@ankhorage/zora 14.0.0 → 15.0.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 15.0.0
+
+### Major Changes
+
+- 3add861: Adopt `@ankhorage/surface` 5, replace `Menu` and `DropdownMenu` with `PopoverMenu`, make AppBar overflow a real action menu, migrate Breadcrumbs and Select to feature ownership and direct manifest nodes, and present Select with Popover on web and BottomSheetFlatList on native without `@react-native-picker/picker`.
+
+## 14.0.1
+
+### Patch Changes
+
+- be83fc0: Move AppBar into canonical `src/features/app-bar` ownership while preserving the public root API, and expand the Paradox Usage source with toast, adaptive picker, and direct native BottomSheet examples.
+
 ## 14.0.0
 
 ### Major Changes

package/README.md

@@ -3,17 +3,17 @@
 
 # @ankhorage/zora
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v13.0.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: v14.0.1](././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)
 
 Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.
 
 ## Usage
 
-### ZORA app root with optional runtime capabilities.
+### ZORA app root with optional runtime capabilities and adaptive UI.
 
-Use `ZoraProvider` once at the application root. Enable `toast` when descendants use
-`useToast()`. Enable `bottomSheet` for native BottomSheet-backed interactions such as native
-DatePicker and TimePicker; web pickers use Popover instead. Omit capabilities the app does not use.
+Enable only the runtime capabilities the app uses. `toast` installs the host consumed by
+`useToast()`. `bottomSheet` installs the native BottomSheet host; DatePicker and TimePicker use
+that host on native and automatically use Popover on web.
 
 Source: `examples/basic-app/App.tsx`
 
@@ -21,12 +21,19 @@ Source: `examples/basic-app/App.tsx`
 import {
   AppBar,
   AppShell,
+  BottomSheet,
+  Button,
+  DatePicker,
   Screen,
   ScreenSection,
+  Stack,
   Text,
+  TimePicker,
+  useToast,
   ZoraProvider,
   type ZoraTheme,
 } from '@ankhorage/zora';
+import React from 'react';
 import { GestureHandlerRootView } from 'react-native-gesture-handler';
 
 const basicTheme: ZoraTheme = {
@@ -49,7 +56,7 @@ export default function BasicApp() {
         <AppShell header={<AppBar title="Dashboard" subtitle="Welcome to ZORA" />}>
           <Screen>
             <ScreenSection>
-              <Text variant="lead">Build your app content inside the shell.</Text>
+              <UsageContent />
             </ScreenSection>
           </Screen>
         </AppShell>
@@ -57,6 +64,169 @@ export default function BasicApp() {
     </GestureHandlerRootView>
   );
 }
+
+/*** Demonstrates toast feedback and adaptive picker presentation. */
+function UsageContent() {
+  const { showToast } = useToast();
+  const [date, setDate] = React.useState<string | null>(null);
+  const [time, setTime] = React.useState<string | null>(null);
+
+  return (
+    <Stack gap="m">
+      <Text variant="lead">Runtime capabilities are opt-in at the app root.</Text>
+      <Button
+        onPress={() =>
+          showToast({
+            description: 'ToastProvider is installed by ZoraProvider.',
+            status: 'success',
+            title: 'Saved',
+          })
+        }
+      >
+        Show toast
+      </Button>
+      <DatePicker label="Date" onValueChange={setDate} value={date} />
+      <TimePicker label="Time" onValueChange={setTime} value={time} />
+    </Stack>
+  );
+}
+
+/***
+ * Direct native BottomSheet usage.
+ *
+ * Render this inside `<ZoraProvider bottomSheet>` on native. Web pickers do not need this host;
+ * their platform adapters use Popover instead.
+ *
+ * @usage
+ * @readme
+ */
+export function NativeBottomSheetExample() {
+  const [open, setOpen] = React.useState(false);
+
+  return (
+    <Stack gap="m">
+      <Button onPress={() => setOpen(true)}>Open native bottom sheet</Button>
+      <BottomSheet onDismiss={() => setOpen(false)} open={open}>
+        <Stack gap="s" p="m">
+          <Text variant="label">Bottom sheet content</Text>
+          <Button onPress={() => setOpen(false)} variant="ghost">
+            Close
+          </Button>
+        </Stack>
+      </BottomSheet>
+    </Stack>
+  );
+}
+```
+
+### Direct native BottomSheet usage.
+
+Render this inside `<ZoraProvider bottomSheet>` on native. Web pickers do not need this host;
+their platform adapters use Popover instead.
+
+Source: `examples/basic-app/App.tsx`
+
+```tsx
+import {
+  AppBar,
+  AppShell,
+  BottomSheet,
+  Button,
+  DatePicker,
+  Screen,
+  ScreenSection,
+  Stack,
+  Text,
+  TimePicker,
+  useToast,
+  ZoraProvider,
+  type ZoraTheme,
+} from '@ankhorage/zora';
+import React from 'react';
+import { GestureHandlerRootView } from 'react-native-gesture-handler';
+
+const basicTheme: ZoraTheme = {
+  id: 'basic-app',
+  name: 'Basic app',
+  appCategory: 'developer_tools',
+  primaryColor: '#0b6e99',
+  harmony: 'analogous',
+};
+
+/***
+ * ZORA app root with optional runtime capabilities and adaptive UI.
+ *
+ * Enable only the runtime capabilities the app uses. `toast` installs the host consumed by
+ * `useToast()`. `bottomSheet` installs the native BottomSheet host; DatePicker and TimePicker use
+ * that host on native and automatically use Popover on web.
+ *
+ * @usage
+ * @readme
+ */
+export default function BasicApp() {
+  return (
+    <GestureHandlerRootView style={{ flex: 1 }}>
+      <ZoraProvider
+        bottomSheet
+        initialMode="light"
+        theme={basicTheme}
+        toast={{ defaultDuration: 4000 }}
+      >
+        <AppShell header={<AppBar title="Dashboard" subtitle="Welcome to ZORA" />}>
+          <Screen>
+            <ScreenSection>
+              <UsageContent />
+            </ScreenSection>
+          </Screen>
+        </AppShell>
+      </ZoraProvider>
+    </GestureHandlerRootView>
+  );
+}
+
+/*** Demonstrates toast feedback and adaptive picker presentation. */
+function UsageContent() {
+  const { showToast } = useToast();
+  const [date, setDate] = React.useState<string | null>(null);
+  const [time, setTime] = React.useState<string | null>(null);
+
+  return (
+    <Stack gap="m">
+      <Text variant="lead">Runtime capabilities are opt-in at the app root.</Text>
+      <Button
+        onPress={() =>
+          showToast({
+            description: 'ToastProvider is installed by ZoraProvider.',
+            status: 'success',
+            title: 'Saved',
+          })
+        }
+      >
+        Show toast
+      </Button>
+      <DatePicker label="Date" onValueChange={setDate} value={date} />
+      <TimePicker label="Time" onValueChange={setTime} value={time} />
+    </Stack>
+  );
+}
+
+export function NativeBottomSheetExample() {
+  const [open, setOpen] = React.useState(false);
+
+  return (
+    <Stack gap="m">
+      <Button onPress={() => setOpen(true)}>Open native bottom sheet</Button>
+      <BottomSheet onDismiss={() => setOpen(false)} open={open}>
+        <Stack gap="s" p="m">
+          <Text variant="label">Bottom sheet content</Text>
+          <Button onPress={() => setOpen(false)} variant="ghost">
+            Close
+          </Button>
+        </Stack>
+      </BottomSheet>
+    </Stack>
+  );
+}
 ```
 
 ## Generated documentation

package/dist/features/app-bar/adapters/inbound/AppBar.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { AppBarProps } from '../../../../types/app-bar';
+/*** Renders a top app bar with title/subtitle and optional leading/trailing actions. */
+export declare const AppBar: (props: AppBarProps) => React.ReactElement | null;
+//# sourceMappingURL=AppBar.d.ts.map

package/dist/features/app-bar/adapters/inbound/AppBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppBar.d.ts","sourceRoot":"","sources":["../../../../../src/features/app-bar/adapters/inbound/AppBar.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,KAAK,EAAkC,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAS7F,wFAAwF;AACxF,eAAO,MAAM,MAAM,mDAAkC,CAAC"}

package/dist/features/app-bar/adapters/inbound/AppBar.js

@@ -0,0 +1,92 @@
+import { AppBar as SurfaceAppBar } from '@ankhorage/surface';
+import React from 'react';
+import { Inline } from '../../../../foundation';
+import { useZoraTheme } from '../../../../theme/useZoraTheme';
+import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
+import { IconButton } from '../../../button/public';
+import { Box, Stack } from '../../../layout/public';
+import { PopoverMenu } from '../../../popover-menu/public';
+import { Heading, Text } from '../../../typography/public';
+const DEFAULT_CANCEL_ICON = { name: 'close-outline' };
+const DEFAULT_OVERFLOW_ICON = { name: 'ellipsis-vertical' };
+/*** Renders a top app bar with title/subtitle and optional leading/trailing actions. */
+export const AppBar = withZoraThemeScope(AppBarInner);
+/*** Composes the opinionated ZORA AppBar over the Surface layout primitive. */
+function AppBarInner({ themeId: _themeId, mode: _mode, title, subtitle, leading, actions, overflow, appMode, children, safeAreaTop = true, divider = true, testID, interactionPolicy, }) {
+    const { theme } = useZoraTheme();
+    const resolvedMode = resolveMode(appMode);
+    const isSelectionMode = resolvedMode.type === 'selection';
+    const resolvedLeading = leading ?? resolveSelectionLeading(resolvedMode, interactionPolicy);
+    const overflowMenu = resolveOverflowMenu(overflow, interactionPolicy, testID);
+    const resolvedTrailing = resolveTrailing(actions, overflowMenu);
+    const resolvedCenter = resolveCenter({
+        children,
+        isSelectionMode,
+        resolvedMode,
+        subtitle,
+        title,
+    });
+    return (<SurfaceAppBar bg={isSelectionMode ? theme.semantics.action.primary.softBg : undefined} divider={divider} leading={resolvedLeading} safeAreaTop={safeAreaTop} testID={testID} trailing={resolvedTrailing}>
+      {resolvedCenter ? <Box style={{ minWidth: 0 }}>{resolvedCenter}</Box> : null}
+    </SurfaceAppBar>);
+}
+/*** Resolves the effective AppBar mode. */
+function resolveMode(mode) {
+    return mode ?? { type: 'default' };
+}
+/*** Formats the active selection label with its optional count. */
+function resolveSelectionLabel({ count, label }) {
+    if (count === undefined)
+        return label;
+    return `${label} (${count})`;
+}
+/*** Resolves the accessible label for the overflow menu trigger. */
+function resolveOverflowLabel(overflow) {
+    return overflow.label ?? 'More options';
+}
+/*** Resolves the accessible label for leaving selection mode. */
+function resolveCancelLabel(mode) {
+    return mode.cancelLabel ?? 'Cancel selection';
+}
+/*** Resolves the selection action shown at the leading edge. */
+function resolveSelectionLeading(mode, interactionPolicy) {
+    if (mode.type !== 'selection')
+        return undefined;
+    return (<IconButton color="neutral" icon={mode.cancelIcon ?? DEFAULT_CANCEL_ICON} interactionPolicy={interactionPolicy} label={resolveCancelLabel(mode)} onPress={mode.onCancel} size="m" variant="ghost"/>);
+}
+/*** Resolves the optional AppBar overflow action menu. */
+function resolveOverflowMenu(overflow, interactionPolicy, testID) {
+    if (overflow === undefined || overflow.actions.length === 0)
+        return null;
+    return (<PopoverMenu actions={overflow.actions} closeOnSelect={overflow.closeOnSelect} interactionPolicy={interactionPolicy} onDismiss={overflow.onDismiss} testID={testID ? `${testID}-overflow` : undefined} trigger={({ toggle }) => (<IconButton color="neutral" disabled={overflow.disabled} icon={overflow.icon ?? DEFAULT_OVERFLOW_ICON} interactionPolicy={interactionPolicy} label={resolveOverflowLabel(overflow)} onPress={toggle} size="m" variant="ghost"/>)}/>);
+}
+/*** Composes trailing actions and overflow controls. */
+function resolveTrailing(actions, overflowMenu) {
+    if (!actions && !overflowMenu)
+        return undefined;
+    return (<Inline align="center" gap="s" wrap="nowrap">
+      {actions}
+      {overflowMenu}
+    </Inline>);
+}
+/*** Resolves the center content for default and selection modes. */
+function resolveCenter({ children, isSelectionMode, resolvedMode, subtitle, title, }) {
+    if (children !== undefined)
+        return children;
+    if (isSelectionMode && resolvedMode.type === 'selection') {
+        return (<Text emphasis="default" numberOfLines={1} variant="label" weight="semiBold">
+        {resolveSelectionLabel(resolvedMode)}
+      </Text>);
+    }
+    if (title == null && subtitle == null)
+        return null;
+    return (<Stack gap="xs">
+      {title != null ? (<Heading ellipsizeMode="tail" level={3} numberOfLines={1} size="h5">
+          {title}
+        </Heading>) : null}
+      {subtitle != null ? (<Text ellipsizeMode="tail" emphasis="muted" numberOfLines={1} variant="bodySmall">
+          {subtitle}
+        </Text>) : null}
+    </Stack>);
+}
+//# sourceMappingURL=AppBar.js.map

package/dist/features/app-bar/adapters/inbound/AppBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppBar.js","sourceRoot":"","sources":["../../../../../src/features/app-bar/adapters/inbound/AppBar.tsx"],"names":[],"mappings":"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","sourcesContent":["import { AppBar as SurfaceAppBar, type ButtonIconSpec } from '@ankhorage/surface';\nimport React from 'react';\n\nimport { Inline } from '../../../../foundation';\nimport { useZoraTheme } from '../../../../theme/useZoraTheme';\nimport { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';\nimport type { AppBarMode, AppBarOverflowMenu, AppBarProps } from '../../../../types/app-bar';\nimport { IconButton } from '../../../button/public';\nimport { Box, Stack } from '../../../layout/public';\nimport { PopoverMenu } from '../../../popover-menu/public';\nimport { Heading, Text } from '../../../typography/public';\n\nconst DEFAULT_CANCEL_ICON = { name: 'close-outline' } satisfies ButtonIconSpec;\nconst DEFAULT_OVERFLOW_ICON = { name: 'ellipsis-vertical' } satisfies ButtonIconSpec;\n\n/*** Renders a top app bar with title/subtitle and optional leading/trailing actions. */\nexport const AppBar = withZoraThemeScope(AppBarInner);\n\n/*** Composes the opinionated ZORA AppBar over the Surface layout primitive. */\nfunction AppBarInner({\n  themeId: _themeId,\n  mode: _mode,\n  title,\n  subtitle,\n  leading,\n  actions,\n  overflow,\n  appMode,\n  children,\n  safeAreaTop = true,\n  divider = true,\n  testID,\n  interactionPolicy,\n}: AppBarProps) {\n  const { theme } = useZoraTheme();\n  const resolvedMode = resolveMode(appMode);\n  const isSelectionMode = resolvedMode.type === 'selection';\n  const resolvedLeading = leading ?? resolveSelectionLeading(resolvedMode, interactionPolicy);\n  const overflowMenu = resolveOverflowMenu(overflow, interactionPolicy, testID);\n  const resolvedTrailing = resolveTrailing(actions, overflowMenu);\n  const resolvedCenter = resolveCenter({\n    children,\n    isSelectionMode,\n    resolvedMode,\n    subtitle,\n    title,\n  });\n\n  return (\n    <SurfaceAppBar\n      bg={isSelectionMode ? theme.semantics.action.primary.softBg : undefined}\n      divider={divider}\n      leading={resolvedLeading}\n      safeAreaTop={safeAreaTop}\n      testID={testID}\n      trailing={resolvedTrailing}\n    >\n      {resolvedCenter ? <Box style={{ minWidth: 0 }}>{resolvedCenter}</Box> : null}\n    </SurfaceAppBar>\n  );\n}\n\n/*** Resolves the effective AppBar mode. */\nfunction resolveMode(mode: AppBarMode | undefined): AppBarMode {\n  return mode ?? { type: 'default' };\n}\n\n/*** Formats the active selection label with its optional count. */\nfunction resolveSelectionLabel({ count, label }: { count?: number; label: string }): string {\n  if (count === undefined) return label;\n  return `${label} (${count})`;\n}\n\n/*** Resolves the accessible label for the overflow menu trigger. */\nfunction resolveOverflowLabel(overflow: AppBarOverflowMenu): string {\n  return overflow.label ?? 'More options';\n}\n\n/*** Resolves the accessible label for leaving selection mode. */\nfunction resolveCancelLabel(mode: Extract<AppBarMode, { type: 'selection' }>): string {\n  return mode.cancelLabel ?? 'Cancel selection';\n}\n\n/*** Resolves the selection action shown at the leading edge. */\nfunction resolveSelectionLeading(\n  mode: AppBarMode,\n  interactionPolicy: AppBarProps['interactionPolicy'],\n): React.ReactNode | undefined {\n  if (mode.type !== 'selection') return undefined;\n\n  return (\n    <IconButton\n      color=\"neutral\"\n      icon={mode.cancelIcon ?? DEFAULT_CANCEL_ICON}\n      interactionPolicy={interactionPolicy}\n      label={resolveCancelLabel(mode)}\n      onPress={mode.onCancel}\n      size=\"m\"\n      variant=\"ghost\"\n    />\n  );\n}\n\n/*** Resolves the optional AppBar overflow action menu. */\nfunction resolveOverflowMenu(\n  overflow: AppBarOverflowMenu | undefined,\n  interactionPolicy: AppBarProps['interactionPolicy'],\n  testID: string | undefined,\n): React.ReactNode {\n  if (overflow === undefined || overflow.actions.length === 0) return null;\n\n  return (\n    <PopoverMenu\n      actions={overflow.actions}\n      closeOnSelect={overflow.closeOnSelect}\n      interactionPolicy={interactionPolicy}\n      onDismiss={overflow.onDismiss}\n      testID={testID ? `${testID}-overflow` : undefined}\n      trigger={({ toggle }) => (\n        <IconButton\n          color=\"neutral\"\n          disabled={overflow.disabled}\n          icon={overflow.icon ?? DEFAULT_OVERFLOW_ICON}\n          interactionPolicy={interactionPolicy}\n          label={resolveOverflowLabel(overflow)}\n          onPress={toggle}\n          size=\"m\"\n          variant=\"ghost\"\n        />\n      )}\n    />\n  );\n}\n\n/*** Composes trailing actions and overflow controls. */\nfunction resolveTrailing(actions: React.ReactNode, overflowMenu: React.ReactNode): React.ReactNode {\n  if (!actions && !overflowMenu) return undefined;\n  return (\n    <Inline align=\"center\" gap=\"s\" wrap=\"nowrap\">\n      {actions}\n      {overflowMenu}\n    </Inline>\n  );\n}\n\n/*** Resolves the center content for default and selection modes. */\nfunction resolveCenter({\n  children,\n  isSelectionMode,\n  resolvedMode,\n  subtitle,\n  title,\n}: {\n  children: React.ReactNode;\n  isSelectionMode: boolean;\n  resolvedMode: AppBarMode;\n  subtitle: React.ReactNode;\n  title: React.ReactNode;\n}): React.ReactNode {\n  if (children !== undefined) return children;\n  if (isSelectionMode && resolvedMode.type === 'selection') {\n    return (\n      <Text emphasis=\"default\" numberOfLines={1} variant=\"label\" weight=\"semiBold\">\n        {resolveSelectionLabel(resolvedMode)}\n      </Text>\n    );\n  }\n  if (title == null && subtitle == null) return null;\n\n  return (\n    <Stack gap=\"xs\">\n      {title != null ? (\n        <Heading ellipsizeMode=\"tail\" level={3} numberOfLines={1} size=\"h5\">\n          {title}\n        </Heading>\n      ) : null}\n      {subtitle != null ? (\n        <Text ellipsizeMode=\"tail\" emphasis=\"muted\" numberOfLines={1} variant=\"bodySmall\">\n          {subtitle}\n        </Text>\n      ) : null}\n    </Stack>\n  );\n}\n"]}

package/dist/{components/app-bar/meta.d.ts → features/app-bar/appBarMeta.d.ts}

@@ -6,4 +6,4 @@ export declare const appBarMeta: {
     readonly note: "Application chrome component; not represented as a manifest node in v1.";
     readonly props: {};
 };
-//# sourceMappingURL=meta.d.ts.map
+//# sourceMappingURL=appBarMeta.d.ts.map

package/dist/features/app-bar/appBarMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appBarMeta.d.ts","sourceRoot":"","sources":["../../../src/features/app-bar/appBarMeta.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU;;;;;;;CAOe,CAAC"}

package/dist/{components/app-bar/meta.js → features/app-bar/appBarMeta.js}

@@ -6,4 +6,4 @@ export const appBarMeta = {
     note: 'Application chrome component; not represented as a manifest node in v1.',
     props: {},
 };
-//# sourceMappingURL=meta.js.map
+//# sourceMappingURL=appBarMeta.js.map

package/dist/features/app-bar/appBarMeta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appBarMeta.js","sourceRoot":"","sources":["../../../src/features/app-bar/appBarMeta.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,WAAW;IACrB,kBAAkB,EAAE,KAAK;IACzB,eAAe,EAAE,EAAE;IACnB,IAAI,EAAE,yEAAyE;IAC/E,KAAK,EAAE,EAAE;CAC2B,CAAC","sourcesContent":["import type { ZoraComponentMeta } from '../../metadata';\n\nexport const appBarMeta = {\n  name: 'AppBar',\n  category: 'component',\n  directManifestNode: false,\n  allowedChildren: [],\n  note: 'Application chrome component; not represented as a manifest node in v1.',\n  props: {},\n} as const satisfies ZoraComponentMeta;\n"]}

package/dist/features/app-bar/public.d.ts

@@ -0,0 +1,3 @@
+export type { AppBarMode, AppBarOverflowMenu, AppBarProps } from '../../types/app-bar';
+export { AppBar } from './adapters/inbound/AppBar';
+//# sourceMappingURL=public.d.ts.map

package/dist/features/app-bar/public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/features/app-bar/public.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/features/app-bar/public.js

@@ -0,0 +1,2 @@
+export { AppBar } from './adapters/inbound/AppBar';
+//# sourceMappingURL=public.js.map

package/dist/features/app-bar/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/features/app-bar/public.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC","sourcesContent":["export type { AppBarMode, AppBarOverflowMenu, AppBarProps } from '../../types/app-bar';\nexport { AppBar } from './adapters/inbound/AppBar';\n"]}

package/dist/features/bottom-sheet/public.d.ts

@@ -1,5 +1,5 @@
 export type { BottomSheetProps } from '../../types/manifest-bottom-sheet';
 export { BottomSheet } from './adapters/inbound/BottomSheet';
-export type { BottomSheetController, BottomSheetPresentOptions, } from '@ankhorage/surface/bottom-sheet';
-export { useBottomSheet } from '@ankhorage/surface/bottom-sheet';
+export type { BottomSheetContentMode, BottomSheetController, BottomSheetPresentOptions, } from '@ankhorage/surface/bottom-sheet';
+export { BottomSheetFlatList, BottomSheetScrollView, BottomSheetSectionList, BottomSheetView, BottomSheetVirtualizedList, useBottomSheet, } from '@ankhorage/surface/bottom-sheet';
 //# sourceMappingURL=public.d.ts.map

package/dist/features/bottom-sheet/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/features/bottom-sheet/public.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,YAAY,EACV,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/features/bottom-sheet/public.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,0BAA0B,EAC1B,cAAc,GACf,MAAM,iCAAiC,CAAC"}

package/dist/features/bottom-sheet/public.js

@@ -1,3 +1,3 @@
 export { BottomSheet } from './adapters/inbound/BottomSheet';
-export { useBottomSheet } from '@ankhorage/surface/bottom-sheet';
+export { BottomSheetFlatList, BottomSheetScrollView, BottomSheetSectionList, BottomSheetView, BottomSheetVirtualizedList, useBottomSheet, } from '@ankhorage/surface/bottom-sheet';
 //# sourceMappingURL=public.js.map

package/dist/features/bottom-sheet/public.js.map

@@ -1 +1 @@
-{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/features/bottom-sheet/public.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAK7D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC","sourcesContent":["export type { BottomSheetProps } from '../../types/manifest-bottom-sheet';\nexport { BottomSheet } from './adapters/inbound/BottomSheet';\nexport type {\n  BottomSheetController,\n  BottomSheetPresentOptions,\n} from '@ankhorage/surface/bottom-sheet';\nexport { useBottomSheet } from '@ankhorage/surface/bottom-sheet';\n"]}
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/features/bottom-sheet/public.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAM7D,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,0BAA0B,EAC1B,cAAc,GACf,MAAM,iCAAiC,CAAC","sourcesContent":["export type { BottomSheetProps } from '../../types/manifest-bottom-sheet';\nexport { BottomSheet } from './adapters/inbound/BottomSheet';\nexport type {\n  BottomSheetContentMode,\n  BottomSheetController,\n  BottomSheetPresentOptions,\n} from '@ankhorage/surface/bottom-sheet';\nexport {\n  BottomSheetFlatList,\n  BottomSheetScrollView,\n  BottomSheetSectionList,\n  BottomSheetView,\n  BottomSheetVirtualizedList,\n  useBottomSheet,\n} from '@ankhorage/surface/bottom-sheet';\n"]}

package/dist/features/breadcrumbs/adapters/inbound/Breadcrumbs.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { BreadcrumbsProps } from '../../../../types/breadcrumbs';
+/*** Renders a breadcrumb trail whose final item represents the current location. */
+export declare const Breadcrumbs: (props: BreadcrumbsProps) => React.ReactElement | null;
+//# sourceMappingURL=Breadcrumbs.d.ts.map

package/dist/features/breadcrumbs/adapters/inbound/Breadcrumbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Breadcrumbs.d.ts","sourceRoot":"","sources":["../../../../../src/features/breadcrumbs/adapters/inbound/Breadcrumbs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,OAAO,KAAK,EAGV,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAKvC,oFAAoF;AACpF,eAAO,MAAM,WAAW,wDAAuC,CAAC"}

package/dist/features/breadcrumbs/adapters/inbound/Breadcrumbs.js

@@ -0,0 +1,81 @@
+import React from 'react';
+import { Inline } from '../../../../foundation';
+import { resolveIconSize } from '../../../../internal/recipes';
+import { useZoraTheme } from '../../../../theme/useZoraTheme';
+import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
+import { Button } from '../../../button/public';
+import { Icon } from '../../../icon/public';
+import { Text } from '../../../typography/public';
+/*** Renders a breadcrumb trail whose final item represents the current location. */
+export const Breadcrumbs = withZoraThemeScope(BreadcrumbsInner);
+/*** Connects serializable breadcrumb items to the component-level item press event. */
+function BreadcrumbsInner({ themeId: _themeId, mode: _mode, interactionPolicy, items, separator = '/', maxItems, compact = false, disabled = false, onItemPress, testID, }) {
+    const normalizedMaxItems = normalizeMaxItems(maxItems);
+    const renderItems = createRenderItems(items, normalizedMaxItems);
+    const currentItemId = items.at(-1)?.id;
+    if (items.length === 0)
+        return null;
+    return (<Inline align="center" gap={compact ? 'xs' : 's'} testID={testID} wrap="wrap">
+      {renderItems.map((renderItem, index) => {
+            const showSeparator = index !== renderItems.length - 1;
+            if (renderItem.type === 'ellipsis') {
+                return (<React.Fragment key="ellipsis">
+              <Text emphasis="muted" variant={compact ? 'caption' : 'bodySmall'}>
+                …
+              </Text>
+              {showSeparator ? renderSeparator(separator) : null}
+            </React.Fragment>);
+            }
+            return (<BreadcrumbItemView compact={compact} current={renderItem.item.id === currentItemId} disabled={disabled} interactionPolicy={interactionPolicy} item={renderItem.item} key={renderItem.item.id} onItemPress={onItemPress} separator={showSeparator ? separator : undefined} testID={testID}/>);
+        })}
+    </Inline>);
+}
+/*** Renders one breadcrumb item and its optional following separator. */
+function BreadcrumbItemView({ compact, current, disabled, interactionPolicy, item, onItemPress, separator, testID, }) {
+    const interactive = !current && !disabled && !item.disabled && onItemPress !== undefined;
+    return (<>
+      {interactive ? (<Button color="neutral" interactionPolicy={interactionPolicy} leadingIcon={item.icon} onPress={() => onItemPress({ id: item.id })} size={compact ? 's' : 'm'} testID={testID ? `${testID}-item-${item.id}` : undefined} variant="ghost">
+          {item.label}
+        </Button>) : (<BreadcrumbLabel compact={compact} item={item}/>)}
+      {separator === undefined ? null : renderSeparator(separator)}
+    </>);
+}
+/*** Renders one non-interactive breadcrumb label. */
+function BreadcrumbLabel({ item, compact }) {
+    const { theme } = useZoraTheme();
+    return (<Inline align="center" gap="xs" wrap="nowrap">
+      {item.icon ? (<Icon {...item.icon} color={theme.semantics.content.muted} size={resolveIconSize(compact ? 's' : 'm')}/>) : null}
+      <Text emphasis="muted" variant={compact ? 'caption' : 'bodySmall'}>
+        {item.label}
+      </Text>
+    </Inline>);
+}
+/*** Renders the configured separator with muted breadcrumb styling. */
+function renderSeparator(separator) {
+    return (<Text emphasis="muted" variant="bodySmall">
+      {separator}
+    </Text>);
+}
+/*** Normalizes an optional maximum breadcrumb item count. */
+function normalizeMaxItems(value) {
+    if (value === undefined || !Number.isFinite(value))
+        return undefined;
+    return Math.max(0, Math.trunc(value));
+}
+/*** Collapses middle breadcrumb items into one ellipsis when required. */
+function createRenderItems(items, maxItems) {
+    if (maxItems === undefined || maxItems === 0 || items.length <= maxItems || maxItems < 3) {
+        return items.map((item) => ({ item, type: 'item' }));
+    }
+    const firstItem = items.at(0);
+    if (firstItem === undefined)
+        return [];
+    const trailingCount = maxItems - 2;
+    const trailingItems = items.slice(items.length - trailingCount);
+    return [
+        { item: firstItem, type: 'item' },
+        { type: 'ellipsis' },
+        ...trailingItems.map((item) => ({ item, type: 'item' })),
+    ];
+}
+//# sourceMappingURL=Breadcrumbs.js.map

package/dist/features/breadcrumbs/adapters/inbound/Breadcrumbs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Breadcrumbs.js","sourceRoot":"","sources":["../../../../../src/features/breadcrumbs/adapters/inbound/Breadcrumbs.tsx"],"names":[],"mappings":"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","sourcesContent":["import React from 'react';\n\nimport { Inline } from '../../../../foundation';\nimport { resolveIconSize } from '../../../../internal/recipes';\nimport { useZoraTheme } from '../../../../theme/useZoraTheme';\nimport { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';\nimport type {\n  BreadcrumbItem,\n  BreadcrumbPressEvent,\n  BreadcrumbsProps,\n} from '../../../../types/breadcrumbs';\nimport { Button } from '../../../button/public';\nimport { Icon } from '../../../icon/public';\nimport { Text } from '../../../typography/public';\n\n/*** Renders a breadcrumb trail whose final item represents the current location. */\nexport const Breadcrumbs = withZoraThemeScope(BreadcrumbsInner);\n\ntype BreadcrumbRenderItem =\n  | {\n      item: BreadcrumbItem;\n      type: 'item';\n    }\n  | {\n      type: 'ellipsis';\n    };\n\n/*** Connects serializable breadcrumb items to the component-level item press event. */\nfunction BreadcrumbsInner({\n  themeId: _themeId,\n  mode: _mode,\n  interactionPolicy,\n  items,\n  separator = '/',\n  maxItems,\n  compact = false,\n  disabled = false,\n  onItemPress,\n  testID,\n}: BreadcrumbsProps) {\n  const normalizedMaxItems = normalizeMaxItems(maxItems);\n  const renderItems = createRenderItems(items, normalizedMaxItems);\n  const currentItemId = items.at(-1)?.id;\n\n  if (items.length === 0) return null;\n\n  return (\n    <Inline align=\"center\" gap={compact ? 'xs' : 's'} testID={testID} wrap=\"wrap\">\n      {renderItems.map((renderItem, index) => {\n        const showSeparator = index !== renderItems.length - 1;\n\n        if (renderItem.type === 'ellipsis') {\n          return (\n            <React.Fragment key=\"ellipsis\">\n              <Text emphasis=\"muted\" variant={compact ? 'caption' : 'bodySmall'}>\n                …\n              </Text>\n              {showSeparator ? renderSeparator(separator) : null}\n            </React.Fragment>\n          );\n        }\n\n        return (\n          <BreadcrumbItemView\n            compact={compact}\n            current={renderItem.item.id === currentItemId}\n            disabled={disabled}\n            interactionPolicy={interactionPolicy}\n            item={renderItem.item}\n            key={renderItem.item.id}\n            onItemPress={onItemPress}\n            separator={showSeparator ? separator : undefined}\n            testID={testID}\n          />\n        );\n      })}\n    </Inline>\n  );\n}\n\n/*** Renders one breadcrumb item and its optional following separator. */\nfunction BreadcrumbItemView({\n  compact,\n  current,\n  disabled,\n  interactionPolicy,\n  item,\n  onItemPress,\n  separator,\n  testID,\n}: {\n  compact: boolean;\n  current: boolean;\n  disabled: boolean;\n  interactionPolicy: BreadcrumbsProps['interactionPolicy'];\n  item: BreadcrumbItem;\n  onItemPress: ((event: BreadcrumbPressEvent) => void) | undefined;\n  separator: string | undefined;\n  testID: string | undefined;\n}) {\n  const interactive = !current && !disabled && !item.disabled && onItemPress !== undefined;\n\n  return (\n    <>\n      {interactive ? (\n        <Button\n          color=\"neutral\"\n          interactionPolicy={interactionPolicy}\n          leadingIcon={item.icon}\n          onPress={() => onItemPress({ id: item.id })}\n          size={compact ? 's' : 'm'}\n          testID={testID ? `${testID}-item-${item.id}` : undefined}\n          variant=\"ghost\"\n        >\n          {item.label}\n        </Button>\n      ) : (\n        <BreadcrumbLabel compact={compact} item={item} />\n      )}\n      {separator === undefined ? null : renderSeparator(separator)}\n    </>\n  );\n}\n\n/*** Renders one non-interactive breadcrumb label. */\nfunction BreadcrumbLabel({ item, compact }: { item: BreadcrumbItem; compact: boolean }) {\n  const { theme } = useZoraTheme();\n\n  return (\n    <Inline align=\"center\" gap=\"xs\" wrap=\"nowrap\">\n      {item.icon ? (\n        <Icon\n          {...item.icon}\n          color={theme.semantics.content.muted}\n          size={resolveIconSize(compact ? 's' : 'm')}\n        />\n      ) : null}\n      <Text emphasis=\"muted\" variant={compact ? 'caption' : 'bodySmall'}>\n        {item.label}\n      </Text>\n    </Inline>\n  );\n}\n\n/*** Renders the configured separator with muted breadcrumb styling. */\nfunction renderSeparator(separator: string): React.ReactNode {\n  return (\n    <Text emphasis=\"muted\" variant=\"bodySmall\">\n      {separator}\n    </Text>\n  );\n}\n\n/*** Normalizes an optional maximum breadcrumb item count. */\nfunction normalizeMaxItems(value: number | undefined): number | undefined {\n  if (value === undefined || !Number.isFinite(value)) return undefined;\n  return Math.max(0, Math.trunc(value));\n}\n\n/*** Collapses middle breadcrumb items into one ellipsis when required. */\nfunction createRenderItems(\n  items: readonly BreadcrumbItem[],\n  maxItems: number | undefined,\n): readonly BreadcrumbRenderItem[] {\n  if (maxItems === undefined || maxItems === 0 || items.length <= maxItems || maxItems < 3) {\n    return items.map((item) => ({ item, type: 'item' }));\n  }\n\n  const firstItem = items.at(0);\n  if (firstItem === undefined) return [];\n\n  const trailingCount = maxItems - 2;\n  const trailingItems = items.slice(items.length - trailingCount);\n  return [\n    { item: firstItem, type: 'item' },\n    { type: 'ellipsis' },\n    ...trailingItems.map((item) => ({ item, type: 'item' }) satisfies BreadcrumbRenderItem),\n  ];\n}\n"]}