Feature/onboarding slides (#4955)

# Description of Changes

- Added onboarding slides/upgrade banner conditions for all the
following cases
  - 'licensed'
  - 'no-login-user-under-limit-no-license'
  - 'no-login-admin-under-limit-no-license'
  - 'no-login-user-over-limit-no-license'
  - 'no-login-admin-over-limit-no-license'
  - 'login-user-under-limit-no-license'
  - 'login-admin-under-limit-no-license'
  - 'login-user-over-limit-no-license'
  - 'login-admin-over-limit-no-license';


---

## 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)

### Translations (if applicable)

- [ ] I ran
[`scripts/counter_translation.py`](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/docs/counter_translation.md)

### 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: Anthony Stirling <[email protected]>
Co-authored-by: Connor Yoh <[email protected]>

frontend/src/core/components/tools/ToolPanelModePrompt.tsx

@@ -3,16 +3,31 @@ import { Badge, Button, Card, Group, Modal, Stack, Text } from '@mantine/core';
 import { useTranslation } from 'react-i18next';
 import { useToolWorkflow } from '@app/contexts/ToolWorkflowContext';
 import { usePreferences } from '@app/contexts/PreferencesContext';
+import { useOnboarding } from '@app/contexts/OnboardingContext';
 import '@app/components/tools/ToolPanelModePrompt.css';
-import type { ToolPanelMode } from '@app/constants/toolPanel';
+import { type ToolPanelMode } from '@app/constants/toolPanel';
+import { useAppConfig } from '@app/contexts/AppConfigContext';
 
-const ToolPanelModePrompt = () => {
+interface ToolPanelModePromptProps {
+  onComplete?: () => void;
+}
+
+const ToolPanelModePrompt = ({ onComplete }: ToolPanelModePromptProps = {}) => {
   const { t } = useTranslation();
   const { toolPanelMode, setToolPanelMode } = useToolWorkflow();
   const { preferences, updatePreference } = usePreferences();
+  const {
+    startTour,
+    startAfterToolModeSelection,
+    setStartAfterToolModeSelection,
+    pendingTourRequest,
+  } = useOnboarding();
   const [opened, setOpened] = useState(false);
+  const { config } = useAppConfig();
+  const isAdmin = !!config?.isAdmin;
 
-  const shouldShowPrompt = !preferences.toolPanelModePromptSeen;
+  // Only show after the new 3-slide onboarding has been completed
+  const shouldShowPrompt = !preferences.toolPanelModePromptSeen && preferences.hasSeenIntroOnboarding;
 
   useEffect(() => {
     if (shouldShowPrompt) {
@@ -20,16 +35,56 @@ const ToolPanelModePrompt = () => {
     }
   }, [shouldShowPrompt]);
 
+  const resolveRequestedTourType = (): 'admin' | 'tools' => {
+    if (pendingTourRequest?.type) {
+      return pendingTourRequest.type;
+    }
+    if (pendingTourRequest?.metadata && 'selfReportedAdmin' in pendingTourRequest.metadata) {
+      return pendingTourRequest.metadata.selfReportedAdmin ? 'admin' : 'tools';
+    }
+    return isAdmin ? 'admin' : 'tools';
+  };
+
+  const resumeDeferredTour = (context?: { selection?: ToolPanelMode; dismissed?: boolean }) => {
+    if (!startAfterToolModeSelection) {
+      return;
+    }
+    setStartAfterToolModeSelection(false);
+    const targetType = resolveRequestedTourType();
+    startTour(targetType, {
+      skipToolPromptRequirement: true,
+      source: 'tool-panel-mode-prompt',
+      metadata: {
+        ...pendingTourRequest?.metadata,
+        resumedFromToolPrompt: true,
+        ...(context?.selection ? { selection: context.selection } : {}),
+        ...(context?.dismissed ? { dismissed: true } : {}),
+      },
+    });
+  };
+
   const handleSelect = (mode: ToolPanelMode) => {
     setToolPanelMode(mode);
     updatePreference('defaultToolPanelMode', mode);
     updatePreference('toolPanelModePromptSeen', true);
+    updatePreference('hasSelectedToolPanelMode', true);
     setOpened(false);
+
+    resumeDeferredTour({ selection: mode });
+    onComplete?.();
   };
 
   const handleDismiss = () => {
+    const defaultMode: ToolPanelMode = 'sidebar';
+    if (toolPanelMode !== defaultMode) {
+      setToolPanelMode(defaultMode);
+      updatePreference('defaultToolPanelMode', defaultMode);
+    }
+    updatePreference('hasSelectedToolPanelMode', true);
     updatePreference('toolPanelModePromptSeen', true);
     setOpened(false);
+    resumeDeferredTour({ dismissed: true });
+    onComplete?.();
   };
 
   return (