npm - @wildo-ai/saas-frontend-lib - Versions diffs - 1.0.1 → 1.1.0 - Mend

@wildo-ai/saas-frontend-lib 1.0.1 → 1.1.0

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 (3472) 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":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEL,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,aAAa,GAKd,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,6BAA6B,GAE9B,MAAM,uEAAuE,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,iEAAiE,CAAC;AAEhG,OAAO,EACL,qBAAqB,EAErB,4BAA4B,GAI7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sCAAsC,GAEvC,MAAM,+DAA+D,CAAC;AAQvE,mEAAmE;AACnE,gBAAgB;AAChB,mEAAmE;AAEnE;;;;;;;;;GASG;AACH,MAAM,YAAY,GAAG,SAAkB,CAAC;AAExC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,GAAG,kBAAkB;IACrB;;;;OAIG;IACH,OAAO,EAAE,YAAY;CACb,CAAC;AAKX,2FAA2F;AAC3F,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAEnG;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAkC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAE5G;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,UAAmB,CAAC;AAE/D;;;GAGG;AACH,MAAM,CAAN,IAAY,qBAWX;AAXD,WAAY,qBAAqB;IAC/B,kEAAyC,CAAA;IACzC,0DAAiC,CAAA;IACjC,kDAAyB,CAAA;IACzB,8DAAqC,CAAA;IACrC,gEAAuC,CAAA;IACvC,0DAAiC,CAAA;IACjC,8DAAqC,CAAA;IACrC,oDAA2B,CAAA;IAC3B,wDAA+B,CAAA;IAC/B,oDAA2B,CAAA;AAC7B,CAAC,EAXW,qBAAqB,KAArB,qBAAqB,QAWhC;AAED;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC1B,wEAAwE;IACxE,6CAAyB,CAAA;IACzB,+EAA+E;IAC/E,yCAAqB,CAAA;AACvB,CAAC,EALW,gBAAgB,KAAhB,gBAAgB,QAK3B;AAwaD,mEAAmE;AACnE,gEAAgE;AAChE,mEAAmE;AAEnE;;;GAGG;AACH,MAAM,CAAN,IAAY,kBAOX;AAPD,WAAY,kBAAkB;IAC5B,+EAA+E;IAC/E,2CAAqB,CAAA;IACrB,iEAAiE;IACjE,mCAAa,CAAA;IACb,4CAA4C;IAC5C,2DAAqC,CAAA;AACvC,CAAC,EAPW,kBAAkB,KAAlB,kBAAkB,QAO7B;AAsGD,4EAA4E;AAC5E,MAAM,UAAU,wBAAwB,CAAC,IAAuB;IAC9D,OAAO,IAAI,CAAC,QAAQ,KAAK,kBAAkB,CAAC,QAAQ,CAAC;AACvD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,oBAAoB,CAAC,IAAuB;IAC1D,OAAO,IAAI,CAAC,QAAQ,KAAK,kBAAkB,CAAC,IAAI,CAAC;AACnD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,+BAA+B,CAAC,IAAuB;IACrE,OAAO,IAAI,CAAC,QAAQ,KAAK,kBAAkB,CAAC,gBAAgB,CAAC;AAC/D,CAAC;AAGD,mEAAmE;AACnE,wDAAwD;AACxD,mEAAmE;AAEnE;;;;GAIG;AACH,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC9B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QACtC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;KAChD,CAAC,CAAC,QAAQ,EAAE;CACd,CAAC,CAAC;AAEH,uFAAuF;AACvF,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC,CAAC;IACnF,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,QAAQ,EAAE;IAC1D,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;IACzD,kBAAkB,EAAE,kCAAkC,CAAC,QAAQ,EAAE;CAClE,CAAC,CAAC;AAEH,iDAAiD;AACjD,MAAM,yCAAyC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,kBAAkB,CAAC;IAChE,eAAe,EAAE,sCAAsC;CACxD,CAAC,CAAC;AAEH,6CAA6C;AAC7C,MAAM,qCAAqC,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,cAAc,CAAC;IAC5D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,0BAA0B,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxE,CAAC,CAAC;AAEH,yCAAyC;AACzC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,UAAU,CAAC;IACxD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,0BAA0B,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvE,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3D,gBAAgB,EAAE,4BAA4B,CAAC,QAAQ,EAAE;IACzD,sEAAsE;IACtE,8EAA8E;IAC9E,yEAAyE;IACzE,cAAc,EAAE,CAAC,CAAC,MAAM,CAAiD,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAC/F,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAkC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;CACpF,CAAC,CAAC;AAEH,+CAA+C;AAC/C,MAAM,sCAAsC,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,gBAAgB,CAAC;IAC9D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE;IAClC,0BAA0B,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxE,CAAC,CAAC;AAEH,gDAAgD;AAChD,MAAM,uCAAuC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,iBAAiB,CAAC;IAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,qBAAqB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1C,0BAA0B,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxE,CAAC,CAAC;AAEH,6CAA6C;AAC7C,MAAM,qCAAqC,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,cAAc,CAAC;IAC5D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,0BAA0B,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxE,CAAC,CAAC;AAEH,uDAAuD;AACvD,MAAM,uCAAuC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,gBAAgB,CAAC;IAC9D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,0BAA0B,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxE,CAAC,CAAC;AAEH,0CAA0C;AAC1C,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,WAAW,CAAC;IACzD,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC;CACrC,CAAC,CAAC;AAEH,4CAA4C;AAC5C,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,aAAa,CAAC;IAC3D,eAAe,EAAE,sCAAsC;IACvD,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;CACjD,CAAC,CAAC;AAEH,0CAA0C;AAC1C,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,WAAW,CAAC;IACzD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrD,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,mEAAmE;AACnE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,kBAAkB,CAAC,aAAa,EAAE;IACzE,yCAAyC;IACzC,qCAAqC;IACrC,iCAAiC;IACjC,sCAAsC;IACtC,uCAAuC;IACvC,qCAAqC;IACrC,uCAAuC;IACvC,kCAAkC;IAClC,oCAAoC;IACpC,kCAAkC;CACnC,CAAC,CAAC;AAEH,8FAA8F;AAC9F,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,OAAO,EAAE,uBAAuB;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,IAAI,EAAE,oBAAoB;IAC1B,SAAS,EAAE,gCAAgC,CAAC,QAAQ,EAAE;IACtD,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;IAC1C,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;IACxC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpF,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC"}
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 /* System references for the flows/actors displayed in this view. /\n flowsActorsSystemRefs: 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 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\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 Whether the target zone is currently in responsive collapse mode at this viewport.\n * When `true`, the controller should apply the zone's `responsiveCollapse` behavior\n * (push into primary or show as overlay) instead of normal zone rendering.\n /\n collapsed: boolean;\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 /* 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 /* Typed reference to 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: system references for the flows/actors displayed. /\n flowsActorsSystemRefs?: 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 flowsActorsSystemRefs: z.array(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});\n"]}

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

@@ -5,11 +5,11 @@
  * Centralized to avoid duplication across navigation modules.
  */
 import { CoreResourceOperation, NavigationZoneName, ResourceConfiguration_Operation_UrlParameterInfo, ResourceRelationship, type RequiredFeaturesConfig } from '@wildo-ai/saas-models';
-import { ApplicationLevelComponentType } from '../../core/config/app-level-components.frontend.schemas.js';
-import type { AnyFrontendResourceConfiguration, FrontendResourceConfiguration_Operation, FrontendResourcesRegistry, FrontendResourceOperationContext } from '../../core/resources/resources.frontend.schemas.js';
+import { ApplicationLevelComponentType } from '../../core/config/app-level-components.frontend.schemas';
+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.js';
-import { NavigationZone, NavigationInitiatorContext, NavigationContent, NavigationContentType, NavigationZoneState, NavigationStackEntry, NavigationState, type AnyNavigationItem, type ViewNavigationItem } from './navigation.schemas.js';
+import type { InlineParentContext } from '../../components/resources/component-props.resources-layout.frontend.schemas';
+import { NavigationZone, NavigationInitiatorContext, NavigationContent, NavigationContentType, NavigationZoneState, NavigationStackEntry, NavigationState, type AnyNavigationItem, type ViewNavigationItem } from './navigation.schemas';
 /**
  * Navigation utility class with static methods for navigation operations
  */
@@ -36,8 +36,8 @@ export declare class NavigationUtils {
      * Explicitly commit (end) the current navigation transaction.
      *
      * This is optional — transactions auto-commit after the current event loop
-     * iteration.  Call this explicitly when you want deterministic timing, e.g.,
-     * inside a requestAnimationFrame callback after a route change.
+     * iteration.  Call this explicitly when you want deterministic timing, e.g., a
+     * test that needs the URL→state reconstruction guard released before asserting.
      */
     static commitTransaction(): void;
     /**
@@ -81,6 +81,27 @@ export declare class NavigationUtils {
         zone: NavigationZoneName;
         entry: NavigationStackEntry;
     } | null;
+    /**
+     * Resolve which structural zone entry owns a URL, scanning the FULL stack of
+     * each zone (not just the top).
+     *
+     * Unlike {@link findStructuralRouteOwner} (which only trusts the visible top
+     * entry, for URL-first *reconstruction* decisions), this is used by the
+     * browser back/forward reconciler to decide whether the URL the user navigated
+     * to via history is a previously-visited entry still sitting lower in a zone's
+     * backstack. When it is, the reconciler can restore it with a pure stack POP
+     * (preserving that entry's live state) instead of rebuilding it from the URL.
+     *
+     * Scans deepest zone first (COMPANION → SECONDARY → PRIMARY); within a zone the
+     * deepest matching entry wins so a genuine "go back N" lands on the correct
+     * historical entry. `isTop` reports whether the match is already that zone's
+     * visible top (i.e. the zone already renders this URL — nothing to do).
+     */
+    static findStructuralStackEntryOwningUrl(urlPath: string, getZoneState: (zone: NavigationZoneName) => NavigationZoneState): {
+        zone: NavigationZoneName;
+        entry: NavigationStackEntry;
+        isTop: boolean;
+    } | null;
     /**
      * Check if a URL pattern matches a pathname (exact match).
      * Patterns use :paramName format (e.g., /organizations/:organizationId/api-keys)
@@ -100,6 +121,34 @@ export declare class NavigationUtils {
      * @returns true if the pathname matches the pattern or is a child route
      */
     static isActiveRoute(pattern: string, pathname: string): boolean;
+    /**
+     * Score how *specific* a route pattern is, so the most precise active item can
+     * be chosen when several match the same URL.
+     *
+     * Primary metric is segment depth (a deeper pattern is more specific); the
+     * static-segment count breaks ties so a fully-literal route outranks a
+     * param-heavy one of equal depth (`/a/b/c` > `/a/:x/c`). `isActiveRoute`
+     * already guarantees the whole pattern matched, so the pattern's own segment
+     * count equals the number of matched segments.
+     */
+    static routeSpecificityScore(pattern: string): number;
+    /**
+     * Among a set of candidate route patterns, return the SINGLE most-specific one
+     * that `isActive` reports as active, or `undefined` when none are active.
+     *
+     * The per-item active check (`isActiveRoute`) marks a pattern active when the
+     * current path equals it OR is a CHILD of it (so a parent section stays
+     * highlighted on a sub-page). The side effect is that a menu listing BOTH a
+     * parent route (`…/todo-lists`) and a child route (`…/todo-lists/:listId/todos`)
+     * sees both report active on the child URL. Active-state highlighting must pick
+     * the most precise one, so callers that own the full candidate set (e.g. the
+     * sidebar) resolve the winner here instead of testing each item in isolation.
+     *
+     * `isActive` is injected (rather than taking a pathname) so callers can reuse
+     * their already-bound checker (e.g. `useNavigationState().isNavigationItemActive`)
+     * without this util depending on router state.
+     */
+    static getMostSpecificActiveRoute(patterns: ReadonlyArray<string | undefined>, isActive: (pattern: string) => boolean): string | undefined;
     /**
      * Convert resourceType-keyed identifiers to fieldIdentifier-keyed identifiers for URL substitution.
      *
@@ -166,6 +215,7 @@ export declare class NavigationUtils {
         fullCustomComponentRef?: string;
         flowsActorsSystemRefs?: string[];
         componentRef?: string;
+        sectionRef?: string;
         requiredFeatures?: RequiredFeaturesConfig;
         contextResourceIdentifiers?: Record<string, string>;
         urlParamValues?: Record<string, string>;
@@ -188,7 +238,7 @@ export declare class NavigationUtils {
      * Create initial navigation state.
      *
      * v3 shape: `{ zones: { primary, secondary, companion }, overlay: [] }`
-     * — DIALOG and SHEET merged into a single `overlay` stack.
+     * — Dialog, sheet, and drawer appearances share a single `overlay` stack.
      * — Former THIRD zone is now COMPANION.
      */
     static createInitialNavigationState(): NavigationState;
@@ -331,7 +381,11 @@ export declare class NavigationUtils {
      * @returns The resolved CoreResourceOperation, or null if no suitable operation
      */
     static resolveAncestorOperation(relationship: ResourceRelationship | undefined, ancestorConfig: AnyFrontendResourceConfiguration): CoreResourceOperation | null;
-    static resolveAncestorOperationConfig(relationship: ResourceRelationship | undefined, ancestorConfig: AnyFrontendResourceConfiguration): FrontendResourceConfiguration_Operation | null;
+    static resolveAncestorOperationConfig(relationship: ResourceRelationship | undefined, ancestorConfig: AnyFrontendResourceConfiguration, runtimeContext?: {
+        registry: FrontendResourcesRegistry;
+        contextResourceIdentifiers: FrontendResourceOperationContext['contextResourceIdentifiers'];
+        contextualParameters: Record<string, string | number>;
+    }): FrontendResourceConfiguration_Operation | null;
     /**
      * Check if secondary/companion zone content is relevant to the current PRIMARY top entry.
      *

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":"AAAA;;;;;GAKG;AAEH,OAAO,EAGL,qBAAqB,EAErB,kBAAkB,EAGlB,gDAAgD,EAChD,oBAAoB,EAGpB,KAAK,sBAAsB,EAE5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,6BAA6B,EAA4B,MAAM,uEAAuE,CAAC;AAChJ,OAAO,KAAK,EAAE,gCAAgC,EAAE,uCAAuC,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAC5N,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;~~AAMxB~~,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4FAA4F,CAAC;AACtI,OAAO,EACL,cAAc,EAGd,0BAA0B,EAC1B,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,~~EAGf~~,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAO9B;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,6BAA6B;IA8C5C,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAS;IAC1C,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAuB;IACxD,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAA8C;IACxF,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAA8C;IAEpF;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAmC7C;;;;;;OAMG;IACH,MAAM,CAAC,iBAAiB,IAAI,IAAI;IAoBhC;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,IAAI,OAAO;IAIjC;;OAEG;IACH,MAAM,CAAC,oBAAoB,IAAI,MAAM,GAAG,IAAI;IAI5C;;;;;;;OAOG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAW,GAAG,MAAM;IAIrE;;;;;;OAMG;IACH,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS;IAS9E;;;;;;;OAOG;IACH,MAAM,CAAC,wBAAwB,CAC7B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,mBAAmB,GAC9D;QAAE,IAAI,EAAE,kBAAkB,CAAC;QAAC,KAAK,EAAE,oBAAoB,CAAA;KAAE,GAAG,IAAI;IAsBnE;;;;;;;;OAQG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAsBlE;;;;;;;OAOG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;~~IAmChE~~;;;;;;;;;OASG;IACH,MAAM,CAAC,4BAA4B,CACjC,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/C,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAyBzB;;;;;;;;;OASG;IACH,MAAM,CAAC,cAAc,CACnB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAChD,MAAM,GAAG,SAAS;IAsBrB;;;;;;OAMG;IACH,MAAM,CAAC,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAM1D;;;;;OAKG;IACH,MAAM,CAAC,uBAAuB,CAAC,QAAQ,EAAE,6BAA6B,GAAG,0BAA0B;IAOnG;;;;OAIG;IACH,MAAM,CAAC,yBAAyB,CAC9B,QAAQ,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,iBAAiB,CAAC;QAAC,SAAS,EAAE,0BAA0B,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,EACnH,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,6BAA6B,GACtC,IAAI;~~IA6BP~~;;;;;OAKG;IACH,MAAM,CAAC,mCAAmC,CACxC,QAAQ,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,iBAAiB,CAAC;QAAC,SAAS,EAAE,0BAA0B,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,EACnH,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,CAAC,EAAE,gCAAgC,CAAC;QACnD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,qBAAqB,CAAC;QACpC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;QACjC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;QAC1C,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACzC,EACD,QAAQ,EAAE,6BAA6B,GACtC,IAAI;~~IAiDP~~;;;;OAIG;IACH,MAAM,CAAC,qCAAqC,CAC1C,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,qBAAqB,EAClC,sBAAsB,CAAC,EAAE,MAAM,EAC/B,qBAAqB,CAAC,EAAE,MAAM,EAAE,EAChC,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,gBAAgB,CAAC,EAAE,sBAAsB,GACxC,iBAAiB;IAyCpB;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAC7B,UAAU,CAAC,EAAE,cAAc,GAAG,MAAM,EACpC,eAAe,CAAC,EAAE,MAAM,GACvB,0BAA0B;IAO7B;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,mBAAmB;IAQ1E;;;;;;OAMG;IACH,MAAM,CAAC,4BAA4B,IAAI,eAAe;IAWtD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,mBAAmB,GAAG,SAAS,GAAG,MAAM;IAInE;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB,GAAG,SAAS;IAKhF;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,kCAAkC,CACvC,2BAA2B,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,GAC7C,MAAM;IAIT;;;;;;;OAOG;IACH,MAAM,CAAC,yBAAyB,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GACA,kBAAkB;IAmBrB;;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;~~IA0Db~~;;;;;;;;;;;;;;;;;;;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;~~IAqDhC~~;;;;;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,~~GAC/C~~,uCAAuC,GAAG,IAAI;~~IAgDjD~~;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,yBAAyB,CAC9B,gBAAgB,EAAE,iBAAiB,EACnC,cAAc,EAAE,iBAAiB,GAChC,OAAO;IAqDV;;;;;;;;;;;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

@@ -7,7 +7,8 @@
 import { CascadeDirection, CoreResourceOperation, coreResourceShared_FieldIdentifier, NavigationZoneName, ParentDisplay, ResourcesConfigOperationsUrlsBuilderUtils, ResourceRelationshipCardinality, Resources_SharedUtils, } from '@wildo-ai/saas-models';
 import { frontendResourceUtils } from '../../core/resources/frontend-resource.utils.js';
 import { pickPreferredOperationForCoreSemantic, resolveEffectiveCoreOperationFromOperation, } from '../../core/resources/operation-semantics.frontend.utils.js';
-import { NavigationZone, APP_LEVEL_NAVIGATION_SOURCE, NavigationContentType, isCustomComponentNavigationItem, isViewNavigationItem, } from './navigation.schemas.js';
+import { pickPreferredOperationForCoreSemanticAddressability } from '../../core/resources/resource-addressability.frontend.utils.js';
+import { NavigationZone, APP_LEVEL_NAVIGATION_SOURCE, NavigationContentType, isCustomComponentNavigationItem, isEnginePageNavigationItem, isSettingsHubNavigationItem, isViewNavigationItem, } from './navigation.schemas.js';
 import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
 const logger = LoggerFrontendService.getLogger();
 const logDebug = logger.debugByType('NavigationUtils');
@@ -105,8 +106,8 @@ export class NavigationUtils {
      * Explicitly commit (end) the current navigation transaction.
      *
      * This is optional — transactions auto-commit after the current event loop
-     * iteration.  Call this explicitly when you want deterministic timing, e.g.,
-     * inside a requestAnimationFrame callback after a route change.
+     * iteration.  Call this explicitly when you want deterministic timing, e.g., a
+     * test that needs the URL→state reconstruction guard released before asserting.
      */
     static commitTransaction() {
         if (!NavigationUtils._transactionActive) {
@@ -192,6 +193,43 @@ export class NavigationUtils {
         }
         return null;
     }
+    /**
+     * Resolve which structural zone entry owns a URL, scanning the FULL stack of
+     * each zone (not just the top).
+     *
+     * Unlike {@link findStructuralRouteOwner} (which only trusts the visible top
+     * entry, for URL-first *reconstruction* decisions), this is used by the
+     * browser back/forward reconciler to decide whether the URL the user navigated
+     * to via history is a previously-visited entry still sitting lower in a zone's
+     * backstack. When it is, the reconciler can restore it with a pure stack POP
+     * (preserving that entry's live state) instead of rebuilding it from the URL.
+     *
+     * Scans deepest zone first (COMPANION → SECONDARY → PRIMARY); within a zone the
+     * deepest matching entry wins so a genuine "go back N" lands on the correct
+     * historical entry. `isTop` reports whether the match is already that zone's
+     * visible top (i.e. the zone already renders this URL — nothing to do).
+     */
+    static findStructuralStackEntryOwningUrl(urlPath, getZoneState) {
+        const comparableTargetUrl = NavigationUtils.normalizeComparableUrl(urlPath);
+        if (!comparableTargetUrl) {
+            return null;
+        }
+        const zonePriority = [
+            NavigationZoneName.COMPANION,
+            NavigationZoneName.SECONDARY,
+            NavigationZoneName.PRIMARY,
+        ];
+        for (const zone of zonePriority) {
+            const stack = getZoneState(zone).stack;
+            for (let index = stack.length - 1; index >= 0; index--) {
+                const entry = stack[index];
+                if (NavigationUtils.normalizeComparableUrl(entry?.urlPath) === comparableTargetUrl) {
+                    return { zone, entry, isTop: index === stack.length - 1 };
+                }
+            }
+        }
+        return null;
+    }
     /**
      * Check if a URL pattern matches a pathname (exact match).
      * Patterns use :paramName format (e.g., /organizations/:organizationId/api-keys)
@@ -258,6 +296,53 @@ export class NavigationUtils {
         }
         return true;
     }
+    /**
+     * Score how *specific* a route pattern is, so the most precise active item can
+     * be chosen when several match the same URL.
+     *
+     * Primary metric is segment depth (a deeper pattern is more specific); the
+     * static-segment count breaks ties so a fully-literal route outranks a
+     * param-heavy one of equal depth (`/a/b/c` > `/a/:x/c`). `isActiveRoute`
+     * already guarantees the whole pattern matched, so the pattern's own segment
+     * count equals the number of matched segments.
+     */
+    static routeSpecificityScore(pattern) {
+        const normalized = pattern.split('?')[0]?.split('#')[0] ?? pattern;
+        const segments = normalized.split('/').filter(Boolean);
+        const staticSegments = segments.filter((segment) => !segment.startsWith(':')).length;
+        return segments.length * 100 + staticSegments;
+    }
+    /**
+     * Among a set of candidate route patterns, return the SINGLE most-specific one
+     * that `isActive` reports as active, or `undefined` when none are active.
+     *
+     * The per-item active check (`isActiveRoute`) marks a pattern active when the
+     * current path equals it OR is a CHILD of it (so a parent section stays
+     * highlighted on a sub-page). The side effect is that a menu listing BOTH a
+     * parent route (`…/todo-lists`) and a child route (`…/todo-lists/:listId/todos`)
+     * sees both report active on the child URL. Active-state highlighting must pick
+     * the most precise one, so callers that own the full candidate set (e.g. the
+     * sidebar) resolve the winner here instead of testing each item in isolation.
+     *
+     * `isActive` is injected (rather than taking a pathname) so callers can reuse
+     * their already-bound checker (e.g. `useNavigationState().isNavigationItemActive`)
+     * without this util depending on router state.
+     */
+    static getMostSpecificActiveRoute(patterns, isActive) {
+        let best;
+        let bestScore = -1;
+        for (const pattern of patterns) {
+            if (!pattern || !isActive(pattern)) {
+                continue;
+            }
+            const score = NavigationUtils.routeSpecificityScore(pattern);
+            if (score > bestScore) {
+                bestScore = score;
+                best = pattern;
+            }
+        }
+        return best;
+    }
     /**
      * Convert resourceType-keyed identifiers to fieldIdentifier-keyed identifiers for URL substitution.
      *
@@ -361,6 +446,29 @@ export class NavigationUtils {
                 urlPath: item.urlPath,
             });
         }
+        else if (isEnginePageNavigationItem(item)) {
+            navigate({
+                content: {
+                    contentType: NavigationContentType.ENGINE_PAGE,
+                    pageRef: item.pageRef,
+                },
+                initiator: NavigationUtils.createAppLevelInitiator(launcher),
+                urlPath: item.urlPath,
+            });
+        }
+        else if (isSettingsHubNavigationItem(item)) {
+            // URL-first via navigate()'s SETTINGS_HUB short-circuit → the route sync
+            // reconstructs the hub overlay. Keeps the sidebar consistent with every
+            // other settings entry point.
+            navigate({
+                content: {
+                    contentType: NavigationContentType.SETTINGS_HUB,
+                    sectionRef: item.sectionRef,
+                },
+                initiator: NavigationUtils.createAppLevelInitiator(launcher),
+                urlPath: item.urlPath,
+            });
+        }
         else if (isViewNavigationItem(item)) {
             navigate({
                 content: NavigationUtils.buildNavigationContentForViewItem(item),
@@ -414,6 +522,19 @@ export class NavigationUtils {
                 urlPath: target.urlPath,
             });
         }
+        else if (target.contentType === NavigationContentType.SETTINGS_HUB) {
+            // URL-first: navigate() short-circuits SETTINGS_HUB content to a route
+            // navigation, and `useSettingsHubRouterSync` reconstructs the hub in the
+            // overlay. Every settings entry point converges on this one path.
+            navigate({
+                content: {
+                    contentType: NavigationContentType.SETTINGS_HUB,
+                    sectionRef: target.sectionRef,
+                },
+                initiator: NavigationUtils.createAppLevelInitiator(launcher),
+                urlPath: target.urlPath,
+            });
+        }
         else if (target.componentRef) {
             navigate({
                 content: {
@@ -497,7 +618,7 @@ export class NavigationUtils {
      * Create initial navigation state.
      *
      * v3 shape: `{ zones: { primary, secondary, companion }, overlay: [] }`
-     * — DIALOG and SHEET merged into a single `overlay` stack.
+     * — Dialog, sheet, and drawer appearances share a single `overlay` stack.
      * — Former THIRD zone is now COMPANION.
      */
     static createInitialNavigationState() {
@@ -602,7 +723,7 @@ export class NavigationUtils {
             if (!routePaths || routePaths.length === 0) {
                 return undefined;
             }
-            const selected = frontendResourceUtils.selectMatchingRoutePath(routePaths, candidateContextIdentifiers, resourceConfig.resourceIdentifier, resourceConfig.resourceFieldIdentifier, parentResourcesRequirements);
+            const selected = frontendResourceUtils.selectMatchingRoutePath(routePaths, candidateContextIdentifiers, resourceConfig.resourceIdentifier, resourceConfig.resourceFieldIdentifier, parentResourcesRequirements, allResourceFieldIdentifiers);
             const templateUrl = selected.url;
             const routePathParameters = (selected.parameters ?? []);
             // Convert resourceType keys to fieldIdentifier keys for URL substitution
@@ -667,7 +788,20 @@ export class NavigationUtils {
             return undefined;
         }
         const matchingOperations = resourceConfig.operations.filter((op) => String(op.operationIdentifier) === operationId);
-        const defaultOperations = matchingOperations.filter((op) => op.isOperationDefault);
+        const defaultOperations = matchingOperations.filter((op) => op.isOperationDefault
+            && op.isBulkOperation !== true);
+        if ((operationVariantRef === 'default' || operationVariantRef === undefined) && defaultOperations.length > 1) {
+            logDebug('resolveOperationRef() failed: ambiguous default operation variants', {
+                resourceType,
+                operationId,
+                operationVariantRef,
+                candidateVariants: defaultOperations.map((op) => ({
+                    variantType: op.variantType,
+                    variantKey: op.variantKey,
+                })),
+            });
+            return undefined;
+        }
         const operation = operationVariantRef === 'default'
             ? defaultOperations.length === 1
                 ? defaultOperations[0]
@@ -829,7 +963,7 @@ export class NavigationUtils {
             ? (resolveEffectiveCoreOperationFromOperation(operation) ?? null)
             : null;
     }
-    static resolveAncestorOperationConfig(relationship, ancestorConfig) {
+    static resolveAncestorOperationConfig(relationship, ancestorConfig, runtimeContext) {
         const directOperations = (ancestorConfig.operations ?? []);
         const legacyOperations = !ancestorConfig.operations && ancestorConfig.operationsConfiguration
             ? Object.entries(ancestorConfig.operationsConfiguration).map(([operationIdentifier, operation]) => ({
@@ -840,7 +974,24 @@ export class NavigationUtils {
         const operations = directOperations.length > 0 ? directOperations : legacyOperations;
         if (operations.length === 0)
             return null;
-        const findOp = (op) => pickPreferredOperationForCoreSemantic(operations, op, { requireAddressable: true });
+        const findOp = (op) => {
+            const needsRuntimeAddressability = op === CoreResourceOperation.READ
+                || op === CoreResourceOperation.UPDATE
+                || op === CoreResourceOperation.DELETE;
+            if (runtimeContext && needsRuntimeAddressability) {
+                return pickPreferredOperationForCoreSemanticAddressability({
+                    resourceConfig: ancestorConfig,
+                    operations,
+                    coreOperation: op,
+                    registry: runtimeContext.registry,
+                    hasResourceId: frontendResourceUtils.getResourceId(runtimeContext.contextResourceIdentifiers[ancestorConfig.resourceIdentifier]).length > 0,
+                    requireFrontendAddressable: true,
+                    contextResourceIdentifiers: runtimeContext.contextResourceIdentifiers,
+                    contextualParameters: runtimeContext.contextualParameters,
+                });
+            }
+            return pickPreferredOperationForCoreSemantic(operations, op, { requireAddressable: true });
+        };
         // 1. Explicit override from display.inParentNavigation.ancestorOperation.
         // This allows relationship config to force a specific operation (LIST or READ)
         // for the ancestor zone, overriding the cardinality-based default.
@@ -990,4 +1141,4 @@ export class NavigationUtils {
         }
     }
 }
-//# sourceMappingURL=navigation.utils.js.map
+//# sourceMappingURL=navigation.utils.js.map