typescript-virtual-container 1.4.4 → 1.4.5

package/dist/commands/help.js

@@ -0,0 +1,124 @@
+import { getCommandModulesPublic } from "./registry";
+// ─── category config ──────────────────────────────────────────────────────────
+const CATEGORY_ORDER = [
+    "navigation",
+    "files",
+    "text",
+    "archive",
+    "system",
+    "package",
+    "network",
+    "shell",
+    "users",
+    "misc",
+];
+const CATEGORY_LABELS = {
+    navigation: "Navigation",
+    files: "Files & Filesystem",
+    text: "Text Processing",
+    archive: "Archive & Compression",
+    system: "System",
+    package: "Package Management",
+    network: "Network",
+    shell: "Shell & Scripting",
+    users: "Users & Permissions",
+    misc: "Miscellaneous",
+};
+// ─── formatting helpers ───────────────────────────────────────────────────────
+const BOLD = "\x1b[1m";
+const RESET = "\x1b[0m";
+const CYAN = "\x1b[36m";
+const YLW = "\x1b[33m";
+const DIM = "\x1b[2m";
+const GREEN = "\x1b[32m";
+function pad(s, n) {
+    return s.length >= n ? s : s + " ".repeat(n - s.length);
+}
+function formatCmdLine(mod) {
+    const aliases = mod.aliases?.length
+        ? ` ${DIM}(${mod.aliases.join(", ")})${RESET}`
+        : "";
+    return `  ${CYAN}${pad(mod.name, 16)}${RESET}${aliases}${pad("", mod.aliases?.length ? 0 : 0)} ${mod.description ?? ""}`;
+}
+// ─── full grouped listing ─────────────────────────────────────────────────────
+function renderFull(modules) {
+    const grouped = {};
+    for (const mod of modules) {
+        const cat = mod.category ?? "misc";
+        if (!grouped[cat])
+            grouped[cat] = [];
+        grouped[cat].push(mod);
+    }
+    const lines = [
+        `${BOLD}Available commands${RESET}`,
+        `${DIM}Type 'help <command>' for detailed usage.${RESET}`,
+        "",
+    ];
+    const cats = [
+        ...CATEGORY_ORDER.filter((c) => grouped[c]),
+        ...Object.keys(grouped)
+            .filter((c) => !CATEGORY_ORDER.includes(c))
+            .sort(),
+    ];
+    for (const cat of cats) {
+        const mods = grouped[cat];
+        if (!mods?.length)
+            continue;
+        lines.push(`${YLW}${CATEGORY_LABELS[cat] ?? cat}${RESET}`);
+        const sorted = [...mods].sort((a, b) => a.name.localeCompare(b.name));
+        for (const mod of sorted) {
+            lines.push(formatCmdLine(mod));
+        }
+        lines.push("");
+    }
+    const total = modules.length;
+    lines.push(`${DIM}${total} commands available.${RESET}`);
+    return lines.join("\n");
+}
+// ─── single-command detail ────────────────────────────────────────────────────
+function renderDetail(mod) {
+    const lines = [];
+    lines.push(`${BOLD}${mod.name}${RESET} — ${mod.description ?? "no description"}`);
+    if (mod.aliases?.length) {
+        lines.push(`${DIM}Aliases: ${mod.aliases.join(", ")}${RESET}`);
+    }
+    lines.push("");
+    lines.push(`${GREEN}Usage:${RESET}`);
+    if (mod.params.length) {
+        for (const p of mod.params) {
+            lines.push(`  ${mod.name} ${p}`);
+        }
+    }
+    else {
+        lines.push(`  ${mod.name}`);
+    }
+    const catLabel = CATEGORY_LABELS[mod.category ?? "misc"] ?? mod.category ?? "misc";
+    lines.push("");
+    lines.push(`${DIM}Category: ${catLabel}${RESET}`);
+    return lines.join("\n");
+}
+// ─── export ───────────────────────────────────────────────────────────────────
+export function createHelpCommand(_getNames) {
+    return {
+        name: "help",
+        description: "List all commands, or show usage for a specific command",
+        category: "shell",
+        params: ["[command]"],
+        run: ({ args }) => {
+            const modules = getCommandModulesPublic();
+            if (args[0]) {
+                const target = args[0].toLowerCase();
+                const mod = modules.find((m) => m.name === target || m.aliases?.includes(target));
+                if (!mod) {
+                    return {
+                        stderr: `help: no help entry for '${args[0]}'`,
+                        exitCode: 1,
+                    };
+                }
+                return { stdout: renderDetail(mod), exitCode: 0 };
+            }
+            return { stdout: renderFull(modules), exitCode: 0 };
+        },
+    };
+}
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/commands/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,iBAAiB,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAYpD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY5D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAUlE;AAYD,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GACf,IAAI,CAQN;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED,wBAAsB,aAAa,CAClC,GAAG,EAAE,MAAM,GACT,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAQvE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA8D/D;AA4BD,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GACf,MAAM,CAyBR;AAED,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK;IAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,GACnD,MAAM,CAQR;AAED,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,YAAY,GACjB,qBAAqB,GAAG,SAAS,CAEnC"}

package/dist/commands/helpers.js

@@ -0,0 +1,167 @@
+import { spawn } from "node:child_process";
+import * as path from "node:path";
+const PROTECTED_PREFIXES = ["/.virtual-env-js/.auth", "/etc/htpasswd"];
+function normalizeFetchUrl(input) {
+    if (/^[a-zA-Z][a-zA-Z\d+\-.]*:/.test(input)) {
+        return input;
+    }
+    return `http://${input}`;
+}
+export function normalizeTerminalOutput(text) {
+    return text
+        .replace(/\r\n/g, "\n")
+        .replace(/\r/g, "\n")
+        .replace(/\t/g, "  ")
+        .split("\n")
+        .map((line) => line.replace(/^[ \u00A0]{8,}/, "  ").replace(/[ \u00A0]{3,}/g, "  "))
+        .join("\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .trimEnd();
+}
+export function resolvePath(cwd, inputPath) {
+    if (!inputPath || inputPath.trim() === "") {
+        return cwd;
+    }
+    if (inputPath.startsWith("~")) {
+        return path.posix.normalize(`/home/${inputPath.slice(1)}`);
+    }
+    return inputPath.startsWith("/")
+        ? path.posix.normalize(inputPath)
+        : path.posix.normalize(path.posix.join(cwd, inputPath));
+}
+function isProtectedPath(targetPath) {
+    const normalized = targetPath.startsWith("/")
+        ? path.posix.normalize(targetPath)
+        : path.posix.normalize(`/${targetPath}`);
+    return PROTECTED_PREFIXES.some((prefix) => normalized === prefix || normalized.startsWith(`${prefix}/`));
+}
+export function assertPathAccess(authUser, targetPath, operation) {
+    if (authUser === "root") {
+        return;
+    }
+    if (isProtectedPath(targetPath)) {
+        throw new Error(`${operation}: permission denied: ${targetPath}`);
+    }
+}
+export function stripUrlFilename(url) {
+    const cleaned = url.split("?")[0]?.split("#")[0] ?? url;
+    const lastPart = cleaned.split("/").filter(Boolean).pop();
+    return lastPart && lastPart.length > 0 ? lastPart : "index.html";
+}
+export async function fetchResource(url) {
+    const response = await fetch(normalizeFetchUrl(url));
+    const contentType = response.headers.get("content-type");
+    return {
+        text: await response.text(),
+        status: response.status,
+        contentType,
+    };
+}
+/**
+ * Run a host command like curl or wget and capture its output.
+ * @param binary - The binary to execute (e.g., "curl", "wget").
+ * @param args - Arguments to pass to the binary.
+ * @returns Promise resolving with stdout, stderr, and exit code.
+ */
+export function runHostCommand(binary, args) {
+    return new Promise((resolve) => {
+        let childProcess;
+        try {
+            childProcess = spawn(binary, args, {
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+        }
+        catch (error) {
+            resolve({
+                stdout: "",
+                stderr: `${binary}: ${error instanceof Error ? error.message : String(error)}`,
+                exitCode: 1,
+            });
+            return;
+        }
+        let stdout = "";
+        let stderr = "";
+        const stdoutStream = childProcess.stdout;
+        const stderrStream = childProcess.stderr;
+        if (!stdoutStream || !stderrStream) {
+            resolve({
+                stdout: "",
+                stderr: `${binary}: failed to capture process output`,
+                exitCode: 1,
+            });
+            return;
+        }
+        stdoutStream.setEncoding("utf8");
+        stderrStream.setEncoding("utf8");
+        stdoutStream.on("data", (chunk) => {
+            stdout += chunk;
+        });
+        stderrStream.on("data", (chunk) => {
+            stderr += chunk;
+        });
+        childProcess.on("error", (error) => {
+            const errorCode = error instanceof Error && "code" in error
+                ? String(error.code ?? "")
+                : "";
+            resolve({
+                stdout: "",
+                stderr: `${binary}: ${error.message}`,
+                exitCode: errorCode === "ENOENT" ? 127 : 1,
+            });
+        });
+        childProcess.on("close", (code) => {
+            resolve({
+                stdout,
+                stderr,
+                exitCode: code ?? 1,
+            });
+        });
+    });
+}
+function levenshtein(a, b) {
+    const dp = Array.from({ length: a.length + 1 }, () => Array(b.length + 1).fill(0));
+    for (let i = 0; i <= a.length; i += 1) {
+        dp[i][0] = i;
+    }
+    for (let j = 0; j <= b.length; j += 1) {
+        dp[0][j] = j;
+    }
+    for (let i = 1; i <= a.length; i += 1) {
+        for (let j = 1; j <= b.length; j += 1) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+        }
+    }
+    return dp[a.length][b.length];
+}
+export function resolveReadablePath(vfs, cwd, inputPath) {
+    const exactPath = resolvePath(cwd, inputPath);
+    if (vfs.exists(exactPath)) {
+        return exactPath;
+    }
+    const parent = path.posix.dirname(exactPath);
+    const fileName = path.posix.basename(exactPath);
+    const siblings = vfs.list(parent);
+    const caseInsensitive = siblings.filter((name) => name.toLowerCase() === fileName.toLowerCase());
+    if (caseInsensitive.length === 1) {
+        return path.posix.join(parent, caseInsensitive[0]);
+    }
+    const near = siblings.filter((name) => levenshtein(name.toLowerCase(), fileName.toLowerCase()) <= 1);
+    if (near.length === 1) {
+        return path.posix.join(parent, near[0]);
+    }
+    return exactPath;
+}
+export function joinListWithType(cwd, items, statAt) {
+    return items
+        .map((name) => {
+        const childPath = resolvePath(cwd, name);
+        const stats = statAt(childPath);
+        return stats.type === "directory" ? `${name}/` : name;
+    })
+        .join("  ");
+}
+export function getPackageManager(shell) {
+    return shell.packageManager;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/commands/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/commands/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAKlC,MAAM,kBAAkB,GAAG,CAAC,wBAAwB,EAAE,eAAe,CAAU,CAAC;AAEhF,SAAS,iBAAiB,CAAC,KAAa;IACvC,IAAI,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC;IACd,CAAC;IAED,OAAO,UAAU,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY;IACnD,OAAO,IAAI;SACT,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SACtB,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;SACpB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACb,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,CACpE;SACA,IAAI,CAAC,IAAI,CAAC;SACV,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;SAC1B,OAAO,EAAE,CAAC;AACb,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,SAAiB;IACzD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3C,OAAO,GAAG,CAAC;IACZ,CAAC;IACD,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC;QAC/B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC;QACjC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,eAAe,CAAC,UAAkB;IAC1C,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC;QAC5C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC;QAClC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,UAAU,EAAE,CAAC,CAAC;IAE1C,OAAO,kBAAkB,CAAC,IAAI,CAC7B,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,KAAK,MAAM,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CACxE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC/B,QAAgB,EAChB,UAAkB,EAClB,SAAiB;IAEjB,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACzB,OAAO;IACR,CAAC;IAED,IAAI,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,wBAAwB,UAAU,EAAE,CAAC,CAAC;IACnE,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC;IAC1D,OAAO,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC;AAClE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,GAAW;IAEX,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACzD,OAAO;QACN,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE;QAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,WAAW;KACX,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC7B,MAAc,EACd,IAAc;IAEd,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,IAAI,YAAsC,CAAC;QAE3C,IAAI,CAAC;YACJ,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE;gBAClC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;aACjC,CAAC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC;gBACP,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,GAAG,MAAM,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;gBAC9E,QAAQ,EAAE,CAAC;aACX,CAAC,CAAC;YACH,OAAO;QACR,CAAC;QAED,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC;QACzC,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC;QAEzC,IAAI,CAAC,YAAY,IAAI,CAAC,YAAY,EAAE,CAAC;YACpC,OAAO,CAAC;gBACP,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,GAAG,MAAM,oCAAoC;gBACrD,QAAQ,EAAE,CAAC;aACX,CAAC,CAAC;YACH,OAAO;QACR,CAAC;QAED,YAAY,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,YAAY,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAEjC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,IAAI,KAAK,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,IAAI,KAAK,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAClC,MAAM,SAAS,GACd,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK;gBACxC,CAAC,CAAC,MAAM,CAAE,KAA+B,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrD,CAAC,CAAC,EAAE,CAAC;YACP,OAAO,CAAC;gBACP,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,GAAG,MAAM,KAAK,KAAK,CAAC,OAAO,EAAE;gBACrC,QAAQ,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;aAC1C,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACjC,OAAO,CAAC;gBACP,MAAM;gBACN,MAAM;gBACN,QAAQ,EAAE,IAAI,IAAI,CAAC;aACnB,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,CAAS,EAAE,CAAS;IACxC,MAAM,EAAE,GAAe,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAChE,KAAK,CAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACnC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CACnB,EAAE,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC,CAAE,GAAG,CAAC,EAClB,EAAE,CAAC,CAAC,CAAE,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,EAClB,EAAE,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,IAAI,CACzB,CAAC;QACH,CAAC;IACF,CAAC;IAED,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAE,CAAC,CAAC,CAAC,MAAM,CAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAClC,GAAsB,EACtB,GAAW,EACX,SAAiB;IAEjB,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC9C,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAElC,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CACtC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,WAAW,EAAE,CACvD,CAAC;IACF,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAE,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAC3B,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CACtE,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC/B,GAAW,EACX,KAAe,EACf,MAAqD;IAErD,OAAO,KAAK;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAChC,KAAmB;IAEnB,OAAO,KAAK,CAAC,cAAc,CAAC;AAC7B,CAAC"}

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

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

package/dist/commands/history.js

@@ -0,0 +1,27 @@
+/**
+ * Display persisted command history for the session (from VFS).
+ * @category shell
+ * @params ["[n]"]
+ */
+export const historyCommand = {
+    name: "history",
+    description: "Display command history",
+    category: "shell",
+    params: ["[n]"],
+    run: ({ args, shell, authUser }) => {
+        // History is persisted in the VFS by the interactive shell
+        const histPath = `/home/${authUser}/.bash_history`;
+        if (!shell.vfs.exists(histPath)) {
+            return { stdout: "", exitCode: 0 };
+        }
+        const raw = shell.vfs.readFile(histPath);
+        const lines = raw.split("\n").filter(Boolean);
+        const nArg = args[0];
+        const n = nArg ? parseInt(nArg, 10) : null;
+        const slice = n && !Number.isNaN(n) ? lines.slice(-n) : lines;
+        const offset = lines.length - slice.length + 1;
+        const numbered = slice.map((line, i) => `${String(offset + i).padStart(5)}  ${line}`);
+        return { stdout: numbered.join("\n"), exitCode: 0 };
+    },
+};
+//# sourceMappingURL=history.js.map

package/dist/commands/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/commands/history.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAgB;IAC1C,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,yBAAyB;IACtC,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE,CAAC,KAAK,CAAC;IACf,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE;QAClC,2DAA2D;QAC3D,MAAM,QAAQ,GAAG,SAAS,QAAQ,gBAAgB,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACpC,CAAC;QAED,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE9C,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3C,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAE9D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CACzB,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CACzD,CAAC;QAEF,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACrD,CAAC;CACD,CAAC"}

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

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

package/dist/commands/hostname.js

@@ -0,0 +1,13 @@
+/**
+ * Print the configured hostname for the virtual shell.
+ * @category system
+ * @params []
+ */
+export const hostnameCommand = {
+    name: "hostname",
+    description: "Print hostname",
+    category: "system",
+    params: [],
+    run: ({ hostname }) => ({ stdout: hostname, exitCode: 0 }),
+};
+//# sourceMappingURL=hostname.js.map

package/dist/commands/hostname.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostname.js","sourceRoot":"","sources":["../../src/commands/hostname.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAgB;IAC3C,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,gBAAgB;IAC7B,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,EAAE;IACV,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;CAC1D,CAAC"}

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

@@ -0,0 +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;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WAYzB,CAAC"}

package/dist/commands/htop.js

@@ -0,0 +1,18 @@
+/**
+ * Interactive system monitor (requires terminal interaction).
+ * @category system
+ * @params []
+ */
+export const htopCommand = {
+    name: "htop",
+    description: "System monitor",
+    category: "system",
+    params: [],
+    run: ({ mode }) => {
+        if (mode === "exec") {
+            return { stderr: "htop: interactive terminal required", exitCode: 1 };
+        }
+        return { openHtop: true, exitCode: 0 };
+    },
+};
+//# sourceMappingURL=htop.js.map

package/dist/commands/htop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"htop.js","sourceRoot":"","sources":["../../src/commands/htop.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAgB;IACvC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,gBAAgB;IAC7B,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,EAAE;IACV,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACrB,OAAO,EAAE,MAAM,EAAE,qCAAqC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACvE,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACxC,CAAC;CACD,CAAC"}

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

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

package/dist/commands/id.js

@@ -0,0 +1,18 @@
+export const idCommand = {
+    name: "id",
+    description: "Print user identity",
+    category: "system",
+    params: ["[user]"],
+    run: ({ authUser, shell, args }) => {
+        const target = args[0] ?? authUser;
+        const uid = target === "root" ? 0 : 1000;
+        const gid = uid;
+        const isSudo = shell.users.isSudoer(target);
+        const groups = isSudo ? `${gid}(${target}),0(root)` : `${gid}(${target})`;
+        return {
+            stdout: `uid=${uid}(${target}) gid=${gid}(${target}) groups=${groups}`,
+            exitCode: 0,
+        };
+    },
+};
+//# sourceMappingURL=id.js.map

package/dist/commands/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/commands/id.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAgB;IACrC,IAAI,EAAE,IAAI;IACV,WAAW,EAAE,qBAAqB;IAClC,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;QACnC,MAAM,GAAG,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACzC,MAAM,GAAG,GAAG,GAAG,CAAC;QAChB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,MAAM,WAAW,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,MAAM,GAAG,CAAC;QAC1E,OAAO;YACN,MAAM,EAAE,OAAO,GAAG,IAAI,MAAM,SAAS,GAAG,IAAI,MAAM,YAAY,MAAM,EAAE;YACtE,QAAQ,EAAE,CAAC;SACX,CAAC;IACH,CAAC;CACD,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,eAAe,EACf,aAAa,EACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/dist/commands/index.js

@@ -0,0 +1,3 @@
+export { createCustomCommand, getCommandModulesPublic, getCommandNames, registerCommand, resolveModule } from "./registry";
+export { makeDefaultEnv, runCommand, runCommandDirect } from "./runtime";
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,eAAe,EACf,aAAa,EACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

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

@@ -0,0 +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;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,WAWzB,CAAC"}

package/dist/commands/kill.js

@@ -0,0 +1,19 @@
+/**
+ * Send a signal to a process by PID.
+ * @category system
+ * @params ["[-9] <pid>"]
+ */
+export const killCommand = {
+    name: "kill",
+    description: "Send signal to process",
+    category: "system",
+    params: ["[-9] <pid>"],
+    run: ({ args }) => {
+        const pid = args.find((a) => !a.startsWith("-"));
+        if (!pid)
+            return { stderr: "kill: no pid specified", exitCode: 1 };
+        // In virtual env, we just acknowledge the kill
+        return { stdout: ``, exitCode: 0 };
+    },
+};
+//# sourceMappingURL=kill.js.map

package/dist/commands/kill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kill.js","sourceRoot":"","sources":["../../src/commands/kill.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAgB;IACvC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,wBAAwB;IACrC,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,CAAC,YAAY,CAAC;IACtB,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,MAAM,EAAE,wBAAwB,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACnE,+CAA+C;QAC/C,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACpC,CAAC;CACD,CAAC"}

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

@@ -0,0 +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;AAEF,yDAAyD;AACzD,eAAO,MAAM,eAAe,EAAE,WAmB7B,CAAC"}

package/dist/commands/ln.js

@@ -0,0 +1,67 @@
+import { ifFlag } from "./command-helpers";
+import { assertPathAccess, resolvePath } from "./helpers";
+export const lnCommand = {
+    name: "ln",
+    description: "Create links",
+    category: "files",
+    params: ["[-s] <target> <link_name>"],
+    run: ({ authUser, shell, cwd, args }) => {
+        const symbolic = ifFlag(args, ["-s", "--symbolic"]);
+        const positionals = args.filter((a) => !a.startsWith("-"));
+        const [targetArg, linkArg] = positionals;
+        if (!targetArg || !linkArg) {
+            return { stderr: "ln: missing operand", exitCode: 1 };
+        }
+        const linkPath = resolvePath(cwd, linkArg);
+        const targetPath = symbolic
+            ? targetArg // keep relative for symlinks
+            : resolvePath(cwd, targetArg);
+        try {
+            assertPathAccess(authUser, linkPath, "ln");
+            if (!symbolic) {
+                // Hard link — copy file contents
+                const srcPath = resolvePath(cwd, targetArg);
+                assertPathAccess(authUser, srcPath, "ln");
+                if (!shell.vfs.exists(srcPath)) {
+                    return {
+                        stderr: `ln: ${targetArg}: No such file or directory`,
+                        exitCode: 1,
+                    };
+                }
+                const content = shell.vfs.readFile(srcPath);
+                shell.writeFileAsUser(authUser, linkPath, content);
+            }
+            else {
+                shell.vfs.symlink(targetPath, linkPath);
+            }
+            return { exitCode: 0 };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { stderr: `ln: ${msg}`, exitCode: 1 };
+        }
+    },
+};
+/** 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 };
+    },
+};
+//# sourceMappingURL=ln.js.map

package/dist/commands/ln.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ln.js","sourceRoot":"","sources":["../../src/commands/ln.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE1D,MAAM,CAAC,MAAM,SAAS,GAAgB;IACrC,IAAI,EAAE,IAAI;IACV,WAAW,EAAE,cAAc;IAC3B,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE,CAAC,2BAA2B,CAAC;IACrC,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE;QACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;QACpD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3D,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC;QAEzC,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5B,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACvD,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,QAAQ;YAC1B,CAAC,CAAC,SAAS,CAAC,6BAA6B;YACzC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAE/B,IAAI,CAAC;YACJ,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YAE3C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACf,iCAAiC;gBACjC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBAC5C,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC1C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;oBAChC,OAAO;wBACN,MAAM,EAAE,OAAO,SAAS,6BAA6B;wBACrD,QAAQ,EAAE,CAAC;qBACX,CAAC;gBACH,CAAC;gBACD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC5C,KAAK,CAAC,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACP,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YACzC,CAAC;YAED,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAC9C,CAAC;IACF,CAAC;CACD,CAAC;AAEF,yDAAyD;AACzD,MAAM,CAAC,MAAM,eAAe,GAAgB;IAC3C,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,sCAAsC;IACnD,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE,CAAC,aAAa,CAAC;IACvB,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,MAAM,EAAE,6BAA6B,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAC3E,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,MAAM,EAAE,aAAa,MAAM,+BAA+B,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACpF,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,MAAM,EAAE,aAAa,MAAM,yBAAyB,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAC9E,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,OAAO,EAAE,MAAM,EAAE,GAAG,QAAQ,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACjD,CAAC;CACD,CAAC"}

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

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