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

package/dist/esm/core/navigation/primary-destination-layout.d.ts

@@ -59,6 +59,64 @@ export type PrimaryDestinationContent = {
 export type PrimaryDestinationCompositeView = PrimaryDestinationLayoutDeclaration & {
     ref: string;
 };
+/**
+ * The destination primary holds when the app root renders a COMPOSITE HOME.
+ *
+ * ## The gap this closes
+ *
+ * `homeDefinition.compositeViewReference` renders its view IN PLACE at `/` — the app root keeps its
+ * URL, and `AppLayout_Home` returns `<CompositeView …>` as the router's children. Its own comment
+ * says it "mirrors the canonical composite render in `NavigationContentAreas`", and it does mirror
+ * the RENDER. What it cannot mirror is the DESTINATION: nothing is pushed onto primary's zone stack,
+ * so `getTopContent(PRIMARY)` answers for a stack the home never wrote to, and every layout
+ * declaration the view carries is unreadable.
+ *
+ * Measured on the workbench at 1512×950 (#1278), whose board declares `adjacentZoneOnEmpty: COLLAPSE`
+ * against a zone whose default is `EMPTY_STATE`:
+ *
+ * | board reached by | primary |
+ * |---|---|
+ * | `/` after login, hard reload, or a deep link | **470px** — the split's own `[33, 67]` share |
+ * | `/composite/creation-board` | 1424px |
+ * | sidebar navigation to it | 1424px |
+ *
+ * So the override worked everywhere the board was a real destination, and nowhere on the one URL the
+ * application actually opens at. An operator met a board in a third of the window on every load and
+ * could only widen it by navigating away and back.
+ *
+ * ## Why here, and why it fixes three things at once
+ *
+ * `NavigationContentAreas` reads primary's destination ONCE and feeds it to the `onEmpty` override,
+ * the zone geometry (`zoneContentMaxWidth` / `zoneContentFillsHeight`) and the resolved/unresolved
+ * predicate. All three were blind in the same way, so a composite home was also silently capped at
+ * the default content width — the defect #176 fixed for canvases, arriving again through the home
+ * door. One fallback at the shared seam answers all three, which is the same argument this module's
+ * own docstring makes for owning the content-kind switch.
+ *
+ * ## What is actually in primary at the root, measured rather than assumed
+ *
+ * `ENGINE_PAGE`. The first version of this fix was a `??` fallback for an EMPTY stack and changed
+ * nothing, because the stack is not empty: the shell pushes the home as an engine page, and an
+ * engine page is precisely the kind `primaryDestinationDeclarationIsKnown` answers `true` for and
+ * `resolvePrimaryDestinationLayoutDeclaration` answers `undefined` for — resolved, declares nothing.
+ * Correct for a real engine page; wrong for one whose whole content is a composite view.
+ *
+ * So this OVERRIDES rather than defaults, and the two guards are what keep the override narrow:
+ *
+ * - **the root path**, because that is where and only where the home layout renders. An empty or
+ *   engine-page primary elsewhere is a different surface, and handing it the home's `COLLAPSE` would
+ *   HIDE a pane that destination wanted reserved — a worse failure than the one being fixed.
+ * - **the stack top being absent or an ENGINE_PAGE**, so a real destination in primary is never
+ *   displaced. If something with its own declaration is there, it wins.
+ */
+export declare function resolveHomeCompositeDestination(params: {
+    /** `homeDefinition.compositeViewReference`, or `undefined` when the home is not a composite. */
+    homeCompositeViewRef: string | undefined;
+    /** Whether the router is at the application root — where, and only where, the home layout renders. */
+    isAppRootPath: boolean;
+    /** What primary's own stack holds, so a real destination is never displaced. */
+    primaryStackTop: PrimaryDestinationContent | undefined;
+}): PrimaryDestinationContent | undefined;
 /**
  * Whether we YET KNOW what the destination in primary declares.
  *

package/dist/esm/core/navigation/primary-destination-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primary-destination-layout.d.ts","sourceRoot":"","sources":["../../../../src/core/navigation/primary-destination-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,qGAAqG;AACrG,MAAM,WAAW,mCAAmC;IAClD,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,iBAAiB,CAAC;IACxC,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,kBAAkB,CAAC;IACzC,iEAAiE;IACjE,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GACjC;IACA,WAAW,EAAE,qBAAqB,CAAC,kBAAkB,CAAC;IACtD,eAAe,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE;YAAE,uBAAuB,CAAC,EAAE,mCAAmC,CAAA;SAAE,CAAA;KAAE,CAAC;CACrG,GACC;IAAE,WAAW,EAAE,qBAAqB,CAAC,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,WAAW,EAAE,OAAO,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,kBAAkB,GAAG,qBAAqB,CAAC,cAAc,CAAC,CAAA;CAAE,CAAC;AAErI,6EAA6E;AAC7E,MAAM,MAAM,+BAA+B,GAAG,mCAAmC,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpG;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oCAAoC,CAAC,MAAM,EAAE;IAC3D,cAAc,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACtD,cAAc,EAAE,SAAS,+BAA+B,EAAE,GAAG,SAAS,CAAC;CACxE,GAAG,OAAO,CAWV;AAED;;;;;;;GAOG;AACH,wBAAgB,0CAA0C,CAAC,MAAM,EAAE;IACjE,cAAc,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACtD,cAAc,EAAE,SAAS,+BAA+B,EAAE,GAAG,SAAS,CAAC;CACxE,GAAG,mCAAmC,GAAG,SAAS,CAelD"}
+{"version":3,"file":"primary-destination-layout.d.ts","sourceRoot":"","sources":["../../../../../src/core/navigation/primary-destination-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,qGAAqG;AACrG,MAAM,WAAW,mCAAmC;IAClD,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,iBAAiB,CAAC;IACxC,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,kBAAkB,CAAC;IACzC,iEAAiE;IACjE,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GACjC;IACA,WAAW,EAAE,qBAAqB,CAAC,kBAAkB,CAAC;IACtD,eAAe,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE;YAAE,uBAAuB,CAAC,EAAE,mCAAmC,CAAA;SAAE,CAAA;KAAE,CAAC;CACrG,GACC;IAAE,WAAW,EAAE,qBAAqB,CAAC,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,WAAW,EAAE,OAAO,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,kBAAkB,GAAG,qBAAqB,CAAC,cAAc,CAAC,CAAA;CAAE,CAAC;AAErI,6EAA6E;AAC7E,MAAM,MAAM,+BAA+B,GAAG,mCAAmC,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,gGAAgG;IAChG,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,sGAAsG;IACtG,aAAa,EAAE,OAAO,CAAC;IACvB,gFAAgF;IAChF,eAAe,EAAE,yBAAyB,GAAG,SAAS,CAAC;CACxD,GAAG,yBAAyB,GAAG,SAAS,CAKxC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oCAAoC,CAAC,MAAM,EAAE;IAC3D,cAAc,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACtD,cAAc,EAAE,SAAS,+BAA+B,EAAE,GAAG,SAAS,CAAC;CACxE,GAAG,OAAO,CAWV;AAED;;;;;;;GAOG;AACH,wBAAgB,0CAA0C,CAAC,MAAM,EAAE;IACjE,cAAc,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACtD,cAAc,EAAE,SAAS,+BAA+B,EAAE,GAAG,SAAS,CAAC;CACxE,GAAG,mCAAmC,GAAG,SAAS,CAelD"}

package/dist/esm/core/navigation/primary-destination-layout.js

@@ -26,6 +26,64 @@
  * an uncapped page should flash before the stack is reconciled from the URL.
  */
 import { NavigationContentType } from './navigation.schemas.js';
+/**
+ * The destination primary holds when the app root renders a COMPOSITE HOME.
+ *
+ * ## The gap this closes
+ *
+ * `homeDefinition.compositeViewReference` renders its view IN PLACE at `/` — the app root keeps its
+ * URL, and `AppLayout_Home` returns `<CompositeView …>` as the router's children. Its own comment
+ * says it "mirrors the canonical composite render in `NavigationContentAreas`", and it does mirror
+ * the RENDER. What it cannot mirror is the DESTINATION: nothing is pushed onto primary's zone stack,
+ * so `getTopContent(PRIMARY)` answers for a stack the home never wrote to, and every layout
+ * declaration the view carries is unreadable.
+ *
+ * Measured on the workbench at 1512×950 (#1278), whose board declares `adjacentZoneOnEmpty: COLLAPSE`
+ * against a zone whose default is `EMPTY_STATE`:
+ *
+ * | board reached by | primary |
+ * |---|---|
+ * | `/` after login, hard reload, or a deep link | **470px** — the split's own `[33, 67]` share |
+ * | `/composite/creation-board` | 1424px |
+ * | sidebar navigation to it | 1424px |
+ *
+ * So the override worked everywhere the board was a real destination, and nowhere on the one URL the
+ * application actually opens at. An operator met a board in a third of the window on every load and
+ * could only widen it by navigating away and back.
+ *
+ * ## Why here, and why it fixes three things at once
+ *
+ * `NavigationContentAreas` reads primary's destination ONCE and feeds it to the `onEmpty` override,
+ * the zone geometry (`zoneContentMaxWidth` / `zoneContentFillsHeight`) and the resolved/unresolved
+ * predicate. All three were blind in the same way, so a composite home was also silently capped at
+ * the default content width — the defect #176 fixed for canvases, arriving again through the home
+ * door. One fallback at the shared seam answers all three, which is the same argument this module's
+ * own docstring makes for owning the content-kind switch.
+ *
+ * ## What is actually in primary at the root, measured rather than assumed
+ *
+ * `ENGINE_PAGE`. The first version of this fix was a `??` fallback for an EMPTY stack and changed
+ * nothing, because the stack is not empty: the shell pushes the home as an engine page, and an
+ * engine page is precisely the kind `primaryDestinationDeclarationIsKnown` answers `true` for and
+ * `resolvePrimaryDestinationLayoutDeclaration` answers `undefined` for — resolved, declares nothing.
+ * Correct for a real engine page; wrong for one whose whole content is a composite view.
+ *
+ * So this OVERRIDES rather than defaults, and the two guards are what keep the override narrow:
+ *
+ * - **the root path**, because that is where and only where the home layout renders. An empty or
+ *   engine-page primary elsewhere is a different surface, and handing it the home's `COLLAPSE` would
+ *   HIDE a pane that destination wanted reserved — a worse failure than the one being fixed.
+ * - **the stack top being absent or an ENGINE_PAGE**, so a real destination in primary is never
+ *   displaced. If something with its own declaration is there, it wins.
+ */
+export function resolveHomeCompositeDestination(params) {
+    const { homeCompositeViewRef, isAppRootPath, primaryStackTop } = params;
+    if (!isAppRootPath || !homeCompositeViewRef)
+        return undefined;
+    if (primaryStackTop && primaryStackTop.contentType !== NavigationContentType.ENGINE_PAGE)
+        return undefined;
+    return { contentType: NavigationContentType.COMPOSITE_VIEW, viewRef: homeCompositeViewRef };
+}
 /**
  * Whether we YET KNOW what the destination in primary declares.
  *

package/dist/esm/core/navigation/primary-destination-layout.js.map

@@ -1 +1 @@
-{"version":3,"file":"primary-destination-layout.js","sourceRoot":"","sources":["../../../../src/core/navigation/primary-destination-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AA4B7D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,oCAAoC,CAAC,MAGpD;IACC,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IAClD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,cAAc,CAAC,WAAW,KAAK,qBAAqB,CAAC,cAAc,EAAE,CAAC;QACxE,gGAAgG;QAChG,mFAAmF;QACnF,OAAO,cAAc,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,KAAK,cAAc,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;IAChG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0CAA0C,CAAC,MAG1D;IACC,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IAClD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,cAAc,CAAC,WAAW,KAAK,qBAAqB,CAAC,kBAAkB,EAAE,CAAC;QAC5E,OAAO,cAAc,CAAC,eAAe,EAAE,SAAS,EAAE,uBAAuB,CAAC;IAC5E,CAAC;IAED,IAAI,cAAc,CAAC,WAAW,KAAK,qBAAqB,CAAC,cAAc,EAAE,CAAC;QACxE,OAAO,cAAc,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["/**\n * Layout declarations read off whatever occupies the PRIMARY zone.\n *\n * ## Why one reader for several concerns\n *\n * Two independent layout questions are answered by the destination in primary — what its adjacent\n * zone does when it empties (`adjacentZoneOnEmpty`, issue #191) and how much of the zone its own\n * content occupies (`zoneContentMaxWidth` / `zoneContentFillsHeight`, issue #176) — and both are answered by the SAME lookup: switch\n * on the content kind, then read the composite-view definition or the resource operation's frontend\n * config.\n *\n * Written once for exactly the reason `invariant-call-site-enumeration.md` exists. Two copies of this\n * switch would be two places to remember when a third content kind becomes a destination, and the one\n * that was forgotten would answer `undefined` — a silent deferral to the default, indistinguishable\n * from a destination that deliberately declared nothing.\n *\n * ## Which content kinds can declare\n *\n * A RESOURCE_OPERATION (a list drilling into a detail) and a COMPOSITE_VIEW (a canvas or board\n * selecting an item). Everything else — charts, engine pages, the settings hub — answers `undefined`\n * and defers, which is an answer rather than an omission: those surfaces neither open a detail pane\n * nor own a canvas, so they have no opinion to express.\n *\n * `undefined` content is the router-fallback case: primary's stack is empty and `routerChildren` is\n * rendering. It defers too, and that matters on a cold deep-link — neither a reserved empty strip nor\n * an uncapped page should flash before the stack is reconciled from the URL.\n */\n\nimport type { ResponsiveMaxWidth } from '@wildo-ai/presets-components-models';\nimport type { ZoneEmptyBehavior } from '@wildo-ai/saas-models';\n\nimport { NavigationContentType } from './navigation.schemas';\n\n/** The layout declarations a destination may carry. Both optional; both default at the read site. */\nexport interface PrimaryDestinationLayoutDeclaration {\n  /** See `CompositeViewAuthoringConfig.adjacentZoneOnEmpty`. */\n  adjacentZoneOnEmpty?: ZoneEmptyBehavior;\n  /** See `CompositeViewAuthoringConfig.zoneContentMaxWidth`. */\n  zoneContentMaxWidth?: ResponsiveMaxWidth;\n  /** See `CompositeViewAuthoringConfig.zoneContentFillsHeight`. */\n  zoneContentFillsHeight?: boolean;\n}\n\n/**\n * The two content shapes this module reads, structurally typed so it does not depend on the full\n * navigation-content union — which already reaches into the resource registry and would make this a\n * cycle.\n */\nexport type PrimaryDestinationContent =\n  | {\n    contentType: NavigationContentType.RESOURCE_OPERATION;\n    resourceContext?: { operation?: { operationFrontendConfig?: PrimaryDestinationLayoutDeclaration } };\n  }\n  | { contentType: NavigationContentType.COMPOSITE_VIEW; viewRef: string }\n  | { contentType: Exclude<NavigationContentType, NavigationContentType.RESOURCE_OPERATION | NavigationContentType.COMPOSITE_VIEW> };\n\n/** A composite view definition, narrowed to the fields this module needs. */\nexport type PrimaryDestinationCompositeView = PrimaryDestinationLayoutDeclaration & { ref: string };\n\n/**\n * Whether we YET KNOW what the destination in primary declares.\n *\n * `resolvePrimaryDestinationLayoutDeclaration` answers `undefined` for two different situations, and\n * for the reads that only pick a default they are interchangeable — which is why they were allowed to\n * stay merged. For one read they are NOT:\n *\n *   - **resolved, and declares nothing** — a chart, an engine page, the settings hub. An answer.\n *   - **not resolved yet** — primary's stack is empty while the URL is being reconciled, or the\n *     composite-view definition has not reached `compositeViews`. Not an answer; a moment.\n *\n * The read that must tell them apart is whether an empty adjacent zone RESERVES space. Reserving is a\n * structural decision: it takes a third of the window away from primary. Taking a default during the\n * unresolved moment means the zone's `onEmpty` briefly wins over a destination override that is about\n * to say the opposite, and the pane appears and vanishes within ~25ms — measured on the workbench\n * creation board, whose zone declares `EMPTY_STATE` and whose every destination overrides `COLLAPSE`.\n *\n * This module's own docstring already named that hazard — \"neither a reserved empty strip nor an\n * uncapped page should flash before the stack is reconciled from the URL\" — and deferring to the zone\n * default is exactly what produced it. The distinction it says costs nothing to keep is what this\n * predicate finally spends.\n *\n * Width does NOT need this. Both sides of an unresolved width answer `'content'`, so nothing moves.\n */\nexport function primaryDestinationDeclarationIsKnown(params: {\n  primaryContent: PrimaryDestinationContent | undefined;\n  compositeViews: readonly PrimaryDestinationCompositeView[] | undefined;\n}): boolean {\n  const { primaryContent, compositeViews } = params;\n  if (!primaryContent) {\n    return false;\n  }\n  if (primaryContent.contentType === NavigationContentType.COMPOSITE_VIEW) {\n    // A view whose definition has not arrived is indistinguishable from one that declares nothing —\n    // and the two want opposite structural answers, so treat the absence as \"not yet\".\n    return compositeViews?.some((candidate) => candidate.ref === primaryContent.viewRef) ?? false;\n  }\n  return true;\n}\n\n/**\n * Resolve the layout declarations carried by the destination currently in PRIMARY.\n *\n * Returns `undefined` when there is no destination or the destination kind carries no declarations —\n * distinct from returning an empty object, so a caller can tell \"nothing there\" from \"there, and\n * declared nothing\". Both defer to the same defaults today; keeping them distinct costs nothing and\n * makes a future default-by-content-kind expressible.\n */\nexport function resolvePrimaryDestinationLayoutDeclaration(params: {\n  primaryContent: PrimaryDestinationContent | undefined;\n  compositeViews: readonly PrimaryDestinationCompositeView[] | undefined;\n}): PrimaryDestinationLayoutDeclaration | undefined {\n  const { primaryContent, compositeViews } = params;\n  if (!primaryContent) {\n    return undefined;\n  }\n\n  if (primaryContent.contentType === NavigationContentType.RESOURCE_OPERATION) {\n    return primaryContent.resourceContext?.operation?.operationFrontendConfig;\n  }\n\n  if (primaryContent.contentType === NavigationContentType.COMPOSITE_VIEW) {\n    return compositeViews?.find((candidate) => candidate.ref === primaryContent.viewRef);\n  }\n\n  return undefined;\n}\n"]}
+{"version":3,"file":"primary-destination-layout.js","sourceRoot":"","sources":["../../../../../src/core/navigation/primary-destination-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AA4B7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,MAAM,UAAU,+BAA+B,CAAC,MAO/C;IACC,MAAM,EAAE,oBAAoB,EAAE,aAAa,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;IACxE,IAAI,CAAC,aAAa,IAAI,CAAC,oBAAoB;QAAE,OAAO,SAAS,CAAC;IAC9D,IAAI,eAAe,IAAI,eAAe,CAAC,WAAW,KAAK,qBAAqB,CAAC,WAAW;QAAE,OAAO,SAAS,CAAC;IAC3G,OAAO,EAAE,WAAW,EAAE,qBAAqB,CAAC,cAAc,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAC9F,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,oCAAoC,CAAC,MAGpD;IACC,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IAClD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,cAAc,CAAC,WAAW,KAAK,qBAAqB,CAAC,cAAc,EAAE,CAAC;QACxE,gGAAgG;QAChG,mFAAmF;QACnF,OAAO,cAAc,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,KAAK,cAAc,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;IAChG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0CAA0C,CAAC,MAG1D;IACC,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IAClD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,cAAc,CAAC,WAAW,KAAK,qBAAqB,CAAC,kBAAkB,EAAE,CAAC;QAC5E,OAAO,cAAc,CAAC,eAAe,EAAE,SAAS,EAAE,uBAAuB,CAAC;IAC5E,CAAC;IAED,IAAI,cAAc,CAAC,WAAW,KAAK,qBAAqB,CAAC,cAAc,EAAE,CAAC;QACxE,OAAO,cAAc,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["/**\n * Layout declarations read off whatever occupies the PRIMARY zone.\n *\n * ## Why one reader for several concerns\n *\n * Two independent layout questions are answered by the destination in primary — what its adjacent\n * zone does when it empties (`adjacentZoneOnEmpty`, issue #191) and how much of the zone its own\n * content occupies (`zoneContentMaxWidth` / `zoneContentFillsHeight`, issue #176) — and both are answered by the SAME lookup: switch\n * on the content kind, then read the composite-view definition or the resource operation's frontend\n * config.\n *\n * Written once for exactly the reason `invariant-call-site-enumeration.md` exists. Two copies of this\n * switch would be two places to remember when a third content kind becomes a destination, and the one\n * that was forgotten would answer `undefined` — a silent deferral to the default, indistinguishable\n * from a destination that deliberately declared nothing.\n *\n * ## Which content kinds can declare\n *\n * A RESOURCE_OPERATION (a list drilling into a detail) and a COMPOSITE_VIEW (a canvas or board\n * selecting an item). Everything else — charts, engine pages, the settings hub — answers `undefined`\n * and defers, which is an answer rather than an omission: those surfaces neither open a detail pane\n * nor own a canvas, so they have no opinion to express.\n *\n * `undefined` content is the router-fallback case: primary's stack is empty and `routerChildren` is\n * rendering. It defers too, and that matters on a cold deep-link — neither a reserved empty strip nor\n * an uncapped page should flash before the stack is reconciled from the URL.\n */\n\nimport type { ResponsiveMaxWidth } from '@wildo-ai/presets-components-models';\nimport type { ZoneEmptyBehavior } from '@wildo-ai/saas-models';\n\nimport { NavigationContentType } from './navigation.schemas';\n\n/** The layout declarations a destination may carry. Both optional; both default at the read site. */\nexport interface PrimaryDestinationLayoutDeclaration {\n  /** See `CompositeViewAuthoringConfig.adjacentZoneOnEmpty`. */\n  adjacentZoneOnEmpty?: ZoneEmptyBehavior;\n  /** See `CompositeViewAuthoringConfig.zoneContentMaxWidth`. */\n  zoneContentMaxWidth?: ResponsiveMaxWidth;\n  /** See `CompositeViewAuthoringConfig.zoneContentFillsHeight`. */\n  zoneContentFillsHeight?: boolean;\n}\n\n/**\n * The two content shapes this module reads, structurally typed so it does not depend on the full\n * navigation-content union — which already reaches into the resource registry and would make this a\n * cycle.\n */\nexport type PrimaryDestinationContent =\n  | {\n    contentType: NavigationContentType.RESOURCE_OPERATION;\n    resourceContext?: { operation?: { operationFrontendConfig?: PrimaryDestinationLayoutDeclaration } };\n  }\n  | { contentType: NavigationContentType.COMPOSITE_VIEW; viewRef: string }\n  | { contentType: Exclude<NavigationContentType, NavigationContentType.RESOURCE_OPERATION | NavigationContentType.COMPOSITE_VIEW> };\n\n/** A composite view definition, narrowed to the fields this module needs. */\nexport type PrimaryDestinationCompositeView = PrimaryDestinationLayoutDeclaration & { ref: string };\n\n/**\n * The destination primary holds when the app root renders a COMPOSITE HOME.\n *\n * ## The gap this closes\n *\n * `homeDefinition.compositeViewReference` renders its view IN PLACE at `/` — the app root keeps its\n * URL, and `AppLayout_Home` returns `<CompositeView …>` as the router's children. Its own comment\n * says it \"mirrors the canonical composite render in `NavigationContentAreas`\", and it does mirror\n * the RENDER. What it cannot mirror is the DESTINATION: nothing is pushed onto primary's zone stack,\n * so `getTopContent(PRIMARY)` answers for a stack the home never wrote to, and every layout\n * declaration the view carries is unreadable.\n *\n * Measured on the workbench at 1512×950 (#1278), whose board declares `adjacentZoneOnEmpty: COLLAPSE`\n * against a zone whose default is `EMPTY_STATE`:\n *\n * | board reached by | primary |\n * |---|---|\n * | `/` after login, hard reload, or a deep link | **470px** — the split's own `[33, 67]` share |\n * | `/composite/creation-board` | 1424px |\n * | sidebar navigation to it | 1424px |\n *\n * So the override worked everywhere the board was a real destination, and nowhere on the one URL the\n * application actually opens at. An operator met a board in a third of the window on every load and\n * could only widen it by navigating away and back.\n *\n * ## Why here, and why it fixes three things at once\n *\n * `NavigationContentAreas` reads primary's destination ONCE and feeds it to the `onEmpty` override,\n * the zone geometry (`zoneContentMaxWidth` / `zoneContentFillsHeight`) and the resolved/unresolved\n * predicate. All three were blind in the same way, so a composite home was also silently capped at\n * the default content width — the defect #176 fixed for canvases, arriving again through the home\n * door. One fallback at the shared seam answers all three, which is the same argument this module's\n * own docstring makes for owning the content-kind switch.\n *\n * ## What is actually in primary at the root, measured rather than assumed\n *\n * `ENGINE_PAGE`. The first version of this fix was a `??` fallback for an EMPTY stack and changed\n * nothing, because the stack is not empty: the shell pushes the home as an engine page, and an\n * engine page is precisely the kind `primaryDestinationDeclarationIsKnown` answers `true` for and\n * `resolvePrimaryDestinationLayoutDeclaration` answers `undefined` for — resolved, declares nothing.\n * Correct for a real engine page; wrong for one whose whole content is a composite view.\n *\n * So this OVERRIDES rather than defaults, and the two guards are what keep the override narrow:\n *\n * - **the root path**, because that is where and only where the home layout renders. An empty or\n *   engine-page primary elsewhere is a different surface, and handing it the home's `COLLAPSE` would\n *   HIDE a pane that destination wanted reserved — a worse failure than the one being fixed.\n * - **the stack top being absent or an ENGINE_PAGE**, so a real destination in primary is never\n *   displaced. If something with its own declaration is there, it wins.\n */\nexport function resolveHomeCompositeDestination(params: {\n  /** `homeDefinition.compositeViewReference`, or `undefined` when the home is not a composite. */\n  homeCompositeViewRef: string | undefined;\n  /** Whether the router is at the application root — where, and only where, the home layout renders. */\n  isAppRootPath: boolean;\n  /** What primary's own stack holds, so a real destination is never displaced. */\n  primaryStackTop: PrimaryDestinationContent | undefined;\n}): PrimaryDestinationContent | undefined {\n  const { homeCompositeViewRef, isAppRootPath, primaryStackTop } = params;\n  if (!isAppRootPath || !homeCompositeViewRef) return undefined;\n  if (primaryStackTop && primaryStackTop.contentType !== NavigationContentType.ENGINE_PAGE) return undefined;\n  return { contentType: NavigationContentType.COMPOSITE_VIEW, viewRef: homeCompositeViewRef };\n}\n\n/**\n * Whether we YET KNOW what the destination in primary declares.\n *\n * `resolvePrimaryDestinationLayoutDeclaration` answers `undefined` for two different situations, and\n * for the reads that only pick a default they are interchangeable — which is why they were allowed to\n * stay merged. For one read they are NOT:\n *\n *   - **resolved, and declares nothing** — a chart, an engine page, the settings hub. An answer.\n *   - **not resolved yet** — primary's stack is empty while the URL is being reconciled, or the\n *     composite-view definition has not reached `compositeViews`. Not an answer; a moment.\n *\n * The read that must tell them apart is whether an empty adjacent zone RESERVES space. Reserving is a\n * structural decision: it takes a third of the window away from primary. Taking a default during the\n * unresolved moment means the zone's `onEmpty` briefly wins over a destination override that is about\n * to say the opposite, and the pane appears and vanishes within ~25ms — measured on the workbench\n * creation board, whose zone declares `EMPTY_STATE` and whose every destination overrides `COLLAPSE`.\n *\n * This module's own docstring already named that hazard — \"neither a reserved empty strip nor an\n * uncapped page should flash before the stack is reconciled from the URL\" — and deferring to the zone\n * default is exactly what produced it. The distinction it says costs nothing to keep is what this\n * predicate finally spends.\n *\n * Width does NOT need this. Both sides of an unresolved width answer `'content'`, so nothing moves.\n */\nexport function primaryDestinationDeclarationIsKnown(params: {\n  primaryContent: PrimaryDestinationContent | undefined;\n  compositeViews: readonly PrimaryDestinationCompositeView[] | undefined;\n}): boolean {\n  const { primaryContent, compositeViews } = params;\n  if (!primaryContent) {\n    return false;\n  }\n  if (primaryContent.contentType === NavigationContentType.COMPOSITE_VIEW) {\n    // A view whose definition has not arrived is indistinguishable from one that declares nothing —\n    // and the two want opposite structural answers, so treat the absence as \"not yet\".\n    return compositeViews?.some((candidate) => candidate.ref === primaryContent.viewRef) ?? false;\n  }\n  return true;\n}\n\n/**\n * Resolve the layout declarations carried by the destination currently in PRIMARY.\n *\n * Returns `undefined` when there is no destination or the destination kind carries no declarations —\n * distinct from returning an empty object, so a caller can tell \"nothing there\" from \"there, and\n * declared nothing\". Both defer to the same defaults today; keeping them distinct costs nothing and\n * makes a future default-by-content-kind expressible.\n */\nexport function resolvePrimaryDestinationLayoutDeclaration(params: {\n  primaryContent: PrimaryDestinationContent | undefined;\n  compositeViews: readonly PrimaryDestinationCompositeView[] | undefined;\n}): PrimaryDestinationLayoutDeclaration | undefined {\n  const { primaryContent, compositeViews } = params;\n  if (!primaryContent) {\n    return undefined;\n  }\n\n  if (primaryContent.contentType === NavigationContentType.RESOURCE_OPERATION) {\n    return primaryContent.resourceContext?.operation?.operationFrontendConfig;\n  }\n\n  if (primaryContent.contentType === NavigationContentType.COMPOSITE_VIEW) {\n    return compositeViews?.find((candidate) => candidate.ref === primaryContent.viewRef);\n  }\n\n  return undefined;\n}\n"]}

package/dist/esm/core/navigation/split-fit.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Does the content area have room for a SPLIT at all?
+ *
+ * ## The principle, and where it comes from
+ *
+ * An OVERLAY already escalates as room runs out: its appearance is viewport-discriminated, so an
+ * author writes `DIALOG` on desktop, `SHEET` on a tablet, `DRAWER` on a phone, and the framework
+ * picks the one the space can carry. The SPLIT has the same ladder — `responsiveCollapse` turns a
+ * pane into a `PUSH` into primary or an `OVERLAY` above it — and until this file it fired on ONE
+ * input: a named viewport breakpoint.
+ *
+ * A breakpoint measures the WINDOW. The panes live in the CONTENT AREA, which is narrower by the
+ * sidebar and narrower still when a companion is already open, when the shell is embedded, or when
+ * the window is merely unusual (a tall narrow column on a wide screen is `DESKTOP`). So a layout
+ * could be handed a content area that cannot carry its own declared minimums while every breakpoint
+ * test said "desktop, split away" — and the geometry layer then made the FLOORS yield, shrinking
+ * both panes below what their author declared rather than escalating. Degrading in place is exactly
+ * what the ladder exists to avoid.
+ *
+ * This is therefore not a new principle; it is the existing one asked of the measurement that is
+ * actually true of the space.
+ *
+ * ## The test
+ *
+ * A split needs the pane's floor plus primary's floor. The pane's floor is its declared `minWidth`
+ * when it has one, and otherwise the same share primary is guaranteed — the rule
+ * `resolveSidePanelBounds` already applies, restated here in PIXELS because that is the unit a
+ * declaration is written in and the unit a container is measured in. Percentages cannot express
+ * "380px does not fit in 600px" without a container to be a percentage OF.
+ *
+ * ## An UNKNOWN width never escalates
+ *
+ * The same reading `resolveCollapseMode` takes for an unmeasured viewport: a width that has not been
+ * measured yet is not a narrow one. Escalating on a missing measurement would collapse every split
+ * for the frames before the first layout pass, which is a layout decision taken from no evidence.
+ */
+/**
+ * The share of the content area PRIMARY is guaranteed, as a fraction.
+ *
+ * Mirrors `MIN_PRIMARY_PERCENT` in `NavigationContentAreas`, which is where the geometry that
+ * HONOURS it lives. Kept as a fraction here because this module reasons in pixels.
+ */
+export declare const MIN_PRIMARY_FRACTION = 0.25;
+/**
+ * Whether a pane of `paneMinWidthPx` can open beside primary in `contentAreaWidth` pixels.
+ *
+ * `contentAreaWidth` of `undefined` or `0` — not yet measured — answers `true`: see the note above.
+ */
+export declare function contentAreaFitsSplit(params: {
+    contentAreaWidth: number | undefined;
+    /** The zone's declared `minWidth`, or `undefined` when it declares none. */
+    paneMinWidthPx: number | undefined;
+    /** Pixels already taken by another adjacent pane that stays open, if any. */
+    occupiedByOtherPanesPx?: number;
+}): boolean;
+//# sourceMappingURL=split-fit.d.ts.map

package/dist/esm/core/navigation/split-fit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-fit.d.ts","sourceRoot":"","sources":["../../../../../src/core/navigation/split-fit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,4EAA4E;IAC5E,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,6EAA6E;IAC7E,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,GAAG,OAAO,CAYV"}

package/dist/esm/core/navigation/split-fit.js

@@ -0,0 +1,61 @@
+/**
+ * Does the content area have room for a SPLIT at all?
+ *
+ * ## The principle, and where it comes from
+ *
+ * An OVERLAY already escalates as room runs out: its appearance is viewport-discriminated, so an
+ * author writes `DIALOG` on desktop, `SHEET` on a tablet, `DRAWER` on a phone, and the framework
+ * picks the one the space can carry. The SPLIT has the same ladder — `responsiveCollapse` turns a
+ * pane into a `PUSH` into primary or an `OVERLAY` above it — and until this file it fired on ONE
+ * input: a named viewport breakpoint.
+ *
+ * A breakpoint measures the WINDOW. The panes live in the CONTENT AREA, which is narrower by the
+ * sidebar and narrower still when a companion is already open, when the shell is embedded, or when
+ * the window is merely unusual (a tall narrow column on a wide screen is `DESKTOP`). So a layout
+ * could be handed a content area that cannot carry its own declared minimums while every breakpoint
+ * test said "desktop, split away" — and the geometry layer then made the FLOORS yield, shrinking
+ * both panes below what their author declared rather than escalating. Degrading in place is exactly
+ * what the ladder exists to avoid.
+ *
+ * This is therefore not a new principle; it is the existing one asked of the measurement that is
+ * actually true of the space.
+ *
+ * ## The test
+ *
+ * A split needs the pane's floor plus primary's floor. The pane's floor is its declared `minWidth`
+ * when it has one, and otherwise the same share primary is guaranteed — the rule
+ * `resolveSidePanelBounds` already applies, restated here in PIXELS because that is the unit a
+ * declaration is written in and the unit a container is measured in. Percentages cannot express
+ * "380px does not fit in 600px" without a container to be a percentage OF.
+ *
+ * ## An UNKNOWN width never escalates
+ *
+ * The same reading `resolveCollapseMode` takes for an unmeasured viewport: a width that has not been
+ * measured yet is not a narrow one. Escalating on a missing measurement would collapse every split
+ * for the frames before the first layout pass, which is a layout decision taken from no evidence.
+ */
+/**
+ * The share of the content area PRIMARY is guaranteed, as a fraction.
+ *
+ * Mirrors `MIN_PRIMARY_PERCENT` in `NavigationContentAreas`, which is where the geometry that
+ * HONOURS it lives. Kept as a fraction here because this module reasons in pixels.
+ */
+export const MIN_PRIMARY_FRACTION = 0.25;
+/**
+ * Whether a pane of `paneMinWidthPx` can open beside primary in `contentAreaWidth` pixels.
+ *
+ * `contentAreaWidth` of `undefined` or `0` — not yet measured — answers `true`: see the note above.
+ */
+export function contentAreaFitsSplit(params) {
+    const { contentAreaWidth, paneMinWidthPx } = params;
+    if (!contentAreaWidth || contentAreaWidth <= 0)
+        return true;
+    const primaryFloorPx = contentAreaWidth * MIN_PRIMARY_FRACTION;
+    // An undeclared pane floor is the same share primary gets — the rule `resolveSidePanelBounds`
+    // applies when a zone declares no `minWidth`, so a zone that declared nothing is not thereby
+    // allowed to open in a space no declared zone could.
+    const paneFloorPx = paneMinWidthPx ?? primaryFloorPx;
+    const occupied = params.occupiedByOtherPanesPx ?? 0;
+    return primaryFloorPx + paneFloorPx + occupied <= contentAreaWidth;
+}
+//# sourceMappingURL=split-fit.js.map

package/dist/esm/core/navigation/split-fit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-fit.js","sourceRoot":"","sources":["../../../../../src/core/navigation/split-fit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAMpC;IACC,MAAM,EAAE,gBAAgB,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IACpD,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5D,MAAM,cAAc,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;IAC/D,8FAA8F;IAC9F,6FAA6F;IAC7F,qDAAqD;IACrD,MAAM,WAAW,GAAG,cAAc,IAAI,cAAc,CAAC;IACrD,MAAM,QAAQ,GAAG,MAAM,CAAC,sBAAsB,IAAI,CAAC,CAAC;IAEpD,OAAO,cAAc,GAAG,WAAW,GAAG,QAAQ,IAAI,gBAAgB,CAAC;AACrE,CAAC","sourcesContent":["/**\n * Does the content area have room for a SPLIT at all?\n *\n * ## The principle, and where it comes from\n *\n * An OVERLAY already escalates as room runs out: its appearance is viewport-discriminated, so an\n * author writes `DIALOG` on desktop, `SHEET` on a tablet, `DRAWER` on a phone, and the framework\n * picks the one the space can carry. The SPLIT has the same ladder — `responsiveCollapse` turns a\n * pane into a `PUSH` into primary or an `OVERLAY` above it — and until this file it fired on ONE\n * input: a named viewport breakpoint.\n *\n * A breakpoint measures the WINDOW. The panes live in the CONTENT AREA, which is narrower by the\n * sidebar and narrower still when a companion is already open, when the shell is embedded, or when\n * the window is merely unusual (a tall narrow column on a wide screen is `DESKTOP`). So a layout\n * could be handed a content area that cannot carry its own declared minimums while every breakpoint\n * test said \"desktop, split away\" — and the geometry layer then made the FLOORS yield, shrinking\n * both panes below what their author declared rather than escalating. Degrading in place is exactly\n * what the ladder exists to avoid.\n *\n * This is therefore not a new principle; it is the existing one asked of the measurement that is\n * actually true of the space.\n *\n * ## The test\n *\n * A split needs the pane's floor plus primary's floor. The pane's floor is its declared `minWidth`\n * when it has one, and otherwise the same share primary is guaranteed — the rule\n * `resolveSidePanelBounds` already applies, restated here in PIXELS because that is the unit a\n * declaration is written in and the unit a container is measured in. Percentages cannot express\n * \"380px does not fit in 600px\" without a container to be a percentage OF.\n *\n * ## An UNKNOWN width never escalates\n *\n * The same reading `resolveCollapseMode` takes for an unmeasured viewport: a width that has not been\n * measured yet is not a narrow one. Escalating on a missing measurement would collapse every split\n * for the frames before the first layout pass, which is a layout decision taken from no evidence.\n */\n\n/**\n * The share of the content area PRIMARY is guaranteed, as a fraction.\n *\n * Mirrors `MIN_PRIMARY_PERCENT` in `NavigationContentAreas`, which is where the geometry that\n * HONOURS it lives. Kept as a fraction here because this module reasons in pixels.\n */\nexport const MIN_PRIMARY_FRACTION = 0.25;\n\n/**\n * Whether a pane of `paneMinWidthPx` can open beside primary in `contentAreaWidth` pixels.\n *\n * `contentAreaWidth` of `undefined` or `0` — not yet measured — answers `true`: see the note above.\n */\nexport function contentAreaFitsSplit(params: {\n  contentAreaWidth: number | undefined;\n  /** The zone's declared `minWidth`, or `undefined` when it declares none. */\n  paneMinWidthPx: number | undefined;\n  /** Pixels already taken by another adjacent pane that stays open, if any. */\n  occupiedByOtherPanesPx?: number;\n}): boolean {\n  const { contentAreaWidth, paneMinWidthPx } = params;\n  if (!contentAreaWidth || contentAreaWidth <= 0) return true;\n\n  const primaryFloorPx = contentAreaWidth * MIN_PRIMARY_FRACTION;\n  // An undeclared pane floor is the same share primary gets — the rule `resolveSidePanelBounds`\n  // applies when a zone declares no `minWidth`, so a zone that declared nothing is not thereby\n  // allowed to open in a space no declared zone could.\n  const paneFloorPx = paneMinWidthPx ?? primaryFloorPx;\n  const occupied = params.occupiedByOtherPanesPx ?? 0;\n\n  return primaryFloorPx + paneFloorPx + occupied <= contentAreaWidth;\n}\n"]}

package/dist/esm/core/navigation/useIsStackEntryActive.d.ts

@@ -1,10 +0,0 @@
-import type { NavigationZone } from './navigation.schemas';
-/**
- * Returns whether a given stack entry is the top (active) entry in its zone.
- *
- * Used by persistent stack rendering to determine visibility — non-top entries
- * are rendered with `display: none` to preserve their React state and avoid
- * re-fetching data on back-navigation.
- */
-export declare function useIsStackEntryActive(entryId: string, zone: NavigationZone): boolean;
-//# sourceMappingURL=useIsStackEntryActive.d.ts.map

package/dist/esm/core/navigation/useIsStackEntryActive.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useIsStackEntryActive.d.ts","sourceRoot":"","sources":["../../../../src/core/navigation/useIsStackEntryActive.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAKpF"}

package/dist/esm/core/navigation/useIsStackEntryActive.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useIsStackEntryActive.js","sourceRoot":"","sources":["../../../../src/core/navigation/useIsStackEntryActive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,IAAoB;IACzE,MAAM,EAAE,YAAY,EAAE,GAAG,kBAAkB,EAAE,CAAC;IAC9C,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7D,OAAO,QAAQ,EAAE,EAAE,KAAK,OAAO,CAAC;AAClC,CAAC","sourcesContent":["import { useNavigationState } from './useNavigationState';\nimport type { NavigationZone } from './navigation.schemas';\n\n/**\n * Returns whether a given stack entry is the top (active) entry in its zone.\n *\n * Used by persistent stack rendering to determine visibility — non-top entries\n * are rendered with `display: none` to preserve their React state and avoid\n * re-fetching data on back-navigation.\n */\nexport function useIsStackEntryActive(entryId: string, zone: NavigationZone): boolean {\n  const { getZoneState } = useNavigationState();\n  const zoneState = getZoneState(zone);\n  const topEntry = zoneState.stack[zoneState.stack.length - 1];\n  return topEntry?.id === entryId;\n}\n"]}

package/dist/esm/core/navigation/useLauncherResolutionContext.d.ts

@@ -12,8 +12,10 @@ import type { LauncherResolutionContext } from './launcher-resolution';
 /**
  * Assembles a `LauncherResolutionContext` from existing React contexts.
  *
- * Returns `null` if the registry isn't loaded yet (callers should treat as
- * not-ready: empty resolved lists or skip rendering until loaded).
+ * Returns `null` if the registry isn't loaded yet, OR if the label bundles its
+ * items are named from have not settled (callers should treat as not-ready:
+ * empty resolved lists or skip rendering until loaded). See the gate below for
+ * why the second condition exists (#1411).
  */
 export declare function useLauncherResolutionContext(): LauncherResolutionContext | null;
 //# sourceMappingURL=useLauncherResolutionContext.d.ts.map

package/dist/esm/core/navigation/useLauncherResolutionContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLauncherResolutionContext.d.ts","sourceRoot":"","sources":["../../../../src/core/navigation/useLauncherResolutionContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAwBvE;;;;;GAKG;AACH,wBAAgB,4BAA4B,IAAI,yBAAyB,GAAG,IAAI,CAoG/E"}
+{"version":3,"file":"useLauncherResolutionContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/navigation/useLauncherResolutionContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAwBvE;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,IAAI,yBAAyB,GAAG,IAAI,CAuH/E"}

package/dist/esm/core/navigation/useLauncherResolutionContext.js

@@ -29,8 +29,10 @@ const ENGINE_PAGE_LABEL_KEYS = Object.values(ENGINE_PAGE_METADATA).map((metadata
 /**
  * Assembles a `LauncherResolutionContext` from existing React contexts.
  *
- * Returns `null` if the registry isn't loaded yet (callers should treat as
- * not-ready: empty resolved lists or skip rendering until loaded).
+ * Returns `null` if the registry isn't loaded yet, OR if the label bundles its
+ * items are named from have not settled (callers should treat as not-ready:
+ * empty resolved lists or skip rendering until loaded). See the gate below for
+ * why the second condition exists (#1411).
  */
 export function useLauncherResolutionContext() {
     const { registry } = useResourceRegistry();
@@ -77,7 +79,7 @@ export function useLauncherResolutionContext() {
             ...resourceViewKeys,
         ]));
     }, [flowsActorsViews, fullCustomViews, registry]);
-    const { t, tResourceHeader, tResourceOperation, tCompositeView, tView, translations } = useI18n({
+    const { t, tResourceHeader, tResourceOperation, tCompositeView, tView, translations, isReady } = useI18n({
         resource: resourceTypes,
         keys: [...compositeLabelKeys, ...viewLabelKeys, ...ENGINE_PAGE_LABEL_KEYS],
     });
@@ -98,6 +100,26 @@ export function useLauncherResolutionContext() {
     return useMemo(() => {
         if (!registry)
             return null;
+        /*
+         * NOT BEFORE THE LABELS. Every item this context resolves takes its visible text from the label
+         * bundles requested above, and until they settle `tViewTitle` / `tResourceOperation` answer `''`.
+         * An item resolved in that window renders as a button with an icon and NO NAME.
+         *
+         * Measured on the Wonder Todos home (#1411): on first paint the sidebar held two items with empty
+         * labels, and one second later five, all named. axe audited inside that window and reported a
+         * CRITICAL `button-name`, and a screen-reader user landing on the page meets exactly what axe did.
+         *
+         * Gated HERE rather than in the sidebar because eight shell surfaces read this context — sidebar,
+         * command menu, toolbar, menubar, control panel, quick action, the user/org menu and the hotkey
+         * handler — and every one of them would otherwise need the same check. Returning `null` is the
+         * contract they already honour for a missing registry. `isReady` settles on a FAILED bundle as
+         * well as a loaded one, so this cannot hold the shell empty forever. A title that stays missing
+         * AFTER settling is the other case, and the resolvers themselves answer it (#1450): the title's
+         * KEY PATH, so the item looks missing rather than being silent, as
+         * `display-text-comes-from-i18n.md` asks.
+         */
+        if (!isReady)
+            return null;
         return {
             registry,
             contextResourceIdentifiers: appScope?.buildContextResourceIdentifiers() ?? {},
@@ -110,6 +132,6 @@ export function useLauncherResolutionContext() {
         };
         // `translations` forces recomputation when i18n data loads — i18n helper
         // closures capture translation data, so the memo must invalidate.
-    }, [registry, appScope, compositeViews, fullCustomViews, flowsActorsViews, tResourceHeader, tResourceOperation, tViewTitle, t, renderIcon, translations]);
+    }, [registry, isReady, appScope, compositeViews, fullCustomViews, flowsActorsViews, tResourceHeader, tResourceOperation, tViewTitle, t, renderIcon, translations]);
 }
 //# sourceMappingURL=useLauncherResolutionContext.js.map

package/dist/esm/core/navigation/useLauncherResolutionContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"useLauncherResolutionContext.js","sourceRoot":"","sources":["../../../../src/core/navigation/useLauncherResolutionContext.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Hook that assembles a `LauncherResolutionContext` from existing React contexts.\n *\n * Per-launcher resolution functions (`resolveSidebarSections`, `resolveCommandMenuCommands`,\n * etc.) are pure functions that need registry, views, i18n, and icon rendering as inputs.\n * This hook collects those from the existing provider tree and returns a stable context object.\n *\n * Used by behavior hooks to call per-launcher resolution functions\n * (e.g., `resolveSidebarSections`, `resolveCommandMenuCommands`).\n */\n\nimport { useMemo } from 'react';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { useIconRegistry } from '~wildo-frontend-lib/core/icons/useIconRegistry';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport type { LauncherResolutionContext } from './launcher-resolution';\nimport { ENGINE_PAGE_METADATA } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport { NavigationContentType } from './navigation.schemas';\nimport {\n  buildCompositeViewLabelKey,\n  buildNavigationViewLabelKey,\n  resolveNavigationViewTitle,\n  buildApplicationViewTranslationRef,\n  buildResourceViewTranslationRef,\n} from './view-title-resolution';\nimport { NavigationViewLabelFamily } from '@wildo-ai/presets-components-models';\n\n/**\n * Engine-page display-label keys, resolved at `engine.pages.<key>.title` (the\n * contract on `EnginePageMetadata.i18nKey`). The launcher context MUST request\n * these so the lazy i18n loader fetches them — `engine.pages.*` is not in\n * `EAGER_I18N_SECTIONS`, so without an explicit request the sidebar renders the\n * raw key (e.g. `engine.pages.securitySettings`). Static + bounded: adding an\n * engine page to `ENGINE_PAGE_METADATA` auto-extends this list.\n */\nconst ENGINE_PAGE_LABEL_KEYS: readonly string[] = Object.values(ENGINE_PAGE_METADATA).map(\n  (metadata) => `${metadata.i18nKey}.title`,\n);\n\n/**\n * Assembles a `LauncherResolutionContext` from existing React contexts.\n *\n * Returns `null` if the registry isn't loaded yet (callers should treat as\n * not-ready: empty resolved lists or skip rendering until loaded).\n */\nexport function useLauncherResolutionContext(): LauncherResolutionContext | null {\n  const { registry } = useResourceRegistry();\n  const { compositeViews, fullCustomViews, flowsActorsViews } = useUI();\n  const appScope = useAppScopeSafe();\n  const resourceTypes = useMemo(\n    () =>\n      registry?.resourceConfigurations\n        ? (Object.keys(registry.resourceConfigurations).filter(\n            rt => registry.resourceConfigurations[rt]?.frontendConfiguration,\n          ) as string[])\n        : [],\n    [registry],\n  );\n  const compositeLabelKeys = useMemo(() => {\n    const applicationCompositeKeys = (compositeViews ?? []).map((view) => (\n      buildCompositeViewLabelKey(view.translationRef)\n    ));\n    const resourceCompositeKeys = registry?.resourceConfigurations\n      ? Object.values(registry.resourceConfigurations).flatMap((resourceConfiguration) => (\n          resourceConfiguration.frontendConfiguration?.compositeViews?.map((view) => (\n            buildCompositeViewLabelKey(view.translationRef)\n          )) ?? []\n        ))\n      : [];\n\n    return Array.from(new Set([\n      ...applicationCompositeKeys,\n      ...resourceCompositeKeys,\n    ]));\n  }, [compositeViews, registry]);\n  const viewLabelKeys = useMemo(() => {\n    const applicationViewKeys = [\n      ...(fullCustomViews ?? []).map((view) => buildNavigationViewLabelKey({\n        family: NavigationViewLabelFamily.FULL_CUSTOM,\n        translationRef: buildApplicationViewTranslationRef(view.ref),\n      })),\n      ...(flowsActorsViews ?? []).map((view) => buildNavigationViewLabelKey({\n        family: NavigationViewLabelFamily.FLOWS_ACTORS,\n        translationRef: buildApplicationViewTranslationRef(view.ref),\n      })),\n    ];\n    const resourceViewKeys = registry?.resourceConfigurations\n      ? Object.entries(registry.resourceConfigurations).flatMap(([resourceType, resourceConfiguration]) => ([\n          ...(resourceConfiguration.frontendConfiguration?.chartViews?.map((view) => buildNavigationViewLabelKey({\n            family: NavigationViewLabelFamily.CHART,\n            translationRef: buildResourceViewTranslationRef(resourceType, view.ref),\n          })) ?? []),\n          ...(resourceConfiguration.frontendConfiguration?.executionViews?.map((view) => buildNavigationViewLabelKey({\n            family: NavigationViewLabelFamily.EXECUTION,\n            translationRef: buildResourceViewTranslationRef(resourceType, view.ref),\n          })) ?? []),\n        ]))\n      : [];\n\n    return Array.from(new Set([\n      ...applicationViewKeys,\n      ...resourceViewKeys,\n    ]));\n  }, [flowsActorsViews, fullCustomViews, registry]);\n  const { t, tResourceHeader, tResourceOperation, tCompositeView, tView, translations } = useI18n({\n    resource: resourceTypes,\n    keys: [...compositeLabelKeys, ...viewLabelKeys, ...ENGINE_PAGE_LABEL_KEYS],\n  });\n  const { renderIcon } = useIconRegistry();\n\n  /**\n   * View title resolver aligned with the authored runtime contracts.\n   *\n   * Composite views resolve through `composite_views.{translationRef}.title`.\n   * Other view families resolve through the dedicated `views.{family}.*`\n   * contract instead of surfacing authored refs or inserted runtime identities.\n   */\n  const tViewTitle = useMemo(\n    () => (viewRef: string, contentType: NavigationContentType): string => (\n      resolveNavigationViewTitle({\n        viewRef,\n        contentType,\n        tCompositeView,\n        tView,\n      })\n    ),\n    [tCompositeView, tView],\n  );\n\n  return useMemo((): LauncherResolutionContext | null => {\n    if (!registry) return null;\n\n    return {\n      registry,\n      contextResourceIdentifiers: appScope?.buildContextResourceIdentifiers() ?? {},\n      views: { compositeViews, fullCustomViews, flowsActorsViews },\n      tResourceHeader,\n      tResourceOperation,\n      tViewTitle,\n      t,\n      renderIcon,\n    };\n  // `translations` forces recomputation when i18n data loads — i18n helper\n  // closures capture translation data, so the memo must invalidate.\n  }, [registry, appScope, compositeViews, fullCustomViews, flowsActorsViews, tResourceHeader, tResourceOperation, tViewTitle, t, renderIcon, translations]);\n}\n"]}
+{"version":3,"file":"useLauncherResolutionContext.js","sourceRoot":"","sources":["../../../../../src/core/navigation/useLauncherResolutionContext.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Hook that assembles a `LauncherResolutionContext` from existing React contexts.\n *\n * Per-launcher resolution functions (`resolveSidebarSections`, `resolveCommandMenuCommands`,\n * etc.) are pure functions that need registry, views, i18n, and icon rendering as inputs.\n * This hook collects those from the existing provider tree and returns a stable context object.\n *\n * Used by behavior hooks to call per-launcher resolution functions\n * (e.g., `resolveSidebarSections`, `resolveCommandMenuCommands`).\n */\n\nimport { useMemo } from 'react';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { useIconRegistry } from '~wildo-frontend-lib/core/icons/useIconRegistry';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport type { LauncherResolutionContext } from './launcher-resolution';\nimport { ENGINE_PAGE_METADATA } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport { NavigationContentType } from './navigation.schemas';\nimport {\n  buildCompositeViewLabelKey,\n  buildNavigationViewLabelKey,\n  resolveNavigationViewTitle,\n  buildApplicationViewTranslationRef,\n  buildResourceViewTranslationRef,\n} from './view-title-resolution';\nimport { NavigationViewLabelFamily } from '@wildo-ai/presets-components-models';\n\n/**\n * Engine-page display-label keys, resolved at `engine.pages.<key>.title` (the\n * contract on `EnginePageMetadata.i18nKey`). The launcher context MUST request\n * these so the lazy i18n loader fetches them — `engine.pages.*` is not in\n * `EAGER_I18N_SECTIONS`, so without an explicit request the sidebar renders the\n * raw key (e.g. `engine.pages.securitySettings`). Static + bounded: adding an\n * engine page to `ENGINE_PAGE_METADATA` auto-extends this list.\n */\nconst ENGINE_PAGE_LABEL_KEYS: readonly string[] = Object.values(ENGINE_PAGE_METADATA).map(\n  (metadata) => `${metadata.i18nKey}.title`,\n);\n\n/**\n * Assembles a `LauncherResolutionContext` from existing React contexts.\n *\n * Returns `null` if the registry isn't loaded yet, OR if the label bundles its\n * items are named from have not settled (callers should treat as not-ready:\n * empty resolved lists or skip rendering until loaded). See the gate below for\n * why the second condition exists (#1411).\n */\nexport function useLauncherResolutionContext(): LauncherResolutionContext | null {\n  const { registry } = useResourceRegistry();\n  const { compositeViews, fullCustomViews, flowsActorsViews } = useUI();\n  const appScope = useAppScopeSafe();\n  const resourceTypes = useMemo(\n    () =>\n      registry?.resourceConfigurations\n        ? (Object.keys(registry.resourceConfigurations).filter(\n            rt => registry.resourceConfigurations[rt]?.frontendConfiguration,\n          ) as string[])\n        : [],\n    [registry],\n  );\n  const compositeLabelKeys = useMemo(() => {\n    const applicationCompositeKeys = (compositeViews ?? []).map((view) => (\n      buildCompositeViewLabelKey(view.translationRef)\n    ));\n    const resourceCompositeKeys = registry?.resourceConfigurations\n      ? Object.values(registry.resourceConfigurations).flatMap((resourceConfiguration) => (\n          resourceConfiguration.frontendConfiguration?.compositeViews?.map((view) => (\n            buildCompositeViewLabelKey(view.translationRef)\n          )) ?? []\n        ))\n      : [];\n\n    return Array.from(new Set([\n      ...applicationCompositeKeys,\n      ...resourceCompositeKeys,\n    ]));\n  }, [compositeViews, registry]);\n  const viewLabelKeys = useMemo(() => {\n    const applicationViewKeys = [\n      ...(fullCustomViews ?? []).map((view) => buildNavigationViewLabelKey({\n        family: NavigationViewLabelFamily.FULL_CUSTOM,\n        translationRef: buildApplicationViewTranslationRef(view.ref),\n      })),\n      ...(flowsActorsViews ?? []).map((view) => buildNavigationViewLabelKey({\n        family: NavigationViewLabelFamily.FLOWS_ACTORS,\n        translationRef: buildApplicationViewTranslationRef(view.ref),\n      })),\n    ];\n    const resourceViewKeys = registry?.resourceConfigurations\n      ? Object.entries(registry.resourceConfigurations).flatMap(([resourceType, resourceConfiguration]) => ([\n          ...(resourceConfiguration.frontendConfiguration?.chartViews?.map((view) => buildNavigationViewLabelKey({\n            family: NavigationViewLabelFamily.CHART,\n            translationRef: buildResourceViewTranslationRef(resourceType, view.ref),\n          })) ?? []),\n          ...(resourceConfiguration.frontendConfiguration?.executionViews?.map((view) => buildNavigationViewLabelKey({\n            family: NavigationViewLabelFamily.EXECUTION,\n            translationRef: buildResourceViewTranslationRef(resourceType, view.ref),\n          })) ?? []),\n        ]))\n      : [];\n\n    return Array.from(new Set([\n      ...applicationViewKeys,\n      ...resourceViewKeys,\n    ]));\n  }, [flowsActorsViews, fullCustomViews, registry]);\n  const { t, tResourceHeader, tResourceOperation, tCompositeView, tView, translations, isReady } = useI18n({\n    resource: resourceTypes,\n    keys: [...compositeLabelKeys, ...viewLabelKeys, ...ENGINE_PAGE_LABEL_KEYS],\n  });\n  const { renderIcon } = useIconRegistry();\n\n  /**\n   * View title resolver aligned with the authored runtime contracts.\n   *\n   * Composite views resolve through `composite_views.{translationRef}.title`.\n   * Other view families resolve through the dedicated `views.{family}.*`\n   * contract instead of surfacing authored refs or inserted runtime identities.\n   */\n  const tViewTitle = useMemo(\n    () => (viewRef: string, contentType: NavigationContentType): string => (\n      resolveNavigationViewTitle({\n        viewRef,\n        contentType,\n        tCompositeView,\n        tView,\n      })\n    ),\n    [tCompositeView, tView],\n  );\n\n  return useMemo((): LauncherResolutionContext | null => {\n    if (!registry) return null;\n    /*\n     * NOT BEFORE THE LABELS. Every item this context resolves takes its visible text from the label\n     * bundles requested above, and until they settle `tViewTitle` / `tResourceOperation` answer `''`.\n     * An item resolved in that window renders as a button with an icon and NO NAME.\n     *\n     * Measured on the Wonder Todos home (#1411): on first paint the sidebar held two items with empty\n     * labels, and one second later five, all named. axe audited inside that window and reported a\n     * CRITICAL `button-name`, and a screen-reader user landing on the page meets exactly what axe did.\n     *\n     * Gated HERE rather than in the sidebar because eight shell surfaces read this context — sidebar,\n     * command menu, toolbar, menubar, control panel, quick action, the user/org menu and the hotkey\n     * handler — and every one of them would otherwise need the same check. Returning `null` is the\n     * contract they already honour for a missing registry. `isReady` settles on a FAILED bundle as\n     * well as a loaded one, so this cannot hold the shell empty forever. A title that stays missing\n     * AFTER settling is the other case, and the resolvers themselves answer it (#1450): the title's\n     * KEY PATH, so the item looks missing rather than being silent, as\n     * `display-text-comes-from-i18n.md` asks.\n     */\n    if (!isReady) return null;\n\n    return {\n      registry,\n      contextResourceIdentifiers: appScope?.buildContextResourceIdentifiers() ?? {},\n      views: { compositeViews, fullCustomViews, flowsActorsViews },\n      tResourceHeader,\n      tResourceOperation,\n      tViewTitle,\n      t,\n      renderIcon,\n    };\n  // `translations` forces recomputation when i18n data loads — i18n helper\n  // closures capture translation data, so the memo must invalidate.\n  }, [registry, isReady, appScope, compositeViews, fullCustomViews, flowsActorsViews, tResourceHeader, tResourceOperation, tViewTitle, t, renderIcon, translations]);\n}\n"]}