npm - @wildo-ai/saas-frontend-lib - Versions diffs - 1.1.4 → 1.1.6 - Mend

@wildo-ai/saas-frontend-lib 1.1.4 → 1.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2742) hide show

package/dist/esm/components/views/onboarding-view/OnboardingView.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"OnboardingView.js","sourceRoot":"","sources":["../../../../../src/components/views/onboarding-view/OnboardingView.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n OnboardingView — Wizard-style onboarding view.\n \n Renders a sequence of guidance elements (checklist, tour, survey, etc.)\n * with step progression, progress bar, and navigation controls.\n * Integrates with GuidanceContext only when a matching `guidanceFlowRef` is\n * provided and falls back to local transient state when the view is rendered\n * directly from a static onboarding document.\n /\n\nimport React, { useState, useMemo, useCallback, useEffect, useId } from 'react';\nimport {\n OnboardingElementType,\n OnboardingStatus,\n isTerminalOnboardingStatus,\n type OnboardingElement,\n type OnboardingViewOptions,\n type GuidanceFlowState,\n} from '@wildo-ai/saas-models';\nimport type { OnboardingViewDefinition } from '~wildo-frontend-lib/core/config/onboarding-view.frontend.schemas';\nimport type { GuidanceElementState } from '@wildo-ai/saas-models';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { useGuidance } from '~wildo-frontend-lib/core/guidance/useGuidance';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport type { GuidanceElementRendererProps } from '~wildo-frontend-lib/core/guidance/GuidanceRenderer';\n\n// Element renderers\nimport { GuidanceChecklist } from '~wildo-frontend-lib/core/guidance/renderers/GuidanceChecklist';\nimport { GuidanceChecklistItem } from '~wildo-frontend-lib/core/guidance/renderers/GuidanceChecklistItem';\nimport { GuidanceTour } from '~wildo-frontend-lib/core/guidance/renderers/GuidanceTour';\nimport { GuidanceTooltip } from '~wildo-frontend-lib/core/guidance/renderers/GuidanceTooltip';\nimport { GuidanceModal } from '~wildo-frontend-lib/core/guidance/renderers/GuidanceModal';\nimport { GuidanceBanner } from '~wildo-frontend-lib/core/guidance/renderers/GuidanceBanner';\nimport { GuidanceAnnouncement } from '~wildo-frontend-lib/core/guidance/renderers/GuidanceAnnouncement';\nimport { GuidanceBadge } from '~wildo-frontend-lib/core/guidance/renderers/GuidanceBadge';\nimport { GuidanceCard } from '~wildo-frontend-lib/core/guidance/renderers/GuidanceCard';\nimport { GuidanceSurvey } from '~wildo-frontend-lib/core/guidance/renderers/GuidanceSurvey';\n\n// ─── Element Type → Component Map ────────────────────────────\n\nconst ELEMENT_RENDERER_MAP: Record<OnboardingElementType, React.FC<GuidanceElementRendererProps>> = {\n [OnboardingElementType.CHECKLIST]: GuidanceChecklist,\n [OnboardingElementType.CHECKLIST_ITEM]: GuidanceChecklistItem,\n [OnboardingElementType.TOUR]: GuidanceTour,\n [OnboardingElementType.TOOLTIP]: GuidanceTooltip,\n [OnboardingElementType.MODAL]: GuidanceModal,\n [OnboardingElementType.BANNER]: GuidanceBanner,\n [OnboardingElementType.ANNOUNCEMENT]: GuidanceAnnouncement,\n [OnboardingElementType.BADGE]: GuidanceBadge,\n [OnboardingElementType.CARD]: GuidanceCard,\n [OnboardingElementType.SURVEY]: GuidanceSurvey,\n};\n\n// ─── Props ───────────────────────────────────────────────────\n\nexport interface OnboardingViewProps {\n /* Onboarding document with elements /\n document: OnboardingViewDefinition;\n /* Additional options to override document options /\n options?: Partial<OnboardingViewOptions>;\n /* Custom class name /\n className?: string;\n /* Callback when element status changes /\n onStatusChange?: (elementRef: string, status: OnboardingStatus) => void;\n /* Callback when action is triggered /\n onAction?: (elementRef: string, actionRef?: string) => void;\n /* View reference for i18n/view identity when rendered from a larger document /\n viewRef?: string;\n /\n Connects this view to a persisted guidance flow.\n \n When provided, dismiss / complete / skip actions are forwarded to\n * `GuidanceContext` and persisted to the backend. Must match a\n * `GuidanceFlowDefinition.ref` registered in the app's guidance config.\n \n When omitted, the view operates in local-only mode — all state is\n * transient and resets on unmount. A console warning is emitted to\n * flag the non-persisted mode.\n /\n guidanceFlowRef?: string;\n}\n\n// ─── Component ───────────────────────────────────────────────\n\nexport const OnboardingView: React.FC<OnboardingViewProps> = ({\n document: doc,\n options: optionsOverride = {},\n className = '',\n onStatusChange,\n onAction,\n viewRef: viewRefProp,\n guidanceFlowRef: guidanceFlowRefProp,\n}) => {\n const { flowStates, completeElement, completeFlow, dismissFlow, skipFlow, isFlowPersistable, isLoading: guidanceIsLoading } = useGuidance();\n const localFlowId = useId();\n const guidanceFlowRef = guidanceFlowRefProp;\n /\n Persistence identity follows CONTENT: default to the document's own ref when\n * no explicit `guidanceFlowRef` override is given (mirrors `translationRef`).\n * Dismiss / complete / skip then persist under `doc.ref` for a first-class\n * onboarding view registered in app config — no parallel guidance flow needed.\n /\n const persistenceFlowRef = guidanceFlowRef ?? doc.ref;\n /\n Whether persistence will actually happen — `persistenceFlowRef` resolves to a\n * registered guidance flow OR an app-config onboarding view. When false the view\n * is a transient local-only embed (ad-hoc inline document not in config).\n /\n const isPersisted = isFlowPersistable(persistenceFlowRef);\n const flowRef = persistenceFlowRef ?? `onboarding-local-${localFlowId}`;\n /\n i18n namespace for this view's element labels. Element labels are read as\n * `guidance.{translationRef}.elements.{el}.{key}` (see `makeTrGuidanceElement`\n * below and `tGuidanceElement` in `core/i18n/I18nContext`).\n \n Translation identity follows CONTENT, not persistence. The elements this\n * view renders are `doc.elements`, so their labels belong under the document's\n * OWN ref — symmetric with `GuidanceRenderer`, which scopes a flow's elements\n * under `flow.ref`. `guidanceFlowRef` is a SEPARATE, persistence-only identity\n * (it drives complete/dismiss/skip + the `flowStates` lookup) and may name a\n * flow whose element set differs entirely from `doc.elements` — e.g. a 3-step\n * wizard document (`focus-hub-step-`) persisted through a single-card flow\n (`focus-hub-guide-card`). Namespacing the document's element refs under that\n * foreign flow ref resolves keys that were never generated for them: the\n * footgun this precedence closes.\n \n Precedence:\n * 1. `viewRefProp` — explicit override; caller knows the canonical ref\n * (e.g. this view is one surface of a larger document).\n * 2. `doc.ref` — the document's own content identity (the normal\n * case; `OnboardingViewDefinition.ref` is\n * `z.string().min(1)`, so it is present and non-empty\n * for every well-formed document).\n * 3. `guidanceFlowRef` — last-resort identity ONLY when `doc.ref` is absent\n * (untyped/malformed callers); preserves the prior\n * persisted-flow lookup instead of collapsing to (4).\n * 4. `'onboarding'` — generic terminal fallback.\n \n Rejected `viewRefProp \|\| guidanceFlowRef \|\| doc.ref \|\| 'onboarding'`: that\n * keeps PERSISTENCE ahead of CONTENT, so any caller passing a divergent\n * `guidanceFlowRef` without a `viewRef` would re-open the exact footgun above.\n * It is also behaviorally identical to this ordering for every current\n * consumer (the only `guidanceFlowRef` caller also passes `viewRef`), so the\n * \"smaller diff\" argument buys no safety — only the wrong default semantics.\n /\n const translationRef = viewRefProp \|\| doc.ref \|\| guidanceFlowRef \|\| 'onboarding';\n const guidanceKeys = useMemo(() => [`guidance.${translationRef}`], [translationRef]);\n const { makeTrGuidanceElement, tComponent, isReady } = useI18n({\n component: FrontendComponentType.GUIDANCE_ONBOARDING_VIEW,\n keys: guidanceKeys,\n });\n\n useEffect(() => {\n if (!isPersisted) {\n const elementRefs = doc.elements.map(el => el.ref).join(', ');\n console.warn(\n `[OnboardingView] Mounted with no persistable identity (ref=\"${persistenceFlowRef ?? '(none)'}\", ` +\n `viewRef=\"${viewRefProp ?? '(none)'}\", elements=[${elementRefs}]). Dismiss, complete, and skip ` +\n 'actions will only affect local component state and will NOT be persisted to the backend. To ' +\n 'persist, either declare this onboarding view (by ref) in the app frontend config so it is ' +\n 'registered, or pass the guidanceFlowRef prop matching a registered GuidanceFlowDefinition.',\n );\n }\n }, []); // eslint-disable-line react-hooks/exhaustive-deps -- intentional mount-only check\n\n const mergedOptions = useMemo<OnboardingViewOptions>(\n () => ({ ...doc.options, ...optionsOverride }),\n [doc.options, optionsOverride],\n );\n\n // Sort elements by order\n const sortedElements = useMemo<OnboardingElement[]>(\n () => [...doc.elements].sort((a, b) => a.order - b.order),\n [doc.elements],\n );\n\n // Step tracking for wizard mode\n const [currentStepIndex, setCurrentStepIndex] = useState(0);\n const [localFlowState, setLocalFlowState] = useState<GuidanceFlowState>({\n status: OnboardingStatus.IN_PROGRESS,\n elements: {},\n triggerCount: 1,\n });\n const totalSteps = sortedElements.length;\n\n useEffect(() => {\n setCurrentStepIndex(0);\n setLocalFlowState({\n status: OnboardingStatus.IN_PROGRESS,\n elements: {},\n triggerCount: 1,\n });\n }, [flowRef]);\n\n // Derive flow state from GuidanceContext when persistable; else local transient.\n const flowState = isPersisted ? (flowStates[persistenceFlowRef] ?? localFlowState) : localFlowState;\n\n const getElementState = useCallback(\n (elementRef: string): GuidanceElementState \| undefined =>\n flowState?.elements?.[elementRef],\n [flowState],\n );\n\n // Count completed elements\n const completedCount = useMemo(() => {\n if (!flowState?.elements) return 0;\n return Object.values(flowState.elements).filter(\n s => s.status === OnboardingStatus.COMPLETED,\n ).length;\n }, [flowState]);\n\n // ─── Handlers ────────────────────────────────────────────\n\n const setLocalElementStatus = useCallback((\n elementRef: string,\n status: OnboardingStatus,\n data?: { surveyAnswers?: GuidanceElementState['surveyAnswers']; lastStepIndex?: number },\n ) => {\n const completedAt = status === OnboardingStatus.COMPLETED ? new Date() : undefined;\n setLocalFlowState(prev => ({\n ...prev,\n elements: {\n ...prev.elements,\n [elementRef]: {\n ...prev.elements[elementRef],\n status,\n completedAt,\n surveyAnswers: data?.surveyAnswers ?? prev.elements[elementRef]?.surveyAnswers,\n lastStepIndex: data?.lastStepIndex ?? prev.elements[elementRef]?.lastStepIndex,\n },\n },\n }));\n }, []);\n\n const setLocalFlowStatus = useCallback((status: OnboardingStatus) => {\n const now = new Date();\n setLocalFlowState(prev => ({\n ...prev,\n status,\n completedAt: status === OnboardingStatus.COMPLETED ? now : prev.completedAt,\n dismissedAt: status === OnboardingStatus.DISMISSED ? now : prev.dismissedAt,\n }));\n }, []);\n\n const handleComplete = useCallback(\n (elementRef: string, data?: { surveyAnswers?: GuidanceElementState['surveyAnswers']; lastStepIndex?: number }) => {\n setLocalElementStatus(elementRef, OnboardingStatus.COMPLETED, data);\n if (isPersisted) {\n completeElement(persistenceFlowRef, elementRef, data);\n }\n onStatusChange?.(elementRef, OnboardingStatus.COMPLETED);\n\n // Auto-advance to next step if not on last\n if (currentStepIndex < totalSteps - 1) {\n setCurrentStepIndex(prev => prev + 1);\n } else {\n setLocalFlowStatus(OnboardingStatus.COMPLETED);\n if (isPersisted) {\n completeFlow(persistenceFlowRef);\n }\n }\n },\n [completeElement, completeFlow, currentStepIndex, isPersisted, persistenceFlowRef, onStatusChange, setLocalElementStatus, setLocalFlowStatus, totalSteps],\n );\n\n const handleDismiss = useCallback(\n (elementRef: string) => {\n setLocalElementStatus(elementRef, OnboardingStatus.DISMISSED);\n onStatusChange?.(elementRef, OnboardingStatus.DISMISSED);\n if (mergedOptions.allowDismiss) {\n setLocalFlowStatus(OnboardingStatus.DISMISSED);\n if (isPersisted) {\n dismissFlow(persistenceFlowRef);\n }\n }\n },\n [dismissFlow, isPersisted, persistenceFlowRef, mergedOptions.allowDismiss, onStatusChange, setLocalElementStatus, setLocalFlowStatus],\n );\n\n const handleAction = useCallback(\n (actionRef: string) => {\n const currentElement = sortedElements[currentStepIndex];\n onAction?.(currentElement?.ref ?? '', actionRef);\n },\n [onAction, sortedElements, currentStepIndex],\n );\n\n const handleNext = useCallback(() => {\n if (currentStepIndex < totalSteps - 1) {\n setCurrentStepIndex(prev => prev + 1);\n return;\n }\n\n const currentElement = sortedElements[currentStepIndex];\n if (!currentElement) {\n setLocalFlowStatus(OnboardingStatus.COMPLETED);\n if (isPersisted) {\n completeFlow(persistenceFlowRef);\n }\n return;\n }\n\n handleComplete(currentElement.ref);\n }, [currentStepIndex, totalSteps, sortedElements, handleComplete, completeFlow, isPersisted, persistenceFlowRef, setLocalFlowStatus]);\n\n const handleBack = useCallback(() => {\n if (currentStepIndex > 0) {\n setCurrentStepIndex(prev => prev - 1);\n }\n }, [currentStepIndex]);\n\n const handleSkip = useCallback(() => {\n setLocalFlowStatus(OnboardingStatus.SKIPPED);\n if (isPersisted) {\n skipFlow(persistenceFlowRef);\n }\n }, [isPersisted, persistenceFlowRef, setLocalFlowStatus, skipFlow]);\n\n // ─── Render ──────────────────────────────────────────────\n\n if (!isReady) return null;\n\n // Hydration-flash guard: a PERSISTED onboarding view must not paint its\n // default (IN_PROGRESS) content before the backend-persisted flow state has\n // loaded — otherwise a view the user already dismissed / completed / skipped\n // flashes in and then vanishes once `flowStates` hydrates. Local-only\n // (non-persisted) views have no backend state to wait for, so they render\n // immediately. Once loading settles, `flowState` reflects the true status\n // (terminal → stays hidden; otherwise renders).\n if (isPersisted && guidanceIsLoading) return null;\n\n if (sortedElements.length === 0) {\n return (\n <div className={cn('p-container-xl text-center text-muted-foreground', className)}>\n {tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'empty')}\n </div>\n );\n }\n\n // A terminal flow status closes the view: the onboarding sequence is over.\n // COMPLETED (last step finished), DISMISSED (user closed), and SKIPPED (user\n // skipped) all mean \"stop rendering\". COMPLETED was previously missing from\n // this gate, so finishing the last step persisted the completion + called\n // `completeFlow(...)` but left the final modal on screen (\"not dismissed at\n // the end\"): the view kept rendering `currentElement` (still the last step).\n // Use the canonical `isTerminalOnboardingStatus` helper so this gate can never\n // drift from the lifecycle status set again (mirrors the GuidanceContext\n // complete/dismiss/skip guards).\n if (isTerminalOnboardingStatus(flowState?.status)) {\n return null;\n }\n\n const currentElement = sortedElements[currentStepIndex];\n if (!currentElement) return null;\n\n const Renderer = ELEMENT_RENDERER_MAP[currentElement.type];\n const elementState = getElementState(currentElement.ref);\n const scopedT = makeTrGuidanceElement(translationRef, currentElement.ref);\n\n return (\n <div className={cn('flex flex-col gap-element', className)}>\n {/ Progress bar /}\n {mergedOptions.showProgress && totalSteps > 1 && (\n <div className=\"flex flex-col gap-item-xs\">\n <div className=\"flex justify-between items-center text-[0.8125rem] text-muted-foreground font-medium\">\n <span>\n {tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'stepOf', {\n current: currentStepIndex + 1,\n total: totalSteps,\n })}\n </span>\n <span className=\"text-xs\">\n {completedCount}/{totalSteps}\n </span>\n </div>\n\n {/ Progress bar track /}\n <div\n className=\"w-full h-1 bg-muted rounded-sm overflow-hidden\"\n role=\"progressbar\"\n aria-valuenow={currentStepIndex + 1}\n aria-valuemin={1}\n aria-valuemax={totalSteps}\n >\n <div\n className=\"h-full bg-primary rounded-sm motion-safe:transition-[width] motion-safe:duration-[var(--motion-duration-normal)] motion-safe:ease-out\"\n style={{ width: `${totalSteps > 0 ? ((currentStepIndex + 1) / totalSteps) 100 : 0}%` }}\n />\n </div>\n </div>\n )}\n\n {/* Current element renderer /}\n {Renderer && (\n <Renderer\n element={currentElement}\n flowRef={flowRef}\n state={elementState}\n onComplete={handleComplete}\n onDismiss={handleDismiss}\n onAction={handleAction}\n t={scopedT}\n />\n )}\n\n {/ Navigation controls /}\n {totalSteps > 1 && (\n <div className=\"flex justify-between items-center pt-item\">\n {/ Left: Back /}\n <div>\n {currentStepIndex > 0 && (\n // V-5: candidate for Button/IconButton migration — see audit doc\n // (raw <button> reimplements OUTLINE/GHOST recipe with non-ladder text-[0.8125rem])\n <button\n type=\"button\"\n onClick={handleBack}\n className=\"px-card py-item text-[0.8125rem] font-medium text-muted-foreground bg-transparent border border-border rounded-md cursor-pointer motion-safe:transition-colors hover:bg-muted focus-ring-offset pointer-coarse:min-h-11\"\n >\n {tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'back')}\n </button>\n )}\n </div>\n\n {/ Right: Skip / Next / Complete /}\n <div className=\"flex gap-item items-center\">\n {mergedOptions.allowSkip && (\n // V-5: candidate for Button/IconButton migration — see audit doc\n // (raw <button> reimplements GHOST recipe with non-ladder text-[0.8125rem])\n <button\n type=\"button\"\n onClick={handleSkip}\n /\n * Quiet, but not below the contrast floor: at `text-muted-foreground/70` this\n * composited to #7d899b on the light theme's #f8fafc — 3.38:1 where 4.5:1 is\n * required (axe, live stack, 2026-09-09, #533). The full token is still visibly\n * secondary to the primary action beside it.\n /\n className=\"px-card-sm py-item text-[0.8125rem] font-medium text-muted-foreground bg-transparent border-none cursor-pointer motion-safe:transition-colors hover:text-muted-foreground focus-ring-offset pointer-coarse:min-h-11\"\n >\n {tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'skip')}\n </button>\n )}\n\n {/ V-5: candidate for Button/IconButton migration — see audit doc /}\n {/ (raw <button> reimplements PRIMARY recipe with non-ladder text-[0.8125rem]) /}\n <button\n type=\"button\"\n onClick={handleNext}\n className=\"px-card py-item text-[0.8125rem] font-medium text-primary-foreground bg-primary border-none rounded-md cursor-pointer motion-safe:transition-colors hover:bg-primary/90 focus-ring-offset pointer-coarse:min-h-11\"\n >\n {currentStepIndex === totalSteps - 1\n ? tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'complete')\n : tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'next')}\n </button>\n </div>\n </div>\n )}\n\n {/ Single-step footer fallback: some renderers do not expose their own completion action. /}\n {totalSteps === 1 && (\n <div className=\"flex justify-end gap-item items-center\">\n {mergedOptions.allowDismiss && (\n // V-5: candidate for Button/IconButton migration — see audit doc\n // (raw <button> reimplements GHOST recipe with non-ladder text-[0.8125rem])\n <button\n type=\"button\"\n onClick={() => handleDismiss(currentElement.ref)}\n className=\"px-card-sm py-item text-[0.8125rem] font-medium text-muted-foreground bg-transparent border-none cursor-pointer motion-safe:transition-colors hover:text-muted-foreground focus-ring-offset pointer-coarse:min-h-11\"\n >\n {tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'dismiss')}\n </button>\n )}\n\n {/ V-5: candidate for Button/IconButton migration — see audit doc /}\n {/ (raw <button> reimplements PRIMARY recipe with non-ladder text-[0.8125rem]) */}\n <button\n type=\"button\"\n onClick={handleNext}\n className=\"px-card py-item text-[0.8125rem] font-medium text-primary-foreground bg-primary border-none rounded-md cursor-pointer motion-safe:transition-colors hover:bg-primary/90 focus-ring-offset pointer-coarse:min-h-11\"\n >\n {tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'complete')}\n </button>\n </div>\n )}\n </div>\n );\n};\n"]}
1	+ {"version":3,"file":"OnboardingView.js","sourceRoot":"","sources":["../../../../../../src/components/views/onboarding-view/OnboardingView.tsx"],"names":[],"mappings":"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","sourcesContent":["/*\n OnboardingView — Wizard-style onboarding view.\n \n Renders a sequence of guidance elements (checklist, tour, survey, etc.)\n * with step progression, progress bar, and navigation controls.\n * Integrates with GuidanceContext only when a matching `guidanceFlowRef` is\n * provided and falls back to local transient state when the view is rendered\n * directly from a static onboarding document.\n /\n\nimport React, { useState, useMemo, useCallback, useEffect, useId } from 'react';\nimport {\n OnboardingElementType,\n OnboardingStatus,\n isTerminalOnboardingStatus,\n resolveGuidanceElementRequiredLabelFields,\n type OnboardingElement,\n type OnboardingViewOptions,\n type GuidanceFlowState,\n} from '@wildo-ai/saas-models';\nimport type { OnboardingViewDefinition } from '~wildo-frontend-lib/core/config/onboarding-view.frontend.schemas';\nimport type { GuidanceElementState } from '@wildo-ai/saas-models';\nimport { ButtonSize, FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { Button, ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport { Progress } from '~wildo-frontend-lib/components/feedback/progress';\nimport { useGuidance } from '~wildo-frontend-lib/core/guidance/useGuidance';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { cn } from '~wildo-frontend-lib/core/ui/cn';\nimport { resolveGuidanceElementRenderer } from '~wildo-frontend-lib/core/guidance/GuidanceRenderer';\n\n// ─── Props ───────────────────────────────────────────────────\n\nexport interface OnboardingViewProps {\n /* Onboarding document with elements /\n document: OnboardingViewDefinition;\n /* Additional options to override document options /\n options?: Partial<OnboardingViewOptions>;\n /* Custom class name /\n className?: string;\n /* Callback when element status changes /\n onStatusChange?: (elementRef: string, status: OnboardingStatus) => void;\n /* Callback when action is triggered /\n onAction?: (elementRef: string, actionRef?: string) => void;\n /* View reference for i18n/view identity when rendered from a larger document /\n viewRef?: string;\n /\n Connects this view to a persisted guidance flow.\n \n When provided, dismiss / complete / skip actions are forwarded to\n * `GuidanceContext` and persisted to the backend. Must match a\n * `GuidanceFlowDefinition.ref` registered in the app's guidance config.\n \n When omitted, the view operates in local-only mode — all state is\n * transient and resets on unmount. A console warning is emitted to\n * flag the non-persisted mode.\n /\n guidanceFlowRef?: string;\n}\n\n// ─── Component ───────────────────────────────────────────────\n\nexport const OnboardingView: React.FC<OnboardingViewProps> = ({\n document: doc,\n options: optionsOverride = {},\n className = '',\n onStatusChange,\n onAction,\n viewRef: viewRefProp,\n guidanceFlowRef: guidanceFlowRefProp,\n}) => {\n const { flowStates, completeElement, completeFlow, dismissFlow, skipFlow, isFlowPersistable, isLoading: guidanceIsLoading } = useGuidance();\n const localFlowId = useId();\n const guidanceFlowRef = guidanceFlowRefProp;\n /\n Persistence identity follows CONTENT: default to the document's own ref when\n * no explicit `guidanceFlowRef` override is given (mirrors `translationRef`).\n * Dismiss / complete / skip then persist under `doc.ref` for a first-class\n * onboarding view registered in app config — no parallel guidance flow needed.\n /\n const persistenceFlowRef = guidanceFlowRef ?? doc.ref;\n /\n Whether persistence will actually happen — `persistenceFlowRef` resolves to a\n * registered guidance flow OR an app-config onboarding view. When false the view\n * is a transient local-only embed (ad-hoc inline document not in config).\n /\n const isPersisted = isFlowPersistable(persistenceFlowRef);\n const flowRef = persistenceFlowRef ?? `onboarding-local-${localFlowId}`;\n /\n i18n namespace for this view's element labels. Element labels are read as\n * `guidance.{translationRef}.elements.{el}.{key}` (see `makeTrGuidanceElement`\n * below and `tGuidanceElement` in `core/i18n/I18nContext`).\n \n Translation identity follows CONTENT, not persistence. The elements this\n * view renders are `doc.elements`, so their labels belong under the document's\n * OWN ref — symmetric with `GuidanceRenderer`, which scopes a flow's elements\n * under `flow.ref`. `guidanceFlowRef` is a SEPARATE, persistence-only identity\n * (it drives complete/dismiss/skip + the `flowStates` lookup) and may name a\n * flow whose element set differs entirely from `doc.elements` — e.g. a 3-step\n * wizard document (`focus-hub-step-`) persisted through a single-card flow\n (`focus-hub-guide-card`). Namespacing the document's element refs under that\n * foreign flow ref resolves keys that were never generated for them: the\n * footgun this precedence closes.\n \n Precedence:\n * 1. `viewRefProp` — explicit override; caller knows the canonical ref\n * (e.g. this view is one surface of a larger document).\n * 2. `doc.ref` — the document's own content identity (the normal\n * case; `OnboardingViewDefinition.ref` is\n * `z.string().min(1)`, so it is present and non-empty\n * for every well-formed document).\n * 3. `guidanceFlowRef` — last-resort identity ONLY when `doc.ref` is absent\n * (untyped/malformed callers); preserves the prior\n * persisted-flow lookup instead of collapsing to (4).\n * 4. `'onboarding'` — generic terminal fallback.\n \n Rejected `viewRefProp \|\| guidanceFlowRef \|\| doc.ref \|\| 'onboarding'`: that\n * keeps PERSISTENCE ahead of CONTENT, so any caller passing a divergent\n * `guidanceFlowRef` without a `viewRef` would re-open the exact footgun above.\n * It is also behaviorally identical to this ordering for every current\n * consumer (the only `guidanceFlowRef` caller also passes `viewRef`), so the\n * \"smaller diff\" argument buys no safety — only the wrong default semantics.\n /\n const translationRef = viewRefProp \|\| doc.ref \|\| guidanceFlowRef \|\| 'onboarding';\n const guidanceKeys = useMemo(() => [`guidance.${translationRef}`], [translationRef]);\n const { makeTrGuidanceElement, tComponent, isReady } = useI18n({\n component: FrontendComponentType.GUIDANCE_ONBOARDING_VIEW,\n keys: guidanceKeys,\n });\n\n useEffect(() => {\n if (!isPersisted) {\n const elementRefs = doc.elements.map(el => el.ref).join(', ');\n console.warn(\n `[OnboardingView] Mounted with no persistable identity (ref=\"${persistenceFlowRef ?? '(none)'}\", ` +\n `viewRef=\"${viewRefProp ?? '(none)'}\", elements=[${elementRefs}]). Dismiss, complete, and skip ` +\n 'actions will only affect local component state and will NOT be persisted to the backend. To ' +\n 'persist, either declare this onboarding view (by ref) in the app frontend config so it is ' +\n 'registered, or pass the guidanceFlowRef prop matching a registered GuidanceFlowDefinition.',\n );\n }\n }, []); // eslint-disable-line react-hooks/exhaustive-deps -- intentional mount-only check\n\n const mergedOptions = useMemo<OnboardingViewOptions>(\n () => ({ ...doc.options, ...optionsOverride }),\n [doc.options, optionsOverride],\n );\n\n // Sort elements by order\n const sortedElements = useMemo<OnboardingElement[]>(\n () => [...doc.elements].sort((a, b) => a.order - b.order),\n [doc.elements],\n );\n\n // Step tracking for wizard mode\n const [currentStepIndex, setCurrentStepIndex] = useState(0);\n const [localFlowState, setLocalFlowState] = useState<GuidanceFlowState>({\n status: OnboardingStatus.IN_PROGRESS,\n elements: {},\n triggerCount: 1,\n });\n const totalSteps = sortedElements.length;\n\n useEffect(() => {\n setCurrentStepIndex(0);\n setLocalFlowState({\n status: OnboardingStatus.IN_PROGRESS,\n elements: {},\n triggerCount: 1,\n });\n }, [flowRef]);\n\n // Derive flow state from GuidanceContext when persistable; else local transient.\n const flowState = isPersisted ? (flowStates[persistenceFlowRef] ?? localFlowState) : localFlowState;\n\n const getElementState = useCallback(\n (elementRef: string): GuidanceElementState \| undefined =>\n flowState?.elements?.[elementRef],\n [flowState],\n );\n\n // Count completed elements\n const completedCount = useMemo(() => {\n if (!flowState?.elements) return 0;\n return Object.values(flowState.elements).filter(\n s => s.status === OnboardingStatus.COMPLETED,\n ).length;\n }, [flowState]);\n\n // ─── Handlers ────────────────────────────────────────────\n\n const setLocalElementStatus = useCallback((\n elementRef: string,\n status: OnboardingStatus,\n data?: { surveyAnswers?: GuidanceElementState['surveyAnswers']; lastStepIndex?: number },\n ) => {\n const completedAt = status === OnboardingStatus.COMPLETED ? new Date() : undefined;\n setLocalFlowState(prev => ({\n ...prev,\n elements: {\n ...prev.elements,\n [elementRef]: {\n ...prev.elements[elementRef],\n status,\n completedAt,\n surveyAnswers: data?.surveyAnswers ?? prev.elements[elementRef]?.surveyAnswers,\n lastStepIndex: data?.lastStepIndex ?? prev.elements[elementRef]?.lastStepIndex,\n },\n },\n }));\n }, []);\n\n const setLocalFlowStatus = useCallback((status: OnboardingStatus) => {\n const now = new Date();\n setLocalFlowState(prev => ({\n ...prev,\n status,\n completedAt: status === OnboardingStatus.COMPLETED ? now : prev.completedAt,\n dismissedAt: status === OnboardingStatus.DISMISSED ? now : prev.dismissedAt,\n }));\n }, []);\n\n /\n * `async` to satisfy the shared renderer contract, which became promise-returning when a guidance\n * survey gained resource binding (#1372). This surface is NOT bound: it owns its element state\n * locally and only mirrors it into guidance persistence, so its completion cannot be refused and\n * there is nothing here to await. The `void` on the mirrored call is deliberate — it keeps this\n * view's own state authoritative, exactly as before, rather than making a local step wait on a\n * persistence round trip.\n /\n const handleComplete = useCallback(\n async (elementRef: string, data?: { surveyAnswers?: GuidanceElementState['surveyAnswers']; lastStepIndex?: number }): Promise<void> => {\n setLocalElementStatus(elementRef, OnboardingStatus.COMPLETED, data);\n if (isPersisted) {\n void completeElement(persistenceFlowRef, elementRef, data);\n }\n onStatusChange?.(elementRef, OnboardingStatus.COMPLETED);\n\n // Auto-advance to next step if not on last\n if (currentStepIndex < totalSteps - 1) {\n setCurrentStepIndex(prev => prev + 1);\n } else {\n setLocalFlowStatus(OnboardingStatus.COMPLETED);\n if (isPersisted) {\n completeFlow(persistenceFlowRef);\n }\n }\n },\n [completeElement, completeFlow, currentStepIndex, isPersisted, persistenceFlowRef, onStatusChange, setLocalElementStatus, setLocalFlowStatus, totalSteps],\n );\n\n const handleDismiss = useCallback(\n (elementRef: string) => {\n setLocalElementStatus(elementRef, OnboardingStatus.DISMISSED);\n onStatusChange?.(elementRef, OnboardingStatus.DISMISSED);\n if (mergedOptions.allowDismiss) {\n setLocalFlowStatus(OnboardingStatus.DISMISSED);\n if (isPersisted) {\n dismissFlow(persistenceFlowRef);\n }\n }\n },\n [dismissFlow, isPersisted, persistenceFlowRef, mergedOptions.allowDismiss, onStatusChange, setLocalElementStatus, setLocalFlowStatus],\n );\n\n const handleAction = useCallback(\n (actionRef: string) => {\n const currentElement = sortedElements[currentStepIndex];\n onAction?.(currentElement?.ref ?? '', actionRef);\n },\n [onAction, sortedElements, currentStepIndex],\n );\n\n const handleNext = useCallback(() => {\n if (currentStepIndex < totalSteps - 1) {\n setCurrentStepIndex(prev => prev + 1);\n return;\n }\n\n const currentElement = sortedElements[currentStepIndex];\n if (!currentElement) {\n setLocalFlowStatus(OnboardingStatus.COMPLETED);\n if (isPersisted) {\n completeFlow(persistenceFlowRef);\n }\n return;\n }\n\n handleComplete(currentElement.ref);\n }, [currentStepIndex, totalSteps, sortedElements, handleComplete, completeFlow, isPersisted, persistenceFlowRef, setLocalFlowStatus]);\n\n const handleBack = useCallback(() => {\n if (currentStepIndex > 0) {\n setCurrentStepIndex(prev => prev - 1);\n }\n }, [currentStepIndex]);\n\n const handleSkip = useCallback(() => {\n setLocalFlowStatus(OnboardingStatus.SKIPPED);\n if (isPersisted) {\n skipFlow(persistenceFlowRef);\n }\n }, [isPersisted, persistenceFlowRef, setLocalFlowStatus, skipFlow]);\n\n // ─── Render ──────────────────────────────────────────────\n\n if (!isReady) return null;\n\n // Hydration-flash guard: a PERSISTED onboarding view must not paint its\n // default (IN_PROGRESS) content before the backend-persisted flow state has\n // loaded — otherwise a view the user already dismissed / completed / skipped\n // flashes in and then vanishes once `flowStates` hydrates. Local-only\n // (non-persisted) views have no backend state to wait for, so they render\n // immediately. Once loading settles, `flowState` reflects the true status\n // (terminal → stays hidden; otherwise renders).\n if (isPersisted && guidanceIsLoading) return null;\n\n if (sortedElements.length === 0) {\n return (\n <div className={cn('p-container-xl text-center text-muted-foreground', className)}>\n {tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'empty')}\n </div>\n );\n }\n\n // A terminal flow status closes the view: the onboarding sequence is over.\n // COMPLETED (last step finished), DISMISSED (user closed), and SKIPPED (user\n // skipped) all mean \"stop rendering\". COMPLETED was previously missing from\n // this gate, so finishing the last step persisted the completion + called\n // `completeFlow(...)` but left the final modal on screen (\"not dismissed at\n // the end\"): the view kept rendering `currentElement` (still the last step).\n // Use the canonical `isTerminalOnboardingStatus` helper so this gate can never\n // drift from the lifecycle status set again (mirrors the GuidanceContext\n // complete/dismiss/skip guards).\n if (isTerminalOnboardingStatus(flowState?.status)) {\n return null;\n }\n\n const currentElement = sortedElements[currentStepIndex];\n if (!currentElement) return null;\n\n /\n The SAME resolution `GuidanceRenderer` uses — custom renderer, then a registered preset, then\n * the engine built-in.\n \n This file kept a private, hard-coded copy of the built-in map and never consulted the registry,\n * so an application that registered a `GUIDANCE_CARD` preset got its component inside a guidance\n * flow and the engine's built-in inside an onboarding VIEW: one element type, two components,\n * decided by which surface happened to show it. The completeness deny-list asserts every guidance\n * slot is swappable, and this was the site at which that stopped being true.\n /\n const Renderer = resolveGuidanceElementRenderer(currentElement.type);\n const elementState = getElementState(currentElement.ref);\n // A missing REQUIRED label renders its key rather than an empty element (#539) — the same\n // translator contract GuidanceRenderer uses, so a view and a flow show a gap identically.\n const scopedT = makeTrGuidanceElement(translationRef, currentElement.ref, resolveGuidanceElementRequiredLabelFields(currentElement));\n\n return (\n <div className={cn('flex flex-col gap-element', className)}>\n {/ Progress bar /}\n {mergedOptions.showProgress && totalSteps > 1 && (\n <div className=\"flex flex-col gap-item-xs\">\n <div className=\"flex justify-between items-center text-[0.8125rem] text-muted-foreground font-medium\">\n <span>\n {tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'stepOf', {\n current: currentStepIndex + 1,\n total: totalSteps,\n })}\n </span>\n <span className=\"text-xs\">\n {completedCount}/{totalSteps}\n </span>\n </div>\n\n {/\n The engine `Progress`, not a hand-rolled track and fill.\n This was a `bg-muted` div wrapping a `bg-primary` div sized by an inline width — the\n THIRD progress bar in this subsystem and the second implementation of one, while\n `GuidanceChecklist` and `ProgressionMilestoneTracker` both used the component. A\n rebrand or a token change reached those two and left this behind.\n\n The accessible name reuses the `stepOf` string rendered directly above: it already says\n exactly what this bar measures, so a second key saying the same thing would be one more\n place for the two to drift apart.\n /}\n <Progress\n value={totalSteps > 0 ? ((currentStepIndex + 1) / totalSteps) 100 : 0}\n className=\"h-1\"\n aria-label={tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'stepOf', {\n current: currentStepIndex + 1,\n total: totalSteps,\n })}\n aria-valuenow={currentStepIndex + 1}\n aria-valuemin={1}\n aria-valuemax={totalSteps}\n />\n </div>\n )}\n\n {/* Current element renderer /}\n {Renderer && (\n <Renderer\n element={currentElement}\n flowRef={flowRef}\n state={elementState}\n onComplete={handleComplete}\n onDismiss={handleDismiss}\n onAction={handleAction}\n t={scopedT}\n />\n )}\n\n {/ Navigation controls /}\n {totalSteps > 1 && (\n <div className=\"flex justify-between items-center pt-item\">\n {/ Left: Back /}\n <div>\n {currentStepIndex > 0 && (\n <Button variant={ButtonVariants_Variant.OUTLINE} size={ButtonSize.SM} onClick={handleBack}>\n {tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'back')}\n </Button>\n )}\n </div>\n\n {/ Right: Skip / Next / Complete /}\n <div className=\"flex gap-item items-center\">\n {mergedOptions.allowSkip && (\n /\n * GHOST, and do NOT reach for a dimmer treatment here. A previous hand-rolled version\n * used `text-muted-foreground/70`, which composited to #7d899b on the light theme's\n * #f8fafc — 3.38:1 where 4.5:1 is required (axe, live stack, 2026-09-09, #533). The\n * ghost recipe is already visibly secondary to the primary action beside it and is\n * held to the contrast floor by the design system rather than by a comment.\n /\n <Button variant={ButtonVariants_Variant.GHOST} size={ButtonSize.SM} onClick={handleSkip}>\n {tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'skip')}\n </Button>\n )}\n\n <Button variant={ButtonVariants_Variant.DEFAULT} size={ButtonSize.SM} onClick={handleNext}>\n {currentStepIndex === totalSteps - 1\n ? tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'complete')\n : tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'next')}\n </Button>\n </div>\n </div>\n )}\n\n {/ Single-step footer fallback: some renderers do not expose their own completion action. */}\n {totalSteps === 1 && (\n <div className=\"flex justify-end gap-item items-center\">\n {mergedOptions.allowDismiss && (\n <Button\n variant={ButtonVariants_Variant.GHOST}\n size={ButtonSize.SM}\n onClick={() => handleDismiss(currentElement.ref)}\n >\n {tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'dismiss')}\n </Button>\n )}\n\n <Button variant={ButtonVariants_Variant.DEFAULT} size={ButtonSize.SM} onClick={handleNext}>\n {tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'complete')}\n </Button>\n </div>\n )}\n </div>\n );\n};\n"]}

package/dist/esm/components/views/onboarding-view/OnboardingView.labels.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"OnboardingView.labels.d.ts","sourceRoot":"","sources":["~~../../../../../~~src/components/views/onboarding-view/OnboardingView.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,mBAAmB,EAEzB,MAAM,qCAAqC,CAAC;AAM7C,eAAO,MAAM,4BAA4B,EAAE,mBAAmB,EAgB7D,CAAC"}
1	+ {"version":3,"file":"OnboardingView.labels.d.ts","sourceRoot":"","sources":["../../../../../../src/components/views/onboarding-view/OnboardingView.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,mBAAmB,EAEzB,MAAM,qCAAqC,CAAC;AAM7C,eAAO,MAAM,4BAA4B,EAAE,mBAAmB,EAgB7D,CAAC"}

package/dist/esm/components/views/onboarding-view/OnboardingView.labels.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"OnboardingView.labels.js","sourceRoot":"","sources":["~~../../../../../~~src/components/views/onboarding-view/OnboardingView.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,SAAS,EAET,uBAAuB,GACxB,MAAM,qCAAqC,CAAC;AAE7C,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,4BAA4B,GAA0B;IACjE,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,iDAAiD,EAAE;IACnG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,oDAAoD,EAAE;IACtG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,mCAAmC,EAAE;IACrF,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,uDAAuD,EAAE;IAC5G,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,kDAAkD,EAAE;IACxG,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,WAAW,EAAE,OAAO,EAAE,4DAA4D,EAAE;IACpH;QACE,GAAG,EAAE,QAAQ;QACb,IAAI,EAAE,SAAS,CAAC,KAAK;QACrB,OAAO,EAAE,0EAA0E;QACnF,MAAM,EAAE;YACN,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,oCAAoC,EAAE;YACjE,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qCAAqC,EAAE;SACjE;KACF;CACF,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,wBAAwB,EAAE,4BAA4B,CAAC,CAAC","sourcesContent":["import {\n FrontendComponentType,\n LabelKind,\n type LabellingUnitaryDef,\n registerComponentLabels,\n} from '@wildo-ai/presets-components-models';\n\n// Companion-only label metadata for this component: keys + params + (where\n// authored) per-key purpose / kind / variable meaning. Statically scanned by\n// the dev companion; NOT imported at runtime, so it never ships in the bundle.\n\nexport const GuidanceOnboardingViewLabels: LabellingUnitaryDef[] = [\n { ref: 'next', kind: LabelKind.BUTTON, purpose: 'Advances the onboarding wizard to the next step' },\n { ref: 'back', kind: LabelKind.BUTTON, purpose: 'Returns the onboarding wizard to the previous step' },\n { ref: 'skip', kind: LabelKind.BUTTON, purpose: 'Skips the current onboarding step' },\n { ref: 'dismiss', kind: LabelKind.BUTTON, purpose: 'Dismisses the onboarding wizard without completing it' },\n { ref: 'complete', kind: LabelKind.BUTTON, purpose: 'Finishes the onboarding wizard on the final step' },\n { ref: 'empty', kind: LabelKind.EMPTY_STATE, purpose: 'Shown when the onboarding document has no steps to display' },\n {\n ref: 'stepOf',\n kind: LabelKind.LABEL,\n purpose: 'Progress indicator showing the current step within the onboarding wizard',\n params: [\n { key: 'current', meaning: 'one-based index of the active step' },\n { key: 'total', meaning: 'total number of steps in the wizard' },\n ],\n },\n];\nregisterComponentLabels(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, GuidanceOnboardingViewLabels);\n"]}
1	+ {"version":3,"file":"OnboardingView.labels.js","sourceRoot":"","sources":["../../../../../../src/components/views/onboarding-view/OnboardingView.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,SAAS,EAET,uBAAuB,GACxB,MAAM,qCAAqC,CAAC;AAE7C,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,4BAA4B,GAA0B;IACjE,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,iDAAiD,EAAE;IACnG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,oDAAoD,EAAE;IACtG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,mCAAmC,EAAE;IACrF,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,uDAAuD,EAAE;IAC5G,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,kDAAkD,EAAE;IACxG,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,WAAW,EAAE,OAAO,EAAE,4DAA4D,EAAE;IACpH;QACE,GAAG,EAAE,QAAQ;QACb,IAAI,EAAE,SAAS,CAAC,KAAK;QACrB,OAAO,EAAE,0EAA0E;QACnF,MAAM,EAAE;YACN,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,oCAAoC,EAAE;YACjE,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,qCAAqC,EAAE;SACjE;KACF;CACF,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,wBAAwB,EAAE,4BAA4B,CAAC,CAAC","sourcesContent":["import {\n FrontendComponentType,\n LabelKind,\n type LabellingUnitaryDef,\n registerComponentLabels,\n} from '@wildo-ai/presets-components-models';\n\n// Companion-only label metadata for this component: keys + params + (where\n// authored) per-key purpose / kind / variable meaning. Statically scanned by\n// the dev companion; NOT imported at runtime, so it never ships in the bundle.\n\nexport const GuidanceOnboardingViewLabels: LabellingUnitaryDef[] = [\n { ref: 'next', kind: LabelKind.BUTTON, purpose: 'Advances the onboarding wizard to the next step' },\n { ref: 'back', kind: LabelKind.BUTTON, purpose: 'Returns the onboarding wizard to the previous step' },\n { ref: 'skip', kind: LabelKind.BUTTON, purpose: 'Skips the current onboarding step' },\n { ref: 'dismiss', kind: LabelKind.BUTTON, purpose: 'Dismisses the onboarding wizard without completing it' },\n { ref: 'complete', kind: LabelKind.BUTTON, purpose: 'Finishes the onboarding wizard on the final step' },\n { ref: 'empty', kind: LabelKind.EMPTY_STATE, purpose: 'Shown when the onboarding document has no steps to display' },\n {\n ref: 'stepOf',\n kind: LabelKind.LABEL,\n purpose: 'Progress indicator showing the current step within the onboarding wizard',\n params: [\n { key: 'current', meaning: 'one-based index of the active step' },\n { key: 'total', meaning: 'total number of steps in the wizard' },\n ],\n },\n];\nregisterComponentLabels(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, GuidanceOnboardingViewLabels);\n"]}

package/dist/esm/components/views/onboarding-view/onboarding-view.utils.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"onboarding-view.utils.d.ts","sourceRoot":"","sources":["~~../../../../../~~src/components/views/onboarding-view/onboarding-view.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAkC,KAAK,wBAAwB,EAAE,MAAM,kEAAkE,CAAC;AACjJ,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAEhG;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,sBAA2D,GACjE,wBAAwB,CAW1B;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,iBAAiB,GACzB,wBAAwB,CAK1B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,wBAAwB,EAClC,UAAU,EAAE,MAAM,GACjB,wBAAwB,CAK1B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,wBAAwB,EAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,gBAAgB,GACvB,wBAAwB,CAO1B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,CAQlF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,OAAO,CAEhF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,wBAAwB,EAClC,IAAI,EAAE,qBAAqB,GAC1B,iBAAiB,EAAE,CAErB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,wBAAwB,GAAG,MAAM,CAE7E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAGhF"}
1	+ {"version":3,"file":"onboarding-view.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/components/views/onboarding-view/onboarding-view.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAkC,KAAK,wBAAwB,EAAE,MAAM,kEAAkE,CAAC;AACjJ,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAEhG;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,sBAA2D,GACjE,wBAAwB,CAW1B;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,iBAAiB,GACzB,wBAAwB,CAK1B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,wBAAwB,EAClC,UAAU,EAAE,MAAM,GACjB,wBAAwB,CAK1B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,wBAAwB,EAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,gBAAgB,GACvB,wBAAwB,CAO1B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,CAQlF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,OAAO,CAEhF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,wBAAwB,EAClC,IAAI,EAAE,qBAAqB,GAC1B,iBAAiB,EAAE,CAErB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,wBAAwB,GAAG,MAAM,CAE7E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAGhF"}

package/dist/esm/components/views/onboarding-view/onboarding-view.utils.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"onboarding-view.utils.js","sourceRoot":"","sources":["~~../../../../../~~src/components/views/onboarding-view/onboarding-view.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,gBAAgB,GAEjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,8BAA8B,EAAiC,MAAM,kEAAkE,CAAC;AACjJ,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAEhG;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAAW,EACX,QAAgC,sBAAsB,CAAC,WAAW;IAElE,OAAO,8BAA8B,CAAC,KAAK,CAAC;QAC1C,GAAG;QACH,KAAK;QACL,OAAO,EAAE;YACP,YAAY,EAAE,IAAI;YAClB,YAAY,EAAE,IAAI;YAClB,YAAY,EAAE,IAAI;SACnB;QACD,QAAQ,EAAE,EAAE;KACb,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,QAAkC,EAClC,OAA0B;IAE1B,OAAO;QACL,GAAG,QAAQ;QACX,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAkC,EAClC,UAAkB;IAElB,OAAO;QACL,GAAG,QAAQ;QACX,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,UAAU,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAkC,EAClC,UAAkB,EAClB,MAAwB;IAExB,OAAO;QACL,GAAG,QAAQ;QACX,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAClC,CAAC,CAAC,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAC5C;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAkC;IACxE,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE7C,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CACxC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,gBAAgB,CAAC,SAAS,CAC7C,CAAC,MAAM,CAAC;IAET,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAkC;IACrE,OAAO,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,gBAAgB,CAAC,SAAS,CAAC,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAkC,EAClC,IAA2B;IAE3B,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAA6B;IACnE,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,8BAA8B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC","sourcesContent":["import {\n OnboardingElementType,\n OnboardingStatus,\n type OnboardingElement,\n} from '@wildo-ai/saas-models';\nimport { OnboardingViewDefinitionSchema, type OnboardingViewDefinition } from '~wildo-frontend-lib/core/config/onboarding-view.frontend.schemas';\nimport { FrontendView_ScopeMode } from '~wildo-frontend-lib/core/config/views-frontend.schemas';\n\n/*\n Create an empty OnboardingViewDefinition with default options.\n \n `ref` is required because every onboarding view needs a stable\n * string identity (used by the spec layer + future ref-based registry\n * lookups; see JSDoc on `OnboardingViewDefinitionSchema.ref`).\n /\nexport function createEmptyOnboardingView(\n ref: string,\n scope: FrontendView_ScopeMode = FrontendView_ScopeMode.APPLICATION,\n): OnboardingViewDefinition {\n return OnboardingViewDefinitionSchema.parse({\n ref,\n scope,\n options: {\n showProgress: true,\n allowDismiss: true,\n persistState: true,\n },\n elements: [],\n });\n}\n\n/\n Add an element to an onboarding document\n /\nexport function addElement(\n document: OnboardingViewDefinition,\n element: OnboardingElement\n): OnboardingViewDefinition {\n return {\n ...document,\n elements: [...document.elements, element],\n };\n}\n\n/\n Remove an element from an onboarding document\n /\nexport function removeElement(\n document: OnboardingViewDefinition,\n elementRef: string\n): OnboardingViewDefinition {\n return {\n ...document,\n elements: document.elements.filter(e => e.ref !== elementRef),\n };\n}\n\n/\n Update element status\n /\nexport function updateElementStatus(\n document: OnboardingViewDefinition,\n elementRef: string,\n status: OnboardingStatus\n): OnboardingViewDefinition {\n return {\n ...document,\n elements: document.elements.map(e =>\n e.ref === elementRef ? { ...e, status } : e\n ),\n };\n}\n\n/\n Get completion percentage\n /\nexport function getCompletionPercentage(document: OnboardingViewDefinition): number {\n if (document.elements.length === 0) return 0;\n \n const completed = document.elements.filter(\n e => e.status === OnboardingStatus.COMPLETED\n ).length;\n \n return Math.round((completed / document.elements.length) 100);\n}\n\n/*\n Check if all elements are completed\n /\nexport function isOnboardingComplete(document: OnboardingViewDefinition): boolean {\n return document.elements.every(e => e.status === OnboardingStatus.COMPLETED);\n}\n\n/\n Get elements by type\n /\nexport function getElementsByType(\n document: OnboardingViewDefinition,\n type: OnboardingElementType\n): OnboardingElement[] {\n return document.elements.filter(e => e.type === type);\n}\n\n/\n Serialize an OnboardingViewDefinition to JSON string\n /\nexport function serializeOnboardingView(doc: OnboardingViewDefinition): string {\n return JSON.stringify(doc, null, 2);\n}\n\n/\n Deserialize a JSON string to an OnboardingViewDefinition\n */\nexport function deserializeOnboardingView(json: string): OnboardingViewDefinition {\n const data = JSON.parse(json);\n return OnboardingViewDefinitionSchema.parse(data);\n}\n\n\n"]}
1	+ {"version":3,"file":"onboarding-view.utils.js","sourceRoot":"","sources":["../../../../../../src/components/views/onboarding-view/onboarding-view.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,gBAAgB,GAEjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,8BAA8B,EAAiC,MAAM,kEAAkE,CAAC;AACjJ,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAEhG;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAAW,EACX,QAAgC,sBAAsB,CAAC,WAAW;IAElE,OAAO,8BAA8B,CAAC,KAAK,CAAC;QAC1C,GAAG;QACH,KAAK;QACL,OAAO,EAAE;YACP,YAAY,EAAE,IAAI;YAClB,YAAY,EAAE,IAAI;YAClB,YAAY,EAAE,IAAI;SACnB;QACD,QAAQ,EAAE,EAAE;KACb,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,QAAkC,EAClC,OAA0B;IAE1B,OAAO;QACL,GAAG,QAAQ;QACX,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAkC,EAClC,UAAkB;IAElB,OAAO;QACL,GAAG,QAAQ;QACX,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,UAAU,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAkC,EAClC,UAAkB,EAClB,MAAwB;IAExB,OAAO;QACL,GAAG,QAAQ;QACX,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAClC,CAAC,CAAC,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAC5C;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAkC;IACxE,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE7C,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CACxC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,gBAAgB,CAAC,SAAS,CAC7C,CAAC,MAAM,CAAC;IAET,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAkC;IACrE,OAAO,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,gBAAgB,CAAC,SAAS,CAAC,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAkC,EAClC,IAA2B;IAE3B,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAA6B;IACnE,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,8BAA8B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC","sourcesContent":["import {\n OnboardingElementType,\n OnboardingStatus,\n type OnboardingElement,\n} from '@wildo-ai/saas-models';\nimport { OnboardingViewDefinitionSchema, type OnboardingViewDefinition } from '~wildo-frontend-lib/core/config/onboarding-view.frontend.schemas';\nimport { FrontendView_ScopeMode } from '~wildo-frontend-lib/core/config/views-frontend.schemas';\n\n/*\n Create an empty OnboardingViewDefinition with default options.\n \n `ref` is required because every onboarding view needs a stable\n * string identity (used by the spec layer + future ref-based registry\n * lookups; see JSDoc on `OnboardingViewDefinitionSchema.ref`).\n /\nexport function createEmptyOnboardingView(\n ref: string,\n scope: FrontendView_ScopeMode = FrontendView_ScopeMode.APPLICATION,\n): OnboardingViewDefinition {\n return OnboardingViewDefinitionSchema.parse({\n ref,\n scope,\n options: {\n showProgress: true,\n allowDismiss: true,\n persistState: true,\n },\n elements: [],\n });\n}\n\n/\n Add an element to an onboarding document\n /\nexport function addElement(\n document: OnboardingViewDefinition,\n element: OnboardingElement\n): OnboardingViewDefinition {\n return {\n ...document,\n elements: [...document.elements, element],\n };\n}\n\n/\n Remove an element from an onboarding document\n /\nexport function removeElement(\n document: OnboardingViewDefinition,\n elementRef: string\n): OnboardingViewDefinition {\n return {\n ...document,\n elements: document.elements.filter(e => e.ref !== elementRef),\n };\n}\n\n/\n Update element status\n /\nexport function updateElementStatus(\n document: OnboardingViewDefinition,\n elementRef: string,\n status: OnboardingStatus\n): OnboardingViewDefinition {\n return {\n ...document,\n elements: document.elements.map(e =>\n e.ref === elementRef ? { ...e, status } : e\n ),\n };\n}\n\n/\n Get completion percentage\n /\nexport function getCompletionPercentage(document: OnboardingViewDefinition): number {\n if (document.elements.length === 0) return 0;\n \n const completed = document.elements.filter(\n e => e.status === OnboardingStatus.COMPLETED\n ).length;\n \n return Math.round((completed / document.elements.length) 100);\n}\n\n/*\n Check if all elements are completed\n /\nexport function isOnboardingComplete(document: OnboardingViewDefinition): boolean {\n return document.elements.every(e => e.status === OnboardingStatus.COMPLETED);\n}\n\n/\n Get elements by type\n /\nexport function getElementsByType(\n document: OnboardingViewDefinition,\n type: OnboardingElementType\n): OnboardingElement[] {\n return document.elements.filter(e => e.type === type);\n}\n\n/\n Serialize an OnboardingViewDefinition to JSON string\n /\nexport function serializeOnboardingView(doc: OnboardingViewDefinition): string {\n return JSON.stringify(doc, null, 2);\n}\n\n/\n Deserialize a JSON string to an OnboardingViewDefinition\n */\nexport function deserializeOnboardingView(json: string): OnboardingViewDefinition {\n const data = JSON.parse(json);\n return OnboardingViewDefinitionSchema.parse(data);\n}\n\n\n"]}

package/dist/esm/core/app-shell/AppShellBuildingBlocks.d.ts ADDED Viewed

@@ -0,0 +1,86 @@
+import React from 'react';
+import { HorizontalPlacement, ShellRegion } from '@wildo-ai/presets-components-models';
+import type { StatusBarPlacement } from '../../core/config/app-level-components.frontend.schemas';
+import type { AppShellLayoutInfo } from './app-shell.schemas';
+/**
+ * Latches the FIRST time the shell becomes ready.
+ *
+ * `isLayoutReady` derives from configuration presence and can drop transiently after bootstrap (an
+ * organization switch reloading config, for example). Replacing the mounted shell with a loading state on such
+ * a drop would unmount every provider and zone below it and destroy navigation state — the failure mode
+ * `AppLoadingGate` documents. So a layout shows its loading state only while this returns `false`.
+ */
+export declare function useAppShellFirstReady(isLayoutReady: boolean): boolean;
+/**
+ * The shell's loading state: a centred spinner on the page background, announced politely. What every layout
+ * shows while `useAppShellFirstReady` says the shell has never been ready — one component rather than a copy per
+ * layout, so the loading state is the same whatever the disposal.
+ */
+export declare function AppShellLoadingState(): React.JSX.Element;
+export interface AppShellProvidersProps {
+    /** The result of `useAppShellLayout()`, computed once by the layout and shared with every outlet. */
+    layout: AppShellLayoutInfo;
+    children: React.ReactNode;
+}
+/**
+ * The providers every shell region reads, and nothing else — they render no DOM of their own:
+ *
+ * - `PortalContainerContext`, holding the `<main>` element `AppShellContentOutlet` registers, so overlays opened
+ *   from any region portal into the content area — or, when the layout renders `AppShellOverlayPortalLayer`, that
+ *   layer instead;
+ * - `HostedComponentInteractionsProvider`, the single owner of the open state and the open hotkey of the
+ *   interactive hosted components (command menu, notification center, quick switcher), which may be hosted in the
+ *   menubar and the sidebar at once.
+ */
+export declare function AppShellProviders({ layout, children }: AppShellProvidersProps): React.JSX.Element;
+/**
+ * A dedicated layer every overlay (dialog, sheet, menu, popover, tooltip) portals into, for a layout whose regions
+ * are TRANSFORMED — a 3D placement. Render it once, inside the providers but OUTSIDE the transformed subtree; the
+ * providers then prefer it to `<main>`. A layout that transforms nothing does not need it.
+ *
+ * It is a zero-size, untransformed, fixed box at the viewport's origin: an overlay positioned `fixed` resolves
+ * against the viewport, one positioned `absolute` against the viewport's origin, so floating content lands where its
+ * trigger is on screen. It carries the stacking tier overlays need above a layout's own layers.
+ */
+export declare function AppShellOverlayPortalLayer(): React.JSX.Element;
+/**
+ * Which region to render, and — for a region that sits at an edge — at which edge. The content area is not
+ * among them: it has its own outlet, because it owns `<main>` and the page.
+ *
+ * `placement` renders the region only when the application configured THAT placement. A layout that places the
+ * same region at two positions — as the default layout does for the sidebar's start and end edges — renders one
+ * outlet per edge. Omitted, the region renders at whatever placement is configured. The type admits only the
+ * placement axis the region has, so a sidebar cannot be asked for a vertical edge and render nothing.
+ */
+export type AppShellRegionOutletProps = {
+    region: ShellRegion.SIDEBAR | ShellRegion.UTILITY_PANEL;
+    placement?: HorizontalPlacement.START | HorizontalPlacement.END;
+} | {
+    region: ShellRegion.STATUS_BAR;
+    placement?: StatusBarPlacement;
+} | {
+    region: ShellRegion.ACTIVITY_BAR | ShellRegion.MENUBAR | ShellRegion.TOOLBAR;
+    placement?: never;
+};
+/**
+ * Renders one shell region's component — the registry-resolved wrapper, with its placement prop — when the
+ * application configures that region (and, if `placement` is given, at that placement). Renders nothing
+ * otherwise, so placing an outlet for every region is always safe.
+ */
+export declare function AppShellRegionOutlet(props: AppShellRegionOutletProps): React.JSX.Element | null;
+export interface AppShellContentOutletProps {
+    /** Classes for the `<main>` element — the layout decides how the content area sizes within its arrangement. */
+    className?: string;
+    /** The route outlet the layout container receives; rendered by the navigation zones while their stack is empty. */
+    children?: React.ReactNode;
+}
+/**
+ * The content area: the `<main>` landmark carrying `ShellRegion.CONTENT`, the navigation zones, and the floating
+ * quick-action button when configured. Its element is registered with `AppShellProviders` as the portal
+ * container, so it must be rendered exactly once, inside the providers.
+ */
+export declare function AppShellContentOutlet({ className, children }: AppShellContentOutletProps): React.JSX.Element;
+/** The shell's overlay layer: navigation dialogs and sheets, then guidance (tours, tooltips, highlights). */
+export declare function AppShellOverlaysOutlet(): React.JSX.Element;
+/** @wildo_source:part:end saas.frontend.app-shell.building-blocks */
+//# sourceMappingURL=AppShellBuildingBlocks.d.ts.map

package/dist/esm/core/app-shell/AppShellBuildingBlocks.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"AppShellBuildingBlocks.d.ts","sourceRoot":"","sources":["../../../../../src/core/app-shell/AppShellBuildingBlocks.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsE,MAAM,OAAO,CAAC;AAE3F,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAqC,MAAM,qCAAqC,CAAC;AAe1H,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uEAAuE,CAAC;AAEhH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAoE9D;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,OAAO,GAAG,OAAO,CAMrE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAUxD;AAED,MAAM,WAAW,sBAAsB;IACrC,qGAAqG;IACrG,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,sBAAsB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAqBjG;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAM9D;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,yBAAyB,GACjC;IAAE,MAAM,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,aAAa,CAAC;IAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC,KAAK,GAAG,mBAAmB,CAAC,GAAG,CAAA;CAAE,GAC5H;IAAE,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,kBAAkB,CAAA;CAAE,GAClE;IAAE,MAAM,EAAE,WAAW,CAAC,YAAY,GAAG,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAExG;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA8B/F;AAED,MAAM,WAAW,0BAA0B;IACzC,+GAA+G;IAC/G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mHAAmH;IACnH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,0BAA0B,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAW5G;AAED,6GAA6G;AAC7G,wBAAgB,sBAAsB,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAO1D;AACD,qEAAqE"}

package/dist/esm/core/app-shell/AppShellBuildingBlocks.js ADDED Viewed

@@ -0,0 +1,187 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useState } from 'react';
+import { ShellRegion, SurfaceVariant } from '@wildo-ai/presets-components-models';
+import { LoadingSpinner } from '../../components/feedback/loading-spinner.js';
+import { Surface } from '../../components/sections/surface.js';
+import { NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE } from '../../core/ui/surface-a11y.utils.js';
+import { ApplicationLevel_ActivityBar } from '../../components/navigation/app-level/ApplicationLevel_ActivityBar.js';
+import { ApplicationLevel_MenuBar } from '../../components/navigation/app-level/ApplicationLevel_MenuBar.js';
+import { ApplicationLevel_QuickActionButton } from '../../components/navigation/app-level/ApplicationLevel_QuickActionButton.js';
+import { ApplicationLevel_Sidebar } from '../../components/navigation/app-level/ApplicationLevel_Sidebar.js';
+import { ApplicationLevel_StatusBar } from '../../components/navigation/app-level/ApplicationLevel_StatusBar.js';
+import { ApplicationLevel_Toolbar } from '../../components/navigation/app-level/ApplicationLevel_Toolbar.js';
+import { ApplicationLevel_UtilityPanel } from '../../components/navigation/app-level/ApplicationLevel_UtilityPanel.js';
+import { HostedComponentInteractionsProvider } from '../../components/navigation/app-level/HostedComponentInteractionsProvider.js';
+import { GuidanceRenderer } from '../../core/guidance/GuidanceRenderer.js';
+import { NavigationContentAreas, NavigationOverlays } from '../../core/navigation/NavigationContentAreas.js';
+import { PortalContainerContext } from './PortalContainerContext.js';
+/** @wildo_source:part:start saas.frontend.app-shell.building-blocks facet:layer:frontend facet:family:app-shell facet:audience:app-developer */
+/**
+ * # App shell building blocks
+ *
+ * The signed-in shell is a LAYOUT — where the regions sit — over parts that do not depend on the layout: the
+ * region components themselves (each resolved from the component registry by its wrapper), the content area,
+ * the overlays, and two providers every region reads. These building blocks are those parts, so a layout
+ * preset only decides the ARRANGEMENT. `AppLayoutPreset_MainContainer_Default` is composed from them, and any
+ * other layout container an application registers should be too — a different arrangement of the same regions,
+ * or, later, an alternative rendering that draws decoration around them.
+ *
+ * A layout preset uses them like this:
+ *
+ * ```tsx
+ * const layout = useAppShellLayout();
+ * const hasBeenReady = useAppShellFirstReady(layout.isLayoutReady);
+ * if (!layout.isLayoutReady && !hasBeenReady) return <AppShellLoadingState />;
+ * return (
+ *   <AppShellProviders layout={layout}>
+ *     <div className="my-arrangement">
+ *       <AppShellRegionOutlet region={ShellRegion.SIDEBAR} placement={HorizontalPlacement.START} />
+ *       <AppShellRegionOutlet region={ShellRegion.MENUBAR} />
+ *       <AppShellContentOutlet className="flex-1 relative min-w-0">{children}</AppShellContentOutlet>
+ *       <AppShellOverlaysOutlet />
+ *     </div>
+ *   </AppShellProviders>
+ * );
+ * ```
+ *
+ * Four rules keep a custom layout correct:
+ *
+ * - **Render `AppShellProviders` exactly once, around the whole shell.** It owns the single open state and the
+ *   single hotkey registration of the command menu, notification center and quick switcher; two copies would
+ *   make one shortcut open two dialogs.
+ * - **Place every region the application configures.** An outlet renders nothing when its region is not
+ *   configured, so placing an outlet is always safe; leaving one out silently drops a region.
+ * - **Render `AppShellContentOutlet` exactly once.** It is the `<main>` landmark, and overlays portal into it —
+ *   unless the layout also renders `AppShellOverlayPortalLayer`, which then takes the overlays instead. A layout that
+ *   transforms its regions (a 3D placement) must render that layer OUTSIDE the transformed subtree: a transformed
+ *   ancestor is the containing block of every `position: fixed` descendant, so a dialog in `<main>` would be confined
+ *   to the pane and a menu would be placed in the wrong coordinates.
+ * - **Give the root `position: relative`, not `isolation: isolate`,** when the theme may declare a background
+ *   layer. That layer is painted in its own stacking context above ordinary in-flow content, so shell text with
+ *   no positioned ancestor is painted UNDER it; positioning the root lifts the whole shell above it. `isolate`
+ *   would also lift it, but would make the shell one stacking context, so an overlay outside the shell with a
+ *   lower z-index (a consent prompt) would paint over the shell's own dialogs.
+ */
+/** The layout decisions `useAppShellLayout()` computed, shared with every outlet below the providers. */
+const AppShellLayoutContext = createContext(null);
+/** Lets the content outlet hand its `<main>` element to the providers, which expose it as the portal container. */
+const AppShellPortalTargetContext = createContext(null);
+/** Lets `AppShellOverlayPortalLayer` hand its element to the providers, which then prefer it over `<main>`. */
+const AppShellOverlayLayerTargetContext = createContext(null);
+function useAppShellLayoutContext(consumer) {
+    const layout = useContext(AppShellLayoutContext);
+    if (!layout) {
+        throw new Error(`${consumer} must be rendered inside <AppShellProviders>, which supplies the layout it places regions from.`);
+    }
+    return layout;
+}
+/**
+ * Latches the FIRST time the shell becomes ready.
+ *
+ * `isLayoutReady` derives from configuration presence and can drop transiently after bootstrap (an
+ * organization switch reloading config, for example). Replacing the mounted shell with a loading state on such
+ * a drop would unmount every provider and zone below it and destroy navigation state — the failure mode
+ * `AppLoadingGate` documents. So a layout shows its loading state only while this returns `false`.
+ */
+export function useAppShellFirstReady(isLayoutReady) {
+    const [hasLayoutBeenReady, setHasLayoutBeenReady] = useState(false);
+    useEffect(() => {
+        if (isLayoutReady)
+            setHasLayoutBeenReady(true);
+    }, [isLayoutReady]);
+    return hasLayoutBeenReady;
+}
+/**
+ * The shell's loading state: a centred spinner on the page background, announced politely. What every layout
+ * shows while `useAppShellFirstReady` says the shell has never been ready — one component rather than a copy per
+ * layout, so the loading state is the same whatever the disposal.
+ */
+export function AppShellLoadingState() {
+    return (_jsx(Surface, { asChild: true, emitPolicyVars: false, variant: SurfaceVariant.SHELL, policyOverride: NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE, children: _jsx("div", { className: "h-screen w-screen bg-background flex items-center justify-center", role: "status", "aria-live": "polite", children: _jsx("div", { className: "text-center", children: _jsx(LoadingSpinner, { size: 32, className: "text-primary mx-auto mb-field", "aria-hidden": "true" }) }) }) }));
+}
+/**
+ * The providers every shell region reads, and nothing else — they render no DOM of their own:
+ *
+ * - `PortalContainerContext`, holding the `<main>` element `AppShellContentOutlet` registers, so overlays opened
+ *   from any region portal into the content area — or, when the layout renders `AppShellOverlayPortalLayer`, that
+ *   layer instead;
+ * - `HostedComponentInteractionsProvider`, the single owner of the open state and the open hotkey of the
+ *   interactive hosted components (command menu, notification center, quick switcher), which may be hosted in the
+ *   menubar and the sidebar at once.
+ */
+export function AppShellProviders({ layout, children }) {
+    const [portalContainer, setPortalContainer] = useState(null);
+    const [overlayLayer, setOverlayLayer] = useState(null);
+    const registerPortalTarget = useCallback((node) => {
+        setPortalContainer(node);
+    }, []);
+    const registerOverlayLayer = useCallback((node) => {
+        setOverlayLayer(node);
+    }, []);
+    return (_jsx(AppShellLayoutContext.Provider, { value: layout, children: _jsx(AppShellPortalTargetContext.Provider, { value: registerPortalTarget, children: _jsx(AppShellOverlayLayerTargetContext.Provider, { value: registerOverlayLayer, children: _jsx(PortalContainerContext.Provider, { value: overlayLayer ?? portalContainer, children: _jsx(HostedComponentInteractionsProvider, { children: children }) }) }) }) }));
+}
+/**
+ * A dedicated layer every overlay (dialog, sheet, menu, popover, tooltip) portals into, for a layout whose regions
+ * are TRANSFORMED — a 3D placement. Render it once, inside the providers but OUTSIDE the transformed subtree; the
+ * providers then prefer it to `<main>`. A layout that transforms nothing does not need it.
+ *
+ * It is a zero-size, untransformed, fixed box at the viewport's origin: an overlay positioned `fixed` resolves
+ * against the viewport, one positioned `absolute` against the viewport's origin, so floating content lands where its
+ * trigger is on screen. It carries the stacking tier overlays need above a layout's own layers.
+ */
+export function AppShellOverlayPortalLayer() {
+    const register = useContext(AppShellOverlayLayerTargetContext);
+    if (!register) {
+        throw new Error('AppShellOverlayPortalLayer must be rendered inside <AppShellProviders>, which exposes it as the portal container.');
+    }
+    return _jsx("div", { ref: register, "data-shell-overlay-layer": "", className: "fixed left-0 top-0 z-50 h-0 w-0" });
+}
+/**
+ * Renders one shell region's component — the registry-resolved wrapper, with its placement prop — when the
+ * application configures that region (and, if `placement` is given, at that placement). Renders nothing
+ * otherwise, so placing an outlet for every region is always safe.
+ */
+export function AppShellRegionOutlet(props) {
+    const layout = useAppShellLayoutContext('AppShellRegionOutlet');
+    const { region, placement } = props;
+    const at = (configured) => placement === undefined || placement === configured ? configured : null;
+    switch (region) {
+        case ShellRegion.ACTIVITY_BAR:
+            return layout.hasActivityBar ? _jsx(ApplicationLevel_ActivityBar, {}) : null;
+        case ShellRegion.MENUBAR:
+            return layout.hasMenubar ? _jsx(ApplicationLevel_MenuBar, {}) : null;
+        case ShellRegion.TOOLBAR:
+            return layout.hasToolbar ? _jsx(ApplicationLevel_Toolbar, {}) : null;
+        case ShellRegion.SIDEBAR: {
+            const sidebarPlacement = at(layout.sidebarPlacement);
+            return layout.hasSidebar && sidebarPlacement ? _jsx(ApplicationLevel_Sidebar, { placement: sidebarPlacement }) : null;
+        }
+        case ShellRegion.UTILITY_PANEL: {
+            const utilityPanelPlacement = at(layout.utilityPanelPlacement);
+            return layout.hasUtilityPanel && utilityPanelPlacement ? _jsx(ApplicationLevel_UtilityPanel, { position: utilityPanelPlacement }) : null;
+        }
+        case ShellRegion.STATUS_BAR: {
+            const statusBarPlacement = at(layout.statusBarPlacement);
+            return layout.hasStatusBar && statusBarPlacement ? _jsx(ApplicationLevel_StatusBar, { placement: statusBarPlacement }) : null;
+        }
+        default: {
+            const unhandled = region;
+            throw new Error(`AppShellRegionOutlet has no rendering for region "${String(unhandled)}".`);
+        }
+    }
+}
+/**
+ * The content area: the `<main>` landmark carrying `ShellRegion.CONTENT`, the navigation zones, and the floating
+ * quick-action button when configured. Its element is registered with `AppShellProviders` as the portal
+ * container, so it must be rendered exactly once, inside the providers.
+ */
+export function AppShellContentOutlet({ className, children }) {
+    const layout = useAppShellLayoutContext('AppShellContentOutlet');
+    const registerPortalTarget = useContext(AppShellPortalTargetContext);
+    return (_jsxs("main", { ref: registerPortalTarget ?? undefined, "data-component-area": ShellRegion.CONTENT, className: className, children: [_jsx(NavigationContentAreas, { routerChildren: children }), layout.hasQuickActionButton && _jsx(ApplicationLevel_QuickActionButton, { placement: "floating" })] }));
+}
+/** The shell's overlay layer: navigation dialogs and sheets, then guidance (tours, tooltips, highlights). */
+export function AppShellOverlaysOutlet() {
+    return (_jsxs(_Fragment, { children: [_jsx(NavigationOverlays, {}), _jsx(GuidanceRenderer, {})] }));
+}
+//# sourceMappingURL=AppShellBuildingBlocks.js.map

package/dist/esm/core/app-shell/AppShellBuildingBlocks.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"AppShellBuildingBlocks.js","sourceRoot":"","sources":["../../../../../src/core/app-shell/AppShellBuildingBlocks.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { createContext, useCallback, useContext, useEffect, useState } from 'react';\n\nimport { HorizontalPlacement, ShellRegion, SurfaceVariant, VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport { LoadingSpinner } from '~wildo-frontend-lib/components/feedback/loading-spinner';\nimport { Surface } from '~wildo-frontend-lib/components/sections/surface';\nimport { NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE } from '~wildo-frontend-lib/core/ui/surface-a11y.utils';\nimport { ApplicationLevel_ActivityBar } from '~wildo-frontend-lib/components/navigation/app-level/ApplicationLevel_ActivityBar';\nimport { ApplicationLevel_MenuBar } from '~wildo-frontend-lib/components/navigation/app-level/ApplicationLevel_MenuBar';\nimport { ApplicationLevel_QuickActionButton } from '~wildo-frontend-lib/components/navigation/app-level/ApplicationLevel_QuickActionButton';\nimport { ApplicationLevel_Sidebar } from '~wildo-frontend-lib/components/navigation/app-level/ApplicationLevel_Sidebar';\nimport { ApplicationLevel_StatusBar } from '~wildo-frontend-lib/components/navigation/app-level/ApplicationLevel_StatusBar';\nimport { ApplicationLevel_Toolbar } from '~wildo-frontend-lib/components/navigation/app-level/ApplicationLevel_Toolbar';\nimport { ApplicationLevel_UtilityPanel } from '~wildo-frontend-lib/components/navigation/app-level/ApplicationLevel_UtilityPanel';\nimport { HostedComponentInteractionsProvider } from '~wildo-frontend-lib/components/navigation/app-level/HostedComponentInteractionsProvider';\nimport { GuidanceRenderer } from '~wildo-frontend-lib/core/guidance/GuidanceRenderer';\nimport { NavigationContentAreas, NavigationOverlays } from '~wildo-frontend-lib/core/navigation/NavigationContentAreas';\n\nimport type { StatusBarPlacement } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\n\nimport type { AppShellLayoutInfo } from './app-shell.schemas';\nimport { PortalContainerContext } from './PortalContainerContext';\n\n/** @wildo_source:part:start saas.frontend.app-shell.building-blocks facet:layer:frontend facet:family:app-shell facet:audience:app-developer */\n/**\n * # App shell building blocks\n *\n * The signed-in shell is a LAYOUT — where the regions sit — over parts that do not depend on the layout: the\n * region components themselves (each resolved from the component registry by its wrapper), the content area,\n * the overlays, and two providers every region reads. These building blocks are those parts, so a layout\n * preset only decides the ARRANGEMENT. `AppLayoutPreset_MainContainer_Default` is composed from them, and any\n * other layout container an application registers should be too — a different arrangement of the same regions,\n * or, later, an alternative rendering that draws decoration around them.\n *\n * A layout preset uses them like this:\n *\n * ```tsx\n * const layout = useAppShellLayout();\n * const hasBeenReady = useAppShellFirstReady(layout.isLayoutReady);\n * if (!layout.isLayoutReady && !hasBeenReady) return <AppShellLoadingState />;\n * return (\n * <AppShellProviders layout={layout}>\n * <div className=\"my-arrangement\">\n * <AppShellRegionOutlet region={ShellRegion.SIDEBAR} placement={HorizontalPlacement.START} />\n * <AppShellRegionOutlet region={ShellRegion.MENUBAR} />\n * <AppShellContentOutlet className=\"flex-1 relative min-w-0\">{children}</AppShellContentOutlet>\n * <AppShellOverlaysOutlet />\n * </div>\n * </AppShellProviders>\n * );\n * ```\n *\n * Four rules keep a custom layout correct:\n *\n * - **Render `AppShellProviders` exactly once, around the whole shell.** It owns the single open state and the\n * single hotkey registration of the command menu, notification center and quick switcher; two copies would\n * make one shortcut open two dialogs.\n * - **Place every region the application configures.** An outlet renders nothing when its region is not\n * configured, so placing an outlet is always safe; leaving one out silently drops a region.\n * - **Render `AppShellContentOutlet` exactly once.** It is the `<main>` landmark, and overlays portal into it —\n * unless the layout also renders `AppShellOverlayPortalLayer`, which then takes the overlays instead. A layout that\n * transforms its regions (a 3D placement) must render that layer OUTSIDE the transformed subtree: a transformed\n * ancestor is the containing block of every `position: fixed` descendant, so a dialog in `<main>` would be confined\n * to the pane and a menu would be placed in the wrong coordinates.\n * - **Give the root `position: relative`, not `isolation: isolate`,** when the theme may declare a background\n * layer. That layer is painted in its own stacking context above ordinary in-flow content, so shell text with\n * no positioned ancestor is painted UNDER it; positioning the root lifts the whole shell above it. `isolate`\n * would also lift it, but would make the shell one stacking context, so an overlay outside the shell with a\n * lower z-index (a consent prompt) would paint over the shell's own dialogs.\n */\n\n/** The layout decisions `useAppShellLayout()` computed, shared with every outlet below the providers. */\nconst AppShellLayoutContext = createContext<AppShellLayoutInfo | null>(null);\n\n/** Lets the content outlet hand its `<main>` element to the providers, which expose it as the portal container. */\nconst AppShellPortalTargetContext = createContext<((node: HTMLElement | null) => void) | null>(null);\n\n/** Lets `AppShellOverlayPortalLayer` hand its element to the providers, which then prefer it over `<main>`. */\nconst AppShellOverlayLayerTargetContext = createContext<((node: HTMLElement | null) => void) | null>(null);\n\nfunction useAppShellLayoutContext(consumer: string): AppShellLayoutInfo {\n const layout = useContext(AppShellLayoutContext);\n if (!layout) {\n throw new Error(`${consumer} must be rendered inside <AppShellProviders>, which supplies the layout it places regions from.`);\n }\n return layout;\n}\n\n/**\n * Latches the FIRST time the shell becomes ready.\n *\n * `isLayoutReady` derives from configuration presence and can drop transiently after bootstrap (an\n * organization switch reloading config, for example). Replacing the mounted shell with a loading state on such\n * a drop would unmount every provider and zone below it and destroy navigation state — the failure mode\n * `AppLoadingGate` documents. So a layout shows its loading state only while this returns `false`.\n */\nexport function useAppShellFirstReady(isLayoutReady: boolean): boolean {\n const [hasLayoutBeenReady, setHasLayoutBeenReady] = useState(false);\n useEffect(() => {\n if (isLayoutReady) setHasLayoutBeenReady(true);\n }, [isLayoutReady]);\n return hasLayoutBeenReady;\n}\n\n/**\n * The shell's loading state: a centred spinner on the page background, announced politely. What every layout\n * shows while `useAppShellFirstReady` says the shell has never been ready — one component rather than a copy per\n * layout, so the loading state is the same whatever the disposal.\n */\nexport function AppShellLoadingState(): React.JSX.Element {\n return (\n <Surface asChild emitPolicyVars={false} variant={SurfaceVariant.SHELL} policyOverride={NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE}>\n <div className=\"h-screen w-screen bg-background flex items-center justify-center\" role=\"status\" aria-live=\"polite\">\n <div className=\"text-center\">\n <LoadingSpinner size={32} className=\"text-primary mx-auto mb-field\" aria-hidden=\"true\" />\n </div>\n </div>\n </Surface>\n );\n}\n\nexport interface AppShellProvidersProps {\n /** The result of `useAppShellLayout()`, computed once by the layout and shared with every outlet. */\n layout: AppShellLayoutInfo;\n children: React.ReactNode;\n}\n\n/**\n * The providers every shell region reads, and nothing else — they render no DOM of their own:\n *\n * - `PortalContainerContext`, holding the `<main>` element `AppShellContentOutlet` registers, so overlays opened\n * from any region portal into the content area — or, when the layout renders `AppShellOverlayPortalLayer`, that\n * layer instead;\n * - `HostedComponentInteractionsProvider`, the single owner of the open state and the open hotkey of the\n * interactive hosted components (command menu, notification center, quick switcher), which may be hosted in the\n * menubar and the sidebar at once.\n */\nexport function AppShellProviders({ layout, children }: AppShellProvidersProps): React.JSX.Element {\n const [portalContainer, setPortalContainer] = useState<HTMLElement | null>(null);\n const [overlayLayer, setOverlayLayer] = useState<HTMLElement | null>(null);\n const registerPortalTarget = useCallback((node: HTMLElement | null) => {\n setPortalContainer(node);\n }, []);\n const registerOverlayLayer = useCallback((node: HTMLElement | null) => {\n setOverlayLayer(node);\n }, []);\n return (\n <AppShellLayoutContext.Provider value={layout}>\n <AppShellPortalTargetContext.Provider value={registerPortalTarget}>\n <AppShellOverlayLayerTargetContext.Provider value={registerOverlayLayer}>\n {/* The dedicated overlay layer wins when a layout renders one; otherwise overlays stay in `<main>`. */}\n <PortalContainerContext.Provider value={overlayLayer ?? portalContainer}>\n <HostedComponentInteractionsProvider>{children}</HostedComponentInteractionsProvider>\n </PortalContainerContext.Provider>\n </AppShellOverlayLayerTargetContext.Provider>\n </AppShellPortalTargetContext.Provider>\n </AppShellLayoutContext.Provider>\n );\n}\n\n/**\n * A dedicated layer every overlay (dialog, sheet, menu, popover, tooltip) portals into, for a layout whose regions\n * are TRANSFORMED — a 3D placement. Render it once, inside the providers but OUTSIDE the transformed subtree; the\n * providers then prefer it to `<main>`. A layout that transforms nothing does not need it.\n *\n * It is a zero-size, untransformed, fixed box at the viewport's origin: an overlay positioned `fixed` resolves\n * against the viewport, one positioned `absolute` against the viewport's origin, so floating content lands where its\n * trigger is on screen. It carries the stacking tier overlays need above a layout's own layers.\n */\nexport function AppShellOverlayPortalLayer(): React.JSX.Element {\n const register = useContext(AppShellOverlayLayerTargetContext);\n if (!register) {\n throw new Error('AppShellOverlayPortalLayer must be rendered inside <AppShellProviders>, which exposes it as the portal container.');\n }\n return <div ref={register} data-shell-overlay-layer=\"\" className=\"fixed left-0 top-0 z-50 h-0 w-0\" />;\n}\n\n/**\n * Which region to render, and — for a region that sits at an edge — at which edge. The content area is not\n * among them: it has its own outlet, because it owns `<main>` and the page.\n *\n * `placement` renders the region only when the application configured THAT placement. A layout that places the\n * same region at two positions — as the default layout does for the sidebar's start and end edges — renders one\n * outlet per edge. Omitted, the region renders at whatever placement is configured. The type admits only the\n * placement axis the region has, so a sidebar cannot be asked for a vertical edge and render nothing.\n */\nexport type AppShellRegionOutletProps =\n | { region: ShellRegion.SIDEBAR | ShellRegion.UTILITY_PANEL; placement?: HorizontalPlacement.START | HorizontalPlacement.END }\n | { region: ShellRegion.STATUS_BAR; placement?: StatusBarPlacement }\n | { region: ShellRegion.ACTIVITY_BAR | ShellRegion.MENUBAR | ShellRegion.TOOLBAR; placement?: never };\n\n/**\n * Renders one shell region's component — the registry-resolved wrapper, with its placement prop — when the\n * application configures that region (and, if `placement` is given, at that placement). Renders nothing\n * otherwise, so placing an outlet for every region is always safe.\n */\nexport function AppShellRegionOutlet(props: AppShellRegionOutletProps): React.JSX.Element | null {\n const layout = useAppShellLayoutContext('AppShellRegionOutlet');\n const { region, placement } = props;\n const at = <T extends HorizontalPlacement | VerticalPlacement>(configured: T): T | null =>\n placement === undefined || placement === configured ? configured : null;\n\n switch (region) {\n case ShellRegion.ACTIVITY_BAR:\n return layout.hasActivityBar ? <ApplicationLevel_ActivityBar /> : null;\n case ShellRegion.MENUBAR:\n return layout.hasMenubar ? <ApplicationLevel_MenuBar /> : null;\n case ShellRegion.TOOLBAR:\n return layout.hasToolbar ? <ApplicationLevel_Toolbar /> : null;\n case ShellRegion.SIDEBAR: {\n const sidebarPlacement = at(layout.sidebarPlacement);\n return layout.hasSidebar && sidebarPlacement ? <ApplicationLevel_Sidebar placement={sidebarPlacement} /> : null;\n }\n case ShellRegion.UTILITY_PANEL: {\n const utilityPanelPlacement = at(layout.utilityPanelPlacement);\n return layout.hasUtilityPanel && utilityPanelPlacement ? <ApplicationLevel_UtilityPanel position={utilityPanelPlacement} /> : null;\n }\n case ShellRegion.STATUS_BAR: {\n const statusBarPlacement = at(layout.statusBarPlacement);\n return layout.hasStatusBar && statusBarPlacement ? <ApplicationLevel_StatusBar placement={statusBarPlacement} /> : null;\n }\n default: {\n const unhandled: never = region;\n throw new Error(`AppShellRegionOutlet has no rendering for region \"${String(unhandled)}\".`);\n }\n }\n}\n\nexport interface AppShellContentOutletProps {\n /** Classes for the `<main>` element — the layout decides how the content area sizes within its arrangement. */\n className?: string;\n /** The route outlet the layout container receives; rendered by the navigation zones while their stack is empty. */\n children?: React.ReactNode;\n}\n\n/**\n * The content area: the `<main>` landmark carrying `ShellRegion.CONTENT`, the navigation zones, and the floating\n * quick-action button when configured. Its element is registered with `AppShellProviders` as the portal\n * container, so it must be rendered exactly once, inside the providers.\n */\nexport function AppShellContentOutlet({ className, children }: AppShellContentOutletProps): React.JSX.Element {\n const layout = useAppShellLayoutContext('AppShellContentOutlet');\n const registerPortalTarget = useContext(AppShellPortalTargetContext);\n return (\n <main ref={registerPortalTarget ?? undefined} data-component-area={ShellRegion.CONTENT} className={className}>\n <NavigationContentAreas routerChildren={children} />\n\n {/* Floating Quick Action Button */}\n {layout.hasQuickActionButton && <ApplicationLevel_QuickActionButton placement=\"floating\" />}\n </main>\n );\n}\n\n/** The shell's overlay layer: navigation dialogs and sheets, then guidance (tours, tooltips, highlights). */\nexport function AppShellOverlaysOutlet(): React.JSX.Element {\n return (\n <>\n <NavigationOverlays />\n <GuidanceRenderer />\n </>\n );\n}\n/** @wildo_source:part:end saas.frontend.app-shell.building-blocks */\n"]}

package/dist/esm/core/app-shell/PortalContainerContext.d.ts CHANGED Viewed

@@ -10,8 +10,11 @@ export interface PortalTargetResolution {
  * portal their content into the provided container instead of `document.body`.
  *
  * Primary use cases:
- * - Containing overlays within an alternate rendering context (e.g. a Three.js
- *   `<Html>` panel) so they don't escape the spatial container.
+ * - Keeping overlays inside the shell's content area: `AppShellProviders` sets it to the `<main>` element
+ *   `AppShellContentOutlet` registers, for every layout composed from the shell building blocks — or to the
+ *   `AppShellOverlayPortalLayer` a layout that transforms its regions renders outside them. (An earlier
+ *   version of this note named a Three.js `<Html>` panel; that design was rejected because such a panel is a
+ *   separate React root that loses every context — see #1820.)
  * - Scoping overlay z-index stacking to a specific subtree.
  *
  * When `null` (the default), overlays portal to `document.body` — matching the

package/dist/esm/core/app-shell/PortalContainerContext.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"PortalContainerContext.d.ts","sourceRoot":"","sources":["~~../../../../~~src/core/app-shell/PortalContainerContext.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EAClB,MAAM,qCAAqC,CAAC;AAG7C,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,WAAW,GAAG,SAAS,CAAC;IACnC,YAAY,EAAE,OAAO,CAAC;CACvB;AAYD~~;;;;;;;;;;;;;GAaG~~;AACH,QAAA,MAAM,sBAAsB,sCAA0C,CAAC;AAEvE;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,GAAG,SAAS,CAG5D;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,cAAc,EACvB,cAAc,CAAC,EAAE,wBAAwB,GACxC,sBAAsB,CA+CxB;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAelG;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,cAAc,EACvB,cAAc,CAAC,EAAE,wBAAwB,GACxC,MAAM,CAKR;AAED,OAAO,EAAE,sBAAsB,EAAE,CAAC"}
1	+ {"version":3,"file":"PortalContainerContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/app-shell/PortalContainerContext.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EAClB,MAAM,qCAAqC,CAAC;AAG7C,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,WAAW,GAAG,SAAS,CAAC;IACnC,YAAY,EAAE,OAAO,CAAC;CACvB;AAYD;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,sBAAsB,sCAA0C,CAAC;AAEvE;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,GAAG,SAAS,CAG5D;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,cAAc,EACvB,cAAc,CAAC,EAAE,wBAAwB,GACxC,sBAAsB,CA+CxB;AAED,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAelG;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,cAAc,EACvB,cAAc,CAAC,EAAE,wBAAwB,GACxC,MAAM,CAKR;AAED,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/esm/core/app-shell/PortalContainerContext.js CHANGED Viewed

@@ -14,8 +14,11 @@ function resolveCustomPortalTarget(customPortalTargetId) {
  * portal their content into the provided container instead of `document.body`.
  *
  * Primary use cases:
- * - Containing overlays within an alternate rendering context (e.g. a Three.js
- *   `<Html>` panel) so they don't escape the spatial container.
+ * - Keeping overlays inside the shell's content area: `AppShellProviders` sets it to the `<main>` element
+ *   `AppShellContentOutlet` registers, for every layout composed from the shell building blocks — or to the
+ *   `AppShellOverlayPortalLayer` a layout that transforms its regions renders outside them. (An earlier
+ *   version of this note named a Three.js `<Html>` panel; that design was rejected because such a panel is a
+ *   separate React root that loses every context — see #1820.)
  * - Scoping overlay z-index stacking to a specific subtree.
  *
  * When `null` (the default), overlays portal to `document.body` — matching the