typescript-virtual-container 1.4.0 → 1.4.2

package/src/commands/man.ts

@@ -1,154 +1,49 @@
 import type { ShellModule } from "../types/commands";
 
-const MAN_PAGES: Record<string, string> = {
-	ls: `LS(1)                    User Commands                    LS(1)
-
-NAME
-       ls - list directory contents
-
-SYNOPSIS
-       ls [OPTION]... [FILE]...
-
-DESCRIPTION
-       List information about the FILEs (the current directory by default).
-
-OPTIONS
-       -l     use a long listing format
-       -a     do not ignore entries starting with .
-       -h     with -l, print human readable sizes
-       -r     reverse order while sorting
-       -t     sort by modification time
-
-AUTHOR
-       Written by Richard M. Stallman and David MacKenzie.`,
-
-	cat: `CAT(1)                   User Commands                    CAT(1)
-
-NAME
-       cat - concatenate files and print on the standard output
-
-SYNOPSIS
-       cat [OPTION]... [FILE]...
-
-DESCRIPTION
-       Concatenate FILE(s) to standard output.
-
-OPTIONS
-       -n, --number          number all output lines
-       -b, --number-nonblank number nonempty output lines`,
-
-	grep: `GREP(1)                  User Commands                    GREP(1)
-
-NAME
-       grep, egrep, fgrep - print lines that match patterns
-
-SYNOPSIS
-       grep [OPTION]... PATTERNS [FILE]...
-
-OPTIONS
-       -i, --ignore-case     ignore case distinctions in patterns and data
-       -v, --invert-match    select non-matching lines
-       -n, --line-number     print line number with output lines
-       -r, --recursive       read all files under each directory, recursively`,
-
-	apt: `APT(8)                   APT                             APT(8)
-
-NAME
-       apt - command-line interface
-
-SYNOPSIS
-       apt [options] command
-
-DESCRIPTION
-       apt provides a high-level commandline interface for the package
-       management system.
-
-COMMANDS
-       install pkg...   Install packages
-       remove pkg...    Remove packages
-       update           Download package information
-       upgrade          Upgrade installed packages
-       search term      Search in package descriptions
-       show pkg         Show package information
-       list             List packages`,
-
-	ssh: `SSH(1)                   OpenSSH                          SSH(1)
-
-NAME
-       ssh - OpenSSH remote login client
-
-SYNOPSIS
-       ssh [-p port] [user@]hostname [command]
-
-DESCRIPTION
-       ssh (SSH client) is a program for logging into a remote machine and
-       for executing commands on a remote machine.`,
-
-	curl: `CURL(1)                  User Commands                    CURL(1)
-
-NAME
-       curl - transfer a URL
-
-SYNOPSIS
-       curl [options / URLs]
-
-DESCRIPTION
-       curl is a tool for transferring data with URL syntax.
-
-OPTIONS
-       -o, --output <file>     Write output to <file>
-       -X, --request <method>  Specify request method
-       -d, --data <data>       HTTP POST data
-       -H, --header <header>   Pass custom header
-       -s, --silent            Silent mode
-       -I, --head              Show document info only
-       -L, --location          Follow redirects
-       -v, --verbose           Make the operation more talkative`,
-
-	chmod: `CHMOD(1)                 User Commands                    CHMOD(1)
-
-NAME
-       chmod - change file mode bits
-
-SYNOPSIS
-       chmod [OPTION]... MODE[,MODE]... FILE...
-       chmod [OPTION]... OCTAL-MODE FILE...
-
-DESCRIPTION
-       Change the file mode bits of each given file according to MODE.
-
-EXAMPLES
-       chmod 755 script.sh      rwxr-xr-x
-       chmod 644 file.txt       rw-r--r--
-       chmod +x script.sh       add execute permission`,
-
-	tar: `TAR(1)                   GNU tar Manual                   TAR(1)
-
-NAME
-       tar - an archiving utility
-
-SYNOPSIS
-       tar [OPTION...] [FILE]...
-
-DESCRIPTION
-       tar saves many files together into a single tape or disk archive,
-       and can restore individual files from the archive.
-
-OPTIONS
-       -c, --create           create a new archive
-       -x, --extract          extract files from an archive
-       -z, --gzip             filter the archive through gzip
-       -f, --file=ARCHIVE     use archive file or device ARCHIVE
-       -v, --verbose          verbosely list files processed
-       -t, --list             list the contents of an archive`,
+const MANUAL_ALIASES: Record<string, string> = {
+	gunzip: "gzip",
 };
 
+const manualCache = new Map<string, string | null>();
+const manualsBaseUrl = new URL("./manuals/", import.meta.url);
+
+async function dynamicImport(specifier: string): Promise<unknown> {
+	const importer = new Function(
+		"moduleName",
+		"return import(moduleName)",
+	) as (moduleName: string) => Promise<unknown>;
+	return importer(specifier);
+}
+
+async function loadBundledManual(commandName: string): Promise<string | null> {
+	const normalized = commandName.toLowerCase();
+	const lookupName = MANUAL_ALIASES[normalized] ?? normalized;
+	const cacheKey = `builtin:${lookupName}`;
+	if (manualCache.has(cacheKey)) {
+		return manualCache.get(cacheKey) ?? null;
+	}
+
+	try {
+		const fsModule = (await dynamicImport("node:fs/promises")) as {
+			readFile: (path: URL, encoding: "utf8") => Promise<string>;
+		};
+		const manualUrl = new URL(`${lookupName}.txt`, manualsBaseUrl);
+		const content = await fsModule.readFile(manualUrl, "utf8");
+		const page = content.replace(/\n$/, "");
+		manualCache.set(cacheKey, page);
+		return page;
+	} catch {
+		manualCache.set(cacheKey, null);
+		return null;
+	}
+}
+
 export const manCommand: ShellModule = {
 	name: "man",
 	description: "Interface to the system reference manuals",
 	category: "shell",
 	params: ["<command>"],
-	run: ({ args, shell }) => {
+	run: async ({ args, shell }) => {
 		const name = args[0];
 		if (!name) return { stderr: "What manual page do you want?", exitCode: 1 };
 
@@ -158,7 +53,7 @@ export const manCommand: ShellModule = {
 			return { stdout: shell.vfs.readFile(manPath), exitCode: 0 };
 		}
 
-		const page = MAN_PAGES[name.toLowerCase()];
+		const page = await loadBundledManual(name);
 		if (page) return { stdout: page, exitCode: 0 };
 
 		return { stderr: `No manual entry for ${name}`, exitCode: 16 };

package/src/commands/manuals/adduser.txt

@@ -0,0 +1,11 @@
+ADDUSER(8)                User Commands                ADDUSER(8)
+
+NAME
+       adduser - add a user to the system
+
+SYNOPSIS
+       adduser USERNAME
+
+DESCRIPTION
+       Create a new user account with a home directory.
+       In this environment, prompts for a password interactively.

package/src/commands/manuals/apt-cache.txt

@@ -0,0 +1,12 @@
+APT-CACHE(8)             APT                        APT-CACHE(8)
+
+NAME
+       apt-cache - query APT package cache
+
+SYNOPSIS
+       apt-cache command [args]
+
+COMMANDS
+       search term    search package names/descriptions
+       show pkg       show package metadata
+       policy pkg     show package policy and candidate versions

package/src/commands/manuals/apt.txt

@@ -0,0 +1,20 @@
+APT(8)                   APT                             APT(8)
+
+NAME
+       apt - command-line interface
+
+SYNOPSIS
+       apt [options] command
+
+DESCRIPTION
+       apt provides a high-level commandline interface for the package
+       management system.
+
+COMMANDS
+       install pkg...   Install packages
+       remove pkg...    Remove packages
+       update           Download package information
+       upgrade          Upgrade installed packages
+       search term      Search in package descriptions
+       show pkg         Show package information
+       list             List packages

package/src/commands/manuals/awk.txt

@@ -0,0 +1,13 @@
+AWK(1)                   User Commands                     AWK(1)
+
+NAME
+       awk - pattern scanning and processing language
+
+SYNOPSIS
+       awk [OPTION]... 'PROGRAM' [FILE]...
+
+DESCRIPTION
+       awk scans each input line, applies PROGRAM rules, and prints results.
+
+OPTIONS
+       -F fs    use fs as input field separator

package/src/commands/manuals/cat.txt

@@ -0,0 +1,14 @@
+CAT(1)                   User Commands                    CAT(1)
+
+NAME
+       cat - concatenate files and print on the standard output
+
+SYNOPSIS
+       cat [OPTION]... [FILE]...
+
+DESCRIPTION
+       Concatenate FILE(s) to standard output.
+
+OPTIONS
+       -n, --number          number all output lines
+       -b, --number-nonblank number nonempty output lines

package/src/commands/manuals/cd.txt

@@ -0,0 +1,16 @@
+CD(1)                    Shell Builtins                    CD(1)
+
+NAME
+       cd - change the shell working directory
+
+SYNOPSIS
+       cd [DIRECTORY]
+
+DESCRIPTION
+       Change the current working directory.
+       Without DIRECTORY, changes to $HOME.
+
+EXAMPLES
+       cd /etc
+       cd ..
+       cd ~

package/src/commands/manuals/chmod.txt

@@ -0,0 +1,16 @@
+CHMOD(1)                 User Commands                    CHMOD(1)
+
+NAME
+       chmod - change file mode bits
+
+SYNOPSIS
+       chmod [OPTION]... MODE[,MODE]... FILE...
+       chmod [OPTION]... OCTAL-MODE FILE...
+
+DESCRIPTION
+       Change the file mode bits of each given file according to MODE.
+
+EXAMPLES
+       chmod 755 script.sh      rwxr-xr-x
+       chmod 644 file.txt       rw-r--r--
+       chmod +x script.sh       add execute permission

package/src/commands/manuals/clear.txt

@@ -0,0 +1,10 @@
+CLEAR(1)                 User Commands                   CLEAR(1)
+
+NAME
+       clear - clear the terminal screen
+
+SYNOPSIS
+       clear
+
+DESCRIPTION
+       Clear the display and move cursor to top-left.

package/src/commands/manuals/cp.txt

@@ -0,0 +1,10 @@
+CP(1)                    User Commands                      CP(1)
+
+NAME
+       cp - copy files and directories
+
+SYNOPSIS
+       cp [OPTION]... SOURCE... DEST
+
+OPTIONS
+       -r     copy directories recursively

package/src/commands/manuals/curl.txt

@@ -0,0 +1,20 @@
+CURL(1)                  User Commands                    CURL(1)
+
+NAME
+       curl - transfer a URL
+
+SYNOPSIS
+       curl [options / URLs]
+
+DESCRIPTION
+       curl is a tool for transferring data with URL syntax.
+
+OPTIONS
+       -o, --output <file>     Write output to <file>
+       -X, --request <method>  Specify request method
+       -d, --data <data>       HTTP POST data
+       -H, --header <header>   Pass custom header
+       -s, --silent            Silent mode
+       -I, --head              Show document info only
+       -L, --location          Follow redirects
+       -v, --verbose           Make the operation more talkative

package/src/commands/manuals/date.txt

@@ -0,0 +1,14 @@
+DATE(1)                  User Commands                    DATE(1)
+
+NAME
+       date - print or set the system date and time
+
+SYNOPSIS
+       date [+FORMAT]
+
+DESCRIPTION
+       Display current date/time, optionally formatted.
+
+EXAMPLES
+       date
+       date +%Y-%m-%d

package/src/commands/manuals/declare.txt

@@ -0,0 +1,12 @@
+DECLARE(1)               Shell Builtins               DECLARE(1)
+
+NAME
+       declare - set variable values and attributes
+
+SYNOPSIS
+       declare [OPTION]... [NAME[=VALUE]...]
+
+OPTIONS
+       -i     variable has integer attribute
+       -r     make NAMEs readonly
+       -x     export NAMEs to environment

package/src/commands/manuals/deluser.txt

@@ -0,0 +1,10 @@
+DELUSER(8)                User Commands                DELUSER(8)
+
+NAME
+       deluser - remove a user account
+
+SYNOPSIS
+       deluser [OPTION] USERNAME
+
+OPTIONS
+       -f, --force    remove without interactive confirmation

package/src/commands/manuals/df.txt

@@ -0,0 +1,10 @@
+DF(1)                    User Commands                      DF(1)
+
+NAME
+       df - report file system disk space usage
+
+SYNOPSIS
+       df [OPTION]... [FILE]...
+
+OPTIONS
+       -h     print sizes in human readable format

package/src/commands/manuals/dpkg-query.txt

@@ -0,0 +1,11 @@
+DPKG-QUERY(1)            User Commands              DPKG-QUERY(1)
+
+NAME
+       dpkg-query - tool to query the dpkg database
+
+SYNOPSIS
+       dpkg-query [OPTION]... [ACTION]
+
+OPTIONS
+       -W     list installed packages (show format)
+       -l     list packages

package/src/commands/manuals/dpkg.txt

@@ -0,0 +1,14 @@
+DPKG(1)                  User Commands                    DPKG(1)
+
+NAME
+       dpkg - package manager for Debian-like systems
+
+SYNOPSIS
+       dpkg [OPTION]... ACTION
+
+OPTIONS
+       -l     list installed packages
+       -s     show package status
+       -L     list files in package
+       -r     remove package
+       -P     purge package

package/src/commands/manuals/du.txt

@@ -0,0 +1,11 @@
+DU(1)                    User Commands                      DU(1)
+
+NAME
+       du - estimate file space usage
+
+SYNOPSIS
+       du [OPTION]... [FILE]...
+
+OPTIONS
+       -h     print sizes in human readable format
+       -s     display only a total for each argument

package/src/commands/manuals/echo.txt

@@ -0,0 +1,11 @@
+ECHO(1)                  User Commands                    ECHO(1)
+
+NAME
+       echo - display a line of text
+
+SYNOPSIS
+       echo [OPTION]... [STRING]...
+
+OPTIONS
+       -n     do not output the trailing newline
+       -e     enable interpretation of backslash escapes

package/src/commands/manuals/false.txt

@@ -0,0 +1,10 @@
+FALSE(1)                 User Commands                   FALSE(1)
+
+NAME
+       false - do nothing, unsuccessfully
+
+SYNOPSIS
+       false
+
+DESCRIPTION
+       Exit with a status code indicating failure (1).

package/src/commands/manuals/find.txt

@@ -0,0 +1,11 @@
+FIND(1)                  User Commands                    FIND(1)
+
+NAME
+       find - search for files in a directory hierarchy
+
+SYNOPSIS
+       find [PATH] [EXPRESSION]
+
+OPTIONS
+       -name PATTERN   base name matches shell PATTERN
+       -type TYPE      file type, e.g. f for file, d for directory

package/src/commands/manuals/free.txt

@@ -0,0 +1,12 @@
+FREE(1)                  User Commands                    FREE(1)
+
+NAME
+       free - display amount of free and used memory in the system
+
+SYNOPSIS
+       free [OPTION]...
+
+OPTIONS
+       -h     show all output fields automatically scaled
+       -m     show output in mebibytes
+       -g     show output in gibibytes

package/src/commands/manuals/grep.txt

@@ -0,0 +1,13 @@
+GREP(1)                  User Commands                    GREP(1)
+
+NAME
+       grep, egrep, fgrep - print lines that match patterns
+
+SYNOPSIS
+       grep [OPTION]... PATTERNS [FILE]...
+
+OPTIONS
+       -i, --ignore-case     ignore case distinctions in patterns and data
+       -v, --invert-match    select non-matching lines
+       -n, --line-number     print line number with output lines
+       -r, --recursive       read all files under each directory, recursively

package/src/commands/manuals/groups.txt

@@ -0,0 +1,10 @@
+GROUPS(1)                User Commands                  GROUPS(1)
+
+NAME
+       groups - print the groups a user is in
+
+SYNOPSIS
+       groups [USER]
+
+DESCRIPTION
+       Print group memberships for USER or current user if omitted.

package/src/commands/manuals/gzip.txt

@@ -0,0 +1,11 @@
+GZIP(1)                  User Commands                    GZIP(1)
+
+NAME
+       gzip, gunzip - compress or expand files
+
+SYNOPSIS
+       gzip FILE...
+       gunzip FILE...
+
+DESCRIPTION
+       Compress or decompress files in place.

package/src/commands/manuals/head.txt

@@ -0,0 +1,10 @@
+HEAD(1)                  User Commands                    HEAD(1)
+
+NAME
+       head - output the first part of files
+
+SYNOPSIS
+       head [OPTION]... [FILE]...
+
+OPTIONS
+       -n, --lines=[-]NUM    print the first NUM lines

package/src/commands/manuals/help.txt

@@ -0,0 +1,11 @@
+HELP(1)                   Shell Builtins                  HELP(1)
+
+NAME
+       help - display information about builtin commands
+
+SYNOPSIS
+       help [COMMAND]
+
+DESCRIPTION
+       With no arguments, list available commands.
+       With COMMAND, show usage details for that command.

package/src/commands/manuals/history.txt

@@ -0,0 +1,11 @@
+HISTORY(1)               Shell Builtins               HISTORY(1)
+
+NAME
+       history - command history list
+
+SYNOPSIS
+       history [N]
+
+DESCRIPTION
+       Print recent command history entries.
+       If N is provided, print only the last N entries.

package/src/commands/manuals/hostname.txt

@@ -0,0 +1,10 @@
+HOSTNAME(1)              User Commands                HOSTNAME(1)
+
+NAME
+       hostname - show or set the system host name
+
+SYNOPSIS
+       hostname
+
+DESCRIPTION
+       Print the current host name.

package/src/commands/manuals/id.txt

@@ -0,0 +1,10 @@
+ID(1)                    User Commands                      ID(1)
+
+NAME
+       id - print real and effective user and group IDs
+
+SYNOPSIS
+       id [USER]
+
+DESCRIPTION
+       Print user identity information including uid, gid, and groups.

package/src/commands/manuals/kill.txt

@@ -0,0 +1,13 @@
+KILL(1)                  User Commands                    KILL(1)
+
+NAME
+       kill - send signals to processes
+
+SYNOPSIS
+       kill [-SIGNAL] PID...
+
+DESCRIPTION
+       Send a signal to one or more process IDs.
+
+NOTES
+       This environment provides a mock process model.

package/src/commands/manuals/ls.txt

@@ -0,0 +1,20 @@
+LS(1)                    User Commands                    LS(1)
+
+NAME
+       ls - list directory contents
+
+SYNOPSIS
+       ls [OPTION]... [FILE]...
+
+DESCRIPTION
+       List information about the FILEs (the current directory by default).
+
+OPTIONS
+       -l     use a long listing format
+       -a     do not ignore entries starting with .
+       -h     with -l, print human readable sizes
+       -r     reverse order while sorting
+       -t     sort by modification time
+
+AUTHOR
+       Written by Richard M. Stallman and David MacKenzie.

package/src/commands/manuals/lsb_release.txt

@@ -0,0 +1,14 @@
+LSB_RELEASE(1)           User Commands             LSB_RELEASE(1)
+
+NAME
+       lsb_release - print distribution-specific information
+
+SYNOPSIS
+       lsb_release [OPTION]...
+
+OPTIONS
+       -a     show all available information
+       -i     show distributor ID
+       -d     show description
+       -r     show release number
+       -c     show codename

package/src/commands/manuals/mkdir.txt

@@ -0,0 +1,10 @@
+MKDIR(1)                 User Commands                  MKDIR(1)
+
+NAME
+       mkdir - make directories
+
+SYNOPSIS
+       mkdir [OPTION]... DIRECTORY...
+
+OPTIONS
+       -p     no error if existing, make parent directories as needed

package/src/commands/manuals/mv.txt

@@ -0,0 +1,10 @@
+MV(1)                    User Commands                      MV(1)
+
+NAME
+       mv - move (rename) files
+
+SYNOPSIS
+       mv SOURCE DEST
+
+DESCRIPTION
+       Rename SOURCE to DEST, or move SOURCE into a destination directory.