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

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;;;;;;;;;;;;;;;;;;;;;;;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"]}

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

@@ -1 +1 @@
-{"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"}
+{"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 +1 @@
-{"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"]}
+{"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.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;;;;;GAKG;AACH,wBAAgB,4BAA4B,IAAI,yBAAyB,GAAG,IAAI,CAoG/E"}

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 (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"]}

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

@@ -37,6 +37,14 @@ export interface NavigateOptions {
      * overrides (including ephemeral/persistent lifecycle modifiers).
      */
     relationshipTransition?: TransitionConfig;
+    /**
+     * `RelationshipDisplayConfig.maxDepth` for the relationship being traversed — the per-relationship
+     * override of `NavigationLayout.maxDepth`.
+     *
+     * Travels beside `relationshipTransition` and for the same reason: only the call site knows which
+     * relationship it is rendering. A nested container passes both from one `config`.
+     */
+    relationshipMaxDepth?: number;
     /**
      * Force the browser URL update to replace the current history entry.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"useNavigationController.d.ts","sourceRoot":"","sources":["../../../../../src/core/navigation/useNavigationController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAUH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iEAAiE,CAAC;AAoBrG,OAAO,EACL,cAAc,EAEd,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAK3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAML,gDAAgD,EAGhD,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAA6B,uCAAuC,EAAE,MAAM,+DAA+D,CAAC;AAQxJ,OAAO,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAsUjH;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,SAAS,EAAE,0BAA0B,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,gBAAgB,CAAC;IAC1C;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IAE7C;;;;;;;;OAQG;IACH,kBAAkB,EAAE,CAAE,eAAe,EAAE,gCAAgC,EAAE,SAAS,EAAE,0BAA0B,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,gBAAgB,KAAM,IAAI,CAAC;IAElL,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IACxC,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,SAAS,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC;IAE7C;;OAEG;IACH,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iCAAiC,+CAAmD,CAAC;AAElG;;;;;;GAMG;AACH,wBAAgB,6BAA6B,IAAI,oBAAoB,CAonBpE;AA8CD,wBAAgB,uBAAuB,IAAI,oBAAoB,CAI9D;AAQD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,SAAS,EAAE,uCAAuC,GAAG,SAAS,EAC9D,mBAAmB,CAAC,EAAE,gDAAgD,EAAE,GACvE,IAAI,CA8PN;AAOD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,WAAW,EAAE,qBAAqB,GACjC,IAAI,CA8IN;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,CAgDhF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,gCAAgC,IAAI,IAAI,CAoGvD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CA0I7C;AAiBD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAwEhD"}
+{"version":3,"file":"useNavigationController.d.ts","sourceRoot":"","sources":["../../../../src/core/navigation/useNavigationController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAUH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iEAAiE,CAAC;AAoBrG,OAAO,EACL,cAAc,EAEd,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAK3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAML,gDAAgD,EAGhD,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAA6B,uCAAuC,EAAE,MAAM,+DAA+D,CAAC;AAQxJ,OAAO,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAsUjH;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,SAAS,EAAE,0BAA0B,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,gBAAgB,CAAC;IAC1C;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;IAE7C;;;;;;;;OAQG;IACH,kBAAkB,EAAE,CAAE,eAAe,EAAE,gCAAgC,EAAE,SAAS,EAAE,0BAA0B,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,gBAAgB,KAAM,IAAI,CAAC;IAElL,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IACxC,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,SAAS,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC;IAE7C;;OAEG;IACH,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iCAAiC,+CAAmD,CAAC;AAElG;;;;;;GAMG;AACH,wBAAgB,6BAA6B,IAAI,oBAAoB,CAyoBpE;AA8CD,wBAAgB,uBAAuB,IAAI,oBAAoB,CAI9D;AAQD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,SAAS,EAAE,uCAAuC,GAAG,SAAS,EAC9D,mBAAmB,CAAC,EAAE,gDAAgD,EAAE,GACvE,IAAI,CA8PN;AAOD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,WAAW,EAAE,qBAAqB,GACjC,IAAI,CA8IN;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,CAgDhF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,gCAAgC,IAAI,IAAI,CAoGvD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CA0I7C;AAiBD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAwEhD"}

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

@@ -347,7 +347,7 @@ export function useGlobalNavigationController() {
     const navigate = useCallback((options) => {
         const requestId = ++latestNavigateRequestIdRef.current;
         void (async () => {
-            let { content, initiator, urlPath, contextResourceIdentifiers, relationshipTransition, replaceBrowserHistory, } = options;
+            let { content, initiator, urlPath, contextResourceIdentifiers, relationshipTransition, relationshipMaxDepth, replaceBrowserHistory, } = options;
             try {
                 logDebug('navigate() called', { contentType: content.contentType, sourceZone: initiator.sourceZone, urlPath });
                 // The Settings Hub is URL-driven: it reconstructs into the overlay from its
@@ -568,10 +568,17 @@ export function useGlobalNavigationController() {
                 const resourceRelationshipDepth = NavigationUtils.isResourceOperationContent(enrichedContent)
                     ? NavigationUtils.calculateResourceRelationshipDepth(enrichedContent.resourceContext.parentResourcesRequirements)
                     : 0;
-                // Compute zone occupancy for SPLIT target heuristic
+                /*
+                 * ONE read of each zone's stack, projected two ways: occupancy for the SPLIT target heuristic,
+                 * and DEPTH for `maxDepth` escalation. Two loops would be two measurements of the same thing at
+                 * two instants, and the boolean cannot be un-flattened back into the number.
+                 */
                 const zoneOccupancy = {};
+                const zoneDepth = {};
                 for (const zone of NAVIGATION_STRUCTURAL_ZONES) {
-                    zoneOccupancy[zone] = getZoneState(zone).stack.length > 0;
+                    const depth = getZoneState(zone).stack.length;
+                    zoneDepth[zone] = depth;
+                    zoneOccupancy[zone] = depth > 0;
                 }
                 // Derive source zone for resolution context — map initiator.sourceZone
                 // to the resolver's expected discriminant (NavigationZoneName | 'appLevel' | 'overlay')
@@ -602,13 +609,20 @@ export function useGlobalNavigationController() {
                     actionPresentationTransition,
                     actionPresentationIsAuthored,
                     relationshipTransition,
+                    relationshipMaxDepth,
                     viewport: currentBreakpoint,
                     zoneOccupancy,
+                    zoneDepth,
                     focusedZone,
                 };
-                // collapsed is available in the result for Phase 3E (NavigationContentAreas rendering)
+                /*
+                 * The resolver APPLIES responsive collapse — `targetZone` and `transition` below are already the
+                 * collapsed outcome. `collapsed` / `collapsedFromZone` are the report, not an instruction: the
+                 * comment here used to say the flag was "available in the result for Phase 3E", and Phase 3E
+                 * never arrived, so for as long as the flag existed nothing acted on it (#411).
+                 */
                 let resolution = navigationPolicyResolver.resolve(resolutionContext, navigationLayout);
-                logDebug('Policy resolved', { targetZone: resolution.targetZone, transition: resolution.transition, appearance: resolution.appearance, collapsed: resolution.collapsed, ephemeral: resolution.ephemeral });
+                logDebug('Policy resolved', { targetZone: resolution.targetZone, transition: resolution.transition, appearance: resolution.appearance, collapsed: resolution.collapsed, collapsedFromZone: resolution.collapsedFromZone, ephemeral: resolution.ephemeral });
                 // ─── INPLACE is NOT a zone outcome — hand it to the element-level host ────────────────────────
                 //
                 // Every other transition places content in a ZONE, and for as long as `INPLACE` was treated as
@@ -721,6 +735,12 @@ export function useGlobalNavigationController() {
                     overlayBehavior: resolution.overlayBehavior,
                     ephemeral: resolution.ephemeral,
                     ...(hostedPane ? { hostedPane: true } : {}),
+                    /*
+                     * Only present when the resolver RETARGETED this placement because the authored zone is
+                     * responsively collapsed at this viewport. It records where the entry belongs, which is the
+                     * one thing a migration back needs and the reason the collapse could not be reversed before.
+                     */
+                    ...(resolution.collapsedFromZone ? { collapsedFromZone: resolution.collapsedFromZone } : {}),
                 };
                 logDebug('Emitting navigation event', { event: resolution.transition === NavigationTransition.PUSH ? 'PUSH' : 'REPLACE', zone: resolution.targetZone, finalUrlPath, hostedPane });
                 if (resolution.transition === NavigationTransition.PUSH) {
@@ -1193,7 +1213,7 @@ export function useViewRouterSync(viewRef, contentType) {
                 content = {
                     contentType: NavigationContentType.FLOWS_ACTORS_VIEW,
                     viewRef,
-                    flowsActorsSystemRefs: flowsActorsView.systemRefs,
+                    flowsActorsSystemRef: flowsActorsView.systemRef,
                 };
                 break;
             case NavigationContentType.EXECUTION_VIEW: