@uifn/core 0.0.1

package/dist/chunk-RR4UBSEY.js

@@ -0,0 +1,128 @@
+'use strict';
+
+var chunkL67UQEPI_js = require('./chunk-L67UQEPI.js');
+var chunkK3WYDUIN_js = require('./chunk-K3WYDUIN.js');
+var chunkEKMJ2G7A_js = require('./chunk-EKMJ2G7A.js');
+
+// src/primitives/collapsible.ts
+function createCollapsible(props = {}) {
+  props.open ?? props.defaultOpen ?? false;
+  const disabled = props.disabled ?? false;
+  const controlledState = chunkL67UQEPI_js.createControllableStateController({
+    value: props.open,
+    defaultValue: props.defaultOpen ?? false,
+    onChange: props.onOpenChange
+  });
+  const store = chunkK3WYDUIN_js.createStore({
+    open: controlledState.getValue(),
+    controlled: controlledState.isControlled(),
+    disabled,
+    lastError: null
+  });
+  const emitOpen = (nextOpen, meta) => {
+    const result = meta.source === "controlled-sync" ? controlledState.syncValue(nextOpen) : controlledState.requestValue(nextOpen);
+    store.patchState(
+      {
+        open: result.value,
+        lastChangeMeta: meta,
+        lastError: null
+      },
+      meta
+    );
+  };
+  const actions = {
+    setOpen(open) {
+      const state = store.getState();
+      if (state.open === open) {
+        return;
+      }
+      if (state.disabled) {
+        store.patchState({
+          lastError: chunkEKMJ2G7A_js.createUIFnError({
+            code: "UIFN_ERR_DISABLED_INTERACTION",
+            package: "@uifn/core",
+            component: "Collapsible",
+            message: "Disabled controls MUST ignore state-changing input.",
+            recoverable: true
+          })
+        });
+        return;
+      }
+      emitOpen(open, {
+        source: "programmatic",
+        reason: "set-open",
+        previousValue: state.open,
+        nextValue: open
+      });
+    },
+    toggle() {
+      const state = store.getState();
+      if (state.disabled) {
+        store.patchState({
+          lastError: chunkEKMJ2G7A_js.createUIFnError({
+            code: "UIFN_ERR_DISABLED_INTERACTION",
+            package: "@uifn/core",
+            component: "Collapsible",
+            message: "Disabled controls MUST ignore state-changing input.",
+            recoverable: true
+          })
+        });
+        return;
+      }
+      const nextOpen = !state.open;
+      emitOpen(nextOpen, {
+        source: "user",
+        reason: "toggle",
+        previousValue: state.open,
+        nextValue: nextOpen,
+        inputModality: "pointer"
+      });
+    },
+    syncOpen(open) {
+      const state = store.getState();
+      if (state.open === open) {
+        return;
+      }
+      emitOpen(open, {
+        source: "controlled-sync",
+        reason: "sync-open",
+        previousValue: state.open,
+        nextValue: open
+      });
+    }
+  };
+  return {
+    get state() {
+      return store.getState();
+    },
+    actions,
+    getState: store.getState,
+    subscribe: store.subscribe
+  };
+}
+function createCollapsibleMachine(initialOpen = false, initialDisabled = false) {
+  const machine = createCollapsible({
+    defaultOpen: initialOpen,
+    disabled: initialDisabled
+  });
+  return {
+    get state() {
+      return machine.state.open ? "open" : "closed";
+    },
+    send(event) {
+      if (event.type === "TOGGLE") {
+        machine.actions.toggle();
+      } else if (event.type === "OPEN") {
+        machine.actions.setOpen(true);
+      } else {
+        machine.actions.setOpen(false);
+      }
+    },
+    subscribe: machine.subscribe
+  };
+}
+
+exports.createCollapsible = createCollapsible;
+exports.createCollapsibleMachine = createCollapsibleMachine;
+//# sourceMappingURL=chunk-RR4UBSEY.js.map
+//# sourceMappingURL=chunk-RR4UBSEY.js.map

package/dist/chunk-RR4UBSEY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/primitives/collapsible.ts"],"names":["createControllableStateController","createStore","createUIFnError"],"mappings":"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","file":"chunk-RR4UBSEY.js","sourcesContent":["import { createUIFnError, type UIFnError } from '../errors';\nimport { createControllableStateController } from '../state/machine';\nimport { type ChangeMeta, createStore } from './shared';\n\nexport interface CollapsibleProps {\n  open?: boolean;\n  defaultOpen?: boolean;\n  disabled?: boolean;\n  onOpenChange?: (open: boolean) => void;\n}\n\nexport interface CollapsibleState {\n  open: boolean;\n  controlled: boolean;\n  disabled: boolean;\n  lastChangeMeta?: ChangeMeta<boolean>;\n  lastError: UIFnError | null;\n}\n\nexport interface CollapsibleActions {\n  setOpen: (open: boolean) => void;\n  toggle: () => void;\n  syncOpen: (open: boolean) => void;\n}\n\nexport interface CollapsibleMachine {\n  readonly state: CollapsibleState;\n  readonly actions: CollapsibleActions;\n  getState: () => CollapsibleState;\n  subscribe: (callback: (state: CollapsibleState, meta?: ChangeMeta<boolean>) => void) => () => void;\n}\n\nexport function createCollapsible(props: CollapsibleProps = {}): CollapsibleMachine {\n  const initialOpen = props.open ?? props.defaultOpen ?? false;\n  const disabled = props.disabled ?? false;\n  const controlledState = createControllableStateController({\n    value: props.open,\n    defaultValue: props.defaultOpen ?? false,\n    onChange: props.onOpenChange,\n  });\n  const store = createStore<CollapsibleState, boolean>({\n    open: controlledState.getValue(),\n    controlled: controlledState.isControlled(),\n    disabled,\n    lastError: null,\n  });\n\n  const emitOpen = (nextOpen: boolean, meta: ChangeMeta<boolean>) => {\n    const result =\n      meta.source === 'controlled-sync'\n        ? controlledState.syncValue(nextOpen)\n        : controlledState.requestValue(nextOpen);\n    store.patchState(\n      {\n        open: result.value,\n        lastChangeMeta: meta,\n        lastError: null,\n      },\n      meta\n    );\n  };\n\n  const actions: CollapsibleActions = {\n    setOpen(open) {\n      const state = store.getState();\n      if (state.open === open) {\n        return;\n      }\n\n      if (state.disabled) {\n        store.patchState({\n          lastError: createUIFnError({\n            code: 'UIFN_ERR_DISABLED_INTERACTION',\n            package: '@uifn/core',\n            component: 'Collapsible',\n            message: 'Disabled controls MUST ignore state-changing input.',\n            recoverable: true,\n          }),\n        });\n        return;\n      }\n\n      emitOpen(open, {\n        source: 'programmatic',\n        reason: 'set-open',\n        previousValue: state.open,\n        nextValue: open,\n      });\n    },\n    toggle() {\n      const state = store.getState();\n      if (state.disabled) {\n        store.patchState({\n          lastError: createUIFnError({\n            code: 'UIFN_ERR_DISABLED_INTERACTION',\n            package: '@uifn/core',\n            component: 'Collapsible',\n            message: 'Disabled controls MUST ignore state-changing input.',\n            recoverable: true,\n          }),\n        });\n        return;\n      }\n\n      const nextOpen = !state.open;\n      emitOpen(nextOpen, {\n        source: 'user',\n        reason: 'toggle',\n        previousValue: state.open,\n        nextValue: nextOpen,\n        inputModality: 'pointer',\n      });\n    },\n    syncOpen(open) {\n      const state = store.getState();\n      if (state.open === open) {\n        return;\n      }\n\n      emitOpen(open, {\n        source: 'controlled-sync',\n        reason: 'sync-open',\n        previousValue: state.open,\n        nextValue: open,\n      });\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\nexport type CollapsibleMachineEvent =\n  | { type: 'TOGGLE' }\n  | { type: 'OPEN' }\n  | { type: 'CLOSE' };\n\nexport function createCollapsibleMachine(initialOpen = false, initialDisabled = false) {\n  const machine = createCollapsible({\n    defaultOpen: initialOpen,\n    disabled: initialDisabled,\n  });\n\n  return {\n    get state() {\n      return machine.state.open ? 'open' : 'closed';\n    },\n    send(event: CollapsibleMachineEvent) {\n      if (event.type === 'TOGGLE') {\n        machine.actions.toggle();\n      } else if (event.type === 'OPEN') {\n        machine.actions.setOpen(true);\n      } else {\n        machine.actions.setOpen(false);\n      }\n    },\n    subscribe: machine.subscribe,\n  };\n}\n"]}

package/dist/chunk-T5JIC6TN.js

@@ -0,0 +1,36 @@
+'use strict';
+
+// src/primitives/avatar.ts
+function createAvatar() {
+  let state = { status: "idle" };
+  const listeners = /* @__PURE__ */ new Set();
+  const notify = () => {
+    listeners.forEach((l) => l({ ...state }));
+  };
+  const actions = {
+    setLoading: () => {
+      state.status = "loading";
+      notify();
+    },
+    setLoaded: () => {
+      state.status = "loaded";
+      notify();
+    },
+    setError: () => {
+      state.status = "error";
+      notify();
+    }
+  };
+  return {
+    state,
+    actions,
+    subscribe: (callback) => {
+      listeners.add(callback);
+      return () => listeners.delete(callback);
+    }
+  };
+}
+
+exports.createAvatar = createAvatar;
+//# sourceMappingURL=chunk-T5JIC6TN.js.map
+//# sourceMappingURL=chunk-T5JIC6TN.js.map

package/dist/chunk-T5JIC6TN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/primitives/avatar.ts"],"names":[],"mappings":";;;AAkBO,SAAS,YAAA,GAA8B;AAC5C,EAAA,IAAI,KAAA,GAAqB,EAAE,MAAA,EAAQ,MAAA,EAAO;AAC1C,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAkC;AAExD,EAAA,MAAM,SAAS,MAAM;AACnB,IAAA,SAAA,CAAU,QAAQ,CAAA,CAAA,KAAK,CAAA,CAAE,EAAE,GAAG,KAAA,EAAO,CAAC,CAAA;AAAA,EACxC,CAAA;AAEA,EAAA,MAAM,OAAA,GAAyB;AAAA,IAC7B,YAAY,MAAM;AAAE,MAAA,KAAA,CAAM,MAAA,GAAS,SAAA;AAAW,MAAA,MAAA,EAAO;AAAA,IAAG,CAAA;AAAA,IACxD,WAAW,MAAM;AAAE,MAAA,KAAA,CAAM,MAAA,GAAS,QAAA;AAAU,MAAA,MAAA,EAAO;AAAA,IAAG,CAAA;AAAA,IACtD,UAAU,MAAM;AAAE,MAAA,KAAA,CAAM,MAAA,GAAS,OAAA;AAAS,MAAA,MAAA,EAAO;AAAA,IAAG;AAAA,GACtD;AAEA,EAAA,OAAO;AAAA,IACL,KAAA;AAAA,IACA,OAAA;AAAA,IACA,SAAA,EAAW,CAAC,QAAA,KAAa;AACvB,MAAA,SAAA,CAAU,IAAI,QAAQ,CAAA;AACtB,MAAA,OAAO,MAAM,SAAA,CAAU,MAAA,CAAO,QAAQ,CAAA;AAAA,IACxC;AAAA,GACF;AACF","file":"chunk-T5JIC6TN.js","sourcesContent":["export type AvatarStatus = 'idle' | 'loading' | 'loaded' | 'error';\n\nexport interface AvatarState {\n  status: AvatarStatus;\n}\n\nexport interface AvatarActions {\n  setLoading: () => void;\n  setLoaded: () => void;\n  setError: () => void;\n}\n\nexport interface AvatarMachine {\n  state: AvatarState;\n  actions: AvatarActions;\n  subscribe: (callback: (state: AvatarState) => void) => () => void;\n}\n\nexport function createAvatar(): AvatarMachine {\n  let state: AvatarState = { status: 'idle' };\n  const listeners = new Set<(state: AvatarState) => void>();\n\n  const notify = () => {\n    listeners.forEach(l => l({ ...state }));\n  };\n\n  const actions: AvatarActions = {\n    setLoading: () => { state.status = 'loading'; notify(); },\n    setLoaded: () => { state.status = 'loaded'; notify(); },\n    setError: () => { state.status = 'error'; notify(); },\n  };\n\n  return {\n    state,\n    actions,\n    subscribe: (callback) => {\n      listeners.add(callback);\n      return () => listeners.delete(callback);\n    }\n  };\n}\n"]}

package/dist/chunk-TC53AKSZ.mjs

@@ -0,0 +1,11 @@
+// src/primitives/separator.ts
+function createSeparator(props) {
+  const { orientation = "horizontal", decorative = false } = props;
+  return {
+    state: { orientation, decorative }
+  };
+}
+
+export { createSeparator };
+//# sourceMappingURL=chunk-TC53AKSZ.mjs.map
+//# sourceMappingURL=chunk-TC53AKSZ.mjs.map

package/dist/chunk-TC53AKSZ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/primitives/separator.ts"],"names":[],"mappings":";AAUO,SAAS,gBAAgB,KAAA,EAAuB;AACrD,EAAA,MAAM,EAAE,WAAA,GAAc,YAAA,EAAc,UAAA,GAAa,OAAM,GAAI,KAAA;AAE3D,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,EAAE,WAAA,EAAa,UAAA;AAAW,GACnC;AACF","file":"chunk-TC53AKSZ.mjs","sourcesContent":["export interface SeparatorProps {\n  orientation?: 'horizontal' | 'vertical';\n  decorative?: boolean;\n}\n\nexport interface SeparatorState {\n  orientation: 'horizontal' | 'vertical';\n  decorative: boolean;\n}\n\nexport function createSeparator(props: SeparatorProps) {\n  const { orientation = 'horizontal', decorative = false } = props;\n  \n  return {\n    state: { orientation, decorative }\n  };\n}\n"]}

package/dist/chunk-TWTQ2Y7N.mjs

@@ -0,0 +1,254 @@
+import { createStore, clamp } from './chunk-LNJ2UKA3.mjs';
+import { createUIFnError } from './chunk-HTTKRX7S.mjs';
+
+// src/primitives/scroll-area.ts
+function createDefaultViewport() {
+  return {
+    scrollTop: 0,
+    scrollLeft: 0,
+    scrollHeight: 0,
+    scrollWidth: 0,
+    clientHeight: 0,
+    clientWidth: 0
+  };
+}
+function toAxisState(scrollSize, clientSize, scrollOffset) {
+  const visible = scrollSize > clientSize && clientSize > 0;
+  if (!visible) {
+    return {
+      visible: false,
+      thumbSizePercent: 100,
+      thumbPositionPercent: 0
+    };
+  }
+  const maxScroll = Math.max(1, scrollSize - clientSize);
+  const thumbSizePercent = clamp(clientSize / scrollSize * 100, 5, 100);
+  const thumbPositionPercent = clamp(scrollOffset / maxScroll * 100, 0, 100);
+  return {
+    visible: true,
+    thumbSizePercent,
+    thumbPositionPercent
+  };
+}
+function resolveStateFromViewport(viewport) {
+  const vertical = toAxisState(viewport.scrollHeight, viewport.clientHeight, viewport.scrollTop);
+  const horizontal = toAxisState(viewport.scrollWidth, viewport.clientWidth, viewport.scrollLeft);
+  return {
+    vertical,
+    horizontal,
+    cornerVisible: vertical.visible && horizontal.visible
+  };
+}
+function toScrollOffset(positionPercent, scrollSize, clientSize) {
+  const maxScroll = Math.max(0, scrollSize - clientSize);
+  if (maxScroll === 0) {
+    return 0;
+  }
+  return clamp(positionPercent, 0, 100) / 100 * maxScroll;
+}
+function clampViewport(viewport) {
+  return {
+    ...viewport,
+    scrollTop: clamp(
+      viewport.scrollTop,
+      0,
+      Math.max(0, viewport.scrollHeight - viewport.clientHeight)
+    ),
+    scrollLeft: clamp(
+      viewport.scrollLeft,
+      0,
+      Math.max(0, viewport.scrollWidth - viewport.clientWidth)
+    )
+  };
+}
+function createScrollArea(props) {
+  const viewport = createDefaultViewport();
+  const computed = resolveStateFromViewport(viewport);
+  const store = createStore({
+    type: props.type ?? "hover",
+    scrollHideDelay: props.scrollHideDelay ?? 600,
+    viewport,
+    vertical: computed.vertical,
+    horizontal: computed.horizontal,
+    cornerVisible: computed.cornerVisible,
+    lastInteraction: null,
+    lastError: null
+  });
+  const actions = {
+    setViewportMetrics(metrics) {
+      const state = store.getState();
+      const nextViewport = clampViewport({
+        ...state.viewport,
+        ...metrics
+      });
+      const nextComputed = resolveStateFromViewport(nextViewport);
+      store.patchState({
+        viewport: nextViewport,
+        vertical: nextComputed.vertical,
+        horizontal: nextComputed.horizontal,
+        cornerVisible: nextComputed.cornerVisible
+      });
+    },
+    onViewportScroll(position) {
+      const state = store.getState();
+      const nextViewport = clampViewport({
+        ...state.viewport,
+        scrollTop: position.top !== void 0 ? position.top : state.viewport.scrollTop,
+        scrollLeft: position.left !== void 0 ? position.left : state.viewport.scrollLeft
+      });
+      const nextComputed = resolveStateFromViewport(nextViewport);
+      const meta = {
+        source: "user",
+        reason: "viewport-scroll",
+        previousValue: state.viewport.scrollTop,
+        nextValue: nextViewport.scrollTop,
+        inputModality: "pointer"
+      };
+      store.patchState(
+        {
+          viewport: nextViewport,
+          vertical: nextComputed.vertical,
+          horizontal: nextComputed.horizontal,
+          cornerVisible: nextComputed.cornerVisible,
+          lastInteraction: "viewport",
+          lastChangeMeta: meta,
+          lastError: null
+        },
+        meta
+      );
+    },
+    scrollTo(position) {
+      const state = store.getState();
+      const nextViewport = clampViewport({
+        ...state.viewport,
+        scrollTop: position.top !== void 0 ? position.top : state.viewport.scrollTop,
+        scrollLeft: position.left !== void 0 ? position.left : state.viewport.scrollLeft
+      });
+      const nextComputed = resolveStateFromViewport(nextViewport);
+      const meta = {
+        source: "programmatic",
+        reason: "programmatic-scroll",
+        previousValue: state.viewport.scrollTop,
+        nextValue: nextViewport.scrollTop
+      };
+      store.patchState(
+        {
+          viewport: nextViewport,
+          vertical: nextComputed.vertical,
+          horizontal: nextComputed.horizontal,
+          cornerVisible: nextComputed.cornerVisible,
+          lastInteraction: "viewport",
+          lastChangeMeta: meta,
+          lastError: null
+        },
+        meta
+      );
+    },
+    dragVerticalThumb(positionPercent) {
+      const state = store.getState();
+      if (!state.vertical.visible) {
+        store.patchState({
+          lastError: createUIFnError({
+            code: "UIFN_ERR_SCROLL_SYNC",
+            package: "@uifn/core",
+            component: "ScrollArea",
+            message: "ScrollArea viewport and thumb state MUST remain synchronized.",
+            recoverable: true
+          })
+        });
+        return;
+      }
+      const nextScrollTop = toScrollOffset(
+        positionPercent,
+        state.viewport.scrollHeight,
+        state.viewport.clientHeight
+      );
+      const nextViewport = clampViewport({
+        ...state.viewport,
+        scrollTop: nextScrollTop
+      });
+      const nextComputed = resolveStateFromViewport(nextViewport);
+      const meta = {
+        source: "user",
+        reason: "vertical-thumb-drag",
+        previousValue: state.viewport.scrollTop,
+        nextValue: nextScrollTop,
+        inputModality: "pointer"
+      };
+      store.patchState(
+        {
+          viewport: nextViewport,
+          vertical: {
+            ...nextComputed.vertical,
+            thumbPositionPercent: clamp(positionPercent, 0, 100)
+          },
+          horizontal: nextComputed.horizontal,
+          cornerVisible: nextComputed.cornerVisible,
+          lastInteraction: "vertical-thumb",
+          lastChangeMeta: meta,
+          lastError: null
+        },
+        meta
+      );
+    },
+    dragHorizontalThumb(positionPercent) {
+      const state = store.getState();
+      if (!state.horizontal.visible) {
+        store.patchState({
+          lastError: createUIFnError({
+            code: "UIFN_ERR_SCROLL_SYNC",
+            package: "@uifn/core",
+            component: "ScrollArea",
+            message: "ScrollArea viewport and thumb state MUST remain synchronized.",
+            recoverable: true
+          })
+        });
+        return;
+      }
+      const nextScrollLeft = toScrollOffset(
+        positionPercent,
+        state.viewport.scrollWidth,
+        state.viewport.clientWidth
+      );
+      const nextViewport = clampViewport({
+        ...state.viewport,
+        scrollLeft: nextScrollLeft
+      });
+      const nextComputed = resolveStateFromViewport(nextViewport);
+      const meta = {
+        source: "user",
+        reason: "horizontal-thumb-drag",
+        previousValue: state.viewport.scrollLeft,
+        nextValue: nextScrollLeft,
+        inputModality: "pointer"
+      };
+      store.patchState(
+        {
+          viewport: nextViewport,
+          horizontal: {
+            ...nextComputed.horizontal,
+            thumbPositionPercent: clamp(positionPercent, 0, 100)
+          },
+          vertical: nextComputed.vertical,
+          cornerVisible: nextComputed.cornerVisible,
+          lastInteraction: "horizontal-thumb",
+          lastChangeMeta: meta,
+          lastError: null
+        },
+        meta
+      );
+    }
+  };
+  return {
+    get state() {
+      return store.getState();
+    },
+    actions,
+    getState: store.getState,
+    subscribe: store.subscribe
+  };
+}
+
+export { createScrollArea };
+//# sourceMappingURL=chunk-TWTQ2Y7N.mjs.map
+//# sourceMappingURL=chunk-TWTQ2Y7N.mjs.map

package/dist/chunk-TWTQ2Y7N.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/primitives/scroll-area.ts"],"names":[],"mappings":"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","file":"chunk-TWTQ2Y7N.mjs","sourcesContent":["import { createUIFnError, type UIFnError } from '../errors';\nimport { clamp, type ChangeMeta, createStore } from './shared';\n\nexport interface ScrollAreaProps {\n  type?: 'auto' | 'always' | 'scroll' | 'hover';\n  scrollHideDelay?: number;\n}\n\nexport interface ScrollMetrics {\n  scrollTop: number;\n  scrollLeft: number;\n  scrollHeight: number;\n  scrollWidth: number;\n  clientHeight: number;\n  clientWidth: number;\n}\n\nexport interface ScrollAxisState {\n  visible: boolean;\n  thumbSizePercent: number;\n  thumbPositionPercent: number;\n}\n\nexport interface ScrollAreaState {\n  type: 'auto' | 'always' | 'scroll' | 'hover';\n  scrollHideDelay: number;\n  viewport: ScrollMetrics;\n  vertical: ScrollAxisState;\n  horizontal: ScrollAxisState;\n  cornerVisible: boolean;\n  lastInteraction: 'viewport' | 'vertical-thumb' | 'horizontal-thumb' | null;\n  lastChangeMeta?: ChangeMeta<number>;\n  lastError: UIFnError | null;\n}\n\nexport interface ScrollAreaActions {\n  setViewportMetrics: (metrics: Partial<ScrollMetrics>) => void;\n  onViewportScroll: (position: { top?: number; left?: number }) => void;\n  scrollTo: (position: { top?: number; left?: number }) => void;\n  dragVerticalThumb: (positionPercent: number) => void;\n  dragHorizontalThumb: (positionPercent: number) => void;\n}\n\nexport interface ScrollAreaMachine {\n  readonly state: ScrollAreaState;\n  readonly actions: ScrollAreaActions;\n  getState: () => ScrollAreaState;\n  subscribe: (\n    callback: (state: ScrollAreaState, meta?: ChangeMeta<number>) => void\n  ) => () => void;\n}\n\nfunction createDefaultViewport(): ScrollMetrics {\n  return {\n    scrollTop: 0,\n    scrollLeft: 0,\n    scrollHeight: 0,\n    scrollWidth: 0,\n    clientHeight: 0,\n    clientWidth: 0,\n  };\n}\n\nfunction toAxisState(\n  scrollSize: number,\n  clientSize: number,\n  scrollOffset: number\n): ScrollAxisState {\n  const visible = scrollSize > clientSize && clientSize > 0;\n  if (!visible) {\n    return {\n      visible: false,\n      thumbSizePercent: 100,\n      thumbPositionPercent: 0,\n    };\n  }\n\n  const maxScroll = Math.max(1, scrollSize - clientSize);\n  const thumbSizePercent = clamp((clientSize / scrollSize) * 100, 5, 100);\n  const thumbPositionPercent = clamp((scrollOffset / maxScroll) * 100, 0, 100);\n\n  return {\n    visible: true,\n    thumbSizePercent,\n    thumbPositionPercent,\n  };\n}\n\nfunction resolveStateFromViewport(\n  viewport: ScrollMetrics\n): Pick<ScrollAreaState, 'vertical' | 'horizontal' | 'cornerVisible'> {\n  const vertical = toAxisState(viewport.scrollHeight, viewport.clientHeight, viewport.scrollTop);\n  const horizontal = toAxisState(viewport.scrollWidth, viewport.clientWidth, viewport.scrollLeft);\n\n  return {\n    vertical,\n    horizontal,\n    cornerVisible: vertical.visible && horizontal.visible,\n  };\n}\n\nfunction toScrollOffset(positionPercent: number, scrollSize: number, clientSize: number): number {\n  const maxScroll = Math.max(0, scrollSize - clientSize);\n  if (maxScroll === 0) {\n    return 0;\n  }\n\n  return (clamp(positionPercent, 0, 100) / 100) * maxScroll;\n}\n\nfunction clampViewport(viewport: ScrollMetrics): ScrollMetrics {\n  return {\n    ...viewport,\n    scrollTop: clamp(\n      viewport.scrollTop,\n      0,\n      Math.max(0, viewport.scrollHeight - viewport.clientHeight)\n    ),\n    scrollLeft: clamp(\n      viewport.scrollLeft,\n      0,\n      Math.max(0, viewport.scrollWidth - viewport.clientWidth)\n    ),\n  };\n}\n\nexport function createScrollArea(props: ScrollAreaProps): ScrollAreaMachine {\n  const viewport = createDefaultViewport();\n  const computed = resolveStateFromViewport(viewport);\n  const store = createStore<ScrollAreaState, number>({\n    type: props.type ?? 'hover',\n    scrollHideDelay: props.scrollHideDelay ?? 600,\n    viewport,\n    vertical: computed.vertical,\n    horizontal: computed.horizontal,\n    cornerVisible: computed.cornerVisible,\n    lastInteraction: null,\n    lastError: null,\n  });\n\n  const actions: ScrollAreaActions = {\n    setViewportMetrics(metrics) {\n      const state = store.getState();\n      const nextViewport = clampViewport({\n        ...state.viewport,\n        ...metrics,\n      });\n      const nextComputed = resolveStateFromViewport(nextViewport);\n      store.patchState({\n        viewport: nextViewport,\n        vertical: nextComputed.vertical,\n        horizontal: nextComputed.horizontal,\n        cornerVisible: nextComputed.cornerVisible,\n      });\n    },\n    onViewportScroll(position) {\n      const state = store.getState();\n      const nextViewport = clampViewport({\n        ...state.viewport,\n        scrollTop: position.top !== undefined ? position.top : state.viewport.scrollTop,\n        scrollLeft: position.left !== undefined ? position.left : state.viewport.scrollLeft,\n      });\n      const nextComputed = resolveStateFromViewport(nextViewport);\n      const meta: ChangeMeta<number> = {\n        source: 'user',\n        reason: 'viewport-scroll',\n        previousValue: state.viewport.scrollTop,\n        nextValue: nextViewport.scrollTop,\n        inputModality: 'pointer',\n      };\n      store.patchState(\n        {\n          viewport: nextViewport,\n          vertical: nextComputed.vertical,\n          horizontal: nextComputed.horizontal,\n          cornerVisible: nextComputed.cornerVisible,\n          lastInteraction: 'viewport',\n          lastChangeMeta: meta,\n          lastError: null,\n        },\n        meta\n      );\n    },\n    scrollTo(position) {\n      const state = store.getState();\n      const nextViewport = clampViewport({\n        ...state.viewport,\n        scrollTop: position.top !== undefined ? position.top : state.viewport.scrollTop,\n        scrollLeft: position.left !== undefined ? position.left : state.viewport.scrollLeft,\n      });\n      const nextComputed = resolveStateFromViewport(nextViewport);\n      const meta: ChangeMeta<number> = {\n        source: 'programmatic',\n        reason: 'programmatic-scroll',\n        previousValue: state.viewport.scrollTop,\n        nextValue: nextViewport.scrollTop,\n      };\n      store.patchState(\n        {\n          viewport: nextViewport,\n          vertical: nextComputed.vertical,\n          horizontal: nextComputed.horizontal,\n          cornerVisible: nextComputed.cornerVisible,\n          lastInteraction: 'viewport',\n          lastChangeMeta: meta,\n          lastError: null,\n        },\n        meta\n      );\n    },\n    dragVerticalThumb(positionPercent) {\n      const state = store.getState();\n      if (!state.vertical.visible) {\n        store.patchState({\n          lastError: createUIFnError({\n            code: 'UIFN_ERR_SCROLL_SYNC',\n            package: '@uifn/core',\n            component: 'ScrollArea',\n            message: 'ScrollArea viewport and thumb state MUST remain synchronized.',\n            recoverable: true,\n          }),\n        });\n        return;\n      }\n\n      const nextScrollTop = toScrollOffset(\n        positionPercent,\n        state.viewport.scrollHeight,\n        state.viewport.clientHeight\n      );\n      const nextViewport = clampViewport({\n        ...state.viewport,\n        scrollTop: nextScrollTop,\n      });\n      const nextComputed = resolveStateFromViewport(nextViewport);\n      const meta: ChangeMeta<number> = {\n        source: 'user',\n        reason: 'vertical-thumb-drag',\n        previousValue: state.viewport.scrollTop,\n        nextValue: nextScrollTop,\n        inputModality: 'pointer',\n      };\n      store.patchState(\n        {\n          viewport: nextViewport,\n          vertical: {\n            ...nextComputed.vertical,\n            thumbPositionPercent: clamp(positionPercent, 0, 100),\n          },\n          horizontal: nextComputed.horizontal,\n          cornerVisible: nextComputed.cornerVisible,\n          lastInteraction: 'vertical-thumb',\n          lastChangeMeta: meta,\n          lastError: null,\n        },\n        meta\n      );\n    },\n    dragHorizontalThumb(positionPercent) {\n      const state = store.getState();\n      if (!state.horizontal.visible) {\n        store.patchState({\n          lastError: createUIFnError({\n            code: 'UIFN_ERR_SCROLL_SYNC',\n            package: '@uifn/core',\n            component: 'ScrollArea',\n            message: 'ScrollArea viewport and thumb state MUST remain synchronized.',\n            recoverable: true,\n          }),\n        });\n        return;\n      }\n\n      const nextScrollLeft = toScrollOffset(\n        positionPercent,\n        state.viewport.scrollWidth,\n        state.viewport.clientWidth\n      );\n      const nextViewport = clampViewport({\n        ...state.viewport,\n        scrollLeft: nextScrollLeft,\n      });\n      const nextComputed = resolveStateFromViewport(nextViewport);\n      const meta: ChangeMeta<number> = {\n        source: 'user',\n        reason: 'horizontal-thumb-drag',\n        previousValue: state.viewport.scrollLeft,\n        nextValue: nextScrollLeft,\n        inputModality: 'pointer',\n      };\n      store.patchState(\n        {\n          viewport: nextViewport,\n          horizontal: {\n            ...nextComputed.horizontal,\n            thumbPositionPercent: clamp(positionPercent, 0, 100),\n          },\n          vertical: nextComputed.vertical,\n          cornerVisible: nextComputed.cornerVisible,\n          lastInteraction: 'horizontal-thumb',\n          lastChangeMeta: meta,\n          lastError: null,\n        },\n        meta\n      );\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"]}