@ankhorage/zora 25.5.0 → 25.6.2

package/dist/cli/index.d.ts

@@ -1,83 +1,11 @@
+import type { Capability } from '@ankhorage/contracts/capability';
 import { create } from './commands/create';
 import { sync } from './commands/sync';
 declare const provider: {
     id: string;
     category: string;
     version: string;
-    capabilities: readonly [{
-        readonly id: "zora.create";
-        readonly owner: "@ankhorage/zora";
-        readonly access: readonly ["invoke"];
-        readonly binding: {
-            readonly kind: "action";
-            readonly bindableAs: readonly ["target"];
-        };
-        readonly label: "Materialize ZORA web component";
-        readonly description: "Materialize a declared ZORA component and reconcile its web runtime.";
-        readonly input: {
-            readonly schema: {
-                readonly type: "object";
-                readonly required: readonly ["component", "platform"];
-                readonly properties: {
-                    readonly component: {
-                        readonly type: "string";
-                    };
-                    readonly platform: {
-                        readonly type: "string";
-                        readonly const: "web";
-                    };
-                };
-                readonly additionalProperties: false;
-            };
-        };
-        readonly output: {
-            readonly schema: {
-                readonly type: "object";
-                readonly required: readonly ["exitCode"];
-                readonly properties: {
-                    readonly exitCode: {
-                        readonly type: "integer";
-                    };
-                };
-                readonly additionalProperties: false;
-            };
-        };
-    }, {
-        readonly id: "zora.sync";
-        readonly owner: "@ankhorage/zora";
-        readonly access: readonly ["invoke"];
-        readonly binding: {
-            readonly kind: "action";
-            readonly bindableAs: readonly ["target"];
-        };
-        readonly label: "Synchronize ZORA web components";
-        readonly description: "Reconcile the web runtime from the declared ZORA component set.";
-        readonly input: {
-            readonly schema: {
-                readonly type: "object";
-                readonly required: readonly ["platform"];
-                readonly properties: {
-                    readonly platform: {
-                        readonly type: "string";
-                        readonly const: "web";
-                    };
-                };
-                readonly additionalProperties: false;
-            };
-        };
-        readonly output: {
-            readonly schema: {
-                readonly type: "object";
-                readonly required: readonly ["exitCode"];
-                readonly properties: {
-                    readonly exitCode: {
-                        readonly type: "integer";
-                    };
-                };
-                readonly additionalProperties: false;
-            };
-        };
-    }];
+    capabilities: Capability[];
     commands: ({
         readonly path: readonly ["create"];
         readonly capability: "zora.create";

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAavC,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBwB,CAAC;AAEvC,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAGlE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAgBvC,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;CAgBwB,CAAC;AAEvC,eAAe,QAAQ,CAAC"}

package/dist/cli/index.js

@@ -14,11 +14,12 @@ const SYNC_COMMAND = {
     capability: 'zora.sync',
     summary: 'Regenerate the declared ZORA web materialization.',
 };
+const COMMAND_CAPABILITIES = CAPABILITIES.filter((capability) => capability.access.includes('invoke'));
 const provider = {
     id: '@ankhorage/zora',
     category: 'zora',
     version: readPackageVersion(),
-    capabilities: CAPABILITIES,
+    capabilities: COMMAND_CAPABILITIES,
     commands: [CREATE_COMMAND, SYNC_COMMAND],
     handlers: [
         {

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAKzC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,MAAM,cAAc,GAAG;IACrB,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,UAAU,EAAE,aAAwC;IACpD,OAAO,EAAE,+DAA+D;CAChE,CAAC;AACX,MAAM,YAAY,GAAG;IACnB,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,UAAU,EAAE,WAAsC;IAClD,OAAO,EAAE,mDAAmD;CACpD,CAAC;AAEX,MAAM,QAAQ,GAAG;IACf,EAAE,EAAE,iBAAiB;IACrB,QAAQ,EAAE,MAAM;IAChB,OAAO,EAAE,kBAAkB,EAAE;IAC7B,YAAY,EAAE,YAAY;IAC1B,QAAQ,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC;IACxC,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,cAAc,CAAC,IAAI;YACzB,OAAO,EAAE,MAAM;SAChB;QACD;YACE,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,OAAO,EAAE,IAAI;SACd;KACF;CACmC,CAAC;AAEvC,eAAe,QAAQ,CAAC;AAExB,uEAAuE;AACvE,SAAS,kBAAkB;IACzB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC,CAC3D,CAAC;IAEpC,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,WAAW,CAAC,OAAO,CAAC;AAC7B,CAAC","sourcesContent":["import { readFileSync } from 'node:fs';\nimport { dirname, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { AnkhRuntimeCommandProvider } from '@ankhorage/ankh';\nimport type { Capability } from '@ankhorage/contracts/capabilities';\n\nimport { CAPABILITIES } from '../capabilities';\nimport { create } from './commands/create';\nimport { sync } from './commands/sync';\n\nconst CREATE_COMMAND = {\n  path: ['create'],\n  capability: 'zora.create' satisfies Capability['id'],\n  summary: 'Materialize a canonical ZORA component for a target platform.',\n} as const;\nconst SYNC_COMMAND = {\n  path: ['sync'],\n  capability: 'zora.sync' satisfies Capability['id'],\n  summary: 'Regenerate the declared ZORA web materialization.',\n} as const;\n\nconst provider = {\n  id: '@ankhorage/zora',\n  category: 'zora',\n  version: readPackageVersion(),\n  capabilities: CAPABILITIES,\n  commands: [CREATE_COMMAND, SYNC_COMMAND],\n  handlers: [\n    {\n      path: CREATE_COMMAND.path,\n      handler: create,\n    },\n    {\n      path: SYNC_COMMAND.path,\n      handler: sync,\n    },\n  ],\n} satisfies AnkhRuntimeCommandProvider;\n\nexport default provider;\n\n/*** Read the installed ZORA version for the Ankh provider manifest. */\nfunction readPackageVersion(): string {\n  const packageJson = JSON.parse(\n    readFileSync(resolve(dirname(fileURLToPath(import.meta.url)), '../../package.json'), 'utf8'),\n  ) as { readonly version?: unknown };\n\n  if (typeof packageJson.version !== 'string' || packageJson.version.trim() === '') {\n    throw new Error('ZORA package.json must define a non-empty version.');\n  }\n\n  return packageJson.version;\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAKzC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,MAAM,cAAc,GAAG;IACrB,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,UAAU,EAAE,aAAwC;IACpD,OAAO,EAAE,+DAA+D;CAChE,CAAC;AACX,MAAM,YAAY,GAAG;IACnB,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,UAAU,EAAE,WAAsC;IAClD,OAAO,EAAE,mDAAmD;CACpD,CAAC;AACX,MAAM,oBAAoB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAC9D,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CACrC,CAAC;AAEF,MAAM,QAAQ,GAAG;IACf,EAAE,EAAE,iBAAiB;IACrB,QAAQ,EAAE,MAAM;IAChB,OAAO,EAAE,kBAAkB,EAAE;IAC7B,YAAY,EAAE,oBAAoB;IAClC,QAAQ,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC;IACxC,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,cAAc,CAAC,IAAI;YACzB,OAAO,EAAE,MAAM;SAChB;QACD;YACE,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,OAAO,EAAE,IAAI;SACd;KACF;CACmC,CAAC;AAEvC,eAAe,QAAQ,CAAC;AAExB,uEAAuE;AACvE,SAAS,kBAAkB;IACzB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC,CAC3D,CAAC;IAEpC,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,WAAW,CAAC,OAAO,CAAC;AAC7B,CAAC","sourcesContent":["import { readFileSync } from 'node:fs';\nimport { dirname, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { AnkhRuntimeCommandProvider } from '@ankhorage/ankh';\nimport type { Capability } from '@ankhorage/contracts/capability';\n\nimport { CAPABILITIES } from '../capabilities';\nimport { create } from './commands/create';\nimport { sync } from './commands/sync';\n\nconst CREATE_COMMAND = {\n  path: ['create'],\n  capability: 'zora.create' satisfies Capability['id'],\n  summary: 'Materialize a canonical ZORA component for a target platform.',\n} as const;\nconst SYNC_COMMAND = {\n  path: ['sync'],\n  capability: 'zora.sync' satisfies Capability['id'],\n  summary: 'Regenerate the declared ZORA web materialization.',\n} as const;\nconst COMMAND_CAPABILITIES = CAPABILITIES.filter((capability) =>\n  capability.access.includes('invoke'),\n);\n\nconst provider = {\n  id: '@ankhorage/zora',\n  category: 'zora',\n  version: readPackageVersion(),\n  capabilities: COMMAND_CAPABILITIES,\n  commands: [CREATE_COMMAND, SYNC_COMMAND],\n  handlers: [\n    {\n      path: CREATE_COMMAND.path,\n      handler: create,\n    },\n    {\n      path: SYNC_COMMAND.path,\n      handler: sync,\n    },\n  ],\n} satisfies AnkhRuntimeCommandProvider;\n\nexport default provider;\n\n/*** Read the installed ZORA version for the Ankh provider manifest. */\nfunction readPackageVersion(): string {\n  const packageJson = JSON.parse(\n    readFileSync(resolve(dirname(fileURLToPath(import.meta.url)), '../../package.json'), 'utf8'),\n  ) as { readonly version?: unknown };\n\n  if (typeof packageJson.version !== 'string' || packageJson.version.trim() === '') {\n    throw new Error('ZORA package.json must define a non-empty version.');\n  }\n\n  return packageJson.version;\n}\n"]}

package/dist/features/grid-view/adapters/inbound/GridView.d.ts

@@ -1,10 +1,5 @@
 import React from 'react';
 import type { GridViewProps } from '../../../../types/grid-view';
-/***
- * Renders world-positioned items on native and web using the canonical viewport/culling engine.
- *
- * This first renderer uses nested native scroll regions. Only visible items are mounted;
- * logical cells and invisible elements are never rendered.
- */
-export declare function GridView({ items, contentWidth, contentHeight, width, height, zoom, overscanPixels, focusedItemId, revealPaddingPixels, interactionPolicy, onViewportChange, onVisibleItemIdsChange, renderItem, testID, }: GridViewProps): React.JSX.Element;
+/*** Renders a controlled or uncontrolled, virtualized 2D world through the canonical grid viewport engine. */
+export declare function GridView({ items, contentWidth, contentHeight, width, height, viewport: controlledViewport, defaultViewport, viewportConstraints, zoomLimits, zoom, overscanPixels, focusedItemId, revealPaddingPixels, interactionPolicy, onViewportChange, onVisibleItemIdsChange, renderItem, testID, }: GridViewProps): React.JSX.Element;
 //# sourceMappingURL=GridView.d.ts.map

package/dist/features/grid-view/adapters/inbound/GridView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GridView.d.ts","sourceRoot":"","sources":["../../../../../src/features/grid-view/adapters/inbound/GridView.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,YAAY,EACZ,aAAa,EACb,KAAK,EACL,MAAM,EACN,IAAQ,EACR,cAAoB,EACpB,aAAa,EACb,mBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,MAAM,GACP,EAAE,aAAa,qBA8Gf"}
+{"version":3,"file":"GridView.d.ts","sourceRoot":"","sources":["../../../../../src/features/grid-view/adapters/inbound/GridView.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,MAAM,OAAO,CAAC;AAQ1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAiBjE,8GAA8G;AAC9G,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,YAAY,EACZ,aAAa,EACb,KAAK,EACL,MAAM,EACN,QAAQ,EAAE,kBAAkB,EAC5B,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,IAAQ,EACR,cAAoB,EACpB,aAAa,EACb,mBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,MAAM,GACP,EAAE,aAAa,qBAwWf"}

package/dist/features/grid-view/adapters/inbound/GridView.js

@@ -1,29 +1,78 @@
-import { getVisibleGridItems, revealWorldRect, worldToViewport, } from '@ankhorage/grid-view';
+import { constrainViewport, getVisibleGridItems, panViewport, revealWorldRect, worldToViewport, zoomViewportAt, } from '@ankhorage/grid-view';
 import React from 'react';
-import { ScrollView as NativeScrollView, View as NativeView } from 'react-native';
-/***
- * Renders world-positioned items on native and web using the canonical viewport/culling engine.
- *
- * This first renderer uses nested native scroll regions. Only visible items are mounted;
- * logical cells and invisible elements are never rendered.
- */
-export function GridView({ items, contentWidth, contentHeight, width, height, zoom = 1, overscanPixels = 160, focusedItemId, revealPaddingPixels = 8, interactionPolicy, onViewportChange, onVisibleItemIdsChange, renderItem, testID, }) {
-    const [scrollX, setScrollX] = React.useState(0);
-    const [scrollY, setScrollY] = React.useState(0);
+import { Pressable as NativePressable, ScrollView as NativeScrollView, Text as NativeText, View as NativeView, } from 'react-native';
+/*** Renders a controlled or uncontrolled, virtualized 2D world through the canonical grid viewport engine. */
+export function GridView({ items, contentWidth, contentHeight, width, height, viewport: controlledViewport, defaultViewport, viewportConstraints, zoomLimits, zoom = 1, overscanPixels = 160, focusedItemId, revealPaddingPixels = 8, interactionPolicy, onViewportChange, onVisibleItemIdsChange, renderItem, testID, }) {
+    const [uncontrolledViewport, setUncontrolledViewport] = React.useState(() => createInitialViewport(width, height, zoom, defaultViewport));
     const horizontalScrollRef = React.useRef(null);
     const verticalScrollRef = React.useRef(null);
-    const scale = Math.max(0.01, zoom);
-    const viewport = React.useMemo(() => ({
-        width,
-        height,
-        offsetX: scrollX / scale,
-        offsetY: scrollY / scale,
-        pixelsPerUnitX: scale,
-        pixelsPerUnitY: scale,
-    }), [height, scale, scrollX, scrollY, width]);
+    const gridRef = React.useRef(null);
+    const scrollPositionRef = React.useRef({ x: 0, y: 0 });
+    const pinchGestureRef = React.useRef(undefined);
+    const pinchMeasurementRef = React.useRef(0);
+    const pinchSessionRef = React.useRef(0);
+    const viewportOriginRef = React.useRef({ x: 0, y: 0 });
+    const focusRevealProposalRef = React.useRef(undefined);
+    const focusRevealViewportRef = React.useRef(undefined);
+    const [isPinching, setIsPinching] = React.useState(false);
+    const constraints = React.useMemo(() => viewportConstraints ?? createContentConstraints(contentWidth, contentHeight), [contentHeight, contentWidth, viewportConstraints]);
+    const sourceViewport = controlledViewport ?? uncontrolledViewport;
+    const viewport = React.useMemo(() => constrainViewport({ ...sourceViewport, height, width }, constraints), [constraints, height, sourceViewport, width]);
+    const viewportRef = React.useRef(viewport);
     const visibleItems = React.useMemo(() => getVisibleGridItems(items, viewport, overscanPixels), [items, overscanPixels, viewport]);
     const viewportVisibleIds = React.useMemo(() => getVisibleGridItems(visibleItems, viewport).map((item) => item.id), [viewport, visibleItems]);
+    const focusedItem = items.find((item) => item.id === focusedItemId);
+    const focusedItemHeight = focusedItem?.height;
+    const focusedItemIdForReveal = focusedItem?.id;
+    const focusedItemWidth = focusedItem?.width;
+    const focusedItemX = focusedItem?.x;
+    const focusedItemY = focusedItem?.y;
     const previousVisibleIdsRef = React.useRef([]);
+    const uncontrolled = controlledViewport === undefined;
+    const interactive = interactionPolicy !== 'passive';
+    const publish = React.useCallback((nextViewport) => {
+        if (areViewportsEqual(viewportRef.current, nextViewport))
+            return;
+        viewportRef.current = nextViewport;
+        if (uncontrolled)
+            setUncontrolledViewport(nextViewport);
+        onViewportChange?.(nextViewport);
+    }, [onViewportChange, uncontrolled]);
+    const publishRef = React.useRef(publish);
+    const pan = (displacement) => publish(panViewport(viewportRef.current, displacement, constraints));
+    const zoomAt = (focalPoint, factor) => publish(zoomViewportAt(viewportRef.current, focalPoint, {
+        pixelsPerUnitX: viewportRef.current.pixelsPerUnitX * factor,
+        pixelsPerUnitY: viewportRef.current.pixelsPerUnitY * factor,
+    }, zoomLimits, constraints));
+    React.useEffect(() => {
+        viewportRef.current = viewport;
+    }, [viewport]);
+    React.useEffect(() => {
+        publishRef.current = publish;
+    }, [publish]);
+    const refreshViewportOrigin = React.useCallback(() => {
+        gridRef.current?.measureInWindow((x, y) => {
+            viewportOriginRef.current = { x, y };
+        });
+    }, []);
+    const measurePinchGesture = React.useCallback((touches, session, onMeasured) => {
+        const measurement = pinchMeasurementRef.current + 1;
+        pinchMeasurementRef.current = measurement;
+        gridRef.current?.measureInWindow((x, y) => {
+            if (measurement !== pinchMeasurementRef.current || session !== pinchSessionRef.current) {
+                return;
+            }
+            viewportOriginRef.current = { x, y };
+            onMeasured(getPinchGesture(touches, width, height, { x, y }));
+        });
+    }, [height, width]);
+    React.useLayoutEffect(() => {
+        refreshViewportOrigin();
+    }, [height, refreshViewportOrigin, width]);
+    React.useEffect(() => () => {
+        pinchMeasurementRef.current += 1;
+        pinchSessionRef.current += 1;
+    }, []);
     React.useEffect(() => {
         if (!onVisibleItemIdsChange)
             return;
@@ -36,46 +85,255 @@ export function GridView({ items, contentWidth, contentHeight, width, height, zo
         onVisibleItemIdsChange(viewportVisibleIds);
     }, [onVisibleItemIdsChange, viewportVisibleIds]);
     React.useEffect(() => {
-        onViewportChange?.(viewport);
-    }, [onViewportChange, viewport]);
-    const viewportRef = React.useRef(viewport);
-    React.useEffect(() => {
-        viewportRef.current = viewport;
-    }, [viewport]);
+        const position = createScrollMapping(viewport, constraints);
+        const nextPosition = {
+            x: position.horizontal.position,
+            y: position.vertical.position,
+        };
+        if (areScrollPositionsEqual(scrollPositionRef.current, nextPosition))
+            return;
+        scrollPositionRef.current = nextPosition;
+        const animated = focusRevealViewportRef.current !== undefined &&
+            areViewportsEqual(viewport, focusRevealViewportRef.current);
+        horizontalScrollRef.current?.scrollTo({ animated, x: nextPosition.x });
+        verticalScrollRef.current?.scrollTo({ animated, y: nextPosition.y });
+        if (animated)
+            focusRevealViewportRef.current = undefined;
+    }, [constraints, viewport]);
     React.useEffect(() => {
-        const currentViewport = viewportRef.current;
-        const focusedItem = items.find((item) => item.id === focusedItemId);
-        if (!focusedItem)
+        if (focusedItemHeight === undefined ||
+            focusedItemIdForReveal === undefined ||
+            focusedItemWidth === undefined ||
+            focusedItemX === undefined ||
+            focusedItemY === undefined) {
+            focusRevealProposalRef.current = undefined;
             return;
-        const revealed = revealWorldRect(currentViewport, focusedItem, revealPaddingPixels);
-        if (revealed.offsetX !== currentViewport.offsetX) {
-            horizontalScrollRef.current?.scrollTo({ x: revealed.offsetX * scale, animated: true });
         }
-        if (revealed.offsetY !== currentViewport.offsetY) {
-            verticalScrollRef.current?.scrollTo({ y: revealed.offsetY * scale, animated: true });
+        const sourceViewport = viewportRef.current;
+        const revealed = revealWorldRect(sourceViewport, {
+            height: focusedItemHeight,
+            width: focusedItemWidth,
+            x: focusedItemX,
+            y: focusedItemY,
+        }, revealPaddingPixels, constraints);
+        if (isRepeatedControlledFocusRevealProposal({
+            controlled: !uncontrolled,
+            focusedItemId: focusedItemIdForReveal,
+            previous: focusRevealProposalRef.current,
+            sourceViewport,
+            viewport: revealed,
+        })) {
+            return;
         }
-    }, [focusedItemId, height, items, revealPaddingPixels, scale, width]);
-    return (<NativeScrollView ref={horizontalScrollRef} horizontal scrollEnabled={interactionPolicy !== 'passive'} scrollEventThrottle={32} showsHorizontalScrollIndicator style={{ width, height }} testID={testID} onScroll={(event) => setScrollX(event.nativeEvent.contentOffset.x)}>
-      <NativeScrollView ref={verticalScrollRef} scrollEnabled={interactionPolicy !== 'passive'} scrollEventThrottle={32} showsVerticalScrollIndicator style={{ width: contentWidth * scale, height }} onScroll={(event) => setScrollY(event.nativeEvent.contentOffset.y)}>
-        <NativeView style={{ width: contentWidth * scale, height: contentHeight * scale }}>
-          {visibleItems.map((item) => {
-            const position = worldToViewport({ x: item.x, y: item.y }, {
-                ...viewport,
-                offsetX: 0,
-                offsetY: 0,
+        focusRevealProposalRef.current = {
+            focusedItemId: focusedItemIdForReveal,
+            sourceViewport,
+            viewport: revealed,
+        };
+        focusRevealViewportRef.current = areViewportsEqual(sourceViewport, revealed)
+            ? undefined
+            : revealed;
+        publishRef.current(revealed);
+    }, [
+        constraints,
+        focusedItemHeight,
+        focusedItemIdForReveal,
+        focusedItemWidth,
+        focusedItemX,
+        focusedItemY,
+        revealPaddingPixels,
+        uncontrolled,
+    ]);
+    const scrollMapping = createScrollMapping(viewport, constraints);
+    const syncScrollPosition = () => {
+        const nextMapping = createScrollMapping(viewportRef.current, constraints);
+        const nextPosition = {
+            x: nextMapping.horizontal.position,
+            y: nextMapping.vertical.position,
+        };
+        scrollPositionRef.current = nextPosition;
+        horizontalScrollRef.current?.scrollTo({ animated: false, x: nextPosition.x });
+        verticalScrollRef.current?.scrollTo({ animated: false, y: nextPosition.y });
+    };
+    return (<NativeView ref={gridRef} accessibilityLabel="Interactive grid viewport" onLayout={refreshViewportOrigin} onTouchEnd={() => {
+            const wasPinching = pinchGestureRef.current !== undefined;
+            pinchMeasurementRef.current += 1;
+            pinchSessionRef.current += 1;
+            pinchGestureRef.current = undefined;
+            setIsPinching(false);
+            if (wasPinching)
+                syncScrollPosition();
+        }} onTouchCancel={() => {
+            const wasPinching = pinchGestureRef.current !== undefined;
+            pinchMeasurementRef.current += 1;
+            pinchSessionRef.current += 1;
+            pinchGestureRef.current = undefined;
+            setIsPinching(false);
+            if (wasPinching)
+                syncScrollPosition();
+        }} onTouchMove={(event) => {
+            if (!interactive)
+                return;
+            measurePinchGesture([...event.nativeEvent.touches], pinchSessionRef.current, (pinch) => {
+                const previous = pinchGestureRef.current;
+                pinchGestureRef.current = pinch;
+                setIsPinching(pinch !== undefined);
+                if (!pinch || !previous)
+                    return;
+                zoomAt(pinch.focalPoint, pinch.distance / previous.distance);
+            });
+        }} onTouchStart={(event) => {
+            const session = pinchSessionRef.current + 1;
+            pinchSessionRef.current = session;
+            measurePinchGesture([...event.nativeEvent.touches], session, (pinch) => {
+                pinchGestureRef.current = pinch;
+                setIsPinching(pinch !== undefined);
             });
+        }} style={{ height, overflow: 'hidden', width }} testID={testID}>
+      <NativeScrollView ref={horizontalScrollRef} testID={testID ? `${testID}-horizontal-scroll` : undefined} horizontal scrollEnabled={interactive && !isPinching} scrollEventThrottle={16} showsHorizontalScrollIndicator style={{ height, width }} onScroll={(event) => {
+            if (pinchGestureRef.current)
+                return;
+            const { x } = event.nativeEvent.contentOffset;
+            const displacement = x - scrollPositionRef.current.x;
+            scrollPositionRef.current = { ...scrollPositionRef.current, x };
+            if (displacement !== 0)
+                pan({ x: -displacement, y: 0 });
+        }}>
+        <NativeScrollView ref={verticalScrollRef} testID={testID ? `${testID}-vertical-scroll` : undefined} scrollEnabled={interactive && !isPinching} scrollEventThrottle={16} showsVerticalScrollIndicator style={{ height, width: scrollMapping.horizontal.contentSize }} onScroll={(event) => {
+            if (pinchGestureRef.current)
+                return;
+            const { y } = event.nativeEvent.contentOffset;
+            const displacement = y - scrollPositionRef.current.y;
+            scrollPositionRef.current = { ...scrollPositionRef.current, y };
+            if (displacement !== 0)
+                pan({ x: 0, y: -displacement });
+        }}>
+          <NativeView style={{
+            height: scrollMapping.vertical.contentSize,
+            width: scrollMapping.horizontal.contentSize,
+        }}>
+            {visibleItems.map((item) => {
+            const position = worldToViewport({ x: item.x, y: item.y }, { ...viewport, offsetX: 0, offsetY: 0 });
             return (<NativeView key={item.id} style={{
+                    height: item.height * viewport.pixelsPerUnitY,
+                    left: position.x + scrollMapping.horizontal.origin,
                     position: 'absolute',
-                    left: position.x,
-                    top: position.y,
-                    width: item.width * scale,
-                    height: item.height * scale,
+                    top: position.y + scrollMapping.vertical.origin,
+                    width: item.width * viewport.pixelsPerUnitX,
                 }}>
-                {renderItem(item)}
-              </NativeView>);
+                  {renderItem(item)}
+                </NativeView>);
         })}
-        </NativeView>
+          </NativeView>
+        </NativeScrollView>
       </NativeScrollView>
-    </NativeScrollView>);
+      {interactive ? (<NativeView accessibilityLabel="Viewport controls" style={controlsStyle}>
+          <NativePressable accessibilityLabel="Pan left" accessibilityRole="button" onPress={() => pan({ x: 48, y: 0 })}>
+            <NativeText>←</NativeText>
+          </NativePressable>
+          <NativePressable accessibilityLabel="Pan right" accessibilityRole="button" onPress={() => pan({ x: -48, y: 0 })}>
+            <NativeText>→</NativeText>
+          </NativePressable>
+          <NativePressable accessibilityLabel="Pan up" accessibilityRole="button" onPress={() => pan({ x: 0, y: 48 })}>
+            <NativeText>↑</NativeText>
+          </NativePressable>
+          <NativePressable accessibilityLabel="Pan down" accessibilityRole="button" onPress={() => pan({ x: 0, y: -48 })}>
+            <NativeText>↓</NativeText>
+          </NativePressable>
+          <NativePressable accessibilityLabel="Zoom in" accessibilityRole="button" onPress={() => zoomAt({ x: width / 2, y: height / 2 }, 1.2)}>
+            <NativeText>+</NativeText>
+          </NativePressable>
+          <NativePressable accessibilityLabel="Zoom out" accessibilityRole="button" onPress={() => zoomAt({ x: width / 2, y: height / 2 }, 1 / 1.2)}>
+            <NativeText>−</NativeText>
+          </NativePressable>
+        </NativeView>) : null}
+    </NativeView>);
+}
+const controlsStyle = { bottom: 8, gap: 4, position: 'absolute', right: 8 };
+/*** Builds the initial world position and independent scales for uncontrolled rendering. */
+function createInitialViewport(width, height, zoom, viewport) {
+    return {
+        height,
+        offsetX: viewport?.offsetX ?? 0,
+        offsetY: viewport?.offsetY ?? 0,
+        pixelsPerUnitX: viewport?.pixelsPerUnitX ?? zoom,
+        pixelsPerUnitY: viewport?.pixelsPerUnitY ?? zoom,
+        width,
+    };
+}
+/*** Uses the rendered content extent as the default finite world boundary. */
+function createContentConstraints(contentWidth, contentHeight) {
+    return { world: { height: contentHeight, width: contentWidth, x: 0, y: 0 } };
+}
+/*** Maps engine-constrained world offsets to nonnegative native scroll coordinates. */
+function createScrollMapping(viewport, constraints) {
+    const horizontalMinimum = constrainViewport({ ...viewport, offsetX: -Number.MAX_SAFE_INTEGER }, constraints).offsetX;
+    const horizontalMaximum = constrainViewport({ ...viewport, offsetX: Number.MAX_SAFE_INTEGER }, constraints).offsetX;
+    const verticalMinimum = constrainViewport({ ...viewport, offsetY: -Number.MAX_SAFE_INTEGER }, constraints).offsetY;
+    const verticalMaximum = constrainViewport({ ...viewport, offsetY: Number.MAX_SAFE_INTEGER }, constraints).offsetY;
+    return {
+        horizontal: createScrollAxisMapping({
+            maximum: horizontalMaximum,
+            minimum: horizontalMinimum,
+            offset: viewport.offsetX,
+            scale: viewport.pixelsPerUnitX,
+            viewportSize: viewport.width,
+        }),
+        vertical: createScrollAxisMapping({
+            maximum: verticalMaximum,
+            minimum: verticalMinimum,
+            offset: viewport.offsetY,
+            scale: viewport.pixelsPerUnitY,
+            viewportSize: viewport.height,
+        }),
+    };
+}
+/*** Derives a physical scroll axis from the published engine constraint result. */
+function createScrollAxisMapping({ maximum, minimum, offset, scale, viewportSize, }) {
+    const range = (maximum - minimum) * scale;
+    return {
+        contentSize: viewportSize + range,
+        origin: -minimum * scale,
+        position: (offset - minimum) * scale,
+    };
+}
+/*** Compares canonical viewport fields without treating equal proposals as state changes. */
+function areViewportsEqual(left, right) {
+    return (left.width === right.width &&
+        left.height === right.height &&
+        left.offsetX === right.offsetX &&
+        left.offsetY === right.offsetY &&
+        left.pixelsPerUnitX === right.pixelsPerUnitX &&
+        left.pixelsPerUnitY === right.pixelsPerUnitY);
+}
+/*** Avoids requesting native scrolling again when the physical position is already current. */
+function areScrollPositionsEqual(left, right) {
+    return left.x === right.x && left.y === right.y;
+}
+/*** Skips a rejected controlled focus proposal until its focus or incoming viewport changes. */
+function isRepeatedControlledFocusRevealProposal({ controlled, focusedItemId, previous, sourceViewport, viewport, }) {
+    return (controlled &&
+        focusedItemId !== undefined &&
+        previous?.focusedItemId === focusedItemId &&
+        areViewportsEqual(previous.sourceViewport, sourceViewport) &&
+        areViewportsEqual(previous.viewport, viewport));
+}
+/*** Extracts a stable two-finger focal point in the measured outer viewport coordinate space. */
+function getPinchGesture(touches, width, height, viewportOrigin) {
+    const [first, second] = touches;
+    if (!first || !second)
+        return undefined;
+    const deltaX = second.pageX - first.pageX;
+    const deltaY = second.pageY - first.pageY;
+    const distance = Math.hypot(deltaX, deltaY);
+    if (!Number.isFinite(distance) || distance === 0)
+        return undefined;
+    return {
+        distance,
+        focalPoint: {
+            x: Math.min(width, Math.max(0, (first.pageX + second.pageX) / 2 - viewportOrigin.x)),
+            y: Math.min(height, Math.max(0, (first.pageY + second.pageY) / 2 - viewportOrigin.y)),
+        },
+    };
 }
 //# sourceMappingURL=GridView.js.map

package/dist/features/grid-view/adapters/inbound/GridView.js.map

@@ -1 +1 @@
-{"version":3,"file":"GridView.js","sourceRoot":"","sources":["../../../../../src/features/grid-view/adapters/inbound/GridView.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  getVisibleGridItems,\n  type GridViewport,\n  revealWorldRect,\n  worldToViewport,\n} from '@ankhorage/grid-view';\nimport React from 'react';\nimport { ScrollView as NativeScrollView, View as NativeView } from 'react-native';\n\nimport type { GridViewProps } from '../../../../types/grid-view';\n\n/***\n * Renders world-positioned items on native and web using the canonical viewport/culling engine.\n *\n * This first renderer uses nested native scroll regions. Only visible items are mounted;\n * logical cells and invisible elements are never rendered.\n */\nexport function GridView({\n  items,\n  contentWidth,\n  contentHeight,\n  width,\n  height,\n  zoom = 1,\n  overscanPixels = 160,\n  focusedItemId,\n  revealPaddingPixels = 8,\n  interactionPolicy,\n  onViewportChange,\n  onVisibleItemIdsChange,\n  renderItem,\n  testID,\n}: GridViewProps) {\n  const [scrollX, setScrollX] = React.useState(0);\n  const [scrollY, setScrollY] = React.useState(0);\n  const horizontalScrollRef = React.useRef<NativeScrollView>(null);\n  const verticalScrollRef = React.useRef<NativeScrollView>(null);\n  const scale = Math.max(0.01, zoom);\n  const viewport = React.useMemo<GridViewport>(\n    () => ({\n      width,\n      height,\n      offsetX: scrollX / scale,\n      offsetY: scrollY / scale,\n      pixelsPerUnitX: scale,\n      pixelsPerUnitY: scale,\n    }),\n    [height, scale, scrollX, scrollY, width],\n  );\n  const visibleItems = React.useMemo(\n    () => getVisibleGridItems(items, viewport, overscanPixels),\n    [items, overscanPixels, viewport],\n  );\n  const viewportVisibleIds = React.useMemo(\n    () => getVisibleGridItems(visibleItems, viewport).map((item) => item.id),\n    [viewport, visibleItems],\n  );\n  const previousVisibleIdsRef = React.useRef<readonly string[]>([]);\n\n  React.useEffect(() => {\n    if (!onVisibleItemIdsChange) return;\n    const previous = previousVisibleIdsRef.current;\n    if (\n      previous.length === viewportVisibleIds.length &&\n      previous.every((id, index) => id === viewportVisibleIds.at(index))\n    ) {\n      return;\n    }\n    previousVisibleIdsRef.current = viewportVisibleIds;\n    onVisibleItemIdsChange(viewportVisibleIds);\n  }, [onVisibleItemIdsChange, viewportVisibleIds]);\n\n  React.useEffect(() => {\n    onViewportChange?.(viewport);\n  }, [onViewportChange, viewport]);\n\n  const viewportRef = React.useRef(viewport);\n  React.useEffect(() => {\n    viewportRef.current = viewport;\n  }, [viewport]);\n\n  React.useEffect(() => {\n    const currentViewport = viewportRef.current;\n    const focusedItem = items.find((item) => item.id === focusedItemId);\n    if (!focusedItem) return;\n    const revealed = revealWorldRect(currentViewport, focusedItem, revealPaddingPixels);\n    if (revealed.offsetX !== currentViewport.offsetX) {\n      horizontalScrollRef.current?.scrollTo({ x: revealed.offsetX * scale, animated: true });\n    }\n    if (revealed.offsetY !== currentViewport.offsetY) {\n      verticalScrollRef.current?.scrollTo({ y: revealed.offsetY * scale, animated: true });\n    }\n  }, [focusedItemId, height, items, revealPaddingPixels, scale, width]);\n\n  return (\n    <NativeScrollView\n      ref={horizontalScrollRef}\n      horizontal\n      scrollEnabled={interactionPolicy !== 'passive'}\n      scrollEventThrottle={32}\n      showsHorizontalScrollIndicator\n      style={{ width, height }}\n      testID={testID}\n      onScroll={(event) => setScrollX(event.nativeEvent.contentOffset.x)}\n    >\n      <NativeScrollView\n        ref={verticalScrollRef}\n        scrollEnabled={interactionPolicy !== 'passive'}\n        scrollEventThrottle={32}\n        showsVerticalScrollIndicator\n        style={{ width: contentWidth * scale, height }}\n        onScroll={(event) => setScrollY(event.nativeEvent.contentOffset.y)}\n      >\n        <NativeView style={{ width: contentWidth * scale, height: contentHeight * scale }}>\n          {visibleItems.map((item) => {\n            const position = worldToViewport(\n              { x: item.x, y: item.y },\n              {\n                ...viewport,\n                offsetX: 0,\n                offsetY: 0,\n              },\n            );\n            return (\n              <NativeView\n                key={item.id}\n                style={{\n                  position: 'absolute',\n                  left: position.x,\n                  top: position.y,\n                  width: item.width * scale,\n                  height: item.height * scale,\n                }}\n              >\n                {renderItem(item)}\n              </NativeView>\n            );\n          })}\n        </NativeView>\n      </NativeScrollView>\n    </NativeScrollView>\n  );\n}\n"]}
+{"version":3,"file":"GridView.js","sourceRoot":"","sources":["../../../../../src/features/grid-view/adapters/inbound/GridView.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  constrainViewport,\n  getVisibleGridItems,\n  type GridPoint,\n  type GridViewport,\n  type GridViewportConstraints,\n  panViewport,\n  revealWorldRect,\n  worldToViewport,\n  zoomViewportAt,\n} from '@ankhorage/grid-view';\nimport React from 'react';\nimport {\n  Pressable as NativePressable,\n  ScrollView as NativeScrollView,\n  Text as NativeText,\n  View as NativeView,\n} from 'react-native';\n\nimport type { GridViewProps } from '../../../../types/grid-view';\n\ntype ScrollPosition = Readonly<{ x: number; y: number }>;\ntype PinchGesture = Readonly<{ distance: number; focalPoint: GridPoint }>;\ntype ScrollAxisMapping = Readonly<{ contentSize: number; origin: number; position: number }>;\ntype ScrollMapping = Readonly<{\n  horizontal: ScrollAxisMapping;\n  vertical: ScrollAxisMapping;\n}>;\ntype ViewportOrigin = Readonly<{ x: number; y: number }>;\ntype FocusRevealProposal = Readonly<{\n  focusedItemId: string;\n  sourceViewport: GridViewport;\n  viewport: GridViewport;\n}>;\ntype PinchTouch = Readonly<{ pageX: number; pageY: number }>;\n\n/*** Renders a controlled or uncontrolled, virtualized 2D world through the canonical grid viewport engine. */\nexport function GridView({\n  items,\n  contentWidth,\n  contentHeight,\n  width,\n  height,\n  viewport: controlledViewport,\n  defaultViewport,\n  viewportConstraints,\n  zoomLimits,\n  zoom = 1,\n  overscanPixels = 160,\n  focusedItemId,\n  revealPaddingPixels = 8,\n  interactionPolicy,\n  onViewportChange,\n  onVisibleItemIdsChange,\n  renderItem,\n  testID,\n}: GridViewProps) {\n  const [uncontrolledViewport, setUncontrolledViewport] = React.useState(() =>\n    createInitialViewport(width, height, zoom, defaultViewport),\n  );\n  const horizontalScrollRef = React.useRef<NativeScrollView>(null);\n  const verticalScrollRef = React.useRef<NativeScrollView>(null);\n  const gridRef = React.useRef<React.ComponentRef<typeof NativeView>>(null);\n  const scrollPositionRef = React.useRef<ScrollPosition>({ x: 0, y: 0 });\n  const pinchGestureRef = React.useRef<PinchGesture | undefined>(undefined);\n  const pinchMeasurementRef = React.useRef(0);\n  const pinchSessionRef = React.useRef(0);\n  const viewportOriginRef = React.useRef<ViewportOrigin>({ x: 0, y: 0 });\n  const focusRevealProposalRef = React.useRef<FocusRevealProposal | undefined>(undefined);\n  const focusRevealViewportRef = React.useRef<GridViewport | undefined>(undefined);\n  const [isPinching, setIsPinching] = React.useState(false);\n  const constraints = React.useMemo(\n    () => viewportConstraints ?? createContentConstraints(contentWidth, contentHeight),\n    [contentHeight, contentWidth, viewportConstraints],\n  );\n  const sourceViewport = controlledViewport ?? uncontrolledViewport;\n  const viewport = React.useMemo(\n    () => constrainViewport({ ...sourceViewport, height, width }, constraints),\n    [constraints, height, sourceViewport, width],\n  );\n  const viewportRef = React.useRef(viewport);\n  const visibleItems = React.useMemo(\n    () => getVisibleGridItems(items, viewport, overscanPixels),\n    [items, overscanPixels, viewport],\n  );\n  const viewportVisibleIds = React.useMemo(\n    () => getVisibleGridItems(visibleItems, viewport).map((item) => item.id),\n    [viewport, visibleItems],\n  );\n  const focusedItem = items.find((item) => item.id === focusedItemId);\n  const focusedItemHeight = focusedItem?.height;\n  const focusedItemIdForReveal = focusedItem?.id;\n  const focusedItemWidth = focusedItem?.width;\n  const focusedItemX = focusedItem?.x;\n  const focusedItemY = focusedItem?.y;\n  const previousVisibleIdsRef = React.useRef<readonly string[]>([]);\n  const uncontrolled = controlledViewport === undefined;\n  const interactive = interactionPolicy !== 'passive';\n\n  const publish = React.useCallback(\n    (nextViewport: GridViewport) => {\n      if (areViewportsEqual(viewportRef.current, nextViewport)) return;\n      viewportRef.current = nextViewport;\n      if (uncontrolled) setUncontrolledViewport(nextViewport);\n      onViewportChange?.(nextViewport);\n    },\n    [onViewportChange, uncontrolled],\n  );\n  const publishRef = React.useRef(publish);\n  const pan = (displacement: GridPoint) =>\n    publish(panViewport(viewportRef.current, displacement, constraints));\n  const zoomAt = (focalPoint: GridPoint, factor: number) =>\n    publish(\n      zoomViewportAt(\n        viewportRef.current,\n        focalPoint,\n        {\n          pixelsPerUnitX: viewportRef.current.pixelsPerUnitX * factor,\n          pixelsPerUnitY: viewportRef.current.pixelsPerUnitY * factor,\n        },\n        zoomLimits,\n        constraints,\n      ),\n    );\n\n  React.useEffect(() => {\n    viewportRef.current = viewport;\n  }, [viewport]);\n\n  React.useEffect(() => {\n    publishRef.current = publish;\n  }, [publish]);\n\n  const refreshViewportOrigin = React.useCallback(() => {\n    gridRef.current?.measureInWindow((x, y) => {\n      viewportOriginRef.current = { x, y };\n    });\n  }, []);\n\n  const measurePinchGesture = React.useCallback(\n    (\n      touches: readonly PinchTouch[],\n      session: number,\n      onMeasured: (pinch: PinchGesture | undefined) => void,\n    ) => {\n      const measurement = pinchMeasurementRef.current + 1;\n      pinchMeasurementRef.current = measurement;\n      gridRef.current?.measureInWindow((x, y) => {\n        if (measurement !== pinchMeasurementRef.current || session !== pinchSessionRef.current) {\n          return;\n        }\n        viewportOriginRef.current = { x, y };\n        onMeasured(getPinchGesture(touches, width, height, { x, y }));\n      });\n    },\n    [height, width],\n  );\n\n  React.useLayoutEffect(() => {\n    refreshViewportOrigin();\n  }, [height, refreshViewportOrigin, width]);\n\n  React.useEffect(\n    () => () => {\n      pinchMeasurementRef.current += 1;\n      pinchSessionRef.current += 1;\n    },\n    [],\n  );\n\n  React.useEffect(() => {\n    if (!onVisibleItemIdsChange) return;\n    const previous = previousVisibleIdsRef.current;\n    if (\n      previous.length === viewportVisibleIds.length &&\n      previous.every((id, index) => id === viewportVisibleIds.at(index))\n    ) {\n      return;\n    }\n    previousVisibleIdsRef.current = viewportVisibleIds;\n    onVisibleItemIdsChange(viewportVisibleIds);\n  }, [onVisibleItemIdsChange, viewportVisibleIds]);\n\n  React.useEffect(() => {\n    const position = createScrollMapping(viewport, constraints);\n    const nextPosition = {\n      x: position.horizontal.position,\n      y: position.vertical.position,\n    };\n    if (areScrollPositionsEqual(scrollPositionRef.current, nextPosition)) return;\n    scrollPositionRef.current = nextPosition;\n    const animated =\n      focusRevealViewportRef.current !== undefined &&\n      areViewportsEqual(viewport, focusRevealViewportRef.current);\n    horizontalScrollRef.current?.scrollTo({ animated, x: nextPosition.x });\n    verticalScrollRef.current?.scrollTo({ animated, y: nextPosition.y });\n    if (animated) focusRevealViewportRef.current = undefined;\n  }, [constraints, viewport]);\n\n  React.useEffect(() => {\n    if (\n      focusedItemHeight === undefined ||\n      focusedItemIdForReveal === undefined ||\n      focusedItemWidth === undefined ||\n      focusedItemX === undefined ||\n      focusedItemY === undefined\n    ) {\n      focusRevealProposalRef.current = undefined;\n      return;\n    }\n    const sourceViewport = viewportRef.current;\n    const revealed = revealWorldRect(\n      sourceViewport,\n      {\n        height: focusedItemHeight,\n        width: focusedItemWidth,\n        x: focusedItemX,\n        y: focusedItemY,\n      },\n      revealPaddingPixels,\n      constraints,\n    );\n    if (\n      isRepeatedControlledFocusRevealProposal({\n        controlled: !uncontrolled,\n        focusedItemId: focusedItemIdForReveal,\n        previous: focusRevealProposalRef.current,\n        sourceViewport,\n        viewport: revealed,\n      })\n    ) {\n      return;\n    }\n    focusRevealProposalRef.current = {\n      focusedItemId: focusedItemIdForReveal,\n      sourceViewport,\n      viewport: revealed,\n    };\n    focusRevealViewportRef.current = areViewportsEqual(sourceViewport, revealed)\n      ? undefined\n      : revealed;\n    publishRef.current(revealed);\n  }, [\n    constraints,\n    focusedItemHeight,\n    focusedItemIdForReveal,\n    focusedItemWidth,\n    focusedItemX,\n    focusedItemY,\n    revealPaddingPixels,\n    uncontrolled,\n  ]);\n\n  const scrollMapping = createScrollMapping(viewport, constraints);\n\n  const syncScrollPosition = () => {\n    const nextMapping = createScrollMapping(viewportRef.current, constraints);\n    const nextPosition = {\n      x: nextMapping.horizontal.position,\n      y: nextMapping.vertical.position,\n    };\n    scrollPositionRef.current = nextPosition;\n    horizontalScrollRef.current?.scrollTo({ animated: false, x: nextPosition.x });\n    verticalScrollRef.current?.scrollTo({ animated: false, y: nextPosition.y });\n  };\n\n  return (\n    <NativeView\n      ref={gridRef}\n      accessibilityLabel=\"Interactive grid viewport\"\n      onLayout={refreshViewportOrigin}\n      onTouchEnd={() => {\n        const wasPinching = pinchGestureRef.current !== undefined;\n        pinchMeasurementRef.current += 1;\n        pinchSessionRef.current += 1;\n        pinchGestureRef.current = undefined;\n        setIsPinching(false);\n        if (wasPinching) syncScrollPosition();\n      }}\n      onTouchCancel={() => {\n        const wasPinching = pinchGestureRef.current !== undefined;\n        pinchMeasurementRef.current += 1;\n        pinchSessionRef.current += 1;\n        pinchGestureRef.current = undefined;\n        setIsPinching(false);\n        if (wasPinching) syncScrollPosition();\n      }}\n      onTouchMove={(event) => {\n        if (!interactive) return;\n        measurePinchGesture([...event.nativeEvent.touches], pinchSessionRef.current, (pinch) => {\n          const previous = pinchGestureRef.current;\n          pinchGestureRef.current = pinch;\n          setIsPinching(pinch !== undefined);\n          if (!pinch || !previous) return;\n          zoomAt(pinch.focalPoint, pinch.distance / previous.distance);\n        });\n      }}\n      onTouchStart={(event) => {\n        const session = pinchSessionRef.current + 1;\n        pinchSessionRef.current = session;\n        measurePinchGesture([...event.nativeEvent.touches], session, (pinch) => {\n          pinchGestureRef.current = pinch;\n          setIsPinching(pinch !== undefined);\n        });\n      }}\n      style={{ height, overflow: 'hidden', width }}\n      testID={testID}\n    >\n      <NativeScrollView\n        ref={horizontalScrollRef}\n        testID={testID ? `${testID}-horizontal-scroll` : undefined}\n        horizontal\n        scrollEnabled={interactive && !isPinching}\n        scrollEventThrottle={16}\n        showsHorizontalScrollIndicator\n        style={{ height, width }}\n        onScroll={(event) => {\n          if (pinchGestureRef.current) return;\n          const { x } = event.nativeEvent.contentOffset;\n          const displacement = x - scrollPositionRef.current.x;\n          scrollPositionRef.current = { ...scrollPositionRef.current, x };\n          if (displacement !== 0) pan({ x: -displacement, y: 0 });\n        }}\n      >\n        <NativeScrollView\n          ref={verticalScrollRef}\n          testID={testID ? `${testID}-vertical-scroll` : undefined}\n          scrollEnabled={interactive && !isPinching}\n          scrollEventThrottle={16}\n          showsVerticalScrollIndicator\n          style={{ height, width: scrollMapping.horizontal.contentSize }}\n          onScroll={(event) => {\n            if (pinchGestureRef.current) return;\n            const { y } = event.nativeEvent.contentOffset;\n            const displacement = y - scrollPositionRef.current.y;\n            scrollPositionRef.current = { ...scrollPositionRef.current, y };\n            if (displacement !== 0) pan({ x: 0, y: -displacement });\n          }}\n        >\n          <NativeView\n            style={{\n              height: scrollMapping.vertical.contentSize,\n              width: scrollMapping.horizontal.contentSize,\n            }}\n          >\n            {visibleItems.map((item) => {\n              const position = worldToViewport(\n                { x: item.x, y: item.y },\n                { ...viewport, offsetX: 0, offsetY: 0 },\n              );\n              return (\n                <NativeView\n                  key={item.id}\n                  style={{\n                    height: item.height * viewport.pixelsPerUnitY,\n                    left: position.x + scrollMapping.horizontal.origin,\n                    position: 'absolute',\n                    top: position.y + scrollMapping.vertical.origin,\n                    width: item.width * viewport.pixelsPerUnitX,\n                  }}\n                >\n                  {renderItem(item)}\n                </NativeView>\n              );\n            })}\n          </NativeView>\n        </NativeScrollView>\n      </NativeScrollView>\n      {interactive ? (\n        <NativeView accessibilityLabel=\"Viewport controls\" style={controlsStyle}>\n          <NativePressable\n            accessibilityLabel=\"Pan left\"\n            accessibilityRole=\"button\"\n            onPress={() => pan({ x: 48, y: 0 })}\n          >\n            <NativeText>←</NativeText>\n          </NativePressable>\n          <NativePressable\n            accessibilityLabel=\"Pan right\"\n            accessibilityRole=\"button\"\n            onPress={() => pan({ x: -48, y: 0 })}\n          >\n            <NativeText>→</NativeText>\n          </NativePressable>\n          <NativePressable\n            accessibilityLabel=\"Pan up\"\n            accessibilityRole=\"button\"\n            onPress={() => pan({ x: 0, y: 48 })}\n          >\n            <NativeText>↑</NativeText>\n          </NativePressable>\n          <NativePressable\n            accessibilityLabel=\"Pan down\"\n            accessibilityRole=\"button\"\n            onPress={() => pan({ x: 0, y: -48 })}\n          >\n            <NativeText>↓</NativeText>\n          </NativePressable>\n          <NativePressable\n            accessibilityLabel=\"Zoom in\"\n            accessibilityRole=\"button\"\n            onPress={() => zoomAt({ x: width / 2, y: height / 2 }, 1.2)}\n          >\n            <NativeText>+</NativeText>\n          </NativePressable>\n          <NativePressable\n            accessibilityLabel=\"Zoom out\"\n            accessibilityRole=\"button\"\n            onPress={() => zoomAt({ x: width / 2, y: height / 2 }, 1 / 1.2)}\n          >\n            <NativeText>−</NativeText>\n          </NativePressable>\n        </NativeView>\n      ) : null}\n    </NativeView>\n  );\n}\n\nconst controlsStyle = { bottom: 8, gap: 4, position: 'absolute' as const, right: 8 };\n\n/*** Builds the initial world position and independent scales for uncontrolled rendering. */\nfunction createInitialViewport(\n  width: number,\n  height: number,\n  zoom: number,\n  viewport: GridViewProps['defaultViewport'],\n): GridViewport {\n  return {\n    height,\n    offsetX: viewport?.offsetX ?? 0,\n    offsetY: viewport?.offsetY ?? 0,\n    pixelsPerUnitX: viewport?.pixelsPerUnitX ?? zoom,\n    pixelsPerUnitY: viewport?.pixelsPerUnitY ?? zoom,\n    width,\n  };\n}\n\n/*** Uses the rendered content extent as the default finite world boundary. */\nfunction createContentConstraints(\n  contentWidth: number,\n  contentHeight: number,\n): GridViewportConstraints {\n  return { world: { height: contentHeight, width: contentWidth, x: 0, y: 0 } };\n}\n\n/*** Maps engine-constrained world offsets to nonnegative native scroll coordinates. */\nfunction createScrollMapping(\n  viewport: GridViewport,\n  constraints: GridViewportConstraints,\n): ScrollMapping {\n  const horizontalMinimum = constrainViewport(\n    { ...viewport, offsetX: -Number.MAX_SAFE_INTEGER },\n    constraints,\n  ).offsetX;\n  const horizontalMaximum = constrainViewport(\n    { ...viewport, offsetX: Number.MAX_SAFE_INTEGER },\n    constraints,\n  ).offsetX;\n  const verticalMinimum = constrainViewport(\n    { ...viewport, offsetY: -Number.MAX_SAFE_INTEGER },\n    constraints,\n  ).offsetY;\n  const verticalMaximum = constrainViewport(\n    { ...viewport, offsetY: Number.MAX_SAFE_INTEGER },\n    constraints,\n  ).offsetY;\n  return {\n    horizontal: createScrollAxisMapping({\n      maximum: horizontalMaximum,\n      minimum: horizontalMinimum,\n      offset: viewport.offsetX,\n      scale: viewport.pixelsPerUnitX,\n      viewportSize: viewport.width,\n    }),\n    vertical: createScrollAxisMapping({\n      maximum: verticalMaximum,\n      minimum: verticalMinimum,\n      offset: viewport.offsetY,\n      scale: viewport.pixelsPerUnitY,\n      viewportSize: viewport.height,\n    }),\n  };\n}\n\ntype ScrollAxisMappingInput = Readonly<{\n  maximum: number;\n  minimum: number;\n  offset: number;\n  scale: number;\n  viewportSize: number;\n}>;\n\n/*** Derives a physical scroll axis from the published engine constraint result. */\nfunction createScrollAxisMapping({\n  maximum,\n  minimum,\n  offset,\n  scale,\n  viewportSize,\n}: ScrollAxisMappingInput): ScrollAxisMapping {\n  const range = (maximum - minimum) * scale;\n  return {\n    contentSize: viewportSize + range,\n    origin: -minimum * scale,\n    position: (offset - minimum) * scale,\n  };\n}\n\n/*** Compares canonical viewport fields without treating equal proposals as state changes. */\nfunction areViewportsEqual(left: GridViewport, right: GridViewport): boolean {\n  return (\n    left.width === right.width &&\n    left.height === right.height &&\n    left.offsetX === right.offsetX &&\n    left.offsetY === right.offsetY &&\n    left.pixelsPerUnitX === right.pixelsPerUnitX &&\n    left.pixelsPerUnitY === right.pixelsPerUnitY\n  );\n}\n\n/*** Avoids requesting native scrolling again when the physical position is already current. */\nfunction areScrollPositionsEqual(left: ScrollPosition, right: ScrollPosition): boolean {\n  return left.x === right.x && left.y === right.y;\n}\n\n/*** Skips a rejected controlled focus proposal until its focus or incoming viewport changes. */\nfunction isRepeatedControlledFocusRevealProposal({\n  controlled,\n  focusedItemId,\n  previous,\n  sourceViewport,\n  viewport,\n}: Readonly<{\n  controlled: boolean;\n  focusedItemId: string | undefined;\n  previous: FocusRevealProposal | undefined;\n  sourceViewport: GridViewport;\n  viewport: GridViewport;\n}>): boolean {\n  return (\n    controlled &&\n    focusedItemId !== undefined &&\n    previous?.focusedItemId === focusedItemId &&\n    areViewportsEqual(previous.sourceViewport, sourceViewport) &&\n    areViewportsEqual(previous.viewport, viewport)\n  );\n}\n\n/*** Extracts a stable two-finger focal point in the measured outer viewport coordinate space. */\nfunction getPinchGesture(\n  touches: readonly Readonly<{\n    pageX: number;\n    pageY: number;\n  }>[],\n  width: number,\n  height: number,\n  viewportOrigin: ViewportOrigin,\n): PinchGesture | undefined {\n  const [first, second] = touches;\n  if (!first || !second) return undefined;\n  const deltaX = second.pageX - first.pageX;\n  const deltaY = second.pageY - first.pageY;\n  const distance = Math.hypot(deltaX, deltaY);\n  if (!Number.isFinite(distance) || distance === 0) return undefined;\n  return {\n    distance,\n    focalPoint: {\n      x: Math.min(width, Math.max(0, (first.pageX + second.pageX) / 2 - viewportOrigin.x)),\n      y: Math.min(height, Math.max(0, (first.pageY + second.pageY) / 2 - viewportOrigin.y)),\n    },\n  };\n}\n"]}