@askrjs/askr 0.0.52 → 0.0.53

package/dist/data/types.d.ts

@@ -1,160 +0,0 @@
-//#region src/data/types.d.ts
-type QueryConsistency = 'fresh' | 'stale' | 'refreshing' | 'pending-write';
-type QueryStaleReason = 'aborted' | 'error' | 'inconsistent';
-interface DataRuntime {
-  readonly queryCache: Map<string, unknown>;
-}
-interface DataRuntimeOptions {
-  queryCache?: Map<string, unknown>;
-}
-interface InvalidateOptions {
-  markPendingWrite?: boolean;
-  runtime?: DataRuntime;
-}
-interface InvalidateOnIntervalOptions extends InvalidateOptions {
-  intervalMs: number;
-  activeOn?: string | readonly string[];
-  visibleOnly?: boolean;
-  focusedOnly?: boolean;
-}
-type QueryKeyPart = string | number | boolean | null | undefined | readonly QueryKeyPart[] | {
-  readonly [key: string]: QueryKeyPart;
-};
-interface QueryScope {
-  key(...parts: QueryKeyPart[]): string;
-  prefix(...parts: QueryKeyPart[]): string;
-  invalidate(parts: readonly QueryKeyPart[], options?: InvalidateOptions): void;
-}
-type QueryControls = {
-  refresh(): Promise<void>;
-};
-type QueryLoading = {
-  data: null;
-  error: null;
-  loading: true;
-  refreshing: false;
-  stale: false;
-  consistency: 'fresh';
-  staleReason: null;
-};
-type QueryFresh<T> = {
-  data: T;
-  error: null;
-  loading: false;
-  refreshing: false;
-  stale: false;
-  consistency: 'fresh';
-  staleReason: null;
-};
-type QueryRefreshing<T> = {
-  data: T;
-  error: null;
-  loading: false;
-  refreshing: true;
-  stale: true;
-  consistency: 'refreshing';
-  staleReason: null;
-};
-type QueryPendingWrite<T> = {
-  data: T;
-  error: null;
-  loading: false;
-  refreshing: true;
-  stale: true;
-  consistency: 'pending-write';
-  staleReason: null;
-};
-type QueryStaleValue<T> = {
-  data: T;
-  error: null;
-  loading: false;
-  refreshing: false;
-  stale: true;
-  consistency: 'stale';
-  staleReason: 'aborted' | 'inconsistent';
-};
-type QueryStaleErrorWithValue<T> = {
-  data: T;
-  error: {};
-  loading: false;
-  refreshing: false;
-  stale: true;
-  consistency: 'stale';
-  staleReason: 'error';
-};
-type QueryStaleError = {
-  data: null;
-  error: {};
-  loading: false;
-  refreshing: false;
-  stale: true;
-  consistency: 'stale';
-  staleReason: 'error';
-};
-type Query<T extends {}> = QueryControls & (QueryLoading | QueryFresh<T> | QueryRefreshing<T> | QueryPendingWrite<T> | QueryStaleValue<T> | QueryStaleErrorWithValue<T> | QueryStaleError);
-type MutationControls<TInput, TResult> = {
-  execute(input: TInput): Promise<TResult>;
-  abort(): void;
-  reset(): void;
-};
-type MutationIdle = {
-  status: 'idle';
-  pending: false;
-  error: null;
-  result: null;
-};
-type MutationPending = {
-  status: 'pending';
-  pending: true;
-  error: null;
-  result: null;
-};
-type MutationSuccess<TResult> = {
-  status: 'success';
-  pending: false;
-  error: null;
-  result: TResult;
-};
-type MutationError = {
-  status: 'error';
-  pending: false;
-  error: {};
-  result: null;
-};
-type Mutation<TInput, TResult> = MutationControls<TInput, TResult> & (MutationIdle | MutationPending | MutationSuccess<TResult> | MutationError);
-type MutationRecord<TResult> = {
-  status: 'idle' | 'pending' | 'success' | 'error';
-  error: {} | null;
-  result: TResult | null;
-};
-type QueryOptions<T> = {
-  key: string;
-  fetch: (ctx: {
-    signal: AbortSignal;
-  }) => Promise<T>;
-  isConsistent?: (data: T) => boolean;
-  reconcile?: (data: T, ctx: {
-    key: string;
-  }) => Promise<boolean> | boolean;
-  runtime?: DataRuntime;
-};
-type MutationOptions<TInput, TResult> = {
-  action: (input: TInput, ctx: {
-    signal: AbortSignal;
-  }) => Promise<TResult>;
-  affects?: (input: TInput, result: TResult) => string[];
-  afterSuccess?: 'invalidate';
-  runtime?: DataRuntime;
-};
-type QueryState<T> = {
-  data: T | null;
-  error: {} | null;
-  loading: boolean;
-  refreshing: boolean;
-  stale: boolean;
-  consistency: QueryConsistency;
-  staleReason: QueryStaleReason | null;
-};
-type QueryDefinitionField = 'fetch' | 'isConsistent' | 'reconcile';
-//#endregion
-export { DataRuntime, DataRuntimeOptions, InvalidateOnIntervalOptions, InvalidateOptions, Mutation, MutationOptions, Query, QueryConsistency, QueryKeyPart, QueryOptions, QueryScope, QueryStaleReason, QueryState };

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

@@ -1,52 +0,0 @@
-import { JSXElement } from "../../common/jsx.js";
-import { IconProps, IconSizeToken, IconStyleObject } from "./icon.types.js";
-
-//#region src/foundations/icon/icon.d.ts
-declare function isIconSizeToken(value: unknown): value is IconSizeToken;
-declare function normalizeIconSizeValue(size: number | string): string;
-declare function resolveIconSizeVariable(size: number | string): string;
-declare function resolveIconStrokeWidthVariable(strokeWidth: number, sizeToken: IconSizeToken | undefined): string;
-declare function serializeIconStyle(style: string | IconStyleObject | undefined): string;
-declare function joinIconStyle(...styles: Array<string | undefined>): string | undefined;
-declare function getIconContractProps({
-  size,
-  strokeWidth,
-  color,
-  title,
-  style,
-  iconName
-}: Pick<IconProps, 'color' | 'iconName' | 'size' | 'strokeWidth' | 'style' | 'title'>): {
-  sizeToken: IconSizeToken | undefined;
-  decorative: string | undefined;
-  iconStyle: string | undefined;
-  attrs: {
-    xmlns: string;
-    width: string;
-    height: string;
-    fill: string;
-    stroke: string;
-    'stroke-width': string;
-    role: string;
-    'aria-hidden': string | undefined;
-    style: string | undefined;
-    'data-slot': string;
-    'data-icon': string | undefined;
-    'data-size': IconSizeToken | undefined;
-    'data-decorative': string | undefined;
-    'data-color': string | undefined;
-  };
-};
-declare function IconBase({
-  size,
-  strokeWidth,
-  color,
-  title,
-  class: className,
-  style,
-  iconName,
-  children,
-  ref,
-  ...rest
-}: IconProps): JSXElement;
-//#endregion
-export { IconBase, getIconContractProps, isIconSizeToken, joinIconStyle, normalizeIconSizeValue, resolveIconSizeVariable, resolveIconStrokeWidthVariable, serializeIconStyle };

package/dist/foundations/icon/icon.js

@@ -1,86 +0,0 @@
-import { jsx, jsxs } from "../../jsx-runtime.js";
-//#region src/foundations/icon/icon.tsx
-const ICON_SIZE_TOKENS = [
-	"sm",
-	"md",
-	"lg",
-	"xl"
-];
-function isIconSizeToken(value) {
-	return typeof value === "string" && ICON_SIZE_TOKENS.includes(value);
-}
-function normalizeIconSizeValue(size) {
-	if (typeof size === "number") return `${size}px`;
-	return size;
-}
-function resolveIconSizeVariable(size) {
-	if (isIconSizeToken(size)) return `var(--ak-icon-size-${size}, var(--ak-icon-size-md, 1.25rem))`;
-	return normalizeIconSizeValue(size);
-}
-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})`;
-}
-function camelToKebab(key) {
-	return key.replace(/([A-Z])/g, (match) => `-${match.toLowerCase()}`);
-}
-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(";");
-}
-function joinIconStyle(...styles) {
-	const merged = styles.map((style) => style?.trim()).filter(Boolean);
-	return merged.length > 0 ? merged.join(";") : void 0;
-}
-function getIconContractProps({ size = 20, strokeWidth = 2, color = "currentColor", title, style, iconName }) {
-	const sizeToken = isIconSizeToken(size) ? size : void 0;
-	const decorative = title ? void 0 : "true";
-	const resolvedSize = resolveIconSizeVariable(size);
-	const resolvedStrokeWidth = resolveIconStrokeWidthVariable(strokeWidth, sizeToken);
-	const iconStyle = joinIconStyle(`--ak-icon-size:${resolvedSize}`, `--ak-icon-stroke-width:${resolvedStrokeWidth}`, "display:inline-block", "flex-shrink:0", "width:var(--ak-icon-size)", "height:var(--ak-icon-size)", "stroke-width:var(--ak-icon-stroke-width)", serializeIconStyle(style));
-	return {
-		sizeToken,
-		decorative,
-		iconStyle,
-		attrs: {
-			xmlns: "http://www.w3.org/2000/svg",
-			width: "24",
-			height: "24",
-			fill: "none",
-			stroke: color,
-			"stroke-width": "var(--ak-icon-stroke-width)",
-			role: "img",
-			"aria-hidden": title ? void 0 : "true",
-			style: iconStyle,
-			"data-slot": "icon",
-			"data-icon": iconName,
-			"data-size": sizeToken,
-			"data-decorative": decorative,
-			"data-color": color === "currentColor" ? "current" : void 0
-		}
-	};
-}
-function IconBase({ size = 20, strokeWidth = 2, color = "currentColor", title, class: className, style, iconName, children, ref, ...rest }) {
-	const { attrs } = getIconContractProps({
-		size,
-		strokeWidth,
-		color,
-		title,
-		style,
-		iconName
-	});
-	const finalChildren = title ? [jsx("title", { children: title }), children] : children;
-	return jsxs("svg", {
-		...rest,
-		...attrs,
-		viewBox: rest.viewBox ?? "0 0 24 24",
-		"stroke-linecap": rest["stroke-linecap"] ?? "round",
-		"stroke-linejoin": rest["stroke-linejoin"] ?? "round",
-		class: className,
-		ref,
-		children: finalChildren
-	});
-}
-//#endregion
-export { IconBase, getIconContractProps, isIconSizeToken, joinIconStyle, normalizeIconSizeValue, resolveIconSizeVariable, resolveIconStrokeWidthVariable, serializeIconStyle };

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

@@ -1,21 +0,0 @@
-import { Props } from "../../common/props.js";
-import { Ref } from "../utilities/compose-ref.js";
-
-//#region src/foundations/icon/icon.types.d.ts
-type IconSizeToken = 'sm' | 'md' | 'lg' | 'xl';
-type IconStyleObject = Record<string, unknown>;
-type IconOwnProps = {
-  size?: number | string;
-  strokeWidth?: number;
-  color?: string;
-  title?: string;
-  class?: string;
-  style?: string | IconStyleObject;
-  iconName?: string;
-};
-type IconProps = Omit<Props, 'children' | 'class' | 'color' | 'height' | 'ref' | 'role' | 'stroke' | 'stroke-width' | 'style' | 'title' | 'width'> & IconOwnProps & {
-  children?: unknown;
-  ref?: Ref<SVGSVGElement>;
-};
-//#endregion
-export { IconOwnProps, IconProps, IconSizeToken, IconStyleObject };

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

@@ -1,71 +0,0 @@
-import { KeyboardLikeEvent, PointerLikeEvent } from "../utilities/event-types.js";
-
-//#region src/foundations/interactions/dismissable.d.ts
-/**
- * dismissable
- *
- * THE dismissal primitive. Handles Escape key and outside interactions.
- *
- * INVARIANTS:
- * 1. Returns props that compose via mergeProps (no factories)
- * 2. Disabled state respected exactly once, here
- * 3. No side effects - pure props generation
- * 4. Outside detection requires explicit node reference
- * 5. This is the ONLY dismissal primitive - do not create alternatives
- *
- * DESIGN:
- * - Returns standard event handler props (onKeyDown, onPointerDownCapture)
- * - Composable via mergeProps with other foundations
- * - Caller provides the protected node reference for outside detection
- * - Returned capture props must be attached to a surface that can observe both
- *   the protected subtree and the outside interaction path (for example, an
- *   overlay or wrapper around the protected node)
- * - Single onDismiss callback for all dismiss triggers
- *
- * PIT OF SUCCESS:
- * ✓ Can't accidentally bypass (only way to get dismiss behavior)
- * ✓ Can't duplicate (disabled checked once)
- * ✓ Composes via mergeProps (standard props)
- * ✓ Wrong usage is hard (no factories to misuse)
- *
- * USAGE:
- *   const props = dismissable({
- *     node: elementRef,
- *     disabled: false,
- *     onDismiss: () => close()
- *   });
- *
- *   <div {...props}>
- *     <div ref={elementRef}>Content</div>
- *   </div>
- *
- * MISUSE EXAMPLE (PREVENTED):
- *   ❌ Can't forget to check disabled - checked inside dismissable
- *   ❌ Can't create custom escape handler - this is the only one
- *   ❌ Can't bypass via direct event listeners - mergeProps composes correctly
- */
-interface DismissableOptions {
-  /**
-   * Reference to the protected element for outside click detection. Attach the
-   * returned capture props to a surface that encloses this node.
-   */
-  node?: Node | null;
-  /**
-   * Whether dismiss is disabled
-   */
-  disabled?: boolean;
-  /**
-   * Called when dismiss is triggered (Escape or outside click)
-   */
-  onDismiss?: (trigger: 'escape' | 'outside') => void;
-}
-declare function dismissable({
-  node,
-  disabled,
-  onDismiss
-}: DismissableOptions): {
-  onKeyDown: (e: KeyboardLikeEvent) => void;
-  onPointerDownCapture: (e: PointerLikeEvent) => void;
-};
-//#endregion
-export { DismissableOptions, dismissable };

package/dist/foundations/interactions/dismissable.js

@@ -1,24 +0,0 @@
-//#region src/foundations/interactions/dismissable.ts
-function dismissable({ node, disabled, onDismiss }) {
-	function handleKeyDown(e) {
-		if (disabled) return;
-		if (e.key === "Escape") {
-			e.preventDefault?.();
-			e.stopPropagation?.();
-			onDismiss?.("escape");
-		}
-	}
-	function handlePointerDownCapture(e) {
-		if (disabled) return;
-		const target = e.target;
-		if (!(target instanceof Node)) return;
-		if (!node) return;
-		if (!node.contains(target)) onDismiss?.("outside");
-	}
-	return {
-		onKeyDown: handleKeyDown,
-		onPointerDownCapture: handlePointerDownCapture
-	};
-}
-//#endregion
-export { dismissable };

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

@@ -1,21 +0,0 @@
-//#region src/foundations/interactions/focusable.d.ts
-/**
- * focusable
- *
- * Normalize focus-related props for hosts.
- * - No DOM manipulation here; returns props that the runtime may attach.
- */
-interface FocusableOptions {
-  disabled?: boolean;
-  tabIndex?: number | undefined;
-}
-interface FocusableResult {
-  tabIndex?: number;
-  'aria-disabled'?: 'true';
-}
-declare function focusable({
-  disabled,
-  tabIndex
-}: FocusableOptions): FocusableResult;
-//#endregion
-export { FocusableOptions, FocusableResult, focusable };

package/dist/foundations/interactions/focusable.js

@@ -1,16 +0,0 @@
-import { ariaDisabled } from "../utilities/aria.js";
-//#region src/foundations/interactions/focusable.ts
-/**
-* focusable
-*
-* Normalize focus-related props for hosts.
-* - No DOM manipulation here; returns props that the runtime may attach.
-*/
-function focusable({ disabled, tabIndex }) {
-	return {
-		tabIndex: disabled ? -1 : tabIndex === void 0 ? 0 : tabIndex,
-		...ariaDisabled(disabled)
-	};
-}
-//#endregion
-export { focusable };

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

@@ -1,25 +0,0 @@
-import { DefaultPreventable, PropagationStoppable } from "../utilities/event-types.js";
-
-//#region src/foundations/interactions/hoverable.d.ts
-/**
- * hoverable
- *
- * Produces props for pointer enter/leave handling. Pure and deterministic.
- */
-interface HoverableOptions {
-  disabled?: boolean;
-  onEnter?: (e: HoverEvent) => void;
-  onLeave?: (e: HoverEvent) => void;
-}
-type HoverEvent = DefaultPreventable & PropagationStoppable;
-interface HoverableResult {
-  onPointerEnter?: (e: HoverEvent) => void;
-  onPointerLeave?: (e: HoverEvent) => void;
-}
-declare function hoverable({
-  disabled,
-  onEnter,
-  onLeave
-}: HoverableOptions): HoverableResult;
-//#endregion
-export { HoverableOptions, HoverableResult, hoverable };

package/dist/foundations/interactions/hoverable.js

@@ -1,13 +0,0 @@
-//#region src/foundations/interactions/hoverable.ts
-function hoverable({ disabled, onEnter, onLeave }) {
-	return {
-		onPointerEnter: disabled ? void 0 : (e) => {
-			onEnter?.(e);
-		},
-		onPointerLeave: disabled ? void 0 : (e) => {
-			onLeave?.(e);
-		}
-	};
-}
-//#endregion
-export { hoverable };

package/dist/foundations/interactions/interaction-policy.d.ts

@@ -1,49 +0,0 @@
-import { Ref } from "../utilities/compose-ref.js";
-import { DefaultPreventable, KeyboardLikeEvent, PropagationStoppable } from "../utilities/event-types.js";
-//#region src/foundations/interactions/interaction-policy.d.ts
-interface InteractionPolicyInput {
-  /** Whether the host element is a native interactive element (button, a, etc) */
-  isNative: boolean;
-  /** Disabled state - checked ONLY here, never in components */
-  disabled: boolean;
-  /** User-provided press handler - semantic action, not DOM event */
-  onPress?: (e: Event) => void;
-  /** Optional ref to compose */
-  ref?: Ref<unknown>;
-}
-/**
- * THE interaction policy. Components MUST use this, NEVER implement
- * interaction logic directly.
- */
-declare function applyInteractionPolicy({
-  isNative,
-  disabled,
-  onPress,
-  ref
-}: InteractionPolicyInput): {
-  disabled: true | undefined;
-  onClick: (e: Event) => void;
-  ref: Ref<unknown>;
-} | {
-  tabIndex: number;
-  ref: Ref<unknown>;
-  'aria-disabled'?: "true";
-  onClick: (e: DefaultPreventable & PropagationStoppable) => void;
-  disabled?: true;
-  role?: "button";
-  onKeyDown?: (e: KeyboardLikeEvent) => void;
-  onKeyUp?: (e: KeyboardLikeEvent) => void;
-};
-/**
- * Merge rule for Slot / asChild
- *
- * Precedence:
- *   policy → user → child
- *
- * Event handlers are composed (policy first).
- * Refs are always composed.
- * Policy props MUST take precedence to enforce invariants.
- */
-declare function mergeInteractionProps(childProps: Record<string, unknown>, policyProps: Record<string, unknown>, userProps?: Record<string, unknown>): Record<string, unknown>;
-//#endregion
-export { InteractionPolicyInput, applyInteractionPolicy, mergeInteractionProps };

package/dist/foundations/interactions/interaction-policy.js

@@ -1,120 +0,0 @@
-import { composeHandlers } from "../utilities/compose-handlers.js";
-import { mergeProps } from "../utilities/merge-props.js";
-import { ariaDisabled } from "../utilities/aria.js";
-import { composeRefs } from "../utilities/compose-ref.js";
-import { pressable } from "./pressable.js";
-//#region src/foundations/interactions/interaction-policy.ts
-/**
-* INTERACTION POLICY (FRAMEWORK LAW)
-*
-* This is THE ONLY way to create interactive elements. Components MUST NOT
-* implement interaction logic directly.
-*
-* INVARIANTS (ENFORCED):
-* 1. "Press" is the semantic. Click/touch/Enter/Space are implementation details.
-* 2. Disabled is enforced exactly once, here. Components may not check disabled.
-* 3. Keyboard handling is automatic. Components may not add onKeyDown for activation.
-* 4. Native elements opt out of polyfills, not semantics.
-* 5. asChild may replace the host element, not interaction behavior.
-* 6. This policy is the SINGLE SOURCE OF TRUTH for interactive behavior.
-*
-* DESIGN:
-* - Single public function: applyInteractionPolicy
-* - Returns props that compose via mergeProps
-* - Delegates to pressable for mechanics
-* - Enforces disabled once and only once
-* - No configuration beyond disabled and native element type
-*
-* PIT OF SUCCESS:
-* ✓ Can't bypass policy (only way to get interaction behavior)
-* ✓ Can't duplicate disabled checks (enforced once, here)
-* ✓ Can't write custom keyboard handlers for buttons (policy owns it)
-* ✓ Composes via mergeProps (standard props)
-* ✓ Wrong usage is impossible (no escape hatch)
-*
-* USAGE:
-*   function Button({ onPress, disabled }) {
-*     const interaction = applyInteractionPolicy({
-*       isNative: true,
-*       disabled,
-*       onPress
-*     });
-*
-*     return <button {...interaction}>Click me</button>;
-*   }
-*
-* MISUSE EXAMPLE (PREVENTED):
-*   ❌ Button checking disabled again:
-*      function Button({ disabled, onPress }) {
-*        if (disabled) return; // NO! Policy handles this
-*        const interaction = applyInteractionPolicy(...);
-*      }
-*
-*   ❌ Custom keyboard handler:
-*      function Button({ onPress }) {
-*        const interaction = applyInteractionPolicy(...);
-*        return <button {...interaction} onKeyDown={...}>; // NO! Policy owns this
-*      }
-*
-*   ❌ Direct event handler:
-*      <button onClick={onPress}>; // NO! Use applyInteractionPolicy
-*/
-/**
-* THE interaction policy. Components MUST use this, NEVER implement
-* interaction logic directly.
-*/
-function applyInteractionPolicy({ isNative, disabled, onPress, ref }) {
-	function invokePress(e) {
-		if (disabled) {
-			e.preventDefault?.();
-			return;
-		}
-		onPress?.(e);
-	}
-	if (isNative) return {
-		disabled: disabled || void 0,
-		onClick: (e) => invokePress(e),
-		ref
-	};
-	const interaction = pressable({
-		disabled,
-		isNativeButton: false,
-		onPress: (e) => invokePress(e)
-	});
-	return {
-		...interaction,
-		...ariaDisabled(disabled),
-		tabIndex: disabled ? -1 : interaction.tabIndex ?? 0,
-		ref
-	};
-}
-/**
-* Merge rule for Slot / asChild
-*
-* Precedence:
-*   policy → user → child
-*
-* Event handlers are composed (policy first).
-* Refs are always composed.
-* Policy props MUST take precedence to enforce invariants.
-*/
-function mergeInteractionProps(childProps, policyProps, userProps) {
-	const out = mergeProps(policyProps, userProps ? mergeProps(userProps, childProps) : childProps);
-	for (const k in out) {
-		if (!k.startsWith("on")) continue;
-		const policyHandler = policyProps?.[k];
-		const userHandler = userProps?.[k];
-		const childHandler = childProps?.[k];
-		if (policyHandler || userHandler || childHandler) {
-			const toHandler = (h) => typeof h === "function" ? h : void 0;
-			out[k] = composeHandlers(toHandler(policyHandler), composeHandlers(toHandler(userHandler), toHandler(childHandler)));
-		}
-	}
-	const childRef = childProps?.ref;
-	const userRef = userProps?.ref;
-	const policyRef = policyProps?.ref;
-	out.ref = composeRefs(childRef, userRef, policyRef);
-	return out;
-}
-//#endregion
-export { applyInteractionPolicy, mergeInteractionProps };