@stryke/env 0.20.49 → 0.20.51

package/dist/string-format/src/articles.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"articles.mjs","names":[],"sources":["../../../../string-format/src/articles.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport const ARTICLES = [\"a\", \"an\", \"the\"];\n"],"mappings":"AAkBA,MAAa,EAAW,CAAC,IAAK,KAAM,MAAM"}
+{"version":3,"file":"articles.mjs","names":[],"sources":["../../../../string-format/src/articles.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport const ARTICLES = [\"a\", \"an\", \"the\"];\n"],"mappings":";AAkBA,MAAa,WAAW;CAAC;CAAK;CAAM;CAAM"}

package/dist/string-format/src/combine.cjs

@@ -1 +1,15 @@
-function e(e,t){return`${e} ${t}`}exports.combine=e;
+
+//#region ../string-format/src/combine.ts
+/**
+* Combine two strings with a space in between.
+*
+* @param acc - The accumulated string.
+* @param str - The string to add.
+* @returns The combined string.
+*/
+function combine(acc, str) {
+	return `${acc} ${str}`;
+}
+
+//#endregion
+exports.combine = combine;

package/dist/string-format/src/combine.mjs

@@ -1,2 +1,15 @@
-function e(e,t){return`${e} ${t}`}export{e as combine};
+//#region ../string-format/src/combine.ts
+/**
+* Combine two strings with a space in between.
+*
+* @param acc - The accumulated string.
+* @param str - The string to add.
+* @returns The combined string.
+*/
+function combine(acc, str) {
+	return `${acc} ${str}`;
+}
+
+//#endregion
+export { combine };
 //# sourceMappingURL=combine.mjs.map

package/dist/string-format/src/combine.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"combine.mjs","names":[],"sources":["../../../../string-format/src/combine.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/**\n * Combine two strings with a space in between.\n *\n * @param acc - The accumulated string.\n * @param str - The string to add.\n * @returns The combined string.\n */\nexport function combine(acc: string, str: string): string {\n  return `${acc} ${str}`;\n}\n"],"mappings":"AAyBA,SAAgB,EAAQ,EAAa,EAAqB,CACxD,MAAO,GAAG,EAAI,GAAG"}
+{"version":3,"file":"combine.mjs","names":[],"sources":["../../../../string-format/src/combine.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/**\n * Combine two strings with a space in between.\n *\n * @param acc - The accumulated string.\n * @param str - The string to add.\n * @returns The combined string.\n */\nexport function combine(acc: string, str: string): string {\n  return `${acc} ${str}`;\n}\n"],"mappings":";;;;;;;;AAyBA,SAAgB,QAAQ,KAAa,KAAqB;AACxD,QAAO,GAAG,IAAI,GAAG"}

package/dist/string-format/src/conjunctions.cjs

@@ -1 +1,32 @@
-const e=[`and`,`that`,`but`,`or`,`as`,`if`,`when`,`than`,`because`,`while`,`where`,`after`,`so`,`though`,`since`,`until`,`whether`,`before`,`although`,`nor`,`like`,`once`,`unless`,`now`,`except`];exports.CONJUNCTIONS=e;
+
+//#region ../string-format/src/conjunctions.ts
+const CONJUNCTIONS = [
+	"and",
+	"that",
+	"but",
+	"or",
+	"as",
+	"if",
+	"when",
+	"than",
+	"because",
+	"while",
+	"where",
+	"after",
+	"so",
+	"though",
+	"since",
+	"until",
+	"whether",
+	"before",
+	"although",
+	"nor",
+	"like",
+	"once",
+	"unless",
+	"now",
+	"except"
+];
+
+//#endregion
+exports.CONJUNCTIONS = CONJUNCTIONS;

package/dist/string-format/src/conjunctions.mjs

@@ -1,2 +1,32 @@
-const e=[`and`,`that`,`but`,`or`,`as`,`if`,`when`,`than`,`because`,`while`,`where`,`after`,`so`,`though`,`since`,`until`,`whether`,`before`,`although`,`nor`,`like`,`once`,`unless`,`now`,`except`];export{e as CONJUNCTIONS};
+//#region ../string-format/src/conjunctions.ts
+const CONJUNCTIONS = [
+	"and",
+	"that",
+	"but",
+	"or",
+	"as",
+	"if",
+	"when",
+	"than",
+	"because",
+	"while",
+	"where",
+	"after",
+	"so",
+	"though",
+	"since",
+	"until",
+	"whether",
+	"before",
+	"although",
+	"nor",
+	"like",
+	"once",
+	"unless",
+	"now",
+	"except"
+];
+
+//#endregion
+export { CONJUNCTIONS };
 //# sourceMappingURL=conjunctions.mjs.map

package/dist/string-format/src/conjunctions.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"conjunctions.mjs","names":[],"sources":["../../../../string-format/src/conjunctions.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport const CONJUNCTIONS = [\n  \"and\",\n  \"that\",\n  \"but\",\n  \"or\",\n  \"as\",\n  \"if\",\n  \"when\",\n  \"than\",\n  \"because\",\n  \"while\",\n  \"where\",\n  \"after\",\n  \"so\",\n  \"though\",\n  \"since\",\n  \"until\",\n  \"whether\",\n  \"before\",\n  \"although\",\n  \"nor\",\n  \"like\",\n  \"once\",\n  \"unless\",\n  \"now\",\n  \"except\"\n];\n"],"mappings":"AAkBA,MAAa,EAAe,CAC1B,MACA,OACA,MACA,KACA,KACA,KACA,OACA,OACA,UACA,QACA,QACA,QACA,KACA,SACA,QACA,QACA,UACA,SACA,WACA,MACA,OACA,OACA,SACA,MACA,SACD"}
+{"version":3,"file":"conjunctions.mjs","names":[],"sources":["../../../../string-format/src/conjunctions.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport const CONJUNCTIONS = [\n  \"and\",\n  \"that\",\n  \"but\",\n  \"or\",\n  \"as\",\n  \"if\",\n  \"when\",\n  \"than\",\n  \"because\",\n  \"while\",\n  \"where\",\n  \"after\",\n  \"so\",\n  \"though\",\n  \"since\",\n  \"until\",\n  \"whether\",\n  \"before\",\n  \"although\",\n  \"nor\",\n  \"like\",\n  \"once\",\n  \"unless\",\n  \"now\",\n  \"except\"\n];\n"],"mappings":";AAkBA,MAAa,eAAe;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}

package/dist/string-format/src/decamelize.cjs

@@ -1 +1,14 @@
-function e(e){return e.replace(/([a-z\d])([A-Z])/g,`$1_$2`).replace(/([A-Z]+)([A-Z][a-z\d]+)/g,`$1_$2`).toLowerCase()}exports.decamelize=e;
+
+//#region ../string-format/src/decamelize.ts
+/**
+* Convert a camelCase or PascalCase string to a snake_case string.
+*
+* @param value - The camelCase or PascalCase string to convert.
+* @returns The converted snake_case string.
+*/
+function decamelize(value) {
+	return value.replace(/([a-z\d])([A-Z])/g, "$1_$2").replace(/([A-Z]+)([A-Z][a-z\d]+)/g, "$1_$2").toLowerCase();
+}
+
+//#endregion
+exports.decamelize = decamelize;

package/dist/string-format/src/decamelize.mjs

@@ -1,2 +1,14 @@
-function e(e){return e.replace(/([a-z\d])([A-Z])/g,`$1_$2`).replace(/([A-Z]+)([A-Z][a-z\d]+)/g,`$1_$2`).toLowerCase()}export{e as decamelize};
+//#region ../string-format/src/decamelize.ts
+/**
+* Convert a camelCase or PascalCase string to a snake_case string.
+*
+* @param value - The camelCase or PascalCase string to convert.
+* @returns The converted snake_case string.
+*/
+function decamelize(value) {
+	return value.replace(/([a-z\d])([A-Z])/g, "$1_$2").replace(/([A-Z]+)([A-Z][a-z\d]+)/g, "$1_$2").toLowerCase();
+}
+
+//#endregion
+export { decamelize };
 //# sourceMappingURL=decamelize.mjs.map

package/dist/string-format/src/decamelize.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"decamelize.mjs","names":[],"sources":["../../../../string-format/src/decamelize.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/**\n * Convert a camelCase or PascalCase string to a snake_case string.\n *\n * @param value - The camelCase or PascalCase string to convert.\n * @returns The converted snake_case string.\n */\nexport function decamelize(value: string): string {\n  return value\n    .replace(/([a-z\\d])([A-Z])/g, \"$1_$2\")\n    .replace(/([A-Z]+)([A-Z][a-z\\d]+)/g, \"$1_$2\")\n    .toLowerCase();\n}\n"],"mappings":"AAwBA,SAAgB,EAAW,EAAuB,CAChD,OAAO,EACJ,QAAQ,oBAAqB,QAAQ,CACrC,QAAQ,2BAA4B,QAAQ,CAC5C,aAAa"}
+{"version":3,"file":"decamelize.mjs","names":[],"sources":["../../../../string-format/src/decamelize.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/**\n * Convert a camelCase or PascalCase string to a snake_case string.\n *\n * @param value - The camelCase or PascalCase string to convert.\n * @returns The converted snake_case string.\n */\nexport function decamelize(value: string): string {\n  return value\n    .replace(/([a-z\\d])([A-Z])/g, \"$1_$2\")\n    .replace(/([A-Z]+)([A-Z][a-z\\d]+)/g, \"$1_$2\")\n    .toLowerCase();\n}\n"],"mappings":";;;;;;;AAwBA,SAAgB,WAAW,OAAuB;AAChD,QAAO,MACJ,QAAQ,qBAAqB,QAAQ,CACrC,QAAQ,4BAA4B,QAAQ,CAC5C,aAAa"}

package/dist/string-format/src/format-special-cases.cjs

@@ -1 +1,33 @@
-const e=require(`./acronyms.cjs`),t=require(`./articles.cjs`),n=require(`./conjunctions.cjs`),r=require(`./prepositions.cjs`),i=require(`./special-cases.cjs`);function a(a,o,s,c){let l=a.toLowerCase(),u=a.toUpperCase();for(let e of i.SPECIAL_CASES)if(e.toLowerCase()===l)return e;return e.ACRONYMS[u]?c?.useDescriptions===!1?e.ACRONYMS[u].display||u:e.ACRONYMS[u].description:o===0||o===s.length-1||a.length>=4?a:r.PREPOSITIONS.includes(l)||n.CONJUNCTIONS.includes(l)||t.ARTICLES.includes(l)?l:a}exports.formatSpecialCases=a;
+const require_acronyms = require('./acronyms.cjs');
+const require_articles = require('./articles.cjs');
+const require_conjunctions = require('./conjunctions.cjs');
+const require_prepositions = require('./prepositions.cjs');
+const require_special_cases = require('./special-cases.cjs');
+
+//#region ../string-format/src/format-special-cases.ts
+/**
+* Handle special words in a title.
+*
+* @see https://apastyle.apa.org/style-grammar-guidelines/capitalization/title-case
+*
+* @param value - The word to handle
+* @param index - The index of the word in the title
+* @param words - The full title as an array of words
+* @returns The formatted word
+*/
+function formatSpecialCases(value, index, words, options) {
+	const lowercaseStr = value.toLowerCase();
+	const uppercaseStr = value.toUpperCase();
+	for (const special of require_special_cases.SPECIAL_CASES) if (special.toLowerCase() === lowercaseStr) return special;
+	if (require_acronyms.ACRONYMS[uppercaseStr]) return options?.useDescriptions !== false ? require_acronyms.ACRONYMS[uppercaseStr].description : require_acronyms.ACRONYMS[uppercaseStr].display || uppercaseStr;
+	if (index === 0) return value;
+	if (index === words.length - 1) return value;
+	if (value.length >= 4) return value;
+	if (require_prepositions.PREPOSITIONS.includes(lowercaseStr)) return lowercaseStr;
+	if (require_conjunctions.CONJUNCTIONS.includes(lowercaseStr)) return lowercaseStr;
+	if (require_articles.ARTICLES.includes(lowercaseStr)) return lowercaseStr;
+	return value;
+}
+
+//#endregion
+exports.formatSpecialCases = formatSpecialCases;

package/dist/string-format/src/format-special-cases.mjs

@@ -1,2 +1,34 @@
-import{ACRONYMS as e}from"./acronyms.mjs";import{ARTICLES as t}from"./articles.mjs";import{CONJUNCTIONS as n}from"./conjunctions.mjs";import{PREPOSITIONS as r}from"./prepositions.mjs";import{SPECIAL_CASES as i}from"./special-cases.mjs";function a(a,o,s,c){let l=a.toLowerCase(),u=a.toUpperCase();for(let e of i)if(e.toLowerCase()===l)return e;return e[u]?c?.useDescriptions===!1?e[u].display||u:e[u].description:o===0||o===s.length-1||a.length>=4?a:r.includes(l)||n.includes(l)||t.includes(l)?l:a}export{a as formatSpecialCases};
+import { ACRONYMS } from "./acronyms.mjs";
+import { ARTICLES } from "./articles.mjs";
+import { CONJUNCTIONS } from "./conjunctions.mjs";
+import { PREPOSITIONS } from "./prepositions.mjs";
+import { SPECIAL_CASES } from "./special-cases.mjs";
+
+//#region ../string-format/src/format-special-cases.ts
+/**
+* Handle special words in a title.
+*
+* @see https://apastyle.apa.org/style-grammar-guidelines/capitalization/title-case
+*
+* @param value - The word to handle
+* @param index - The index of the word in the title
+* @param words - The full title as an array of words
+* @returns The formatted word
+*/
+function formatSpecialCases(value, index, words, options) {
+	const lowercaseStr = value.toLowerCase();
+	const uppercaseStr = value.toUpperCase();
+	for (const special of SPECIAL_CASES) if (special.toLowerCase() === lowercaseStr) return special;
+	if (ACRONYMS[uppercaseStr]) return options?.useDescriptions !== false ? ACRONYMS[uppercaseStr].description : ACRONYMS[uppercaseStr].display || uppercaseStr;
+	if (index === 0) return value;
+	if (index === words.length - 1) return value;
+	if (value.length >= 4) return value;
+	if (PREPOSITIONS.includes(lowercaseStr)) return lowercaseStr;
+	if (CONJUNCTIONS.includes(lowercaseStr)) return lowercaseStr;
+	if (ARTICLES.includes(lowercaseStr)) return lowercaseStr;
+	return value;
+}
+
+//#endregion
+export { formatSpecialCases };
 //# sourceMappingURL=format-special-cases.mjs.map

package/dist/string-format/src/format-special-cases.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"format-special-cases.mjs","names":[],"sources":["../../../../string-format/src/format-special-cases.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { ACRONYMS } from \"./acronyms\";\nimport { ARTICLES } from \"./articles\";\nimport { CONJUNCTIONS } from \"./conjunctions\";\nimport { PREPOSITIONS } from \"./prepositions\";\nimport { SPECIAL_CASES } from \"./special-cases\";\n\nexport interface FormatSpecialCasesOptions {\n  /**\n   * If true, use the descriptions from the acronym list instead of the display names.\n   *\n   * @defaultValue true\n   */\n  useDescriptions?: boolean;\n}\n\n/**\n * Handle special words in a title.\n *\n * @see https://apastyle.apa.org/style-grammar-guidelines/capitalization/title-case\n *\n * @param value - The word to handle\n * @param index - The index of the word in the title\n * @param words - The full title as an array of words\n * @returns The formatted word\n */\nexport function formatSpecialCases(\n  value: string,\n  index: number,\n  words: string[],\n  options?: FormatSpecialCasesOptions\n): string {\n  const lowercaseStr = value.toLowerCase();\n  const uppercaseStr = value.toUpperCase();\n\n  for (const special of SPECIAL_CASES) {\n    if (special.toLowerCase() === lowercaseStr) {\n      return special;\n    }\n  }\n\n  if (ACRONYMS[uppercaseStr]) {\n    return options?.useDescriptions !== false\n      ? ACRONYMS[uppercaseStr].description\n      : ACRONYMS[uppercaseStr].display || uppercaseStr;\n  }\n\n  // If the word is the first word in the sentence, but it's not a specially\n  // cased word or an acronym, return the capitalized string\n  if (index === 0) {\n    return value;\n  }\n\n  // If the word is the last word in the sentence, but it's not a specially\n  // cased word or an acronym, return the capitalized string\n  if (index === words.length - 1) {\n    return value;\n  }\n\n  // Return the word capitalized if it's 4 characters or more\n  if (value.length >= 4) {\n    return value;\n  }\n\n  if (PREPOSITIONS.includes(lowercaseStr)) {\n    return lowercaseStr;\n  }\n  if (CONJUNCTIONS.includes(lowercaseStr)) {\n    return lowercaseStr;\n  }\n  if (ARTICLES.includes(lowercaseStr)) {\n    return lowercaseStr;\n  }\n\n  return value;\n}\n"],"mappings":"4OA2CA,SAAgB,EACd,EACA,EACA,EACA,EACQ,CACR,IAAM,EAAe,EAAM,aAAa,CAClC,EAAe,EAAM,aAAa,CAExC,IAAK,IAAM,KAAW,EACpB,GAAI,EAAQ,aAAa,GAAK,EAC5B,OAAO,EAqCX,OAjCI,EAAS,GACJ,GAAS,kBAAoB,GAEhC,EAAS,GAAc,SAAW,EADlC,EAAS,GAAc,YAMzB,IAAU,GAMV,IAAU,EAAM,OAAS,GAKzB,EAAM,QAAU,EACX,EAGL,EAAa,SAAS,EAAa,EAGnC,EAAa,SAAS,EAAa,EAGnC,EAAS,SAAS,EAAa,CAC1B,EAGF"}
+{"version":3,"file":"format-special-cases.mjs","names":[],"sources":["../../../../string-format/src/format-special-cases.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { ACRONYMS } from \"./acronyms\";\nimport { ARTICLES } from \"./articles\";\nimport { CONJUNCTIONS } from \"./conjunctions\";\nimport { PREPOSITIONS } from \"./prepositions\";\nimport { SPECIAL_CASES } from \"./special-cases\";\n\nexport interface FormatSpecialCasesOptions {\n  /**\n   * If true, use the descriptions from the acronym list instead of the display names.\n   *\n   * @defaultValue true\n   */\n  useDescriptions?: boolean;\n}\n\n/**\n * Handle special words in a title.\n *\n * @see https://apastyle.apa.org/style-grammar-guidelines/capitalization/title-case\n *\n * @param value - The word to handle\n * @param index - The index of the word in the title\n * @param words - The full title as an array of words\n * @returns The formatted word\n */\nexport function formatSpecialCases(\n  value: string,\n  index: number,\n  words: string[],\n  options?: FormatSpecialCasesOptions\n): string {\n  const lowercaseStr = value.toLowerCase();\n  const uppercaseStr = value.toUpperCase();\n\n  for (const special of SPECIAL_CASES) {\n    if (special.toLowerCase() === lowercaseStr) {\n      return special;\n    }\n  }\n\n  if (ACRONYMS[uppercaseStr]) {\n    return options?.useDescriptions !== false\n      ? ACRONYMS[uppercaseStr].description\n      : ACRONYMS[uppercaseStr].display || uppercaseStr;\n  }\n\n  // If the word is the first word in the sentence, but it's not a specially\n  // cased word or an acronym, return the capitalized string\n  if (index === 0) {\n    return value;\n  }\n\n  // If the word is the last word in the sentence, but it's not a specially\n  // cased word or an acronym, return the capitalized string\n  if (index === words.length - 1) {\n    return value;\n  }\n\n  // Return the word capitalized if it's 4 characters or more\n  if (value.length >= 4) {\n    return value;\n  }\n\n  if (PREPOSITIONS.includes(lowercaseStr)) {\n    return lowercaseStr;\n  }\n  if (CONJUNCTIONS.includes(lowercaseStr)) {\n    return lowercaseStr;\n  }\n  if (ARTICLES.includes(lowercaseStr)) {\n    return lowercaseStr;\n  }\n\n  return value;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA2CA,SAAgB,mBACd,OACA,OACA,OACA,SACQ;CACR,MAAM,eAAe,MAAM,aAAa;CACxC,MAAM,eAAe,MAAM,aAAa;AAExC,MAAK,MAAM,WAAW,cACpB,KAAI,QAAQ,aAAa,KAAK,aAC5B,QAAO;AAIX,KAAI,SAAS,cACX,QAAO,SAAS,oBAAoB,QAChC,SAAS,cAAc,cACvB,SAAS,cAAc,WAAW;AAKxC,KAAI,UAAU,EACZ,QAAO;AAKT,KAAI,UAAU,MAAM,SAAS,EAC3B,QAAO;AAIT,KAAI,MAAM,UAAU,EAClB,QAAO;AAGT,KAAI,aAAa,SAAS,aAAa,CACrC,QAAO;AAET,KAAI,aAAa,SAAS,aAAa,CACrC,QAAO;AAET,KAAI,SAAS,SAAS,aAAa,CACjC,QAAO;AAGT,QAAO"}

package/dist/string-format/src/prepositions.cjs

@@ -1 +1,68 @@
-const e=`about.above.across.after.against.along.among.around.at.because of.before.behind.below.beneath.beside.besides.between.beyond.but.by.concerning.despite.down.during.except.excepting.for.from.in.in front of.inside.in spite of.instead of.into.like.near.of.off.on.onto.out.outside.over.past.regarding.since.through.throughout.to.toward.under.underneath.until.up.upon.up to.with.within.without.with regard to.with respect to`.split(`.`);exports.PREPOSITIONS=e;
+
+//#region ../string-format/src/prepositions.ts
+const PREPOSITIONS = [
+	"about",
+	"above",
+	"across",
+	"after",
+	"against",
+	"along",
+	"among",
+	"around",
+	"at",
+	"because of",
+	"before",
+	"behind",
+	"below",
+	"beneath",
+	"beside",
+	"besides",
+	"between",
+	"beyond",
+	"but",
+	"by",
+	"concerning",
+	"despite",
+	"down",
+	"during",
+	"except",
+	"excepting",
+	"for",
+	"from",
+	"in",
+	"in front of",
+	"inside",
+	"in spite of",
+	"instead of",
+	"into",
+	"like",
+	"near",
+	"of",
+	"off",
+	"on",
+	"onto",
+	"out",
+	"outside",
+	"over",
+	"past",
+	"regarding",
+	"since",
+	"through",
+	"throughout",
+	"to",
+	"toward",
+	"under",
+	"underneath",
+	"until",
+	"up",
+	"upon",
+	"up to",
+	"with",
+	"within",
+	"without",
+	"with regard to",
+	"with respect to"
+];
+
+//#endregion
+exports.PREPOSITIONS = PREPOSITIONS;

package/dist/string-format/src/prepositions.mjs

@@ -1,2 +1,68 @@
-const e=`about.above.across.after.against.along.among.around.at.because of.before.behind.below.beneath.beside.besides.between.beyond.but.by.concerning.despite.down.during.except.excepting.for.from.in.in front of.inside.in spite of.instead of.into.like.near.of.off.on.onto.out.outside.over.past.regarding.since.through.throughout.to.toward.under.underneath.until.up.upon.up to.with.within.without.with regard to.with respect to`.split(`.`);export{e as PREPOSITIONS};
+//#region ../string-format/src/prepositions.ts
+const PREPOSITIONS = [
+	"about",
+	"above",
+	"across",
+	"after",
+	"against",
+	"along",
+	"among",
+	"around",
+	"at",
+	"because of",
+	"before",
+	"behind",
+	"below",
+	"beneath",
+	"beside",
+	"besides",
+	"between",
+	"beyond",
+	"but",
+	"by",
+	"concerning",
+	"despite",
+	"down",
+	"during",
+	"except",
+	"excepting",
+	"for",
+	"from",
+	"in",
+	"in front of",
+	"inside",
+	"in spite of",
+	"instead of",
+	"into",
+	"like",
+	"near",
+	"of",
+	"off",
+	"on",
+	"onto",
+	"out",
+	"outside",
+	"over",
+	"past",
+	"regarding",
+	"since",
+	"through",
+	"throughout",
+	"to",
+	"toward",
+	"under",
+	"underneath",
+	"until",
+	"up",
+	"upon",
+	"up to",
+	"with",
+	"within",
+	"without",
+	"with regard to",
+	"with respect to"
+];
+
+//#endregion
+export { PREPOSITIONS };
 //# sourceMappingURL=prepositions.mjs.map

package/dist/string-format/src/prepositions.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"prepositions.mjs","names":[],"sources":["../../../../string-format/src/prepositions.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport const PREPOSITIONS = [\n  \"about\",\n  \"above\",\n  \"across\",\n  \"after\",\n  \"against\",\n  \"along\",\n  \"among\",\n  \"around\",\n  \"at\",\n  \"because of\",\n  \"before\",\n  \"behind\",\n  \"below\",\n  \"beneath\",\n  \"beside\",\n  \"besides\",\n  \"between\",\n  \"beyond\",\n  \"but\",\n  \"by\",\n  \"concerning\",\n  \"despite\",\n  \"down\",\n  \"during\",\n  \"except\",\n  \"excepting\",\n  \"for\",\n  \"from\",\n  \"in\",\n  \"in front of\",\n  \"inside\",\n  \"in spite of\",\n  \"instead of\",\n  \"into\",\n  \"like\",\n  \"near\",\n  \"of\",\n  \"off\",\n  \"on\",\n  \"onto\",\n  \"out\",\n  \"outside\",\n  \"over\",\n  \"past\",\n  \"regarding\",\n  \"since\",\n  \"through\",\n  \"throughout\",\n  \"to\",\n  \"toward\",\n  \"under\",\n  \"underneath\",\n  \"until\",\n  \"up\",\n  \"upon\",\n  \"up to\",\n  \"with\",\n  \"within\",\n  \"without\",\n  \"with regard to\",\n  \"with respect to\"\n];\n"],"mappings":"AAkBA,MAAa,EAAe,8aA8D3B"}
+{"version":3,"file":"prepositions.mjs","names":[],"sources":["../../../../string-format/src/prepositions.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport const PREPOSITIONS = [\n  \"about\",\n  \"above\",\n  \"across\",\n  \"after\",\n  \"against\",\n  \"along\",\n  \"among\",\n  \"around\",\n  \"at\",\n  \"because of\",\n  \"before\",\n  \"behind\",\n  \"below\",\n  \"beneath\",\n  \"beside\",\n  \"besides\",\n  \"between\",\n  \"beyond\",\n  \"but\",\n  \"by\",\n  \"concerning\",\n  \"despite\",\n  \"down\",\n  \"during\",\n  \"except\",\n  \"excepting\",\n  \"for\",\n  \"from\",\n  \"in\",\n  \"in front of\",\n  \"inside\",\n  \"in spite of\",\n  \"instead of\",\n  \"into\",\n  \"like\",\n  \"near\",\n  \"of\",\n  \"off\",\n  \"on\",\n  \"onto\",\n  \"out\",\n  \"outside\",\n  \"over\",\n  \"past\",\n  \"regarding\",\n  \"since\",\n  \"through\",\n  \"throughout\",\n  \"to\",\n  \"toward\",\n  \"under\",\n  \"underneath\",\n  \"until\",\n  \"up\",\n  \"upon\",\n  \"up to\",\n  \"with\",\n  \"within\",\n  \"without\",\n  \"with regard to\",\n  \"with respect to\"\n];\n"],"mappings":";AAkBA,MAAa,eAAe;CAC1B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}

package/dist/string-format/src/special-cases.cjs

@@ -1 +1,53 @@
-const e=`2FA.4K.5K.8K.AGI.BI.ChatGPT.CTA.DateTime.FMS.GitHub.GPT.HD.IBMid.IDs.iMac.IMAX.iOS.iPad.iPhone.iPod.LDAP.LinkedIn.LLM.macOS.McDonalds.MCP.ML.MySQL.NLG.NLP.NLU.OpenAI.PDFs.PIM.PEFT.pH.PostgreSQL.SEO.TTS.UHD.UUID.XSS.YouTube.CSpell.ESLint`.split(`.`);exports.SPECIAL_CASES=e;
+
+//#region ../string-format/src/special-cases.ts
+const SPECIAL_CASES = [
+	"2FA",
+	"4K",
+	"5K",
+	"8K",
+	"AGI",
+	"BI",
+	"ChatGPT",
+	"CTA",
+	"DateTime",
+	"FMS",
+	"GitHub",
+	"GPT",
+	"HD",
+	"IBMid",
+	"IDs",
+	"iMac",
+	"IMAX",
+	"iOS",
+	"iPad",
+	"iPhone",
+	"iPod",
+	"LDAP",
+	"LinkedIn",
+	"LLM",
+	"macOS",
+	"McDonalds",
+	"MCP",
+	"ML",
+	"MySQL",
+	"NLG",
+	"NLP",
+	"NLU",
+	"OpenAI",
+	"PDFs",
+	"PIM",
+	"PEFT",
+	"pH",
+	"PostgreSQL",
+	"SEO",
+	"TTS",
+	"UHD",
+	"UUID",
+	"XSS",
+	"YouTube",
+	"CSpell",
+	"ESLint"
+];
+
+//#endregion
+exports.SPECIAL_CASES = SPECIAL_CASES;

package/dist/string-format/src/special-cases.mjs

@@ -1,2 +1,53 @@
-const e=`2FA.4K.5K.8K.AGI.BI.ChatGPT.CTA.DateTime.FMS.GitHub.GPT.HD.IBMid.IDs.iMac.IMAX.iOS.iPad.iPhone.iPod.LDAP.LinkedIn.LLM.macOS.McDonalds.MCP.ML.MySQL.NLG.NLP.NLU.OpenAI.PDFs.PIM.PEFT.pH.PostgreSQL.SEO.TTS.UHD.UUID.XSS.YouTube.CSpell.ESLint`.split(`.`);export{e as SPECIAL_CASES};
+//#region ../string-format/src/special-cases.ts
+const SPECIAL_CASES = [
+	"2FA",
+	"4K",
+	"5K",
+	"8K",
+	"AGI",
+	"BI",
+	"ChatGPT",
+	"CTA",
+	"DateTime",
+	"FMS",
+	"GitHub",
+	"GPT",
+	"HD",
+	"IBMid",
+	"IDs",
+	"iMac",
+	"IMAX",
+	"iOS",
+	"iPad",
+	"iPhone",
+	"iPod",
+	"LDAP",
+	"LinkedIn",
+	"LLM",
+	"macOS",
+	"McDonalds",
+	"MCP",
+	"ML",
+	"MySQL",
+	"NLG",
+	"NLP",
+	"NLU",
+	"OpenAI",
+	"PDFs",
+	"PIM",
+	"PEFT",
+	"pH",
+	"PostgreSQL",
+	"SEO",
+	"TTS",
+	"UHD",
+	"UUID",
+	"XSS",
+	"YouTube",
+	"CSpell",
+	"ESLint"
+];
+
+//#endregion
+export { SPECIAL_CASES };
 //# sourceMappingURL=special-cases.mjs.map

package/dist/string-format/src/special-cases.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"special-cases.mjs","names":[],"sources":["../../../../string-format/src/special-cases.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport const SPECIAL_CASES = [\n  \"2FA\",\n  \"4K\",\n  \"5K\",\n  \"8K\",\n  \"AGI\",\n  \"BI\",\n  \"ChatGPT\",\n  \"CTA\",\n  \"DateTime\",\n  \"FMS\",\n  \"GitHub\",\n  \"GPT\",\n  \"HD\",\n  \"IBMid\",\n  \"IDs\",\n  \"iMac\",\n  \"IMAX\",\n  \"iOS\",\n  \"iPad\",\n  \"iPhone\",\n  \"iPod\",\n  \"LDAP\",\n  \"LinkedIn\",\n  \"LLM\",\n  \"macOS\",\n  \"McDonalds\",\n  \"MCP\",\n  \"ML\",\n  \"MySQL\",\n  \"NLG\",\n  \"NLP\",\n  \"NLU\",\n  \"OpenAI\",\n  \"PDFs\",\n  \"PIM\",\n  \"PEFT\",\n  \"pH\",\n  \"PostgreSQL\",\n  \"SEO\",\n  \"TTS\",\n  \"UHD\",\n  \"UUID\",\n  \"XSS\",\n  \"YouTube\",\n  \"CSpell\",\n  \"ESLint\"\n];\n"],"mappings":"AAkBA,MAAa,EAAgB,yPA+C5B"}
+{"version":3,"file":"special-cases.mjs","names":[],"sources":["../../../../string-format/src/special-cases.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport const SPECIAL_CASES = [\n  \"2FA\",\n  \"4K\",\n  \"5K\",\n  \"8K\",\n  \"AGI\",\n  \"BI\",\n  \"ChatGPT\",\n  \"CTA\",\n  \"DateTime\",\n  \"FMS\",\n  \"GitHub\",\n  \"GPT\",\n  \"HD\",\n  \"IBMid\",\n  \"IDs\",\n  \"iMac\",\n  \"IMAX\",\n  \"iOS\",\n  \"iPad\",\n  \"iPhone\",\n  \"iPod\",\n  \"LDAP\",\n  \"LinkedIn\",\n  \"LLM\",\n  \"macOS\",\n  \"McDonalds\",\n  \"MCP\",\n  \"ML\",\n  \"MySQL\",\n  \"NLG\",\n  \"NLP\",\n  \"NLU\",\n  \"OpenAI\",\n  \"PDFs\",\n  \"PIM\",\n  \"PEFT\",\n  \"pH\",\n  \"PostgreSQL\",\n  \"SEO\",\n  \"TTS\",\n  \"UHD\",\n  \"UUID\",\n  \"XSS\",\n  \"YouTube\",\n  \"CSpell\",\n  \"ESLint\"\n];\n"],"mappings":";AAkBA,MAAa,gBAAgB;CAC3B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}

package/dist/string-format/src/title-case.cjs

@@ -1 +1,19 @@
-const e=require(`./combine.cjs`),t=require(`./decamelize.cjs`),n=require(`./format-special-cases.cjs`),r=require(`./upper-case-first.cjs`);function i(i,a){return i?.split(/\s+-\s+/).map(i=>t.decamelize(i).split(/[\s\-_]/).map(r.upperCaseFirst).map((e,t,r)=>n.formatSpecialCases(e,t,r,a)).reduce(e.combine)).join(` - `)}exports.titleCase=i;
+const require_combine = require('./combine.cjs');
+const require_decamelize = require('./decamelize.cjs');
+const require_format_special_cases = require('./format-special-cases.cjs');
+const require_upper_case_first = require('./upper-case-first.cjs');
+
+//#region ../string-format/src/title-case.ts
+/**
+* Convert a string to title case.
+*
+* @param input - The input string to convert.
+* @param options - Options for formatting special cases.
+* @returns The title cased string.
+*/
+function titleCase(input, options) {
+	return input?.split(/\s+-\s+/).map((segment) => require_decamelize.decamelize(segment).split(/[\s\-_]/).map(require_upper_case_first.upperCaseFirst).map((value, index, array) => require_format_special_cases.formatSpecialCases(value, index, array, options)).reduce(require_combine.combine)).join(" - ");
+}
+
+//#endregion
+exports.titleCase = titleCase;

package/dist/string-format/src/title-case.mjs

@@ -1,2 +1,20 @@
-import{combine as e}from"./combine.mjs";import{decamelize as t}from"./decamelize.mjs";import{formatSpecialCases as n}from"./format-special-cases.mjs";import{upperCaseFirst as r}from"./upper-case-first.mjs";function i(i,a){return i?.split(/\s+-\s+/).map(i=>t(i).split(/[\s\-_]/).map(r).map((e,t,r)=>n(e,t,r,a)).reduce(e)).join(` - `)}export{i as titleCase};
+import { combine } from "./combine.mjs";
+import { decamelize } from "./decamelize.mjs";
+import { formatSpecialCases } from "./format-special-cases.mjs";
+import { upperCaseFirst } from "./upper-case-first.mjs";
+
+//#region ../string-format/src/title-case.ts
+/**
+* Convert a string to title case.
+*
+* @param input - The input string to convert.
+* @param options - Options for formatting special cases.
+* @returns The title cased string.
+*/
+function titleCase(input, options) {
+	return input?.split(/\s+-\s+/).map((segment) => decamelize(segment).split(/[\s\-_]/).map(upperCaseFirst).map((value, index, array) => formatSpecialCases(value, index, array, options)).reduce(combine)).join(" - ");
+}
+
+//#endregion
+export { titleCase };
 //# sourceMappingURL=title-case.mjs.map

package/dist/string-format/src/title-case.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"title-case.mjs","names":[],"sources":["../../../../string-format/src/title-case.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { combine } from \"./combine\";\nimport { decamelize } from \"./decamelize\";\nimport type { FormatSpecialCasesOptions } from \"./format-special-cases\";\nimport { formatSpecialCases } from \"./format-special-cases\";\nimport { upperCaseFirst } from \"./upper-case-first\";\n\n/**\n * Convert a string to title case.\n *\n * @param input - The input string to convert.\n * @param options - Options for formatting special cases.\n * @returns The title cased string.\n */\nexport function titleCase<T extends string | undefined>(\n  input: T,\n  options?: FormatSpecialCasesOptions\n): T {\n  return input\n    ?.split(/\\s+-\\s+/)\n    .map(segment =>\n      decamelize(segment)\n        .split(/[\\s\\-_]/)\n        .map(upperCaseFirst)\n        .map((value: string, index: number, array: string[]) =>\n          formatSpecialCases(value, index, array, options)\n        )\n        .reduce(combine)\n    )\n    .join(\" - \") as T;\n}\n"],"mappings":"8MA+BA,SAAgB,EACd,EACA,EACG,CACH,OAAO,GACH,MAAM,UAAU,CACjB,IAAI,GACH,EAAW,EAAQ,CAChB,MAAM,UAAU,CAChB,IAAI,EAAe,CACnB,KAAK,EAAe,EAAe,IAClC,EAAmB,EAAO,EAAO,EAAO,EAAQ,CACjD,CACA,OAAO,EAAQ,CACnB,CACA,KAAK,MAAM"}
+{"version":3,"file":"title-case.mjs","names":[],"sources":["../../../../string-format/src/title-case.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { combine } from \"./combine\";\nimport { decamelize } from \"./decamelize\";\nimport type { FormatSpecialCasesOptions } from \"./format-special-cases\";\nimport { formatSpecialCases } from \"./format-special-cases\";\nimport { upperCaseFirst } from \"./upper-case-first\";\n\n/**\n * Convert a string to title case.\n *\n * @param input - The input string to convert.\n * @param options - Options for formatting special cases.\n * @returns The title cased string.\n */\nexport function titleCase<T extends string | undefined>(\n  input: T,\n  options?: FormatSpecialCasesOptions\n): T {\n  return input\n    ?.split(/\\s+-\\s+/)\n    .map(segment =>\n      decamelize(segment)\n        .split(/[\\s\\-_]/)\n        .map(upperCaseFirst)\n        .map((value: string, index: number, array: string[]) =>\n          formatSpecialCases(value, index, array, options)\n        )\n        .reduce(combine)\n    )\n    .join(\" - \") as T;\n}\n"],"mappings":";;;;;;;;;;;;;AA+BA,SAAgB,UACd,OACA,SACG;AACH,QAAO,OACH,MAAM,UAAU,CACjB,KAAI,YACH,WAAW,QAAQ,CAChB,MAAM,UAAU,CAChB,IAAI,eAAe,CACnB,KAAK,OAAe,OAAe,UAClC,mBAAmB,OAAO,OAAO,OAAO,QAAQ,CACjD,CACA,OAAO,QAAQ,CACnB,CACA,KAAK,MAAM"}

package/dist/string-format/src/upper-case-first.cjs

@@ -1 +1,17 @@
-function e(e){return e&&e.charAt(0).toUpperCase()+e.slice(1)}exports.upperCaseFirst=e;
+
+//#region ../string-format/src/upper-case-first.ts
+/**
+* Upper case the first character of an input string.
+*
+*  @remarks
+* "Thisisanexample"
+*
+* @param input - The input string.
+* @returns The capitalized string.
+*/
+function upperCaseFirst(input) {
+	return input ? input.charAt(0).toUpperCase() + input.slice(1) : input;
+}
+
+//#endregion
+exports.upperCaseFirst = upperCaseFirst;

package/dist/string-format/src/upper-case-first.mjs

@@ -1,2 +1,17 @@
-function e(e){return e&&e.charAt(0).toUpperCase()+e.slice(1)}export{e as upperCaseFirst};
+//#region ../string-format/src/upper-case-first.ts
+/**
+* Upper case the first character of an input string.
+*
+*  @remarks
+* "Thisisanexample"
+*
+* @param input - The input string.
+* @returns The capitalized string.
+*/
+function upperCaseFirst(input) {
+	return input ? input.charAt(0).toUpperCase() + input.slice(1) : input;
+}
+
+//#endregion
+export { upperCaseFirst };
 //# sourceMappingURL=upper-case-first.mjs.map