@askrjs/askr 0.0.28 → 0.0.29

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

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

@@ -1,3 +1,4 @@
+//#region src/foundations/structures/layer.d.ts
 /**
  * createLayer
  *
@@ -28,75 +29,53 @@
  *   layer.isTop(); // true if this is the topmost layer
  *   layer.unregister();
  */
-export interface LayerOptions {
-    /**
-     * Called when Escape is pressed and this is the top layer
-     */
-    onEscape?: () => void;
-    /**
-     * Called when pointer event occurs outside and this is the top layer
-     */
-    onOutsidePointer?: (e: PointerEvent) => void;
-    /**
-     * Optional node reference for outside pointer detection
-     */
-    node?: Node | null;
+interface LayerOptions {
+  /**
+   * Called when Escape is pressed and this is the top layer
+   */
+  onEscape?: () => void;
+  /**
+   * Called when pointer event occurs outside and this is the top layer
+   */
+  onOutsidePointer?: (e: PointerEvent) => void;
+  /**
+   * Optional node reference for outside pointer detection
+   */
+  node?: Node | null;
 }
-export interface Layer {
-    /**
-     * Unique layer ID
-     */
-    id: number;
-    /**
-     * Check if this layer is the topmost
-     */
-    isTop(): boolean;
-    /**
-     * Remove this layer from the stack
-     */
-    unregister(): void;
+interface Layer {
+  /**
+   * Unique layer ID
+   */
+  id: number;
+  /**
+   * Check if this layer is the topmost
+   */
+  isTop(): boolean;
+  /**
+   * Remove this layer from the stack
+   */
+  unregister(): void;
 }
-export interface LayerManager {
-    /**
-     * Register a new layer
-     */
-    register(options: LayerOptions): Layer;
-    /**
-     * Get all active layers in order
-     */
-    layers(): ReadonlyArray<Layer>;
-    /**
-     * Manually trigger escape handling on the top layer
-     */
-    handleEscape(): void;
-    /**
-     * Manually trigger outside pointer handling on the top layer
-     */
-    handleOutsidePointer(e: PointerEvent): void;
+interface LayerManager {
+  /**
+   * Register a new layer
+   */
+  register(options: LayerOptions): Layer;
+  /**
+   * Get all active layers in order
+   */
+  layers(): ReadonlyArray<Layer>;
+  /**
+   * Manually trigger escape handling on the top layer
+   */
+  handleEscape(): void;
+  /**
+   * Manually trigger outside pointer handling on the top layer
+   */
+  handleOutsidePointer(e: PointerEvent): void;
 }
-export declare function createLayer(): LayerManager;
-/**
- * USAGE EXAMPLE:
- *
- * const layerManager = createLayer();
- *
- * function Modal({ onClose }) {
- *   const modalRef = ref<HTMLDivElement>();
- *
- *   const layer = layerManager.register({
- *     node: modalRef.current,
- *     onEscape: onClose,
- *     onOutsidePointer: onClose,
- *   });
- *
- *   onUnmount(() => layer.unregister());
- *
- *   return (
- *     <div ref={modalRef}>
- *       <h1>Modal</h1>
- *       {layer.isTop() && <p>I am on top!</p>}
- *     </div>
- *   );
- * }
- */
+declare function createLayer(): LayerManager;
+//#endregion
+export { Layer, LayerManager, LayerOptions, createLayer };
 //# sourceMappingURL=layer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"layer.d.ts","sourceRoot":"","sources":["../../../src/foundations/structures/layer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAEtB;;OAEG;IACH,gBAAgB,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IAE7C;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC;IAEjB;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK,CAAC;IAEvC;;OAEG;IACH,MAAM,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;IAE/B;;OAEG;IACH,YAAY,IAAI,IAAI,CAAC;IAErB;;OAEG;IACH,oBAAoB,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CAC7C;AAED,wBAAgB,WAAW,IAAI,YAAY,CAyE1C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}
+{"version":3,"file":"layer.d.ts","names":[],"sources":["../../../src/foundations/structures/layer.ts"],"mappings":";;AA+BA;;;;;;;;;;;;AAiBA;;;;;;;;;AAiBA;;;;;;;;UAlCiB,YAAA;EAqDqB;;;EAjDpC,QAAA;EAkCiC;;;EA7BjC,gBAAA,IAAoB,CAAA,EAAG,YAAA;EAuCvB;;;EAlCA,IAAA,GAAO,IAAA;AAAA;AAAA,UAGQ,KAAA;EAuCD;;;EAnCd,EAAA;EAmCyC;;;EA9BzC,KAAA;;;;EAKA,UAAA;AAAA;AAAA,UAGe,YAAA;;;;EAIf,QAAA,CAAS,OAAA,EAAS,YAAA,GAAe,KAAA;;;;EAKjC,MAAA,IAAU,aAAA,CAAc,KAAA;;;;EAKxB,YAAA;;;;EAKA,oBAAA,CAAqB,CAAA,EAAG,YAAA;AAAA;AAAA,iBAGV,WAAA,CAAA,GAAe,YAAA"}

package/dist/foundations/structures/layer.js

@@ -1 +1,81 @@
-function l(){const n=[];let s=1;function d(t){const i=s++,e={id:i,options:t};n.push(e);function f(){return n[n.length-1]?.id===i}function p(){const o=n.findIndex(a=>a.id===i);o!==-1&&n.splice(o,1)}return{id:i,isTop:f,unregister:p}}function r(){return n.map(t=>({id:t.id,isTop:()=>n[n.length-1]?.id===t.id,unregister:()=>{const i=n.findIndex(e=>e.id===t.id);i!==-1&&n.splice(i,1)}}))}function c(){const t=n[n.length-1];t&&t.options.onEscape?.()}function u(t){const i=n[n.length-1];if(!i)return;const e=i.options.node;e&&t.target instanceof Node&&e.contains(t.target)||i.options.onOutsidePointer?.(t)}return{register:d,layers:r,handleEscape:c,handleOutsidePointer:u}}export{l as createLayer};
+//#region src/foundations/structures/layer.ts
+function createLayer() {
+	const stack = [];
+	let nextId = 1;
+	function register(options) {
+		const id = nextId++;
+		const entry = {
+			id,
+			options
+		};
+		stack.push(entry);
+		function isTop() {
+			return stack[stack.length - 1]?.id === id;
+		}
+		function unregister() {
+			const index = stack.findIndex((e) => e.id === id);
+			if (index !== -1) stack.splice(index, 1);
+		}
+		return {
+			id,
+			isTop,
+			unregister
+		};
+	}
+	function layers() {
+		return stack.map((entry) => ({
+			id: entry.id,
+			isTop: () => stack[stack.length - 1]?.id === entry.id,
+			unregister: () => {
+				const index = stack.findIndex((e) => e.id === entry.id);
+				if (index !== -1) stack.splice(index, 1);
+			}
+		}));
+	}
+	function handleEscape() {
+		const top = stack[stack.length - 1];
+		if (top) top.options.onEscape?.();
+	}
+	function handleOutsidePointer(e) {
+		const top = stack[stack.length - 1];
+		if (!top) return;
+		const node = top.options.node;
+		if (node && e.target instanceof Node) {
+			if (!node.contains(e.target)) top.options.onOutsidePointer?.(e);
+		} else top.options.onOutsidePointer?.(e);
+	}
+	return {
+		register,
+		layers,
+		handleEscape,
+		handleOutsidePointer
+	};
+}
+/**
+* USAGE EXAMPLE:
+*
+* const layerManager = createLayer();
+*
+* function Modal({ onClose }) {
+*   const modalRef = ref<HTMLDivElement>();
+*
+*   const layer = layerManager.register({
+*     node: modalRef.current,
+*     onEscape: onClose,
+*     onOutsidePointer: onClose,
+*   });
+*
+*   onUnmount(() => layer.unregister());
+*
+*   return (
+*     <div ref={modalRef}>
+*       <h1>Modal</h1>
+*       {layer.isTop() && <p>I am on top!</p>}
+*     </div>
+*   );
+* }
+*/
+//#endregion
+export { createLayer };
+
+//# sourceMappingURL=layer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layer.js","names":[],"sources":["../../../src/foundations/structures/layer.ts"],"sourcesContent":["/**\n * createLayer\n *\n * Manages stacking order and coordination for overlays (modals, popovers, etc).\n *\n * INVARIANTS:\n * 1. Layers are ordered by registration time (FIFO)\n * 2. Only the top layer handles Escape key\n * 3. Only the top layer handles outside pointer events\n * 4. Nested layers are supported\n * 5. Does not implement portals (orthogonal concern)\n * 6. No automatic DOM insertion (caller controls mounting)\n *\n * DESIGN:\n * - Returns a layer manager with register/unregister API\n * - Each layer has a unique ID and can query if it's the top layer\n * - Escape and outside pointer coordination via callbacks\n * - No z-index management (CSS concern)\n *\n * USAGE:\n *   const manager = createLayer();\n *\n *   const layer = manager.register({\n *     onEscape: () => { ... },\n *     onOutsidePointer: () => { ... }\n *   });\n *\n *   layer.isTop(); // true if this is the topmost layer\n *   layer.unregister();\n */\n\nexport interface LayerOptions {\n  /**\n   * Called when Escape is pressed and this is the top layer\n   */\n  onEscape?: () => void;\n\n  /**\n   * Called when pointer event occurs outside and this is the top layer\n   */\n  onOutsidePointer?: (e: PointerEvent) => void;\n\n  /**\n   * Optional node reference for outside pointer detection\n   */\n  node?: Node | null;\n}\n\nexport interface Layer {\n  /**\n   * Unique layer ID\n   */\n  id: number;\n\n  /**\n   * Check if this layer is the topmost\n   */\n  isTop(): boolean;\n\n  /**\n   * Remove this layer from the stack\n   */\n  unregister(): void;\n}\n\nexport interface LayerManager {\n  /**\n   * Register a new layer\n   */\n  register(options: LayerOptions): Layer;\n\n  /**\n   * Get all active layers in order\n   */\n  layers(): ReadonlyArray<Layer>;\n\n  /**\n   * Manually trigger escape handling on the top layer\n   */\n  handleEscape(): void;\n\n  /**\n   * Manually trigger outside pointer handling on the top layer\n   */\n  handleOutsidePointer(e: PointerEvent): void;\n}\n\nexport function createLayer(): LayerManager {\n  const stack: Array<{\n    id: number;\n    options: LayerOptions;\n  }> = [];\n\n  let nextId = 1;\n\n  function register(options: LayerOptions): Layer {\n    const id = nextId++;\n    const entry = { id, options };\n    stack.push(entry);\n\n    function isTop(): boolean {\n      return stack[stack.length - 1]?.id === id;\n    }\n\n    function unregister(): void {\n      const index = stack.findIndex((e) => e.id === id);\n      if (index !== -1) {\n        stack.splice(index, 1);\n      }\n    }\n\n    return {\n      id,\n      isTop,\n      unregister,\n    };\n  }\n\n  function layers(): ReadonlyArray<Layer> {\n    return stack.map((entry) => ({\n      id: entry.id,\n      isTop: () => stack[stack.length - 1]?.id === entry.id,\n      unregister: () => {\n        const index = stack.findIndex((e) => e.id === entry.id);\n        if (index !== -1) {\n          stack.splice(index, 1);\n        }\n      },\n    }));\n  }\n\n  function handleEscape(): void {\n    const top = stack[stack.length - 1];\n    if (top) {\n      top.options.onEscape?.();\n    }\n  }\n\n  function handleOutsidePointer(e: PointerEvent): void {\n    const top = stack[stack.length - 1];\n    if (!top) return;\n\n    const node = top.options.node;\n    if (node && e.target instanceof Node) {\n      // Check if the event target is outside the layer node\n      if (!node.contains(e.target)) {\n        top.options.onOutsidePointer?.(e);\n      }\n    } else {\n      // No node provided, always trigger\n      top.options.onOutsidePointer?.(e);\n    }\n  }\n\n  return {\n    register,\n    layers,\n    handleEscape,\n    handleOutsidePointer,\n  };\n}\n\n/**\n * USAGE EXAMPLE:\n *\n * const layerManager = createLayer();\n *\n * function Modal({ onClose }) {\n *   const modalRef = ref<HTMLDivElement>();\n *\n *   const layer = layerManager.register({\n *     node: modalRef.current,\n *     onEscape: onClose,\n *     onOutsidePointer: onClose,\n *   });\n *\n *   onUnmount(() => layer.unregister());\n *\n *   return (\n *     <div ref={modalRef}>\n *       <h1>Modal</h1>\n *       {layer.isTop() && <p>I am on top!</p>}\n *     </div>\n *   );\n * }\n */\n"],"mappings":";AAuFA,SAAgB,cAA4B;CAC1C,MAAM,QAGD,EAAE;CAEP,IAAI,SAAS;CAEb,SAAS,SAAS,SAA8B;EAC9C,MAAM,KAAK;EACX,MAAM,QAAQ;GAAE;GAAI;GAAS;AAC7B,QAAM,KAAK,MAAM;EAEjB,SAAS,QAAiB;AACxB,UAAO,MAAM,MAAM,SAAS,IAAI,OAAO;;EAGzC,SAAS,aAAmB;GAC1B,MAAM,QAAQ,MAAM,WAAW,MAAM,EAAE,OAAO,GAAG;AACjD,OAAI,UAAU,GACZ,OAAM,OAAO,OAAO,EAAE;;AAI1B,SAAO;GACL;GACA;GACA;GACD;;CAGH,SAAS,SAA+B;AACtC,SAAO,MAAM,KAAK,WAAW;GAC3B,IAAI,MAAM;GACV,aAAa,MAAM,MAAM,SAAS,IAAI,OAAO,MAAM;GACnD,kBAAkB;IAChB,MAAM,QAAQ,MAAM,WAAW,MAAM,EAAE,OAAO,MAAM,GAAG;AACvD,QAAI,UAAU,GACZ,OAAM,OAAO,OAAO,EAAE;;GAG3B,EAAE;;CAGL,SAAS,eAAqB;EAC5B,MAAM,MAAM,MAAM,MAAM,SAAS;AACjC,MAAI,IACF,KAAI,QAAQ,YAAY;;CAI5B,SAAS,qBAAqB,GAAuB;EACnD,MAAM,MAAM,MAAM,MAAM,SAAS;AACjC,MAAI,CAAC,IAAK;EAEV,MAAM,OAAO,IAAI,QAAQ;AACzB,MAAI,QAAQ,EAAE,kBAAkB,MAE9B;OAAI,CAAC,KAAK,SAAS,EAAE,OAAO,CAC1B,KAAI,QAAQ,mBAAmB,EAAE;QAInC,KAAI,QAAQ,mBAAmB,EAAE;;AAIrC,QAAO;EACL;EACA;EACA;EACA;EACD"}

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

@@ -1,3 +1,4 @@
+//#region src/foundations/structures/layout.d.ts
 /**
  * Layout helper.
  *
@@ -21,8 +22,10 @@
  *    Props are spread into the layout component. This is intentional
  *    and deterministic — no merging or composition.
  */
-export type LayoutComponent<P = object> = (props: P & {
-    children?: unknown;
+type LayoutComponent<P = object> = (props: P & {
+  children?: unknown;
 }) => unknown;
-export declare function layout<P = object>(Layout: LayoutComponent<P>): (children?: unknown, props?: P) => unknown;
+declare function layout<P = object>(Layout: LayoutComponent<P>): (children?: unknown, props?: P) => unknown;
+//#endregion
+export { LayoutComponent, layout };
 //# sourceMappingURL=layout.d.ts.map