@splendidlabz/utils 1.12.0 → 1.13.0

package/dist/cjs/lib/strings/index.cjs

@@ -29,11 +29,15 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/lib/strings/index.js
 var strings_exports = {};
 __export(strings_exports, {
+  createPluralize: () => createPluralize,
+  isPlural: () => isPlural,
+  isSingular: () => isSingular,
   markdown: () => markdown,
   parseFullName: () => parseFullName,
   parseQueryString: () => parseQueryString,
   plural: () => plural,
   pluralize: () => pluralize,
+  singular: () => singular,
   stripNumbers: () => stripNumbers,
   toCamel: () => toCamel,
   toKebab: () => toKebab,
@@ -163,8 +167,366 @@ function parseFullName(name) {
 }
 
 // src/lib/strings/pluralize.js
-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;
 
 // src/lib/strings/query-string.js
 function toQueryString(object) {
@@ -198,20 +560,20 @@ 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 = {
+  createPluralize,
+  isPlural,
+  isSingular,
   markdown,
   parseFullName,
   parseQueryString,
   plural,
   pluralize,
+  singular,
   stripNumbers,
   toCamel,
   toKebab,