@wildo-ai/saas-frontend-lib 1.1.3 → 1.1.5

package/dist/esm/core/guidance/GuidanceRenderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"GuidanceRenderer.js","sourceRoot":"","sources":["../../../../src/core/guidance/GuidanceRenderer.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * GuidanceRenderer\n *\n * Root renderer for the Guidance System. Reads active flows from\n * GuidanceContext and delegates rendering to render-mode-specific\n * sub-renderers (OVERLAY, INLINE, CHECKLIST). Each element within\n * a flow is mapped to its type-specific renderer component via\n * RENDERER_MAP.\n */\n\nimport React, { useCallback, useMemo } from 'react';\nimport ReactDOM from 'react-dom';\nimport type {\n  GuidanceFlowDefinition,\n  GuidanceElementState,\n  OnboardingElement,\n} from '@wildo-ai/saas-models';\nimport {\n  GuidanceRenderMode,\n  OnboardingElementType,\n} from '@wildo-ai/saas-models';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { useGuidance } from './useGuidance';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { APP_LEVEL_NAVIGATION_SOURCE } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { usePortalContainer } from '~wildo-frontend-lib/core/app-shell/PortalContainerContext';\n\n// Renderers — imported lazily to avoid circular deps; wired in RENDERER_MAP below\nimport { GuidanceChecklist, type GuidanceChecklistProps } from './renderers/GuidanceChecklist';\nimport { GuidanceChecklistItem } from './renderers/GuidanceChecklistItem';\nimport { GuidanceTour } from './renderers/GuidanceTour';\nimport { GuidanceTooltip } from './renderers/GuidanceTooltip';\nimport { GuidanceModal } from './renderers/GuidanceModal';\nimport { GuidanceBanner } from './renderers/GuidanceBanner';\nimport { GuidanceAnnouncement } from './renderers/GuidanceAnnouncement';\nimport { GuidanceBadge } from './renderers/GuidanceBadge';\nimport { GuidanceCard } from './renderers/GuidanceCard';\nimport { GuidanceSurvey } from './renderers/GuidanceSurvey';\n\n// ─── Shared Props Interface ──────────────────────────────────────\n\nexport interface GuidanceElementRendererProps {\n  element: OnboardingElement;\n  flowRef: string;\n  state: GuidanceElementState | undefined;\n  onComplete: (elementRef: string, data?: { surveyAnswers?: Record<string, unknown>; lastStepIndex?: number }) => void;\n  onDismiss: (elementRef: string) => void;\n  onAction: (actionRef: string) => void;\n  /** i18n translate function scoped to this flow+element. Returns undefined when no translation exists. */\n  t: (key: string, params?: Record<string, string | number>) => string | undefined;\n}\n\n// ─── Renderer Map ────────────────────────────────────────────────\n\n/** Placeholder component for element types that don't have a renderer yet */\nconst UnimplementedRenderer: React.FC<GuidanceElementRendererProps> = () => null;\n\nconst 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// ─── Error Boundary ──────────────────────────────────────────────\n\nclass GuidanceElementErrorBoundary extends React.Component<\n  { elementRef: string; children: React.ReactNode },\n  { hasError: boolean }\n> {\n  constructor(props: { elementRef: string; children: React.ReactNode }) {\n    super(props);\n    this.state = { hasError: false };\n  }\n\n  static getDerivedStateFromError(): { hasError: boolean } {\n    return { hasError: true };\n  }\n\n  componentDidCatch(error: Error): void {\n    LoggerFrontendService.getLogger().error(\n      `GuidanceRenderer: element \"${this.props.elementRef}\" threw an error`,\n      error,\n    );\n  }\n\n  render(): React.ReactNode {\n    if (this.state.hasError) return null;\n    return this.props.children;\n  }\n}\n\n// ─── Target Element Resolution (Phase G / Step 25) ──────────────\n\nfunction resolveTargetSelector(element: OnboardingElement): string | null {\n  if ('targetSelector' in element && typeof (element as Record<string, unknown>).targetSelector === 'string') {\n    return (element as Record<string, unknown>).targetSelector as string;\n  }\n\n  if (element.targetField) {\n    return `[data-guidance-field=\"${element.targetField}\"]`;\n  }\n\n  return null;\n}\n\n// ─── Inline Portal Wrapper ───────────────────────────────────────\n\nconst InlinePortal: React.FC<{ targetSelector: string; children: React.ReactNode }> = ({ targetSelector, children }) => {\n  const target = typeof document !== 'undefined' ? document.querySelector(targetSelector) : null;\n  if (!target) return null;\n\n  return ReactDOM.createPortal(\n    <div className=\"absolute z-[calc(var(--z-guidance)-2)]\">\n      {children}\n    </div>,\n    target,\n  );\n};\n\n// ─── GuidanceRenderer Component ──────────────────────────────────\n\nexport interface GuidanceRendererProps {\n  customRenderers?: Partial<Record<OnboardingElementType, React.FC<GuidanceElementRendererProps>>>;\n}\n\nexport const GuidanceRenderer: React.FC<GuidanceRendererProps> = ({ customRenderers }) => {\n  const { activeFlows, flowStates, completeElement, dismissFlow, completeFlow } = useGuidance();\n  const guidanceI18nKeys = useMemo(() => activeFlows.map(f => `guidance.${f.ref}`), [activeFlows]);\n  const { makeTrGuidanceElement, tComponent, isReady: isGuidanceI18nReady } = useI18n({ keys: guidanceI18nKeys });\n  const { emit } = useEventBus();\n  const portalContainer = usePortalContainer();\n\n  const effectiveRenderers = useMemo(\n    () => ({ ...RENDERER_MAP, ...customRenderers }),\n    [customRenderers],\n  );\n\n  // Emit NAVIGATION_REQUEST with the unresolved operationRef.\n  // Guidance sits above ResourceRegistryProvider, so we use the\n  // operationRef shorthand (same pattern as NotificationContext).\n  const handleAction = useCallback((actionRef: string) => {\n    emit(FrontendEvents.NAVIGATION_REQUEST, {\n      operationRef: actionRef,\n      initiator: {\n        sourceZone: APP_LEVEL_NAVIGATION_SOURCE,\n      },\n    });\n  }, [emit]);\n\n  const handleComplete = useCallback((flowRef: string, elementRef: string, data?: { surveyAnswers?: Record<string, unknown>; lastStepIndex?: number }) => {\n    completeElement(flowRef, elementRef, data);\n  }, [completeElement]);\n\n  const handleDismiss = useCallback((flowRef: string, _elementRef: string) => {\n    dismissFlow(flowRef);\n  }, [dismissFlow]);\n\n  // Build per-flow rendering output\n  const renderedFlows = useMemo(() => {\n    if (activeFlows.length === 0) return null;\n\n    const overlayElements: React.ReactNode[] = [];\n    const inlineElements: React.ReactNode[] = [];\n    const checklistElements: React.ReactNode[] = [];\n\n    for (const flow of activeFlows) {\n      const flowState = flowStates[flow.ref];\n\n      if (flow.renderMode === GuidanceRenderMode.CHECKLIST) {\n        // Group CHECKLIST_ITEM elements inside their parent CHECKLIST container\n        const checklistContainers = flow.elements.filter(\n          el => el.type === OnboardingElementType.CHECKLIST\n        );\n        const itemElements = flow.elements.filter(\n          el => el.type === OnboardingElementType.CHECKLIST_ITEM\n        );\n\n        for (const container of checklistContainers) {\n          const ChecklistRenderer = effectiveRenderers[OnboardingElementType.CHECKLIST];\n          if (!ChecklistRenderer || ChecklistRenderer === UnimplementedRenderer) continue;\n\n          const containerState: GuidanceElementState | undefined = flowState?.elements?.[container.ref];\n          const containerT = makeTrGuidanceElement(flow.ref, container.ref);\n\n          const ItemRenderer = effectiveRenderers[OnboardingElementType.CHECKLIST_ITEM];\n          const itemNodes = ItemRenderer && ItemRenderer !== UnimplementedRenderer\n            ? itemElements.map(item => {\n                const itemState: GuidanceElementState | undefined = flowState?.elements?.[item.ref];\n                const itemT = makeTrGuidanceElement(flow.ref, item.ref);\n                return (\n                  <GuidanceElementErrorBoundary key={`${flow.ref}-${item.ref}`} elementRef={item.ref}>\n                    <ItemRenderer\n                      element={item}\n                      flowRef={flow.ref}\n                      state={itemState}\n                      onComplete={(elRef, data) => handleComplete(flow.ref, elRef, data)}\n                      onDismiss={(elRef) => handleDismiss(flow.ref, elRef)}\n                      onAction={handleAction}\n                      t={itemT}\n                    />\n                  </GuidanceElementErrorBoundary>\n                );\n              })\n            : null;\n\n          const node = (\n            <GuidanceElementErrorBoundary key={`${flow.ref}-${container.ref}`} elementRef={container.ref}>\n              <ChecklistRenderer\n                element={container}\n                flowRef={flow.ref}\n                state={containerState}\n                onComplete={(elRef, data) => handleComplete(flow.ref, elRef, data)}\n                onDismiss={(elRef) => handleDismiss(flow.ref, elRef)}\n                onAction={handleAction}\n                t={containerT}\n                {...({ children: itemNodes } as Partial<GuidanceChecklistProps>)}\n              />\n            </GuidanceElementErrorBoundary>\n          );\n          checklistElements.push(node);\n        }\n        continue;\n      }\n\n      for (const element of flow.elements) {\n        const Renderer = effectiveRenderers[element.type];\n        if (!Renderer || Renderer === UnimplementedRenderer) continue;\n\n        const elementState: GuidanceElementState | undefined = flowState?.elements?.[element.ref];\n        const t = makeTrGuidanceElement(flow.ref, element.ref);\n\n        const node = (\n          <GuidanceElementErrorBoundary key={`${flow.ref}-${element.ref}`} elementRef={element.ref}>\n            <Renderer\n              element={element}\n              flowRef={flow.ref}\n              state={elementState}\n              onComplete={(elRef, data) => handleComplete(flow.ref, elRef, data)}\n              onDismiss={(elRef) => handleDismiss(flow.ref, elRef)}\n              onAction={handleAction}\n              t={t}\n            />\n          </GuidanceElementErrorBoundary>\n        );\n\n        switch (flow.renderMode) {\n          case GuidanceRenderMode.OVERLAY:\n            overlayElements.push(node);\n            break;\n          case GuidanceRenderMode.INLINE: {\n            const selector = resolveTargetSelector(element);\n            if (selector) {\n              inlineElements.push(\n                <InlinePortal\n                  key={`inline-${flow.ref}-${element.ref}`}\n                  targetSelector={selector}\n                >\n                  {node}\n                </InlinePortal>,\n              );\n            } else {\n              inlineElements.push(node);\n            }\n            break;\n          }\n        }\n      }\n    }\n\n    return { overlayElements, inlineElements, checklistElements };\n  }, [activeFlows, flowStates, makeTrGuidanceElement, handleAction, handleComplete, handleDismiss]);\n\n  if (!isGuidanceI18nReady) return null;\n  if (!renderedFlows) return null;\n\n  const { overlayElements, inlineElements, checklistElements } = renderedFlows;\n  const hasContent = overlayElements.length > 0 || inlineElements.length > 0 || checklistElements.length > 0;\n  if (!hasContent) return null;\n  const portalTarget = typeof document !== 'undefined' ? portalContainer ?? document.body : undefined;\n\n  return (\n    <>\n      {/* OVERLAY -- rendered in the app portal target when available. */}\n      {overlayElements.length > 0 && portalTarget &&\n        ReactDOM.createPortal(\n          <div data-guidance-layer=\"overlay\" className=\"fixed inset-0 z-(--z-guidance) pointer-events-none\">\n            {overlayElements}\n          </div>,\n          portalTarget,\n        )\n      }\n\n      {/* INLINE -- already portalled individually per-element */}\n      {inlineElements}\n\n      {/* CHECKLIST -- floating panel, bottom-right via portal */}\n      {checklistElements.length > 0 && portalTarget &&\n        ReactDOM.createPortal(\n          <div data-guidance-layer=\"checklist\" className=\"fixed bottom-6 end-6 z-[calc(var(--z-guidance)-1)]\">\n            {checklistElements}\n          </div>,\n          portalTarget,\n        )\n      }\n    </>\n  );\n};\n"]}
+{"version":3,"file":"GuidanceRenderer.js","sourceRoot":"","sources":["../../../../../src/core/guidance/GuidanceRenderer.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * GuidanceRenderer\n *\n * Root renderer for the Guidance System. Reads active flows from\n * GuidanceContext and delegates rendering to render-mode-specific\n * sub-renderers (OVERLAY, INLINE, CHECKLIST). Each element within\n * a flow is mapped to its type-specific renderer component via\n * RENDERER_MAP.\n */\n\nimport React, { useCallback, useEffect, useMemo, useRef } from 'react';\nimport ReactDOM from 'react-dom';\nimport type {\n  GuidanceFlowDefinition,\n  GuidanceElementState,\n  OnboardingElement,\n} from '@wildo-ai/saas-models';\nimport {\n  GuidanceRenderMode,\n  OnboardingElementType,\n  resolveGuidanceElementRequiredLabelFields,\n} from '@wildo-ai/saas-models';\nimport { CorePresetNames, FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { ComponentRegistryService } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.service';\nimport { useGuidance } from './useGuidance';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { APP_LEVEL_NAVIGATION_SOURCE } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { usePortalContainer } from '~wildo-frontend-lib/core/app-shell/PortalContainerContext';\n\n// Renderers — imported lazily to avoid circular deps; wired in RENDERER_MAP below\nimport { GuidanceChecklist, type GuidanceChecklistProps } from './renderers/GuidanceChecklist';\nimport { GuidanceChecklistItem } from './renderers/GuidanceChecklistItem';\nimport { GuidanceTour } from './renderers/GuidanceTour';\nimport { GuidanceTooltip } from './renderers/GuidanceTooltip';\nimport { GuidanceModal } from './renderers/GuidanceModal';\nimport { GuidanceBanner } from './renderers/GuidanceBanner';\nimport { GuidanceAnnouncement } from './renderers/GuidanceAnnouncement';\nimport { GuidanceBadge } from './renderers/GuidanceBadge';\nimport { GuidanceCard } from './renderers/GuidanceCard';\nimport { GuidanceSurvey } from './renderers/GuidanceSurvey';\n\n// ─── Shared Props Interface ──────────────────────────────────────\n\nexport interface GuidanceElementRendererProps {\n  element: OnboardingElement;\n  flowRef: string;\n  state: GuidanceElementState | undefined;\n  /**\n   * Record this element complete. REJECTS when a bound survey's answers could not be written\n   * (#1372), in which case nothing was recorded — a renderer that can bind must await this and\n   * surface the failure rather than leaving the person to wonder.\n   *\n   * Every element type but SURVEY, and every unbound survey, resolves without a round trip, so a\n   * renderer with nothing to bind may keep ignoring the promise.\n   */\n  onComplete: (elementRef: string, data?: { surveyAnswers?: Record<string, unknown>; lastStepIndex?: number; declineResourceBinding?: boolean }) => Promise<void>;\n  onDismiss: (elementRef: string) => void;\n  onAction: (actionRef: string) => void;\n  /** i18n translate function scoped to this flow+element. Returns undefined when no translation exists. */\n  t: (key: string, params?: Record<string, string | number>) => string | undefined;\n}\n\n// ─── Renderer Map ────────────────────────────────────────────────\n\n/** Placeholder component for element types that don't have a renderer yet */\nconst UnimplementedRenderer: React.FC<GuidanceElementRendererProps> = () => null;\n\nconst 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/**\n * The component-registry slot each guidance element type is replaceable through.\n *\n * ## Why this map exists\n *\n * Every `GUIDANCE_*` component type was already declared, already carried a frontend-component\n * SPECIFICATION advertising a `DEFAULT` preset and an exported registry key, and was already used\n * as an i18n namespace by the renderer that implements it — but nothing ever joined the element\n * type to the slot, so the slots were addressable for labels and unreachable for COMPONENTS. Each\n * one sat on the registry-completeness deny-list under \"framework-internal … not swappable\", and an\n * application that wanted a different banner had no way to supply one short of replacing the whole\n * `APP_LAYOUT_MAIN_CONTAINER` preset.\n *\n * Total over `OnboardingElementType` by construction: a new element type is a compile error here\n * until it declares which slot replaces it, rather than silently shipping as unswappable.\n */\nexport const GUIDANCE_ELEMENT_COMPONENT_TYPE: Record<OnboardingElementType, FrontendComponentType> = {\n  [OnboardingElementType.CHECKLIST]: FrontendComponentType.GUIDANCE_CHECKLIST,\n  [OnboardingElementType.CHECKLIST_ITEM]: FrontendComponentType.GUIDANCE_CHECKLIST_ITEM,\n  [OnboardingElementType.TOUR]: FrontendComponentType.GUIDANCE_TOUR,\n  [OnboardingElementType.TOOLTIP]: FrontendComponentType.GUIDANCE_TOOLTIP,\n  [OnboardingElementType.MODAL]: FrontendComponentType.GUIDANCE_MODAL,\n  [OnboardingElementType.BANNER]: FrontendComponentType.GUIDANCE_BANNER,\n  [OnboardingElementType.ANNOUNCEMENT]: FrontendComponentType.GUIDANCE_ANNOUNCEMENT,\n  [OnboardingElementType.BADGE]: FrontendComponentType.GUIDANCE_BADGE,\n  [OnboardingElementType.CARD]: FrontendComponentType.GUIDANCE_CARD,\n  [OnboardingElementType.SURVEY]: FrontendComponentType.GUIDANCE_SURVEY,\n};\n\n/**\n * Resolve the component that renders one element type, most specific source first.\n *\n * `customRenderers` (a prop) → a REGISTERED preset → the engine's built-in renderer.\n *\n * ## Why this is not `createComponentResolver`\n *\n * That helper renders `ComponentNotInjected` when a slot has no registration, which is right for a\n * slot the framework does not implement. These ten slots DO have working framework implementations,\n * so a missing registration must fall through to the built-in rather than blank the element — an\n * application that registers nothing keeps exactly the behaviour it has today, and one that\n * registers a preset gets its own component. Registration is therefore purely additive and cannot\n * break a guidance surface by its absence.\n *\n * `preset` is read from the registry under `CorePresetNames.DEFAULT`, which is the name an\n * application overrides. Named alternative presets are deliberately NOT resolved here: nothing in a\n * flow definition selects one, so admitting them would create a second selection axis with no\n * authoring surface behind it.\n */\nexport function resolveGuidanceElementRenderer(\n  elementType: OnboardingElementType,\n  /**\n   * Optional, because the second caller — `OnboardingView` — has no equivalent prop. Leaving it\n   * required would have meant that surface passing a literal `undefined`, which reads as an\n   * oversight rather than as \"this surface takes no overrides\".\n   */\n  customRenderers?: Partial<Record<OnboardingElementType, React.FC<GuidanceElementRendererProps>>>,\n): React.FC<GuidanceElementRendererProps> | undefined {\n  const custom = customRenderers?.[elementType];\n  if (custom) return custom;\n\n  const registered = ComponentRegistryService.resolve(\n    GUIDANCE_ELEMENT_COMPONENT_TYPE[elementType],\n    CorePresetNames.DEFAULT,\n  );\n  if (registered) return registered as React.FC<GuidanceElementRendererProps>;\n\n  return RENDERER_MAP[elementType];\n}\n\n// ─── Error Boundary ──────────────────────────────────────────────\n\nclass GuidanceElementErrorBoundary extends React.Component<\n  { elementRef: string; children: React.ReactNode },\n  { hasError: boolean }\n> {\n  constructor(props: { elementRef: string; children: React.ReactNode }) {\n    super(props);\n    this.state = { hasError: false };\n  }\n\n  static getDerivedStateFromError(): { hasError: boolean } {\n    return { hasError: true };\n  }\n\n  componentDidCatch(error: Error): void {\n    LoggerFrontendService.getLogger().error(\n      `GuidanceRenderer: element \"${this.props.elementRef}\" threw an error`,\n      error,\n    );\n  }\n\n  render(): React.ReactNode {\n    if (this.state.hasError) return null;\n    return this.props.children;\n  }\n}\n\n// ─── Target Element Resolution (Phase G / Step 25) ──────────────\n\nfunction resolveTargetSelector(element: OnboardingElement): string | null {\n  if ('targetSelector' in element && typeof (element as Record<string, unknown>).targetSelector === 'string') {\n    return (element as Record<string, unknown>).targetSelector as string;\n  }\n\n  if (element.targetField) {\n    return `[data-guidance-field=\"${element.targetField}\"]`;\n  }\n\n  return null;\n}\n\n// ─── Presentable Elements (#539) ─────────────────────────────────\n\n/**\n * Whether an element mounted by the render loop actually PUTS SOMETHING ON SCREEN.\n *\n * Having a renderer is not the same as being visible, and four renderers answer `null` at runtime\n * for reasons the render loop cannot see from the element alone:\n *\n * - a TOOLTIP whose `targetSelector` matches no node — it renders nothing until a rect exists;\n * - a TOUR with no steps — `currentStep` is undefined and it returns before the portal;\n * - an INLINE element whose portal target is absent — `InlinePortal` returns `null`;\n * - any element of a CHECKLIST-mode flow that declares items and no container — the loop's own\n *   container scan finds nothing and the items are never mounted.\n *\n * Each of those was counted as presented, so the flow's once-per-user occasion was spent on a\n * screen the user saw nothing on. The DOM lookups here are the same ones the renderers perform, and\n * this runs from an effect, after paint, so they see what the renderers saw AT THAT INSTANT.\n *\n * RESIDUAL, in the other direction and deliberately accepted: the presentation effect re-runs on\n * `activeFlows` and has no DOM signal, while `GuidanceTooltip` re-resolves its target on scroll,\n * resize and a `ResizeObserver`. A tooltip whose target mounts AFTER this effect therefore becomes\n * visible and is never recorded, so its flow fires again next session. That errs toward showing a\n * flow twice rather than spending an occasion on nothing, which is the direction #539 asks for —\n * but it is a residual, not an absence, and closing it means subscribing to the same signals the\n * renderers use.\n */\n/**\n * `document.querySelector` over an AUTHOR-SUPPLIED string, which may not be a selector at all.\n *\n * `targetSelector` is a bare `z.string()`, so `''` or a malformed value makes `querySelector` throw\n * `SyntaxError`. That used to be contained: the lookup lived inside `GuidanceTooltip`'s own effect,\n * under `GuidanceElementErrorBoundary`, so one bad selector cost one element. The visibility check\n * runs from `GuidanceRenderer`'s presentation effect, ABOVE every boundary it renders, so an\n * unguarded throw there takes the whole guidance surface down instead.\n *\n * A selector that cannot be parsed matches nothing, so `false` is also the truthful answer.\n */\nfunction matchesSomething(selector: string): boolean {\n  try {\n    return Boolean(document.querySelector(selector));\n  } catch {\n    if (!warnedInvalidSelectors.has(selector)) {\n      warnedInvalidSelectors.add(selector);\n      LoggerFrontendService.getLogger().warn(\n        `GuidanceRenderer: \"${selector}\" is not a valid CSS selector, so the element targeting it can never be shown.`,\n      );\n    }\n    return false;\n  }\n}\n\n/** Selectors already reported as unparseable, so the warning fires once rather than per render. */\nconst warnedInvalidSelectors = new Set<string>();\n\nfunction isElementVisible(flow: GuidanceFlowDefinition, element: OnboardingElement): boolean {\n  if (typeof document === 'undefined') return false;\n\n  if (element.type === OnboardingElementType.TOOLTIP) {\n    const selector = (element as Record<string, unknown>).targetSelector;\n    return typeof selector === 'string' && matchesSomething(selector);\n  }\n\n  if (element.type === OnboardingElementType.TOUR) {\n    const steps = (element as Record<string, unknown>).steps;\n    return Array.isArray(steps) && steps.length > 0;\n  }\n\n  if (flow.renderMode === GuidanceRenderMode.INLINE) {\n    // An inline element with no selector renders in place rather than through a portal, so only a\n    // DECLARED target that resolves to nothing makes it invisible.\n    const selector = resolveTargetSelector(element);\n    return selector === null || matchesSomething(selector);\n  }\n\n  return true;\n}\n\n/**\n * The elements this renderer actually SHOWS for a flow — the population whose copy decides whether\n * showing the flow spends its occasion.\n *\n * CHECKLIST mode renders only its containers and items, and only when a container exists; every\n * other mode renders every element that has a renderer AND is visible. Kept beside the render\n * loop's own selection so the two cannot disagree about which elements a person sees — which they\n * did, because this function asked only whether a renderer existed. See {@link isElementVisible}.\n */\nfunction selectPresentedElements(\n  flow: GuidanceFlowDefinition,\n  renderers: Record<OnboardingElementType, React.FC<GuidanceElementRendererProps>>,\n): OnboardingElement[] {\n  const hasRenderer = (element: OnboardingElement): boolean => {\n    const Renderer = renderers[element.type];\n    return Boolean(Renderer) && Renderer !== UnimplementedRenderer;\n  };\n  if (flow.renderMode === GuidanceRenderMode.CHECKLIST) {\n    const containers = flow.elements.filter(el => el.type === OnboardingElementType.CHECKLIST && hasRenderer(el));\n    // No container, no items: the render loop scans for containers and never reaches the items.\n    if (containers.length === 0) return [];\n    return flow.elements.filter(\n      el => (el.type === OnboardingElementType.CHECKLIST || el.type === OnboardingElementType.CHECKLIST_ITEM) && hasRenderer(el),\n    );\n  }\n  return flow.elements.filter(el => hasRenderer(el) && isElementVisible(flow, el));\n}\n\n// ─── Inline Portal Wrapper ───────────────────────────────────────\n\nconst InlinePortal: React.FC<{ targetSelector: string; children: React.ReactNode }> = ({ targetSelector, children }) => {\n  // Through the guarded lookup: this call is in the RENDER path and outside every error boundary\n  // this file mounts, so an author-supplied string that is not a valid selector would throw\n  // `SyntaxError` and take the whole guidance surface down rather than hiding one element.\n  const target = typeof document !== 'undefined' && matchesSomething(targetSelector)\n    ? document.querySelector(targetSelector)\n    : null;\n  if (!target) return null;\n\n  return ReactDOM.createPortal(\n    <div className=\"absolute z-[calc(var(--z-guidance)-2)]\">\n      {children}\n    </div>,\n    target,\n  );\n};\n\n// ─── GuidanceRenderer Component ──────────────────────────────────\n\nexport interface GuidanceRendererProps {\n  customRenderers?: Partial<Record<OnboardingElementType, React.FC<GuidanceElementRendererProps>>>;\n}\n\nexport const GuidanceRenderer: React.FC<GuidanceRendererProps> = ({ customRenderers }) => {\n  const { activeFlows, flowStates, completeElement, dismissFlow, recordFlowPresented, reportFlowNotPresentable } = useGuidance();\n  const guidanceI18nKeys = useMemo(() => activeFlows.map(f => `guidance.${f.ref}`), [activeFlows]);\n  const { makeTrGuidanceElement, tGuidanceElement, isReady: isGuidanceI18nReady } = useI18n({ keys: guidanceI18nKeys });\n  const { emit } = useEventBus();\n  const portalContainer = usePortalContainer();\n\n  /**\n   * One resolved renderer per element type, built through\n   * {@link resolveGuidanceElementRenderer} so a registered preset participates.\n   *\n   * This was `{ ...RENDERER_MAP, ...customRenderers }` — a spread over the built-ins that gave the\n   * component registry no say at all, which is why every guidance surface was unswappable in\n   * practice while its specification advertised a preset.\n   *\n   * ## Why the registration COUNT is a dependency\n   *\n   * An earlier version deliberately took none, reasoning that \"the registry is a module-level\n   * singleton populated once at startup, before anything renders\". That is an assumption about every\n   * host, not a property of the registry: a lazily-loaded preset bundle, a registration inside an\n   * effect, and a code-split design system all register AFTER this memo first resolves — and the\n   * failure is silent, because the application's component simply never appears.\n   *\n   * `getRegistrationCount()` grows with every new key, so it is the cheapest available version\n   * signal and re-resolving costs one map lookup per element type. RESIDUAL: re-registering an\n   * EXISTING key replaces the value without changing the count. That cannot affect a guidance slot\n   * today — nothing in the engine registers one, so the first registration is always a new key — but\n   * a registry that published a change signal would remove the caveat as well as the polling.\n   *\n   * ## Why the resolved map keeps its identity\n   *\n   * It is a dependency of `renderedFlows`, and the overwhelmingly common `customRenderers` call\n   * shape is an inline object literal — a new identity every render. Returning the PREVIOUS object\n   * when every entry is unchanged keeps that memo effective while still letting a genuine change\n   * through.\n   */\n  const registrationCount = ComponentRegistryService.getRegistrationCount();\n  const resolvedRenderersRef = useRef<Record<OnboardingElementType, React.FC<GuidanceElementRendererProps>> | null>(null);\n  const effectiveRenderers = useMemo(\n    () => {\n      const resolved: Partial<Record<OnboardingElementType, React.FC<GuidanceElementRendererProps>>> = {};\n      for (const elementType of Object.values(OnboardingElementType)) {\n        const renderer = resolveGuidanceElementRenderer(elementType, customRenderers);\n        if (renderer) resolved[elementType] = renderer;\n      }\n      const next = resolved as Record<OnboardingElementType, React.FC<GuidanceElementRendererProps>>;\n      const previous = resolvedRenderersRef.current;\n      if (previous && Object.values(OnboardingElementType).every(type => previous[type] === next[type])) {\n        return previous;\n      }\n      resolvedRenderersRef.current = next;\n      return next;\n    },\n    [customRenderers, registrationCount],\n  );\n\n  // Emit NAVIGATION_REQUEST with the unresolved operationRef.\n  // Guidance sits above ResourceRegistryProvider, so we use the\n  // operationRef shorthand (same pattern as NotificationContext).\n  const handleAction = useCallback((actionRef: string) => {\n    emit(FrontendEvents.NAVIGATION_REQUEST, {\n      operationRef: actionRef,\n      initiator: {\n        sourceZone: APP_LEVEL_NAVIGATION_SOURCE,\n      },\n    });\n  }, [emit]);\n\n  const handleComplete = useCallback((flowRef: string, elementRef: string, data?: { surveyAnswers?: Record<string, unknown>; lastStepIndex?: number; declineResourceBinding?: boolean }): Promise<void> => {\n    // The promise is RETURNED rather than swallowed: a bound survey rejects when its write is\n    // refused, and its renderer awaits that to keep the form open (#1372).\n    return completeElement(flowRef, elementRef, data);\n  }, [completeElement]);\n\n  const handleDismiss = useCallback((flowRef: string, _elementRef: string) => {\n    dismissFlow(flowRef);\n  }, [dismissFlow]);\n\n  // Build per-flow rendering output\n  const renderedFlows = useMemo(() => {\n    if (activeFlows.length === 0) return null;\n\n    const overlayElements: React.ReactNode[] = [];\n    const inlineElements: React.ReactNode[] = [];\n    const checklistElements: React.ReactNode[] = [];\n\n    for (const flow of activeFlows) {\n      const flowState = flowStates[flow.ref];\n\n      if (flow.renderMode === GuidanceRenderMode.CHECKLIST) {\n        // Group CHECKLIST_ITEM elements inside their parent CHECKLIST container\n        const checklistContainers = flow.elements.filter(\n          el => el.type === OnboardingElementType.CHECKLIST\n        );\n        const itemElements = flow.elements.filter(\n          el => el.type === OnboardingElementType.CHECKLIST_ITEM\n        );\n\n        for (const container of checklistContainers) {\n          const ChecklistRenderer = effectiveRenderers[OnboardingElementType.CHECKLIST];\n          if (!ChecklistRenderer || ChecklistRenderer === UnimplementedRenderer) continue;\n\n          const containerState: GuidanceElementState | undefined = flowState?.elements?.[container.ref];\n          const containerT = makeTrGuidanceElement(flow.ref, container.ref, resolveGuidanceElementRequiredLabelFields(container));\n\n          const ItemRenderer = effectiveRenderers[OnboardingElementType.CHECKLIST_ITEM];\n          const itemNodes = ItemRenderer && ItemRenderer !== UnimplementedRenderer\n            ? itemElements.map(item => {\n                const itemState: GuidanceElementState | undefined = flowState?.elements?.[item.ref];\n                const itemT = makeTrGuidanceElement(flow.ref, item.ref, resolveGuidanceElementRequiredLabelFields(item));\n                return (\n                  <GuidanceElementErrorBoundary key={`${flow.ref}-${item.ref}`} elementRef={item.ref}>\n                    <ItemRenderer\n                      element={item}\n                      flowRef={flow.ref}\n                      state={itemState}\n                      onComplete={(elRef, data) => handleComplete(flow.ref, elRef, data)}\n                      onDismiss={(elRef) => handleDismiss(flow.ref, elRef)}\n                      onAction={handleAction}\n                      t={itemT}\n                    />\n                  </GuidanceElementErrorBoundary>\n                );\n              })\n            : null;\n\n          const node = (\n            <GuidanceElementErrorBoundary key={`${flow.ref}-${container.ref}`} elementRef={container.ref}>\n              <ChecklistRenderer\n                element={container}\n                flowRef={flow.ref}\n                state={containerState}\n                onComplete={(elRef, data) => handleComplete(flow.ref, elRef, data)}\n                onDismiss={(elRef) => handleDismiss(flow.ref, elRef)}\n                onAction={handleAction}\n                t={containerT}\n                {...({ children: itemNodes } as Partial<GuidanceChecklistProps>)}\n              />\n            </GuidanceElementErrorBoundary>\n          );\n          checklistElements.push(node);\n        }\n        continue;\n      }\n\n      for (const element of flow.elements) {\n        const Renderer = effectiveRenderers[element.type];\n        if (!Renderer || Renderer === UnimplementedRenderer) continue;\n\n        const elementState: GuidanceElementState | undefined = flowState?.elements?.[element.ref];\n        const t = makeTrGuidanceElement(flow.ref, element.ref, resolveGuidanceElementRequiredLabelFields(element));\n\n        const node = (\n          <GuidanceElementErrorBoundary key={`${flow.ref}-${element.ref}`} elementRef={element.ref}>\n            <Renderer\n              element={element}\n              flowRef={flow.ref}\n              state={elementState}\n              onComplete={(elRef, data) => handleComplete(flow.ref, elRef, data)}\n              onDismiss={(elRef) => handleDismiss(flow.ref, elRef)}\n              onAction={handleAction}\n              t={t}\n            />\n          </GuidanceElementErrorBoundary>\n        );\n\n        switch (flow.renderMode) {\n          case GuidanceRenderMode.OVERLAY:\n            overlayElements.push(node);\n            break;\n          case GuidanceRenderMode.INLINE: {\n            const selector = resolveTargetSelector(element);\n            if (selector) {\n              inlineElements.push(\n                <InlinePortal\n                  key={`inline-${flow.ref}-${element.ref}`}\n                  targetSelector={selector}\n                >\n                  {node}\n                </InlinePortal>,\n              );\n            } else {\n              inlineElements.push(node);\n            }\n            break;\n          }\n        }\n      }\n    }\n\n    return { overlayElements, inlineElements, checklistElements };\n    // `effectiveRenderers` is read at three sites in this block and was MISSING from these\n    // dependencies, so the memo kept the first resolution for the component's life: a\n    // `customRenderers` prop that changed — a feature flag, a lazily loaded bundle, an A/B arm —\n    // never took effect. It is identity-stable by content (see its own docblock), so including it\n    // does not defeat the memo for the common inline-literal call shape.\n  }, [activeFlows, flowStates, effectiveRenderers, makeTrGuidanceElement, handleAction, handleComplete, handleDismiss]);\n\n  /*\n   * PRESENTATION — the moment a flow's once-per-user occasion is spent (#539).\n   *\n   * Only this layer knows whether a flow's copy exists, so only this layer may\n   * decide that showing it counted. A flow with every required label resolved is\n   * recorded as presented. A flow missing one is still RENDERED — its required slots\n   * show their raw keys, so the gap is visible — but it is not recorded, so it fires\n   * again once the labelling pipeline has generated its copy instead of having been\n   * silently consumed by an author's first run. The console names the missing keys,\n   * once per flow and missing set, because every request in that situation is a 200.\n   *\n   * Waits for readiness: before the bundle settles every key reads as missing, and\n   * recording nothing then is correct but warning would be noise.\n   */\n  const warnedMissingLabelSignaturesRef = useRef<Set<string>>(new Set());\n  useEffect(() => {\n    if (!isGuidanceI18nReady) return;\n    for (const flow of activeFlows) {\n      const presentedElements = selectPresentedElements(flow, effectiveRenderers);\n      /*\n       * Tell the context when a flow resolves to NOTHING. An OVERLAY flow whose elements never\n       * render still occupied the single overlay slot for the session — it never reaches a terminal\n       * status, so it never leaves the active set — and permanently suppressed a lower-priority\n       * flow that would have rendered.\n       */\n      reportFlowNotPresentable(flow.ref, presentedElements.length === 0);\n      if (presentedElements.length === 0) continue;\n      const missingKeys = presentedElements.flatMap(element =>\n        resolveGuidanceElementRequiredLabelFields(element)\n          .filter(field => tGuidanceElement(flow.ref, element.ref, field) === undefined)\n          .map(field => `guidance.${flow.ref}.elements.${element.ref}.${field}`),\n      );\n      if (missingKeys.length === 0) {\n        recordFlowPresented(flow.ref);\n        continue;\n      }\n      const signature = `${flow.ref}|${missingKeys.join(',')}`;\n      if (warnedMissingLabelSignaturesRef.current.has(signature)) continue;\n      warnedMissingLabelSignaturesRef.current.add(signature);\n      LoggerFrontendService.getLogger().warn(\n        `GuidanceRenderer: flow \"${flow.ref}\" is shown but NOT recorded as presented — its required labels are unresolved `\n          + `[${missingKeys.join(', ')}]. Generate the labels; the flow will trigger again once they exist.`,\n      );\n    }\n  }, [isGuidanceI18nReady, activeFlows, effectiveRenderers, tGuidanceElement, recordFlowPresented]);\n\n  if (!isGuidanceI18nReady) return null;\n  if (!renderedFlows) return null;\n\n  const { overlayElements, inlineElements, checklistElements } = renderedFlows;\n  const hasContent = overlayElements.length > 0 || inlineElements.length > 0 || checklistElements.length > 0;\n  if (!hasContent) return null;\n  const portalTarget = typeof document !== 'undefined' ? portalContainer ?? document.body : undefined;\n\n  /**\n   * The guidance layers position against the CONTENT AREA, not the viewport.\n   *\n   * ## What was wrong, measured in a running application\n   *\n   * Both layers were `fixed`. A fixed element resolves against the VIEWPORT and ignores whatever\n   * containing block it was portalled into — so with the app shell's `<main>` at\n   * `left: 256, top: 52` (sidebar 256 wide, header 52 tall), the overlay layer still covered\n   * `0,0 → 1440×1000` and `GuidanceBanner`'s `absolute top-0 inset-x-0` landed on the viewport's top\n   * edge. `document.elementFromPoint` at the header's own centre returned the BANNER's title: the\n   * logo, the resource selector, global search, notifications and the user avatar were all covered,\n   * and since the banner sets `pointer-events-auto` it took their clicks too. A dismissible notice\n   * was hiding the application's primary navigation for as long as it was up.\n   *\n   * ## Why `absolute` is the fix rather than an offset\n   *\n   * The shell already publishes the right anchor and makes it work: `app-layout-main-container`\n   * renders `<main ref={portalRef} className=\"flex-1 relative min-w-0\">` and hands that element to\n   * `PortalContainerContext`, so it is BOTH the portal target and a containing block. `fixed` was\n   * the one thing standing between that arrangement and the correct result; `absolute inset-0` fills\n   * the content area exactly, and every self-positioning child — the banner's `top-0`, the\n   * checklist's `bottom-6 end-6` — then means the top and bottom of the content area, which is what\n   * those authoring values have always claimed to mean. No offset to keep in step with a header\n   * height, and an END sidebar or a bottom status bar is respected for free.\n   *\n   * ## The fallback, and the contract\n   *\n   * With no portal container — the public and auth layouts, and unit tests — the target is\n   * `document.body`, which is not positioned, so the layers stay `fixed` and behave exactly as\n   * before. The contract this relies on: **a guidance portal container must be a containing block**\n   * (`position` other than `static`). One provider sets it today and it satisfies that; a host that\n   * sets its own must too.\n   */\n  const layerPosition = portalContainer ? 'absolute' : 'fixed';\n\n  return (\n    <>\n      {/* OVERLAY -- rendered in the app portal target when available. */}\n      {overlayElements.length > 0 && portalTarget &&\n        ReactDOM.createPortal(\n          /**\n           * The OVERLAY layer positions the elements that do not position THEMSELVES.\n           *\n           * It was a bare `fixed inset-0 … pointer-events-none` with no layout at all. Modal, tour\n           * and tooltip portal out of it and banner self-positions (`absolute top-0 inset-x-0`), so\n           * those four were fine — but CARD, SURVEY, ANNOUNCEMENT and BADGE are ordinary in-flow\n           * children, and an in-flow child of a `fixed inset-0` box with no layout renders\n           * full-viewport-width, pinned to the top-left corner, stacked on top of any banner. That\n           * is what `renderMode: OVERLAY` with any of those four element types actually produced,\n           * and it is the default authoring path.\n           *\n           * Centred with a readable cap rather than stretched: an overlay card is a focal message,\n           * and `max-w-md` is the width `GuidanceModal` already uses for the same kind of content,\n           * so the two read as one system.\n           *\n           * ## No padding and no `overflow-y-auto` on THIS element, and both were here and wrong\n           *\n           * `GuidanceBanner` is `absolute top-0 inset-x-0` — NOT `fixed`, which an earlier version of\n           * this comment asserted and reasoned from. An absolutely positioned child resolves against\n           * the nearest positioned ancestor's PADDING BOX, and this layer is that ancestor, so a\n           * `p-element` here inset the banner from all four viewport edges — visibly breaking the one\n           * overlay element that had always positioned itself correctly. Edge spacing therefore lives\n           * on the per-element wrapper below, which is static and so is not a containing block.\n           *\n           * `overflow-y-auto` was added claiming it made a third card reachable. It does not: content\n           * overflowing the START edge of a centred flex container cannot be scrolled to, and the\n           * layer is `pointer-events-none`, so a wheel event never targets it. Overflow with several\n           * simultaneously eligible overlay flows is a real limitation and is left honestly\n           * unaddressed rather than papered over by a class that does nothing.\n           *\n           * `pointer-events-none` stays — every renderer that is interactive sets\n           * `pointer-events-auto` on its own root.\n           */\n          <div\n            data-guidance-layer=\"overlay\"\n            className={`${layerPosition} inset-0 z-(--z-guidance) pointer-events-none flex flex-col items-center justify-center gap-element`}\n          >\n            {overlayElements.map(node => (\n              /**\n               * Capped and padded per element rather than by a rule on the layer, because this\n               * wrapper is STATIC: it establishes no containing block, so the absolutely positioned\n               * banner resolves against the layer and ignores this box entirely, while\n               * card/survey/announcement/badge are laid out by it. A `[&>*]` rule or padding on the\n               * layer would reach the banner and did.\n               *\n               * `empty:hidden` because modal, tour, tooltip and banner all portal their DOM\n               * elsewhere, leaving this wrapper with no child nodes. A childless flex item still\n               * consumes a `gap`, so without this each portalling element added a slice of empty\n               * space that pushed the genuinely centred cards off-centre.\n               *\n               * The node's OWN key is reused rather than the array index — these are keyed\n               * `${flowRef}-${elementRef}` at construction, and several flows can be eligible at\n               * once, so an index would remount the wrong subtree whenever eligibility reorders.\n               */\n              <div\n                key={(node as React.ReactElement).key}\n                className=\"w-full max-w-md shrink-0 px-element empty:hidden\"\n              >\n                {node}\n              </div>\n            ))}\n          </div>,\n          portalTarget,\n        )\n      }\n\n      {/* INLINE -- already portalled individually per-element */}\n      {inlineElements}\n\n      {/* CHECKLIST -- floating panel, bottom-right via portal */}\n      {checklistElements.length > 0 && portalTarget &&\n        ReactDOM.createPortal(\n          <div data-guidance-layer=\"checklist\" className={`${layerPosition} bottom-6 end-6 z-[calc(var(--z-guidance)-1)]`}>\n            {checklistElements}\n          </div>,\n          portalTarget,\n        )\n      }\n    </>\n  );\n};\n"]}

package/dist/esm/core/guidance/guidance-audience.frontend.utils.d.ts

@@ -1,4 +1,13 @@
-import type { GuidanceAudience } from '@wildo-ai/saas-models';
+import type { GuidanceAudience, GuidanceFlowScope, LifecycleStage } from '@wildo-ai/saas-models';
+/** What one scope's progression and lifecycle say, as the audience evaluator needs them. */
+export interface GuidanceAudienceScopedState {
+    /** Refs in `progressionState.milestonesAchieved`. */
+    achievedMilestoneRefs: Set<string>;
+    /** `lifecycleState.currentStage`, absent when the lane is off or the document unread. */
+    currentLifecycleStage?: LifecycleStage;
+    /** `lifecycleState.stagesVisited` — what `lifecycleStagesReached` asks about. */
+    stagesReached: Set<LifecycleStage>;
+}
 export interface GuidanceAudienceContext {
     userRoles: string[];
     userFeatures: string[];
@@ -6,6 +15,17 @@ export interface GuidanceAudienceContext {
     currentUsage: Record<string, number>;
     completedFlowRefs: Set<string>;
     userCreatedAt?: Date;
+    /**
+     * Progression and lifecycle, PER SCOPE, because a flow asks about its own (#1373). A scope with
+     * nothing loaded is absent rather than empty — see `UNKNOWN_SCOPED_STATE` for what that means.
+     */
+    scopedState: Partial<Record<GuidanceFlowScope, GuidanceAudienceScopedState>>;
+    /**
+     * A recorded survey answer, addressed by the question that asked it. Returns `undefined` when the
+     * flow, element or question has no recorded answer — which is NOT the same as an answer that does
+     * not match, and the evaluator treats both as unmet.
+     */
+    recordedSurveyAnswer: (flowRef: string, elementRef: string, questionId: string) => string | number | boolean | string[] | undefined;
 }
 /**
  * Evaluates whether the current user is eligible to see a guidance flow.
@@ -15,5 +35,5 @@ export interface GuidanceAudienceContext {
  * config `features + mode`, while `limitChecks` are enforced as advisory
  * capacity checks using the resolved frontend feature payload.
  */
-export declare function evaluateGuidanceAudience(audience: GuidanceAudience | undefined, ctx: GuidanceAudienceContext): boolean;
+export declare function evaluateGuidanceAudience(audience: GuidanceAudience | undefined, ctx: GuidanceAudienceContext, flowScope: GuidanceFlowScope): boolean;
 //# sourceMappingURL=guidance-audience.frontend.utils.d.ts.map

package/dist/esm/core/guidance/guidance-audience.frontend.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guidance-audience.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/guidance/guidance-audience.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,aAAa,CAAC,EAAE,IAAI,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CA8DT"}
+{"version":3,"file":"guidance-audience.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/guidance/guidance-audience.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGjG,4FAA4F;AAC5F,MAAM,WAAW,2BAA2B;IAC1C,qDAAqD;IACrD,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,yFAAyF;IACzF,qBAAqB,CAAC,EAAE,cAAc,CAAC;IACvC,iFAAiF;IACjF,aAAa,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,2BAA2B,CAAC,CAAC,CAAC;IAC7E;;;;OAIG;IACH,oBAAoB,EAAE,CACpB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,KACf,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CACvD;AAeD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,GAAG,EAAE,uBAAuB,EAC5B,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAsHT"}

package/dist/esm/core/guidance/guidance-audience.frontend.utils.js

@@ -1,4 +1,16 @@
 import { FEATURES_UNLIMITED } from '@wildo-ai/saas-models';
+/**
+ * What a scope with no loaded progression or lifecycle answers.
+ *
+ * Empty rather than permissive, deliberately: a criterion asking "has this milestone been achieved"
+ * must answer NO while nothing is known, not YES. An unloaded scope that admitted every flow would
+ * show gated guidance during the window before its documents arrive, which is exactly the moment a
+ * new subject is looking at the screen.
+ */
+const UNKNOWN_SCOPED_STATE = {
+    achievedMilestoneRefs: new Set(),
+    stagesReached: new Set(),
+};
 /**
  * Evaluates whether the current user is eligible to see a guidance flow.
  *
@@ -7,10 +19,11 @@ import { FEATURES_UNLIMITED } from '@wildo-ai/saas-models';
  * config `features + mode`, while `limitChecks` are enforced as advisory
  * capacity checks using the resolved frontend feature payload.
  */
-export function evaluateGuidanceAudience(audience, ctx) {
+export function evaluateGuidanceAudience(audience, ctx, flowScope) {
     if (!audience) {
         return true;
     }
+    const scoped = ctx.scopedState[flowScope] ?? UNKNOWN_SCOPED_STATE;
     if (audience.roles && audience.roles.length > 0) {
         const hasMatchingRole = audience.roles.some(role => ctx.userRoles.includes(role));
         if (!hasMatchingRole) {
@@ -53,6 +66,51 @@ export function evaluateGuidanceAudience(audience, ctx) {
             return false;
         }
     }
+    // ALL-of: a prerequisite list with one unmet entry is unmet. COMPLETED only — a flow that was
+    // dismissed or skipped was declined, and treating that as satisfaction would show the follow-up
+    // to precisely the people who opted out of its lead-in.
+    if (audience.requireIfCompleted && audience.requireIfCompleted.length > 0) {
+        const allCompleted = audience.requireIfCompleted.every(ref => ctx.completedFlowRefs.has(ref));
+        if (!allCompleted) {
+            return false;
+        }
+    }
+    // ALL-of, in the FLOW's progression scope.
+    if (audience.requiredMilestones && audience.requiredMilestones.length > 0) {
+        const allAchieved = audience.requiredMilestones.every(ref => scoped.achievedMilestoneRefs.has(ref));
+        if (!allAchieved) {
+            return false;
+        }
+    }
+    // ANY-of — "who are you NOW". Unmet when the lane is off or the document unread, because an
+    // unknown stage is not a matching stage.
+    if (audience.currentLifecycleStages && audience.currentLifecycleStages.length > 0) {
+        const stage = scoped.currentLifecycleStage;
+        if (stage === undefined || !audience.currentLifecycleStages.includes(stage)) {
+            return false;
+        }
+    }
+    // ANY-of — "have you EVER been". Reads `stagesVisited`, which survives the stage-history cap.
+    if (audience.lifecycleStagesReached && audience.lifecycleStagesReached.length > 0) {
+        const hasReached = audience.lifecycleStagesReached.some(stage => scoped.stagesReached.has(stage));
+        if (!hasReached) {
+            return false;
+        }
+    }
+    // ALL-of. An absent answer and a non-matching answer are both unmet: "they have not said this".
+    if (audience.requiredSurveyAnswers && audience.requiredSurveyAnswers.length > 0) {
+        const allMatch = audience.requiredSurveyAnswers.every((requirement) => {
+            const recorded = ctx.recordedSurveyAnswer(requirement.flowRef, requirement.elementRef, requirement.questionId);
+            // An array answer (a CHECKBOX) matches when the required value is among its entries; a scalar
+            // matches by equality. Without the array case a multi-select could never satisfy a criterion.
+            return Array.isArray(recorded)
+                ? recorded.includes(String(requirement.equals))
+                : recorded === requirement.equals;
+        });
+        if (!allMatch) {
+            return false;
+        }
+    }
     if (audience.createdAfter && ctx.userCreatedAt) {
         if (ctx.userCreatedAt < audience.createdAfter) {
             return false;

package/dist/esm/core/guidance/guidance-audience.frontend.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"guidance-audience.frontend.utils.js","sourceRoot":"","sources":["../../../../src/core/guidance/guidance-audience.frontend.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { GuidanceAudience } from '@wildo-ai/saas-models';\nimport { FEATURES_UNLIMITED } from '@wildo-ai/saas-models';\n\nexport interface GuidanceAudienceContext {\n  userRoles: string[];\n  userFeatures: string[];\n  featureLimits: Record<string, number>;\n  currentUsage: Record<string, number>;\n  completedFlowRefs: Set<string>;\n  userCreatedAt?: Date;\n}\n\n/**\n * Evaluates whether the current user is eligible to see a guidance flow.\n *\n * This intentionally follows the same `RequiredFeaturesConfig` semantics as the\n * rest of the frontend gating layer: boolean features honor shorthand/full\n * config `features + mode`, while `limitChecks` are enforced as advisory\n * capacity checks using the resolved frontend feature payload.\n */\nexport function evaluateGuidanceAudience(\n  audience: GuidanceAudience | undefined,\n  ctx: GuidanceAudienceContext,\n): boolean {\n  if (!audience) {\n    return true;\n  }\n\n  if (audience.roles && audience.roles.length > 0) {\n    const hasMatchingRole = audience.roles.some(role => ctx.userRoles.includes(role));\n    if (!hasMatchingRole) {\n      return false;\n    }\n  }\n\n  if (audience.requiredFeatures) {\n    const requiredFeatures = audience.requiredFeatures;\n    const featureList = Array.isArray(requiredFeatures) ? requiredFeatures : (requiredFeatures.features ?? []);\n    const mode = Array.isArray(requiredFeatures) ? 'OR' : (requiredFeatures.mode ?? 'OR');\n\n    if (featureList.length > 0) {\n      const featuresSatisfied = mode === 'OR'\n        ? featureList.some(featureId => ctx.userFeatures.includes(featureId))\n        : featureList.every(featureId => ctx.userFeatures.includes(featureId));\n\n      if (!featuresSatisfied) {\n        return false;\n      }\n    }\n\n    if (!Array.isArray(requiredFeatures) && requiredFeatures.limitChecks?.length) {\n      const hasExceededLimit = requiredFeatures.limitChecks.some((check) => {\n        const limit = ctx.featureLimits[check.featureId];\n        if (limit === undefined) {\n          return false;\n        }\n        if (limit === FEATURES_UNLIMITED) {\n          return false;\n        }\n\n        const currentUsage = ctx.currentUsage[check.featureId] ?? 0;\n        const increment = check.increment ?? 1;\n        return currentUsage + increment > limit;\n      });\n\n      if (hasExceededLimit) {\n        return false;\n      }\n    }\n  }\n\n  if (audience.excludeIfCompleted && audience.excludeIfCompleted.length > 0) {\n    const hasCompleted = audience.excludeIfCompleted.some(ref => ctx.completedFlowRefs.has(ref));\n    if (hasCompleted) {\n      return false;\n    }\n  }\n\n  if (audience.createdAfter && ctx.userCreatedAt) {\n    if (ctx.userCreatedAt < audience.createdAfter) {\n      return false;\n    }\n  }\n\n  return true;\n}\n"]}
+{"version":3,"file":"guidance-audience.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/guidance/guidance-audience.frontend.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { GuidanceAudience, GuidanceFlowScope, LifecycleStage } from '@wildo-ai/saas-models';\nimport { FEATURES_UNLIMITED } from '@wildo-ai/saas-models';\n\n/** What one scope's progression and lifecycle say, as the audience evaluator needs them. */\nexport interface GuidanceAudienceScopedState {\n  /** Refs in `progressionState.milestonesAchieved`. */\n  achievedMilestoneRefs: Set<string>;\n  /** `lifecycleState.currentStage`, absent when the lane is off or the document unread. */\n  currentLifecycleStage?: LifecycleStage;\n  /** `lifecycleState.stagesVisited` — what `lifecycleStagesReached` asks about. */\n  stagesReached: Set<LifecycleStage>;\n}\n\nexport interface GuidanceAudienceContext {\n  userRoles: string[];\n  userFeatures: string[];\n  featureLimits: Record<string, number>;\n  currentUsage: Record<string, number>;\n  completedFlowRefs: Set<string>;\n  userCreatedAt?: Date;\n  /**\n   * Progression and lifecycle, PER SCOPE, because a flow asks about its own (#1373). A scope with\n   * nothing loaded is absent rather than empty — see `UNKNOWN_SCOPED_STATE` for what that means.\n   */\n  scopedState: Partial<Record<GuidanceFlowScope, GuidanceAudienceScopedState>>;\n  /**\n   * A recorded survey answer, addressed by the question that asked it. Returns `undefined` when the\n   * flow, element or question has no recorded answer — which is NOT the same as an answer that does\n   * not match, and the evaluator treats both as unmet.\n   */\n  recordedSurveyAnswer: (\n    flowRef: string,\n    elementRef: string,\n    questionId: string,\n  ) => string | number | boolean | string[] | undefined;\n}\n\n/**\n * What a scope with no loaded progression or lifecycle answers.\n *\n * Empty rather than permissive, deliberately: a criterion asking \"has this milestone been achieved\"\n * must answer NO while nothing is known, not YES. An unloaded scope that admitted every flow would\n * show gated guidance during the window before its documents arrive, which is exactly the moment a\n * new subject is looking at the screen.\n */\nconst UNKNOWN_SCOPED_STATE: GuidanceAudienceScopedState = {\n  achievedMilestoneRefs: new Set(),\n  stagesReached: new Set(),\n};\n\n/**\n * Evaluates whether the current user is eligible to see a guidance flow.\n *\n * This intentionally follows the same `RequiredFeaturesConfig` semantics as the\n * rest of the frontend gating layer: boolean features honor shorthand/full\n * config `features + mode`, while `limitChecks` are enforced as advisory\n * capacity checks using the resolved frontend feature payload.\n */\nexport function evaluateGuidanceAudience(\n  audience: GuidanceAudience | undefined,\n  ctx: GuidanceAudienceContext,\n  flowScope: GuidanceFlowScope,\n): boolean {\n  if (!audience) {\n    return true;\n  }\n\n  const scoped = ctx.scopedState[flowScope] ?? UNKNOWN_SCOPED_STATE;\n\n  if (audience.roles && audience.roles.length > 0) {\n    const hasMatchingRole = audience.roles.some(role => ctx.userRoles.includes(role));\n    if (!hasMatchingRole) {\n      return false;\n    }\n  }\n\n  if (audience.requiredFeatures) {\n    const requiredFeatures = audience.requiredFeatures;\n    const featureList = Array.isArray(requiredFeatures) ? requiredFeatures : (requiredFeatures.features ?? []);\n    const mode = Array.isArray(requiredFeatures) ? 'OR' : (requiredFeatures.mode ?? 'OR');\n\n    if (featureList.length > 0) {\n      const featuresSatisfied = mode === 'OR'\n        ? featureList.some(featureId => ctx.userFeatures.includes(featureId))\n        : featureList.every(featureId => ctx.userFeatures.includes(featureId));\n\n      if (!featuresSatisfied) {\n        return false;\n      }\n    }\n\n    if (!Array.isArray(requiredFeatures) && requiredFeatures.limitChecks?.length) {\n      const hasExceededLimit = requiredFeatures.limitChecks.some((check) => {\n        const limit = ctx.featureLimits[check.featureId];\n        if (limit === undefined) {\n          return false;\n        }\n        if (limit === FEATURES_UNLIMITED) {\n          return false;\n        }\n\n        const currentUsage = ctx.currentUsage[check.featureId] ?? 0;\n        const increment = check.increment ?? 1;\n        return currentUsage + increment > limit;\n      });\n\n      if (hasExceededLimit) {\n        return false;\n      }\n    }\n  }\n\n  if (audience.excludeIfCompleted && audience.excludeIfCompleted.length > 0) {\n    const hasCompleted = audience.excludeIfCompleted.some(ref => ctx.completedFlowRefs.has(ref));\n    if (hasCompleted) {\n      return false;\n    }\n  }\n\n  // ALL-of: a prerequisite list with one unmet entry is unmet. COMPLETED only — a flow that was\n  // dismissed or skipped was declined, and treating that as satisfaction would show the follow-up\n  // to precisely the people who opted out of its lead-in.\n  if (audience.requireIfCompleted && audience.requireIfCompleted.length > 0) {\n    const allCompleted = audience.requireIfCompleted.every(ref => ctx.completedFlowRefs.has(ref));\n    if (!allCompleted) {\n      return false;\n    }\n  }\n\n  // ALL-of, in the FLOW's progression scope.\n  if (audience.requiredMilestones && audience.requiredMilestones.length > 0) {\n    const allAchieved = audience.requiredMilestones.every(ref => scoped.achievedMilestoneRefs.has(ref));\n    if (!allAchieved) {\n      return false;\n    }\n  }\n\n  // ANY-of — \"who are you NOW\". Unmet when the lane is off or the document unread, because an\n  // unknown stage is not a matching stage.\n  if (audience.currentLifecycleStages && audience.currentLifecycleStages.length > 0) {\n    const stage = scoped.currentLifecycleStage;\n    if (stage === undefined || !audience.currentLifecycleStages.includes(stage)) {\n      return false;\n    }\n  }\n\n  // ANY-of — \"have you EVER been\". Reads `stagesVisited`, which survives the stage-history cap.\n  if (audience.lifecycleStagesReached && audience.lifecycleStagesReached.length > 0) {\n    const hasReached = audience.lifecycleStagesReached.some(stage => scoped.stagesReached.has(stage));\n    if (!hasReached) {\n      return false;\n    }\n  }\n\n  // ALL-of. An absent answer and a non-matching answer are both unmet: \"they have not said this\".\n  if (audience.requiredSurveyAnswers && audience.requiredSurveyAnswers.length > 0) {\n    const allMatch = audience.requiredSurveyAnswers.every((requirement) => {\n      const recorded = ctx.recordedSurveyAnswer(\n        requirement.flowRef,\n        requirement.elementRef,\n        requirement.questionId,\n      );\n      // An array answer (a CHECKBOX) matches when the required value is among its entries; a scalar\n      // matches by equality. Without the array case a multi-select could never satisfy a criterion.\n      return Array.isArray(recorded)\n        ? recorded.includes(String(requirement.equals))\n        : recorded === requirement.equals;\n    });\n    if (!allMatch) {\n      return false;\n    }\n  }\n\n  if (audience.createdAfter && ctx.userCreatedAt) {\n    if (ctx.userCreatedAt < audience.createdAfter) {\n      return false;\n    }\n  }\n\n  return true;\n}\n"]}

package/dist/esm/core/guidance/guidance-resource-compiler.shared.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guidance-resource-compiler.shared.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/guidance/guidance-resource-compiler.shared.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAIpE,OAAO,KAAK,EACV,+BAA+B,EAEhC,MAAM,+DAA+D,CAAC;AAIvE,MAAM,WAAW,8BAA8B;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,+BAA+B,EAAE,CAAC;IACjD,4HAA4H;IAC5H,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,sBAAsB,EAAE,CAwBzG"}
+{"version":3,"file":"guidance-resource-compiler.shared.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/guidance/guidance-resource-compiler.shared.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAIpE,OAAO,KAAK,EACV,+BAA+B,EAEhC,MAAM,+DAA+D,CAAC;AAQvE,MAAM,WAAW,8BAA8B;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,+BAA+B,EAAE,CAAC;IACjD,4HAA4H;IAC5H,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,sBAAsB,EAAE,CAwEzG"}

package/dist/esm/core/guidance/guidance-resource-compiler.shared.utils.js

@@ -10,6 +10,9 @@
  */
 import { GuidanceFlowScope } from '@wildo-ai/saas-models';
 import { OnboardingTriggerType, OnboardingElementType, TourStepPlacement } from '@wildo-ai/saas-models';
+import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
+/** Flows already reported as declaring more than one checklist, so the warning fires once. */
+const warnedMultiChecklistFlowRefs = new Set();
 /**
  * Compile resource-level guidance declarations into standard GuidanceFlowDefinition objects.
  *
@@ -25,6 +28,49 @@ export function compileResourceGuidance(options) {
         const trigger = resolveFlowTrigger(flow, resourceType, urlPatterns);
         // 3. Map elements to OnboardingElement format
         const elements = flow.elements.map((el, index) => compileElement(el, index));
+        /**
+         * 3b. Point each CHECKLIST at the CHECKLIST_ITEMs declared beside it.
+         *
+         * `compileElement` sees one element at a time, so it emitted `items: []` for every checklist —
+         * and `GuidanceChecklist` derives BOTH its completed count and its total from `items.length`.
+         * A resource-level checklist therefore rendered a permanently empty progress bar and the text
+         * `0/0`, however many items were authored, because the only thing that knew about the siblings
+         * was this loop.
+         *
+         * A checklist owns every checklist-item in its own flow: the resource-level authoring surface
+         * has no nesting, so declaring an item beside a checklist IS how membership is expressed. Refs
+         * are carried through `compileElement` unchanged, so they address the same elements the flow's
+         * per-element state is keyed by.
+         *
+         * ## Why only the FIRST checklist gets them
+         *
+         * That premise holds for one checklist per flow and for no other number.
+         * `ResourceFrontend_GuidanceElement` has no `items` field and no nesting, so a flow declaring
+         * TWO checklists cannot say which items belong to which — and assigning the whole set to both
+         * made `GuidanceRenderer` render every item inside BOTH containers: duplicated rows, both
+         * showing the same `N/N`, with nothing reporting it.
+         *
+         * The first container owns the items and the rest get none, so the second checklist renders
+         * empty — a visible gap rather than a convincing duplicate — and the warning names the flow so
+         * the author can split it into two flows, which is the shape the authoring surface does express.
+         */
+        const itemRefs = elements
+            .filter(el => el.type === OnboardingElementType.CHECKLIST_ITEM)
+            .map(el => el.ref);
+        let checklistsSeen = 0;
+        for (const element of elements) {
+            if (element.type === OnboardingElementType.CHECKLIST) {
+                checklistsSeen++;
+                element.items = checklistsSeen === 1 ? itemRefs : [];
+            }
+        }
+        if (checklistsSeen > 1 && itemRefs.length > 0 && !warnedMultiChecklistFlowRefs.has(namespacedRef)) {
+            warnedMultiChecklistFlowRefs.add(namespacedRef);
+            LoggerFrontendService.getLogger().warn(`compileResourceGuidance: flow "${namespacedRef}" declares ${checklistsSeen} checklists and `
+                + `${itemRefs.length} checklist item(s). The resource-level authoring surface cannot express `
+                + `which items belong to which checklist, so the first checklist owns them all and the others `
+                + `render empty. Declare one checklist per flow.`);
+        }
         // 4. Return standard GuidanceFlowDefinition
         return {
             ref: namespacedRef,
@@ -55,7 +101,11 @@ function resolveFlowTrigger(flow, resourceType, urlPatterns) {
             return {
                 type: OnboardingTriggerType.ROUTE_MATCH,
                 routePattern: routePattern ?? `/${resourceType.toLowerCase()}`,
-                conditions: { newUsersOnly: true, triggerOnce: true },
+                // `conditions: { newUsersOnly: true, triggerOnce: true }` stood here and was REMOVED with
+                // the vocabulary itself (#1369). It was this repository's ONLY producer of `conditions`,
+                // it emitted a constant, and nothing anywhere read it back. Both values described what the
+                // runtime already does: a flow does not re-trigger because every status transition refuses
+                // from a terminal status.
             };
         }
         case 'MANUAL':

package/dist/esm/core/guidance/guidance-resource-compiler.shared.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"guidance-resource-compiler.shared.utils.js","sourceRoot":"","sources":["../../../../src/core/guidance/guidance-resource-compiler.shared.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Guidance Resource Compiler\n *\n * Compiles resource-level guidance declarations (ResourceUIBehavior_GuidanceFlow)\n * into standard GuidanceFlowDefinition objects that can be consumed by the Guidance System.\n *\n * Resource-level guidance is declared in the frontend preset via\n * `ResourceUIBehaviorConfig.guidance`. The compiler namespaces refs (e.g., \"TASKS.list-intro\"),\n * resolves triggers, and maps elements to the standard OnboardingElement format.\n */\n\nimport type { GuidanceFlowDefinition } from '@wildo-ai/saas-models';\nimport { GuidanceRenderMode, GuidanceFlowScope } from '@wildo-ai/saas-models';\nimport { OnboardingTriggerType, OnboardingElementType, TourStepPlacement } from '@wildo-ai/saas-models';\nimport type { OnboardingTrigger, OnboardingElement } from '@wildo-ai/saas-models';\nimport type {\n  ResourceUIBehavior_GuidanceFlow,\n  ResourceFrontend_GuidanceElement,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\n// ─── Public API ──────────────────────────────────────────────\n\nexport interface CompileResourceGuidanceOptions {\n  resourceType: string;\n  guidanceFlows: ResourceUIBehavior_GuidanceFlow[];\n  /** URL patterns per operation (e.g., { LIST: '/organizations/:orgId/tasks', CREATE: '/organizations/:orgId/tasks/new' }) */\n  urlPatterns?: Record<string, string>;\n}\n\n/**\n * Compile resource-level guidance declarations into standard GuidanceFlowDefinition objects.\n *\n * @param options - Resource type, guidance flows, and optional URL patterns\n * @returns Array of GuidanceFlowDefinition ready for the Guidance System\n */\nexport function compileResourceGuidance(options: CompileResourceGuidanceOptions): GuidanceFlowDefinition[] {\n  const { resourceType, guidanceFlows, urlPatterns } = options;\n\n  return guidanceFlows.map((flow) => {\n    // 1. Namespace ref: TASKS.list-intro\n    const namespacedRef = `${resourceType}.${flow.ref}`;\n\n    // 2. Resolve trigger\n    const trigger = resolveFlowTrigger(flow, resourceType, urlPatterns);\n\n    // 3. Map elements to OnboardingElement format\n    const elements = flow.elements.map((el, index) => compileElement(el, index));\n\n    // 4. Return standard GuidanceFlowDefinition\n    return {\n      ref: namespacedRef,\n      scope: flow.scope ?? GuidanceFlowScope.USER,\n      renderMode: flow.renderMode,\n      trigger,\n      audience: flow.audience,\n      priority: flow.priority ?? 100,\n      elements,\n    } satisfies GuidanceFlowDefinition;\n  });\n}\n\n// ─── Helpers ─────────────────────────────────────────────────\n\n/**\n * Map the resource-level trigger declaration to an OnboardingTrigger.\n *\n * - FIRST_VISIT → type='route-match' with routePattern derived from urlPatterns\n *   because resource-level guidance is operation-surface-bound, not app-global\n * - MANUAL → type='manual'\n * - DELAYED → type='delayed' with delayMs\n * - EVENT → type='event' with eventName (defaults to `${resourceType}:${bindToOperation}`)\n */\nfunction resolveFlowTrigger(\n  flow: ResourceUIBehavior_GuidanceFlow,\n  resourceType: string,\n  urlPatterns?: Record<string, string>,\n): OnboardingTrigger {\n  const triggerDef = flow.trigger;\n\n  switch (triggerDef.type) {\n    case 'FIRST_VISIT': {\n      const routePattern = urlPatterns?.[flow.bindToOperation];\n      return {\n        type: OnboardingTriggerType.ROUTE_MATCH,\n        routePattern: routePattern ?? `/${resourceType.toLowerCase()}`,\n        conditions: { newUsersOnly: true, triggerOnce: true },\n      };\n    }\n    case 'MANUAL':\n      return {\n        type: OnboardingTriggerType.MANUAL,\n      };\n    case 'DELAYED':\n      return {\n        type: OnboardingTriggerType.DELAYED,\n        delayMs: triggerDef.delayMs ?? 1000,\n      };\n    case 'EVENT': {\n      const eventName = triggerDef.eventName ?? `${resourceType}:${flow.bindToOperation}`;\n      return {\n        type: OnboardingTriggerType.EVENT,\n        eventName,\n      };\n    }\n    default:\n      return {\n        type: OnboardingTriggerType.MANUAL,\n      };\n  }\n}\n\n/**\n * Map a ResourceFrontend_GuidanceElement to a standard OnboardingElement.\n *\n * - Resolves `targetField` to `targetSelector` via `[data-guidance-field=\"...\"]`\n * - Preserves `targetField` as a custom property for runtime resolution by GuidanceRenderer\n * - Maps type-specific properties (steps, questions, placement, actionRef)\n */\nfunction compileElement(\n  el: ResourceFrontend_GuidanceElement,\n  index: number,\n): OnboardingElement {\n  // Resolve targetSelector: explicit selector takes precedence, then derive from targetField\n  const targetSelector = el.targetSelector ?? (el.targetField ? `[data-guidance-field=\"${el.targetField}\"]` : undefined);\n\n  // Build the base element — common fields across all element types\n  const base = {\n    ref: el.ref,\n    type: el.type,\n    order: index,\n    // targetField is a first-class field on OnboardingElementBaseSchema — used by\n    // GuidanceRenderer.resolveTargetSelector() to derive [data-guidance-field=\"...\"] selectors\n    ...(el.targetField ? { targetField: el.targetField } : {}),\n  };\n\n  // Build type-specific fields\n  switch (el.type) {\n    case OnboardingElementType.TOOLTIP:\n      return {\n        ...base,\n        type: OnboardingElementType.TOOLTIP,\n        targetSelector: targetSelector ?? '',\n        placement: mapPlacement(el.placement),\n      } as OnboardingElement;\n\n    case OnboardingElementType.TOUR:\n      return {\n        ...base,\n        type: OnboardingElementType.TOUR,\n        steps: (el.steps ?? []).map((step, stepIndex) => ({\n          ref: step.ref,\n          order: stepIndex,\n          placement: mapPlacement(step.placement) ?? TourStepPlacement.BOTTOM,\n          targetSelector: step.targetSelector ?? (step.targetField ? `[data-guidance-field=\"${step.targetField}\"]` : undefined),\n          ...(step.targetField ? { targetField: step.targetField } : {}),\n        })),\n      } as OnboardingElement;\n\n    case OnboardingElementType.MODAL:\n      return {\n        ...base,\n        type: OnboardingElementType.MODAL,\n        dismissible: true,\n        ...(el.actionRef ? { ctaAction: el.actionRef } : {}),\n      } as OnboardingElement;\n\n    case OnboardingElementType.BANNER:\n      return {\n        ...base,\n        type: OnboardingElementType.BANNER,\n        ...(el.actionRef ? { actionRef: el.actionRef } : {}),\n      } as OnboardingElement;\n\n    case OnboardingElementType.ANNOUNCEMENT:\n      return {\n        ...base,\n        type: OnboardingElementType.ANNOUNCEMENT,\n        ...(el.actionRef ? { actionRef: el.actionRef } : {}),\n      } as OnboardingElement;\n\n    case OnboardingElementType.BADGE:\n      return {\n        ...base,\n        type: OnboardingElementType.BADGE,\n        ...(targetSelector ? { targetSelector } : {}),\n      } as OnboardingElement;\n\n    case OnboardingElementType.CARD:\n      return {\n        ...base,\n        type: OnboardingElementType.CARD,\n        ...(el.actionRef ? { actionRef: el.actionRef } : {}),\n      } as OnboardingElement;\n\n    case OnboardingElementType.SURVEY:\n      return {\n        ...base,\n        type: OnboardingElementType.SURVEY,\n        questions: (el.questions ?? []).map((q) => ({\n          id: q.id,\n          type: q.type as any,\n          required: q.required ?? false,\n          options: q.options?.map((opt) => ({ ref: opt.ref })),\n        })),\n      } as OnboardingElement;\n\n    case OnboardingElementType.CHECKLIST:\n      return {\n        ...base,\n        type: OnboardingElementType.CHECKLIST,\n        items: [],\n      } as OnboardingElement;\n\n    case OnboardingElementType.CHECKLIST_ITEM:\n      return {\n        ...base,\n        type: OnboardingElementType.CHECKLIST_ITEM,\n        ...(el.actionRef ? { actionRef: el.actionRef } : {}),\n      } as OnboardingElement;\n\n    default:\n      // Fallback for unknown/new element types — double-cast is intentional because\n      // the discriminated union requires type-specific fields we cannot know here.\n      // This should only be reached for future element types not yet in the compiler.\n      return {\n        ...base,\n        type: el.type,\n      } as unknown as OnboardingElement;\n  }\n}\n\n/**\n * Map a string placement to the TourStepPlacement enum.\n */\nfunction mapPlacement(placement?: string): TourStepPlacement | undefined {\n  if (!placement) return undefined;\n  const upper = placement.toUpperCase();\n  if (upper in TourStepPlacement) {\n    return TourStepPlacement[upper as keyof typeof TourStepPlacement];\n  }\n  return undefined;\n}\n"]}
+{"version":3,"file":"guidance-resource-compiler.shared.utils.js","sourceRoot":"","sources":["../../../../../src/core/guidance/guidance-resource-compiler.shared.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Guidance Resource Compiler\n *\n * Compiles resource-level guidance declarations (ResourceUIBehavior_GuidanceFlow)\n * into standard GuidanceFlowDefinition objects that can be consumed by the Guidance System.\n *\n * Resource-level guidance is declared in the frontend preset via\n * `ResourceUIBehaviorConfig.guidance`. The compiler namespaces refs (e.g., \"TASKS.list-intro\"),\n * resolves triggers, and maps elements to the standard OnboardingElement format.\n */\n\nimport type { GuidanceFlowDefinition } from '@wildo-ai/saas-models';\nimport { GuidanceRenderMode, GuidanceFlowScope } from '@wildo-ai/saas-models';\nimport { OnboardingTriggerType, OnboardingElementType, TourStepPlacement } from '@wildo-ai/saas-models';\nimport type { OnboardingTrigger, OnboardingElement } from '@wildo-ai/saas-models';\nimport type {\n  ResourceUIBehavior_GuidanceFlow,\n  ResourceFrontend_GuidanceElement,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\n/** Flows already reported as declaring more than one checklist, so the warning fires once. */\nconst warnedMultiChecklistFlowRefs = new Set<string>();\n\n// ─── Public API ──────────────────────────────────────────────\n\nexport interface CompileResourceGuidanceOptions {\n  resourceType: string;\n  guidanceFlows: ResourceUIBehavior_GuidanceFlow[];\n  /** URL patterns per operation (e.g., { LIST: '/organizations/:orgId/tasks', CREATE: '/organizations/:orgId/tasks/new' }) */\n  urlPatterns?: Record<string, string>;\n}\n\n/**\n * Compile resource-level guidance declarations into standard GuidanceFlowDefinition objects.\n *\n * @param options - Resource type, guidance flows, and optional URL patterns\n * @returns Array of GuidanceFlowDefinition ready for the Guidance System\n */\nexport function compileResourceGuidance(options: CompileResourceGuidanceOptions): GuidanceFlowDefinition[] {\n  const { resourceType, guidanceFlows, urlPatterns } = options;\n\n  return guidanceFlows.map((flow) => {\n    // 1. Namespace ref: TASKS.list-intro\n    const namespacedRef = `${resourceType}.${flow.ref}`;\n\n    // 2. Resolve trigger\n    const trigger = resolveFlowTrigger(flow, resourceType, urlPatterns);\n\n    // 3. Map elements to OnboardingElement format\n    const elements = flow.elements.map((el, index) => compileElement(el, index));\n\n    /**\n     * 3b. Point each CHECKLIST at the CHECKLIST_ITEMs declared beside it.\n     *\n     * `compileElement` sees one element at a time, so it emitted `items: []` for every checklist —\n     * and `GuidanceChecklist` derives BOTH its completed count and its total from `items.length`.\n     * A resource-level checklist therefore rendered a permanently empty progress bar and the text\n     * `0/0`, however many items were authored, because the only thing that knew about the siblings\n     * was this loop.\n     *\n     * A checklist owns every checklist-item in its own flow: the resource-level authoring surface\n     * has no nesting, so declaring an item beside a checklist IS how membership is expressed. Refs\n     * are carried through `compileElement` unchanged, so they address the same elements the flow's\n     * per-element state is keyed by.\n     *\n     * ## Why only the FIRST checklist gets them\n     *\n     * That premise holds for one checklist per flow and for no other number.\n     * `ResourceFrontend_GuidanceElement` has no `items` field and no nesting, so a flow declaring\n     * TWO checklists cannot say which items belong to which — and assigning the whole set to both\n     * made `GuidanceRenderer` render every item inside BOTH containers: duplicated rows, both\n     * showing the same `N/N`, with nothing reporting it.\n     *\n     * The first container owns the items and the rest get none, so the second checklist renders\n     * empty — a visible gap rather than a convincing duplicate — and the warning names the flow so\n     * the author can split it into two flows, which is the shape the authoring surface does express.\n     */\n    const itemRefs = elements\n      .filter(el => el.type === OnboardingElementType.CHECKLIST_ITEM)\n      .map(el => el.ref);\n\n    let checklistsSeen = 0;\n    for (const element of elements) {\n      if (element.type === OnboardingElementType.CHECKLIST) {\n        checklistsSeen++;\n        (element as { items: string[] }).items = checklistsSeen === 1 ? itemRefs : [];\n      }\n    }\n\n    if (checklistsSeen > 1 && itemRefs.length > 0 && !warnedMultiChecklistFlowRefs.has(namespacedRef)) {\n      warnedMultiChecklistFlowRefs.add(namespacedRef);\n      LoggerFrontendService.getLogger().warn(\n        `compileResourceGuidance: flow \"${namespacedRef}\" declares ${checklistsSeen} checklists and `\n          + `${itemRefs.length} checklist item(s). The resource-level authoring surface cannot express `\n          + `which items belong to which checklist, so the first checklist owns them all and the others `\n          + `render empty. Declare one checklist per flow.`,\n      );\n    }\n\n    // 4. Return standard GuidanceFlowDefinition\n    return {\n      ref: namespacedRef,\n      scope: flow.scope ?? GuidanceFlowScope.USER,\n      renderMode: flow.renderMode,\n      trigger,\n      audience: flow.audience,\n      priority: flow.priority ?? 100,\n      elements,\n    } satisfies GuidanceFlowDefinition;\n  });\n}\n\n// ─── Helpers ─────────────────────────────────────────────────\n\n/**\n * Map the resource-level trigger declaration to an OnboardingTrigger.\n *\n * - FIRST_VISIT → type='route-match' with routePattern derived from urlPatterns\n *   because resource-level guidance is operation-surface-bound, not app-global\n * - MANUAL → type='manual'\n * - DELAYED → type='delayed' with delayMs\n * - EVENT → type='event' with eventName (defaults to `${resourceType}:${bindToOperation}`)\n */\nfunction resolveFlowTrigger(\n  flow: ResourceUIBehavior_GuidanceFlow,\n  resourceType: string,\n  urlPatterns?: Record<string, string>,\n): OnboardingTrigger {\n  const triggerDef = flow.trigger;\n\n  switch (triggerDef.type) {\n    case 'FIRST_VISIT': {\n      const routePattern = urlPatterns?.[flow.bindToOperation];\n      return {\n        type: OnboardingTriggerType.ROUTE_MATCH,\n        routePattern: routePattern ?? `/${resourceType.toLowerCase()}`,\n        // `conditions: { newUsersOnly: true, triggerOnce: true }` stood here and was REMOVED with\n        // the vocabulary itself (#1369). It was this repository's ONLY producer of `conditions`,\n        // it emitted a constant, and nothing anywhere read it back. Both values described what the\n        // runtime already does: a flow does not re-trigger because every status transition refuses\n        // from a terminal status.\n      };\n    }\n    case 'MANUAL':\n      return {\n        type: OnboardingTriggerType.MANUAL,\n      };\n    case 'DELAYED':\n      return {\n        type: OnboardingTriggerType.DELAYED,\n        delayMs: triggerDef.delayMs ?? 1000,\n      };\n    case 'EVENT': {\n      const eventName = triggerDef.eventName ?? `${resourceType}:${flow.bindToOperation}`;\n      return {\n        type: OnboardingTriggerType.EVENT,\n        eventName,\n      };\n    }\n    default:\n      return {\n        type: OnboardingTriggerType.MANUAL,\n      };\n  }\n}\n\n/**\n * Map a ResourceFrontend_GuidanceElement to a standard OnboardingElement.\n *\n * - Resolves `targetField` to `targetSelector` via `[data-guidance-field=\"...\"]`\n * - Preserves `targetField` as a custom property for runtime resolution by GuidanceRenderer\n * - Maps type-specific properties (steps, questions, placement, actionRef)\n */\nfunction compileElement(\n  el: ResourceFrontend_GuidanceElement,\n  index: number,\n): OnboardingElement {\n  // Resolve targetSelector: explicit selector takes precedence, then derive from targetField\n  const targetSelector = el.targetSelector ?? (el.targetField ? `[data-guidance-field=\"${el.targetField}\"]` : undefined);\n\n  // Build the base element — common fields across all element types\n  const base = {\n    ref: el.ref,\n    type: el.type,\n    order: index,\n    // targetField is a first-class field on OnboardingElementBaseSchema — used by\n    // GuidanceRenderer.resolveTargetSelector() to derive [data-guidance-field=\"...\"] selectors\n    ...(el.targetField ? { targetField: el.targetField } : {}),\n  };\n\n  // Build type-specific fields\n  switch (el.type) {\n    case OnboardingElementType.TOOLTIP:\n      return {\n        ...base,\n        type: OnboardingElementType.TOOLTIP,\n        targetSelector: targetSelector ?? '',\n        placement: mapPlacement(el.placement),\n      } as OnboardingElement;\n\n    case OnboardingElementType.TOUR:\n      return {\n        ...base,\n        type: OnboardingElementType.TOUR,\n        steps: (el.steps ?? []).map((step, stepIndex) => ({\n          ref: step.ref,\n          order: stepIndex,\n          placement: mapPlacement(step.placement) ?? TourStepPlacement.BOTTOM,\n          targetSelector: step.targetSelector ?? (step.targetField ? `[data-guidance-field=\"${step.targetField}\"]` : undefined),\n          ...(step.targetField ? { targetField: step.targetField } : {}),\n        })),\n      } as OnboardingElement;\n\n    case OnboardingElementType.MODAL:\n      return {\n        ...base,\n        type: OnboardingElementType.MODAL,\n        dismissible: true,\n        ...(el.actionRef ? { ctaAction: el.actionRef } : {}),\n      } as OnboardingElement;\n\n    case OnboardingElementType.BANNER:\n      return {\n        ...base,\n        type: OnboardingElementType.BANNER,\n        ...(el.actionRef ? { actionRef: el.actionRef } : {}),\n      } as OnboardingElement;\n\n    case OnboardingElementType.ANNOUNCEMENT:\n      return {\n        ...base,\n        type: OnboardingElementType.ANNOUNCEMENT,\n        ...(el.actionRef ? { actionRef: el.actionRef } : {}),\n      } as OnboardingElement;\n\n    case OnboardingElementType.BADGE:\n      return {\n        ...base,\n        type: OnboardingElementType.BADGE,\n        ...(targetSelector ? { targetSelector } : {}),\n      } as OnboardingElement;\n\n    case OnboardingElementType.CARD:\n      return {\n        ...base,\n        type: OnboardingElementType.CARD,\n        ...(el.actionRef ? { actionRef: el.actionRef } : {}),\n      } as OnboardingElement;\n\n    case OnboardingElementType.SURVEY:\n      return {\n        ...base,\n        type: OnboardingElementType.SURVEY,\n        questions: (el.questions ?? []).map((q) => ({\n          id: q.id,\n          type: q.type as any,\n          required: q.required ?? false,\n          options: q.options?.map((opt) => ({ ref: opt.ref })),\n        })),\n      } as OnboardingElement;\n\n    case OnboardingElementType.CHECKLIST:\n      return {\n        ...base,\n        type: OnboardingElementType.CHECKLIST,\n        items: [],\n      } as OnboardingElement;\n\n    case OnboardingElementType.CHECKLIST_ITEM:\n      return {\n        ...base,\n        type: OnboardingElementType.CHECKLIST_ITEM,\n        ...(el.actionRef ? { actionRef: el.actionRef } : {}),\n      } as OnboardingElement;\n\n    default:\n      // Fallback for unknown/new element types — double-cast is intentional because\n      // the discriminated union requires type-specific fields we cannot know here.\n      // This should only be reached for future element types not yet in the compiler.\n      return {\n        ...base,\n        type: el.type,\n      } as unknown as OnboardingElement;\n  }\n}\n\n/**\n * Map a string placement to the TourStepPlacement enum.\n */\nfunction mapPlacement(placement?: string): TourStepPlacement | undefined {\n  if (!placement) return undefined;\n  const upper = placement.toUpperCase();\n  if (upper in TourStepPlacement) {\n    return TourStepPlacement[upper as keyof typeof TourStepPlacement];\n  }\n  return undefined;\n}\n"]}

package/dist/esm/core/guidance/renderers/GuidanceAnnouncement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GuidanceAnnouncement.d.ts","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceAnnouncement.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAsB,MAAM,OAAO,CAAC;AAS3C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AASvG,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CAgEvE,CAAC"}
+{"version":3,"file":"GuidanceAnnouncement.d.ts","sourceRoot":"","sources":["../../../../../../src/core/guidance/renderers/GuidanceAnnouncement.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAsB,MAAM,OAAO,CAAC;AAS3C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AASvG,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CAgEvE,CAAC"}

package/dist/esm/core/guidance/renderers/GuidanceAnnouncement.js.map

@@ -1 +1 @@
-{"version":3,"file":"GuidanceAnnouncement.js","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceAnnouncement.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * GuidanceAnnouncement — Announcement renderer with icon support.\n *\n * Uses the engine Alert component for theme-compliant variant styling,\n * and Button for actions/dismiss.\n */\n\nimport React, { useCallback } from 'react';\nimport { OnboardingVariant } from '@wildo-ai/saas-models';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { Alert, AlertTitle, AlertDescription } from '~wildo-frontend-lib/components/overlays/containers/alert';\nimport { Button, ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport { ButtonSize } from '@wildo-ai/presets-components-models';\nimport { useIconRegistry } from '~wildo-frontend-lib/core/icons/useIconRegistry';\nimport { IconSize, StandardIconReference } from '~wildo-frontend-lib/core/icons/icon-registry.frontend.schemas';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport type { GuidanceElementRendererProps } from '~wildo-frontend-lib/core/guidance/GuidanceRenderer';\n\nconst VARIANT_MAP: Record<OnboardingVariant, 'info' | 'success' | 'warning' | 'destructive'> = {\n  [OnboardingVariant.INFO]: 'info',\n  [OnboardingVariant.SUCCESS]: 'success',\n  [OnboardingVariant.WARNING]: 'warning',\n  [OnboardingVariant.ERROR]: 'destructive',\n};\n\nexport const GuidanceAnnouncement: React.FC<GuidanceElementRendererProps> = ({\n  element,\n  t,\n  onAction,\n  onDismiss,\n}) => {\n  const { tComponent, isReady } = useI18n({ component: FrontendComponentType.GUIDANCE_ANNOUNCEMENT });\n  const { renderIcon } = useIconRegistry();\n\n  const handleDismiss = useCallback(() => {\n    onDismiss(element.ref);\n  }, [onDismiss, element.ref]);\n\n  if (!isReady) return null;\n\n  const el = element as Extract<typeof element, { type: 'announcement' }>;\n\n  const variant = el.variant ?? OnboardingVariant.INFO;\n  const dismissible = el.dismissible ?? true;\n\n  const title = t('title');\n  const content = t('content');\n  const actionLabel = t('actionLabel');\n  const actionRef = el.actionRef;\n  const icon = el.icon;\n\n  return (\n    <Alert\n      variant={VARIANT_MAP[variant]}\n      role=\"status\"\n      className=\"pointer-events-auto relative\"\n    >\n      {icon && (\n        <span className=\"text-xl leading-none shrink-0 mt-0.5\" aria-hidden=\"true\">\n          {icon}\n        </span>\n      )}\n\n      <div className=\"flex-1 min-w-0\">\n        {title && <AlertTitle>{title}</AlertTitle>}\n        {content && <AlertDescription>{content}</AlertDescription>}\n\n        {actionLabel && actionRef && (\n          <div className=\"mt-3\">\n            <Button size={ButtonSize.SM} onClick={() => onAction(actionRef)}>\n              {actionLabel}\n            </Button>\n          </div>\n        )}\n      </div>\n\n      {dismissible && (\n        <Button\n          variant={ButtonVariants_Variant.GHOST}\n          size={ButtonSize.ICON_SM}\n          onClick={handleDismiss}\n          aria-label={tComponent(FrontendComponentType.GUIDANCE_ANNOUNCEMENT, 'dismiss')}\n          className=\"absolute top-2 end-2\"\n        >\n          {renderIcon(StandardIconReference.CLOSE, { size: IconSize.SM })}\n        </Button>\n      )}\n    </Alert>\n  );\n};\n"]}
+{"version":3,"file":"GuidanceAnnouncement.js","sourceRoot":"","sources":["../../../../../../src/core/guidance/renderers/GuidanceAnnouncement.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * GuidanceAnnouncement — Announcement renderer with icon support.\n *\n * Uses the engine Alert component for theme-compliant variant styling,\n * and Button for actions/dismiss.\n */\n\nimport React, { useCallback } from 'react';\nimport { OnboardingVariant } from '@wildo-ai/saas-models';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { Alert, AlertTitle, AlertDescription } from '~wildo-frontend-lib/components/overlays/containers/alert';\nimport { Button, ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport { ButtonSize } from '@wildo-ai/presets-components-models';\nimport { useIconRegistry } from '~wildo-frontend-lib/core/icons/useIconRegistry';\nimport { IconSize, StandardIconReference } from '~wildo-frontend-lib/core/icons/icon-registry.frontend.schemas';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport type { GuidanceElementRendererProps } from '~wildo-frontend-lib/core/guidance/GuidanceRenderer';\n\nconst VARIANT_MAP: Record<OnboardingVariant, 'info' | 'success' | 'warning' | 'destructive'> = {\n  [OnboardingVariant.INFO]: 'info',\n  [OnboardingVariant.SUCCESS]: 'success',\n  [OnboardingVariant.WARNING]: 'warning',\n  [OnboardingVariant.ERROR]: 'destructive',\n};\n\nexport const GuidanceAnnouncement: React.FC<GuidanceElementRendererProps> = ({\n  element,\n  t,\n  onAction,\n  onDismiss,\n}) => {\n  const { tComponent, isReady } = useI18n({ component: FrontendComponentType.GUIDANCE_ANNOUNCEMENT });\n  const { renderIcon } = useIconRegistry();\n\n  const handleDismiss = useCallback(() => {\n    onDismiss(element.ref);\n  }, [onDismiss, element.ref]);\n\n  if (!isReady) return null;\n\n  const el = element as Extract<typeof element, { type: 'announcement' }>;\n\n  const variant = el.variant ?? OnboardingVariant.INFO;\n  const dismissible = el.dismissible ?? true;\n\n  const title = t('title');\n  const content = t('content');\n  const actionLabel = t('actionLabel');\n  const actionRef = el.actionRef;\n  const icon = el.icon;\n\n  return (\n    <Alert\n      variant={VARIANT_MAP[variant]}\n      role=\"status\"\n      className=\"pointer-events-auto relative\"\n    >\n      {icon && (\n        <span className=\"text-xl leading-none shrink-0 mt-0.5\" aria-hidden=\"true\">\n          {icon}\n        </span>\n      )}\n\n      <div className=\"flex-1 min-w-0\">\n        {title && <AlertTitle>{title}</AlertTitle>}\n        {content && <AlertDescription>{content}</AlertDescription>}\n\n        {actionLabel && actionRef && (\n          <div className=\"mt-3\">\n            <Button size={ButtonSize.SM} onClick={() => onAction(actionRef)}>\n              {actionLabel}\n            </Button>\n          </div>\n        )}\n      </div>\n\n      {dismissible && (\n        <Button\n          variant={ButtonVariants_Variant.GHOST}\n          size={ButtonSize.ICON_SM}\n          onClick={handleDismiss}\n          aria-label={tComponent(FrontendComponentType.GUIDANCE_ANNOUNCEMENT, 'dismiss')}\n          className=\"absolute top-2 end-2\"\n        >\n          {renderIcon(StandardIconReference.CLOSE, { size: IconSize.SM })}\n        </Button>\n      )}\n    </Alert>\n  );\n};\n"]}

package/dist/esm/core/guidance/renderers/GuidanceAnnouncement.labels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GuidanceAnnouncement.labels.d.ts","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceAnnouncement.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM1I,eAAO,MAAM,0BAA0B,EAAE,mBAAmB,EAE3D,CAAC"}
+{"version":3,"file":"GuidanceAnnouncement.labels.d.ts","sourceRoot":"","sources":["../../../../../../src/core/guidance/renderers/GuidanceAnnouncement.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM1I,eAAO,MAAM,0BAA0B,EAAE,mBAAmB,EAE3D,CAAC"}

package/dist/esm/core/guidance/renderers/GuidanceAnnouncement.labels.js.map

@@ -1 +1 @@
-{"version":3,"file":"GuidanceAnnouncement.labels.js","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceAnnouncement.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE1I,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,0BAA0B,GAA0B;IAC/D,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,yDAAyD,EAAE;CAC/G,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,qBAAqB,EAAE,0BAA0B,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, LabelKind, type LabellingUnitaryDef, registerComponentLabels } 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 GuidanceAnnouncementLabels: LabellingUnitaryDef[] = [\n  { ref: 'dismiss', kind: LabelKind.BUTTON, purpose: 'Action that dismisses the announcement guidance element' },\n];\nregisterComponentLabels(FrontendComponentType.GUIDANCE_ANNOUNCEMENT, GuidanceAnnouncementLabels);\n"]}
+{"version":3,"file":"GuidanceAnnouncement.labels.js","sourceRoot":"","sources":["../../../../../../src/core/guidance/renderers/GuidanceAnnouncement.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAA4B,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE1I,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAE/E,MAAM,CAAC,MAAM,0BAA0B,GAA0B;IAC/D,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,yDAAyD,EAAE;CAC/G,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,qBAAqB,EAAE,0BAA0B,CAAC,CAAC","sourcesContent":["import { FrontendComponentType, LabelKind, type LabellingUnitaryDef, registerComponentLabels } 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 GuidanceAnnouncementLabels: LabellingUnitaryDef[] = [\n  { ref: 'dismiss', kind: LabelKind.BUTTON, purpose: 'Action that dismisses the announcement guidance element' },\n];\nregisterComponentLabels(FrontendComponentType.GUIDANCE_ANNOUNCEMENT, GuidanceAnnouncementLabels);\n"]}

package/dist/esm/core/guidance/renderers/GuidanceBadge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GuidanceBadge.d.ts","sourceRoot":"","sources":["../../../../../src/core/guidance/renderers/GuidanceBadge.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AAYvG,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CA0BhE,CAAC"}
+{"version":3,"file":"GuidanceBadge.d.ts","sourceRoot":"","sources":["../../../../../../src/core/guidance/renderers/GuidanceBadge.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oDAAoD,CAAC;AAmBvG,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CA0BhE,CAAC"}