npm - @wildo-ai/saas-frontend-lib - Versions diffs - 1.1.3 → 1.1.5 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2521) hide show

package/dist/esm/core/navigation/navigation.schemas.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"navigation.schemas.js","sourceRoot":"","sources":["../../../../src/core/navigation/navigation.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Navigation — Frontend Runtime Types\n \n Runtime types for zone state, navigation stacks/tabs, events, content,\n * initiator context, and resolution results. These are the types the\n * navigation controller, context, and rendering layer operate on.\n \n Configuration types (what developers configure) live in\n * `@wildo-ai/saas-models` — `navigation.shared.schemas.ts`.\n * This file imports config enums from there and defines runtime state on top.\n \n Key runtime concepts:\n * - NavigationZone: type union = `NavigationZoneName \| 'overlay'` — extends the 3\n * configurable zones with the implicit overlay destination (no enum duplication)\n * - NavigationState: per-zone stack/tab state + separate overlay stack\n * - NavigationResolutionResult: output of the resolver, consumed by the controller\n \n @see _code_archive/docs-archive/navigation/navigation-v3-reflection.md\n /\n\nimport React from 'react';\nimport { z } from 'zod';\nimport {\n NavigationZoneContentModel,\n NavigationTransition,\n NavigationZoneName,\n OverlayAppearance,\n SplitAppearance,\n ParentDisplay,\n ZoneEmptyBehavior,\n type RelationshipDisplayInChildView,\n type TransitionConfig,\n type ViewportDiscriminated,\n} from '@wildo-ai/saas-models';\nimport { ViewportBreakpoint } from '@wildo-ai/zod-decorators';\nimport {\n ApplicationLevelComponentType,\n SidebarItemDisplayPolicy,\n} from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { EnginePageRef } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport type { NavigationOperationOverride, FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport {\n CoreResourceOperation,\n ResourceOperationFrontendSurface,\n type RequiredFeaturesConfig,\n RequiredFeaturesConfigSchema,\n FeatureUnavailabilityBehavior,\n FeatureUnavailabilityReason,\n type FeatureUpgradeOption,\n} from '@wildo-ai/saas-models';\nimport {\n FrontendResourceOperationContextSchema,\n type FrontendResourceOperationContext,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type {\n InsertedChartDeclaration,\n ResolvedInsertedChartDescriptor,\n} from '~wildo-frontend-lib/core/config/chart-view.frontend.schemas';\n\n\n// ════════════════════════════════════════════════════════════════\n// Runtime Enums\n// ════════════════════════════════════════════════════════════════\n\n/\n Runtime zone identifiers — all possible destinations for navigation content.\n \n Extends `NavigationZoneName` (the 3 configurable zones) with `OVERLAY`,\n * which is an implicit runtime destination (not a configurable zone).\n \n Implemented as a const object (spread of `NavigationZoneName` + `OVERLAY`)\n * to avoid duplicating the 3 structural zone values already defined in\n * `NavigationZoneName`. Use `NavigationZone.PRIMARY`, `NavigationZone.OVERLAY`, etc.\n /\nconst OVERLAY_ZONE = 'overlay' as const;\n\nexport const NavigationZone = {\n ...NavigationZoneName,\n /\n Implicit floating layer above all zones. Not a configurable zone —\n * always available as a destination for `overlay` transitions.\n * Content renders as dialog, sheet, or drawer based on the source zone's appearance config.\n /\n OVERLAY: OVERLAY_ZONE,\n} as const;\n\n/* Union of all runtime zone identifiers (3 structural + overlay). /\nexport type NavigationZone = NavigationZoneName \| typeof OVERLAY_ZONE;\n\n/* Zod schema for `NavigationZone` — validates any structural zone name or `'overlay'`. /\nexport const NavigationZoneSchema = z.union([z.enum(NavigationZoneName), z.literal(OVERLAY_ZONE)]);\n\n/\n All structural zones (excludes overlay).\n * Used for iterating over zones that have configuration and state.\n /\nexport const NAVIGATION_STRUCTURAL_ZONES: readonly NavigationZoneName[] = Object.values(NavigationZoneName);\n\n/\n Navigation source for app-shell actions (sidebar, command palette, hotkey, toast, notification).\n * Used alongside `NavigationZone` to form the complete set of navigation origins.\n * App-level navigation causes a layout reset: primary replaced, other zones cleared.\n /\nexport const APP_LEVEL_NAVIGATION_SOURCE = 'appLevel' as const;\n\n/\n What kind of content is being navigated to.\n * Frontend-only — used by navigation stacks, resolution, and content rendering.\n /\nexport enum NavigationContentType {\n RESOURCE_OPERATION = 'resource_operation',\n COMPOSITE_VIEW = 'composite_view',\n CHART_VIEW = 'chart_view',\n FULL_CUSTOM_VIEW = 'full_custom_view',\n FLOWS_ACTORS_VIEW = 'flows_actors_view',\n EXECUTION_VIEW = 'execution_view',\n CUSTOM_COMPONENT = 'custom_component',\n ENGINE_PAGE = 'engine_page',\n SETTINGS_HUB = 'settings_hub',\n INLINE_CREATE = 'inline_create',\n ERROR_MODAL = 'error_modal',\n}\n\n/\n How a navigation entry was created — tracks the origin of each stack entry.\n \n Used to coordinate between controller-initiated (programmatic) and\n * URL-initiated (browser back/forward, direct link) navigation.\n * The controller needs to know if a navigation event came from URL sync\n * to avoid infinite loops (URL change → navigate → URL change → ...).\n /\nexport enum NavigationSource {\n /* Navigation triggered programmatically by useNavigationController. /\n CONTROLLER = 'controller',\n /* Navigation triggered by URL change (bookmark, back button, direct link). /\n URL_SYNC = 'url_sync',\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Initiator Context\n// ════════════════════════════════════════════════════════════════\n\n/\n Lightweight relationship metadata carried on navigation events.\n \n When navigation is triggered by a parent→child relationship traversal\n * (e.g., clicking a related item in a parent's detail view), this carries\n * just enough relationship info for the destination component to configure\n * its parent reference display (breadcrumb, badge, etc.).\n \n Intentionally NOT the full `ResourceRelationship` — avoids importing the\n * entire relationship schema tree into navigation events (Nav-2 decision).\n /\nexport interface NavigationSourceRelationship {\n /* The resource type of the parent in this relationship. /\n parentResourceType: string;\n /* The specific parent instance ID, if navigating from a specific parent record. /\n parentResourceId?: string;\n /* The resource type of the child in this relationship. /\n childResourceType: string;\n /* FK field used to traverse this edge when disambiguation is required. /\n foreignKeyField?: string;\n /* Stable parent→child edge key for navigation-time identity. /\n relationshipEdgeKey?: string;\n /\n The `inChildView` display config from the relationship definition.\n * Controls how the parent reference appears in the child's view (breadcrumb, badge, etc.).\n /\n inChildView?: RelationshipDisplayInChildView;\n}\n\n/\n Source context for a navigation event — WHO triggered the navigation and FROM WHERE.\n \n The resolver uses `sourceZone` as the primary input signal to determine\n * which transition applies. The same operation produces different transitions\n * depending on where the user currently is.\n /\nexport interface NavigationInitiatorContext {\n /\n Where the navigation was triggered from.\n \n - A `NavigationZone` value: navigation from within a structural zone or overlay\n * - `APP_LEVEL_NAVIGATION_SOURCE`: navigation from the app shell (sidebar,\n * command palette, hotkey, toast action, notification click). Causes a layout reset.\n \n This replaces the old `type: NavigationInitiatorType` + `sourcePane: NavigationPane`\n * pattern with a single, explicit field.\n /\n sourceZone: NavigationZone \| typeof APP_LEVEL_NAVIGATION_SOURCE;\n /\n Which app-level launcher triggered the navigation.\n * Only relevant when `sourceZone === APP_LEVEL_NAVIGATION_SOURCE`. Examples: sidebar click,\n * command palette selection, quick action button, hotkey.\n /\n launcher?: ApplicationLevelComponentType;\n /* The operation that produced this navigation (read, create, delete, etc.). /\n sourceOperation?: CoreResourceOperation;\n /\n When navigation was triggered by traversing a parent→child relationship.\n * Carries lightweight relationship info so the destination can configure\n * parent reference display (breadcrumb, badge, summary card).\n /\n sourceRelationship?: NavigationSourceRelationship;\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Navigation Content (discriminated union — what's being shown)\n// ════════════════════════════════════════════════════════════════\n\n/* Content representing a resource operation (list, read, create, etc.). /\nexport interface NavigationContent_ResourceOperation {\n contentType: NavigationContentType.RESOURCE_OPERATION;\n /* Fully resolved resource context: resource type, operation, params, record ID, etc. /\n resourceContext: FrontendResourceOperationContext;\n}\n\n/* Content representing a composite view (dashboard, overview, etc.). /\nexport interface NavigationContent_CompositeView {\n contentType: NavigationContentType.COMPOSITE_VIEW;\n /* Reference identifier for the composite view definition. /\n viewRef: string;\n /* Optional context resource IDs to pass to the view for scoping/filtering. /\n contextResourceIdentifiers?: Record<string, string>;\n}\n\n/* Content representing a chart view (data visualization). /\nexport interface NavigationContent_ChartView {\n contentType: NavigationContentType.CHART_VIEW;\n /* Reference identifier for the chart view definition. /\n viewRef: string;\n /* Optional context resource IDs to scope the chart's data. /\n contextResourceIdentifiers?: Record<string, string>;\n /* Optional route-derived URL params for standalone chart URL_PARAM bindings. /\n urlParamValues?: Record<string, string>;\n /* Optional feature-gating metadata for chart-stack rendering. /\n requiredFeatures?: RequiredFeaturesConfig;\n /* Optional pre-resolved chart surface definition for inserted/routed charts. /\n viewDefinition?: InsertedChartDeclaration;\n /* Optional pre-resolved descriptor for inserted/routed charts. /\n runtimeDescriptor?: ResolvedInsertedChartDescriptor;\n}\n\n/* Content representing a full custom view (developer-provided component). /\nexport interface NavigationContent_FullCustomView {\n contentType: NavigationContentType.FULL_CUSTOM_VIEW;\n /* Reference identifier for the view definition. /\n viewRef: string;\n /* Reference to the custom React component registered for this view. /\n fullCustomComponentRef: string;\n /* Optional context resource IDs to pass to the component. /\n contextResourceIdentifiers?: Record<string, string>;\n}\n\n/* Content representing a flows & actors view (AI workflows, agent execution). /\nexport interface NavigationContent_FlowsActorsView {\n contentType: NavigationContentType.FLOWS_ACTORS_VIEW;\n /* Reference identifier for the view definition. /\n viewRef: string;\n /* The flows/actors system this view displays. /\n flowsActorsSystemRef: string;\n /* Optional context resource IDs to scope the view. /\n contextResourceIdentifiers?: Record<string, string>;\n}\n\n/* Content representing an execution view (framework-owned execution host). /\nexport interface NavigationContent_ExecutionView {\n contentType: NavigationContentType.EXECUTION_VIEW;\n /* Reference identifier for the execution view definition. /\n viewRef: string;\n /* Optional context resource IDs to scope the execution view. /\n contextResourceIdentifiers?: Record<string, string>;\n}\n\n/* Content representing a generic app-level custom component. /\nexport interface NavigationContent_CustomComponent {\n contentType: NavigationContentType.CUSTOM_COMPONENT;\n /* Registered component reference to materialize. /\n componentRef: string;\n /* Optional context resource IDs to pass to the component. /\n contextResourceIdentifiers?: Record<string, string>;\n}\n\n/* Content representing a router-backed engine page. /\nexport interface NavigationContent_EnginePage {\n contentType: NavigationContentType.ENGINE_PAGE;\n pageRef: EnginePageRef;\n}\n\n/\n Content representing the unified Settings Hub.\n \n Always rendered in the overlay zone (DIALOG appearance, persistent — NOT\n * ephemeral, so it survives source-zone changes and closes only on explicit\n * dismiss). The optional `sectionRef` pre-selects which section opens; when\n * omitted the hub opens at its default section. URL-addressable via\n * `/settings/:sectionRef`.\n /\nexport interface NavigationContent_SettingsHub {\n contentType: NavigationContentType.SETTINGS_HUB;\n sectionRef?: string;\n}\n\n/* Content representing a typed sidebar inline-create flow. /\nexport interface NavigationContent_InlineCreate {\n contentType: NavigationContentType.INLINE_CREATE;\n resourceContext: FrontendResourceOperationContext;\n defaultValues: Record<string, unknown>;\n}\n\n/* Content representing an error modal pushed through the overlay stack. /\nexport interface NavigationContent_ErrorModal {\n contentType: NavigationContentType.ERROR_MODAL;\n errorType: string;\n message: string;\n context?: Record<string, unknown>;\n wildoError?: unknown;\n}\n\n/\n Discriminated union of all navigation content types.\n * Discriminated on `contentType` for clean narrowing.\n * Every navigation stack entry carries exactly one of these.\n /\nexport type NavigationContent =\n \| NavigationContent_ResourceOperation\n \| NavigationContent_CompositeView\n \| NavigationContent_ChartView\n \| NavigationContent_FullCustomView\n \| NavigationContent_FlowsActorsView\n \| NavigationContent_ExecutionView\n \| NavigationContent_CustomComponent\n \| NavigationContent_EnginePage\n \| NavigationContent_SettingsHub\n \| NavigationContent_InlineCreate\n \| NavigationContent_ErrorModal;\n\n\n// ════════════════════════════════════════════════════════════════\n// Navigation Stack Entry\n// ════════════════════════════════════════════════════════════════\n\n/\n A single entry in a zone's navigation stack (or overlay stack).\n \n Each entry represents one piece of content that was navigated to.\n * The stack maintains navigation history within a zone for back navigation.\n * In tabbed zones, entries represent parallel tabs (not a depth stack).\n /\nexport interface NavigationStackEntry {\n /* Unique identifier for this stack entry (UUID). /\n id: string;\n /* The content being displayed in this entry. /\n content: NavigationContent;\n /\n URL path that represents this navigation state.\n * Used for URL serialization, deep linking, and browser history.\n * Every navigation state must be URL-addressable.\n /\n urlPath?: string;\n /* Timestamp (ms since epoch) when this entry was created. For ordering and debugging. /\n timestamp: number;\n /* Which zone this entry lives in. /\n zone: NavigationZone;\n /* The context that triggered this navigation (source zone, operation, relationship). /\n initiator?: NavigationInitiatorContext;\n /* Whether this entry was created by the controller or by URL sync. /\n navigationSource: NavigationSource;\n /\n The transition verb that placed this entry (push, replace, split, overlay, promote).\n * Note: `inplace` does not produce a stack entry (it transforms an element in the\n * current view without changing zone state), so it will never appear here.\n /\n transition: NavigationTransition;\n /\n Visual appearance for this entry's transition.\n * Set by the resolver from zone appearance config. Only meaningful for\n * overlay entries (dialog/sheet/drawer) and split entries (panel/drawer).\n * Used by ContentAreas to decide how to render overlay or split content.\n /\n appearance?: OverlayAppearance \| SplitAppearance;\n /\n Behaviour of an OVERLAY entry: is the page behind interactive, does touching it dismiss, is it\n * dimmed. Three independent questions, and a companion panel needs all three answered — see\n * `OverlayContainerConfig`, whose fields these feed.\n \n Declared per operation because it is a property of the CONTENT, not of the zone: one application\n * legitimately has a create dialog that blocks everything and a detail sheet beside a live canvas\n * that blocks nothing.\n /\n overlayBehavior?: {\n /* Block interaction with the page behind. Default `true`. /\n modal?: boolean;\n /* Dismiss when the page behind is clicked. Default `true`. /\n closeOnOutsideClick?: boolean;\n /* Dim the page behind. Default `true`. /\n showBackdrop?: boolean;\n };\n /\n When `true`, this overlay entry auto-closes when the source zone's stack changes.\n * Set by the resolver from `TransitionConfig.ephemeral`. Only valid on overlay entries.\n * Used by NavigationContext auto-close logic.\n /\n ephemeral?: boolean;\n /\n `true` when this SECONDARY entry was opened beside a primary whose address the pane's own URL\n * cannot re-derive (a composite view, a canvas, a chart, an engine page), so the browser URL is\n * the HOST's address carrying this entry as `?pane=` — see `HOSTED_PANE_QUERY_PARAM` in\n * `hosted-pane.constants.ts`.\n \n Three readers key on it, and each needs it for a different reason: the zone-dependency cleanup\n * keeps a hosted pane beside a primary it cannot otherwise relate to (the relevance rule is\n * relationship-aware and a composite view has no relationships); the URL reconciler closes the\n * pane when the `pane` parameter leaves the URL (browser back); and the route-owner lookup never\n * lets a hosted entry claim a BARE browser URL, because its address is only ever reachable in the\n * composed form.\n /\n hostedPane?: boolean;\n /\n The zone this entry was AUTHORED for, when a responsive collapse placed it somewhere else.\n \n A `secondary` split on a phone lands in PRIMARY (under `ResponsiveCollapseMode.PUSH`) or in\n * OVERLAY (under `OVERLAY`), and `zone` above records where it actually IS. This records where it\n * belongs, so widening the viewport can migrate it back — the behaviour `ResponsiveCollapseMode`\n * documents and, before #411, nothing implemented because nothing recorded the origin.\n \n Absent on every entry that was placed where it was authored, which is the common case.\n /\n collapsedFromZone?: NavigationZoneName;\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Zone State (runtime)\n// ════════════════════════════════════════════════════════════════\n\n/\n Runtime state of a single navigation zone.\n \n Each zone independently tracks its navigation stack and visibility.\n * For tabbed zones, `activeTabId` identifies which tab is currently displayed.\n \n Zone lifecycle states (not an enum — derived from config + runtime):\n * - Inactive: zone not declared in config. Doesn't exist in DOM.\n * - Hidden: zone exists but not visible (`defaultVisible: false`, collapsed, `onEmpty: ZoneEmptyBehavior.COLLAPSE`).\n * - Empty: zone visible but no content. Only when `onEmpty: 'emptyState'`.\n * - Active: zone has content and is visible.\n /\nexport interface NavigationZoneState {\n /* Which zone this state belongs to. /\n zone: NavigationZone;\n /\n The zone's navigation stack.\n * - In `single` content model: depth stack. Top entry is visible. Back pops.\n * - In `NavigationZoneContentModel.TABBED` content model: tab entries. All are \"open\", one is active.\n /\n stack: NavigationStackEntry[];\n /\n Whether this zone is currently rendered in the DOM and visible.\n * `false` when: zone is collapsed (responsive), empty with `onEmpty: ZoneEmptyBehavior.COLLAPSE`,\n * or `defaultVisible: false` and no content has been pushed yet.\n /\n isVisible: boolean;\n /\n For `NavigationZoneContentModel.TABBED` zones — the ID of the currently active tab entry.\n * References `NavigationStackEntry.id`. When `undefined`, the zone is in single mode.\n * Using ID (not index) for stability when tabs are reordered or closed.\n /\n activeTabId?: string;\n}\n\n/\n Full runtime navigation state.\n \n Zones hold their own stack/tab state keyed by `NavigationZoneName` (the 3 structural\n * zones). Overlay is separate because it's not a configurable zone — it's an implicit\n * floating layer that can hold a stack of its own (push within overlay).\n /\nexport interface NavigationState {\n /\n Per-zone state for the 3 structural zones (primary, secondary, companion).\n * Keyed by `NavigationZoneName` — NOT `NavigationZone` (which includes overlay).\n /\n zones: Record<NavigationZoneName, NavigationZoneState>;\n /\n Overlay stack — content shown in the floating layer above all zones.\n * Supports push depth within the overlay (e.g., navigating to a related item\n * from within a create dialog pushes onto the overlay stack).\n * When the stack empties, the overlay dismisses.\n /\n overlay: NavigationStackEntry[];\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Resolution Result (output of the resolver)\n// ════════════════════════════════════════════════════════════════\n\n/\n Output of the navigation policy resolver — tells the controller exactly what to do.\n \n The resolver takes (sourceZone, operation, resourceConfig, viewport) as inputs\n * and produces this result by walking the resolution chain:\n * 1. Per-resource operation override\n * 2. Per-relationship inParentNavigation.transition\n * 3. Global viewport override\n * 4. Source zone's transitions[operation]\n * 5. Framework fallback\n /\nexport interface NavigationResolutionResult {\n /* Which zone the content should be placed in. /\n targetZone: NavigationZone;\n /* The transition verb to apply. /\n transition: NavigationTransition;\n /\n Visual appearance for the transition. Only meaningful for:\n * - `overlay` transitions: `OverlayAppearance` (dialog, sheet, or drawer)\n * - `split` transitions: `SplitAppearance` (panel or drawer)\n * `undefined` for `push`, `replace`, `inplace`, and `promote`\n * (`push`/`replace`/`promote` fill the zone; `inplace` transforms an element).\n /\n appearance?: OverlayAppearance \| SplitAppearance;\n /\n Behaviour of an OVERLAY entry: is the page behind interactive, does touching it dismiss, is it\n * dimmed. Three independent questions, and a companion panel needs all three answered — see\n * `OverlayContainerConfig`, whose fields these feed.\n \n Declared per operation because it is a property of the CONTENT, not of the zone: one application\n * legitimately has a create dialog that blocks everything and a detail sheet beside a live canvas\n * that blocks nothing.\n /\n overlayBehavior?: {\n /* Block interaction with the page behind. Default `true`. /\n modal?: boolean;\n /* Dismiss when the page behind is clicked. Default `true`. /\n closeOnOutsideClick?: boolean;\n /* Dim the page behind. Default `true`. /\n showBackdrop?: boolean;\n };\n /\n Whether this placement IS a responsive collapse — the zone the content was headed for is\n * collapsed at this viewport, so `targetZone` and `transition` above are already the collapsed\n * outcome (PRIMARY + push, or OVERLAY + overlay) rather than the authored one.\n \n It is a REPORT, not an instruction. It said the opposite until 2026-09-08 (#411) — \"the\n * controller should apply the zone's `responsiveCollapse` behavior\" — and no controller ever did,\n * which is exactly how the mechanism stayed inert for as long as it existed. The resolver applies\n * it now, because placement is what the resolver answers.\n \n What it is still FOR: telling a collapsed placement apart from an authored one. A collapsed\n * SPLIT and an authored PUSH produce an identical `targetZone`/`transition` pair, and only this\n * flag (with `collapsedFromZone`) distinguishes them.\n /\n collapsed: boolean;\n /\n The zone this content was headed for before the collapse retargeted it — `secondary` or\n * `companion`. Present only when `collapsed` is `true`.\n \n `ResponsiveCollapseMode`'s contract is that \"when viewport grows back past the breakpoint,\n * collapsed content migrates back to its original zone\", and an entry cannot migrate back to a\n * zone nothing recorded. The controller writes this onto the stack entry as\n * `NavigationStackEntry.collapsedFromZone`.\n /\n collapsedFromZone?: NavigationZoneName;\n /\n When `true`, this overlay entry should auto-close when its source zone's stack changes.\n * Derived from `TransitionConfig.ephemeral`. Only meaningful for overlay transitions.\n * The controller writes this to `NavigationStackEntry.ephemeral`.\n /\n ephemeral?: boolean;\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Resolution Context (input to the resolver)\n// ════════════════════════════════════════════════════════════════\n\n/\n Input to the navigation policy resolver — all the contextual signals needed\n * to determine which transition + zone + appearance to use.\n \n Three fundamentally different source types select different config paths:\n * - `NavigationZoneName`: structural zone → reads `layout.zones[zone].transitions`\n * - `'appLevel'`: app shell (sidebar, command palette) → reads `layout.appLevel.transitions`\n * - `'overlay'`: from within an overlay → reads `layout.fromOverlay.transitions`\n /\nexport interface NavigationResolutionContext {\n /\n Where the navigation was triggered from. Determines which config\n * branch the resolver reads transitions from.\n /\n sourceZone: NavigationZoneName \| typeof APP_LEVEL_NAVIGATION_SOURCE \| 'overlay';\n /* The operation being performed (read, create, list, update, etc.). /\n operation: CoreResourceOperation \| string;\n /\n Semantic core operation for custom operations that behave like a framework\n * core surface. Transition maps are keyed by core semantics, so resolvers must\n * use this field instead of raw custom operation identifiers.\n /\n effectiveOperation?: CoreResourceOperation;\n /* Resource type being navigated to (for per-resource override matching). /\n resourceType?: string;\n /\n The target operation's declared frontend surface (resource content only).\n * This is the channel that keeps navigation policy surface-aware: the\n * resolver coerces EMBEDDED content away from PRIMARY (embedded views open\n * in a HOST — overlay/pane — never as the page), and the controller refuses\n * API_ONLY content outright. Replaces a former `isAddressable` boolean that\n * was populated but read by nothing (dead channel, removed 2026-08-19).\n /\n operationSurface?: ResourceOperationFrontendSurface;\n /* Per-resource operation overrides (from resource operationFrontendConfig). First match wins. /\n operationOverrides?: NavigationOperationOverride[];\n /\n The transition the target operation's ACTION PRESENTATION resolves to, when it resolves to one\n * at all — `MODAL` → `OVERLAY`, `PAGE` → nothing (the ordinary chain answers).\n \n The presentation axis is an ALIAS over this chain, never a parallel mechanism: it lets an author\n * say \"an overlay\" without naming a zone, a verb and an appearance. `DIRECT`, `POPOVER` and\n * `INLINE` do not navigate at all, so on their normal path they never reach here; `POPOVER` and\n * `INLINE` supply an `OVERLAY` only as the DEGRADE for a host that cannot anchor or has no\n * element to transform.\n /\n actionPresentationTransition?: TransitionConfig;\n /\n Was the presentation AUTHORED, or derived by the framework?\n \n It decides precedence, and the distinction is load-bearing. An authored presentation is a\n * statement about this operation and outranks the app's relationship- and zone-level navigation\n * defaults. A DERIVED one is the framework's guess and must yield to every configuration an app\n * actually wrote — otherwise introducing the derivation would silently restyle navigation that\n * apps had already tuned.\n /\n actionPresentationIsAuthored?: boolean;\n /\n Full transition config from the relationship's\n * `display.inParentNavigation.transition`.\n * Preserves lifecycle modifiers (ephemeral/persistent). `undefined` when\n * navigation is not relationship-driven.\n /\n relationshipTransition?: TransitionConfig;\n /* Current viewport breakpoint for responsive resolution. /\n viewport: ViewportBreakpoint;\n /* Which structural zones currently have content. Used for SPLIT target heuristic. /\n zoneOccupancy: Partial<Record<NavigationZoneName, boolean>>;\n /\n Current stack DEPTH per structural zone — what `NavigationLayout.maxDepth` is measured against.\n \n Distinct from `zoneOccupancy`, which is this same measurement flattened to a boolean. Both are\n * projected from ONE read of the zone state in the controller, so they cannot disagree; the depth\n * exists separately because \"does the zone hold anything\" and \"how deep is it\" are different\n * questions and the second cannot be recovered from the first.\n /\n zoneDepth: Partial<Record<NavigationZoneName, number>>;\n /\n `RelationshipDisplayConfig.maxDepth` for the relationship that triggered this navigation, when\n * one did — the per-relationship override of the layout's global `maxDepth`.\n \n Supplied by the caller alongside `relationshipTransition`, because the relationship's display\n * config is a fact about the CALL SITE (a nested container knows which relationship it renders)\n * and the resolver has no way to recover it from a resource type and an operation.\n /\n relationshipMaxDepth?: number;\n /* Currently focused zone — tiebreaker for SPLIT target selection. /\n focusedZone?: NavigationZoneName;\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Feature Availability (for navigation items)\n// ════════════════════════════════════════════════════════════════\n\n/\n Lightweight feature availability status attached to navigation items.\n \n Used by sidebar, command menu, and toolbar to communicate feature gating\n * status to UI components (lock icons, disabled state, upgrade prompts).\n * Subset of the full `FeatureAvailability` from the features system.\n /\nexport interface NavigationFeatureAvailability {\n /* Whether the feature is currently available to the user. /\n isAvailable: boolean;\n /* Why the feature is unavailable (plan limit, not enabled, etc.). /\n reason?: FeatureUnavailabilityReason;\n /* How the UI should respond to unavailability (disable, hide, show upgrade). /\n behavior: FeatureUnavailabilityBehavior;\n /* Feature IDs that are missing/required for this item. /\n missingFeatures?: string[];\n /* Limit details when the feature is gated by usage limits. /\n limitInfo?: { featureId: string; current: number; limit: number };\n /* Available upgrade options to unlock this feature. /\n upgradeOptions?: FeatureUpgradeOption[];\n /* Suggested product reference for upgrade CTAs. /\n suggestedProductRef?: string;\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Navigation Item Types (app-level sidebar, command menu, etc.)\n// ════════════════════════════════════════════════════════════════\n\n/\n Discriminator for navigation item variants.\n * Navigation items appear in the sidebar, command menu, and toolbar.\n /\nexport enum NavigationItemType {\n /* A navigable resource operation (list, read, create for a resource type). /\n RESOURCE = 'resource',\n /* A navigable view (composite, chart, custom, flows/actors). /\n VIEW = 'view',\n /* A navigable framework-owned engine page (home, security settings). /\n ENGINE_PAGE = 'engine_page',\n /* A navigable generic custom component. /\n CUSTOM_COMPONENT = 'custom_component',\n /* Opens the unified Settings Hub (overlay) at an optional section. /\n SETTINGS_HUB = 'settings_hub',\n}\n\n/* Subset of `NavigationContentType` for view-based navigation items. /\nexport type ViewNavigationContentType =\n \| NavigationContentType.COMPOSITE_VIEW\n \| NavigationContentType.CHART_VIEW\n \| NavigationContentType.FULL_CUSTOM_VIEW\n \| NavigationContentType.FLOWS_ACTORS_VIEW\n \| NavigationContentType.EXECUTION_VIEW;\n\n/\n Shared fields across all navigation item variants.\n * Populated by per-launcher resolution (`launcher-resolution.ts`) and behavior\n * hooks from declared launcher content and resource/view definitions.\n /\nexport interface NavigationItemBase {\n /* Unique identifier for this item (typically resourceType or viewRef based). /\n id: string;\n /* Stable reference for configuration matching (not display-specific). /\n ref: string;\n /* Display label for the item. /\n label: string;\n /* URL path for this item's destination. /\n urlPath: string;\n /* Optional icon React node for sidebar/toolbar rendering. /\n icon?: React.ReactNode;\n /* Section reference for grouping (e.g., 'main', 'tools', 'settings'). /\n section?: string;\n /* Sidebar display policy (always visible, collapsible, etc.). /\n displayPolicy?: SidebarItemDisplayPolicy;\n /* Badge KEY (`<scope>:<identifier>`) naming a registered notification-badge definition (see `SidebarItem`). /\n notificationBadgeRef?: string;\n /* Keyboard shortcut hint displayed in UI (e.g., \"⌘K\"). /\n shortcut?: string;\n /* Additional search keywords for command menu filtering. /\n searchKeywords?: string[];\n /* Parent item reference for hierarchical nesting in sidebar. /\n parentItemRef?: string;\n /* Whether this item has children and can be collapsed. /\n isCollapsible?: boolean;\n /* Category for command menu grouping. /\n commandCategory?: string;\n /* Whether to render as icon-only (no label) in compact modes. /\n iconOnly?: boolean;\n\n /* Whether this item is disabled (feature gating, permissions, etc.). /\n disabled?: boolean;\n /* Whether this item shows a lock indicator (feature-locked but visible). /\n featureLocked?: boolean;\n /* Feature availability details when `featureLocked` or `disabled` due to features. /\n featureAvailability?: NavigationFeatureAvailability;\n}\n\n/\n Resource navigation item — a navigable resource operation in app-level components.\n * Discriminated by `itemType: NavigationItemType.RESOURCE`.\n /\nexport interface ResourceNavigationItem extends NavigationItemBase {\n itemType: NavigationItemType.RESOURCE;\n /* The resource type identifier (e.g., 'project', 'task'). /\n resourceType: string;\n /* The operation identifier within the resource config (e.g., 'list', 'create'). /\n operationIdentifier: string;\n /* The full operation configuration from the resource. /\n operation: FrontendResourceConfiguration_Operation;\n /* Pre-built resource context for navigation dispatch. /\n resourceContext: FrontendResourceOperationContext;\n}\n\n/\n View navigation item — a navigable view in app-level components.\n * Discriminated by `itemType: NavigationItemType.VIEW`.\n /\nexport interface ViewNavigationItem extends NavigationItemBase {\n itemType: NavigationItemType.VIEW;\n /* View reference identifier. /\n viewRef: string;\n /* Content type for routing (composite, chart, custom, flows/actors). /\n contentType: ViewNavigationContentType;\n /* Optional context resource IDs carried with the app-level navigation payload. /\n contextResourceIdentifiers?: Record<string, string>;\n /* Optional chart-route query params for standalone chart URL_PARAM bindings. /\n urlParamValues?: Record<string, string>;\n /* FlowsActorsView: the flows/actors system displayed. /\n flowsActorsSystemRef?: string;\n /* FullCustomView: reference to the registered custom component. /\n fullCustomComponentRef?: string;\n /* Required features configuration for feature gating. /\n requiredFeatures?: RequiredFeaturesConfig;\n}\n\n/\n Engine-page navigation item — a navigable framework-owned page in app-level components.\n * Discriminated by `itemType: NavigationItemType.ENGINE_PAGE`.\n /\nexport interface EnginePageNavigationItem extends NavigationItemBase {\n itemType: NavigationItemType.ENGINE_PAGE;\n /* Framework-owned page reference. /\n pageRef: EnginePageRef;\n}\n\n/* Generic custom-component navigation item — launcher escape hatch with explicit runtime meaning. /\nexport interface CustomComponentNavigationItem extends NavigationItemBase {\n itemType: NavigationItemType.CUSTOM_COMPONENT;\n componentRef: string;\n /* Optional context resource IDs carried with the app-level navigation payload. /\n contextResourceIdentifiers?: Record<string, string>;\n}\n\n/\n Settings-hub navigation item — opens the unified Settings Hub (overlay).\n * Discriminated by `itemType: NavigationItemType.SETTINGS_HUB`.\n /\nexport interface SettingsHubNavigationItem extends NavigationItemBase {\n itemType: NavigationItemType.SETTINGS_HUB;\n /* Section to pre-open; omit to open the hub's default section. /\n sectionRef?: string;\n}\n\n/* Discriminated union of all navigation items. Narrow on `itemType`. /\nexport type AnyNavigationItem =\n \| ResourceNavigationItem\n \| ViewNavigationItem\n \| EnginePageNavigationItem\n \| CustomComponentNavigationItem\n \| SettingsHubNavigationItem;\n\n/* Type guard — narrows `AnyNavigationItem` to `ResourceNavigationItem`. /\nexport function isResourceNavigationItem(item: AnyNavigationItem): item is ResourceNavigationItem {\n return item.itemType === NavigationItemType.RESOURCE;\n}\n\n/* Type guard — narrows `AnyNavigationItem` to `ViewNavigationItem`. /\nexport function isViewNavigationItem(item: AnyNavigationItem): item is ViewNavigationItem {\n return item.itemType === NavigationItemType.VIEW;\n}\n\n/* Type guard — narrows `AnyNavigationItem` to `EnginePageNavigationItem`. /\nexport function isEnginePageNavigationItem(item: AnyNavigationItem): item is EnginePageNavigationItem {\n return item.itemType === NavigationItemType.ENGINE_PAGE;\n}\n\n/* Type guard — narrows `AnyNavigationItem` to `CustomComponentNavigationItem`. /\nexport function isCustomComponentNavigationItem(item: AnyNavigationItem): item is CustomComponentNavigationItem {\n return item.itemType === NavigationItemType.CUSTOM_COMPONENT;\n}\n\n/* Type guard — narrows `AnyNavigationItem` to `SettingsHubNavigationItem`. /\nexport function isSettingsHubNavigationItem(item: AnyNavigationItem): item is SettingsHubNavigationItem {\n return item.itemType === NavigationItemType.SETTINGS_HUB;\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Zod Validation Schemas (for runtime event validation)\n// ════════════════════════════════════════════════════════════════\n\n/\n Zod schema for `NavigationSourceRelationship`.\n * Intentional lightweight subset of the full relationship schema —\n * only navigation-relevant fields for event validation.\n /\nconst navigationSourceRelationshipSchema = z.object({\n parentResourceType: z.string(),\n parentResourceId: z.string().optional(),\n childResourceType: z.string(),\n foreignKeyField: z.string().optional(),\n relationshipEdgeKey: z.string().optional(),\n inChildView: z.object({\n showParentLink: z.boolean().optional(),\n parentDisplay: z.enum(ParentDisplay).optional(),\n }).optional(),\n});\n\n/* Zod schema for `NavigationInitiatorContext` — validates navigation event source. /\nexport const NavigationInitiatorContextSchema = z.object({\n sourceZone: z.union([NavigationZoneSchema, z.literal(APP_LEVEL_NAVIGATION_SOURCE)]),\n launcher: z.enum(ApplicationLevelComponentType).optional(),\n sourceOperation: z.enum(CoreResourceOperation).optional(),\n sourceRelationship: navigationSourceRelationshipSchema.optional(),\n});\n\n/* Zod schema for resource operation content. /\nconst navigationContent_ResourceOperationSchema = z.object({\n contentType: z.literal(NavigationContentType.RESOURCE_OPERATION),\n resourceContext: FrontendResourceOperationContextSchema,\n});\n\n/* Zod schema for composite view content. /\nconst navigationContent_CompositeViewSchema = z.object({\n contentType: z.literal(NavigationContentType.COMPOSITE_VIEW),\n viewRef: z.string(),\n contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),\n});\n\n/* Zod schema for chart view content. /\nconst navigationContent_ChartViewSchema = z.object({\n contentType: z.literal(NavigationContentType.CHART_VIEW),\n viewRef: z.string(),\n contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),\n urlParamValues: z.record(z.string(), z.string()).optional(),\n requiredFeatures: RequiredFeaturesConfigSchema.optional(),\n // Pre-resolved chart payloads ride on the navigation stack as runtime\n // transport objects. They are already type-checked at construction sites; the\n // stack schema only needs to validate that optional payload slots exist.\n viewDefinition: z.custom<InsertedChartDeclaration>(() => true).optional(),\n runtimeDescriptor: z.custom<ResolvedInsertedChartDescriptor>(() => true).optional(),\n});\n\n/* Zod schema for full custom view content. /\nconst navigationContent_FullCustomViewSchema = z.object({\n contentType: z.literal(NavigationContentType.FULL_CUSTOM_VIEW),\n viewRef: z.string(),\n fullCustomComponentRef: z.string(),\n contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),\n});\n\n/* Zod schema for flows/actors view content. /\nconst navigationContent_FlowsActorsViewSchema = z.object({\n contentType: z.literal(NavigationContentType.FLOWS_ACTORS_VIEW),\n viewRef: z.string(),\n flowsActorsSystemRef: z.string(),\n contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),\n});\n\n/* Zod schema for execution view content. /\nconst navigationContent_ExecutionViewSchema = z.object({\n contentType: z.literal(NavigationContentType.EXECUTION_VIEW),\n viewRef: z.string(),\n contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),\n});\n\n/* Zod schema for generic custom component content. /\nconst navigationContent_CustomComponentSchema = z.object({\n contentType: z.literal(NavigationContentType.CUSTOM_COMPONENT),\n componentRef: z.string(),\n contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),\n});\n\n/* Zod schema for engine page content. /\nconst navigationContent_EnginePageSchema = z.object({\n contentType: z.literal(NavigationContentType.ENGINE_PAGE),\n pageRef: z.nativeEnum(EnginePageRef),\n});\n\n/* Zod schema for the unified Settings Hub overlay content. /\nconst navigationContent_SettingsHubSchema = z.object({\n contentType: z.literal(NavigationContentType.SETTINGS_HUB),\n sectionRef: z.string().optional(),\n});\n\n/* Zod schema for inline create content. /\nconst navigationContent_InlineCreateSchema = z.object({\n contentType: z.literal(NavigationContentType.INLINE_CREATE),\n resourceContext: FrontendResourceOperationContextSchema,\n defaultValues: z.record(z.string(), z.unknown()),\n});\n\n/* Zod schema for error modal content. /\nconst navigationContent_ErrorModalSchema = z.object({\n contentType: z.literal(NavigationContentType.ERROR_MODAL),\n errorType: z.string(),\n message: z.string(),\n context: z.record(z.string(), z.unknown()).optional(),\n wildoError: z.unknown().optional(),\n});\n\n/* Discriminated union schema for all navigation content types. /\nexport const NavigationContentSchema = z.discriminatedUnion('contentType', [\n navigationContent_ResourceOperationSchema,\n navigationContent_CompositeViewSchema,\n navigationContent_ChartViewSchema,\n navigationContent_FullCustomViewSchema,\n navigationContent_FlowsActorsViewSchema,\n navigationContent_ExecutionViewSchema,\n navigationContent_CustomComponentSchema,\n navigationContent_EnginePageSchema,\n navigationContent_SettingsHubSchema,\n navigationContent_InlineCreateSchema,\n navigationContent_ErrorModalSchema,\n]);\n\n/* Zod schema for a single navigation stack entry — validates serialized navigation state. */\nexport const NavigationStackEntrySchema = z.object({\n id: z.string(),\n content: NavigationContentSchema,\n urlPath: z.string().optional(),\n timestamp: z.number(),\n zone: NavigationZoneSchema,\n initiator: NavigationInitiatorContextSchema.optional(),\n navigationSource: z.enum(NavigationSource),\n transition: z.enum(NavigationTransition),\n appearance: z.union([z.enum(OverlayAppearance), z.enum(SplitAppearance)]).optional(),\n ephemeral: z.boolean().optional(),\n hostedPane: z.boolean().optional(),\n});\n"]}
1	+ {"version":3,"file":"navigation.schemas.js","sourceRoot":"","sources":["../../../../../src/core/navigation/navigation.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Navigation — Frontend Runtime Types\n \n Runtime types for zone state, navigation stacks/tabs, events, content,\n * initiator context, and resolution results. These are the types the\n * navigation controller, context, and rendering layer operate on.\n \n Configuration types (what developers configure) live in\n * `@wildo-ai/saas-models` — `navigation.shared.schemas.ts`.\n * This file imports config enums from there and defines runtime state on top.\n \n Key runtime concepts:\n * - NavigationZone: type union = `NavigationZoneName \| 'overlay'` — extends the 3\n * configurable zones with the implicit overlay destination (no enum duplication)\n * - NavigationState: per-zone stack/tab state + separate overlay stack\n * - NavigationResolutionResult: output of the resolver, consumed by the controller\n \n @see _code_archive/docs-archive/navigation/navigation-v3-reflection.md\n /\n\nimport React from 'react';\nimport { z } from 'zod';\nimport {\n NavigationZoneContentModel,\n NavigationTransition,\n NavigationZoneName,\n OverlayAppearance,\n SplitAppearance,\n ParentDisplay,\n ZoneEmptyBehavior,\n type RelationshipDisplayInChildView,\n type TransitionConfig,\n type ViewportDiscriminated,\n} from '@wildo-ai/saas-models';\nimport { ViewportBreakpoint } from '@wildo-ai/zod-decorators';\nimport {\n ApplicationLevelComponentType,\n SidebarItemDisplayPolicy,\n} from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { EnginePageRef } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport type { NavigationOperationOverride, FrontendResourceConfiguration_Operation } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport {\n CoreResourceOperation,\n ResourceOperationFrontendSurface,\n type RequiredFeaturesConfig,\n RequiredFeaturesConfigSchema,\n FeatureUnavailabilityBehavior,\n FeatureUnavailabilityReason,\n type FeatureUpgradeOption,\n} from '@wildo-ai/saas-models';\nimport {\n FrontendResourceOperationContextSchema,\n type FrontendResourceOperationContext,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type {\n InsertedChartDeclaration,\n ResolvedInsertedChartDescriptor,\n} from '~wildo-frontend-lib/core/config/chart-view.frontend.schemas';\n\n\n// ════════════════════════════════════════════════════════════════\n// Runtime Enums\n// ════════════════════════════════════════════════════════════════\n\n/\n Runtime zone identifiers — all possible destinations for navigation content.\n \n Extends `NavigationZoneName` (the 3 configurable zones) with `OVERLAY`,\n * which is an implicit runtime destination (not a configurable zone).\n \n Implemented as a const object (spread of `NavigationZoneName` + `OVERLAY`)\n * to avoid duplicating the 3 structural zone values already defined in\n * `NavigationZoneName`. Use `NavigationZone.PRIMARY`, `NavigationZone.OVERLAY`, etc.\n /\nconst OVERLAY_ZONE = 'overlay' as const;\n\nexport const NavigationZone = {\n ...NavigationZoneName,\n /\n Implicit floating layer above all zones. Not a configurable zone —\n * always available as a destination for `overlay` transitions.\n * Content renders as dialog, sheet, or drawer based on the source zone's appearance config.\n /\n OVERLAY: OVERLAY_ZONE,\n} as const;\n\n/* Union of all runtime zone identifiers (3 structural + overlay). /\nexport type NavigationZone = NavigationZoneName \| typeof OVERLAY_ZONE;\n\n/* Zod schema for `NavigationZone` — validates any structural zone name or `'overlay'`. /\nexport const NavigationZoneSchema = z.union([z.enum(NavigationZoneName), z.literal(OVERLAY_ZONE)]);\n\n/\n All structural zones (excludes overlay).\n * Used for iterating over zones that have configuration and state.\n /\nexport const NAVIGATION_STRUCTURAL_ZONES: readonly NavigationZoneName[] = Object.values(NavigationZoneName);\n\n/\n Navigation source for app-shell actions (sidebar, command palette, hotkey, toast, notification).\n * Used alongside `NavigationZone` to form the complete set of navigation origins.\n * App-level navigation causes a layout reset: primary replaced, other zones cleared.\n /\nexport const APP_LEVEL_NAVIGATION_SOURCE = 'appLevel' as const;\n\n/\n What kind of content is being navigated to.\n * Frontend-only — used by navigation stacks, resolution, and content rendering.\n /\nexport enum NavigationContentType {\n RESOURCE_OPERATION = 'resource_operation',\n COMPOSITE_VIEW = 'composite_view',\n CHART_VIEW = 'chart_view',\n FULL_CUSTOM_VIEW = 'full_custom_view',\n FLOWS_ACTORS_VIEW = 'flows_actors_view',\n EXECUTION_VIEW = 'execution_view',\n CUSTOM_COMPONENT = 'custom_component',\n ENGINE_PAGE = 'engine_page',\n SETTINGS_HUB = 'settings_hub',\n INLINE_CREATE = 'inline_create',\n ERROR_MODAL = 'error_modal',\n}\n\n/\n How a navigation entry was created — tracks the origin of each stack entry.\n \n Used to coordinate between controller-initiated (programmatic) and\n * URL-initiated (browser back/forward, direct link) navigation.\n * The controller needs to know if a navigation event came from URL sync\n * to avoid infinite loops (URL change → navigate → URL change → ...).\n /\nexport enum NavigationSource {\n /* Navigation triggered programmatically by useNavigationController. /\n CONTROLLER = 'controller',\n /* Navigation triggered by URL change (bookmark, back button, direct link). /\n URL_SYNC = 'url_sync',\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Initiator Context\n// ════════════════════════════════════════════════════════════════\n\n/\n Lightweight relationship metadata carried on navigation events.\n \n When navigation is triggered by a parent→child relationship traversal\n * (e.g., clicking a related item in a parent's detail view), this carries\n * just enough relationship info for the destination component to configure\n * its parent reference display (breadcrumb, badge, etc.).\n \n Intentionally NOT the full `ResourceRelationship` — avoids importing the\n * entire relationship schema tree into navigation events (Nav-2 decision).\n /\nexport interface NavigationSourceRelationship {\n /* The resource type of the parent in this relationship. /\n parentResourceType: string;\n /* The specific parent instance ID, if navigating from a specific parent record. /\n parentResourceId?: string;\n /* The resource type of the child in this relationship. /\n childResourceType: string;\n /* FK field used to traverse this edge when disambiguation is required. /\n foreignKeyField?: string;\n /* Stable parent→child edge key for navigation-time identity. /\n relationshipEdgeKey?: string;\n /\n The `inChildView` display config from the relationship definition.\n * Controls how the parent reference appears in the child's view (breadcrumb, badge, etc.).\n /\n inChildView?: RelationshipDisplayInChildView;\n}\n\n/\n Source context for a navigation event — WHO triggered the navigation and FROM WHERE.\n \n The resolver uses `sourceZone` as the primary input signal to determine\n * which transition applies. The same operation produces different transitions\n * depending on where the user currently is.\n /\nexport interface NavigationInitiatorContext {\n /\n Where the navigation was triggered from.\n \n - A `NavigationZone` value: navigation from within a structural zone or overlay\n * - `APP_LEVEL_NAVIGATION_SOURCE`: navigation from the app shell (sidebar,\n * command palette, hotkey, toast action, notification click). Causes a layout reset.\n \n This replaces the old `type: NavigationInitiatorType` + `sourcePane: NavigationPane`\n * pattern with a single, explicit field.\n /\n sourceZone: NavigationZone \| typeof APP_LEVEL_NAVIGATION_SOURCE;\n /\n Which app-level launcher triggered the navigation.\n * Only relevant when `sourceZone === APP_LEVEL_NAVIGATION_SOURCE`. Examples: sidebar click,\n * command palette selection, quick action button, hotkey.\n /\n launcher?: ApplicationLevelComponentType;\n /* The operation that produced this navigation (read, create, delete, etc.). /\n sourceOperation?: CoreResourceOperation;\n /\n When navigation was triggered by traversing a parent→child relationship.\n * Carries lightweight relationship info so the destination can configure\n * parent reference display (breadcrumb, badge, summary card).\n /\n sourceRelationship?: NavigationSourceRelationship;\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Navigation Content (discriminated union — what's being shown)\n// ════════════════════════════════════════════════════════════════\n\n/* Content representing a resource operation (list, read, create, etc.). /\nexport interface NavigationContent_ResourceOperation {\n contentType: NavigationContentType.RESOURCE_OPERATION;\n /* Fully resolved resource context: resource type, operation, params, record ID, etc. /\n resourceContext: FrontendResourceOperationContext;\n}\n\n/* Content representing a composite view (dashboard, overview, etc.). /\nexport interface NavigationContent_CompositeView {\n contentType: NavigationContentType.COMPOSITE_VIEW;\n /* Reference identifier for the composite view definition. /\n viewRef: string;\n /* Optional context resource IDs to pass to the view for scoping/filtering. /\n contextResourceIdentifiers?: Record<string, string>;\n}\n\n/* Content representing a chart view (data visualization). /\nexport interface NavigationContent_ChartView {\n contentType: NavigationContentType.CHART_VIEW;\n /* Reference identifier for the chart view definition. /\n viewRef: string;\n /* Optional context resource IDs to scope the chart's data. /\n contextResourceIdentifiers?: Record<string, string>;\n /* Optional route-derived URL params for standalone chart URL_PARAM bindings. /\n urlParamValues?: Record<string, string>;\n /* Optional feature-gating metadata for chart-stack rendering. /\n requiredFeatures?: RequiredFeaturesConfig;\n /* Optional pre-resolved chart surface definition for inserted/routed charts. /\n viewDefinition?: InsertedChartDeclaration;\n /* Optional pre-resolved descriptor for inserted/routed charts. /\n runtimeDescriptor?: ResolvedInsertedChartDescriptor;\n}\n\n/* Content representing a full custom view (developer-provided component). /\nexport interface NavigationContent_FullCustomView {\n contentType: NavigationContentType.FULL_CUSTOM_VIEW;\n /* Reference identifier for the view definition. /\n viewRef: string;\n /* Reference to the custom React component registered for this view. /\n fullCustomComponentRef: string;\n /* Optional context resource IDs to pass to the component. /\n contextResourceIdentifiers?: Record<string, string>;\n}\n\n/* Content representing a flows & actors view (AI workflows, agent execution). /\nexport interface NavigationContent_FlowsActorsView {\n contentType: NavigationContentType.FLOWS_ACTORS_VIEW;\n /* Reference identifier for the view definition. /\n viewRef: string;\n /* The flows/actors system this view displays. /\n flowsActorsSystemRef: string;\n /* Optional context resource IDs to scope the view. /\n contextResourceIdentifiers?: Record<string, string>;\n}\n\n/* Content representing an execution view (framework-owned execution host). /\nexport interface NavigationContent_ExecutionView {\n contentType: NavigationContentType.EXECUTION_VIEW;\n /* Reference identifier for the execution view definition. /\n viewRef: string;\n /* Optional context resource IDs to scope the execution view. /\n contextResourceIdentifiers?: Record<string, string>;\n}\n\n/* Content representing a generic app-level custom component. /\nexport interface NavigationContent_CustomComponent {\n contentType: NavigationContentType.CUSTOM_COMPONENT;\n /* Registered component reference to materialize. /\n componentRef: string;\n /* Optional context resource IDs to pass to the component. /\n contextResourceIdentifiers?: Record<string, string>;\n}\n\n/* Content representing a router-backed engine page. /\nexport interface NavigationContent_EnginePage {\n contentType: NavigationContentType.ENGINE_PAGE;\n pageRef: EnginePageRef;\n}\n\n/\n Content representing the unified Settings Hub.\n \n Always rendered in the overlay zone (DIALOG appearance, persistent — NOT\n * ephemeral, so it survives source-zone changes and closes only on explicit\n * dismiss). The optional `sectionRef` pre-selects which section opens; when\n * omitted the hub opens at its default section. URL-addressable via\n * `/settings/:sectionRef`, and `/settings/:sectionRef/:subTabRef` when the\n * section renders sub-tabs.\n /\nexport interface NavigationContent_SettingsHub {\n contentType: NavigationContentType.SETTINGS_HUB;\n sectionRef?: string;\n /\n Which sub-tab of `sectionRef` opens. Only meaningful for a `SUB_TABS` target; a ref the\n * section does not declare is IGNORED rather than refused, so a stale or hand-typed link still\n * opens the section at its first tab instead of an error page.\n /\n subTabRef?: string;\n}\n\n/* Content representing a typed sidebar inline-create flow. /\nexport interface NavigationContent_InlineCreate {\n contentType: NavigationContentType.INLINE_CREATE;\n resourceContext: FrontendResourceOperationContext;\n defaultValues: Record<string, unknown>;\n}\n\n/\n Content representing an error modal pushed through the overlay stack.\n \n Carries the error itself, not text: the modal is pushed by `ErrorContext`, which is mounted ABOVE the\n * `I18nProvider`, so nothing there can produce words a person should read. The renderer resolves\n * `wildoError` through `useUserFacingErrorMessage`. The `message` and `context` fields were removed (#1159):\n * they held the raw i18n reference and the request context, and both reached the screen.\n /\nexport interface NavigationContent_ErrorModal {\n contentType: NavigationContentType.ERROR_MODAL;\n /* Technical discriminator for the stack-entry key only — never rendered. /\n errorType: string;\n wildoError: unknown;\n}\n\n/\n Discriminated union of all navigation content types.\n * Discriminated on `contentType` for clean narrowing.\n * Every navigation stack entry carries exactly one of these.\n /\nexport type NavigationContent =\n \| NavigationContent_ResourceOperation\n \| NavigationContent_CompositeView\n \| NavigationContent_ChartView\n \| NavigationContent_FullCustomView\n \| NavigationContent_FlowsActorsView\n \| NavigationContent_ExecutionView\n \| NavigationContent_CustomComponent\n \| NavigationContent_EnginePage\n \| NavigationContent_SettingsHub\n \| NavigationContent_InlineCreate\n \| NavigationContent_ErrorModal;\n\n\n// ════════════════════════════════════════════════════════════════\n// Navigation Stack Entry\n// ════════════════════════════════════════════════════════════════\n\n/\n A single entry in a zone's navigation stack (or overlay stack).\n \n Each entry represents one piece of content that was navigated to.\n * The stack maintains navigation history within a zone for back navigation.\n * In tabbed zones, entries represent parallel tabs (not a depth stack).\n /\nexport interface NavigationStackEntry {\n /* Unique identifier for this stack entry (UUID). /\n id: string;\n /* The content being displayed in this entry. /\n content: NavigationContent;\n /\n URL path that represents this navigation state.\n * Used for URL serialization, deep linking, and browser history.\n * Every navigation state must be URL-addressable.\n /\n urlPath?: string;\n /* Timestamp (ms since epoch) when this entry was created. For ordering and debugging. /\n timestamp: number;\n /* Which zone this entry lives in. /\n zone: NavigationZone;\n /* The context that triggered this navigation (source zone, operation, relationship). /\n initiator?: NavigationInitiatorContext;\n /* Whether this entry was created by the controller or by URL sync. /\n navigationSource: NavigationSource;\n /\n The transition verb that placed this entry (push, replace, split, overlay, promote).\n * Note: `inplace` does not produce a stack entry (it transforms an element in the\n * current view without changing zone state), so it will never appear here.\n /\n transition: NavigationTransition;\n /\n Visual appearance for this entry's transition.\n * Set by the resolver from zone appearance config. Only meaningful for\n * overlay entries (dialog/sheet/drawer) and split entries (panel/drawer).\n * Used by ContentAreas to decide how to render overlay or split content.\n /\n appearance?: OverlayAppearance \| SplitAppearance;\n /\n Behaviour of an OVERLAY entry: is the page behind interactive, does touching it dismiss, is it\n * dimmed. Three independent questions, and a companion panel needs all three answered — see\n * `OverlayContainerConfig`, whose fields these feed.\n \n Declared per operation because it is a property of the CONTENT, not of the zone: one application\n * legitimately has a create dialog that blocks everything and a detail sheet beside a live canvas\n * that blocks nothing.\n /\n overlayBehavior?: {\n /* Block interaction with the page behind. Default `true`. /\n modal?: boolean;\n /* Dismiss when the page behind is clicked. Default `true`. /\n closeOnOutsideClick?: boolean;\n /* Dim the page behind. Default `true`. /\n showBackdrop?: boolean;\n };\n /\n When `true`, this overlay entry auto-closes when the source zone's stack changes.\n * Set by the resolver from `TransitionConfig.ephemeral`. Only valid on overlay entries.\n * Used by NavigationContext auto-close logic.\n /\n ephemeral?: boolean;\n /\n `true` when this SECONDARY entry was opened beside a primary whose address the pane's own URL\n * cannot re-derive (a composite view, a canvas, a chart, an engine page), so the browser URL is\n * the HOST's address carrying this entry as `?pane=` — see `HOSTED_PANE_QUERY_PARAM` in\n * `hosted-pane.constants.ts`.\n \n Three readers key on it, and each needs it for a different reason: the zone-dependency cleanup\n * keeps a hosted pane beside a primary it cannot otherwise relate to (the relevance rule is\n * relationship-aware and a composite view has no relationships); the URL reconciler closes the\n * pane when the `pane` parameter leaves the URL (browser back); and the route-owner lookup never\n * lets a hosted entry claim a BARE browser URL, because its address is only ever reachable in the\n * composed form.\n /\n hostedPane?: boolean;\n /\n The zone this entry was AUTHORED for, when a responsive collapse placed it somewhere else.\n \n A `secondary` split on a phone lands in PRIMARY (under `ResponsiveCollapseMode.PUSH`) or in\n * OVERLAY (under `OVERLAY`), and `zone` above records where it actually IS. This records where it\n * belongs, so widening the viewport can migrate it back — the behaviour `ResponsiveCollapseMode`\n * documents and, before #411, nothing implemented because nothing recorded the origin.\n \n Absent on every entry that was placed where it was authored, which is the common case.\n /\n collapsedFromZone?: NavigationZoneName;\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Zone State (runtime)\n// ════════════════════════════════════════════════════════════════\n\n/\n Runtime state of a single navigation zone.\n \n Each zone independently tracks its navigation stack and visibility.\n * For tabbed zones, `activeTabId` identifies which tab is currently displayed.\n \n Zone lifecycle states (not an enum — derived from config + runtime):\n * - Inactive: zone not declared in config. Doesn't exist in DOM.\n * - Hidden: zone exists but not visible (collapsed, or `onEmpty: ZoneEmptyBehavior.COLLAPSE` with nothing pushed).\n * - Empty: zone visible but no content. Only when `onEmpty: 'emptyState'`.\n * - Active: zone has content and is visible.\n /\nexport interface NavigationZoneState {\n /* Which zone this state belongs to. /\n zone: NavigationZone;\n /\n The zone's navigation stack.\n * - In `single` content model: depth stack. Top entry is visible. Back pops.\n * - In `NavigationZoneContentModel.TABBED` content model: tab entries. All are \"open\", one is active.\n /\n stack: NavigationStackEntry[];\n /\n Whether this zone is currently rendered in the DOM and visible.\n * `false` when the zone is collapsed (responsive), or is empty with\n * `onEmpty: ZoneEmptyBehavior.COLLAPSE` and nothing has been pushed into it yet.\n /\n isVisible: boolean;\n /\n For `NavigationZoneContentModel.TABBED` zones — the ID of the currently active tab entry.\n * References `NavigationStackEntry.id`. When `undefined`, the zone is in single mode.\n * Using ID (not index) for stability when tabs are reordered or closed.\n /\n activeTabId?: string;\n}\n\n/\n Full runtime navigation state.\n \n Zones hold their own stack/tab state keyed by `NavigationZoneName` (the 3 structural\n * zones). Overlay is separate because it's not a configurable zone — it's an implicit\n * floating layer that can hold a stack of its own (push within overlay).\n /\nexport interface NavigationState {\n /\n Per-zone state for the 3 structural zones (primary, secondary, companion).\n * Keyed by `NavigationZoneName` — NOT `NavigationZone` (which includes overlay).\n /\n zones: Record<NavigationZoneName, NavigationZoneState>;\n /\n Overlay stack — content shown in the floating layer above all zones.\n * Supports push depth within the overlay (e.g., navigating to a related item\n * from within a create dialog pushes onto the overlay stack).\n * When the stack empties, the overlay dismisses.\n /\n overlay: NavigationStackEntry[];\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Resolution Result (output of the resolver)\n// ════════════════════════════════════════════════════════════════\n\n/\n Output of the navigation policy resolver — tells the controller exactly what to do.\n \n The resolver takes (sourceZone, operation, resourceConfig, viewport) as inputs\n * and produces this result by walking the resolution chain:\n * 1. Per-resource operation override\n * 2. Per-relationship inParentNavigation.transition\n * 3. Global viewport override\n * 4. Source zone's transitions[operation]\n * 5. Framework fallback\n /\nexport interface NavigationResolutionResult {\n /* Which zone the content should be placed in. /\n targetZone: NavigationZone;\n /* The transition verb to apply. /\n transition: NavigationTransition;\n /\n Visual appearance for the transition. Only meaningful for:\n * - `overlay` transitions: `OverlayAppearance` (dialog, sheet, or drawer)\n * - `split` transitions: `SplitAppearance` (panel or drawer)\n * `undefined` for `push`, `replace`, `inplace`, and `promote`\n * (`push`/`replace`/`promote` fill the zone; `inplace` transforms an element).\n /\n appearance?: OverlayAppearance \| SplitAppearance;\n /\n Behaviour of an OVERLAY entry: is the page behind interactive, does touching it dismiss, is it\n * dimmed. Three independent questions, and a companion panel needs all three answered — see\n * `OverlayContainerConfig`, whose fields these feed.\n \n Declared per operation because it is a property of the CONTENT, not of the zone: one application\n * legitimately has a create dialog that blocks everything and a detail sheet beside a live canvas\n * that blocks nothing.\n /\n overlayBehavior?: {\n /* Block interaction with the page behind. Default `true`. /\n modal?: boolean;\n /* Dismiss when the page behind is clicked. Default `true`. /\n closeOnOutsideClick?: boolean;\n /* Dim the page behind. Default `true`. /\n showBackdrop?: boolean;\n };\n /\n Whether this placement IS a responsive collapse — the zone the content was headed for is\n * collapsed at this viewport, so `targetZone` and `transition` above are already the collapsed\n * outcome (PRIMARY + push, or OVERLAY + overlay) rather than the authored one.\n \n It is a REPORT, not an instruction. It said the opposite until 2026-09-08 (#411) — \"the\n * controller should apply the zone's `responsiveCollapse` behavior\" — and no controller ever did,\n * which is exactly how the mechanism stayed inert for as long as it existed. The resolver applies\n * it now, because placement is what the resolver answers.\n \n What it is still FOR: telling a collapsed placement apart from an authored one. A collapsed\n * SPLIT and an authored PUSH produce an identical `targetZone`/`transition` pair, and only this\n * flag (with `collapsedFromZone`) distinguishes them.\n /\n collapsed: boolean;\n /\n The zone this content was headed for before the collapse retargeted it — `secondary` or\n * `companion`. Present only when `collapsed` is `true`.\n \n `ResponsiveCollapseMode`'s contract is that \"when viewport grows back past the breakpoint,\n * collapsed content migrates back to its original zone\", and an entry cannot migrate back to a\n * zone nothing recorded. The controller writes this onto the stack entry as\n * `NavigationStackEntry.collapsedFromZone`.\n /\n collapsedFromZone?: NavigationZoneName;\n /\n When `true`, this overlay entry should auto-close when its source zone's stack changes.\n * Derived from `TransitionConfig.ephemeral`. Only meaningful for overlay transitions.\n * The controller writes this to `NavigationStackEntry.ephemeral`.\n /\n ephemeral?: boolean;\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Resolution Context (input to the resolver)\n// ════════════════════════════════════════════════════════════════\n\n/\n Input to the navigation policy resolver — all the contextual signals needed\n * to determine which transition + zone + appearance to use.\n \n Three fundamentally different source types select different config paths:\n * - `NavigationZoneName`: structural zone → reads `layout.zones[zone].transitions`\n * - `'appLevel'`: app shell (sidebar, command palette) → reads `layout.appLevel.transitions`\n * - `'overlay'`: from within an overlay → reads `layout.fromOverlay.transitions`\n /\nexport interface NavigationResolutionContext {\n /\n Where the navigation was triggered from. Determines which config\n * branch the resolver reads transitions from.\n /\n sourceZone: NavigationZoneName \| typeof APP_LEVEL_NAVIGATION_SOURCE \| 'overlay';\n /* The operation being performed (read, create, list, update, etc.). /\n operation: CoreResourceOperation \| string;\n /\n Semantic core operation for custom operations that behave like a framework\n * core surface. Transition maps are keyed by core semantics, so resolvers must\n * use this field instead of raw custom operation identifiers.\n /\n effectiveOperation?: CoreResourceOperation;\n /* Resource type being navigated to (for per-resource override matching). /\n resourceType?: string;\n /\n The target operation's declared frontend surface (resource content only).\n * This is the channel that keeps navigation policy surface-aware: the\n * resolver coerces EMBEDDED content away from PRIMARY (embedded views open\n * in a HOST — overlay/pane — never as the page), and the controller refuses\n * API_ONLY content outright. Replaces a former `isAddressable` boolean that\n * was populated but read by nothing (dead channel, removed 2026-08-19).\n /\n operationSurface?: ResourceOperationFrontendSurface;\n /* Per-resource operation overrides (from resource operationFrontendConfig). First match wins. /\n operationOverrides?: NavigationOperationOverride[];\n /\n The transition the target operation's ACTION PRESENTATION resolves to, when it resolves to one\n * at all — `MODAL` → `OVERLAY`, `PAGE` → nothing (the ordinary chain answers).\n \n The presentation axis is an ALIAS over this chain, never a parallel mechanism: it lets an author\n * say \"an overlay\" without naming a zone, a verb and an appearance. `DIRECT`, `POPOVER` and\n * `INLINE` do not navigate at all, so on their normal path they never reach here; `POPOVER` and\n * `INLINE` supply an `OVERLAY` only as the DEGRADE for a host that cannot anchor or has no\n * element to transform.\n /\n actionPresentationTransition?: TransitionConfig;\n /\n Was the presentation AUTHORED, or derived by the framework?\n \n It decides precedence, and the distinction is load-bearing. An authored presentation is a\n * statement about this operation and outranks the app's relationship- and zone-level navigation\n * defaults. A DERIVED one is the framework's guess and must yield to every configuration an app\n * actually wrote — otherwise introducing the derivation would silently restyle navigation that\n * apps had already tuned.\n /\n actionPresentationIsAuthored?: boolean;\n /\n Full transition config from the relationship's\n * `display.inParentNavigation.transition`.\n * Preserves lifecycle modifiers (ephemeral/persistent). `undefined` when\n * navigation is not relationship-driven.\n /\n relationshipTransition?: TransitionConfig;\n /* Current viewport breakpoint for responsive resolution. /\n viewport: ViewportBreakpoint;\n /\n The measured width, in pixels, of the CONTENT AREA the structural zones share — not the window.\n \n The two differ by the sidebar, by any pane already open, and by whatever an embedded shell gives\n * the application; a tall narrow column on a wide monitor is `DESKTOP` at a width no split can\n * carry. `resolveCollapseMode` escalates a SPLIT that does not fit, exactly as it escalates one\n * below a narrow breakpoint, so this is the measurement that makes the responsive ladder answer to\n * the space rather than to the window.\n \n `undefined` before the first layout pass, which never escalates: an unmeasured width is not a\n * narrow one (the same reading the viewport takes).\n /\n contentAreaWidth?: number;\n /* Which structural zones currently have content. Used for SPLIT target heuristic. /\n zoneOccupancy: Partial<Record<NavigationZoneName, boolean>>;\n /\n Current stack DEPTH per structural zone — what `NavigationLayout.maxDepth` is measured against.\n \n Distinct from `zoneOccupancy`, which is this same measurement flattened to a boolean. Both are\n * projected from ONE read of the zone state in the controller, so they cannot disagree; the depth\n * exists separately because \"does the zone hold anything\" and \"how deep is it\" are different\n * questions and the second cannot be recovered from the first.\n /\n zoneDepth: Partial<Record<NavigationZoneName, number>>;\n /\n `RelationshipDisplayConfig.maxDepth` for the relationship that triggered this navigation, when\n * one did — the per-relationship override of the layout's global `maxDepth`.\n \n Supplied by the caller alongside `relationshipTransition`, because the relationship's display\n * config is a fact about the CALL SITE (a nested container knows which relationship it renders)\n * and the resolver has no way to recover it from a resource type and an operation.\n /\n relationshipMaxDepth?: number;\n /* Currently focused zone — tiebreaker for SPLIT target selection. /\n focusedZone?: NavigationZoneName;\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Feature Availability (for navigation items)\n// ════════════════════════════════════════════════════════════════\n\n/\n Lightweight feature availability status attached to navigation items.\n \n Used by sidebar, command menu, and toolbar to communicate feature gating\n * status to UI components (lock icons, disabled state, upgrade prompts).\n * Subset of the full `FeatureAvailability` from the features system.\n /\nexport interface NavigationFeatureAvailability {\n /* Whether the feature is currently available to the user. /\n isAvailable: boolean;\n /* Why the feature is unavailable (plan limit, not enabled, etc.). /\n reason?: FeatureUnavailabilityReason;\n /* How the UI should respond to unavailability (disable, hide, show upgrade). /\n behavior: FeatureUnavailabilityBehavior;\n /* Feature IDs that are missing/required for this item. /\n missingFeatures?: string[];\n /* Limit details when the feature is gated by usage limits. /\n limitInfo?: { featureId: string; current: number; limit: number };\n /* Available upgrade options to unlock this feature. /\n upgradeOptions?: FeatureUpgradeOption[];\n /* Suggested product reference for upgrade CTAs. /\n suggestedProductRef?: string;\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Navigation Item Types (app-level sidebar, command menu, etc.)\n// ════════════════════════════════════════════════════════════════\n\n/\n Discriminator for navigation item variants.\n * Navigation items appear in the sidebar, command menu, and toolbar.\n /\nexport enum NavigationItemType {\n /* A navigable resource operation (list, read, create for a resource type). /\n RESOURCE = 'resource',\n /* A navigable view (composite, chart, custom, flows/actors). /\n VIEW = 'view',\n /* A navigable framework-owned engine page (home, security settings). /\n ENGINE_PAGE = 'engine_page',\n /* A navigable generic custom component. /\n CUSTOM_COMPONENT = 'custom_component',\n /* Opens the unified Settings Hub (overlay) at an optional section. /\n SETTINGS_HUB = 'settings_hub',\n}\n\n/* Subset of `NavigationContentType` for view-based navigation items. /\nexport type ViewNavigationContentType =\n \| NavigationContentType.COMPOSITE_VIEW\n \| NavigationContentType.CHART_VIEW\n \| NavigationContentType.FULL_CUSTOM_VIEW\n \| NavigationContentType.FLOWS_ACTORS_VIEW\n \| NavigationContentType.EXECUTION_VIEW;\n\n/\n Shared fields across all navigation item variants.\n * Populated by per-launcher resolution (`launcher-resolution.ts`) and behavior\n * hooks from declared launcher content and resource/view definitions.\n /\nexport interface NavigationItemBase {\n /* Unique identifier for this item (typically resourceType or viewRef based). /\n id: string;\n /* Stable reference for configuration matching (not display-specific). /\n ref: string;\n /* Display label for the item. /\n label: string;\n /* URL path for this item's destination. /\n urlPath: string;\n /* Optional icon React node for sidebar/toolbar rendering. /\n icon?: React.ReactNode;\n /* Section reference for grouping (e.g., 'main', 'tools', 'settings'). /\n section?: string;\n /* Sidebar display policy (always visible, collapsible, etc.). /\n displayPolicy?: SidebarItemDisplayPolicy;\n /* Badge KEY (`<scope>:<identifier>`) naming a registered notification-badge definition (see `SidebarItem`). /\n notificationBadgeRef?: string;\n /* Keyboard shortcut hint displayed in UI (e.g., \"⌘K\"). /\n shortcut?: string;\n /* Additional search keywords for command menu filtering. /\n searchKeywords?: string[];\n /* Parent item reference for hierarchical nesting in sidebar. /\n parentItemRef?: string;\n /* Whether this item has children and can be collapsed. /\n isCollapsible?: boolean;\n /* Category for command menu grouping. /\n commandCategory?: string;\n /* Whether to render as icon-only (no label) in compact modes. /\n iconOnly?: boolean;\n\n /* Whether this item is disabled (feature gating, permissions, etc.). /\n disabled?: boolean;\n /* Whether this item shows a lock indicator (feature-locked but visible). /\n featureLocked?: boolean;\n /* Feature availability details when `featureLocked` or `disabled` due to features. /\n featureAvailability?: NavigationFeatureAvailability;\n}\n\n/\n Resource navigation item — a navigable resource operation in app-level components.\n * Discriminated by `itemType: NavigationItemType.RESOURCE`.\n /\nexport interface ResourceNavigationItem extends NavigationItemBase {\n itemType: NavigationItemType.RESOURCE;\n /* The resource type identifier (e.g., 'project', 'task'). /\n resourceType: string;\n /* The operation identifier within the resource config (e.g., 'list', 'create'). /\n operationIdentifier: string;\n /* The full operation configuration from the resource. /\n operation: FrontendResourceConfiguration_Operation;\n /* Pre-built resource context for navigation dispatch. /\n resourceContext: FrontendResourceOperationContext;\n}\n\n/\n View navigation item — a navigable view in app-level components.\n * Discriminated by `itemType: NavigationItemType.VIEW`.\n /\nexport interface ViewNavigationItem extends NavigationItemBase {\n itemType: NavigationItemType.VIEW;\n /* View reference identifier. /\n viewRef: string;\n /* Content type for routing (composite, chart, custom, flows/actors). /\n contentType: ViewNavigationContentType;\n /* Optional context resource IDs carried with the app-level navigation payload. /\n contextResourceIdentifiers?: Record<string, string>;\n /* Optional chart-route query params for standalone chart URL_PARAM bindings. /\n urlParamValues?: Record<string, string>;\n /* FlowsActorsView: the flows/actors system displayed. /\n flowsActorsSystemRef?: string;\n /* FullCustomView: reference to the registered custom component. /\n fullCustomComponentRef?: string;\n /* Required features configuration for feature gating. /\n requiredFeatures?: RequiredFeaturesConfig;\n}\n\n/\n Engine-page navigation item — a navigable framework-owned page in app-level components.\n * Discriminated by `itemType: NavigationItemType.ENGINE_PAGE`.\n /\nexport interface EnginePageNavigationItem extends NavigationItemBase {\n itemType: NavigationItemType.ENGINE_PAGE;\n /* Framework-owned page reference. /\n pageRef: EnginePageRef;\n}\n\n/* Generic custom-component navigation item — launcher escape hatch with explicit runtime meaning. /\nexport interface CustomComponentNavigationItem extends NavigationItemBase {\n itemType: NavigationItemType.CUSTOM_COMPONENT;\n componentRef: string;\n /* Optional context resource IDs carried with the app-level navigation payload. /\n contextResourceIdentifiers?: Record<string, string>;\n}\n\n/\n Settings-hub navigation item — opens the unified Settings Hub (overlay).\n * Discriminated by `itemType: NavigationItemType.SETTINGS_HUB`.\n /\nexport interface SettingsHubNavigationItem extends NavigationItemBase {\n itemType: NavigationItemType.SETTINGS_HUB;\n /* Section to pre-open; omit to open the hub's default section. /\n sectionRef?: string;\n}\n\n/* Discriminated union of all navigation items. Narrow on `itemType`. /\nexport type AnyNavigationItem =\n \| ResourceNavigationItem\n \| ViewNavigationItem\n \| EnginePageNavigationItem\n \| CustomComponentNavigationItem\n \| SettingsHubNavigationItem;\n\n/* Type guard — narrows `AnyNavigationItem` to `ResourceNavigationItem`. /\nexport function isResourceNavigationItem(item: AnyNavigationItem): item is ResourceNavigationItem {\n return item.itemType === NavigationItemType.RESOURCE;\n}\n\n/* Type guard — narrows `AnyNavigationItem` to `ViewNavigationItem`. /\nexport function isViewNavigationItem(item: AnyNavigationItem): item is ViewNavigationItem {\n return item.itemType === NavigationItemType.VIEW;\n}\n\n/* Type guard — narrows `AnyNavigationItem` to `EnginePageNavigationItem`. /\nexport function isEnginePageNavigationItem(item: AnyNavigationItem): item is EnginePageNavigationItem {\n return item.itemType === NavigationItemType.ENGINE_PAGE;\n}\n\n/* Type guard — narrows `AnyNavigationItem` to `CustomComponentNavigationItem`. /\nexport function isCustomComponentNavigationItem(item: AnyNavigationItem): item is CustomComponentNavigationItem {\n return item.itemType === NavigationItemType.CUSTOM_COMPONENT;\n}\n\n/* Type guard — narrows `AnyNavigationItem` to `SettingsHubNavigationItem`. /\nexport function isSettingsHubNavigationItem(item: AnyNavigationItem): item is SettingsHubNavigationItem {\n return item.itemType === NavigationItemType.SETTINGS_HUB;\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Zod Validation Schemas (for runtime event validation)\n// ════════════════════════════════════════════════════════════════\n\n/\n Zod schema for `NavigationSourceRelationship`.\n * Intentional lightweight subset of the full relationship schema —\n * only navigation-relevant fields for event validation.\n /\nconst navigationSourceRelationshipSchema = z.object({\n parentResourceType: z.string(),\n parentResourceId: z.string().optional(),\n childResourceType: z.string(),\n foreignKeyField: z.string().optional(),\n relationshipEdgeKey: z.string().optional(),\n inChildView: z.object({\n showParentLink: z.boolean().optional(),\n parentDisplay: z.enum(ParentDisplay).optional(),\n }).optional(),\n});\n\n/* Zod schema for `NavigationInitiatorContext` — validates navigation event source. /\nexport const NavigationInitiatorContextSchema = z.object({\n sourceZone: z.union([NavigationZoneSchema, z.literal(APP_LEVEL_NAVIGATION_SOURCE)]),\n launcher: z.enum(ApplicationLevelComponentType).optional(),\n sourceOperation: z.enum(CoreResourceOperation).optional(),\n sourceRelationship: navigationSourceRelationshipSchema.optional(),\n});\n\n/* Zod schema for resource operation content. /\nconst navigationContent_ResourceOperationSchema = z.object({\n contentType: z.literal(NavigationContentType.RESOURCE_OPERATION),\n resourceContext: FrontendResourceOperationContextSchema,\n});\n\n/* Zod schema for composite view content. /\nconst navigationContent_CompositeViewSchema = z.object({\n contentType: z.literal(NavigationContentType.COMPOSITE_VIEW),\n viewRef: z.string(),\n contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),\n});\n\n/* Zod schema for chart view content. /\nconst navigationContent_ChartViewSchema = z.object({\n contentType: z.literal(NavigationContentType.CHART_VIEW),\n viewRef: z.string(),\n contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),\n urlParamValues: z.record(z.string(), z.string()).optional(),\n requiredFeatures: RequiredFeaturesConfigSchema.optional(),\n // Pre-resolved chart payloads ride on the navigation stack as runtime\n // transport objects. They are already type-checked at construction sites; the\n // stack schema only needs to validate that optional payload slots exist.\n viewDefinition: z.custom<InsertedChartDeclaration>(() => true).optional(),\n runtimeDescriptor: z.custom<ResolvedInsertedChartDescriptor>(() => true).optional(),\n});\n\n/* Zod schema for full custom view content. /\nconst navigationContent_FullCustomViewSchema = z.object({\n contentType: z.literal(NavigationContentType.FULL_CUSTOM_VIEW),\n viewRef: z.string(),\n fullCustomComponentRef: z.string(),\n contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),\n});\n\n/* Zod schema for flows/actors view content. /\nconst navigationContent_FlowsActorsViewSchema = z.object({\n contentType: z.literal(NavigationContentType.FLOWS_ACTORS_VIEW),\n viewRef: z.string(),\n flowsActorsSystemRef: z.string(),\n contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),\n});\n\n/* Zod schema for execution view content. /\nconst navigationContent_ExecutionViewSchema = z.object({\n contentType: z.literal(NavigationContentType.EXECUTION_VIEW),\n viewRef: z.string(),\n contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),\n});\n\n/* Zod schema for generic custom component content. /\nconst navigationContent_CustomComponentSchema = z.object({\n contentType: z.literal(NavigationContentType.CUSTOM_COMPONENT),\n componentRef: z.string(),\n contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),\n});\n\n/* Zod schema for engine page content. /\nconst navigationContent_EnginePageSchema = z.object({\n contentType: z.literal(NavigationContentType.ENGINE_PAGE),\n pageRef: z.nativeEnum(EnginePageRef),\n});\n\n/\n Zod schema for the unified Settings Hub overlay content.\n \n Mirrors {@link NavigationContent_SettingsHub}, which is the SECOND declaration of this shape —\n * the interface is what components consume and this is what the navigation events validate. The two\n * must move together: `subTabRef` was added to the interface first and the emit site kept failing\n * against this one, which is the whole reason the pair is called out here rather than left implicit.\n /\nconst navigationContent_SettingsHubSchema = z.object({\n contentType: z.literal(NavigationContentType.SETTINGS_HUB),\n sectionRef: z.string().optional(),\n subTabRef: z.string().optional(),\n});\n\n/* Zod schema for inline create content. /\nconst navigationContent_InlineCreateSchema = z.object({\n contentType: z.literal(NavigationContentType.INLINE_CREATE),\n resourceContext: FrontendResourceOperationContextSchema,\n defaultValues: z.record(z.string(), z.unknown()),\n});\n\n/* Zod schema for error modal content. /\nconst navigationContent_ErrorModalSchema = z.object({\n contentType: z.literal(NavigationContentType.ERROR_MODAL),\n errorType: z.string(),\n wildoError: z.unknown(),\n});\n\n/* Discriminated union schema for all navigation content types. /\nexport const NavigationContentSchema = z.discriminatedUnion('contentType', [\n navigationContent_ResourceOperationSchema,\n navigationContent_CompositeViewSchema,\n navigationContent_ChartViewSchema,\n navigationContent_FullCustomViewSchema,\n navigationContent_FlowsActorsViewSchema,\n navigationContent_ExecutionViewSchema,\n navigationContent_CustomComponentSchema,\n navigationContent_EnginePageSchema,\n navigationContent_SettingsHubSchema,\n navigationContent_InlineCreateSchema,\n navigationContent_ErrorModalSchema,\n]);\n\n/* Zod schema for a single navigation stack entry — validates serialized navigation state. */\nexport const NavigationStackEntrySchema = z.object({\n id: z.string(),\n content: NavigationContentSchema,\n urlPath: z.string().optional(),\n timestamp: z.number(),\n zone: NavigationZoneSchema,\n initiator: NavigationInitiatorContextSchema.optional(),\n navigationSource: z.enum(NavigationSource),\n transition: z.enum(NavigationTransition),\n appearance: z.union([z.enum(OverlayAppearance), z.enum(SplitAppearance)]).optional(),\n ephemeral: z.boolean().optional(),\n hostedPane: z.boolean().optional(),\n});\n"]}

package/dist/esm/core/navigation/navigation.utils.d.ts CHANGED Viewed

@@ -6,6 +6,7 @@
  */
 import { CoreResourceOperation, NavigationZoneName, ResourceConfiguration_Operation_UrlParameterInfo, ResourceRelationship, type RequiredFeaturesConfig } from '@wildo-ai/saas-models';
 import { ApplicationLevelComponentType } from '../../core/config/app-level-components.frontend.schemas';
+import { ViewportBreakpoint } from '@wildo-ai/zod-decorators';
 import type { AnyFrontendResourceConfiguration, FrontendResourceConfiguration_Operation, FrontendResourcesRegistry, FrontendResourceOperationContext } from '../../core/resources/resources.frontend.schemas';
 import { z } from 'zod';
 import type { InlineParentContext } from '../../components/resources/component-props.resources-layout.frontend.schemas';
@@ -184,6 +185,32 @@ export declare class NavigationUtils {
         zone: NavigationZoneName;
         browserUrl: string | undefined;
     } | null;
+    /**
+     * The browser URL once an adjacent ZONE is gone — the address of what remains.
+     *
+     * Two callers, and they must agree: a `goBack` that pops the LAST entry of a pane, and the pane's
+     * own DISMISS control, which clears the whole stack at once. Both leave the same layout behind, so
+     * both owe the same URL; two copies of this walk is how one of them comes to write a pane's bare
+     * address that the reconciler cannot claim.
+     *
+     * Closing the last pane beside a non-derivable primary returns to the host's LIVE URL (its view
+     * state intact), not to the stamp the primary entry took when it was placed — the pane simply
+     * leaves the query string. Decided from the BROWSER URL alone, before the primary entry is
+     * consulted: under a composed URL the host half IS the primary's address by construction, and
+     * the primary entry may carry no address of its own at all — a composite view that is not
+     * declared addressable is placed with an EMPTY `urlPath` (the launcher's rule), and the
+     * application's home is exactly such a view. Read through the entry, closing the last pane
+     * emitted the POP and wrote nothing, so the zone collapsed while `?pane=` stayed in the URL and
+     * a reload reopened it (the workbench's conversation, measured on both colour schemes,
+     * 2026-09-22). Everywhere else the fallback is the entry's own URL.
+     *
+     * `undefined` means "leave the URL alone" — there is nothing addressable left to name.
+     */
+    static resolveZoneDismissUrl(params: {
+        zone: NavigationZoneName;
+        currentBrowserUrl: string;
+        getZoneState: (zone: NavigationZoneName) => NavigationZoneState;
+    }): string | undefined;
     /**
      * Whether `zone`'s visible entry is what the browser URL shows for that zone.
      *
@@ -419,14 +446,45 @@ export declare class NavigationUtils {
      * the page props and the live navigation stack cannot disagree about whether a
      * deep-linked resource belongs to PRIMARY, SECONDARY, or COMPANION.
      */
-    /** Does the layout resolve this operation to a SPLIT out of PRIMARY? (#203) */
+    /**
+     * Does this operation resolve to a SPLIT out of PRIMARY? (#203)
+     *
+     * ## This is a RECONSTRUCTION of what a click would have decided, so it reads the same inputs
+     *
+     * `useRouterSync` and `AppRouter` ask this to place a flat (depth-0) detail restored from a URL.
+     * A CLICK never comes here — it goes through {@link NavigationPolicyResolver}, whose resolution
+     * chain puts a PER-OPERATION `navigationOverrides` entry at step 1, ABOVE every zone default. So
+     * a predicate that reads only `zones.primary.transitions` answers a different question from the
+     * one the click answered, and the two disagree exactly where an application has authored an
+     * override.
+     *
+     * Measured on Wonder CRM (2026-09-24), which is the first application to author one:
+     * `zones.primary.transitions.read` is `PUSH` and `deal`'s READ declares
+     * `navigationOverrides: [{ transition: SPLIT }]`. Clicking a deal opened it in SECONDARY; the
+     * same address reloaded rebuilt it in PRIMARY, and the sibling-list cascade — gated on this same
+     * predicate — was skipped too, so the left pane was not wired either. One address, two layouts,
+     * which is the defect `flat-list-detail-restoration.test.ts` was written to stop.
+     *
+     * ## What a reconstruction can and cannot read
+     *
+     * An override scoped with `fromZone` says "when clicked FROM there". A reload was clicked from
+     * nowhere, so such an override cannot describe it and is skipped — the zone map decides, exactly
+     * as before. `viewport` IS knowable and is honoured when the caller supplies one; a caller with
+     * no measured viewport yet matches only the unconditional overrides, which is the conservative
+     * half (an unknown viewport is not a particular one — the same reading `resolveCollapseMode`
+     * takes).
+     *
+     * First match wins, like `checkOperationOverrides`, and a matching override is an ANSWER rather
+     * than an absence: one declaring PUSH stops the walk instead of falling through to a zone map
+     * that might say SPLIT.
+     */
     static layoutSplitsOperationFromPrimary(layout: {
         zones?: {
             primary?: {
                 transitions?: Record<string, unknown>;
             };
         };
-    } | undefined, operation: FrontendResourceConfiguration_Operation): boolean;
+    } | undefined, operation: FrontendResourceConfiguration_Operation, viewport?: ViewportBreakpoint): boolean;
     static resolveResourceTargetZone(depth: number, options?: {
         hasSecondary?: boolean;
         hasCompanion?: boolean;

package/dist/esm/core/navigation/navigation.utils.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"navigation.utils.d.ts","sourceRoot":"","sources":["~~../../../../~~src/core/navigation/navigation.utils.ts"],"names":[],"mappings":"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~~IAyCvE~~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~~IAIT~~;;;;;;;OAOG;IACH~~,+EAA~~+E;~~IAC/E~~,MAAM,CAAC,gCAAgC,CACrC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE;gBAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;aAAE,CAAA;SAAE,CAAA;KAAE,GAAG,SAAS,EACvF,SAAS,EAAE,uCAAuC,~~GACjD~~,OAAO;~~IAUV~~,MAAM,CAAC,yBAAyB,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,wFAAwF;QACxF,4BAA4B,CAAC,EAAE,OAAO,CAAC;KACxC,GACA,kBAAkB;IAqBrB;;OAEG;IACH,MAAM,CAAC,oBAAoB,IAAI,MAAM;IAIrC;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,IAAI,iBAAiB,GAAG;QAAE,WAAW,EAAE,qBAAqB,CAAC,kBAAkB,CAAA;KAAE;IAIvJ;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,kBAAkB,CACvB,cAAc,EAAE,gCAAgC,EAChD,SAAS,EAAE,uCAAuC,EAClD,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnD,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnD,2BAA2B,CAAC,EAAE,OAAO,EAAE,GACtC;QACD,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,WAAW,EAAE,MAAM,CAAC;QACpB,mBAAmB,EAAE,gDAAgD,EAAE,CAAC;KACzE,GAAG,SAAS;IA2Db;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,mBAAmB,CACxB,YAAY,EAAE,MAAM,EACpB,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACzD,QAAQ,EAAE,yBAAyB,GAClC,iBAAiB,GAAG,SAAS;~~IAoEhC~~;;;;;OAKG;IACH,MAAM,CAAC,iCAAiC,CAAC,IAAI,EAAE,kBAAkB,GAAG,iBAAiB;IAmDrF;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,uBAAuB,CAC5B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,yBAAyB,EACnC,eAAe,CAAC,EAAE,MAAM,GACvB,oBAAoB,GAAG,SAAS;IAenC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,8BAA8B,CACnC,YAAY,EAAE,oBAAoB,GACjC,qBAAqB;IAqCxB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,wBAAwB,CAC7B,YAAY,EAAE,oBAAoB,GAAG,SAAS,EAC9C,cAAc,EAAE,gCAAgC,GAC/C,qBAAqB,GAAG,IAAI;IAO/B,MAAM,CAAC,8BAA8B,CACnC,YAAY,EAAE,oBAAoB,GAAG,SAAS,EAC9C,cAAc,EAAE,gCAAgC,EAChD,cAAc,CAAC,EAAE;QACf,QAAQ,EAAE,yBAAyB,CAAC;QACpC,0BAA0B,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;QAC3F,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;KACvD,GACA,uCAAuC,GAAG,IAAI;IAmEjD;;;;;;;;;;;OAWG;IACH;;;;;;OAMG;IACH,MAAM,CAAC,4BAA4B,CACjC,eAAe,EAAE;QAAE,SAAS,CAAC,EAAE,uCAAuC,CAAA;KAAE,GACvE,OAAO;IAOV,MAAM,CAAC,yBAAyB,CAC9B,gBAAgB,EAAE,iBAAiB,EACnC,cAAc,EAAE,iBAAiB,GAChC,OAAO;IA0EV;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,yBAAyB,CAC9B,mBAAmB,EAAE,mBAAmB,GAAG,SAAS,EACpD,cAAc,EAAE,cAAc,GAAG,MAAM,EACvC,mBAAmB,EAAE,0BAA0B,GAAG,SAAS,EAC3D,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,mBAAmB,GAAG,SAAS,GAC3E,OAAO;IAyCV;;;;;;;;;OASG;IACH,MAAM,CAAC,4BAA4B,CACjC,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,WAAW,EAAE,MAAM,GAClB,OAAO;CAiBX"}
1	+ {"version":3,"file":"navigation.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/navigation/navigation.utils.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/navigation/navigation.utils.js CHANGED Viewed

@@ -8,6 +8,7 @@ import { CascadeDirection, CoreResourceOperation, coreResourceShared_FieldIdenti
 import { COMPOSITE_ROUTE_CONTEXT_QUERY_PARAM_PREFIX } from '../../core/config/composite-view.schemas.js';
 import { CHART_ROUTE_CONTEXT_QUERY_PARAM_PREFIX, CHART_ROUTE_PATH_PREFIX } from '../../core/config/chart-view.frontend.schemas.js';
 import { HOSTED_PANE_QUERY_PARAM } from './hosted-pane.constants.js';
+import { resolveViewportDiscriminated } from './navigation-policy-resolver.service.js';
 import { EXECUTION_ROUTE_CONTEXT_QUERY_PARAM_PREFIX } from '../../core/config/execution-view.schemas.js';
 import { isOperationAddressable } from '../../core/resources/resources.frontend.schemas.js';
 import { frontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
@@ -362,24 +363,41 @@ export class NavigationUtils {
         if (zone === NavigationZoneName.PRIMARY) {
             return null;
         }
+        return { zone, browserUrl: NavigationUtils.resolveZoneDismissUrl({ zone, currentBrowserUrl, getZoneState }) };
+    }
+    /**
+     * The browser URL once an adjacent ZONE is gone — the address of what remains.
+     *
+     * Two callers, and they must agree: a `goBack` that pops the LAST entry of a pane, and the pane's
+     * own DISMISS control, which clears the whole stack at once. Both leave the same layout behind, so
+     * both owe the same URL; two copies of this walk is how one of them comes to write a pane's bare
+     * address that the reconciler cannot claim.
+     *
+     * Closing the last pane beside a non-derivable primary returns to the host's LIVE URL (its view
+     * state intact), not to the stamp the primary entry took when it was placed — the pane simply
+     * leaves the query string. Decided from the BROWSER URL alone, before the primary entry is
+     * consulted: under a composed URL the host half IS the primary's address by construction, and
+     * the primary entry may carry no address of its own at all — a composite view that is not
+     * declared addressable is placed with an EMPTY `urlPath` (the launcher's rule), and the
+     * application's home is exactly such a view. Read through the entry, closing the last pane
+     * emitted the POP and wrote nothing, so the zone collapsed while `?pane=` stayed in the URL and
+     * a reload reopened it (the workbench's conversation, measured on both colour schemes,
+     * 2026-09-22). Everywhere else the fallback is the entry's own URL.
+     *
+     * `undefined` means "leave the URL alone" — there is nothing addressable left to name.
+     */
+    static resolveZoneDismissUrl(params) {
+        const { zone, currentBrowserUrl, getZoneState } = params;
+        const { hostUrl, paneUrl } = NavigationUtils.decomposeHostedPaneBrowserUrl(currentBrowserUrl);
+        if (zone === NavigationZoneName.SECONDARY && paneUrl !== undefined) {
+            return hostUrl;
+        }
         const primaryTopUrl = NavigationUtils.getTopEntry(getZoneState(NavigationZoneName.PRIMARY))?.urlPath;
         const secondaryTopUrl = NavigationUtils.getTopEntry(getZoneState(NavigationZoneName.SECONDARY))?.urlPath;
         const fallbackUrl = zone === NavigationZoneName.COMPANION
             ? secondaryTopUrl ?? primaryTopUrl
             : primaryTopUrl;
-        if (!fallbackUrl) {
-            return { zone, browserUrl: undefined };
-        }
-        /*
-         * Closing the last pane beside a non-derivable primary returns to the host's LIVE URL (its view
-         * state intact), not to the stamp the primary entry took when it was placed — the pane simply
-         * leaves the query string. Everywhere else the fallback is the entry's own URL.
-         */
-        const { hostUrl } = NavigationUtils.decomposeHostedPaneBrowserUrl(currentBrowserUrl);
-        const browserUrl = zone === NavigationZoneName.SECONDARY && NavigationUtils.urlsAddressSameDestination(hostUrl, fallbackUrl)
-            ? hostUrl
-            : fallbackUrl;
-        return { zone, browserUrl };
+        return fallbackUrl || undefined;
     }
     /**
      * Whether `zone`'s visible entry is what the browser URL shows for that zone.
@@ -995,7 +1013,34 @@ export class NavigationUtils {
      * @returns The resource relationship depth (0 = root, 1 = child, 2 = grandchild, etc.)
      */
     static calculateResourceRelationshipDepth(parentResourcesRequirements) {
-        return parentResourcesRequirements?.length ?? 0;
+        /*
+         * ─── The TENANCY SCOPE is not a level of the hierarchy ──────────────────────────────────────
+         *
+         * A primary-scope requirement — the organization, the user, the application — is WHERE a record
+         * lives, not a parent record a reader drills through. Counting it made every org-scoped
+         * resource a depth-1 resource, and `resolveResourceTargetZone` sends depth 1 to SECONDARY. So in
+         * any layout that DECLARES a secondary zone, every ordinary resource's list and detail were
+         * routed into the pane by URL sync — while PRIMARY, left empty, fell back to rendering the
+         * router's own route element. The same content in both panes, measured on Wonder CRM
+         * (2026-09-24): `/organizations/:org/deal` painted the deals list twice, side by side, and
+         * clicking a row painted the deal twice.
+         *
+         * It could not self-correct either: `cascadeAncestorZones` — the mechanism that fills the zones
+         * ABOVE a deep resource — skips a primary-scope ancestor deliberately ("these don't get a
+         * zone"), so nothing ever placed anything in PRIMARY. The two functions disagreed about whether
+         * the organization is a level, and only one of them was right.
+         *
+         * Wonder Todos never showed it because it declares no secondary zone, so
+         * `resolveResourceTargetZone` collapses every depth back to PRIMARY. The defect needed an
+         * application with a pane, and Wonder CRM is the first.
+         *
+         * The same reading is already established elsewhere in the frontend:
+         * `ResourceLayout_Breadcrumb` and `inserted-resource-view.frontend.utils` both skip
+         * `isPrimaryScope` requirements when deciding what the hierarchy contains.
+         */
+        if (!parentResourcesRequirements)
+            return 0;
+        return parentResourcesRequirements.filter((requirement) => requirement?.isPrimaryScope !== true).length;
     }
     /**
      * Resolve the structural zone that should own a routed resource entry based on
@@ -1005,13 +1050,60 @@ export class NavigationUtils {
      * the page props and the live navigation stack cannot disagree about whether a
      * deep-linked resource belongs to PRIMARY, SECONDARY, or COMPANION.
      */
-    /** Does the layout resolve this operation to a SPLIT out of PRIMARY? (#203) */
-    static layoutSplitsOperationFromPrimary(layout, operation) {
+    /**
+     * Does this operation resolve to a SPLIT out of PRIMARY? (#203)
+     *
+     * ## This is a RECONSTRUCTION of what a click would have decided, so it reads the same inputs
+     *
+     * `useRouterSync` and `AppRouter` ask this to place a flat (depth-0) detail restored from a URL.
+     * A CLICK never comes here — it goes through {@link NavigationPolicyResolver}, whose resolution
+     * chain puts a PER-OPERATION `navigationOverrides` entry at step 1, ABOVE every zone default. So
+     * a predicate that reads only `zones.primary.transitions` answers a different question from the
+     * one the click answered, and the two disagree exactly where an application has authored an
+     * override.
+     *
+     * Measured on Wonder CRM (2026-09-24), which is the first application to author one:
+     * `zones.primary.transitions.read` is `PUSH` and `deal`'s READ declares
+     * `navigationOverrides: [{ transition: SPLIT }]`. Clicking a deal opened it in SECONDARY; the
+     * same address reloaded rebuilt it in PRIMARY, and the sibling-list cascade — gated on this same
+     * predicate — was skipped too, so the left pane was not wired either. One address, two layouts,
+     * which is the defect `flat-list-detail-restoration.test.ts` was written to stop.
+     *
+     * ## What a reconstruction can and cannot read
+     *
+     * An override scoped with `fromZone` says "when clicked FROM there". A reload was clicked from
+     * nowhere, so such an override cannot describe it and is skipped — the zone map decides, exactly
+     * as before. `viewport` IS knowable and is honoured when the caller supplies one; a caller with
+     * no measured viewport yet matches only the unconditional overrides, which is the conservative
+     * half (an unknown viewport is not a particular one — the same reading `resolveCollapseMode`
+     * takes).
+     *
+     * First match wins, like `checkOperationOverrides`, and a matching override is an ANSWER rather
+     * than an absence: one declaring PUSH stops the walk instead of falling through to a zone map
+     * that might say SPLIT.
+     */
+    static layoutSplitsOperationFromPrimary(layout, operation, viewport) {
         if (operation.isBulkOperation === true)
             return false;
         const semantic = resolveEffectiveCoreOperationFromOperation(operation);
         if (!semantic)
             return false;
+        // Step 1 of the resolver's chain, replayed for a reconstruction (see the note above).
+        const overrides = operation
+            .operationFrontendConfig?.navigationOverrides;
+        if (Array.isArray(overrides)) {
+            for (const candidate of overrides) {
+                const override = candidate;
+                if (override.fromZone !== undefined)
+                    continue;
+                if (override.viewport !== undefined && override.viewport !== viewport)
+                    continue;
+                const overrideVerb = resolveViewportDiscriminated(override.transition, viewport);
+                if (overrideVerb === undefined)
+                    continue;
+                return overrideVerb === NavigationTransition.SPLIT;
+            }
+        }
         const transition = layout?.zones?.primary?.transitions?.[semantic];
         const verb = typeof transition === 'string' ? transition : transition?.transition;
         return verb === NavigationTransition.SPLIT;
@@ -1128,7 +1220,21 @@ export class NavigationUtils {
     static resolveOperationRef(operationRef, additionalIdentifiers, registry) {
         const parts = operationRef.split('.');
         if (parts.length < 2) {
-            logDebug('resolveOperationRef() failed: invalid ref format', { operationRef });
+            /*
+             * WARN, not debug. A ref with no `.` cannot address an operation under any registry, so this
+             * is an AUTHORING error rather than a runtime state — unlike the two branches below, where a
+             * resource genuinely may not be registered in this application.
+             *
+             * It has to be audible because nothing downstream says anything: the caller answers
+             * `undefined`, `NavigationRequestBridge` returns on a falsy `content`, and the person who
+             * pressed the button sees nothing happen. `logDebug` could not report it at all — debug
+             * logging for this type is switched off at module scope a few lines above, so that branch was
+             * unconditionally silent rather than merely quiet.
+             *
+             * This mirrors the guidance EVENT-trigger lane, which warns once, by name, on an unqualified
+             * `eventName` for the same reason: a ref that can never match fails by doing nothing.
+             */
+            logger.warn('resolveOperationRef() failed: invalid ref format — expected `<resourceType>.<operationIdentifier>[.<variant>]`, so this navigation does nothing', { operationRef });
             return undefined;
         }
         const [resourceType, operationId, operationVariantRef] = parts;