typescript-virtual-container 1.3.4 → 1.4.1

package/dist/commands/mv.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Move or rename files and directories.
+ * @category files
+ * @params ["<source> <dest>"]
+ */
 export declare const mvCommand: ShellModule;
 //# sourceMappingURL=mv.d.ts.map

package/dist/commands/mv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mv.d.ts","sourceRoot":"","sources":["../../src/commands/mv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,SAAS,EAAE,WAyCvB,CAAC"}
+{"version":3,"file":"mv.d.ts","sourceRoot":"","sources":["../../src/commands/mv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,WAyCvB,CAAC"}

package/dist/commands/mv.js

@@ -1,4 +1,9 @@
 import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Move or rename files and directories.
+ * @category files
+ * @params ["<source> <dest>"]
+ */
 export const mvCommand = {
     name: "mv",
     description: "Move or rename files",

package/dist/commands/nano.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Simple text editor for editing files.
+ * @category files
+ * @params ["<file>"]
+ */
 export declare const nanoCommand: ShellModule;
 //# sourceMappingURL=nano.d.ts.map

package/dist/commands/nano.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nano.d.ts","sourceRoot":"","sources":["../../src/commands/nano.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,WAAW,EAAE,WA4BzB,CAAC"}
+{"version":3,"file":"nano.d.ts","sourceRoot":"","sources":["../../src/commands/nano.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WA4BzB,CAAC"}

package/dist/commands/nano.js

@@ -1,5 +1,10 @@
 import * as path from "node:path";
 import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Simple text editor for editing files.
+ * @category files
+ * @params ["<file>"]
+ */
 export const nanoCommand = {
     name: "nano",
     description: "Text editor",

package/dist/commands/neofetch.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Display system information in a decorative format.
+ * @category system
+ * @params ["[--off]"]
+ */
 export declare const neofetchCommand: ShellModule;
 //# sourceMappingURL=neofetch.d.ts.map

package/dist/commands/neofetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"neofetch.d.ts","sourceRoot":"","sources":["../../src/commands/neofetch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,eAAe,EAAE,WAsC7B,CAAC"}
+{"version":3,"file":"neofetch.d.ts","sourceRoot":"","sources":["../../src/commands/neofetch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,WA2C7B,CAAC"}

package/dist/commands/neofetch.js

@@ -1,13 +1,22 @@
 import { buildNeofetchOutput } from "../modules/neofetch";
 import { ifFlag } from "./command-helpers";
-import { getAllEnvVars } from "./set";
+/**
+ * Display system information in a decorative format.
+ * @category system
+ * @params ["[--off]"]
+ */
 export const neofetchCommand = {
     name: "neofetch",
     description: "System info display",
     category: "system",
     params: ["[--off]"],
-    run: ({ args, authUser, hostname, shell }) => {
-        const env = getAllEnvVars(authUser);
+    run: ({ args, authUser, hostname, shell, env }) => {
+        if (!shell.packageManager.isInstalled("neofetch")) {
+            return {
+                stderr: "bash: neofetch: command not found\nHint: install it with: apt install neofetch\n",
+                exitCode: 127,
+            };
+        }
         if (ifFlag(args, "--help")) {
             return {
                 stdout: "Usage: neofetch [--off]",
@@ -24,9 +33,9 @@ export const neofetchCommand = {
             stdout: buildNeofetchOutput({
                 user: authUser,
                 host: hostname,
-                shell: env.SHELL,
+                shell: env.vars.SHELL,
                 shellProps: shell.properties,
-                terminal: env.TERM,
+                terminal: env.vars.TERM,
                 uptimeSeconds: Math.floor((Date.now() - shell.startTime) / 1000),
                 packages: (() => {
                     const count = shell.packageManager?.installedCount() ?? 0;

package/dist/commands/passwd.d.ts

@@ -1,3 +1,11 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * `passwd [username]` — change a virtual user's password.
+ *
+ * - Root can change any user's password.
+ * - Non-root can only change their own password.
+ * - Interactive: emits `passwordChallenge` for hidden-input prompting.
+ * - Non-interactive: reads new password from stdin first line.
+ */
 export declare const passwdCommand: ShellModule;
 //# sourceMappingURL=passwd.d.ts.map

package/dist/commands/passwd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"passwd.d.ts","sourceRoot":"","sources":["../../src/commands/passwd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,aAAa,EAAE,WAwB3B,CAAC"}
+{"version":3,"file":"passwd.d.ts","sourceRoot":"","sources":["../../src/commands/passwd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,WAuC3B,CAAC"}

package/dist/commands/passwd.js

@@ -1,22 +1,43 @@
+/**
+ * `passwd [username]` — change a virtual user's password.
+ *
+ * - Root can change any user's password.
+ * - Non-root can only change their own password.
+ * - Interactive: emits `passwordChallenge` for hidden-input prompting.
+ * - Non-interactive: reads new password from stdin first line.
+ */
 export const passwdCommand = {
     name: "passwd",
     description: "Change user password",
     category: "users",
-    params: ["<username> <password>"],
-    run: async ({ authUser, args, shell }) => {
-        const [username, password] = args;
-        if (!username || !password) {
+    params: ["[username]"],
+    run: async ({ authUser, args, shell, stdin }) => {
+        const targetUser = args[0] ?? authUser;
+        // Permission check
+        if (authUser !== "root" && authUser !== targetUser) {
+            return { stderr: "passwd: permission denied", exitCode: 1 };
+        }
+        // Target must exist
+        if (!shell.users.listUsers().includes(targetUser)) {
+            return { stderr: `passwd: user '${targetUser}' does not exist`, exitCode: 1 };
+        }
+        // Non-interactive: read new password from stdin
+        if (stdin !== undefined && stdin.trim().length > 0) {
+            const password = stdin.trim().split("\n")[0];
+            await shell.users.setPassword(targetUser, password);
             return {
-                stderr: "passwd: usage: passwd <username> <password>",
-                exitCode: 1,
+                stdout: `passwd: password updated successfully\n`,
+                exitCode: 0,
             };
         }
-        if (authUser !== "root" && authUser !== username) {
-            return { stderr: "passwd: permission denied", exitCode: 1 };
-        }
-        await shell.users.setPassword(username, password);
+        // Interactive: emit password challenge
         return {
-            stdout: `passwd: password updated for '${username}'`,
+            passwordChallenge: {
+                prompt: "New password: ",
+                confirmPrompt: "Retype new password: ",
+                action: "passwd",
+                targetUsername: targetUser,
+            },
             exitCode: 0,
         };
     },

package/dist/commands/ping.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Send ICMP ECHO_REQUEST packets (mock implementation).
+ * @category network
+ * @params ["[-c <count>] <host>"]
+ */
 export declare const pingCommand: ShellModule;
 //# sourceMappingURL=ping.d.ts.map

package/dist/commands/ping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ping.d.ts","sourceRoot":"","sources":["../../src/commands/ping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,WAAW,EAAE,WAuBzB,CAAC"}
+{"version":3,"file":"ping.d.ts","sourceRoot":"","sources":["../../src/commands/ping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WAuBzB,CAAC"}

package/dist/commands/ping.js

@@ -1,4 +1,9 @@
 import { parseArgs } from "./command-helpers";
+/**
+ * Send ICMP ECHO_REQUEST packets (mock implementation).
+ * @category network
+ * @params ["[-c <count>] <host>"]
+ */
 export const pingCommand = {
     name: "ping",
     description: "Send ICMP ECHO_REQUEST (mock)",

package/dist/commands/printf.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Format and print data to stdout.
+ * @category shell
+ * @params ["<format> [args...]"]
+ */
 export declare const printfCommand: ShellModule;
 //# sourceMappingURL=printf.d.ts.map

package/dist/commands/printf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"printf.d.ts","sourceRoot":"","sources":["../../src/commands/printf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAoGrD,eAAO,MAAM,aAAa,EAAE,WAW3B,CAAC"}
+{"version":3,"file":"printf.d.ts","sourceRoot":"","sources":["../../src/commands/printf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAgHrD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WAW3B,CAAC"}

package/dist/commands/printf.js

@@ -48,38 +48,64 @@ function renderPrintf(fmt, args) {
             }
         }
         if (fmt[i] === "%" && i + 1 < fmt.length) {
-            // Optional width/precision: %[-][width][.prec]spec
             let j = i + 1;
-            if (fmt[j] === "-")
+            let leftAlign = false;
+            if (fmt[j] === "-") {
+                leftAlign = true;
                 j++;
-            while (j < fmt.length && /\d/.test(fmt[j]))
+            }
+            let zeroPad = false;
+            if (fmt[j] === "0") {
+                zeroPad = true;
+                j++;
+            }
+            let width = 0;
+            while (j < fmt.length && /\d/.test(fmt[j])) {
+                width = width * 10 + parseInt(fmt[j], 10);
                 j++;
+            }
+            let precision = -1;
             if (fmt[j] === ".") {
                 j++;
-                while (j < fmt.length && /\d/.test(fmt[j]))
+                precision = 0;
+                while (j < fmt.length && /\d/.test(fmt[j])) {
+                    precision = precision * 10 + parseInt(fmt[j], 10);
                     j++;
+                }
             }
             const spec = fmt[j];
             const arg = args[argIdx++] ?? "";
+            const pad = (s, ch = " ") => {
+                if (width <= 0 || s.length >= width)
+                    return s;
+                const fill = ch.repeat(width - s.length);
+                return leftAlign ? s + fill : fill + s;
+            };
             switch (spec) {
-                case "s":
-                    out += arg;
+                case "s": {
+                    let val = String(arg);
+                    if (precision >= 0)
+                        val = val.slice(0, precision);
+                    out += pad(val);
                     break;
+                }
                 case "d":
                 case "i":
-                    out += String(parseInt(arg, 10) || 0);
+                    out += pad(String(parseInt(arg, 10) || 0), zeroPad ? "0" : " ");
                     break;
-                case "f":
-                    out += String(parseFloat(arg) || 0);
+                case "f": {
+                    const prec = precision >= 0 ? precision : 6;
+                    out += pad((parseFloat(arg) || 0).toFixed(prec));
                     break;
+                }
                 case "o":
-                    out += (parseInt(arg, 10) || 0).toString(8);
+                    out += pad((parseInt(arg, 10) || 0).toString(8), zeroPad ? "0" : " ");
                     break;
                 case "x":
-                    out += (parseInt(arg, 10) || 0).toString(16);
+                    out += pad((parseInt(arg, 10) || 0).toString(16), zeroPad ? "0" : " ");
                     break;
                 case "X":
-                    out += (parseInt(arg, 10) || 0).toString(16).toUpperCase();
+                    out += pad((parseInt(arg, 10) || 0).toString(16).toUpperCase(), zeroPad ? "0" : " ");
                     break;
                 case "%":
                     out += "%";
@@ -98,6 +124,11 @@ function renderPrintf(fmt, args) {
     }
     return out;
 }
+/**
+ * Format and print data to stdout.
+ * @category shell
+ * @params ["<format> [args...]"]
+ */
 export const printfCommand = {
     name: "printf",
     description: "Format and print data",

package/dist/commands/ps.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Report process status with various formatting options.
+ * @category system
+ * @params ["[-a] [-u] [-x] [aux]"]
+ */
 export declare const psCommand: ShellModule;
 //# sourceMappingURL=ps.d.ts.map

package/dist/commands/ps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ps.d.ts","sourceRoot":"","sources":["../../src/commands/ps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,SAAS,EAAE,WAiDvB,CAAC"}
+{"version":3,"file":"ps.d.ts","sourceRoot":"","sources":["../../src/commands/ps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,WAiDvB,CAAC"}

package/dist/commands/ps.js

@@ -1,4 +1,9 @@
 import { ifFlag } from "./command-helpers";
+/**
+ * Report process status with various formatting options.
+ * @category system
+ * @params ["[-a] [-u] [-x] [aux]"]
+ */
 export const psCommand = {
     name: "ps",
     description: "Report process status",

package/dist/commands/read.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Read a line from stdin into one or more variables.
+ * @category shell
+ * @params ["[-r] [-p prompt] <var...>"]
+ */
 export declare const readCommand: ShellModule;
 //# sourceMappingURL=read.d.ts.map

package/dist/commands/read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/commands/read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,WAAW,EAAE,WAqCzB,CAAC"}
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/commands/read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WAqCzB,CAAC"}

package/dist/commands/read.js

@@ -1,4 +1,9 @@
 import { ifFlag } from "./command-helpers";
+/**
+ * Read a line from stdin into one or more variables.
+ * @category shell
+ * @params ["[-r] [-p prompt] <var...>"]
+ */
 export const readCommand = {
     name: "read",
     description: "Read a line from stdin into variables",

package/dist/commands/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/commands/registry.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAgNpF,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAYzD;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,EAChB,GAAG,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,GAClE,WAAW,CAEb;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAG1C;AAED,wBAAgB,uBAAuB,IAAI,WAAW,EAAE,CAEvD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGnE"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/commands/registry.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAmNpF,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAYzD;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,EAChB,GAAG,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,GAClE,WAAW,CAEb;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAG1C;AAED,wBAAgB,uBAAuB,IAAI,WAAW,EAAE,CAEvD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGnE"}

package/dist/commands/registry.js

@@ -33,7 +33,8 @@ import { hostnameCommand } from "./hostname";
 import { htopCommand } from "./htop";
 import { idCommand } from "./id";
 import { killCommand } from "./kill";
-import { lnCommand } from "./ln";
+import { lnCommand, readlinkCommand } from "./ln";
+import { statCommand } from "./stat";
 import { lsCommand } from "./ls";
 import { lsbReleaseCommand } from "./lsb-release";
 import { manCommand } from "./man";
@@ -93,7 +94,9 @@ const BASE_COMMANDS = [
     cpCommand,
     mvCommand,
     lnCommand,
+    readlinkCommand,
     chmodCommand,
+    statCommand,
     findCommand,
     // Text processing
     grepCommand,

package/dist/commands/rm.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Remove files or directories from the filesystem.
+ * @category files
+ * @params ["[-r|-rf] <path>"]
+ */
 export declare const rmCommand: ShellModule;
 //# sourceMappingURL=rm.d.ts.map

package/dist/commands/rm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rm.d.ts","sourceRoot":"","sources":["../../src/commands/rm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,SAAS,EAAE,WAgCvB,CAAC"}
+{"version":3,"file":"rm.d.ts","sourceRoot":"","sources":["../../src/commands/rm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,WAgCvB,CAAC"}

package/dist/commands/rm.js

@@ -1,5 +1,10 @@
 import { getArg, ifFlag } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Remove files or directories from the filesystem.
+ * @category files
+ * @params ["[-r|-rf] <path>"]
+ */
 export const rmCommand = {
     name: "rm",
     description: "Remove files or directories",

package/dist/commands/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/commands/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EACR,WAAW,EACX,aAAa,EACb,QAAQ,EACX,MAAM,mBAAmB,CAAC;AAiE3B,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAc3E;AAyCD,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,EAAE,QAAQ,GACX,OAAO,CAAC,aAAa,CAAC,CA4ExB;AAED,wBAAsB,UAAU,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,aAAa,CAAC,CA+HxB"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/commands/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EACR,WAAW,EACX,aAAa,EACb,QAAQ,EACX,MAAM,mBAAmB,CAAC;AAK3B,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAc3E;AAyCD,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,EAAE,QAAQ,GACX,OAAO,CAAC,aAAa,CAAC,CA4ExB;AAED,wBAAsB,UAAU,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,QAAQ,GACZ,OAAO,CAAC,aAAa,CAAC,CA+HxB"}

package/dist/commands/runtime.js

@@ -2,64 +2,8 @@
 import { executeStatements } from "../SSHMimic/executor";
 import { parseScript } from "../VirtualShell/shellParser";
 import { expandAsync } from "../utils/expand";
+import { tokenizeCommand } from "../utils/tokenize";
 import { resolveModule } from "./registry";
-// ── Tokenize command input respecting quotes ──────────────────────────────────
-function tokenizeCommand(input) {
-    const tokens = [];
-    let current = "";
-    let inQ = false;
-    let qChar = "";
-    let i = 0;
-    while (i < input.length) {
-        const ch = input[i];
-        const next = input[i + 1];
-        if ((ch === '"' || ch === "'") && !inQ) {
-            inQ = true;
-            qChar = ch;
-            i++;
-            continue;
-        }
-        if (inQ && ch === qChar) {
-            inQ = false;
-            qChar = "";
-            i++;
-            continue;
-        }
-        if (inQ) {
-            current += ch;
-            i++;
-            continue;
-        }
-        if (ch === " ") {
-            if (current) {
-                tokens.push(current);
-                current = "";
-            }
-            i++;
-            continue;
-        }
-        if ((ch === ">" || ch === "<") && !inQ) {
-            if (current) {
-                tokens.push(current);
-                current = "";
-            }
-            if (ch === ">" && next === ">") {
-                tokens.push(">>");
-                i += 2;
-            }
-            else {
-                tokens.push(ch);
-                i++;
-            }
-            continue;
-        }
-        current += ch;
-        i++;
-    }
-    if (current)
-        tokens.push(current);
-    return tokens;
-}
 export function makeDefaultEnv(authUser, hostname) {
     return {
         vars: {

package/dist/commands/sed.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Stream editor for filtering and transforming text lines.
+ * @category text
+ * @params ["-e <expr> [file]", "s/pattern/replace/[g]"]
+ */
 export declare const sedCommand: ShellModule;
 //# sourceMappingURL=sed.d.ts.map

package/dist/commands/sed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sed.d.ts","sourceRoot":"","sources":["../../src/commands/sed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,UAAU,EAAE,WA0DxB,CAAC"}
+{"version":3,"file":"sed.d.ts","sourceRoot":"","sources":["../../src/commands/sed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,WA0DxB,CAAC"}

package/dist/commands/sed.js

@@ -1,5 +1,10 @@
 import { getFlag, ifFlag } from "./command-helpers";
 import { resolvePath } from "./helpers";
+/**
+ * Stream editor for filtering and transforming text lines.
+ * @category text
+ * @params ["-e <expr> [file]", "s/pattern/replace/[g]"]
+ */
 export const sedCommand = {
     name: "sed",
     description: "Stream editor for filtering and transforming text",

package/dist/commands/set.d.ts

@@ -1,10 +1,9 @@
 /** biome-ignore-all lint/style/useNamingConvention: env variables */
 import type { ShellModule } from "../types/commands";
-/** @deprecated use env.vars from CommandContext */
-export declare function getEnvVar(name: string): string | undefined;
-/** @deprecated use env.vars from CommandContext */
-export declare function setEnvVar(name: string, value: string): void;
-/** @deprecated use env.vars from CommandContext */
-export declare function getAllEnvVars(authUser: string): Record<string, string>;
+/**
+ * Display or set shell variables and options.
+ * @category shell
+ * @params ["[VAR=value]"]
+ */
 export declare const setCommand: ShellModule;
 //# sourceMappingURL=set.d.ts.map

package/dist/commands/set.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../src/commands/set.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAWrD,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1D;AACD,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE3D;AACD,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAItE;AAED,eAAO,MAAM,UAAU,EAAE,WAoBxB,CAAC"}
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../src/commands/set.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,WAoBxB,CAAC"}

package/dist/commands/set.js

@@ -1,25 +1,8 @@
-// Legacy global store kept for compatibility with older callers
-const _globalEnv = {
-    PATH: "/usr/local/bin:/usr/bin:/bin",
-    HOME: "/home/user",
-    SHELL: "/bin/sh",
-    TERM: "xterm-256color",
-    USER: "user",
-};
-/** @deprecated use env.vars from CommandContext */
-export function getEnvVar(name) {
-    return _globalEnv[name];
-}
-/** @deprecated use env.vars from CommandContext */
-export function setEnvVar(name, value) {
-    _globalEnv[name] = value;
-}
-/** @deprecated use env.vars from CommandContext */
-export function getAllEnvVars(authUser) {
-    _globalEnv.USER = authUser;
-    _globalEnv.HOME = `/home/${authUser}`;
-    return { ..._globalEnv };
-}
+/**
+ * Display or set shell variables and options.
+ * @category shell
+ * @params ["[VAR=value]"]
+ */
 export const setCommand = {
     name: "set",
     description: "Display or set shell variables",

package/dist/commands/sh.d.ts

@@ -1,3 +1,9 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Execute shell scripts or commands with a minimal shell interpreter.
+ * Supports if/elif/else, for loops, while loops, and variable expansion.
+ * @category shell
+ * @params ["-c <script>", "[<file>]"]
+ */
 export declare const shCommand: ShellModule;
 //# sourceMappingURL=sh.d.ts.map

package/dist/commands/sh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sh.d.ts","sourceRoot":"","sources":["../../src/commands/sh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGR,WAAW,EACd,MAAM,mBAAmB,CAAC;AA4R3B,eAAO,MAAM,SAAS,EAAE,WA4CvB,CAAC"}
+{"version":3,"file":"sh.d.ts","sourceRoot":"","sources":["../../src/commands/sh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGX,WAAW,EACX,MAAM,mBAAmB,CAAC;AA4R3B;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,WA4CvB,CAAC"}

package/dist/commands/sh.js

@@ -233,6 +233,12 @@ async function runBlocks(blocks, ctx) {
     }
     return { ...lastResult, stdout: output.trim() || lastResult.stdout };
 }
+/**
+ * Execute shell scripts or commands with a minimal shell interpreter.
+ * Supports if/elif/else, for loops, while loops, and variable expansion.
+ * @category shell
+ * @params ["-c <script>", "[<file>]"]
+ */
 export const shCommand = {
     name: "sh",
     aliases: ["bash"],

package/dist/commands/shift.d.ts

@@ -1,5 +1,15 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Shift positional parameters (remove first N arguments).
+ * @category shell
+ * @params ["[n]"]
+ */
 export declare const shiftCommand: ShellModule;
+/**
+ * Trap signals and execute actions on signal receipt or shell exit.
+ * @category shell
+ * @params ["[action] [signal...]"]
+ */
 export declare const trapCommand: ShellModule;
 export declare const returnCommand: ShellModule;
 //# sourceMappingURL=shift.d.ts.map

package/dist/commands/shift.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shift.d.ts","sourceRoot":"","sources":["../../src/commands/shift.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,YAAY,EAAE,WAoB1B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,WAezB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,WAW3B,CAAC"}
+{"version":3,"file":"shift.d.ts","sourceRoot":"","sources":["../../src/commands/shift.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,WAoB1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WAezB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,WAW3B,CAAC"}