@ankhorage/zora 1.0.8 → 1.0.10

package/dist/patterns/zora-drawer-content/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/patterns/zora-drawer-content/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,KAAK,EACV,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACpB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D,KAAK,EAAE,mBAAmB,CAAC;IAC3B,UAAU,EAAE,oBAAoB,CAAC;IACjC,WAAW,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/patterns/zora-drawer-content/types.js

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

package/dist/patterns/zora-drawer-content/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/patterns/zora-drawer-content/types.ts"],"names":[],"mappings":"","sourcesContent":["import type React from 'react';\n\nimport type { ZoraNavigationRouteMap } from '../../components/navigation-list';\nimport type {\n  ZoraDrawerNavigation,\n  ZoraNavigationDescriptors,\n  ZoraNavigationState,\n} from '../../internal/resolveZoraNavigationItems';\nimport type { ZoraBaseProps } from '../../theme/ZoraBaseProps';\n\nexport interface ZoraDrawerContentProps extends ZoraBaseProps {\n  state: ZoraNavigationState;\n  navigation: ZoraDrawerNavigation;\n  descriptors?: ZoraNavigationDescriptors | undefined;\n  routeMap?: ZoraNavigationRouteMap | undefined;\n  compact?: boolean;\n  header?: React.ReactNode;\n  footer?: React.ReactNode;\n  testID?: string;\n}\n"]}

package/dist/patterns/zora-tab-bar/ZoraTabBar.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { ZoraTabBarProps } from './types';
+export declare const ZoraTabBar: (props: ZoraTabBarProps) => React.ReactElement | null;
+//# sourceMappingURL=ZoraTabBar.d.ts.map

package/dist/patterns/zora-tab-bar/ZoraTabBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZoraTabBar.d.ts","sourceRoot":"","sources":["../../../src/patterns/zora-tab-bar/ZoraTabBar.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAQ1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AA6C/C,eAAO,MAAM,UAAU,uDAAsC,CAAC"}

package/dist/patterns/zora-tab-bar/ZoraTabBar.js

@@ -0,0 +1,33 @@
+import { TabBar as SurfaceTabBar } from '@ankhorage/surface';
+import React from 'react';
+import { Surface } from '../../foundation';
+import { createTabBarItemPressHandler, resolveNavigationItems, } from '../../internal/resolveZoraNavigationItems';
+import { withZoraThemeScope } from '../../theme/withZoraThemeScope';
+function ZoraTabBarInner({ themeId: _themeId, mode: _mode, state, navigation, descriptors, routeMap, compact = false, chrome = 'raised', testID, }) {
+    const resolved = resolveNavigationItems({
+        state,
+        descriptors,
+        routeMap,
+        kind: 'tab',
+    });
+    const items = resolved.map((item) => ({
+        id: item.route.key,
+        label: item.label,
+        icon: item.metadata?.icon,
+        badge: item.metadata?.badge,
+        active: item.active,
+        disabled: item.disabled,
+        onPress: createTabBarItemPressHandler({ item, navigation }),
+        accessibilityLabel: item.metadata?.accessibilityLabel,
+        testID: item.metadata?.testID,
+    }));
+    const content = <SurfaceTabBar compact={compact} items={items} testID={testID}/>;
+    if (chrome === 'none') {
+        return content;
+    }
+    return (<Surface variant="raised" testID={testID ? `${testID}-chrome` : undefined}>
+      {content}
+    </Surface>);
+}
+export const ZoraTabBar = withZoraThemeScope(ZoraTabBarInner);
+//# sourceMappingURL=ZoraTabBar.js.map

package/dist/patterns/zora-tab-bar/ZoraTabBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZoraTabBar.js","sourceRoot":"","sources":["../../../src/patterns/zora-tab-bar/ZoraTabBar.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGpE,SAAS,eAAe,CAAC,EACvB,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,KAAK,EACX,KAAK,EACL,UAAU,EACV,WAAW,EACX,QAAQ,EACR,OAAO,GAAG,KAAK,EACf,MAAM,GAAG,QAAQ,EACjB,MAAM,GACU;IAChB,MAAM,QAAQ,GAAG,sBAAsB,CAAC;QACtC,KAAK;QACL,WAAW;QACX,QAAQ;QACR,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG;QAClB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI;QACzB,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK;QAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO,EAAE,4BAA4B,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAC3D,kBAAkB,EAAE,IAAI,CAAC,QAAQ,EAAE,kBAAkB;QACrD,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM;KAC9B,CAAC,CAAC,CAAC;IAEJ,MAAM,OAAO,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAG,CAAC;IAElF,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,CACL,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CACxE;MAAA,CAAC,OAAO,CACV;IAAA,EAAE,OAAO,CAAC,CACX,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC","sourcesContent":["import { TabBar as SurfaceTabBar } from '@ankhorage/surface';\nimport React from 'react';\n\nimport { Surface } from '../../foundation';\nimport {\n  createTabBarItemPressHandler,\n  resolveNavigationItems,\n} from '../../internal/resolveZoraNavigationItems';\nimport { withZoraThemeScope } from '../../theme/withZoraThemeScope';\nimport type { ZoraTabBarProps } from './types';\n\nfunction ZoraTabBarInner({\n  themeId: _themeId,\n  mode: _mode,\n  state,\n  navigation,\n  descriptors,\n  routeMap,\n  compact = false,\n  chrome = 'raised',\n  testID,\n}: ZoraTabBarProps) {\n  const resolved = resolveNavigationItems({\n    state,\n    descriptors,\n    routeMap,\n    kind: 'tab',\n  });\n\n  const items = resolved.map((item) => ({\n    id: item.route.key,\n    label: item.label,\n    icon: item.metadata?.icon,\n    badge: item.metadata?.badge,\n    active: item.active,\n    disabled: item.disabled,\n    onPress: createTabBarItemPressHandler({ item, navigation }),\n    accessibilityLabel: item.metadata?.accessibilityLabel,\n    testID: item.metadata?.testID,\n  }));\n\n  const content = <SurfaceTabBar compact={compact} items={items} testID={testID} />;\n\n  if (chrome === 'none') {\n    return content;\n  }\n\n  return (\n    <Surface variant=\"raised\" testID={testID ? `${testID}-chrome` : undefined}>\n      {content}\n    </Surface>\n  );\n}\n\nexport const ZoraTabBar = withZoraThemeScope(ZoraTabBarInner);\n"]}

package/dist/patterns/zora-tab-bar/index.d.ts

@@ -0,0 +1,3 @@
+export type { ZoraTabBarProps } from './types';
+export { ZoraTabBar } from './ZoraTabBar';
+//# sourceMappingURL=index.d.ts.map

package/dist/patterns/zora-tab-bar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/patterns/zora-tab-bar/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/patterns/zora-tab-bar/index.js

@@ -0,0 +1,2 @@
+export { ZoraTabBar } from './ZoraTabBar';
+//# sourceMappingURL=index.js.map

package/dist/patterns/zora-tab-bar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/patterns/zora-tab-bar/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC","sourcesContent":["export type { ZoraTabBarProps } from './types';\nexport { ZoraTabBar } from './ZoraTabBar';\n"]}

package/dist/patterns/zora-tab-bar/types.d.ts

@@ -0,0 +1,19 @@
+import type { ZoraNavigationRouteMap } from '../../components/navigation-list';
+import type { ZoraNavigationDescriptors, ZoraNavigationState, ZoraTabBarNavigation } from '../../internal/resolveZoraNavigationItems';
+import type { ZoraBaseProps } from '../../theme/ZoraBaseProps';
+export interface ZoraTabBarProps extends ZoraBaseProps {
+    state: ZoraNavigationState;
+    navigation: ZoraTabBarNavigation;
+    descriptors?: ZoraNavigationDescriptors | undefined;
+    insets?: {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+    } | undefined;
+    routeMap?: ZoraNavigationRouteMap | undefined;
+    compact?: boolean;
+    chrome?: 'none' | 'raised';
+    testID?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/patterns/zora-tab-bar/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/patterns/zora-tab-bar/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,KAAK,EACV,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,KAAK,EAAE,mBAAmB,CAAC;IAC3B,UAAU,EAAE,oBAAoB,CAAC;IACjC,WAAW,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACpD,MAAM,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACtF,QAAQ,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/patterns/zora-tab-bar/types.js

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

package/dist/patterns/zora-tab-bar/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/patterns/zora-tab-bar/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ZoraNavigationRouteMap } from '../../components/navigation-list';\nimport type {\n  ZoraNavigationDescriptors,\n  ZoraNavigationState,\n  ZoraTabBarNavigation,\n} from '../../internal/resolveZoraNavigationItems';\nimport type { ZoraBaseProps } from '../../theme/ZoraBaseProps';\n\nexport interface ZoraTabBarProps extends ZoraBaseProps {\n  state: ZoraNavigationState;\n  navigation: ZoraTabBarNavigation;\n  descriptors?: ZoraNavigationDescriptors | undefined;\n  insets?: { top?: number; bottom?: number; left?: number; right?: number } | undefined;\n  routeMap?: ZoraNavigationRouteMap | undefined;\n  compact?: boolean;\n  chrome?: 'none' | 'raised';\n  testID?: string;\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/zora",
   "type": "module",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {
@@ -45,7 +45,7 @@
   "dependencies": {
     "@ankhorage/color-theory": "^0.0.4",
     "@ankhorage/contracts": "^1.1.1",
-    "@ankhorage/surface": "^1.0.2"
+    "@ankhorage/surface": "^1.1.0"
   },
   "files": [
     "dist",

package/src/audit.test.ts

@@ -240,3 +240,32 @@ describe('Plan 5 audit — public exports carry no legacy types', () => {
     expect(indexSource).not.toContain('AnkhTheme');
   });
 });
+
+describe('navigation chrome policy', () => {
+  const NAVIGATION_PATHS = [
+    join(SRC_ROOT, 'components', 'navigation-item'),
+    join(SRC_ROOT, 'components', 'navigation-list'),
+    join(SRC_ROOT, 'patterns', 'zora-tab-bar'),
+    join(SRC_ROOT, 'patterns', 'zora-drawer-content'),
+    join(SRC_ROOT, 'internal', 'resolveZoraNavigationItems.ts'),
+  ];
+
+  test('does not import expo-router, react-navigation, or Surface internals', () => {
+    const sources = NAVIGATION_PATHS.flatMap((path) => {
+      if (path.endsWith('.ts')) {
+        return [readFileSync(path, 'utf8')];
+      }
+
+      if (!path.includes(`${SRC_ROOT}/`)) {
+        return [];
+      }
+
+      return listFiles(path).map((filePath) => readFileSync(filePath, 'utf8'));
+    }).join('\n');
+
+    expect(sources).not.toMatch(/expo-router/);
+    expect(sources).not.toMatch(/@react-navigation\//);
+    expect(sources).not.toMatch(/@ankhorage\/surface\/src\//);
+    expect(sources).not.toMatch(/@ankhorage\/surface\/dist\//);
+  });
+});

package/src/components/navigation-item/NavigationItem.tsx

@@ -0,0 +1,36 @@
+import { NavigationItem as SurfaceNavigationItem } from '@ankhorage/surface';
+import React from 'react';
+
+import { withZoraThemeScope } from '../../theme/withZoraThemeScope';
+import type { NavigationItemProps } from './types';
+
+function NavigationItemInner({
+  themeId: _themeId,
+  mode: _mode,
+  route,
+  metadata,
+  active = false,
+  compact = false,
+  onPress,
+  testID,
+}: NavigationItemProps) {
+  return (
+    <SurfaceNavigationItem
+      compact={compact}
+      item={{
+        id: route.key,
+        label: metadata?.label ?? route.name,
+        icon: metadata?.icon,
+        badge: metadata?.badge,
+        active,
+        disabled: metadata?.disabled,
+        onPress,
+        accessibilityLabel: metadata?.accessibilityLabel,
+        testID: metadata?.testID,
+      }}
+      testID={testID}
+    />
+  );
+}
+
+export const NavigationItem = withZoraThemeScope(NavigationItemInner);

package/src/components/navigation-item/index.ts

@@ -0,0 +1,6 @@
+export { NavigationItem } from './NavigationItem';
+export type {
+  NavigationItemProps,
+  ZoraNavigationRouteMetadata,
+  ZoraNavigationRouteState,
+} from './types';

package/src/components/navigation-item/types.ts

@@ -0,0 +1,26 @@
+import type { ButtonIconSpec } from '@ankhorage/surface';
+import type React from 'react';
+
+import type { ZoraBaseProps } from '../../theme/ZoraBaseProps';
+
+export interface ZoraNavigationRouteMetadata {
+  label?: React.ReactNode;
+  icon?: ButtonIconSpec;
+  badge?: React.ReactNode;
+  disabled?: boolean;
+  testID?: string;
+  accessibilityLabel?: string;
+}
+
+export interface ZoraNavigationRouteState {
+  key: string;
+  name: string;
+}
+
+export interface NavigationItemProps extends ZoraBaseProps {
+  route: ZoraNavigationRouteState;
+  metadata?: ZoraNavigationRouteMetadata;
+  active?: boolean;
+  compact?: boolean;
+  onPress?: () => void;
+}

package/src/components/navigation-list/NavigationList.tsx

@@ -0,0 +1,62 @@
+import {
+  DrawerNavigation as SurfaceDrawerNavigation,
+  NavigationList as SurfaceNavigationList,
+} from '@ankhorage/surface';
+import React from 'react';
+
+import { withZoraThemeScope } from '../../theme/withZoraThemeScope';
+import type { NavigationListProps } from './types';
+
+function NavigationListInner({
+  themeId: _themeId,
+  mode: _mode,
+  routes,
+  routeMap,
+  activeRouteKey,
+  orientation = 'vertical',
+  compact = false,
+  onRoutePress,
+  header,
+  footer,
+  testID,
+}: NavigationListProps) {
+  const items = routes.map((route) => {
+    const metadata = routeMap?.[route.name];
+    const active = activeRouteKey ? route.key === activeRouteKey : false;
+
+    return {
+      id: route.key,
+      label: metadata?.label ?? route.name,
+      icon: metadata?.icon,
+      badge: metadata?.badge,
+      active,
+      disabled: metadata?.disabled,
+      onPress: metadata?.disabled ? undefined : () => onRoutePress?.(route),
+      accessibilityLabel: metadata?.accessibilityLabel,
+      testID: metadata?.testID,
+    };
+  });
+
+  if (header || footer) {
+    return (
+      <SurfaceDrawerNavigation
+        compact={compact}
+        footer={footer}
+        header={header}
+        items={items}
+        testID={testID}
+      />
+    );
+  }
+
+  return (
+    <SurfaceNavigationList
+      compact={compact}
+      items={items}
+      orientation={orientation}
+      testID={testID}
+    />
+  );
+}
+
+export const NavigationList = withZoraThemeScope(NavigationListInner);

package/src/components/navigation-list/index.ts

@@ -0,0 +1,2 @@
+export { NavigationList } from './NavigationList';
+export type { NavigationListProps, ZoraNavigationRouteMap } from './types';

package/src/components/navigation-list/types.ts

@@ -0,0 +1,17 @@
+import type React from 'react';
+
+import type { ZoraBaseProps } from '../../theme/ZoraBaseProps';
+import type { ZoraNavigationRouteMetadata, ZoraNavigationRouteState } from '../navigation-item';
+
+export type ZoraNavigationRouteMap = Partial<Record<string, ZoraNavigationRouteMetadata>>;
+
+export interface NavigationListProps extends ZoraBaseProps {
+  routes: readonly ZoraNavigationRouteState[];
+  routeMap?: ZoraNavigationRouteMap;
+  activeRouteKey?: string;
+  orientation?: 'vertical' | 'horizontal';
+  compact?: boolean;
+  onRoutePress?: (route: ZoraNavigationRouteState) => void;
+  header?: React.ReactNode;
+  footer?: React.ReactNode;
+}

package/src/index.ts

@@ -66,6 +66,14 @@ export type { MetricCardProps } from './components/metric-card';
 export { MetricCard } from './components/metric-card';
 export type { ModalProps } from './components/modal';
 export { Modal } from './components/modal';
+export type {
+  NavigationItemProps,
+  ZoraNavigationRouteMetadata,
+  ZoraNavigationRouteState,
+} from './components/navigation-item';
+export { NavigationItem } from './components/navigation-item';
+export type { NavigationListProps, ZoraNavigationRouteMap } from './components/navigation-list';
+export { NavigationList } from './components/navigation-list';
 export type { ProgressProps } from './components/progress';
 export { Progress } from './components/progress';
 export type { RadioGroupOption, RadioGroupProps, RadioProps } from './components/radio';
@@ -183,4 +191,8 @@ export type { TimelineItem, TimelineProps } from './patterns/timeline';
 export { Timeline } from './patterns/timeline';
 export type { TreeItemNode, TreeItemRenderProps, TreeViewProps } from './patterns/tree-view';
 export { TreeItem, TreeView } from './patterns/tree-view';
+export type { ZoraDrawerContentProps } from './patterns/zora-drawer-content';
+export { ZoraDrawerContent } from './patterns/zora-drawer-content';
+export type { ZoraTabBarProps } from './patterns/zora-tab-bar';
+export { ZoraTabBar } from './patterns/zora-tab-bar';
 export * from './theme';

package/src/internal/resolveZoraNavigationItems.test.ts

@@ -0,0 +1,163 @@
+import { describe, expect, test } from 'bun:test';
+import React from 'react';
+
+import {
+  createDrawerItemPressHandler,
+  createTabBarItemPressHandler,
+  resolveNavigationItems,
+  resolveRouteLabel,
+  type ZoraNavigationDescriptor,
+  type ZoraNavigationState,
+  type ZoraResolvedNavigationItem,
+  type ZoraRouteLabelSource,
+} from './resolveZoraNavigationItems';
+
+describe('resolveRouteLabel', () => {
+  test('prefers routeMap label over descriptor label', () => {
+    const descriptor: ZoraNavigationDescriptor = {
+      options: {
+        title: 'Home Title',
+        tabBarLabel: 'Home Tab',
+      },
+    };
+
+    const result = resolveRouteLabel({
+      kind: 'tab',
+      route: { key: 'k1', name: 'home' },
+      metadata: { label: 'Home Map' },
+      descriptor,
+    });
+
+    const expectedSource: ZoraRouteLabelSource = 'routeMap';
+    expect(result).toEqual({ label: 'Home Map', source: expectedSource });
+  });
+
+  test('uses descriptor label/title as fallback for label only', () => {
+    const descriptor: ZoraNavigationDescriptor = {
+      options: {
+        title: 'Settings Title',
+        tabBarLabel: undefined,
+      },
+    };
+
+    const result = resolveRouteLabel({
+      kind: 'tab',
+      route: { key: 'k2', name: 'settings' },
+      metadata: undefined,
+      descriptor,
+    });
+
+    expect(result).toEqual({ label: 'Settings Title', source: 'descriptor' });
+  });
+
+  test('falls back to route name if nothing else provided', () => {
+    const result = resolveRouteLabel({
+      kind: 'drawer',
+      route: { key: 'k3', name: 'profile' },
+      metadata: undefined,
+      descriptor: undefined,
+    });
+
+    expect(result).toEqual({ label: 'profile', source: 'name' });
+  });
+});
+
+describe('resolveNavigationItems', () => {
+  test('maps active index + routeMap disabled state without using descriptors for icons/badges', () => {
+    const state: ZoraNavigationState = {
+      index: 1,
+      routes: [
+        { key: 'r1', name: 'home' },
+        { key: 'r2', name: 'settings' },
+      ],
+    };
+
+    const items = resolveNavigationItems({
+      state,
+      kind: 'tab',
+      descriptors: {
+        r1: { options: { tabBarLabel: 'Home Opt', title: 'Home Title' } },
+        r2: { options: { tabBarLabel: 'Settings Opt' } },
+      },
+      routeMap: {
+        settings: { disabled: true, badge: React.createElement('span', null, '3') },
+      },
+    });
+
+    expect(items).toHaveLength(2);
+    expect(items[0]).toMatchObject({ active: false, disabled: false });
+    expect(items[1]).toMatchObject({ active: true, disabled: true });
+    expect(items[1]?.metadata?.badge).toBeDefined();
+  });
+});
+
+describe('press handler helpers', () => {
+  test('tab press handler is undefined for disabled or active items', () => {
+    const handlerDisabled = createTabBarItemPressHandler({
+      item: {
+        route: { key: 'k1', name: 'home' },
+        metadata: { disabled: true },
+        label: 'Home',
+        active: false,
+        disabled: true,
+      },
+      navigation: { navigate: () => undefined },
+    });
+    expect(handlerDisabled).toBeUndefined();
+
+    const handlerActive = createTabBarItemPressHandler({
+      item: {
+        route: { key: 'k1', name: 'home' },
+        metadata: undefined,
+        label: 'Home',
+        active: true,
+        disabled: false,
+      },
+      navigation: { navigate: () => undefined },
+    });
+    expect(handlerActive).toBeUndefined();
+  });
+
+  test('tab press handler respects preventDefault', () => {
+    let navigatedTo: string | null = null;
+    const handler = createTabBarItemPressHandler({
+      item: {
+        route: { key: 'k1', name: 'home' },
+        metadata: undefined,
+        label: 'Home',
+        active: false,
+        disabled: false,
+      },
+      navigation: {
+        emit: () => ({ defaultPrevented: true }),
+        navigate: (name) => {
+          navigatedTo = name;
+        },
+      },
+    });
+
+    expect(handler).toBeDefined();
+    handler?.();
+    expect(navigatedTo).toBeNull();
+  });
+
+  test('drawer press handler navigates and closes drawer', () => {
+    const calls: string[] = [];
+    const handler = createDrawerItemPressHandler({
+      item: {
+        route: { key: 'k1', name: 'home' },
+        metadata: undefined,
+        label: 'Home',
+        active: false,
+        disabled: false,
+      } satisfies ZoraResolvedNavigationItem,
+      navigation: {
+        navigate: (name) => calls.push(`navigate:${name}`),
+        closeDrawer: () => calls.push('close'),
+      },
+    });
+
+    handler?.();
+    expect(calls).toEqual(['navigate:home', 'close']);
+  });
+});

package/src/internal/resolveZoraNavigationItems.ts

@@ -0,0 +1,156 @@
+import type React from 'react';
+
+import type {
+  ZoraNavigationRouteMetadata,
+  ZoraNavigationRouteState,
+} from '../components/navigation-item';
+import type { ZoraNavigationRouteMap } from '../components/navigation-list';
+
+export interface ZoraNavigationDescriptorOptions {
+  title?: string;
+  tabBarLabel?: string | React.ReactNode;
+  drawerLabel?: string | React.ReactNode;
+}
+
+export interface ZoraNavigationDescriptor {
+  options?: ZoraNavigationDescriptorOptions;
+}
+
+export type ZoraNavigationDescriptors = Readonly<
+  Record<string, ZoraNavigationDescriptor | undefined>
+>;
+
+export interface ZoraNavigationState {
+  index: number;
+  routes: readonly ZoraNavigationRouteState[];
+}
+
+export interface ZoraTabPressEvent {
+  type: 'tabPress';
+  target: string;
+  canPreventDefault: true;
+}
+
+export interface ZoraTabPressEventResult {
+  defaultPrevented: boolean;
+}
+
+export interface ZoraTabBarNavigation {
+  emit?: (event: ZoraTabPressEvent) => ZoraTabPressEventResult;
+  navigate: (name: string) => void;
+}
+
+export interface ZoraDrawerNavigation {
+  navigate: (name: string) => void;
+  closeDrawer?: () => void;
+}
+
+export interface ZoraResolvedNavigationItem {
+  route: ZoraNavigationRouteState;
+  metadata?: ZoraNavigationRouteMetadata;
+  label: React.ReactNode;
+  active: boolean;
+  disabled: boolean;
+}
+
+export type ZoraRouteLabelSource = 'routeMap' | 'descriptor' | 'name';
+
+export function resolveRouteLabel({
+  route,
+  metadata,
+  descriptor,
+  kind,
+}: {
+  route: ZoraNavigationRouteState;
+  metadata: ZoraNavigationRouteMetadata | undefined;
+  descriptor: ZoraNavigationDescriptor | undefined;
+  kind: 'tab' | 'drawer';
+}): { label: React.ReactNode; source: ZoraRouteLabelSource } {
+  if (metadata?.label !== undefined) {
+    return { label: metadata.label, source: 'routeMap' };
+  }
+
+  const options = descriptor?.options;
+  const fallback =
+    kind === 'tab'
+      ? (options?.tabBarLabel ?? options?.title)
+      : (options?.drawerLabel ?? options?.title);
+
+  if (fallback !== undefined) {
+    return { label: fallback, source: 'descriptor' };
+  }
+
+  return { label: route.name, source: 'name' };
+}
+
+export function resolveNavigationItems({
+  state,
+  descriptors,
+  routeMap,
+  kind,
+}: {
+  state: ZoraNavigationState;
+  descriptors?: ZoraNavigationDescriptors | undefined;
+  routeMap?: ZoraNavigationRouteMap | undefined;
+  kind: 'tab' | 'drawer';
+}): readonly ZoraResolvedNavigationItem[] {
+  const activeRoute = state.routes[state.index];
+
+  return state.routes.map((route) => {
+    const metadata = routeMap?.[route.name];
+    const descriptor = descriptors?.[route.key];
+    const { label } = resolveRouteLabel({ route, metadata, descriptor, kind });
+    const disabled = Boolean(metadata?.disabled);
+
+    return {
+      route,
+      metadata,
+      label,
+      active: activeRoute ? activeRoute.key === route.key : false,
+      disabled,
+    };
+  });
+}
+
+export function createTabBarItemPressHandler({
+  item,
+  navigation,
+}: {
+  item: ZoraResolvedNavigationItem;
+  navigation: ZoraTabBarNavigation;
+}): (() => void) | undefined {
+  if (item.disabled || item.active) {
+    return undefined;
+  }
+
+  return () => {
+    const result = navigation.emit?.({
+      type: 'tabPress',
+      target: item.route.key,
+      canPreventDefault: true,
+    });
+
+    if (result?.defaultPrevented) {
+      return;
+    }
+
+    navigation.navigate(item.route.name);
+  };
+}
+
+export function createDrawerItemPressHandler({
+  item,
+  navigation,
+}: {
+  item: ZoraResolvedNavigationItem;
+  navigation: ZoraDrawerNavigation;
+}): (() => void) | undefined {
+  if (item.disabled) {
+    return undefined;
+  }
+
+  return () => {
+    navigation.navigate(item.route.name);
+    navigation.closeDrawer?.();
+  };
+}