@stryke/fs 0.33.32 → 0.33.33

package/dist/path/src/append.mjs

@@ -1,2 +1,57 @@
-import{cwd as e}from"./cwd.mjs";import{slash as t}from"./slash.mjs";import{isParentPath as n}from"./is-parent-path.mjs";import{joinPaths as r}from"./join-paths.mjs";function i(i,a=e(),o={}){return t(o.skipIfAlreadyParent!==!1&&n(i,a)?i:r(a,i))}function a(e,t){return`${e}.${t.replace(/^\./,``)}`}export{a as appendExtension,i as appendPath};
+import { cwd } from "./cwd.mjs";
+import { slash } from "./slash.mjs";
+import { isParentPath } from "./is-parent-path.mjs";
+import { joinPaths } from "./join-paths.mjs";
+
+//#region ../path/src/append.ts
+/**
+* If not already a parent path, append the base path from the beginning of the given child path.
+*
+* @example
+* ```ts
+* appendPath("src/index.ts", "/home/user/project");
+* // returns "/home/user/project/src/index.ts"
+*
+* appendPath("/user/dev/app.ts", "/user/dev");
+* // returns "/user/dev/app.ts"
+*
+* appendPath("docs/readme.md");
+* // returns "<current_working_directory>/docs/readme.md"
+*
+* appendPath("src/index.ts", "/home/user/project", { skipIfAlreadyParent: false });
+* // returns "/home/user/project/src/index.ts"
+*
+* appendPath("/home/user/project/src/index.ts", "/home/user/project", { skipIfAlreadyParent: false });
+* // returns "/home/user/project/src/index.ts"
+* ```
+*
+* @param childPath - The child path to append to the {@link parentPath}
+* @param parentPath - The parent path to add the {@link childPath} to
+* @param options - Options for appending the path
+* @returns The {@link parentPath} with the {@link childPath} appended
+*/
+function appendPath(childPath, parentPath = cwd(), options = {}) {
+	return slash(options.skipIfAlreadyParent !== false && isParentPath(childPath, parentPath) ? childPath : joinPaths(parentPath, childPath));
+}
+/**
+* Append the extension to the given path.
+*
+* @example
+* ```ts
+* appendExtension("/home/user/project/src/index", ".ts");
+* // returns "/home/user/project/src/index.ts"
+* appendExtension("/home/user/project/src/index.ts", ".js");
+* // returns "/home/user/project/src/index.ts.js"
+* ```
+*
+* @param path - The path to append the extension to.
+* @param extension - The extension to append.
+* @returns The path with the appended extension.
+*/
+function appendExtension(path, extension) {
+	return `${path}.${extension.replace(/^\./, "")}`;
+}
+
+//#endregion
+export { appendExtension, appendPath };
 //# sourceMappingURL=append.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"append.mjs","names":[],"sources":["../../../../path/src/append.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 { cwd } from \"./cwd\";\nimport { isParentPath } from \"./is-parent-path\";\nimport { joinPaths } from \"./join-paths\";\nimport { slash } from \"./slash\";\n\nexport interface AppendPathOptions {\n  /**\n   * If `true`, the function will skip appending if the `childPath` is already a child of the `parentPath`.\n   *\n   * @defaultValue true\n   */\n  skipIfAlreadyParent?: boolean;\n}\n\n/**\n * If not already a parent path, append the base path from the beginning of the given child path.\n *\n * @example\n * ```ts\n * appendPath(\"src/index.ts\", \"/home/user/project\");\n * // returns \"/home/user/project/src/index.ts\"\n *\n * appendPath(\"/user/dev/app.ts\", \"/user/dev\");\n * // returns \"/user/dev/app.ts\"\n *\n * appendPath(\"docs/readme.md\");\n * // returns \"<current_working_directory>/docs/readme.md\"\n *\n * appendPath(\"src/index.ts\", \"/home/user/project\", { skipIfAlreadyParent: false });\n * // returns \"/home/user/project/src/index.ts\"\n *\n * appendPath(\"/home/user/project/src/index.ts\", \"/home/user/project\", { skipIfAlreadyParent: false });\n * // returns \"/home/user/project/src/index.ts\"\n * ```\n *\n * @param childPath - The child path to append to the {@link parentPath}\n * @param parentPath - The parent path to add the {@link childPath} to\n * @param options - Options for appending the path\n * @returns The {@link parentPath} with the {@link childPath} appended\n */\nexport function appendPath(\n  childPath: string,\n  parentPath: string = cwd(),\n  options: AppendPathOptions = {}\n): string {\n  return slash(\n    options.skipIfAlreadyParent !== false && isParentPath(childPath, parentPath)\n      ? childPath\n      : joinPaths(parentPath, childPath)\n  );\n}\n\nexport const append = appendPath;\n\n/**\n * Append the extension to the given path.\n *\n * @example\n * ```ts\n * appendExtension(\"/home/user/project/src/index\", \".ts\");\n * // returns \"/home/user/project/src/index.ts\"\n * appendExtension(\"/home/user/project/src/index.ts\", \".js\");\n * // returns \"/home/user/project/src/index.ts.js\"\n * ```\n *\n * @param path - The path to append the extension to.\n * @param extension - The extension to append.\n * @returns The path with the appended extension.\n */\nexport function appendExtension(path: string, extension: string): string {\n  return `${path}.${extension.replace(/^\\./, \"\")}`;\n}\n"],"mappings":"qKA0DA,SAAgB,EACd,EACA,EAAqB,GAAK,CAC1B,EAA6B,EAAE,CACvB,CACR,OAAO,EACL,EAAQ,sBAAwB,IAAS,EAAa,EAAW,EAAW,CACxE,EACA,EAAU,EAAY,EAAU,CACrC,CAoBH,SAAgB,EAAgB,EAAc,EAA2B,CACvE,MAAO,GAAG,EAAK,GAAG,EAAU,QAAQ,MAAO,GAAG"}
+{"version":3,"file":"append.mjs","names":[],"sources":["../../../../path/src/append.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 { cwd } from \"./cwd\";\nimport { isParentPath } from \"./is-parent-path\";\nimport { joinPaths } from \"./join-paths\";\nimport { slash } from \"./slash\";\n\nexport interface AppendPathOptions {\n  /**\n   * If `true`, the function will skip appending if the `childPath` is already a child of the `parentPath`.\n   *\n   * @defaultValue true\n   */\n  skipIfAlreadyParent?: boolean;\n}\n\n/**\n * If not already a parent path, append the base path from the beginning of the given child path.\n *\n * @example\n * ```ts\n * appendPath(\"src/index.ts\", \"/home/user/project\");\n * // returns \"/home/user/project/src/index.ts\"\n *\n * appendPath(\"/user/dev/app.ts\", \"/user/dev\");\n * // returns \"/user/dev/app.ts\"\n *\n * appendPath(\"docs/readme.md\");\n * // returns \"<current_working_directory>/docs/readme.md\"\n *\n * appendPath(\"src/index.ts\", \"/home/user/project\", { skipIfAlreadyParent: false });\n * // returns \"/home/user/project/src/index.ts\"\n *\n * appendPath(\"/home/user/project/src/index.ts\", \"/home/user/project\", { skipIfAlreadyParent: false });\n * // returns \"/home/user/project/src/index.ts\"\n * ```\n *\n * @param childPath - The child path to append to the {@link parentPath}\n * @param parentPath - The parent path to add the {@link childPath} to\n * @param options - Options for appending the path\n * @returns The {@link parentPath} with the {@link childPath} appended\n */\nexport function appendPath(\n  childPath: string,\n  parentPath: string = cwd(),\n  options: AppendPathOptions = {}\n): string {\n  return slash(\n    options.skipIfAlreadyParent !== false && isParentPath(childPath, parentPath)\n      ? childPath\n      : joinPaths(parentPath, childPath)\n  );\n}\n\nexport const append = appendPath;\n\n/**\n * Append the extension to the given path.\n *\n * @example\n * ```ts\n * appendExtension(\"/home/user/project/src/index\", \".ts\");\n * // returns \"/home/user/project/src/index.ts\"\n * appendExtension(\"/home/user/project/src/index.ts\", \".js\");\n * // returns \"/home/user/project/src/index.ts.js\"\n * ```\n *\n * @param path - The path to append the extension to.\n * @param extension - The extension to append.\n * @returns The path with the appended extension.\n */\nexport function appendExtension(path: string, extension: string): string {\n  return `${path}.${extension.replace(/^\\./, \"\")}`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0DA,SAAgB,WACd,WACA,aAAqB,KAAK,EAC1B,UAA6B,EAAE,EACvB;AACR,QAAO,MACL,QAAQ,wBAAwB,SAAS,aAAa,WAAW,WAAW,GACxE,YACA,UAAU,YAAY,UAAU,CACrC;;;;;;;;;;;;;;;;;AAoBH,SAAgB,gBAAgB,MAAc,WAA2B;AACvE,QAAO,GAAG,KAAK,GAAG,UAAU,QAAQ,OAAO,GAAG"}

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

@@ -1 +1,138 @@
-const e=require(`./cwd.cjs`),t=require(`./regex.cjs`),n=require(`./is-type.cjs`),r=require(`./slash.cjs`),i=require(`./append.cjs`);function a(e=``){return e&&r.slash(e).replace(t.DRIVE_LETTER_START_REGEX,e=>e.toUpperCase())}function o(e){if(!e||e.length===0)return`.`;e=a(e);let r=e.match(t.UNC_REGEX),i=n.isAbsolutePath(e),o=e.endsWith(`/`);return e=c(e,!i),e.length===0?i?`/`:o?`./`:`.`:(o&&(e+=`/`),t.DRIVE_LETTER_REGEX.test(e)&&(e+=`/`),r?i?`//${e}`:`//./${e}`:!e.startsWith(`/`)&&i&&!t.DRIVE_LETTER_REGEX.test(e)?`/${e}`:e)}function s(e){if(!e||e.length===0)return`.`;e=o(e);let t=!1;return`${e.startsWith(`/`)?`/`:``}${e.split(`/`).reduce((e,n)=>n?.trim()?t||n.includes(`*`)?(t=!0,e):e+(e?`/${n}`:n):e,``)}`}function c(e,t){let n=``,r=0,i=-1,a=0,o=null;for(let s=0;s<=e.length;++s){if(s<e.length)o=e[s];else if(o===`/`)break;else o=`/`;if(o===`/`){if(!(i===s-1||a===1))if(a===2){if(n.length<2||r!==2||n[n.length-1]!==`.`||n[n.length-2]!==`.`){if(n.length>2){let e=n.lastIndexOf(`/`);e===-1?(n=``,r=0):(n=n.slice(0,e),r=n.length-1-n.lastIndexOf(`/`)),i=s,a=0;continue}else if(n.length>0){n=``,r=0,i=s,a=0;continue}}t&&(n+=n.length>0?`/..`:`..`,r=2)}else n.length>0?n+=`/${e.slice(i+1,s)}`:n=e.slice(i+1,s),r=s-i-1;i=s,a=0}else o===`.`&&a!==-1?++a:a=-1}return n}function l(t,a=e.cwd()){return n.isAbsolutePath(t)?t:r.slash(c(i.appendPath(t,a),!0))}exports.correctPath=o,exports.normalizeString=c,exports.normalizeWindowsPath=a,exports.stripStars=s,exports.toAbsolutePath=l;
+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_append = require('./append.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;
+}
+/**
+* Remove any star tokens (*) from the end of the file path
+*
+* @example
+* stripStars("src/**") // returns "src"
+* stripStars("src/*") // returns "src"
+* stripStars("src/**\/*") // returns "src"
+* stripStars("src/**\/*.txt") // returns "src"
+* stripStars("src/**\/file.txt") // returns "src"
+* stripStars("src/file.txt") // returns "src/file.txt"
+* stripStars("") // returns "."
+*
+* @param path - The path to correct.
+* @returns The corrected path.
+*/
+function stripStars(path) {
+	if (!path || path.length === 0) return ".";
+	path = correctPath(path);
+	let found = false;
+	return `${path.startsWith("/") ? "/" : ""}${path.split("/").reduce((ret, segment) => {
+		if (!segment?.trim()) return ret;
+		if (found || segment.includes("*")) {
+			found = true;
+			return ret;
+		}
+		return ret + (ret ? `/${segment}` : segment);
+	}, "")}`;
+}
+/**
+* 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 an absolute path based on the current working directory.
+*
+* @param path - The path to convert to an absolute path.
+* @param cwd - The current working directory to use as the base path if the path is not absolute.
+* @returns The absolute path.
+*/
+function toAbsolutePath(path, cwd$1 = require_cwd.cwd()) {
+	if (require_is_type.isAbsolutePath(path)) return path;
+	return require_slash.slash(normalizeString(require_append.appendPath(path, cwd$1), true));
+}
+
+//#endregion
+exports.correctPath = correctPath;
+exports.normalizeString = normalizeString;
+exports.normalizeWindowsPath = normalizeWindowsPath;
+exports.stripStars = stripStars;
+exports.toAbsolutePath = toAbsolutePath;

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

@@ -1,2 +1,135 @@
-import{cwd as e}from"./cwd.mjs";import{DRIVE_LETTER_REGEX as t,DRIVE_LETTER_START_REGEX as n,UNC_REGEX as r}from"./regex.mjs";import{isAbsolutePath as i}from"./is-type.mjs";import{slash as a}from"./slash.mjs";import{appendPath as o}from"./append.mjs";function s(e=``){return e&&a(e).replace(n,e=>e.toUpperCase())}function c(e){if(!e||e.length===0)return`.`;e=s(e);let n=e.match(r),a=i(e),o=e.endsWith(`/`);return e=u(e,!a),e.length===0?a?`/`:o?`./`:`.`:(o&&(e+=`/`),t.test(e)&&(e+=`/`),n?a?`//${e}`:`//./${e}`:!e.startsWith(`/`)&&a&&!t.test(e)?`/${e}`:e)}function l(e){if(!e||e.length===0)return`.`;e=c(e);let t=!1;return`${e.startsWith(`/`)?`/`:``}${e.split(`/`).reduce((e,n)=>n?.trim()?t||n.includes(`*`)?(t=!0,e):e+(e?`/${n}`:n):e,``)}`}function u(e,t){let n=``,r=0,i=-1,a=0,o=null;for(let s=0;s<=e.length;++s){if(s<e.length)o=e[s];else if(o===`/`)break;else o=`/`;if(o===`/`){if(!(i===s-1||a===1))if(a===2){if(n.length<2||r!==2||n[n.length-1]!==`.`||n[n.length-2]!==`.`){if(n.length>2){let e=n.lastIndexOf(`/`);e===-1?(n=``,r=0):(n=n.slice(0,e),r=n.length-1-n.lastIndexOf(`/`)),i=s,a=0;continue}else if(n.length>0){n=``,r=0,i=s,a=0;continue}}t&&(n+=n.length>0?`/..`:`..`,r=2)}else n.length>0?n+=`/${e.slice(i+1,s)}`:n=e.slice(i+1,s),r=s-i-1;i=s,a=0}else o===`.`&&a!==-1?++a:a=-1}return n}function d(t,n=e()){return i(t)?t:a(u(o(t,n),!0))}export{c as correctPath,u as normalizeString,s as normalizeWindowsPath,l as stripStars,d as toAbsolutePath};
+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 { appendPath } from "./append.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;
+}
+/**
+* Remove any star tokens (*) from the end of the file path
+*
+* @example
+* stripStars("src/**") // returns "src"
+* stripStars("src/*") // returns "src"
+* stripStars("src/**\/*") // returns "src"
+* stripStars("src/**\/*.txt") // returns "src"
+* stripStars("src/**\/file.txt") // returns "src"
+* stripStars("src/file.txt") // returns "src/file.txt"
+* stripStars("") // returns "."
+*
+* @param path - The path to correct.
+* @returns The corrected path.
+*/
+function stripStars(path) {
+	if (!path || path.length === 0) return ".";
+	path = correctPath(path);
+	let found = false;
+	return `${path.startsWith("/") ? "/" : ""}${path.split("/").reduce((ret, segment) => {
+		if (!segment?.trim()) return ret;
+		if (found || segment.includes("*")) {
+			found = true;
+			return ret;
+		}
+		return ret + (ret ? `/${segment}` : segment);
+	}, "")}`;
+}
+/**
+* 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 an absolute path based on the current working directory.
+*
+* @param path - The path to convert to an absolute path.
+* @param cwd - The current working directory to use as the base path if the path is not absolute.
+* @returns The absolute path.
+*/
+function toAbsolutePath(path, cwd$1 = cwd()) {
+	if (isAbsolutePath(path)) return path;
+	return slash(normalizeString(appendPath(path, cwd$1), true));
+}
+
+//#endregion
+export { correctPath, normalizeString, normalizeWindowsPath, stripStars, toAbsolutePath };
 //# sourceMappingURL=correct-path.mjs.map

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

@@ -1 +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":"2PA8BA,SAAgB,EAAqB,EAAQ,GAAI,CAK/C,OAJK,GAIE,EAAM,EAAM,CAAC,QAAQ,EAA0B,GAAK,EAAE,aAAa,CAAC,CAS7E,SAAgB,EAAY,EAAe,CACzC,GAAI,CAAC,GAAQ,EAAK,SAAW,EAC3B,MAAO,IAIT,EAAO,EAAqB,EAAK,CAEjC,IAAM,EAAY,EAAK,MAAM,EAAU,CACjC,EAAiB,EAAe,EAAK,CACrC,EAAoB,EAAK,SAAS,IAAI,CA0B5C,MAvBA,GAAO,EAAgB,EAAM,CAAC,EAAe,CAEzC,EAAK,SAAW,EACd,EACK,IAEF,EAAoB,KAAO,KAGhC,IACF,GAAQ,KAEN,EAAmB,KAAK,EAAK,GAC/B,GAAQ,KAGN,EACG,EAGE,KAAK,IAFH,OAAO,IAKX,CAAC,EAAK,WAAW,IAAI,EAC1B,GACA,CAAC,EAAmB,KAAK,EAAK,CAC5B,IAAI,IACJ,GAkBN,SAAgB,EAAW,EAAe,CACxC,GAAI,CAAC,GAAQ,EAAK,SAAW,EAC3B,MAAO,IAGT,EAAO,EAAY,EAAK,CAExB,IAAI,EAAQ,GAEZ,MAAO,GAAG,EAAK,WAAW,IAAI,CAAG,IAAM,KAAK,EACzC,MAAM,IAAI,CACV,QAAQ,EAAK,IACP,GAAS,MAAM,CAIhB,GAAS,EAAQ,SAAS,IAAI,EAChC,EAAQ,GACD,GAGF,GAAO,EAAM,IAAI,IAAY,GAR3B,EASR,GAAG,GAUV,SAAgB,EAAgB,EAAc,EAAyB,CACrE,IAAI,EAAM,GACN,EAAoB,EACpB,EAAY,GACZ,EAAO,EACPA,EAAsB,KAC1B,IAAK,IAAI,EAAQ,EAAG,GAAS,EAAK,OAAQ,EAAE,EAAO,CACjD,GAAI,EAAQ,EAAK,OAEf,EAAO,EAAK,WACH,IAAS,IAClB,WAEA,EAAO,IAET,GAAI,IAAS,IAAK,CAChB,GAAI,MAAc,EAAQ,GAAK,IAAS,GAAG,GAEhC,IAAS,EAAG,CACrB,GACE,EAAI,OAAS,GACb,IAAsB,GACtB,EAAI,EAAI,OAAS,KAAO,KACxB,EAAI,EAAI,OAAS,KAAO,QAEpB,EAAI,OAAS,EAAG,CAClB,IAAM,EAAiB,EAAI,YAAY,IAAI,CACvC,IAAmB,IACrB,EAAM,GACN,EAAoB,IAEpB,EAAM,EAAI,MAAM,EAAG,EAAe,CAClC,EAAoB,EAAI,OAAS,EAAI,EAAI,YAAY,IAAI,EAE3D,EAAY,EACZ,EAAO,EACP,iBACS,EAAI,OAAS,EAAG,CACzB,EAAM,GACN,EAAoB,EACpB,EAAY,EACZ,EAAO,EACP,UAGA,IACF,GAAO,EAAI,OAAS,EAAI,MAAQ,KAChC,EAAoB,QAGlB,EAAI,OAAS,EACf,GAAO,IAAI,EAAK,MAAM,EAAY,EAAG,EAAM,GAE3C,EAAM,EAAK,MAAM,EAAY,EAAG,EAAM,CAExC,EAAoB,EAAQ,EAAY,EAE1C,EAAY,EACZ,EAAO,OACE,IAAS,KAAO,IAAS,GAClC,EAAE,EAEF,EAAO,GAGX,OAAO,EAUT,SAAgB,EAAe,EAAc,EAAMC,GAAY,CAAU,CAKvE,OAJI,EAAe,EAAK,CACf,EAGF,EAAM,EAAgB,EAAW,EAAMC,EAAI,CAAE,GAAK,CAAC"}
+{"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;;;;;;;;;;;;;;;;;AAkBN,SAAgB,WAAW,MAAe;AACxC,KAAI,CAAC,QAAQ,KAAK,WAAW,EAC3B,QAAO;AAGT,QAAO,YAAY,KAAK;CAExB,IAAI,QAAQ;AAEZ,QAAO,GAAG,KAAK,WAAW,IAAI,GAAG,MAAM,KAAK,KACzC,MAAM,IAAI,CACV,QAAQ,KAAK,YAAY;AACxB,MAAI,CAAC,SAAS,MAAM,CAClB,QAAO;AAGT,MAAI,SAAS,QAAQ,SAAS,IAAI,EAAE;AAClC,WAAQ;AACR,UAAO;;AAGT,SAAO,OAAO,MAAM,IAAI,YAAY;IACnC,GAAG;;;;;;;;;AAUV,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;;;;;;;;;AAUT,SAAgB,eAAe,MAAc,QAAMC,KAAY,EAAU;AACvE,KAAI,eAAe,KAAK,CACtB,QAAO;AAGT,QAAO,MAAM,gBAAgB,WAAW,MAAMC,MAAI,EAAE,KAAK,CAAC"}

package/dist/path/src/cwd.cjs

@@ -1 +1,17 @@
-function e(){return typeof process<`u`&&typeof process.cwd==`function`?process.cwd().replace(/\\/g,`/`):`/`}exports.cwd=e;
+
+//#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

@@ -1,2 +1,17 @@
-function e(){return typeof process<`u`&&typeof process.cwd==`function`?process.cwd().replace(/\\/g,`/`):`/`}export{e as cwd};
+//#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

@@ -1 +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,GAAM,CAIpB,OAHI,OAAO,QAAY,KAAe,OAAO,QAAQ,KAAQ,WACpD,QAAQ,KAAK,CAAC,QAAQ,MAAO,IAAI,CAEnC"}
+{"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/file-path-fns.cjs

@@ -1 +1,169 @@
-const e=require(`./cwd.cjs`),t=require(`./regex.cjs`),n=require(`./is-type.cjs`),r=require(`./correct-path.cjs`),i=require(`../../type-checks/src/is-set-string.cjs`),a=require(`../../types/src/base.cjs`);function o(e,t={}){let{requireExtension:n=!1,withExtension:i=!0}=t,o=r.normalizeWindowsPath(e)?.split(e?.includes(`\\`)?`\\`:`/`)?.pop()??``;return n===!0&&!o.includes(`.`)?a.EMPTY_STRING:i===!1&&o.includes(`.`)?o.replace(`.${l(o)??``}`,``)||a.EMPTY_STRING:o}function s(e,t={}){let n=r.normalizeWindowsPath(e),i=n.replace(o(n,{requireExtension:!1,...t}),``);return i===`/`?i:i.replace(/\/$/,``)}function c(e,t){let n=s(e,t).split(`/`),r=``;for(let e=n.length-1;e>=0;e--){let t=n[e];if(t){r=t;break}}return r??a.EMPTY_STRING}function l(e){if(e.endsWith(`.`)||e.endsWith(`/`))return;let n=t.FILE_EXTENSION_REGEX.exec(r.normalizeWindowsPath(e));return n&&n.length>0&&i.isSetString(n[0])?n[0].replace(`.`,``):void 0}function u(e){return!!l(e)}function d(...t){t=t.map(e=>r.normalizeWindowsPath(e));let i=``,a=!1;for(let r=t.length-1;r>=-1&&!a;r--){let o=r>=0?t[r]:e.cwd();!o||o.length===0||(i=`${o}/${i}`,a=n.isAbsolute(o))}return i=r.normalizeString(i,!a),a&&!n.isAbsolute(i)?`/${i}`:i.length>0?i:`.`}function f(e,n){let r=d(e).replace(t.ROOT_FOLDER_REGEX,`$1`).split(`/`),i=d(n).replace(t.ROOT_FOLDER_REGEX,`$1`).split(`/`);if(i[0][1]===`:`&&r[0][1]===`:`&&r[0]!==i[0])return i.join(`/`);let a=[...r];for(let e of a){if(i[0]!==e)break;r.shift(),i.shift()}return[...r.map(()=>`..`),...i].join(`/`)}function p(e,t,n=!1){return f(n===!0?e:e.replace(/\/$/,``),n===!0?t:t.replace(/\/$/,``))}exports.findFileExtension=l,exports.findFileName=o,exports.findFilePath=s,exports.findFolderName=c,exports.hasFileExtension=u,exports.relativePath=p;
+const require_cwd = require('./cwd.cjs');
+const require_regex = require('./regex.cjs');
+const require_is_type = require('./is-type.cjs');
+const require_correct_path = require('./correct-path.cjs');
+const require_is_set_string = require('../../type-checks/src/is-set-string.cjs');
+const require_base = require('../../types/src/base.cjs');
+
+//#region ../path/src/file-path-fns.ts
+/**
+* Find the file name from a file path.
+*
+* @example
+* ```ts
+* const fileName = findFileName("C:\\Users\\user\\Documents\\file.txt");
+* // fileName = "file.txt"
+* ```
+*
+* @param filePath - The file path to process
+* @param options - Options to control the file name extraction
+* @returns The file name
+*/
+function findFileName(filePath, options = {}) {
+	const { requireExtension = false, withExtension = true } = options;
+	const result = require_correct_path.normalizeWindowsPath(filePath)?.split(filePath?.includes("\\") ? "\\" : "/")?.pop() ?? "";
+	if (requireExtension === true && !result.includes(".")) return require_base.EMPTY_STRING;
+	if (withExtension === false && result.includes(".")) return result.replace(`.${findFileExtension(result) ?? ""}`, "") || require_base.EMPTY_STRING;
+	return result;
+}
+/**
+* Find the full file path's directories from a file path.
+*
+* @remarks
+* The functionality of this method is similar to the {@link path.dirname} function in Node's path module.
+*
+* @example
+* ```ts
+* const folderPath = findFilePath("C:\\Users\\user\\Documents\\file.txt");
+* // folderPath = "C:\\Users\\user\\Documents"
+* ```
+*
+* @param filePath - The file path to process
+* @param options - Options to control the file name extraction
+* @returns The full file path's directories
+*/
+function findFilePath(filePath, options = {}) {
+	const normalizedPath = require_correct_path.normalizeWindowsPath(filePath);
+	const result = normalizedPath.replace(findFileName(normalizedPath, {
+		requireExtension: false,
+		...options
+	}), "");
+	return result === "/" ? result : result.replace(/\/$/, "");
+}
+/**
+* Find the top most folder containing the file from a file path.
+*
+* @remarks
+* The functionality of this method is similar to the {@link path.basename} function in Node's path module.
+* If you're looking for the full path of the folder (for example: `C:\\Users\\user\\Documents` instead of just `Documents`) containing the file, use {@link findFilePath} instead.
+*
+* @example
+* const folderPath = findFolderName("C:\\Users\\user\\Documents\\file.txt");
+* // folderPath = "Documents"
+*
+* @param filePath - The file path to process
+* @param options - Options to control the file name extraction
+* @returns The folder containing the file
+*/
+function findFolderName(filePath, options) {
+	const segments = findFilePath(filePath, options).split("/");
+	let lastSegment = "";
+	for (let i = segments.length - 1; i >= 0; i--) {
+		const val = segments[i];
+		if (val) {
+			lastSegment = val;
+			break;
+		}
+	}
+	return lastSegment ?? require_base.EMPTY_STRING;
+}
+/**
+* Find the file extension from a file path.
+*
+* @remarks
+* The functionality of this method is similar to the {@link path.extname} function in Node's path module.
+* The file extension is the part of the file name that comes after the last dot (`.`) in the file name. If the file name does not contain a dot, or if it ends with a dot, this function will return `undefined`.
+*
+* The returned extension **will not** include the dot, for example `txt` or `js` instead of `.txt` or `.js`.
+*
+* @example
+* ```ts
+* findFileExtension("C:\\Users\\user\\Documents\\file.config.ts");
+* // Returns "ts"
+* ```
+*
+* @param filePath - The file path to process
+* @returns The file extension or undefined if no extension is found
+*/
+function findFileExtension(filePath) {
+	if (filePath.endsWith(".") || filePath.endsWith("/")) return;
+	const match = require_regex.FILE_EXTENSION_REGEX.exec(require_correct_path.normalizeWindowsPath(filePath));
+	return match && match.length > 0 && require_is_set_string.isSetString(match[0]) ? match[0].replace(".", "") : void 0;
+}
+/**
+* Check if a file path has a file extension.
+*
+* @param filePath - The file path to process
+* @returns An indicator specifying if the file path has a file extension
+*/
+function hasFileExtension(filePath) {
+	return Boolean(findFileExtension(filePath));
+}
+function resolve(...paths) {
+	paths = paths.map((argument) => require_correct_path.normalizeWindowsPath(argument));
+	let resolvedPath = "";
+	let resolvedAbsolute = false;
+	for (let index = paths.length - 1; index >= -1 && !resolvedAbsolute; index--) {
+		const path = index >= 0 ? paths[index] : require_cwd.cwd();
+		if (!path || path.length === 0) continue;
+		resolvedPath = `${path}/${resolvedPath}`;
+		resolvedAbsolute = require_is_type.isAbsolute(path);
+	}
+	resolvedPath = require_correct_path.normalizeString(resolvedPath, !resolvedAbsolute);
+	if (resolvedAbsolute && !require_is_type.isAbsolute(resolvedPath)) return `/${resolvedPath}`;
+	return resolvedPath.length > 0 ? resolvedPath : ".";
+}
+/**
+* Get the relative path from one file to another.
+*
+* @remarks
+* This function is similar to the `path.relative` function in Node's path module.
+*
+* @param from - The base path to start from
+* @param to - The target path to resolve relative to the base path
+* @returns The relative path from the base path to the target path
+*/
+function relative(from, to) {
+	const _from = resolve(from).replace(require_regex.ROOT_FOLDER_REGEX, "$1").split("/");
+	const _to = resolve(to).replace(require_regex.ROOT_FOLDER_REGEX, "$1").split("/");
+	if (_to[0][1] === ":" && _from[0][1] === ":" && _from[0] !== _to[0]) return _to.join("/");
+	const _fromCopy = [..._from];
+	for (const segment of _fromCopy) {
+		if (_to[0] !== segment) break;
+		_from.shift();
+		_to.shift();
+	}
+	return [..._from.map(() => ".."), ..._to].join("/");
+}
+/**
+* Get the relative path from one file to another.
+*
+* @remarks
+* This function wraps the `path.relative` function in Node's path module.
+*
+* @param from - The base path to start from
+* @param to - The target path to resolve relative to the base path
+* @param withEndSlash - Whether to include a trailing slash at the end of the path
+* @returns The relative path from the base path to the target path
+*/
+function relativePath(from, to, withEndSlash = false) {
+	return relative(withEndSlash !== true ? from.replace(/\/$/, "") : from, withEndSlash !== true ? to.replace(/\/$/, "") : to);
+}
+
+//#endregion
+exports.findFileExtension = findFileExtension;
+exports.findFileName = findFileName;
+exports.findFilePath = findFilePath;
+exports.findFolderName = findFolderName;
+exports.hasFileExtension = hasFileExtension;
+exports.relativePath = relativePath;