@stryke/fs 0.33.32 → 0.33.33

package/dist/path/src/file-path-fns.mjs

@@ -1,2 +1,165 @@
-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}from"./is-type.mjs";import{normalizeString as i,normalizeWindowsPath as a}from"./correct-path.mjs";import{isSetString as o}from"../../type-checks/src/is-set-string.mjs";import{EMPTY_STRING as s}from"../../types/src/base.mjs";function c(e,t={}){let{requireExtension:n=!1,withExtension:r=!0}=t,i=a(e)?.split(e?.includes(`\\`)?`\\`:`/`)?.pop()??``;return n===!0&&!i.includes(`.`)?s:r===!1&&i.includes(`.`)?i.replace(`.${d(i)??``}`,``)||s:i}function l(e,t={}){let n=a(e),r=n.replace(c(n,{requireExtension:!1,...t}),``);return r===`/`?r:r.replace(/\/$/,``)}function u(e,t){let n=l(e,t).split(`/`),r=``;for(let e=n.length-1;e>=0;e--){let t=n[e];if(t){r=t;break}}return r??s}function d(e){if(e.endsWith(`.`)||e.endsWith(`/`))return;let n=t.exec(a(e));return n&&n.length>0&&o(n[0])?n[0].replace(`.`,``):void 0}function f(e){return!!d(e)}function p(...t){t=t.map(e=>a(e));let n=``,o=!1;for(let i=t.length-1;i>=-1&&!o;i--){let a=i>=0?t[i]:e();!a||a.length===0||(n=`${a}/${n}`,o=r(a))}return n=i(n,!o),o&&!r(n)?`/${n}`:n.length>0?n:`.`}function m(e,t){let r=p(e).replace(n,`$1`).split(`/`),i=p(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 h(e,t,n=!1){return m(n===!0?e:e.replace(/\/$/,``),n===!0?t:t.replace(/\/$/,``))}export{d as findFileExtension,c as findFileName,l as findFilePath,u as findFolderName,f as hasFileExtension,h as relativePath};
+import { cwd } from "./cwd.mjs";
+import { FILE_EXTENSION_REGEX, ROOT_FOLDER_REGEX } from "./regex.mjs";
+import { isAbsolute } from "./is-type.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 ../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 = 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(/\/$/, "");
+}
+/**
+* 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;
+}
+/**
+* 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;
+}
+/**
+* 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) => 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 : ".";
+}
+/**
+* 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);
+}
+
+//#endregion
+export { findFileExtension, findFileName, findFilePath, findFolderName, hasFileExtension, relativePath };
 //# sourceMappingURL=file-path-fns.mjs.map

package/dist/path/src/file-path-fns.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"file-path-fns.mjs","names":["currentDir"],"sources":["../../../../path/src/file-path-fns.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 { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { EMPTY_STRING } from \"@stryke/types/base\";\nimport { normalizeString, normalizeWindowsPath } from \"./correct-path\";\nimport { cwd as currentDir } from \"./cwd\";\nimport { isAbsolute, isAbsolutePath } from \"./is-type\";\nimport { joinPaths } from \"./join-paths\";\nimport { FILE_EXTENSION_REGEX, ROOT_FOLDER_REGEX } from \"./regex\";\n\nexport interface FindFileNameOptions {\n  /**\n   * Require the file extension to be present in the file name.\n   *\n   * @defaultValue false\n   */\n  requireExtension?: boolean;\n\n  /**\n   * Return the file extension as part of the full file name result.\n   *\n   * @defaultValue true\n   */\n  withExtension?: boolean;\n}\n\n/**\n * Find the file name from a file path.\n *\n * @example\n * ```ts\n * const fileName = findFileName(\"C:\\\\Users\\\\user\\\\Documents\\\\file.txt\");\n * // fileName = \"file.txt\"\n * ```\n *\n * @param filePath - The file path to process\n * @param options - Options to control the file name extraction\n * @returns The file name\n */\nexport function findFileName(\n  filePath: string,\n  options: FindFileNameOptions = {}\n): string {\n  const { requireExtension = false, withExtension = true } = options;\n  const result =\n    normalizeWindowsPath(filePath)\n      ?.split(filePath?.includes(\"\\\\\") ? \"\\\\\" : \"/\")\n      ?.pop() ?? \"\";\n\n  if (requireExtension === true && !result.includes(\".\")) {\n    return EMPTY_STRING;\n  }\n\n  if (withExtension === false && result.includes(\".\")) {\n    return (\n      result.replace(`.${findFileExtension(result) ?? \"\"}`, \"\") || EMPTY_STRING\n    );\n  }\n\n  return result;\n}\n\n/**\n * Find the full file path's directories from a file path.\n *\n * @remarks\n * The functionality of this method is similar to the {@link path.dirname} function in Node's path module.\n *\n * @example\n * ```ts\n * const folderPath = findFilePath(\"C:\\\\Users\\\\user\\\\Documents\\\\file.txt\");\n * // folderPath = \"C:\\\\Users\\\\user\\\\Documents\"\n * ```\n *\n * @param filePath - The file path to process\n * @param options - Options to control the file name extraction\n * @returns The full file path's directories\n */\nexport function findFilePath(\n  filePath: string,\n  options: FindFileNameOptions = {}\n): string {\n  const normalizedPath = normalizeWindowsPath(filePath);\n\n  const result = normalizedPath.replace(\n    findFileName(normalizedPath, { requireExtension: false, ...options }),\n    \"\"\n  );\n\n  return result === \"/\" ? result : result.replace(/\\/$/, \"\");\n}\n\nexport const dirname = findFilePath;\n\n/**\n * Find the top most folder containing the file from a file path.\n *\n * @remarks\n * The functionality of this method is similar to the {@link path.basename} function in Node's path module.\n * 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.\n *\n * @example\n * const folderPath = findFolderName(\"C:\\\\Users\\\\user\\\\Documents\\\\file.txt\");\n * // folderPath = \"Documents\"\n *\n * @param filePath - The file path to process\n * @param options - Options to control the file name extraction\n * @returns The folder containing the file\n */\nexport function findFolderName(\n  filePath: string,\n  options?: FindFileNameOptions\n): string {\n  const segments = findFilePath(filePath, options).split(\"/\");\n\n  let lastSegment = \"\";\n  for (let i = segments.length - 1; i >= 0; i--) {\n    const val = segments[i];\n    if (val) {\n      lastSegment = val;\n      break;\n    }\n  }\n\n  // if (\n  //   folderPath.lastIndexOf(\"\\\\\") === folderPath.length - 1 ||\n  //   folderPath.lastIndexOf(\"/\") === folderPath.length - 1\n  // ) {\n  //   folderPath = folderPath.slice(0, Math.max(0, folderPath.length - 1));\n  // }\n\n  return lastSegment ?? EMPTY_STRING;\n}\n\nexport const basename = findFolderName;\n\n/**\n * Find the file extension from a file path.\n *\n * @remarks\n * The functionality of this method is similar to the {@link path.extname} function in Node's path module.\n * 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`.\n *\n * The returned extension **will not** include the dot, for example `txt` or `js` instead of `.txt` or `.js`.\n *\n * @example\n * ```ts\n * findFileExtension(\"C:\\\\Users\\\\user\\\\Documents\\\\file.config.ts\");\n * // Returns \"ts\"\n * ```\n *\n * @param filePath - The file path to process\n * @returns The file extension or undefined if no extension is found\n */\nexport function findFileExtension(filePath: string): string | undefined {\n  if (filePath.endsWith(\".\") || filePath.endsWith(\"/\")) {\n    return undefined;\n  }\n\n  const match = FILE_EXTENSION_REGEX.exec(normalizeWindowsPath(filePath));\n\n  return match && match.length > 0 && isSetString(match[0])\n    ? match[0].replace(\".\", \"\")\n    : undefined;\n}\n\nexport const extname = findFileExtension;\n\n/**\n * Find the file extension including the `\".\"` character prefix from a file path.\n *\n * @remarks\n * 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`.\n *\n * The returned extension **will** include the dot, for example `.txt` or `.js` instead of `txt` or `js`.\n *\n * @param filePath - The file path to process\n * @returns The file extension (including the `\".\"` prefix) or undefined if no extension is found\n */\nexport function findFileDotExtension(filePath: string): string | undefined {\n  const ext = findFileExtension(filePath);\n\n  return ext ? `.${ext}` : undefined;\n}\n\n/**\n * Find the file extension from a file path or an empty string.\n *\n *  @remarks\n * 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`.\n *\n * The returned extension **will not** include the dot, for example `txt` or `js` instead of `.txt` or `.js`.\n *\n * @param filePath - The file path to process\n * @returns The file extension or an empty string if no extension is found\n */\nexport function findFileExtensionSafe(filePath: string): string {\n  return findFileExtension(filePath) ?? EMPTY_STRING;\n}\n\n/**\n * Find the file extension including the `\".\"` character prefix from a file path or an empty string.\n *\n *  @remarks\n * 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`.\n *\n * The returned extension **will** include the dot, for example `.txt` or `.js` instead of `txt` or `js`.\n *\n * @param filePath - The file path to process\n * @returns The file extension (including the `\".\"` prefix) or an empty string if no extension is found\n */\nexport function findFileDotExtensionSafe(filePath: string): string {\n  const ext = findFileExtension(filePath);\n\n  return ext ? `.${ext}` : \"\";\n}\n\n/**\n * Check if a file path has a file name.\n *\n * @param filePath - The file path to process\n * @returns An indicator specifying if the file path has a file name\n */\nexport function hasFileName(filePath: string): boolean {\n  return Boolean(findFileName(filePath));\n}\n\n/**\n * Check if a file path has a file path.\n *\n * @param filePath - The file path to process\n * @returns An indicator specifying if the file path has a file path\n */\nexport function hasFilePath(filePath: string): boolean {\n  return Boolean(findFilePath(filePath));\n}\n\n/**\n * Check if a file path has a folder name.\n *\n * @param filePath - The file path to process\n * @returns An indicator specifying if the file path has a folder name\n */\nexport function hasFolderName(filePath: string): boolean {\n  return Boolean(findFolderName(filePath));\n}\n\n/**\n * Check if a file path has a file extension.\n *\n * @param filePath - The file path to process\n * @returns An indicator specifying if the file path has a file extension\n */\nexport function hasFileExtension(filePath: string): boolean {\n  return Boolean(findFileExtension(filePath));\n}\n\n/**\n * Resolve the file path to an absolute path.\n *\n * @param path - The path to resolve\n * @param cwd - The current working directory\n * @returns The resolved path\n */\nexport function resolvePath(path: string, cwd = currentDir()) {\n  // Normalize windows arguments\n  const paths = normalizeWindowsPath(path).split(\"/\");\n\n  let resolvedPath = \"\";\n  let resolvedAbsolute = false;\n\n  for (\n    let index = paths.length - 1;\n    index >= -1 && !resolvedAbsolute;\n    index--\n  ) {\n    const path = index >= 0 ? paths[index] : cwd;\n\n    // Skip empty entries\n    if (!path || path.length === 0) {\n      continue;\n    }\n\n    resolvedPath = joinPaths(path, resolvedPath);\n    resolvedAbsolute = isAbsolutePath(path);\n  }\n\n  // At this point the path should be resolved to a full absolute path, but\n  // handle relative paths to be safe (might happen when process.cwd() fails)\n\n  // Normalize the path\n  resolvedPath = normalizeString(resolvedPath, !resolvedAbsolute);\n\n  if (resolvedAbsolute && !isAbsolutePath(resolvedPath)) {\n    return `/${resolvedPath}`;\n  }\n\n  return resolvedPath.length > 0 ? resolvedPath : \".\";\n}\n\nexport function resolve(...paths: string[]) {\n  // Normalize windows arguments\n  paths = paths.map(argument => normalizeWindowsPath(argument));\n\n  let resolvedPath = \"\";\n  let resolvedAbsolute = false;\n\n  for (\n    let index = paths.length - 1;\n    index >= -1 && !resolvedAbsolute;\n    index--\n  ) {\n    const path = index >= 0 ? paths[index] : currentDir();\n\n    // Skip empty entries\n    if (!path || path.length === 0) {\n      continue;\n    }\n\n    resolvedPath = `${path}/${resolvedPath}`;\n    resolvedAbsolute = isAbsolute(path);\n  }\n\n  // At this point the path should be resolved to a full absolute path, but\n  // handle relative paths to be safe (might happen when process.cwd() fails)\n\n  // Normalize the path\n  resolvedPath = normalizeString(resolvedPath, !resolvedAbsolute);\n\n  if (resolvedAbsolute && !isAbsolute(resolvedPath)) {\n    return `/${resolvedPath}`;\n  }\n\n  return resolvedPath.length > 0 ? resolvedPath : \".\";\n}\n\n/**\n * Resolve the file path to an absolute path.\n *\n * @param paths - The paths to resolve\n * @returns The resolved path\n */\nexport function resolvePaths(...paths: string[]) {\n  return resolvePath(\n    joinPaths(...paths.map(path => normalizeWindowsPath(path)))\n  );\n}\n\n/**\n * Get the relative path from one file to another.\n *\n * @remarks\n * This function is similar to the `path.relative` function in Node's path module.\n *\n * @param from - The base path to start from\n * @param to - The target path to resolve relative to the base path\n * @returns The relative path from the base path to the target path\n */\nexport function relative(from: string, to: string) {\n  // we cast these because `split` will always be at least one string\n  const _from = resolve(from).replace(ROOT_FOLDER_REGEX, \"$1\").split(\"/\") as [\n    string,\n    ...string[]\n  ];\n  const _to = resolve(to).replace(ROOT_FOLDER_REGEX, \"$1\").split(\"/\") as [\n    string,\n    ...string[]\n  ];\n\n  // Different windows drive letters\n  if (_to[0][1] === \":\" && _from[0][1] === \":\" && _from[0] !== _to[0]) {\n    return _to.join(\"/\");\n  }\n\n  const _fromCopy = [..._from];\n  for (const segment of _fromCopy) {\n    if (_to[0] !== segment) {\n      break;\n    }\n    _from.shift();\n    _to.shift();\n  }\n  return [..._from.map(() => \"..\"), ..._to].join(\"/\");\n}\n\n/**\n * Get the relative path from one file to another.\n *\n * @remarks\n * This function wraps the `path.relative` function in Node's path module.\n *\n * @param from - The base path to start from\n * @param to - The target path to resolve relative to the base path\n * @param withEndSlash - Whether to include a trailing slash at the end of the path\n * @returns The relative path from the base path to the target path\n */\nexport function relativePath(from: string, to: string, withEndSlash = false) {\n  return relative(\n    withEndSlash !== true ? from.replace(/\\/$/, \"\") : from,\n    withEndSlash !== true ? to.replace(/\\/$/, \"\") : to\n  );\n}\n\n/**\n * Find the file path relative to the workspace root path.\n *\n * @param filePath - The file path to process\n * @returns The resolved file path\n */\nexport function relativeToCurrentDir(filePath: string) {\n  return relativePath(filePath, currentDir());\n}\n\n/**\n * Check if the path is a relative path.\n *\n * @param path - The path to check\n * @returns An indicator specifying if the path is a relative path\n */\nexport function parsePath(path: string) {\n  // The root of the path such as '/' or 'c:\\'\n  const root =\n    /^[/\\\\]|^[a-z]:[/\\\\]/i.exec(path)?.[0]?.replace(/\\\\/g, \"/\") || \"\";\n\n  const normalizedPath = normalizeWindowsPath(path);\n\n  const segments = normalizedPath.replace(/\\/$/, \"\").split(\"/\").slice(0, -1);\n  if (segments.length === 1 && /^[A-Z]:$/i.test(segments[0] as string)) {\n    segments[0] += \"/\";\n  }\n\n  const base = findFolderName(normalizedPath);\n  const dir = segments.join(\"/\") || (isAbsolutePath(path) ? \"/\" : \".\");\n  const ext = findFileExtensionSafe(path);\n\n  return {\n    root,\n    dir,\n    base,\n    ext,\n    name: base.slice(0, base.length - ext.length)\n  };\n}\n\n/**\n * Rename the file name with a new name.\n *\n * @param filePath - The current file path being processed\n * @param newFileName - The updated file name being processed\n * @returns The modified or unmodified file path.\n */\nexport function renameFile(filePath: string, newFileName: string): string {\n  const file = parsePath(filePath);\n\n  return joinPaths(\n    file.dir,\n    newFileName.includes(\".\") ? newFileName : newFileName + file.ext\n  );\n}\n"],"mappings":"kWAuDA,SAAgB,EACd,EACA,EAA+B,EAAE,CACzB,CACR,GAAM,CAAE,mBAAmB,GAAO,gBAAgB,IAAS,EACrD,EACJ,EAAqB,EAAS,EAC1B,MAAM,GAAU,SAAS,KAAK,CAAG,KAAO,IAAI,EAC5C,KAAK,EAAI,GAYf,OAVI,IAAqB,IAAQ,CAAC,EAAO,SAAS,IAAI,CAC7C,EAGL,IAAkB,IAAS,EAAO,SAAS,IAAI,CAE/C,EAAO,QAAQ,IAAI,EAAkB,EAAO,EAAI,KAAM,GAAG,EAAI,EAI1D,EAmBT,SAAgB,EACd,EACA,EAA+B,EAAE,CACzB,CACR,IAAM,EAAiB,EAAqB,EAAS,CAE/C,EAAS,EAAe,QAC5B,EAAa,EAAgB,CAAE,iBAAkB,GAAO,GAAG,EAAS,CAAC,CACrE,GACD,CAED,OAAO,IAAW,IAAM,EAAS,EAAO,QAAQ,MAAO,GAAG,CAoB5D,SAAgB,EACd,EACA,EACQ,CACR,IAAM,EAAW,EAAa,EAAU,EAAQ,CAAC,MAAM,IAAI,CAEvD,EAAc,GAClB,IAAK,IAAI,EAAI,EAAS,OAAS,EAAG,GAAK,EAAG,IAAK,CAC7C,IAAM,EAAM,EAAS,GACrB,GAAI,EAAK,CACP,EAAc,EACd,OAWJ,OAAO,GAAe,EAuBxB,SAAgB,EAAkB,EAAsC,CACtE,GAAI,EAAS,SAAS,IAAI,EAAI,EAAS,SAAS,IAAI,CAClD,OAGF,IAAM,EAAQ,EAAqB,KAAK,EAAqB,EAAS,CAAC,CAEvE,OAAO,GAAS,EAAM,OAAS,GAAK,EAAY,EAAM,GAAG,CACrD,EAAM,GAAG,QAAQ,IAAK,GAAG,CACzB,IAAA,GA0FN,SAAgB,EAAiB,EAA2B,CAC1D,MAAO,EAAQ,EAAkB,EAAS,CA8C5C,SAAgB,EAAQ,GAAG,EAAiB,CAE1C,EAAQ,EAAM,IAAI,GAAY,EAAqB,EAAS,CAAC,CAE7D,IAAI,EAAe,GACf,EAAmB,GAEvB,IACE,IAAI,EAAQ,EAAM,OAAS,EAC3B,GAAS,IAAM,CAAC,EAChB,IACA,CACA,IAAM,EAAO,GAAS,EAAI,EAAM,GAASA,GAAY,CAGjD,CAAC,GAAQ,EAAK,SAAW,IAI7B,EAAe,GAAG,EAAK,GAAG,IAC1B,EAAmB,EAAW,EAAK,EAarC,MANA,GAAe,EAAgB,EAAc,CAAC,EAAiB,CAE3D,GAAoB,CAAC,EAAW,EAAa,CACxC,IAAI,IAGN,EAAa,OAAS,EAAI,EAAe,IAyBlD,SAAgB,EAAS,EAAc,EAAY,CAEjD,IAAM,EAAQ,EAAQ,EAAK,CAAC,QAAQ,EAAmB,KAAK,CAAC,MAAM,IAAI,CAIjE,EAAM,EAAQ,EAAG,CAAC,QAAQ,EAAmB,KAAK,CAAC,MAAM,IAAI,CAMnE,GAAI,EAAI,GAAG,KAAO,KAAO,EAAM,GAAG,KAAO,KAAO,EAAM,KAAO,EAAI,GAC/D,OAAO,EAAI,KAAK,IAAI,CAGtB,IAAM,EAAY,CAAC,GAAG,EAAM,CAC5B,IAAK,IAAM,KAAW,EAAW,CAC/B,GAAI,EAAI,KAAO,EACb,MAEF,EAAM,OAAO,CACb,EAAI,OAAO,CAEb,MAAO,CAAC,GAAG,EAAM,QAAU,KAAK,CAAE,GAAG,EAAI,CAAC,KAAK,IAAI,CAcrD,SAAgB,EAAa,EAAc,EAAY,EAAe,GAAO,CAC3E,OAAO,EACL,IAAiB,GAAiC,EAA1B,EAAK,QAAQ,MAAO,GAAG,CAC/C,IAAiB,GAA+B,EAAxB,EAAG,QAAQ,MAAO,GAAG,CAC9C"}
+{"version":3,"file":"file-path-fns.mjs","names":["currentDir"],"sources":["../../../../path/src/file-path-fns.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 { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { EMPTY_STRING } from \"@stryke/types/base\";\nimport { normalizeString, normalizeWindowsPath } from \"./correct-path\";\nimport { cwd as currentDir } from \"./cwd\";\nimport { isAbsolute, isAbsolutePath } from \"./is-type\";\nimport { joinPaths } from \"./join-paths\";\nimport { FILE_EXTENSION_REGEX, ROOT_FOLDER_REGEX } from \"./regex\";\n\nexport interface FindFileNameOptions {\n  /**\n   * Require the file extension to be present in the file name.\n   *\n   * @defaultValue false\n   */\n  requireExtension?: boolean;\n\n  /**\n   * Return the file extension as part of the full file name result.\n   *\n   * @defaultValue true\n   */\n  withExtension?: boolean;\n}\n\n/**\n * Find the file name from a file path.\n *\n * @example\n * ```ts\n * const fileName = findFileName(\"C:\\\\Users\\\\user\\\\Documents\\\\file.txt\");\n * // fileName = \"file.txt\"\n * ```\n *\n * @param filePath - The file path to process\n * @param options - Options to control the file name extraction\n * @returns The file name\n */\nexport function findFileName(\n  filePath: string,\n  options: FindFileNameOptions = {}\n): string {\n  const { requireExtension = false, withExtension = true } = options;\n  const result =\n    normalizeWindowsPath(filePath)\n      ?.split(filePath?.includes(\"\\\\\") ? \"\\\\\" : \"/\")\n      ?.pop() ?? \"\";\n\n  if (requireExtension === true && !result.includes(\".\")) {\n    return EMPTY_STRING;\n  }\n\n  if (withExtension === false && result.includes(\".\")) {\n    return (\n      result.replace(`.${findFileExtension(result) ?? \"\"}`, \"\") || EMPTY_STRING\n    );\n  }\n\n  return result;\n}\n\n/**\n * Find the full file path's directories from a file path.\n *\n * @remarks\n * The functionality of this method is similar to the {@link path.dirname} function in Node's path module.\n *\n * @example\n * ```ts\n * const folderPath = findFilePath(\"C:\\\\Users\\\\user\\\\Documents\\\\file.txt\");\n * // folderPath = \"C:\\\\Users\\\\user\\\\Documents\"\n * ```\n *\n * @param filePath - The file path to process\n * @param options - Options to control the file name extraction\n * @returns The full file path's directories\n */\nexport function findFilePath(\n  filePath: string,\n  options: FindFileNameOptions = {}\n): string {\n  const normalizedPath = normalizeWindowsPath(filePath);\n\n  const result = normalizedPath.replace(\n    findFileName(normalizedPath, { requireExtension: false, ...options }),\n    \"\"\n  );\n\n  return result === \"/\" ? result : result.replace(/\\/$/, \"\");\n}\n\nexport const dirname = findFilePath;\n\n/**\n * Find the top most folder containing the file from a file path.\n *\n * @remarks\n * The functionality of this method is similar to the {@link path.basename} function in Node's path module.\n * 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.\n *\n * @example\n * const folderPath = findFolderName(\"C:\\\\Users\\\\user\\\\Documents\\\\file.txt\");\n * // folderPath = \"Documents\"\n *\n * @param filePath - The file path to process\n * @param options - Options to control the file name extraction\n * @returns The folder containing the file\n */\nexport function findFolderName(\n  filePath: string,\n  options?: FindFileNameOptions\n): string {\n  const segments = findFilePath(filePath, options).split(\"/\");\n\n  let lastSegment = \"\";\n  for (let i = segments.length - 1; i >= 0; i--) {\n    const val = segments[i];\n    if (val) {\n      lastSegment = val;\n      break;\n    }\n  }\n\n  // if (\n  //   folderPath.lastIndexOf(\"\\\\\") === folderPath.length - 1 ||\n  //   folderPath.lastIndexOf(\"/\") === folderPath.length - 1\n  // ) {\n  //   folderPath = folderPath.slice(0, Math.max(0, folderPath.length - 1));\n  // }\n\n  return lastSegment ?? EMPTY_STRING;\n}\n\nexport const basename = findFolderName;\n\n/**\n * Find the file extension from a file path.\n *\n * @remarks\n * The functionality of this method is similar to the {@link path.extname} function in Node's path module.\n * 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`.\n *\n * The returned extension **will not** include the dot, for example `txt` or `js` instead of `.txt` or `.js`.\n *\n * @example\n * ```ts\n * findFileExtension(\"C:\\\\Users\\\\user\\\\Documents\\\\file.config.ts\");\n * // Returns \"ts\"\n * ```\n *\n * @param filePath - The file path to process\n * @returns The file extension or undefined if no extension is found\n */\nexport function findFileExtension(filePath: string): string | undefined {\n  if (filePath.endsWith(\".\") || filePath.endsWith(\"/\")) {\n    return undefined;\n  }\n\n  const match = FILE_EXTENSION_REGEX.exec(normalizeWindowsPath(filePath));\n\n  return match && match.length > 0 && isSetString(match[0])\n    ? match[0].replace(\".\", \"\")\n    : undefined;\n}\n\nexport const extname = findFileExtension;\n\n/**\n * Find the file extension including the `\".\"` character prefix from a file path.\n *\n * @remarks\n * 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`.\n *\n * The returned extension **will** include the dot, for example `.txt` or `.js` instead of `txt` or `js`.\n *\n * @param filePath - The file path to process\n * @returns The file extension (including the `\".\"` prefix) or undefined if no extension is found\n */\nexport function findFileDotExtension(filePath: string): string | undefined {\n  const ext = findFileExtension(filePath);\n\n  return ext ? `.${ext}` : undefined;\n}\n\n/**\n * Find the file extension from a file path or an empty string.\n *\n *  @remarks\n * 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`.\n *\n * The returned extension **will not** include the dot, for example `txt` or `js` instead of `.txt` or `.js`.\n *\n * @param filePath - The file path to process\n * @returns The file extension or an empty string if no extension is found\n */\nexport function findFileExtensionSafe(filePath: string): string {\n  return findFileExtension(filePath) ?? EMPTY_STRING;\n}\n\n/**\n * Find the file extension including the `\".\"` character prefix from a file path or an empty string.\n *\n *  @remarks\n * 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`.\n *\n * The returned extension **will** include the dot, for example `.txt` or `.js` instead of `txt` or `js`.\n *\n * @param filePath - The file path to process\n * @returns The file extension (including the `\".\"` prefix) or an empty string if no extension is found\n */\nexport function findFileDotExtensionSafe(filePath: string): string {\n  const ext = findFileExtension(filePath);\n\n  return ext ? `.${ext}` : \"\";\n}\n\n/**\n * Check if a file path has a file name.\n *\n * @param filePath - The file path to process\n * @returns An indicator specifying if the file path has a file name\n */\nexport function hasFileName(filePath: string): boolean {\n  return Boolean(findFileName(filePath));\n}\n\n/**\n * Check if a file path has a file path.\n *\n * @param filePath - The file path to process\n * @returns An indicator specifying if the file path has a file path\n */\nexport function hasFilePath(filePath: string): boolean {\n  return Boolean(findFilePath(filePath));\n}\n\n/**\n * Check if a file path has a folder name.\n *\n * @param filePath - The file path to process\n * @returns An indicator specifying if the file path has a folder name\n */\nexport function hasFolderName(filePath: string): boolean {\n  return Boolean(findFolderName(filePath));\n}\n\n/**\n * Check if a file path has a file extension.\n *\n * @param filePath - The file path to process\n * @returns An indicator specifying if the file path has a file extension\n */\nexport function hasFileExtension(filePath: string): boolean {\n  return Boolean(findFileExtension(filePath));\n}\n\n/**\n * Resolve the file path to an absolute path.\n *\n * @param path - The path to resolve\n * @param cwd - The current working directory\n * @returns The resolved path\n */\nexport function resolvePath(path: string, cwd = currentDir()) {\n  // Normalize windows arguments\n  const paths = normalizeWindowsPath(path).split(\"/\");\n\n  let resolvedPath = \"\";\n  let resolvedAbsolute = false;\n\n  for (\n    let index = paths.length - 1;\n    index >= -1 && !resolvedAbsolute;\n    index--\n  ) {\n    const path = index >= 0 ? paths[index] : cwd;\n\n    // Skip empty entries\n    if (!path || path.length === 0) {\n      continue;\n    }\n\n    resolvedPath = joinPaths(path, resolvedPath);\n    resolvedAbsolute = isAbsolutePath(path);\n  }\n\n  // At this point the path should be resolved to a full absolute path, but\n  // handle relative paths to be safe (might happen when process.cwd() fails)\n\n  // Normalize the path\n  resolvedPath = normalizeString(resolvedPath, !resolvedAbsolute);\n\n  if (resolvedAbsolute && !isAbsolutePath(resolvedPath)) {\n    return `/${resolvedPath}`;\n  }\n\n  return resolvedPath.length > 0 ? resolvedPath : \".\";\n}\n\nexport function resolve(...paths: string[]) {\n  // Normalize windows arguments\n  paths = paths.map(argument => normalizeWindowsPath(argument));\n\n  let resolvedPath = \"\";\n  let resolvedAbsolute = false;\n\n  for (\n    let index = paths.length - 1;\n    index >= -1 && !resolvedAbsolute;\n    index--\n  ) {\n    const path = index >= 0 ? paths[index] : currentDir();\n\n    // Skip empty entries\n    if (!path || path.length === 0) {\n      continue;\n    }\n\n    resolvedPath = `${path}/${resolvedPath}`;\n    resolvedAbsolute = isAbsolute(path);\n  }\n\n  // At this point the path should be resolved to a full absolute path, but\n  // handle relative paths to be safe (might happen when process.cwd() fails)\n\n  // Normalize the path\n  resolvedPath = normalizeString(resolvedPath, !resolvedAbsolute);\n\n  if (resolvedAbsolute && !isAbsolute(resolvedPath)) {\n    return `/${resolvedPath}`;\n  }\n\n  return resolvedPath.length > 0 ? resolvedPath : \".\";\n}\n\n/**\n * Resolve the file path to an absolute path.\n *\n * @param paths - The paths to resolve\n * @returns The resolved path\n */\nexport function resolvePaths(...paths: string[]) {\n  return resolvePath(\n    joinPaths(...paths.map(path => normalizeWindowsPath(path)))\n  );\n}\n\n/**\n * Get the relative path from one file to another.\n *\n * @remarks\n * This function is similar to the `path.relative` function in Node's path module.\n *\n * @param from - The base path to start from\n * @param to - The target path to resolve relative to the base path\n * @returns The relative path from the base path to the target path\n */\nexport function relative(from: string, to: string) {\n  // we cast these because `split` will always be at least one string\n  const _from = resolve(from).replace(ROOT_FOLDER_REGEX, \"$1\").split(\"/\") as [\n    string,\n    ...string[]\n  ];\n  const _to = resolve(to).replace(ROOT_FOLDER_REGEX, \"$1\").split(\"/\") as [\n    string,\n    ...string[]\n  ];\n\n  // Different windows drive letters\n  if (_to[0][1] === \":\" && _from[0][1] === \":\" && _from[0] !== _to[0]) {\n    return _to.join(\"/\");\n  }\n\n  const _fromCopy = [..._from];\n  for (const segment of _fromCopy) {\n    if (_to[0] !== segment) {\n      break;\n    }\n    _from.shift();\n    _to.shift();\n  }\n  return [..._from.map(() => \"..\"), ..._to].join(\"/\");\n}\n\n/**\n * Get the relative path from one file to another.\n *\n * @remarks\n * This function wraps the `path.relative` function in Node's path module.\n *\n * @param from - The base path to start from\n * @param to - The target path to resolve relative to the base path\n * @param withEndSlash - Whether to include a trailing slash at the end of the path\n * @returns The relative path from the base path to the target path\n */\nexport function relativePath(from: string, to: string, withEndSlash = false) {\n  return relative(\n    withEndSlash !== true ? from.replace(/\\/$/, \"\") : from,\n    withEndSlash !== true ? to.replace(/\\/$/, \"\") : to\n  );\n}\n\n/**\n * Find the file path relative to the workspace root path.\n *\n * @param filePath - The file path to process\n * @returns The resolved file path\n */\nexport function relativeToCurrentDir(filePath: string) {\n  return relativePath(filePath, currentDir());\n}\n\n/**\n * Check if the path is a relative path.\n *\n * @param path - The path to check\n * @returns An indicator specifying if the path is a relative path\n */\nexport function parsePath(path: string) {\n  // The root of the path such as '/' or 'c:\\'\n  const root =\n    /^[/\\\\]|^[a-z]:[/\\\\]/i.exec(path)?.[0]?.replace(/\\\\/g, \"/\") || \"\";\n\n  const normalizedPath = normalizeWindowsPath(path);\n\n  const segments = normalizedPath.replace(/\\/$/, \"\").split(\"/\").slice(0, -1);\n  if (segments.length === 1 && /^[A-Z]:$/i.test(segments[0] as string)) {\n    segments[0] += \"/\";\n  }\n\n  const base = findFolderName(normalizedPath);\n  const dir = segments.join(\"/\") || (isAbsolutePath(path) ? \"/\" : \".\");\n  const ext = findFileExtensionSafe(path);\n\n  return {\n    root,\n    dir,\n    base,\n    ext,\n    name: base.slice(0, base.length - ext.length)\n  };\n}\n\n/**\n * Rename the file name with a new name.\n *\n * @param filePath - The current file path being processed\n * @param newFileName - The updated file name being processed\n * @returns The modified or unmodified file path.\n */\nexport function renameFile(filePath: string, newFileName: string): string {\n  const file = parsePath(filePath);\n\n  return joinPaths(\n    file.dir,\n    newFileName.includes(\".\") ? newFileName : newFileName + file.ext\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAuDA,SAAgB,aACd,UACA,UAA+B,EAAE,EACzB;CACR,MAAM,EAAE,mBAAmB,OAAO,gBAAgB,SAAS;CAC3D,MAAM,SACJ,qBAAqB,SAAS,EAC1B,MAAM,UAAU,SAAS,KAAK,GAAG,OAAO,IAAI,EAC5C,KAAK,IAAI;AAEf,KAAI,qBAAqB,QAAQ,CAAC,OAAO,SAAS,IAAI,CACpD,QAAO;AAGT,KAAI,kBAAkB,SAAS,OAAO,SAAS,IAAI,CACjD,QACE,OAAO,QAAQ,IAAI,kBAAkB,OAAO,IAAI,MAAM,GAAG,IAAI;AAIjE,QAAO;;;;;;;;;;;;;;;;;;AAmBT,SAAgB,aACd,UACA,UAA+B,EAAE,EACzB;CACR,MAAM,iBAAiB,qBAAqB,SAAS;CAErD,MAAM,SAAS,eAAe,QAC5B,aAAa,gBAAgB;EAAE,kBAAkB;EAAO,GAAG;EAAS,CAAC,EACrE,GACD;AAED,QAAO,WAAW,MAAM,SAAS,OAAO,QAAQ,OAAO,GAAG;;;;;;;;;;;;;;;;;AAoB5D,SAAgB,eACd,UACA,SACQ;CACR,MAAM,WAAW,aAAa,UAAU,QAAQ,CAAC,MAAM,IAAI;CAE3D,IAAI,cAAc;AAClB,MAAK,IAAI,IAAI,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK;EAC7C,MAAM,MAAM,SAAS;AACrB,MAAI,KAAK;AACP,iBAAc;AACd;;;AAWJ,QAAO,eAAe;;;;;;;;;;;;;;;;;;;;AAuBxB,SAAgB,kBAAkB,UAAsC;AACtE,KAAI,SAAS,SAAS,IAAI,IAAI,SAAS,SAAS,IAAI,CAClD;CAGF,MAAM,QAAQ,qBAAqB,KAAK,qBAAqB,SAAS,CAAC;AAEvE,QAAO,SAAS,MAAM,SAAS,KAAK,YAAY,MAAM,GAAG,GACrD,MAAM,GAAG,QAAQ,KAAK,GAAG,GACzB;;;;;;;;AA0FN,SAAgB,iBAAiB,UAA2B;AAC1D,QAAO,QAAQ,kBAAkB,SAAS,CAAC;;AA8C7C,SAAgB,QAAQ,GAAG,OAAiB;AAE1C,SAAQ,MAAM,KAAI,aAAY,qBAAqB,SAAS,CAAC;CAE7D,IAAI,eAAe;CACnB,IAAI,mBAAmB;AAEvB,MACE,IAAI,QAAQ,MAAM,SAAS,GAC3B,SAAS,MAAM,CAAC,kBAChB,SACA;EACA,MAAM,OAAO,SAAS,IAAI,MAAM,SAASA,KAAY;AAGrD,MAAI,CAAC,QAAQ,KAAK,WAAW,EAC3B;AAGF,iBAAe,GAAG,KAAK,GAAG;AAC1B,qBAAmB,WAAW,KAAK;;AAOrC,gBAAe,gBAAgB,cAAc,CAAC,iBAAiB;AAE/D,KAAI,oBAAoB,CAAC,WAAW,aAAa,CAC/C,QAAO,IAAI;AAGb,QAAO,aAAa,SAAS,IAAI,eAAe;;;;;;;;;;;;AAyBlD,SAAgB,SAAS,MAAc,IAAY;CAEjD,MAAM,QAAQ,QAAQ,KAAK,CAAC,QAAQ,mBAAmB,KAAK,CAAC,MAAM,IAAI;CAIvE,MAAM,MAAM,QAAQ,GAAG,CAAC,QAAQ,mBAAmB,KAAK,CAAC,MAAM,IAAI;AAMnE,KAAI,IAAI,GAAG,OAAO,OAAO,MAAM,GAAG,OAAO,OAAO,MAAM,OAAO,IAAI,GAC/D,QAAO,IAAI,KAAK,IAAI;CAGtB,MAAM,YAAY,CAAC,GAAG,MAAM;AAC5B,MAAK,MAAM,WAAW,WAAW;AAC/B,MAAI,IAAI,OAAO,QACb;AAEF,QAAM,OAAO;AACb,MAAI,OAAO;;AAEb,QAAO,CAAC,GAAG,MAAM,UAAU,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,IAAI;;;;;;;;;;;;;AAcrD,SAAgB,aAAa,MAAc,IAAY,eAAe,OAAO;AAC3E,QAAO,SACL,iBAAiB,OAAO,KAAK,QAAQ,OAAO,GAAG,GAAG,MAClD,iBAAiB,OAAO,GAAG,QAAQ,OAAO,GAAG,GAAG,GACjD"}

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

@@ -1 +1,32 @@
-const e=require(`./slash.cjs`);function t(t,n){let r=e.slash(t.replaceAll(/\\/g,`/`).replace(/\/*$/,``))?.toLowerCase(),i=e.slash(n.replaceAll(/\\/g,`/`).replace(/\/*$/,``))?.toLowerCase();return t!==n&&r!==i&&r.startsWith(`${i}/`)}exports.isParentPath=t;
+const require_slash = require('./slash.cjs');
+
+//#region ../path/src/is-parent-path.ts
+/**
+* Check if a given path is a parent of another path.
+*
+* @example
+* ```ts
+* isParentPath("/home/user/project/src/index.ts", "/home/user/project/src");
+* // returns true
+* isParentPath("/home/user/project/src/index.ts", "/home/user/project");
+* // returns true
+* isParentPath("/home/user/project/src/index.ts", "/home/user/project/src/other");
+* // returns false
+* isParentPath("/home/user/project/src/index.ts", "/home/user/other");
+* // returns false
+* isParentPath("/home/user/project/src/index.ts", "/home/user/project/src/index.ts");
+* // returns false
+* ```
+*
+* @param childPath - The path to check if it is a child of the parent path.
+* @param parentPath - The path to check if it is a parent of the child path.
+* @returns `true` if `childPath` is a child of `parentPath`, otherwise `false`.
+*/
+function isParentPath(childPath, parentPath) {
+	const normalizedChild = require_slash.slash(childPath.replaceAll(/\\/g, "/").replace(/\/*$/, ""))?.toLowerCase();
+	const normalizedParent = require_slash.slash(parentPath.replaceAll(/\\/g, "/").replace(/\/*$/, ""))?.toLowerCase();
+	return childPath !== parentPath && normalizedChild !== normalizedParent && normalizedChild.startsWith(`${normalizedParent}/`);
+}
+
+//#endregion
+exports.isParentPath = isParentPath;

package/dist/path/src/is-parent-path.mjs

@@ -1,2 +1,33 @@
-import{slash as e}from"./slash.mjs";function t(t,n){let r=e(t.replaceAll(/\\/g,`/`).replace(/\/*$/,``))?.toLowerCase(),i=e(n.replaceAll(/\\/g,`/`).replace(/\/*$/,``))?.toLowerCase();return t!==n&&r!==i&&r.startsWith(`${i}/`)}export{t as isParentPath};
+import { slash } from "./slash.mjs";
+
+//#region ../path/src/is-parent-path.ts
+/**
+* Check if a given path is a parent of another path.
+*
+* @example
+* ```ts
+* isParentPath("/home/user/project/src/index.ts", "/home/user/project/src");
+* // returns true
+* isParentPath("/home/user/project/src/index.ts", "/home/user/project");
+* // returns true
+* isParentPath("/home/user/project/src/index.ts", "/home/user/project/src/other");
+* // returns false
+* isParentPath("/home/user/project/src/index.ts", "/home/user/other");
+* // returns false
+* isParentPath("/home/user/project/src/index.ts", "/home/user/project/src/index.ts");
+* // returns false
+* ```
+*
+* @param childPath - The path to check if it is a child of the parent path.
+* @param parentPath - The path to check if it is a parent of the child path.
+* @returns `true` if `childPath` is a child of `parentPath`, otherwise `false`.
+*/
+function isParentPath(childPath, parentPath) {
+	const normalizedChild = slash(childPath.replaceAll(/\\/g, "/").replace(/\/*$/, ""))?.toLowerCase();
+	const normalizedParent = slash(parentPath.replaceAll(/\\/g, "/").replace(/\/*$/, ""))?.toLowerCase();
+	return childPath !== parentPath && normalizedChild !== normalizedParent && normalizedChild.startsWith(`${normalizedParent}/`);
+}
+
+//#endregion
+export { isParentPath };
 //# sourceMappingURL=is-parent-path.mjs.map

package/dist/path/src/is-parent-path.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"is-parent-path.mjs","names":[],"sources":["../../../../path/src/is-parent-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 { slash } from \"./slash\";\n\n/**\n * Check if a given path is a parent of another path.\n *\n * @example\n * ```ts\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/project/src\");\n * // returns true\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/project\");\n * // returns true\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/project/src/other\");\n * // returns false\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/other\");\n * // returns false\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/project/src/index.ts\");\n * // returns false\n * ```\n *\n * @param childPath - The path to check if it is a child of the parent path.\n * @param parentPath - The path to check if it is a parent of the child path.\n * @returns `true` if `childPath` is a child of `parentPath`, otherwise `false`.\n */\nexport function isParentPath(childPath: string, parentPath: string): boolean {\n  const normalizedChild = slash(\n    childPath.replaceAll(/\\\\/g, \"/\").replace(/\\/*$/, \"\")\n  )?.toLowerCase();\n  const normalizedParent = slash(\n    parentPath.replaceAll(/\\\\/g, \"/\").replace(/\\/*$/, \"\")\n  )?.toLowerCase();\n\n  return (\n    childPath !== parentPath &&\n    normalizedChild !== normalizedParent &&\n    normalizedChild.startsWith(`${normalizedParent}/`)\n  );\n}\n"],"mappings":"oCAyCA,SAAgB,EAAa,EAAmB,EAA6B,CAC3E,IAAM,EAAkB,EACtB,EAAU,WAAW,MAAO,IAAI,CAAC,QAAQ,OAAQ,GAAG,CACrD,EAAE,aAAa,CACV,EAAmB,EACvB,EAAW,WAAW,MAAO,IAAI,CAAC,QAAQ,OAAQ,GAAG,CACtD,EAAE,aAAa,CAEhB,OACE,IAAc,GACd,IAAoB,GACpB,EAAgB,WAAW,GAAG,EAAiB,GAAG"}
+{"version":3,"file":"is-parent-path.mjs","names":[],"sources":["../../../../path/src/is-parent-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 { slash } from \"./slash\";\n\n/**\n * Check if a given path is a parent of another path.\n *\n * @example\n * ```ts\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/project/src\");\n * // returns true\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/project\");\n * // returns true\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/project/src/other\");\n * // returns false\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/other\");\n * // returns false\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/project/src/index.ts\");\n * // returns false\n * ```\n *\n * @param childPath - The path to check if it is a child of the parent path.\n * @param parentPath - The path to check if it is a parent of the child path.\n * @returns `true` if `childPath` is a child of `parentPath`, otherwise `false`.\n */\nexport function isParentPath(childPath: string, parentPath: string): boolean {\n  const normalizedChild = slash(\n    childPath.replaceAll(/\\\\/g, \"/\").replace(/\\/*$/, \"\")\n  )?.toLowerCase();\n  const normalizedParent = slash(\n    parentPath.replaceAll(/\\\\/g, \"/\").replace(/\\/*$/, \"\")\n  )?.toLowerCase();\n\n  return (\n    childPath !== parentPath &&\n    normalizedChild !== normalizedParent &&\n    normalizedChild.startsWith(`${normalizedParent}/`)\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAyCA,SAAgB,aAAa,WAAmB,YAA6B;CAC3E,MAAM,kBAAkB,MACtB,UAAU,WAAW,OAAO,IAAI,CAAC,QAAQ,QAAQ,GAAG,CACrD,EAAE,aAAa;CAChB,MAAM,mBAAmB,MACvB,WAAW,WAAW,OAAO,IAAI,CAAC,QAAQ,QAAQ,GAAG,CACtD,EAAE,aAAa;AAEhB,QACE,cAAc,cACd,oBAAoB,oBACpB,gBAAgB,WAAW,GAAG,iBAAiB,GAAG"}

package/dist/path/src/is-root-dir.cjs

@@ -1 +1,14 @@
-function e(e){return e===`/`||e===`c:\\`||e===`C:\\`}exports.isSystemRoot=e;
+
+//#region ../path/src/is-root-dir.ts
+/**
+* Check if the directory is the current system's root directory.
+*
+* @param dir - The directory to check.
+* @returns Returns true if the directory is the root directory.
+*/
+function isSystemRoot(dir) {
+	return Boolean(dir === "/" || dir === "c:\\" || dir === "C:\\");
+}
+
+//#endregion
+exports.isSystemRoot = isSystemRoot;

package/dist/path/src/is-root-dir.mjs

@@ -1,2 +1,14 @@
-function e(e){return e===`/`||e===`c:\\`||e===`C:\\`}export{e as isSystemRoot};
+//#region ../path/src/is-root-dir.ts
+/**
+* Check if the directory is the current system's root directory.
+*
+* @param dir - The directory to check.
+* @returns Returns true if the directory is the root directory.
+*/
+function isSystemRoot(dir) {
+	return Boolean(dir === "/" || dir === "c:\\" || dir === "C:\\");
+}
+
+//#endregion
+export { isSystemRoot };
 //# sourceMappingURL=is-root-dir.mjs.map

package/dist/path/src/is-root-dir.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"is-root-dir.mjs","names":[],"sources":["../../../../path/src/is-root-dir.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 * Check if the directory is the current system's root directory.\n *\n * @param dir - The directory to check.\n * @returns Returns true if the directory is the root directory.\n */\nexport function isSystemRoot(dir: string): boolean {\n  return Boolean(dir === \"/\" || dir === \"c:\\\\\" || dir === \"C:\\\\\");\n}\n"],"mappings":"AAwBA,SAAgB,EAAa,EAAsB,CACjD,OAAe,IAAQ,KAAO,IAAQ,QAAU,IAAQ"}
+{"version":3,"file":"is-root-dir.mjs","names":[],"sources":["../../../../path/src/is-root-dir.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 * Check if the directory is the current system's root directory.\n *\n * @param dir - The directory to check.\n * @returns Returns true if the directory is the root directory.\n */\nexport function isSystemRoot(dir: string): boolean {\n  return Boolean(dir === \"/\" || dir === \"c:\\\\\" || dir === \"C:\\\\\");\n}\n"],"mappings":";;;;;;;AAwBA,SAAgB,aAAa,KAAsB;AACjD,QAAO,QAAQ,QAAQ,OAAO,QAAQ,UAAU,QAAQ,OAAO"}

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

@@ -1 +1,68 @@
-const e=require(`./regex.cjs`),t=require(`./slash.cjs`);function n(n){return e.ABSOLUTE_PATH_REGEX.test(t.slash(n))}function r(e){return n(e)}function i(n){return e.NPM_SCOPED_PACKAGE_REGEX.test(t.slash(n))}function a(e){return i(e)}exports.isAbsolute=r,exports.isAbsolutePath=n,exports.isNpmScopedPackage=a;
+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);
+}
+/**
+* Check if the path is a npm package path.
+*
+* @remarks
+* This only checks if the path matches the npm namespace scoped package naming convention such as `@scope/package-name`. This is an alias for {@link isNpmScopedPackage}.
+*
+* @example
+* ```ts
+* isNpmScopedPackage("@stryke/path"); // returns true
+* isNpmScopedPackage("lodash"); // returns false
+* isNpmNamespacePackage("./src/index.ts"); // returns false
+* ```
+*
+* @param path - The path to check
+* @returns An indicator specifying if the path is a npm package path
+*/
+function isNpmScopedPackagePath(path) {
+	return require_regex.NPM_SCOPED_PACKAGE_REGEX.test(require_slash.slash(path));
+}
+/**
+* Check if the path is a npm package path.
+*
+* @remarks
+* This only checks if the path matches the npm namespace scoped package naming convention such as `@scope/package-name`. This is an alias for {@link isNpmScopedPackagePath}.
+*
+* @example
+* ```ts
+* isNpmScopedPackagePath("@stryke/path"); // returns true
+* isNpmScopedPackagePath("lodash"); // returns false
+* isNpmScopedPackagePath("./src/index.ts"); // returns false
+* ```
+*
+* @param path - The path to check
+* @returns An indicator specifying if the path is a npm package path
+*/
+function isNpmScopedPackage(path) {
+	return isNpmScopedPackagePath(path);
+}
+
+//#endregion
+exports.isAbsolute = isAbsolute;
+exports.isAbsolutePath = isAbsolutePath;
+exports.isNpmScopedPackage = isNpmScopedPackage;

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

@@ -1,2 +1,67 @@
-import{ABSOLUTE_PATH_REGEX as e,NPM_SCOPED_PACKAGE_REGEX as t}from"./regex.mjs";import{slash as n}from"./slash.mjs";function r(t){return e.test(n(t))}function i(e){return r(e)}function a(e){return t.test(n(e))}function o(e){return a(e)}export{i as isAbsolute,r as isAbsolutePath,o as isNpmScopedPackage};
+import { ABSOLUTE_PATH_REGEX, NPM_SCOPED_PACKAGE_REGEX } from "./regex.mjs";
+import { slash } from "./slash.mjs";
+
+//#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 ABSOLUTE_PATH_REGEX.test(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);
+}
+/**
+* Check if the path is a npm package path.
+*
+* @remarks
+* This only checks if the path matches the npm namespace scoped package naming convention such as `@scope/package-name`. This is an alias for {@link isNpmScopedPackage}.
+*
+* @example
+* ```ts
+* isNpmScopedPackage("@stryke/path"); // returns true
+* isNpmScopedPackage("lodash"); // returns false
+* isNpmNamespacePackage("./src/index.ts"); // returns false
+* ```
+*
+* @param path - The path to check
+* @returns An indicator specifying if the path is a npm package path
+*/
+function isNpmScopedPackagePath(path) {
+	return NPM_SCOPED_PACKAGE_REGEX.test(slash(path));
+}
+/**
+* Check if the path is a npm package path.
+*
+* @remarks
+* This only checks if the path matches the npm namespace scoped package naming convention such as `@scope/package-name`. This is an alias for {@link isNpmScopedPackagePath}.
+*
+* @example
+* ```ts
+* isNpmScopedPackagePath("@stryke/path"); // returns true
+* isNpmScopedPackagePath("lodash"); // returns false
+* isNpmScopedPackagePath("./src/index.ts"); // returns false
+* ```
+*
+* @param path - The path to check
+* @returns An indicator specifying if the path is a npm package path
+*/
+function isNpmScopedPackage(path) {
+	return isNpmScopedPackagePath(path);
+}
+
+//#endregion
+export { isAbsolute, isAbsolutePath, isNpmScopedPackage };
 //# sourceMappingURL=is-type.mjs.map

package/dist/path/src/is-type.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"is-type.mjs","names":[],"sources":["../../../../path/src/is-type.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 { ABSOLUTE_PATH_REGEX, NPM_SCOPED_PACKAGE_REGEX } from \"./regex\";\nimport { slash } from \"./slash\";\n\n/**\n * Check if the path is an absolute path.\n *\n * @param path - The path to check\n * @returns An indicator specifying if the path is an absolute path\n */\nexport function isAbsolutePath(path: string): boolean {\n  return ABSOLUTE_PATH_REGEX.test(slash(path));\n}\n\n/**\n * Check if the path is an absolute path.\n *\n * @remarks\n * This is an alias for {@link isAbsolutePath}.\n *\n * @param path - The path to check\n * @returns An indicator specifying if the path is an absolute path\n */\nexport function isAbsolute(path: string): boolean {\n  return isAbsolutePath(path);\n}\n\n/**\n * Check if the path is a relative path.\n *\n * @param path - The path to check\n * @returns An indicator specifying if the path is a relative path\n */\nexport function isRelativePath(path: string): boolean {\n  return !isAbsolutePath(path);\n}\n\n/**\n * Check if the path is a relative path.\n *\n * @remarks\n * This is an alias for {@link isRelativePath}.\n *\n * @param path - The path to check\n * @returns An indicator specifying if the path is a relative path\n */\nexport function isRelative(path: string): boolean {\n  return isRelativePath(path);\n}\n\n/**\n * Check if the path is a npm package path.\n *\n * @remarks\n * This only checks if the path matches the npm namespace scoped package naming convention such as `@scope/package-name`. This is an alias for {@link isNpmScopedPackage}.\n *\n * @example\n * ```ts\n * isNpmScopedPackage(\"@stryke/path\"); // returns true\n * isNpmScopedPackage(\"lodash\"); // returns false\n * isNpmNamespacePackage(\"./src/index.ts\"); // returns false\n * ```\n *\n * @param path - The path to check\n * @returns An indicator specifying if the path is a npm package path\n */\nexport function isNpmScopedPackagePath(path: string): boolean {\n  return NPM_SCOPED_PACKAGE_REGEX.test(slash(path));\n}\n\n/**\n * Check if the path is a npm package path.\n *\n * @remarks\n * This only checks if the path matches the npm namespace scoped package naming convention such as `@scope/package-name`. This is an alias for {@link isNpmScopedPackagePath}.\n *\n * @example\n * ```ts\n * isNpmScopedPackagePath(\"@stryke/path\"); // returns true\n * isNpmScopedPackagePath(\"lodash\"); // returns false\n * isNpmScopedPackagePath(\"./src/index.ts\"); // returns false\n * ```\n *\n * @param path - The path to check\n * @returns An indicator specifying if the path is a npm package path\n */\nexport function isNpmScopedPackage(path: string): boolean {\n  return isNpmScopedPackagePath(path);\n}\n"],"mappings":"oHA2BA,SAAgB,EAAe,EAAuB,CACpD,OAAO,EAAoB,KAAK,EAAM,EAAK,CAAC,CAY9C,SAAgB,EAAW,EAAuB,CAChD,OAAO,EAAe,EAAK,CA0C7B,SAAgB,EAAuB,EAAuB,CAC5D,OAAO,EAAyB,KAAK,EAAM,EAAK,CAAC,CAmBnD,SAAgB,EAAmB,EAAuB,CACxD,OAAO,EAAuB,EAAK"}
+{"version":3,"file":"is-type.mjs","names":[],"sources":["../../../../path/src/is-type.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 { ABSOLUTE_PATH_REGEX, NPM_SCOPED_PACKAGE_REGEX } from \"./regex\";\nimport { slash } from \"./slash\";\n\n/**\n * Check if the path is an absolute path.\n *\n * @param path - The path to check\n * @returns An indicator specifying if the path is an absolute path\n */\nexport function isAbsolutePath(path: string): boolean {\n  return ABSOLUTE_PATH_REGEX.test(slash(path));\n}\n\n/**\n * Check if the path is an absolute path.\n *\n * @remarks\n * This is an alias for {@link isAbsolutePath}.\n *\n * @param path - The path to check\n * @returns An indicator specifying if the path is an absolute path\n */\nexport function isAbsolute(path: string): boolean {\n  return isAbsolutePath(path);\n}\n\n/**\n * Check if the path is a relative path.\n *\n * @param path - The path to check\n * @returns An indicator specifying if the path is a relative path\n */\nexport function isRelativePath(path: string): boolean {\n  return !isAbsolutePath(path);\n}\n\n/**\n * Check if the path is a relative path.\n *\n * @remarks\n * This is an alias for {@link isRelativePath}.\n *\n * @param path - The path to check\n * @returns An indicator specifying if the path is a relative path\n */\nexport function isRelative(path: string): boolean {\n  return isRelativePath(path);\n}\n\n/**\n * Check if the path is a npm package path.\n *\n * @remarks\n * This only checks if the path matches the npm namespace scoped package naming convention such as `@scope/package-name`. This is an alias for {@link isNpmScopedPackage}.\n *\n * @example\n * ```ts\n * isNpmScopedPackage(\"@stryke/path\"); // returns true\n * isNpmScopedPackage(\"lodash\"); // returns false\n * isNpmNamespacePackage(\"./src/index.ts\"); // returns false\n * ```\n *\n * @param path - The path to check\n * @returns An indicator specifying if the path is a npm package path\n */\nexport function isNpmScopedPackagePath(path: string): boolean {\n  return NPM_SCOPED_PACKAGE_REGEX.test(slash(path));\n}\n\n/**\n * Check if the path is a npm package path.\n *\n * @remarks\n * This only checks if the path matches the npm namespace scoped package naming convention such as `@scope/package-name`. This is an alias for {@link isNpmScopedPackagePath}.\n *\n * @example\n * ```ts\n * isNpmScopedPackagePath(\"@stryke/path\"); // returns true\n * isNpmScopedPackagePath(\"lodash\"); // returns false\n * isNpmScopedPackagePath(\"./src/index.ts\"); // returns false\n * ```\n *\n * @param path - The path to check\n * @returns An indicator specifying if the path is a npm package path\n */\nexport function isNpmScopedPackage(path: string): boolean {\n  return isNpmScopedPackagePath(path);\n}\n"],"mappings":";;;;;;;;;;AA2BA,SAAgB,eAAe,MAAuB;AACpD,QAAO,oBAAoB,KAAK,MAAM,KAAK,CAAC;;;;;;;;;;;AAY9C,SAAgB,WAAW,MAAuB;AAChD,QAAO,eAAe,KAAK;;;;;;;;;;;;;;;;;;AA0C7B,SAAgB,uBAAuB,MAAuB;AAC5D,QAAO,yBAAyB,KAAK,MAAM,KAAK,CAAC;;;;;;;;;;;;;;;;;;AAmBnD,SAAgB,mBAAmB,MAAuB;AACxD,QAAO,uBAAuB,KAAK"}