@splendidlabz/utils 1.12.0 → 1.13.0

package/dist/cjs/lib/strings/pluralize.cjs

@@ -1,8 +1,6 @@
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -16,25 +14,385 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/lib/strings/pluralize.js
 var pluralize_exports = {};
 __export(pluralize_exports, {
-  pluralize: () => pluralize
+  createPluralize: () => createPluralize,
+  isPlural: () => isPlural,
+  isSingular: () => isSingular,
+  plural: () => plural,
+  pluralize: () => pluralize,
+  singular: () => singular
 });
 module.exports = __toCommonJS(pluralize_exports);
-var import_pluralize = __toESM(require("pluralize"), 1);
-var pluralize = import_pluralize.default;
+function sanitizeRule(rule) {
+  if (typeof rule === "string") return new RegExp("^" + rule + "$", "i");
+  return rule;
+}
+function restoreCase(word, token) {
+  if (word === token) return token;
+  if (word === word.toLowerCase()) return token.toLowerCase();
+  if (word === word.toUpperCase()) return token.toUpperCase();
+  if (word[0] === word[0].toUpperCase()) {
+    return token.charAt(0).toUpperCase() + token.substr(1).toLowerCase();
+  }
+  return token.toLowerCase();
+}
+function interpolate(str, args) {
+  return str.replace(/\$(\d{1,2})/g, (match, index) => args[index] || "");
+}
+function replace(word, rule) {
+  return word.replace(rule[0], function(match, index) {
+    const result = interpolate(rule[1], arguments);
+    if (match === "") return restoreCase(word[index - 1], result);
+    return restoreCase(match, result);
+  });
+}
+function sanitizeWord(token, word, rules, uncountables) {
+  if (!token.length || uncountables.hasOwnProperty(token)) return word;
+  let len = rules.length;
+  while (len--) {
+    const rule = rules[len];
+    if (rule[0].test(word)) return replace(word, rule);
+  }
+  return word;
+}
+function replaceWord(replaceMap, keepMap, rules, uncountables) {
+  return function(word) {
+    const token = word.toLowerCase();
+    if (keepMap.hasOwnProperty(token)) return restoreCase(word, token);
+    if (replaceMap.hasOwnProperty(token)) {
+      return restoreCase(word, replaceMap[token]);
+    }
+    return sanitizeWord(token, word, rules, uncountables);
+  };
+}
+function checkWord(replaceMap, keepMap, rules, uncountables) {
+  return function(word) {
+    const token = word.toLowerCase();
+    if (keepMap.hasOwnProperty(token)) return true;
+    if (replaceMap.hasOwnProperty(token)) return false;
+    return sanitizeWord(token, token, rules, uncountables) === token;
+  };
+}
+var BASE_IRREGULAR = [
+  // Pronouns.
+  ["I", "we"],
+  ["me", "us"],
+  ["he", "they"],
+  ["she", "they"],
+  ["them", "them"],
+  ["myself", "ourselves"],
+  ["yourself", "yourselves"],
+  ["itself", "themselves"],
+  ["herself", "themselves"],
+  ["himself", "themselves"],
+  ["themself", "themselves"],
+  ["is", "are"],
+  ["was", "were"],
+  ["has", "have"],
+  ["this", "these"],
+  ["that", "those"],
+  // Words ending with a consonant and `o`.
+  ["echo", "echoes"],
+  ["dingo", "dingoes"],
+  ["volcano", "volcanoes"],
+  ["tornado", "tornadoes"],
+  ["torpedo", "torpedoes"],
+  // Ends with `us`.
+  ["genus", "genera"],
+  ["viscus", "viscera"],
+  // Ends with `ma`.
+  ["stigma", "stigmata"],
+  ["stoma", "stomata"],
+  ["dogma", "dogmata"],
+  ["lemma", "lemmata"],
+  ["schema", "schemata"],
+  ["anathema", "anathemata"],
+  // Other irregular rules.
+  ["ox", "oxen"],
+  ["axe", "axes"],
+  ["die", "dice"],
+  ["yes", "yeses"],
+  ["foot", "feet"],
+  ["eave", "eaves"],
+  ["goose", "geese"],
+  ["tooth", "teeth"],
+  ["quiz", "quizzes"],
+  ["human", "humans"],
+  ["proof", "proofs"],
+  ["carve", "carves"],
+  ["valve", "valves"],
+  ["looey", "looies"],
+  ["thief", "thieves"],
+  ["groove", "grooves"],
+  ["pickaxe", "pickaxes"],
+  ["passerby", "passersby"]
+];
+var BASE_PLURAL = [
+  [/s?$/i, "s"],
+  // eslint-disable-next-line no-control-regex
+  [/[^\u0000-\u007F]$/i, "$0"],
+  [/([^aeiou]ese)$/i, "$1"],
+  [/(ax|test)is$/i, "$1es"],
+  [/(alias|[^aou]us|t[lm]as|gas|ris)$/i, "$1es"],
+  [/(e[mn]u)s?$/i, "$1s"],
+  [/([^l]ias|[aeiou]las|[ejzr]as|[iu]am)$/i, "$1"],
+  [
+    /(alumn|syllab|vir|radi|nucle|fung|cact|stimul|termin|bacill|foc|uter|loc|strat)(?:us|i)$/i,
+    "$1i"
+  ],
+  [/(alumn|alg|vertebr)(?:a|ae)$/i, "$1ae"],
+  [/(seraph|cherub)(?:im)?$/i, "$1im"],
+  [/(her|at|gr)o$/i, "$1oes"],
+  [
+    /(agend|addend|millenni|dat|extrem|bacteri|desiderat|strat|candelabr|errat|ov|symposi|curricul|automat|quor)(?:a|um)$/i,
+    "$1a"
+  ],
+  [
+    /(apheli|hyperbat|periheli|asyndet|noumen|phenomen|criteri|organ|prolegomen|hedr|automat)(?:a|on)$/i,
+    "$1a"
+  ],
+  [/sis$/i, "ses"],
+  [/(?:(kni|wi|li)fe|(ar|l|ea|eo|oa|hoo)f)$/i, "$1$2ves"],
+  [/([^aeiouy]|qu)y$/i, "$1ies"],
+  [/([^ch][ieo][ln])ey$/i, "$1ies"],
+  [/(x|ch|ss|sh|zz)$/i, "$1es"],
+  [/(matr|cod|mur|sil|vert|ind|append)(?:ix|ex)$/i, "$1ices"],
+  [/\b((?:tit)?m|l)(?:ice|ouse)$/i, "$1ice"],
+  [/(pe)(?:rson|ople)$/i, "$1ople"],
+  [/(child)(?:ren)?$/i, "$1ren"],
+  [/eaux$/i, "$0"],
+  [/m[ae]n$/i, "men"],
+  ["thou", "you"]
+];
+var BASE_SINGULAR = [
+  [/s$/i, ""],
+  [/(ss)$/i, "$1"],
+  [/(wi|kni|(?:after|half|high|low|mid|non|night|[^\w]|^)li)ves$/i, "$1fe"],
+  [/(ar|(?:wo|[ae])l|[eo][ao])ves$/i, "$1f"],
+  [/ies$/i, "y"],
+  [
+    /\b([pl]|zomb|(?:neck|cross)?t|coll|faer|food|gen|goon|group|lass|talk|goal|cut)ies$/i,
+    "$1ie"
+  ],
+  [/\b(mon|smil)ies$/i, "$1ey"],
+  [/\b((?:tit)?m|l)ice$/i, "$1ouse"],
+  [/(seraph|cherub)im$/i, "$1"],
+  [
+    /(x|ch|ss|sh|zz|tto|go|cho|alias|[^aou]us|t[lm]as|gas|(?:her|at|gr)o|[aeiou]ris)(?:es)?$/i,
+    "$1"
+  ],
+  [
+    /(analy|diagno|parenthe|progno|synop|the|empha|cri|ne)(?:sis|ses)$/i,
+    "$1sis"
+  ],
+  [/(movie|twelve|abuse|e[mn]u)s$/i, "$1"],
+  [/(test)(?:is|es)$/i, "$1is"],
+  [
+    /(alumn|syllab|vir|radi|nucle|fung|cact|stimul|termin|bacill|foc|uter|loc|strat)(?:us|i)$/i,
+    "$1us"
+  ],
+  [
+    /(agend|addend|millenni|dat|extrem|bacteri|desiderat|strat|candelabr|errat|ov|symposi|curricul|quor)a$/i,
+    "$1um"
+  ],
+  [
+    /(apheli|hyperbat|periheli|asyndet|noumen|phenomen|criteri|organ|prolegomen|hedr|automat)a$/i,
+    "$1on"
+  ],
+  [/(alumn|alg|vertebr)ae$/i, "$1a"],
+  [/(cod|mur|sil|vert|ind)ices$/i, "$1ex"],
+  [/(matr|append)ices$/i, "$1ix"],
+  [/(pe)(rson|ople)$/i, "$1rson"],
+  [/(child)ren$/i, "$1"],
+  [/(eau)x?$/i, "$1"],
+  [/men$/i, "man"]
+];
+var BASE_UNCOUNTABLE = [
+  // Singular words with no plurals.
+  "adulthood",
+  "advice",
+  "agenda",
+  "aid",
+  "aircraft",
+  "alcohol",
+  "ammo",
+  "analytics",
+  "anime",
+  "athletics",
+  "audio",
+  "bison",
+  "blood",
+  "bream",
+  "buffalo",
+  "butter",
+  "carp",
+  "cash",
+  "chassis",
+  "chess",
+  "clothing",
+  "cod",
+  "commerce",
+  "cooperation",
+  "corps",
+  "debris",
+  "diabetes",
+  "digestion",
+  "elk",
+  "energy",
+  "equipment",
+  "excretion",
+  "expertise",
+  "firmware",
+  "flounder",
+  "fun",
+  "gallows",
+  "garbage",
+  "graffiti",
+  "hardware",
+  "headquarters",
+  "health",
+  "herpes",
+  "highjinks",
+  "homework",
+  "housework",
+  "information",
+  "jeans",
+  "justice",
+  "kudos",
+  "labour",
+  "literature",
+  "machinery",
+  "mackerel",
+  "mail",
+  "media",
+  "mews",
+  "moose",
+  "music",
+  "mud",
+  "manga",
+  "news",
+  "only",
+  "personnel",
+  "pike",
+  "plankton",
+  "pliers",
+  "police",
+  "pollution",
+  "premises",
+  "rain",
+  "research",
+  "rice",
+  "salmon",
+  "scissors",
+  "series",
+  "sewage",
+  "shambles",
+  "shrimp",
+  "software",
+  "species",
+  "staff",
+  "swine",
+  "tennis",
+  "traffic",
+  "transportation",
+  "trout",
+  "tuna",
+  "wealth",
+  "welfare",
+  "whiting",
+  "wildebeest",
+  "wildlife",
+  "you",
+  /pok[eé]mon$/i,
+  // Regexes.
+  /[^aeiou]ese$/i,
+  // "chinese", "japanese"
+  /deer$/i,
+  // "deer", "reindeer"
+  /fish$/i,
+  // "fish", "blowfish", "angelfish"
+  /measles$/i,
+  /o[iu]s$/i,
+  // "carnivorous"
+  /pox$/i,
+  // "chickpox", "smallpox"
+  /sheep$/i
+];
+function createPluralize(config = {}) {
+  const pluralRules = [];
+  const singularRules = [];
+  const uncountables = {};
+  const irregularPlurals = {};
+  const irregularSingles = {};
+  for (const [single, plur] of [
+    ...BASE_IRREGULAR,
+    ...config.irregular || []
+  ]) {
+    irregularSingles[single.toLowerCase()] = plur.toLowerCase();
+    irregularPlurals[plur.toLowerCase()] = single.toLowerCase();
+  }
+  for (const [rule, replacement] of [...BASE_PLURAL, ...config.plural || []]) {
+    pluralRules.push([sanitizeRule(rule), replacement]);
+  }
+  for (const [rule, replacement] of [
+    ...BASE_SINGULAR,
+    ...config.singular || []
+  ]) {
+    singularRules.push([sanitizeRule(rule), replacement]);
+  }
+  for (const word of [...BASE_UNCOUNTABLE, ...config.uncountable || []]) {
+    if (typeof word === "string") {
+      uncountables[word.toLowerCase()] = true;
+    } else {
+      pluralRules.push([sanitizeRule(word), "$0"]);
+      singularRules.push([sanitizeRule(word), "$0"]);
+    }
+  }
+  const plural2 = replaceWord(
+    irregularSingles,
+    irregularPlurals,
+    pluralRules,
+    uncountables
+  );
+  const singular2 = replaceWord(
+    irregularPlurals,
+    irregularSingles,
+    singularRules,
+    uncountables
+  );
+  const isPlural2 = checkWord(
+    irregularSingles,
+    irregularPlurals,
+    pluralRules,
+    uncountables
+  );
+  const isSingular2 = checkWord(
+    irregularPlurals,
+    irregularSingles,
+    singularRules,
+    uncountables
+  );
+  function pluralize2(word, count, inclusive) {
+    const out = count === 1 ? singular2(word) : plural2(word);
+    return (inclusive ? count + " " : "") + out;
+  }
+  return Object.assign(pluralize2, { plural: plural2, singular: singular2, isPlural: isPlural2, isSingular: isSingular2 });
+}
+var pluralize = createPluralize();
+var plural = pluralize.plural;
+var singular = pluralize.singular;
+var isPlural = pluralize.isPlural;
+var isSingular = pluralize.isSingular;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  pluralize
+  createPluralize,
+  isPlural,
+  isSingular,
+  plural,
+  pluralize,
+  singular
 });

package/dist/cjs/lib/strings/query-string.cjs

@@ -20,7 +20,6 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var query_string_exports = {};
 __export(query_string_exports, {
   parseQueryString: () => parseQueryString,
-  plural: () => plural,
   stripNumbers: () => stripNumbers,
   toQueryString: () => toQueryString
 });
@@ -56,17 +55,12 @@ function parseQueryString(string = "") {
   }
   return result;
 }
-function plural(count, noun, suffix = "s") {
-  console.warn("plural is deprecated. Use pluralize instead");
-  return `${count} ${noun}${count !== 1 ? suffix : ""}`;
-}
 function stripNumbers(string) {
   return string.replace(/\d*/, "");
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   parseQueryString,
-  plural,
   stripNumbers,
   toQueryString
 });

package/dist/cjs/lib/style/index.cjs

@@ -19,10 +19,43 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/lib/style/index.js
 var style_exports = {};
 __export(style_exports, {
+  scatter: () => scatter,
   toStyleString: () => toStyleString
 });
 module.exports = __toCommonJS(style_exports);
 
+// src/lib/numbers/random.js
+function seededRandom(seed = 1) {
+  let state = seed >>> 0;
+  return () => {
+    state = state * 1664525 + 1013904223 >>> 0;
+    return state / 4294967296;
+  };
+}
+
+// src/lib/style/scatter.js
+var round = (n) => {
+  const value = Math.round(n * 100) / 100;
+  return value === 0 ? 0 : value;
+};
+function scatter(count, options = {}) {
+  const { seed = 1, spread = 20, rotation = 6, amount = 1 } = options;
+  const random = seededRandom(seed);
+  const items = [];
+  for (let i = 0; i < count; i++) {
+    const x = round((random() - 0.5) * 2 * spread * amount);
+    const y = round((random() - 0.5) * 2 * spread * amount);
+    const r = round((random() - 0.5) * 2 * rotation * amount);
+    items.push({
+      x,
+      y,
+      rotation: r,
+      transform: `translate(${x}%, ${y}%) rotate(${r}deg)`
+    });
+  }
+  return items;
+}
+
 // src/lib/strings/convert-case/convert-case.js
 function toKebab(string) {
   if (!string) return "";
@@ -49,7 +82,7 @@ function isDigit(char) {
   return /[0-9]/.test(char);
 }
 
-// src/lib/style/index.js
+// src/lib/style/to-style-string.js
 function toStyleString(style) {
   if (!style) return null;
   if (typeof style === "string") return style;
@@ -60,5 +93,6 @@ function toStyleString(style) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  scatter,
   toStyleString
 });

package/dist/cjs/lib/style/scatter.cjs

@@ -0,0 +1,60 @@
+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/lib/style/scatter.js
+var scatter_exports = {};
+__export(scatter_exports, {
+  scatter: () => scatter
+});
+module.exports = __toCommonJS(scatter_exports);
+
+// src/lib/numbers/random.js
+function seededRandom(seed = 1) {
+  let state = seed >>> 0;
+  return () => {
+    state = state * 1664525 + 1013904223 >>> 0;
+    return state / 4294967296;
+  };
+}
+
+// src/lib/style/scatter.js
+var round = (n) => {
+  const value = Math.round(n * 100) / 100;
+  return value === 0 ? 0 : value;
+};
+function scatter(count, options = {}) {
+  const { seed = 1, spread = 20, rotation = 6, amount = 1 } = options;
+  const random = seededRandom(seed);
+  const items = [];
+  for (let i = 0; i < count; i++) {
+    const x = round((random() - 0.5) * 2 * spread * amount);
+    const y = round((random() - 0.5) * 2 * spread * amount);
+    const r = round((random() - 0.5) * 2 * rotation * amount);
+    items.push({
+      x,
+      y,
+      rotation: r,
+      transform: `translate(${x}%, ${y}%) rotate(${r}deg)`
+    });
+  }
+  return items;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  scatter
+});

package/dist/cjs/lib/style/to-style-string.cjs

@@ -0,0 +1,64 @@
+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/lib/style/to-style-string.js
+var to_style_string_exports = {};
+__export(to_style_string_exports, {
+  toStyleString: () => toStyleString
+});
+module.exports = __toCommonJS(to_style_string_exports);
+
+// src/lib/strings/convert-case/convert-case.js
+function toKebab(string) {
+  if (!string) return "";
+  return string.split("").map((letter, index) => {
+    const previousLetter = string[index - 1] || "";
+    const currentLetter = letter;
+    if (isDigit(currentLetter) && !isDigit(previousLetter)) {
+      return `-${currentLetter}`;
+    }
+    if (!isCaps(currentLetter)) return currentLetter;
+    if (previousLetter === "") {
+      return `${currentLetter.toLowerCase()}`;
+    }
+    if (isCaps(previousLetter)) {
+      return `${currentLetter.toLowerCase()}`;
+    }
+    return `-${currentLetter.toLowerCase()}`;
+  }).join("").trim().replace(/[-_\s]+/g, "-");
+}
+function isCaps(char) {
+  return /\p{Lu}/u.test(char);
+}
+function isDigit(char) {
+  return /[0-9]/.test(char);
+}
+
+// src/lib/style/to-style-string.js
+function toStyleString(style) {
+  if (!style) return null;
+  if (typeof style === "string") return style;
+  return Object.entries(style).map(([k, v]) => {
+    if (k.startsWith("--")) return `${k}:${v}`;
+    else return `${toKebab(k)}:${v}`;
+  }).join("; ").concat(";");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  toStyleString
+});