@askrjs/askr 0.0.27 → 0.0.29

package/dist/foundations/utilities/aria.js

@@ -1 +1,11 @@
-function a(r){return r?{"aria-disabled":"true"}:{}}function i(r){return r===void 0?{}:{"aria-expanded":String(r)}}function n(r){return r===void 0?{}:{"aria-selected":String(r)}}export{a as ariaDisabled,i as ariaExpanded,n as ariaSelected};
+//#region src/foundations/utilities/aria.ts
+/**
+* Tiny aria helpers
+*/
+function ariaDisabled(disabled) {
+	return disabled ? { "aria-disabled": "true" } : {};
+}
+//#endregion
+export { ariaDisabled };
+
+//# sourceMappingURL=aria.js.map

package/dist/foundations/utilities/aria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria.js","names":[],"sources":["../../../src/foundations/utilities/aria.ts"],"sourcesContent":["/**\n * Tiny aria helpers\n */\n\nexport function ariaDisabled(disabled?: boolean): { 'aria-disabled'?: 'true' } {\n  return disabled ? { 'aria-disabled': 'true' } : {};\n}\n\nexport function ariaExpanded(expanded?: boolean): {\n  'aria-expanded'?: 'true' | 'false';\n} {\n  return expanded === undefined\n    ? {}\n    : { 'aria-expanded': String(expanded) as 'true' | 'false' };\n}\n\nexport function ariaSelected(selected?: boolean): {\n  'aria-selected'?: 'true' | 'false';\n} {\n  return selected === undefined\n    ? {}\n    : { 'aria-selected': String(selected) as 'true' | 'false' };\n}\n"],"mappings":";;;;AAIA,SAAgB,aAAa,UAAkD;AAC7E,QAAO,WAAW,EAAE,iBAAiB,QAAQ,GAAG,EAAE"}

package/dist/foundations/utilities/compose-handlers.js

@@ -1 +1,20 @@
-function f(e){return typeof e=="object"&&e!==null&&"defaultPrevented"in e&&e.defaultPrevented===!0}function i(e,t,r){if(!e&&!t)return o;if(!e)return t;if(!t)return e;const u=r?.checkDefaultPrevented!==!1;return function(...n){e(...n),!(u&&f(n[0]))&&t(...n)}}function o(){}export{i as composeHandlers};
+//#region src/foundations/utilities/compose-handlers.ts
+function isDefaultPrevented(value) {
+	return typeof value === "object" && value !== null && "defaultPrevented" in value && value.defaultPrevented === true;
+}
+function composeHandlers(first, second, options) {
+	if (!first && !second) return noop;
+	if (!first) return second;
+	if (!second) return first;
+	const checkDefaultPrevented = options?.checkDefaultPrevented !== false;
+	return function composed(...args) {
+		first(...args);
+		if (checkDefaultPrevented && isDefaultPrevented(args[0])) return;
+		second(...args);
+	};
+}
+function noop() {}
+//#endregion
+export { composeHandlers };
+
+//# sourceMappingURL=compose-handlers.js.map

package/dist/foundations/utilities/compose-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-handlers.js","names":[],"sources":["../../../src/foundations/utilities/compose-handlers.ts"],"sourcesContent":["/**\n * composeHandlers\n *\n * Compose two event handlers into one. The first handler runs, and unless it\n * calls `event.preventDefault()` (or sets `defaultPrevented`), the second\n * handler runs. This prevents accidental clobbering of child handlers when\n * injecting props.\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Execution Order\n *    First handler runs before second (injected before base).\n *    This allows injected handlers to prevent default behavior.\n *\n * 2. Default Prevention Check\n *    By default, checks `defaultPrevented` on first argument.\n *    Can be disabled via options.checkDefaultPrevented = false.\n *\n * 3. Undefined Handler Support\n *    Undefined handlers are skipped (no-op). This simplifies usage\n *    where handlers are optional.\n *\n * 4. Type Safety\n *    Args are readonly to prevent mutation. Return type matches input.\n */\n\nexport interface ComposeHandlersOptions {\n  /**\n   * When true (default), do not run the second handler if the first prevented default.\n   * When false, always run both handlers.\n   */\n  checkDefaultPrevented?: boolean;\n}\n\nfunction isDefaultPrevented(\n  value: unknown\n): value is { defaultPrevented: true } {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'defaultPrevented' in value &&\n    (value as { defaultPrevented?: boolean }).defaultPrevented === true\n  );\n}\n\nexport function composeHandlers<A extends readonly unknown[]>(\n  first?: (...args: A) => void,\n  second?: (...args: A) => void,\n  options?: ComposeHandlersOptions\n): (...args: A) => void {\n  // Fast path: if neither handler exists, return stable no-op\n  if (!first && !second) {\n    return noop as (...args: A) => void;\n  }\n\n  // Fast path: if only one handler exists, return it directly\n  if (!first) return second!;\n  if (!second) return first;\n\n  // Composition path: both handlers exist\n  const checkDefaultPrevented = options?.checkDefaultPrevented !== false;\n\n  return function composed(...args: A) {\n    first(...args);\n\n    if (checkDefaultPrevented && isDefaultPrevented(args[0])) {\n      return;\n    }\n\n    second(...args);\n  } as (...args: A) => void;\n}\n\n// Stable no-op for fast path\nfunction noop() {}\n"],"mappings":";AAkCA,SAAS,mBACP,OACqC;AACrC,QACE,OAAO,UAAU,YACjB,UAAU,QACV,sBAAsB,SACrB,MAAyC,qBAAqB;;AAInE,SAAgB,gBACd,OACA,QACA,SACsB;AAEtB,KAAI,CAAC,SAAS,CAAC,OACb,QAAO;AAIT,KAAI,CAAC,MAAO,QAAO;AACnB,KAAI,CAAC,OAAQ,QAAO;CAGpB,MAAM,wBAAwB,SAAS,0BAA0B;AAEjE,QAAO,SAAS,SAAS,GAAG,MAAS;AACnC,QAAM,GAAG,KAAK;AAEd,MAAI,yBAAyB,mBAAmB,KAAK,GAAG,CACtD;AAGF,SAAO,GAAG,KAAK;;;AAKnB,SAAS,OAAO"}

package/dist/foundations/utilities/compose-ref.d.ts

@@ -1,3 +1,4 @@
+//#region src/foundations/utilities/compose-ref.d.ts
 /**
  * Ref composition utilities
  *
@@ -16,9 +17,11 @@
  *    composeRefs applies refs in array order (left to right).
  *    All refs are called even if one fails.
  */
-export type Ref<T> = ((value: T | null) => void) | {
-    current: T | null;
+type Ref<T> = ((value: T | null) => void) | {
+  current: T | null;
 } | null | undefined;
-export declare function setRef<T>(ref: Ref<T>, value: T | null): void;
-export declare function composeRefs<T>(...refs: Array<Ref<T>>): (value: T | null) => void;
+declare function setRef<T>(ref: Ref<T>, value: T | null): void;
+declare function composeRefs<T>(...refs: Array<Ref<T>>): (value: T | null) => void;
+//#endregion
+export { Ref };
 //# sourceMappingURL=compose-ref.d.ts.map

package/dist/foundations/utilities/compose-ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compose-ref.d.ts","sourceRoot":"","sources":["../../../src/foundations/utilities/compose-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,GAAG,CAAC,CAAC,IACb,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC,GAC3B;IAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAA;CAAE,GACrB,IAAI,GACJ,SAAS,CAAC;AAEd,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,CAU5D;AAED,wBAAgB,WAAW,CAAC,CAAC,EAC3B,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GACrB,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAI3B"}
+{"version":3,"file":"compose-ref.d.ts","names":[],"sources":["../../../src/foundations/utilities/compose-ref.ts"],"mappings":";;AAmBA;;;;;;;;;;;AAMA;;;;;;KANY,GAAA,QACN,KAAA,EAAO,CAAA;EACP,OAAA,EAAS,CAAA;AAAA;AAAA,iBAIC,MAAA,GAAA,CAAU,GAAA,EAAK,GAAA,CAAI,CAAA,GAAI,KAAA,EAAO,CAAA;AAAA,iBAY9B,WAAA,GAAA,CAAA,GACX,IAAA,EAAM,KAAA,CAAM,GAAA,CAAI,CAAA,MACjB,KAAA,EAAO,CAAA"}

package/dist/foundations/utilities/compose-ref.js

@@ -1 +1,18 @@
-function e(t,n){if(t){if(typeof t=="function"){t(n);return}Object.isExtensible(t)&&(t.current=n)}}function f(...t){return n=>{for(const o of t)e(o,n)}}export{f as composeRefs,e as setRef};
+//#region src/foundations/utilities/compose-ref.ts
+function setRef(ref, value) {
+	if (!ref) return;
+	if (typeof ref === "function") {
+		ref(value);
+		return;
+	}
+	if (Object.isExtensible(ref)) ref.current = value;
+}
+function composeRefs(...refs) {
+	return (value) => {
+		for (const ref of refs) setRef(ref, value);
+	};
+}
+//#endregion
+export { composeRefs };
+
+//# sourceMappingURL=compose-ref.js.map

package/dist/foundations/utilities/compose-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-ref.js","names":[],"sources":["../../../src/foundations/utilities/compose-ref.ts"],"sourcesContent":["/**\n * Ref composition utilities\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Ref Types Supported\n *    - Callback refs: (value: T | null) => void\n *    - Object refs: { current: T | null }\n *    - null/undefined (no-op)\n *\n * 2. Write Failure Handling\n *    setRef catches write failures (readonly refs) and ignores them.\n *    This is intentional — refs may be readonly in some contexts.\n *\n * 3. Composition Order\n *    composeRefs applies refs in array order (left to right).\n *    All refs are called even if one fails.\n */\n\nexport type Ref<T> =\n  | ((value: T | null) => void)\n  | { current: T | null }\n  | null\n  | undefined;\n\nexport function setRef<T>(ref: Ref<T>, value: T | null): void {\n  if (!ref) return;\n  if (typeof ref === 'function') {\n    ref(value);\n    return;\n  }\n  // Fast path: use Object.isExtensible check instead of try/catch for better performance\n  if (Object.isExtensible(ref)) {\n    (ref as { current: T | null }).current = value;\n  }\n}\n\nexport function composeRefs<T>(\n  ...refs: Array<Ref<T>>\n): (value: T | null) => void {\n  return (value: T | null) => {\n    for (const ref of refs) setRef(ref, value);\n  };\n}\n"],"mappings":";AAyBA,SAAgB,OAAU,KAAa,OAAuB;AAC5D,KAAI,CAAC,IAAK;AACV,KAAI,OAAO,QAAQ,YAAY;AAC7B,MAAI,MAAM;AACV;;AAGF,KAAI,OAAO,aAAa,IAAI,CACzB,KAA8B,UAAU;;AAI7C,SAAgB,YACd,GAAG,MACwB;AAC3B,SAAQ,UAAoB;AAC1B,OAAK,MAAM,OAAO,KAAM,QAAO,KAAK,MAAM"}

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

@@ -1 +1,49 @@
-import{composeHandlers as f}from"./compose-handlers.js";function u(n){return n.startsWith("on")}function a(n,o){const s=Object.keys(n);if(s.length===0)return o;const e={...o};for(const t of s){const r=n[t],c=o[t];if(u(t)&&typeof r=="function"&&typeof c=="function"){e[t]=f(c,r);continue}e[t]=r}return e}export{a as mergeProps};
+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

@@ -0,0 +1 @@
+{"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;AAC/C,QAAO,IAAI,WAAW,KAAK;;AAG7B,SAAgB,WACd,MACA,UACmB;CAEnB,MAAM,WAAW,OAAO,KAAK,KAAK;AAClC,KAAI,SAAS,WAAW,EACtB,QAAO;CAGT,MAAM,MAAM,EAAE,GAAI,UAAqB;AAEvC,MAAK,MAAM,OAAO,UAAiD;EACjE,MAAM,YAAa,KAAiC;EACpD,MAAM,gBAAiB,SAAqC;AAE5D,MACE,kBAAkB,IAAI,IACtB,OAAO,cAAc,cACrB,OAAO,kBAAkB,YACzB;AAGC,OAAgC,OAAO,gBACtC,eACA,UACD;AACD;;AAGD,MAAgC,OAAO;;AAG1C,QAAO"}

package/dist/fx/fx.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"fx.d.ts","sourceRoot":"","sources":["../../src/fx/fx.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC;AAwClC,wBAAgB,aAAa,CAC3B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAClD,aAAa,GAAG;IAAE,MAAM,IAAI,IAAI,CAAC;IAAC,KAAK,IAAI,IAAI,CAAA;CAAE,CAoEnD;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAClD,aAAa,GAAG;IAAE,MAAM,IAAI,IAAI,CAAA;CAAE,CAwDpC;AAED,wBAAgB,QAAQ,CACtB,OAAO,EAAE,aAAa,GACrB,aAAa,GAAG;IAAE,MAAM,IAAI,IAAI,CAAA;CAAE,CAmDpC;AAID,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,QAAQ,CAqBpE;AAED,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,IAAI,EACd,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,QAAQ,CAwCV;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C;AAED,wBAAgB,aAAa,CAAC,CAAC,EAC7B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,YAAY,GACrB;IAAE,MAAM,IAAI,IAAI,CAAA;CAAE,CAiDpB"}
+{"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;EAAkB,MAAA;EAAgB,KAAA;AAAA;AAAA,iBAsErB,aAAA,CACd,EAAA,UACA,OAAA,EAAS,aAAA,EACT,OAAA;EAAY,OAAA;EAAmB,QAAA;AAAA,IAC9B,aAAA;EAAkB,MAAA;AAAA;AAAA,iBA0DL,QAAA,CACd,OAAA,EAAS,aAAA,GACR,aAAA;EAAkB,MAAA;AAAA;AAAA,iBAuDL,eAAA,CAAgB,EAAA,UAAY,EAAA,eAAiB,QAAA;AAAA,iBAuB7C,YAAA,CACd,EAAA,cACA,OAAA;EAAY,OAAA;AAAA,IACX,QAAA;AAAA,UA0Cc,YAAA;EACf,WAAA;EACA,OAAA;EACA,OAAA,IAAW,YAAA;AAAA;AAAA,iBAGG,aAAA,GAAA,CACd,EAAA,QAAU,OAAA,CAAQ,CAAA,GAClB,OAAA,GAAU,YAAA;EACP,MAAA;AAAA"}

package/dist/fx/fx.js

@@ -1 +1,212 @@
-import{globalScheduler as h}from"../runtime/scheduler.js";import{getCurrentComponentInstance as d}from"../runtime/component.js";import{logger as T}from"../dev/logger.js";import{noopEventListenerWithFlush as g,noopEventListener as F}from"./noop.js";function p(){if(d()!==null)throw new Error("[Askr] calling FX handler during render is not allowed. Move calls to event handlers or effects.")}function m(c){h.enqueue(()=>{try{c()}catch(u){T.error("[Askr] FX handler error:",u)}})}function A(c,u,e){const{leading:n=!1,trailing:o=!0}=e||{},r=d();if(r&&r.ssr)return g;let l=null,t=null,s=0;const i=function(f){p();const a=Date.now();t=f,l!==null&&(clearTimeout(l),l=null),n&&a-s>=c&&(m(()=>u.call(null,f)),s=a),o&&(l=setTimeout(()=>{t&&m(()=>u.call(null,t)),l=null,s=Date.now()},c))};return i.cancel=()=>{l!==null&&(clearTimeout(l),l=null),t=null},i.flush=()=>{if(l!==null){clearTimeout(l);const f=t;t=null,l=null,f&&m(()=>u.call(null,f))}},r&&r.cleanupFns.push(()=>{i.cancel()}),i}function C(c,u,e){const{leading:n=!0,trailing:o=!0}=e||{},r=d();if(r&&r.ssr)return F;let l=0,t=null,s=null;const i=function(f){p();const a=Date.now();if(s=f,n&&a-l>=c?(m(()=>u.call(null,f)),l=a,t!==null&&(clearTimeout(t),t=null)):!n&&l===0&&(l=a),o&&t===null){const w=c-(a-l);t=setTimeout(()=>{s&&m(()=>u.call(null,s)),l=Date.now(),t=null},Math.max(0,w))}};return i.cancel=()=>{t!==null&&(clearTimeout(t),t=null),s=null},r&&r.cleanupFns.push(()=>i.cancel()),i}function k(c){const u=d();if(u&&u.ssr)return F;let e=null,n=null;const o=()=>{e=(typeof requestAnimationFrame<"u"?requestAnimationFrame:t=>setTimeout(()=>t(Date.now()),16))(()=>{if(e=null,n){const t=n;n=null,m(()=>c.call(null,t))}})},r=function(l){p(),n=l,e===null&&o()};return r.cancel=()=>{e!==null&&(typeof cancelAnimationFrame<"u"&&typeof e=="number"?cancelAnimationFrame(e):clearTimeout(e),e=null),n=null},u&&u.cleanupFns.push(()=>r.cancel()),r}function E(c,u){p();const e=d();if(e&&e.ssr)return()=>{};let n=setTimeout(()=>{n=null,m(u)},c);const o=()=>{n!==null&&(clearTimeout(n),n=null)};return e&&e.cleanupFns.push(o),o}function q(c,u){p();const e=d();if(e&&e.ssr)return()=>{};let n=null,o=!1;typeof requestIdleCallback<"u"?(o=!0,n=requestIdleCallback(()=>{n=null,m(c)},u)):n=setTimeout(()=>{n=null,m(c)},0);const r=()=>{n!==null&&(o&&typeof cancelIdleCallback<"u"&&typeof n=="number"?cancelIdleCallback(n):clearTimeout(n),n=null)};return e&&e.cleanupFns.push(r),r}function D(c,u){p();const e=d();if(e&&e.ssr)return{cancel:()=>{}};const{maxAttempts:n=3,delayMs:o=100,backoff:r=i=>o*Math.pow(2,i)}=u||{};let l=!1;const t=i=>{l||h.enqueue(()=>{if(l)return;c().then(()=>{},()=>{if(!l&&i+1<n){const a=r(i);setTimeout(()=>{t(i+1)},a)}}).catch(a=>{T.error("[Askr] scheduleRetry error:",a)})})};t(0);const s=()=>{l=!0};return e&&e.cleanupFns.push(s),{cancel:s}}export{A as debounceEvent,k as rafEvent,q as scheduleIdle,D as scheduleRetry,E as scheduleTimeout,C as throttleEvent};
+import { logger } from "../dev/logger.js";
+import { globalScheduler } from "../runtime/scheduler.js";
+import { getCurrentComponentInstance } from "../runtime/component.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) {
+	globalScheduler.enqueue(() => {
+		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;
+		globalScheduler.enqueue(() => {
+			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

@@ -0,0 +1 @@
+{"version":3,"file":"fx.js","names":[],"sources":["../../src/fx/fx.ts"],"sourcesContent":["import { globalScheduler } from '../runtime/scheduler';\nimport { getCurrentComponentInstance } from '../runtime/component';\nimport { logger } from '../dev/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  globalScheduler.enqueue(() => {\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    globalScheduler.enqueue(() => {\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/index.d.ts

@@ -1,7 +1,4 @@
-/**
- * Standard library — pure helpers for common patterns
- * Zero framework coupling
- */
-export { debounce, throttle, once, defer, raf, idle, timeout, retry, type DebounceOptions, type ThrottleOptions, type RetryOptions, } from './timing';
-export { debounceEvent, throttleEvent, rafEvent, scheduleTimeout, scheduleIdle, scheduleRetry, } from './fx';
-//# sourceMappingURL=index.d.ts.map
+import { scheduleEventHandler } from "../runtime/scheduler.js";
+import { DebounceOptions, RetryOptions, ThrottleOptions, debounce, defer, idle, once, raf, retry, throttle, timeout } from "./timing.js";
+import { debounceEvent, rafEvent, scheduleIdle, scheduleRetry, scheduleTimeout, throttleEvent } from "./fx.js";
+export { type DebounceOptions, type RetryOptions, type ThrottleOptions, debounce, debounceEvent, defer, idle, once, raf, rafEvent, retry, scheduleEventHandler, scheduleIdle, scheduleRetry, scheduleTimeout, throttle, throttleEvent, timeout };

package/dist/fx/index.js

@@ -1 +1,4 @@
-import{debounce as r,defer as o,idle as d,once as l,raf as u,retry as c,throttle as n,timeout as f}from"./timing.js";import{debounceEvent as m,rafEvent as i,scheduleIdle as s,scheduleRetry as v,scheduleTimeout as E,throttleEvent as a}from"./fx.js";export{r as debounce,m as debounceEvent,o as defer,d as idle,l as once,u as raf,i as rafEvent,c as retry,s as scheduleIdle,v as scheduleRetry,E as scheduleTimeout,n as throttle,a as throttleEvent,f as timeout};
+import { scheduleEventHandler } from "../runtime/scheduler.js";
+import { debounce, defer, idle, once, raf, retry, throttle, timeout } from "./timing.js";
+import { debounceEvent, rafEvent, scheduleIdle, scheduleRetry, scheduleTimeout, throttleEvent } from "./fx.js";
+export { debounce, debounceEvent, defer, idle, once, raf, rafEvent, retry, scheduleEventHandler, scheduleIdle, scheduleRetry, scheduleTimeout, throttle, throttleEvent, timeout };

package/dist/fx/noop.js

@@ -1 +1,9 @@
-const e=()=>{},c=Object.assign(n=>{},{cancel(){}}),o=Object.assign(n=>{},{cancel(){},flush(){}}),s={cancel(){}};export{e as noop,s as noopCancel,c as noopEventListener,o as noopEventListenerWithFlush};
+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

@@ -0,0 +1 @@
+{"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,IAAI,EAAE,SAAS,IAAI,CAAC;AAErD,MAAa,6BAGT,OAAO,QAAQ,QAAgB,IAAI;CAAE,SAAS;CAAI,QAAQ;CAAI,CAAC"}

package/dist/fx/timing.d.ts

@@ -1,19 +1,20 @@
+//#region src/fx/timing.d.ts
 /**
  * Timing utilities — pure helpers for common async patterns
  * No framework coupling. No lifecycle awareness.
  */
-export interface DebounceOptions {
-    leading?: boolean;
-    trailing?: boolean;
+interface DebounceOptions {
+  leading?: boolean;
+  trailing?: boolean;
 }
-export interface ThrottleOptions {
-    leading?: boolean;
-    trailing?: boolean;
+interface ThrottleOptions {
+  leading?: boolean;
+  trailing?: boolean;
 }
-export interface RetryOptions {
-    maxAttempts?: number;
-    delayMs?: number;
-    backoff?: (attemptIndex: number) => number;
+interface RetryOptions {
+  maxAttempts?: number;
+  delayMs?: number;
+  backoff?: (attemptIndex: number) => number;
 }
 /**
  * Debounce — delay execution, coalesce rapid calls
@@ -32,8 +33,8 @@ export interface RetryOptions {
  * save.cancel(); // stop any pending execution
  * ```
  */
-export declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, ms: number, options?: DebounceOptions): T & {
-    cancel(): void;
+declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, ms: number, options?: DebounceOptions): T & {
+  cancel(): void;
 };
 /**
  * Throttle — rate-limit execution, keep first/last
@@ -52,8 +53,8 @@ export declare function debounce<T extends (...args: unknown[]) => unknown>(fn:
  * handleScroll.cancel();
  * ```
  */
-export declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, ms: number, options?: ThrottleOptions): T & {
-    cancel(): void;
+declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, ms: number, options?: ThrottleOptions): T & {
+  cancel(): void;
 };
 /**
  * Once — guard against double execution
@@ -71,7 +72,7 @@ export declare function throttle<T extends (...args: unknown[]) => unknown>(fn:
  * init(); // does nothing
  * ```
  */
-export declare function once<T extends (...args: unknown[]) => unknown>(fn: T): T;
+declare function once<T extends (...args: unknown[]) => unknown>(fn: T): T;
 /**
  * Defer — schedule on microtask queue
  *
@@ -85,7 +86,7 @@ export declare function once<T extends (...args: unknown[]) => unknown>(fn: T):
  * defer(() => update()); // runs after current stack, before next macrotask
  * ```
  */
-export declare function defer(fn: () => void): void;
+declare function defer(fn: () => void): void;
 /**
  * RAF — coalesce multiple updates into single frame
  *
@@ -101,7 +102,7 @@ export declare function defer(fn: () => void): void;
  * update(); // same frame, no duplicate
  * ```
  */
-export declare function raf<T extends (...args: unknown[]) => unknown>(fn: T): T;
+declare function raf<T extends (...args: unknown[]) => unknown>(fn: T): T;
 /**
  * Idle — schedule low-priority work
  *
@@ -116,8 +117,8 @@ export declare function raf<T extends (...args: unknown[]) => unknown>(fn: T): T
  * idle(() => prefetchData());
  * ```
  */
-export declare function idle(fn: () => void, options?: {
-    timeout?: number;
+declare function idle(fn: () => void, options?: {
+  timeout?: number;
 }): void;
 /**
  * Timeout — Promise-based delay
@@ -133,7 +134,7 @@ export declare function idle(fn: () => void, options?: {
  * console.log('300ms later');
  * ```
  */
-export declare function timeout(ms: number): Promise<void>;
+declare function timeout(ms: number): Promise<void>;
 /**
  * Retry — attempt function with backoff
  *
@@ -151,5 +152,7 @@ export declare function timeout(ms: number): Promise<void>;
  * });
  * ```
  */
-export declare function retry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+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 +1 @@
-{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/fx/timing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAChE,EAAE,EAAE,CAAC,EACL,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,eAAe,GACxB,CAAC,GAAG;IAAE,MAAM,IAAI,IAAI,CAAA;CAAE,CAuCxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAChE,EAAE,EAAE,CAAC,EACL,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,eAAe,GACxB,CAAC,GAAG;IAAE,MAAM,IAAI,IAAI,CAAA;CAAE,CA4CxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAWxE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAE1C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAiBvE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASzE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,CAAC,CAAC,CAsBZ"}
+{"version":3,"file":"timing.d.ts","names":[],"sources":["../../src/fx/timing.ts"],"mappings":";;AAKA;;;UAAiB,eAAA;EACf,OAAA;EACA,QAAA;AAAA;AAAA,UAGe,eAAA;EACf,OAAA;EACA,QAAA;AAAA;AAAA,UAGe,YAAA;EACf,WAAA;EACA,OAAA;EACA,OAAA,IAAW,YAAA;AAAA;;;;;AAoBb;;;;;;;;;;;;;iBAAgB,QAAA,eAAuB,IAAA,wBAAA,CACrC,EAAA,EAAI,CAAA,EACJ,EAAA,UACA,OAAA,GAAU,eAAA,GACT,CAAA;EAAM,MAAA;AAAA;;;;AA0DT;;;;;;;;;;;;;;iBAAgB,QAAA,eAAuB,IAAA,wBAAA,CACrC,EAAA,EAAI,CAAA,EACJ,EAAA,UACA,OAAA,GAAU,eAAA,GACT,CAAA;EAAM,MAAA;AAAA;;;AA8DT;;;;;;;;;;;AA0BA;;;iBA1BgB,IAAA,eAAmB,IAAA,wBAAA,CAA6B,EAAA,EAAI,CAAA,GAAI,CAAA;;AA6CxE;;;;;;;;;;;AAiCA;iBApDgB,KAAA,CAAM,EAAA;;;;;;;;AA6EtB;;;;;AAqBA;;;iBA/EgB,GAAA,eAAkB,IAAA,wBAAA,CAA6B,EAAA,EAAI,CAAA,GAAI,CAAA;;;;;;;;;;;;;;;iBAiCvD,IAAA,CAAK,EAAA,cAAgB,OAAA;EAAY,OAAA;AAAA;;;;;;;;;;;;;;;iBAyBjC,OAAA,CAAQ,EAAA,WAAa,OAAA;;;;;;;;;;;;;;;;;;iBAqBf,KAAA,GAAA,CACpB,EAAA,QAAU,OAAA,CAAQ,CAAA,GAClB,OAAA,GAAU,YAAA,GACT,OAAA,CAAQ,CAAA"}