# Description of Changes <!-- Please provide a summary of the changes, including: - What was changed - Why the change was made - Any challenges encountered Closes #(issue_number) --> --- ## Checklist ### General - [ ] I have read the [Contribution Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md) - [ ] I have read the [Stirling-PDF Developer Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md) (if applicable) - [ ] I have read the [How to add new languages to Stirling-PDF](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md) (if applicable) - [ ] I have performed a self-review of my own code - [ ] My changes generate no new warnings ### Documentation - [ ] I have updated relevant docs on [Stirling-PDF's doc repo](https://github.com/Stirling-Tools/Stirling-Tools.github.io/blob/main/docs/) (if functionality has heavily changed) - [ ] I have read the section [Add New Translation Tags](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md#add-new-translation-tags) (for new translation tags only) ### UI Changes (if applicable) - [ ] Screenshots or videos demonstrating the UI changes are attached (e.g., as comments or direct attachments in the PR) ### Testing (if applicable) - [ ] I have tested my changes locally. Refer to the [Testing Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md#6-testing) for more details. --------- Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: EthanHealy01 <ethan.healy.21@gmail.com> Co-authored-by: EthanHealy01 <80844253+EthanHealy01@users.noreply.github.com>
146 lines
6.5 KiB
TypeScript
146 lines
6.5 KiB
TypeScript
import { useEffect, useState } from 'react';
|
|
import { Badge, Button, Card, Group, Modal, Stack, Text } from '@mantine/core';
|
|
import { useTranslation } from 'react-i18next';
|
|
import { useToolWorkflow } from '../../contexts/ToolWorkflowContext';
|
|
import './ToolPanelModePrompt.css';
|
|
import { useToolPanelModePreference } from '../../hooks/useToolPanelModePreference';
|
|
import { ToolPanelMode } from 'src/contexts/toolWorkflow/toolWorkflowState';
|
|
|
|
// type moved to hook
|
|
|
|
const ToolPanelModePrompt = () => {
|
|
const { t } = useTranslation();
|
|
const { toolPanelMode, setToolPanelMode } = useToolWorkflow();
|
|
const [opened, setOpened] = useState(false);
|
|
const { hydrated, shouldShowPrompt, markPromptSeen, setPreferredMode } = useToolPanelModePreference();
|
|
|
|
useEffect(() => {
|
|
if (shouldShowPrompt) {
|
|
setOpened(true);
|
|
}
|
|
}, [shouldShowPrompt]);
|
|
|
|
const handleSelect = (mode: ToolPanelMode) => {
|
|
setToolPanelMode(mode);
|
|
setPreferredMode(mode);
|
|
markPromptSeen();
|
|
setOpened(false);
|
|
};
|
|
|
|
const handleDismiss = () => {
|
|
markPromptSeen();
|
|
setOpened(false);
|
|
};
|
|
|
|
if (!hydrated) {
|
|
return null;
|
|
}
|
|
|
|
return (
|
|
<Modal
|
|
opened={opened}
|
|
onClose={handleDismiss}
|
|
centered
|
|
size="xl"
|
|
radius="lg"
|
|
overlayProps={{ blur: 6, opacity: 0.35 }}
|
|
classNames={{ content: 'tool-panel-mode-prompt__modal' }}
|
|
title={t('toolPanel.modePrompt.title', 'Choose how you browse tools')}
|
|
>
|
|
<Stack gap="lg">
|
|
<Text size="sm" c="dimmed">
|
|
{t('toolPanel.modePrompt.description', 'Preview both layouts and decide how you want to explore Stirling PDF tools.')}
|
|
</Text>
|
|
<div className="tool-panel-mode-prompt__options">
|
|
<Card withBorder radius="lg" shadow="sm" padding="lg" className="tool-panel-mode-prompt__card tool-panel-mode-prompt__card--sidebar">
|
|
<Stack gap="md" className="tool-panel-mode-prompt__card-content">
|
|
<Group justify="space-between">
|
|
<Stack gap={2}>
|
|
<Text fw={600}>{t('toolPanel.modePrompt.sidebarTitle', 'Sidebar mode')}</Text>
|
|
<Text size="sm" c="dimmed">
|
|
{t('toolPanel.modePrompt.sidebarDescription', 'Keep tools alongside your workspace for quick switching.')}
|
|
</Text>
|
|
</Stack>
|
|
<Badge color="blue" variant="filled">
|
|
{t('toolPanel.modePrompt.recommended', 'Recommended')}
|
|
</Badge>
|
|
</Group>
|
|
<div className="tool-panel-mode-prompt__preview tool-panel-mode-prompt__preview--sidebar" aria-hidden>
|
|
<div className="tool-panel-mode-prompt__sidebar-panel">
|
|
<span className="tool-panel-mode-prompt__sidebar-search" />
|
|
<span className="tool-panel-mode-prompt__sidebar-item" />
|
|
<span className="tool-panel-mode-prompt__sidebar-item" />
|
|
<span className="tool-panel-mode-prompt__sidebar-item" />
|
|
<span className="tool-panel-mode-prompt__sidebar-item tool-panel-mode-prompt__sidebar-item--muted" />
|
|
</div>
|
|
<div className="tool-panel-mode-prompt__workspace" aria-hidden>
|
|
<div className="tool-panel-mode-prompt__workspace-page" />
|
|
<div className="tool-panel-mode-prompt__workspace-page tool-panel-mode-prompt__workspace-page--secondary" />
|
|
</div>
|
|
</div>
|
|
<Button
|
|
variant={toolPanelMode === 'sidebar' ? 'filled' : 'light'}
|
|
color="blue"
|
|
radius="md"
|
|
className="tool-panel-mode-prompt__action"
|
|
onClick={() => handleSelect('sidebar')}
|
|
>
|
|
{t('toolPanel.modePrompt.chooseSidebar', 'Use sidebar mode')}
|
|
</Button>
|
|
</Stack>
|
|
</Card>
|
|
<Card withBorder radius="lg" shadow="xs" padding="lg" className="tool-panel-mode-prompt__card">
|
|
<Stack gap="md" className="tool-panel-mode-prompt__card-content">
|
|
<Stack gap={2}>
|
|
<Text fw={600}>{t('toolPanel.modePrompt.fullscreenTitle', 'Fullscreen mode')}</Text>
|
|
<Text size="sm" c="dimmed">
|
|
{t('toolPanel.modePrompt.fullscreenDescription', 'Browse every tool in a catalogue that covers the workspace until you pick one.')}
|
|
</Text>
|
|
</Stack>
|
|
<div className="tool-panel-mode-prompt__preview tool-panel-mode-prompt__preview--fullscreen" aria-hidden>
|
|
<div className="tool-panel-mode-prompt__fullscreen-columns">
|
|
<div className="tool-panel-mode-prompt__fullscreen-column">
|
|
<span className="tool-panel-mode-prompt__fullscreen-card" />
|
|
<span className="tool-panel-mode-prompt__fullscreen-card" />
|
|
<span className="tool-panel-mode-prompt__fullscreen-card tool-panel-mode-prompt__fullscreen-card--muted" />
|
|
</div>
|
|
<div className="tool-panel-mode-prompt__fullscreen-column">
|
|
<span className="tool-panel-mode-prompt__fullscreen-card" />
|
|
<span className="tool-panel-mode-prompt__fullscreen-card" />
|
|
<span className="tool-panel-mode-prompt__fullscreen-card tool-panel-mode-prompt__fullscreen-card--muted" />
|
|
</div>
|
|
<div className="tool-panel-mode-prompt__fullscreen-column">
|
|
<span className="tool-panel-mode-prompt__fullscreen-card" />
|
|
<span className="tool-panel-mode-prompt__fullscreen-card" />
|
|
<span className="tool-panel-mode-prompt__fullscreen-card tool-panel-mode-prompt__fullscreen-card--muted" />
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<Button
|
|
variant={toolPanelMode === 'fullscreen' ? 'filled' : 'outline'}
|
|
color="blue"
|
|
radius="md"
|
|
className="tool-panel-mode-prompt__action"
|
|
onClick={() => handleSelect('fullscreen')}
|
|
>
|
|
{t('toolPanel.modePrompt.chooseFullscreen', 'Use fullscreen mode')}
|
|
</Button>
|
|
</Stack>
|
|
</Card>
|
|
</div>
|
|
<Button
|
|
variant="subtle"
|
|
color="gray"
|
|
radius="md"
|
|
className="tool-panel-mode-prompt__maybe-later"
|
|
onClick={handleDismiss}
|
|
>
|
|
{t('toolPanel.modePrompt.dismiss', 'Maybe later')}
|
|
</Button>
|
|
</Stack>
|
|
</Modal>
|
|
);
|
|
};
|
|
|
|
export default ToolPanelModePrompt;
|