typescript-virtual-container 1.5.11 → 1.6.0

package/dist/commands/manuals-bundle.js

@@ -209,6 +209,17 @@ EXAMPLES
        mount | column -t
        cat /etc/passwd | column -t -s:
        column -t file.txt`,
+    "comm": `COMM(1)                  User Commands                  COMM(1)
+
+NAME
+       comm - compare two sorted files line by line
+
+SYNOPSIS
+       comm [OPTION]... FILE1 FILE2
+
+DESCRIPTION
+       Compare FILE1 and FILE2 line by line, producing
+       three-column output of common and unique lines.`,
     "cowsay": `COWSAY(1)                User Commands                  COWSAY(1)
 
 NAME
@@ -240,6 +251,17 @@ SYNOPSIS
 
 OPTIONS
        -r     copy directories recursively`,
+    "csplit": `CSPLIT(1)                User Commands                CSPLIT(1)
+
+NAME
+       csplit - split a file into pieces by context
+
+SYNOPSIS
+       csplit [OPTION]... FILE PATTERN...
+
+DESCRIPTION
+       Split FILE into pieces based on context lines
+       matching PATTERN, creating numbered output files.`,
     "curl": `CURL(1)                  User Commands                    CURL(1)
 
 NAME
@@ -292,6 +314,18 @@ DESCRIPTION
 EXAMPLES
        date
        date +%Y-%m-%d`,
+    "dd": `DD(1)                    User Commands                    DD(1)
+
+NAME
+       dd - convert and copy a file
+
+SYNOPSIS
+       dd [OPERAND...]
+
+DESCRIPTION
+       Copy a file with optional conversions.  Operands
+       specify input file, output file, block size, and
+       count.`,
     "declare": `DECLARE(1)               Shell Builtins               DECLARE(1)
 
 NAME
@@ -464,6 +498,17 @@ EXAMPLES
        exit       # exit with last command's status
        exit 0     # exit successfully
        exit 1     # exit with error`,
+    "expand": `EXPAND(1)                User Commands                EXPAND(1)
+
+NAME
+       expand - convert tabs to spaces
+
+SYNOPSIS
+       expand [OPTION]... [FILE...]
+
+DESCRIPTION
+       Convert tabs in each FILE to spaces, writing to
+       standard output.`,
     "export": `EXPORT(1)                User Commands                   EXPORT(1)
 
 NAME
@@ -484,6 +529,17 @@ EXAMPLES
        export PATH="$PATH:/usr/local/bin"
        export NODE_ENV=production
        export -p`,
+    "expr": `EXPR(1)                  User Commands                  EXPR(1)
+
+NAME
+       expr - evaluate arithmetic expressions
+
+SYNOPSIS
+       expr EXPRESSION
+
+DESCRIPTION
+       Evaluate an EXPRESSION and print its result.
+       Supports arithmetic, string, and logical operators.`,
     "false": `FALSE(1)                 User Commands                   FALSE(1)
 
 NAME
@@ -526,6 +582,28 @@ SYNOPSIS
 OPTIONS
        -name PATTERN   base name matches shell PATTERN
        -type TYPE      file type, e.g. f for file, d for directory`,
+    "fmt": `FMT(1)                   User Commands                   FMT(1)
+
+NAME
+       fmt - simple text formatter
+
+SYNOPSIS
+       fmt [OPTION]... [FILE...]
+
+DESCRIPTION
+       Reformat paragraphs from each FILE to a specified
+       width, filling and joining lines.`,
+    "fold": `FOLD(1)                  User Commands                  FOLD(1)
+
+NAME
+       fold - wrap each input line to fit specified width
+
+SYNOPSIS
+       fold [OPTION]... [FILE...]
+
+DESCRIPTION
+       Wrap lines from each FILE to a specified width
+       (default 80), breaking at character boundaries.`,
     "fortune": `FORTUNE(6)               Games and Amusements          FORTUNE(6)
 
 NAME
@@ -710,6 +788,17 @@ EXAMPLES
        ip addr show eth0        # show eth0 address
        ip route                 # show routing table
        ip link                  # show link info`,
+    "join": `JOIN(1)                  User Commands                  JOIN(1)
+
+NAME
+       join - join lines of two files on a common field
+
+SYNOPSIS
+       join [OPTION]... FILE1 FILE2
+
+DESCRIPTION
+       Join lines from FILE1 and FILE2 based on a common
+       field, writing to standard output.`,
     "kill": `KILL(1)                  User Commands                    KILL(1)
 
 NAME
@@ -800,6 +889,39 @@ EXAMPLES
        lsb_release -a
        lsb_release -d
        lsb_release -rs`,
+    "lscpu": `LSCPU(1)                 User Commands                 LSCPU(1)
+
+NAME
+       lscpu - display CPU architecture information
+
+SYNOPSIS
+       lscpu
+
+DESCRIPTION
+       Display information about the CPU architecture,
+       including cores, threads, caches, and flags.`,
+    "lspci": `LSPCI(1)                 User Commands                 LSPCI(1)
+
+NAME
+       lspci - list PCI devices
+
+SYNOPSIS
+       lspci [OPTION]...
+
+DESCRIPTION
+       Display information about PCI buses and devices
+       connected to the system.`,
+    "lsusb": `LSUSB(1)                 User Commands                 LSUSB(1)
+
+NAME
+       lsusb - list USB devices
+
+SYNOPSIS
+       lsusb [OPTION]...
+
+DESCRIPTION
+       Display information about USB buses and devices
+       connected to the system.`,
     "man": `MAN(1)                   User Commands                     MAN(1)
 
 NAME
@@ -822,6 +944,16 @@ EXAMPLES
        man ls
        man 1 printf
        man grep`,
+    "md5sum": `MD5SUM(1)                User Commands                MD5SUM(1)
+
+NAME
+       md5sum - compute and check MD5 message digest
+
+SYNOPSIS
+       md5sum [FILE...]
+
+DESCRIPTION
+       Print or check MD5 (128-bit) checksums for each FILE.`,
     "mkdir": `MKDIR(1)                 User Commands                  MKDIR(1)
 
 NAME
@@ -878,6 +1010,17 @@ SYNOPSIS
 DESCRIPTION
        Open FILE in an interactive editor.
        Save with Ctrl+O, exit with Ctrl+X.`,
+    "nc": `NC(1)                    User Commands                    NC(1)
+
+NAME
+       nc - arbitrary TCP and UDP connections
+
+SYNOPSIS
+       nc [OPTION]... HOST PORT
+
+DESCRIPTION
+       Open TCP or UDP connections to arbitrary ports,
+       useful for debugging and network exploration.`,
     "neofetch": `NEOFETCH(1)              User Commands                NEOFETCH(1)
 
 NAME
@@ -888,6 +1031,17 @@ SYNOPSIS
 
 DESCRIPTION
        Print OS, kernel, uptime, package count, and related system details.`,
+    "nice": `NICE(1)                  User Commands                  NICE(1)
+
+NAME
+       nice - run a command with modified niceness
+
+SYNOPSIS
+       nice [OPTION]... COMMAND [ARG...]
+
+DESCRIPTION
+       Run COMMAND with an adjusted scheduling priority
+       (niceness).  Higher niceness means lower priority.`,
     "nl": `NL(1)                    User Commands                      NL(1)
 
 NAME
@@ -925,6 +1079,17 @@ DESCRIPTION
 
 NOTES
        Requires package installation: apt install nodejs.`,
+    "nohup": `NOHUP(1)                 User Commands                 NOHUP(1)
+
+NAME
+       nohup - run a command immune to hangups
+
+SYNOPSIS
+       nohup COMMAND [ARG...]
+
+DESCRIPTION
+       Run COMMAND such that it ignores HUP signals and
+       continues running after the terminal is closed.`,
     "npm": `NPM(1)                   User Commands                      NPM(1)
 
 NAME
@@ -1035,6 +1200,17 @@ EXAMPLES
        paste file1 file2
        paste -d: /etc/passwd /etc/shadow
        paste -d, a.txt b.txt c.txt`,
+    "pgrep": `PGREP(1)                 User Commands                 PGREP(1)
+
+NAME
+       pgrep - look up processes by pattern
+
+SYNOPSIS
+       pgrep [OPTION]... PATTERN
+
+DESCRIPTION
+       List process IDs matching PATTERN.  By default
+       matches against process names.`,
     "ping": `PING(8)                   User Commands                   PING(8)
 
 NAME
@@ -1045,6 +1221,17 @@ SYNOPSIS
 
 OPTIONS
        -c COUNT    stop after sending COUNT packets`,
+    "pkill": `PKILL(1)                 User Commands                 PKILL(1)
+
+NAME
+       pkill - kill processes by pattern
+
+SYNOPSIS
+       pkill [OPTION]... PATTERN
+
+DESCRIPTION
+       Send signals to processes matching PATTERN.  By
+       default sends SIGTERM.`,
     "printf": `PRINTF(1)                User Commands                  PRINTF(1)
 
 NAME
@@ -1118,6 +1305,17 @@ SYNOPSIS
 
 OPTIONS
        -f     canonicalize by following every symlink in every component`,
+    "realpath": `REALPATH(1)              User Commands              REALPATH(1)
+
+NAME
+       realpath - print resolved absolute file name
+
+SYNOPSIS
+       realpath [FILE...]
+
+DESCRIPTION
+       Print the resolved absolute path for each FILE,
+       with all symbolic links resolved.`,
     "return": `RETURN(1)                Shell Builtins                 RETURN(1)
 
 NAME
@@ -1214,6 +1412,17 @@ EXAMPLES
        sh -c 'echo hello'
        sh script.sh
        sh -c 'for i in 1 2 3; do echo $i; done'`,
+    "sha256sum": `SHA256SUM(1)             User Commands             SHA256SUM(1)
+
+NAME
+       sha256sum - compute and check SHA-256 message digest
+
+SYNOPSIS
+       sha256sum [FILE...]
+
+DESCRIPTION
+       Print or check SHA-256 (256-bit) checksums for each
+       FILE.`,
     "shift": `SHIFT(1)                 Shell Builtins                  SHIFT(1)
 
 NAME
@@ -1295,6 +1504,17 @@ SYNOPSIS
 
 DESCRIPTION
        Read and execute commands from FILE in the current shell context.`,
+    "split": `SPLIT(1)                 User Commands                 SPLIT(1)
+
+NAME
+       split - split a file into pieces
+
+SYNOPSIS
+       split [OPTION]... [FILE [PREFIX]]
+
+DESCRIPTION
+       Split FILE into fixed-size pieces, creating output
+       files named PREFIXaa, PREFIXab, etc.`,
     "ssh": `SSH(1)                   OpenSSH                          SSH(1)
 
 NAME
@@ -1316,6 +1536,17 @@ SYNOPSIS
 
 OPTIONS
        -c, --format=FORMAT   use the specified output format`,
+    "strings": `STRINGS(1)               User Commands               STRINGS(1)
+
+NAME
+       strings - print printable strings in binary files
+
+SYNOPSIS
+       strings [FILE...]
+
+DESCRIPTION
+       For each FILE, print sequences of printable
+       characters found in binary data.`,
     "stty": `STTY(1)                  User Commands                    STTY(1)
 
 NAME
@@ -1452,6 +1683,17 @@ EXIT STATUS
 EXAMPLES
        timeout 5 sleep 10
        timeout 30 curl http://example.com/`,
+    "top": `TOP(1)                   User Commands                   TOP(1)
+
+NAME
+       top - display process information
+
+SYNOPSIS
+       top [OPTION]...
+
+DESCRIPTION
+       Display a dynamic, real-time view of running
+       processes and system resource usage.`,
     "touch": `TOUCH(1)                 User Commands                  TOUCH(1)
 
 NAME

package/dist/commands/miscutils.d.ts

@@ -0,0 +1,43 @@
+import type { ShellModule } from "../types/commands";
+/**
+ * Resolve symlinks and print absolute path
+ * @category files
+ * @params ["<path>"]
+ */
+export declare const realpathCommand: ShellModule;
+/**
+ * Compute MD5 hash of a file
+ * @category text
+ * @params ["<file>"]
+ */
+export declare const md5sumCommand: ShellModule;
+/**
+ * Compute SHA256 hash of a file
+ * @category text
+ * @params ["<file>"]
+ */
+export declare const sha256sumCommand: ShellModule;
+/**
+ * Find printable strings in a file
+ * @category text
+ * @params ["<file>"]
+ */
+export declare const stringsCommand: ShellModule;
+/**
+ * Wrap lines to a specified width
+ * @category text
+ * @params ["[-w width] <file>"]
+ */
+export declare const foldCommand: ShellModule;
+/**
+ * Convert tabs to spaces
+ * @category text
+ * @params ["[-t tabs] <file>"]
+ */
+export declare const expandCommand: ShellModule;
+/**
+ * Simple text formatter
+ * @category text
+ * @params ["[-w width] <file>"]
+ */
+export declare const fmtCommand: ShellModule;

package/dist/commands/miscutils.js

@@ -0,0 +1,233 @@
+import { createHash } from "node:crypto";
+import * as path from "node:path";
+import { parseArgs } from "./command-helpers";
+import { resolvePath } from "./helpers";
+/**
+ * Resolve symlinks and print absolute path
+ * @category files
+ * @params ["<path>"]
+ */
+export const realpathCommand = {
+    name: "realpath",
+    description: "Resolve symlinks and print absolute path",
+    category: "files",
+    params: ["<path>"],
+    run: ({ shell, cwd, args }) => {
+        const target = args.find((a) => !a.startsWith("-"));
+        if (!target)
+            return { stderr: "realpath: missing operand\n", exitCode: 1 };
+        const p = resolvePath(cwd, target);
+        if (!shell.vfs.exists(p)) {
+            return { stderr: `realpath: ${target}: No such file or directory\n`, exitCode: 1 };
+        }
+        const resolved = shell.vfs.isSymlink(p)
+            ? shell.vfs.resolveSymlink(p)
+            : p;
+        return { stdout: path.posix.normalize(resolved) + "\n", exitCode: 0 };
+    },
+};
+/**
+ * Compute MD5 hash of a file
+ * @category text
+ * @params ["<file>"]
+ */
+export const md5sumCommand = {
+    name: "md5sum",
+    description: "Compute MD5 hash of a file",
+    category: "text",
+    params: ["<file>"],
+    run: ({ shell, cwd, args }) => {
+        const fileArg = args.find((a) => !a.startsWith("-"));
+        if (!fileArg)
+            return { stderr: "md5sum: missing file operand\n", exitCode: 1 };
+        const p = resolvePath(cwd, fileArg);
+        if (!shell.vfs.exists(p)) {
+            return { stderr: `md5sum: ${fileArg}: No such file or directory\n`, exitCode: 1 };
+        }
+        const content = shell.vfs.readFile(p);
+        const hash = createHash("md5").update(content).digest("hex");
+        return { stdout: `${hash}  ${fileArg}\n`, exitCode: 0 };
+    },
+};
+/**
+ * Compute SHA256 hash of a file
+ * @category text
+ * @params ["<file>"]
+ */
+export const sha256sumCommand = {
+    name: "sha256sum",
+    description: "Compute SHA256 hash of a file",
+    category: "text",
+    params: ["<file>"],
+    run: ({ shell, cwd, args }) => {
+        const fileArg = args.find((a) => !a.startsWith("-"));
+        if (!fileArg)
+            return { stderr: "sha256sum: missing file operand\n", exitCode: 1 };
+        const p = resolvePath(cwd, fileArg);
+        if (!shell.vfs.exists(p)) {
+            return { stderr: `sha256sum: ${fileArg}: No such file or directory\n`, exitCode: 1 };
+        }
+        const content = shell.vfs.readFile(p);
+        const hash = createHash("sha256").update(content).digest("hex");
+        return { stdout: `${hash}  ${fileArg}\n`, exitCode: 0 };
+    },
+};
+/**
+ * Find printable strings in a file
+ * @category text
+ * @params ["<file>"]
+ */
+export const stringsCommand = {
+    name: "strings",
+    description: "Find printable strings in a file",
+    category: "text",
+    params: ["<file>"],
+    run: ({ shell, cwd, args }) => {
+        const fileArg = args.find((a) => !a.startsWith("-"));
+        if (!fileArg)
+            return { stderr: "strings: missing file operand\n", exitCode: 1 };
+        const p = resolvePath(cwd, fileArg);
+        if (!shell.vfs.exists(p)) {
+            return { stderr: `strings: ${fileArg}: No such file or directory\n`, exitCode: 1 };
+        }
+        const buf = shell.vfs.readFileRaw(p);
+        let current = "";
+        const results = [];
+        for (let i = 0; i < buf.length; i++) {
+            const ch = buf[i];
+            if (ch >= 32 && ch <= 126) {
+                current += String.fromCharCode(ch);
+            }
+            else {
+                if (current.length >= 4)
+                    results.push(current);
+                current = "";
+            }
+        }
+        if (current.length >= 4)
+            results.push(current);
+        return { stdout: results.join("\n") + "\n", exitCode: 0 };
+    },
+};
+/**
+ * Wrap lines to a specified width
+ * @category text
+ * @params ["[-w width] <file>"]
+ */
+export const foldCommand = {
+    name: "fold",
+    description: "Wrap lines to a specified width",
+    category: "text",
+    params: ["[-w width] <file>"],
+    run: ({ shell, cwd, args, stdin }) => {
+        const { flagsWithValues, positionals } = parseArgs(args, {
+            flagsWithValue: ["-w"],
+        });
+        const width = parseInt(flagsWithValues.get("-w") || "80", 10);
+        const fileArg = positionals[0];
+        let input;
+        if (fileArg) {
+            const p = resolvePath(cwd, fileArg);
+            if (!shell.vfs.exists(p)) {
+                return { stderr: `fold: ${fileArg}: No such file or directory\n`, exitCode: 1 };
+            }
+            input = shell.vfs.readFile(p);
+        }
+        else {
+            input = stdin;
+        }
+        if (!input)
+            return { exitCode: 0 };
+        const lines = input.split("\n");
+        const folded = lines.map((line) => {
+            if (line.length <= width)
+                return line;
+            const parts = [];
+            for (let i = 0; i < line.length; i += width) {
+                parts.push(line.slice(i, i + width));
+            }
+            return parts.join("\n");
+        });
+        return { stdout: folded.join("\n"), exitCode: 0 };
+    },
+};
+/**
+ * Convert tabs to spaces
+ * @category text
+ * @params ["[-t tabs] <file>"]
+ */
+export const expandCommand = {
+    name: "expand",
+    description: "Convert tabs to spaces",
+    category: "text",
+    params: ["[-t tabs] <file>"],
+    run: ({ shell, cwd, args, stdin }) => {
+        const { flagsWithValues, positionals } = parseArgs(args, {
+            flagsWithValue: ["-t", "--tabs"],
+        });
+        const tabstop = parseInt(flagsWithValues.get("-t") || flagsWithValues.get("--tabs") || "8", 10);
+        const fileArg = positionals[0];
+        let input;
+        if (fileArg) {
+            const p = resolvePath(cwd, fileArg);
+            if (!shell.vfs.exists(p)) {
+                return { stderr: `expand: ${fileArg}: No such file or directory\n`, exitCode: 1 };
+            }
+            input = shell.vfs.readFile(p);
+        }
+        else {
+            input = stdin;
+        }
+        if (!input)
+            return { exitCode: 0 };
+        const expanded = input.replace(/\t/g, " ".repeat(tabstop));
+        return { stdout: expanded, exitCode: 0 };
+    },
+};
+/**
+ * Simple text formatter
+ * @category text
+ * @params ["[-w width] <file>"]
+ */
+export const fmtCommand = {
+    name: "fmt",
+    description: "Simple text formatter",
+    category: "text",
+    params: ["[-w width] <file>"],
+    run: ({ shell, cwd, args, stdin }) => {
+        const { flagsWithValues, positionals } = parseArgs(args, {
+            flagsWithValue: ["-w"],
+        });
+        const width = parseInt(flagsWithValues.get("-w") || "75", 10);
+        const fileArg = positionals[0];
+        let input;
+        if (fileArg) {
+            const p = resolvePath(cwd, fileArg);
+            if (!shell.vfs.exists(p)) {
+                return { stderr: `fmt: ${fileArg}: No such file or directory\n`, exitCode: 1 };
+            }
+            input = shell.vfs.readFile(p);
+        }
+        else {
+            input = stdin;
+        }
+        if (!input)
+            return { exitCode: 0 };
+        const words = input.replace(/\n/g, " ").split(/\s+/).filter(Boolean);
+        const lines = [];
+        let current = "";
+        for (const word of words) {
+            if (current.length + word.length + (current ? 1 : 0) > width) {
+                if (current)
+                    lines.push(current);
+                current = word;
+            }
+            else {
+                current = current ? `${current} ${word}` : word;
+            }
+        }
+        if (current)
+            lines.push(current);
+        return { stdout: lines.join("\n") + "\n", exitCode: 0 };
+    },
+};

package/dist/commands/mkdir.js

@@ -1,5 +1,6 @@
+import * as path from "node:path";
 import { getArg } from "./command-helpers";
-import { assertPathAccess, resolvePath } from "./helpers";
+import { checkFilePermission, resolvePath } from "./helpers";
 /**
  * Create one or more directories.
  * @category files
@@ -20,7 +21,7 @@ export const mkdirCommand = {
                 return { stderr: "mkdir: missing operand", exitCode: 1 };
             }
             const target = resolvePath(cwd, dir);
-            assertPathAccess(authUser, target, "mkdir");
+            checkFilePermission(shell.vfs, shell.users, authUser, path.posix.dirname(target), 2);
             shell.vfs.mkdir(target);
         }
         return { exitCode: 0 };

package/dist/commands/mv.js

@@ -1,4 +1,5 @@
-import { assertPathAccess, resolvePath } from "./helpers";
+import * as path from "node:path";
+import { checkFilePermission, resolvePath } from "./helpers";
 /**
  * Move or rename files and directories.
  * @category files
@@ -18,8 +19,8 @@ export const mvCommand = {
         const srcPath = resolvePath(cwd, srcArg);
         const destPath = resolvePath(cwd, destArg);
         try {
-            assertPathAccess(authUser, srcPath, "mv");
-            assertPathAccess(authUser, destPath, "mv");
+            checkFilePermission(shell.vfs, shell.users, authUser, srcPath, 2);
+            checkFilePermission(shell.vfs, shell.users, authUser, path.posix.dirname(destPath), 2);
             if (!shell.vfs.exists(srcPath)) {
                 return {
                     stderr: `mv: ${srcArg}: No such file or directory`,

package/dist/commands/netcat.d.ts

@@ -0,0 +1,7 @@
+import type { ShellModule } from "../types/commands";
+/**
+ * Netcat network utility
+ * @category net
+ * @params ["[-l] [-p port] [-v]"]
+ */
+export declare const ncCommand: ShellModule;