typescript-virtual-container 1.2.8 → 1.3.0

package/dist/commands/command-helpers.d.ts

@@ -2,14 +2,88 @@ type ArgParseOptions = {
     flags?: string[];
     flagsWithValue?: string[];
 };
+/**
+ * Returns `true` when any of the given flags appear in `args`.
+ *
+ * Matches both standalone tokens (`-s`, `--silent`) and inline forms
+ * (`--output=file`). Useful for simple boolean flag checks inside command
+ * `run` handlers.
+ *
+ * @param args  Tokenized argument array from `CommandContext.args`.
+ * @param flags Single flag string or array of equivalent flag strings.
+ * @returns `true` if at least one flag is present, otherwise `false`.
+ *
+ * @example
+ * ```ts
+ * ifFlag(args, "-r")              // single flag
+ * ifFlag(args, ["-r", "--recursive"]) // aliases
+ * ```
+ */
 export declare function ifFlag(args: string[], flags: string | string[]): boolean;
+/**
+ * Returns the value associated with a flag, or `true` if the flag is present
+ * but has no associated value, or `undefined` if the flag is absent.
+ *
+ * Handles three forms:
+ * - `--output file`   → returns `"file"` (next token)
+ * - `--output=file`   → returns `"file"` (inline `=` form)
+ * - `--verbose`       → returns `true` (flag with no value)
+ *
+ * @param args  Tokenized argument array from `CommandContext.args`.
+ * @param flags Single flag string or array of equivalent flag strings.
+ * @returns The flag value string, `true` when valueless, or `undefined`.
+ *
+ * @example
+ * ```ts
+ * const output = getFlag(args, ["-o", "--output"]);
+ * if (typeof output === "string") { /* use path *\/ }
+ * ```
+ */
 export declare function getFlag(args: string[], flags: string | string[]): string | true | undefined;
+/**
+ * Returns the positional argument at the given zero-based index, skipping
+ * known flags and their values.
+ *
+ * Flags declared in `options.flags` are treated as boolean and skipped.
+ * Flags declared in `options.flagsWithValue` consume the next token too.
+ * Tokens after `--` are always treated as positionals.
+ *
+ * @param args    Tokenized argument array from `CommandContext.args`.
+ * @param index   Zero-based positional index to retrieve.
+ * @param options Optional flag declarations to skip during positional collection.
+ * @returns The positional value, or `undefined` if the index is out of range.
+ *
+ * @example
+ * ```ts
+ * // args = ["-r", "src", "dest"]
+ * getArg(args, 0, { flags: ["-r"] }) // "src"
+ * getArg(args, 1, { flags: ["-r"] }) // "dest"
+ * ```
+ */
 export declare function getArg(args: string[], index: number, options?: ArgParseOptions): string | undefined;
 /**
- * Parse arguments into flags, flags with values, and positionals.
- * @param args - Array of arguments to parse.
- * @param options - Parsing options for flags and flags with values.
- * @returns Parsed arguments as { flags, flagsWithValues, positionals }.
+ * Parses an argument array into structured flags, flag values, and positionals.
+ *
+ * - `options.flags` — boolean flags (e.g. `["-r", "--recursive"]`); collected
+ *   into a `Set<string>` and not treated as positionals.
+ * - `options.flagsWithValue` — flags that consume the next token or an inline
+ *   `=value`; collected into a `Map<string, string>`.
+ * - All remaining tokens are positionals.
+ * - Tokens after `--` are always positionals, regardless of `-` prefix.
+ *
+ * @param args    Tokenized argument array from `CommandContext.args`.
+ * @param options Flag declaration lists.
+ * @returns `{ flags, flagsWithValues, positionals }`.
+ *
+ * @example
+ * ```ts
+ * const { flags, flagsWithValues, positionals } = parseArgs(args, {
+ *   flags:          ["-r", "--recursive"],
+ *   flagsWithValue: ["-o", "--output"],
+ * });
+ * const recursive = flags.has("-r");
+ * const output    = flagsWithValues.get("-o");
+ * ```
  */
 export declare function parseArgs(args: string[], options?: {
     flags?: string[];

package/dist/commands/command-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/command-helpers.ts"],"names":[],"mappings":"AAAA,KAAK,eAAe,GAAG;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AA+EF,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAYxE;AAED,wBAAgB,OAAO,CACtB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GACtB,MAAM,GAAG,IAAI,GAAG,SAAS,CA0B3B;AAED,wBAAgB,MAAM,CACrB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,eAAoB,GAC3B,MAAM,GAAG,SAAS,CAGpB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACxB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAC3D;IACF,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB,CAiDA"}
+{"version":3,"file":"command-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/command-helpers.ts"],"names":[],"mappings":"AAAA,KAAK,eAAe,GAAG;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AA+EF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAYxE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,OAAO,CACtB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GACtB,MAAM,GAAG,IAAI,GAAG,SAAS,CA0B3B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CACrB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,eAAoB,GAC3B,MAAM,GAAG,SAAS,CAGpB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,SAAS,CACxB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAC3D;IACF,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,WAAW,EAAE,MAAM,EAAE,CAAC;CACtB,CAiDA"}

package/dist/commands/command-helpers.js

@@ -54,6 +54,23 @@ function collectPositionals(args, options = {}) {
     }
     return positionals;
 }
+/**
+ * Returns `true` when any of the given flags appear in `args`.
+ *
+ * Matches both standalone tokens (`-s`, `--silent`) and inline forms
+ * (`--output=file`). Useful for simple boolean flag checks inside command
+ * `run` handlers.
+ *
+ * @param args  Tokenized argument array from `CommandContext.args`.
+ * @param flags Single flag string or array of equivalent flag strings.
+ * @returns `true` if at least one flag is present, otherwise `false`.
+ *
+ * @example
+ * ```ts
+ * ifFlag(args, "-r")              // single flag
+ * ifFlag(args, ["-r", "--recursive"]) // aliases
+ * ```
+ */
 export function ifFlag(args, flags) {
     const allFlags = toFlagList(flags);
     for (const arg of args) {
@@ -65,6 +82,25 @@ export function ifFlag(args, flags) {
     }
     return false;
 }
+/**
+ * Returns the value associated with a flag, or `true` if the flag is present
+ * but has no associated value, or `undefined` if the flag is absent.
+ *
+ * Handles three forms:
+ * - `--output file`   → returns `"file"` (next token)
+ * - `--output=file`   → returns `"file"` (inline `=` form)
+ * - `--verbose`       → returns `true` (flag with no value)
+ *
+ * @param args  Tokenized argument array from `CommandContext.args`.
+ * @param flags Single flag string or array of equivalent flag strings.
+ * @returns The flag value string, `true` when valueless, or `undefined`.
+ *
+ * @example
+ * ```ts
+ * const output = getFlag(args, ["-o", "--output"]);
+ * if (typeof output === "string") { /* use path *\/ }
+ * ```
+ */
 export function getFlag(args, flags) {
     const allFlags = toFlagList(flags);
     for (let index = 0; index < args.length; index += 1) {
@@ -86,15 +122,53 @@ export function getFlag(args, flags) {
     }
     return undefined;
 }
+/**
+ * Returns the positional argument at the given zero-based index, skipping
+ * known flags and their values.
+ *
+ * Flags declared in `options.flags` are treated as boolean and skipped.
+ * Flags declared in `options.flagsWithValue` consume the next token too.
+ * Tokens after `--` are always treated as positionals.
+ *
+ * @param args    Tokenized argument array from `CommandContext.args`.
+ * @param index   Zero-based positional index to retrieve.
+ * @param options Optional flag declarations to skip during positional collection.
+ * @returns The positional value, or `undefined` if the index is out of range.
+ *
+ * @example
+ * ```ts
+ * // args = ["-r", "src", "dest"]
+ * getArg(args, 0, { flags: ["-r"] }) // "src"
+ * getArg(args, 1, { flags: ["-r"] }) // "dest"
+ * ```
+ */
 export function getArg(args, index, options = {}) {
     const positionals = collectPositionals(args, options);
     return positionals[index];
 }
 /**
- * Parse arguments into flags, flags with values, and positionals.
- * @param args - Array of arguments to parse.
- * @param options - Parsing options for flags and flags with values.
- * @returns Parsed arguments as { flags, flagsWithValues, positionals }.
+ * Parses an argument array into structured flags, flag values, and positionals.
+ *
+ * - `options.flags` — boolean flags (e.g. `["-r", "--recursive"]`); collected
+ *   into a `Set<string>` and not treated as positionals.
+ * - `options.flagsWithValue` — flags that consume the next token or an inline
+ *   `=value`; collected into a `Map<string, string>`.
+ * - All remaining tokens are positionals.
+ * - Tokens after `--` are always positionals, regardless of `-` prefix.
+ *
+ * @param args    Tokenized argument array from `CommandContext.args`.
+ * @param options Flag declaration lists.
+ * @returns `{ flags, flagsWithValues, positionals }`.
+ *
+ * @example
+ * ```ts
+ * const { flags, flagsWithValues, positionals } = parseArgs(args, {
+ *   flags:          ["-r", "--recursive"],
+ *   flagsWithValue: ["-o", "--output"],
+ * });
+ * const recursive = flags.has("-r");
+ * const output    = flagsWithValues.get("-o");
+ * ```
  */
 export function parseArgs(args, options = {}) {
     const flags = new Set();

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;AASrD,eAAO,MAAM,WAAW,EAAE,WAmDzB,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,46 +1,126 @@
-import { parseArgs } from "./command-helpers";
-import { assertPathAccess, normalizeTerminalOutput, resolvePath, runHostCommand, } from "./helpers";
+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: "HTTP client",
+    description: "Transfer data from or to a server (pure fetch)",
     category: "network",
-    params: ["[-o file] <url>"],
+    params: ["[options] <url>"],
     run: async ({ authUser, cwd, args, shell }) => {
         const { flagsWithValues, positionals } = parseArgs(args, {
-            flagsWithValue: ["-o", "--output"],
+            flagsWithValue: [
+                "-o",
+                "--output",
+                "-X",
+                "--request",
+                "-d",
+                "--data",
+                "-H",
+                "--header",
+                "-u",
+                "--user",
+            ],
         });
-        const outputPath = flagsWithValues.get("-o") || flagsWithValues.get("--output") || null;
+        if (ifFlag(args, ["--help", "-h"])) {
+            return {
+                stdout: [
+                    "Usage: curl [options] <url>",
+                    "  -o, --output <file>    Write to file",
+                    "  -X, --request <method> HTTP method",
+                    "  -d, --data <data>      POST data",
+                    "  -H, --header <hdr>     Extra header",
+                    "  -s, --silent           Silent mode",
+                    "  -I, --head             Fetch headers only",
+                    "  -L, --location         Follow redirects",
+                    "  -v, --verbose          Verbose",
+                ].join("\n"),
+                exitCode: 0,
+            };
+        }
         const url = positionals[0];
-        if (!url) {
-            return { stderr: "curl: missing URL", exitCode: 1 };
-        }
-        const passthroughArgs = outputPath
-            ? [...positionals, "-o", "-"]
-            : positionals;
-        const result = await runHostCommand("curl", passthroughArgs);
-        if (result.exitCode !== 0) {
+        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 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",
+        };
+        if (headerRaw) {
+            const idx = headerRaw.indexOf(":");
+            if (idx !== -1)
+                extraHeaders[headerRaw.slice(0, idx).trim()] = headerRaw
+                    .slice(idx + 1)
+                    .trim();
+        }
+        const finalMethod = postData && method === "GET" ? "POST" : method;
+        const fetchOpts = {
+            method: finalMethod,
+            headers: extraHeaders,
+            redirect: followRedirects ? "follow" : "manual",
+        };
+        if (postData) {
+            extraHeaders["Content-Type"] ??= "application/x-www-form-urlencoded";
+            fetchOpts.body = postData;
+        }
+        const stderrLines = [];
+        if (verbose) {
+            stderrLines.push(`* Trying ${url}...`, `* Connected`);
+            stderrLines.push(`> ${finalMethod} / HTTP/1.1`, `> Host: ${new URL(url).host}`);
+        }
+        let response;
+        try {
+            response = await fetch(url, fetchOpts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
             return {
-                stderr: normalizeTerminalOutput(result.stderr || `curl: exited with code ${result.exitCode}`),
-                exitCode: result.exitCode,
+                stderr: `curl: (6) Could not resolve host: ${msg}`,
+                exitCode: 6,
             };
         }
+        if (verbose) {
+            stderrLines.push(`< HTTP/1.1 ${response.status} ${response.statusText}`);
+        }
+        if (headOnly) {
+            const lines = [`HTTP/1.1 ${response.status} ${response.statusText}`];
+            for (const [k, v] of response.headers.entries())
+                lines.push(`${k}: ${v}`);
+            return { stdout: `${lines.join("\r\n")}\r\n`, exitCode: 0 };
+        }
+        let body;
+        try {
+            body = await response.text();
+        }
+        catch {
+            return { stderr: "curl: failed to read response body", exitCode: 1 };
+        }
         if (outputPath) {
             const target = resolvePath(cwd, outputPath);
             assertPathAccess(authUser, target, "curl");
-            shell.writeFileAsUser(authUser, target, result.stdout);
+            shell.writeFileAsUser(authUser, target, body);
+            if (!silent)
+                stderrLines.push(`  % Total    % Received\n100 ${body.length}  100 ${body.length}`);
             return {
-                stderr: result.stderr
-                    ? normalizeTerminalOutput(result.stderr)
-                    : undefined,
-                exitCode: 0,
+                stderr: stderrLines.join("\n") || undefined,
+                exitCode: response.ok ? 0 : 22,
             };
         }
         return {
-            stdout: result.stdout,
-            stderr: result.stderr
-                ? normalizeTerminalOutput(result.stderr)
-                : undefined,
-            exitCode: 0,
+            stdout: body,
+            stderr: stderrLines.length > 0 ? stderrLines.join("\n") : undefined,
+            exitCode: response.ok ? 0 : 22,
         };
     },
 };

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",

package/dist/commands/dpkg.d.ts

@@ -0,0 +1,9 @@
+import type { ShellModule } from "../types/commands";
+/**
+ * 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 declare const dpkgCommand: ShellModule;
+export declare const dpkgQueryCommand: ShellModule;
+//# sourceMappingURL=dpkg.d.ts.map

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

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