@ankhorage/zora 25.8.13 → 25.8.15

package/src/features/registry/ZORA_BASE_COMPONENT_REGISTRY.ts

@@ -0,0 +1,236 @@
+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 { AppHeader } from '../app-header/public';
+import {
+  AuthScreen,
+  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 { ChessBoard, OpeningBook } from '../chess/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 { Explorer, FileExplorer, MediaExplorer } from '../explorer/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 {
+  Game,
+  GameEntity,
+  GameField,
+  GameInputZone,
+  GameMeasurementProbe,
+  GameOverlay,
+} from '../game/public';
+import { Gradient } from '../gradient/public';
+import { GridInteractions } from '../grid-interactions/public';
+import { GridLineOverlay, GridRuler } from '../grid-rulers/public';
+import { GridView, TileGrid } from '../grid-view/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 { MatrixGrid } from '../matrix-grid/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 { 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 { SpatialGrid } from '../spatial-grid/public';
+import { Surface } from '../surface/public';
+import {
+  CardBack,
+  CardHand,
+  PlayingCard,
+  PokerTrainingTable,
+  TabletopTable,
+} from '../tabletop/public';
+import { Tab, TabList, TabPanel, Tabs } from '../tabs/public';
+import { ThemeModeToggle } from '../theme/adapters/inbound/ThemeModeToggle';
+import { TimeGrid } from '../time-grid/public';
+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_BASE_COMPONENT_REGISTRY> = React.ComponentProps<
+  (typeof _ZORA_BASE_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_BASE_COMPONENT_REGISTRY]: AcceptsSurfaceInteractionPolicyProps<
+    ComponentPropsFor<K>
+  >;
+};
+
+type _AssertTrue<T extends true> = T;
+type _RegistryInteractionPolicyCheck = _AssertTrue<
+  RegistryInteractionPolicyContract[keyof typeof _ZORA_BASE_COMPONENT_REGISTRY]
+>;
+
+const _ZORA_BASE_COMPONENT_REGISTRY = {
+  Accordion,
+  AccordionItem,
+  ActivityIndicator,
+  AppBar,
+  AppHeader,
+  Avatar,
+  AvatarGroup,
+  Badge,
+  Breadcrumbs,
+  Button,
+  ButtonGroup,
+  Card,
+  Checkbox,
+  CheckboxGroup,
+  Chip,
+  ChipGroup,
+  DataTable,
+  DatePicker,
+  Dialog,
+  Form,
+  FormActions,
+  FormError,
+  Field,
+  Gradient,
+  Game,
+  GameEntity,
+  GameField,
+  GameInputZone,
+  GameMeasurementProbe,
+  GameOverlay,
+  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,
+  AuthScreen,
+  ForgotPasswordForm,
+  OAuthProviderButton,
+  OAuthProviderList,
+  OtpForm,
+  SignInForm,
+  SignUpForm,
+  ChatListItem,
+  ChessBoard,
+  CollectionEditor,
+  ContentRail,
+  EmptyState,
+  Explorer,
+  FileExplorer,
+  GridLineOverlay,
+  GridRuler,
+  GridInteractions,
+  GridView,
+  TileGrid,
+  TimeGrid,
+  MatrixGrid,
+  MediaExplorer,
+  Hero,
+  List,
+  ListItem,
+  ListSection,
+  MessageBubble,
+  OpeningBook,
+  MissingElement,
+  PostCard,
+  ProductCard,
+  BarcodeScannerView,
+  CameraPermissionView,
+  ScanOverlay,
+  SectionHeader,
+  SelectableItem,
+  SpatialGrid,
+  PaletteItem,
+  CardBack,
+  CardHand,
+  PlayingCard,
+  TabletopTable,
+  PokerTrainingTable,
+  Timeline,
+  TreeItem,
+  TreeView,
+} as const satisfies ZoraComponentRegistry;
+
+/*** The core ZORA runtime component registry, excluding separately selected feature entries such as Reader. */
+export const ZORA_BASE_COMPONENT_REGISTRY: ZoraComponentRegistry = _ZORA_BASE_COMPONENT_REGISTRY;

package/src/features/registry/ZORA_COMPONENT_REGISTRY.ts

@@ -1,237 +1,8 @@
-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 { AppHeader } from '../app-header/public';
-import {
-  AuthScreen,
-  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 { ChessBoard, OpeningBook } from '../chess/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 { Explorer, FileExplorer, MediaExplorer } from '../explorer/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 {
-  Game,
-  GameEntity,
-  GameField,
-  GameInputZone,
-  GameMeasurementProbe,
-  GameOverlay,
-} from '../game/public';
-import { Gradient } from '../gradient/public';
-import { GridInteractions } from '../grid-interactions/public';
-import { GridLineOverlay, GridRuler } from '../grid-rulers/public';
-import { GridView, TileGrid } from '../grid-view/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 { MatrixGrid } from '../matrix-grid/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 { Reader } 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 { SpatialGrid } from '../spatial-grid/public';
-import { Surface } from '../surface/public';
-import {
-  CardBack,
-  CardHand,
-  PlayingCard,
-  PokerTrainingTable,
-  TabletopTable,
-} from '../tabletop/public';
-import { Tab, TabList, TabPanel, Tabs } from '../tabs/public';
-import { ThemeModeToggle } from '../theme/adapters/inbound/ThemeModeToggle';
-import { TimeGrid } from '../time-grid/public';
-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;
+import { createZoraComponentRegistry } from './createZoraComponentRegistry';
 
-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,
-  AppHeader,
-  Avatar,
-  AvatarGroup,
-  Badge,
-  Breadcrumbs,
-  Button,
-  ButtonGroup,
-  Card,
-  Checkbox,
-  CheckboxGroup,
-  Chip,
-  ChipGroup,
-  DataTable,
-  DatePicker,
-  Dialog,
-  Form,
-  FormActions,
-  FormError,
-  Field,
-  Gradient,
-  Game,
-  GameEntity,
-  GameField,
-  GameInputZone,
-  GameMeasurementProbe,
-  GameOverlay,
-  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,
-  AuthScreen,
-  ForgotPasswordForm,
-  OAuthProviderButton,
-  OAuthProviderList,
-  OtpForm,
-  SignInForm,
-  SignUpForm,
-  ChatListItem,
-  ChessBoard,
-  CollectionEditor,
-  ContentRail,
-  EmptyState,
-  Explorer,
-  FileExplorer,
-  GridLineOverlay,
-  GridRuler,
-  GridInteractions,
-  GridView,
-  TileGrid,
-  TimeGrid,
-  MatrixGrid,
-  MediaExplorer,
-  Hero,
-  List,
-  ListItem,
-  ListSection,
-  MessageBubble,
-  OpeningBook,
-  MissingElement,
-  PostCard,
-  ProductCard,
+/*** The complete ZORA runtime component registry, including the public Reader component. */
+export const ZORA_COMPONENT_REGISTRY: ZoraComponentRegistry = createZoraComponentRegistry({
   Reader,
-  BarcodeScannerView,
-  CameraPermissionView,
-  ScanOverlay,
-  SectionHeader,
-  SelectableItem,
-  SpatialGrid,
-  PaletteItem,
-  CardBack,
-  CardHand,
-  PlayingCard,
-  TabletopTable,
-  PokerTrainingTable,
-  Timeline,
-  TreeItem,
-  TreeView,
-} as const satisfies ZoraComponentRegistry;
-
-export const ZORA_COMPONENT_REGISTRY: ZoraComponentRegistry = _ZORA_COMPONENT_REGISTRY;
+});

package/src/features/registry/createZoraComponentRegistry.ts

@@ -0,0 +1,9 @@
+import type { ZoraComponentRegistry } from '../../types/registry';
+import { ZORA_BASE_COMPONENT_REGISTRY } from './ZORA_BASE_COMPONENT_REGISTRY';
+
+/*** Build a runtime component registry from ZORA's Reader-free base and explicitly selected feature entries. */
+export function createZoraComponentRegistry(
+  extensions: ZoraComponentRegistry = {},
+): ZoraComponentRegistry {
+  return { ...ZORA_BASE_COMPONENT_REGISTRY, ...extensions };
+}

package/src/features/registry/public.ts

@@ -1 +1,3 @@
+export { createZoraComponentRegistry } from './createZoraComponentRegistry';
+export { ZORA_BASE_COMPONENT_REGISTRY } from './ZORA_BASE_COMPONENT_REGISTRY';
 export { ZORA_COMPONENT_REGISTRY } from './ZORA_COMPONENT_REGISTRY';

package/src/features/registry/readerFreeRegistry.ts

@@ -0,0 +1,2 @@
+export { createZoraComponentRegistry } from './createZoraComponentRegistry';
+export { ZORA_BASE_COMPONENT_REGISTRY } from './ZORA_BASE_COMPONENT_REGISTRY';

package/src/features/registry/registry.test.ts

@@ -53,7 +53,7 @@ async function listRuntimeRegistryEntries(): Promise<readonly string[]> {
 }
 
 async function listPublicConcreteComponentExports(): Promise<readonly string[]> {
-  const source = await Bun.file('src/index.ts').text();
+  const source = await Bun.file('src/readerFree.ts').text();
   const componentExports = Array.from(
     source.matchAll(
       /export\s+\{([^}]+)\}\s+from '\.\/(components\/[^']+|features\/[^']+|foundation|layout\/[^']+|patterns\/[^']+)';/g,
@@ -64,7 +64,7 @@ async function listPublicConcreteComponentExports(): Promise<readonly string[]>
     .filter((name) => /^[A-Z][A-Za-z0-9]+$/.test(name))
     .filter((name) => !NON_RUNTIME_COMPONENT_EXPORTS.has(name));
 
-  return [...componentExports, ...RUNTIME_THEME_COMPONENT_EXPORTS].sort();
+  return [...componentExports, 'Reader', ...RUNTIME_THEME_COMPONENT_EXPORTS].sort();
 }
 
 describe('ZORA_COMPONENT_REGISTRY', () => {
@@ -78,9 +78,40 @@ describe('ZORA_COMPONENT_REGISTRY', () => {
     expect(registryEntries).toContain('View');
     expect(registryEntries).toContain('AppHeader');
     expect(source).toContain("export type { ZoraComponentRegistry } from './types/registry';");
-    expect(source).toContain(
-      "export { ZORA_COMPONENT_REGISTRY } from './features/registry/public';",
-    );
+    expect(source).toContain('ZORA_COMPONENT_REGISTRY');
+  });
+
+  test('publishes Reader-free registry and root-surface composition boundaries', async () => {
+    const [baseSource, compositionSource, packageJson, readerFreeSource, readerFreeRootSource] =
+      await Promise.all([
+        Bun.file('src/features/registry/ZORA_BASE_COMPONENT_REGISTRY.ts').text(),
+        Bun.file('src/features/registry/createZoraComponentRegistry.ts').text(),
+        Bun.file('package.json').json() as Promise<{ readonly exports: Record<string, unknown> }>,
+        Bun.file('src/features/registry/readerFreeRegistry.ts').text(),
+        Bun.file('src/readerFree.ts').text(),
+      ]);
+
+    expect(baseSource).not.toContain("from '../reader/public'");
+    expect(compositionSource).toContain('ZORA_BASE_COMPONENT_REGISTRY');
+    expect(readerFreeSource).toContain('ZORA_BASE_COMPONENT_REGISTRY');
+    expect(readerFreeSource).toContain('createZoraComponentRegistry');
+    expect(readerFreeSource).not.toContain('ZORA_COMPONENT_REGISTRY');
+    expect(readerFreeRootSource).not.toContain("from './features/reader/public'");
+    expect(readerFreeRootSource).not.toContain('ZORA_COMPONENT_REGISTRY');
+    expect(packageJson.exports['./registry']).toEqual({
+      'react-native': './src/features/registry/readerFreeRegistry.ts',
+      browser: './src/features/registry/readerFreeRegistry.ts',
+      types: './dist/features/registry/readerFreeRegistry.d.ts',
+      import: './dist/features/registry/readerFreeRegistry.js',
+      default: './dist/features/registry/readerFreeRegistry.js',
+    });
+    expect(packageJson.exports['./reader-free']).toEqual({
+      'react-native': './src/readerFree.ts',
+      browser: './src/readerFree.ts',
+      types: './dist/readerFree.d.ts',
+      import: './dist/readerFree.js',
+      default: './dist/readerFree.js',
+    });
   });
 
   test('covers every public concrete ZORA component export supported for runtime rendering', async () => {

package/src/features/uploader/public.test.ts

@@ -6,15 +6,16 @@ describe('ZORA Uploader public contract', () => {
       dependencies: Readonly<Record<string, string>>;
       exports: Readonly<Record<string, unknown>>;
     };
-    const [rootSource, publicSource] = await Promise.all([
+    const [rootSource, readerFreeSource, publicSource] = await Promise.all([
       Bun.file('src/index.ts').text(),
+      Bun.file('src/readerFree.ts').text(),
       Bun.file('src/features/uploader/public.ts').text(),
     ]);
 
     expect(packageJson.exports['./uploader']).toBeDefined();
     expect(packageJson.dependencies['expo-image-picker']).toMatch(/^~57\./u);
     expect(packageJson.dependencies['expo-document-picker']).toMatch(/^~57\./u);
-    expect(rootSource).toContain("from './features/uploader/public'");
+    expect(`${rootSource}\n${readerFreeSource}`).toContain("from './features/uploader/public'");
     expect(publicSource).toContain('export { Uploader }');
     expect(publicSource).toContain('export { validateUploadAsset }');
   });