@askrjs/askr 0.0.28 → 0.0.30

package/dist/components/link.js

@@ -1 +1,64 @@
-import{navigate as u}from"../router/navigate.js";import{applyInteractionPolicy as m}from"../foundations/interactions/interaction-policy.js";import{mergeProps as f}from"../foundations/utilities/merge-props.js";import{jsx as p}from"../jsx-runtime.js";function d({href:r,class:a,children:n,rel:i,target:e,"aria-current":o,"aria-label":s}){const l=m({isNative:!0,disabled:!1,onPress:c=>{const t=c;(t.button??0)!==0||t.ctrlKey||t.metaKey||t.shiftKey||t.altKey||e||(t.preventDefault(),u(r))}});return p("a",f(l,{href:r,class:a,rel:i,target:e,"aria-current":o,"aria-label":s,children:n}))}export{d as Link};
+import { jsx } from "../jsx-runtime.js";
+import { navigate } from "../router/navigate.js";
+import { mergeProps } from "../foundations/utilities/merge-props.js";
+import { applyInteractionPolicy } from "../foundations/interactions/interaction-policy.js";
+import "../jsx-runtime2.js";
+//#region src/components/link.tsx
+/**
+* Link component for client-side navigation
+*/
+/**
+* Link component that prevents default navigation and uses navigate()
+* Provides declarative way to navigate between routes
+*
+* Accessibility features:
+* - Proper semantic <a> element (not a button)
+* - Supports aria-current for indicating active page
+* - Supports aria-label for descriptive labels
+* - Keyboard accessible (Enter key handled by native <a> element)
+*
+* Respects native browser behaviors:
+* - Middle-click (opens in new tab)
+* - Ctrl/Cmd+click (opens in new tab)
+* - Shift+click (opens in new window)
+* - Alt+click (downloads link)
+* - Right-click context menu
+*
+* Best practices:
+* - Use target="_blank" with rel="noopener noreferrer" for external links
+* - Use aria-current="page" for the current page in navigation
+* - Provide descriptive link text or aria-label
+*
+* Uses applyInteractionPolicy to enforce pit-of-success principles:
+* - Interaction behavior centralized in foundations
+* - Keyboard handling automatic
+* - Composable via mergeProps
+*/
+function Link({ href, class: className, children, rel, target, "aria-current": ariaCurrent, "aria-label": ariaLabel, ...rest }) {
+	return /* @__PURE__ */ jsx("a", {
+		...mergeProps(rest, {
+			...applyInteractionPolicy({
+				isNative: true,
+				disabled: false,
+				onPress: (e) => {
+					const event = e;
+					if ((event.button ?? 0) !== 0 || event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return;
+					if (target) return;
+					event.preventDefault();
+					navigate(href);
+				}
+			}),
+			href,
+			class: className,
+			rel,
+			target,
+			"aria-current": ariaCurrent,
+			"aria-label": ariaLabel
+		}),
+		children
+	});
+}
+//#endregion
+export { Link };
+
+//# sourceMappingURL=link.js.map

package/dist/components/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","names":[],"sources":["../../src/components/link.tsx"],"sourcesContent":["/**\n * Link component for client-side navigation\n */\n\nimport { navigate } from '../router/navigate';\nimport { applyInteractionPolicy } from '../foundations/interactions/interaction-policy';\nimport { mergeProps } from '../foundations/utilities/merge-props';\n\nexport type LinkProps = Omit<\n  JSX.IntrinsicElements['a'],\n  | 'children'\n  | 'href'\n  | 'class'\n  | 'rel'\n  | 'target'\n  | 'aria-current'\n  | 'aria-label'\n> & {\n  href: string;\n  class?: string;\n  children?: unknown;\n  /**\n   * Optional rel attribute for link relationships.\n   * Common values: \"noopener\", \"noreferrer\", \"nofollow\"\n   */\n  rel?: string;\n  /**\n   * Optional target attribute.\n   * Use \"_blank\" for new tab/window.\n   */\n  target?: string;\n  /**\n   * Optional aria-current attribute for indicating current page/location.\n   * Use \"page\" for the current page in navigation.\n   */\n  'aria-current'?:\n    | 'page'\n    | 'step'\n    | 'location'\n    | 'date'\n    | 'time'\n    | 'true'\n    | 'false';\n  /**\n   * Optional aria-label for accessibility when link text isn't descriptive enough.\n   */\n  'aria-label'?: string;\n};\n\n/**\n * Link component that prevents default navigation and uses navigate()\n * Provides declarative way to navigate between routes\n *\n * Accessibility features:\n * - Proper semantic <a> element (not a button)\n * - Supports aria-current for indicating active page\n * - Supports aria-label for descriptive labels\n * - Keyboard accessible (Enter key handled by native <a> element)\n *\n * Respects native browser behaviors:\n * - Middle-click (opens in new tab)\n * - Ctrl/Cmd+click (opens in new tab)\n * - Shift+click (opens in new window)\n * - Alt+click (downloads link)\n * - Right-click context menu\n *\n * Best practices:\n * - Use target=\"_blank\" with rel=\"noopener noreferrer\" for external links\n * - Use aria-current=\"page\" for the current page in navigation\n * - Provide descriptive link text or aria-label\n *\n * Uses applyInteractionPolicy to enforce pit-of-success principles:\n * - Interaction behavior centralized in foundations\n * - Keyboard handling automatic\n * - Composable via mergeProps\n */\nexport function Link({\n  href,\n  class: className,\n  children,\n  rel,\n  target,\n  'aria-current': ariaCurrent,\n  'aria-label': ariaLabel,\n  ...rest\n}: LinkProps): JSX.Element {\n  const interaction = applyInteractionPolicy({\n    isNative: true,\n    disabled: false,\n    onPress: (e: Event) => {\n      const event = e as MouseEvent;\n\n      // Only intercept left-click without modifiers\n      // Default button to 0 if undefined (for mock events in tests)\n      const button = event.button ?? 0;\n      if (\n        button !== 0 || // not left-click\n        event.ctrlKey || // Ctrl/Cmd+click\n        event.metaKey || // Cmd on Mac\n        event.shiftKey || // Shift+click\n        event.altKey // Alt+click\n      ) {\n        return; // Let browser handle it (new tab, etc.)\n      }\n\n      // Don't intercept external links or explicit target\n      if (target) {\n        return; // Let browser handle it\n      }\n\n      event.preventDefault();\n      navigate(href);\n    },\n  });\n\n  const props = mergeProps(rest, {\n    ...interaction,\n    href,\n    class: className,\n    rel,\n    target,\n    'aria-current': ariaCurrent,\n    'aria-label': ariaLabel,\n  });\n\n  return <a {...props}>{children}</a>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4EA,SAAgB,KAAK,EACnB,MACA,OAAO,WACP,UACA,KACA,QACA,gBAAgB,aAChB,cAAc,WACd,GAAG,QACsB;AAwCzB,QAAO,oBAAC,KAAD;EAAG,GAVI,WAAW,MAAM;GAC7B,GA9BkB,uBAAuB;IACzC,UAAU;IACV,UAAU;IACV,UAAU,MAAa;KACrB,MAAM,QAAQ;AAKd,UADe,MAAM,UAAU,OAElB,KACX,MAAM,WACN,MAAM,WACN,MAAM,YACN,MAAM,OAEN;AAIF,SAAI,OACF;AAGF,WAAM,gBAAgB;AACtB,cAAS,KAAK;;IAEjB,CAGI;GACH;GACA,OAAO;GACP;GACA;GACA,gBAAgB;GAChB,cAAc;GACf,CAEa;EAAQ;EAAa,CAAA"}

package/dist/control/case.d.ts

@@ -0,0 +1,17 @@
+import { JSXElement } from "../common/jsx.js";
+
+//#region src/control/case.d.ts
+type MatchProps = {
+  key?: string | number | null;
+  when: unknown;
+  children: unknown;
+};
+type CaseProps = {
+  fallback?: unknown;
+  children?: unknown;
+};
+declare function Match(_props: MatchProps): null;
+declare const Case: (props: CaseProps) => JSXElement;
+//#endregion
+export { Case, CaseProps, Match, MatchProps };
+//# sourceMappingURL=case.d.ts.map

package/dist/control/case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"case.d.ts","names":[],"sources":["../../src/control/case.ts"],"mappings":";;;KAeY,UAAA;EACV,GAAA;EACA,IAAA;EACA,QAAA;AAAA;AAAA,KAGU,SAAA;EACV,QAAA;EACA,QAAA;AAAA;AAAA,iBAmBc,KAAA,CAAM,MAAA,EAAQ,UAAA;AAAA,cAqFjB,IAAA,GAEP,KAAA,EAAO,SAAA,KAAc,UAAA"}

package/dist/control/case.js

@@ -0,0 +1,69 @@
+import { __CONTROL_BOUNDARY__, markEagerControlPrimitive } from "../common/control.js";
+import { isDevelopmentEnvironment } from "../common/env.js";
+import { createCaseState } from "../runtime/control.js";
+import { state } from "../runtime/state.js";
+import { normalizeBoundaryChild } from "./shared.js";
+//#region src/control/case.ts
+function flattenChildren(children) {
+	if (!Array.isArray(children)) return children == null || children === false ? [] : [children];
+	const result = [];
+	for (const child of children) {
+		if (Array.isArray(child)) {
+			result.push(...flattenChildren(child));
+			continue;
+		}
+		result.push(child);
+	}
+	return result;
+}
+function Match(_props) {
+	if (isDevelopmentEnvironment()) throw new Error("[askr] <Match> may only be used as a direct child of <Case>.");
+	return null;
+}
+function createCaseFallbackRenderer(fallback) {
+	const normalizedFallback = normalizeBoundaryChild(fallback);
+	if (normalizedFallback == null || normalizedFallback === false) return null;
+	return () => normalizedFallback;
+}
+function createMatchBranchKey(key, index) {
+	if (key == null) return index;
+	return `match:${index}:${typeof key}:${String(key)}`;
+}
+function readMatchBranches(children) {
+	const branches = [];
+	const flatChildren = flattenChildren(children);
+	for (let index = 0; index < flatChildren.length; index += 1) {
+		const child = flatChildren[index];
+		if (child == null || child === false) continue;
+		if (typeof child === "object" && child !== null && "type" in child && child.type === Match) {
+			const element = child;
+			const props = element.props ?? {};
+			const key = createMatchBranchKey(element.key, index);
+			const render = typeof props.children === "function" ? () => normalizeBoundaryChild(props.children()) : () => normalizeBoundaryChild(props.children);
+			branches.push({
+				key,
+				render,
+				when: props.when
+			});
+			continue;
+		}
+		if (isDevelopmentEnvironment()) throw new Error("[askr] <Case> only accepts <Match> children.");
+	}
+	return branches;
+}
+function CasePrimitive(props) {
+	const matches = readMatchBranches(props.children);
+	const fallback = createCaseFallbackRenderer(props.fallback);
+	const caseState = state(createCaseState(matches, fallback))();
+	caseState.matches = matches;
+	caseState.fallback = fallback;
+	return {
+		type: __CONTROL_BOUNDARY__,
+		_controlState: caseState
+	};
+}
+const Case = markEagerControlPrimitive(CasePrimitive);
+//#endregion
+export { Case, Match };
+
+//# sourceMappingURL=case.js.map

package/dist/control/case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"case.js","names":[],"sources":["../../src/control/case.ts"],"sourcesContent":["import {\n  __CONTROL_BOUNDARY__,\n  markEagerControlPrimitive,\n} from '../common/control';\nimport type { JSXElement } from '../common/jsx';\nimport type { VNode } from '../common/vnode';\nimport { isDevelopmentEnvironment } from '../common/env';\nimport {\n  createCaseState,\n  type CaseState,\n  type MatchBranch,\n} from '../runtime/control';\nimport { state } from '../runtime/state';\nimport { normalizeBoundaryChild } from './shared';\n\nexport type MatchProps = {\n  key?: string | number | null;\n  when: unknown;\n  children: unknown;\n};\n\nexport type CaseProps = {\n  fallback?: unknown;\n  children?: unknown;\n};\n\nfunction flattenChildren(children: unknown): unknown[] {\n  if (!Array.isArray(children)) {\n    return children == null || children === false ? [] : [children];\n  }\n\n  const result: unknown[] = [];\n  for (const child of children) {\n    if (Array.isArray(child)) {\n      result.push(...flattenChildren(child));\n      continue;\n    }\n    result.push(child);\n  }\n  return result;\n}\n\nexport function Match(_props: MatchProps): null {\n  if (isDevelopmentEnvironment()) {\n    throw new Error(\n      '[askr] <Match> may only be used as a direct child of <Case>.'\n    );\n  }\n  return null;\n}\n\nfunction createCaseFallbackRenderer(fallback: unknown): (() => VNode) | null {\n  const normalizedFallback = normalizeBoundaryChild(fallback);\n  if (normalizedFallback == null || normalizedFallback === false) {\n    return null;\n  }\n  return () => normalizedFallback;\n}\n\nfunction createMatchBranchKey(\n  key: string | number | null | undefined,\n  index: number\n): string | number {\n  if (key == null) {\n    return index;\n  }\n  return `match:${index}:${typeof key}:${String(key)}`;\n}\n\nfunction readMatchBranches(children: unknown): MatchBranch[] {\n  const branches: MatchBranch[] = [];\n  const flatChildren = flattenChildren(children);\n\n  for (let index = 0; index < flatChildren.length; index += 1) {\n    const child = flatChildren[index];\n    if (child == null || child === false) {\n      continue;\n    }\n\n    if (\n      typeof child === 'object' &&\n      child !== null &&\n      'type' in child &&\n      (child as JSXElement).type === Match\n    ) {\n      const element = child as JSXElement;\n      const props = (element.props ?? {}) as MatchProps;\n      const key = createMatchBranchKey(element.key, index);\n      const render =\n        typeof props.children === 'function'\n          ? () =>\n              normalizeBoundaryChild((props.children as () => VNode)()) as VNode\n          : () => normalizeBoundaryChild(props.children) as VNode;\n      branches.push({\n        key,\n        render,\n        when: props.when,\n      });\n      continue;\n    }\n\n    if (isDevelopmentEnvironment()) {\n      throw new Error('[askr] <Case> only accepts <Match> children.');\n    }\n  }\n\n  return branches;\n}\n\nfunction CasePrimitive(props: CaseProps): JSXElement {\n  const matches = readMatchBranches(props.children);\n  const fallback = createCaseFallbackRenderer(props.fallback);\n\n  const caseStateContainer = state<CaseState>(\n    createCaseState(matches, fallback)\n  );\n  const caseState = caseStateContainer();\n\n  caseState.matches = matches;\n  caseState.fallback = fallback;\n\n  return {\n    type: __CONTROL_BOUNDARY__,\n    _controlState: caseState,\n  } as unknown as JSXElement;\n}\n\nexport const Case = markEagerControlPrimitive(\n  CasePrimitive as (props: CaseProps) => JSXElement\n) as (props: CaseProps) => JSXElement;\n"],"mappings":";;;;;;AA0BA,SAAS,gBAAgB,UAA8B;AACrD,KAAI,CAAC,MAAM,QAAQ,SAAS,CAC1B,QAAO,YAAY,QAAQ,aAAa,QAAQ,EAAE,GAAG,CAAC,SAAS;CAGjE,MAAM,SAAoB,EAAE;AAC5B,MAAK,MAAM,SAAS,UAAU;AAC5B,MAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,UAAO,KAAK,GAAG,gBAAgB,MAAM,CAAC;AACtC;;AAEF,SAAO,KAAK,MAAM;;AAEpB,QAAO;;AAGT,SAAgB,MAAM,QAA0B;AAC9C,KAAI,0BAA0B,CAC5B,OAAM,IAAI,MACR,+DACD;AAEH,QAAO;;AAGT,SAAS,2BAA2B,UAAyC;CAC3E,MAAM,qBAAqB,uBAAuB,SAAS;AAC3D,KAAI,sBAAsB,QAAQ,uBAAuB,MACvD,QAAO;AAET,cAAa;;AAGf,SAAS,qBACP,KACA,OACiB;AACjB,KAAI,OAAO,KACT,QAAO;AAET,QAAO,SAAS,MAAM,GAAG,OAAO,IAAI,GAAG,OAAO,IAAI;;AAGpD,SAAS,kBAAkB,UAAkC;CAC3D,MAAM,WAA0B,EAAE;CAClC,MAAM,eAAe,gBAAgB,SAAS;AAE9C,MAAK,IAAI,QAAQ,GAAG,QAAQ,aAAa,QAAQ,SAAS,GAAG;EAC3D,MAAM,QAAQ,aAAa;AAC3B,MAAI,SAAS,QAAQ,UAAU,MAC7B;AAGF,MACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACT,MAAqB,SAAS,OAC/B;GACA,MAAM,UAAU;GAChB,MAAM,QAAS,QAAQ,SAAS,EAAE;GAClC,MAAM,MAAM,qBAAqB,QAAQ,KAAK,MAAM;GACpD,MAAM,SACJ,OAAO,MAAM,aAAa,mBAEpB,uBAAwB,MAAM,UAA0B,CAAC,SACrD,uBAAuB,MAAM,SAAS;AAClD,YAAS,KAAK;IACZ;IACA;IACA,MAAM,MAAM;IACb,CAAC;AACF;;AAGF,MAAI,0BAA0B,CAC5B,OAAM,IAAI,MAAM,+CAA+C;;AAInE,QAAO;;AAGT,SAAS,cAAc,OAA8B;CACnD,MAAM,UAAU,kBAAkB,MAAM,SAAS;CACjD,MAAM,WAAW,2BAA2B,MAAM,SAAS;CAK3D,MAAM,YAHqB,MACzB,gBAAgB,SAAS,SAAS,CAElB,EAAoB;AAEtC,WAAU,UAAU;AACpB,WAAU,WAAW;AAErB,QAAO;EACL,MAAM;EACN,eAAe;EAChB;;AAGH,MAAa,OAAO,0BAClB,cACD"}

package/dist/control/for.d.ts

@@ -0,0 +1,23 @@
+import { JSXElement } from "../common/jsx.js";
+import { VNode } from "../common/vnode.js";
+
+//#region src/control/for.d.ts
+type ForEachSource<T> = T[] | (() => T[]);
+type ForBaseProps<T> = {
+  each: ForEachSource<T>;
+  fallback?: unknown;
+  children: (item: T, index: () => number) => VNode;
+};
+type KeyedForProps<T, K extends string | number> = ForBaseProps<T> & {
+  by: (item: T, index: number) => K;
+  byIndex?: never;
+};
+type IndexedForProps<T> = ForBaseProps<T> & {
+  by?: never;
+  byIndex: true;
+};
+type ForProps<T, K extends string | number = string | number> = KeyedForProps<T, K> | IndexedForProps<T>;
+declare const For: <T, K extends string | number = string | number>(props: ForProps<T, K>) => JSXElement;
+//#endregion
+export { For, ForEachSource, ForProps };
+//# sourceMappingURL=for.d.ts.map

package/dist/control/for.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"for.d.ts","names":[],"sources":["../../src/control/for.ts"],"mappings":";;;;KAgBY,aAAA,MAAmB,CAAA,YAAa,CAAA;AAAA,KAEvC,YAAA;EACH,IAAA,EAAM,aAAA,CAAc,CAAA;EACpB,QAAA;EACA,QAAA,GAAW,IAAA,EAAM,CAAA,EAAG,KAAA,mBAAwB,KAAA;AAAA;AAAA,KAGzC,aAAA,iCAA8C,YAAA,CAAa,CAAA;EAC9D,EAAA,GAAK,IAAA,EAAM,CAAA,EAAG,KAAA,aAAkB,CAAA;EAChC,OAAA;AAAA;AAAA,KAGG,eAAA,MAAqB,YAAA,CAAa,CAAA;EACrC,EAAA;EACA,OAAA;AAAA;AAAA,KAGU,QAAA,mDACR,aAAA,CAAc,CAAA,EAAG,CAAA,IACjB,eAAA,CAAgB,CAAA;AAAA,cA0EP,GAAA,mDAKX,KAAA,EAAO,QAAA,CAAS,CAAA,EAAG,CAAA,MAChB,UAAA"}

package/dist/control/for.js

@@ -0,0 +1,62 @@
+import { __CONTROL_BOUNDARY__, markEagerControlPrimitive } from "../common/control.js";
+import { useForState } from "../runtime/for.js";
+import { createFineGrainedEffect } from "../runtime/effect.js";
+import { normalizeBoundaryChild } from "./shared.js";
+//#region src/control/for.ts
+/**
+* For JSX primitive
+*
+* Creates a keyed child-scope boundary for efficient list rendering.
+*/
+function resolveEach(each) {
+	const resolved = typeof each === "function" ? each() : each;
+	if (!Array.isArray(resolved)) throw new Error("For each must resolve to an array.");
+	return resolved;
+}
+function resolveKeyFn(props) {
+	if ("by" in props && typeof props.by === "function") return props.by;
+	if ("byIndex" in props && props.byIndex === true) return (_item, index) => index;
+	throw new Error("[askr] <For> requires a stable `by` key function. Use `byIndex` only as an explicit positional escape hatch.");
+}
+function createForBoundary(props) {
+	if ("by" in props && typeof props.by === "function" && "byIndex" in props) throw new Error("[askr] <For> accepts either `by` or `byIndex`, not both.");
+	const byFn = resolveKeyFn(props);
+	const fallback = normalizeBoundaryChild(props.fallback);
+	const forState = useForState(props.each, byFn, props.children, fallback);
+	const computeItems = () => resolveEach(forState.eachSource);
+	if (!forState._sourceEffect) {
+		forState._suspendSourceCommit = true;
+		forState._sourceEffect = createFineGrainedEffect({
+			lane: "reactive",
+			compute: computeItems,
+			commit: (items) => {
+				forState.currentItems = items;
+				if (forState._suspendSourceCommit) return;
+				forState._needsSourceReconcile = true;
+				if (forState._enqueueBoundaryCommit) {
+					forState._enqueueBoundaryCommit();
+					return;
+				}
+				forState.parentInstance?._enqueueRun?.();
+			}
+		});
+		forState._suspendSourceCommit = false;
+	} else {
+		forState._suspendSourceCommit = true;
+		forState._sourceEffect.updateCompute(computeItems);
+		forState._suspendSourceCommit = false;
+	}
+	return {
+		type: __CONTROL_BOUNDARY__,
+		_controlState: forState,
+		_forState: forState
+	};
+}
+function ForPrimitive(props) {
+	return createForBoundary(props);
+}
+const For = markEagerControlPrimitive(ForPrimitive);
+//#endregion
+export { For };
+
+//# sourceMappingURL=for.js.map

package/dist/control/for.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"for.js","names":[],"sources":["../../src/control/for.ts"],"sourcesContent":["/**\n * For JSX primitive\n *\n * Creates a keyed child-scope boundary for efficient list rendering.\n */\n\nimport {\n  __CONTROL_BOUNDARY__,\n  markEagerControlPrimitive,\n} from '../common/control';\nimport type { JSXElement } from '../common/jsx';\nimport type { DOMElement, VNode } from '../common/vnode';\nimport { createFineGrainedEffect } from '../runtime/effect';\nimport { type ForState, useForState } from '../runtime/for';\nimport { normalizeBoundaryChild } from './shared';\n\nexport type ForEachSource<T> = T[] | (() => T[]);\n\ntype ForBaseProps<T> = {\n  each: ForEachSource<T>;\n  fallback?: unknown;\n  children: (item: T, index: () => number) => VNode;\n};\n\ntype KeyedForProps<T, K extends string | number> = ForBaseProps<T> & {\n  by: (item: T, index: number) => K;\n  byIndex?: never;\n};\n\ntype IndexedForProps<T> = ForBaseProps<T> & {\n  by?: never;\n  byIndex: true;\n};\n\nexport type ForProps<T, K extends string | number = string | number> =\n  | KeyedForProps<T, K>\n  | IndexedForProps<T>;\n\nfunction resolveEach<T>(each: ForEachSource<T>): T[] {\n  const resolved = typeof each === 'function' ? each() : each;\n  if (!Array.isArray(resolved)) {\n    throw new Error('For each must resolve to an array.');\n  }\n  return resolved;\n}\n\nfunction resolveKeyFn<T>(\n  props: ForProps<T>\n): (item: T, index: number) => string | number {\n  if ('by' in props && typeof props.by === 'function') {\n    return props.by;\n  }\n  if ('byIndex' in props && props.byIndex === true) {\n    return (_item, index) => index;\n  }\n  throw new Error(\n    '[askr] <For> requires a stable `by` key function. Use `byIndex` only as an explicit positional escape hatch.'\n  );\n}\n\nfunction createForBoundary<T>(props: ForProps<T>): DOMElement {\n  if ('by' in props && typeof props.by === 'function' && 'byIndex' in props) {\n    throw new Error('[askr] <For> accepts either `by` or `byIndex`, not both.');\n  }\n\n  const byFn = resolveKeyFn(props);\n  const fallback = normalizeBoundaryChild(props.fallback);\n  const forState = useForState(props.each, byFn, props.children, fallback);\n\n  const computeItems = () => resolveEach(forState.eachSource);\n  if (!forState._sourceEffect) {\n    forState._suspendSourceCommit = true;\n    forState._sourceEffect = createFineGrainedEffect({\n      lane: 'reactive',\n      compute: computeItems,\n      commit: (items) => {\n        forState.currentItems = items;\n\n        if (forState._suspendSourceCommit) {\n          return;\n        }\n\n        forState._needsSourceReconcile = true;\n\n        if (forState._enqueueBoundaryCommit) {\n          forState._enqueueBoundaryCommit();\n          return;\n        }\n\n        forState.parentInstance?._enqueueRun?.();\n      },\n    });\n    forState._suspendSourceCommit = false;\n  } else {\n    forState._suspendSourceCommit = true;\n    forState._sourceEffect.updateCompute(computeItems);\n    forState._suspendSourceCommit = false;\n  }\n\n  return {\n    type: __CONTROL_BOUNDARY__,\n    _controlState: forState as unknown as ForState<unknown>,\n    _forState: forState as unknown as ForState<unknown>,\n  };\n}\n\nfunction ForPrimitive<T>(props: ForProps<T>): JSXElement {\n  return createForBoundary(props) as unknown as JSXElement;\n}\n\nexport const For = markEagerControlPrimitive(\n  ForPrimitive as <T, K extends string | number = string | number>(\n    props: ForProps<T, K>\n  ) => JSXElement\n) as <T, K extends string | number = string | number>(\n  props: ForProps<T, K>\n) => JSXElement;\n"],"mappings":";;;;;;;;;;AAsCA,SAAS,YAAe,MAA6B;CACnD,MAAM,WAAW,OAAO,SAAS,aAAa,MAAM,GAAG;AACvD,KAAI,CAAC,MAAM,QAAQ,SAAS,CAC1B,OAAM,IAAI,MAAM,qCAAqC;AAEvD,QAAO;;AAGT,SAAS,aACP,OAC6C;AAC7C,KAAI,QAAQ,SAAS,OAAO,MAAM,OAAO,WACvC,QAAO,MAAM;AAEf,KAAI,aAAa,SAAS,MAAM,YAAY,KAC1C,SAAQ,OAAO,UAAU;AAE3B,OAAM,IAAI,MACR,+GACD;;AAGH,SAAS,kBAAqB,OAAgC;AAC5D,KAAI,QAAQ,SAAS,OAAO,MAAM,OAAO,cAAc,aAAa,MAClE,OAAM,IAAI,MAAM,2DAA2D;CAG7E,MAAM,OAAO,aAAa,MAAM;CAChC,MAAM,WAAW,uBAAuB,MAAM,SAAS;CACvD,MAAM,WAAW,YAAY,MAAM,MAAM,MAAM,MAAM,UAAU,SAAS;CAExE,MAAM,qBAAqB,YAAY,SAAS,WAAW;AAC3D,KAAI,CAAC,SAAS,eAAe;AAC3B,WAAS,uBAAuB;AAChC,WAAS,gBAAgB,wBAAwB;GAC/C,MAAM;GACN,SAAS;GACT,SAAS,UAAU;AACjB,aAAS,eAAe;AAExB,QAAI,SAAS,qBACX;AAGF,aAAS,wBAAwB;AAEjC,QAAI,SAAS,wBAAwB;AACnC,cAAS,wBAAwB;AACjC;;AAGF,aAAS,gBAAgB,eAAe;;GAE3C,CAAC;AACF,WAAS,uBAAuB;QAC3B;AACL,WAAS,uBAAuB;AAChC,WAAS,cAAc,cAAc,aAAa;AAClD,WAAS,uBAAuB;;AAGlC,QAAO;EACL,MAAM;EACN,eAAe;EACf,WAAW;EACZ;;AAGH,SAAS,aAAgB,OAAgC;AACvD,QAAO,kBAAkB,MAAM;;AAGjC,MAAa,MAAM,0BACjB,aAGD"}

package/dist/control/index.d.ts

@@ -0,0 +1,4 @@
+import { For, ForProps } from "./for.js";
+import { Show, ShowProps } from "./show.js";
+import { Case, CaseProps, Match, MatchProps } from "./case.js";
+export { Case, type CaseProps, For, type ForProps, Match, type MatchProps, Show, type ShowProps };

package/dist/control/index.js

@@ -0,0 +1,4 @@
+import { For } from "./for.js";
+import { Show } from "./show.js";
+import { Case, Match } from "./case.js";
+export { Case, For, Match, Show };

package/dist/control/shared.js

@@ -0,0 +1,20 @@
+import { Fragment } from "../common/jsx.js";
+//#region src/control/shared.ts
+function normalizeBoundaryChild(value) {
+	if (Array.isArray(value)) {
+		if (value.length === 0) return null;
+		if (value.length === 1) return normalizeBoundaryChild(value[0]);
+		return {
+			type: Fragment,
+			props: { children: value }
+		};
+	}
+	return value ?? null;
+}
+function resolveMaybeAccessor(value) {
+	return typeof value === "function" ? value() : value;
+}
+//#endregion
+export { normalizeBoundaryChild, resolveMaybeAccessor };
+
+//# sourceMappingURL=shared.js.map

package/dist/control/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","names":[],"sources":["../../src/control/shared.ts"],"sourcesContent":["import { Fragment } from '../common/jsx';\nimport type { DOMElement, VNode } from '../common/vnode';\n\nexport function normalizeBoundaryChild(value: unknown): VNode | null {\n  if (Array.isArray(value)) {\n    if (value.length === 0) {\n      return null;\n    }\n    if (value.length === 1) {\n      return normalizeBoundaryChild(value[0]);\n    }\n    return {\n      type: Fragment,\n      props: {\n        children: value,\n      },\n    } as DOMElement;\n  }\n\n  return (value ?? null) as VNode | null;\n}\n\nexport function resolveMaybeAccessor<T>(value: T | (() => T)): T {\n  return typeof value === 'function' ? (value as () => T)() : value;\n}\n"],"mappings":";;AAGA,SAAgB,uBAAuB,OAA8B;AACnE,KAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,MAAI,MAAM,WAAW,EACnB,QAAO;AAET,MAAI,MAAM,WAAW,EACnB,QAAO,uBAAuB,MAAM,GAAG;AAEzC,SAAO;GACL,MAAM;GACN,OAAO,EACL,UAAU,OACX;GACF;;AAGH,QAAQ,SAAS;;AAGnB,SAAgB,qBAAwB,OAAyB;AAC/D,QAAO,OAAO,UAAU,aAAc,OAAmB,GAAG"}

package/dist/control/show.d.ts

@@ -0,0 +1,14 @@
+import { JSXElement } from "../common/jsx.js";
+import { VNode } from "../common/vnode.js";
+
+//#region src/control/show.d.ts
+type ShowSource<T> = T | (() => T);
+type ShowProps<T> = {
+  when: ShowSource<T>;
+  fallback?: unknown;
+  children: unknown | ((value: NonNullable<T>) => VNode);
+};
+declare const Show: <T>(props: ShowProps<T>) => JSXElement;
+//#endregion
+export { Show, ShowProps };
+//# sourceMappingURL=show.d.ts.map

package/dist/control/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","names":[],"sources":["../../src/control/show.ts"],"mappings":";;;;KAUK,UAAA,MAAgB,CAAA,UAAW,CAAA;AAAA,KAEpB,SAAA;EACV,IAAA,EAAM,UAAA,CAAW,CAAA;EACjB,QAAA;EACA,QAAA,cAAsB,KAAA,EAAO,WAAA,CAAY,CAAA,MAAO,KAAA;AAAA;AAAA,cA+CrC,IAAA,MAEJ,KAAA,EAAO,SAAA,CAAU,CAAA,MAAO,UAAA"}

package/dist/control/show.js

@@ -0,0 +1,33 @@
+import { __CONTROL_BOUNDARY__, markEagerControlPrimitive } from "../common/control.js";
+import { createShowState } from "../runtime/control.js";
+import { state } from "../runtime/state.js";
+import { normalizeBoundaryChild, resolveMaybeAccessor } from "./shared.js";
+//#region src/control/show.ts
+function createTruthyRenderer(props) {
+	if (typeof props.children === "function") return (value) => normalizeBoundaryChild(props.children(value));
+	const staticChild = normalizeBoundaryChild(props.children);
+	return () => staticChild;
+}
+function createFallbackRenderer(fallback) {
+	const normalizedFallback = normalizeBoundaryChild(fallback);
+	if (normalizedFallback == null || normalizedFallback === false) return null;
+	return () => normalizedFallback;
+}
+function ShowPrimitive(props) {
+	const selectedValue = resolveMaybeAccessor(props.when);
+	const renderTruthy = createTruthyRenderer(props);
+	const renderFallback = createFallbackRenderer(props.fallback);
+	const showState = state(createShowState(selectedValue, renderTruthy, renderFallback))();
+	showState.selectedValue = selectedValue;
+	showState.renderTruthy = renderTruthy;
+	showState.renderFallback = renderFallback;
+	return {
+		type: __CONTROL_BOUNDARY__,
+		_controlState: showState
+	};
+}
+const Show = markEagerControlPrimitive(ShowPrimitive);
+//#endregion
+export { Show };
+
+//# sourceMappingURL=show.js.map

package/dist/control/show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","names":[],"sources":["../../src/control/show.ts"],"sourcesContent":["import {\n  __CONTROL_BOUNDARY__,\n  markEagerControlPrimitive,\n} from '../common/control';\nimport type { JSXElement } from '../common/jsx';\nimport type { VNode } from '../common/vnode';\nimport { createShowState, type ShowState } from '../runtime/control';\nimport { state } from '../runtime/state';\nimport { normalizeBoundaryChild, resolveMaybeAccessor } from './shared';\n\ntype ShowSource<T> = T | (() => T);\n\nexport type ShowProps<T> = {\n  when: ShowSource<T>;\n  fallback?: unknown;\n  children: unknown | ((value: NonNullable<T>) => VNode);\n};\n\nfunction createTruthyRenderer<T>(\n  props: ShowProps<T>\n): ShowState['renderTruthy'] {\n  if (typeof props.children === 'function') {\n    return (value: unknown) =>\n      normalizeBoundaryChild(\n        (props.children as (resolved: NonNullable<T>) => VNode)(\n          value as NonNullable<T>\n        )\n      ) as VNode;\n  }\n\n  const staticChild = normalizeBoundaryChild(props.children);\n  return () => staticChild as VNode;\n}\n\nfunction createFallbackRenderer(fallback: unknown): (() => VNode) | null {\n  const normalizedFallback = normalizeBoundaryChild(fallback);\n  if (normalizedFallback == null || normalizedFallback === false) {\n    return null;\n  }\n  return () => normalizedFallback;\n}\n\nfunction ShowPrimitive<T>(props: ShowProps<T>): JSXElement {\n  const selectedValue = resolveMaybeAccessor(props.when);\n  const renderTruthy = createTruthyRenderer(props);\n  const renderFallback = createFallbackRenderer(props.fallback);\n\n  const showStateContainer = state<ShowState>(\n    createShowState(selectedValue, renderTruthy, renderFallback)\n  );\n  const showState = showStateContainer();\n\n  showState.selectedValue = selectedValue;\n  showState.renderTruthy = renderTruthy;\n  showState.renderFallback = renderFallback;\n\n  return {\n    type: __CONTROL_BOUNDARY__,\n    _controlState: showState,\n  } as unknown as JSXElement;\n}\n\nexport const Show = markEagerControlPrimitive(\n  ShowPrimitive as <T>(props: ShowProps<T>) => JSXElement\n) as <T>(props: ShowProps<T>) => JSXElement;\n"],"mappings":";;;;;AAkBA,SAAS,qBACP,OAC2B;AAC3B,KAAI,OAAO,MAAM,aAAa,WAC5B,SAAQ,UACN,uBACG,MAAM,SACL,MACD,CACF;CAGL,MAAM,cAAc,uBAAuB,MAAM,SAAS;AAC1D,cAAa;;AAGf,SAAS,uBAAuB,UAAyC;CACvE,MAAM,qBAAqB,uBAAuB,SAAS;AAC3D,KAAI,sBAAsB,QAAQ,uBAAuB,MACvD,QAAO;AAET,cAAa;;AAGf,SAAS,cAAiB,OAAiC;CACzD,MAAM,gBAAgB,qBAAqB,MAAM,KAAK;CACtD,MAAM,eAAe,qBAAqB,MAAM;CAChD,MAAM,iBAAiB,uBAAuB,MAAM,SAAS;CAK7D,MAAM,YAHqB,MACzB,gBAAgB,eAAe,cAAc,eAAe,CAE5C,EAAoB;AAEtC,WAAU,gBAAgB;AAC1B,WAAU,eAAe;AACzB,WAAU,iBAAiB;AAE3B,QAAO;EACL,MAAM;EACN,eAAe;EAChB;;AAGH,MAAa,OAAO,0BAClB,cACD"}

package/dist/dev/invariant.js

@@ -1,2 +1,29 @@
-function e(t,n,i){if(!t){const s=i?`
-`+JSON.stringify(i,null,2):"";throw new Error(`[Askr Invariant] ${n}${s}`)}}function a(t,n,i){if(e(n in t,`Object missing required property '${String(n)}'`,{object:t}),i){const s=typeof t[n];e(s===i,`Property '${String(n)}' has type '${s}', expected '${i}'`,{value:t[n],expectedType:i})}}function r(t,n){e(t!=null,n,{value:t})}class o{constructor(n){this.called=!1,this.calledAt=null,this.name=n}check(){return this.called}mark(){e(!this.called,`${this.name} called multiple times (previously at ${this.calledAt}ms)`,{now:Date.now()}),this.called=!0,this.calledAt=Date.now()}reset(){this.called=!1,this.calledAt=null}}function l(t,n,i){e(n.includes(t),`${i} must be one of [${n.join(", ")}], got ${JSON.stringify(t)}`,{value:t,allowed:n})}function c(t,n,i){e(t===n,`Invalid ${i} context. Expected ${n}, got ${t}`,{expected:n,actual:t})}function u(t,n){e(t,`[Scheduler Precondition] ${n}`)}function $(t,n){e(t,`[State Precondition] ${n}`)}function d(t,n,i){e(t.aborted===n,`AbortSignal ${n?"should be":"should not be"} aborted in ${i}`,{actual:t.aborted,expected:n})}function f(t,n){e(t!=null,`${n} callback is required but not available`,{callback:t})}function h(t,n,i){e(t===n,`Stale evaluation generation in ${i}: current ${t}, latest ${n}`,{current:t,latest:n})}function S(t,n,i){e(t===n,`Invalid mounted state in ${i}: expected ${n}, got ${t}`,{mounted:t,expected:n})}function g(t,n){e(t!==null,`Cannot render in ${n}: target is null`,{target:t})}export{o as Once,d as assertAbortControllerState,f as assertCallbackAvailable,c as assertContext,r as assertDefined,l as assertEnum,h as assertEvaluationGeneration,S as assertMountedState,a as assertProperty,g as assertRenderTarget,u as assertSchedulingPrecondition,$ as assertStatePrecondition,e as invariant};
+//#region src/dev/invariant.ts
+/**
+* Invariant assertion utilities for correctness checking
+* Production-safe: invariants are enforced at build-time or with minimal overhead
+*
+* Core principle: fail fast when invariants are violated
+* All functions throw descriptive errors for debugging
+*/
+/**
+* Assert a condition; throw with context if false
+* @internal
+*/
+function invariant(condition, message, context) {
+	if (!condition) {
+		const contextStr = context ? "\n" + JSON.stringify(context, null, 2) : "";
+		throw new Error(`[Askr Invariant] ${message}${contextStr}`);
+	}
+}
+/**
+* Assert scheduling precondition (not reentering, not during render, etc)
+* @internal
+*/
+function assertSchedulingPrecondition(condition, violationMessage) {
+	invariant(condition, `[Scheduler Precondition] ${violationMessage}`);
+}
+//#endregion
+export { assertSchedulingPrecondition, invariant };
+
+//# sourceMappingURL=invariant.js.map

package/dist/dev/invariant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.js","names":[],"sources":["../../src/dev/invariant.ts"],"sourcesContent":["/**\n * Invariant assertion utilities for correctness checking\n * Production-safe: invariants are enforced at build-time or with minimal overhead\n *\n * Core principle: fail fast when invariants are violated\n * All functions throw descriptive errors for debugging\n */\n\n/**\n * Assert a condition; throw with context if false\n * @internal\n */\nexport function invariant(\n  condition: boolean,\n  message: string,\n  context?: Record<string, unknown>\n): asserts condition {\n  if (!condition) {\n    const contextStr = context ? '\\n' + JSON.stringify(context, null, 2) : '';\n    throw new Error(`[Askr Invariant] ${message}${contextStr}`);\n  }\n}\n\n/**\n * Assert object property exists and has correct type\n * @internal\n */\nexport function assertProperty<T extends object, K extends keyof T>(\n  obj: T,\n  prop: K,\n  expectedType?: string\n): asserts obj is T & Required<Pick<T, K>> {\n  invariant(prop in obj, `Object missing required property '${String(prop)}'`, {\n    object: obj,\n  });\n\n  if (expectedType) {\n    const actualType = typeof obj[prop];\n    invariant(\n      actualType === expectedType,\n      `Property '${String(prop)}' has type '${actualType}', expected '${expectedType}'`,\n      { value: obj[prop], expectedType }\n    );\n  }\n}\n\n/**\n * Assert a reference is not null/undefined\n * @internal\n */\nexport function assertDefined<T>(\n  value: T | null | undefined,\n  message: string\n): asserts value is T {\n  invariant(value !== null && value !== undefined, message, { value });\n}\n\n/**\n * Assert a task runs exactly once atomically\n * Useful for verifying lifecycle events fire precisely when expected\n * @internal\n */\nexport class Once {\n  private called = false;\n  private calledAt: number | null = null;\n  readonly name: string;\n\n  constructor(name: string) {\n    this.name = name;\n  }\n\n  check(): boolean {\n    return this.called;\n  }\n\n  mark(): void {\n    invariant(\n      !this.called,\n      `${this.name} called multiple times (previously at ${this.calledAt}ms)`,\n      { now: Date.now() }\n    );\n    this.called = true;\n    this.calledAt = Date.now();\n  }\n\n  reset(): void {\n    this.called = false;\n    this.calledAt = null;\n  }\n}\n\n/**\n * Assert a value falls in an enumerated set\n * @internal\n */\nexport function assertEnum<T extends readonly unknown[]>(\n  value: unknown,\n  allowedValues: T,\n  fieldName: string\n): asserts value is T[number] {\n  invariant(\n    allowedValues.includes(value),\n    `${fieldName} must be one of [${allowedValues.join(', ')}], got ${JSON.stringify(value)}`,\n    { value, allowed: allowedValues }\n  );\n}\n\n/**\n * Assert execution context (scheduler, component, etc)\n * @internal\n */\nexport function assertContext(\n  actual: unknown,\n  expected: unknown,\n  contextName: string\n): asserts actual is typeof expected {\n  invariant(\n    actual === expected,\n    `Invalid ${contextName} context. Expected ${expected}, got ${actual}`,\n    { expected, actual }\n  );\n}\n\n/**\n * Assert scheduling precondition (not reentering, not during render, etc)\n * @internal\n */\nexport function assertSchedulingPrecondition(\n  condition: boolean,\n  violationMessage: string\n): asserts condition {\n  invariant(condition, `[Scheduler Precondition] ${violationMessage}`);\n}\n\n/**\n * Assert state precondition\n * @internal\n */\nexport function assertStatePrecondition(\n  condition: boolean,\n  violationMessage: string\n): asserts condition {\n  invariant(condition, `[State Precondition] ${violationMessage}`);\n}\n\n/**\n * Verify AbortController lifecycle\n * @internal\n */\nexport function assertAbortControllerState(\n  signal: AbortSignal,\n  expectedAborted: boolean,\n  context: string\n): void {\n  invariant(\n    signal.aborted === expectedAborted,\n    `AbortSignal ${expectedAborted ? 'should be' : 'should not be'} aborted in ${context}`,\n    { actual: signal.aborted, expected: expectedAborted }\n  );\n}\n\n/**\n * Guard: throw if callback is null when it shouldn't be\n * Used for notifyUpdate, event handlers, etc.\n * @internal\n */\nexport function assertCallbackAvailable<\n  T extends (...args: unknown[]) => unknown,\n>(callback: T | null | undefined, callbackName: string): asserts callback is T {\n  invariant(\n    callback !== null && callback !== undefined,\n    `${callbackName} callback is required but not available`,\n    { callback }\n  );\n}\n\n/**\n * Verify evaluation generation prevents stale evaluations\n * @internal\n */\nexport function assertEvaluationGeneration(\n  current: number,\n  latest: number,\n  context: string\n): void {\n  invariant(\n    current === latest,\n    `Stale evaluation generation in ${context}: current ${current}, latest ${latest}`,\n    { current, latest }\n  );\n}\n\n/**\n * Verify mounted flag state\n * @internal\n */\nexport function assertMountedState(\n  mounted: boolean,\n  expectedMounted: boolean,\n  context: string\n): void {\n  invariant(\n    mounted === expectedMounted,\n    `Invalid mounted state in ${context}: expected ${expectedMounted}, got ${mounted}`,\n    { mounted, expected: expectedMounted }\n  );\n}\n\n/**\n * Verify no null target when rendering\n * @internal\n */\nexport function assertRenderTarget(\n  target: Element | null,\n  context: string\n): asserts target is Element {\n  invariant(target !== null, `Cannot render in ${context}: target is null`, {\n    target,\n  });\n}\n"],"mappings":";;;;;;;;;;;;AAYA,SAAgB,UACd,WACA,SACA,SACmB;AACnB,KAAI,CAAC,WAAW;EACd,MAAM,aAAa,UAAU,OAAO,KAAK,UAAU,SAAS,MAAM,EAAE,GAAG;AACvE,QAAM,IAAI,MAAM,oBAAoB,UAAU,aAAa;;;;;;;AA4G/D,SAAgB,6BACd,WACA,kBACmB;AACnB,WAAU,WAAW,4BAA4B,mBAAmB"}

package/dist/dev/logger.js

@@ -1 +1,37 @@
-function o(n,t){const r=typeof console<"u"?console:void 0;if(!r)return;const e=r[n];if(typeof e=="function")try{e.apply(console,t)}catch{}}const f={debug:(...n)=>{},info:(...n)=>{},warn:(...n)=>{},error:(...n)=>{o("error",n)}};export{f as logger};
+import { isProductionEnvironment } from "../common/env.js";
+//#region src/dev/logger.ts
+/**
+* Centralized logger interface
+* - Keeps production builds silent for debug/warn/info messages
+* - Ensures consistent behavior across the codebase
+* - Protects against missing `console` in some environments
+*/
+function callConsole(method, args) {
+	const c = typeof console !== "undefined" ? console : void 0;
+	if (!c) return;
+	const fn = c[method];
+	if (typeof fn === "function") try {
+		fn.apply(console, args);
+	} catch {}
+}
+const logger = {
+	debug: (...args) => {
+		if (isProductionEnvironment()) return;
+		callConsole("debug", args);
+	},
+	info: (...args) => {
+		if (isProductionEnvironment()) return;
+		callConsole("info", args);
+	},
+	warn: (...args) => {
+		if (isProductionEnvironment()) return;
+		callConsole("warn", args);
+	},
+	error: (...args) => {
+		callConsole("error", args);
+	}
+};
+//#endregion
+export { logger };
+
+//# sourceMappingURL=logger.js.map

package/dist/dev/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","names":[],"sources":["../../src/dev/logger.ts"],"sourcesContent":["/**\n * Centralized logger interface\n * - Keeps production builds silent for debug/warn/info messages\n * - Ensures consistent behavior across the codebase\n * - Protects against missing `console` in some environments\n */\n\nimport { isProductionEnvironment } from '../common/env';\n\nfunction callConsole(method: string, args: unknown[]): void {\n  const c = typeof console !== 'undefined' ? (console as unknown) : undefined;\n  if (!c) return;\n  const fn = (c as Record<string, unknown>)[method];\n  if (typeof fn === 'function') {\n    try {\n      (fn as (...a: unknown[]) => unknown).apply(console, args as unknown[]);\n    } catch {\n      // ignore logging errors\n    }\n  }\n}\n\nexport const logger = {\n  debug: (...args: unknown[]) => {\n    if (isProductionEnvironment()) return;\n    callConsole('debug', args);\n  },\n\n  info: (...args: unknown[]) => {\n    if (isProductionEnvironment()) return;\n    callConsole('info', args);\n  },\n\n  warn: (...args: unknown[]) => {\n    if (isProductionEnvironment()) return;\n    callConsole('warn', args);\n  },\n\n  error: (...args: unknown[]) => {\n    callConsole('error', args);\n  },\n};\n"],"mappings":";;;;;;;;AASA,SAAS,YAAY,QAAgB,MAAuB;CAC1D,MAAM,IAAI,OAAO,YAAY,cAAe,UAAsB;AAClE,KAAI,CAAC,EAAG;CACR,MAAM,KAAM,EAA8B;AAC1C,KAAI,OAAO,OAAO,WAChB,KAAI;AACD,KAAoC,MAAM,SAAS,KAAkB;SAChE;;AAMZ,MAAa,SAAS;CACpB,QAAQ,GAAG,SAAoB;AAC7B,MAAI,yBAAyB,CAAE;AAC/B,cAAY,SAAS,KAAK;;CAG5B,OAAO,GAAG,SAAoB;AAC5B,MAAI,yBAAyB,CAAE;AAC/B,cAAY,QAAQ,KAAK;;CAG3B,OAAO,GAAG,SAAoB;AAC5B,MAAI,yBAAyB,CAAE;AAC/B,cAAY,QAAQ,KAAK;;CAG3B,QAAQ,GAAG,SAAoB;AAC7B,cAAY,SAAS,KAAK;;CAE7B"}

package/dist/foundations/core.d.ts

@@ -1,23 +1,15 @@
-export { composeHandlers } from './utilities/compose-handlers';
-export type { ComposeHandlersOptions } from './utilities/compose-handlers';
-export { mergeProps } from './utilities/merge-props';
-export { ariaDisabled, ariaExpanded, ariaSelected } from './utilities/aria';
-export { composeRefs, setRef } from './utilities/compose-ref';
-export type { Ref } from './utilities/compose-ref';
-export { formatId } from './utilities/use-id';
-export type { FormatIdOptions } from './utilities/use-id';
-export { pressable } from './interactions/pressable';
-export type { PressableOptions, PressableResult, } from './interactions/pressable';
-export { dismissable } from './interactions/dismissable';
-export type { DismissableOptions } from './interactions/dismissable';
-export { focusable } from './interactions/focusable';
-export type { FocusableOptions, FocusableResult, } from './interactions/focusable';
-export { hoverable } from './interactions/hoverable';
-export type { HoverableOptions, HoverableResult, } from './interactions/hoverable';
-export { rovingFocus } from './interactions/roving-focus';
-export type { RovingFocusOptions, RovingFocusResult, Orientation, } from './interactions/roving-focus';
-export { applyInteractionPolicy, mergeInteractionProps, } from './interactions/interaction-policy';
-export type { InteractionPolicyInput } from './interactions/interaction-policy';
-export { isControlled, resolveControllable, makeControllable, controllableState, } from './state/controllable';
-export type { ControllableState } from './state/controllable';
-//# sourceMappingURL=core.d.ts.map
+import { ComposeHandlersOptions, composeHandlers } from "./utilities/compose-handlers.js";
+import { mergeProps } from "./utilities/merge-props.js";
+import { ariaDisabled, ariaExpanded, ariaSelected } from "./utilities/aria.js";
+import { Ref, composeRefs, setRef } from "./utilities/compose-ref.js";
+import { FormatIdOptions, formatId } from "./utilities/use-id.js";
+import { DefaultPreventable, FocusLikeEvent, KeyboardLikeEvent, PointerLikeEvent, PropagationStoppable } from "./utilities/event-types.js";
+import { PressableOptions, PressableResult, pressable } from "./interactions/pressable.js";
+import { DismissableOptions, dismissable } from "./interactions/dismissable.js";
+import { FocusableOptions, FocusableResult, focusable } from "./interactions/focusable.js";
+import { HoverableOptions, HoverableResult, hoverable } from "./interactions/hoverable.js";
+import { Orientation, RovingFocusOptions, RovingFocusResult, rovingFocus } from "./interactions/roving-focus.js";
+import { InteractionPolicyInput, applyInteractionPolicy, mergeInteractionProps } from "./interactions/interaction-policy.js";
+import { ControllableState, controllableState, isControlled, makeControllable, resolveControllable } from "./state/controllable.js";
+import { IconOwnProps, IconProps, IconSizeToken, IconStyleObject } from "./icon/icon.types.js";
+import { IconBase, getIconContractProps, isIconSizeToken, joinIconStyle, normalizeIconSizeValue, resolveIconSizeVariable, resolveIconStrokeWidthVariable, serializeIconStyle } from "./icon/icon.js";

package/dist/foundations/core.js

@@ -1 +1,13 @@
-import{composeHandlers as r}from"./utilities/compose-handlers.js";import{mergeProps as a}from"./utilities/merge-props.js";import{ariaDisabled as p,ariaExpanded as m,ariaSelected as s}from"./utilities/aria.js";import{composeRefs as x,setRef as i}from"./utilities/compose-ref.js";import{formatId as c}from"./utilities/use-id.js";import{pressable as d}from"./interactions/pressable.js";import{dismissable as v}from"./interactions/dismissable.js";import{focusable as I}from"./interactions/focusable.js";import{hoverable as u}from"./interactions/hoverable.js";import{rovingFocus as R}from"./interactions/roving-focus.js";import{applyInteractionPolicy as h,mergeInteractionProps as k}from"./interactions/interaction-policy.js";import{controllableState as E,isControlled as F,makeControllable as H,resolveControllable as j}from"./state/controllable.js";export{h as applyInteractionPolicy,p as ariaDisabled,m as ariaExpanded,s as ariaSelected,r as composeHandlers,x as composeRefs,E as controllableState,v as dismissable,I as focusable,c as formatId,u as hoverable,F as isControlled,H as makeControllable,k as mergeInteractionProps,a as mergeProps,d as pressable,j as resolveControllable,R as rovingFocus,i as setRef};
+import "./utilities/aria.js";
+import "./interactions/pressable.js";
+import "./utilities/compose-handlers.js";
+import "./utilities/compose-ref.js";
+import "./utilities/merge-props.js";
+import "./interactions/interaction-policy.js";
+import "./utilities/use-id.js";
+import "./interactions/dismissable.js";
+import "./interactions/focusable.js";
+import "./interactions/hoverable.js";
+import "./interactions/roving-focus.js";
+import "./state/controllable.js";
+import "./icon/icon.js";

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

@@ -0,0 +1,53 @@
+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 };
+//# sourceMappingURL=icon.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"icon.d.ts","names":[],"sources":["../../../src/foundations/icon/icon.tsx"],"mappings":";;;;iBAMgB,eAAA,CAAgB,KAAA,YAAiB,KAAA,IAAS,aAAA;AAAA,iBAO1C,sBAAA,CAAuB,IAAA;AAAA,iBAKvB,uBAAA,CAAwB,IAAA;AAAA,iBAOxB,8BAAA,CACd,WAAA,UACA,SAAA,EAAW,aAAA;AAAA,iBAYG,kBAAA,CACd,KAAA,WAAgB,eAAA;AAAA,iBAUF,aAAA,CAAA,GACX,MAAA,EAAQ,KAAA;AAAA,iBAMG,oBAAA,CAAA;EACd,IAAA;EACA,WAAA;EACA,KAAA;EACA,KAAA;EACA,KAAA;EACA;AAAA,GACC,IAAA,CACD,SAAA;;;;;;;;;;;;;;;;;;;;;iBA4Cc,QAAA,CAAA;EACd,IAAA;EACA,WAAA;EACA,KAAA;EACA,KAAA;EACA,KAAA,EAAO,SAAA;EACP,KAAA;EACA,QAAA;EACA,QAAA;EACA,GAAA;EAAA,GACG;AAAA,GACF,SAAA,GAAS,UAAA"}