@askrjs/askr 0.0.92 → 0.0.94

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;