@stryke/path 0.24.4 → 0.25.1

package/dist/file-path-fns.cjs

@@ -1 +1,332 @@
-const e=require(`./cwd.cjs`),t=require(`./regex.cjs`),n=require(`./is-type.cjs`),r=require(`./join-paths.cjs`),i=require(`./correct-path.cjs`),a=require(`./type-checks/src/is-set-string.cjs`),o=require(`./types/src/base.cjs`);function s(e,t={}){let{requireExtension:n=!1,withExtension:r=!0}=t,a=i.normalizeWindowsPath(e)?.split(e?.includes(`\\`)?`\\`:`/`)?.pop()??``;return n===!0&&!a.includes(`.`)?o.EMPTY_STRING:r===!1&&a.includes(`.`)?a.replace(`.${f(a)??``}`,``)||o.EMPTY_STRING:a}function c(e,t={}){let n=i.normalizeWindowsPath(e),r=n.replace(s(n,{requireExtension:!1,...t}),``);return r===`/`?r:r.replace(/\/$/,``)}const l=c;function u(e,t){let n=c(e,t).split(`/`),r=``;for(let e=n.length-1;e>=0;e--){let t=n[e];if(t){r=t;break}}return r??o.EMPTY_STRING}const d=u;function f(e){if(e.endsWith(`.`)||e.endsWith(`/`))return;let n=t.FILE_EXTENSION_REGEX.exec(i.normalizeWindowsPath(e));return n&&n.length>0&&a.isSetString(n[0])?n[0].replace(`.`,``):void 0}const p=f;function m(e){let t=f(e);return t?`.${t}`:void 0}function h(e){return f(e)??o.EMPTY_STRING}function g(e){let t=f(e);return t?`.${t}`:``}function _(e){return!!s(e)}function v(e){return!!c(e)}function y(e){return!!u(e)}function b(e){return!!f(e)}function x(t,a=e.cwd()){let o=i.normalizeWindowsPath(t).split(`/`),s=``,c=!1;for(let e=o.length-1;e>=-1&&!c;e--){let t=e>=0?o[e]:a;!t||t.length===0||(s=r.joinPaths(t,s),c=n.isAbsolutePath(t))}return s=i.normalizeString(s,!c),c&&!n.isAbsolutePath(s)?`/${s}`:s.length>0?s:`.`}function S(...t){t=t.map(e=>i.normalizeWindowsPath(e));let r=``,a=!1;for(let i=t.length-1;i>=-1&&!a;i--){let o=i>=0?t[i]:e.cwd();!o||o.length===0||(r=`${o}/${r}`,a=n.isAbsolute(o))}return r=i.normalizeString(r,!a),a&&!n.isAbsolute(r)?`/${r}`:r.length>0?r:`.`}function C(...e){return x(r.joinPaths(...e.map(e=>i.normalizeWindowsPath(e))))}function w(e,n){let r=S(e).replace(t.ROOT_FOLDER_REGEX,`$1`).split(`/`),i=S(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 T(e,t,n=!1){return w(n===!0?e:e.replace(/\/$/,``),n===!0?t:t.replace(/\/$/,``))}function E(t){return T(t,e.cwd())}function D(e){let t=/^[/\\]|^[a-z]:[/\\]/i.exec(e)?.[0]?.replace(/\\/g,`/`)||``,r=i.normalizeWindowsPath(e),a=r.replace(/\/$/,``).split(`/`).slice(0,-1);a.length===1&&/^[A-Z]:$/i.test(a[0])&&(a[0]+=`/`);let o=u(r),s=a.join(`/`)||(n.isAbsolutePath(e)?`/`:`.`),c=h(e);return{root:t,dir:s,base:o,ext:c,name:o.slice(0,o.length-c.length)}}function O(e,t){let n=D(e);return r.joinPaths(n.dir,t.includes(`.`)?t:t+n.ext)}exports.basename=d,exports.dirname=l,exports.extname=p,exports.findFileDotExtension=m,exports.findFileDotExtensionSafe=g,exports.findFileExtension=f,exports.findFileExtensionSafe=h,exports.findFileName=s,exports.findFilePath=c,exports.findFolderName=u,exports.hasFileExtension=b,exports.hasFileName=_,exports.hasFilePath=v,exports.hasFolderName=y,exports.parsePath=D,exports.relative=w,exports.relativePath=T,exports.relativeToCurrentDir=E,exports.renameFile=O,exports.resolve=S,exports.resolvePath=x,exports.resolvePaths=C;
+const require_cwd = require('./cwd.cjs');
+const require_regex = require('./regex.cjs');
+const require_is_type = require('./is-type.cjs');
+const require_join_paths = require('./join-paths.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 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(/\/$/, "");
+}
+const dirname = findFilePath;
+/**
+* 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;
+}
+const basename = findFolderName;
+/**
+* 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;
+}
+const extname = findFileExtension;
+/**
+* Find the file extension including the `"."` character prefix from a file path.
+*
+* @remarks
+* The file extension is the part of the file name that comes after (and including) 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** include the dot, for example `.txt` or `.js` instead of `txt` or `js`.
+*
+* @param filePath - The file path to process
+* @returns The file extension (including the `"."` prefix) or undefined if no extension is found
+*/
+function findFileDotExtension(filePath) {
+	const ext = findFileExtension(filePath);
+	return ext ? `.${ext}` : void 0;
+}
+/**
+* Find the file extension from a file path or an empty string.
+*
+*  @remarks
+* 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`.
+*
+* @param filePath - The file path to process
+* @returns The file extension or an empty string if no extension is found
+*/
+function findFileExtensionSafe(filePath) {
+	return findFileExtension(filePath) ?? require_base.EMPTY_STRING;
+}
+/**
+* Find the file extension including the `"."` character prefix from a file path or an empty string.
+*
+*  @remarks
+* The file extension is the part of the file name that comes after (and including) 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** include the dot, for example `.txt` or `.js` instead of `txt` or `js`.
+*
+* @param filePath - The file path to process
+* @returns The file extension (including the `"."` prefix) or an empty string if no extension is found
+*/
+function findFileDotExtensionSafe(filePath) {
+	const ext = findFileExtension(filePath);
+	return ext ? `.${ext}` : "";
+}
+/**
+* Check if a file path has a file name.
+*
+* @param filePath - The file path to process
+* @returns An indicator specifying if the file path has a file name
+*/
+function hasFileName(filePath) {
+	return Boolean(findFileName(filePath));
+}
+/**
+* Check if a file path has a file path.
+*
+* @param filePath - The file path to process
+* @returns An indicator specifying if the file path has a file path
+*/
+function hasFilePath(filePath) {
+	return Boolean(findFilePath(filePath));
+}
+/**
+* Check if a file path has a folder name.
+*
+* @param filePath - The file path to process
+* @returns An indicator specifying if the file path has a folder name
+*/
+function hasFolderName(filePath) {
+	return Boolean(findFolderName(filePath));
+}
+/**
+* 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));
+}
+/**
+* Resolve the file path to an absolute path.
+*
+* @param path - The path to resolve
+* @param cwd - The current working directory
+* @returns The resolved path
+*/
+function resolvePath(path, cwd$1 = require_cwd.cwd()) {
+	const paths = require_correct_path.normalizeWindowsPath(path).split("/");
+	let resolvedPath = "";
+	let resolvedAbsolute = false;
+	for (let index = paths.length - 1; index >= -1 && !resolvedAbsolute; index--) {
+		const path$1 = index >= 0 ? paths[index] : cwd$1;
+		if (!path$1 || path$1.length === 0) continue;
+		resolvedPath = require_join_paths.joinPaths(path$1, resolvedPath);
+		resolvedAbsolute = require_is_type.isAbsolutePath(path$1);
+	}
+	resolvedPath = require_correct_path.normalizeString(resolvedPath, !resolvedAbsolute);
+	if (resolvedAbsolute && !require_is_type.isAbsolutePath(resolvedPath)) return `/${resolvedPath}`;
+	return resolvedPath.length > 0 ? resolvedPath : ".";
+}
+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 : ".";
+}
+/**
+* Resolve the file path to an absolute path.
+*
+* @param paths - The paths to resolve
+* @returns The resolved path
+*/
+function resolvePaths(...paths) {
+	return resolvePath(require_join_paths.joinPaths(...paths.map((path) => require_correct_path.normalizeWindowsPath(path))));
+}
+/**
+* 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);
+}
+/**
+* Find the file path relative to the workspace root path.
+*
+* @param filePath - The file path to process
+* @returns The resolved file path
+*/
+function relativeToCurrentDir(filePath) {
+	return relativePath(filePath, require_cwd.cwd());
+}
+/**
+* Check if the path is a relative path.
+*
+* @param path - The path to check
+* @returns An indicator specifying if the path is a relative path
+*/
+function parsePath(path) {
+	const root = /^[/\\]|^[a-z]:[/\\]/i.exec(path)?.[0]?.replace(/\\/g, "/") || "";
+	const normalizedPath = require_correct_path.normalizeWindowsPath(path);
+	const segments = normalizedPath.replace(/\/$/, "").split("/").slice(0, -1);
+	if (segments.length === 1 && /^[A-Z]:$/i.test(segments[0])) segments[0] += "/";
+	const base = findFolderName(normalizedPath);
+	const dir = segments.join("/") || (require_is_type.isAbsolutePath(path) ? "/" : ".");
+	const ext = findFileExtensionSafe(path);
+	return {
+		root,
+		dir,
+		base,
+		ext,
+		name: base.slice(0, base.length - ext.length)
+	};
+}
+/**
+* Rename the file name with a new name.
+*
+* @param filePath - The current file path being processed
+* @param newFileName - The updated file name being processed
+* @returns The modified or unmodified file path.
+*/
+function renameFile(filePath, newFileName) {
+	const file = parsePath(filePath);
+	return require_join_paths.joinPaths(file.dir, newFileName.includes(".") ? newFileName : newFileName + file.ext);
+}
+
+//#endregion
+exports.basename = basename;
+exports.dirname = dirname;
+exports.extname = extname;
+exports.findFileDotExtension = findFileDotExtension;
+exports.findFileDotExtensionSafe = findFileDotExtensionSafe;
+exports.findFileExtension = findFileExtension;
+exports.findFileExtensionSafe = findFileExtensionSafe;
+exports.findFileName = findFileName;
+exports.findFilePath = findFilePath;
+exports.findFolderName = findFolderName;
+exports.hasFileExtension = hasFileExtension;
+exports.hasFileName = hasFileName;
+exports.hasFilePath = hasFilePath;
+exports.hasFolderName = hasFolderName;
+exports.parsePath = parsePath;
+exports.relative = relative;
+exports.relativePath = relativePath;
+exports.relativeToCurrentDir = relativeToCurrentDir;
+exports.renameFile = renameFile;
+exports.resolve = resolve;
+exports.resolvePath = resolvePath;
+exports.resolvePaths = resolvePaths;

package/dist/file-path-fns.mjs

@@ -1,2 +1,312 @@
-import{cwd as e}from"./cwd.mjs";import{FILE_EXTENSION_REGEX as t,ROOT_FOLDER_REGEX as n}from"./regex.mjs";import{isAbsolute as r,isAbsolutePath as i}from"./is-type.mjs";import{joinPaths as a}from"./join-paths.mjs";import{normalizeString as o,normalizeWindowsPath as s}from"./correct-path.mjs";import{isSetString as c}from"./type-checks/src/is-set-string.mjs";import{EMPTY_STRING as l}from"./types/src/base.mjs";function u(e,t={}){let{requireExtension:n=!1,withExtension:r=!0}=t,i=s(e)?.split(e?.includes(`\\`)?`\\`:`/`)?.pop()??``;return n===!0&&!i.includes(`.`)?l:r===!1&&i.includes(`.`)?i.replace(`.${h(i)??``}`,``)||l:i}function d(e,t={}){let n=s(e),r=n.replace(u(n,{requireExtension:!1,...t}),``);return r===`/`?r:r.replace(/\/$/,``)}const f=d;function p(e,t){let n=d(e,t).split(`/`),r=``;for(let e=n.length-1;e>=0;e--){let t=n[e];if(t){r=t;break}}return r??l}const m=p;function h(e){if(e.endsWith(`.`)||e.endsWith(`/`))return;let n=t.exec(s(e));return n&&n.length>0&&c(n[0])?n[0].replace(`.`,``):void 0}const g=h;function _(e){let t=h(e);return t?`.${t}`:void 0}function v(e){return h(e)??l}function y(e){let t=h(e);return t?`.${t}`:``}function b(e){return!!u(e)}function x(e){return!!d(e)}function S(e){return!!p(e)}function C(e){return!!h(e)}function w(t,n=e()){let r=s(t).split(`/`),c=``,l=!1;for(let e=r.length-1;e>=-1&&!l;e--){let t=e>=0?r[e]:n;!t||t.length===0||(c=a(t,c),l=i(t))}return c=o(c,!l),l&&!i(c)?`/${c}`:c.length>0?c:`.`}function T(...t){t=t.map(e=>s(e));let n=``,i=!1;for(let a=t.length-1;a>=-1&&!i;a--){let o=a>=0?t[a]:e();!o||o.length===0||(n=`${o}/${n}`,i=r(o))}return n=o(n,!i),i&&!r(n)?`/${n}`:n.length>0?n:`.`}function E(...e){return w(a(...e.map(e=>s(e))))}function D(e,t){let r=T(e).replace(n,`$1`).split(`/`),i=T(t).replace(n,`$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 O(e,t,n=!1){return D(n===!0?e:e.replace(/\/$/,``),n===!0?t:t.replace(/\/$/,``))}function k(t){return O(t,e())}function A(e){let t=/^[/\\]|^[a-z]:[/\\]/i.exec(e)?.[0]?.replace(/\\/g,`/`)||``,n=s(e),r=n.replace(/\/$/,``).split(`/`).slice(0,-1);r.length===1&&/^[A-Z]:$/i.test(r[0])&&(r[0]+=`/`);let a=p(n),o=r.join(`/`)||(i(e)?`/`:`.`),c=v(e);return{root:t,dir:o,base:a,ext:c,name:a.slice(0,a.length-c.length)}}function j(e,t){let n=A(e);return a(n.dir,t.includes(`.`)?t:t+n.ext)}export{m as basename,f as dirname,g as extname,_ as findFileDotExtension,y as findFileDotExtensionSafe,h as findFileExtension,v as findFileExtensionSafe,u as findFileName,d as findFilePath,p as findFolderName,C as hasFileExtension,b as hasFileName,x as hasFilePath,S as hasFolderName,A as parsePath,D as relative,O as relativePath,k as relativeToCurrentDir,j as renameFile,T as resolve,w as resolvePath,E as resolvePaths};
+import { cwd } from "./cwd.mjs";
+import { FILE_EXTENSION_REGEX, ROOT_FOLDER_REGEX } from "./regex.mjs";
+import { isAbsolute, isAbsolutePath } from "./is-type.mjs";
+import { joinPaths } from "./join-paths.mjs";
+import { normalizeString, normalizeWindowsPath } from "./correct-path.mjs";
+import { isSetString } from "./type-checks/src/is-set-string.mjs";
+import { EMPTY_STRING } from "./types/src/base.mjs";
+
+//#region 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 = normalizeWindowsPath(filePath)?.split(filePath?.includes("\\") ? "\\" : "/")?.pop() ?? "";
+	if (requireExtension === true && !result.includes(".")) return EMPTY_STRING;
+	if (withExtension === false && result.includes(".")) return result.replace(`.${findFileExtension(result) ?? ""}`, "") || 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 = normalizeWindowsPath(filePath);
+	const result = normalizedPath.replace(findFileName(normalizedPath, {
+		requireExtension: false,
+		...options
+	}), "");
+	return result === "/" ? result : result.replace(/\/$/, "");
+}
+const dirname = findFilePath;
+/**
+* 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 ?? EMPTY_STRING;
+}
+const basename = findFolderName;
+/**
+* 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 = FILE_EXTENSION_REGEX.exec(normalizeWindowsPath(filePath));
+	return match && match.length > 0 && isSetString(match[0]) ? match[0].replace(".", "") : void 0;
+}
+const extname = findFileExtension;
+/**
+* Find the file extension including the `"."` character prefix from a file path.
+*
+* @remarks
+* The file extension is the part of the file name that comes after (and including) 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** include the dot, for example `.txt` or `.js` instead of `txt` or `js`.
+*
+* @param filePath - The file path to process
+* @returns The file extension (including the `"."` prefix) or undefined if no extension is found
+*/
+function findFileDotExtension(filePath) {
+	const ext = findFileExtension(filePath);
+	return ext ? `.${ext}` : void 0;
+}
+/**
+* Find the file extension from a file path or an empty string.
+*
+*  @remarks
+* 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`.
+*
+* @param filePath - The file path to process
+* @returns The file extension or an empty string if no extension is found
+*/
+function findFileExtensionSafe(filePath) {
+	return findFileExtension(filePath) ?? EMPTY_STRING;
+}
+/**
+* Find the file extension including the `"."` character prefix from a file path or an empty string.
+*
+*  @remarks
+* The file extension is the part of the file name that comes after (and including) 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** include the dot, for example `.txt` or `.js` instead of `txt` or `js`.
+*
+* @param filePath - The file path to process
+* @returns The file extension (including the `"."` prefix) or an empty string if no extension is found
+*/
+function findFileDotExtensionSafe(filePath) {
+	const ext = findFileExtension(filePath);
+	return ext ? `.${ext}` : "";
+}
+/**
+* Check if a file path has a file name.
+*
+* @param filePath - The file path to process
+* @returns An indicator specifying if the file path has a file name
+*/
+function hasFileName(filePath) {
+	return Boolean(findFileName(filePath));
+}
+/**
+* Check if a file path has a file path.
+*
+* @param filePath - The file path to process
+* @returns An indicator specifying if the file path has a file path
+*/
+function hasFilePath(filePath) {
+	return Boolean(findFilePath(filePath));
+}
+/**
+* Check if a file path has a folder name.
+*
+* @param filePath - The file path to process
+* @returns An indicator specifying if the file path has a folder name
+*/
+function hasFolderName(filePath) {
+	return Boolean(findFolderName(filePath));
+}
+/**
+* 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));
+}
+/**
+* Resolve the file path to an absolute path.
+*
+* @param path - The path to resolve
+* @param cwd - The current working directory
+* @returns The resolved path
+*/
+function resolvePath(path, cwd$1 = cwd()) {
+	const paths = normalizeWindowsPath(path).split("/");
+	let resolvedPath = "";
+	let resolvedAbsolute = false;
+	for (let index = paths.length - 1; index >= -1 && !resolvedAbsolute; index--) {
+		const path$1 = index >= 0 ? paths[index] : cwd$1;
+		if (!path$1 || path$1.length === 0) continue;
+		resolvedPath = joinPaths(path$1, resolvedPath);
+		resolvedAbsolute = isAbsolutePath(path$1);
+	}
+	resolvedPath = normalizeString(resolvedPath, !resolvedAbsolute);
+	if (resolvedAbsolute && !isAbsolutePath(resolvedPath)) return `/${resolvedPath}`;
+	return resolvedPath.length > 0 ? resolvedPath : ".";
+}
+function resolve(...paths) {
+	paths = paths.map((argument) => normalizeWindowsPath(argument));
+	let resolvedPath = "";
+	let resolvedAbsolute = false;
+	for (let index = paths.length - 1; index >= -1 && !resolvedAbsolute; index--) {
+		const path = index >= 0 ? paths[index] : cwd();
+		if (!path || path.length === 0) continue;
+		resolvedPath = `${path}/${resolvedPath}`;
+		resolvedAbsolute = isAbsolute(path);
+	}
+	resolvedPath = normalizeString(resolvedPath, !resolvedAbsolute);
+	if (resolvedAbsolute && !isAbsolute(resolvedPath)) return `/${resolvedPath}`;
+	return resolvedPath.length > 0 ? resolvedPath : ".";
+}
+/**
+* Resolve the file path to an absolute path.
+*
+* @param paths - The paths to resolve
+* @returns The resolved path
+*/
+function resolvePaths(...paths) {
+	return resolvePath(joinPaths(...paths.map((path) => normalizeWindowsPath(path))));
+}
+/**
+* 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(ROOT_FOLDER_REGEX, "$1").split("/");
+	const _to = resolve(to).replace(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);
+}
+/**
+* Find the file path relative to the workspace root path.
+*
+* @param filePath - The file path to process
+* @returns The resolved file path
+*/
+function relativeToCurrentDir(filePath) {
+	return relativePath(filePath, cwd());
+}
+/**
+* Check if the path is a relative path.
+*
+* @param path - The path to check
+* @returns An indicator specifying if the path is a relative path
+*/
+function parsePath(path) {
+	const root = /^[/\\]|^[a-z]:[/\\]/i.exec(path)?.[0]?.replace(/\\/g, "/") || "";
+	const normalizedPath = normalizeWindowsPath(path);
+	const segments = normalizedPath.replace(/\/$/, "").split("/").slice(0, -1);
+	if (segments.length === 1 && /^[A-Z]:$/i.test(segments[0])) segments[0] += "/";
+	const base = findFolderName(normalizedPath);
+	const dir = segments.join("/") || (isAbsolutePath(path) ? "/" : ".");
+	const ext = findFileExtensionSafe(path);
+	return {
+		root,
+		dir,
+		base,
+		ext,
+		name: base.slice(0, base.length - ext.length)
+	};
+}
+/**
+* Rename the file name with a new name.
+*
+* @param filePath - The current file path being processed
+* @param newFileName - The updated file name being processed
+* @returns The modified or unmodified file path.
+*/
+function renameFile(filePath, newFileName) {
+	const file = parsePath(filePath);
+	return joinPaths(file.dir, newFileName.includes(".") ? newFileName : newFileName + file.ext);
+}
+
+//#endregion
+export { basename, dirname, extname, findFileDotExtension, findFileDotExtensionSafe, findFileExtension, findFileExtensionSafe, findFileName, findFilePath, findFolderName, hasFileExtension, hasFileName, hasFilePath, hasFolderName, parsePath, relative, relativePath, relativeToCurrentDir, renameFile, resolve, resolvePath, resolvePaths };
 //# sourceMappingURL=file-path-fns.mjs.map