@askrjs/askr 0.0.35 → 0.0.37

package/dist/dev/invariant.js.map

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

package/dist/dev/logger.js.map

@@ -1 +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"}
+{"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;CAClE,IAAI,CAAC,GAAG;CACR,MAAM,KAAM,EAA8B;CAC1C,IAAI,OAAO,OAAO,YAChB,IAAI;EACF,GAAqC,MAAM,SAAS,KAAkB;SAChE;;AAMZ,MAAa,SAAS;CACpB,QAAQ,GAAG,SAAoB;EAC7B,IAAI,yBAAyB,EAAE;EAC/B,YAAY,SAAS,KAAK;;CAG5B,OAAO,GAAG,SAAoB;EAC5B,IAAI,yBAAyB,EAAE;EAC/B,YAAY,QAAQ,KAAK;;CAG3B,OAAO,GAAG,SAAoB;EAC5B,IAAI,yBAAyB,EAAE;EAC/B,YAAY,QAAQ,KAAK;;CAG3B,QAAQ,GAAG,SAAoB;EAC7B,YAAY,SAAS,KAAK;;CAE7B"}

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

@@ -1 +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"}
+{"version":3,"file":"icon.d.ts","names":[],"sources":["../../../src/foundations/icon/icon.tsx"],"mappings":";;;;iBAOgB,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,GAAY,UAAA"}

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

@@ -1 +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"}
+{"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 { JSXElement } from '../../common/jsx';\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): JSXElement {\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":";;AAKA,MAAM,mBAA6C;CAAC;CAAM;CAAM;CAAM;CAAK;AAE3E,SAAgB,gBAAgB,OAAwC;CACtE,OACE,OAAO,UAAU,YACjB,iBAAiB,SAAS,MAAuB;;AAIrD,SAAgB,uBAAuB,MAA+B;CACpE,IAAI,OAAO,SAAS,UAAU,OAAO,GAAG,KAAK;CAC7C,OAAO;;AAGT,SAAgB,wBAAwB,MAA+B;CACrE,IAAI,gBAAgB,KAAK,EACvB,OAAO,sBAAsB,KAAK;CAEpC,OAAO,uBAAuB,KAAK;;AAGrC,SAAgB,+BACd,aACA,WACQ;CACR,IAAI,WACF,OAAO,8BAA8B,UAAU,mCAAmC,YAAY;CAEhG,OAAO,kCAAkC,YAAY;;AAGvD,SAAS,aAAa,KAAqB;CACzC,OAAO,IAAI,QAAQ,aAAa,UAAU,IAAI,MAAM,aAAa,GAAG;;AAGtE,SAAgB,mBACd,OACQ;CACR,IAAI,CAAC,OAAO,OAAO;CACnB,IAAI,OAAO,UAAU,UAAU,OAAO,MAAM,MAAM;CAClD,OAAO,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;CACnE,OAAO,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;CAED,OAAO;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,QACqB;CACxB,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;CAEJ,OAAO,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

@@ -1,3 +1,4 @@
+import { Props } from "../../common/props.js";
 import { Ref } from "../utilities/compose-ref.js";
 
 //#region src/foundations/icon/icon.types.d.ts
@@ -12,7 +13,7 @@ type IconOwnProps = {
   style?: string | IconStyleObject;
   iconName?: string;
 };
-type IconProps = Omit<JSX.IntrinsicElements['svg'], 'children' | 'class' | 'color' | 'height' | 'ref' | 'role' | 'stroke' | 'stroke-width' | 'style' | 'title' | 'width'> & IconOwnProps & {
+type IconProps = Omit<Props, 'children' | 'class' | 'color' | 'height' | 'ref' | 'role' | 'stroke' | 'stroke-width' | 'style' | 'title' | 'width'> & IconOwnProps & {
   children?: unknown;
   ref?: Ref<SVGSVGElement>;
 };

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

@@ -1 +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"}
+{"version":3,"file":"icon.types.d.ts","names":[],"sources":["../../../src/foundations/icon/icon.types.ts"],"mappings":";;;;KAIY,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,KAAA,0HAaA,YAAA;EACE,QAAA;EACA,GAAA,GAAM,GAAA,CAAI,aAAA;AAAA"}

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

@@ -0,0 +1,3 @@
+import { IconOwnProps, IconProps, IconSizeToken, IconStyleObject } from "./icon.types.js";
+import { IconBase, getIconContractProps, isIconSizeToken, joinIconStyle, normalizeIconSizeValue, resolveIconSizeVariable, resolveIconStrokeWidthVariable, serializeIconStyle } from "./icon.js";
+export { IconBase, type IconOwnProps, type IconProps, type IconSizeToken, type IconStyleObject, getIconContractProps, isIconSizeToken, joinIconStyle, normalizeIconSizeValue, resolveIconSizeVariable, resolveIconStrokeWidthVariable, serializeIconStyle };

package/dist/foundations/icon/index.js

@@ -0,0 +1,2 @@
+import { IconBase, getIconContractProps, isIconSizeToken, joinIconStyle, normalizeIconSizeValue, resolveIconSizeVariable, resolveIconStrokeWidthVariable, serializeIconStyle } from "./icon.js";
+export { IconBase, getIconContractProps, isIconSizeToken, joinIconStyle, normalizeIconSizeValue, resolveIconSizeVariable, resolveIconStrokeWidthVariable, serializeIconStyle };

package/dist/foundations/index.d.ts

@@ -1,23 +1,6 @@
 import { JSXElement } from "../common/jsx.js";
-import { ComposeHandlersOptions, composeHandlers } from "./utilities/compose-handlers.js";
-import { mergeProps } from "./utilities/merge-props.js";
-import { ariaDisabled, ariaExpanded, ariaSelected } from "./utilities/aria.js";
-import { Ref, composeRefs, setRef } from "./utilities/compose-ref.js";
-import { FormatIdOptions, formatId } from "./utilities/use-id.js";
-import { DefaultPreventable, FocusLikeEvent, KeyboardLikeEvent, PointerLikeEvent, PropagationStoppable } from "./utilities/event-types.js";
-import { PressableOptions, PressableResult, pressable } from "./interactions/pressable.js";
-import { DismissableOptions, dismissable } from "./interactions/dismissable.js";
-import { FocusableOptions, FocusableResult, focusable } from "./interactions/focusable.js";
-import { HoverableOptions, HoverableResult, hoverable } from "./interactions/hoverable.js";
-import { Orientation, RovingFocusOptions, RovingFocusResult, rovingFocus } from "./interactions/roving-focus.js";
-import { InteractionPolicyInput, applyInteractionPolicy, mergeInteractionProps } from "./interactions/interaction-policy.js";
-import { ControllableState, controllableState, isControlled, makeControllable, resolveControllable } from "./state/controllable.js";
-import { IconOwnProps, IconProps, IconSizeToken, IconStyleObject } from "./icon/icon.types.js";
-import { IconBase, getIconContractProps, isIconSizeToken, joinIconStyle, normalizeIconSizeValue, resolveIconSizeVariable, resolveIconStrokeWidthVariable, serializeIconStyle } from "./icon/icon.js";
 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";
-export { Collection, CollectionItem, ComposeHandlersOptions, ControllableState, DefaultPortal, DefaultPreventable, DismissableOptions, FocusLikeEvent, FocusableOptions, FocusableResult, FormatIdOptions, HoverableOptions, HoverableResult, IconBase, type IconOwnProps, type IconProps, type IconSizeToken, type IconStyleObject, InteractionPolicyInput, JSXElement, KeyboardLikeEvent, Layer, LayerManager, LayerOptions, LayoutComponent, Orientation, PointerLikeEvent, Portal, PortalProps, Presence, PresenceProps, PressableOptions, PressableResult, PropagationStoppable, Ref, RovingFocusOptions, RovingFocusResult, Slot, SlotProps, applyInteractionPolicy, ariaDisabled, ariaExpanded, ariaSelected, composeHandlers, composeRefs, controllableState, createCollection, createLayer, definePortal, dismissable, focusable, formatId, getIconContractProps, hoverable, isControlled, isIconSizeToken, joinIconStyle, layout, makeControllable, mergeInteractionProps, mergeProps, normalizeIconSizeValue, pressable, resolveControllable, resolveIconSizeVariable, resolveIconStrokeWidthVariable, rovingFocus, serializeIconStyle, setRef };
+export { DefaultPortal, type JSXElement, type LayoutComponent, Portal, type PortalProps, Presence, type PresenceProps, Slot, type SlotProps, definePortal, layout };

package/dist/foundations/index.js

@@ -1,22 +1,6 @@
 import { DefaultPortal, Portal, definePortal } from "./structures/portal.js";
-import { ariaDisabled, ariaExpanded, ariaSelected } from "./utilities/aria.js";
-import { pressable } from "./interactions/pressable.js";
-import { composeHandlers } from "./utilities/compose-handlers.js";
-import { composeRefs, setRef } from "./utilities/compose-ref.js";
-import { mergeProps } from "./utilities/merge-props.js";
-import { applyInteractionPolicy, mergeInteractionProps } from "./interactions/interaction-policy.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 { formatId } from "./utilities/use-id.js";
-import { dismissable } from "./interactions/dismissable.js";
-import { focusable } from "./interactions/focusable.js";
-import { hoverable } from "./interactions/hoverable.js";
-import { rovingFocus } from "./interactions/roving-focus.js";
-import { controllableState, isControlled, makeControllable, resolveControllable } from "./state/controllable.js";
-import { IconBase, getIconContractProps, isIconSizeToken, joinIconStyle, normalizeIconSizeValue, resolveIconSizeVariable, resolveIconStrokeWidthVariable, serializeIconStyle } from "./icon/icon.js";
-import "./core.js";
-export { DefaultPortal, IconBase, Portal, Presence, Slot, applyInteractionPolicy, ariaDisabled, ariaExpanded, ariaSelected, composeHandlers, composeRefs, controllableState, createCollection, createLayer, definePortal, dismissable, focusable, formatId, getIconContractProps, hoverable, isControlled, isIconSizeToken, joinIconStyle, layout, makeControllable, mergeInteractionProps, mergeProps, normalizeIconSizeValue, pressable, resolveControllable, resolveIconSizeVariable, resolveIconStrokeWidthVariable, rovingFocus, serializeIconStyle, setRef };
+import "./structures/index.js";
+export { DefaultPortal, Portal, Presence, Slot, definePortal, layout };

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

@@ -1 +1 @@
-{"version":3,"file":"dismissable.js","names":[],"sources":["../../../src/foundations/interactions/dismissable.ts"],"sourcesContent":["/**\n * dismissable\n *\n * THE dismissal primitive. Handles Escape key and outside interactions.\n *\n * INVARIANTS:\n * 1. Returns props that compose via mergeProps (no factories)\n * 2. Disabled state respected exactly once, here\n * 3. No side effects - pure props generation\n * 4. Outside detection requires explicit node reference\n * 5. This is the ONLY dismissal primitive - do not create alternatives\n *\n * DESIGN:\n * - Returns standard event handler props (onKeyDown, onPointerDownCapture)\n * - Composable via mergeProps with other foundations\n * - Caller provides node reference for outside detection\n * - Single onDismiss callback for all dismiss triggers\n *\n * PIT OF SUCCESS:\n * ✓ Can't accidentally bypass (only way to get dismiss behavior)\n * ✓ Can't duplicate (disabled checked once)\n * ✓ Composes via mergeProps (standard props)\n * ✓ Wrong usage is hard (no factories to misuse)\n *\n * USAGE:\n *   const props = dismissable({\n *     node: elementRef,\n *     disabled: false,\n *     onDismiss: () => close()\n *   });\n *\n *   <div ref={elementRef} {...props}>Content</div>\n *\n * MISUSE EXAMPLE (PREVENTED):\n *   ❌ Can't forget to check disabled - checked inside dismissable\n *   ❌ Can't create custom escape handler - this is the only one\n *   ❌ Can't bypass via direct event listeners - mergeProps composes correctly\n */\n\nexport interface DismissableOptions {\n  /**\n   * Reference to the element for outside click detection\n   */\n  node?: Node | null;\n\n  /**\n   * Whether dismiss is disabled\n   */\n  disabled?: boolean;\n\n  /**\n   * Called when dismiss is triggered (Escape or outside click)\n   */\n  onDismiss?: (trigger: 'escape' | 'outside') => void;\n}\n\nimport type {\n  KeyboardLikeEvent,\n  PointerLikeEvent,\n} from '../utilities/event-types';\n\nexport function dismissable({ node, disabled, onDismiss }: DismissableOptions) {\n  function handleKeyDown(e: KeyboardLikeEvent) {\n    if (disabled) return;\n    if (e.key === 'Escape') {\n      e.preventDefault?.();\n      e.stopPropagation?.();\n      onDismiss?.('escape');\n    }\n  }\n\n  function handlePointerDownCapture(e: PointerLikeEvent) {\n    if (disabled) return;\n\n    const target = e.target;\n    if (!(target instanceof Node)) return;\n\n    // If no node provided, can't detect outside clicks\n    if (!node) return;\n\n    // Check if click is outside\n    if (!node.contains(target)) {\n      onDismiss?.('outside');\n    }\n  }\n\n  return {\n    onKeyDown: handleKeyDown,\n    // Use capture phase to catch events before they bubble\n    onPointerDownCapture: handlePointerDownCapture,\n  };\n}\n"],"mappings":";AA6DA,SAAgB,YAAY,EAAE,MAAM,UAAU,aAAiC;CAC7E,SAAS,cAAc,GAAsB;AAC3C,MAAI,SAAU;AACd,MAAI,EAAE,QAAQ,UAAU;AACtB,KAAE,kBAAkB;AACpB,KAAE,mBAAmB;AACrB,eAAY,SAAS;;;CAIzB,SAAS,yBAAyB,GAAqB;AACrD,MAAI,SAAU;EAEd,MAAM,SAAS,EAAE;AACjB,MAAI,EAAE,kBAAkB,MAAO;AAG/B,MAAI,CAAC,KAAM;AAGX,MAAI,CAAC,KAAK,SAAS,OAAO,CACxB,aAAY,UAAU;;AAI1B,QAAO;EACL,WAAW;EAEX,sBAAsB;EACvB"}
+{"version":3,"file":"dismissable.js","names":[],"sources":["../../../src/foundations/interactions/dismissable.ts"],"sourcesContent":["/**\n * dismissable\n *\n * THE dismissal primitive. Handles Escape key and outside interactions.\n *\n * INVARIANTS:\n * 1. Returns props that compose via mergeProps (no factories)\n * 2. Disabled state respected exactly once, here\n * 3. No side effects - pure props generation\n * 4. Outside detection requires explicit node reference\n * 5. This is the ONLY dismissal primitive - do not create alternatives\n *\n * DESIGN:\n * - Returns standard event handler props (onKeyDown, onPointerDownCapture)\n * - Composable via mergeProps with other foundations\n * - Caller provides node reference for outside detection\n * - Single onDismiss callback for all dismiss triggers\n *\n * PIT OF SUCCESS:\n * ✓ Can't accidentally bypass (only way to get dismiss behavior)\n * ✓ Can't duplicate (disabled checked once)\n * ✓ Composes via mergeProps (standard props)\n * ✓ Wrong usage is hard (no factories to misuse)\n *\n * USAGE:\n *   const props = dismissable({\n *     node: elementRef,\n *     disabled: false,\n *     onDismiss: () => close()\n *   });\n *\n *   <div ref={elementRef} {...props}>Content</div>\n *\n * MISUSE EXAMPLE (PREVENTED):\n *   ❌ Can't forget to check disabled - checked inside dismissable\n *   ❌ Can't create custom escape handler - this is the only one\n *   ❌ Can't bypass via direct event listeners - mergeProps composes correctly\n */\n\nexport interface DismissableOptions {\n  /**\n   * Reference to the element for outside click detection\n   */\n  node?: Node | null;\n\n  /**\n   * Whether dismiss is disabled\n   */\n  disabled?: boolean;\n\n  /**\n   * Called when dismiss is triggered (Escape or outside click)\n   */\n  onDismiss?: (trigger: 'escape' | 'outside') => void;\n}\n\nimport type {\n  KeyboardLikeEvent,\n  PointerLikeEvent,\n} from '../utilities/event-types';\n\nexport function dismissable({ node, disabled, onDismiss }: DismissableOptions) {\n  function handleKeyDown(e: KeyboardLikeEvent) {\n    if (disabled) return;\n    if (e.key === 'Escape') {\n      e.preventDefault?.();\n      e.stopPropagation?.();\n      onDismiss?.('escape');\n    }\n  }\n\n  function handlePointerDownCapture(e: PointerLikeEvent) {\n    if (disabled) return;\n\n    const target = e.target;\n    if (!(target instanceof Node)) return;\n\n    // If no node provided, can't detect outside clicks\n    if (!node) return;\n\n    // Check if click is outside\n    if (!node.contains(target)) {\n      onDismiss?.('outside');\n    }\n  }\n\n  return {\n    onKeyDown: handleKeyDown,\n    // Use capture phase to catch events before they bubble\n    onPointerDownCapture: handlePointerDownCapture,\n  };\n}\n"],"mappings":";AA6DA,SAAgB,YAAY,EAAE,MAAM,UAAU,aAAiC;CAC7E,SAAS,cAAc,GAAsB;EAC3C,IAAI,UAAU;EACd,IAAI,EAAE,QAAQ,UAAU;GACtB,EAAE,kBAAkB;GACpB,EAAE,mBAAmB;GACrB,YAAY,SAAS;;;CAIzB,SAAS,yBAAyB,GAAqB;EACrD,IAAI,UAAU;EAEd,MAAM,SAAS,EAAE;EACjB,IAAI,EAAE,kBAAkB,OAAO;EAG/B,IAAI,CAAC,MAAM;EAGX,IAAI,CAAC,KAAK,SAAS,OAAO,EACxB,YAAY,UAAU;;CAI1B,OAAO;EACL,WAAW;EAEX,sBAAsB;EACvB"}

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

@@ -1 +1 @@
-{"version":3,"file":"focusable.js","names":[],"sources":["../../../src/foundations/interactions/focusable.ts"],"sourcesContent":["/**\n * focusable\n *\n * Normalize focus-related props for hosts.\n * - No DOM manipulation here; returns props that the runtime may attach.\n */\n\nimport { ariaDisabled } from '../utilities/aria';\n\nexport interface FocusableOptions {\n  disabled?: boolean;\n  tabIndex?: number | undefined;\n}\n\nexport interface FocusableResult {\n  tabIndex?: number;\n  'aria-disabled'?: 'true';\n}\n\nexport function focusable({\n  disabled,\n  tabIndex,\n}: FocusableOptions): FocusableResult {\n  return {\n    tabIndex: disabled ? -1 : tabIndex === undefined ? 0 : tabIndex,\n    ...ariaDisabled(disabled),\n  };\n}\n"],"mappings":";;;;;;;;AAmBA,SAAgB,UAAU,EACxB,UACA,YACoC;AACpC,QAAO;EACL,UAAU,WAAW,KAAK,aAAa,SAAY,IAAI;EACvD,GAAG,aAAa,SAAS;EAC1B"}
+{"version":3,"file":"focusable.js","names":[],"sources":["../../../src/foundations/interactions/focusable.ts"],"sourcesContent":["/**\n * focusable\n *\n * Normalize focus-related props for hosts.\n * - No DOM manipulation here; returns props that the runtime may attach.\n */\n\nimport { ariaDisabled } from '../utilities/aria';\n\nexport interface FocusableOptions {\n  disabled?: boolean;\n  tabIndex?: number | undefined;\n}\n\nexport interface FocusableResult {\n  tabIndex?: number;\n  'aria-disabled'?: 'true';\n}\n\nexport function focusable({\n  disabled,\n  tabIndex,\n}: FocusableOptions): FocusableResult {\n  return {\n    tabIndex: disabled ? -1 : tabIndex === undefined ? 0 : tabIndex,\n    ...ariaDisabled(disabled),\n  };\n}\n"],"mappings":";;;;;;;;AAmBA,SAAgB,UAAU,EACxB,UACA,YACoC;CACpC,OAAO;EACL,UAAU,WAAW,KAAK,aAAa,SAAY,IAAI;EACvD,GAAG,aAAa,SAAS;EAC1B"}

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

@@ -1 +1 @@
-{"version":3,"file":"hoverable.js","names":[],"sources":["../../../src/foundations/interactions/hoverable.ts"],"sourcesContent":["/**\n * hoverable\n *\n * Produces props for pointer enter/leave handling. Pure and deterministic.\n */\n\nexport interface HoverableOptions {\n  disabled?: boolean;\n  onEnter?: (e: HoverEvent) => void;\n  onLeave?: (e: HoverEvent) => void;\n}\n\nimport type {\n  DefaultPreventable,\n  PropagationStoppable,\n} from '../utilities/event-types';\n\ntype HoverEvent = DefaultPreventable & PropagationStoppable;\n\nexport interface HoverableResult {\n  onPointerEnter?: (e: HoverEvent) => void;\n  onPointerLeave?: (e: HoverEvent) => void;\n}\n\nexport function hoverable({\n  disabled,\n  onEnter,\n  onLeave,\n}: HoverableOptions): HoverableResult {\n  return {\n    onPointerEnter: disabled\n      ? undefined\n      : (e) => {\n          onEnter?.(e);\n        },\n    onPointerLeave: disabled\n      ? undefined\n      : (e) => {\n          onLeave?.(e);\n        },\n  };\n}\n"],"mappings":";AAwBA,SAAgB,UAAU,EACxB,UACA,SACA,WACoC;AACpC,QAAO;EACL,gBAAgB,WACZ,UACC,MAAM;AACL,aAAU,EAAE;;EAElB,gBAAgB,WACZ,UACC,MAAM;AACL,aAAU,EAAE;;EAEnB"}
+{"version":3,"file":"hoverable.js","names":[],"sources":["../../../src/foundations/interactions/hoverable.ts"],"sourcesContent":["/**\n * hoverable\n *\n * Produces props for pointer enter/leave handling. Pure and deterministic.\n */\n\nexport interface HoverableOptions {\n  disabled?: boolean;\n  onEnter?: (e: HoverEvent) => void;\n  onLeave?: (e: HoverEvent) => void;\n}\n\nimport type {\n  DefaultPreventable,\n  PropagationStoppable,\n} from '../utilities/event-types';\n\ntype HoverEvent = DefaultPreventable & PropagationStoppable;\n\nexport interface HoverableResult {\n  onPointerEnter?: (e: HoverEvent) => void;\n  onPointerLeave?: (e: HoverEvent) => void;\n}\n\nexport function hoverable({\n  disabled,\n  onEnter,\n  onLeave,\n}: HoverableOptions): HoverableResult {\n  return {\n    onPointerEnter: disabled\n      ? undefined\n      : (e) => {\n          onEnter?.(e);\n        },\n    onPointerLeave: disabled\n      ? undefined\n      : (e) => {\n          onLeave?.(e);\n        },\n  };\n}\n"],"mappings":";AAwBA,SAAgB,UAAU,EACxB,UACA,SACA,WACoC;CACpC,OAAO;EACL,gBAAgB,WACZ,UACC,MAAM;GACL,UAAU,EAAE;;EAElB,gBAAgB,WACZ,UACC,MAAM;GACL,UAAU,EAAE;;EAEnB"}

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

@@ -0,0 +1,7 @@
+import { PressableOptions, PressableResult, pressable } from "./pressable.js";
+import { DismissableOptions, dismissable } from "./dismissable.js";
+import { FocusableOptions, FocusableResult, focusable } from "./focusable.js";
+import { HoverableOptions, HoverableResult, hoverable } from "./hoverable.js";
+import { Orientation, RovingFocusOptions, RovingFocusResult, rovingFocus } from "./roving-focus.js";
+import { InteractionPolicyInput, applyInteractionPolicy, mergeInteractionProps } from "./interaction-policy.js";
+export { type DismissableOptions, type FocusableOptions, type FocusableResult, type HoverableOptions, type HoverableResult, type InteractionPolicyInput, type Orientation, type PressableOptions, type PressableResult, type RovingFocusOptions, type RovingFocusResult, applyInteractionPolicy, dismissable, focusable, hoverable, mergeInteractionProps, pressable, rovingFocus };

package/dist/foundations/interactions/index.js

@@ -0,0 +1,7 @@
+import { pressable } from "./pressable.js";
+import { dismissable } from "./dismissable.js";
+import { focusable } from "./focusable.js";
+import { hoverable } from "./hoverable.js";
+import { rovingFocus } from "./roving-focus.js";
+import { applyInteractionPolicy, mergeInteractionProps } from "./interaction-policy.js";
+export { applyInteractionPolicy, dismissable, focusable, hoverable, mergeInteractionProps, pressable, rovingFocus };

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

@@ -1,7 +1,7 @@
-import { pressable } from "./pressable.js";
 import { composeHandlers } from "../utilities/compose-handlers.js";
-import { composeRefs } from "../utilities/compose-ref.js";
 import { mergeProps } from "../utilities/merge-props.js";
+import { composeRefs } from "../utilities/compose-ref.js";
+import { pressable } from "./pressable.js";
 //#region src/foundations/interactions/interaction-policy.ts
 /**
 * INTERACTION POLICY (FRAMEWORK LAW)

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

@@ -1 +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;;;;;;;;;;;;AAaH,SAAgB,sBACd,YACA,aACA,WACA;CACA,IAAI,MAAMA,WAAe,YAAY,YAAY;AACjD,KAAI,UAAW,OAAMA,WAAe,KAAK,UAAU;AAGnD,MAAK,MAAM,KAAK,KAAK;AACnB,MAAI,CAAC,EAAE,WAAW,KAAK,CAAE;EAEzB,MAAM,gBAAgB,cAAc;EACpC,MAAM,cAAc,YAAY;EAChC,MAAM,eAAe,aAAa;AAElC,MAAI,iBAAiB,eAAe,cAAc;GAChD,MAAM,aAAa,MACjB,OAAO,MAAM,aACR,IACD;AAEN,OAAI,KAAK,gBACP,UAAU,cAAc,EACxB,gBAAgB,UAAU,YAAY,EAAE,UAAU,aAAa,CAAC,CACjE;;;CAIL,MAAM,WAAW,YAAY;CAC7B,MAAM,UAAU,WAAW;CAC3B,MAAM,YAAY,aAAa;AAE/B,KAAI,MAAM,YAAY,UAAU,SAAS,UAAU;AAEnD,QAAO"}
+{"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;EAC7B,IAAI,UAAU;GACZ,EAAE,kBAAkB;GACpB;;EAEF,UAAU,EAAE;;CAGd,IAAI,UACF,OAAO;EACL,UAAU,YAAY;EACtB,UAAU,MAAa,YAAY,EAAE;EACrC;EACD;CAIH,MAAM,cAAc,UAAU;EAC5B;EACA,gBAAgB;EAChB,UAAU,MAAM,YAAY,EAAW;EACxC,CAAC;CAEF,OAAO;EACL,GAAG;EACH,iBAAiB,YAAY;EAC7B,UAAU,WAAW,KAAM,YAAY,YAAY;EACnD;EACD;;;;;;;;;;;;AAaH,SAAgB,sBACd,YACA,aACA,WACA;CACA,IAAI,MAAMA,WAAe,YAAY,YAAY;CACjD,IAAI,WAAW,MAAMA,WAAe,KAAK,UAAU;CAGnD,KAAK,MAAM,KAAK,KAAK;EACnB,IAAI,CAAC,EAAE,WAAW,KAAK,EAAE;EAEzB,MAAM,gBAAgB,cAAc;EACpC,MAAM,cAAc,YAAY;EAChC,MAAM,eAAe,aAAa;EAElC,IAAI,iBAAiB,eAAe,cAAc;GAChD,MAAM,aAAa,MACjB,OAAO,MAAM,aACR,IACD;GAEN,IAAI,KAAK,gBACP,UAAU,cAAc,EACxB,gBAAgB,UAAU,YAAY,EAAE,UAAU,aAAa,CAAC,CACjE;;;CAIL,MAAM,WAAW,YAAY;CAC7B,MAAM,UAAU,WAAW;CAC3B,MAAM,YAAY,aAAa;CAE/B,IAAI,MAAM,YAAY,UAAU,SAAS,UAAU;CAEnD,OAAO"}

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

@@ -1 +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"}
+{"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;EACd,IAAI,UAAU;GACZ,EAAE,kBAAkB;GACpB,EAAE,mBAAmB;GACrB;;EAEF,UAAU,EAAE;IAEf;CAED,IAAI,gBAAgB;EAClB,IAAI,UAAU;GACZ,MAAM,WAAW;GACjB,OAAO,OAAO,OAAO,aAAa,SAAS,CAAC;;EAE9C,OAAO;;CAGT,MAAM,OAAO;CACb,MAAM,WAAW,WAAW,KAAK;CAEjC,MAAM,aAAa,MAAM;EACvB,IAAI,UAAU;GACZ,EAAE,kBAAkB;GACpB,EAAE,mBAAmB;GACrB;;EAGF,IAAI,EAAE,QAAQ,SAAS;GACrB,EAAE,kBAAkB;GACpB,UAAU,EAAE;GACZ;;EAGF,IAAI,EAAE,QAAQ,KAEZ,EAAE,kBAAkB;;CAIxB,MAAM,WAAW,MAAM;EACrB,IAAI,UAAU;GACZ,EAAE,kBAAkB;GACpB,EAAE,mBAAmB;GACrB;;EAEF,IAAI,EAAE,QAAQ,KAAK;GACjB,EAAE,kBAAkB;GACpB,UAAU,EAAE;;;CAIhB,IAAI,UAAU,OAAO,OAAO,OAAO,aAAa,SAAS,CAAC;CAC1D,OAAO"}

package/dist/foundations/interactions/roving-focus.js.map

@@ -1 +1 @@
-{"version":3,"file":"roving-focus.js","names":[],"sources":["../../../src/foundations/interactions/roving-focus.ts"],"sourcesContent":["/**\n * rovingFocus\n *\n * Single tab stop navigation with arrow-key control.\n *\n * INVARIANTS:\n * 1. Only one item in the group is reachable via Tab (single tab stop)\n * 2. Arrow keys move focus within the group\n * 3. Orientation determines which arrow keys are active\n * 4. Looping is opt-in\n * 5. Disabled items are skipped\n * 6. Returns props objects, never factories (composes via mergeProps)\n *\n * DESIGN:\n * - Container gets onKeyDown for arrow navigation\n * - Each item gets tabIndex based on current selection\n * - Navigation logic is pure - caller controls focus application\n * - Disabled check happens per-item via predicate\n *\n * PIT OF SUCCESS:\n * ✓ Can't accidentally break tab order (tabIndex assigned correctly)\n * ✓ Can't duplicate navigation logic (single source)\n * ✓ Composes via mergeProps (all standard props)\n * ✓ Type-safe - invalid indices caught at call site\n *\n * USAGE:\n *   const nav = rovingFocus({\n *     currentIndex: 0,\n *     itemCount: 3,\n *     orientation: 'horizontal',\n *     onNavigate: setIndex\n *   });\n *\n *   <div {...nav.container}>\n *     <button {...nav.item(0)}>First</button>\n *     <button {...nav.item(1)}>Second</button>\n *   </div>\n *\n * MISUSE EXAMPLE (PREVENTED):\n *   ❌ Can't forget to set tabIndex - returned in item props\n *   ❌ Can't create conflicting arrow handlers - mergeProps composes\n *   ❌ Can't skip disabled items incorrectly - logic is internal\n */\n\nimport type { KeyboardLikeEvent } from '../utilities/event-types';\n\nexport type Orientation = 'horizontal' | 'vertical' | 'both';\n\nexport interface RovingFocusOptions {\n  /**\n   * Current focused index\n   */\n  currentIndex: number;\n\n  /**\n   * Total number of items\n   */\n  itemCount: number;\n\n  /**\n   * Navigation orientation\n   * - horizontal: ArrowLeft/ArrowRight\n   * - vertical: ArrowUp/ArrowDown\n   * - both: all arrow keys\n   */\n  orientation?: Orientation;\n\n  /**\n   * Whether to loop when reaching the end\n   */\n  loop?: boolean;\n\n  /**\n   * Callback when navigation occurs\n   */\n  onNavigate?: (index: number) => void;\n\n  /**\n   * Optional disabled state check per index\n   */\n  isDisabled?: (index: number) => boolean;\n}\n\nexport interface RovingFocusResult {\n  /**\n   * Props for the container element (composes via mergeProps)\n   */\n  container: {\n    onKeyDown: (e: KeyboardLikeEvent) => void;\n  };\n\n  /**\n   * Generate props for an item at the given index (composes via mergeProps)\n   */\n  item: (index: number) => {\n    tabIndex: number;\n    'data-roving-index': number;\n  };\n}\n\nexport function rovingFocus(options: RovingFocusOptions): RovingFocusResult {\n  const {\n    currentIndex,\n    itemCount,\n    orientation = 'horizontal',\n    loop = false,\n    onNavigate,\n    isDisabled,\n  } = options;\n\n  function findNextIndex(from: number, direction: 1 | -1): number | undefined {\n    let next = from + direction;\n\n    // Handle looping\n    if (loop) {\n      if (next < 0) next = itemCount - 1;\n      if (next >= itemCount) next = 0;\n    } else {\n      if (next < 0 || next >= itemCount) return undefined;\n    }\n\n    // Skip disabled items\n    if (isDisabled?.(next)) {\n      // Recursively find the next non-disabled item\n      if (next === from) return undefined; // Prevent infinite loop\n      return findNextIndex(next, direction);\n    }\n\n    return next;\n  }\n\n  function handleKeyDown(e: KeyboardLikeEvent) {\n    const { key } = e;\n\n    let direction: 1 | -1 | undefined;\n\n    if (orientation === 'horizontal' || orientation === 'both') {\n      if (key === 'ArrowRight') direction = 1;\n      if (key === 'ArrowLeft') direction = -1;\n    }\n\n    if (orientation === 'vertical' || orientation === 'both') {\n      if (key === 'ArrowDown') direction = 1;\n      if (key === 'ArrowUp') direction = -1;\n    }\n\n    if (direction === undefined) return;\n\n    const nextIndex = findNextIndex(currentIndex, direction);\n    if (nextIndex === undefined) return;\n\n    e.preventDefault?.();\n    e.stopPropagation?.();\n\n    onNavigate?.(nextIndex);\n  }\n\n  return {\n    container: {\n      onKeyDown: handleKeyDown,\n    },\n    item: (index: number) => ({\n      tabIndex: index === currentIndex ? 0 : -1,\n      'data-roving-index': index,\n    }),\n  };\n}\n\n/**\n * USAGE EXAMPLE:\n *\n * function Menu() {\n *   const [focusIndex, setFocusIndex] = state(0);\n *   const items = ['File', 'Edit', 'View'];\n *\n *   const navigation = rovingFocus({\n *     currentIndex: focusIndex(),\n *     itemCount: items.length,\n *     orientation: 'horizontal',\n *     loop: true,\n *     onNavigate: setFocusIndex,\n *   });\n *\n *   return (\n *     <div {...navigation.container}>\n *       {items.map((label, index) => (\n *         <button {...navigation.item(index)}>\n *           {label}\n *         </button>\n *       ))}\n *     </div>\n *   );\n * }\n */\n"],"mappings":";AAoGA,SAAgB,YAAY,SAAgD;CAC1E,MAAM,EACJ,cACA,WACA,cAAc,cACd,OAAO,OACP,YACA,eACE;CAEJ,SAAS,cAAc,MAAc,WAAuC;EAC1E,IAAI,OAAO,OAAO;AAGlB,MAAI,MAAM;AACR,OAAI,OAAO,EAAG,QAAO,YAAY;AACjC,OAAI,QAAQ,UAAW,QAAO;aAE1B,OAAO,KAAK,QAAQ,UAAW,QAAO;AAI5C,MAAI,aAAa,KAAK,EAAE;AAEtB,OAAI,SAAS,KAAM,QAAO;AAC1B,UAAO,cAAc,MAAM,UAAU;;AAGvC,SAAO;;CAGT,SAAS,cAAc,GAAsB;EAC3C,MAAM,EAAE,QAAQ;EAEhB,IAAI;AAEJ,MAAI,gBAAgB,gBAAgB,gBAAgB,QAAQ;AAC1D,OAAI,QAAQ,aAAc,aAAY;AACtC,OAAI,QAAQ,YAAa,aAAY;;AAGvC,MAAI,gBAAgB,cAAc,gBAAgB,QAAQ;AACxD,OAAI,QAAQ,YAAa,aAAY;AACrC,OAAI,QAAQ,UAAW,aAAY;;AAGrC,MAAI,cAAc,OAAW;EAE7B,MAAM,YAAY,cAAc,cAAc,UAAU;AACxD,MAAI,cAAc,OAAW;AAE7B,IAAE,kBAAkB;AACpB,IAAE,mBAAmB;AAErB,eAAa,UAAU;;AAGzB,QAAO;EACL,WAAW,EACT,WAAW,eACZ;EACD,OAAO,WAAmB;GACxB,UAAU,UAAU,eAAe,IAAI;GACvC,qBAAqB;GACtB;EACF"}
+{"version":3,"file":"roving-focus.js","names":[],"sources":["../../../src/foundations/interactions/roving-focus.ts"],"sourcesContent":["/**\n * rovingFocus\n *\n * Single tab stop navigation with arrow-key control.\n *\n * INVARIANTS:\n * 1. Only one item in the group is reachable via Tab (single tab stop)\n * 2. Arrow keys move focus within the group\n * 3. Orientation determines which arrow keys are active\n * 4. Looping is opt-in\n * 5. Disabled items are skipped\n * 6. Returns props objects, never factories (composes via mergeProps)\n *\n * DESIGN:\n * - Container gets onKeyDown for arrow navigation\n * - Each item gets tabIndex based on current selection\n * - Navigation logic is pure - caller controls focus application\n * - Disabled check happens per-item via predicate\n *\n * PIT OF SUCCESS:\n * ✓ Can't accidentally break tab order (tabIndex assigned correctly)\n * ✓ Can't duplicate navigation logic (single source)\n * ✓ Composes via mergeProps (all standard props)\n * ✓ Type-safe - invalid indices caught at call site\n *\n * USAGE:\n *   const nav = rovingFocus({\n *     currentIndex: 0,\n *     itemCount: 3,\n *     orientation: 'horizontal',\n *     onNavigate: setIndex\n *   });\n *\n *   <div {...nav.container}>\n *     <button {...nav.item(0)}>First</button>\n *     <button {...nav.item(1)}>Second</button>\n *   </div>\n *\n * MISUSE EXAMPLE (PREVENTED):\n *   ❌ Can't forget to set tabIndex - returned in item props\n *   ❌ Can't create conflicting arrow handlers - mergeProps composes\n *   ❌ Can't skip disabled items incorrectly - logic is internal\n */\n\nimport type { KeyboardLikeEvent } from '../utilities/event-types';\n\nexport type Orientation = 'horizontal' | 'vertical' | 'both';\n\nexport interface RovingFocusOptions {\n  /**\n   * Current focused index\n   */\n  currentIndex: number;\n\n  /**\n   * Total number of items\n   */\n  itemCount: number;\n\n  /**\n   * Navigation orientation\n   * - horizontal: ArrowLeft/ArrowRight\n   * - vertical: ArrowUp/ArrowDown\n   * - both: all arrow keys\n   */\n  orientation?: Orientation;\n\n  /**\n   * Whether to loop when reaching the end\n   */\n  loop?: boolean;\n\n  /**\n   * Callback when navigation occurs\n   */\n  onNavigate?: (index: number) => void;\n\n  /**\n   * Optional disabled state check per index\n   */\n  isDisabled?: (index: number) => boolean;\n}\n\nexport interface RovingFocusResult {\n  /**\n   * Props for the container element (composes via mergeProps)\n   */\n  container: {\n    onKeyDown: (e: KeyboardLikeEvent) => void;\n  };\n\n  /**\n   * Generate props for an item at the given index (composes via mergeProps)\n   */\n  item: (index: number) => {\n    tabIndex: number;\n    'data-roving-index': number;\n  };\n}\n\nexport function rovingFocus(options: RovingFocusOptions): RovingFocusResult {\n  const {\n    currentIndex,\n    itemCount,\n    orientation = 'horizontal',\n    loop = false,\n    onNavigate,\n    isDisabled,\n  } = options;\n\n  function findNextIndex(from: number, direction: 1 | -1): number | undefined {\n    let next = from + direction;\n\n    // Handle looping\n    if (loop) {\n      if (next < 0) next = itemCount - 1;\n      if (next >= itemCount) next = 0;\n    } else {\n      if (next < 0 || next >= itemCount) return undefined;\n    }\n\n    // Skip disabled items\n    if (isDisabled?.(next)) {\n      // Recursively find the next non-disabled item\n      if (next === from) return undefined; // Prevent infinite loop\n      return findNextIndex(next, direction);\n    }\n\n    return next;\n  }\n\n  function handleKeyDown(e: KeyboardLikeEvent) {\n    const { key } = e;\n\n    let direction: 1 | -1 | undefined;\n\n    if (orientation === 'horizontal' || orientation === 'both') {\n      if (key === 'ArrowRight') direction = 1;\n      if (key === 'ArrowLeft') direction = -1;\n    }\n\n    if (orientation === 'vertical' || orientation === 'both') {\n      if (key === 'ArrowDown') direction = 1;\n      if (key === 'ArrowUp') direction = -1;\n    }\n\n    if (direction === undefined) return;\n\n    const nextIndex = findNextIndex(currentIndex, direction);\n    if (nextIndex === undefined) return;\n\n    e.preventDefault?.();\n    e.stopPropagation?.();\n\n    onNavigate?.(nextIndex);\n  }\n\n  return {\n    container: {\n      onKeyDown: handleKeyDown,\n    },\n    item: (index: number) => ({\n      tabIndex: index === currentIndex ? 0 : -1,\n      'data-roving-index': index,\n    }),\n  };\n}\n\n/**\n * USAGE EXAMPLE:\n *\n * function Menu() {\n *   const [focusIndex, setFocusIndex] = state(0);\n *   const items = ['File', 'Edit', 'View'];\n *\n *   const navigation = rovingFocus({\n *     currentIndex: focusIndex(),\n *     itemCount: items.length,\n *     orientation: 'horizontal',\n *     loop: true,\n *     onNavigate: setFocusIndex,\n *   });\n *\n *   return (\n *     <div {...navigation.container}>\n *       {items.map((label, index) => (\n *         <button {...navigation.item(index)}>\n *           {label}\n *         </button>\n *       ))}\n *     </div>\n *   );\n * }\n */\n"],"mappings":";AAoGA,SAAgB,YAAY,SAAgD;CAC1E,MAAM,EACJ,cACA,WACA,cAAc,cACd,OAAO,OACP,YACA,eACE;CAEJ,SAAS,cAAc,MAAc,WAAuC;EAC1E,IAAI,OAAO,OAAO;EAGlB,IAAI,MAAM;GACR,IAAI,OAAO,GAAG,OAAO,YAAY;GACjC,IAAI,QAAQ,WAAW,OAAO;SAE9B,IAAI,OAAO,KAAK,QAAQ,WAAW,OAAO;EAI5C,IAAI,aAAa,KAAK,EAAE;GAEtB,IAAI,SAAS,MAAM,OAAO;GAC1B,OAAO,cAAc,MAAM,UAAU;;EAGvC,OAAO;;CAGT,SAAS,cAAc,GAAsB;EAC3C,MAAM,EAAE,QAAQ;EAEhB,IAAI;EAEJ,IAAI,gBAAgB,gBAAgB,gBAAgB,QAAQ;GAC1D,IAAI,QAAQ,cAAc,YAAY;GACtC,IAAI,QAAQ,aAAa,YAAY;;EAGvC,IAAI,gBAAgB,cAAc,gBAAgB,QAAQ;GACxD,IAAI,QAAQ,aAAa,YAAY;GACrC,IAAI,QAAQ,WAAW,YAAY;;EAGrC,IAAI,cAAc,QAAW;EAE7B,MAAM,YAAY,cAAc,cAAc,UAAU;EACxD,IAAI,cAAc,QAAW;EAE7B,EAAE,kBAAkB;EACpB,EAAE,mBAAmB;EAErB,aAAa,UAAU;;CAGzB,OAAO;EACL,WAAW,EACT,WAAW,eACZ;EACD,OAAO,WAAmB;GACxB,UAAU,UAAU,eAAe,IAAI;GACvC,qBAAqB;GACtB;EACF"}

package/dist/foundations/state/controllable.js.map

@@ -1 +1 @@
-{"version":3,"file":"controllable.js","names":[],"sources":["../../../src/foundations/state/controllable.ts"],"sourcesContent":["/**\n * controllable\n *\n * Small utilities for controlled vs uncontrolled components. These helpers are\n * intentionally minimal and do not manage state themselves; they help component\n * implementations make correct decisions about when to call `onChange` vs\n * update internal state.\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Controlled Detection\n *    A value is \"controlled\" if it is not `undefined`.\n *    This matches React conventions and is SSR-safe.\n *\n * 2. onChange Timing\n *    - Controlled mode: onChange called immediately, no internal update\n *    - Uncontrolled mode: internal state updated first, then onChange called\n *    This ensures onChange sees the new value in both modes.\n *\n * 3. Value Equality\n *    controllableState uses Object.is() to prevent unnecessary onChange calls.\n *    This is intentional — strict equality, no deep comparison.\n */\n\nimport { state, type State } from '../../runtime/state';\n\nexport function isControlled<T>(value: T | undefined): value is T {\n  return value !== undefined;\n}\n\nexport function resolveControllable<T>(\n  value: T | undefined,\n  defaultValue: T\n): { value: T; isControlled: boolean } {\n  const controlled = isControlled(value);\n  return {\n    value: controlled ? (value as T) : defaultValue,\n    isControlled: controlled,\n  };\n}\n\nexport function makeControllable<T>(options: {\n  value: T | undefined;\n  defaultValue: T;\n  onChange?: (next: T) => void;\n  setInternal?: (next: T) => void;\n}) {\n  const { value, defaultValue, onChange, setInternal } = options;\n  const { isControlled } = resolveControllable(value, defaultValue);\n\n  function set(next: T) {\n    if (isControlled) {\n      onChange?.(next);\n    } else {\n      setInternal?.(next);\n      onChange?.(next);\n    }\n  }\n\n  return { set, isControlled };\n}\n\nexport type ControllableState<T> = State<T> & { isControlled: boolean };\n\n/**\n * controllableState\n *\n * Hook-like primitive that mirrors `state()` semantics while supporting\n * controlled/uncontrolled behavior.\n */\nexport function controllableState<T>(options: {\n  value: T | undefined;\n  defaultValue: T;\n  onChange?: (next: T) => void;\n}): ControllableState<T> {\n  const isControlled = options.value !== undefined;\n  const internal = isControlled ? null : state<T>(options.defaultValue);\n\n  function read(): T {\n    if (isControlled) {\n      return options.value as T;\n    }\n\n    return internal!();\n  }\n\n  read.set = (nextOrUpdater: T | ((prev: T) => T)) => {\n    const prev = read();\n    const next =\n      typeof nextOrUpdater === 'function'\n        ? (nextOrUpdater as (p: T) => T)(prev)\n        : (nextOrUpdater as T);\n\n    if (Object.is(prev, next)) return;\n\n    if (isControlled) {\n      options.onChange?.(next);\n      return;\n    }\n\n    internal!.set(nextOrUpdater as never);\n    options.onChange?.(next);\n  };\n\n  (read as ControllableState<T>).isControlled = isControlled;\n  return read as ControllableState<T>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,aAAgB,OAAkC;AAChE,QAAO,UAAU;;AAGnB,SAAgB,oBACd,OACA,cACqC;CACrC,MAAM,aAAa,aAAa,MAAM;AACtC,QAAO;EACL,OAAO,aAAc,QAAc;EACnC,cAAc;EACf;;AAGH,SAAgB,iBAAoB,SAKjC;CACD,MAAM,EAAE,OAAO,cAAc,UAAU,gBAAgB;CACvD,MAAM,EAAE,iBAAiB,oBAAoB,OAAO,aAAa;CAEjE,SAAS,IAAI,MAAS;AACpB,MAAI,aACF,YAAW,KAAK;OACX;AACL,iBAAc,KAAK;AACnB,cAAW,KAAK;;;AAIpB,QAAO;EAAE;EAAK;EAAc;;;;;;;;AAW9B,SAAgB,kBAAqB,SAIZ;CACvB,MAAM,eAAe,QAAQ,UAAU;CACvC,MAAM,WAAW,eAAe,OAAO,MAAS,QAAQ,aAAa;CAErE,SAAS,OAAU;AACjB,MAAI,aACF,QAAO,QAAQ;AAGjB,SAAO,UAAW;;AAGpB,MAAK,OAAO,kBAAwC;EAClD,MAAM,OAAO,MAAM;EACnB,MAAM,OACJ,OAAO,kBAAkB,aACpB,cAA8B,KAAK,GACnC;AAEP,MAAI,OAAO,GAAG,MAAM,KAAK,CAAE;AAE3B,MAAI,cAAc;AAChB,WAAQ,WAAW,KAAK;AACxB;;AAGF,WAAU,IAAI,cAAuB;AACrC,UAAQ,WAAW,KAAK;;AAGzB,MAA8B,eAAe;AAC9C,QAAO"}
+{"version":3,"file":"controllable.js","names":[],"sources":["../../../src/foundations/state/controllable.ts"],"sourcesContent":["/**\n * controllable\n *\n * Small utilities for controlled vs uncontrolled components. These helpers are\n * intentionally minimal and do not manage state themselves; they help component\n * implementations make correct decisions about when to call `onChange` vs\n * update internal state.\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Controlled Detection\n *    A value is \"controlled\" if it is not `undefined`.\n *    This matches React conventions and is SSR-safe.\n *\n * 2. onChange Timing\n *    - Controlled mode: onChange called immediately, no internal update\n *    - Uncontrolled mode: internal state updated first, then onChange called\n *    This ensures onChange sees the new value in both modes.\n *\n * 3. Value Equality\n *    controllableState uses Object.is() to prevent unnecessary onChange calls.\n *    This is intentional — strict equality, no deep comparison.\n */\n\nimport { state, type State } from '../../runtime/state';\n\nexport function isControlled<T>(value: T | undefined): value is T {\n  return value !== undefined;\n}\n\nexport function resolveControllable<T>(\n  value: T | undefined,\n  defaultValue: T\n): { value: T; isControlled: boolean } {\n  const controlled = isControlled(value);\n  return {\n    value: controlled ? (value as T) : defaultValue,\n    isControlled: controlled,\n  };\n}\n\nexport function makeControllable<T>(options: {\n  value: T | undefined;\n  defaultValue: T;\n  onChange?: (next: T) => void;\n  setInternal?: (next: T) => void;\n}) {\n  const { value, defaultValue, onChange, setInternal } = options;\n  const { isControlled } = resolveControllable(value, defaultValue);\n\n  function set(next: T) {\n    if (isControlled) {\n      onChange?.(next);\n    } else {\n      setInternal?.(next);\n      onChange?.(next);\n    }\n  }\n\n  return { set, isControlled };\n}\n\nexport type ControllableState<T> = State<T> & { isControlled: boolean };\n\n/**\n * controllableState\n *\n * Hook-like primitive that mirrors `state()` semantics while supporting\n * controlled/uncontrolled behavior.\n */\nexport function controllableState<T>(options: {\n  value: T | undefined;\n  defaultValue: T;\n  onChange?: (next: T) => void;\n}): ControllableState<T> {\n  const isControlled = options.value !== undefined;\n  const internal = isControlled ? null : state<T>(options.defaultValue);\n\n  function read(): T {\n    if (isControlled) {\n      return options.value as T;\n    }\n\n    return internal!();\n  }\n\n  read.set = (nextOrUpdater: T | ((prev: T) => T)) => {\n    const prev = read();\n    const next =\n      typeof nextOrUpdater === 'function'\n        ? (nextOrUpdater as (p: T) => T)(prev)\n        : (nextOrUpdater as T);\n\n    if (Object.is(prev, next)) return;\n\n    if (isControlled) {\n      options.onChange?.(next);\n      return;\n    }\n\n    internal!.set(nextOrUpdater as never);\n    options.onChange?.(next);\n  };\n\n  (read as ControllableState<T>).isControlled = isControlled;\n  return read as ControllableState<T>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,aAAgB,OAAkC;CAChE,OAAO,UAAU;;AAGnB,SAAgB,oBACd,OACA,cACqC;CACrC,MAAM,aAAa,aAAa,MAAM;CACtC,OAAO;EACL,OAAO,aAAc,QAAc;EACnC,cAAc;EACf;;AAGH,SAAgB,iBAAoB,SAKjC;CACD,MAAM,EAAE,OAAO,cAAc,UAAU,gBAAgB;CACvD,MAAM,EAAE,iBAAiB,oBAAoB,OAAO,aAAa;CAEjE,SAAS,IAAI,MAAS;EACpB,IAAI,cACF,WAAW,KAAK;OACX;GACL,cAAc,KAAK;GACnB,WAAW,KAAK;;;CAIpB,OAAO;EAAE;EAAK;EAAc;;;;;;;;AAW9B,SAAgB,kBAAqB,SAIZ;CACvB,MAAM,eAAe,QAAQ,UAAU;CACvC,MAAM,WAAW,eAAe,OAAO,MAAS,QAAQ,aAAa;CAErE,SAAS,OAAU;EACjB,IAAI,cACF,OAAO,QAAQ;EAGjB,OAAO,UAAW;;CAGpB,KAAK,OAAO,kBAAwC;EAClD,MAAM,OAAO,MAAM;EACnB,MAAM,OACJ,OAAO,kBAAkB,aACpB,cAA8B,KAAK,GACnC;EAEP,IAAI,OAAO,GAAG,MAAM,KAAK,EAAE;EAE3B,IAAI,cAAc;GAChB,QAAQ,WAAW,KAAK;GACxB;;EAGF,SAAU,IAAI,cAAuB;EACrC,QAAQ,WAAW,KAAK;;CAG1B,KAA+B,eAAe;CAC9C,OAAO"}

package/dist/foundations/state/index.d.ts

@@ -0,0 +1,2 @@
+import { ControllableState, controllableState, isControlled, makeControllable, resolveControllable } from "./controllable.js";
+export { type ControllableState, controllableState, isControlled, makeControllable, resolveControllable };

package/dist/foundations/state/index.js

@@ -0,0 +1,2 @@
+import { controllableState, isControlled, makeControllable, resolveControllable } from "./controllable.js";
+export { controllableState, isControlled, makeControllable, resolveControllable };

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

@@ -1 +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"}
+{"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;EACjE,SAAS,IAAI,MAAM,KAAK;EAExB,aAAa;GACX,SAAS,OAAO,KAAK;;;CAIzB,SAAS,QAAyD;EAChE,OAAO,MAAM,KAAK,SAAS,QAAQ,CAAC;;CAGtC,SAAS,QAAc;EACrB,SAAS,OAAO;;CAGlB,SAAS,OAAe;EACtB,OAAO,SAAS;;CAGlB,OAAO;EACL;EACA;EACA;EACA;EACD"}

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

@@ -0,0 +1,8 @@
+import { JSXElement } from "../../common/jsx.js";
+import { LayoutComponent, layout } from "./layout.js";
+import { Slot, SlotProps } from "./slot.js";
+import { Presence, PresenceProps } from "./presence.js";
+import { DefaultPortal, Portal, PortalProps, definePortal } from "./portal.js";
+import { Collection, CollectionItem, createCollection } from "./collection.js";
+import { Layer, LayerManager, LayerOptions, createLayer } from "./layer.js";
+export { type Collection, type CollectionItem, DefaultPortal, type JSXElement, type Layer, type LayerManager, type LayerOptions, type LayoutComponent, Portal, type PortalProps, Presence, type PresenceProps, Slot, type SlotProps, createCollection, createLayer, definePortal, layout };

package/dist/foundations/structures/index.js

@@ -0,0 +1,7 @@
+import { DefaultPortal, Portal, definePortal } from "./portal.js";
+import { layout } from "./layout.js";
+import { Slot } from "./slot.js";
+import { Presence } from "./presence.js";
+import { createCollection } from "./collection.js";
+import { createLayer } from "./layer.js";
+export { DefaultPortal, Portal, Presence, Slot, createCollection, createLayer, definePortal, layout };

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

@@ -1 +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"}
+{"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;EAC7B,MAAM,KAAK,MAAM;EAEjB,SAAS,QAAiB;GACxB,OAAO,MAAM,MAAM,SAAS,IAAI,OAAO;;EAGzC,SAAS,aAAmB;GAC1B,MAAM,QAAQ,MAAM,WAAW,MAAM,EAAE,OAAO,GAAG;GACjD,IAAI,UAAU,IACZ,MAAM,OAAO,OAAO,EAAE;;EAI1B,OAAO;GACL;GACA;GACA;GACD;;CAGH,SAAS,SAA+B;EACtC,OAAO,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;IACvD,IAAI,UAAU,IACZ,MAAM,OAAO,OAAO,EAAE;;GAG3B,EAAE;;CAGL,SAAS,eAAqB;EAC5B,MAAM,MAAM,MAAM,MAAM,SAAS;EACjC,IAAI,KACF,IAAI,QAAQ,YAAY;;CAI5B,SAAS,qBAAqB,GAAuB;EACnD,MAAM,MAAM,MAAM,MAAM,SAAS;EACjC,IAAI,CAAC,KAAK;EAEV,MAAM,OAAO,IAAI,QAAQ;EACzB,IAAI,QAAQ,EAAE,kBAAkB,MAE9B;OAAI,CAAC,KAAK,SAAS,EAAE,OAAO,EAC1B,IAAI,QAAQ,mBAAmB,EAAE;SAInC,IAAI,QAAQ,mBAAmB,EAAE;;CAIrC,OAAO;EACL;EACA;EACA;EACA;EACD"}

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

@@ -1 +1 @@
-{"version":3,"file":"layout.js","names":[],"sources":["../../../src/foundations/structures/layout.tsx"],"sourcesContent":["/**\n * Layout helper.\n *\n * A layout is just a normal component that wraps children.\n * Persistence and reuse are handled by the runtime via component identity.\n *\n * This helper exists purely for readability and convention.\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Return Type is Opaque (unknown)\n *    Layout components return `unknown` to remain runtime-agnostic.\n *    The runtime owns concrete JSX element types.\n *\n * 2. Children Positioning\n *    Layout receives children as first argument (router-friendly).\n *    Props come second. This matches route layout conventions where\n *    children represent the nested route content.\n *\n * 3. Props Spreading\n *    Props are spread into the layout component. This is intentional\n *    and deterministic — no merging or composition.\n */\n\nexport type LayoutComponent<P = object> = (\n  props: P & { children?: unknown }\n) => unknown;\n\nexport function layout<P = object>(Layout: LayoutComponent<P>) {\n  return (children?: unknown, props?: P) => {\n    const mergedProps = { ...props, children } as P & { children?: unknown };\n    return Layout(mergedProps);\n  };\n}\n"],"mappings":";AA4BA,SAAgB,OAAmB,QAA4B;AAC7D,SAAQ,UAAoB,UAAc;AAExC,SAAO,OAAO;GADQ,GAAG;GAAO;GAClB,CAAY"}
+{"version":3,"file":"layout.js","names":[],"sources":["../../../src/foundations/structures/layout.tsx"],"sourcesContent":["/**\n * Layout helper.\n *\n * A layout is just a normal component that wraps children.\n * Persistence and reuse are handled by the runtime via component identity.\n *\n * This helper exists purely for readability and convention.\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Return Type is Opaque (unknown)\n *    Layout components return `unknown` to remain runtime-agnostic.\n *    The runtime owns concrete JSX element types.\n *\n * 2. Children Positioning\n *    Layout receives children as first argument (router-friendly).\n *    Props come second. This matches route layout conventions where\n *    children represent the nested route content.\n *\n * 3. Props Spreading\n *    Props are spread into the layout component. This is intentional\n *    and deterministic — no merging or composition.\n */\n\nexport type LayoutComponent<P = object> = (\n  props: P & { children?: unknown }\n) => unknown;\n\nexport function layout<P = object>(Layout: LayoutComponent<P>) {\n  return (children?: unknown, props?: P) => {\n    const mergedProps = { ...props, children } as P & { children?: unknown };\n    return Layout(mergedProps);\n  };\n}\n"],"mappings":";AA4BA,SAAgB,OAAmB,QAA4B;CAC7D,QAAQ,UAAoB,UAAc;EAExC,OAAO,OAAO;GADQ,GAAG;GAAO;GAClB,CAAY"}

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

@@ -1 +1 @@
-{"version":3,"file":"portal.js","names":[],"sources":["../../../src/foundations/structures/portal.tsx"],"sourcesContent":["/**\n * Portal / Host primitive.\n *\n * Foundations remain runtime-agnostic: a portal is an explicit read/write slot.\n * Scheduling and attachment are owned by the runtime when `createPortalSlot`\n * exists; otherwise this falls back to a local slot (deterministic, but does\n * not schedule updates).\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Local Mutable State\n *    Foundations may use local mutable state ONLY to model deterministic slots,\n *    never to coordinate timing, effects, or ordering. The fallback mode uses\n *    closure-local `mounted` and `value` variables which are non-escaping and\n *    deterministic.\n *\n * 2. Return Type Philosophy\n *    Portal call signatures return `unknown` (intentionally opaque). The runtime\n *    owns the concrete type. This prevents foundations from assuming JSX.Element\n *    or DOM node types, maintaining runtime-agnostic portability.\n */\n\nimport {\n  markReactivePropsDirtySource,\n  markReadableDerivedSubscribersDirty,\n  notifyReadableReaders,\n  recordReadableRead,\n  type ReadableSource,\n} from '../../runtime/readable';\n\nexport interface Portal<T = unknown> {\n  /** Mount point — rendered exactly once */\n  (): unknown;\n\n  /** Render content into the portal */\n  render(props: { children?: T }): unknown;\n}\n\nexport interface PortalProps {\n  children?: unknown;\n}\n\nfunction createPortalSlot<T>(): {\n  read(): unknown;\n  write(value: T | undefined): void;\n} {\n  let currentValue: T | undefined;\n\n  const source = (() => {\n    recordReadableRead(source);\n    return currentValue;\n  }) as ReadableSource<T | undefined>;\n\n  return {\n    read() {\n      return source();\n    },\n    write(value: T | undefined) {\n      if (Object.is(currentValue, value)) {\n        return;\n      }\n\n      currentValue = value;\n      markReadableDerivedSubscribersDirty(source);\n      markReactivePropsDirtySource(source);\n      notifyReadableReaders(source);\n    },\n  };\n}\n\nexport function definePortal<T = unknown>(): Portal<T> {\n  // Using `typeof createPortalSlot` is safe even if the identifier is not\n  // defined at runtime (it returns 'undefined' rather than throwing).\n  if (typeof createPortalSlot === 'function') {\n    const slot = createPortalSlot<T>();\n\n    function PortalHost() {\n      return slot.read();\n    }\n\n    PortalHost.render = function PortalRender(props: { children?: T }) {\n      slot.write(props.children);\n      return null;\n    };\n\n    return PortalHost as Portal<T>;\n  }\n\n  // Deterministic local fallback (SSR/tests). No runtime scheduling.\n  // Writes are accepted only after the host has rendered at least once.\n  //\n  // CRITICAL BEHAVIOR:\n  // - Writes update local state but do NOT trigger re-renders\n  // - The portal host will reflect changes only when the component tree\n  //   re-renders for other reasons (e.g., parent state change)\n  // - This is safe for SSR and tests where rendering is synchronous\n  //   and externally controlled\n  // - In runtime mode, createPortalSlot handles scheduling automatically\n  let mounted = false;\n  let value: T | undefined;\n\n  function PortalHostFallback() {\n    mounted = true;\n    return value as unknown;\n  }\n\n  PortalHostFallback.render = function PortalRenderFallback(props: {\n    children?: T;\n  }) {\n    if (!mounted) return null;\n    value = props.children;\n    return null;\n  };\n\n  return PortalHostFallback as Portal<T>;\n}\n\n/**\n * Default Portal Singleton\n *\n * POLICY (LOCKED):\n * There is exactly one default portal per runtime.\n * Tests must reset it explicitly using _resetDefaultPortal().\n * This ensures consistent portal behavior across the application\n * while maintaining test isolation.\n */\nlet _defaultPortal: Portal<unknown> | undefined;\n\nexport function _resetDefaultPortal(): void {\n  _defaultPortal = undefined;\n}\n\nfunction ensureDefaultPortal(): Portal<unknown> {\n  if (!_defaultPortal) _defaultPortal = definePortal<unknown>();\n  return _defaultPortal;\n}\n\nexport const DefaultPortal: Portal<unknown> = (() => {\n  function Host() {\n    const v = ensureDefaultPortal()();\n    return v === undefined ? null : v;\n  }\n  Host.render = function Render(props: { children?: unknown }) {\n    ensureDefaultPortal().render(props);\n    return null;\n  };\n  return Host as Portal<unknown>;\n})();\n\nexport function Portal(props: PortalProps): null {\n  DefaultPortal.render(props);\n  return null;\n}\n\n/**\n * NOTE:\n * createPortalSlot is a runtime primitive.\n * It owns scheduling, consistency, and SSR behavior.\n */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAS,mBAGP;CACA,IAAI;CAEJ,MAAM,gBAAgB;AACpB,qBAAmB,OAAO;AAC1B,SAAO;;AAGT,QAAO;EACL,OAAO;AACL,UAAO,QAAQ;;EAEjB,MAAM,OAAsB;AAC1B,OAAI,OAAO,GAAG,cAAc,MAAM,CAChC;AAGF,kBAAe;AACf,uCAAoC,OAAO;AAC3C,gCAA6B,OAAO;AACpC,yBAAsB,OAAO;;EAEhC;;AAGH,SAAgB,eAAuC;AAGrD,KAAI,OAAO,qBAAqB,YAAY;EAC1C,MAAM,OAAO,kBAAqB;EAElC,SAAS,aAAa;AACpB,UAAO,KAAK,MAAM;;AAGpB,aAAW,SAAS,SAAS,aAAa,OAAyB;AACjE,QAAK,MAAM,MAAM,SAAS;AAC1B,UAAO;;AAGT,SAAO;;CAaT,IAAI,UAAU;CACd,IAAI;CAEJ,SAAS,qBAAqB;AAC5B,YAAU;AACV,SAAO;;AAGT,oBAAmB,SAAS,SAAS,qBAAqB,OAEvD;AACD,MAAI,CAAC,QAAS,QAAO;AACrB,UAAQ,MAAM;AACd,SAAO;;AAGT,QAAO;;;;;;;;;;;AAYT,IAAI;AAMJ,SAAS,sBAAuC;AAC9C,KAAI,CAAC,eAAgB,kBAAiB,cAAuB;AAC7D,QAAO;;AAGT,MAAa,uBAAwC;CACnD,SAAS,OAAO;EACd,MAAM,IAAI,qBAAqB,EAAE;AACjC,SAAO,MAAM,SAAY,OAAO;;AAElC,MAAK,SAAS,SAAS,OAAO,OAA+B;AAC3D,uBAAqB,CAAC,OAAO,MAAM;AACnC,SAAO;;AAET,QAAO;IACL;AAEJ,SAAgB,OAAO,OAA0B;AAC/C,eAAc,OAAO,MAAM;AAC3B,QAAO"}
+{"version":3,"file":"portal.js","names":[],"sources":["../../../src/foundations/structures/portal.tsx"],"sourcesContent":["/**\n * Portal / Host primitive.\n *\n * Foundations remain runtime-agnostic: a portal is an explicit read/write slot.\n * Scheduling and attachment are owned by the runtime when `createPortalSlot`\n * exists; otherwise this falls back to a local slot (deterministic, but does\n * not schedule updates).\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Local Mutable State\n *    Foundations may use local mutable state ONLY to model deterministic slots,\n *    never to coordinate timing, effects, or ordering. The fallback mode uses\n *    closure-local `mounted` and `value` variables which are non-escaping and\n *    deterministic.\n *\n * 2. Return Type Philosophy\n *    Portal call signatures return `unknown` (intentionally opaque). The runtime\n *    owns the concrete type. This prevents foundations from assuming JSX.Element\n *    or DOM node types, maintaining runtime-agnostic portability.\n */\n\nimport {\n  markReactivePropsDirtySource,\n  markReadableDerivedSubscribersDirty,\n  notifyReadableReaders,\n  recordReadableRead,\n  type ReadableSource,\n} from '../../runtime/readable';\n\nexport interface Portal<T = unknown> {\n  /** Mount point — rendered exactly once */\n  (): unknown;\n\n  /** Render content into the portal */\n  render(props: { children?: T }): unknown;\n}\n\nexport interface PortalProps {\n  children?: unknown;\n}\n\nfunction createPortalSlot<T>(): {\n  read(): unknown;\n  write(value: T | undefined): void;\n} {\n  let currentValue: T | undefined;\n\n  const source = (() => {\n    recordReadableRead(source);\n    return currentValue;\n  }) as ReadableSource<T | undefined>;\n\n  return {\n    read() {\n      return source();\n    },\n    write(value: T | undefined) {\n      if (Object.is(currentValue, value)) {\n        return;\n      }\n\n      currentValue = value;\n      markReadableDerivedSubscribersDirty(source);\n      markReactivePropsDirtySource(source);\n      notifyReadableReaders(source);\n    },\n  };\n}\n\nexport function definePortal<T = unknown>(): Portal<T> {\n  // Using `typeof createPortalSlot` is safe even if the identifier is not\n  // defined at runtime (it returns 'undefined' rather than throwing).\n  if (typeof createPortalSlot === 'function') {\n    const slot = createPortalSlot<T>();\n\n    function PortalHost() {\n      return slot.read();\n    }\n\n    PortalHost.render = function PortalRender(props: { children?: T }) {\n      slot.write(props.children);\n      return null;\n    };\n\n    return PortalHost as Portal<T>;\n  }\n\n  // Deterministic local fallback (SSR/tests). No runtime scheduling.\n  // Writes are accepted only after the host has rendered at least once.\n  //\n  // CRITICAL BEHAVIOR:\n  // - Writes update local state but do NOT trigger re-renders\n  // - The portal host will reflect changes only when the component tree\n  //   re-renders for other reasons (e.g., parent state change)\n  // - This is safe for SSR and tests where rendering is synchronous\n  //   and externally controlled\n  // - In runtime mode, createPortalSlot handles scheduling automatically\n  let mounted = false;\n  let value: T | undefined;\n\n  function PortalHostFallback() {\n    mounted = true;\n    return value as unknown;\n  }\n\n  PortalHostFallback.render = function PortalRenderFallback(props: {\n    children?: T;\n  }) {\n    if (!mounted) return null;\n    value = props.children;\n    return null;\n  };\n\n  return PortalHostFallback as Portal<T>;\n}\n\n/**\n * Default Portal Singleton\n *\n * POLICY (LOCKED):\n * There is exactly one default portal per runtime.\n * Tests must reset it explicitly using _resetDefaultPortal().\n * This ensures consistent portal behavior across the application\n * while maintaining test isolation.\n */\nlet _defaultPortal: Portal<unknown> | undefined;\n\nexport function _resetDefaultPortal(): void {\n  _defaultPortal = undefined;\n}\n\nfunction ensureDefaultPortal(): Portal<unknown> {\n  if (!_defaultPortal) _defaultPortal = definePortal<unknown>();\n  return _defaultPortal;\n}\n\nexport const DefaultPortal: Portal<unknown> = (() => {\n  function Host() {\n    const v = ensureDefaultPortal()();\n    return v === undefined ? null : v;\n  }\n  Host.render = function Render(props: { children?: unknown }) {\n    ensureDefaultPortal().render(props);\n    return null;\n  };\n  return Host as Portal<unknown>;\n})();\n\nexport function Portal(props: PortalProps): null {\n  DefaultPortal.render(props);\n  return null;\n}\n\n/**\n * NOTE:\n * createPortalSlot is a runtime primitive.\n * It owns scheduling, consistency, and SSR behavior.\n */\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA0CA,SAAS,mBAGP;CACA,IAAI;CAEJ,MAAM,gBAAgB;EACpB,mBAAmB,OAAO;EAC1B,OAAO;;CAGT,OAAO;EACL,OAAO;GACL,OAAO,QAAQ;;EAEjB,MAAM,OAAsB;GAC1B,IAAI,OAAO,GAAG,cAAc,MAAM,EAChC;GAGF,eAAe;GACf,oCAAoC,OAAO;GAC3C,6BAA6B,OAAO;GACpC,sBAAsB,OAAO;;EAEhC;;AAGH,SAAgB,eAAuC;CAGrD,IAAI,OAAO,qBAAqB,YAAY;EAC1C,MAAM,OAAO,kBAAqB;EAElC,SAAS,aAAa;GACpB,OAAO,KAAK,MAAM;;EAGpB,WAAW,SAAS,SAAS,aAAa,OAAyB;GACjE,KAAK,MAAM,MAAM,SAAS;GAC1B,OAAO;;EAGT,OAAO;;CAaT,IAAI,UAAU;CACd,IAAI;CAEJ,SAAS,qBAAqB;EAC5B,UAAU;EACV,OAAO;;CAGT,mBAAmB,SAAS,SAAS,qBAAqB,OAEvD;EACD,IAAI,CAAC,SAAS,OAAO;EACrB,QAAQ,MAAM;EACd,OAAO;;CAGT,OAAO;;;;;;;;;;;AAYT,IAAI;AAMJ,SAAS,sBAAuC;CAC9C,IAAI,CAAC,gBAAgB,iBAAiB,cAAuB;CAC7D,OAAO;;AAGT,MAAa,uBAAwC;CACnD,SAAS,OAAO;EACd,MAAM,IAAI,qBAAqB,EAAE;EACjC,OAAO,MAAM,SAAY,OAAO;;CAElC,KAAK,SAAS,SAAS,OAAO,OAA+B;EAC3D,qBAAqB,CAAC,OAAO,MAAM;EACnC,OAAO;;CAET,OAAO;IACL;AAEJ,SAAgB,OAAO,OAA0B;CAC/C,cAAc,OAAO,MAAM;CAC3B,OAAO"}

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

@@ -1 +1 @@
-{"version":3,"file":"presence.js","names":[],"sources":["../../../src/foundations/structures/presence.ts"],"sourcesContent":["import { ELEMENT_TYPE, Fragment } from '../../jsx';\nimport type { JSXElement } from '../../jsx';\n\nexport interface PresenceProps {\n  present: boolean | (() => boolean);\n  children?: unknown;\n}\n\n/**\n * Presence\n *\n * Structural policy primitive for conditional mount/unmount.\n * - No timers\n * - No animation coupling\n * - No DOM side-effects\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Present as Function\n *    Accepts boolean OR function to support lazy evaluation patterns.\n *    Function is called once per render. Use boolean form for static values.\n *\n * 2. Children Type\n *    `children` is intentionally `unknown` to remain runtime-agnostic.\n *    The runtime owns child normalization and validation.\n *\n * 3. Immediate Mount/Unmount\n *    No exit animations or transitions. When `present` becomes false,\n *    children are removed immediately. Animation must be layered above\n *    this primitive.\n */\nexport function Presence({\n  present,\n  children,\n}: PresenceProps): JSXElement | null {\n  const isPresent =\n    typeof present === 'function' ? present() : Boolean(present);\n  if (!isPresent) return null;\n\n  const element: JSXElement = {\n    $$typeof: ELEMENT_TYPE,\n    type: Fragment,\n    props: { children },\n    key: null,\n  };\n  return element;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,SAAgB,SAAS,EACvB,SACA,YACmC;AAGnC,KAAI,EADF,OAAO,YAAY,aAAa,SAAS,GAAG,QAAQ,QAAQ,EAC9C,QAAO;AAQvB,QAAO;EALL,UAAU;EACV,MAAM;EACN,OAAO,EAAE,UAAU;EACnB,KAAK;EAEA"}
+{"version":3,"file":"presence.js","names":[],"sources":["../../../src/foundations/structures/presence.ts"],"sourcesContent":["import { ELEMENT_TYPE, Fragment } from '../../jsx';\nimport type { JSXElement } from '../../jsx';\n\nexport interface PresenceProps {\n  present: boolean | (() => boolean);\n  children?: unknown;\n}\n\n/**\n * Presence\n *\n * Structural policy primitive for conditional mount/unmount.\n * - No timers\n * - No animation coupling\n * - No DOM side-effects\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Present as Function\n *    Accepts boolean OR function to support lazy evaluation patterns.\n *    Function is called once per render. Use boolean form for static values.\n *\n * 2. Children Type\n *    `children` is intentionally `unknown` to remain runtime-agnostic.\n *    The runtime owns child normalization and validation.\n *\n * 3. Immediate Mount/Unmount\n *    No exit animations or transitions. When `present` becomes false,\n *    children are removed immediately. Animation must be layered above\n *    this primitive.\n */\nexport function Presence({\n  present,\n  children,\n}: PresenceProps): JSXElement | null {\n  const isPresent =\n    typeof present === 'function' ? present() : Boolean(present);\n  if (!isPresent) return null;\n\n  const element: JSXElement = {\n    $$typeof: ELEMENT_TYPE,\n    type: Fragment,\n    props: { children },\n    key: null,\n  };\n  return element;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,SAAgB,SAAS,EACvB,SACA,YACmC;CAGnC,IAAI,EADF,OAAO,YAAY,aAAa,SAAS,GAAG,QAAQ,QAAQ,GAC9C,OAAO;CAQvB,OAAO;EALL,UAAU;EACV,MAAM;EACN,OAAO,EAAE,UAAU;EACnB,KAAK;EAEA"}

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

@@ -1 +1 @@
-{"version":3,"file":"slot.js","names":[],"sources":["../../../src/foundations/structures/slot.tsx"],"sourcesContent":["import { Fragment, cloneElement, isElement, ELEMENT_TYPE } from '../../jsx';\nimport type { JSXElement } from '../../jsx';\n\nexport type SlotProps =\n  | {\n      asChild: true;\n      children: JSXElement;\n      [key: string]: unknown;\n    }\n  | {\n      asChild?: false;\n      children?: unknown;\n    };\n\n/**\n * Slot\n *\n * Structural primitive for prop forwarding patterns.\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. asChild Pattern\n *    When asChild=true, merges props into the single child element.\n *    Child must be a valid JSXElement; non-element children return null.\n *    **Slot props override child props** (injection pattern).\n *\n * 2. Fallback Behavior\n *    When asChild=false, returns a Fragment (structural no-op).\n *    No DOM element is introduced.\n *\n * 3. Type Safety\n *    asChild=true requires exactly one JSXElement child (enforced by type).\n *    Runtime validates with isElement() check.\n */\nexport function Slot(props: SlotProps): JSXElement | null {\n  if (props.asChild) {\n    const { children, asChild: _asChild, ...rest } = props;\n\n    if (isElement(children)) {\n      return cloneElement(children, rest);\n    }\n    return null;\n  }\n\n  // Structural no-op: Slot does not introduce DOM\n  // Return a vnode object for the fragment with the internal element marker.\n  const element: JSXElement = {\n    $$typeof: ELEMENT_TYPE,\n    type: Fragment,\n    props: { children: props.children },\n    key: null,\n  };\n  return element;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,KAAK,OAAqC;AACxD,KAAI,MAAM,SAAS;EACjB,MAAM,EAAE,UAAU,SAAS,UAAU,GAAG,SAAS;AAEjD,MAAI,UAAU,SAAS,CACrB,QAAO,aAAa,UAAU,KAAK;AAErC,SAAO;;AAWT,QAAO;EALL,UAAU;EACV,MAAM;EACN,OAAO,EAAE,UAAU,MAAM,UAAU;EACnC,KAAK;EAEA"}
+{"version":3,"file":"slot.js","names":[],"sources":["../../../src/foundations/structures/slot.tsx"],"sourcesContent":["import { Fragment, cloneElement, isElement, ELEMENT_TYPE } from '../../jsx';\nimport type { JSXElement } from '../../jsx';\n\nexport type SlotProps =\n  | {\n      asChild: true;\n      children: JSXElement;\n      [key: string]: unknown;\n    }\n  | {\n      asChild?: false;\n      children?: unknown;\n    };\n\n/**\n * Slot\n *\n * Structural primitive for prop forwarding patterns.\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. asChild Pattern\n *    When asChild=true, merges props into the single child element.\n *    Child must be a valid JSXElement; non-element children return null.\n *    **Slot props override child props** (injection pattern).\n *\n * 2. Fallback Behavior\n *    When asChild=false, returns a Fragment (structural no-op).\n *    No DOM element is introduced.\n *\n * 3. Type Safety\n *    asChild=true requires exactly one JSXElement child (enforced by type).\n *    Runtime validates with isElement() check.\n */\nexport function Slot(props: SlotProps): JSXElement | null {\n  if (props.asChild) {\n    const { children, asChild: _asChild, ...rest } = props;\n\n    if (isElement(children)) {\n      return cloneElement(children, rest);\n    }\n    return null;\n  }\n\n  // Structural no-op: Slot does not introduce DOM\n  // Return a vnode object for the fragment with the internal element marker.\n  const element: JSXElement = {\n    $$typeof: ELEMENT_TYPE,\n    type: Fragment,\n    props: { children: props.children },\n    key: null,\n  };\n  return element;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAkCA,SAAgB,KAAK,OAAqC;CACxD,IAAI,MAAM,SAAS;EACjB,MAAM,EAAE,UAAU,SAAS,UAAU,GAAG,SAAS;EAEjD,IAAI,UAAU,SAAS,EACrB,OAAO,aAAa,UAAU,KAAK;EAErC,OAAO;;CAWT,OAAO;EALL,UAAU;EACV,MAAM;EACN,OAAO,EAAE,UAAU,MAAM,UAAU;EACnC,KAAK;EAEA"}

package/dist/foundations/utilities/aria.js.map

@@ -1 +1 @@
-{"version":3,"file":"aria.js","names":[],"sources":["../../../src/foundations/utilities/aria.ts"],"sourcesContent":["/**\n * Tiny aria helpers\n */\n\nexport function ariaDisabled(disabled?: boolean): { 'aria-disabled'?: 'true' } {\n  return disabled ? { 'aria-disabled': 'true' } : {};\n}\n\nexport function ariaExpanded(expanded?: boolean): {\n  'aria-expanded'?: 'true' | 'false';\n} {\n  return expanded === undefined\n    ? {}\n    : { 'aria-expanded': String(expanded) as 'true' | 'false' };\n}\n\nexport function ariaSelected(selected?: boolean): {\n  'aria-selected'?: 'true' | 'false';\n} {\n  return selected === undefined\n    ? {}\n    : { 'aria-selected': String(selected) as 'true' | 'false' };\n}\n"],"mappings":";;;;AAIA,SAAgB,aAAa,UAAkD;AAC7E,QAAO,WAAW,EAAE,iBAAiB,QAAQ,GAAG,EAAE;;AAGpD,SAAgB,aAAa,UAE3B;AACA,QAAO,aAAa,SAChB,EAAE,GACF,EAAE,iBAAiB,OAAO,SAAS,EAAsB;;AAG/D,SAAgB,aAAa,UAE3B;AACA,QAAO,aAAa,SAChB,EAAE,GACF,EAAE,iBAAiB,OAAO,SAAS,EAAsB"}
+{"version":3,"file":"aria.js","names":[],"sources":["../../../src/foundations/utilities/aria.ts"],"sourcesContent":["/**\n * Tiny aria helpers\n */\n\nexport function ariaDisabled(disabled?: boolean): { 'aria-disabled'?: 'true' } {\n  return disabled ? { 'aria-disabled': 'true' } : {};\n}\n\nexport function ariaExpanded(expanded?: boolean): {\n  'aria-expanded'?: 'true' | 'false';\n} {\n  return expanded === undefined\n    ? {}\n    : { 'aria-expanded': String(expanded) as 'true' | 'false' };\n}\n\nexport function ariaSelected(selected?: boolean): {\n  'aria-selected'?: 'true' | 'false';\n} {\n  return selected === undefined\n    ? {}\n    : { 'aria-selected': String(selected) as 'true' | 'false' };\n}\n"],"mappings":";;;;AAIA,SAAgB,aAAa,UAAkD;CAC7E,OAAO,WAAW,EAAE,iBAAiB,QAAQ,GAAG,EAAE;;AAGpD,SAAgB,aAAa,UAE3B;CACA,OAAO,aAAa,SAChB,EAAE,GACF,EAAE,iBAAiB,OAAO,SAAS,EAAsB;;AAG/D,SAAgB,aAAa,UAE3B;CACA,OAAO,aAAa,SAChB,EAAE,GACF,EAAE,iBAAiB,OAAO,SAAS,EAAsB"}

package/dist/foundations/utilities/compose-handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose-handlers.js","names":[],"sources":["../../../src/foundations/utilities/compose-handlers.ts"],"sourcesContent":["/**\n * composeHandlers\n *\n * Compose two event handlers into one. The first handler runs, and unless it\n * calls `event.preventDefault()` (or sets `defaultPrevented`), the second\n * handler runs. This prevents accidental clobbering of child handlers when\n * injecting props.\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Execution Order\n *    First handler runs before second (injected before base).\n *    This allows injected handlers to prevent default behavior.\n *\n * 2. Default Prevention Check\n *    By default, checks `defaultPrevented` on first argument.\n *    Can be disabled via options.checkDefaultPrevented = false.\n *\n * 3. Undefined Handler Support\n *    Undefined handlers are skipped (no-op). This simplifies usage\n *    where handlers are optional.\n *\n * 4. Type Safety\n *    Args are readonly to prevent mutation. Return type matches input.\n */\n\nexport interface ComposeHandlersOptions {\n  /**\n   * When true (default), do not run the second handler if the first prevented default.\n   * When false, always run both handlers.\n   */\n  checkDefaultPrevented?: boolean;\n}\n\nfunction isDefaultPrevented(\n  value: unknown\n): value is { defaultPrevented: true } {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'defaultPrevented' in value &&\n    (value as { defaultPrevented?: boolean }).defaultPrevented === true\n  );\n}\n\nexport function composeHandlers<A extends readonly unknown[]>(\n  first?: (...args: A) => void,\n  second?: (...args: A) => void,\n  options?: ComposeHandlersOptions\n): (...args: A) => void {\n  // Fast path: if neither handler exists, return stable no-op\n  if (!first && !second) {\n    return noop as (...args: A) => void;\n  }\n\n  // Fast path: if only one handler exists, return it directly\n  if (!first) return second!;\n  if (!second) return first;\n\n  // Composition path: both handlers exist\n  const checkDefaultPrevented = options?.checkDefaultPrevented !== false;\n\n  return function composed(...args: A) {\n    first(...args);\n\n    if (checkDefaultPrevented && isDefaultPrevented(args[0])) {\n      return;\n    }\n\n    second(...args);\n  } as (...args: A) => void;\n}\n\n// Stable no-op for fast path\nfunction noop() {}\n"],"mappings":";AAkCA,SAAS,mBACP,OACqC;AACrC,QACE,OAAO,UAAU,YACjB,UAAU,QACV,sBAAsB,SACrB,MAAyC,qBAAqB;;AAInE,SAAgB,gBACd,OACA,QACA,SACsB;AAEtB,KAAI,CAAC,SAAS,CAAC,OACb,QAAO;AAIT,KAAI,CAAC,MAAO,QAAO;AACnB,KAAI,CAAC,OAAQ,QAAO;CAGpB,MAAM,wBAAwB,SAAS,0BAA0B;AAEjE,QAAO,SAAS,SAAS,GAAG,MAAS;AACnC,QAAM,GAAG,KAAK;AAEd,MAAI,yBAAyB,mBAAmB,KAAK,GAAG,CACtD;AAGF,SAAO,GAAG,KAAK;;;AAKnB,SAAS,OAAO"}
+{"version":3,"file":"compose-handlers.js","names":[],"sources":["../../../src/foundations/utilities/compose-handlers.ts"],"sourcesContent":["/**\n * composeHandlers\n *\n * Compose two event handlers into one. The first handler runs, and unless it\n * calls `event.preventDefault()` (or sets `defaultPrevented`), the second\n * handler runs. This prevents accidental clobbering of child handlers when\n * injecting props.\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Execution Order\n *    First handler runs before second (injected before base).\n *    This allows injected handlers to prevent default behavior.\n *\n * 2. Default Prevention Check\n *    By default, checks `defaultPrevented` on first argument.\n *    Can be disabled via options.checkDefaultPrevented = false.\n *\n * 3. Undefined Handler Support\n *    Undefined handlers are skipped (no-op). This simplifies usage\n *    where handlers are optional.\n *\n * 4. Type Safety\n *    Args are readonly to prevent mutation. Return type matches input.\n */\n\nexport interface ComposeHandlersOptions {\n  /**\n   * When true (default), do not run the second handler if the first prevented default.\n   * When false, always run both handlers.\n   */\n  checkDefaultPrevented?: boolean;\n}\n\nfunction isDefaultPrevented(\n  value: unknown\n): value is { defaultPrevented: true } {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'defaultPrevented' in value &&\n    (value as { defaultPrevented?: boolean }).defaultPrevented === true\n  );\n}\n\nexport function composeHandlers<A extends readonly unknown[]>(\n  first?: (...args: A) => void,\n  second?: (...args: A) => void,\n  options?: ComposeHandlersOptions\n): (...args: A) => void {\n  // Fast path: if neither handler exists, return stable no-op\n  if (!first && !second) {\n    return noop as (...args: A) => void;\n  }\n\n  // Fast path: if only one handler exists, return it directly\n  if (!first) return second!;\n  if (!second) return first;\n\n  // Composition path: both handlers exist\n  const checkDefaultPrevented = options?.checkDefaultPrevented !== false;\n\n  return function composed(...args: A) {\n    first(...args);\n\n    if (checkDefaultPrevented && isDefaultPrevented(args[0])) {\n      return;\n    }\n\n    second(...args);\n  } as (...args: A) => void;\n}\n\n// Stable no-op for fast path\nfunction noop() {}\n"],"mappings":";AAkCA,SAAS,mBACP,OACqC;CACrC,OACE,OAAO,UAAU,YACjB,UAAU,QACV,sBAAsB,SACrB,MAAyC,qBAAqB;;AAInE,SAAgB,gBACd,OACA,QACA,SACsB;CAEtB,IAAI,CAAC,SAAS,CAAC,QACb,OAAO;CAIT,IAAI,CAAC,OAAO,OAAO;CACnB,IAAI,CAAC,QAAQ,OAAO;CAGpB,MAAM,wBAAwB,SAAS,0BAA0B;CAEjE,OAAO,SAAS,SAAS,GAAG,MAAS;EACnC,MAAM,GAAG,KAAK;EAEd,IAAI,yBAAyB,mBAAmB,KAAK,GAAG,EACtD;EAGF,OAAO,GAAG,KAAK;;;AAKnB,SAAS,OAAO"}

package/dist/foundations/utilities/compose-ref.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose-ref.js","names":[],"sources":["../../../src/foundations/utilities/compose-ref.ts"],"sourcesContent":["/**\n * Ref composition utilities\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Ref Types Supported\n *    - Callback refs: (value: T | null) => void\n *    - Object refs: { current: T | null }\n *    - null/undefined (no-op)\n *\n * 2. Write Failure Handling\n *    setRef catches write failures (readonly refs) and ignores them.\n *    This is intentional — refs may be readonly in some contexts.\n *\n * 3. Composition Order\n *    composeRefs applies refs in array order (left to right).\n *    All refs are called even if one fails.\n */\n\nexport type Ref<T> =\n  | ((value: T | null) => void)\n  | { current: T | null }\n  | null\n  | undefined;\n\nexport function setRef<T>(ref: Ref<T>, value: T | null): void {\n  if (!ref) return;\n  if (typeof ref === 'function') {\n    ref(value);\n    return;\n  }\n  // Fast path: use Object.isExtensible check instead of try/catch for better performance\n  if (Object.isExtensible(ref)) {\n    (ref as { current: T | null }).current = value;\n  }\n}\n\nexport function composeRefs<T>(\n  ...refs: Array<Ref<T>>\n): (value: T | null) => void {\n  return (value: T | null) => {\n    for (const ref of refs) setRef(ref, value);\n  };\n}\n"],"mappings":";AAyBA,SAAgB,OAAU,KAAa,OAAuB;AAC5D,KAAI,CAAC,IAAK;AACV,KAAI,OAAO,QAAQ,YAAY;AAC7B,MAAI,MAAM;AACV;;AAGF,KAAI,OAAO,aAAa,IAAI,CACzB,KAA8B,UAAU;;AAI7C,SAAgB,YACd,GAAG,MACwB;AAC3B,SAAQ,UAAoB;AAC1B,OAAK,MAAM,OAAO,KAAM,QAAO,KAAK,MAAM"}
+{"version":3,"file":"compose-ref.js","names":[],"sources":["../../../src/foundations/utilities/compose-ref.ts"],"sourcesContent":["/**\n * Ref composition utilities\n *\n * POLICY DECISIONS (LOCKED):\n *\n * 1. Ref Types Supported\n *    - Callback refs: (value: T | null) => void\n *    - Object refs: { current: T | null }\n *    - null/undefined (no-op)\n *\n * 2. Write Failure Handling\n *    setRef catches write failures (readonly refs) and ignores them.\n *    This is intentional — refs may be readonly in some contexts.\n *\n * 3. Composition Order\n *    composeRefs applies refs in array order (left to right).\n *    All refs are called even if one fails.\n */\n\nexport type Ref<T> =\n  | ((value: T | null) => void)\n  | { current: T | null }\n  | null\n  | undefined;\n\nexport function setRef<T>(ref: Ref<T>, value: T | null): void {\n  if (!ref) return;\n  if (typeof ref === 'function') {\n    ref(value);\n    return;\n  }\n  // Fast path: use Object.isExtensible check instead of try/catch for better performance\n  if (Object.isExtensible(ref)) {\n    (ref as { current: T | null }).current = value;\n  }\n}\n\nexport function composeRefs<T>(\n  ...refs: Array<Ref<T>>\n): (value: T | null) => void {\n  return (value: T | null) => {\n    for (const ref of refs) setRef(ref, value);\n  };\n}\n"],"mappings":";AAyBA,SAAgB,OAAU,KAAa,OAAuB;CAC5D,IAAI,CAAC,KAAK;CACV,IAAI,OAAO,QAAQ,YAAY;EAC7B,IAAI,MAAM;EACV;;CAGF,IAAI,OAAO,aAAa,IAAI,EAC1B,IAA+B,UAAU;;AAI7C,SAAgB,YACd,GAAG,MACwB;CAC3B,QAAQ,UAAoB;EAC1B,KAAK,MAAM,OAAO,MAAM,OAAO,KAAK,MAAM"}

package/dist/foundations/utilities/index.d.ts

@@ -0,0 +1,7 @@
+import { Ref, composeRefs, setRef } from "./compose-ref.js";
+import { DefaultPreventable, FocusLikeEvent, KeyboardLikeEvent, PointerLikeEvent, PropagationStoppable } from "./event-types.js";
+import { ComposeHandlersOptions, composeHandlers } from "./compose-handlers.js";
+import { mergeProps } from "./merge-props.js";
+import { ariaDisabled, ariaExpanded, ariaSelected } from "./aria.js";
+import { FormatIdOptions, formatId } from "./use-id.js";
+export { type ComposeHandlersOptions, type DefaultPreventable, type FocusLikeEvent, type FormatIdOptions, type KeyboardLikeEvent, type PointerLikeEvent, type PropagationStoppable, type Ref, ariaDisabled, ariaExpanded, ariaSelected, composeHandlers, composeRefs, formatId, mergeProps, setRef };

package/dist/foundations/utilities/index.js

@@ -0,0 +1,6 @@
+import { composeHandlers } from "./compose-handlers.js";
+import { mergeProps } from "./merge-props.js";
+import { ariaDisabled, ariaExpanded, ariaSelected } from "./aria.js";
+import { composeRefs, setRef } from "./compose-ref.js";
+import { formatId } from "./use-id.js";
+export { ariaDisabled, ariaExpanded, ariaSelected, composeHandlers, composeRefs, formatId, mergeProps, setRef };