@ankhorage/contracts 11.0.0 → 12.0.0

package/dist/navigator.d.ts

@@ -1,7 +1,7 @@
 import type { IconSpec, ManifestValue } from './types';
 export declare const NAVIGATOR_TYPES: readonly ["slot", "stack", "tabs", "drawer", "split-view", "custom"];
 export type NavigatorType = (typeof NAVIGATOR_TYPES)[number];
-export declare const NAVIGATOR_PRESETS: readonly ["slot", "stack", "tabs", "tabs-stack", "drawer", "drawer-stack", "drawer-tabs", "drawer-tabs-stack", "root-stack-tabs", "root-stack-tabs-stack", "root-stack-drawer", "root-stack-drawer-stack", "root-stack-drawer-tabs", "root-stack-drawer-tabs-stack", "split-view", "custom"];
+export declare const NAVIGATOR_PRESETS: readonly ["slot", "stack", "tabs", "tabs-stack", "stack-tabs", "stack-tabs-stack", "drawer", "drawer-stack", "stack-drawer", "stack-drawer-stack", "drawer-tabs", "drawer-tabs-stack", "stack-drawer-tabs", "stack-drawer-tabs-stack", "split-view", "custom"];
 export type NavigatorPreset = (typeof NAVIGATOR_PRESETS)[number];
 export declare const STACK_IMPLEMENTATIONS: readonly ["native", "javascript", "experimental"];
 export type StackImplementation = (typeof STACK_IMPLEMENTATIONS)[number];
@@ -49,21 +49,21 @@ export interface DrawerNavigatorOptions {
     swipeEnabled?: boolean;
     headerShown?: boolean;
 }
-export declare const FIXED_CUSTOM_TABS_PRESENTATIONS: readonly ["bottom", "top", "rail", "sidebar"];
-export type FixedCustomTabsPresentation = (typeof FIXED_CUSTOM_TABS_PRESENTATIONS)[number];
-export declare const CUSTOM_TABS_PRESENTATIONS: readonly ["bottom", "top", "rail", "sidebar", "responsive", "custom"];
-export type CustomTabsPresentation = (typeof CUSTOM_TABS_PRESENTATIONS)[number];
+export declare const FIXED_HEADLESS_TABS_PRESENTATIONS: readonly ["bottom", "top", "rail", "sidebar"];
+export type FixedHeadlessTabsPresentation = (typeof FIXED_HEADLESS_TABS_PRESENTATIONS)[number];
+export declare const HEADLESS_TABS_PRESENTATIONS: readonly ["bottom", "top", "rail", "sidebar", "responsive", "custom"];
+export type HeadlessTabsPresentation = (typeof HEADLESS_TABS_PRESENTATIONS)[number];
 export declare const JAVASCRIPT_TABS_PRESENTATIONS: readonly ["bottom", "top"];
 export type JavaScriptTabsPresentation = (typeof JAVASCRIPT_TABS_PRESENTATIONS)[number];
 export declare const NATIVE_TABS_MINIMIZE_BEHAVIORS: readonly ["automatic", "never", "onScrollDown", "onScrollUp"];
 export type NativeTabsMinimizeBehavior = (typeof NATIVE_TABS_MINIMIZE_BEHAVIORS)[number];
 export interface ResponsiveTabsPresentation {
-    compact: FixedCustomTabsPresentation;
-    medium?: FixedCustomTabsPresentation;
-    expanded: FixedCustomTabsPresentation;
+    compact: FixedHeadlessTabsPresentation;
+    medium?: FixedHeadlessTabsPresentation;
+    expanded: FixedHeadlessTabsPresentation;
 }
-export type CustomTabsPresentationConfig = {
-    presentation: FixedCustomTabsPresentation;
+export type HeadlessTabsPresentationConfig = {
+    presentation: FixedHeadlessTabsPresentation;
     responsive?: never;
     customPresentationId?: never;
 } | {
@@ -76,10 +76,10 @@ export type CustomTabsPresentationConfig = {
     /** Serializable registered presentation id. */
     customPresentationId: string;
 };
-export type CustomTabsConfig = {
-    implementation: 'custom';
-} & CustomTabsPresentationConfig;
-export type CustomTabsWebConfig = CustomTabsPresentationConfig;
+export type HeadlessTabsConfig = {
+    implementation: 'headless';
+} & HeadlessTabsPresentationConfig;
+export type HeadlessTabsWebConfig = HeadlessTabsPresentationConfig;
 export interface NavigatorScreenReference {
     screenId: string;
 }
@@ -99,10 +99,10 @@ export interface AdaptiveTabsConfig {
     implementation?: 'adaptive';
     /** Android/iOS branch. Expo Router may expose this implementation as unstable. */
     native?: NativeTabsConfig;
-    /** Web branch rendered through headless custom tabs. */
-    web?: CustomTabsWebConfig;
+    /** Web branch rendered through headless tabs. */
+    web?: HeadlessTabsWebConfig;
 }
-export type TabsImplementationConfig = AdaptiveTabsConfig | CustomTabsConfig | JavaScriptTabsConfig | NativeTabsConfig;
+export type TabsImplementationConfig = AdaptiveTabsConfig | HeadlessTabsConfig | JavaScriptTabsConfig | NativeTabsConfig;
 interface NavigatorNodeBase {
     initialRouteName?: string;
     routes: RouteDefinition[];
@@ -150,10 +150,6 @@ export interface RouteDefinition {
     stackOptions?: StackScreenOptions;
     navigator?: NavigatorNode;
 }
-export interface NavigatorFlows {
-    onboarding?: boolean;
-    authentication?: boolean;
-}
 export interface NavigatorDefaults {
     tabs?: TabsImplementationConfig;
     stack?: StackImplementationConfig;
@@ -175,9 +171,11 @@ export interface NavigatorPlatforms {
  */
 export type AppNavigatorManifest = NavigatorNode & {
     preset?: NavigatorPreset;
-    flows?: NavigatorFlows;
     defaults?: NavigatorDefaults;
     platforms?: NavigatorPlatforms;
 };
-export {};
+export type { NavigatorCapabilityDescriptor, NavigatorCapabilityRequirement, NavigatorCapabilityTarget, NavigatorCapabilityVerification, NavigatorCatalog, NavigatorImplementation, NavigatorPresentation, NavigatorPresetDescriptor, NavigatorVerificationKind, NavigatorVerificationStatus, } from './navigator/catalog';
+export type { CustomNavigatorConfigIssue, CustomNavigatorRegistration, CustomNavigatorRegistry, } from './navigator/extensions';
+export type { NavigatorDependencyRequirement, NavigatorGeneratedFile, NavigatorGenerationBindings, NavigatorGenerationOptions, NavigatorGenerationResult, NavigatorScreenModule, } from './navigator/generation';
+export type { CreateNavigatorPlanOptions, ExpoRouterNavigatorModule, NavigatorAdapterId, NavigatorAdapterPlan, NavigatorApiStability, NavigatorCapabilityId, NavigatorDiagnostic, NavigatorNodePlan, NavigatorPlan, NavigatorResponsiveSize, NavigatorRoutePlan, NavigatorRuntimePlatform, NavigatorSupportStatus, NavigatorValidationContext, ResolvedHeadlessTabsPresentation, 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

@@ -4,16 +4,16 @@ export const NAVIGATOR_PRESETS = [
     'stack',
     'tabs',
     'tabs-stack',
+    'stack-tabs',
+    'stack-tabs-stack',
     'drawer',
     'drawer-stack',
+    'stack-drawer',
+    'stack-drawer-stack',
     'drawer-tabs',
     'drawer-tabs-stack',
-    'root-stack-tabs',
-    'root-stack-tabs-stack',
-    'root-stack-drawer',
-    'root-stack-drawer-stack',
-    'root-stack-drawer-tabs',
-    'root-stack-drawer-tabs-stack',
+    'stack-drawer-tabs',
+    'stack-drawer-tabs-stack',
     'split-view',
     'custom',
 ];
@@ -30,9 +30,9 @@ export const STACK_PRESENTATIONS = [
 export const JAVASCRIPT_STACK_PRESENTATIONS = ['card', 'modal', 'transparentModal'];
 export const DRAWER_POSITIONS = ['left', 'right'];
 export const DRAWER_TYPES = ['front', 'back', 'slide', 'permanent'];
-export const FIXED_CUSTOM_TABS_PRESENTATIONS = ['bottom', 'top', 'rail', 'sidebar'];
-export const CUSTOM_TABS_PRESENTATIONS = [
-    ...FIXED_CUSTOM_TABS_PRESENTATIONS,
+export const FIXED_HEADLESS_TABS_PRESENTATIONS = ['bottom', 'top', 'rail', 'sidebar'];
+export const HEADLESS_TABS_PRESENTATIONS = [
+    ...FIXED_HEADLESS_TABS_PRESENTATIONS,
     'responsive',
     'custom',
 ];

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,YAAY;IACZ,kBAAkB;IAClB,QAAQ;IACR,cAAc;IACd,cAAc;IACd,oBAAoB;IACpB,aAAa;IACb,mBAAmB;IACnB,mBAAmB;IACnB,yBAAyB;IACzB,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,iCAAiC,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAG/F,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,GAAG,iCAAiC;IACpC,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  'stack-tabs',\n  'stack-tabs-stack',\n  'drawer',\n  'drawer-stack',\n  'stack-drawer',\n  'stack-drawer-stack',\n  'drawer-tabs',\n  'drawer-tabs-stack',\n  'stack-drawer-tabs',\n  '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_HEADLESS_TABS_PRESENTATIONS = ['bottom', 'top', 'rail', 'sidebar'] as const;\nexport type FixedHeadlessTabsPresentation = (typeof FIXED_HEADLESS_TABS_PRESENTATIONS)[number];\n\nexport const HEADLESS_TABS_PRESENTATIONS = [\n  ...FIXED_HEADLESS_TABS_PRESENTATIONS,\n  'responsive',\n  'custom',\n] as const;\nexport type HeadlessTabsPresentation = (typeof HEADLESS_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: FixedHeadlessTabsPresentation;\n  medium?: FixedHeadlessTabsPresentation;\n  expanded: FixedHeadlessTabsPresentation;\n}\n\nexport type HeadlessTabsPresentationConfig =\n  | {\n      presentation: FixedHeadlessTabsPresentation;\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 HeadlessTabsConfig = {\n  implementation: 'headless';\n} & HeadlessTabsPresentationConfig;\n\nexport type HeadlessTabsWebConfig = HeadlessTabsPresentationConfig;\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 tabs. */\n  web?: HeadlessTabsWebConfig;\n}\n\nexport type TabsImplementationConfig =\n  AdaptiveTabsConfig | HeadlessTabsConfig | 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 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  defaults?: NavigatorDefaults;\n  platforms?: NavigatorPlatforms;\n};\n\nexport type {\n  NavigatorCapabilityDescriptor,\n  NavigatorCapabilityRequirement,\n  NavigatorCapabilityTarget,\n  NavigatorCapabilityVerification,\n  NavigatorCatalog,\n  NavigatorImplementation,\n  NavigatorPresentation,\n  NavigatorPresetDescriptor,\n  NavigatorVerificationKind,\n  NavigatorVerificationStatus,\n} from './navigator/catalog';\nexport type {\n  CustomNavigatorConfigIssue,\n  CustomNavigatorRegistration,\n  CustomNavigatorRegistry,\n} from './navigator/extensions';\nexport type {\n  NavigatorDependencyRequirement,\n  NavigatorGeneratedFile,\n  NavigatorGenerationBindings,\n  NavigatorGenerationOptions,\n  NavigatorGenerationResult,\n  NavigatorScreenModule,\n} from './navigator/generation';\nexport type {\n  CreateNavigatorPlanOptions,\n  ExpoRouterNavigatorModule,\n  NavigatorAdapterId,\n  NavigatorAdapterPlan,\n  NavigatorApiStability,\n  NavigatorCapabilityId,\n  NavigatorDiagnostic,\n  NavigatorNodePlan,\n  NavigatorPlan,\n  NavigatorResponsiveSize,\n  NavigatorRoutePlan,\n  NavigatorRuntimePlatform,\n  NavigatorSupportStatus,\n  NavigatorValidationContext,\n  ResolvedHeadlessTabsPresentation,\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": "12.0.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.12.0",
     "@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/appManifest/navigator.ts

@@ -20,7 +20,7 @@ export function isAppNavigatorManifest(value: unknown): boolean {
     isNavigatorNode(value) &&
     (value.preset === undefined ||
       (typeof value.preset === 'string' && NAVIGATOR_PRESET_SET.has(value.preset))) &&
-    (value.flows === undefined || isNavigatorFlows(value.flows)) &&
+    value.flows === undefined &&
     (value.defaults === undefined || isNavigatorDefaults(value.defaults)) &&
     (value.platforms === undefined || isNavigatorPlatforms(value.platforms))
   );
@@ -134,15 +134,6 @@ function isNavigatorJsonValue(value: unknown, ancestors: Set<object>): boolean {
   return isValid;
 }
 
-/*** Validate optional app-level navigator flow intent. */
-function isNavigatorFlows(value: unknown): boolean {
-  return (
-    isRecord(value) &&
-    isOptionalBoolean(value.onboarding) &&
-    isOptionalBoolean(value.authentication)
-  );
-}
-
 /*** Validate package-owned navigator defaults without requiring a navigator node type. */
 function isNavigatorDefaults(value: unknown): boolean {
   return (

package/src/appManifest/navigatorOptions.ts

@@ -1,8 +1,8 @@
 import {
-  CUSTOM_TABS_PRESENTATIONS,
   DRAWER_POSITIONS,
   DRAWER_TYPES,
-  FIXED_CUSTOM_TABS_PRESENTATIONS,
+  FIXED_HEADLESS_TABS_PRESENTATIONS,
+  HEADLESS_TABS_PRESENTATIONS,
   JAVASCRIPT_STACK_PRESENTATIONS,
   JAVASCRIPT_TABS_PRESENTATIONS,
   NATIVE_TABS_MINIMIZE_BEHAVIORS,
@@ -10,10 +10,10 @@ import {
 } from '../navigator';
 import { isOptionalBoolean, isOptionalString, isRecord } from './shared';
 
-const CUSTOM_TABS_PRESENTATION_SET = new Set<string>(CUSTOM_TABS_PRESENTATIONS);
+const HEADLESS_TABS_PRESENTATION_SET = new Set<string>(HEADLESS_TABS_PRESENTATIONS);
 const DRAWER_POSITION_SET = new Set<string>(DRAWER_POSITIONS);
 const DRAWER_TYPE_SET = new Set<string>(DRAWER_TYPES);
-const FIXED_CUSTOM_TABS_PRESENTATION_SET = new Set<string>(FIXED_CUSTOM_TABS_PRESENTATIONS);
+const FIXED_HEADLESS_TABS_PRESENTATION_SET = new Set<string>(FIXED_HEADLESS_TABS_PRESENTATIONS);
 const JAVASCRIPT_STACK_PRESENTATION_SET = new Set<string>(JAVASCRIPT_STACK_PRESENTATIONS);
 const JAVASCRIPT_TABS_PRESENTATION_SET = new Set<string>(JAVASCRIPT_TABS_PRESENTATIONS);
 const NATIVE_TABS_MINIMIZE_BEHAVIOR_SET = new Set<string>(NATIVE_TABS_MINIMIZE_BEHAVIORS);
@@ -98,9 +98,9 @@ export function isTabsImplementationConfig(value: Record<string, unknown>): bool
   if (value.implementation === 'native') return isFullNativeTabsConfig(value);
   if (value.implementation === 'javascript') return isJavaScriptTabsConfig(value);
   return (
-    value.implementation === 'custom' &&
+    value.implementation === 'headless' &&
     hasNoDefinedKeys(value, ['options', 'native', 'web', 'minimizeBehavior', 'bottomAccessory']) &&
-    isCustomTabsPresentationConfig(value)
+    isHeadlessTabsPresentationConfig(value)
   );
 }
 
@@ -181,7 +181,7 @@ function isAdaptiveTabsConfig(value: Record<string, unknown>): boolean {
       'bottomAccessory',
     ]) &&
     (value.native === undefined || isNativeTabsConfig(value.native)) &&
-    (value.web === undefined || isCustomTabsWebConfig(value.web))
+    (value.web === undefined || isHeadlessTabsWebConfig(value.web))
   );
 }
 
@@ -237,20 +237,20 @@ function isNativeTabsFields(value: Record<string, unknown>): boolean {
   );
 }
 
-/*** Validate the implementation-free custom-tabs Web branch inside adaptive tabs. */
-function isCustomTabsWebConfig(value: unknown): boolean {
+/*** Validate the implementation-free headless-tabs Web branch inside adaptive tabs. */
+function isHeadlessTabsWebConfig(value: unknown): boolean {
   return (
     isRecord(value) &&
     hasOnlyKeys(value, ['presentation', 'responsive', 'customPresentationId']) &&
-    isCustomTabsPresentationConfig(value)
+    isHeadlessTabsPresentationConfig(value)
   );
 }
 
-/*** Validate custom-tab presentation and its conditional serializable configuration. */
-function isCustomTabsPresentationConfig(value: Record<string, unknown>): boolean {
+/*** Validate headless-tab presentation and its conditional serializable configuration. */
+function isHeadlessTabsPresentationConfig(value: Record<string, unknown>): boolean {
   if (
     typeof value.presentation !== 'string' ||
-    !CUSTOM_TABS_PRESENTATION_SET.has(value.presentation)
+    !HEADLESS_TABS_PRESENTATION_SET.has(value.presentation)
   ) {
     return false;
   }
@@ -258,7 +258,7 @@ function isCustomTabsPresentationConfig(value: Record<string, unknown>): boolean
     return false;
   }
   if (!isOptionalString(value.customPresentationId)) return false;
-  if (FIXED_CUSTOM_TABS_PRESENTATION_SET.has(value.presentation)) {
+  if (FIXED_HEADLESS_TABS_PRESENTATION_SET.has(value.presentation)) {
     return value.responsive === undefined && value.customPresentationId === undefined;
   }
   if (value.presentation === 'responsive') {
@@ -271,17 +271,18 @@ function isCustomTabsPresentationConfig(value: Record<string, unknown>): boolean
   );
 }
 
-/*** Validate semantic compact/medium/expanded custom-tab presentation mapping. */
+/*** Validate semantic compact/medium/expanded headless-tab presentation mapping. */
 function isResponsiveTabsPresentation(value: unknown): boolean {
   return (
     isRecord(value) &&
     hasOnlyKeys(value, ['compact', 'medium', 'expanded']) &&
     typeof value.compact === 'string' &&
-    FIXED_CUSTOM_TABS_PRESENTATION_SET.has(value.compact) &&
+    FIXED_HEADLESS_TABS_PRESENTATION_SET.has(value.compact) &&
     (value.medium === undefined ||
-      (typeof value.medium === 'string' && FIXED_CUSTOM_TABS_PRESENTATION_SET.has(value.medium))) &&
+      (typeof value.medium === 'string' &&
+        FIXED_HEADLESS_TABS_PRESENTATION_SET.has(value.medium))) &&
     typeof value.expanded === 'string' &&
-    FIXED_CUSTOM_TABS_PRESENTATION_SET.has(value.expanded)
+    FIXED_HEADLESS_TABS_PRESENTATION_SET.has(value.expanded)
   );
 }
 

package/src/navigator/catalog.ts

@@ -0,0 +1,79 @@
+import type {
+  HeadlessTabsPresentation,
+  JavaScriptTabsPresentation,
+  NavigatorPreset,
+  NavigatorType,
+  StackPresentation,
+} from '../navigator';
+import type { NavigatorDependencyRequirement } from './generation';
+import type {
+  NavigatorApiStability,
+  NavigatorCapabilityId,
+  NavigatorRuntimePlatform,
+  NavigatorSupportStatus,
+} from './planning';
+
+export type NavigatorVerificationKind =
+  | 'structural'
+  | 'generation'
+  | 'format'
+  | 'lint'
+  | 'dependency'
+  | 'typescript'
+  | 'install'
+  | 'build'
+  | 'export'
+  | 'browser'
+  | 'simulator'
+  | 'device';
+
+export type NavigatorVerificationStatus = 'verified' | 'unverified';
+
+export type NavigatorImplementation = 'native' | 'javascript' | 'headless' | 'experimental';
+
+export type NavigatorPresentation =
+  | StackPresentation
+  | HeadlessTabsPresentation
+  | JavaScriptTabsPresentation
+  | 'two-column'
+  | 'three-column';
+
+export interface NavigatorCapabilityVerification {
+  kind: NavigatorVerificationKind;
+  status: NavigatorVerificationStatus;
+}
+
+export interface NavigatorCapabilityTarget {
+  platform: NavigatorRuntimePlatform;
+  support: NavigatorSupportStatus;
+  verification: readonly NavigatorCapabilityVerification[];
+}
+
+export interface NavigatorCapabilityRequirement {
+  id: string;
+  description: string;
+}
+
+export interface NavigatorCapabilityDescriptor {
+  id: NavigatorCapabilityId;
+  topology: NavigatorType;
+  implementation?: NavigatorImplementation;
+  presentation?: NavigatorPresentation;
+  stability: NavigatorApiStability;
+  targets: readonly NavigatorCapabilityTarget[];
+  dependencies: readonly NavigatorDependencyRequirement[];
+  requirements: readonly NavigatorCapabilityRequirement[];
+  incompatibilities: readonly NavigatorCapabilityId[];
+  limitations: readonly string[];
+}
+
+export interface NavigatorPresetDescriptor {
+  id: NavigatorPreset;
+  description: string;
+  topology: readonly NavigatorType[];
+}
+
+export interface NavigatorCatalog {
+  capabilities: readonly NavigatorCapabilityDescriptor[];
+  presets: readonly NavigatorPresetDescriptor[];
+}

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,46 @@
+import type {
+  NavigatorCapabilityId,
+  NavigatorDiagnostic,
+  NavigatorPlan,
+  NavigatorSupportStatus,
+} from './planning';
+
+export interface NavigatorGeneratedFile {
+  path: string;
+  contents: string;
+}
+
+export interface NavigatorGenerationBindings {
+  screens: Readonly<Record<string, NavigatorScreenModule>>;
+  guards: Readonly<Record<string, NavigatorScreenModule>>;
+  iconSourceResolver?: NavigatorScreenModule;
+  tabPresentations?: Readonly<Record<string, NavigatorScreenModule>>;
+}
+
+export interface NavigatorDependencyRequirement {
+  packageName: string;
+  versionRange: string;
+  kind: 'dependency' | 'peerDependency';
+}
+
+export interface NavigatorGenerationResult {
+  support: NavigatorSupportStatus;
+  capabilityIds: readonly NavigatorCapabilityId[];
+  dependencies: readonly NavigatorDependencyRequirement[];
+  diagnostics: readonly NavigatorDiagnostic[];
+  plan: NavigatorPlan;
+  files: readonly NavigatorGeneratedFile[];
+}
+
+/** 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;
+}