typescript-virtual-container 1.2.8 → 1.3.0

package/dist/commands/dpkg.js

@@ -0,0 +1,161 @@
+import { ifFlag, parseArgs } from "./command-helpers";
+import { getPackageManager } from "./helpers";
+/**
+ * dpkg compatibility command (query/remove/list) backed by the virtual package manager.
+ * @category package
+ * @params ["[-l] [-s pkg] [-L pkg] [-i pkg] [--remove pkg]"]
+ */
+export const dpkgCommand = {
+    name: "dpkg",
+    description: "Debian package manager low-level tool",
+    category: "package",
+    params: ["[-l] [-s pkg] [-L pkg] [-i pkg] [--remove pkg]"],
+    run: ({ args, authUser, shell }) => {
+        const pm = getPackageManager(shell);
+        if (!pm)
+            return { stderr: "dpkg: package manager not initialised", exitCode: 1 };
+        const listFlag = ifFlag(args, ["-l", "--list"]);
+        const statusFlag = ifFlag(args, ["-s", "--status"]);
+        const listFilesFlag = ifFlag(args, ["-L", "--listfiles"]);
+        const removeFlag = ifFlag(args, ["-r", "--remove"]);
+        const purgeFlag = ifFlag(args, ["-P", "--purge"]);
+        const { positionals } = parseArgs(args, {
+            flags: [
+                "-l",
+                "--list",
+                "-s",
+                "--status",
+                "-L",
+                "--listfiles",
+                "-r",
+                "--remove",
+                "-P",
+                "--purge",
+            ],
+        });
+        if (listFlag) {
+            const pkgList = pm.listInstalled();
+            if (pkgList.length === 0) {
+                return {
+                    stdout: [
+                        "Desired=Unknown/Install/Remove/Purge/Hold",
+                        "|Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend",
+                        "|/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)",
+                        "||/ Name           Version         Architecture Description",
+                        "+++-==============-===============-============-========================================",
+                        "(no packages installed)",
+                    ].join("\n"),
+                    exitCode: 0,
+                };
+            }
+            const header = [
+                "Desired=Unknown/Install/Remove/Purge/Hold",
+                "|Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend",
+                "|/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)",
+                "||/ Name           Version         Architecture Description",
+                "+++-==============-===============-============-========================================",
+            ];
+            const rows = pkgList.map((p) => {
+                const name = p.name.padEnd(14).slice(0, 14);
+                const ver = p.version.padEnd(15).slice(0, 15);
+                const arch = p.architecture.padEnd(12).slice(0, 12);
+                const desc = (p.description || "").slice(0, 40);
+                return `ii  ${name} ${ver} ${arch} ${desc}`;
+            });
+            return { stdout: [...header, ...rows].join("\n"), exitCode: 0 };
+        }
+        if (statusFlag) {
+            const pkgName = positionals[0];
+            if (!pkgName)
+                return { stderr: "dpkg: -s needs a package name", exitCode: 1 };
+            const info = pm.show(pkgName);
+            if (!info)
+                return {
+                    stderr: `dpkg-query: package '${pkgName}' is not installed and no information is available`,
+                    exitCode: 1,
+                };
+            return { stdout: info, exitCode: 0 };
+        }
+        if (listFilesFlag) {
+            const pkgName = positionals[0];
+            if (!pkgName)
+                return { stderr: "dpkg: -L needs a package name", exitCode: 1 };
+            const installed = pm.listInstalled().find((p) => p.name === pkgName);
+            if (!installed)
+                return {
+                    stderr: `dpkg-query: package '${pkgName}' is not installed`,
+                    exitCode: 1,
+                };
+            if (installed.files.length === 0)
+                return { stdout: "/.keep", exitCode: 0 };
+            return { stdout: installed.files.join("\n"), exitCode: 0 };
+        }
+        if (removeFlag || purgeFlag) {
+            if (authUser !== "root")
+                return {
+                    stderr: "dpkg: error: requested operation requires superuser privilege",
+                    exitCode: 2,
+                };
+            if (positionals.length === 0)
+                return { stderr: "dpkg: error: need an action option", exitCode: 2 };
+            const { output, exitCode } = pm.remove(positionals, { purge: purgeFlag });
+            return { stdout: output || undefined, exitCode };
+        }
+        // Default: show help
+        return {
+            stdout: [
+                "Usage: dpkg [<option>...] <command>",
+                "",
+                "Commands:",
+                "  -l, --list                  List packages matching given pattern",
+                "  -s, --status <pkg>...       Report status of specified package",
+                "  -L, --listfiles <pkg>...    List files owned by package",
+                "  -r, --remove <pkg>...       Remove <pkg> but leave its configuration",
+                "  -P, --purge <pkg>...        Remove <pkg> and its configuration",
+            ].join("\n"),
+            exitCode: 0,
+        };
+    },
+};
+export const dpkgQueryCommand = {
+    name: "dpkg-query",
+    description: "Show information about installed packages",
+    category: "package",
+    params: ["-W [pkg] | -l [pattern]"],
+    run: ({ args, shell }) => {
+        const pm = getPackageManager(shell);
+        if (!pm)
+            return {
+                stderr: "dpkg-query: package manager not initialised",
+                exitCode: 1,
+            };
+        const listFlag = ifFlag(args, ["-l"]);
+        const showFlag = ifFlag(args, ["-W", "--show"]);
+        const { positionals } = parseArgs(args, {
+            flags: ["-l", "-W", "--show"],
+        });
+        if (listFlag || showFlag) {
+            const pkgList = pm.listInstalled();
+            const pattern = positionals[0];
+            const filtered = pattern
+                ? pkgList.filter((p) => p.name.includes(pattern))
+                : pkgList;
+            if (showFlag) {
+                return {
+                    stdout: filtered.map((p) => `${p.name}\t${p.version}`).join("\n"),
+                    exitCode: 0,
+                };
+            }
+            const rows = filtered.map((p) => {
+                const name = p.name.padEnd(14).slice(0, 14);
+                const ver = p.version.padEnd(15).slice(0, 15);
+                return `ii  ${name} ${ver} amd64 ${(p.description || "").slice(0, 40)}`;
+            });
+            return {
+                stdout: rows.join("\n") || "(no packages match)",
+                exitCode: 0,
+            };
+        }
+        return { stderr: "dpkg-query: need a flag (-l, -W)", exitCode: 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,WAkCvB,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,eAAO,MAAM,SAAS,EAAE,WA8CvB,CAAC"}

package/dist/commands/du.js

@@ -12,9 +12,15 @@ export const duCommand = {
         const p = resolvePath(cwd, target);
         const fmt = (b) => human ? `${(b / 1024).toFixed(1)}K` : String(Math.ceil(b / 1024));
         if (!shell.vfs.exists(p))
-            return { stderr: `du: ${target}: No such file or directory`, exitCode: 1 };
+            return {
+                stderr: `du: ${target}: No such file or directory`,
+                exitCode: 1,
+            };
         if (summary || shell.vfs.stat(p).type === "file") {
-            return { stdout: `${fmt(shell.vfs.getUsageBytes(p))}\t${target}`, exitCode: 0 };
+            return {
+                stdout: `${fmt(shell.vfs.getUsageBytes(p))}\t${target}`,
+                exitCode: 0,
+            };
         }
         const lines = [];
         const walk = (dir, rel) => {

package/dist/commands/echo.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Echo text to stdout with shell-style expansion and escape support.
+ * @category shell
+ * @params ["[-n] [-e] [text...]"]
+ */
 export declare const echoCommand: ShellModule;
 //# sourceMappingURL=echo.d.ts.map

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

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

package/dist/commands/echo.js

@@ -1,23 +1,44 @@
 import { parseArgs } from "./command-helpers";
-import { getAllEnvVars } from "./set";
-function expandEnvVars(input, env) {
-    return input.replace(/\$([A-Za-z_][A-Za-z0-9_]*)/g, (_, name) => {
-        return env[name] ?? "";
-    });
+import { expandSync } from "../utils/expand";
+/**
+ * Expand escape sequences for `echo -e`.
+ * Handles \n \t \r \\ \a \b \f \v and \0NNN (octal).
+ */
+function expandEscapes(text) {
+    return text
+        .replace(/\\n/g, "\n")
+        .replace(/\\t/g, "\t")
+        .replace(/\\r/g, "\r")
+        .replace(/\\\\/g, "\\")
+        .replace(/\\a/g, "\x07")
+        .replace(/\\b/g, "\x08")
+        .replace(/\\f/g, "\x0C")
+        .replace(/\\v/g, "\x0B")
+        .replace(/\\0(\d{1,3})/g, (_, oct) => String.fromCharCode(parseInt(oct, 8)));
 }
+/**
+ * Echo text to stdout with shell-style expansion and escape support.
+ * @category shell
+ * @params ["[-n] [-e] [text...]"]
+ */
 export const echoCommand = {
     name: "echo",
     description: "Display text",
     category: "shell",
-    params: ["[options] [text...]"],
-    run: ({ args, authUser, stdin }) => {
-        const { flags, positionals } = parseArgs(args, { flags: ["-n"] });
-        const newline = !flags.has("-n");
+    params: ["[-n] [-e] [text...]"],
+    run: ({ args, stdin, env }) => {
+        const { flags, positionals } = parseArgs(args, {
+            flags: ["-n", "-e", "-E"],
+        });
+        const noNewline = flags.has("-n");
+        const escapes = flags.has("-e");
         const rawText = positionals.length > 0 ? positionals.join(" ") : (stdin ?? "");
-        const env = getAllEnvVars(authUser);
-        const text = expandEnvVars(rawText, env);
+        // Full expansion: $? ${#VAR} $((expr)) ~ ${VAR:-def} $VAR etc.
+        // $(cmd) is already resolved upstream by runCommand before echo.run is called.
+        const expanded = expandSync(rawText, env?.vars ?? {}, env?.lastExitCode ?? 0);
+        const text = escapes ? expandEscapes(expanded) : expanded;
         return {
-            stdout: newline ? text : text.trimEnd(),
+            stdout: noNewline ? text : `${text}\n`,
             exitCode: 0,
         };
     },

package/dist/commands/env.d.ts

@@ -1,4 +1,9 @@
 /** biome-ignore-all lint/style/useNamingConvention: ENV VARS */
 import type { ShellModule } from "../types/commands";
+/**
+ * Print environment variables for the current session.
+ * @category shell
+ * @params []
+ */
 export declare const envCommand: ShellModule;
 //# sourceMappingURL=env.d.ts.map

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

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

package/dist/commands/env.js

@@ -1,3 +1,8 @@
+/**
+ * Print environment variables for the current session.
+ * @category shell
+ * @params []
+ */
 export const envCommand = {
     name: "env",
     description: "Print environment variables",
@@ -5,6 +10,11 @@ export const envCommand = {
     params: [],
     run: ({ env, authUser }) => {
         const vars = { ...env.vars, USER: authUser, HOME: `/home/${authUser}` };
-        return { stdout: Object.entries(vars).map(([k, v]) => `${k}=${v}`).join("\n"), exitCode: 0 };
+        return {
+            stdout: Object.entries(vars)
+                .map(([k, v]) => `${k}=${v}`)
+                .join("\n"),
+            exitCode: 0,
+        };
     },
 };

package/dist/commands/exit.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Exit the current shell session (closeSession flag).
+ * @category shell
+ * @params ["[code]"]
+ */
 export declare const exitCommand: ShellModule;
 //# sourceMappingURL=exit.d.ts.map

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

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

package/dist/commands/exit.js

@@ -1,6 +1,16 @@
+/**
+ * Exit the current shell session (closeSession flag).
+ * @category shell
+ * @params ["[code]"]
+ */
 export const exitCommand = {
     name: "exit",
     aliases: ["bye"],
-    params: [],
-    run: () => ({ closeSession: true, exitCode: 0 }),
+    description: "Exit the shell session",
+    category: "shell",
+    params: ["[code]"],
+    run: ({ args }) => ({
+        closeSession: true,
+        exitCode: parseInt(args[0] ?? "0", 10) || 0,
+    }),
 };

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,WAsB3B,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,eAAO,MAAM,aAAa,EAAE,WAwB3B,CAAC"}

package/dist/commands/export.js

@@ -5,7 +5,9 @@ export const exportCommand = {
     params: ["[VAR=value]"],
     run: ({ args, env }) => {
         if (args.length === 0) {
-            const out = Object.entries(env.vars).map(([k, v]) => `declare -x ${k}="${v}"`).join("\n");
+            const out = Object.entries(env.vars)
+                .map(([k, v]) => `declare -x ${k}="${v}"`)
+                .join("\n");
             return { stdout: out, exitCode: 0 };
         }
         for (const arg of args) {

package/dist/commands/find.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Find files and directories by name and type with minimal pattern support.
+ * @category files
+ * @params ["[path] [-name <pattern>] [-type f|d]"]
+ */
 export declare const findCommand: ShellModule;
 //# sourceMappingURL=find.d.ts.map

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

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

package/dist/commands/find.js

@@ -1,5 +1,10 @@
 import { getFlag } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Find files and directories by name and type with minimal pattern support.
+ * @category files
+ * @params ["[path] [-name <pattern>] [-type f|d]"]
+ */
 export const findCommand = {
     name: "find",
     description: "Search for files",

package/dist/commands/free.d.ts

@@ -0,0 +1,8 @@
+import type { ShellModule } from "../types/commands";
+/**
+ * Display memory usage information (human / MB / GB options).
+ * @category system
+ * @params ["[-h] [-m] [-g]"]
+ */
+export declare const freeCommand: ShellModule;
+//# sourceMappingURL=free.d.ts.map

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

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

package/dist/commands/free.js

@@ -0,0 +1,43 @@
+import * as os from "node:os";
+import { ifFlag } from "./command-helpers";
+/**
+ * Display memory usage information (human / MB / GB options).
+ * @category system
+ * @params ["[-h] [-m] [-g]"]
+ */
+export const freeCommand = {
+    name: "free",
+    description: "Display amount of free and used memory",
+    category: "system",
+    params: ["[-h] [-m] [-g]"],
+    run: ({ args }) => {
+        const human = ifFlag(args, ["-h", "--human"]);
+        const mb = ifFlag(args, ["-m"]);
+        const gb = ifFlag(args, ["-g"]);
+        const osTotalB = os.totalmem();
+        const osFreeB = os.freemem();
+        const usedB = osTotalB - osFreeB;
+        const sharedB = Math.floor(osTotalB * 0.02);
+        const buffersB = Math.floor(osTotalB * 0.05);
+        const availableB = Math.floor(osFreeB * 0.95);
+        const swapB = Math.floor(osTotalB * 0.5);
+        const fmt = (bytes) => {
+            if (human) {
+                if (bytes >= 1024 * 1024 * 1024)
+                    return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)}G`;
+                if (bytes >= 1024 * 1024)
+                    return `${(bytes / (1024 * 1024)).toFixed(1)}M`;
+                return `${(bytes / 1024).toFixed(1)}K`;
+            }
+            if (gb)
+                return String(Math.floor(bytes / (1024 * 1024 * 1024)));
+            if (mb)
+                return String(Math.floor(bytes / (1024 * 1024)));
+            return String(Math.floor(bytes / 1024));
+        };
+        const header = `               total        used        free      shared  buff/cache   available`;
+        const memRow = `Mem:  ${fmt(osTotalB).padStart(12)} ${fmt(usedB).padStart(11)} ${fmt(osFreeB).padStart(11)} ${fmt(sharedB).padStart(11)} ${fmt(buffersB).padStart(11)} ${fmt(availableB).padStart(11)}`;
+        const swapRow = `Swap: ${fmt(swapB).padStart(12)} ${fmt(0).padStart(11)} ${fmt(swapB).padStart(11)}`;
+        return { stdout: [header, memRow, swapRow].join("\n"), exitCode: 0 };
+    },
+};

package/dist/commands/grep.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Search for a regex pattern in files or stdin with common flags.
+ * @category text
+ * @params ["[-i] [-v] [-n] [-r] <pattern> [file...]"]
+ */
 export declare const grepCommand: ShellModule;
 //# sourceMappingURL=grep.d.ts.map

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,eAAO,MAAM,WAAW,EAAE,WAwFzB,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,WA6FzB,CAAC"}

package/dist/commands/grep.js

@@ -1,12 +1,19 @@
 import { parseArgs } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Search for a regex pattern in files or stdin with common flags.
+ * @category text
+ * @params ["[-i] [-v] [-n] [-r] <pattern> [file...]"]
+ */
 export const grepCommand = {
     name: "grep",
     description: "Search text patterns",
     category: "text",
     params: ["[-i] [-v] [-n] [-r] <pattern> [file...]"],
     run: ({ authUser, shell, cwd, args, stdin }) => {
-        const { flags, positionals } = parseArgs(args, { flags: ["-i", "-v", "-n", "-r"] });
+        const { flags, positionals } = parseArgs(args, {
+            flags: ["-i", "-v", "-n", "-r"],
+        });
         const caseInsensitive = flags.has("-i");
         const invertMatch = flags.has("-v");
         const showLineNumbers = flags.has("-n");
@@ -80,7 +87,10 @@ export const grepCommand = {
                     results.push(...matchLines(content, prefix));
                 }
                 catch {
-                    return { stderr: `grep: ${file}: No such file or directory`, exitCode: 1 };
+                    return {
+                        stderr: `grep: ${file}: No such file or directory`,
+                        exitCode: 1,
+                    };
                 }
             }
         }

package/dist/commands/gzip.d.ts

@@ -1,4 +1,9 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Compress files using gzip (stores in VFS as compressed content).
+ * @category archive
+ * @params ["<file>"]
+ */
 export declare const gzipCommand: ShellModule;
 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,eAAO,MAAM,WAAW,EAAE,WAYzB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,WAa3B,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;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WAmBzB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,WAyB3B,CAAC"}

package/dist/commands/gzip.js

@@ -1,4 +1,9 @@
 import { resolvePath } from "./helpers";
+/**
+ * Compress files using gzip (stores in VFS as compressed content).
+ * @category archive
+ * @params ["<file>"]
+ */
 export const gzipCommand = {
     name: "gzip",
     description: "Compress files",
@@ -14,11 +19,19 @@ export const gzipCommand = {
             return { exitCode: 0 };
         }
         catch {
-            return { stderr: `gzip: ${file}: No such file or directory`, exitCode: 1 };
+            return {
+                stderr: `gzip: ${file}: No such file or directory`,
+                exitCode: 1,
+            };
         }
     },
 };
 export const gunzipCommand = {
+    /**
+     * Decompress gzip files (or zcat alias).
+     * @category archive
+     * @params ["<file>"]
+     */
     name: "gunzip",
     description: "Decompress files",
     category: "archive",
@@ -34,7 +47,10 @@ export const gunzipCommand = {
             return { exitCode: 0 };
         }
         catch {
-            return { stderr: `gunzip: ${file}: No such file or directory`, exitCode: 1 };
+            return {
+                stderr: `gunzip: ${file}: No such file or directory`,
+                exitCode: 1,
+            };
         }
     },
 };

package/dist/commands/head.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Output the first part of files or stdin (head).
+ * @category text
+ * @params ["[-n <lines>] [file...]"]
+ */
 export declare const headCommand: ShellModule;
 //# sourceMappingURL=head.d.ts.map

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,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,WAgCzB,CAAC"}

package/dist/commands/head.js

@@ -1,5 +1,10 @@
 import { getFlag } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Output the first part of files or stdin (head).
+ * @category text
+ * @params ["[-n <lines>] [file...]"]
+ */
 export const headCommand = {
     name: "head",
     description: "Output first lines",

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

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAoBrD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,MAAM,EAAE,GAAG,WAAW,CAyDxE"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA6HrD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,MAAM,EAAE,GAAG,WAAW,CA0BxE"}