shell-dsl 0.0.31 → 0.0.33

package/README.md

@@ -36,6 +36,7 @@ bun add shell-dsl memfs
 - **Automatic escaping** — Interpolated values are escaped by default for safety
 - **POSIX-inspired syntax** — Pipes, redirects, control flow operators, and more
 - **Streaming pipelines** — Commands communicate via async iteration
+- **Version control** — Built-in VCS with commits, branches, checkout, and diffs on any virtual filesystem
 - **TypeScript-first** — Full type definitions included
 
 ## Getting Started
@@ -564,7 +565,7 @@ import { echo, cat, grep, wc, cp, mv, touch, tee, tree, find, sed, awk, cut } fr
 | `mv` | Move/rename files/directories (`-n` no-clobber) |
 | `touch` | Create empty files or update timestamps (`-c` no-create) |
 | `tee` | Duplicate stdin to stdout and files (`-a` append) |
-| `tree` | Display directory structure as tree (`-a` all, `-d` dirs only, `-L <n>` depth) |
+| `tree` | Display directory structure as tree (`-a` all, `-d` dirs only, `-L <n>` depth, `-I <pattern>` ignore, `--prune` remove empty dirs) |
 | `find` | Search for files (`-name`, `-iname`, `-type f\|d`, `-maxdepth`, `-mindepth`) |
 | `sed` | Stream editor (`s///`, `d`, `p`, `-n`, `-e`) |
 | `awk` | Pattern scanning (`{print $1}`, `-F`, `NF`, `NR`) |
@@ -745,6 +746,109 @@ const fs = new FileSystem("/", {}, createWebUnderlyingFS(root));
 ```
 
 
+## Version Control
+
+`VersionControlSystem` adds git-like version control to any `VirtualFS`. It tracks changes as diffs, supports branching, and stores metadata in a `.vcs` directory.
+
+```ts
+import { VersionControlSystem, createVirtualFS } from "shell-dsl";
+import { createFsFromVolume, Volume } from "memfs";
+
+const vol = new Volume();
+vol.fromJSON({
+  "/project/src/index.ts": 'console.log("hello")',
+  "/project/README.md": "# My Project",
+});
+const fs = createVirtualFS(createFsFromVolume(vol));
+
+const vcs = new VersionControlSystem({
+  fs,
+  path: "/project",
+});
+```
+
+### Committing Changes
+
+```ts
+// Commit all pending changes
+const rev = await vcs.commit("initial commit");
+
+// Selective commit with glob patterns (relative to root path)
+await vcs.commit("update src only", { paths: ["/src/**"] });
+```
+
+### Checking Status
+
+`status()` returns a `DiffEntry[]` describing uncommitted changes:
+
+```ts
+const changes = await vcs.status();
+for (const entry of changes) {
+  console.log(entry.type, entry.path); // "add" | "modify" | "delete"
+}
+```
+
+### Checkout
+
+```ts
+// Checkout a specific revision (errors if working tree is dirty)
+await vcs.checkout(1);
+
+// Force checkout, discarding uncommitted changes
+await vcs.checkout(1, { force: true });
+
+// Partial checkout — restore specific files without changing HEAD
+await vcs.checkout(1, { paths: ["/src/index.ts", "/**/*.txt"] });
+```
+
+### Branching
+
+```ts
+// Create a branch at HEAD
+await vcs.branch("feature");
+
+// Switch to a branch
+await vcs.checkout("feature");
+
+// List all branches
+const branches = await vcs.branches();
+// [{ name: "main", revision: 1, current: false },
+//  { name: "feature", revision: 1, current: true }]
+```
+
+### History and Diffs
+
+```ts
+// Revision history
+const entries = await vcs.log();
+const filtered = await vcs.log({ path: "src/index.ts", limit: 10 });
+
+// Diff between two revisions
+const diff = await vcs.diff(1, 2);
+for (const entry of diff) {
+  console.log(entry.type, entry.path); // "add" | "modify" | "delete"
+}
+
+// Current HEAD info
+const head = await vcs.head();
+// { branch: "main", revision: 2 }
+```
+
+### Separate VCS Storage
+
+By default, metadata lives in `{path}/.vcs`. You can store it on a different filesystem:
+
+```ts
+const vcs = new VersionControlSystem({
+  fs: workingTreeFs,
+  path: "/project",
+  vcsPath: {
+    fs: metadataFs,          // different VirtualFS instance
+    path: "/meta/.vcs",      // custom location
+  },
+});
+```
+
 ## Low-Level API
 
 For advanced use cases (custom tooling, AST inspection):
@@ -809,6 +913,11 @@ import type {
   Permission,
   PermissionRules,
   UnderlyingFS,
+  VCSConfig,
+  Revision,
+  DiffEntry,
+  LogEntry,
+  BranchInfo,
 } from "shell-dsl";
 ```
 

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "shell-dsl",
-  "version": "0.0.31",
+  "version": "0.0.33",
   "type": "commonjs"
 }

package/dist/cjs/src/commands/mv/mv.cjs

@@ -43,6 +43,7 @@ __export(exports_mv, {
 });
 module.exports = __toCommonJS(exports_mv);
 var import_flag_parser = require("../../utils/flag-parser.cjs");
+var import_special_files = require("../../fs/special-files.cjs");
 var spec = {
   name: "mv",
   flags: [
@@ -88,6 +89,11 @@ var mv = async (ctx) => {
     try {
       await ctx.fs.stat(srcPath);
       const finalDest = destIsDir ? ctx.fs.resolve(destPath, ctx.fs.basename(srcPath)) : destPath;
+      if (import_special_files.isDevNullPath(srcPath) || import_special_files.isDevNullPath(finalDest)) {
+        await ctx.stderr.writeText(`mv: cannot move to or from special file '${import_special_files.DEV_NULL_PATH}'
+`);
+        return 1;
+      }
       if (noClobber) {
         const exists = await ctx.fs.exists(finalDest);
         if (exists)
@@ -132,4 +138,4 @@ async function moveDirectory(ctx, src, dest, noClobber) {
   await ctx.fs.rm(src, { recursive: true });
 }
 
-//# debugId=54B51AB3A551E2C964756E2164756E21
+//# debugId=C4CE62A58C3EA07364756E2164756E21

package/dist/cjs/src/commands/mv/mv.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../../src/commands/mv/mv.ts"],
   "sourcesContent": [
-    "import type { Command } from \"../../types.cjs\";\nimport { createFlagParser, type FlagDefinition } from \"../../utils/flag-parser.cjs\";\n\ninterface MvFlags {\n  noClobber: boolean;\n}\n\nconst spec = {\n  name: \"mv\",\n  flags: [\n    { short: \"n\", long: \"no-clobber\" },\n    { short: \"f\", long: \"force\" },\n  ] as FlagDefinition[],\n  usage: \"mv [-nf] source ... dest\",\n};\n\nconst defaults: MvFlags = { noClobber: false };\n\nconst handler = (flags: MvFlags, flag: FlagDefinition) => {\n  if (flag.short === \"n\") flags.noClobber = true;\n  // -f is default behavior, so we don't need to do anything\n};\n\nconst parser = createFlagParser(spec, defaults, handler);\n\nexport const mv: Command = async (ctx) => {\n  const result = parser.parse(ctx.args);\n\n  if (result.error) {\n    await parser.writeError(result.error, ctx.stderr);\n    return 1;\n  }\n\n  const { noClobber } = result.flags;\n  const paths = result.args;\n\n  if (paths.length < 2) {\n    await ctx.stderr.writeText(\"mv: missing destination file operand\\n\");\n    return 1;\n  }\n\n  const sources = paths.slice(0, -1);\n  const dest = paths[paths.length - 1]!;\n  const destPath = ctx.fs.resolve(ctx.cwd, dest);\n\n  // Check if destination is a directory\n  let destIsDir = false;\n  try {\n    const stat = await ctx.fs.stat(destPath);\n    destIsDir = stat.isDirectory();\n  } catch {\n    // Destination doesn't exist\n  }\n\n  // If multiple sources, dest must be a directory\n  if (sources.length > 1 && !destIsDir) {\n    await ctx.stderr.writeText(`mv: target '${dest}' is not a directory\\n`);\n    return 1;\n  }\n\n  for (const source of sources) {\n    const srcPath = ctx.fs.resolve(ctx.cwd, source);\n\n    try {\n      // Check source exists\n      await ctx.fs.stat(srcPath);\n\n      // Determine final destination path\n      const finalDest = destIsDir\n        ? ctx.fs.resolve(destPath, ctx.fs.basename(srcPath))\n        : destPath;\n\n      // Check if dest exists and noClobber\n      if (noClobber) {\n        const exists = await ctx.fs.exists(finalDest);\n        if (exists) continue; // Skip silently\n      }\n\n      // Move: copy then delete\n      const srcStat = await ctx.fs.stat(srcPath);\n      if (srcStat.isDirectory()) {\n        await moveDirectory(ctx, srcPath, finalDest, noClobber);\n      } else {\n        const content = await ctx.fs.readFile(srcPath);\n        await ctx.fs.writeFile(finalDest, content);\n        await ctx.fs.rm(srcPath);\n      }\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      await ctx.stderr.writeText(`mv: cannot stat '${source}': ${message}\\n`);\n      return 1;\n    }\n  }\n\n  return 0;\n};\n\nasync function moveDirectory(\n  ctx: Parameters<Command>[0],\n  src: string,\n  dest: string,\n  noClobber: boolean\n): Promise<void> {\n  // Create destination directory\n  await ctx.fs.mkdir(dest, { recursive: true });\n\n  // Read source directory contents\n  const entries = await ctx.fs.readdir(src);\n\n  for (const entry of entries) {\n    const srcPath = ctx.fs.resolve(src, entry);\n    const destPath = ctx.fs.resolve(dest, entry);\n\n    const stat = await ctx.fs.stat(srcPath);\n\n    if (stat.isDirectory()) {\n      await moveDirectory(ctx, srcPath, destPath, noClobber);\n    } else {\n      if (noClobber) {\n        const exists = await ctx.fs.exists(destPath);\n        if (exists) continue;\n      }\n      const content = await ctx.fs.readFile(srcPath);\n      await ctx.fs.writeFile(destPath, content);\n    }\n  }\n\n  // Remove source directory after copying\n  await ctx.fs.rm(src, { recursive: true });\n}\n"
+    "import type { Command } from \"../../types.cjs\";\nimport { createFlagParser, type FlagDefinition } from \"../../utils/flag-parser.cjs\";\nimport { DEV_NULL_PATH, isDevNullPath } from \"../../fs/special-files.cjs\";\n\ninterface MvFlags {\n  noClobber: boolean;\n}\n\nconst spec = {\n  name: \"mv\",\n  flags: [\n    { short: \"n\", long: \"no-clobber\" },\n    { short: \"f\", long: \"force\" },\n  ] as FlagDefinition[],\n  usage: \"mv [-nf] source ... dest\",\n};\n\nconst defaults: MvFlags = { noClobber: false };\n\nconst handler = (flags: MvFlags, flag: FlagDefinition) => {\n  if (flag.short === \"n\") flags.noClobber = true;\n  // -f is default behavior, so we don't need to do anything\n};\n\nconst parser = createFlagParser(spec, defaults, handler);\n\nexport const mv: Command = async (ctx) => {\n  const result = parser.parse(ctx.args);\n\n  if (result.error) {\n    await parser.writeError(result.error, ctx.stderr);\n    return 1;\n  }\n\n  const { noClobber } = result.flags;\n  const paths = result.args;\n\n  if (paths.length < 2) {\n    await ctx.stderr.writeText(\"mv: missing destination file operand\\n\");\n    return 1;\n  }\n\n  const sources = paths.slice(0, -1);\n  const dest = paths[paths.length - 1]!;\n  const destPath = ctx.fs.resolve(ctx.cwd, dest);\n\n  // Check if destination is a directory\n  let destIsDir = false;\n  try {\n    const stat = await ctx.fs.stat(destPath);\n    destIsDir = stat.isDirectory();\n  } catch {\n    // Destination doesn't exist\n  }\n\n  // If multiple sources, dest must be a directory\n  if (sources.length > 1 && !destIsDir) {\n    await ctx.stderr.writeText(`mv: target '${dest}' is not a directory\\n`);\n    return 1;\n  }\n\n  for (const source of sources) {\n    const srcPath = ctx.fs.resolve(ctx.cwd, source);\n\n    try {\n      // Check source exists\n      await ctx.fs.stat(srcPath);\n\n      // Determine final destination path\n      const finalDest = destIsDir\n        ? ctx.fs.resolve(destPath, ctx.fs.basename(srcPath))\n        : destPath;\n\n      if (isDevNullPath(srcPath) || isDevNullPath(finalDest)) {\n        await ctx.stderr.writeText(`mv: cannot move to or from special file '${DEV_NULL_PATH}'\\n`);\n        return 1;\n      }\n\n      // Check if dest exists and noClobber\n      if (noClobber) {\n        const exists = await ctx.fs.exists(finalDest);\n        if (exists) continue; // Skip silently\n      }\n\n      // Move: copy then delete\n      const srcStat = await ctx.fs.stat(srcPath);\n      if (srcStat.isDirectory()) {\n        await moveDirectory(ctx, srcPath, finalDest, noClobber);\n      } else {\n        const content = await ctx.fs.readFile(srcPath);\n        await ctx.fs.writeFile(finalDest, content);\n        await ctx.fs.rm(srcPath);\n      }\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      await ctx.stderr.writeText(`mv: cannot stat '${source}': ${message}\\n`);\n      return 1;\n    }\n  }\n\n  return 0;\n};\n\nasync function moveDirectory(\n  ctx: Parameters<Command>[0],\n  src: string,\n  dest: string,\n  noClobber: boolean\n): Promise<void> {\n  // Create destination directory\n  await ctx.fs.mkdir(dest, { recursive: true });\n\n  // Read source directory contents\n  const entries = await ctx.fs.readdir(src);\n\n  for (const entry of entries) {\n    const srcPath = ctx.fs.resolve(src, entry);\n    const destPath = ctx.fs.resolve(dest, entry);\n\n    const stat = await ctx.fs.stat(srcPath);\n\n    if (stat.isDirectory()) {\n      await moveDirectory(ctx, srcPath, destPath, noClobber);\n    } else {\n      if (noClobber) {\n        const exists = await ctx.fs.exists(destPath);\n        if (exists) continue;\n      }\n      const content = await ctx.fs.readFile(srcPath);\n      await ctx.fs.writeFile(destPath, content);\n    }\n  }\n\n  // Remove source directory after copying\n  await ctx.fs.rm(src, { recursive: true });\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "54B51AB3A551E2C964756E2164756E21",
+  "mappings": "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",
+  "debugId": "C4CE62A58C3EA07364756E2164756E21",
   "names": []
 }

package/dist/cjs/src/commands/tree/tree.cjs

@@ -51,11 +51,19 @@ var spec = {
     { short: "d" },
     { short: "L", takesValue: true },
     { short: "I", takesValue: true },
-    { long: "dirsfirst" }
+    { long: "dirsfirst" },
+    { long: "prune" }
   ],
-  usage: "tree [-adI] [-L level] [-I pattern] [--dirsfirst] [directory ...]"
+  usage: "tree [-adI] [-L level] [-I pattern] [--dirsfirst] [--prune] [directory ...]"
+};
+var defaults = {
+  all: false,
+  directoriesOnly: false,
+  maxDepth: Infinity,
+  dirsfirst: true,
+  prune: false,
+  ignorePatterns: []
 };
-var defaults = { all: false, directoriesOnly: false, maxDepth: Infinity, dirsfirst: true, ignorePatterns: [] };
 var handlerResult = {};
 var handler = (flags, flag, value) => {
   if (flag.short === "a")
@@ -64,6 +72,8 @@ var handler = (flags, flag, value) => {
     flags.directoriesOnly = true;
   if (flag.long === "dirsfirst")
     flags.dirsfirst = true;
+  if (flag.long === "prune")
+    flags.prune = true;
   if (flag.short === "I" && value) {
     if (flags.ignorePatterns === defaults.ignorePatterns) {
       flags.ignorePatterns = [];
@@ -93,7 +103,7 @@ var tree = async (ctx) => {
     await ctx.stderr.writeText(handlerResult.error);
     return 1;
   }
-  const { all: showAll, directoriesOnly, maxDepth, ignorePatterns } = result.flags;
+  const { all: showAll, directoriesOnly, maxDepth, prune, ignorePatterns } = result.flags;
   const targetPath = result.args[0] ?? ".";
   if (maxDepth < 1) {
     await ctx.stderr.writeText(`tree: Invalid level, must be greater than 0
@@ -118,11 +128,14 @@ var tree = async (ctx) => {
   }
   let dirCount = 0;
   let fileCount = 0;
+  const entriesCache = new Map;
+  const visibleContentCache = new Map;
   await ctx.stdout.writeText(targetPath + `
 `);
-  async function printTree(path, prefix, depth) {
-    if (depth > maxDepth)
-      return;
+  async function getEntries(path) {
+    const cached = entriesCache.get(path);
+    if (cached)
+      return cached;
     let entries = await ctx.fs.readdir(path);
     if (!showAll) {
       entries = entries.filter((e) => !e.startsWith("."));
@@ -131,39 +144,63 @@ var tree = async (ctx) => {
       entries = entries.filter((e) => !ignorePatterns.some((p) => import_match_glob.matchGlob(p, e)));
     }
     entries.sort();
+    const resolvedEntries = [];
+    for (const name of entries) {
+      const entryPath = ctx.fs.resolve(path, name);
+      try {
+        const entryStat = await ctx.fs.stat(entryPath);
+        resolvedEntries.push({ name, path: entryPath, isDir: entryStat.isDirectory() });
+      } catch {}
+    }
+    entriesCache.set(path, resolvedEntries);
+    return resolvedEntries;
+  }
+  async function hasVisibleContent(path) {
+    const cached = visibleContentCache.get(path);
+    if (cached !== undefined)
+      return cached;
+    const entries = await getEntries(path);
+    for (const entry of entries) {
+      if (!entry.isDir) {
+        visibleContentCache.set(path, true);
+        return true;
+      }
+      if (await hasVisibleContent(entry.path)) {
+        visibleContentCache.set(path, true);
+        return true;
+      }
+    }
+    visibleContentCache.set(path, false);
+    return false;
+  }
+  async function printTree(path, prefix, depth) {
+    if (depth > maxDepth)
+      return;
+    const entries = await getEntries(path);
     const dirEntries = [];
     const fileEntries = [];
     for (const entry of entries) {
-      const entryPath = ctx.fs.resolve(path, entry);
-      try {
-        const entryStat = await ctx.fs.stat(entryPath);
-        if (entryStat.isDirectory()) {
-          dirEntries.push(entry);
-        } else {
-          fileEntries.push(entry);
+      if (entry.isDir) {
+        if (prune && !await hasVisibleContent(entry.path)) {
+          continue;
         }
-      } catch {}
+        dirEntries.push(entry);
+      } else {
+        fileEntries.push(entry);
+      }
     }
     const sortedEntries = directoriesOnly ? dirEntries : [...dirEntries, ...fileEntries];
     for (let i = 0;i < sortedEntries.length; i++) {
       const entry = sortedEntries[i];
       const isLast = i === sortedEntries.length - 1;
       const connector = isLast ? "└── " : "├── ";
-      const entryPath = ctx.fs.resolve(path, entry);
-      let isDir = false;
-      try {
-        const entryStat = await ctx.fs.stat(entryPath);
-        isDir = entryStat.isDirectory();
-      } catch {
-        continue;
-      }
-      await ctx.stdout.writeText(prefix + connector + entry + `
+      await ctx.stdout.writeText(prefix + connector + entry.name + `
 `);
-      if (isDir) {
+      if (entry.isDir) {
         dirCount++;
         if (depth < maxDepth) {
           const newPrefix = prefix + (isLast ? "    " : "│   ");
-          await printTree(entryPath, newPrefix, depth + 1);
+          await printTree(entry.path, newPrefix, depth + 1);
         }
       } else {
         fileCount++;
@@ -179,4 +216,4 @@ ${dirCount} ${dirWord}, ${fileCount} ${fileWord}
   return 0;
 };
 
-//# debugId=84C05E2FE694C09E64756E2164756E21
+//# debugId=F4832ADA9F283A9964756E2164756E21

package/dist/cjs/src/commands/tree/tree.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../../src/commands/tree/tree.ts"],
   "sourcesContent": [
-    "import type { Command } from \"../../types.cjs\";\nimport { createFlagParser, type FlagDefinition } from \"../../utils/flag-parser.cjs\";\nimport { matchGlob } from \"../../utils/match-glob.cjs\";\n\ninterface TreeFlags {\n  all: boolean;\n  directoriesOnly: boolean;\n  maxDepth: number;\n  dirsfirst: boolean;\n  ignorePatterns: string[];\n}\n\nconst spec = {\n  name: \"tree\",\n  flags: [\n    { short: \"a\", long: \"all\" },\n    { short: \"d\" },\n    { short: \"L\", takesValue: true },\n    { short: \"I\", takesValue: true },\n    { long: \"dirsfirst\" },\n  ] as FlagDefinition[],\n  usage: \"tree [-adI] [-L level] [-I pattern] [--dirsfirst] [directory ...]\",\n};\n\nconst defaults: TreeFlags = { all: false, directoriesOnly: false, maxDepth: Infinity, dirsfirst: true, ignorePatterns: [] };\n\ninterface HandlerResult {\n  error?: string;\n}\n\nlet handlerResult: HandlerResult = {};\n\nconst handler = (flags: TreeFlags, flag: FlagDefinition, value?: string) => {\n  if (flag.short === \"a\") flags.all = true;\n  if (flag.short === \"d\") flags.directoriesOnly = true;\n  if (flag.long === \"dirsfirst\") flags.dirsfirst = true;\n  if (flag.short === \"I\" && value) {\n    if (flags.ignorePatterns === defaults.ignorePatterns) {\n      flags.ignorePatterns = [];\n    }\n    flags.ignorePatterns.push(...value.split(\"|\"));\n  }\n  if (flag.short === \"L\" && value) {\n    const depth = parseInt(value, 10);\n    if (isNaN(depth) || !/^\\d+$/.test(value)) {\n      handlerResult.error = `tree: -L option requires a numeric argument\\nusage: ${spec.usage}\\n`;\n    } else {\n      flags.maxDepth = depth;\n    }\n  }\n};\n\nconst parser = createFlagParser(spec, defaults, handler);\n\nexport const tree: Command = async (ctx) => {\n  // Reset handler result for each invocation\n  handlerResult = {};\n\n  const result = parser.parse(ctx.args);\n\n  if (result.error) {\n    await parser.writeError(result.error, ctx.stderr);\n    return 1;\n  }\n\n  if (handlerResult.error) {\n    await ctx.stderr.writeText(handlerResult.error);\n    return 1;\n  }\n\n  const { all: showAll, directoriesOnly, maxDepth, ignorePatterns } = result.flags;\n  const targetPath = result.args[0] ?? \".\";\n\n  // Validate maxDepth\n  if (maxDepth < 1) {\n    await ctx.stderr.writeText(\"tree: Invalid level, must be greater than 0\\n\");\n    return 1;\n  }\n\n  const resolvedPath = ctx.fs.resolve(ctx.cwd, targetPath);\n\n  // Check if path exists\n  let stat;\n  try {\n    stat = await ctx.fs.stat(resolvedPath);\n  } catch {\n    await ctx.stderr.writeText(`tree: ${targetPath}: No such file or directory\\n`);\n    return 1;\n  }\n\n  // If it's a file, just print the filename\n  if (stat.isFile()) {\n    await ctx.stdout.writeText(targetPath + \"\\n\\n0 directories, 1 file\\n\");\n    return 0;\n  }\n\n  let dirCount = 0;\n  let fileCount = 0;\n\n  // Print root\n  await ctx.stdout.writeText(targetPath + \"\\n\");\n\n  // Recursive function to build tree\n  async function printTree(path: string, prefix: string, depth: number): Promise<void> {\n    if (depth > maxDepth) return;\n\n    let entries = await ctx.fs.readdir(path);\n\n    // Filter hidden files unless -a\n    if (!showAll) {\n      entries = entries.filter((e) => !e.startsWith(\".\"));\n    }\n\n    // Filter by -I ignore patterns\n    if (ignorePatterns.length > 0) {\n      entries = entries.filter((e) => !ignorePatterns.some((p) => matchGlob(p, e)));\n    }\n\n    // Sort entries\n    entries.sort();\n\n    // Separate dirs and files, dirs first\n    const dirEntries: string[] = [];\n    const fileEntries: string[] = [];\n\n    for (const entry of entries) {\n      const entryPath = ctx.fs.resolve(path, entry);\n      try {\n        const entryStat = await ctx.fs.stat(entryPath);\n        if (entryStat.isDirectory()) {\n          dirEntries.push(entry);\n        } else {\n          fileEntries.push(entry);\n        }\n      } catch {\n        // Skip entries we can't stat\n      }\n    }\n\n    // Combine: directories first, then files (unless directoriesOnly)\n    const sortedEntries = directoriesOnly\n      ? dirEntries\n      : [...dirEntries, ...fileEntries];\n\n    for (let i = 0; i < sortedEntries.length; i++) {\n      const entry = sortedEntries[i]!;\n      const isLast = i === sortedEntries.length - 1;\n      const connector = isLast ? \"└── \" : \"├── \";\n      const entryPath = ctx.fs.resolve(path, entry);\n\n      let isDir = false;\n      try {\n        const entryStat = await ctx.fs.stat(entryPath);\n        isDir = entryStat.isDirectory();\n      } catch {\n        continue;\n      }\n\n      await ctx.stdout.writeText(prefix + connector + entry + \"\\n\");\n\n      if (isDir) {\n        dirCount++;\n        if (depth < maxDepth) {\n          const newPrefix = prefix + (isLast ? \"    \" : \"│   \");\n          await printTree(entryPath, newPrefix, depth + 1);\n        }\n      } else {\n        fileCount++;\n      }\n    }\n  }\n\n  await printTree(resolvedPath, \"\", 1);\n\n  // Print summary\n  const dirWord = dirCount === 1 ? \"directory\" : \"directories\";\n  const fileWord = fileCount === 1 ? \"file\" : \"files\";\n  await ctx.stdout.writeText(`\\n${dirCount} ${dirWord}, ${fileCount} ${fileWord}\\n`);\n\n  return 0;\n};\n"
+    "import type { Command } from \"../../types.cjs\";\nimport { createFlagParser, type FlagDefinition } from \"../../utils/flag-parser.cjs\";\nimport { matchGlob } from \"../../utils/match-glob.cjs\";\n\ninterface TreeFlags {\n  all: boolean;\n  directoriesOnly: boolean;\n  maxDepth: number;\n  dirsfirst: boolean;\n  prune: boolean;\n  ignorePatterns: string[];\n}\n\nconst spec = {\n  name: \"tree\",\n  flags: [\n    { short: \"a\", long: \"all\" },\n    { short: \"d\" },\n    { short: \"L\", takesValue: true },\n    { short: \"I\", takesValue: true },\n    { long: \"dirsfirst\" },\n    { long: \"prune\" },\n  ] as FlagDefinition[],\n  usage: \"tree [-adI] [-L level] [-I pattern] [--dirsfirst] [--prune] [directory ...]\",\n};\n\nconst defaults: TreeFlags = {\n  all: false,\n  directoriesOnly: false,\n  maxDepth: Infinity,\n  dirsfirst: true,\n  prune: false,\n  ignorePatterns: [],\n};\n\ninterface HandlerResult {\n  error?: string;\n}\n\nlet handlerResult: HandlerResult = {};\n\nconst handler = (flags: TreeFlags, flag: FlagDefinition, value?: string) => {\n  if (flag.short === \"a\") flags.all = true;\n  if (flag.short === \"d\") flags.directoriesOnly = true;\n  if (flag.long === \"dirsfirst\") flags.dirsfirst = true;\n  if (flag.long === \"prune\") flags.prune = true;\n  if (flag.short === \"I\" && value) {\n    if (flags.ignorePatterns === defaults.ignorePatterns) {\n      flags.ignorePatterns = [];\n    }\n    flags.ignorePatterns.push(...value.split(\"|\"));\n  }\n  if (flag.short === \"L\" && value) {\n    const depth = parseInt(value, 10);\n    if (isNaN(depth) || !/^\\d+$/.test(value)) {\n      handlerResult.error = `tree: -L option requires a numeric argument\\nusage: ${spec.usage}\\n`;\n    } else {\n      flags.maxDepth = depth;\n    }\n  }\n};\n\nconst parser = createFlagParser(spec, defaults, handler);\n\nexport const tree: Command = async (ctx) => {\n  // Reset handler result for each invocation\n  handlerResult = {};\n\n  const result = parser.parse(ctx.args);\n\n  if (result.error) {\n    await parser.writeError(result.error, ctx.stderr);\n    return 1;\n  }\n\n  if (handlerResult.error) {\n    await ctx.stderr.writeText(handlerResult.error);\n    return 1;\n  }\n\n  const { all: showAll, directoriesOnly, maxDepth, prune, ignorePatterns } = result.flags;\n  const targetPath = result.args[0] ?? \".\";\n\n  // Validate maxDepth\n  if (maxDepth < 1) {\n    await ctx.stderr.writeText(\"tree: Invalid level, must be greater than 0\\n\");\n    return 1;\n  }\n\n  const resolvedPath = ctx.fs.resolve(ctx.cwd, targetPath);\n\n  // Check if path exists\n  let stat;\n  try {\n    stat = await ctx.fs.stat(resolvedPath);\n  } catch {\n    await ctx.stderr.writeText(`tree: ${targetPath}: No such file or directory\\n`);\n    return 1;\n  }\n\n  // If it's a file, just print the filename\n  if (stat.isFile()) {\n    await ctx.stdout.writeText(targetPath + \"\\n\\n0 directories, 1 file\\n\");\n    return 0;\n  }\n\n  let dirCount = 0;\n  let fileCount = 0;\n  const entriesCache = new Map<string, { name: string; path: string; isDir: boolean }[]>();\n  const visibleContentCache = new Map<string, boolean>();\n\n  // Print root\n  await ctx.stdout.writeText(targetPath + \"\\n\");\n\n  async function getEntries(path: string): Promise<{ name: string; path: string; isDir: boolean }[]> {\n    const cached = entriesCache.get(path);\n    if (cached) return cached;\n\n    let entries = await ctx.fs.readdir(path);\n\n    // Filter hidden files unless -a\n    if (!showAll) {\n      entries = entries.filter((e) => !e.startsWith(\".\"));\n    }\n\n    // Filter by -I ignore patterns\n    if (ignorePatterns.length > 0) {\n      entries = entries.filter((e) => !ignorePatterns.some((p) => matchGlob(p, e)));\n    }\n\n    // Sort entries\n    entries.sort();\n\n    const resolvedEntries: { name: string; path: string; isDir: boolean }[] = [];\n\n    for (const name of entries) {\n      const entryPath = ctx.fs.resolve(path, name);\n      try {\n        const entryStat = await ctx.fs.stat(entryPath);\n        resolvedEntries.push({ name, path: entryPath, isDir: entryStat.isDirectory() });\n      } catch {\n        // Skip entries we can't stat\n      }\n    }\n\n    entriesCache.set(path, resolvedEntries);\n    return resolvedEntries;\n  }\n\n  async function hasVisibleContent(path: string): Promise<boolean> {\n    const cached = visibleContentCache.get(path);\n    if (cached !== undefined) return cached;\n\n    const entries = await getEntries(path);\n\n    for (const entry of entries) {\n      if (!entry.isDir) {\n        visibleContentCache.set(path, true);\n        return true;\n      }\n\n      if (await hasVisibleContent(entry.path)) {\n        visibleContentCache.set(path, true);\n        return true;\n      }\n    }\n\n    visibleContentCache.set(path, false);\n    return false;\n  }\n\n  // Recursive function to build tree\n  async function printTree(path: string, prefix: string, depth: number): Promise<void> {\n    if (depth > maxDepth) return;\n\n    const entries = await getEntries(path);\n\n    // Separate dirs and files, dirs first\n    const dirEntries: { name: string; path: string; isDir: boolean }[] = [];\n    const fileEntries: { name: string; path: string; isDir: boolean }[] = [];\n\n    for (const entry of entries) {\n      if (entry.isDir) {\n        if (prune && !(await hasVisibleContent(entry.path))) {\n          continue;\n        }\n        dirEntries.push(entry);\n      } else {\n        fileEntries.push(entry);\n      }\n    }\n\n    // Combine: directories first, then files (unless directoriesOnly)\n    const sortedEntries = directoriesOnly\n      ? dirEntries\n      : [...dirEntries, ...fileEntries];\n\n    for (let i = 0; i < sortedEntries.length; i++) {\n      const entry = sortedEntries[i]!;\n      const isLast = i === sortedEntries.length - 1;\n      const connector = isLast ? \"└── \" : \"├── \";\n\n      await ctx.stdout.writeText(prefix + connector + entry.name + \"\\n\");\n\n      if (entry.isDir) {\n        dirCount++;\n        if (depth < maxDepth) {\n          const newPrefix = prefix + (isLast ? \"    \" : \"│   \");\n          await printTree(entry.path, newPrefix, depth + 1);\n        }\n      } else {\n        fileCount++;\n      }\n    }\n  }\n\n  await printTree(resolvedPath, \"\", 1);\n\n  // Print summary\n  const dirWord = dirCount === 1 ? \"directory\" : \"directories\";\n  const fileWord = fileCount === 1 ? \"file\" : \"files\";\n  await ctx.stdout.writeText(`\\n${dirCount} ${dirWord}, ${fileCount} ${fileWord}\\n`);\n\n  return 0;\n};\n"
   ],
-  "mappings": "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",
-  "debugId": "84C05E2FE694C09E64756E2164756E21",
+  "mappings": "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",
+  "debugId": "F4832ADA9F283A9964756E2164756E21",
   "names": []
 }

package/dist/cjs/src/fs/memfs-adapter.cjs

@@ -68,21 +68,29 @@ __export(exports_memfs_adapter, {
 module.exports = __toCommonJS(exports_memfs_adapter);
 var pathModule = __toESM(require("path"));
 var import_glob = require("../utils/glob.cjs");
+var import_special_files = require("./special-files.cjs");
 function createVirtualFS(memfs) {
   const { promises: fs } = memfs;
   return {
     readFile: async (path, encoding) => {
-      if (path === "/dev/null")
-        return encoding ? "" : Buffer.alloc(0);
+      const specialContent = import_special_files.readSpecialFile(path, encoding);
+      if (specialContent !== undefined)
+        return specialContent;
       const content = await fs.readFile(path);
       const buf = Buffer.from(content);
       return encoding ? buf.toString(encoding) : buf;
     },
     async readdir(path) {
+      const specialError = import_special_files.getSpecialPathError(path, "readdir");
+      if (specialError)
+        throw specialError;
       const entries = await fs.readdir(path);
       return entries.map(String);
     },
     async stat(path) {
+      const specialStat = import_special_files.statSpecialFile(path);
+      if (specialStat)
+        return specialStat;
       const stats = await fs.stat(path);
       return {
         isFile: () => stats.isFile(),
@@ -92,6 +100,9 @@ function createVirtualFS(memfs) {
       };
     },
     async exists(path) {
+      const specialExists = import_special_files.existsSpecialFile(path);
+      if (specialExists !== undefined)
+        return specialExists;
       try {
         await fs.stat(path);
         return true;
@@ -100,15 +111,27 @@ function createVirtualFS(memfs) {
       }
     },
     async writeFile(path, data) {
+      if (import_special_files.discardsSpecialFileWrites(path)) {
+        return;
+      }
       await fs.writeFile(path, data);
     },
     async appendFile(path, data) {
+      if (import_special_files.discardsSpecialFileWrites(path)) {
+        return;
+      }
       await fs.appendFile(path, data);
     },
     async mkdir(path, opts) {
+      const specialError = import_special_files.getSpecialPathError(path, "mkdir");
+      if (specialError)
+        throw specialError;
       await fs.mkdir(path, opts);
     },
     async rm(path, opts) {
+      const specialError = import_special_files.getSpecialPathError(path, "rm");
+      if (specialError)
+        throw specialError;
       try {
         const stats = await fs.stat(path);
         if (stats.isDirectory()) {
@@ -141,4 +164,4 @@ function createVirtualFS(memfs) {
   };
 }
 
-//# debugId=60E8B0C48B1EE27B64756E2164756E21
+//# debugId=F25975C12E3475B564756E2164756E21

package/dist/cjs/src/fs/memfs-adapter.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/fs/memfs-adapter.ts"],
   "sourcesContent": [
-    "import type { IFs } from \"memfs\";\nimport type { VirtualFS, FileStat } from \"../types.cjs\";\nimport * as pathModule from \"path\";\nimport { globVirtualFS } from \"../utils/glob.cjs\";\n\nexport function createVirtualFS(memfs: IFs): VirtualFS {\n  const { promises: fs } = memfs;\n\n  return {\n    readFile: (async (path: string, encoding?: BufferEncoding): Promise<Buffer | string> => {\n      if (path === \"/dev/null\") return encoding ? \"\" : Buffer.alloc(0);\n      const content = await fs.readFile(path);\n      const buf = Buffer.from(content);\n      return encoding ? buf.toString(encoding) : buf;\n    }) as VirtualFS[\"readFile\"],\n\n    async readdir(path: string): Promise<string[]> {\n      const entries = await fs.readdir(path);\n      return entries.map(String);\n    },\n\n    async stat(path: string): Promise<FileStat> {\n      const stats = await fs.stat(path);\n      return {\n        isFile: () => stats.isFile(),\n        isDirectory: () => stats.isDirectory(),\n        size: Number(stats.size),\n        mtime: new Date(stats.mtime),\n      };\n    },\n\n    async exists(path: string): Promise<boolean> {\n      try {\n        await fs.stat(path);\n        return true;\n      } catch {\n        return false;\n      }\n    },\n\n    async writeFile(path: string, data: Buffer | string): Promise<void> {\n      await fs.writeFile(path, data);\n    },\n\n    async appendFile(path: string, data: Buffer | string): Promise<void> {\n      await fs.appendFile(path, data);\n    },\n\n    async mkdir(path: string, opts?: { recursive?: boolean }): Promise<void> {\n      await fs.mkdir(path, opts);\n    },\n\n    async rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n      try {\n        const stats = await fs.stat(path);\n        if (stats.isDirectory()) {\n          await fs.rmdir(path, { recursive: opts?.recursive });\n        } else {\n          await fs.unlink(path);\n        }\n      } catch (err) {\n        if (!opts?.force) throw err;\n      }\n    },\n\n    resolve(...paths: string[]): string {\n      return pathModule.resolve(...paths);\n    },\n\n    dirname(path: string): string {\n      return pathModule.dirname(path);\n    },\n\n    basename(path: string): string {\n      return pathModule.basename(path);\n    },\n\n    async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n      const cwd = opts?.cwd ?? \"/\";\n      return globVirtualFS(\n        {\n          readdir: (filePath: string) => this.readdir(filePath),\n          stat: (filePath: string) => this.stat(filePath),\n          resolve: (...paths: string[]) => this.resolve(...paths),\n        },\n        pattern,\n        { cwd }\n      );\n    },\n  };\n}\n"
+    "import type { IFs } from \"memfs\";\nimport type { VirtualFS, FileStat } from \"../types.cjs\";\nimport * as pathModule from \"path\";\nimport { globVirtualFS } from \"../utils/glob.cjs\";\nimport {\n  discardsSpecialFileWrites,\n  existsSpecialFile,\n  getSpecialPathError,\n  readSpecialFile,\n  statSpecialFile,\n} from \"./special-files.cjs\";\n\nexport function createVirtualFS(memfs: IFs): VirtualFS {\n  const { promises: fs } = memfs;\n\n  return {\n    readFile: (async (path: string, encoding?: BufferEncoding): Promise<Buffer | string> => {\n      const specialContent = readSpecialFile(path, encoding);\n      if (specialContent !== undefined) return specialContent;\n      const content = await fs.readFile(path);\n      const buf = Buffer.from(content);\n      return encoding ? buf.toString(encoding) : buf;\n    }) as VirtualFS[\"readFile\"],\n\n    async readdir(path: string): Promise<string[]> {\n      const specialError = getSpecialPathError(path, \"readdir\");\n      if (specialError) throw specialError;\n      const entries = await fs.readdir(path);\n      return entries.map(String);\n    },\n\n    async stat(path: string): Promise<FileStat> {\n      const specialStat = statSpecialFile(path);\n      if (specialStat) return specialStat;\n      const stats = await fs.stat(path);\n      return {\n        isFile: () => stats.isFile(),\n        isDirectory: () => stats.isDirectory(),\n        size: Number(stats.size),\n        mtime: new Date(stats.mtime),\n      };\n    },\n\n    async exists(path: string): Promise<boolean> {\n      const specialExists = existsSpecialFile(path);\n      if (specialExists !== undefined) return specialExists;\n      try {\n        await fs.stat(path);\n        return true;\n      } catch {\n        return false;\n      }\n    },\n\n    async writeFile(path: string, data: Buffer | string): Promise<void> {\n      if (discardsSpecialFileWrites(path)) {\n        return;\n      }\n      await fs.writeFile(path, data);\n    },\n\n    async appendFile(path: string, data: Buffer | string): Promise<void> {\n      if (discardsSpecialFileWrites(path)) {\n        return;\n      }\n      await fs.appendFile(path, data);\n    },\n\n    async mkdir(path: string, opts?: { recursive?: boolean }): Promise<void> {\n      const specialError = getSpecialPathError(path, \"mkdir\");\n      if (specialError) throw specialError;\n      await fs.mkdir(path, opts);\n    },\n\n    async rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n      const specialError = getSpecialPathError(path, \"rm\");\n      if (specialError) throw specialError;\n      try {\n        const stats = await fs.stat(path);\n        if (stats.isDirectory()) {\n          await fs.rmdir(path, { recursive: opts?.recursive });\n        } else {\n          await fs.unlink(path);\n        }\n      } catch (err) {\n        if (!opts?.force) throw err;\n      }\n    },\n\n    resolve(...paths: string[]): string {\n      return pathModule.resolve(...paths);\n    },\n\n    dirname(path: string): string {\n      return pathModule.dirname(path);\n    },\n\n    basename(path: string): string {\n      return pathModule.basename(path);\n    },\n\n    async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n      const cwd = opts?.cwd ?? \"/\";\n      return globVirtualFS(\n        {\n          readdir: (filePath: string) => this.readdir(filePath),\n          stat: (filePath: string) => this.stat(filePath),\n          resolve: (...paths: string[]) => this.resolve(...paths),\n        },\n        pattern,\n        { cwd }\n      );\n    },\n  };\n}\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE4B,IAA5B;AAC8B,IAA9B;AAEO,SAAS,eAAe,CAAC,OAAuB;AAAA,EACrD,QAAQ,UAAU,OAAO;AAAA,EAEzB,OAAO;AAAA,IACL,UAAW,OAAO,MAAc,aAAwD;AAAA,MACtF,IAAI,SAAS;AAAA,QAAa,OAAO,WAAW,KAAK,OAAO,MAAM,CAAC;AAAA,MAC/D,MAAM,UAAU,MAAM,GAAG,SAAS,IAAI;AAAA,MACtC,MAAM,MAAM,OAAO,KAAK,OAAO;AAAA,MAC/B,OAAO,WAAW,IAAI,SAAS,QAAQ,IAAI;AAAA;AAAA,SAGvC,QAAO,CAAC,MAAiC;AAAA,MAC7C,MAAM,UAAU,MAAM,GAAG,QAAQ,IAAI;AAAA,MACrC,OAAO,QAAQ,IAAI,MAAM;AAAA;AAAA,SAGrB,KAAI,CAAC,MAAiC;AAAA,MAC1C,MAAM,QAAQ,MAAM,GAAG,KAAK,IAAI;AAAA,MAChC,OAAO;AAAA,QACL,QAAQ,MAAM,MAAM,OAAO;AAAA,QAC3B,aAAa,MAAM,MAAM,YAAY;AAAA,QACrC,MAAM,OAAO,MAAM,IAAI;AAAA,QACvB,OAAO,IAAI,KAAK,MAAM,KAAK;AAAA,MAC7B;AAAA;AAAA,SAGI,OAAM,CAAC,MAAgC;AAAA,MAC3C,IAAI;AAAA,QACF,MAAM,GAAG,KAAK,IAAI;AAAA,QAClB,OAAO;AAAA,QACP,MAAM;AAAA,QACN,OAAO;AAAA;AAAA;AAAA,SAIL,UAAS,CAAC,MAAc,MAAsC;AAAA,MAClE,MAAM,GAAG,UAAU,MAAM,IAAI;AAAA;AAAA,SAGzB,WAAU,CAAC,MAAc,MAAsC;AAAA,MACnE,MAAM,GAAG,WAAW,MAAM,IAAI;AAAA;AAAA,SAG1B,MAAK,CAAC,MAAc,MAA+C;AAAA,MACvE,MAAM,GAAG,MAAM,MAAM,IAAI;AAAA;AAAA,SAGrB,GAAE,CAAC,MAAc,MAAgE;AAAA,MACrF,IAAI;AAAA,QACF,MAAM,QAAQ,MAAM,GAAG,KAAK,IAAI;AAAA,QAChC,IAAI,MAAM,YAAY,GAAG;AAAA,UACvB,MAAM,GAAG,MAAM,MAAM,EAAE,WAAW,MAAM,UAAU,CAAC;AAAA,QACrD,EAAO;AAAA,UACL,MAAM,GAAG,OAAO,IAAI;AAAA;AAAA,QAEtB,OAAO,KAAK;AAAA,QACZ,IAAI,CAAC,MAAM;AAAA,UAAO,MAAM;AAAA;AAAA;AAAA,IAI5B,OAAO,IAAI,OAAyB;AAAA,MAClC,OAAkB,mBAAQ,GAAG,KAAK;AAAA;AAAA,IAGpC,OAAO,CAAC,MAAsB;AAAA,MAC5B,OAAkB,mBAAQ,IAAI;AAAA;AAAA,IAGhC,QAAQ,CAAC,MAAsB;AAAA,MAC7B,OAAkB,oBAAS,IAAI;AAAA;AAAA,SAG3B,KAAI,CAAC,SAAiB,MAA4C;AAAA,MACtE,MAAM,MAAM,MAAM,OAAO;AAAA,MACzB,OAAO,0BACL;AAAA,QACE,SAAS,CAAC,aAAqB,KAAK,QAAQ,QAAQ;AAAA,QACpD,MAAM,CAAC,aAAqB,KAAK,KAAK,QAAQ;AAAA,QAC9C,SAAS,IAAI,UAAoB,KAAK,QAAQ,GAAG,KAAK;AAAA,MACxD,GACA,SACA,EAAE,IAAI,CACR;AAAA;AAAA,EAEJ;AAAA;",
-  "debugId": "60E8B0C48B1EE27B64756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE4B,IAA5B;AAC8B,IAA9B;AAOO,IANP;AAQO,SAAS,eAAe,CAAC,OAAuB;AAAA,EACrD,QAAQ,UAAU,OAAO;AAAA,EAEzB,OAAO;AAAA,IACL,UAAW,OAAO,MAAc,aAAwD;AAAA,MACtF,MAAM,iBAAiB,qCAAgB,MAAM,QAAQ;AAAA,MACrD,IAAI,mBAAmB;AAAA,QAAW,OAAO;AAAA,MACzC,MAAM,UAAU,MAAM,GAAG,SAAS,IAAI;AAAA,MACtC,MAAM,MAAM,OAAO,KAAK,OAAO;AAAA,MAC/B,OAAO,WAAW,IAAI,SAAS,QAAQ,IAAI;AAAA;AAAA,SAGvC,QAAO,CAAC,MAAiC;AAAA,MAC7C,MAAM,eAAe,yCAAoB,MAAM,SAAS;AAAA,MACxD,IAAI;AAAA,QAAc,MAAM;AAAA,MACxB,MAAM,UAAU,MAAM,GAAG,QAAQ,IAAI;AAAA,MACrC,OAAO,QAAQ,IAAI,MAAM;AAAA;AAAA,SAGrB,KAAI,CAAC,MAAiC;AAAA,MAC1C,MAAM,cAAc,qCAAgB,IAAI;AAAA,MACxC,IAAI;AAAA,QAAa,OAAO;AAAA,MACxB,MAAM,QAAQ,MAAM,GAAG,KAAK,IAAI;AAAA,MAChC,OAAO;AAAA,QACL,QAAQ,MAAM,MAAM,OAAO;AAAA,QAC3B,aAAa,MAAM,MAAM,YAAY;AAAA,QACrC,MAAM,OAAO,MAAM,IAAI;AAAA,QACvB,OAAO,IAAI,KAAK,MAAM,KAAK;AAAA,MAC7B;AAAA;AAAA,SAGI,OAAM,CAAC,MAAgC;AAAA,MAC3C,MAAM,gBAAgB,uCAAkB,IAAI;AAAA,MAC5C,IAAI,kBAAkB;AAAA,QAAW,OAAO;AAAA,MACxC,IAAI;AAAA,QACF,MAAM,GAAG,KAAK,IAAI;AAAA,QAClB,OAAO;AAAA,QACP,MAAM;AAAA,QACN,OAAO;AAAA;AAAA;AAAA,SAIL,UAAS,CAAC,MAAc,MAAsC;AAAA,MAClE,IAAI,+CAA0B,IAAI,GAAG;AAAA,QACnC;AAAA,MACF;AAAA,MACA,MAAM,GAAG,UAAU,MAAM,IAAI;AAAA;AAAA,SAGzB,WAAU,CAAC,MAAc,MAAsC;AAAA,MACnE,IAAI,+CAA0B,IAAI,GAAG;AAAA,QACnC;AAAA,MACF;AAAA,MACA,MAAM,GAAG,WAAW,MAAM,IAAI;AAAA;AAAA,SAG1B,MAAK,CAAC,MAAc,MAA+C;AAAA,MACvE,MAAM,eAAe,yCAAoB,MAAM,OAAO;AAAA,MACtD,IAAI;AAAA,QAAc,MAAM;AAAA,MACxB,MAAM,GAAG,MAAM,MAAM,IAAI;AAAA;AAAA,SAGrB,GAAE,CAAC,MAAc,MAAgE;AAAA,MACrF,MAAM,eAAe,yCAAoB,MAAM,IAAI;AAAA,MACnD,IAAI;AAAA,QAAc,MAAM;AAAA,MACxB,IAAI;AAAA,QACF,MAAM,QAAQ,MAAM,GAAG,KAAK,IAAI;AAAA,QAChC,IAAI,MAAM,YAAY,GAAG;AAAA,UACvB,MAAM,GAAG,MAAM,MAAM,EAAE,WAAW,MAAM,UAAU,CAAC;AAAA,QACrD,EAAO;AAAA,UACL,MAAM,GAAG,OAAO,IAAI;AAAA;AAAA,QAEtB,OAAO,KAAK;AAAA,QACZ,IAAI,CAAC,MAAM;AAAA,UAAO,MAAM;AAAA;AAAA;AAAA,IAI5B,OAAO,IAAI,OAAyB;AAAA,MAClC,OAAkB,mBAAQ,GAAG,KAAK;AAAA;AAAA,IAGpC,OAAO,CAAC,MAAsB;AAAA,MAC5B,OAAkB,mBAAQ,IAAI;AAAA;AAAA,IAGhC,QAAQ,CAAC,MAAsB;AAAA,MAC7B,OAAkB,oBAAS,IAAI;AAAA;AAAA,SAG3B,KAAI,CAAC,SAAiB,MAA4C;AAAA,MACtE,MAAM,MAAM,MAAM,OAAO;AAAA,MACzB,OAAO,0BACL;AAAA,QACE,SAAS,CAAC,aAAqB,KAAK,QAAQ,QAAQ;AAAA,QACpD,MAAM,CAAC,aAAqB,KAAK,KAAK,QAAQ;AAAA,QAC9C,SAAS,IAAI,UAAoB,KAAK,QAAQ,GAAG,KAAK;AAAA,MACxD,GACA,SACA,EAAE,IAAI,CACR;AAAA;AAAA,EAEJ;AAAA;",
+  "debugId": "F25975C12E3475B564756E2164756E21",
   "names": []
 }

package/dist/cjs/src/fs/real-fs.cjs

@@ -69,6 +69,7 @@ module.exports = __toCommonJS(exports_real_fs);
 var path = __toESM(require("path"));
 var nodeFs = __toESM(require("node:fs/promises"));
 var import_glob = require("../utils/glob.cjs");
+var import_special_files = require("./special-files.cjs");
 var defaultFS = { promises: nodeFs };
 var nodePathOps = {
   separator: path.sep,
@@ -167,6 +168,10 @@ class FileSystem {
     return resolved;
   }
   async readFile(filePath, encoding) {
+    const specialContent = import_special_files.readSpecialFile(filePath, encoding);
+    if (specialContent !== undefined) {
+      return specialContent;
+    }
     this.checkPermission(filePath, "read");
     const realPath = this.resolveSafePath(filePath);
     const content = await this.underlyingFs.promises.readFile(realPath);
@@ -174,12 +179,20 @@ class FileSystem {
     return encoding ? buf.toString(encoding) : buf;
   }
   async readdir(dirPath) {
+    const specialError = import_special_files.getSpecialPathError(dirPath, "readdir");
+    if (specialError) {
+      throw specialError;
+    }
     this.checkPermission(dirPath, "read");
     const realPath = this.resolveSafePath(dirPath);
     const entries = await this.underlyingFs.promises.readdir(realPath);
     return entries.map(String);
   }
   async stat(filePath) {
+    const specialStat = import_special_files.statSpecialFile(filePath);
+    if (specialStat) {
+      return specialStat;
+    }
     this.checkPermission(filePath, "read");
     const realPath = this.resolveSafePath(filePath);
     const stats = await this.underlyingFs.promises.stat(realPath);
@@ -191,6 +204,10 @@ class FileSystem {
     };
   }
   async exists(filePath) {
+    const specialExists = import_special_files.existsSpecialFile(filePath);
+    if (specialExists !== undefined) {
+      return specialExists;
+    }
     try {
       this.checkPermission(filePath, "read");
       const realPath = this.resolveSafePath(filePath);
@@ -201,21 +218,35 @@ class FileSystem {
     }
   }
   async writeFile(filePath, data) {
+    if (import_special_files.discardsSpecialFileWrites(filePath)) {
+      return;
+    }
     this.checkPermission(filePath, "write");
     const realPath = this.resolveSafePath(filePath);
     await this.underlyingFs.promises.writeFile(realPath, data);
   }
   async appendFile(filePath, data) {
+    if (import_special_files.discardsSpecialFileWrites(filePath)) {
+      return;
+    }
     this.checkPermission(filePath, "write");
     const realPath = this.resolveSafePath(filePath);
     await this.underlyingFs.promises.appendFile(realPath, data);
   }
   async mkdir(dirPath, opts) {
+    const specialError = import_special_files.getSpecialPathError(dirPath, "mkdir");
+    if (specialError) {
+      throw specialError;
+    }
     this.checkPermission(dirPath, "write");
     const realPath = this.resolveSafePath(dirPath);
     await this.underlyingFs.promises.mkdir(realPath, opts);
   }
   async rm(filePath, opts) {
+    const specialError = import_special_files.getSpecialPathError(filePath, "rm");
+    if (specialError) {
+      throw specialError;
+    }
     this.checkPermission(filePath, "write");
     const realPath = this.resolveSafePath(filePath);
     await this.underlyingFs.promises.rm(realPath, opts);
@@ -236,4 +267,4 @@ class FileSystem {
   }
 }
 
-//# debugId=6E371DB9ABEDFA8764756E2164756E21
+//# debugId=58FDFA4CFF76BA5364756E2164756E21