typescript-virtual-container 1.2.9 → 1.3.0

package/dist/VirtualUserManager/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/VirtualUserManager/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/VirtualUserManager/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/adduser.d.ts

@@ -1,3 +1,9 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Add a new user to the virtual user database.
+ * @category users
+ * @params ["<username> <password>"]
+ * @returns ShellModule
+ */
 export declare const adduserCommand: ShellModule;
 //# sourceMappingURL=adduser.d.ts.map

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

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

package/dist/commands/adduser.js

@@ -1,3 +1,9 @@
+/**
+ * Add a new user to the virtual user database.
+ * @category users
+ * @params ["<username> <password>"]
+ * @returns ShellModule
+ */
 export const adduserCommand = {
     name: "adduser",
     description: "Add a new user",

package/dist/commands/alias.d.ts

@@ -1,4 +1,9 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Manage shell aliases (list / set / remove).
+ * @category shell
+ * @params ["[name[=value] ...]"]
+ */
 export declare const aliasCommand: ShellModule;
 export declare const unaliasCommand: ShellModule;
 //# sourceMappingURL=alias.d.ts.map

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

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

package/dist/commands/alias.js

@@ -1,4 +1,9 @@
 import { ifFlag } from "./command-helpers";
+/**
+ * Manage shell aliases (list / set / remove).
+ * @category shell
+ * @params ["[name[=value] ...]"]
+ */
 export const aliasCommand = {
     name: "alias",
     description: "Define or display aliases",

package/dist/commands/apt.d.ts

@@ -1,4 +1,9 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * APT package manager front-end (simulated).
+ * @category package
+ * @params ["<install|remove|update|upgrade|search|show|list> [pkg...]"]
+ */
 export declare const aptCommand: ShellModule;
 export declare const aptCacheCommand: ShellModule;
 //# sourceMappingURL=apt.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"apt.d.ts","sourceRoot":"","sources":["../../src/commands/apt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,eAAO,MAAM,UAAU,EAAE,WA2IxB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAoD7B,CAAC"}
+{"version":3,"file":"apt.d.ts","sourceRoot":"","sources":["../../src/commands/apt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,WAyJxB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WA+D7B,CAAC"}

package/dist/commands/apt.js

@@ -1,10 +1,15 @@
-import { ifFlag, } from "./command-helpers";
+import { ifFlag } from "./command-helpers";
 import { getPackageManager } from "./helpers";
+/**
+ * APT package manager front-end (simulated).
+ * @category package
+ * @params ["<install|remove|update|upgrade|search|show|list> [pkg...]"]
+ */
 export const aptCommand = {
     name: "apt",
     aliases: ["apt-get"],
     description: "Package manager",
-    category: "system",
+    category: "package",
     params: ["<install|remove|update|upgrade|search|show|list> [pkg...]"],
     run: ({ args, shell, authUser }) => {
         const pm = getPackageManager(shell);
@@ -87,7 +92,10 @@ export const aptCommand = {
                     return { stderr: "apt: show requires a package name", exitCode: 1 };
                 const info = pm.show(name);
                 if (!info)
-                    return { stderr: `N: Unable to locate package ${name}`, exitCode: 100 };
+                    return {
+                        stderr: `N: Unable to locate package ${name}`,
+                        exitCode: 100,
+                    };
                 return { stdout: info, exitCode: 0 };
             }
             case "list": {
@@ -95,9 +103,15 @@ export const aptCommand = {
                 if (installedFlag) {
                     const pkgList = pm.listInstalled();
                     if (pkgList.length === 0)
-                        return { stdout: "Listing... Done\n(no packages installed)", exitCode: 0 };
+                        return {
+                            stdout: "Listing... Done\n(no packages installed)",
+                            exitCode: 0,
+                        };
                     const lines = pkgList.map((p) => `${p.name}/${p.section} ${p.version} ${p.architecture} [installed]`);
-                    return { stdout: `Listing... Done\n${lines.join("\n")}`, exitCode: 0 };
+                    return {
+                        stdout: `Listing... Done\n${lines.join("\n")}`,
+                        exitCode: 0,
+                    };
                 }
                 // all available
                 const all = pm.listAvailable();
@@ -128,12 +142,15 @@ export const aptCommand = {
 export const aptCacheCommand = {
     name: "apt-cache",
     description: "Query the package cache",
-    category: "system",
+    category: "package",
     params: ["<search|show|policy> [pkg]"],
     run: ({ args, shell }) => {
         const pm = getPackageManager(shell);
         if (!pm)
-            return { stderr: "apt-cache: package manager not initialised", exitCode: 1 };
+            return {
+                stderr: "apt-cache: package manager not initialised",
+                exitCode: 1,
+            };
         const sub = args[0]?.toLowerCase();
         const pkgName = args[1];
         switch (sub) {
@@ -161,7 +178,10 @@ export const aptCacheCommand = {
                     return { stderr: "Need a package name", exitCode: 1 };
                 const def = pm.findInRegistry(pkgName);
                 if (!def)
-                    return { stderr: `N: Unable to locate package ${pkgName}`, exitCode: 100 };
+                    return {
+                        stderr: `N: Unable to locate package ${pkgName}`,
+                        exitCode: 100,
+                    };
                 const inst = pm.isInstalled(pkgName);
                 return {
                     stdout: [
@@ -176,7 +196,10 @@ export const aptCacheCommand = {
                 };
             }
             default:
-                return { stderr: `apt-cache: unknown command '${sub ?? ""}'`, exitCode: 1 };
+                return {
+                    stderr: `apt-cache: unknown command '${sub ?? ""}'`,
+                    exitCode: 1,
+                };
         }
     },
 };

package/dist/commands/awk.d.ts

@@ -1,3 +1,14 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Minimal `awk`-like pattern scanner (supports simple print patterns).
+ * @category text
+ * @params ["[-F <sep>] '<program>' [file]"]
+ *
+ * Supported program patterns:
+ * - `print $N` (e.g. `print $1`, `print $2, $3`, `print $0`)
+ * - `{print $N}` (e.g. `{print $1}`, `{print $2, $3}`, `{print $0}`)
+ *
+ * The field separator can be set with `-F` (default is space, which splits on any whitespace).
+ */
 export declare const awkCommand: ShellModule;
 //# sourceMappingURL=awk.d.ts.map

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

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

package/dist/commands/awk.js

@@ -1,4 +1,15 @@
 import { getFlag } from "./command-helpers";
+/**
+ * Minimal `awk`-like pattern scanner (supports simple print patterns).
+ * @category text
+ * @params ["[-F <sep>] '<program>' [file]"]
+ *
+ * Supported program patterns:
+ * - `print $N` (e.g. `print $1`, `print $2, $3`, `print $0`)
+ * - `{print $N}` (e.g. `{print $1}`, `{print $2, $3}`, `{print $0}`)
+ *
+ * The field separator can be set with `-F` (default is space, which splits on any whitespace).
+ */
 export const awkCommand = {
     name: "awk",
     description: "Pattern scanning and processing language (minimal)",
@@ -17,12 +28,14 @@ export const awkCommand = {
         const lines = (stdin ?? "").split("\n").filter(Boolean);
         const out = lines.map((line) => {
             const parts = line.split(sep === " " ? /\s+/ : sep);
-            return fields.map((f) => {
+            return fields
+                .map((f) => {
                 if (f === "$0")
                     return line;
                 const n = parseInt(f.replace("$", ""), 10);
                 return Number.isNaN(n) ? f.replace(/"/g, "") : (parts[n - 1] ?? "");
-            }).join(sep === " " ? "\t" : sep);
+            })
+                .join(sep === " " ? "\t" : sep);
         });
         return { stdout: out.join("\n"), exitCode: 0 };
     },

package/dist/commands/base64.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Encode or decode base64 data.
+ * @category text
+ * @params ["[-d] [file]"]
+ */
 export declare const base64Command: ShellModule;
 //# sourceMappingURL=base64.d.ts.map

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

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

package/dist/commands/base64.js

@@ -1,4 +1,9 @@
 import { ifFlag } from "./command-helpers";
+/**
+ * Encode or decode base64 data.
+ * @category text
+ * @params ["[-d] [file]"]
+ */
 export const base64Command = {
     name: "base64",
     description: "Encode/decode base64",
@@ -9,7 +14,10 @@ export const base64Command = {
         const input = stdin ?? "";
         if (decode) {
             try {
-                return { stdout: Buffer.from(input.trim(), "base64").toString("utf8"), exitCode: 0 };
+                return {
+                    stdout: Buffer.from(input.trim(), "base64").toString("utf8"),
+                    exitCode: 0,
+                };
             }
             catch {
                 return { stderr: "base64: invalid input", exitCode: 1 };

package/dist/commands/cat.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Concatenate and print files to stdout.
+ * @category files
+ * @params ["[-n] [-b] <file...>"]
+ */
 export declare const catCommand: ShellModule;
 //# sourceMappingURL=cat.d.ts.map

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

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

package/dist/commands/cat.js

@@ -1,5 +1,10 @@
 import { ifFlag } from "./command-helpers";
 import { assertPathAccess, resolveReadablePath } from "./helpers";
+/**
+ * Concatenate and print files to stdout.
+ * @category files
+ * @params ["[-n] [-b] <file...>"]
+ */
 export const catCommand = {
     name: "cat",
     description: "Concatenate and print files",
@@ -26,11 +31,14 @@ export const catCommand = {
             return { stdout: combined, exitCode: 0 };
         }
         let lineNum = 1;
-        const numbered = combined.split("\n").map((line) => {
+        const numbered = combined
+            .split("\n")
+            .map((line) => {
             if (numberNonBlank && line.trim() === "")
                 return line;
             return `${String(lineNum++).padStart(6)}\t${line}`;
-        }).join("\n");
+        })
+            .join("\n");
         return { stdout: numbered, exitCode: 0 };
     },
 };

package/dist/commands/cd.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Change current working directory.
+ * @category navigation
+ * @params ["[path]"]
+ */
 export declare const cdCommand: ShellModule;
 //# sourceMappingURL=cd.d.ts.map

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

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

package/dist/commands/cd.js

@@ -1,4 +1,9 @@
 import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Change current working directory.
+ * @category navigation
+ * @params ["[path]"]
+ */
 export const cdCommand = {
     name: "cd",
     description: "Change directory",

package/dist/commands/chmod.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Change file permissions (octal or symbolic).
+ * @category files
+ * @params ["<mode> <file>"]
+ */
 export declare const chmodCommand: ShellModule;
 //# sourceMappingURL=chmod.d.ts.map

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

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

package/dist/commands/chmod.js

@@ -38,6 +38,11 @@ function applySymbolicMode(existing, modeStr) {
     }
     return mode;
 }
+/**
+ * Change file permissions (octal or symbolic).
+ * @category files
+ * @params ["<mode> <file>"]
+ */
 export const chmodCommand = {
     name: "chmod",
     description: "Change file permissions",

package/dist/commands/cp.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Copy files or directories inside the virtual filesystem.
+ * @category files
+ * @params ["[-r] <source> <dest>"]
+ */
 export declare const cpCommand: ShellModule;
 //# sourceMappingURL=cp.d.ts.map

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

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

package/dist/commands/cp.js

@@ -1,5 +1,10 @@
 import { ifFlag } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * Copy files or directories inside the virtual filesystem.
+ * @category files
+ * @params ["[-r] <source> <dest>"]
+ */
 export const cpCommand = {
     name: "cp",
     description: "Copy files or directories",

package/dist/commands/curl.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * HTTP client wrapper using `fetch()` semantics (virtual curl).
+ * @category network
+ * @params ["[options] <url>"]
+ */
 export declare const curlCommand: ShellModule;
 //# sourceMappingURL=curl.d.ts.map

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

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

package/dist/commands/curl.js

@@ -1,5 +1,10 @@
 import { ifFlag, parseArgs } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
+/**
+ * HTTP client wrapper using `fetch()` semantics (virtual curl).
+ * @category network
+ * @params ["[options] <url>"]
+ */
 export const curlCommand = {
     name: "curl",
     description: "Transfer data from or to a server (pure fetch)",
@@ -7,7 +12,18 @@ export const curlCommand = {
     params: ["[options] <url>"],
     run: async ({ authUser, cwd, args, shell }) => {
         const { flagsWithValues, positionals } = parseArgs(args, {
-            flagsWithValue: ["-o", "--output", "-X", "--request", "-d", "--data", "-H", "--header", "-u", "--user"],
+            flagsWithValue: [
+                "-o",
+                "--output",
+                "-X",
+                "--request",
+                "-d",
+                "--data",
+                "-H",
+                "--header",
+                "-u",
+                "--user",
+            ],
         });
         if (ifFlag(args, ["--help", "-h"])) {
             return {
@@ -29,18 +45,24 @@ export const curlCommand = {
         if (!url)
             return { stderr: "curl: no URL specified", exitCode: 1 };
         const outputPath = flagsWithValues.get("-o") ?? flagsWithValues.get("--output") ?? null;
-        const method = (flagsWithValues.get("-X") ?? flagsWithValues.get("--request") ?? "GET").toUpperCase();
+        const method = (flagsWithValues.get("-X") ??
+            flagsWithValues.get("--request") ??
+            "GET").toUpperCase();
         const postData = flagsWithValues.get("-d") ?? flagsWithValues.get("--data") ?? null;
         const headerRaw = flagsWithValues.get("-H") ?? flagsWithValues.get("--header") ?? null;
         const silent = ifFlag(args, ["-s", "--silent"]);
         const headOnly = ifFlag(args, ["-I", "--head"]);
         const followRedirects = ifFlag(args, ["-L", "--location"]);
         const verbose = ifFlag(args, ["-v", "--verbose"]);
-        const extraHeaders = { "User-Agent": "curl/7.88.1" };
+        const extraHeaders = {
+            "User-Agent": "curl/7.88.1",
+        };
         if (headerRaw) {
             const idx = headerRaw.indexOf(":");
             if (idx !== -1)
-                extraHeaders[headerRaw.slice(0, idx).trim()] = headerRaw.slice(idx + 1).trim();
+                extraHeaders[headerRaw.slice(0, idx).trim()] = headerRaw
+                    .slice(idx + 1)
+                    .trim();
         }
         const finalMethod = postData && method === "GET" ? "POST" : method;
         const fetchOpts = {
@@ -63,7 +85,10 @@ export const curlCommand = {
         }
         catch (err) {
             const msg = err instanceof Error ? err.message : String(err);
-            return { stderr: `curl: (6) Could not resolve host: ${msg}`, exitCode: 6 };
+            return {
+                stderr: `curl: (6) Could not resolve host: ${msg}`,
+                exitCode: 6,
+            };
         }
         if (verbose) {
             stderrLines.push(`< HTTP/1.1 ${response.status} ${response.statusText}`);
@@ -87,7 +112,10 @@ export const curlCommand = {
             shell.writeFileAsUser(authUser, target, body);
             if (!silent)
                 stderrLines.push(`  % Total    % Received\n100 ${body.length}  100 ${body.length}`);
-            return { stderr: stderrLines.join("\n") || undefined, exitCode: response.ok ? 0 : 22 };
+            return {
+                stderr: stderrLines.join("\n") || undefined,
+                exitCode: response.ok ? 0 : 22,
+            };
         }
         return {
             stdout: body,

package/dist/commands/cut.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Extract selected fields from each line of input.
+ * @category text
+ * @params ["-d <delim> -f <fields> [file]"]
+ */
 export declare const cutCommand: ShellModule;
 //# sourceMappingURL=cut.d.ts.map

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

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

package/dist/commands/cut.js

@@ -1,4 +1,9 @@
 import { getFlag } from "./command-helpers";
+/**
+ * Extract selected fields from each line of input.
+ * @category text
+ * @params ["-d <delim> -f <fields> [file]"]
+ */
 export const cutCommand = {
     name: "cut",
     description: "Remove sections from lines",
@@ -9,7 +14,9 @@ export const cutCommand = {
         const fields = getFlag(args, ["-f"]) ?? "1";
         const cols = fields.split(",").map((f) => {
             const [a, b] = f.split("-").map(Number);
-            return b !== undefined ? { from: (a ?? 1) - 1, to: b - 1 } : { from: (a ?? 1) - 1, to: (a ?? 1) - 1 };
+            return b !== undefined
+                ? { from: (a ?? 1) - 1, to: b - 1 }
+                : { from: (a ?? 1) - 1, to: (a ?? 1) - 1 };
         });
         const lines = (stdin ?? "").split("\n");
         const out = lines.map((line) => {

package/dist/commands/date.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Print the current date/time or a formatted representation.
+ * @category system
+ * @params ["[+format]"]
+ */
 export declare const dateCommand: ShellModule;
 //# sourceMappingURL=date.d.ts.map

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

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

package/dist/commands/date.js

@@ -1,3 +1,8 @@
+/**
+ * Print the current date/time or a formatted representation.
+ * @category system
+ * @params ["[+format]"]
+ */
 export const dateCommand = {
     name: "date",
     description: "Print current date and time",
@@ -7,7 +12,8 @@ export const dateCommand = {
         const now = new Date();
         const fmt = args[0];
         if (fmt?.startsWith("+")) {
-            const f = fmt.slice(1)
+            const f = fmt
+                .slice(1)
                 .replace("%Y", String(now.getFullYear()))
                 .replace("%m", String(now.getMonth() + 1).padStart(2, "0"))
                 .replace("%d", String(now.getDate()).padStart(2, "0"))

package/dist/commands/declare.d.ts

@@ -0,0 +1,3 @@
+import type { ShellModule } from "../types/commands";
+export declare const declareCommand: ShellModule;
+//# sourceMappingURL=declare.d.ts.map

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

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

package/dist/commands/declare.js

@@ -0,0 +1,39 @@
+import { ifFlag } from "./command-helpers";
+export const declareCommand = {
+    name: "declare",
+    aliases: ["local", "typeset"],
+    description: "Declare variables and give them attributes",
+    category: "shell",
+    params: ["[-i] [-r] [-x] [-a] [name[=value]...]"],
+    run: ({ args, env }) => {
+        if (!env)
+            return { exitCode: 0 };
+        const integer = ifFlag(args, ["-i"]);
+        const _readonly = ifFlag(args, ["-r"]);
+        const _export_ = ifFlag(args, ["-x"]);
+        const printAll = args.filter((a) => !a.startsWith("-")).length === 0;
+        if (printAll) {
+            const lines = Object.entries(env.vars).map(([k, v]) => `declare -- ${k}="${v}"`);
+            return { stdout: lines.join("\n"), exitCode: 0 };
+        }
+        const assignments = args.filter((a) => !a.startsWith("-"));
+        for (const token of assignments) {
+            const eq = token.indexOf("=");
+            if (eq === -1) {
+                // Just declare (no value)
+                if (!(token in env.vars))
+                    env.vars[token] = "";
+            }
+            else {
+                const name = token.slice(0, eq);
+                let val = token.slice(eq + 1);
+                if (integer) {
+                    const n = parseInt(val, 10);
+                    val = Number.isNaN(n) ? "0" : String(n);
+                }
+                env.vars[name] = val;
+            }
+        }
+        return { exitCode: 0 };
+    },
+};

package/dist/commands/diff.d.ts

@@ -1,3 +1,8 @@
 import type { ShellModule } from "../types/commands";
+/**
+ * Compare files line-by-line and print differing lines.
+ * @category text
+ * @params ["<file1> <file2>"]
+ */
 export declare const diffCommand: ShellModule;
 //# sourceMappingURL=diff.d.ts.map

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

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

package/dist/commands/diff.js

@@ -1,4 +1,9 @@
 import { resolvePath } from "./helpers";
+/**
+ * Compare files line-by-line and print differing lines.
+ * @category text
+ * @params ["<file1> <file2>"]
+ */
 export const diffCommand = {
     name: "diff",
     description: "Compare files line by line",