typescript-virtual-container 1.3.4 → 1.4.0

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,WAyCzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,WA0B3B,CAAC"}

package/dist/commands/gzip.js

@@ -1,56 +1,76 @@
 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];
+        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/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",

package/dist/commands/mv.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Move or rename files and directories.
+ * @category files
+ * @params ["<source> <dest>"]
+ */
 export declare const mvCommand: ShellModule;
 //# sourceMappingURL=mv.d.ts.map

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

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

package/dist/commands/mv.js

@@ -1,4 +1,9 @@
 import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Move or rename files and directories.
+ * @category files
+ * @params ["<source> <dest>"]
+ */
 export const mvCommand = {
     name: "mv",
     description: "Move or rename files",

package/dist/commands/nano.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Simple text editor for editing files.
+ * @category files
+ * @params ["<file>"]
+ */
 export declare const nanoCommand: ShellModule;
 //# sourceMappingURL=nano.d.ts.map

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

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

package/dist/commands/nano.js

@@ -1,5 +1,10 @@
 import * as path from "node:path";
 import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Simple text editor for editing files.
+ * @category files
+ * @params ["<file>"]
+ */
 export const nanoCommand = {
     name: "nano",
     description: "Text editor",

package/dist/commands/neofetch.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Display system information in a decorative format.
+ * @category system
+ * @params ["[--off]"]
+ */
 export declare const neofetchCommand: ShellModule;
 //# sourceMappingURL=neofetch.d.ts.map

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

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

package/dist/commands/neofetch.js

@@ -1,13 +1,16 @@
 import { buildNeofetchOutput } from "../modules/neofetch";
 import { ifFlag } from "./command-helpers";
-import { getAllEnvVars } from "./set";
+/**
+ * Display system information in a decorative format.
+ * @category system
+ * @params ["[--off]"]
+ */
 export const neofetchCommand = {
     name: "neofetch",
     description: "System info display",
     category: "system",
     params: ["[--off]"],
-    run: ({ args, authUser, hostname, shell }) => {
-        const env = getAllEnvVars(authUser);
+    run: ({ args, authUser, hostname, shell, env }) => {
         if (ifFlag(args, "--help")) {
             return {
                 stdout: "Usage: neofetch [--off]",
@@ -24,9 +27,9 @@ export const neofetchCommand = {
             stdout: buildNeofetchOutput({
                 user: authUser,
                 host: hostname,
-                shell: env.SHELL,
+                shell: env.vars.SHELL,
                 shellProps: shell.properties,
-                terminal: env.TERM,
+                terminal: env.vars.TERM,
                 uptimeSeconds: Math.floor((Date.now() - shell.startTime) / 1000),
                 packages: (() => {
                     const count = shell.packageManager?.installedCount() ?? 0;

package/dist/commands/passwd.d.ts

@@ -1,3 +1,11 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * `passwd [username]` — change a virtual user's password.
+ *
+ * - Root can change any user's password.
+ * - Non-root can only change their own password.
+ * - Interactive: emits `passwordChallenge` for hidden-input prompting.
+ * - Non-interactive: reads new password from stdin first line.
+ */
 export declare const passwdCommand: ShellModule;
 //# sourceMappingURL=passwd.d.ts.map

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

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

package/dist/commands/passwd.js

@@ -1,22 +1,43 @@
+/**
+ * `passwd [username]` — change a virtual user's password.
+ *
+ * - Root can change any user's password.
+ * - Non-root can only change their own password.
+ * - Interactive: emits `passwordChallenge` for hidden-input prompting.
+ * - Non-interactive: reads new password from stdin first line.
+ */
 export const passwdCommand = {
     name: "passwd",
     description: "Change user password",
     category: "users",
-    params: ["<username> <password>"],
-    run: async ({ authUser, args, shell }) => {
-        const [username, password] = args;
-        if (!username || !password) {
+    params: ["[username]"],
+    run: async ({ authUser, args, shell, stdin }) => {
+        const targetUser = args[0] ?? authUser;
+        // Permission check
+        if (authUser !== "root" && authUser !== targetUser) {
+            return { stderr: "passwd: permission denied", exitCode: 1 };
+        }
+        // Target must exist
+        if (!shell.users.listUsers().includes(targetUser)) {
+            return { stderr: `passwd: user '${targetUser}' does not exist`, exitCode: 1 };
+        }
+        // Non-interactive: read new password from stdin
+        if (stdin !== undefined && stdin.trim().length > 0) {
+            const password = stdin.trim().split("\n")[0];
+            await shell.users.setPassword(targetUser, password);
             return {
-                stderr: "passwd: usage: passwd <username> <password>",
-                exitCode: 1,
+                stdout: `passwd: password updated successfully\n`,
+                exitCode: 0,
             };
         }
-        if (authUser !== "root" && authUser !== username) {
-            return { stderr: "passwd: permission denied", exitCode: 1 };
-        }
-        await shell.users.setPassword(username, password);
+        // Interactive: emit password challenge
         return {
-            stdout: `passwd: password updated for '${username}'`,
+            passwordChallenge: {
+                prompt: "New password: ",
+                confirmPrompt: "Retype new password: ",
+                action: "passwd",
+                targetUsername: targetUser,
+            },
             exitCode: 0,
         };
     },

package/dist/commands/ping.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Send ICMP ECHO_REQUEST packets (mock implementation).
+ * @category network
+ * @params ["[-c <count>] <host>"]
+ */
 export declare const pingCommand: ShellModule;
 //# sourceMappingURL=ping.d.ts.map

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

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