@askrjs/askr 0.0.92 → 0.0.95

package/dist/{control-CdzY49Q2.d.ts → control-DdFw-Caz.d.ts}

@@ -1,4 +1,4 @@
-import { s as Props } from "./types-BA9FJtfR.js";
+import { s as Props } from "./types-DkVJhVs9.js";
 //#region src/common/control.d.ts
 declare const EAGER_CONTROL_PRIMITIVE: unique symbol;
 type EagerControlPrimitive<P extends Props = Props> = ((props: P) => unknown) & {

package/dist/{csp-nonce-ByMbWv8s.js → csp-nonce-BVybpV1v.js}

@@ -1,4 +1,4 @@
-import { _ as readScope, d as defineScope } from "./component-internal-DlAkCgBE.js";
+import { p as defineScope, y as readScope } from "./component-internal-D0yE2Ch3.js";
 //#region src/common/url.ts
 const SAFE_URL_SCHEMES = /* @__PURE__ */ new Set([
 	"http",
@@ -35,7 +35,14 @@ function isUnsafeUrlAttribute(key, value) {
 const ROUTE_ROOT_COMPONENT = Symbol.for("askr.route-root-component");
 //#endregion
 //#region src/csp-nonce.ts
+/** Lexical scope carrying the CSP nonce for the current render, if any. */
 const CspNonceScope = defineScope(void 0);
+/**
+* Read the CSP nonce for the current render from {@link CspNonceScope}.
+*
+* @returns The active nonce, or `undefined` when called outside of a
+* component render or when no nonce was configured.
+*/
 function cspNonce() {
 	try {
 		return readScope(CspNonceScope);

package/dist/data/index.d.ts

@@ -1,2 +1,2 @@
-import { A as QueryStaleReason, C as MutationOptions, D as QueryKeyPart, E as QueryDefinition, O as QueryPrefetchContext, S as Mutation, T as QueryConsistency, a as defineServerQueries, b as InvalidateOnIntervalOptions, c as prefetchQuery, d as invalidateOnInterval, f as queryScope, g as createMutation, h as createQuery, i as defineQuery, j as ServerQueryHandler, k as QueryScope, l as serveQuery, m as getDefaultDataRuntime, n as ServerQueryRegistry, o as dehydrateDataRuntime, p as createDataRuntime, r as createQueryPrefetchContext, s as hydrateDataRuntime, t as ServerQueryEntry, u as invalidate, v as DataRuntime, w as Query, x as InvalidateOptions, y as DataRuntimeOptions } from "../index-2bk8nldG.js";
+import { Bt as DataRuntimeOptions, Gt as Query, Ht as InvalidateOptions, Jt as QueryKeyPart, Kt as QueryConsistency, Qt as ServerQueryHandler, S as createMutation, Ut as Mutation, Vt as InvalidateOnIntervalOptions, Wt as MutationOptions, Xt as QueryScope, Yt as QueryPrefetchContext, Zt as QueryStaleReason, _ as invalidateOnInterval, b as getDefaultDataRuntime, c as ServerQueryRegistry, d as defineServerQueries, f as dehydrateDataRuntime, g as invalidate, h as serveQuery, l as createQueryPrefetchContext, m as prefetchQuery, p as hydrateDataRuntime, qt as QueryDefinition, s as ServerQueryEntry, u as defineQuery, v as queryScope, x as createQuery, y as createDataRuntime, zt as DataRuntime } from "../index-CTIBOqUB.js";
 export { type DataRuntime, type DataRuntimeOptions, type InvalidateOnIntervalOptions, type InvalidateOptions, type Mutation, type MutationOptions, type Query, type QueryConsistency, type QueryDefinition, type QueryKeyPart, type QueryPrefetchContext, type QueryScope, type QueryStaleReason, type ServerQueryEntry, type ServerQueryHandler, type ServerQueryRegistry, createDataRuntime, createMutation, createQuery, createQueryPrefetchContext, defineQuery, defineServerQueries, dehydrateDataRuntime, getDefaultDataRuntime, hydrateDataRuntime, invalidate, invalidateOnInterval, prefetchQuery, queryScope, serveQuery };

package/dist/data/index.js

@@ -1,4 +1,4 @@
-import { i as getDefaultDataRuntime, t as createDataRuntime } from "../data-runtime-oIdQWnPW.js";
-import { c as queryScope, n as createMutation, o as invalidate, s as invalidateOnInterval, t as createQuery } from "../data-DcikEH9N.js";
-import { a as hydrateDataRuntime, i as dehydrateDataRuntime, n as defineQuery, o as prefetchQuery, r as defineServerQueries, s as serveQuery, t as createQueryPrefetchContext } from "../query-registry-qm13pEdK.js";
+import { i as getDefaultDataRuntime, t as createDataRuntime } from "../data-runtime-JxoRgrrt.js";
+import { c as queryScope, n as createMutation, o as invalidate, s as invalidateOnInterval, t as createQuery } from "../data-Bm8L6JOm.js";
+import { a as hydrateDataRuntime, i as dehydrateDataRuntime, n as defineQuery, o as prefetchQuery, r as defineServerQueries, s as serveQuery, t as createQueryPrefetchContext } from "../query-registry-CimB1YeW.js";
 export { createDataRuntime, createMutation, createQuery, createQueryPrefetchContext, defineQuery, defineServerQueries, dehydrateDataRuntime, getDefaultDataRuntime, hydrateDataRuntime, invalidate, invalidateOnInterval, prefetchQuery, queryScope, serveQuery };

package/dist/{data-DcikEH9N.js → data-Bm8L6JOm.js}

@@ -1,9 +1,9 @@
-import { n as enqueueRuntimeTask, y as logger } from "./access-DSkccuEI.js";
+import { n as enqueueRuntimeTask, y as logger } from "./access-d_DCdwqn.js";
 import { d as getCurrentAppRenderRuntime, f as getCurrentComponentInstance, i as claimHookIndex } from "./component-scope-4I3yEMkb.js";
-import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-B99wh5Z_.js";
+import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-BsdGWsDE.js";
 import { n as getActiveRenderContext } from "./render-context-B7ohlh6t.js";
-import { i as routeActive, n as documentVisible, o as timer, s as windowFocused } from "./lifecycle-operations-CQ8fsc94.js";
-import { a as getMutationSlotStore, c as resolveDataRuntimeState, i as getDefaultDataRuntime, n as ensureMutationCleanup, o as getQuerySlotStore, r as ensureQueryCleanup, s as invalidateQueriesForRuntime } from "./data-runtime-oIdQWnPW.js";
+import { i as routeActive, n as documentVisible, o as timer, s as windowFocused } from "./lifecycle-operations-CBzG5PyB.js";
+import { a as getMutationSlotStore, c as resolveDataRuntimeState, i as getDefaultDataRuntime, n as ensureMutationCleanup, o as getQuerySlotStore, r as ensureQueryCleanup, s as invalidateQueriesForRuntime } from "./data-runtime-JxoRgrrt.js";
 //#region src/data/query-key.ts
 function serializeQueryKeyNumber(part) {
 	if (Number.isNaN(part)) return "NaN";
@@ -44,13 +44,19 @@ function createQueryScope(namespace, invalidate) {
 }
 //#endregion
 //#region src/data/invalidation.ts
+/** Mark all cached queries whose key starts with `prefix` as stale, triggering a refresh. */
 function invalidate(prefix, options) {
 	invalidateQueriesForRuntime(resolveDataRuntimeState(options?.runtime), prefix, options?.markPendingWrite ?? false);
 }
+/** Create a {@link QueryScope} that namespaces keys and invalidations under `namespace`. */
 function queryScope(namespace) {
 	return createQueryScope(namespace, invalidate);
 }
 const INVALIDATE_ON_INTERVAL_OPTIONS_ERROR = "[Askr] invalidateOnInterval() requires an options object with a finite numeric intervalMs.";
+/**
+* Periodically invalidate queries matching `prefix` on a fixed interval,
+* optionally gated by active route, document visibility, or window focus.
+*/
 function invalidateOnInterval(prefix, options) {
 	if (!options || typeof options !== "object" || typeof options.intervalMs !== "number" || !Number.isFinite(options.intervalMs)) throw new Error(INVALIDATE_ON_INTERVAL_OPTIONS_ERROR);
 	const runtimeState = resolveDataRuntimeState(options.runtime);
@@ -190,6 +196,11 @@ var MutationCell = class {
 		});
 	}
 };
+/**
+* Create a reactive {@link Mutation} cell bound to the current component,
+* running `options.action` on `execute()` and optionally invalidating
+* affected query prefixes on success.
+*/
 function createMutation(options) {
 	if (options.key !== void 0 && options.key.length === 0) throw new TypeError("createMutation key must be a non-empty string.");
 	const instance = getCurrentComponentInstance();

package/dist/{data-runtime-oIdQWnPW.js → data-runtime-JxoRgrrt.js}

@@ -27,6 +27,7 @@ function createDataRuntimeState(queryCache, queryData, queryTestOverrides, mutat
 		mutationTestOverrides
 	};
 }
+/** Create a new, isolated {@link DataRuntime} with its own query/mutation caches. */
 function createDataRuntime(options = {}) {
 	const runtime = Object.freeze({
 		queryCache: options.queryCache ?? /* @__PURE__ */ new Map(),
@@ -39,6 +40,7 @@ function createDataRuntime(options = {}) {
 	return runtime;
 }
 const defaultDataRuntime = createDataRuntime();
+/** Get the process-wide default {@link DataRuntime} used when none is provided explicitly. */
 function getDefaultDataRuntime() {
 	return defaultDataRuntime;
 }

package/dist/{deferred-B6CafO5u.js → deferred-p8hyanxJ.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-B62UQKHV.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-BQyo7qNn.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-DkBwTG4S.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 { _ as haveEquivalentContextFrames, b as rebaseVNodeTreeWithContextFrame, n as createComponentInstance, s as renderScopedComponent } from "./component-internal-D0yE2Ch3.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-DYG80yhG.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-S2IqSJib.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-CPycoyZj.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-CTIBOqUB.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-S2IqSJib.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-CPycoyZj.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-CTIBOqUB.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();