@componentor/fs 2.0.12 → 3.0.0

package/dist/workers/server.worker.js

@@ -0,0 +1,1547 @@
+// src/vfs/layout.ts
+var VFS_MAGIC = 1447449377;
+var VFS_VERSION = 1;
+var DEFAULT_BLOCK_SIZE = 4096;
+var DEFAULT_INODE_COUNT = 1e4;
+var INODE_SIZE = 64;
+var SUPERBLOCK = {
+  SIZE: 64,
+  MAGIC: 0,
+  // uint32 - 0x56465321
+  VERSION: 4,
+  // uint32
+  INODE_COUNT: 8,
+  // uint32 - total inodes allocated
+  BLOCK_SIZE: 12,
+  // uint32 - data block size (default 4096)
+  TOTAL_BLOCKS: 16,
+  // uint32 - total data blocks
+  FREE_BLOCKS: 20,
+  // uint32 - available data blocks
+  INODE_OFFSET: 24,
+  // float64 - byte offset to inode table
+  PATH_OFFSET: 32,
+  // float64 - byte offset to path table
+  DATA_OFFSET: 40,
+  // float64 - byte offset to data region
+  BITMAP_OFFSET: 48,
+  // float64 - byte offset to free block bitmap
+  PATH_USED: 56,
+  // uint32 - bytes used in path table
+  RESERVED: 60
+  // uint32
+};
+var INODE = {
+  TYPE: 0,
+  // uint8 - 0=free, 1=file, 2=directory, 3=symlink
+  FLAGS: 1,
+  // uint8[3] - reserved
+  PATH_OFFSET: 4,
+  // uint32 - byte offset into path table
+  PATH_LENGTH: 8,
+  // uint16 - length of path string
+  RESERVED_10: 10,
+  // uint16
+  MODE: 12,
+  // uint32 - permissions (e.g. 0o100644)
+  SIZE: 16,
+  // float64 - file content size in bytes (using f64 for >4GB)
+  FIRST_BLOCK: 24,
+  // uint32 - index of first data block
+  BLOCK_COUNT: 28,
+  // uint32 - number of contiguous data blocks
+  MTIME: 32,
+  // float64 - last modification time (ms since epoch)
+  CTIME: 40,
+  // float64 - creation/change time (ms since epoch)
+  ATIME: 48,
+  // float64 - last access time (ms since epoch)
+  UID: 56,
+  // uint32 - owner
+  GID: 60
+  // uint32 - group
+};
+var INODE_TYPE = {
+  FREE: 0,
+  FILE: 1,
+  DIRECTORY: 2,
+  SYMLINK: 3
+};
+var DEFAULT_FILE_MODE = 33188;
+var DEFAULT_DIR_MODE = 16877;
+var DEFAULT_SYMLINK_MODE = 41471;
+var DEFAULT_UMASK = 18;
+var S_IFMT = 61440;
+var MAX_SYMLINK_DEPTH = 40;
+var INITIAL_PATH_TABLE_SIZE = 256 * 1024;
+var INITIAL_DATA_BLOCKS = 1024;
+function calculateLayout(inodeCount = DEFAULT_INODE_COUNT, blockSize = DEFAULT_BLOCK_SIZE, totalBlocks = INITIAL_DATA_BLOCKS) {
+  const inodeTableOffset = SUPERBLOCK.SIZE;
+  const inodeTableSize = inodeCount * INODE_SIZE;
+  const pathTableOffset = inodeTableOffset + inodeTableSize;
+  const pathTableSize = INITIAL_PATH_TABLE_SIZE;
+  const bitmapOffset = pathTableOffset + pathTableSize;
+  const bitmapSize = Math.ceil(totalBlocks / 8);
+  const dataOffset = Math.ceil((bitmapOffset + bitmapSize) / blockSize) * blockSize;
+  const totalSize = dataOffset + totalBlocks * blockSize;
+  return {
+    inodeTableOffset,
+    inodeTableSize,
+    pathTableOffset,
+    pathTableSize,
+    bitmapOffset,
+    bitmapSize,
+    dataOffset,
+    totalSize,
+    totalBlocks
+  };
+}
+
+// src/errors.ts
+var CODE_TO_STATUS = {
+  OK: 0,
+  ENOENT: 1,
+  EEXIST: 2,
+  EISDIR: 3,
+  ENOTDIR: 4,
+  ENOTEMPTY: 5,
+  EACCES: 6,
+  EINVAL: 7,
+  EBADF: 8,
+  ELOOP: 9,
+  ENOSPC: 10
+};
+
+// src/vfs/engine.ts
+var encoder = new TextEncoder();
+var decoder = new TextDecoder();
+var VFSEngine = class {
+  handle;
+  pathIndex = /* @__PURE__ */ new Map();
+  // path → inode index
+  inodeCount = 0;
+  blockSize = DEFAULT_BLOCK_SIZE;
+  totalBlocks = 0;
+  freeBlocks = 0;
+  inodeTableOffset = 0;
+  pathTableOffset = 0;
+  pathTableUsed = 0;
+  pathTableSize = 0;
+  bitmapOffset = 0;
+  dataOffset = 0;
+  umask = DEFAULT_UMASK;
+  processUid = 0;
+  processGid = 0;
+  strictPermissions = false;
+  debug = false;
+  // File descriptor table
+  fdTable = /* @__PURE__ */ new Map();
+  nextFd = 3;
+  // 0=stdin, 1=stdout, 2=stderr reserved
+  // Reusable buffers to avoid allocations
+  inodeBuf = new Uint8Array(INODE_SIZE);
+  inodeView = new DataView(this.inodeBuf.buffer);
+  // In-memory inode cache — eliminates disk reads for hot inodes
+  inodeCache = /* @__PURE__ */ new Map();
+  superblockBuf = new Uint8Array(SUPERBLOCK.SIZE);
+  superblockView = new DataView(this.superblockBuf.buffer);
+  // In-memory bitmap cache — eliminates bitmap reads from OPFS
+  bitmap = null;
+  bitmapDirtyLo = Infinity;
+  // lowest dirty byte index
+  bitmapDirtyHi = -1;
+  // highest dirty byte index (inclusive)
+  superblockDirty = false;
+  // Free inode hint — skip O(n) scan
+  freeInodeHint = 0;
+  init(handle, opts) {
+    this.handle = handle;
+    this.processUid = opts?.uid ?? 0;
+    this.processGid = opts?.gid ?? 0;
+    this.umask = opts?.umask ?? DEFAULT_UMASK;
+    this.strictPermissions = opts?.strictPermissions ?? false;
+    this.debug = opts?.debug ?? false;
+    const size = handle.getSize();
+    if (size === 0) {
+      this.format();
+    } else {
+      this.mount();
+    }
+  }
+  /** Format a fresh VFS */
+  format() {
+    const layout = calculateLayout(DEFAULT_INODE_COUNT, DEFAULT_BLOCK_SIZE, INITIAL_DATA_BLOCKS);
+    this.inodeCount = DEFAULT_INODE_COUNT;
+    this.blockSize = DEFAULT_BLOCK_SIZE;
+    this.totalBlocks = layout.totalBlocks;
+    this.freeBlocks = layout.totalBlocks;
+    this.inodeTableOffset = layout.inodeTableOffset;
+    this.pathTableOffset = layout.pathTableOffset;
+    this.pathTableSize = layout.pathTableSize;
+    this.pathTableUsed = 0;
+    this.bitmapOffset = layout.bitmapOffset;
+    this.dataOffset = layout.dataOffset;
+    this.handle.truncate(layout.totalSize);
+    this.writeSuperblock();
+    const zeroBuf = new Uint8Array(layout.inodeTableSize);
+    this.handle.write(zeroBuf, { at: this.inodeTableOffset });
+    this.bitmap = new Uint8Array(layout.bitmapSize);
+    this.handle.write(this.bitmap, { at: this.bitmapOffset });
+    this.createInode("/", INODE_TYPE.DIRECTORY, DEFAULT_DIR_MODE, 0);
+    this.handle.flush();
+  }
+  /** Mount an existing VFS from disk */
+  mount() {
+    this.handle.read(this.superblockBuf, { at: 0 });
+    const v = this.superblockView;
+    const magic = v.getUint32(SUPERBLOCK.MAGIC, true);
+    if (magic !== VFS_MAGIC) {
+      throw new Error(`Invalid VFS: bad magic 0x${magic.toString(16)}`);
+    }
+    this.inodeCount = v.getUint32(SUPERBLOCK.INODE_COUNT, true);
+    this.blockSize = v.getUint32(SUPERBLOCK.BLOCK_SIZE, true);
+    this.totalBlocks = v.getUint32(SUPERBLOCK.TOTAL_BLOCKS, true);
+    this.freeBlocks = v.getUint32(SUPERBLOCK.FREE_BLOCKS, true);
+    this.inodeTableOffset = v.getFloat64(SUPERBLOCK.INODE_OFFSET, true);
+    this.pathTableOffset = v.getFloat64(SUPERBLOCK.PATH_OFFSET, true);
+    this.dataOffset = v.getFloat64(SUPERBLOCK.DATA_OFFSET, true);
+    this.bitmapOffset = v.getFloat64(SUPERBLOCK.BITMAP_OFFSET, true);
+    this.pathTableUsed = v.getUint32(SUPERBLOCK.PATH_USED, true);
+    this.pathTableSize = this.bitmapOffset - this.pathTableOffset;
+    const bitmapSize = Math.ceil(this.totalBlocks / 8);
+    this.bitmap = new Uint8Array(bitmapSize);
+    this.handle.read(this.bitmap, { at: this.bitmapOffset });
+    this.rebuildIndex();
+  }
+  writeSuperblock() {
+    const v = this.superblockView;
+    v.setUint32(SUPERBLOCK.MAGIC, VFS_MAGIC, true);
+    v.setUint32(SUPERBLOCK.VERSION, VFS_VERSION, true);
+    v.setUint32(SUPERBLOCK.INODE_COUNT, this.inodeCount, true);
+    v.setUint32(SUPERBLOCK.BLOCK_SIZE, this.blockSize, true);
+    v.setUint32(SUPERBLOCK.TOTAL_BLOCKS, this.totalBlocks, true);
+    v.setUint32(SUPERBLOCK.FREE_BLOCKS, this.freeBlocks, true);
+    v.setFloat64(SUPERBLOCK.INODE_OFFSET, this.inodeTableOffset, true);
+    v.setFloat64(SUPERBLOCK.PATH_OFFSET, this.pathTableOffset, true);
+    v.setFloat64(SUPERBLOCK.DATA_OFFSET, this.dataOffset, true);
+    v.setFloat64(SUPERBLOCK.BITMAP_OFFSET, this.bitmapOffset, true);
+    v.setUint32(SUPERBLOCK.PATH_USED, this.pathTableUsed, true);
+    this.handle.write(this.superblockBuf, { at: 0 });
+  }
+  /** Flush pending bitmap and superblock writes to disk (one write each) */
+  markBitmapDirty(lo, hi) {
+    if (lo < this.bitmapDirtyLo) this.bitmapDirtyLo = lo;
+    if (hi > this.bitmapDirtyHi) this.bitmapDirtyHi = hi;
+  }
+  commitPending() {
+    if (this.bitmapDirtyHi >= 0) {
+      const lo = this.bitmapDirtyLo;
+      const hi = this.bitmapDirtyHi;
+      this.handle.write(this.bitmap.subarray(lo, hi + 1), { at: this.bitmapOffset + lo });
+      this.bitmapDirtyLo = Infinity;
+      this.bitmapDirtyHi = -1;
+    }
+    if (this.superblockDirty) {
+      this.writeSuperblock();
+      this.superblockDirty = false;
+    }
+  }
+  /** Rebuild in-memory path→inode index from disk */
+  rebuildIndex() {
+    this.pathIndex.clear();
+    for (let i = 0; i < this.inodeCount; i++) {
+      const inode = this.readInode(i);
+      if (inode.type === INODE_TYPE.FREE) continue;
+      const path = this.readPath(inode.pathOffset, inode.pathLength);
+      this.pathIndex.set(path, i);
+    }
+  }
+  // ========== Low-level inode I/O ==========
+  readInode(idx) {
+    const cached = this.inodeCache.get(idx);
+    if (cached) return cached;
+    const offset = this.inodeTableOffset + idx * INODE_SIZE;
+    this.handle.read(this.inodeBuf, { at: offset });
+    const v = this.inodeView;
+    const inode = {
+      type: v.getUint8(INODE.TYPE),
+      pathOffset: v.getUint32(INODE.PATH_OFFSET, true),
+      pathLength: v.getUint16(INODE.PATH_LENGTH, true),
+      mode: v.getUint32(INODE.MODE, true),
+      size: v.getFloat64(INODE.SIZE, true),
+      firstBlock: v.getUint32(INODE.FIRST_BLOCK, true),
+      blockCount: v.getUint32(INODE.BLOCK_COUNT, true),
+      mtime: v.getFloat64(INODE.MTIME, true),
+      ctime: v.getFloat64(INODE.CTIME, true),
+      atime: v.getFloat64(INODE.ATIME, true),
+      uid: v.getUint32(INODE.UID, true),
+      gid: v.getUint32(INODE.GID, true)
+    };
+    this.inodeCache.set(idx, inode);
+    return inode;
+  }
+  writeInode(idx, inode) {
+    if (inode.type === INODE_TYPE.FREE) {
+      this.inodeCache.delete(idx);
+    } else {
+      this.inodeCache.set(idx, inode);
+    }
+    const v = this.inodeView;
+    v.setUint8(INODE.TYPE, inode.type);
+    v.setUint8(INODE.FLAGS, 0);
+    v.setUint8(INODE.FLAGS + 1, 0);
+    v.setUint8(INODE.FLAGS + 2, 0);
+    v.setUint32(INODE.PATH_OFFSET, inode.pathOffset, true);
+    v.setUint16(INODE.PATH_LENGTH, inode.pathLength, true);
+    v.setUint16(INODE.RESERVED_10, 0, true);
+    v.setUint32(INODE.MODE, inode.mode, true);
+    v.setFloat64(INODE.SIZE, inode.size, true);
+    v.setUint32(INODE.FIRST_BLOCK, inode.firstBlock, true);
+    v.setUint32(INODE.BLOCK_COUNT, inode.blockCount, true);
+    v.setFloat64(INODE.MTIME, inode.mtime, true);
+    v.setFloat64(INODE.CTIME, inode.ctime, true);
+    v.setFloat64(INODE.ATIME, inode.atime, true);
+    v.setUint32(INODE.UID, inode.uid, true);
+    v.setUint32(INODE.GID, inode.gid, true);
+    const offset = this.inodeTableOffset + idx * INODE_SIZE;
+    this.handle.write(this.inodeBuf, { at: offset });
+  }
+  // ========== Path table I/O ==========
+  readPath(offset, length) {
+    const buf = new Uint8Array(length);
+    this.handle.read(buf, { at: this.pathTableOffset + offset });
+    return decoder.decode(buf);
+  }
+  appendPath(path) {
+    const bytes = encoder.encode(path);
+    const offset = this.pathTableUsed;
+    if (offset + bytes.byteLength > this.pathTableSize) {
+      this.growPathTable(offset + bytes.byteLength);
+    }
+    this.handle.write(bytes, { at: this.pathTableOffset + offset });
+    this.pathTableUsed += bytes.byteLength;
+    this.superblockDirty = true;
+    return { offset, length: bytes.byteLength };
+  }
+  growPathTable(needed) {
+    const newSize = Math.max(this.pathTableSize * 2, needed + INITIAL_PATH_TABLE_SIZE);
+    const growth = newSize - this.pathTableSize;
+    const dataSize = this.totalBlocks * this.blockSize;
+    const dataBuf = new Uint8Array(dataSize);
+    this.handle.read(dataBuf, { at: this.dataOffset });
+    const newTotalSize = this.handle.getSize() + growth;
+    this.handle.truncate(newTotalSize);
+    const newBitmapOffset = this.bitmapOffset + growth;
+    const newDataOffset = this.dataOffset + growth;
+    this.handle.write(dataBuf, { at: newDataOffset });
+    this.handle.write(this.bitmap, { at: newBitmapOffset });
+    this.pathTableSize = newSize;
+    this.bitmapOffset = newBitmapOffset;
+    this.dataOffset = newDataOffset;
+    this.superblockDirty = true;
+  }
+  // ========== Bitmap I/O ==========
+  allocateBlocks(count) {
+    if (count === 0) return 0;
+    const bitmap = this.bitmap;
+    let run = 0;
+    let start = 0;
+    for (let i = 0; i < this.totalBlocks; i++) {
+      const byteIdx = i >>> 3;
+      const bitIdx = i & 7;
+      const used = bitmap[byteIdx] >>> bitIdx & 1;
+      if (used) {
+        run = 0;
+        start = i + 1;
+      } else {
+        run++;
+        if (run === count) {
+          for (let j = start; j <= i; j++) {
+            const bj = j >>> 3;
+            const bi = j & 7;
+            bitmap[bj] |= 1 << bi;
+          }
+          this.markBitmapDirty(start >>> 3, i >>> 3);
+          this.freeBlocks -= count;
+          this.superblockDirty = true;
+          return start;
+        }
+      }
+    }
+    return this.growAndAllocate(count);
+  }
+  growAndAllocate(count) {
+    const oldTotal = this.totalBlocks;
+    const newTotal = Math.max(oldTotal * 2, oldTotal + count);
+    const addedBlocks = newTotal - oldTotal;
+    const newFileSize = this.dataOffset + newTotal * this.blockSize;
+    this.handle.truncate(newFileSize);
+    const newBitmapSize = Math.ceil(newTotal / 8);
+    const newBitmap = new Uint8Array(newBitmapSize);
+    newBitmap.set(this.bitmap);
+    this.bitmap = newBitmap;
+    this.totalBlocks = newTotal;
+    this.freeBlocks += addedBlocks;
+    const start = oldTotal;
+    for (let j = start; j < start + count; j++) {
+      const bj = j >>> 3;
+      const bi = j & 7;
+      this.bitmap[bj] |= 1 << bi;
+    }
+    this.markBitmapDirty(start >>> 3, start + count - 1 >>> 3);
+    this.freeBlocks -= count;
+    this.superblockDirty = true;
+    return start;
+  }
+  freeBlockRange(start, count) {
+    if (count === 0) return;
+    const bitmap = this.bitmap;
+    for (let i = start; i < start + count; i++) {
+      const byteIdx = i >>> 3;
+      const bitIdx = i & 7;
+      bitmap[byteIdx] &= ~(1 << bitIdx);
+    }
+    this.markBitmapDirty(start >>> 3, start + count - 1 >>> 3);
+    this.freeBlocks += count;
+    this.superblockDirty = true;
+  }
+  // updateSuperblockFreeBlocks is no longer needed — superblock writes are coalesced via commitPending()
+  // ========== Inode allocation ==========
+  findFreeInode() {
+    for (let i = this.freeInodeHint; i < this.inodeCount; i++) {
+      if (this.inodeCache.has(i)) continue;
+      const offset = this.inodeTableOffset + i * INODE_SIZE;
+      const typeBuf = new Uint8Array(1);
+      this.handle.read(typeBuf, { at: offset });
+      if (typeBuf[0] === INODE_TYPE.FREE) {
+        this.freeInodeHint = i + 1;
+        return i;
+      }
+    }
+    const idx = this.growInodeTable();
+    this.freeInodeHint = idx + 1;
+    return idx;
+  }
+  growInodeTable() {
+    const oldCount = this.inodeCount;
+    const newCount = oldCount * 2;
+    const growth = (newCount - oldCount) * INODE_SIZE;
+    const afterInodeOffset = this.inodeTableOffset + oldCount * INODE_SIZE;
+    const afterSize = this.handle.getSize() - afterInodeOffset;
+    const afterBuf = new Uint8Array(afterSize);
+    this.handle.read(afterBuf, { at: afterInodeOffset });
+    this.handle.truncate(this.handle.getSize() + growth);
+    this.handle.write(afterBuf, { at: afterInodeOffset + growth });
+    const zeroes = new Uint8Array(growth);
+    this.handle.write(zeroes, { at: afterInodeOffset });
+    this.pathTableOffset += growth;
+    this.bitmapOffset += growth;
+    this.dataOffset += growth;
+    this.inodeCount = newCount;
+    this.superblockDirty = true;
+    return oldCount;
+  }
+  // ========== Data I/O ==========
+  readData(firstBlock, blockCount, size) {
+    const buf = new Uint8Array(size);
+    const offset = this.dataOffset + firstBlock * this.blockSize;
+    this.handle.read(buf, { at: offset });
+    return buf;
+  }
+  writeData(firstBlock, data) {
+    const offset = this.dataOffset + firstBlock * this.blockSize;
+    this.handle.write(data, { at: offset });
+  }
+  // ========== Path resolution ==========
+  resolvePath(path, depth = 0) {
+    if (depth > MAX_SYMLINK_DEPTH) return void 0;
+    const idx = this.pathIndex.get(path);
+    if (idx === void 0) return void 0;
+    const inode = this.readInode(idx);
+    if (inode.type === INODE_TYPE.SYMLINK) {
+      const target = decoder.decode(this.readData(inode.firstBlock, inode.blockCount, inode.size));
+      const resolved = target.startsWith("/") ? target : this.resolveRelative(path, target);
+      return this.resolvePath(resolved, depth + 1);
+    }
+    return idx;
+  }
+  /** Resolve symlinks in intermediate path components */
+  resolvePathComponents(path, followLast = true) {
+    const parts = path.split("/").filter(Boolean);
+    let current = "/";
+    for (let i = 0; i < parts.length; i++) {
+      const isLast = i === parts.length - 1;
+      current = current === "/" ? "/" + parts[i] : current + "/" + parts[i];
+      const idx = this.pathIndex.get(current);
+      if (idx === void 0) return void 0;
+      const inode = this.readInode(idx);
+      if (inode.type === INODE_TYPE.SYMLINK && (!isLast || followLast)) {
+        const target = decoder.decode(this.readData(inode.firstBlock, inode.blockCount, inode.size));
+        const resolved = target.startsWith("/") ? target : this.resolveRelative(current, target);
+        if (isLast) {
+          return this.resolvePath(resolved);
+        }
+        const remaining = parts.slice(i + 1).join("/");
+        const newPath = resolved + (remaining ? "/" + remaining : "");
+        return this.resolvePathComponents(newPath, followLast);
+      }
+    }
+    return this.pathIndex.get(current);
+  }
+  resolveRelative(from, target) {
+    const dir = from.substring(0, from.lastIndexOf("/")) || "/";
+    const parts = (dir + "/" + target).split("/").filter(Boolean);
+    const resolved = [];
+    for (const p of parts) {
+      if (p === ".") continue;
+      if (p === "..") {
+        resolved.pop();
+        continue;
+      }
+      resolved.push(p);
+    }
+    return "/" + resolved.join("/");
+  }
+  // ========== Core inode creation helper ==========
+  createInode(path, type, mode, size, data) {
+    const idx = this.findFreeInode();
+    const { offset: pathOff, length: pathLen } = this.appendPath(path);
+    const now = Date.now();
+    let firstBlock = 0;
+    let blockCount = 0;
+    if (data && data.byteLength > 0) {
+      blockCount = Math.ceil(data.byteLength / this.blockSize);
+      firstBlock = this.allocateBlocks(blockCount);
+      this.writeData(firstBlock, data);
+    }
+    const inode = {
+      type,
+      pathOffset: pathOff,
+      pathLength: pathLen,
+      mode,
+      size,
+      firstBlock,
+      blockCount,
+      mtime: now,
+      ctime: now,
+      atime: now,
+      uid: this.processUid,
+      gid: this.processGid
+    };
+    this.writeInode(idx, inode);
+    this.pathIndex.set(path, idx);
+    return idx;
+  }
+  // ========== Public API — called by server worker dispatch ==========
+  /** Normalize a path: ensure leading /, resolve . and .. */
+  normalizePath(p) {
+    if (p.charCodeAt(0) !== 47) p = "/" + p;
+    if (p.length === 1) return p;
+    if (p.indexOf("/.") === -1 && p.indexOf("//") === -1 && p.charCodeAt(p.length - 1) !== 47) {
+      return p;
+    }
+    const parts = p.split("/").filter(Boolean);
+    const resolved = [];
+    for (const part of parts) {
+      if (part === ".") continue;
+      if (part === "..") {
+        resolved.pop();
+        continue;
+      }
+      resolved.push(part);
+    }
+    return "/" + resolved.join("/");
+  }
+  // ---- READ ----
+  read(path) {
+    const t0 = this.debug ? performance.now() : 0;
+    path = this.normalizePath(path);
+    let idx = this.pathIndex.get(path);
+    if (idx !== void 0) {
+      const inode2 = this.inodeCache.get(idx);
+      if (inode2) {
+        if (inode2.type === INODE_TYPE.SYMLINK) {
+          idx = this.resolvePathComponents(path, true);
+        } else if (inode2.type === INODE_TYPE.DIRECTORY) {
+          return { status: CODE_TO_STATUS.EISDIR, data: null };
+        } else {
+          const data2 = inode2.size > 0 ? this.readData(inode2.firstBlock, inode2.blockCount, inode2.size) : new Uint8Array(0);
+          if (this.debug) {
+            const t1 = performance.now();
+            console.log(`[VFS read] path=${path} size=${inode2.size} TOTAL=${(t1 - t0).toFixed(3)}ms (fast)`);
+          }
+          return { status: 0, data: data2 };
+        }
+      }
+    }
+    if (idx === void 0) idx = this.resolvePathComponents(path, true);
+    if (idx === void 0) return { status: CODE_TO_STATUS.ENOENT, data: null };
+    const inode = this.readInode(idx);
+    if (inode.type === INODE_TYPE.DIRECTORY) return { status: CODE_TO_STATUS.EISDIR, data: null };
+    const data = inode.size > 0 ? this.readData(inode.firstBlock, inode.blockCount, inode.size) : new Uint8Array(0);
+    if (this.debug) {
+      const t1 = performance.now();
+      console.log(`[VFS read] path=${path} size=${inode.size} TOTAL=${(t1 - t0).toFixed(3)}ms (slow path)`);
+    }
+    return { status: 0, data };
+  }
+  // ---- WRITE ----
+  write(path, data, flags = 0) {
+    const t0 = this.debug ? performance.now() : 0;
+    path = this.normalizePath(path);
+    const t1 = this.debug ? performance.now() : 0;
+    const parentStatus = this.ensureParent(path);
+    if (parentStatus !== 0) return { status: parentStatus };
+    const t2 = this.debug ? performance.now() : 0;
+    const existingIdx = this.resolvePathComponents(path, true);
+    const t3 = this.debug ? performance.now() : 0;
+    let tAlloc = t3, tData = t3, tInode = t3;
+    if (existingIdx !== void 0) {
+      const inode = this.readInode(existingIdx);
+      if (inode.type === INODE_TYPE.DIRECTORY) return { status: CODE_TO_STATUS.EISDIR };
+      const neededBlocks = Math.ceil(data.byteLength / this.blockSize);
+      if (neededBlocks <= inode.blockCount) {
+        tAlloc = this.debug ? performance.now() : 0;
+        this.writeData(inode.firstBlock, data);
+        tData = this.debug ? performance.now() : 0;
+        if (neededBlocks < inode.blockCount) {
+          this.freeBlockRange(inode.firstBlock + neededBlocks, inode.blockCount - neededBlocks);
+        }
+      } else {
+        this.freeBlockRange(inode.firstBlock, inode.blockCount);
+        const newFirst = this.allocateBlocks(neededBlocks);
+        tAlloc = this.debug ? performance.now() : 0;
+        this.writeData(newFirst, data);
+        tData = this.debug ? performance.now() : 0;
+        inode.firstBlock = newFirst;
+      }
+      inode.size = data.byteLength;
+      inode.blockCount = neededBlocks;
+      inode.mtime = Date.now();
+      this.writeInode(existingIdx, inode);
+      tInode = this.debug ? performance.now() : 0;
+    } else {
+      const mode = DEFAULT_FILE_MODE & ~(this.umask & 511);
+      this.createInode(path, INODE_TYPE.FILE, mode, data.byteLength, data);
+      tAlloc = this.debug ? performance.now() : 0;
+      tData = tAlloc;
+      tInode = tAlloc;
+    }
+    if (flags & 1) {
+      this.commitPending();
+      this.handle.flush();
+    }
+    const tFlush = this.debug ? performance.now() : 0;
+    if (this.debug) {
+      const existing = existingIdx !== void 0;
+      console.log(`[VFS write] path=${path} size=${data.byteLength} ${existing ? "UPDATE" : "CREATE"} normalize=${(t1 - t0).toFixed(3)}ms parent=${(t2 - t1).toFixed(3)}ms resolve=${(t3 - t2).toFixed(3)}ms alloc=${(tAlloc - t3).toFixed(3)}ms data=${(tData - tAlloc).toFixed(3)}ms inode=${(tInode - tData).toFixed(3)}ms flush=${(tFlush - tInode).toFixed(3)}ms TOTAL=${(tFlush - t0).toFixed(3)}ms`);
+    }
+    return { status: 0 };
+  }
+  // ---- APPEND ----
+  append(path, data) {
+    path = this.normalizePath(path);
+    const existingIdx = this.resolvePathComponents(path, true);
+    if (existingIdx === void 0) {
+      return this.write(path, data);
+    }
+    const inode = this.readInode(existingIdx);
+    if (inode.type === INODE_TYPE.DIRECTORY) return { status: CODE_TO_STATUS.EISDIR };
+    const existing = inode.size > 0 ? this.readData(inode.firstBlock, inode.blockCount, inode.size) : new Uint8Array(0);
+    const combined = new Uint8Array(existing.byteLength + data.byteLength);
+    combined.set(existing);
+    combined.set(data, existing.byteLength);
+    const neededBlocks = Math.ceil(combined.byteLength / this.blockSize);
+    this.freeBlockRange(inode.firstBlock, inode.blockCount);
+    const newFirst = this.allocateBlocks(neededBlocks);
+    this.writeData(newFirst, combined);
+    inode.firstBlock = newFirst;
+    inode.blockCount = neededBlocks;
+    inode.size = combined.byteLength;
+    inode.mtime = Date.now();
+    this.writeInode(existingIdx, inode);
+    this.commitPending();
+    return { status: 0 };
+  }
+  // ---- UNLINK ----
+  unlink(path) {
+    path = this.normalizePath(path);
+    const idx = this.pathIndex.get(path);
+    if (idx === void 0) return { status: CODE_TO_STATUS.ENOENT };
+    const inode = this.readInode(idx);
+    if (inode.type === INODE_TYPE.DIRECTORY) return { status: CODE_TO_STATUS.EISDIR };
+    this.freeBlockRange(inode.firstBlock, inode.blockCount);
+    inode.type = INODE_TYPE.FREE;
+    this.writeInode(idx, inode);
+    this.pathIndex.delete(path);
+    if (idx < this.freeInodeHint) this.freeInodeHint = idx;
+    this.commitPending();
+    return { status: 0 };
+  }
+  // ---- STAT ----
+  stat(path) {
+    path = this.normalizePath(path);
+    const idx = this.resolvePathComponents(path, true);
+    if (idx === void 0) return { status: CODE_TO_STATUS.ENOENT, data: null };
+    return this.encodeStatResponse(idx);
+  }
+  // ---- LSTAT (no symlink follow) ----
+  lstat(path) {
+    path = this.normalizePath(path);
+    const idx = this.pathIndex.get(path);
+    if (idx === void 0) return { status: CODE_TO_STATUS.ENOENT, data: null };
+    return this.encodeStatResponse(idx);
+  }
+  encodeStatResponse(idx) {
+    const inode = this.readInode(idx);
+    const buf = new Uint8Array(49);
+    const view = new DataView(buf.buffer);
+    view.setUint8(0, inode.type);
+    view.setUint32(1, inode.mode, true);
+    view.setFloat64(5, inode.size, true);
+    view.setFloat64(13, inode.mtime, true);
+    view.setFloat64(21, inode.ctime, true);
+    view.setFloat64(29, inode.atime, true);
+    view.setUint32(37, inode.uid, true);
+    view.setUint32(41, inode.gid, true);
+    view.setUint32(45, idx, true);
+    return { status: 0, data: buf };
+  }
+  // ---- MKDIR ----
+  mkdir(path, flags = 0) {
+    path = this.normalizePath(path);
+    const recursive = (flags & 1) !== 0;
+    if (recursive) {
+      return this.mkdirRecursive(path);
+    }
+    if (this.pathIndex.has(path)) return { status: CODE_TO_STATUS.EEXIST, data: null };
+    const parentStatus = this.ensureParent(path);
+    if (parentStatus !== 0) return { status: parentStatus, data: null };
+    const mode = DEFAULT_DIR_MODE & ~(this.umask & 511);
+    this.createInode(path, INODE_TYPE.DIRECTORY, mode, 0);
+    this.commitPending();
+    const pathBytes = encoder.encode(path);
+    return { status: 0, data: pathBytes };
+  }
+  mkdirRecursive(path) {
+    const parts = path.split("/").filter(Boolean);
+    let current = "";
+    let firstCreated = null;
+    for (const part of parts) {
+      current += "/" + part;
+      if (this.pathIndex.has(current)) {
+        const idx = this.pathIndex.get(current);
+        const inode = this.readInode(idx);
+        if (inode.type !== INODE_TYPE.DIRECTORY) {
+          return { status: CODE_TO_STATUS.ENOTDIR, data: null };
+        }
+        continue;
+      }
+      const mode = DEFAULT_DIR_MODE & ~(this.umask & 511);
+      this.createInode(current, INODE_TYPE.DIRECTORY, mode, 0);
+      if (!firstCreated) firstCreated = current;
+    }
+    this.commitPending();
+    const result = firstCreated ? encoder.encode(firstCreated) : void 0;
+    return { status: 0, data: result ?? null };
+  }
+  // ---- RMDIR ----
+  rmdir(path, flags = 0) {
+    path = this.normalizePath(path);
+    const recursive = (flags & 1) !== 0;
+    const idx = this.pathIndex.get(path);
+    if (idx === void 0) return { status: CODE_TO_STATUS.ENOENT };
+    const inode = this.readInode(idx);
+    if (inode.type !== INODE_TYPE.DIRECTORY) return { status: CODE_TO_STATUS.ENOTDIR };
+    const children = this.getDirectChildren(path);
+    if (children.length > 0) {
+      if (!recursive) return { status: CODE_TO_STATUS.ENOTEMPTY };
+      for (const child of this.getAllDescendants(path)) {
+        const childIdx = this.pathIndex.get(child);
+        const childInode = this.readInode(childIdx);
+        this.freeBlockRange(childInode.firstBlock, childInode.blockCount);
+        childInode.type = INODE_TYPE.FREE;
+        this.writeInode(childIdx, childInode);
+        this.pathIndex.delete(child);
+      }
+    }
+    inode.type = INODE_TYPE.FREE;
+    this.writeInode(idx, inode);
+    this.pathIndex.delete(path);
+    if (idx < this.freeInodeHint) this.freeInodeHint = idx;
+    this.commitPending();
+    return { status: 0 };
+  }
+  // ---- READDIR ----
+  readdir(path, flags = 0) {
+    path = this.normalizePath(path);
+    const idx = this.resolvePathComponents(path, true);
+    if (idx === void 0) return { status: CODE_TO_STATUS.ENOENT, data: null };
+    const inode = this.readInode(idx);
+    if (inode.type !== INODE_TYPE.DIRECTORY) return { status: CODE_TO_STATUS.ENOTDIR, data: null };
+    const withFileTypes = (flags & 1) !== 0;
+    const children = this.getDirectChildren(path);
+    if (withFileTypes) {
+      let totalSize2 = 4;
+      const entries = [];
+      for (const childPath of children) {
+        const name = childPath.substring(childPath.lastIndexOf("/") + 1);
+        const nameBytes = encoder.encode(name);
+        const childIdx = this.pathIndex.get(childPath);
+        const childInode = this.readInode(childIdx);
+        entries.push({ name: nameBytes, type: childInode.type });
+        totalSize2 += 2 + nameBytes.byteLength + 1;
+      }
+      const buf2 = new Uint8Array(totalSize2);
+      const view2 = new DataView(buf2.buffer);
+      view2.setUint32(0, entries.length, true);
+      let offset2 = 4;
+      for (const entry of entries) {
+        view2.setUint16(offset2, entry.name.byteLength, true);
+        offset2 += 2;
+        buf2.set(entry.name, offset2);
+        offset2 += entry.name.byteLength;
+        buf2[offset2++] = entry.type;
+      }
+      return { status: 0, data: buf2 };
+    }
+    let totalSize = 4;
+    const nameEntries = [];
+    for (const childPath of children) {
+      const name = childPath.substring(childPath.lastIndexOf("/") + 1);
+      const nameBytes = encoder.encode(name);
+      nameEntries.push(nameBytes);
+      totalSize += 2 + nameBytes.byteLength;
+    }
+    const buf = new Uint8Array(totalSize);
+    const view = new DataView(buf.buffer);
+    view.setUint32(0, nameEntries.length, true);
+    let offset = 4;
+    for (const nameBytes of nameEntries) {
+      view.setUint16(offset, nameBytes.byteLength, true);
+      offset += 2;
+      buf.set(nameBytes, offset);
+      offset += nameBytes.byteLength;
+    }
+    return { status: 0, data: buf };
+  }
+  // ---- RENAME ----
+  rename(oldPath, newPath) {
+    oldPath = this.normalizePath(oldPath);
+    newPath = this.normalizePath(newPath);
+    const idx = this.pathIndex.get(oldPath);
+    if (idx === void 0) return { status: CODE_TO_STATUS.ENOENT };
+    const parentStatus = this.ensureParent(newPath);
+    if (parentStatus !== 0) return { status: parentStatus };
+    const existingIdx = this.pathIndex.get(newPath);
+    if (existingIdx !== void 0) {
+      const existingInode = this.readInode(existingIdx);
+      this.freeBlockRange(existingInode.firstBlock, existingInode.blockCount);
+      existingInode.type = INODE_TYPE.FREE;
+      this.writeInode(existingIdx, existingInode);
+      this.pathIndex.delete(newPath);
+    }
+    const inode = this.readInode(idx);
+    const { offset: pathOff, length: pathLen } = this.appendPath(newPath);
+    inode.pathOffset = pathOff;
+    inode.pathLength = pathLen;
+    inode.mtime = Date.now();
+    this.writeInode(idx, inode);
+    this.pathIndex.delete(oldPath);
+    this.pathIndex.set(newPath, idx);
+    if (inode.type === INODE_TYPE.DIRECTORY) {
+      const prefix = oldPath === "/" ? "/" : oldPath + "/";
+      const toRename = [];
+      for (const [p, i] of this.pathIndex) {
+        if (p.startsWith(prefix)) {
+          toRename.push([p, i]);
+        }
+      }
+      for (const [p, i] of toRename) {
+        const suffix = p.substring(oldPath.length);
+        const childNewPath = newPath + suffix;
+        const childInode = this.readInode(i);
+        const { offset: cpo, length: cpl } = this.appendPath(childNewPath);
+        childInode.pathOffset = cpo;
+        childInode.pathLength = cpl;
+        this.writeInode(i, childInode);
+        this.pathIndex.delete(p);
+        this.pathIndex.set(childNewPath, i);
+      }
+    }
+    this.commitPending();
+    return { status: 0 };
+  }
+  // ---- EXISTS ----
+  exists(path) {
+    path = this.normalizePath(path);
+    const idx = this.resolvePathComponents(path, true);
+    const buf = new Uint8Array(1);
+    buf[0] = idx !== void 0 ? 1 : 0;
+    return { status: 0, data: buf };
+  }
+  // ---- TRUNCATE ----
+  truncate(path, len = 0) {
+    path = this.normalizePath(path);
+    const idx = this.resolvePathComponents(path, true);
+    if (idx === void 0) return { status: CODE_TO_STATUS.ENOENT };
+    const inode = this.readInode(idx);
+    if (inode.type === INODE_TYPE.DIRECTORY) return { status: CODE_TO_STATUS.EISDIR };
+    if (len === 0) {
+      this.freeBlockRange(inode.firstBlock, inode.blockCount);
+      inode.firstBlock = 0;
+      inode.blockCount = 0;
+      inode.size = 0;
+    } else if (len < inode.size) {
+      const neededBlocks = Math.ceil(len / this.blockSize);
+      if (neededBlocks < inode.blockCount) {
+        this.freeBlockRange(inode.firstBlock + neededBlocks, inode.blockCount - neededBlocks);
+      }
+      inode.blockCount = neededBlocks;
+      inode.size = len;
+    } else if (len > inode.size) {
+      const neededBlocks = Math.ceil(len / this.blockSize);
+      if (neededBlocks > inode.blockCount) {
+        const oldData = this.readData(inode.firstBlock, inode.blockCount, inode.size);
+        this.freeBlockRange(inode.firstBlock, inode.blockCount);
+        const newFirst = this.allocateBlocks(neededBlocks);
+        const newData = new Uint8Array(len);
+        newData.set(oldData);
+        this.writeData(newFirst, newData);
+        inode.firstBlock = newFirst;
+      }
+      inode.blockCount = neededBlocks;
+      inode.size = len;
+    }
+    inode.mtime = Date.now();
+    this.writeInode(idx, inode);
+    this.commitPending();
+    return { status: 0 };
+  }
+  // ---- COPY ----
+  copy(srcPath, destPath, flags = 0) {
+    srcPath = this.normalizePath(srcPath);
+    destPath = this.normalizePath(destPath);
+    const srcIdx = this.resolvePathComponents(srcPath, true);
+    if (srcIdx === void 0) return { status: CODE_TO_STATUS.ENOENT };
+    const srcInode = this.readInode(srcIdx);
+    if (srcInode.type === INODE_TYPE.DIRECTORY) return { status: CODE_TO_STATUS.EISDIR };
+    if (flags & 1 && this.pathIndex.has(destPath)) {
+      return { status: CODE_TO_STATUS.EEXIST };
+    }
+    const data = srcInode.size > 0 ? this.readData(srcInode.firstBlock, srcInode.blockCount, srcInode.size) : new Uint8Array(0);
+    return this.write(destPath, data);
+  }
+  // ---- ACCESS ----
+  access(path, mode = 0) {
+    path = this.normalizePath(path);
+    const idx = this.resolvePathComponents(path, true);
+    if (idx === void 0) return { status: CODE_TO_STATUS.ENOENT };
+    if (mode === 0) return { status: 0 };
+    if (!this.strictPermissions) return { status: 0 };
+    const inode = this.readInode(idx);
+    const filePerm = this.getEffectivePermission(inode);
+    if (mode & 4 && !(filePerm & 4)) return { status: CODE_TO_STATUS.EACCES };
+    if (mode & 2 && !(filePerm & 2)) return { status: CODE_TO_STATUS.EACCES };
+    if (mode & 1 && !(filePerm & 1)) return { status: CODE_TO_STATUS.EACCES };
+    return { status: 0 };
+  }
+  getEffectivePermission(inode) {
+    const modeBits = inode.mode & 511;
+    if (this.processUid === inode.uid) return modeBits >>> 6 & 7;
+    if (this.processGid === inode.gid) return modeBits >>> 3 & 7;
+    return modeBits & 7;
+  }
+  // ---- REALPATH ----
+  realpath(path) {
+    path = this.normalizePath(path);
+    const idx = this.resolvePathComponents(path, true);
+    if (idx === void 0) return { status: CODE_TO_STATUS.ENOENT, data: null };
+    const inode = this.readInode(idx);
+    const resolvedPath = this.readPath(inode.pathOffset, inode.pathLength);
+    return { status: 0, data: encoder.encode(resolvedPath) };
+  }
+  // ---- CHMOD ----
+  chmod(path, mode) {
+    path = this.normalizePath(path);
+    const idx = this.resolvePathComponents(path, true);
+    if (idx === void 0) return { status: CODE_TO_STATUS.ENOENT };
+    const inode = this.readInode(idx);
+    inode.mode = inode.mode & S_IFMT | mode & 4095;
+    inode.ctime = Date.now();
+    this.writeInode(idx, inode);
+    return { status: 0 };
+  }
+  // ---- CHOWN ----
+  chown(path, uid, gid) {
+    path = this.normalizePath(path);
+    const idx = this.resolvePathComponents(path, true);
+    if (idx === void 0) return { status: CODE_TO_STATUS.ENOENT };
+    const inode = this.readInode(idx);
+    inode.uid = uid;
+    inode.gid = gid;
+    inode.ctime = Date.now();
+    this.writeInode(idx, inode);
+    return { status: 0 };
+  }
+  // ---- UTIMES ----
+  utimes(path, atime, mtime) {
+    path = this.normalizePath(path);
+    const idx = this.resolvePathComponents(path, true);
+    if (idx === void 0) return { status: CODE_TO_STATUS.ENOENT };
+    const inode = this.readInode(idx);
+    inode.atime = atime;
+    inode.mtime = mtime;
+    inode.ctime = Date.now();
+    this.writeInode(idx, inode);
+    return { status: 0 };
+  }
+  // ---- SYMLINK ----
+  symlink(target, linkPath) {
+    linkPath = this.normalizePath(linkPath);
+    if (this.pathIndex.has(linkPath)) return { status: CODE_TO_STATUS.EEXIST };
+    const parentStatus = this.ensureParent(linkPath);
+    if (parentStatus !== 0) return { status: parentStatus };
+    const targetBytes = encoder.encode(target);
+    this.createInode(linkPath, INODE_TYPE.SYMLINK, DEFAULT_SYMLINK_MODE, targetBytes.byteLength, targetBytes);
+    this.commitPending();
+    return { status: 0 };
+  }
+  // ---- READLINK ----
+  readlink(path) {
+    path = this.normalizePath(path);
+    const idx = this.pathIndex.get(path);
+    if (idx === void 0) return { status: CODE_TO_STATUS.ENOENT, data: null };
+    const inode = this.readInode(idx);
+    if (inode.type !== INODE_TYPE.SYMLINK) return { status: CODE_TO_STATUS.EINVAL, data: null };
+    const target = this.readData(inode.firstBlock, inode.blockCount, inode.size);
+    return { status: 0, data: target };
+  }
+  // ---- LINK (hard link — copies the file) ----
+  link(existingPath, newPath) {
+    return this.copy(existingPath, newPath);
+  }
+  // ---- OPEN (file descriptor) ----
+  open(path, flags, tabId) {
+    path = this.normalizePath(path);
+    const hasCreate = (flags & 64) !== 0;
+    const hasTrunc = (flags & 512) !== 0;
+    const hasExcl = (flags & 128) !== 0;
+    let idx = this.resolvePathComponents(path, true);
+    if (idx === void 0) {
+      if (!hasCreate) return { status: CODE_TO_STATUS.ENOENT, data: null };
+      const mode = DEFAULT_FILE_MODE & ~(this.umask & 511);
+      idx = this.createInode(path, INODE_TYPE.FILE, mode, 0);
+    } else if (hasExcl && hasCreate) {
+      return { status: CODE_TO_STATUS.EEXIST, data: null };
+    }
+    if (hasTrunc) {
+      this.truncate(path, 0);
+    }
+    const fd = this.nextFd++;
+    this.fdTable.set(fd, { tabId, inodeIdx: idx, position: 0, flags });
+    const buf = new Uint8Array(4);
+    new DataView(buf.buffer).setUint32(0, fd, true);
+    return { status: 0, data: buf };
+  }
+  // ---- CLOSE ----
+  close(fd) {
+    if (!this.fdTable.has(fd)) return { status: CODE_TO_STATUS.EBADF };
+    this.fdTable.delete(fd);
+    return { status: 0 };
+  }
+  // ---- FREAD ----
+  fread(fd, length, position) {
+    const entry = this.fdTable.get(fd);
+    if (!entry) return { status: CODE_TO_STATUS.EBADF, data: null };
+    const inode = this.readInode(entry.inodeIdx);
+    const pos = position ?? entry.position;
+    const readLen = Math.min(length, inode.size - pos);
+    if (readLen <= 0) return { status: 0, data: new Uint8Array(0) };
+    const dataOffset = this.dataOffset + inode.firstBlock * this.blockSize + pos;
+    const buf = new Uint8Array(readLen);
+    this.handle.read(buf, { at: dataOffset });
+    if (position === null) {
+      entry.position += readLen;
+    }
+    return { status: 0, data: buf };
+  }
+  // ---- FWRITE ----
+  fwrite(fd, data, position) {
+    const entry = this.fdTable.get(fd);
+    if (!entry) return { status: CODE_TO_STATUS.EBADF, data: null };
+    const inode = this.readInode(entry.inodeIdx);
+    const isAppend = (entry.flags & 1024) !== 0;
+    const pos = isAppend ? inode.size : position ?? entry.position;
+    const endPos = pos + data.byteLength;
+    if (endPos > inode.size) {
+      const neededBlocks = Math.ceil(endPos / this.blockSize);
+      if (neededBlocks > inode.blockCount) {
+        const oldData = inode.size > 0 ? this.readData(inode.firstBlock, inode.blockCount, inode.size) : new Uint8Array(0);
+        this.freeBlockRange(inode.firstBlock, inode.blockCount);
+        const newFirst = this.allocateBlocks(neededBlocks);
+        const newBuf = new Uint8Array(endPos);
+        newBuf.set(oldData);
+        newBuf.set(data, pos);
+        this.writeData(newFirst, newBuf);
+        inode.firstBlock = newFirst;
+        inode.blockCount = neededBlocks;
+      } else {
+        const dataOffset = this.dataOffset + inode.firstBlock * this.blockSize + pos;
+        this.handle.write(data, { at: dataOffset });
+      }
+      inode.size = endPos;
+    } else {
+      const dataOffset = this.dataOffset + inode.firstBlock * this.blockSize + pos;
+      this.handle.write(data, { at: dataOffset });
+    }
+    inode.mtime = Date.now();
+    this.writeInode(entry.inodeIdx, inode);
+    if (position === null) {
+      entry.position = endPos;
+    }
+    this.commitPending();
+    const buf = new Uint8Array(4);
+    new DataView(buf.buffer).setUint32(0, data.byteLength, true);
+    return { status: 0, data: buf };
+  }
+  // ---- FSTAT ----
+  fstat(fd) {
+    const entry = this.fdTable.get(fd);
+    if (!entry) return { status: CODE_TO_STATUS.EBADF, data: null };
+    return this.encodeStatResponse(entry.inodeIdx);
+  }
+  // ---- FTRUNCATE ----
+  ftruncate(fd, len = 0) {
+    const entry = this.fdTable.get(fd);
+    if (!entry) return { status: CODE_TO_STATUS.EBADF };
+    const inode = this.readInode(entry.inodeIdx);
+    const path = this.readPath(inode.pathOffset, inode.pathLength);
+    return this.truncate(path, len);
+  }
+  // ---- FSYNC ----
+  fsync() {
+    this.commitPending();
+    this.handle.flush();
+    return { status: 0 };
+  }
+  // ---- OPENDIR ----
+  opendir(path, tabId) {
+    path = this.normalizePath(path);
+    const idx = this.resolvePathComponents(path, true);
+    if (idx === void 0) return { status: CODE_TO_STATUS.ENOENT, data: null };
+    const inode = this.readInode(idx);
+    if (inode.type !== INODE_TYPE.DIRECTORY) return { status: CODE_TO_STATUS.ENOTDIR, data: null };
+    const fd = this.nextFd++;
+    this.fdTable.set(fd, { tabId, inodeIdx: idx, position: 0, flags: 0 });
+    const buf = new Uint8Array(4);
+    new DataView(buf.buffer).setUint32(0, fd, true);
+    return { status: 0, data: buf };
+  }
+  // ---- MKDTEMP ----
+  mkdtemp(prefix) {
+    const suffix = Math.random().toString(36).substring(2, 8);
+    const path = this.normalizePath(prefix + suffix);
+    const parentStatus = this.ensureParent(path);
+    if (parentStatus !== 0) {
+      const parentPath = path.substring(0, path.lastIndexOf("/"));
+      if (parentPath) {
+        this.mkdirRecursive(parentPath);
+      }
+    }
+    const mode = DEFAULT_DIR_MODE & ~(this.umask & 511);
+    this.createInode(path, INODE_TYPE.DIRECTORY, mode, 0);
+    this.commitPending();
+    return { status: 0, data: encoder.encode(path) };
+  }
+  // ========== Helpers ==========
+  getDirectChildren(dirPath) {
+    const prefix = dirPath === "/" ? "/" : dirPath + "/";
+    const children = [];
+    for (const path of this.pathIndex.keys()) {
+      if (path === dirPath) continue;
+      if (!path.startsWith(prefix)) continue;
+      const rest = path.substring(prefix.length);
+      if (!rest.includes("/")) {
+        children.push(path);
+      }
+    }
+    return children.sort();
+  }
+  getAllDescendants(dirPath) {
+    const prefix = dirPath === "/" ? "/" : dirPath + "/";
+    const descendants = [];
+    for (const path of this.pathIndex.keys()) {
+      if (path.startsWith(prefix)) descendants.push(path);
+    }
+    return descendants.sort((a, b) => {
+      const da = a.split("/").length;
+      const db = b.split("/").length;
+      return db - da;
+    });
+  }
+  ensureParent(path) {
+    const lastSlash = path.lastIndexOf("/");
+    if (lastSlash <= 0) return 0;
+    const parentPath = path.substring(0, lastSlash);
+    const parentIdx = this.pathIndex.get(parentPath);
+    if (parentIdx === void 0) return CODE_TO_STATUS.ENOENT;
+    const parentInode = this.readInode(parentIdx);
+    if (parentInode.type !== INODE_TYPE.DIRECTORY) return CODE_TO_STATUS.ENOTDIR;
+    return 0;
+  }
+  /** Clean up all fds owned by a tab */
+  cleanupTab(tabId) {
+    for (const [fd, entry] of this.fdTable) {
+      if (entry.tabId === tabId) {
+        this.fdTable.delete(fd);
+      }
+    }
+  }
+  /** Get all file paths and their data for OPFS sync */
+  getAllFiles() {
+    const files = [];
+    for (const [path, idx] of this.pathIndex) {
+      files.push({ path, idx });
+    }
+    return files;
+  }
+  /** Get file path for a file descriptor (used by OPFS sync for FD-based ops) */
+  getPathForFd(fd) {
+    const entry = this.fdTable.get(fd);
+    if (!entry) return null;
+    const inode = this.readInode(entry.inodeIdx);
+    return this.readPath(inode.pathOffset, inode.pathLength);
+  }
+  /** Get file data by inode index */
+  getInodeData(idx) {
+    const inode = this.readInode(idx);
+    const data = inode.size > 0 ? this.readData(inode.firstBlock, inode.blockCount, inode.size) : new Uint8Array(0);
+    return { type: inode.type, data, mtime: inode.mtime };
+  }
+  flush() {
+    this.handle.flush();
+  }
+};
+
+// src/protocol/opcodes.ts
+var OP = {
+  READ: 1,
+  WRITE: 2,
+  UNLINK: 3,
+  STAT: 4,
+  LSTAT: 5,
+  MKDIR: 6,
+  RMDIR: 7,
+  READDIR: 8,
+  RENAME: 9,
+  EXISTS: 10,
+  TRUNCATE: 11,
+  APPEND: 12,
+  COPY: 13,
+  ACCESS: 14,
+  REALPATH: 15,
+  CHMOD: 16,
+  CHOWN: 17,
+  UTIMES: 18,
+  SYMLINK: 19,
+  READLINK: 20,
+  LINK: 21,
+  OPEN: 22,
+  CLOSE: 23,
+  FREAD: 24,
+  FWRITE: 25,
+  FSTAT: 26,
+  FTRUNCATE: 27,
+  FSYNC: 28,
+  OPENDIR: 29,
+  MKDTEMP: 30
+};
+var encoder2 = new TextEncoder();
+var decoder2 = new TextDecoder();
+function decodeRequest(buf) {
+  const view = new DataView(buf);
+  const op = view.getUint32(0, true);
+  const flags = view.getUint32(4, true);
+  const pathLen = view.getUint32(8, true);
+  const dataLen = view.getUint32(12, true);
+  const bytes = new Uint8Array(buf);
+  const path = decoder2.decode(bytes.subarray(16, 16 + pathLen));
+  const data = dataLen > 0 ? bytes.subarray(16 + pathLen, 16 + pathLen + dataLen) : null;
+  return { op, flags, path, data };
+}
+function encodeResponse(status, data) {
+  const dataLen = data ? data.byteLength : 0;
+  const buf = new ArrayBuffer(8 + dataLen);
+  const view = new DataView(buf);
+  view.setUint32(0, status, true);
+  view.setUint32(4, dataLen, true);
+  if (data) {
+    new Uint8Array(buf).set(data, 8);
+  }
+  return buf;
+}
+function decodeSecondPath(data) {
+  const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+  const pathLen = view.getUint32(0, true);
+  return decoder2.decode(data.subarray(4, 4 + pathLen));
+}
+
+// src/workers/server.worker.ts
+var engine = new VFSEngine();
+var ports = /* @__PURE__ */ new Map();
+var opfsSyncPort = null;
+var config = {
+  root: "/",
+  opfsSync: true,
+  uid: 0,
+  gid: 0,
+  umask: 18,
+  strictPermissions: false
+};
+function handleRequest(tabId, buffer) {
+  const { op, flags, path, data } = decodeRequest(buffer);
+  let result;
+  switch (op) {
+    case OP.READ:
+      result = engine.read(path);
+      break;
+    case OP.WRITE:
+      result = engine.write(path, data ?? new Uint8Array(0), flags);
+      notifyOPFSSync("write", path, data);
+      break;
+    case OP.APPEND:
+      result = engine.append(path, data ?? new Uint8Array(0));
+      notifyOPFSSync("write", path, data);
+      break;
+    case OP.UNLINK:
+      result = engine.unlink(path);
+      notifyOPFSSync("delete", path);
+      break;
+    case OP.STAT:
+      result = engine.stat(path);
+      break;
+    case OP.LSTAT:
+      result = engine.lstat(path);
+      break;
+    case OP.MKDIR:
+      result = engine.mkdir(path, flags);
+      notifyOPFSSync("mkdir", path);
+      break;
+    case OP.RMDIR:
+      result = engine.rmdir(path, flags);
+      notifyOPFSSync("delete", path);
+      break;
+    case OP.READDIR:
+      result = engine.readdir(path, flags);
+      break;
+    case OP.RENAME: {
+      const newPath = data ? decodeSecondPath(data) : "";
+      result = engine.rename(path, newPath);
+      notifyOPFSSync("rename", path, void 0, newPath);
+      break;
+    }
+    case OP.EXISTS:
+      result = engine.exists(path);
+      break;
+    case OP.TRUNCATE: {
+      const len = data ? new DataView(data.buffer, data.byteOffset, data.byteLength).getUint32(0, true) : 0;
+      result = engine.truncate(path, len);
+      break;
+    }
+    case OP.COPY: {
+      const destPath = data ? decodeSecondPath(data) : "";
+      result = engine.copy(path, destPath, flags);
+      break;
+    }
+    case OP.ACCESS:
+      result = engine.access(path, flags);
+      break;
+    case OP.REALPATH:
+      result = engine.realpath(path);
+      break;
+    case OP.CHMOD: {
+      const mode = data ? new DataView(data.buffer, data.byteOffset, data.byteLength).getUint32(0, true) : 0;
+      result = engine.chmod(path, mode);
+      break;
+    }
+    case OP.CHOWN: {
+      if (!data || data.byteLength < 8) {
+        result = { status: 7 };
+        break;
+      }
+      const dv = new DataView(data.buffer, data.byteOffset, data.byteLength);
+      const uid = dv.getUint32(0, true);
+      const gid = dv.getUint32(4, true);
+      result = engine.chown(path, uid, gid);
+      break;
+    }
+    case OP.UTIMES: {
+      if (!data || data.byteLength < 16) {
+        result = { status: 7 };
+        break;
+      }
+      const dv = new DataView(data.buffer, data.byteOffset, data.byteLength);
+      const atime = dv.getFloat64(0, true);
+      const mtime = dv.getFloat64(8, true);
+      result = engine.utimes(path, atime, mtime);
+      break;
+    }
+    case OP.SYMLINK: {
+      const target = data ? new TextDecoder().decode(data) : "";
+      result = engine.symlink(target, path);
+      break;
+    }
+    case OP.READLINK:
+      result = engine.readlink(path);
+      break;
+    case OP.LINK: {
+      const newPath = data ? decodeSecondPath(data) : "";
+      result = engine.link(path, newPath);
+      break;
+    }
+    case OP.OPEN: {
+      result = engine.open(path, flags, tabId);
+      break;
+    }
+    case OP.CLOSE: {
+      const fd = data ? new DataView(data.buffer, data.byteOffset, data.byteLength).getUint32(0, true) : 0;
+      result = engine.close(fd);
+      break;
+    }
+    case OP.FREAD: {
+      if (!data || data.byteLength < 12) {
+        result = { status: 7 };
+        break;
+      }
+      const dv = new DataView(data.buffer, data.byteOffset, data.byteLength);
+      const fd = dv.getUint32(0, true);
+      const length = dv.getUint32(4, true);
+      const pos = dv.getInt32(8, true);
+      result = engine.fread(fd, length, pos === -1 ? null : pos);
+      break;
+    }
+    case OP.FWRITE: {
+      if (!data || data.byteLength < 8) {
+        result = { status: 7 };
+        break;
+      }
+      const dv = new DataView(data.buffer, data.byteOffset, data.byteLength);
+      const fd = dv.getUint32(0, true);
+      const pos = dv.getInt32(4, true);
+      const writeData = data.subarray(8);
+      result = engine.fwrite(fd, writeData, pos === -1 ? null : pos);
+      break;
+    }
+    case OP.FSTAT: {
+      const fd = data ? new DataView(data.buffer, data.byteOffset, data.byteLength).getUint32(0, true) : 0;
+      result = engine.fstat(fd);
+      break;
+    }
+    case OP.FTRUNCATE: {
+      if (!data || data.byteLength < 8) {
+        result = { status: 7 };
+        break;
+      }
+      const dv = new DataView(data.buffer, data.byteOffset, data.byteLength);
+      const fd = dv.getUint32(0, true);
+      const len = dv.getUint32(4, true);
+      result = engine.ftruncate(fd, len);
+      break;
+    }
+    case OP.FSYNC:
+      result = engine.fsync();
+      break;
+    case OP.OPENDIR:
+      result = engine.opendir(path, tabId);
+      break;
+    case OP.MKDTEMP:
+      result = engine.mkdtemp(path);
+      break;
+    default:
+      result = { status: 7 };
+  }
+  const responseData = result.data instanceof Uint8Array ? result.data : void 0;
+  return encodeResponse(result.status, responseData);
+}
+function notifyOPFSSync(op, path, data, newPath) {
+  if (!opfsSyncPort) return;
+  const msg = { op, path, ts: Date.now() };
+  const transfers = [];
+  if (op === "write" && data) {
+    const copy = data.slice().buffer;
+    msg.data = copy;
+    transfers.push(copy);
+  }
+  if (op === "rename" && newPath) {
+    msg.newPath = newPath;
+  }
+  opfsSyncPort.postMessage(msg, transfers);
+}
+function setupClientPort(tabId, port) {
+  ports.set(tabId, port);
+  port.onmessage = (e) => {
+    const { buffer, id } = e.data;
+    if (buffer instanceof ArrayBuffer) {
+      const response = handleRequest(tabId, buffer);
+      port.postMessage({ id, buffer: response }, [response]);
+    }
+  };
+  port.start();
+}
+function onTabLost(tabId) {
+  engine.cleanupTab(tabId);
+  const port = ports.get(tabId);
+  if (port) {
+    port.close();
+    ports.delete(tabId);
+  }
+}
+async function init(initData) {
+  config = initData;
+  let rootDir = await navigator.storage.getDirectory();
+  if (config.root && config.root !== "/") {
+    const segments = config.root.split("/").filter(Boolean);
+    for (const segment of segments) {
+      rootDir = await rootDir.getDirectoryHandle(segment, { create: true });
+    }
+  }
+  const vfsFileHandle = await rootDir.getFileHandle(".vfs.bin", { create: true });
+  const vfsHandle = await vfsFileHandle.createSyncAccessHandle();
+  engine.init(vfsHandle, {
+    uid: config.uid,
+    gid: config.gid,
+    umask: config.umask,
+    strictPermissions: config.strictPermissions
+  });
+}
+self.onmessage = async (e) => {
+  const msg = e.data;
+  if (msg.type === "init") {
+    await init(msg.config);
+    self.postMessage({ type: "ready" });
+    return;
+  }
+  if (msg.type === "port") {
+    setupClientPort(msg.tabId, msg.port);
+    return;
+  }
+  if (msg.type === "tab-lost") {
+    onTabLost(msg.tabId);
+    return;
+  }
+  if (msg.type === "opfs-sync-port") {
+    opfsSyncPort = msg.port;
+    opfsSyncPort.start();
+    return;
+  }
+  if (msg.buffer instanceof ArrayBuffer) {
+    const tabId = msg.tabId || "local";
+    const response = handleRequest(tabId, msg.buffer);
+    self.postMessage(
+      { id: msg.id, buffer: response },
+      [response]
+    );
+  }
+};
+//# sourceMappingURL=server.worker.js.map