@ankhorage/zora 3.0.2 → 3.1.0

package/dist/patterns/reader/resolveReaderProgress.js

@@ -0,0 +1,17 @@
+export function resolveReaderProgress({ progress, page, pageCount, }) {
+    if (progress !== undefined && Number.isFinite(progress)) {
+        return Math.min(1, Math.max(0, progress));
+    }
+    if (page === undefined ||
+        pageCount === undefined ||
+        !Number.isFinite(page) ||
+        !Number.isFinite(pageCount) ||
+        pageCount < 1) {
+        return 0;
+    }
+    if (pageCount === 1) {
+        return 1;
+    }
+    return Math.min(1, Math.max(0, (page - 1) / (pageCount - 1)));
+}
+//# sourceMappingURL=resolveReaderProgress.js.map

package/dist/patterns/reader/resolveReaderProgress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveReaderProgress.js","sourceRoot":"","sources":["../../../src/patterns/reader/resolveReaderProgress.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,qBAAqB,CAAC,EACpC,QAAQ,EACR,IAAI,EACJ,SAAS,GAKV;IACC,IAAI,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,IACE,IAAI,KAAK,SAAS;QAClB,SAAS,KAAK,SAAS;QACvB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QACtB,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC3B,SAAS,GAAG,CAAC,EACb,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC","sourcesContent":["export function resolveReaderProgress({\n  progress,\n  page,\n  pageCount,\n}: {\n  progress?: number;\n  page?: number;\n  pageCount?: number;\n}): number {\n  if (progress !== undefined && Number.isFinite(progress)) {\n    return Math.min(1, Math.max(0, progress));\n  }\n\n  if (\n    page === undefined ||\n    pageCount === undefined ||\n    !Number.isFinite(page) ||\n    !Number.isFinite(pageCount) ||\n    pageCount < 1\n  ) {\n    return 0;\n  }\n\n  if (pageCount === 1) {\n    return 1;\n  }\n\n  return Math.min(1, Math.max(0, (page - 1) / (pageCount - 1)));\n}\n"]}

package/dist/patterns/reader/types.d.ts

@@ -0,0 +1,69 @@
+import type React from 'react';
+import type { ZoraBaseProps } from '../../theme/ZoraBaseProps';
+export type ReaderDocumentFormat = 'epub' | 'pdf';
+export type ReaderStatus = 'idle' | 'loading' | 'ready' | 'error';
+export type ReaderNavigationTrigger = 'swipe' | 'previousControl' | 'nextControl' | 'keyboard' | 'location';
+export interface ReaderLocationChangeEvent {
+    format: ReaderDocumentFormat;
+    locator: string;
+    page: number;
+    pageCount?: number;
+    progression: number;
+    chapterId?: string;
+    chapterTitle?: string;
+    trigger: ReaderNavigationTrigger;
+}
+export type ReaderErrorCode = 'invalid-document' | 'load-failed' | 'protected-document' | 'unsupported-format';
+export interface ReaderErrorEvent {
+    code: ReaderErrorCode;
+    format?: ReaderDocumentFormat;
+    message: string;
+}
+export type ReaderColorScheme = 'system' | 'light' | 'dark' | 'sepia';
+export type ReaderLineHeight = 'compact' | 'normal' | 'relaxed';
+export type ReaderResolvedSource = string | number | {
+    readonly uri: string;
+};
+export interface ReaderExternalLinkEvent {
+    url: string;
+}
+export interface ReaderSurfaceProps extends ZoraBaseProps {
+    source?: ReaderResolvedSource | null;
+    format: ReaderDocumentFormat;
+    location?: string;
+    status?: ReaderStatus;
+    page?: number;
+    pageCount?: number;
+    progress?: number;
+    canGoPrevious?: boolean;
+    canGoNext?: boolean;
+    title?: string;
+    subtitle?: string;
+    chapterLabel?: string;
+    pageLabel?: string;
+    previousPageLabel?: string;
+    nextPageLabel?: string;
+    contentsLabel?: string;
+    appearanceLabel?: string;
+    highlightLabel?: string;
+    loadingLabel?: string;
+    errorTitle?: string;
+    unavailableTitle?: string;
+    showChrome?: boolean;
+    readerColorScheme?: ReaderColorScheme;
+    fontScale?: number;
+    lineHeight?: ReaderLineHeight;
+    highlighted?: boolean;
+    viewport?: React.ReactNode;
+    headerActions?: React.ReactNode;
+    footerActions?: React.ReactNode;
+    onPreviousPage?: () => void | Promise<void>;
+    onNextPage?: () => void | Promise<void>;
+    onLocationChange?: (event: ReaderLocationChangeEvent) => void | Promise<void>;
+    onOpenContents?: () => void | Promise<void>;
+    onOpenAppearance?: () => void | Promise<void>;
+    onToggleHighlight?: () => void | Promise<void>;
+    onOpenExternalLink?: (event: ReaderExternalLinkEvent) => void | Promise<void>;
+    onReaderError?: (event: ReaderErrorEvent) => void | Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/patterns/reader/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/patterns/reader/types.ts"],"names":[],"mappings":"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"}

package/dist/patterns/reader/types.js

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

package/dist/patterns/reader/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/patterns/reader/types.ts"],"names":[],"mappings":"","sourcesContent":["import type React from 'react';\n\nimport type { ZoraBaseProps } from '../../theme/ZoraBaseProps';\n\nexport type ReaderDocumentFormat = 'epub' | 'pdf';\n\nexport type ReaderStatus = 'idle' | 'loading' | 'ready' | 'error';\n\nexport type ReaderNavigationTrigger =\n  'swipe' | 'previousControl' | 'nextControl' | 'keyboard' | 'location';\n\nexport interface ReaderLocationChangeEvent {\n  format: ReaderDocumentFormat;\n  locator: string;\n  page: number;\n  pageCount?: number;\n  progression: number;\n  chapterId?: string;\n  chapterTitle?: string;\n  trigger: ReaderNavigationTrigger;\n}\n\nexport type ReaderErrorCode =\n  'invalid-document' | 'load-failed' | 'protected-document' | 'unsupported-format';\n\nexport interface ReaderErrorEvent {\n  code: ReaderErrorCode;\n  format?: ReaderDocumentFormat;\n  message: string;\n}\n\nexport type ReaderColorScheme = 'system' | 'light' | 'dark' | 'sepia';\n\nexport type ReaderLineHeight = 'compact' | 'normal' | 'relaxed';\n\nexport type ReaderResolvedSource = string | number | { readonly uri: string };\n\nexport interface ReaderExternalLinkEvent {\n  url: string;\n}\n\nexport interface ReaderSurfaceProps extends ZoraBaseProps {\n  source?: ReaderResolvedSource | null;\n  format: ReaderDocumentFormat;\n  location?: string;\n  status?: ReaderStatus;\n  page?: number;\n  pageCount?: number;\n  progress?: number;\n  canGoPrevious?: boolean;\n  canGoNext?: boolean;\n  title?: string;\n  subtitle?: string;\n  chapterLabel?: string;\n  pageLabel?: string;\n  previousPageLabel?: string;\n  nextPageLabel?: string;\n  contentsLabel?: string;\n  appearanceLabel?: string;\n  highlightLabel?: string;\n  loadingLabel?: string;\n  errorTitle?: string;\n  unavailableTitle?: string;\n  showChrome?: boolean;\n  readerColorScheme?: ReaderColorScheme;\n  fontScale?: number;\n  lineHeight?: ReaderLineHeight;\n  highlighted?: boolean;\n  viewport?: React.ReactNode;\n  headerActions?: React.ReactNode;\n  footerActions?: React.ReactNode;\n  onPreviousPage?: () => void | Promise<void>;\n  onNextPage?: () => void | Promise<void>;\n  onLocationChange?: (event: ReaderLocationChangeEvent) => void | Promise<void>;\n  onOpenContents?: () => void | Promise<void>;\n  onOpenAppearance?: () => void | Promise<void>;\n  onToggleHighlight?: () => void | Promise<void>;\n  onOpenExternalLink?: (event: ReaderExternalLinkEvent) => void | Promise<void>;\n  onReaderError?: (event: ReaderErrorEvent) => void | Promise<void>;\n}\n"]}

package/dist/patterns/scanner/meta.d.ts

@@ -105,7 +105,7 @@ export declare const barcodeScannerViewMeta: {
     readonly category: "pattern";
     readonly description: "Composed scanner shell with permission, camera slot, scan overlay, and manual entry affordance.";
     readonly directManifestNode: true;
-    readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble"];
+    readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ReaderSurface"];
     readonly requirements: {
         readonly permissions: readonly [{
             readonly permission: "camera";
@@ -145,7 +145,7 @@ export declare const barcodeScannerViewMeta: {
         };
         readonly children: {
             readonly label: "Scanner footer";
-            readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble"];
+            readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ReaderSurface"];
         };
     };
     readonly props: {

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAoG/B,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AA0IhF,eAAO,MAAM,uBAAuB,EAAE,qBAAgD,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAqG/B,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AA2IhF,eAAO,MAAM,uBAAuB,EAAE,qBAAgD,CAAC"}

package/dist/registry.js

@@ -64,6 +64,7 @@ import { Notice } from './patterns/notice';
 import { Panel } from './patterns/panel';
 import { PostCard } from './patterns/post-card';
 import { ProductCard } from './patterns/product-card';
+import { ReaderSurface } from './patterns/reader';
 import { ResponsivePanel } from './patterns/responsive-panel';
 import { BarcodeScannerView, CameraPermissionView, ScanOverlay } from './patterns/scanner';
 import { SectionHeader } from './patterns/section-header';
@@ -173,6 +174,7 @@ const _ZORA_COMPONENT_REGISTRY = {
     PostCard,
     ProductCard,
     ResponsivePanel,
+    ReaderSurface,
     BarcodeScannerView,
     CameraPermissionView,
     ScanOverlay,

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { InteractionPolicyProps } from '@ankhorage/surface';\nimport type React from 'react';\n\nimport { ActionSheet, ActionSheetItem } from './components/action-sheet';\nimport { AppBar } from './components/app-bar';\nimport { Avatar } from './components/avatar';\nimport { AvatarGroup } from './components/avatar-group';\nimport { Badge } from './components/badge';\nimport { Breadcrumbs } from './components/breadcrumbs';\nimport { Button } from './components/button';\nimport { ButtonGroup } from './components/button-group';\nimport { Card } from './components/card';\nimport { Checkbox, CheckboxGroup } from './components/checkbox';\nimport { Chip } from './components/chip';\nimport { ChipGroup } from './components/chip-group';\nimport { DataTable } from './components/data-table';\nimport { DatePicker } from './components/date-picker';\nimport { Drawer } from './components/drawer';\nimport { Form, FormActions, FormError, FormField } from './components/form';\nimport { Gradient } from './components/gradient';\nimport { Heading } from './components/heading';\nimport { Icon } from './components/icon';\nimport { IconButton } from './components/icon-button';\nimport { Image } from './components/image';\nimport { Input } from './components/input';\nimport { MediaCard } from './components/media-card';\nimport { DropdownMenu, Menu } from './components/menu';\nimport { MetricCard } from './components/metric-card';\nimport { Modal } from './components/modal';\nimport { NavigationItem } from './components/navigation-item';\nimport { NavigationList } from './components/navigation-list';\nimport { Pagination } from './components/pagination';\nimport { Progress } from './components/progress';\nimport { Radio, RadioGroup } from './components/radio';\nimport { Rating } from './components/rating';\nimport { SearchBar } from './components/search-bar';\nimport { Select } from './components/select';\nimport { Skeleton, SkeletonCard, SkeletonList, SkeletonText } from './components/skeleton';\nimport { SplashScreen } from './components/splash-screen';\nimport { Tabs } from './components/tabs';\nimport { Text } from './components/text';\nimport { Textarea } from './components/textarea';\nimport { TimePicker } from './components/time-picker';\nimport { Toast } from './components/toast';\nimport { Toolbar, ToolbarAction } from './components/toolbar';\nimport {\n  Box,\n  Center,\n  Container,\n  Divider,\n  Grid,\n  Inline,\n  Show,\n  Spacer,\n  Stack,\n  Surface,\n} from './foundation';\nimport { AppShell } from './layout/app-shell';\nimport { Screen } from './layout/screen';\nimport { ScreenSection } from './layout/screen-section';\nimport { SettingsLayout } from './layout/settings-layout';\nimport { SidebarLayout } from './layout/sidebar-layout';\nimport { TopbarLayout } from './layout/topbar-layout';\nimport {\n  ForgotPasswordForm,\n  OAuthProviderButton,\n  OAuthProviderList,\n  OtpForm,\n  SignInForm,\n  SignUpForm,\n} from './patterns/auth';\nimport { ChatListItem } from './patterns/chat-list-item';\nimport { CollectionEditor } from './patterns/collection-editor';\nimport { ConfirmDialog } from './patterns/confirm-dialog';\nimport { DisclosureSection } from './patterns/disclosure-section';\nimport { EmptyState } from './patterns/empty-state';\nimport { FilterBar } from './patterns/filter-bar';\nimport { Hero } from './patterns/hero';\nimport { ImagePreview } from './patterns/image-preview';\nimport { ImageUploadField } from './patterns/image-upload-field';\nimport { InspectorField } from './patterns/inspector-field';\nimport { List, ListRow, ListSection } from './patterns/list';\nimport { MessageBubble } from './patterns/message-bubble';\nimport { Notice } from './patterns/notice';\nimport { Panel } from './patterns/panel';\nimport { PostCard } from './patterns/post-card';\nimport { ProductCard } from './patterns/product-card';\nimport { ResponsivePanel } from './patterns/responsive-panel';\nimport { BarcodeScannerView, CameraPermissionView, ScanOverlay } from './patterns/scanner';\nimport { SectionHeader } from './patterns/section-header';\nimport { SelectableItem } from './patterns/selection';\nimport { SettingsRow } from './patterns/settings-row';\nimport { SwitchField } from './patterns/switch-field';\nimport { ThemeComposer } from './patterns/theme-composer';\nimport { PaletteItem, TileGrid } from './patterns/tile-grid';\nimport { Timeline } from './patterns/timeline';\nimport { TreeItem, TreeView } from './patterns/tree-view';\nimport { ZoraDrawerContent } from './patterns/zora-drawer-content';\nimport { ZoraTabBar } from './patterns/zora-tab-bar';\nimport { ThemeModeToggle } from './theme/ThemeModeToggle';\n\nexport type ZoraComponentRegistry = Readonly<Record<string, React.ElementType>>;\n\ntype ComponentPropsFor<K extends keyof typeof _ZORA_COMPONENT_REGISTRY> = React.ComponentProps<\n  (typeof _ZORA_COMPONENT_REGISTRY)[K]\n>;\n\ntype AcceptsSurfaceInteractionPolicyProps<P> = 'interactionPolicy' extends keyof P\n  ? InteractionPolicyProps extends Pick<P, 'interactionPolicy'>\n    ? Pick<P, 'interactionPolicy'> extends InteractionPolicyProps\n      ? true\n      : false\n    : false\n  : false;\n\ntype RegistryInteractionPolicyContract = {\n  [K in keyof typeof _ZORA_COMPONENT_REGISTRY]: AcceptsSurfaceInteractionPolicyProps<\n    ComponentPropsFor<K>\n  >;\n};\n\ntype _AssertTrue<T extends true> = T;\ntype _RegistryInteractionPolicyCheck = _AssertTrue<\n  RegistryInteractionPolicyContract[keyof typeof _ZORA_COMPONENT_REGISTRY]\n>;\n\nconst _ZORA_COMPONENT_REGISTRY = {\n  ActionSheet,\n  ActionSheetItem,\n  AppBar,\n  Avatar,\n  AvatarGroup,\n  Badge,\n  Breadcrumbs,\n  Button,\n  ButtonGroup,\n  Card,\n  Checkbox,\n  CheckboxGroup,\n  Chip,\n  ChipGroup,\n  DataTable,\n  DatePicker,\n  Drawer,\n  DropdownMenu,\n  Form,\n  FormActions,\n  FormError,\n  FormField,\n  Gradient,\n  Heading,\n  Icon,\n  IconButton,\n  Image,\n  Input,\n  MediaCard,\n  Menu,\n  MetricCard,\n  Modal,\n  NavigationItem,\n  NavigationList,\n  Pagination,\n  Progress,\n  Radio,\n  RadioGroup,\n  Rating,\n  SearchBar,\n  Select,\n  Skeleton,\n  SkeletonCard,\n  SkeletonList,\n  SkeletonText,\n  SplashScreen,\n  Tabs,\n  Text,\n  Textarea,\n  TimePicker,\n  Toast,\n  Toolbar,\n  ToolbarAction,\n  ThemeModeToggle,\n  Box,\n  Center,\n  Container,\n  Divider,\n  Grid,\n  Inline,\n  Show,\n  Spacer,\n  Stack,\n  Surface,\n  AppShell,\n  Screen,\n  ScreenSection,\n  SettingsLayout,\n  SidebarLayout,\n  TopbarLayout,\n  ForgotPasswordForm,\n  OAuthProviderButton,\n  OAuthProviderList,\n  OtpForm,\n  SignInForm,\n  SignUpForm,\n  ChatListItem,\n  CollectionEditor,\n  ConfirmDialog,\n  DisclosureSection,\n  EmptyState,\n  FilterBar,\n  Hero,\n  ImagePreview,\n  ImageUploadField,\n  InspectorField,\n  List,\n  ListRow,\n  ListSection,\n  MessageBubble,\n  Notice,\n  Panel,\n  PostCard,\n  ProductCard,\n  ResponsivePanel,\n  BarcodeScannerView,\n  CameraPermissionView,\n  ScanOverlay,\n  SectionHeader,\n  SelectableItem,\n  SettingsRow,\n  SwitchField,\n  ThemeComposer,\n  PaletteItem,\n  TileGrid,\n  Timeline,\n  TreeItem,\n  TreeView,\n  ZoraDrawerContent,\n  ZoraTabBar,\n} as const satisfies ZoraComponentRegistry;\n\nexport const ZORA_COMPONENT_REGISTRY: ZoraComponentRegistry = _ZORA_COMPONENT_REGISTRY;\n"]}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { InteractionPolicyProps } from '@ankhorage/surface';\nimport type React from 'react';\n\nimport { ActionSheet, ActionSheetItem } from './components/action-sheet';\nimport { AppBar } from './components/app-bar';\nimport { Avatar } from './components/avatar';\nimport { AvatarGroup } from './components/avatar-group';\nimport { Badge } from './components/badge';\nimport { Breadcrumbs } from './components/breadcrumbs';\nimport { Button } from './components/button';\nimport { ButtonGroup } from './components/button-group';\nimport { Card } from './components/card';\nimport { Checkbox, CheckboxGroup } from './components/checkbox';\nimport { Chip } from './components/chip';\nimport { ChipGroup } from './components/chip-group';\nimport { DataTable } from './components/data-table';\nimport { DatePicker } from './components/date-picker';\nimport { Drawer } from './components/drawer';\nimport { Form, FormActions, FormError, FormField } from './components/form';\nimport { Gradient } from './components/gradient';\nimport { Heading } from './components/heading';\nimport { Icon } from './components/icon';\nimport { IconButton } from './components/icon-button';\nimport { Image } from './components/image';\nimport { Input } from './components/input';\nimport { MediaCard } from './components/media-card';\nimport { DropdownMenu, Menu } from './components/menu';\nimport { MetricCard } from './components/metric-card';\nimport { Modal } from './components/modal';\nimport { NavigationItem } from './components/navigation-item';\nimport { NavigationList } from './components/navigation-list';\nimport { Pagination } from './components/pagination';\nimport { Progress } from './components/progress';\nimport { Radio, RadioGroup } from './components/radio';\nimport { Rating } from './components/rating';\nimport { SearchBar } from './components/search-bar';\nimport { Select } from './components/select';\nimport { Skeleton, SkeletonCard, SkeletonList, SkeletonText } from './components/skeleton';\nimport { SplashScreen } from './components/splash-screen';\nimport { Tabs } from './components/tabs';\nimport { Text } from './components/text';\nimport { Textarea } from './components/textarea';\nimport { TimePicker } from './components/time-picker';\nimport { Toast } from './components/toast';\nimport { Toolbar, ToolbarAction } from './components/toolbar';\nimport {\n  Box,\n  Center,\n  Container,\n  Divider,\n  Grid,\n  Inline,\n  Show,\n  Spacer,\n  Stack,\n  Surface,\n} from './foundation';\nimport { AppShell } from './layout/app-shell';\nimport { Screen } from './layout/screen';\nimport { ScreenSection } from './layout/screen-section';\nimport { SettingsLayout } from './layout/settings-layout';\nimport { SidebarLayout } from './layout/sidebar-layout';\nimport { TopbarLayout } from './layout/topbar-layout';\nimport {\n  ForgotPasswordForm,\n  OAuthProviderButton,\n  OAuthProviderList,\n  OtpForm,\n  SignInForm,\n  SignUpForm,\n} from './patterns/auth';\nimport { ChatListItem } from './patterns/chat-list-item';\nimport { CollectionEditor } from './patterns/collection-editor';\nimport { ConfirmDialog } from './patterns/confirm-dialog';\nimport { DisclosureSection } from './patterns/disclosure-section';\nimport { EmptyState } from './patterns/empty-state';\nimport { FilterBar } from './patterns/filter-bar';\nimport { Hero } from './patterns/hero';\nimport { ImagePreview } from './patterns/image-preview';\nimport { ImageUploadField } from './patterns/image-upload-field';\nimport { InspectorField } from './patterns/inspector-field';\nimport { List, ListRow, ListSection } from './patterns/list';\nimport { MessageBubble } from './patterns/message-bubble';\nimport { Notice } from './patterns/notice';\nimport { Panel } from './patterns/panel';\nimport { PostCard } from './patterns/post-card';\nimport { ProductCard } from './patterns/product-card';\nimport { ReaderSurface } from './patterns/reader';\nimport { ResponsivePanel } from './patterns/responsive-panel';\nimport { BarcodeScannerView, CameraPermissionView, ScanOverlay } from './patterns/scanner';\nimport { SectionHeader } from './patterns/section-header';\nimport { SelectableItem } from './patterns/selection';\nimport { SettingsRow } from './patterns/settings-row';\nimport { SwitchField } from './patterns/switch-field';\nimport { ThemeComposer } from './patterns/theme-composer';\nimport { PaletteItem, TileGrid } from './patterns/tile-grid';\nimport { Timeline } from './patterns/timeline';\nimport { TreeItem, TreeView } from './patterns/tree-view';\nimport { ZoraDrawerContent } from './patterns/zora-drawer-content';\nimport { ZoraTabBar } from './patterns/zora-tab-bar';\nimport { ThemeModeToggle } from './theme/ThemeModeToggle';\n\nexport type ZoraComponentRegistry = Readonly<Record<string, React.ElementType>>;\n\ntype ComponentPropsFor<K extends keyof typeof _ZORA_COMPONENT_REGISTRY> = React.ComponentProps<\n  (typeof _ZORA_COMPONENT_REGISTRY)[K]\n>;\n\ntype AcceptsSurfaceInteractionPolicyProps<P> = 'interactionPolicy' extends keyof P\n  ? InteractionPolicyProps extends Pick<P, 'interactionPolicy'>\n    ? Pick<P, 'interactionPolicy'> extends InteractionPolicyProps\n      ? true\n      : false\n    : false\n  : false;\n\ntype RegistryInteractionPolicyContract = {\n  [K in keyof typeof _ZORA_COMPONENT_REGISTRY]: AcceptsSurfaceInteractionPolicyProps<\n    ComponentPropsFor<K>\n  >;\n};\n\ntype _AssertTrue<T extends true> = T;\ntype _RegistryInteractionPolicyCheck = _AssertTrue<\n  RegistryInteractionPolicyContract[keyof typeof _ZORA_COMPONENT_REGISTRY]\n>;\n\nconst _ZORA_COMPONENT_REGISTRY = {\n  ActionSheet,\n  ActionSheetItem,\n  AppBar,\n  Avatar,\n  AvatarGroup,\n  Badge,\n  Breadcrumbs,\n  Button,\n  ButtonGroup,\n  Card,\n  Checkbox,\n  CheckboxGroup,\n  Chip,\n  ChipGroup,\n  DataTable,\n  DatePicker,\n  Drawer,\n  DropdownMenu,\n  Form,\n  FormActions,\n  FormError,\n  FormField,\n  Gradient,\n  Heading,\n  Icon,\n  IconButton,\n  Image,\n  Input,\n  MediaCard,\n  Menu,\n  MetricCard,\n  Modal,\n  NavigationItem,\n  NavigationList,\n  Pagination,\n  Progress,\n  Radio,\n  RadioGroup,\n  Rating,\n  SearchBar,\n  Select,\n  Skeleton,\n  SkeletonCard,\n  SkeletonList,\n  SkeletonText,\n  SplashScreen,\n  Tabs,\n  Text,\n  Textarea,\n  TimePicker,\n  Toast,\n  Toolbar,\n  ToolbarAction,\n  ThemeModeToggle,\n  Box,\n  Center,\n  Container,\n  Divider,\n  Grid,\n  Inline,\n  Show,\n  Spacer,\n  Stack,\n  Surface,\n  AppShell,\n  Screen,\n  ScreenSection,\n  SettingsLayout,\n  SidebarLayout,\n  TopbarLayout,\n  ForgotPasswordForm,\n  OAuthProviderButton,\n  OAuthProviderList,\n  OtpForm,\n  SignInForm,\n  SignUpForm,\n  ChatListItem,\n  CollectionEditor,\n  ConfirmDialog,\n  DisclosureSection,\n  EmptyState,\n  FilterBar,\n  Hero,\n  ImagePreview,\n  ImageUploadField,\n  InspectorField,\n  List,\n  ListRow,\n  ListSection,\n  MessageBubble,\n  Notice,\n  Panel,\n  PostCard,\n  ProductCard,\n  ResponsivePanel,\n  ReaderSurface,\n  BarcodeScannerView,\n  CameraPermissionView,\n  ScanOverlay,\n  SectionHeader,\n  SelectableItem,\n  SettingsRow,\n  SwitchField,\n  ThemeComposer,\n  PaletteItem,\n  TileGrid,\n  Timeline,\n  TreeItem,\n  TreeView,\n  ZoraDrawerContent,\n  ZoraTabBar,\n} as const satisfies ZoraComponentRegistry;\n\nexport const ZORA_COMPONENT_REGISTRY: ZoraComponentRegistry = _ZORA_COMPONENT_REGISTRY;\n"]}

package/dist/theme/useZoraTheme.d.ts

@@ -1,7 +1,7 @@
 export declare function useZoraTheme(): {
     theme: import("@ankhorage/surface").SurfaceTheme;
     mode: "light" | "dark";
-    setThemeConfig: (config: Partial<import("@ankhorage/contracts").ThemeConfig>) => void;
+    setThemeConfig: (config: Partial<import("@ankhorage/surface").ThemeConfig>) => void;
     setMode: (mode: "light" | "dark") => void;
     _hasProvider?: boolean;
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/zora",
   "type": "module",
-  "version": "3.0.2",
+  "version": "3.1.0",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {
@@ -37,7 +37,7 @@
   },
   "dependencies": {
     "@ankhorage/color-theory": "^0.0.8",
-    "@ankhorage/contracts": "^8.0.0",
+    "@ankhorage/contracts": "^8.0.1",
     "@ankhorage/surface": "^3.0.2"
   },
   "files": [
@@ -86,7 +86,7 @@
     "version-packages": "ankhorage-changeset version"
   },
   "devDependencies": {
-    "@ankhorage/devtools": "^1.8.2",
+    "@ankhorage/devtools": "^1.8.3",
     "@ankhorage/paradox": "^0.1.24",
     "@react-native-picker/picker": "2.11.4",
     "@react-native-vector-icons/fontawesome": "^13.1.3",

package/src/components/text/Text.tsx

@@ -56,6 +56,7 @@ function TextInner({
   accessibilityLabel,
   accessibilityHint,
   accessibilityRole,
+  accessibilityLiveRegion,
   nativeID,
   testID,
   interactionPolicy: _interactionPolicy,
@@ -82,6 +83,7 @@ function TextInner({
     <ReactNativeText
       accessibilityHint={accessibilityHint}
       accessibilityLabel={accessibilityLabel}
+      accessibilityLiveRegion={accessibilityLiveRegion}
       accessibilityRole={accessibilityRole}
       ellipsizeMode={ellipsizeMode}
       nativeID={nativeID}

package/src/components/text/types.ts

@@ -1,6 +1,11 @@
 import type { Responsive } from '@ankhorage/surface';
 import type React from 'react';
-import type { AccessibilityRole, StyleProp, TextStyle } from 'react-native';
+import type {
+  AccessibilityRole,
+  StyleProp,
+  TextProps as ReactNativeTextProps,
+  TextStyle,
+} from 'react-native';
 
 import type { ZoraColor, ZoraEmphasis } from '../../internal/recipes';
 import type { ZoraBaseProps } from '../../theme/ZoraBaseProps';
@@ -31,5 +36,6 @@ export interface TextProps extends ZoraBaseProps {
   accessibilityLabel?: string;
   accessibilityHint?: string;
   accessibilityRole?: AccessibilityRole;
+  accessibilityLiveRegion?: ReactNativeTextProps['accessibilityLiveRegion'];
   nativeID?: string;
 }

package/src/expo57Migration.test.ts

@@ -20,6 +20,10 @@ const RNVI_PLUGINS = [
   '@react-native-vector-icons/fontawesome6',
   '@react-native-vector-icons/ionicons',
 ] as const;
+const CARET_SEMVER_RANGE = /^\^\d+\.\d+\.\d+$/u;
+const EXACT_SEMVER_VERSION = /^\d+\.\d+\.\d+$/u;
+const MINOR_WILDCARD_SEMVER_RANGE = /^\d+\.\d+\.x$/u;
+const TILDE_SEMVER_RANGE = /^~\d+\.\d+\.\d+$/u;
 
 function readJson(path: string): Record<string, unknown> {
   const value: unknown = JSON.parse(readFileSync(path, 'utf8'));
@@ -46,18 +50,18 @@ function readExamplePackage(directory: string): Record<string, unknown> {
 }
 
 describe('portable ZORA package boundary', () => {
-  test('targets the released RN 0.86 and Surface 3 contract without Expo runtime peers', () => {
+  test('uses the expected dependency range styles without Expo runtime peers', () => {
     const packageJson = readJson(join(ROOT, 'package.json'));
     const dependencies = readRecord(packageJson, 'dependencies');
     const peers = readRecord(packageJson, 'peerDependencies');
     const development = readRecord(packageJson, 'devDependencies');
 
-    expect(readValue(dependencies, '@ankhorage/surface')).toBe('^3.0.2');
-    expect(readValue(dependencies, '@ankhorage/contracts')).toBe('^8.0.0');
-    expect(peers.react).toBe('19.2.3');
-    expect(readValue(peers, 'react-native')).toBe('0.86.x');
-    expect(readValue(peers, 'react-native-web')).toBe('~0.21.0');
-    expect(development.typescript).toBe('~6.0.3');
+    expect(readValue(dependencies, '@ankhorage/surface')).toMatch(CARET_SEMVER_RANGE);
+    expect(readValue(dependencies, '@ankhorage/contracts')).toMatch(CARET_SEMVER_RANGE);
+    expect(peers.react).toMatch(EXACT_SEMVER_VERSION);
+    expect(readValue(peers, 'react-native')).toMatch(MINOR_WILDCARD_SEMVER_RANGE);
+    expect(readValue(peers, 'react-native-web')).toMatch(TILDE_SEMVER_RANGE);
+    expect(development.typescript).toMatch(TILDE_SEMVER_RANGE);
 
     for (const expoPackage of ['@expo/vector-icons', 'expo-font', 'expo-linear-gradient']) {
       expect(readValue(peers, expoPackage)).toBeUndefined();
@@ -82,18 +86,18 @@ describe('portable ZORA package boundary', () => {
 });
 
 describe('Expo 57 example boundary', () => {
-  test('uses the canonical React, RN, RNW, TypeScript, and Expo baselines', () => {
+  test('uses Renovate-safe dependency range styles across every Expo example', () => {
     for (const directory of EXPO_EXAMPLE_DIRS) {
       const packageJson = readExamplePackage(directory);
       const dependencies = readRecord(packageJson, 'dependencies');
       const development = readRecord(packageJson, 'devDependencies');
 
-      expect(readValue(dependencies, '@ankhorage/zora')).toBe('^3.0.0');
-      expect(dependencies.expo).toBe('57.0.18');
-      expect(dependencies.react).toBe('19.2.3');
-      expect(readValue(dependencies, 'react-native')).toBe('0.86.3');
-      expect(readValue(dependencies, 'react-native-web')).toBe('~0.21.0');
-      expect(development.typescript).toBe('~6.0.3');
+      expect(readValue(dependencies, '@ankhorage/zora')).toMatch(CARET_SEMVER_RANGE);
+      expect(dependencies.expo).toMatch(EXACT_SEMVER_VERSION);
+      expect(dependencies.react).toMatch(EXACT_SEMVER_VERSION);
+      expect(readValue(dependencies, 'react-native')).toMatch(EXACT_SEMVER_VERSION);
+      expect(readValue(dependencies, 'react-native-web')).toMatch(TILDE_SEMVER_RANGE);
+      expect(development.typescript).toMatch(TILDE_SEMVER_RANGE);
       expect(readValue(dependencies, '@expo/vector-icons')).toBeUndefined();
     }
   });

package/src/index.ts

@@ -327,6 +327,20 @@ export type {
 export { PostCard } from './patterns/post-card';
 export type { ProductCardProps } from './patterns/product-card';
 export { ProductCard } from './patterns/product-card';
+export type {
+  ReaderColorScheme,
+  ReaderDocumentFormat,
+  ReaderErrorCode,
+  ReaderErrorEvent,
+  ReaderExternalLinkEvent,
+  ReaderLineHeight,
+  ReaderLocationChangeEvent,
+  ReaderNavigationTrigger,
+  ReaderResolvedSource,
+  ReaderStatus,
+  ReaderSurfaceProps,
+} from './patterns/reader';
+export { ReaderSurface, resolveReaderProgress } from './patterns/reader';
 export type {
   ResponsivePanelDesktopMode,
   ResponsivePanelMobileMode,

package/src/interactionPolicy.test.ts

@@ -42,6 +42,7 @@ describe('InteractionPolicy declaration', () => {
       readPattern('empty-state', 'types.ts'),
       readPattern('hero', 'types.ts'),
       readPattern('product-card', 'types.ts'),
+      readPattern('reader', 'types.ts'),
       readPattern('scanner', 'types.ts'),
       readPattern('zora-tab-bar', 'types.ts'),
       readComponent('select', 'types.ts'),
@@ -156,6 +157,35 @@ describe('ProductCard', () => {
   });
 });
 
+describe('ReaderSurface', () => {
+  test('types extend ZoraBaseProps instead of duplicating InteractionPolicy', () => {
+    const source = readPattern('reader', 'types.ts');
+
+    expect(source).not.toMatch(
+      /import type \{\s*InteractionPolicy\s*\} from '@ankhorage\/surface';/,
+    );
+    expect(source).toMatch(/export interface ReaderSurfaceProps extends ZoraBaseProps/);
+    expect(source).not.toMatch(/interactionPolicy\?: InteractionPolicy;/);
+  });
+
+  test('forwards interactionPolicy to its owned interactive controls', () => {
+    const source = readPattern('reader', 'ReaderSurface.tsx');
+
+    expect(source).not.toMatch(/interactionPolicy:\s*_interactionPolicy/);
+    expect(source).toMatch(
+      /function ReaderHeader[\s\S]*?<IconButton[\s\S]*?interactionPolicy=\{interactionPolicy\}/,
+    );
+    expect(source).toMatch(
+      /function ReaderHeader[\s\S]*?<AppBar[\s\S]*?interactionPolicy=\{interactionPolicy\}/,
+    );
+    expect(source).toMatch(
+      /function ReaderFooter[\s\S]*?<IconButton[\s\S]*?interactionPolicy=\{interactionPolicy\}/,
+    );
+    expect(source).toMatch(/<ReaderHeader[\s\S]*?interactionPolicy=\{interactionPolicy\}/);
+    expect(source).toMatch(/<ReaderFooter[\s\S]*?interactionPolicy=\{interactionPolicy\}/);
+  });
+});
+
 describe('CameraPermissionView', () => {
   test('forwards interactionPolicy to internal Buttons after prop spreads', () => {
     const source = readPattern('scanner', 'CameraPermissionView.tsx');

package/src/metadata/allowedChildren.ts

@@ -21,6 +21,7 @@ export const CONTAINER_ALLOWED_CHILDREN = [
   'PostCard',
   'ChatListItem',
   'MessageBubble',
+  'ReaderSurface',
 ] as const;
 
 export const SCREEN_SECTION_ALLOWED_CHILDREN = [...CONTAINER_ALLOWED_CHILDREN] as const;

package/src/metadata/bindableComponentMeta.test.ts

@@ -28,4 +28,34 @@ describe('ZORA bindable component metadata', () => {
     expect(image.directManifestNode).toBe(ZORA_COMPONENT_META.Image.directManifestNode);
     expect(image.bindings.props.source.value.type).toBe('imageAsset');
   });
+
+  it('describes serializable controlled ReaderSurface bindings', () => {
+    const reader = ZORA_BINDABLE_COMPONENT_META.ReaderSurface;
+
+    expect(Object.keys(reader.bindings.props)).toEqual([
+      'location',
+      'page',
+      'pageCount',
+      'progress',
+      'status',
+    ]);
+    expect(reader.bindings.events.locationChange.payload.fields.map((field) => field.path)).toEqual(
+      [
+        'format',
+        'locator',
+        'page',
+        'pageCount',
+        'progression',
+        'chapterId',
+        'chapterTitle',
+        'trigger',
+      ],
+    );
+    expect(reader.bindings.events.openExternalLink.payload.fields).toEqual([
+      { path: 'url', type: 'string', label: 'URL' },
+    ]);
+    expect(reader.bindings.props.location.value.type).toBe('string');
+    expect(reader.bindings.props.page.value.type).toBe('number');
+    expect(reader.bindings.events.locationChange.payload.eventType).toBe('reader.locationChange');
+  });
 });

package/src/metadata/bindableComponentMeta.ts

@@ -1,6 +1,7 @@
 import type { UiComponentMetaRegistry } from '@ankhorage/contracts';
 
 import { imageMeta } from '../components/image/meta';
+import { readerSurfaceMeta } from '../patterns/reader/meta';
 
 export const ZORA_BINDABLE_COMPONENT_META = {
   Text: {
@@ -462,6 +463,107 @@ export const ZORA_BINDABLE_COMPONENT_META = {
       },
     },
   },
+  ReaderSurface: {
+    ...readerSurfaceMeta,
+    bindings: {
+      props: {
+        location: {
+          label: 'Location',
+          description: 'Opaque adapter locator to restore.',
+          value: { type: 'string' },
+          acceptsFallback: true,
+          acceptsTransforms: true,
+        },
+        page: {
+          label: 'Page',
+          description: 'One-based visible page.',
+          value: { type: 'number' },
+          acceptsFallback: true,
+          acceptsTransforms: true,
+        },
+        pageCount: {
+          label: 'Page count',
+          description: 'Current number of logical pages.',
+          value: { type: 'number' },
+          acceptsFallback: true,
+          acceptsTransforms: true,
+        },
+        progress: {
+          label: 'Progress',
+          description: 'Reading progression clamped from zero to one.',
+          value: { type: 'number' },
+          acceptsFallback: true,
+          acceptsTransforms: true,
+        },
+        status: {
+          label: 'Status',
+          description: 'Current reader loading status.',
+          value: { type: 'string' },
+          acceptsFallback: true,
+          acceptsTransforms: true,
+        },
+      },
+      events: {
+        previousPage: {
+          label: 'Previous page',
+          description: 'Requests navigation to the previous page.',
+          payload: { eventType: 'reader.previousPage', fields: [] },
+        },
+        nextPage: {
+          label: 'Next page',
+          description: 'Requests navigation to the next page.',
+          payload: { eventType: 'reader.nextPage', fields: [] },
+        },
+        locationChange: {
+          label: 'Location change',
+          description: 'Runs after the adapter displays a destination.',
+          payload: {
+            eventType: 'reader.locationChange',
+            fields: [
+              { path: 'format', type: 'string', label: 'Format' },
+              { path: 'locator', type: 'string', label: 'Opaque locator' },
+              { path: 'page', type: 'number', label: 'Page' },
+              { path: 'pageCount', type: 'number', label: 'Page count' },
+              { path: 'progression', type: 'number', label: 'Progression' },
+              { path: 'chapterId', type: 'string', label: 'Chapter ID' },
+              { path: 'chapterTitle', type: 'string', label: 'Chapter title' },
+              { path: 'trigger', type: 'string', label: 'Navigation trigger' },
+            ],
+          },
+        },
+        openContents: {
+          label: 'Open contents',
+          payload: { eventType: 'reader.openContents', fields: [] },
+        },
+        openAppearance: {
+          label: 'Open appearance',
+          payload: { eventType: 'reader.openAppearance', fields: [] },
+        },
+        toggleHighlight: {
+          label: 'Toggle highlight',
+          payload: { eventType: 'reader.toggleHighlight', fields: [] },
+        },
+        openExternalLink: {
+          label: 'Open external link',
+          payload: {
+            eventType: 'reader.openExternalLink',
+            fields: [{ path: 'url', type: 'string', label: 'URL' }],
+          },
+        },
+        readerError: {
+          label: 'Reader error',
+          payload: {
+            eventType: 'reader.error',
+            fields: [
+              { path: 'code', type: 'string', label: 'Error code' },
+              { path: 'format', type: 'string', label: 'Format' },
+              { path: 'message', type: 'string', label: 'Message' },
+            ],
+          },
+        },
+      },
+    },
+  },
 } as const satisfies UiComponentMetaRegistry;
 
 export type ZoraBindableComponentType = keyof typeof ZORA_BINDABLE_COMPONENT_META;

package/src/metadata/componentMeta.test.ts

@@ -88,6 +88,12 @@ describe('ZORA_COMPONENT_META requirement metadata', () => {
     });
   });
 
+  test('declares ebook reader capability metadata for ReaderSurface', () => {
+    expect(ZORA_COMPONENT_META.ReaderSurface.requirements).toEqual({
+      capabilities: [{ capability: 'ebookReader' }],
+    });
+  });
+
   test('does not declare runtime requirements for the camera-agnostic scan overlay', () => {
     expect(ZORA_COMPONENT_META.ScanOverlay.requirements).toBeUndefined();
   });
@@ -132,6 +138,7 @@ describe('ZORA_COMPONENT_META invariants', () => {
       'ScanOverlay',
       'ProductCard',
       'Progress',
+      'ReaderSurface',
     ]);
 
     const expectedContainerNodes = new Set([
@@ -204,6 +211,35 @@ describe('ZORA_COMPONENT_META invariants', () => {
     });
   });
 
+  test('ReaderSurface exposes a safe file-media blueprint and normalized events', () => {
+    const reader = ZORA_COMPONENT_META.ReaderSurface;
+
+    expect(reader.directManifestNode).toBe(true);
+    expect(reader.allowedChildren).toEqual([]);
+    expect(reader.props.source).toMatchObject({ type: 'media', mediaKinds: ['file'] });
+    expect(reader.props.format.enum).toEqual(['epub', 'pdf']);
+    expect(reader.blueprint?.defaultProps).toEqual({
+      format: 'epub',
+      status: 'idle',
+      showChrome: true,
+      readerColorScheme: 'system',
+      fontScale: 1,
+      lineHeight: 'normal',
+    });
+    expect(reader.blueprint?.defaultProps).not.toHaveProperty('source');
+    expect(reader.events?.locationChange?.payloadFields?.map((field) => field.path)).toEqual([
+      'format',
+      'locator',
+      'page',
+      'pageCount',
+      'progression',
+      'chapterId',
+      'chapterTitle',
+      'trigger',
+    ]);
+    expect(reader.events?.readerError?.eventType).toBe('reader.error');
+  });
+
   test('non-direct manifest nodes include an explicit note', () => {
     for (const [key, meta] of Object.entries(ZORA_COMPONENT_META)) {
       if (meta.directManifestNode) continue;