@reliverse/pathkit 1.3.4 → 2.2.7

package/{bin → dist}/mod.d.ts

@@ -1,5 +1,5 @@
 import type { PlatformPath } from "node:path";
-import { getFileImportsExports, type ImportExportInfo, type ImportExportSpecifier, type GetFileImportsExportsOptions } from "./impl/getFileImportsExports.js";
+import { type GetFileImportsExportsOptions, getFileImportsExports, type ImportExportInfo, type ImportExportSpecifier } from "./utils/get-imports-exports.js";
 declare const normalizedAliasSymbol: unique symbol;
 export declare const IMPORT_EXPORT_REGEX: RegExp;
 interface NormalizedRecord extends Record<string, string> {

package/{bin → dist}/mod.js

@@ -1,7 +1,7 @@
-import fs from "node:fs/promises";
+import * as fs from "node:fs/promises";
 import {
   getFileImportsExports
-} from "./impl/getFileImportsExports.js";
+} from "./utils/get-imports-exports.js";
 const regularLogger = (msg) => {
   const message = typeof msg === "function" ? msg() : msg;
   console.log(`\x1B[2m${message}\x1B[0m`);
@@ -23,7 +23,7 @@ const BACK_SLASH = "\\";
 const DOT = ".";
 const DOUBLE_DOT = "..";
 const EMPTY = "";
-const normalizedAliasSymbol = Symbol.for("pathkit:normalizedAlias");
+const normalizedAliasSymbol = /* @__PURE__ */ Symbol.for("pathkit:normalizedAlias");
 const DRIVE_LETTER_START_RE = /^[A-Za-z]:\//;
 const DRIVE_LETTER_RE = /^[A-Za-z]:$/;
 const UNC_REGEX = /^[/\\]{2}/;

package/package.json

@@ -1,26 +1,22 @@
 {
-  "dependencies": {
-    "@reliverse/cfg": "^1.7.40"
-  },
-  "description": "@reliverse/pathkit is a slash‑consistent, cross‑platform path manipulation, with POSIX forward slash, drop‑in for node:path and unjs/pathe. This library extends the node:path module with a set of functions for manipulating file paths.",
-  "homepage": "https://docs.reliverse.org",
-  "license": "MIT",
   "name": "@reliverse/pathkit",
+  "description": "Path manipulation and resolution utilities for Reliverse ecosystem",
+  "author": "reliverse",
+  "version": "2.2.7",
+  "private": false,
   "type": "module",
-  "version": "1.3.4",
-  "devDependencies": {},
   "exports": {
-    ".": "./bin/mod.js"
+    ".": {
+      "types": "./dist/mod.d.ts",
+      "default": "./dist/mod.js"
+    }
   },
-  "files": [
-    "bin",
-    "package.json",
-    "README.md",
-    "LICENSE"
-  ],
-  "main": "./bin/mod.js",
-  "module": "./bin/mod.js",
   "publishConfig": {
     "access": "public"
-  }
-}
+  },
+  "files": [
+    "dist",
+    "package.json"
+  ],
+  "license": "MIT"
+}

package/LICENSE

@@ -1,21 +0,0 @@
-# MIT License
-
-Copyright (c) Nazar Kornienko (blefnk), Reliverse
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,510 +0,0 @@
-# pathkit • cross‑platform path manipulation
-
-> @reliverse/pathkit is a slash‑consistent, cross‑platform path manipulation, with POSIX forward slash, drop‑in for node:path and unjs/pathe. This library extends the node:path module with a set of functions for manipulating file paths.
-
-[sponsor](https://github.com/sponsors/blefnk) • [discord](https://discord.gg/Pb8uKbwpsJ) • [npm](https://npmjs.com/package/@reliverse/pathkit) • [repo](https://github.com/reliverse/pathkit)
-
-## Key Features
-
-- 🔹 **drop in** and replace `node:path` and `unjs/pathe` instantly
-- ➕ **`unjs/pathe` on steroids** – alias resolution, import parsing, and more
-- 🌀 **always `/`** – posix separators 100% of the time (buh‑bye `\\`)
-- ⚙️ **node.js api compatible** – familiar methods, no learning curve
-- 🚀 **modern & fast** – typescript, pure esm, bun & node‑ready
-- 🧠 **predictable & testable** – deterministic output across windows / macos / linux
-- 🧼 **no dependencies** – just better path api + couple of cool utilities = [4kB](https://bundlephobia.com/package/@reliverse/pathkit@latest)
-
-## Installation
-
-```bash
-# bun • pnpm • yarn • npm
-bun add @reliverse/pathkit
-```
-
-**Migrate**:
-
-```bash
-# soon:
-# bun add -D @reliverse/dler
-# bun dler migrate --lib path-to-pathkit
-# bun dler migrate --lib pathe-to-pathkit
-```
-
-### `unjs/pathe` vs `@reliverse/pathkit`
-
-| Package | What you get | When to use |
-|---------|--------------|-------------|
-| **`pathe`** | Path API only (with POSIX everywhere) | You only need a drop‑in for `node:path` |
-| **`pathkit`** | Everything in `pathe` **+** advanced utilities | You need alias resolution, import transforms, etc. |
-
-## Why Pathkit? — The Problem with Native Paths
-
-Native `node:path` flips behavior between operating systems, spurring subtle bugs and OS checks.
-
-```js
-// With node:path – the same call may yield different separators on each OS
-import path from "node:path";
-
-const project = "users/blefnk/project";
-const full = path.join("C:\\", project);
-console.log(full); // "C:\\users\\blefnk\\project" (Windows) vs ??? (others)
-```
-
-### ✅ The `pathkit` Fix
-
-```js
-import { join } from "@reliverse/pathkit";
-
-const full = join("C:", "users", "blefnk", "project");
-console.log(full); // "C:/users/blefnk/project" on **every** OS 🎉
-```
-
-| Pain Point                     | `@reliverse/pathkit` Solution |
-| :----------------------------- | :--------------------------- |
-| Inconsistent separators        | ✅ Always `/` |
-| OS‑specific work‑arounds       | ✅ One code path |
-| Needs TypeScript + ESM         | ✅ Built‑in |
-| Works in Bun / Deno / Node     | ✅ Out of the box |
-
-## Quick Start
-
-```ts
-import { resolve, join, normalize } from "@reliverse/pathkit";
-
-// Mixed slashes & dot‑segments? No problem.
-const messy = "src\\..\\./dist///file.js";
-console.log(resolve(messy));             // → "dist/file.js"
-
-// Join is predictable everywhere:
-console.log(join("users", "blefnk"));    // → "users/blefnk"
-```
-
-**Side‑by‑Side Demo**:
-
-| Code | Windows Output | macOS / Linux Output |
-|------|----------------|----------------------|
-| `join("a", "b")` | `a/b` | `a/b` |
-| `resolve("..", "x")` | `x` | `x` |
-
-Say goodbye to `process.platform` conditionals 👋.
-
-## pathkit advanced features
-
-`@reliverse/pathkit` extends the core functionality of `node:path` with powerful utilities for working with imports, aliases, and more.
-
-### Import/Export Analysis
-
-The `getFileImportsExports` function provides detailed analysis of ES module imports and exports in your code:
-
-```ts
-import { getFileImportsExports } from "@reliverse/pathkit";
-
-const code = `
-import { ref } from "vue";
-import utils from "@/utils";
-import type { Config } from "./types";
-import * as React from "react";
-import { Button as UIButton } from "./components";
-export { default as MyComponent } from "./MyComponent";
-export type { Props } from "./types";
-`;
-
-const analysis = getFileImportsExports(code, {
-  kind: "all",           // "import" | "export" | "all"
-  pathTypes: ["alias"],  // Filter by path types: "alias" | "relative" | "absolute" | "bare" | "module"
-  limitPerType: 2        // Limit results per type
-});
-```
-
-The analysis provides rich information about each import/export statement:
-
-```ts
-interface ImportExportInfo {
-  statement: string;           // Full original statement
-  type: "static" | "dynamic"; // Import type (static or dynamic import())
-  kind: "import" | "export";  // Statement kind
-  source?: string;            // Import/export source path
-  pathType?: "alias" | "relative" | "absolute" | "bare" | "module";
-  pathTypeSymbol?: string;    // Path prefix (e.g., "@/", "~/")
-  isTypeOnly?: boolean;       // Type-only import/export
-  specifiers?: {              // Imported/exported items
-    type: "named" | "default" | "namespace" | "all";
-    name: string;
-    alias?: string;
-    isType?: boolean;
-  }[];
-  start: number;              // Position in source
-  end: number;
-  importExt?: string;         // Extension as written in import/export statement
-  realFileExt?: string;       // Likely actual file extension (e.g., .ts for .js imports)
-}
-```
-
-Features:
-
-- ✨ **Comprehensive Syntax Support**
-  - Static imports (`import x from "y"`)
-  - Dynamic imports (`import("y")`)
-  - Named imports/exports (`import { x } from "y"`)
-  - Default imports/exports (`import x from "y"`)
-  - Namespace imports (`import * as x from "y"`)
-  - Re-exports (`export * from "y"`)
-  - Type imports/exports (`import type { x } from "y"`)
-
-- 🔍 **Path Analysis**
-  - Detects path types (alias, relative, absolute, bare, module)
-  - Extracts path prefixes (e.g., `@/`, `~/`)
-  - Preserves original path format
-  - Tracks both import statement extensions and likely real file extensions
-  - Handles TypeScript/JavaScript extension conversion (e.g., `.js` → `.ts`)
-
-- 🎯 **Specifier Details**
-  - Named imports/exports with aliases
-  - Default imports/exports
-  - Namespace imports
-  - Type-only imports/exports
-  - Mixed type and value imports
-
-- 📊 **Filtering Options**
-  - Filter by statement kind (import/export)
-  - Filter by path types
-  - Limit results per type
-  - Preserve statement order
-
-- 🛡️ **Type Safety**
-  - Full TypeScript support
-  - Detailed type definitions
-  - Null-safe operations
-
-Example output:
-
-```ts
-[
-  {
-    statement: 'import { ref } from "vue"',
-    type: "static",
-    kind: "import",
-    source: "vue",
-    pathType: "bare",
-    specifiers: [{
-      type: "named",
-      name: "ref"
-    }],
-    start: 0,
-    end: 24,
-    importExt: "",
-    realFileExt: ""
-  },
-  {
-    statement: 'import type { Config } from "./types.js"',
-    type: "static",
-    kind: "import",
-    source: "./types.js",
-    pathType: "relative",
-    isTypeOnly: true,
-    specifiers: [{
-      type: "named",
-      name: "Config",
-      isType: true
-    }],
-    start: 45,
-    end: 85,
-    importExt: ".js",
-    realFileExt: ".ts"
-  }
-]
-```
-
-### Path Transformation
-
-Convert between different path formats:
-
-```ts
-import { convertImportPaths } from "@reliverse/pathkit";
-
-await convertImportPaths({
-  baseDir: "./src",
-  fromType: "relative",    // "./components/Button"
-  toType: "alias",         // "@/components/Button"
-  aliasPrefix: "@/",
-  generateSourceMap: true
-});
-```
-
-### Extension Conversion
-
-```ts
-import { convertImportsExt } from "@reliverse/pathkit";
-
-// Basic usage - convert all relative imports to .ts
-await convertImportsExt({
-  targetDir: "./src",
-  extFrom: "none",
-  extTo: "ts"
-});
-
-// Convert .js to .ts
-await convertImportsExt({
-  targetDir: "./src",
-  extFrom: "js",
-  extTo: "ts"
-});
-
-// Remove extensions
-await convertImportsExt({
-  targetDir: "./src",
-  extFrom: "ts",
-  extTo: "none"
-});
-
-// Handle alias paths (e.g. @/components)
-await convertImportsExt({
-  targetDir: "./src",
-  extFrom: "none",
-  extTo: "ts",
-  alias: "@" // or "@/*"
-});
-```
-
-The function intelligently handles different import types:
-
-- ✅ Relative imports (`./file`, `../file`)
-- ✅ Alias imports (when alias is specified)
-- ✅ Package imports (`lodash`, `@scope/pkg`)
-- ✅ Node built-ins (`node:path`, `node:fs`)
-- ✅ URLs (`http://`, `https://`)
-- ✅ Already processed paths
-
-Features:
-
-- 🔄 Recursively processes directories
-- 🎯 Preserves package imports
-- 🛡️ Safe for code generation
-- 📝 Detailed change logging
-- 🎨 Supports custom aliases
-
-### Path Segment Manipulation
-
-Manipulate path segments in import statements:
-
-```ts
-import { 
-  stripPathSegments,
-  stripPathSegmentsInDirectory,
-  attachPathSegments,
-  attachPathSegmentsInDirectory 
-} from "@reliverse/pathkit";
-
-// Strip segments from a path
-stripPathSegments("src/components/Button.tsx", 1);  // "components/Button.tsx"
-
-// Strip segments from imports in a directory
-await stripPathSegmentsInDirectory({
-  targetDir: "./src",
-  segmentsToStrip: 1,
-  alias: "@"  // Optional: preserve alias prefix
-});
-
-// Attach segments to a path
-attachPathSegments("Button.tsx", "components", {
-  position: "before",    // "before" | "after"
-  normalize: true,       // Normalize the path
-  ensureSlash: true,     // Ensure slash between segments
-  preserveRoot: true,    // Preserve root in absolute paths
-  preserveAlias: "@"     // Optional: preserve alias prefix
-});
-
-// Attach segments to imports in a directory
-await attachPathSegmentsInDirectory({
-  targetDir: "./src",
-  segments: "components",
-  options: {
-    position: "before",
-    preserveAlias: "@"
-  }
-});
-```
-
-### Alias Resolution
-
-Advanced alias handling and resolution:
-
-```ts
-import { 
-  normalizeAliases,
-  resolveAlias,
-  reverseResolveAlias
-} from "@reliverse/pathkit";
-
-const aliases = { "@/": "/src/", "~/": "/home/user/" };
-
-// Normalize alias config
-console.log(normalizeAliases(aliases));
-
-// Resolve alias to absolute path
-console.log(resolveAlias("@/components", aliases));  // "/src/components"
-
-// Convert absolute path back to alias
-console.log(reverseResolveAlias("/src/utils", aliases));  // "@/utils"
-```
-
-```ts
-import { 
-  normalizeAliases,
-  resolveAlias,
-  reverseResolveAlias,
-  findAliasMatch 
-} from "@reliverse/pathkit";
-
-// Normalize and optimize alias configurations
-const aliases = {
-  "@/": "/src/",
-  "~/": "/home/user/",
-  "@/components/": "/src/components/"  // Nested alias
-};
-const normalized = normalizeAliases(aliases);
-
-// Resolve aliased paths
-resolveAlias("@/components/Button", aliases);  // "/src/components/Button"
-
-// Convert absolute paths back to aliases
-reverseResolveAlias("/src/utils", aliases);   // ["@/utils"]
-
-// Find matching alias in tsconfig-style paths
-const paths = {
-  "@/*": ["./src/*"],
-  "~/*": ["./home/*"]
-};
-findAliasMatch("@/components/Button", paths);
-```
-
-### Path Conversion
-
-Convert between different path formats:
-
-```ts
-import { 
-  convertStringAliasRelative,
-  convertImportsAliasToRelative 
-} from "@reliverse/pathkit";
-
-// Convert a single aliased path to relative
-await convertStringAliasRelative({
-  importPath: "@/components/Button",
-  importerFile: "src/pages/Home.tsx",
-  pathPattern: "@/*",
-  targetDir: "src"
-});
-
-// Convert all aliased imports to relative in a directory
-await convertImportsAliasToRelative({
-  targetDir: "./src",
-  aliasToReplace: "@",
-  pathExtFilter: "js-ts-none"  // "js" | "ts" | "none" | "js-ts-none"
-});
-```
-
-### Platform-Specific Features
-
-Handle platform-specific path operations:
-
-```ts
-import { posix, win32 } from "@reliverse/pathkit";
-
-// Use platform-specific path handling
-const path = process.platform === "win32" ? win32 : posix;
-
-// Windows-specific features
-win32.toNamespacedPath("C:\\path\\to\\file");  // "\\\\?\\C:\\path\\to\\file"
-win32.delimiter;  // ";"
-
-// POSIX-specific features
-posix.delimiter;  // ":"
-```
-
-### Utility Functions
-
-```ts
-import {
-  filename,               // Strip extension
-  normalizeQuotes,        // Standardize quote style
-  matchesGlob            // Test glob patterns
-} from "@reliverse/pathkit";
-
-console.log(filename("/path/component.vue"));     // "component"
-console.log(normalizeQuotes("import 'pkg'"));     // 'import "pkg"'
-console.log(matchesGlob("file.ts", "**/*.ts"));  // true
-```
-
-```ts
-import { 
-  filename,
-  normalizeWindowsPath,
-  replaceAllInString 
-} from "@reliverse/pathkit";
-
-// Get filename without extension
-filename("/path/to/file.ts");  // "file"
-
-// Normalize Windows paths
-normalizeWindowsPath("C:\\path\\to\\file");  // "C:/path/to/file"
-
-// Replace strings while tracking position
-replaceAllInString("import x from 'y'", "'y'", "'z'");
-```
-
-### Supported File Extensions
-
-The library supports the following file extensions by default:
-
-```ts
-const EXTENSIONS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"];
-```
-
-### Type Definitions
-
-```ts
-type PathExtFilter = "js" | "ts" | "none" | "js-ts-none";
-type ImportExtType = "js" | "ts" | "none";
-```
-
-## Use Cases / Ideal For
-
-- 🛠️ **CLI tools**
-- 🌍 **Cross‑platform dev environments**
-- 🔄 **Bundlers, linters, compilers**
-- 🏗️ **Framework & library authors**
-- 📜 **Scripts / test runners**
-- …anywhere file‑paths roam!
-
-## Examples & Contributing
-
-```bash
-git clone https://github.com/reliverse/pathkit.git
-cd pathkit
-bun install
-bun dev
-```
-
-Bug reports & PRs are warmly welcome—come on in!
-
-## Related
-
-- [`@reliverse/rempts`](https://npmjs.com/package/@reliverse/rempts) – Terminal Prompts Engine
-
-## Community
-
-- ⭐ **Star** the repo if this helped you.
-- 💖 **Sponsor** [@blefnk](https://github.com/sponsors/blefnk) to keep the lights on.
-- 💬 **Chat** with us on [Discord](https://discord.gg/Pb8uKbwpsJ).
-
-## License
-
-[MIT](LICENSE) © [Nazar Kornienko (blefnk)](https://github.com/blefnk), [Reliverse](https://github.com/reliverse)
-
-## Badges
-
-[![npm](https://img.shields.io/npm/v/@reliverse/pathkit?label=npm%20v)](https://npmjs.com/package/@reliverse/pathkit)
-[![downloads](https://img.shields.io/npm/dm/@reliverse/pathkit.svg?color=brightgreen)](https://npmjs.com/package/@reliverse/pathkit)
-[![typescript](https://img.shields.io/badge/typed-%E2%9C%85-blue)](https://github.com/reliverse/pathkit)
-[![license](https://img.shields.io/npm/l/@reliverse/pathkit.svg)](LICENSE)