typescript-virtual-container 1.3.4 → 1.4.1

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

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

package/dist/commands/du.js

@@ -1,5 +1,10 @@
 import { ifFlag } from "./command-helpers";
 import { resolvePath } from "./helpers";
+/**
+ * Estimate file and directory space usage.
+ * @category system
+ * @params ["[-h] [-s] [path]"]
+ */
 export const duCommand = {
     name: "du",
     description: "Estimate file space usage",

package/dist/commands/export.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Set or display shell environment variables for child processes.
+ * @category shell
+ * @params ["[VAR=value]"]
+ */
 export declare const exportCommand: ShellModule;
 //# sourceMappingURL=export.d.ts.map

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

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

package/dist/commands/export.js

@@ -1,3 +1,8 @@
+/**
+ * Set or display shell environment variables for child processes.
+ * @category shell
+ * @params ["[VAR=value]"]
+ */
 export const exportCommand = {
     name: "export",
     description: "Set shell environment variable",

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

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

package/dist/commands/grep.js

@@ -12,12 +12,15 @@ export const grepCommand = {
     params: ["[-i] [-v] [-n] [-r] <pattern> [file...]"],
     run: ({ authUser, shell, cwd, args, stdin }) => {
         const { flags, positionals } = parseArgs(args, {
-            flags: ["-i", "-v", "-n", "-r"],
+            flags: ["-i", "-v", "-n", "-r", "-c", "-l", "-L", "-q", "--quiet", "--silent"],
         });
         const caseInsensitive = flags.has("-i");
         const invertMatch = flags.has("-v");
         const showLineNumbers = flags.has("-n");
         const recursive = flags.has("-r");
+        const countOnly = flags.has("-c");
+        const filesWithMatches = flags.has("-l");
+        const quiet = flags.has("-q") || flags.has("--quiet") || flags.has("--silent");
         const pattern = positionals[0];
         const files = positionals.slice(1);
         if (!pattern) {
@@ -72,7 +75,12 @@ export const grepCommand = {
         if (files.length === 0) {
             if (!stdin)
                 return { stdout: "", exitCode: 1 };
-            results.push(...matchLines(stdin));
+            const matched = matchLines(stdin);
+            if (countOnly)
+                return { stdout: `${matched.length}\n`, exitCode: matched.length > 0 ? 0 : 1 };
+            if (quiet)
+                return { exitCode: matched.length > 0 ? 0 : 1 };
+            results.push(...matched);
         }
         else {
             const resolvedPaths = files.flatMap((f) => {
@@ -84,7 +92,17 @@ export const grepCommand = {
                     assertPathAccess(authUser, filePath, "grep");
                     const content = shell.vfs.readFile(filePath);
                     const prefix = resolvedPaths.length > 1 ? `${file}:` : "";
-                    results.push(...matchLines(content, prefix));
+                    const matched = matchLines(content, prefix);
+                    if (countOnly) {
+                        results.push(resolvedPaths.length > 1 ? `${file}:${matched.length}` : String(matched.length));
+                    }
+                    else if (filesWithMatches) {
+                        if (matched.length > 0)
+                            results.push(file);
+                    }
+                    else {
+                        results.push(...matched);
+                    }
                 }
                 catch {
                     return {
@@ -95,7 +113,7 @@ export const grepCommand = {
             }
         }
         return {
-            stdout: results.length > 0 ? results.join("\n") : "",
+            stdout: results.length > 0 ? `${results.join("\n")}\n` : "",
             exitCode: results.length > 0 ? 0 : 1,
         };
     },

package/dist/commands/groups.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Print group memberships for a user.
+ * @category system
+ * @params ["[user]"]
+ */
 export declare const groupsCommand: ShellModule;
 //# sourceMappingURL=groups.d.ts.map

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

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

package/dist/commands/groups.js

@@ -1,3 +1,8 @@
+/**
+ * Print group memberships for a user.
+ * @category system
+ * @params ["[user]"]
+ */
 export const groupsCommand = {
     name: "groups",
     description: "Print group memberships",

package/dist/commands/gzip.d.ts

@@ -1,9 +1,12 @@
 import type { ShellModule } from "../types/commands";
 /**
- * Compress files using gzip (stores in VFS as compressed content).
+ * Compress files using gzip — renames file to `<file>.gz`, removes original.
  * @category archive
- * @params ["<file>"]
  */
 export declare const gzipCommand: ShellModule;
+/**
+ * Decompress gzip files — renames `<file>.gz` to `<file>`, removes original.
+ * @category archive
+ */
 export declare const gunzipCommand: ShellModule;
 //# sourceMappingURL=gzip.d.ts.map

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

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

package/dist/commands/gzip.js

@@ -1,56 +1,82 @@
 import { resolvePath } from "./helpers";
 /**
- * Compress files using gzip (stores in VFS as compressed content).
+ * Compress files using gzip — renames file to `<file>.gz`, removes original.
  * @category archive
- * @params ["<file>"]
  */
 export const gzipCommand = {
     name: "gzip",
     description: "Compress files",
     category: "archive",
-    params: ["<file>"],
+    params: ["[-k] [-d] <file>"],
     run: ({ shell, cwd, args }) => {
-        const file = args[0];
+        if (!shell.packageManager.isInstalled("gzip")) {
+            return {
+                stderr: "bash: gzip: command not found\nHint: install it with: apt install gzip\n",
+                exitCode: 127,
+            };
+        }
+        const keepOrig = args.includes("-k") || args.includes("--keep");
+        const decompress = args.includes("-d");
+        const file = args.find((a) => !a.startsWith("-"));
         if (!file)
-            return { stderr: "gzip: no file specified", exitCode: 1 };
+            return { stderr: "gzip: no file specified\n", exitCode: 1 };
         const p = resolvePath(cwd, file);
-        try {
-            shell.vfs.compressFile(p);
+        if (decompress) {
+            // gzip -d = gunzip
+            if (!file.endsWith(".gz")) {
+                return { stderr: `gzip: ${file}: unknown suffix -- ignored\n`, exitCode: 1 };
+            }
+            if (!shell.vfs.exists(p)) {
+                return { stderr: `gzip: ${file}: No such file or directory\n`, exitCode: 1 };
+            }
+            const content = shell.vfs.readFile(p);
+            const dest = p.slice(0, -3);
+            shell.vfs.writeFile(dest, content);
+            if (!keepOrig)
+                shell.vfs.remove(p);
             return { exitCode: 0 };
         }
-        catch {
-            return {
-                stderr: `gzip: ${file}: No such file or directory`,
-                exitCode: 1,
-            };
+        if (!shell.vfs.exists(p)) {
+            return { stderr: `gzip: ${file}: No such file or directory\n`, exitCode: 1 };
+        }
+        if (file.endsWith(".gz")) {
+            return { stderr: `gzip: ${file}: already has .gz suffix -- unchanged\n`, exitCode: 1 };
         }
+        const rawContent = shell.vfs.readFileRaw(p);
+        const gzPath = `${p}.gz`;
+        shell.vfs.writeFile(gzPath, rawContent, { compress: true });
+        if (!keepOrig)
+            shell.vfs.remove(p);
+        return { exitCode: 0 };
     },
 };
+/**
+ * Decompress gzip files — renames `<file>.gz` to `<file>`, removes original.
+ * @category archive
+ */
 export const gunzipCommand = {
-    /**
-     * Decompress gzip files (or zcat alias).
-     * @category archive
-     * @params ["<file>"]
-     */
     name: "gunzip",
     description: "Decompress files",
     category: "archive",
-    params: ["<file>"],
     aliases: ["zcat"],
+    params: ["[-k] <file>"],
     run: ({ shell, cwd, args }) => {
-        const file = args[0];
+        const keepOrig = args.includes("-k") || args.includes("--keep");
+        const file = args.find((a) => !a.startsWith("-"));
         if (!file)
-            return { stderr: "gunzip: no file specified", exitCode: 1 };
+            return { stderr: "gunzip: no file specified\n", exitCode: 1 };
         const p = resolvePath(cwd, file);
-        try {
-            shell.vfs.decompressFile(p);
-            return { exitCode: 0 };
+        if (!shell.vfs.exists(p)) {
+            return { stderr: `gunzip: ${file}: No such file or directory\n`, exitCode: 1 };
         }
-        catch {
-            return {
-                stderr: `gunzip: ${file}: No such file or directory`,
-                exitCode: 1,
-            };
+        if (!file.endsWith(".gz")) {
+            return { stderr: `gunzip: ${file}: unknown suffix -- ignored\n`, exitCode: 1 };
         }
+        const content = shell.vfs.readFile(p);
+        const dest = p.slice(0, -3);
+        shell.vfs.writeFile(dest, content);
+        if (!keepOrig)
+            shell.vfs.remove(p);
+        return { exitCode: 0 };
     },
 };

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

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

package/dist/commands/head.js

@@ -12,9 +12,18 @@ export const headCommand = {
     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 take = (content) => content.split("\n").slice(0, n).join("\n");
+        // Support both -n N and -N shorthand (head -2, head -10)
+        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");
+            // Preserve trailing newline
+            const sliced = lines.slice(0, n);
+            return sliced.join("\n") + (content.endsWith("\n") && sliced.length === lines.slice(0, n).length ? "\n" : "");
+        };
         if (positionals.length === 0) {
             return { stdout: take(stdin ?? ""), exitCode: 0 };
         }

package/dist/commands/htop.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Interactive system monitor (requires terminal interaction).
+ * @category system
+ * @params []
+ */
 export declare const htopCommand: ShellModule;
 //# sourceMappingURL=htop.d.ts.map

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

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

package/dist/commands/htop.js

@@ -1,3 +1,8 @@
+/**
+ * Interactive system monitor (requires terminal interaction).
+ * @category system
+ * @params []
+ */
 export const htopCommand = {
     name: "htop",
     description: "System monitor",

package/dist/commands/kill.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Send a signal to a process by PID.
+ * @category system
+ * @params ["[-9] <pid>"]
+ */
 export declare const killCommand: ShellModule;
 //# sourceMappingURL=kill.d.ts.map

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

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

package/dist/commands/kill.js

@@ -1,3 +1,8 @@
+/**
+ * Send a signal to a process by PID.
+ * @category system
+ * @params ["[-9] <pid>"]
+ */
 export const killCommand = {
     name: "kill",
     description: "Send signal to process",

package/dist/commands/ln.d.ts

@@ -1,3 +1,5 @@
 import type { ShellModule } from "../types/commands";
 export declare const lnCommand: ShellModule;
+/** Shell command: print the value of a symbolic link. */
+export declare const readlinkCommand: ShellModule;
 //# sourceMappingURL=ln.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ln.d.ts","sourceRoot":"","sources":["../../src/commands/ln.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,SAAS,EAAE,WA4CvB,CAAC"}
+{"version":3,"file":"ln.d.ts","sourceRoot":"","sources":["../../src/commands/ln.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,SAAS,EAAE,WA4CvB,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,eAAe,EAAE,WAmB7B,CAAC"}

package/dist/commands/ln.js

@@ -42,3 +42,25 @@ export const lnCommand = {
         }
     },
 };
+/** Shell command: print the value of a symbolic link. */
+export const readlinkCommand = {
+    name: "readlink",
+    description: "Print resolved path of symbolic link",
+    category: "files",
+    params: ["[-f] <path>"],
+    run: ({ shell, cwd, args }) => {
+        const follow = args.includes("-f") || args.includes("-e");
+        const target = args.find((a) => !a.startsWith("-"));
+        if (!target)
+            return { stderr: "readlink: missing operand\n", exitCode: 1 };
+        const p = resolvePath(cwd, target);
+        if (!shell.vfs.exists(p)) {
+            return { stderr: `readlink: ${target}: No such file or directory\n`, exitCode: 1 };
+        }
+        if (!shell.vfs.isSymlink(p)) {
+            return { stderr: `readlink: ${target}: not a symbolic link\n`, exitCode: 1 };
+        }
+        const resolved = shell.vfs.resolveSymlink(follow ? p : p);
+        return { stdout: `${resolved}\n`, exitCode: 0 };
+    },
+};

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

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

package/dist/commands/ls.js

@@ -34,6 +34,21 @@ export const lsCommand = {
         });
         const target = resolvePath(cwd, targetArg ?? cwd);
         assertPathAccess(authUser, target, "ls");
+        // If target is a file, show its info directly (ls -l /etc/passwd)
+        if (shell.vfs.exists(target)) {
+            const st = shell.vfs.stat(target);
+            if (st.type === "file" || shell.vfs.isSymlink(target)) {
+                if (longFormat) {
+                    const name = target.split("/").pop() ?? target;
+                    const size = st.type === "file" ? st.size : 0;
+                    return {
+                        stdout: `${formatPermissions(st.mode, false)} 1 root root ${size} ${formatDate(st.updatedAt)} ${name}\n`,
+                        exitCode: 0,
+                    };
+                }
+                return { stdout: target.split("/").pop() ?? target, exitCode: 0 };
+            }
+        }
         const items = shell.vfs
             .list(target)
             .filter((name) => showHidden || !name.startsWith("."));

package/dist/commands/lsb-release.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Print Linux distribution information.
+ * @category system
+ * @params ["[-a] [-i] [-d] [-r] [-c]"]
+ */
 export declare const lsbReleaseCommand: ShellModule;
 //# sourceMappingURL=lsb-release.d.ts.map

package/dist/commands/lsb-release.d.ts.map

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

package/dist/commands/lsb-release.js

@@ -1,4 +1,9 @@
 import { ifFlag } from "./command-helpers";
+/**
+ * Print Linux distribution information.
+ * @category system
+ * @params ["[-a] [-i] [-d] [-r] [-c]"]
+ */
 export const lsbReleaseCommand = {
     name: "lsb_release",
     description: "Print distribution-specific information",

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

@@ -1 +1 @@
-{"version":3,"file":"man.d.ts","sourceRoot":"","sources":["../../src/commands/man.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAiJrD,eAAO,MAAM,UAAU,EAAE,WAoBxB,CAAC"}
+{"version":3,"file":"man.d.ts","sourceRoot":"","sources":["../../src/commands/man.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAwCrD,eAAO,MAAM,UAAU,EAAE,WAoBxB,CAAC"}

package/dist/commands/man.js

@@ -1,144 +1,38 @@
-const MAN_PAGES = {
-    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 = {
+    gunzip: "gzip",
 };
+const manualCache = new Map();
+const manualsBaseUrl = new URL("./manuals/", import.meta.url);
+async function dynamicImport(specifier) {
+    const importer = new Function("moduleName", "return import(moduleName)");
+    return importer(specifier);
+}
+async function loadBundledManual(commandName) {
+    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"));
+        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 = {
     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 };
@@ -147,7 +41,7 @@ export const manCommand = {
         if (shell.vfs.exists(manPath)) {
             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/dist/commands/mkdir.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Create one or more directories.
+ * @category files
+ * @params ["<dir>"]
+ */
 export declare const mkdirCommand: ShellModule;
 //# sourceMappingURL=mkdir.d.ts.map

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

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

package/dist/commands/mkdir.js

@@ -1,5 +1,10 @@
 import { getArg } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Create one or more directories.
+ * @category files
+ * @params ["<dir>"]
+ */
 export const mkdirCommand = {
     name: "mkdir",
     description: "Make directories",