@askrjs/askr 0.0.51 → 0.0.53

package/dist/foundations/utilities/merge-props.js

@@ -1,49 +0,0 @@
-import { composeHandlers } from "./compose-handlers.js";
-//#region src/foundations/utilities/merge-props.ts
-/**
-* mergeProps
-*
-* Deterministic props merging.
-* - For non-handlers: `base` overwrites `injected`.
-* - For handlers present in both: handlers are composed with `injected` running
-*   first; it may call `preventDefault()` to suppress the `base` handler.
-*
-* POLICY DECISIONS (LOCKED):
-*
-* 1. Merge Strategy
-*    Base props overwrite injected props (base wins).
-*    Exception: Event handlers are composed, not overwritten.
-*
-* 2. Event Handler Detection
-*    Keys starting with "on" are treated as event handlers.
-*    This matches JSX conventions.
-*
-* 3. Handler Composition Order
-*    Injected handler runs first, base handler second.
-*    This allows injected handlers to prevent default.
-*
-* 4. Return Type
-*    Returns intersection type (TInjected & TBase) for type safety.
-*/
-function isEventHandlerKey(key) {
-	return key.startsWith("on");
-}
-function mergeProps(base, injected) {
-	const baseKeys = Object.keys(base);
-	if (baseKeys.length === 0) return injected;
-	const out = { ...injected };
-	for (const key of baseKeys) {
-		const baseValue = base[key];
-		const injectedValue = injected[key];
-		if (isEventHandlerKey(key) && typeof baseValue === "function" && typeof injectedValue === "function") {
-			out[key] = composeHandlers(injectedValue, baseValue);
-			continue;
-		}
-		out[key] = baseValue;
-	}
-	return out;
-}
-//#endregion
-export { mergeProps };
-
-//# sourceMappingURL=merge-props.js.map

package/dist/foundations/utilities/merge-props.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"merge-props.js","names":[],"sources":["../../../src/foundations/utilities/merge-props.ts"],"sourcesContent":["/**\n * mergeProps\n *\n * Deterministic props merging.\n * - For non-handlers: `base` overwrites `injected`.\n * - For handlers present in both: handlers are composed with `injected` running\n *   first; it may call `preventDefault()` to suppress the `base` handler.\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Merge Strategy\n *    Base props overwrite injected props (base wins).\n *    Exception: Event handlers are composed, not overwritten.\n *\n * 2. Event Handler Detection\n *    Keys starting with \"on\" are treated as event handlers.\n *    This matches JSX conventions.\n *\n * 3. Handler Composition Order\n *    Injected handler runs first, base handler second.\n *    This allows injected handlers to prevent default.\n *\n * 4. Return Type\n *    Returns intersection type (TInjected & TBase) for type safety.\n */\nimport { composeHandlers } from './compose-handlers';\n\ntype Fn = (...args: readonly unknown[]) => void;\n\nfunction isEventHandlerKey(key: string): boolean {\n  return key.startsWith('on');\n}\n\nexport function mergeProps<TBase extends object, TInjected extends object>(\n  base: TBase,\n  injected: TInjected\n): TInjected & TBase {\n  // Fast path: if base is empty, return injected as-is\n  const baseKeys = Object.keys(base);\n  if (baseKeys.length === 0) {\n    return injected as TInjected & TBase;\n  }\n\n  const out = { ...(injected as object) } as TInjected & TBase;\n\n  for (const key of baseKeys as Array<Extract<keyof TBase, string>>) {\n    const baseValue = (base as Record<string, unknown>)[key];\n    const injectedValue = (injected as Record<string, unknown>)[key];\n\n    if (\n      isEventHandlerKey(key) &&\n      typeof baseValue === 'function' &&\n      typeof injectedValue === 'function'\n    ) {\n      // Invariant: injected runs first; it may call preventDefault() to\n      // suppress base behaviour.\n      (out as Record<string, unknown>)[key] = composeHandlers(\n        injectedValue as unknown as Fn,\n        baseValue as unknown as Fn\n      );\n      continue;\n    }\n\n    (out as Record<string, unknown>)[key] = baseValue;\n  }\n\n  return out;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAS,kBAAkB,KAAsB;CAC/C,OAAO,IAAI,WAAW,IAAI;AAC5B;AAEA,SAAgB,WACd,MACA,UACmB;CAEnB,MAAM,WAAW,OAAO,KAAK,IAAI;CACjC,IAAI,SAAS,WAAW,GACtB,OAAO;CAGT,MAAM,MAAM,EAAE,GAAI,SAAoB;CAEtC,KAAK,MAAM,OAAO,UAAiD;EACjE,MAAM,YAAa,KAAiC;EACpD,MAAM,gBAAiB,SAAqC;EAE5D,IACE,kBAAkB,GAAG,KACrB,OAAO,cAAc,cACrB,OAAO,kBAAkB,YACzB;GAGA,IAAiC,OAAO,gBACtC,eACA,SACF;GACA;EACF;EAEA,IAAiC,OAAO;CAC1C;CAEA,OAAO;AACT"}

package/dist/foundations/utilities/use-id.d.ts

@@ -1,32 +0,0 @@
-//#region src/foundations/utilities/use-id.d.ts
-interface FormatIdOptions {
-  /** Defaults to 'askr' */
-  prefix?: string;
-  /** Stable, caller-provided identity */
-  id: string | number;
-}
-/**
- * formatId
- *
- * Formats a stable ID from a caller-provided identity.
- * - Pure and deterministic (no time/randomness/global counters)
- * - SSR-safe
- *
- * POLICY DECISIONS (LOCKED):
- *
- * 1. No Auto-Generation
- *    Caller must provide the `id`. No random/sequential generation.
- *    This ensures determinism and SSR safety.
- *
- * 2. Format Convention
- *    IDs are formatted as `{prefix}-{id}`.
- *    Default prefix is "askr".
- *
- * 3. Type Coercion
- *    Numbers are coerced to strings via String().
- *    This is deterministic and consistent.
- */
-declare function formatId(options: FormatIdOptions): string;
-//#endregion
-export { FormatIdOptions, formatId };
-//# sourceMappingURL=use-id.d.ts.map

package/dist/foundations/utilities/use-id.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-id.d.ts","names":[],"sources":["../../../src/foundations/utilities/use-id.ts"],"mappings":";UAAiB,eAAA;EAAA;EAEf,MAAA;;EAEA,EAAE;AAAA;AAwBJ;;;;AAAiD;;;;;;;;;;;;;;;;;AAAjD,iBAAgB,QAAA,CAAS,OAAwB,EAAf,eAAe"}

package/dist/foundations/utilities/use-id.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-id.js","names":[],"sources":["../../../src/foundations/utilities/use-id.ts"],"sourcesContent":["export interface FormatIdOptions {\n  /** Defaults to 'askr' */\n  prefix?: string;\n  /** Stable, caller-provided identity */\n  id: string | number;\n}\n\n/**\n * formatId\n *\n * Formats a stable ID from a caller-provided identity.\n * - Pure and deterministic (no time/randomness/global counters)\n * - SSR-safe\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. No Auto-Generation\n *    Caller must provide the `id`. No random/sequential generation.\n *    This ensures determinism and SSR safety.\n *\n * 2. Format Convention\n *    IDs are formatted as `{prefix}-{id}`.\n *    Default prefix is \"askr\".\n *\n * 3. Type Coercion\n *    Numbers are coerced to strings via String().\n *    This is deterministic and consistent.\n */\nexport function formatId(options: FormatIdOptions): string {\n  const prefix = options.prefix ?? 'askr';\n  return `${prefix}-${String(options.id)}`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AA4BA,SAAgB,SAAS,SAAkC;CAEzD,OAAO,GADQ,QAAQ,UAAU,OAChB,GAAG,OAAO,QAAQ,EAAE;AACvC"}

package/dist/fx/fx.d.ts

@@ -1,33 +0,0 @@
-//#region src/fx/fx.d.ts
-type CancelFn = () => void;
-declare function debounceEvent(ms: number, handler: EventListener, options?: {
-  leading?: boolean;
-  trailing?: boolean;
-}): EventListener & {
-  cancel(): void;
-  flush(): void;
-};
-declare function throttleEvent(ms: number, handler: EventListener, options?: {
-  leading?: boolean;
-  trailing?: boolean;
-}): EventListener & {
-  cancel(): void;
-};
-declare function rafEvent(handler: EventListener): EventListener & {
-  cancel(): void;
-};
-declare function scheduleTimeout(ms: number, fn: () => void): CancelFn;
-declare function scheduleIdle(fn: () => void, options?: {
-  timeout?: number;
-}): CancelFn;
-interface RetryOptions {
-  maxAttempts?: number;
-  delayMs?: number;
-  backoff?: (attemptIndex: number) => number;
-}
-declare function scheduleRetry<T>(fn: () => Promise<T>, options?: RetryOptions): {
-  cancel(): void;
-};
-//#endregion
-export { CancelFn, RetryOptions, debounceEvent, rafEvent, scheduleIdle, scheduleRetry, scheduleTimeout, throttleEvent };
-//# sourceMappingURL=fx.d.ts.map

package/dist/fx/fx.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fx.d.ts","names":[],"sources":["../../src/fx/fx.ts"],"mappings":";KAKY,QAAA;AAAA,iBAwCI,aAAA,CACd,EAAA,UACA,OAAA,EAAS,aAAA,EACT,OAAA;EAAY,OAAA;EAAmB,QAAA;AAAA,IAC9B,aAAa;EAAK,MAAA;EAAgB,KAAA;AAAA;AAAA,iBAsErB,aAAA,CACd,EAAA,UACA,OAAA,EAAS,aAAA,EACT,OAAA;EAAY,OAAA;EAAmB,QAAA;AAAA,IAC9B,aAAa;EAAK,MAAA;AAAA;AAAA,iBA0DL,QAAA,CACd,OAAA,EAAS,aAAA,GACR,aAAa;EAAK,MAAA;AAAA;AAAA,iBAuDL,eAAA,CAAgB,EAAA,UAAY,EAAA,eAAiB,QAAQ;AAAA,iBAuBrD,YAAA,CACd,EAAA,cACA,OAAA;EAAY,OAAA;AAAA,IACX,QAAQ;AAAA,UA0CM,YAAA;EACf,WAAA;EACA,OAAA;EACA,OAAA,IAAW,YAAA;AAAA;AAAA,iBAGG,aAAA,IACd,EAAA,QAAU,OAAA,CAAQ,CAAA,GAClB,OAAA,GAAU,YAAA;EACP,MAAA;AAAA"}

package/dist/fx/fx.js

@@ -1,213 +0,0 @@
-import { logger } from "../common/logger.js";
-import { enqueueRuntimeTask } from "../runtime/access.js";
-import { getCurrentComponentInstance } from "../runtime/component-scope.js";
-import "../runtime/index.js";
-import { noopEventListener, noopEventListenerWithFlush } from "./noop.js";
-//#region src/fx/fx.ts
-function throwIfDuringRender() {
-	if (getCurrentComponentInstance() !== null) throw new Error("[Askr] calling FX handler during render is not allowed. Move calls to event handlers or effects.");
-}
-/**
-* Helper: schedule a user callback through the global scheduler
-*/
-function enqueueUserCallback(fn) {
-	enqueueRuntimeTask(() => {
-		try {
-			fn();
-		} catch (err) {
-			logger.error("[Askr] FX handler error:", err);
-		}
-	});
-}
-function debounceEvent(ms, handler, options) {
-	const { leading = false, trailing = true } = options || {};
-	const inst = getCurrentComponentInstance();
-	if (inst && inst.ssr) return noopEventListenerWithFlush;
-	let timeoutId = null;
-	let lastEvent = null;
-	let lastCallTime = 0;
-	const debounced = function(ev) {
-		throwIfDuringRender();
-		const now = Date.now();
-		lastEvent = ev;
-		if (timeoutId !== null) {
-			clearTimeout(timeoutId);
-			timeoutId = null;
-		}
-		if (leading && now - lastCallTime >= ms) {
-			enqueueUserCallback(() => handler.call(null, ev));
-			lastCallTime = now;
-		}
-		if (trailing) timeoutId = setTimeout(() => {
-			if (lastEvent) enqueueUserCallback(() => handler.call(null, lastEvent));
-			timeoutId = null;
-			lastCallTime = Date.now();
-		}, ms);
-	};
-	debounced.cancel = () => {
-		if (timeoutId !== null) {
-			clearTimeout(timeoutId);
-			timeoutId = null;
-		}
-		lastEvent = null;
-	};
-	debounced.flush = () => {
-		if (timeoutId !== null) {
-			clearTimeout(timeoutId);
-			const ev = lastEvent;
-			lastEvent = null;
-			timeoutId = null;
-			if (ev) enqueueUserCallback(() => handler.call(null, ev));
-		}
-	};
-	if (inst) (inst.cleanupFns ??= []).push(() => {
-		debounced.cancel();
-	});
-	return debounced;
-}
-function throttleEvent(ms, handler, options) {
-	const { leading = true, trailing = true } = options || {};
-	const inst = getCurrentComponentInstance();
-	if (inst && inst.ssr) return noopEventListener;
-	let lastCallTime = 0;
-	let timeoutId = null;
-	let lastEvent = null;
-	const throttled = function(ev) {
-		throwIfDuringRender();
-		const now = Date.now();
-		lastEvent = ev;
-		if (leading && now - lastCallTime >= ms) {
-			enqueueUserCallback(() => handler.call(null, ev));
-			lastCallTime = now;
-			if (timeoutId !== null) {
-				clearTimeout(timeoutId);
-				timeoutId = null;
-			}
-		} else if (!leading && lastCallTime === 0) lastCallTime = now;
-		if (trailing && timeoutId === null) {
-			const wait = ms - (now - lastCallTime);
-			timeoutId = setTimeout(() => {
-				if (lastEvent) enqueueUserCallback(() => handler.call(null, lastEvent));
-				lastCallTime = Date.now();
-				timeoutId = null;
-			}, Math.max(0, wait));
-		}
-	};
-	throttled.cancel = () => {
-		if (timeoutId !== null) {
-			clearTimeout(timeoutId);
-			timeoutId = null;
-		}
-		lastEvent = null;
-	};
-	if (inst) (inst.cleanupFns ??= []).push(() => throttled.cancel());
-	return throttled;
-}
-function rafEvent(handler) {
-	const inst = getCurrentComponentInstance();
-	if (inst && inst.ssr) return noopEventListener;
-	let frameId = null;
-	let lastEvent = null;
-	const scheduleFrame = () => {
-		frameId = (typeof requestAnimationFrame !== "undefined" ? requestAnimationFrame : (cb) => setTimeout(() => cb(Date.now()), 16))(() => {
-			frameId = null;
-			if (lastEvent) {
-				const ev = lastEvent;
-				lastEvent = null;
-				enqueueUserCallback(() => handler.call(null, ev));
-			}
-		});
-	};
-	const fn = function(ev) {
-		throwIfDuringRender();
-		lastEvent = ev;
-		if (frameId === null) scheduleFrame();
-	};
-	fn.cancel = () => {
-		if (frameId !== null) {
-			if (typeof cancelAnimationFrame !== "undefined" && typeof frameId === "number") cancelAnimationFrame(frameId);
-			else clearTimeout(frameId);
-			frameId = null;
-		}
-		lastEvent = null;
-	};
-	if (inst) (inst.cleanupFns ??= []).push(() => fn.cancel());
-	return fn;
-}
-function scheduleTimeout(ms, fn) {
-	throwIfDuringRender();
-	const inst = getCurrentComponentInstance();
-	if (inst && inst.ssr) return () => {};
-	let id = setTimeout(() => {
-		id = null;
-		enqueueUserCallback(fn);
-	}, ms);
-	const cancel = () => {
-		if (id !== null) {
-			clearTimeout(id);
-			id = null;
-		}
-	};
-	if (inst) (inst.cleanupFns ??= []).push(cancel);
-	return cancel;
-}
-function scheduleIdle(fn, options) {
-	throwIfDuringRender();
-	const inst = getCurrentComponentInstance();
-	if (inst && inst.ssr) return () => {};
-	let id = null;
-	let usingRIC = false;
-	if (typeof requestIdleCallback !== "undefined") {
-		usingRIC = true;
-		id = requestIdleCallback(() => {
-			id = null;
-			enqueueUserCallback(fn);
-		}, options);
-	} else id = setTimeout(() => {
-		id = null;
-		enqueueUserCallback(fn);
-	}, 0);
-	const cancel = () => {
-		if (id !== null) {
-			if (usingRIC && typeof cancelIdleCallback !== "undefined" && typeof id === "number") cancelIdleCallback(id);
-			else clearTimeout(id);
-			id = null;
-		}
-	};
-	if (inst) (inst.cleanupFns ??= []).push(cancel);
-	return cancel;
-}
-function scheduleRetry(fn, options) {
-	throwIfDuringRender();
-	const inst = getCurrentComponentInstance();
-	if (inst && inst.ssr) return { cancel: () => {} };
-	const { maxAttempts = 3, delayMs = 100, backoff = (i) => delayMs * Math.pow(2, i) } = options || {};
-	let cancelled = false;
-	const attempt = (index) => {
-		if (cancelled) return;
-		enqueueRuntimeTask(() => {
-			if (cancelled) return;
-			fn().then(() => {}, () => {
-				if (cancelled) return;
-				if (index + 1 < maxAttempts) {
-					const delay = backoff(index);
-					setTimeout(() => {
-						attempt(index + 1);
-					}, delay);
-				}
-			}).catch((e) => {
-				logger.error("[Askr] scheduleRetry error:", e);
-			});
-		});
-	};
-	attempt(0);
-	const cancel = () => {
-		cancelled = true;
-	};
-	if (inst) (inst.cleanupFns ??= []).push(cancel);
-	return { cancel };
-}
-//#endregion
-export { debounceEvent, rafEvent, scheduleIdle, scheduleRetry, scheduleTimeout, throttleEvent };
-
-//# sourceMappingURL=fx.js.map

package/dist/fx/fx.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fx.js","names":[],"sources":["../../src/fx/fx.ts"],"sourcesContent":["import { enqueueRuntimeTask } from '../runtime';\nimport { getCurrentComponentInstance } from '../runtime';\nimport { logger } from '../common/logger';\nimport { noopEventListener, noopEventListenerWithFlush } from './noop';\n\nexport type CancelFn = () => void;\n\n// Platform-specific timer handle types\ntype TimeoutHandle = ReturnType<typeof setTimeout> | null;\n// rAF may fall back to setTimeout in some environments/tests, include both\ntype RafHandle =\n  | ReturnType<typeof requestAnimationFrame>\n  | ReturnType<typeof setTimeout>\n  | null;\n// requestIdleCallback may be unavailable; allow setTimeout fallback handle\ntype IdleHandle =\n  | ReturnType<typeof requestIdleCallback>\n  | ReturnType<typeof setTimeout>\n  | null;\n\nfunction throwIfDuringRender(): void {\n  const inst = getCurrentComponentInstance();\n  if (inst !== null) {\n    throw new Error(\n      '[Askr] calling FX handler during render is not allowed. Move calls to event handlers or effects.'\n    );\n  }\n}\n\n/**\n * Helper: schedule a user callback through the global scheduler\n */\nfunction enqueueUserCallback(fn: () => void) {\n  enqueueRuntimeTask(() => {\n    try {\n      fn();\n    } catch (err) {\n      // Keep behavior consistent with other scheduler-queued work\n      logger.error('[Askr] FX handler error:', err);\n    }\n  });\n}\n\n// ---------- Event handlers ----------\n\nexport function debounceEvent(\n  ms: number,\n  handler: EventListener,\n  options?: { leading?: boolean; trailing?: boolean }\n): EventListener & { cancel(): void; flush(): void } {\n  const { leading = false, trailing = true } = options || {};\n\n  const inst = getCurrentComponentInstance();\n  // On SSR, event handlers are inert\n  if (inst && inst.ssr) {\n    return noopEventListenerWithFlush;\n  }\n\n  let timeoutId: TimeoutHandle = null;\n  let lastEvent: Event | null = null;\n  let lastCallTime = 0;\n\n  const debounced = function (this: unknown, ev: Event) {\n    // Disallow using returned handler during render\n    throwIfDuringRender();\n\n    const now = Date.now();\n    lastEvent = ev;\n\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n\n    if (leading && now - lastCallTime >= ms) {\n      enqueueUserCallback(() => handler.call(null, ev));\n      lastCallTime = now;\n    }\n\n    if (trailing) {\n      timeoutId = setTimeout(() => {\n        // Schedule through scheduler\n        if (lastEvent) {\n          enqueueUserCallback(() => handler.call(null, lastEvent!));\n        }\n        timeoutId = null;\n        lastCallTime = Date.now();\n      }, ms);\n    }\n  } as EventListener & { cancel(): void; flush(): void };\n\n  debounced.cancel = () => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n    lastEvent = null;\n  };\n\n  debounced.flush = () => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      const ev = lastEvent;\n      lastEvent = null;\n      timeoutId = null;\n      if (ev) enqueueUserCallback(() => handler.call(null, ev));\n    }\n  };\n\n  // Auto-cleanup on component unmount\n  if (inst) {\n    (inst.cleanupFns ??= []).push(() => {\n      debounced.cancel();\n    });\n  }\n\n  return debounced;\n}\n\nexport function throttleEvent(\n  ms: number,\n  handler: EventListener,\n  options?: { leading?: boolean; trailing?: boolean }\n): EventListener & { cancel(): void } {\n  const { leading = true, trailing = true } = options || {};\n\n  const inst = getCurrentComponentInstance();\n  if (inst && inst.ssr) {\n    return noopEventListener;\n  }\n\n  let lastCallTime = 0;\n  let timeoutId: TimeoutHandle = null;\n  let lastEvent: Event | null = null;\n\n  const throttled = function (this: unknown, ev: Event) {\n    throwIfDuringRender();\n\n    const now = Date.now();\n    lastEvent = ev;\n\n    if (leading && now - lastCallTime >= ms) {\n      enqueueUserCallback(() => handler.call(null, ev));\n      lastCallTime = now;\n      if (timeoutId !== null) {\n        clearTimeout(timeoutId);\n        timeoutId = null;\n      }\n    } else if (!leading && lastCallTime === 0) {\n      lastCallTime = now;\n    }\n\n    if (trailing && timeoutId === null) {\n      const wait = ms - (now - lastCallTime);\n      timeoutId = setTimeout(\n        () => {\n          if (lastEvent)\n            enqueueUserCallback(() => handler.call(null, lastEvent!));\n          lastCallTime = Date.now();\n          timeoutId = null;\n        },\n        Math.max(0, wait)\n      );\n    }\n  } as EventListener & { cancel(): void };\n\n  throttled.cancel = () => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n    lastEvent = null;\n  };\n\n  if (inst) {\n    (inst.cleanupFns ??= []).push(() => throttled.cancel());\n  }\n\n  return throttled;\n}\n\nexport function rafEvent(\n  handler: EventListener\n): EventListener & { cancel(): void } {\n  const inst = getCurrentComponentInstance();\n  if (inst && inst.ssr) {\n    return noopEventListener;\n  }\n\n  let frameId: RafHandle = null;\n  let lastEvent: Event | null = null;\n\n  const scheduleFrame = () => {\n    const rAF =\n      typeof requestAnimationFrame !== 'undefined'\n        ? requestAnimationFrame\n        : (cb: FrameRequestCallback) => setTimeout(() => cb(Date.now()), 16);\n\n    frameId = rAF(() => {\n      frameId = null;\n      if (lastEvent) {\n        const ev = lastEvent;\n        lastEvent = null;\n        enqueueUserCallback(() => handler.call(null, ev));\n      }\n    });\n  };\n\n  const fn = function (this: unknown, ev: Event) {\n    throwIfDuringRender();\n    lastEvent = ev;\n    if (frameId === null) scheduleFrame();\n  } as EventListener & { cancel(): void };\n\n  fn.cancel = () => {\n    if (frameId !== null) {\n      // If frameId is numeric and cancelAnimationFrame is available, use it;\n      // otherwise fall back to clearTimeout for the setTimeout fallback.\n      if (\n        typeof cancelAnimationFrame !== 'undefined' &&\n        typeof frameId === 'number'\n      ) {\n        cancelAnimationFrame(frameId);\n      } else {\n        clearTimeout(frameId as ReturnType<typeof setTimeout>);\n      }\n      frameId = null;\n    }\n    lastEvent = null;\n  };\n\n  if (inst) (inst.cleanupFns ??= []).push(() => fn.cancel());\n\n  return fn;\n}\n\n// ---------- Scheduled work ----------\n\nexport function scheduleTimeout(ms: number, fn: () => void): CancelFn {\n  throwIfDuringRender();\n  const inst = getCurrentComponentInstance();\n  if (inst && inst.ssr) {\n    return () => {};\n  }\n\n  let id: TimeoutHandle = setTimeout(() => {\n    id = null;\n    enqueueUserCallback(fn);\n  }, ms);\n\n  const cancel = () => {\n    if (id !== null) {\n      clearTimeout(id);\n      id = null;\n    }\n  };\n\n  if (inst) (inst.cleanupFns ??= []).push(cancel);\n  return cancel;\n}\n\nexport function scheduleIdle(\n  fn: () => void,\n  options?: { timeout?: number }\n): CancelFn {\n  throwIfDuringRender();\n  const inst = getCurrentComponentInstance();\n  if (inst && inst.ssr) return () => {};\n\n  let id: IdleHandle = null;\n  let usingRIC = false;\n\n  if (typeof requestIdleCallback !== 'undefined') {\n    usingRIC = true;\n    id = requestIdleCallback(() => {\n      id = null;\n      enqueueUserCallback(fn);\n    }, options);\n  } else {\n    // Fallback: schedule on next macrotask\n    id = setTimeout(() => {\n      id = null;\n      enqueueUserCallback(fn);\n    }, 0);\n  }\n\n  const cancel = () => {\n    if (id !== null) {\n      // If using requestIdleCallback and available, call cancelIdleCallback for numeric ids.\n      if (\n        usingRIC &&\n        typeof cancelIdleCallback !== 'undefined' &&\n        typeof id === 'number'\n      ) {\n        cancelIdleCallback(id);\n      } else {\n        clearTimeout(id as ReturnType<typeof setTimeout>);\n      }\n      id = null;\n    }\n  };\n\n  if (inst) (inst.cleanupFns ??= []).push(cancel);\n  return cancel;\n}\n\nexport interface RetryOptions {\n  maxAttempts?: number;\n  delayMs?: number;\n  backoff?: (attemptIndex: number) => number;\n}\n\nexport function scheduleRetry<T>(\n  fn: () => Promise<T>,\n  options?: RetryOptions\n): { cancel(): void } {\n  throwIfDuringRender();\n  const inst = getCurrentComponentInstance();\n  if (inst && inst.ssr) return { cancel: () => {} };\n\n  const {\n    maxAttempts = 3,\n    delayMs = 100,\n    backoff = (i: number) => delayMs * Math.pow(2, i),\n  } = options || {};\n\n  let cancelled = false;\n\n  const attempt = (index: number) => {\n    if (cancelled) return;\n    // Run user fn inside scheduler\n    enqueueRuntimeTask(() => {\n      if (cancelled) return;\n      // Call fn (it may be async)\n      const p = fn();\n      p.then(\n        () => {\n          // Completed successfully\n        },\n        () => {\n          if (cancelled) return;\n          if (index + 1 < maxAttempts) {\n            const delay = backoff(index);\n            // Schedule next attempt via setTimeout so it gets enqueued through scheduleTimeout\n            setTimeout(() => {\n              attempt(index + 1);\n            }, delay);\n          }\n        }\n      ).catch((e) => {\n        logger.error('[Askr] scheduleRetry error:', e);\n      });\n    });\n  };\n\n  // Start first attempt\n  attempt(0);\n\n  const cancel = () => {\n    cancelled = true;\n  };\n\n  if (inst) (inst.cleanupFns ??= []).push(cancel);\n  return { cancel };\n}\n"],"mappings":"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"}

package/dist/fx/noop.js

@@ -1,9 +0,0 @@
-const noopEventListener = Object.assign((_ev) => {}, { cancel() {} });
-const noopEventListenerWithFlush = Object.assign((_ev) => {}, {
-	cancel() {},
-	flush() {}
-});
-//#endregion
-export { noopEventListener, noopEventListenerWithFlush };
-
-//# sourceMappingURL=noop.js.map

package/dist/fx/noop.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"noop.js","names":[],"sources":["../../src/fx/noop.ts"],"sourcesContent":["// Lightweight shared no-op helpers to avoid double-casts and duplicated definitions\n\nexport const noop: () => void = () => {};\n\nexport const noopEventListener: EventListener & { cancel(): void } =\n  Object.assign((_ev?: Event) => {}, { cancel() {} });\n\nexport const noopEventListenerWithFlush: EventListener & {\n  cancel(): void;\n  flush(): void;\n} = Object.assign((_ev?: Event) => {}, { cancel() {}, flush() {} });\n\nexport const noopCancel: { cancel(): void } = { cancel() {} };\n"],"mappings":"AAIA,MAAa,oBACX,OAAO,QAAQ,QAAgB,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC;AAEpD,MAAa,6BAGT,OAAO,QAAQ,QAAgB,CAAC,GAAG;CAAE,SAAS,CAAC;CAAG,QAAQ,CAAC;AAAE,CAAC"}

package/dist/fx/timing.d.ts

@@ -1,159 +0,0 @@
-//#region src/fx/timing.d.ts
-/**
- * Timing utilities — pure helpers for common async patterns
- * No framework coupling. No lifecycle awareness.
- */
-interface DebounceOptions {
-  leading?: boolean;
-  trailing?: boolean;
-}
-interface ThrottleOptions {
-  leading?: boolean;
-  trailing?: boolean;
-}
-interface RetryOptions {
-  maxAttempts?: number;
-  delayMs?: number;
-  backoff?: (attemptIndex: number) => number;
-}
-type AnyFn = (...args: never[]) => unknown;
-/**
- * Debounce — delay execution, coalesce rapid calls
- *
- * Useful for: text input, resize, autosave
- *
- * @param fn Function to debounce
- * @param ms Delay in milliseconds
- * @param options trailing (default true), leading
- * @returns Debounced function with cancel() method
- *
- * @example
- * ```ts
- * const save = debounce((text) => api.save(text), 500);
- * input.addEventListener('input', (e) => save(e.target.value));
- * save.cancel(); // stop any pending execution
- * ```
- */
-declare function debounce<T extends AnyFn>(fn: T, ms: number, options?: DebounceOptions): T & {
-  cancel(): void;
-};
-/**
- * Throttle — rate-limit execution, keep first/last
- *
- * Useful for: scroll, mouse move, high-frequency events
- *
- * @param fn Function to throttle
- * @param ms Minimum interval between calls in milliseconds
- * @param options leading (default true), trailing (default true)
- * @returns Throttled function with cancel() method
- *
- * @example
- * ```ts
- * const handleScroll = throttle(updateUI, 100);
- * window.addEventListener('scroll', handleScroll);
- * handleScroll.cancel();
- * ```
- */
-declare function throttle<T extends AnyFn>(fn: T, ms: number, options?: ThrottleOptions): T & {
-  cancel(): void;
-};
-/**
- * Once — guard against double execution
- *
- * Useful for: init logic, event safety
- *
- * @param fn Function to call at most once
- * @returns Function that executes fn only on first call
- *
- * @example
- * ```ts
- * const init = once(setup);
- * init(); // runs
- * init(); // does nothing
- * init(); // does nothing
- * ```
- */
-declare function once<T extends AnyFn>(fn: T): T;
-/**
- * Defer — schedule on microtask queue
- *
- * Useful for: run-after-current-stack logic
- * More reliable than setTimeout(..., 0)
- *
- * @param fn Function to defer
- *
- * @example
- * ```ts
- * defer(() => update()); // runs after current stack, before next macrotask
- * ```
- */
-declare function defer(fn: () => void): void;
-/**
- * RAF — coalesce multiple updates into single frame
- *
- * Useful for: animation, layout work, render updates
- *
- * @param fn Function to schedule on next animation frame
- * @returns Function that schedules fn on requestAnimationFrame
- *
- * @example
- * ```ts
- * const update = raf(render);
- * update(); // schedules on next frame
- * update(); // same frame, no duplicate
- * ```
- */
-declare function raf<T extends AnyFn>(fn: T): T;
-/**
- * Idle — schedule low-priority work
- *
- * Useful for: background prep, non-urgent updates
- * Falls back to setTimeout if requestIdleCallback unavailable
- *
- * @param fn Function to call when idle
- * @param options timeout for fallback
- *
- * @example
- * ```ts
- * idle(() => prefetchData());
- * ```
- */
-declare function idle(fn: () => void, options?: {
-  timeout?: number;
-}): void;
-/**
- * Timeout — Promise-based delay
- *
- * Useful for: readable async code, waiting between retries
- *
- * @param ms Milliseconds to wait
- * @returns Promise that resolves after delay
- *
- * @example
- * ```ts
- * await timeout(300);
- * console.log('300ms later');
- * ```
- */
-declare function timeout(ms: number): Promise<void>;
-/**
- * Retry — attempt function with backoff
- *
- * Useful for: network calls, transient failures
- *
- * @param fn Async function to retry
- * @param options maxAttempts, delayMs, backoff function
- * @returns Promise with final result or error
- *
- * @example
- * ```ts
- * const data = await retry(() => fetch(url), {
- *   maxAttempts: 3,
- *   delayMs: 100,
- * });
- * ```
- */
-declare function retry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
-//#endregion
-export { DebounceOptions, RetryOptions, ThrottleOptions, debounce, defer, idle, once, raf, retry, throttle, timeout };
-//# sourceMappingURL=timing.d.ts.map

package/dist/fx/timing.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"timing.d.ts","names":[],"sources":["../../src/fx/timing.ts"],"mappings":";;AAKA;;;UAAiB,eAAA;EACf,OAAA;EACA,QAAQ;AAAA;AAAA,UAGO,eAAA;EACf,OAAA;EACA,QAAQ;AAAA;AAAA,UAGO,YAAA;EACf,WAAA;EACA,OAAA;EACA,OAAA,IAAW,YAAA;AAAA;AAAA,KAGR,KAAA,OAAY,IAAI;;;AAHY;AAChC;;;;AAEoB;AAoBrB;;;;;;;;;iBAAgB,QAAA,WAAmB,KAAA,EACjC,EAAA,EAAI,CAAA,EACJ,EAAA,UACA,OAAA,GAAU,eAAA,GACT,CAAA;EAAM,MAAA;AAAA;;;;;;;;AAAM;AA2Df;;;;;;;;;iBAAgB,QAAA,WAAmB,KAAA,EACjC,EAAA,EAAI,CAAA,EACJ,EAAA,UACA,OAAA,GAAU,eAAA,GACT,CAAA;EAAM,MAAA;AAAA;;;;;;;;AAAM;AAsEf;;;;;;;;iBAAgB,IAAA,WAAe,KAAA,EAAO,EAAA,EAAI,CAAA,GAAI,CAAA;;;;;;AAAC;AA2B/C;;;;AAAoC;AAmBpC;;iBAnBgB,KAAA,CAAM,EAAc;;;;;;;;;;;;AAmBU;AAkC9C;;;iBAlCgB,GAAA,WAAc,KAAA,EAAO,EAAA,EAAI,CAAA,GAAI,CAAA;;;;;AAkCsB;AAyBnE;;;;AAA4C;AAqB5C;;;;iBA9CgB,IAAA,CAAK,EAAA,cAAgB,OAAA;EAAY,OAAA;AAAA;;;;;;;;;;;;;AAiDrC;;iBAxBI,OAAA,CAAQ,EAAA,WAAa,OAAO;;;;;;;;;;;;;;;;;;iBAqBtB,KAAA,IACpB,EAAA,QAAU,OAAA,CAAQ,CAAA,GAClB,OAAA,GAAU,YAAA,GACT,OAAA,CAAQ,CAAA"}