typescript-virtual-container 1.4.0 → 1.4.2

package/src/commands/manuals/nano.txt

@@ -0,0 +1,11 @@
+NANO(1)                  User Commands                    NANO(1)
+
+NAME
+       nano - simple terminal text editor
+
+SYNOPSIS
+       nano FILE
+
+DESCRIPTION
+       Open FILE in an interactive editor.
+       Save with Ctrl+O, exit with Ctrl+X.

package/src/commands/manuals/neofetch.txt

@@ -0,0 +1,10 @@
+NEOFETCH(1)              User Commands                NEOFETCH(1)
+
+NAME
+       neofetch - display system information
+
+SYNOPSIS
+       neofetch
+
+DESCRIPTION
+       Print OS, kernel, uptime, package count, and related system details.

package/src/commands/manuals/node.txt

@@ -0,0 +1,13 @@
+NODE(1)                  User Commands                    NODE(1)
+
+NAME
+       node - virtual JavaScript runtime entry point
+
+SYNOPSIS
+       node [--version] [-e SCRIPT] [-p EXPR]
+
+DESCRIPTION
+       Execute JavaScript snippets in the virtual runtime.
+
+NOTES
+       Requires package installation: apt install nodejs.

package/src/commands/manuals/npm.txt

@@ -0,0 +1,13 @@
+NPM(1)                   User Commands                      NPM(1)
+
+NAME
+       npm - virtual Node.js package manager interface
+
+SYNOPSIS
+       npm [--version] [COMMAND]
+
+DESCRIPTION
+       Manage packages and run scripts in the virtual environment.
+
+NOTES
+       Requires package installation: apt install npm.

package/src/commands/manuals/npx.txt

@@ -0,0 +1,13 @@
+NPX(1)                   User Commands                      NPX(1)
+
+NAME
+       npx - execute package binaries from npm
+
+SYNOPSIS
+       npx [--version] <command>
+
+DESCRIPTION
+       Run package executables in the virtual environment.
+
+NOTES
+       Requires package installation: apt install npm.

package/src/commands/manuals/passwd.txt

@@ -0,0 +1,11 @@
+PASSWD(1)                 User Commands                 PASSWD(1)
+
+NAME
+       passwd - change user password
+
+SYNOPSIS
+       passwd [USER]
+
+DESCRIPTION
+       Update the authentication token (password) for USER.
+       Without USER, change the current user's password.

package/src/commands/manuals/ping.txt

@@ -0,0 +1,10 @@
+PING(8)                   User Commands                   PING(8)
+
+NAME
+       ping - send ICMP ECHO_REQUEST to network hosts
+
+SYNOPSIS
+       ping [-c COUNT] DESTINATION
+
+OPTIONS
+       -c COUNT    stop after sending COUNT packets

package/src/commands/manuals/printf.txt

@@ -0,0 +1,11 @@
+PRINTF(1)                User Commands                  PRINTF(1)
+
+NAME
+       printf - format and print data
+
+SYNOPSIS
+       printf FORMAT [ARGUMENT]...
+
+DESCRIPTION
+       Print ARGUMENT(s) according to FORMAT.
+       Supports common conversions like %s, %d, %f, %x and escapes like \n.

package/src/commands/manuals/ps.txt

@@ -0,0 +1,10 @@
+PS(1)                    User Commands                      PS(1)
+
+NAME
+       ps - report a snapshot of current processes
+
+SYNOPSIS
+       ps [OPTION]
+
+DESCRIPTION
+       Show process information for active sessions and commands.

package/src/commands/manuals/pwd.txt

@@ -0,0 +1,10 @@
+PWD(1)                   User Commands                    PWD(1)
+
+NAME
+       pwd - print name of current working directory
+
+SYNOPSIS
+       pwd
+
+DESCRIPTION
+       Print the absolute path of the current directory.

package/src/commands/manuals/python3.txt

@@ -0,0 +1,13 @@
+PYTHON3(1)               User Commands                  PYTHON3(1)
+
+NAME
+       python3 - virtual Python 3 interpreter entry point
+
+SYNOPSIS
+       python3 [--version] [-V] [-c COMMAND]
+
+DESCRIPTION
+       Execute Python snippets in the virtual runtime.
+
+NOTES
+       Requires package installation: apt install python3.

package/src/commands/manuals/readlink.txt

@@ -0,0 +1,10 @@
+READLINK(1)               User Commands                READLINK(1)
+
+NAME
+       readlink - print resolved symbolic links or canonical file names
+
+SYNOPSIS
+       readlink [OPTION]... FILE
+
+OPTIONS
+       -f     canonicalize by following every symlink in every component

package/src/commands/manuals/return.txt

@@ -0,0 +1,10 @@
+RETURN(1)                Shell Builtins                 RETURN(1)
+
+NAME
+       return - return from a shell function
+
+SYNOPSIS
+       return [N]
+
+DESCRIPTION
+       Cause a function to exit with status N (default: last status).

package/src/commands/manuals/rm.txt

@@ -0,0 +1,10 @@
+RM(1)                    User Commands                      RM(1)
+
+NAME
+       rm - remove files or directories
+
+SYNOPSIS
+       rm [OPTION]... FILE...
+
+OPTIONS
+       -r     remove directories and their contents recursively

package/src/commands/manuals/sed.txt

@@ -0,0 +1,11 @@
+SED(1)                   User Commands                      SED(1)
+
+NAME
+       sed - stream editor for filtering and transforming text
+
+SYNOPSIS
+       sed [OPTION]... {-e script} [FILE]...
+
+OPTIONS
+       -e SCRIPT   add SCRIPT to commands to be executed
+       -i          edit files in place

package/src/commands/manuals/set.txt

@@ -0,0 +1,11 @@
+SET(1)                   Shell Builtins                    SET(1)
+
+NAME
+       set - set or unset shell options and positional parameters
+
+SYNOPSIS
+       set [OPTION]... [ARG]...
+       set [NAME=VALUE]...
+
+DESCRIPTION
+       Display or modify shell variable state.

package/src/commands/manuals/shift.txt

@@ -0,0 +1,10 @@
+SHIFT(1)                 Shell Builtins                  SHIFT(1)
+
+NAME
+       shift - shift positional parameters
+
+SYNOPSIS
+       shift [N]
+
+DESCRIPTION
+       Rename positional parameters by discarding the first N arguments.

package/src/commands/manuals/sleep.txt

@@ -0,0 +1,10 @@
+SLEEP(1)                 User Commands                   SLEEP(1)
+
+NAME
+       sleep - delay for a specified amount of time
+
+SYNOPSIS
+       sleep NUMBER
+
+DESCRIPTION
+       Pause execution for NUMBER seconds.

package/src/commands/manuals/sort.txt

@@ -0,0 +1,12 @@
+SORT(1)                  User Commands                    SORT(1)
+
+NAME
+       sort - sort lines of text files
+
+SYNOPSIS
+       sort [OPTION]... [FILE]...
+
+OPTIONS
+       -r     reverse the result of comparisons
+       -n     compare according to string numerical value
+       -u     output only the first of an equal run

package/src/commands/manuals/source.txt

@@ -0,0 +1,11 @@
+SOURCE(1)                 Shell Builtins                SOURCE(1)
+
+NAME
+       source - execute commands from a file in the current shell
+
+SYNOPSIS
+       source FILE
+       . FILE
+
+DESCRIPTION
+       Read and execute commands from FILE in the current shell context.

package/src/commands/manuals/ssh.txt

@@ -0,0 +1,11 @@
+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.

package/src/commands/manuals/stat.txt

@@ -0,0 +1,10 @@
+STAT(1)                  User Commands                    STAT(1)
+
+NAME
+       stat - display file status
+
+SYNOPSIS
+       stat [OPTION]... FILE...
+
+OPTIONS
+       -c, --format=FORMAT   use the specified output format

package/src/commands/manuals/su.txt

@@ -0,0 +1,13 @@
+SU(1)                    User Commands                      SU(1)
+
+NAME
+       su - run a command with substitute user and group ID
+
+SYNOPSIS
+       su [OPTION]... [USER]
+
+OPTIONS
+       -           start a login shell
+
+DESCRIPTION
+       Switch to another user account in the current session.

package/src/commands/manuals/sudo.txt

@@ -0,0 +1,11 @@
+SUDO(8)                   User Commands                   SUDO(8)
+
+NAME
+       sudo - execute a command as another user
+
+SYNOPSIS
+       sudo [OPTION]... COMMAND [ARG]...
+
+OPTIONS
+       -i          run login shell as target user
+       -u USER     run command as USER

package/src/commands/manuals/tail.txt

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

package/src/commands/manuals/tar.txt

@@ -0,0 +1,19 @@
+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

package/src/commands/manuals/tee.txt

@@ -0,0 +1,10 @@
+TEE(1)                   User Commands                     TEE(1)
+
+NAME
+       tee - read from standard input and write to standard output and files
+
+SYNOPSIS
+       tee [OPTION]... [FILE]...
+
+OPTIONS
+       -a     append to the given FILEs, do not overwrite

package/src/commands/manuals/test.txt

@@ -0,0 +1,11 @@
+TEST(1)                   Shell Builtins                  TEST(1)
+
+NAME
+       test - check file types and compare values
+
+SYNOPSIS
+       test EXPRESSION
+       [ EXPRESSION ]
+
+DESCRIPTION
+       Evaluate conditional expressions for scripts and shell logic.

package/src/commands/manuals/touch.txt

@@ -0,0 +1,11 @@
+TOUCH(1)                 User Commands                  TOUCH(1)
+
+NAME
+       touch - change file timestamps / create file
+
+SYNOPSIS
+       touch FILE...
+
+DESCRIPTION
+       Update access and modification times.
+       If FILE does not exist, create an empty file.

package/src/commands/manuals/tr.txt

@@ -0,0 +1,10 @@
+TR(1)                    User Commands                      TR(1)
+
+NAME
+       tr - translate or delete characters
+
+SYNOPSIS
+       tr [OPTION]... SET1 [SET2]
+
+OPTIONS
+       -d     delete characters in SET1 instead of translating

package/src/commands/manuals/trap.txt

@@ -0,0 +1,10 @@
+TRAP(1)                  Shell Builtins                   TRAP(1)
+
+NAME
+       trap - trap signals and other events
+
+SYNOPSIS
+       trap [ACTION] [SIGNAL]...
+
+DESCRIPTION
+       Define or clear handlers for shell signals and EXIT.

package/src/commands/manuals/true.txt

@@ -0,0 +1,10 @@
+TRUE(1)                  User Commands                    TRUE(1)
+
+NAME
+       true - do nothing, successfully
+
+SYNOPSIS
+       true
+
+DESCRIPTION
+       Exit with a status code indicating success (0).

package/src/commands/manuals/type.txt

@@ -0,0 +1,10 @@
+TYPE(1)                   Shell Builtins                  TYPE(1)
+
+NAME
+       type - display how a command name is interpreted
+
+SYNOPSIS
+       type NAME...
+
+DESCRIPTION
+       Indicate whether NAME is a shell builtin, alias, or found in PATH.

package/src/commands/manuals/uname.txt

@@ -0,0 +1,12 @@
+UNAME(1)                 User Commands                  UNAME(1)
+
+NAME
+       uname - print system information
+
+SYNOPSIS
+       uname [OPTION]...
+
+OPTIONS
+       -a     print all information
+       -r     print kernel release
+       -m     print machine hardware name

package/src/commands/manuals/uniq.txt

@@ -0,0 +1,12 @@
+UNIQ(1)                  User Commands                    UNIQ(1)
+
+NAME
+       uniq - report or omit repeated lines
+
+SYNOPSIS
+       uniq [OPTION]... [INPUT [OUTPUT]]
+
+OPTIONS
+       -c     prefix lines by the number of occurrences
+       -d     only print duplicate lines
+       -u     only print unique lines

package/src/commands/manuals/unset.txt

@@ -0,0 +1,10 @@
+UNSET(1)                 Shell Builtins                  UNSET(1)
+
+NAME
+       unset - unset values and attributes of shell variables
+
+SYNOPSIS
+       unset NAME...
+
+DESCRIPTION
+       Remove one or more shell variables from the current environment.

package/src/commands/manuals/uptime.txt

@@ -0,0 +1,11 @@
+UPTIME(1)                User Commands                  UPTIME(1)
+
+NAME
+       uptime - tell how long the system has been running
+
+SYNOPSIS
+       uptime [OPTION]
+
+OPTIONS
+       -p     show uptime in a pretty format
+       -s     show system up since time

package/src/commands/manuals/wc.txt

@@ -0,0 +1,12 @@
+WC(1)                    User Commands                      WC(1)
+
+NAME
+       wc - print newline, word, and byte counts for each file
+
+SYNOPSIS
+       wc [OPTION]... [FILE]...
+
+OPTIONS
+       -l     print the newline counts
+       -w     print the word counts
+       -c     print the byte counts

package/src/commands/manuals/wget.txt

@@ -0,0 +1,12 @@
+WGET(1)                  User Commands                    WGET(1)
+
+NAME
+       wget - non-interactive network downloader
+
+SYNOPSIS
+       wget [OPTION]... [URL]...
+
+OPTIONS
+       -O FILE    write documents to FILE
+       -P DIR     save files to DIR
+       -q         quiet mode

package/src/commands/manuals/which.txt

@@ -0,0 +1,10 @@
+WHICH(1)                 User Commands                  WHICH(1)
+
+NAME
+       which - locate a command
+
+SYNOPSIS
+       which COMMAND...
+
+DESCRIPTION
+       Print the path of COMMAND found in $PATH.

package/src/commands/manuals/whoami.txt

@@ -0,0 +1,10 @@
+WHOAMI(1)                User Commands                 WHOAMI(1)
+
+NAME
+       whoami - print effective user name
+
+SYNOPSIS
+       whoami
+
+DESCRIPTION
+       Print the user name associated with the current effective user ID.

package/src/commands/manuals/xargs.txt

@@ -0,0 +1,10 @@
+XARGS(1)                 User Commands                   XARGS(1)
+
+NAME
+       xargs - build and execute command lines from standard input
+
+SYNOPSIS
+       xargs [COMMAND [INITIAL-ARGS]]
+
+DESCRIPTION
+       Read items from stdin and execute COMMAND with those items as arguments.

package/src/commands/neofetch.ts

@@ -13,6 +13,13 @@ export const neofetchCommand: ShellModule = {
 	category: "system",
 	params: ["[--off]"],
 	run: ({ args, authUser, hostname, shell, env }) => {
+		if (!shell.packageManager.isInstalled("neofetch")) {
+			return {
+				stderr:
+					"bash: neofetch: command not found\nHint: install it with: apt install neofetch\n",
+				exitCode: 127,
+			};
+		}
 		if (ifFlag(args, "--help")) {
 			return {
 				stdout: "Usage: neofetch [--off]",

package/src/commands/wget.ts

@@ -49,7 +49,18 @@ export const wgetCommand: ShellModule = {
 			};
 		}
 
-		const url = positionals[0];
+		const urlWithoutProtocol = positionals[0];
+		if (!urlWithoutProtocol) {
+			return {
+				stderr: "wget: missing URL\nUsage: wget [OPTION]... [URL]...",
+				exitCode: 1,
+			};
+		}
+
+		const url = urlWithoutProtocol.startsWith("http://") ||
+			urlWithoutProtocol.startsWith("https://")
+			? urlWithoutProtocol
+			: `http://${urlWithoutProtocol}`;
 		if (!url)
 			return {
 				stderr: "wget: missing URL\nUsage: wget [OPTION]... [URL]...",

package/src/modules/linuxRootfs.ts

@@ -8,8 +8,8 @@
  */
 
 import * as os from "node:os";
-import type { ShellProperties } from "../VirtualShell";
 import type VirtualFileSystem from "../VirtualFileSystem";
+import type { ShellProperties } from "../VirtualShell";
 import type { VirtualUserManager } from "../VirtualUserManager";
 
 // ─── helpers ────────────────────────────────────────────────────────────────
@@ -584,7 +584,7 @@ function bootstrapRoot(vfs: VirtualFileSystem): void {
 	ensureDir(vfs, "/root", 0o700);
 	ensureFile(
 		vfs,
-		"/root/.bashrc",
+		"/home/root/.bashrc",
 		`${[
 			"# root .bashrc",
 			"export PS1='\\[\\033[0;31m\\]\\u@\\h\\[\\033[0m\\]:\\[\\033[0;34m\\]\\w\\[\\033[0m\\]# '",
@@ -593,11 +593,11 @@ function bootstrapRoot(vfs: VirtualFileSystem): void {
 			"alias la='ls -A'",
 		].join("\n")}\n`,
 	);
-	ensureFile(vfs, "/root/.profile", "[ -f ~/.bashrc ] && . ~/.bashrc\n");
+	ensureFile(vfs, "/home/root/.profile", "[ -f ~/.bashrc ] && . ~/.bashrc\n");
 	// Fix: /home/root should map to /root for root user
-	if (!vfs.exists("/home/root")) {
-		vfs.symlink("/root", "/home/root");
-	}
+	// if (!vfs.exists("/home/root")) {
+	// 	vfs.symlink("/root", "/home/root");
+	// }
 }
 
 // ─── /opt + /srv + /mnt + /media ─────────────────────────────────────────────