@rootnative/inertia 0.0.2 → 0.0.3

package/dist/index.d.mts

@@ -355,9 +355,11 @@ declare function useAnimation(target: number, transition?: TransitionInput): Sha
  *    `<MotionConfig reducedMotion>`. Hand-rolled `resolveTransition` writes
  *    silently bypass that setting — a correctness bug this hook fixes.
  *
- * The returned callback is stable across renders (it reads the registry and
- * the reduced-motion flag live inside the body), so it can be dropped straight
- * into memoized handlers.
+ * The returned callback is identity-stable for the lifetime of the component —
+ * it reads the registry and the reduced-motion flag out of refs at call time,
+ * so neither a new `<MotionConfig transitions>` map nor a reduced-motion change
+ * gives it a new identity. Drop it straight into memoized handlers or a
+ * `useCallback` dependency list without churning them.
  *
  * This is not a new animation API — it starts animations in Inertia's existing
  * transition vocabulary, so it does not conflict with the "no imperative-only
@@ -501,11 +503,11 @@ interface UseColorCascadeOptions {
  * hook is not a replacement for it. For a mixed numeric + color cascade, or
  * function-valued layers, drop to a hand-rolled `useAnimatedStyle`.
  *
- * The layer chain is resolved once on the JS thread and memoized on a
- * structural signature (colors + key), so a fresh-but-equal `layers` array
- * each render produces no new UI-thread closure (CLAUDE.md principle 8). The
- * `progress` shared values are read live in the worklet, so their identity is
- * intentionally excluded from the signature.
+ * The layer chain is resolved once on the JS thread and kept identity-stable,
+ * so a fresh-but-equal `layers` array each render produces no new UI-thread
+ * closure (CLAUDE.md principle 8). Changing a colour, the `key`, the base
+ * `rest`, the layer count, or **which shared value drives a layer** all rewire
+ * the worklet as you'd expect.
  */
 declare function useColorCascade(rest: string, layers: readonly ColorCascadeLayer[], options?: UseColorCascadeOptions): ReturnType<typeof useAnimatedStyle>;
 

package/dist/index.d.ts

@@ -355,9 +355,11 @@ declare function useAnimation(target: number, transition?: TransitionInput): Sha
  *    `<MotionConfig reducedMotion>`. Hand-rolled `resolveTransition` writes
  *    silently bypass that setting — a correctness bug this hook fixes.
  *
- * The returned callback is stable across renders (it reads the registry and
- * the reduced-motion flag live inside the body), so it can be dropped straight
- * into memoized handlers.
+ * The returned callback is identity-stable for the lifetime of the component —
+ * it reads the registry and the reduced-motion flag out of refs at call time,
+ * so neither a new `<MotionConfig transitions>` map nor a reduced-motion change
+ * gives it a new identity. Drop it straight into memoized handlers or a
+ * `useCallback` dependency list without churning them.
  *
  * This is not a new animation API — it starts animations in Inertia's existing
  * transition vocabulary, so it does not conflict with the "no imperative-only
@@ -501,11 +503,11 @@ interface UseColorCascadeOptions {
  * hook is not a replacement for it. For a mixed numeric + color cascade, or
  * function-valued layers, drop to a hand-rolled `useAnimatedStyle`.
  *
- * The layer chain is resolved once on the JS thread and memoized on a
- * structural signature (colors + key), so a fresh-but-equal `layers` array
- * each render produces no new UI-thread closure (CLAUDE.md principle 8). The
- * `progress` shared values are read live in the worklet, so their identity is
- * intentionally excluded from the signature.
+ * The layer chain is resolved once on the JS thread and kept identity-stable,
+ * so a fresh-but-equal `layers` array each render produces no new UI-thread
+ * closure (CLAUDE.md principle 8). Changing a colour, the `key`, the base
+ * `rest`, the layer count, or **which shared value drives a layer** all rewire
+ * the worklet as you'd expect.
  */
 declare function useColorCascade(rest: string, layers: readonly ColorCascadeLayer[], options?: UseColorCascadeOptions): ReturnType<typeof useAnimatedStyle>;
 

package/dist/index.js

@@ -1,12 +1,12 @@
 'use strict';
 
 var chunk4PEHWDAZ_js = require('./chunk-4PEHWDAZ.js');
-var chunkKYJROYCG_js = require('./chunk-KYJROYCG.js');
-var chunkX5J5M3K3_js = require('./chunk-X5J5M3K3.js');
-var chunk34Q4UM6V_js = require('./chunk-34Q4UM6V.js');
-var chunkNKA6XR77_js = require('./chunk-NKA6XR77.js');
-var chunkTUYHTHVV_js = require('./chunk-TUYHTHVV.js');
-var chunkIWLU3VDE_js = require('./chunk-IWLU3VDE.js');
+var chunkFNVFV4EY_js = require('./chunk-FNVFV4EY.js');
+var chunkFWQOXA43_js = require('./chunk-FWQOXA43.js');
+var chunkKBP4LR75_js = require('./chunk-KBP4LR75.js');
+var chunk3XTVY34H_js = require('./chunk-3XTVY34H.js');
+var chunkW5MC3P4N_js = require('./chunk-W5MC3P4N.js');
+var chunkBP3Y2SHQ_js = require('./chunk-BP3Y2SHQ.js');
 var chunk7AOERN53_js = require('./chunk-7AOERN53.js');
 var chunkPTRF47DA_js = require('./chunk-PTRF47DA.js');
 var react = require('react');
@@ -15,11 +15,11 @@ var reactNativeWorklets = require('react-native-worklets');
 
 // src/motion/index.ts
 var Motion = {
-  View: chunkKYJROYCG_js.MotionView,
-  Text: chunkX5J5M3K3_js.MotionText,
-  Image: chunk34Q4UM6V_js.MotionImage,
-  Pressable: chunkNKA6XR77_js.MotionPressable,
-  ScrollView: chunkTUYHTHVV_js.MotionScrollView
+  View: chunkFNVFV4EY_js.MotionView,
+  Text: chunkFWQOXA43_js.MotionText,
+  Image: chunkKBP4LR75_js.MotionImage,
+  Pressable: chunk3XTVY34H_js.MotionPressable,
+  ScrollView: chunkW5MC3P4N_js.MotionScrollView
 };
 function useAnimation(target, transition) {
   const output = reactNativeReanimated.useSharedValue(target);
@@ -41,14 +41,15 @@ function useAnimation(target, transition) {
 function useAnimator() {
   const registry = chunk7AOERN53_js.useNamedTransitions();
   const shouldReduceMotion = chunk7AOERN53_js.useShouldReduceMotion();
-  return react.useCallback(
-    (value, to, transition) => {
-      const resolved = chunk7AOERN53_js.resolveNamedTransition(transition, registry);
-      const cfg = shouldReduceMotion ? { type: "no-animation" } : resolved ?? { type: "spring" };
-      value.value = chunkPTRF47DA_js.resolveTransition(cfg, to);
-    },
-    [registry, shouldReduceMotion]
-  );
+  const registryRef = react.useRef(registry);
+  registryRef.current = registry;
+  const reduceMotionRef = react.useRef(shouldReduceMotion);
+  reduceMotionRef.current = shouldReduceMotion;
+  return react.useCallback((value, to, transition) => {
+    const resolved = chunk7AOERN53_js.resolveNamedTransition(transition, registryRef.current);
+    const cfg = reduceMotionRef.current ? { type: "no-animation" } : resolved ?? { type: "spring" };
+    value.value = chunkPTRF47DA_js.resolveTransition(cfg, to);
+  }, []);
 }
 function useSpring(target, config) {
   const spring = resolveSpringInput(config, chunk7AOERN53_js.useNamedTransitions());
@@ -119,7 +120,19 @@ function useColorCascade(rest, layers, options) {
   const key = options?.key ?? "backgroundColor";
   const sig = `${key}|${rest}|${layers.length}|${layers.map((l) => l.color).join(",")}`;
   const colors = react.useMemo(() => layers.map((l) => l.color), [sig]);
-  const progressValues = react.useMemo(() => layers.map((l) => l.progress), [sig]);
+  const progressRef = react.useRef([]);
+  const prevProgress = progressRef.current;
+  let progressChanged = prevProgress.length !== layers.length;
+  if (!progressChanged) {
+    for (let i = 0; i < layers.length; i++) {
+      if (prevProgress[i] !== layers[i].progress) {
+        progressChanged = true;
+        break;
+      }
+    }
+  }
+  if (progressChanged) progressRef.current = layers.map((l) => l.progress);
+  const progressValues = progressRef.current;
   return reactNativeReanimated.useAnimatedStyle(() => {
     "worklet";
     let acc = rest;
@@ -575,35 +588,35 @@ Object.defineProperty(exports, "useGesture", {
 });
 Object.defineProperty(exports, "MotionView", {
   enumerable: true,
-  get: function () { return chunkKYJROYCG_js.MotionView; }
+  get: function () { return chunkFNVFV4EY_js.MotionView; }
 });
 Object.defineProperty(exports, "MotionText", {
   enumerable: true,
-  get: function () { return chunkX5J5M3K3_js.MotionText; }
+  get: function () { return chunkFWQOXA43_js.MotionText; }
 });
 Object.defineProperty(exports, "MotionImage", {
   enumerable: true,
-  get: function () { return chunk34Q4UM6V_js.MotionImage; }
+  get: function () { return chunkKBP4LR75_js.MotionImage; }
 });
 Object.defineProperty(exports, "MotionPressable", {
   enumerable: true,
-  get: function () { return chunkNKA6XR77_js.MotionPressable; }
+  get: function () { return chunk3XTVY34H_js.MotionPressable; }
 });
 Object.defineProperty(exports, "MotionScrollView", {
   enumerable: true,
-  get: function () { return chunkTUYHTHVV_js.MotionScrollView; }
+  get: function () { return chunkW5MC3P4N_js.MotionScrollView; }
 });
 Object.defineProperty(exports, "Presence", {
   enumerable: true,
-  get: function () { return chunkIWLU3VDE_js.Presence; }
+  get: function () { return chunkBP3Y2SHQ_js.Presence; }
 });
 Object.defineProperty(exports, "createMotionComponent", {
   enumerable: true,
-  get: function () { return chunkIWLU3VDE_js.createMotionComponent; }
+  get: function () { return chunkBP3Y2SHQ_js.createMotionComponent; }
 });
 Object.defineProperty(exports, "usePresence", {
   enumerable: true,
-  get: function () { return chunkIWLU3VDE_js.usePresence; }
+  get: function () { return chunkBP3Y2SHQ_js.usePresence; }
 });
 Object.defineProperty(exports, "MotionConfig", {
   enumerable: true,

package/dist/index.mjs

@@ -1,20 +1,20 @@
 export { useGesture } from './chunk-RGNX6UZN.mjs';
-import { MotionView } from './chunk-TUMNV4P7.mjs';
-export { MotionView } from './chunk-TUMNV4P7.mjs';
-import { MotionText } from './chunk-ZN3PNGHQ.mjs';
-export { MotionText } from './chunk-ZN3PNGHQ.mjs';
-import { MotionImage } from './chunk-2DHKV2XY.mjs';
-export { MotionImage } from './chunk-2DHKV2XY.mjs';
-import { MotionPressable } from './chunk-V6BTXHZK.mjs';
-export { MotionPressable } from './chunk-V6BTXHZK.mjs';
-import { MotionScrollView } from './chunk-HFDZAHWP.mjs';
-export { MotionScrollView } from './chunk-HFDZAHWP.mjs';
-export { Presence, createMotionComponent, usePresence } from './chunk-LYMLQ6WQ.mjs';
+import { MotionView } from './chunk-BQQTHG2V.mjs';
+export { MotionView } from './chunk-BQQTHG2V.mjs';
+import { MotionText } from './chunk-SGUHE5CX.mjs';
+export { MotionText } from './chunk-SGUHE5CX.mjs';
+import { MotionImage } from './chunk-O22NXXCZ.mjs';
+export { MotionImage } from './chunk-O22NXXCZ.mjs';
+import { MotionPressable } from './chunk-46P57VMY.mjs';
+export { MotionPressable } from './chunk-46P57VMY.mjs';
+import { MotionScrollView } from './chunk-OQV66TBQ.mjs';
+export { MotionScrollView } from './chunk-OQV66TBQ.mjs';
+export { Presence, createMotionComponent, usePresence } from './chunk-CSODMRJ7.mjs';
 import { useShouldReduceMotion, resolveNamedTransition, useNamedTransitions, lookupNamedTransition } from './chunk-R63GIUNU.mjs';
 export { MotionConfig, resolveNamedTransition, useMotionConfig, useNamedTransitions, useShouldReduceMotion } from './chunk-R63GIUNU.mjs';
 import { stableSig, resolveTransition, springToReanimated, warnNonWorkletOnce } from './chunk-CY7Y64C3.mjs';
 export { buildReleaseAnimation, cubicBezier, ensureWorkletEasing, resolveAnimatableValue, resolveTransition } from './chunk-CY7Y64C3.mjs';
-import { useEffect, useCallback, useMemo, useRef } from 'react';
+import { useEffect, useRef, useCallback, useMemo } from 'react';
 import { useSharedValue, cancelAnimation, withSpring, useAnimatedReaction, useAnimatedStyle, interpolateColor, interpolate, useDerivedValue, Extrapolation, useAnimatedScrollHandler } from 'react-native-reanimated';
 import { isWorkletFunction } from 'react-native-worklets';
 
@@ -46,14 +46,15 @@ function useAnimation(target, transition) {
 function useAnimator() {
   const registry = useNamedTransitions();
   const shouldReduceMotion = useShouldReduceMotion();
-  return useCallback(
-    (value, to, transition) => {
-      const resolved = resolveNamedTransition(transition, registry);
-      const cfg = shouldReduceMotion ? { type: "no-animation" } : resolved ?? { type: "spring" };
-      value.value = resolveTransition(cfg, to);
-    },
-    [registry, shouldReduceMotion]
-  );
+  const registryRef = useRef(registry);
+  registryRef.current = registry;
+  const reduceMotionRef = useRef(shouldReduceMotion);
+  reduceMotionRef.current = shouldReduceMotion;
+  return useCallback((value, to, transition) => {
+    const resolved = resolveNamedTransition(transition, registryRef.current);
+    const cfg = reduceMotionRef.current ? { type: "no-animation" } : resolved ?? { type: "spring" };
+    value.value = resolveTransition(cfg, to);
+  }, []);
 }
 function useSpring(target, config) {
   const spring = resolveSpringInput(config, useNamedTransitions());
@@ -124,7 +125,19 @@ function useColorCascade(rest, layers, options) {
   const key = options?.key ?? "backgroundColor";
   const sig = `${key}|${rest}|${layers.length}|${layers.map((l) => l.color).join(",")}`;
   const colors = useMemo(() => layers.map((l) => l.color), [sig]);
-  const progressValues = useMemo(() => layers.map((l) => l.progress), [sig]);
+  const progressRef = useRef([]);
+  const prevProgress = progressRef.current;
+  let progressChanged = prevProgress.length !== layers.length;
+  if (!progressChanged) {
+    for (let i = 0; i < layers.length; i++) {
+      if (prevProgress[i] !== layers[i].progress) {
+        progressChanged = true;
+        break;
+      }
+    }
+  }
+  if (progressChanged) progressRef.current = layers.map((l) => l.progress);
+  const progressValues = progressRef.current;
   return useAnimatedStyle(() => {
     "worklet";
     let acc = rest;

package/dist/motion/Image.js

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunk34Q4UM6V_js = require('../chunk-34Q4UM6V.js');
-require('../chunk-IWLU3VDE.js');
+var chunkKBP4LR75_js = require('../chunk-KBP4LR75.js');
+require('../chunk-BP3Y2SHQ.js');
 require('../chunk-7AOERN53.js');
 require('../chunk-PTRF47DA.js');
 
@@ -9,5 +9,5 @@ require('../chunk-PTRF47DA.js');
 
 Object.defineProperty(exports, "MotionImage", {
   enumerable: true,
-  get: function () { return chunk34Q4UM6V_js.MotionImage; }
+  get: function () { return chunkKBP4LR75_js.MotionImage; }
 });

package/dist/motion/Image.mjs

@@ -1,4 +1,4 @@
-export { MotionImage } from '../chunk-2DHKV2XY.mjs';
-import '../chunk-LYMLQ6WQ.mjs';
+export { MotionImage } from '../chunk-O22NXXCZ.mjs';
+import '../chunk-CSODMRJ7.mjs';
 import '../chunk-R63GIUNU.mjs';
 import '../chunk-CY7Y64C3.mjs';

package/dist/motion/Pressable.js

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkNKA6XR77_js = require('../chunk-NKA6XR77.js');
-require('../chunk-IWLU3VDE.js');
+var chunk3XTVY34H_js = require('../chunk-3XTVY34H.js');
+require('../chunk-BP3Y2SHQ.js');
 require('../chunk-7AOERN53.js');
 require('../chunk-PTRF47DA.js');
 
@@ -9,5 +9,5 @@ require('../chunk-PTRF47DA.js');
 
 Object.defineProperty(exports, "MotionPressable", {
   enumerable: true,
-  get: function () { return chunkNKA6XR77_js.MotionPressable; }
+  get: function () { return chunk3XTVY34H_js.MotionPressable; }
 });

package/dist/motion/Pressable.mjs

@@ -1,4 +1,4 @@
-export { MotionPressable } from '../chunk-V6BTXHZK.mjs';
-import '../chunk-LYMLQ6WQ.mjs';
+export { MotionPressable } from '../chunk-46P57VMY.mjs';
+import '../chunk-CSODMRJ7.mjs';
 import '../chunk-R63GIUNU.mjs';
 import '../chunk-CY7Y64C3.mjs';

package/dist/motion/ScrollView.js

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkTUYHTHVV_js = require('../chunk-TUYHTHVV.js');
-require('../chunk-IWLU3VDE.js');
+var chunkW5MC3P4N_js = require('../chunk-W5MC3P4N.js');
+require('../chunk-BP3Y2SHQ.js');
 require('../chunk-7AOERN53.js');
 require('../chunk-PTRF47DA.js');
 
@@ -9,5 +9,5 @@ require('../chunk-PTRF47DA.js');
 
 Object.defineProperty(exports, "MotionScrollView", {
   enumerable: true,
-  get: function () { return chunkTUYHTHVV_js.MotionScrollView; }
+  get: function () { return chunkW5MC3P4N_js.MotionScrollView; }
 });

package/dist/motion/ScrollView.mjs

@@ -1,4 +1,4 @@
-export { MotionScrollView } from '../chunk-HFDZAHWP.mjs';
-import '../chunk-LYMLQ6WQ.mjs';
+export { MotionScrollView } from '../chunk-OQV66TBQ.mjs';
+import '../chunk-CSODMRJ7.mjs';
 import '../chunk-R63GIUNU.mjs';
 import '../chunk-CY7Y64C3.mjs';

package/dist/motion/Text.js

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkX5J5M3K3_js = require('../chunk-X5J5M3K3.js');
-require('../chunk-IWLU3VDE.js');
+var chunkFWQOXA43_js = require('../chunk-FWQOXA43.js');
+require('../chunk-BP3Y2SHQ.js');
 require('../chunk-7AOERN53.js');
 require('../chunk-PTRF47DA.js');
 
@@ -9,5 +9,5 @@ require('../chunk-PTRF47DA.js');
 
 Object.defineProperty(exports, "MotionText", {
   enumerable: true,
-  get: function () { return chunkX5J5M3K3_js.MotionText; }
+  get: function () { return chunkFWQOXA43_js.MotionText; }
 });

package/dist/motion/Text.mjs

@@ -1,4 +1,4 @@
-export { MotionText } from '../chunk-ZN3PNGHQ.mjs';
-import '../chunk-LYMLQ6WQ.mjs';
+export { MotionText } from '../chunk-SGUHE5CX.mjs';
+import '../chunk-CSODMRJ7.mjs';
 import '../chunk-R63GIUNU.mjs';
 import '../chunk-CY7Y64C3.mjs';

package/dist/motion/View.js

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkKYJROYCG_js = require('../chunk-KYJROYCG.js');
-require('../chunk-IWLU3VDE.js');
+var chunkFNVFV4EY_js = require('../chunk-FNVFV4EY.js');
+require('../chunk-BP3Y2SHQ.js');
 require('../chunk-7AOERN53.js');
 require('../chunk-PTRF47DA.js');
 
@@ -9,5 +9,5 @@ require('../chunk-PTRF47DA.js');
 
 Object.defineProperty(exports, "MotionView", {
   enumerable: true,
-  get: function () { return chunkKYJROYCG_js.MotionView; }
+  get: function () { return chunkFNVFV4EY_js.MotionView; }
 });

package/dist/motion/View.mjs

@@ -1,4 +1,4 @@
-export { MotionView } from '../chunk-TUMNV4P7.mjs';
-import '../chunk-LYMLQ6WQ.mjs';
+export { MotionView } from '../chunk-BQQTHG2V.mjs';
+import '../chunk-CSODMRJ7.mjs';
 import '../chunk-R63GIUNU.mjs';
 import '../chunk-CY7Y64C3.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rootnative/inertia",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Declarative animation primitives for React Native, built on react-native-reanimated.",
   "license": "MIT",
   "author": "RootNative",

package/src/layout/index.ts

@@ -7,6 +7,7 @@ export {
   releaseLayout,
   SHARED_LAYOUT_TTL_MS,
   __setSharedLayoutClock,
+  __sharedRegistrySize,
   type SharedRect,
 } from './sharedRegistry'
 export {

package/src/layout/sharedRegistry.ts

@@ -51,6 +51,37 @@ export const SHARED_LAYOUT_TTL_MS = 1000
  */
 let now = (): number => Date.now()
 
+/**
+ * When the last expiry sweep ran, so the scan is amortized to at most once per
+ * TTL window rather than running on every write.
+ */
+let lastSweep = 0
+
+/**
+ * Drop every entry whose TTL has passed.
+ *
+ * Without this the map only ever shrank via `consumeLayout` / `peekSharedLayout`,
+ * so a `layoutId` that unmounted and was never remounted left its rect behind
+ * for the lifetime of the process. Bounded by distinct-id count, which is small
+ * for a handful of hero images but not for per-item ids in a long-lived list
+ * (`layoutId={`photo-${item.id}`}`).
+ *
+ * Sweeping a *live* element's entry is harmless: while mounted it re-registers
+ * on every `onLayout`, and on unmount `releaseLayout` re-adds it with a fresh
+ * TTL. So the only thing an over-eager sweep can cost is a FLIP source that was
+ * already too old to be used.
+ *
+ * Time-gated so a burst of layout events doesn't turn into a burst of full
+ * scans — worst case an expired entry survives one extra TTL window.
+ */
+function sweepExpired(at: number): void {
+  if (at - lastSweep < SHARED_LAYOUT_TTL_MS) return
+  lastSweep = at
+  for (const [id, entry] of REGISTRY) {
+    if (entry.expiresAt < at) REGISTRY.delete(id)
+  }
+}
+
 /**
  * Update the latest known rect for `id`. Called on every `onLayout` of a
  * Motion primitive with `layoutId` set so the registry always holds a
@@ -58,7 +89,9 @@ let now = (): number => Date.now()
  * transition. Resets the TTL each call.
  */
 export function registerLayout(id: string, rect: SharedRect): void {
-  REGISTRY.set(id, { rect, expiresAt: now() + SHARED_LAYOUT_TTL_MS })
+  const at = now()
+  sweepExpired(at)
+  REGISTRY.set(id, { rect, expiresAt: at + SHARED_LAYOUT_TTL_MS })
 }
 
 /**
@@ -67,7 +100,9 @@ export function registerLayout(id: string, rect: SharedRect): void {
  * is purely intent-documenting at the call site.
  */
 export function releaseLayout(id: string, rect: SharedRect): void {
-  REGISTRY.set(id, { rect, expiresAt: now() + SHARED_LAYOUT_TTL_MS })
+  const at = now()
+  sweepExpired(at)
+  REGISTRY.set(id, { rect, expiresAt: at + SHARED_LAYOUT_TTL_MS })
 }
 
 /**
@@ -88,6 +123,7 @@ export function consumeLayout(id: string): SharedRect | undefined {
 /** Drop all entries. Tests use this to isolate between cases. */
 export function clearSharedRegistry(): void {
   REGISTRY.clear()
+  lastSweep = 0
 }
 
 /**
@@ -108,4 +144,17 @@ export function peekSharedLayout(id: string): SharedRect | undefined {
  */
 export function __setSharedLayoutClock(fn: (() => number) | undefined): void {
   now = fn ?? Date.now
+  // Swapping the clock makes the previous sweep timestamp meaningless — a
+  // stubbed clock usually starts near 0, which would otherwise suppress every
+  // sweep until it caught up past the real-time value recorded earlier.
+  lastSweep = 0
+}
+
+/**
+ * Test hook: how many entries the registry is holding, expired or not. Used to
+ * assert that released-but-never-consumed rects are actually evicted. Not
+ * exported from the package root — reachable only from inside the workspace.
+ */
+export function __sharedRegistrySize(): number {
+  return REGISTRY.size
 }