@ankhorage/contracts 11.0.0 → 11.1.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ankhorage/contracts
 
+## 11.1.0
+
+### Minor Changes
+
+- 8a62b08: Expose the portable Navigator planning, generation, and custom-registration contracts through the navigator subpath. Group related declarations by topic so Navigator and Studio can consume canonical shared types without depending on another capability's type exports.
+
 ## 11.0.0
 
 ### Major Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # CONTRACTS
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v10.1.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v11.1.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
 
 Serializable app, action, theme, auth, and secret-store contracts for Ankhorage.
 

package/dist/navigator/extensions.d.ts

@@ -0,0 +1,23 @@
+import type { CustomNavigatorNode } from '../navigator';
+import type { NavigatorApiStability, NavigatorRuntimePlatform } from './planning';
+export interface CustomNavigatorConfigIssue {
+    code: string;
+    message: string;
+    path?: string;
+}
+export interface CustomNavigatorRegistration {
+    readonly id: string;
+    readonly platforms: readonly NavigatorRuntimePlatform[];
+    readonly stability: NavigatorApiStability;
+    readonly integration: 'expo-router-standard';
+    readonly router: 'stack' | 'tab';
+    readonly module: string;
+    readonly exportName: string;
+    readonly validateConfig: (config: CustomNavigatorNode['config']) => readonly CustomNavigatorConfigIssue[];
+}
+export type CustomNavigatorRegistry = Readonly<Record<string, CustomNavigatorRegistration>> & {
+    readonly [CUSTOM_NAVIGATOR_REGISTRY]: true;
+};
+declare const CUSTOM_NAVIGATOR_REGISTRY: unique symbol;
+export {};
+//# sourceMappingURL=extensions.d.ts.map

package/dist/navigator/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/navigator/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAClF,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,CACvB,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,KAClC,SAAS,0BAA0B,EAAE,CAAC;CAC5C;AAED,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC,GAAG;IAC5F,QAAQ,CAAC,CAAC,yBAAyB,CAAC,EAAE,IAAI,CAAC;CAC5C,CAAC;AAEF,OAAO,CAAC,MAAM,yBAAyB,EAAE,OAAO,MAAM,CAAC"}

package/dist/navigator/extensions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extensions.js.map

package/dist/navigator/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../../src/navigator/extensions.ts"],"names":[],"mappings":"","sourcesContent":["import type { CustomNavigatorNode } from '../navigator';\nimport type { NavigatorApiStability, NavigatorRuntimePlatform } from './planning';\nexport interface CustomNavigatorConfigIssue {\n  code: string;\n  message: string;\n  path?: string;\n}\n\nexport interface CustomNavigatorRegistration {\n  readonly id: string;\n  readonly platforms: readonly NavigatorRuntimePlatform[];\n  readonly stability: NavigatorApiStability;\n  readonly integration: 'expo-router-standard';\n  readonly router: 'stack' | 'tab';\n  readonly module: string;\n  readonly exportName: string;\n  readonly validateConfig: (\n    config: CustomNavigatorNode['config'],\n  ) => readonly CustomNavigatorConfigIssue[];\n}\n\nexport type CustomNavigatorRegistry = Readonly<Record<string, CustomNavigatorRegistration>> & {\n  readonly [CUSTOM_NAVIGATOR_REGISTRY]: true;\n};\n\ndeclare const CUSTOM_NAVIGATOR_REGISTRY: unique symbol;\n"]}

package/dist/navigator/generation.d.ts

@@ -0,0 +1,26 @@
+export interface NavigatorGeneratedFile {
+    path: string;
+    contents: string;
+}
+export interface NavigatorGenerationBindings {
+    screens: Readonly<Record<string, NavigatorScreenModule>>;
+    guards: Readonly<Record<string, NavigatorScreenModule>>;
+    iconSourceResolver?: NavigatorScreenModule;
+    flows?: {
+        onboardingRoute?: string;
+        authenticationRoute?: string;
+    };
+    tabPresentations?: Readonly<Record<string, NavigatorScreenModule>>;
+}
+/** Options for placing Navigator-owned files inside a consumer-owned Expo Router app shell. */
+export interface NavigatorGenerationOptions {
+    /** Directory that receives the root navigator layout. Must be `src/app` or one of its safe descendants. */
+    rootDirectory?: string;
+    /** Emit routed screen re-export modules in addition to layouts. Defaults to true. */
+    includeScreenFiles?: boolean;
+}
+export interface NavigatorScreenModule {
+    module: string;
+    exportName: string;
+}
+//# sourceMappingURL=generation.d.ts.map

package/dist/navigator/generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation.d.ts","sourceRoot":"","sources":["../../src/navigator/generation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;IACzD,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;IACxD,kBAAkB,CAAC,EAAE,qBAAqB,CAAC;IAC3C,KAAK,CAAC,EAAE;QACN,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,gBAAgB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;CACpE;AAED,+FAA+F;AAC/F,MAAM,WAAW,0BAA0B;IACzC,2GAA2G;IAC3G,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/navigator/generation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=generation.js.map

package/dist/navigator/generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation.js","sourceRoot":"","sources":["../../src/navigator/generation.ts"],"names":[],"mappings":"","sourcesContent":["export interface NavigatorGeneratedFile {\n  path: string;\n  contents: string;\n}\n\nexport interface NavigatorGenerationBindings {\n  screens: Readonly<Record<string, NavigatorScreenModule>>;\n  guards: Readonly<Record<string, NavigatorScreenModule>>;\n  iconSourceResolver?: NavigatorScreenModule;\n  flows?: {\n    onboardingRoute?: string;\n    authenticationRoute?: string;\n  };\n  tabPresentations?: Readonly<Record<string, NavigatorScreenModule>>;\n}\n\n/** Options for placing Navigator-owned files inside a consumer-owned Expo Router app shell. */\nexport interface NavigatorGenerationOptions {\n  /** Directory that receives the root navigator layout. Must be `src/app` or one of its safe descendants. */\n  rootDirectory?: string;\n  /** Emit routed screen re-export modules in addition to layouts. Defaults to true. */\n  includeScreenFiles?: boolean;\n}\n\nexport interface NavigatorScreenModule {\n  module: string;\n  exportName: string;\n}\n"]}

package/dist/navigator/planning.d.ts

@@ -0,0 +1,105 @@
+import type { CustomNavigatorNode, DrawerNavigatorOptions, NavigatorType, RouteDefinition, StackImplementation, StackScreenOptions } from '../navigator';
+import type { CustomNavigatorRegistry } from './extensions';
+export interface ResolvedCustomTabsPresentation {
+    presentation: ResolvedTabsPresentation;
+    customPresentationId?: string;
+}
+export type ResolvedTabsImplementation = 'custom' | 'javascript' | 'native';
+export type ResolvedTabsPresentation = 'bottom' | 'top' | 'rail' | 'sidebar' | 'custom';
+/**
+ * Disposable adapter plan for a `tabs` topology.
+ *
+ * The implementation selects the Router runtime. Presentation only selects its visual chrome and
+ * never creates another route topology.
+ */
+export interface TabsNavigatorPlan {
+    implementation: ResolvedTabsImplementation;
+    module: ExpoRouterNavigatorModule;
+    exportName: string;
+    stability: NavigatorApiStability;
+    presentation?: ResolvedTabsPresentation;
+    presentations?: Readonly<Record<NavigatorResponsiveSize, ResolvedTabsPresentation>>;
+    customPresentationId?: string;
+    minimizeBehavior?: 'automatic' | 'never' | 'onScrollDown' | 'onScrollUp';
+    bottomAccessoryScreenId?: string;
+}
+export interface CreateNavigatorPlanOptions {
+    platform: NavigatorRuntimePlatform;
+    expoRouterVersion: string;
+    responsiveSize?: NavigatorResponsiveSize;
+    customNavigators?: CustomNavigatorRegistry;
+}
+export type ExpoRouterNavigatorModule = 'expo-router' | 'expo-router/drawer' | 'expo-router/js-stack' | 'expo-router/js-tabs' | 'expo-router/js-top-tabs' | 'expo-router/ui' | 'expo-router/unstable-split-view' | 'expo-router/unstable-native-tabs';
+export type NavigatorAdapterId = 'slot' | 'stack.native' | 'stack.javascript' | 'stack.experimental' | 'drawer' | 'tabs.native' | 'tabs.javascript' | 'tabs.custom' | 'split-view' | 'custom';
+export interface NavigatorAdapterPlan {
+    id: NavigatorAdapterId;
+    /** Built-in Expo Router entry point or an explicitly registered custom module. */
+    module?: string;
+    exportName?: string;
+    support: NavigatorSupportStatus;
+    stability: NavigatorApiStability;
+    limitations: readonly string[];
+}
+export type NavigatorApiStability = 'stable' | 'alpha';
+export interface NavigatorDiagnostic {
+    code: string;
+    severity: 'error' | 'warning';
+    path: string;
+    message: string;
+}
+export interface NavigatorNodePlan {
+    type: NavigatorType;
+    pointer: string;
+    adapter: NavigatorAdapterPlan;
+    initialRouteName?: string;
+    routes: readonly NavigatorRoutePlan[];
+    stack?: {
+        implementation: StackImplementation;
+        options?: StackScreenOptions;
+    };
+    drawer?: {
+        options?: DrawerNavigatorOptions;
+    };
+    tabs?: TabsNavigatorPlan;
+    splitView?: {
+        columns: {
+            primary: string;
+            supplementary?: string;
+        };
+        inspector?: string;
+        topColumnForCollapsing?: 'primary' | 'secondary' | 'supplementary';
+    };
+    custom?: {
+        navigatorId: string;
+        config?: CustomNavigatorNode['config'];
+    };
+}
+export interface NavigatorPlan {
+    context: NavigatorValidationContext;
+    root: NavigatorNodePlan;
+    diagnostics: readonly NavigatorDiagnostic[];
+    supported: boolean;
+    flows: {
+        onboarding: boolean;
+        authentication: boolean;
+    };
+}
+export type NavigatorResponsiveSize = 'compact' | 'medium' | 'expanded';
+export interface NavigatorRoutePlan {
+    name: string;
+    path?: string;
+    label?: string;
+    icon?: RouteDefinition['icon'];
+    showInPrimaryNavigation?: boolean;
+    guards: readonly string[];
+    screenId?: string;
+    stackOptions?: StackScreenOptions;
+    navigator?: NavigatorNodePlan;
+}
+export type NavigatorRuntimePlatform = 'android' | 'ios' | 'web';
+export type NavigatorSupportStatus = 'supported' | 'unavailable';
+export interface NavigatorValidationContext {
+    platform: NavigatorRuntimePlatform;
+    expoRouterVersion: string;
+}
+//# sourceMappingURL=planning.d.ts.map

package/dist/navigator/planning.d.ts.map

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

package/dist/navigator/planning.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=planning.js.map

package/dist/navigator/planning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.js","sourceRoot":"","sources":["../../src/navigator/planning.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  CustomNavigatorNode,\n  DrawerNavigatorOptions,\n  NavigatorType,\n  RouteDefinition,\n  StackImplementation,\n  StackScreenOptions,\n} from '../navigator';\nimport type { CustomNavigatorRegistry } from './extensions';\n\nexport interface ResolvedCustomTabsPresentation {\n  presentation: ResolvedTabsPresentation;\n  customPresentationId?: string;\n}\n\nexport type ResolvedTabsImplementation = 'custom' | 'javascript' | 'native';\n\nexport type ResolvedTabsPresentation = 'bottom' | 'top' | 'rail' | 'sidebar' | 'custom';\n\n/**\n * Disposable adapter plan for a `tabs` topology.\n *\n * The implementation selects the Router runtime. Presentation only selects its visual chrome and\n * never creates another route topology.\n */\nexport interface TabsNavigatorPlan {\n  implementation: ResolvedTabsImplementation;\n  module: ExpoRouterNavigatorModule;\n  exportName: string;\n  stability: NavigatorApiStability;\n  presentation?: ResolvedTabsPresentation;\n  presentations?: Readonly<Record<NavigatorResponsiveSize, ResolvedTabsPresentation>>;\n  customPresentationId?: string;\n  minimizeBehavior?: 'automatic' | 'never' | 'onScrollDown' | 'onScrollUp';\n  bottomAccessoryScreenId?: string;\n}\n\nexport interface CreateNavigatorPlanOptions {\n  platform: NavigatorRuntimePlatform;\n  expoRouterVersion: string;\n  responsiveSize?: NavigatorResponsiveSize;\n  customNavigators?: CustomNavigatorRegistry;\n}\n\nexport type ExpoRouterNavigatorModule =\n  | 'expo-router'\n  | 'expo-router/drawer'\n  | 'expo-router/js-stack'\n  | 'expo-router/js-tabs'\n  | 'expo-router/js-top-tabs'\n  | 'expo-router/ui'\n  | 'expo-router/unstable-split-view'\n  | 'expo-router/unstable-native-tabs';\n\nexport type NavigatorAdapterId =\n  | 'slot'\n  | 'stack.native'\n  | 'stack.javascript'\n  | 'stack.experimental'\n  | 'drawer'\n  | 'tabs.native'\n  | 'tabs.javascript'\n  | 'tabs.custom'\n  | 'split-view'\n  | 'custom';\n\nexport interface NavigatorAdapterPlan {\n  id: NavigatorAdapterId;\n  /** Built-in Expo Router entry point or an explicitly registered custom module. */\n  module?: string;\n  exportName?: string;\n  support: NavigatorSupportStatus;\n  stability: NavigatorApiStability;\n  limitations: readonly string[];\n}\n\nexport type NavigatorApiStability = 'stable' | 'alpha';\n\nexport interface NavigatorDiagnostic {\n  code: string;\n  severity: 'error' | 'warning';\n  path: string;\n  message: string;\n}\n\nexport interface NavigatorNodePlan {\n  type: NavigatorType;\n  pointer: string;\n  adapter: NavigatorAdapterPlan;\n  initialRouteName?: string;\n  routes: readonly NavigatorRoutePlan[];\n  stack?: {\n    implementation: StackImplementation;\n    options?: StackScreenOptions;\n  };\n  drawer?: {\n    options?: DrawerNavigatorOptions;\n  };\n  tabs?: TabsNavigatorPlan;\n  splitView?: {\n    columns: {\n      primary: string;\n      supplementary?: string;\n    };\n    inspector?: string;\n    topColumnForCollapsing?: 'primary' | 'secondary' | 'supplementary';\n  };\n  custom?: {\n    navigatorId: string;\n    config?: CustomNavigatorNode['config'];\n  };\n}\n\nexport interface NavigatorPlan {\n  context: NavigatorValidationContext;\n  root: NavigatorNodePlan;\n  diagnostics: readonly NavigatorDiagnostic[];\n  supported: boolean;\n  flows: {\n    onboarding: boolean;\n    authentication: boolean;\n  };\n}\n\nexport type NavigatorResponsiveSize = 'compact' | 'medium' | 'expanded';\n\nexport interface NavigatorRoutePlan {\n  name: string;\n  path?: string;\n  label?: string;\n  icon?: RouteDefinition['icon'];\n  showInPrimaryNavigation?: boolean;\n  guards: readonly string[];\n  screenId?: string;\n  stackOptions?: StackScreenOptions;\n  navigator?: NavigatorNodePlan;\n}\n\nexport type NavigatorRuntimePlatform = 'android' | 'ios' | 'web';\n\nexport type NavigatorSupportStatus = 'supported' | 'unavailable';\n\nexport interface NavigatorValidationContext {\n  platform: NavigatorRuntimePlatform;\n  expoRouterVersion: string;\n}\n"]}

package/dist/navigator.d.ts

@@ -179,5 +179,7 @@ export type AppNavigatorManifest = NavigatorNode & {
     defaults?: NavigatorDefaults;
     platforms?: NavigatorPlatforms;
 };
-export {};
+export type { CustomNavigatorConfigIssue, CustomNavigatorRegistration, CustomNavigatorRegistry, } from './navigator/extensions';
+export type { NavigatorGeneratedFile, NavigatorGenerationBindings, NavigatorGenerationOptions, NavigatorScreenModule, } from './navigator/generation';
+export type { CreateNavigatorPlanOptions, ExpoRouterNavigatorModule, NavigatorAdapterId, NavigatorAdapterPlan, NavigatorApiStability, NavigatorDiagnostic, NavigatorNodePlan, NavigatorPlan, NavigatorResponsiveSize, NavigatorRoutePlan, NavigatorRuntimePlatform, NavigatorSupportStatus, NavigatorValidationContext, ResolvedCustomTabsPresentation, ResolvedTabsImplementation, ResolvedTabsPresentation, TabsNavigatorPlan, } from './navigator/planning';
 //# sourceMappingURL=navigator.d.ts.map

package/dist/navigator.d.ts.map

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

package/dist/navigator.js.map

@@ -1 +1 @@
-{"version":3,"file":"navigator.js","sourceRoot":"","sources":["../src/navigator.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAU,CAAC;AAGpG,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM;IACN,OAAO;IACP,MAAM;IACN,YAAY;IACZ,QAAQ;IACR,cAAc;IACd,aAAa;IACb,mBAAmB;IACnB,iBAAiB;IACjB,uBAAuB;IACvB,mBAAmB;IACnB,yBAAyB;IACzB,wBAAwB;IACxB,8BAA8B;IAC9B,YAAY;IACZ,QAAQ;CACA,CAAC;AAGX,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,cAAc,CAAU,CAAC;AAGvF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,MAAM;IACN,OAAO;IACP,kBAAkB;IAClB,gBAAgB;IAChB,2BAA2B;IAC3B,iBAAiB;IACjB,WAAW;CACH,CAAC;AAGX,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,kBAAkB,CAAU,CAAC;AA4C7F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAU,CAAC;AAG3D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAU,CAAC;AAU7E,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAG7F,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,GAAG,+BAA+B;IAClC,YAAY;IACZ,QAAQ;CACA,CAAC;AAGX,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAU,CAAC;AAGxE,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,WAAW;IACX,OAAO;IACP,cAAc;IACd,YAAY;CACJ,CAAC","sourcesContent":["import type { IconSpec, ManifestValue } from './types';\n\nexport const NAVIGATOR_TYPES = ['slot', 'stack', 'tabs', 'drawer', 'split-view', 'custom'] as const;\nexport type NavigatorType = (typeof NAVIGATOR_TYPES)[number];\n\nexport const NAVIGATOR_PRESETS = [\n  'slot',\n  'stack',\n  'tabs',\n  'tabs-stack',\n  'drawer',\n  'drawer-stack',\n  'drawer-tabs',\n  'drawer-tabs-stack',\n  'root-stack-tabs',\n  'root-stack-tabs-stack',\n  'root-stack-drawer',\n  'root-stack-drawer-stack',\n  'root-stack-drawer-tabs',\n  'root-stack-drawer-tabs-stack',\n  'split-view',\n  'custom',\n] as const;\nexport type NavigatorPreset = (typeof NAVIGATOR_PRESETS)[number];\n\nexport const STACK_IMPLEMENTATIONS = ['native', 'javascript', 'experimental'] as const;\nexport type StackImplementation = (typeof STACK_IMPLEMENTATIONS)[number];\n\nexport const STACK_PRESENTATIONS = [\n  'card',\n  'modal',\n  'transparentModal',\n  'containedModal',\n  'containedTransparentModal',\n  'fullScreenModal',\n  'formSheet',\n] as const;\nexport type StackPresentation = (typeof STACK_PRESENTATIONS)[number];\n\nexport const JAVASCRIPT_STACK_PRESENTATIONS = ['card', 'modal', 'transparentModal'] as const;\nexport type JavaScriptStackPresentation = (typeof JAVASCRIPT_STACK_PRESENTATIONS)[number];\n\nexport interface StackHeaderOptions {\n  title?: string;\n  headerShown?: boolean;\n  headerTransparent?: boolean;\n  headerBackVisible?: boolean;\n}\n\nexport type StackScreenOptions = StackHeaderOptions &\n  (\n    | {\n        presentation?: Exclude<StackPresentation, 'formSheet'>;\n        sheetAllowedDetents?: never;\n        sheetGrabberVisible?: never;\n      }\n    | {\n        presentation: 'formSheet';\n        sheetAllowedDetents?: 'fitToContents' | number[];\n        sheetGrabberVisible?: boolean;\n      }\n  );\n\nexport type JavaScriptStackScreenOptions = StackHeaderOptions & {\n  presentation?: JavaScriptStackPresentation;\n};\n\nexport type StackImplementationConfig =\n  | {\n      /** Omission selects the stable native stack implementation. */\n      implementation?: 'native';\n      options?: StackScreenOptions;\n    }\n  | {\n      implementation: 'javascript';\n      options?: JavaScriptStackScreenOptions;\n    }\n  | {\n      /** Expo Router Experimental Stack is alpha, native-only, and available from SDK 56. */\n      implementation: 'experimental';\n      options?: StackHeaderOptions;\n    };\n\nexport const DRAWER_POSITIONS = ['left', 'right'] as const;\nexport type DrawerPosition = (typeof DRAWER_POSITIONS)[number];\n\nexport const DRAWER_TYPES = ['front', 'back', 'slide', 'permanent'] as const;\nexport type DrawerType = (typeof DRAWER_TYPES)[number];\n\nexport interface DrawerNavigatorOptions {\n  drawerPosition?: DrawerPosition;\n  drawerType?: DrawerType;\n  swipeEnabled?: boolean;\n  headerShown?: boolean;\n}\n\nexport const FIXED_CUSTOM_TABS_PRESENTATIONS = ['bottom', 'top', 'rail', 'sidebar'] as const;\nexport type FixedCustomTabsPresentation = (typeof FIXED_CUSTOM_TABS_PRESENTATIONS)[number];\n\nexport const CUSTOM_TABS_PRESENTATIONS = [\n  ...FIXED_CUSTOM_TABS_PRESENTATIONS,\n  'responsive',\n  'custom',\n] as const;\nexport type CustomTabsPresentation = (typeof CUSTOM_TABS_PRESENTATIONS)[number];\n\nexport const JAVASCRIPT_TABS_PRESENTATIONS = ['bottom', 'top'] as const;\nexport type JavaScriptTabsPresentation = (typeof JAVASCRIPT_TABS_PRESENTATIONS)[number];\n\nexport const NATIVE_TABS_MINIMIZE_BEHAVIORS = [\n  'automatic',\n  'never',\n  'onScrollDown',\n  'onScrollUp',\n] as const;\nexport type NativeTabsMinimizeBehavior = (typeof NATIVE_TABS_MINIMIZE_BEHAVIORS)[number];\n\nexport interface ResponsiveTabsPresentation {\n  compact: FixedCustomTabsPresentation;\n  medium?: FixedCustomTabsPresentation;\n  expanded: FixedCustomTabsPresentation;\n}\n\nexport type CustomTabsPresentationConfig =\n  | {\n      presentation: FixedCustomTabsPresentation;\n      responsive?: never;\n      customPresentationId?: never;\n    }\n  | {\n      presentation: 'responsive';\n      responsive: ResponsiveTabsPresentation;\n      customPresentationId?: never;\n    }\n  | {\n      presentation: 'custom';\n      responsive?: never;\n      /** Serializable registered presentation id. */\n      customPresentationId: string;\n    };\n\nexport type CustomTabsConfig = {\n  implementation: 'custom';\n} & CustomTabsPresentationConfig;\n\nexport type CustomTabsWebConfig = CustomTabsPresentationConfig;\n\nexport interface NavigatorScreenReference {\n  screenId: string;\n}\n\nexport interface NativeTabsConfig {\n  implementation: 'native';\n  /** Expo Router Native Tabs is alpha; minimizing is available on iOS 26+ from SDK 55. */\n  minimizeBehavior?: NativeTabsMinimizeBehavior;\n  /** Registered screen rendered through NativeTabs.BottomAccessory, available from SDK 55. */\n  bottomAccessory?: NavigatorScreenReference;\n}\n\nexport interface JavaScriptTabsConfig {\n  implementation: 'javascript';\n  presentation?: JavaScriptTabsPresentation;\n}\n\nexport interface AdaptiveTabsConfig {\n  /** Omission selects the canonical adaptive default. */\n  implementation?: 'adaptive';\n  /** Android/iOS branch. Expo Router may expose this implementation as unstable. */\n  native?: NativeTabsConfig;\n  /** Web branch rendered through headless custom tabs. */\n  web?: CustomTabsWebConfig;\n}\n\nexport type TabsImplementationConfig =\n  AdaptiveTabsConfig | CustomTabsConfig | JavaScriptTabsConfig | NativeTabsConfig;\n\ninterface NavigatorNodeBase {\n  initialRouteName?: string;\n  routes: RouteDefinition[];\n}\n\nexport interface SlotNavigatorNode extends NavigatorNodeBase {\n  type: 'slot';\n}\n\nexport type StackNavigatorNode = NavigatorNodeBase & {\n  type: 'stack';\n} & StackImplementationConfig;\n\nexport interface DrawerNavigatorNode extends NavigatorNodeBase {\n  type: 'drawer';\n  options?: DrawerNavigatorOptions;\n}\n\nexport type TabsNavigatorConfig = {\n  type: 'tabs';\n} & TabsImplementationConfig;\n\nexport type TabsNavigatorNode = NavigatorNodeBase & TabsNavigatorConfig;\n\nexport interface SplitViewNavigatorNode extends NavigatorNodeBase {\n  type: 'split-view';\n  columns: {\n    primary: NavigatorScreenReference;\n    supplementary?: NavigatorScreenReference;\n  };\n  inspector?: NavigatorScreenReference;\n  /** Split View is alpha and iOS-only; other platforms fall back to Slot. */\n  topColumnForCollapsing?: 'primary' | 'supplementary' | 'secondary';\n}\n\nexport interface CustomNavigatorNode extends NavigatorNodeBase {\n  type: 'custom';\n  navigatorId: string;\n  config?: Readonly<Record<string, ManifestValue>>;\n}\n\nexport type NavigatorNode =\n  | CustomNavigatorNode\n  | DrawerNavigatorNode\n  | SlotNavigatorNode\n  | SplitViewNavigatorNode\n  | StackNavigatorNode\n  | TabsNavigatorNode;\n\nexport interface RouteDefinition {\n  name: string;\n  path?: string;\n  label?: string;\n  icon?: IconSpec;\n  /** Hide this route from primary Tabs/Drawer presentation without making it unnavigable. */\n  showInPrimaryNavigation?: boolean;\n  guards?: string[];\n  screenId?: string;\n  /** Presentation applied by the resolved parent stack implementation. */\n  stackOptions?: StackScreenOptions;\n  navigator?: NavigatorNode;\n}\n\nexport interface NavigatorFlows {\n  onboarding?: boolean;\n  authentication?: boolean;\n}\n\nexport interface NavigatorDefaults {\n  tabs?: TabsImplementationConfig;\n  stack?: StackImplementationConfig;\n}\n\nexport interface NavigatorPlatformConfig {\n  tabs?: TabsImplementationConfig;\n  stack?: StackImplementationConfig;\n}\n\nexport interface NavigatorPlatforms {\n  android?: NavigatorPlatformConfig;\n  ios?: NavigatorPlatformConfig;\n  web?: NavigatorPlatformConfig;\n}\n\n/**\n * Serializable desired state for `AppManifest.navigator`.\n *\n * The manifest slice is the root navigator tree itself; optional authoring metadata does not add\n * a redundant `root` wrapper. The standalone Navigator capability consumes this slice directly.\n */\nexport type AppNavigatorManifest = NavigatorNode & {\n  preset?: NavigatorPreset;\n  flows?: NavigatorFlows;\n  defaults?: NavigatorDefaults;\n  platforms?: NavigatorPlatforms;\n};\n"]}
+{"version":3,"file":"navigator.js","sourceRoot":"","sources":["../src/navigator.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAU,CAAC;AAGpG,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM;IACN,OAAO;IACP,MAAM;IACN,YAAY;IACZ,QAAQ;IACR,cAAc;IACd,aAAa;IACb,mBAAmB;IACnB,iBAAiB;IACjB,uBAAuB;IACvB,mBAAmB;IACnB,yBAAyB;IACzB,wBAAwB;IACxB,8BAA8B;IAC9B,YAAY;IACZ,QAAQ;CACA,CAAC;AAGX,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,cAAc,CAAU,CAAC;AAGvF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,MAAM;IACN,OAAO;IACP,kBAAkB;IAClB,gBAAgB;IAChB,2BAA2B;IAC3B,iBAAiB;IACjB,WAAW;CACH,CAAC;AAGX,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,kBAAkB,CAAU,CAAC;AA4C7F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAU,CAAC;AAG3D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAU,CAAC;AAU7E,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAG7F,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,GAAG,+BAA+B;IAClC,YAAY;IACZ,QAAQ;CACA,CAAC;AAGX,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAU,CAAC;AAGxE,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,WAAW;IACX,OAAO;IACP,cAAc;IACd,YAAY;CACJ,CAAC","sourcesContent":["import type { IconSpec, ManifestValue } from './types';\n\nexport const NAVIGATOR_TYPES = ['slot', 'stack', 'tabs', 'drawer', 'split-view', 'custom'] as const;\nexport type NavigatorType = (typeof NAVIGATOR_TYPES)[number];\n\nexport const NAVIGATOR_PRESETS = [\n  'slot',\n  'stack',\n  'tabs',\n  'tabs-stack',\n  'drawer',\n  'drawer-stack',\n  'drawer-tabs',\n  'drawer-tabs-stack',\n  'root-stack-tabs',\n  'root-stack-tabs-stack',\n  'root-stack-drawer',\n  'root-stack-drawer-stack',\n  'root-stack-drawer-tabs',\n  'root-stack-drawer-tabs-stack',\n  'split-view',\n  'custom',\n] as const;\nexport type NavigatorPreset = (typeof NAVIGATOR_PRESETS)[number];\n\nexport const STACK_IMPLEMENTATIONS = ['native', 'javascript', 'experimental'] as const;\nexport type StackImplementation = (typeof STACK_IMPLEMENTATIONS)[number];\n\nexport const STACK_PRESENTATIONS = [\n  'card',\n  'modal',\n  'transparentModal',\n  'containedModal',\n  'containedTransparentModal',\n  'fullScreenModal',\n  'formSheet',\n] as const;\nexport type StackPresentation = (typeof STACK_PRESENTATIONS)[number];\n\nexport const JAVASCRIPT_STACK_PRESENTATIONS = ['card', 'modal', 'transparentModal'] as const;\nexport type JavaScriptStackPresentation = (typeof JAVASCRIPT_STACK_PRESENTATIONS)[number];\n\nexport interface StackHeaderOptions {\n  title?: string;\n  headerShown?: boolean;\n  headerTransparent?: boolean;\n  headerBackVisible?: boolean;\n}\n\nexport type StackScreenOptions = StackHeaderOptions &\n  (\n    | {\n        presentation?: Exclude<StackPresentation, 'formSheet'>;\n        sheetAllowedDetents?: never;\n        sheetGrabberVisible?: never;\n      }\n    | {\n        presentation: 'formSheet';\n        sheetAllowedDetents?: 'fitToContents' | number[];\n        sheetGrabberVisible?: boolean;\n      }\n  );\n\nexport type JavaScriptStackScreenOptions = StackHeaderOptions & {\n  presentation?: JavaScriptStackPresentation;\n};\n\nexport type StackImplementationConfig =\n  | {\n      /** Omission selects the stable native stack implementation. */\n      implementation?: 'native';\n      options?: StackScreenOptions;\n    }\n  | {\n      implementation: 'javascript';\n      options?: JavaScriptStackScreenOptions;\n    }\n  | {\n      /** Expo Router Experimental Stack is alpha, native-only, and available from SDK 56. */\n      implementation: 'experimental';\n      options?: StackHeaderOptions;\n    };\n\nexport const DRAWER_POSITIONS = ['left', 'right'] as const;\nexport type DrawerPosition = (typeof DRAWER_POSITIONS)[number];\n\nexport const DRAWER_TYPES = ['front', 'back', 'slide', 'permanent'] as const;\nexport type DrawerType = (typeof DRAWER_TYPES)[number];\n\nexport interface DrawerNavigatorOptions {\n  drawerPosition?: DrawerPosition;\n  drawerType?: DrawerType;\n  swipeEnabled?: boolean;\n  headerShown?: boolean;\n}\n\nexport const FIXED_CUSTOM_TABS_PRESENTATIONS = ['bottom', 'top', 'rail', 'sidebar'] as const;\nexport type FixedCustomTabsPresentation = (typeof FIXED_CUSTOM_TABS_PRESENTATIONS)[number];\n\nexport const CUSTOM_TABS_PRESENTATIONS = [\n  ...FIXED_CUSTOM_TABS_PRESENTATIONS,\n  'responsive',\n  'custom',\n] as const;\nexport type CustomTabsPresentation = (typeof CUSTOM_TABS_PRESENTATIONS)[number];\n\nexport const JAVASCRIPT_TABS_PRESENTATIONS = ['bottom', 'top'] as const;\nexport type JavaScriptTabsPresentation = (typeof JAVASCRIPT_TABS_PRESENTATIONS)[number];\n\nexport const NATIVE_TABS_MINIMIZE_BEHAVIORS = [\n  'automatic',\n  'never',\n  'onScrollDown',\n  'onScrollUp',\n] as const;\nexport type NativeTabsMinimizeBehavior = (typeof NATIVE_TABS_MINIMIZE_BEHAVIORS)[number];\n\nexport interface ResponsiveTabsPresentation {\n  compact: FixedCustomTabsPresentation;\n  medium?: FixedCustomTabsPresentation;\n  expanded: FixedCustomTabsPresentation;\n}\n\nexport type CustomTabsPresentationConfig =\n  | {\n      presentation: FixedCustomTabsPresentation;\n      responsive?: never;\n      customPresentationId?: never;\n    }\n  | {\n      presentation: 'responsive';\n      responsive: ResponsiveTabsPresentation;\n      customPresentationId?: never;\n    }\n  | {\n      presentation: 'custom';\n      responsive?: never;\n      /** Serializable registered presentation id. */\n      customPresentationId: string;\n    };\n\nexport type CustomTabsConfig = {\n  implementation: 'custom';\n} & CustomTabsPresentationConfig;\n\nexport type CustomTabsWebConfig = CustomTabsPresentationConfig;\n\nexport interface NavigatorScreenReference {\n  screenId: string;\n}\n\nexport interface NativeTabsConfig {\n  implementation: 'native';\n  /** Expo Router Native Tabs is alpha; minimizing is available on iOS 26+ from SDK 55. */\n  minimizeBehavior?: NativeTabsMinimizeBehavior;\n  /** Registered screen rendered through NativeTabs.BottomAccessory, available from SDK 55. */\n  bottomAccessory?: NavigatorScreenReference;\n}\n\nexport interface JavaScriptTabsConfig {\n  implementation: 'javascript';\n  presentation?: JavaScriptTabsPresentation;\n}\n\nexport interface AdaptiveTabsConfig {\n  /** Omission selects the canonical adaptive default. */\n  implementation?: 'adaptive';\n  /** Android/iOS branch. Expo Router may expose this implementation as unstable. */\n  native?: NativeTabsConfig;\n  /** Web branch rendered through headless custom tabs. */\n  web?: CustomTabsWebConfig;\n}\n\nexport type TabsImplementationConfig =\n  AdaptiveTabsConfig | CustomTabsConfig | JavaScriptTabsConfig | NativeTabsConfig;\n\ninterface NavigatorNodeBase {\n  initialRouteName?: string;\n  routes: RouteDefinition[];\n}\n\nexport interface SlotNavigatorNode extends NavigatorNodeBase {\n  type: 'slot';\n}\n\nexport type StackNavigatorNode = NavigatorNodeBase & {\n  type: 'stack';\n} & StackImplementationConfig;\n\nexport interface DrawerNavigatorNode extends NavigatorNodeBase {\n  type: 'drawer';\n  options?: DrawerNavigatorOptions;\n}\n\nexport type TabsNavigatorConfig = {\n  type: 'tabs';\n} & TabsImplementationConfig;\n\nexport type TabsNavigatorNode = NavigatorNodeBase & TabsNavigatorConfig;\n\nexport interface SplitViewNavigatorNode extends NavigatorNodeBase {\n  type: 'split-view';\n  columns: {\n    primary: NavigatorScreenReference;\n    supplementary?: NavigatorScreenReference;\n  };\n  inspector?: NavigatorScreenReference;\n  /** Split View is alpha and iOS-only; other platforms fall back to Slot. */\n  topColumnForCollapsing?: 'primary' | 'supplementary' | 'secondary';\n}\n\nexport interface CustomNavigatorNode extends NavigatorNodeBase {\n  type: 'custom';\n  navigatorId: string;\n  config?: Readonly<Record<string, ManifestValue>>;\n}\n\nexport type NavigatorNode =\n  | CustomNavigatorNode\n  | DrawerNavigatorNode\n  | SlotNavigatorNode\n  | SplitViewNavigatorNode\n  | StackNavigatorNode\n  | TabsNavigatorNode;\n\nexport interface RouteDefinition {\n  name: string;\n  path?: string;\n  label?: string;\n  icon?: IconSpec;\n  /** Hide this route from primary Tabs/Drawer presentation without making it unnavigable. */\n  showInPrimaryNavigation?: boolean;\n  guards?: string[];\n  screenId?: string;\n  /** Presentation applied by the resolved parent stack implementation. */\n  stackOptions?: StackScreenOptions;\n  navigator?: NavigatorNode;\n}\n\nexport interface NavigatorFlows {\n  onboarding?: boolean;\n  authentication?: boolean;\n}\n\nexport interface NavigatorDefaults {\n  tabs?: TabsImplementationConfig;\n  stack?: StackImplementationConfig;\n}\n\nexport interface NavigatorPlatformConfig {\n  tabs?: TabsImplementationConfig;\n  stack?: StackImplementationConfig;\n}\n\nexport interface NavigatorPlatforms {\n  android?: NavigatorPlatformConfig;\n  ios?: NavigatorPlatformConfig;\n  web?: NavigatorPlatformConfig;\n}\n\n/**\n * Serializable desired state for `AppManifest.navigator`.\n *\n * The manifest slice is the root navigator tree itself; optional authoring metadata does not add\n * a redundant `root` wrapper. The standalone Navigator capability consumes this slice directly.\n */\nexport type AppNavigatorManifest = NavigatorNode & {\n  preset?: NavigatorPreset;\n  flows?: NavigatorFlows;\n  defaults?: NavigatorDefaults;\n  platforms?: NavigatorPlatforms;\n};\n\nexport type {\n  CustomNavigatorConfigIssue,\n  CustomNavigatorRegistration,\n  CustomNavigatorRegistry,\n} from './navigator/extensions';\nexport type {\n  NavigatorGeneratedFile,\n  NavigatorGenerationBindings,\n  NavigatorGenerationOptions,\n  NavigatorScreenModule,\n} from './navigator/generation';\nexport type {\n  CreateNavigatorPlanOptions,\n  ExpoRouterNavigatorModule,\n  NavigatorAdapterId,\n  NavigatorAdapterPlan,\n  NavigatorApiStability,\n  NavigatorDiagnostic,\n  NavigatorNodePlan,\n  NavigatorPlan,\n  NavigatorResponsiveSize,\n  NavigatorRoutePlan,\n  NavigatorRuntimePlatform,\n  NavigatorSupportStatus,\n  NavigatorValidationContext,\n  ResolvedCustomTabsPresentation,\n  ResolvedTabsImplementation,\n  ResolvedTabsPresentation,\n  TabsNavigatorPlan,\n} from './navigator/planning';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/contracts",
-  "version": "11.0.0",
+  "version": "11.1.0",
   "main": "./dist/index.js",
   "ankh": {
     "category": "contracts",
@@ -13,9 +13,9 @@
     "@ankhorage/color-theory": "^0.3.0"
   },
   "devDependencies": {
-    "@ankhorage/devtools": "^1.10.9",
+    "@ankhorage/devtools": "^1.11.11",
     "@ankhorage/paradox": "^0.1.24",
-    "@types/bun": "^1.4.0",
+    "@types/bun": "^1.4.1",
     "@types/node": "^25.2.3",
     "typescript": "^5.9.3"
   },
@@ -104,7 +104,7 @@
     "CHANGELOG.md",
     "LICENSE"
   ],
-  "packageManager": "bun@1.4.0",
+  "packageManager": "bun@1.4.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ankhorage/contracts.git"

package/src/navigator/extensions.ts

@@ -0,0 +1,26 @@
+import type { CustomNavigatorNode } from '../navigator';
+import type { NavigatorApiStability, NavigatorRuntimePlatform } from './planning';
+export interface CustomNavigatorConfigIssue {
+  code: string;
+  message: string;
+  path?: string;
+}
+
+export interface CustomNavigatorRegistration {
+  readonly id: string;
+  readonly platforms: readonly NavigatorRuntimePlatform[];
+  readonly stability: NavigatorApiStability;
+  readonly integration: 'expo-router-standard';
+  readonly router: 'stack' | 'tab';
+  readonly module: string;
+  readonly exportName: string;
+  readonly validateConfig: (
+    config: CustomNavigatorNode['config'],
+  ) => readonly CustomNavigatorConfigIssue[];
+}
+
+export type CustomNavigatorRegistry = Readonly<Record<string, CustomNavigatorRegistration>> & {
+  readonly [CUSTOM_NAVIGATOR_REGISTRY]: true;
+};
+
+declare const CUSTOM_NAVIGATOR_REGISTRY: unique symbol;

package/src/navigator/generation.ts

@@ -0,0 +1,28 @@
+export interface NavigatorGeneratedFile {
+  path: string;
+  contents: string;
+}
+
+export interface NavigatorGenerationBindings {
+  screens: Readonly<Record<string, NavigatorScreenModule>>;
+  guards: Readonly<Record<string, NavigatorScreenModule>>;
+  iconSourceResolver?: NavigatorScreenModule;
+  flows?: {
+    onboardingRoute?: string;
+    authenticationRoute?: string;
+  };
+  tabPresentations?: Readonly<Record<string, NavigatorScreenModule>>;
+}
+
+/** Options for placing Navigator-owned files inside a consumer-owned Expo Router app shell. */
+export interface NavigatorGenerationOptions {
+  /** Directory that receives the root navigator layout. Must be `src/app` or one of its safe descendants. */
+  rootDirectory?: string;
+  /** Emit routed screen re-export modules in addition to layouts. Defaults to true. */
+  includeScreenFiles?: boolean;
+}
+
+export interface NavigatorScreenModule {
+  module: string;
+  exportName: string;
+}

package/src/navigator/planning.ts

@@ -0,0 +1,146 @@
+import type {
+  CustomNavigatorNode,
+  DrawerNavigatorOptions,
+  NavigatorType,
+  RouteDefinition,
+  StackImplementation,
+  StackScreenOptions,
+} from '../navigator';
+import type { CustomNavigatorRegistry } from './extensions';
+
+export interface ResolvedCustomTabsPresentation {
+  presentation: ResolvedTabsPresentation;
+  customPresentationId?: string;
+}
+
+export type ResolvedTabsImplementation = 'custom' | 'javascript' | 'native';
+
+export type ResolvedTabsPresentation = 'bottom' | 'top' | 'rail' | 'sidebar' | 'custom';
+
+/**
+ * Disposable adapter plan for a `tabs` topology.
+ *
+ * The implementation selects the Router runtime. Presentation only selects its visual chrome and
+ * never creates another route topology.
+ */
+export interface TabsNavigatorPlan {
+  implementation: ResolvedTabsImplementation;
+  module: ExpoRouterNavigatorModule;
+  exportName: string;
+  stability: NavigatorApiStability;
+  presentation?: ResolvedTabsPresentation;
+  presentations?: Readonly<Record<NavigatorResponsiveSize, ResolvedTabsPresentation>>;
+  customPresentationId?: string;
+  minimizeBehavior?: 'automatic' | 'never' | 'onScrollDown' | 'onScrollUp';
+  bottomAccessoryScreenId?: string;
+}
+
+export interface CreateNavigatorPlanOptions {
+  platform: NavigatorRuntimePlatform;
+  expoRouterVersion: string;
+  responsiveSize?: NavigatorResponsiveSize;
+  customNavigators?: CustomNavigatorRegistry;
+}
+
+export type ExpoRouterNavigatorModule =
+  | 'expo-router'
+  | 'expo-router/drawer'
+  | 'expo-router/js-stack'
+  | 'expo-router/js-tabs'
+  | 'expo-router/js-top-tabs'
+  | 'expo-router/ui'
+  | 'expo-router/unstable-split-view'
+  | 'expo-router/unstable-native-tabs';
+
+export type NavigatorAdapterId =
+  | 'slot'
+  | 'stack.native'
+  | 'stack.javascript'
+  | 'stack.experimental'
+  | 'drawer'
+  | 'tabs.native'
+  | 'tabs.javascript'
+  | 'tabs.custom'
+  | 'split-view'
+  | 'custom';
+
+export interface NavigatorAdapterPlan {
+  id: NavigatorAdapterId;
+  /** Built-in Expo Router entry point or an explicitly registered custom module. */
+  module?: string;
+  exportName?: string;
+  support: NavigatorSupportStatus;
+  stability: NavigatorApiStability;
+  limitations: readonly string[];
+}
+
+export type NavigatorApiStability = 'stable' | 'alpha';
+
+export interface NavigatorDiagnostic {
+  code: string;
+  severity: 'error' | 'warning';
+  path: string;
+  message: string;
+}
+
+export interface NavigatorNodePlan {
+  type: NavigatorType;
+  pointer: string;
+  adapter: NavigatorAdapterPlan;
+  initialRouteName?: string;
+  routes: readonly NavigatorRoutePlan[];
+  stack?: {
+    implementation: StackImplementation;
+    options?: StackScreenOptions;
+  };
+  drawer?: {
+    options?: DrawerNavigatorOptions;
+  };
+  tabs?: TabsNavigatorPlan;
+  splitView?: {
+    columns: {
+      primary: string;
+      supplementary?: string;
+    };
+    inspector?: string;
+    topColumnForCollapsing?: 'primary' | 'secondary' | 'supplementary';
+  };
+  custom?: {
+    navigatorId: string;
+    config?: CustomNavigatorNode['config'];
+  };
+}
+
+export interface NavigatorPlan {
+  context: NavigatorValidationContext;
+  root: NavigatorNodePlan;
+  diagnostics: readonly NavigatorDiagnostic[];
+  supported: boolean;
+  flows: {
+    onboarding: boolean;
+    authentication: boolean;
+  };
+}
+
+export type NavigatorResponsiveSize = 'compact' | 'medium' | 'expanded';
+
+export interface NavigatorRoutePlan {
+  name: string;
+  path?: string;
+  label?: string;
+  icon?: RouteDefinition['icon'];
+  showInPrimaryNavigation?: boolean;
+  guards: readonly string[];
+  screenId?: string;
+  stackOptions?: StackScreenOptions;
+  navigator?: NavigatorNodePlan;
+}
+
+export type NavigatorRuntimePlatform = 'android' | 'ios' | 'web';
+
+export type NavigatorSupportStatus = 'supported' | 'unavailable';
+
+export interface NavigatorValidationContext {
+  platform: NavigatorRuntimePlatform;
+  expoRouterVersion: string;
+}

package/src/navigator-runtime-contracts.test.ts

@@ -0,0 +1,53 @@
+import { expect, test } from 'bun:test';
+
+import type {
+  CustomNavigatorRegistration,
+  NavigatorGeneratedFile,
+  NavigatorGenerationBindings,
+  NavigatorPlan,
+} from './navigator';
+
+test('keeps generation bindings and plan output portable across package boundaries', () => {
+  const bindings: NavigatorGenerationBindings = {
+    screens: { home: { module: '@/screens/Home', exportName: 'Home' } },
+    guards: {},
+  };
+  const file: NavigatorGeneratedFile = {
+    path: 'src/app/index.tsx',
+    contents: 'export default Home;',
+  };
+  const plan: NavigatorPlan = {
+    context: { platform: 'web', expoRouterVersion: '57.0.18' },
+    root: {
+      type: 'slot',
+      pointer: '',
+      adapter: {
+        id: 'slot',
+        module: 'expo-router',
+        exportName: 'Slot',
+        support: 'supported',
+        stability: 'stable',
+        limitations: [],
+      },
+      routes: [],
+    },
+    diagnostics: [],
+    supported: true,
+    flows: { onboarding: false, authentication: false },
+  };
+  expect(JSON.parse(JSON.stringify({ bindings, file, plan }))).toEqual({ bindings, file, plan });
+});
+
+test('describes a custom extension without importing Navigator or a UI runtime', () => {
+  const registration: CustomNavigatorRegistration = {
+    id: 'example',
+    platforms: ['web'],
+    stability: 'stable',
+    integration: 'expo-router-standard',
+    router: 'stack',
+    module: '@example/navigation',
+    exportName: 'ExampleNavigator',
+    validateConfig: () => [],
+  };
+  expect(registration.validateConfig({ mode: 'compact' })).toEqual([]);
+});

package/src/navigator.ts

@@ -270,3 +270,34 @@ export type AppNavigatorManifest = NavigatorNode & {
   defaults?: NavigatorDefaults;
   platforms?: NavigatorPlatforms;
 };
+
+export type {
+  CustomNavigatorConfigIssue,
+  CustomNavigatorRegistration,
+  CustomNavigatorRegistry,
+} from './navigator/extensions';
+export type {
+  NavigatorGeneratedFile,
+  NavigatorGenerationBindings,
+  NavigatorGenerationOptions,
+  NavigatorScreenModule,
+} from './navigator/generation';
+export type {
+  CreateNavigatorPlanOptions,
+  ExpoRouterNavigatorModule,
+  NavigatorAdapterId,
+  NavigatorAdapterPlan,
+  NavigatorApiStability,
+  NavigatorDiagnostic,
+  NavigatorNodePlan,
+  NavigatorPlan,
+  NavigatorResponsiveSize,
+  NavigatorRoutePlan,
+  NavigatorRuntimePlatform,
+  NavigatorSupportStatus,
+  NavigatorValidationContext,
+  ResolvedCustomTabsPresentation,
+  ResolvedTabsImplementation,
+  ResolvedTabsPresentation,
+  TabsNavigatorPlan,
+} from './navigator/planning';