@wildo-ai/presets-components 1.1.4 → 1.1.6

package/dist/esm/components/app/app-layout-main-container.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-layout-main-container.js","sourceRoot":"","sources":["../../../../../src/components/app/app-layout-main-container.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { useCallback, useEffect, useState } from 'react';\n\nimport { FrontendComponentType, HorizontalPlacement, ShellAppearance, SurfaceVariant, VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport {\n  AppLayoutPreset_MainContainer_DefaultProps,\n  ApplicationLevel_StatusBar,\n  ApplicationLevel_MenuBar,\n  ApplicationLevel_Toolbar,\n  ApplicationLevel_ActivityBar,\n  ApplicationLevel_QuickActionButton,\n  ApplicationLevel_Sidebar,\n  ApplicationLevel_UtilityPanel,\n  NavigationContentAreas,\n  NavigationOverlays,\n  useAppShellLayout,\n  HostedComponentInteractionsProvider,\n  PortalContainerContext,\n  GuidanceRenderer,\n  LoadingSpinner,\n  NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE,\n  Surface,\n  cn,\n  useUI,\n} from '@wildo-ai/saas-frontend-lib';\n\nexport const AppLayoutPreset_MainContainer_Default = ({ children }: AppLayoutPreset_MainContainer_DefaultProps): React.JSX.Element => {\n  const layoutInfo = useAppShellLayout();\n  const { shellAppearance } = useUI();\n  // CONTINUOUS shell chrome: the root paints NOTHING so the theme's fixed\n  // `backgroundLayer` (rendered by UIProvider behind the app) is the single\n  // continuous canvas under sidebar, bars, and content alike.\n  const isContinuousShell = shellAppearance === ShellAppearance.CONTINUOUS;\n  const [portalContainer, setPortalContainer] = useState<HTMLElement | null>(null);\n  const portalRef = useCallback((node: HTMLDivElement | null) => {\n    setPortalContainer(node);\n  }, []);\n\n  // ===================================================================\n  // Loading State\n  // ===================================================================\n\n  // Latch the FIRST layout-ready flip. `isLayoutReady` derives from config presence\n  // and can transiently drop after bootstrap (e.g. an org switch reloading config);\n  // replacing the whole mounted shell with a spinner on such a drop unmounts every\n  // provider/zone below it and destroys navigation state — the same failure mode\n  // AppLoadingGate documents. The spinner branch therefore only applies BEFORE the\n  // shell has ever been ready; later drops keep the shell mounted (per-component\n  // `has*` flags simply render nothing while config is absent).\n  const [hasLayoutBeenReady, setHasLayoutBeenReady] = useState(false);\n  useEffect(() => {\n    if (layoutInfo.isLayoutReady) setHasLayoutBeenReady(true);\n  }, [layoutInfo.isLayoutReady]);\n\n  if (!layoutInfo.isLayoutReady && !hasLayoutBeenReady) {\n    return (\n      <Surface asChild emitPolicyVars={false} variant={SurfaceVariant.SHELL} policyOverride={NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE}>\n        <div className=\"h-screen w-screen bg-background flex items-center justify-center\" role=\"status\" aria-live=\"polite\">\n          <div className=\"text-center\">\n            <LoadingSpinner size={32} className=\"text-primary mx-auto mb-field\" aria-hidden=\"true\" />\n          </div>\n        </div>\n      </Surface>\n    );\n  }\n\n  // ===================================================================\n  // Main Layout Rendering - PLACEMENT ONLY\n  // ===================================================================\n\n  return (\n    <PortalContainerContext.Provider value={portalContainer}>\n      <HostedComponentInteractionsProvider>\n      <Surface asChild emitPolicyVars={false} variant={SurfaceVariant.SHELL} policyOverride={NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE}>\n        <div className={cn('h-screen w-screen flex overflow-hidden', isContinuousShell ? 'bg-transparent' : 'bg-background')}>\n          {/* Activity Bar - leftmost */}\n          {layoutInfo.hasActivityBar && (\n            <ApplicationLevel_ActivityBar />\n          )}\n\n          {/* Sidebar - START (full height) */}\n          {layoutInfo.hasSidebar && layoutInfo.sidebarPlacement === HorizontalPlacement.START && (\n            <ApplicationLevel_Sidebar placement={HorizontalPlacement.START} />\n          )}\n\n          {/* Utility Panel trigger - START */}\n          {layoutInfo.hasUtilityPanel && layoutInfo.utilityPanelPlacement === HorizontalPlacement.START && (\n            <ApplicationLevel_UtilityPanel position={HorizontalPlacement.START} />\n          )}\n\n          {/* Right side: Menubar, Toolbar, Content, Status Bar */}\n          <div className=\"flex-1 flex flex-col min-w-0 min-h-0\">\n            {/* Status Bar - TOP */}\n            {layoutInfo.hasStatusBar && layoutInfo.statusBarPlacement === VerticalPlacement.TOP && (\n              <ApplicationLevel_StatusBar placement={VerticalPlacement.TOP} />\n            )}\n\n            {/* Menubar */}\n            {layoutInfo.hasMenubar && (\n              <ApplicationLevel_MenuBar />\n            )}\n\n            {/* Toolbar */}\n            {layoutInfo.hasToolbar && (\n              <ApplicationLevel_Toolbar />\n            )}\n\n            {/* Main Content Area */}\n            <div className=\"flex-1 flex min-h-0\">\n              <main ref={portalRef} className=\"flex-1 relative min-w-0\">\n                <NavigationContentAreas routerChildren={children} />\n\n                {/* Floating Quick Action Button */}\n                {layoutInfo.hasQuickActionButton && (\n                  <ApplicationLevel_QuickActionButton placement=\"floating\" />\n                )}\n              </main>\n\n              {/* Sidebar - END (full height within content area) */}\n              {layoutInfo.hasSidebar && layoutInfo.sidebarPlacement === HorizontalPlacement.END && (\n                <ApplicationLevel_Sidebar placement={HorizontalPlacement.END} />\n              )}\n            </div>\n\n            {/* Status Bar - BOTTOM */}\n            {layoutInfo.hasStatusBar && layoutInfo.statusBarPlacement === VerticalPlacement.BOTTOM && (\n              <ApplicationLevel_StatusBar placement={VerticalPlacement.BOTTOM} />\n            )}\n          </div>\n\n          {/* Navigation Overlays (Dialog & Sheet) */}\n          <NavigationOverlays />\n          <GuidanceRenderer />\n\n          {/* Utility Panel trigger - END */}\n          {layoutInfo.hasUtilityPanel && layoutInfo.utilityPanelPlacement === HorizontalPlacement.END && (\n            <ApplicationLevel_UtilityPanel position={HorizontalPlacement.END} />\n          )}\n        </div>\n      </Surface>\n      </HostedComponentInteractionsProvider>\n    </PortalContainerContext.Provider>\n  );\n};\n"]}
+{"version":3,"file":"app-layout-main-container.js","sourceRoot":"","sources":["../../../../../src/components/app/app-layout-main-container.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC3I,OAAO,EAEL,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,2CAA2C,EAC3C,OAAO,EACP,EAAE,EACF,KAAK,GACN,MAAM,6BAA6B,CAAC;AAErC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,EAAE,QAAQ,EAA8C,EAAqB,EAAE;IACnI,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;IACvC,MAAM,EAAE,eAAe,EAAE,GAAG,KAAK,EAAE,CAAC;IACpC,wEAAwE;IACxE,0EAA0E;IAC1E,4DAA4D;IAC5D,MAAM,iBAAiB,GAAG,eAAe,KAAK,eAAe,CAAC,UAAU,CAAC;IAEzE,sEAAsE;IACtE,gBAAgB;IAChB,sEAAsE;IAEtE,wGAAwG;IACxG,2FAA2F;IAC3F,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IAE3E,IAAI,CAAC,UAAU,CAAC,aAAa,IAAI,CAAC,kBAAkB;QAAE,OAAO,KAAC,oBAAoB,KAAG,CAAC;IAEtF,sEAAsE;IACtE,yCAAyC;IACzC,sEAAsE;IAEtE,OAAO,CACL,KAAC,iBAAiB,IAAC,MAAM,EAAE,UAAU,YACnC,KAAC,OAAO,IAAC,OAAO,QAAC,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,2CAA2C,YAahI,eAAK,SAAS,EAAE,EAAE,CAAC,iDAAiD,EAAE,iBAAiB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC,aAE3H,KAAC,oBAAoB,IAAC,MAAM,EAAE,WAAW,CAAC,YAAY,GAAI,EAG1D,KAAC,oBAAoB,IAAC,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,mBAAmB,CAAC,KAAK,GAAI,EAG3F,KAAC,oBAAoB,IAAC,MAAM,EAAE,WAAW,CAAC,aAAa,EAAE,SAAS,EAAE,mBAAmB,CAAC,KAAK,GAAI,EAGjG,eAAK,SAAS,EAAC,sCAAsC,aAEnD,KAAC,oBAAoB,IAAC,MAAM,EAAE,WAAW,CAAC,UAAU,EAAE,SAAS,EAAE,iBAAiB,CAAC,GAAG,GAAI,EAG1F,KAAC,oBAAoB,IAAC,MAAM,EAAE,WAAW,CAAC,OAAO,GAAI,EAGrD,KAAC,oBAAoB,IAAC,MAAM,EAAE,WAAW,CAAC,OAAO,GAAI,EAGrD,eAAK,SAAS,EAAC,qBAAqB,aAClC,KAAC,qBAAqB,IAAC,SAAS,EAAC,yBAAyB,YAAE,QAAQ,GAAyB,EAG7F,KAAC,oBAAoB,IAAC,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,mBAAmB,CAAC,GAAG,GAAI,IACrF,EAGN,KAAC,oBAAoB,IAAC,MAAM,EAAE,WAAW,CAAC,UAAU,EAAE,SAAS,EAAE,iBAAiB,CAAC,MAAM,GAAI,IACzF,EAGN,KAAC,sBAAsB,KAAG,EAG1B,KAAC,oBAAoB,IAAC,MAAM,EAAE,WAAW,CAAC,aAAa,EAAE,SAAS,EAAE,mBAAmB,CAAC,GAAG,GAAI,IAC3F,GACE,GACQ,CACrB,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import React from 'react';\n\nimport { HorizontalPlacement, ShellAppearance, ShellRegion, SurfaceVariant, VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport {\n  AppLayoutPreset_MainContainer_DefaultProps,\n  AppShellContentOutlet,\n  AppShellLoadingState,\n  AppShellOverlaysOutlet,\n  AppShellProviders,\n  AppShellRegionOutlet,\n  useAppShellFirstReady,\n  useAppShellLayout,\n  NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE,\n  Surface,\n  cn,\n  useUI,\n} from '@wildo-ai/saas-frontend-lib';\n\n/**\n * The default signed-in shell: the regions in a flex arrangement — activity bar and sidebar at the start edge,\n * a column of status bar / menubar / toolbar / content / status bar, the utility panel at the end edge.\n *\n * Composed from the shell building blocks (`AppShellProviders`, `AppShellRegionOutlet`, `AppShellContentOutlet`,\n * `AppShellOverlaysOutlet`, `useAppShellFirstReady`, #1842), so this file decides only the ARRANGEMENT and the\n * shell's own surface; another layout can arrange the same regions differently without copying it. Its rendered\n * DOM is pinned for every layout configuration by `app-layout-main-container.dom-snapshot.test.tsx`.\n */\nexport const AppLayoutPreset_MainContainer_Default = ({ children }: AppLayoutPreset_MainContainer_DefaultProps): React.JSX.Element => {\n  const layoutInfo = useAppShellLayout();\n  const { shellAppearance } = useUI();\n  // CONTINUOUS shell chrome: the root paints NOTHING so the theme's fixed\n  // `backgroundLayer` (rendered by UIProvider behind the app) is the single\n  // continuous canvas under sidebar, bars, and content alike.\n  const isContinuousShell = shellAppearance === ShellAppearance.CONTINUOUS;\n\n  // ===================================================================\n  // Loading State\n  // ===================================================================\n\n  // The spinner applies only BEFORE the shell has ever been ready: a later transient drop keeps the shell\n  // mounted (see `useAppShellFirstReady` for why a remount there destroys navigation state).\n  const hasLayoutBeenReady = useAppShellFirstReady(layoutInfo.isLayoutReady);\n\n  if (!layoutInfo.isLayoutReady && !hasLayoutBeenReady) return <AppShellLoadingState />;\n\n  // ===================================================================\n  // Main Layout Rendering - PLACEMENT ONLY\n  // ===================================================================\n\n  return (\n    <AppShellProviders layout={layoutInfo}>\n      <Surface asChild emitPolicyVars={false} variant={SurfaceVariant.SHELL} policyOverride={NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE}>\n        {/*\n          `relative` is load-bearing (#1830). A theme's decorative `backgroundLayer` is rendered by `UIContext`\n          in an `isolate` wrapper, which paints at the z-index:0 level — ABOVE ordinary in-flow content (see the\n          note there, and #1204 for the public layout). A shell text with no positioned ancestor therefore\n          vanished under the gradient: the status bar's \"Connected\" did, 1 of the shell's 91 visible texts.\n          Positioning the root lifts the WHOLE shell to that level, after the layer in tree order.\n          Deliberately NOT `isolate`: that would also make the shell one stacking context, so the consent\n          prompt (`z-50`, outside the shell) would paint over the shell's own dialogs (`--z-overlay`, 300).\n          A positioned root with `z-index: auto` creates no stacking context, so every z-index inside keeps\n          its current global order. The root spans the unscrolled viewport, so no absolutely positioned\n          descendant moves either.\n        */}\n        <div className={cn('relative h-screen w-screen flex overflow-hidden', isContinuousShell ? 'bg-transparent' : 'bg-background')}>\n          {/* Activity Bar - leftmost */}\n          <AppShellRegionOutlet region={ShellRegion.ACTIVITY_BAR} />\n\n          {/* Sidebar - START (full height) */}\n          <AppShellRegionOutlet region={ShellRegion.SIDEBAR} placement={HorizontalPlacement.START} />\n\n          {/* Utility Panel trigger - START */}\n          <AppShellRegionOutlet region={ShellRegion.UTILITY_PANEL} placement={HorizontalPlacement.START} />\n\n          {/* Right side: Menubar, Toolbar, Content, Status Bar */}\n          <div className=\"flex-1 flex flex-col min-w-0 min-h-0\">\n            {/* Status Bar - TOP */}\n            <AppShellRegionOutlet region={ShellRegion.STATUS_BAR} placement={VerticalPlacement.TOP} />\n\n            {/* Menubar */}\n            <AppShellRegionOutlet region={ShellRegion.MENUBAR} />\n\n            {/* Toolbar */}\n            <AppShellRegionOutlet region={ShellRegion.TOOLBAR} />\n\n            {/* Main Content Area */}\n            <div className=\"flex-1 flex min-h-0\">\n              <AppShellContentOutlet className=\"flex-1 relative min-w-0\">{children}</AppShellContentOutlet>\n\n              {/* Sidebar - END (full height within content area) */}\n              <AppShellRegionOutlet region={ShellRegion.SIDEBAR} placement={HorizontalPlacement.END} />\n            </div>\n\n            {/* Status Bar - BOTTOM */}\n            <AppShellRegionOutlet region={ShellRegion.STATUS_BAR} placement={VerticalPlacement.BOTTOM} />\n          </div>\n\n          {/* Navigation Overlays (Dialog & Sheet) and guidance */}\n          <AppShellOverlaysOutlet />\n\n          {/* Utility Panel trigger - END */}\n          <AppShellRegionOutlet region={ShellRegion.UTILITY_PANEL} placement={HorizontalPlacement.END} />\n        </div>\n      </Surface>\n    </AppShellProviders>\n  );\n};\n"]}

package/dist/esm/components/app/app-layout-main-container.labels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-layout-main-container.labels.d.ts","sourceRoot":"","sources":["../../../../src/components/app/app-layout-main-container.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM1I,eAAO,MAAM,6BAA6B,EAAE,mBAAmB,EAS9D,CAAC"}
+{"version":3,"file":"app-layout-main-container.labels.d.ts","sourceRoot":"","sources":["../../../../../src/components/app/app-layout-main-container.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM1I,eAAO,MAAM,6BAA6B,EAAE,mBAAmB,EAgE9D,CAAC"}

package/dist/esm/components/app/app-layout-main-container.labels.js

@@ -10,6 +10,54 @@ export const AppLayoutsMainContainerLabels = [
             + 'empty via onEmpty: EMPTY_STATE — tells the reader the pane is waiting for a selection rather '
             + 'than broken. Not shown when the zone collapses instead.',
     },
+    {
+        ref: 'zoneExpand',
+        kind: LabelKind.BUTTON,
+        purpose: 'The control on an adjacent content zone (detail / companion pane) that gives that pane the '
+            + 'WHOLE content area, folding the list it opened from out of view. Short, imperative, one or '
+            + 'two words; it also names the control for screen readers.',
+    },
+    {
+        ref: 'zoneDismiss',
+        kind: LabelKind.BUTTON,
+        purpose: 'The control that CLOSES an adjacent content zone (detail / companion pane) outright, handing '
+            + 'its width back to the pane beside it. Offered only where the layout declares the zone '
+            + 'collapses when empty, because that is where closing it actually returns room. Short, '
+            + 'imperative, one or two words; it also names the control for screen readers.',
+    },
+    {
+        ref: 'zoneRestore',
+        kind: LabelKind.BUTTON,
+        purpose: 'The inverse of zoneExpand, shown while a pane has the whole content area: hands the room back '
+            + 'to the split so the list appears beside the pane again. Escape does the same.',
+    },
+    {
+        ref: 'zoneRegionPrimary',
+        kind: LabelKind.ARIA,
+        purpose: 'Names the MAIN content column for screen readers, so a reader moving by landmark can tell it '
+            + 'from the detail and companion panes beside it. Never read aloud on screen; two or three '
+            + 'words naming what the column holds, in the reader\'s terms rather than the framework\'s.',
+    },
+    {
+        ref: 'zoneRegionSecondary',
+        kind: LabelKind.ARIA,
+        purpose: 'Names the adjacent DETAIL pane — the one a record opens into beside the list — for screen '
+            + 'readers. Distinct from zoneRegionCompanion: a reader jumping between landmarks hears only '
+            + 'these names, so two panes sharing one name is the same as neither being named.',
+    },
+    {
+        ref: 'zoneRegionCompanion',
+        kind: LabelKind.ARIA,
+        purpose: 'Names the third COMPANION pane (assistant, context, activity) for screen readers. See '
+            + 'zoneRegionSecondary — the two must not be interchangeable.',
+    },
+    {
+        ref: 'zoneResizeHandle',
+        kind: LabelKind.ARIA,
+        purpose: 'Names the draggable divider between two content panes, which is also operable with the arrow '
+            + 'keys once focused. A reader hears this instead of an unnamed "separator", so it should say '
+            + 'what dragging it does (resize the panes), not what it looks like.',
+    },
 ];
 registerComponentLabels(FrontendComponentType.APP_LAYOUTS_MAIN_CONTAINER, AppLayoutsMainContainerLabels);
 //# sourceMappingURL=app-layout-main-container.labels.js.map

package/dist/esm/components/app/app-layout-main-container.labels.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-layout-main-container.labels.js","sourceRoot":"","sources":["../../../../../src/components/app/app-layout-main-container.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,6BAA6B,GAA0B;IAClE;QACE,GAAG,EAAE,gBAAgB;QACrB,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,OAAO,EACL,gGAAgG;cAC9F,+FAA+F;cAC/F,yDAAyD;KAC9D;CACF,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,0BAA0B,EAAE,6BAA6B,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 AppLayoutsMainContainerLabels: LabellingUnitaryDef[] = [\n  {\n    ref: 'zoneEmptyState',\n    kind: LabelKind.EMPTY_STATE,\n    purpose:\n      'Shown in an adjacent content zone (detail / companion pane) that a layout keeps VISIBLE while '\n      + 'empty via onEmpty: EMPTY_STATE — tells the reader the pane is waiting for a selection rather '\n      + 'than broken. Not shown when the zone collapses instead.',\n  },\n];\nregisterComponentLabels(FrontendComponentType.APP_LAYOUTS_MAIN_CONTAINER, AppLayoutsMainContainerLabels);\n"]}
+{"version":3,"file":"app-layout-main-container.labels.js","sourceRoot":"","sources":["../../../../../src/components/app/app-layout-main-container.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,6BAA6B,GAA0B;IAClE;QACE,GAAG,EAAE,gBAAgB;QACrB,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,OAAO,EACL,gGAAgG;cAC9F,+FAA+F;cAC/F,yDAAyD;KAC9D;IACD;QACE,GAAG,EAAE,YAAY;QACjB,IAAI,EAAE,SAAS,CAAC,MAAM;QACtB,OAAO,EACL,6FAA6F;cAC3F,6FAA6F;cAC7F,0DAA0D;KAC/D;IACD;QACE,GAAG,EAAE,aAAa;QAClB,IAAI,EAAE,SAAS,CAAC,MAAM;QACtB,OAAO,EACL,+FAA+F;cAC7F,wFAAwF;cACxF,uFAAuF;cACvF,6EAA6E;KAClF;IACD;QACE,GAAG,EAAE,aAAa;QAClB,IAAI,EAAE,SAAS,CAAC,MAAM;QACtB,OAAO,EACL,gGAAgG;cAC9F,+EAA+E;KACpF;IACD;QACE,GAAG,EAAE,mBAAmB;QACxB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,OAAO,EACL,+FAA+F;cAC7F,0FAA0F;cAC1F,0FAA0F;KAC/F;IACD;QACE,GAAG,EAAE,qBAAqB;QAC1B,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,OAAO,EACL,4FAA4F;cAC1F,4FAA4F;cAC5F,gFAAgF;KACrF;IACD;QACE,GAAG,EAAE,qBAAqB;QAC1B,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,OAAO,EACL,wFAAwF;cACtF,4DAA4D;KACjE;IACD;QACE,GAAG,EAAE,kBAAkB;QACvB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,OAAO,EACL,+FAA+F;cAC7F,6FAA6F;cAC7F,mEAAmE;KACxE;CACF,CAAC;AACF,uBAAuB,CAAC,qBAAqB,CAAC,0BAA0B,EAAE,6BAA6B,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 AppLayoutsMainContainerLabels: LabellingUnitaryDef[] = [\n  {\n    ref: 'zoneEmptyState',\n    kind: LabelKind.EMPTY_STATE,\n    purpose:\n      'Shown in an adjacent content zone (detail / companion pane) that a layout keeps VISIBLE while '\n      + 'empty via onEmpty: EMPTY_STATE — tells the reader the pane is waiting for a selection rather '\n      + 'than broken. Not shown when the zone collapses instead.',\n  },\n  {\n    ref: 'zoneExpand',\n    kind: LabelKind.BUTTON,\n    purpose:\n      'The control on an adjacent content zone (detail / companion pane) that gives that pane the '\n      + 'WHOLE content area, folding the list it opened from out of view. Short, imperative, one or '\n      + 'two words; it also names the control for screen readers.',\n  },\n  {\n    ref: 'zoneDismiss',\n    kind: LabelKind.BUTTON,\n    purpose:\n      'The control that CLOSES an adjacent content zone (detail / companion pane) outright, handing '\n      + 'its width back to the pane beside it. Offered only where the layout declares the zone '\n      + 'collapses when empty, because that is where closing it actually returns room. Short, '\n      + 'imperative, one or two words; it also names the control for screen readers.',\n  },\n  {\n    ref: 'zoneRestore',\n    kind: LabelKind.BUTTON,\n    purpose:\n      'The inverse of zoneExpand, shown while a pane has the whole content area: hands the room back '\n      + 'to the split so the list appears beside the pane again. Escape does the same.',\n  },\n  {\n    ref: 'zoneRegionPrimary',\n    kind: LabelKind.ARIA,\n    purpose:\n      'Names the MAIN content column for screen readers, so a reader moving by landmark can tell it '\n      + 'from the detail and companion panes beside it. Never read aloud on screen; two or three '\n      + 'words naming what the column holds, in the reader\\'s terms rather than the framework\\'s.',\n  },\n  {\n    ref: 'zoneRegionSecondary',\n    kind: LabelKind.ARIA,\n    purpose:\n      'Names the adjacent DETAIL pane — the one a record opens into beside the list — for screen '\n      + 'readers. Distinct from zoneRegionCompanion: a reader jumping between landmarks hears only '\n      + 'these names, so two panes sharing one name is the same as neither being named.',\n  },\n  {\n    ref: 'zoneRegionCompanion',\n    kind: LabelKind.ARIA,\n    purpose:\n      'Names the third COMPANION pane (assistant, context, activity) for screen readers. See '\n      + 'zoneRegionSecondary — the two must not be interchangeable.',\n  },\n  {\n    ref: 'zoneResizeHandle',\n    kind: LabelKind.ARIA,\n    purpose:\n      'Names the draggable divider between two content panes, which is also operable with the arrow '\n      + 'keys once focused. A reader hears this instead of an unnamed \"separator\", so it should say '\n      + 'what dragging it does (resize the panes), not what it looks like.',\n  },\n];\nregisterComponentLabels(FrontendComponentType.APP_LAYOUTS_MAIN_CONTAINER, AppLayoutsMainContainerLabels);\n"]}

package/dist/esm/components/app/public-layout-main-container.d.ts

@@ -1,4 +1,4 @@
 import React from 'react';
 import { PublicLayoutPreset_MainContainer_DefaultProps } from '@wildo-ai/saas-frontend-lib';
-export declare const PublicLayoutPreset_MainContainer_Default: ({ children, useCardLayout, className }: PublicLayoutPreset_MainContainer_DefaultProps) => React.JSX.Element;
+export declare const PublicLayoutPreset_MainContainer_Default: ({ children, useCardLayout, organizationBranding, className }: PublicLayoutPreset_MainContainer_DefaultProps) => React.JSX.Element;
 //# sourceMappingURL=public-layout-main-container.d.ts.map

package/dist/esm/components/app/public-layout-main-container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public-layout-main-container.d.ts","sourceRoot":"","sources":["../../../../src/components/app/public-layout-main-container.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EACL,6CAA6C,EAU9C,MAAM,6BAA6B,CAAC;AAuErC,eAAO,MAAM,wCAAwC,GAAI,wCAItD,6CAA6C,KAAG,KAAK,CAAC,GAAG,CAAC,OAmE5D,CAAC"}
+{"version":3,"file":"public-layout-main-container.d.ts","sourceRoot":"","sources":["../../../../../src/components/app/public-layout-main-container.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EACL,6CAA6C,EAU9C,MAAM,6BAA6B,CAAC;AAyErC,eAAO,MAAM,wCAAwC,GAAI,8DAKtD,6CAA6C,KAAG,KAAK,CAAC,GAAG,CAAC,OAuG5D,CAAC"}

package/dist/esm/components/app/public-layout-main-container.js

@@ -18,8 +18,9 @@ import { SurfaceVariant, TypographyVariant, UIBehavior } from "@wildo-ai/presets
  * where it is most visible: a cold load on a slow link, which is the first impression the page
  * exists to make. The `h-14` box is fixed and `w-auto` lets a wide lockup keep its aspect ratio
  * inside it — sized against the name beneath rather than picked in the abstract, so mark and name
- * read as one unit (hence the tighter `gap-element-sm` between them, and the wider `mb-group` below
- * the pair).
+ * read as one unit (hence the tighter `gap-element-sm` between them). Below the pair sits a
+ * SECTION gap, not a group gap: the identity and the form's own heading are two different things
+ * ("this is <product>" / "sign in"), and at `mb-group` the heading read as a caption of the logo.
  *
  * ## Why the name is styled from the recipe and is NOT a heading
  *
@@ -34,13 +35,13 @@ import { SurfaceVariant, TypographyVariant, UIBehavior } from "@wildo-ai/presets
  * this same card. A second one would give the document two competing top-level headings; the recipe
  * supplies the LOOK while the outline stays owned by the content.
  */
-const PublicShellBrandHeader = ({ identity }) => {
+const PublicShellBrandHeader = ({ identity, accentColor }) => {
     const { name, logoUrl, hasMark, markCarriesName, isEmpty, onMarkError } = useBrandPresentation(identity);
     const { getRecipe } = useUI();
     const headingRecipe = getRecipe(UIBehavior.TYPOGRAPHY, TypographyVariant.HEADING);
     if (isEmpty)
         return null;
-    return (_jsxs("div", { className: "flex flex-col items-center gap-element-sm mb-group", children: [hasMark && (_jsx("div", { className: "flex h-14 items-center justify-center", children: _jsx("img", { src: logoUrl, 
+    return (_jsxs("div", { className: "flex flex-col items-center gap-element-sm mb-section-lg", children: [accentColor && _jsx("span", { "aria-hidden": "true", className: "h-1 w-12 rounded-full", style: { backgroundColor: accentColor } }), hasMark && (_jsx("div", { className: "flex h-14 items-center justify-center", children: _jsx("img", { src: logoUrl, 
                     /*
                      * A mark that CARRIES the name is the only thing announcing it, so it is the accessible
                      * name. A symbol sits beside the name text below and is decorative — announcing it too
@@ -48,11 +49,11 @@ const PublicShellBrandHeader = ({ identity }) => {
                      */
                     alt: markCarriesName ? name : '', "aria-hidden": markCarriesName ? undefined : 'true', onError: onMarkError, className: "max-h-14 w-auto object-contain" }) })), !markCarriesName && name !== '' && (_jsx("p", { className: cn(headingRecipe.base, headingRecipe.sizes?.h1 ?? 'text-3xl', 'text-center text-foreground'), children: name }))] }));
 };
-export const PublicLayoutPreset_MainContainer_Default = ({ children = null, useCardLayout = false, className = "" }) => {
-    const { brandHeader } = usePublicShellLayout(useCardLayout);
+export const PublicLayoutPreset_MainContainer_Default = ({ children = null, useCardLayout = false, organizationBranding, className = "" }) => {
+    const { brandHeader, brandAccentColor } = usePublicShellLayout(useCardLayout, organizationBranding);
     if (useCardLayout) {
-        return (_jsx(Surface, { asChild: true, emitPolicyVars: false, variant: SurfaceVariant.SHELL, policyOverride: NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE, children: _jsx("div", { className: "h-screen w-screen overflow-auto", children: _jsx("main", { className: "min-h-full flex items-center justify-center p-container", children: _jsx(Card, { className: cn('w-full max-w-md', className), policyOverride: { a11y: { landmarkRole: 'none' } }, children: _jsxs(CardContent, { className: "p-container-xl", children: [brandHeader && _jsx(PublicShellBrandHeader, { identity: brandHeader }), children] }) }) }) }) }));
+        return (_jsx(Surface, { asChild: true, emitPolicyVars: false, variant: SurfaceVariant.SHELL, policyOverride: NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE, children: _jsx("div", { className: "h-screen w-screen overflow-auto", children: _jsx("main", { className: "isolate min-h-full flex items-center justify-center p-container", children: _jsx(Card, { className: cn('w-full max-w-md', className), policyOverride: { a11y: { landmarkRole: 'none' } }, children: _jsxs(CardContent, { className: "p-container-xl", children: [brandHeader && _jsx(PublicShellBrandHeader, { identity: brandHeader, accentColor: brandAccentColor }), children] }) }) }) }) }));
     }
-    return (_jsx(Surface, { asChild: true, emitPolicyVars: false, variant: SurfaceVariant.SHELL, policyOverride: NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE, children: _jsx("div", { className: cn('h-screen w-screen overflow-auto', className), children: _jsx("main", { className: "min-h-full py-section", children: _jsx("div", { className: "max-w-7xl mx-auto px-card sm:px-container lg:px-container-lg", children: children }) }) }) }));
+    return (_jsx(Surface, { asChild: true, emitPolicyVars: false, variant: SurfaceVariant.SHELL, policyOverride: NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE, children: _jsx("div", { tabIndex: 0, className: cn('h-screen w-screen overflow-auto focus-ring-inset', className), children: _jsx("main", { className: "isolate min-h-full py-section", children: _jsx("div", { className: "max-w-7xl mx-auto px-card sm:px-container lg:px-container-lg", children: children }) }) }) }));
 };
 //# sourceMappingURL=public-layout-main-container.js.map

package/dist/esm/components/app/public-layout-main-container.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-layout-main-container.js","sourceRoot":"","sources":["../../../../src/components/app/public-layout-main-container.tsx"],"names":[],"mappings":";AAEA,OAAO,EAEL,IAAI,EACJ,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,EACL,EAAE,EACF,2CAA2C,EAC3C,OAAO,GAER,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAyB,cAAc,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAA;AAE1H;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,sBAAsB,GAAG,CAAC,EAAE,QAAQ,EAA+B,EAA4B,EAAE;IACrG,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACzG,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,CAAC;IAC9B,MAAM,aAAa,GAAG,SAAS,CAAC,UAAU,CAAC,UAAU,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAElF,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC;IAEzB,OAAO,CACL,eAAK,SAAS,EAAC,oDAAoD,aAChE,OAAO,IAAI,CACV,cAAK,SAAS,EAAC,uCAAuC,YACpD,cACE,GAAG,EAAE,OAAO;oBACZ;;;;uBAIG;oBACH,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,iBACnB,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EACjD,OAAO,EAAE,WAAW,EACpB,SAAS,EAAC,gCAAgC,GAC1C,GACE,CACP,EACA,CAAC,eAAe,IAAI,IAAI,KAAK,EAAE,IAAI,CAClC,YAAG,SAAS,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,KAAK,EAAE,EAAE,IAAI,UAAU,EAAE,6BAA6B,CAAC,YACvG,IAAI,GACH,CACL,IACG,CACP,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAAC,EACvD,QAAQ,GAAG,IAAI,EACf,aAAa,GAAG,KAAK,EACrB,SAAS,GAAG,EAAE,EACgC,EAAqB,EAAE;IAErE,MAAM,EAAE,WAAW,EAAE,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAE5D,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,CACL,KAAC,OAAO,IAAC,OAAO,QAAC,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,2CAA2C,YAChI,cAAK,SAAS,EAAC,iCAAiC,YAgB9C,eAAM,SAAS,EAAC,yDAAyD,YASvE,KAAC,IAAI,IACH,SAAS,EAAE,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC,EAC3C,cAAc,EAAE,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,YAElD,MAAC,WAAW,IAAC,SAAS,EAAC,gBAAgB,aAUpC,WAAW,IAAI,KAAC,sBAAsB,IAAC,QAAQ,EAAE,WAAW,GAAI,EAChE,QAAQ,IACG,GACT,GACF,GACH,GACE,CACX,CAAC;IACJ,CAAC;IAED,OAAO,CACL,KAAC,OAAO,IAAC,OAAO,QAAC,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,2CAA2C,YAChI,cAAK,SAAS,EAAE,EAAE,CAAC,iCAAiC,EAAE,SAAS,CAAC,YAC9D,eAAM,SAAS,EAAC,uBAAuB,YACrC,cAAK,SAAS,EAAC,8DAA8D,YAC1E,QAAQ,GACL,GACD,GACH,GACE,CACX,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import React from 'react';\n\nimport {\n  PublicLayoutPreset_MainContainer_DefaultProps,\n  Card,\n  CardContent,\n  usePublicShellLayout,\n  useBrandPresentation,\n  useUI,\n  cn,\n  NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE,\n  Surface,\n  type BrandIdentity,\n} from '@wildo-ai/saas-frontend-lib';\n\nimport { FrontendComponentType, SurfaceVariant, TypographyVariant, UIBehavior } from \"@wildo-ai/presets-components-models\"\n\n/**\n * The surface's identity, at the top of the public card.\n *\n * Rendered ONLY when the application opted in (`publicShellIdentityMode`) — `usePublicShellLayout`\n * gates that, so reaching this component at all is the permission. What it draws is decided from the\n * DATA, and each branch is a defect that would otherwise ship silently:\n *\n * - a WORDMARK/LOCKUP already contains the name, so the name label is dropped rather than printed\n *   twice — the brand resolver returns one for an application that generated no symbol;\n * - a mark whose URL 404s degrades to the name alone instead of a browser broken-image glyph;\n * - an identity with neither mark nor name renders nothing, not an empty gap above the card.\n *\n * The height is RESERVED rather than left to the image. A login card that jumps downward when a logo\n * finishes loading is the \"glitch\" this feature is most likely to introduce, and it is worst exactly\n * where it is most visible: a cold load on a slow link, which is the first impression the page\n * exists to make. The `h-14` box is fixed and `w-auto` lets a wide lockup keep its aspect ratio\n * inside it — sized against the name beneath rather than picked in the abstract, so mark and name\n * read as one unit (hence the tighter `gap-element-sm` between them, and the wider `mb-group` below\n * the pair).\n *\n * ## Why the name is styled from the recipe and is NOT a heading\n *\n * The type comes from the design system's `TYPOGRAPHY.HEADING` recipe rather than from classes\n * chosen here, so an application that restyles its headings restyles this too — the same thing\n * `CardTitle` does, and the reason it is worth a hook call for one line of text. `h1` SIZE — the top\n * of the design system's ordinary ladder — because the identity is what the card is opening with; at\n * `h2` it rendered visibly smaller than the action heading beneath it and read as a caption on the\n * logo rather than as the product's name. Measured on a screenshot, not reasoned about.\n *\n * It renders as a `<p>`, not a heading, because `Auth_Main` already emits the page's `<h1>` inside\n * this same card. A second one would give the document two competing top-level headings; the recipe\n * supplies the LOOK while the outline stays owned by the content.\n */\nconst PublicShellBrandHeader = ({ identity }: { identity: BrandIdentity }): React.JSX.Element | null => {\n  const { name, logoUrl, hasMark, markCarriesName, isEmpty, onMarkError } = useBrandPresentation(identity);\n  const { getRecipe } = useUI();\n  const headingRecipe = getRecipe(UIBehavior.TYPOGRAPHY, TypographyVariant.HEADING);\n\n  if (isEmpty) return null;\n\n  return (\n    <div className=\"flex flex-col items-center gap-element-sm mb-group\">\n      {hasMark && (\n        <div className=\"flex h-14 items-center justify-center\">\n          <img\n            src={logoUrl}\n            /*\n             * A mark that CARRIES the name is the only thing announcing it, so it is the accessible\n             * name. A symbol sits beside the name text below and is decorative — announcing it too\n             * would read the product name twice to a screen reader.\n             */\n            alt={markCarriesName ? name : ''}\n            aria-hidden={markCarriesName ? undefined : 'true'}\n            onError={onMarkError}\n            className=\"max-h-14 w-auto object-contain\"\n          />\n        </div>\n      )}\n      {!markCarriesName && name !== '' && (\n        <p className={cn(headingRecipe.base, headingRecipe.sizes?.h1 ?? 'text-3xl', 'text-center text-foreground')}>\n          {name}\n        </p>\n      )}\n    </div>\n  );\n};\n\nexport const PublicLayoutPreset_MainContainer_Default = ({\n  children = null,\n  useCardLayout = false,\n  className = \"\"\n}: PublicLayoutPreset_MainContainer_DefaultProps): React.JSX.Element => {\n\n  const { brandHeader } = usePublicShellLayout(useCardLayout);\n\n  if (useCardLayout) {\n    return (\n      <Surface asChild emitPolicyVars={false} variant={SurfaceVariant.SHELL} policyOverride={NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE}>\n        <div className=\"h-screen w-screen overflow-auto\">\n          {/*\n            A `<main>`, exactly like the wide branch below — the two branches are the same page at\n            different widths, and only one of them had a landmark.\n\n            The card branch is every public AUTH surface (sign-in, register, invitation, password\n            reset, MFA challenge), so its content sat in no landmark at all: axe reported\n            `landmark-one-main` plus three `region` violations on `/login` in the first accessibility\n            audit ever run against this product (#533). A screen-reader user had no \"skip to main\"\n            target and no way to jump to the form.\n\n            It goes HERE, on the centring wrapper, rather than on the card: `Card` deliberately opts\n            out of a landmark (`landmarkRole: 'none'` below) because it is presentational chrome, and\n            the shell `<div>` above owns scrolling. This element is the one that actually bounds the\n            page's content.\n          */}\n          <main className=\"min-h-full flex items-center justify-center p-container\">\n            {/*\n              `landmarkRole: 'none'` opts this card out of the BASE variant's\n              default `region` landmark. The card here is presentational\n              chrome wrapping the public-auth panel — it doesn't represent a\n              distinct semantic region on the page. Without the override the\n              card would emit `role=\"region\"` without a label (no header,\n              no aria-label) and the framework would warn on every render.\n            */}\n            <Card\n              className={cn('w-full max-w-md', className)}\n              policyOverride={{ a11y: { landmarkRole: 'none' } }}\n            >\n              <CardContent className=\"p-container-xl\">\n                {/*\n                  The identity sits INSIDE the card, above the form's own heading — so the box reads\n                  as one object (\"this is <product>, sign in\") rather than as a card with a caption\n                  floating over it.\n\n                  Only the CARD branch carries it. The other branch is the wide static-content layout\n                  (terms, legal pages), which is reached with the application's chrome around it and\n                  does not ask \"sign in to what\".\n                */}\n                {brandHeader && <PublicShellBrandHeader identity={brandHeader} />}\n                {children}\n              </CardContent>\n            </Card>\n          </main>\n        </div>\n      </Surface>\n    );\n  }\n\n  return (\n    <Surface asChild emitPolicyVars={false} variant={SurfaceVariant.SHELL} policyOverride={NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE}>\n      <div className={cn('h-screen w-screen overflow-auto', className)}>\n        <main className=\"min-h-full py-section\">\n          <div className=\"max-w-7xl mx-auto px-card sm:px-container lg:px-container-lg\">\n            {children}\n          </div>\n        </main>\n      </div>\n    </Surface>\n  );\n};\n"]}
+{"version":3,"file":"public-layout-main-container.js","sourceRoot":"","sources":["../../../../../src/components/app/public-layout-main-container.tsx"],"names":[],"mappings":"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","sourcesContent":["import React from 'react';\n\nimport {\n  PublicLayoutPreset_MainContainer_DefaultProps,\n  Card,\n  CardContent,\n  usePublicShellLayout,\n  useBrandPresentation,\n  useUI,\n  cn,\n  NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE,\n  Surface,\n  type BrandIdentity,\n} from '@wildo-ai/saas-frontend-lib';\n\nimport { FrontendComponentType, SurfaceVariant, TypographyVariant, UIBehavior } from \"@wildo-ai/presets-components-models\"\n\n/**\n * The surface's identity, at the top of the public card.\n *\n * Rendered ONLY when the application opted in (`publicShellIdentityMode`) — `usePublicShellLayout`\n * gates that, so reaching this component at all is the permission. What it draws is decided from the\n * DATA, and each branch is a defect that would otherwise ship silently:\n *\n * - a WORDMARK/LOCKUP already contains the name, so the name label is dropped rather than printed\n *   twice — the brand resolver returns one for an application that generated no symbol;\n * - a mark whose URL 404s degrades to the name alone instead of a browser broken-image glyph;\n * - an identity with neither mark nor name renders nothing, not an empty gap above the card.\n *\n * The height is RESERVED rather than left to the image. A login card that jumps downward when a logo\n * finishes loading is the \"glitch\" this feature is most likely to introduce, and it is worst exactly\n * where it is most visible: a cold load on a slow link, which is the first impression the page\n * exists to make. The `h-14` box is fixed and `w-auto` lets a wide lockup keep its aspect ratio\n * inside it — sized against the name beneath rather than picked in the abstract, so mark and name\n * read as one unit (hence the tighter `gap-element-sm` between them). Below the pair sits a\n * SECTION gap, not a group gap: the identity and the form's own heading are two different things\n * (\"this is <product>\" / \"sign in\"), and at `mb-group` the heading read as a caption of the logo.\n *\n * ## Why the name is styled from the recipe and is NOT a heading\n *\n * The type comes from the design system's `TYPOGRAPHY.HEADING` recipe rather than from classes\n * chosen here, so an application that restyles its headings restyles this too — the same thing\n * `CardTitle` does, and the reason it is worth a hook call for one line of text. `h1` SIZE — the top\n * of the design system's ordinary ladder — because the identity is what the card is opening with; at\n * `h2` it rendered visibly smaller than the action heading beneath it and read as a caption on the\n * logo rather than as the product's name. Measured on a screenshot, not reasoned about.\n *\n * It renders as a `<p>`, not a heading, because `Auth_Main` already emits the page's `<h1>` inside\n * this same card. A second one would give the document two competing top-level headings; the recipe\n * supplies the LOOK while the outline stays owned by the content.\n */\nconst PublicShellBrandHeader = ({ identity, accentColor }: { identity: BrandIdentity; accentColor?: string }): React.JSX.Element | null => {\n  const { name, logoUrl, hasMark, markCarriesName, isEmpty, onMarkError } = useBrandPresentation(identity);\n  const { getRecipe } = useUI();\n  const headingRecipe = getRecipe(UIBehavior.TYPOGRAPHY, TypographyVariant.HEADING);\n\n  if (isEmpty) return null;\n\n  return (\n    <div className=\"flex flex-col items-center gap-element-sm mb-section-lg\">\n      {accentColor && <span aria-hidden=\"true\" className=\"h-1 w-12 rounded-full\" style={{ backgroundColor: accentColor }} />}\n      {hasMark && (\n        <div className=\"flex h-14 items-center justify-center\">\n          <img\n            src={logoUrl}\n            /*\n             * A mark that CARRIES the name is the only thing announcing it, so it is the accessible\n             * name. A symbol sits beside the name text below and is decorative — announcing it too\n             * would read the product name twice to a screen reader.\n             */\n            alt={markCarriesName ? name : ''}\n            aria-hidden={markCarriesName ? undefined : 'true'}\n            onError={onMarkError}\n            className=\"max-h-14 w-auto object-contain\"\n          />\n        </div>\n      )}\n      {!markCarriesName && name !== '' && (\n        <p className={cn(headingRecipe.base, headingRecipe.sizes?.h1 ?? 'text-3xl', 'text-center text-foreground')}>\n          {name}\n        </p>\n      )}\n    </div>\n  );\n};\n\nexport const PublicLayoutPreset_MainContainer_Default = ({\n  children = null,\n  useCardLayout = false,\n  organizationBranding,\n  className = \"\"\n}: PublicLayoutPreset_MainContainer_DefaultProps): React.JSX.Element => {\n\n  const { brandHeader, brandAccentColor } = usePublicShellLayout(useCardLayout, organizationBranding);\n\n  if (useCardLayout) {\n    return (\n      <Surface asChild emitPolicyVars={false} variant={SurfaceVariant.SHELL} policyOverride={NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE}>\n        <div className=\"h-screen w-screen overflow-auto\">\n          {/*\n            A `<main>`, exactly like the wide branch below — the two branches are the same page at\n            different widths, and only one of them had a landmark.\n\n            The card branch is every public AUTH surface (sign-in, register, invitation, password\n            reset, MFA challenge), so its content sat in no landmark at all: axe reported\n            `landmark-one-main` plus three `region` violations on `/login` in the first accessibility\n            audit ever run against this product (#533). A screen-reader user had no \"skip to main\"\n            target and no way to jump to the form.\n\n            It goes HERE, on the centring wrapper, rather than on the card: `Card` deliberately opts\n            out of a landmark (`landmarkRole: 'none'` below) because it is presentational chrome, and\n            the shell `<div>` above owns scrolling. This element is the one that actually bounds the\n            page's content.\n          */}\n          {/* `isolate` for the same reason as the wide branch below — stated rather than left to\n              `Card`'s incidental `z-index: 0`, which is what happened to keep this branch visible. */}\n          <main className=\"isolate min-h-full flex items-center justify-center p-container\">\n            {/*\n              `landmarkRole: 'none'` opts this card out of the BASE variant's\n              default `region` landmark. The card here is presentational\n              chrome wrapping the public-auth panel — it doesn't represent a\n              distinct semantic region on the page. Without the override the\n              card would emit `role=\"region\"` without a label (no header,\n              no aria-label) and the framework would warn on every render.\n            */}\n            <Card\n              className={cn('w-full max-w-md', className)}\n              policyOverride={{ a11y: { landmarkRole: 'none' } }}\n            >\n              <CardContent className=\"p-container-xl\">\n                {/*\n                  The identity sits INSIDE the card, above the form's own heading — so the box reads\n                  as one object (\"this is <product>, sign in\") rather than as a card with a caption\n                  floating over it.\n\n                  Only the CARD branch carries it. The other branch is the wide static-content layout\n                  (terms, legal pages), which is reached with the application's chrome around it and\n                  does not ask \"sign in to what\".\n                */}\n                {brandHeader && <PublicShellBrandHeader identity={brandHeader} accentColor={brandAccentColor} />}\n                {children}\n              </CardContent>\n            </Card>\n          </main>\n        </div>\n      </Surface>\n    );\n  }\n\n  return (\n    <Surface asChild emitPolicyVars={false} variant={SurfaceVariant.SHELL} policyOverride={NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE}>\n      {/*\n        FOCUSABLE, because this element is the only thing that scrolls. The product sets\n        `html, body { overflow: hidden }`, so the page never scrolls — each shell owns it — and a\n        scroll container can only be scrolled from the keyboard while focus is inside it.\n\n        The card branch above needs none of this: every surface it serves has form fields. This\n        branch serves the static public pages, and `/terms` is pure prose with nothing focusable in\n        it at all — so a keyboard user could not read past the first screen of the terms they were\n        being asked to accept. The first accessibility run against it reported exactly that\n        (`scrollable-region-focusable`, #1385). `/privacy` passed only because it happens to\n        contain a link, which is luck rather than design.\n\n        `focus-ring-inset` rather than offset: an offset ring on a viewport-sized box is drawn\n        outside the viewport and nobody sees it.\n      */}\n      <div tabIndex={0} className={cn('h-screen w-screen overflow-auto focus-ring-inset', className)}>\n          {/*\n            `isolate` is load-bearing: it is what makes this page's content VISIBLE.\n\n            A theme's decorative background layer is rendered by `UIContext` inside an `isolate`\n            wrapper, and `isolation: isolate` on a NON-POSITIONED element promotes that wrapper to\n            the z-index:0 painting level (CSS 2.1 painting order step 8) rather than leaving it with\n            in-flow block backgrounds and inline content at steps 3-5. So the layer paints ABOVE all\n            ordinary content, and being an earlier DOM sibling does not lower it — DOM order only\n            orders peers within the SAME painting level.\n\n            Content therefore has to reach that level too. The card branch got there by accident:\n            `Card` is a flex item carrying `z-index: 0`, so it paints at the same level and, being\n            later in DOM order, lands above the layer. This branch is plain prose with no z-index,\n            so its whole document painted underneath the layer and the page rendered as an empty\n            gradient — 13,453 characters of privacy notice in the DOM and nothing on screen (#1204).\n\n            Isolating the CONTENT rather than the shell is deliberate: the shell's own fill stays\n            below the layer, so the decorative ground is unchanged and only the content rises.\n          */}\n        <main className=\"isolate min-h-full py-section\">\n          <div className=\"max-w-7xl mx-auto px-card sm:px-container lg:px-container-lg\">\n            {children}\n          </div>\n        </main>\n      </div>\n    </Surface>\n  );\n};\n"]}

package/dist/esm/components/app/public-layout-main-container.labels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public-layout-main-container.labels.d.ts","sourceRoot":"","sources":["../../../../src/components/app/public-layout-main-container.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM/H,eAAO,MAAM,gCAAgC,EAAE,mBAAmB,EAAO,CAAC"}
+{"version":3,"file":"public-layout-main-container.labels.d.ts","sourceRoot":"","sources":["../../../../../src/components/app/public-layout-main-container.labels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,mBAAmB,EAA2B,MAAM,qCAAqC,CAAC;AAM/H,eAAO,MAAM,gCAAgC,EAAE,mBAAmB,EAAO,CAAC"}

package/dist/esm/components/app/public-layout-terms.d.ts

@@ -0,0 +1,46 @@
+import React from 'react';
+import { type PublicLayoutPreset_Terms_DefaultProps } from '@wildo-ai/saas-frontend-lib';
+/**
+ * The public governed-document page. Issue #168, and #968 for what it serves.
+ *
+ * Reads the application's own `compliance.publicDocuments` — each entry a composed release with the
+ * text it carries, or the latest draft of a document the application has never released. The page
+ * is a RENDERING of that specification, never a second description of it, which is why it takes no
+ * title, no body and no effective date as props: every one of them would be a place the page could
+ * disagree with the document.
+ *
+ * ## Four states
+ *
+ * **Not settled** — labels are still resolving. A loading line, because rendering a legal document
+ * with unresolved labels around it is worse than rendering nothing for a moment.
+ *
+ * **Nothing to show** — no release for this ref is in force (or none is approved, when the gate is
+ * armed), and no draft may stand in. The page says so and shows NO content. There is deliberately no
+ * partial render: a legal statement half-shown is worse than one not shown, because a reader cannot
+ * tell which half is missing.
+ *
+ * **Released** — the document, its sections and clauses in their declared order, with the release
+ * version and effective date beneath the title. `bodyMarkdown` goes through `MarkdownContent`, which
+ * renders markdown as TEXT through the active theme's typography recipes; the schema's own note says
+ * public content "is never trusted as raw HTML", and this is where that holds.
+ *
+ * **Unreleased draft** — the same rendering, with a notice in place of the release metadata saying
+ * the reader is looking at a draft. There is no effective date to show because nothing took effect.
+ * It exists so that neither a missing approval nor a missing release leaves the page empty (#968).
+ *
+ * ## Unestablished clauses are MARKED, in either state
+ *
+ * A clause the drafter could not yet establish is rendered with a note beneath it saying so and what
+ * is missing. Omitting it would narrow the document; showing it bare would state as settled what the
+ * application itself wrote down as unsettled.
+ *
+ * ## What it does not decide
+ *
+ * Whether an UNAPPROVED release — or a draft — may be shown. That is the application's approval gate,
+ * `compliance.governedDocumentApprovalGate`, read through `requiresApprovedGovernedDocuments` — the same
+ * reading every acceptance surface uses, so the page cannot be armed without them (#1565). It used to
+ * be a prop the route passed, which is exactly how it could be armed here alone. See
+ * `.claude/rules/one-source-of-truth.md` D5 for why arming it belongs to Gate 3.
+ */
+export declare const PublicLayoutPreset_Terms_Default: ({ documentRef, }: PublicLayoutPreset_Terms_DefaultProps) => React.JSX.Element;
+//# sourceMappingURL=public-layout-terms.d.ts.map

package/dist/esm/components/app/public-layout-terms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-layout-terms.d.ts","sourceRoot":"","sources":["../../../../../src/components/app/public-layout-terms.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EASL,KAAK,qCAAqC,EAC3C,MAAM,6BAA6B,CAAC;AAiBrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,eAAO,MAAM,gCAAgC,GAAI,kBAE9C,qCAAqC,KAAG,KAAK,CAAC,GAAG,CAAC,OA6JpD,CAAC"}

package/dist/esm/components/app/public-layout-terms.js

@@ -0,0 +1,137 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { PublicLayout_MainContainer, cn, getManualCallsHttpClient, useAnonymousSession, useApplication, useI18n, useUI, useUserOrgs, } from '@wildo-ai/saas-frontend-lib';
+import { GovernedDocumentInteractionKind, GovernedDocumentPublicClauseStanding, GovernedDocumentPublicDocumentKind, requiresApprovedGovernedDocuments, resolveInForcePublicDocument, } from '@wildo-ai/saas-models';
+// The markdown renderer is THIS package's, so it is reached by its own path rather than through the
+// engine barrel — `presets-components` is where the theme-mapped renderer lives.
+import { MarkdownContent } from '../../components/data-display/markdown-content.js';
+import { FrontendComponentType, PublicLayoutsTermsLabel, TypographyVariant, UIBehavior } from '@wildo-ai/presets-components-models';
+const CT = FrontendComponentType.PUBLIC_LAYOUTS_TERMS;
+/**
+ * The public governed-document page. Issue #168, and #968 for what it serves.
+ *
+ * Reads the application's own `compliance.publicDocuments` — each entry a composed release with the
+ * text it carries, or the latest draft of a document the application has never released. The page
+ * is a RENDERING of that specification, never a second description of it, which is why it takes no
+ * title, no body and no effective date as props: every one of them would be a place the page could
+ * disagree with the document.
+ *
+ * ## Four states
+ *
+ * **Not settled** — labels are still resolving. A loading line, because rendering a legal document
+ * with unresolved labels around it is worse than rendering nothing for a moment.
+ *
+ * **Nothing to show** — no release for this ref is in force (or none is approved, when the gate is
+ * armed), and no draft may stand in. The page says so and shows NO content. There is deliberately no
+ * partial render: a legal statement half-shown is worse than one not shown, because a reader cannot
+ * tell which half is missing.
+ *
+ * **Released** — the document, its sections and clauses in their declared order, with the release
+ * version and effective date beneath the title. `bodyMarkdown` goes through `MarkdownContent`, which
+ * renders markdown as TEXT through the active theme's typography recipes; the schema's own note says
+ * public content "is never trusted as raw HTML", and this is where that holds.
+ *
+ * **Unreleased draft** — the same rendering, with a notice in place of the release metadata saying
+ * the reader is looking at a draft. There is no effective date to show because nothing took effect.
+ * It exists so that neither a missing approval nor a missing release leaves the page empty (#968).
+ *
+ * ## Unestablished clauses are MARKED, in either state
+ *
+ * A clause the drafter could not yet establish is rendered with a note beneath it saying so and what
+ * is missing. Omitting it would narrow the document; showing it bare would state as settled what the
+ * application itself wrote down as unsettled.
+ *
+ * ## What it does not decide
+ *
+ * Whether an UNAPPROVED release — or a draft — may be shown. That is the application's approval gate,
+ * `compliance.governedDocumentApprovalGate`, read through `requiresApprovedGovernedDocuments` — the same
+ * reading every acceptance surface uses, so the page cannot be armed without them (#1565). It used to
+ * be a prop the route passed, which is exactly how it could be armed here alone. See
+ * `.claude/rules/one-source-of-truth.md` D5 for why arming it belongs to Gate 3.
+ */
+export const PublicLayoutPreset_Terms_Default = ({ documentRef, }) => {
+    const { appConfig } = useApplication();
+    const { tComponent, isReady } = useI18n({ component: CT });
+    const { getRecipe } = useUI();
+    const { user, auth } = useUserOrgs();
+    const { initAnonymousSession } = useAnonymousSession();
+    const heading = getRecipe(UIBehavior.TYPOGRAPHY, TypographyVariant.HEADING);
+    const body = getRecipe(UIBehavior.TYPOGRAPHY, TypographyVariant.BODY);
+    /*
+     * Pinned at mount rather than re-evaluated per render. A release taking effect while somebody is
+     * READING would otherwise swap the document under them mid-paragraph — the reading equivalent of
+     * the registration form's own "what am I agreeing to" hazard.
+     */
+    const document = React.useMemo(() => resolveInForcePublicDocument(appConfig.compliance?.publicDocuments ?? [], documentRef, new Date().toISOString(), { requireApproved: requiresApprovedGovernedDocuments(appConfig.compliance) }), 
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- pinned at mount, deliberately; see above.
+    [appConfig.compliance?.publicDocuments, documentRef, appConfig.compliance?.governedDocumentApprovalGate]);
+    /*
+     * Record NOTICE_DELIVERED once, on MOUNT — never per render — for the exact release this page is
+     * showing (#1258 Step 5 / R11). Fire-and-forget: a delivery record failing to write must never
+     * affect the page the reader already sees.
+     *
+     * Two guards keep this from writing the "47 identical reads" the #51 lesson warns about
+     * (`recordGovernedDocumentAcceptances`'s own header cites it): the effect's own empty-ish deps
+     * fire it once per mount, and a `sessionStorage` flag skips a repeat visit to the same document +
+     * release within the same browser tab. Neither is a hard guarantee against every duplicate — the
+     * recorder's own JSDoc explains why a rare true duplicate is tolerated rather than built out with a
+     * second queryable resource.
+     *
+     * Reader identity: a signed-in person's own bearer-token route, or the anonymous-session door —
+     * whichever the person currently is. **Waits for `auth.isRestoringSession` to clear first**, and
+     * that wait is load-bearing, not cosmetic (review finding F1, #1258 Steps 4-5): a stored access
+     * token resolves ASYNCHRONOUSLY, over a real network round-trip
+     * (`AuthSessionContext`/`UserOrgsContext`) — an earlier draft of this comment claimed the resolve
+     * was synchronous and that "signed out" and "not yet known" were indistinguishable, and both
+     * halves were wrong. A signed-in person landing directly on `/terms` or `/privacy` on a fresh page
+     * load (an emailed link, the R7 re-acceptance redirect) would otherwise be read as signed-out for
+     * the one render this effect fires on, mint a throwaway anonymous session via
+     * `initAnonymousSession()`, and have their delivery permanently misattributed to it — nothing ever
+     * reconciles a stray session created this way back onto the account, unlike Step 1's carry, which
+     * only runs at registration/authentication. `AppLayout_AuthenticatedRoute.tsx` already gates on
+     * exactly this signal for exactly this reason; this effect now does the same.
+     */
+    React.useEffect(() => {
+        if (auth.isRestoringSession)
+            return;
+        if (document?.kind !== GovernedDocumentPublicDocumentKind.RELEASED)
+            return;
+        if (!document.release.allowedInteractionKinds.includes(GovernedDocumentInteractionKind.NOTICE_DELIVERED))
+            return;
+        const sessionKey = `wildo:notice-delivered:${documentRef}:${document.release.identity.releaseId}@${document.release.identity.releaseVersion}`;
+        try {
+            if (window.sessionStorage.getItem(sessionKey))
+                return;
+            window.sessionStorage.setItem(sessionKey, '1');
+        }
+        catch {
+            // Storage unavailable (private browsing, quota) — proceed and risk a duplicate row rather than
+            // never recording delivery at all.
+        }
+        const client = getManualCallsHttpClient();
+        if (user !== null) {
+            void client.recordGovernedDocumentNoticeDelivered(documentRef);
+        }
+        else {
+            // A first-ever visit has no anonymous session yet — `record_consent`'s own door needed the
+            // same thing before Step 1a existed. `initAnonymousSession` is a no-op returning the existing
+            // id when one is already ACTIVE, so this is safe to call unconditionally here.
+            initAnonymousSession();
+            void client.recordAnonymousGovernedDocumentNoticeDelivered(documentRef);
+        }
+        // `auth.isRestoringSession` is a real dependency, not a suppressed one: this effect must re-run
+        // the instant it clears, which is the whole point of the gate above. `user`/`initAnonymousSession`
+        // are read fresh inside the effect and are stable enough not to cause a spurious re-fire past the
+        // sessionStorage guard, which is what the suppression below still covers.
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- fires once per mount for this release; see above.
+    }, [document, documentRef, auth.isRestoringSession]);
+    if (!isReady) {
+        return (_jsx(PublicLayout_MainContainer, { children: _jsx("p", { className: cn(body.base, 'text-muted-foreground'), children: tComponent(CT, PublicLayoutsTermsLabel.LOADING) }) }));
+    }
+    if (!document) {
+        return (_jsx(PublicLayout_MainContainer, { children: _jsxs("div", { className: "mx-auto flex max-w-prose flex-col gap-element", children: [_jsx("h1", { className: cn(heading.base, heading.sizes?.h1 ?? 'text-3xl'), children: tComponent(CT, PublicLayoutsTermsLabel.UNAVAILABLE_TITLE) }), _jsx("p", { className: cn(body.base, 'text-muted-foreground'), children: tComponent(CT, PublicLayoutsTermsLabel.UNAVAILABLE_DESCRIPTION) })] }) }));
+    }
+    const { content } = document;
+    return (_jsx(PublicLayout_MainContainer, { children: _jsxs("article", { className: "mx-auto flex max-w-prose flex-col gap-section", lang: content.locale, children: [_jsxs("header", { className: "flex flex-col gap-element-sm", children: [_jsx("h1", { className: cn(heading.base, heading.sizes?.h1 ?? 'text-3xl'), children: content.title }), document.kind === GovernedDocumentPublicDocumentKind.RELEASED ? (_jsxs("dl", { className: cn(body.base, 'flex flex-wrap gap-field text-sm text-muted-foreground'), children: [_jsxs("div", { className: "flex gap-element-sm", children: [_jsx("dt", { children: tComponent(CT, PublicLayoutsTermsLabel.EFFECTIVE_AT) }), _jsx("dd", { children: _jsx("time", { dateTime: document.release.effectiveAt, children: new Date(document.release.effectiveAt).toLocaleDateString() }) })] }), _jsx("div", { className: "flex gap-element-sm", children: _jsx("dt", { children: tComponent(CT, PublicLayoutsTermsLabel.RELEASE_VERSION, { releaseVersion: document.release.identity.releaseVersion }) }) })] })) : (_jsx("p", { role: "note", className: cn(body.base, 'text-sm text-muted-foreground'), children: tComponent(CT, PublicLayoutsTermsLabel.UNRELEASED_DRAFT_NOTICE) }))] }), content.sections.map((section) => (_jsxs("section", { className: "flex flex-col gap-element", children: [_jsx("h2", { className: cn(heading.base, heading.sizes?.h2 ?? 'text-2xl'), children: section.title }), section.clauses.map((clause) => (_jsxs("div", { className: "flex flex-col gap-element-sm", children: [_jsx(MarkdownContent, { value: clause.bodyMarkdown }), clause.standing === GovernedDocumentPublicClauseStanding.NOT_YET_ESTABLISHED && (_jsxs("p", { role: "note", className: cn(body.base, 'text-sm text-muted-foreground'), children: [_jsx("span", { children: tComponent(CT, PublicLayoutsTermsLabel.CLAUSE_NOT_YET_ESTABLISHED) }), " ", _jsx("span", { children: clause.missingInformation })] }))] }, clause.clauseRef)))] }, section.sectionRef)))] }) }));
+};
+//# sourceMappingURL=public-layout-terms.js.map

package/dist/esm/components/app/public-layout-terms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-layout-terms.js","sourceRoot":"","sources":["../../../../../src/components/app/public-layout-terms.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EACL,0BAA0B,EAC1B,EAAE,EACF,wBAAwB,EACxB,mBAAmB,EACnB,cAAc,EACd,OAAO,EACP,KAAK,EACL,WAAW,GAEZ,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,+BAA+B,EAC/B,oCAAoC,EACpC,kCAAkC,EAClC,iCAAiC,EACjC,4BAA4B,GAE7B,MAAM,uBAAuB,CAAC;AAE/B,oGAAoG;AACpG,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,yDAAyD,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAEpI,MAAM,EAAE,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,EAC/C,WAAW,GAC2B,EAAqB,EAAE;IAC7D,MAAM,EAAE,SAAS,EAAE,GAAG,cAAc,EAAE,CAAC;IACvC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3D,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,CAAC;IAC9B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC;IACrC,MAAM,EAAE,oBAAoB,EAAE,GAAG,mBAAmB,EAAE,CAAC;IACvD,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,CAAC,UAAU,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,UAAU,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAEtE;;;;OAIG;IACH,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAC5B,GAAG,EAAE,CAAC,4BAA4B,CAChC,SAAS,CAAC,UAAU,EAAE,eAAe,IAAI,EAAE,EAC3C,WAAW,EACX,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EACxB,EAAE,eAAe,EAAE,iCAAiC,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAC7E;IACD,oGAAoG;IACpG,CAAC,SAAS,CAAC,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,CAAC,UAAU,EAAE,4BAA4B,CAAC,CACzG,CAAC;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,IAAI,CAAC,kBAAkB;YAAE,OAAO;QACpC,IAAI,QAAQ,EAAE,IAAI,KAAK,kCAAkC,CAAC,QAAQ;YAAE,OAAO;QAC3E,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,uBAAuB,CAAC,QAAQ,CAAC,+BAA+B,CAAC,gBAAgB,CAAC;YAAE,OAAO;QAEjH,MAAM,UAAU,GAAG,0BAA0B,WAAW,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC9I,IAAI,CAAC;YACH,IAAI,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC;gBAAE,OAAO;YACtD,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,+FAA+F;YAC/F,mCAAmC;QACrC,CAAC;QAED,MAAM,MAAM,GAAG,wBAAwB,EAAE,CAAC;QAC1C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,KAAK,MAAM,CAAC,qCAAqC,CAAC,WAAW,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,2FAA2F;YAC3F,8FAA8F;YAC9F,+EAA+E;YAC/E,oBAAoB,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,8CAA8C,CAAC,WAAW,CAAC,CAAC;QAC1E,CAAC;QACD,gGAAgG;QAChG,mGAAmG;QACnG,kGAAkG;QAClG,0EAA0E;QAC1E,4GAA4G;IAC9G,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAErD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CACL,KAAC,0BAA0B,cACzB,YAAG,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,uBAAuB,CAAC,YAAG,UAAU,CAAC,EAAE,EAAE,uBAAuB,CAAC,OAAO,CAAC,GAAK,GAChF,CAC9B,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CACL,KAAC,0BAA0B,cACzB,eAAK,SAAS,EAAC,+CAA+C,aAC5D,aAAI,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,UAAU,CAAC,YAC7D,UAAU,CAAC,EAAE,EAAE,uBAAuB,CAAC,iBAAiB,CAAC,GACvD,EACL,YAAG,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,uBAAuB,CAAC,YACjD,UAAU,CAAC,EAAE,EAAE,uBAAuB,CAAC,uBAAuB,CAAC,GAC9D,IACA,GACqB,CAC9B,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;IAE7B,OAAO,CACL,KAAC,0BAA0B,cAOzB,mBAAS,SAAS,EAAC,+CAA+C,EAAC,IAAI,EAAE,OAAO,CAAC,MAAM,aACrF,kBAAQ,SAAS,EAAC,8BAA8B,aAC9C,aAAI,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,UAAU,CAAC,YAAG,OAAO,CAAC,KAAK,GAAM,EACrF,QAAQ,CAAC,IAAI,KAAK,kCAAkC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC/D,cAAI,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,wDAAwD,CAAC,aACpF,eAAK,SAAS,EAAC,qBAAqB,aAClC,uBAAK,UAAU,CAAC,EAAE,EAAE,uBAAuB,CAAC,YAAY,CAAC,GAAM,EAE/D,uBACE,eAAM,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,WAAW,YAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,kBAAkB,EAAE,GAAQ,GAC/G,IACD,EACN,cAAK,SAAS,EAAC,qBAAqB,YAClC,uBACG,UAAU,CAAC,EAAE,EAAE,uBAAuB,CAAC,eAAe,EAAE,EAAE,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,GACnH,GACD,IACH,CACN,CAAC,CAAC,CAAC,CACF,YAAG,IAAI,EAAC,MAAM,EAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,+BAA+B,CAAC,YACrE,UAAU,CAAC,EAAE,EAAE,uBAAuB,CAAC,uBAAuB,CAAC,GAC9D,CACL,IACM,EACR,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CACjC,mBAAkC,SAAS,EAAC,2BAA2B,aACrE,aAAI,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,UAAU,CAAC,YAAG,OAAO,CAAC,KAAK,GAAM,EACrF,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAC/B,eAA4B,SAAS,EAAC,8BAA8B,aAClE,KAAC,eAAe,IAAC,KAAK,EAAE,MAAM,CAAC,YAAY,GAAI,EAC9C,MAAM,CAAC,QAAQ,KAAK,oCAAoC,CAAC,mBAAmB,IAAI,CAC/E,aAAG,IAAI,EAAC,MAAM,EAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,+BAA+B,CAAC,aACtE,yBAAO,UAAU,CAAC,EAAE,EAAE,uBAAuB,CAAC,0BAA0B,CAAC,GAAQ,OAAC,yBAAO,MAAM,CAAC,kBAAkB,GAAQ,IACxH,CACL,KANO,MAAM,CAAC,SAAS,CAOpB,CACP,CAAC,KAXU,OAAO,CAAC,UAAU,CAYtB,CACX,CAAC,IACM,GACiB,CAC9B,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import React from 'react';\n\nimport {\n  PublicLayout_MainContainer,\n  cn,\n  getManualCallsHttpClient,\n  useAnonymousSession,\n  useApplication,\n  useI18n,\n  useUI,\n  useUserOrgs,\n  type PublicLayoutPreset_Terms_DefaultProps,\n} from '@wildo-ai/saas-frontend-lib';\nimport {\n  GovernedDocumentInteractionKind,\n  GovernedDocumentPublicClauseStanding,\n  GovernedDocumentPublicDocumentKind,\n  requiresApprovedGovernedDocuments,\n  resolveInForcePublicDocument,\n  type GovernedDocumentPublicDocument,\n} from '@wildo-ai/saas-models';\n\n// The markdown renderer is THIS package's, so it is reached by its own path rather than through the\n// engine barrel — `presets-components` is where the theme-mapped renderer lives.\nimport { MarkdownContent } from '~wildo-presets/components/data-display/markdown-content';\nimport { FrontendComponentType, PublicLayoutsTermsLabel, TypographyVariant, UIBehavior } from '@wildo-ai/presets-components-models';\n\nconst CT = FrontendComponentType.PUBLIC_LAYOUTS_TERMS;\n\n/**\n * The public governed-document page. Issue #168, and #968 for what it serves.\n *\n * Reads the application's own `compliance.publicDocuments` — each entry a composed release with the\n * text it carries, or the latest draft of a document the application has never released. The page\n * is a RENDERING of that specification, never a second description of it, which is why it takes no\n * title, no body and no effective date as props: every one of them would be a place the page could\n * disagree with the document.\n *\n * ## Four states\n *\n * **Not settled** — labels are still resolving. A loading line, because rendering a legal document\n * with unresolved labels around it is worse than rendering nothing for a moment.\n *\n * **Nothing to show** — no release for this ref is in force (or none is approved, when the gate is\n * armed), and no draft may stand in. The page says so and shows NO content. There is deliberately no\n * partial render: a legal statement half-shown is worse than one not shown, because a reader cannot\n * tell which half is missing.\n *\n * **Released** — the document, its sections and clauses in their declared order, with the release\n * version and effective date beneath the title. `bodyMarkdown` goes through `MarkdownContent`, which\n * renders markdown as TEXT through the active theme's typography recipes; the schema's own note says\n * public content \"is never trusted as raw HTML\", and this is where that holds.\n *\n * **Unreleased draft** — the same rendering, with a notice in place of the release metadata saying\n * the reader is looking at a draft. There is no effective date to show because nothing took effect.\n * It exists so that neither a missing approval nor a missing release leaves the page empty (#968).\n *\n * ## Unestablished clauses are MARKED, in either state\n *\n * A clause the drafter could not yet establish is rendered with a note beneath it saying so and what\n * is missing. Omitting it would narrow the document; showing it bare would state as settled what the\n * application itself wrote down as unsettled.\n *\n * ## What it does not decide\n *\n * Whether an UNAPPROVED release — or a draft — may be shown. That is the application's approval gate,\n * `compliance.governedDocumentApprovalGate`, read through `requiresApprovedGovernedDocuments` — the same\n * reading every acceptance surface uses, so the page cannot be armed without them (#1565). It used to\n * be a prop the route passed, which is exactly how it could be armed here alone. See\n * `.claude/rules/one-source-of-truth.md` D5 for why arming it belongs to Gate 3.\n */\nexport const PublicLayoutPreset_Terms_Default = ({\n  documentRef,\n}: PublicLayoutPreset_Terms_DefaultProps): React.JSX.Element => {\n  const { appConfig } = useApplication();\n  const { tComponent, isReady } = useI18n({ component: CT });\n  const { getRecipe } = useUI();\n  const { user, auth } = useUserOrgs();\n  const { initAnonymousSession } = useAnonymousSession();\n  const heading = getRecipe(UIBehavior.TYPOGRAPHY, TypographyVariant.HEADING);\n  const body = getRecipe(UIBehavior.TYPOGRAPHY, TypographyVariant.BODY);\n\n  /*\n   * Pinned at mount rather than re-evaluated per render. A release taking effect while somebody is\n   * READING would otherwise swap the document under them mid-paragraph — the reading equivalent of\n   * the registration form's own \"what am I agreeing to\" hazard.\n   */\n  const document = React.useMemo<GovernedDocumentPublicDocument | undefined>(\n    () => resolveInForcePublicDocument(\n      appConfig.compliance?.publicDocuments ?? [],\n      documentRef,\n      new Date().toISOString(),\n      { requireApproved: requiresApprovedGovernedDocuments(appConfig.compliance) },\n    ),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- pinned at mount, deliberately; see above.\n    [appConfig.compliance?.publicDocuments, documentRef, appConfig.compliance?.governedDocumentApprovalGate],\n  );\n\n  /*\n   * Record NOTICE_DELIVERED once, on MOUNT — never per render — for the exact release this page is\n   * showing (#1258 Step 5 / R11). Fire-and-forget: a delivery record failing to write must never\n   * affect the page the reader already sees.\n   *\n   * Two guards keep this from writing the \"47 identical reads\" the #51 lesson warns about\n   * (`recordGovernedDocumentAcceptances`'s own header cites it): the effect's own empty-ish deps\n   * fire it once per mount, and a `sessionStorage` flag skips a repeat visit to the same document +\n   * release within the same browser tab. Neither is a hard guarantee against every duplicate — the\n   * recorder's own JSDoc explains why a rare true duplicate is tolerated rather than built out with a\n   * second queryable resource.\n   *\n   * Reader identity: a signed-in person's own bearer-token route, or the anonymous-session door —\n   * whichever the person currently is. **Waits for `auth.isRestoringSession` to clear first**, and\n   * that wait is load-bearing, not cosmetic (review finding F1, #1258 Steps 4-5): a stored access\n   * token resolves ASYNCHRONOUSLY, over a real network round-trip\n   * (`AuthSessionContext`/`UserOrgsContext`) — an earlier draft of this comment claimed the resolve\n   * was synchronous and that \"signed out\" and \"not yet known\" were indistinguishable, and both\n   * halves were wrong. A signed-in person landing directly on `/terms` or `/privacy` on a fresh page\n   * load (an emailed link, the R7 re-acceptance redirect) would otherwise be read as signed-out for\n   * the one render this effect fires on, mint a throwaway anonymous session via\n   * `initAnonymousSession()`, and have their delivery permanently misattributed to it — nothing ever\n   * reconciles a stray session created this way back onto the account, unlike Step 1's carry, which\n   * only runs at registration/authentication. `AppLayout_AuthenticatedRoute.tsx` already gates on\n   * exactly this signal for exactly this reason; this effect now does the same.\n   */\n  React.useEffect(() => {\n    if (auth.isRestoringSession) return;\n    if (document?.kind !== GovernedDocumentPublicDocumentKind.RELEASED) return;\n    if (!document.release.allowedInteractionKinds.includes(GovernedDocumentInteractionKind.NOTICE_DELIVERED)) return;\n\n    const sessionKey = `wildo:notice-delivered:${documentRef}:${document.release.identity.releaseId}@${document.release.identity.releaseVersion}`;\n    try {\n      if (window.sessionStorage.getItem(sessionKey)) return;\n      window.sessionStorage.setItem(sessionKey, '1');\n    } catch {\n      // Storage unavailable (private browsing, quota) — proceed and risk a duplicate row rather than\n      // never recording delivery at all.\n    }\n\n    const client = getManualCallsHttpClient();\n    if (user !== null) {\n      void client.recordGovernedDocumentNoticeDelivered(documentRef);\n    } else {\n      // A first-ever visit has no anonymous session yet — `record_consent`'s own door needed the\n      // same thing before Step 1a existed. `initAnonymousSession` is a no-op returning the existing\n      // id when one is already ACTIVE, so this is safe to call unconditionally here.\n      initAnonymousSession();\n      void client.recordAnonymousGovernedDocumentNoticeDelivered(documentRef);\n    }\n    // `auth.isRestoringSession` is a real dependency, not a suppressed one: this effect must re-run\n    // the instant it clears, which is the whole point of the gate above. `user`/`initAnonymousSession`\n    // are read fresh inside the effect and are stable enough not to cause a spurious re-fire past the\n    // sessionStorage guard, which is what the suppression below still covers.\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- fires once per mount for this release; see above.\n  }, [document, documentRef, auth.isRestoringSession]);\n\n  if (!isReady) {\n    return (\n      <PublicLayout_MainContainer>\n        <p className={cn(body.base, 'text-muted-foreground')}>{tComponent(CT, PublicLayoutsTermsLabel.LOADING)}</p>\n      </PublicLayout_MainContainer>\n    );\n  }\n\n  if (!document) {\n    return (\n      <PublicLayout_MainContainer>\n        <div className=\"mx-auto flex max-w-prose flex-col gap-element\">\n          <h1 className={cn(heading.base, heading.sizes?.h1 ?? 'text-3xl')}>\n            {tComponent(CT, PublicLayoutsTermsLabel.UNAVAILABLE_TITLE)}\n          </h1>\n          <p className={cn(body.base, 'text-muted-foreground')}>\n            {tComponent(CT, PublicLayoutsTermsLabel.UNAVAILABLE_DESCRIPTION)}\n          </p>\n        </div>\n      </PublicLayout_MainContainer>\n    );\n  }\n\n  const { content } = document;\n\n  return (\n    <PublicLayout_MainContainer>\n      {/*\n        * `lang` is the document's OWN locale, not the reader's. A French notice read in an English\n        * browser is still French, and announcing it as English makes a screen reader pronounce it\n        * wrongly — the one accessibility defect a document page can introduce that its own content\n        * cannot fix.\n        */}\n      <article className=\"mx-auto flex max-w-prose flex-col gap-section\" lang={content.locale}>\n        <header className=\"flex flex-col gap-element-sm\">\n          <h1 className={cn(heading.base, heading.sizes?.h1 ?? 'text-3xl')}>{content.title}</h1>\n          {document.kind === GovernedDocumentPublicDocumentKind.RELEASED ? (\n            <dl className={cn(body.base, 'flex flex-wrap gap-field text-sm text-muted-foreground')}>\n              <div className=\"flex gap-element-sm\">\n                <dt>{tComponent(CT, PublicLayoutsTermsLabel.EFFECTIVE_AT)}</dt>\n                {/* The machine-readable value stays in `dateTime`; the text is the reader's locale. */}\n                <dd>\n                  <time dateTime={document.release.effectiveAt}>{new Date(document.release.effectiveAt).toLocaleDateString()}</time>\n                </dd>\n              </div>\n              <div className=\"flex gap-element-sm\">\n                <dt>\n                  {tComponent(CT, PublicLayoutsTermsLabel.RELEASE_VERSION, { releaseVersion: document.release.identity.releaseVersion })}\n                </dt>\n              </div>\n            </dl>\n          ) : (\n            <p role=\"note\" className={cn(body.base, 'text-sm text-muted-foreground')}>\n              {tComponent(CT, PublicLayoutsTermsLabel.UNRELEASED_DRAFT_NOTICE)}\n            </p>\n          )}\n        </header>\n        {content.sections.map((section) => (\n          <section key={section.sectionRef} className=\"flex flex-col gap-element\">\n            <h2 className={cn(heading.base, heading.sizes?.h2 ?? 'text-2xl')}>{section.title}</h2>\n            {section.clauses.map((clause) => (\n              <div key={clause.clauseRef} className=\"flex flex-col gap-element-sm\">\n                <MarkdownContent value={clause.bodyMarkdown} />\n                {clause.standing === GovernedDocumentPublicClauseStanding.NOT_YET_ESTABLISHED && (\n                  <p role=\"note\" className={cn(body.base, 'text-sm text-muted-foreground')}>\n                    <span>{tComponent(CT, PublicLayoutsTermsLabel.CLAUSE_NOT_YET_ESTABLISHED)}</span> <span>{clause.missingInformation}</span>\n                  </p>\n                )}\n              </div>\n            ))}\n          </section>\n        ))}\n      </article>\n    </PublicLayout_MainContainer>\n  );\n};\n"]}

package/dist/esm/components/billing/billing-format.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"billing-format.utils.d.ts","sourceRoot":"","sources":["../../../../src/components/billing/billing-format.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAK3D;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,CAAC,KAAK,EAAE,UAAU,KAAK,MAAM,CAe9D"}
+{"version":3,"file":"billing-format.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/billing/billing-format.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAK3D;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,CAAC,KAAK,EAAE,UAAU,KAAK,MAAM,CAe9D"}

package/dist/esm/components/billing/billing-invoice-history.d.ts

@@ -9,5 +9,5 @@
  */
 import { InvoiceHistoryProps } from '@wildo-ai/saas-frontend-lib';
 import React from 'react';
-export declare function InvoiceHistory({ invoices, providerName, isLoading, error, onViewAll, limit, }: InvoiceHistoryProps): React.JSX.Element | null;
+export declare function InvoiceHistory({ invoices, providerName, isLoading, error, unavailable, onViewAll, limit, }: InvoiceHistoryProps): React.JSX.Element | null;
 //# sourceMappingURL=billing-invoice-history.d.ts.map

package/dist/esm/components/billing/billing-invoice-history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"billing-invoice-history.d.ts","sourceRoot":"","sources":["../../../../src/components/billing/billing-invoice-history.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,mBAAmB,EAapB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,KAA+B,MAAM,OAAO,CAAC;AAoBpD,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,KAAK,EACL,SAAS,EACT,KAAU,GACX,EAAE,mBAAmB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA2IhD"}
+{"version":3,"file":"billing-invoice-history.d.ts","sourceRoot":"","sources":["../../../../../src/components/billing/billing-invoice-history.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,mBAAmB,EAapB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,KAA+B,MAAM,OAAO,CAAC;AAoBpD,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,KAAK,EACL,WAAW,EACX,SAAS,EACT,KAAU,GACX,EAAE,mBAAmB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA6IhD"}

package/dist/esm/components/billing/billing-invoice-history.js

@@ -21,7 +21,7 @@ const STATUS_BADGE_CONFIG = {
     uncollectible: { labelKey: 'uncollectibleBadge', indicatorVariant: IndicatorVariant.ERROR },
 };
 // ── Component ───────────────────────────────────────────────────────
-export function InvoiceHistory({ invoices, providerName, isLoading, error, onViewAll, limit = 10, }) {
+export function InvoiceHistory({ invoices, providerName, isLoading, error, unavailable, onViewAll, limit = 10, }) {
     const { getRecipe } = useUI();
     const { makeTrComponent, formatDate, isReady } = useI18n({ component: FrontendComponentType.LOW_LEVEL_BILLING_INVOICE_HISTORY });
     const { renderIcon } = useIconRegistry();
@@ -45,6 +45,8 @@ export function InvoiceHistory({ invoices, providerName, isLoading, error, onVie
     }
     if (!isReady)
         return null;
+    if (unavailable)
+        return _jsx(Alert, { variant: "destructive", children: _jsx(AlertDescription, { children: t('unavailable') }) });
     return (_jsx(Surface, { asChild: true, emitPolicyVars: false, variant: SurfaceVariant.BASE, children: _jsxs("div", { className: cn("p-card", surfaceRecipe.base), children: [_jsxs("div", { className: "flex items-center justify-between mb-section", children: [_jsx("h3", { className: cn(headingRecipe.base, headingRecipe.sizes?.md), children: t('title') }), onViewAll && invoices.length > limit && (_jsxs(Button, { variant: ButtonVariants_Variant.GHOST, size: ButtonSize.SM, onClick: onViewAll, children: [_jsx("span", { children: t('viewAll') }), providerName && (_jsx("span", { className: cn(descriptionRecipe.base, "text-xs"), children: providerName }))] }))] }), displayInvoices.length === 0 && (_jsx("p", { className: cn(descriptionRecipe.base, "py-4 text-center"), children: t('emptyState') })), displayInvoices.length > 0 && (_jsx("div", { className: "divide-y divide-border", children: displayInvoices.map((invoice) => {
                         const badgeConfig = STATUS_BADGE_CONFIG[invoice.status] ?? STATUS_BADGE_CONFIG.draft;
                         const badgeRecipe = getRecipe(UIBehavior.INDICATOR, badgeConfig.indicatorVariant);