@askrjs/askr 0.0.92 → 0.0.94

package/dist/{deferred-B6CafO5u.js → deferred-BS0Xpstg.js}

@@ -1,9 +1,9 @@
 import { d as getCurrentAppRenderRuntime, f as getCurrentComponentInstance } from "./component-scope-4I3yEMkb.js";
-import { i as getExecutionModel } from "./manifest-Dv0bO6kg.js";
+import { i as getExecutionModel } from "./manifest-D6rfj_jC.js";
 import { n as getActiveRenderContext, r as getCurrentRenderData } from "./render-context-B7ohlh6t.js";
-import { t as resource } from "./resource-operation-CaAttQqz.js";
+import { t as resource } from "./resource-operation-CLQXCn1p.js";
 import { A as getDefaultRouteBasePath, C as getCurrentInheritedPolicies, D as getCurrentPathPrefix, E as getCurrentPageScope, F as insertRecordSorted, H as computeRank, L as pushRegistrationScope, N as hasActivePageScope, O as getCurrentScopeKind, S as getCurrentInheritedMeta, T as getCurrentPageChain, U as normalizeRouteSegmentName, W as parseSegments, g as assertRouteRegistrationUnlocked, h as addRouteToStores, w as getCurrentLayoutChain, x as getCurrentInheritedAuthRequirements } from "./route-matching-Bo6UqG-5.js";
-import { _ as createRouteHandler, d as DEFERRED_BOUNDARY, p as isDeferred, s as guardHydratedRouteData } from "./resolution-B21kmOkp.js";
+import { _ as createRouteHandler, d as DEFERRED_BOUNDARY, p as isDeferred, s as guardHydratedRouteData } from "./resolution-D8PgnTzh.js";
 import { allOf } from "@askrjs/auth";
 //#region src/router/access.ts
 function compileNodePolicies(node) {
@@ -167,12 +167,14 @@ function page(path, Component, optionsOrFn, maybeFn) {
 	if (typeof fn !== "function") throw new Error("page(path, Component, fn) requires a route definition callback as the final argument.");
 	pushPageScope(path, Component, options, fn);
 }
+/** Declare the index route for the enclosing `page()` scope. */
 function index(Component, options) {
 	const pageScope = getCurrentPageScope();
 	if (pageScope?.hasIndex) throw new Error("page() cannot declare multiple index routes.");
 	if (pageScope) pageScope.hasIndex = true;
 	registerRouteAtResolvedPath(resolveIndexPath(), Component, options);
 }
+/** Declare the catch-all `/*` fallback route for the enclosing scope. */
 function fallback(Component) {
 	if (hasActivePageScope()) {
 		if (getCurrentScopeKind() !== "page") throw new Error("fallback() inside page() must be declared directly in the page scope, not inside nested group().");
@@ -225,6 +227,7 @@ function awaitWithSignal(promise, signal) {
 		});
 	});
 }
+/** Recursively await any {@link Deferred} values nested within `input`, returning it once fully resolved. */
 async function resolveDeferredValues(input, signal) {
 	const seen = /* @__PURE__ */ new Set();
 	const visit = async (value) => {
@@ -242,6 +245,7 @@ async function resolveDeferredValues(input, signal) {
 	await visit(input);
 	return input;
 }
+/** Read the current route's server loader data during render or hydration. */
 function routeData() {
 	const envelope = getCurrentRenderData();
 	if (envelope) return guardHydratedRouteData(envelope.route, envelope.framework);
@@ -252,6 +256,7 @@ function routeData() {
 function rejectedChild(props, error) {
 	return typeof props.rejected === "function" ? props.rejected(error) : props.rejected ?? null;
 }
+/** Render a {@link Deferred} value's fulfilled state, a pending placeholder, or a rejected fallback. */
 function Resolve(props) {
 	if (props.value.state === "fulfilled") return props.children(props.value.value);
 	if (props.value.state === "rejected") return rejectedChild(props, props.value.error);

package/dist/{effect-BdZcHblj.js → effect-BdvdgMvV.js}

@@ -1,5 +1,5 @@
-import { t as enqueueRuntimeLane } from "./access-DSkccuEI.js";
-import { m as withFineGrainedReadTracking } from "./readable-B99wh5Z_.js";
+import { t as enqueueRuntimeLane } from "./access-d_DCdwqn.js";
+import { m as withFineGrainedReadTracking } from "./readable-BsdGWsDE.js";
 //#region src/runtime/effect.ts
 const SOURCE_EFFECTS = Symbol("askr.source-effects");
 const effectSources = /* @__PURE__ */ new WeakMap();

package/dist/{fastlane-B2s24fWt.js → fastlane-DGo7SxBQ.js}

@@ -1,6 +1,6 @@
-import { d as setRuntimeBulkCommitProbe, o as getRuntimeRenderer, u as runRuntimeWithSyncProgress, x as isDevelopmentEnvironment } from "./access-DSkccuEI.js";
-import { i as isFragmentType } from "./jsx-C3IECePB.js";
-import { i as finalizeReadableSubscriptions, l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty } from "./readable-B99wh5Z_.js";
+import { d as setRuntimeBulkCommitProbe, o as getRuntimeRenderer, u as runRuntimeWithSyncProgress, x as isDevelopmentEnvironment } from "./access-d_DCdwqn.js";
+import { i as isFragmentType } from "./jsx-DRS-qjiN.js";
+import { i as finalizeReadableSubscriptions, l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty } from "./readable-BsdGWsDE.js";
 //#region src/runtime/dev-namespace.ts
 /**
 * Set a value in the dev namespace (no-op in production).

package/dist/{for-internal-T1C7jd7x.js → for-internal-jrliHZmF.js}

@@ -1,10 +1,10 @@
 import { n as _isDOMElement } from "./vnode-D24p6IW2.js";
-import { o as getRuntimeRenderer, x as isDevelopmentEnvironment, y as logger } from "./access-DSkccuEI.js";
+import { o as getRuntimeRenderer, x as isDevelopmentEnvironment, y as logger } from "./access-d_DCdwqn.js";
 import { h as getCurrentStateIndex, i as claimHookIndex, o as clearRenderTracking, p as getCurrentInstance } from "./component-scope-4I3yEMkb.js";
-import { h as haveEquivalentContextFrames, n as createComponentInstance, s as renderScopedComponent, v as rebaseVNodeTreeWithContextFrame } from "./component-internal-DlAkCgBE.js";
-import { d as shouldCoalesceFineGrainedItemReads, l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-B99wh5Z_.js";
-import { i as unregisterOwnedChildScope, r as registerOwnedChildScope, t as cleanupComponent } from "./component-cleanup-CJCfu5ed.js";
-import { o as finalizeInlineReadSubscriptions, u as registerLifecycleTransaction } from "./lifecycle-batch-Cyfd07rf.js";
+import { h as haveEquivalentContextFrames, n as createComponentInstance, s as renderScopedComponent, v as rebaseVNodeTreeWithContextFrame } from "./component-internal-DOVVMjG7.js";
+import { d as shouldCoalesceFineGrainedItemReads, l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-BsdGWsDE.js";
+import { i as unregisterOwnedChildScope, r as registerOwnedChildScope, t as cleanupComponent } from "./component-cleanup-hrqSikl2.js";
+import { o as finalizeInlineReadSubscriptions, u as registerLifecycleTransaction } from "./lifecycle-batch-BH0fax4F.js";
 //#region src/runtime/child-scope.ts
 const EMPTY_CHILD_SCOPE_PROPS = {};
 const childScopesByInstance = /* @__PURE__ */ new WeakMap();

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

@@ -1,8 +1,11 @@
-import { r as JSXElement, s as Props } from "../../types-BA9FJtfR.js";
-import { t as Ref } from "../../compose-ref-Cizq72-x.js";
+import { r as JSXElement, s as Props } from "../../types-DkVJhVs9.js";
+import { t as Ref } from "../../compose-ref-DOJHoW5X.js";
 //#region src/foundations/icon/icon.types.d.ts
+/** Named icon size presets, mapped to CSS variables at render time. */
 type IconSizeToken = 'sm' | 'md' | 'lg' | 'xl';
+/** Camel-cased CSS style object accepted by icon `style` props. */
 type IconStyleObject = Record<string, unknown>;
+/** Props specific to the icon contract, independent of the underlying `<svg>` props. */
 type IconOwnProps = {
   size?: number | string;
   strokeWidth?: number;
@@ -12,18 +15,26 @@ type IconOwnProps = {
   style?: string | IconStyleObject;
   iconName?: string;
 };
+/** Full prop set accepted by {@link IconBase} and generated icon components. */
 type IconProps = Omit<Props, 'children' | 'class' | 'color' | 'height' | 'ref' | 'role' | 'stroke' | 'stroke-width' | 'style' | 'title' | 'width'> & IconOwnProps & {
   children?: unknown;
   ref?: Ref<SVGSVGElement>;
 };
 //#endregion
 //#region src/foundations/icon/icon.d.ts
+/** 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;
@@ -45,6 +56,7 @@ declare function getIconContractProps({ size, strokeWidth, color, title, style,
     'data-color': string | undefined;
   };
 };
+/** Base `<svg>` wrapper implementing the icon contract; generated icon components render into it. */
 declare function IconBase({ size, strokeWidth, color, title, class: className, style, iconName, children, ref, ...rest }: IconProps): JSXElement;
 //#endregion
 export { IconBase, type IconOwnProps, type IconProps, type IconSizeToken, type IconStyleObject, getIconContractProps, isIconSizeToken, joinIconStyle, normalizeIconSizeValue, resolveIconSizeVariable, resolveIconStrokeWidthVariable, serializeIconStyle };

package/dist/foundations/icon/index.js

@@ -6,17 +6,21 @@ const ICON_SIZE_TOKENS = [
 	"lg",
 	"xl"
 ];
+/** Check whether `value` is one of the named icon size tokens ('sm'|'md'|'lg'|'xl'). */
 function isIconSizeToken(value) {
 	return typeof value === "string" && ICON_SIZE_TOKENS.includes(value);
 }
+/** Normalize a numeric icon size to a `px` string; strings pass through unchanged. */
 function normalizeIconSizeValue(size) {
 	if (typeof size === "number") return `${size}px`;
 	return size;
 }
+/** Resolve a size (token or literal) to a CSS `var(--ak-icon-size-*, ...)` expression or literal value. */
 function resolveIconSizeVariable(size) {
 	if (isIconSizeToken(size)) return `var(--ak-icon-size-${size}, var(--ak-icon-size-md, 1.25rem))`;
 	return normalizeIconSizeValue(size);
 }
+/** Resolve a stroke width to a CSS `var(--ak-icon-stroke-width-*, ...)` expression, scoped to `sizeToken` when given. */
 function resolveIconStrokeWidthVariable(strokeWidth, sizeToken) {
 	if (sizeToken) return `var(--ak-icon-stroke-width-${sizeToken}, var(--ak-icon-stroke-width-md, ${strokeWidth}))`;
 	return `var(--ak-icon-stroke-width-md, ${strokeWidth})`;
@@ -24,15 +28,18 @@ function resolveIconStrokeWidthVariable(strokeWidth, sizeToken) {
 function camelToKebab(key) {
 	return key.replace(/([A-Z])/g, (match) => `-${match.toLowerCase()}`);
 }
+/** Serialize an inline style object (or pass through a string) to a CSS declaration string. */
 function serializeIconStyle(style) {
 	if (!style) return "";
 	if (typeof style === "string") return style.trim();
 	return Object.entries(style).filter(([, value]) => value !== void 0 && value !== null).map(([key, value]) => `${camelToKebab(key)}:${String(value)}`).join(";");
 }
+/** Join non-empty CSS declaration fragments with `;`, dropping any that are blank. */
 function joinIconStyle(...styles) {
 	const merged = styles.map((style) => style?.trim()).filter(Boolean);
 	return merged.length > 0 ? merged.join(";") : void 0;
 }
+/** Compute the shared SVG attributes and inline style implementing the icon size/stroke/color contract. */
 function getIconContractProps({ size = 20, strokeWidth = 2, color = "currentColor", title, style, iconName }) {
 	const sizeToken = isIconSizeToken(size) ? size : void 0;
 	const decorative = title ? void 0 : "true";
@@ -61,6 +68,7 @@ function getIconContractProps({ size = 20, strokeWidth = 2, color = "currentColo
 		}
 	};
 }
+/** Base `<svg>` wrapper implementing the icon contract; generated icon components render into it. */
 function IconBase({ size = 20, strokeWidth = 2, color = "currentColor", title, class: className, style, iconName, children, ref, ...rest }) {
 	const { attrs } = getIconContractProps({
 		size,

package/dist/foundations/index.d.ts

@@ -1,3 +1,3 @@
-import { r as JSXElement } from "../types-BA9FJtfR.js";
-import { c as DefaultPortal, d as definePortal, f as Presence, h as SlotProps, l as Portal, m as Slot, p as PresenceProps, u as PortalProps, v as LayoutComponent, y as layout } from "../index-oswRaMn6.js";
+import { r as JSXElement } from "../types-DkVJhVs9.js";
+import { c as DefaultPortal, d as definePortal, f as Presence, h as SlotProps, l as Portal, m as Slot, p as PresenceProps, u as PortalProps, v as LayoutComponent, y as layout } from "../index-C29SEGIv.js";
 export { DefaultPortal, type JSXElement, type LayoutComponent, Portal, type PortalProps, Presence, type PresenceProps, Slot, type SlotProps, definePortal, layout };

package/dist/foundations/index.js

@@ -1,2 +1,2 @@
-import { a as definePortal, c as layout, i as Portal, o as Presence, r as DefaultPortal, s as Slot } from "../structures-DKjkAmM5.js";
+import { a as definePortal, c as layout, i as Portal, o as Presence, r as DefaultPortal, s as Slot } from "../structures-umvVUD-M.js";
 export { DefaultPortal, Portal, Presence, Slot, definePortal, layout };

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 { Nt as State } from "../../index-DA3g8lm8.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-XPZYUzHL.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-XPZYUzHL.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 "../../types-BA9FJtfR.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-oswRaMn6.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-DKjkAmM5.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,4 +1,4 @@
-import { g as scheduleEventHandler, n as enqueueRuntimeTask, y as logger } from "../access-DSkccuEI.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
 /**
@@ -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-oswRaMn6.d.ts → index-C29SEGIv.d.ts}

@@ -1,5 +1,5 @@
-import { Tt as RenderableChild } from "./index-DA3g8lm8.js";
-import { r as JSXElement } from "./types-BA9FJtfR.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.
@@ -24,16 +24,24 @@ import { r as JSXElement } from "./types-BA9FJtfR.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;
@@ -65,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;
 }
@@ -95,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
@@ -133,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.
@@ -156,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:
@@ -207,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
@@ -221,6 +246,7 @@ interface LayerOptions {
    */
   node?: Node | null;
 }
+/** A registered layer entry returned by {@link LayerManager.register}. */
 interface Layer {
   /**
    * Unique layer ID
@@ -235,6 +261,7 @@ interface Layer {
    */
   unregister(): void;
 }
+/** Stacking coordinator returned by {@link createLayer}. */
 interface LayerManager {
   /**
    * Register a new layer
@@ -253,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: