@socketsecurity/lib 5.27.0 → 6.0.0

package/dist/paths/normalize.js

@@ -20,253 +20,73 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var normalize_exports = {};
 __export(normalize_exports, {
-  fromUnixPath: () => fromUnixPath,
-  isAbsolute: () => isAbsolute,
-  isNodeModules: () => isNodeModules,
-  isPath: () => isPath,
-  isRelative: () => isRelative,
-  isUnixPath: () => isUnixPath,
+  fromUnixPath: () => import_conversion.fromUnixPath,
+  getUrl: () => import_internal2.getUrl,
+  isAbsolute: () => import_predicates.isAbsolute,
+  isNodeModules: () => import_predicates.isNodeModules,
+  isPath: () => import_predicates.isPath,
+  isPathSeparator: () => import_predicates.isPathSeparator,
+  isRelative: () => import_predicates.isRelative,
+  isUnixPath: () => import_predicates.isUnixPath,
+  isWindowsDeviceRoot: () => import_predicates.isWindowsDeviceRoot,
+  msysDriveToNative: () => msysDriveToNative,
   normalizePath: () => normalizePath,
-  pathLikeToString: () => pathLikeToString,
-  relativeResolve: () => relativeResolve,
-  splitPath: () => splitPath,
-  toUnixPath: () => toUnixPath,
-  trimLeadingDotSlash: () => trimLeadingDotSlash
+  pathLikeToString: () => import_internal2.pathLikeToString,
+  relative: () => import_resolve.relative,
+  relativeResolve: () => import_resolve.relativeResolve,
+  resolve: () => import_resolve.resolve,
+  splitPath: () => import_conversion.splitPath,
+  toUnixPath: () => import_conversion.toUnixPath,
+  trimLeadingDotSlash: () => import_conversion.trimLeadingDotSlash
 });
 module.exports = __toCommonJS(normalize_exports);
 var import_platform = require("../constants/platform");
-var import_strings = require("../strings");
-var import_primordials = require("../primordials");
-const CHAR_BACKWARD_SLASH = 92;
-const CHAR_COLON = 58;
-const CHAR_FORWARD_SLASH = 47;
-const CHAR_LOWERCASE_A = 97;
-const CHAR_LOWERCASE_Z = 122;
-const CHAR_UPPERCASE_A = 65;
-const CHAR_UPPERCASE_Z = 90;
-const msysDriveRegExp = /^\/([a-zA-Z])(\/|$)/;
-const slashRegExp = /[/\\]/;
-const nodeModulesPathRegExp = /(?:^|[/\\])node_modules(?:[/\\]|$)/;
-let _url;
-// @__NO_SIDE_EFFECTS__
-function getUrl() {
-  if (_url === void 0) {
-    _url = require("node:url");
-  }
-  return _url;
-}
-// @__NO_SIDE_EFFECTS__
-function isPathSeparator(code) {
-  return code === CHAR_FORWARD_SLASH || code === CHAR_BACKWARD_SLASH;
-}
-// @__NO_SIDE_EFFECTS__
-function isWindowsDeviceRoot(code) {
-  return code >= CHAR_UPPERCASE_A && code <= CHAR_UPPERCASE_Z || code >= CHAR_LOWERCASE_A && code <= CHAR_LOWERCASE_Z;
-}
+var import_search = require("../strings/search");
+var import_string = require("../primordials/string");
+var import_internal = require("./_internal");
+var import_internal2 = require("./_internal");
+var import_conversion = require("./conversion");
+var import_predicates = require("./predicates");
+var import_resolve = require("./resolve");
 function msysDriveToNative(normalized) {
   if (import_platform.WIN32) {
     return normalized.replace(
-      msysDriveRegExp,
+      import_internal.msysDriveRegExp,
       (_, letter, sep) => `${letter.toUpperCase()}:${sep || "/"}`
     );
   }
   return normalized;
 }
 // @__NO_SIDE_EFFECTS__
-function relative(from, to) {
-  if (from === to) {
-    return "";
-  }
-  const actualFrom = /* @__PURE__ */ resolve(from);
-  const actualTo = /* @__PURE__ */ resolve(to);
-  if (actualFrom === actualTo) {
-    return "";
-  }
-  if (import_platform.WIN32) {
-    const fromLower = actualFrom.toLowerCase();
-    const toLower = actualTo.toLowerCase();
-    if (fromLower === toLower) {
-      return "";
-    }
-  }
-  const fromStart = 1;
-  const fromEnd = actualFrom.length;
-  const fromLen = fromEnd - fromStart;
-  const toStart = 1;
-  const toEnd = actualTo.length;
-  const toLen = toEnd - toStart;
-  const length = fromLen < toLen ? fromLen : toLen;
-  let lastCommonSep = -1;
-  let i = 0;
-  for (; i < length; i += 1) {
-    let fromCode = (0, import_primordials.StringPrototypeCharCodeAt)(actualFrom, fromStart + i);
-    let toCode = (0, import_primordials.StringPrototypeCharCodeAt)(actualTo, toStart + i);
-    if (import_platform.WIN32) {
-      if (fromCode >= CHAR_UPPERCASE_A && fromCode <= CHAR_UPPERCASE_Z) {
-        fromCode += 32;
-      }
-      if (toCode >= CHAR_UPPERCASE_A && toCode <= CHAR_UPPERCASE_Z) {
-        toCode += 32;
-      }
-    }
-    if (fromCode !== toCode) {
-      break;
-    }
-    if (/* @__PURE__ */ isPathSeparator((0, import_primordials.StringPrototypeCharCodeAt)(actualFrom, fromStart + i))) {
-      lastCommonSep = i;
-    }
-  }
-  if (i === length) {
-    if (toLen > length) {
-      const toCode = (0, import_primordials.StringPrototypeCharCodeAt)(actualTo, toStart + i);
-      if (/* @__PURE__ */ isPathSeparator(toCode)) {
-        return actualTo.slice(toStart + i + 1);
-      }
-      if (i === 0) {
-        return actualTo.slice(toStart + i);
-      }
-    } else if (fromLen > length) {
-      const fromCode = (0, import_primordials.StringPrototypeCharCodeAt)(actualFrom, fromStart + i);
-      if (/* @__PURE__ */ isPathSeparator(fromCode)) {
-        lastCommonSep = i;
-      } else if (i === 0) {
-        lastCommonSep = 0;
-      }
-    }
-  }
-  let out = "";
-  for (i = fromStart + lastCommonSep + 1; i <= fromEnd; i += 1) {
-    const code = (0, import_primordials.StringPrototypeCharCodeAt)(actualFrom, i);
-    if (i === fromEnd || /* @__PURE__ */ isPathSeparator(code)) {
-      out += out.length === 0 ? ".." : "/..";
-    }
-  }
-  return out + actualTo.slice(toStart + lastCommonSep);
-}
-// @__NO_SIDE_EFFECTS__
-function resolve(...segments) {
-  let resolvedPath = "";
-  let resolvedAbsolute = false;
-  for (let i = segments.length - 1; i >= 0 && !resolvedAbsolute; i -= 1) {
-    const segment = segments[i];
-    if (typeof segment !== "string" || segment.length === 0) {
-      continue;
-    }
-    resolvedPath = segment + (resolvedPath.length === 0 ? "" : `/${resolvedPath}`);
-    resolvedAbsolute = /* @__PURE__ */ isAbsolute(segment);
-  }
-  if (!resolvedAbsolute) {
-    const cwd = /* @__PURE__ */ require("node:process").cwd();
-    resolvedPath = cwd + (resolvedPath.length === 0 ? "" : `/${resolvedPath}`);
-  }
-  return /* @__PURE__ */ normalizePath(resolvedPath);
-}
-// @__NO_SIDE_EFFECTS__
-function fromUnixPath(pathLike) {
-  const normalized = /* @__PURE__ */ normalizePath(pathLike);
-  if (import_platform.WIN32) {
-    return normalized.replace(/\//g, "\\");
-  }
-  return normalized;
-}
-// @__NO_SIDE_EFFECTS__
-function isAbsolute(pathLike) {
-  const filepath = /* @__PURE__ */ pathLikeToString(pathLike);
-  const { length } = filepath;
-  if (length === 0) {
-    return false;
-  }
-  const code = (0, import_primordials.StringPrototypeCharCodeAt)(filepath, 0);
-  if (code === CHAR_FORWARD_SLASH) {
-    return true;
-  }
-  if (code === CHAR_BACKWARD_SLASH) {
-    return true;
-  }
-  if (import_platform.WIN32 && length > 2) {
-    if (/* @__PURE__ */ isWindowsDeviceRoot(code) && (0, import_primordials.StringPrototypeCharCodeAt)(filepath, 1) === CHAR_COLON && /* @__PURE__ */ isPathSeparator((0, import_primordials.StringPrototypeCharCodeAt)(filepath, 2))) {
-      return true;
-    }
-  }
-  return false;
-}
-// @__NO_SIDE_EFFECTS__
-function isNodeModules(pathLike) {
-  const filepath = /* @__PURE__ */ pathLikeToString(pathLike);
-  return (0, import_primordials.RegExpPrototypeTest)(nodeModulesPathRegExp, filepath);
-}
-// @__NO_SIDE_EFFECTS__
-function isPath(pathLike) {
-  const filepath = /* @__PURE__ */ pathLikeToString(pathLike);
-  if (typeof filepath !== "string" || filepath.length === 0) {
-    return false;
-  }
-  if (/^[a-z][a-z0-9+.-]+:/i.test(filepath)) {
-    return false;
-  }
-  if (filepath === "." || filepath === "..") {
-    return true;
-  }
-  if (/* @__PURE__ */ isAbsolute(filepath)) {
-    return true;
-  }
-  if (filepath.includes("/") || filepath.includes("\\")) {
-    if ((0, import_primordials.StringPrototypeStartsWith)(filepath, "@") && !(0, import_primordials.StringPrototypeStartsWith)(filepath, "@/")) {
-      const parts = filepath.split("/");
-      if (parts.length <= 2 && !parts[1]?.includes("\\")) {
-        return false;
-      }
-    }
-    return true;
-  }
-  return false;
-}
-// @__NO_SIDE_EFFECTS__
-function isRelative(pathLike) {
-  const filepath = /* @__PURE__ */ pathLikeToString(pathLike);
-  if (typeof filepath !== "string") {
-    return false;
-  }
-  if (filepath.length === 0) {
-    return true;
-  }
-  return !/* @__PURE__ */ isAbsolute(filepath);
-}
-// @__NO_SIDE_EFFECTS__
-function isUnixPath(pathLike) {
-  const filepath = /* @__PURE__ */ pathLikeToString(pathLike);
-  return typeof filepath === "string" && (0, import_primordials.RegExpPrototypeTest)(msysDriveRegExp, filepath);
-}
-// @__NO_SIDE_EFFECTS__
 function normalizePath(pathLike) {
-  const filepath = /* @__PURE__ */ pathLikeToString(pathLike);
+  const filepath = (0, import_internal.pathLikeToString)(pathLike);
   const { length } = filepath;
   if (length === 0) {
     return ".";
   }
   if (length < 2) {
-    return length === 1 && (0, import_primordials.StringPrototypeCharCodeAt)(filepath, 0) === 92 ? "/" : filepath;
+    return length === 1 && (0, import_string.StringPrototypeCharCodeAt)(filepath, 0) === 92 ? "/" : filepath;
   }
   let code = 0;
   let start = 0;
   let prefix = "";
-  if (length > 4 && (0, import_primordials.StringPrototypeCharCodeAt)(filepath, 3) === 92) {
-    const code2 = (0, import_primordials.StringPrototypeCharCodeAt)(filepath, 2);
-    if ((code2 === 63 || code2 === 46) && (0, import_primordials.StringPrototypeCharCodeAt)(filepath, 0) === 92 && (0, import_primordials.StringPrototypeCharCodeAt)(filepath, 1) === 92) {
+  if (length > 4 && (0, import_string.StringPrototypeCharCodeAt)(filepath, 3) === 92) {
+    const code2 = (0, import_string.StringPrototypeCharCodeAt)(filepath, 2);
+    if ((code2 === 63 || code2 === 46) && (0, import_string.StringPrototypeCharCodeAt)(filepath, 0) === 92 && (0, import_string.StringPrototypeCharCodeAt)(filepath, 1) === 92) {
       start = 2;
       prefix = "//";
     }
   }
   if (start === 0) {
-    if (length > 2 && ((0, import_primordials.StringPrototypeCharCodeAt)(filepath, 0) === 92 && (0, import_primordials.StringPrototypeCharCodeAt)(filepath, 1) === 92 && (0, import_primordials.StringPrototypeCharCodeAt)(filepath, 2) !== 92 || (0, import_primordials.StringPrototypeCharCodeAt)(filepath, 0) === 47 && (0, import_primordials.StringPrototypeCharCodeAt)(filepath, 1) === 47 && (0, import_primordials.StringPrototypeCharCodeAt)(filepath, 2) !== 47)) {
+    if (length > 2 && ((0, import_string.StringPrototypeCharCodeAt)(filepath, 0) === 92 && (0, import_string.StringPrototypeCharCodeAt)(filepath, 1) === 92 && (0, import_string.StringPrototypeCharCodeAt)(filepath, 2) !== 92 || (0, import_string.StringPrototypeCharCodeAt)(filepath, 0) === 47 && (0, import_string.StringPrototypeCharCodeAt)(filepath, 1) === 47 && (0, import_string.StringPrototypeCharCodeAt)(filepath, 2) !== 47)) {
       let firstSegmentEnd = -1;
       let hasSecondSegment = false;
       let i = 2;
-      while (i < length && ((0, import_primordials.StringPrototypeCharCodeAt)(filepath, i) === 47 || (0, import_primordials.StringPrototypeCharCodeAt)(filepath, i) === 92)) {
+      while (i < length && ((0, import_string.StringPrototypeCharCodeAt)(filepath, i) === 47 || (0, import_string.StringPrototypeCharCodeAt)(filepath, i) === 92)) {
         i++;
       }
       while (i < length) {
-        const char = (0, import_primordials.StringPrototypeCharCodeAt)(filepath, i);
+        const char = (0, import_string.StringPrototypeCharCodeAt)(filepath, i);
         if (char === 47 || char === 92) {
           firstSegmentEnd = i;
           break;
@@ -275,7 +95,7 @@ function normalizePath(pathLike) {
       }
       if (firstSegmentEnd > 2) {
         i = firstSegmentEnd;
-        while (i < length && ((0, import_primordials.StringPrototypeCharCodeAt)(filepath, i) === 47 || (0, import_primordials.StringPrototypeCharCodeAt)(filepath, i) === 92)) {
+        while (i < length && ((0, import_string.StringPrototypeCharCodeAt)(filepath, i) === 47 || (0, import_string.StringPrototypeCharCodeAt)(filepath, i) === 92)) {
           i++;
         }
         if (i < length) {
@@ -286,34 +106,34 @@ function normalizePath(pathLike) {
         start = 2;
         prefix = "//";
       } else {
-        code = (0, import_primordials.StringPrototypeCharCodeAt)(filepath, start);
+        code = (0, import_string.StringPrototypeCharCodeAt)(filepath, start);
         while (code === 47 || code === 92) {
           start += 1;
-          code = (0, import_primordials.StringPrototypeCharCodeAt)(filepath, start);
+          code = (0, import_string.StringPrototypeCharCodeAt)(filepath, start);
         }
         if (start) {
           prefix = "/";
         }
       }
     } else {
-      code = (0, import_primordials.StringPrototypeCharCodeAt)(filepath, start);
+      code = (0, import_string.StringPrototypeCharCodeAt)(filepath, start);
       while (code === 47 || code === 92) {
         start += 1;
-        code = (0, import_primordials.StringPrototypeCharCodeAt)(filepath, start);
+        code = (0, import_string.StringPrototypeCharCodeAt)(filepath, start);
       }
       if (start) {
         prefix = "/";
       }
     }
   }
-  let nextIndex = (0, import_strings.search)(filepath, slashRegExp, { fromIndex: start });
+  let nextIndex = (0, import_search.search)(filepath, import_internal.slashRegExp, { fromIndex: start });
   if (nextIndex === -1) {
     const segment = filepath.slice(start);
     if (segment === "." || segment.length === 0) {
       return prefix || ".";
     }
     if (segment === "..") {
-      return prefix ? (0, import_primordials.StringPrototypeSlice)(prefix, 0, -1) || "/" : "..";
+      return prefix ? (0, import_string.StringPrototypeSlice)(prefix, 0, -1) || "/" : "..";
     }
     return msysDriveToNative(prefix + segment);
   }
@@ -354,12 +174,12 @@ function normalizePath(pathLike) {
       }
     }
     start = nextIndex + 1;
-    code = (0, import_primordials.StringPrototypeCharCodeAt)(filepath, start);
+    code = (0, import_string.StringPrototypeCharCodeAt)(filepath, start);
     while (code === 47 || code === 92) {
       start += 1;
-      code = (0, import_primordials.StringPrototypeCharCodeAt)(filepath, start);
+      code = (0, import_string.StringPrototypeCharCodeAt)(filepath, start);
     }
-    nextIndex = (0, import_strings.search)(filepath, slashRegExp, { fromIndex: start });
+    nextIndex = (0, import_search.search)(filepath, import_internal.slashRegExp, { fromIndex: start });
   }
   const lastSegment = filepath.slice(start);
   if (lastSegment.length > 0 && lastSegment !== ".") {
@@ -398,83 +218,23 @@ function normalizePath(pathLike) {
   }
   return msysDriveToNative(prefix + collapsed);
 }
-// @__NO_SIDE_EFFECTS__
-function pathLikeToString(pathLike) {
-  if (pathLike === null || pathLike === void 0) {
-    return "";
-  }
-  if (typeof pathLike === "string") {
-    return pathLike;
-  }
-  if ((0, import_primordials.BufferIsBuffer)(pathLike)) {
-    return pathLike.toString("utf8");
-  }
-  const url = /* @__PURE__ */ getUrl();
-  if (pathLike instanceof URL) {
-    try {
-      return url.fileURLToPath(pathLike);
-    } catch {
-      const pathname = pathLike.pathname;
-      const decodedPathname = decodeURIComponent(pathname);
-      if (import_platform.WIN32 && (0, import_primordials.StringPrototypeStartsWith)(decodedPathname, "/")) {
-        const letter = (0, import_primordials.StringPrototypeCharCodeAt)(decodedPathname, 1) | 32;
-        const hasValidDriveLetter = decodedPathname.length >= 3 && letter >= 97 && // 'a' to 'z'
-        letter <= 122 && (0, import_primordials.StringPrototypeCharAt)(decodedPathname, 2) === ":";
-        if (!hasValidDriveLetter) {
-          return decodedPathname;
-        }
-      }
-      return decodedPathname;
-    }
-  }
-  return String(pathLike);
-}
-// @__NO_SIDE_EFFECTS__
-function relativeResolve(from, to) {
-  const rel = /* @__PURE__ */ relative(from, to);
-  if (rel === "") {
-    return "";
-  }
-  return /* @__PURE__ */ normalizePath(rel);
-}
-// @__NO_SIDE_EFFECTS__
-function splitPath(pathLike) {
-  const filepath = /* @__PURE__ */ pathLikeToString(pathLike);
-  if (filepath === "") {
-    return [];
-  }
-  return filepath.split(slashRegExp);
-}
-// @__NO_SIDE_EFFECTS__
-function toUnixPath(pathLike) {
-  const normalized = /* @__PURE__ */ normalizePath(pathLike);
-  if (import_platform.WIN32) {
-    return normalized.replace(
-      /^([A-Z]):/i,
-      (_, letter) => `/${letter.toLowerCase()}`
-    );
-  }
-  return normalized;
-}
-// @__NO_SIDE_EFFECTS__
-function trimLeadingDotSlash(pathLike) {
-  const filepath = /* @__PURE__ */ pathLikeToString(pathLike);
-  if ((0, import_primordials.StringPrototypeStartsWith)(filepath, "./") || (0, import_primordials.StringPrototypeStartsWith)(filepath, ".\\")) {
-    return filepath.slice(2);
-  }
-  return filepath;
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   fromUnixPath,
+  getUrl,
   isAbsolute,
   isNodeModules,
   isPath,
+  isPathSeparator,
   isRelative,
   isUnixPath,
+  isWindowsDeviceRoot,
+  msysDriveToNative,
   normalizePath,
   pathLikeToString,
+  relative,
   relativeResolve,
+  resolve,
   splitPath,
   toUnixPath,
   trimLeadingDotSlash

package/dist/paths/packages.d.ts

@@ -1,6 +1,12 @@
 /**
- * @fileoverview Package.json path resolution utilities.
+ * @file Package.json path resolution utilities.
  */
+/**
+ * Whether `filepath`'s final segment is exactly `package.json`. Accepts both
+ * POSIX and Windows-style separators so paths captured on either platform
+ * classify the same regardless of the host we're running on.
+ */
+export declare function isPackageJsonFile(filepath: string): boolean;
 /**
  * Resolve directory path from a package.json file path.
  */

package/dist/paths/packages.js

@@ -20,28 +20,22 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var packages_exports = {};
 __export(packages_exports, {
+  isPackageJsonFile: () => isPackageJsonFile,
   resolvePackageJsonDirname: () => resolvePackageJsonDirname,
   resolvePackageJsonPath: () => resolvePackageJsonPath
 });
 module.exports = __toCommonJS(packages_exports);
 var import_normalize = require("./normalize");
-var import_primordials = require("../primordials");
-let _path;
-// @__NO_SIDE_EFFECTS__
-function getPath() {
-  if (_path === void 0) {
-    _path = require("node:path");
-  }
-  return _path;
-}
+var import_string = require("../primordials/string");
+var import_path = require("../node/path");
 // @__NO_SIDE_EFFECTS__
 function isPackageJsonFile(filepath) {
-  return filepath === "package.json" || (0, import_primordials.StringPrototypeEndsWith)(filepath, "/package.json") || (0, import_primordials.StringPrototypeEndsWith)(filepath, "\\package.json");
+  return filepath === "package.json" || (0, import_string.StringPrototypeEndsWith)(filepath, "/package.json") || (0, import_string.StringPrototypeEndsWith)(filepath, "\\package.json");
 }
 // @__NO_SIDE_EFFECTS__
 function resolvePackageJsonDirname(filepath) {
   if (/* @__PURE__ */ isPackageJsonFile(filepath)) {
-    const path = /* @__PURE__ */ getPath();
+    const path = (0, import_path.getNodePath)();
     return (0, import_normalize.normalizePath)(path.dirname(filepath));
   }
   return (0, import_normalize.normalizePath)(filepath);
@@ -51,11 +45,12 @@ function resolvePackageJsonPath(filepath) {
   if (/* @__PURE__ */ isPackageJsonFile(filepath)) {
     return (0, import_normalize.normalizePath)(filepath);
   }
-  const path = /* @__PURE__ */ getPath();
+  const path = (0, import_path.getNodePath)();
   return (0, import_normalize.normalizePath)(path.join(filepath, "package.json"));
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  isPackageJsonFile,
   resolvePackageJsonDirname,
   resolvePackageJsonPath
 });

package/dist/paths/predicates.d.ts

@@ -0,0 +1,129 @@
+/**
+ * @file Path predicates — `is*` checks for path shape and kind. Split out of
+ *   `paths/normalize.ts` for file-size hygiene. Pure boolean predicates over
+ *   paths and character codes.
+ *
+ *   - `isAbsolute`, `isRelative` — root-anchoring shape
+ *   - `isPath` — file-path vs package-spec vs URL discriminator
+ *   - `isNodeModules`, `isUnixPath` — content-pattern checks
+ *   - `isPathSeparator`, `isWindowsDeviceRoot` — char-code primitives
+ */
+/**
+ * Check if a path is absolute.
+ *
+ * Handles both POSIX (`/...`) and Windows (drive-letter, UNC, device) absolute
+ * path shapes.
+ *
+ * @example
+ *   ;```typescript
+ *   isAbsolute('/home/user') // true
+ *   isAbsolute('C:\\Windows') // true on Windows
+ *   isAbsolute('../relative') // false
+ *   ```
+ *
+ * @param {string | Buffer | URL} pathLike - The path to check.
+ *
+ * @returns {boolean} `true` if absolute, `false` otherwise
+ */
+export declare function isAbsolute(pathLike: string | Buffer | URL): boolean;
+/**
+ * Check if a path contains a `node_modules` directory segment.
+ *
+ * Matches `node_modules` only as a complete path segment.
+ *
+ * @example
+ *   ;```typescript
+ *   isNodeModules('/project/node_modules/package') // true
+ *   isNodeModules('/src/my_node_modules_backup') // false
+ *   ```
+ *
+ * @param {string | Buffer | URL} pathLike - The path to check.
+ *
+ * @returns {boolean} `true` if the path contains `node_modules`
+ */
+export declare function isNodeModules(pathLike: string | Buffer | URL): boolean;
+/**
+ * Check if a value is a valid file path (absolute or relative).
+ *
+ * Distinguishes between file paths and other string formats like package names,
+ * URLs, or bare module specifiers.
+ *
+ * @example
+ *   ;```typescript
+ *   isPath('/absolute/path') // true
+ *   isPath('./relative/path') // true
+ *   isPath('@scope/name/subpath') // true
+ *   isPath('lodash') // false
+ *   isPath('http://example.com') // false
+ *   ```
+ *
+ * @param {string | Buffer | URL} pathLike - The value to check.
+ *
+ * @returns {boolean} `true` if the value is a valid file path
+ */
+export declare function isPath(pathLike: string | Buffer | URL): boolean;
+/**
+ * Check if a character code is a path separator (`/` or `\`).
+ *
+ * @example
+ *   ;```typescript
+ *   isPathSeparator(47) // true — '/'
+ *   isPathSeparator(92) // true — '\'
+ *   isPathSeparator(65) // false — 'A'
+ *   ```
+ *
+ * @param {number} code - The character code to check.
+ *
+ * @returns {boolean} `true` if separator
+ */
+export declare function isPathSeparator(code: number): boolean;
+/**
+ * Check if a path is relative (i.e., not absolute).
+ *
+ * Empty strings are treated as relative.
+ *
+ * @example
+ *   ;```typescript
+ *   isRelative('./src/index.js') // true
+ *   isRelative('src/file.js') // true
+ *   isRelative('/home/user') // false
+ *   ```
+ *
+ * @param {string | Buffer | URL} pathLike - The path to check.
+ *
+ * @returns {boolean} `true` if the path is relative
+ */
+export declare function isRelative(pathLike: string | Buffer | URL): boolean;
+/**
+ * Check if a path uses MSYS/Git Bash Unix-style drive letter notation.
+ *
+ * Detects paths in the format `/c/...` where a single letter after the leading
+ * slash represents a Windows drive letter.
+ *
+ * @example
+ *   ;```typescript
+ *   isUnixPath('/c/tools/bin') // true
+ *   isUnixPath('/tmp/build') // false
+ *   isUnixPath('C:/Windows') // false
+ *   ```
+ *
+ * @param {string | Buffer | URL} pathLike - The path to check.
+ *
+ * @returns {boolean} `true` if the path uses MSYS drive letter notation
+ */
+export declare function isUnixPath(pathLike: string | Buffer | URL): boolean;
+/**
+ * Check if a character code is a Windows device root letter (A-Z / a-z).
+ *
+ * @example
+ *   ;```typescript
+ *   isWindowsDeviceRoot(67) // true  — 'C'
+ *   isWindowsDeviceRoot(99) // true  — 'c'
+ *   isWindowsDeviceRoot(58) // false — ':'
+ *   ```
+ *
+ * @param {number} code - The character code to check.
+ *
+ * @returns {boolean} `true` if valid drive-letter code
+ */
+export declare function isWindowsDeviceRoot(code: number): boolean;