@seanhogg/builderforce-webcontainers-core 2026.10.2 → 2026.10.4

package/dist/system/terminal.js

@@ -0,0 +1,127 @@
+/**
+ * What a kernel's TTY layer does between xterm.js and a program:
+ *
+ * - InputQueue: stdin as a buffered stream of string chunks (data that arrives
+ *   before the program subscribes is kept, not dropped).
+ * - LineDiscipline: "cooked" mode — echo, backspace, Ctrl-U, Enter delivers the
+ *   line, Ctrl-C raises SIGINT, Ctrl-D is end-of-file. A program that calls
+ *   `setRawMode(true)` (the shell, prompts libraries) gets keystrokes untouched.
+ * - toTerminal: `\n` → `\r\n` on output (the TTY's ONLCR), since xterm.js
+ *   only moves to column 0 on `\r`.
+ */
+export class InputQueue {
+    buffered = [];
+    listeners = new Set();
+    ended = false;
+    draining = false;
+    push(chunk) {
+        if (this.ended)
+            return;
+        if (chunk === null)
+            this.ended = true;
+        this.buffered.push(chunk);
+        this.drain();
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        this.drain();
+        return () => this.listeners.delete(listener);
+    }
+    /**
+     * Deliver on a microtask: a subscriber has always stored its unsubscribe
+     * function by then, and chunks stay buffered until someone is actually
+     * listening — one that leaves early does not take data with it.
+     */
+    drain() {
+        if (this.draining || !this.listeners.size || !this.buffered.length)
+            return;
+        this.draining = true;
+        queueMicrotask(() => {
+            this.draining = false;
+            while (this.buffered.length && this.listeners.size) {
+                const chunk = this.buffered.shift();
+                for (const listener of [...this.listeners])
+                    listener(chunk);
+            }
+        });
+    }
+    /** Everything until end-of-file. */
+    readAll() {
+        return new Promise((resolve) => {
+            let text = '';
+            const stop = this.subscribe((chunk) => {
+                if (chunk === null) {
+                    stop();
+                    resolve(text);
+                }
+                else
+                    text += chunk;
+            });
+        });
+    }
+    get isEnded() {
+        return this.ended;
+    }
+}
+export function toTerminal(text) {
+    return text.replace(/\r?\n/g, '\r\n');
+}
+export class LineDiscipline {
+    options;
+    raw = false;
+    line = '';
+    constructor(options) {
+        this.options = options;
+    }
+    input(data) {
+        if (this.raw) {
+            this.options.deliver(data);
+            return;
+        }
+        // Arrow keys and other escape sequences have no meaning in cooked mode.
+        const text = data.replace(/\x1b\[[0-9;]*[A-Za-z~]|\x1bO[A-Za-z]/g, '');
+        for (const ch of text) {
+            switch (ch) {
+                case '\r':
+                case '\n':
+                    this.options.echo('\r\n');
+                    this.options.deliver(this.line + '\n');
+                    this.line = '';
+                    break;
+                case '\x7f':
+                case '\b':
+                    if (this.line) {
+                        this.line = [...this.line].slice(0, -1).join('');
+                        this.options.echo('\b \b');
+                    }
+                    break;
+                case '\x03':
+                    this.options.echo('^C\r\n');
+                    this.line = '';
+                    this.options.signal('SIGINT');
+                    break;
+                case '\x1c':
+                    this.options.signal('SIGQUIT');
+                    break;
+                case '\x04':
+                    if (this.line) {
+                        this.options.deliver(this.line);
+                        this.line = '';
+                    }
+                    else
+                        this.options.deliver(null);
+                    break;
+                case '\x15':
+                    this.options.echo('\b \b'.repeat([...this.line].length));
+                    this.line = '';
+                    break;
+                default:
+                    if (ch >= ' ' || ch === '\t') {
+                        this.line += ch;
+                        this.options.echo(ch);
+                    }
+            }
+        }
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/dist/system/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../src/system/terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,OAAO,UAAU;IACJ,QAAQ,GAAyB,EAAE,CAAC;IACpC,SAAS,GAAG,IAAI,GAAG,EAAkC,CAAC;IAC/D,KAAK,GAAG,KAAK,CAAC;IAEd,QAAQ,GAAG,KAAK,CAAC;IAEzB,IAAI,CAAC,KAAoB;QACvB,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,IAAI,KAAK,KAAK,IAAI;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACtC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,SAAS,CAAC,QAAwC;QAChD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACK,KAAK;QACX,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAO;QAC3E,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,cAAc,CAAC,GAAG,EAAE;YAClB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;gBACnD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAG,CAAC;gBACrC,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;oBAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,oCAAoC;IACpC,OAAO;QACL,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,IAAI,GAAG,EAAE,CAAC;YACd,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;gBACpC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACnB,IAAI,EAAE,CAAC;oBACP,OAAO,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC;;oBAAM,IAAI,IAAI,KAAK,CAAC;YACvB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAWD,MAAM,OAAO,cAAc;IAII;IAH7B,GAAG,GAAG,KAAK,CAAC;IACJ,IAAI,GAAG,EAAE,CAAC;IAElB,YAA6B,OAA8B;QAA9B,YAAO,GAAP,OAAO,CAAuB;IAAG,CAAC;IAE/D,KAAK,CAAC,IAAY;QAChB,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,wEAAwE;QACxE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,uCAAuC,EAAE,EAAE,CAAC,CAAC;QACvE,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;YACtB,QAAQ,EAAE,EAAE,CAAC;gBACX,KAAK,IAAI,CAAC;gBACV,KAAK,IAAI;oBACP,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAC1B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;oBACvC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;oBACf,MAAM;gBACR,KAAK,MAAM,CAAC;gBACZ,KAAK,IAAI;oBACP,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;wBACd,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBACjD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBAC7B,CAAC;oBACD,MAAM;gBACR,KAAK,MAAM;oBACT,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC5B,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;oBACf,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBAC9B,MAAM;gBACR,KAAK,MAAM;oBACT,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;oBAC/B,MAAM;gBACR,KAAK,MAAM;oBACT,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;wBACd,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBAChC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;oBACjB,CAAC;;wBAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAClC,MAAM;gBACR,KAAK,MAAM;oBACT,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;oBACzD,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;oBACf,MAAM;gBACR;oBACE,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;wBAC7B,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;wBAChB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACxB,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/system/types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * The contract between programs (node, the shell, npm, coreutils) and whatever
+ * hosts them. Programs only ever see these ports, so the same program code runs
+ * in-process under the core `Kernel` (Node tests) and one-per-Web-Worker in the
+ * browser runtime, where `spawn` and `listen` are relayed to the page.
+ */
+import type { VirtualFileSystem } from '../vfs.js';
+import type { PackageCache } from '../installer/registry.js';
+export interface TerminalPort {
+    cols: number;
+    rows: number;
+    onResize(listener: (cols: number, rows: number) => void): () => void;
+    /** Raw mode: the program handles keystrokes itself (no line editing, no echo). */
+    setRawMode(raw: boolean): void;
+}
+export interface ProgramIO {
+    stdout(chunk: string | Uint8Array): void;
+    stderr(chunk: string | Uint8Array): void;
+    /** Stdin chunks as they arrive; `null` is end-of-file. Buffered until the first subscriber. */
+    onStdin(listener: (chunk: string | null) => void): () => void;
+    /** Present when attached to a terminal (xterm.js). */
+    terminal?: TerminalPort;
+}
+export interface SpawnOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    /** Attach to a terminal of this size (`isTTY`, line discipline, `\r\n` output). */
+    terminal?: {
+        cols: number;
+        rows: number;
+    };
+}
+/** A child as its parent sees it (separate stdout/stderr, unlike the public API). */
+export interface ChildHandle {
+    readonly pid: number;
+    onStdout(listener: (chunk: string) => void): () => void;
+    onStderr(listener: (chunk: string) => void): () => void;
+    write(data: string): void;
+    closeStdin(): void;
+    kill(signal?: string): void;
+    resize?(cols: number, rows: number): void;
+    readonly exit: Promise<number>;
+}
+export interface HttpRequestData {
+    method: string;
+    /** Path and query, as the server sees it (`/api?x=1`). */
+    url: string;
+    headers: Record<string, string>;
+    body: Uint8Array | null;
+}
+export interface HttpResponseData {
+    status: number;
+    statusText?: string;
+    headers: Record<string, string | string[]>;
+    body: Uint8Array;
+}
+export type HttpHandler = (request: HttpRequestData) => Promise<HttpResponseData>;
+export interface System {
+    fs: VirtualFileSystem;
+    /** Outbound network (registry, `http.request`, `fetch`). */
+    fetch(input: string, init?: RequestInit): Promise<Response>;
+    spawn(command: string, args: string[], options?: SpawnOptions): ChildHandle;
+    /** Register a virtual server; throws `EADDRINUSE`. Port 0 picks a free one. Returns the port and an unlisten. */
+    listen(port: number, handler: HttpHandler): {
+        port: number;
+        close(): void;
+    };
+    /** Send a request to a virtual server in this runtime (`http.get('http://localhost:3000')`); undefined when nothing listens. */
+    loopback(port: number, request: HttpRequestData): Promise<HttpResponseData | undefined>;
+    /** Where a browser reaches a server on `port` (the preview URL), if known. */
+    serverUrl(port: number): string | undefined;
+    /** Tell the host a server is ready (`server-ready`); used by the dev-server handoff. */
+    announceServer(port: number, url: string): void;
+    /** The in-browser dev server's preview URL, for `vite`/`react-scripts start` handoff. */
+    previewUrl?: string;
+    /**
+     * This program has the JS realm to itself (one process per Web Worker): node
+     * may install `process`, `Buffer`, timers on `globalThis`, and the host routes
+     * the realm's uncaught errors to it through `trapUncaught`.
+     */
+    ownsRealm?: boolean;
+    /** Register for the realm's uncaught errors and unhandled rejections. */
+    trapUncaught?(handler: (error: unknown) => void): () => void;
+    /** npm registry and cache for `npm install`. */
+    registry?: string;
+    packageCache?: PackageCache;
+}
+export interface ProgramContext {
+    /** Arguments after the program name. */
+    args: string[];
+    cwd: string;
+    env: Record<string, string>;
+    io: ProgramIO;
+    system: System;
+    /** Aborted by kill(): in-process programs stop at their next await. */
+    signal: AbortSignal;
+}
+/** A program resolves with its exit code. */
+export type Program = (ctx: ProgramContext) => Promise<number>;
+//# sourceMappingURL=types.d.ts.map

package/dist/system/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/system/types.ts"],"names":[],"mappings":"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"}

package/dist/system/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/system/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/system/types.ts"],"names":[],"mappings":""}

package/dist/vfs.d.ts

@@ -12,15 +12,21 @@ export interface FileSystemTree {
 /** A flat `{ 'src/main.tsx': '...' }` map, the other shape callers commonly hold. */
 export type FlatFiles = Record<string, FileContent>;
 export interface FsChange {
-    type: 'write' | 'remove';
+    /** `mkdir` is an explicitly created (possibly empty) directory. */
+    type: 'write' | 'remove' | 'mkdir';
     path: string;
     /** For a write: the file did not exist before. A new file can change how imports resolve. */
     created?: boolean;
 }
 /**
- * An in-memory file system. Files only — a directory exists while it contains a
- * file, which keeps the store a single map and makes "is this a directory?" a
- * prefix check rather than a second structure to keep consistent.
+ * An in-memory file system. Files are the store; a directory exists while it
+ * contains something, or because it was created explicitly with `mkdir` (shells
+ * and Node programs create empty directories, a preview never needs to).
+ *
+ * A directory index (dir → child names) is maintained alongside the files, so
+ * `isDirectory`/`readdir` stay O(1)/O(children) even with a populated
+ * `node_modules` of tens of thousands of files — module resolution probes those
+ * constantly.
  *
  * Every write bumps a per-file version, so a transform cache can key on
  * (path, version) instead of hashing contents.
@@ -28,6 +34,11 @@ export interface FsChange {
 export declare class VirtualFileSystem {
     private readonly files;
     private readonly versions;
+    private readonly mtimes;
+    /** dir → names of its direct children (files and directories). */
+    private readonly children;
+    /** Directories created with `mkdir`: they outlive their last file. */
+    private readonly explicit;
     private readonly listeners;
     private clock;
     writeFile(path: string, contents: FileContent): void;
@@ -36,14 +47,20 @@ export declare class VirtualFileSystem {
     isFile(path: string): boolean;
     isDirectory(path: string): boolean;
     exists(path: string): boolean;
+    /** Create a directory (and its parents). A no-op when it already exists. */
+    mkdir(path: string): void;
     /** Direct children of a directory (files and sub-directories), sorted. */
     readdir(path: string): string[];
     /** Every file path, sorted. */
     list(): string[];
+    /** Directories created explicitly with `mkdir` — what `list()` cannot reproduce. */
+    explicitDirectories(): string[];
     /** Remove a file, or a directory and everything under it. */
     rm(path: string): void;
     /** The file's version (bumped on every write), or undefined when absent. */
     version(path: string): number | undefined;
+    /** When the file was last written (epoch ms), or undefined when absent. */
+    mtime(path: string): number | undefined;
     /**
      * Write many files at once. Takes either the nested WebContainer tree or a flat
      * path→contents map — or a mix, since each entry is judged on its own.
@@ -52,6 +69,13 @@ export declare class VirtualFileSystem {
     /** Flat snapshot keyed without the leading slash (`src/main.tsx`). */
     toFlat(): FlatFiles;
     watch(listener: (change: FsChange) => void): () => void;
+    private removeFile;
+    /** Register `key` under its parent, creating implicit ancestors as needed. */
+    private link;
+    private ensureDir;
+    /** Detach `key` from its parent, pruning implicit ancestors left empty. */
+    private unlink;
+    private unlinkDir;
     private emit;
 }
 //# sourceMappingURL=vfs.d.ts.map

package/dist/vfs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vfs.d.ts","sourceRoot":"","sources":["../src/vfs.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC;AAE9C,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE;YAAE,QAAQ,EAAE,WAAW,CAAA;SAAE,CAAA;KAAE,GAAG;QAAE,SAAS,EAAE,cAAc,CAAA;KAAE,CAAC;CACrF;AAED,qFAAqF;AACrF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEpD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyC;IACnE,OAAO,CAAC,KAAK,CAAK;IAElB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI;IAQpD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI/C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAM1C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI7B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQlC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI7B,0EAA0E;IAC1E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAa/B,+BAA+B;IAC/B,IAAI,IAAI,MAAM,EAAE;IAIhB,6DAA6D;IAC7D,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAYtB,4EAA4E;IAC5E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIzC;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,EAAE,EAAE,SAAM,GAAG,IAAI;IASxD,sEAAsE;IACtE,MAAM,IAAI,SAAS;IAMnB,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,IAAI;IAKvD,OAAO,CAAC,IAAI;CAGb"}
+{"version":3,"file":"vfs.d.ts","sourceRoot":"","sources":["../src/vfs.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC;AAE9C,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE;YAAE,QAAQ,EAAE,WAAW,CAAA;SAAE,CAAA;KAAE,GAAG;QAAE,SAAS,EAAE,cAAc,CAAA;KAAE,CAAC;CACrF;AAED,qFAAqF;AACrF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEpD,MAAM,WAAW,QAAQ;IACvB,mEAAmE;IACnE,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,kEAAkE;IAClE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoD;IAC7E,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyC;IACnE,OAAO,CAAC,KAAK,CAAK;IAElB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI;IAWpD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI/C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAM1C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI7B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI7B,4EAA4E;IAC5E,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAWzB,0EAA0E;IAC1E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAI/B,+BAA+B;IAC/B,IAAI,IAAI,MAAM,EAAE;IAIhB,oFAAoF;IACpF,mBAAmB,IAAI,MAAM,EAAE;IAI/B,6DAA6D;IAC7D,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IActB,4EAA4E;IAC5E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIzC,2EAA2E;IAC3E,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIvC;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,EAAE,EAAE,SAAM,GAAG,IAAI;IAYxD,sEAAsE;IACtE,MAAM,IAAI,SAAS;IAMnB,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,IAAI;IAKvD,OAAO,CAAC,UAAU;IAQlB,8EAA8E;IAC9E,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,SAAS;IAOjB,2EAA2E;IAC3E,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,IAAI;CAGb"}

package/dist/vfs.js

@@ -1,9 +1,14 @@
-import { normalizePath, join } from './paths.js';
+import { normalizePath, join, dirname } from './paths.js';
 const decoder = new TextDecoder();
 /**
- * An in-memory file system. Files only — a directory exists while it contains a
- * file, which keeps the store a single map and makes "is this a directory?" a
- * prefix check rather than a second structure to keep consistent.
+ * An in-memory file system. Files are the store; a directory exists while it
+ * contains something, or because it was created explicitly with `mkdir` (shells
+ * and Node programs create empty directories, a preview never needs to).
+ *
+ * A directory index (dir → child names) is maintained alongside the files, so
+ * `isDirectory`/`readdir` stay O(1)/O(children) even with a populated
+ * `node_modules` of tens of thousands of files — module resolution probes those
+ * constantly.
  *
  * Every write bumps a per-file version, so a transform cache can key on
  * (path, version) instead of hashing contents.
@@ -11,13 +16,23 @@ const decoder = new TextDecoder();
 export class VirtualFileSystem {
     files = new Map();
     versions = new Map();
+    mtimes = new Map();
+    /** dir → names of its direct children (files and directories). */
+    children = new Map([['/', new Set()]]);
+    /** Directories created with `mkdir`: they outlive their last file. */
+    explicit = new Set();
     listeners = new Set();
     clock = 0;
     writeFile(path, contents) {
         const key = normalizePath(path);
+        if (key === '/' || this.children.has(key))
+            throw new Error(`EISDIR: illegal operation on a directory, open '${key}'`);
         const created = !this.files.has(key);
+        if (created)
+            this.link(key);
         this.files.set(key, contents);
         this.versions.set(key, ++this.clock);
+        this.mtimes.set(key, Date.now());
         this.emit({ type: 'write', path: key, created });
     }
     readFile(path) {
@@ -33,53 +48,64 @@ export class VirtualFileSystem {
         return this.files.has(normalizePath(path));
     }
     isDirectory(path) {
-        const key = normalizePath(path);
-        if (key === '/')
-            return true;
-        const prefix = key + '/';
-        for (const file of this.files.keys())
-            if (file.startsWith(prefix))
-                return true;
-        return false;
+        return this.children.has(normalizePath(path));
     }
     exists(path) {
         return this.isFile(path) || this.isDirectory(path);
     }
+    /** Create a directory (and its parents). A no-op when it already exists. */
+    mkdir(path) {
+        const key = normalizePath(path);
+        if (this.files.has(key))
+            throw new Error(`EEXIST: file already exists, mkdir '${key}'`);
+        if (key === '/')
+            return;
+        const existed = this.children.has(key);
+        this.explicit.add(key);
+        if (existed)
+            return;
+        this.ensureDir(key);
+        this.emit({ type: 'mkdir', path: key });
+    }
     /** Direct children of a directory (files and sub-directories), sorted. */
     readdir(path) {
-        const key = normalizePath(path);
-        const prefix = key === '/' ? '/' : key + '/';
-        const names = new Set();
-        for (const file of this.files.keys()) {
-            if (!file.startsWith(prefix))
-                continue;
-            const rest = file.slice(prefix.length);
-            const name = rest.split('/')[0];
-            if (name)
-                names.add(name);
-        }
-        return [...names].sort();
+        return [...(this.children.get(normalizePath(path)) ?? [])].sort();
     }
     /** Every file path, sorted. */
     list() {
         return [...this.files.keys()].sort();
     }
+    /** Directories created explicitly with `mkdir` — what `list()` cannot reproduce. */
+    explicitDirectories() {
+        return [...this.explicit].sort();
+    }
     /** Remove a file, or a directory and everything under it. */
     rm(path) {
         const key = normalizePath(path);
-        const prefix = key === '/' ? '/' : key + '/';
-        for (const file of [...this.files.keys()]) {
-            if (file === key || file.startsWith(prefix)) {
-                this.files.delete(file);
-                this.versions.delete(file);
-                this.emit({ type: 'remove', path: file });
-            }
+        if (this.files.has(key)) {
+            this.removeFile(key);
+            return;
         }
+        if (!this.children.has(key))
+            return;
+        for (const name of [...(this.children.get(key) ?? [])])
+            this.rm(key === '/' ? '/' + name : `${key}/${name}`);
+        if (key === '/')
+            return;
+        const wasExplicit = this.explicit.delete(key);
+        if (this.children.has(key))
+            this.unlinkDir(key);
+        if (wasExplicit)
+            this.emit({ type: 'remove', path: key });
     }
     /** The file's version (bumped on every write), or undefined when absent. */
     version(path) {
         return this.versions.get(normalizePath(path));
     }
+    /** When the file was last written (epoch ms), or undefined when absent. */
+    mtime(path) {
+        return this.mtimes.get(normalizePath(path));
+    }
     /**
      * Write many files at once. Takes either the nested WebContainer tree or a flat
      * path→contents map — or a mix, since each entry is judged on its own.
@@ -91,8 +117,10 @@ export class VirtualFileSystem {
                 this.writeFile(path, entry);
             else if ('file' in entry)
                 this.writeFile(path, entry.file.contents);
-            else
+            else {
+                this.mkdir(path);
                 this.mount(entry.directory, path);
+            }
         }
     }
     /** Flat snapshot keyed without the leading slash (`src/main.tsx`). */
@@ -106,6 +134,41 @@ export class VirtualFileSystem {
         this.listeners.add(listener);
         return () => this.listeners.delete(listener);
     }
+    removeFile(key) {
+        this.files.delete(key);
+        this.versions.delete(key);
+        this.mtimes.delete(key);
+        this.unlink(key);
+        this.emit({ type: 'remove', path: key });
+    }
+    /** Register `key` under its parent, creating implicit ancestors as needed. */
+    link(key) {
+        const parent = dirname(key);
+        this.ensureDir(parent);
+        this.children.get(parent).add(key.slice(key.lastIndexOf('/') + 1));
+    }
+    ensureDir(dir) {
+        if (this.children.has(dir))
+            return;
+        if (this.files.has(dir))
+            throw new Error(`ENOTDIR: not a directory, '${dir}'`);
+        this.children.set(dir, new Set());
+        this.link(dir);
+    }
+    /** Detach `key` from its parent, pruning implicit ancestors left empty. */
+    unlink(key) {
+        const parent = dirname(key);
+        const siblings = this.children.get(parent);
+        if (!siblings)
+            return;
+        siblings.delete(key.slice(key.lastIndexOf('/') + 1));
+        if (siblings.size === 0 && parent !== '/' && !this.explicit.has(parent))
+            this.unlinkDir(parent);
+    }
+    unlinkDir(dir) {
+        this.children.delete(dir);
+        this.unlink(dir);
+    }
     emit(change) {
         for (const listener of this.listeners)
             listener(change);

package/dist/vfs.js.map

@@ -1 +1 @@
-{"version":3,"file":"vfs.js","sourceRoot":"","sources":["../src/vfs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vfs.js","sourceRoot":"","sources":["../src/vfs.ts"],"names":[],"mappings":"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"}

package/dist/vueCompiler.d.ts

@@ -0,0 +1,75 @@
+import type { ComponentCompiler } from './components.js';
+/**
+ * Vue single-file components through `@vue/compiler-sfc` — the same steps
+ * `@vitejs/plugin-vue` takes, minus HMR: script (with `<script setup>` and its
+ * template inlined), a separate render function for options-API components, and
+ * each `<style>` compiled with the component's scope id.
+ */
+interface VueBlock {
+    content: string;
+    lang?: string;
+}
+interface VueStyleBlock extends VueBlock {
+    scoped?: boolean;
+}
+export interface VueDescriptor {
+    script: VueBlock | null;
+    scriptSetup: VueBlock | null;
+    template: VueBlock | null;
+    styles: VueStyleBlock[];
+}
+type Problem = string | {
+    message: string;
+};
+/**
+ * The script's binding analysis, passed from compileScript to compileTemplate
+ * untouched. Opaque here (`any`) so the real compiler's precise type fits.
+ */
+type BindingMetadata = any;
+/** The subset of `@vue/compiler-sfc` used (its browser build has the same API). */
+export interface VueCompilerSfcLike {
+    parse(source: string, options: {
+        filename: string;
+        sourceMap: boolean;
+    }): {
+        descriptor: VueDescriptor;
+        errors: Problem[];
+    };
+    compileScript(descriptor: VueDescriptor, options: {
+        id: string;
+        inlineTemplate: boolean;
+        genDefaultAs: string;
+        isProd: boolean;
+        sourceMap: boolean;
+    }): {
+        content: string;
+        bindings?: BindingMetadata;
+    };
+    compileTemplate(options: {
+        source: string;
+        filename: string;
+        id: string;
+        scoped: boolean;
+        isProd: boolean;
+        compilerOptions: {
+            bindingMetadata?: BindingMetadata;
+            isTS?: boolean;
+        };
+    }): {
+        code: string;
+        errors: Problem[];
+    };
+    compileStyle(options: {
+        source: string;
+        filename: string;
+        id: string;
+        scoped: boolean;
+        isProd: boolean;
+    }): {
+        code: string;
+        errors: Problem[];
+    };
+}
+export declare function createVueCompiler(sfc: VueCompilerSfcLike): ComponentCompiler;
+export {};
+//# sourceMappingURL=vueCompiler.d.ts.map

package/dist/vueCompiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vueCompiler.d.ts","sourceRoot":"","sources":["../src/vueCompiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIzD;;;;;GAKG;AAEH,UAAU,QAAQ;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,aAAc,SAAQ,QAAQ;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,KAAK,OAAO,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAC5C;;;GAGG;AACH,KAAK,eAAe,GAAG,GAAG,CAAC;AAE3B,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,UAAU,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAC3H,aAAa,CACX,UAAU,EAAE,aAAa,EACzB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GAC1G;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,eAAe,CAAA;KAAE,CAAC;IACnD,eAAe,CAAC,OAAO,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,EAAE,OAAO,CAAC;QAChB,eAAe,EAAE;YAAE,eAAe,CAAC,EAAE,eAAe,CAAC;YAAC,IAAI,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KACxE,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IACxC,YAAY,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG;QACzG,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,EAAE,CAAC;KACnB,CAAC;CACH;AASD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,kBAAkB,GAAG,iBAAiB,CA0D5E"}