@geometra/core 1.49.0 → 1.53.0

package/dist/focus.js

@@ -19,6 +19,8 @@ export function clearFocus() {
  * Non-box leaves (`text`, `image`, `scene3d`) are ignored — only `box` nodes participate in this walk.
  * Boxes with a missing or non-array `children` field are treated as leaf boxes (no throw) so bad
  * deserialization cannot take down focus walks.
+ * At each index, both the element child and `layout.children[i]` must be present — a hole in the
+ * element `children` array with a layout slot still present is skipped (same rule as hit-testing).
  * Skips boxes whose layout bounds are non-finite or have negative width/height, and does not walk
  * their subtrees — same rule as hit-testing so corrupt geometry cannot enter focus order.
  *
@@ -42,9 +44,10 @@ function collectFocusable(element, layout, results) {
         const kids = element.children;
         const n = Array.isArray(kids) ? kids.length : 0;
         for (let i = 0; i < n; i++) {
+            const child = kids[i];
             const childLayout = layout.children[i];
-            if (childLayout) {
-                collectFocusable(kids[i], childLayout, results);
+            if (child && childLayout) {
+                collectFocusable(child, childLayout, results);
             }
         }
     }

package/dist/focus.js.map

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

package/dist/gestures.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Renderer-agnostic pointer gesture recognizers: pan/drag, swipe, and pinch.
+ *
+ * Each recognizer is a pure state machine. Host code (canvas hit-test,
+ * terminal pointer, native bridge, tests) feeds it pointer events via
+ * `pointerDown`/`pointerMove`/`pointerUp`/`pointerCancel`; the recognizer
+ * invokes callbacks when thresholds are crossed. No DOM, no raf.
+ *
+ * Pointer IDs are integers (matching Pointer Events API conventions), but any
+ * stable per-pointer identity works — synthesized ids from terminal tap
+ * protocols are fine as long as down/move/up match.
+ */
+export interface PointerSample {
+    id: number;
+    x: number;
+    y: number;
+    /** High-resolution timestamp in ms. Finite values only; callers are responsible. */
+    timestampMs: number;
+}
+export interface PanEvent {
+    pointerId: number;
+    x: number;
+    y: number;
+    startX: number;
+    startY: number;
+    deltaX: number;
+    deltaY: number;
+    /** Time since the gesture started moving past `minDistance`. */
+    elapsedMs: number;
+}
+export interface PanRecognizerOptions {
+    /** Distance in px the pointer must travel before `onStart` fires. Default 4. */
+    minDistance?: number;
+    /** Fires when the pointer crosses `minDistance`. */
+    onStart?: (event: PanEvent) => void;
+    /** Fires on each pointer move after `onStart`. */
+    onMove?: (event: PanEvent) => void;
+    /** Fires on `pointerUp`. Carries the final sample. */
+    onEnd?: (event: PanEvent) => void;
+    /** Fires on `pointerCancel`. No event is built if the gesture never started. */
+    onCancel?: (event: PanEvent) => void;
+}
+export interface PanRecognizer {
+    pointerDown(sample: PointerSample): void;
+    pointerMove(sample: PointerSample): void;
+    pointerUp(sample: PointerSample): void;
+    pointerCancel(pointerId: number): void;
+    /** True while the pan gesture has crossed `minDistance` and not yet ended. */
+    isActive(): boolean;
+    /** Drop any in-flight gesture without firing callbacks. */
+    reset(): void;
+}
+export declare function createPanRecognizer(options?: PanRecognizerOptions): PanRecognizer;
+export type SwipeDirection = 'left' | 'right' | 'up' | 'down';
+export interface SwipeEvent {
+    pointerId: number;
+    direction: SwipeDirection;
+    deltaX: number;
+    deltaY: number;
+    /** px/ms magnitude of the final velocity. */
+    velocity: number;
+    elapsedMs: number;
+}
+export interface SwipeRecognizerOptions {
+    /** Minimum total travel (px) before a swipe can register. Default 24. */
+    minDistance?: number;
+    /** Minimum velocity (px/ms) of the release. Default 0.3. */
+    minVelocity?: number;
+    /** Swipe must complete within this many ms. Default 600. */
+    maxDurationMs?: number;
+    onSwipe?: (event: SwipeEvent) => void;
+}
+export interface SwipeRecognizer {
+    pointerDown(sample: PointerSample): void;
+    pointerMove(sample: PointerSample): void;
+    pointerUp(sample: PointerSample): void;
+    pointerCancel(pointerId: number): void;
+    reset(): void;
+}
+export declare function createSwipeRecognizer(options?: SwipeRecognizerOptions): SwipeRecognizer;
+export interface PinchEvent {
+    pointerIds: [number, number];
+    /** Current distance between the two tracked pointers. */
+    distance: number;
+    /** Distance between pointers when the gesture became active. */
+    startDistance: number;
+    /** `distance / startDistance`. Values > 1 = zoom in, < 1 = zoom out. */
+    scale: number;
+    /** Midpoint of the two pointers, useful as a zoom focal point. */
+    centerX: number;
+    centerY: number;
+    elapsedMs: number;
+}
+export interface PinchRecognizerOptions {
+    /** Minimum absolute distance change (px) before `onStart` fires. Default 4. */
+    minDeltaDistance?: number;
+    onStart?: (event: PinchEvent) => void;
+    onMove?: (event: PinchEvent) => void;
+    onEnd?: (event: PinchEvent) => void;
+}
+export interface PinchRecognizer {
+    pointerDown(sample: PointerSample): void;
+    pointerMove(sample: PointerSample): void;
+    pointerUp(sample: PointerSample): void;
+    pointerCancel(pointerId: number): void;
+    isActive(): boolean;
+    reset(): void;
+}
+export declare function createPinchRecognizer(options?: PinchRecognizerOptions): PinchRecognizer;
+//# sourceMappingURL=gestures.d.ts.map

package/dist/gestures.d.ts.map

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

package/dist/gestures.js

@@ -0,0 +1,248 @@
+/**
+ * Renderer-agnostic pointer gesture recognizers: pan/drag, swipe, and pinch.
+ *
+ * Each recognizer is a pure state machine. Host code (canvas hit-test,
+ * terminal pointer, native bridge, tests) feeds it pointer events via
+ * `pointerDown`/`pointerMove`/`pointerUp`/`pointerCancel`; the recognizer
+ * invokes callbacks when thresholds are crossed. No DOM, no raf.
+ *
+ * Pointer IDs are integers (matching Pointer Events API conventions), but any
+ * stable per-pointer identity works — synthesized ids from terminal tap
+ * protocols are fine as long as down/move/up match.
+ */
+function resolveMinDistance(distance, fallback) {
+    if (typeof distance !== 'number' || !Number.isFinite(distance) || distance < 0)
+        return fallback;
+    return distance;
+}
+export function createPanRecognizer(options = {}) {
+    const minDistance = resolveMinDistance(options.minDistance, 4);
+    const tracked = new Map();
+    function buildEvent(t, now) {
+        return {
+            pointerId: t.start.id,
+            x: now.x,
+            y: now.y,
+            startX: t.start.x,
+            startY: t.start.y,
+            deltaX: now.x - t.start.x,
+            deltaY: now.y - t.start.y,
+            elapsedMs: now.timestampMs - t.startTimeMs,
+        };
+    }
+    return {
+        pointerDown(sample) {
+            tracked.set(sample.id, {
+                start: sample,
+                last: sample,
+                startTimeMs: sample.timestampMs,
+                startedGesture: false,
+            });
+        },
+        pointerMove(sample) {
+            const t = tracked.get(sample.id);
+            if (!t)
+                return;
+            t.last = sample;
+            if (!t.startedGesture) {
+                const dx = sample.x - t.start.x;
+                const dy = sample.y - t.start.y;
+                const dist2 = dx * dx + dy * dy;
+                if (dist2 >= minDistance * minDistance) {
+                    t.startedGesture = true;
+                    t.startTimeMs = sample.timestampMs;
+                    options.onStart?.(buildEvent(t, sample));
+                }
+                return;
+            }
+            options.onMove?.(buildEvent(t, sample));
+        },
+        pointerUp(sample) {
+            const t = tracked.get(sample.id);
+            if (!t)
+                return;
+            tracked.delete(sample.id);
+            if (!t.startedGesture)
+                return;
+            t.last = sample;
+            options.onEnd?.(buildEvent(t, sample));
+        },
+        pointerCancel(pointerId) {
+            const t = tracked.get(pointerId);
+            if (!t)
+                return;
+            tracked.delete(pointerId);
+            if (!t.startedGesture)
+                return;
+            options.onCancel?.(buildEvent(t, t.last));
+        },
+        isActive() {
+            for (const t of tracked.values())
+                if (t.startedGesture)
+                    return true;
+            return false;
+        },
+        reset() {
+            tracked.clear();
+        },
+    };
+}
+function classifyDirection(dx, dy) {
+    return Math.abs(dx) >= Math.abs(dy) ? (dx >= 0 ? 'right' : 'left') : dy >= 0 ? 'down' : 'up';
+}
+const VELOCITY_WINDOW_MS = 100;
+export function createSwipeRecognizer(options = {}) {
+    const minDistance = resolveMinDistance(options.minDistance, 24);
+    const minVelocity = typeof options.minVelocity === 'number' && Number.isFinite(options.minVelocity) && options.minVelocity > 0
+        ? options.minVelocity
+        : 0.3;
+    const maxDurationMs = typeof options.maxDurationMs === 'number' && Number.isFinite(options.maxDurationMs) && options.maxDurationMs > 0
+        ? options.maxDurationMs
+        : 600;
+    const tracked = new Map();
+    return {
+        pointerDown(sample) {
+            tracked.set(sample.id, { start: sample, samples: [sample] });
+        },
+        pointerMove(sample) {
+            const t = tracked.get(sample.id);
+            if (!t)
+                return;
+            t.samples.push(sample);
+            // Keep only the trailing window so velocity doesn't drift on long pans.
+            const cutoff = sample.timestampMs - VELOCITY_WINDOW_MS;
+            while (t.samples.length > 2 && t.samples[0].timestampMs < cutoff)
+                t.samples.shift();
+        },
+        pointerUp(sample) {
+            const t = tracked.get(sample.id);
+            if (!t)
+                return;
+            tracked.delete(sample.id);
+            const dx = sample.x - t.start.x;
+            const dy = sample.y - t.start.y;
+            const dist = Math.hypot(dx, dy);
+            const elapsedMs = sample.timestampMs - t.start.timestampMs;
+            if (dist < minDistance || elapsedMs <= 0 || elapsedMs > maxDurationMs)
+                return;
+            const windowStart = t.samples[0];
+            const ws = sample.timestampMs - windowStart.timestampMs;
+            const wdx = sample.x - windowStart.x;
+            const wdy = sample.y - windowStart.y;
+            const velocity = ws > 0 ? Math.hypot(wdx, wdy) / ws : 0;
+            if (velocity < minVelocity)
+                return;
+            options.onSwipe?.({
+                pointerId: t.start.id,
+                direction: classifyDirection(dx, dy),
+                deltaX: dx,
+                deltaY: dy,
+                velocity,
+                elapsedMs,
+            });
+        },
+        pointerCancel(pointerId) {
+            tracked.delete(pointerId);
+        },
+        reset() {
+            tracked.clear();
+        },
+    };
+}
+export function createPinchRecognizer(options = {}) {
+    const minDelta = resolveMinDistance(options.minDeltaDistance, 4);
+    const state = {
+        pointers: new Map(),
+        lastPair: null,
+        startDistance: 0,
+        startTimeMs: 0,
+        started: false,
+    };
+    function twoPointers() {
+        if (state.pointers.size !== 2)
+            return null;
+        const iter = state.pointers.values();
+        const first = iter.next().value;
+        const second = iter.next().value;
+        return [first, second];
+    }
+    function distance(a, b) {
+        return Math.hypot(a.x - b.x, a.y - b.y);
+    }
+    function buildEvent(pair, now) {
+        const d = distance(pair[0], pair[1]);
+        return {
+            pointerIds: [pair[0].id, pair[1].id],
+            distance: d,
+            startDistance: state.startDistance || d,
+            scale: state.startDistance > 0 ? d / state.startDistance : 1,
+            centerX: (pair[0].x + pair[1].x) / 2,
+            centerY: (pair[0].y + pair[1].y) / 2,
+            elapsedMs: now - state.startTimeMs,
+        };
+    }
+    function endGesture(lastTimestamp) {
+        if (!state.started)
+            return;
+        const pair = state.lastPair ?? twoPointers();
+        if (pair)
+            options.onEnd?.(buildEvent(pair, lastTimestamp));
+        state.started = false;
+        state.startDistance = 0;
+        state.lastPair = null;
+    }
+    return {
+        pointerDown(sample) {
+            if (state.pointers.size >= 2 && !state.pointers.has(sample.id))
+                return;
+            state.pointers.set(sample.id, sample);
+            if (state.pointers.size === 2 && !state.started) {
+                const pair = twoPointers();
+                state.startDistance = distance(pair[0], pair[1]);
+                state.startTimeMs = sample.timestampMs;
+                state.lastPair = pair;
+            }
+        },
+        pointerMove(sample) {
+            if (!state.pointers.has(sample.id))
+                return;
+            state.pointers.set(sample.id, sample);
+            const pair = twoPointers();
+            if (!pair)
+                return;
+            state.lastPair = pair;
+            const d = distance(pair[0], pair[1]);
+            if (!state.started) {
+                if (Math.abs(d - state.startDistance) < minDelta)
+                    return;
+                state.started = true;
+                options.onStart?.(buildEvent(pair, sample.timestampMs));
+                return;
+            }
+            options.onMove?.(buildEvent(pair, sample.timestampMs));
+        },
+        pointerUp(sample) {
+            const existed = state.pointers.has(sample.id);
+            state.pointers.delete(sample.id);
+            if (existed && state.pointers.size < 2)
+                endGesture(sample.timestampMs);
+        },
+        pointerCancel(pointerId) {
+            const existed = state.pointers.has(pointerId);
+            state.pointers.delete(pointerId);
+            if (existed && state.pointers.size < 2)
+                endGesture(state.startTimeMs);
+        },
+        isActive() {
+            return state.started;
+        },
+        reset() {
+            state.pointers.clear();
+            state.started = false;
+            state.startDistance = 0;
+            state.startTimeMs = 0;
+            state.lastPair = null;
+        },
+    };
+}
+//# sourceMappingURL=gestures.js.map

package/dist/gestures.js.map

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

package/dist/hit-test.d.ts

@@ -46,8 +46,9 @@ export interface HitDispatchResult {
  * For `onClick` only, the return value may include `focusTarget` for focus routing
  * (including click-to-focus when there is no `onClick` handler).
  * Non-box roots (`text`, `image`, `scene3d`) always return `{ handled: false }` — attach pointer handlers to a parent {@link import('./types.js').BoxElement}.
- * Pointer `x` / `y` must be finite numbers: anything that fails `Number.isFinite` (including
- * non-numbers at runtime) returns `{ handled: false }` without invoking handlers.
+ * Pointer `x` / `y` must be **primitive** finite numbers — same rule as
+ * {@link import('./layout-bounds.js').isFinitePlainNumber} / {@link import('./layout-bounds.js').pointInInclusiveLayoutRect}
+ * (boxed numbers and non-numbers return `{ handled: false }` without invoking handlers).
  * Layout bounds must be finite and non-negative on `width` and `height`; otherwise the node is
  * skipped for hit-testing (corrupt geometry from Yoga or a bad snapshot).
  *
@@ -75,7 +76,7 @@ export declare function dispatchHit(element: UIElement, layout: ComputedLayout,
  * (`onClick`, `onPointerDown` / `Up` / `Move`, `onWheel`). Keyboard and composition
  * handlers alone do not count — use this for hover / pointer-capture style checks.
  *
- * Non-finite or non-number `x` / `y` return `false` (same `Number.isFinite` guard as {@link dispatchHit}).
+ * Non-finite or non-number `x` / `y` return `false` (same {@link import('./layout-bounds.js').isFinitePlainNumber} guard as {@link dispatchHit}).
  *
  * Optional `offsetX` / `offsetY` match {@link hitPathAtPoint} / {@link dispatchHit} for rooted coordinate transforms.
  * Non-finite or non-number offsets are treated as `0`.
@@ -94,7 +95,7 @@ export declare function hasInteractiveHitAtPoint(element: UIElement, layout: Com
  * non-finite or non-number `zIndex` values match `dispatchHit` / paint order (treated as `0`).
  * Boxes with `pointerEvents: 'none'` are skipped for path segments; if the deepest matching geometry is only such a box
  * (no deeper box under the point), returns `null` (same as missing the interactive stack).
- * Non-finite or non-number `x` / `y` return `null` (same `Number.isFinite` guard as {@link dispatchHit}).
+ * Non-finite or non-number `x` / `y` return `null` (same {@link import('./layout-bounds.js').isFinitePlainNumber} guard as {@link dispatchHit}).
  * Returns `null` when the point misses the tree, when the root is not a `box` (text/image/scene3d roots have no index path),
  * or in the `pointerEvents: 'none'` deepest-only case above. Returns `[]` when the point hits a box root or leaf box with
  * no deeper box under the point.
@@ -119,7 +120,7 @@ export declare function hitPathAtPoint(element: UIElement, layout: ComputedLayou
  * fall through to geometry behind, matching {@link hitPathAtPoint}.
  *
  * Root `offsetX` / `offsetY` follow {@link dispatchHit}: non-finite or non-number values are treated as `0`.
- * Non-finite or non-number `x` / `y` return `null`.
+ * Non-finite or non-number `x` / `y` return `null` ({@link import('./layout-bounds.js').isFinitePlainNumber}).
  *
  * An empty-string `cursor` on a nested box does not stop the walk (child results are checked with truthiness),
  * so the nearest ancestor with a non-empty `cursor` wins. A root hit on a lone box with `cursor: ''` still

package/dist/hit-test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hit-test.d.ts","sourceRoot":"","sources":["../src/hit-test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAY,MAAM,YAAY,CAAA;AA2HhF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE,CAAA;CAC9D;AA2HD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,aAAa,EAC9B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,SAAI,EACX,OAAO,SAAI,GACV,iBAAiB,CAWnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,cAAc,EACtB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,SAAI,EACX,OAAO,SAAI,GACV,OAAO,CAgBT;AA2BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,cAAc,EACtB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,SAAI,EACX,OAAO,SAAI,GACV,MAAM,EAAE,GAAG,IAAI,CAuBjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,cAAc,EACtB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,SAAI,EACX,OAAO,SAAI,GACV,MAAM,GAAG,IAAI,CAiCf"}
+{"version":3,"file":"hit-test.d.ts","sourceRoot":"","sources":["../src/hit-test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAY,MAAM,YAAY,CAAA;AAsHhF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE,CAAA;CAC9D;AA2HD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,aAAa,EAC9B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,SAAI,EACX,OAAO,SAAI,GACV,iBAAiB,CAWnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,cAAc,EACtB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,SAAI,EACX,OAAO,SAAI,GACV,OAAO,CAgBT;AA2BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,cAAc,EACtB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,SAAI,EACX,OAAO,SAAI,GACV,MAAM,EAAE,GAAG,IAAI,CAuBjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,cAAc,EACtB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,SAAI,EACX,OAAO,SAAI,GACV,MAAM,GAAG,IAAI,CAiCf"}

package/dist/hit-test.js

@@ -1,5 +1,5 @@
 import { hasFocusCandidateHandlers } from './focus-candidates.js';
-import { finiteNumberOrZero, layoutBoundsAreFinite, pointInInclusiveLayoutRect, scrollSafeChildOffsets, } from './layout-bounds.js';
+import { finiteNumberOrZero, isFinitePlainNumber, layoutBoundsAreFinite, pointInInclusiveLayoutRect, scrollSafeChildOffsets, } from './layout-bounds.js';
 const zIndexOrderCache = new WeakMap();
 function zIndexOf(el) {
     if (el == null)
@@ -31,44 +31,43 @@ function getChildrenByZAsc(boxEl) {
         zIndexOrderCache.set(boxEl, { zValues, asc });
         return asc;
     }
-    // Three+ children sharing one z-index: stable paint order matches source order; avoid map/sort allocations.
-    if (n >= 3) {
-        const z0 = zIndexOf(kids[0]);
-        let allEqual = true;
-        for (let i = 1; i < n; i++) {
-            if (zIndexOf(kids[i]) !== z0) {
-                allEqual = false;
-                break;
-            }
-        }
-        if (allEqual) {
-            const cached = zIndexOrderCache.get(boxEl);
-            if (cached && cached.zValues.length === n) {
-                let match = true;
-                for (let j = 0; j < n; j++) {
-                    if (cached.zValues[j] !== z0) {
-                        match = false;
-                        break;
-                    }
+    // Three+ children: one zIndexOf pass fills zValues, then either identity order (all equal z) or sort.
+    // Cache checks compare against that same zValues array — no second zIndexOf sweep before sort.
+    const zValues = new Array(n);
+    zValues[0] = zIndexOf(kids[0]);
+    let allEqual = true;
+    for (let i = 1; i < n; i++) {
+        const zi = zIndexOf(kids[i]);
+        zValues[i] = zi;
+        if (zi !== zValues[0])
+            allEqual = false;
+    }
+    if (allEqual) {
+        const z0 = zValues[0];
+        const cached = zIndexOrderCache.get(boxEl);
+        if (cached && cached.zValues.length === n) {
+            let match = true;
+            for (let j = 0; j < n; j++) {
+                if (cached.zValues[j] !== z0) {
+                    match = false;
+                    break;
                 }
-                if (match)
-                    return cached.asc;
-            }
-            const zValues = new Array(n);
-            const asc = new Array(n);
-            for (let i = 0; i < n; i++) {
-                zValues[i] = z0;
-                asc[i] = i;
             }
-            zIndexOrderCache.set(boxEl, { zValues, asc });
-            return asc;
+            if (match)
+                return cached.asc;
         }
+        const asc = new Array(n);
+        for (let i = 0; i < n; i++) {
+            asc[i] = i;
+        }
+        zIndexOrderCache.set(boxEl, { zValues, asc });
+        return asc;
     }
     const cached = zIndexOrderCache.get(boxEl);
     if (cached && cached.zValues.length === n) {
         let unchanged = true;
         for (let i = 0; i < n; i++) {
-            if (cached.zValues[i] !== zIndexOf(kids[i])) {
+            if (cached.zValues[i] !== zValues[i]) {
                 unchanged = false;
                 break;
             }
@@ -76,11 +75,6 @@ function getChildrenByZAsc(boxEl) {
         if (unchanged)
             return cached.asc;
     }
-    // Single pass: stale or missing cache must not re-call zIndexOf after validation (was map + prior loop).
-    const zValues = new Array(n);
-    for (let i = 0; i < n; i++) {
-        zValues[i] = zIndexOf(kids[i]);
-    }
     const asc = new Array(n);
     for (let i = 0; i < n; i++) {
         asc[i] = i;
@@ -101,7 +95,7 @@ function getChildrenByZAsc(boxEl) {
 }
 /** Walk the element tree + computed layout in parallel to find hit targets at (x, y). */
 function collectHits(element, layout, x, y, offsetX, offsetY, results) {
-    if (!Number.isFinite(x) || !Number.isFinite(y))
+    if (!isFinitePlainNumber(x) || !isFinitePlainNumber(y))
         return;
     if (!layoutBoundsAreFinite(layout))
         return;
@@ -128,7 +122,7 @@ function collectHits(element, layout, x, y, offsetX, offsetY, results) {
     }
 }
 function dispatchHitRecursive(element, layout, eventType, x, y, offsetX, offsetY, extra) {
-    if (!Number.isFinite(x) || !Number.isFinite(y))
+    if (!isFinitePlainNumber(x) || !isFinitePlainNumber(y))
         return { handled: false };
     if (!layoutBoundsAreFinite(layout))
         return { handled: false };
@@ -206,8 +200,9 @@ function dispatchHitRecursive(element, layout, eventType, x, y, offsetX, offsetY
  * For `onClick` only, the return value may include `focusTarget` for focus routing
  * (including click-to-focus when there is no `onClick` handler).
  * Non-box roots (`text`, `image`, `scene3d`) always return `{ handled: false }` — attach pointer handlers to a parent {@link import('./types.js').BoxElement}.
- * Pointer `x` / `y` must be finite numbers: anything that fails `Number.isFinite` (including
- * non-numbers at runtime) returns `{ handled: false }` without invoking handlers.
+ * Pointer `x` / `y` must be **primitive** finite numbers — same rule as
+ * {@link import('./layout-bounds.js').isFinitePlainNumber} / {@link import('./layout-bounds.js').pointInInclusiveLayoutRect}
+ * (boxed numbers and non-numbers return `{ handled: false }` without invoking handlers).
  * Layout bounds must be finite and non-negative on `width` and `height`; otherwise the node is
  * skipped for hit-testing (corrupt geometry from Yoga or a bad snapshot).
  *
@@ -237,7 +232,7 @@ export function dispatchHit(element, layout, eventType, x, y, extra, offsetX = 0
  * (`onClick`, `onPointerDown` / `Up` / `Move`, `onWheel`). Keyboard and composition
  * handlers alone do not count — use this for hover / pointer-capture style checks.
  *
- * Non-finite or non-number `x` / `y` return `false` (same `Number.isFinite` guard as {@link dispatchHit}).
+ * Non-finite or non-number `x` / `y` return `false` (same {@link import('./layout-bounds.js').isFinitePlainNumber} guard as {@link dispatchHit}).
  *
  * Optional `offsetX` / `offsetY` match {@link hitPathAtPoint} / {@link dispatchHit} for rooted coordinate transforms.
  * Non-finite or non-number offsets are treated as `0`.
@@ -272,7 +267,7 @@ export function hasInteractiveHitAtPoint(element, layout, x, y, offsetX = 0, off
  * Returns the node’s absolute origin `(absX, absY)` when the point hits the layout rect.
  */
 function rootedLayoutPointContainment(layout, x, y, offsetX, offsetY) {
-    if (!Number.isFinite(x) || !Number.isFinite(y))
+    if (!isFinitePlainNumber(x) || !isFinitePlainNumber(y))
         return null;
     if (!layoutBoundsAreFinite(layout))
         return null;
@@ -289,7 +284,7 @@ function rootedLayoutPointContainment(layout, x, y, offsetX, offsetY) {
  * non-finite or non-number `zIndex` values match `dispatchHit` / paint order (treated as `0`).
  * Boxes with `pointerEvents: 'none'` are skipped for path segments; if the deepest matching geometry is only such a box
  * (no deeper box under the point), returns `null` (same as missing the interactive stack).
- * Non-finite or non-number `x` / `y` return `null` (same `Number.isFinite` guard as {@link dispatchHit}).
+ * Non-finite or non-number `x` / `y` return `null` (same {@link import('./layout-bounds.js').isFinitePlainNumber} guard as {@link dispatchHit}).
  * Returns `null` when the point misses the tree, when the root is not a `box` (text/image/scene3d roots have no index path),
  * or in the `pointerEvents: 'none'` deepest-only case above. Returns `[]` when the point hits a box root or leaf box with
  * no deeper box under the point.
@@ -339,7 +334,7 @@ export function hitPathAtPoint(element, layout, x, y, offsetX = 0, offsetY = 0)
  * fall through to geometry behind, matching {@link hitPathAtPoint}.
  *
  * Root `offsetX` / `offsetY` follow {@link dispatchHit}: non-finite or non-number values are treated as `0`.
- * Non-finite or non-number `x` / `y` return `null`.
+ * Non-finite or non-number `x` / `y` return `null` ({@link import('./layout-bounds.js').isFinitePlainNumber}).
  *
  * An empty-string `cursor` on a nested box does not stop the walk (child results are checked with truthiness),
  * so the nearest ancestor with a non-empty `cursor` wins. A root hit on a lone box with `cursor: ''` still