@askrjs/askr 0.3.0 → 0.4.0

package/dist/foundations/icon/index.d.ts

@@ -33,57 +33,6 @@ type IconProps = Omit<
     children?: unknown;
     ref?: Ref<SVGSVGElement>;
   };
-/** Check whether `value` is one of the named icon size tokens ('sm'|'md'|'lg'|'xl'). */
-declare function isIconSizeToken(value: unknown): value is IconSizeToken;
-/** Normalize a numeric icon size to a `px` string; strings pass through unchanged. */
-declare function normalizeIconSizeValue(size: number | string): string;
-/** Resolve a size (token or literal) to a CSS `var(--ak-icon-size-*, ...)` expression or literal value. */
-declare function resolveIconSizeVariable(size: number | string): string;
-/** Resolve a stroke width to a CSS `var(--ak-icon-stroke-width-*, ...)` expression, scoped to `sizeToken` when given. */
-declare function resolveIconStrokeWidthVariable(
-  strokeWidth: number,
-  sizeToken: IconSizeToken | undefined
-): string;
-/** Serialize an inline style object (or pass through a string) to a CSS declaration string. */
-declare function serializeIconStyle(
-  style: string | IconStyleObject | undefined
-): string;
-/** Join non-empty CSS declaration fragments with `;`, dropping any that are blank. */
-declare function joinIconStyle(
-  ...styles: Array<string | undefined>
-): string | undefined;
-/** Compute the shared SVG attributes and inline style implementing the icon size/stroke/color contract. */
-declare function getIconContractProps({
-  size,
-  strokeWidth,
-  color,
-  title,
-  style,
-  iconName,
-}: Pick<
-  IconProps,
-  'color' | 'iconName' | 'size' | 'strokeWidth' | 'style' | 'title'
->): {
-  sizeToken: IconSizeToken | undefined;
-  decorative: string | undefined;
-  iconStyle: string | undefined;
-  attrs: {
-    xmlns: string;
-    width: string;
-    height: string;
-    fill: string;
-    stroke: string;
-    'stroke-width': string;
-    role: string;
-    'aria-hidden': string | undefined;
-    style: string | undefined;
-    'data-slot': string;
-    'data-icon': string | undefined;
-    'data-size': IconSizeToken | undefined;
-    'data-decorative': string | undefined;
-    'data-color': string | undefined;
-  };
-};
 /** Base `<svg>` wrapper implementing the icon contract; generated icon components render into it. */
 declare function IconBase({
   size,
@@ -103,11 +52,4 @@ export {
   type IconProps,
   type IconSizeToken,
   type IconStyleObject,
-  getIconContractProps,
-  isIconSizeToken,
-  joinIconStyle,
-  normalizeIconSizeValue,
-  resolveIconSizeVariable,
-  resolveIconStrokeWidthVariable,
-  serializeIconStyle,
 };

package/dist/foundations/icon/index.js

@@ -1,4 +1,4 @@
-import { r as jsxs, t as jsx } from "../../jsx-runtime-CPJXAOBF.js";
+import { i as jsxs, n as jsx } from "../../jsx-runtime-C4idqHY0.js";
 //#region src/foundations/icon/icon.tsx
 const ICON_SIZE_TOKENS = [
 	"sm",
@@ -92,4 +92,4 @@ function IconBase({ size = 20, strokeWidth = 2, color = "currentColor", title, c
 	return jsxs("svg", svgProps);
 }
 //#endregion
-export { IconBase, getIconContractProps, isIconSizeToken, joinIconStyle, normalizeIconSizeValue, resolveIconSizeVariable, resolveIconStrokeWidthVariable, serializeIconStyle };
+export { IconBase };

package/dist/foundations/index.js

@@ -1,2 +1,3 @@
-import { a as definePortal, c as layout, i as Portal, o as Presence, r as DefaultPortal, s as Slot } from "../structures-CjEzfj4h.js";
+import { a as layout, i as Slot, r as Presence } from "../structures-D4dDMqHX.js";
+import { n as Portal, r as definePortal, t as DefaultPortal } from "../portal-DuOKfnLa.js";
 export { DefaultPortal, Portal, Presence, Slot, definePortal, layout };

package/dist/foundations/interactions/index.js

@@ -1,2 +1,2 @@
-import { a as focusable, i as hoverable, n as mergeInteractionProps, o as dismissable, r as rovingFocus, s as pressable, t as applyInteractionPolicy } from "../../interactions-CTeACdT_.js";
+import { a as focusable, i as hoverable, n as mergeInteractionProps, o as dismissable, r as rovingFocus, s as pressable, t as applyInteractionPolicy } from "../../interactions-D2BoREb-.js";
 export { applyInteractionPolicy, dismissable, focusable, hoverable, mergeInteractionProps, pressable, rovingFocus };

package/dist/foundations/state/index.d.ts

@@ -1,4 +1,4 @@
-import { State } from '../../core.js';
+import { StateTuple } from '../../core.js';
 /** Whether `value` represents controlled mode (not `undefined`). */
 declare function isControlled<T>(value: T | undefined): value is T;
 /** Resolve the effective value and controlled-ness for a controllable prop. */
@@ -22,8 +22,8 @@ declare function makeControllable<T>(options: {
   set: (next: T) => void;
   isControlled: boolean;
 };
-/** A {@link State} accessor that also reports whether it is controlled. */
-type ControllableState<T> = State<T> & {
+/** A {@link StateTuple} accessor that also reports whether it is controlled. */
+type ControllableState<T> = StateTuple<T> & {
   isControlled: boolean;
 };
 /**

package/dist/foundations/state/index.js

@@ -1,4 +1,5 @@
-import { t as state } from "../../state-BXJfudq1.js";
+import { t as markReadable } from "../../readable-DFWOsTac.js";
+import { a as state, r as makeDestructurable } from "../../state-DWO1KzkX.js";
 //#region src/foundations/state/controllable.ts
 /**
 * controllable
@@ -76,11 +77,12 @@ function controllableState(options) {
 			options.onChange?.(next);
 			return;
 		}
-		internal.set(nextOrUpdater);
+		internal.set((() => next));
 		options.onChange?.(next);
 	};
 	read.isControlled = isControlled;
-	return read;
+	markReadable(read);
+	return makeDestructurable(read);
 }
 //#endregion
 export { controllableState, isControlled, makeControllable, resolveControllable };

package/dist/foundations/structures/index.js

@@ -1,2 +1,3 @@
-import { a as definePortal, c as layout, i as Portal, l as cloneElement, n as createCollection, o as Presence, r as DefaultPortal, s as Slot, t as createLayer, u as isElement } from "../../structures-CjEzfj4h.js";
+import { a as layout, i as Slot, n as createCollection, o as cloneElement, r as Presence, s as isElement, t as createLayer } from "../../structures-D4dDMqHX.js";
+import { n as Portal, r as definePortal, t as DefaultPortal } from "../../portal-DuOKfnLa.js";
 export { DefaultPortal, Portal, Presence, Slot, cloneElement, createCollection, createLayer, definePortal, isElement, layout };

package/dist/foundations/utilities/index.d.ts

@@ -8,6 +8,7 @@ import {
   DefaultPreventable,
   formatId,
   mergeProps,
+  MergedProps,
   PropagationStoppable,
   ariaDisabled,
   ComposeHandlersOptions,
@@ -20,6 +21,7 @@ export {
   type FocusLikeEvent,
   type FormatIdOptions,
   type KeyboardLikeEvent,
+  type MergedProps,
   type PointerLikeEvent,
   type PropagationStoppable,
   type Ref,

package/dist/foundations/utilities/index.js

@@ -1,4 +1,3 @@
-import { n as setRef, t as composeRefs } from "../../compose-ref-v0qGlHoN.js";
-import { a as composeHandlers, i as mergeProps, n as ariaExpanded, r as ariaSelected, t as ariaDisabled } from "../../aria-hKjThHcp.js";
+import { a as ariaSelected, i as ariaExpanded, n as setRef, o as mergeProps, r as ariaDisabled, s as composeHandlers, t as composeRefs } from "../../compose-ref-DWzdbxsD.js";
 import { t as formatId } from "../../utilities-C_CGX4Dz.js";
 export { ariaDisabled, ariaExpanded, ariaSelected, composeHandlers, composeRefs, formatId, mergeProps, setRef };

package/dist/fx/index.d.ts

@@ -1,13 +1,14 @@
 import { scheduleEventHandler } from '../core.js';
 /**
- * Timing utilities — pure helpers for common async patterns
- * No framework coupling. No lifecycle awareness.
+ * Timing and event-scheduling helpers.
+ *
+ * The timing helpers (`throttle`, `once`, `raf`, `idle`,
+ * `timeout`, `retry`) are plain functions with no runtime dependency. The
+ * event and `schedule*` helpers use the Askr scheduler and lifecycle ownership.
+ * `debounceEvent`, `throttleEvent`, and `rafEvent` reject invocation during
+ * render and cancel pending work on owner cleanup. `scheduleEventHandler`
+ * runs its handler in the captured owner's scope.
  */
-/** Options for {@link debounce}. */
-interface DebounceOptions {
-  leading?: boolean;
-  trailing?: boolean;
-}
 /** Options for {@link throttle}. */
 interface ThrottleOptions {
   leading?: boolean;
@@ -24,30 +25,6 @@ type Scheduled<T extends AnyFn> = (
   this: ThisParameterType<T>,
   ...args: Parameters<T>
 ) => void;
-/**
- * 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
-): Scheduled<T> & {
-  cancel(): void;
-};
 /**
  * Throttle — rate-limit execution, keep first/last
  *
@@ -89,20 +66,6 @@ declare function throttle<T extends AnyFn>(
  * ```
  */
 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
  *
@@ -118,7 +81,7 @@ declare function defer(fn: () => void): void;
  * update(); // same frame, no duplicate
  * ```
  */
-declare function raf<T extends AnyFn>(fn: T): Scheduled<T>;
+declare function raf<T extends AnyFn>(fn: T): Scheduled<T> & { cancel(): void };
 /**
  * Idle — schedule low-priority work
  *
@@ -203,34 +166,44 @@ declare function throttleEvent(
 declare function rafEvent(handler: EventListener): EventListener & {
   cancel(): void;
 };
-/** Schedule `fn` after `ms`, auto-cancelling on component cleanup; returns a cancel function. */
+/**
+ * Schedule `fn` after `ms`; returns a cancel function. Called from a mounted
+ * component's task, watch callback, or event handler, it is also cancelled
+ * when that component is cleaned up.
+ */
 declare function scheduleTimeout(ms: number, fn: () => void): CancelFn;
-/** Schedule `fn` during browser idle time, auto-cancelling on component cleanup. */
+/**
+ * Schedule `fn` during browser idle time; returns a cancel function. Called
+ * from a mounted component's task, watch callback, or event handler, it is
+ * also cancelled when that component is cleaned up.
+ */
 declare function scheduleIdle(
   fn: () => void,
   options?: {
     timeout?: number;
   }
 ): CancelFn;
-interface RetryOptions$1 {
-  maxAttempts?: number;
-  delayMs?: number;
-  backoff?: (attemptIndex: number) => number;
-}
-/** Run `fn`, retrying with backoff on failure, auto-cancelling on component cleanup. */
+/**
+ * Run `fn`, retrying with backoff on failure. Called from a mounted
+ * component's task, watch callback, or event handler, pending attempts are
+ * also cancelled when that component is cleaned up.
+ */
+type RetryOutcome<T> =
+  | { status: 'success'; value: T }
+  | { status: 'error'; error: unknown }
+  | { status: 'cancelled' };
 declare function scheduleRetry<T>(
   fn: () => Promise<T>,
-  options?: RetryOptions$1
+  options?: RetryOptions
 ): {
   cancel(): void;
+  result: Promise<RetryOutcome<T>>;
 };
 export {
-  type DebounceOptions,
   type RetryOptions,
+  type RetryOutcome,
   type ThrottleOptions,
-  debounce,
   debounceEvent,
-  defer,
   idle,
   once,
   raf,