@stryke/string-format 0.14.8 → 0.17.0

package/CHANGELOG.md

@@ -2,6 +2,61 @@
 
 # Changelog for Stryke - String Format
 
+## [0.17.0](https://github.com/storm-software/stryke/releases/tag/string-format%400.17.0) (03/08/2026)
+
+### Features
+
+- **string-format:** Added the conjuction option to `list` helper ([058de0bc](https://github.com/storm-software/stryke/commit/058de0bc))
+
+### Updated Dependencies
+
+- Updated **helpers** to **v0.10.0**
+- Updated **types** to **v0.10.49**
+- Updated **path** to **v0.26.16**
+
+## [0.16.0](https://github.com/storm-software/stryke/releases/tag/string-format%400.16.0) (03/06/2026)
+
+### Features
+
+- **string-format:** Added the `expandAcronyms` option to `titleCase` helper ([e2fef657](https://github.com/storm-software/stryke/commit/e2fef657))
+
+### Updated Dependencies
+
+- Updated **helpers** to **v0.9.51**
+- Updated **types** to **v0.10.48**
+- Updated **path** to **v0.26.15**
+
+## [0.15.1](https://github.com/storm-software/stryke/releases/tag/string-format%400.15.1) (03/06/2026)
+
+### Updated Dependencies
+
+- Updated **helpers** to **v0.9.50**
+- Updated **types** to **v0.10.47**
+- Updated **path** to **v0.26.14**
+
+## [0.15.0](https://github.com/storm-software/stryke/releases/tag/string-format%400.15.0) (03/06/2026)
+
+### Bug Fixes
+
+- **string-format:** Added misssing `exports` to package ([8972efdc](https://github.com/storm-software/stryke/commit/8972efdc))
+
+### Features
+
+- **string-format:** Added `list` and `prettyPath` helper functions ([c9071abc](https://github.com/storm-software/stryke/commit/c9071abc))
+
+### Updated Dependencies
+
+- Updated **helpers** to **v0.9.49**
+- Updated **types** to **v0.10.46**
+- Updated **path** to **v0.26.13**
+
+## [0.14.8](https://github.com/storm-software/stryke/releases/tag/string-format%400.14.8) (03/03/2026)
+
+### Updated Dependencies
+
+- Updated **helpers** to **v0.9.48**
+- Updated **types** to **v0.10.45**
+
 ## [0.14.7](https://github.com/storm-software/stryke/releases/tag/string-format%400.14.7) (03/03/2026)
 
 ### Updated Dependencies

package/dist/index.cjs

@@ -14,6 +14,7 @@ const require_prepositions = require('./prepositions.cjs');
 const require_special_cases = require('./special-cases.cjs');
 const require_format_special_cases = require('./format-special-cases.cjs');
 const require_kebab_case = require('./kebab-case.cjs');
+const require_list = require('./list.cjs');
 const require_lower_case_first = require('./lower-case-first.cjs');
 const require_normalize_email = require('./normalize-email.cjs');
 const require_ordinals = require('./ordinals.cjs');
@@ -22,6 +23,7 @@ const require_pad = require('./pad.cjs');
 const require_pascal_case = require('./pascal-case.cjs');
 const require_period_split = require('./period-split.cjs');
 const require_pretty_bytes = require('./pretty-bytes.cjs');
+const require_pretty_path = require('./pretty-path.cjs');
 const require_start_case = require('./start-case.cjs');
 const require_strip_indents = require('./strip-indents.cjs');
 const require_title_case = require('./title-case.cjs');
@@ -60,12 +62,14 @@ exports.isSnakeCase = require_snake_case.isSnakeCase;
 exports.isStartCase = require_start_case.isStartCase;
 exports.isVowel = require_vowels.isVowel;
 exports.kebabCase = require_kebab_case.kebabCase;
+exports.list = require_list.list;
 exports.lowerCaseFirst = require_lower_case_first.lowerCaseFirst;
 exports.normalizeEmail = require_normalize_email.normalizeEmail;
 exports.pad = require_pad.pad;
 exports.pascalCase = require_pascal_case.pascalCase;
 exports.periodSplit = require_period_split.periodSplit;
 exports.prettyBytes = require_pretty_bytes.prettyBytes;
+exports.prettyPath = require_pretty_path.prettyPath;
 exports.removePackageVersion = require_package.removePackageVersion;
 exports.snakeCase = require_snake_case.snakeCase;
 exports.startCase = require_start_case.startCase;

package/dist/index.d.cts

@@ -10,6 +10,7 @@ import { escapeHtml, escapeRegExp } from "./escape.cjs";
 import { FormatSpecialCasesOptions, formatSpecialCases } from "./format-special-cases.cjs";
 import { CASE_SPLIT_PATTERN, GetWordsOptions, RELAXED_SPLIT_PATTERN, getWords } from "./get-words.cjs";
 import { isKebabCase, kebabCase } from "./kebab-case.cjs";
+import { ListOptions, list } from "./list.cjs";
 import { lowerCaseFirst } from "./lower-case-first.cjs";
 import { normalizeEmail } from "./normalize-email.cjs";
 import { toOrdinal } from "./ordinals.cjs";
@@ -19,12 +20,13 @@ import { isPascalCase, pascalCase } from "./pascal-case.cjs";
 import { isPeriodSplit, periodSplit } from "./period-split.cjs";
 import { PREPOSITIONS } from "./prepositions.cjs";
 import { Options, prettyBytes, toLocaleString } from "./pretty-bytes.cjs";
+import { PrettyPathOptions, prettyPath } from "./pretty-path.cjs";
 import { SnakeCaseOptions, isSnakeCase, snakeCase } from "./snake-case.cjs";
 import { SPECIAL_CASES } from "./special-cases.cjs";
 import { isStartCase, startCase } from "./start-case.cjs";
 import { stripIndents } from "./strip-indents.cjs";
-import { titleCase } from "./title-case.cjs";
+import { TitleCaseOptions, titleCase } from "./title-case.cjs";
 import { unescape } from "./unescape.cjs";
 import { upperCaseFirst } from "./upper-case-first.cjs";
 import { getIndefiniteArticle, isVowel } from "./vowels.cjs";
-export { ACRONYMS, ACRONYM_DESCRIPTION, ACRONYM_DISPLAY, ACRONYM_LIST, ARTICLES, CASE_SPLIT_PATTERN, CONJUNCTIONS, FormatSpecialCasesOptions, GetWordsOptions, Options, PREPOSITIONS, RELAXED_SPLIT_PATTERN, SPECIAL_CASES, SnakeCaseOptions, camelCase, combine, constantCase, deburr, decamelize, escapeHtml, escapeRegExp, formatSpecialCases, getIndefiniteArticle, getPackageName, getPackageVersion, getWords, hasPackageVersion, isCamelCase, isConstantCase, isKebabCase, isPascalCase, isPeriodSplit, isSnakeCase, isStartCase, isVowel, kebabCase, lowerCaseFirst, normalizeEmail, pad, pascalCase, periodSplit, prettyBytes, removePackageVersion, snakeCase, startCase, stripIndents, titleCase, toLocaleString, toOrdinal, unescape, upperCaseFirst };
+export { ACRONYMS, ACRONYM_DESCRIPTION, ACRONYM_DISPLAY, ACRONYM_LIST, ARTICLES, CASE_SPLIT_PATTERN, CONJUNCTIONS, FormatSpecialCasesOptions, GetWordsOptions, ListOptions, Options, PREPOSITIONS, PrettyPathOptions, RELAXED_SPLIT_PATTERN, SPECIAL_CASES, SnakeCaseOptions, TitleCaseOptions, camelCase, combine, constantCase, deburr, decamelize, escapeHtml, escapeRegExp, formatSpecialCases, getIndefiniteArticle, getPackageName, getPackageVersion, getWords, hasPackageVersion, isCamelCase, isConstantCase, isKebabCase, isPascalCase, isPeriodSplit, isSnakeCase, isStartCase, isVowel, kebabCase, list, lowerCaseFirst, normalizeEmail, pad, pascalCase, periodSplit, prettyBytes, prettyPath, removePackageVersion, snakeCase, startCase, stripIndents, titleCase, toLocaleString, toOrdinal, unescape, upperCaseFirst };

package/dist/index.d.mts

@@ -10,6 +10,7 @@ import { escapeHtml, escapeRegExp } from "./escape.mjs";
 import { FormatSpecialCasesOptions, formatSpecialCases } from "./format-special-cases.mjs";
 import { CASE_SPLIT_PATTERN, GetWordsOptions, RELAXED_SPLIT_PATTERN, getWords } from "./get-words.mjs";
 import { isKebabCase, kebabCase } from "./kebab-case.mjs";
+import { ListOptions, list } from "./list.mjs";
 import { lowerCaseFirst } from "./lower-case-first.mjs";
 import { normalizeEmail } from "./normalize-email.mjs";
 import { toOrdinal } from "./ordinals.mjs";
@@ -19,12 +20,13 @@ import { isPascalCase, pascalCase } from "./pascal-case.mjs";
 import { isPeriodSplit, periodSplit } from "./period-split.mjs";
 import { PREPOSITIONS } from "./prepositions.mjs";
 import { Options, prettyBytes, toLocaleString } from "./pretty-bytes.mjs";
+import { PrettyPathOptions, prettyPath } from "./pretty-path.mjs";
 import { SnakeCaseOptions, isSnakeCase, snakeCase } from "./snake-case.mjs";
 import { SPECIAL_CASES } from "./special-cases.mjs";
 import { isStartCase, startCase } from "./start-case.mjs";
 import { stripIndents } from "./strip-indents.mjs";
-import { titleCase } from "./title-case.mjs";
+import { TitleCaseOptions, titleCase } from "./title-case.mjs";
 import { unescape } from "./unescape.mjs";
 import { upperCaseFirst } from "./upper-case-first.mjs";
 import { getIndefiniteArticle, isVowel } from "./vowels.mjs";
-export { ACRONYMS, ACRONYM_DESCRIPTION, ACRONYM_DISPLAY, ACRONYM_LIST, ARTICLES, CASE_SPLIT_PATTERN, CONJUNCTIONS, FormatSpecialCasesOptions, GetWordsOptions, Options, PREPOSITIONS, RELAXED_SPLIT_PATTERN, SPECIAL_CASES, SnakeCaseOptions, camelCase, combine, constantCase, deburr, decamelize, escapeHtml, escapeRegExp, formatSpecialCases, getIndefiniteArticle, getPackageName, getPackageVersion, getWords, hasPackageVersion, isCamelCase, isConstantCase, isKebabCase, isPascalCase, isPeriodSplit, isSnakeCase, isStartCase, isVowel, kebabCase, lowerCaseFirst, normalizeEmail, pad, pascalCase, periodSplit, prettyBytes, removePackageVersion, snakeCase, startCase, stripIndents, titleCase, toLocaleString, toOrdinal, unescape, upperCaseFirst };
+export { ACRONYMS, ACRONYM_DESCRIPTION, ACRONYM_DISPLAY, ACRONYM_LIST, ARTICLES, CASE_SPLIT_PATTERN, CONJUNCTIONS, FormatSpecialCasesOptions, GetWordsOptions, ListOptions, Options, PREPOSITIONS, PrettyPathOptions, RELAXED_SPLIT_PATTERN, SPECIAL_CASES, SnakeCaseOptions, TitleCaseOptions, camelCase, combine, constantCase, deburr, decamelize, escapeHtml, escapeRegExp, formatSpecialCases, getIndefiniteArticle, getPackageName, getPackageVersion, getWords, hasPackageVersion, isCamelCase, isConstantCase, isKebabCase, isPascalCase, isPeriodSplit, isSnakeCase, isStartCase, isVowel, kebabCase, list, lowerCaseFirst, normalizeEmail, pad, pascalCase, periodSplit, prettyBytes, prettyPath, removePackageVersion, snakeCase, startCase, stripIndents, titleCase, toLocaleString, toOrdinal, unescape, upperCaseFirst };

package/dist/index.mjs

@@ -14,6 +14,7 @@ import { PREPOSITIONS } from "./prepositions.mjs";
 import { SPECIAL_CASES } from "./special-cases.mjs";
 import { formatSpecialCases } from "./format-special-cases.mjs";
 import { isKebabCase, kebabCase } from "./kebab-case.mjs";
+import { list } from "./list.mjs";
 import { lowerCaseFirst } from "./lower-case-first.mjs";
 import { normalizeEmail } from "./normalize-email.mjs";
 import { toOrdinal } from "./ordinals.mjs";
@@ -22,10 +23,11 @@ import { pad } from "./pad.mjs";
 import { isPascalCase, pascalCase } from "./pascal-case.mjs";
 import { isPeriodSplit, periodSplit } from "./period-split.mjs";
 import { prettyBytes, toLocaleString } from "./pretty-bytes.mjs";
+import { prettyPath } from "./pretty-path.mjs";
 import { isStartCase, startCase } from "./start-case.mjs";
 import { stripIndents } from "./strip-indents.mjs";
 import { titleCase } from "./title-case.mjs";
 import { unescape } from "./unescape.mjs";
 import { getIndefiniteArticle, isVowel } from "./vowels.mjs";
 
-export { ACRONYMS, ACRONYM_DESCRIPTION, ACRONYM_DISPLAY, ACRONYM_LIST, ARTICLES, CASE_SPLIT_PATTERN, CONJUNCTIONS, PREPOSITIONS, RELAXED_SPLIT_PATTERN, SPECIAL_CASES, camelCase, combine, constantCase, deburr, decamelize, escapeHtml, escapeRegExp, formatSpecialCases, getIndefiniteArticle, getPackageName, getPackageVersion, getWords, hasPackageVersion, isCamelCase, isConstantCase, isKebabCase, isPascalCase, isPeriodSplit, isSnakeCase, isStartCase, isVowel, kebabCase, lowerCaseFirst, normalizeEmail, pad, pascalCase, periodSplit, prettyBytes, removePackageVersion, snakeCase, startCase, stripIndents, titleCase, toLocaleString, toOrdinal, unescape, upperCaseFirst };
+export { ACRONYMS, ACRONYM_DESCRIPTION, ACRONYM_DISPLAY, ACRONYM_LIST, ARTICLES, CASE_SPLIT_PATTERN, CONJUNCTIONS, PREPOSITIONS, RELAXED_SPLIT_PATTERN, SPECIAL_CASES, camelCase, combine, constantCase, deburr, decamelize, escapeHtml, escapeRegExp, formatSpecialCases, getIndefiniteArticle, getPackageName, getPackageVersion, getWords, hasPackageVersion, isCamelCase, isConstantCase, isKebabCase, isPascalCase, isPeriodSplit, isSnakeCase, isStartCase, isVowel, kebabCase, list, lowerCaseFirst, normalizeEmail, pad, pascalCase, periodSplit, prettyBytes, prettyPath, removePackageVersion, snakeCase, startCase, stripIndents, titleCase, toLocaleString, toOrdinal, unescape, upperCaseFirst };

package/dist/list.cjs

@@ -0,0 +1,26 @@
+
+//#region src/list.ts
+/**
+* Convert an array of strings into a human-readable list string.
+*
+* @example
+* list(["apple", "banana", "cherry"]) // "apple, banana, and cherry"
+* list(["apple", "banana"]) // "apple and banana"
+* list(["apple"]) // "apple"
+* list("apple") // "apple"
+*
+* @param strings - The array of strings or a single string to convert into a list.
+* @returns The converted list string.
+*/
+function list(strings, options = {}) {
+	const { conjunction = "and" } = options;
+	if (typeof strings === "string") return strings;
+	if (strings.length === 0) return "";
+	if (strings.length === 1) return strings[0];
+	if (strings.length === 2) return `${strings[0]} ${conjunction} ${strings[1]}`;
+	const last = strings.pop();
+	return `${strings.join(", ")}, ${conjunction} ${last}`;
+}
+
+//#endregion
+exports.list = list;

package/dist/list.d.cts

@@ -0,0 +1,25 @@
+//#region src/list.d.ts
+interface ListOptions {
+  /**
+   * The conjunction to use when joining the last two items in the list.
+   *
+   * @defaultValue "and"
+   */
+  conjunction?: string;
+}
+/**
+ * Convert an array of strings into a human-readable list string.
+ *
+ * @example
+ * list(["apple", "banana", "cherry"]) // "apple, banana, and cherry"
+ * list(["apple", "banana"]) // "apple and banana"
+ * list(["apple"]) // "apple"
+ * list("apple") // "apple"
+ *
+ * @param strings - The array of strings or a single string to convert into a list.
+ * @returns The converted list string.
+ */
+declare function list(strings: string | string[], options?: ListOptions): string;
+//#endregion
+export { ListOptions, list };
+//# sourceMappingURL=list.d.cts.map

package/dist/list.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.cts","names":[],"sources":["../src/list.ts"],"sourcesContent":[],"mappings":";UAkBiB,WAAA;EAAA;AAqBjB;;;;;;;;;;;;;;;;;;iBAAgB,IAAA,uCAEL"}

package/dist/list.d.mts

@@ -0,0 +1,25 @@
+//#region src/list.d.ts
+interface ListOptions {
+  /**
+   * The conjunction to use when joining the last two items in the list.
+   *
+   * @defaultValue "and"
+   */
+  conjunction?: string;
+}
+/**
+ * Convert an array of strings into a human-readable list string.
+ *
+ * @example
+ * list(["apple", "banana", "cherry"]) // "apple, banana, and cherry"
+ * list(["apple", "banana"]) // "apple and banana"
+ * list(["apple"]) // "apple"
+ * list("apple") // "apple"
+ *
+ * @param strings - The array of strings or a single string to convert into a list.
+ * @returns The converted list string.
+ */
+declare function list(strings: string | string[], options?: ListOptions): string;
+//#endregion
+export { ListOptions, list };
+//# sourceMappingURL=list.d.mts.map

package/dist/list.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.mts","names":[],"sources":["../src/list.ts"],"sourcesContent":[],"mappings":";UAkBiB,WAAA;EAAA;AAqBjB;;;;;;;;;;;;;;;;;;iBAAgB,IAAA,uCAEL"}

package/dist/list.mjs

@@ -0,0 +1,26 @@
+//#region src/list.ts
+/**
+* Convert an array of strings into a human-readable list string.
+*
+* @example
+* list(["apple", "banana", "cherry"]) // "apple, banana, and cherry"
+* list(["apple", "banana"]) // "apple and banana"
+* list(["apple"]) // "apple"
+* list("apple") // "apple"
+*
+* @param strings - The array of strings or a single string to convert into a list.
+* @returns The converted list string.
+*/
+function list(strings, options = {}) {
+	const { conjunction = "and" } = options;
+	if (typeof strings === "string") return strings;
+	if (strings.length === 0) return "";
+	if (strings.length === 1) return strings[0];
+	if (strings.length === 2) return `${strings[0]} ${conjunction} ${strings[1]}`;
+	const last = strings.pop();
+	return `${strings.join(", ")}, ${conjunction} ${last}`;
+}
+
+//#endregion
+export { list };
+//# sourceMappingURL=list.mjs.map

package/dist/list.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.mjs","names":[],"sources":["../src/list.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 interface ListOptions {\n  /**\n   * The conjunction to use when joining the last two items in the list.\n   *\n   * @defaultValue \"and\"\n   */\n  conjunction?: string;\n}\n\n/**\n * Convert an array of strings into a human-readable list string.\n *\n * @example\n * list([\"apple\", \"banana\", \"cherry\"]) // \"apple, banana, and cherry\"\n * list([\"apple\", \"banana\"]) // \"apple and banana\"\n * list([\"apple\"]) // \"apple\"\n * list(\"apple\") // \"apple\"\n *\n * @param strings - The array of strings or a single string to convert into a list.\n * @returns The converted list string.\n */\nexport function list(\n  strings: string | string[],\n  options: ListOptions = {}\n): string {\n  const { conjunction = \"and\" } = options;\n\n  if (typeof strings === \"string\") {\n    return strings;\n  }\n\n  if (strings.length === 0) {\n    return \"\";\n  }\n\n  if (strings.length === 1) {\n    return strings[0]!;\n  }\n\n  if (strings.length === 2) {\n    return `${strings[0]} ${conjunction} ${strings[1]}`;\n  }\n\n  const last = strings.pop();\n\n  return `${strings.join(\", \")}, ${conjunction} ${last}`;\n}\n"],"mappings":";;;;;;;;;;;;;AAuCA,SAAgB,KACd,SACA,UAAuB,EAAE,EACjB;CACR,MAAM,EAAE,cAAc,UAAU;AAEhC,KAAI,OAAO,YAAY,SACrB,QAAO;AAGT,KAAI,QAAQ,WAAW,EACrB,QAAO;AAGT,KAAI,QAAQ,WAAW,EACrB,QAAO,QAAQ;AAGjB,KAAI,QAAQ,WAAW,EACrB,QAAO,GAAG,QAAQ,GAAG,GAAG,YAAY,GAAG,QAAQ;CAGjD,MAAM,OAAO,QAAQ,KAAK;AAE1B,QAAO,GAAG,QAAQ,KAAK,KAAK,CAAC,IAAI,YAAY,GAAG"}

package/dist/path/src/correct-path.cjs

@@ -0,0 +1,120 @@
+const require_cwd = require('./cwd.cjs');
+const require_regex = require('./regex.cjs');
+const require_is_type = require('./is-type.cjs');
+const require_slash = require('./slash.cjs');
+const require_join_paths = require('./join-paths.cjs');
+
+//#region ../path/src/correct-path.ts
+function normalizeWindowsPath(input = "") {
+	if (!input) return input;
+	return require_slash.slash(input).replace(require_regex.DRIVE_LETTER_START_REGEX, (r) => r.toUpperCase());
+}
+/**
+* Corrects/normalized a file path.
+*
+* @param path - The path to correct.
+* @returns The corrected path.
+*/
+function correctPath(path) {
+	if (!path || path.length === 0) return ".";
+	path = normalizeWindowsPath(path);
+	const isUNCPath = path.match(require_regex.UNC_REGEX);
+	const isPathAbsolute = require_is_type.isAbsolutePath(path);
+	const trailingSeparator = path.endsWith("/");
+	path = normalizeString(path, !isPathAbsolute);
+	if (path.length === 0) {
+		if (isPathAbsolute) return "/";
+		return trailingSeparator ? "./" : ".";
+	}
+	if (trailingSeparator) path += "/";
+	if (require_regex.DRIVE_LETTER_REGEX.test(path)) path += "/";
+	if (isUNCPath) {
+		if (!isPathAbsolute) return `//./${path}`;
+		return `//${path}`;
+	}
+	return !path.startsWith("/") && isPathAbsolute && !require_regex.DRIVE_LETTER_REGEX.test(path) ? `/${path}` : path;
+}
+/**
+* Resolves a string path, resolving '.' and '.' segments and allowing paths above the root.
+*
+* @param path - The path to normalize.
+* @param allowAboveRoot - Whether to allow the resulting path to be above the root directory.
+* @returns the normalize path string.
+*/
+function normalizeString(path, allowAboveRoot) {
+	let res = "";
+	let lastSegmentLength = 0;
+	let lastSlash = -1;
+	let dots = 0;
+	let char = null;
+	for (let index = 0; index <= path.length; ++index) {
+		if (index < path.length) char = path[index];
+		else if (char === "/") break;
+		else char = "/";
+		if (char === "/") {
+			if (lastSlash === index - 1 || dots === 1) {} else if (dots === 2) {
+				if (res.length < 2 || lastSegmentLength !== 2 || res[res.length - 1] !== "." || res[res.length - 2] !== ".") {
+					if (res.length > 2) {
+						const lastSlashIndex = res.lastIndexOf("/");
+						if (lastSlashIndex === -1) {
+							res = "";
+							lastSegmentLength = 0;
+						} else {
+							res = res.slice(0, lastSlashIndex);
+							lastSegmentLength = res.length - 1 - res.lastIndexOf("/");
+						}
+						lastSlash = index;
+						dots = 0;
+						continue;
+					} else if (res.length > 0) {
+						res = "";
+						lastSegmentLength = 0;
+						lastSlash = index;
+						dots = 0;
+						continue;
+					}
+				}
+				if (allowAboveRoot) {
+					res += res.length > 0 ? "/.." : "..";
+					lastSegmentLength = 2;
+				}
+			} else {
+				if (res.length > 0) res += `/${path.slice(lastSlash + 1, index)}`;
+				else res = path.slice(lastSlash + 1, index);
+				lastSegmentLength = index - lastSlash - 1;
+			}
+			lastSlash = index;
+			dots = 0;
+		} else if (char === "." && dots !== -1) ++dots;
+		else dots = -1;
+	}
+	return res;
+}
+/**
+* Converts a given path to a relative path based on the current working directory.
+*
+* @param path - The path to convert to a relative path.
+* @param cwd - The current working directory to use as the base path if the path is not absolute.
+* @returns The relative path.
+*/
+function toRelativePath(path, cwd$1 = require_cwd.cwd()) {
+	if (!path || path.length === 0) return ".";
+	if (require_is_type.isAbsolutePath(path)) path = require_slash.slash(normalizeString(path, true));
+	else path = require_slash.slash(normalizeString(require_join_paths.joinPaths(cwd$1, path), true));
+	if (path.startsWith("./")) return path.slice(2);
+	return path;
+}
+/**
+* Removes a trailing slash from a path if it has one.
+*
+* @param path - The path to modify.
+* @returns The modified path without a trailing slash.
+*/
+function withoutTrailingSlash(path) {
+	const result = correctPath(path);
+	return result.endsWith("/") ? result.slice(0, -1) : result;
+}
+
+//#endregion
+exports.toRelativePath = toRelativePath;
+exports.withoutTrailingSlash = withoutTrailingSlash;

package/dist/path/src/correct-path.mjs

@@ -0,0 +1,120 @@
+import { cwd } from "./cwd.mjs";
+import { DRIVE_LETTER_REGEX, DRIVE_LETTER_START_REGEX, UNC_REGEX } from "./regex.mjs";
+import { isAbsolutePath } from "./is-type.mjs";
+import { slash } from "./slash.mjs";
+import { joinPaths } from "./join-paths.mjs";
+
+//#region ../path/src/correct-path.ts
+function normalizeWindowsPath(input = "") {
+	if (!input) return input;
+	return slash(input).replace(DRIVE_LETTER_START_REGEX, (r) => r.toUpperCase());
+}
+/**
+* Corrects/normalized a file path.
+*
+* @param path - The path to correct.
+* @returns The corrected path.
+*/
+function correctPath(path) {
+	if (!path || path.length === 0) return ".";
+	path = normalizeWindowsPath(path);
+	const isUNCPath = path.match(UNC_REGEX);
+	const isPathAbsolute = isAbsolutePath(path);
+	const trailingSeparator = path.endsWith("/");
+	path = normalizeString(path, !isPathAbsolute);
+	if (path.length === 0) {
+		if (isPathAbsolute) return "/";
+		return trailingSeparator ? "./" : ".";
+	}
+	if (trailingSeparator) path += "/";
+	if (DRIVE_LETTER_REGEX.test(path)) path += "/";
+	if (isUNCPath) {
+		if (!isPathAbsolute) return `//./${path}`;
+		return `//${path}`;
+	}
+	return !path.startsWith("/") && isPathAbsolute && !DRIVE_LETTER_REGEX.test(path) ? `/${path}` : path;
+}
+/**
+* Resolves a string path, resolving '.' and '.' segments and allowing paths above the root.
+*
+* @param path - The path to normalize.
+* @param allowAboveRoot - Whether to allow the resulting path to be above the root directory.
+* @returns the normalize path string.
+*/
+function normalizeString(path, allowAboveRoot) {
+	let res = "";
+	let lastSegmentLength = 0;
+	let lastSlash = -1;
+	let dots = 0;
+	let char = null;
+	for (let index = 0; index <= path.length; ++index) {
+		if (index < path.length) char = path[index];
+		else if (char === "/") break;
+		else char = "/";
+		if (char === "/") {
+			if (lastSlash === index - 1 || dots === 1) {} else if (dots === 2) {
+				if (res.length < 2 || lastSegmentLength !== 2 || res[res.length - 1] !== "." || res[res.length - 2] !== ".") {
+					if (res.length > 2) {
+						const lastSlashIndex = res.lastIndexOf("/");
+						if (lastSlashIndex === -1) {
+							res = "";
+							lastSegmentLength = 0;
+						} else {
+							res = res.slice(0, lastSlashIndex);
+							lastSegmentLength = res.length - 1 - res.lastIndexOf("/");
+						}
+						lastSlash = index;
+						dots = 0;
+						continue;
+					} else if (res.length > 0) {
+						res = "";
+						lastSegmentLength = 0;
+						lastSlash = index;
+						dots = 0;
+						continue;
+					}
+				}
+				if (allowAboveRoot) {
+					res += res.length > 0 ? "/.." : "..";
+					lastSegmentLength = 2;
+				}
+			} else {
+				if (res.length > 0) res += `/${path.slice(lastSlash + 1, index)}`;
+				else res = path.slice(lastSlash + 1, index);
+				lastSegmentLength = index - lastSlash - 1;
+			}
+			lastSlash = index;
+			dots = 0;
+		} else if (char === "." && dots !== -1) ++dots;
+		else dots = -1;
+	}
+	return res;
+}
+/**
+* Converts a given path to a relative path based on the current working directory.
+*
+* @param path - The path to convert to a relative path.
+* @param cwd - The current working directory to use as the base path if the path is not absolute.
+* @returns The relative path.
+*/
+function toRelativePath(path, cwd$1 = cwd()) {
+	if (!path || path.length === 0) return ".";
+	if (isAbsolutePath(path)) path = slash(normalizeString(path, true));
+	else path = slash(normalizeString(joinPaths(cwd$1, path), true));
+	if (path.startsWith("./")) return path.slice(2);
+	return path;
+}
+/**
+* Removes a trailing slash from a path if it has one.
+*
+* @param path - The path to modify.
+* @returns The modified path without a trailing slash.
+*/
+function withoutTrailingSlash(path) {
+	const result = correctPath(path);
+	return result.endsWith("/") ? result.slice(0, -1) : result;
+}
+
+//#endregion
+export { toRelativePath, withoutTrailingSlash };
+//# sourceMappingURL=correct-path.mjs.map

package/dist/path/src/correct-path.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"correct-path.mjs","names":["char: string | null","currentDir","cwd"],"sources":["../../../../path/src/correct-path.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 { appendPath } from \"./append\";\nimport { cwd as currentDir } from \"./cwd\";\nimport { isAbsolutePath } from \"./is-type\";\nimport { joinPaths } from \"./join-paths\";\nimport {\n  DRIVE_LETTER_REGEX,\n  DRIVE_LETTER_START_REGEX,\n  UNC_REGEX\n} from \"./regex\";\nimport { slash } from \"./slash\";\n\n// Util to normalize windows paths to posix\nexport function normalizeWindowsPath(input = \"\") {\n  if (!input) {\n    return input;\n  }\n\n  return slash(input).replace(DRIVE_LETTER_START_REGEX, r => r.toUpperCase());\n}\n\n/**\n * Corrects/normalized a file path.\n *\n * @param path - The path to correct.\n * @returns The corrected path.\n */\nexport function correctPath(path?: string) {\n  if (!path || path.length === 0) {\n    return \".\";\n  }\n\n  // Normalize windows argument\n  path = normalizeWindowsPath(path);\n\n  const isUNCPath = path.match(UNC_REGEX);\n  const isPathAbsolute = isAbsolutePath(path);\n  const trailingSeparator = path.endsWith(\"/\");\n\n  // Normalize the path\n  path = normalizeString(path, !isPathAbsolute);\n\n  if (path.length === 0) {\n    if (isPathAbsolute) {\n      return \"/\";\n    }\n    return trailingSeparator ? \"./\" : \".\";\n  }\n\n  if (trailingSeparator) {\n    path += \"/\";\n  }\n  if (DRIVE_LETTER_REGEX.test(path)) {\n    path += \"/\";\n  }\n\n  if (isUNCPath) {\n    if (!isPathAbsolute) {\n      return `//./${path}`;\n    }\n    return `//${path}`;\n  }\n\n  return !path.startsWith(\"/\") &&\n    isPathAbsolute &&\n    !DRIVE_LETTER_REGEX.test(path)\n    ? `/${path}`\n    : path;\n}\n\n/**\n * Remove any star tokens (*) from the end of the file path\n *\n * @example\n * stripStars(\"src/**\") // returns \"src\"\n * stripStars(\"src/*\") // returns \"src\"\n * stripStars(\"src/**\\/*\") // returns \"src\"\n * stripStars(\"src/**\\/*.txt\") // returns \"src\"\n * stripStars(\"src/**\\/file.txt\") // returns \"src\"\n * stripStars(\"src/file.txt\") // returns \"src/file.txt\"\n * stripStars(\"\") // returns \".\"\n *\n * @param path - The path to correct.\n * @returns The corrected path.\n */\nexport function stripStars(path?: string) {\n  if (!path || path.length === 0) {\n    return \".\";\n  }\n\n  path = correctPath(path);\n\n  let found = false;\n\n  return `${path.startsWith(\"/\") ? \"/\" : \"\"}${path\n    .split(\"/\")\n    .reduce((ret, segment) => {\n      if (!segment?.trim()) {\n        return ret;\n      }\n\n      if (found || segment.includes(\"*\")) {\n        found = true;\n        return ret;\n      }\n\n      return ret + (ret ? `/${segment}` : segment);\n    }, \"\")}`;\n}\n\n/**\n * Resolves a string path, resolving '.' and '.' segments and allowing paths above the root.\n *\n * @param path - The path to normalize.\n * @param allowAboveRoot - Whether to allow the resulting path to be above the root directory.\n * @returns the normalize path string.\n */\nexport function normalizeString(path: string, allowAboveRoot: boolean) {\n  let res = \"\";\n  let lastSegmentLength = 0;\n  let lastSlash = -1;\n  let dots = 0;\n  let char: string | null = null;\n  for (let index = 0; index <= path.length; ++index) {\n    if (index < path.length) {\n      // casted because we know it exists thanks to the length check\n      char = path[index] as string;\n    } else if (char === \"/\") {\n      break;\n    } else {\n      char = \"/\";\n    }\n    if (char === \"/\") {\n      if (lastSlash === index - 1 || dots === 1) {\n        // NOOP\n      } else if (dots === 2) {\n        if (\n          res.length < 2 ||\n          lastSegmentLength !== 2 ||\n          res[res.length - 1] !== \".\" ||\n          res[res.length - 2] !== \".\"\n        ) {\n          if (res.length > 2) {\n            const lastSlashIndex = res.lastIndexOf(\"/\");\n            if (lastSlashIndex === -1) {\n              res = \"\";\n              lastSegmentLength = 0;\n            } else {\n              res = res.slice(0, lastSlashIndex);\n              lastSegmentLength = res.length - 1 - res.lastIndexOf(\"/\");\n            }\n            lastSlash = index;\n            dots = 0;\n            continue;\n          } else if (res.length > 0) {\n            res = \"\";\n            lastSegmentLength = 0;\n            lastSlash = index;\n            dots = 0;\n            continue;\n          }\n        }\n        if (allowAboveRoot) {\n          res += res.length > 0 ? \"/..\" : \"..\";\n          lastSegmentLength = 2;\n        }\n      } else {\n        if (res.length > 0) {\n          res += `/${path.slice(lastSlash + 1, index)}`;\n        } else {\n          res = path.slice(lastSlash + 1, index);\n        }\n        lastSegmentLength = index - lastSlash - 1;\n      }\n      lastSlash = index;\n      dots = 0;\n    } else if (char === \".\" && dots !== -1) {\n      ++dots;\n    } else {\n      dots = -1;\n    }\n  }\n  return res;\n}\n\n/**\n * Converts a given path to an absolute path based on the current working directory.\n *\n * @param path - The path to convert to an absolute path.\n * @param cwd - The current working directory to use as the base path if the path is not absolute.\n * @returns The absolute path.\n */\nexport function toAbsolutePath(path: string, cwd = currentDir()): string {\n  if (isAbsolutePath(path)) {\n    return path;\n  }\n\n  return slash(normalizeString(appendPath(path, cwd), true));\n}\n\n/**\n * Converts a given path to a relative path based on the current working directory.\n *\n * @param path - The path to convert to a relative path.\n * @param cwd - The current working directory to use as the base path if the path is not absolute.\n * @returns The relative path.\n */\nexport function toRelativePath(path: string, cwd = currentDir()): string {\n  if (!path || path.length === 0) {\n    return \".\";\n  }\n\n  if (isAbsolutePath(path)) {\n    path = slash(normalizeString(path, true));\n  } else {\n    path = slash(normalizeString(joinPaths(cwd, path), true));\n  }\n\n  if (path.startsWith(\"./\")) {\n    return path.slice(2);\n  }\n\n  return path;\n}\n\n/**\n * Adds a trailing slash to a path if it doesn't already have one.\n *\n * @param path - The path to modify.\n * @returns The modified path with a trailing slash.\n */\nexport function withTrailingSlash(path: string): string {\n  const result = correctPath(path);\n\n  return result.endsWith(\"/\") ? result : `${result}/`;\n}\n\n/**\n * Removes a trailing slash from a path if it has one.\n *\n * @param path - The path to modify.\n * @returns The modified path without a trailing slash.\n */\nexport function withoutTrailingSlash(path: string): string {\n  const result = correctPath(path);\n\n  return result.endsWith(\"/\") ? result.slice(0, -1) : result;\n}\n"],"mappings":";;;;;;;AA8BA,SAAgB,qBAAqB,QAAQ,IAAI;AAC/C,KAAI,CAAC,MACH,QAAO;AAGT,QAAO,MAAM,MAAM,CAAC,QAAQ,2BAA0B,MAAK,EAAE,aAAa,CAAC;;;;;;;;AAS7E,SAAgB,YAAY,MAAe;AACzC,KAAI,CAAC,QAAQ,KAAK,WAAW,EAC3B,QAAO;AAIT,QAAO,qBAAqB,KAAK;CAEjC,MAAM,YAAY,KAAK,MAAM,UAAU;CACvC,MAAM,iBAAiB,eAAe,KAAK;CAC3C,MAAM,oBAAoB,KAAK,SAAS,IAAI;AAG5C,QAAO,gBAAgB,MAAM,CAAC,eAAe;AAE7C,KAAI,KAAK,WAAW,GAAG;AACrB,MAAI,eACF,QAAO;AAET,SAAO,oBAAoB,OAAO;;AAGpC,KAAI,kBACF,SAAQ;AAEV,KAAI,mBAAmB,KAAK,KAAK,CAC/B,SAAQ;AAGV,KAAI,WAAW;AACb,MAAI,CAAC,eACH,QAAO,OAAO;AAEhB,SAAO,KAAK;;AAGd,QAAO,CAAC,KAAK,WAAW,IAAI,IAC1B,kBACA,CAAC,mBAAmB,KAAK,KAAK,GAC5B,IAAI,SACJ;;;;;;;;;AAkDN,SAAgB,gBAAgB,MAAc,gBAAyB;CACrE,IAAI,MAAM;CACV,IAAI,oBAAoB;CACxB,IAAI,YAAY;CAChB,IAAI,OAAO;CACX,IAAIA,OAAsB;AAC1B,MAAK,IAAI,QAAQ,GAAG,SAAS,KAAK,QAAQ,EAAE,OAAO;AACjD,MAAI,QAAQ,KAAK,OAEf,QAAO,KAAK;WACH,SAAS,IAClB;MAEA,QAAO;AAET,MAAI,SAAS,KAAK;AAChB,OAAI,cAAc,QAAQ,KAAK,SAAS,GAAG,YAEhC,SAAS,GAAG;AACrB,QACE,IAAI,SAAS,KACb,sBAAsB,KACtB,IAAI,IAAI,SAAS,OAAO,OACxB,IAAI,IAAI,SAAS,OAAO,KAExB;SAAI,IAAI,SAAS,GAAG;MAClB,MAAM,iBAAiB,IAAI,YAAY,IAAI;AAC3C,UAAI,mBAAmB,IAAI;AACzB,aAAM;AACN,2BAAoB;aACf;AACL,aAAM,IAAI,MAAM,GAAG,eAAe;AAClC,2BAAoB,IAAI,SAAS,IAAI,IAAI,YAAY,IAAI;;AAE3D,kBAAY;AACZ,aAAO;AACP;gBACS,IAAI,SAAS,GAAG;AACzB,YAAM;AACN,0BAAoB;AACpB,kBAAY;AACZ,aAAO;AACP;;;AAGJ,QAAI,gBAAgB;AAClB,YAAO,IAAI,SAAS,IAAI,QAAQ;AAChC,yBAAoB;;UAEjB;AACL,QAAI,IAAI,SAAS,EACf,QAAO,IAAI,KAAK,MAAM,YAAY,GAAG,MAAM;QAE3C,OAAM,KAAK,MAAM,YAAY,GAAG,MAAM;AAExC,wBAAoB,QAAQ,YAAY;;AAE1C,eAAY;AACZ,UAAO;aACE,SAAS,OAAO,SAAS,GAClC,GAAE;MAEF,QAAO;;AAGX,QAAO;;;;;;;;;AAyBT,SAAgB,eAAe,MAAc,QAAMC,KAAY,EAAU;AACvE,KAAI,CAAC,QAAQ,KAAK,WAAW,EAC3B,QAAO;AAGT,KAAI,eAAe,KAAK,CACtB,QAAO,MAAM,gBAAgB,MAAM,KAAK,CAAC;KAEzC,QAAO,MAAM,gBAAgB,UAAUC,OAAK,KAAK,EAAE,KAAK,CAAC;AAG3D,KAAI,KAAK,WAAW,KAAK,CACvB,QAAO,KAAK,MAAM,EAAE;AAGtB,QAAO;;;;;;;;AAqBT,SAAgB,qBAAqB,MAAsB;CACzD,MAAM,SAAS,YAAY,KAAK;AAEhC,QAAO,OAAO,SAAS,IAAI,GAAG,OAAO,MAAM,GAAG,GAAG,GAAG"}

package/dist/path/src/cwd.cjs

@@ -0,0 +1,17 @@
+
+//#region ../path/src/cwd.ts
+/**
+* Get the current working directory.
+*
+* @remarks
+* This function attempts to retrieve the current working directory using `process.cwd()`.
+*
+* @returns The current working directory or '/' if it cannot be determined
+*/
+function cwd() {
+	if (typeof process !== "undefined" && typeof process.cwd === "function") return process.cwd().replace(/\\/g, "/");
+	return "/";
+}
+
+//#endregion
+exports.cwd = cwd;

package/dist/path/src/cwd.mjs

@@ -0,0 +1,17 @@
+//#region ../path/src/cwd.ts
+/**
+* Get the current working directory.
+*
+* @remarks
+* This function attempts to retrieve the current working directory using `process.cwd()`.
+*
+* @returns The current working directory or '/' if it cannot be determined
+*/
+function cwd() {
+	if (typeof process !== "undefined" && typeof process.cwd === "function") return process.cwd().replace(/\\/g, "/");
+	return "/";
+}
+
+//#endregion
+export { cwd };
+//# sourceMappingURL=cwd.mjs.map

package/dist/path/src/cwd.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cwd.mjs","names":[],"sources":["../../../../path/src/cwd.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 * Get the current working directory.\n *\n * @remarks\n * This function attempts to retrieve the current working directory using `process.cwd()`.\n *\n * @returns The current working directory or '/' if it cannot be determined\n */\nexport function cwd() {\n  if (typeof process !== \"undefined\" && typeof process.cwd === \"function\") {\n    return process.cwd().replace(/\\\\/g, \"/\");\n  }\n  return \"/\";\n}\n"],"mappings":";;;;;;;;;AA0BA,SAAgB,MAAM;AACpB,KAAI,OAAO,YAAY,eAAe,OAAO,QAAQ,QAAQ,WAC3D,QAAO,QAAQ,KAAK,CAAC,QAAQ,OAAO,IAAI;AAE1C,QAAO"}

package/dist/path/src/is-type.cjs

@@ -0,0 +1,29 @@
+const require_regex = require('./regex.cjs');
+const require_slash = require('./slash.cjs');
+
+//#region ../path/src/is-type.ts
+/**
+* Check if the path is an absolute path.
+*
+* @param path - The path to check
+* @returns An indicator specifying if the path is an absolute path
+*/
+function isAbsolutePath(path) {
+	return require_regex.ABSOLUTE_PATH_REGEX.test(require_slash.slash(path));
+}
+/**
+* Check if the path is an absolute path.
+*
+* @remarks
+* This is an alias for {@link isAbsolutePath}.
+*
+* @param path - The path to check
+* @returns An indicator specifying if the path is an absolute path
+*/
+function isAbsolute(path) {
+	return isAbsolutePath(path);
+}
+
+//#endregion
+exports.isAbsolute = isAbsolute;
+exports.isAbsolutePath = isAbsolutePath;