inferred-types 0.54.3 → 0.54.4

package/modules/runtime/dist/index.js

@@ -2459,235 +2459,6 @@ function ensureTrailing(content, ensure) {
   );
 }
 
-// src/literals/identity.ts
-function identity(...values) {
-  return values.length === 1 ? values[0] : values.length === 0 ? void 0 : values;
-}
-
-// src/literals/ifLowercase.ts
-function ifLowercaseChar(ch, callbackForMatch, callbackForNoMatch) {
-  if (ch.length !== 1) {
-    throw new Error(`call to ifUppercaseChar received ${ch.length} characters but is only valid when one character is passed in!`);
-  }
-  return LOWER_ALPHA_CHARS.includes(ch) ? callbackForMatch(ch) : callbackForNoMatch(ch);
-}
-
-// src/literals/ifUppercase.ts
-function ifUppercaseChar(ch, callbackForMatch, callbackForNoMatch) {
-  if (ch.length !== 1) {
-    throw new Error(`Invalid string length passed to ifUppercaseChar(ch); this function requires a single character but ${ch.length} were received`);
-  }
-  return LOWER_ALPHA_CHARS.includes(ch) ? callbackForMatch(ch) : callbackForNoMatch(ch);
-}
-
-// src/literals/infer.ts
-function parseTemplate(template) {
-  const pattern = /\{\{\s*infer\s+([A-Za-z_]\w*)\s*(?:as\s+(string|number|boolean)\s*)?\}\}/g;
-  let lastIndex = 0;
-  let match;
-  const segments = [];
-  do {
-    match = pattern.exec(template);
-    if (match) {
-      const [fullMatch, varName, asType2] = match;
-      const staticPart = template.slice(lastIndex, match.index);
-      if (staticPart) {
-        segments.push({ dynamic: false, text: staticPart });
-      }
-      segments.push({
-        dynamic: true,
-        varName,
-        type: asType2 ? asType2 : "string"
-      });
-      lastIndex = match.index + fullMatch.length;
-    }
-  } while (match);
-  const remainder = template.slice(lastIndex);
-  if (remainder) {
-    segments.push({ dynamic: false, text: remainder });
-  }
-  return segments;
-}
-function escapeRegex(str) {
-  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function buildRegexPattern(segments) {
-  let regexStr = "^";
-  for (const seg of segments) {
-    if (!seg.dynamic) {
-      regexStr += escapeRegex(seg.text);
-    } else {
-      switch (seg.type) {
-        case "string":
-          regexStr += `(?<${seg.varName}>.*?)`;
-          break;
-        case "number":
-          regexStr += `(?<${seg.varName}>\\d+)`;
-          break;
-        case "boolean":
-          regexStr += `(?<${seg.varName}>(?:true|false))`;
-          break;
-      }
-    }
-  }
-  regexStr += "$";
-  return new RegExp(regexStr, "s");
-}
-function convertValue(type, value) {
-  switch (type) {
-    case "string":
-      return value;
-    case "number":
-      return Number(value);
-    case "boolean":
-      return value === "true";
-  }
-}
-function matchTemplate(inference, test) {
-  const segments = parseTemplate(inference);
-  const regex = buildRegexPattern(segments);
-  const match = test.match(regex);
-  if (!match)
-    return false;
-  const result2 = {};
-  for (const seg of segments) {
-    if (seg.dynamic) {
-      const rawVal = match.groups?.[seg.varName];
-      if (rawVal === void 0)
-        return false;
-      result2[seg.varName.toLowerCase()] = convertValue(seg.type, rawVal);
-    }
-  }
-  return result2;
-}
-function infer(inference) {
-  return (test) => {
-    return matchTemplate(inference, test);
-  };
-}
-
-// src/literals/literal.ts
-function idLiteral(o) {
-  return { ...o, id: o.id };
-}
-function nameLiteral(o) {
-  return o;
-}
-function kindLiteral(o) {
-  return o;
-}
-function idTypeGuard(_o) {
-  return true;
-}
-function literal(obj) {
-  return obj;
-}
-
-// src/literals/lowercase.ts
-function lowercase(str) {
-  return str.toLowerCase();
-}
-
-// src/literals/narrow.ts
-function narrow(...values) {
-  return values.length === 1 ? values[0] : values;
-}
-
-// src/literals/pathJoin.ts
-function pathJoin(...segments) {
-  const clean_path = segments.map((i) => stripTrailing(stripLeading(i, "/"), "/")).join("/");
-  const original_path = segments.join("/");
-  const pre = original_path.startsWith("/") ? "/" : "";
-  const post = original_path.endsWith("/") ? "/" : "";
-  return `${pre}${clean_path}${post}`;
-}
-
-// src/literals/phone/asPhoneNumber.ts
-var asPhoneFormat = () => `NOT IMPLEMENTED`;
-
-// src/literals/phone/getPhoneCountryCode.ts
-function getPhoneCountryCode(phone) {
-  return phone.trim().startsWith("+") || phone.trim().startsWith("00") ? retainWhile(
-    stripLeading(stripLeading(phone.trim(), "+"), "00"),
-    ...NUMERIC_CHAR
-  ) : "";
-}
-
-// src/literals/phone/removePhoneCountryCode.ts
-function removePhoneCountryCode(phone) {
-  const countryCode = getPhoneCountryCode(phone);
-  return countryCode !== "" ? stripLeading(stripLeading(
-    phone.trim(),
-    "+",
-    "00"
-  ), countryCode).trim() : phone.trim();
-}
-
-// src/literals/pluralize.ts
-var isException = (word) => Object.keys(PLURAL_EXCEPTIONS).includes(word);
-function endingIn(word, postfix) {
-  switch (postfix) {
-    case "is":
-      return word.endsWith(postfix) ? `${word}es` : void 0;
-    case "singular-noun":
-      return SINGULAR_NOUN_ENDINGS.some((i) => word.endsWith(i)) ? split(word).every((i) => [...ALPHA_CHARS].includes(i)) ? `${word}es` : void 0 : void 0;
-    case "f":
-      return word.endsWith("f") ? `${stripTrailing(word, "f")}ves` : word.endsWith("fe") ? `${stripTrailing(word, "fe")}ves` : void 0;
-    case "y":
-      return word.endsWith("y") ? `${stripTrailing(word, "y")}ies` : void 0;
-    default:
-      throw new Error(`endingIn received "${postfix}" as a postfix but this ending is not known!`);
-  }
-}
-function pluralize(word) {
-  const right = rightWhitespace(word);
-  const w = word.trimEnd();
-  const result2 = isException(w) ? PLURAL_EXCEPTIONS[w] : endingIn(w, "is") || endingIn(w, "singular-noun") || endingIn(w, "f") || endingIn(w, "y") || `${w}s`;
-  return `${result2}${right}`;
-}
-
-// src/literals/retainAfter.ts
-function retainAfter(content, ...find2) {
-  const idx = Math.min(
-    ...find2.map((i) => content.indexOf(i)).filter((i) => i > -1)
-  );
-  const min = Math.min(...find2.map((i) => i.length));
-  let len = Math.max(...find2.map((i) => i.length));
-  if (min !== len) {
-    if (!find2.includes(content.slice(idx, len))) {
-      len = min;
-    }
-  }
-  return idx && idx > 0 ? content.slice(idx + len) : "";
-}
-function retainAfterInclusive(content, ...find2) {
-  const minFound = Math.min(
-    ...find2.map((i) => content.indexOf(i)).filter((i) => i > -1)
-  );
-  return minFound > 0 ? content.slice(minFound) : "";
-}
-
-// src/type-conversion/asChars.ts
-function asChars(str) {
-  return str.split("");
-}
-
-// src/literals/retainChars.ts
-function retainChars(content, ...retain2) {
-  const chars = asChars(content);
-  return chars.filter((c) => retain2.includes(c)).join("");
-}
-
-// src/type-conversion/asRecord.ts
-function asRecord(obj) {
-  return obj;
-}
-
-// src/type-conversion/asString.ts
-function asString(value) {
-  return isString(value) ? value : isNumber(value) ? `${value}` : isBoolean(value) ? `${value}` : isArray(value) ? value.join("") : String(value);
-}
-
 // src/type-guards/isFunction.ts
 function isFunction(value) {
   return typeof value === "function";
@@ -3019,30 +2790,214 @@ function hasKeys(...props) {
   };
 }
 
-// src/type-guards/hasWhitespace.ts
-function hasWhiteSpace(val) {
-  return isString(val) && asChars(val).some((c) => WHITESPACE_CHARS.includes(c));
-}
-
-// src/type-guards/higher-order/endsWith.ts
-function endsWith(endingIn2) {
-  return (val) => {
-    return isString(val) ? !!val.endsWith(endingIn2) : isNumber(val) ? !!String(val).endsWith(endingIn2) : false;
-  };
+// src/type-conversion/asChars.ts
+function asChars(str) {
+  return str.split("");
 }
 
-// src/type-guards/higher-order/isEqual.ts
-function isEqual(base) {
-  return (value) => isSameTypeOf(base)(value) ? value === base : false;
+// src/type-conversion/asRecord.ts
+function asRecord(obj) {
+  return obj;
 }
 
-// src/type-guards/higher-order/isLength.ts
-function isLength(value, len) {
-  return isArray(value) ? !!isEqual(value.length)(len) : isString(value) ? !!isEqual(value.length)(len) : isObject(value) ? !!isEqual(keysOf(value))(len) : false;
+// src/type-conversion/asString.ts
+function asString(value) {
+  return isString(value) ? value : isNumber(value) ? `${value}` : isBoolean(value) ? `${value}` : isArray(value) ? value.join("") : String(value);
 }
 
-// src/type-guards/higher-order/isSameTypeOf.ts
-function isSameTypeOf(base) {
+// src/type-conversion/csv.ts
+function csv(csv2, format = `string-numeric-tuple`) {
+  const tuple3 = [];
+  csv2.split(/,\s?/).forEach((v) => {
+    tuple3.push(
+      format === "string-numeric-tuple" ? isNumberLike(v) ? Number(v) : v : format === "json-tuple" ? isNumberLike(v) ? Number(v) : v === "true" ? true : v === "false" ? false : `"${v}"` : format === "string-tuple" ? `${v}` : Never
+    );
+  });
+  return tuple3;
+}
+
+// src/type-conversion/intersect.ts
+function intersect(value, _intersectedWith) {
+  return value;
+}
+
+// src/literals/stripTrailing.ts
+function stripTrailing(content, ...strip2) {
+  let output = String(content);
+  for (const s of strip2) {
+    if (output.endsWith(String(s))) {
+      output = output.slice(0, -1 * String(s).length);
+    }
+  }
+  return isNumber(content) ? Number(output) : output;
+}
+
+// src/type-conversion/ip6GroupExpansion.ts
+function ip6GroupExpansion(ip) {
+  return stripTrailing(ip.replaceAll("::", ":0000:"), ":");
+}
+
+// src/type-conversion/json.ts
+function jsonValue(val) {
+  return isNumberLike(val) ? Number(val) : val === "true" ? true : val === "false" ? false : `"${val}"`;
+}
+function jsonValues(...val) {
+  return val.map((i) => jsonValue(i));
+}
+
+// src/type-conversion/lookupCountry.ts
+function lookupAlpha2Code(code, prop) {
+  const found = ISO3166_1.find((i) => i.alpha2 === code);
+  return found ? found[prop] : void 0;
+}
+function lookupAlpha3Code(code, prop) {
+  const found = ISO3166_1.find((i) => i.alpha3 === code);
+  return found ? found[prop] : void 0;
+}
+function lookupName(name, prop) {
+  const found = ISO3166_1.find((i) => i.name === name);
+  return found ? found[prop] : void 0;
+}
+function lookupNumericCode(code, prop) {
+  let num = isNumber(code) ? `${code}` : code;
+  if (num.length === 1) {
+    num = `00${num}`;
+  } else if (num.length === 2) {
+    num = `0${num}`;
+  }
+  const found = ISO3166_1.find((i) => i.countryCode === num);
+  return found ? found[prop] : void 0;
+}
+function lookupCountryName(code) {
+  const uc = uppercase(code);
+  return isNumberLike(code) ? lookupNumericCode(code, "name") : isIso3166Alpha2(uc) ? lookupAlpha2Code(uc, "name") : isIso3166Alpha3(uc) ? lookupAlpha3Code(uc, "name") : void 0;
+}
+function lookupCountryAlpha2(code) {
+  const uc = uppercase(code);
+  return isNumberLike(code) ? lookupNumericCode(code, "alpha2") : isIso3166Alpha2(uc) ? lookupAlpha2Code(uc, "alpha2") : isIso3166Alpha3(uc) ? lookupAlpha3Code(uc, "alpha2") : isIso3166CountryName(code) ? lookupName(code, "alpha2") : void 0;
+}
+function lookupCountryAlpha3(token) {
+  const uc = uppercase(token);
+  return isNumberLike(token) ? lookupNumericCode(token, "alpha3") : isIso3166Alpha2(uc) ? lookupAlpha2Code(uc, "alpha3") : isIso3166Alpha3(uc) ? lookupAlpha3Code(uc, "alpha3") : isIso3166CountryName(token) ? lookupName(token, "alpha3") : void 0;
+}
+function lookupCountryCode(token) {
+  const uc = uppercase(token);
+  return isNumberLike(token) ? lookupNumericCode(token, "countryCode") : isIso3166Alpha2(uc) ? lookupAlpha2Code(uc, "countryCode") : isIso3166Alpha3(uc) ? lookupAlpha3Code(uc, "countryCode") : isIso3166CountryName(token) ? lookupName(token, "countryCode") : void 0;
+}
+
+// src/type-conversion/mergeObjects.ts
+function mergeObjects(defVal, override) {
+  const intersectingKeys = sharedKeys(defVal, override);
+  const defUnique = withoutKeys(defVal, ...intersectingKeys);
+  const overrideUnique = withoutKeys(defVal, ...intersectingKeys);
+  const merged = {
+    ...intersectingKeys.reduce(
+      (acc, key) => typeof override[key] === "undefined" ? { ...acc, [key]: defVal[key] } : { ...acc, [key]: override[key] },
+      {}
+    ),
+    ...defUnique,
+    ...overrideUnique
+  };
+  return merged;
+}
+
+// src/type-guards/isUndefined.ts
+function isUndefined(value) {
+  return typeof value === "undefined";
+}
+
+// src/type-conversion/mergeScalars.ts
+function mergeScalars(a, b) {
+  return isUndefined(b) ? a : b;
+}
+
+// src/type-conversion/mergeTuples.ts
+function mergeTuples(a, b) {
+  return b.length > a.length ? b.map((v, idx) => v !== void 0 ? v : a[idx]) : [...b, ...a.slice(b.length)].map((v, idx) => v !== void 0 ? v : a[idx]);
+}
+
+// src/type-conversion/never.ts
+function never(val) {
+  return val;
+}
+
+// src/type-conversion/optional.ts
+function optional(value) {
+  return value;
+}
+function orNull(value) {
+  return value;
+}
+function optionalOrNull(value) {
+  return value;
+}
+
+// src/type-conversion/stripParenthesis.ts
+function stripParenthesis(val) {
+  return stripTrailing(stripLeading(val.trim(), "("), ")").trim();
+}
+
+// src/type-conversion/toNumber.ts
+function convertScalar(val) {
+  switch (typeof val) {
+    case "number":
+      return val;
+    case "string":
+      return Number(val);
+    case "boolean":
+      return val ? 1 : 0;
+    default:
+      throw new Error(`${typeof val} is an invalid scalar type to convert to a number!`);
+  }
+}
+var convertList = (val) => val.map((i) => convertScalar(i));
+function toNumber(value) {
+  return Array.isArray(value) ? convertList(value) : convertScalar(value);
+}
+
+// src/type-conversion/tw-conversion.ts
+var MODS = TW_MODIFIERS.map((i) => `${i}:`);
+function removeTailwindModifiers(val) {
+  return MODS.some((i) => val.startsWith(i)) ? removeTailwindModifiers(val.replace(MODS.find((i) => val.startsWith(i)), "")) : val;
+}
+function getTailwindModifiers(val) {
+  return val.split(":").filter((i) => isTailwindModifier(i));
+}
+
+// src/type-conversion/union.ts
+function union(..._options) {
+  return (value) => value;
+}
+
+// src/type-conversion/unionize.ts
+function unionize(value, _inUnionWith) {
+  return value;
+}
+
+// src/type-guards/hasWhitespace.ts
+function hasWhiteSpace(val) {
+  return isString(val) && asChars(val).some((c) => WHITESPACE_CHARS.includes(c));
+}
+
+// src/type-guards/higher-order/endsWith.ts
+function endsWith(endingIn2) {
+  return (val) => {
+    return isString(val) ? !!val.endsWith(endingIn2) : isNumber(val) ? !!String(val).endsWith(endingIn2) : false;
+  };
+}
+
+// src/type-guards/higher-order/isEqual.ts
+function isEqual(base) {
+  return (value) => isSameTypeOf(base)(value) ? value === base : false;
+}
+
+// src/type-guards/higher-order/isLength.ts
+function isLength(value, len) {
+  return isArray(value) ? !!isEqual(value.length)(len) : isString(value) ? !!isEqual(value.length)(len) : isObject(value) ? !!isEqual(keysOf(value))(len) : false;
+}
+
+// src/type-guards/higher-order/isSameTypeOf.ts
+function isSameTypeOf(base) {
   return (compare) => {
     return typeof base === typeof compare;
   };
@@ -3264,16 +3219,16 @@ function isTruthy(val) {
   return !FALSY_VALUES.includes(val);
 }
 
+// src/type-guards/isTypeSubtype.ts
+function isTypeSubtype(val) {
+  return isString(val) && val.split("/").length === 2;
+}
+
 // src/type-guards/isTypeTuple.ts
 function isTypeTuple(value) {
   return Array.isArray(value) && value.length === 3 && typeof value[1] === "function";
 }
 
-// src/type-guards/isUndefined.ts
-function isUndefined(value) {
-  return typeof value === "undefined";
-}
-
 // src/type-guards/isUnset.ts
 function isUnset(val) {
   return isObject(val) && val.kind === "Unset";
@@ -3923,168 +3878,230 @@ function isYouTubeVideosInPlaylist(val) {
   return isString(val) && (val.startsWith(`https://www.youtube.com/playlist?`) || val.startsWith(`https://youtube.com/playlist?`)) && hasUrlQueryParameter(val, "list");
 }
 
-// src/type-conversion/csv.ts
-function csv(csv2, format = `string-numeric-tuple`) {
-  const tuple3 = [];
-  csv2.split(/,\s?/).forEach((v) => {
-    tuple3.push(
-      format === "string-numeric-tuple" ? isNumberLike(v) ? Number(v) : v : format === "json-tuple" ? isNumberLike(v) ? Number(v) : v === "true" ? true : v === "false" ? false : `"${v}"` : format === "string-tuple" ? `${v}` : Never
-    );
-  });
-  return tuple3;
+// src/literals/getTypeSubtype.ts
+function getTypeSubtype(str) {
+  if (isTypeSubtype(str)) {
+    const [t, st] = str.split("/");
+    return [t, st];
+  } else {
+    const err = new Error(`An invalid Type/Subtype was passed into getTypeSubtype(${str})`);
+    err.name = "InvalidTypeSubtype";
+    throw err;
+  }
 }
 
-// src/type-conversion/intersect.ts
-function intersect(value, _intersectedWith) {
-  return value;
+// src/literals/identity.ts
+function identity(...values) {
+  return values.length === 1 ? values[0] : values.length === 0 ? void 0 : values;
 }
 
-// src/literals/stripTrailing.ts
-function stripTrailing(content, ...strip2) {
-  let output = String(content);
-  for (const s of strip2) {
-    if (output.endsWith(String(s))) {
-      output = output.slice(0, -1 * String(s).length);
-    }
+// src/literals/ifLowercase.ts
+function ifLowercaseChar(ch, callbackForMatch, callbackForNoMatch) {
+  if (ch.length !== 1) {
+    throw new Error(`call to ifUppercaseChar received ${ch.length} characters but is only valid when one character is passed in!`);
   }
-  return isNumber(content) ? Number(output) : output;
+  return LOWER_ALPHA_CHARS.includes(ch) ? callbackForMatch(ch) : callbackForNoMatch(ch);
 }
 
-// src/type-conversion/ip6GroupExpansion.ts
-function ip6GroupExpansion(ip) {
-  return stripTrailing(ip.replaceAll("::", ":0000:"), ":");
+// src/literals/ifUppercase.ts
+function ifUppercaseChar(ch, callbackForMatch, callbackForNoMatch) {
+  if (ch.length !== 1) {
+    throw new Error(`Invalid string length passed to ifUppercaseChar(ch); this function requires a single character but ${ch.length} were received`);
+  }
+  return LOWER_ALPHA_CHARS.includes(ch) ? callbackForMatch(ch) : callbackForNoMatch(ch);
 }
 
-// src/type-conversion/json.ts
-function jsonValue(val) {
-  return isNumberLike(val) ? Number(val) : val === "true" ? true : val === "false" ? false : `"${val}"`;
-}
-function jsonValues(...val) {
-  return val.map((i) => jsonValue(i));
+// src/literals/infer.ts
+function parseTemplate(template) {
+  const pattern = /\{\{\s*infer\s+([A-Za-z_]\w*)\s*(?:as\s+(string|number|boolean)\s*)?\}\}/g;
+  let lastIndex = 0;
+  let match;
+  const segments = [];
+  do {
+    match = pattern.exec(template);
+    if (match) {
+      const [fullMatch, varName, asType2] = match;
+      const staticPart = template.slice(lastIndex, match.index);
+      if (staticPart) {
+        segments.push({ dynamic: false, text: staticPart });
+      }
+      segments.push({
+        dynamic: true,
+        varName,
+        type: asType2 ? asType2 : "string"
+      });
+      lastIndex = match.index + fullMatch.length;
+    }
+  } while (match);
+  const remainder = template.slice(lastIndex);
+  if (remainder) {
+    segments.push({ dynamic: false, text: remainder });
+  }
+  return segments;
 }
-
-// src/type-conversion/lookupCountry.ts
-function lookupAlpha2Code(code, prop) {
-  const found = ISO3166_1.find((i) => i.alpha2 === code);
-  return found ? found[prop] : void 0;
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function lookupAlpha3Code(code, prop) {
-  const found = ISO3166_1.find((i) => i.alpha3 === code);
-  return found ? found[prop] : void 0;
+function buildRegexPattern(segments) {
+  let regexStr = "^";
+  for (const seg of segments) {
+    if (!seg.dynamic) {
+      regexStr += escapeRegex(seg.text);
+    } else {
+      switch (seg.type) {
+        case "string":
+          regexStr += `(?<${seg.varName}>.*?)`;
+          break;
+        case "number":
+          regexStr += `(?<${seg.varName}>\\d+)`;
+          break;
+        case "boolean":
+          regexStr += `(?<${seg.varName}>(?:true|false))`;
+          break;
+      }
+    }
+  }
+  regexStr += "$";
+  return new RegExp(regexStr, "s");
 }
-function lookupName(name, prop) {
-  const found = ISO3166_1.find((i) => i.name === name);
-  return found ? found[prop] : void 0;
+function convertValue(type, value) {
+  switch (type) {
+    case "string":
+      return value;
+    case "number":
+      return Number(value);
+    case "boolean":
+      return value === "true";
+  }
 }
-function lookupNumericCode(code, prop) {
-  let num = isNumber(code) ? `${code}` : code;
-  if (num.length === 1) {
-    num = `00${num}`;
-  } else if (num.length === 2) {
-    num = `0${num}`;
+function matchTemplate(inference, test) {
+  const segments = parseTemplate(inference);
+  const regex = buildRegexPattern(segments);
+  const match = test.match(regex);
+  if (!match)
+    return false;
+  const result2 = {};
+  for (const seg of segments) {
+    if (seg.dynamic) {
+      const rawVal = match.groups?.[seg.varName];
+      if (rawVal === void 0)
+        return false;
+      result2[seg.varName.toLowerCase()] = convertValue(seg.type, rawVal);
+    }
   }
-  const found = ISO3166_1.find((i) => i.countryCode === num);
-  return found ? found[prop] : void 0;
+  return result2;
 }
-function lookupCountryName(code) {
-  const uc = uppercase(code);
-  return isNumberLike(code) ? lookupNumericCode(code, "name") : isIso3166Alpha2(uc) ? lookupAlpha2Code(uc, "name") : isIso3166Alpha3(uc) ? lookupAlpha3Code(uc, "name") : void 0;
+function infer(inference) {
+  return (test) => {
+    return matchTemplate(inference, test);
+  };
 }
-function lookupCountryAlpha2(code) {
-  const uc = uppercase(code);
-  return isNumberLike(code) ? lookupNumericCode(code, "alpha2") : isIso3166Alpha2(uc) ? lookupAlpha2Code(uc, "alpha2") : isIso3166Alpha3(uc) ? lookupAlpha3Code(uc, "alpha2") : isIso3166CountryName(code) ? lookupName(code, "alpha2") : void 0;
+
+// src/literals/literal.ts
+function idLiteral(o) {
+  return { ...o, id: o.id };
 }
-function lookupCountryAlpha3(token) {
-  const uc = uppercase(token);
-  return isNumberLike(token) ? lookupNumericCode(token, "alpha3") : isIso3166Alpha2(uc) ? lookupAlpha2Code(uc, "alpha3") : isIso3166Alpha3(uc) ? lookupAlpha3Code(uc, "alpha3") : isIso3166CountryName(token) ? lookupName(token, "alpha3") : void 0;
+function nameLiteral(o) {
+  return o;
 }
-function lookupCountryCode(token) {
-  const uc = uppercase(token);
-  return isNumberLike(token) ? lookupNumericCode(token, "countryCode") : isIso3166Alpha2(uc) ? lookupAlpha2Code(uc, "countryCode") : isIso3166Alpha3(uc) ? lookupAlpha3Code(uc, "countryCode") : isIso3166CountryName(token) ? lookupName(token, "countryCode") : void 0;
+function kindLiteral(o) {
+  return o;
 }
-
-// src/type-conversion/mergeObjects.ts
-function mergeObjects(defVal, override) {
-  const intersectingKeys = sharedKeys(defVal, override);
-  const defUnique = withoutKeys(defVal, ...intersectingKeys);
-  const overrideUnique = withoutKeys(defVal, ...intersectingKeys);
-  const merged = {
-    ...intersectingKeys.reduce(
-      (acc, key) => typeof override[key] === "undefined" ? { ...acc, [key]: defVal[key] } : { ...acc, [key]: override[key] },
-      {}
-    ),
-    ...defUnique,
-    ...overrideUnique
-  };
-  return merged;
+function idTypeGuard(_o) {
+  return true;
 }
-
-// src/type-conversion/mergeScalars.ts
-function mergeScalars(a, b) {
-  return isUndefined(b) ? a : b;
+function literal(obj) {
+  return obj;
 }
 
-// src/type-conversion/mergeTuples.ts
-function mergeTuples(a, b) {
-  return b.length > a.length ? b.map((v, idx) => v !== void 0 ? v : a[idx]) : [...b, ...a.slice(b.length)].map((v, idx) => v !== void 0 ? v : a[idx]);
+// src/literals/lowercase.ts
+function lowercase(str) {
+  return str.toLowerCase();
 }
 
-// src/type-conversion/never.ts
-function never(val) {
-  return val;
+// src/literals/narrow.ts
+function narrow(...values) {
+  return values.length === 1 ? values[0] : values;
 }
 
-// src/type-conversion/optional.ts
-function optional(value) {
-  return value;
-}
-function orNull(value) {
-  return value;
+// src/literals/pathJoin.ts
+function pathJoin(...segments) {
+  const clean_path = segments.map((i) => stripTrailing(stripLeading(i, "/"), "/")).join("/");
+  const original_path = segments.join("/");
+  const pre = original_path.startsWith("/") ? "/" : "";
+  const post = original_path.endsWith("/") ? "/" : "";
+  return `${pre}${clean_path}${post}`;
 }
-function optionalOrNull(value) {
-  return value;
+
+// src/literals/phone/asPhoneNumber.ts
+var asPhoneFormat = () => `NOT IMPLEMENTED`;
+
+// src/literals/phone/getPhoneCountryCode.ts
+function getPhoneCountryCode(phone) {
+  return phone.trim().startsWith("+") || phone.trim().startsWith("00") ? retainWhile(
+    stripLeading(stripLeading(phone.trim(), "+"), "00"),
+    ...NUMERIC_CHAR
+  ) : "";
 }
 
-// src/type-conversion/stripParenthesis.ts
-function stripParenthesis(val) {
-  return stripTrailing(stripLeading(val.trim(), "("), ")").trim();
+// src/literals/phone/removePhoneCountryCode.ts
+function removePhoneCountryCode(phone) {
+  const countryCode = getPhoneCountryCode(phone);
+  return countryCode !== "" ? stripLeading(stripLeading(
+    phone.trim(),
+    "+",
+    "00"
+  ), countryCode).trim() : phone.trim();
 }
 
-// src/type-conversion/toNumber.ts
-function convertScalar(val) {
-  switch (typeof val) {
-    case "number":
-      return val;
-    case "string":
-      return Number(val);
-    case "boolean":
-      return val ? 1 : 0;
+// src/literals/pluralize.ts
+var isException = (word) => Object.keys(PLURAL_EXCEPTIONS).includes(word);
+function endingIn(word, postfix) {
+  switch (postfix) {
+    case "is":
+      return word.endsWith(postfix) ? `${word}es` : void 0;
+    case "singular-noun":
+      return SINGULAR_NOUN_ENDINGS.some((i) => word.endsWith(i)) ? split(word).every((i) => [...ALPHA_CHARS].includes(i)) ? `${word}es` : void 0 : void 0;
+    case "f":
+      return word.endsWith("f") ? `${stripTrailing(word, "f")}ves` : word.endsWith("fe") ? `${stripTrailing(word, "fe")}ves` : void 0;
+    case "y":
+      return word.endsWith("y") ? `${stripTrailing(word, "y")}ies` : void 0;
     default:
-      throw new Error(`${typeof val} is an invalid scalar type to convert to a number!`);
+      throw new Error(`endingIn received "${postfix}" as a postfix but this ending is not known!`);
   }
 }
-var convertList = (val) => val.map((i) => convertScalar(i));
-function toNumber(value) {
-  return Array.isArray(value) ? convertList(value) : convertScalar(value);
+function pluralize(word) {
+  const right = rightWhitespace(word);
+  const w = word.trimEnd();
+  const result2 = isException(w) ? PLURAL_EXCEPTIONS[w] : endingIn(w, "is") || endingIn(w, "singular-noun") || endingIn(w, "f") || endingIn(w, "y") || `${w}s`;
+  return `${result2}${right}`;
 }
 
-// src/type-conversion/tw-conversion.ts
-var MODS = TW_MODIFIERS.map((i) => `${i}:`);
-function removeTailwindModifiers(val) {
-  return MODS.some((i) => val.startsWith(i)) ? removeTailwindModifiers(val.replace(MODS.find((i) => val.startsWith(i)), "")) : val;
-}
-function getTailwindModifiers(val) {
-  return val.split(":").filter((i) => isTailwindModifier(i));
+// src/literals/retainAfter.ts
+function retainAfter(content, ...find2) {
+  const idx = Math.min(
+    ...find2.map((i) => content.indexOf(i)).filter((i) => i > -1)
+  );
+  const min = Math.min(...find2.map((i) => i.length));
+  let len = Math.max(...find2.map((i) => i.length));
+  if (min !== len) {
+    if (!find2.includes(content.slice(idx, len))) {
+      len = min;
+    }
+  }
+  return idx && idx > 0 ? content.slice(idx + len) : "";
 }
-
-// src/type-conversion/union.ts
-function union(..._options) {
-  return (value) => value;
+function retainAfterInclusive(content, ...find2) {
+  const minFound = Math.min(
+    ...find2.map((i) => content.indexOf(i)).filter((i) => i > -1)
+  );
+  return minFound > 0 ? content.slice(minFound) : "";
 }
 
-// src/type-conversion/unionize.ts
-function unionize(value, _inUnionWith) {
-  return value;
+// src/literals/retainChars.ts
+function retainChars(content, ...retain2) {
+  const chars = asChars(content);
+  return chars.filter((c) => retain2.includes(c)).join("");
 }
 
 // src/literals/retainUntil.ts
@@ -4877,6 +4894,7 @@ export {
   getToday,
   getTokenKind,
   getTomorrow,
+  getTypeSubtype,
   getUrlPath,
   getUrlPort,
   getUrlProtocol,
@@ -5117,6 +5135,7 @@ export {
   isTupleToken,
   isTurkishNewsUrl,
   isTypeOf,
+  isTypeSubtype,
   isTypeToken,
   isTypeTokenKind,
   isTypeTuple,