typescript-virtual-container 1.3.4 → 1.4.1

package/dist/commands/shift.js

@@ -1,3 +1,8 @@
+/**
+ * Shift positional parameters (remove first N arguments).
+ * @category shell
+ * @params ["[n]"]
+ */
 export const shiftCommand = {
     name: "shift",
     description: "Shift positional parameters",
@@ -20,6 +25,11 @@ export const shiftCommand = {
         return { exitCode: 0 };
     },
 };
+/**
+ * Trap signals and execute actions on signal receipt or shell exit.
+ * @category shell
+ * @params ["[action] [signal...]"]
+ */
 export const trapCommand = {
     name: "trap",
     description: "Trap signals and events",

package/dist/commands/sleep.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Delay execution for a specified number of seconds.
+ * @category system
+ * @params ["<seconds>"]
+ */
 export declare const sleepCommand: ShellModule;
 //# sourceMappingURL=sleep.d.ts.map

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

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

package/dist/commands/sleep.js

@@ -1,3 +1,8 @@
+/**
+ * Delay execution for a specified number of seconds.
+ * @category system
+ * @params ["<seconds>"]
+ */
 export const sleepCommand = {
     name: "sleep",
     description: "Delay execution",

package/dist/commands/sort.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Sort lines of text with various options (reverse, numeric, unique).
+ * @category text
+ * @params ["[-r] [-n] [-u] [-k <col>] [file...]"]
+ */
 export declare const sortCommand: ShellModule;
 //# sourceMappingURL=sort.d.ts.map

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

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

package/dist/commands/sort.js

@@ -1,5 +1,10 @@
 import { ifFlag } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Sort lines of text with various options (reverse, numeric, unique).
+ * @category text
+ * @params ["[-r] [-n] [-u] [-k <col>] [file...]"]
+ */
 export const sortCommand = {
     name: "sort",
     description: "Sort lines of text",

package/dist/commands/source.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Execute commands from a file in the current shell environment.
+ * @category shell
+ * @params ["<file> [args...]"]
+ */
 export declare const sourceCommand: ShellModule;
 //# sourceMappingURL=source.d.ts.map

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

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

package/dist/commands/source.js

@@ -1,5 +1,10 @@
 import { resolvePath } from "./helpers";
 import { runCommand } from "./runtime";
+/**
+ * Execute commands from a file in the current shell environment.
+ * @category shell
+ * @params ["<file> [args...]"]
+ */
 export const sourceCommand = {
     name: "source",
     aliases: ["."],

package/dist/commands/stat.d.ts

@@ -0,0 +1,7 @@
+import type { ShellModule } from "../types/commands";
+/**
+ * Display file or filesystem status.
+ * Outputs: path, size, mode, type, timestamps — similar to `stat` on Linux.
+ */
+export declare const statCommand: ShellModule;
+//# sourceMappingURL=stat.d.ts.map

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

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

package/dist/commands/stat.js

@@ -0,0 +1,56 @@
+import { resolvePath } from "./helpers";
+/**
+ * Display file or filesystem status.
+ * Outputs: path, size, mode, type, timestamps — similar to `stat` on Linux.
+ */
+export const statCommand = {
+    name: "stat",
+    description: "Display file status",
+    category: "files",
+    params: ["[-c <format>] <file>"],
+    run: ({ shell, cwd, args }) => {
+        const fmtIdx = args.findIndex((a) => a === "-c" || a === "--format");
+        const fmt = fmtIdx !== -1 ? args[fmtIdx + 1] : undefined;
+        const file = args.find((a) => !a.startsWith("-") && a !== fmt);
+        if (!file)
+            return { stderr: "stat: missing operand\n", exitCode: 1 };
+        const p = resolvePath(cwd, file);
+        if (!shell.vfs.exists(p)) {
+            return { stderr: `stat: cannot stat '${file}': No such file or directory\n`, exitCode: 1 };
+        }
+        const st = shell.vfs.stat(p);
+        const isDir = st.type === "directory";
+        const _isLink = shell.vfs.isSymlink(p);
+        const isSymlink = shell.vfs.isSymlink(p);
+        const modePerm = (mode) => {
+            const bits = [0o400, 0o200, 0o100, 0o040, 0o020, 0o010, 0o004, 0o002, 0o001];
+            const syms = ["r", "w", "x", "r", "w", "x", "r", "w", "x"];
+            return (isDir ? "d" : isSymlink ? "l" : "-") +
+                bits.map((b, i) => mode & b ? syms[i] : "-").join("");
+        };
+        const octal = (st.mode).toString(8).padStart(4, "0");
+        const modeStr = modePerm(st.mode);
+        const size = "size" in st ? st.size : 0;
+        const ts = (d) => d.toISOString().replace("T", " ").replace(/\.\d+Z$/, " +0000");
+        // -c format string support
+        if (fmt) {
+            const out = fmt
+                .replace("%n", file)
+                .replace("%s", String(size))
+                .replace("%a", octal.slice(1)) // access in octal (no leading 0)
+                .replace("%A", modeStr)
+                .replace("%F", isSymlink ? "symbolic link" : isDir ? "directory" : "regular file")
+                .replace("%y", ts(st.updatedAt))
+                .replace("%z", ts(st.updatedAt));
+            return { stdout: `${out}\n`, exitCode: 0 };
+        }
+        const out = [
+            `  File: ${file}${isSymlink ? ` -> ${shell.vfs.resolveSymlink(p)}` : ""}`,
+            `  Size: ${size}${"\t".repeat(3)}${isSymlink ? "symbolic link" : isDir ? "directory" : "regular file"}`,
+            `Access: (${octal}/${modeStr})  Uid: (    0/    root)   Gid: (    0/    root)`,
+            `Modify: ${ts(st.updatedAt)}`,
+            `Change: ${ts(st.updatedAt)}`,
+        ].join("\n");
+        return { stdout: `${out}\n`, exitCode: 0 };
+    },
+};

package/dist/commands/su.d.ts

@@ -1,3 +1,16 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * 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 declare const suCommand: ShellModule;
 //# sourceMappingURL=su.d.ts.map

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

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

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",