@ankhorage/zora 25.4.0 → 25.6.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 25.6.0
+
+### Minor Changes
+
+- b3bd629: Add controlled and bounded two-dimensional GridView and TileGrid viewport interaction for React Native and React Native Web.
+
+## 25.5.0
+
+### Minor Changes
+
+- e6b7784: Add virtualized TimeGrid interval lanes for generic timeline, DAW, and scheduler code APIs.
+
 ## 25.4.0
 
 ### Minor Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/zora
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v25.4.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v25.6.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
 
 Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.
 
@@ -65,12 +65,14 @@ This package contains 6 additional examples. See the generated documentation for
 - [createPokerTrainingTableState sequence](././paradox/diagrams/sequences/create-poker-training-table-state.mmd)
 - [createZoraThemeConfig sequence](././paradox/diagrams/sequences/create-zora-theme-config.mmd)
 - [getLegalTargets sequence](././paradox/diagrams/sequences/get-legal-targets.mmd)
+- [GridView sequence](././paradox/diagrams/sequences/grid-view.mmd)
 - [readChessPieces sequence](././paradox/diagrams/sequences/read-chess-pieces.mmd)
 - [resolveAvatarInitials sequence](././paradox/diagrams/sequences/resolve-avatar-initials.mmd)
 - [resolveExplorerSelection sequence](././paradox/diagrams/sequences/resolve-explorer-selection.mmd)
 - [resolveGridRulerMarks sequence](././paradox/diagrams/sequences/resolve-grid-ruler-marks.mmd)
 - [resolveOAuthProviderIcon sequence](././paradox/diagrams/sequences/resolve-oauth-provider-icon.mmd)
 - [resolveOAuthProviderLabel sequence](././paradox/diagrams/sequences/resolve-oauth-provider-label.mmd)
+- [resolveTimeGridVisibleIntervals sequence](././paradox/diagrams/sequences/resolve-time-grid-visible-intervals.mmd)
 - [SelectionProvider sequence](././paradox/diagrams/sequences/selection-provider.mmd)
 - [tryMove sequence](././paradox/diagrams/sequences/try-move.mmd)
 - [useZoraTheme sequence](././paradox/diagrams/sequences/use-zora-theme.mmd)

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":"AAAA,OAAO,EACL,mBAAmB,EAEnB,eAAe,EACf,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,IAAI,gBAAgB,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AAIlF;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,EACvB,KAAK,EACL,YAAY,EACZ,aAAa,EACb,KAAK,EACL,MAAM,EACN,IAAI,GAAG,CAAC,EACR,cAAc,GAAG,GAAG,EACpB,aAAa,EACb,mBAAmB,GAAG,CAAC,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,MAAM,GACQ;IACd,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,mBAAmB,GAAG,KAAK,CAAC,MAAM,CAAmB,IAAI,CAAC,CAAC;IACjE,MAAM,iBAAiB,GAAG,KAAK,CAAC,MAAM,CAAmB,IAAI,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAC5B,GAAG,EAAE,CAAC,CAAC;QACL,KAAK;QACL,MAAM;QACN,OAAO,EAAE,OAAO,GAAG,KAAK;QACxB,OAAO,EAAE,OAAO,GAAG,KAAK;QACxB,cAAc,EAAE,KAAK;QACrB,cAAc,EAAE,KAAK;KACtB,CAAC,EACF,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CACzC,CAAC;IACF,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAChC,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,cAAc,CAAC,EAC1D,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,CAAC,CAClC,CAAC;IACF,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CACtC,GAAG,EAAE,CAAC,mBAAmB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EACxE,CAAC,QAAQ,EAAE,YAAY,CAAC,CACzB,CAAC;IACF,MAAM,qBAAqB,GAAG,KAAK,CAAC,MAAM,CAAoB,EAAE,CAAC,CAAC;IAElE,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC,sBAAsB;YAAE,OAAO;QACpC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,OAAO,CAAC;QAC/C,IACE,QAAQ,CAAC,MAAM,KAAK,kBAAkB,CAAC,MAAM;YAC7C,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,KAAK,kBAAkB,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAClE,CAAC;YACD,OAAO;QACT,CAAC;QACD,qBAAqB,CAAC,OAAO,GAAG,kBAAkB,CAAC;QACnD,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;IAC7C,CAAC,EAAE,CAAC,sBAAsB,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAEjD,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,gBAAgB,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC,EAAE,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEjC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3C,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IACjC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC;QAC5C,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,aAAa,CAAC,CAAC;QACpE,IAAI,CAAC,WAAW;YAAE,OAAO;QACzB,MAAM,QAAQ,GAAG,eAAe,CAAC,eAAe,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC;QACpF,IAAI,QAAQ,CAAC,OAAO,KAAK,eAAe,CAAC,OAAO,EAAE,CAAC;YACjD,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,QAAQ,CAAC,OAAO,KAAK,eAAe,CAAC,OAAO,EAAE,CAAC;YACjD,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACvF,CAAC;IACH,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAEtE,OAAO,CACL,CAAC,gBAAgB,CACf,GAAG,CAAC,CAAC,mBAAmB,CAAC,CACzB,UAAU,CACV,aAAa,CAAC,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAC/C,mBAAmB,CAAC,CAAC,EAAE,CAAC,CACxB,8BAA8B,CAC9B,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CACzB,MAAM,CAAC,CAAC,MAAM,CAAC,CACf,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAEnE;MAAA,CAAC,gBAAgB,CACf,GAAG,CAAC,CAAC,iBAAiB,CAAC,CACvB,aAAa,CAAC,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAC/C,mBAAmB,CAAC,CAAC,EAAE,CAAC,CACxB,4BAA4B,CAC5B,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,KAAK,EAAE,MAAM,EAAE,CAAC,CAC/C,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAEnE;QAAA,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,KAAK,EAAE,MAAM,EAAE,aAAa,GAAG,KAAK,EAAE,CAAC,CAChF;UAAA,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACzB,MAAM,QAAQ,GAAG,eAAe,CAC9B,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,EACxB;gBACE,GAAG,QAAQ;gBACX,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;aACX,CACF,CAAC;YACF,OAAO,CACL,CAAC,UAAU,CACT,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CACb,KAAK,CAAC,CAAC;oBACL,QAAQ,EAAE,UAAU;oBACpB,IAAI,EAAE,QAAQ,CAAC,CAAC;oBAChB,GAAG,EAAE,QAAQ,CAAC,CAAC;oBACf,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,KAAK;oBACzB,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK;iBAC5B,CAAC,CAEF;gBAAA,CAAC,UAAU,CAAC,IAAI,CAAC,CACnB;cAAA,EAAE,UAAU,CAAC,CACd,CAAC;QACJ,CAAC,CAAC,CACJ;QAAA,EAAE,UAAU,CACd;MAAA,EAAE,gBAAgB,CACpB;IAAA,EAAE,gBAAgB,CAAC,CACpB,CAAC;AACJ,CAAC","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"]}

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

@@ -1,5 +1,5 @@
 import React from 'react';
 import type { TileGridProps } from '../../../../types/grid-view';
 /*** Composes a responsive, virtualized tile presentation over the generic GridView renderer. */
-export declare function TileGrid({ items, width, height, tileSize, gap, zoom, overscanPixels, focusedItemId, revealPaddingPixels, onColumnsChange, onVisibleItemIdsChange, renderItem, interactionPolicy, testID, }: TileGridProps): React.JSX.Element;
+export declare function TileGrid({ items, width, height, tileSize, gap, zoom, viewport, defaultViewport, viewportConstraints, zoomLimits, overscanPixels, focusedItemId, revealPaddingPixels, onColumnsChange, onViewportChange, onVisibleItemIdsChange, renderItem, interactionPolicy, testID, }: TileGridProps): React.JSX.Element;
 //# sourceMappingURL=TileGrid.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"TileGrid.d.ts","sourceRoot":"","sources":["../../../../../src/features/grid-view/adapters/inbound/TileGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAIjE,gGAAgG;AAChG,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,KAAK,EACL,MAAY,EACZ,QAAc,EACd,GAAQ,EACR,IAAQ,EACR,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,UAAU,EACV,iBAAiB,EACjB,MAAM,GACP,EAAE,aAAa,qBAwCf"}
+{"version":3,"file":"TileGrid.d.ts","sourceRoot":"","sources":["../../../../../src/features/grid-view/adapters/inbound/TileGrid.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAIjE,gGAAgG;AAChG,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,KAAK,EACL,MAAY,EACZ,QAAc,EACd,GAAQ,EACR,IAAQ,EACR,QAAQ,EACR,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACV,iBAAiB,EACjB,MAAM,GACP,EAAE,aAAa,qBAyDf"}

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

@@ -3,20 +3,27 @@ import { View as NativeView } from 'react-native';
 import { layoutTileGrid } from '../../application/layoutTileGrid';
 import { GridView } from './GridView';
 /*** Composes a responsive, virtualized tile presentation over the generic GridView renderer. */
-export function TileGrid({ items, width, height = 440, tileSize = 120, gap = 12, zoom = 1, overscanPixels, focusedItemId, revealPaddingPixels, onColumnsChange, onVisibleItemIdsChange, renderItem, interactionPolicy, testID, }) {
+export function TileGrid({ items, width, height = 440, tileSize = 120, gap = 12, zoom = 1, viewport, defaultViewport, viewportConstraints, zoomLimits, overscanPixels, focusedItemId, revealPaddingPixels, onColumnsChange, onViewportChange, onVisibleItemIdsChange, renderItem, interactionPolicy, testID, }) {
     const [measuredWidth, setMeasuredWidth] = React.useState(0);
+    const [uncontrolledPixelsPerUnitX, setUncontrolledPixelsPerUnitX] = React.useState(() => defaultViewport?.pixelsPerUnitX ?? zoom);
     const resolvedWidth = width ?? measuredWidth;
-    const layout = React.useMemo(() => layoutTileGrid(items, resolvedWidth, tileSize, gap, zoom), [items, resolvedWidth, tileSize, gap, zoom]);
+    const pixelsPerUnitX = viewport?.pixelsPerUnitX ?? uncontrolledPixelsPerUnitX;
+    const layout = React.useMemo(() => layoutTileGrid(items, resolvedWidth, tileSize, gap, pixelsPerUnitX), [gap, items, pixelsPerUnitX, resolvedWidth, tileSize]);
     const itemLookup = React.useMemo(() => new Map(items.map((item) => [item.id, item])), [items]);
     React.useEffect(() => {
         if (resolvedWidth > 0)
             onColumnsChange?.(layout.columns);
     }, [layout.columns, onColumnsChange, resolvedWidth]);
+    const handleViewportChange = React.useCallback((nextViewport) => {
+        if (viewport === undefined)
+            setUncontrolledPixelsPerUnitX(nextViewport.pixelsPerUnitX);
+        onViewportChange?.(nextViewport);
+    }, [onViewportChange, viewport]);
     return (<NativeView onLayout={(event) => setMeasuredWidth(event.nativeEvent.layout.width)} style={{ width, height, overflow: 'hidden' }} testID={testID}>
-      {resolvedWidth > 0 ? (<GridView contentHeight={layout.height} contentWidth={Math.max(resolvedWidth / zoom, layout.width)} height={height} focusedItemId={focusedItemId} interactionPolicy={interactionPolicy} items={layout.items} onVisibleItemIdsChange={onVisibleItemIdsChange} overscanPixels={overscanPixels} renderItem={(item) => {
+      {resolvedWidth > 0 ? (<GridView contentHeight={layout.height} contentWidth={Math.max(resolvedWidth / pixelsPerUnitX, layout.width)} defaultViewport={defaultViewport} height={height} focusedItemId={focusedItemId} interactionPolicy={interactionPolicy} items={layout.items} onVisibleItemIdsChange={onVisibleItemIdsChange} onViewportChange={handleViewportChange} overscanPixels={overscanPixels} renderItem={(item) => {
                 const source = itemLookup.get(item.id);
                 return source ? renderItem(source) : null;
-            }} revealPaddingPixels={revealPaddingPixels} width={resolvedWidth} zoom={zoom}/>) : null}
+            }} revealPaddingPixels={revealPaddingPixels} width={resolvedWidth} viewport={viewport} viewportConstraints={viewportConstraints} zoomLimits={zoomLimits} zoom={zoom}/>) : null}
     </NativeView>);
 }
 //# sourceMappingURL=TileGrid.js.map