typescript-virtual-container 1.3.4 → 1.4.0

package/dist/commands/su.js

@@ -1,25 +1,56 @@
-import { getArg } from "./command-helpers";
+import { runCommand } from "./runtime";
+/**
+ * Switch to another user account.
+ *
+ * Usage:
+ *   su [username]        — switch to username (defaults to root)
+ *   su - [username]      — login shell (changes cwd to target home)
+ *   su -c 'cmd' [user]   — run command as user
+ *
+ * - Root can switch to any user without a password.
+ * - Non-root sudoers must enter the target user's password.
+ * - Non-sudoers are denied.
+ * - Switching to a non-existent user returns an error immediately.
+ */
 export const suCommand = {
     name: "su",
     description: "Switch user",
     category: "users",
-    params: ["- <username>"],
-    run: ({ authUser, shell, args }) => {
-        const users = shell.users;
-        const targetUser = getArg(args, 0, { flags: ["-"] });
-        if (!targetUser) {
-            return { stderr: "su: missing username", exitCode: 1 };
+    params: ["[-] [-c <cmd>] [username]"],
+    run: async ({ authUser, shell, args, hostname, mode, cwd }) => {
+        const loginShellFlag = args.includes("-") || args.includes("-l") || args.includes("--login");
+        const cIdx = args.indexOf("-c");
+        const cmdLine = cIdx !== -1 ? args[cIdx + 1] : undefined;
+        const filteredArgs = args.filter((_, i) => i !== cIdx && i !== cIdx + 1).filter((a) => a !== "-" && a !== "-l" && a !== "--login");
+        const targetUser = filteredArgs.find((a) => !a.startsWith("-")) ?? "root";
+        // Verify target user exists
+        if (!shell.users.listUsers().includes(targetUser)) {
+            return { stderr: `su: user '${targetUser}' does not exist\n`, exitCode: 1 };
         }
-        if (!users.isSudoer(authUser) && authUser !== "root") {
-            return { stderr: "su: permission denied", exitCode: 1 };
+        // Root switches freely without any password
+        if (authUser === "root") {
+            if (cmdLine) {
+                return runCommand(cmdLine, targetUser, hostname, mode, loginShellFlag ? `/home/${targetUser}` : cwd, shell);
+            }
+            return {
+                switchUser: targetUser,
+                nextCwd: loginShellFlag ? `/home/${targetUser}` : undefined,
+                exitCode: 0,
+            };
         }
-        if (!users.verifyPassword(targetUser, getArg(args, 1) ?? "") &&
-            authUser !== "root") {
-            return { stderr: "su: authentication failure", exitCode: 1 };
+        // Non-sudoers denied
+        if (!shell.users.isSudoer(authUser)) {
+            return { stderr: "su: permission denied\n", exitCode: 1 };
         }
+        // Sudoers must enter target user's password via challenge
         return {
-            switchUser: targetUser,
-            nextCwd: `/home/${targetUser}`,
+            sudoChallenge: {
+                username: targetUser,
+                targetUser,
+                commandLine: cmdLine ?? null,
+                loginShell: loginShellFlag,
+                prompt: "Password: ",
+            },
             exitCode: 0,
         };
     },

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

@@ -1 +1 @@
-{"version":3,"file":"sudo.d.ts","sourceRoot":"","sources":["../../src/commands/sudo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAqBrD,eAAO,MAAM,WAAW,EAAE,WAiDzB,CAAC"}
+{"version":3,"file":"sudo.d.ts","sourceRoot":"","sources":["../../src/commands/sudo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA0BrD,eAAO,MAAM,WAAW,EAAE,WAiDzB,CAAC"}

package/dist/commands/sudo.js

@@ -1,5 +1,10 @@
 import { parseArgs } from "./command-helpers";
 import { runCommand } from "./runtime";
+/**
+ * Execute a command as another user (superuser by default).
+ * @category users
+ * @params ["[-u user] [-c cmd] [command]"]
+ */
 function parseSudoArgs(args) {
     const { flags, flagsWithValues, positionals } = parseArgs(args, {
         flags: ["-i", "-S"],

package/dist/commands/tail.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Output the last part of files or stdin.
+ * @category text
+ * @params ["[-n <lines>] [file...]"]
+ */
 export declare const tailCommand: ShellModule;
 //# sourceMappingURL=tail.d.ts.map

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

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

package/dist/commands/tail.js

@@ -1,5 +1,10 @@
 import { getFlag } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Output the last part of files or stdin.
+ * @category text
+ * @params ["[-n <lines>] [file...]"]
+ */
 export const tailCommand = {
     name: "tail",
     description: "Output last lines",
@@ -7,11 +12,18 @@ export const tailCommand = {
     params: ["[-n <lines>] [file...]"],
     run: ({ authUser, shell, cwd, args, stdin }) => {
         const nArg = getFlag(args, ["-n"]);
-        const n = typeof nArg === "string" ? parseInt(nArg, 10) : 10;
-        const positionals = args.filter((a) => !a.startsWith("-") && a !== nArg);
+        const shortN = args.find((a) => /^-\d+$/.test(a));
+        const n = typeof nArg === "string"
+            ? parseInt(nArg, 10)
+            : shortN ? parseInt(shortN.slice(1), 10) : 10;
+        const positionals = args.filter((a) => !a.startsWith("-") && a !== nArg && a !== String(n));
         const take = (content) => {
             const lines = content.split("\n");
-            return lines.slice(Math.max(0, lines.length - n)).join("\n");
+            // If content ends with \n, last element is ""; exclude from count
+            const hasTrailingNewline = content.endsWith("\n");
+            const meaningful = hasTrailingNewline ? lines.slice(0, -1) : lines;
+            const sliced = meaningful.slice(Math.max(0, meaningful.length - n));
+            return sliced.join("\n") + (hasTrailingNewline ? "\n" : "");
         };
         if (positionals.length === 0) {
             return { stdout: take(stdin ?? ""), exitCode: 0 };

package/dist/commands/tar.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Archive or extract files with tar and optional gzip compression.
+ * @category archive
+ * @params ["[-czf|-xzf|-tf] <archive> [files...]"]
+ */
 export declare const tarCommand: ShellModule;
 //# sourceMappingURL=tar.d.ts.map

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

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

package/dist/commands/tar.js

@@ -1,23 +1,53 @@
-import { ifFlag } from "./command-helpers";
 import { resolvePath } from "./helpers";
+/**
+ * Archive or extract files with tar and optional gzip compression.
+ * @category archive
+ * @params ["[-czf|-xzf|-tf] <archive> [files...]"]
+ */
 export const tarCommand = {
     name: "tar",
     description: "Archive utility",
     category: "archive",
     params: ["[-czf|-xzf|-tf] <archive> [files...]"],
     run: ({ authUser, shell, cwd, args }) => {
-        const create = ifFlag(args, ["-c"]);
-        const extract = ifFlag(args, ["-x"]);
-        const list = ifFlag(args, ["-t"]);
-        const fFlag = args.findIndex((a) => a.includes("f"));
-        const archiveName = fFlag !== -1
-            ? args[fFlag + 1]
-            : args.find((a) => a.endsWith(".tar") || a.endsWith(".tar.gz") || a.endsWith(".tgz"));
+        // Expand combined flags: -czf or czf (bare mode string) → ["-c", "-z", "-f"]
+        const expanded = [];
+        let foundModeStr = false;
+        for (const a of args) {
+            if (/^-[a-zA-Z]{2,}$/.test(a)) {
+                // -czf style
+                for (const ch of a.slice(1))
+                    expanded.push(`-${ch}`);
+            }
+            else if (!foundModeStr && /^[cxtdru]{1,}[a-zA-Z]*$/.test(a) && !a.includes("/") && !a.startsWith("-")) {
+                // czf bare style (first non-path arg)
+                foundModeStr = true;
+                for (const ch of a)
+                    expanded.push(`-${ch}`);
+            }
+            else {
+                expanded.push(a);
+            }
+        }
+        const create = expanded.includes("-c");
+        const extract = expanded.includes("-x");
+        const list = expanded.includes("-t");
+        const fIdx = expanded.indexOf("-f");
+        const archiveName = fIdx !== -1
+            ? expanded[fIdx + 1]
+            : expanded.find((a) => a.endsWith(".tar") || a.endsWith(".tar.gz") || a.endsWith(".tgz"));
+        if (!create && !extract && !list) {
+            return { stderr: "tar: must specify -c, -x, or -t\n", exitCode: 1 };
+        }
         if (!archiveName)
-            return { stderr: "tar: no archive specified", exitCode: 1 };
+            return { stderr: "tar: no archive specified\n", exitCode: 1 };
         const archivePath = resolvePath(cwd, archiveName);
         if (create) {
-            const fileArgs = args.filter((a) => !a.startsWith("-") && a !== archiveName);
+            // Skip flags and archive name from file list
+            const skipNext2 = new Set();
+            if (fIdx !== -1)
+                skipNext2.add(fIdx + 1);
+            const fileArgs = expanded.filter((a, i) => !a.startsWith("-") && a !== archiveName && !skipNext2.has(i));
             const entries = {};
             for (const f of fileArgs) {
                 const p = resolvePath(cwd, f);

package/dist/commands/tee.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Read stdin and write to stdout and files simultaneously.
+ * @category text
+ * @params ["[-a] <file...>"]
+ */
 export declare const teeCommand: ShellModule;
 //# sourceMappingURL=tee.d.ts.map

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

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

package/dist/commands/tee.js

@@ -1,5 +1,10 @@
 import { ifFlag } from "./command-helpers";
 import { resolvePath } from "./helpers";
+/**
+ * Read stdin and write to stdout and files simultaneously.
+ * @category text
+ * @params ["[-a] <file...>"]
+ */
 export const teeCommand = {
     name: "tee",
     description: "Read stdin, write to stdout and files",

package/dist/commands/touch.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Create empty files or update file timestamps.
+ * @category files
+ * @params ["<file>"]
+ */
 export declare const touchCommand: ShellModule;
 //# sourceMappingURL=touch.d.ts.map

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

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

package/dist/commands/touch.js

@@ -1,4 +1,9 @@
 import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Create empty files or update file timestamps.
+ * @category files
+ * @params ["<file>"]
+ */
 export const touchCommand = {
     name: "touch",
     description: "Create or update files",

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

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

package/dist/commands/tr.js

@@ -1,25 +1,60 @@
 import { ifFlag } from "./command-helpers";
+function unescapeTrSet(s) {
+    return s
+        .replace(/\\n/g, "\n")
+        .replace(/\\t/g, "\t")
+        .replace(/\\r/g, "\r")
+        .replace(/\\\\/g, "\\");
+}
+function expandTrSet(s) {
+    const chars = [];
+    const unescaped = unescapeTrSet(s);
+    let i = 0;
+    while (i < unescaped.length) {
+        // Range: a-z, A-Z, 0-9
+        if (i + 2 < unescaped.length && unescaped[i + 1] === "-") {
+            const from = unescaped.charCodeAt(i);
+            const to = unescaped.charCodeAt(i + 2);
+            if (from <= to) {
+                for (let c = from; c <= to; c++)
+                    chars.push(String.fromCharCode(c));
+                i += 3;
+                continue;
+            }
+        }
+        chars.push(unescaped[i]);
+        i++;
+    }
+    return chars;
+}
 export const trCommand = {
     name: "tr",
     description: "Translate or delete characters",
     category: "text",
-    params: ["[-d] <set1> [set2]"],
+    params: ["[-d] [-s] <set1> [set2]"],
     run: ({ args, stdin }) => {
         const del = ifFlag(args, ["-d"]);
+        const squeeze = ifFlag(args, ["-s"]);
         const positionals = args.filter((a) => !a.startsWith("-"));
-        const set1 = positionals[0] ?? "";
-        const set2 = positionals[1] ?? "";
+        const set1chars = expandTrSet(positionals[0] ?? "");
+        const set2chars = expandTrSet(positionals[1] ?? "");
         let input = stdin ?? "";
         if (del) {
-            for (const c of set1)
-                input = input.split(c).join("");
+            const deleteSet = new Set(set1chars);
+            input = [...input].filter((c) => !deleteSet.has(c)).join("");
         }
-        else if (set2) {
-            for (let i = 0; i < set1.length; i++) {
-                input = input
-                    .split(set1[i])
-                    .join(set2[i] ?? set2[set2.length - 1] ?? "");
+        else if (set2chars.length > 0) {
+            // Build translation map
+            const map = new Map();
+            for (let i = 0; i < set1chars.length; i++) {
+                map.set(set1chars[i], set2chars[i] ?? set2chars[set2chars.length - 1] ?? "");
             }
+            input = [...input].map((c) => map.get(c) ?? c).join("");
+        }
+        if (squeeze && set2chars.length > 0) {
+            // Squeeze repeated characters in set2
+            const squeezeSet = new Set(set2chars);
+            input = input.replace(/(.)\1+/g, (_, c) => squeezeSet.has(c) ? c : _);
         }
         return { stdout: input, exitCode: 0 };
     },

package/dist/commands/tree.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Display directory structure in a tree format.
+ * @category navigation
+ * @params ["[path]"]
+ */
 export declare const treeCommand: ShellModule;
 //# sourceMappingURL=tree.d.ts.map

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

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

package/dist/commands/tree.js

@@ -1,5 +1,10 @@
 import { getArg } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Display directory structure in a tree format.
+ * @category navigation
+ * @params ["[path]"]
+ */
 export const treeCommand = {
     name: "tree",
     description: "Display directory tree",

package/dist/commands/true.d.ts

@@ -1,4 +1,14 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Always return success (exit code 0).
+ * @category shell
+ * @params []
+ */
 export declare const trueCommand: ShellModule;
+/**
+ * Always return failure (exit code 1).
+ * @category shell
+ * @params []
+ */
 export declare const falseCommand: ShellModule;
 //# sourceMappingURL=true.d.ts.map

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

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

package/dist/commands/true.js

@@ -1,3 +1,8 @@
+/**
+ * Always return success (exit code 0).
+ * @category shell
+ * @params []
+ */
 export const trueCommand = {
     name: "true",
     description: "Return success exit code",
@@ -5,6 +10,11 @@ export const trueCommand = {
     params: [],
     run: () => ({ exitCode: 0 }),
 };
+/**
+ * Always return failure (exit code 1).
+ * @category shell
+ * @params []
+ */
 export const falseCommand = {
     name: "false",
     description: "Return failure exit code",

package/dist/commands/type.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Describe how a command name would be interpreted (builtin, function, or file).
+ * @category shell
+ * @params ["<command...>"]
+ */
 export declare const typeCommand: ShellModule;
 //# sourceMappingURL=type.d.ts.map

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

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

package/dist/commands/type.js

@@ -1,4 +1,9 @@
 import { resolveModule } from "./registry";
+/**
+ * Describe how a command name would be interpreted (builtin, function, or file).
+ * @category shell
+ * @params ["<command...>"]
+ */
 export const typeCommand = {
     name: "type",
     description: "Describe how a command would be interpreted",

package/dist/commands/uname.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Print system information (kernel name, version, machine type).
+ * @category system
+ * @params ["[-a] [-s] [-r] [-m]"]
+ */
 export declare const unameCommand: ShellModule;
 //# sourceMappingURL=uname.d.ts.map

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

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

package/dist/commands/uname.js

@@ -1,4 +1,9 @@
 import { ifFlag } from "./command-helpers";
+/**
+ * Print system information (kernel name, version, machine type).
+ * @category system
+ * @params ["[-a] [-s] [-r] [-m]"]
+ */
 export const unameCommand = {
     name: "uname",
     description: "Print system information",

package/dist/commands/uniq.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Report or filter out repeated consecutive lines.
+ * @category text
+ * @params ["[-c] [-d] [-u] [file]"]
+ */
 export declare const uniqCommand: ShellModule;
 //# sourceMappingURL=uniq.d.ts.map

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

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

package/dist/commands/uniq.js

@@ -1,4 +1,9 @@
 import { ifFlag } from "./command-helpers";
+/**
+ * Report or filter out repeated consecutive lines.
+ * @category text
+ * @params ["[-c] [-d] [-u] [file]"]
+ */
 export const uniqCommand = {
     name: "uniq",
     description: "Report or filter out repeated lines",

package/dist/commands/unset.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Remove shell variable from the environment.
+ * @category shell
+ * @params ["<VAR>"]
+ */
 export declare const unsetCommand: ShellModule;
 //# sourceMappingURL=unset.d.ts.map

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

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

package/dist/commands/unset.js

@@ -1,3 +1,8 @@
+/**
+ * Remove shell variable from the environment.
+ * @category shell
+ * @params ["<VAR>"]
+ */
 export const unsetCommand = {
     name: "unset",
     description: "Remove shell variable",

package/dist/commands/uptime.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Tell how long the system has been running.
+ * @category system
+ * @params ["[-p] [-s]"]
+ */
 export declare const uptimeCommand: ShellModule;
 //# sourceMappingURL=uptime.d.ts.map

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

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

package/dist/commands/uptime.js

@@ -1,4 +1,9 @@
 import { ifFlag } from "./command-helpers";
+/**
+ * Tell how long the system has been running.
+ * @category system
+ * @params ["[-p] [-s]"]
+ */
 export const uptimeCommand = {
     name: "uptime",
     description: "Tell how long the system has been running",

package/dist/commands/wc.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Count words, lines, and/or bytes in files or stdin.
+ * @category text
+ * @params ["[-l] [-w] [-c] [file...]"]
+ */
 export declare const wcCommand: ShellModule;
 //# sourceMappingURL=wc.d.ts.map

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

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

package/dist/commands/wc.js

@@ -1,5 +1,10 @@
 import { ifFlag } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Count words, lines, and/or bytes in files or stdin.
+ * @category text
+ * @params ["[-l] [-w] [-c] [file...]"]
+ */
 export const wcCommand = {
     name: "wc",
     description: "Count words/lines/bytes",

package/dist/commands/wget.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Download files from the web (fetch-based implementation).
+ * @category network
+ * @params ["[options] <url>"]
+ */
 export declare const wgetCommand: ShellModule;
 //# sourceMappingURL=wget.d.ts.map

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

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

package/dist/commands/wget.js

@@ -1,5 +1,10 @@
 import { ifFlag, parseArgs } from "./command-helpers";
 import { assertPathAccess, resolvePath, stripUrlFilename } from "./helpers";
+/**
+ * Download files from the web (fetch-based implementation).
+ * @category network
+ * @params ["[options] <url>"]
+ */
 export const wgetCommand = {
     name: "wget",
     description: "File downloader (pure fetch)",

package/dist/commands/who.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Show active user sessions.
+ * @category system
+ * @params []
+ */
 export declare const whoCommand: ShellModule;
 //# sourceMappingURL=who.d.ts.map

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

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

package/dist/commands/who.js

@@ -1,4 +1,9 @@
 import { formatLoginDate } from "../SSHMimic/loginFormat";
+/**
+ * Show active user sessions.
+ * @category system
+ * @params []
+ */
 export const whoCommand = {
     name: "who",
     description: "Show active sessions",