@ankhorage/zora 19.0.0 → 20.0.0

package/src/{corePluginMetadata.ts → features/plugin/ZORA_CORE_PLUGIN_METADATA.ts}

@@ -1,9 +1,9 @@
 import type { UiComponentMetaRegistry } from '@ankhorage/contracts';
 
-import { ZORA_BINDABLE_COMPONENT_META } from './metadata/bindableComponentMeta';
-import { ZORA_COMPONENT_META } from './metadata/componentMeta';
-import type { ZoraComponentMetaRegistry } from './metadata/types';
-import type { ZoraPluginMetadata } from './pluginComposition';
+import type { ZoraComponentMetaRegistry } from '../../types/authoring';
+import type { ZoraPluginMetadata } from '../../types/plugin';
+import { ZORA_BINDABLE_COMPONENT_META } from '../authoring/bindableComponentMeta';
+import { ZORA_COMPONENT_META } from '../authoring/componentMeta';
 
 const CORE_EXTENSION_HOSTS = [
   'Card',

package/src/{pluginComposition.ts → features/plugin/application/use-cases/composeZoraPluginMetadata.ts}

@@ -1,66 +1,11 @@
-import type { UiComponentMetaRegistry, UiComponentPackageManifest } from '@ankhorage/contracts';
-
-import type { ZoraComponentMeta, ZoraComponentMetaRegistry } from './metadata/types';
-import type { ZoraComponentRegistry } from './registry';
-
-export type ZoraPluginCompositionErrorCode =
-  | 'duplicate-component'
-  | 'duplicate-package'
-  | 'invalid-component-meta'
-  | 'invalid-interaction-policy-component'
-  | 'invalid-placement-child'
-  | 'invalid-placement-parent'
-  | 'missing-component-meta'
-  | 'missing-runtime-component';
-
-export interface ZoraPluginPlacement {
-  readonly child: string;
-  readonly parents: readonly string[];
-}
-
-export interface ZoraPluginMetadata {
-  readonly packageName: string;
-  readonly displayName?: string;
-  readonly componentMeta: ZoraComponentMetaRegistry;
-  readonly extensionHosts?: readonly string[];
-  readonly placements?: readonly ZoraPluginPlacement[];
-  readonly interactionPolicySupportedComponents?: readonly string[];
-}
-
-export interface ZoraPluginDescriptor extends ZoraPluginMetadata {
-  readonly componentRegistry: ZoraComponentRegistry;
-}
-
-export interface ComposedZoraPluginMetadataCatalog {
-  readonly componentMeta: ZoraComponentMetaRegistry;
-  readonly bindableComponentMeta: UiComponentMetaRegistry;
-  readonly packageManifests: readonly UiComponentPackageManifest[];
-  readonly interactionPolicySupportedComponents: Readonly<Record<string, true>>;
-}
-
-export interface ComposedZoraPluginCatalog extends ComposedZoraPluginMetadataCatalog {
-  readonly componentRegistry: ZoraComponentRegistry;
-}
-
-/*** Report one deterministic plugin composition contract violation. */
-export class ZoraPluginCompositionError extends Error {
-  readonly code: ZoraPluginCompositionErrorCode;
-  readonly packageName: string;
-  readonly componentName?: string;
-
-  constructor(args: {
-    readonly code: ZoraPluginCompositionErrorCode;
-    readonly packageName: string;
-    readonly message: string;
-    readonly componentName?: string;
-  }) {
-    super(args.message);
-    this.name = 'ZoraPluginCompositionError';
-    this.code = args.code;
-    this.packageName = args.packageName;
-    this.componentName = args.componentName;
-  }
-}
+import type { ZoraComponentMeta } from '../../../../types/authoring';
+import type {
+  ComposedZoraPluginMetadataCatalog,
+  ZoraPluginCompositionErrorCode,
+  ZoraPluginMetadata,
+  ZoraPluginPlacement,
+} from '../../../../types/plugin';
+import { ZoraPluginCompositionError } from '../../domain/ZoraPluginCompositionError';
 
 /*** Compose a selected ZORA metadata set for authoring tools that must not load React Native runtime modules. */
 export function composeZoraPluginMetadata(
@@ -95,10 +40,10 @@ export function composeZoraPluginMetadata(
   return {
     componentMeta: Object.fromEntries(componentMeta),
     bindableComponentMeta: Object.fromEntries(componentMeta),
-    packageManifests: descriptors.map(({ packageName, displayName, componentMeta }) => ({
+    packageManifests: descriptors.map(({ packageName, displayName, componentMeta: meta }) => ({
       packageName,
       ...(displayName === undefined ? {} : { displayName }),
-      components: componentMeta,
+      components: meta,
     })),
     interactionPolicySupportedComponents: Object.fromEntries(
       [...interactionPolicySupportedComponents]
@@ -108,24 +53,6 @@ export function composeZoraPluginMetadata(
   };
 }
 
-/*** Compose a selected ZORA core/plugin descriptor set into one validated authoring/runtime catalog. */
-export function composeZoraPlugins(
-  plugins: readonly ZoraPluginDescriptor[],
-): ComposedZoraPluginCatalog {
-  const descriptors = sortPlugins(plugins);
-  const componentRegistry = new Map<string, ZoraComponentRegistry[string]>();
-
-  for (const descriptor of descriptors) {
-    validateRuntime(descriptor);
-    for (const [componentName, component] of sortedEntries(descriptor.componentRegistry)) {
-      componentRegistry.set(componentName, component);
-    }
-  }
-  const metadataCatalog = composeZoraPluginMetadata(descriptors);
-
-  return { ...metadataCatalog, componentRegistry: Object.fromEntries(componentRegistry) };
-}
-
 function validateUniquePackage(descriptor: ZoraPluginMetadata, packages: Set<string>): void {
   if (packages.has(descriptor.packageName)) {
     throw compositionError(
@@ -150,41 +77,6 @@ function validateMetadata(descriptor: ZoraPluginMetadata): void {
   }
 }
 
-function validateRuntime(descriptor: ZoraPluginDescriptor): void {
-  const componentMetaNames = new Set(Object.keys(descriptor.componentMeta));
-  const runtimeComponentNames = new Set(Object.keys(descriptor.componentRegistry));
-  for (const componentName of sortedKeys(descriptor.componentRegistry)) {
-    if (!componentMetaNames.has(componentName)) {
-      throw compositionError(
-        'missing-component-meta',
-        descriptor.packageName,
-        `ZORA plugin '${descriptor.packageName}' registers runtime component '${componentName}' without component metadata.`,
-        componentName,
-      );
-    }
-  }
-  for (const [componentName, meta] of sortedEntries(descriptor.componentMeta)) {
-    if (meta.directManifestNode && !runtimeComponentNames.has(componentName)) {
-      throw compositionError(
-        'missing-runtime-component',
-        descriptor.packageName,
-        `ZORA plugin '${descriptor.packageName}' exposes direct manifest node '${componentName}' without a runtime component.`,
-        componentName,
-      );
-    }
-  }
-  for (const componentName of descriptor.interactionPolicySupportedComponents ?? []) {
-    if (!runtimeComponentNames.has(componentName)) {
-      throw compositionError(
-        'invalid-interaction-policy-component',
-        descriptor.packageName,
-        `ZORA plugin '${descriptor.packageName}' declares interaction-policy support for unregistered component '${componentName}'.`,
-        componentName,
-      );
-    }
-  }
-}
-
 function claimComponent(
   componentName: string,
   packageName: string,
@@ -256,10 +148,6 @@ function appendUnique(values: readonly string[], value: string): readonly string
   return values.includes(value) ? values : [...values, value];
 }
 
-function sortedKeys(value: Readonly<Record<string, unknown>>): string[] {
-  return Object.keys(value).sort();
-}
-
 function sortedEntries<T>(value: Readonly<Record<string, T>>): [string, T][] {
   return Object.entries(value).sort(([left], [right]) => left.localeCompare(right));
 }

package/src/features/plugin/application/use-cases/composeZoraPlugins.ts

@@ -0,0 +1,76 @@
+import type {
+  ComposedZoraPluginCatalog,
+  ZoraPluginCompositionErrorCode,
+  ZoraPluginDescriptor,
+} from '../../../../types/plugin';
+import type { ZoraComponentRegistry } from '../../../../types/registry';
+import { ZoraPluginCompositionError } from '../../domain/ZoraPluginCompositionError';
+import { composeZoraPluginMetadata } from './composeZoraPluginMetadata';
+
+/*** Compose a selected ZORA core/plugin descriptor set into one validated authoring/runtime catalog. */
+export function composeZoraPlugins(
+  plugins: readonly ZoraPluginDescriptor[],
+): ComposedZoraPluginCatalog {
+  const descriptors = [...plugins].sort((left, right) =>
+    left.packageName.localeCompare(right.packageName),
+  );
+  const componentRegistry = new Map<string, ZoraComponentRegistry[string]>();
+
+  for (const descriptor of descriptors) {
+    validateRuntime(descriptor);
+    for (const [componentName, component] of sortedEntries(descriptor.componentRegistry)) {
+      componentRegistry.set(componentName, component);
+    }
+  }
+  const metadataCatalog = composeZoraPluginMetadata(descriptors);
+
+  return { ...metadataCatalog, componentRegistry: Object.fromEntries(componentRegistry) };
+}
+
+function validateRuntime(descriptor: ZoraPluginDescriptor): void {
+  const componentMetaNames = new Set(Object.keys(descriptor.componentMeta));
+  const runtimeComponentNames = new Set(Object.keys(descriptor.componentRegistry));
+  for (const componentName of Object.keys(descriptor.componentRegistry).sort()) {
+    if (!componentMetaNames.has(componentName)) {
+      throw compositionError(
+        'missing-component-meta',
+        descriptor.packageName,
+        `ZORA plugin '${descriptor.packageName}' registers runtime component '${componentName}' without component metadata.`,
+        componentName,
+      );
+    }
+  }
+  for (const [componentName, meta] of sortedEntries(descriptor.componentMeta)) {
+    if (meta.directManifestNode && !runtimeComponentNames.has(componentName)) {
+      throw compositionError(
+        'missing-runtime-component',
+        descriptor.packageName,
+        `ZORA plugin '${descriptor.packageName}' exposes direct manifest node '${componentName}' without a runtime component.`,
+        componentName,
+      );
+    }
+  }
+  for (const componentName of descriptor.interactionPolicySupportedComponents ?? []) {
+    if (!runtimeComponentNames.has(componentName)) {
+      throw compositionError(
+        'invalid-interaction-policy-component',
+        descriptor.packageName,
+        `ZORA plugin '${descriptor.packageName}' declares interaction-policy support for unregistered component '${componentName}'.`,
+        componentName,
+      );
+    }
+  }
+}
+
+function sortedEntries<T>(value: Readonly<Record<string, T>>): [string, T][] {
+  return Object.entries(value).sort(([left], [right]) => left.localeCompare(right));
+}
+
+function compositionError(
+  code: ZoraPluginCompositionErrorCode,
+  packageName: string,
+  message: string,
+  componentName?: string,
+): ZoraPluginCompositionError {
+  return new ZoraPluginCompositionError({ code, packageName, message, componentName });
+}

package/src/features/plugin/domain/ZoraPluginCompositionError.ts

@@ -0,0 +1,21 @@
+import type { ZoraPluginCompositionErrorCode } from '../../../types/plugin';
+
+/*** Report one deterministic plugin composition contract violation. */
+export class ZoraPluginCompositionError extends Error {
+  readonly code: ZoraPluginCompositionErrorCode;
+  readonly packageName: string;
+  readonly componentName?: string;
+
+  constructor(args: {
+    readonly code: ZoraPluginCompositionErrorCode;
+    readonly packageName: string;
+    readonly message: string;
+    readonly componentName?: string;
+  }) {
+    super(args.message);
+    this.name = 'ZoraPluginCompositionError';
+    this.code = args.code;
+    this.packageName = args.packageName;
+    this.componentName = args.componentName;
+  }
+}

package/src/{pluginComposition.test.ts → features/plugin/pluginComposition.test.ts}

@@ -1,11 +1,9 @@
 import { describe, expect, test } from 'bun:test';
 
-import type { ZoraComponentMeta } from './metadata';
-import {
-  composeZoraPlugins,
-  ZoraPluginCompositionError,
-  type ZoraPluginDescriptor,
-} from './pluginComposition';
+import type { ZoraComponentMeta } from '../../types/authoring';
+import type { ZoraPluginDescriptor } from '../../types/plugin';
+import { composeZoraPlugins } from './application/use-cases/composeZoraPlugins';
+import { ZoraPluginCompositionError } from './domain/ZoraPluginCompositionError';
 
 const pluginLeafMeta: ZoraComponentMeta = {
   name: 'PluginLeaf',

package/src/features/plugin/public.ts

@@ -0,0 +1,3 @@
+export { composeZoraPluginMetadata } from './application/use-cases/composeZoraPluginMetadata';
+export { ZoraPluginCompositionError } from './domain/ZoraPluginCompositionError';
+export { ZORA_CORE_PLUGIN_METADATA } from './ZORA_CORE_PLUGIN_METADATA';

package/src/features/plugin/runtime.ts

@@ -0,0 +1,2 @@
+export { composeZoraPlugins } from './application/use-cases/composeZoraPlugins';
+export { ZORA_CORE_PLUGIN } from './ZORA_CORE_PLUGIN';

package/src/features/popover-menu/adapters/inbound/PopoverMenu.tsx

@@ -4,12 +4,12 @@ import {
 } from '@ankhorage/surface';
 import React from 'react';
 
-import { resolveIconSize } from '../../../../internal/recipes';
-import { useZoraTheme } from '../../../../theme/useZoraTheme';
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
 import type { PopoverMenuAction, PopoverMenuProps } from '../../../../types/popover-menu';
 import { Icon } from '../../../icon/public';
+import { resolveIconSize } from '../../../icon/utils/resolveIconSize';
 import { View } from '../../../layout/public';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { useZoraTheme } from '../../../theme/composition/useZoraTheme';
 
 /*** Presents a ZORA-styled action list through the Surface PopoverMenu capability. */
 export const PopoverMenu = withZoraThemeScope(PopoverMenuInner);

package/src/features/popover-menu/popoverMenuMeta.ts

@@ -1,4 +1,4 @@
-import type { ZoraComponentMeta } from '../../metadata';
+import type { ZoraComponentMeta } from '../authoring';
 
 export const popoverMenuMeta = {
   name: 'PopoverMenu',

package/src/features/progress/adapters/inbound/Progress.tsx

@@ -1,9 +1,9 @@
 import React from 'react';
 
-import { useZoraTheme } from '../../../../theme/useZoraTheme';
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
 import { type ProgressProps, resolveProgressRole } from '../../../../types/progress';
 import { View } from '../../../layout/public';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { useZoraTheme } from '../../../theme/composition/useZoraTheme';
 import { resolveProgressFraction } from '../../utils/resolveProgressFraction';
 
 function resolveProgressHeight(size: NonNullable<ProgressProps['size']>): number {

package/src/features/progress/adapters/inbound/ProgressRing.tsx

@@ -1,10 +1,10 @@
 import React from 'react';
 import { StyleSheet, View as ReactNativeView } from 'react-native';
 
-import { useZoraTheme } from '../../../../theme/useZoraTheme';
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
 import { type ProgressRingProps, resolveProgressRole } from '../../../../types/progress';
 import { View } from '../../../layout/public';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { useZoraTheme } from '../../../theme/composition/useZoraTheme';
 import { Text } from '../../../typography/public';
 import { resolveProgressFraction } from '../../utils/resolveProgressFraction';
 import { resolveProgressRingGeometry } from '../../utils/resolveProgressRingGeometry';

package/src/features/progress/progressMeta.ts

@@ -1,5 +1,5 @@
-import { ZORA_COLORS } from '../../internal/colorModel';
-import type { ZoraComponentMeta } from '../../metadata';
+import type { ZoraComponentMeta } from '../authoring';
+import { ZORA_COLORS } from '../theme/colorModel';
 
 export const progressMeta = {
   name: 'Progress',

package/src/features/rating/adapters/inbound/Rating.tsx

@@ -1,12 +1,12 @@
 import type { RoleSemantics, SurfaceTheme } from '@ankhorage/surface';
 
-import type { ZoraColor } from '../../../../internal/recipes';
-import { resolveIconSize } from '../../../../internal/recipes';
-import { useZoraTheme } from '../../../../theme/useZoraTheme';
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
 import type { RatingProps } from '../../../../types/rating';
+import type { ZoraColor } from '../../../../types/theme';
 import { Icon } from '../../../icon/public';
+import { resolveIconSize } from '../../../icon/utils/resolveIconSize';
 import { View } from '../../../layout/public';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { useZoraTheme } from '../../../theme/composition/useZoraTheme';
 import { resolveRatingSegments } from '../../utils/resolveRatingSegments';
 
 /*** Displays a read-only star rating with optional half steps. */

package/src/features/rating/ratingMeta.ts

@@ -1,4 +1,4 @@
-import type { ZoraComponentMeta } from '../../metadata/types';
+import type { ZoraComponentMeta } from '../../types/authoring';
 
 export const ratingMeta = {
   name: 'Rating',

package/src/features/reader/adapters/inbound/ReaderSurface.tsx

@@ -1,13 +1,13 @@
 import React from 'react';
 
-import { useZoraTheme } from '../../../../theme/useZoraTheme';
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
 import type { ReaderStatus, ReaderSurfaceProps } from '../../../../types/reader';
 import { AppBar } from '../../../app-bar/public';
 import { IconButton } from '../../../button/public';
 import { View } from '../../../layout/public';
 import { Progress } from '../../../progress/public';
 import { Surface } from '../../../surface/public';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { useZoraTheme } from '../../../theme/composition/useZoraTheme';
 import { Text } from '../../../typography/public';
 import { resolveReaderProgress } from '../../utils/resolveReaderProgress';
 

package/src/features/reader/meta.ts

@@ -1,5 +1,5 @@
-import type { ZoraComponentMeta } from '../../metadata';
-import { CONTAINER_ALLOWED_CHILDREN } from '../../metadata/allowedChildren';
+import type { ZoraComponentMeta } from '../authoring';
+import { CONTAINER_ALLOWED_CHILDREN } from '../authoring/allowedChildren';
 
 const EMPTY_EVENT_FIELDS = [] as const;
 
@@ -10,7 +10,7 @@ export const readerSurfaceMeta = {
     'Adapter-neutral EPUB and PDF reader shell with controlled chrome, progress, and navigation events.',
   directManifestNode: true,
   requirements: {
-    capabilities: [{ capability: 'ebookReader' }],
+    capabilities: { ebookReader: true },
   },
   allowedChildren: [],
   blueprint: {

package/src/features/registry/ZORA_COMPONENT_REGISTRY.ts

@@ -0,0 +1,186 @@
+import type { InteractionPolicyProps } from '@ankhorage/surface';
+import type React from 'react';
+
+import type { ZoraComponentRegistry } from '../../types/registry';
+import { Accordion, AccordionItem } from '../accordion/public';
+import { ActivityIndicator } from '../activity-indicator/public';
+import { AppBar } from '../app-bar/public';
+import {
+  ForgotPasswordForm,
+  OAuthProviderButton,
+  OAuthProviderList,
+  OtpForm,
+  SignInForm,
+  SignUpForm,
+} from '../auth/public';
+import { Avatar, AvatarGroup } from '../avatar/public';
+import { Badge } from '../badge/public';
+import { BottomSheet } from '../bottom-sheet/public';
+import { Breadcrumbs } from '../breadcrumbs/public';
+import { Button, ButtonGroup, IconButton } from '../button/public';
+import { Card, MediaCard, MetricCard, PostCard, ProductCard } from '../card/public';
+import { ChatListItem, MessageBubble } from '../chat/public';
+import { Chip, ChipGroup } from '../chip/public';
+import { CollectionEditor } from '../collection-editor/public';
+import { ContentRail } from '../content-rail/public';
+import { DataTable } from '../data-table/public';
+import { DatePicker } from '../date-picker/public';
+import { Dialog } from '../dialog/public';
+import { EmptyState } from '../empty-state/public';
+import { Checkbox, CheckboxGroup } from '../form/checkbox/public';
+import { Field, Form, FormActions, FormError } from '../form/public';
+import { Radio, RadioGroup } from '../form/radio/public';
+import { SearchInput } from '../form/search-input/public';
+import { Select } from '../form/select/public';
+import { Switch } from '../form/switch/public';
+import { TextInput } from '../form/text-input/public';
+import { Gradient } from '../gradient/public';
+import { Hero } from '../hero/public';
+import { Icon } from '../icon/public';
+import { Image } from '../image/public';
+import { KeyboardAvoidingView } from '../keyboard-avoiding-view/public';
+import { AppShell, Divider, Grid, Screen, ScrollView, View } from '../layout/public';
+import { FlatList, List, ListItem, ListSection, SectionList } from '../list/public';
+import { MissingElement } from '../missing-element/public';
+import { Pagination } from '../pagination/public';
+import { PaletteItem } from '../palette-item/public';
+import { PopoverMenu } from '../popover-menu/public';
+import { Progress, ProgressRing } from '../progress/public';
+import { Rating } from '../rating/public';
+import { ReaderSurface } from '../reader/public';
+import { BarcodeScannerView, CameraPermissionView, ScanOverlay } from '../scanner/public';
+import { ScreenSection, SectionHeader } from '../section/public';
+import { SelectableItem } from '../selection/public';
+import { Skeleton, SkeletonCard, SkeletonList, SkeletonText } from '../skeleton/public';
+import { Surface } from '../surface/public';
+import { Tab, TabList, TabPanel, Tabs } from '../tabs/public';
+import { ThemeModeToggle } from '../theme/adapters/inbound/ThemeModeToggle';
+import { TimePicker } from '../time-picker/public';
+import { Timeline } from '../timeline/public';
+import { Toast } from '../toast/public';
+import { Toolbar } from '../toolbar/public';
+import { TreeItem, TreeView } from '../tree-view/public';
+import { Heading, Text } from '../typography/public';
+import { Uploader } from '../uploader/public';
+
+type ComponentPropsFor<K extends keyof typeof _ZORA_COMPONENT_REGISTRY> = React.ComponentProps<
+  (typeof _ZORA_COMPONENT_REGISTRY)[K]
+>;
+
+type AcceptsSurfaceInteractionPolicyProps<P> = 'interactionPolicy' extends keyof P
+  ? InteractionPolicyProps extends Pick<P, 'interactionPolicy'>
+    ? Pick<P, 'interactionPolicy'> extends InteractionPolicyProps
+      ? true
+      : false
+    : false
+  : false;
+
+type RegistryInteractionPolicyContract = {
+  [K in keyof typeof _ZORA_COMPONENT_REGISTRY]: AcceptsSurfaceInteractionPolicyProps<
+    ComponentPropsFor<K>
+  >;
+};
+
+type _AssertTrue<T extends true> = T;
+type _RegistryInteractionPolicyCheck = _AssertTrue<
+  RegistryInteractionPolicyContract[keyof typeof _ZORA_COMPONENT_REGISTRY]
+>;
+
+const _ZORA_COMPONENT_REGISTRY = {
+  Accordion,
+  AccordionItem,
+  ActivityIndicator,
+  AppBar,
+  Avatar,
+  AvatarGroup,
+  Badge,
+  Breadcrumbs,
+  Button,
+  ButtonGroup,
+  Card,
+  Checkbox,
+  CheckboxGroup,
+  Chip,
+  ChipGroup,
+  DataTable,
+  DatePicker,
+  Dialog,
+  Form,
+  FormActions,
+  FormError,
+  Field,
+  Gradient,
+  Heading,
+  Icon,
+  IconButton,
+  Image,
+  KeyboardAvoidingView,
+  TextInput,
+  MediaCard,
+  MetricCard,
+  Pagination,
+  PopoverMenu,
+  Progress,
+  ProgressRing,
+  Radio,
+  RadioGroup,
+  Rating,
+  SearchInput,
+  Select,
+  Switch,
+  Skeleton,
+  SkeletonCard,
+  SkeletonList,
+  SkeletonText,
+  Tab,
+  TabList,
+  TabPanel,
+  Tabs,
+  Text,
+  TimePicker,
+  Toast,
+  Toolbar,
+  Uploader,
+  BottomSheet,
+  FlatList,
+  SectionList,
+  ScrollView,
+  View,
+  ThemeModeToggle,
+  Divider,
+  Grid,
+  Surface,
+  AppShell,
+  Screen,
+  ScreenSection,
+  ForgotPasswordForm,
+  OAuthProviderButton,
+  OAuthProviderList,
+  OtpForm,
+  SignInForm,
+  SignUpForm,
+  ChatListItem,
+  CollectionEditor,
+  ContentRail,
+  EmptyState,
+  Hero,
+  List,
+  ListItem,
+  ListSection,
+  MessageBubble,
+  MissingElement,
+  PostCard,
+  ProductCard,
+  ReaderSurface,
+  BarcodeScannerView,
+  CameraPermissionView,
+  ScanOverlay,
+  SectionHeader,
+  SelectableItem,
+  PaletteItem,
+  Timeline,
+  TreeItem,
+  TreeView,
+} as const satisfies ZoraComponentRegistry;
+
+export const ZORA_COMPONENT_REGISTRY: ZoraComponentRegistry = _ZORA_COMPONENT_REGISTRY;

package/src/features/registry/public.ts

@@ -0,0 +1 @@
+export { ZORA_COMPONENT_REGISTRY } from './ZORA_COMPONENT_REGISTRY';

package/src/{registry.test.ts → features/registry/registry.test.ts}

@@ -1,11 +1,12 @@
 import { describe, expect, test } from 'bun:test';
 
-import type { ZoraComponentRegistry } from '.';
+import type { ZoraComponentRegistry } from '../../types/registry';
 
 const NON_RUNTIME_COMPONENT_EXPORTS = new Set([
   'GradientRendererProvider',
   'SelectionProvider',
   'ToastProvider',
+  'ZoraPluginCompositionError',
 ]);
 const RUNTIME_THEME_COMPONENT_EXPORTS = ['ThemeModeToggle'] as const;
 const REGISTRY_SNAPSHOT_PREFIX = 'ZORA_REGISTRY_SNAPSHOT:';
@@ -75,8 +76,10 @@ describe('ZORA_COMPONENT_REGISTRY', () => {
     expect(registry).toEqual({});
     expect(registryEntries).toContain('Screen');
     expect(registryEntries).toContain('View');
-    expect(source).toContain("export type { ZoraComponentRegistry } from './registry';");
-    expect(source).toContain("export { ZORA_COMPONENT_REGISTRY } from './registry';");
+    expect(source).toContain("export type { ZoraComponentRegistry } from './types/registry';");
+    expect(source).toContain(
+      "export { ZORA_COMPONENT_REGISTRY } from './features/registry/public';",
+    );
   });
 
   test('covers every public concrete ZORA component export supported for runtime rendering', async () => {

package/src/features/scanner/adapters/inbound/BarcodeScannerView.tsx

@@ -1,11 +1,11 @@
 import React from 'react';
 import { StyleSheet } from 'react-native';
 
-import { useZoraTheme } from '../../../../theme/useZoraTheme';
-import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
 import type { BarcodeScannerViewProps } from '../../../../types/scanner';
 import { Card } from '../../../card/public';
 import { View } from '../../../layout/public';
+import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { useZoraTheme } from '../../../theme/composition/useZoraTheme';
 import { Text } from '../../../typography/public';
 import { CameraPermissionView } from './CameraPermissionView';
 import { ScanOverlay } from './ScanOverlay';