shell-dsl 0.0.28 → 0.0.29

package/README.md

@@ -695,6 +695,29 @@ Omit the mount path for unrestricted access, but this is the same as just passin
 const fs = new FileSystem();  // Full filesystem access same as fs from node:fs
 ```
 
+### OPFS (Browser)
+
+Use `OPFSFileSystem` when you already have an OPFS root directory handle in the browser:
+
+```ts
+import { OPFSFileSystem } from "shell-dsl";
+
+const root = await navigator.storage.getDirectory();
+const fs = new OPFSFileSystem(root, {
+  "secrets/**": "excluded",
+  "docs/**": "read-only",
+});
+```
+
+For advanced use, you can inject the OPFS adapter into `FileSystem` directly:
+
+```ts
+import { FileSystem, createOPFSUnderlyingFS } from "shell-dsl";
+
+const root = await navigator.storage.getDirectory();
+const fs = new FileSystem("/", {}, createOPFSUnderlyingFS(root));
+```
+
 
 ## Low-Level API
 

package/dist/cjs/package.json

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

package/dist/cjs/src/fs/index.cjs

@@ -40,12 +40,15 @@ var __export = (target, all) => {
 var exports_fs = {};
 __export(exports_fs, {
   createVirtualFS: () => import_memfs_adapter.createVirtualFS,
+  createOPFSUnderlyingFS: () => import_opfs_fs.createOPFSUnderlyingFS,
   ReadOnlyFileSystem: () => import_readonly_fs.ReadOnlyFileSystem,
+  OPFSFileSystem: () => import_opfs_fs.OPFSFileSystem,
   FileSystem: () => import_real_fs.FileSystem
 });
 module.exports = __toCommonJS(exports_fs);
 var import_memfs_adapter = require("./memfs-adapter.cjs");
 var import_real_fs = require("./real-fs.cjs");
 var import_readonly_fs = require("./readonly-fs.cjs");
+var import_opfs_fs = require("./opfs-fs.cjs");
 
-//# debugId=C25E926A7D9E568464756E2164756E21
+//# debugId=39C00A408BEE69A164756E2164756E21

package/dist/cjs/src/fs/index.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/fs/index.ts"],
   "sourcesContent": [
-    "export { createVirtualFS } from \"./memfs-adapter.cjs\";\nexport { FileSystem, type Permission, type PermissionRules, type UnderlyingFS } from \"./real-fs.cjs\";\nexport { ReadOnlyFileSystem } from \"./readonly-fs.cjs\";\n"
+    "export { createVirtualFS } from \"./memfs-adapter.cjs\";\nexport { FileSystem, type Permission, type PermissionRules, type UnderlyingFS } from \"./real-fs.cjs\";\nexport { ReadOnlyFileSystem } from \"./readonly-fs.cjs\";\nexport { OPFSFileSystem, createOPFSUnderlyingFS } from \"./opfs-fs.cjs\";\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAgC,IAAhC;AACqF,IAArF;AACmC,IAAnC;",
-  "debugId": "C25E926A7D9E568464756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAgC,IAAhC;AACqF,IAArF;AACmC,IAAnC;AACuD,IAAvD;",
+  "debugId": "39C00A408BEE69A164756E2164756E21",
   "names": []
 }

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

@@ -0,0 +1,247 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/fs/opfs-fs.ts
+var exports_opfs_fs = {};
+__export(exports_opfs_fs, {
+  createOPFSUnderlyingFS: () => createOPFSUnderlyingFS,
+  OPFSFileSystem: () => OPFSFileSystem
+});
+module.exports = __toCommonJS(exports_opfs_fs);
+var import_real_fs = require("./real-fs.cjs");
+var DIRECTORY_MTIME = new Date(0);
+function createOPFSUnderlyingFS(root) {
+  return {
+    promises: {
+      async readFile(path) {
+        const { parentSegments, name } = splitParent(path);
+        const parent = await walkDirectory(root, parentSegments, false);
+        const fileHandle = await parent.getFileHandle(name, { create: false });
+        const file = await fileHandle.getFile();
+        return Buffer.from(await file.arrayBuffer());
+      },
+      async readdir(path) {
+        const dir = await walkDirectory(root, getPathSegments(path), false);
+        const entries = [];
+        for await (const [name] of dir.entries()) {
+          entries.push(name);
+        }
+        return entries;
+      },
+      async stat(path) {
+        const segments = getPathSegments(path);
+        if (segments.length === 0) {
+          return createDirectoryStat();
+        }
+        const { parentSegments, name } = splitParent(path);
+        const parent = await walkDirectory(root, parentSegments, false);
+        try {
+          const fileHandle = await parent.getFileHandle(name, { create: false });
+          const file = await fileHandle.getFile();
+          return {
+            isFile: () => true,
+            isDirectory: () => false,
+            size: file.size,
+            mtime: new Date(file.lastModified ?? 0)
+          };
+        } catch (error) {
+          if (!isNotFoundOrTypeMismatch(error))
+            throw error;
+        }
+        try {
+          await parent.getDirectoryHandle(name, { create: false });
+          return createDirectoryStat();
+        } catch (error) {
+          if (!isNotFoundOrTypeMismatch(error))
+            throw error;
+          throw error;
+        }
+      },
+      async writeFile(path, data) {
+        const { parentSegments, name } = splitParent(path);
+        const parent = await walkDirectory(root, parentSegments, false);
+        const fileHandle = await parent.getFileHandle(name, { create: true });
+        const writable = await fileHandle.createWritable();
+        await writable.write(toWritableData(data));
+        await writable.close();
+      },
+      async appendFile(path, data) {
+        const { parentSegments, name } = splitParent(path);
+        const parent = await walkDirectory(root, parentSegments, false);
+        const fileHandle = await parent.getFileHandle(name, { create: true });
+        const file = await fileHandle.getFile();
+        const writable = await fileHandle.createWritable({ keepExistingData: true });
+        await writable.write({
+          type: "write",
+          position: file.size,
+          data: toWritableData(data)
+        });
+        await writable.close();
+      },
+      async mkdir(path, opts) {
+        const segments = getPathSegments(path);
+        if (segments.length === 0) {
+          return;
+        }
+        if (opts?.recursive) {
+          await walkDirectory(root, segments, true);
+          return;
+        }
+        const parent = await walkDirectory(root, segments.slice(0, -1), false);
+        const name = segments[segments.length - 1];
+        const exists = await entryExists(parent, name);
+        if (exists) {
+          throw new Error(`EEXIST: file already exists, mkdir '${normalizeOpfsPath(path)}'`);
+        }
+        await parent.getDirectoryHandle(name, { create: true });
+      },
+      async rm(path, opts) {
+        const segments = getPathSegments(path);
+        if (segments.length === 0) {
+          throw new Error("EPERM: operation not permitted, rm '/'");
+        }
+        const parent = await walkDirectory(root, segments.slice(0, -1), false);
+        const name = segments[segments.length - 1];
+        try {
+          await parent.removeEntry(name, { recursive: opts?.recursive });
+        } catch (error) {
+          if (opts?.force && isNotFoundError(error)) {
+            return;
+          }
+          throw error;
+        }
+      }
+    }
+  };
+}
+
+class OPFSFileSystem extends import_real_fs.FileSystem {
+  constructor(root, permissions) {
+    super("/", permissions, createOPFSUnderlyingFS(root));
+  }
+}
+function createDirectoryStat() {
+  return {
+    isFile: () => false,
+    isDirectory: () => true,
+    size: 0,
+    mtime: DIRECTORY_MTIME
+  };
+}
+function normalizeOpfsPath(path) {
+  const normalized = path.replace(/\\/g, "/");
+  const rawSegments = (normalized.startsWith("/") ? normalized : `/${normalized}`).split("/").filter(Boolean);
+  const segments = [];
+  for (const segment of rawSegments) {
+    if (segment === ".")
+      continue;
+    if (segment === "..") {
+      segments.pop();
+      continue;
+    }
+    segments.push(segment);
+  }
+  return `/${segments.join("/")}`;
+}
+function getPathSegments(path) {
+  const normalized = normalizeOpfsPath(path);
+  return normalized.split("/").filter(Boolean);
+}
+function splitParent(path) {
+  const segments = getPathSegments(path);
+  if (segments.length === 0) {
+    throw new Error(`Invalid file path: "${path}"`);
+  }
+  return {
+    parentSegments: segments.slice(0, -1),
+    name: segments[segments.length - 1]
+  };
+}
+async function walkDirectory(root, segments, create) {
+  let current = root;
+  for (const segment of segments) {
+    current = await current.getDirectoryHandle(segment, { create });
+  }
+  return current;
+}
+async function entryExists(dir, name) {
+  try {
+    await dir.getFileHandle(name, { create: false });
+    return true;
+  } catch (error) {
+    if (isTypeMismatchError(error))
+      return true;
+    if (!isNotFoundError(error))
+      throw error;
+  }
+  try {
+    await dir.getDirectoryHandle(name, { create: false });
+    return true;
+  } catch (error) {
+    if (isTypeMismatchError(error))
+      return true;
+    if (!isNotFoundError(error))
+      throw error;
+    return false;
+  }
+}
+function isNotFoundOrTypeMismatch(error) {
+  return isNotFoundError(error) || isTypeMismatchError(error);
+}
+function isNotFoundError(error) {
+  return getErrorName(error) === "NotFoundError";
+}
+function isTypeMismatchError(error) {
+  return getErrorName(error) === "TypeMismatchError";
+}
+function getErrorName(error) {
+  if (!error || typeof error !== "object")
+    return;
+  const named = error;
+  return typeof named.name === "string" ? named.name : undefined;
+}
+function toWritableData(data) {
+  if (typeof data === "string") {
+    return data;
+  }
+  const out = new Uint8Array(data.length);
+  out.set(data);
+  return out.buffer;
+}
+
+//# debugId=A8F1730E4A45379564756E2164756E21

package/dist/cjs/src/fs/opfs-fs.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/fs/opfs-fs.ts"],
+  "sourcesContent": [
+    "import { FileSystem, type PermissionRules, type UnderlyingFS } from \"./real-fs.cjs\";\n\nconst DIRECTORY_MTIME = new Date(0);\n\nexport function createOPFSUnderlyingFS(root: FileSystemDirectoryHandle): UnderlyingFS {\n  return {\n    promises: {\n      async readFile(path: string): Promise<Buffer> {\n        const { parentSegments, name } = splitParent(path);\n        const parent = await walkDirectory(root, parentSegments, false);\n        const fileHandle = await parent.getFileHandle(name, { create: false });\n        const file = await fileHandle.getFile();\n        return Buffer.from(await file.arrayBuffer());\n      },\n\n      async readdir(path: string): Promise<string[]> {\n        const dir = await walkDirectory(root, getPathSegments(path), false);\n        const entries: string[] = [];\n        for await (const [name] of dir.entries()) {\n          entries.push(name);\n        }\n        return entries;\n      },\n\n      async stat(path: string): Promise<{\n        isFile(): boolean;\n        isDirectory(): boolean;\n        size: number;\n        mtime: Date;\n      }> {\n        const segments = getPathSegments(path);\n\n        if (segments.length === 0) {\n          return createDirectoryStat();\n        }\n\n        const { parentSegments, name } = splitParent(path);\n        const parent = await walkDirectory(root, parentSegments, false);\n\n        try {\n          const fileHandle = await parent.getFileHandle(name, { create: false });\n          const file = await fileHandle.getFile();\n          return {\n            isFile: () => true,\n            isDirectory: () => false,\n            size: file.size,\n            mtime: new Date(file.lastModified ?? 0),\n          };\n        } catch (error) {\n          if (!isNotFoundOrTypeMismatch(error)) throw error;\n        }\n\n        try {\n          await parent.getDirectoryHandle(name, { create: false });\n          return createDirectoryStat();\n        } catch (error) {\n          if (!isNotFoundOrTypeMismatch(error)) throw error;\n          throw error;\n        }\n      },\n\n      async writeFile(path: string, data: Buffer | string): Promise<void> {\n        const { parentSegments, name } = splitParent(path);\n        const parent = await walkDirectory(root, parentSegments, false);\n        const fileHandle = await parent.getFileHandle(name, { create: true });\n        const writable = await fileHandle.createWritable();\n        await writable.write(toWritableData(data));\n        await writable.close();\n      },\n\n      async appendFile(path: string, data: Buffer | string): Promise<void> {\n        const { parentSegments, name } = splitParent(path);\n        const parent = await walkDirectory(root, parentSegments, false);\n        const fileHandle = await parent.getFileHandle(name, { create: true });\n        const file = await fileHandle.getFile();\n        const writable = await fileHandle.createWritable({ keepExistingData: true });\n        await writable.write({\n          type: \"write\",\n          position: file.size,\n          data: toWritableData(data),\n        });\n        await writable.close();\n      },\n\n      async mkdir(path: string, opts?: { recursive?: boolean }): Promise<void> {\n        const segments = getPathSegments(path);\n        if (segments.length === 0) {\n          return;\n        }\n\n        if (opts?.recursive) {\n          await walkDirectory(root, segments, true);\n          return;\n        }\n\n        const parent = await walkDirectory(root, segments.slice(0, -1), false);\n        const name = segments[segments.length - 1]!;\n        const exists = await entryExists(parent, name);\n        if (exists) {\n          throw new Error(`EEXIST: file already exists, mkdir '${normalizeOpfsPath(path)}'`);\n        }\n        await parent.getDirectoryHandle(name, { create: true });\n      },\n\n      async rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n        const segments = getPathSegments(path);\n        if (segments.length === 0) {\n          throw new Error(\"EPERM: operation not permitted, rm '/'\");\n        }\n\n        const parent = await walkDirectory(root, segments.slice(0, -1), false);\n        const name = segments[segments.length - 1]!;\n        try {\n          await parent.removeEntry(name, { recursive: opts?.recursive });\n        } catch (error) {\n          if (opts?.force && isNotFoundError(error)) {\n            return;\n          }\n          throw error;\n        }\n      },\n    },\n  };\n}\n\nexport class OPFSFileSystem extends FileSystem {\n  constructor(root: FileSystemDirectoryHandle, permissions?: PermissionRules) {\n    super(\"/\", permissions, createOPFSUnderlyingFS(root));\n  }\n}\n\nfunction createDirectoryStat() {\n  return {\n    isFile: () => false,\n    isDirectory: () => true,\n    size: 0,\n    mtime: DIRECTORY_MTIME,\n  };\n}\n\nfunction normalizeOpfsPath(path: string): string {\n  const normalized = path.replace(/\\\\/g, \"/\");\n  const rawSegments = (normalized.startsWith(\"/\") ? normalized : `/${normalized}`)\n    .split(\"/\")\n    .filter(Boolean);\n\n  const segments: string[] = [];\n  for (const segment of rawSegments) {\n    if (segment === \".\") continue;\n    if (segment === \"..\") {\n      segments.pop();\n      continue;\n    }\n    segments.push(segment);\n  }\n\n  return `/${segments.join(\"/\")}`;\n}\n\nfunction getPathSegments(path: string): string[] {\n  const normalized = normalizeOpfsPath(path);\n  return normalized.split(\"/\").filter(Boolean);\n}\n\nfunction splitParent(path: string): { parentSegments: string[]; name: string } {\n  const segments = getPathSegments(path);\n  if (segments.length === 0) {\n    throw new Error(`Invalid file path: \"${path}\"`);\n  }\n  return {\n    parentSegments: segments.slice(0, -1),\n    name: segments[segments.length - 1]!,\n  };\n}\n\nasync function walkDirectory(\n  root: FileSystemDirectoryHandle,\n  segments: string[],\n  create: boolean\n): Promise<FileSystemDirectoryHandle> {\n  let current = root;\n  for (const segment of segments) {\n    current = await current.getDirectoryHandle(segment, { create });\n  }\n  return current;\n}\n\nasync function entryExists(dir: FileSystemDirectoryHandle, name: string): Promise<boolean> {\n  try {\n    await dir.getFileHandle(name, { create: false });\n    return true;\n  } catch (error) {\n    if (isTypeMismatchError(error)) return true;\n    if (!isNotFoundError(error)) throw error;\n  }\n\n  try {\n    await dir.getDirectoryHandle(name, { create: false });\n    return true;\n  } catch (error) {\n    if (isTypeMismatchError(error)) return true;\n    if (!isNotFoundError(error)) throw error;\n    return false;\n  }\n}\n\nfunction isNotFoundOrTypeMismatch(error: unknown): boolean {\n  return isNotFoundError(error) || isTypeMismatchError(error);\n}\n\nfunction isNotFoundError(error: unknown): boolean {\n  return getErrorName(error) === \"NotFoundError\";\n}\n\nfunction isTypeMismatchError(error: unknown): boolean {\n  return getErrorName(error) === \"TypeMismatchError\";\n}\n\nfunction getErrorName(error: unknown): string | undefined {\n  if (!error || typeof error !== \"object\") return undefined;\n  const named = error as { name?: unknown };\n  return typeof named.name === \"string\" ? named.name : undefined;\n}\n\nfunction toWritableData(data: Buffer | string): string | ArrayBuffer {\n  if (typeof data === \"string\") {\n    return data;\n  }\n  const out = new Uint8Array(data.length);\n  out.set(data);\n  return out.buffer;\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "A8F1730E4A45379564756E2164756E21",
+  "names": []
+}

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

@@ -145,7 +145,9 @@ class FileSystem {
     const relativePath = normalized.startsWith("/") ? normalized.slice(1) : normalized;
     const realPath = path.join(this.mountBase, relativePath);
     const resolved = path.resolve(realPath);
-    if (!resolved.startsWith(this.mountBase + path.sep) && resolved !== this.mountBase) {
+    const relativeFromMount = path.relative(this.mountBase, resolved);
+    const escapesMount = relativeFromMount === ".." || relativeFromMount.startsWith(`..${path.sep}`) || path.isAbsolute(relativeFromMount);
+    if (escapesMount) {
       throw new Error(`Path traversal blocked: "${virtualPath}" escapes mount point`);
     }
     return resolved;
@@ -244,8 +246,8 @@ class FileSystem {
   }
   async matchPattern(pattern, cwd) {
     const parts = pattern.split("/").filter((p) => p !== "");
-    const isAbsolute = pattern.startsWith("/");
-    const startDir = isAbsolute ? "/" : cwd;
+    const isAbsolute2 = pattern.startsWith("/");
+    const startDir = isAbsolute2 ? "/" : cwd;
     return this.matchParts(parts, startDir);
   }
   async matchParts(parts, currentPath) {
@@ -330,4 +332,4 @@ class FileSystem {
   }
 }
 
-//# debugId=361DB3D8C708371764756E2164756E21
+//# debugId=CB9942EB884530FB64756E2164756E21

package/dist/cjs/src/fs/real-fs.cjs.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.cjs\";\n\nexport type Permission = \"read-write\" | \"read-only\" | \"excluded\";\nexport type PermissionRules = Record<string, Permission>;\n\n// Minimal interface for the underlying fs (compatible with node:fs and memfs)\nexport interface UnderlyingFS {\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 };\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  protected readonly underlyingFs: UnderlyingFS;\n\n  constructor(mountPath?: string, permissions?: PermissionRules, fs?: UnderlyingFS) {\n    this.mountBase = mountPath ? path.resolve(mountPath) : null;\n    this.rules = this.compileRules(permissions ?? {});\n    this.underlyingFs = fs ?? defaultFS;\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 path.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 = path.normalize(virtualPath);\n    const relativePath = normalized.startsWith(\"/\") ? normalized.slice(1) : normalized;\n    const realPath = path.join(this.mountBase, relativePath);\n    const resolved = path.resolve(realPath);\n\n    // Double-check containment (defense in depth)\n    if (!resolved.startsWith(this.mountBase + path.sep) && resolved !== this.mountBase) {\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 path.resolve(\"/\", ...paths);\n  }\n\n  dirname(filePath: string): string {\n    return path.dirname(filePath);\n  }\n\n  basename(filePath: string): string {\n    return path.basename(filePath);\n  }\n\n  // Glob with permission filtering\n  async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n    const cwd = opts?.cwd ?? \"/\";\n    this.checkPermission(cwd, \"read\");\n\n    const matches = await this.expandGlob(pattern, cwd);\n\n    // Filter out excluded paths\n    return matches.filter((p) => this.getPermission(p) !== \"excluded\").sort();\n  }\n\n  // Glob expansion (similar to memfs-adapter implementation)\n  private async expandGlob(pattern: string, cwd: string): Promise<string[]> {\n    // Handle brace expansion first\n    const patterns = this.expandBraces(pattern);\n    const allMatches: string[] = [];\n\n    for (const pat of patterns) {\n      const matches = await this.matchPattern(pat, cwd);\n      allMatches.push(...matches);\n    }\n\n    // Remove duplicates and sort\n    return [...new Set(allMatches)].sort();\n  }\n\n  private expandBraces(pattern: string): string[] {\n    const braceMatch = pattern.match(/\\{([^{}]+)\\}/);\n    if (!braceMatch) return [pattern];\n\n    const before = pattern.slice(0, braceMatch.index);\n    const after = pattern.slice(braceMatch.index! + braceMatch[0].length);\n    const options = braceMatch[1]!.split(\",\");\n\n    const results: string[] = [];\n    for (const opt of options) {\n      const expanded = this.expandBraces(before + opt + after);\n      results.push(...expanded);\n    }\n    return results;\n  }\n\n  private async matchPattern(pattern: string, cwd: string): Promise<string[]> {\n    const parts = pattern.split(\"/\").filter((p) => p !== \"\");\n    const isAbsolute = pattern.startsWith(\"/\");\n    const startDir = isAbsolute ? \"/\" : cwd;\n\n    return this.matchParts(parts, startDir);\n  }\n\n  private async matchParts(parts: string[], currentPath: string): Promise<string[]> {\n    if (parts.length === 0) {\n      return [currentPath];\n    }\n\n    const [part, ...rest] = parts;\n\n    // Handle ** (recursive glob)\n    if (part === \"**\") {\n      const results: string[] = [];\n\n      // Match current directory\n      const withoutStar = await this.matchParts(rest, currentPath);\n      results.push(...withoutStar);\n\n      // Recurse into subdirectories\n      try {\n        const realPath = this.resolveSafePath(currentPath);\n        const entries = await this.underlyingFs.promises.readdir(realPath);\n        for (const entry of entries) {\n          const entryPath = path.posix.join(currentPath, String(entry));\n          try {\n            const entryRealPath = this.resolveSafePath(entryPath);\n            const stat = await this.underlyingFs.promises.stat(entryRealPath);\n            if (stat.isDirectory()) {\n              const subMatches = await this.matchParts(parts, entryPath);\n              results.push(...subMatches);\n            }\n          } catch {\n            // Skip inaccessible entries\n          }\n        }\n      } catch {\n        // Directory not readable\n      }\n\n      return results;\n    }\n\n    // Handle regular glob patterns\n    const regex = this.globToRegex(part!);\n\n    try {\n      const realPath = this.resolveSafePath(currentPath);\n      const entries = await this.underlyingFs.promises.readdir(realPath);\n      const results: string[] = [];\n\n      for (const entry of entries) {\n        const entryName = String(entry);\n        if (regex.test(entryName)) {\n          const entryPath = path.posix.join(currentPath, entryName);\n          if (rest.length === 0) {\n            results.push(entryPath);\n          } else {\n            try {\n              const entryRealPath = this.resolveSafePath(entryPath);\n              const stat = await this.underlyingFs.promises.stat(entryRealPath);\n              if (stat.isDirectory()) {\n                const subMatches = await this.matchParts(rest, entryPath);\n                results.push(...subMatches);\n              }\n            } catch {\n              // Skip inaccessible entries\n            }\n          }\n        }\n      }\n\n      return results;\n    } catch {\n      return [];\n    }\n  }\n\n  private globToRegex(pattern: string): RegExp {\n    let regex = \"^\";\n    for (let i = 0; i < pattern.length; i++) {\n      const char = pattern[i]!;\n      if (char === \"*\") {\n        regex += \"[^/]*\";\n      } else if (char === \"?\") {\n        regex += \"[^/]\";\n      } else if (char === \"[\") {\n        // Character class\n        let j = i + 1;\n        let classContent = \"\";\n        while (j < pattern.length && pattern[j] !== \"]\") {\n          classContent += pattern[j];\n          j++;\n        }\n        regex += `[${classContent}]`;\n        i = j;\n      } else if (\".+^${}()|\\\\\".includes(char)) {\n        regex += \"\\\\\" + char;\n      } else {\n        regex += char;\n      }\n    }\n    regex += \"$\";\n    return new RegExp(regex);\n  }\n}\n"
+    "import * as path from \"path\";\nimport * as nodeFs from \"node:fs/promises\";\nimport type { VirtualFS, FileStat } from \"../types.cjs\";\n\nexport type Permission = \"read-write\" | \"read-only\" | \"excluded\";\nexport type PermissionRules = Record<string, Permission>;\n\n// Minimal interface for the underlying fs (compatible with node:fs and memfs)\nexport interface UnderlyingFS {\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 };\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  protected readonly underlyingFs: UnderlyingFS;\n\n  constructor(mountPath?: string, permissions?: PermissionRules, fs?: UnderlyingFS) {\n    this.mountBase = mountPath ? path.resolve(mountPath) : null;\n    this.rules = this.compileRules(permissions ?? {});\n    this.underlyingFs = fs ?? defaultFS;\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 path.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 = path.normalize(virtualPath);\n    const relativePath = normalized.startsWith(\"/\") ? normalized.slice(1) : normalized;\n    const realPath = path.join(this.mountBase, relativePath);\n    const resolved = path.resolve(realPath);\n\n    // Double-check containment (defense in depth), including root mounts.\n    const relativeFromMount = path.relative(this.mountBase, resolved);\n    const escapesMount =\n      relativeFromMount === \"..\" ||\n      relativeFromMount.startsWith(`..${path.sep}`) ||\n      path.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 path.resolve(\"/\", ...paths);\n  }\n\n  dirname(filePath: string): string {\n    return path.dirname(filePath);\n  }\n\n  basename(filePath: string): string {\n    return path.basename(filePath);\n  }\n\n  // Glob with permission filtering\n  async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n    const cwd = opts?.cwd ?? \"/\";\n    this.checkPermission(cwd, \"read\");\n\n    const matches = await this.expandGlob(pattern, cwd);\n\n    // Filter out excluded paths\n    return matches.filter((p) => this.getPermission(p) !== \"excluded\").sort();\n  }\n\n  // Glob expansion (similar to memfs-adapter implementation)\n  private async expandGlob(pattern: string, cwd: string): Promise<string[]> {\n    // Handle brace expansion first\n    const patterns = this.expandBraces(pattern);\n    const allMatches: string[] = [];\n\n    for (const pat of patterns) {\n      const matches = await this.matchPattern(pat, cwd);\n      allMatches.push(...matches);\n    }\n\n    // Remove duplicates and sort\n    return [...new Set(allMatches)].sort();\n  }\n\n  private expandBraces(pattern: string): string[] {\n    const braceMatch = pattern.match(/\\{([^{}]+)\\}/);\n    if (!braceMatch) return [pattern];\n\n    const before = pattern.slice(0, braceMatch.index);\n    const after = pattern.slice(braceMatch.index! + braceMatch[0].length);\n    const options = braceMatch[1]!.split(\",\");\n\n    const results: string[] = [];\n    for (const opt of options) {\n      const expanded = this.expandBraces(before + opt + after);\n      results.push(...expanded);\n    }\n    return results;\n  }\n\n  private async matchPattern(pattern: string, cwd: string): Promise<string[]> {\n    const parts = pattern.split(\"/\").filter((p) => p !== \"\");\n    const isAbsolute = pattern.startsWith(\"/\");\n    const startDir = isAbsolute ? \"/\" : cwd;\n\n    return this.matchParts(parts, startDir);\n  }\n\n  private async matchParts(parts: string[], currentPath: string): Promise<string[]> {\n    if (parts.length === 0) {\n      return [currentPath];\n    }\n\n    const [part, ...rest] = parts;\n\n    // Handle ** (recursive glob)\n    if (part === \"**\") {\n      const results: string[] = [];\n\n      // Match current directory\n      const withoutStar = await this.matchParts(rest, currentPath);\n      results.push(...withoutStar);\n\n      // Recurse into subdirectories\n      try {\n        const realPath = this.resolveSafePath(currentPath);\n        const entries = await this.underlyingFs.promises.readdir(realPath);\n        for (const entry of entries) {\n          const entryPath = path.posix.join(currentPath, String(entry));\n          try {\n            const entryRealPath = this.resolveSafePath(entryPath);\n            const stat = await this.underlyingFs.promises.stat(entryRealPath);\n            if (stat.isDirectory()) {\n              const subMatches = await this.matchParts(parts, entryPath);\n              results.push(...subMatches);\n            }\n          } catch {\n            // Skip inaccessible entries\n          }\n        }\n      } catch {\n        // Directory not readable\n      }\n\n      return results;\n    }\n\n    // Handle regular glob patterns\n    const regex = this.globToRegex(part!);\n\n    try {\n      const realPath = this.resolveSafePath(currentPath);\n      const entries = await this.underlyingFs.promises.readdir(realPath);\n      const results: string[] = [];\n\n      for (const entry of entries) {\n        const entryName = String(entry);\n        if (regex.test(entryName)) {\n          const entryPath = path.posix.join(currentPath, entryName);\n          if (rest.length === 0) {\n            results.push(entryPath);\n          } else {\n            try {\n              const entryRealPath = this.resolveSafePath(entryPath);\n              const stat = await this.underlyingFs.promises.stat(entryRealPath);\n              if (stat.isDirectory()) {\n                const subMatches = await this.matchParts(rest, entryPath);\n                results.push(...subMatches);\n              }\n            } catch {\n              // Skip inaccessible entries\n            }\n          }\n        }\n      }\n\n      return results;\n    } catch {\n      return [];\n    }\n  }\n\n  private globToRegex(pattern: string): RegExp {\n    let regex = \"^\";\n    for (let i = 0; i < pattern.length; i++) {\n      const char = pattern[i]!;\n      if (char === \"*\") {\n        regex += \"[^/]*\";\n      } else if (char === \"?\") {\n        regex += \"[^/]\";\n      } else if (char === \"[\") {\n        // Character class\n        let j = i + 1;\n        let classContent = \"\";\n        while (j < pattern.length && pattern[j] !== \"]\") {\n          classContent += pattern[j];\n          j++;\n        }\n        regex += `[${classContent}]`;\n        i = j;\n      } else if (\".+^${}()|\\\\\".includes(char)) {\n        regex += \"\\\\\" + char;\n      } else {\n        regex += char;\n      }\n    }\n    regex += \"$\";\n    return new RegExp(regex);\n  }\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "361DB3D8C708371764756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAsB,IAAtB;AACwB,IAAxB;AAyBA,IAAM,YAA0B,EAAE,UAAU,OAAO;AAAA;AAQ5C,MAAM,WAAgC;AAAA,EAC1B;AAAA,EACA;AAAA,EACE;AAAA,EAEnB,WAAW,CAAC,WAAoB,aAA+B,IAAmB;AAAA,IAChF,KAAK,YAAY,YAAiB,aAAQ,SAAS,IAAI;AAAA,IACvD,KAAK,QAAQ,KAAK,aAAa,eAAe,CAAC,CAAC;AAAA,IAChD,KAAK,eAAe,MAAM;AAAA;AAAA,EAGpB,YAAY,CAAC,aAA8C;AAAA,IACjE,OAAO,OAAO,QAAQ,WAAW,EAC9B,IAAI,EAAE,SAAS,iBAAiB;AAAA,MAC/B;AAAA,MACA;AAAA,MACA,aAAa,KAAK,qBAAqB,OAAO;AAAA,IAChD,EAAE,EACD,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,EAAE,WAAW;AAAA;AAAA,EAGzC,oBAAoB,CAAC,SAAyB;AAAA,IACpD,MAAM,WAAW,QAAQ,MAAM,GAAG,EAAE,OAAO,OAAO;AAAA,IAClD,IAAI,QAAQ,SAAS,SAAS;AAAA,IAE9B,WAAW,OAAO,UAAU;AAAA,MAC1B,IAAI,QAAQ;AAAA,QAAM,SAAS;AAAA,MACtB,SAAI,IAAI,SAAS,GAAG;AAAA,QAAG,SAAS;AAAA,MAChC;AAAA,iBAAS;AAAA,IAChB;AAAA,IACA,OAAO;AAAA;AAAA,EAGF,aAAa,CAAC,aAAiC;AAAA,IACpD,MAAM,aAAa,YAAY,QAAQ,QAAQ,EAAE;AAAA,IAEjD,WAAW,QAAQ,KAAK,OAAO;AAAA,MAC7B,IAAI,KAAK,UAAU,KAAK,SAAS,UAAU,GAAG;AAAA,QAC5C,OAAO,KAAK;AAAA,MACd;AAAA,IACF;AAAA,IACA,OAAO;AAAA;AAAA,EAGD,SAAS,CAAC,SAAiB,UAA2B;AAAA,IAG5D,MAAM,QAAQ,QACX,MAAM,GAAG,EACT,IAAI,CAAC,QAAQ;AAAA,MACZ,IAAI,QAAQ;AAAA,QAAM,OAAO;AAAA,MACzB,OAAO,IAAI,QAAQ,OAAO,OAAO,EAAE,QAAQ,OAAO,MAAM;AAAA,KACzD,EACA,KAAK,GAAG;AAAA,IACX,OAAO,IAAI,OAAO,IAAI,QAAQ,EAAE,KAAK,QAAQ;AAAA;AAAA,EAGxC,eAAe,CAAC,aAAqB,WAAmC;AAAA,IAC7E,MAAM,OAAO,KAAK,cAAc,WAAW;AAAA,IAE3C,IAAI,SAAS,YAAY;AAAA,MACvB,MAAM,IAAI,MAAM,mBAAmB,0BAA0B;AAAA,IAC/D;AAAA,IACA,IAAI,cAAc,WAAW,SAAS,aAAa;AAAA,MACjD,MAAM,IAAI,MAAM,mBAAmB,2BAA2B;AAAA,IAChE;AAAA;AAAA,EAGM,eAAe,CAAC,aAA6B;AAAA,IACnD,IAAI,KAAK,cAAc,MAAM;AAAA,MAC3B,OAAY,aAAQ,WAAW;AAAA,IACjC;AAAA,IAGA,MAAM,WAAW,YAAY,MAAM,GAAG,EAAE,OAAO,OAAO;AAAA,IACtD,IAAI,QAAQ;AAAA,IACZ,WAAW,OAAO,UAAU;AAAA,MAC1B,IAAI,QAAQ,MAAM;AAAA,QAChB;AAAA,QACA,IAAI,QAAQ,GAAG;AAAA,UACb,MAAM,IAAI,MAAM,4BAA4B,kCAAkC;AAAA,QAChF;AAAA,MACF,EAAO,SAAI,QAAQ,KAAK;AAAA,QACtB;AAAA,MACF;AAAA,IACF;AAAA,IAEA,MAAM,aAAkB,eAAU,WAAW;AAAA,IAC7C,MAAM,eAAe,WAAW,WAAW,GAAG,IAAI,WAAW,MAAM,CAAC,IAAI;AAAA,IACxE,MAAM,WAAgB,UAAK,KAAK,WAAW,YAAY;AAAA,IACvD,MAAM,WAAgB,aAAQ,QAAQ;AAAA,IAGtC,MAAM,oBAAyB,cAAS,KAAK,WAAW,QAAQ;AAAA,IAChE,MAAM,eACJ,sBAAsB,QACtB,kBAAkB,WAAW,KAAU,UAAK,KACvC,gBAAW,iBAAiB;AAAA,IACnC,IAAI,cAAc;AAAA,MAChB,MAAM,IAAI,MAAM,4BAA4B,kCAAkC;AAAA,IAChF;AAAA,IAEA,OAAO;AAAA;AAAA,OAMH,SAAQ,CAAC,UAAkB,UAAqD;AAAA,IACpF,KAAK,gBAAgB,UAAU,MAAM;AAAA,IACrC,MAAM,WAAW,KAAK,gBAAgB,QAAQ;AAAA,IAC9C,MAAM,UAAU,MAAM,KAAK,aAAa,SAAS,SAAS,QAAQ;AAAA,IAClE,MAAM,MAAM,OAAO,KAAK,OAAO;AAAA,IAC/B,OAAO,WAAW,IAAI,SAAS,QAAQ,IAAI;AAAA;AAAA,OAGvC,QAAO,CAAC,SAAoC;AAAA,IAChD,KAAK,gBAAgB,SAAS,MAAM;AAAA,IACpC,MAAM,WAAW,KAAK,gBAAgB,OAAO;AAAA,IAC7C,MAAM,UAAU,MAAM,KAAK,aAAa,SAAS,QAAQ,QAAQ;AAAA,IACjE,OAAO,QAAQ,IAAI,MAAM;AAAA;AAAA,OAGrB,KAAI,CAAC,UAAqC;AAAA,IAC9C,KAAK,gBAAgB,UAAU,MAAM;AAAA,IACrC,MAAM,WAAW,KAAK,gBAAgB,QAAQ;AAAA,IAC9C,MAAM,QAAQ,MAAM,KAAK,aAAa,SAAS,KAAK,QAAQ;AAAA,IAC5D,OAAO;AAAA,MACL,QAAQ,MAAM,MAAM,OAAO;AAAA,MAC3B,aAAa,MAAM,MAAM,YAAY;AAAA,MACrC,MAAM,MAAM;AAAA,MACZ,OAAO,MAAM;AAAA,IACf;AAAA;AAAA,OAGI,OAAM,CAAC,UAAoC;AAAA,IAC/C,IAAI;AAAA,MACF,KAAK,gBAAgB,UAAU,MAAM;AAAA,MACrC,MAAM,WAAW,KAAK,gBAAgB,QAAQ;AAAA,MAC9C,MAAM,KAAK,aAAa,SAAS,KAAK,QAAQ;AAAA,MAC9C,OAAO;AAAA,MACP,MAAM;AAAA,MACN,OAAO;AAAA;AAAA;AAAA,OAKL,UAAS,CAAC,UAAkB,MAAsC;AAAA,IACtE,KAAK,gBAAgB,UAAU,OAAO;AAAA,IACtC,MAAM,WAAW,KAAK,gBAAgB,QAAQ;AAAA,IAC9C,MAAM,KAAK,aAAa,SAAS,UAAU,UAAU,IAAI;AAAA;AAAA,OAGrD,WAAU,CAAC,UAAkB,MAAsC;AAAA,IACvE,KAAK,gBAAgB,UAAU,OAAO;AAAA,IACtC,MAAM,WAAW,KAAK,gBAAgB,QAAQ;AAAA,IAC9C,MAAM,KAAK,aAAa,SAAS,WAAW,UAAU,IAAI;AAAA;AAAA,OAGtD,MAAK,CAAC,SAAiB,MAA+C;AAAA,IAC1E,KAAK,gBAAgB,SAAS,OAAO;AAAA,IACrC,MAAM,WAAW,KAAK,gBAAgB,OAAO;AAAA,IAC7C,MAAM,KAAK,aAAa,SAAS,MAAM,UAAU,IAAI;AAAA;AAAA,OAGjD,GAAE,CAAC,UAAkB,MAAgE;AAAA,IACzF,KAAK,gBAAgB,UAAU,OAAO;AAAA,IACtC,MAAM,WAAW,KAAK,gBAAgB,QAAQ;AAAA,IAC9C,MAAM,KAAK,aAAa,SAAS,GAAG,UAAU,IAAI;AAAA;AAAA,EAIpD,OAAO,IAAI,OAAyB;AAAA,IAClC,OAAY,aAAQ,KAAK,GAAG,KAAK;AAAA;AAAA,EAGnC,OAAO,CAAC,UAA0B;AAAA,IAChC,OAAY,aAAQ,QAAQ;AAAA;AAAA,EAG9B,QAAQ,CAAC,UAA0B;AAAA,IACjC,OAAY,cAAS,QAAQ;AAAA;AAAA,OAIzB,KAAI,CAAC,SAAiB,MAA4C;AAAA,IACtE,MAAM,MAAM,MAAM,OAAO;AAAA,IACzB,KAAK,gBAAgB,KAAK,MAAM;AAAA,IAEhC,MAAM,UAAU,MAAM,KAAK,WAAW,SAAS,GAAG;AAAA,IAGlD,OAAO,QAAQ,OAAO,CAAC,MAAM,KAAK,cAAc,CAAC,MAAM,UAAU,EAAE,KAAK;AAAA;AAAA,OAI5D,WAAU,CAAC,SAAiB,KAAgC;AAAA,IAExE,MAAM,WAAW,KAAK,aAAa,OAAO;AAAA,IAC1C,MAAM,aAAuB,CAAC;AAAA,IAE9B,WAAW,OAAO,UAAU;AAAA,MAC1B,MAAM,UAAU,MAAM,KAAK,aAAa,KAAK,GAAG;AAAA,MAChD,WAAW,KAAK,GAAG,OAAO;AAAA,IAC5B;AAAA,IAGA,OAAO,CAAC,GAAG,IAAI,IAAI,UAAU,CAAC,EAAE,KAAK;AAAA;AAAA,EAG/B,YAAY,CAAC,SAA2B;AAAA,IAC9C,MAAM,aAAa,QAAQ,MAAM,cAAc;AAAA,IAC/C,IAAI,CAAC;AAAA,MAAY,OAAO,CAAC,OAAO;AAAA,IAEhC,MAAM,SAAS,QAAQ,MAAM,GAAG,WAAW,KAAK;AAAA,IAChD,MAAM,QAAQ,QAAQ,MAAM,WAAW,QAAS,WAAW,GAAG,MAAM;AAAA,IACpE,MAAM,UAAU,WAAW,GAAI,MAAM,GAAG;AAAA,IAExC,MAAM,UAAoB,CAAC;AAAA,IAC3B,WAAW,OAAO,SAAS;AAAA,MACzB,MAAM,WAAW,KAAK,aAAa,SAAS,MAAM,KAAK;AAAA,MACvD,QAAQ,KAAK,GAAG,QAAQ;AAAA,IAC1B;AAAA,IACA,OAAO;AAAA;AAAA,OAGK,aAAY,CAAC,SAAiB,KAAgC;AAAA,IAC1E,MAAM,QAAQ,QAAQ,MAAM,GAAG,EAAE,OAAO,CAAC,MAAM,MAAM,EAAE;AAAA,IACvD,MAAM,cAAa,QAAQ,WAAW,GAAG;AAAA,IACzC,MAAM,WAAW,cAAa,MAAM;AAAA,IAEpC,OAAO,KAAK,WAAW,OAAO,QAAQ;AAAA;AAAA,OAG1B,WAAU,CAAC,OAAiB,aAAwC;AAAA,IAChF,IAAI,MAAM,WAAW,GAAG;AAAA,MACtB,OAAO,CAAC,WAAW;AAAA,IACrB;AAAA,IAEA,OAAO,SAAS,QAAQ;AAAA,IAGxB,IAAI,SAAS,MAAM;AAAA,MACjB,MAAM,UAAoB,CAAC;AAAA,MAG3B,MAAM,cAAc,MAAM,KAAK,WAAW,MAAM,WAAW;AAAA,MAC3D,QAAQ,KAAK,GAAG,WAAW;AAAA,MAG3B,IAAI;AAAA,QACF,MAAM,WAAW,KAAK,gBAAgB,WAAW;AAAA,QACjD,MAAM,UAAU,MAAM,KAAK,aAAa,SAAS,QAAQ,QAAQ;AAAA,QACjE,WAAW,SAAS,SAAS;AAAA,UAC3B,MAAM,YAAiB,WAAM,KAAK,aAAa,OAAO,KAAK,CAAC;AAAA,UAC5D,IAAI;AAAA,YACF,MAAM,gBAAgB,KAAK,gBAAgB,SAAS;AAAA,YACpD,MAAM,OAAO,MAAM,KAAK,aAAa,SAAS,KAAK,aAAa;AAAA,YAChE,IAAI,KAAK,YAAY,GAAG;AAAA,cACtB,MAAM,aAAa,MAAM,KAAK,WAAW,OAAO,SAAS;AAAA,cACzD,QAAQ,KAAK,GAAG,UAAU;AAAA,YAC5B;AAAA,YACA,MAAM;AAAA,QAGV;AAAA,QACA,MAAM;AAAA,MAIR,OAAO;AAAA,IACT;AAAA,IAGA,MAAM,QAAQ,KAAK,YAAY,IAAK;AAAA,IAEpC,IAAI;AAAA,MACF,MAAM,WAAW,KAAK,gBAAgB,WAAW;AAAA,MACjD,MAAM,UAAU,MAAM,KAAK,aAAa,SAAS,QAAQ,QAAQ;AAAA,MACjE,MAAM,UAAoB,CAAC;AAAA,MAE3B,WAAW,SAAS,SAAS;AAAA,QAC3B,MAAM,YAAY,OAAO,KAAK;AAAA,QAC9B,IAAI,MAAM,KAAK,SAAS,GAAG;AAAA,UACzB,MAAM,YAAiB,WAAM,KAAK,aAAa,SAAS;AAAA,UACxD,IAAI,KAAK,WAAW,GAAG;AAAA,YACrB,QAAQ,KAAK,SAAS;AAAA,UACxB,EAAO;AAAA,YACL,IAAI;AAAA,cACF,MAAM,gBAAgB,KAAK,gBAAgB,SAAS;AAAA,cACpD,MAAM,OAAO,MAAM,KAAK,aAAa,SAAS,KAAK,aAAa;AAAA,cAChE,IAAI,KAAK,YAAY,GAAG;AAAA,gBACtB,MAAM,aAAa,MAAM,KAAK,WAAW,MAAM,SAAS;AAAA,gBACxD,QAAQ,KAAK,GAAG,UAAU;AAAA,cAC5B;AAAA,cACA,MAAM;AAAA;AAAA,QAIZ;AAAA,MACF;AAAA,MAEA,OAAO;AAAA,MACP,MAAM;AAAA,MACN,OAAO,CAAC;AAAA;AAAA;AAAA,EAIJ,WAAW,CAAC,SAAyB;AAAA,IAC3C,IAAI,QAAQ;AAAA,IACZ,SAAS,IAAI,EAAG,IAAI,QAAQ,QAAQ,KAAK;AAAA,MACvC,MAAM,OAAO,QAAQ;AAAA,MACrB,IAAI,SAAS,KAAK;AAAA,QAChB,SAAS;AAAA,MACX,EAAO,SAAI,SAAS,KAAK;AAAA,QACvB,SAAS;AAAA,MACX,EAAO,SAAI,SAAS,KAAK;AAAA,QAEvB,IAAI,IAAI,IAAI;AAAA,QACZ,IAAI,eAAe;AAAA,QACnB,OAAO,IAAI,QAAQ,UAAU,QAAQ,OAAO,KAAK;AAAA,UAC/C,gBAAgB,QAAQ;AAAA,UACxB;AAAA,QACF;AAAA,QACA,SAAS,IAAI;AAAA,QACb,IAAI;AAAA,MACN,EAAO,SAAI,cAAc,SAAS,IAAI,GAAG;AAAA,QACvC,SAAS,OAAO;AAAA,MAClB,EAAO;AAAA,QACL,SAAS;AAAA;AAAA,IAEb;AAAA,IACA,SAAS;AAAA,IACT,OAAO,IAAI,OAAO,KAAK;AAAA;AAE3B;",
+  "debugId": "CB9942EB884530FB64756E2164756E21",
   "names": []
 }

package/dist/cjs/src/index.cjs

@@ -67,6 +67,7 @@ __export(exports_src, {
   createStderr: () => import_io2.createStderr,
   createShellDSL: () => import_shell_dsl.createShellDSL,
   createPipe: () => import_io2.createPipe,
+  createOPFSUnderlyingFS: () => import_fs2.createOPFSUnderlyingFS,
   StdinImpl: () => import_io.StdinImpl,
   ShellPromise: () => import_shell_promise.ShellPromise,
   ShellError: () => import_errors.ShellError,
@@ -76,6 +77,7 @@ __export(exports_src, {
   Parser: () => import_parser.Parser,
   ParseError: () => import_errors.ParseError,
   OutputCollectorImpl: () => import_io2.OutputCollectorImpl,
+  OPFSFileSystem: () => import_fs2.OPFSFileSystem,
   Lexer: () => import_lexer.Lexer,
   LexError: () => import_errors.LexError,
   Interpreter: () => import_interpreter.Interpreter,
@@ -98,4 +100,4 @@ var import_io = require("./io/index.cjs");
 var import_io2 = require("./io/index.cjs");
 var import_utils = require("./utils/index.cjs");
 
-//# debugId=CE17363E1DD27E2264756E2164756E21
+//# debugId=6C82E1C1008ACE2064756E2164756E21

package/dist/cjs/src/index.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../src/index.ts"],
   "sourcesContent": [
-    "// Main class exports\nexport { ShellDSL, createShellDSL, type Program } from \"./shell-dsl.cjs\";\nexport { ShellPromise, type ShellPromiseOptions } from \"./shell-promise.cjs\";\n\n// Types\nexport type {\n  VirtualFS,\n  FileStat,\n  Command,\n  CommandContext,\n  Stdin,\n  Stdout,\n  Stderr,\n  OutputCollector,\n  ExecResult,\n  ShellConfig,\n  RawValue,\n} from \"./types.cjs\";\nexport { isRawValue } from \"./types.cjs\";\n\n// Errors\nexport { ShellError, LexError, ParseError } from \"./errors.cjs\";\n\n// Lexer\nexport { Lexer, lex, tokenToString } from \"./lexer/index.cjs\";\nexport type { Token, RedirectMode } from \"./lexer/index.cjs\";\n\n// Parser\nexport { Parser, parse } from \"./parser/index.cjs\";\nexport type {\n  ASTNode,\n  Redirect,\n  CommandNode,\n  PipelineNode,\n  AndNode,\n  OrNode,\n  SequenceNode,\n  LiteralNode,\n  VariableNode,\n  SubstitutionNode,\n  GlobNode,\n  ConcatNode,\n  IfNode,\n  ForNode,\n  WhileNode,\n  UntilNode,\n  CaseNode,\n  CaseClause,\n  ArithmeticNode,\n} from \"./parser/index.cjs\";\nexport {\n  isCommandNode,\n  isPipelineNode,\n  isAndNode,\n  isOrNode,\n  isSequenceNode,\n  isLiteralNode,\n  isVariableNode,\n  isSubstitutionNode,\n  isGlobNode,\n  isConcatNode,\n  isIfNode,\n  isForNode,\n  isWhileNode,\n  isUntilNode,\n  isCaseNode,\n  isArithmeticNode,\n} from \"./parser/index.cjs\";\n\n// Interpreter\nexport { Interpreter, type InterpreterOptions, BreakException, ContinueException } from \"./interpreter/index.cjs\";\n\n// Filesystem\nexport { createVirtualFS } from \"./fs/index.cjs\";\nexport {\n  FileSystem,\n  ReadOnlyFileSystem,\n  type Permission,\n  type PermissionRules,\n  type UnderlyingFS,\n} from \"./fs/index.cjs\";\n\n// I/O\nexport { createStdin, StdinImpl } from \"./io/index.cjs\";\nexport { createStdout, createStderr, createPipe, OutputCollectorImpl, PipeBuffer } from \"./io/index.cjs\";\n\n// Utilities\nexport { escape, escapeForInterpolation } from \"./utils/index.cjs\";\n"
+    "// Main class exports\nexport { ShellDSL, createShellDSL, type Program } from \"./shell-dsl.cjs\";\nexport { ShellPromise, type ShellPromiseOptions } from \"./shell-promise.cjs\";\n\n// Types\nexport type {\n  VirtualFS,\n  FileStat,\n  Command,\n  CommandContext,\n  Stdin,\n  Stdout,\n  Stderr,\n  OutputCollector,\n  ExecResult,\n  ShellConfig,\n  RawValue,\n} from \"./types.cjs\";\nexport { isRawValue } from \"./types.cjs\";\n\n// Errors\nexport { ShellError, LexError, ParseError } from \"./errors.cjs\";\n\n// Lexer\nexport { Lexer, lex, tokenToString } from \"./lexer/index.cjs\";\nexport type { Token, RedirectMode } from \"./lexer/index.cjs\";\n\n// Parser\nexport { Parser, parse } from \"./parser/index.cjs\";\nexport type {\n  ASTNode,\n  Redirect,\n  CommandNode,\n  PipelineNode,\n  AndNode,\n  OrNode,\n  SequenceNode,\n  LiteralNode,\n  VariableNode,\n  SubstitutionNode,\n  GlobNode,\n  ConcatNode,\n  IfNode,\n  ForNode,\n  WhileNode,\n  UntilNode,\n  CaseNode,\n  CaseClause,\n  ArithmeticNode,\n} from \"./parser/index.cjs\";\nexport {\n  isCommandNode,\n  isPipelineNode,\n  isAndNode,\n  isOrNode,\n  isSequenceNode,\n  isLiteralNode,\n  isVariableNode,\n  isSubstitutionNode,\n  isGlobNode,\n  isConcatNode,\n  isIfNode,\n  isForNode,\n  isWhileNode,\n  isUntilNode,\n  isCaseNode,\n  isArithmeticNode,\n} from \"./parser/index.cjs\";\n\n// Interpreter\nexport { Interpreter, type InterpreterOptions, BreakException, ContinueException } from \"./interpreter/index.cjs\";\n\n// Filesystem\nexport { createVirtualFS } from \"./fs/index.cjs\";\nexport {\n  FileSystem,\n  ReadOnlyFileSystem,\n  OPFSFileSystem,\n  createOPFSUnderlyingFS,\n  type Permission,\n  type PermissionRules,\n  type UnderlyingFS,\n} from \"./fs/index.cjs\";\n\n// I/O\nexport { createStdin, StdinImpl } from \"./io/index.cjs\";\nexport { createStdout, createStderr, createPipe, OutputCollectorImpl, PipeBuffer } from \"./io/index.cjs\";\n\n// Utilities\nexport { escape, escapeForInterpolation } from \"./utils/index.cjs\";\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACuD,IAAvD;AACuD,IAAvD;AAgB2B,IAA3B;AAGiD,IAAjD;AAG0C,IAA1C;AAI8B,IAA9B;AAuCO,IAjBP;AAoBwF,IAAxF;AAGgC,IAAhC;AAOO,IANP;AASuC,IAAvC;AACwF,IAAxF;AAG+C,IAA/C;",
-  "debugId": "CE17363E1DD27E2264756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACuD,IAAvD;AACuD,IAAvD;AAgB2B,IAA3B;AAGiD,IAAjD;AAG0C,IAA1C;AAI8B,IAA9B;AAuCO,IAjBP;AAoBwF,IAAxF;AAGgC,IAAhC;AASO,IARP;AAWuC,IAAvC;AACwF,IAAxF;AAG+C,IAA/C;",
+  "debugId": "6C82E1C1008ACE2064756E2164756E21",
   "names": []
 }

package/dist/cjs/src/shell-promise.cjs

@@ -101,7 +101,7 @@ class ShellPromise {
   }
   async blob() {
     const result = await this.run();
-    return new Blob([result.stdout]);
+    return new Blob([new Uint8Array(result.stdout)]);
   }
   async buffer() {
     const result = await this.run();
@@ -166,4 +166,4 @@ class ShellPromise {
   }
 }
 
-//# debugId=3425E56DF2B7E24B64756E2164756E21
+//# debugId=DFBD1041E32C91CE64756E2164756E21

package/dist/cjs/src/shell-promise.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../src/shell-promise.ts"],
   "sourcesContent": [
-    "import type { ExecResult } from \"./types.cjs\";\nimport { ShellError } from \"./errors.cjs\";\n\nexport interface ExecuteOverrides {\n  cwd?: string;\n  env?: Record<string, string>;\n}\n\nexport interface ShellPromiseOptions {\n  execute: (overrides: ExecuteOverrides) => Promise<ExecResult>;\n  cwdOverride?: string;\n  envOverride?: Record<string, string>;\n  shouldThrow?: boolean;\n  quiet?: boolean;\n}\n\nexport class ShellPromise implements PromiseLike<ExecResult> {\n  private executor: (overrides: ExecuteOverrides) => Promise<ExecResult>;\n  private cwdOverride?: string;\n  private envOverride?: Record<string, string>;\n  private shouldThrow: boolean;\n  private isQuiet: boolean;\n  private cachedResult?: Promise<ExecResult>;\n\n  constructor(options: ShellPromiseOptions) {\n    this.executor = options.execute;\n    this.cwdOverride = options.cwdOverride;\n    this.envOverride = options.envOverride;\n    this.shouldThrow = options.shouldThrow ?? true;\n    this.isQuiet = options.quiet ?? false;\n  }\n\n  private async run(): Promise<ExecResult> {\n    if (!this.cachedResult) {\n      this.cachedResult = this.executor({\n        cwd: this.cwdOverride,\n        env: this.envOverride,\n      });\n    }\n\n    const result = await this.cachedResult;\n\n    if (this.shouldThrow && result.exitCode !== 0) {\n      throw new ShellError(\n        `Command failed with exit code ${result.exitCode}`,\n        result.stdout,\n        result.stderr,\n        result.exitCode\n      );\n    }\n\n    return result;\n  }\n\n  then<TResult1 = ExecResult, TResult2 = never>(\n    onfulfilled?: ((value: ExecResult) => TResult1 | PromiseLike<TResult1>) | null,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null\n  ): Promise<TResult1 | TResult2> {\n    return this.run().then(onfulfilled, onrejected);\n  }\n\n  catch<TResult = never>(\n    onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null\n  ): Promise<ExecResult | TResult> {\n    return this.run().catch(onrejected);\n  }\n\n  finally(onfinally?: (() => void) | null): Promise<ExecResult> {\n    return this.run().finally(onfinally);\n  }\n\n  // Output formats\n  async text(): Promise<string> {\n    const result = await this.run();\n    return result.stdout.toString(\"utf-8\");\n  }\n\n  async json<T = unknown>(): Promise<T> {\n    const text = await this.text();\n    return JSON.parse(text);\n  }\n\n  async *lines(): AsyncIterable<string> {\n    const text = await this.text();\n    const lines = text.split(\"\\n\");\n    // Remove trailing empty line if present\n    if (lines[lines.length - 1] === \"\") {\n      lines.pop();\n    }\n    for (const line of lines) {\n      yield line;\n    }\n  }\n\n  async blob(): Promise<Blob> {\n    const result = await this.run();\n    return new Blob([result.stdout]);\n  }\n\n  async buffer(): Promise<Buffer> {\n    const result = await this.run();\n    return result.stdout;\n  }\n\n  // Behavior modifiers - return new ShellPromise with modified options\n  quiet(): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: this.cwdOverride,\n      envOverride: this.envOverride,\n      shouldThrow: this.shouldThrow,\n      quiet: true,\n    });\n  }\n\n  nothrow(): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: this.cwdOverride,\n      envOverride: this.envOverride,\n      shouldThrow: false,\n      quiet: this.isQuiet,\n    });\n  }\n\n  throws(enable: boolean): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: this.cwdOverride,\n      envOverride: this.envOverride,\n      shouldThrow: enable,\n      quiet: this.isQuiet,\n    });\n  }\n\n  // Context overrides - these need to be handled by the shell\n  cwd(path: string): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: path,\n      envOverride: this.envOverride,\n      shouldThrow: this.shouldThrow,\n      quiet: this.isQuiet,\n    });\n  }\n\n  env(vars: Record<string, string>): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: this.cwdOverride,\n      envOverride: { ...this.envOverride, ...vars },\n      shouldThrow: this.shouldThrow,\n      quiet: this.isQuiet,\n    });\n  }\n\n  // Getters for internal state (used by ShellDSL)\n  getCwdOverride(): string | undefined {\n    return this.cwdOverride;\n  }\n\n  getEnvOverride(): Record<string, string> | undefined {\n    return this.envOverride;\n  }\n\n  getShouldThrow(): boolean {\n    return this.shouldThrow;\n  }\n\n  getIsQuiet(): boolean {\n    return this.isQuiet;\n  }\n}\n"
+    "import type { ExecResult } from \"./types.cjs\";\nimport { ShellError } from \"./errors.cjs\";\n\nexport interface ExecuteOverrides {\n  cwd?: string;\n  env?: Record<string, string>;\n}\n\nexport interface ShellPromiseOptions {\n  execute: (overrides: ExecuteOverrides) => Promise<ExecResult>;\n  cwdOverride?: string;\n  envOverride?: Record<string, string>;\n  shouldThrow?: boolean;\n  quiet?: boolean;\n}\n\nexport class ShellPromise implements PromiseLike<ExecResult> {\n  private executor: (overrides: ExecuteOverrides) => Promise<ExecResult>;\n  private cwdOverride?: string;\n  private envOverride?: Record<string, string>;\n  private shouldThrow: boolean;\n  private isQuiet: boolean;\n  private cachedResult?: Promise<ExecResult>;\n\n  constructor(options: ShellPromiseOptions) {\n    this.executor = options.execute;\n    this.cwdOverride = options.cwdOverride;\n    this.envOverride = options.envOverride;\n    this.shouldThrow = options.shouldThrow ?? true;\n    this.isQuiet = options.quiet ?? false;\n  }\n\n  private async run(): Promise<ExecResult> {\n    if (!this.cachedResult) {\n      this.cachedResult = this.executor({\n        cwd: this.cwdOverride,\n        env: this.envOverride,\n      });\n    }\n\n    const result = await this.cachedResult;\n\n    if (this.shouldThrow && result.exitCode !== 0) {\n      throw new ShellError(\n        `Command failed with exit code ${result.exitCode}`,\n        result.stdout,\n        result.stderr,\n        result.exitCode\n      );\n    }\n\n    return result;\n  }\n\n  then<TResult1 = ExecResult, TResult2 = never>(\n    onfulfilled?: ((value: ExecResult) => TResult1 | PromiseLike<TResult1>) | null,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null\n  ): Promise<TResult1 | TResult2> {\n    return this.run().then(onfulfilled, onrejected);\n  }\n\n  catch<TResult = never>(\n    onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null\n  ): Promise<ExecResult | TResult> {\n    return this.run().catch(onrejected);\n  }\n\n  finally(onfinally?: (() => void) | null): Promise<ExecResult> {\n    return this.run().finally(onfinally);\n  }\n\n  // Output formats\n  async text(): Promise<string> {\n    const result = await this.run();\n    return result.stdout.toString(\"utf-8\");\n  }\n\n  async json<T = unknown>(): Promise<T> {\n    const text = await this.text();\n    return JSON.parse(text);\n  }\n\n  async *lines(): AsyncIterable<string> {\n    const text = await this.text();\n    const lines = text.split(\"\\n\");\n    // Remove trailing empty line if present\n    if (lines[lines.length - 1] === \"\") {\n      lines.pop();\n    }\n    for (const line of lines) {\n      yield line;\n    }\n  }\n\n  async blob(): Promise<Blob> {\n    const result = await this.run();\n    return new Blob([new Uint8Array(result.stdout)]);\n  }\n\n  async buffer(): Promise<Buffer> {\n    const result = await this.run();\n    return result.stdout;\n  }\n\n  // Behavior modifiers - return new ShellPromise with modified options\n  quiet(): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: this.cwdOverride,\n      envOverride: this.envOverride,\n      shouldThrow: this.shouldThrow,\n      quiet: true,\n    });\n  }\n\n  nothrow(): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: this.cwdOverride,\n      envOverride: this.envOverride,\n      shouldThrow: false,\n      quiet: this.isQuiet,\n    });\n  }\n\n  throws(enable: boolean): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: this.cwdOverride,\n      envOverride: this.envOverride,\n      shouldThrow: enable,\n      quiet: this.isQuiet,\n    });\n  }\n\n  // Context overrides - these need to be handled by the shell\n  cwd(path: string): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: path,\n      envOverride: this.envOverride,\n      shouldThrow: this.shouldThrow,\n      quiet: this.isQuiet,\n    });\n  }\n\n  env(vars: Record<string, string>): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: this.cwdOverride,\n      envOverride: { ...this.envOverride, ...vars },\n      shouldThrow: this.shouldThrow,\n      quiet: this.isQuiet,\n    });\n  }\n\n  // Getters for internal state (used by ShellDSL)\n  getCwdOverride(): string | undefined {\n    return this.cwdOverride;\n  }\n\n  getEnvOverride(): Record<string, string> | undefined {\n    return this.envOverride;\n  }\n\n  getShouldThrow(): boolean {\n    return this.shouldThrow;\n  }\n\n  getIsQuiet(): boolean {\n    return this.isQuiet;\n  }\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "3425E56DF2B7E24B64756E2164756E21",
+  "mappings": "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",
+  "debugId": "DFBD1041E32C91CE64756E2164756E21",
   "names": []
 }

package/dist/mjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "shell-dsl",
-  "version": "0.0.28",
+  "version": "0.0.29",
   "type": "module"
 }

package/dist/mjs/src/fs/index.mjs

@@ -2,10 +2,13 @@
 import { createVirtualFS } from "./memfs-adapter.mjs";
 import { FileSystem } from "./real-fs.mjs";
 import { ReadOnlyFileSystem } from "./readonly-fs.mjs";
+import { OPFSFileSystem, createOPFSUnderlyingFS } from "./opfs-fs.mjs";
 export {
   createVirtualFS,
+  createOPFSUnderlyingFS,
   ReadOnlyFileSystem,
+  OPFSFileSystem,
   FileSystem
 };
 
-//# debugId=1175A4F96BC2DD3F64756E2164756E21
+//# debugId=E2CEC4178A168F0E64756E2164756E21

package/dist/mjs/src/fs/index.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/fs/index.ts"],
   "sourcesContent": [
-    "export { createVirtualFS } from \"./memfs-adapter.mjs\";\nexport { FileSystem, type Permission, type PermissionRules, type UnderlyingFS } from \"./real-fs.mjs\";\nexport { ReadOnlyFileSystem } from \"./readonly-fs.mjs\";\n"
+    "export { createVirtualFS } from \"./memfs-adapter.mjs\";\nexport { FileSystem, type Permission, type PermissionRules, type UnderlyingFS } from \"./real-fs.mjs\";\nexport { ReadOnlyFileSystem } from \"./readonly-fs.mjs\";\nexport { OPFSFileSystem, createOPFSUnderlyingFS } from \"./opfs-fs.mjs\";\n"
   ],
-  "mappings": ";AAAA;AACA;AACA;",
-  "debugId": "1175A4F96BC2DD3F64756E2164756E21",
+  "mappings": ";AAAA;AACA;AACA;AACA;",
+  "debugId": "E2CEC4178A168F0E64756E2164756E21",
   "names": []
 }

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

@@ -0,0 +1,207 @@
+// src/fs/opfs-fs.ts
+import { FileSystem } from "./real-fs.mjs";
+var DIRECTORY_MTIME = new Date(0);
+function createOPFSUnderlyingFS(root) {
+  return {
+    promises: {
+      async readFile(path) {
+        const { parentSegments, name } = splitParent(path);
+        const parent = await walkDirectory(root, parentSegments, false);
+        const fileHandle = await parent.getFileHandle(name, { create: false });
+        const file = await fileHandle.getFile();
+        return Buffer.from(await file.arrayBuffer());
+      },
+      async readdir(path) {
+        const dir = await walkDirectory(root, getPathSegments(path), false);
+        const entries = [];
+        for await (const [name] of dir.entries()) {
+          entries.push(name);
+        }
+        return entries;
+      },
+      async stat(path) {
+        const segments = getPathSegments(path);
+        if (segments.length === 0) {
+          return createDirectoryStat();
+        }
+        const { parentSegments, name } = splitParent(path);
+        const parent = await walkDirectory(root, parentSegments, false);
+        try {
+          const fileHandle = await parent.getFileHandle(name, { create: false });
+          const file = await fileHandle.getFile();
+          return {
+            isFile: () => true,
+            isDirectory: () => false,
+            size: file.size,
+            mtime: new Date(file.lastModified ?? 0)
+          };
+        } catch (error) {
+          if (!isNotFoundOrTypeMismatch(error))
+            throw error;
+        }
+        try {
+          await parent.getDirectoryHandle(name, { create: false });
+          return createDirectoryStat();
+        } catch (error) {
+          if (!isNotFoundOrTypeMismatch(error))
+            throw error;
+          throw error;
+        }
+      },
+      async writeFile(path, data) {
+        const { parentSegments, name } = splitParent(path);
+        const parent = await walkDirectory(root, parentSegments, false);
+        const fileHandle = await parent.getFileHandle(name, { create: true });
+        const writable = await fileHandle.createWritable();
+        await writable.write(toWritableData(data));
+        await writable.close();
+      },
+      async appendFile(path, data) {
+        const { parentSegments, name } = splitParent(path);
+        const parent = await walkDirectory(root, parentSegments, false);
+        const fileHandle = await parent.getFileHandle(name, { create: true });
+        const file = await fileHandle.getFile();
+        const writable = await fileHandle.createWritable({ keepExistingData: true });
+        await writable.write({
+          type: "write",
+          position: file.size,
+          data: toWritableData(data)
+        });
+        await writable.close();
+      },
+      async mkdir(path, opts) {
+        const segments = getPathSegments(path);
+        if (segments.length === 0) {
+          return;
+        }
+        if (opts?.recursive) {
+          await walkDirectory(root, segments, true);
+          return;
+        }
+        const parent = await walkDirectory(root, segments.slice(0, -1), false);
+        const name = segments[segments.length - 1];
+        const exists = await entryExists(parent, name);
+        if (exists) {
+          throw new Error(`EEXIST: file already exists, mkdir '${normalizeOpfsPath(path)}'`);
+        }
+        await parent.getDirectoryHandle(name, { create: true });
+      },
+      async rm(path, opts) {
+        const segments = getPathSegments(path);
+        if (segments.length === 0) {
+          throw new Error("EPERM: operation not permitted, rm '/'");
+        }
+        const parent = await walkDirectory(root, segments.slice(0, -1), false);
+        const name = segments[segments.length - 1];
+        try {
+          await parent.removeEntry(name, { recursive: opts?.recursive });
+        } catch (error) {
+          if (opts?.force && isNotFoundError(error)) {
+            return;
+          }
+          throw error;
+        }
+      }
+    }
+  };
+}
+
+class OPFSFileSystem extends FileSystem {
+  constructor(root, permissions) {
+    super("/", permissions, createOPFSUnderlyingFS(root));
+  }
+}
+function createDirectoryStat() {
+  return {
+    isFile: () => false,
+    isDirectory: () => true,
+    size: 0,
+    mtime: DIRECTORY_MTIME
+  };
+}
+function normalizeOpfsPath(path) {
+  const normalized = path.replace(/\\/g, "/");
+  const rawSegments = (normalized.startsWith("/") ? normalized : `/${normalized}`).split("/").filter(Boolean);
+  const segments = [];
+  for (const segment of rawSegments) {
+    if (segment === ".")
+      continue;
+    if (segment === "..") {
+      segments.pop();
+      continue;
+    }
+    segments.push(segment);
+  }
+  return `/${segments.join("/")}`;
+}
+function getPathSegments(path) {
+  const normalized = normalizeOpfsPath(path);
+  return normalized.split("/").filter(Boolean);
+}
+function splitParent(path) {
+  const segments = getPathSegments(path);
+  if (segments.length === 0) {
+    throw new Error(`Invalid file path: "${path}"`);
+  }
+  return {
+    parentSegments: segments.slice(0, -1),
+    name: segments[segments.length - 1]
+  };
+}
+async function walkDirectory(root, segments, create) {
+  let current = root;
+  for (const segment of segments) {
+    current = await current.getDirectoryHandle(segment, { create });
+  }
+  return current;
+}
+async function entryExists(dir, name) {
+  try {
+    await dir.getFileHandle(name, { create: false });
+    return true;
+  } catch (error) {
+    if (isTypeMismatchError(error))
+      return true;
+    if (!isNotFoundError(error))
+      throw error;
+  }
+  try {
+    await dir.getDirectoryHandle(name, { create: false });
+    return true;
+  } catch (error) {
+    if (isTypeMismatchError(error))
+      return true;
+    if (!isNotFoundError(error))
+      throw error;
+    return false;
+  }
+}
+function isNotFoundOrTypeMismatch(error) {
+  return isNotFoundError(error) || isTypeMismatchError(error);
+}
+function isNotFoundError(error) {
+  return getErrorName(error) === "NotFoundError";
+}
+function isTypeMismatchError(error) {
+  return getErrorName(error) === "TypeMismatchError";
+}
+function getErrorName(error) {
+  if (!error || typeof error !== "object")
+    return;
+  const named = error;
+  return typeof named.name === "string" ? named.name : undefined;
+}
+function toWritableData(data) {
+  if (typeof data === "string") {
+    return data;
+  }
+  const out = new Uint8Array(data.length);
+  out.set(data);
+  return out.buffer;
+}
+export {
+  createOPFSUnderlyingFS,
+  OPFSFileSystem
+};
+
+//# debugId=00CBC00BD7A1121364756E2164756E21

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/fs/opfs-fs.ts"],
+  "sourcesContent": [
+    "import { FileSystem, type PermissionRules, type UnderlyingFS } from \"./real-fs.mjs\";\n\nconst DIRECTORY_MTIME = new Date(0);\n\nexport function createOPFSUnderlyingFS(root: FileSystemDirectoryHandle): UnderlyingFS {\n  return {\n    promises: {\n      async readFile(path: string): Promise<Buffer> {\n        const { parentSegments, name } = splitParent(path);\n        const parent = await walkDirectory(root, parentSegments, false);\n        const fileHandle = await parent.getFileHandle(name, { create: false });\n        const file = await fileHandle.getFile();\n        return Buffer.from(await file.arrayBuffer());\n      },\n\n      async readdir(path: string): Promise<string[]> {\n        const dir = await walkDirectory(root, getPathSegments(path), false);\n        const entries: string[] = [];\n        for await (const [name] of dir.entries()) {\n          entries.push(name);\n        }\n        return entries;\n      },\n\n      async stat(path: string): Promise<{\n        isFile(): boolean;\n        isDirectory(): boolean;\n        size: number;\n        mtime: Date;\n      }> {\n        const segments = getPathSegments(path);\n\n        if (segments.length === 0) {\n          return createDirectoryStat();\n        }\n\n        const { parentSegments, name } = splitParent(path);\n        const parent = await walkDirectory(root, parentSegments, false);\n\n        try {\n          const fileHandle = await parent.getFileHandle(name, { create: false });\n          const file = await fileHandle.getFile();\n          return {\n            isFile: () => true,\n            isDirectory: () => false,\n            size: file.size,\n            mtime: new Date(file.lastModified ?? 0),\n          };\n        } catch (error) {\n          if (!isNotFoundOrTypeMismatch(error)) throw error;\n        }\n\n        try {\n          await parent.getDirectoryHandle(name, { create: false });\n          return createDirectoryStat();\n        } catch (error) {\n          if (!isNotFoundOrTypeMismatch(error)) throw error;\n          throw error;\n        }\n      },\n\n      async writeFile(path: string, data: Buffer | string): Promise<void> {\n        const { parentSegments, name } = splitParent(path);\n        const parent = await walkDirectory(root, parentSegments, false);\n        const fileHandle = await parent.getFileHandle(name, { create: true });\n        const writable = await fileHandle.createWritable();\n        await writable.write(toWritableData(data));\n        await writable.close();\n      },\n\n      async appendFile(path: string, data: Buffer | string): Promise<void> {\n        const { parentSegments, name } = splitParent(path);\n        const parent = await walkDirectory(root, parentSegments, false);\n        const fileHandle = await parent.getFileHandle(name, { create: true });\n        const file = await fileHandle.getFile();\n        const writable = await fileHandle.createWritable({ keepExistingData: true });\n        await writable.write({\n          type: \"write\",\n          position: file.size,\n          data: toWritableData(data),\n        });\n        await writable.close();\n      },\n\n      async mkdir(path: string, opts?: { recursive?: boolean }): Promise<void> {\n        const segments = getPathSegments(path);\n        if (segments.length === 0) {\n          return;\n        }\n\n        if (opts?.recursive) {\n          await walkDirectory(root, segments, true);\n          return;\n        }\n\n        const parent = await walkDirectory(root, segments.slice(0, -1), false);\n        const name = segments[segments.length - 1]!;\n        const exists = await entryExists(parent, name);\n        if (exists) {\n          throw new Error(`EEXIST: file already exists, mkdir '${normalizeOpfsPath(path)}'`);\n        }\n        await parent.getDirectoryHandle(name, { create: true });\n      },\n\n      async rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n        const segments = getPathSegments(path);\n        if (segments.length === 0) {\n          throw new Error(\"EPERM: operation not permitted, rm '/'\");\n        }\n\n        const parent = await walkDirectory(root, segments.slice(0, -1), false);\n        const name = segments[segments.length - 1]!;\n        try {\n          await parent.removeEntry(name, { recursive: opts?.recursive });\n        } catch (error) {\n          if (opts?.force && isNotFoundError(error)) {\n            return;\n          }\n          throw error;\n        }\n      },\n    },\n  };\n}\n\nexport class OPFSFileSystem extends FileSystem {\n  constructor(root: FileSystemDirectoryHandle, permissions?: PermissionRules) {\n    super(\"/\", permissions, createOPFSUnderlyingFS(root));\n  }\n}\n\nfunction createDirectoryStat() {\n  return {\n    isFile: () => false,\n    isDirectory: () => true,\n    size: 0,\n    mtime: DIRECTORY_MTIME,\n  };\n}\n\nfunction normalizeOpfsPath(path: string): string {\n  const normalized = path.replace(/\\\\/g, \"/\");\n  const rawSegments = (normalized.startsWith(\"/\") ? normalized : `/${normalized}`)\n    .split(\"/\")\n    .filter(Boolean);\n\n  const segments: string[] = [];\n  for (const segment of rawSegments) {\n    if (segment === \".\") continue;\n    if (segment === \"..\") {\n      segments.pop();\n      continue;\n    }\n    segments.push(segment);\n  }\n\n  return `/${segments.join(\"/\")}`;\n}\n\nfunction getPathSegments(path: string): string[] {\n  const normalized = normalizeOpfsPath(path);\n  return normalized.split(\"/\").filter(Boolean);\n}\n\nfunction splitParent(path: string): { parentSegments: string[]; name: string } {\n  const segments = getPathSegments(path);\n  if (segments.length === 0) {\n    throw new Error(`Invalid file path: \"${path}\"`);\n  }\n  return {\n    parentSegments: segments.slice(0, -1),\n    name: segments[segments.length - 1]!,\n  };\n}\n\nasync function walkDirectory(\n  root: FileSystemDirectoryHandle,\n  segments: string[],\n  create: boolean\n): Promise<FileSystemDirectoryHandle> {\n  let current = root;\n  for (const segment of segments) {\n    current = await current.getDirectoryHandle(segment, { create });\n  }\n  return current;\n}\n\nasync function entryExists(dir: FileSystemDirectoryHandle, name: string): Promise<boolean> {\n  try {\n    await dir.getFileHandle(name, { create: false });\n    return true;\n  } catch (error) {\n    if (isTypeMismatchError(error)) return true;\n    if (!isNotFoundError(error)) throw error;\n  }\n\n  try {\n    await dir.getDirectoryHandle(name, { create: false });\n    return true;\n  } catch (error) {\n    if (isTypeMismatchError(error)) return true;\n    if (!isNotFoundError(error)) throw error;\n    return false;\n  }\n}\n\nfunction isNotFoundOrTypeMismatch(error: unknown): boolean {\n  return isNotFoundError(error) || isTypeMismatchError(error);\n}\n\nfunction isNotFoundError(error: unknown): boolean {\n  return getErrorName(error) === \"NotFoundError\";\n}\n\nfunction isTypeMismatchError(error: unknown): boolean {\n  return getErrorName(error) === \"TypeMismatchError\";\n}\n\nfunction getErrorName(error: unknown): string | undefined {\n  if (!error || typeof error !== \"object\") return undefined;\n  const named = error as { name?: unknown };\n  return typeof named.name === \"string\" ? named.name : undefined;\n}\n\nfunction toWritableData(data: Buffer | string): string | ArrayBuffer {\n  if (typeof data === \"string\") {\n    return data;\n  }\n  const out = new Uint8Array(data.length);\n  out.set(data);\n  return out.buffer;\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "00CBC00BD7A1121364756E2164756E21",
+  "names": []
+}

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

@@ -78,7 +78,9 @@ class FileSystem {
     const relativePath = normalized.startsWith("/") ? normalized.slice(1) : normalized;
     const realPath = path.join(this.mountBase, relativePath);
     const resolved = path.resolve(realPath);
-    if (!resolved.startsWith(this.mountBase + path.sep) && resolved !== this.mountBase) {
+    const relativeFromMount = path.relative(this.mountBase, resolved);
+    const escapesMount = relativeFromMount === ".." || relativeFromMount.startsWith(`..${path.sep}`) || path.isAbsolute(relativeFromMount);
+    if (escapesMount) {
       throw new Error(`Path traversal blocked: "${virtualPath}" escapes mount point`);
     }
     return resolved;
@@ -177,8 +179,8 @@ class FileSystem {
   }
   async matchPattern(pattern, cwd) {
     const parts = pattern.split("/").filter((p) => p !== "");
-    const isAbsolute = pattern.startsWith("/");
-    const startDir = isAbsolute ? "/" : cwd;
+    const isAbsolute2 = pattern.startsWith("/");
+    const startDir = isAbsolute2 ? "/" : cwd;
     return this.matchParts(parts, startDir);
   }
   async matchParts(parts, currentPath) {
@@ -266,4 +268,4 @@ export {
   FileSystem
 };
 
-//# debugId=48B583F651B4E85F64756E2164756E21
+//# debugId=22C6D81D0318A4DC64756E2164756E21

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\";\n\nexport type Permission = \"read-write\" | \"read-only\" | \"excluded\";\nexport type PermissionRules = Record<string, Permission>;\n\n// Minimal interface for the underlying fs (compatible with node:fs and memfs)\nexport interface UnderlyingFS {\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 };\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  protected readonly underlyingFs: UnderlyingFS;\n\n  constructor(mountPath?: string, permissions?: PermissionRules, fs?: UnderlyingFS) {\n    this.mountBase = mountPath ? path.resolve(mountPath) : null;\n    this.rules = this.compileRules(permissions ?? {});\n    this.underlyingFs = fs ?? defaultFS;\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 path.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 = path.normalize(virtualPath);\n    const relativePath = normalized.startsWith(\"/\") ? normalized.slice(1) : normalized;\n    const realPath = path.join(this.mountBase, relativePath);\n    const resolved = path.resolve(realPath);\n\n    // Double-check containment (defense in depth)\n    if (!resolved.startsWith(this.mountBase + path.sep) && resolved !== this.mountBase) {\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 path.resolve(\"/\", ...paths);\n  }\n\n  dirname(filePath: string): string {\n    return path.dirname(filePath);\n  }\n\n  basename(filePath: string): string {\n    return path.basename(filePath);\n  }\n\n  // Glob with permission filtering\n  async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n    const cwd = opts?.cwd ?? \"/\";\n    this.checkPermission(cwd, \"read\");\n\n    const matches = await this.expandGlob(pattern, cwd);\n\n    // Filter out excluded paths\n    return matches.filter((p) => this.getPermission(p) !== \"excluded\").sort();\n  }\n\n  // Glob expansion (similar to memfs-adapter implementation)\n  private async expandGlob(pattern: string, cwd: string): Promise<string[]> {\n    // Handle brace expansion first\n    const patterns = this.expandBraces(pattern);\n    const allMatches: string[] = [];\n\n    for (const pat of patterns) {\n      const matches = await this.matchPattern(pat, cwd);\n      allMatches.push(...matches);\n    }\n\n    // Remove duplicates and sort\n    return [...new Set(allMatches)].sort();\n  }\n\n  private expandBraces(pattern: string): string[] {\n    const braceMatch = pattern.match(/\\{([^{}]+)\\}/);\n    if (!braceMatch) return [pattern];\n\n    const before = pattern.slice(0, braceMatch.index);\n    const after = pattern.slice(braceMatch.index! + braceMatch[0].length);\n    const options = braceMatch[1]!.split(\",\");\n\n    const results: string[] = [];\n    for (const opt of options) {\n      const expanded = this.expandBraces(before + opt + after);\n      results.push(...expanded);\n    }\n    return results;\n  }\n\n  private async matchPattern(pattern: string, cwd: string): Promise<string[]> {\n    const parts = pattern.split(\"/\").filter((p) => p !== \"\");\n    const isAbsolute = pattern.startsWith(\"/\");\n    const startDir = isAbsolute ? \"/\" : cwd;\n\n    return this.matchParts(parts, startDir);\n  }\n\n  private async matchParts(parts: string[], currentPath: string): Promise<string[]> {\n    if (parts.length === 0) {\n      return [currentPath];\n    }\n\n    const [part, ...rest] = parts;\n\n    // Handle ** (recursive glob)\n    if (part === \"**\") {\n      const results: string[] = [];\n\n      // Match current directory\n      const withoutStar = await this.matchParts(rest, currentPath);\n      results.push(...withoutStar);\n\n      // Recurse into subdirectories\n      try {\n        const realPath = this.resolveSafePath(currentPath);\n        const entries = await this.underlyingFs.promises.readdir(realPath);\n        for (const entry of entries) {\n          const entryPath = path.posix.join(currentPath, String(entry));\n          try {\n            const entryRealPath = this.resolveSafePath(entryPath);\n            const stat = await this.underlyingFs.promises.stat(entryRealPath);\n            if (stat.isDirectory()) {\n              const subMatches = await this.matchParts(parts, entryPath);\n              results.push(...subMatches);\n            }\n          } catch {\n            // Skip inaccessible entries\n          }\n        }\n      } catch {\n        // Directory not readable\n      }\n\n      return results;\n    }\n\n    // Handle regular glob patterns\n    const regex = this.globToRegex(part!);\n\n    try {\n      const realPath = this.resolveSafePath(currentPath);\n      const entries = await this.underlyingFs.promises.readdir(realPath);\n      const results: string[] = [];\n\n      for (const entry of entries) {\n        const entryName = String(entry);\n        if (regex.test(entryName)) {\n          const entryPath = path.posix.join(currentPath, entryName);\n          if (rest.length === 0) {\n            results.push(entryPath);\n          } else {\n            try {\n              const entryRealPath = this.resolveSafePath(entryPath);\n              const stat = await this.underlyingFs.promises.stat(entryRealPath);\n              if (stat.isDirectory()) {\n                const subMatches = await this.matchParts(rest, entryPath);\n                results.push(...subMatches);\n              }\n            } catch {\n              // Skip inaccessible entries\n            }\n          }\n        }\n      }\n\n      return results;\n    } catch {\n      return [];\n    }\n  }\n\n  private globToRegex(pattern: string): RegExp {\n    let regex = \"^\";\n    for (let i = 0; i < pattern.length; i++) {\n      const char = pattern[i]!;\n      if (char === \"*\") {\n        regex += \"[^/]*\";\n      } else if (char === \"?\") {\n        regex += \"[^/]\";\n      } else if (char === \"[\") {\n        // Character class\n        let j = i + 1;\n        let classContent = \"\";\n        while (j < pattern.length && pattern[j] !== \"]\") {\n          classContent += pattern[j];\n          j++;\n        }\n        regex += `[${classContent}]`;\n        i = j;\n      } else if (\".+^${}()|\\\\\".includes(char)) {\n        regex += \"\\\\\" + char;\n      } else {\n        regex += char;\n      }\n    }\n    regex += \"$\";\n    return new RegExp(regex);\n  }\n}\n"
+    "import * as path from \"path\";\nimport * as nodeFs from \"node:fs/promises\";\nimport type { VirtualFS, FileStat } from \"../types.mjs\";\n\nexport type Permission = \"read-write\" | \"read-only\" | \"excluded\";\nexport type PermissionRules = Record<string, Permission>;\n\n// Minimal interface for the underlying fs (compatible with node:fs and memfs)\nexport interface UnderlyingFS {\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 };\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  protected readonly underlyingFs: UnderlyingFS;\n\n  constructor(mountPath?: string, permissions?: PermissionRules, fs?: UnderlyingFS) {\n    this.mountBase = mountPath ? path.resolve(mountPath) : null;\n    this.rules = this.compileRules(permissions ?? {});\n    this.underlyingFs = fs ?? defaultFS;\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 path.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 = path.normalize(virtualPath);\n    const relativePath = normalized.startsWith(\"/\") ? normalized.slice(1) : normalized;\n    const realPath = path.join(this.mountBase, relativePath);\n    const resolved = path.resolve(realPath);\n\n    // Double-check containment (defense in depth), including root mounts.\n    const relativeFromMount = path.relative(this.mountBase, resolved);\n    const escapesMount =\n      relativeFromMount === \"..\" ||\n      relativeFromMount.startsWith(`..${path.sep}`) ||\n      path.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 path.resolve(\"/\", ...paths);\n  }\n\n  dirname(filePath: string): string {\n    return path.dirname(filePath);\n  }\n\n  basename(filePath: string): string {\n    return path.basename(filePath);\n  }\n\n  // Glob with permission filtering\n  async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n    const cwd = opts?.cwd ?? \"/\";\n    this.checkPermission(cwd, \"read\");\n\n    const matches = await this.expandGlob(pattern, cwd);\n\n    // Filter out excluded paths\n    return matches.filter((p) => this.getPermission(p) !== \"excluded\").sort();\n  }\n\n  // Glob expansion (similar to memfs-adapter implementation)\n  private async expandGlob(pattern: string, cwd: string): Promise<string[]> {\n    // Handle brace expansion first\n    const patterns = this.expandBraces(pattern);\n    const allMatches: string[] = [];\n\n    for (const pat of patterns) {\n      const matches = await this.matchPattern(pat, cwd);\n      allMatches.push(...matches);\n    }\n\n    // Remove duplicates and sort\n    return [...new Set(allMatches)].sort();\n  }\n\n  private expandBraces(pattern: string): string[] {\n    const braceMatch = pattern.match(/\\{([^{}]+)\\}/);\n    if (!braceMatch) return [pattern];\n\n    const before = pattern.slice(0, braceMatch.index);\n    const after = pattern.slice(braceMatch.index! + braceMatch[0].length);\n    const options = braceMatch[1]!.split(\",\");\n\n    const results: string[] = [];\n    for (const opt of options) {\n      const expanded = this.expandBraces(before + opt + after);\n      results.push(...expanded);\n    }\n    return results;\n  }\n\n  private async matchPattern(pattern: string, cwd: string): Promise<string[]> {\n    const parts = pattern.split(\"/\").filter((p) => p !== \"\");\n    const isAbsolute = pattern.startsWith(\"/\");\n    const startDir = isAbsolute ? \"/\" : cwd;\n\n    return this.matchParts(parts, startDir);\n  }\n\n  private async matchParts(parts: string[], currentPath: string): Promise<string[]> {\n    if (parts.length === 0) {\n      return [currentPath];\n    }\n\n    const [part, ...rest] = parts;\n\n    // Handle ** (recursive glob)\n    if (part === \"**\") {\n      const results: string[] = [];\n\n      // Match current directory\n      const withoutStar = await this.matchParts(rest, currentPath);\n      results.push(...withoutStar);\n\n      // Recurse into subdirectories\n      try {\n        const realPath = this.resolveSafePath(currentPath);\n        const entries = await this.underlyingFs.promises.readdir(realPath);\n        for (const entry of entries) {\n          const entryPath = path.posix.join(currentPath, String(entry));\n          try {\n            const entryRealPath = this.resolveSafePath(entryPath);\n            const stat = await this.underlyingFs.promises.stat(entryRealPath);\n            if (stat.isDirectory()) {\n              const subMatches = await this.matchParts(parts, entryPath);\n              results.push(...subMatches);\n            }\n          } catch {\n            // Skip inaccessible entries\n          }\n        }\n      } catch {\n        // Directory not readable\n      }\n\n      return results;\n    }\n\n    // Handle regular glob patterns\n    const regex = this.globToRegex(part!);\n\n    try {\n      const realPath = this.resolveSafePath(currentPath);\n      const entries = await this.underlyingFs.promises.readdir(realPath);\n      const results: string[] = [];\n\n      for (const entry of entries) {\n        const entryName = String(entry);\n        if (regex.test(entryName)) {\n          const entryPath = path.posix.join(currentPath, entryName);\n          if (rest.length === 0) {\n            results.push(entryPath);\n          } else {\n            try {\n              const entryRealPath = this.resolveSafePath(entryPath);\n              const stat = await this.underlyingFs.promises.stat(entryRealPath);\n              if (stat.isDirectory()) {\n                const subMatches = await this.matchParts(rest, entryPath);\n                results.push(...subMatches);\n              }\n            } catch {\n              // Skip inaccessible entries\n            }\n          }\n        }\n      }\n\n      return results;\n    } catch {\n      return [];\n    }\n  }\n\n  private globToRegex(pattern: string): RegExp {\n    let regex = \"^\";\n    for (let i = 0; i < pattern.length; i++) {\n      const char = pattern[i]!;\n      if (char === \"*\") {\n        regex += \"[^/]*\";\n      } else if (char === \"?\") {\n        regex += \"[^/]\";\n      } else if (char === \"[\") {\n        // Character class\n        let j = i + 1;\n        let classContent = \"\";\n        while (j < pattern.length && pattern[j] !== \"]\") {\n          classContent += pattern[j];\n          j++;\n        }\n        regex += `[${classContent}]`;\n        i = j;\n      } else if (\".+^${}()|\\\\\".includes(char)) {\n        regex += \"\\\\\" + char;\n      } else {\n        regex += char;\n      }\n    }\n    regex += \"$\";\n    return new RegExp(regex);\n  }\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "48B583F651B4E85F64756E2164756E21",
+  "mappings": "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",
+  "debugId": "22C6D81D0318A4DC64756E2164756E21",
   "names": []
 }

package/dist/mjs/src/index.mjs

@@ -27,7 +27,9 @@ import { Interpreter, BreakException, ContinueException } from "./interpreter/in
 import { createVirtualFS } from "./fs/index.mjs";
 import {
   FileSystem,
-  ReadOnlyFileSystem
+  ReadOnlyFileSystem,
+  OPFSFileSystem,
+  createOPFSUnderlyingFS
 } from "./fs/index.mjs";
 import { createStdin, StdinImpl } from "./io/index.mjs";
 import { createStdout, createStderr, createPipe, OutputCollectorImpl, PipeBuffer } from "./io/index.mjs";
@@ -61,6 +63,7 @@ export {
   createStderr,
   createShellDSL,
   createPipe,
+  createOPFSUnderlyingFS,
   StdinImpl,
   ShellPromise,
   ShellError,
@@ -70,6 +73,7 @@ export {
   Parser,
   ParseError,
   OutputCollectorImpl,
+  OPFSFileSystem,
   Lexer,
   LexError,
   Interpreter,
@@ -78,4 +82,4 @@ export {
   BreakException
 };
 
-//# debugId=0CC96BD5A2BCA29264756E2164756E21
+//# debugId=3BAA746B1799743164756E2164756E21

package/dist/mjs/src/index.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../src/index.ts"],
   "sourcesContent": [
-    "// Main class exports\nexport { ShellDSL, createShellDSL, type Program } from \"./shell-dsl.mjs\";\nexport { ShellPromise, type ShellPromiseOptions } from \"./shell-promise.mjs\";\n\n// Types\nexport type {\n  VirtualFS,\n  FileStat,\n  Command,\n  CommandContext,\n  Stdin,\n  Stdout,\n  Stderr,\n  OutputCollector,\n  ExecResult,\n  ShellConfig,\n  RawValue,\n} from \"./types.mjs\";\nexport { isRawValue } from \"./types.mjs\";\n\n// Errors\nexport { ShellError, LexError, ParseError } from \"./errors.mjs\";\n\n// Lexer\nexport { Lexer, lex, tokenToString } from \"./lexer/index.mjs\";\nexport type { Token, RedirectMode } from \"./lexer/index.mjs\";\n\n// Parser\nexport { Parser, parse } from \"./parser/index.mjs\";\nexport type {\n  ASTNode,\n  Redirect,\n  CommandNode,\n  PipelineNode,\n  AndNode,\n  OrNode,\n  SequenceNode,\n  LiteralNode,\n  VariableNode,\n  SubstitutionNode,\n  GlobNode,\n  ConcatNode,\n  IfNode,\n  ForNode,\n  WhileNode,\n  UntilNode,\n  CaseNode,\n  CaseClause,\n  ArithmeticNode,\n} from \"./parser/index.mjs\";\nexport {\n  isCommandNode,\n  isPipelineNode,\n  isAndNode,\n  isOrNode,\n  isSequenceNode,\n  isLiteralNode,\n  isVariableNode,\n  isSubstitutionNode,\n  isGlobNode,\n  isConcatNode,\n  isIfNode,\n  isForNode,\n  isWhileNode,\n  isUntilNode,\n  isCaseNode,\n  isArithmeticNode,\n} from \"./parser/index.mjs\";\n\n// Interpreter\nexport { Interpreter, type InterpreterOptions, BreakException, ContinueException } from \"./interpreter/index.mjs\";\n\n// Filesystem\nexport { createVirtualFS } from \"./fs/index.mjs\";\nexport {\n  FileSystem,\n  ReadOnlyFileSystem,\n  type Permission,\n  type PermissionRules,\n  type UnderlyingFS,\n} from \"./fs/index.mjs\";\n\n// I/O\nexport { createStdin, StdinImpl } from \"./io/index.mjs\";\nexport { createStdout, createStderr, createPipe, OutputCollectorImpl, PipeBuffer } from \"./io/index.mjs\";\n\n// Utilities\nexport { escape, escapeForInterpolation } from \"./utils/index.mjs\";\n"
+    "// Main class exports\nexport { ShellDSL, createShellDSL, type Program } from \"./shell-dsl.mjs\";\nexport { ShellPromise, type ShellPromiseOptions } from \"./shell-promise.mjs\";\n\n// Types\nexport type {\n  VirtualFS,\n  FileStat,\n  Command,\n  CommandContext,\n  Stdin,\n  Stdout,\n  Stderr,\n  OutputCollector,\n  ExecResult,\n  ShellConfig,\n  RawValue,\n} from \"./types.mjs\";\nexport { isRawValue } from \"./types.mjs\";\n\n// Errors\nexport { ShellError, LexError, ParseError } from \"./errors.mjs\";\n\n// Lexer\nexport { Lexer, lex, tokenToString } from \"./lexer/index.mjs\";\nexport type { Token, RedirectMode } from \"./lexer/index.mjs\";\n\n// Parser\nexport { Parser, parse } from \"./parser/index.mjs\";\nexport type {\n  ASTNode,\n  Redirect,\n  CommandNode,\n  PipelineNode,\n  AndNode,\n  OrNode,\n  SequenceNode,\n  LiteralNode,\n  VariableNode,\n  SubstitutionNode,\n  GlobNode,\n  ConcatNode,\n  IfNode,\n  ForNode,\n  WhileNode,\n  UntilNode,\n  CaseNode,\n  CaseClause,\n  ArithmeticNode,\n} from \"./parser/index.mjs\";\nexport {\n  isCommandNode,\n  isPipelineNode,\n  isAndNode,\n  isOrNode,\n  isSequenceNode,\n  isLiteralNode,\n  isVariableNode,\n  isSubstitutionNode,\n  isGlobNode,\n  isConcatNode,\n  isIfNode,\n  isForNode,\n  isWhileNode,\n  isUntilNode,\n  isCaseNode,\n  isArithmeticNode,\n} from \"./parser/index.mjs\";\n\n// Interpreter\nexport { Interpreter, type InterpreterOptions, BreakException, ContinueException } from \"./interpreter/index.mjs\";\n\n// Filesystem\nexport { createVirtualFS } from \"./fs/index.mjs\";\nexport {\n  FileSystem,\n  ReadOnlyFileSystem,\n  OPFSFileSystem,\n  createOPFSUnderlyingFS,\n  type Permission,\n  type PermissionRules,\n  type UnderlyingFS,\n} from \"./fs/index.mjs\";\n\n// I/O\nexport { createStdin, StdinImpl } from \"./io/index.mjs\";\nexport { createStdout, createStderr, createPipe, OutputCollectorImpl, PipeBuffer } from \"./io/index.mjs\";\n\n// Utilities\nexport { escape, escapeForInterpolation } from \"./utils/index.mjs\";\n"
   ],
-  "mappings": ";AACA;AACA;AAgBA;AAGA;AAGA;AAIA;AAsBA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoBA;AAGA;AACA;AAAA;AAAA;AAAA;AASA;AACA;AAGA;",
-  "debugId": "0CC96BD5A2BCA29264756E2164756E21",
+  "mappings": ";AACA;AACA;AAgBA;AAGA;AAGA;AAIA;AAsBA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoBA;AAGA;AACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWA;AACA;AAGA;",
+  "debugId": "3BAA746B1799743164756E2164756E21",
   "names": []
 }

package/dist/mjs/src/shell-promise.mjs

@@ -58,7 +58,7 @@ class ShellPromise {
   }
   async blob() {
     const result = await this.run();
-    return new Blob([result.stdout]);
+    return new Blob([new Uint8Array(result.stdout)]);
   }
   async buffer() {
     const result = await this.run();
@@ -126,4 +126,4 @@ export {
   ShellPromise
 };
 
-//# debugId=27303E978C3F3C8A64756E2164756E21
+//# debugId=77697BFE77B4E29464756E2164756E21

package/dist/mjs/src/shell-promise.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../src/shell-promise.ts"],
   "sourcesContent": [
-    "import type { ExecResult } from \"./types.mjs\";\nimport { ShellError } from \"./errors.mjs\";\n\nexport interface ExecuteOverrides {\n  cwd?: string;\n  env?: Record<string, string>;\n}\n\nexport interface ShellPromiseOptions {\n  execute: (overrides: ExecuteOverrides) => Promise<ExecResult>;\n  cwdOverride?: string;\n  envOverride?: Record<string, string>;\n  shouldThrow?: boolean;\n  quiet?: boolean;\n}\n\nexport class ShellPromise implements PromiseLike<ExecResult> {\n  private executor: (overrides: ExecuteOverrides) => Promise<ExecResult>;\n  private cwdOverride?: string;\n  private envOverride?: Record<string, string>;\n  private shouldThrow: boolean;\n  private isQuiet: boolean;\n  private cachedResult?: Promise<ExecResult>;\n\n  constructor(options: ShellPromiseOptions) {\n    this.executor = options.execute;\n    this.cwdOverride = options.cwdOverride;\n    this.envOverride = options.envOverride;\n    this.shouldThrow = options.shouldThrow ?? true;\n    this.isQuiet = options.quiet ?? false;\n  }\n\n  private async run(): Promise<ExecResult> {\n    if (!this.cachedResult) {\n      this.cachedResult = this.executor({\n        cwd: this.cwdOverride,\n        env: this.envOverride,\n      });\n    }\n\n    const result = await this.cachedResult;\n\n    if (this.shouldThrow && result.exitCode !== 0) {\n      throw new ShellError(\n        `Command failed with exit code ${result.exitCode}`,\n        result.stdout,\n        result.stderr,\n        result.exitCode\n      );\n    }\n\n    return result;\n  }\n\n  then<TResult1 = ExecResult, TResult2 = never>(\n    onfulfilled?: ((value: ExecResult) => TResult1 | PromiseLike<TResult1>) | null,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null\n  ): Promise<TResult1 | TResult2> {\n    return this.run().then(onfulfilled, onrejected);\n  }\n\n  catch<TResult = never>(\n    onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null\n  ): Promise<ExecResult | TResult> {\n    return this.run().catch(onrejected);\n  }\n\n  finally(onfinally?: (() => void) | null): Promise<ExecResult> {\n    return this.run().finally(onfinally);\n  }\n\n  // Output formats\n  async text(): Promise<string> {\n    const result = await this.run();\n    return result.stdout.toString(\"utf-8\");\n  }\n\n  async json<T = unknown>(): Promise<T> {\n    const text = await this.text();\n    return JSON.parse(text);\n  }\n\n  async *lines(): AsyncIterable<string> {\n    const text = await this.text();\n    const lines = text.split(\"\\n\");\n    // Remove trailing empty line if present\n    if (lines[lines.length - 1] === \"\") {\n      lines.pop();\n    }\n    for (const line of lines) {\n      yield line;\n    }\n  }\n\n  async blob(): Promise<Blob> {\n    const result = await this.run();\n    return new Blob([result.stdout]);\n  }\n\n  async buffer(): Promise<Buffer> {\n    const result = await this.run();\n    return result.stdout;\n  }\n\n  // Behavior modifiers - return new ShellPromise with modified options\n  quiet(): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: this.cwdOverride,\n      envOverride: this.envOverride,\n      shouldThrow: this.shouldThrow,\n      quiet: true,\n    });\n  }\n\n  nothrow(): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: this.cwdOverride,\n      envOverride: this.envOverride,\n      shouldThrow: false,\n      quiet: this.isQuiet,\n    });\n  }\n\n  throws(enable: boolean): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: this.cwdOverride,\n      envOverride: this.envOverride,\n      shouldThrow: enable,\n      quiet: this.isQuiet,\n    });\n  }\n\n  // Context overrides - these need to be handled by the shell\n  cwd(path: string): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: path,\n      envOverride: this.envOverride,\n      shouldThrow: this.shouldThrow,\n      quiet: this.isQuiet,\n    });\n  }\n\n  env(vars: Record<string, string>): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: this.cwdOverride,\n      envOverride: { ...this.envOverride, ...vars },\n      shouldThrow: this.shouldThrow,\n      quiet: this.isQuiet,\n    });\n  }\n\n  // Getters for internal state (used by ShellDSL)\n  getCwdOverride(): string | undefined {\n    return this.cwdOverride;\n  }\n\n  getEnvOverride(): Record<string, string> | undefined {\n    return this.envOverride;\n  }\n\n  getShouldThrow(): boolean {\n    return this.shouldThrow;\n  }\n\n  getIsQuiet(): boolean {\n    return this.isQuiet;\n  }\n}\n"
+    "import type { ExecResult } from \"./types.mjs\";\nimport { ShellError } from \"./errors.mjs\";\n\nexport interface ExecuteOverrides {\n  cwd?: string;\n  env?: Record<string, string>;\n}\n\nexport interface ShellPromiseOptions {\n  execute: (overrides: ExecuteOverrides) => Promise<ExecResult>;\n  cwdOverride?: string;\n  envOverride?: Record<string, string>;\n  shouldThrow?: boolean;\n  quiet?: boolean;\n}\n\nexport class ShellPromise implements PromiseLike<ExecResult> {\n  private executor: (overrides: ExecuteOverrides) => Promise<ExecResult>;\n  private cwdOverride?: string;\n  private envOverride?: Record<string, string>;\n  private shouldThrow: boolean;\n  private isQuiet: boolean;\n  private cachedResult?: Promise<ExecResult>;\n\n  constructor(options: ShellPromiseOptions) {\n    this.executor = options.execute;\n    this.cwdOverride = options.cwdOverride;\n    this.envOverride = options.envOverride;\n    this.shouldThrow = options.shouldThrow ?? true;\n    this.isQuiet = options.quiet ?? false;\n  }\n\n  private async run(): Promise<ExecResult> {\n    if (!this.cachedResult) {\n      this.cachedResult = this.executor({\n        cwd: this.cwdOverride,\n        env: this.envOverride,\n      });\n    }\n\n    const result = await this.cachedResult;\n\n    if (this.shouldThrow && result.exitCode !== 0) {\n      throw new ShellError(\n        `Command failed with exit code ${result.exitCode}`,\n        result.stdout,\n        result.stderr,\n        result.exitCode\n      );\n    }\n\n    return result;\n  }\n\n  then<TResult1 = ExecResult, TResult2 = never>(\n    onfulfilled?: ((value: ExecResult) => TResult1 | PromiseLike<TResult1>) | null,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null\n  ): Promise<TResult1 | TResult2> {\n    return this.run().then(onfulfilled, onrejected);\n  }\n\n  catch<TResult = never>(\n    onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null\n  ): Promise<ExecResult | TResult> {\n    return this.run().catch(onrejected);\n  }\n\n  finally(onfinally?: (() => void) | null): Promise<ExecResult> {\n    return this.run().finally(onfinally);\n  }\n\n  // Output formats\n  async text(): Promise<string> {\n    const result = await this.run();\n    return result.stdout.toString(\"utf-8\");\n  }\n\n  async json<T = unknown>(): Promise<T> {\n    const text = await this.text();\n    return JSON.parse(text);\n  }\n\n  async *lines(): AsyncIterable<string> {\n    const text = await this.text();\n    const lines = text.split(\"\\n\");\n    // Remove trailing empty line if present\n    if (lines[lines.length - 1] === \"\") {\n      lines.pop();\n    }\n    for (const line of lines) {\n      yield line;\n    }\n  }\n\n  async blob(): Promise<Blob> {\n    const result = await this.run();\n    return new Blob([new Uint8Array(result.stdout)]);\n  }\n\n  async buffer(): Promise<Buffer> {\n    const result = await this.run();\n    return result.stdout;\n  }\n\n  // Behavior modifiers - return new ShellPromise with modified options\n  quiet(): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: this.cwdOverride,\n      envOverride: this.envOverride,\n      shouldThrow: this.shouldThrow,\n      quiet: true,\n    });\n  }\n\n  nothrow(): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: this.cwdOverride,\n      envOverride: this.envOverride,\n      shouldThrow: false,\n      quiet: this.isQuiet,\n    });\n  }\n\n  throws(enable: boolean): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: this.cwdOverride,\n      envOverride: this.envOverride,\n      shouldThrow: enable,\n      quiet: this.isQuiet,\n    });\n  }\n\n  // Context overrides - these need to be handled by the shell\n  cwd(path: string): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: path,\n      envOverride: this.envOverride,\n      shouldThrow: this.shouldThrow,\n      quiet: this.isQuiet,\n    });\n  }\n\n  env(vars: Record<string, string>): ShellPromise {\n    return new ShellPromise({\n      execute: this.executor,\n      cwdOverride: this.cwdOverride,\n      envOverride: { ...this.envOverride, ...vars },\n      shouldThrow: this.shouldThrow,\n      quiet: this.isQuiet,\n    });\n  }\n\n  // Getters for internal state (used by ShellDSL)\n  getCwdOverride(): string | undefined {\n    return this.cwdOverride;\n  }\n\n  getEnvOverride(): Record<string, string> | undefined {\n    return this.envOverride;\n  }\n\n  getShouldThrow(): boolean {\n    return this.shouldThrow;\n  }\n\n  getIsQuiet(): boolean {\n    return this.isQuiet;\n  }\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "27303E978C3F3C8A64756E2164756E21",
+  "mappings": ";AACA;AAAA;AAeO,MAAM,aAAgD;AAAA,EACnD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAER,WAAW,CAAC,SAA8B;AAAA,IACxC,KAAK,WAAW,QAAQ;AAAA,IACxB,KAAK,cAAc,QAAQ;AAAA,IAC3B,KAAK,cAAc,QAAQ;AAAA,IAC3B,KAAK,cAAc,QAAQ,eAAe;AAAA,IAC1C,KAAK,UAAU,QAAQ,SAAS;AAAA;AAAA,OAGpB,IAAG,GAAwB;AAAA,IACvC,IAAI,CAAC,KAAK,cAAc;AAAA,MACtB,KAAK,eAAe,KAAK,SAAS;AAAA,QAChC,KAAK,KAAK;AAAA,QACV,KAAK,KAAK;AAAA,MACZ,CAAC;AAAA,IACH;AAAA,IAEA,MAAM,SAAS,MAAM,KAAK;AAAA,IAE1B,IAAI,KAAK,eAAe,OAAO,aAAa,GAAG;AAAA,MAC7C,MAAM,IAAI,WACR,iCAAiC,OAAO,YACxC,OAAO,QACP,OAAO,QACP,OAAO,QACT;AAAA,IACF;AAAA,IAEA,OAAO;AAAA;AAAA,EAGT,IAA6C,CAC3C,aACA,YAC8B;AAAA,IAC9B,OAAO,KAAK,IAAI,EAAE,KAAK,aAAa,UAAU;AAAA;AAAA,EAGhD,KAAsB,CACpB,YAC+B;AAAA,IAC/B,OAAO,KAAK,IAAI,EAAE,MAAM,UAAU;AAAA;AAAA,EAGpC,OAAO,CAAC,WAAsD;AAAA,IAC5D,OAAO,KAAK,IAAI,EAAE,QAAQ,SAAS;AAAA;AAAA,OAI/B,KAAI,GAAoB;AAAA,IAC5B,MAAM,SAAS,MAAM,KAAK,IAAI;AAAA,IAC9B,OAAO,OAAO,OAAO,SAAS,OAAO;AAAA;AAAA,OAGjC,KAAiB,GAAe;AAAA,IACpC,MAAM,OAAO,MAAM,KAAK,KAAK;AAAA,IAC7B,OAAO,KAAK,MAAM,IAAI;AAAA;AAAA,SAGjB,KAAK,GAA0B;AAAA,IACpC,MAAM,OAAO,MAAM,KAAK,KAAK;AAAA,IAC7B,MAAM,QAAQ,KAAK,MAAM;AAAA,CAAI;AAAA,IAE7B,IAAI,MAAM,MAAM,SAAS,OAAO,IAAI;AAAA,MAClC,MAAM,IAAI;AAAA,IACZ;AAAA,IACA,WAAW,QAAQ,OAAO;AAAA,MACxB,MAAM;AAAA,IACR;AAAA;AAAA,OAGI,KAAI,GAAkB;AAAA,IAC1B,MAAM,SAAS,MAAM,KAAK,IAAI;AAAA,IAC9B,OAAO,IAAI,KAAK,CAAC,IAAI,WAAW,OAAO,MAAM,CAAC,CAAC;AAAA;AAAA,OAG3C,OAAM,GAAoB;AAAA,IAC9B,MAAM,SAAS,MAAM,KAAK,IAAI;AAAA,IAC9B,OAAO,OAAO;AAAA;AAAA,EAIhB,KAAK,GAAiB;AAAA,IACpB,OAAO,IAAI,aAAa;AAAA,MACtB,SAAS,KAAK;AAAA,MACd,aAAa,KAAK;AAAA,MAClB,aAAa,KAAK;AAAA,MAClB,aAAa,KAAK;AAAA,MAClB,OAAO;AAAA,IACT,CAAC;AAAA;AAAA,EAGH,OAAO,GAAiB;AAAA,IACtB,OAAO,IAAI,aAAa;AAAA,MACtB,SAAS,KAAK;AAAA,MACd,aAAa,KAAK;AAAA,MAClB,aAAa,KAAK;AAAA,MAClB,aAAa;AAAA,MACb,OAAO,KAAK;AAAA,IACd,CAAC;AAAA;AAAA,EAGH,MAAM,CAAC,QAA+B;AAAA,IACpC,OAAO,IAAI,aAAa;AAAA,MACtB,SAAS,KAAK;AAAA,MACd,aAAa,KAAK;AAAA,MAClB,aAAa,KAAK;AAAA,MAClB,aAAa;AAAA,MACb,OAAO,KAAK;AAAA,IACd,CAAC;AAAA;AAAA,EAIH,GAAG,CAAC,MAA4B;AAAA,IAC9B,OAAO,IAAI,aAAa;AAAA,MACtB,SAAS,KAAK;AAAA,MACd,aAAa;AAAA,MACb,aAAa,KAAK;AAAA,MAClB,aAAa,KAAK;AAAA,MAClB,OAAO,KAAK;AAAA,IACd,CAAC;AAAA;AAAA,EAGH,GAAG,CAAC,MAA4C;AAAA,IAC9C,OAAO,IAAI,aAAa;AAAA,MACtB,SAAS,KAAK;AAAA,MACd,aAAa,KAAK;AAAA,MAClB,aAAa,KAAK,KAAK,gBAAgB,KAAK;AAAA,MAC5C,aAAa,KAAK;AAAA,MAClB,OAAO,KAAK;AAAA,IACd,CAAC;AAAA;AAAA,EAIH,cAAc,GAAuB;AAAA,IACnC,OAAO,KAAK;AAAA;AAAA,EAGd,cAAc,GAAuC;AAAA,IACnD,OAAO,KAAK;AAAA;AAAA,EAGd,cAAc,GAAY;AAAA,IACxB,OAAO,KAAK;AAAA;AAAA,EAGd,UAAU,GAAY;AAAA,IACpB,OAAO,KAAK;AAAA;AAEhB;",
+  "debugId": "77697BFE77B4E29464756E2164756E21",
   "names": []
 }

package/dist/types/src/fs/index.d.ts

@@ -1,3 +1,4 @@
 export { createVirtualFS } from "./memfs-adapter.ts";
 export { FileSystem, type Permission, type PermissionRules, type UnderlyingFS } from "./real-fs.ts";
 export { ReadOnlyFileSystem } from "./readonly-fs.ts";
+export { OPFSFileSystem, createOPFSUnderlyingFS } from "./opfs-fs.ts";

package/dist/types/src/fs/opfs-fs.d.ts

@@ -0,0 +1,5 @@
+import { FileSystem, type PermissionRules, type UnderlyingFS } from "./real-fs.ts";
+export declare function createOPFSUnderlyingFS(root: FileSystemDirectoryHandle): UnderlyingFS;
+export declare class OPFSFileSystem extends FileSystem {
+    constructor(root: FileSystemDirectoryHandle, permissions?: PermissionRules);
+}

package/dist/types/src/index.d.ts

@@ -10,7 +10,7 @@ export type { ASTNode, Redirect, CommandNode, PipelineNode, AndNode, OrNode, Seq
 export { isCommandNode, isPipelineNode, isAndNode, isOrNode, isSequenceNode, isLiteralNode, isVariableNode, isSubstitutionNode, isGlobNode, isConcatNode, isIfNode, isForNode, isWhileNode, isUntilNode, isCaseNode, isArithmeticNode, } from "./parser/index.ts";
 export { Interpreter, type InterpreterOptions, BreakException, ContinueException } from "./interpreter/index.ts";
 export { createVirtualFS } from "./fs/index.ts";
-export { FileSystem, ReadOnlyFileSystem, type Permission, type PermissionRules, type UnderlyingFS, } from "./fs/index.ts";
+export { FileSystem, ReadOnlyFileSystem, OPFSFileSystem, createOPFSUnderlyingFS, type Permission, type PermissionRules, type UnderlyingFS, } from "./fs/index.ts";
 export { createStdin, StdinImpl } from "./io/index.ts";
 export { createStdout, createStderr, createPipe, OutputCollectorImpl, PipeBuffer } from "./io/index.ts";
 export { escape, escapeForInterpolation } from "./utils/index.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shell-dsl",
-  "version": "0.0.28",
+  "version": "0.0.29",
   "description": "A sandboxed shell-style DSL for running scriptable command pipelines in-process without host OS access",
   "author": "ricsam <oss@ricsam.dev>",
   "license": "MIT",