@adara-cs/utils 2.9.0 → 2.10.0

package/dist/csx.js

@@ -1,4 +1,4 @@
-const e = (...o) => o.filter(Boolean).join(" ");
+const e = (...o) => Array.from(new Set(o.filter(Boolean))).join(" ");
 export {
   e as csx
 };

package/dist/csx.js.map

@@ -1 +1 @@
-{"version":3,"file":"csx.js","sources":["../src/csx.ts"],"sourcesContent":["export const csx = (...rest: (string | undefined)[]) => rest.filter(Boolean).join(' ')"],"names":["csx","rest"],"mappings":"AAAa,MAAAA,IAAM,IAAIC,MAAiCA,EAAK,OAAO,OAAO,EAAE,KAAK,GAAG;"}
+{"version":3,"file":"csx.js","sources":["../src/csx.ts"],"sourcesContent":["export const csx = (...rest: (string | undefined)[]) => Array.from(new Set(rest.filter(Boolean))).join(' ')"],"names":["csx","rest"],"mappings":"AAAO,MAAMA,IAAM,IAAIC,MAAiC,MAAM,KAAK,IAAI,IAAIA,EAAK,OAAO,OAAO,CAAC,CAAC,EAAE,KAAK,GAAG;"}

package/dist/index.d.ts

@@ -2,3 +2,4 @@ export * from './csx';
 export * from './mergeRefs';
 export * from './inRange';
 export * from './getElementRef';
+export * from './mergeProps.ts';

package/dist/index.js

@@ -1,11 +1,13 @@
 import { csx as o } from "./csx.js";
-import { mergeRefs as m } from "./mergeRefs.js";
-import { inRange as x } from "./inRange.js";
+import { mergeRefs as f } from "./mergeRefs.js";
+import { inRange as p } from "./inRange.js";
 import { getElementRef as g } from "./getElementRef.js";
+import { mergeProps as s } from "./mergeProps.js";
 export {
   o as csx,
   g as getElementRef,
-  x as inRange,
-  m as mergeRefs
+  p as inRange,
+  s as mergeProps,
+  f as mergeRefs
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}

package/dist/mergeProps.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Merges multiple props objects together into a single props object.
+ *
+ * - ✅ Event handlers (`onClick`, `onChange`, etc.) are chained in order of appearance.
+ * - ✅ `className` values are concatenated with space.
+ * - ✅ `id` is deduplicated: the first defined value is preserved.
+ * - ✅ All other props are shallow-merged, with the last one winning.
+ *
+ * This function is especially useful for composing component props,
+ * e.g., merging parent and child props in polymorphic or slot-based components.
+ *
+ * @template T - Type of the props object.
+ * @param {...T[]} args - One or more props objects to merge together.
+ * @returns {T} - A new object containing the merged props.
+ *
+ * @example
+ * const props = mergeProps(
+ *   { className: 'btn', onClick: () => console.log('base') },
+ *   { className: 'primary', onClick: () => console.log('override') }
+ * );
+ *
+ * // props.className === 'btn primary'
+ * // props.onClick calls both handlers
+ */
+export declare function mergeProps<T extends Record<string, unknown>>(...args: T[]): T;

package/dist/mergeProps.js

@@ -0,0 +1,40 @@
+import { csx as r } from "./csx.js";
+import { mergeRefs as s } from "./mergeRefs.js";
+function m(...c) {
+  const e = {};
+  for (const f of c)
+    for (const o in f) {
+      const t = f[o], n = e[o];
+      if (typeof n == "function" && typeof t == "function" && /^on[A-Z]/.test(o)) {
+        e[o] = (...i) => {
+          n(...i), t(...i);
+        };
+        continue;
+      }
+      if (o === "ref") {
+        e[o] = s([n, t]);
+        continue;
+      }
+      if (o === "style" && typeof n == "object" && typeof t == "object") {
+        e[o] = {
+          ...n,
+          ...t
+        };
+        continue;
+      }
+      if (o === "className") {
+        e[o] = r(n, t);
+        continue;
+      }
+      if (o === "id") {
+        e[o] = n ?? t;
+        continue;
+      }
+      e[o] = t;
+    }
+  return e;
+}
+export {
+  m as mergeProps
+};
+//# sourceMappingURL=mergeProps.js.map

package/dist/mergeProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeProps.js","sources":["../src/mergeProps.ts"],"sourcesContent":["import { csx } from './csx';\nimport { mergeRefs } from './mergeRefs';\nimport { Ref } from 'react';\n\n/**\n * Merges multiple props objects together into a single props object.\n *\n * - ✅ Event handlers (`onClick`, `onChange`, etc.) are chained in order of appearance.\n * - ✅ `className` values are concatenated with space.\n * - ✅ `id` is deduplicated: the first defined value is preserved.\n * - ✅ All other props are shallow-merged, with the last one winning.\n *\n * This function is especially useful for composing component props,\n * e.g., merging parent and child props in polymorphic or slot-based components.\n *\n * @template T - Type of the props object.\n * @param {...T[]} args - One or more props objects to merge together.\n * @returns {T} - A new object containing the merged props.\n *\n * @example\n * const props = mergeProps(\n *   { className: 'btn', onClick: () => console.log('base') },\n *   { className: 'primary', onClick: () => console.log('override') }\n * );\n *\n * // props.className === 'btn primary'\n * // props.onClick calls both handlers\n */\nexport function mergeProps<T extends Record<string, unknown>>(...args: T[]): T {\n  const result: Record<string, unknown> = {};\n\n  for (const props of args) {\n    for (const key in props) {\n      const newValue = props[key];\n      const existingValue = result[key];\n\n      if (\n        typeof existingValue === 'function' &&\n        typeof newValue === 'function' &&\n        /^on[A-Z]/.test(key)\n      ) {\n        result[key] = (...args: unknown[]) => {\n          existingValue(...args);\n          newValue(...args);\n        };\n        continue;\n      }\n\n      if (key === 'ref') {\n        result[key] = mergeRefs([existingValue as Ref<unknown>, newValue as Ref<unknown>])\n        continue\n      }\n\n      if (key === 'style' && typeof existingValue === 'object' && typeof newValue === 'object') {\n        result[key] = {\n          ...existingValue,\n          ...newValue,\n        }\n        continue;\n      }\n\n      if (key === 'className') {\n        result[key] = csx(existingValue as string, newValue as string);\n        continue;\n      }\n\n      if (key === 'id') {\n        result[key] = existingValue ?? newValue;\n        continue;\n      }\n\n      result[key] = newValue;\n    }\n  }\n\n  return result as T;\n}"],"names":["mergeProps","args","result","props","key","newValue","existingValue","mergeRefs","csx"],"mappings":";;AA4BO,SAASA,KAAiDC,GAAc;AAC7E,QAAMC,IAAkC,CAAC;AAEzC,aAAWC,KAASF;AAClB,eAAWG,KAAOD,GAAO;AACjB,YAAAE,IAAWF,EAAMC,CAAG,GACpBE,IAAgBJ,EAAOE,CAAG;AAG9B,UAAA,OAAOE,KAAkB,cACzB,OAAOD,KAAa,cACpB,WAAW,KAAKD,CAAG,GACnB;AACO,QAAAF,EAAAE,CAAG,IAAI,IAAIH,MAAoB;AACpC,UAAAK,EAAc,GAAGL,CAAI,GACrBI,EAAS,GAAGJ,CAAI;AAAA,QAClB;AACA;AAAA,MAAA;AAGF,UAAIG,MAAQ,OAAO;AACjB,QAAAF,EAAOE,CAAG,IAAIG,EAAU,CAACD,GAA+BD,CAAwB,CAAC;AACjF;AAAA,MAAA;AAGF,UAAID,MAAQ,WAAW,OAAOE,KAAkB,YAAY,OAAOD,KAAa,UAAU;AACxF,QAAAH,EAAOE,CAAG,IAAI;AAAA,UACZ,GAAGE;AAAA,UACH,GAAGD;AAAA,QACL;AACA;AAAA,MAAA;AAGF,UAAID,MAAQ,aAAa;AACvB,QAAAF,EAAOE,CAAG,IAAII,EAAIF,GAAyBD,CAAkB;AAC7D;AAAA,MAAA;AAGF,UAAID,MAAQ,MAAM;AACT,QAAAF,EAAAE,CAAG,IAAIE,KAAiBD;AAC/B;AAAA,MAAA;AAGF,MAAAH,EAAOE,CAAG,IAAIC;AAAA,IAAA;AAIX,SAAAH;AACT;"}

package/dist/mergeRefs.d.ts

@@ -1,2 +1,2 @@
-import { LegacyRef, MutableRefObject, RefCallback } from 'react';
-export declare const mergeRefs: <T = never>(refs: Array<MutableRefObject<T> | LegacyRef<T> | undefined | null>) => RefCallback<T>;
+import { Ref, RefCallback } from 'react';
+export declare const mergeRefs: <T = unknown>(refs: Array<Ref<T> | undefined | null>) => RefCallback<T>;

package/dist/mergeRefs.js

@@ -1,9 +1,9 @@
-const o = (e) => (t) => {
-  e.forEach((n) => {
-    typeof n == "function" ? n(t) : n != null && (n.current = t);
+const n = (e) => (o) => {
+  e.forEach((t) => {
+    typeof t == "function" ? t(o) : t != null && typeof t == "object" && (t.current = o);
   });
 };
 export {
-  o as mergeRefs
+  n as mergeRefs
 };
 //# sourceMappingURL=mergeRefs.js.map

package/dist/mergeRefs.js.map

@@ -1 +1 @@
-{"version":3,"file":"mergeRefs.js","sources":["../src/mergeRefs.ts"],"sourcesContent":["import { LegacyRef, MutableRefObject, RefCallback } from 'react';\n\nexport const mergeRefs = <T = never>(\n  refs: Array<MutableRefObject<T> | LegacyRef<T> | undefined | null>\n): RefCallback<T> => {\n  return (value) => {\n    refs.forEach((ref) => {\n      if (typeof ref === 'function') {\n        ref(value);\n      } else if (ref != null) {\n        (ref as MutableRefObject<T | null>).current = value;\n      }\n    });\n  };\n}"],"names":["mergeRefs","refs","value","ref"],"mappings":"AAEa,MAAAA,IAAY,CACvBC,MAEO,CAACC,MAAU;AACX,EAAAD,EAAA,QAAQ,CAACE,MAAQ;AAChB,IAAA,OAAOA,KAAQ,aACjBA,EAAID,CAAK,IACAC,KAAO,SACfA,EAAmC,UAAUD;AAAA,EAChD,CACD;AACH;"}
+{"version":3,"file":"mergeRefs.js","sources":["../src/mergeRefs.ts"],"sourcesContent":["import { Ref, RefCallback, RefObject } from 'react';\n\nexport const mergeRefs = <T = unknown>(\n  refs: Array<Ref<T> | undefined | null>\n): RefCallback<T> => {\n  return (value) => {\n    refs.forEach((ref) => {\n      if (typeof ref === 'function') {\n        ref(value);\n      } else if (ref != null && typeof ref === 'object') {\n        (ref as RefObject<T | null>).current = value;\n      }\n    });\n  };\n}"],"names":["mergeRefs","refs","value","ref"],"mappings":"AAEa,MAAAA,IAAY,CACvBC,MAEO,CAACC,MAAU;AACX,EAAAD,EAAA,QAAQ,CAACE,MAAQ;AAChB,IAAA,OAAOA,KAAQ,aACjBA,EAAID,CAAK,IACAC,KAAO,QAAQ,OAAOA,KAAQ,aACtCA,EAA4B,UAAUD;AAAA,EACzC,CACD;AACH;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adara-cs/utils",
-  "version": "2.9.0",
+  "version": "2.10.0",
   "description": "Utilities for @adara-cs/ui-kit-web",
   "license": "MIT",
   "keywords": [