@structyl/utils 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 your-lib contributors
+
+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,155 @@
+# @structyl/utils
+
+> Small, tree-shakeable TypeScript utilities that power the structyl ecosystem.
+
+![npm](https://img.shields.io/npm/v/@structyl/utils)
+![license](https://img.shields.io/npm/l/@structyl/utils)
+
+A focused collection of pure utility functions used across structyl's primitives, styled
+components, and DataTable. No React imports, no side effects, fully tree-shakeable — import
+only what you need. Useful on its own in any TypeScript or JavaScript project, browser or server.
+
+## Installation
+
+```bash
+# pnpm
+pnpm add @structyl/utils
+
+# npm
+npm install @structyl/utils
+
+# yarn
+yarn add @structyl/utils
+```
+
+> `cn` and `mergeProps` build on [`clsx`](https://github.com/lukeed/clsx) and
+> [`tailwind-merge`](https://github.com/dcastil/tailwind-merge), which ship as dependencies.
+
+## Usage
+
+```ts
+import {
+  cn,
+  composeEventHandlers,
+  isString,
+  groupBy,
+  pick,
+  slugify,
+  formatCurrency,
+  getFocusableElements,
+} from '@structyl/utils';
+
+// Merge Tailwind classes — conflicting utilities are resolved.
+cn('px-2 py-1', isActive && 'px-4'); // → 'py-1 px-4'
+
+// Compose event handlers; the second is skipped if the first prevents default.
+const onClick = composeEventHandlers(props.onClick, () => setOpen(true));
+
+// Type guards narrow `unknown` safely.
+if (isString(value)) {
+  value.toUpperCase();
+}
+
+// Array helpers.
+groupBy(users, (u) => u.role); // → { admin: [...], member: [...] }
+
+// Object helpers.
+pick(config, ['id', 'name']);
+
+// String helpers.
+slugify('Hello, World!'); // → 'hello-world'
+
+// Number formatting via Intl.
+formatCurrency(1999.9, 'USD'); // → '$1,999.90'
+
+// DOM helpers (browser only).
+getFocusableElements(containerEl); // → HTMLElement[]
+```
+
+## Features
+
+- **Tree-shakeable** — named exports with `"sideEffects": false`; unused helpers are dropped by your bundler.
+- **No React dependency** — pure functions usable anywhere, including Node and edge runtimes.
+- **Tailwind-aware class merging** — `cn` combines `clsx` + `tailwind-merge` to resolve conflicting utilities.
+- **Type-safe guards** — `is*` helpers act as TypeScript type predicates to narrow `unknown`.
+- **SSR-safe DOM helpers** — `isBrowser`-guarded utilities that won't crash on the server.
+- **Ships ESM + CJS + types** — first-class TypeScript declarations out of the box.
+
+## API
+
+### Class names
+
+| Export | Description |
+| --- | --- |
+| `cn(...inputs)` | Merge class names with `clsx`, then resolve Tailwind conflicts via `tailwind-merge`. |
+
+### Composition
+
+| Export | Description |
+| --- | --- |
+| `composeEventHandlers(original, ours, opts?)` | Chain two event handlers; skips `ours` when `original` calls `preventDefault` (configurable). |
+| `mergeProps(base, override)` | Merge two prop objects, composing event handlers, `className`, and `style`. |
+
+### Type guards
+
+| Export | Description |
+| --- | --- |
+| `isFunction`, `isObject`, `isString`, `isNumber`, `isArray`, `isBoolean`, `isNullish` | Type-predicate guards that narrow `unknown`. |
+| `isEmpty(value)` | `true` for nullish values, empty strings/arrays/objects. |
+| `isBrowser()` | `true` when `window` is defined. |
+
+### Array
+
+| Export | Description |
+| --- | --- |
+| `chunk(array, size)` | Split an array into chunks of size `N`. |
+| `groupBy(array, keyFn)` | Group items into a record keyed by `keyFn`. |
+| `sortBy(array, keyFn)` | Non-mutating sort by a derived key. |
+| `uniqueBy(array, keyFn)` | Dedupe items by a derived key. |
+| `partition(array, predicate)` | Split into `[matching, notMatching]`. |
+| `range(start, end?, step?)` | Generate a numeric range. |
+
+### Object
+
+| Export | Description |
+| --- | --- |
+| `pick(obj, keys)` | Keep only the given keys. |
+| `omit(obj, keys)` | Remove the given keys. |
+| `get(obj, path, default?)` | Read a nested value by dot-path. |
+| `deepEqual(a, b)` | Recursive structural equality check. |
+
+### String
+
+| Export | Description |
+| --- | --- |
+| `capitalize`, `camelCase`, `kebabCase`, `snakeCase` | Case transforms. |
+| `truncate(str, max, suffix?)` | Truncate with a trailing suffix (default `…`). |
+| `slugify(str)` | URL-safe slug (lowercase, accent-stripped). |
+
+### Number
+
+| Export | Description |
+| --- | --- |
+| `clamp(value, min, max)` | Constrain a number to a range. |
+| `roundTo(value, decimals?)` | Round to `N` decimal places. |
+| `lerp(start, end, t)` | Linear interpolation. |
+| `formatNumber`, `formatCurrency`, `formatPercent` | `Intl`-based formatting helpers. |
+
+### DOM
+
+| Export | Description |
+| --- | --- |
+| `getOwnerDocument(node)`, `getOwnerWindow(node)` | Resolve the owning `Document`/`Window`, SSR-safe. |
+| `getActiveElement(doc?)` | The document's active element. |
+| `getFocusableElements(container)` | All visible, focusable descendants. |
+| `FOCUSABLE_SELECTOR` | Selector string for focusable elements. |
+| `contains(parent, child)` | Whether `parent` contains `child`. |
+
+## Part of structyl
+
+This package is part of [structyl](https://github.com/imirfanul/structyl) — see the full
+documentation at [structyl.dev](https://structyl.dev).
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,246 @@
+'use strict';
+
+var clsx = require('clsx');
+var tailwindMerge = require('tailwind-merge');
+
+// src/class-names.ts
+function cn(...inputs) {
+  return tailwindMerge.twMerge(clsx.clsx(inputs));
+}
+
+// src/compose.ts
+function composeEventHandlers(originalEventHandler, ourEventHandler, { checkForDefaultPrevented = true } = {}) {
+  return function handleEvent(event) {
+    originalEventHandler?.(event);
+    if (checkForDefaultPrevented === false || !event.defaultPrevented) {
+      ourEventHandler?.(event);
+    }
+  };
+}
+function mergeProps(base, override) {
+  const merged = { ...base, ...override };
+  for (const key in override) {
+    const baseVal = base[key];
+    const overrideVal = override[key];
+    if (/^on[A-Z]/.test(key) && typeof baseVal === "function" && typeof overrideVal === "function") {
+      merged[key] = (...args) => {
+        overrideVal(...args);
+        baseVal(...args);
+      };
+    } else if (key === "style" && typeof baseVal === "object" && typeof overrideVal === "object") {
+      merged[key] = { ...baseVal, ...overrideVal };
+    } else if (key === "className" && typeof baseVal === "string" && typeof overrideVal === "string") {
+      merged[key] = [baseVal, overrideVal].filter(Boolean).join(" ");
+    }
+  }
+  return merged;
+}
+
+// src/type-guards.ts
+var isFunction = (value) => typeof value === "function";
+var isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isString = (value) => typeof value === "string";
+var isNumber = (value) => typeof value === "number" && !Number.isNaN(value);
+var isArray = (value) => Array.isArray(value);
+var isNullish = (value) => value == null;
+var isBoolean = (value) => typeof value === "boolean";
+var isEmpty = (value) => {
+  if (isNullish(value)) return true;
+  if (isString(value) || isArray(value)) return value.length === 0;
+  if (isObject(value)) return Object.keys(value).length === 0;
+  return false;
+};
+var isBrowser = () => typeof window !== "undefined";
+
+// src/array.ts
+function chunk(array, size) {
+  if (size <= 0) return [];
+  const result = [];
+  for (let i = 0; i < array.length; i += size) {
+    result.push(array.slice(i, i + size));
+  }
+  return result;
+}
+function groupBy(array, keyFn) {
+  return array.reduce(
+    (acc, item) => {
+      const key = keyFn(item);
+      (acc[key] ||= []).push(item);
+      return acc;
+    },
+    {}
+  );
+}
+function sortBy(array, keyFn) {
+  return [...array].sort((a, b) => {
+    const aKey = keyFn(a);
+    const bKey = keyFn(b);
+    if (aKey < bKey) return -1;
+    if (aKey > bKey) return 1;
+    return 0;
+  });
+}
+function uniqueBy(array, keyFn) {
+  const seen = /* @__PURE__ */ new Set();
+  return array.filter((item) => {
+    const key = keyFn(item);
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
+  });
+}
+function partition(array, predicate) {
+  const truthy = [];
+  const falsy = [];
+  for (const item of array) {
+    if (predicate(item)) truthy.push(item);
+    else falsy.push(item);
+  }
+  return [truthy, falsy];
+}
+function range(start, end, step = 1) {
+  if (end === void 0) {
+    end = start;
+    start = 0;
+  }
+  const result = [];
+  if (step > 0) {
+    for (let i = start; i < end; i += step) result.push(i);
+  } else if (step < 0) {
+    for (let i = start; i > end; i += step) result.push(i);
+  }
+  return result;
+}
+
+// src/object.ts
+function pick(obj, keys) {
+  const result = {};
+  for (const key of keys) {
+    if (key in obj) result[key] = obj[key];
+  }
+  return result;
+}
+function omit(obj, keys) {
+  const result = { ...obj };
+  for (const key of keys) {
+    delete result[key];
+  }
+  return result;
+}
+function get(obj, path, defaultValue) {
+  const keys = path.split(".");
+  let result = obj;
+  for (const key of keys) {
+    if (result == null || typeof result !== "object") return defaultValue;
+    result = result[key];
+  }
+  return result ?? defaultValue;
+}
+function deepEqual(a, b) {
+  if (a === b) return true;
+  if (a == null || b == null) return false;
+  if (typeof a !== typeof b) return false;
+  if (typeof a !== "object") return false;
+  if (Array.isArray(a) && Array.isArray(b)) {
+    if (a.length !== b.length) return false;
+    return a.every((item, i) => deepEqual(item, b[i]));
+  }
+  const aKeys = Object.keys(a);
+  const bKeys = Object.keys(b);
+  if (aKeys.length !== bKeys.length) return false;
+  return aKeys.every(
+    (key) => deepEqual(a[key], b[key])
+  );
+}
+
+// src/string.ts
+var capitalize = (str) => str.length === 0 ? str : str.charAt(0).toUpperCase() + str.slice(1);
+var camelCase = (str) => str.replace(/[-_\s]+(.)?/g, (_, char) => char ? char.toUpperCase() : "").replace(/^(.)/, (m) => m.toLowerCase());
+var kebabCase = (str) => str.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
+var snakeCase = (str) => str.replace(/([a-z])([A-Z])/g, "$1_$2").replace(/[\s-]+/g, "_").toLowerCase();
+var truncate = (str, maxLength, suffix = "\u2026") => str.length <= maxLength ? str : str.slice(0, maxLength - suffix.length) + suffix;
+var slugify = (str) => str.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9\s-]/g, "").trim().replace(/\s+/g, "-").replace(/-+/g, "-");
+
+// src/number.ts
+var clamp = (value, min, max) => Math.max(min, Math.min(max, value));
+var roundTo = (value, decimals = 0) => {
+  const factor = 10 ** decimals;
+  return Math.round(value * factor) / factor;
+};
+var lerp = (start, end, t) => start + (end - start) * t;
+var formatNumber = (value, options = {}, locale = "en-US") => new Intl.NumberFormat(locale, options).format(value);
+var formatCurrency = (value, currency = "USD", locale = "en-US") => formatNumber(value, { style: "currency", currency }, locale);
+var formatPercent = (value, decimals = 0, locale = "en-US") => formatNumber(
+  value,
+  { style: "percent", minimumFractionDigits: decimals, maximumFractionDigits: decimals },
+  locale
+);
+
+// src/dom.ts
+var getOwnerDocument = (node) => node?.ownerDocument ?? (isBrowser() ? document : {});
+var getOwnerWindow = (node) => getOwnerDocument(node).defaultView ?? (isBrowser() ? window : {});
+var getActiveElement = (doc = document) => doc.activeElement;
+var FOCUSABLE_SELECTOR = [
+  "a[href]",
+  "button:not([disabled])",
+  'input:not([disabled]):not([type="hidden"])',
+  "select:not([disabled])",
+  "textarea:not([disabled])",
+  '[tabindex]:not([tabindex="-1"])',
+  "audio[controls]",
+  "video[controls]",
+  '[contenteditable]:not([contenteditable="false"])'
+].join(",");
+var getFocusableElements = (container) => {
+  if (!container) return [];
+  return Array.from(container.querySelectorAll(FOCUSABLE_SELECTOR)).filter(
+    (el) => !el.hasAttribute("disabled") && el.offsetParent !== null
+  );
+};
+var contains = (parent, child) => {
+  if (!parent || !child) return false;
+  return parent.contains(child);
+};
+
+exports.FOCUSABLE_SELECTOR = FOCUSABLE_SELECTOR;
+exports.camelCase = camelCase;
+exports.capitalize = capitalize;
+exports.chunk = chunk;
+exports.clamp = clamp;
+exports.cn = cn;
+exports.composeEventHandlers = composeEventHandlers;
+exports.contains = contains;
+exports.deepEqual = deepEqual;
+exports.formatCurrency = formatCurrency;
+exports.formatNumber = formatNumber;
+exports.formatPercent = formatPercent;
+exports.get = get;
+exports.getActiveElement = getActiveElement;
+exports.getFocusableElements = getFocusableElements;
+exports.getOwnerDocument = getOwnerDocument;
+exports.getOwnerWindow = getOwnerWindow;
+exports.groupBy = groupBy;
+exports.isArray = isArray;
+exports.isBoolean = isBoolean;
+exports.isBrowser = isBrowser;
+exports.isEmpty = isEmpty;
+exports.isFunction = isFunction;
+exports.isNullish = isNullish;
+exports.isNumber = isNumber;
+exports.isObject = isObject;
+exports.isString = isString;
+exports.kebabCase = kebabCase;
+exports.lerp = lerp;
+exports.mergeProps = mergeProps;
+exports.omit = omit;
+exports.partition = partition;
+exports.pick = pick;
+exports.range = range;
+exports.roundTo = roundTo;
+exports.slugify = slugify;
+exports.snakeCase = snakeCase;
+exports.sortBy = sortBy;
+exports.truncate = truncate;
+exports.uniqueBy = uniqueBy;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/class-names.ts","../src/compose.ts","../src/type-guards.ts","../src/array.ts","../src/object.ts","../src/string.ts","../src/number.ts","../src/dom.ts"],"names":["twMerge","clsx"],"mappings":";;;;;;AASO,SAAS,MAAM,MAAA,EAA8B;AAClD,EAAA,OAAOA,qBAAA,CAAQC,SAAA,CAAK,MAAM,CAAC,CAAA;AAC7B;;;ACNO,SAAS,oBAAA,CACd,sBACA,eAAA,EACA,EAAE,2BAA2B,IAAA,EAAK,GAAI,EAAC,EACnB;AACpB,EAAA,OAAO,SAAS,YAAY,KAAA,EAAU;AACpC,IAAA,oBAAA,GAAuB,KAAK,CAAA;AAE5B,IAAA,IACE,wBAAA,KAA6B,KAAA,IAC7B,CAAE,KAAA,CAAmD,gBAAA,EACrD;AACA,MAAA,eAAA,GAAkB,KAAK,CAAA;AAAA,IACzB;AAAA,EACF,CAAA;AACF;AAQO,SAAS,UAAA,CACd,MACA,QAAA,EACO;AACP,EAAA,MAAM,MAAA,GAAmB,EAAE,GAAG,IAAA,EAAM,GAAG,QAAA,EAAS;AAEhD,EAAA,KAAA,MAAW,OAAO,QAAA,EAAU;AAC1B,IAAA,MAAM,OAAA,GAAU,KAAK,GAAG,CAAA;AACxB,IAAA,MAAM,WAAA,GAAc,SAAS,GAAG,CAAA;AAGhC,IAAA,IAAI,UAAA,CAAW,KAAK,GAAG,CAAA,IAAK,OAAO,OAAA,KAAY,UAAA,IAAc,OAAO,WAAA,KAAgB,UAAA,EAAY;AAC9F,MAAA,MAAA,CAAO,GAAG,CAAA,GAAI,CAAA,GAAI,IAAA,KAAoB;AACpC,QAAC,WAAA,CAA6C,GAAG,IAAI,CAAA;AACrD,QAAC,OAAA,CAAyC,GAAG,IAAI,CAAA;AAAA,MACnD,CAAA;AAAA,IACF,CAAA,MAAA,IAES,QAAQ,OAAA,IAAW,OAAO,YAAY,QAAA,IAAY,OAAO,gBAAgB,QAAA,EAAU;AAC1F,MAAA,MAAA,CAAO,GAAG,CAAA,GAAI,EAAE,GAAI,OAAA,EAAoB,GAAI,WAAA,EAAuB;AAAA,IACrE,CAAA,MAAA,IAES,QAAQ,WAAA,IAAe,OAAO,YAAY,QAAA,IAAY,OAAO,gBAAgB,QAAA,EAAU;AAC9F,MAAA,MAAA,CAAO,GAAG,CAAA,GAAI,CAAC,OAAA,EAAS,WAAW,EAAE,MAAA,CAAO,OAAO,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AAAA,IAC/D;AAAA,EACF;AAEA,EAAA,OAAO,MAAA;AACT;;;ACxDO,IAAM,UAAA,GAAa,CAAC,KAAA,KACzB,OAAO,KAAA,KAAU;AAEZ,IAAM,QAAA,GAAW,CAAC,KAAA,KACvB,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA,IAAQ,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK;AAE9D,IAAM,QAAA,GAAW,CAAC,KAAA,KAAoC,OAAO,KAAA,KAAU;AAEvE,IAAM,QAAA,GAAW,CAAC,KAAA,KACvB,OAAO,UAAU,QAAA,IAAY,CAAC,MAAA,CAAO,KAAA,CAAM,KAAK;AAE3C,IAAM,OAAA,GAAU,CAAc,KAAA,KAAiC,KAAA,CAAM,QAAQ,KAAK;AAElF,IAAM,SAAA,GAAY,CAAC,KAAA,KAA8C,KAAA,IAAS;AAE1E,IAAM,SAAA,GAAY,CAAC,KAAA,KAAqC,OAAO,KAAA,KAAU;AAEzE,IAAM,OAAA,GAAU,CAAC,KAAA,KAA4B;AAClD,EAAA,IAAI,SAAA,CAAU,KAAK,CAAA,EAAG,OAAO,IAAA;AAC7B,EAAA,IAAI,QAAA,CAAS,KAAK,CAAA,IAAK,OAAA,CAAQ,KAAK,CAAA,EAAG,OAAO,MAAM,MAAA,KAAW,CAAA;AAC/D,EAAA,IAAI,QAAA,CAAS,KAAK,CAAA,EAAG,OAAO,OAAO,IAAA,CAAK,KAAK,EAAE,MAAA,KAAW,CAAA;AAC1D,EAAA,OAAO,KAAA;AACT;AAEO,IAAM,SAAA,GAAY,MAAe,OAAO,MAAA,KAAW;;;ACvBnD,SAAS,KAAA,CAAS,OAAY,IAAA,EAAqB;AACxD,EAAA,IAAI,IAAA,IAAQ,CAAA,EAAG,OAAO,EAAC;AACvB,EAAA,MAAM,SAAgB,EAAC;AACvB,EAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,MAAA,EAAQ,KAAK,IAAA,EAAM;AAC3C,IAAA,MAAA,CAAO,KAAK,KAAA,CAAM,KAAA,CAAM,CAAA,EAAG,CAAA,GAAI,IAAI,CAAC,CAAA;AAAA,EACtC;AACA,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,OAAA,CACd,OACA,KAAA,EACgB;AAChB,EAAA,OAAO,KAAA,CAAM,MAAA;AAAA,IACX,CAAC,KAAK,IAAA,KAAS;AACb,MAAA,MAAM,GAAA,GAAM,MAAM,IAAI,CAAA;AACtB,MAAA,CAAC,IAAI,GAAG,CAAA,KAAM,EAAC,EAAG,KAAK,IAAI,CAAA;AAC3B,MAAA,OAAO,GAAA;AAAA,IACT,CAAA;AAAA,IACA;AAAC,GACH;AACF;AAGO,SAAS,MAAA,CAAU,OAAY,KAAA,EAA0C;AAC9E,EAAA,OAAO,CAAC,GAAG,KAAK,EAAE,IAAA,CAAK,CAAC,GAAG,CAAA,KAAM;AAC/B,IAAA,MAAM,IAAA,GAAO,MAAM,CAAC,CAAA;AACpB,IAAA,MAAM,IAAA,GAAO,MAAM,CAAC,CAAA;AACpB,IAAA,IAAI,IAAA,GAAO,MAAM,OAAO,EAAA;AACxB,IAAA,IAAI,IAAA,GAAO,MAAM,OAAO,CAAA;AACxB,IAAA,OAAO,CAAA;AAAA,EACT,CAAC,CAAA;AACH;AAGO,SAAS,QAAA,CAAY,OAAY,KAAA,EAAkC;AACxE,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAI;AACrB,EAAA,OAAO,KAAA,CAAM,MAAA,CAAO,CAAC,IAAA,KAAS;AAC5B,IAAA,MAAM,GAAA,GAAM,MAAM,IAAI,CAAA;AACtB,IAAA,IAAI,IAAA,CAAK,GAAA,CAAI,GAAG,CAAA,EAAG,OAAO,KAAA;AAC1B,IAAA,IAAA,CAAK,IAAI,GAAG,CAAA;AACZ,IAAA,OAAO,IAAA;AAAA,EACT,CAAC,CAAA;AACH;AAGO,SAAS,SAAA,CAAa,OAAY,SAAA,EAA6C;AACpF,EAAA,MAAM,SAAc,EAAC;AACrB,EAAA,MAAM,QAAa,EAAC;AACpB,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,IAAA,IAAI,SAAA,CAAU,IAAI,CAAA,EAAG,MAAA,CAAO,KAAK,IAAI,CAAA;AAAA,SAChC,KAAA,CAAM,KAAK,IAAI,CAAA;AAAA,EACtB;AACA,EAAA,OAAO,CAAC,QAAQ,KAAK,CAAA;AACvB;AAGO,SAAS,KAAA,CAAM,KAAA,EAAe,GAAA,EAAc,IAAA,GAAO,CAAA,EAAa;AACrE,EAAA,IAAI,QAAQ,MAAA,EAAW;AACrB,IAAA,GAAA,GAAM,KAAA;AACN,IAAA,KAAA,GAAQ,CAAA;AAAA,EACV;AACA,EAAA,MAAM,SAAmB,EAAC;AAC1B,EAAA,IAAI,OAAO,CAAA,EAAG;AACZ,IAAA,KAAA,IAAS,CAAA,GAAI,OAAO,CAAA,GAAI,GAAA,EAAK,KAAK,IAAA,EAAM,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EACvD,CAAA,MAAA,IAAW,OAAO,CAAA,EAAG;AACnB,IAAA,KAAA,IAAS,CAAA,GAAI,OAAO,CAAA,GAAI,GAAA,EAAK,KAAK,IAAA,EAAM,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EACvD;AACA,EAAA,OAAO,MAAA;AACT;;;ACtEO,SAAS,IAAA,CAA0C,KAAQ,IAAA,EAAuB;AACvF,EAAA,MAAM,SAAS,EAAC;AAChB,EAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,IAAA,IAAI,OAAO,GAAA,EAAK,MAAA,CAAO,GAAG,CAAA,GAAI,IAAI,GAAG,CAAA;AAAA,EACvC;AACA,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,IAAA,CAA0C,KAAQ,IAAA,EAAuB;AACvF,EAAA,MAAM,MAAA,GAAS,EAAE,GAAG,GAAA,EAAI;AACxB,EAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,IAAA,OAAO,OAAO,GAAG,CAAA;AAAA,EACnB;AACA,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,GAAA,CAAiB,GAAA,EAAc,IAAA,EAAc,YAAA,EAAiC;AAC5F,EAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,GAAG,CAAA;AAC3B,EAAA,IAAI,MAAA,GAAkB,GAAA;AACtB,EAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,IAAA,IAAI,MAAA,IAAU,IAAA,IAAQ,OAAO,MAAA,KAAW,UAAU,OAAO,YAAA;AACzD,IAAA,MAAA,GAAU,OAAmC,GAAG,CAAA;AAAA,EAClD;AACA,EAAA,OAAQ,MAAA,IAAU,YAAA;AACpB;AAGO,SAAS,SAAA,CAAU,GAAY,CAAA,EAAqB;AACzD,EAAA,IAAI,CAAA,KAAM,GAAG,OAAO,IAAA;AACpB,EAAA,IAAI,CAAA,IAAK,IAAA,IAAQ,CAAA,IAAK,IAAA,EAAM,OAAO,KAAA;AACnC,EAAA,IAAI,OAAO,CAAA,KAAM,OAAO,CAAA,EAAG,OAAO,KAAA;AAClC,EAAA,IAAI,OAAO,CAAA,KAAM,QAAA,EAAU,OAAO,KAAA;AAElC,EAAA,IAAI,MAAM,OAAA,CAAQ,CAAC,KAAK,KAAA,CAAM,OAAA,CAAQ,CAAC,CAAA,EAAG;AACxC,IAAA,IAAI,CAAA,CAAE,MAAA,KAAW,CAAA,CAAE,MAAA,EAAQ,OAAO,KAAA;AAClC,IAAA,OAAO,CAAA,CAAE,KAAA,CAAM,CAAC,IAAA,EAAM,CAAA,KAAM,UAAU,IAAA,EAAM,CAAA,CAAE,CAAC,CAAC,CAAC,CAAA;AAAA,EACnD;AAEA,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,CAAK,CAAW,CAAA;AACrC,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,CAAK,CAAW,CAAA;AACrC,EAAA,IAAI,KAAA,CAAM,MAAA,KAAW,KAAA,CAAM,MAAA,EAAQ,OAAO,KAAA;AAC1C,EAAA,OAAO,KAAA,CAAM,KAAA;AAAA,IAAM,CAAC,QAClB,SAAA,CAAW,CAAA,CAA8B,GAAG,CAAA,EAAI,CAAA,CAA8B,GAAG,CAAC;AAAA,GACpF;AACF;;;AC/CO,IAAM,UAAA,GAAa,CAAC,GAAA,KACzB,GAAA,CAAI,WAAW,CAAA,GAAI,GAAA,GAAM,GAAA,CAAI,MAAA,CAAO,CAAC,CAAA,CAAE,WAAA,EAAY,GAAI,GAAA,CAAI,MAAM,CAAC;AAE7D,IAAM,SAAA,GAAY,CAAC,GAAA,KACxB,GAAA,CACG,QAAQ,cAAA,EAAgB,CAAC,GAAG,IAAA,KAAU,IAAA,GAAO,KAAK,WAAA,EAAY,GAAI,EAAG,CAAA,CACrE,OAAA,CAAQ,QAAQ,CAAC,CAAA,KAAM,CAAA,CAAE,WAAA,EAAa;AAEpC,IAAM,SAAA,GAAY,CAAC,GAAA,KACxB,GAAA,CACG,OAAA,CAAQ,iBAAA,EAAmB,OAAO,CAAA,CAClC,OAAA,CAAQ,SAAA,EAAW,GAAG,CAAA,CACtB,WAAA;AAEE,IAAM,SAAA,GAAY,CAAC,GAAA,KACxB,GAAA,CACG,OAAA,CAAQ,iBAAA,EAAmB,OAAO,CAAA,CAClC,OAAA,CAAQ,SAAA,EAAW,GAAG,CAAA,CACtB,WAAA;AAEE,IAAM,WAAW,CAAC,GAAA,EAAa,SAAA,EAAmB,MAAA,GAAS,aAChE,GAAA,CAAI,MAAA,IAAU,SAAA,GAAY,GAAA,GAAM,IAAI,KAAA,CAAM,CAAA,EAAG,SAAA,GAAY,MAAA,CAAO,MAAM,CAAA,GAAI;AAErE,IAAM,OAAA,GAAU,CAAC,GAAA,KACtB,GAAA,CACG,WAAA,GACA,SAAA,CAAU,KAAK,CAAA,CACf,OAAA,CAAQ,kBAAA,EAAoB,EAAE,EAC9B,OAAA,CAAQ,eAAA,EAAiB,EAAE,CAAA,CAC3B,IAAA,EAAK,CACL,OAAA,CAAQ,MAAA,EAAQ,GAAG,CAAA,CACnB,OAAA,CAAQ,KAAA,EAAO,GAAG;;;AC9BhB,IAAM,KAAA,GAAQ,CAAC,KAAA,EAAe,GAAA,EAAa,GAAA,KAChD,IAAA,CAAK,GAAA,CAAI,GAAA,EAAK,IAAA,CAAK,GAAA,CAAI,GAAA,EAAK,KAAK,CAAC;AAG7B,IAAM,OAAA,GAAU,CAAC,KAAA,EAAe,QAAA,GAAW,CAAA,KAAc;AAC9D,EAAA,MAAM,SAAS,EAAA,IAAM,QAAA;AACrB,EAAA,OAAO,IAAA,CAAK,KAAA,CAAM,KAAA,GAAQ,MAAM,CAAA,GAAI,MAAA;AACtC;AAGO,IAAM,OAAO,CAAC,KAAA,EAAe,KAAa,CAAA,KAAsB,KAAA,GAAA,CAAS,MAAM,KAAA,IAAS;AAGxF,IAAM,YAAA,GAAe,CAC1B,KAAA,EACA,OAAA,GAAoC,EAAC,EACrC,MAAA,GAAS,OAAA,KACE,IAAI,KAAK,YAAA,CAAa,MAAA,EAAQ,OAAO,CAAA,CAAE,OAAO,KAAK;AAEzD,IAAM,cAAA,GAAiB,CAC5B,KAAA,EACA,QAAA,GAAW,OACX,MAAA,GAAS,OAAA,KACE,YAAA,CAAa,KAAA,EAAO,EAAE,KAAA,EAAO,UAAA,EAAY,QAAA,IAAY,MAAM;AAEjE,IAAM,gBAAgB,CAC3B,KAAA,EACA,QAAA,GAAW,CAAA,EACX,SAAS,OAAA,KAET,YAAA;AAAA,EACE,KAAA;AAAA,EACA,EAAE,KAAA,EAAO,SAAA,EAAW,qBAAA,EAAuB,QAAA,EAAU,uBAAuB,QAAA,EAAS;AAAA,EACrF;AACF;;;ACjCK,IAAM,gBAAA,GAAmB,CAAC,IAAA,KAC/B,IAAA,EAAM,kBAAkB,SAAA,EAAU,GAAI,WAAY,EAAC;AAE9C,IAAM,cAAA,GAAiB,CAAC,IAAA,KAC5B,gBAAA,CAAiB,IAAI,EAAE,WAAA,KAAgB,SAAA,EAAU,GAAI,MAAA,GAAU,EAAC;AAE5D,IAAM,gBAAA,GAAmB,CAAC,GAAA,GAAgB,QAAA,KAA6B,GAAA,CAAI;AAG3E,IAAM,kBAAA,GAAqB;AAAA,EAChC,SAAA;AAAA,EACA,wBAAA;AAAA,EACA,4CAAA;AAAA,EACA,wBAAA;AAAA,EACA,0BAAA;AAAA,EACA,iCAAA;AAAA,EACA,iBAAA;AAAA,EACA,iBAAA;AAAA,EACA;AACF,CAAA,CAAE,KAAK,GAAG;AAEH,IAAM,oBAAA,GAAuB,CAAC,SAAA,KAAiD;AACpF,EAAA,IAAI,CAAC,SAAA,EAAW,OAAO,EAAC;AACxB,EAAA,OAAO,MAAM,IAAA,CAAK,SAAA,CAAU,gBAAA,CAA8B,kBAAkB,CAAC,CAAA,CAAE,MAAA;AAAA,IAC7E,CAAC,OAAO,CAAC,EAAA,CAAG,aAAa,UAAU,CAAA,IAAK,GAAG,YAAA,KAAiB;AAAA,GAC9D;AACF;AAEO,IAAM,QAAA,GAAW,CAAC,MAAA,EAAqB,KAAA,KAAgC;AAC5E,EAAA,IAAI,CAAC,MAAA,IAAU,CAAC,KAAA,EAAO,OAAO,KAAA;AAC9B,EAAA,OAAO,MAAA,CAAO,SAAS,KAAK,CAAA;AAC9B","file":"index.cjs","sourcesContent":["import { clsx, type ClassValue } from 'clsx';\nimport { twMerge } from 'tailwind-merge';\n\n/**\n * Merge Tailwind class names intelligently — conflicting utilities are resolved.\n *\n * @example\n * cn('px-2 py-1', condition && 'px-4') // → 'py-1 px-4'\n */\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs));\n}\n","/**\n * Compose two event handlers into one. The handlers are called in order.\n * If the original handler calls `event.preventDefault()`, the next one is skipped\n * unless `checkForDefaultPrevented` is `false`.\n */\nexport function composeEventHandlers<E>(\n  originalEventHandler?: (event: E) => void,\n  ourEventHandler?: (event: E) => void,\n  { checkForDefaultPrevented = true } = {},\n): (event: E) => void {\n  return function handleEvent(event: E) {\n    originalEventHandler?.(event);\n\n    if (\n      checkForDefaultPrevented === false ||\n      !(event as unknown as { defaultPrevented: boolean }).defaultPrevented\n    ) {\n      ourEventHandler?.(event);\n    }\n  };\n}\n\n/**\n * Merge two sets of React props, with the second set taking precedence\n * except for event handlers and `className`/`style`, which are composed.\n */\ntype AnyProps = Record<string, unknown>;\n\nexport function mergeProps<T extends AnyProps, U extends AnyProps>(\n  base: T,\n  override: U,\n): T & U {\n  const merged: AnyProps = { ...base, ...override };\n\n  for (const key in override) {\n    const baseVal = base[key];\n    const overrideVal = override[key];\n\n    // Compose event handlers (onClick, onKeyDown, etc.)\n    if (/^on[A-Z]/.test(key) && typeof baseVal === 'function' && typeof overrideVal === 'function') {\n      merged[key] = (...args: unknown[]) => {\n        (overrideVal as (...args: unknown[]) => void)(...args);\n        (baseVal as (...args: unknown[]) => void)(...args);\n      };\n    }\n    // Merge styles\n    else if (key === 'style' && typeof baseVal === 'object' && typeof overrideVal === 'object') {\n      merged[key] = { ...(baseVal as object), ...(overrideVal as object) };\n    }\n    // Merge classNames\n    else if (key === 'className' && typeof baseVal === 'string' && typeof overrideVal === 'string') {\n      merged[key] = [baseVal, overrideVal].filter(Boolean).join(' ');\n    }\n  }\n\n  return merged as T & U;\n}\n","export const isFunction = (value: unknown): value is (...args: unknown[]) => unknown =>\n  typeof value === 'function';\n\nexport const isObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nexport const isString = (value: unknown): value is string => typeof value === 'string';\n\nexport const isNumber = (value: unknown): value is number =>\n  typeof value === 'number' && !Number.isNaN(value);\n\nexport const isArray = <T = unknown>(value: unknown): value is T[] => Array.isArray(value);\n\nexport const isNullish = (value: unknown): value is null | undefined => value == null;\n\nexport const isBoolean = (value: unknown): value is boolean => typeof value === 'boolean';\n\nexport const isEmpty = (value: unknown): boolean => {\n  if (isNullish(value)) return true;\n  if (isString(value) || isArray(value)) return value.length === 0;\n  if (isObject(value)) return Object.keys(value).length === 0;\n  return false;\n};\n\nexport const isBrowser = (): boolean => typeof window !== 'undefined';\n","/** Split an array into chunks of size N. */\nexport function chunk<T>(array: T[], size: number): T[][] {\n  if (size <= 0) return [];\n  const result: T[][] = [];\n  for (let i = 0; i < array.length; i += size) {\n    result.push(array.slice(i, i + size));\n  }\n  return result;\n}\n\n/** Group array items by a key function. */\nexport function groupBy<T, K extends string | number>(\n  array: T[],\n  keyFn: (item: T) => K,\n): Record<K, T[]> {\n  return array.reduce(\n    (acc, item) => {\n      const key = keyFn(item);\n      (acc[key] ||= []).push(item);\n      return acc;\n    },\n    {} as Record<K, T[]>,\n  );\n}\n\n/** Sort array by a key function (non-mutating). */\nexport function sortBy<T>(array: T[], keyFn: (item: T) => number | string): T[] {\n  return [...array].sort((a, b) => {\n    const aKey = keyFn(a);\n    const bKey = keyFn(b);\n    if (aKey < bKey) return -1;\n    if (aKey > bKey) return 1;\n    return 0;\n  });\n}\n\n/** Get unique items by a key function. */\nexport function uniqueBy<T>(array: T[], keyFn: (item: T) => unknown): T[] {\n  const seen = new Set();\n  return array.filter((item) => {\n    const key = keyFn(item);\n    if (seen.has(key)) return false;\n    seen.add(key);\n    return true;\n  });\n}\n\n/** Partition array into [matching, notMatching]. */\nexport function partition<T>(array: T[], predicate: (item: T) => boolean): [T[], T[]] {\n  const truthy: T[] = [];\n  const falsy: T[] = [];\n  for (const item of array) {\n    if (predicate(item)) truthy.push(item);\n    else falsy.push(item);\n  }\n  return [truthy, falsy];\n}\n\n/** Generate a numeric range. */\nexport function range(start: number, end?: number, step = 1): number[] {\n  if (end === undefined) {\n    end = start;\n    start = 0;\n  }\n  const result: number[] = [];\n  if (step > 0) {\n    for (let i = start; i < end; i += step) result.push(i);\n  } else if (step < 0) {\n    for (let i = start; i > end; i += step) result.push(i);\n  }\n  return result;\n}\n","/** Pick specified keys from an object. */\nexport function pick<T extends object, K extends keyof T>(obj: T, keys: K[]): Pick<T, K> {\n  const result = {} as Pick<T, K>;\n  for (const key of keys) {\n    if (key in obj) result[key] = obj[key];\n  }\n  return result;\n}\n\n/** Omit specified keys from an object. */\nexport function omit<T extends object, K extends keyof T>(obj: T, keys: K[]): Omit<T, K> {\n  const result = { ...obj };\n  for (const key of keys) {\n    delete result[key];\n  }\n  return result;\n}\n\n/** Get a nested value by dot-path. */\nexport function get<T = unknown>(obj: unknown, path: string, defaultValue?: T): T | undefined {\n  const keys = path.split('.');\n  let result: unknown = obj;\n  for (const key of keys) {\n    if (result == null || typeof result !== 'object') return defaultValue;\n    result = (result as Record<string, unknown>)[key];\n  }\n  return (result ?? defaultValue) as T | undefined;\n}\n\n/** Deep equality check. */\nexport function deepEqual(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n  if (a == null || b == null) return false;\n  if (typeof a !== typeof b) return false;\n  if (typeof a !== 'object') return false;\n\n  if (Array.isArray(a) && Array.isArray(b)) {\n    if (a.length !== b.length) return false;\n    return a.every((item, i) => deepEqual(item, b[i]));\n  }\n\n  const aKeys = Object.keys(a as object);\n  const bKeys = Object.keys(b as object);\n  if (aKeys.length !== bKeys.length) return false;\n  return aKeys.every((key) =>\n    deepEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key]),\n  );\n}\n","export const capitalize = (str: string): string =>\n  str.length === 0 ? str : str.charAt(0).toUpperCase() + str.slice(1);\n\nexport const camelCase = (str: string): string =>\n  str\n    .replace(/[-_\\s]+(.)?/g, (_, char) => (char ? char.toUpperCase() : ''))\n    .replace(/^(.)/, (m) => m.toLowerCase());\n\nexport const kebabCase = (str: string): string =>\n  str\n    .replace(/([a-z])([A-Z])/g, '$1-$2')\n    .replace(/[\\s_]+/g, '-')\n    .toLowerCase();\n\nexport const snakeCase = (str: string): string =>\n  str\n    .replace(/([a-z])([A-Z])/g, '$1_$2')\n    .replace(/[\\s-]+/g, '_')\n    .toLowerCase();\n\nexport const truncate = (str: string, maxLength: number, suffix = '…'): string =>\n  str.length <= maxLength ? str : str.slice(0, maxLength - suffix.length) + suffix;\n\nexport const slugify = (str: string): string =>\n  str\n    .toLowerCase()\n    .normalize('NFD')\n    .replace(/[\\u0300-\\u036f]/g, '')\n    .replace(/[^a-z0-9\\s-]/g, '')\n    .trim()\n    .replace(/\\s+/g, '-')\n    .replace(/-+/g, '-');\n","/** Clamp a number between min and max. */\nexport const clamp = (value: number, min: number, max: number): number =>\n  Math.max(min, Math.min(max, value));\n\n/** Round to N decimal places. */\nexport const roundTo = (value: number, decimals = 0): number => {\n  const factor = 10 ** decimals;\n  return Math.round(value * factor) / factor;\n};\n\n/** Linear interpolation between two values. */\nexport const lerp = (start: number, end: number, t: number): number => start + (end - start) * t;\n\n/** Format a number using Intl. */\nexport const formatNumber = (\n  value: number,\n  options: Intl.NumberFormatOptions = {},\n  locale = 'en-US',\n): string => new Intl.NumberFormat(locale, options).format(value);\n\nexport const formatCurrency = (\n  value: number,\n  currency = 'USD',\n  locale = 'en-US',\n): string => formatNumber(value, { style: 'currency', currency }, locale);\n\nexport const formatPercent = (\n  value: number,\n  decimals = 0,\n  locale = 'en-US',\n): string =>\n  formatNumber(\n    value,\n    { style: 'percent', minimumFractionDigits: decimals, maximumFractionDigits: decimals },\n    locale,\n  );\n","import { isBrowser } from './type-guards';\n\nexport const getOwnerDocument = (node: Node | null | undefined): Document =>\n  node?.ownerDocument ?? (isBrowser() ? document : ({} as Document));\n\nexport const getOwnerWindow = (node: Node | null | undefined): Window =>\n  (getOwnerDocument(node).defaultView ?? (isBrowser() ? window : ({} as Window))) as Window;\n\nexport const getActiveElement = (doc: Document = document): Element | null => doc.activeElement;\n\n/** A list of all focusable element selectors. */\nexport const FOCUSABLE_SELECTOR = [\n  'a[href]',\n  'button:not([disabled])',\n  'input:not([disabled]):not([type=\"hidden\"])',\n  'select:not([disabled])',\n  'textarea:not([disabled])',\n  '[tabindex]:not([tabindex=\"-1\"])',\n  'audio[controls]',\n  'video[controls]',\n  '[contenteditable]:not([contenteditable=\"false\"])',\n].join(',');\n\nexport const getFocusableElements = (container: HTMLElement | null): HTMLElement[] => {\n  if (!container) return [];\n  return Array.from(container.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)).filter(\n    (el) => !el.hasAttribute('disabled') && el.offsetParent !== null,\n  );\n};\n\nexport const contains = (parent: Node | null, child: Node | null): boolean => {\n  if (!parent || !child) return false;\n  return parent.contains(child);\n};\n"]}

package/dist/index.d.cts

@@ -0,0 +1,84 @@
+import { ClassValue } from 'clsx';
+
+/**
+ * Merge Tailwind class names intelligently — conflicting utilities are resolved.
+ *
+ * @example
+ * cn('px-2 py-1', condition && 'px-4') // → 'py-1 px-4'
+ */
+declare function cn(...inputs: ClassValue[]): string;
+
+/**
+ * Compose two event handlers into one. The handlers are called in order.
+ * If the original handler calls `event.preventDefault()`, the next one is skipped
+ * unless `checkForDefaultPrevented` is `false`.
+ */
+declare function composeEventHandlers<E>(originalEventHandler?: (event: E) => void, ourEventHandler?: (event: E) => void, { checkForDefaultPrevented }?: {
+    checkForDefaultPrevented?: boolean | undefined;
+}): (event: E) => void;
+/**
+ * Merge two sets of React props, with the second set taking precedence
+ * except for event handlers and `className`/`style`, which are composed.
+ */
+type AnyProps = Record<string, unknown>;
+declare function mergeProps<T extends AnyProps, U extends AnyProps>(base: T, override: U): T & U;
+
+declare const isFunction: (value: unknown) => value is (...args: unknown[]) => unknown;
+declare const isObject: (value: unknown) => value is Record<string, unknown>;
+declare const isString: (value: unknown) => value is string;
+declare const isNumber: (value: unknown) => value is number;
+declare const isArray: <T = unknown>(value: unknown) => value is T[];
+declare const isNullish: (value: unknown) => value is null | undefined;
+declare const isBoolean: (value: unknown) => value is boolean;
+declare const isEmpty: (value: unknown) => boolean;
+declare const isBrowser: () => boolean;
+
+/** Split an array into chunks of size N. */
+declare function chunk<T>(array: T[], size: number): T[][];
+/** Group array items by a key function. */
+declare function groupBy<T, K extends string | number>(array: T[], keyFn: (item: T) => K): Record<K, T[]>;
+/** Sort array by a key function (non-mutating). */
+declare function sortBy<T>(array: T[], keyFn: (item: T) => number | string): T[];
+/** Get unique items by a key function. */
+declare function uniqueBy<T>(array: T[], keyFn: (item: T) => unknown): T[];
+/** Partition array into [matching, notMatching]. */
+declare function partition<T>(array: T[], predicate: (item: T) => boolean): [T[], T[]];
+/** Generate a numeric range. */
+declare function range(start: number, end?: number, step?: number): number[];
+
+/** Pick specified keys from an object. */
+declare function pick<T extends object, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+/** Omit specified keys from an object. */
+declare function omit<T extends object, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
+/** Get a nested value by dot-path. */
+declare function get<T = unknown>(obj: unknown, path: string, defaultValue?: T): T | undefined;
+/** Deep equality check. */
+declare function deepEqual(a: unknown, b: unknown): boolean;
+
+declare const capitalize: (str: string) => string;
+declare const camelCase: (str: string) => string;
+declare const kebabCase: (str: string) => string;
+declare const snakeCase: (str: string) => string;
+declare const truncate: (str: string, maxLength: number, suffix?: string) => string;
+declare const slugify: (str: string) => string;
+
+/** Clamp a number between min and max. */
+declare const clamp: (value: number, min: number, max: number) => number;
+/** Round to N decimal places. */
+declare const roundTo: (value: number, decimals?: number) => number;
+/** Linear interpolation between two values. */
+declare const lerp: (start: number, end: number, t: number) => number;
+/** Format a number using Intl. */
+declare const formatNumber: (value: number, options?: Intl.NumberFormatOptions, locale?: string) => string;
+declare const formatCurrency: (value: number, currency?: string, locale?: string) => string;
+declare const formatPercent: (value: number, decimals?: number, locale?: string) => string;
+
+declare const getOwnerDocument: (node: Node | null | undefined) => Document;
+declare const getOwnerWindow: (node: Node | null | undefined) => Window;
+declare const getActiveElement: (doc?: Document) => Element | null;
+/** A list of all focusable element selectors. */
+declare const FOCUSABLE_SELECTOR: string;
+declare const getFocusableElements: (container: HTMLElement | null) => HTMLElement[];
+declare const contains: (parent: Node | null, child: Node | null) => boolean;
+
+export { FOCUSABLE_SELECTOR, camelCase, capitalize, chunk, clamp, cn, composeEventHandlers, contains, deepEqual, formatCurrency, formatNumber, formatPercent, get, getActiveElement, getFocusableElements, getOwnerDocument, getOwnerWindow, groupBy, isArray, isBoolean, isBrowser, isEmpty, isFunction, isNullish, isNumber, isObject, isString, kebabCase, lerp, mergeProps, omit, partition, pick, range, roundTo, slugify, snakeCase, sortBy, truncate, uniqueBy };

package/dist/index.d.ts

@@ -0,0 +1,84 @@
+import { ClassValue } from 'clsx';
+
+/**
+ * Merge Tailwind class names intelligently — conflicting utilities are resolved.
+ *
+ * @example
+ * cn('px-2 py-1', condition && 'px-4') // → 'py-1 px-4'
+ */
+declare function cn(...inputs: ClassValue[]): string;
+
+/**
+ * Compose two event handlers into one. The handlers are called in order.
+ * If the original handler calls `event.preventDefault()`, the next one is skipped
+ * unless `checkForDefaultPrevented` is `false`.
+ */
+declare function composeEventHandlers<E>(originalEventHandler?: (event: E) => void, ourEventHandler?: (event: E) => void, { checkForDefaultPrevented }?: {
+    checkForDefaultPrevented?: boolean | undefined;
+}): (event: E) => void;
+/**
+ * Merge two sets of React props, with the second set taking precedence
+ * except for event handlers and `className`/`style`, which are composed.
+ */
+type AnyProps = Record<string, unknown>;
+declare function mergeProps<T extends AnyProps, U extends AnyProps>(base: T, override: U): T & U;
+
+declare const isFunction: (value: unknown) => value is (...args: unknown[]) => unknown;
+declare const isObject: (value: unknown) => value is Record<string, unknown>;
+declare const isString: (value: unknown) => value is string;
+declare const isNumber: (value: unknown) => value is number;
+declare const isArray: <T = unknown>(value: unknown) => value is T[];
+declare const isNullish: (value: unknown) => value is null | undefined;
+declare const isBoolean: (value: unknown) => value is boolean;
+declare const isEmpty: (value: unknown) => boolean;
+declare const isBrowser: () => boolean;
+
+/** Split an array into chunks of size N. */
+declare function chunk<T>(array: T[], size: number): T[][];
+/** Group array items by a key function. */
+declare function groupBy<T, K extends string | number>(array: T[], keyFn: (item: T) => K): Record<K, T[]>;
+/** Sort array by a key function (non-mutating). */
+declare function sortBy<T>(array: T[], keyFn: (item: T) => number | string): T[];
+/** Get unique items by a key function. */
+declare function uniqueBy<T>(array: T[], keyFn: (item: T) => unknown): T[];
+/** Partition array into [matching, notMatching]. */
+declare function partition<T>(array: T[], predicate: (item: T) => boolean): [T[], T[]];
+/** Generate a numeric range. */
+declare function range(start: number, end?: number, step?: number): number[];
+
+/** Pick specified keys from an object. */
+declare function pick<T extends object, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+/** Omit specified keys from an object. */
+declare function omit<T extends object, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
+/** Get a nested value by dot-path. */
+declare function get<T = unknown>(obj: unknown, path: string, defaultValue?: T): T | undefined;
+/** Deep equality check. */
+declare function deepEqual(a: unknown, b: unknown): boolean;
+
+declare const capitalize: (str: string) => string;
+declare const camelCase: (str: string) => string;
+declare const kebabCase: (str: string) => string;
+declare const snakeCase: (str: string) => string;
+declare const truncate: (str: string, maxLength: number, suffix?: string) => string;
+declare const slugify: (str: string) => string;
+
+/** Clamp a number between min and max. */
+declare const clamp: (value: number, min: number, max: number) => number;
+/** Round to N decimal places. */
+declare const roundTo: (value: number, decimals?: number) => number;
+/** Linear interpolation between two values. */
+declare const lerp: (start: number, end: number, t: number) => number;
+/** Format a number using Intl. */
+declare const formatNumber: (value: number, options?: Intl.NumberFormatOptions, locale?: string) => string;
+declare const formatCurrency: (value: number, currency?: string, locale?: string) => string;
+declare const formatPercent: (value: number, decimals?: number, locale?: string) => string;
+
+declare const getOwnerDocument: (node: Node | null | undefined) => Document;
+declare const getOwnerWindow: (node: Node | null | undefined) => Window;
+declare const getActiveElement: (doc?: Document) => Element | null;
+/** A list of all focusable element selectors. */
+declare const FOCUSABLE_SELECTOR: string;
+declare const getFocusableElements: (container: HTMLElement | null) => HTMLElement[];
+declare const contains: (parent: Node | null, child: Node | null) => boolean;
+
+export { FOCUSABLE_SELECTOR, camelCase, capitalize, chunk, clamp, cn, composeEventHandlers, contains, deepEqual, formatCurrency, formatNumber, formatPercent, get, getActiveElement, getFocusableElements, getOwnerDocument, getOwnerWindow, groupBy, isArray, isBoolean, isBrowser, isEmpty, isFunction, isNullish, isNumber, isObject, isString, kebabCase, lerp, mergeProps, omit, partition, pick, range, roundTo, slugify, snakeCase, sortBy, truncate, uniqueBy };

package/dist/index.mjs

@@ -0,0 +1,205 @@
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+// src/class-names.ts
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+
+// src/compose.ts
+function composeEventHandlers(originalEventHandler, ourEventHandler, { checkForDefaultPrevented = true } = {}) {
+  return function handleEvent(event) {
+    originalEventHandler?.(event);
+    if (checkForDefaultPrevented === false || !event.defaultPrevented) {
+      ourEventHandler?.(event);
+    }
+  };
+}
+function mergeProps(base, override) {
+  const merged = { ...base, ...override };
+  for (const key in override) {
+    const baseVal = base[key];
+    const overrideVal = override[key];
+    if (/^on[A-Z]/.test(key) && typeof baseVal === "function" && typeof overrideVal === "function") {
+      merged[key] = (...args) => {
+        overrideVal(...args);
+        baseVal(...args);
+      };
+    } else if (key === "style" && typeof baseVal === "object" && typeof overrideVal === "object") {
+      merged[key] = { ...baseVal, ...overrideVal };
+    } else if (key === "className" && typeof baseVal === "string" && typeof overrideVal === "string") {
+      merged[key] = [baseVal, overrideVal].filter(Boolean).join(" ");
+    }
+  }
+  return merged;
+}
+
+// src/type-guards.ts
+var isFunction = (value) => typeof value === "function";
+var isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isString = (value) => typeof value === "string";
+var isNumber = (value) => typeof value === "number" && !Number.isNaN(value);
+var isArray = (value) => Array.isArray(value);
+var isNullish = (value) => value == null;
+var isBoolean = (value) => typeof value === "boolean";
+var isEmpty = (value) => {
+  if (isNullish(value)) return true;
+  if (isString(value) || isArray(value)) return value.length === 0;
+  if (isObject(value)) return Object.keys(value).length === 0;
+  return false;
+};
+var isBrowser = () => typeof window !== "undefined";
+
+// src/array.ts
+function chunk(array, size) {
+  if (size <= 0) return [];
+  const result = [];
+  for (let i = 0; i < array.length; i += size) {
+    result.push(array.slice(i, i + size));
+  }
+  return result;
+}
+function groupBy(array, keyFn) {
+  return array.reduce(
+    (acc, item) => {
+      const key = keyFn(item);
+      (acc[key] ||= []).push(item);
+      return acc;
+    },
+    {}
+  );
+}
+function sortBy(array, keyFn) {
+  return [...array].sort((a, b) => {
+    const aKey = keyFn(a);
+    const bKey = keyFn(b);
+    if (aKey < bKey) return -1;
+    if (aKey > bKey) return 1;
+    return 0;
+  });
+}
+function uniqueBy(array, keyFn) {
+  const seen = /* @__PURE__ */ new Set();
+  return array.filter((item) => {
+    const key = keyFn(item);
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
+  });
+}
+function partition(array, predicate) {
+  const truthy = [];
+  const falsy = [];
+  for (const item of array) {
+    if (predicate(item)) truthy.push(item);
+    else falsy.push(item);
+  }
+  return [truthy, falsy];
+}
+function range(start, end, step = 1) {
+  if (end === void 0) {
+    end = start;
+    start = 0;
+  }
+  const result = [];
+  if (step > 0) {
+    for (let i = start; i < end; i += step) result.push(i);
+  } else if (step < 0) {
+    for (let i = start; i > end; i += step) result.push(i);
+  }
+  return result;
+}
+
+// src/object.ts
+function pick(obj, keys) {
+  const result = {};
+  for (const key of keys) {
+    if (key in obj) result[key] = obj[key];
+  }
+  return result;
+}
+function omit(obj, keys) {
+  const result = { ...obj };
+  for (const key of keys) {
+    delete result[key];
+  }
+  return result;
+}
+function get(obj, path, defaultValue) {
+  const keys = path.split(".");
+  let result = obj;
+  for (const key of keys) {
+    if (result == null || typeof result !== "object") return defaultValue;
+    result = result[key];
+  }
+  return result ?? defaultValue;
+}
+function deepEqual(a, b) {
+  if (a === b) return true;
+  if (a == null || b == null) return false;
+  if (typeof a !== typeof b) return false;
+  if (typeof a !== "object") return false;
+  if (Array.isArray(a) && Array.isArray(b)) {
+    if (a.length !== b.length) return false;
+    return a.every((item, i) => deepEqual(item, b[i]));
+  }
+  const aKeys = Object.keys(a);
+  const bKeys = Object.keys(b);
+  if (aKeys.length !== bKeys.length) return false;
+  return aKeys.every(
+    (key) => deepEqual(a[key], b[key])
+  );
+}
+
+// src/string.ts
+var capitalize = (str) => str.length === 0 ? str : str.charAt(0).toUpperCase() + str.slice(1);
+var camelCase = (str) => str.replace(/[-_\s]+(.)?/g, (_, char) => char ? char.toUpperCase() : "").replace(/^(.)/, (m) => m.toLowerCase());
+var kebabCase = (str) => str.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
+var snakeCase = (str) => str.replace(/([a-z])([A-Z])/g, "$1_$2").replace(/[\s-]+/g, "_").toLowerCase();
+var truncate = (str, maxLength, suffix = "\u2026") => str.length <= maxLength ? str : str.slice(0, maxLength - suffix.length) + suffix;
+var slugify = (str) => str.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9\s-]/g, "").trim().replace(/\s+/g, "-").replace(/-+/g, "-");
+
+// src/number.ts
+var clamp = (value, min, max) => Math.max(min, Math.min(max, value));
+var roundTo = (value, decimals = 0) => {
+  const factor = 10 ** decimals;
+  return Math.round(value * factor) / factor;
+};
+var lerp = (start, end, t) => start + (end - start) * t;
+var formatNumber = (value, options = {}, locale = "en-US") => new Intl.NumberFormat(locale, options).format(value);
+var formatCurrency = (value, currency = "USD", locale = "en-US") => formatNumber(value, { style: "currency", currency }, locale);
+var formatPercent = (value, decimals = 0, locale = "en-US") => formatNumber(
+  value,
+  { style: "percent", minimumFractionDigits: decimals, maximumFractionDigits: decimals },
+  locale
+);
+
+// src/dom.ts
+var getOwnerDocument = (node) => node?.ownerDocument ?? (isBrowser() ? document : {});
+var getOwnerWindow = (node) => getOwnerDocument(node).defaultView ?? (isBrowser() ? window : {});
+var getActiveElement = (doc = document) => doc.activeElement;
+var FOCUSABLE_SELECTOR = [
+  "a[href]",
+  "button:not([disabled])",
+  'input:not([disabled]):not([type="hidden"])',
+  "select:not([disabled])",
+  "textarea:not([disabled])",
+  '[tabindex]:not([tabindex="-1"])',
+  "audio[controls]",
+  "video[controls]",
+  '[contenteditable]:not([contenteditable="false"])'
+].join(",");
+var getFocusableElements = (container) => {
+  if (!container) return [];
+  return Array.from(container.querySelectorAll(FOCUSABLE_SELECTOR)).filter(
+    (el) => !el.hasAttribute("disabled") && el.offsetParent !== null
+  );
+};
+var contains = (parent, child) => {
+  if (!parent || !child) return false;
+  return parent.contains(child);
+};
+
+export { FOCUSABLE_SELECTOR, camelCase, capitalize, chunk, clamp, cn, composeEventHandlers, contains, deepEqual, formatCurrency, formatNumber, formatPercent, get, getActiveElement, getFocusableElements, getOwnerDocument, getOwnerWindow, groupBy, isArray, isBoolean, isBrowser, isEmpty, isFunction, isNullish, isNumber, isObject, isString, kebabCase, lerp, mergeProps, omit, partition, pick, range, roundTo, slugify, snakeCase, sortBy, truncate, uniqueBy };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/class-names.ts","../src/compose.ts","../src/type-guards.ts","../src/array.ts","../src/object.ts","../src/string.ts","../src/number.ts","../src/dom.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import { clsx, type ClassValue } from 'clsx';\nimport { twMerge } from 'tailwind-merge';\n\n/**\n * Merge Tailwind class names intelligently — conflicting utilities are resolved.\n *\n * @example\n * cn('px-2 py-1', condition && 'px-4') // → 'py-1 px-4'\n */\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs));\n}\n","/**\n * Compose two event handlers into one. The handlers are called in order.\n * If the original handler calls `event.preventDefault()`, the next one is skipped\n * unless `checkForDefaultPrevented` is `false`.\n */\nexport function composeEventHandlers<E>(\n  originalEventHandler?: (event: E) => void,\n  ourEventHandler?: (event: E) => void,\n  { checkForDefaultPrevented = true } = {},\n): (event: E) => void {\n  return function handleEvent(event: E) {\n    originalEventHandler?.(event);\n\n    if (\n      checkForDefaultPrevented === false ||\n      !(event as unknown as { defaultPrevented: boolean }).defaultPrevented\n    ) {\n      ourEventHandler?.(event);\n    }\n  };\n}\n\n/**\n * Merge two sets of React props, with the second set taking precedence\n * except for event handlers and `className`/`style`, which are composed.\n */\ntype AnyProps = Record<string, unknown>;\n\nexport function mergeProps<T extends AnyProps, U extends AnyProps>(\n  base: T,\n  override: U,\n): T & U {\n  const merged: AnyProps = { ...base, ...override };\n\n  for (const key in override) {\n    const baseVal = base[key];\n    const overrideVal = override[key];\n\n    // Compose event handlers (onClick, onKeyDown, etc.)\n    if (/^on[A-Z]/.test(key) && typeof baseVal === 'function' && typeof overrideVal === 'function') {\n      merged[key] = (...args: unknown[]) => {\n        (overrideVal as (...args: unknown[]) => void)(...args);\n        (baseVal as (...args: unknown[]) => void)(...args);\n      };\n    }\n    // Merge styles\n    else if (key === 'style' && typeof baseVal === 'object' && typeof overrideVal === 'object') {\n      merged[key] = { ...(baseVal as object), ...(overrideVal as object) };\n    }\n    // Merge classNames\n    else if (key === 'className' && typeof baseVal === 'string' && typeof overrideVal === 'string') {\n      merged[key] = [baseVal, overrideVal].filter(Boolean).join(' ');\n    }\n  }\n\n  return merged as T & U;\n}\n","export const isFunction = (value: unknown): value is (...args: unknown[]) => unknown =>\n  typeof value === 'function';\n\nexport const isObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nexport const isString = (value: unknown): value is string => typeof value === 'string';\n\nexport const isNumber = (value: unknown): value is number =>\n  typeof value === 'number' && !Number.isNaN(value);\n\nexport const isArray = <T = unknown>(value: unknown): value is T[] => Array.isArray(value);\n\nexport const isNullish = (value: unknown): value is null | undefined => value == null;\n\nexport const isBoolean = (value: unknown): value is boolean => typeof value === 'boolean';\n\nexport const isEmpty = (value: unknown): boolean => {\n  if (isNullish(value)) return true;\n  if (isString(value) || isArray(value)) return value.length === 0;\n  if (isObject(value)) return Object.keys(value).length === 0;\n  return false;\n};\n\nexport const isBrowser = (): boolean => typeof window !== 'undefined';\n","/** Split an array into chunks of size N. */\nexport function chunk<T>(array: T[], size: number): T[][] {\n  if (size <= 0) return [];\n  const result: T[][] = [];\n  for (let i = 0; i < array.length; i += size) {\n    result.push(array.slice(i, i + size));\n  }\n  return result;\n}\n\n/** Group array items by a key function. */\nexport function groupBy<T, K extends string | number>(\n  array: T[],\n  keyFn: (item: T) => K,\n): Record<K, T[]> {\n  return array.reduce(\n    (acc, item) => {\n      const key = keyFn(item);\n      (acc[key] ||= []).push(item);\n      return acc;\n    },\n    {} as Record<K, T[]>,\n  );\n}\n\n/** Sort array by a key function (non-mutating). */\nexport function sortBy<T>(array: T[], keyFn: (item: T) => number | string): T[] {\n  return [...array].sort((a, b) => {\n    const aKey = keyFn(a);\n    const bKey = keyFn(b);\n    if (aKey < bKey) return -1;\n    if (aKey > bKey) return 1;\n    return 0;\n  });\n}\n\n/** Get unique items by a key function. */\nexport function uniqueBy<T>(array: T[], keyFn: (item: T) => unknown): T[] {\n  const seen = new Set();\n  return array.filter((item) => {\n    const key = keyFn(item);\n    if (seen.has(key)) return false;\n    seen.add(key);\n    return true;\n  });\n}\n\n/** Partition array into [matching, notMatching]. */\nexport function partition<T>(array: T[], predicate: (item: T) => boolean): [T[], T[]] {\n  const truthy: T[] = [];\n  const falsy: T[] = [];\n  for (const item of array) {\n    if (predicate(item)) truthy.push(item);\n    else falsy.push(item);\n  }\n  return [truthy, falsy];\n}\n\n/** Generate a numeric range. */\nexport function range(start: number, end?: number, step = 1): number[] {\n  if (end === undefined) {\n    end = start;\n    start = 0;\n  }\n  const result: number[] = [];\n  if (step > 0) {\n    for (let i = start; i < end; i += step) result.push(i);\n  } else if (step < 0) {\n    for (let i = start; i > end; i += step) result.push(i);\n  }\n  return result;\n}\n","/** Pick specified keys from an object. */\nexport function pick<T extends object, K extends keyof T>(obj: T, keys: K[]): Pick<T, K> {\n  const result = {} as Pick<T, K>;\n  for (const key of keys) {\n    if (key in obj) result[key] = obj[key];\n  }\n  return result;\n}\n\n/** Omit specified keys from an object. */\nexport function omit<T extends object, K extends keyof T>(obj: T, keys: K[]): Omit<T, K> {\n  const result = { ...obj };\n  for (const key of keys) {\n    delete result[key];\n  }\n  return result;\n}\n\n/** Get a nested value by dot-path. */\nexport function get<T = unknown>(obj: unknown, path: string, defaultValue?: T): T | undefined {\n  const keys = path.split('.');\n  let result: unknown = obj;\n  for (const key of keys) {\n    if (result == null || typeof result !== 'object') return defaultValue;\n    result = (result as Record<string, unknown>)[key];\n  }\n  return (result ?? defaultValue) as T | undefined;\n}\n\n/** Deep equality check. */\nexport function deepEqual(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n  if (a == null || b == null) return false;\n  if (typeof a !== typeof b) return false;\n  if (typeof a !== 'object') return false;\n\n  if (Array.isArray(a) && Array.isArray(b)) {\n    if (a.length !== b.length) return false;\n    return a.every((item, i) => deepEqual(item, b[i]));\n  }\n\n  const aKeys = Object.keys(a as object);\n  const bKeys = Object.keys(b as object);\n  if (aKeys.length !== bKeys.length) return false;\n  return aKeys.every((key) =>\n    deepEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key]),\n  );\n}\n","export const capitalize = (str: string): string =>\n  str.length === 0 ? str : str.charAt(0).toUpperCase() + str.slice(1);\n\nexport const camelCase = (str: string): string =>\n  str\n    .replace(/[-_\\s]+(.)?/g, (_, char) => (char ? char.toUpperCase() : ''))\n    .replace(/^(.)/, (m) => m.toLowerCase());\n\nexport const kebabCase = (str: string): string =>\n  str\n    .replace(/([a-z])([A-Z])/g, '$1-$2')\n    .replace(/[\\s_]+/g, '-')\n    .toLowerCase();\n\nexport const snakeCase = (str: string): string =>\n  str\n    .replace(/([a-z])([A-Z])/g, '$1_$2')\n    .replace(/[\\s-]+/g, '_')\n    .toLowerCase();\n\nexport const truncate = (str: string, maxLength: number, suffix = '…'): string =>\n  str.length <= maxLength ? str : str.slice(0, maxLength - suffix.length) + suffix;\n\nexport const slugify = (str: string): string =>\n  str\n    .toLowerCase()\n    .normalize('NFD')\n    .replace(/[\\u0300-\\u036f]/g, '')\n    .replace(/[^a-z0-9\\s-]/g, '')\n    .trim()\n    .replace(/\\s+/g, '-')\n    .replace(/-+/g, '-');\n","/** Clamp a number between min and max. */\nexport const clamp = (value: number, min: number, max: number): number =>\n  Math.max(min, Math.min(max, value));\n\n/** Round to N decimal places. */\nexport const roundTo = (value: number, decimals = 0): number => {\n  const factor = 10 ** decimals;\n  return Math.round(value * factor) / factor;\n};\n\n/** Linear interpolation between two values. */\nexport const lerp = (start: number, end: number, t: number): number => start + (end - start) * t;\n\n/** Format a number using Intl. */\nexport const formatNumber = (\n  value: number,\n  options: Intl.NumberFormatOptions = {},\n  locale = 'en-US',\n): string => new Intl.NumberFormat(locale, options).format(value);\n\nexport const formatCurrency = (\n  value: number,\n  currency = 'USD',\n  locale = 'en-US',\n): string => formatNumber(value, { style: 'currency', currency }, locale);\n\nexport const formatPercent = (\n  value: number,\n  decimals = 0,\n  locale = 'en-US',\n): string =>\n  formatNumber(\n    value,\n    { style: 'percent', minimumFractionDigits: decimals, maximumFractionDigits: decimals },\n    locale,\n  );\n","import { isBrowser } from './type-guards';\n\nexport const getOwnerDocument = (node: Node | null | undefined): Document =>\n  node?.ownerDocument ?? (isBrowser() ? document : ({} as Document));\n\nexport const getOwnerWindow = (node: Node | null | undefined): Window =>\n  (getOwnerDocument(node).defaultView ?? (isBrowser() ? window : ({} as Window))) as Window;\n\nexport const getActiveElement = (doc: Document = document): Element | null => doc.activeElement;\n\n/** A list of all focusable element selectors. */\nexport const FOCUSABLE_SELECTOR = [\n  'a[href]',\n  'button:not([disabled])',\n  'input:not([disabled]):not([type=\"hidden\"])',\n  'select:not([disabled])',\n  'textarea:not([disabled])',\n  '[tabindex]:not([tabindex=\"-1\"])',\n  'audio[controls]',\n  'video[controls]',\n  '[contenteditable]:not([contenteditable=\"false\"])',\n].join(',');\n\nexport const getFocusableElements = (container: HTMLElement | null): HTMLElement[] => {\n  if (!container) return [];\n  return Array.from(container.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)).filter(\n    (el) => !el.hasAttribute('disabled') && el.offsetParent !== null,\n  );\n};\n\nexport const contains = (parent: Node | null, child: Node | null): boolean => {\n  if (!parent || !child) return false;\n  return parent.contains(child);\n};\n"]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@structyl/utils",
+  "version": "1.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Tree-shakeable TypeScript utilities for structyl: cn (Tailwind merge), prop/event composition, type guards, array/object/string/number/DOM helpers.",
+  "keywords": [
+    "react",
+    "typescript",
+    "structyl",
+    "utils",
+    "cn",
+    "tailwind-merge",
+    "clsx",
+    "type-guards",
+    "tree-shakeable",
+    "merge-props",
+    "dom",
+    "helpers"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^2.5.4"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.2"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  }
+}