@stryke/path 0.19.4 → 0.21.0

package/dist/append.cjs

@@ -4,12 +4,16 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.append = void 0;
+exports.appendExtension = appendExtension;
 exports.appendPath = appendPath;
 var _cwd = require("./cwd.cjs");
 var _isParentPath = require("./is-parent-path.cjs");
 var _joinPaths = require("./join-paths.cjs");
 var _slash = require("./slash.cjs");
-function appendPath(r, o = (0, _cwd.cwd)()) {
-  return (0, _slash.slash)((0, _isParentPath.isParentPath)(r, o) ? r : (0, _joinPaths.joinPaths)(o, r));
+function appendPath(r, n = (0, _cwd.cwd)()) {
+  return (0, _slash.slash)((0, _isParentPath.isParentPath)(r, n) ? r : (0, _joinPaths.joinPaths)(n, r));
 }
-const append = exports.append = appendPath;
+const append = exports.append = appendPath;
+function appendExtension(r, n) {
+  return `${r}.${n.replace(/^\./, "")}`;
+}

package/dist/append.d.ts

@@ -16,3 +16,19 @@
  */
 export declare function appendPath(childPath: string, parentPath?: string): string;
 export declare const append: typeof appendPath;
+/**
+ * Append the extension to the given path.
+ *
+ * @example
+ * ```ts
+ * appendExtension("/home/user/project/src/index", ".ts");
+ * // returns "/home/user/project/src/index.ts"
+ * appendExtension("/home/user/project/src/index.ts", ".js");
+ * // returns "/home/user/project/src/index.ts.js"
+ * ```
+ *
+ * @param path - The path to append the extension to.
+ * @param extension - The extension to append.
+ * @returns The path with the appended extension.
+ */
+export declare function appendExtension(path: string, extension: string): string;

package/dist/append.mjs

@@ -1 +1 @@
-import{cwd as t}from"./cwd";import{isParentPath as n}from"./is-parent-path";import{joinPaths as p}from"./join-paths";import{slash as i}from"./slash";export function appendPath(r,o=t()){return i(n(r,o)?r:p(o,r))}export const append=appendPath;
+import{cwd as t}from"./cwd";import{isParentPath as o}from"./is-parent-path";import{joinPaths as i}from"./join-paths";import{slash as p}from"./slash";export function appendPath(r,n=t()){return p(o(r,n)?r:i(n,r))}export const append=appendPath;export function appendExtension(r,n){return`${r}.${n.replace(/^\./,"")}`}

package/dist/correct-path.cjs

@@ -10,31 +10,32 @@ exports.stripStars = stripStars;
 exports.toAbsolutePath = toAbsolutePath;
 exports.toRelativePath = toRelativePath;
 exports.withTrailingSlash = withTrailingSlash;
+var _append = require("./append.cjs");
 var _cwd = require("./cwd.cjs");
 var _isType = require("./is-type.cjs");
 var _joinPaths = require("./join-paths.cjs");
 var _regex = require("./regex.cjs");
 var _slash = require("./slash.cjs");
 function normalizeWindowsPath(e = "") {
-  return e && (0, _slash.slash)(e).replace(_regex.DRIVE_LETTER_START_REGEX, n => n.toUpperCase());
+  return e && (0, _slash.slash)(e).replace(_regex.DRIVE_LETTER_START_REGEX, t => t.toUpperCase());
 }
 function correctPath(e) {
   if (!e || e.length === 0) return ".";
   e = normalizeWindowsPath(e);
-  const n = e.match(_regex.UNC_REGEX),
+  const t = e.match(_regex.UNC_REGEX),
     r = (0, _isType.isAbsolutePath)(e),
-    t = e.endsWith("/");
-  return e = normalizeString(e, !r), e.length === 0 ? r ? "/" : t ? "./" : "." : (t && (e += "/"), _regex.DRIVE_LETTER_REGEX.test(e) && (e += "/"), n ? r ? `//${e}` : `//./${e}` : !e.startsWith("/") && r && !_regex.DRIVE_LETTER_REGEX.test(e) ? `/${e}` : e);
+    n = e.endsWith("/");
+  return e = normalizeString(e, !r), e.length === 0 ? r ? "/" : n ? "./" : "." : (n && (e += "/"), _regex.DRIVE_LETTER_REGEX.test(e) && (e += "/"), t ? r ? `//${e}` : `//./${e}` : !e.startsWith("/") && r && !_regex.DRIVE_LETTER_REGEX.test(e) ? `/${e}` : e);
 }
 function stripStars(e) {
   if (!e || e.length === 0) return ".";
   e = correctPath(e);
-  let n = !1;
-  return e.split("/").reduce((r, t) => t?.trim() ? n || t.includes("*") ? (n = !0, r) : r + (r ? `/${t}` : t) : r, "");
+  let t = !1;
+  return e.split("/").reduce((r, n) => n?.trim() ? t || n.includes("*") ? (t = !0, r) : r + (r ? `/${n}` : n) : r, "");
 }
-function normalizeString(e, n) {
+function normalizeString(e, t) {
   let r = "",
-    t = 0,
+    n = 0,
     l = -1,
     s = 0,
     o = null;
@@ -45,30 +46,30 @@ function normalizeString(e, n) {
     }
     if (o === "/") {
       if (!(l === i - 1 || s === 1)) if (s === 2) {
-        if (r.length < 2 || t !== 2 || r[r.length - 1] !== "." || r[r.length - 2] !== ".") {
+        if (r.length < 2 || n !== 2 || r[r.length - 1] !== "." || r[r.length - 2] !== ".") {
           if (r.length > 2) {
             const c = r.lastIndexOf("/");
-            c === -1 ? (r = "", t = 0) : (r = r.slice(0, c), t = r.length - 1 - r.lastIndexOf("/")), l = i, s = 0;
+            c === -1 ? (r = "", n = 0) : (r = r.slice(0, c), n = r.length - 1 - r.lastIndexOf("/")), l = i, s = 0;
             continue;
           } else if (r.length > 0) {
-            r = "", t = 0, l = i, s = 0;
+            r = "", n = 0, l = i, s = 0;
             continue;
           }
         }
-        n && (r += r.length > 0 ? "/.." : "..", t = 2);
-      } else r.length > 0 ? r += `/${e.slice(l + 1, i)}` : r = e.slice(l + 1, i), t = i - l - 1;
+        t && (r += r.length > 0 ? "/.." : "..", n = 2);
+      } else r.length > 0 ? r += `/${e.slice(l + 1, i)}` : r = e.slice(l + 1, i), n = i - l - 1;
       l = i, s = 0;
     } else o === "." && s !== -1 ? ++s : s = -1;
   }
   return r;
 }
-function toAbsolutePath(e, n) {
-  return (0, _isType.isAbsolutePath)(e) ? e : (0, _slash.slash)(normalizeString((0, _joinPaths.joinPaths)(n || process.cwd(), e), !0));
+function toAbsolutePath(e, t = (0, _cwd.cwd)()) {
+  return (0, _isType.isAbsolutePath)(e) ? e : (0, _slash.slash)(normalizeString((0, _append.appendPath)(e, t), !0));
 }
-function toRelativePath(e, n = (0, _cwd.cwd)()) {
-  return !e || e.length === 0 ? "." : ((0, _isType.isAbsolutePath)(e) ? e = (0, _slash.slash)(normalizeString(e, !0)) : e = (0, _slash.slash)(normalizeString((0, _joinPaths.joinPaths)(n, e), !0)), e.startsWith("./") ? e.slice(2) : e);
+function toRelativePath(e, t = (0, _cwd.cwd)()) {
+  return !e || e.length === 0 ? "." : ((0, _isType.isAbsolutePath)(e) ? e = (0, _slash.slash)(normalizeString(e, !0)) : e = (0, _slash.slash)(normalizeString((0, _joinPaths.joinPaths)(t, e), !0)), e.startsWith("./") ? e.slice(2) : e);
 }
 function withTrailingSlash(e) {
-  const n = correctPath(e);
-  return n.endsWith("/") ? n : `${n}/`;
+  const t = correctPath(e);
+  return t.endsWith("/") ? t : `${t}/`;
 }

package/dist/correct-path.mjs

@@ -1 +1 @@
-import{cwd as m}from"./cwd";import{isAbsolutePath as u}from"./is-type";import{joinPaths as g}from"./join-paths";import{DRIVE_LETTER_REGEX as d,DRIVE_LETTER_START_REGEX as E,UNC_REGEX as x}from"./regex";import{slash as f}from"./slash";export function normalizeWindowsPath(e=""){return e&&f(e).replace(E,n=>n.toUpperCase())}export function correctPath(e){if(!e||e.length===0)return".";e=normalizeWindowsPath(e);const n=e.match(x),r=u(e),t=e.endsWith("/");return e=normalizeString(e,!r),e.length===0?r?"/":t?"./":".":(t&&(e+="/"),d.test(e)&&(e+="/"),n?r?`//${e}`:`//./${e}`:!e.startsWith("/")&&r&&!d.test(e)?`/${e}`:e)}export function stripStars(e){if(!e||e.length===0)return".";e=correctPath(e);let n=!1;return e.split("/").reduce((r,t)=>t?.trim()?n||t.includes("*")?(n=!0,r):r+(r?`/${t}`:t):r,"")}export function normalizeString(e,n){let r="",t=0,l=-1,s=0,o=null;for(let i=0;i<=e.length;++i){if(i<e.length)o=e[i];else{if(o==="/")break;o="/"}if(o==="/"){if(!(l===i-1||s===1))if(s===2){if(r.length<2||t!==2||r[r.length-1]!=="."||r[r.length-2]!=="."){if(r.length>2){const c=r.lastIndexOf("/");c===-1?(r="",t=0):(r=r.slice(0,c),t=r.length-1-r.lastIndexOf("/")),l=i,s=0;continue}else if(r.length>0){r="",t=0,l=i,s=0;continue}}n&&(r+=r.length>0?"/..":"..",t=2)}else r.length>0?r+=`/${e.slice(l+1,i)}`:r=e.slice(l+1,i),t=i-l-1;l=i,s=0}else o==="."&&s!==-1?++s:s=-1}return r}export function toAbsolutePath(e,n){return u(e)?e:f(normalizeString(g(n||process.cwd(),e),!0))}export function toRelativePath(e,n=m()){return!e||e.length===0?".":(u(e)?e=f(normalizeString(e,!0)):e=f(normalizeString(g(n,e),!0)),e.startsWith("./")?e.slice(2):e)}export function withTrailingSlash(e){const n=correctPath(e);return n.endsWith("/")?n:`${n}/`}
+import{appendPath as d}from"./append";import{cwd as g}from"./cwd";import{isAbsolutePath as u}from"./is-type";import{joinPaths as E}from"./join-paths";import{DRIVE_LETTER_REGEX as m,DRIVE_LETTER_START_REGEX as x,UNC_REGEX as P}from"./regex";import{slash as f}from"./slash";export function normalizeWindowsPath(e=""){return e&&f(e).replace(x,t=>t.toUpperCase())}export function correctPath(e){if(!e||e.length===0)return".";e=normalizeWindowsPath(e);const t=e.match(P),r=u(e),n=e.endsWith("/");return e=normalizeString(e,!r),e.length===0?r?"/":n?"./":".":(n&&(e+="/"),m.test(e)&&(e+="/"),t?r?`//${e}`:`//./${e}`:!e.startsWith("/")&&r&&!m.test(e)?`/${e}`:e)}export function stripStars(e){if(!e||e.length===0)return".";e=correctPath(e);let t=!1;return e.split("/").reduce((r,n)=>n?.trim()?t||n.includes("*")?(t=!0,r):r+(r?`/${n}`:n):r,"")}export function normalizeString(e,t){let r="",n=0,l=-1,s=0,o=null;for(let i=0;i<=e.length;++i){if(i<e.length)o=e[i];else{if(o==="/")break;o="/"}if(o==="/"){if(!(l===i-1||s===1))if(s===2){if(r.length<2||n!==2||r[r.length-1]!=="."||r[r.length-2]!=="."){if(r.length>2){const c=r.lastIndexOf("/");c===-1?(r="",n=0):(r=r.slice(0,c),n=r.length-1-r.lastIndexOf("/")),l=i,s=0;continue}else if(r.length>0){r="",n=0,l=i,s=0;continue}}t&&(r+=r.length>0?"/..":"..",n=2)}else r.length>0?r+=`/${e.slice(l+1,i)}`:r=e.slice(l+1,i),n=i-l-1;l=i,s=0}else o==="."&&s!==-1?++s:s=-1}return r}export function toAbsolutePath(e,t=g()){return u(e)?e:f(normalizeString(d(e,t),!0))}export function toRelativePath(e,t=g()){return!e||e.length===0?".":(u(e)?e=f(normalizeString(e,!0)):e=f(normalizeString(E(t,e),!0)),e.startsWith("./")?e.slice(2):e)}export function withTrailingSlash(e){const t=correctPath(e);return t.endsWith("/")?t:`${t}/`}

package/dist/is-type.cjs

@@ -5,6 +5,8 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.isAbsolute = isAbsolute;
 exports.isAbsolutePath = isAbsolutePath;
+exports.isNpmScopedPackage = isNpmScopedPackage;
+exports.isNpmScopedPackagePath = isNpmScopedPackagePath;
 exports.isRelative = isRelative;
 exports.isRelativePath = isRelativePath;
 var _regex = require("./regex.cjs");
@@ -20,4 +22,10 @@ function isRelativePath(t) {
 }
 function isRelative(t) {
   return isRelativePath(t);
+}
+function isNpmScopedPackagePath(t) {
+  return _regex.NPM_SCOPED_PACKAGE_REGEX.test((0, _slash.slash)(t));
+}
+function isNpmScopedPackage(t) {
+  return isNpmScopedPackagePath(t);
 }

package/dist/is-type.d.ts

@@ -32,3 +32,37 @@ export declare function isRelativePath(path: string): boolean;
  * @returns An indicator specifying if the path is a relative path
  */
 export declare function isRelative(path: string): boolean;
+/**
+ * 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
+ */
+export declare function isNpmScopedPackagePath(path: string): boolean;
+/**
+ * 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
+ */
+export declare function isNpmScopedPackage(path: string): boolean;

package/dist/is-type.mjs

@@ -1 +1 @@
-import{ABSOLUTE_PATH_REGEX as o}from"./regex";import{slash as n}from"./slash";export function isAbsolutePath(t){return o.test(n(t))}export function isAbsolute(t){return isAbsolutePath(t)}export function isRelativePath(t){return!isAbsolutePath(t)}export function isRelative(t){return isRelativePath(t)}
+import{ABSOLUTE_PATH_REGEX as e,NPM_SCOPED_PACKAGE_REGEX as n}from"./regex";import{slash as o}from"./slash";export function isAbsolutePath(t){return e.test(o(t))}export function isAbsolute(t){return isAbsolutePath(t)}export function isRelativePath(t){return!isAbsolutePath(t)}export function isRelative(t){return isRelativePath(t)}export function isNpmScopedPackagePath(t){return n.test(o(t))}export function isNpmScopedPackage(t){return isNpmScopedPackagePath(t)}

package/dist/regex.cjs

@@ -3,10 +3,12 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.UNC_REGEX = exports.ROOT_FOLDER_REGEX = exports.FILE_EXTENSION_REGEX = exports.DRIVE_LETTER_START_REGEX = exports.DRIVE_LETTER_REGEX = exports.ABSOLUTE_PATH_REGEX = void 0;
+exports.UNC_REGEX = exports.ROOT_FOLDER_REGEX = exports.PACKAGE_PATH_REGEX = exports.NPM_SCOPED_PACKAGE_REGEX = exports.FILE_EXTENSION_REGEX = exports.DRIVE_LETTER_START_REGEX = exports.DRIVE_LETTER_REGEX = exports.ABSOLUTE_PATH_REGEX = void 0;
 const DRIVE_LETTER_START_REGEX = exports.DRIVE_LETTER_START_REGEX = /^[A-Z]:\//i,
   DRIVE_LETTER_REGEX = exports.DRIVE_LETTER_REGEX = /^[A-Z]:$/i,
   UNC_REGEX = exports.UNC_REGEX = /^[/\\]{2}/,
   ABSOLUTE_PATH_REGEX = exports.ABSOLUTE_PATH_REGEX = /^[/\\](?![/\\])|^[/\\]{2}(?!\.)|^~[/\\]|^[A-Z]:[/\\]/i,
   ROOT_FOLDER_REGEX = exports.ROOT_FOLDER_REGEX = /^\/([A-Z]:)?$/i,
-  FILE_EXTENSION_REGEX = exports.FILE_EXTENSION_REGEX = /\.[0-9a-z]+$/i;
+  FILE_EXTENSION_REGEX = exports.FILE_EXTENSION_REGEX = /\.[0-9a-z]+$/i,
+  PACKAGE_PATH_REGEX = exports.PACKAGE_PATH_REGEX = /^@\w+\/.*$/,
+  NPM_SCOPED_PACKAGE_REGEX = exports.NPM_SCOPED_PACKAGE_REGEX = /^(?:@[\w-]+\/)?[\w-]+$/;

package/dist/regex.d.ts

@@ -4,3 +4,5 @@ export declare const UNC_REGEX: RegExp;
 export declare const ABSOLUTE_PATH_REGEX: RegExp;
 export declare const ROOT_FOLDER_REGEX: RegExp;
 export declare const FILE_EXTENSION_REGEX: RegExp;
+export declare const PACKAGE_PATH_REGEX: RegExp;
+export declare const NPM_SCOPED_PACKAGE_REGEX: RegExp;

package/dist/regex.mjs

@@ -1 +1 @@
-export const DRIVE_LETTER_START_REGEX=/^[A-Z]:\//i,DRIVE_LETTER_REGEX=/^[A-Z]:$/i,UNC_REGEX=/^[/\\]{2}/,ABSOLUTE_PATH_REGEX=/^[/\\](?![/\\])|^[/\\]{2}(?!\.)|^~[/\\]|^[A-Z]:[/\\]/i,ROOT_FOLDER_REGEX=/^\/([A-Z]:)?$/i,FILE_EXTENSION_REGEX=/\.[0-9a-z]+$/i;
+export const DRIVE_LETTER_START_REGEX=/^[A-Z]:\//i,DRIVE_LETTER_REGEX=/^[A-Z]:$/i,UNC_REGEX=/^[/\\]{2}/,ABSOLUTE_PATH_REGEX=/^[/\\](?![/\\])|^[/\\]{2}(?!\.)|^~[/\\]|^[A-Z]:[/\\]/i,ROOT_FOLDER_REGEX=/^\/([A-Z]:)?$/i,FILE_EXTENSION_REGEX=/\.[0-9a-z]+$/i,PACKAGE_PATH_REGEX=/^@\w+\/.*$/,NPM_SCOPED_PACKAGE_REGEX=/^(?:@[\w-]+\/)?[\w-]+$/;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stryke/path",
-  "version": "0.19.4",
+  "version": "0.21.0",
   "type": "module",
   "description": "A package containing various utilities that expand the functionality of NodeJs's built-in `path` module",
   "repository": {
@@ -11,9 +11,9 @@
   "private": false,
   "devDependencies": {
     "@storm-software/testing-tools": "^1.119.48",
-    "@stryke/convert": "^0.6.4",
-    "@stryke/type-checks": "^0.3.14",
-    "@stryke/types": "^0.10.4"
+    "@stryke/convert": "^0.6.6",
+    "@stryke/type-checks": "^0.3.16",
+    "@stryke/types": "^0.10.6"
   },
   "publishConfig": { "access": "public" },
   "dependencies": {},
@@ -280,5 +280,5 @@
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
-  "gitHead": "201972005e4b1291d431d46e3fb49764f44690c5"
+  "gitHead": "fc3f6e2179191455ef4c9a8e7be4294a77228b07"
 }