typescript-virtual-container 1.4.1 → 1.4.3

package/dist/self-standalone.js

@@ -1,14 +1,18 @@
 import { readFile, unlink, writeFile } from "node:fs/promises";
+import * as path from "node:path";
 import { basename } from "node:path";
 import { stdin, stdout } from "node:process";
 import { createInterface } from "node:readline";
+import { getCommandNames } from "./commands/registry";
 import { makeDefaultEnv, runCommand } from "./commands/runtime";
 import { spawnNanoEditorProcess } from "./modules/shellInteractive";
+import { resolvePath } from "./modules/shellRuntime";
 import { buildLoginBanner } from "./SSHMimic/loginBanner";
 import { buildPrompt } from "./SSHMimic/prompt";
 import { VirtualShell } from "./VirtualShell";
 const hostname = process.env.SSH_MIMIC_HOSTNAME ?? "typescript-vm";
 const argv = process.argv.slice(2);
+// ── CLI args ──────────────────────────────────────────────────────────────────
 function readUserArg() {
     for (let index = 0; index < argv.length; index += 1) {
         const current = argv[index];
@@ -30,11 +34,11 @@ const virtualShell = new VirtualShell(hostname, undefined, {
     mode: "fs",
     snapshotPath: ".vfs",
 });
+// ── VFS helpers ───────────────────────────────────────────────────────────────
 function readLastLogin(username) {
-    const lastlogPath = `/virtual-env-js/.lastlog/${username}.json`;
-    if (!virtualShell.vfs.exists(lastlogPath)) {
+    const lastlogPath = `/home/${username}/.lastlog`;
+    if (!virtualShell.vfs.exists(lastlogPath))
         return null;
-    }
     try {
         return JSON.parse(virtualShell.vfs.readFile(lastlogPath));
     }
@@ -42,6 +46,63 @@ function readLastLogin(username) {
         return null;
     }
 }
+function writeLastLogin(username, from) {
+    virtualShell.vfs.writeFile(`/home/${username}/.lastlog`, JSON.stringify({ at: new Date().toISOString(), from }));
+}
+async function flushVfs() {
+    await virtualShell.vfs.flushMirror();
+}
+function loadHistory(authUser) {
+    const historyPath = `/home/${authUser}/.bash_history`;
+    if (!virtualShell.vfs.exists(historyPath)) {
+        virtualShell.vfs.writeFile(historyPath, "");
+        return [];
+    }
+    return virtualShell.vfs
+        .readFile(historyPath)
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+}
+function saveHistory(history, authUser) {
+    const data = history.length > 0 ? `${history.join("\n")}\n` : "";
+    virtualShell.vfs.writeFile(`/home/${authUser}/.bash_history`, data);
+}
+// ── Tab completion ────────────────────────────────────────────────────────────
+function listPathCompletions(vfs, cwd, prefix) {
+    const slashIndex = prefix.lastIndexOf("/");
+    const dirPart = slashIndex >= 0 ? prefix.slice(0, slashIndex + 1) : "";
+    const namePart = slashIndex >= 0 ? prefix.slice(slashIndex + 1) : prefix;
+    const basePath = resolvePath(cwd, dirPart || ".");
+    try {
+        return vfs
+            .list(basePath)
+            .filter((e) => !e.startsWith(".") && e.startsWith(namePart))
+            .map((e) => {
+            const fullPath = path.posix.join(basePath, e);
+            const st = vfs.stat(fullPath);
+            return `${dirPart}${e}${st.type === "directory" ? "/" : ""}`;
+        })
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+function makeCompleter(getState) {
+    const commandNames = Array.from(new Set(getCommandNames())).sort();
+    return (line, cb) => {
+        const { cwd } = getState();
+        // Extract the token under/before cursor (last whitespace-separated word)
+        const token = line.split(/\s+/).at(-1) ?? "";
+        const isFirstToken = line.trimStart() === token;
+        const cmdHits = isFirstToken ? commandNames.filter((n) => n.startsWith(token)) : [];
+        const pathHits = listPathCompletions(virtualShell.vfs, cwd, token);
+        const hits = Array.from(new Set([...cmdHits, ...pathHits])).sort();
+        cb(null, [hits, token]);
+    };
+}
+// ── Hidden password input ─────────────────────────────────────────────────────
 function askHiddenQuestion(rl, promptText) {
     return new Promise((resolve) => {
         if (!stdin.isTTY || !stdout.isTTY) {
@@ -52,10 +113,8 @@ function askHiddenQuestion(rl, promptText) {
         let buffer = "";
         const cleanup = () => {
             stdin.off("data", onData);
-            if (!wasRawMode) {
+            if (!wasRawMode)
                 stdin.setRawMode(false);
-            }
-            rl.resume();
         };
         const finish = (value) => {
             cleanup();
@@ -64,8 +123,8 @@ function askHiddenQuestion(rl, promptText) {
         };
         const onData = (chunk) => {
             const input = chunk.toString("utf8");
-            for (let index = 0; index < input.length; index += 1) {
-                const ch = input[index];
+            for (let i = 0; i < input.length; i += 1) {
+                const ch = input[i];
                 if (ch === "\r" || ch === "\n") {
                     finish(buffer);
                     return;
@@ -74,46 +133,20 @@ function askHiddenQuestion(rl, promptText) {
                     buffer = buffer.slice(0, -1);
                     continue;
                 }
-                if (ch >= " ") {
+                if (ch >= " ")
                     buffer += ch;
-                }
             }
         };
+        // Pause readline so it doesn't eat our raw keystrokes
         rl.pause();
         stdout.write(promptText);
-        if (!wasRawMode) {
+        if (!wasRawMode)
             stdin.setRawMode(true);
-        }
         stdin.resume();
         stdin.on("data", onData);
     });
 }
-function writeLastLogin(username, from) {
-    const dir = "/virtual-env-js/.lastlog";
-    if (!virtualShell.vfs.exists(dir)) {
-        virtualShell.vfs.mkdir(dir, 0o700);
-    }
-    virtualShell.vfs.writeFile(`/virtual-env-js/.lastlog/${username}.json`, JSON.stringify({ at: new Date().toISOString(), from }));
-}
-async function flushVfs() {
-    await virtualShell.vfs.flushMirror();
-}
-function loadHistory() {
-    const historyPath = "/virtual-env-js/.bash_history";
-    if (!virtualShell.vfs.exists(historyPath)) {
-        virtualShell.vfs.writeFile(historyPath, "");
-        return [];
-    }
-    return virtualShell.vfs
-        .readFile(historyPath)
-        .split("\n")
-        .map((line) => line.trim())
-        .filter((line) => line.length > 0);
-}
-function saveHistory(history) {
-    const data = history.length > 0 ? `${history.join("\n")}\n` : "";
-    virtualShell.vfs.writeFile("/virtual-env-js/.bash_history", data);
-}
+// ── Session state helper ──────────────────────────────────────────────────────
 function applySessionState(authUserState, cwdState, result, shellEnvState) {
     let authUser = authUserState;
     let cwd = cwdState;
@@ -131,21 +164,16 @@ function applySessionState(authUserState, cwdState, result, shellEnvState) {
     }
     return { authUser, cwd };
 }
-virtualShell.addCommand("demo", [], () => {
-    return {
-        stdout: "This is a demo command. It does nothing useful.",
-        exitCode: 0,
-    };
-});
+// ── Demo command ──────────────────────────────────────────────────────────────
+virtualShell.addCommand("demo", [], () => ({
+    stdout: "This is a demo command. It does nothing useful.",
+    exitCode: 0,
+}));
+// ── Main shell ────────────────────────────────────────────────────────────────
 async function runReadlineShell() {
-    const rl = createInterface({ input: stdin, output: stdout, terminal: true });
     await virtualShell.ensureInitialized();
-    let history = loadHistory();
-    const rlWithHistory = rl;
-    rlWithHistory.history = [...history].reverse();
     const selectedUser = initialUser.trim() || "root";
-    const userExists = virtualShell.users.getPasswordHash(selectedUser) !== null;
-    if (!userExists) {
+    if (virtualShell.users.getPasswordHash(selectedUser) === null) {
         process.stderr.write(`self-standalone: user '${selectedUser}' does not exist\n`);
         process.exit(1);
     }
@@ -154,10 +182,19 @@ async function runReadlineShell() {
     let cwd = `/home/${authUser}`;
     shellEnv.vars.PWD = cwd;
     const remoteAddress = "localhost";
-    const terminalSize = {
-        cols: stdout.columns ?? 80,
-        rows: stdout.rows ?? 24,
-    };
+    const terminalSize = { cols: stdout.columns ?? 80, rows: stdout.rows ?? 24 };
+    let history = loadHistory(authUser);
+    // completer reads cwd via closure — always current
+    const rl = createInterface({
+        input: stdin,
+        output: stdout,
+        terminal: true,
+        completer: makeCompleter(() => ({ cwd })),
+    });
+    // Sync readline's internal history with our VFS history
+    const rlWithHistory = rl;
+    rlWithHistory.history = [...history].reverse();
+    // ── nano editor ────────────────────────────────────────────────────────────
     async function startNanoEditor(targetPath, initialContent, tempPath) {
         if (virtualShell.vfs.exists(targetPath)) {
             await writeFile(tempPath, initialContent, "utf8");
@@ -169,20 +206,16 @@ async function runReadlineShell() {
             end: () => undefined,
         });
         const wasRawMode = Boolean(stdin.isRaw);
-        const forwardInput = (chunk) => {
-            editor.stdin.write(chunk);
-        };
+        const forwardInput = (chunk) => { editor.stdin.write(chunk); };
         stdin.resume();
-        if (!wasRawMode) {
+        if (!wasRawMode)
             stdin.setRawMode(true);
-        }
         stdin.on("data", forwardInput);
         await new Promise((resolve) => {
             const cleanup = () => {
                 stdin.off("data", forwardInput);
-                if (!wasRawMode) {
+                if (!wasRawMode)
                     stdin.setRawMode(false);
-                }
                 rl.resume();
             };
             editor.on("error", (error) => {
@@ -199,7 +232,7 @@ async function runReadlineShell() {
                     await flushVfs();
                 }
                 catch {
-                    // Save skipped or temp file missing.
+                    // save skipped or temp file missing
                 }
                 await unlink(tempPath).catch(() => undefined);
                 stdout.write("\r\n");
@@ -207,6 +240,7 @@ async function runReadlineShell() {
             });
         });
     }
+    // ── challenge handlers ─────────────────────────────────────────────────────
     async function handleSudoChallenge(challenge) {
         if (challenge.onPassword) {
             let promptText = challenge.prompt;
@@ -275,6 +309,7 @@ async function runReadlineShell() {
                 break;
         }
     }
+    // handleCommandResult must be declared before the "line" handler
     async function handleCommandResult(result) {
         if (result.openEditor) {
             await startNanoEditor(result.openEditor.targetPath, result.openEditor.initialContent, result.openEditor.tempPath);
@@ -288,32 +323,26 @@ async function runReadlineShell() {
             await handlePasswordChallenge(result.passwordChallenge);
             return;
         }
+        if (result.clearScreen) {
+            stdout.write("\u001b[2J\u001b[H");
+            console.clear();
+        }
         if (result.stdout) {
             stdout.write(result.stdout.endsWith("\n") ? result.stdout : `${result.stdout}\n`);
         }
         if (result.stderr) {
             process.stderr.write(result.stderr.endsWith("\n") ? result.stderr : `${result.stderr}\n`);
         }
-        if (result.clearScreen) {
-            stdout.write("\u001b[2J\u001b[H");
-            console.clear();
-        }
-        const updatedState = applySessionState(authUser, cwd, result, shellEnv);
-        authUser = updatedState.authUser;
-        cwd = updatedState.cwd;
+        const updated = applySessionState(authUser, cwd, result, shellEnv);
+        authUser = updated.authUser;
+        cwd = updated.cwd;
         if (result.closeSession) {
             await flushVfs();
             rl.close();
             process.exit(result.exitCode ?? 0);
         }
     }
-    if (process.env.USER !== "root" && virtualShell.users.hasPassword(authUser)) {
-        const password = await askHiddenQuestion(rl, `Password for ${authUser}: `);
-        if (!virtualShell.users.verifyPassword(authUser, password)) {
-            process.stderr.write("self-standalone: authentication failed\n");
-            process.exit(1);
-        }
-    }
+    // ── Prompt helper ──────────────────────────────────────────────────────────
     const renderPrompt = () => {
         const cwdLabel = cwd === `/home/${authUser}` ? "~" : basename(cwd) || "/";
         return buildPrompt(authUser, hostname, cwdLabel);
@@ -322,50 +351,68 @@ async function runReadlineShell() {
         rl.setPrompt(renderPrompt());
         rl.prompt();
     };
-    rl.on("SIGINT", () => {
-        stdout.write("^C\n");
-        rl.write("", { ctrl: true, name: "u" });
-        prompt();
-    });
-    rl.on("close", () => {
-        void (async () => {
-            await flushVfs();
-            console.log("");
-            process.exit(0);
-        })();
-    });
+    // ── Auth (password gate) ───────────────────────────────────────────────────
+    if (process.env.USER !== "root" && virtualShell.users.hasPassword(authUser)) {
+        const password = await askHiddenQuestion(rl, `Password for ${authUser}: `);
+        if (!virtualShell.users.verifyPassword(authUser, password)) {
+            process.stderr.write("self-standalone: authentication failed\n");
+            process.exit(1);
+        }
+    }
+    // ── Login banner ───────────────────────────────────────────────────────────
     stdout.write(buildLoginBanner(hostname, virtualShell.properties, readLastLogin(authUser)));
     writeLastLogin(authUser, remoteAddress);
     await flushVfs();
-    prompt();
-    while (true) {
-        const inputLine = await new Promise((resolve) => {
-            rl.once("line", (line) => resolve(line));
-        });
+    // ── Event-driven line handler (enables completer) ──────────────────────────
+    //
+    // Key insight: readline's completer only fires when readline itself owns
+    // stdin (i.e. rl is not paused). We use the event-driven "line" pattern
+    // instead of a while(true)+rl.once("line") loop so readline stays active
+    // between commands. We pause only while awaiting async work, then resume
+    // immediately before re-prompting so the next Tab press is caught.
+    let busy = false;
+    rl.on("line", async (inputLine) => {
+        if (busy)
+            return; // shouldn't happen but guard re-entrancy
+        busy = true;
         rl.pause();
-        if (inputLine.trim().length > 0) {
+        const trimmed = inputLine.trim();
+        if (trimmed.length > 0) {
             history.push(inputLine);
-            if (history.length > 500) {
+            if (history.length > 500)
                 history = history.slice(history.length - 500);
-            }
-            saveHistory(history);
+            saveHistory(history, authUser);
             rlWithHistory.history = [...history].reverse();
         }
         const result = await runCommand(inputLine, authUser, hostname, "shell", cwd, virtualShell, undefined, shellEnv);
         await handleCommandResult(result);
         await flushVfs();
-        prompt();
+        busy = false;
+        // Resume before prompt so readline can handle Tab on the next input
         rl.resume();
-    }
+        prompt();
+    });
+    rl.on("SIGINT", () => {
+        stdout.write("^C\n");
+        rl.write("", { ctrl: true, name: "u" });
+        prompt();
+    });
+    rl.on("close", () => {
+        void flushVfs().then(() => {
+            console.log("");
+            process.exit(0);
+        });
+    });
+    // Initial prompt — readline is already active, completer live from first keystroke
+    prompt();
 }
 runReadlineShell().catch((error) => {
     console.error("Failed to start readline SSH emulation:", error);
     process.exit(1);
 });
 process.on("uncaughtException", (error) => {
-    console.log("Oh my god, something terrible happened: ", error);
+    console.error("Uncaught exception:", error);
 });
 process.on("unhandledRejection", (error, promise) => {
-    console.log(" Oh Lord! We forgot to handle a promise rejection here: ", promise);
-    console.log(" The error was: ", error);
+    console.error("Unhandled rejection at:", promise, "error:", error);
 });

package/dist/types/pipeline.d.ts

@@ -10,6 +10,12 @@ export interface PipelineCommand {
     outputFile?: string;
     /** Append to output file (>> file) */
     appendOutput?: boolean;
+    /** Stderr redirection file path (2> file) */
+    stderrFile?: string;
+    /** Append stderr to file (2>> file) */
+    stderrAppend?: boolean;
+    /** Redirect stderr to stdout (2>&1) */
+    stderrToStdout?: boolean;
 }
 /** Logical operator connecting two statement groups. */
 export type LogicalOp = "&&" | "||" | ";";

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

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/types/pipeline.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC/B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wDAAwD;AACxD,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,GAAG,CAAC;AAE1C,yCAAyC;AACzC,MAAM,WAAW,QAAQ;IACxB,uCAAuC;IACvC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0FAA0F;AAC1F,MAAM,WAAW,SAAS;IACzB,8CAA8C;IAC9C,QAAQ,EAAE,QAAQ,CAAC;IACnB,0DAA0D;IAC1D,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,2CAA2C;IAC3C,IAAI,CAAC,EAAE,SAAS,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,MAAM;IACtB,0CAA0C;IAC1C,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/types/pipeline.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC/B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uCAAuC;IACvC,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wDAAwD;AACxD,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,GAAG,CAAC;AAE1C,yCAAyC;AACzC,MAAM,WAAW,QAAQ;IACxB,uCAAuC;IACvC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0FAA0F;AAC1F,MAAM,WAAW,SAAS;IACzB,8CAA8C;IAC9C,QAAQ,EAAE,QAAQ,CAAC;IACnB,0DAA0D;IAC1D,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,2CAA2C;IAC3C,IAAI,CAAC,EAAE,SAAS,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,MAAM;IACtB,0CAA0C;IAC1C,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/types/vfs.d.ts

@@ -68,4 +68,19 @@ export type VfsSnapshotNode = VfsSnapshotFileNode | VfsSnapshotDirectoryNode;
 export interface VfsSnapshot {
     root: VfsSnapshotDirectoryNode;
 }
+/** Options for mounting a host directory into the VFS. */
+export interface MountOptions {
+    /** Absolute path inside the VM (e.g. `"/app"`). */
+    vPath: string;
+    /** Path on the host filesystem. Relative paths resolved from `process.cwd()`. */
+    hostPath: string;
+    /** When `true` (default), write operations inside the mount throw `EROFS`. */
+    readOnly?: boolean;
+}
+/** Describes an active mount point. */
+export interface MountPoint {
+    vPath: string;
+    hostPath: string;
+    readOnly: boolean;
+}
 //# sourceMappingURL=vfs.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"vfs.d.ts","sourceRoot":"","sources":["../../src/types/vfs.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/C,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC3B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,IAAI,CAAC;IAChB,6BAA6B;IAC7B,SAAS,EAAE,IAAI,CAAC;CAChB;AAED,0CAA0C;AAC1C,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,UAAU,EAAE,OAAO,CAAC;IACpB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;CACb;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,kDAAkD;AAClD,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAE1D,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAChC,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC7B,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACpE,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,kDAAkD;AAClD,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG,wBAAwB,CAAC;AAE7E,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,wBAAwB,CAAC;CAC/B"}
+{"version":3,"file":"vfs.d.ts","sourceRoot":"","sources":["../../src/types/vfs.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/C,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC3B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,IAAI,CAAC;IAChB,6BAA6B;IAC7B,SAAS,EAAE,IAAI,CAAC;CAChB;AAED,0CAA0C;AAC1C,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,UAAU,EAAE,OAAO,CAAC;IACpB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;CACb;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,kDAAkD;AAClD,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAE1D,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAChC,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC7B,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACpE,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,kDAAkD;AAClD,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG,wBAAwB,CAAC;AAE7E,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,wBAAwB,CAAC;CAC/B;AAED,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC5B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,uCAAuC;AACvC,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAK,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CAClB"}

package/dist/utils/expand.d.ts

@@ -34,6 +34,15 @@ export declare function evalArith(expr: string, env: Record<string, string>): nu
  * @param lastExit  Last command exit code (for `$?`).
  * @param home      Home directory path (for `~`).
  */
+/**
+ * Expand brace expressions in a single token.
+ * - `{a,b,c}` → `["a", "b", "c"]`
+ * - `{1..5}` → `["1", "2", "3", "4", "5"]`
+ * - `{a..e}` → `["a", "b", "c", "d", "e"]`
+ * - `prefix{a,b}suffix` → `["prefixasuffix", "prefixbsuffix"]`
+ * Returns a single-element array when no brace expansion applies.
+ */
+export declare function expandBraces(token: string): string[];
 export declare function expandSync(input: string, env: Record<string, string>, lastExit?: number, home?: string): string;
 /**
  * Expand all shell forms including `$(cmd)` command substitution.

package/dist/utils/expand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expand.d.ts","sourceRoot":"","sources":["../../src/utils/expand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAuB3E;AAoCD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACzB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,QAAQ,SAAI,EACZ,IAAI,CAAC,EAAE,MAAM,GACX,MAAM,CA4DR;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAChC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CAuDjB"}
+{"version":3,"file":"expand.d.ts","sourceRoot":"","sources":["../../src/utils/expand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAuB3E;AAoCD;;;;;;;;;GASG;AAEH;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA8DpD;AAED,wBAAgB,UAAU,CACzB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,QAAQ,SAAI,EACZ,IAAI,CAAC,EAAE,MAAM,GACX,MAAM,CA4DR;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAChC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CAuDjB"}

package/dist/utils/expand.js

@@ -82,6 +82,88 @@ function outsideSingleQuotes(input, replacer) {
  * @param lastExit  Last command exit code (for `$?`).
  * @param home      Home directory path (for `~`).
  */
+/**
+ * Expand brace expressions in a single token.
+ * - `{a,b,c}` → `["a", "b", "c"]`
+ * - `{1..5}` → `["1", "2", "3", "4", "5"]`
+ * - `{a..e}` → `["a", "b", "c", "d", "e"]`
+ * - `prefix{a,b}suffix` → `["prefixasuffix", "prefixbsuffix"]`
+ * Returns a single-element array when no brace expansion applies.
+ */
+export function expandBraces(token) {
+    // Find the first { not preceded by $
+    let depth = 0;
+    let start = -1;
+    for (let i = 0; i < token.length; i++) {
+        const ch = token[i];
+        if (ch === "{" && token[i - 1] !== "$") {
+            if (depth === 0)
+                start = i;
+            depth++;
+        }
+        else if (ch === "}") {
+            depth--;
+            if (depth === 0 && start !== -1) {
+                const prefix = token.slice(0, start);
+                const inner = token.slice(start + 1, i);
+                const suffix = token.slice(i + 1);
+                // Range: {1..5} or {a..e}
+                const rangeMatch = inner.match(/^(-?\d+)\.\.(-?\d+)(?:\.\.-?(\d+))?$/) ||
+                    inner.match(/^([a-z])\.\.([a-z])$/);
+                if (rangeMatch) {
+                    const items = [];
+                    if (/\d/.test(rangeMatch[1])) {
+                        const from = parseInt(rangeMatch[1], 10);
+                        const to = parseInt(rangeMatch[2], 10);
+                        const step = rangeMatch[3] ? parseInt(rangeMatch[3], 10) : 1;
+                        const inc = from <= to ? step : -step;
+                        for (let n = from; from <= to ? n <= to : n >= to; n += inc) {
+                            items.push(String(n));
+                        }
+                    }
+                    else {
+                        const from = rangeMatch[1].charCodeAt(0);
+                        const to = rangeMatch[2].charCodeAt(0);
+                        const inc = from <= to ? 1 : -1;
+                        for (let c = from; from <= to ? c <= to : c >= to; c += inc) {
+                            items.push(String.fromCharCode(c));
+                        }
+                    }
+                    const expanded = items.map((v) => `${prefix}${v}${suffix}`);
+                    return expanded.flatMap(expandBraces);
+                }
+                // Comma list: {a,b,c} — split respecting nested braces
+                const parts = [];
+                let cur = "";
+                let d2 = 0;
+                for (const ch2 of inner) {
+                    if (ch2 === "{") {
+                        d2++;
+                        cur += ch2;
+                    }
+                    else if (ch2 === "}") {
+                        d2--;
+                        cur += ch2;
+                    }
+                    else if (ch2 === "," && d2 === 0) {
+                        parts.push(cur);
+                        cur = "";
+                    }
+                    else {
+                        cur += ch2;
+                    }
+                }
+                parts.push(cur);
+                if (parts.length > 1) {
+                    const expanded = parts.map((p) => `${prefix}${p}${suffix}`);
+                    return expanded.flatMap(expandBraces);
+                }
+                break;
+            }
+        }
+    }
+    return [token];
+}
 export function expandSync(input, env, lastExit = 0, home) {
     const homePath = home ?? env.HOME ?? "/home/user";
     return outsideSingleQuotes(input, (chunk) => {
@@ -111,8 +193,8 @@ export function expandSync(input, env, lastExit = 0, home) {
         s = s.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*):\+([^}]*)\}/g, (_, name, alt) => env[name] !== undefined && env[name] !== "" ? alt : "");
         // ${VAR}
         s = s.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (_, name) => env[name] ?? "");
-        // $VAR
-        s = s.replace(/\$([A-Za-z_][A-Za-z0-9_]*)/g, (_, name) => env[name] ?? "");
+        // $VAR and positional params $1 $2 ...
+        s = s.replace(/\$([A-Za-z_][A-Za-z0-9_]*|\d+)/g, (_, name) => env[name] ?? "");
         return s;
     });
 }

package/dist/utils/tokenize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenize.d.ts","sourceRoot":"","sources":["../../src/utils/tokenize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA0DvD"}
+{"version":3,"file":"tokenize.d.ts","sourceRoot":"","sources":["../../src/utils/tokenize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA8EvD"}

package/dist/utils/tokenize.js

@@ -50,6 +50,46 @@ export function tokenizeCommand(input) {
             i++;
             continue;
         }
+        // Handle 2>&1, 2>>, 2>, >&, >>
+        if (!inQ && ch === "2" && (next === ">")) {
+            const rest = input.slice(i + 1);
+            if (rest.startsWith(">>&1") || rest.startsWith(">> &1")) {
+                if (current) {
+                    tokens.push(current);
+                    current = "";
+                }
+                tokens.push("2>>&1");
+                i += 5;
+                continue;
+            }
+            if (rest.startsWith(">&1")) {
+                if (current) {
+                    tokens.push(current);
+                    current = "";
+                }
+                tokens.push("2>&1");
+                i += 4;
+                continue;
+            }
+            if (rest.startsWith(">>")) {
+                if (current) {
+                    tokens.push(current);
+                    current = "";
+                }
+                tokens.push("2>>");
+                i += 3;
+                continue;
+            }
+            if (rest.startsWith(">")) {
+                if (current) {
+                    tokens.push(current);
+                    current = "";
+                }
+                tokens.push("2>");
+                i += 2;
+                continue;
+            }
+        }
         if ((ch === ">" || ch === "<") && !inQ) {
             if (current) {
                 tokens.push(current);

package/package.json

@@ -4,7 +4,7 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
-  "version": "1.4.1",
+  "version": "1.4.3",
   "license": "MIT",
   "repository": {
     "type": "git",