@kopexa/shared-utils 1.1.3 → 1.1.5

package/dist/functions.d.mts

@@ -1,3 +1,6 @@
+/** biome-ignore-all lint/complexity/noBannedTypes: utility library */
+/** biome-ignore-all lint/suspicious/noExplicitAny: utility library */
+type Args<T extends Function> = T extends (...args: infer R) => any ? R : never;
 /**
  * Generates a unique identifier using a specified prefix and a random number.
  *
@@ -8,5 +11,21 @@
  * getUniqueID('btn'); // returns 'btn-123456'
  */
 declare function getUniqueID(prefix: string): string;
+/**
+ * Creates a function that invokes each provided function with the same argument, until
+ * one of the functions calls `event.preventDefault()`.
+ *
+ * @param fns - An array of functions that may or may not be defined.
+ * @returns A function that takes an event and invokes each handler with this event.
+ *
+ * @typeParam T - A function type that takes an event-like argument.
+ *
+ * @example
+ * const handler1 = event => console.log('Handled by first', event.type);
+ * const handler2 = event => event.preventDefault();
+ * const allHandlers = callAllHandlers(handler1, handler2);
+ * allHandlers({ type: 'click' });
+ */
+declare function callAllHandlers<T extends (event: any) => void>(...fns: (T | undefined)[]): (event: Args<T>[0]) => void;
 
-export { getUniqueID };
+export { callAllHandlers, getUniqueID };

package/dist/functions.d.ts

@@ -1,3 +1,6 @@
+/** biome-ignore-all lint/complexity/noBannedTypes: utility library */
+/** biome-ignore-all lint/suspicious/noExplicitAny: utility library */
+type Args<T extends Function> = T extends (...args: infer R) => any ? R : never;
 /**
  * Generates a unique identifier using a specified prefix and a random number.
  *
@@ -8,5 +11,21 @@
  * getUniqueID('btn'); // returns 'btn-123456'
  */
 declare function getUniqueID(prefix: string): string;
+/**
+ * Creates a function that invokes each provided function with the same argument, until
+ * one of the functions calls `event.preventDefault()`.
+ *
+ * @param fns - An array of functions that may or may not be defined.
+ * @returns A function that takes an event and invokes each handler with this event.
+ *
+ * @typeParam T - A function type that takes an event-like argument.
+ *
+ * @example
+ * const handler1 = event => console.log('Handled by first', event.type);
+ * const handler2 = event => event.preventDefault();
+ * const allHandlers = callAllHandlers(handler1, handler2);
+ * allHandlers({ type: 'click' });
+ */
+declare function callAllHandlers<T extends (event: any) => void>(...fns: (T | undefined)[]): (event: Args<T>[0]) => void;
 
-export { getUniqueID };
+export { callAllHandlers, getUniqueID };

package/dist/functions.js

@@ -20,13 +20,23 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/functions.ts
 var functions_exports = {};
 __export(functions_exports, {
+  callAllHandlers: () => callAllHandlers,
   getUniqueID: () => getUniqueID
 });
 module.exports = __toCommonJS(functions_exports);
 function getUniqueID(prefix) {
   return `${prefix}-${Math.floor(Math.random() * 1e6)}`;
 }
+function callAllHandlers(...fns) {
+  return function func(event) {
+    fns.some((fn) => {
+      fn == null ? void 0 : fn(event);
+      return event == null ? void 0 : event.defaultPrevented;
+    });
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  callAllHandlers,
   getUniqueID
 });

package/dist/functions.mjs

@@ -2,6 +2,15 @@
 function getUniqueID(prefix) {
   return `${prefix}-${Math.floor(Math.random() * 1e6)}`;
 }
+function callAllHandlers(...fns) {
+  return function func(event) {
+    fns.some((fn) => {
+      fn == null ? void 0 : fn(event);
+      return event == null ? void 0 : event.defaultPrevented;
+    });
+  };
+}
 export {
+  callAllHandlers,
   getUniqueID
 };

package/dist/index.d.mts

@@ -1,7 +1,8 @@
 export { ariaAttr, dataAttr, isArray, isEmpty, isEmptyArray, isEmptyObject, isObject } from './assertion.mjs';
 export { cn } from './clsx.mjs';
-export { getUniqueID } from './functions.mjs';
+export { callAllHandlers, getUniqueID } from './functions.mjs';
 export { clamp } from './numbers.mjs';
+export { compact, mapPropsVariants, objectToDeps } from './object.mjs';
 export { chain } from './ra.mjs';
 export { getInitials, safeText } from './text.mjs';
 import 'clsx';

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 export { ariaAttr, dataAttr, isArray, isEmpty, isEmptyArray, isEmptyObject, isObject } from './assertion.js';
 export { cn } from './clsx.js';
-export { getUniqueID } from './functions.js';
+export { callAllHandlers, getUniqueID } from './functions.js';
 export { clamp } from './numbers.js';
+export { compact, mapPropsVariants, objectToDeps } from './object.js';
 export { chain } from './ra.js';
 export { getInitials, safeText } from './text.js';
 import 'clsx';

package/dist/index.js

@@ -21,9 +21,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   ariaAttr: () => ariaAttr,
+  callAllHandlers: () => callAllHandlers,
   chain: () => chain,
   clamp: () => clamp,
   cn: () => cn,
+  compact: () => compact,
   dataAttr: () => dataAttr,
   getInitials: () => getInitials,
   getUniqueID: () => getUniqueID,
@@ -32,6 +34,8 @@ __export(index_exports, {
   isEmptyArray: () => isEmptyArray,
   isEmptyObject: () => isEmptyObject,
   isObject: () => isObject,
+  mapPropsVariants: () => mapPropsVariants,
+  objectToDeps: () => objectToDeps,
   safeText: () => safeText
 });
 module.exports = __toCommonJS(index_exports);
@@ -70,12 +74,57 @@ function cn(...inputs) {
 function getUniqueID(prefix) {
   return `${prefix}-${Math.floor(Math.random() * 1e6)}`;
 }
+function callAllHandlers(...fns) {
+  return function func(event) {
+    fns.some((fn) => {
+      fn == null ? void 0 : fn(event);
+      return event == null ? void 0 : event.defaultPrevented;
+    });
+  };
+}
 
 // src/numbers.ts
 function clamp(value, min, max) {
   return Math.min(Math.max(value, min), max);
 }
 
+// src/object.ts
+function compact(object) {
+  const clone = Object.assign({}, object);
+  for (const key in clone) {
+    if (clone[key] === void 0) delete clone[key];
+  }
+  return clone;
+}
+var mapPropsVariants = (props, variantKeys, removeVariantProps = true) => {
+  if (!variantKeys) {
+    return [props, {}];
+  }
+  const picked = variantKeys.reduce((acc, key) => {
+    if (key in props) {
+      return { ...acc, [key]: props[key] };
+    } else {
+      return acc;
+    }
+  }, {});
+  if (removeVariantProps) {
+    const omitted = Object.keys(props).filter((key) => !variantKeys.includes(key)).reduce((acc, key) => ({ ...acc, [key]: props[key] }), {});
+    return [omitted, picked];
+  } else {
+    return [props, picked];
+  }
+};
+function objectToDeps(obj) {
+  if (!obj || typeof obj !== "object") {
+    return "";
+  }
+  try {
+    return JSON.stringify(obj);
+  } catch {
+    return "";
+  }
+}
+
 // src/ra.ts
 function chain(...callbacks) {
   return (...args) => {
@@ -104,9 +153,11 @@ var getInitials = (text) => {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ariaAttr,
+  callAllHandlers,
   chain,
   clamp,
   cn,
+  compact,
   dataAttr,
   getInitials,
   getUniqueID,
@@ -115,5 +166,7 @@ var getInitials = (text) => {
   isEmptyArray,
   isEmptyObject,
   isObject,
+  mapPropsVariants,
+  objectToDeps,
   safeText
 });

package/dist/index.mjs

@@ -32,12 +32,57 @@ function cn(...inputs) {
 function getUniqueID(prefix) {
   return `${prefix}-${Math.floor(Math.random() * 1e6)}`;
 }
+function callAllHandlers(...fns) {
+  return function func(event) {
+    fns.some((fn) => {
+      fn == null ? void 0 : fn(event);
+      return event == null ? void 0 : event.defaultPrevented;
+    });
+  };
+}
 
 // src/numbers.ts
 function clamp(value, min, max) {
   return Math.min(Math.max(value, min), max);
 }
 
+// src/object.ts
+function compact(object) {
+  const clone = Object.assign({}, object);
+  for (const key in clone) {
+    if (clone[key] === void 0) delete clone[key];
+  }
+  return clone;
+}
+var mapPropsVariants = (props, variantKeys, removeVariantProps = true) => {
+  if (!variantKeys) {
+    return [props, {}];
+  }
+  const picked = variantKeys.reduce((acc, key) => {
+    if (key in props) {
+      return { ...acc, [key]: props[key] };
+    } else {
+      return acc;
+    }
+  }, {});
+  if (removeVariantProps) {
+    const omitted = Object.keys(props).filter((key) => !variantKeys.includes(key)).reduce((acc, key) => ({ ...acc, [key]: props[key] }), {});
+    return [omitted, picked];
+  } else {
+    return [props, picked];
+  }
+};
+function objectToDeps(obj) {
+  if (!obj || typeof obj !== "object") {
+    return "";
+  }
+  try {
+    return JSON.stringify(obj);
+  } catch {
+    return "";
+  }
+}
+
 // src/ra.ts
 function chain(...callbacks) {
   return (...args) => {
@@ -65,9 +110,11 @@ var getInitials = (text) => {
 };
 export {
   ariaAttr,
+  callAllHandlers,
   chain,
   clamp,
   cn,
+  compact,
   dataAttr,
   getInitials,
   getUniqueID,
@@ -76,5 +123,7 @@ export {
   isEmptyArray,
   isEmptyObject,
   isObject,
+  mapPropsVariants,
+  objectToDeps,
   safeText
 };

package/dist/object.d.mts

@@ -0,0 +1,23 @@
+/** biome-ignore-all lint/suspicious/noExplicitAny: utility file */
+/** biome-ignore-all lint/complexity/noBannedTypes: utility file */
+/** biome-ignore-all lint/performance/noAccumulatingSpread: utility file */
+type Extractable = {
+    [key: string]: any;
+} | undefined;
+declare function compact<T extends Record<any, any>>(object: T): {} & T;
+declare const mapPropsVariants: <T extends Record<string, any>, K extends keyof T>(props: T, variantKeys?: K[], removeVariantProps?: boolean) => readonly [Omit<T, K> | T, Pick<T, K> | {}];
+/**
+ * Converts an object into a JSON string. Returns an empty string if the object
+ * is not extractable or if a circular reference is detected during stringification.
+ *
+ * @param obj - The object to convert into a dependency string.
+ *
+ * @returns A JSON string representation of the object or an empty string if conversion fails.
+ *
+ * @example
+ * objectToDeps({ key: 'value' }); // returns '{"key":"value"}'
+ * objectToDeps(undefined); // returns ""
+ */
+declare function objectToDeps(obj: Extractable): string;
+
+export { compact, mapPropsVariants, objectToDeps };

package/dist/object.d.ts

@@ -0,0 +1,23 @@
+/** biome-ignore-all lint/suspicious/noExplicitAny: utility file */
+/** biome-ignore-all lint/complexity/noBannedTypes: utility file */
+/** biome-ignore-all lint/performance/noAccumulatingSpread: utility file */
+type Extractable = {
+    [key: string]: any;
+} | undefined;
+declare function compact<T extends Record<any, any>>(object: T): {} & T;
+declare const mapPropsVariants: <T extends Record<string, any>, K extends keyof T>(props: T, variantKeys?: K[], removeVariantProps?: boolean) => readonly [Omit<T, K> | T, Pick<T, K> | {}];
+/**
+ * Converts an object into a JSON string. Returns an empty string if the object
+ * is not extractable or if a circular reference is detected during stringification.
+ *
+ * @param obj - The object to convert into a dependency string.
+ *
+ * @returns A JSON string representation of the object or an empty string if conversion fails.
+ *
+ * @example
+ * objectToDeps({ key: 'value' }); // returns '{"key":"value"}'
+ * objectToDeps(undefined); // returns ""
+ */
+declare function objectToDeps(obj: Extractable): string;
+
+export { compact, mapPropsVariants, objectToDeps };

package/dist/object.js

@@ -0,0 +1,68 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/object.ts
+var object_exports = {};
+__export(object_exports, {
+  compact: () => compact,
+  mapPropsVariants: () => mapPropsVariants,
+  objectToDeps: () => objectToDeps
+});
+module.exports = __toCommonJS(object_exports);
+function compact(object) {
+  const clone = Object.assign({}, object);
+  for (const key in clone) {
+    if (clone[key] === void 0) delete clone[key];
+  }
+  return clone;
+}
+var mapPropsVariants = (props, variantKeys, removeVariantProps = true) => {
+  if (!variantKeys) {
+    return [props, {}];
+  }
+  const picked = variantKeys.reduce((acc, key) => {
+    if (key in props) {
+      return { ...acc, [key]: props[key] };
+    } else {
+      return acc;
+    }
+  }, {});
+  if (removeVariantProps) {
+    const omitted = Object.keys(props).filter((key) => !variantKeys.includes(key)).reduce((acc, key) => ({ ...acc, [key]: props[key] }), {});
+    return [omitted, picked];
+  } else {
+    return [props, picked];
+  }
+};
+function objectToDeps(obj) {
+  if (!obj || typeof obj !== "object") {
+    return "";
+  }
+  try {
+    return JSON.stringify(obj);
+  } catch {
+    return "";
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  compact,
+  mapPropsVariants,
+  objectToDeps
+});

package/dist/object.mjs

@@ -0,0 +1,41 @@
+// src/object.ts
+function compact(object) {
+  const clone = Object.assign({}, object);
+  for (const key in clone) {
+    if (clone[key] === void 0) delete clone[key];
+  }
+  return clone;
+}
+var mapPropsVariants = (props, variantKeys, removeVariantProps = true) => {
+  if (!variantKeys) {
+    return [props, {}];
+  }
+  const picked = variantKeys.reduce((acc, key) => {
+    if (key in props) {
+      return { ...acc, [key]: props[key] };
+    } else {
+      return acc;
+    }
+  }, {});
+  if (removeVariantProps) {
+    const omitted = Object.keys(props).filter((key) => !variantKeys.includes(key)).reduce((acc, key) => ({ ...acc, [key]: props[key] }), {});
+    return [omitted, picked];
+  } else {
+    return [props, picked];
+  }
+};
+function objectToDeps(obj) {
+  if (!obj || typeof obj !== "object") {
+    return "";
+  }
+  try {
+    return JSON.stringify(obj);
+  } catch {
+    return "";
+  }
+}
+export {
+  compact,
+  mapPropsVariants,
+  objectToDeps
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kopexa/shared-utils",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "A set of kopexa shared utilities",
   "keywords": [
     "system"