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

package/dist/cjs/matchers/typeChecks.js

@@ -0,0 +1,127 @@
+'use strict';
+
+var _typeof = require('@babel/runtime/helpers/typeof');
+var nullChecks = require('./nullChecks.js');
+
+/**
+ * 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.
+ */
+function isObject(val) {
+  return !nullChecks.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.
+ */
+function isArray(val) {
+  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.
+ */
+function isString(value) {
+  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.
+ */
+function isNumber(value) {
+  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'
+ */
+function isBoolean(value) {
+  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)
+ */
+function isTrue() {
+  var value = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : "";
+  return value === true || value === 1 || (value === null || value === void 0 ? void 0 : value.toString().toLowerCase()) === "yes" || (value === null || value === void 0 ? void 0 : 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)
+ */
+function isFalse() {
+  var value = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : "";
+  return value === false || value === 0 || (value === null || value === void 0 ? void 0 : value.toString().toLowerCase()) === "no" || (value === null || value === void 0 ? void 0 : 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.
+ */
+function isColor(color) {
+  var _color$startsWith, _color$startsWith2, _color$startsWith3, _color$startsWith4;
+  return ((_color$startsWith = color.startsWith) === null || _color$startsWith === void 0 ? void 0 : _color$startsWith.call(color, "#")) || ((_color$startsWith2 = color.startsWith) === null || _color$startsWith2 === void 0 ? void 0 : _color$startsWith2.call(color, "rgb")) || ((_color$startsWith3 = color.startsWith) === null || _color$startsWith3 === void 0 ? void 0 : _color$startsWith3.call(color, "hsl")) || ((_color$startsWith4 = color.startsWith) === null || _color$startsWith4 === void 0 ? void 0 : _color$startsWith4.call(color, "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.
+ */
+function isSvgPath(value) {
+  return typeof value === "string" && value.match(/^[Mm][\d.].*[\dzZ]$/) !== null;
+}
+
+exports.isArray = isArray;
+exports.isBoolean = isBoolean;
+exports.isColor = isColor;
+exports.isFalse = isFalse;
+exports.isNumber = isNumber;
+exports.isObject = isObject;
+exports.isString = isString;
+exports.isSvgPath = isSvgPath;
+exports.isTrue = isTrue;

package/dist/cjs/strings/ascii.js

@@ -0,0 +1,105 @@
+'use strict';
+
+var isEmpty = require('../matchers/isEmpty.js');
+
+/**
+ * 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 */
+
+/** ***************** 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: "ƒ"
+};
+
+/**
+ * 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.
+ */
+function ascii(str) {
+  if (isEmpty.isEmpty(str)) return "";
+  Object.entries(conversions).forEach(function (entry) {
+    var re = new RegExp(entry[1], "g");
+    str = "".concat(str).replace(re, entry[0]);
+  });
+  return str;
+}
+
+exports.ascii = ascii;

package/dist/cjs/strings/hash.js

@@ -0,0 +1,75 @@
+'use strict';
+
+var isEmpty = require('../matchers/isEmpty.js');
+
+/**
+ * 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.
+ */
+
+
+/**
+ * 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.
+ */
+function hash(str) {
+  var hash = 0;
+  var i;
+  var chr;
+  if (isEmpty.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.
+ */
+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.
+ */
+function uuid() {
+  return [1e7, 1e3, 4e3, 8e3, 1e11].join("-").replace(/[018]/g, function (c) {
+    return (+c ^ Math.random() * 16 & 15 >> +c / 4).toString(16);
+  });
+}
+
+exports.hash = hash;
+exports.shortHash = shortHash;
+exports.uuid = uuid;

package/dist/cjs/strings/interpolate.js

@@ -0,0 +1,47 @@
+'use strict';
+
+var getByPath = require('../lists/getByPath.js');
+
+/**
+ * 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.
+ */
+
+
+/**
+ * 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.
+ */
+function interpolate(str, model) {
+  return str.replace(/\${([^{}]*)}/g, function (a, b) {
+    var r = getByPath.getByPath(model, b);
+    return typeof r === "string" || typeof r === "number" ? "".concat(r) : "";
+  });
+}
+
+exports.interpolate = interpolate;

package/dist/cjs/strings/matchString.js

@@ -0,0 +1,54 @@
+'use strict';
+
+var ascii = require('./ascii.js');
+
+/**
+ * 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.
+ */
+
+
+/**
+ * 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.
+ */
+function matchString(base, match) {
+  var equality = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+  var _base = ascii.ascii(base).toLowerCase();
+  var _match = ascii.ascii(match).toLowerCase();
+  return equality === true ? _base === _match : equality === "start" ? _base.startsWith(_match) : _base.includes(_match);
+}
+
+exports.matchString = matchString;

package/dist/cjs/strings/template.js

@@ -0,0 +1,48 @@
+'use strict';
+
+var getByPath = require('../lists/getByPath.js');
+
+/**
+ * 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.
+ */
+
+
+/**
+ * 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.
+ */
+function renderTemplate(str, model) {
+  return str.replace(/{{([^{}]*)}}/g, function (a, b) {
+    var r = getByPath.getByPath(model, b);
+    return typeof r === "string" || typeof r === "number" ? "".concat(r) : "";
+  });
+}
+
+exports.renderTemplate = renderTemplate;

package/dist/cjs/strings/tokenize.js

@@ -0,0 +1,83 @@
+'use strict';
+
+var isEmpty = require('../matchers/isEmpty.js');
+var typeChecks = require('../matchers/typeChecks.js');
+
+/**
+ * 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.
+ */
+
+
+/**
+ * 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].
+ */
+function tokenize(str, keywords) {
+  if (isEmpty.isEmpty(keywords)) {
+    return [[str, ""]];
+  }
+  var keys = typeChecks.isArray(keywords) ? keywords : [keywords];
+  var keyMap = keys.map(function (key) {
+    // escape regex control characters
+    var 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".concat(escapedKey);
+    if (key.match(/[a-z0-9]$/i) != null) escapedKey = "".concat(escapedKey, "\\b");
+    return escapedKey;
+  });
+  var regx = new RegExp("(".concat(keyMap.join("|"), ")"), "img");
+  var match;
+  var lastIndex = 0;
+  var 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.
+ */
+function iconToken(str) {
+  var split = str.trim().split(" ");
+  var first = split[0];
+  var last = split.length > 1 && split.pop();
+  return (first && last ? "".concat(first.charAt(0)).concat(last.charAt(0)) : "".concat(first.substring(0, 2))).toUpperCase();
+}
+
+exports.iconToken = iconToken;
+exports.tokenize = tokenize;

package/dist/cjs/utils/mergeRefs.js

@@ -0,0 +1,56 @@
+'use strict';
+
+var _typeof = require('@babel/runtime/helpers/typeof');
+
+/**
+ * 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.
+ */
+function mergeRefs() {
+  for (var _len = arguments.length, refs = new Array(_len), _key = 0; _key < _len; _key++) {
+    refs[_key] = arguments[_key];
+  }
+  return function (el) {
+    refs.forEach(function (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;
+    });
+  };
+}
+
+exports.mergeRefs = mergeRefs;

package/dist/esm/css/boundingBox.js

@@ -0,0 +1,71 @@
+'use client';
+
+import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
+import { isEmpty } from '../matchers/isEmpty.js';
+
+function _getBox(box) {
+  var boundingBox;
+  if (isEmpty(box)) return [0, 0, 0, 0];
+  if (typeof box === "string") {
+    boundingBox = box.split(",").map(function (b) {
+      return parseInt(b, 10);
+    });
+  } else {
+    boundingBox = box;
+  }
+  return boundingBox;
+}
+
+/**
+ * Get box dimensions from a string or array.
+ * The box can be in the format "x,y,w,h" or [x,y,w,h].
+ * The box is adjusted to ensure that x and y are non-negative.
+ * The width and height are adjusted accordingly.
+ *
+ * @param box "x,y,w,h" | [x,y,w,h]
+ * @returns canvas box [x,y,w,h]
+ */
+function getBox() {
+  var box = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : "0,0,0,0";
+  var boundingBox = _getBox(box);
+  var _boundingBox = _slicedToArray(boundingBox, 4),
+    x = _boundingBox[0],
+    y = _boundingBox[1],
+    w = _boundingBox[2],
+    h = _boundingBox[3];
+  w = x < 0 ? w + x : w;
+  h = y < 0 ? h + y : h;
+  x = x > 0 ? x : 0;
+  y = y > 0 ? y : 0;
+  return [x, y, w, h];
+}
+
+/**
+ * Get bounding box dimensions from a string or array.
+ * The box can be in the format "x1,y1,x2,y2" or [x1,y1,x2,y2].
+ * The box is adjusted to ensure that x1 and y1 are non-negative.
+ * The width and height are calculated as x2 - x1 and y2 - y1 respectively.
+ * If x1 or y1 are negative, they are set to 0 and the width and height are adjusted accordingly.
+ * This is useful for ensuring that the bounding box is always within the canvas area.
+ *
+ * @param box "x1,y1,x2,y2" | [x1,y1,x2,y2]
+ * @returns canvas box [x,y,w,h]
+ */
+function getBoundingBox() {
+  var box = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : "0,0,0,0";
+  var boundingBox = _getBox(box);
+
+  // eslint-disable-next-line prefer-const
+  var _boundingBox2 = _slicedToArray(boundingBox, 4),
+    x1 = _boundingBox2[0],
+    y1 = _boundingBox2[1],
+    x2 = _boundingBox2[2],
+    y2 = _boundingBox2[3];
+  var w = x2 - x1;
+  var h = y2 - y1;
+  x1 = x1 > 0 ? x1 : 0;
+  y1 = y1 > 0 ? y1 : 0;
+  return [x1, y1, w, h];
+}
+
+export { getBoundingBox, getBox };