@wildo-ai/saas-frontend-lib 1.0.1 → 1.1.1

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

@@ -9,10 +9,11 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * directly from a static onboarding document.
  */
 import { useState, useMemo, useCallback, useEffect, useId } from 'react';
-import { OnboardingElementType, OnboardingStatus, } from '@wildo-ai/saas-models';
+import { OnboardingElementType, OnboardingStatus, isTerminalOnboardingStatus, } from '@wildo-ai/saas-models';
 import { FrontendComponentType } from '@wildo-ai/presets-components-models';
 import { useGuidance } from '../../../core/guidance/useGuidance.js';
 import { useI18n } from '../../../core/i18n/useI18n.js';
+import { cn } from '../../../core/ui/cn.js';
 // Element renderers
 import { GuidanceChecklist } from '../../../core/guidance/renderers/GuidanceChecklist.js';
 import { GuidanceChecklistItem } from '../../../core/guidance/renderers/GuidanceChecklistItem.js';
@@ -39,16 +40,74 @@ const ELEMENT_RENDERER_MAP = {
 };
 // ─── Component ───────────────────────────────────────────────
 export const OnboardingView = ({ document: doc, options: optionsOverride = {}, className = '', onStatusChange, onAction, viewRef: viewRefProp, guidanceFlowRef: guidanceFlowRefProp, }) => {
-    const { flowStates, completeElement, completeFlow, dismissFlow, skipFlow } = useGuidance();
+    const { flowStates, completeElement, completeFlow, dismissFlow, skipFlow, isFlowPersistable, isLoading: guidanceIsLoading } = useGuidance();
     const localFlowId = useId();
     const guidanceFlowRef = guidanceFlowRefProp;
-    const flowRef = guidanceFlowRef ?? `onboarding-local-${localFlowId}`;
-    const translationRef = viewRefProp || guidanceFlowRef || 'onboarding';
+    /**
+     * Persistence identity follows CONTENT: default to the document's own ref when
+     * no explicit `guidanceFlowRef` override is given (mirrors `translationRef`).
+     * Dismiss / complete / skip then persist under `doc.ref` for a first-class
+     * onboarding view registered in app config — no parallel guidance flow needed.
+     */
+    const persistenceFlowRef = guidanceFlowRef ?? doc.ref;
+    /**
+     * Whether persistence will actually happen — `persistenceFlowRef` resolves to a
+     * registered guidance flow OR an app-config onboarding view. When false the view
+     * is a transient local-only embed (ad-hoc inline document not in config).
+     */
+    const isPersisted = isFlowPersistable(persistenceFlowRef);
+    const flowRef = persistenceFlowRef ?? `onboarding-local-${localFlowId}`;
+    /**
+     * i18n namespace for this view's element labels. Element labels are read as
+     * `guidance.{translationRef}.elements.{el}.{key}` (see `makeTrGuidanceElement`
+     * below and `tGuidanceElement` in `core/i18n/I18nContext`).
+     *
+     * Translation identity follows CONTENT, not persistence. The elements this
+     * view renders are `doc.elements`, so their labels belong under the document's
+     * OWN ref — symmetric with `GuidanceRenderer`, which scopes a flow's elements
+     * under `flow.ref`. `guidanceFlowRef` is a SEPARATE, persistence-only identity
+     * (it drives complete/dismiss/skip + the `flowStates` lookup) and may name a
+     * flow whose element set differs entirely from `doc.elements` — e.g. a 3-step
+     * wizard document (`focus-hub-step-*`) persisted through a single-card flow
+     * (`focus-hub-guide-card`). Namespacing the document's element refs under that
+     * foreign flow ref resolves keys that were never generated for them: the
+     * footgun this precedence closes.
+     *
+     * Precedence:
+     *   1. `viewRefProp`     — explicit override; caller knows the canonical ref
+     *                          (e.g. this view is one surface of a larger document).
+     *   2. `doc.ref`         — the document's own content identity (the normal
+     *                          case; `OnboardingViewDefinition.ref` is
+     *                          `z.string().min(1)`, so it is present and non-empty
+     *                          for every well-formed document).
+     *   3. `guidanceFlowRef` — last-resort identity ONLY when `doc.ref` is absent
+     *                          (untyped/malformed callers); preserves the prior
+     *                          persisted-flow lookup instead of collapsing to (4).
+     *   4. `'onboarding'`    — generic terminal fallback.
+     *
+     * Rejected `viewRefProp || guidanceFlowRef || doc.ref || 'onboarding'`: that
+     * keeps PERSISTENCE ahead of CONTENT, so any caller passing a divergent
+     * `guidanceFlowRef` without a `viewRef` would re-open the exact footgun above.
+     * It is also behaviorally identical to this ordering for every current
+     * consumer (the only `guidanceFlowRef` caller also passes `viewRef`), so the
+     * "smaller diff" argument buys no safety — only the wrong default semantics.
+     */
+    const translationRef = viewRefProp || doc.ref || guidanceFlowRef || 'onboarding';
     const guidanceKeys = useMemo(() => [`guidance.${translationRef}`], [translationRef]);
-    const { makeTrGuidanceElement, tComponent } = useI18n({
+    const { makeTrGuidanceElement, tComponent, isReady } = useI18n({
         component: FrontendComponentType.GUIDANCE_ONBOARDING_VIEW,
         keys: guidanceKeys,
     });
+    useEffect(() => {
+        if (!isPersisted) {
+            const elementRefs = doc.elements.map(el => el.ref).join(', ');
+            console.warn(`[OnboardingView] Mounted with no persistable identity (ref="${persistenceFlowRef ?? '(none)'}", ` +
+                `viewRef="${viewRefProp ?? '(none)'}", elements=[${elementRefs}]). Dismiss, complete, and skip ` +
+                'actions will only affect local component state and will NOT be persisted to the backend. To ' +
+                'persist, either declare this onboarding view (by ref) in the app frontend config so it is ' +
+                'registered, or pass the guidanceFlowRef prop matching a registered GuidanceFlowDefinition.');
+        }
+    }, []); // eslint-disable-line react-hooks/exhaustive-deps -- intentional mount-only check
     const mergedOptions = useMemo(() => ({ ...doc.options, ...optionsOverride }), [doc.options, optionsOverride]);
     // Sort elements by order
     const sortedElements = useMemo(() => [...doc.elements].sort((a, b) => a.order - b.order), [doc.elements]);
@@ -68,8 +127,8 @@ export const OnboardingView = ({ document: doc, options: optionsOverride = {}, c
             triggerCount: 1,
         });
     }, [flowRef]);
-    // Derive flow state from GuidanceContext
-    const flowState = guidanceFlowRef ? (flowStates[guidanceFlowRef] ?? localFlowState) : localFlowState;
+    // Derive flow state from GuidanceContext when persistable; else local transient.
+    const flowState = isPersisted ? (flowStates[persistenceFlowRef] ?? localFlowState) : localFlowState;
     const getElementState = useCallback((elementRef) => flowState?.elements?.[elementRef], [flowState]);
     // Count completed elements
     const completedCount = useMemo(() => {
@@ -105,8 +164,8 @@ export const OnboardingView = ({ document: doc, options: optionsOverride = {}, c
     }, []);
     const handleComplete = useCallback((elementRef, data) => {
         setLocalElementStatus(elementRef, OnboardingStatus.COMPLETED, data);
-        if (guidanceFlowRef) {
-            completeElement(guidanceFlowRef, elementRef, data);
+        if (isPersisted) {
+            completeElement(persistenceFlowRef, elementRef, data);
         }
         onStatusChange?.(elementRef, OnboardingStatus.COMPLETED);
         // Auto-advance to next step if not on last
@@ -115,21 +174,21 @@ export const OnboardingView = ({ document: doc, options: optionsOverride = {}, c
         }
         else {
             setLocalFlowStatus(OnboardingStatus.COMPLETED);
-            if (guidanceFlowRef) {
-                completeFlow(guidanceFlowRef);
+            if (isPersisted) {
+                completeFlow(persistenceFlowRef);
             }
         }
-    }, [completeElement, completeFlow, currentStepIndex, guidanceFlowRef, onStatusChange, setLocalElementStatus, setLocalFlowStatus, totalSteps]);
+    }, [completeElement, completeFlow, currentStepIndex, isPersisted, persistenceFlowRef, onStatusChange, setLocalElementStatus, setLocalFlowStatus, totalSteps]);
     const handleDismiss = useCallback((elementRef) => {
         setLocalElementStatus(elementRef, OnboardingStatus.DISMISSED);
         onStatusChange?.(elementRef, OnboardingStatus.DISMISSED);
         if (mergedOptions.allowDismiss) {
             setLocalFlowStatus(OnboardingStatus.DISMISSED);
-            if (guidanceFlowRef) {
-                dismissFlow(guidanceFlowRef);
+            if (isPersisted) {
+                dismissFlow(persistenceFlowRef);
             }
         }
-    }, [dismissFlow, guidanceFlowRef, mergedOptions.allowDismiss, onStatusChange, setLocalElementStatus, setLocalFlowStatus]);
+    }, [dismissFlow, isPersisted, persistenceFlowRef, mergedOptions.allowDismiss, onStatusChange, setLocalElementStatus, setLocalFlowStatus]);
     const handleAction = useCallback((actionRef) => {
         const currentElement = sortedElements[currentStepIndex];
         onAction?.(currentElement?.ref ?? '', actionRef);
@@ -142,13 +201,13 @@ export const OnboardingView = ({ document: doc, options: optionsOverride = {}, c
         const currentElement = sortedElements[currentStepIndex];
         if (!currentElement) {
             setLocalFlowStatus(OnboardingStatus.COMPLETED);
-            if (guidanceFlowRef) {
-                completeFlow(guidanceFlowRef);
+            if (isPersisted) {
+                completeFlow(persistenceFlowRef);
             }
             return;
         }
         handleComplete(currentElement.ref);
-    }, [currentStepIndex, totalSteps, sortedElements, handleComplete, completeFlow, guidanceFlowRef, setLocalFlowStatus]);
+    }, [currentStepIndex, totalSteps, sortedElements, handleComplete, completeFlow, isPersisted, persistenceFlowRef, setLocalFlowStatus]);
     const handleBack = useCallback(() => {
         if (currentStepIndex > 0) {
             setCurrentStepIndex(prev => prev - 1);
@@ -156,13 +215,36 @@ export const OnboardingView = ({ document: doc, options: optionsOverride = {}, c
     }, [currentStepIndex]);
     const handleSkip = useCallback(() => {
         setLocalFlowStatus(OnboardingStatus.SKIPPED);
-        if (guidanceFlowRef) {
-            skipFlow(guidanceFlowRef);
+        if (isPersisted) {
+            skipFlow(persistenceFlowRef);
         }
-    }, [guidanceFlowRef, setLocalFlowStatus, skipFlow]);
+    }, [isPersisted, persistenceFlowRef, setLocalFlowStatus, skipFlow]);
     // ─── Render ──────────────────────────────────────────────
+    if (!isReady)
+        return null;
+    // Hydration-flash guard: a PERSISTED onboarding view must not paint its
+    // default (IN_PROGRESS) content before the backend-persisted flow state has
+    // loaded — otherwise a view the user already dismissed / completed / skipped
+    // flashes in and then vanishes once `flowStates` hydrates. Local-only
+    // (non-persisted) views have no backend state to wait for, so they render
+    // immediately. Once loading settles, `flowState` reflects the true status
+    // (terminal → stays hidden; otherwise renders).
+    if (isPersisted && guidanceIsLoading)
+        return null;
     if (sortedElements.length === 0) {
-        return (_jsx("div", { className: `p-container-xl text-center text-muted-foreground ${className}`, children: tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'empty') }));
+        return (_jsx("div", { className: cn('p-container-xl text-center text-muted-foreground', className), children: tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'empty') }));
+    }
+    // A terminal flow status closes the view: the onboarding sequence is over.
+    // COMPLETED (last step finished), DISMISSED (user closed), and SKIPPED (user
+    // skipped) all mean "stop rendering". COMPLETED was previously missing from
+    // this gate, so finishing the last step persisted the completion + called
+    // `completeFlow(...)` but left the final modal on screen ("not dismissed at
+    // the end"): the view kept rendering `currentElement` (still the last step).
+    // Use the canonical `isTerminalOnboardingStatus` helper so this gate can never
+    // drift from the lifecycle status set again (mirrors the GuidanceContext
+    // complete/dismiss/skip guards).
+    if (isTerminalOnboardingStatus(flowState?.status)) {
+        return null;
     }
     const currentElement = sortedElements[currentStepIndex];
     if (!currentElement)
@@ -170,11 +252,20 @@ export const OnboardingView = ({ document: doc, options: optionsOverride = {}, c
     const Renderer = ELEMENT_RENDERER_MAP[currentElement.type];
     const elementState = getElementState(currentElement.ref);
     const scopedT = makeTrGuidanceElement(translationRef, currentElement.ref);
-    return (_jsxs("div", { className: `flex flex-col gap-element ${className}`, children: [mergedOptions.showProgress && totalSteps > 1 && (_jsxs("div", { className: "flex flex-col gap-item-xs", children: [_jsxs("div", { className: "flex justify-between items-center text-[0.8125rem] text-muted-foreground font-medium", children: [_jsx("span", { children: tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'stepOf', {
+    return (_jsxs("div", { className: cn('flex flex-col gap-element', className), children: [mergedOptions.showProgress && totalSteps > 1 && (_jsxs("div", { className: "flex flex-col gap-item-xs", children: [_jsxs("div", { className: "flex justify-between items-center text-[0.8125rem] text-muted-foreground font-medium", children: [_jsx("span", { children: tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'stepOf', {
                                     current: currentStepIndex + 1,
                                     total: totalSteps,
-                                }) }), _jsxs("span", { className: "text-xs", children: [completedCount, "/", totalSteps] })] }), _jsx("div", { className: "w-full h-1 bg-muted rounded-sm overflow-hidden", role: "progressbar", "aria-valuenow": currentStepIndex + 1, "aria-valuemin": 1, "aria-valuemax": totalSteps, children: _jsx("div", { className: "h-full bg-primary rounded-sm motion-safe:transition-[width] motion-safe:duration-[var(--motion-duration-normal)] motion-safe:ease-out", style: { width: `${totalSteps > 0 ? ((currentStepIndex + 1) / totalSteps) * 100 : 0}%` } }) })] })), Renderer && (_jsx(Renderer, { element: currentElement, flowRef: flowRef, state: elementState, onComplete: handleComplete, onDismiss: handleDismiss, onAction: handleAction, t: scopedT })), totalSteps > 1 && (_jsxs("div", { className: "flex justify-between items-center pt-item", children: [_jsx("div", { children: currentStepIndex > 0 && (_jsx("button", { type: "button", onClick: handleBack, 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-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:rounded pointer-coarse:min-h-11", children: tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'back') })) }), _jsxs("div", { className: "flex gap-item items-center", children: [mergedOptions.allowSkip && (_jsx("button", { type: "button", onClick: handleSkip, className: "px-card-sm py-item text-[0.8125rem] font-medium text-muted-foreground/70 bg-transparent border-none cursor-pointer motion-safe:transition-colors hover:text-muted-foreground focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:rounded pointer-coarse:min-h-11", children: tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'skip') })), _jsx("button", { type: "button", onClick: handleNext, 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-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:rounded pointer-coarse:min-h-11", children: currentStepIndex === totalSteps - 1
+                                }) }), _jsxs("span", { className: "text-xs", children: [completedCount, "/", totalSteps] })] }), _jsx("div", { className: "w-full h-1 bg-muted rounded-sm overflow-hidden", role: "progressbar", "aria-valuenow": currentStepIndex + 1, "aria-valuemin": 1, "aria-valuemax": totalSteps, children: _jsx("div", { className: "h-full bg-primary rounded-sm motion-safe:transition-[width] motion-safe:duration-[var(--motion-duration-normal)] motion-safe:ease-out", style: { width: `${totalSteps > 0 ? ((currentStepIndex + 1) / totalSteps) * 100 : 0}%` } }) })] })), Renderer && (_jsx(Renderer, { element: currentElement, flowRef: flowRef, state: elementState, onComplete: handleComplete, onDismiss: handleDismiss, onAction: handleAction, t: scopedT })), totalSteps > 1 && (_jsxs("div", { className: "flex justify-between items-center pt-item", children: [_jsx("div", { children: currentStepIndex > 0 && (
+                        // V-5: candidate for Button/IconButton migration — see audit doc
+                        // (raw <button> reimplements OUTLINE/GHOST recipe with non-ladder text-[0.8125rem])
+                        _jsx("button", { type: "button", onClick: handleBack, 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", children: tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'back') })) }), _jsxs("div", { className: "flex gap-item items-center", children: [mergedOptions.allowSkip && (
+                            // V-5: candidate for Button/IconButton migration — see audit doc
+                            // (raw <button> reimplements GHOST recipe with non-ladder text-[0.8125rem])
+                            _jsx("button", { type: "button", onClick: handleSkip, className: "px-card-sm py-item text-[0.8125rem] font-medium text-muted-foreground/70 bg-transparent border-none cursor-pointer motion-safe:transition-colors hover:text-muted-foreground focus-ring-offset pointer-coarse:min-h-11", children: tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'skip') })), _jsx("button", { type: "button", onClick: handleNext, 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", children: currentStepIndex === totalSteps - 1
                                     ? tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'complete')
-                                    : tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'next') })] })] })), totalSteps === 1 && (_jsxs("div", { className: "flex justify-end gap-item items-center", children: [mergedOptions.allowDismiss && (_jsx("button", { type: "button", onClick: () => handleDismiss(currentElement.ref), className: "px-card-sm py-item text-[0.8125rem] font-medium text-muted-foreground/70 bg-transparent border-none cursor-pointer motion-safe:transition-colors hover:text-muted-foreground focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:rounded pointer-coarse:min-h-11", children: tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'dismiss') })), _jsx("button", { type: "button", onClick: handleNext, 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-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:rounded pointer-coarse:min-h-11", children: tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'complete') })] }))] }));
+                                    : tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'next') })] })] })), totalSteps === 1 && (_jsxs("div", { className: "flex justify-end gap-item items-center", children: [mergedOptions.allowDismiss && (
+                    // V-5: candidate for Button/IconButton migration — see audit doc
+                    // (raw <button> reimplements GHOST recipe with non-ladder text-[0.8125rem])
+                    _jsx("button", { type: "button", onClick: () => handleDismiss(currentElement.ref), className: "px-card-sm py-item text-[0.8125rem] font-medium text-muted-foreground/70 bg-transparent border-none cursor-pointer motion-safe:transition-colors hover:text-muted-foreground focus-ring-offset pointer-coarse:min-h-11", children: tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'dismiss') })), _jsx("button", { type: "button", onClick: handleNext, 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", children: tComponent(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, 'complete') })] }))] }));
 };
-//# sourceMappingURL=OnboardingView.js.map
+//# sourceMappingURL=OnboardingView.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"OnboardingView.js","sourceRoot":"","sources":["../../../../../src/components/views/onboarding-view/OnboardingView.tsx"],"names":[],"mappings":"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"}
+{"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                className=\"px-card-sm py-item text-[0.8125rem] font-medium text-muted-foreground/70 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/70 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"]}

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

@@ -0,0 +1,3 @@
+import { type LabellingUnitaryDef } from '@wildo-ai/presets-components-models';
+export declare const GuidanceOnboardingViewLabels: LabellingUnitaryDef[];
+//# sourceMappingURL=OnboardingView.labels.d.ts.map

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

@@ -0,0 +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

@@ -0,0 +1,23 @@
+import { FrontendComponentType, LabelKind, registerComponentLabels, } from '@wildo-ai/presets-components-models';
+// Companion-only label metadata for this component: keys + params + (where
+// authored) per-key purpose / kind / variable meaning. Statically scanned by
+// the dev companion; NOT imported at runtime, so it never ships in the bundle.
+export const GuidanceOnboardingViewLabels = [
+    { ref: 'next', kind: LabelKind.BUTTON, purpose: 'Advances the onboarding wizard to the next step' },
+    { ref: 'back', kind: LabelKind.BUTTON, purpose: 'Returns the onboarding wizard to the previous step' },
+    { ref: 'skip', kind: LabelKind.BUTTON, purpose: 'Skips the current onboarding step' },
+    { ref: 'dismiss', kind: LabelKind.BUTTON, purpose: 'Dismisses the onboarding wizard without completing it' },
+    { ref: 'complete', kind: LabelKind.BUTTON, purpose: 'Finishes the onboarding wizard on the final step' },
+    { ref: 'empty', kind: LabelKind.EMPTY_STATE, purpose: 'Shown when the onboarding document has no steps to display' },
+    {
+        ref: 'stepOf',
+        kind: LabelKind.LABEL,
+        purpose: 'Progress indicator showing the current step within the onboarding wizard',
+        params: [
+            { key: 'current', meaning: 'one-based index of the active step' },
+            { key: 'total', meaning: 'total number of steps in the wizard' },
+        ],
+    },
+];
+registerComponentLabels(FrontendComponentType.GUIDANCE_ONBOARDING_VIEW, GuidanceOnboardingViewLabels);
+//# sourceMappingURL=OnboardingView.labels.js.map

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

@@ -0,0 +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

@@ -1,10 +1,14 @@
-import { OnboardingElementType, OnboardingStatus, type OnboardingElement, type OnboardingChecklistItem, type OnboardingTourStep } from '@wildo-ai/saas-models';
-import { type OnboardingViewDefinition } from '../../../core/config/onboarding-view.frontend.schemas.js';
-import { FrontendView_ScopeMode } from '../../../core/config/views-frontend.schemas.js';
+import { OnboardingElementType, OnboardingStatus, type OnboardingElement } from '@wildo-ai/saas-models';
+import { type OnboardingViewDefinition } from '../../../core/config/onboarding-view.frontend.schemas';
+import { FrontendView_ScopeMode } from '../../../core/config/views-frontend.schemas';
 /**
- * Create an empty OnboardingViewDefinition with default options
+ * Create an empty OnboardingViewDefinition with default options.
+ *
+ * `ref` is required because every onboarding view needs a stable
+ * string identity (used by the spec layer + future ref-based registry
+ * lookups; see JSDoc on `OnboardingViewDefinitionSchema.ref`).
  */
-export declare function createEmptyOnboardingView(scope?: FrontendView_ScopeMode): OnboardingViewDefinition;
+export declare function createEmptyOnboardingView(ref: string, scope?: FrontendView_ScopeMode): OnboardingViewDefinition;
 /**
  * Add an element to an onboarding document
  */
@@ -37,12 +41,4 @@ export declare function serializeOnboardingView(doc: OnboardingViewDefinition):
  * Deserialize a JSON string to an OnboardingViewDefinition
  */
 export declare function deserializeOnboardingView(json: string): OnboardingViewDefinition;
-/**
- * Create a sample checklist item
- */
-export declare function createChecklistItem(ref: string, title: string, actionLabel?: string): OnboardingChecklistItem;
-/**
- * Create sample tour steps
- */
-export declare function createTourSteps(count: number): OnboardingTourStep[];
 //# sourceMappingURL=onboarding-view.utils.d.ts.map

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

@@ -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,EAEhB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAkC,KAAK,wBAAwB,EAAE,MAAM,kEAAkE,CAAC;AACjJ,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAEhG;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,GAAE,sBAA2D,GACjE,wBAAwB,CAU1B;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;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,uBAAuB,CAUzB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAQnE"}
+{"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

@@ -1,11 +1,16 @@
-import { OnboardingElementType, OnboardingStatus, TourStepPlacement, } from '@wildo-ai/saas-models';
+import { OnboardingStatus, } from '@wildo-ai/saas-models';
 import { OnboardingViewDefinitionSchema } from '../../../core/config/onboarding-view.frontend.schemas.js';
 import { FrontendView_ScopeMode } from '../../../core/config/views-frontend.schemas.js';
 /**
- * Create an empty OnboardingViewDefinition with default options
+ * Create an empty OnboardingViewDefinition with default options.
+ *
+ * `ref` is required because every onboarding view needs a stable
+ * string identity (used by the spec layer + future ref-based registry
+ * lookups; see JSDoc on `OnboardingViewDefinitionSchema.ref`).
  */
-export function createEmptyOnboardingView(scope = FrontendView_ScopeMode.APPLICATION) {
+export function createEmptyOnboardingView(ref, scope = FrontendView_ScopeMode.APPLICATION) {
     return OnboardingViewDefinitionSchema.parse({
+        ref,
         scope,
         options: {
             showProgress: true,
@@ -76,30 +81,4 @@ export function deserializeOnboardingView(json) {
     const data = JSON.parse(json);
     return OnboardingViewDefinitionSchema.parse(data);
 }
-/**
- * Create a sample checklist item
- */
-export function createChecklistItem(ref, title, actionLabel) {
-    return {
-        ref,
-        type: OnboardingElementType.CHECKLIST_ITEM,
-        title,
-        status: OnboardingStatus.NOT_STARTED,
-        order: 0,
-        completed: false,
-        actionLabel,
-    };
-}
-/**
- * Create sample tour steps
- */
-export function createTourSteps(count) {
-    return Array.from({ length: count }, (_, i) => ({
-        ref: `step-${i + 1}`,
-        title: `Step ${i + 1}`,
-        description: `Description for step ${i + 1}`,
-        order: i,
-        placement: TourStepPlacement.BOTTOM,
-    }));
-}
-//# sourceMappingURL=onboarding-view.utils.js.map
+//# sourceMappingURL=onboarding-view.utils.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"onboarding-view.utils.js","sourceRoot":"","sources":["../../../../../src/components/views/onboarding-view/onboarding-view.utils.ts"],"names":[],"mappings":"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"}
+{"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/PortalContainerContext.d.ts

@@ -1,3 +1,8 @@
+import { SurfaceVariant, type DeepPartialSurfacePolicy, type StackingTier } from '@wildo-ai/presets-components-models';
+export interface PortalTargetResolution {
+    container: HTMLElement | undefined;
+    shouldPortal: boolean;
+}
 /**
  * Provides a DOM element that Radix UI Portal components should render into.
  *
@@ -24,5 +29,8 @@ declare const PortalContainerContext: import("react").Context<HTMLElement>;
  * ```
  */
 export declare function usePortalContainer(): HTMLElement | undefined;
+export declare function useSurfacePolicyPortalTarget(variant: SurfaceVariant, policyOverride?: DeepPartialSurfacePolicy): PortalTargetResolution;
+export declare function resolveSurfacePolicyStackingClass(tier: StackingTier | 'reset' | undefined): string;
+export declare function useSurfacePolicyStackingClass(variant: SurfaceVariant, policyOverride?: DeepPartialSurfacePolicy): string;
 export { PortalContainerContext };
 //# sourceMappingURL=PortalContainerContext.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PortalContainerContext.d.ts","sourceRoot":"","sources":["../../../../src/core/app-shell/PortalContainerContext.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,sBAAsB,sCAA0C,CAAC;AAEvE;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,GAAG,SAAS,CAG5D;AAED,OAAO,EAAE,sBAAsB,EAAE,CAAC"}
+{"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"}

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

@@ -1,4 +1,12 @@
-import { createContext, useContext } from 'react';
+import { createContext, useContext, useEffect, useLayoutEffect, useState } from 'react';
+import { useUI } from '../../core/ui/useUI.js';
+const useIsomorphicLayoutEffect = typeof window !== 'undefined' ? useLayoutEffect : useEffect;
+function resolveCustomPortalTarget(customPortalTargetId) {
+    if (!customPortalTargetId || typeof document === 'undefined') {
+        return null;
+    }
+    return document.getElementById(customPortalTargetId);
+}
 /**
  * Provides a DOM element that Radix UI Portal components should render into.
  *
@@ -28,5 +36,62 @@ export function usePortalContainer() {
     const container = useContext(PortalContainerContext);
     return container ?? undefined;
 }
+export function useSurfacePolicyPortalTarget(variant, policyOverride) {
+    const appPortalContainer = usePortalContainer();
+    const { getSurfacePolicy } = useUI();
+    const portalTarget = getSurfacePolicy?.(variant, policyOverride)?.stacking?.portalTarget;
+    const customPortalTargetId = typeof portalTarget === 'string' && portalTarget !== 'inline' && portalTarget !== 'app-portal' && portalTarget !== 'reset'
+        ? portalTarget
+        : null;
+    const [customPortalContainer, setCustomPortalContainer] = useState(() => resolveCustomPortalTarget(customPortalTargetId));
+    useIsomorphicLayoutEffect(() => {
+        if (!customPortalTargetId || typeof document === 'undefined') {
+            setCustomPortalContainer(null);
+            return;
+        }
+        const existingTarget = resolveCustomPortalTarget(customPortalTargetId);
+        setCustomPortalContainer(existingTarget);
+        if (existingTarget || typeof MutationObserver === 'undefined') {
+            return;
+        }
+        const observer = new MutationObserver(() => {
+            const nextTarget = resolveCustomPortalTarget(customPortalTargetId);
+            if (!nextTarget)
+                return;
+            setCustomPortalContainer(nextTarget);
+            observer.disconnect();
+        });
+        observer.observe(document.body, { childList: true, subtree: true });
+        return () => observer.disconnect();
+    }, [customPortalTargetId]);
+    if (portalTarget === 'inline') {
+        return { container: undefined, shouldPortal: false };
+    }
+    if (customPortalContainer) {
+        return { container: customPortalContainer, shouldPortal: true };
+    }
+    return { container: appPortalContainer, shouldPortal: true };
+}
+export function resolveSurfacePolicyStackingClass(tier) {
+    switch (tier) {
+        case 'content':
+            return 'z-(--z-content)';
+        case 'transient':
+            return 'z-(--z-transient)';
+        case 'guidance':
+            return 'z-(--z-guidance)';
+        case 'critical':
+            return 'z-(--z-critical)';
+        case 'overlay':
+        case 'reset':
+        default:
+            return 'z-(--z-overlay)';
+    }
+}
+export function useSurfacePolicyStackingClass(variant, policyOverride) {
+    const { getSurfacePolicy } = useUI();
+    const stackingTier = getSurfacePolicy?.(variant, policyOverride)?.stacking?.stackingTier;
+    return resolveSurfacePolicyStackingClass(stackingTier);
+}
 export { PortalContainerContext };
-//# sourceMappingURL=PortalContainerContext.js.map
+//# sourceMappingURL=PortalContainerContext.js.map