@wildo-ai/saas-frontend-lib 1.1.10 → 1.1.11

package/dist/esm/core/navigation/navigation-cascade.js.map

@@ -1 +1 @@
-{"version":3,"file":"navigation-cascade.js","sourceRoot":"","sources":["../../../../../src/core/navigation/navigation-cascade.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The CASCADING ORCHESTRATOR: what fills the zones a reader did not click.\n *\n * Two functions, one concern. When content lands in an adjacent zone, the zones ABOVE it must show\n * the ancestors that content belongs to, or the reader sees a record with no context beside it —\n * `cascadeAncestorZones` for a record with a parent chain, `cascadeSiblingListIntoPrimary` for a FLAT\n * resource whose detail was split out of primary (#203).\n *\n * Split out of `useNavigationController.ts` on 2026-09-25. It is the ONE piece both halves of that\n * module used — the controller cascades after a click, the router-sync hooks cascade after a deep\n * link — which is why it is its own module rather than living with either.\n */\n\nimport {\n  useNavigate,\n} from 'react-router-dom';\nimport {\n  FrontendEvents,\n} from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport {\n  NavigationZoneState,\n  NavigationContent,\n  NavigationContentType,\n} from './navigation.schemas';\nimport {\n  NavigationTransition,\n  NavigationZoneName,\n  CoreResourceOperation,\n} from '@wildo-ai/saas-models';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport type {\n  FrontendResourcesRegistry,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { NavigationSource } from './navigation.schemas';\nimport { NavigationUtils } from './navigation.utils';\nimport { FrontendResourceUtils, frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { isOperationAddressable } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport {\n  resolveEffectiveCoreOperationFromOperation,\n  getOperationsForCoreSemantic,\n  pickPreferredOperationForCoreSemantic,\n} from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\n\nimport { logDebug, resourceOperationOwnsBrowserUrl, updateBrowserUrl } from './navigation-controller-internals';\n// ================================\n// Cascading Orchestrator\n// ================================\n\n/**\n * Auto-populate ancestor zones when navigating to SECONDARY or COMPANION.\n *\n * When a resource is placed in SECONDARY or COMPANION, its ancestor resources\n * should be visible in the zones above it. This function checks which\n * ancestor zones are empty and populates them with the appropriate content.\n *\n * Rules:\n * - Only cascades for resource operations (not views)\n * - Only populates EMPTY zones (never overwrites user-navigated content)\n * - Uses `parentResourcesRequirements` to determine ancestor chain\n * - Stops at primary scope ancestors (org/user level)\n * - Maximum 2 ancestor zones (PRIMARY + SECONDARY for a COMPANION target)\n */\n/** Put a flat resource's LIST into PRIMARY beside a detail restored into SECONDARY (#203). */\nexport function cascadeSiblingListIntoPrimary(params: {\n  resourceType: string;\n  contextResourceIdentifiers: Record<string, string>;\n  parentResourcesRequirements: FrontendResource_ParentResourceRequirement[];\n  registry: FrontendResourcesRegistry;\n  emit: (event: string, payload: any) => void;\n  getZoneState: (zone: NavigationZoneName) => NavigationZoneState;\n}): void {\n  const { resourceType, contextResourceIdentifiers, parentResourcesRequirements, registry, emit, getZoneState } = params;\n  if (getZoneState(NavigationZoneName.PRIMARY).stack.length > 0) return;\n\n  const resourceConfig = registry.resourceConfigurations?.[resourceType];\n  if (!resourceConfig) return;\n\n  const listContextIdentifiers = { ...contextResourceIdentifiers };\n  delete listContextIdentifiers[resourceType];\n\n  /*\n   * The DEFAULT addressable LIST, picked WITHOUT the context-addressability check.\n   * `pickPreferredOperationForCoreSemanticAddressability` asks \"reachable given the PARENT context\",\n   * which a flat STANDALONE resource can never satisfy — it answers false for an operation that is\n   * plainly addressable and reachable from the sidebar. `allowBulk` is required too: a LIST addresses\n   * a COLLECTION and the semantic filter drops bulk operations by default.\n   */\n  const listOperation = pickPreferredOperationForCoreSemantic(\n    getOperationsForCoreSemantic(resourceConfig.operations ?? [], CoreResourceOperation.LIST, { allowBulk: true })\n      .filter((candidate) => isOperationAddressable(candidate.operationFrontendConfig)),\n    CoreResourceOperation.LIST,\n    { allowBulk: true },\n  );\n  if (!listOperation) return;\n\n  /*\n   * The list's OWN address, which is not the same thing as writing the browser URL.\n   *\n   * This entry was placed address-less under the note \"the browser URL belongs to the DETAIL in\n   * secondary\" — true of who WRITES the URL, and wrong as a reason to leave `urlPath` empty. An\n   * entry's `urlPath` is its ADDRESS, read by everything that asks what a zone holds: `goBack`,\n   * `dismissZone`, `findStructuralRouteOwner`, `zoneOwnsBrowserUrl`. Nothing here writes the\n   * browser URL — this is an emit, and the controller's write lives in `navigate()`.\n   *\n   * Measured on the workbench, 2026-09-25: with the list address-less, `resolveZoneDismissUrl`\n   * found no primary address, wrote nothing, and the pane CLOSED while the URL still named it — so\n   * the next reload reopened it. `goBack` from the last pane had the identical hole, which predates\n   * the dismiss control and is fixed by the same line.\n   */\n  const listUrl = NavigationUtils.resolveResourceUrl(\n    resourceConfig as never,\n    listOperation as never,\n    listContextIdentifiers,\n    registry.allResourceFieldIdentifiers,\n    parentResourcesRequirements as never,\n  )?.resolvedUrl;\n\n  emit(FrontendEvents.NAVIGATION_REPLACE, {\n    zone: NavigationZoneName.PRIMARY,\n    content: {\n      contentType: NavigationContentType.RESOURCE_OPERATION,\n      resourceContext: frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n        resourceType, operation: listOperation,\n        contextResourceIdentifiers: listContextIdentifiers,\n        parentResourcesRequirements,\n      }),\n    },\n    ...(listUrl ? { urlPath: listUrl } : {}),\n    stackEntryId: NavigationUtils.generateStackEntryId(),\n    initiator: { sourceZone: NavigationZoneName.PRIMARY },\n    navigationSource: NavigationSource.URL_SYNC,\n    transition: NavigationTransition.REPLACE,\n  });\n}\n\nexport function cascadeAncestorZones(\n  targetContent: NavigationContent & { contentType: NavigationContentType.RESOURCE_OPERATION },\n  resolvedZone: NavigationZoneName,\n  registry: FrontendResourcesRegistry,\n  contextIdentifiers: Record<string, string>,\n  emit: (event: string, payload: any) => void,\n  routerNavigate: ReturnType<typeof useNavigate> | null,\n  getZoneState: (zone: NavigationZoneName) => NavigationZoneState,\n  options?: {\n    overwriteExisting?: boolean;\n  },\n): void {\n  const parentRequirements = targetContent.resourceContext.parentResourcesRequirements as FrontendResource_ParentResourceRequirement[];\n  if (!parentRequirements || parentRequirements.length === 0) return;\n\n  // Determine which zones need population.\n  // Order matters: zonesToPopulate[i] maps to ancestors[i] (nearest parent first).\n  // For COMPANION target: nearest parent → SECONDARY (adjacent), furthest → PRIMARY (root).\n  // This maintains the master-detail-detail convention: PRIMARY=broadest, COMPANION=most specific.\n  const zonesToPopulate: NavigationZoneName[] = [];\n  if (resolvedZone === NavigationZoneName.SECONDARY) {\n    zonesToPopulate.push(NavigationZoneName.PRIMARY);\n  } else if (resolvedZone === NavigationZoneName.COMPANION) {\n    zonesToPopulate.push(NavigationZoneName.SECONDARY, NavigationZoneName.PRIMARY);\n  }\n\n  if (zonesToPopulate.length === 0) return;\n\n  // parentResourcesRequirements is ordered root → leaf (closest ancestor last).\n  // Reverse to process nearest parent first — nearest maps to adjacent zone.\n  const ancestors = [...parentRequirements].reverse();\n\n  const targetResourceType = targetContent.resourceContext.resourceType;\n\n  for (let i = 0; i < zonesToPopulate.length && i < ancestors.length; i++) {\n    const zone = zonesToPopulate[i];\n    const ancestor = ancestors[i];\n\n    // Skip primary scope ancestors (org, user) — these don't get a zone\n    if (ancestor.isPrimaryScope) continue;\n\n    // Controller-driven cascade keeps existing user context intact, but URL-first\n    // reconstruction is allowed to replace ancestor zones so the visible stack\n    // matches the authoritative browser URL again.\n    const zoneState = getZoneState(zone);\n    if (!options?.overwriteExisting && zoneState.stack.length > 0) continue;\n\n    // Get ancestor resource config\n    const ancestorResourceType = ancestor.resourceType;\n    const ancestorConfig = registry.resourceConfigurations?.[ancestorResourceType];\n    if (!ancestorConfig) continue;\n\n    // Find relationship between ancestor and target (or intermediate child)\n    const childType = ancestor.childResourceType\n      ?? (i === 0 ? targetResourceType : ancestors[i - 1].resourceType);\n    const relationship = NavigationUtils.findRelationshipBetween(\n      ancestorResourceType, childType, registry, ancestor.foreignKeyField\n    );\n\n    // Build parent requirements for the ancestor itself:\n    // The ancestor's parents are those ABOVE it in the chain (root → leaf ordering).\n    // Using slice(0, index) ensures we only include entries before the ancestor,\n    // not entries below it (which are its children/grandchildren, not parents).\n    // Previously used filter(req => req.resourceType !== ancestorResourceType) which\n    // incorrectly kept descendants as parents for non-adjacent ancestors (Bug #1).\n    // `ancestors` is reversed (nearest parent first) but `parentRequirements`\n    // stays root → leaf, so convert back by position instead of looking up by\n    // resource type. Position-based slicing is what keeps repeated/self-ref\n    // parent types from collapsing onto the first matching entry.\n    const ancestorIndex = parentRequirements.length - 1 - i;\n    const ancestorParentReqs = ancestorIndex > 0\n      ? parentRequirements.slice(0, ancestorIndex)\n      : [];\n\n    // Build ancestor resource context\n    const ancestorContextIdentifiers: Record<string, string> = {};\n    for (const req of ancestorParentReqs) {\n      const contextKey = req.foreignKeyField ?? req.resourceType;\n      // Prefer the FK-keyed slot when present. Same-type parent chains store the\n      // parent id under the FK field so the resource-type key can continue to\n      // represent the current record.\n      const id = contextIdentifiers[contextKey] ?? contextIdentifiers[req.resourceType];\n      if (id) {\n        ancestorContextIdentifiers[contextKey] = id;\n      }\n    }\n    const ancestorSelfId = contextIdentifiers[ancestorResourceType];\n    const ancestorSelectionContextIdentifiers = ancestorSelfId\n      ? {\n          ...ancestorContextIdentifiers,\n          [ancestorResourceType]: ancestorSelfId,\n        }\n      : ancestorContextIdentifiers;\n\n    const opConfig = NavigationUtils.resolveAncestorOperationConfig(\n      relationship,\n      ancestorConfig as any,\n      {\n        registry,\n        contextResourceIdentifiers: ancestorSelectionContextIdentifiers,\n        contextualParameters: FrontendResourceUtils.buildContextualParameters(\n          ancestorSelectionContextIdentifiers,\n          registry,\n        ),\n      },\n    );\n    if (!opConfig) continue;\n    const ancestorOp = resolveEffectiveCoreOperationFromOperation(opConfig);\n    if (ancestorSelfId && ancestorOp === CoreResourceOperation.READ) {\n      ancestorContextIdentifiers[ancestorResourceType] = ancestorSelfId;\n    }\n\n    const ancestorResourceContext = frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n      resourceType: ancestorResourceType,\n      operation: opConfig,\n      contextResourceIdentifiers: ancestorContextIdentifiers,\n      parentResourcesRequirements: ancestorParentReqs,\n    });\n\n    const ancestorContent: NavigationContent = {\n      contentType: NavigationContentType.RESOURCE_OPERATION,\n      resourceContext: ancestorResourceContext,\n    };\n\n    // Resolve URL for ancestor — only when the ancestor operation actually\n    // owns a browser URL (declared ADDRESSABLE). Same surface gate as the main\n    // navigate() path: an EMBEDDED ancestor read must not stamp an unroutable\n    // URL onto the revealed zone entry or the browser.\n    let ancestorUrl: string | undefined;\n    if (resourceOperationOwnsBrowserUrl(opConfig)) {\n      const resolved = NavigationUtils.resolveResourceUrl(\n        ancestorConfig as any,\n        opConfig as any,\n        ancestorContextIdentifiers,\n        registry.allResourceFieldIdentifiers,\n        ancestorParentReqs as any,\n      );\n      if (resolved?.resolvedUrl) {\n        ancestorUrl = resolved.resolvedUrl;\n      }\n    }\n\n    const stackEntryId = NavigationUtils.generateStackEntryId();\n    logDebug('cascadeAncestorZones: populating ancestor zone', {\n      zone,\n      ancestorResourceType,\n      ancestorOp,\n      ancestorUrl,\n    });\n    emit(FrontendEvents.NAVIGATION_REPLACE, {\n      zone,\n      content: ancestorContent,\n      urlPath: ancestorUrl,\n      stackEntryId,\n      initiator: { sourceZone: zone },\n      navigationSource: NavigationSource.CONTROLLER,\n      transition: NavigationTransition.REPLACE,\n    });\n\n    // Update URL only for PRIMARY zone ancestor (the URL bar shows PRIMARY)\n    // Skip URL update when routerNavigate is null (reverse cascade from URL sync)\n    if (zone === NavigationZoneName.PRIMARY && ancestorUrl && routerNavigate) {\n      updateBrowserUrl(routerNavigate, ancestorUrl, true);\n    }\n  }\n}"]}
+{"version":3,"file":"navigation-cascade.js","sourceRoot":"","sources":["../../../../../src/core/navigation/navigation-cascade.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The CASCADING ORCHESTRATOR: what fills the zones a reader did not click.\n *\n * Two functions, one concern. When content lands in an adjacent zone, the zones ABOVE it must show\n * the context that content belongs to, or the reader sees a record with nothing beside it.\n * `cascadeAncestorZones` places a record's ANCESTORS. `cascadeSiblingListIntoPrimary` places a record's\n * OWN collection in PRIMARY, in two roles: beside a FLAT resource's detail split out of primary (#203),\n * and in place of an ancestor that PRIMARY cannot hold (#2115, see the PRIMARY rule in the cascade).\n *\n * Split out of `useNavigationController.ts` on 2026-09-25. It is the ONE piece both halves of that\n * module used — the controller cascades after a click, the router-sync hooks cascade after a deep\n * link — which is why it is its own module rather than living with either.\n */\n\nimport {\n  useNavigate,\n} from 'react-router-dom';\nimport {\n  FrontendEvents,\n} from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport {\n  NavigationZoneState,\n  NavigationContent,\n  NavigationContentType,\n} from './navigation.schemas';\nimport {\n  NavigationTransition,\n  NavigationZoneName,\n  CoreResourceOperation,\n} from '@wildo-ai/saas-models';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport type {\n  FrontendResourcesRegistry,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { NavigationSource } from './navigation.schemas';\nimport { NavigationUtils } from './navigation.utils';\nimport { FrontendResourceUtils, frontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { isOperationAddressable } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport {\n  resolveEffectiveCoreOperationFromOperation,\n  getOperationsForCoreSemantic,\n  pickPreferredOperationForCoreSemantic,\n} from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\n\nimport { logDebug, resourceOperationOwnsBrowserUrl, updateBrowserUrl } from './navigation-controller-internals';\n// ================================\n// Cascading Orchestrator\n// ================================\n\n/**\n * Put a record's OWN collection into PRIMARY, in the record's parent context.\n *\n * Two callers, one shape — the list-detail pairing, which the zone-dependency cleanup keeps (a pane\n * beside a collection of its own type):\n *\n * - `useRouterSync`, for a FLAT resource whose detail was restored into SECONDARY (#203) — or, at a width\n *   where that pane is collapsed, pushed into PRIMARY on top of this list;\n * - `cascadeAncestorZones`, in place of an ancestor PRIMARY cannot hold — a collection of another\n *   type, or none at all (#2115).\n *\n * It places nothing when the resource has no configuration or no addressable LIST: PRIMARY then stays\n * empty and renders the route's Outlet. That is the one remaining way to show a record twice, and it\n * needs a resource whose records are reachable while its collection is not.\n */\nexport function cascadeSiblingListIntoPrimary(params: {\n  resourceType: string;\n  contextResourceIdentifiers: Record<string, string>;\n  parentResourcesRequirements: FrontendResource_ParentResourceRequirement[];\n  registry: FrontendResourcesRegistry;\n  emit: (event: string, payload: any) => void;\n  getZoneState: (zone: NavigationZoneName) => NavigationZoneState;\n  /**\n   * Provenance stamped on the emitted event — `URL_SYNC` by default, `CONTROLLER` from the ancestor\n   * cascade, which stamps its own ancestor placements the same way on both paths. Recorded for\n   * diagnostics (the navigation log); nothing branches on it.\n   */\n  navigationSource?: NavigationSource;\n  /**\n   * Replace what PRIMARY holds instead of leaving it alone. The ancestor cascade passes its own\n   * `overwriteExisting` here: a URL-first rebuild REPLACES the ancestor zones so they match the URL, and\n   * this placement stands in for an ancestor, so it must replace too. Without it, stale primary content\n   * would survive a rebuild that every other ancestor placement overwrites.\n   */\n  replaceExisting?: boolean;\n}): void {\n  const { resourceType, contextResourceIdentifiers, parentResourcesRequirements, registry, emit, getZoneState } = params;\n  if (!params.replaceExisting && getZoneState(NavigationZoneName.PRIMARY).stack.length > 0) return;\n\n  const resourceConfig = registry.resourceConfigurations?.[resourceType];\n  if (!resourceConfig) return;\n\n  const listContextIdentifiers = { ...contextResourceIdentifiers };\n  delete listContextIdentifiers[resourceType];\n\n  /*\n   * The DEFAULT addressable LIST, picked WITHOUT the context-addressability check.\n   * `pickPreferredOperationForCoreSemanticAddressability` asks \"reachable given the PARENT context\",\n   * which a flat STANDALONE resource can never satisfy — it answers false for an operation that is\n   * plainly addressable and reachable from the sidebar. For a NESTED resource (the #2115 role) the\n   * parent ids it needs are in `contextResourceIdentifiers`, and the URL below is resolved from them.\n   * `allowBulk` is required too: a LIST addresses a COLLECTION and the semantic filter drops bulk\n   * operations by default.\n   */\n  const listOperation = pickPreferredOperationForCoreSemantic(\n    getOperationsForCoreSemantic(resourceConfig.operations ?? [], CoreResourceOperation.LIST, { allowBulk: true })\n      .filter((candidate) => isOperationAddressable(candidate.operationFrontendConfig)),\n    CoreResourceOperation.LIST,\n    { allowBulk: true },\n  );\n  if (!listOperation) return;\n\n  /*\n   * The list's OWN address, which is not the same thing as writing the browser URL.\n   *\n   * This entry was placed address-less under the note \"the browser URL belongs to the DETAIL in\n   * secondary\" — true of who WRITES the URL, and wrong as a reason to leave `urlPath` empty. An\n   * entry's `urlPath` is its ADDRESS, read by everything that asks what a zone holds: `goBack`,\n   * `dismissZone`, `findStructuralRouteOwner`, `zoneOwnsBrowserUrl`. Nothing here writes the\n   * browser URL — this is an emit, and the controller's write lives in `navigate()`.\n   *\n   * Measured on the workbench, 2026-09-25: with the list address-less, `resolveZoneDismissUrl`\n   * found no primary address, wrote nothing, and the pane CLOSED while the URL still named it — so\n   * the next reload reopened it. `goBack` from the last pane had the identical hole, which predates\n   * the dismiss control and is fixed by the same line.\n   */\n  const listUrl = NavigationUtils.resolveResourceUrl(\n    resourceConfig as never,\n    listOperation as never,\n    listContextIdentifiers,\n    registry.allResourceFieldIdentifiers,\n    parentResourcesRequirements as never,\n  )?.resolvedUrl;\n\n  emit(FrontendEvents.NAVIGATION_REPLACE, {\n    zone: NavigationZoneName.PRIMARY,\n    content: {\n      contentType: NavigationContentType.RESOURCE_OPERATION,\n      resourceContext: frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n        resourceType, operation: listOperation,\n        contextResourceIdentifiers: listContextIdentifiers,\n        parentResourcesRequirements,\n      }),\n    },\n    ...(listUrl ? { urlPath: listUrl } : {}),\n    stackEntryId: NavigationUtils.generateStackEntryId(),\n    initiator: { sourceZone: NavigationZoneName.PRIMARY },\n    navigationSource: params.navigationSource ?? NavigationSource.URL_SYNC,\n    transition: NavigationTransition.REPLACE,\n  });\n}\n\n/**\n * Auto-populate ancestor zones when navigating to SECONDARY or COMPANION.\n *\n * When a resource is placed in SECONDARY or COMPANION, its ancestor resources\n * should be visible in the zones above it.\n *\n * Rules:\n * - Only cascades for resource operations (not views)\n * - Populates EMPTY zones only — unless `overwriteExisting` (URL-first reconstruction), which replaces\n *   them so the visible stack matches the authoritative browser URL\n * - Uses `parentResourcesRequirements` to determine ancestor chain\n * - Stops at primary scope ancestors (org/user level)\n * - Maximum 2 ancestor zones (PRIMARY + SECONDARY for a COMPANION target)\n * - PRIMARY never receives a collection of another type than the pane below it (see the rule in the loop)\n */\nexport function cascadeAncestorZones(\n  targetContent: NavigationContent & { contentType: NavigationContentType.RESOURCE_OPERATION },\n  resolvedZone: NavigationZoneName,\n  registry: FrontendResourcesRegistry,\n  contextIdentifiers: Record<string, string>,\n  emit: (event: string, payload: any) => void,\n  routerNavigate: ReturnType<typeof useNavigate> | null,\n  getZoneState: (zone: NavigationZoneName) => NavigationZoneState,\n  options?: {\n    overwriteExisting?: boolean;\n  },\n): void {\n  const parentRequirements = targetContent.resourceContext.parentResourcesRequirements as FrontendResource_ParentResourceRequirement[];\n  if (!parentRequirements || parentRequirements.length === 0) return;\n\n  // Determine which zones need population.\n  // Order matters: zonesToPopulate[i] maps to ancestors[i] (nearest parent first).\n  // For COMPANION target: nearest parent → SECONDARY (adjacent), furthest → PRIMARY (root).\n  // This maintains the master-detail-detail convention: PRIMARY=broadest, COMPANION=most specific.\n  const zonesToPopulate: NavigationZoneName[] = [];\n  if (resolvedZone === NavigationZoneName.SECONDARY) {\n    zonesToPopulate.push(NavigationZoneName.PRIMARY);\n  } else if (resolvedZone === NavigationZoneName.COMPANION) {\n    zonesToPopulate.push(NavigationZoneName.SECONDARY, NavigationZoneName.PRIMARY);\n  }\n\n  if (zonesToPopulate.length === 0) return;\n\n  // parentResourcesRequirements is ordered root → leaf (closest ancestor last).\n  // Reverse to process nearest parent first — nearest maps to adjacent zone.\n  const ancestors = [...parentRequirements].reverse();\n\n  const targetResourceType = targetContent.resourceContext.resourceType;\n\n  for (let i = 0; i < zonesToPopulate.length && i < ancestors.length; i++) {\n    const zone = zonesToPopulate[i];\n    const ancestor = ancestors[i];\n\n    // Skip primary scope ancestors (org, user) — these don't get a zone\n    if (ancestor.isPrimaryScope) continue;\n\n    // Controller-driven cascade keeps existing user context intact, but URL-first\n    // reconstruction is allowed to replace ancestor zones so the visible stack\n    // matches the authoritative browser URL again.\n    const zoneState = getZoneState(zone);\n    if (!options?.overwriteExisting && zoneState.stack.length > 0) continue;\n\n    // Get ancestor resource config\n    const ancestorResourceType = ancestor.resourceType;\n    const ancestorConfig = registry.resourceConfigurations?.[ancestorResourceType];\n    if (!ancestorConfig) continue;\n\n    // Find relationship between ancestor and target (or intermediate child)\n    const childType = ancestor.childResourceType\n      ?? (i === 0 ? targetResourceType : ancestors[i - 1].resourceType);\n    const relationship = NavigationUtils.findRelationshipBetween(\n      ancestorResourceType, childType, registry, ancestor.foreignKeyField\n    );\n\n    // Build parent requirements for the ancestor itself:\n    // The ancestor's parents are those ABOVE it in the chain (root → leaf ordering).\n    // Using slice(0, index) ensures we only include entries before the ancestor,\n    // not entries below it (which are its children/grandchildren, not parents).\n    // Previously used filter(req => req.resourceType !== ancestorResourceType) which\n    // incorrectly kept descendants as parents for non-adjacent ancestors (Bug #1).\n    // `ancestors` is reversed (nearest parent first) but `parentRequirements`\n    // stays root → leaf, so convert back by position instead of looking up by\n    // resource type. Position-based slicing is what keeps repeated/self-ref\n    // parent types from collapsing onto the first matching entry.\n    const ancestorIndex = parentRequirements.length - 1 - i;\n    const ancestorParentReqs = ancestorIndex > 0\n      ? parentRequirements.slice(0, ancestorIndex)\n      : [];\n\n    // Build ancestor resource context\n    const ancestorContextIdentifiers: Record<string, string> = {};\n    for (const req of ancestorParentReqs) {\n      const contextKey = req.foreignKeyField ?? req.resourceType;\n      // Prefer the FK-keyed slot when present. Same-type parent chains store the\n      // parent id under the FK field so the resource-type key can continue to\n      // represent the current record.\n      const id = contextIdentifiers[contextKey] ?? contextIdentifiers[req.resourceType];\n      if (id) {\n        ancestorContextIdentifiers[contextKey] = id;\n      }\n    }\n    // The ancestor's own id. Its FOREIGN-KEY slot names it whenever the context carries one; the TYPE slot does\n    // only for an ancestor of another type. For a self-referencing ancestor (the target's own type) the type slot\n    // is the TARGET's own id — a self-referencing parent lives in its foreign-key slot (#2143) — so reading it\n    // there placed the record as its own parent (a BACKWARD self-relationship cascades the parent's READ).\n    const ancestorSelfId = (ancestor.foreignKeyField ? contextIdentifiers[ancestor.foreignKeyField] : undefined)\n      ?? (ancestorResourceType !== targetResourceType ? contextIdentifiers[ancestorResourceType] : undefined);\n    const ancestorSelectionContextIdentifiers = ancestorSelfId\n      ? {\n          ...ancestorContextIdentifiers,\n          [ancestorResourceType]: ancestorSelfId,\n        }\n      : ancestorContextIdentifiers;\n\n    const opConfig = NavigationUtils.resolveAncestorOperationConfig(\n      relationship,\n      ancestorConfig as any,\n      {\n        registry,\n        contextResourceIdentifiers: ancestorSelectionContextIdentifiers,\n        contextualParameters: FrontendResourceUtils.buildContextualParameters(\n          ancestorSelectionContextIdentifiers,\n          registry,\n        ),\n      },\n    );\n\n    /*\n     * PRIMARY is what the zone-dependency cleanup measures SECONDARY against (`NavigationContext`, its top\n     * entry only; COMPANION is kept when it belongs to PRIMARY's record or to the SECONDARY record beside\n     * it). A collection in PRIMARY keeps the pane below it only when it holds that pane's OWN type — the\n     * list-detail pairing. A collection of another type (the parent's, when the parent's record has no page\n     * of its own) clears the very pane this cascade is placing it for (#2115). An EMPTY primary is no answer\n     * either: it renders the route's Outlet, which is the same record a second time.\n     *\n     * So the cascade never PLACES such a collection in PRIMARY: it places the pane below's own collection\n     * instead, in that pane's parent context. (It does not police what a reader put there by clicking.) In\n     * SECONDARY (the middle of a three-pane chain) a parent's collection clears nothing — the companion is\n     * still kept by the record in PRIMARY — and the resolver's fallback stands.\n     *\n     * On the click path this placement writes no browser URL, unlike an ancestor placement below: the URL\n     * stays the record's. A deep link writes none either way.\n     *\n     * What this cannot rescue, stated rather than hidden: a pane below whose collection is not addressable\n     * (or that has no configuration). Nothing is placed, PRIMARY stays empty, and it renders the route's\n     * Outlet — the record twice (`cascadeSiblingListIntoPrimary`).\n     */\n    const placesForeignCollectionInPrimary = zone === NavigationZoneName.PRIMARY\n      && (!opConfig || (NavigationUtils.isCollectionOperationContext({ operation: opConfig }) && ancestorResourceType !== childType));\n    if (placesForeignCollectionInPrimary) {\n      // The pane below's parent chain is everything up to and including this ancestor (root → leaf). For the\n      // nearest ancestor that is the record's whole chain.\n      const childParentRequirements = parentRequirements.slice(0, ancestorIndex + 1);\n      const childContextIdentifiers: Record<string, string> = {};\n      for (const req of childParentRequirements) {\n        const contextKey = req.foreignKeyField ?? req.resourceType;\n        const id = contextIdentifiers[contextKey] ?? contextIdentifiers[req.resourceType];\n        if (id) childContextIdentifiers[contextKey] = id;\n      }\n      cascadeSiblingListIntoPrimary({\n        resourceType: childType,\n        contextResourceIdentifiers: childContextIdentifiers,\n        parentResourcesRequirements: childParentRequirements,\n        registry,\n        emit,\n        getZoneState,\n        navigationSource: NavigationSource.CONTROLLER,\n        replaceExisting: !!options?.overwriteExisting,\n      });\n      continue;\n    }\n    if (!opConfig) continue;\n    const ancestorOp = resolveEffectiveCoreOperationFromOperation(opConfig);\n    if (ancestorSelfId && ancestorOp === CoreResourceOperation.READ) {\n      ancestorContextIdentifiers[ancestorResourceType] = ancestorSelfId;\n    }\n\n    const ancestorResourceContext = frontendResourceUtils.createFrontendResourceOperationContextFromOperation({\n      resourceType: ancestorResourceType,\n      operation: opConfig,\n      contextResourceIdentifiers: ancestorContextIdentifiers,\n      parentResourcesRequirements: ancestorParentReqs,\n    });\n\n    const ancestorContent: NavigationContent = {\n      contentType: NavigationContentType.RESOURCE_OPERATION,\n      resourceContext: ancestorResourceContext,\n    };\n\n    // Resolve URL for ancestor — only when the ancestor operation actually\n    // owns a browser URL (declared ADDRESSABLE). Same surface gate as the main\n    // navigate() path: an EMBEDDED ancestor read must not stamp an unroutable\n    // URL onto the revealed zone entry or the browser.\n    let ancestorUrl: string | undefined;\n    if (resourceOperationOwnsBrowserUrl(opConfig)) {\n      const resolved = NavigationUtils.resolveResourceUrl(\n        ancestorConfig as any,\n        opConfig as any,\n        ancestorContextIdentifiers,\n        registry.allResourceFieldIdentifiers,\n        ancestorParentReqs as any,\n      );\n      if (resolved?.resolvedUrl) {\n        ancestorUrl = resolved.resolvedUrl;\n      }\n    }\n\n    const stackEntryId = NavigationUtils.generateStackEntryId();\n    logDebug('cascadeAncestorZones: populating ancestor zone', {\n      zone,\n      ancestorResourceType,\n      ancestorOp,\n      ancestorUrl,\n    });\n    emit(FrontendEvents.NAVIGATION_REPLACE, {\n      zone,\n      content: ancestorContent,\n      urlPath: ancestorUrl,\n      stackEntryId,\n      initiator: { sourceZone: zone },\n      navigationSource: NavigationSource.CONTROLLER,\n      transition: NavigationTransition.REPLACE,\n    });\n\n    // Update URL only for PRIMARY zone ancestor (the URL bar shows PRIMARY)\n    // Skip URL update when routerNavigate is null (reverse cascade from URL sync)\n    if (zone === NavigationZoneName.PRIMARY && ancestorUrl && routerNavigate) {\n      updateBrowserUrl(routerNavigate, ancestorUrl, true);\n    }\n  }\n}"]}

package/dist/esm/core/navigation/navigation-clean-break.frontend.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation-clean-break.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/navigation/navigation-clean-break.frontend.utils.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,0BAA0B,GAClC,sBAAsB,GACtB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,+BAA+B,GAAG,6BAA6B,CAAC;AAE5E,MAAM,MAAM,2BAA2B,GACnC,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,EAC/C,MAAM,EAAE,+BAA+B,GACtC,IAAI,CAGN;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,EAC/C,MAAM,EAAE,0BAA0B,GACjC,IAAI,CAwBN;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CASP;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,2BAA2B,CAAC;CACtC,GAAG,IAAI,CAYP"}
+{"version":3,"file":"navigation-clean-break.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/navigation/navigation-clean-break.frontend.utils.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,0BAA0B,GAClC,sBAAsB,GACtB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,+BAA+B,GAAG,6BAA6B,CAAC;AAE5E,MAAM,MAAM,2BAA2B,GACnC,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,EAC/C,MAAM,EAAE,+BAA+B,GACtC,IAAI,CAGN;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,EAC/C,MAAM,EAAE,0BAA0B,GACjC,IAAI,CAwBN;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CASP;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,2BAA2B,CAAC;CACtC,GAAG,IAAI,CAYP"}

package/dist/esm/core/navigation/navigation-commit.d.ts

@@ -0,0 +1,45 @@
+import type { NavigationZone } from './navigation.schemas';
+/**
+ * The moment a navigation COMMITS: the controller has resolved where content goes and now emits the zone-state event and
+ * updates the browser URL, in one synchronous step. Everything before it (resolution, access checks, context loading) is
+ * asynchronous; this step is not, which is what lets a layout animate BETWEEN the state before and the state after.
+ *
+ * A layout may install ONE wrapper around that step (#2055): the animated 2D layouts' view-transition arrival calls
+ * `document.startViewTransition(() => flushSync(commit))`, so the browser captures the screen before the commit and
+ * after it, and morphs the pressed row into the pane that opened. With no wrapper installed, the commit simply runs.
+ *
+ * Why here and not on the router: React Router's own `viewTransition` option wraps the ROUTER's state update, and the
+ * panes do not follow the router. They follow the zone state this controller emits BEFORE it touches the URL, so a
+ * router-side transition would capture a screen that has already changed.
+ */
+/** Where the committing navigation sends its content. */
+export interface NavigationCommitTarget {
+    /** The zone that receives the content. */
+    zone: NavigationZone;
+}
+/**
+ * Runs `commit` EXACTLY ONCE — now, or within the browser's next frame. A view transition runs its update in the frame
+ * after it captured the screen, so a wrapper may defer the commit that long, never longer; it must never skip it or run
+ * it twice. The navigation has already been decided, and the URL and the zones must not disagree.
+ */
+export type NavigationCommitWrapper = (commit: () => void, target: NavigationCommitTarget) => void;
+/**
+ * How long a wrapper may hold a commit before it runs anyway. A view transition calls its update within a frame, and
+ * also when it is skipped (a hidden tab, another transition); this only catches a wrapper that forgot.
+ */
+export declare const NAVIGATION_COMMIT_MAX_DEFERRAL_MS = 400;
+/**
+ * Installs the wrapper every navigation commit runs through, and returns the function that removes it. One at a time: an
+ * application has one shell layout, so a second install replaces the first, and removing a wrapper that has since been
+ * replaced leaves the newer one in place.
+ */
+export declare function installNavigationCommitWrapper(wrapper: NavigationCommitWrapper): () => void;
+/**
+ * Lands a commit a wrapper is still holding, at once. Called before ANY change to the zone state is applied
+ * (`NavigationContext` applies every navigation event through it), so nothing — a later navigation's clean break, a
+ * dismiss, a back, the router reconciling a URL — can land before an earlier commit and then be undone by it.
+ */
+export declare function flushHeldNavigationCommit(): void;
+/** Runs a navigation's commit through the installed wrapper, or directly when none is installed. */
+export declare function runNavigationCommit(commit: () => void, target: NavigationCommitTarget): void;
+//# sourceMappingURL=navigation-commit.d.ts.map

package/dist/esm/core/navigation/navigation-commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-commit.d.ts","sourceRoot":"","sources":["../../../../../src/core/navigation/navigation-commit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;;;;;;GAYG;AAEH,yDAAyD;AACzD,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,IAAI,EAAE,cAAc,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,MAAM,EAAE,sBAAsB,KAAK,IAAI,CAAC;AAEnG;;;GAGG;AACH,eAAO,MAAM,iCAAiC,MAAM,CAAC;AAMrD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,IAAI,CAK3F;AAQD;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,MAAM,EAAE,sBAAsB,GAAG,IAAI,CA4B5F"}

package/dist/esm/core/navigation/navigation-commit.js

@@ -0,0 +1,68 @@
+/**
+ * How long a wrapper may hold a commit before it runs anyway. A view transition calls its update within a frame, and
+ * also when it is skipped (a hidden tab, another transition); this only catches a wrapper that forgot.
+ */
+export const NAVIGATION_COMMIT_MAX_DEFERRAL_MS = 400;
+let installedWrapper = null;
+/** The commit a wrapper is holding, if any: a newer navigation runs it first, so two navigations never swap order. */
+let heldCommit = null;
+/**
+ * Installs the wrapper every navigation commit runs through, and returns the function that removes it. One at a time: an
+ * application has one shell layout, so a second install replaces the first, and removing a wrapper that has since been
+ * replaced leaves the newer one in place.
+ */
+export function installNavigationCommitWrapper(wrapper) {
+    installedWrapper = wrapper;
+    return () => {
+        if (installedWrapper === wrapper)
+            installedWrapper = null;
+    };
+}
+/*
+ * Two residuals are accepted, both inside the hold (one frame; 400 ms at worst): a controller method that READS the zones
+ * before emitting (a dismiss of a pane not yet landed) sees them before the held commit, and a browser Back pressed in
+ * that frame lets the held commit push its URL after the popstate — the zones end right, and router sync re-applies the
+ * URL. Neither can be reached by a reader acting on what is on screen, since the held pane is not on screen yet.
+ */
+/**
+ * Lands a commit a wrapper is still holding, at once. Called before ANY change to the zone state is applied
+ * (`NavigationContext` applies every navigation event through it), so nothing — a later navigation's clean break, a
+ * dismiss, a back, the router reconciling a URL — can land before an earlier commit and then be undone by it.
+ */
+export function flushHeldNavigationCommit() {
+    heldCommit?.();
+}
+/** Runs a navigation's commit through the installed wrapper, or directly when none is installed. */
+export function runNavigationCommit(commit, target) {
+    // An earlier commit still held by a wrapper lands first: the later navigation must win.
+    flushHeldNavigationCommit();
+    const wrapper = installedWrapper;
+    if (!wrapper) {
+        commit();
+        return;
+    }
+    let committed = false;
+    let safety;
+    const once = () => {
+        if (committed)
+            return;
+        committed = true;
+        if (heldCommit === once)
+            heldCommit = null;
+        clearTimeout(safety);
+        commit();
+    };
+    try {
+        wrapper(once, target);
+    }
+    catch (error) {
+        // A wrapper that threw must not lose the navigation.
+        once();
+        throw error;
+    }
+    if (!committed) {
+        heldCommit = once;
+        safety = setTimeout(once, NAVIGATION_COMMIT_MAX_DEFERRAL_MS);
+    }
+}
+//# sourceMappingURL=navigation-commit.js.map

package/dist/esm/core/navigation/navigation-commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-commit.js","sourceRoot":"","sources":["../../../../../src/core/navigation/navigation-commit.ts"],"names":[],"mappings":"AA6BA;;;GAGG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,GAAG,CAAC;AAErD,IAAI,gBAAgB,GAAmC,IAAI,CAAC;AAC5D,sHAAsH;AACtH,IAAI,UAAU,GAAwB,IAAI,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAAC,OAAgC;IAC7E,gBAAgB,GAAG,OAAO,CAAC;IAC3B,OAAO,GAAG,EAAE;QACV,IAAI,gBAAgB,KAAK,OAAO;YAAE,gBAAgB,GAAG,IAAI,CAAC;IAC5D,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH;;;;GAIG;AACH,MAAM,UAAU,yBAAyB;IACvC,UAAU,EAAE,EAAE,CAAC;AACjB,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,mBAAmB,CAAC,MAAkB,EAAE,MAA8B;IACpF,wFAAwF;IACxF,yBAAyB,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,gBAAgB,CAAC;IACjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,EAAE,CAAC;QACT,OAAO;IACT,CAAC;IACD,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,MAAiD,CAAC;IACtD,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,IAAI,SAAS;YAAE,OAAO;QACtB,SAAS,GAAG,IAAI,CAAC;QACjB,IAAI,UAAU,KAAK,IAAI;YAAE,UAAU,GAAG,IAAI,CAAC;QAC3C,YAAY,CAAC,MAAM,CAAC,CAAC;QACrB,MAAM,EAAE,CAAC;IACX,CAAC,CAAC;IACF,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,qDAAqD;QACrD,IAAI,EAAE,CAAC;QACP,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,UAAU,GAAG,IAAI,CAAC;QAClB,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,iCAAiC,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC","sourcesContent":["import type { NavigationZone } from './navigation.schemas';\n\n/**\n * The moment a navigation COMMITS: the controller has resolved where content goes and now emits the zone-state event and\n * updates the browser URL, in one synchronous step. Everything before it (resolution, access checks, context loading) is\n * asynchronous; this step is not, which is what lets a layout animate BETWEEN the state before and the state after.\n *\n * A layout may install ONE wrapper around that step (#2055): the animated 2D layouts' view-transition arrival calls\n * `document.startViewTransition(() => flushSync(commit))`, so the browser captures the screen before the commit and\n * after it, and morphs the pressed row into the pane that opened. With no wrapper installed, the commit simply runs.\n *\n * Why here and not on the router: React Router's own `viewTransition` option wraps the ROUTER's state update, and the\n * panes do not follow the router. They follow the zone state this controller emits BEFORE it touches the URL, so a\n * router-side transition would capture a screen that has already changed.\n */\n\n/** Where the committing navigation sends its content. */\nexport interface NavigationCommitTarget {\n  /** The zone that receives the content. */\n  zone: NavigationZone;\n}\n\n/**\n * Runs `commit` EXACTLY ONCE — now, or within the browser's next frame. A view transition runs its update in the frame\n * after it captured the screen, so a wrapper may defer the commit that long, never longer; it must never skip it or run\n * it twice. The navigation has already been decided, and the URL and the zones must not disagree.\n */\nexport type NavigationCommitWrapper = (commit: () => void, target: NavigationCommitTarget) => void;\n\n/**\n * How long a wrapper may hold a commit before it runs anyway. A view transition calls its update within a frame, and\n * also when it is skipped (a hidden tab, another transition); this only catches a wrapper that forgot.\n */\nexport const NAVIGATION_COMMIT_MAX_DEFERRAL_MS = 400;\n\nlet installedWrapper: NavigationCommitWrapper | null = null;\n/** The commit a wrapper is holding, if any: a newer navigation runs it first, so two navigations never swap order. */\nlet heldCommit: (() => void) | null = null;\n\n/**\n * Installs the wrapper every navigation commit runs through, and returns the function that removes it. One at a time: an\n * application has one shell layout, so a second install replaces the first, and removing a wrapper that has since been\n * replaced leaves the newer one in place.\n */\nexport function installNavigationCommitWrapper(wrapper: NavigationCommitWrapper): () => void {\n  installedWrapper = wrapper;\n  return () => {\n    if (installedWrapper === wrapper) installedWrapper = null;\n  };\n}\n\n/*\n * Two residuals are accepted, both inside the hold (one frame; 400 ms at worst): a controller method that READS the zones\n * before emitting (a dismiss of a pane not yet landed) sees them before the held commit, and a browser Back pressed in\n * that frame lets the held commit push its URL after the popstate — the zones end right, and router sync re-applies the\n * URL. Neither can be reached by a reader acting on what is on screen, since the held pane is not on screen yet.\n */\n/**\n * Lands a commit a wrapper is still holding, at once. Called before ANY change to the zone state is applied\n * (`NavigationContext` applies every navigation event through it), so nothing — a later navigation's clean break, a\n * dismiss, a back, the router reconciling a URL — can land before an earlier commit and then be undone by it.\n */\nexport function flushHeldNavigationCommit(): void {\n  heldCommit?.();\n}\n\n/** Runs a navigation's commit through the installed wrapper, or directly when none is installed. */\nexport function runNavigationCommit(commit: () => void, target: NavigationCommitTarget): void {\n  // An earlier commit still held by a wrapper lands first: the later navigation must win.\n  flushHeldNavigationCommit();\n  const wrapper = installedWrapper;\n  if (!wrapper) {\n    commit();\n    return;\n  }\n  let committed = false;\n  let safety: ReturnType<typeof setTimeout> | undefined;\n  const once = (): void => {\n    if (committed) return;\n    committed = true;\n    if (heldCommit === once) heldCommit = null;\n    clearTimeout(safety);\n    commit();\n  };\n  try {\n    wrapper(once, target);\n  } catch (error) {\n    // A wrapper that threw must not lose the navigation.\n    once();\n    throw error;\n  }\n  if (!committed) {\n    heldCommit = once;\n    safety = setTimeout(once, NAVIGATION_COMMIT_MAX_DEFERRAL_MS);\n  }\n}\n"]}

package/dist/esm/core/navigation/navigation-controller-internals.d.ts

@@ -1,6 +1,7 @@
 /**
- * The two things every layer of the navigation controller needs, and neither of which belongs to any
- * one of them: the debug channel, and the one function that writes the browser URL.
+ * What every layer of the navigation controller needs and no one layer owns: the debug channel, the one
+ * function that writes the browser URL, and the resolver inputs a resource operation states about itself
+ * (read by the click and by a reload alike, so the two cannot answer differently — #2130).
  *
  * Extracted 2026-09-25 when `useNavigationController.ts` was split — 2,322 lines holding click
  * resolution, URL reconciliation, the ancestor cascade, clean breaks, dismiss and the emit bridge in
@@ -16,7 +17,10 @@
  * router-sync logs — a split is not the moment to change what a diagnostic switch covers.
  */
 import type { useNavigate } from 'react-router-dom';
-import { ResourceOperationFrontendSurface } from '@wildo-ai/saas-models';
+import { NavigationZoneName, ResourceOperationFrontendSurface, type NavigationLayout } from '@wildo-ai/saas-models';
+import { ViewportBreakpoint } from '@wildo-ai/zod-decorators';
+import type { FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas';
+import type { NavigationContent, NavigationResolutionContext } from './navigation.schemas';
 export declare const logDebug: (message: string, context?: Record<string, unknown>) => void;
 /**
  * Update the browser URL via React Router's navigate function, so React Router's
@@ -68,4 +72,51 @@ export declare function resourceOperationOwnsBrowserUrl(operation: {
     };
 } | undefined): boolean;
 export declare function updateBrowserUrl(routerNavigate: ReturnType<typeof useNavigate>, urlPath: string, replace?: boolean): void;
+/**
+ * The resolver inputs a navigation's CONTENT decides on its own: which operation, what it means, which resource,
+ * the surface it declares, its own navigation overrides and its action presentation.
+ *
+ * One derivation, read by the click (`navigate`) and by a reload (`restoredEntryIsPersistent`), so a pane restored
+ * from the URL is resolved from exactly what placed it (#2130). Content that is not a resource operation states
+ * none of them, and is resolved as a LIST.
+ */
+export type OperationResolutionInputs = Pick<NavigationResolutionContext, 'operation' | 'effectiveOperation' | 'resourceType' | 'operationSurface' | 'operationOverrides' | 'actionPresentationTransition' | 'actionPresentationIsAuthored'>;
+export declare function deriveOperationResolutionInputs(content: NavigationContent): OperationResolutionInputs;
+/**
+ * Whether an entry RESTORED from the URL stands for a `persistent` split, and so must carry `persistent` (#2130).
+ *
+ * A click resolves `persistent` from the transition chain, and the entry carries it; the zone-dependency cleanup
+ * then keeps the pane when the page beneath it changes (`NavigationStackEntry.persistent`). A reload rebuilt the pane
+ * from the URL by relationship depth and never asked, so the pane came back without it and the next unrelated
+ * primary navigation closed it — `NAVIGATION_LAYOUT_TRIPLE` (APP_EMAIL, APP_ERP, KIT_WIDESCREEN) ships exactly this.
+ *
+ * So it asks the resolver the question the click asked: the restored content, opened from the zone below the pane it
+ * belongs to (`paneZone`), with those zones occupied and the pane free, at the current viewport. It is persistent
+ * when the resolver says so AND places it where the reload did (`placedZone`) — a pane collapsed into PRIMARY at this
+ * width is placed there by a click too, and carries the flag the same way.
+ *
+ * RECOMPUTED rather than carried in the URL: everything persistence depends on is recoverable — the layout, the
+ * operation's own overrides and action presentation, the viewport — and a URL flag would be a second record of a
+ * fact the configuration already holds, one that survives the configuration changing.
+ *
+ * That includes the RELATIONSHIP's transition (`display.inParentNavigation.transition`, where a relationship declares
+ * a companion pane as `{ transition: SPLIT, persistent: true }`). A click passes it only when the pane was opened from the parent's relationship
+ * section, and no URL says which control opened a pane. But a reload rebuilds the chain THROUGH that relationship:
+ * the ancestor cascade puts the pane's nearest parent in the zone below, found by the same relationship. So the pane
+ * is resolved as opened from that parent's section, which is the chain the reload rebuilds. It is resolved for the
+ * viewport the way the section resolves it (`resolveViewportDiscriminated`, desktop when unmeasured). A pane opened
+ * some other way (a row of a list in the zone below) is restored as if opened through the relationship; the URL
+ * cannot tell the two apart.
+ */
+export declare function restoredEntryIsPersistent(params: {
+    content: NavigationContent;
+    /** The zone the content belongs to — where a click from the zone below would open it. */
+    paneZone: NavigationZoneName;
+    /** The zone the reload actually placed it in (PRIMARY when the pane is collapsed at this width). */
+    placedZone: NavigationZoneName;
+    layout: NavigationLayout | undefined;
+    registry: FrontendResourcesRegistry;
+    viewport: ViewportBreakpoint;
+    contentAreaWidth?: number;
+}): boolean;
 //# sourceMappingURL=navigation-controller-internals.d.ts.map

package/dist/esm/core/navigation/navigation-controller-internals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation-controller-internals.d.ts","sourceRoot":"","sources":["../../../../src/core/navigation/navigation-controller-internals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC;AAOzE,eAAO,MAAM,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAoD,CAAC;AAGpI;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE;IAAE,uBAAuB,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,gCAAgC,CAAA;KAAE,CAAA;CAAE,GAAG,SAAS,GAClG,OAAO,CAIT;AAED,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,EAC9C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAe,GACvB,IAAI,CAUN"}
+{"version":3,"file":"navigation-controller-internals.d.ts","sourceRoot":"","sources":["../../../../../src/core/navigation/navigation-controller-internals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAEL,kBAAkB,EAClB,gCAAgC,EAChC,KAAK,gBAAgB,EAEtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAQ9D,OAAO,KAAK,EAAoC,yBAAyB,EAAE,MAAM,+DAA+D,CAAC;AAEjJ,OAAO,KAAK,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAK3F,eAAO,MAAM,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAoD,CAAC;AAGpI;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE;IAAE,uBAAuB,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,gCAAgC,CAAA;KAAE,CAAA;CAAE,GAAG,SAAS,GAClG,OAAO,CAIT;AAED,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,EAC9C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAe,GACvB,IAAI,CAUN;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,2BAA2B,EAC3B,WAAW,GAAG,oBAAoB,GAAG,cAAc,GAAG,kBAAkB,GAAG,oBAAoB,GAC7F,8BAA8B,GAAG,8BAA8B,CAClE,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,iBAAiB,GAAG,yBAAyB,CAgBrG;AAQD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,yFAAyF;IACzF,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,oGAAoG;IACpG,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACrC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,OAAO,CAmBV"}

package/dist/esm/core/navigation/navigation-controller-internals.js

@@ -1,6 +1,7 @@
 /**
- * The two things every layer of the navigation controller needs, and neither of which belongs to any
- * one of them: the debug channel, and the one function that writes the browser URL.
+ * What every layer of the navigation controller needs and no one layer owns: the debug channel, the one
+ * function that writes the browser URL, and the resolver inputs a resource operation states about itself
+ * (read by the click and by a reload alike, so the two cannot answer differently — #2130).
  *
  * Extracted 2026-09-25 when `useNavigationController.ts` was split — 2,322 lines holding click
  * resolution, URL reconciliation, the ancestor cascade, clean breaks, dismiss and the emit bridge in
@@ -15,8 +16,11 @@
  * own name would be finer-grained and would silently stop every existing toggle from reaching the
  * router-sync logs — a split is not the moment to change what a diagnostic switch covers.
  */
-import { ResourceOperationFrontendSurface } from '@wildo-ai/saas-models';
+import { CoreResourceOperation, NavigationZoneName, ResourceOperationFrontendSurface, } from '@wildo-ai/saas-models';
+import { ViewportBreakpoint } from '@wildo-ai/zod-decorators';
 import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
+import { resolveActionPresentationTransition, resolveEffectiveCoreOperationFromOperation, resolveResourceOperationActionPresentation, } from '../../core/resources/operation-semantics.frontend.utils.js';
+import { navigationPolicyResolver, resolveViewportDiscriminated } from './navigation-policy-resolver.service.js';
 import { NavigationUtils } from './navigation.utils.js';
 const logger = LoggerFrontendService.getLogger();
 export const logDebug = logger.debugByType('useNavigationController');
@@ -81,4 +85,88 @@ export function updateBrowserUrl(routerNavigate, urlPath, replace = false) {
     }
     routerNavigate(urlPath, { replace });
 }
+export function deriveOperationResolutionInputs(content) {
+    if (!NavigationUtils.isResourceOperationContent(content)) {
+        return { operation: CoreResourceOperation.LIST, effectiveOperation: CoreResourceOperation.LIST, actionPresentationIsAuthored: false };
+    }
+    const operation = content.resourceContext.operation;
+    return {
+        operation: operation?.operationIdentifier ?? CoreResourceOperation.LIST,
+        effectiveOperation: resolveEffectiveCoreOperationFromOperation(operation),
+        resourceType: content.resourceContext.resourceType,
+        operationSurface: operation?.operationFrontendConfig?.surface,
+        operationOverrides: operation?.operationFrontendConfig?.navigationOverrides,
+        // The action-presentation ALIAS is read off the operation, never threaded in by a caller: navigation is reached
+        // from several action surfaces, and a parameter would have to be passed correctly by every one of them.
+        actionPresentationTransition: resolveActionPresentationTransition(resolveResourceOperationActionPresentation(operation)),
+        actionPresentationIsAuthored: operation?.operationFrontendConfig?.actionPresentation !== undefined,
+    };
+}
+/** The zone a split INTO `paneZone` was clicked from: the pane opens beside the zone below it. */
+const ZONE_BELOW = {
+    [NavigationZoneName.SECONDARY]: NavigationZoneName.PRIMARY,
+    [NavigationZoneName.COMPANION]: NavigationZoneName.SECONDARY,
+};
+/**
+ * Whether an entry RESTORED from the URL stands for a `persistent` split, and so must carry `persistent` (#2130).
+ *
+ * A click resolves `persistent` from the transition chain, and the entry carries it; the zone-dependency cleanup
+ * then keeps the pane when the page beneath it changes (`NavigationStackEntry.persistent`). A reload rebuilt the pane
+ * from the URL by relationship depth and never asked, so the pane came back without it and the next unrelated
+ * primary navigation closed it — `NAVIGATION_LAYOUT_TRIPLE` (APP_EMAIL, APP_ERP, KIT_WIDESCREEN) ships exactly this.
+ *
+ * So it asks the resolver the question the click asked: the restored content, opened from the zone below the pane it
+ * belongs to (`paneZone`), with those zones occupied and the pane free, at the current viewport. It is persistent
+ * when the resolver says so AND places it where the reload did (`placedZone`) — a pane collapsed into PRIMARY at this
+ * width is placed there by a click too, and carries the flag the same way.
+ *
+ * RECOMPUTED rather than carried in the URL: everything persistence depends on is recoverable — the layout, the
+ * operation's own overrides and action presentation, the viewport — and a URL flag would be a second record of a
+ * fact the configuration already holds, one that survives the configuration changing.
+ *
+ * That includes the RELATIONSHIP's transition (`display.inParentNavigation.transition`, where a relationship declares
+ * a companion pane as `{ transition: SPLIT, persistent: true }`). A click passes it only when the pane was opened from the parent's relationship
+ * section, and no URL says which control opened a pane. But a reload rebuilds the chain THROUGH that relationship:
+ * the ancestor cascade puts the pane's nearest parent in the zone below, found by the same relationship. So the pane
+ * is resolved as opened from that parent's section, which is the chain the reload rebuilds. It is resolved for the
+ * viewport the way the section resolves it (`resolveViewportDiscriminated`, desktop when unmeasured). A pane opened
+ * some other way (a row of a list in the zone below) is restored as if opened through the relationship; the URL
+ * cannot tell the two apart.
+ */
+export function restoredEntryIsPersistent(params) {
+    const clickSource = ZONE_BELOW[params.paneZone];
+    if (!params.layout || !clickSource)
+        return false;
+    const relationshipTransition = NavigationUtils.isResourceOperationContent(params.content)
+        ? resolveRelationshipTransitionFromNearestParent(params.content.resourceContext, params.registry, params.viewport)
+        : undefined;
+    const zoneOccupancy = { [NavigationZoneName.PRIMARY]: true };
+    if (clickSource === NavigationZoneName.SECONDARY)
+        zoneOccupancy[NavigationZoneName.SECONDARY] = true;
+    const resolution = navigationPolicyResolver.resolve({
+        ...deriveOperationResolutionInputs(params.content),
+        relationshipTransition,
+        sourceZone: clickSource,
+        focusedZone: clickSource,
+        viewport: params.viewport,
+        contentAreaWidth: params.contentAreaWidth,
+        zoneOccupancy,
+        zoneDepth: {},
+    }, params.layout);
+    return resolution.persistent === true && resolution.targetZone === params.placedZone;
+}
+/**
+ * The transition the relationship between a restored record and its NEAREST parent declares
+ * (`display.inParentNavigation.transition`), resolved for the viewport as the parent's relationship section resolves
+ * it. `undefined` when the record has no parent requirement or the relationship declares none. A primary-scope
+ * parent (the organization, the user) is skipped: the cascade places no zone for it, so nothing was opened from it.
+ */
+function resolveRelationshipTransitionFromNearestParent(resourceContext, registry, viewport) {
+    const requirements = (resourceContext.parentResourcesRequirements ?? []).filter((requirement) => !requirement.isPrimaryScope);
+    const nearest = requirements[requirements.length - 1];
+    if (!nearest)
+        return undefined;
+    const relationship = NavigationUtils.findRelationshipBetween(nearest.resourceType, resourceContext.resourceType, registry, nearest.foreignKeyField);
+    return resolveViewportDiscriminated(relationship?.display?.inParentNavigation?.transition, viewport ?? ViewportBreakpoint.DESKTOP);
+}
 //# sourceMappingURL=navigation-controller-internals.js.map

package/dist/esm/core/navigation/navigation-controller-internals.js.map

@@ -1 +1 @@
-{"version":3,"file":"navigation-controller-internals.js","sourceRoot":"","sources":["../../../../../src/core/navigation/navigation-controller-internals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,EAAE,CAAC;AAEjD,MAAM,CAAC,MAAM,QAAQ,GAAiE,MAAM,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;AACpI,MAAM,CAAC,mBAAmB,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,+BAA+B,CAC7C,SAAmG;IAEnG,MAAM,OAAO,GAAG,SAAS,EAAE,uBAAuB,EAAE,OAAO,CAAC;IAC5D,OAAO,OAAO,KAAK,gCAAgC,CAAC,QAAQ;WACvD,OAAO,KAAK,gCAAgC,CAAC,QAAQ,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,cAA8C,EAC9C,OAAe,EACf,UAAmB,KAAK;IAExB,gFAAgF;IAChF,gFAAgF;IAChF,6EAA6E;IAC7E,2EAA2E;IAC3E,6BAA6B;IAC7B,IAAI,CAAC,eAAe,CAAC,eAAe,EAAE,EAAE,CAAC;QACvC,eAAe,CAAC,gBAAgB,CAAC,uBAAuB,CAAC,CAAC;IAC5D,CAAC;IACD,cAAc,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AACvC,CAAC","sourcesContent":["/**\n * The two things every layer of the navigation controller needs, and neither of which belongs to any\n * one of them: the debug channel, and the one function that writes the browser URL.\n *\n * Extracted 2026-09-25 when `useNavigationController.ts` was split — 2,322 lines holding click\n * resolution, URL reconciliation, the ancestor cascade, clean breaks, dismiss and the emit bridge in\n * one module. Measured across the seam, the ROUTER-SYNC half used exactly THREE symbols from the\n * controller half (`logDebug` and the two cascade functions), which is what made the split cheap\n * enough to be worth doing at all.\n *\n * ## The debug type name is DELIBERATELY still `useNavigationController`\n *\n * `logger.debugByType` keys on this string, and it is what an operator or a test types to turn the\n * channel on (`setDebugTypeLogging('useNavigationController', true)`). Giving each split module its\n * own name would be finer-grained and would silently stop every existing toggle from reaching the\n * router-sync logs — a split is not the moment to change what a diagnostic switch covers.\n */\n\nimport type { useNavigate } from 'react-router-dom';\n\nimport { ResourceOperationFrontendSurface } from '@wildo-ai/saas-models';\n\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { NavigationUtils } from './navigation.utils';\n\nconst logger = LoggerFrontendService.getLogger();\n\nexport const logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('useNavigationController');\nlogger.setDebugTypeLogging('useNavigationController', false);\n\n/**\n * Update the browser URL via React Router's navigate function, so React Router's\n * `useLocation` hook updates. Everything derived from `useLocation` depends on\n * this: deep-link shareability, back-button state, and the sidebar's\n * most-specific-active highlight (`useSidebarBehavior` reads `useLocation`).\n *\n * ORDERING (why the transaction): the URL→state reconstruction hooks\n * (`useRouterSync`, `useViewRouterSync`, `useEnginePageRouterSync`,\n * `useSettingsHubOverlaySync`) observe `location` changes and rebuild zone state\n * from the URL — UNLESS the target zone already owns the URL, OR a navigation\n * transaction is active. A controller-driven navigation emits the zone-state\n * entry (event bus → `setState`) and THEN changes the URL; if the URL change is\n * observed before that state has committed, those hooks would re-derive stale\n * content (the race the old code papered over). We therefore open (or extend) a\n * navigation transaction so they skip during the commit window and re-validate\n * via their transaction-aware retry once state has committed — by then the\n * emitted entry owns the URL, so they no-op. This mirrors\n * `navigatePathWithFreshStart` / `emitFreshStartNavigationCleanup`, which already\n * pair `beginTransaction` with a synchronous `routerNavigate`.\n *\n * NOT PAINT-GATED (why not requestAnimationFrame): rAF callbacks are throttled to\n * ~0fps in occluded / backgrounded / throttled tabs, so a deferred\n * `routerNavigate` could be stranded indefinitely — zone content (event bus →\n * state) swaps instantly while the URL, sidebar highlight, and back-button state\n * lag until the tab is refocused (reproduced live: composite-view content visible\n * while `location.pathname` stayed stale for 8+ seconds, converging only on tab\n * activation). The transaction guard fills the ordering role rAF was standing in\n * for, without the paint dependency.\n */\n/**\n * Only a resource operation DECLARED `ADDRESSABLE` owns a browser URL.\n *\n * The URL builders are surface-blind — `resolveResourceUrl` happily produces a\n * pattern URL for any URL-bearing variant, including EMBEDDED (notAddressable)\n * ones — but `AppRouter` registers routes for ADDRESSABLE operations only, so\n * writing such a URL to the browser strands refresh / deep-link on the router\n * 404 (seen live 2026-08-19: a breadcrumb click on the EMBEDDED organizations\n * READ rewrote the URL to `/organizations/:id`, a route that does not exist).\n * EMBEDDED content navigates as pure zone/overlay content instead.\n *\n * An `undefined` surface (synthetic/legacy operation objects that never passed\n * through the registry's Step-2.5 posture resolution) keeps the historical\n * URL-writing behavior — only an EXPLICIT non-addressable declaration opts out.\n */\nexport function resourceOperationOwnsBrowserUrl(\n  operation: { operationFrontendConfig?: { surface?: ResourceOperationFrontendSurface } } | undefined,\n): boolean {\n  const surface = operation?.operationFrontendConfig?.surface;\n  return surface !== ResourceOperationFrontendSurface.EMBEDDED\n    && surface !== ResourceOperationFrontendSurface.API_ONLY;\n}\n\nexport function updateBrowserUrl(\n  routerNavigate: ReturnType<typeof useNavigate>,\n  urlPath: string,\n  replace: boolean = false\n): void {\n  // Preserve an in-flight transaction's source label (e.g. 'app_level_navigation'\n  // opened by the APP_LEVEL clean break in navigate()) — only open a fresh window\n  // when none is active (zone-level drill, goBack, non-app-level cascade). The\n  // transaction auto-commits on setTimeout(0), after React has committed the\n  // preceding zone-state emit.\n  if (!NavigationUtils.isInTransaction()) {\n    NavigationUtils.beginTransaction('controller_url_update');\n  }\n  routerNavigate(urlPath, { replace });\n}\n\n"]}
+{"version":3,"file":"navigation-controller-internals.js","sourceRoot":"","sources":["../../../../../src/core/navigation/navigation-controller-internals.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * What every layer of the navigation controller needs and no one layer owns: the debug channel, the one\n * function that writes the browser URL, and the resolver inputs a resource operation states about itself\n * (read by the click and by a reload alike, so the two cannot answer differently — #2130).\n *\n * Extracted 2026-09-25 when `useNavigationController.ts` was split — 2,322 lines holding click\n * resolution, URL reconciliation, the ancestor cascade, clean breaks, dismiss and the emit bridge in\n * one module. Measured across the seam, the ROUTER-SYNC half used exactly THREE symbols from the\n * controller half (`logDebug` and the two cascade functions), which is what made the split cheap\n * enough to be worth doing at all.\n *\n * ## The debug type name is DELIBERATELY still `useNavigationController`\n *\n * `logger.debugByType` keys on this string, and it is what an operator or a test types to turn the\n * channel on (`setDebugTypeLogging('useNavigationController', true)`). Giving each split module its\n * own name would be finer-grained and would silently stop every existing toggle from reaching the\n * router-sync logs — a split is not the moment to change what a diagnostic switch covers.\n */\n\nimport type { useNavigate } from 'react-router-dom';\n\nimport {\n  CoreResourceOperation,\n  NavigationZoneName,\n  ResourceOperationFrontendSurface,\n  type NavigationLayout,\n  type TransitionConfig,\n} from '@wildo-ai/saas-models';\nimport { ViewportBreakpoint } from '@wildo-ai/zod-decorators';\n\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport {\n  resolveActionPresentationTransition,\n  resolveEffectiveCoreOperationFromOperation,\n  resolveResourceOperationActionPresentation,\n} from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport type { FrontendResourceOperationContext, FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { navigationPolicyResolver, resolveViewportDiscriminated } from './navigation-policy-resolver.service';\nimport type { NavigationContent, NavigationResolutionContext } from './navigation.schemas';\nimport { NavigationUtils } from './navigation.utils';\n\nconst logger = LoggerFrontendService.getLogger();\n\nexport const logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('useNavigationController');\nlogger.setDebugTypeLogging('useNavigationController', false);\n\n/**\n * Update the browser URL via React Router's navigate function, so React Router's\n * `useLocation` hook updates. Everything derived from `useLocation` depends on\n * this: deep-link shareability, back-button state, and the sidebar's\n * most-specific-active highlight (`useSidebarBehavior` reads `useLocation`).\n *\n * ORDERING (why the transaction): the URL→state reconstruction hooks\n * (`useRouterSync`, `useViewRouterSync`, `useEnginePageRouterSync`,\n * `useSettingsHubOverlaySync`) observe `location` changes and rebuild zone state\n * from the URL — UNLESS the target zone already owns the URL, OR a navigation\n * transaction is active. A controller-driven navigation emits the zone-state\n * entry (event bus → `setState`) and THEN changes the URL; if the URL change is\n * observed before that state has committed, those hooks would re-derive stale\n * content (the race the old code papered over). We therefore open (or extend) a\n * navigation transaction so they skip during the commit window and re-validate\n * via their transaction-aware retry once state has committed — by then the\n * emitted entry owns the URL, so they no-op. This mirrors\n * `navigatePathWithFreshStart` / `emitFreshStartNavigationCleanup`, which already\n * pair `beginTransaction` with a synchronous `routerNavigate`.\n *\n * NOT PAINT-GATED (why not requestAnimationFrame): rAF callbacks are throttled to\n * ~0fps in occluded / backgrounded / throttled tabs, so a deferred\n * `routerNavigate` could be stranded indefinitely — zone content (event bus →\n * state) swaps instantly while the URL, sidebar highlight, and back-button state\n * lag until the tab is refocused (reproduced live: composite-view content visible\n * while `location.pathname` stayed stale for 8+ seconds, converging only on tab\n * activation). The transaction guard fills the ordering role rAF was standing in\n * for, without the paint dependency.\n */\n/**\n * Only a resource operation DECLARED `ADDRESSABLE` owns a browser URL.\n *\n * The URL builders are surface-blind — `resolveResourceUrl` happily produces a\n * pattern URL for any URL-bearing variant, including EMBEDDED (notAddressable)\n * ones — but `AppRouter` registers routes for ADDRESSABLE operations only, so\n * writing such a URL to the browser strands refresh / deep-link on the router\n * 404 (seen live 2026-08-19: a breadcrumb click on the EMBEDDED organizations\n * READ rewrote the URL to `/organizations/:id`, a route that does not exist).\n * EMBEDDED content navigates as pure zone/overlay content instead.\n *\n * An `undefined` surface (synthetic/legacy operation objects that never passed\n * through the registry's Step-2.5 posture resolution) keeps the historical\n * URL-writing behavior — only an EXPLICIT non-addressable declaration opts out.\n */\nexport function resourceOperationOwnsBrowserUrl(\n  operation: { operationFrontendConfig?: { surface?: ResourceOperationFrontendSurface } } | undefined,\n): boolean {\n  const surface = operation?.operationFrontendConfig?.surface;\n  return surface !== ResourceOperationFrontendSurface.EMBEDDED\n    && surface !== ResourceOperationFrontendSurface.API_ONLY;\n}\n\nexport function updateBrowserUrl(\n  routerNavigate: ReturnType<typeof useNavigate>,\n  urlPath: string,\n  replace: boolean = false\n): void {\n  // Preserve an in-flight transaction's source label (e.g. 'app_level_navigation'\n  // opened by the APP_LEVEL clean break in navigate()) — only open a fresh window\n  // when none is active (zone-level drill, goBack, non-app-level cascade). The\n  // transaction auto-commits on setTimeout(0), after React has committed the\n  // preceding zone-state emit.\n  if (!NavigationUtils.isInTransaction()) {\n    NavigationUtils.beginTransaction('controller_url_update');\n  }\n  routerNavigate(urlPath, { replace });\n}\n\n/**\n * The resolver inputs a navigation's CONTENT decides on its own: which operation, what it means, which resource,\n * the surface it declares, its own navigation overrides and its action presentation.\n *\n * One derivation, read by the click (`navigate`) and by a reload (`restoredEntryIsPersistent`), so a pane restored\n * from the URL is resolved from exactly what placed it (#2130). Content that is not a resource operation states\n * none of them, and is resolved as a LIST.\n */\nexport type OperationResolutionInputs = Pick<\n  NavigationResolutionContext,\n  'operation' | 'effectiveOperation' | 'resourceType' | 'operationSurface' | 'operationOverrides'\n  | 'actionPresentationTransition' | 'actionPresentationIsAuthored'\n>;\n\nexport function deriveOperationResolutionInputs(content: NavigationContent): OperationResolutionInputs {\n  if (!NavigationUtils.isResourceOperationContent(content)) {\n    return { operation: CoreResourceOperation.LIST, effectiveOperation: CoreResourceOperation.LIST, actionPresentationIsAuthored: false };\n  }\n  const operation = content.resourceContext.operation;\n  return {\n    operation: operation?.operationIdentifier ?? CoreResourceOperation.LIST,\n    effectiveOperation: resolveEffectiveCoreOperationFromOperation(operation),\n    resourceType: content.resourceContext.resourceType,\n    operationSurface: operation?.operationFrontendConfig?.surface,\n    operationOverrides: operation?.operationFrontendConfig?.navigationOverrides as NavigationResolutionContext['operationOverrides'],\n    // The action-presentation ALIAS is read off the operation, never threaded in by a caller: navigation is reached\n    // from several action surfaces, and a parameter would have to be passed correctly by every one of them.\n    actionPresentationTransition: resolveActionPresentationTransition(resolveResourceOperationActionPresentation(operation)),\n    actionPresentationIsAuthored: operation?.operationFrontendConfig?.actionPresentation !== undefined,\n  };\n}\n\n/** The zone a split INTO `paneZone` was clicked from: the pane opens beside the zone below it. */\nconst ZONE_BELOW: Partial<Record<NavigationZoneName, NavigationZoneName>> = {\n  [NavigationZoneName.SECONDARY]: NavigationZoneName.PRIMARY,\n  [NavigationZoneName.COMPANION]: NavigationZoneName.SECONDARY,\n};\n\n/**\n * Whether an entry RESTORED from the URL stands for a `persistent` split, and so must carry `persistent` (#2130).\n *\n * A click resolves `persistent` from the transition chain, and the entry carries it; the zone-dependency cleanup\n * then keeps the pane when the page beneath it changes (`NavigationStackEntry.persistent`). A reload rebuilt the pane\n * from the URL by relationship depth and never asked, so the pane came back without it and the next unrelated\n * primary navigation closed it — `NAVIGATION_LAYOUT_TRIPLE` (APP_EMAIL, APP_ERP, KIT_WIDESCREEN) ships exactly this.\n *\n * So it asks the resolver the question the click asked: the restored content, opened from the zone below the pane it\n * belongs to (`paneZone`), with those zones occupied and the pane free, at the current viewport. It is persistent\n * when the resolver says so AND places it where the reload did (`placedZone`) — a pane collapsed into PRIMARY at this\n * width is placed there by a click too, and carries the flag the same way.\n *\n * RECOMPUTED rather than carried in the URL: everything persistence depends on is recoverable — the layout, the\n * operation's own overrides and action presentation, the viewport — and a URL flag would be a second record of a\n * fact the configuration already holds, one that survives the configuration changing.\n *\n * That includes the RELATIONSHIP's transition (`display.inParentNavigation.transition`, where a relationship declares\n * a companion pane as `{ transition: SPLIT, persistent: true }`). A click passes it only when the pane was opened from the parent's relationship\n * section, and no URL says which control opened a pane. But a reload rebuilds the chain THROUGH that relationship:\n * the ancestor cascade puts the pane's nearest parent in the zone below, found by the same relationship. So the pane\n * is resolved as opened from that parent's section, which is the chain the reload rebuilds. It is resolved for the\n * viewport the way the section resolves it (`resolveViewportDiscriminated`, desktop when unmeasured). A pane opened\n * some other way (a row of a list in the zone below) is restored as if opened through the relationship; the URL\n * cannot tell the two apart.\n */\nexport function restoredEntryIsPersistent(params: {\n  content: NavigationContent;\n  /** The zone the content belongs to — where a click from the zone below would open it. */\n  paneZone: NavigationZoneName;\n  /** The zone the reload actually placed it in (PRIMARY when the pane is collapsed at this width). */\n  placedZone: NavigationZoneName;\n  layout: NavigationLayout | undefined;\n  registry: FrontendResourcesRegistry;\n  viewport: ViewportBreakpoint;\n  contentAreaWidth?: number;\n}): boolean {\n  const clickSource = ZONE_BELOW[params.paneZone];\n  if (!params.layout || !clickSource) return false;\n  const relationshipTransition = NavigationUtils.isResourceOperationContent(params.content)\n    ? resolveRelationshipTransitionFromNearestParent(params.content.resourceContext, params.registry, params.viewport)\n    : undefined;\n  const zoneOccupancy: Partial<Record<NavigationZoneName, boolean>> = { [NavigationZoneName.PRIMARY]: true };\n  if (clickSource === NavigationZoneName.SECONDARY) zoneOccupancy[NavigationZoneName.SECONDARY] = true;\n  const resolution = navigationPolicyResolver.resolve({\n    ...deriveOperationResolutionInputs(params.content),\n    relationshipTransition,\n    sourceZone: clickSource,\n    focusedZone: clickSource,\n    viewport: params.viewport,\n    contentAreaWidth: params.contentAreaWidth,\n    zoneOccupancy,\n    zoneDepth: {},\n  }, params.layout);\n  return resolution.persistent === true && resolution.targetZone === params.placedZone;\n}\n\n/**\n * The transition the relationship between a restored record and its NEAREST parent declares\n * (`display.inParentNavigation.transition`), resolved for the viewport as the parent's relationship section resolves\n * it. `undefined` when the record has no parent requirement or the relationship declares none. A primary-scope\n * parent (the organization, the user) is skipped: the cascade places no zone for it, so nothing was opened from it.\n */\nfunction resolveRelationshipTransitionFromNearestParent(\n  resourceContext: FrontendResourceOperationContext,\n  registry: FrontendResourcesRegistry,\n  viewport: ViewportBreakpoint | undefined,\n): TransitionConfig | undefined {\n  const requirements = (resourceContext.parentResourcesRequirements ?? []).filter((requirement) => !requirement.isPrimaryScope);\n  const nearest = requirements[requirements.length - 1];\n  if (!nearest) return undefined;\n  const relationship = NavigationUtils.findRelationshipBetween(nearest.resourceType, resourceContext.resourceType, registry, nearest.foreignKeyField);\n  return resolveViewportDiscriminated(relationship?.display?.inParentNavigation?.transition, viewport ?? ViewportBreakpoint.DESKTOP);\n}\n"]}

package/dist/esm/core/navigation/navigation-policy-resolver.service.d.ts

@@ -38,9 +38,9 @@ import { type NavigationResolutionContext, type NavigationResolutionResult } fro
  *
  * ## An UNDECLARED collapse defaults to PUSH, and that is a decision
  *
- * `NavigationContentAreas` renders a single zone below the mobile breakpoint — secondary and
- * companion are not shown at all. So on a phone a zone with no `responsiveCollapse` is not "left
- * alone": content routed there is placed into a zone that does not render, and the user sees
+ * `NavigationContentAreas` draws only the primary column below the mobile breakpoint — secondary and
+ * companion are collapsed and not shown at all. So on a phone a zone with no `responsiveCollapse` is not
+ * "left alone": content routed there is placed into a zone that does not render, and the user sees
  * nothing happen. That is what an undeclared collapse meant before #411, for every application, and
  * it is not a behaviour anyone would choose deliberately.
  *

package/dist/esm/core/navigation/navigation-policy-resolver.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation-policy-resolver.service.d.ts","sourceRoot":"","sources":["../../../../src/core/navigation/navigation-policy-resolver.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAIL,sBAAsB,EAMtB,KAAK,gBAAgB,EAIrB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAKL,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAChC,MAAM,sBAAsB,CAAC;AAkB9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;IACnC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,sBAAsB,GAAG,SAAS,CAKrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,EAC5C,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,SAAS,EAC3C,QAAQ,EAAE,kBAAkB,GAC3B,CAAC,GAAG,SAAS,CAUf;AAsDD,qBAAa,wBAAwB;IAEnC;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,2BAA2B,EAAE,MAAM,EAAE,gBAAgB,GAAG,0BAA0B;IA0NnG;;;;;;;;;;OAUG;IACH,uBAAuB,CACrB,OAAO,EAAE,2BAA2B,EACpC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,0BAA0B,GACnC,0BAA0B;IAoB7B,OAAO,CAAC,iBAAiB;IA0FzB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAa/B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAavB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAgBlC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,OAAO,CAAC,oBAAoB;IAsB5B;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAO/B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAmC1B;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAavB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAY9B,6DAA6D;IAC7D,OAAO,CAAC,mBAAmB;IA6B3B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,mBAAmB;CAoB5B;AAED,sDAAsD;AACtD,eAAO,MAAM,wBAAwB,0BAAiC,CAAC"}
+{"version":3,"file":"navigation-policy-resolver.service.d.ts","sourceRoot":"","sources":["../../../../../src/core/navigation/navigation-policy-resolver.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAIL,sBAAsB,EAMtB,KAAK,gBAAgB,EAIrB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAKL,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAChC,MAAM,sBAAsB,CAAC;AAkB9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;IACnC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,sBAAsB,GAAG,SAAS,CAKrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,EAC5C,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,SAAS,EAC3C,QAAQ,EAAE,kBAAkB,GAC3B,CAAC,GAAG,SAAS,CAUf;AAsDD,qBAAa,wBAAwB;IAEnC;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,2BAA2B,EAAE,MAAM,EAAE,gBAAgB,GAAG,0BAA0B;IA0NnG;;;;;;;;;;OAUG;IACH,uBAAuB,CACrB,OAAO,EAAE,2BAA2B,EACpC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,0BAA0B,GACnC,0BAA0B;IAoB7B,OAAO,CAAC,iBAAiB;IA0FzB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAa/B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAavB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAgBlC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,OAAO,CAAC,oBAAoB;IAsB5B;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAO/B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAmC1B;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAavB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAY9B,6DAA6D;IAC7D,OAAO,CAAC,mBAAmB;IA6B3B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,mBAAmB;CAoB5B;AAED,sDAAsD;AACtD,eAAO,MAAM,wBAAwB,0BAAiC,CAAC"}

package/dist/esm/core/navigation/navigation-policy-resolver.service.js

@@ -51,9 +51,9 @@ const VIEWPORT_FALLBACK_ORDER = {
  *
  * ## An UNDECLARED collapse defaults to PUSH, and that is a decision
  *
- * `NavigationContentAreas` renders a single zone below the mobile breakpoint — secondary and
- * companion are not shown at all. So on a phone a zone with no `responsiveCollapse` is not "left
- * alone": content routed there is placed into a zone that does not render, and the user sees
+ * `NavigationContentAreas` draws only the primary column below the mobile breakpoint — secondary and
+ * companion are collapsed and not shown at all. So on a phone a zone with no `responsiveCollapse` is not
+ * "left alone": content routed there is placed into a zone that does not render, and the user sees
  * nothing happen. That is what an undeclared collapse meant before #411, for every application, and
  * it is not a behaviour anyone would choose deliberately.
  *