@volter/tabnode 0.2.14-volter.88 → 0.3.1

package/dist/runtime.d.ts

@@ -141,4 +141,3 @@ export declare function execute(code: string, vfs: VirtualFS, options?: RuntimeO
 };
 export type { IRuntime, IExecuteResult, IRuntimeOptions } from './runtime-interface';
 export default Runtime;
-//# sourceMappingURL=runtime.d.ts.map

package/dist/server-bridge.d.ts

@@ -144,4 +144,3 @@ export declare function getServerBridge(options?: BridgeOptions): ServerBridge;
  */
 export declare function resetServerBridge(): void;
 export default ServerBridge;
-//# sourceMappingURL=server-bridge.d.ts.map

package/dist/shims/async_hooks.d.ts

@@ -47,4 +47,3 @@ declare const _default: {
     triggerAsyncId: typeof triggerAsyncId;
 };
 export default _default;
-//# sourceMappingURL=async_hooks.d.ts.map

package/dist/shims/child_process.d.ts

@@ -101,4 +101,3 @@ declare const _default: {
     sendStdin: typeof sendStdin;
 };
 export default _default;
-//# sourceMappingURL=child_process.d.ts.map

package/dist/shims/cluster.d.ts

@@ -49,4 +49,3 @@ declare const _default: {
     removeListener: (event: string, listener: (...args: any[]) => void) => unknown;
 };
 export default _default;
-//# sourceMappingURL=cluster.d.ts.map

package/dist/shims/command-line.d.ts

@@ -40,4 +40,3 @@ export declare function setProgramResolver(resolve: (file: string, cwd?: string)
  * program and its words, each quoted.
  */
 export declare function __substrateLineFor(file: string, argv: string[], cwd?: string): string;
-//# sourceMappingURL=command-line.d.ts.map

package/dist/shims/constants.d.ts

@@ -219,4 +219,3 @@ type ConstantsBinding = {
  */
 export declare function constantsBinding(): ConstantsBinding;
 export {};
-//# sourceMappingURL=constants.d.ts.map

package/dist/shims/crypto-constants.d.ts

@@ -9,4 +9,3 @@ export declare const cryptoConstants: {
     RSA_PKCS1_OAEP_PADDING: number;
     RSA_PKCS1_PSS_PADDING: number;
 };
-//# sourceMappingURL=crypto-constants.d.ts.map

package/dist/shims/crypto.d.ts

@@ -141,4 +141,3 @@ declare const _default: {
     createPrivateKey: typeof createPrivateKey;
 };
 export default _default;
-//# sourceMappingURL=crypto.d.ts.map

package/dist/shims/dgram.d.ts

@@ -31,4 +31,3 @@ declare const _default: {
     createSocket: typeof createSocket;
 };
 export default _default;
-//# sourceMappingURL=dgram.d.ts.map

package/dist/shims/dns.d.ts

@@ -88,4 +88,3 @@ declare const _default: {
     ALL: number;
 };
 export default _default;
-//# sourceMappingURL=dns.d.ts.map

package/dist/shims/domain.d.ts

@@ -22,4 +22,3 @@ declare const _default: {
     active: null;
 };
 export default _default;
-//# sourceMappingURL=domain.d.ts.map

package/dist/shims/esbuild.d.ts

@@ -202,4 +202,3 @@ declare const _default: {
     analyzeMetafile: typeof analyzeMetafile;
 };
 export default _default;
-//# sourceMappingURL=esbuild.d.ts.map

package/dist/shims/fs.d.ts

@@ -22,4 +22,3 @@ export type FsShim = typeof import('node:fs');
  */
 export declare function createFsShim(tree: VirtualFS, _getCwd?: () => string): FsShim;
 export default createFsShim;
-//# sourceMappingURL=fs.d.ts.map

package/dist/shims/http2.d.ts

@@ -78,4 +78,3 @@ declare const _default: {
     sensitiveHeaders: symbol;
 };
 export default _default;
-//# sourceMappingURL=http2.d.ts.map

package/dist/shims/inspector.d.ts

@@ -22,4 +22,3 @@ declare const _default: {
     console: Console;
 };
 export default _default;
-//# sourceMappingURL=inspector.d.ts.map

package/dist/shims/module.d.ts

@@ -19,4 +19,3 @@ export declare const Module: {
     syncBuiltinESMExports: typeof syncBuiltinESMExports;
 };
 export default Module;
-//# sourceMappingURL=module.d.ts.map

package/dist/shims/os.d.ts

@@ -156,4 +156,3 @@ declare const _default: {
     devNull: string;
 };
 export default _default;
-//# sourceMappingURL=os.d.ts.map

package/dist/shims/path.d.ts

@@ -49,4 +49,3 @@ export declare const format: (pathObject: FormatInputPathObject) => string;
 export declare const toNamespacedPath: <T>(path: T) => T;
 export declare const matchesGlob: (path: string, pattern: string) => boolean;
 export default nodePath;
-//# sourceMappingURL=path.d.ts.map

package/dist/shims/perf_hooks.d.ts

@@ -47,4 +47,3 @@ declare const _default: {
     monitorEventLoopDelay: typeof monitorEventLoopDelay;
 };
 export default _default;
-//# sourceMappingURL=perf_hooks.d.ts.map

package/dist/shims/process.d.ts

@@ -223,4 +223,3 @@ export declare function createProcess(options?: {
     tty?: boolean;
 }): Process;
 export {};
-//# sourceMappingURL=process.d.ts.map

package/dist/shims/rollup.d.ts

@@ -68,4 +68,3 @@ declare const _default: {
     parseAstAsync: typeof parseAstAsync;
 };
 export default _default;
-//# sourceMappingURL=rollup.d.ts.map

package/dist/shims/string_decoder.d.ts

@@ -38,4 +38,3 @@ declare const _default: {
     StringDecoder: StringDecoderConstructor;
 };
 export default _default;
-//# sourceMappingURL=string_decoder.d.ts.map

package/dist/shims/sync-child.d.ts

@@ -61,4 +61,3 @@ export declare function warmSyncChild(): void;
  * result Node gives for a child it could not start.
  */
 export declare function runSyncChild(request: SyncChildRequest): SyncChildResult;
-//# sourceMappingURL=sync-child.d.ts.map

package/dist/shims/tls.d.ts

@@ -50,4 +50,3 @@ declare const _default: {
     rootCertificates: string[];
 };
 export default _default;
-//# sourceMappingURL=tls.d.ts.map

package/dist/shims/url.d.ts

@@ -81,4 +81,3 @@ declare const _default: {
     pathToFileURL: typeof pathToFileURL;
 };
 export default _default;
-//# sourceMappingURL=url.d.ts.map

package/dist/shims/v8.d.ts

@@ -70,4 +70,3 @@ declare const _default: {
     promiseHooks: typeof promiseHooks;
 };
 export default _default;
-//# sourceMappingURL=v8.d.ts.map

package/dist/shims/vfs-adapter.d.ts

@@ -123,4 +123,3 @@ export declare class VirtualFSAdapter implements IFileSystem {
     utimes(path: string, _atime: Date, _mtime: Date): Promise<void>;
 }
 export {};
-//# sourceMappingURL=vfs-adapter.d.ts.map

package/dist/shims/vm.d.ts

@@ -49,4 +49,3 @@ declare const _default: {
     SyntheticModule: typeof SyntheticModule;
 };
 export default _default;
-//# sourceMappingURL=vm.d.ts.map

package/dist/shims/wasi.d.ts

@@ -75,4 +75,3 @@ export interface WasiModule {
     };
 }
 export declare function createWasiModule(fs: WasiHostFs, process: WasiHostProcess): WasiModule;
-//# sourceMappingURL=wasi.d.ts.map

package/dist/shims/worker_threads.d.ts

@@ -63,4 +63,3 @@ declare const _default: {
     setEnvironmentData: typeof setEnvironmentData;
 };
 export default _default;
-//# sourceMappingURL=worker_threads.d.ts.map

package/dist/shims/zlib-constants.d.ts

@@ -63,4 +63,3 @@ export declare const zlibConstants: {
     BROTLI_MIN_INPUT_BLOCK_BITS: number;
     BROTLI_MAX_INPUT_BLOCK_BITS: number;
 };
-//# sourceMappingURL=zlib-constants.d.ts.map

package/dist/shims/zlib.d.ts

@@ -99,4 +99,3 @@ declare const _default: {
     };
 };
 export default _default;
-//# sourceMappingURL=zlib.d.ts.map

package/dist/transform.d.ts

@@ -21,4 +21,3 @@ export declare function transformFile(code: string, filename: string): Promise<s
  * Transform all ESM files in a package directory to CJS
  */
 export declare function transformPackage(vfs: VirtualFS, pkgPath: string, onProgress?: (msg: string) => void): Promise<number>;
-//# sourceMappingURL=transform.d.ts.map

package/dist/types/package-json.d.ts

@@ -15,4 +15,3 @@ export interface PackageJson {
     scripts?: Record<string, string>;
     [key: string]: unknown;
 }
-//# sourceMappingURL=package-json.d.ts.map

package/dist/utils/binary-encoding.d.ts

@@ -10,4 +10,3 @@ export declare function base64ToUint8(base64: string): Uint8Array;
 export declare function uint8ToHex(bytes: Uint8Array): string;
 /** Convert Uint8Array to binary (latin1) string */
 export declare function uint8ToBinaryString(bytes: Uint8Array): string;
-//# sourceMappingURL=binary-encoding.d.ts.map

package/dist/utils/glob.d.ts

@@ -16,4 +16,3 @@
  * source system keeps its own semantics.
  */
 export declare function globToRegExp(glob: string, nocase?: boolean): RegExp;
-//# sourceMappingURL=glob.d.ts.map

package/dist/utils/hash.d.ts

@@ -3,4 +3,3 @@
  * Uses djb2-style hashing for fast string hashing.
  */
 export declare function simpleHash(str: string): string;
-//# sourceMappingURL=hash.d.ts.map

package/dist/virtual-fs.d.ts

@@ -256,4 +256,3 @@ export declare class VirtualFS {
     };
 }
 export {};
-//# sourceMappingURL=virtual-fs.d.ts.map

package/dist/vite-plugin.d.ts

@@ -33,4 +33,3 @@ export interface TabnodePluginOptions {
  */
 export declare function tabnodePlugin(options?: TabnodePluginOptions): Plugin;
 export default tabnodePlugin;
-//# sourceMappingURL=vite-plugin.d.ts.map

package/dist/vite-plugin.mjs

@@ -28,4 +28,3 @@ export {
   tabnodePlugin as default,
   tabnodePlugin
 };
-//# sourceMappingURL=vite-plugin.mjs.map

package/dist/worker/runtime-worker.d.ts

@@ -5,4 +5,3 @@
  * and runs them in isolation, preventing UI blocking.
  */
 export {};
-//# sourceMappingURL=runtime-worker.d.ts.map

package/dist/worker-runtime.d.ts

@@ -47,4 +47,3 @@ export declare class WorkerRuntime implements IRuntime {
      */
     terminate(): void;
 }
-//# sourceMappingURL=worker-runtime.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/tabnode",
-  "version": "0.2.14-volter.88",
+  "version": "0.3.1",
   "description": "Node's own library, in a browser tab.",
   "type": "module",
   "license": "MIT",
@@ -14,7 +14,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/volter-ai/tabnode.git"
+    "url": "git+https://github.com/volter-ai/tabnode.git"
   },
   "homepage": "https://github.com/volter-ai/tabnode#readme",
   "bugs": {
@@ -22,31 +22,17 @@
   },
   "author": "Aaron <aaron@volter.ai>",
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=20.19.0"
   },
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.mjs"
-      },
-      "require": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.cjs"
-      }
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.mjs"
     },
     "./vite": {
-      "import": {
-        "types": "./dist/vite-plugin.d.ts",
-        "default": "./dist/vite-plugin.mjs"
-      },
-      "require": {
-        "types": "./dist/vite-plugin.d.ts",
-        "default": "./dist/vite-plugin.cjs"
-      }
+      "types": "./dist/vite-plugin.d.ts",
+      "default": "./dist/vite-plugin.mjs"
     }
   },
   "files": [
@@ -59,9 +45,8 @@
     "access": "public"
   },
   "scripts": {
-    "build:lib": "vite build --config vite.lib.config.js && (tsc -p tsconfig.build.json || true)",
-    "build:types": "tsc --project tsconfig.build.json",
-    "build:publish": "npm run build:lib && npm run build:types",
+    "build:lib": "vite build --config vite.lib.config.js && tsc -p tsconfig.build.json",
+    "docs:api": "typedoc",
     "test": "vitest run",
     "type-check": "tsc --noEmit"
   },
@@ -81,6 +66,8 @@
   "devDependencies": {
     "@types/node": "^25.0.10",
     "@types/pako": "^2.0.4",
+    "typedoc": "^0.28.20",
+    "typedoc-plugin-markdown": "^4.13.1",
     "typescript": "^5.9.3",
     "vite": "^5.4.0",
     "vitest": "^4.0.18"

package/src/node-lib/binding/fs.ts

@@ -469,6 +469,9 @@ export const fsBinding = {
       if ((flags & bits.excl) !== 0 && (flags & bits.create) !== 0 && exists) throw createNodeError('EEXIST', 'open', name);
       if (!exists) {
         if ((flags & bits.create) === 0) throw createNodeError('ENOENT', 'open', name);
+        // VirtualFS writes create parents for image loading; open(2) does not.
+        const parent = name.slice(0, name.lastIndexOf('/')) || '/';
+        if (!tree.statSync(parent).isDirectory()) throw createNodeError('ENOTDIR', 'open', name);
         tree.writeFileSync(name, '');
       } else if ((flags & bits.truncate) !== 0) {
         tree.writeFileSync(name, '');
@@ -481,13 +484,14 @@ export const fsBinding = {
   },
 
   close(fd: number, req?: FSReq): undefined {
-    return answer(req, () => { openFiles.delete(fd); return undefined; });
+    return answer(req, () => { fileFor(fd); openFiles.delete(fd); return undefined; });
   },
 
   // ---- reading ------------------------------------------------------------
   read(fd: number, buffer: Uint8Array, offset: number, length: number, position: number, req?: FSReq): number | undefined {
     return answer(req, () => {
       const file = fileFor(fd);
+      if ((file.flags & 3) === 1) throw createNodeError('EBADF', 'read', file.path);
       if (file.cached === undefined) file.cached = file.tree.readFileSync(file.path) as Uint8Array;
       const bytes = file.cached;
       const from = position === null || position === undefined || position < 0 ? file.position : position;
@@ -512,18 +516,27 @@ export const fsBinding = {
   },
 
   /** Node's fast path for `readFile` with an encoding it can decode itself. */
-  readFileUtf8(path: unknown, _flags: number): string {
-    return vfs().readFileSync(asPath(path), 'utf8') as string;
+  readFileUtf8(path: unknown, flags: number): string {
+    const owned = typeof path !== 'number';
+    const fd = owned ? fsBinding.open(path, flags, 0o666) as number : path as number;
+    try {
+      const file = fileFor(fd);
+      const bytes = new Uint8Array(file.tree.statSync(file.path).size);
+      const length = fsBinding.read(fd, bytes, 0, bytes.length, -1) as number;
+      return new TextDecoder().decode(bytes.subarray(0, length));
+    } finally { if (owned) fsBinding.close(fd); }
   },
 
   // ---- writing ------------------------------------------------------------
   writeBuffer(fd: number, buffer: Uint8Array, offset: number, length: number, position: number | null, req?: FSReq): number | undefined {
     return answer(req, () => {
       const file = fileFor(fd);
+      if ((file.flags & 3) === 0) throw createNodeError('EBADF', 'write', file.path);
       const tree = file.tree;
       const slice = buffer.subarray(offset, offset + length);
       const existing = file.cached ?? (tree.existsSync(file.path) ? tree.readFileSync(file.path) as Uint8Array : new Uint8Array(0));
-      const at = position === null || position === undefined || position < 0 ? file.position : position;
+      const at = (file.flags & flagBits().append) !== 0 ? existing.length
+        : position === null || position === undefined || position < 0 ? file.position : position;
       const size = Math.max(existing.length, at + slice.length);
       const next = new Uint8Array(size);
       next.set(existing, 0);
@@ -553,15 +566,13 @@ export const fsBinding = {
     return fsBinding.writeBuffer(fd, bytes, 0, bytes.length, position ?? null, req);
   },
 
-  writeFileUtf8(path: unknown, data: string, flags: number, _mode: number): undefined {
-    const tree = vfs();
-    const name = asPath(path);
-    if ((flags & flagBits().append) !== 0 && tree.existsSync(name)) {
-      const existing = tree.readFileSync(name, 'utf8') as string;
-      tree.writeFileSync(name, existing + data);
-      return undefined;
-    }
-    tree.writeFileSync(name, data);
+  writeFileUtf8(path: unknown, data: string, flags: number, mode: number): undefined {
+    // Node's UTF-8 fast path accepts a path OR an already-open descriptor.
+    // Reuse open/write so flags, offsets and errors match the buffer path.
+    const owned = typeof path !== 'number';
+    const fd = owned ? fsBinding.open(path, flags, mode) as number : path as number;
+    try { fsBinding.writeString(fd, data, null, 'utf8'); }
+    finally { if (owned) fsBinding.close(fd); }
     return undefined;
   },
 
@@ -843,6 +854,7 @@ export const fsBinding = {
   ftruncate(fd: number, length: number, req?: FSReq): undefined {
     return answer(req, () => {
       const file = fileFor(fd);
+      if ((file.flags & 3) === 0) throw createNodeError('EBADF', 'ftruncate', file.path);
       const tree = file.tree;
       const bytes = file.cached ?? (tree.readFileSync(file.path) as Uint8Array);
       const next = new Uint8Array(length);

package/src/node-lib/binding/zlib.ts

@@ -25,7 +25,7 @@
  * `http`, and there is none to vendor: no zlib wasm exists anywhere on this
  * box, npm's `zlib-wasm` is one maintainer, two versions, and depends on pako
  * itself, and compiling `deps/zlib` here would mean running a C toolchain,
- * which this product does not do. The row in FORK.md says the same.
+ * which this product does not do. The row in BUILTINS.md says the same.
  */
 import { zstream, inflateModule, deflateModule, zlibConstants } from './zlib-pako';
 

package/src/node-lib/sources.ts

@@ -101,7 +101,7 @@ import INTERNAL_UTIL_COLORS from './internal/util/colors.js?raw';
 import INTERNAL_FIXED_QUEUE from './internal/fixed_queue.js?raw';
 import INTERNAL_EVENTS_SYMBOLS from './internal/events/symbols.js?raw';
 
-/** The Node the vendored files come from, reported in `FORK.md`'s table. */
+/** The Node the vendored files come from, reported in `BUILTINS.md`. */
 export const NODE_LIB_VERSION = 'v22.18.0';
 
 export const NODE_LIB_SOURCES: Record<string, string> = {

package/src/virtual-fs.ts

@@ -45,6 +45,17 @@ export interface FSNode {
   atime?: number;
 }
 
+// Identity belongs to the node, so writes and renames preserve it while an
+// unlink followed by recreation receives a different inode. Weak keys do not
+// retain deleted trees, and snapshots receive new identities when restored.
+const nodeInodes = new WeakMap<FSNode, number>();
+let nextInode = 1;
+function inodeFor(node: FSNode): number {
+  let inode = nodeInodes.get(node);
+  if (inode === undefined) { inode = nextInode++; nodeInodes.set(node, inode); }
+  return inode;
+}
+
 // Simple EventEmitter for VFS change notifications
 type VFSChangeListener = (path: string, content: string) => void;
 type VFSDeleteListener = (path: string) => void;
@@ -491,7 +502,7 @@ export class VirtualFS {
       uid: 1000,
       gid: 1000,
       dev: 0,
-      ino: 0,
+      ino: inodeFor(node),
       rdev: 0,
       blksize: 4096,
       blocks: Math.ceil(size / 512),
@@ -531,7 +542,7 @@ export class VirtualFS {
       uid: 1000,
       gid: 1000,
       dev: 0,
-      ino: 0,
+      ino: inodeFor(node),
       rdev: 0,
       blksize: 4096,
       blocks: 0