@askrjs/askr 0.0.27 → 0.0.29

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/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"}

package/dist/foundations/icon/icon.js

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

package/dist/foundations/icon/icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.js","names":[],"sources":["../../../src/foundations/icon/icon.tsx"],"sourcesContent":["/* eslint-disable askr/no-hardcoded-theme-tokens -- Icon exposes a stable CSS variable contract consumed by themes. */\nimport { jsx, jsxs } from '../../jsx/jsx-runtime';\nimport type { IconProps, IconSizeToken, IconStyleObject } from './icon.types';\n\nconst ICON_SIZE_TOKENS: readonly IconSizeToken[] = ['sm', 'md', 'lg', 'xl'];\n\nexport function isIconSizeToken(value: unknown): value is IconSizeToken {\n  return (\n    typeof value === 'string' &&\n    ICON_SIZE_TOKENS.includes(value as IconSizeToken)\n  );\n}\n\nexport function normalizeIconSizeValue(size: number | string): string {\n  if (typeof size === 'number') return `${size}px`;\n  return size;\n}\n\nexport function resolveIconSizeVariable(size: number | string): string {\n  if (isIconSizeToken(size)) {\n    return `var(--ak-icon-size-${size}, var(--ak-icon-size-md, 1.25rem))`;\n  }\n  return normalizeIconSizeValue(size);\n}\n\nexport function resolveIconStrokeWidthVariable(\n  strokeWidth: number,\n  sizeToken: IconSizeToken | undefined\n): string {\n  if (sizeToken) {\n    return `var(--ak-icon-stroke-width-${sizeToken}, var(--ak-icon-stroke-width-md, ${strokeWidth}))`;\n  }\n  return `var(--ak-icon-stroke-width-md, ${strokeWidth})`;\n}\n\nfunction camelToKebab(key: string): string {\n  return key.replace(/([A-Z])/g, (match) => `-${match.toLowerCase()}`);\n}\n\nexport function serializeIconStyle(\n  style: string | IconStyleObject | undefined\n): string {\n  if (!style) return '';\n  if (typeof style === 'string') return style.trim();\n  return Object.entries(style)\n    .filter(([, value]) => value !== undefined && value !== null)\n    .map(([key, value]) => `${camelToKebab(key)}:${String(value)}`)\n    .join(';');\n}\n\nexport function joinIconStyle(\n  ...styles: Array<string | undefined>\n): string | undefined {\n  const merged = styles.map((style) => style?.trim()).filter(Boolean);\n  return merged.length > 0 ? merged.join(';') : undefined;\n}\n\nexport function getIconContractProps({\n  size = 20,\n  strokeWidth = 2,\n  color = 'currentColor',\n  title,\n  style,\n  iconName,\n}: Pick<\n  IconProps,\n  'color' | 'iconName' | 'size' | 'strokeWidth' | 'style' | 'title'\n>) {\n  const sizeToken = isIconSizeToken(size) ? size : undefined;\n  const decorative = title ? undefined : 'true';\n  const resolvedSize = resolveIconSizeVariable(size);\n  const resolvedStrokeWidth = resolveIconStrokeWidthVariable(\n    strokeWidth,\n    sizeToken\n  );\n  const iconStyle = joinIconStyle(\n    `--ak-icon-size:${resolvedSize}`,\n    `--ak-icon-stroke-width:${resolvedStrokeWidth}`,\n    'display:inline-block',\n    'flex-shrink:0',\n    'width:var(--ak-icon-size)',\n    'height:var(--ak-icon-size)',\n    'stroke-width:var(--ak-icon-stroke-width)',\n    serializeIconStyle(style)\n  );\n\n  return {\n    sizeToken,\n    decorative,\n    iconStyle,\n    attrs: {\n      xmlns: 'http://www.w3.org/2000/svg',\n      width: '24',\n      height: '24',\n      fill: 'none',\n      stroke: color,\n      'stroke-width': 'var(--ak-icon-stroke-width)',\n      role: 'img',\n      'aria-hidden': title ? undefined : 'true',\n      style: iconStyle,\n      'data-slot': 'icon',\n      'data-icon': iconName,\n      'data-size': sizeToken,\n      'data-decorative': decorative,\n      'data-color': color === 'currentColor' ? 'current' : undefined,\n    },\n  };\n}\n\nexport function IconBase({\n  size = 20,\n  strokeWidth = 2,\n  color = 'currentColor',\n  title,\n  class: className,\n  style,\n  iconName,\n  children,\n  ref,\n  ...rest\n}: IconProps) {\n  const { attrs } = getIconContractProps({\n    size,\n    strokeWidth,\n    color,\n    title,\n    style,\n    iconName,\n  });\n\n  const finalChildren = title\n    ? [jsx('title', { children: title }), children]\n    : children;\n\n  return jsxs('svg', {\n    ...rest,\n    ...attrs,\n    viewBox: rest.viewBox ?? '0 0 24 24',\n    'stroke-linecap': rest['stroke-linecap'] ?? 'round',\n    'stroke-linejoin': rest['stroke-linejoin'] ?? 'round',\n    class: className,\n    ref,\n    children: finalChildren,\n  });\n}\n"],"mappings":";;AAIA,MAAM,mBAA6C;CAAC;CAAM;CAAM;CAAM;CAAK;AAE3E,SAAgB,gBAAgB,OAAwC;AACtE,QACE,OAAO,UAAU,YACjB,iBAAiB,SAAS,MAAuB;;AAIrD,SAAgB,uBAAuB,MAA+B;AACpE,KAAI,OAAO,SAAS,SAAU,QAAO,GAAG,KAAK;AAC7C,QAAO;;AAGT,SAAgB,wBAAwB,MAA+B;AACrE,KAAI,gBAAgB,KAAK,CACvB,QAAO,sBAAsB,KAAK;AAEpC,QAAO,uBAAuB,KAAK;;AAGrC,SAAgB,+BACd,aACA,WACQ;AACR,KAAI,UACF,QAAO,8BAA8B,UAAU,mCAAmC,YAAY;AAEhG,QAAO,kCAAkC,YAAY;;AAGvD,SAAS,aAAa,KAAqB;AACzC,QAAO,IAAI,QAAQ,aAAa,UAAU,IAAI,MAAM,aAAa,GAAG;;AAGtE,SAAgB,mBACd,OACQ;AACR,KAAI,CAAC,MAAO,QAAO;AACnB,KAAI,OAAO,UAAU,SAAU,QAAO,MAAM,MAAM;AAClD,QAAO,OAAO,QAAQ,MAAM,CACzB,QAAQ,GAAG,WAAW,UAAU,UAAa,UAAU,KAAK,CAC5D,KAAK,CAAC,KAAK,WAAW,GAAG,aAAa,IAAI,CAAC,GAAG,OAAO,MAAM,GAAG,CAC9D,KAAK,IAAI;;AAGd,SAAgB,cACd,GAAG,QACiB;CACpB,MAAM,SAAS,OAAO,KAAK,UAAU,OAAO,MAAM,CAAC,CAAC,OAAO,QAAQ;AACnE,QAAO,OAAO,SAAS,IAAI,OAAO,KAAK,IAAI,GAAG;;AAGhD,SAAgB,qBAAqB,EACnC,OAAO,IACP,cAAc,GACd,QAAQ,gBACR,OACA,OACA,YAIC;CACD,MAAM,YAAY,gBAAgB,KAAK,GAAG,OAAO;CACjD,MAAM,aAAa,QAAQ,SAAY;CACvC,MAAM,eAAe,wBAAwB,KAAK;CAClD,MAAM,sBAAsB,+BAC1B,aACA,UACD;CACD,MAAM,YAAY,cAChB,kBAAkB,gBAClB,0BAA0B,uBAC1B,wBACA,iBACA,6BACA,8BACA,4CACA,mBAAmB,MAAM,CAC1B;AAED,QAAO;EACL;EACA;EACA;EACA,OAAO;GACL,OAAO;GACP,OAAO;GACP,QAAQ;GACR,MAAM;GACN,QAAQ;GACR,gBAAgB;GAChB,MAAM;GACN,eAAe,QAAQ,SAAY;GACnC,OAAO;GACP,aAAa;GACb,aAAa;GACb,aAAa;GACb,mBAAmB;GACnB,cAAc,UAAU,iBAAiB,YAAY;GACtD;EACF;;AAGH,SAAgB,SAAS,EACvB,OAAO,IACP,cAAc,GACd,QAAQ,gBACR,OACA,OAAO,WACP,OACA,UACA,UACA,KACA,GAAG,QACS;CACZ,MAAM,EAAE,UAAU,qBAAqB;EACrC;EACA;EACA;EACA;EACA;EACA;EACD,CAAC;CAEF,MAAM,gBAAgB,QAClB,CAAC,IAAI,SAAS,EAAE,UAAU,OAAO,CAAC,EAAE,SAAS,GAC7C;AAEJ,QAAO,KAAK,OAAO;EACjB,GAAG;EACH,GAAG;EACH,SAAS,KAAK,WAAW;EACzB,kBAAkB,KAAK,qBAAqB;EAC5C,mBAAmB,KAAK,sBAAsB;EAC9C,OAAO;EACP;EACA,UAAU;EACX,CAAC"}

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

@@ -0,0 +1,21 @@
+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<JSX.IntrinsicElements['svg'], 'children' | 'class' | 'color' | 'height' | 'ref' | 'role' | 'stroke' | 'stroke-width' | 'style' | 'title' | 'width'> & IconOwnProps & {
+  children?: unknown;
+  ref?: Ref<SVGSVGElement>;
+};
+//#endregion
+export { IconOwnProps, IconProps, IconSizeToken, IconStyleObject };
+//# sourceMappingURL=icon.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"icon.types.d.ts","names":[],"sources":["../../../src/foundations/icon/icon.types.ts"],"mappings":";;;KAEY,aAAA;AAAA,KAEA,eAAA,GAAkB,MAAA;AAAA,KAElB,YAAA;EACV,IAAA;EACA,WAAA;EACA,KAAA;EACA,KAAA;EACA,KAAA;EACA,KAAA,YAAiB,eAAA;EACjB,QAAA;AAAA;AAAA,KAGU,SAAA,GAAY,IAAA,CACtB,GAAA,CAAI,iBAAA,iIAaJ,YAAA;EACE,QAAA;EACA,GAAA,GAAM,GAAA,CAAI,aAAA;AAAA"}

package/dist/foundations/index.d.ts

@@ -1,3 +1,10 @@
-export * from './core';
-export * from './structures';
-//# sourceMappingURL=index.d.ts.map
+import { JSXElement } from "../common/jsx.js";
+import { LayoutComponent, layout } from "./structures/layout.js";
+import { Slot, SlotProps } from "./structures/slot.js";
+import { Presence, PresenceProps } from "./structures/presence.js";
+import { DefaultPortal, Portal, PortalProps, definePortal } from "./structures/portal.js";
+import { Collection, CollectionItem, createCollection } from "./structures/collection.js";
+import { Layer, LayerManager, LayerOptions, createLayer } from "./structures/layer.js";
+import { IconOwnProps, IconProps, IconSizeToken, IconStyleObject } from "./icon/icon.types.js";
+import { IconBase, getIconContractProps, isIconSizeToken, joinIconStyle, normalizeIconSizeValue, resolveIconSizeVariable, resolveIconStrokeWidthVariable, serializeIconStyle } from "./icon/icon.js";
+export { Collection, CollectionItem, DefaultPortal, IconBase, type IconOwnProps, type IconProps, type IconSizeToken, type IconStyleObject, JSXElement, Layer, LayerManager, LayerOptions, LayoutComponent, Portal, PortalProps, Presence, PresenceProps, Slot, SlotProps, createCollection, createLayer, definePortal, getIconContractProps, isIconSizeToken, joinIconStyle, layout, normalizeIconSizeValue, resolveIconSizeVariable, resolveIconStrokeWidthVariable, serializeIconStyle };

package/dist/foundations/index.js

@@ -1 +1,9 @@
-import"./core.js";import"./structures.js";import{DefaultPortal as a,definePortal as l}from"./structures/portal.js";import{Presence as m}from"./structures/presence.js";import{Slot as x}from"./structures/slot.js";import{applyInteractionPolicy as i,mergeInteractionProps as n}from"./interactions/interaction-policy.js";import{ariaDisabled as d,ariaExpanded as b,ariaSelected as P}from"./utilities/aria.js";import{composeHandlers as y}from"./utilities/compose-handlers.js";import{composeRefs as g,setRef as v}from"./utilities/compose-ref.js";import{controllableState as S,isControlled as D,makeControllable as R,resolveControllable as h}from"./state/controllable.js";import{createCollection as E}from"./structures/collection.js";import{createLayer as H}from"./structures/layer.js";import{dismissable as j}from"./interactions/dismissable.js";import{focusable as w}from"./interactions/focusable.js";import{formatId as A}from"./utilities/use-id.js";import{hoverable as G}from"./interactions/hoverable.js";import{layout as K}from"./structures/layout.js";import{mergeProps as N}from"./utilities/merge-props.js";import{pressable as Q}from"./interactions/pressable.js";import{rovingFocus as U}from"./interactions/roving-focus.js";export{a as DefaultPortal,m as Presence,x as Slot,i as applyInteractionPolicy,d as ariaDisabled,b as ariaExpanded,P as ariaSelected,y as composeHandlers,g as composeRefs,S as controllableState,E as createCollection,H as createLayer,l as definePortal,j as dismissable,w as focusable,A as formatId,G as hoverable,D as isControlled,K as layout,R as makeControllable,n as mergeInteractionProps,N as mergeProps,Q as pressable,h as resolveControllable,U as rovingFocus,v as setRef};
+import { DefaultPortal, Portal, definePortal } from "./structures/portal.js";
+import { layout } from "./structures/layout.js";
+import { Slot } from "./structures/slot.js";
+import { Presence } from "./structures/presence.js";
+import { createCollection } from "./structures/collection.js";
+import { createLayer } from "./structures/layer.js";
+import "./structures.js";
+import { IconBase, getIconContractProps, isIconSizeToken, joinIconStyle, normalizeIconSizeValue, resolveIconSizeVariable, resolveIconStrokeWidthVariable, serializeIconStyle } from "./icon/icon.js";
+export { DefaultPortal, IconBase, Portal, Presence, Slot, createCollection, createLayer, definePortal, getIconContractProps, isIconSizeToken, joinIconStyle, layout, normalizeIconSizeValue, resolveIconSizeVariable, resolveIconStrokeWidthVariable, serializeIconStyle };

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

@@ -1 +1,93 @@
-import{pressable as v}from"./pressable.js";import{composeHandlers as p}from"../utilities/compose-handlers.js";import{composeRefs as H}from"../utilities/compose-ref.js";import{mergeProps as d}from"../utilities/merge-props.js";function y({isNative:r,disabled:n,onPress:e,ref:t}){function f(o){if(n){o.preventDefault?.();return}e?.(o)}if(r)return{disabled:n||void 0,onClick:o=>f(o),ref:t};const c=v({disabled:n,isNativeButton:!1,onPress:o=>f(o)});return{...c,"aria-disabled":n||void 0,tabIndex:n?-1:c.tabIndex??0,ref:t}}function g(r,n,e){let t=d(r,n);e&&(t=d(t,e));for(const i in t){if(!i.startsWith("on"))continue;const s=n?.[i],m=e?.[i],u=r?.[i];if(s||m||u){const a=l=>typeof l=="function"?l:void 0;t[i]=p(a(s),p(a(m),a(u)))}}const f=r?.ref,c=e?.ref,o=n?.ref;return t.ref=H(f,c,o),t}export{y as applyInteractionPolicy,g as mergeInteractionProps};
+import { pressable } from "./pressable.js";
+import "../utilities/compose-handlers.js";
+import "../utilities/compose-ref.js";
+import "../utilities/merge-props.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,
+		"aria-disabled": disabled || void 0,
+		tabIndex: disabled ? -1 : interaction.tabIndex ?? 0,
+		ref
+	};
+}
+//#endregion
+export { applyInteractionPolicy };
+
+//# sourceMappingURL=interaction-policy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-policy.js","names":["mergePropsBase"],"sources":["../../../src/foundations/interactions/interaction-policy.ts"],"sourcesContent":["/**\n * INTERACTION POLICY (FRAMEWORK LAW)\n *\n * This is THE ONLY way to create interactive elements. Components MUST NOT\n * implement interaction logic directly.\n *\n * INVARIANTS (ENFORCED):\n * 1. \"Press\" is the semantic. Click/touch/Enter/Space are implementation details.\n * 2. Disabled is enforced exactly once, here. Components may not check disabled.\n * 3. Keyboard handling is automatic. Components may not add onKeyDown for activation.\n * 4. Native elements opt out of polyfills, not semantics.\n * 5. asChild may replace the host element, not interaction behavior.\n * 6. This policy is the SINGLE SOURCE OF TRUTH for interactive behavior.\n *\n * DESIGN:\n * - Single public function: applyInteractionPolicy\n * - Returns props that compose via mergeProps\n * - Delegates to pressable for mechanics\n * - Enforces disabled once and only once\n * - No configuration beyond disabled and native element type\n *\n * PIT OF SUCCESS:\n * ✓ Can't bypass policy (only way to get interaction behavior)\n * ✓ Can't duplicate disabled checks (enforced once, here)\n * ✓ Can't write custom keyboard handlers for buttons (policy owns it)\n * ✓ Composes via mergeProps (standard props)\n * ✓ Wrong usage is impossible (no escape hatch)\n *\n * USAGE:\n *   function Button({ onPress, disabled }) {\n *     const interaction = applyInteractionPolicy({\n *       isNative: true,\n *       disabled,\n *       onPress\n *     });\n *\n *     return <button {...interaction}>Click me</button>;\n *   }\n *\n * MISUSE EXAMPLE (PREVENTED):\n *   ❌ Button checking disabled again:\n *      function Button({ disabled, onPress }) {\n *        if (disabled) return; // NO! Policy handles this\n *        const interaction = applyInteractionPolicy(...);\n *      }\n *\n *   ❌ Custom keyboard handler:\n *      function Button({ onPress }) {\n *        const interaction = applyInteractionPolicy(...);\n *        return <button {...interaction} onKeyDown={...}>; // NO! Policy owns this\n *      }\n *\n *   ❌ Direct event handler:\n *      <button onClick={onPress}>; // NO! Use applyInteractionPolicy\n */\n\nimport { pressable } from './pressable';\nimport { composeHandlers } from '../utilities/compose-handlers';\nimport { composeRefs, Ref } from '../utilities/compose-ref';\nimport { mergeProps as mergePropsBase } from '../utilities/merge-props';\n\nexport interface InteractionPolicyInput {\n  /** Whether the host element is a native interactive element (button, a, etc) */\n  isNative: boolean;\n  /** Disabled state - checked ONLY here, never in components */\n  disabled: boolean;\n  /** User-provided press handler - semantic action, not DOM event */\n  onPress?: (e: Event) => void;\n  /** Optional ref to compose */\n  ref?: Ref<unknown>;\n}\n\n/**\n * THE interaction policy. Components MUST use this, NEVER implement\n * interaction logic directly.\n */\nexport function applyInteractionPolicy({\n  isNative,\n  disabled,\n  onPress,\n  ref,\n}: InteractionPolicyInput) {\n  // Disabled is enforced exactly once, here.\n  // Components downstream may NOT check disabled.\n  function invokePress(e: Event) {\n    if (disabled) {\n      e.preventDefault?.();\n      return;\n    }\n    onPress?.(e);\n  }\n\n  if (isNative) {\n    return {\n      disabled: disabled || undefined,\n      onClick: (e: Event) => invokePress(e),\n      ref,\n    };\n  }\n\n  // Non-native elements get full button semantics\n  const interaction = pressable({\n    disabled,\n    isNativeButton: false,\n    onPress: (e) => invokePress(e as Event),\n  });\n\n  return {\n    ...interaction,\n    'aria-disabled': disabled || undefined,\n    tabIndex: disabled ? -1 : (interaction.tabIndex ?? 0),\n    ref,\n  };\n}\n\n/**\n * Merge rule for Slot / asChild\n *\n * Precedence:\n *   policy → user → child\n *\n * Event handlers are composed (policy first).\n * Refs are always composed.\n * Policy props MUST take precedence to enforce invariants.\n */\nexport function mergeInteractionProps(\n  childProps: Record<string, unknown>,\n  policyProps: Record<string, unknown>,\n  userProps?: Record<string, unknown>\n) {\n  let out = mergePropsBase(childProps, policyProps);\n  if (userProps) out = mergePropsBase(out, userProps);\n\n  // Ensure policy handlers always run first\n  for (const k in out) {\n    if (!k.startsWith('on')) continue;\n\n    const policyHandler = policyProps?.[k];\n    const userHandler = userProps?.[k];\n    const childHandler = childProps?.[k];\n\n    if (policyHandler || userHandler || childHandler) {\n      const toHandler = (h: unknown) =>\n        typeof h === 'function'\n          ? (h as (...args: readonly unknown[]) => void)\n          : undefined;\n\n      out[k] = composeHandlers(\n        toHandler(policyHandler),\n        composeHandlers(toHandler(userHandler), toHandler(childHandler))\n      );\n    }\n  }\n\n  const childRef = childProps?.ref as Ref<unknown> | undefined;\n  const userRef = userProps?.ref as Ref<unknown> | undefined;\n  const policyRef = policyProps?.ref as Ref<unknown> | undefined;\n\n  out.ref = composeRefs(childRef, userRef, policyRef);\n\n  return out;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4EA,SAAgB,uBAAuB,EACrC,UACA,UACA,SACA,OACyB;CAGzB,SAAS,YAAY,GAAU;AAC7B,MAAI,UAAU;AACZ,KAAE,kBAAkB;AACpB;;AAEF,YAAU,EAAE;;AAGd,KAAI,SACF,QAAO;EACL,UAAU,YAAY;EACtB,UAAU,MAAa,YAAY,EAAE;EACrC;EACD;CAIH,MAAM,cAAc,UAAU;EAC5B;EACA,gBAAgB;EAChB,UAAU,MAAM,YAAY,EAAW;EACxC,CAAC;AAEF,QAAO;EACL,GAAG;EACH,iBAAiB,YAAY;EAC7B,UAAU,WAAW,KAAM,YAAY,YAAY;EACnD;EACD"}

package/dist/foundations/interactions/pressable.js

@@ -1 +1,51 @@
-import{ariaDisabled as o}from"../utilities/aria.js";function u({disabled:n,onPress:e,isNativeButton:f=!1}){const r={onClick:t=>{if(n){t.preventDefault?.(),t.stopPropagation?.();return}e?.(t)}};return f?(n&&(r.disabled=!0,Object.assign(r,o(n))),r):(r.role="button",r.tabIndex=n?-1:0,r.onKeyDown=t=>{if(n){t.preventDefault?.(),t.stopPropagation?.();return}if(t.key==="Enter"){t.preventDefault?.(),e?.(t);return}t.key===" "&&t.preventDefault?.()},r.onKeyUp=t=>{if(n){t.preventDefault?.(),t.stopPropagation?.();return}t.key===" "&&(t.preventDefault?.(),e?.(t))},n&&Object.assign(r,o(n)),r)}export{u as pressable};
+import { ariaDisabled } from "../utilities/aria.js";
+//#region src/foundations/interactions/pressable.ts
+function pressable({ disabled, onPress, isNativeButton = false }) {
+	const props = { onClick: (e) => {
+		if (disabled) {
+			e.preventDefault?.();
+			e.stopPropagation?.();
+			return;
+		}
+		onPress?.(e);
+	} };
+	if (isNativeButton) {
+		if (disabled) {
+			props.disabled = true;
+			Object.assign(props, ariaDisabled(disabled));
+		}
+		return props;
+	}
+	props.role = "button";
+	props.tabIndex = disabled ? -1 : 0;
+	props.onKeyDown = (e) => {
+		if (disabled) {
+			e.preventDefault?.();
+			e.stopPropagation?.();
+			return;
+		}
+		if (e.key === "Enter") {
+			e.preventDefault?.();
+			onPress?.(e);
+			return;
+		}
+		if (e.key === " ") e.preventDefault?.();
+	};
+	props.onKeyUp = (e) => {
+		if (disabled) {
+			e.preventDefault?.();
+			e.stopPropagation?.();
+			return;
+		}
+		if (e.key === " ") {
+			e.preventDefault?.();
+			onPress?.(e);
+		}
+	};
+	if (disabled) Object.assign(props, ariaDisabled(disabled));
+	return props;
+}
+//#endregion
+export { pressable };
+
+//# sourceMappingURL=pressable.js.map

package/dist/foundations/interactions/pressable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pressable.js","names":[],"sources":["../../../src/foundations/interactions/pressable.ts"],"sourcesContent":["/**\n * pressable\n *\n * Interaction helper that produces VNode props for 'press' semantics.\n * - Pure and deterministic: no DOM construction or mutation here\n * - The runtime owns event attachment and scheduling\n * - This helper returns plain props (handlers) intended to be attached by the runtime\n *\n * Behaviour:\n * - For native buttons: only an `onClick` prop is provided (no ARIA or keyboard shims)\n * - For non-button elements: add `role=\"button\"` and `tabIndex` and keyboard handlers\n * - Activation: `Enter` activates on keydown, `Space` activates on keyup (matches native button)\n * - Disabled: handlers short-circuit and `aria-disabled` is set for all hosts\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Activation Timing (Platform Parity)\n *    - Enter fires on keydown (immediate response)\n *    - Space fires on keyup (allows cancel by moving focus, matches native)\n *    - Space keydown prevents scroll (matches native button behavior)\n *\n * 2. Disabled Enforcement Strategy\n *    - Native buttons: Use HTML `disabled` attribute (platform-enforced non-interactivity)\n *                     AND `aria-disabled` (consistent a11y signaling)\n *    - Non-native: Use `tabIndex=-1` (removes from tab order)\n *                  AND `aria-disabled` (signals disabled state to AT)\n *    - Click handler short-circuits as defense-in-depth (prevents leaked focus issues)\n *\n * 3. Key Repeat Behavior\n *    - Held Enter/Space will fire onPress repeatedly (matches native button)\n *    - No debouncing or repeat prevention (platform parity)\n */\n\nexport interface PressableOptions {\n  disabled?: boolean;\n  onPress?: (e: PressEvent) => void;\n  /**\n   * Whether the host is a native button. Defaults to false.\n   */\n  isNativeButton?: boolean;\n}\n\nimport type {\n  DefaultPreventable,\n  KeyboardLikeEvent,\n  PropagationStoppable,\n} from '../utilities/event-types';\nimport { ariaDisabled } from '../utilities/aria';\n\ntype PressEvent = DefaultPreventable & PropagationStoppable;\n\nexport interface PressableResult {\n  onClick: (e: PressEvent) => void;\n  disabled?: true;\n  role?: 'button';\n  tabIndex?: number;\n  onKeyDown?: (e: KeyboardLikeEvent) => void;\n  onKeyUp?: (e: KeyboardLikeEvent) => void;\n  'aria-disabled'?: 'true';\n}\n\nexport function pressable({\n  disabled,\n  onPress,\n  isNativeButton = false,\n}: PressableOptions): PressableResult {\n  const props: PressableResult = {\n    onClick: (e) => {\n      if (disabled) {\n        e.preventDefault?.();\n        e.stopPropagation?.();\n        return;\n      }\n      onPress?.(e);\n    },\n  };\n\n  if (isNativeButton) {\n    if (disabled) {\n      props.disabled = true;\n      Object.assign(props, ariaDisabled(disabled));\n    }\n    return props;\n  }\n\n  props.role = 'button';\n  props.tabIndex = disabled ? -1 : 0;\n\n  props.onKeyDown = (e) => {\n    if (disabled) {\n      e.preventDefault?.();\n      e.stopPropagation?.();\n      return;\n    }\n\n    if (e.key === 'Enter') {\n      e.preventDefault?.();\n      onPress?.(e);\n      return;\n    }\n\n    if (e.key === ' ') {\n      // Prevent scrolling while Space is held.\n      e.preventDefault?.();\n    }\n  };\n\n  props.onKeyUp = (e) => {\n    if (disabled) {\n      e.preventDefault?.();\n      e.stopPropagation?.();\n      return;\n    }\n    if (e.key === ' ') {\n      e.preventDefault?.();\n      onPress?.(e);\n    }\n  };\n\n  if (disabled) Object.assign(props, ariaDisabled(disabled));\n  return props;\n}\n"],"mappings":";;AA6DA,SAAgB,UAAU,EACxB,UACA,SACA,iBAAiB,SACmB;CACpC,MAAM,QAAyB,EAC7B,UAAU,MAAM;AACd,MAAI,UAAU;AACZ,KAAE,kBAAkB;AACpB,KAAE,mBAAmB;AACrB;;AAEF,YAAU,EAAE;IAEf;AAED,KAAI,gBAAgB;AAClB,MAAI,UAAU;AACZ,SAAM,WAAW;AACjB,UAAO,OAAO,OAAO,aAAa,SAAS,CAAC;;AAE9C,SAAO;;AAGT,OAAM,OAAO;AACb,OAAM,WAAW,WAAW,KAAK;AAEjC,OAAM,aAAa,MAAM;AACvB,MAAI,UAAU;AACZ,KAAE,kBAAkB;AACpB,KAAE,mBAAmB;AACrB;;AAGF,MAAI,EAAE,QAAQ,SAAS;AACrB,KAAE,kBAAkB;AACpB,aAAU,EAAE;AACZ;;AAGF,MAAI,EAAE,QAAQ,IAEZ,GAAE,kBAAkB;;AAIxB,OAAM,WAAW,MAAM;AACrB,MAAI,UAAU;AACZ,KAAE,kBAAkB;AACpB,KAAE,mBAAmB;AACrB;;AAEF,MAAI,EAAE,QAAQ,KAAK;AACjB,KAAE,kBAAkB;AACpB,aAAU,EAAE;;;AAIhB,KAAI,SAAU,QAAO,OAAO,OAAO,aAAa,SAAS,CAAC;AAC1D,QAAO"}

package/dist/foundations/structures/collection.d.ts

@@ -1,3 +1,4 @@
+//#region src/foundations/structures/collection.d.ts
 /**
  * createCollection
  *
@@ -22,46 +23,30 @@
  *   const allItems = collection.items();
  *   unregister();
  */
-export type CollectionItem<TNode, TMetadata = unknown> = {
-    node: TNode;
-    metadata: TMetadata;
+type CollectionItem<TNode, TMetadata = unknown> = {
+  node: TNode;
+  metadata: TMetadata;
 };
-export interface Collection<TNode, TMetadata = unknown> {
-    /**
-     * Register a node with optional metadata.
-     * Returns an unregister function.
-     */
-    register(node: TNode, metadata: TMetadata): () => void;
-    /**
-     * Get all registered items in insertion order.
-     */
-    items(): ReadonlyArray<CollectionItem<TNode, TMetadata>>;
-    /**
-     * Clear all registered items.
-     */
-    clear(): void;
-    /**
-     * Get the count of registered items.
-     */
-    size(): number;
+interface Collection<TNode, TMetadata = unknown> {
+  /**
+   * Register a node with optional metadata.
+   * Returns an unregister function.
+   */
+  register(node: TNode, metadata: TMetadata): () => void;
+  /**
+   * Get all registered items in insertion order.
+   */
+  items(): ReadonlyArray<CollectionItem<TNode, TMetadata>>;
+  /**
+   * Clear all registered items.
+   */
+  clear(): void;
+  /**
+   * Get the count of registered items.
+   */
+  size(): number;
 }
-export declare function createCollection<TNode, TMetadata = unknown>(): Collection<TNode, TMetadata>;
-/**
- * USAGE EXAMPLE:
- *
- * // Create a collection for menu items
- * const menuItems = createCollection<HTMLElement, { disabled: boolean }>();
- *
- * // Register items
- * const unregister1 = menuItems.register(element1, { disabled: false });
- * const unregister2 = menuItems.register(element2, { disabled: true });
- *
- * // Query items
- * const allItems = menuItems.items();
- * const enabledItems = allItems.filter(item => !item.metadata.disabled);
- *
- * // Cleanup
- * unregister1();
- * unregister2();
- */
+declare function createCollection<TNode, TMetadata = unknown>(): Collection<TNode, TMetadata>;
+//#endregion
+export { Collection, CollectionItem, createCollection };
 //# sourceMappingURL=collection.d.ts.map

package/dist/foundations/structures/collection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../../src/foundations/structures/collection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,MAAM,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,IAAI;IACvD,IAAI,EAAE,KAAK,CAAC;IACZ,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IACpD;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,GAAG,MAAM,IAAI,CAAC;IAEvD;;OAEG;IACH,KAAK,IAAI,aAAa,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IAEzD;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,IAAI,IAAI,MAAM,CAAC;CAChB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,KAAK,UAAU,CACxE,KAAK,EACL,SAAS,CACV,CA8BA;AAED;;;;;;;;;;;;;;;;;GAiBG"}
+{"version":3,"file":"collection.d.ts","names":[],"sources":["../../../src/foundations/structures/collection.ts"],"mappings":";;AAyBA;;;;;;;;;;;;AAKA;;;;;;;;;;;KALY,cAAA;EACV,IAAA,EAAM,KAAA;EACN,QAAA,EAAU,SAAA;AAAA;AAAA,UAGK,UAAA;EAKiB;;;;EAAhC,QAAA,CAAS,IAAA,EAAM,KAAA,EAAO,QAAA,EAAU,SAAA;EAKM;;;EAAtC,KAAA,IAAS,aAAA,CAAc,cAAA,CAAe,KAAA,EAAO,SAAA;EAUzC;;AAGN;EARE,KAAA;EAQ8B;;;EAH9B,IAAA;AAAA;AAAA,iBAGc,gBAAA,4BAAA,CAAA,GAAgD,UAAA,CAC9D,KAAA,EACA,SAAA"}

package/dist/foundations/structures/collection.js

@@ -1 +1,51 @@
-function s(){const e=new Map;function r(t,u){const o={node:t,metadata:u};return e.set(t,o),()=>{e.delete(t)}}function n(){return Array.from(e.values())}function i(){e.clear()}function c(){return e.size}return{register:r,items:n,clear:i,size:c}}export{s as createCollection};
+//#region src/foundations/structures/collection.ts
+function createCollection() {
+	const registry = /* @__PURE__ */ new Map();
+	function register(node, metadata) {
+		const item = {
+			node,
+			metadata
+		};
+		registry.set(node, item);
+		return () => {
+			registry.delete(node);
+		};
+	}
+	function items() {
+		return Array.from(registry.values());
+	}
+	function clear() {
+		registry.clear();
+	}
+	function size() {
+		return registry.size;
+	}
+	return {
+		register,
+		items,
+		clear,
+		size
+	};
+}
+/**
+* USAGE EXAMPLE:
+*
+* // Create a collection for menu items
+* const menuItems = createCollection<HTMLElement, { disabled: boolean }>();
+*
+* // Register items
+* const unregister1 = menuItems.register(element1, { disabled: false });
+* const unregister2 = menuItems.register(element2, { disabled: true });
+*
+* // Query items
+* const allItems = menuItems.items();
+* const enabledItems = allItems.filter(item => !item.metadata.disabled);
+*
+* // Cleanup
+* unregister1();
+* unregister2();
+*/
+//#endregion
+export { createCollection };
+
+//# sourceMappingURL=collection.js.map

package/dist/foundations/structures/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","names":[],"sources":["../../../src/foundations/structures/collection.ts"],"sourcesContent":["/**\n * createCollection\n *\n * Ordered descendant registry for coordinating items without DOM queries.\n *\n * INVARIANTS:\n * 1. Registration order determines item order (no DOM queries)\n * 2. Stable ordering across renders (insertion order preserved)\n * 3. Each item may have metadata (type-safe, user-defined)\n * 4. No implicit global state (explicit collection instances)\n * 5. No automatic cleanup (caller controls lifecycle)\n *\n * DESIGN:\n * - Returns a registry API ({ register, items, clear })\n * - Items are stored in insertion order\n * - Registration returns an unregister function\n * - No side effects on registration (pure data structure)\n *\n * USAGE:\n *   const collection = createCollection<HTMLElement, { disabled: boolean }>();\n *   const unregister = collection.register(element, { disabled: false });\n *   const allItems = collection.items();\n *   unregister();\n */\n\nexport type CollectionItem<TNode, TMetadata = unknown> = {\n  node: TNode;\n  metadata: TMetadata;\n};\n\nexport interface Collection<TNode, TMetadata = unknown> {\n  /**\n   * Register a node with optional metadata.\n   * Returns an unregister function.\n   */\n  register(node: TNode, metadata: TMetadata): () => void;\n\n  /**\n   * Get all registered items in insertion order.\n   */\n  items(): ReadonlyArray<CollectionItem<TNode, TMetadata>>;\n\n  /**\n   * Clear all registered items.\n   */\n  clear(): void;\n\n  /**\n   * Get the count of registered items.\n   */\n  size(): number;\n}\n\nexport function createCollection<TNode, TMetadata = unknown>(): Collection<\n  TNode,\n  TMetadata\n> {\n  const registry = new Map<TNode, CollectionItem<TNode, TMetadata>>();\n\n  function register(node: TNode, metadata: TMetadata): () => void {\n    const item: CollectionItem<TNode, TMetadata> = { node, metadata };\n    registry.set(node, item);\n\n    return () => {\n      registry.delete(node);\n    };\n  }\n\n  function items(): ReadonlyArray<CollectionItem<TNode, TMetadata>> {\n    return Array.from(registry.values());\n  }\n\n  function clear(): void {\n    registry.clear();\n  }\n\n  function size(): number {\n    return registry.size;\n  }\n\n  return {\n    register,\n    items,\n    clear,\n    size,\n  };\n}\n\n/**\n * USAGE EXAMPLE:\n *\n * // Create a collection for menu items\n * const menuItems = createCollection<HTMLElement, { disabled: boolean }>();\n *\n * // Register items\n * const unregister1 = menuItems.register(element1, { disabled: false });\n * const unregister2 = menuItems.register(element2, { disabled: true });\n *\n * // Query items\n * const allItems = menuItems.items();\n * const enabledItems = allItems.filter(item => !item.metadata.disabled);\n *\n * // Cleanup\n * unregister1();\n * unregister2();\n */\n"],"mappings":";AAqDA,SAAgB,mBAGd;CACA,MAAM,2BAAW,IAAI,KAA8C;CAEnE,SAAS,SAAS,MAAa,UAAiC;EAC9D,MAAM,OAAyC;GAAE;GAAM;GAAU;AACjE,WAAS,IAAI,MAAM,KAAK;AAExB,eAAa;AACX,YAAS,OAAO,KAAK;;;CAIzB,SAAS,QAAyD;AAChE,SAAO,MAAM,KAAK,SAAS,QAAQ,CAAC;;CAGtC,SAAS,QAAc;AACrB,WAAS,OAAO;;CAGlB,SAAS,OAAe;AACtB,SAAO,SAAS;;AAGlB,QAAO;EACL;EACA;EACA;EACA;EACD"}