@stryke/path 0.22.0 → 0.22.8

package/dist/cwd.d.cts

@@ -0,0 +1,2 @@
+import { t as cwd } from "./cwd-Bt4NcS-v.cjs";
+export { cwd };

package/dist/cwd.d.mts

@@ -0,0 +1,2 @@
+import { t as cwd } from "./cwd-Dx53cgUn.mjs";
+export { cwd };

package/dist/cwd.mjs

@@ -1 +1 @@
-export function cwd(){return typeof process<"u"&&typeof process.cwd=="function"?process.cwd().replace(/\\/g,"/"):"/"}
+import{t as e}from"./cwd-DxrPG9WB.mjs";export{e as cwd};

package/dist/delimiter-B3nWo9Xn.mjs

@@ -0,0 +1,2 @@
+const e=(()=>process?.platform===`win32`?`;`:`:`)(),t={posix:void 0,win32:void 0},n=(n=e)=>new Proxy({},{get(e,a){return a===`delimiter`?n:a===`posix`?r:a===`win32`?i:t[a]}}),r=n(`:`),i=n(`;`);export{r as n,i as r,e as t};
+//# sourceMappingURL=delimiter-B3nWo9Xn.mjs.map

package/dist/delimiter-B3nWo9Xn.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"delimiter-B3nWo9Xn.mjs","names":["delimiter: \";\" | \":\""],"sources":["../src/delimiter.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 * The platform-specific file delimiter.\n *\n * Equals to `\";\"` in windows and `\":\"` in all other platforms.\n */\nexport const delimiter: \";\" | \":\" = /* @__PURE__ */ (() =>\n  process?.platform === \"win32\" ? \";\" : \":\")();\n\n// Mix namespaces without side-effects of object to allow tree-shaking\n\nconst platforms = {\n  posix: undefined,\n  win32: undefined\n} as unknown as {\n  posix: any;\n  win32: any;\n};\n\nconst mix = (del: \";\" | \":\" = delimiter) => {\n  return new Proxy(\n    {},\n    {\n      get(_, prop) {\n        if (prop === \"delimiter\") {\n          return del;\n        }\n        if (prop === \"posix\") {\n          // eslint-disable-next-line ts/no-use-before-define\n          return posix;\n        }\n        if (prop === \"win32\") {\n          // eslint-disable-next-line ts/no-use-before-define\n          return win32;\n        }\n        return platforms[prop as keyof typeof platforms];\n      }\n    }\n  ) as unknown as typeof platforms & { delimiter: typeof del };\n};\n\nexport const posix = /* @__PURE__ */ mix(\":\");\n\nexport const win32 = /* @__PURE__ */ mix(\";\");\n"],"mappings":"AAuBA,MAAaA,OACX,SAAS,WAAa,QAAU,IAAM,MAAM,CAIxC,EAAY,CAChB,MAAO,IAAA,GACP,MAAO,IAAA,GACR,CAKK,GAAO,EAAiB,IACrB,IAAI,MACT,EAAE,CACF,CACE,IAAI,EAAG,EAAM,CAYX,OAXI,IAAS,YACJ,EAEL,IAAS,QAEJ,EAEL,IAAS,QAEJ,EAEF,EAAU,IAEpB,CACF,CAGU,EAAwB,EAAI,IAAI,CAEhC,EAAwB,EAAI,IAAI"}

package/dist/delimiter-BwyCEwu9.d.cts

@@ -0,0 +1,22 @@
+//#region src/delimiter.d.ts
+/**
+ * The platform-specific file delimiter.
+ *
+ * Equals to `";"` in windows and `":"` in all other platforms.
+ */
+declare const delimiter: ";" | ":";
+declare const posix: {
+  posix: any;
+  win32: any;
+} & {
+  delimiter: ";" | ":";
+};
+declare const win32: {
+  posix: any;
+  win32: any;
+} & {
+  delimiter: ";" | ":";
+};
+//#endregion
+export { posix as n, win32 as r, delimiter as t };
+//# sourceMappingURL=delimiter-BwyCEwu9.d.cts.map

package/dist/delimiter-BwyCEwu9.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delimiter-BwyCEwu9.d.cts","names":[],"sources":["../src/delimiter.ts"],"sourcesContent":[],"mappings":";;AAuBA;AAmCA;AAEA;;cArCa;cAmCA;;;;;;cAEA"}

package/dist/delimiter-DuDX7fvN.d.mts

@@ -0,0 +1,22 @@
+//#region src/delimiter.d.ts
+/**
+ * The platform-specific file delimiter.
+ *
+ * Equals to `";"` in windows and `":"` in all other platforms.
+ */
+declare const delimiter: ";" | ":";
+declare const posix: {
+  posix: any;
+  win32: any;
+} & {
+  delimiter: ";" | ":";
+};
+declare const win32: {
+  posix: any;
+  win32: any;
+} & {
+  delimiter: ";" | ":";
+};
+//#endregion
+export { posix as n, win32 as r, delimiter as t };
+//# sourceMappingURL=delimiter-DuDX7fvN.d.mts.map

package/dist/delimiter-DuDX7fvN.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delimiter-DuDX7fvN.d.mts","names":[],"sources":["../src/delimiter.ts"],"sourcesContent":[],"mappings":";;AAuBA;AAmCA;AAEA;;cArCa;cAmCA;;;;;;cAEA"}

package/dist/delimiter-IA9U4fxC.cjs

@@ -0,0 +1 @@
+const e=(()=>process?.platform===`win32`?`;`:`:`)(),t={posix:void 0,win32:void 0},n=(n=e)=>new Proxy({},{get(e,a){return a===`delimiter`?n:a===`posix`?r:a===`win32`?i:t[a]}}),r=n(`:`),i=n(`;`);Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return e}});

package/dist/delimiter.cjs

@@ -1,18 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.win32 = exports.posix = exports.delimiter = void 0;
-const delimiter = exports.delimiter = process?.platform === "win32" ? ";" : ":";
-const i = {
-    posix: void 0,
-    win32: void 0
-  },
-  e = (t = delimiter) => new Proxy({}, {
-    get(o, n) {
-      return n === "delimiter" ? t : n === "posix" ? posix : n === "win32" ? win32 : i[n];
-    }
-  });
-const posix = exports.posix = e(":"),
-  win32 = exports.win32 = e(";");
+const e=require(`./delimiter-IA9U4fxC.cjs`);exports.delimiter=e.t,exports.posix=e.n,exports.win32=e.r;

package/dist/delimiter.d.cts

@@ -0,0 +1,2 @@
+import { n as posix, r as win32, t as delimiter } from "./delimiter-BwyCEwu9.cjs";
+export { delimiter, posix, win32 };

package/dist/delimiter.d.mts

@@ -0,0 +1,2 @@
+import { n as posix, r as win32, t as delimiter } from "./delimiter-DuDX7fvN.mjs";
+export { delimiter, posix, win32 };

package/dist/delimiter.mjs

@@ -1 +1 @@
-export const delimiter=process?.platform==="win32"?";":":";const i={posix:void 0,win32:void 0},e=(t=delimiter)=>new Proxy({},{get(o,n){return n==="delimiter"?t:n==="posix"?posix:n==="win32"?win32:i[n]}});export const posix=e(":"),win32=e(";");
+import{n as e,r as t,t as n}from"./delimiter-B3nWo9Xn.mjs";export{n as delimiter,e as posix,t as win32};

package/dist/file-path-fns-B9hKjfA-.cjs

@@ -0,0 +1 @@
+const e=require(`./cwd-D66SsPHE.cjs`),t=require(`./regex-BEjSq2wo.cjs`),n=require(`./slash-DhzW1Om-.cjs`),r=require(`./join-paths-hCBPtGlC.cjs`),i=require(`./correct-path-B0Y_kOkW.cjs`),a=e=>{try{return e===null}catch{return!1}},o=e=>e===void 0,s=e=>{try{return o(e)||a(e)}catch{return!1}},c=e=>{try{return!s(e)}catch{return!1}},l=e=>{try{return typeof e==`string`}catch{return!1}},u=e=>{try{return c(e)&&l(e)&&e.length>0}catch{return!1}},d=``;function f(e,t={}){let{requireExtension:n=!1,withExtension:r=!0}=t,a=i.r(e)?.split(e?.includes(`\\`)?`\\`:`/`)?.pop()??``;return n===!0&&!a.includes(`.`)?``:r===!1&&a.includes(`.`)?a.replace(`.${_(a)??``}`,``)||``:a}function p(e,t={}){let n=i.r(e),r=n.replace(f(n,{requireExtension:!1,...t}),``);return r===`/`?r:r.replace(/\/$/,``)}const m=p;function h(e,t){let n=p(e,t).split(`/`),r=``;for(let e=n.length-1;e>=0;e--){let t=n[e];if(t){r=t;break}}return r??``}const g=h;function _(e){if(e.endsWith(`.`)||e.endsWith(`/`))return;let n=t.i.exec(i.r(e));return n&&n.length>0&&u(n[0])?n[0].replace(`.`,``):void 0}const v=_;function y(e){let t=_(e);return t?`.${t}`:void 0}function b(e){return _(e)??``}function x(e){let t=_(e);return t?`.${t}`:``}function S(e){return!!f(e)}function C(e){return!!p(e)}function w(e){return!!h(e)}function T(e){return!!_(e)}function E(t,a=e.t()){let o=i.r(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.n(t,s),c=n.i(t))}return s=i.n(s,!c),c&&!n.i(s)?`/${s}`:s.length>0?s:`.`}function D(...t){t=t.map(e=>i.r(e));let r=``,a=!1;for(let i=t.length-1;i>=-1&&!a;i--){let o=i>=0?t[i]:e.t();!o||o.length===0||(r=`${o}/${r}`,a=n.r(o))}return r=i.n(r,!a),a&&!n.r(r)?`/${r}`:r.length>0?r:`.`}function O(...e){return E(r.n(...e.map(e=>i.r(e))))}function k(e,n){let r=D(e).replace(t.s,`$1`).split(`/`),i=D(n).replace(t.s,`$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 A(e,t,n=!1){return k(n===!0?e:e.replace(/\/$/,``),n===!0?t:t.replace(/\/$/,``))}function j(t){return A(t,e.t())}function M(e){let t=/^[/\\]|^[a-z]:[/\\]/i.exec(e)?.[0]?.replace(/\\/g,`/`)||``,r=i.r(e),a=r.replace(/\/$/,``).split(`/`).slice(0,-1);a.length===1&&/^[A-Z]:$/i.test(a[0])&&(a[0]+=`/`);let o=h(r),s=a.join(`/`)||(n.i(e)?`/`:`.`),c=b(e);return{root:t,dir:s,base:o,ext:c,name:o.slice(0,o.length-c.length)}}function N(e,t){let n=M(e);return r.n(n.dir,t.includes(`.`)?t:t+n.ext)}Object.defineProperty(exports,`S`,{enumerable:!0,get:function(){return O}}),Object.defineProperty(exports,`_`,{enumerable:!0,get:function(){return A}}),Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return x}}),Object.defineProperty(exports,`b`,{enumerable:!0,get:function(){return D}}),Object.defineProperty(exports,`c`,{enumerable:!0,get:function(){return f}}),Object.defineProperty(exports,`d`,{enumerable:!0,get:function(){return T}}),Object.defineProperty(exports,`f`,{enumerable:!0,get:function(){return S}}),Object.defineProperty(exports,`g`,{enumerable:!0,get:function(){return k}}),Object.defineProperty(exports,`h`,{enumerable:!0,get:function(){return M}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,`l`,{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,`m`,{enumerable:!0,get:function(){return w}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,`p`,{enumerable:!0,get:function(){return C}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return b}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,`u`,{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,`v`,{enumerable:!0,get:function(){return j}}),Object.defineProperty(exports,`x`,{enumerable:!0,get:function(){return E}}),Object.defineProperty(exports,`y`,{enumerable:!0,get:function(){return N}});

package/dist/{file-path-fns.d.ts → file-path-fns-BKbfZRTB.d.mts}

@@ -1,16 +1,17 @@
-export interface FindFileNameOptions {
-    /**
-     * Require the file extension to be present in the file name.
-     *
-     * @defaultValue false
-     */
-    requireExtension?: boolean;
-    /**
-     * Return the file extension as part of the full file name result.
-     *
-     * @defaultValue true
-     */
-    withExtension?: boolean;
+//#region src/file-path-fns.d.ts
+interface FindFileNameOptions {
+  /**
+   * Require the file extension to be present in the file name.
+   *
+   * @defaultValue false
+   */
+  requireExtension?: boolean;
+  /**
+   * Return the file extension as part of the full file name result.
+   *
+   * @defaultValue true
+   */
+  withExtension?: boolean;
 }
 /**
  * Find the file name from a file path.
@@ -25,7 +26,7 @@ export interface FindFileNameOptions {
  * @param options - Options to control the file name extraction
  * @returns The file name
  */
-export declare function findFileName(filePath: string, options?: FindFileNameOptions): string;
+declare function findFileName(filePath: string, options?: FindFileNameOptions): string;
 /**
  * Find the full file path's directories from a file path.
  *
@@ -42,8 +43,8 @@ export declare function findFileName(filePath: string, options?: FindFileNameOpt
  * @param options - Options to control the file name extraction
  * @returns The full file path's directories
  */
-export declare function findFilePath(filePath: string, options?: FindFileNameOptions): string;
-export declare const dirname: typeof findFilePath;
+declare function findFilePath(filePath: string, options?: FindFileNameOptions): string;
+declare const dirname: typeof findFilePath;
 /**
  * Find the top most folder containing the file from a file path.
  *
@@ -59,8 +60,8 @@ export declare const dirname: typeof findFilePath;
  * @param options - Options to control the file name extraction
  * @returns The folder containing the file
  */
-export declare function findFolderName(filePath: string, options?: FindFileNameOptions): string;
-export declare const basename: typeof findFolderName;
+declare function findFolderName(filePath: string, options?: FindFileNameOptions): string;
+declare const basename: typeof findFolderName;
 /**
  * Find the file extension from a file path.
  *
@@ -79,8 +80,8 @@ export declare const basename: typeof findFolderName;
  * @param filePath - The file path to process
  * @returns The file extension or undefined if no extension is found
  */
-export declare function findFileExtension(filePath: string): string | undefined;
-export declare const extname: typeof findFileExtension;
+declare function findFileExtension(filePath: string): string | undefined;
+declare const extname: typeof findFileExtension;
 /**
  * Find the file extension including the `"."` character prefix from a file path.
  *
@@ -92,7 +93,7 @@ export declare const extname: typeof findFileExtension;
  * @param filePath - The file path to process
  * @returns The file extension (including the `"."` prefix) or undefined if no extension is found
  */
-export declare function findFileDotExtension(filePath: string): string | undefined;
+declare function findFileDotExtension(filePath: string): string | undefined;
 /**
  * Find the file extension from a file path or an empty string.
  *
@@ -104,7 +105,7 @@ export declare function findFileDotExtension(filePath: string): string | undefin
  * @param filePath - The file path to process
  * @returns The file extension or an empty string if no extension is found
  */
-export declare function findFileExtensionSafe(filePath: string): string;
+declare function findFileExtensionSafe(filePath: string): string;
 /**
  * Find the file extension including the `"."` character prefix from a file path or an empty string.
  *
@@ -116,35 +117,35 @@ export declare function findFileExtensionSafe(filePath: string): string;
  * @param filePath - The file path to process
  * @returns The file extension (including the `"."` prefix) or an empty string if no extension is found
  */
-export declare function findFileDotExtensionSafe(filePath: string): string;
+declare function findFileDotExtensionSafe(filePath: string): string;
 /**
  * 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
  */
-export declare function hasFileName(filePath: string): boolean;
+declare function hasFileName(filePath: string): boolean;
 /**
  * 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
  */
-export declare function hasFilePath(filePath: string): boolean;
+declare function hasFilePath(filePath: string): boolean;
 /**
  * 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
  */
-export declare function hasFolderName(filePath: string): boolean;
+declare function hasFolderName(filePath: string): boolean;
 /**
  * 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
  */
-export declare function hasFileExtension(filePath: string): boolean;
+declare function hasFileExtension(filePath: string): boolean;
 /**
  * Resolve the file path to an absolute path.
  *
@@ -152,15 +153,15 @@ export declare function hasFileExtension(filePath: string): boolean;
  * @param cwd - The current working directory
  * @returns The resolved path
  */
-export declare function resolvePath(path: string, cwd?: string): string;
-export declare function resolve(...paths: string[]): string;
+declare function resolvePath(path: string, cwd?: string): string;
+declare function resolve(...paths: string[]): string;
 /**
  * Resolve the file path to an absolute path.
  *
  * @param paths - The paths to resolve
  * @returns The resolved path
  */
-export declare function resolvePaths(...paths: string[]): string;
+declare function resolvePaths(...paths: string[]): string;
 /**
  * Get the relative path from one file to another.
  *
@@ -171,7 +172,7 @@ export declare function resolvePaths(...paths: string[]): string;
  * @param to - The target path to resolve relative to the base path
  * @returns The relative path from the base path to the target path
  */
-export declare function relative(from: string, to: string): string;
+declare function relative(from: string, to: string): string;
 /**
  * Get the relative path from one file to another.
  *
@@ -183,26 +184,26 @@ export declare function relative(from: string, to: string): string;
  * @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
  */
-export declare function relativePath(from: string, to: string, withEndSlash?: boolean): string;
+declare function relativePath(from: string, to: string, withEndSlash?: boolean): string;
 /**
  * Find the file path relative to the workspace root path.
  *
  * @param filePath - The file path to process
  * @returns The resolved file path
  */
-export declare function relativeToCurrentDir(filePath: string): string;
+declare function relativeToCurrentDir(filePath: string): string;
 /**
  * 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
  */
-export declare function parsePath(path: string): {
-    root: string;
-    dir: string;
-    base: string;
-    ext: string;
-    name: string;
+declare function parsePath(path: string): {
+  root: string;
+  dir: string;
+  base: string;
+  ext: string;
+  name: string;
 };
 /**
  * Rename the file name with a new name.
@@ -211,4 +212,7 @@ export declare function parsePath(path: string): {
  * @param newFileName - The updated file name being processed
  * @returns The modified or unmodified file path.
  */
-export declare function renameFile(filePath: string, newFileName: string): string;
+declare function renameFile(filePath: string, newFileName: string): string;
+//#endregion
+export { resolvePaths as C, resolvePath as S, relative as _, findFileDotExtension as a, renameFile as b, findFileExtensionSafe as c, findFolderName as d, hasFileExtension as f, parsePath as g, hasFolderName as h, extname as i, findFileName as l, hasFilePath as m, basename as n, findFileDotExtensionSafe as o, hasFileName as p, dirname as r, findFileExtension as s, FindFileNameOptions as t, findFilePath as u, relativePath as v, resolve as x, relativeToCurrentDir as y };
+//# sourceMappingURL=file-path-fns-BKbfZRTB.d.mts.map

package/dist/file-path-fns-BKbfZRTB.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-path-fns-BKbfZRTB.d.mts","names":[],"sources":["../src/file-path-fns.ts"],"sourcesContent":[],"mappings":";UA0BiB,mBAAA;EAAA;AA6BjB;AAuCA;AAcA;AAiBA;EAyBa,gBAAyB,CAAA,EAAA,OAAjB;EAoBL;AAYhB;AAaA;AAiBA;AAeA;EAYgB,aAAA,CAAW,EAAA,OAAA;AAU3B;AAUA;AAUA;AAWA;AAoCA;AA0CA;AAgBA;AAsCA;AAaA;AAUA;AAgCA;;;;iBA5ZgB,YAAA,6BAEL;;;;;;;;;;;;;;;;;iBAqCK,YAAA,6BAEL;cAYE,gBAAO;;;;;;;;;;;;;;;;iBAiBJ,cAAA,6BAEJ;cAuBC,iBAAQ;;;;;;;;;;;;;;;;;;;iBAoBL,iBAAA;cAYH,gBAAO;;;;;;;;;;;;iBAaJ,oBAAA;;;;;;;;;;;;iBAiBA,qBAAA;;;;;;;;;;;;iBAeA,wBAAA;;;;;;;iBAYA,WAAA;;;;;;;iBAUA,WAAA;;;;;;;iBAUA,aAAA;;;;;;;iBAUA,gBAAA;;;;;;;;iBAWA,WAAA;iBAoCA,OAAA;;;;;;;iBA0CA,YAAA;;;;;;;;;;;iBAgBA,QAAA;;;;;;;;;;;;iBAsCA,YAAA;;;;;;;iBAaA,oBAAA;;;;;;;iBAUA,SAAA;;;;;;;;;;;;;;iBAgCA,UAAA"}

package/dist/file-path-fns-CTLJP4j9.d.cts

@@ -0,0 +1,218 @@
+//#region src/file-path-fns.d.ts
+interface FindFileNameOptions {
+  /**
+   * Require the file extension to be present in the file name.
+   *
+   * @defaultValue false
+   */
+  requireExtension?: boolean;
+  /**
+   * Return the file extension as part of the full file name result.
+   *
+   * @defaultValue true
+   */
+  withExtension?: boolean;
+}
+/**
+ * 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
+ */
+declare function findFileName(filePath: string, options?: FindFileNameOptions): string;
+/**
+ * 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
+ */
+declare function findFilePath(filePath: string, options?: FindFileNameOptions): string;
+declare const dirname: typeof 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
+ */
+declare function findFolderName(filePath: string, options?: FindFileNameOptions): string;
+declare const basename: typeof 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
+ */
+declare function findFileExtension(filePath: string): string | undefined;
+declare const extname: typeof 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
+ */
+declare function findFileDotExtension(filePath: string): string | undefined;
+/**
+ * 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
+ */
+declare function findFileExtensionSafe(filePath: string): 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
+ */
+declare function findFileDotExtensionSafe(filePath: string): string;
+/**
+ * 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
+ */
+declare function hasFileName(filePath: string): boolean;
+/**
+ * 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
+ */
+declare function hasFilePath(filePath: string): boolean;
+/**
+ * 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
+ */
+declare function hasFolderName(filePath: string): boolean;
+/**
+ * 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
+ */
+declare function hasFileExtension(filePath: string): boolean;
+/**
+ * Resolve the file path to an absolute path.
+ *
+ * @param path - The path to resolve
+ * @param cwd - The current working directory
+ * @returns The resolved path
+ */
+declare function resolvePath(path: string, cwd?: string): string;
+declare function resolve(...paths: string[]): string;
+/**
+ * Resolve the file path to an absolute path.
+ *
+ * @param paths - The paths to resolve
+ * @returns The resolved path
+ */
+declare function resolvePaths(...paths: string[]): string;
+/**
+ * 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
+ */
+declare function relative(from: string, to: string): string;
+/**
+ * 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
+ */
+declare function relativePath(from: string, to: string, withEndSlash?: boolean): string;
+/**
+ * Find the file path relative to the workspace root path.
+ *
+ * @param filePath - The file path to process
+ * @returns The resolved file path
+ */
+declare function relativeToCurrentDir(filePath: string): string;
+/**
+ * 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
+ */
+declare function parsePath(path: string): {
+  root: string;
+  dir: string;
+  base: string;
+  ext: string;
+  name: string;
+};
+/**
+ * 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.
+ */
+declare function renameFile(filePath: string, newFileName: string): string;
+//#endregion
+export { resolvePaths as C, resolvePath as S, relative as _, findFileDotExtension as a, renameFile as b, findFileExtensionSafe as c, findFolderName as d, hasFileExtension as f, parsePath as g, hasFolderName as h, extname as i, findFileName as l, hasFilePath as m, basename as n, findFileDotExtensionSafe as o, hasFileName as p, dirname as r, findFileExtension as s, FindFileNameOptions as t, findFilePath as u, relativePath as v, resolve as x, relativeToCurrentDir as y };
+//# sourceMappingURL=file-path-fns-CTLJP4j9.d.cts.map

package/dist/file-path-fns-CTLJP4j9.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-path-fns-CTLJP4j9.d.cts","names":[],"sources":["../src/file-path-fns.ts"],"sourcesContent":[],"mappings":";UA0BiB,mBAAA;EAAA;AA6BjB;AAuCA;AAcA;AAiBA;EAyBa,gBAAyB,CAAA,EAAA,OAAjB;EAoBL;AAYhB;AAaA;AAiBA;AAeA;EAYgB,aAAA,CAAW,EAAA,OAAA;AAU3B;AAUA;AAUA;AAWA;AAoCA;AA0CA;AAgBA;AAsCA;AAaA;AAUA;AAgCA;;;;iBA5ZgB,YAAA,6BAEL;;;;;;;;;;;;;;;;;iBAqCK,YAAA,6BAEL;cAYE,gBAAO;;;;;;;;;;;;;;;;iBAiBJ,cAAA,6BAEJ;cAuBC,iBAAQ;;;;;;;;;;;;;;;;;;;iBAoBL,iBAAA;cAYH,gBAAO;;;;;;;;;;;;iBAaJ,oBAAA;;;;;;;;;;;;iBAiBA,qBAAA;;;;;;;;;;;;iBAeA,wBAAA;;;;;;;iBAYA,WAAA;;;;;;;iBAUA,WAAA;;;;;;;iBAUA,aAAA;;;;;;;iBAUA,gBAAA;;;;;;;;iBAWA,WAAA;iBAoCA,OAAA;;;;;;;iBA0CA,YAAA;;;;;;;;;;;iBAgBA,QAAA;;;;;;;;;;;;iBAsCA,YAAA;;;;;;;iBAaA,oBAAA;;;;;;;iBAUA,SAAA;;;;;;;;;;;;;;iBAgCA,UAAA"}

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

@@ -0,0 +1,2 @@
+import{t as e}from"./cwd-DxrPG9WB.mjs";import{i as t,s as n}from"./regex-hMUNHeGK.mjs";import{i as r,r as i}from"./slash-C7xRDucF.mjs";import{n as a}from"./join-paths-BLjJ0GmK.mjs";import{n as o,r as s}from"./correct-path-DmaZHNUF.mjs";const c=e=>{try{return e===null}catch{return!1}},l=e=>e===void 0,u=e=>{try{return l(e)||c(e)}catch{return!1}},d=e=>{try{return!u(e)}catch{return!1}},f=e=>{try{return typeof e==`string`}catch{return!1}},p=e=>{try{return d(e)&&f(e)&&e.length>0}catch{return!1}};function m(e,t={}){let{requireExtension:n=!1,withExtension:r=!0}=t,i=s(e)?.split(e?.includes(`\\`)?`\\`:`/`)?.pop()??``;return n===!0&&!i.includes(`.`)?``:r===!1&&i.includes(`.`)?i.replace(`.${y(i)??``}`,``)||``:i}function h(e,t={}){let n=s(e),r=n.replace(m(n,{requireExtension:!1,...t}),``);return r===`/`?r:r.replace(/\/$/,``)}const g=h;function _(e,t){let n=h(e,t).split(`/`),r=``;for(let e=n.length-1;e>=0;e--){let t=n[e];if(t){r=t;break}}return r??``}const v=_;function y(e){if(e.endsWith(`.`)||e.endsWith(`/`))return;let n=t.exec(s(e));return n&&n.length>0&&p(n[0])?n[0].replace(`.`,``):void 0}const b=y;function x(e){let t=y(e);return t?`.${t}`:void 0}function S(e){return y(e)??``}function C(e){let t=y(e);return t?`.${t}`:``}function w(e){return!!m(e)}function T(e){return!!h(e)}function E(e){return!!_(e)}function D(e){return!!y(e)}function O(t,n=e()){let i=s(t).split(`/`),c=``,l=!1;for(let e=i.length-1;e>=-1&&!l;e--){let t=e>=0?i[e]:n;!t||t.length===0||(c=a(t,c),l=r(t))}return c=o(c,!l),l&&!r(c)?`/${c}`:c.length>0?c:`.`}function k(...t){t=t.map(e=>s(e));let n=``,r=!1;for(let a=t.length-1;a>=-1&&!r;a--){let o=a>=0?t[a]:e();!o||o.length===0||(n=`${o}/${n}`,r=i(o))}return n=o(n,!r),r&&!i(n)?`/${n}`:n.length>0?n:`.`}function A(...e){return O(a(...e.map(e=>s(e))))}function j(e,t){let r=k(e).replace(n,`$1`).split(`/`),i=k(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 M(e,t,n=!1){return j(n===!0?e:e.replace(/\/$/,``),n===!0?t:t.replace(/\/$/,``))}function N(t){return M(t,e())}function P(e){let t=/^[/\\]|^[a-z]:[/\\]/i.exec(e)?.[0]?.replace(/\\/g,`/`)||``,n=s(e),i=n.replace(/\/$/,``).split(`/`).slice(0,-1);i.length===1&&/^[A-Z]:$/i.test(i[0])&&(i[0]+=`/`);let a=_(n),o=i.join(`/`)||(r(e)?`/`:`.`),c=S(e);return{root:t,dir:o,base:a,ext:c,name:a.slice(0,a.length-c.length)}}function F(e,t){let n=P(e);return a(n.dir,t.includes(`.`)?t:t+n.ext)}export{A as S,M as _,C as a,k as b,m as c,D as d,w as f,j as g,P as h,x as i,h as l,E as m,g as n,y as o,T as p,b as r,S as s,v as t,_ as u,N as v,O as x,F as y};
+//# sourceMappingURL=file-path-fns-MRI3PV8K.mjs.map