@wildo-ai/saas-frontend-lib 1.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/navigation/navigation.schemas.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,243 @@
+/**
+ * Navigation — Frontend Runtime Types
+ *
+ * Runtime types for zone state, navigation stacks/tabs, events, content,
+ * initiator context, and resolution results. These are the types the
+ * navigation controller, context, and rendering layer operate on.
+ *
+ * Configuration types (what developers configure) live in
+ * `@wildo-ai/saas-models` — `navigation.shared.schemas.ts`.
+ * This file imports config enums from there and defines runtime state on top.
+ *
+ * Key runtime concepts:
+ * - **NavigationZone**: type union = `NavigationZoneName | 'overlay'` — extends the 3
+ *   configurable zones with the implicit overlay destination (no enum duplication)
+ * - **NavigationState**: per-zone stack/tab state + separate overlay stack
+ * - **NavigationResolutionResult**: output of the resolver, consumed by the controller
+ *
+ * @see _code_archive/docs-archive/navigation/navigation-v3-reflection.md
+ */
+import { z } from 'zod';
+import { NavigationTransition, NavigationZoneName, OverlayAppearance, SplitAppearance, ParentDisplay, } from '@wildo-ai/saas-models';
+import { ApplicationLevelComponentType, } from '../../core/config/app-level-components.frontend.schemas.js';
+import { EnginePageRef } from '../../core/config/launcher-items.frontend.schemas.js';
+import { CoreResourceOperation, RequiredFeaturesConfigSchema, } from '@wildo-ai/saas-models';
+import { FrontendResourceOperationContextSchema, } from '../../core/resources/resources.frontend.schemas.js';
+// ════════════════════════════════════════════════════════════════
+// Runtime Enums
+// ════════════════════════════════════════════════════════════════
+/**
+ * Runtime zone identifiers — all possible destinations for navigation content.
+ *
+ * Extends `NavigationZoneName` (the 3 configurable zones) with `OVERLAY`,
+ * which is an implicit runtime destination (not a configurable zone).
+ *
+ * Implemented as a const object (spread of `NavigationZoneName` + `OVERLAY`)
+ * to avoid duplicating the 3 structural zone values already defined in
+ * `NavigationZoneName`. Use `NavigationZone.PRIMARY`, `NavigationZone.OVERLAY`, etc.
+ */
+const OVERLAY_ZONE = 'overlay';
+export const NavigationZone = {
+    ...NavigationZoneName,
+    /**
+     * Implicit floating layer above all zones. Not a configurable zone —
+     * always available as a destination for `overlay` transitions.
+     * Content renders as dialog or sheet based on the source zone's appearance config.
+     */
+    OVERLAY: OVERLAY_ZONE,
+};
+/** Zod schema for `NavigationZone` — validates any structural zone name or `'overlay'`. */
+export const NavigationZoneSchema = z.union([z.enum(NavigationZoneName), z.literal(OVERLAY_ZONE)]);
+/**
+ * All structural zones (excludes overlay).
+ * Used for iterating over zones that have configuration and state.
+ */
+export const NAVIGATION_STRUCTURAL_ZONES = Object.values(NavigationZoneName);
+/**
+ * Navigation source for app-shell actions (sidebar, command palette, hotkey, toast, notification).
+ * Used alongside `NavigationZone` to form the complete set of navigation origins.
+ * App-level navigation causes a layout reset: primary replaced, other zones cleared.
+ */
+export const APP_LEVEL_NAVIGATION_SOURCE = 'appLevel';
+/**
+ * What kind of content is being navigated to.
+ * Frontend-only — used by navigation stacks, resolution, and content rendering.
+ */
+export var NavigationContentType;
+(function (NavigationContentType) {
+    NavigationContentType["RESOURCE_OPERATION"] = "resource_operation";
+    NavigationContentType["COMPOSITE_VIEW"] = "composite_view";
+    NavigationContentType["CHART_VIEW"] = "chart_view";
+    NavigationContentType["FULL_CUSTOM_VIEW"] = "full_custom_view";
+    NavigationContentType["FLOWS_ACTORS_VIEW"] = "flows_actors_view";
+    NavigationContentType["EXECUTION_VIEW"] = "execution_view";
+    NavigationContentType["CUSTOM_COMPONENT"] = "custom_component";
+    NavigationContentType["ENGINE_PAGE"] = "engine_page";
+    NavigationContentType["INLINE_CREATE"] = "inline_create";
+    NavigationContentType["ERROR_MODAL"] = "error_modal";
+})(NavigationContentType || (NavigationContentType = {}));
+/**
+ * How a navigation entry was created — tracks the origin of each stack entry.
+ *
+ * Used to coordinate between controller-initiated (programmatic) and
+ * URL-initiated (browser back/forward, direct link) navigation.
+ * The controller needs to know if a navigation event came from URL sync
+ * to avoid infinite loops (URL change → navigate → URL change → ...).
+ */
+export var NavigationSource;
+(function (NavigationSource) {
+    /** Navigation triggered programmatically by useNavigationController. */
+    NavigationSource["CONTROLLER"] = "controller";
+    /** Navigation triggered by URL change (bookmark, back button, direct link). */
+    NavigationSource["URL_SYNC"] = "url_sync";
+})(NavigationSource || (NavigationSource = {}));
+// ════════════════════════════════════════════════════════════════
+// Navigation Item Types (app-level sidebar, command menu, etc.)
+// ════════════════════════════════════════════════════════════════
+/**
+ * Discriminator for navigation item variants.
+ * Navigation items appear in the sidebar, command menu, and toolbar.
+ */
+export var NavigationItemType;
+(function (NavigationItemType) {
+    /** A navigable resource operation (list, read, create for a resource type). */
+    NavigationItemType["RESOURCE"] = "resource";
+    /** A navigable view (composite, chart, custom, flows/actors). */
+    NavigationItemType["VIEW"] = "view";
+    /** A navigable generic custom component. */
+    NavigationItemType["CUSTOM_COMPONENT"] = "custom_component";
+})(NavigationItemType || (NavigationItemType = {}));
+/** Type guard — narrows `AnyNavigationItem` to `ResourceNavigationItem`. */
+export function isResourceNavigationItem(item) {
+    return item.itemType === NavigationItemType.RESOURCE;
+}
+/** Type guard — narrows `AnyNavigationItem` to `ViewNavigationItem`. */
+export function isViewNavigationItem(item) {
+    return item.itemType === NavigationItemType.VIEW;
+}
+/** Type guard — narrows `AnyNavigationItem` to `CustomComponentNavigationItem`. */
+export function isCustomComponentNavigationItem(item) {
+    return item.itemType === NavigationItemType.CUSTOM_COMPONENT;
+}
+// ════════════════════════════════════════════════════════════════
+// Zod Validation Schemas (for runtime event validation)
+// ════════════════════════════════════════════════════════════════
+/**
+ * Zod schema for `NavigationSourceRelationship`.
+ * Intentional lightweight subset of the full relationship schema —
+ * only navigation-relevant fields for event validation.
+ */
+const navigationSourceRelationshipSchema = z.object({
+    parentResourceType: z.string(),
+    parentResourceId: z.string().optional(),
+    childResourceType: z.string(),
+    foreignKeyField: z.string().optional(),
+    relationshipEdgeKey: z.string().optional(),
+    inChildView: z.object({
+        showParentLink: z.boolean().optional(),
+        parentDisplay: z.enum(ParentDisplay).optional(),
+    }).optional(),
+});
+/** Zod schema for `NavigationInitiatorContext` — validates navigation event source. */
+export const NavigationInitiatorContextSchema = z.object({
+    sourceZone: z.union([NavigationZoneSchema, z.literal(APP_LEVEL_NAVIGATION_SOURCE)]),
+    launcher: z.enum(ApplicationLevelComponentType).optional(),
+    sourceOperation: z.enum(CoreResourceOperation).optional(),
+    sourceRelationship: navigationSourceRelationshipSchema.optional(),
+});
+/** Zod schema for resource operation content. */
+const navigationContent_ResourceOperationSchema = z.object({
+    contentType: z.literal(NavigationContentType.RESOURCE_OPERATION),
+    resourceContext: FrontendResourceOperationContextSchema,
+});
+/** Zod schema for composite view content. */
+const navigationContent_CompositeViewSchema = z.object({
+    contentType: z.literal(NavigationContentType.COMPOSITE_VIEW),
+    viewRef: z.string(),
+    contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),
+});
+/** Zod schema for chart view content. */
+const navigationContent_ChartViewSchema = z.object({
+    contentType: z.literal(NavigationContentType.CHART_VIEW),
+    viewRef: z.string(),
+    contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),
+    urlParamValues: z.record(z.string(), z.string()).optional(),
+    requiredFeatures: RequiredFeaturesConfigSchema.optional(),
+    // Pre-resolved chart payloads ride on the navigation stack as runtime
+    // transport objects. They are already type-checked at construction sites; the
+    // stack schema only needs to validate that optional payload slots exist.
+    viewDefinition: z.custom(() => true).optional(),
+    runtimeDescriptor: z.custom(() => true).optional(),
+});
+/** Zod schema for full custom view content. */
+const navigationContent_FullCustomViewSchema = z.object({
+    contentType: z.literal(NavigationContentType.FULL_CUSTOM_VIEW),
+    viewRef: z.string(),
+    fullCustomComponentRef: z.string(),
+    contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),
+});
+/** Zod schema for flows/actors view content. */
+const navigationContent_FlowsActorsViewSchema = z.object({
+    contentType: z.literal(NavigationContentType.FLOWS_ACTORS_VIEW),
+    viewRef: z.string(),
+    flowsActorsSystemRefs: z.array(z.string()),
+    contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),
+});
+/** Zod schema for execution view content. */
+const navigationContent_ExecutionViewSchema = z.object({
+    contentType: z.literal(NavigationContentType.EXECUTION_VIEW),
+    viewRef: z.string(),
+    contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),
+});
+/** Zod schema for generic custom component content. */
+const navigationContent_CustomComponentSchema = z.object({
+    contentType: z.literal(NavigationContentType.CUSTOM_COMPONENT),
+    componentRef: z.string(),
+    contextResourceIdentifiers: z.record(z.string(), z.string()).optional(),
+});
+/** Zod schema for engine page content. */
+const navigationContent_EnginePageSchema = z.object({
+    contentType: z.literal(NavigationContentType.ENGINE_PAGE),
+    pageRef: z.nativeEnum(EnginePageRef),
+});
+/** Zod schema for inline create content. */
+const navigationContent_InlineCreateSchema = z.object({
+    contentType: z.literal(NavigationContentType.INLINE_CREATE),
+    resourceContext: FrontendResourceOperationContextSchema,
+    defaultValues: z.record(z.string(), z.unknown()),
+});
+/** Zod schema for error modal content. */
+const navigationContent_ErrorModalSchema = z.object({
+    contentType: z.literal(NavigationContentType.ERROR_MODAL),
+    errorType: z.string(),
+    message: z.string(),
+    context: z.record(z.string(), z.unknown()).optional(),
+    wildoError: z.unknown().optional(),
+});
+/** Discriminated union schema for all navigation content types. */
+export const NavigationContentSchema = z.discriminatedUnion('contentType', [
+    navigationContent_ResourceOperationSchema,
+    navigationContent_CompositeViewSchema,
+    navigationContent_ChartViewSchema,
+    navigationContent_FullCustomViewSchema,
+    navigationContent_FlowsActorsViewSchema,
+    navigationContent_ExecutionViewSchema,
+    navigationContent_CustomComponentSchema,
+    navigationContent_EnginePageSchema,
+    navigationContent_InlineCreateSchema,
+    navigationContent_ErrorModalSchema,
+]);
+/** Zod schema for a single navigation stack entry — validates serialized navigation state. */
+export const NavigationStackEntrySchema = z.object({
+    id: z.string(),
+    content: NavigationContentSchema,
+    urlPath: z.string().optional(),
+    timestamp: z.number(),
+    zone: NavigationZoneSchema,
+    initiator: NavigationInitiatorContextSchema.optional(),
+    navigationSource: z.enum(NavigationSource),
+    transition: z.enum(NavigationTransition),
+    appearance: z.union([z.enum(OverlayAppearance), z.enum(SplitAppearance)]).optional(),
+    ephemeral: z.boolean().optional(),
+});
+//# sourceMappingURL=navigation.schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.schemas.js","sourceRoot":"","sources":["../../../../src/core/navigation/navigation.schemas.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,373 @@
+/**
+ * Navigation Utilities
+ *
+ * Shared utility functions for the navigation system.
+ * 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 { 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';
+/**
+ * Navigation utility class with static methods for navigation operations
+ */
+export declare class NavigationUtils {
+    private static resolveContextIdentifierValue;
+    private static _transactionActive;
+    private static _transactionSource;
+    private static _transactionAutoCommitTimer;
+    private static _transactionSafetyTimer;
+    /**
+     * Begin a navigation transaction.
+     *
+     * While active, useRouterSync skips synchronization to prevent stale content
+     * from being pushed to the navigation stack during multi-step operations.
+     *
+     * Transactions auto-commit after the current event loop iteration (setTimeout(0))
+     * to handle the common case where explicit commitTransaction() is omitted.
+     * A safety timeout (5s) prevents permanent suppression if something goes wrong.
+     *
+     * @param source - Descriptive label for debugging (e.g., 'home_navigation', 'org_switch')
+     */
+    static beginTransaction(source: string): void;
+    /**
+     * 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.
+     */
+    static commitTransaction(): void;
+    /**
+     * Check if a navigation transaction is currently active.
+     *
+     * Used by useRouterSync to decide whether to skip synchronization.
+     * Unlike the old consumeRouterSyncSuppression(), this does NOT consume
+     * the flag — the transaction remains active until committed.
+     */
+    static isInTransaction(): boolean;
+    /**
+     * Get the current transaction source label (for debugging).
+     */
+    static getTransactionSource(): string | null;
+    /**
+     * Build the canonical browser URL string used by navigation ownership checks.
+     *
+     * We compare full addressable URLs (`pathname + search`) rather than mixing
+     * pathname-only and query-bearing variants across different runtime entry
+     * points. This keeps URL-first reconstruction truthful for views that encode
+     * meaningful state in query params.
+     */
+    static buildBrowserUrl(pathname: string, search?: string): string;
+    /**
+     * Normalize a stored URL before route-owner comparisons.
+     *
+     * We intentionally preserve query parameters because they participate in
+     * addressable navigation state, but drop hash fragments because the runtime
+     * does not model them as navigation ownership signals.
+     */
+    static normalizeComparableUrl(urlPath: string | undefined): string | undefined;
+    /**
+     * Resolve which structural zone currently owns a URL.
+     *
+     * URL-first reconstruction must only trust the visible top entry of a zone,
+     * never a stale entry buried deeper in a backstack. We therefore scan the
+     * structural zones from deepest to shallowest and only match against each
+     * zone's current top entry.
+     */
+    static findStructuralRouteOwner(urlPath: string, getZoneState: (zone: NavigationZoneName) => NavigationZoneState): {
+        zone: NavigationZoneName;
+        entry: NavigationStackEntry;
+    } | null;
+    /**
+     * Check if a URL pattern matches a pathname (exact match).
+     * Patterns use :paramName format (e.g., /organizations/:organizationId/api-keys)
+     * and pathnames have actual values (e.g., /organizations/abc123/api-keys).
+     *
+     * @param pattern - URL pattern with :paramName placeholders
+     * @param pathname - Actual URL pathname with resolved values
+     * @returns true if the pattern matches the pathname
+     */
+    static matchUrlPattern(pattern: string, pathname: string): boolean;
+    /**
+     * Check if pathname matches pattern or is a child of it.
+     * Used to determine if a navigation item should be marked as active.
+     *
+     * @param pattern - URL pattern with :paramName placeholders
+     * @param pathname - Actual URL pathname
+     * @returns true if the pathname matches the pattern or is a child route
+     */
+    static isActiveRoute(pattern: string, pathname: string): boolean;
+    /**
+     * Convert resourceType-keyed identifiers to fieldIdentifier-keyed identifiers for URL substitution.
+     *
+     * Frontend URLs use :fieldIdentifier format (e.g., :organizationId), but contextResourceIdentifiers
+     * use resourceType as keys (e.g., 'organizations'). This function converts between the two.
+     *
+     * @param resourceTypeIdentifiers - Map with resourceType keys (e.g., { organizations: 'org-123' })
+     * @param allResourceFieldIdentifiers - Registry mapping from resourceType to fieldIdentifier
+     * @returns Map with fieldIdentifier keys (e.g., { organizationId: 'org-123' })
+     */
+    static convertToFieldIdentifierKeys(resourceTypeIdentifiers: Record<string, string>, allResourceFieldIdentifiers: Record<string, string>): Record<string, string>;
+    /**
+     * Resolve URL path placeholders with actual values from context identifiers.
+     *
+     * Frontend URLs use :fieldIdentifier format (React Router style, e.g., /organizations/:organizationId/api-keys).
+     * This function replaces these placeholders with actual values.
+     *
+     * @param urlPath - URL path with :paramName placeholders
+     * @param fieldIdentifiers - Map with fieldIdentifier keys (e.g., { organizationId: 'org-123' })
+     * @returns Resolved URL path with placeholders replaced
+     */
+    static resolveUrlPath(urlPath: string | undefined, fieldIdentifiers: Record<string, string | number>): string | undefined;
+    /**
+     * Check if a URL path still contains unresolved :paramName or {paramName} placeholders.
+     * Used as a sending-side guard to prevent writing malformed URLs to the browser or API calls.
+     *
+     * @param urlPath - Resolved URL path to check
+     * @returns true if unresolved placeholders remain
+     */
+    static hasUnresolvedPlaceholders(urlPath: string): boolean;
+    /**
+     * Helper to create initiator context for app-level launchers
+     *
+     * @param launcher - The app-level action launcher
+     * @returns Navigation initiator context for app-level navigation
+     */
+    static createAppLevelInitiator(launcher: ApplicationLevelComponentType): NavigationInitiatorContext;
+    /**
+     * Dispatch navigation for an AnyNavigationItem — DRY helper shared
+     * across all behavior hooks that convert a nav item click into a
+     * `navigate()` call.
+     */
+    static dispatchNavigationForItem(navigate: (options: {
+        content: NavigationContent;
+        initiator: NavigationInitiatorContext;
+        urlPath: string;
+    }) => void, item: AnyNavigationItem, launcher: ApplicationLevelComponentType): void;
+    /**
+     * Dispatch navigation for a resolved target (from the new per-launcher resolution layer).
+     *
+     * Builds `NavigationContent` from the resolved target's fields, dispatching
+     * on presence of `resourceContext` (resource items) vs `viewRef`+`contentType` (view items).
+     */
+    static dispatchNavigationForResolvedTarget(navigate: (options: {
+        content: NavigationContent;
+        initiator: NavigationInitiatorContext;
+        urlPath: string;
+    }) => void, target: {
+        urlPath: string;
+        resourceContext?: FrontendResourceOperationContext;
+        viewRef?: string;
+        contentType?: NavigationContentType;
+        pageRef?: string;
+        fullCustomComponentRef?: string;
+        flowsActorsSystemRefs?: string[];
+        componentRef?: string;
+        requiredFeatures?: RequiredFeaturesConfig;
+        contextResourceIdentifiers?: Record<string, string>;
+        urlParamValues?: Record<string, string>;
+    }, launcher: ApplicationLevelComponentType): void;
+    /**
+     * Build navigation content from resolved view fields.
+     * Mirrors `buildNavigationContentForViewItem` but operates on loose fields
+     * from `ResolvedNavigationTarget` instead of `ViewNavigationItem`.
+     */
+    static buildNavigationContentForResolvedView(viewRef: string, contentType: NavigationContentType, fullCustomComponentRef?: string, flowsActorsSystemRefs?: string[], contextResourceIdentifiers?: Record<string, string>, urlParamValues?: Record<string, string>, requiredFeatures?: RequiredFeaturesConfig): NavigationContent;
+    /**
+     * Create initiator context for operation-related navigation (from within a structural zone).
+     */
+    static createOperationInitiator(sourceZone?: NavigationZone | string, sourceOperation?: string): NavigationInitiatorContext;
+    /**
+     * Create initial empty zone state
+     */
+    static createEmptyZoneState(zone: NavigationZoneName): NavigationZoneState;
+    /**
+     * Create initial navigation state.
+     *
+     * v3 shape: `{ zones: { primary, secondary, companion }, overlay: [] }`
+     * — DIALOG and SHEET merged into a single `overlay` stack.
+     * — Former THIRD zone is now COMPANION.
+     */
+    static createInitialNavigationState(): NavigationState;
+    /**
+     * Get the current depth of a zone's stack
+     */
+    static getZoneDepth(state: NavigationZoneState | undefined): number;
+    /**
+     * Get the top entry of a zone's stack (current content)
+     */
+    static getTopEntry(state: NavigationZoneState): NavigationStackEntry | undefined;
+    /**
+     * Calculate the resource relationship depth from parentResourcesRequirements.
+     *
+     * This is the correct depth metric for navigation policy resolution:
+     * - Root resource (no parents) → depth 0
+     * - First-level child (1 parent) → depth 1
+     * - Grandchild (2 parents) → depth 2
+     *
+     * Unlike viewDepth (stack-based), this reflects the actual resource hierarchy
+     * depth, which is what the navigation policy's depth matrix cares about.
+     *
+     * @param parentResourcesRequirements - Array of parent resource requirements
+     * @returns The resource relationship depth (0 = root, 1 = child, 2 = grandchild, etc.)
+     */
+    static calculateResourceRelationshipDepth(parentResourcesRequirements?: unknown[] | null): number;
+    /**
+     * Resolve the structural zone that should own a routed resource entry based on
+     * its relationship depth and the zones available in the current layout.
+     *
+     * This is shared by URL-sync restoration and AppRouter's routed page wrapper so
+     * the page props and the live navigation stack cannot disagree about whether a
+     * deep-linked resource belongs to PRIMARY, SECONDARY, or COMPANION.
+     */
+    static resolveResourceTargetZone(depth: number, options?: {
+        hasSecondary?: boolean;
+        hasCompanion?: boolean;
+    }): NavigationZoneName;
+    /**
+     * Generate a unique stack entry ID
+     */
+    static generateStackEntryId(): string;
+    /**
+     * Check if content is a resource operation
+     */
+    static isResourceOperationContent(content: NavigationContent): content is NavigationContent & {
+        contentType: NavigationContentType.RESOURCE_OPERATION;
+    };
+    /**
+     * Resolve the URL for a resource operation given candidate context identifiers.
+     *
+     * This is the unified URL resolution pipeline, centralizing the logic that was
+     * previously duplicated across useNavigationController, NavigationContext, and useRouterSync.
+     *
+     * Steps:
+     * 1. Build all possible route paths for the operation
+     * 2. Select the best matching route path based on available context
+     * 3. Convert resourceType keys to fieldIdentifier keys
+     * 4. Ensure FK-prefixed placeholders resolve correctly
+     * 5. Resolve :placeholder patterns with actual values
+     *
+     * @param resourceConfig - The frontend resource configuration
+     * @param operation - The operation configuration
+     * @param candidateContextIdentifiers - Normalized context identifiers (resourceType → id)
+     * @param allResourceFieldIdentifiers - Registry mapping resourceType → fieldIdentifier
+     * @param parentResourcesRequirements - Optional parent resource requirements for route selection
+     * @returns Resolved URL info, or undefined if resolution fails
+     */
+    static resolveResourceUrl(resourceConfig: AnyFrontendResourceConfiguration, operation: FrontendResourceConfiguration_Operation, candidateContextIdentifiers: Record<string, string>, allResourceFieldIdentifiers: Record<string, string>, parentResourcesRequirements?: unknown[]): {
+        resolvedUrl: string | undefined;
+        templateUrl: string;
+        routePathParameters: ResourceConfiguration_Operation_UrlParameterInfo[];
+    } | undefined;
+    /**
+     * Resolve an operationRef string (e.g., "TASKS.LIST.default") into a full
+     * NavigationContent_ResourceOperation by looking up the operation in the registry.
+     *
+     * This is the resolution step for **unresolved operation refs** — a lightweight
+     * navigation input format where the emitter only knows a ref string, not a full
+     * NavigationContent payload.
+     *
+     * **Consumers:**
+     * - NAVIGATION_REQUEST event listener (in useNavigationController): resolves
+     *   `payload.operationRef` before entering the navigation pipeline. Used by
+     *   emitters that sit above ResourceRegistryProvider (e.g., NotificationProvider).
+     * - RouterErrorBoundary: calls this directly to resolve error guidance nextAction
+     *   refs, since NavigationProvider is destroyed in the error boundary context.
+     *
+     * @param operationRef   Dot-separated ref, e.g., "TASKS.LIST.default" or "TASKS.LIST"
+     * @param additionalIdentifiers  Optional context identifiers (orgId, resourceId, etc.)
+     * @param registry       The frontend resource registry for operation lookup
+     * @returns Resolved NavigationContent_ResourceOperation, or undefined if lookup fails
+     */
+    static resolveOperationRef(operationRef: string, additionalIdentifiers: Record<string, string> | undefined, registry: FrontendResourcesRegistry): NavigationContent | undefined;
+    /**
+     * Build NavigationContent from a ViewNavigationItem.
+     *
+     * Centralizes the viewType → NavigationContent conversion that was previously
+     * duplicated across every preset component's click handler.
+     */
+    static buildNavigationContentForViewItem(item: ViewNavigationItem): NavigationContent;
+    /**
+     * Find the relationship between two resource types in the registry.
+     *
+     * Searches the global `resourceRelationships` array for a match where:
+     * - resourceType1 = parentType, resourceType2 = childType
+     * - Optionally filtered by foreignKeyField for disambiguation
+     *
+     * @param parentType - The parent resource type (resourceType1 side)
+     * @param childType - The child resource type (resourceType2 side)
+     * @param registry - The frontend resources registry
+     * @param foreignKeyField - Optional FK field for disambiguation when multiple relationships exist
+     * @returns The matching ResourceRelationship, or undefined
+     */
+    static findRelationshipBetween(parentType: string, childType: string, registry: FrontendResourcesRegistry, foreignKeyField?: string): ResourceRelationship | undefined;
+    /**
+     * Determine the default ancestor operation based on relationship cardinality.
+     *
+     * Cardinality semantics:
+     * - 1:N (parent ONE → child MANY): ancestor shows LIST (list of children / siblings)
+     * - 1:1 (parent ONE → child ONE): ancestor shows READ (parent detail)
+     * - N:1 (reversed perspective): ancestor shows READ (parent detail)
+     * - M:N (junction): ancestor shows LIST (related items)
+     *
+     * @param relationship - The resource relationship
+     * @returns The default CoreResourceOperation for the ancestor zone
+     */
+    static deriveDefaultAncestorOperation(relationship: ResourceRelationship): CoreResourceOperation;
+    /**
+     * Resolve the ancestor operation for a given relationship.
+     *
+     * Resolution order:
+     * 1. Explicit `ancestorOperation` override from display.inParentNavigation → use directly
+     * 2. Cardinality-based default (deriveDefaultAncestorOperation)
+     * 3. Fallback: swap LIST ↔ READ if default is not available
+     * 4. null if no suitable operation exists
+     *
+     * @param relationship - The resource relationship between ancestor and descendant
+     * @param ancestorConfig - The ancestor resource's frontend configuration
+     * @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;
+    /**
+     * Check if secondary/companion zone content is relevant to the current PRIMARY top entry.
+     *
+     * Content is considered "stale" (irrelevant) when:
+     * - It's a resource operation whose parentResourcesRequirements no longer match
+     *   the PRIMARY zone's parent resource type and id
+     * - It's a view (composite/chart) — always stale on PRIMARY change
+     *
+     * @param dependentContent - Content in SECONDARY or COMPANION zone
+     * @param primaryContent - Current top content in PRIMARY zone
+     * @returns true if the dependent content is still relevant to the primary
+     */
+    static isContentRelevantToParent(dependentContent: NavigationContent, primaryContent: NavigationContent): boolean;
+    /**
+     * Determine whether a parent reference should be shown in a child resource view.
+     *
+     * Uses navigation context, inline rendering state, and relationship config
+     * to decide if showing a parent link/badge is appropriate or redundant.
+     *
+     * @param inlineParentContext - Set by ContainerNested when rendering inline children
+     * @param navigationZone - Which zone the child is rendered in
+     * @param navigationInitiator - How the child was navigated to (source, relationship info)
+     * @param getZoneState - Function to check another zone's current state (for staleness detection)
+     *
+     */
+    static shouldShowParentReference(inlineParentContext: InlineParentContext | undefined, navigationZone: NavigationZone | string, navigationInitiator: NavigationInitiatorContext | undefined, getZoneState?: (zone: NavigationZoneName) => NavigationZoneState | undefined): boolean;
+    /**
+     * Resolve the default `showParentLink` value for a relationship when
+     * `display.inChildView.showParentLink` is not explicitly configured.
+     *
+     * Rule: `true` for required FK fields (the parent is integral to the child),
+     *        `false` for optional FK fields (the parent is an optional association).
+     *
+     * @param schema - The child resource schema
+     * @param fkFieldName - The foreign key field name on the child
+     */
+    static resolveDefaultShowParentLink(schema: z.ZodTypeAny, fkFieldName: string): boolean;
+}
+//# sourceMappingURL=navigation.utils.d.ts.map