@ankhorage/zora 25.8.11 → 25.8.12

package/dist/features/grid-view/application/createGridScrollSync.js

@@ -0,0 +1,141 @@
+import { ANIMATED_SCROLL_WINDOW_MS, IMMEDIATE_SCROLL_WINDOW_MS, SCROLL_POSITION_TOLERANCE, } from '../constants/scroll';
+import { resolveScrollEventSource } from './resolveScrollEventSource';
+const AXES = ['x', 'y'];
+/***
+ * Arbitrates each native scroll axis between programmatic requests and the user,
+ * so echoes of GridView's own scrollTo calls never become viewport pans.
+ */
+export function createGridScrollSync({ scrollTo, onUserScroll, onProgrammaticScroll, now = Date.now, schedule = setTimeout, cancel = clearTimeout, }) {
+    let position = { x: 0, y: 0 };
+    const pending = new Map();
+    const inFlight = new Map();
+    // Keep ownership of late frames even after a stalled animation is reconciled.
+    const echoTails = new Map();
+    const timers = new Map();
+    const clearTimer = (axis) => {
+        const timer = timers.get(axis);
+        if (timer !== undefined)
+            cancel(timer);
+        timers.delete(axis);
+    };
+    const release = (axis) => {
+        clearTimer(axis);
+        pending.delete(axis);
+        inFlight.delete(axis);
+    };
+    const adopt = (axis, offset) => {
+        const displacement = offset - readAxis(position, axis);
+        position = withAxis(position, axis, offset);
+        if (displacement !== 0)
+            onUserScroll(axis, displacement);
+    };
+    const settle = (axis, finalOffset) => {
+        const pendingScroll = pending.get(axis);
+        const offset = finalOffset ?? inFlight.get(axis);
+        release(axis);
+        if (offset !== undefined) {
+            if (finalOffset === undefined &&
+                pendingScroll?.animated &&
+                !isSameOffset(offset, pendingScroll.target)) {
+                echoTails.set(axis, { lastOffset: offset, target: pendingScroll.target });
+            }
+            else {
+                echoTails.delete(axis);
+            }
+            adopt(axis, offset);
+        }
+    };
+    const scrolled = (axis, offset) => {
+        const tail = echoTails.get(axis);
+        if (tail) {
+            if (isContinuingProgrammaticEcho(tail, offset)) {
+                const displacement = offset - readAxis(position, axis);
+                position = withAxis(position, axis, offset);
+                if (displacement !== 0)
+                    onProgrammaticScroll(axis, displacement);
+                if (isSameOffset(offset, tail.target))
+                    echoTails.delete(axis);
+                else
+                    tail.lastOffset = offset;
+                return;
+            }
+            echoTails.delete(axis);
+        }
+        let pendingScroll = pending.get(axis);
+        if (pendingScroll?.animated && now() > pendingScroll.expiresAt) {
+            // A native scroll may deliver its first frame after the initial deadline.
+            // Without an explicit drag/end, that is still an echo of our scrollTo.
+            pendingScroll = { ...pendingScroll, expiresAt: now() + ANIMATED_SCROLL_WINDOW_MS };
+            pending.set(axis, pendingScroll);
+        }
+        const source = resolveScrollEventSource(pendingScroll, offset, now());
+        if (source === 'in-flight' && pendingScroll) {
+            clearTimer(axis);
+            inFlight.set(axis, offset);
+            // Native animation frames can pause longer than 120ms; only reconcile at the
+            // original request deadline, or earlier on an explicit drag/end/target echo.
+            timers.set(axis, schedule(() => settle(axis), Math.max(0, pendingScroll.expiresAt - now())));
+            return;
+        }
+        release(axis);
+        if (source === 'user')
+            adopt(axis, offset);
+    };
+    return {
+        isCurrent: (next) => AXES.every((axis) => isSameOffset(readAxis(position, axis), readAxis(next, axis))),
+        request: (next, animated) => {
+            const windowMs = animated ? ANIMATED_SCROLL_WINDOW_MS : IMMEDIATE_SCROLL_WINDOW_MS;
+            const expiresAt = now() + windowMs;
+            for (const axis of AXES) {
+                const target = readAxis(next, axis);
+                if (isSameOffset(readAxis(position, axis), target))
+                    continue;
+                release(axis);
+                echoTails.delete(axis);
+                pending.set(axis, { animated, expiresAt, target });
+                scrollTo(axis, target, animated);
+            }
+            position = next;
+        },
+        scrolled,
+        dragBegan: (axis, offset) => {
+            const hadTail = echoTails.delete(axis);
+            if (pending.has(axis) || inFlight.has(axis))
+                settle(axis, offset);
+            else if (hadTail)
+                adopt(axis, offset);
+        },
+        scrollEnded: (axis, offset) => {
+            scrolled(axis, offset);
+            echoTails.delete(axis);
+            if (pending.has(axis))
+                settle(axis, offset);
+        },
+        dispose: () => {
+            for (const axis of AXES)
+                release(axis);
+            echoTails.clear();
+        },
+    };
+}
+/*** Suppresses delayed monotonic frames toward the old programmatic target until an actual drag/end. */
+function isContinuingProgrammaticEcho({ lastOffset, target }, offset) {
+    const step = offset - lastOffset;
+    if (Math.abs(step) <= SCROLL_POSITION_TOLERANCE)
+        return true;
+    return (Math.sign(step) === Math.sign(target - lastOffset) &&
+        Math.abs(target - offset) <= Math.abs(target - lastOffset) + SCROLL_POSITION_TOLERANCE);
+}
+/*** Reads one axis of a physical scroll position. */
+function readAxis(value, axis) {
+    return axis === 'x' ? value.x : value.y;
+}
+/*** Replaces one axis of a physical scroll position. */
+function withAxis(value, axis, offset) {
+    return axis === 'x' ? { ...value, x: offset } : { ...value, y: offset };
+}
+/*** Treats offsets within the native positioning tolerance as the same scroll offset. */
+function isSameOffset(left, right) {
+    return Math.abs(left - right) <= SCROLL_POSITION_TOLERANCE;
+}
+//# sourceMappingURL=createGridScrollSync.js.map

package/dist/features/grid-view/application/createGridScrollSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGridScrollSync.js","sourceRoot":"","sources":["../../../../src/features/grid-view/application/createGridScrollSync.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  GridPendingScroll,\n  GridScrollAxis,\n  GridScrollPosition,\n  GridScrollSync,\n  GridScrollSyncOptions,\n} from '../../../types/grid-view';\nimport {\n  ANIMATED_SCROLL_WINDOW_MS,\n  IMMEDIATE_SCROLL_WINDOW_MS,\n  SCROLL_POSITION_TOLERANCE,\n} from '../constants/scroll';\nimport { resolveScrollEventSource } from './resolveScrollEventSource';\n\nconst AXES: readonly GridScrollAxis[] = ['x', 'y'];\ninterface EchoTail {\n  lastOffset: number;\n  target: number;\n}\n\n/***\n * Arbitrates each native scroll axis between programmatic requests and the user,\n * so echoes of GridView's own scrollTo calls never become viewport pans.\n */\nexport function createGridScrollSync({\n  scrollTo,\n  onUserScroll,\n  onProgrammaticScroll,\n  now = Date.now,\n  schedule = setTimeout,\n  cancel = clearTimeout,\n}: GridScrollSyncOptions): GridScrollSync {\n  let position: GridScrollPosition = { x: 0, y: 0 };\n  const pending = new Map<GridScrollAxis, GridPendingScroll>();\n  const inFlight = new Map<GridScrollAxis, number>();\n  // Keep ownership of late frames even after a stalled animation is reconciled.\n  const echoTails = new Map<GridScrollAxis, EchoTail>();\n  const timers = new Map<GridScrollAxis, ReturnType<typeof setTimeout>>();\n\n  const clearTimer = (axis: GridScrollAxis) => {\n    const timer = timers.get(axis);\n    if (timer !== undefined) cancel(timer);\n    timers.delete(axis);\n  };\n  const release = (axis: GridScrollAxis) => {\n    clearTimer(axis);\n    pending.delete(axis);\n    inFlight.delete(axis);\n  };\n  const adopt = (axis: GridScrollAxis, offset: number) => {\n    const displacement = offset - readAxis(position, axis);\n    position = withAxis(position, axis, offset);\n    if (displacement !== 0) onUserScroll(axis, displacement);\n  };\n  const settle = (axis: GridScrollAxis, finalOffset?: number) => {\n    const pendingScroll = pending.get(axis);\n    const offset = finalOffset ?? inFlight.get(axis);\n    release(axis);\n    if (offset !== undefined) {\n      if (\n        finalOffset === undefined &&\n        pendingScroll?.animated &&\n        !isSameOffset(offset, pendingScroll.target)\n      ) {\n        echoTails.set(axis, { lastOffset: offset, target: pendingScroll.target });\n      } else {\n        echoTails.delete(axis);\n      }\n      adopt(axis, offset);\n    }\n  };\n  const scrolled = (axis: GridScrollAxis, offset: number) => {\n    const tail = echoTails.get(axis);\n    if (tail) {\n      if (isContinuingProgrammaticEcho(tail, offset)) {\n        const displacement = offset - readAxis(position, axis);\n        position = withAxis(position, axis, offset);\n        if (displacement !== 0) onProgrammaticScroll(axis, displacement);\n        if (isSameOffset(offset, tail.target)) echoTails.delete(axis);\n        else tail.lastOffset = offset;\n        return;\n      }\n      echoTails.delete(axis);\n    }\n    let pendingScroll = pending.get(axis);\n    if (pendingScroll?.animated && now() > pendingScroll.expiresAt) {\n      // A native scroll may deliver its first frame after the initial deadline.\n      // Without an explicit drag/end, that is still an echo of our scrollTo.\n      pendingScroll = { ...pendingScroll, expiresAt: now() + ANIMATED_SCROLL_WINDOW_MS };\n      pending.set(axis, pendingScroll);\n    }\n    const source = resolveScrollEventSource(pendingScroll, offset, now());\n    if (source === 'in-flight' && pendingScroll) {\n      clearTimer(axis);\n      inFlight.set(axis, offset);\n      // Native animation frames can pause longer than 120ms; only reconcile at the\n      // original request deadline, or earlier on an explicit drag/end/target echo.\n      timers.set(\n        axis,\n        schedule(() => settle(axis), Math.max(0, pendingScroll.expiresAt - now())),\n      );\n      return;\n    }\n    release(axis);\n    if (source === 'user') adopt(axis, offset);\n  };\n\n  return {\n    isCurrent: (next) =>\n      AXES.every((axis) => isSameOffset(readAxis(position, axis), readAxis(next, axis))),\n    request: (next, animated) => {\n      const windowMs = animated ? ANIMATED_SCROLL_WINDOW_MS : IMMEDIATE_SCROLL_WINDOW_MS;\n      const expiresAt = now() + windowMs;\n      for (const axis of AXES) {\n        const target = readAxis(next, axis);\n        if (isSameOffset(readAxis(position, axis), target)) continue;\n        release(axis);\n        echoTails.delete(axis);\n        pending.set(axis, { animated, expiresAt, target });\n        scrollTo(axis, target, animated);\n      }\n      position = next;\n    },\n    scrolled,\n    dragBegan: (axis, offset) => {\n      const hadTail = echoTails.delete(axis);\n      if (pending.has(axis) || inFlight.has(axis)) settle(axis, offset);\n      else if (hadTail) adopt(axis, offset);\n    },\n    scrollEnded: (axis, offset) => {\n      scrolled(axis, offset);\n      echoTails.delete(axis);\n      if (pending.has(axis)) settle(axis, offset);\n    },\n    dispose: () => {\n      for (const axis of AXES) release(axis);\n      echoTails.clear();\n    },\n  };\n}\n\n/*** Suppresses delayed monotonic frames toward the old programmatic target until an actual drag/end. */\nfunction isContinuingProgrammaticEcho({ lastOffset, target }: EchoTail, offset: number): boolean {\n  const step = offset - lastOffset;\n  if (Math.abs(step) <= SCROLL_POSITION_TOLERANCE) return true;\n  return (\n    Math.sign(step) === Math.sign(target - lastOffset) &&\n    Math.abs(target - offset) <= Math.abs(target - lastOffset) + SCROLL_POSITION_TOLERANCE\n  );\n}\n\n/*** Reads one axis of a physical scroll position. */\nfunction readAxis(value: GridScrollPosition, axis: GridScrollAxis): number {\n  return axis === 'x' ? value.x : value.y;\n}\n\n/*** Replaces one axis of a physical scroll position. */\nfunction withAxis(\n  value: GridScrollPosition,\n  axis: GridScrollAxis,\n  offset: number,\n): GridScrollPosition {\n  return axis === 'x' ? { ...value, x: offset } : { ...value, y: offset };\n}\n\n/*** Treats offsets within the native positioning tolerance as the same scroll offset. */\nfunction isSameOffset(left: number, right: number): boolean {\n  return Math.abs(left - right) <= SCROLL_POSITION_TOLERANCE;\n}\n"]}

package/dist/features/grid-view/application/resolveScrollEventSource.d.ts

@@ -0,0 +1,4 @@
+import type { GridPendingScroll } from '../../../types/grid-view';
+/*** Classifies a native scroll offset as a user gesture, the settled echo of a programmatic scroll, or an in-flight frame of one. */
+export declare function resolveScrollEventSource(pending: GridPendingScroll | undefined, offset: number, now: number): 'in-flight' | 'settled' | 'user';
+//# sourceMappingURL=resolveScrollEventSource.d.ts.map

package/dist/features/grid-view/application/resolveScrollEventSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveScrollEventSource.d.ts","sourceRoot":"","sources":["../../../../src/features/grid-view/application/resolveScrollEventSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,qIAAqI;AACrI,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,WAAW,GAAG,SAAS,GAAG,MAAM,CAGlC"}

package/dist/features/grid-view/application/resolveScrollEventSource.js

@@ -0,0 +1,8 @@
+import { SCROLL_POSITION_TOLERANCE } from '../constants/scroll';
+/*** Classifies a native scroll offset as a user gesture, the settled echo of a programmatic scroll, or an in-flight frame of one. */
+export function resolveScrollEventSource(pending, offset, now) {
+    if (pending === undefined || now > pending.expiresAt)
+        return 'user';
+    return Math.abs(offset - pending.target) <= SCROLL_POSITION_TOLERANCE ? 'settled' : 'in-flight';
+}
+//# sourceMappingURL=resolveScrollEventSource.js.map

package/dist/features/grid-view/application/resolveScrollEventSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveScrollEventSource.js","sourceRoot":"","sources":["../../../../src/features/grid-view/application/resolveScrollEventSource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,qIAAqI;AACrI,MAAM,UAAU,wBAAwB,CACtC,OAAsC,EACtC,MAAc,EACd,GAAW;IAEX,IAAI,OAAO,KAAK,SAAS,IAAI,GAAG,GAAG,OAAO,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC;IACpE,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,yBAAyB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;AAClG,CAAC","sourcesContent":["import type { GridPendingScroll } from '../../../types/grid-view';\nimport { SCROLL_POSITION_TOLERANCE } from '../constants/scroll';\n\n/*** Classifies a native scroll offset as a user gesture, the settled echo of a programmatic scroll, or an in-flight frame of one. */\nexport function resolveScrollEventSource(\n  pending: GridPendingScroll | undefined,\n  offset: number,\n  now: number,\n): 'in-flight' | 'settled' | 'user' {\n  if (pending === undefined || now > pending.expiresAt) return 'user';\n  return Math.abs(offset - pending.target) <= SCROLL_POSITION_TOLERANCE ? 'settled' : 'in-flight';\n}\n"]}

package/dist/features/grid-view/constants/scroll.d.ts

@@ -0,0 +1,7 @@
+/** Largest native-versus-requested scroll offset difference, in pixels, still treated as the same position. */
+export declare const SCROLL_POSITION_TOLERANCE = 1;
+/** Upper bound for a native animated `scrollTo` to deliver its settled offset. */
+export declare const ANIMATED_SCROLL_WINDOW_MS = 700;
+/** Upper bound for an immediate `scrollTo` to deliver its settled offset. */
+export declare const IMMEDIATE_SCROLL_WINDOW_MS = 120;
+//# sourceMappingURL=scroll.d.ts.map

package/dist/features/grid-view/constants/scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.d.ts","sourceRoot":"","sources":["../../../../src/features/grid-view/constants/scroll.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,kFAAkF;AAClF,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,6EAA6E;AAC7E,eAAO,MAAM,0BAA0B,MAAM,CAAC"}

package/dist/features/grid-view/constants/scroll.js

@@ -0,0 +1,7 @@
+/** Largest native-versus-requested scroll offset difference, in pixels, still treated as the same position. */
+export const SCROLL_POSITION_TOLERANCE = 1;
+/** Upper bound for a native animated `scrollTo` to deliver its settled offset. */
+export const ANIMATED_SCROLL_WINDOW_MS = 700;
+/** Upper bound for an immediate `scrollTo` to deliver its settled offset. */
+export const IMMEDIATE_SCROLL_WINDOW_MS = 120;
+//# sourceMappingURL=scroll.js.map

package/dist/features/grid-view/constants/scroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.js","sourceRoot":"","sources":["../../../../src/features/grid-view/constants/scroll.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAE3C,kFAAkF;AAClF,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C,6EAA6E;AAC7E,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC","sourcesContent":["/** Largest native-versus-requested scroll offset difference, in pixels, still treated as the same position. */\nexport const SCROLL_POSITION_TOLERANCE = 1;\n\n/** Upper bound for a native animated `scrollTo` to deliver its settled offset. */\nexport const ANIMATED_SCROLL_WINDOW_MS = 700;\n\n/** Upper bound for an immediate `scrollTo` to deliver its settled offset. */\nexport const IMMEDIATE_SCROLL_WINDOW_MS = 120;\n"]}

package/dist/features/layout/adapters/inbound/ScrollGestureLockContext.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { ScrollGestureLock } from '../../../../types/layout';
+/*** Carries the nearest ZORA ScrollView gesture lock to descendant gesture surfaces. */
+export declare const ScrollGestureLockContext: React.Context<ScrollGestureLock | undefined>;
+//# sourceMappingURL=ScrollGestureLockContext.d.ts.map

package/dist/features/layout/adapters/inbound/ScrollGestureLockContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollGestureLockContext.d.ts","sourceRoot":"","sources":["../../../../../src/features/layout/adapters/inbound/ScrollGestureLockContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,wFAAwF;AACxF,eAAO,MAAM,wBAAwB,8CAEpC,CAAC"}

package/dist/features/layout/adapters/inbound/ScrollGestureLockContext.js

@@ -0,0 +1,4 @@
+import React from 'react';
+/*** Carries the nearest ZORA ScrollView gesture lock to descendant gesture surfaces. */
+export const ScrollGestureLockContext = React.createContext(undefined);
+//# sourceMappingURL=ScrollGestureLockContext.js.map

package/dist/features/layout/adapters/inbound/ScrollGestureLockContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollGestureLockContext.js","sourceRoot":"","sources":["../../../../../src/features/layout/adapters/inbound/ScrollGestureLockContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,wFAAwF;AACxF,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC,aAAa,CACzD,SAAS,CACV,CAAC","sourcesContent":["import React from 'react';\n\nimport type { ScrollGestureLock } from '../../../../types/layout';\n\n/*** Carries the nearest ZORA ScrollView gesture lock to descendant gesture surfaces. */\nexport const ScrollGestureLockContext = React.createContext<ScrollGestureLock | undefined>(\n  undefined,\n);\n"]}

package/dist/features/layout/adapters/inbound/ScrollView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScrollView.d.ts","sourceRoot":"","sources":["../../../../../src/features/layout/adapters/inbound/ScrollView.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGhE,gFAAgF;AAChF,eAAO,MAAM,UAAU,uDAAsC,CAAC"}
+{"version":3,"file":"ScrollView.d.ts","sourceRoot":"","sources":["../../../../../src/features/layout/adapters/inbound/ScrollView.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAMhE,gFAAgF;AAChF,eAAO,MAAM,UAAU,uDAAsC,CAAC"}

package/dist/features/layout/adapters/inbound/ScrollView.js

@@ -1,10 +1,18 @@
 import { ScrollView as SurfaceScrollView } from '@ankhorage/surface';
 import React from 'react';
 import { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';
+import { createScrollGestureLock } from '../../utils/createScrollGestureLock';
+import { ScrollGestureLockContext } from './ScrollGestureLockContext';
+import { useScrollGestureLock } from './useScrollGestureLock';
 /*** Adapts the token-aware Surface ScrollView primitive to ZORA theme scope. */
 export const ScrollView = withZoraThemeScope(ScrollViewInner);
-/*** Forwards ZORA scrolling props to the published Surface ScrollView boundary. */
-function ScrollViewInner({ themeId: _themeId, mode: _mode, interactionPolicy: _interactionPolicy, ...props }) {
-    return <SurfaceScrollView {...props}/>;
+/*** Forwards ZORA scrolling props to the published Surface ScrollView boundary and yields scrolling to active descendant gestures. */
+function ScrollViewInner({ themeId: _themeId, mode: _mode, interactionPolicy: _interactionPolicy, scrollEnabled = true, ...props }) {
+    const parentLock = useScrollGestureLock();
+    const [activeGestures, setActiveGestures] = React.useState(0);
+    const lock = React.useMemo(() => createScrollGestureLock(parentLock, (delta) => setActiveGestures((count) => count + delta)), [parentLock]);
+    return (<ScrollGestureLockContext.Provider value={lock}>
+      <SurfaceScrollView {...props} scrollEnabled={scrollEnabled && activeGestures === 0}/>
+    </ScrollGestureLockContext.Provider>);
 }
 //# sourceMappingURL=ScrollView.js.map

package/dist/features/layout/adapters/inbound/ScrollView.js.map

@@ -1 +1 @@
-{"version":3,"file":"ScrollView.js","sourceRoot":"","sources":["../../../../../src/features/layout/adapters/inbound/ScrollView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAExF,gFAAgF;AAChF,MAAM,CAAC,MAAM,UAAU,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC;AAE9D,mFAAmF;AACnF,SAAS,eAAe,CAAC,EACvB,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,KAAK,EACX,iBAAiB,EAAE,kBAAkB,EACrC,GAAG,KAAK,EACQ;IAChB,OAAO,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,EAAG,CAAC;AAC1C,CAAC","sourcesContent":["import { ScrollView as SurfaceScrollView } from '@ankhorage/surface';\nimport React from 'react';\n\nimport type { ScrollViewProps } from '../../../../types/layout';\nimport { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';\n\n/*** Adapts the token-aware Surface ScrollView primitive to ZORA theme scope. */\nexport const ScrollView = withZoraThemeScope(ScrollViewInner);\n\n/*** Forwards ZORA scrolling props to the published Surface ScrollView boundary. */\nfunction ScrollViewInner({\n  themeId: _themeId,\n  mode: _mode,\n  interactionPolicy: _interactionPolicy,\n  ...props\n}: ScrollViewProps) {\n  return <SurfaceScrollView {...props} />;\n}\n"]}
+{"version":3,"file":"ScrollView.js","sourceRoot":"","sources":["../../../../../src/features/layout/adapters/inbound/ScrollView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,gFAAgF;AAChF,MAAM,CAAC,MAAM,UAAU,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC;AAE9D,sIAAsI;AACtI,SAAS,eAAe,CAAC,EACvB,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,KAAK,EACX,iBAAiB,EAAE,kBAAkB,EACrC,aAAa,GAAG,IAAI,EACpB,GAAG,KAAK,EACQ;IAChB,MAAM,UAAU,GAAG,oBAAoB,EAAE,CAAC;IAC1C,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CACxB,GAAG,EAAE,CACH,uBAAuB,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,EAC7F,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,OAAO,CACL,CAAC,wBAAwB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAC7C;MAAA,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,CAAC,aAAa,CAAC,CAAC,aAAa,IAAI,cAAc,KAAK,CAAC,CAAC,EACrF;IAAA,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CACrC,CAAC;AACJ,CAAC","sourcesContent":["import { ScrollView as SurfaceScrollView } from '@ankhorage/surface';\nimport React from 'react';\n\nimport type { ScrollViewProps } from '../../../../types/layout';\nimport { withZoraThemeScope } from '../../../theme/adapters/inbound/withZoraThemeScope';\nimport { createScrollGestureLock } from '../../utils/createScrollGestureLock';\nimport { ScrollGestureLockContext } from './ScrollGestureLockContext';\nimport { useScrollGestureLock } from './useScrollGestureLock';\n\n/*** Adapts the token-aware Surface ScrollView primitive to ZORA theme scope. */\nexport const ScrollView = withZoraThemeScope(ScrollViewInner);\n\n/*** Forwards ZORA scrolling props to the published Surface ScrollView boundary and yields scrolling to active descendant gestures. */\nfunction ScrollViewInner({\n  themeId: _themeId,\n  mode: _mode,\n  interactionPolicy: _interactionPolicy,\n  scrollEnabled = true,\n  ...props\n}: ScrollViewProps) {\n  const parentLock = useScrollGestureLock();\n  const [activeGestures, setActiveGestures] = React.useState(0);\n  const lock = React.useMemo(\n    () =>\n      createScrollGestureLock(parentLock, (delta) => setActiveGestures((count) => count + delta)),\n    [parentLock],\n  );\n\n  return (\n    <ScrollGestureLockContext.Provider value={lock}>\n      <SurfaceScrollView {...props} scrollEnabled={scrollEnabled && activeGestures === 0} />\n    </ScrollGestureLockContext.Provider>\n  );\n}\n"]}

package/dist/features/layout/adapters/inbound/useScrollGestureLock.d.ts

@@ -0,0 +1,4 @@
+import type { ScrollGestureLock } from '../../../../types/layout';
+/*** Resolves the nearest ZORA ScrollView lock, or an inert lock when no scroll container exists. */
+export declare function useScrollGestureLock(): ScrollGestureLock;
+//# sourceMappingURL=useScrollGestureLock.d.ts.map

package/dist/features/layout/adapters/inbound/useScrollGestureLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollGestureLock.d.ts","sourceRoot":"","sources":["../../../../../src/features/layout/adapters/inbound/useScrollGestureLock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAKlE,oGAAoG;AACpG,wBAAgB,oBAAoB,IAAI,iBAAiB,CAExD"}

package/dist/features/layout/adapters/inbound/useScrollGestureLock.js

@@ -0,0 +1,8 @@
+import React from 'react';
+import { ScrollGestureLockContext } from './ScrollGestureLockContext';
+const unlockedScrollGesture = { acquire: () => () => undefined };
+/*** Resolves the nearest ZORA ScrollView lock, or an inert lock when no scroll container exists. */
+export function useScrollGestureLock() {
+    return React.useContext(ScrollGestureLockContext) ?? unlockedScrollGesture;
+}
+//# sourceMappingURL=useScrollGestureLock.js.map

package/dist/features/layout/adapters/inbound/useScrollGestureLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollGestureLock.js","sourceRoot":"","sources":["../../../../../src/features/layout/adapters/inbound/useScrollGestureLock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,MAAM,qBAAqB,GAAsB,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;AAEpF,oGAAoG;AACpG,MAAM,UAAU,oBAAoB;IAClC,OAAO,KAAK,CAAC,UAAU,CAAC,wBAAwB,CAAC,IAAI,qBAAqB,CAAC;AAC7E,CAAC","sourcesContent":["import React from 'react';\n\nimport type { ScrollGestureLock } from '../../../../types/layout';\nimport { ScrollGestureLockContext } from './ScrollGestureLockContext';\n\nconst unlockedScrollGesture: ScrollGestureLock = { acquire: () => () => undefined };\n\n/*** Resolves the nearest ZORA ScrollView lock, or an inert lock when no scroll container exists. */\nexport function useScrollGestureLock(): ScrollGestureLock {\n  return React.useContext(ScrollGestureLockContext) ?? unlockedScrollGesture;\n}\n"]}

package/dist/features/layout/public.d.ts

@@ -1,8 +1,9 @@
-export type { AppShellProps, DividerProps, GridProps, ScreenProps, ScrollViewProps, ViewProps, } from '../../types/layout';
+export type { AppShellProps, DividerProps, GridProps, ScreenProps, ScrollGestureLock, ScrollViewProps, ViewProps, } from '../../types/layout';
 export { AppShell } from './adapters/inbound/AppShell';
 export { Divider } from './adapters/inbound/Divider';
 export { Grid } from './adapters/inbound/Grid';
 export { Screen } from './adapters/inbound/Screen';
 export { ScrollView } from './adapters/inbound/ScrollView';
+export { useScrollGestureLock } from './adapters/inbound/useScrollGestureLock';
 export { View } from './adapters/inbound/View';
 //# sourceMappingURL=public.d.ts.map

package/dist/features/layout/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/features/layout/public.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,YAAY,EACZ,SAAS,EACT,WAAW,EACX,eAAe,EACf,SAAS,GACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/features/layout/public.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,YAAY,EACZ,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,SAAS,GACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/features/layout/public.js

@@ -3,5 +3,6 @@ export { Divider } from './adapters/inbound/Divider';
 export { Grid } from './adapters/inbound/Grid';
 export { Screen } from './adapters/inbound/Screen';
 export { ScrollView } from './adapters/inbound/ScrollView';
+export { useScrollGestureLock } from './adapters/inbound/useScrollGestureLock';
 export { View } from './adapters/inbound/View';
 //# sourceMappingURL=public.js.map

package/dist/features/layout/public.js.map

@@ -1 +1 @@
-{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/features/layout/public.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC","sourcesContent":["export type {\n  AppShellProps,\n  DividerProps,\n  GridProps,\n  ScreenProps,\n  ScrollViewProps,\n  ViewProps,\n} from '../../types/layout';\nexport { AppShell } from './adapters/inbound/AppShell';\nexport { Divider } from './adapters/inbound/Divider';\nexport { Grid } from './adapters/inbound/Grid';\nexport { Screen } from './adapters/inbound/Screen';\nexport { ScrollView } from './adapters/inbound/ScrollView';\nexport { View } from './adapters/inbound/View';\n"]}
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/features/layout/public.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC","sourcesContent":["export type {\n  AppShellProps,\n  DividerProps,\n  GridProps,\n  ScreenProps,\n  ScrollGestureLock,\n  ScrollViewProps,\n  ViewProps,\n} from '../../types/layout';\nexport { AppShell } from './adapters/inbound/AppShell';\nexport { Divider } from './adapters/inbound/Divider';\nexport { Grid } from './adapters/inbound/Grid';\nexport { Screen } from './adapters/inbound/Screen';\nexport { ScrollView } from './adapters/inbound/ScrollView';\nexport { useScrollGestureLock } from './adapters/inbound/useScrollGestureLock';\nexport { View } from './adapters/inbound/View';\n"]}

package/dist/features/layout/utils/createScrollGestureLock.d.ts

@@ -0,0 +1,4 @@
+import type { ScrollGestureLock } from '../../../types/layout';
+/*** Creates a lock that reports each held gesture to its scroll container and also suspends every ancestor container. */
+export declare function createScrollGestureLock(parent: ScrollGestureLock, onActiveGesturesChange: (delta: 1 | -1) => void): ScrollGestureLock;
+//# sourceMappingURL=createScrollGestureLock.d.ts.map

package/dist/features/layout/utils/createScrollGestureLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createScrollGestureLock.d.ts","sourceRoot":"","sources":["../../../../src/features/layout/utils/createScrollGestureLock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,yHAAyH;AACzH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,EACzB,sBAAsB,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,GAC9C,iBAAiB,CAcnB"}

package/dist/features/layout/utils/createScrollGestureLock.js

@@ -0,0 +1,18 @@
+/*** Creates a lock that reports each held gesture to its scroll container and also suspends every ancestor container. */
+export function createScrollGestureLock(parent, onActiveGesturesChange) {
+    return {
+        acquire: () => {
+            const releaseParent = parent.acquire();
+            let released = false;
+            onActiveGesturesChange(1);
+            return () => {
+                if (released)
+                    return;
+                released = true;
+                onActiveGesturesChange(-1);
+                releaseParent();
+            };
+        },
+    };
+}
+//# sourceMappingURL=createScrollGestureLock.js.map

package/dist/features/layout/utils/createScrollGestureLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createScrollGestureLock.js","sourceRoot":"","sources":["../../../../src/features/layout/utils/createScrollGestureLock.ts"],"names":[],"mappings":"AAEA,yHAAyH;AACzH,MAAM,UAAU,uBAAuB,CACrC,MAAyB,EACzB,sBAA+C;IAE/C,OAAO;QACL,OAAO,EAAE,GAAG,EAAE;YACZ,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YACvC,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,sBAAsB,CAAC,CAAC,CAAC,CAAC;YAC1B,OAAO,GAAG,EAAE;gBACV,IAAI,QAAQ;oBAAE,OAAO;gBACrB,QAAQ,GAAG,IAAI,CAAC;gBAChB,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3B,aAAa,EAAE,CAAC;YAClB,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { ScrollGestureLock } from '../../../types/layout';\n\n/*** Creates a lock that reports each held gesture to its scroll container and also suspends every ancestor container. */\nexport function createScrollGestureLock(\n  parent: ScrollGestureLock,\n  onActiveGesturesChange: (delta: 1 | -1) => void,\n): ScrollGestureLock {\n  return {\n    acquire: () => {\n      const releaseParent = parent.acquire();\n      let released = false;\n      onActiveGesturesChange(1);\n      return () => {\n        if (released) return;\n        released = true;\n        onActiveGesturesChange(-1);\n        releaseParent();\n      };\n    },\n  };\n}\n"]}

package/dist/types/grid-interactions.d.ts

@@ -55,4 +55,9 @@ export interface GridInteractionsController {
     readonly keyDown: (key: string, pointer?: GridInteractionPointer) => boolean;
     readonly update: (props: GridInteractionsControllerProps) => void;
 }
+/** Gesture-scoped ownership of ancestor scrolling for one interaction surface. */
+export interface GridInteractionScrollLock {
+    readonly acquire: () => void;
+    readonly release: () => void;
+}
 //# sourceMappingURL=grid-interactions.d.ts.map

package/dist/types/grid-interactions.d.ts.map

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

package/dist/types/grid-interactions.js.map

@@ -1 +1 @@
-{"version":3,"file":"grid-interactions.js","sourceRoot":"","sources":["../../src/types/grid-interactions.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  GridInteractionRectItem,\n  GridMarqueeSelectionMode,\n  GridRect,\n  GridResizeHandle,\n  GridSnapCandidate,\n  GridViewport,\n} from '@ankhorage/grid-view';\nimport type React from 'react';\n\nimport type { ZoraBaseProps } from './base';\n\n/** A caller-owned world item accepted by the platform interaction adapter. */\nexport interface GridInteractionItem extends GridInteractionRectItem {\n  readonly readOnly?: boolean;\n  readonly passive?: boolean;\n}\n\n/** Caller-controlled snapping inputs for both world axes. */\nexport interface GridInteractionSnap {\n  readonly enabled?: boolean;\n  readonly tolerancePixels: number;\n  readonly priorities: readonly GridSnapCandidate['kind'][];\n  readonly x?: readonly GridSnapCandidate[];\n  readonly y?: readonly GridSnapCandidate[];\n}\n\n/** Events emitted by the adapter; callers remain responsible for mutations. */\nexport interface GridInteractionIntent {\n  readonly type: 'select' | 'move' | 'resize' | 'marquee' | 'pan';\n  readonly itemIds: readonly string[];\n  readonly rects?: readonly GridInteractionItem[];\n  readonly marquee?: GridRect;\n  readonly viewport?: GridViewport;\n}\n\n/** Public, controlled inputs for generic world-space grid interaction. */\nexport interface GridInteractionsProps extends ZoraBaseProps {\n  readonly children: React.ReactNode;\n  readonly viewport: GridViewport;\n  readonly items: readonly GridInteractionItem[];\n  readonly selectedIds?: readonly string[];\n  readonly marqueeMode?: GridMarqueeSelectionMode;\n  /** Identifies the resize handle represented by this interaction surface. */\n  readonly resizeHandle?: GridResizeHandle;\n  readonly snap?: GridInteractionSnap;\n  readonly onIntent: (intent: GridInteractionIntent) => void;\n}\n\n/** The non-visual controlled contract consumed by the platform-neutral controller. */\nexport type GridInteractionsControllerProps = Omit<GridInteractionsProps, 'children'>;\n\n/** Pointer coordinates in viewport pixels, independent of native or web event shapes. */\nexport interface GridInteractionPointer {\n  readonly x: number;\n  readonly y: number;\n  readonly shiftKey?: boolean;\n  readonly metaKey?: boolean;\n  readonly ctrlKey?: boolean;\n  readonly altKey?: boolean;\n  readonly spaceKey?: boolean;\n}\n\n/** Imperative handlers supplied to native responders or web pointer adapters. */\nexport interface GridInteractionsController {\n  readonly begin: (pointer: GridInteractionPointer, handle?: GridResizeHandle) => void;\n  readonly move: (pointer: GridInteractionPointer) => void;\n  readonly end: (pointer: GridInteractionPointer) => void;\n  readonly cancel: () => void;\n  readonly keyDown: (key: string, pointer?: GridInteractionPointer) => boolean;\n  readonly update: (props: GridInteractionsControllerProps) => void;\n}\n"]}
+{"version":3,"file":"grid-interactions.js","sourceRoot":"","sources":["../../src/types/grid-interactions.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  GridInteractionRectItem,\n  GridMarqueeSelectionMode,\n  GridRect,\n  GridResizeHandle,\n  GridSnapCandidate,\n  GridViewport,\n} from '@ankhorage/grid-view';\nimport type React from 'react';\n\nimport type { ZoraBaseProps } from './base';\n\n/** A caller-owned world item accepted by the platform interaction adapter. */\nexport interface GridInteractionItem extends GridInteractionRectItem {\n  readonly readOnly?: boolean;\n  readonly passive?: boolean;\n}\n\n/** Caller-controlled snapping inputs for both world axes. */\nexport interface GridInteractionSnap {\n  readonly enabled?: boolean;\n  readonly tolerancePixels: number;\n  readonly priorities: readonly GridSnapCandidate['kind'][];\n  readonly x?: readonly GridSnapCandidate[];\n  readonly y?: readonly GridSnapCandidate[];\n}\n\n/** Events emitted by the adapter; callers remain responsible for mutations. */\nexport interface GridInteractionIntent {\n  readonly type: 'select' | 'move' | 'resize' | 'marquee' | 'pan';\n  readonly itemIds: readonly string[];\n  readonly rects?: readonly GridInteractionItem[];\n  readonly marquee?: GridRect;\n  readonly viewport?: GridViewport;\n}\n\n/** Public, controlled inputs for generic world-space grid interaction. */\nexport interface GridInteractionsProps extends ZoraBaseProps {\n  readonly children: React.ReactNode;\n  readonly viewport: GridViewport;\n  readonly items: readonly GridInteractionItem[];\n  readonly selectedIds?: readonly string[];\n  readonly marqueeMode?: GridMarqueeSelectionMode;\n  /** Identifies the resize handle represented by this interaction surface. */\n  readonly resizeHandle?: GridResizeHandle;\n  readonly snap?: GridInteractionSnap;\n  readonly onIntent: (intent: GridInteractionIntent) => void;\n}\n\n/** The non-visual controlled contract consumed by the platform-neutral controller. */\nexport type GridInteractionsControllerProps = Omit<GridInteractionsProps, 'children'>;\n\n/** Pointer coordinates in viewport pixels, independent of native or web event shapes. */\nexport interface GridInteractionPointer {\n  readonly x: number;\n  readonly y: number;\n  readonly shiftKey?: boolean;\n  readonly metaKey?: boolean;\n  readonly ctrlKey?: boolean;\n  readonly altKey?: boolean;\n  readonly spaceKey?: boolean;\n}\n\n/** Imperative handlers supplied to native responders or web pointer adapters. */\nexport interface GridInteractionsController {\n  readonly begin: (pointer: GridInteractionPointer, handle?: GridResizeHandle) => void;\n  readonly move: (pointer: GridInteractionPointer) => void;\n  readonly end: (pointer: GridInteractionPointer) => void;\n  readonly cancel: () => void;\n  readonly keyDown: (key: string, pointer?: GridInteractionPointer) => boolean;\n  readonly update: (props: GridInteractionsControllerProps) => void;\n}\n\n/** Gesture-scoped ownership of ancestor scrolling for one interaction surface. */\nexport interface GridInteractionScrollLock {\n  readonly acquire: () => void;\n  readonly release: () => void;\n}\n"]}

package/dist/types/grid-view.d.ts

@@ -55,4 +55,44 @@ export interface TileGridProps extends ZoraBaseProps {
     onVisibleItemIdsChange?: (ids: readonly string[]) => void;
     renderItem: (item: TileGridItem) => React.ReactNode;
 }
+/** The two independent native scroll axes that back a GridView viewport. */
+export type GridScrollAxis = 'x' | 'y';
+/** A physical native scroll position in pixels. */
+export interface GridScrollPosition {
+    readonly x: number;
+    readonly y: number;
+}
+/** A programmatic native scroll request that GridView is still waiting to observe. */
+export interface GridPendingScroll {
+    readonly animated: boolean;
+    readonly expiresAt: number;
+    readonly target: number;
+}
+/** Native capabilities and clock used by the programmatic-versus-user scroll arbiter. */
+export interface GridScrollSyncOptions {
+    /** Requests a native scroll of one axis. */
+    readonly scrollTo: (axis: GridScrollAxis, offset: number, animated: boolean) => void;
+    /** Reports a genuine user scroll as the pixel displacement of the native offset. */
+    readonly onUserScroll: (axis: GridScrollAxis, displacement: number) => void;
+    /** Reconciles a late programmatic native frame without classifying it as a user pan. */
+    readonly onProgrammaticScroll: (axis: GridScrollAxis, displacement: number) => void;
+    readonly now?: () => number;
+    readonly schedule?: (callback: () => void, delay: number) => ReturnType<typeof setTimeout>;
+    readonly cancel?: (handle: ReturnType<typeof setTimeout>) => void;
+}
+/** Separates echoes of programmatic scrolls from user scrolling, independently per axis. */
+export interface GridScrollSync {
+    /** True when the baseline already matches the position within native tolerance. */
+    readonly isCurrent: (position: GridScrollPosition) => boolean;
+    /** Moves native scrolling to a viewport-derived position. */
+    readonly request: (position: GridScrollPosition, animated: boolean) => void;
+    /** Routes one native scroll event. */
+    readonly scrolled: (axis: GridScrollAxis, offset: number) => void;
+    /** Hands an axis to the user, adopting the native offset at the start of their drag. */
+    readonly dragBegan: (axis: GridScrollAxis, offset: number) => void;
+    /** Adopts the final native offset when a programmatic or momentum scroll ends. */
+    readonly scrollEnded: (axis: GridScrollAxis, offset: number) => void;
+    /** Cancels every pending settle timer. */
+    readonly dispose: () => void;
+}
 //# sourceMappingURL=grid-view.d.ts.map

package/dist/types/grid-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grid-view.d.ts","sourceRoot":"","sources":["../../src/types/grid-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,uBAAuB,EACvB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,gFAAgF;AAChF,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,qFAAqF;IACrF,eAAe,CAAC,EAAE,OAAO,CACvB,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,SAAS,GAAG,gBAAgB,GAAG,gBAAgB,CAAC,CAChF,CAAC;IACF,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;IAC9C,6EAA6E;IAC7E,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kGAAkG;IAClG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IACpD,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAC1D,UAAU,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,KAAK,CAAC,SAAS,CAAC;CACrD;AAED,yFAAyF;AACzF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CACvB,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,SAAS,GAAG,gBAAgB,GAAG,gBAAgB,CAAC,CAChF,CAAC;IACF,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;IAC9C,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qEAAqE;IACrE,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IACpD,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAC1D,UAAU,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,KAAK,CAAC,SAAS,CAAC;CACrD"}
+{"version":3,"file":"grid-view.d.ts","sourceRoot":"","sources":["../../src/types/grid-view.ts"],"names":[],"mappings":"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"}

package/dist/types/grid-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"grid-view.js","sourceRoot":"","sources":["../../src/types/grid-view.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  GridRectItem,\n  GridViewport,\n  GridViewportConstraints,\n  GridZoomLimits,\n} from '@ankhorage/grid-view';\nimport type React from 'react';\n\nimport type { ZoraBaseProps } from './base';\n\n/** The renderer owns presentation only; world geometry comes from grid-view. */\nexport interface GridViewProps extends ZoraBaseProps {\n  items: readonly GridRectItem[];\n  contentWidth: number;\n  contentHeight: number;\n  width: number;\n  height: number;\n  /**\n   * Canonical controlled world viewport. Supplying this value makes `onViewportChange`\n   * report interaction proposals without mutating renderer-owned state.\n   */\n  viewport?: GridViewport;\n  /** Initial world position and independent axis scales for uncontrolled rendering. */\n  defaultViewport?: Partial<\n    Pick<GridViewport, 'offsetX' | 'offsetY' | 'pixelsPerUnitX' | 'pixelsPerUnitY'>\n  >;\n  /** Finite world bounds and optional overscroll for panning and focused-item reveal. */\n  viewportConstraints?: GridViewportConstraints;\n  /** Independent X/Y scale limits applied to focal-point zoom interactions. */\n  zoomLimits?: GridZoomLimits;\n  /** @deprecated Use `defaultViewport` for new code. */\n  zoom?: number;\n  overscanPixels?: number;\n  /** Stable item identity that must be scrolled into view without duplicating viewport geometry. */\n  focusedItemId?: string;\n  /** Pixel inset retained around a revealed focused item. */\n  revealPaddingPixels?: number;\n  onViewportChange?: (viewport: GridViewport) => void;\n  onVisibleItemIdsChange?: (ids: readonly string[]) => void;\n  renderItem: (item: GridRectItem) => React.ReactNode;\n}\n\n/** An item needs a stable ID; visual positioning belongs to the TileGrid composition. */\nexport interface TileGridItem {\n  readonly id: string;\n}\n\n/** Reusable tile presentation based on the generic world/viewport engine. */\nexport interface TileGridProps extends ZoraBaseProps {\n  items: readonly TileGridItem[];\n  width?: number;\n  height?: number;\n  tileSize?: number;\n  gap?: number;\n  zoom?: number;\n  viewport?: GridViewport;\n  defaultViewport?: Partial<\n    Pick<GridViewport, 'offsetX' | 'offsetY' | 'pixelsPerUnitX' | 'pixelsPerUnitY'>\n  >;\n  viewportConstraints?: GridViewportConstraints;\n  zoomLimits?: GridZoomLimits;\n  overscanPixels?: number;\n  focusedItemId?: string;\n  revealPaddingPixels?: number;\n  /** Reports the same measured column count used to position tiles. */\n  onColumnsChange?: (columns: number) => void;\n  onViewportChange?: (viewport: GridViewport) => void;\n  onVisibleItemIdsChange?: (ids: readonly string[]) => void;\n  renderItem: (item: TileGridItem) => React.ReactNode;\n}\n"]}
+{"version":3,"file":"grid-view.js","sourceRoot":"","sources":["../../src/types/grid-view.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  GridRectItem,\n  GridViewport,\n  GridViewportConstraints,\n  GridZoomLimits,\n} from '@ankhorage/grid-view';\nimport type React from 'react';\n\nimport type { ZoraBaseProps } from './base';\n\n/** The renderer owns presentation only; world geometry comes from grid-view. */\nexport interface GridViewProps extends ZoraBaseProps {\n  items: readonly GridRectItem[];\n  contentWidth: number;\n  contentHeight: number;\n  width: number;\n  height: number;\n  /**\n   * Canonical controlled world viewport. Supplying this value makes `onViewportChange`\n   * report interaction proposals without mutating renderer-owned state.\n   */\n  viewport?: GridViewport;\n  /** Initial world position and independent axis scales for uncontrolled rendering. */\n  defaultViewport?: Partial<\n    Pick<GridViewport, 'offsetX' | 'offsetY' | 'pixelsPerUnitX' | 'pixelsPerUnitY'>\n  >;\n  /** Finite world bounds and optional overscroll for panning and focused-item reveal. */\n  viewportConstraints?: GridViewportConstraints;\n  /** Independent X/Y scale limits applied to focal-point zoom interactions. */\n  zoomLimits?: GridZoomLimits;\n  /** @deprecated Use `defaultViewport` for new code. */\n  zoom?: number;\n  overscanPixels?: number;\n  /** Stable item identity that must be scrolled into view without duplicating viewport geometry. */\n  focusedItemId?: string;\n  /** Pixel inset retained around a revealed focused item. */\n  revealPaddingPixels?: number;\n  onViewportChange?: (viewport: GridViewport) => void;\n  onVisibleItemIdsChange?: (ids: readonly string[]) => void;\n  renderItem: (item: GridRectItem) => React.ReactNode;\n}\n\n/** An item needs a stable ID; visual positioning belongs to the TileGrid composition. */\nexport interface TileGridItem {\n  readonly id: string;\n}\n\n/** Reusable tile presentation based on the generic world/viewport engine. */\nexport interface TileGridProps extends ZoraBaseProps {\n  items: readonly TileGridItem[];\n  width?: number;\n  height?: number;\n  tileSize?: number;\n  gap?: number;\n  zoom?: number;\n  viewport?: GridViewport;\n  defaultViewport?: Partial<\n    Pick<GridViewport, 'offsetX' | 'offsetY' | 'pixelsPerUnitX' | 'pixelsPerUnitY'>\n  >;\n  viewportConstraints?: GridViewportConstraints;\n  zoomLimits?: GridZoomLimits;\n  overscanPixels?: number;\n  focusedItemId?: string;\n  revealPaddingPixels?: number;\n  /** Reports the same measured column count used to position tiles. */\n  onColumnsChange?: (columns: number) => void;\n  onViewportChange?: (viewport: GridViewport) => void;\n  onVisibleItemIdsChange?: (ids: readonly string[]) => void;\n  renderItem: (item: TileGridItem) => React.ReactNode;\n}\n\n/** The two independent native scroll axes that back a GridView viewport. */\nexport type GridScrollAxis = 'x' | 'y';\n\n/** A physical native scroll position in pixels. */\nexport interface GridScrollPosition {\n  readonly x: number;\n  readonly y: number;\n}\n\n/** A programmatic native scroll request that GridView is still waiting to observe. */\nexport interface GridPendingScroll {\n  readonly animated: boolean;\n  readonly expiresAt: number;\n  readonly target: number;\n}\n\n/** Native capabilities and clock used by the programmatic-versus-user scroll arbiter. */\nexport interface GridScrollSyncOptions {\n  /** Requests a native scroll of one axis. */\n  readonly scrollTo: (axis: GridScrollAxis, offset: number, animated: boolean) => void;\n  /** Reports a genuine user scroll as the pixel displacement of the native offset. */\n  readonly onUserScroll: (axis: GridScrollAxis, displacement: number) => void;\n  /** Reconciles a late programmatic native frame without classifying it as a user pan. */\n  readonly onProgrammaticScroll: (axis: GridScrollAxis, displacement: number) => void;\n  readonly now?: () => number;\n  readonly schedule?: (callback: () => void, delay: number) => ReturnType<typeof setTimeout>;\n  readonly cancel?: (handle: ReturnType<typeof setTimeout>) => void;\n}\n\n/** Separates echoes of programmatic scrolls from user scrolling, independently per axis. */\nexport interface GridScrollSync {\n  /** True when the baseline already matches the position within native tolerance. */\n  readonly isCurrent: (position: GridScrollPosition) => boolean;\n  /** Moves native scrolling to a viewport-derived position. */\n  readonly request: (position: GridScrollPosition, animated: boolean) => void;\n  /** Routes one native scroll event. */\n  readonly scrolled: (axis: GridScrollAxis, offset: number) => void;\n  /** Hands an axis to the user, adopting the native offset at the start of their drag. */\n  readonly dragBegan: (axis: GridScrollAxis, offset: number) => void;\n  /** Adopts the final native offset when a programmatic or momentum scroll ends. */\n  readonly scrollEnded: (axis: GridScrollAxis, offset: number) => void;\n  /** Cancels every pending settle timer. */\n  readonly dispose: () => void;\n}\n"]}

package/dist/types/layout.d.ts

@@ -22,4 +22,9 @@ export interface ScreenProps extends ZoraBaseProps {
     scroll?: boolean;
     width?: ZoraContentWidth;
 }
+/** Exclusive-gesture coordination between a ZORA scroll container and its descendant surfaces. */
+export interface ScrollGestureLock {
+    /** Suspends scrolling until the returned release function runs; releasing twice is harmless. */
+    readonly acquire: () => () => void;
+}
 //# sourceMappingURL=layout.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/types/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,IAAI,mBAAmB,EACnC,SAAS,IAAI,gBAAgB,EAC7B,eAAe,IAAI,sBAAsB,EACzC,SAAS,IAAI,gBAAgB,EAC9B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,SAAU,SAAQ,aAAa,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CAAG;AAC/F,MAAM,WAAW,eACf,SAAQ,aAAa,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,SAAS,CAAC;CAAG;AAC5E,MAAM,WAAW,YACf,SAAQ,aAAa,EAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;CAAG;AACzE,MAAM,WAAW,SAAU,SAAQ,aAAa,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CAAG;AAE/F,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B"}
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/types/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,IAAI,mBAAmB,EACnC,SAAS,IAAI,gBAAgB,EAC7B,eAAe,IAAI,sBAAsB,EACzC,SAAS,IAAI,gBAAgB,EAC9B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,SAAU,SAAQ,aAAa,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CAAG;AAC/F,MAAM,WAAW,eACf,SAAQ,aAAa,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,SAAS,CAAC;CAAG;AAC5E,MAAM,WAAW,YACf,SAAQ,aAAa,EAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;CAAG;AACzE,MAAM,WAAW,SAAU,SAAQ,aAAa,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CAAG;AAE/F,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED,kGAAkG;AAClG,MAAM,WAAW,iBAAiB;IAChC,gGAAgG;IAChG,QAAQ,CAAC,OAAO,EAAE,MAAM,MAAM,IAAI,CAAC;CACpC"}

package/dist/types/layout.js.map

@@ -1 +1 @@
-{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/types/layout.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  DividerProps as SurfaceDividerProps,\n  GridProps as SurfaceGridProps,\n  ScrollViewProps as SurfaceScrollViewProps,\n  ViewProps as SurfaceViewProps,\n} from '@ankhorage/surface';\nimport type React from 'react';\n\nimport type { ZoraBaseProps } from './base';\n\nexport type ZoraContentWidth = 'narrow' | 'default' | 'wide';\n\nexport interface ViewProps extends ZoraBaseProps, Omit<SurfaceViewProps, 'mode' | 'themeId'> {}\nexport interface ScrollViewProps\n  extends ZoraBaseProps, Omit<SurfaceScrollViewProps, 'mode' | 'themeId'> {}\nexport interface DividerProps\n  extends ZoraBaseProps, Omit<SurfaceDividerProps, 'mode' | 'themeId'> {}\nexport interface GridProps extends ZoraBaseProps, Omit<SurfaceGridProps, 'mode' | 'themeId'> {}\n\nexport interface AppShellProps extends ZoraBaseProps {\n  children?: React.ReactNode;\n  header?: React.ReactNode;\n  footer?: React.ReactNode;\n  overlay?: React.ReactNode;\n}\n\nexport interface ScreenProps extends ZoraBaseProps {\n  children?: React.ReactNode;\n  footer?: React.ReactNode;\n  scroll?: boolean;\n  width?: ZoraContentWidth;\n}\n"]}
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/types/layout.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  DividerProps as SurfaceDividerProps,\n  GridProps as SurfaceGridProps,\n  ScrollViewProps as SurfaceScrollViewProps,\n  ViewProps as SurfaceViewProps,\n} from '@ankhorage/surface';\nimport type React from 'react';\n\nimport type { ZoraBaseProps } from './base';\n\nexport type ZoraContentWidth = 'narrow' | 'default' | 'wide';\n\nexport interface ViewProps extends ZoraBaseProps, Omit<SurfaceViewProps, 'mode' | 'themeId'> {}\nexport interface ScrollViewProps\n  extends ZoraBaseProps, Omit<SurfaceScrollViewProps, 'mode' | 'themeId'> {}\nexport interface DividerProps\n  extends ZoraBaseProps, Omit<SurfaceDividerProps, 'mode' | 'themeId'> {}\nexport interface GridProps extends ZoraBaseProps, Omit<SurfaceGridProps, 'mode' | 'themeId'> {}\n\nexport interface AppShellProps extends ZoraBaseProps {\n  children?: React.ReactNode;\n  header?: React.ReactNode;\n  footer?: React.ReactNode;\n  overlay?: React.ReactNode;\n}\n\nexport interface ScreenProps extends ZoraBaseProps {\n  children?: React.ReactNode;\n  footer?: React.ReactNode;\n  scroll?: boolean;\n  width?: ZoraContentWidth;\n}\n\n/** Exclusive-gesture coordination between a ZORA scroll container and its descendant surfaces. */\nexport interface ScrollGestureLock {\n  /** Suspends scrolling until the returned release function runs; releasing twice is harmless. */\n  readonly acquire: () => () => void;\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/zora",
   "type": "module",
-  "version": "25.8.11",
+  "version": "25.8.12",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {
@@ -135,7 +135,7 @@
   },
   "devDependencies": {
     "@ankhorage/devtools": "^2.3.18",
-    "@ankhorage/paradox": "^0.3.4",
+    "@ankhorage/paradox": "^0.3.5",
     "@react-native-vector-icons/fontawesome": "^13.1.5",
     "@react-native-vector-icons/fontawesome5": "^13.1.5",
     "@react-native-vector-icons/fontawesome6": "^13.1.5",