@uifn/core 0.0.1

package/dist/chunk-4YPFHTID.js

@@ -0,0 +1,136 @@
+'use strict';
+
+var chunkRFARH4U4_js = require('./chunk-RFARH4U4.js');
+var chunkK3WYDUIN_js = require('./chunk-K3WYDUIN.js');
+var chunkEKMJ2G7A_js = require('./chunk-EKMJ2G7A.js');
+
+// src/primitives/toolbar.ts
+function normalizeItems(items) {
+  const dedupe = /* @__PURE__ */ new Map();
+  (items ?? []).forEach((item) => {
+    dedupe.set(item.id, item);
+  });
+  return Array.from(dedupe.values());
+}
+function resolveGroups(items) {
+  return items.reduce((acc, item) => {
+    if (!item.group) {
+      return acc;
+    }
+    const existing = acc[item.group] ?? [];
+    acc[item.group] = [...existing, item.id];
+    return acc;
+  }, {});
+}
+function getEnabledItemIds(items) {
+  return items.filter((item) => !item.disabled).map((item) => item.id);
+}
+function createToolbar(props) {
+  const items = normalizeItems(props.items);
+  const enabledItems = getEnabledItemIds(items);
+  const store = chunkK3WYDUIN_js.createStore({
+    orientation: props.orientation ?? "horizontal",
+    items,
+    focusedItem: enabledItems[0] ?? null,
+    groups: resolveGroups(items),
+    lastError: null
+  });
+  const actions = {
+    registerItem(item) {
+      const state = store.getState();
+      if (state.items.some((entry) => entry.id === item.id)) {
+        return;
+      }
+      const nextItems = [...state.items, item];
+      const nextEnabled = getEnabledItemIds(nextItems);
+      store.patchState({
+        items: nextItems,
+        groups: resolveGroups(nextItems),
+        focusedItem: state.focusedItem ?? nextEnabled[0] ?? null
+      });
+    },
+    setItems(nextItems) {
+      const normalized = normalizeItems(nextItems);
+      const nextEnabled = getEnabledItemIds(normalized);
+      const state = store.getState();
+      store.patchState({
+        items: normalized,
+        groups: resolveGroups(normalized),
+        focusedItem: nextEnabled.includes(state.focusedItem ?? "") ? state.focusedItem : nextEnabled[0] ?? null
+      });
+    },
+    focusItem(itemId) {
+      const state = store.getState();
+      if (itemId === null) {
+        store.patchState({
+          focusedItem: null
+        });
+        return;
+      }
+      if (!getEnabledItemIds(state.items).includes(itemId)) {
+        return;
+      }
+      store.patchState({
+        focusedItem: itemId
+      });
+    },
+    handleKeyDown(key, currentItem) {
+      const state = store.getState();
+      const enabled = getEnabledItemIds(state.items);
+      if (enabled.length === 0) {
+        return null;
+      }
+      const current = currentItem ?? state.focusedItem ?? enabled[0];
+      const currentIndex = Math.max(0, enabled.indexOf(current));
+      const nextIndex = chunkRFARH4U4_js.getNextRovingFocusIndex({
+        key,
+        itemCount: enabled.length,
+        currentIndex,
+        orientation: state.orientation
+      });
+      if (nextIndex < 0) {
+        return null;
+      }
+      const nextItem = enabled[nextIndex] ?? null;
+      if (!nextItem) {
+        return null;
+      }
+      store.patchState({
+        focusedItem: nextItem
+      });
+      return nextItem;
+    },
+    getGroupItems(group) {
+      const state = store.getState();
+      const groupItems = state.groups[group];
+      if (!groupItems) {
+        store.patchState({
+          lastError: chunkEKMJ2G7A_js.createUIFnError({
+            code: "UIFN_ERR_INVALID_VALUE",
+            package: "@uifn/core",
+            component: "Toolbar",
+            message: "Toolbar orientation and grouping semantics are documented and tested.",
+            recoverable: true,
+            details: {
+              group
+            }
+          })
+        });
+        return [];
+      }
+      return groupItems;
+    }
+  };
+  return {
+    get state() {
+      return store.getState();
+    },
+    actions,
+    getState: store.getState,
+    subscribe: store.subscribe
+  };
+}
+
+exports.createToolbar = createToolbar;
+//# sourceMappingURL=chunk-4YPFHTID.js.map
+//# sourceMappingURL=chunk-4YPFHTID.js.map

package/dist/chunk-4YPFHTID.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/primitives/toolbar.ts"],"names":["createStore","getNextRovingFocusIndex","createUIFnError"],"mappings":"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","file":"chunk-4YPFHTID.js","sourcesContent":["import { createUIFnError, type UIFnError } from '../errors';\nimport { getNextRovingFocusIndex } from '../utils/roving-focus';\nimport { createStore } from './shared';\n\nexport interface ToolbarItem {\n  id: string;\n  group?: string;\n  disabled?: boolean;\n}\n\nexport interface ToolbarProps {\n  orientation?: 'horizontal' | 'vertical';\n  items?: ToolbarItem[];\n}\n\nexport interface ToolbarState {\n  orientation: 'horizontal' | 'vertical';\n  items: ToolbarItem[];\n  focusedItem: string | null;\n  groups: Record<string, string[]>;\n  lastError: UIFnError | null;\n}\n\nexport interface ToolbarActions {\n  registerItem: (item: ToolbarItem) => void;\n  setItems: (items: ToolbarItem[]) => void;\n  focusItem: (itemId: string | null) => void;\n  handleKeyDown: (key: string, currentItem?: string | null) => string | null;\n  getGroupItems: (group: string) => string[];\n}\n\nexport interface ToolbarMachine {\n  readonly state: ToolbarState;\n  readonly actions: ToolbarActions;\n  getState: () => ToolbarState;\n  subscribe: (callback: (state: ToolbarState) => void) => () => void;\n}\n\nfunction normalizeItems(items: ToolbarItem[] | undefined): ToolbarItem[] {\n  const dedupe = new Map<string, ToolbarItem>();\n  (items ?? []).forEach((item) => {\n    dedupe.set(item.id, item);\n  });\n\n  return Array.from(dedupe.values());\n}\n\nfunction resolveGroups(items: ToolbarItem[]): Record<string, string[]> {\n  return items.reduce<Record<string, string[]>>((acc, item) => {\n    if (!item.group) {\n      return acc;\n    }\n\n    const existing = acc[item.group] ?? [];\n    acc[item.group] = [...existing, item.id];\n    return acc;\n  }, {});\n}\n\nfunction getEnabledItemIds(items: ToolbarItem[]): string[] {\n  return items.filter((item) => !item.disabled).map((item) => item.id);\n}\n\nexport function createToolbar(props: ToolbarProps): ToolbarMachine {\n  const items = normalizeItems(props.items);\n  const enabledItems = getEnabledItemIds(items);\n  const store = createStore<ToolbarState>({\n    orientation: props.orientation ?? 'horizontal',\n    items,\n    focusedItem: enabledItems[0] ?? null,\n    groups: resolveGroups(items),\n    lastError: null,\n  });\n\n  const actions: ToolbarActions = {\n    registerItem(item) {\n      const state = store.getState();\n      if (state.items.some((entry) => entry.id === item.id)) {\n        return;\n      }\n\n      const nextItems = [...state.items, item];\n      const nextEnabled = getEnabledItemIds(nextItems);\n      store.patchState({\n        items: nextItems,\n        groups: resolveGroups(nextItems),\n        focusedItem: state.focusedItem ?? nextEnabled[0] ?? null,\n      });\n    },\n    setItems(nextItems) {\n      const normalized = normalizeItems(nextItems);\n      const nextEnabled = getEnabledItemIds(normalized);\n      const state = store.getState();\n      store.patchState({\n        items: normalized,\n        groups: resolveGroups(normalized),\n        focusedItem: nextEnabled.includes(state.focusedItem ?? '')\n          ? state.focusedItem\n          : nextEnabled[0] ?? null,\n      });\n    },\n    focusItem(itemId) {\n      const state = store.getState();\n      if (itemId === null) {\n        store.patchState({\n          focusedItem: null,\n        });\n        return;\n      }\n\n      if (!getEnabledItemIds(state.items).includes(itemId)) {\n        return;\n      }\n\n      store.patchState({\n        focusedItem: itemId,\n      });\n    },\n    handleKeyDown(key, currentItem) {\n      const state = store.getState();\n      const enabled = getEnabledItemIds(state.items);\n      if (enabled.length === 0) {\n        return null;\n      }\n\n      const current = currentItem ?? state.focusedItem ?? enabled[0];\n      const currentIndex = Math.max(0, enabled.indexOf(current));\n      const nextIndex = getNextRovingFocusIndex({\n        key,\n        itemCount: enabled.length,\n        currentIndex,\n        orientation: state.orientation,\n      });\n\n      if (nextIndex < 0) {\n        return null;\n      }\n\n      const nextItem = enabled[nextIndex] ?? null;\n      if (!nextItem) {\n        return null;\n      }\n\n      store.patchState({\n        focusedItem: nextItem,\n      });\n      return nextItem;\n    },\n    getGroupItems(group) {\n      const state = store.getState();\n      const groupItems = state.groups[group];\n      if (!groupItems) {\n        store.patchState({\n          lastError: createUIFnError({\n            code: 'UIFN_ERR_INVALID_VALUE',\n            package: '@uifn/core',\n            component: 'Toolbar',\n            message: 'Toolbar orientation and grouping semantics are documented and tested.',\n            recoverable: true,\n            details: {\n              group,\n            },\n          }),\n        });\n        return [];\n      }\n\n      return groupItems;\n    },\n  };\n\n  return {\n    get state() {\n      return store.getState();\n    },\n    actions,\n    getState: store.getState,\n    subscribe: store.subscribe,\n  };\n}\n"]}

package/dist/chunk-5C57AF3A.js

@@ -0,0 +1,247 @@
+'use strict';
+
+var chunkJBMGXJ55_js = require('./chunk-JBMGXJ55.js');
+var chunkWV2D7BZS_js = require('./chunk-WV2D7BZS.js');
+var chunk75SPLZPF_js = require('./chunk-75SPLZPF.js');
+var chunkL67UQEPI_js = require('./chunk-L67UQEPI.js');
+var chunkK3WYDUIN_js = require('./chunk-K3WYDUIN.js');
+var chunkEKMJ2G7A_js = require('./chunk-EKMJ2G7A.js');
+
+// src/primitives/hover-card.ts
+function patchCleanup(store, presence) {
+  const presenceState = presence.getState();
+  store.patchState({
+    cleanup: {
+      timers: presenceState.timers,
+      listeners: presenceState.listeners,
+      complete: presenceState.cleanupComplete
+    }
+  });
+}
+function createHoverCard(props = {}) {
+  const openController = chunkL67UQEPI_js.createControllableStateController({
+    value: props.open,
+    defaultValue: props.defaultOpen ?? false,
+    onChange: props.onOpenChange
+  });
+  const open = openController.getValue();
+  const baseId = props.idBase ? chunk75SPLZPF_js.registerPublicId(props.idBase, {
+    package: "@uifn/core",
+    component: "HoverCard"
+  }) : chunk75SPLZPF_js.generateId("hover-card");
+  const store = chunkK3WYDUIN_js.createStore({
+    open,
+    controlled: openController.isControlled(),
+    ids: {
+      baseId,
+      triggerId: chunk75SPLZPF_js.registerPublicId(chunk75SPLZPF_js.composePublicId({ prefix: baseId, slot: "trigger" })),
+      contentId: chunk75SPLZPF_js.registerPublicId(chunk75SPLZPF_js.composePublicId({ prefix: baseId, slot: "content" }))
+    },
+    openDelay: props.openDelay ?? 700,
+    closeDelay: props.closeDelay ?? 300,
+    pendingOpenMs: null,
+    pendingCloseMs: null,
+    side: props.side ?? "bottom",
+    align: props.align ?? "center",
+    sideOffset: props.sideOffset ?? 5,
+    alignOffset: props.alignOffset ?? 0,
+    collisionPadding: props.collisionPadding ?? 5,
+    collisionDetection: props.collisionDetection ?? true,
+    position: null,
+    cleanup: {
+      timers: 0,
+      listeners: 0,
+      complete: !open
+    },
+    lastError: null
+  });
+  const presence = chunkJBMGXJ55_js.createPresenceManager(open, {
+    reducedMotion: props.reducedMotion ?? false
+  });
+  const applyOpen = (nextOpen, reason, source, inputModality) => {
+    const state = store.getState();
+    if (state.open === nextOpen && state.pendingOpenMs === null && state.pendingCloseMs === null) {
+      return;
+    }
+    const meta = {
+      source,
+      reason,
+      previousValue: state.open,
+      nextValue: nextOpen,
+      inputModality
+    };
+    const result = source === "controlled-sync" ? openController.syncValue(nextOpen) : openController.requestValue(nextOpen);
+    presence.setPresent(nextOpen);
+    if (!nextOpen) {
+      presence.cleanup();
+    }
+    store.patchState(
+      {
+        open: result.value,
+        pendingOpenMs: null,
+        pendingCloseMs: null,
+        cleanup: {
+          timers: presence.getState().timers,
+          listeners: presence.getState().listeners,
+          complete: presence.getState().cleanupComplete
+        },
+        lastChangeMeta: meta,
+        lastError: null
+      },
+      meta
+    );
+  };
+  const actions = {
+    open() {
+      applyOpen(true, "open-programmatic", "programmatic");
+    },
+    close() {
+      if (store.getState().pendingOpenMs !== null) {
+        presence.clearTimer();
+      }
+      if (store.getState().pendingCloseMs !== null) {
+        presence.clearTimer();
+      }
+      applyOpen(false, "close-programmatic", "programmatic");
+    },
+    toggle() {
+      const state = store.getState();
+      if (state.open) {
+        actions.close();
+      } else {
+        actions.open();
+      }
+    },
+    setOpen(nextOpen) {
+      if (nextOpen) {
+        actions.open();
+      } else {
+        actions.close();
+      }
+    },
+    openWithDelay() {
+      const state = store.getState();
+      if (state.pendingCloseMs !== null) {
+        presence.clearTimer();
+      }
+      if (state.openDelay <= 0) {
+        applyOpen(true, "open-hover", "user", "pointer");
+        return;
+      }
+      if (state.pendingOpenMs === null) {
+        presence.registerTimer();
+      }
+      store.patchState({
+        pendingOpenMs: state.openDelay,
+        pendingCloseMs: null
+      });
+      patchCleanup(store, presence);
+    },
+    closeWithDelay() {
+      const state = store.getState();
+      if (state.pendingOpenMs !== null) {
+        presence.clearTimer();
+      }
+      if (state.closeDelay <= 0) {
+        applyOpen(false, "close-hover", "user", "pointer");
+        return;
+      }
+      if (state.pendingCloseMs === null) {
+        presence.registerTimer();
+      }
+      store.patchState({
+        pendingOpenMs: null,
+        pendingCloseMs: state.closeDelay
+      });
+      patchCleanup(store, presence);
+    },
+    cancelClose() {
+      const state = store.getState();
+      if (state.pendingCloseMs !== null) {
+        presence.clearTimer();
+      }
+      store.patchState({
+        pendingCloseMs: null
+      });
+      patchCleanup(store, presence);
+    },
+    advanceTime(elapsedMs) {
+      const state = store.getState();
+      if (state.pendingOpenMs !== null) {
+        const remainingOpen = Math.max(0, state.pendingOpenMs - elapsedMs);
+        if (remainingOpen === 0) {
+          presence.clearTimer();
+          patchCleanup(store, presence);
+          applyOpen(true, "open-hover-delayed", "user", "pointer");
+          return;
+        }
+        store.patchState({
+          pendingOpenMs: remainingOpen
+        });
+      }
+      const nextState = store.getState();
+      if (nextState.pendingCloseMs !== null) {
+        const remainingClose = Math.max(0, nextState.pendingCloseMs - elapsedMs);
+        if (remainingClose === 0) {
+          presence.clearTimer();
+          patchCleanup(store, presence);
+          applyOpen(false, "close-hover-delayed", "user", "pointer");
+          return;
+        }
+        store.patchState({
+          pendingCloseMs: remainingClose
+        });
+      }
+    },
+    computePosition(anchorRect, contentRect, viewport) {
+      const state = store.getState();
+      const options = {
+        side: state.side,
+        align: state.align,
+        sideOffset: state.sideOffset,
+        alignOffset: state.alignOffset,
+        collisionPadding: state.collisionPadding,
+        collisionDetection: state.collisionDetection,
+        viewportWidth: viewport.width,
+        viewportHeight: viewport.height,
+        scrollX: viewport.scrollX,
+        scrollY: viewport.scrollY
+      };
+      const position = chunkWV2D7BZS_js.computePosition(anchorRect, contentRect, options);
+      store.patchState({
+        position,
+        lastError: position.overflow ? chunkEKMJ2G7A_js.createUIFnError({
+          code: "UIFN_ERR_POSITIONING_OVERFLOW",
+          package: "@uifn/core",
+          component: "HoverCard",
+          message: "Popup families MUST resolve collisions deterministically.",
+          recoverable: true,
+          details: {
+            overflowSides: position.overflowSides
+          }
+        }) : null
+      });
+      return position;
+    },
+    registerListener() {
+      presence.registerListener();
+      patchCleanup(store, presence);
+    },
+    clearListener() {
+      presence.clearListener();
+      patchCleanup(store, presence);
+    }
+  };
+  return {
+    get state() {
+      return store.getState();
+    },
+    actions,
+    getState: store.getState,
+    subscribe: store.subscribe
+  };
+}
+
+exports.createHoverCard = createHoverCard;
+//# sourceMappingURL=chunk-5C57AF3A.js.map
+//# sourceMappingURL=chunk-5C57AF3A.js.map

package/dist/chunk-5C57AF3A.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/primitives/hover-card.ts"],"names":["createControllableStateController","registerPublicId","generateId","createStore","composePublicId","createPresenceManager","computePosition","createUIFnError"],"mappings":"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","file":"chunk-5C57AF3A.js","sourcesContent":["import { createUIFnError, type UIFnError } from '../errors';\nimport { createControllableStateController } from '../state/machine';\nimport { composePublicId, generateId, registerPublicId } from '../utils/id';\nimport {\n  computePosition,\n  type Align,\n  type ComputePositionOptions,\n  type PositionResult,\n  type RectLike,\n  type Side,\n} from '../utils/position';\nimport { createPresenceManager } from '../utils/presence';\nimport { type ChangeMeta, createStore } from './shared';\n\nexport interface HoverCardState {\n  open: boolean;\n  controlled: boolean;\n  ids: {\n    baseId: string;\n    triggerId: string;\n    contentId: string;\n  };\n  openDelay: number;\n  closeDelay: number;\n  pendingOpenMs: number | null;\n  pendingCloseMs: number | null;\n  side: Side;\n  align: Align;\n  sideOffset: number;\n  alignOffset: number;\n  collisionPadding: number;\n  collisionDetection: boolean;\n  position: PositionResult | null;\n  cleanup: {\n    timers: number;\n    listeners: number;\n    complete: boolean;\n  };\n  lastChangeMeta?: ChangeMeta<boolean>;\n  lastError: UIFnError | null;\n}\n\nexport interface HoverCardActions {\n  open: () => void;\n  close: () => void;\n  toggle: () => void;\n  setOpen: (open: boolean) => void;\n  openWithDelay: () => void;\n  closeWithDelay: () => void;\n  cancelClose: () => void;\n  advanceTime: (elapsedMs: number) => void;\n  computePosition: (\n    anchorRect: RectLike,\n    contentRect: RectLike,\n    viewport: { width: number; height: number; scrollX?: number; scrollY?: number }\n  ) => PositionResult;\n  registerListener: () => void;\n  clearListener: () => void;\n}\n\nexport interface HoverCardMachine {\n  readonly state: HoverCardState;\n  readonly actions: HoverCardActions;\n  getState: () => HoverCardState;\n  subscribe: (\n    callback: (state: HoverCardState, meta?: ChangeMeta<boolean>) => void\n  ) => () => void;\n}\n\nexport interface CreateHoverCardProps {\n  open?: boolean;\n  defaultOpen?: boolean;\n  onOpenChange?: (open: boolean) => void;\n  idBase?: string;\n  openDelay?: number;\n  closeDelay?: number;\n  side?: Side;\n  align?: Align;\n  sideOffset?: number;\n  alignOffset?: number;\n  collisionPadding?: number;\n  collisionDetection?: boolean;\n  reducedMotion?: boolean;\n}\n\nfunction patchCleanup(\n  store: ReturnType<typeof createStore<HoverCardState, boolean>>,\n  presence: ReturnType<typeof createPresenceManager>\n) {\n  const presenceState = presence.getState();\n  store.patchState({\n    cleanup: {\n      timers: presenceState.timers,\n      listeners: presenceState.listeners,\n      complete: presenceState.cleanupComplete,\n    },\n  });\n}\n\nexport function createHoverCard(props: CreateHoverCardProps = {}): HoverCardMachine {\n  const openController = createControllableStateController<boolean>({\n    value: props.open,\n    defaultValue: props.defaultOpen ?? false,\n    onChange: props.onOpenChange,\n  });\n  const open = openController.getValue();\n  const baseId = props.idBase\n    ? registerPublicId(props.idBase, {\n        package: '@uifn/core',\n        component: 'HoverCard',\n      })\n    : generateId('hover-card');\n  const store = createStore<HoverCardState, boolean>({\n    open,\n    controlled: openController.isControlled(),\n    ids: {\n      baseId,\n      triggerId: registerPublicId(composePublicId({ prefix: baseId, slot: 'trigger' })),\n      contentId: registerPublicId(composePublicId({ prefix: baseId, slot: 'content' })),\n    },\n    openDelay: props.openDelay ?? 700,\n    closeDelay: props.closeDelay ?? 300,\n    pendingOpenMs: null,\n    pendingCloseMs: null,\n    side: props.side ?? 'bottom',\n    align: props.align ?? 'center',\n    sideOffset: props.sideOffset ?? 5,\n    alignOffset: props.alignOffset ?? 0,\n    collisionPadding: props.collisionPadding ?? 5,\n    collisionDetection: props.collisionDetection ?? true,\n    position: null,\n    cleanup: {\n      timers: 0,\n      listeners: 0,\n      complete: !open,\n    },\n    lastError: null,\n  });\n\n  const presence = createPresenceManager(open, {\n    reducedMotion: props.reducedMotion ?? false,\n  });\n\n  const applyOpen = (\n    nextOpen: boolean,\n    reason: string,\n    source: ChangeMeta<boolean>['source'],\n    inputModality?: ChangeMeta<boolean>['inputModality']\n  ) => {\n    const state = store.getState();\n    if (\n      state.open === nextOpen &&\n      state.pendingOpenMs === null &&\n      state.pendingCloseMs === null\n    ) {\n      return;\n    }\n\n    const meta: ChangeMeta<boolean> = {\n      source,\n      reason,\n      previousValue: state.open,\n      nextValue: nextOpen,\n      inputModality,\n    };\n    const result =\n      source === 'controlled-sync'\n        ? openController.syncValue(nextOpen)\n        : openController.requestValue(nextOpen);\n\n    presence.setPresent(nextOpen);\n    if (!nextOpen) {\n      presence.cleanup();\n    }\n\n    store.patchState(\n      {\n        open: result.value,\n        pendingOpenMs: null,\n        pendingCloseMs: null,\n        cleanup: {\n          timers: presence.getState().timers,\n          listeners: presence.getState().listeners,\n          complete: presence.getState().cleanupComplete,\n        },\n        lastChangeMeta: meta,\n        lastError: null,\n      },\n      meta\n    );\n  };\n\n  const actions: HoverCardActions = {\n    open() {\n      applyOpen(true, 'open-programmatic', 'programmatic');\n    },\n    close() {\n      if (store.getState().pendingOpenMs !== null) {\n        presence.clearTimer();\n      }\n      if (store.getState().pendingCloseMs !== null) {\n        presence.clearTimer();\n      }\n      applyOpen(false, 'close-programmatic', 'programmatic');\n    },\n    toggle() {\n      const state = store.getState();\n      if (state.open) {\n        actions.close();\n      } else {\n        actions.open();\n      }\n    },\n    setOpen(nextOpen) {\n      if (nextOpen) {\n        actions.open();\n      } else {\n        actions.close();\n      }\n    },\n    openWithDelay() {\n      const state = store.getState();\n      if (state.pendingCloseMs !== null) {\n        presence.clearTimer();\n      }\n\n      if (state.openDelay <= 0) {\n        applyOpen(true, 'open-hover', 'user', 'pointer');\n        return;\n      }\n\n      if (state.pendingOpenMs === null) {\n        presence.registerTimer();\n      }\n\n      store.patchState({\n        pendingOpenMs: state.openDelay,\n        pendingCloseMs: null,\n      });\n      patchCleanup(store, presence);\n    },\n    closeWithDelay() {\n      const state = store.getState();\n      if (state.pendingOpenMs !== null) {\n        presence.clearTimer();\n      }\n\n      if (state.closeDelay <= 0) {\n        applyOpen(false, 'close-hover', 'user', 'pointer');\n        return;\n      }\n\n      if (state.pendingCloseMs === null) {\n        presence.registerTimer();\n      }\n\n      store.patchState({\n        pendingOpenMs: null,\n        pendingCloseMs: state.closeDelay,\n      });\n      patchCleanup(store, presence);\n    },\n    cancelClose() {\n      const state = store.getState();\n      if (state.pendingCloseMs !== null) {\n        presence.clearTimer();\n      }\n\n      store.patchState({\n        pendingCloseMs: null,\n      });\n      patchCleanup(store, presence);\n    },\n    advanceTime(elapsedMs) {\n      const state = store.getState();\n\n      if (state.pendingOpenMs !== null) {\n        const remainingOpen = Math.max(0, state.pendingOpenMs - elapsedMs);\n        if (remainingOpen === 0) {\n          presence.clearTimer();\n          patchCleanup(store, presence);\n          applyOpen(true, 'open-hover-delayed', 'user', 'pointer');\n          return;\n        }\n\n        store.patchState({\n          pendingOpenMs: remainingOpen,\n        });\n      }\n\n      const nextState = store.getState();\n      if (nextState.pendingCloseMs !== null) {\n        const remainingClose = Math.max(0, nextState.pendingCloseMs - elapsedMs);\n        if (remainingClose === 0) {\n          presence.clearTimer();\n          patchCleanup(store, presence);\n          applyOpen(false, 'close-hover-delayed', 'user', 'pointer');\n          return;\n        }\n\n        store.patchState({\n          pendingCloseMs: remainingClose,\n        });\n      }\n    },\n    computePosition(anchorRect, contentRect, viewport) {\n      const state = store.getState();\n      const options: ComputePositionOptions = {\n        side: state.side,\n        align: state.align,\n        sideOffset: state.sideOffset,\n        alignOffset: state.alignOffset,\n        collisionPadding: state.collisionPadding,\n        collisionDetection: state.collisionDetection,\n        viewportWidth: viewport.width,\n        viewportHeight: viewport.height,\n        scrollX: viewport.scrollX,\n        scrollY: viewport.scrollY,\n      };\n      const position = computePosition(anchorRect, contentRect, options);\n      store.patchState({\n        position,\n        lastError: position.overflow\n          ? createUIFnError({\n              code: 'UIFN_ERR_POSITIONING_OVERFLOW',\n              package: '@uifn/core',\n              component: 'HoverCard',\n              message: 'Popup families MUST resolve collisions deterministically.',\n              recoverable: true,\n              details: {\n                overflowSides: position.overflowSides,\n              },\n            })\n          : null,\n      });\n\n      return position;\n    },\n    registerListener() {\n      presence.registerListener();\n      patchCleanup(store, presence);\n    },\n    clearListener() {\n      presence.clearListener();\n      patchCleanup(store, presence);\n    },\n  };\n\n  return {\n    get state() {\n      return store.getState();\n    },\n    actions,\n    getState: store.getState,\n    subscribe: store.subscribe,\n  };\n}\n"]}

package/dist/chunk-5DK6IIIL.mjs

@@ -0,0 +1,209 @@
+import { getNextEnabledRovingFocusIndex } from './chunk-6Y53W77O.mjs';
+import { createControllableStateController } from './chunk-RPH4AAZZ.mjs';
+import { uniqueStrings, createStore } from './chunk-LNJ2UKA3.mjs';
+import { createUIFnError } from './chunk-HTTKRX7S.mjs';
+
+// src/primitives/radio-group.ts
+function getFormValue(name, value) {
+  if (!name || !value) {
+    return {};
+  }
+  return {
+    [name]: value
+  };
+}
+function validateRadioValue(value, items) {
+  if (!value || items.length === 0) {
+    return;
+  }
+  if (!items.includes(value)) {
+    throw createUIFnError({
+      code: "UIFN_ERR_INVALID_VALUE",
+      package: "@uifn/core",
+      component: "RadioGroup",
+      message: "Invalid external values MUST be handled deterministically.",
+      details: {
+        value,
+        items
+      }
+    });
+  }
+}
+function createRadioGroup(props) {
+  const initialValue = props.value ?? props.defaultValue ?? "";
+  const orientation = props.orientation ?? "vertical";
+  const items = uniqueStrings(props.items ?? []);
+  const controlledState = createControllableStateController({
+    value: props.value,
+    defaultValue: props.defaultValue ?? "",
+    onChange: props.onValueChange
+  });
+  validateRadioValue(initialValue, items);
+  const store = createStore({
+    value: controlledState.getValue(),
+    controlled: controlledState.isControlled(),
+    disabled: props.disabled ?? false,
+    required: props.required ?? false,
+    orientation,
+    name: props.name,
+    items,
+    disabledItems: [],
+    focusedItem: initialValue || items[0] || null,
+    formValue: getFormValue(props.name, controlledState.getValue()),
+    lastError: null
+  });
+  const emitValue = (nextValue, meta) => {
+    const state = store.getState();
+    validateRadioValue(nextValue, state.items);
+    const result = meta.source === "controlled-sync" ? controlledState.syncValue(nextValue) : controlledState.requestValue(nextValue);
+    store.patchState(
+      {
+        value: result.value,
+        focusedItem: nextValue || state.focusedItem,
+        formValue: getFormValue(state.name, result.value),
+        lastChangeMeta: meta,
+        lastError: null
+      },
+      meta
+    );
+  };
+  const ensureEnabled = (value) => {
+    const state = store.getState();
+    if (!state.disabled && (!value || !state.disabledItems.includes(value))) {
+      return true;
+    }
+    store.patchState({
+      lastError: createUIFnError({
+        code: "UIFN_ERR_DISABLED_INTERACTION",
+        package: "@uifn/core",
+        component: "RadioGroup",
+        message: "Disabled controls MUST ignore state-changing input.",
+        recoverable: true
+      })
+    });
+    return false;
+  };
+  const actions = {
+    setValue(value) {
+      if (!ensureEnabled(value)) {
+        return;
+      }
+      const state = store.getState();
+      if (state.value === value) {
+        return;
+      }
+      emitValue(value, {
+        source: "programmatic",
+        reason: "set-value",
+        previousValue: state.value,
+        nextValue: value
+      });
+    },
+    registerItem(value, disabled = false) {
+      const state = store.getState();
+      if (state.items.includes(value)) {
+        if (disabled !== state.disabledItems.includes(value)) {
+          actions.setItemDisabled(value, disabled);
+        }
+        return;
+      }
+      const nextItems = [...state.items, value];
+      validateRadioValue(state.value, nextItems);
+      store.patchState({
+        items: nextItems,
+        disabledItems: disabled ? uniqueStrings([...state.disabledItems, value]) : state.disabledItems,
+        focusedItem: state.focusedItem ?? value
+      });
+    },
+    unregisterItem(value) {
+      const state = store.getState();
+      const nextItems = state.items.filter((entry) => entry !== value);
+      const nextDisabledItems = state.disabledItems.filter((entry) => entry !== value);
+      const nextValue = state.value === value ? "" : state.value;
+      if (nextValue !== state.value) {
+        controlledState.syncValue(nextValue);
+      }
+      store.patchState({
+        items: nextItems,
+        disabledItems: nextDisabledItems,
+        value: nextValue,
+        focusedItem: state.focusedItem === value ? nextItems[0] ?? null : state.focusedItem,
+        formValue: getFormValue(state.name, nextValue)
+      });
+    },
+    setItemDisabled(value, disabled) {
+      const state = store.getState();
+      if (!state.items.includes(value)) {
+        return;
+      }
+      const nextDisabledItems = disabled ? uniqueStrings([...state.disabledItems, value]) : state.disabledItems.filter((entry) => entry !== value);
+      const nextValue = disabled && state.value === value ? "" : state.value;
+      if (nextValue !== state.value) {
+        controlledState.syncValue(nextValue);
+      }
+      store.patchState({
+        disabledItems: nextDisabledItems,
+        value: nextValue,
+        formValue: getFormValue(state.name, nextValue)
+      });
+    },
+    handleKeyDown(key, currentItem) {
+      const state = store.getState();
+      const enabledItems = state.items.filter(
+        (item) => !state.disabledItems.includes(item)
+      );
+      if (enabledItems.length === 0) {
+        return null;
+      }
+      const currentIndex = Math.max(0, enabledItems.indexOf(currentItem));
+      const nextIndex = getNextEnabledRovingFocusIndex({
+        key,
+        itemCount: enabledItems.length,
+        currentIndex,
+        orientation: state.orientation
+      });
+      if (nextIndex < 0 || nextIndex === currentIndex) {
+        return null;
+      }
+      const nextItem = enabledItems[nextIndex] ?? null;
+      if (!nextItem) {
+        return null;
+      }
+      emitValue(nextItem, {
+        source: "user",
+        reason: "keyboard-navigation",
+        previousValue: state.value,
+        nextValue: nextItem,
+        inputModality: "keyboard"
+      });
+      return nextItem;
+    },
+    syncValue(value) {
+      const state = store.getState();
+      if (state.value === value) {
+        return;
+      }
+      emitValue(value, {
+        source: "controlled-sync",
+        reason: "sync-value",
+        previousValue: state.value,
+        nextValue: value
+      });
+    },
+    getFormValue() {
+      return store.getState().formValue;
+    }
+  };
+  return {
+    get state() {
+      return store.getState();
+    },
+    actions,
+    getState: store.getState,
+    subscribe: store.subscribe
+  };
+}
+
+export { createRadioGroup };
+//# sourceMappingURL=chunk-5DK6IIIL.mjs.map
+//# sourceMappingURL=chunk-5DK6IIIL.mjs.map

package/dist/chunk-5DK6IIIL.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/primitives/radio-group.ts"],"names":[],"mappings":"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","file":"chunk-5DK6IIIL.mjs","sourcesContent":["import { createUIFnError, type UIFnError } from '../errors';\nimport { createControllableStateController } from '../state/machine';\nimport { getNextEnabledRovingFocusIndex } from '../utils/roving-focus';\nimport { type ChangeMeta, createStore, uniqueStrings } from './shared';\n\nexport interface RadioGroupProps {\n  value?: string;\n  defaultValue?: string;\n  disabled?: boolean;\n  required?: boolean;\n  orientation?: 'horizontal' | 'vertical';\n  name?: string;\n  items?: string[];\n  onValueChange?: (value: string) => void;\n}\n\nexport interface RadioGroupState {\n  value: string;\n  controlled: boolean;\n  disabled: boolean;\n  required: boolean;\n  orientation: 'horizontal' | 'vertical';\n  name?: string;\n  items: string[];\n  disabledItems: string[];\n  focusedItem: string | null;\n  formValue: Record<string, string>;\n  lastChangeMeta?: ChangeMeta<string>;\n  lastError: UIFnError | null;\n}\n\nexport interface RadioGroupActions {\n  setValue: (value: string) => void;\n  registerItem: (value: string, disabled?: boolean) => void;\n  unregisterItem: (value: string) => void;\n  setItemDisabled: (value: string, disabled: boolean) => void;\n  handleKeyDown: (key: string, currentItem: string) => string | null;\n  syncValue: (value: string) => void;\n  getFormValue: () => Record<string, string>;\n}\n\nexport interface RadioGroupMachine {\n  readonly state: RadioGroupState;\n  readonly actions: RadioGroupActions;\n  getState: () => RadioGroupState;\n  subscribe: (callback: (state: RadioGroupState, meta?: ChangeMeta<string>) => void) => () => void;\n}\n\nfunction getFormValue(name: string | undefined, value: string): Record<string, string> {\n  if (!name || !value) {\n    return {};\n  }\n\n  return {\n    [name]: value,\n  };\n}\n\nfunction validateRadioValue(value: string, items: string[]): void {\n  if (!value || items.length === 0) {\n    return;\n  }\n\n  if (!items.includes(value)) {\n    throw createUIFnError({\n      code: 'UIFN_ERR_INVALID_VALUE',\n      package: '@uifn/core',\n      component: 'RadioGroup',\n      message: 'Invalid external values MUST be handled deterministically.',\n      details: {\n        value,\n        items,\n      },\n    });\n  }\n}\n\nexport function createRadioGroup(props: RadioGroupProps): RadioGroupMachine {\n  const initialValue = props.value ?? props.defaultValue ?? '';\n  const orientation = props.orientation ?? 'vertical';\n  const items = uniqueStrings(props.items ?? []);\n  const controlledState = createControllableStateController({\n    value: props.value,\n    defaultValue: props.defaultValue ?? '',\n    onChange: props.onValueChange,\n  });\n\n  validateRadioValue(initialValue, items);\n\n  const store = createStore<RadioGroupState, string>({\n    value: controlledState.getValue(),\n    controlled: controlledState.isControlled(),\n    disabled: props.disabled ?? false,\n    required: props.required ?? false,\n    orientation,\n    name: props.name,\n    items,\n    disabledItems: [],\n    focusedItem: initialValue || items[0] || null,\n    formValue: getFormValue(props.name, controlledState.getValue()),\n    lastError: null,\n  });\n\n  const emitValue = (nextValue: string, meta: ChangeMeta<string>) => {\n    const state = store.getState();\n    validateRadioValue(nextValue, state.items);\n    const result =\n      meta.source === 'controlled-sync'\n        ? controlledState.syncValue(nextValue)\n        : controlledState.requestValue(nextValue);\n    store.patchState(\n      {\n        value: result.value,\n        focusedItem: nextValue || state.focusedItem,\n        formValue: getFormValue(state.name, result.value),\n        lastChangeMeta: meta,\n        lastError: null,\n      },\n      meta\n    );\n  };\n\n  const ensureEnabled = (value?: string): boolean => {\n    const state = store.getState();\n    if (!state.disabled && (!value || !state.disabledItems.includes(value))) {\n      return true;\n    }\n\n    store.patchState({\n      lastError: createUIFnError({\n        code: 'UIFN_ERR_DISABLED_INTERACTION',\n        package: '@uifn/core',\n        component: 'RadioGroup',\n        message: 'Disabled controls MUST ignore state-changing input.',\n        recoverable: true,\n      }),\n    });\n    return false;\n  };\n\n  const actions: RadioGroupActions = {\n    setValue(value) {\n      if (!ensureEnabled(value)) {\n        return;\n      }\n\n      const state = store.getState();\n      if (state.value === value) {\n        return;\n      }\n      emitValue(value, {\n        source: 'programmatic',\n        reason: 'set-value',\n        previousValue: state.value,\n        nextValue: value,\n      });\n    },\n    registerItem(value, disabled = false) {\n      const state = store.getState();\n      if (state.items.includes(value)) {\n        if (disabled !== state.disabledItems.includes(value)) {\n          actions.setItemDisabled(value, disabled);\n        }\n        return;\n      }\n\n      const nextItems = [...state.items, value];\n      validateRadioValue(state.value, nextItems);\n      store.patchState({\n        items: nextItems,\n        disabledItems: disabled\n          ? uniqueStrings([...state.disabledItems, value])\n          : state.disabledItems,\n        focusedItem: state.focusedItem ?? value,\n      });\n    },\n    unregisterItem(value) {\n      const state = store.getState();\n      const nextItems = state.items.filter((entry) => entry !== value);\n      const nextDisabledItems = state.disabledItems.filter((entry) => entry !== value);\n      const nextValue = state.value === value ? '' : state.value;\n      if (nextValue !== state.value) {\n        controlledState.syncValue(nextValue);\n      }\n      store.patchState({\n        items: nextItems,\n        disabledItems: nextDisabledItems,\n        value: nextValue,\n        focusedItem:\n          state.focusedItem === value ? nextItems[0] ?? null : state.focusedItem,\n        formValue: getFormValue(state.name, nextValue),\n      });\n    },\n    setItemDisabled(value, disabled) {\n      const state = store.getState();\n      if (!state.items.includes(value)) {\n        return;\n      }\n\n      const nextDisabledItems = disabled\n        ? uniqueStrings([...state.disabledItems, value])\n        : state.disabledItems.filter((entry) => entry !== value);\n      const nextValue = disabled && state.value === value ? '' : state.value;\n      if (nextValue !== state.value) {\n        controlledState.syncValue(nextValue);\n      }\n      store.patchState({\n        disabledItems: nextDisabledItems,\n        value: nextValue,\n        formValue: getFormValue(state.name, nextValue),\n      });\n    },\n    handleKeyDown(key, currentItem) {\n      const state = store.getState();\n      const enabledItems = state.items.filter(\n        (item) => !state.disabledItems.includes(item)\n      );\n      if (enabledItems.length === 0) {\n        return null;\n      }\n\n      const currentIndex = Math.max(0, enabledItems.indexOf(currentItem));\n      const nextIndex = getNextEnabledRovingFocusIndex({\n        key,\n        itemCount: enabledItems.length,\n        currentIndex,\n        orientation: state.orientation,\n      });\n\n      if (nextIndex < 0 || nextIndex === currentIndex) {\n        return null;\n      }\n\n      const nextItem = enabledItems[nextIndex] ?? null;\n      if (!nextItem) {\n        return null;\n      }\n\n      emitValue(nextItem, {\n        source: 'user',\n        reason: 'keyboard-navigation',\n        previousValue: state.value,\n        nextValue: nextItem,\n        inputModality: 'keyboard',\n      });\n      return nextItem;\n    },\n    syncValue(value) {\n      const state = store.getState();\n      if (state.value === value) {\n        return;\n      }\n\n      emitValue(value, {\n        source: 'controlled-sync',\n        reason: 'sync-value',\n        previousValue: state.value,\n        nextValue: value,\n      });\n    },\n    getFormValue() {\n      return store.getState().formValue;\n    },\n  };\n\n  return {\n    get state() {\n      return store.getState();\n    },\n    actions,\n    getState: store.getState,\n    subscribe: store.subscribe,\n  };\n}\n"]}