@ankhorage/expo-runtime 3.1.1 → 3.2.0

package/dist/reader/readerViewportPresentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readerViewportPresentation.js","sourceRoot":"","sources":["../../src/reader/readerViewportPresentation.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAwB;IAChD,SAAS,EAAE,KAAK;IAChB,aAAa,EAAE,KAAK;IACpB,IAAI,EAAE,CAAC;IACP,QAAQ,EAAE,CAAC;IACX,MAAM,EAAE,SAAS;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;CAiB5B,CAAC","sourcesContent":["import type { ReaderViewportState } from './types';\n\nexport const LOADING_STATE: ReaderViewportState = {\n  canGoNext: false,\n  canGoPrevious: false,\n  page: 1,\n  progress: 0,\n  status: 'loading',\n};\n\nexport const READER_STYLES = `\n  :root, body, #root { height: 100%; margin: 0; overflow: hidden; }\n  * { box-sizing: border-box; }\n  .reader-root { background: #fff; color: #111; height: 100%; outline: none; overflow: hidden; touch-action: pan-y; width: 100%; }\n  .reader-dark { background: #111; color: #f5f5f5; }\n  .reader-sepia { background: #f4ecd8; color: #3f3527; }\n  .reader-content { height: 100%; overflow: auto; position: relative; width: 100%; }\n  .reader-content > div:not(.reader-pdf-page) { height: 100%; width: 100%; }\n  .reader-pdf-page { --user-unit: 1; --total-scale-factor: calc(var(--scale-factor) * var(--user-unit)); margin: 0 auto; position: relative; }\n  .reader-pdf-page canvas { display: block; position: absolute; inset: 0; }\n  .reader-pdf-text-layer { --min-font-size: 1; --text-scale-factor: calc(var(--total-scale-factor) * var(--min-font-size)); --min-font-size-inv: calc(1 / var(--min-font-size)); inset: 0; line-height: 1; opacity: 1; overflow: hidden; position: absolute; text-align: initial; text-size-adjust: none; transform-origin: 0 0; }\n  .reader-pdf-text-layer span, .reader-pdf-text-layer br { color: transparent; cursor: text; position: absolute; transform-origin: 0 0; user-select: text; white-space: pre; }\n  .reader-pdf-text-layer > :not(.markedContent), .reader-pdf-text-layer .markedContent span:not(.markedContent) { --font-height: 0; --scale-x: 1; --rotate: 0deg; font-size: calc(var(--text-scale-factor) * var(--font-height)); transform: rotate(var(--rotate)) scaleX(var(--scale-x)) scale(var(--min-font-size-inv)); }\n  .reader-pdf-text-layer .markedContent { display: contents; }\n  .reader-pdf-text-layer ::selection { background: rgba(0, 100, 255, 0.35); }\n  .reader-pdf-link-layer { inset: 0; pointer-events: none; position: absolute; }\n  .reader-pdf-link-layer a { outline-offset: 2px; pointer-events: auto; position: absolute; }\n`;\n"]}

package/dist/reader/types.d.ts

@@ -0,0 +1,57 @@
+import type { ReaderErrorEvent, ReaderLocationChangeEvent } from '@ankhorage/zora';
+import type { DOMProps } from 'expo/dom';
+export interface ReaderAppearance {
+    readonly colorScheme: 'dark' | 'light' | 'sepia' | 'system';
+    readonly fontScale: number;
+    readonly lineHeight: number;
+}
+export interface ReaderCommand {
+    readonly id: number;
+    readonly sourceUri: string;
+    readonly type: 'next' | 'previous';
+}
+export interface ReaderViewportState {
+    readonly canGoNext: boolean;
+    readonly canGoPrevious: boolean;
+    readonly location?: ReaderLocationChangeEvent;
+    readonly page: number;
+    readonly pageCount?: number;
+    readonly progress: number;
+    readonly status: 'loading' | 'ready';
+}
+export interface ReaderViewportProps {
+    readonly appearance: ReaderAppearance;
+    readonly command?: ReaderCommand;
+    readonly format: 'epub' | 'pdf';
+    readonly initialLocation?: string;
+    readonly onError: (event: ReaderErrorEvent) => Promise<void>;
+    readonly onOpenExternalLink: (event: {
+        readonly url: string;
+    }) => Promise<void>;
+    readonly onStateChange: (state: ReaderViewportState) => Promise<void>;
+    readonly sourceUri: string;
+    readonly dom?: DOMProps;
+}
+export interface ReaderDriverState {
+    readonly canGoNext: boolean;
+    readonly canGoPrevious: boolean;
+    readonly chapterId?: string;
+    readonly chapterTitle?: string;
+    readonly locator: string;
+    readonly page: number;
+    readonly pageCount?: number;
+    readonly progression: number;
+}
+export interface ReaderDriver {
+    readonly direction: 'ltr' | 'rtl';
+    destroy(): Promise<void>;
+    getState(): ReaderDriverState;
+    goNext(trigger: ReaderLocationChangeEvent['trigger']): Promise<void>;
+    goPrevious(trigger: ReaderLocationChangeEvent['trigger']): Promise<void>;
+}
+export interface ReaderTouchStart {
+    readonly interactive: boolean;
+    readonly x: number;
+    readonly y: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/reader/types.js

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

package/dist/reader/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/reader/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ReaderErrorEvent, ReaderLocationChangeEvent } from '@ankhorage/zora';\nimport type { DOMProps } from 'expo/dom';\n\nexport interface ReaderAppearance {\n  readonly colorScheme: 'dark' | 'light' | 'sepia' | 'system';\n  readonly fontScale: number;\n  readonly lineHeight: number;\n}\n\nexport interface ReaderCommand {\n  readonly id: number;\n  readonly sourceUri: string;\n  readonly type: 'next' | 'previous';\n}\n\nexport interface ReaderViewportState {\n  readonly canGoNext: boolean;\n  readonly canGoPrevious: boolean;\n  readonly location?: ReaderLocationChangeEvent;\n  readonly page: number;\n  readonly pageCount?: number;\n  readonly progress: number;\n  readonly status: 'loading' | 'ready';\n}\n\nexport interface ReaderViewportProps {\n  readonly appearance: ReaderAppearance;\n  readonly command?: ReaderCommand;\n  readonly format: 'epub' | 'pdf';\n  readonly initialLocation?: string;\n  readonly onError: (event: ReaderErrorEvent) => Promise<void>;\n  readonly onOpenExternalLink: (event: { readonly url: string }) => Promise<void>;\n  readonly onStateChange: (state: ReaderViewportState) => Promise<void>;\n  readonly sourceUri: string;\n  readonly dom?: DOMProps;\n}\n\nexport interface ReaderDriverState {\n  readonly canGoNext: boolean;\n  readonly canGoPrevious: boolean;\n  readonly chapterId?: string;\n  readonly chapterTitle?: string;\n  readonly locator: string;\n  readonly page: number;\n  readonly pageCount?: number;\n  readonly progression: number;\n}\n\nexport interface ReaderDriver {\n  readonly direction: 'ltr' | 'rtl';\n  destroy(): Promise<void>;\n  getState(): ReaderDriverState;\n  goNext(trigger: ReaderLocationChangeEvent['trigger']): Promise<void>;\n  goPrevious(trigger: ReaderLocationChangeEvent['trigger']): Promise<void>;\n}\n\nexport interface ReaderTouchStart {\n  readonly interactive: boolean;\n  readonly x: number;\n  readonly y: number;\n}\n"]}

package/dist/reader/validateEpubArchiveEntriesAsync.d.ts

@@ -0,0 +1,3 @@
+import type { Entry } from '@zip.js/zip.js';
+export declare function validateEpubArchiveEntriesAsync(entries: readonly Entry[], signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=validateEpubArchiveEntriesAsync.d.ts.map

package/dist/reader/validateEpubArchiveEntriesAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateEpubArchiveEntriesAsync.d.ts","sourceRoot":"","sources":["../../src/reader/validateEpubArchiveEntriesAsync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAQ5C,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,SAAS,KAAK,EAAE,EACzB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAkDf"}

package/dist/reader/validateEpubArchiveEntriesAsync.js

@@ -0,0 +1,48 @@
+import { Uint8ArrayWriter } from '@zip.js/zip.js';
+const MAX_COMPRESSION_RATIO = 100;
+const MAX_ENTRY_COUNT = 10_000;
+const MAX_ENTRY_UNCOMPRESSED_BYTES = 64 * 1024 * 1024;
+const MAX_TOTAL_UNCOMPRESSED_BYTES = 512 * 1024 * 1024;
+export async function validateEpubArchiveEntriesAsync(entries, signal) {
+    if (entries.length > MAX_ENTRY_COUNT) {
+        throw new Error(`EPUB archive exceeds the ${MAX_ENTRY_COUNT}-entry limit.`);
+    }
+    let totalUncompressedBytes = 0;
+    for (const entry of entries) {
+        validateDeclaredSizes(entry);
+        if (entry.directory) {
+            continue;
+        }
+        if (entry.uncompressedSize > MAX_ENTRY_UNCOMPRESSED_BYTES) {
+            throw new Error(`EPUB archive entry "${entry.filename}" exceeds the ${MAX_ENTRY_UNCOMPRESSED_BYTES}-byte uncompressed limit.`);
+        }
+        if (entry.uncompressedSize > 0 &&
+            (entry.compressedSize === 0 ||
+                entry.uncompressedSize > entry.compressedSize * MAX_COMPRESSION_RATIO)) {
+            throw new Error(`EPUB archive entry "${entry.filename}" exceeds the ${MAX_COMPRESSION_RATIO}:1 compression-ratio limit.`);
+        }
+        if (totalUncompressedBytes > MAX_TOTAL_UNCOMPRESSED_BYTES - entry.uncompressedSize) {
+            throw new Error(`EPUB archive exceeds the ${MAX_TOTAL_UNCOMPRESSED_BYTES}-byte aggregate uncompressed limit.`);
+        }
+        totalUncompressedBytes += entry.uncompressedSize;
+    }
+    for (const entry of entries) {
+        if (entry.directory) {
+            continue;
+        }
+        await entry.getData(new Uint8ArrayWriter(), {
+            checkOverlappingEntryOnly: true,
+            signal,
+            strictness: 'strict',
+        });
+    }
+}
+function validateDeclaredSizes(entry) {
+    if (!Number.isSafeInteger(entry.compressedSize) ||
+        entry.compressedSize < 0 ||
+        !Number.isSafeInteger(entry.uncompressedSize) ||
+        entry.uncompressedSize < 0) {
+        throw new Error(`EPUB archive entry "${entry.filename}" declares invalid sizes.`);
+    }
+}
+//# sourceMappingURL=validateEpubArchiveEntriesAsync.js.map

package/dist/reader/validateEpubArchiveEntriesAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateEpubArchiveEntriesAsync.js","sourceRoot":"","sources":["../../src/reader/validateEpubArchiveEntriesAsync.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,4BAA4B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AACtD,MAAM,4BAA4B,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,OAAyB,EACzB,MAAoB;IAEpB,IAAI,OAAO,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,4BAA4B,eAAe,eAAe,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,sBAAsB,GAAG,CAAC,CAAC;IAE/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAE7B,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,gBAAgB,GAAG,4BAA4B,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CACb,uBAAuB,KAAK,CAAC,QAAQ,iBAAiB,4BAA4B,2BAA2B,CAC9G,CAAC;QACJ,CAAC;QAED,IACE,KAAK,CAAC,gBAAgB,GAAG,CAAC;YAC1B,CAAC,KAAK,CAAC,cAAc,KAAK,CAAC;gBACzB,KAAK,CAAC,gBAAgB,GAAG,KAAK,CAAC,cAAc,GAAG,qBAAqB,CAAC,EACxE,CAAC;YACD,MAAM,IAAI,KAAK,CACb,uBAAuB,KAAK,CAAC,QAAQ,iBAAiB,qBAAqB,6BAA6B,CACzG,CAAC;QACJ,CAAC;QAED,IAAI,sBAAsB,GAAG,4BAA4B,GAAG,KAAK,CAAC,gBAAgB,EAAE,CAAC;YACnF,MAAM,IAAI,KAAK,CACb,4BAA4B,4BAA4B,qCAAqC,CAC9F,CAAC;QACJ,CAAC;QAED,sBAAsB,IAAI,KAAK,CAAC,gBAAgB,CAAC;IACnD,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,SAAS;QACX,CAAC;QAED,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,gBAAgB,EAAE,EAAE;YAC1C,yBAAyB,EAAE,IAAI;YAC/B,MAAM;YACN,UAAU,EAAE,QAAQ;SACrB,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAY;IACzC,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,cAAc,CAAC;QAC3C,KAAK,CAAC,cAAc,GAAG,CAAC;QACxB,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,gBAAgB,CAAC;QAC7C,KAAK,CAAC,gBAAgB,GAAG,CAAC,EAC1B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,CAAC,QAAQ,2BAA2B,CAAC,CAAC;IACpF,CAAC;AACH,CAAC","sourcesContent":["import type { Entry } from '@zip.js/zip.js';\nimport { Uint8ArrayWriter } from '@zip.js/zip.js';\n\nconst MAX_COMPRESSION_RATIO = 100;\nconst MAX_ENTRY_COUNT = 10_000;\nconst MAX_ENTRY_UNCOMPRESSED_BYTES = 64 * 1024 * 1024;\nconst MAX_TOTAL_UNCOMPRESSED_BYTES = 512 * 1024 * 1024;\n\nexport async function validateEpubArchiveEntriesAsync(\n  entries: readonly Entry[],\n  signal?: AbortSignal,\n): Promise<void> {\n  if (entries.length > MAX_ENTRY_COUNT) {\n    throw new Error(`EPUB archive exceeds the ${MAX_ENTRY_COUNT}-entry limit.`);\n  }\n\n  let totalUncompressedBytes = 0;\n\n  for (const entry of entries) {\n    validateDeclaredSizes(entry);\n\n    if (entry.directory) {\n      continue;\n    }\n\n    if (entry.uncompressedSize > MAX_ENTRY_UNCOMPRESSED_BYTES) {\n      throw new Error(\n        `EPUB archive entry \"${entry.filename}\" exceeds the ${MAX_ENTRY_UNCOMPRESSED_BYTES}-byte uncompressed limit.`,\n      );\n    }\n\n    if (\n      entry.uncompressedSize > 0 &&\n      (entry.compressedSize === 0 ||\n        entry.uncompressedSize > entry.compressedSize * MAX_COMPRESSION_RATIO)\n    ) {\n      throw new Error(\n        `EPUB archive entry \"${entry.filename}\" exceeds the ${MAX_COMPRESSION_RATIO}:1 compression-ratio limit.`,\n      );\n    }\n\n    if (totalUncompressedBytes > MAX_TOTAL_UNCOMPRESSED_BYTES - entry.uncompressedSize) {\n      throw new Error(\n        `EPUB archive exceeds the ${MAX_TOTAL_UNCOMPRESSED_BYTES}-byte aggregate uncompressed limit.`,\n      );\n    }\n\n    totalUncompressedBytes += entry.uncompressedSize;\n  }\n\n  for (const entry of entries) {\n    if (entry.directory) {\n      continue;\n    }\n\n    await entry.getData(new Uint8ArrayWriter(), {\n      checkOverlappingEntryOnly: true,\n      signal,\n      strictness: 'strict',\n    });\n  }\n}\n\nfunction validateDeclaredSizes(entry: Entry): void {\n  if (\n    !Number.isSafeInteger(entry.compressedSize) ||\n    entry.compressedSize < 0 ||\n    !Number.isSafeInteger(entry.uncompressedSize) ||\n    entry.uncompressedSize < 0\n  ) {\n    throw new Error(`EPUB archive entry \"${entry.filename}\" declares invalid sizes.`);\n  }\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/expo-runtime",
   "type": "module",
-  "version": "3.1.1",
+  "version": "3.2.0",
   "description": "Declarative runtime integration for Expo apps: maps app capabilities to permissions, packages, config plugins, providers, and adapters",
   "homepage": "https://github.com/ankhorage/expo-runtime#readme",
   "bugs": {
@@ -121,13 +121,15 @@
     "validate:expo-platform": "bun scripts/validateExpoPlatform.ts",
     "validate:headless-platform": "bun scripts/headlessPlatformAcceptance.ts",
     "validate:packed-runtime": "bun scripts/packedRuntimeAcceptance.ts",
+    "validate:reader-dom": "bun scripts/readerDomAcceptance.ts",
     "validate:web-barcode": "bun scripts/webBarcodeAcceptance.ts",
     "version-packages": "ankhorage-changeset version"
   },
   "peerDependencies": {
     "@ankhorage/permissions": "^0.2.3",
-    "@ankhorage/zora": "^3.0.2",
+    "@ankhorage/zora": "^3.1.0",
     "@readium/navigator": "2.8.2",
+    "@readium/shared": "2.4.0",
     "@react-native-vector-icons/fontawesome": "^13.1.3",
     "@react-native-vector-icons/fontawesome5": "^13.1.3",
     "@react-native-vector-icons/fontawesome6": "^13.1.3",
@@ -155,6 +157,9 @@
     "@readium/navigator": {
       "optional": true
     },
+    "@readium/shared": {
+      "optional": true
+    },
     "@react-native-vector-icons/fontawesome": {
       "optional": true
     },
@@ -205,11 +210,12 @@
     }
   },
   "devDependencies": {
-    "@ankhorage/devtools": "^1.8.2",
+    "@ankhorage/devtools": "^1.8.3",
     "@ankhorage/paradox": "^0.1.24",
     "@ankhorage/permissions": "^0.2.3",
-    "@ankhorage/zora": "^3.0.2",
+    "@ankhorage/zora": "^3.1.0",
     "@readium/navigator": "2.8.2",
+    "@readium/shared": "2.4.0",
     "@react-native-picker/picker": "2.11.4",
     "@react-native-vector-icons/fontawesome": "^13.1.3",
     "@react-native-vector-icons/fontawesome5": "^13.1.3",
@@ -221,6 +227,7 @@
     "@types/node": "^24.13.3",
     "@types/pngjs": "^6.0.5",
     "@types/react": "^19.2.18",
+    "@xmldom/xmldom": "0.9.10",
     "bwip-js": "^4.11.4",
     "expo": "57.0.18",
     "expo-camera": "~57.0.4",

package/src/createExpoRuntimeRegistry.test.tsx

@@ -4,20 +4,26 @@ import React from 'react';
 const BaseBarcodeScannerView = (): React.ReactElement => React.createElement(React.Fragment);
 const BaseText = (): React.ReactElement => React.createElement(React.Fragment);
 const MockExpoBarcodeScannerAdapter = (): React.ReactElement => React.createElement(React.Fragment);
+const BaseReaderSurface = (): React.ReactElement => React.createElement(React.Fragment);
+const MockExpoReaderSurfaceAdapter = (): React.ReactElement => React.createElement(React.Fragment);
 
 describe('createExpoRuntimeRegistry', () => {
   afterEach(() => {
     mock.restore();
   });
 
-  it('overrides BarcodeScannerView while preserving unrelated registry entries', async () => {
+  it('overrides platform-owned views while preserving unrelated registry entries', async () => {
     void mock.module('./ExpoBarcodeScannerAdapter', () => ({
       ExpoBarcodeScannerAdapter: MockExpoBarcodeScannerAdapter,
     }));
+    void mock.module('./reader/ExpoReaderSurfaceAdapter', () => ({
+      ExpoReaderSurfaceAdapter: MockExpoReaderSurfaceAdapter,
+    }));
 
     const { createExpoRuntimeRegistry } = await import('./createExpoRuntimeRegistry');
     const baseRegistry = {
       BarcodeScannerView: BaseBarcodeScannerView,
+      ReaderSurface: BaseReaderSurface,
       Text: BaseText,
     };
 
@@ -27,5 +33,7 @@ describe('createExpoRuntimeRegistry', () => {
     expect(registry.Text).toBe(BaseText);
     expect(registry.BarcodeScannerView).not.toBe(BaseBarcodeScannerView);
     expect(typeof registry.BarcodeScannerView).toBe('function');
+    expect(registry.ReaderSurface).not.toBe(BaseReaderSurface);
+    expect(typeof registry.ReaderSurface).toBe('function');
   });
 });

package/src/createExpoRuntimeRegistry.tsx

@@ -1,11 +1,13 @@
-import { type BarcodeScannerViewProps } from '@ankhorage/zora';
+import { type BarcodeScannerViewProps, type ReaderSurfaceProps } from '@ankhorage/zora';
 import React from 'react';
 
 import { type ComponentRegistry, createComponentRegistry } from './componentRegistry';
 import { ExpoBarcodeScannerAdapter } from './ExpoBarcodeScannerAdapter';
+import { ExpoReaderSurfaceAdapter } from './reader/ExpoReaderSurfaceAdapter';
 
 const EXPO_RUNTIME_OVERRIDES: ComponentRegistry = {
   BarcodeScannerView: ExpoBarcodeScannerView,
+  ReaderSurface: ExpoReaderSurface,
 };
 
 export function createExpoRuntimeRegistry(baseRegistry: ComponentRegistry): ComponentRegistry {
@@ -15,3 +17,7 @@ export function createExpoRuntimeRegistry(baseRegistry: ComponentRegistry): Comp
 function ExpoBarcodeScannerView(props: BarcodeScannerViewProps) {
   return <ExpoBarcodeScannerAdapter {...props} />;
 }
+
+function ExpoReaderSurface(props: ReaderSurfaceProps) {
+  return <ExpoReaderSurfaceAdapter {...props} />;
+}

package/src/expoRuntimePlanningMetadata.ts

@@ -13,7 +13,7 @@ export interface ExpoRuntimeConfigPlugin {
 }
 
 export type ExpoRuntimeProviderId = 'permissions';
-export type ExpoRuntimeAdapterId = 'ExpoBarcodeScannerAdapter';
+export type ExpoRuntimeAdapterId = 'ExpoBarcodeScannerAdapter' | 'ExpoReaderSurfaceAdapter';
 
 export interface ExpoRuntimeDiagnostic {
   readonly severity: 'error' | 'warning';
@@ -40,6 +40,10 @@ export interface ExpoRuntimeHintMetadata {
 const GENERATED_ANKHORAGE_DEPENDENCY_VERSIONS = {
   '@ankhorage/permissions': '^0.2.3',
   '@ankhorage/expo-runtime': '^3.0.0',
+  '@readium/navigator': '2.8.2',
+  '@readium/shared': '2.4.0',
+  '@zip.js/zip.js': '2.9.0',
+  'pdfjs-dist': '6.3.289',
 } as const satisfies Record<string, string>;
 
 const GENERATED_EXPO_DEPENDENCY_VERSIONS = Object.fromEntries(
@@ -148,6 +152,10 @@ export const EXPO_CAPABILITY_RUNTIME_REGISTRY = {
       },
     ],
   },
+  ebookReader: {
+    requiredPackages: ['@readium/navigator', '@readium/shared', '@zip.js/zip.js', 'pdfjs-dist'],
+    runtimeAdapters: ['ExpoReaderSurfaceAdapter'],
+  },
 } as const satisfies Readonly<
   Partial<Record<AnkhorageCapabilityName, ExpoRuntimeCapabilityMetadata>>
 >;

package/src/index.ts

@@ -53,6 +53,7 @@ export {
   type ExpoRuntimeLayoutIntegrationPlan,
   resolveExpoRuntimeLayoutIntegration,
 } from './layoutIntegrationPlanning';
+export { ExpoReaderSurfaceAdapter } from './reader/ExpoReaderSurfaceAdapter';
 export type {
   ExpoRuntimeAdapterId,
   ExpoRuntimePlan,

package/src/reader/ExpoReaderSurfaceAdapter.tsx

@@ -0,0 +1,170 @@
+import { type ReaderErrorEvent, ReaderSurface, type ReaderSurfaceProps } from '@ankhorage/zora';
+import React from 'react';
+import { Image, StyleSheet, View } from 'react-native';
+
+import ReaderViewport from './ReaderViewport';
+import type { ReaderAppearance, ReaderCommand, ReaderViewportState } from './types';
+
+const INITIAL_STATE: ReaderViewportState = {
+  canGoNext: false,
+  canGoPrevious: false,
+  page: 1,
+  progress: 0,
+  status: 'loading',
+};
+
+export function ExpoReaderSurfaceAdapter(props: ReaderSurfaceProps) {
+  const sourceUri = resolveReaderSourceUri(props.source);
+  const controller = useReaderController(props, sourceUri);
+  const appearance = useReaderAppearance(props);
+  const viewport = sourceUri ? (
+    <ReaderAdapterViewport
+      appearance={appearance}
+      command={controller.command}
+      format={props.format}
+      initialLocation={props.location}
+      onError={controller.handleError}
+      onOpenExternalLink={controller.handleOpenExternalLink}
+      onStateChange={controller.handleStateChange}
+      sourceUri={sourceUri}
+    />
+  ) : undefined;
+
+  return (
+    <ReaderSurface
+      {...props}
+      canGoNext={controller.state.canGoNext}
+      canGoPrevious={controller.state.canGoPrevious}
+      chapterLabel={controller.state.location?.chapterTitle ?? props.chapterLabel}
+      onNextPage={controller.handleNextPage}
+      onPreviousPage={controller.handlePreviousPage}
+      page={controller.state.page}
+      pageCount={controller.state.pageCount}
+      progress={controller.state.progress}
+      status={controller.error ? 'error' : sourceUri ? controller.state.status : 'idle'}
+      viewport={viewport}
+    />
+  );
+}
+
+function ReaderAdapterViewport({
+  appearance,
+  command,
+  format,
+  initialLocation,
+  onError,
+  onOpenExternalLink,
+  onStateChange,
+  sourceUri,
+}: React.ComponentProps<typeof ReaderViewport>) {
+  return (
+    <View style={styles.viewport}>
+      <ReaderViewport
+        appearance={appearance}
+        command={command}
+        dom={DOM_CONFIGURATION}
+        format={format}
+        initialLocation={initialLocation}
+        key={`${format}:${sourceUri}`}
+        onError={onError}
+        onOpenExternalLink={onOpenExternalLink}
+        onStateChange={onStateChange}
+        sourceUri={sourceUri}
+      />
+    </View>
+  );
+}
+
+function useReaderController(props: ReaderSurfaceProps, sourceUri: string | undefined) {
+  const { onLocationChange, onNextPage, onOpenExternalLink, onPreviousPage, onReaderError } = props;
+  const [state, setState] = React.useState<ReaderViewportState>(INITIAL_STATE);
+  const [error, setError] = React.useState<ReaderErrorEvent>();
+  const { command, issueCommand } = useReaderCommandState(sourceUri);
+  const handlePreviousPage = React.useCallback(() => {
+    issueCommand('previous');
+    void onPreviousPage?.();
+  }, [issueCommand, onPreviousPage]);
+  const handleNextPage = React.useCallback(() => {
+    issueCommand('next');
+    void onNextPage?.();
+  }, [issueCommand, onNextPage]);
+  const handleStateChange = React.useCallback(
+    async (nextState: ReaderViewportState) => {
+      setState(nextState);
+      setError(undefined);
+      if (nextState.location) await onLocationChange?.(nextState.location);
+    },
+    [onLocationChange],
+  );
+  const handleError = React.useCallback(
+    async (event: ReaderErrorEvent) => {
+      setError(event);
+      await onReaderError?.(event);
+    },
+    [onReaderError],
+  );
+  const handleOpenExternalLink = React.useCallback(
+    async (event: { readonly url: string }) => onOpenExternalLink?.(event),
+    [onOpenExternalLink],
+  );
+  return {
+    command,
+    error,
+    handleError,
+    handleNextPage,
+    handleOpenExternalLink,
+    handlePreviousPage,
+    handleStateChange,
+    state,
+  };
+}
+
+function useReaderCommandState(sourceUri: string | undefined) {
+  const [command, setCommand] = React.useState<ReaderCommand>();
+  const commandIdRef = React.useRef(0);
+  const issueCommand = React.useCallback(
+    (type: ReaderCommand['type']) => {
+      if (!sourceUri) return;
+      commandIdRef.current += 1;
+      setCommand({ id: commandIdRef.current, sourceUri, type });
+    },
+    [sourceUri],
+  );
+  return { command, issueCommand };
+}
+
+function useReaderAppearance(props: ReaderSurfaceProps): ReaderAppearance {
+  const colorScheme = props.readerColorScheme ?? 'system';
+  const fontScale = props.fontScale ?? 1;
+  const lineHeight = resolveLineHeight(props.lineHeight ?? 'normal');
+  return React.useMemo(
+    () => ({ colorScheme, fontScale, lineHeight }),
+    [colorScheme, fontScale, lineHeight],
+  );
+}
+
+function resolveReaderSourceUri(source: ReaderSurfaceProps['source']): string | undefined {
+  if (typeof source === 'string') return source;
+  if (typeof source === 'number') return Image.resolveAssetSource(source).uri;
+  return source ? source.uri : undefined;
+}
+
+function resolveLineHeight(lineHeight: NonNullable<ReaderSurfaceProps['lineHeight']>): number {
+  if (lineHeight === 'compact') return 1.25;
+  if (lineHeight === 'relaxed') return 1.75;
+  return 1.5;
+}
+
+const styles = StyleSheet.create({
+  viewport: { flex: 1, minHeight: 360 },
+});
+
+const DOM_CONFIGURATION = {
+  allowsInlineMediaPlayback: false,
+  javaScriptCanOpenWindowsAutomatically: false,
+  mediaPlaybackRequiresUserAction: true,
+  originWhitelist: ['about:blank', 'blob:*'],
+  scrollEnabled: false,
+  style: styles.viewport,
+  unstable_useExpoModulesBridge: false,
+};

package/src/reader/ReaderDocumentError.ts

@@ -0,0 +1,11 @@
+import type { ReaderErrorCode } from '@ankhorage/zora';
+
+export class ReaderDocumentError extends Error {
+  constructor(
+    readonly code: ReaderErrorCode,
+    message: string,
+  ) {
+    super(message);
+    this.name = 'ReaderDocumentError';
+  }
+}