@askrjs/askr 0.0.21 → 0.0.24

package/dist/foundations/structures/layer.d.ts

@@ -0,0 +1,102 @@
+/**
+ * createLayer
+ *
+ * Manages stacking order and coordination for overlays (modals, popovers, etc).
+ *
+ * INVARIANTS:
+ * 1. Layers are ordered by registration time (FIFO)
+ * 2. Only the top layer handles Escape key
+ * 3. Only the top layer handles outside pointer events
+ * 4. Nested layers are supported
+ * 5. Does not implement portals (orthogonal concern)
+ * 6. No automatic DOM insertion (caller controls mounting)
+ *
+ * DESIGN:
+ * - Returns a layer manager with register/unregister API
+ * - Each layer has a unique ID and can query if it's the top layer
+ * - Escape and outside pointer coordination via callbacks
+ * - No z-index management (CSS concern)
+ *
+ * USAGE:
+ *   const manager = createLayer();
+ *
+ *   const layer = manager.register({
+ *     onEscape: () => { ... },
+ *     onOutsidePointer: () => { ... }
+ *   });
+ *
+ *   layer.isTop(); // true if this is the topmost layer
+ *   layer.unregister();
+ */
+export interface LayerOptions {
+    /**
+     * Called when Escape is pressed and this is the top layer
+     */
+    onEscape?: () => void;
+    /**
+     * Called when pointer event occurs outside and this is the top layer
+     */
+    onOutsidePointer?: (e: PointerEvent) => void;
+    /**
+     * Optional node reference for outside pointer detection
+     */
+    node?: Node | null;
+}
+export interface Layer {
+    /**
+     * Unique layer ID
+     */
+    id: number;
+    /**
+     * Check if this layer is the topmost
+     */
+    isTop(): boolean;
+    /**
+     * Remove this layer from the stack
+     */
+    unregister(): void;
+}
+export interface LayerManager {
+    /**
+     * Register a new layer
+     */
+    register(options: LayerOptions): Layer;
+    /**
+     * Get all active layers in order
+     */
+    layers(): ReadonlyArray<Layer>;
+    /**
+     * Manually trigger escape handling on the top layer
+     */
+    handleEscape(): void;
+    /**
+     * Manually trigger outside pointer handling on the top layer
+     */
+    handleOutsidePointer(e: PointerEvent): void;
+}
+export declare function createLayer(): LayerManager;
+/**
+ * USAGE EXAMPLE:
+ *
+ * const layerManager = createLayer();
+ *
+ * function Modal({ onClose }) {
+ *   const modalRef = ref<HTMLDivElement>();
+ *
+ *   const layer = layerManager.register({
+ *     node: modalRef.current,
+ *     onEscape: onClose,
+ *     onOutsidePointer: onClose,
+ *   });
+ *
+ *   onUnmount(() => layer.unregister());
+ *
+ *   return (
+ *     <div ref={modalRef}>
+ *       <h1>Modal</h1>
+ *       {layer.isTop() && <p>I am on top!</p>}
+ *     </div>
+ *   );
+ * }
+ */
+//# sourceMappingURL=layer.d.ts.map

package/dist/foundations/structures/layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer.d.ts","sourceRoot":"","sources":["../../../src/foundations/structures/layer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAEtB;;OAEG;IACH,gBAAgB,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IAE7C;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC;IAEjB;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK,CAAC;IAEvC;;OAEG;IACH,MAAM,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;IAE/B;;OAEG;IACH,YAAY,IAAI,IAAI,CAAC;IAErB;;OAEG;IACH,oBAAoB,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CAC7C;AAED,wBAAgB,WAAW,IAAI,YAAY,CAyE1C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}

package/dist/foundations/structures/layer.js

@@ -0,0 +1 @@
+function l(){const n=[];let s=1;function d(t){const i=s++,e={id:i,options:t};n.push(e);function f(){return n[n.length-1]?.id===i}function p(){const o=n.findIndex(a=>a.id===i);o!==-1&&n.splice(o,1)}return{id:i,isTop:f,unregister:p}}function r(){return n.map(t=>({id:t.id,isTop:()=>n[n.length-1]?.id===t.id,unregister:()=>{const i=n.findIndex(e=>e.id===t.id);i!==-1&&n.splice(i,1)}}))}function c(){const t=n[n.length-1];t&&t.options.onEscape?.()}function u(t){const i=n[n.length-1];if(!i)return;const e=i.options.node;e&&t.target instanceof Node&&e.contains(t.target)||i.options.onOutsidePointer?.(t)}return{register:d,layers:r,handleEscape:c,handleOutsidePointer:u}}export{l as createLayer};

package/dist/{layout-BINPv-nz.d.ts → foundations/structures/layout.d.ts}

@@ -21,9 +21,8 @@
  *    Props are spread into the layout component. This is intentional
  *    and deterministic — no merging or composition.
  */
-type LayoutComponent<P = object> = (props: P & {
+export type LayoutComponent<P = object> = (props: P & {
     children?: unknown;
 }) => unknown;
-declare function layout<P = object>(Layout: LayoutComponent<P>): (children?: unknown, props?: P) => unknown;
-
-export { type LayoutComponent as L, layout as l };
+export declare function layout<P = object>(Layout: LayoutComponent<P>): (children?: unknown, props?: P) => unknown;
+//# sourceMappingURL=layout.d.ts.map

package/dist/foundations/structures/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/foundations/structures/layout.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,MAAM,IAAI,CACxC,KAAK,EAAE,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,KAC9B,OAAO,CAAC;AAEb,wBAAgB,MAAM,CAAC,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,IACnD,WAAW,OAAO,EAAE,QAAQ,CAAC,aAItC"}

package/dist/foundations/structures/layout.js

@@ -0,0 +1 @@
+function o(r){return(t,e)=>{const n={...e,children:t};return r(n)}}export{o as layout};

package/dist/foundations/structures/portal.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Portal / Host primitive.
+ *
+ * Foundations remain runtime-agnostic: a portal is an explicit read/write slot.
+ * Scheduling and attachment are owned by the runtime when `createPortalSlot`
+ * exists; otherwise this falls back to a local slot (deterministic, but does
+ * not schedule updates).
+ *
+ * POLICY DECISIONS (LOCKED):
+ *
+ * 1. Local Mutable State
+ *    Foundations may use local mutable state ONLY to model deterministic slots,
+ *    never to coordinate timing, effects, or ordering. The fallback mode uses
+ *    closure-local `mounted` and `value` variables which are non-escaping and
+ *    deterministic.
+ *
+ * 2. Return Type Philosophy
+ *    Portal call signatures return `unknown` (intentionally opaque). The runtime
+ *    owns the concrete type. This prevents foundations from assuming JSX.Element
+ *    or DOM node types, maintaining runtime-agnostic portability.
+ */
+export interface Portal<T = unknown> {
+    /** Mount point — rendered exactly once */
+    (): unknown;
+    /** Render content into the portal */
+    render(props: {
+        children?: T;
+    }): unknown;
+}
+export declare function definePortal<T = unknown>(): Portal<T>;
+export declare function _resetDefaultPortal(): void;
+export declare const DefaultPortal: Portal<unknown>;
+//# sourceMappingURL=portal.d.ts.map

package/dist/foundations/structures/portal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../../src/foundations/structures/portal.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,OAAO;IACjC,0CAA0C;IAC1C,IAAI,OAAO,CAAC;IAEZ,qCAAqC;IACrC,MAAM,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC;CAC1C;AAED,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,CA6CrD;AAaD,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAOD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,OAAO,CAUtC,CAAC"}

package/dist/foundations/structures/portal.js

@@ -0,0 +1 @@
+function f(){if(typeof createPortalSlot=="function"){let o=function(){return n.read()};const n=createPortalSlot();return o.render=function(a){return n.write(a.children),null},o}let r=!1,t;function e(){return r=!0,t}return e.render=function(n){return r&&(t=n.children),null},e}let l;function i(){l=void 0}function u(){return l||(l=f()),l}const d=(()=>{function r(){const t=u()();return t===void 0?null:t}return r.render=function(e){return u().render(e),null},r})();export{d as DefaultPortal,i as _resetDefaultPortal,f as definePortal};

package/dist/foundations/structures/presence.d.ts

@@ -0,0 +1,30 @@
+import type { JSXElement } from '../../jsx';
+export interface PresenceProps {
+    present: boolean | (() => boolean);
+    children?: unknown;
+}
+/**
+ * Presence
+ *
+ * Structural policy primitive for conditional mount/unmount.
+ * - No timers
+ * - No animation coupling
+ * - No DOM side-effects
+ *
+ * POLICY DECISIONS (LOCKED):
+ *
+ * 1. Present as Function
+ *    Accepts boolean OR function to support lazy evaluation patterns.
+ *    Function is called once per render. Use boolean form for static values.
+ *
+ * 2. Children Type
+ *    `children` is intentionally `unknown` to remain runtime-agnostic.
+ *    The runtime owns child normalization and validation.
+ *
+ * 3. Immediate Mount/Unmount
+ *    No exit animations or transitions. When `present` becomes false,
+ *    children are removed immediately. Animation must be layered above
+ *    this primitive.
+ */
+export declare function Presence({ present, children, }: PresenceProps): JSXElement | null;
+//# sourceMappingURL=presence.d.ts.map

package/dist/foundations/structures/presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../../src/foundations/structures/presence.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,EACvB,OAAO,EACP,QAAQ,GACT,EAAE,aAAa,GAAG,UAAU,GAAG,IAAI,CAYnC"}

package/dist/foundations/structures/presence.js

@@ -0,0 +1 @@
+import"../../jsx/index.js";import{Fragment as t,ELEMENT_TYPE as o}from"../../common/jsx.js";function m({present:e,children:n}){return(typeof e=="function"?e():!!e)?{$$typeof:o,type:t,props:{children:n},key:null}:null}export{m as Presence};

package/dist/foundations/structures/slot.d.ts

@@ -0,0 +1,31 @@
+import type { JSXElement } from '../../jsx';
+export type SlotProps = {
+    asChild: true;
+    children: JSXElement;
+    [key: string]: unknown;
+} | {
+    asChild?: false;
+    children?: unknown;
+};
+/**
+ * Slot
+ *
+ * Structural primitive for prop forwarding patterns.
+ *
+ * POLICY DECISIONS (LOCKED):
+ *
+ * 1. asChild Pattern
+ *    When asChild=true, merges props into the single child element.
+ *    Child must be a valid JSXElement; non-element children return null.
+ *    **Slot props override child props** (injection pattern).
+ *
+ * 2. Fallback Behavior
+ *    When asChild=false, returns a Fragment (structural no-op).
+ *    No DOM element is introduced.
+ *
+ * 3. Type Safety
+ *    asChild=true requires exactly one JSXElement child (enforced by type).
+ *    Runtime validates with isElement() check.
+ */
+export declare function Slot(props: SlotProps): JSXElement | null;
+//# sourceMappingURL=slot.d.ts.map

package/dist/foundations/structures/slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot.d.ts","sourceRoot":"","sources":["../../../src/foundations/structures/slot.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,MAAM,SAAS,GACjB;IACE,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,UAAU,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,GACD;IACE,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEN;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI,CAmBxD"}

package/dist/foundations/structures/slot.js

@@ -0,0 +1 @@
+import"../../jsx/index.js";import{isElement as l,cloneElement as r}from"../../jsx/utils.js";import{Fragment as i,ELEMENT_TYPE as o}from"../../common/jsx.js";function s(e){if(e.asChild){const{children:t,asChild:c,...n}=e;return l(t)?r(t,n):null}return{$$typeof:o,type:i,props:{children:e.children},key:null}}export{s as Slot};

package/dist/foundations/structures.d.ts

@@ -0,0 +1,14 @@
+export { layout } from './structures/layout';
+export type { LayoutComponent } from './structures/layout';
+export { Slot } from './structures/slot';
+export type { SlotProps } from './structures/slot';
+export type { JSXElement } from '../jsx';
+export { Presence } from './structures/presence';
+export type { PresenceProps } from './structures/presence';
+export { definePortal, DefaultPortal } from './structures/portal';
+export type { Portal } from './structures/portal';
+export { createCollection } from './structures/collection';
+export type { Collection, CollectionItem } from './structures/collection';
+export { createLayer } from './structures/layer';
+export type { Layer, LayerManager, LayerOptions } from './structures/layer';
+//# sourceMappingURL=structures.d.ts.map

package/dist/foundations/structures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structures.d.ts","sourceRoot":"","sources":["../../src/foundations/structures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAClE,YAAY,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE1E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/foundations/structures.js

@@ -0,0 +1 @@
+import{layout as r}from"./structures/layout.js";import{Slot as f}from"./structures/slot.js";import{Presence as l}from"./structures/presence.js";import{DefaultPortal as p,definePortal as x}from"./structures/portal.js";import{createCollection as n}from"./structures/collection.js";import{createLayer as i}from"./structures/layer.js";export{p as DefaultPortal,l as Presence,f as Slot,n as createCollection,i as createLayer,x as definePortal,r as layout};

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

@@ -0,0 +1,13 @@
+/**
+ * Tiny aria helpers
+ */
+export declare function ariaDisabled(disabled?: boolean): {
+    'aria-disabled'?: 'true';
+};
+export declare function ariaExpanded(expanded?: boolean): {
+    'aria-expanded'?: 'true' | 'false';
+};
+export declare function ariaSelected(selected?: boolean): {
+    'aria-selected'?: 'true' | 'false';
+};
+//# sourceMappingURL=aria.d.ts.map

package/dist/foundations/utilities/aria.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria.d.ts","sourceRoot":"","sources":["../../../src/foundations/utilities/aria.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG;IAAE,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CAE7E;AAED,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG;IAChD,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACpC,CAIA;AAED,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG;IAChD,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACpC,CAIA"}

package/dist/foundations/utilities/aria.js

@@ -0,0 +1 @@
+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};

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

@@ -0,0 +1,34 @@
+/**
+ * composeHandlers
+ *
+ * Compose two event handlers into one. The first handler runs, and unless it
+ * calls `event.preventDefault()` (or sets `defaultPrevented`), the second
+ * handler runs. This prevents accidental clobbering of child handlers when
+ * injecting props.
+ *
+ * POLICY DECISIONS (LOCKED):
+ *
+ * 1. Execution Order
+ *    First handler runs before second (injected before base).
+ *    This allows injected handlers to prevent default behavior.
+ *
+ * 2. Default Prevention Check
+ *    By default, checks `defaultPrevented` on first argument.
+ *    Can be disabled via options.checkDefaultPrevented = false.
+ *
+ * 3. Undefined Handler Support
+ *    Undefined handlers are skipped (no-op). This simplifies usage
+ *    where handlers are optional.
+ *
+ * 4. Type Safety
+ *    Args are readonly to prevent mutation. Return type matches input.
+ */
+export interface ComposeHandlersOptions {
+    /**
+     * When true (default), do not run the second handler if the first prevented default.
+     * When false, always run both handlers.
+     */
+    checkDefaultPrevented?: boolean;
+}
+export declare function composeHandlers<A extends readonly unknown[]>(first?: (...args: A) => void, second?: (...args: A) => void, options?: ComposeHandlersOptions): (...args: A) => void;
+//# sourceMappingURL=compose-handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compose-handlers.d.ts","sourceRoot":"","sources":["../../../src/foundations/utilities/compose-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAaD,wBAAgB,eAAe,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,EAC1D,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,EAC5B,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,EAC7B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,CAsBtB"}

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

@@ -0,0 +1 @@
+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};

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

@@ -0,0 +1,24 @@
+/**
+ * Ref composition utilities
+ *
+ * POLICY DECISIONS (LOCKED):
+ *
+ * 1. Ref Types Supported
+ *    - Callback refs: (value: T | null) => void
+ *    - Object refs: { current: T | null }
+ *    - null/undefined (no-op)
+ *
+ * 2. Write Failure Handling
+ *    setRef catches write failures (readonly refs) and ignores them.
+ *    This is intentional — refs may be readonly in some contexts.
+ *
+ * 3. Composition Order
+ *    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;
+} | 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;
+//# sourceMappingURL=compose-ref.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1 @@
+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};

package/dist/foundations/utilities/event-types.d.ts

@@ -0,0 +1,17 @@
+export interface DefaultPreventable {
+    defaultPrevented?: boolean;
+    preventDefault?: () => void;
+}
+export interface PropagationStoppable {
+    stopPropagation?: () => void;
+}
+export interface KeyboardLikeEvent extends DefaultPreventable, PropagationStoppable {
+    key: string;
+}
+export interface PointerLikeEvent extends DefaultPreventable, PropagationStoppable {
+    target?: unknown;
+}
+export interface FocusLikeEvent extends DefaultPreventable, PropagationStoppable {
+    relatedTarget?: unknown;
+}
+//# sourceMappingURL=event-types.d.ts.map

package/dist/foundations/utilities/event-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-types.d.ts","sourceRoot":"","sources":["../../../src/foundations/utilities/event-types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,iBACf,SAAQ,kBAAkB,EAAE,oBAAoB;IAChD,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBACf,SAAQ,kBAAkB,EAAE,oBAAoB;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cACf,SAAQ,kBAAkB,EAAE,oBAAoB;IAChD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

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

@@ -0,0 +1,7 @@
+export * from './compose-handlers';
+export * from './merge-props';
+export * from './aria';
+export * from './compose-ref';
+export * from './use-id';
+export * from './event-types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/foundations/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/foundations/utilities/merge-props.d.ts

@@ -0,0 +1,2 @@
+export declare function mergeProps<TBase extends object, TInjected extends object>(base: TBase, injected: TInjected): TInjected & TBase;
+//# sourceMappingURL=merge-props.d.ts.map

package/dist/foundations/utilities/merge-props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-props.d.ts","sourceRoot":"","sources":["../../../src/foundations/utilities/merge-props.ts"],"names":[],"mappings":"AAiCA,wBAAgB,UAAU,CAAC,KAAK,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,EACvE,IAAI,EAAE,KAAK,EACX,QAAQ,EAAE,SAAS,GAClB,SAAS,GAAG,KAAK,CA+BnB"}

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

@@ -0,0 +1 @@
+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};

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

@@ -0,0 +1,29 @@
+export 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.
+ */
+export declare function formatId(options: FormatIdOptions): string;
+//# sourceMappingURL=use-id.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-id.d.ts","sourceRoot":"","sources":["../../../src/foundations/utilities/use-id.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAGzD"}

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

@@ -0,0 +1 @@
+function f(r){return`${r.prefix??"askr"}-${String(r.id)}`}export{f as formatId};

package/dist/fx/fx.d.ts

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

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

@@ -0,0 +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"}

package/dist/fx/fx.js

@@ -0,0 +1 @@
+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};