@ankhorage/expo-runtime 3.1.0 → 3.1.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @ankhorage/expo-runtime
 
+## 3.1.1
+
+### Patch Changes
+
+- 979cb5b: Pin the audited EPUB/PDF renderer foundations and document the isolated DOM, content-safety, and deterministic fixture contract for the reader adapter.
+- 162fb2a: Update Ankhorage dependencies: `@ankhorage/contracts`.
+
 ## 3.1.0
 
 ### Minor Changes

package/dist/reader/navigation/resolveReaderKeyboardIntent.d.ts

@@ -0,0 +1,9 @@
+export declare function resolveReaderKeyboardIntent(input: {
+    canGoNext: boolean;
+    canGoPrevious: boolean;
+    direction: 'ltr' | 'rtl';
+    hasModifier?: boolean;
+    isInteractiveTarget?: boolean;
+    key: string;
+}): 'next' | 'previous' | null;
+//# sourceMappingURL=resolveReaderKeyboardIntent.d.ts.map

package/dist/reader/navigation/resolveReaderKeyboardIntent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveReaderKeyboardIntent.d.ts","sourceRoot":"","sources":["../../../src/reader/navigation/resolveReaderKeyboardIntent.ts"],"names":[],"mappings":"AAAA,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAY7B"}

package/dist/reader/navigation/resolveReaderKeyboardIntent.js

@@ -0,0 +1,19 @@
+export function resolveReaderKeyboardIntent(input) {
+    if (input.hasModifier || input.isInteractiveTarget)
+        return null;
+    let intent = null;
+    if (input.key === 'PageUp')
+        intent = 'previous';
+    if (input.key === 'PageDown')
+        intent = 'next';
+    if (input.key === 'ArrowLeft')
+        intent = input.direction === 'ltr' ? 'previous' : 'next';
+    if (input.key === 'ArrowRight')
+        intent = input.direction === 'ltr' ? 'next' : 'previous';
+    if (intent === 'next')
+        return input.canGoNext ? intent : null;
+    if (intent === 'previous')
+        return input.canGoPrevious ? intent : null;
+    return null;
+}
+//# sourceMappingURL=resolveReaderKeyboardIntent.js.map

package/dist/reader/navigation/resolveReaderKeyboardIntent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveReaderKeyboardIntent.js","sourceRoot":"","sources":["../../../src/reader/navigation/resolveReaderKeyboardIntent.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,2BAA2B,CAAC,KAO3C;IACC,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,mBAAmB;QAAE,OAAO,IAAI,CAAC;IAEhE,IAAI,MAAM,GAA+B,IAAI,CAAC;IAC9C,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ;QAAE,MAAM,GAAG,UAAU,CAAC;IAChD,IAAI,KAAK,CAAC,GAAG,KAAK,UAAU;QAAE,MAAM,GAAG,MAAM,CAAC;IAC9C,IAAI,KAAK,CAAC,GAAG,KAAK,WAAW;QAAE,MAAM,GAAG,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;IACxF,IAAI,KAAK,CAAC,GAAG,KAAK,YAAY;QAAE,MAAM,GAAG,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;IAEzF,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACtE,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["export function resolveReaderKeyboardIntent(input: {\n  canGoNext: boolean;\n  canGoPrevious: boolean;\n  direction: 'ltr' | 'rtl';\n  hasModifier?: boolean;\n  isInteractiveTarget?: boolean;\n  key: string;\n}): 'next' | 'previous' | null {\n  if (input.hasModifier || input.isInteractiveTarget) return null;\n\n  let intent: 'next' | 'previous' | null = null;\n  if (input.key === 'PageUp') intent = 'previous';\n  if (input.key === 'PageDown') intent = 'next';\n  if (input.key === 'ArrowLeft') intent = input.direction === 'ltr' ? 'previous' : 'next';\n  if (input.key === 'ArrowRight') intent = input.direction === 'ltr' ? 'next' : 'previous';\n\n  if (intent === 'next') return input.canGoNext ? intent : null;\n  if (intent === 'previous') return input.canGoPrevious ? intent : null;\n  return null;\n}\n"]}

package/dist/reader/navigation/resolveReaderNavigationIntent.d.ts

@@ -0,0 +1,11 @@
+export declare function resolveReaderNavigationIntent(input: {
+    canGoNext: boolean;
+    canGoPrevious: boolean;
+    deltaX: number;
+    deltaY: number;
+    direction: 'ltr' | 'rtl';
+    hasSelection?: boolean;
+    isInteractiveTarget?: boolean;
+    viewportWidth: number;
+}): 'next' | 'previous' | null;
+//# sourceMappingURL=resolveReaderNavigationIntent.d.ts.map

package/dist/reader/navigation/resolveReaderNavigationIntent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveReaderNavigationIntent.d.ts","sourceRoot":"","sources":["../../../src/reader/navigation/resolveReaderNavigationIntent.ts"],"names":[],"mappings":"AAAA,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAa7B"}

package/dist/reader/navigation/resolveReaderNavigationIntent.js

@@ -0,0 +1,16 @@
+export function resolveReaderNavigationIntent(input) {
+    if (input.hasSelection || input.isInteractiveTarget)
+        return null;
+    const horizontalDistance = Math.abs(input.deltaX);
+    const verticalDistance = Math.abs(input.deltaY);
+    const distanceThreshold = Math.max(48, input.viewportWidth * 0.15);
+    if (horizontalDistance <= verticalDistance * 1.25)
+        return null;
+    if (horizontalDistance <= distanceThreshold)
+        return null;
+    const movesForward = input.direction === 'ltr' ? input.deltaX < 0 : input.deltaX > 0;
+    if (movesForward)
+        return input.canGoNext ? 'next' : null;
+    return input.canGoPrevious ? 'previous' : null;
+}
+//# sourceMappingURL=resolveReaderNavigationIntent.js.map

package/dist/reader/navigation/resolveReaderNavigationIntent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveReaderNavigationIntent.js","sourceRoot":"","sources":["../../../src/reader/navigation/resolveReaderNavigationIntent.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,6BAA6B,CAAC,KAS7C;IACC,IAAI,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,mBAAmB;QAAE,OAAO,IAAI,CAAC;IAEjE,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAEnE,IAAI,kBAAkB,IAAI,gBAAgB,GAAG,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/D,IAAI,kBAAkB,IAAI,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAEzD,MAAM,YAAY,GAAG,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACrF,IAAI,YAAY;QAAE,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,OAAO,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC","sourcesContent":["export function resolveReaderNavigationIntent(input: {\n  canGoNext: boolean;\n  canGoPrevious: boolean;\n  deltaX: number;\n  deltaY: number;\n  direction: 'ltr' | 'rtl';\n  hasSelection?: boolean;\n  isInteractiveTarget?: boolean;\n  viewportWidth: number;\n}): 'next' | 'previous' | null {\n  if (input.hasSelection || input.isInteractiveTarget) return null;\n\n  const horizontalDistance = Math.abs(input.deltaX);\n  const verticalDistance = Math.abs(input.deltaY);\n  const distanceThreshold = Math.max(48, input.viewportWidth * 0.15);\n\n  if (horizontalDistance <= verticalDistance * 1.25) return null;\n  if (horizontalDistance <= distanceThreshold) return null;\n\n  const movesForward = input.direction === 'ltr' ? input.deltaX < 0 : input.deltaX > 0;\n  if (movesForward) return input.canGoNext ? 'next' : null;\n  return input.canGoPrevious ? 'previous' : null;\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/expo-runtime",
   "type": "module",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "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": {
@@ -25,7 +25,7 @@
     "runtime"
   ],
   "dependencies": {
-    "@ankhorage/contracts": "^8.0.0"
+    "@ankhorage/contracts": "^8.0.1"
   },
   "files": [
     "dist",
@@ -127,11 +127,13 @@
   "peerDependencies": {
     "@ankhorage/permissions": "^0.2.3",
     "@ankhorage/zora": "^3.0.2",
+    "@readium/navigator": "2.8.2",
     "@react-native-vector-icons/fontawesome": "^13.1.3",
     "@react-native-vector-icons/fontawesome5": "^13.1.3",
     "@react-native-vector-icons/fontawesome6": "^13.1.3",
     "@react-native-vector-icons/ionicons": "^13.1.3",
     "@react-native-vector-icons/material-design-icons": "^13.1.3",
+    "@zip.js/zip.js": "2.9.0",
     "expo": "57.0.18",
     "expo-camera": "~57.0.4",
     "expo-constants": "~57.0.16",
@@ -139,6 +141,7 @@
     "expo-file-system": "~57.0.6",
     "expo-font": "~57.0.2",
     "expo-image-picker": "~57.0.14",
+    "pdfjs-dist": "6.3.289",
     "react": "19.2.3",
     "react-native": "0.86.3"
   },
@@ -149,6 +152,9 @@
     "@ankhorage/zora": {
       "optional": true
     },
+    "@readium/navigator": {
+      "optional": true
+    },
     "@react-native-vector-icons/fontawesome": {
       "optional": true
     },
@@ -164,6 +170,9 @@
     "@react-native-vector-icons/material-design-icons": {
       "optional": true
     },
+    "@zip.js/zip.js": {
+      "optional": true
+    },
     "expo": {
       "optional": true
     },
@@ -185,6 +194,9 @@
     "expo-image-picker": {
       "optional": true
     },
+    "pdfjs-dist": {
+      "optional": true
+    },
     "react": {
       "optional": true
     },
@@ -197,12 +209,14 @@
     "@ankhorage/paradox": "^0.1.24",
     "@ankhorage/permissions": "^0.2.3",
     "@ankhorage/zora": "^3.0.2",
+    "@readium/navigator": "2.8.2",
     "@react-native-picker/picker": "2.11.4",
     "@react-native-vector-icons/fontawesome": "^13.1.3",
     "@react-native-vector-icons/fontawesome5": "^13.1.3",
     "@react-native-vector-icons/fontawesome6": "^13.1.3",
     "@react-native-vector-icons/ionicons": "^13.1.3",
     "@react-native-vector-icons/material-design-icons": "^13.1.3",
+    "@zip.js/zip.js": "2.9.0",
     "@types/bun": "^1.4.0",
     "@types/node": "^24.13.3",
     "@types/pngjs": "^6.0.5",
@@ -220,6 +234,7 @@
     "react-native": "0.86.3",
     "react-native-safe-area-context": "~5.7.0",
     "react-native-web": "~0.21.0",
+    "pdfjs-dist": "6.3.289",
     "playwright-core": "^1.62.1",
     "pngjs": "^7.0.0",
     "typescript": "~6.0.3"

package/src/reader/navigation/resolveReaderKeyboardIntent.test.ts

@@ -0,0 +1,38 @@
+import { describe, expect, test } from 'bun:test';
+
+import { resolveReaderKeyboardIntent } from './resolveReaderKeyboardIntent';
+
+const defaultInput = {
+  canGoNext: true,
+  canGoPrevious: true,
+  direction: 'ltr' as const,
+  key: 'ArrowRight',
+};
+
+describe('resolveReaderKeyboardIntent', () => {
+  test('maps directional keys in LTR and RTL publications', () => {
+    expect(resolveReaderKeyboardIntent(defaultInput)).toBe('next');
+    expect(resolveReaderKeyboardIntent({ ...defaultInput, key: 'ArrowLeft' })).toBe('previous');
+    expect(resolveReaderKeyboardIntent({ ...defaultInput, direction: 'rtl' })).toBe('previous');
+    expect(
+      resolveReaderKeyboardIntent({ ...defaultInput, direction: 'rtl', key: 'ArrowLeft' }),
+    ).toBe('next');
+  });
+
+  test('keeps PageUp and PageDown tied to logical page order', () => {
+    expect(resolveReaderKeyboardIntent({ ...defaultInput, key: 'PageUp' })).toBe('previous');
+    expect(
+      resolveReaderKeyboardIntent({ ...defaultInput, direction: 'rtl', key: 'PageDown' }),
+    ).toBe('next');
+  });
+
+  test('ignores modified, interactive, unsupported, and boundary input', () => {
+    expect(resolveReaderKeyboardIntent({ ...defaultInput, hasModifier: true })).toBeNull();
+    expect(resolveReaderKeyboardIntent({ ...defaultInput, isInteractiveTarget: true })).toBeNull();
+    expect(resolveReaderKeyboardIntent({ ...defaultInput, key: 'Enter' })).toBeNull();
+    expect(resolveReaderKeyboardIntent({ ...defaultInput, canGoNext: false })).toBeNull();
+    expect(
+      resolveReaderKeyboardIntent({ ...defaultInput, canGoPrevious: false, key: 'ArrowLeft' }),
+    ).toBeNull();
+  });
+});

package/src/reader/navigation/resolveReaderKeyboardIntent.ts

@@ -0,0 +1,20 @@
+export function resolveReaderKeyboardIntent(input: {
+  canGoNext: boolean;
+  canGoPrevious: boolean;
+  direction: 'ltr' | 'rtl';
+  hasModifier?: boolean;
+  isInteractiveTarget?: boolean;
+  key: string;
+}): 'next' | 'previous' | null {
+  if (input.hasModifier || input.isInteractiveTarget) return null;
+
+  let intent: 'next' | 'previous' | null = null;
+  if (input.key === 'PageUp') intent = 'previous';
+  if (input.key === 'PageDown') intent = 'next';
+  if (input.key === 'ArrowLeft') intent = input.direction === 'ltr' ? 'previous' : 'next';
+  if (input.key === 'ArrowRight') intent = input.direction === 'ltr' ? 'next' : 'previous';
+
+  if (intent === 'next') return input.canGoNext ? intent : null;
+  if (intent === 'previous') return input.canGoPrevious ? intent : null;
+  return null;
+}

package/src/reader/navigation/resolveReaderNavigationIntent.test.ts

@@ -0,0 +1,48 @@
+import { describe, expect, test } from 'bun:test';
+
+import { resolveReaderNavigationIntent } from './resolveReaderNavigationIntent';
+
+const defaultInput = {
+  canGoNext: true,
+  canGoPrevious: true,
+  deltaX: -49,
+  deltaY: 0,
+  direction: 'ltr' as const,
+  viewportWidth: 300,
+};
+
+describe('resolveReaderNavigationIntent', () => {
+  test('maps one qualified LTR swipe to its logical page direction', () => {
+    expect(resolveReaderNavigationIntent(defaultInput)).toBe('next');
+    expect(resolveReaderNavigationIntent({ ...defaultInput, deltaX: 49 })).toBe('previous');
+  });
+
+  test('inverts horizontal navigation for RTL publications', () => {
+    expect(resolveReaderNavigationIntent({ ...defaultInput, direction: 'rtl' })).toBe('previous');
+    expect(resolveReaderNavigationIntent({ ...defaultInput, deltaX: 49, direction: 'rtl' })).toBe(
+      'next',
+    );
+  });
+
+  test('requires horizontal intent and a strict responsive distance threshold', () => {
+    expect(resolveReaderNavigationIntent({ ...defaultInput, deltaX: -100, deltaY: 80 })).toBeNull();
+    expect(resolveReaderNavigationIntent({ ...defaultInput, deltaX: -48 })).toBeNull();
+    expect(
+      resolveReaderNavigationIntent({ ...defaultInput, deltaX: -60, viewportWidth: 400 }),
+    ).toBeNull();
+    expect(
+      resolveReaderNavigationIntent({ ...defaultInput, deltaX: -61, viewportWidth: 400 }),
+    ).toBe('next');
+  });
+
+  test('does not claim selection, interactive content, or a document boundary', () => {
+    expect(resolveReaderNavigationIntent({ ...defaultInput, hasSelection: true })).toBeNull();
+    expect(
+      resolveReaderNavigationIntent({ ...defaultInput, isInteractiveTarget: true }),
+    ).toBeNull();
+    expect(resolveReaderNavigationIntent({ ...defaultInput, canGoNext: false })).toBeNull();
+    expect(
+      resolveReaderNavigationIntent({ ...defaultInput, canGoPrevious: false, deltaX: 49 }),
+    ).toBeNull();
+  });
+});

package/src/reader/navigation/resolveReaderNavigationIntent.ts

@@ -0,0 +1,23 @@
+export function resolveReaderNavigationIntent(input: {
+  canGoNext: boolean;
+  canGoPrevious: boolean;
+  deltaX: number;
+  deltaY: number;
+  direction: 'ltr' | 'rtl';
+  hasSelection?: boolean;
+  isInteractiveTarget?: boolean;
+  viewportWidth: number;
+}): 'next' | 'previous' | null {
+  if (input.hasSelection || input.isInteractiveTarget) return null;
+
+  const horizontalDistance = Math.abs(input.deltaX);
+  const verticalDistance = Math.abs(input.deltaY);
+  const distanceThreshold = Math.max(48, input.viewportWidth * 0.15);
+
+  if (horizontalDistance <= verticalDistance * 1.25) return null;
+  if (horizontalDistance <= distanceThreshold) return null;
+
+  const movesForward = input.direction === 'ltr' ? input.deltaX < 0 : input.deltaX > 0;
+  if (movesForward) return input.canGoNext ? 'next' : null;
+  return input.canGoPrevious ? 'previous' : null;
+}

package/src/reader/rendererPackages.test.ts

@@ -0,0 +1,22 @@
+import { describe, expect, test } from 'bun:test';
+
+describe('reader renderer package boundary', () => {
+  test('provides the EPUB navigator and archive APIs required by the driver', async () => {
+    const [{ EpubNavigator }, { BlobReader, ZipReader }] = await Promise.all([
+      import('@readium/navigator'),
+      import('@zip.js/zip.js'),
+    ]);
+
+    expect(EpubNavigator).toBeFunction();
+    expect(BlobReader).toBeFunction();
+    expect(ZipReader).toBeFunction();
+  });
+
+  test('provides the PDF loading, worker, and protected-document APIs', async () => {
+    const { getDocument, PasswordException, PDFWorker } = await import('pdfjs-dist');
+
+    expect(getDocument).toBeFunction();
+    expect(PasswordException).toBeFunction();
+    expect(PDFWorker).toBeFunction();
+  });
+});