@react-fabric/utilities 1.0.0-beta.8 → 1.0.1

package/src/matchers/typeChecks.ts

@@ -0,0 +1,146 @@
+/**
+ * React Fabric
+ * @version 1.0.0
+ * @license MIT
+ * @copyright 2024 Adarsh Pastakia
+ *
+ * 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.
+ */
+
+import { isNil } from "./nullChecks";
+
+/**
+ * Check if a value is an object.
+ * An object is considered valid if it is:
+ * - not null or undefined
+ * - not a Date instance
+ * - of type 'object'
+ * - not an array
+ * @param val - The value to check.
+ * @returns true if the value is an object, false otherwise.
+ */
+export function isObject<T = KeyValue>(val: AnyObject): val is T {
+  return !isNil(val) && !(val instanceof Date) && typeof val === "object" && !Array.isArray(val);
+}
+
+/**
+ * Check if a value is an array.
+ * An array is considered valid if it is:
+ * - not null or undefined
+ * - an instance of Array
+ * @param val - The value to check.
+ * @returns true if the value is an array, false otherwise.
+ */
+export function isArray<T = AnyObject>(val: AnyObject): val is T[] {
+  return Array.isArray(val);
+}
+
+/**
+ * Check if a value is a string.
+ * A string is considered valid if it is:
+ * - not null or undefined
+ * - of type 'string'
+ * @param value - The value to check.
+ * @returns true if the value is a string, false otherwise.
+ */
+export function isString(value: AnyObject): value is string {
+  return typeof value === "string";
+}
+
+/**
+ * Check if a value is a number.
+ * A number is considered valid if it is:
+ * - not null or undefined
+ * - of type 'number'
+ * @param value - The value to check.
+ * @returns true if the value is a number, false otherwise.
+ */
+export function isNumber(value: AnyObject): value is number {
+  return typeof value === "number";
+}
+
+/**
+ * Check if a value is a boolean.
+ * A boolean is considered valid if it is:
+ * - not null or undefined
+ * - of type 'boolean'
+ */
+export function isBoolean(value: AnyObject): value is boolean {
+  return typeof value === "boolean";
+}
+
+/**
+ * Check if a value is a true.
+ * A value is considered true if it is:
+ * - strictly equal to true
+ * - equal to 1
+ * - a string that is "yes" or "true" (case insensitive)
+ */
+export function isTrue(value: unknown = ""): value is true {
+  return (
+    value === true || value === 1 || value?.toString().toLowerCase() === "yes" || value?.toString().toLowerCase() === "true"
+  );
+}
+
+/**
+ * Check if a value is false.
+ * A value is considered false if it is:
+ * - strictly equal to false
+ * - equal to 0
+ * - a string that is "no" or "false" (case insensitive)
+ */
+export function isFalse(value: unknown = ""): value is false {
+  return (
+    value === false || value === 0 || value?.toString().toLowerCase() === "no" || value?.toString().toLowerCase() === "false"
+  );
+}
+
+/**
+ * Check if a value is a valid color.
+ * A color is considered valid if it:
+ * - starts with a '#' (hex color)
+ * - starts with 'rgb' (RGB color)
+ * - starts with 'hsl' (HSL color)
+ * - starts with 'lab' (Lab color)
+ * - is equal to 'transparent'
+ * @param color - The value to check.
+ * @returns true if the value is a valid color, false otherwise.
+ */
+export function isColor(color: string) {
+  return (
+    color.startsWith?.("#") ||
+    color.startsWith?.("rgb") ||
+    color.startsWith?.("hsl") ||
+    color.startsWith?.("lab") ||
+    color === "transparent"
+  );
+}
+
+/**
+ * Check if a value is a valid SVG path.
+ * A valid SVG path is a string that:
+ * - starts with 'M' or 'm' (move to command)
+ * - contains at least one digit or decimal point
+ * - ends with 'Z' or 'z' (close path command)
+ * @param value - The value to check.
+ * @returns true if the value is a valid SVG path, false otherwise.
+ */
+export function isSvgPath(value: AnyObject): boolean {
+  return typeof value === "string" && value.match(/^[Mm][\d.].*[\dzZ]$/) !== null;
+}

package/src/strings/ascii.ts

@@ -0,0 +1,100 @@
+/**
+ * React Fabric
+ * @version 1.0.0
+ * @license MIT
+ * @copyright 2024 Adarsh Pastakia
+ *
+ * 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.
+ */
+
+import { isEmpty } from "../matchers/isEmpty";
+
+/* istanbul ignore file */
+
+/** ***************** latin-ascii conversions *******************/
+const conversions = {
+  AE: "Æ|Ǽ",
+  Ae: "Ä",
+  ae: "ä|æ|ǽ",
+  OE: "Œ",
+  Oe: "Ö",
+  oe: "ö|œ",
+  Ue: "Ü",
+  ue: "ü",
+  IJ: "IJ",
+  ij: "ij",
+  ss: "ß",
+  A: "À|Á|Â|Ã|Ä|Å|Ǻ|Ā|Ă|Ą|Ǎ",
+  a: "à|á|â|ã|å|ǻ|ā|ă|ą|ǎ|ª",
+  C: "Ç|Ć|Ĉ|Ċ|Č",
+  c: "ç|ć|ĉ|ċ|č",
+  D: "Ð|Ď|Đ",
+  d: "ð|ď|đ",
+  E: "È|É|Ê|Ë|Ē|Ĕ|Ė|Ę|Ě",
+  e: "è|é|ê|ë|ē|ĕ|ė|ę|ě",
+  G: "Ĝ|Ğ|Ġ|Ģ",
+  g: "ĝ|ğ|ġ|ģ",
+  H: "Ĥ|Ħ",
+  h: "ĥ|ħ",
+  I: "Ì|Í|Î|Ï|Ĩ|Ī|Ĭ|Ǐ|Į|İ",
+  i: "ì|í|î|ï|ĩ|ī|ĭ|ǐ|į|ı",
+  J: "Ĵ",
+  j: "ĵ",
+  K: "Ķ",
+  k: "ķ",
+  L: "Ĺ|Ļ|Ľ|Ŀ|Ł",
+  l: "ĺ|ļ|ľ|ŀ|ł",
+  N: "Ñ|Ń|Ņ|Ň",
+  n: "ñ|ń|ņ|ň|ʼn",
+  O: "Ò|Ó|Ô|Õ|Ō|Ŏ|Ǒ|Ő|Ơ|Ø|Ǿ",
+  o: "ò|ó|ô|õ|ō|ŏ|ǒ|ő|ơ|ø|ǿ|º",
+  R: "Ŕ|Ŗ|Ř",
+  r: "ŕ|ŗ|ř",
+  S: "Ś|Ŝ|Ş|Š",
+  s: "ś|ŝ|ş|š|ſ",
+  T: "Ţ|Ť|Ŧ",
+  t: "ţ|ť|ŧ",
+  U: "Ù|Ú|Û|Ũ|Ū|Ŭ|Ů|Ű|Ų|Ư|Ǔ|Ǖ|Ǘ|Ǚ|Ǜ",
+  u: "ù|ú|û|ũ|ū|ŭ|ů|ű|ų|ư|ǔ|ǖ|ǘ|ǚ|ǜ",
+  Y: "Ý|Ÿ|Ŷ",
+  y: "ý|ÿ|ŷ",
+  W: "Ŵ",
+  w: "ŵ",
+  Z: "Ź|Ż|Ž",
+  z: "ź|ż|ž",
+  f: "ƒ",
+};
+
+/**
+ * Converts a string to its ASCII representation by replacing
+ * special characters with their ASCII equivalents.
+ * This function is useful for normalizing strings for search or display purposes.
+ * It replaces characters like "Ä" with "Ae", "ß" with "ss", etc.
+ *
+ * @param {string} str - The input string to be converted.
+ * @returns {string} - The ASCII representation of the input string.
+ */
+export function ascii(str: string) {
+  if (isEmpty(str)) return "";
+  Object.entries(conversions).forEach((entry) => {
+    const re = new RegExp(entry[1], "g");
+    str = `${str}`.replace(re, entry[0]);
+  });
+  return str;
+}

package/src/strings/hash.ts

@@ -0,0 +1,68 @@
+/**
+ * React Fabric
+ * @version 1.0.0
+ * @license MIT
+ * @copyright 2024 Adarsh Pastakia
+ *
+ * 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.
+ */
+
+import { isEmpty } from "../matchers/isEmpty";
+
+/**
+ * Generate a hash from a string.
+ * This function computes a simple hash by iterating over each character in the string,
+ * performing bitwise operations to produce a 32-bit integer hash.
+ * @param str
+ * @returns {number} A 32-bit integer hash of the input string.
+ */
+export function hash(str: string) {
+  let hash = 0;
+  let i;
+  let chr;
+  if (isEmpty(str)) return hash;
+  for (i = 0; i < str.length; i++) {
+    chr = str.charCodeAt(i);
+    hash = (hash << 5) - hash + chr;
+    hash |= 0; // Convert to 32bit integer
+  }
+  return hash;
+}
+
+/**
+ * Generate a short hash using the current timestamp and a random number.
+ * This function creates a unique identifier by combining the current time in milliseconds
+ * with a random number, and then converting it to a base-36 string.
+ * @returns {string} A short hash string.
+ */
+export function shortHash() {
+  return (new Date().getTime() * Math.random()).toString(36);
+}
+
+/**
+ * Generate a UUID (Universally Unique Identifier).
+ * This function creates a version 4 UUID by generating random numbers
+ * and formatting them according to the UUID standard.
+ * @returns {string} A UUID string in the format xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx.
+ */
+export function uuid() {
+  return [1e7, 1e3, 4e3, 8e3, 1e11]
+    .join("-")
+    .replace(/[018]/g, (c: string) => (+c ^ ((Math.random() * 16) & (15 >> (+c / 4)))).toString(16));
+}

package/src/strings/interpolate.ts

@@ -0,0 +1,42 @@
+/**
+ * React Fabric
+ * @version 1.0.0
+ * @license MIT
+ * @copyright 2024 Adarsh Pastakia
+ *
+ * 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.
+ */
+
+import { getByPath } from "../lists/getByPath";
+
+/**
+ * Interpolate a string with values from a model.
+ * This function replaces placeholders in the format ${key} with corresponding values from the model object.
+ * If the value is not a string or number, it returns an empty string.
+ *
+ * @param {string} str - The string to interpolate.
+ * @param {KeyValue} model - The model object containing key-value pairs for interpolation.
+ * @returns {string} The interpolated string with placeholders replaced by values from the model.
+ */
+export function interpolate(str: string, model: KeyValue) {
+  return str.replace(/\${([^{}]*)}/g, (a: string, b: string): string => {
+    const r = getByPath(model, b);
+    return typeof r === "string" || typeof r === "number" ? `${r}` : "";
+  });
+}

package/src/strings/matchString.ts

@@ -0,0 +1,49 @@
+/**
+ * React Fabric
+ * @version 1.0.0
+ * @license MIT
+ * @copyright 2024 Adarsh Pastakia
+ *
+ * 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.
+ */
+
+import { ascii } from "./ascii";
+
+/**
+ * Match a string against another string with options for equality.
+ * This function checks if the base string starts with, includes, or is equal to the match string,
+ * based on the specified equality condition.
+ * It normalizes both strings to lowercase and ASCII format before comparison.
+ * This is useful for case-insensitive and ASCII-only comparisons,
+ * such as when filtering or searching through text data.
+ *
+ * @param {string} base - The base string to match against.
+ * @param {string} match - The string to match with the base string.
+ * @param {("start" | boolean)} equality - The type of match to perform:
+ *                   - "start": checks if the base string starts with the match string.
+ *                   - true: checks for exact equality.
+ *                   - false (default): checks if the base string includes the match string.
+ * @returns {boolean} - Returns true if the base string matches the conditions specified by the match string and equality.
+ */
+export function matchString(base: string, match: string, equality: "start" | boolean = false) {
+  const _base = ascii(base).toLowerCase();
+  const _match = ascii(match).toLowerCase();
+
+  return equality === true ? _base === _match : equality === "start" ? _base.startsWith(_match) : _base.includes(_match);
+}

package/src/strings/template.ts

@@ -0,0 +1,43 @@
+/**
+ * React Fabric
+ * @version 1.0.0
+ * @license MIT
+ * @copyright 2024 Adarsh Pastakia
+ *
+ * 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.
+ */
+
+import { getByPath } from "../lists/getByPath";
+
+/**
+ * Render a template string with values from a model.
+ * This function replaces placeholders in the format {{key}} with corresponding values from the model object.
+ * If the value is not a string or number, it returns an empty string.
+ * This is similar to the interpolate function but for handlebar templates.
+ *
+ * @param {string} str - The template string to render.
+ * @param {KeyValue} model - The model object containing key-value pairs for rendering the template.
+ * @returns {string} The rendered template string with placeholders replaced by values from the model.
+ */
+export function renderTemplate(str: string, model: KeyValue) {
+  return str.replace(/{{([^{}]*)}}/g, (a: string, b: string): string => {
+    const r = getByPath(model, b);
+    return typeof r === "string" || typeof r === "number" ? `${r}` : "";
+  });
+}

package/src/strings/tokenize.ts

@@ -0,0 +1,77 @@
+/**
+ * React Fabric
+ * @version 1.0.0
+ * @license MIT
+ * @copyright 2024 Adarsh Pastakia
+ *
+ * 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.
+ */
+
+import { isEmpty } from "../matchers/isEmpty";
+import { isArray } from "../matchers/typeChecks";
+
+/**
+ * Tokenize a string based on provided keywords.
+ * This function splits the input string into tokens, where each token is an array containing
+ * the substring before the keyword and the keyword itself.
+ * If no keywords are provided, it returns the entire string as a single token.
+ *
+ * @param {string} str - The string to tokenize.
+ * @param {string | string[]} keywords - A string or an array of strings to use as keywords for tokenization.
+ * @returns {Array<[string, string]>} An array of tokens, where each token is an array of [substring, keyword].
+ */
+export function tokenize(str: string, keywords?: string | string[]) {
+  if (isEmpty(keywords)) {
+    return [[str, ""]];
+  }
+  const keys = isArray(keywords) ? keywords : [keywords];
+  const keyMap = keys.map((key) => {
+    // escape regex control characters
+    let escapedKey = key.replace(/([+*.?^$()[\]\\!&|\-=])/gm, "\\$1");
+    // place token within word boundaries if start/end with alpha-numeric
+    if (key.match(/^[a-z0-9]/i) != null) escapedKey = `\\b${escapedKey}`;
+    if (key.match(/[a-z0-9]$/i) != null) escapedKey = `${escapedKey}\\b`;
+    return escapedKey;
+  });
+  const regx = new RegExp(`(${keyMap.join("|")})`, "img");
+  let match;
+  let lastIndex = 0;
+  const tokens = [];
+  while ((match = regx.exec(str)) !== null) {
+    tokens.push([str.substring(lastIndex, match.index), str.substring(match.index, regx.lastIndex)]);
+    lastIndex = regx.lastIndex;
+  }
+  tokens.push([str.substring(lastIndex), ""]);
+  return tokens;
+}
+
+/**
+ * Generate a token from a string.
+ * This function creates a token by taking the first letter of the first word and the first letter of the last word,
+ * or the first two letters of the first word if there is no last word.
+ *
+ * @param {string} str - The string to tokenize.
+ * @returns {string} A string token consisting of the first letters of the first and last words, or the first two letters of the first word.
+ */
+export function iconToken(str: string) {
+  const split = str.trim().split(" ");
+  const first = split[0];
+  const last = split.length > 1 && split.pop();
+  return (first && last ? `${first.charAt(0)}${last.charAt(0)}` : `${first.substring(0, 2)}`).toUpperCase();
+}

package/src/utils/mergeRefs.ts

@@ -0,0 +1,47 @@
+/**
+ * React Fabric
+ * @version 1.0.0
+ * @license MIT
+ * @copyright 2024 Adarsh Pastakia
+ *
+ * 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.
+ */
+
+/* istanbul ignore file */
+
+/**
+ * Merge multiple refs into a single ref callback.
+ * This function allows you to combine multiple refs (either callback refs or React refs)
+ * into a single ref callback that can be used in React components.
+ * This is particularly useful when you want to assign a single element to multiple refs,
+ * such as when using third-party libraries that require refs or when you want to share refs between components.
+ * The function iterates over the provided refs and assigns the element to each ref.
+ *
+ * @param {AnyObject[]} refs - An array of refs to merge.
+ * @returns {function} A function that takes an element and assigns it to all provided refs.
+ */
+export function mergeRefs(...refs: unknown[]) {
+  return (el: unknown) => {
+    refs.forEach((ref) => {
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+      if (typeof ref === "function") ref(el);
+      if (ref && typeof ref === "object" && "current" in ref) ref.current = el;
+    });
+  };
+}

package/src/{yup.ts → utils/yup.ts}

@@ -27,15 +27,15 @@ import * as _yup from "yup";
 
 _yup.setLocale({
   mixed: {
-    default: ({ path, label }) => ({
+    default: ({ path, label }: KeyValue<string>) => ({
       key: "form:yup.invalid",
       values: { path, label },
     }),
-    required: ({ path, label }) => ({
+    required: ({ path, label }: KeyValue<string>) => ({
       key: "form:yup.required",
       values: { path, label },
     }),
-    notType: ({ type, path, label }) => ({
+    notType: ({ type, path, label }: KeyValue<string>) => ({
       key: "form:yup.invalidType",
       values: { type, path, label },
     }),

package/dist/cjs/_ascii.js

@@ -1,76 +0,0 @@
-'use strict';
-
-var _slicedToArray = require('@babel/runtime/helpers/slicedToArray');
-var _isType = require('./_isType.js');
-
-/** ***************** latin-ascii conversions *******************/
-var conversions = {
-  AE: "Æ|Ǽ",
-  Ae: "Ä",
-  ae: "ä|æ|ǽ",
-  OE: "Œ",
-  Oe: "Ö",
-  oe: "ö|œ",
-  Ue: "Ü",
-  ue: "ü",
-  IJ: "IJ",
-  ij: "ij",
-  ss: "ß",
-  A: "À|Á|Â|Ã|Ä|Å|Ǻ|Ā|Ă|Ą|Ǎ",
-  a: "à|á|â|ã|å|ǻ|ā|ă|ą|ǎ|ª",
-  C: "Ç|Ć|Ĉ|Ċ|Č",
-  c: "ç|ć|ĉ|ċ|č",
-  D: "Ð|Ď|Đ",
-  d: "ð|ď|đ",
-  E: "È|É|Ê|Ë|Ē|Ĕ|Ė|Ę|Ě",
-  e: "è|é|ê|ë|ē|ĕ|ė|ę|ě",
-  G: "Ĝ|Ğ|Ġ|Ģ",
-  g: "ĝ|ğ|ġ|ģ",
-  H: "Ĥ|Ħ",
-  h: "ĥ|ħ",
-  I: "Ì|Í|Î|Ï|Ĩ|Ī|Ĭ|Ǐ|Į|İ",
-  i: "ì|í|î|ï|ĩ|ī|ĭ|ǐ|į|ı",
-  J: "Ĵ",
-  j: "ĵ",
-  K: "Ķ",
-  k: "ķ",
-  L: "Ĺ|Ļ|Ľ|Ŀ|Ł",
-  l: "ĺ|ļ|ľ|ŀ|ł",
-  N: "Ñ|Ń|Ņ|Ň",
-  n: "ñ|ń|ņ|ň|ʼn",
-  O: "Ò|Ó|Ô|Õ|Ō|Ŏ|Ǒ|Ő|Ơ|Ø|Ǿ",
-  o: "ò|ó|ô|õ|ō|ŏ|ǒ|ő|ơ|ø|ǿ|º",
-  R: "Ŕ|Ŗ|Ř",
-  r: "ŕ|ŗ|ř",
-  S: "Ś|Ŝ|Ş|Š",
-  s: "ś|ŝ|ş|š|ſ",
-  T: "Ţ|Ť|Ŧ",
-  t: "ţ|ť|ŧ",
-  U: "Ù|Ú|Û|Ũ|Ū|Ŭ|Ů|Ű|Ų|Ư|Ǔ|Ǖ|Ǘ|Ǚ|Ǜ",
-  u: "ù|ú|û|ũ|ū|ŭ|ů|ű|ų|ư|ǔ|ǖ|ǘ|ǚ|ǜ",
-  Y: "Ý|Ÿ|Ŷ",
-  y: "ý|ÿ|ŷ",
-  W: "Ŵ",
-  w: "ŵ",
-  Z: "Ź|Ż|Ž",
-  z: "ź|ż|ž",
-  f: "ƒ"
-};
-
-/**
- * latin to ascii converter for convenient searching
- * @internal
- */
-var ascii = function ascii(str) {
-  if (_isType.isEmpty(str)) return "";
-  Object.entries(conversions).forEach(function (_ref) {
-    var _ref2 = _slicedToArray(_ref, 2),
-      a = _ref2[0],
-      l = _ref2[1];
-    var re = new RegExp(l, "g");
-    str = "".concat(str).replace(re, a);
-  });
-  return str;
-};
-
-exports.ascii = ascii;