phase 0.2.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +32 -32
- package/dist/{debounce-V_5xqZSY.js → debounce-BA-WszUy.js} +52 -28
- package/dist/debounce-BA-WszUy.js.map +1 -0
- package/dist/{index-MqCTTujG.d.ts → index-BF6G-0ih.d.ts} +14 -4
- package/dist/{index-MqCTTujG.d.ts.map → index-BF6G-0ih.d.ts.map} +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/react.d.ts +28 -1
- package/dist/react.d.ts.map +1 -1
- package/dist/react.js +28 -16
- package/dist/react.js.map +1 -1
- package/package.json +1 -1
- package/dist/debounce-V_5xqZSY.js.map +0 -1
package/README.md
CHANGED
|
@@ -238,15 +238,15 @@ createLoop({
|
|
|
238
238
|
|
|
239
239
|
#### Loop options
|
|
240
240
|
|
|
241
|
-
| Option | Type | Default | Description
|
|
242
|
-
| --------------- | ----------------------------------- | ------------ |
|
|
243
|
-
| `target` | `Element`
|
|
244
|
-
| `onTick` | `(frame: FrameState) => void` | required | Called each frame while running
|
|
245
|
-
| `fps` | `number` | — | Cap frames per second
|
|
246
|
-
| `reducedMotion` | `'pause' \| 'complete' \| 'ignore'` | `'pause'` | Behavior when user prefers reduced motion
|
|
247
|
-
| `degraded` | `'throttle' \| 'pause' \| 'ignore'` | `'throttle'` | Behavior when quality degrades
|
|
248
|
-
| `degradedFps` | `number` | `30` | FPS cap in degraded throttle mode
|
|
249
|
-
| `onPhaseChange` | `(phase, reason) => void` | — | Called on every phase transition
|
|
241
|
+
| Option | Type | Default | Description |
|
|
242
|
+
| --------------- | ----------------------------------- | ------------ | ------------------------------------------------------------- |
|
|
243
|
+
| `target` | `Element \| Document` | required | Element to observe for visibility, or `document` for the page |
|
|
244
|
+
| `onTick` | `(frame: FrameState) => void` | required | Called each frame while running |
|
|
245
|
+
| `fps` | `number` | — | Cap frames per second |
|
|
246
|
+
| `reducedMotion` | `'pause' \| 'complete' \| 'ignore'` | `'pause'` | Behavior when user prefers reduced motion |
|
|
247
|
+
| `degraded` | `'throttle' \| 'pause' \| 'ignore'` | `'throttle'` | Behavior when quality degrades |
|
|
248
|
+
| `degradedFps` | `number` | `30` | FPS cap in degraded throttle mode |
|
|
249
|
+
| `onPhaseChange` | `(phase, reason) => void` | — | Called on every phase transition |
|
|
250
250
|
|
|
251
251
|
### createTicker
|
|
252
252
|
|
|
@@ -359,17 +359,17 @@ The `steps` option controls threshold granularity. Default `20` generates 21 eve
|
|
|
359
359
|
|
|
360
360
|
#### ScrollProgress options
|
|
361
361
|
|
|
362
|
-
| Option | Type | Default | Description
|
|
363
|
-
| ------------ | ----------------------------- | -------- |
|
|
364
|
-
| `target` | `Element`
|
|
365
|
-
| `onProgress` | `(ratio: number) => void` | required | Called at each threshold crossing
|
|
366
|
-
| `steps` | `number` | `20` | Number of evenly-spaced thresholds
|
|
367
|
-
| `root` | `Element \| Document \| null` | — | IO root element
|
|
368
|
-
| `rootMargin` | `string` | — | IO root margin
|
|
362
|
+
| Option | Type | Default | Description |
|
|
363
|
+
| ------------ | ----------------------------- | -------- | ---------------------------------------------- |
|
|
364
|
+
| `target` | `Element \| Document` | required | Element to observe, or `document` for the page |
|
|
365
|
+
| `onProgress` | `(ratio: number) => void` | required | Called at each threshold crossing |
|
|
366
|
+
| `steps` | `number` | `20` | Number of evenly-spaced thresholds |
|
|
367
|
+
| `root` | `Element \| Document \| null` | — | IO root element |
|
|
368
|
+
| `rootMargin` | `string` | — | IO root margin |
|
|
369
369
|
|
|
370
370
|
### createScroll
|
|
371
371
|
|
|
372
|
-
Tracks a scroll container's offset and progress. Reads `scrollLeft`/`scrollTop` once per rAF frame and reads the reflow-heavy geometry (`scrollWidth`/`clientWidth`) only on resize or explicit `measure()`, never on the scroll path. Auto-pauses off-screen via the shared IntersectionObserver pool. This is to `scroll` + `scrollWidth` what `createPointer` is to `pointermove` + `getBoundingClientRect`.
|
|
372
|
+
Tracks a scroll container's offset and progress. Reads `scrollLeft`/`scrollTop` once per rAF frame and reads the reflow-heavy geometry (`scrollWidth`/`clientWidth`) only on a coalesced resize or an explicit `measure()`, never on the scroll path. Auto-pauses off-screen via the shared IntersectionObserver pool. This is to `scroll` + `scrollWidth` what `createPointer` is to `pointermove` + `getBoundingClientRect`.
|
|
373
373
|
|
|
374
374
|
> **Scroll offset, not visibility ratio.** This reports the element's own scroll position (for scrollbars, carousels, position indicators). For _how much of an element is in the viewport_, use [`createScrollProgress`](#createscrollprogress); for CSS-declarative scroll-linked animation, use the native `ScrollTimeline` API.
|
|
375
375
|
|
|
@@ -1236,9 +1236,9 @@ Minimal footprint is a core promise (see [Why phase](#why-phase)). Every export
|
|
|
1236
1236
|
| ------------------------- | ----------------: |
|
|
1237
1237
|
| **Core** | |
|
|
1238
1238
|
| `createTicker` | 847 B |
|
|
1239
|
-
| `createSight` |
|
|
1240
|
-
| `createLifecycle` | 1.
|
|
1241
|
-
| `createLoop` |
|
|
1239
|
+
| `createSight` | 1.01 kB |
|
|
1240
|
+
| `createLifecycle` | 1.52 kB |
|
|
1241
|
+
| `createLoop` | 2.65 kB |
|
|
1242
1242
|
| `createScrollProgress` | 869 B |
|
|
1243
1243
|
| `createRenderState` | 490 B |
|
|
1244
1244
|
| `createDevicePixelRatio` | 544 B |
|
|
@@ -1252,18 +1252,18 @@ Minimal footprint is a core promise (see [Why phase](#why-phase)). Every export
|
|
|
1252
1252
|
| **Ease** | |
|
|
1253
1253
|
| `ease (all)` | 210 B |
|
|
1254
1254
|
| **React** | |
|
|
1255
|
-
| `useLoop` | 2.
|
|
1256
|
-
| `useLifecycle` | 1.
|
|
1257
|
-
| `useSight` | 1.
|
|
1258
|
-
| `useCanvas` | 3.
|
|
1255
|
+
| `useLoop` | 2.98 kB |
|
|
1256
|
+
| `useLifecycle` | 1.81 kB |
|
|
1257
|
+
| `useSight` | 1.33 kB |
|
|
1258
|
+
| `useCanvas` | 3.51 kB |
|
|
1259
1259
|
| `useMutation` | 1.36 kB |
|
|
1260
1260
|
| `usePointer` | 1.47 kB |
|
|
1261
1261
|
| `useScroll` | 1.9 kB |
|
|
1262
|
-
| `useThrottledCallback` |
|
|
1263
|
-
| `useDebouncedCallback` |
|
|
1262
|
+
| `useThrottledCallback` | 804 B |
|
|
1263
|
+
| `useDebouncedCallback` | 696 B |
|
|
1264
1264
|
| `useTween` | 680 B |
|
|
1265
1265
|
| `usePresence` | 591 B |
|
|
1266
|
-
| `useScrollProgress` |
|
|
1266
|
+
| `useScrollProgress` | 991 B |
|
|
1267
1267
|
| `useSize` | 378 B |
|
|
1268
1268
|
| `useContainerQuery` | 384 B |
|
|
1269
1269
|
| `useMediaQuery` | 246 B |
|
|
@@ -1272,12 +1272,12 @@ Minimal footprint is a core promise (see [Why phase](#why-phase)). Every export
|
|
|
1272
1272
|
| `useSyncedRef` | 22 B |
|
|
1273
1273
|
| `useStableCallback` | 39 B |
|
|
1274
1274
|
| `Presence` | 741 B |
|
|
1275
|
-
| `WhenVisible` | 1.
|
|
1276
|
-
| `WhenIdle` |
|
|
1275
|
+
| `WhenVisible` | 1.57 kB |
|
|
1276
|
+
| `WhenIdle` | 596 B |
|
|
1277
1277
|
| `Defer` | 86 B |
|
|
1278
|
-
| `useIdle` |
|
|
1279
|
-
| `useWhenIdle` |
|
|
1280
|
-
| `useRenderState` |
|
|
1278
|
+
| `useIdle` | 414 B |
|
|
1279
|
+
| `useWhenIdle` | 445 B |
|
|
1280
|
+
| `useRenderState` | 515 B |
|
|
1281
1281
|
| `Swap` | 1.12 kB |
|
|
1282
1282
|
|
|
1283
1283
|
<!-- SIZE-TABLE:END -->
|
|
@@ -60,7 +60,7 @@ function conflictingTargetError(fn) {
|
|
|
60
60
|
throw new PhaseError(`${fn}() received both ref and target.`, {
|
|
61
61
|
code: "conflicting_target",
|
|
62
62
|
reason: "A tracker has one anchor.",
|
|
63
|
-
fix: "Pass ref for an element,
|
|
63
|
+
fix: "Pass one: ref for an element, target: 'page' for the page."
|
|
64
64
|
});
|
|
65
65
|
}
|
|
66
66
|
function invalidDurationError(fn, value) {
|
|
@@ -213,6 +213,19 @@ function createTicker(options) {
|
|
|
213
213
|
};
|
|
214
214
|
}
|
|
215
215
|
//#endregion
|
|
216
|
+
//#region src/core/_internal/dom/index.ts
|
|
217
|
+
const DOCUMENT_NODE = 9;
|
|
218
|
+
/**
|
|
219
|
+
* Discriminates a page target from an element target.
|
|
220
|
+
*
|
|
221
|
+
* Uses `nodeType` rather than a property check: `document.scrollingElement` is
|
|
222
|
+
* absent in some test DOMs, so feature detection would silently classify a
|
|
223
|
+
* Document as an Element.
|
|
224
|
+
*/
|
|
225
|
+
function isDocument(target) {
|
|
226
|
+
return target.nodeType === DOCUMENT_NODE;
|
|
227
|
+
}
|
|
228
|
+
//#endregion
|
|
216
229
|
//#region src/core/_internal/pool/io-pool.ts
|
|
217
230
|
const pool$1 = /* @__PURE__ */ new Map();
|
|
218
231
|
/**
|
|
@@ -285,6 +298,9 @@ const createPoolEntry$1 = (options) => {
|
|
|
285
298
|
* and the element is within the viewport. Uses a shared IntersectionObserver
|
|
286
299
|
* pool. Multiple `createSight` calls with the same options share one observer.
|
|
287
300
|
*
|
|
301
|
+
* Pass `document` to anchor to the page instead. There is no viewport test to
|
|
302
|
+
* make, so no observer is created and `phase` follows document visibility.
|
|
303
|
+
*
|
|
288
304
|
* @example
|
|
289
305
|
* const sight = createSight({
|
|
290
306
|
* target: el,
|
|
@@ -303,8 +319,9 @@ function createSight(options) {
|
|
|
303
319
|
let _phase = "unknown";
|
|
304
320
|
let _reason = "initial";
|
|
305
321
|
let stopped = false;
|
|
322
|
+
const isPage = isDocument(target);
|
|
306
323
|
let documentVisible = !document.hidden;
|
|
307
|
-
let elementInView =
|
|
324
|
+
let elementInView = isPage;
|
|
308
325
|
function recompute(trigger) {
|
|
309
326
|
if (stopped) return;
|
|
310
327
|
const prev = _phase;
|
|
@@ -329,7 +346,15 @@ function createSight(options) {
|
|
|
329
346
|
}
|
|
330
347
|
document.addEventListener("visibilitychange", onVisibilityChange);
|
|
331
348
|
window.addEventListener("pageshow", onPageShow);
|
|
332
|
-
|
|
349
|
+
let unobserveIO;
|
|
350
|
+
if (isPage) try {
|
|
351
|
+
recompute("initial");
|
|
352
|
+
} catch (error) {
|
|
353
|
+
document.removeEventListener("visibilitychange", onVisibilityChange);
|
|
354
|
+
window.removeEventListener("pageshow", onPageShow);
|
|
355
|
+
throw error;
|
|
356
|
+
}
|
|
357
|
+
else unobserveIO = observeIntersection({
|
|
333
358
|
element: target,
|
|
334
359
|
onIntersect: onIntersection,
|
|
335
360
|
...intersectionOptions
|
|
@@ -341,7 +366,7 @@ function createSight(options) {
|
|
|
341
366
|
unlinkAbort?.();
|
|
342
367
|
document.removeEventListener("visibilitychange", onVisibilityChange);
|
|
343
368
|
window.removeEventListener("pageshow", onPageShow);
|
|
344
|
-
unobserveIO();
|
|
369
|
+
unobserveIO?.();
|
|
345
370
|
_phase = "hidden";
|
|
346
371
|
_reason = "initial";
|
|
347
372
|
}
|
|
@@ -1289,7 +1314,7 @@ function createScroll(options) {
|
|
|
1289
1314
|
};
|
|
1290
1315
|
let rafId = 0;
|
|
1291
1316
|
let dirty = false;
|
|
1292
|
-
let
|
|
1317
|
+
let geometryDirty = false;
|
|
1293
1318
|
let listenersAttached = false;
|
|
1294
1319
|
let unobserveRO;
|
|
1295
1320
|
function setPhase(phase, reason) {
|
|
@@ -1307,8 +1332,7 @@ function createScroll(options) {
|
|
|
1307
1332
|
_state.progressX = maxX > 0 ? _state.x / maxX : 0;
|
|
1308
1333
|
_state.progressY = maxY > 0 ? _state.y / maxY : 0;
|
|
1309
1334
|
}
|
|
1310
|
-
function
|
|
1311
|
-
if (stopped || !listenersAttached) return;
|
|
1335
|
+
function readGeometry() {
|
|
1312
1336
|
const scrollWidth = scroller.scrollWidth;
|
|
1313
1337
|
const clientWidth = scroller.clientWidth;
|
|
1314
1338
|
const scrollHeight = scroller.scrollHeight;
|
|
@@ -1319,19 +1343,21 @@ function createScroll(options) {
|
|
|
1319
1343
|
_state.maxY = maxY > 0 ? maxY : 0;
|
|
1320
1344
|
_state.visibleX = maxX > 0 ? clientWidth / scrollWidth : 1;
|
|
1321
1345
|
_state.visibleY = maxY > 0 ? clientHeight / scrollHeight : 1;
|
|
1346
|
+
}
|
|
1347
|
+
function measure() {
|
|
1348
|
+
if (stopped || !listenersAttached) return;
|
|
1349
|
+
geometryDirty = false;
|
|
1350
|
+
readGeometry();
|
|
1322
1351
|
computePosition();
|
|
1323
1352
|
onScroll(_state);
|
|
1324
1353
|
}
|
|
1325
1354
|
function flush() {
|
|
1326
1355
|
rafId = 0;
|
|
1327
|
-
if (stopped) return;
|
|
1328
|
-
if (
|
|
1329
|
-
|
|
1330
|
-
|
|
1331
|
-
measure();
|
|
1332
|
-
return;
|
|
1356
|
+
if (stopped || !dirty && !geometryDirty) return;
|
|
1357
|
+
if (geometryDirty) {
|
|
1358
|
+
geometryDirty = false;
|
|
1359
|
+
readGeometry();
|
|
1333
1360
|
}
|
|
1334
|
-
if (!dirty) return;
|
|
1335
1361
|
dirty = false;
|
|
1336
1362
|
computePosition();
|
|
1337
1363
|
onScroll(_state);
|
|
@@ -1346,7 +1372,7 @@ function createScroll(options) {
|
|
|
1346
1372
|
rafId = 0;
|
|
1347
1373
|
}
|
|
1348
1374
|
dirty = false;
|
|
1349
|
-
|
|
1375
|
+
geometryDirty = false;
|
|
1350
1376
|
}
|
|
1351
1377
|
function onScrollEvent() {
|
|
1352
1378
|
if (stopped) return;
|
|
@@ -1354,13 +1380,9 @@ function createScroll(options) {
|
|
|
1354
1380
|
scheduleFlush();
|
|
1355
1381
|
}
|
|
1356
1382
|
function onROResize() {
|
|
1357
|
-
if (stopped) return;
|
|
1358
|
-
|
|
1359
|
-
|
|
1360
|
-
scheduleFlush();
|
|
1361
|
-
return;
|
|
1362
|
-
}
|
|
1363
|
-
measure();
|
|
1383
|
+
if (stopped || !listenersAttached) return;
|
|
1384
|
+
geometryDirty = true;
|
|
1385
|
+
scheduleFlush();
|
|
1364
1386
|
}
|
|
1365
1387
|
function attachListeners() {
|
|
1366
1388
|
if (listenersAttached) return;
|
|
@@ -1418,7 +1440,13 @@ function createScroll(options) {
|
|
|
1418
1440
|
window.removeEventListener("pageshow", onPageShow);
|
|
1419
1441
|
unobserveIO?.();
|
|
1420
1442
|
};
|
|
1421
|
-
|
|
1443
|
+
try {
|
|
1444
|
+
recompute();
|
|
1445
|
+
} catch (error) {
|
|
1446
|
+
cleanupVisibility();
|
|
1447
|
+
detachListeners();
|
|
1448
|
+
throw error;
|
|
1449
|
+
}
|
|
1422
1450
|
} else {
|
|
1423
1451
|
setPhase("tracking", "started");
|
|
1424
1452
|
attachListeners();
|
|
@@ -1448,10 +1476,6 @@ function createScroll(options) {
|
|
|
1448
1476
|
stop
|
|
1449
1477
|
};
|
|
1450
1478
|
}
|
|
1451
|
-
const DOCUMENT_NODE = 9;
|
|
1452
|
-
function isDocument(target) {
|
|
1453
|
-
return target.nodeType === DOCUMENT_NODE;
|
|
1454
|
-
}
|
|
1455
1479
|
//#endregion
|
|
1456
1480
|
//#region src/core/throttle/index.ts
|
|
1457
1481
|
/**
|
|
@@ -1657,4 +1681,4 @@ function createDebounce(options) {
|
|
|
1657
1681
|
//#endregion
|
|
1658
1682
|
export { isPhaseError as C, linkAbortSignal as E, invalidDurationError as S, serverContextError as T, subscribeMediaQuery as _, createPointer as a, PhaseError as b, prefersReducedMotion as c, subscribeDpr as d, createRenderState as f, readMediaQuery as g, createLifecycle as h, observeResize as i, whenIdle as l, createLoop as m, createThrottle as n, createMutation as o, createScrollProgress as p, createScroll as r, REDUCED_MOTION_QUERY as s, createDebounce as t, readDpr as u, createSight as v, missingContextError as w, conflictingTargetError as x, createTicker as y };
|
|
1659
1683
|
|
|
1660
|
-
//# sourceMappingURL=debounce-
|
|
1684
|
+
//# sourceMappingURL=debounce-BA-WszUy.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"debounce-BA-WszUy.js","names":["pool","createPoolEntry","REDUCED_MOTION_QUERY"],"sources":["../src/core/_internal/abort/index.ts","../src/core/_internal/errors/index.ts","../src/core/tick/index.ts","../src/core/_internal/dom/index.ts","../src/core/_internal/pool/io-pool.ts","../src/core/sight/index.ts","../src/core/_internal/pool/mql-pool.ts","../src/core/lifecycle/index.ts","../src/core/loop/index.ts","../src/core/scroll-progress/index.ts","../src/core/render-state/index.ts","../src/core/_internal/pool/dpr.ts","../src/core/idle/index.ts","../src/core/reduced-motion/index.ts","../src/core/mutation/index.ts","../src/core/pointer/index.ts","../src/core/_internal/pool/ro-pool.ts","../src/core/scroll/index.ts","../src/core/throttle/index.ts","../src/core/debounce/index.ts"],"sourcesContent":["/**\n * Link an optional `AbortSignal` to a primitive's `stop`/cancel function.\n *\n * When the signal aborts, `stop` runs once. If the signal is already aborted,\n * `stop` runs synchronously. Returns an unlink function that removes the abort\n * listener. Call it from inside `stop` so a manual stop does not leave a\n * dangling listener on a long-lived controller.\n *\n * The listener is registered with `{ once: true }`, so abort and manual stop\n * are safe to interleave: whichever fires first wins, the other is a no-op.\n */\nexport function linkAbortSignal(\n signal: AbortSignal | undefined,\n stop: () => void,\n): () => void {\n if (!signal) return unlinkNoop;\n if (signal.aborted) {\n stop();\n return unlinkNoop;\n }\n signal.addEventListener('abort', stop, { once: true });\n return () => signal.removeEventListener('abort', stop);\n}\n\n/** Shared empty unlink for the no-signal and already-aborted paths. */\nfunction unlinkNoop(): void {\n // No listener was registered, so there is nothing to remove.\n}\n","export type PhaseErrorCode =\n | 'server_context'\n | 'no_target'\n | 'conflicting_target'\n | 'invalid_duration'\n | 'ticker_stopped'\n | 'missing_context';\n\ninterface PhaseErrorOptions {\n code: PhaseErrorCode;\n reason?: string;\n fix?: string;\n link?: string;\n}\n\n/** Lightweight structured error for phase. */\nexport class PhaseError extends Error {\n readonly code: PhaseErrorCode;\n readonly reason: string | undefined;\n readonly fix: string | undefined;\n readonly link: string | undefined;\n\n constructor(message: string, options: PhaseErrorOptions) {\n super(message);\n this.name = 'PhaseError';\n this.code = options.code;\n this.reason = options.reason;\n this.fix = options.fix;\n this.link = options.link;\n }\n}\n\n/** Check if a value is a PhaseError instance. */\nexport function isPhaseError(error: unknown): error is PhaseError {\n return error instanceof PhaseError;\n}\n\nexport function serverContextError(fn: string): never {\n throw new PhaseError(`${fn}() cannot be called on the server.`, {\n code: 'server_context',\n reason: 'Browser APIs are unavailable during SSR.',\n fix: 'Move into a useEffect or client-only module.',\n });\n}\n\nexport function noTargetError(fn: string): never {\n throw new PhaseError(`${fn}() requires a target.`, {\n code: 'no_target',\n reason: 'The target was null or undefined.',\n fix: 'Pass a mounted Element, or use the React hook which manages the ref.',\n });\n}\n\nexport function conflictingTargetError(fn: string): never {\n throw new PhaseError(`${fn}() received both ref and target.`, {\n code: 'conflicting_target',\n reason: 'A tracker has one anchor.',\n fix: \"Pass one: ref for an element, target: 'page' for the page.\",\n });\n}\n\nexport function invalidDurationError(fn: string, value: number): never {\n throw new PhaseError(`${fn}() received an invalid duration: ${value}`, {\n code: 'invalid_duration',\n reason: 'Duration must be a finite positive number.',\n fix: 'Pass a positive number (e.g., 300 for 300ms).',\n });\n}\n\nexport function tickerStoppedError(): never {\n throw new PhaseError('Cannot resume a stopped ticker.', {\n code: 'ticker_stopped',\n reason: 'stop() is terminal, so a stopped ticker cannot be resumed.',\n fix: 'Create a new ticker instance instead of resuming a stopped one.',\n });\n}\n\nexport function missingContextError(child: string, parent: string): never {\n throw new PhaseError(`<${child}> must be used inside <${parent}>.`, {\n code: 'missing_context',\n reason: `<${child}> reads from a context that <${parent}> provides.`,\n fix: `Wrap <${child}> with <${parent}>.`,\n });\n}\n","import { linkAbortSignal } from '../_internal/abort';\nimport { serverContextError, tickerStoppedError } from '../_internal/errors';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface FrameState {\n /** Current browser requestAnimationFrame timestamp. */\n time: number;\n /** Milliseconds since last tick, clamped to 40ms. */\n delta: number;\n /** Milliseconds since start, excluding paused time. */\n elapsed: number;\n /** Frame count since start. */\n frame: number;\n}\n\nexport type TickerPhase = 'idle' | 'running' | 'paused' | 'stopped';\nexport type TickerReason =\n | 'initial'\n | 'started'\n | 'resumed'\n | 'manual'\n | 'disposed';\n\nexport interface TickerOptions {\n /** Cap frame rate. Default: uncapped (display refresh rate). */\n fps?: number;\n /**\n * Called every frame with the current frame state. Write to refs or DOM\n * directly. Never call React `setState` here (60 state updates/sec = 60 re-renders/sec).\n */\n onTick: (frame: FrameState) => void;\n /** Abort signal that stops the ticker when aborted. */\n signal?: AbortSignal;\n}\n\nexport interface Ticker {\n start(): void;\n stop(): void;\n pause(): void;\n resume(): void;\n readonly phase: TickerPhase;\n readonly phaseReason: TickerReason;\n}\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\n/** Prevents teleportation on resume. Matches motion's maxElapsed. */\nconst MAX_DELTA_MS = 40;\n\n/** Default first-frame delta when no previous tick exists. */\nconst DEFAULT_FIRST_DELTA_MS = 16.67;\n\n// ---------------------------------------------------------------------------\n// Shared frame-locked clock\n//\n// All ticker instances subscribe to a single rAF loop so they read the same\n// timestamp each frame. This prevents visual desync between multiple loops\n// on the same page. The clock starts when the first subscriber joins and\n// stops when the last one leaves.\n// ---------------------------------------------------------------------------\n\ninterface SharedSubscription {\n callback: (time: number) => void;\n joinedFrame: number;\n}\n\nlet sharedRafId: number | null = null;\nlet sharedFrame = 0;\nlet sharedTime = 0;\nconst sharedSubscribers = new Set<SharedSubscription>();\n\nfunction dispatchSharedSubscription(subscription: SharedSubscription): void {\n if (subscription.joinedFrame < sharedFrame) {\n subscription.callback(sharedTime);\n }\n}\n\nfunction sharedTick(time: number): void {\n sharedTime = time;\n sharedFrame++;\n sharedRafId = requestAnimationFrame(sharedTick);\n // eslint-disable-next-line unicorn/no-array-for-each -- Set#forEach avoids a per-frame iterator.\n sharedSubscribers.forEach(dispatchSharedSubscription);\n}\n\nfunction joinSharedClock(subscription: SharedSubscription): void {\n const wasEmpty: boolean = sharedSubscribers.size === 0;\n subscription.joinedFrame = sharedFrame;\n sharedSubscribers.add(subscription);\n\n if (wasEmpty) {\n sharedRafId = requestAnimationFrame(sharedTick);\n }\n}\n\nfunction leaveSharedClock(subscription: SharedSubscription): void {\n sharedSubscribers.delete(subscription);\n if (sharedSubscribers.size === 0 && sharedRafId !== null) {\n cancelAnimationFrame(sharedRafId);\n sharedRafId = null;\n }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction resetFrameState(state: FrameState): void {\n state.time = 0;\n state.delta = 0;\n state.elapsed = 0;\n state.frame = 0;\n}\n\n// ---------------------------------------------------------------------------\n// createTicker\n// ---------------------------------------------------------------------------\n\n/**\n * Core rAF loop primitive with FPS cap, delta clamping, and strong pause.\n *\n * @remarks\n * `FrameState` is reused across frames. Do not store a reference to it.\n * Read values immediately in your `onTick` callback.\n */\nexport function createTicker(options: TickerOptions): Ticker {\n if (typeof requestAnimationFrame === 'undefined') {\n serverContextError('createTicker');\n }\n\n const { onTick, fps, signal } = options;\n const minFrameTime: number = fps ? 1000 / fps : 0;\n\n let _phase: TickerPhase = 'idle';\n let _reason: TickerReason = 'initial';\n\n let lastTickTime = 0;\n let pauseStartTime = 0;\n let totalPausedTime = 0;\n let startTime = 0;\n\n // Pre-allocated, mutated in place each frame — zero allocations per tick.\n const frame: FrameState = { time: 0, delta: 0, elapsed: 0, frame: 0 };\n\n function tick(now: number): void {\n // FPS throttle: skip this frame if we're ahead of the target interval.\n if (minFrameTime > 0 && now - lastTickTime < minFrameTime) return;\n\n const rawDelta: number =\n lastTickTime === 0 ? DEFAULT_FIRST_DELTA_MS : now - lastTickTime;\n lastTickTime = now;\n\n frame.time = now;\n frame.delta = rawDelta > MAX_DELTA_MS ? MAX_DELTA_MS : rawDelta;\n frame.elapsed = now - startTime - totalPausedTime;\n frame.frame++;\n\n onTick(frame);\n }\n\n const subscription: SharedSubscription = { callback: tick, joinedFrame: 0 };\n\n function start(): void {\n if (_phase === 'running') return;\n if (_phase === 'stopped') tickerStoppedError();\n if (_phase === 'paused') {\n resume();\n return;\n }\n\n _phase = 'running';\n _reason = 'started';\n startTime = performance.now();\n lastTickTime = 0;\n totalPausedTime = 0;\n resetFrameState(frame);\n\n joinSharedClock(subscription);\n }\n\n function pause(): void {\n if (_phase !== 'running') return;\n\n _phase = 'paused';\n _reason = 'manual';\n pauseStartTime = performance.now();\n\n // Strong pause: cancel rAF subscription entirely — zero CPU while paused.\n leaveSharedClock(subscription);\n }\n\n function resume(): void {\n if (_phase === 'stopped') tickerStoppedError();\n if (_phase !== 'paused') return;\n\n totalPausedTime += performance.now() - pauseStartTime;\n // Reset so the first resumed tick gets a clean delta (not the pause gap).\n lastTickTime = 0;\n\n _phase = 'running';\n _reason = 'resumed';\n joinSharedClock(subscription);\n }\n\n function stop(): void {\n if (_phase === 'stopped') return;\n\n _phase = 'stopped';\n _reason = _reason === 'initial' ? 'disposed' : 'manual';\n unlinkAbort?.();\n leaveSharedClock(subscription);\n }\n\n // Declared before assignment because an already-aborted signal makes\n // linkAbortSignal call stop() synchronously, which reads unlinkAbort.\n let unlinkAbort: (() => void) | undefined;\n unlinkAbort = linkAbortSignal(signal, stop);\n\n return {\n start,\n stop,\n pause,\n resume,\n get phase() {\n return _phase;\n },\n get phaseReason() {\n return _reason;\n },\n };\n}\n","const DOCUMENT_NODE = 9;\n\n/**\n * Discriminates a page target from an element target.\n *\n * Uses `nodeType` rather than a property check: `document.scrollingElement` is\n * absent in some test DOMs, so feature detection would silently classify a\n * Document as an Element.\n */\nexport function isDocument(target: Element | Document): target is Document {\n return target.nodeType === DOCUMENT_NODE;\n}\n","type IOCallback = (entry: IntersectionObserverEntry) => void;\n\nexport interface ObserveIntersectionOptions {\n element: Element;\n onIntersect: IOCallback;\n root?: Element | Document | null;\n rootMargin?: string;\n threshold?: number | number[];\n}\n\ninterface IOPoolEntry {\n observer: IntersectionObserver;\n callbacks: Map<Element, IOCallback>;\n}\n\nconst pool = new Map<string, IOPoolEntry>();\n\n/**\n * Observe an element via a shared IntersectionObserver pool.\n * Elements with identical options share one IO instance.\n *\n * @returns Cleanup function that unobserves the element and removes the IO if empty.\n */\nexport function observeIntersection(\n options: ObserveIntersectionOptions,\n): () => void {\n const { element, onIntersect, root, rootMargin, threshold } = options;\n const ioInit: IntersectionObserverInit = { root, rootMargin, threshold };\n\n const key: string = getPoolKey(ioInit);\n const entry: IOPoolEntry = getOrCreatePoolEntry(key, ioInit);\n\n entry.callbacks.set(element, onIntersect);\n entry.observer.observe(element);\n\n let disposed = false;\n\n return () => {\n if (disposed) return;\n disposed = true;\n\n const poolEntry: IOPoolEntry | undefined = pool.get(key);\n if (!poolEntry) return;\n\n // Only unobserve if our callback is still the registered one.\n // A later subscription on the same element would have overwritten it.\n if (poolEntry.callbacks.get(element) === onIntersect) {\n poolEntry.observer.unobserve(element);\n poolEntry.callbacks.delete(element);\n }\n\n if (poolEntry.callbacks.size === 0) {\n poolEntry.observer.disconnect();\n pool.delete(key);\n }\n };\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Produces a stable string key from IO options to group observers in the pool.\n * IO options are immutable after construction, so identical options can share.\n */\nfunction getPoolKey(opts: IntersectionObserverInit): string {\n const root = opts.root ? 'custom' : 'null';\n const margin = opts.rootMargin ?? '0px';\n const threshold = Array.isArray(opts.threshold)\n ? opts.threshold.join(',')\n : String(opts.threshold ?? 0);\n\n return `${root}|${margin}|${threshold}`;\n}\n\n/** Return an existing pool entry for this key, or create and register a new one. */\nfunction getOrCreatePoolEntry(\n key: string,\n options: IntersectionObserverInit,\n): IOPoolEntry {\n const existing: IOPoolEntry | undefined = pool.get(key);\n if (existing) return existing;\n\n const entry = createPoolEntry(options);\n\n pool.set(key, entry);\n return entry;\n}\n\n/** Create a new pool entry for the given options. */\nconst createPoolEntry = (options: IntersectionObserverInit): IOPoolEntry => {\n const callbacks = new Map<Element, IOCallback>();\n const observer = new IntersectionObserver((entries) => {\n for (const ioEntry of entries) {\n const cb: IOCallback | undefined = callbacks.get(ioEntry.target);\n if (cb) cb(ioEntry);\n }\n }, options);\n\n return { observer, callbacks };\n};\n","import { linkAbortSignal } from '../_internal/abort';\nimport { isDocument } from '../_internal/dom';\nimport { noTargetError, serverContextError } from '../_internal/errors';\nimport { observeIntersection } from '../_internal/pool/io-pool';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type SightPhase = 'unknown' | 'visible' | 'hidden';\nexport type SightReason =\n | 'initial'\n | 'viewport'\n | 'document'\n | 'bfcache'\n | 'all-hidden';\n\nexport interface SightOptions {\n /**\n * Element to observe, or `document` to track the page. A page is never\n * off-screen, so a Document target reports document visibility alone.\n */\n target: Element | Document;\n /** Forwarded to the pooled observer. Ignored for `document`. */\n intersectionOptions?: IntersectionObserverInit;\n onPhaseChange?: (phase: SightPhase, reason: SightReason) => void;\n /** Abort signal that stops the observer when aborted. */\n signal?: AbortSignal;\n}\n\nexport interface Sight {\n readonly phase: SightPhase;\n readonly phaseReason: SightReason;\n stop(): void;\n}\n\n// ---------------------------------------------------------------------------\n// createSight\n// ---------------------------------------------------------------------------\n\n/**\n * Visibility observer combining document focus and viewport intersection.\n *\n * `phase` is `'visible'` only when both the document is visible (not backgrounded)\n * and the element is within the viewport. Uses a shared IntersectionObserver\n * pool. Multiple `createSight` calls with the same options share one observer.\n *\n * Pass `document` to anchor to the page instead. There is no viewport test to\n * make, so no observer is created and `phase` follows document visibility.\n *\n * @example\n * const sight = createSight({\n * target: el,\n * onPhaseChange: (phase) => phase === 'visible' ? loop.start() : loop.pause(),\n * });\n * // cleanup:\n * sight.stop();\n *\n * @remarks\n * `onPhaseChange` fires only on phase transitions, not on every IntersectionObserver callback.\n */\nexport function createSight(options: SightOptions): Sight {\n if (typeof document === 'undefined') {\n serverContextError('createSight');\n }\n\n const { target, intersectionOptions, onPhaseChange, signal } = options;\n\n if (!target) noTargetError('createSight');\n\n let _phase: SightPhase = 'unknown';\n let _reason: SightReason = 'initial';\n let stopped = false;\n\n const isPage = isDocument(target);\n\n let documentVisible: boolean = !document.hidden;\n let elementInView = isPage;\n\n function recompute(trigger: SightReason): void {\n if (stopped) return;\n\n const prev = _phase;\n const next: SightPhase =\n documentVisible && elementInView ? 'visible' : 'hidden';\n\n _reason =\n next === 'hidden' && !documentVisible && !elementInView\n ? 'all-hidden'\n : trigger;\n\n if (next === prev) return;\n _phase = next;\n onPhaseChange?.(_phase, _reason);\n }\n\n // --- Signal handlers ---\n\n function onVisibilityChange(): void {\n documentVisible = !document.hidden;\n recompute('document');\n }\n\n function onPageShow(event: PageTransitionEvent): void {\n if (!event.persisted) return;\n documentVisible = true;\n recompute('bfcache');\n }\n\n function onIntersection(entry: IntersectionObserverEntry): void {\n elementInView = entry.isIntersecting;\n recompute('viewport');\n }\n\n // --- Subscribe ---\n\n document.addEventListener('visibilitychange', onVisibilityChange);\n window.addEventListener('pageshow', onPageShow);\n\n let unobserveIO: (() => void) | undefined;\n if (isPage) {\n // An element target gets its first phase from the observer's initial\n // callback. A page has no observer, so report the starting phase here or\n // consumers would wait on a transition that never comes.\n //\n // This is the only path where a consumer callback runs before the caller\n // holds an instance to stop, so a throw here has to release the listeners\n // itself or they outlive the failed construction.\n try {\n recompute('initial');\n } catch (error) {\n document.removeEventListener('visibilitychange', onVisibilityChange);\n window.removeEventListener('pageshow', onPageShow);\n throw error;\n }\n } else {\n unobserveIO = observeIntersection({\n element: target,\n onIntersect: onIntersection,\n ...intersectionOptions,\n });\n }\n\n let unlinkAbort: (() => void) | undefined;\n\n function stop(): void {\n if (stopped) return;\n stopped = true;\n unlinkAbort?.();\n document.removeEventListener('visibilitychange', onVisibilityChange);\n window.removeEventListener('pageshow', onPageShow);\n unobserveIO?.();\n _phase = 'hidden';\n _reason = 'initial';\n }\n\n unlinkAbort = linkAbortSignal(signal, stop);\n\n return {\n get phase() {\n return stopped ? 'hidden' : _phase;\n },\n get phaseReason() {\n return _reason;\n },\n stop,\n };\n}\n","type MQLCallback = (matches: boolean) => void;\n\ninterface MQLPoolEntry {\n mql: MediaQueryList;\n listeners: Set<MQLCallback>;\n handler: (e: MediaQueryListEvent) => void;\n}\n\nconst pool = new Map<string, MQLPoolEntry>();\n\n/**\n * Subscribe to a media query via a shared MediaQueryList pool.\n * Multiple subscribers to the same query share one MQL and one change listener.\n *\n * @returns Cleanup function that removes the subscriber.\n */\nexport function subscribeMediaQuery(\n query: string,\n callback: MQLCallback,\n): () => void {\n const entry: MQLPoolEntry = getOrCreateEntry(query);\n\n entry.listeners.add(callback);\n\n let disposed = false;\n\n return () => {\n if (disposed) return;\n disposed = true;\n\n const poolEntry: MQLPoolEntry | undefined = pool.get(query);\n if (!poolEntry) return;\n poolEntry.listeners.delete(callback);\n\n if (poolEntry.listeners.size === 0) {\n poolEntry.mql.removeEventListener('change', poolEntry.handler);\n pool.delete(query);\n }\n };\n}\n\n/**\n * Synchronous read of a media query via the shared pool.\n * Uses the existing pool entry if available, otherwise reads directly.\n */\nexport function readMediaQuery(query: string): boolean {\n const entry: MQLPoolEntry | undefined = pool.get(query);\n if (entry) return entry.mql.matches;\n return matchMedia(query).matches;\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\n/** Return an existing pool entry for this query, or create and register a new one. */\nfunction getOrCreateEntry(query: string): MQLPoolEntry {\n const existing: MQLPoolEntry | undefined = pool.get(query);\n if (existing) return existing;\n\n const entry = createPoolEntry(query);\n\n entry.mql.addEventListener('change', entry.handler);\n pool.set(query, entry);\n\n return entry;\n}\n\nconst createPoolEntry = (query: string): MQLPoolEntry => {\n const mql: MediaQueryList = matchMedia(query);\n const listeners = new Set<MQLCallback>();\n\n const handler = (event: MediaQueryListEvent): void => {\n for (const cb of listeners) cb(event.matches);\n };\n return { mql, listeners, handler };\n};\n","import { linkAbortSignal } from '../_internal/abort';\nimport { noTargetError, serverContextError } from '../_internal/errors';\nimport {\n readMediaQuery,\n subscribeMediaQuery,\n} from '../_internal/pool/mql-pool';\nimport { createSight } from '../sight';\nimport type { SightPhase } from '../sight';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type LifecyclePhase = 'idle' | 'active' | 'paused' | 'stopped';\nexport type LifecycleReason =\n | 'initial'\n | 'started'\n | 'resumed'\n | 'sight'\n | 'reduced-motion'\n | 'manual'\n | 'disposed';\n\n/** Whether reduced motion pauses the lifecycle. Default `'pause'`. */\nexport type LifecycleReducedMotion = 'pause' | 'ignore';\n\nexport interface LifecycleOptions {\n /** Element to observe, or `document` to anchor to the page. */\n target: Element | Document;\n reducedMotion?: LifecycleReducedMotion;\n intersectionOptions?: IntersectionObserverInit;\n start?: 'auto' | 'manual';\n onPhaseChange?: (phase: LifecyclePhase, reason: LifecycleReason) => void;\n /** Abort signal that stops the lifecycle when aborted. */\n signal?: AbortSignal;\n}\n\nexport interface Lifecycle {\n /** Begin honoring signals. Called automatically unless `start: 'manual'`. */\n start(): void;\n /** Terminal. Disposes observers and listeners. Cannot be restarted. */\n stop(): void;\n /** Manually pause (e.g. a panel opened over the animation). Lowest priority. */\n pause(): void;\n /** Clear a manual pause. */\n resume(): void;\n readonly phase: LifecyclePhase;\n readonly phaseReason: LifecycleReason;\n}\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst REDUCED_MOTION_QUERY = '(prefers-reduced-motion: reduce)';\n\n// ---------------------------------------------------------------------------\n// createLifecycle\n// ---------------------------------------------------------------------------\n\n/**\n * The activation decision for an animation, decoupled from who drives the frames.\n *\n * Composes visibility (`createSight`), reduced motion, and a manual pause into a\n * single `active` / `paused` phase. Use when you own your render loop (WebGL,\n * three.js, a Web Worker, or non-rAF work that should still pause off-screen or\n * under reduced motion). For loops `phase` should drive, use `createLoop` instead.\n *\n * @example\n * const lifecycle = createLifecycle({\n * target: canvas,\n * onPhaseChange: (phase) => {\n * if (phase === 'active') renderer.start();\n * else renderer.stop();\n * },\n * });\n * // cleanup:\n * lifecycle.stop();\n */\nexport function createLifecycle(options: LifecycleOptions): Lifecycle {\n if (typeof document === 'undefined') {\n serverContextError('createLifecycle');\n }\n\n const {\n target,\n reducedMotion = 'pause',\n intersectionOptions,\n start: startMode = 'auto',\n onPhaseChange,\n signal,\n } = options;\n\n if (!target) noTargetError('createLifecycle');\n\n let _phase: LifecyclePhase = 'idle';\n let _reason: LifecycleReason = 'initial';\n\n let sightVisible = false;\n let reducedMotionActive = false;\n let manualPaused = false;\n let intentStarted = false;\n let hasBeenActive = false;\n\n function setPhase(phase: LifecyclePhase, reason: LifecycleReason): void {\n if (_phase === phase && _reason === reason) return;\n _phase = phase;\n _reason = reason;\n onPhaseChange?.(phase, reason);\n }\n\n /** Highest-priority active pause signal, or null when nothing should pause. */\n function pauseReason(): LifecycleReason | null {\n if (reducedMotionActive && reducedMotion === 'pause')\n return 'reduced-motion';\n if (!sightVisible) return 'sight';\n if (manualPaused) return 'manual';\n return null;\n }\n\n function reconcile(): void {\n if (_phase === 'stopped' || !intentStarted) return;\n\n const reason = pauseReason();\n if (reason) {\n setPhase('paused', reason);\n return;\n }\n\n setPhase('active', hasBeenActive ? 'resumed' : 'started');\n hasBeenActive = true;\n }\n\n // --- Signal handlers ---\n\n function onSightChange(phase: SightPhase): void {\n sightVisible = phase === 'visible';\n reconcile();\n }\n\n function onReducedMotionChange(matches: boolean): void {\n reducedMotionActive = matches;\n reconcile();\n }\n\n // --- Init subsystems ---\n\n const sight = createSight({\n target,\n intersectionOptions,\n onPhaseChange: onSightChange,\n });\n\n let unsubReducedMotion: (() => void) | null = null;\n if (reducedMotion !== 'ignore') {\n reducedMotionActive = readMediaQuery(REDUCED_MOTION_QUERY);\n unsubReducedMotion = subscribeMediaQuery(\n REDUCED_MOTION_QUERY,\n onReducedMotionChange,\n );\n }\n\n // --- Public API ---\n\n function start(): void {\n if (_phase === 'stopped') return;\n intentStarted = true;\n reconcile();\n }\n\n function stop(): void {\n if (_phase === 'stopped') return;\n unlinkAbort?.();\n sight.stop();\n unsubReducedMotion?.();\n unsubReducedMotion = null;\n setPhase('stopped', 'disposed');\n }\n\n function pause(): void {\n if (manualPaused) return;\n manualPaused = true;\n reconcile();\n }\n\n function resume(): void {\n if (!manualPaused) return;\n manualPaused = false;\n reconcile();\n }\n\n let unlinkAbort: (() => void) | undefined;\n unlinkAbort = linkAbortSignal(signal, stop);\n\n if (startMode === 'auto') {\n start();\n }\n\n return {\n start,\n stop,\n pause,\n resume,\n get phase() {\n return _phase;\n },\n get phaseReason() {\n return _reason;\n },\n };\n}\n","import { linkAbortSignal } from '../_internal/abort';\nimport { noTargetError, serverContextError } from '../_internal/errors';\nimport { createLifecycle } from '../lifecycle';\nimport { createTicker } from '../tick';\nimport type { FrameState, Ticker } from '../tick';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type ReducedMotionBehavior = 'pause' | 'complete' | 'ignore';\nexport type DegradedBehavior = 'throttle' | 'pause' | 'ignore';\n\nexport type LoopPhase = 'idle' | 'running' | 'paused' | 'stopped';\nexport type LoopReason =\n | 'initial'\n | 'started'\n | 'resumed'\n | 'sight'\n | 'reduced-motion'\n | 'degraded'\n | 'manual'\n | 'disposed';\n\nexport type Quality = 'full' | 'degraded';\nexport type DegradedReason = 'unfocused' | 'frame-budget';\n\ninterface LoopOptionsBase {\n /** Element to observe, or `document` to anchor the loop to the page. */\n target: Element | Document;\n /**\n * Called every frame. Write to refs or DOM directly. Never call React\n * `setState` here (60 calls/sec = 60 re-renders/sec).\n */\n onTick: (frame: FrameState) => void;\n fps?: number;\n reducedMotion?: ReducedMotionBehavior;\n intersectionOptions?: IntersectionObserverInit;\n start?: 'auto' | 'manual';\n onPhaseChange?: (phase: LoopPhase, reason: LoopReason) => void;\n /** Abort signal that stops the loop when aborted. */\n signal?: AbortSignal;\n}\n\ntype DegradedOptions =\n | { degraded?: 'throttle'; degradedFps?: number }\n | { degraded: 'pause' }\n | { degraded: 'ignore' };\n\nexport type LoopOptions = LoopOptionsBase & DegradedOptions;\n\nexport interface Loop {\n start(): void;\n stop(): void;\n readonly phase: LoopPhase;\n readonly phaseReason: LoopReason;\n readonly quality: Quality;\n readonly qualityReason: DegradedReason | undefined;\n}\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\n/** How many consecutive over-budget frames before degrading quality. */\nconst OVER_BUDGET_THRESHOLD = 3;\n\n/** FPS cap applied when quality is degraded (throttle mode). */\nconst DEGRADED_FPS_CAP = 30;\n\n/**\n * In `degraded: 'pause'` mode a frame-budget degrade pauses the loop, so no\n * further frames tick to clear it. Without a timer the loop would stay paused\n * forever after a transient spike. After this delay the loop optimistically\n * un-pauses and re-measures, rescheduling on each subsequent degrade. (Throttle\n * mode keeps ticking, so it does not use this.)\n */\nconst RECOVERY_RETRY_MS = 2000;\n\n// ---------------------------------------------------------------------------\n// createLoop\n// ---------------------------------------------------------------------------\n\n/**\n * Lifecycle-aware animation loop composing ticker, visibility, and reduced motion.\n *\n * Pass an element and get a loop that pauses when the element leaves the viewport\n * or the tab is backgrounded, resumes when it returns, and cleans up with `stop()`.\n *\n * @remarks\n * The loop is signal-driven and exposes only `start()` and `stop()`. There is no\n * imperative `pause()`/`resume()`. Pausing is decided by visibility, reduced\n * motion, and quality, so an imperative pause would compete with those signals.\n * For manual control, use `useLoop`'s `enabled` option (React) or `createLifecycle`,\n * which exposes `pause()`/`resume()` for loops you drive yourself.\n *\n * @example\n * const loop = createLoop({\n * target: el,\n * onTick: (frame) => draw(ctx, frame),\n * });\n * // cleanup:\n * loop.stop();\n */\nexport function createLoop(options: LoopOptions): Loop {\n if (typeof requestAnimationFrame === 'undefined') {\n serverContextError('createLoop');\n }\n\n const {\n target,\n onTick,\n fps: baseFps,\n reducedMotion = 'pause',\n degraded = 'throttle' as DegradedBehavior,\n degradedFps: configuredDegradedFps,\n intersectionOptions,\n start: startMode = 'auto',\n onPhaseChange,\n signal,\n } = options as LoopOptionsBase & {\n degraded?: DegradedBehavior;\n degradedFps?: number;\n signal?: AbortSignal;\n };\n\n if (!target) noTargetError('createLoop');\n\n const degradedFps: number | undefined =\n degraded === 'throttle' ? configuredDegradedFps : undefined;\n\n // --- State ---\n\n let _phase: LoopPhase = 'idle';\n let _reason: LoopReason = 'initial';\n let _quality: Quality = 'full';\n let _qualityReason: DegradedReason | undefined;\n\n let intentStarted = false;\n let overBudgetCount = 0;\n let ticker: Ticker | null = null;\n\n // Quality signal flags\n let focusDegraded = false;\n\n // Pending pause-mode frame-budget recovery timer (see RECOVERY_RETRY_MS).\n let recoveryTimer: ReturnType<typeof setTimeout> | null = null;\n\n // --- State transitions ---\n\n function setPhase(phase: LoopPhase, reason: LoopReason): void {\n if (_phase === phase && _reason === reason) return;\n _phase = phase;\n _reason = reason;\n onPhaseChange?.(phase, reason);\n }\n\n function setQuality(quality: Quality, reason?: DegradedReason): void {\n const changed = _quality !== quality;\n _quality = quality;\n _qualityReason = reason;\n\n if (!changed) return;\n\n if (degraded === 'throttle') {\n if (ticker && _phase === 'running') {\n queueMicrotask(rebuildTicker);\n }\n } else if (degraded === 'pause') {\n reconcile();\n }\n }\n\n /** Evaluate all quality signals and pick the highest-priority active one. */\n function reconcileQuality(): void {\n if (focusDegraded) {\n setQuality('degraded', 'unfocused');\n return;\n }\n if (overBudgetCount >= OVER_BUDGET_THRESHOLD) {\n setQuality('degraded', 'frame-budget');\n return;\n }\n setQuality('full');\n }\n\n /**\n * Un-pause and re-measure after a pause-mode frame-budget degrade. If frames\n * are still over budget, the next degrade reschedules this.\n */\n function scheduleBudgetRecovery(): void {\n if (recoveryTimer !== null) return;\n recoveryTimer = setTimeout(() => {\n recoveryTimer = null;\n overBudgetCount = 0;\n reconcileQuality();\n }, RECOVERY_RETRY_MS);\n }\n\n function clearBudgetRecovery(): void {\n if (recoveryTimer === null) return;\n clearTimeout(recoveryTimer);\n recoveryTimer = null;\n }\n\n // --- Ticker lifecycle ---\n\n function getEffectiveFps(): number | undefined {\n if (_quality !== 'degraded') return baseFps;\n const cap: number = degradedFps ?? DEGRADED_FPS_CAP;\n if (baseFps === undefined) return cap;\n return Math.min(baseFps, cap);\n }\n\n function destroyTicker(): void {\n if (!ticker) return;\n ticker.stop();\n ticker = null;\n }\n\n function buildTicker(): void {\n const targetFps: number | undefined = getEffectiveFps();\n const budget: number = 1000 / (targetFps ?? 60);\n\n destroyTicker();\n\n ticker = createTicker({\n fps: targetFps,\n onTick: (frame) => {\n checkFrameBudget(frame.delta, budget);\n onTick(frame);\n },\n });\n ticker.start();\n }\n\n function rebuildTicker(): void {\n if (_phase !== 'running' || !ticker) return;\n buildTicker();\n }\n\n function checkFrameBudget(delta: number, budget: number): void {\n if (delta <= budget * 1.5) {\n overBudgetCount = 0;\n return;\n }\n\n overBudgetCount++;\n if (overBudgetCount < OVER_BUDGET_THRESHOLD) return;\n\n reconcileQuality();\n // Pause mode stops ticking once degraded, so no future frame can clear the\n // degraded state — schedule a timed retry. Throttle keeps running.\n if (degraded === 'pause') scheduleBudgetRecovery();\n }\n\n // --- Reconcile ---\n\n /** Check if any signal requires the loop to be paused. */\n function shouldPause(): LoopReason | null {\n // Visibility + reduced motion are owned by the lifecycle; its paused reasons\n // ('sight' | 'reduced-motion') are a subset of LoopReason.\n if (lifecycle.phase === 'paused')\n return lifecycle.phaseReason as LoopReason;\n // Quality-driven pause stays here — it needs the ticker's frame timing.\n if (degraded === 'pause' && _quality === 'degraded') return 'degraded';\n return null;\n }\n\n /** Evaluate all signals and transition to the correct phase. */\n function reconcile(): void {\n if (_phase === 'stopped' || !intentStarted) return;\n\n const pauseReason = shouldPause();\n\n if (pauseReason) {\n if (ticker && _phase === 'running') ticker.pause();\n setPhase('paused', pauseReason);\n return;\n }\n\n if (!ticker) {\n buildTicker();\n setPhase('running', _reason === 'initial' ? 'started' : 'resumed');\n } else if (_phase === 'paused') {\n ticker.resume();\n setPhase('running', 'resumed');\n }\n }\n\n // --- Signal handlers ---\n\n function onFocusChange(): void {\n focusDegraded = !document.hasFocus();\n reconcileQuality();\n }\n\n // --- Init subsystems ---\n\n // Lifecycle owns the visibility + reduced-motion decision. The loop layers the\n // ticker and quality (frame-budget / focus) on top. Driven manually so it only\n // activates once the loop itself starts.\n const lifecycle = createLifecycle({\n target,\n reducedMotion: reducedMotion === 'pause' ? 'pause' : 'ignore',\n intersectionOptions,\n start: 'manual',\n onPhaseChange: reconcile,\n });\n\n const unsubFocus: () => void = subscribeFocusTracking(onFocusChange);\n\n // --- Public API ---\n\n function start(): void {\n if (_phase === 'stopped') return;\n intentStarted = true;\n lifecycle.start();\n reconcile();\n }\n\n function stop(): void {\n if (_phase === 'stopped') return;\n unlinkAbort?.();\n clearBudgetRecovery();\n destroyTicker();\n lifecycle.stop();\n unsubFocus();\n setPhase('stopped', 'disposed');\n }\n\n // Declared before assignment because an already-aborted signal makes\n // linkAbortSignal call stop() synchronously, which reads unlinkAbort.\n let unlinkAbort: (() => void) | undefined;\n unlinkAbort = linkAbortSignal(signal, stop);\n\n if (startMode === 'auto') {\n start();\n }\n\n return {\n start,\n stop,\n get phase() {\n return _phase;\n },\n get phaseReason() {\n return _reason;\n },\n get quality() {\n return _quality;\n },\n get qualityReason() {\n return _qualityReason;\n },\n };\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nfunction subscribeFocusTracking(onChange: () => void): () => void {\n window.addEventListener('focus', onChange);\n window.addEventListener('blur', onChange);\n return () => {\n window.removeEventListener('focus', onChange);\n window.removeEventListener('blur', onChange);\n };\n}\n","import { linkAbortSignal } from '../_internal/abort';\nimport { noTargetError, serverContextError } from '../_internal/errors';\nimport { observeIntersection } from '../_internal/pool/io-pool';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface ScrollProgressOptions {\n target: Element;\n /** Called when the intersection ratio changes at a threshold crossing. */\n onProgress: (ratio: number) => void;\n /** Number of evenly-spaced thresholds. Default 20 (~5% granularity). */\n steps?: number;\n root?: Element | Document | null;\n rootMargin?: string;\n /** Abort signal that stops the observer when aborted. */\n signal?: AbortSignal;\n}\n\nexport interface ScrollProgress {\n /** Current intersection ratio (0–1). Synchronous read of the last-reported value. */\n readonly ratio: number;\n stop(): void;\n}\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_STEPS = 20;\n\n// ---------------------------------------------------------------------------\n// Threshold cache\n//\n// Most consumers use the same step count. Cache the array so the IO pool\n// receives stable references and identical pool keys without re-allocating.\n// ---------------------------------------------------------------------------\n\nconst thresholdCache = new Map<number, number[]>();\n\nfunction buildThresholds(steps: number): number[] {\n const cached: number[] | undefined = thresholdCache.get(steps);\n if (cached) return cached;\n\n const thresholds: number[] = [];\n for (let i = 0; i <= steps; i++) {\n thresholds.push(i / steps);\n }\n thresholdCache.set(steps, thresholds);\n return thresholds;\n}\n\n// ---------------------------------------------------------------------------\n// createScrollProgress\n// ---------------------------------------------------------------------------\n\n/**\n * Observe what fraction of an element is visible in the viewport (0–1).\n *\n * Uses the shared IntersectionObserver pool with multi-threshold options.\n * Multiple instances with the same `steps` share a single IO.\n *\n * @example\n * const progress = createScrollProgress({\n * target: el,\n * onProgress: (ratio) => {\n * el.style.opacity = String(ratio);\n * },\n * });\n * // cleanup:\n * progress.stop();\n */\nexport function createScrollProgress(\n options: ScrollProgressOptions,\n): ScrollProgress {\n if (typeof IntersectionObserver === 'undefined') {\n serverContextError('createScrollProgress');\n }\n\n const {\n target: element,\n onProgress,\n steps = DEFAULT_STEPS,\n root,\n rootMargin,\n signal,\n } = options;\n\n if (!element) noTargetError('createScrollProgress');\n\n let _ratio = 0;\n let stopped = false;\n\n const threshold: number[] = buildThresholds(steps);\n\n const unobserve: () => void = observeIntersection({\n element,\n onIntersect: (entry: IntersectionObserverEntry) => {\n const newRatio: number = entry.intersectionRatio;\n if (newRatio === _ratio) return;\n _ratio = newRatio;\n onProgress(newRatio);\n },\n root,\n rootMargin,\n threshold,\n });\n\n let unlinkAbort: (() => void) | undefined;\n\n function stop(): void {\n if (stopped) return;\n stopped = true;\n unlinkAbort?.();\n unobserve();\n }\n\n unlinkAbort = linkAbortSignal(signal, stop);\n\n return {\n get ratio(): number {\n return _ratio;\n },\n stop,\n };\n}\n","import { linkAbortSignal } from '../_internal/abort';\nimport { noTargetError, serverContextError } from '../_internal/errors';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type RenderPhase = 'rendered' | 'skipped';\n\nexport interface RenderStateOptions {\n target: Element;\n onPhaseChange?: (phase: RenderPhase) => void;\n /** Abort signal that stops the observer when aborted. */\n signal?: AbortSignal;\n}\n\nexport interface RenderState {\n /** Whether the browser is currently rendering the element or skipping it. */\n readonly phase: RenderPhase;\n stop(): void;\n}\n\n// ---------------------------------------------------------------------------\n// createRenderState\n// ---------------------------------------------------------------------------\n\n/**\n * Report whether the browser is rendering an element or skipping it under\n * `content-visibility`. Listens to the `contentvisibilityautostatechange`\n * event, the browser's ground-truth paint decision.\n *\n * Use it to pause raw, non-phase work (a hand-written rAF loop, `setInterval`,\n * expensive effects) when a `Defer` subtree stops painting. phase's own loops\n * already self-pause off-screen, so they do not need this.\n *\n * Listening and reacting has zero layout effect. It never breaks the\n * no-layout-shift guarantee of `content-visibility`.\n *\n * @example\n * const render = createRenderState({\n * target: el,\n * onPhaseChange: (phase) => phase === 'skipped' ? clock.pause() : clock.resume(),\n * });\n * // cleanup:\n * render.stop();\n *\n * @remarks\n * Where `content-visibility` is unsupported, `phase` stays `'rendered'`.\n *\n * Per the CSS Containment spec, `ResizeObserver` callbacks pause for elements\n * inside a skipped `content-visibility: auto` subtree. Use this primitive to\n * detect that transition when your code depends on size observations resuming.\n */\nexport function createRenderState(options: RenderStateOptions): RenderState {\n if (typeof document === 'undefined') {\n serverContextError('createRenderState');\n }\n\n const { target: element, onPhaseChange, signal } = options;\n\n if (!element) noTargetError('createRenderState');\n\n let _phase: RenderPhase = 'rendered';\n let stopped = false;\n\n function onStateChange(event: Event): void {\n if (stopped) return;\n const next: RenderPhase = (event as ContentVisibilityAutoStateChangeEvent)\n .skipped\n ? 'skipped'\n : 'rendered';\n if (next === _phase) return;\n _phase = next;\n onPhaseChange?.(_phase);\n }\n\n element.addEventListener('contentvisibilityautostatechange', onStateChange);\n\n let unlinkAbort: (() => void) | undefined;\n\n function stop(): void {\n if (stopped) return;\n stopped = true;\n unlinkAbort?.();\n element.removeEventListener(\n 'contentvisibilityautostatechange',\n onStateChange,\n );\n }\n\n unlinkAbort = linkAbortSignal(signal, stop);\n\n return {\n get phase() {\n return _phase;\n },\n stop,\n };\n}\n","type DprCallback = (dpr: number) => void;\n\nconst listeners = new Set<DprCallback>();\n\n// Last-bound DPR. Set by bind() before the MQL is created; only meaningful\n// while a subscription is active.\nlet currentDpr = 1;\n\nlet mql: MediaQueryList | null = null;\nlet handler: (() => void) | null = null;\n\n/**\n * Subscribe to devicePixelRatio changes (e.g. user drags window between monitors).\n *\n * Uses a single shared `matchMedia` query that re-subscribes on every DPR change,\n * so chained monitor switches (A -> B -> C) are all caught.\n *\n * @returns Cleanup function that removes the subscriber.\n */\nexport function subscribeDpr(callback: DprCallback): () => void {\n listeners.add(callback);\n\n if (listeners.size === 1) {\n bind();\n }\n\n let disposed = false;\n return () => {\n if (disposed) return;\n disposed = true;\n listeners.delete(callback);\n if (listeners.size === 0) {\n unbind();\n }\n };\n}\n\n/** Read the current devicePixelRatio. */\nexport function readDpr(): number {\n if (typeof window === 'undefined') return 1;\n return window.devicePixelRatio || 1;\n}\n\n// ---------------------------------------------------------------------------\n// Internal: bind/unbind the resolution MQL\n// ---------------------------------------------------------------------------\n\nfunction bind(): void {\n if (typeof matchMedia === 'undefined') return;\n currentDpr = window.devicePixelRatio || 1;\n mql = matchMedia(`(resolution: ${currentDpr}dppx)`);\n handler = onDprChange;\n mql.addEventListener('change', handler);\n}\n\nfunction unbind(): void {\n if (mql && handler) {\n mql.removeEventListener('change', handler);\n }\n mql = null;\n handler = null;\n}\n\nfunction onDprChange(): void {\n const newDpr: number = window.devicePixelRatio || 1;\n if (newDpr === currentDpr) return;\n currentDpr = newDpr;\n\n // Re-subscribe with the new DPR value so the next change is caught.\n unbind();\n bind();\n\n for (const cb of listeners) cb(newDpr);\n}\n","import { linkAbortSignal } from '../_internal/abort';\nimport { serverContextError } from '../_internal/errors';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface IdleOptions {\n /** Max ms to wait before running the callback even if no idle period occurs. */\n timeout?: number;\n /** Abort signal that cancels the scheduled callback when aborted. */\n signal?: AbortSignal;\n}\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\n/** Fallback delay when `requestIdleCallback` is unavailable (e.g. Safari). */\nconst FALLBACK_DELAY = 1;\n\n// ---------------------------------------------------------------------------\n// whenIdle\n// ---------------------------------------------------------------------------\n\n/**\n * Run a callback once the browser is idle. Wraps `requestIdleCallback`, falling\n * back to a near-immediate `setTimeout` where it is unavailable (Safari).\n *\n * Returns a cancel function. Calling it before the callback runs prevents it.\n *\n * @example\n * const cancel = whenIdle(() => warmCache(), { timeout: 2000 });\n * // later, if no longer needed:\n * cancel();\n */\nexport function whenIdle(\n callback: () => void,\n options?: IdleOptions,\n): () => void {\n if (typeof window === 'undefined') {\n serverContextError('whenIdle');\n }\n\n const { timeout, signal } = options ?? {};\n\n // Already aborted: never schedule, and hand back a no-op cancel.\n if (signal?.aborted) {\n return () => {\n // Nothing was scheduled, so there is nothing to cancel.\n };\n }\n\n let cancel: () => void;\n\n if (typeof window.requestIdleCallback === 'function') {\n // Capture cancelIdleCallback now (bound to window), rather than reading\n // window.cancelIdleCallback inside the returned closure. The cancel may run\n // after the global is swapped out (e.g. test teardown unstubbing globals),\n // and a late lookup would throw \"not a function\". Binding also avoids an\n // illegal-invocation error from calling it detached from window.\n const cancelIdle = window.cancelIdleCallback.bind(window);\n const handle: number = window.requestIdleCallback(\n () => callback(),\n timeout === undefined ? undefined : { timeout },\n );\n cancel = () => cancelIdle(handle);\n } else {\n const handle: ReturnType<typeof setTimeout> = setTimeout(\n callback,\n FALLBACK_DELAY,\n );\n cancel = () => clearTimeout(handle);\n }\n\n const unlinkAbort: () => void = linkAbortSignal(signal, cancel);\n\n return () => {\n unlinkAbort();\n cancel();\n };\n}\n","import { readMediaQuery } from '../_internal/pool/mql-pool';\n\nexport const REDUCED_MOTION_QUERY = '(prefers-reduced-motion: reduce)';\n\n/**\n * Synchronous check for `prefers-reduced-motion: reduce`.\n *\n * Returns `false` on the server (no `matchMedia`). On the client, reads from\n * the shared MQL pool so the underlying `MediaQueryList` is reused across\n * all callers.\n */\nexport function prefersReducedMotion(): boolean {\n if (typeof matchMedia === 'undefined') return false;\n return readMediaQuery(REDUCED_MOTION_QUERY);\n}\n","import { linkAbortSignal } from '../_internal/abort';\nimport { noTargetError, serverContextError } from '../_internal/errors';\nimport { observeIntersection } from '../_internal/pool/io-pool';\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\nexport type MutationPhase = 'observing' | 'paused' | 'stopped';\nexport type MutationReason = 'initial' | 'started' | 'sight' | 'disposed';\n\nexport interface MutationOptions {\n target: Element;\n /** Standard MutationObserver configuration. */\n mutation: MutationObserverInit;\n /** Called once per rAF frame with coalesced records. Never per-record. */\n onMutations: (records: MutationRecord[]) => void;\n /** Called on phase transitions (observing, paused, stopped). */\n onPhaseChange?: (phase: MutationPhase, reason: MutationReason) => void;\n /** Pause when off-screen or ignore visibility. Default `'pause'`. */\n visibility?: 'pause' | 'ignore';\n /** IO options forwarded to the visibility observer. */\n intersectionOptions?: IntersectionObserverInit;\n /** Stops the observer when aborted. */\n signal?: AbortSignal;\n}\n\nexport interface Mutation {\n readonly phase: MutationPhase;\n readonly phaseReason: MutationReason;\n stop(): void;\n}\n\n// ---------------------------------------------------------------------------\n// createMutation\n// ---------------------------------------------------------------------------\n\n/** Lifecycle-aware MutationObserver with rAF-coalesced callbacks. */\nexport function createMutation(options: MutationOptions): Mutation {\n if (typeof document === 'undefined') {\n serverContextError('createMutation');\n }\n\n const {\n target: element,\n mutation: mutationInit,\n onMutations,\n onPhaseChange,\n visibility = 'pause',\n intersectionOptions,\n signal,\n } = options;\n\n if (!element) noTargetError('createMutation');\n\n warnReflowStorm(mutationInit);\n\n let _phase: MutationPhase = 'paused';\n let _reason: MutationReason = 'initial';\n let stopped = false;\n let pendingRecords: MutationRecord[] = [];\n let rafId = 0;\n\n function setPhase(phase: MutationPhase, reason: MutationReason): void {\n const prev = _phase;\n _phase = phase;\n _reason = reason;\n if (prev !== phase) onPhaseChange?.(phase, reason);\n }\n\n function flushRecords(): void {\n rafId = 0;\n if (stopped || pendingRecords.length === 0) return;\n const batch = pendingRecords;\n pendingRecords = [];\n onMutations(batch);\n }\n\n function scheduleFlush(): void {\n if (rafId !== 0) return;\n rafId = requestAnimationFrame(flushRecords);\n }\n\n const mo = new MutationObserver((records) => {\n if (stopped || _phase !== 'observing') return;\n for (let i = 0, len = records.length; i < len; i++) {\n pendingRecords[pendingRecords.length] = records[i] as MutationRecord;\n }\n scheduleFlush();\n });\n\n function startObserving(): void {\n if (stopped || _phase === 'observing') return;\n setPhase('observing', 'started');\n mo.observe(element, mutationInit);\n }\n\n function pauseObserving(reason: MutationReason): void {\n if (stopped || _phase === 'paused') return;\n setPhase('paused', reason);\n mo.disconnect();\n if (rafId !== 0) {\n cancelAnimationFrame(rafId);\n rafId = 0;\n }\n pendingRecords = [];\n }\n\n let cleanupVisibility: (() => void) | undefined;\n\n if (visibility === 'pause') {\n let elementInView = false;\n let documentVisible = !document.hidden;\n\n function recompute(): void {\n if (stopped) return;\n if (documentVisible && elementInView) startObserving();\n else pauseObserving('sight');\n }\n\n function onVisibilityChange(): void {\n documentVisible = !document.hidden;\n recompute();\n }\n\n function onPageShow(event: PageTransitionEvent): void {\n if (!event.persisted) return;\n documentVisible = true;\n recompute();\n }\n\n document.addEventListener('visibilitychange', onVisibilityChange);\n window.addEventListener('pageshow', onPageShow);\n\n const unobserveIO = observeIntersection({\n element,\n onIntersect: (entry) => {\n elementInView = entry.isIntersecting;\n recompute();\n },\n ...intersectionOptions,\n });\n\n cleanupVisibility = () => {\n document.removeEventListener('visibilitychange', onVisibilityChange);\n window.removeEventListener('pageshow', onPageShow);\n unobserveIO();\n };\n } else {\n startObserving();\n }\n\n let unlinkAbort: (() => void) | undefined;\n\n function stop(): void {\n if (stopped) return;\n stopped = true;\n unlinkAbort?.();\n cleanupVisibility?.();\n mo.disconnect();\n if (rafId !== 0) {\n cancelAnimationFrame(rafId);\n rafId = 0;\n }\n pendingRecords = [];\n setPhase('stopped', 'disposed');\n }\n\n unlinkAbort = linkAbortSignal(signal, stop);\n\n return {\n get phase() {\n return _phase;\n },\n get phaseReason() {\n return _reason;\n },\n stop,\n };\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nconst REFLOW_STORM_ATTRIBUTES = new Set(['style', 'class']);\n\nfunction warnReflowStorm(opts: MutationObserverInit): void {\n if (process.env.NODE_ENV === 'production') return;\n if (!opts.subtree) return;\n const filter = opts.attributeFilter;\n if (!filter) return;\n if (!filter.some((attr) => REFLOW_STORM_ATTRIBUTES.has(attr))) return;\n\n console.warn(\n '[phase] createMutation: observing subtree + attributeFilter including ' +\n '\"style\" or \"class\" fires on every descendant style/class change ' +\n '(animations, hovers, framework churn). Narrow the scope or use a ' +\n 'visibility signal instead.',\n );\n}\n","import { linkAbortSignal } from '../_internal/abort';\nimport { noTargetError, serverContextError } from '../_internal/errors';\nimport { observeIntersection } from '../_internal/pool/io-pool';\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\nexport type PointerPhase = 'idle' | 'tracking' | 'stopped';\nexport type PointerReason =\n | 'initial'\n | 'enter'\n | 'leave'\n | 'sight'\n | 'disposed';\n\nexport interface PointerState {\n /** X position relative to the element's top-left, in CSS pixels. */\n x: number;\n /** Y position relative to the element's top-left, in CSS pixels. */\n y: number;\n /** Whether a pointer is currently over the element. */\n active: boolean;\n}\n\nexport interface PointerOptions {\n target: Element;\n /** Called once per rAF frame with the latest pointer position. */\n onPointer: (state: PointerState) => void;\n /** Called on phase transitions (idle, tracking, stopped). */\n onPhaseChange?: (phase: PointerPhase, reason: PointerReason) => void;\n /** Pause when off-screen or ignore visibility. Default `'pause'`. */\n visibility?: 'pause' | 'ignore';\n /** IO options forwarded to the visibility observer. */\n intersectionOptions?: IntersectionObserverInit;\n /** Stops the tracker when aborted. */\n signal?: AbortSignal;\n}\n\nexport interface Pointer {\n readonly phase: PointerPhase;\n readonly phaseReason: PointerReason;\n readonly state: Readonly<PointerState>;\n stop(): void;\n}\n\n// ---------------------------------------------------------------------------\n// createPointer\n// ---------------------------------------------------------------------------\n\n/** Lifecycle-aware pointer tracker with rAF-batched `getBoundingClientRect`. */\nexport function createPointer(options: PointerOptions): Pointer {\n if (typeof document === 'undefined') {\n serverContextError('createPointer');\n }\n\n const {\n target: element,\n onPointer,\n onPhaseChange,\n visibility = 'pause',\n intersectionOptions,\n signal,\n } = options;\n\n if (!element) noTargetError('createPointer');\n\n let _phase: PointerPhase = 'idle';\n let _reason: PointerReason = 'initial';\n let stopped = false;\n const _state: PointerState = { x: 0, y: 0, active: false };\n\n let rafId = 0;\n let lastClientX = 0;\n let lastClientY = 0;\n let dirty = false;\n\n function setPhase(phase: PointerPhase, reason: PointerReason): void {\n const prev = _phase;\n _phase = phase;\n _reason = reason;\n if (prev !== phase) onPhaseChange?.(phase, reason);\n }\n\n function flush(): void {\n rafId = 0;\n if (!dirty || stopped) return;\n dirty = false;\n const rect = element.getBoundingClientRect();\n _state.x = lastClientX - rect.left;\n _state.y = lastClientY - rect.top;\n onPointer(_state);\n }\n\n function scheduleFlush(): void {\n if (rafId !== 0) return;\n rafId = requestAnimationFrame(flush);\n }\n\n function cancelFlush(): void {\n if (rafId !== 0) {\n cancelAnimationFrame(rafId);\n rafId = 0;\n }\n dirty = false;\n }\n\n function onPointerMove(e: Event): void {\n if (stopped || _phase !== 'tracking') return;\n const pe = e as PointerEvent;\n lastClientX = pe.clientX;\n lastClientY = pe.clientY;\n dirty = true;\n scheduleFlush();\n }\n\n function onPointerEnter(): void {\n if (stopped) return;\n _state.active = true;\n setPhase('tracking', 'enter');\n }\n\n function onPointerLeave(): void {\n if (stopped) return;\n cancelFlush();\n _state.active = false;\n setPhase('idle', 'leave');\n onPointer(_state);\n }\n\n let cleanupVisibility: (() => void) | undefined;\n let listenersAttached = false;\n\n function attachListeners(): void {\n if (listenersAttached) return;\n listenersAttached = true;\n element.addEventListener('pointermove', onPointerMove);\n element.addEventListener('pointerenter', onPointerEnter);\n element.addEventListener('pointerleave', onPointerLeave);\n }\n\n function detachListeners(): void {\n if (!listenersAttached) return;\n listenersAttached = false;\n element.removeEventListener('pointermove', onPointerMove);\n element.removeEventListener('pointerenter', onPointerEnter);\n element.removeEventListener('pointerleave', onPointerLeave);\n }\n\n if (visibility === 'pause') {\n let elementInView = false;\n let documentVisible = !document.hidden;\n\n function recompute(): void {\n if (stopped) return;\n if (documentVisible && elementInView) {\n attachListeners();\n } else {\n detachListeners();\n if (_state.active) {\n cancelFlush();\n _state.active = false;\n setPhase('idle', 'sight');\n }\n }\n }\n\n function onVisChange(): void {\n documentVisible = !document.hidden;\n recompute();\n }\n\n function onPageShow(event: PageTransitionEvent): void {\n if (!event.persisted) return;\n documentVisible = true;\n recompute();\n }\n\n document.addEventListener('visibilitychange', onVisChange);\n window.addEventListener('pageshow', onPageShow);\n\n const unobserveIO = observeIntersection({\n element,\n onIntersect: (entry) => {\n elementInView = entry.isIntersecting;\n recompute();\n },\n ...intersectionOptions,\n });\n\n cleanupVisibility = () => {\n document.removeEventListener('visibilitychange', onVisChange);\n window.removeEventListener('pageshow', onPageShow);\n unobserveIO();\n };\n } else {\n attachListeners();\n }\n\n let unlinkAbort: (() => void) | undefined;\n\n function stop(): void {\n if (stopped) return;\n stopped = true;\n unlinkAbort?.();\n cleanupVisibility?.();\n detachListeners();\n cancelFlush();\n _state.active = false;\n setPhase('stopped', 'disposed');\n }\n\n unlinkAbort = linkAbortSignal(signal, stop);\n\n return {\n get phase() {\n return _phase;\n },\n get phaseReason() {\n return _reason;\n },\n get state() {\n return _state;\n },\n stop,\n };\n}\n","type ROCallback = (entry: ResizeObserverEntry) => void;\n\nlet observer: ResizeObserver | null = null;\nconst callbacks = new Map<Element, ROCallback>();\n\n/**\n * Observe an element via a singleton ResizeObserver.\n * One RO instance for the entire page. Per-element `box` options are\n * forwarded to `ResizeObserver.observe()`.\n *\n * @returns Cleanup function that unobserves the element.\n */\nexport function observeResize(\n element: Element,\n callback: ROCallback,\n box?: ResizeObserverBoxOptions,\n): () => void {\n callbacks.set(element, callback);\n getObserver().observe(element, box ? { box } : undefined);\n\n let disposed = false;\n\n return () => {\n if (disposed) return;\n disposed = true;\n\n // Only unobserve if our callback is still the registered one.\n // A later subscription on the same element would have overwritten it.\n if (callbacks.get(element) === callback) {\n callbacks.delete(element);\n observer?.unobserve(element);\n }\n };\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\n/** Lazy-created singleton. RO takes zero constructor options, so one instance can observe everything. */\nfunction getObserver(): ResizeObserver {\n if (!observer) {\n observer = new ResizeObserver((entries) => {\n for (const entry of entries) {\n const cb: ROCallback | undefined = callbacks.get(entry.target);\n if (cb) cb(entry);\n }\n });\n }\n return observer;\n}\n","import { linkAbortSignal } from '../_internal/abort';\nimport { isDocument } from '../_internal/dom';\nimport { noTargetError, serverContextError } from '../_internal/errors';\nimport { observeIntersection } from '../_internal/pool/io-pool';\nimport { observeResize } from '../_internal/pool/ro-pool';\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\nexport type ScrollPhase = 'tracking' | 'paused' | 'stopped';\nexport type ScrollReason = 'initial' | 'started' | 'sight' | 'disposed';\n\nexport interface ScrollState {\n /** `scrollLeft`, clamped to `[0, maxX]`. */\n x: number;\n /** `scrollTop`, clamped to `[0, maxY]`. */\n y: number;\n /** Max horizontal scroll distance (`scrollWidth - clientWidth`, never negative). */\n maxX: number;\n /** Max vertical scroll distance (`scrollHeight - clientHeight`, never negative). */\n maxY: number;\n /** Horizontal scroll progress `x / maxX` (0–1). `0` when not scrollable. */\n progressX: number;\n /** Vertical scroll progress `y / maxY` (0–1). `0` when not scrollable. */\n progressY: number;\n /** Visible horizontal fraction `clientWidth / scrollWidth` (0–1). Thumb `scaleX`. */\n visibleX: number;\n /** Visible vertical fraction `clientHeight / scrollHeight` (0–1). Thumb `scaleY`. */\n visibleY: number;\n}\n\n// `ScrollOptions` is a lib.dom global; do not shadow it (see code-style rules).\nexport interface CreateScrollOptions {\n /**\n * Scroll container to track. Pass an `Element` for a scrollable element, or\n * `document` to track the page scroller.\n */\n target: Element | Document;\n /** Called once per rAF frame with the latest scroll position + progress. */\n onScroll: (state: ScrollState) => void;\n /** Called on phase transitions (tracking, paused, stopped). */\n onPhaseChange?: (phase: ScrollPhase, reason: ScrollReason) => void;\n /** Pause when off-screen or ignore visibility. Default `'pause'`. */\n visibility?: 'pause' | 'ignore';\n /** IO options forwarded to the visibility observer. Ignored for `document`. */\n intersectionOptions?: IntersectionObserverInit;\n /** Stops the tracker when aborted. */\n signal?: AbortSignal;\n}\n\nexport interface Scroll {\n readonly phase: ScrollPhase;\n readonly phaseReason: ScrollReason;\n readonly state: Readonly<ScrollState>;\n /** Re-read geometry (`scrollWidth`/`clientWidth`) after a content change. */\n measure(): void;\n stop(): void;\n}\n\n// ---------------------------------------------------------------------------\n// createScroll\n// ---------------------------------------------------------------------------\n\n/**\n * Lifecycle-aware scroll tracker. Reads `scrollLeft`/`scrollTop` once per rAF\n * frame and reads the reflow-heavy geometry (`scrollWidth`/`clientWidth`) only\n * on resize or explicit `measure()`, never on the scroll path. Auto-pauses when\n * the element is off-screen.\n *\n * This is to `scroll` + `scrollWidth` what `createPointer` is to `pointermove`\n * + `getBoundingClientRect`: the layout read is batched off the hot path so the\n * per-scroll work is a single cheap position read plus math on cached geometry.\n *\n * Pass `document` to track the page. Offsets and geometry then come from\n * `document.scrollingElement`, and because the page is always in view,\n * `visibility: 'pause'` reacts to tab visibility alone rather than an\n * `IntersectionObserver`.\n */\nexport function createScroll(options: CreateScrollOptions): Scroll {\n if (typeof document === 'undefined') {\n serverContextError('createScroll');\n }\n\n const {\n target,\n onScroll,\n onPhaseChange,\n visibility = 'pause',\n intersectionOptions,\n signal,\n } = options;\n\n if (!target) noTargetError('createScroll');\n\n // Page mode reads offsets and geometry from the scrolling element, while the\n // `scroll` event stays on the Document (where the page fires it). Element mode\n // uses the same node for both.\n let pageDoc: Document | undefined;\n let scroller: Element;\n if (isDocument(target)) {\n pageDoc = target;\n // `scrollingElement` is `body` in quirks mode and absent in some test DOMs.\n scroller = target.scrollingElement ?? target.documentElement;\n } else {\n scroller = target;\n }\n\n let _phase: ScrollPhase = 'paused';\n let _reason: ScrollReason = 'initial';\n let stopped = false;\n const _state: ScrollState = {\n x: 0,\n y: 0,\n maxX: 0,\n maxY: 0,\n progressX: 0,\n progressY: 0,\n visibleX: 1,\n visibleY: 1,\n };\n\n let rafId = 0;\n let dirty = false;\n let geometryDirty = false;\n let listenersAttached = false;\n let unobserveRO: (() => void) | undefined;\n\n function setPhase(phase: ScrollPhase, reason: ScrollReason): void {\n const prev = _phase;\n _phase = phase;\n _reason = reason;\n if (prev !== phase) onPhaseChange?.(phase, reason);\n }\n\n // Reads only scroll offsets (cheap, post-layout) and derives progress from\n // the cached geometry. No `scrollWidth`/`clientWidth` here; that stays on\n // the resize path.\n function computePosition(): void {\n const { maxX, maxY } = _state;\n const x = scroller.scrollLeft;\n const y = scroller.scrollTop;\n _state.x = x < 0 ? 0 : x > maxX ? maxX : x;\n _state.y = y < 0 ? 0 : y > maxY ? maxY : y;\n _state.progressX = maxX > 0 ? _state.x / maxX : 0;\n _state.progressY = maxY > 0 ? _state.y / maxY : 0;\n }\n\n // The one reflow-heavy read. Runs on attach, on a coalesced resize, and on an\n // explicit `measure()`, never per scroll event.\n function readGeometry(): void {\n const scrollWidth = scroller.scrollWidth;\n const clientWidth = scroller.clientWidth;\n const scrollHeight = scroller.scrollHeight;\n const clientHeight = scroller.clientHeight;\n\n const maxX = scrollWidth - clientWidth;\n const maxY = scrollHeight - clientHeight;\n _state.maxX = maxX > 0 ? maxX : 0;\n _state.maxY = maxY > 0 ? maxY : 0;\n _state.visibleX = maxX > 0 ? clientWidth / scrollWidth : 1;\n _state.visibleY = maxY > 0 ? clientHeight / scrollHeight : 1;\n }\n\n // Skipped while paused/off-screen (re-entry re-measures), so this never forces\n // an off-screen reflow.\n function measure(): void {\n if (stopped || !listenersAttached) return;\n geometryDirty = false;\n readGeometry();\n computePosition();\n onScroll(_state);\n }\n\n function flush(): void {\n rafId = 0;\n if (stopped || (!dirty && !geometryDirty)) return;\n if (geometryDirty) {\n geometryDirty = false;\n readGeometry();\n }\n dirty = false;\n computePosition();\n onScroll(_state);\n }\n\n function scheduleFlush(): void {\n if (rafId !== 0) return;\n rafId = requestAnimationFrame(flush);\n }\n\n function cancelFlush(): void {\n if (rafId !== 0) {\n cancelAnimationFrame(rafId);\n rafId = 0;\n }\n dirty = false;\n geometryDirty = false;\n }\n\n function onScrollEvent(): void {\n if (stopped) return;\n dirty = true;\n scheduleFlush();\n }\n\n // Page mode hears one layout change from two sources (the observer and the\n // resize event), and an element can see a burst from the observer alone. Mark\n // the geometry stale and let the frame flush read it once.\n function onROResize(): void {\n if (stopped || !listenersAttached) return;\n geometryDirty = true;\n scheduleFlush();\n }\n\n function attachListeners(): void {\n if (listenersAttached) return;\n listenersAttached = true;\n target.addEventListener('scroll', onScrollEvent, { passive: true });\n unobserveRO = observeResize(scroller, onROResize);\n // A viewport height change (mobile URL bar, window resize) moves `maxY`\n // without resizing the scrolling element's content box, so the observer\n // alone would leave page geometry stale.\n if (pageDoc) window.addEventListener('resize', onROResize);\n measure();\n }\n\n function detachListeners(): void {\n if (!listenersAttached) return;\n listenersAttached = false;\n target.removeEventListener('scroll', onScrollEvent);\n unobserveRO?.();\n unobserveRO = undefined;\n if (pageDoc) window.removeEventListener('resize', onROResize);\n cancelFlush();\n }\n\n let cleanupVisibility: (() => void) | undefined;\n\n if (visibility === 'pause') {\n // The page is always in view, so only tab visibility gates page mode.\n let elementInView = pageDoc !== undefined;\n let documentVisible = !document.hidden;\n\n function recompute(): void {\n if (stopped) return;\n const shouldTrack = documentVisible && elementInView;\n if (shouldTrack && !listenersAttached) {\n setPhase('tracking', 'started');\n attachListeners();\n } else if (!shouldTrack && listenersAttached) {\n detachListeners();\n setPhase('paused', 'sight');\n }\n }\n\n function onVisChange(): void {\n documentVisible = !document.hidden;\n recompute();\n }\n\n function onPageShow(event: PageTransitionEvent): void {\n if (!event.persisted) return;\n documentVisible = true;\n recompute();\n }\n\n document.addEventListener('visibilitychange', onVisChange);\n window.addEventListener('pageshow', onPageShow);\n\n const unobserveIO = pageDoc\n ? undefined\n : observeIntersection({\n element: scroller,\n onIntersect: (entry) => {\n elementInView = entry.isIntersecting;\n recompute();\n },\n ...intersectionOptions,\n });\n\n cleanupVisibility = () => {\n document.removeEventListener('visibilitychange', onVisChange);\n window.removeEventListener('pageshow', onPageShow);\n unobserveIO?.();\n };\n\n // A page attaches immediately, so `onScroll` runs before the caller holds\n // an instance to stop. Release what was attached if it throws.\n try {\n recompute();\n } catch (error) {\n cleanupVisibility();\n detachListeners();\n throw error;\n }\n } else {\n setPhase('tracking', 'started');\n attachListeners();\n }\n\n let unlinkAbort: (() => void) | undefined;\n\n function stop(): void {\n if (stopped) return;\n stopped = true;\n unlinkAbort?.();\n cleanupVisibility?.();\n detachListeners();\n cancelFlush();\n setPhase('stopped', 'disposed');\n }\n\n unlinkAbort = linkAbortSignal(signal, stop);\n\n return {\n get phase() {\n return _phase;\n },\n get phaseReason() {\n return _reason;\n },\n get state() {\n return _state;\n },\n measure,\n stop,\n };\n}\n","import { linkAbortSignal } from '../_internal/abort';\nimport { serverContextError } from '../_internal/errors';\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\nexport type ThrottleEdge = 'leading' | 'trailing' | 'both';\n\nexport interface ThrottleOptions<T = void> {\n /** Called with the latest value passed to `call`. */\n callback: (value: T) => void;\n /**\n * Minimum milliseconds between invocations. Trailing calls fire on the\n * first animation frame at or past the interval, so the effective interval\n * quantizes up to frame boundaries.\n */\n interval: number;\n /** Which edges fire. Default `'both'`. */\n edge?: ThrottleEdge;\n /** Pending-call policy when the document hides. Default `'flush'`. */\n hidden?: 'flush' | 'drop';\n /** Stops the throttle when aborted. */\n signal?: AbortSignal;\n}\n\nexport interface Throttle<T = void> {\n /** Record `value` and fire per the edge rules. */\n call(value: T): void;\n /** Invoke a pending trailing call now. No-op when nothing is pending. */\n flush(): void;\n /** Discard a pending trailing call and reset the interval window. */\n cancel(): void;\n /** Whether a trailing call is waiting to fire. */\n readonly pending: boolean;\n /** Terminal. Discards pending work and removes listeners. */\n stop(): void;\n}\n\n// ---------------------------------------------------------------------------\n// createThrottle\n// ---------------------------------------------------------------------------\n\n/**\n * Frame-aligned, visibility-aware throttle. Leading calls fire synchronously;\n * a pending trailing call rides a one-shot rAF chain and fires with the latest\n * value on the first frame at or past `interval`. While the document is hidden\n * nothing is scheduled: a pending call is flushed or dropped per `hidden`, and\n * new calls are recorded but deferred until the document is visible again.\n *\n * @remarks\n * `call` takes exactly one value and stores it by reference, so the hot path\n * never allocates. Trailing calls read the value at fire time.\n */\nexport function createThrottle<T = void>(\n options: ThrottleOptions<T>,\n): Throttle<T> {\n if (typeof document === 'undefined') {\n serverContextError('createThrottle');\n }\n\n const {\n callback,\n interval,\n edge = 'both',\n hidden = 'flush',\n signal,\n } = options;\n const leading: boolean = edge !== 'trailing';\n const trailing: boolean = edge !== 'leading';\n\n let stopped = false;\n let pending = false;\n let lastFire = 0;\n let rafId = 0;\n let documentVisible: boolean = !document.hidden;\n let latest: T = undefined as T;\n\n function fire(now: number): void {\n lastFire = now;\n pending = false;\n callback(latest);\n }\n\n function cancelRaf(): void {\n if (rafId !== 0) {\n cancelAnimationFrame(rafId);\n rafId = 0;\n }\n }\n\n function tick(): void {\n rafId = 0;\n if (stopped || !pending) return;\n const now: number = performance.now();\n if (now - lastFire >= interval) {\n fire(now);\n } else {\n rafId = requestAnimationFrame(tick);\n }\n }\n\n function scheduleRaf(): void {\n if (rafId === 0) rafId = requestAnimationFrame(tick);\n }\n\n function call(value: T): void {\n if (stopped) return;\n latest = value;\n\n // Hidden: record only. Everything defers until the document is visible.\n if (!documentVisible) {\n pending = true;\n return;\n }\n\n const now: number = performance.now();\n if (now - lastFire >= interval) {\n if (leading) {\n fire(now);\n return;\n }\n // Trailing-only: open the window without firing; the trailing call\n // lands at lastFire + interval.\n lastFire = now;\n }\n\n if (trailing) {\n pending = true;\n scheduleRaf();\n }\n }\n\n function flush(): void {\n if (stopped || !pending) return;\n cancelRaf();\n fire(performance.now());\n }\n\n function cancel(): void {\n if (stopped) return;\n cancelRaf();\n pending = false;\n lastFire = 0;\n }\n\n function onVisibilityChange(): void {\n documentVisible = !document.hidden;\n if (stopped) return;\n if (!documentVisible) {\n cancelRaf();\n if (pending) {\n if (hidden === 'flush') fire(performance.now());\n else pending = false;\n }\n } else if (pending) {\n scheduleRaf();\n }\n }\n\n function onPageShow(event: PageTransitionEvent): void {\n if (!event.persisted) return;\n documentVisible = true;\n if (!stopped && pending) scheduleRaf();\n }\n\n document.addEventListener('visibilitychange', onVisibilityChange);\n window.addEventListener('pageshow', onPageShow);\n\n let unlinkAbort: (() => void) | undefined;\n\n function stop(): void {\n if (stopped) return;\n stopped = true;\n unlinkAbort?.();\n document.removeEventListener('visibilitychange', onVisibilityChange);\n window.removeEventListener('pageshow', onPageShow);\n cancelRaf();\n pending = false;\n }\n\n unlinkAbort = linkAbortSignal(signal, stop);\n\n return {\n call,\n flush,\n cancel,\n get pending() {\n return pending;\n },\n stop,\n };\n}\n","import { linkAbortSignal } from '../_internal/abort';\nimport { serverContextError } from '../_internal/errors';\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\nexport interface DebounceOptions<T = void> {\n /** Called with the latest value passed to `call`. */\n callback: (value: T) => void;\n /** Quiet period in milliseconds. Each call restarts it. */\n wait: number;\n /** Pending-call policy when the document hides. Default `'flush'`. */\n hidden?: 'flush' | 'drop';\n /** Stops the debounce when aborted. */\n signal?: AbortSignal;\n}\n\nexport interface Debounce<T = void> {\n /** Record `value` and restart the quiet timer. */\n call(value: T): void;\n /** Invoke a pending call now. No-op when nothing is pending. */\n flush(): void;\n /** Discard a pending call. */\n cancel(): void;\n /** Whether a call is waiting for the quiet period to elapse. */\n readonly pending: boolean;\n /** Terminal. Discards pending work and removes listeners. */\n stop(): void;\n}\n\n// ---------------------------------------------------------------------------\n// createDebounce\n// ---------------------------------------------------------------------------\n\n/**\n * Visibility-aware trailing debounce. Fires the callback with the latest\n * value once `wait` milliseconds pass without a new call. While the document\n * is hidden no timer runs: a pending call is flushed or dropped per `hidden`,\n * and new calls are recorded but wait until the document is visible again,\n * when the quiet timer restarts.\n */\nexport function createDebounce<T = void>(\n options: DebounceOptions<T>,\n): Debounce<T> {\n if (typeof document === 'undefined') {\n serverContextError('createDebounce');\n }\n\n const { callback, wait, hidden = 'flush', signal } = options;\n\n let stopped = false;\n let pending = false;\n let timer: ReturnType<typeof setTimeout> | undefined;\n let documentVisible: boolean = !document.hidden;\n let latest: T = undefined as T;\n\n function fire(): void {\n pending = false;\n callback(latest);\n }\n\n function clearTimer(): void {\n if (timer !== undefined) {\n clearTimeout(timer);\n timer = undefined;\n }\n }\n\n function onTimer(): void {\n timer = undefined;\n if (stopped || !pending) return;\n fire();\n }\n\n function startTimer(): void {\n clearTimer();\n timer = setTimeout(onTimer, wait);\n }\n\n function call(value: T): void {\n if (stopped) return;\n latest = value;\n pending = true;\n // Hidden: record only. The quiet timer restarts on visibility.\n if (documentVisible) startTimer();\n }\n\n function flush(): void {\n if (stopped || !pending) return;\n clearTimer();\n fire();\n }\n\n function cancel(): void {\n if (stopped) return;\n clearTimer();\n pending = false;\n }\n\n function onVisibilityChange(): void {\n documentVisible = !document.hidden;\n if (stopped) return;\n if (!documentVisible) {\n clearTimer();\n if (pending) {\n if (hidden === 'flush') fire();\n else pending = false;\n }\n } else if (pending) {\n startTimer();\n }\n }\n\n function onPageShow(event: PageTransitionEvent): void {\n if (!event.persisted) return;\n documentVisible = true;\n if (!stopped && pending) startTimer();\n }\n\n document.addEventListener('visibilitychange', onVisibilityChange);\n window.addEventListener('pageshow', onPageShow);\n\n let unlinkAbort: (() => void) | undefined;\n\n function stop(): void {\n if (stopped) return;\n stopped = true;\n unlinkAbort?.();\n document.removeEventListener('visibilitychange', onVisibilityChange);\n window.removeEventListener('pageshow', onPageShow);\n clearTimer();\n pending = false;\n }\n\n unlinkAbort = linkAbortSignal(signal, stop);\n\n return {\n call,\n flush,\n cancel,\n get pending() {\n return pending;\n },\n stop,\n };\n}\n"],"mappings":"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"}
|
|
@@ -43,7 +43,12 @@ declare function createTicker(options: TickerOptions): Ticker;
|
|
|
43
43
|
type SightPhase = 'unknown' | 'visible' | 'hidden';
|
|
44
44
|
type SightReason = 'initial' | 'viewport' | 'document' | 'bfcache' | 'all-hidden';
|
|
45
45
|
interface SightOptions {
|
|
46
|
-
|
|
46
|
+
/**
|
|
47
|
+
* Element to observe, or `document` to track the page. A page is never
|
|
48
|
+
* off-screen, so a Document target reports document visibility alone.
|
|
49
|
+
*/
|
|
50
|
+
target: Element | Document;
|
|
51
|
+
/** Forwarded to the pooled observer. Ignored for `document`. */
|
|
47
52
|
intersectionOptions?: IntersectionObserverInit;
|
|
48
53
|
onPhaseChange?: (phase: SightPhase, reason: SightReason) => void;
|
|
49
54
|
/** Abort signal that stops the observer when aborted. */
|
|
@@ -61,6 +66,9 @@ interface Sight {
|
|
|
61
66
|
* and the element is within the viewport. Uses a shared IntersectionObserver
|
|
62
67
|
* pool. Multiple `createSight` calls with the same options share one observer.
|
|
63
68
|
*
|
|
69
|
+
* Pass `document` to anchor to the page instead. There is no viewport test to
|
|
70
|
+
* make, so no observer is created and `phase` follows document visibility.
|
|
71
|
+
*
|
|
64
72
|
* @example
|
|
65
73
|
* const sight = createSight({
|
|
66
74
|
* target: el,
|
|
@@ -80,7 +88,8 @@ type LifecycleReason = 'initial' | 'started' | 'resumed' | 'sight' | 'reduced-mo
|
|
|
80
88
|
/** Whether reduced motion pauses the lifecycle. Default `'pause'`. */
|
|
81
89
|
type LifecycleReducedMotion = 'pause' | 'ignore';
|
|
82
90
|
interface LifecycleOptions {
|
|
83
|
-
|
|
91
|
+
/** Element to observe, or `document` to anchor to the page. */
|
|
92
|
+
target: Element | Document;
|
|
84
93
|
reducedMotion?: LifecycleReducedMotion;
|
|
85
94
|
intersectionOptions?: IntersectionObserverInit;
|
|
86
95
|
start?: 'auto' | 'manual';
|
|
@@ -129,7 +138,8 @@ type LoopReason = 'initial' | 'started' | 'resumed' | 'sight' | 'reduced-motion'
|
|
|
129
138
|
type Quality = 'full' | 'degraded';
|
|
130
139
|
type DegradedReason = 'unfocused' | 'frame-budget';
|
|
131
140
|
interface LoopOptionsBase {
|
|
132
|
-
|
|
141
|
+
/** Element to observe, or `document` to anchor the loop to the page. */
|
|
142
|
+
target: Element | Document;
|
|
133
143
|
/**
|
|
134
144
|
* Called every frame. Write to refs or DOM directly. Never call React
|
|
135
145
|
* `setState` here (60 calls/sec = 60 re-renders/sec).
|
|
@@ -411,4 +421,4 @@ interface Throttle<T = void> {
|
|
|
411
421
|
declare function createThrottle<T = void>(options: ThrottleOptions<T>): Throttle<T>;
|
|
412
422
|
//#endregion
|
|
413
423
|
export { createTicker as $, Loop as A, LifecycleReason as B, whenIdle as C, createRenderState as D, RenderStateOptions as E, ReducedMotionBehavior as F, SightPhase as G, createLifecycle as H, createLoop as I, FrameState as J, SightReason as K, Lifecycle as L, LoopPhase as M, LoopReason as N, DegradedBehavior as O, Quality as P, TickerReason as Q, LifecycleOptions as R, IdleOptions as S, RenderState as T, Sight as U, LifecycleReducedMotion as V, SightOptions as W, TickerOptions as X, Ticker as Y, TickerPhase as Z, Mutation as _, CreateScrollOptions as a, MutationReason as b, ScrollReason as c, Pointer as d, PointerOptions as f, createPointer as g, PointerState as h, createThrottle as i, LoopOptions as j, DegradedReason as k, ScrollState as l, PointerReason as m, ThrottleEdge as n, Scroll as o, PointerPhase as p, createSight as q, ThrottleOptions as r, ScrollPhase as s, Throttle as t, createScroll as u, MutationOptions as v, RenderPhase as w, createMutation as x, MutationPhase as y, LifecyclePhase as z };
|
|
414
|
-
//# sourceMappingURL=index-
|
|
424
|
+
//# sourceMappingURL=index-BF6G-0ih.d.ts.map
|