@refraction-ui/shared 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 elloloop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,21 @@
+# @refraction-ui/shared
+
+Shared utilities used across all Refraction UI packages. Part of [Refraction UI](https://elloloop.github.io/refraction-ui/).
+
+## Install
+
+```bash
+pnpm add @refraction-ui/shared
+```
+
+## Usage
+
+```tsx
+import { cn } from '@refraction-ui/shared'
+
+const className = cn('base-class', condition && 'conditional-class')
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,316 @@
+'use strict';
+
+// src/aria.ts
+function mergeAriaProps(...propSets) {
+  const result = {};
+  for (const props of propSets) {
+    for (const [key, value] of Object.entries(props)) {
+      if (value !== void 0) {
+        result[key] = value;
+      }
+    }
+  }
+  return result;
+}
+var idCounter = 0;
+function generateId(prefix = "rfr") {
+  idCounter++;
+  return `${prefix}-${idCounter}`;
+}
+function resetIdCounter() {
+  idCounter = 0;
+}
+
+// src/keyboard.ts
+var Keys = {
+  Enter: "Enter",
+  Space: " ",
+  Escape: "Escape",
+  Tab: "Tab",
+  ArrowUp: "ArrowUp",
+  ArrowDown: "ArrowDown",
+  ArrowLeft: "ArrowLeft",
+  ArrowRight: "ArrowRight",
+  Home: "Home",
+  End: "End",
+  PageUp: "PageUp",
+  PageDown: "PageDown",
+  Backspace: "Backspace",
+  Delete: "Delete"
+};
+function createKeyboardHandler(handlers) {
+  return (event) => {
+    const handler = handlers[event.key];
+    if (handler) {
+      handler(event);
+    }
+  };
+}
+
+// src/state-machine.ts
+function createMachine(config) {
+  let current = config.initial;
+  const listeners = /* @__PURE__ */ new Set();
+  return {
+    get state() {
+      return current;
+    },
+    send(event) {
+      const stateConfig = config.states[current];
+      const next = stateConfig?.on?.[event];
+      if (next && next !== current) {
+        current = next;
+        for (const fn of listeners) {
+          fn(current);
+        }
+      }
+    },
+    subscribe(fn) {
+      listeners.add(fn);
+      return () => {
+        listeners.delete(fn);
+      };
+    },
+    matches(state) {
+      return current === state;
+    }
+  };
+}
+
+// src/cn.ts
+function cn(...inputs) {
+  const classes = [];
+  for (const input of inputs) {
+    if (!input) continue;
+    if (typeof input === "string") {
+      classes.push(input);
+    } else if (typeof input === "number") {
+      classes.push(String(input));
+    } else if (Array.isArray(input)) {
+      const nested = cn(...input);
+      if (nested) classes.push(nested);
+    } else if (typeof input === "object") {
+      for (const [key, value] of Object.entries(input)) {
+        if (value) classes.push(key);
+      }
+    }
+  }
+  return classes.join(" ");
+}
+
+// src/cva.ts
+function cva(config) {
+  return (props) => {
+    const classes = [];
+    if (config.base) {
+      classes.push(config.base);
+    }
+    if (config.variants) {
+      for (const [variantKey, variantOptions] of Object.entries(config.variants)) {
+        const selectedValue = props?.[variantKey] ?? config.defaultVariants?.[variantKey];
+        if (selectedValue != null) {
+          const variantClass = variantOptions[selectedValue];
+          if (variantClass) {
+            classes.push(variantClass);
+          }
+        }
+      }
+    }
+    if (config.compoundVariants) {
+      for (const compound of config.compoundVariants) {
+        const { class: compoundClass, ...conditions } = compound;
+        let matches = true;
+        for (const [key, value] of Object.entries(conditions)) {
+          const propValue = props?.[key] ?? config.defaultVariants?.[key];
+          if (propValue !== value) {
+            matches = false;
+            break;
+          }
+        }
+        if (matches) {
+          classes.push(compoundClass);
+        }
+      }
+    }
+    if (props?.className) {
+      classes.push(props.className);
+    }
+    return classes.filter(Boolean).join(" ");
+  };
+}
+
+// src/focus-trap.ts
+var FOCUSABLE_SELECTOR = 'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])';
+function getFocusableElements(container) {
+  return Array.from(container.querySelectorAll(FOCUSABLE_SELECTOR));
+}
+function createFocusTrap(config) {
+  let active = false;
+  let previouslyFocused = null;
+  function handleKeyDown(event) {
+    if (event.key === "Escape" && config.onEscape) {
+      event.preventDefault();
+      config.onEscape();
+      return;
+    }
+    if (event.key !== "Tab") return;
+    const focusable = getFocusableElements(config.container);
+    if (focusable.length === 0) return;
+    const first = focusable[0];
+    const last = focusable[focusable.length - 1];
+    if (event.shiftKey) {
+      if (document.activeElement === first) {
+        event.preventDefault();
+        last.focus();
+      }
+    } else {
+      if (document.activeElement === last) {
+        event.preventDefault();
+        first.focus();
+      }
+    }
+  }
+  return {
+    activate() {
+      if (active) return;
+      active = true;
+      if (typeof document !== "undefined") {
+        previouslyFocused = document.activeElement;
+      }
+      if (config.initialFocus) {
+        const target = config.initialFocus();
+        if (target && "focus" in target) {
+          target.focus();
+        }
+      } else {
+        const focusable = getFocusableElements(config.container);
+        if (focusable.length > 0) {
+          focusable[0].focus();
+        }
+      }
+      config.container.addEventListener(
+        "keydown",
+        handleKeyDown
+      );
+    },
+    deactivate() {
+      if (!active) return;
+      active = false;
+      config.container.removeEventListener(
+        "keydown",
+        handleKeyDown
+      );
+      if (config.returnFocusOnDeactivate !== false && previouslyFocused && "focus" in previouslyFocused) {
+        previouslyFocused.focus();
+      }
+    },
+    isActive() {
+      return active;
+    }
+  };
+}
+
+// src/live-region.ts
+function createLiveRegion(config = {}) {
+  const { politeness = "polite", clearAfterMs = 5e3 } = config;
+  let element = null;
+  let clearTimeout = null;
+  function getElement() {
+    if (!element && typeof document !== "undefined") {
+      element = document.createElement("div");
+      element.setAttribute("role", "status");
+      element.setAttribute("aria-live", politeness);
+      element.setAttribute("aria-atomic", "true");
+      Object.assign(element.style, {
+        position: "absolute",
+        width: "1px",
+        height: "1px",
+        padding: "0",
+        margin: "-1px",
+        overflow: "hidden",
+        clip: "rect(0, 0, 0, 0)",
+        whiteSpace: "nowrap",
+        border: "0"
+      });
+      document.body.appendChild(element);
+    }
+    return element;
+  }
+  return {
+    announce(message) {
+      const el = getElement();
+      if (!el) return;
+      if (clearTimeout !== null) {
+        globalThis.clearTimeout(clearTimeout);
+      }
+      el.textContent = message;
+      if (clearAfterMs > 0) {
+        clearTimeout = globalThis.setTimeout(() => {
+          el.textContent = "";
+          clearTimeout = null;
+        }, clearAfterMs);
+      }
+    },
+    clear() {
+      if (clearTimeout !== null) {
+        globalThis.clearTimeout(clearTimeout);
+        clearTimeout = null;
+      }
+      if (element) {
+        element.textContent = "";
+      }
+    },
+    destroy() {
+      if (clearTimeout !== null) {
+        globalThis.clearTimeout(clearTimeout);
+        clearTimeout = null;
+      }
+      if (element && element.parentNode) {
+        element.parentNode.removeChild(element);
+        element = null;
+      }
+    }
+  };
+}
+
+// src/motion.ts
+function prefersReducedMotion() {
+  if (typeof window === "undefined") return false;
+  return window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+}
+function getAnimationDuration(normalDuration) {
+  return prefersReducedMotion() ? "0ms" : normalDuration;
+}
+
+// src/skip-link.ts
+function createSkipLink(props = {}) {
+  const targetId = props.targetId ?? "main-content";
+  const label = props.label ?? "Skip to main content";
+  return {
+    ariaProps: {
+      role: "link",
+      "aria-label": label
+    },
+    href: `#${targetId}`,
+    label,
+    className: "sr-only focus:not-sr-only focus:absolute focus:z-50 focus:p-4 focus:bg-white focus:text-black focus:underline"
+  };
+}
+
+exports.FOCUSABLE_SELECTOR = FOCUSABLE_SELECTOR;
+exports.Keys = Keys;
+exports.cn = cn;
+exports.createFocusTrap = createFocusTrap;
+exports.createKeyboardHandler = createKeyboardHandler;
+exports.createLiveRegion = createLiveRegion;
+exports.createMachine = createMachine;
+exports.createSkipLink = createSkipLink;
+exports.cva = cva;
+exports.generateId = generateId;
+exports.getAnimationDuration = getAnimationDuration;
+exports.getFocusableElements = getFocusableElements;
+exports.mergeAriaProps = mergeAriaProps;
+exports.prefersReducedMotion = prefersReducedMotion;
+exports.resetIdCounter = resetIdCounter;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/aria.ts","../src/keyboard.ts","../src/state-machine.ts","../src/cn.ts","../src/cva.ts","../src/focus-trap.ts","../src/live-region.ts","../src/motion.ts","../src/skip-link.ts"],"names":[],"mappings":";;;AACO,SAAS,kBACX,QAAA,EACsB;AACzB,EAAA,MAAM,SAAkC,EAAC;AACzC,EAAA,KAAA,MAAW,SAAS,QAAA,EAAU;AAC5B,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,EAAG;AAChD,MAAA,IAAI,UAAU,MAAA,EAAW;AACvB,QAAA,MAAA,CAAO,GAAG,CAAA,GAAI,KAAA;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AACA,EAAA,OAAO,MAAA;AACT;AAEA,IAAI,SAAA,GAAY,CAAA;AAMT,SAAS,UAAA,CAAW,SAAS,KAAA,EAAe;AACjD,EAAA,SAAA,EAAA;AACA,EAAA,OAAO,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,SAAS,CAAA,CAAA;AAC/B;AAGO,SAAS,cAAA,GAAuB;AACrC,EAAA,SAAA,GAAY,CAAA;AACd;;;AC5BO,IAAM,IAAA,GAAO;AAAA,EAClB,KAAA,EAAO,OAAA;AAAA,EACP,KAAA,EAAO,GAAA;AAAA,EACP,MAAA,EAAQ,QAAA;AAAA,EACR,GAAA,EAAK,KAAA;AAAA,EACL,OAAA,EAAS,SAAA;AAAA,EACT,SAAA,EAAW,WAAA;AAAA,EACX,SAAA,EAAW,WAAA;AAAA,EACX,UAAA,EAAY,YAAA;AAAA,EACZ,IAAA,EAAM,MAAA;AAAA,EACN,GAAA,EAAK,KAAA;AAAA,EACL,MAAA,EAAQ,QAAA;AAAA,EACR,QAAA,EAAU,UAAA;AAAA,EACV,SAAA,EAAW,WAAA;AAAA,EACX,MAAA,EAAQ;AACV;AAUO,SAAS,sBACd,QAAA,EACgC;AAChC,EAAA,OAAO,CAAC,KAAA,KAAyB;AAC/B,IAAA,MAAM,OAAA,GAAU,QAAA,CAAS,KAAA,CAAM,GAAG,CAAA;AAClC,IAAA,IAAI,OAAA,EAAS;AACX,MAAA,OAAA,CAAQ,KAAK,CAAA;AAAA,IACf;AAAA,EACF,CAAA;AACF;;;ACZO,SAAS,cACd,MAAA,EACyB;AACzB,EAAA,IAAI,UAAU,MAAA,CAAO,OAAA;AACrB,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAA6B;AAEnD,EAAA,OAAO;AAAA,IACL,IAAI,KAAA,GAAQ;AACV,MAAA,OAAO,OAAA;AAAA,IACT,CAAA;AAAA,IAEA,KAAK,KAAA,EAAe;AAClB,MAAA,MAAM,WAAA,GAAc,MAAA,CAAO,MAAA,CAAO,OAAO,CAAA;AACzC,MAAA,MAAM,IAAA,GAAO,WAAA,EAAa,EAAA,GAAK,KAAK,CAAA;AACpC,MAAA,IAAI,IAAA,IAAQ,SAAS,OAAA,EAAS;AAC5B,QAAA,OAAA,GAAU,IAAA;AACV,QAAA,KAAA,MAAW,MAAM,SAAA,EAAW;AAC1B,UAAA,EAAA,CAAG,OAAO,CAAA;AAAA,QACZ;AAAA,MACF;AAAA,IACF,CAAA;AAAA,IAEA,UAAU,EAAA,EAA6B;AACrC,MAAA,SAAA,CAAU,IAAI,EAAE,CAAA;AAChB,MAAA,OAAO,MAAM;AACX,QAAA,SAAA,CAAU,OAAO,EAAE,CAAA;AAAA,MACrB,CAAA;AAAA,IACF,CAAA;AAAA,IAEA,QAAQ,KAAA,EAAe;AACrB,MAAA,OAAO,OAAA,KAAY,KAAA;AAAA,IACrB;AAAA,GACF;AACF;;;AC3CO,SAAS,MAAM,MAAA,EAAiD;AACrE,EAAA,MAAM,UAAoB,EAAC;AAE3B,EAAA,KAAA,MAAW,SAAS,MAAA,EAAQ;AAC1B,IAAA,IAAI,CAAC,KAAA,EAAO;AAEZ,IAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,MAAA,OAAA,CAAQ,KAAK,KAAK,CAAA;AAAA,IACpB,CAAA,MAAA,IAAW,OAAO,KAAA,KAAU,QAAA,EAAU;AACpC,MAAA,OAAA,CAAQ,IAAA,CAAK,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,IAC5B,CAAA,MAAA,IAAW,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AAC/B,MAAA,MAAM,MAAA,GAAS,EAAA,CAAG,GAAG,KAAK,CAAA;AAC1B,MAAA,IAAI,MAAA,EAAQ,OAAA,CAAQ,IAAA,CAAK,MAAM,CAAA;AAAA,IACjC,CAAA,MAAA,IAAW,OAAO,KAAA,KAAU,QAAA,EAAU;AACpC,MAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,EAAG;AAChD,QAAA,IAAI,KAAA,EAAO,OAAA,CAAQ,IAAA,CAAK,GAAG,CAAA;AAAA,MAC7B;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,OAAA,CAAQ,KAAK,GAAG,CAAA;AACzB;;;ACNO,SAAS,IAA6B,MAAA,EAAsB;AACjE,EAAA,OAAO,CAAC,KAAA,KAA6D;AACnE,IAAA,MAAM,UAAoB,EAAC;AAE3B,IAAA,IAAI,OAAO,IAAA,EAAM;AACf,MAAA,OAAA,CAAQ,IAAA,CAAK,OAAO,IAAI,CAAA;AAAA,IAC1B;AAEA,IAAA,IAAI,OAAO,QAAA,EAAU;AACnB,MAAA,KAAA,MAAW,CAAC,YAAY,cAAc,CAAA,IAAK,OAAO,OAAA,CAAQ,MAAA,CAAO,QAAQ,CAAA,EAAG;AAC1E,QAAA,MAAM,gBACH,KAAA,GAAgD,UAAU,CAAA,IAC3D,MAAA,CAAO,kBAAkB,UAAU,CAAA;AAErC,QAAA,IAAI,iBAAiB,IAAA,EAAM;AACzB,UAAA,MAAM,YAAA,GAAgB,eACpB,aACF,CAAA;AACA,UAAA,IAAI,YAAA,EAAc;AAChB,YAAA,OAAA,CAAQ,KAAK,YAAY,CAAA;AAAA,UAC3B;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IAAI,OAAO,gBAAA,EAAkB;AAC3B,MAAA,KAAA,MAAW,QAAA,IAAY,OAAO,gBAAA,EAAkB;AAC9C,QAAA,MAAM,EAAE,KAAA,EAAO,aAAA,EAAe,GAAG,YAAW,GAAI,QAAA;AAChD,QAAA,IAAI,OAAA,GAAU,IAAA;AAEd,QAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA,EAAG;AACrD,UAAA,MAAM,YACH,KAAA,GAAoC,GAAG,CAAA,IACxC,MAAA,CAAO,kBAAkB,GAAG,CAAA;AAC9B,UAAA,IAAI,cAAc,KAAA,EAAO;AACvB,YAAA,OAAA,GAAU,KAAA;AACV,YAAA;AAAA,UACF;AAAA,QACF;AAEA,QAAA,IAAI,OAAA,EAAS;AACX,UAAA,OAAA,CAAQ,KAAK,aAAuB,CAAA;AAAA,QACtC;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IAAI,OAAO,SAAA,EAAW;AACpB,MAAA,OAAA,CAAQ,IAAA,CAAK,MAAM,SAAS,CAAA;AAAA,IAC9B;AAEA,IAAA,OAAO,OAAA,CAAQ,MAAA,CAAO,OAAO,CAAA,CAAE,KAAK,GAAG,CAAA;AAAA,EACzC,CAAA;AACF;;;ACzEO,IAAM,kBAAA,GACX;AAGK,SAAS,qBAAqB,SAAA,EAA+B;AAClE,EAAA,OAAO,KAAA,CAAM,IAAA,CAAK,SAAA,CAAU,gBAAA,CAAiB,kBAAkB,CAAC,CAAA;AAClE;AAsBO,SAAS,gBAAgB,MAAA,EAAoC;AAClE,EAAA,IAAI,MAAA,GAAS,KAAA;AACb,EAAA,IAAI,iBAAA,GAAoC,IAAA;AAExC,EAAA,SAAS,cAAc,KAAA,EAA4B;AACjD,IAAA,IAAI,KAAA,CAAM,GAAA,KAAQ,QAAA,IAAY,MAAA,CAAO,QAAA,EAAU;AAC7C,MAAA,KAAA,CAAM,cAAA,EAAe;AACrB,MAAA,MAAA,CAAO,QAAA,EAAS;AAChB,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,KAAA,CAAM,QAAQ,KAAA,EAAO;AAEzB,IAAA,MAAM,SAAA,GAAY,oBAAA,CAAqB,MAAA,CAAO,SAAS,CAAA;AACvD,IAAA,IAAI,SAAA,CAAU,WAAW,CAAA,EAAG;AAE5B,IAAA,MAAM,KAAA,GAAQ,UAAU,CAAC,CAAA;AACzB,IAAA,MAAM,IAAA,GAAO,SAAA,CAAU,SAAA,CAAU,MAAA,GAAS,CAAC,CAAA;AAE3C,IAAA,IAAI,MAAM,QAAA,EAAU;AAElB,MAAA,IAAI,QAAA,CAAS,kBAAkB,KAAA,EAAO;AACpC,QAAA,KAAA,CAAM,cAAA,EAAe;AACrB,QAAA,IAAA,CAAK,KAAA,EAAM;AAAA,MACb;AAAA,IACF,CAAA,MAAO;AAEL,MAAA,IAAI,QAAA,CAAS,kBAAkB,IAAA,EAAM;AACnC,QAAA,KAAA,CAAM,cAAA,EAAe;AACrB,QAAA,KAAA,CAAM,KAAA,EAAM;AAAA,MACd;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,QAAA,GAAW;AACT,MAAA,IAAI,MAAA,EAAQ;AACZ,MAAA,MAAA,GAAS,IAAA;AAGT,MAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACnC,QAAA,iBAAA,GAAoB,QAAA,CAAS,aAAA;AAAA,MAC/B;AAGA,MAAA,IAAI,OAAO,YAAA,EAAc;AACvB,QAAA,MAAM,MAAA,GAAS,OAAO,YAAA,EAAa;AACnC,QAAA,IAAI,MAAA,IAAU,WAAW,MAAA,EAAQ;AAC9B,UAAC,OAAuB,KAAA,EAAM;AAAA,QACjC;AAAA,MACF,CAAA,MAAO;AACL,QAAA,MAAM,SAAA,GAAY,oBAAA,CAAqB,MAAA,CAAO,SAAS,CAAA;AACvD,QAAA,IAAI,SAAA,CAAU,SAAS,CAAA,EAAG;AACvB,UAAC,SAAA,CAAU,CAAC,CAAA,CAAkB,KAAA,EAAM;AAAA,QACvC;AAAA,MACF;AAGA,MAAA,MAAA,CAAO,SAAA,CAAU,gBAAA;AAAA,QACf,SAAA;AAAA,QACA;AAAA,OACF;AAAA,IACF,CAAA;AAAA,IAEA,UAAA,GAAa;AACX,MAAA,IAAI,CAAC,MAAA,EAAQ;AACb,MAAA,MAAA,GAAS,KAAA;AAET,MAAA,MAAA,CAAO,SAAA,CAAU,mBAAA;AAAA,QACf,SAAA;AAAA,QACA;AAAA,OACF;AAGA,MAAA,IACE,MAAA,CAAO,uBAAA,KAA4B,KAAA,IACnC,iBAAA,IACA,WAAW,iBAAA,EACX;AACC,QAAC,kBAAkC,KAAA,EAAM;AAAA,MAC5C;AAAA,IACF,CAAA;AAAA,IAEA,QAAA,GAAW;AACT,MAAA,OAAO,MAAA;AAAA,IACT;AAAA,GACF;AACF;;;ACvGO,SAAS,gBAAA,CAAiB,MAAA,GAA2B,EAAC,EAAe;AAC1E,EAAA,MAAM,EAAE,UAAA,GAAa,QAAA,EAAU,YAAA,GAAe,KAAK,GAAI,MAAA;AACvD,EAAA,IAAI,OAAA,GAA8B,IAAA;AAClC,EAAA,IAAI,YAAA,GAAqD,IAAA;AAEzD,EAAA,SAAS,UAAA,GAA0B;AACjC,IAAA,IAAI,CAAC,OAAA,IAAW,OAAO,QAAA,KAAa,WAAA,EAAa;AAC/C,MAAA,OAAA,GAAU,QAAA,CAAS,cAAc,KAAK,CAAA;AACtC,MAAA,OAAA,CAAQ,YAAA,CAAa,QAAQ,QAAQ,CAAA;AACrC,MAAA,OAAA,CAAQ,YAAA,CAAa,aAAa,UAAU,CAAA;AAC5C,MAAA,OAAA,CAAQ,YAAA,CAAa,eAAe,MAAM,CAAA;AAE1C,MAAA,MAAA,CAAO,MAAA,CAAO,QAAQ,KAAA,EAAO;AAAA,QAC3B,QAAA,EAAU,UAAA;AAAA,QACV,KAAA,EAAO,KAAA;AAAA,QACP,MAAA,EAAQ,KAAA;AAAA,QACR,OAAA,EAAS,GAAA;AAAA,QACT,MAAA,EAAQ,MAAA;AAAA,QACR,QAAA,EAAU,QAAA;AAAA,QACV,IAAA,EAAM,kBAAA;AAAA,QACN,UAAA,EAAY,QAAA;AAAA,QACZ,MAAA,EAAQ;AAAA,OACT,CAAA;AACD,MAAA,QAAA,CAAS,IAAA,CAAK,YAAY,OAAO,CAAA;AAAA,IACnC;AACA,IAAA,OAAO,OAAA;AAAA,EACT;AAEA,EAAA,OAAO;AAAA,IACL,SAAS,OAAA,EAAuB;AAC9B,MAAA,MAAM,KAAK,UAAA,EAAW;AACtB,MAAA,IAAI,CAAC,EAAA,EAAI;AAGT,MAAA,IAAI,iBAAiB,IAAA,EAAM;AACzB,QAAA,UAAA,CAAW,aAAa,YAAY,CAAA;AAAA,MACtC;AAGA,MAAA,EAAA,CAAG,WAAA,GAAc,OAAA;AAEjB,MAAA,IAAI,eAAe,CAAA,EAAG;AACpB,QAAA,YAAA,GAAe,UAAA,CAAW,WAAW,MAAM;AACzC,UAAA,EAAA,CAAG,WAAA,GAAc,EAAA;AACjB,UAAA,YAAA,GAAe,IAAA;AAAA,QACjB,GAAG,YAAY,CAAA;AAAA,MACjB;AAAA,IACF,CAAA;AAAA,IAEA,KAAA,GAAc;AACZ,MAAA,IAAI,iBAAiB,IAAA,EAAM;AACzB,QAAA,UAAA,CAAW,aAAa,YAAY,CAAA;AACpC,QAAA,YAAA,GAAe,IAAA;AAAA,MACjB;AACA,MAAA,IAAI,OAAA,EAAS;AACX,QAAA,OAAA,CAAQ,WAAA,GAAc,EAAA;AAAA,MACxB;AAAA,IACF,CAAA;AAAA,IAEA,OAAA,GAAgB;AACd,MAAA,IAAI,iBAAiB,IAAA,EAAM;AACzB,QAAA,UAAA,CAAW,aAAa,YAAY,CAAA;AACpC,QAAA,YAAA,GAAe,IAAA;AAAA,MACjB;AACA,MAAA,IAAI,OAAA,IAAW,QAAQ,UAAA,EAAY;AACjC,QAAA,OAAA,CAAQ,UAAA,CAAW,YAAY,OAAO,CAAA;AACtC,QAAA,OAAA,GAAU,IAAA;AAAA,MACZ;AAAA,IACF;AAAA,GACF;AACF;;;ACnFO,SAAS,oBAAA,GAAgC;AAC9C,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,KAAA;AAC1C,EAAA,OAAO,MAAA,CAAO,UAAA,CAAW,kCAAkC,CAAA,CAAE,OAAA;AAC/D;AAGO,SAAS,qBAAqB,cAAA,EAAgC;AACnE,EAAA,OAAO,oBAAA,KAAyB,KAAA,GAAQ,cAAA;AAC1C;;;ACAO,SAAS,cAAA,CAAe,KAAA,GAAuB,EAAC,EAMrD;AACA,EAAA,MAAM,QAAA,GAAW,MAAM,QAAA,IAAY,cAAA;AACnC,EAAA,MAAM,KAAA,GAAQ,MAAM,KAAA,IAAS,sBAAA;AAE7B,EAAA,OAAO;AAAA,IACL,SAAA,EAAW;AAAA,MACT,IAAA,EAAM,MAAA;AAAA,MACN,YAAA,EAAc;AAAA,KAChB;AAAA,IACA,IAAA,EAAM,IAAI,QAAQ,CAAA,CAAA;AAAA,IAClB,KAAA;AAAA,IACA,SAAA,EACE;AAAA,GACJ;AACF","file":"index.cjs","sourcesContent":["/** Merge multiple ARIA prop objects, later values override earlier ones */\nexport function mergeAriaProps(\n  ...propSets: Array<Record<string, unknown>>\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {}\n  for (const props of propSets) {\n    for (const [key, value] of Object.entries(props)) {\n      if (value !== undefined) {\n        result[key] = value\n      }\n    }\n  }\n  return result\n}\n\nlet idCounter = 0\n\n/**\n * Generate a unique ID, safe for SSR (deterministic within a render pass).\n * In browsers, uses crypto.randomUUID when available.\n */\nexport function generateId(prefix = 'rfr'): string {\n  idCounter++\n  return `${prefix}-${idCounter}`\n}\n\n/** Reset the ID counter (useful for tests) */\nexport function resetIdCounter(): void {\n  idCounter = 0\n}\n","/** Standard keyboard key constants */\nexport const Keys = {\n  Enter: 'Enter',\n  Space: ' ',\n  Escape: 'Escape',\n  Tab: 'Tab',\n  ArrowUp: 'ArrowUp',\n  ArrowDown: 'ArrowDown',\n  ArrowLeft: 'ArrowLeft',\n  ArrowRight: 'ArrowRight',\n  Home: 'Home',\n  End: 'End',\n  PageUp: 'PageUp',\n  PageDown: 'PageDown',\n  Backspace: 'Backspace',\n  Delete: 'Delete',\n} as const\n\nexport type KeyboardKey = (typeof Keys)[keyof typeof Keys]\n\n/** Map of key → handler function */\nexport type KeyboardHandlerMap = Partial<\n  Record<string, (event: KeyboardEvent) => void>\n>\n\n/** Create a keyboard event handler from a handler map */\nexport function createKeyboardHandler(\n  handlers: KeyboardHandlerMap,\n): (event: KeyboardEvent) => void {\n  return (event: KeyboardEvent) => {\n    const handler = handlers[event.key]\n    if (handler) {\n      handler(event)\n    }\n  }\n}\n","/**\n * Minimal state machine — zero dependencies, < 1KB.\n * Inspired by XState concepts but dramatically simpler.\n */\n\nexport interface MachineConfig<TState extends string, TEvent extends string> {\n  initial: TState\n  states: Record<TState, {\n    on?: Partial<Record<TEvent, TState>>\n  }>\n}\n\nexport interface Machine<TState extends string, TEvent extends string> {\n  /** Current state */\n  state: TState\n  /** Send an event to transition */\n  send(event: TEvent): void\n  /** Subscribe to state changes. Returns unsubscribe function. */\n  subscribe(fn: (state: TState) => void): () => void\n  /** Check if machine is in a given state */\n  matches(state: TState): boolean\n}\n\nexport function createMachine<TState extends string, TEvent extends string>(\n  config: MachineConfig<TState, TEvent>,\n): Machine<TState, TEvent> {\n  let current = config.initial\n  const listeners = new Set<(state: TState) => void>()\n\n  return {\n    get state() {\n      return current\n    },\n\n    send(event: TEvent) {\n      const stateConfig = config.states[current]\n      const next = stateConfig?.on?.[event]\n      if (next && next !== current) {\n        current = next\n        for (const fn of listeners) {\n          fn(current)\n        }\n      }\n    },\n\n    subscribe(fn: (state: TState) => void) {\n      listeners.add(fn)\n      return () => {\n        listeners.delete(fn)\n      }\n    },\n\n    matches(state: TState) {\n      return current === state\n    },\n  }\n}\n","/**\n * Lightweight class name utility — our own implementation.\n * Handles conditional classes, arrays, and falsy values.\n * No external dependencies (no clsx, no tailwind-merge).\n *\n * For Tailwind class conflict resolution (e.g., 'p-2 p-4' → 'p-4'),\n * consumers can use @refraction-ui/tailwind-config which provides\n * a tw-merge-aware variant of this function.\n */\n\ntype ClassValue = string | number | boolean | undefined | null | ClassValue[]\ntype ClassRecord = Record<string, boolean | undefined | null>\n\nexport function cn(...inputs: Array<ClassValue | ClassRecord>): string {\n  const classes: string[] = []\n\n  for (const input of inputs) {\n    if (!input) continue\n\n    if (typeof input === 'string') {\n      classes.push(input)\n    } else if (typeof input === 'number') {\n      classes.push(String(input))\n    } else if (Array.isArray(input)) {\n      const nested = cn(...input)\n      if (nested) classes.push(nested)\n    } else if (typeof input === 'object') {\n      for (const [key, value] of Object.entries(input)) {\n        if (value) classes.push(key)\n      }\n    }\n  }\n\n  return classes.join(' ')\n}\n","/**\n * Lightweight class-variance-authority alternative — zero dependencies.\n * Creates variant-driven class name functions for components.\n */\n\ntype ClassValue = string | undefined | null | false\n\ninterface VariantConfig {\n  [variant: string]: Record<string, string>\n}\n\ninterface CVAConfig<V extends VariantConfig> {\n  base?: string\n  variants?: V\n  defaultVariants?: {\n    [K in keyof V]?: keyof V[K]\n  }\n  compoundVariants?: Array<\n    {\n      [K in keyof V]?: keyof V[K]\n    } & { class: string }\n  >\n}\n\ntype VariantProps<V extends VariantConfig> = {\n  [K in keyof V]?: keyof V[K]\n}\n\nexport function cva<V extends VariantConfig>(config: CVAConfig<V>) {\n  return (props?: VariantProps<V> & { className?: string }): string => {\n    const classes: string[] = []\n\n    if (config.base) {\n      classes.push(config.base)\n    }\n\n    if (config.variants) {\n      for (const [variantKey, variantOptions] of Object.entries(config.variants)) {\n        const selectedValue =\n          (props as Record<string, unknown> | undefined)?.[variantKey] ??\n          config.defaultVariants?.[variantKey]\n\n        if (selectedValue != null) {\n          const variantClass = (variantOptions as Record<string, string>)[\n            selectedValue as string\n          ]\n          if (variantClass) {\n            classes.push(variantClass)\n          }\n        }\n      }\n    }\n\n    if (config.compoundVariants) {\n      for (const compound of config.compoundVariants) {\n        const { class: compoundClass, ...conditions } = compound\n        let matches = true\n\n        for (const [key, value] of Object.entries(conditions)) {\n          const propValue =\n            (props as Record<string, unknown>)?.[key] ??\n            config.defaultVariants?.[key]\n          if (propValue !== value) {\n            matches = false\n            break\n          }\n        }\n\n        if (matches) {\n          classes.push(compoundClass as string)\n        }\n      }\n    }\n\n    if (props?.className) {\n      classes.push(props.className)\n    }\n\n    return classes.filter(Boolean).join(' ')\n  }\n}\n","/**\n * Focus trap utilities — keeps keyboard focus within a container.\n * Used by Dialog, DropdownMenu, and other overlay components.\n * Pure TypeScript, no DOM dependency (accepts element via parameter).\n */\n\n/** Selector for all natively focusable elements */\nexport const FOCUSABLE_SELECTOR =\n  'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex=\"-1\"])'\n\n/** Get all focusable elements within a container */\nexport function getFocusableElements(container: Element): Element[] {\n  return Array.from(container.querySelectorAll(FOCUSABLE_SELECTOR))\n}\n\n/** Configuration for creating a focus trap */\nexport interface FocusTrapConfig {\n  /** The container element */\n  container: Element\n  /** Called to get the initial focus target */\n  initialFocus?: () => Element | null\n  /** Called when Escape is pressed */\n  onEscape?: () => void\n  /** Whether to return focus to trigger on deactivate */\n  returnFocusOnDeactivate?: boolean\n}\n\n/** A focus trap instance */\nexport interface FocusTrap {\n  activate(): void\n  deactivate(): void\n  isActive(): boolean\n}\n\n/** Create a focus trap that keeps Tab/Shift+Tab within a container */\nexport function createFocusTrap(config: FocusTrapConfig): FocusTrap {\n  let active = false\n  let previouslyFocused: Element | null = null\n\n  function handleKeyDown(event: KeyboardEvent): void {\n    if (event.key === 'Escape' && config.onEscape) {\n      event.preventDefault()\n      config.onEscape()\n      return\n    }\n\n    if (event.key !== 'Tab') return\n\n    const focusable = getFocusableElements(config.container)\n    if (focusable.length === 0) return\n\n    const first = focusable[0] as HTMLElement\n    const last = focusable[focusable.length - 1] as HTMLElement\n\n    if (event.shiftKey) {\n      // Shift+Tab: if on first element, wrap to last\n      if (document.activeElement === first) {\n        event.preventDefault()\n        last.focus()\n      }\n    } else {\n      // Tab: if on last element, wrap to first\n      if (document.activeElement === last) {\n        event.preventDefault()\n        first.focus()\n      }\n    }\n  }\n\n  return {\n    activate() {\n      if (active) return\n      active = true\n\n      // Remember the currently focused element so we can restore it later\n      if (typeof document !== 'undefined') {\n        previouslyFocused = document.activeElement\n      }\n\n      // Set initial focus\n      if (config.initialFocus) {\n        const target = config.initialFocus()\n        if (target && 'focus' in target) {\n          ;(target as HTMLElement).focus()\n        }\n      } else {\n        const focusable = getFocusableElements(config.container)\n        if (focusable.length > 0) {\n          ;(focusable[0] as HTMLElement).focus()\n        }\n      }\n\n      // Attach keydown listener to the container\n      config.container.addEventListener(\n        'keydown',\n        handleKeyDown as EventListener,\n      )\n    },\n\n    deactivate() {\n      if (!active) return\n      active = false\n\n      config.container.removeEventListener(\n        'keydown',\n        handleKeyDown as EventListener,\n      )\n\n      // Restore focus to the previously focused element\n      if (\n        config.returnFocusOnDeactivate !== false &&\n        previouslyFocused &&\n        'focus' in previouslyFocused\n      ) {\n        ;(previouslyFocused as HTMLElement).focus()\n      }\n    },\n\n    isActive() {\n      return active\n    },\n  }\n}\n","/**\n * Screen reader announcement utility.\n * Creates and manages an aria-live region for dynamic content updates.\n */\n\nexport interface LiveRegionConfig {\n  /** 'polite' (default) or 'assertive' */\n  politeness?: 'polite' | 'assertive'\n  /** Clear the announcement after this many ms. Default: 5000 */\n  clearAfterMs?: number\n}\n\nexport interface LiveRegion {\n  announce(message: string): void\n  clear(): void\n  destroy(): void\n}\n\n/** Create a live region that announces messages to screen readers */\nexport function createLiveRegion(config: LiveRegionConfig = {}): LiveRegion {\n  const { politeness = 'polite', clearAfterMs = 5000 } = config\n  let element: HTMLElement | null = null\n  let clearTimeout: ReturnType<typeof setTimeout> | null = null\n\n  function getElement(): HTMLElement {\n    if (!element && typeof document !== 'undefined') {\n      element = document.createElement('div')\n      element.setAttribute('role', 'status')\n      element.setAttribute('aria-live', politeness)\n      element.setAttribute('aria-atomic', 'true')\n      // Visually hidden but accessible to screen readers\n      Object.assign(element.style, {\n        position: 'absolute',\n        width: '1px',\n        height: '1px',\n        padding: '0',\n        margin: '-1px',\n        overflow: 'hidden',\n        clip: 'rect(0, 0, 0, 0)',\n        whiteSpace: 'nowrap',\n        border: '0',\n      })\n      document.body.appendChild(element)\n    }\n    return element!\n  }\n\n  return {\n    announce(message: string): void {\n      const el = getElement()\n      if (!el) return\n\n      // Clear any pending timeout\n      if (clearTimeout !== null) {\n        globalThis.clearTimeout(clearTimeout)\n      }\n\n      // Set text content — screen readers will detect the change via aria-live\n      el.textContent = message\n\n      if (clearAfterMs > 0) {\n        clearTimeout = globalThis.setTimeout(() => {\n          el.textContent = ''\n          clearTimeout = null\n        }, clearAfterMs)\n      }\n    },\n\n    clear(): void {\n      if (clearTimeout !== null) {\n        globalThis.clearTimeout(clearTimeout)\n        clearTimeout = null\n      }\n      if (element) {\n        element.textContent = ''\n      }\n    },\n\n    destroy(): void {\n      if (clearTimeout !== null) {\n        globalThis.clearTimeout(clearTimeout)\n        clearTimeout = null\n      }\n      if (element && element.parentNode) {\n        element.parentNode.removeChild(element)\n        element = null\n      }\n    },\n  }\n}\n","/**\n * Reduced motion utilities.\n * Respects user preferences for reduced motion.\n */\n\n/** Check if user prefers reduced motion */\nexport function prefersReducedMotion(): boolean {\n  if (typeof window === 'undefined') return false\n  return window.matchMedia('(prefers-reduced-motion: reduce)').matches\n}\n\n/** Get animation duration — returns '0ms' if reduced motion preferred */\nexport function getAnimationDuration(normalDuration: string): string {\n  return prefersReducedMotion() ? '0ms' : normalDuration\n}\n","/**\n * Skip-to-content link utility.\n * Provides a keyboard-accessible link that is visually hidden until focused.\n */\n\n/** Props for a skip-to-content link */\nexport interface SkipLinkProps {\n  /** ID of the target element. Default: 'main-content' */\n  targetId?: string\n  /** Label text for the link. Default: 'Skip to main content' */\n  label?: string\n}\n\n/** Create props for a skip-to-content link */\nexport function createSkipLink(props: SkipLinkProps = {}): {\n  ariaProps: Record<string, string>\n  href: string\n  label: string\n  /** CSS classes — visually hidden until focused */\n  className: string\n} {\n  const targetId = props.targetId ?? 'main-content'\n  const label = props.label ?? 'Skip to main content'\n\n  return {\n    ariaProps: {\n      role: 'link',\n      'aria-label': label,\n    },\n    href: `#${targetId}`,\n    label,\n    className:\n      'sr-only focus:not-sr-only focus:absolute focus:z-50 focus:p-4 focus:bg-white focus:text-black focus:underline',\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,242 @@
+/**
+ * Framework-agnostic base prop types for all refraction-ui components.
+ * These are headless core types — no React, Angular, or Astro imports.
+ * Framework wrappers extend these with framework-specific types.
+ */
+/** Base props shared by all components */
+interface BaseProps {
+    id?: string;
+    className?: string;
+    style?: Record<string, string | number>;
+    [dataAttr: `data-${string}`]: string | undefined;
+}
+/** Accessibility props */
+interface AccessibilityProps {
+    role?: string;
+    tabIndex?: number;
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    'aria-describedby'?: string;
+    'aria-controls'?: string;
+    'aria-expanded'?: boolean;
+    'aria-selected'?: boolean;
+    'aria-hidden'?: boolean;
+    'aria-disabled'?: boolean;
+    'aria-pressed'?: boolean | 'mixed';
+    'aria-checked'?: boolean | 'mixed';
+    'aria-current'?: boolean | 'page' | 'step' | 'location' | 'date' | 'time';
+    'aria-live'?: 'off' | 'assertive' | 'polite';
+    'aria-atomic'?: boolean;
+}
+/** Theme customization props (framework-agnostic) */
+interface ThemeProps {
+    variant?: string;
+    size?: string;
+    colorScheme?: string;
+    disabled?: boolean;
+}
+/** Composition props (framework-agnostic) */
+interface CompositionProps {
+    asChild?: boolean;
+}
+
+/** Standard size scale */
+type Size = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+/** Standard component variants */
+type Variant = 'default' | 'primary' | 'secondary' | 'destructive' | 'outline' | 'ghost' | 'link';
+/** Layout orientation */
+type Orientation = 'horizontal' | 'vertical';
+/** Positioning side */
+type Side = 'top' | 'right' | 'bottom' | 'left';
+/** Alignment */
+type Align = 'start' | 'center' | 'end';
+/** Data state attribute values */
+type DataState = 'open' | 'closed' | 'active' | 'inactive';
+
+/** Defines the CSS custom properties a component reads */
+interface TokenContract {
+    /** Component name */
+    name: string;
+    /** Map of token name → CSS custom property info */
+    tokens: Record<string, TokenDefinition>;
+}
+interface TokenDefinition {
+    /** CSS custom property name (e.g., '--rfr-button-bg') */
+    variable: string;
+    /** Fallback value when the variable is not set */
+    fallback: string;
+    /** Description of what this token controls */
+    description?: string;
+}
+
+/** Standard keyboard key constants */
+declare const Keys: {
+    readonly Enter: "Enter";
+    readonly Space: " ";
+    readonly Escape: "Escape";
+    readonly Tab: "Tab";
+    readonly ArrowUp: "ArrowUp";
+    readonly ArrowDown: "ArrowDown";
+    readonly ArrowLeft: "ArrowLeft";
+    readonly ArrowRight: "ArrowRight";
+    readonly Home: "Home";
+    readonly End: "End";
+    readonly PageUp: "PageUp";
+    readonly PageDown: "PageDown";
+    readonly Backspace: "Backspace";
+    readonly Delete: "Delete";
+};
+type KeyboardKey = (typeof Keys)[keyof typeof Keys];
+/** Map of key → handler function */
+type KeyboardHandlerMap = Partial<Record<string, (event: KeyboardEvent) => void>>;
+/** Create a keyboard event handler from a handler map */
+declare function createKeyboardHandler(handlers: KeyboardHandlerMap): (event: KeyboardEvent) => void;
+
+/**
+ * Minimal state machine — zero dependencies, < 1KB.
+ * Inspired by XState concepts but dramatically simpler.
+ */
+interface MachineConfig<TState extends string, TEvent extends string> {
+    initial: TState;
+    states: Record<TState, {
+        on?: Partial<Record<TEvent, TState>>;
+    }>;
+}
+interface Machine<TState extends string, TEvent extends string> {
+    /** Current state */
+    state: TState;
+    /** Send an event to transition */
+    send(event: TEvent): void;
+    /** Subscribe to state changes. Returns unsubscribe function. */
+    subscribe(fn: (state: TState) => void): () => void;
+    /** Check if machine is in a given state */
+    matches(state: TState): boolean;
+}
+declare function createMachine<TState extends string, TEvent extends string>(config: MachineConfig<TState, TEvent>): Machine<TState, TEvent>;
+
+/**
+ * Focus trap utilities — keeps keyboard focus within a container.
+ * Used by Dialog, DropdownMenu, and other overlay components.
+ * Pure TypeScript, no DOM dependency (accepts element via parameter).
+ */
+/** Selector for all natively focusable elements */
+declare const FOCUSABLE_SELECTOR = "a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex=\"-1\"])";
+/** Get all focusable elements within a container */
+declare function getFocusableElements(container: Element): Element[];
+/** Configuration for creating a focus trap */
+interface FocusTrapConfig {
+    /** The container element */
+    container: Element;
+    /** Called to get the initial focus target */
+    initialFocus?: () => Element | null;
+    /** Called when Escape is pressed */
+    onEscape?: () => void;
+    /** Whether to return focus to trigger on deactivate */
+    returnFocusOnDeactivate?: boolean;
+}
+/** A focus trap instance */
+interface FocusTrap {
+    activate(): void;
+    deactivate(): void;
+    isActive(): boolean;
+}
+/** Create a focus trap that keeps Tab/Shift+Tab within a container */
+declare function createFocusTrap(config: FocusTrapConfig): FocusTrap;
+
+/**
+ * Screen reader announcement utility.
+ * Creates and manages an aria-live region for dynamic content updates.
+ */
+interface LiveRegionConfig {
+    /** 'polite' (default) or 'assertive' */
+    politeness?: 'polite' | 'assertive';
+    /** Clear the announcement after this many ms. Default: 5000 */
+    clearAfterMs?: number;
+}
+interface LiveRegion {
+    announce(message: string): void;
+    clear(): void;
+    destroy(): void;
+}
+/** Create a live region that announces messages to screen readers */
+declare function createLiveRegion(config?: LiveRegionConfig): LiveRegion;
+
+/**
+ * Skip-to-content link utility.
+ * Provides a keyboard-accessible link that is visually hidden until focused.
+ */
+/** Props for a skip-to-content link */
+interface SkipLinkProps {
+    /** ID of the target element. Default: 'main-content' */
+    targetId?: string;
+    /** Label text for the link. Default: 'Skip to main content' */
+    label?: string;
+}
+/** Create props for a skip-to-content link */
+declare function createSkipLink(props?: SkipLinkProps): {
+    ariaProps: Record<string, string>;
+    href: string;
+    label: string;
+    /** CSS classes — visually hidden until focused */
+    className: string;
+};
+
+/** Merge multiple ARIA prop objects, later values override earlier ones */
+declare function mergeAriaProps(...propSets: Array<Record<string, unknown>>): Record<string, unknown>;
+/**
+ * Generate a unique ID, safe for SSR (deterministic within a render pass).
+ * In browsers, uses crypto.randomUUID when available.
+ */
+declare function generateId(prefix?: string): string;
+/** Reset the ID counter (useful for tests) */
+declare function resetIdCounter(): void;
+
+/**
+ * Lightweight class name utility — our own implementation.
+ * Handles conditional classes, arrays, and falsy values.
+ * No external dependencies (no clsx, no tailwind-merge).
+ *
+ * For Tailwind class conflict resolution (e.g., 'p-2 p-4' → 'p-4'),
+ * consumers can use @refraction-ui/tailwind-config which provides
+ * a tw-merge-aware variant of this function.
+ */
+type ClassValue = string | number | boolean | undefined | null | ClassValue[];
+type ClassRecord = Record<string, boolean | undefined | null>;
+declare function cn(...inputs: Array<ClassValue | ClassRecord>): string;
+
+/**
+ * Lightweight class-variance-authority alternative — zero dependencies.
+ * Creates variant-driven class name functions for components.
+ */
+interface VariantConfig {
+    [variant: string]: Record<string, string>;
+}
+interface CVAConfig<V extends VariantConfig> {
+    base?: string;
+    variants?: V;
+    defaultVariants?: {
+        [K in keyof V]?: keyof V[K];
+    };
+    compoundVariants?: Array<{
+        [K in keyof V]?: keyof V[K];
+    } & {
+        class: string;
+    }>;
+}
+type VariantProps<V extends VariantConfig> = {
+    [K in keyof V]?: keyof V[K];
+};
+declare function cva<V extends VariantConfig>(config: CVAConfig<V>): (props?: VariantProps<V> & {
+    className?: string;
+}) => string;
+
+/**
+ * Reduced motion utilities.
+ * Respects user preferences for reduced motion.
+ */
+/** Check if user prefers reduced motion */
+declare function prefersReducedMotion(): boolean;
+/** Get animation duration — returns '0ms' if reduced motion preferred */
+declare function getAnimationDuration(normalDuration: string): string;
+
+export { type AccessibilityProps, type Align, type BaseProps, type CompositionProps, type DataState, FOCUSABLE_SELECTOR, type FocusTrap, type FocusTrapConfig, type KeyboardHandlerMap, type KeyboardKey, Keys, type LiveRegion, type LiveRegionConfig, type Machine, type MachineConfig, type Orientation, type Side, type Size, type SkipLinkProps, type ThemeProps, type TokenContract, type TokenDefinition, type Variant, cn, createFocusTrap, createKeyboardHandler, createLiveRegion, createMachine, createSkipLink, cva, generateId, getAnimationDuration, getFocusableElements, mergeAriaProps, prefersReducedMotion, resetIdCounter };

package/dist/index.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Framework-agnostic base prop types for all refraction-ui components.
+ * These are headless core types — no React, Angular, or Astro imports.
+ * Framework wrappers extend these with framework-specific types.
+ */
+/** Base props shared by all components */
+interface BaseProps {
+    id?: string;
+    className?: string;
+    style?: Record<string, string | number>;
+    [dataAttr: `data-${string}`]: string | undefined;
+}
+/** Accessibility props */
+interface AccessibilityProps {
+    role?: string;
+    tabIndex?: number;
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    'aria-describedby'?: string;
+    'aria-controls'?: string;
+    'aria-expanded'?: boolean;
+    'aria-selected'?: boolean;
+    'aria-hidden'?: boolean;
+    'aria-disabled'?: boolean;
+    'aria-pressed'?: boolean | 'mixed';
+    'aria-checked'?: boolean | 'mixed';
+    'aria-current'?: boolean | 'page' | 'step' | 'location' | 'date' | 'time';
+    'aria-live'?: 'off' | 'assertive' | 'polite';
+    'aria-atomic'?: boolean;
+}
+/** Theme customization props (framework-agnostic) */
+interface ThemeProps {
+    variant?: string;
+    size?: string;
+    colorScheme?: string;
+    disabled?: boolean;
+}
+/** Composition props (framework-agnostic) */
+interface CompositionProps {
+    asChild?: boolean;
+}
+
+/** Standard size scale */
+type Size = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+/** Standard component variants */
+type Variant = 'default' | 'primary' | 'secondary' | 'destructive' | 'outline' | 'ghost' | 'link';
+/** Layout orientation */
+type Orientation = 'horizontal' | 'vertical';
+/** Positioning side */
+type Side = 'top' | 'right' | 'bottom' | 'left';
+/** Alignment */
+type Align = 'start' | 'center' | 'end';
+/** Data state attribute values */
+type DataState = 'open' | 'closed' | 'active' | 'inactive';
+
+/** Defines the CSS custom properties a component reads */
+interface TokenContract {
+    /** Component name */
+    name: string;
+    /** Map of token name → CSS custom property info */
+    tokens: Record<string, TokenDefinition>;
+}
+interface TokenDefinition {
+    /** CSS custom property name (e.g., '--rfr-button-bg') */
+    variable: string;
+    /** Fallback value when the variable is not set */
+    fallback: string;
+    /** Description of what this token controls */
+    description?: string;
+}
+
+/** Standard keyboard key constants */
+declare const Keys: {
+    readonly Enter: "Enter";
+    readonly Space: " ";
+    readonly Escape: "Escape";
+    readonly Tab: "Tab";
+    readonly ArrowUp: "ArrowUp";
+    readonly ArrowDown: "ArrowDown";
+    readonly ArrowLeft: "ArrowLeft";
+    readonly ArrowRight: "ArrowRight";
+    readonly Home: "Home";
+    readonly End: "End";
+    readonly PageUp: "PageUp";
+    readonly PageDown: "PageDown";
+    readonly Backspace: "Backspace";
+    readonly Delete: "Delete";
+};
+type KeyboardKey = (typeof Keys)[keyof typeof Keys];
+/** Map of key → handler function */
+type KeyboardHandlerMap = Partial<Record<string, (event: KeyboardEvent) => void>>;
+/** Create a keyboard event handler from a handler map */
+declare function createKeyboardHandler(handlers: KeyboardHandlerMap): (event: KeyboardEvent) => void;
+
+/**
+ * Minimal state machine — zero dependencies, < 1KB.
+ * Inspired by XState concepts but dramatically simpler.
+ */
+interface MachineConfig<TState extends string, TEvent extends string> {
+    initial: TState;
+    states: Record<TState, {
+        on?: Partial<Record<TEvent, TState>>;
+    }>;
+}
+interface Machine<TState extends string, TEvent extends string> {
+    /** Current state */
+    state: TState;
+    /** Send an event to transition */
+    send(event: TEvent): void;
+    /** Subscribe to state changes. Returns unsubscribe function. */
+    subscribe(fn: (state: TState) => void): () => void;
+    /** Check if machine is in a given state */
+    matches(state: TState): boolean;
+}
+declare function createMachine<TState extends string, TEvent extends string>(config: MachineConfig<TState, TEvent>): Machine<TState, TEvent>;
+
+/**
+ * Focus trap utilities — keeps keyboard focus within a container.
+ * Used by Dialog, DropdownMenu, and other overlay components.
+ * Pure TypeScript, no DOM dependency (accepts element via parameter).
+ */
+/** Selector for all natively focusable elements */
+declare const FOCUSABLE_SELECTOR = "a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex=\"-1\"])";
+/** Get all focusable elements within a container */
+declare function getFocusableElements(container: Element): Element[];
+/** Configuration for creating a focus trap */
+interface FocusTrapConfig {
+    /** The container element */
+    container: Element;
+    /** Called to get the initial focus target */
+    initialFocus?: () => Element | null;
+    /** Called when Escape is pressed */
+    onEscape?: () => void;
+    /** Whether to return focus to trigger on deactivate */
+    returnFocusOnDeactivate?: boolean;
+}
+/** A focus trap instance */
+interface FocusTrap {
+    activate(): void;
+    deactivate(): void;
+    isActive(): boolean;
+}
+/** Create a focus trap that keeps Tab/Shift+Tab within a container */
+declare function createFocusTrap(config: FocusTrapConfig): FocusTrap;
+
+/**
+ * Screen reader announcement utility.
+ * Creates and manages an aria-live region for dynamic content updates.
+ */
+interface LiveRegionConfig {
+    /** 'polite' (default) or 'assertive' */
+    politeness?: 'polite' | 'assertive';
+    /** Clear the announcement after this many ms. Default: 5000 */
+    clearAfterMs?: number;
+}
+interface LiveRegion {
+    announce(message: string): void;
+    clear(): void;
+    destroy(): void;
+}
+/** Create a live region that announces messages to screen readers */
+declare function createLiveRegion(config?: LiveRegionConfig): LiveRegion;
+
+/**
+ * Skip-to-content link utility.
+ * Provides a keyboard-accessible link that is visually hidden until focused.
+ */
+/** Props for a skip-to-content link */
+interface SkipLinkProps {
+    /** ID of the target element. Default: 'main-content' */
+    targetId?: string;
+    /** Label text for the link. Default: 'Skip to main content' */
+    label?: string;
+}
+/** Create props for a skip-to-content link */
+declare function createSkipLink(props?: SkipLinkProps): {
+    ariaProps: Record<string, string>;
+    href: string;
+    label: string;
+    /** CSS classes — visually hidden until focused */
+    className: string;
+};
+
+/** Merge multiple ARIA prop objects, later values override earlier ones */
+declare function mergeAriaProps(...propSets: Array<Record<string, unknown>>): Record<string, unknown>;
+/**
+ * Generate a unique ID, safe for SSR (deterministic within a render pass).
+ * In browsers, uses crypto.randomUUID when available.
+ */
+declare function generateId(prefix?: string): string;
+/** Reset the ID counter (useful for tests) */
+declare function resetIdCounter(): void;
+
+/**
+ * Lightweight class name utility — our own implementation.
+ * Handles conditional classes, arrays, and falsy values.
+ * No external dependencies (no clsx, no tailwind-merge).
+ *
+ * For Tailwind class conflict resolution (e.g., 'p-2 p-4' → 'p-4'),
+ * consumers can use @refraction-ui/tailwind-config which provides
+ * a tw-merge-aware variant of this function.
+ */
+type ClassValue = string | number | boolean | undefined | null | ClassValue[];
+type ClassRecord = Record<string, boolean | undefined | null>;
+declare function cn(...inputs: Array<ClassValue | ClassRecord>): string;
+
+/**
+ * Lightweight class-variance-authority alternative — zero dependencies.
+ * Creates variant-driven class name functions for components.
+ */
+interface VariantConfig {
+    [variant: string]: Record<string, string>;
+}
+interface CVAConfig<V extends VariantConfig> {
+    base?: string;
+    variants?: V;
+    defaultVariants?: {
+        [K in keyof V]?: keyof V[K];
+    };
+    compoundVariants?: Array<{
+        [K in keyof V]?: keyof V[K];
+    } & {
+        class: string;
+    }>;
+}
+type VariantProps<V extends VariantConfig> = {
+    [K in keyof V]?: keyof V[K];
+};
+declare function cva<V extends VariantConfig>(config: CVAConfig<V>): (props?: VariantProps<V> & {
+    className?: string;
+}) => string;
+
+/**
+ * Reduced motion utilities.
+ * Respects user preferences for reduced motion.
+ */
+/** Check if user prefers reduced motion */
+declare function prefersReducedMotion(): boolean;
+/** Get animation duration — returns '0ms' if reduced motion preferred */
+declare function getAnimationDuration(normalDuration: string): string;
+
+export { type AccessibilityProps, type Align, type BaseProps, type CompositionProps, type DataState, FOCUSABLE_SELECTOR, type FocusTrap, type FocusTrapConfig, type KeyboardHandlerMap, type KeyboardKey, Keys, type LiveRegion, type LiveRegionConfig, type Machine, type MachineConfig, type Orientation, type Side, type Size, type SkipLinkProps, type ThemeProps, type TokenContract, type TokenDefinition, type Variant, cn, createFocusTrap, createKeyboardHandler, createLiveRegion, createMachine, createSkipLink, cva, generateId, getAnimationDuration, getFocusableElements, mergeAriaProps, prefersReducedMotion, resetIdCounter };

package/dist/index.js

@@ -0,0 +1,300 @@
+// src/aria.ts
+function mergeAriaProps(...propSets) {
+  const result = {};
+  for (const props of propSets) {
+    for (const [key, value] of Object.entries(props)) {
+      if (value !== void 0) {
+        result[key] = value;
+      }
+    }
+  }
+  return result;
+}
+var idCounter = 0;
+function generateId(prefix = "rfr") {
+  idCounter++;
+  return `${prefix}-${idCounter}`;
+}
+function resetIdCounter() {
+  idCounter = 0;
+}
+
+// src/keyboard.ts
+var Keys = {
+  Enter: "Enter",
+  Space: " ",
+  Escape: "Escape",
+  Tab: "Tab",
+  ArrowUp: "ArrowUp",
+  ArrowDown: "ArrowDown",
+  ArrowLeft: "ArrowLeft",
+  ArrowRight: "ArrowRight",
+  Home: "Home",
+  End: "End",
+  PageUp: "PageUp",
+  PageDown: "PageDown",
+  Backspace: "Backspace",
+  Delete: "Delete"
+};
+function createKeyboardHandler(handlers) {
+  return (event) => {
+    const handler = handlers[event.key];
+    if (handler) {
+      handler(event);
+    }
+  };
+}
+
+// src/state-machine.ts
+function createMachine(config) {
+  let current = config.initial;
+  const listeners = /* @__PURE__ */ new Set();
+  return {
+    get state() {
+      return current;
+    },
+    send(event) {
+      const stateConfig = config.states[current];
+      const next = stateConfig?.on?.[event];
+      if (next && next !== current) {
+        current = next;
+        for (const fn of listeners) {
+          fn(current);
+        }
+      }
+    },
+    subscribe(fn) {
+      listeners.add(fn);
+      return () => {
+        listeners.delete(fn);
+      };
+    },
+    matches(state) {
+      return current === state;
+    }
+  };
+}
+
+// src/cn.ts
+function cn(...inputs) {
+  const classes = [];
+  for (const input of inputs) {
+    if (!input) continue;
+    if (typeof input === "string") {
+      classes.push(input);
+    } else if (typeof input === "number") {
+      classes.push(String(input));
+    } else if (Array.isArray(input)) {
+      const nested = cn(...input);
+      if (nested) classes.push(nested);
+    } else if (typeof input === "object") {
+      for (const [key, value] of Object.entries(input)) {
+        if (value) classes.push(key);
+      }
+    }
+  }
+  return classes.join(" ");
+}
+
+// src/cva.ts
+function cva(config) {
+  return (props) => {
+    const classes = [];
+    if (config.base) {
+      classes.push(config.base);
+    }
+    if (config.variants) {
+      for (const [variantKey, variantOptions] of Object.entries(config.variants)) {
+        const selectedValue = props?.[variantKey] ?? config.defaultVariants?.[variantKey];
+        if (selectedValue != null) {
+          const variantClass = variantOptions[selectedValue];
+          if (variantClass) {
+            classes.push(variantClass);
+          }
+        }
+      }
+    }
+    if (config.compoundVariants) {
+      for (const compound of config.compoundVariants) {
+        const { class: compoundClass, ...conditions } = compound;
+        let matches = true;
+        for (const [key, value] of Object.entries(conditions)) {
+          const propValue = props?.[key] ?? config.defaultVariants?.[key];
+          if (propValue !== value) {
+            matches = false;
+            break;
+          }
+        }
+        if (matches) {
+          classes.push(compoundClass);
+        }
+      }
+    }
+    if (props?.className) {
+      classes.push(props.className);
+    }
+    return classes.filter(Boolean).join(" ");
+  };
+}
+
+// src/focus-trap.ts
+var FOCUSABLE_SELECTOR = 'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])';
+function getFocusableElements(container) {
+  return Array.from(container.querySelectorAll(FOCUSABLE_SELECTOR));
+}
+function createFocusTrap(config) {
+  let active = false;
+  let previouslyFocused = null;
+  function handleKeyDown(event) {
+    if (event.key === "Escape" && config.onEscape) {
+      event.preventDefault();
+      config.onEscape();
+      return;
+    }
+    if (event.key !== "Tab") return;
+    const focusable = getFocusableElements(config.container);
+    if (focusable.length === 0) return;
+    const first = focusable[0];
+    const last = focusable[focusable.length - 1];
+    if (event.shiftKey) {
+      if (document.activeElement === first) {
+        event.preventDefault();
+        last.focus();
+      }
+    } else {
+      if (document.activeElement === last) {
+        event.preventDefault();
+        first.focus();
+      }
+    }
+  }
+  return {
+    activate() {
+      if (active) return;
+      active = true;
+      if (typeof document !== "undefined") {
+        previouslyFocused = document.activeElement;
+      }
+      if (config.initialFocus) {
+        const target = config.initialFocus();
+        if (target && "focus" in target) {
+          target.focus();
+        }
+      } else {
+        const focusable = getFocusableElements(config.container);
+        if (focusable.length > 0) {
+          focusable[0].focus();
+        }
+      }
+      config.container.addEventListener(
+        "keydown",
+        handleKeyDown
+      );
+    },
+    deactivate() {
+      if (!active) return;
+      active = false;
+      config.container.removeEventListener(
+        "keydown",
+        handleKeyDown
+      );
+      if (config.returnFocusOnDeactivate !== false && previouslyFocused && "focus" in previouslyFocused) {
+        previouslyFocused.focus();
+      }
+    },
+    isActive() {
+      return active;
+    }
+  };
+}
+
+// src/live-region.ts
+function createLiveRegion(config = {}) {
+  const { politeness = "polite", clearAfterMs = 5e3 } = config;
+  let element = null;
+  let clearTimeout = null;
+  function getElement() {
+    if (!element && typeof document !== "undefined") {
+      element = document.createElement("div");
+      element.setAttribute("role", "status");
+      element.setAttribute("aria-live", politeness);
+      element.setAttribute("aria-atomic", "true");
+      Object.assign(element.style, {
+        position: "absolute",
+        width: "1px",
+        height: "1px",
+        padding: "0",
+        margin: "-1px",
+        overflow: "hidden",
+        clip: "rect(0, 0, 0, 0)",
+        whiteSpace: "nowrap",
+        border: "0"
+      });
+      document.body.appendChild(element);
+    }
+    return element;
+  }
+  return {
+    announce(message) {
+      const el = getElement();
+      if (!el) return;
+      if (clearTimeout !== null) {
+        globalThis.clearTimeout(clearTimeout);
+      }
+      el.textContent = message;
+      if (clearAfterMs > 0) {
+        clearTimeout = globalThis.setTimeout(() => {
+          el.textContent = "";
+          clearTimeout = null;
+        }, clearAfterMs);
+      }
+    },
+    clear() {
+      if (clearTimeout !== null) {
+        globalThis.clearTimeout(clearTimeout);
+        clearTimeout = null;
+      }
+      if (element) {
+        element.textContent = "";
+      }
+    },
+    destroy() {
+      if (clearTimeout !== null) {
+        globalThis.clearTimeout(clearTimeout);
+        clearTimeout = null;
+      }
+      if (element && element.parentNode) {
+        element.parentNode.removeChild(element);
+        element = null;
+      }
+    }
+  };
+}
+
+// src/motion.ts
+function prefersReducedMotion() {
+  if (typeof window === "undefined") return false;
+  return window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+}
+function getAnimationDuration(normalDuration) {
+  return prefersReducedMotion() ? "0ms" : normalDuration;
+}
+
+// src/skip-link.ts
+function createSkipLink(props = {}) {
+  const targetId = props.targetId ?? "main-content";
+  const label = props.label ?? "Skip to main content";
+  return {
+    ariaProps: {
+      role: "link",
+      "aria-label": label
+    },
+    href: `#${targetId}`,
+    label,
+    className: "sr-only focus:not-sr-only focus:absolute focus:z-50 focus:p-4 focus:bg-white focus:text-black focus:underline"
+  };
+}
+
+export { FOCUSABLE_SELECTOR, Keys, cn, createFocusTrap, createKeyboardHandler, createLiveRegion, createMachine, createSkipLink, cva, generateId, getAnimationDuration, getFocusableElements, mergeAriaProps, prefersReducedMotion, resetIdCounter };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/aria.ts","../src/keyboard.ts","../src/state-machine.ts","../src/cn.ts","../src/cva.ts","../src/focus-trap.ts","../src/live-region.ts","../src/motion.ts","../src/skip-link.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/** Merge multiple ARIA prop objects, later values override earlier ones */\nexport function mergeAriaProps(\n  ...propSets: Array<Record<string, unknown>>\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {}\n  for (const props of propSets) {\n    for (const [key, value] of Object.entries(props)) {\n      if (value !== undefined) {\n        result[key] = value\n      }\n    }\n  }\n  return result\n}\n\nlet idCounter = 0\n\n/**\n * Generate a unique ID, safe for SSR (deterministic within a render pass).\n * In browsers, uses crypto.randomUUID when available.\n */\nexport function generateId(prefix = 'rfr'): string {\n  idCounter++\n  return `${prefix}-${idCounter}`\n}\n\n/** Reset the ID counter (useful for tests) */\nexport function resetIdCounter(): void {\n  idCounter = 0\n}\n","/** Standard keyboard key constants */\nexport const Keys = {\n  Enter: 'Enter',\n  Space: ' ',\n  Escape: 'Escape',\n  Tab: 'Tab',\n  ArrowUp: 'ArrowUp',\n  ArrowDown: 'ArrowDown',\n  ArrowLeft: 'ArrowLeft',\n  ArrowRight: 'ArrowRight',\n  Home: 'Home',\n  End: 'End',\n  PageUp: 'PageUp',\n  PageDown: 'PageDown',\n  Backspace: 'Backspace',\n  Delete: 'Delete',\n} as const\n\nexport type KeyboardKey = (typeof Keys)[keyof typeof Keys]\n\n/** Map of key → handler function */\nexport type KeyboardHandlerMap = Partial<\n  Record<string, (event: KeyboardEvent) => void>\n>\n\n/** Create a keyboard event handler from a handler map */\nexport function createKeyboardHandler(\n  handlers: KeyboardHandlerMap,\n): (event: KeyboardEvent) => void {\n  return (event: KeyboardEvent) => {\n    const handler = handlers[event.key]\n    if (handler) {\n      handler(event)\n    }\n  }\n}\n","/**\n * Minimal state machine — zero dependencies, < 1KB.\n * Inspired by XState concepts but dramatically simpler.\n */\n\nexport interface MachineConfig<TState extends string, TEvent extends string> {\n  initial: TState\n  states: Record<TState, {\n    on?: Partial<Record<TEvent, TState>>\n  }>\n}\n\nexport interface Machine<TState extends string, TEvent extends string> {\n  /** Current state */\n  state: TState\n  /** Send an event to transition */\n  send(event: TEvent): void\n  /** Subscribe to state changes. Returns unsubscribe function. */\n  subscribe(fn: (state: TState) => void): () => void\n  /** Check if machine is in a given state */\n  matches(state: TState): boolean\n}\n\nexport function createMachine<TState extends string, TEvent extends string>(\n  config: MachineConfig<TState, TEvent>,\n): Machine<TState, TEvent> {\n  let current = config.initial\n  const listeners = new Set<(state: TState) => void>()\n\n  return {\n    get state() {\n      return current\n    },\n\n    send(event: TEvent) {\n      const stateConfig = config.states[current]\n      const next = stateConfig?.on?.[event]\n      if (next && next !== current) {\n        current = next\n        for (const fn of listeners) {\n          fn(current)\n        }\n      }\n    },\n\n    subscribe(fn: (state: TState) => void) {\n      listeners.add(fn)\n      return () => {\n        listeners.delete(fn)\n      }\n    },\n\n    matches(state: TState) {\n      return current === state\n    },\n  }\n}\n","/**\n * Lightweight class name utility — our own implementation.\n * Handles conditional classes, arrays, and falsy values.\n * No external dependencies (no clsx, no tailwind-merge).\n *\n * For Tailwind class conflict resolution (e.g., 'p-2 p-4' → 'p-4'),\n * consumers can use @refraction-ui/tailwind-config which provides\n * a tw-merge-aware variant of this function.\n */\n\ntype ClassValue = string | number | boolean | undefined | null | ClassValue[]\ntype ClassRecord = Record<string, boolean | undefined | null>\n\nexport function cn(...inputs: Array<ClassValue | ClassRecord>): string {\n  const classes: string[] = []\n\n  for (const input of inputs) {\n    if (!input) continue\n\n    if (typeof input === 'string') {\n      classes.push(input)\n    } else if (typeof input === 'number') {\n      classes.push(String(input))\n    } else if (Array.isArray(input)) {\n      const nested = cn(...input)\n      if (nested) classes.push(nested)\n    } else if (typeof input === 'object') {\n      for (const [key, value] of Object.entries(input)) {\n        if (value) classes.push(key)\n      }\n    }\n  }\n\n  return classes.join(' ')\n}\n","/**\n * Lightweight class-variance-authority alternative — zero dependencies.\n * Creates variant-driven class name functions for components.\n */\n\ntype ClassValue = string | undefined | null | false\n\ninterface VariantConfig {\n  [variant: string]: Record<string, string>\n}\n\ninterface CVAConfig<V extends VariantConfig> {\n  base?: string\n  variants?: V\n  defaultVariants?: {\n    [K in keyof V]?: keyof V[K]\n  }\n  compoundVariants?: Array<\n    {\n      [K in keyof V]?: keyof V[K]\n    } & { class: string }\n  >\n}\n\ntype VariantProps<V extends VariantConfig> = {\n  [K in keyof V]?: keyof V[K]\n}\n\nexport function cva<V extends VariantConfig>(config: CVAConfig<V>) {\n  return (props?: VariantProps<V> & { className?: string }): string => {\n    const classes: string[] = []\n\n    if (config.base) {\n      classes.push(config.base)\n    }\n\n    if (config.variants) {\n      for (const [variantKey, variantOptions] of Object.entries(config.variants)) {\n        const selectedValue =\n          (props as Record<string, unknown> | undefined)?.[variantKey] ??\n          config.defaultVariants?.[variantKey]\n\n        if (selectedValue != null) {\n          const variantClass = (variantOptions as Record<string, string>)[\n            selectedValue as string\n          ]\n          if (variantClass) {\n            classes.push(variantClass)\n          }\n        }\n      }\n    }\n\n    if (config.compoundVariants) {\n      for (const compound of config.compoundVariants) {\n        const { class: compoundClass, ...conditions } = compound\n        let matches = true\n\n        for (const [key, value] of Object.entries(conditions)) {\n          const propValue =\n            (props as Record<string, unknown>)?.[key] ??\n            config.defaultVariants?.[key]\n          if (propValue !== value) {\n            matches = false\n            break\n          }\n        }\n\n        if (matches) {\n          classes.push(compoundClass as string)\n        }\n      }\n    }\n\n    if (props?.className) {\n      classes.push(props.className)\n    }\n\n    return classes.filter(Boolean).join(' ')\n  }\n}\n","/**\n * Focus trap utilities — keeps keyboard focus within a container.\n * Used by Dialog, DropdownMenu, and other overlay components.\n * Pure TypeScript, no DOM dependency (accepts element via parameter).\n */\n\n/** Selector for all natively focusable elements */\nexport const FOCUSABLE_SELECTOR =\n  'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex=\"-1\"])'\n\n/** Get all focusable elements within a container */\nexport function getFocusableElements(container: Element): Element[] {\n  return Array.from(container.querySelectorAll(FOCUSABLE_SELECTOR))\n}\n\n/** Configuration for creating a focus trap */\nexport interface FocusTrapConfig {\n  /** The container element */\n  container: Element\n  /** Called to get the initial focus target */\n  initialFocus?: () => Element | null\n  /** Called when Escape is pressed */\n  onEscape?: () => void\n  /** Whether to return focus to trigger on deactivate */\n  returnFocusOnDeactivate?: boolean\n}\n\n/** A focus trap instance */\nexport interface FocusTrap {\n  activate(): void\n  deactivate(): void\n  isActive(): boolean\n}\n\n/** Create a focus trap that keeps Tab/Shift+Tab within a container */\nexport function createFocusTrap(config: FocusTrapConfig): FocusTrap {\n  let active = false\n  let previouslyFocused: Element | null = null\n\n  function handleKeyDown(event: KeyboardEvent): void {\n    if (event.key === 'Escape' && config.onEscape) {\n      event.preventDefault()\n      config.onEscape()\n      return\n    }\n\n    if (event.key !== 'Tab') return\n\n    const focusable = getFocusableElements(config.container)\n    if (focusable.length === 0) return\n\n    const first = focusable[0] as HTMLElement\n    const last = focusable[focusable.length - 1] as HTMLElement\n\n    if (event.shiftKey) {\n      // Shift+Tab: if on first element, wrap to last\n      if (document.activeElement === first) {\n        event.preventDefault()\n        last.focus()\n      }\n    } else {\n      // Tab: if on last element, wrap to first\n      if (document.activeElement === last) {\n        event.preventDefault()\n        first.focus()\n      }\n    }\n  }\n\n  return {\n    activate() {\n      if (active) return\n      active = true\n\n      // Remember the currently focused element so we can restore it later\n      if (typeof document !== 'undefined') {\n        previouslyFocused = document.activeElement\n      }\n\n      // Set initial focus\n      if (config.initialFocus) {\n        const target = config.initialFocus()\n        if (target && 'focus' in target) {\n          ;(target as HTMLElement).focus()\n        }\n      } else {\n        const focusable = getFocusableElements(config.container)\n        if (focusable.length > 0) {\n          ;(focusable[0] as HTMLElement).focus()\n        }\n      }\n\n      // Attach keydown listener to the container\n      config.container.addEventListener(\n        'keydown',\n        handleKeyDown as EventListener,\n      )\n    },\n\n    deactivate() {\n      if (!active) return\n      active = false\n\n      config.container.removeEventListener(\n        'keydown',\n        handleKeyDown as EventListener,\n      )\n\n      // Restore focus to the previously focused element\n      if (\n        config.returnFocusOnDeactivate !== false &&\n        previouslyFocused &&\n        'focus' in previouslyFocused\n      ) {\n        ;(previouslyFocused as HTMLElement).focus()\n      }\n    },\n\n    isActive() {\n      return active\n    },\n  }\n}\n","/**\n * Screen reader announcement utility.\n * Creates and manages an aria-live region for dynamic content updates.\n */\n\nexport interface LiveRegionConfig {\n  /** 'polite' (default) or 'assertive' */\n  politeness?: 'polite' | 'assertive'\n  /** Clear the announcement after this many ms. Default: 5000 */\n  clearAfterMs?: number\n}\n\nexport interface LiveRegion {\n  announce(message: string): void\n  clear(): void\n  destroy(): void\n}\n\n/** Create a live region that announces messages to screen readers */\nexport function createLiveRegion(config: LiveRegionConfig = {}): LiveRegion {\n  const { politeness = 'polite', clearAfterMs = 5000 } = config\n  let element: HTMLElement | null = null\n  let clearTimeout: ReturnType<typeof setTimeout> | null = null\n\n  function getElement(): HTMLElement {\n    if (!element && typeof document !== 'undefined') {\n      element = document.createElement('div')\n      element.setAttribute('role', 'status')\n      element.setAttribute('aria-live', politeness)\n      element.setAttribute('aria-atomic', 'true')\n      // Visually hidden but accessible to screen readers\n      Object.assign(element.style, {\n        position: 'absolute',\n        width: '1px',\n        height: '1px',\n        padding: '0',\n        margin: '-1px',\n        overflow: 'hidden',\n        clip: 'rect(0, 0, 0, 0)',\n        whiteSpace: 'nowrap',\n        border: '0',\n      })\n      document.body.appendChild(element)\n    }\n    return element!\n  }\n\n  return {\n    announce(message: string): void {\n      const el = getElement()\n      if (!el) return\n\n      // Clear any pending timeout\n      if (clearTimeout !== null) {\n        globalThis.clearTimeout(clearTimeout)\n      }\n\n      // Set text content — screen readers will detect the change via aria-live\n      el.textContent = message\n\n      if (clearAfterMs > 0) {\n        clearTimeout = globalThis.setTimeout(() => {\n          el.textContent = ''\n          clearTimeout = null\n        }, clearAfterMs)\n      }\n    },\n\n    clear(): void {\n      if (clearTimeout !== null) {\n        globalThis.clearTimeout(clearTimeout)\n        clearTimeout = null\n      }\n      if (element) {\n        element.textContent = ''\n      }\n    },\n\n    destroy(): void {\n      if (clearTimeout !== null) {\n        globalThis.clearTimeout(clearTimeout)\n        clearTimeout = null\n      }\n      if (element && element.parentNode) {\n        element.parentNode.removeChild(element)\n        element = null\n      }\n    },\n  }\n}\n","/**\n * Reduced motion utilities.\n * Respects user preferences for reduced motion.\n */\n\n/** Check if user prefers reduced motion */\nexport function prefersReducedMotion(): boolean {\n  if (typeof window === 'undefined') return false\n  return window.matchMedia('(prefers-reduced-motion: reduce)').matches\n}\n\n/** Get animation duration — returns '0ms' if reduced motion preferred */\nexport function getAnimationDuration(normalDuration: string): string {\n  return prefersReducedMotion() ? '0ms' : normalDuration\n}\n","/**\n * Skip-to-content link utility.\n * Provides a keyboard-accessible link that is visually hidden until focused.\n */\n\n/** Props for a skip-to-content link */\nexport interface SkipLinkProps {\n  /** ID of the target element. Default: 'main-content' */\n  targetId?: string\n  /** Label text for the link. Default: 'Skip to main content' */\n  label?: string\n}\n\n/** Create props for a skip-to-content link */\nexport function createSkipLink(props: SkipLinkProps = {}): {\n  ariaProps: Record<string, string>\n  href: string\n  label: string\n  /** CSS classes — visually hidden until focused */\n  className: string\n} {\n  const targetId = props.targetId ?? 'main-content'\n  const label = props.label ?? 'Skip to main content'\n\n  return {\n    ariaProps: {\n      role: 'link',\n      'aria-label': label,\n    },\n    href: `#${targetId}`,\n    label,\n    className:\n      'sr-only focus:not-sr-only focus:absolute focus:z-50 focus:p-4 focus:bg-white focus:text-black focus:underline',\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@refraction-ui/shared",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {},
+  "devDependencies": {},
+  "sideEffects": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elloloop/refraction-ui.git",
+    "directory": "packages/shared"
+  },
+  "homepage": "https://elloloop.github.io/refraction-ui/",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts",
+    "clean": "rm -rf dist"
+  }
+}