@kopexa/shared-utils 1.1.4 → 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,8 +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 } from './object.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,8 +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 } from './object.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,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   ariaAttr: () => ariaAttr,
+  callAllHandlers: () => callAllHandlers,
   chain: () => chain,
   clamp: () => clamp,
   cn: () => cn,
@@ -33,6 +34,8 @@ __export(index_exports, {
   isEmptyArray: () => isEmptyArray,
   isEmptyObject: () => isEmptyObject,
   isObject: () => isObject,
+  mapPropsVariants: () => mapPropsVariants,
+  objectToDeps: () => objectToDeps,
   safeText: () => safeText
 });
 module.exports = __toCommonJS(index_exports);
@@ -71,6 +74,14 @@ 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) {
@@ -85,6 +96,34 @@ function compact(object) {
   }
   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) {
@@ -114,6 +153,7 @@ var getInitials = (text) => {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ariaAttr,
+  callAllHandlers,
   chain,
   clamp,
   cn,
@@ -126,5 +166,7 @@ var getInitials = (text) => {
   isEmptyArray,
   isEmptyObject,
   isObject,
+  mapPropsVariants,
+  objectToDeps,
   safeText
 });

package/dist/index.mjs

@@ -32,6 +32,14 @@ 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) {
@@ -46,6 +54,34 @@ function compact(object) {
   }
   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) {
@@ -74,6 +110,7 @@ var getInitials = (text) => {
 };
 export {
   ariaAttr,
+  callAllHandlers,
   chain,
   clamp,
   cn,
@@ -86,5 +123,7 @@ export {
   isEmptyArray,
   isEmptyObject,
   isObject,
+  mapPropsVariants,
+  objectToDeps,
   safeText
 };

package/dist/object.d.mts

@@ -1,4 +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 };
+export { compact, mapPropsVariants, objectToDeps };

package/dist/object.d.ts

@@ -1,4 +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 };
+export { compact, mapPropsVariants, objectToDeps };

package/dist/object.js

@@ -20,7 +20,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/object.ts
 var object_exports = {};
 __export(object_exports, {
-  compact: () => compact
+  compact: () => compact,
+  mapPropsVariants: () => mapPropsVariants,
+  objectToDeps: () => objectToDeps
 });
 module.exports = __toCommonJS(object_exports);
 function compact(object) {
@@ -30,7 +32,37 @@ function compact(object) {
   }
   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
+  compact,
+  mapPropsVariants,
+  objectToDeps
 });

package/dist/object.mjs

@@ -6,6 +6,36 @@ function compact(object) {
   }
   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
+  compact,
+  mapPropsVariants,
+  objectToDeps
 };

package/package.json

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