@graphrefly/ts 0.0.2 → 0.0.3

package/dist/sources/browser.d.cts

@@ -1,10 +1,10 @@
-import { L as Operator } from '../graph-CWK3HLPB.cjs';
-export { c as DriverResult, g as HttpRequest, h as HttpResponse, y as SseDriverEvent, z as SseEvent, A as SseRequest, I as WebSocketDriverEvent, J as WebSocketEvent, M as WebSocketRequest, V as WebhookDriverEvent, X as WebhookEvent, Y as WebhookRegistration } from '../types-BS6CyR-x.cjs';
-export { A as AsyncSourceOpts, C as CronSchedule, E as EventListenerOptionsLike, a as EventTargetLike, F as FromCronOptions, b as FromEventOptions, N as NodeInput, P as PushRegister, c as PushUnsubscribe, S as SingleFromAnyOptions, T as TimerSourceOpts, e as empty, f as firstValueFrom, d as fromAny, g as fromAsyncIter, h as fromCron, i as fromEvent, j as fromHttp, k as fromHttpWithOptions, l as fromIter, n as fromPromise, o as fromPushNotification, p as fromSSE, q as fromSSEWithOptions, r as fromTimer, s as fromWebSocket, t as fromWebSocketWithOptions, u as fromWebhook, v as fromWebhookWithOptions, w as interval, x as matchesCron, y as never, z as of, B as parseCron, H as singleFromAny, I as throwError, J as timer } from '../index-DHA1i67c.cjs';
+import { L as Operator } from '../graph-C1C-wb0L.cjs';
+export { c as DriverResult, g as HttpRequest, h as HttpResponse, y as SseDriverEvent, z as SseEvent, A as SseRequest, I as WebSocketDriverEvent, J as WebSocketEvent, M as WebSocketRequest, V as WebhookDriverEvent, X as WebhookEvent, Y as WebhookRegistration } from '../types-CTN3XoMl.cjs';
+export { A as AsyncSourceOpts, C as CronSchedule, E as EventListenerOptionsLike, a as EventTargetLike, F as FromCronOptions, b as FromEventOptions, N as NodeInput, P as PushRegister, c as PushUnsubscribe, S as SingleFromAnyOptions, T as TimerSourceOpts, e as empty, f as firstValueFrom, d as fromAny, g as fromAsyncIter, h as fromCron, i as fromEvent, j as fromHttp, k as fromHttpWithOptions, l as fromIter, n as fromPromise, o as fromPushNotification, p as fromSSE, q as fromSSEWithOptions, r as fromTimer, s as fromWebSocket, t as fromWebSocketWithOptions, u as fromWebhook, v as fromWebhookWithOptions, w as interval, x as matchesCron, y as never, z as of, B as parseCron, H as singleFromAny, I as throwError, J as timer } from '../index-DLrNopda.cjs';
 import '../core/index.cjs';
 import '../messages-CAzUPPJM.cjs';
 import '../codec-BB7p8fJc.cjs';
-import '../describe-CQRrkv-Q.cjs';
+import '../describe-BumQ-3_0.cjs';
 
 /**
  * Browser-safe source factories. This subpath intentionally excludes
@@ -49,8 +49,24 @@ interface FromRafOptions {
 /**
  * Browser animation-frame source.
  *
- * This is a browser/source boundary, not reactive-layout ownership (D181): every frame timestamp
- * enters the graph as DATA through `ctx.down`, and teardown cancels the pending host callback.
+ * @param opts - Optional scheduler, fallback timer cadence, visibility document, and strict
+ *   background parking flag.
+ * @returns An open-ended source operator that emits animation-frame timestamps as `DATA`.
+ * @example
+ * ```ts
+ * import { graph } from "@graphrefly/ts";
+ * import { fromRaf } from "@graphrefly/ts/sources/browser";
+ *
+ * const frames = graph().initNode(fromRaf({ pauseWhenHidden: true }), [], { name: "frames" });
+ * frames.subscribe((time) => {
+ *   console.log("frame", time);
+ * });
+ * ```
+ * @remarks **Browser boundary:** Each frame timestamp enters the graph as `DATA` through `ctx.down`,
+ *   and teardown cancels the pending host callback.
+ * @remarks **Hidden tabs:** `pauseWhenHidden: true` parks completely while the document is hidden;
+ *   the default preserves the timer fallback behavior.
+ * @category sources
  */
 declare function fromRaf(opts?: FromRafOptions): Operator<never, number>;
 /** Wrap an IndexedDB request as a one-shot source. */

package/dist/sources/browser.d.ts

@@ -1,10 +1,10 @@
-import { L as Operator } from '../graph-ho5sotHP.js';
-export { c as DriverResult, g as HttpRequest, h as HttpResponse, y as SseDriverEvent, z as SseEvent, A as SseRequest, I as WebSocketDriverEvent, J as WebSocketEvent, M as WebSocketRequest, V as WebhookDriverEvent, X as WebhookEvent, Y as WebhookRegistration } from '../types-C9NOgNJw.js';
-export { A as AsyncSourceOpts, C as CronSchedule, E as EventListenerOptionsLike, a as EventTargetLike, F as FromCronOptions, b as FromEventOptions, N as NodeInput, P as PushRegister, c as PushUnsubscribe, S as SingleFromAnyOptions, T as TimerSourceOpts, e as empty, f as firstValueFrom, d as fromAny, g as fromAsyncIter, h as fromCron, i as fromEvent, j as fromHttp, k as fromHttpWithOptions, l as fromIter, n as fromPromise, o as fromPushNotification, p as fromSSE, q as fromSSEWithOptions, r as fromTimer, s as fromWebSocket, t as fromWebSocketWithOptions, u as fromWebhook, v as fromWebhookWithOptions, w as interval, x as matchesCron, y as never, z as of, B as parseCron, H as singleFromAny, I as throwError, J as timer } from '../index-CQWcE0Dw.js';
+import { L as Operator } from '../graph-CS0b4V9B.js';
+export { c as DriverResult, g as HttpRequest, h as HttpResponse, y as SseDriverEvent, z as SseEvent, A as SseRequest, I as WebSocketDriverEvent, J as WebSocketEvent, M as WebSocketRequest, V as WebhookDriverEvent, X as WebhookEvent, Y as WebhookRegistration } from '../types-DChxk1vK.js';
+export { A as AsyncSourceOpts, C as CronSchedule, E as EventListenerOptionsLike, a as EventTargetLike, F as FromCronOptions, b as FromEventOptions, N as NodeInput, P as PushRegister, c as PushUnsubscribe, S as SingleFromAnyOptions, T as TimerSourceOpts, e as empty, f as firstValueFrom, d as fromAny, g as fromAsyncIter, h as fromCron, i as fromEvent, j as fromHttp, k as fromHttpWithOptions, l as fromIter, n as fromPromise, o as fromPushNotification, p as fromSSE, q as fromSSEWithOptions, r as fromTimer, s as fromWebSocket, t as fromWebSocketWithOptions, u as fromWebhook, v as fromWebhookWithOptions, w as interval, x as matchesCron, y as never, z as of, B as parseCron, H as singleFromAny, I as throwError, J as timer } from '../index-DzJni3_6.js';
 import '../core/index.js';
 import '../messages-CAzUPPJM.js';
 import '../codec-BB7p8fJc.js';
-import '../describe-B_A5fbXH.js';
+import '../describe-cYr_Z5zm.js';
 
 /**
  * Browser-safe source factories. This subpath intentionally excludes
@@ -49,8 +49,24 @@ interface FromRafOptions {
 /**
  * Browser animation-frame source.
  *
- * This is a browser/source boundary, not reactive-layout ownership (D181): every frame timestamp
- * enters the graph as DATA through `ctx.down`, and teardown cancels the pending host callback.
+ * @param opts - Optional scheduler, fallback timer cadence, visibility document, and strict
+ *   background parking flag.
+ * @returns An open-ended source operator that emits animation-frame timestamps as `DATA`.
+ * @example
+ * ```ts
+ * import { graph } from "@graphrefly/ts";
+ * import { fromRaf } from "@graphrefly/ts/sources/browser";
+ *
+ * const frames = graph().initNode(fromRaf({ pauseWhenHidden: true }), [], { name: "frames" });
+ * frames.subscribe((time) => {
+ *   console.log("frame", time);
+ * });
+ * ```
+ * @remarks **Browser boundary:** Each frame timestamp enters the graph as `DATA` through `ctx.down`,
+ *   and teardown cancels the pending host callback.
+ * @remarks **Hidden tabs:** `pauseWhenHidden: true` parks completely while the document is hidden;
+ *   the default preserves the timer fallback behavior.
+ * @category sources
  */
 declare function fromRaf(opts?: FromRafOptions): Operator<never, number>;
 /** Wrap an IndexedDB request as a one-shot source. */

package/dist/sources/browser.js

@@ -26,9 +26,9 @@ import {
   singleFromAny,
   throwError,
   timer
-} from "../chunk-CX6B6PO2.js";
-import "../chunk-CJIFGJQG.js";
-import "../chunk-SHZDP2MQ.js";
+} from "../chunk-DKFWDTVY.js";
+import "../chunk-54WPEODM.js";
+import "../chunk-GXU6WFEJ.js";
 import "../chunk-WQIA3GFB.js";
 import {
   errorPayload

package/dist/sources/browser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/sources/browser.ts"],"sourcesContent":["/**\n * Browser-safe source factories. This subpath intentionally excludes\n * Node-only adapters such as fromFSWatch.\n */\n\nimport type { Ctx } from \"../ctx/types.js\";\nimport type { Operator } from \"../graph/operators.js\";\nimport { errorPayload } from \"../protocol/messages.js\";\n\nexport * from \"./index.js\";\n\ntype IDBEventHandler<TThis> = {\n\tbivarianceHack(this: TThis, event: unknown): unknown;\n}[\"bivarianceHack\"];\n\nexport interface IDBRequestLike<T> {\n\tresult: T;\n\terror?: unknown;\n\tonsuccess: null | IDBEventHandler<IDBRequestLike<T>>;\n\tonerror: null | IDBEventHandler<IDBRequestLike<T>>;\n}\n\nexport interface IDBTransactionLike {\n\terror?: unknown;\n\toncomplete: null | IDBEventHandler<IDBTransactionLike>;\n\tonerror: null | IDBEventHandler<IDBTransactionLike>;\n\tonabort: null | IDBEventHandler<IDBTransactionLike>;\n}\n\nexport type AnimationFrameHandle = number | ReturnType<typeof setTimeout>;\n\nexport interface AnimationFrameScheduler {\n\trequestAnimationFrame(callback: (time: number) => void): AnimationFrameHandle;\n\tcancelAnimationFrame(handle: AnimationFrameHandle): void;\n}\n\nexport interface VisibilityDocumentLike {\n\treadonly visibilityState?: \"hidden\" | \"visible\" | \"prerender\" | string;\n\taddEventListener?(type: \"visibilitychange\", listener: () => void): void;\n\tremoveEventListener?(type: \"visibilitychange\", listener: () => void): void;\n}\n\nexport interface FromRafOptions {\n\t/** Custom scheduler for tests or host wrappers. Defaults to browser rAF, then a timer fallback. */\n\treadonly scheduler?: AnimationFrameScheduler;\n\t/** Timer fallback cadence when requestAnimationFrame is unavailable. Default: 16ms. */\n\treadonly fallbackMs?: number;\n\t/** Fully park while the provided/browser document is hidden. Default: false. */\n\treadonly pauseWhenHidden?: boolean;\n\t/** Document-like visibility source for tests or embedded browser hosts. */\n\treadonly document?: VisibilityDocumentLike;\n}\n\nfunction source<T>(\n\tfactory: string,\n\tsetup: (ctx: Ctx) => undefined | (() => void),\n): Operator<never, T> {\n\treturn {\n\t\tfactory,\n\t\tbody: (ctx) => {\n\t\t\tconst cleanup = setup(ctx);\n\t\t\tif (typeof cleanup === \"function\") ctx.onDeactivation(cleanup);\n\t\t},\n\t};\n}\n\nfunction defaultAnimationFrameScheduler(fallbackMs: number): AnimationFrameScheduler {\n\tconst host = globalThis as {\n\t\trequestAnimationFrame?: (callback: (time: number) => void) => number;\n\t\tcancelAnimationFrame?: (handle: number) => void;\n\t};\n\tif (\n\t\ttypeof host.requestAnimationFrame === \"function\" &&\n\t\ttypeof host.cancelAnimationFrame === \"function\"\n\t) {\n\t\treturn {\n\t\t\trequestAnimationFrame: (callback) => host.requestAnimationFrame?.(callback) ?? 0,\n\t\t\tcancelAnimationFrame: (handle) => {\n\t\t\t\tif (typeof handle === \"number\") host.cancelAnimationFrame?.(handle);\n\t\t\t},\n\t\t};\n\t}\n\treturn {\n\t\trequestAnimationFrame(callback) {\n\t\t\treturn setTimeout(() => callback(Date.now()), fallbackMs);\n\t\t},\n\t\tcancelAnimationFrame(handle) {\n\t\t\tclearTimeout(handle);\n\t\t},\n\t};\n}\n\nfunction defaultVisibilityDocument(): VisibilityDocumentLike | undefined {\n\treturn (globalThis as { document?: VisibilityDocumentLike }).document;\n}\n\n/**\n * Browser animation-frame source.\n *\n * This is a browser/source boundary, not reactive-layout ownership (D181): every frame timestamp\n * enters the graph as DATA through `ctx.down`, and teardown cancels the pending host callback.\n */\nexport function fromRaf(opts: FromRafOptions = {}): Operator<never, number> {\n\tconst fallbackMsOpt = opts.fallbackMs;\n\tconst fallbackMs =\n\t\tNumber.isFinite(fallbackMsOpt) && fallbackMsOpt !== undefined && fallbackMsOpt > 0\n\t\t\t? fallbackMsOpt\n\t\t\t: 16;\n\tconst scheduler = opts.scheduler ?? defaultAnimationFrameScheduler(fallbackMs);\n\tconst visibilityDocument = opts.document ?? defaultVisibilityDocument();\n\treturn {\n\t\tfactory: \"fromRaf\",\n\t\topts: { pool: \"sync\", pausable: false },\n\t\tbody: (ctx) => {\n\t\t\tlet active = true;\n\t\t\tlet frame: AnimationFrameHandle | undefined;\n\t\t\tconst cancelPending = () => {\n\t\t\t\tif (frame === undefined) return;\n\t\t\t\tscheduler.cancelAnimationFrame(frame);\n\t\t\t\tframe = undefined;\n\t\t\t};\n\t\t\tconst isHidden = () =>\n\t\t\t\topts.pauseWhenHidden === true && visibilityDocument?.visibilityState === \"hidden\";\n\t\t\tconst schedule = () => {\n\t\t\t\tif (!active || frame !== undefined || isHidden()) return;\n\t\t\t\tframe = scheduler.requestAnimationFrame((time) => {\n\t\t\t\t\tframe = undefined;\n\t\t\t\t\tif (!active || isHidden()) return;\n\t\t\t\t\tctx.down([[\"DATA\", Number.isFinite(time) ? time : Date.now()]]);\n\t\t\t\t\tschedule();\n\t\t\t\t});\n\t\t\t};\n\t\t\tconst onVisibilityChange = () => {\n\t\t\t\tif (!active) return;\n\t\t\t\tif (isHidden()) cancelPending();\n\t\t\t\telse schedule();\n\t\t\t};\n\t\t\tif (\n\t\t\t\topts.pauseWhenHidden === true &&\n\t\t\t\tvisibilityDocument?.addEventListener &&\n\t\t\t\tvisibilityDocument.removeEventListener\n\t\t\t) {\n\t\t\t\tvisibilityDocument.addEventListener(\"visibilitychange\", onVisibilityChange);\n\t\t\t}\n\t\t\tctx.onDeactivation(() => {\n\t\t\t\tactive = false;\n\t\t\t\tcancelPending();\n\t\t\t\tvisibilityDocument?.removeEventListener?.(\"visibilitychange\", onVisibilityChange);\n\t\t\t});\n\t\t\tschedule();\n\t\t},\n\t};\n}\n\n/** Wrap an IndexedDB request as a one-shot source. */\nexport function fromIDBRequest<T>(request: IDBRequestLike<T>): Operator<never, T> {\n\treturn source<T>(\"fromIDBRequest\", (ctx) => {\n\t\tlet done = false;\n\t\tconst clear = () => {\n\t\t\trequest.onsuccess = null;\n\t\t\trequest.onerror = null;\n\t\t};\n\t\trequest.onsuccess = () => {\n\t\t\tif (done) return;\n\t\t\tdone = true;\n\t\t\tclear();\n\t\t\tif (request.result === undefined) {\n\t\t\t\tctx.down([\n\t\t\t\t\t[\"ERROR\", new TypeError(\"fromIDBRequest: request.result is the substrate SENTINEL\")],\n\t\t\t\t]);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tctx.down([[\"DATA\", request.result], [\"COMPLETE\"]]);\n\t\t};\n\t\trequest.onerror = () => {\n\t\t\tif (done) return;\n\t\t\tdone = true;\n\t\t\tclear();\n\t\t\tctx.down([[\"ERROR\", errorPayload(request.error ?? new Error(\"IndexedDB request failed\"))]]);\n\t\t};\n\t\treturn () => {\n\t\t\tdone = true;\n\t\t\tclear();\n\t\t};\n\t});\n}\n\n/**\n * Wrap an IndexedDB transaction lifecycle as a terminal-only source.\n *\n * Success emits COMPLETE without DATA: undefined is the TypeScript SENTINEL and cannot be a DATA\n * payload under R-data-payload.\n */\nexport function fromIDBTransaction(transaction: IDBTransactionLike): Operator<never, never> {\n\treturn source<never>(\"fromIDBTransaction\", (ctx) => {\n\t\tlet done = false;\n\t\tconst clear = () => {\n\t\t\ttransaction.oncomplete = null;\n\t\t\ttransaction.onerror = null;\n\t\t\ttransaction.onabort = null;\n\t\t};\n\t\tconst fail = (fallback: string) => {\n\t\t\tif (done) return;\n\t\t\tdone = true;\n\t\t\tclear();\n\t\t\tctx.down([[\"ERROR\", errorPayload(transaction.error ?? new Error(fallback))]]);\n\t\t};\n\t\ttransaction.oncomplete = () => {\n\t\t\tif (done) return;\n\t\t\tdone = true;\n\t\t\tclear();\n\t\t\tctx.down([[\"COMPLETE\"]]);\n\t\t};\n\t\ttransaction.onerror = () => fail(\"IndexedDB transaction failed\");\n\t\ttransaction.onabort = () => fail(\"IndexedDB transaction aborted\");\n\t\treturn () => {\n\t\t\tdone = true;\n\t\t\tclear();\n\t\t};\n\t});\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/sources/browser.ts"],"sourcesContent":["/**\n * Browser-safe source factories. This subpath intentionally excludes\n * Node-only adapters such as fromFSWatch.\n */\n\nimport type { Ctx } from \"../ctx/types.js\";\nimport type { Operator } from \"../graph/operators.js\";\nimport { errorPayload } from \"../protocol/messages.js\";\n\nexport * from \"./index.js\";\n\ntype IDBEventHandler<TThis> = {\n\tbivarianceHack(this: TThis, event: unknown): unknown;\n}[\"bivarianceHack\"];\n\nexport interface IDBRequestLike<T> {\n\tresult: T;\n\terror?: unknown;\n\tonsuccess: null | IDBEventHandler<IDBRequestLike<T>>;\n\tonerror: null | IDBEventHandler<IDBRequestLike<T>>;\n}\n\nexport interface IDBTransactionLike {\n\terror?: unknown;\n\toncomplete: null | IDBEventHandler<IDBTransactionLike>;\n\tonerror: null | IDBEventHandler<IDBTransactionLike>;\n\tonabort: null | IDBEventHandler<IDBTransactionLike>;\n}\n\nexport type AnimationFrameHandle = number | ReturnType<typeof setTimeout>;\n\nexport interface AnimationFrameScheduler {\n\trequestAnimationFrame(callback: (time: number) => void): AnimationFrameHandle;\n\tcancelAnimationFrame(handle: AnimationFrameHandle): void;\n}\n\nexport interface VisibilityDocumentLike {\n\treadonly visibilityState?: \"hidden\" | \"visible\" | \"prerender\" | string;\n\taddEventListener?(type: \"visibilitychange\", listener: () => void): void;\n\tremoveEventListener?(type: \"visibilitychange\", listener: () => void): void;\n}\n\nexport interface FromRafOptions {\n\t/** Custom scheduler for tests or host wrappers. Defaults to browser rAF, then a timer fallback. */\n\treadonly scheduler?: AnimationFrameScheduler;\n\t/** Timer fallback cadence when requestAnimationFrame is unavailable. Default: 16ms. */\n\treadonly fallbackMs?: number;\n\t/** Fully park while the provided/browser document is hidden. Default: false. */\n\treadonly pauseWhenHidden?: boolean;\n\t/** Document-like visibility source for tests or embedded browser hosts. */\n\treadonly document?: VisibilityDocumentLike;\n}\n\nfunction source<T>(\n\tfactory: string,\n\tsetup: (ctx: Ctx) => undefined | (() => void),\n): Operator<never, T> {\n\treturn {\n\t\tfactory,\n\t\tbody: (ctx) => {\n\t\t\tconst cleanup = setup(ctx);\n\t\t\tif (typeof cleanup === \"function\") ctx.onDeactivation(cleanup);\n\t\t},\n\t};\n}\n\nfunction defaultAnimationFrameScheduler(fallbackMs: number): AnimationFrameScheduler {\n\tconst host = globalThis as {\n\t\trequestAnimationFrame?: (callback: (time: number) => void) => number;\n\t\tcancelAnimationFrame?: (handle: number) => void;\n\t};\n\tif (\n\t\ttypeof host.requestAnimationFrame === \"function\" &&\n\t\ttypeof host.cancelAnimationFrame === \"function\"\n\t) {\n\t\treturn {\n\t\t\trequestAnimationFrame: (callback) => host.requestAnimationFrame?.(callback) ?? 0,\n\t\t\tcancelAnimationFrame: (handle) => {\n\t\t\t\tif (typeof handle === \"number\") host.cancelAnimationFrame?.(handle);\n\t\t\t},\n\t\t};\n\t}\n\treturn {\n\t\trequestAnimationFrame(callback) {\n\t\t\treturn setTimeout(() => callback(Date.now()), fallbackMs);\n\t\t},\n\t\tcancelAnimationFrame(handle) {\n\t\t\tclearTimeout(handle);\n\t\t},\n\t};\n}\n\nfunction defaultVisibilityDocument(): VisibilityDocumentLike | undefined {\n\treturn (globalThis as { document?: VisibilityDocumentLike }).document;\n}\n\n/**\n * Browser animation-frame source.\n *\n * @param opts - Optional scheduler, fallback timer cadence, visibility document, and strict\n *   background parking flag.\n * @returns An open-ended source operator that emits animation-frame timestamps as `DATA`.\n * @example\n * ```ts\n * import { graph } from \"@graphrefly/ts\";\n * import { fromRaf } from \"@graphrefly/ts/sources/browser\";\n *\n * const frames = graph().initNode(fromRaf({ pauseWhenHidden: true }), [], { name: \"frames\" });\n * frames.subscribe((time) => {\n *   console.log(\"frame\", time);\n * });\n * ```\n * @remarks **Browser boundary:** Each frame timestamp enters the graph as `DATA` through `ctx.down`,\n *   and teardown cancels the pending host callback.\n * @remarks **Hidden tabs:** `pauseWhenHidden: true` parks completely while the document is hidden;\n *   the default preserves the timer fallback behavior.\n * @category sources\n */\nexport function fromRaf(opts: FromRafOptions = {}): Operator<never, number> {\n\tconst fallbackMsOpt = opts.fallbackMs;\n\tconst fallbackMs =\n\t\tNumber.isFinite(fallbackMsOpt) && fallbackMsOpt !== undefined && fallbackMsOpt > 0\n\t\t\t? fallbackMsOpt\n\t\t\t: 16;\n\tconst scheduler = opts.scheduler ?? defaultAnimationFrameScheduler(fallbackMs);\n\tconst visibilityDocument = opts.document ?? defaultVisibilityDocument();\n\treturn {\n\t\tfactory: \"fromRaf\",\n\t\topts: { pool: \"sync\", pausable: false },\n\t\tbody: (ctx) => {\n\t\t\tlet active = true;\n\t\t\tlet frame: AnimationFrameHandle | undefined;\n\t\t\tconst cancelPending = () => {\n\t\t\t\tif (frame === undefined) return;\n\t\t\t\tscheduler.cancelAnimationFrame(frame);\n\t\t\t\tframe = undefined;\n\t\t\t};\n\t\t\tconst isHidden = () =>\n\t\t\t\topts.pauseWhenHidden === true && visibilityDocument?.visibilityState === \"hidden\";\n\t\t\tconst schedule = () => {\n\t\t\t\tif (!active || frame !== undefined || isHidden()) return;\n\t\t\t\tframe = scheduler.requestAnimationFrame((time) => {\n\t\t\t\t\tframe = undefined;\n\t\t\t\t\tif (!active || isHidden()) return;\n\t\t\t\t\tctx.down([[\"DATA\", Number.isFinite(time) ? time : Date.now()]]);\n\t\t\t\t\tschedule();\n\t\t\t\t});\n\t\t\t};\n\t\t\tconst onVisibilityChange = () => {\n\t\t\t\tif (!active) return;\n\t\t\t\tif (isHidden()) cancelPending();\n\t\t\t\telse schedule();\n\t\t\t};\n\t\t\tif (\n\t\t\t\topts.pauseWhenHidden === true &&\n\t\t\t\tvisibilityDocument?.addEventListener &&\n\t\t\t\tvisibilityDocument.removeEventListener\n\t\t\t) {\n\t\t\t\tvisibilityDocument.addEventListener(\"visibilitychange\", onVisibilityChange);\n\t\t\t}\n\t\t\tctx.onDeactivation(() => {\n\t\t\t\tactive = false;\n\t\t\t\tcancelPending();\n\t\t\t\tvisibilityDocument?.removeEventListener?.(\"visibilitychange\", onVisibilityChange);\n\t\t\t});\n\t\t\tschedule();\n\t\t},\n\t};\n}\n\n/** Wrap an IndexedDB request as a one-shot source. */\nexport function fromIDBRequest<T>(request: IDBRequestLike<T>): Operator<never, T> {\n\treturn source<T>(\"fromIDBRequest\", (ctx) => {\n\t\tlet done = false;\n\t\tconst clear = () => {\n\t\t\trequest.onsuccess = null;\n\t\t\trequest.onerror = null;\n\t\t};\n\t\trequest.onsuccess = () => {\n\t\t\tif (done) return;\n\t\t\tdone = true;\n\t\t\tclear();\n\t\t\tif (request.result === undefined) {\n\t\t\t\tctx.down([\n\t\t\t\t\t[\"ERROR\", new TypeError(\"fromIDBRequest: request.result is the substrate SENTINEL\")],\n\t\t\t\t]);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tctx.down([[\"DATA\", request.result], [\"COMPLETE\"]]);\n\t\t};\n\t\trequest.onerror = () => {\n\t\t\tif (done) return;\n\t\t\tdone = true;\n\t\t\tclear();\n\t\t\tctx.down([[\"ERROR\", errorPayload(request.error ?? new Error(\"IndexedDB request failed\"))]]);\n\t\t};\n\t\treturn () => {\n\t\t\tdone = true;\n\t\t\tclear();\n\t\t};\n\t});\n}\n\n/**\n * Wrap an IndexedDB transaction lifecycle as a terminal-only source.\n *\n * Success emits COMPLETE without DATA: undefined is the TypeScript SENTINEL and cannot be a DATA\n * payload under R-data-payload.\n */\nexport function fromIDBTransaction(transaction: IDBTransactionLike): Operator<never, never> {\n\treturn source<never>(\"fromIDBTransaction\", (ctx) => {\n\t\tlet done = false;\n\t\tconst clear = () => {\n\t\t\ttransaction.oncomplete = null;\n\t\t\ttransaction.onerror = null;\n\t\t\ttransaction.onabort = null;\n\t\t};\n\t\tconst fail = (fallback: string) => {\n\t\t\tif (done) return;\n\t\t\tdone = true;\n\t\t\tclear();\n\t\t\tctx.down([[\"ERROR\", errorPayload(transaction.error ?? new Error(fallback))]]);\n\t\t};\n\t\ttransaction.oncomplete = () => {\n\t\t\tif (done) return;\n\t\t\tdone = true;\n\t\t\tclear();\n\t\t\tctx.down([[\"COMPLETE\"]]);\n\t\t};\n\t\ttransaction.onerror = () => fail(\"IndexedDB transaction failed\");\n\t\ttransaction.onabort = () => fail(\"IndexedDB transaction aborted\");\n\t\treturn () => {\n\t\t\tdone = true;\n\t\t\tclear();\n\t\t};\n\t});\n}\n"],"mappings":"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","names":[]}