shell-dsl 0.0.31 → 0.0.32

package/dist/mjs/src/commands/tree/tree.mjs

@@ -8,11 +8,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")
@@ -21,6 +29,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 = [];
@@ -50,7 +60,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
@@ -75,11 +85,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("."));
@@ -88,39 +101,63 @@ var tree = async (ctx) => {
       entries = entries.filter((e) => !ignorePatterns.some((p) => 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++;
@@ -139,4 +176,4 @@ export {
   tree
 };
 
-//# debugId=9413424130A1F65864756E2164756E21
+//# debugId=CEDB38313AEAA77264756E2164756E21

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

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../../src/commands/tree/tree.ts"],
   "sourcesContent": [
-    "import type { Command } from \"../../types.mjs\";\nimport { createFlagParser, type FlagDefinition } from \"../../utils/flag-parser.mjs\";\nimport { matchGlob } from \"../../utils/match-glob.mjs\";\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.mjs\";\nimport { createFlagParser, type FlagDefinition } from \"../../utils/flag-parser.mjs\";\nimport { matchGlob } from \"../../utils/match-glob.mjs\";\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": "9413424130A1F65864756E2164756E21",
+  "mappings": "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",
+  "debugId": "CEDB38313AEAA77264756E2164756E21",
   "names": []
 }

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

@@ -1,21 +1,35 @@
 // src/fs/memfs-adapter.ts
 import * as pathModule from "path";
 import { globVirtualFS } from "../utils/glob.mjs";
+import {
+  discardsSpecialFileWrites,
+  existsSpecialFile,
+  getSpecialPathError,
+  readSpecialFile,
+  statSpecialFile
+} from "./special-files.mjs";
 function createVirtualFS(memfs) {
   const { promises: fs } = memfs;
   return {
     readFile: async (path, encoding) => {
-      if (path === "/dev/null")
-        return encoding ? "" : Buffer.alloc(0);
+      const specialContent = 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 = getSpecialPathError(path, "readdir");
+      if (specialError)
+        throw specialError;
       const entries = await fs.readdir(path);
       return entries.map(String);
     },
     async stat(path) {
+      const specialStat = statSpecialFile(path);
+      if (specialStat)
+        return specialStat;
       const stats = await fs.stat(path);
       return {
         isFile: () => stats.isFile(),
@@ -25,6 +39,9 @@ function createVirtualFS(memfs) {
       };
     },
     async exists(path) {
+      const specialExists = existsSpecialFile(path);
+      if (specialExists !== undefined)
+        return specialExists;
       try {
         await fs.stat(path);
         return true;
@@ -33,15 +50,27 @@ function createVirtualFS(memfs) {
       }
     },
     async writeFile(path, data) {
+      if (discardsSpecialFileWrites(path)) {
+        return;
+      }
       await fs.writeFile(path, data);
     },
     async appendFile(path, data) {
+      if (discardsSpecialFileWrites(path)) {
+        return;
+      }
       await fs.appendFile(path, data);
     },
     async mkdir(path, opts) {
+      const specialError = getSpecialPathError(path, "mkdir");
+      if (specialError)
+        throw specialError;
       await fs.mkdir(path, opts);
     },
     async rm(path, opts) {
+      const specialError = getSpecialPathError(path, "rm");
+      if (specialError)
+        throw specialError;
       try {
         const stats = await fs.stat(path);
         if (stats.isDirectory()) {
@@ -77,4 +106,4 @@ export {
   createVirtualFS
 };
 
-//# debugId=EAE27F968F9F56F664756E2164756E21
+//# debugId=DF93BEF2761EBF0164756E2164756E21

package/dist/mjs/src/fs/memfs-adapter.mjs.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.mjs\";\nimport * as pathModule from \"path\";\nimport { globVirtualFS } from \"../utils/glob.mjs\";\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.mjs\";\nimport * as pathModule from \"path\";\nimport { globVirtualFS } from \"../utils/glob.mjs\";\nimport {\n  discardsSpecialFileWrites,\n  existsSpecialFile,\n  getSpecialPathError,\n  readSpecialFile,\n  statSpecialFile,\n} from \"./special-files.mjs\";\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": ";AAEA;AACA;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,cACL;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": "EAE27F968F9F56F664756E2164756E21",
+  "mappings": "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",
+  "debugId": "DF93BEF2761EBF0164756E2164756E21",
   "names": []
 }

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

@@ -2,6 +2,13 @@
 import * as path from "path";
 import * as nodeFs from "node:fs/promises";
 import { globVirtualFS } from "../utils/glob.mjs";
+import {
+  discardsSpecialFileWrites,
+  existsSpecialFile,
+  getSpecialPathError,
+  readSpecialFile,
+  statSpecialFile
+} from "./special-files.mjs";
 var defaultFS = { promises: nodeFs };
 var nodePathOps = {
   separator: path.sep,
@@ -100,6 +107,10 @@ class FileSystem {
     return resolved;
   }
   async readFile(filePath, encoding) {
+    const specialContent = 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);
@@ -107,12 +118,20 @@ class FileSystem {
     return encoding ? buf.toString(encoding) : buf;
   }
   async readdir(dirPath) {
+    const specialError = 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 = statSpecialFile(filePath);
+    if (specialStat) {
+      return specialStat;
+    }
     this.checkPermission(filePath, "read");
     const realPath = this.resolveSafePath(filePath);
     const stats = await this.underlyingFs.promises.stat(realPath);
@@ -124,6 +143,10 @@ class FileSystem {
     };
   }
   async exists(filePath) {
+    const specialExists = existsSpecialFile(filePath);
+    if (specialExists !== undefined) {
+      return specialExists;
+    }
     try {
       this.checkPermission(filePath, "read");
       const realPath = this.resolveSafePath(filePath);
@@ -134,21 +157,35 @@ class FileSystem {
     }
   }
   async writeFile(filePath, data) {
+    if (discardsSpecialFileWrites(filePath)) {
+      return;
+    }
     this.checkPermission(filePath, "write");
     const realPath = this.resolveSafePath(filePath);
     await this.underlyingFs.promises.writeFile(realPath, data);
   }
   async appendFile(filePath, data) {
+    if (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 = 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 = getSpecialPathError(filePath, "rm");
+    if (specialError) {
+      throw specialError;
+    }
     this.checkPermission(filePath, "write");
     const realPath = this.resolveSafePath(filePath);
     await this.underlyingFs.promises.rm(realPath, opts);
@@ -172,4 +209,4 @@ export {
   FileSystem
 };
 
-//# debugId=093147B23E1E8F5A64756E2164756E21
+//# debugId=9ACC9F274DA10B5E64756E2164756E21

package/dist/mjs/src/fs/real-fs.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/fs/real-fs.ts"],
   "sourcesContent": [
-    "import * as path from \"path\";\nimport * as nodeFs from \"node:fs/promises\";\nimport type { VirtualFS, FileStat } from \"../types.mjs\";\nimport { globVirtualFS } from \"../utils/glob.mjs\";\n\nexport type Permission = \"read-write\" | \"read-only\" | \"excluded\";\nexport type PermissionRules = Record<string, Permission>;\nexport interface PathOps {\n  readonly separator: string;\n  resolve(...paths: string[]): string;\n  normalize(path: string): string;\n  join(...paths: string[]): string;\n  relative(from: string, to: string): string;\n  isAbsolute(path: string): boolean;\n  dirname(path: string): string;\n  basename(path: string): string;\n}\n\n// Minimal interface for the underlying fs (compatible with node:fs and memfs)\nexport interface UnderlyingFS {\n  pathOps?: PathOps;\n  promises: {\n    readFile(path: string): Promise<Buffer | Uint8Array | string>;\n    readdir(path: string): Promise<string[]>;\n    stat(path: string): Promise<{\n      isFile(): boolean;\n      isDirectory(): boolean;\n      size: number;\n      mtime: Date;\n    }>;\n    writeFile(path: string, data: Buffer | string): Promise<void>;\n    appendFile(path: string, data: Buffer | string): Promise<void>;\n    mkdir(path: string, opts?: { recursive?: boolean }): Promise<string | undefined | void>;\n    rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void>;\n  };\n}\n\n// Default: use real node:fs\nconst defaultFS: UnderlyingFS = { promises: nodeFs };\nconst nodePathOps: PathOps = {\n  separator: path.sep,\n  resolve: (...paths) => path.resolve(...paths),\n  normalize: (filePath) => path.normalize(filePath),\n  join: (...paths) => path.join(...paths),\n  relative: (from, to) => path.relative(from, to),\n  isAbsolute: (filePath) => path.isAbsolute(filePath),\n  dirname: (filePath) => path.dirname(filePath),\n  basename: (filePath) => path.basename(filePath),\n};\n\ninterface CompiledRule {\n  pattern: string;\n  permission: Permission;\n  specificity: number;\n}\n\nexport class FileSystem implements VirtualFS {\n  private readonly mountBase: string | null;\n  private readonly rules: CompiledRule[];\n  private readonly pathOps: PathOps;\n  protected readonly underlyingFs: UnderlyingFS;\n\n  constructor(mountPath?: string, permissions?: PermissionRules, fs?: UnderlyingFS) {\n    const underlyingFs = fs ?? defaultFS;\n    this.pathOps = underlyingFs.pathOps ?? nodePathOps;\n    this.mountBase = mountPath ? this.pathOps.resolve(mountPath) : null;\n    this.rules = this.compileRules(permissions ?? {});\n    this.underlyingFs = underlyingFs;\n  }\n\n  private compileRules(permissions: PermissionRules): CompiledRule[] {\n    return Object.entries(permissions)\n      .map(([pattern, permission]) => ({\n        pattern,\n        permission,\n        specificity: this.calculateSpecificity(pattern),\n      }))\n      .sort((a, b) => b.specificity - a.specificity); // highest first\n  }\n\n  private calculateSpecificity(pattern: string): number {\n    const segments = pattern.split(\"/\").filter(Boolean);\n    let score = segments.length * 1000; // segment count is primary\n\n    for (const seg of segments) {\n      if (seg === \"**\") score += 0;\n      else if (seg.includes(\"*\")) score += 1;\n      else score += 10; // literal segment\n    }\n    return score;\n  }\n\n  public getPermission(virtualPath: string): Permission {\n    const normalized = virtualPath.replace(/^\\/+/, \"\"); // strip leading slashes\n\n    for (const rule of this.rules) {\n      if (this.matchGlob(rule.pattern, normalized)) {\n        return rule.permission;\n      }\n    }\n    return \"read-write\"; // default\n  }\n\n  private matchGlob(pattern: string, filePath: string): boolean {\n    // Convert glob to regex\n    // ** matches any path segments, * matches within segment\n    const regex = pattern\n      .split(\"/\")\n      .map((seg) => {\n        if (seg === \"**\") return \".*\";\n        return seg.replace(/\\*/g, \"[^/]*\").replace(/\\?/g, \"[^/]\");\n      })\n      .join(\"/\");\n    return new RegExp(`^${regex}$`).test(filePath);\n  }\n\n  public checkPermission(virtualPath: string, operation: \"read\" | \"write\"): void {\n    const perm = this.getPermission(virtualPath);\n\n    if (perm === \"excluded\") {\n      throw new Error(`Access denied: \"${virtualPath}\" is excluded`);\n    }\n    if (operation === \"write\" && perm === \"read-only\") {\n      throw new Error(`Access denied: \"${virtualPath}\" is read-only`);\n    }\n  }\n\n  private resolveSafePath(virtualPath: string): string {\n    if (this.mountBase === null) {\n      return this.pathOps.resolve(virtualPath);\n    }\n\n    // Check for path traversal by tracking depth\n    const segments = virtualPath.split(\"/\").filter(Boolean);\n    let depth = 0;\n    for (const seg of segments) {\n      if (seg === \"..\") {\n        depth--;\n        if (depth < 0) {\n          throw new Error(`Path traversal blocked: \"${virtualPath}\" escapes mount point`);\n        }\n      } else if (seg !== \".\") {\n        depth++;\n      }\n    }\n\n    const normalized = this.pathOps.normalize(virtualPath);\n    const relativePath = normalized.startsWith(\"/\") ? normalized.slice(1) : normalized;\n    const realPath = this.pathOps.join(this.mountBase, relativePath);\n    const resolved = this.pathOps.resolve(realPath);\n\n    // Double-check containment (defense in depth), including root mounts.\n    const relativeFromMount = this.pathOps.relative(this.mountBase, resolved);\n    const escapesMount =\n      relativeFromMount === \"..\" ||\n      relativeFromMount.startsWith(`..${this.pathOps.separator}`) ||\n      this.pathOps.isAbsolute(relativeFromMount);\n    if (escapesMount) {\n      throw new Error(`Path traversal blocked: \"${virtualPath}\" escapes mount point`);\n    }\n\n    return resolved;\n  }\n\n  // Read operations\n  async readFile(filePath: string): Promise<Buffer>;\n  async readFile(filePath: string, encoding: BufferEncoding): Promise<string>;\n  async readFile(filePath: string, encoding?: BufferEncoding): Promise<Buffer | string> {\n    this.checkPermission(filePath, \"read\");\n    const realPath = this.resolveSafePath(filePath);\n    const content = await this.underlyingFs.promises.readFile(realPath);\n    const buf = Buffer.from(content);\n    return encoding ? buf.toString(encoding) : buf;\n  }\n\n  async readdir(dirPath: string): Promise<string[]> {\n    this.checkPermission(dirPath, \"read\");\n    const realPath = this.resolveSafePath(dirPath);\n    const entries = await this.underlyingFs.promises.readdir(realPath);\n    return entries.map(String);\n  }\n\n  async stat(filePath: string): Promise<FileStat> {\n    this.checkPermission(filePath, \"read\");\n    const realPath = this.resolveSafePath(filePath);\n    const stats = await this.underlyingFs.promises.stat(realPath);\n    return {\n      isFile: () => stats.isFile(),\n      isDirectory: () => stats.isDirectory(),\n      size: stats.size,\n      mtime: stats.mtime,\n    };\n  }\n\n  async exists(filePath: string): Promise<boolean> {\n    try {\n      this.checkPermission(filePath, \"read\");\n      const realPath = this.resolveSafePath(filePath);\n      await this.underlyingFs.promises.stat(realPath);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  // Write operations\n  async writeFile(filePath: string, data: Buffer | string): Promise<void> {\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.writeFile(realPath, data);\n  }\n\n  async appendFile(filePath: string, data: Buffer | string): Promise<void> {\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.appendFile(realPath, data);\n  }\n\n  async mkdir(dirPath: string, opts?: { recursive?: boolean }): Promise<void> {\n    this.checkPermission(dirPath, \"write\");\n    const realPath = this.resolveSafePath(dirPath);\n    await this.underlyingFs.promises.mkdir(realPath, opts);\n  }\n\n  async rm(filePath: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.rm(realPath, opts);\n  }\n\n  // Path utilities (no permission check needed)\n  resolve(...paths: string[]): string {\n    return this.pathOps.resolve(\"/\", ...paths);\n  }\n\n  dirname(filePath: string): string {\n    return this.pathOps.dirname(filePath);\n  }\n\n  basename(filePath: string): string {\n    return this.pathOps.basename(filePath);\n  }\n\n  // Glob expansion\n  async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n    const cwd = opts?.cwd ?? \"/\";\n    this.checkPermission(cwd, \"read\");\n    return globVirtualFS(this, pattern, { cwd });\n  }\n}\n"
+    "import * as path from \"path\";\nimport * as nodeFs from \"node:fs/promises\";\nimport type { VirtualFS, FileStat } from \"../types.mjs\";\nimport { globVirtualFS } from \"../utils/glob.mjs\";\nimport {\n  discardsSpecialFileWrites,\n  existsSpecialFile,\n  getSpecialPathError,\n  readSpecialFile,\n  statSpecialFile,\n} from \"./special-files.mjs\";\n\nexport type Permission = \"read-write\" | \"read-only\" | \"excluded\";\nexport type PermissionRules = Record<string, Permission>;\nexport interface PathOps {\n  readonly separator: string;\n  resolve(...paths: string[]): string;\n  normalize(path: string): string;\n  join(...paths: string[]): string;\n  relative(from: string, to: string): string;\n  isAbsolute(path: string): boolean;\n  dirname(path: string): string;\n  basename(path: string): string;\n}\n\n// Minimal interface for the underlying fs (compatible with node:fs and memfs)\nexport interface UnderlyingFS {\n  pathOps?: PathOps;\n  promises: {\n    readFile(path: string): Promise<Buffer | Uint8Array | string>;\n    readdir(path: string): Promise<string[]>;\n    stat(path: string): Promise<{\n      isFile(): boolean;\n      isDirectory(): boolean;\n      size: number;\n      mtime: Date;\n    }>;\n    writeFile(path: string, data: Buffer | string): Promise<void>;\n    appendFile(path: string, data: Buffer | string): Promise<void>;\n    mkdir(path: string, opts?: { recursive?: boolean }): Promise<string | undefined | void>;\n    rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void>;\n  };\n}\n\n// Default: use real node:fs\nconst defaultFS: UnderlyingFS = { promises: nodeFs };\nconst nodePathOps: PathOps = {\n  separator: path.sep,\n  resolve: (...paths) => path.resolve(...paths),\n  normalize: (filePath) => path.normalize(filePath),\n  join: (...paths) => path.join(...paths),\n  relative: (from, to) => path.relative(from, to),\n  isAbsolute: (filePath) => path.isAbsolute(filePath),\n  dirname: (filePath) => path.dirname(filePath),\n  basename: (filePath) => path.basename(filePath),\n};\n\ninterface CompiledRule {\n  pattern: string;\n  permission: Permission;\n  specificity: number;\n}\n\nexport class FileSystem implements VirtualFS {\n  private readonly mountBase: string | null;\n  private readonly rules: CompiledRule[];\n  private readonly pathOps: PathOps;\n  protected readonly underlyingFs: UnderlyingFS;\n\n  constructor(mountPath?: string, permissions?: PermissionRules, fs?: UnderlyingFS) {\n    const underlyingFs = fs ?? defaultFS;\n    this.pathOps = underlyingFs.pathOps ?? nodePathOps;\n    this.mountBase = mountPath ? this.pathOps.resolve(mountPath) : null;\n    this.rules = this.compileRules(permissions ?? {});\n    this.underlyingFs = underlyingFs;\n  }\n\n  private compileRules(permissions: PermissionRules): CompiledRule[] {\n    return Object.entries(permissions)\n      .map(([pattern, permission]) => ({\n        pattern,\n        permission,\n        specificity: this.calculateSpecificity(pattern),\n      }))\n      .sort((a, b) => b.specificity - a.specificity); // highest first\n  }\n\n  private calculateSpecificity(pattern: string): number {\n    const segments = pattern.split(\"/\").filter(Boolean);\n    let score = segments.length * 1000; // segment count is primary\n\n    for (const seg of segments) {\n      if (seg === \"**\") score += 0;\n      else if (seg.includes(\"*\")) score += 1;\n      else score += 10; // literal segment\n    }\n    return score;\n  }\n\n  public getPermission(virtualPath: string): Permission {\n    const normalized = virtualPath.replace(/^\\/+/, \"\"); // strip leading slashes\n\n    for (const rule of this.rules) {\n      if (this.matchGlob(rule.pattern, normalized)) {\n        return rule.permission;\n      }\n    }\n    return \"read-write\"; // default\n  }\n\n  private matchGlob(pattern: string, filePath: string): boolean {\n    // Convert glob to regex\n    // ** matches any path segments, * matches within segment\n    const regex = pattern\n      .split(\"/\")\n      .map((seg) => {\n        if (seg === \"**\") return \".*\";\n        return seg.replace(/\\*/g, \"[^/]*\").replace(/\\?/g, \"[^/]\");\n      })\n      .join(\"/\");\n    return new RegExp(`^${regex}$`).test(filePath);\n  }\n\n  public checkPermission(virtualPath: string, operation: \"read\" | \"write\"): void {\n    const perm = this.getPermission(virtualPath);\n\n    if (perm === \"excluded\") {\n      throw new Error(`Access denied: \"${virtualPath}\" is excluded`);\n    }\n    if (operation === \"write\" && perm === \"read-only\") {\n      throw new Error(`Access denied: \"${virtualPath}\" is read-only`);\n    }\n  }\n\n  private resolveSafePath(virtualPath: string): string {\n    if (this.mountBase === null) {\n      return this.pathOps.resolve(virtualPath);\n    }\n\n    // Check for path traversal by tracking depth\n    const segments = virtualPath.split(\"/\").filter(Boolean);\n    let depth = 0;\n    for (const seg of segments) {\n      if (seg === \"..\") {\n        depth--;\n        if (depth < 0) {\n          throw new Error(`Path traversal blocked: \"${virtualPath}\" escapes mount point`);\n        }\n      } else if (seg !== \".\") {\n        depth++;\n      }\n    }\n\n    const normalized = this.pathOps.normalize(virtualPath);\n    const relativePath = normalized.startsWith(\"/\") ? normalized.slice(1) : normalized;\n    const realPath = this.pathOps.join(this.mountBase, relativePath);\n    const resolved = this.pathOps.resolve(realPath);\n\n    // Double-check containment (defense in depth), including root mounts.\n    const relativeFromMount = this.pathOps.relative(this.mountBase, resolved);\n    const escapesMount =\n      relativeFromMount === \"..\" ||\n      relativeFromMount.startsWith(`..${this.pathOps.separator}`) ||\n      this.pathOps.isAbsolute(relativeFromMount);\n    if (escapesMount) {\n      throw new Error(`Path traversal blocked: \"${virtualPath}\" escapes mount point`);\n    }\n\n    return resolved;\n  }\n\n  // Read operations\n  async readFile(filePath: string): Promise<Buffer>;\n  async readFile(filePath: string, encoding: BufferEncoding): Promise<string>;\n  async readFile(filePath: string, encoding?: BufferEncoding): Promise<Buffer | string> {\n    const specialContent = readSpecialFile(filePath, encoding);\n    if (specialContent !== undefined) {\n      return specialContent;\n    }\n    this.checkPermission(filePath, \"read\");\n    const realPath = this.resolveSafePath(filePath);\n    const content = await this.underlyingFs.promises.readFile(realPath);\n    const buf = Buffer.from(content);\n    return encoding ? buf.toString(encoding) : buf;\n  }\n\n  async readdir(dirPath: string): Promise<string[]> {\n    const specialError = getSpecialPathError(dirPath, \"readdir\");\n    if (specialError) {\n      throw specialError;\n    }\n    this.checkPermission(dirPath, \"read\");\n    const realPath = this.resolveSafePath(dirPath);\n    const entries = await this.underlyingFs.promises.readdir(realPath);\n    return entries.map(String);\n  }\n\n  async stat(filePath: string): Promise<FileStat> {\n    const specialStat = statSpecialFile(filePath);\n    if (specialStat) {\n      return specialStat;\n    }\n    this.checkPermission(filePath, \"read\");\n    const realPath = this.resolveSafePath(filePath);\n    const stats = await this.underlyingFs.promises.stat(realPath);\n    return {\n      isFile: () => stats.isFile(),\n      isDirectory: () => stats.isDirectory(),\n      size: stats.size,\n      mtime: stats.mtime,\n    };\n  }\n\n  async exists(filePath: string): Promise<boolean> {\n    const specialExists = existsSpecialFile(filePath);\n    if (specialExists !== undefined) {\n      return specialExists;\n    }\n    try {\n      this.checkPermission(filePath, \"read\");\n      const realPath = this.resolveSafePath(filePath);\n      await this.underlyingFs.promises.stat(realPath);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  // Write operations\n  async writeFile(filePath: string, data: Buffer | string): Promise<void> {\n    if (discardsSpecialFileWrites(filePath)) {\n      return;\n    }\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.writeFile(realPath, data);\n  }\n\n  async appendFile(filePath: string, data: Buffer | string): Promise<void> {\n    if (discardsSpecialFileWrites(filePath)) {\n      return;\n    }\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.appendFile(realPath, data);\n  }\n\n  async mkdir(dirPath: string, opts?: { recursive?: boolean }): Promise<void> {\n    const specialError = getSpecialPathError(dirPath, \"mkdir\");\n    if (specialError) {\n      throw specialError;\n    }\n    this.checkPermission(dirPath, \"write\");\n    const realPath = this.resolveSafePath(dirPath);\n    await this.underlyingFs.promises.mkdir(realPath, opts);\n  }\n\n  async rm(filePath: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n    const specialError = getSpecialPathError(filePath, \"rm\");\n    if (specialError) {\n      throw specialError;\n    }\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.rm(realPath, opts);\n  }\n\n  // Path utilities (no permission check needed)\n  resolve(...paths: string[]): string {\n    return this.pathOps.resolve(\"/\", ...paths);\n  }\n\n  dirname(filePath: string): string {\n    return this.pathOps.dirname(filePath);\n  }\n\n  basename(filePath: string): string {\n    return this.pathOps.basename(filePath);\n  }\n\n  // Glob expansion\n  async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n    const cwd = opts?.cwd ?? \"/\";\n    this.checkPermission(cwd, \"read\");\n    return globVirtualFS(this, pattern, { cwd });\n  }\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "093147B23E1E8F5A64756E2164756E21",
+  "mappings": "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",
+  "debugId": "9ACC9F274DA10B5E64756E2164756E21",
   "names": []
 }

package/dist/mjs/src/fs/special-files.mjs

@@ -0,0 +1,58 @@
+// src/fs/special-files.ts
+var DEV_NULL_PATH = "/dev/null";
+function normalizeSpecialPath(path) {
+  return path.replace(/\\/g, "/");
+}
+function isDevNullPath(path) {
+  return normalizeSpecialPath(path) === DEV_NULL_PATH;
+}
+function readSpecialFile(path, encoding) {
+  if (!isDevNullPath(path)) {
+    return;
+  }
+  return encoding ? "" : Buffer.alloc(0);
+}
+function statSpecialFile(path) {
+  if (!isDevNullPath(path)) {
+    return;
+  }
+  return {
+    isFile: () => true,
+    isDirectory: () => false,
+    size: 0,
+    mtime: new Date(0)
+  };
+}
+function existsSpecialFile(path) {
+  if (!isDevNullPath(path)) {
+    return;
+  }
+  return true;
+}
+function discardsSpecialFileWrites(path) {
+  return isDevNullPath(path);
+}
+function getSpecialPathError(path, operation) {
+  if (!isDevNullPath(path)) {
+    return;
+  }
+  switch (operation) {
+    case "mkdir":
+      return new Error(`EEXIST: file already exists, mkdir '${DEV_NULL_PATH}'`);
+    case "readdir":
+      return new Error(`ENOTDIR: not a directory, scandir '${DEV_NULL_PATH}'`);
+    case "rm":
+      return new Error(`EPERM: operation not permitted, rm '${DEV_NULL_PATH}'`);
+  }
+}
+export {
+  statSpecialFile,
+  readSpecialFile,
+  isDevNullPath,
+  getSpecialPathError,
+  existsSpecialFile,
+  discardsSpecialFileWrites,
+  DEV_NULL_PATH
+};
+
+//# debugId=5E984ABB0F12E5E964756E2164756E21

package/dist/mjs/src/fs/special-files.mjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/fs/special-files.ts"],
+  "sourcesContent": [
+    "import type { FileStat } from \"../types.mjs\";\n\nexport const DEV_NULL_PATH = \"/dev/null\";\n\nfunction normalizeSpecialPath(path: string): string {\n  return path.replace(/\\\\/g, \"/\");\n}\n\nexport function isDevNullPath(path: string): boolean {\n  return normalizeSpecialPath(path) === DEV_NULL_PATH;\n}\n\nexport function readSpecialFile(\n  path: string,\n  encoding?: BufferEncoding\n): Buffer | string | undefined {\n  if (!isDevNullPath(path)) {\n    return undefined;\n  }\n\n  return encoding ? \"\" : Buffer.alloc(0);\n}\n\nexport function statSpecialFile(path: string): FileStat | undefined {\n  if (!isDevNullPath(path)) {\n    return undefined;\n  }\n\n  return {\n    isFile: () => true,\n    isDirectory: () => false,\n    size: 0,\n    mtime: new Date(0),\n  };\n}\n\nexport function existsSpecialFile(path: string): boolean | undefined {\n  if (!isDevNullPath(path)) {\n    return undefined;\n  }\n\n  return true;\n}\n\nexport function discardsSpecialFileWrites(path: string): boolean {\n  return isDevNullPath(path);\n}\n\nexport function getSpecialPathError(\n  path: string,\n  operation: \"mkdir\" | \"readdir\" | \"rm\"\n): Error | undefined {\n  if (!isDevNullPath(path)) {\n    return undefined;\n  }\n\n  switch (operation) {\n    case \"mkdir\":\n      return new Error(`EEXIST: file already exists, mkdir '${DEV_NULL_PATH}'`);\n    case \"readdir\":\n      return new Error(`ENOTDIR: not a directory, scandir '${DEV_NULL_PATH}'`);\n    case \"rm\":\n      return new Error(`EPERM: operation not permitted, rm '${DEV_NULL_PATH}'`);\n  }\n}\n"
+  ],
+  "mappings": ";AAEO,IAAM,gBAAgB;AAE7B,SAAS,oBAAoB,CAAC,MAAsB;AAAA,EAClD,OAAO,KAAK,QAAQ,OAAO,GAAG;AAAA;AAGzB,SAAS,aAAa,CAAC,MAAuB;AAAA,EACnD,OAAO,qBAAqB,IAAI,MAAM;AAAA;AAGjC,SAAS,eAAe,CAC7B,MACA,UAC6B;AAAA,EAC7B,IAAI,CAAC,cAAc,IAAI,GAAG;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,OAAO,WAAW,KAAK,OAAO,MAAM,CAAC;AAAA;AAGhC,SAAS,eAAe,CAAC,MAAoC;AAAA,EAClE,IAAI,CAAC,cAAc,IAAI,GAAG;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,OAAO;AAAA,IACL,QAAQ,MAAM;AAAA,IACd,aAAa,MAAM;AAAA,IACnB,MAAM;AAAA,IACN,OAAO,IAAI,KAAK,CAAC;AAAA,EACnB;AAAA;AAGK,SAAS,iBAAiB,CAAC,MAAmC;AAAA,EACnE,IAAI,CAAC,cAAc,IAAI,GAAG;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,OAAO;AAAA;AAGF,SAAS,yBAAyB,CAAC,MAAuB;AAAA,EAC/D,OAAO,cAAc,IAAI;AAAA;AAGpB,SAAS,mBAAmB,CACjC,MACA,WACmB;AAAA,EACnB,IAAI,CAAC,cAAc,IAAI,GAAG;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,QAAQ;AAAA,SACD;AAAA,MACH,OAAO,IAAI,MAAM,uCAAuC,gBAAgB;AAAA,SACrE;AAAA,MACH,OAAO,IAAI,MAAM,sCAAsC,gBAAgB;AAAA,SACpE;AAAA,MACH,OAAO,IAAI,MAAM,uCAAuC,gBAAgB;AAAA;AAAA;",
+  "debugId": "5E984ABB0F12E5E964756E2164756E21",
+  "names": []
+}