typescript-virtual-container 1.3.3 → 1.4.0

package/dist/commands/adduser.js

@@ -1,26 +1,89 @@
 /**
- * Add a new user to the virtual user database.
- * @category users
- * @params ["<username> <password>"]
- * @returns ShellModule
+ * Add a new user interactively.
+ *
+ * Usage: `adduser <username>`
+ *
+ * Prompts for:
+ *   New password: ****
+ *   Retype new password: ****
+ *
+ * Mirrors the real `adduser` behaviour — password is never passed on the
+ * command line. Root-only.
  */
 export const adduserCommand = {
     name: "adduser",
     description: "Add a new user",
     category: "users",
-    params: ["<username> <password>"],
-    run: async ({ authUser, shell, args }) => {
+    params: ["<username>"],
+    run: ({ authUser, shell, args }) => {
         if (authUser !== "root") {
-            return { stderr: "adduser: permission denied", exitCode: 1 };
+            return { stderr: "adduser: permission denied\n", exitCode: 1 };
         }
-        const [username, password] = args;
-        if (!username || !password) {
+        const username = args[0];
+        if (!username) {
             return {
-                stderr: "adduser: usage: adduser <username> <password>",
+                stderr: "Usage: adduser <username>\n",
                 exitCode: 1,
             };
         }
-        await shell.users.addUser(username, password);
-        return { stdout: `adduser: user '${username}' created`, exitCode: 0 };
+        // Reject if user already exists
+        if (shell.users.listUsers().includes(username)) {
+            return {
+                stderr: `adduser: user '${username}' already exists\n`,
+                exitCode: 1,
+            };
+        }
+        let newPassword = "";
+        let step = "new";
+        const onPassword = async (input, sh) => {
+            if (step === "new") {
+                if (input.length < 1) {
+                    return {
+                        result: {
+                            stderr: "adduser: password cannot be empty\n",
+                            exitCode: 1,
+                        },
+                    };
+                }
+                newPassword = input;
+                step = "retype";
+                return { result: null, nextPrompt: "Retype new password: " };
+            }
+            // step === "retype"
+            if (input !== newPassword) {
+                return {
+                    result: {
+                        stderr: "adduser: passwords do not match — user not created\n",
+                        exitCode: 1,
+                    },
+                };
+            }
+            await sh.users.addUser(username, newPassword);
+            return {
+                result: {
+                    stdout: `${[
+                        `Adding user '${username}' ...`,
+                        `Adding new group '${username}' (1001) ...`,
+                        `Adding new user '${username}' (1001) with group '${username}' ...`,
+                        `Creating home directory '/home/${username}' ...`,
+                        `passwd: password set for '${username}'`,
+                        `adduser: done.`,
+                    ].join("\n")}\n`,
+                    exitCode: 0,
+                },
+            };
+        };
+        return {
+            sudoChallenge: {
+                username,
+                targetUser: username,
+                commandLine: null,
+                loginShell: false,
+                prompt: "New password: ",
+                mode: "passwd",
+                onPassword,
+            },
+            exitCode: 0,
+        };
     },
 };

package/dist/commands/alias.d.ts

@@ -5,5 +5,10 @@ import type { ShellModule } from "../types/commands";
  * @params ["[name[=value] ...]"]
  */
 export declare const aliasCommand: ShellModule;
+/**
+ * Remove shell aliases.
+ * @category shell
+ * @params ["<name...>"]
+ */
 export declare const unaliasCommand: ShellModule;
 //# sourceMappingURL=alias.d.ts.map

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

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

package/dist/commands/alias.js

@@ -40,6 +40,11 @@ export const aliasCommand = {
         return { stdout: lines.join("\n") || undefined, exitCode: 0 };
     },
 };
+/**
+ * Remove shell aliases.
+ * @category shell
+ * @params ["<name...>"]
+ */
 export const unaliasCommand = {
     name: "unalias",
     description: "Remove alias definitions",

package/dist/commands/apt.d.ts

@@ -5,5 +5,10 @@ import type { ShellModule } from "../types/commands";
  * @params ["<install|remove|update|upgrade|search|show|list> [pkg...]"]
  */
 export declare const aptCommand: ShellModule;
+/**
+ * Query the package cache and retrieve package information.
+ * @category package
+ * @params ["<search|show|policy> [pkg]"]
+ */
 export declare const aptCacheCommand: ShellModule;
 //# sourceMappingURL=apt.d.ts.map

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

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

package/dist/commands/apt.js

@@ -139,6 +139,11 @@ export const aptCommand = {
         }
     },
 };
+/**
+ * Query the package cache and retrieve package information.
+ * @category package
+ * @params ["<search|show|policy> [pkg]"]
+ */
 export const aptCacheCommand = {
     name: "apt-cache",
     description: "Query the package cache",

package/dist/commands/awk.d.ts

@@ -1,14 +1,16 @@
 import type { ShellModule } from "../types/commands";
 /**
- * Minimal `awk`-like pattern scanner (supports simple print patterns).
- * @category text
- * @params ["[-F <sep>] '<program>' [file]"]
+ * Minimal awk-like pattern scanner.
  *
- * Supported program patterns:
- * - `print $N` (e.g. `print $1`, `print $2, $3`, `print $0`)
- * - `{print $N}` (e.g. `{print $1}`, `{print $2, $3}`, `{print $0}`)
- *
- * The field separator can be set with `-F` (default is space, which splits on any whitespace).
+ * Supported:
+ *   - `NR==N` pattern (line number condition)
+ *   - `NF` (number of fields)
+ *   - `/regex/` pattern
+ *   - `{ print $N, $M, ... }` action
+ *   - `{ print }` / `{ print $0 }`
+ *   - `BEGIN { ... }` and `END { ... }` blocks (no side effects)
+ *   - `$NF` (last field)
+ *   - `-F sep` field separator
  */
 export declare const awkCommand: ShellModule;
 //# sourceMappingURL=awk.d.ts.map

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

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

package/dist/commands/awk.js

@@ -1,42 +1,170 @@
 import { getFlag } from "./command-helpers";
+import { resolvePath, assertPathAccess } from "./helpers";
 /**
- * Minimal `awk`-like pattern scanner (supports simple print patterns).
- * @category text
- * @params ["[-F <sep>] '<program>' [file]"]
+ * Minimal awk-like pattern scanner.
  *
- * Supported program patterns:
- * - `print $N` (e.g. `print $1`, `print $2, $3`, `print $0`)
- * - `{print $N}` (e.g. `{print $1}`, `{print $2, $3}`, `{print $0}`)
- *
- * The field separator can be set with `-F` (default is space, which splits on any whitespace).
+ * Supported:
+ *   - `NR==N` pattern (line number condition)
+ *   - `NF` (number of fields)
+ *   - `/regex/` pattern
+ *   - `{ print $N, $M, ... }` action
+ *   - `{ print }` / `{ print $0 }`
+ *   - `BEGIN { ... }` and `END { ... }` blocks (no side effects)
+ *   - `$NF` (last field)
+ *   - `-F sep` field separator
  */
 export const awkCommand = {
     name: "awk",
-    description: "Pattern scanning and processing language (minimal)",
+    description: "Pattern scanning and processing language",
     category: "text",
     params: ["[-F <sep>] '<program>' [file]"],
-    run: ({ args, stdin }) => {
+    run: ({ authUser, args, stdin, cwd, shell }) => {
         const sep = getFlag(args, ["-F"]) ?? " ";
-        const prog = args.find((a) => !a.startsWith("-") && a !== sep);
+        const nonFlagArgs = args.filter((a) => !a.startsWith("-") && a !== sep);
+        const prog = nonFlagArgs[0];
+        const fileArg = nonFlagArgs[1];
         if (!prog)
             return { stderr: "awk: no program", exitCode: 1 };
-        // Only support print $N and {print $N} patterns
-        const printMatch = prog.match(/^\{?\s*print\s+([^}]+)\s*\}?$/);
-        if (!printMatch)
-            return { stderr: `awk: unsupported program: ${prog}`, exitCode: 1 };
-        const fields = printMatch[1].split(/\s*,\s*/).map((f) => f.trim());
-        const lines = (stdin ?? "").split("\n").filter(Boolean);
-        const out = lines.map((line) => {
-            const parts = line.split(sep === " " ? /\s+/ : sep);
-            return fields
-                .map((f) => {
-                if (f === "$0")
+        let input = stdin ?? "";
+        if (fileArg) {
+            const filePath = resolvePath(cwd, fileArg);
+            try {
+                assertPathAccess(authUser, filePath, "awk");
+                input = shell.vfs.readFile(filePath);
+            }
+            catch {
+                return { stderr: `awk: ${fileArg}: No such file or directory`, exitCode: 1 };
+            }
+        }
+        const lines = input.split("\n");
+        // Remove empty last element if input ends with \n
+        if (lines[lines.length - 1] === "")
+            lines.pop();
+        const clauses = [];
+        const progTrim = prog.trim();
+        // Handle single unbraced pattern (NR==2, /regex/)
+        if (!progTrim.startsWith("{") && !progTrim.includes("{")) {
+            clauses.push({ pattern: progTrim, action: "print $0" });
+        }
+        else {
+            // Parse "pattern { action } pattern2 { action2 }"
+            const clauseRe = /([^{]*)\{([^}]*)\}/g;
+            let m2 = clauseRe.exec(progTrim);
+            while (m2 !== null) {
+                clauses.push({ pattern: m2[1].trim(), action: m2[2].trim() });
+                m2 = clauseRe.exec(progTrim);
+            }
+            if (clauses.length === 0) {
+                clauses.push({ pattern: "", action: progTrim.replace(/[{}]/g, "").trim() });
+            }
+        }
+        const out = [];
+        // BEGIN / END
+        const beginClause = clauses.find((c) => c.pattern === "BEGIN");
+        const endClause = clauses.find((c) => c.pattern === "END");
+        const mainClauses = clauses.filter((c) => c.pattern !== "BEGIN" && c.pattern !== "END");
+        function splitFields(line) {
+            if (sep === " ")
+                return line.trim().split(/\s+/).filter(Boolean);
+            return line.split(sep);
+        }
+        function evalAction(action, line, nr) {
+            const parts = splitFields(line);
+            const nf = parts.length;
+            // Expand variables
+            const resolve = (expr) => {
+                expr = expr.trim();
+                if (expr === "NR")
+                    return String(nr);
+                if (expr === "NF")
+                    return String(nf);
+                if (expr === "$0")
                     return line;
-                const n = parseInt(f.replace("$", ""), 10);
-                return Number.isNaN(n) ? f.replace(/"/g, "") : (parts[n - 1] ?? "");
-            })
-                .join(sep === " " ? "\t" : sep);
-        });
-        return { stdout: out.join("\n"), exitCode: 0 };
+                if (expr === "$NF")
+                    return parts[nf - 1] ?? "";
+                if (/^\$\d+$/.test(expr))
+                    return parts[parseInt(expr.slice(1), 10) - 1] ?? "";
+                // Arithmetic NR+1, NF-1
+                const arith = expr.replace(/\bNR\b/g, String(nr)).replace(/\bNF\b/g, String(nf));
+                if (/^[\d\s+\-*/()]+$/.test(arith)) {
+                    // biome-ignore lint/security/noGlobalEval: safe arithmetic — input contains only digits and operators after variable substitution
+                    try {
+                        return String(Function(`"use strict"; return (${arith});`)());
+                    }
+                    catch { }
+                }
+                return expr.replace(/"/g, "");
+            };
+            const stmts = action.split(";").map((s) => s.trim()).filter(Boolean);
+            for (const stmt of stmts) {
+                if (stmt === "print" || stmt === "print $0") {
+                    out.push(line);
+                }
+                else if (stmt.startsWith("print ")) {
+                    const args2 = stmt.slice(6).split(/\s*,\s*/);
+                    out.push(args2.map(resolve).join("\t"));
+                }
+            }
+        }
+        function matchPattern(pattern, line, nr) {
+            if (!pattern)
+                return true;
+            if (pattern === "1")
+                return true;
+            // NR==N or NR>N etc.
+            const nrCond = pattern.match(/^NR\s*([=!<>]=?|==)\s*(\d+)$/);
+            if (nrCond) {
+                const op = nrCond[1];
+                const val = parseInt(nrCond[2], 10);
+                switch (op) {
+                    case "==": return nr === val;
+                    case "!=": return nr !== val;
+                    case ">": return nr > val;
+                    case ">=": return nr >= val;
+                    case "<": return nr < val;
+                    case "<=": return nr <= val;
+                }
+            }
+            // NR%N==M
+            const nrMod = pattern.match(/^NR%(\d+)==(\d+)$/);
+            if (nrMod) {
+                return nr % parseInt(nrMod[1], 10) === parseInt(nrMod[2], 10);
+            }
+            // /regex/ pattern
+            if (pattern.startsWith("/") && pattern.endsWith("/")) {
+                try {
+                    return new RegExp(pattern.slice(1, -1)).test(line);
+                }
+                catch {
+                    return false;
+                }
+            }
+            // $N~/regex/
+            const fieldMatch = pattern.match(/^\$(\d+)~\/(.*)\/$/);
+            if (fieldMatch) {
+                const parts = splitFields(line);
+                const field = parts[parseInt(fieldMatch[1], 10) - 1] ?? "";
+                try {
+                    return new RegExp(fieldMatch[2]).test(field);
+                }
+                catch {
+                    return false;
+                }
+            }
+            return false;
+        }
+        if (beginClause)
+            evalAction(beginClause.action, "", 0);
+        for (let nr = 1; nr <= lines.length; nr++) {
+            const line = lines[nr - 1];
+            for (const clause of mainClauses) {
+                if (matchPattern(clause.pattern, line, nr)) {
+                    evalAction(clause.action, line, nr);
+                }
+            }
+        }
+        if (endClause)
+            evalAction(endClause.action, "", lines.length + 1);
+        return { stdout: out.join("\n") + (out.length > 0 ? "\n" : ""), exitCode: 0 };
     },
 };

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

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

package/dist/commands/cd.js

@@ -16,9 +16,6 @@ export const cdCommand = {
         if (stats.type !== "directory") {
             return { stderr: `cd: not a directory: ${target}`, exitCode: 1 };
         }
-        if (mode === "exec") {
-            return { exitCode: 0 };
-        }
         return { nextCwd: target, exitCode: 0 };
     },
 };

package/dist/commands/clear.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Clear the terminal screen.
+ * @category shell
+ * @params []
+ */
 export declare const clearCommand: ShellModule;
 //# sourceMappingURL=clear.d.ts.map

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

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

package/dist/commands/clear.js

@@ -1,3 +1,8 @@
+/**
+ * Clear the terminal screen.
+ * @category shell
+ * @params []
+ */
 export const clearCommand = {
     name: "clear",
     description: "Clear the terminal screen",

package/dist/commands/command-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/command-helpers.ts"],"names":[],"mappings":"AAAA,KAAK,eAAe,GAAG;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AA+EF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAYxE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,OAAO,CACtB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GACtB,MAAM,GAAG,IAAI,GAAG,SAAS,CA0B3B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CACrB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,eAAoB,GAC3B,MAAM,GAAG,SAAS,CAGpB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,SAAS,CACxB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAC3D;IACF,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB,CAiDA"}
+{"version":3,"file":"command-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/command-helpers.ts"],"names":[],"mappings":"AAAA,KAAK,eAAe,GAAG;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAwFF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAYxE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,OAAO,CACtB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GACtB,MAAM,GAAG,IAAI,GAAG,SAAS,CA0B3B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CACrB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,eAAoB,GAC3B,MAAM,GAAG,SAAS,CAGpB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,SAAS,CACxB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAC3D;IACF,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB,CAiDA"}

package/dist/commands/command-helpers.js

@@ -5,10 +5,18 @@ function matchFlagToken(token, flag) {
     if (token === flag) {
         return { matched: true, inlineValue: null };
     }
+    // --flag=value style
     const prefix = `${flag}=`;
     if (token.startsWith(prefix)) {
         return { matched: true, inlineValue: token.slice(prefix.length) };
     }
+    // Short flag inline value: -f2, -d: (single char flag like -f, -d, -n)
+    // Only applies to single-char flags (-X), not long flags (--flag)
+    if (flag.length === 2 && flag.startsWith("-") && !flag.startsWith("--")) {
+        if (token.startsWith(flag) && token.length > flag.length) {
+            return { matched: true, inlineValue: token.slice(flag.length) };
+        }
+    }
     return { matched: false, inlineValue: null };
 }
 function collectPositionals(args, options = {}) {

package/dist/commands/declare.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Declare variables and give them attributes (integer, readonly, export, array).
+ * @category shell
+ * @params ["[-i] [-r] [-x] [-a] [name[=value]...]"]
+ */
 export declare const declareCommand: ShellModule;
 //# sourceMappingURL=declare.d.ts.map

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

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

package/dist/commands/declare.js

@@ -1,4 +1,9 @@
 import { ifFlag } from "./command-helpers";
+/**
+ * Declare variables and give them attributes (integer, readonly, export, array).
+ * @category shell
+ * @params ["[-i] [-r] [-x] [-a] [name[=value]...]"]
+ */
 export const declareCommand = {
     name: "declare",
     aliases: ["local", "typeset"],

package/dist/commands/deluser.d.ts

@@ -1,3 +1,15 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Delete a user. Root-only.
+ *
+ * Without `-f`: prompts for confirmation — the user must type the exact
+ * username to proceed.
+ *
+ * With `-f` / `--force`: deletes without confirmation.
+ *
+ * Usage:
+ *   deluser <username>
+ *   deluser -f <username>
+ */
 export declare const deluserCommand: ShellModule;
 //# sourceMappingURL=deluser.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"deluser.d.ts","sourceRoot":"","sources":["../../src/commands/deluser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,cAAc,EAAE,WAkB5B,CAAC"}
+{"version":3,"file":"deluser.d.ts","sourceRoot":"","sources":["../../src/commands/deluser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGpE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,EAAE,WAkF5B,CAAC"}

package/dist/commands/deluser.js

@@ -1,17 +1,83 @@
+/**
+ * Delete a user. Root-only.
+ *
+ * Without `-f`: prompts for confirmation — the user must type the exact
+ * username to proceed.
+ *
+ * With `-f` / `--force`: deletes without confirmation.
+ *
+ * Usage:
+ *   deluser <username>
+ *   deluser -f <username>
+ */
 export const deluserCommand = {
     name: "deluser",
     description: "Delete a user",
     category: "users",
-    params: ["<username>"],
+    params: ["[-f] <username>"],
     run: async ({ authUser, args, shell }) => {
         if (authUser !== "root") {
-            return { stderr: "deluser: permission denied", exitCode: 1 };
+            return { stderr: "deluser: permission denied\n", exitCode: 1 };
         }
-        const [username] = args;
+        const force = args.includes("-f") ||
+            args.includes("--force") ||
+            args.includes("-y");
+        const username = args.find((a) => !a.startsWith("-"));
         if (!username) {
-            return { stderr: "deluser: usage: deluser <username>", exitCode: 1 };
+            return {
+                stderr: "Usage: deluser [-f] <username>\n",
+                exitCode: 1,
+            };
         }
-        await shell.users.deleteUser(username);
-        return { stdout: `deluser: user '${username}' deleted`, exitCode: 0 };
+        if (!shell.users.listUsers().includes(username)) {
+            return {
+                stderr: `deluser: user '${username}' does not exist\n`,
+                exitCode: 1,
+            };
+        }
+        if (username === "root") {
+            return {
+                stderr: "deluser: cannot remove the root account\n",
+                exitCode: 1,
+            };
+        }
+        // Force mode — delete without confirmation
+        if (force) {
+            await shell.users.deleteUser(username);
+            return {
+                stdout: `Removing user '${username}' ...\ndeluser: done.\n`,
+                exitCode: 0,
+            };
+        }
+        // Interactive confirmation
+        const onPassword = async (input, sh) => {
+            if (input.trim() !== username) {
+                return {
+                    result: {
+                        stderr: "deluser: confirmation did not match — user not deleted\n",
+                        exitCode: 1,
+                    },
+                };
+            }
+            await sh.users.deleteUser(username);
+            return {
+                result: {
+                    stdout: `Removing user '${username}' ...\ndeluser: done.\n`,
+                    exitCode: 0,
+                },
+            };
+        };
+        return {
+            sudoChallenge: {
+                username,
+                targetUser: username,
+                commandLine: null,
+                loginShell: false,
+                prompt: `Warning: deleting user '${username}'.\nType the username to confirm: `,
+                mode: "confirm",
+                onPassword,
+            },
+            exitCode: 0,
+        };
     },
 };

package/dist/commands/df.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Report filesystem disk space usage.
+ * @category system
+ * @params ["[-h]"]
+ */
 export declare const dfCommand: ShellModule;
 //# sourceMappingURL=df.d.ts.map

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

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

package/dist/commands/df.js

@@ -1,3 +1,8 @@
+/**
+ * Report filesystem disk space usage.
+ * @category system
+ * @params ["[-h]"]
+ */
 export const dfCommand = {
     name: "df",
     description: "Report filesystem disk space usage",

package/dist/commands/du.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Estimate file and directory space usage.
+ * @category system
+ * @params ["[-h] [-s] [path]"]
+ */
 export declare const duCommand: ShellModule;
 //# sourceMappingURL=du.d.ts.map

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

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

package/dist/commands/du.js

@@ -1,5 +1,10 @@
 import { ifFlag } from "./command-helpers";
 import { resolvePath } from "./helpers";
+/**
+ * Estimate file and directory space usage.
+ * @category system
+ * @params ["[-h] [-s] [path]"]
+ */
 export const duCommand = {
     name: "du",
     description: "Estimate file space usage",