@askrjs/askr 0.0.91 → 0.0.94

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

@@ -1,5 +1,5 @@
-import { t as Ref } from "../../compose-ref-Cizq72-x.js";
-import { d as KeyboardLikeEvent, f as PointerLikeEvent, l as DefaultPreventable, p as PropagationStoppable } from "../../index-BnU0NPwM.js";
+import { t as Ref } from "../../compose-ref-DOJHoW5X.js";
+import { d as KeyboardLikeEvent, f as PointerLikeEvent, l as DefaultPreventable, p as PropagationStoppable } from "../../index-CzH-0LcA.js";
 //#region src/foundations/interactions/pressable.d.ts
 /**
  * pressable
@@ -33,6 +33,7 @@ import { d as KeyboardLikeEvent, f as PointerLikeEvent, l as DefaultPreventable,
  *    - Held Enter/Space will fire onPress repeatedly (matches native button)
  *    - No debouncing or repeat prevention (platform parity)
  */
+/** Options for {@link pressable}. */
 interface PressableOptions {
   disabled?: boolean;
   onPress?: (e: PressEvent) => void;
@@ -42,6 +43,7 @@ interface PressableOptions {
   isNativeButton?: boolean;
 }
 type PressEvent = DefaultPreventable & PropagationStoppable;
+/** Element props returned by {@link pressable}. */
 interface PressableResult {
   onClick: (e: PressEvent) => void;
   disabled?: true;
@@ -51,6 +53,7 @@ interface PressableResult {
   onKeyUp?: (e: KeyboardLikeEvent) => void;
   'aria-disabled'?: 'true';
 }
+/** Produce click/keyboard props implementing 'press' semantics for an element. */
 declare function pressable({ disabled, onPress, isNativeButton }: PressableOptions): PressableResult;
 //#endregion
 //#region src/foundations/interactions/dismissable.d.ts
@@ -97,6 +100,7 @@ declare function pressable({ disabled, onPress, isNativeButton }: PressableOptio
  *   ❌ Can't create custom escape handler - this is the only one
  *   ❌ Can't bypass via direct event listeners - mergeProps composes correctly
  */
+/** Options for {@link dismissable}. */
 interface DismissableOptions {
   /**
    * Reference to the protected element for outside click detection. Attach the
@@ -112,6 +116,7 @@ interface DismissableOptions {
    */
   onDismiss?: (trigger: 'escape' | 'outside') => void;
 }
+/** Produce keydown/outside-click props that invoke `onDismiss` on Escape or an outside click. */
 declare function dismissable({ node, disabled, onDismiss }: DismissableOptions): {
   onKeyDown: (e: KeyboardLikeEvent) => void;
   onPointerDownCapture: (e: PointerLikeEvent) => void;
@@ -124,14 +129,17 @@ declare function dismissable({ node, disabled, onDismiss }: DismissableOptions):
  * Normalize focus-related props for hosts.
  * - No DOM manipulation here; returns props that the runtime may attach.
  */
+/** Options for {@link focusable}. */
 interface FocusableOptions {
   disabled?: boolean;
   tabIndex?: number | undefined;
 }
+/** Element props returned by {@link focusable}. */
 interface FocusableResult {
   tabIndex?: number;
   'aria-disabled'?: 'true';
 }
+/** Normalize `tabIndex`/`aria-disabled` props for a focusable host. */
 declare function focusable({ disabled, tabIndex }: FocusableOptions): FocusableResult;
 //#endregion
 //#region src/foundations/interactions/hoverable.d.ts
@@ -140,20 +148,25 @@ declare function focusable({ disabled, tabIndex }: FocusableOptions): FocusableR
  *
  * Produces props for pointer enter/leave handling. Pure and deterministic.
  */
+/** Options for {@link hoverable}. */
 interface HoverableOptions {
   disabled?: boolean;
   onEnter?: (e: HoverEvent) => void;
   onLeave?: (e: HoverEvent) => void;
 }
 type HoverEvent = DefaultPreventable & PropagationStoppable;
+/** Element props returned by {@link hoverable}. */
 interface HoverableResult {
   onPointerEnter?: (e: HoverEvent) => void;
   onPointerLeave?: (e: HoverEvent) => void;
 }
+/** Produce pointer enter/leave props that call `onEnter`/`onLeave` unless disabled. */
 declare function hoverable({ disabled, onEnter, onLeave }: HoverableOptions): HoverableResult;
 //#endregion
 //#region src/foundations/interactions/roving-focus.d.ts
+/** Arrow-key axis for {@link rovingFocus}. */
 type Orientation = 'horizontal' | 'vertical' | 'both';
+/** Options for {@link rovingFocus}. */
 interface RovingFocusOptions {
   /**
    * Current focused index
@@ -183,6 +196,7 @@ interface RovingFocusOptions {
    */
   isDisabled?: (index: number) => boolean;
 }
+/** Container and per-item props returned by {@link rovingFocus}. */
 interface RovingFocusResult {
   /**
    * Props for the container element (composes via mergeProps)
@@ -198,6 +212,7 @@ interface RovingFocusResult {
     'data-roving-index': number;
   };
 }
+/** Implement arrow-key roving tabindex navigation over a set of items. */
 declare function rovingFocus(options: RovingFocusOptions): RovingFocusResult;
 /**
  * USAGE EXAMPLE:
@@ -227,6 +242,7 @@ declare function rovingFocus(options: RovingFocusOptions): RovingFocusResult;
  */
 //#endregion
 //#region src/foundations/interactions/interaction-policy.d.ts
+/** Input to {@link applyInteractionPolicy}. */
 interface InteractionPolicyInput {
   /** Whether the host element is a native interactive element (button, a, etc) */
   isNative: boolean;

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-CWkNEq_C.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-B4XaFxt1.js";
 export { applyInteractionPolicy, dismissable, focusable, hoverable, mergeInteractionProps, pressable, rovingFocus };

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

@@ -1,10 +1,16 @@
-import { v as State } from "../../control-D-FIa-n-.js";
+import { dn as State } from "../../index-KQ7Vl4-8.js";
 //#region src/foundations/state/controllable.d.ts
+/** 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. */
 declare function resolveControllable<T>(value: T | undefined, defaultValue: T): {
   value: T;
   isControlled: boolean;
 };
+/**
+ * Build a `set` function that calls `onChange` in controlled mode, or
+ * updates internal state and then calls `onChange` in uncontrolled mode.
+ */
 declare function makeControllable<T>(options: {
   value: T | undefined;
   defaultValue: T;
@@ -14,6 +20,7 @@ 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> & {
   isControlled: boolean;
 };

package/dist/foundations/state/index.js

@@ -1,4 +1,4 @@
-import { t as state } from "../../state-DCjONcHK.js";
+import { t as state } from "../../state-DmkGM_LN.js";
 //#region src/foundations/state/controllable.ts
 /**
 * controllable
@@ -23,9 +23,11 @@ import { t as state } from "../../state-DCjONcHK.js";
 *    controllableState uses Object.is() to prevent unnecessary onChange calls.
 *    This is intentional — strict equality, no deep comparison.
 */
+/** Whether `value` represents controlled mode (not `undefined`). */
 function isControlled(value) {
 	return value !== void 0;
 }
+/** Resolve the effective value and controlled-ness for a controllable prop. */
 function resolveControllable(value, defaultValue) {
 	const controlled = isControlled(value);
 	return {
@@ -33,6 +35,10 @@ function resolveControllable(value, defaultValue) {
 		isControlled: controlled
 	};
 }
+/**
+* Build a `set` function that calls `onChange` in controlled mode, or
+* updates internal state and then calls `onChange` in uncontrolled mode.
+*/
 function makeControllable(options) {
 	const { value, defaultValue, onChange, setInternal } = options;
 	const { isControlled } = resolveControllable(value, defaultValue);

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

@@ -1,3 +1,3 @@
-import { r as JSXElement } from "../../jsx-BYXe_Nnk.js";
-import { _ as isElement, a as Collection, c as DefaultPortal, d as definePortal, f as Presence, g as cloneElement, h as SlotProps, i as createLayer, l as Portal, m as Slot, n as LayerManager, o as CollectionItem, p as PresenceProps, r as LayerOptions, s as createCollection, t as Layer, u as PortalProps, v as LayoutComponent, y as layout } from "../../index-Cf2ANwPL.js";
+import { r as JSXElement } from "../../types-DkVJhVs9.js";
+import { _ as isElement, a as Collection, c as DefaultPortal, d as definePortal, f as Presence, g as cloneElement, h as SlotProps, i as createLayer, l as Portal, m as Slot, n as LayerManager, o as CollectionItem, p as PresenceProps, r as LayerOptions, s as createCollection, t as Layer, u as PortalProps, v as LayoutComponent, y as layout } from "../../index-C29SEGIv.js";
 export { type Collection, type CollectionItem, DefaultPortal, type JSXElement, type Layer, type LayerManager, type LayerOptions, type LayoutComponent, Portal, type PortalProps, Presence, type PresenceProps, Slot, type SlotProps, cloneElement, createCollection, createLayer, definePortal, isElement, layout };

package/dist/foundations/structures/index.js

@@ -1,2 +1,2 @@
-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-m-cphWI-.js";
+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-umvVUD-M.js";
 export { DefaultPortal, Portal, Presence, Slot, cloneElement, createCollection, createLayer, definePortal, isElement, layout };

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

@@ -1,3 +1,3 @@
-import { n as composeRefs, r as setRef, t as Ref } from "../../compose-ref-Cizq72-x.js";
-import { a as ariaSelected, c as composeHandlers, d as KeyboardLikeEvent, f as PointerLikeEvent, i as ariaExpanded, l as DefaultPreventable, n as formatId, o as mergeProps, p as PropagationStoppable, r as ariaDisabled, s as ComposeHandlersOptions, t as FormatIdOptions, u as FocusLikeEvent } from "../../index-BnU0NPwM.js";
+import { n as composeRefs, r as setRef, t as Ref } from "../../compose-ref-DOJHoW5X.js";
+import { a as ariaSelected, c as composeHandlers, d as KeyboardLikeEvent, f as PointerLikeEvent, i as ariaExpanded, l as DefaultPreventable, n as formatId, o as mergeProps, p as PropagationStoppable, r as ariaDisabled, s as ComposeHandlersOptions, t as FormatIdOptions, u as FocusLikeEvent } from "../../index-CzH-0LcA.js";
 export { type ComposeHandlersOptions, type DefaultPreventable, type FocusLikeEvent, type FormatIdOptions, type KeyboardLikeEvent, type PointerLikeEvent, type PropagationStoppable, type Ref, ariaDisabled, ariaExpanded, ariaSelected, composeHandlers, composeRefs, formatId, mergeProps, setRef };

package/dist/foundations/utilities/index.js

@@ -1,3 +1,3 @@
-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-Cc_YkUpM.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-1Fhs7mbF.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,17 +1,20 @@
-import { n as scheduleEventHandler } from "../scheduler-CmLO4Dfm.js";
+import { X as scheduleEventHandler } from "../index-KQ7Vl4-8.js";
 //#region src/fx/timing.d.ts
 /**
  * Timing utilities — pure helpers for common async patterns
  * No framework coupling. No lifecycle awareness.
  */
+/** Options for {@link debounce}. */
 interface DebounceOptions {
   leading?: boolean;
   trailing?: boolean;
 }
+/** Options for {@link throttle}. */
 interface ThrottleOptions {
   leading?: boolean;
   trailing?: boolean;
 }
+/** Options for {@link retry}. */
 interface RetryOptions {
   maxAttempts?: number;
   delayMs?: number;
@@ -158,6 +161,7 @@ declare function retry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise
 //#endregion
 //#region src/fx/fx.d.ts
 type CancelFn = () => void;
+/** Wrap an event handler so rapid events are coalesced and delayed by `ms`. */
 declare function debounceEvent(ms: number, handler: EventListener, options?: {
   leading?: boolean;
   trailing?: boolean;
@@ -165,16 +169,20 @@ declare function debounceEvent(ms: number, handler: EventListener, options?: {
   cancel(): void;
   flush(): void;
 };
+/** Wrap an event handler so it runs at most once per `ms` interval. */
 declare function throttleEvent(ms: number, handler: EventListener, options?: {
   leading?: boolean;
   trailing?: boolean;
 }): EventListener & {
   cancel(): void;
 };
+/** Wrap an event handler so it runs at most once per animation frame, using the latest event. */
 declare function rafEvent(handler: EventListener): EventListener & {
   cancel(): void;
 };
+/** Schedule `fn` after `ms`, auto-cancelling on component cleanup; returns a cancel function. */
 declare function scheduleTimeout(ms: number, fn: () => void): CancelFn;
+/** Schedule `fn` during browser idle time, auto-cancelling on component cleanup. */
 declare function scheduleIdle(fn: () => void, options?: {
   timeout?: number;
 }): CancelFn;
@@ -183,6 +191,7 @@ interface RetryOptions$1 {
   delayMs?: number;
   backoff?: (attemptIndex: number) => number;
 }
+/** Run `fn`, retrying with backoff on failure, auto-cancelling on component cleanup. */
 declare function scheduleRetry<T>(fn: () => Promise<T>, options?: RetryOptions$1): {
   cancel(): void;
 };

package/dist/fx/index.js

@@ -1,5 +1,5 @@
-import { h as scheduleEventHandler, n as enqueueRuntimeTask, v as logger } from "../access-Dpfoi4cA.js";
-import { f as getCurrentComponentInstance } from "../component-scope-DzJEbYGE.js";
+import { g as scheduleEventHandler, n as enqueueRuntimeTask, y as logger } from "../access-d_DCdwqn.js";
+import { f as getCurrentComponentInstance } from "../component-scope-4I3yEMkb.js";
 //#region src/fx/timing.ts
 /**
 * Debounce — delay execution, coalesce rapid calls
@@ -263,6 +263,7 @@ function enqueueUserCallback(fn) {
 		}
 	});
 }
+/** Wrap an event handler so rapid events are coalesced and delayed by `ms`. */
 function debounceEvent(ms, handler, options) {
 	const { leading = false, trailing = true } = options || {};
 	const inst = getCurrentComponentInstance();
@@ -309,6 +310,7 @@ function debounceEvent(ms, handler, options) {
 	});
 	return debounced;
 }
+/** Wrap an event handler so it runs at most once per `ms` interval. */
 function throttleEvent(ms, handler, options) {
 	const { leading = true, trailing = true } = options || {};
 	const inst = getCurrentComponentInstance();
@@ -347,6 +349,7 @@ function throttleEvent(ms, handler, options) {
 	if (inst) (inst.cleanupFns ??= []).push(() => throttled.cancel());
 	return throttled;
 }
+/** Wrap an event handler so it runs at most once per animation frame, using the latest event. */
 function rafEvent(handler) {
 	const inst = getCurrentComponentInstance();
 	if (inst && inst.ssr) return noopEventListener;
@@ -378,6 +381,7 @@ function rafEvent(handler) {
 	if (inst) (inst.cleanupFns ??= []).push(() => fn.cancel());
 	return fn;
 }
+/** Schedule `fn` after `ms`, auto-cancelling on component cleanup; returns a cancel function. */
 function scheduleTimeout(ms, fn) {
 	throwIfDuringRender();
 	const inst = getCurrentComponentInstance();
@@ -395,6 +399,7 @@ function scheduleTimeout(ms, fn) {
 	if (inst) (inst.cleanupFns ??= []).push(cancel);
 	return cancel;
 }
+/** Schedule `fn` during browser idle time, auto-cancelling on component cleanup. */
 function scheduleIdle(fn, options) {
 	throwIfDuringRender();
 	const inst = getCurrentComponentInstance();
@@ -421,6 +426,7 @@ function scheduleIdle(fn, options) {
 	if (inst) (inst.cleanupFns ??= []).push(cancel);
 	return cancel;
 }
+/** Run `fn`, retrying with backoff on failure, auto-cancelling on component cleanup. */
 function scheduleRetry(fn, options) {
 	throwIfDuringRender();
 	const inst = getCurrentComponentInstance();

package/dist/{index-Cf2ANwPL.d.ts → index-C29SEGIv.d.ts}

@@ -1,6 +1,5 @@
-import { u as RenderableChild } from "./control-D-FIa-n-.js";
-import { r as JSXElement } from "./jsx-BYXe_Nnk.js";
-import "./types-CsPtBGWb.js";
+import { rn as RenderableChild } from "./index-KQ7Vl4-8.js";
+import { r as JSXElement } from "./types-DkVJhVs9.js";
 //#region src/foundations/structures/layout.d.ts
 /**
  * Layout helper.
@@ -25,16 +24,24 @@ import "./types-CsPtBGWb.js";
  *    Props are spread into the layout component. This is intentional
  *    and deterministic — no merging or composition.
  */
+/** A component that receives its route children via `props.children`. */
 type LayoutComponent<P = object> = (props: P & {
   children?: RenderableChild;
 }) => unknown;
+/**
+ * Wrap a {@link LayoutComponent} so it can be invoked as `(children, props)`,
+ * matching route layout conventions.
+ */
 declare function layout<P = object>(Layout: LayoutComponent<P>): (children?: RenderableChild, props?: P) => unknown;
 //#endregion
 //#region src/jsx/utils.d.ts
+/** Check whether `value` is a JSX element vnode. */
 declare function isElement(value: unknown): value is JSXElement;
+/** Clone a JSX element, shallow-merging `props` over its existing props. */
 declare function cloneElement(element: JSXElement, props: Record<string, unknown>): JSXElement;
 //#endregion
 //#region src/foundations/structures/slot.d.ts
+/** Props for {@link Slot}: `asChild` selects prop-merging vs. fragment mode. */
 type SlotProps = {
   asChild: true;
   children: JSXElement;
@@ -66,7 +73,9 @@ type SlotProps = {
 declare function Slot(props: SlotProps): JSXElement | null;
 //#endregion
 //#region src/foundations/structures/presence.d.ts
+/** Props for {@link Presence}. */
 interface PresenceProps {
+  /** Whether the children should be mounted, or a function returning it. */
   present: boolean | (() => boolean);
   children?: RenderableChild;
 }
@@ -96,17 +105,28 @@ interface PresenceProps {
 declare function Presence({ present, children }: PresenceProps): JSXElement | null;
 //#endregion
 //#region src/runtime/portal.d.ts
+/**
+ * A named portal channel created by {@link definePortal}: call it as a
+ * component to render the host, and call `.render(props)` to write content.
+ */
 interface Portal<T extends RenderableChild = RenderableChild> {
   (): T | JSXElement | null | undefined;
   render(props: {
     children?: T;
   }): unknown;
 }
+/** Props for the {@link Portal} component. */
 interface PortalProps {
   children?: RenderableChild;
 }
+/** Create a new named {@link Portal} channel with its own host and content. */
 declare function definePortal<T extends RenderableChild = RenderableChild>(): Portal<T>;
+/**
+ * The implicit portal channel that {@link Portal} writes to and that any
+ * host rendered without an explicit portal falls back to.
+ */
 declare const DefaultPortal: Portal<RenderableChild>;
+/** Write children to the {@link DefaultPortal} host wherever it is rendered. */
 declare function Portal(props: PortalProps): JSXElement | null;
 //#endregion
 //#region src/foundations/structures/collection.d.ts
@@ -134,10 +154,12 @@ declare function Portal(props: PortalProps): JSXElement | null;
  *   const allItems = collection.items();
  *   unregister();
  */
+/** A registered node paired with its metadata inside a {@link Collection}. */
 type CollectionItem<TNode, TMetadata = unknown> = {
   node: TNode;
   metadata: TMetadata;
 };
+/** Ordered descendant registry returned by {@link createCollection}. */
 interface Collection<TNode, TMetadata = unknown> {
   /**
    * Register a node with optional metadata.
@@ -157,6 +179,7 @@ interface Collection<TNode, TMetadata = unknown> {
    */
   size(): number;
 }
+/** Create an empty, insertion-ordered {@link Collection} registry. */
 declare function createCollection<TNode, TMetadata = unknown>(): Collection<TNode, TMetadata>;
 /**
  * USAGE EXAMPLE:
@@ -208,6 +231,7 @@ declare function createCollection<TNode, TMetadata = unknown>(): Collection<TNod
  *   layer.isTop(); // true if this is the topmost layer
  *   layer.unregister();
  */
+/** Options for registering a layer with {@link LayerManager.register}. */
 interface LayerOptions {
   /**
    * Called when Escape is pressed and this is the top layer
@@ -222,6 +246,7 @@ interface LayerOptions {
    */
   node?: Node | null;
 }
+/** A registered layer entry returned by {@link LayerManager.register}. */
 interface Layer {
   /**
    * Unique layer ID
@@ -236,6 +261,7 @@ interface Layer {
    */
   unregister(): void;
 }
+/** Stacking coordinator returned by {@link createLayer}. */
 interface LayerManager {
   /**
    * Register a new layer
@@ -254,6 +280,7 @@ interface LayerManager {
    */
   handleOutsidePointer(e: PointerEvent): void;
 }
+/** Create a new, empty {@link LayerManager} for coordinating overlay stacking. */
 declare function createLayer(): LayerManager;
 /**
  * USAGE EXAMPLE:

package/dist/{index-BnU0NPwM.d.ts → index-CzH-0LcA.d.ts}

@@ -1,17 +1,22 @@
 //#region src/foundations/utilities/event-types.d.ts
+/** Minimal shape of an event that can be prevented from its default action. */
 interface DefaultPreventable {
   defaultPrevented?: boolean;
   preventDefault?: () => void;
 }
+/** Minimal shape of an event whose propagation can be stopped. */
 interface PropagationStoppable {
   stopPropagation?: () => void;
 }
+/** Structural subset of a keyboard event, for handlers that accept native or synthetic events. */
 interface KeyboardLikeEvent extends DefaultPreventable, PropagationStoppable {
   key: string;
 }
+/** Structural subset of a pointer event, for handlers that accept native or synthetic events. */
 interface PointerLikeEvent extends DefaultPreventable, PropagationStoppable {
   target?: unknown;
 }
+/** Structural subset of a focus event, for handlers that accept native or synthetic events. */
 interface FocusLikeEvent extends DefaultPreventable, PropagationStoppable {
   relatedTarget?: unknown;
 }
@@ -42,6 +47,7 @@ interface FocusLikeEvent extends DefaultPreventable, PropagationStoppable {
  * 4. Type Safety
  *    Args are readonly to prevent mutation. Return type matches input.
  */
+/** Options for {@link composeHandlers}. */
 interface ComposeHandlersOptions {
   /**
    * When true (default), do not run the second handler if the first prevented default.
@@ -49,26 +55,38 @@ interface ComposeHandlersOptions {
    */
   checkDefaultPrevented?: boolean;
 }
+/**
+ * Compose two optional event handlers into one, running `first` then
+ * `second` unless `first` marked the event as default-prevented.
+ */
 declare function composeHandlers<A extends readonly unknown[]>(first?: (...args: A) => void, second?: (...args: A) => void, options?: ComposeHandlersOptions): (...args: A) => void;
 //#endregion
 //#region src/foundations/utilities/merge-props.d.ts
+/**
+ * Merge `base` props over `injected` props: non-handler keys in `base` win,
+ * and matching event handlers are composed (`injected` runs first).
+ */
 declare function mergeProps<TBase extends object, TInjected extends object>(base: TBase, injected: TInjected): TInjected & TBase;
 //#endregion
 //#region src/foundations/utilities/aria.d.ts
 /**
  * Tiny aria helpers
  */
+/** Build an `aria-disabled` prop object; omitted entirely when `disabled` is falsy. */
 declare function ariaDisabled(disabled?: boolean): {
   'aria-disabled'?: 'true';
 };
+/** Build an `aria-expanded` prop object; omitted when `expanded` is `undefined`. */
 declare function ariaExpanded(expanded?: boolean): {
   'aria-expanded'?: 'true' | 'false';
 };
+/** Build an `aria-selected` prop object; omitted when `selected` is `undefined`. */
 declare function ariaSelected(selected?: boolean): {
   'aria-selected'?: 'true' | 'false';
 };
 //#endregion
 //#region src/foundations/utilities/use-id.d.ts
+/** Options for {@link formatId}. */
 interface FormatIdOptions {
   /** Defaults to 'askr' */
   prefix?: string;