typescript-virtual-container 1.2.5 → 1.2.6

package/dist/VirtualShell/shellParser.js

@@ -1,91 +1,225 @@
-/** Parse a shell command line into a structured pipeline */
+// ── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Parse a shell input line into a Script (sequence of statements connected
+ * by && / || / ;).  Each statement contains one Pipeline (commands connected
+ * by |).
+ */
+export function parseScript(rawInput) {
+    const trimmed = rawInput.trim();
+    if (!trimmed)
+        return { statements: [], isValid: true };
+    try {
+        const statements = parseStatements(trimmed);
+        return { statements, isValid: true };
+    }
+    catch (e) {
+        return { statements: [], isValid: false, error: e.message };
+    }
+}
+/** Legacy compat: parse a single pipeline (no &&/||/;) */
 export function parseShellPipeline(rawInput) {
     const trimmed = rawInput.trim();
-    if (!trimmed) {
+    if (!trimmed)
         return { commands: [], isValid: true };
+    try {
+        const commands = parsePipeline(trimmed);
+        return { commands, isValid: true };
     }
-    const commands = [];
-    const tokenized = tokenizePipeline(trimmed);
-    if (tokenized.error) {
-        return {
-            commands: [],
-            isValid: false,
-            error: tokenized.error,
-        };
+    catch (e) {
+        return { commands: [], isValid: false, error: e.message };
     }
-    const pipeTokens = tokenized.tokens;
-    for (const token of pipeTokens) {
-        const cmd = parseCommandWithRedirections(token);
-        if (!cmd.isValid) {
-            return {
-                commands: [],
-                isValid: false,
-                error: cmd.error,
-            };
-        }
-        if (cmd.command) {
-            commands.push(cmd.command);
+}
+// ── Variable & tilde expansion ────────────────────────────────────────────────
+/**
+ * Expand ~ and $VAR / ${VAR} / ${VAR:-default} / $(cmd placeholder) in a
+ * token, given the current env vars and home path.
+ * Command substitution $(…) is NOT executed here — it's left as a marker so
+ * the executor can handle it.
+ */
+export function expandToken(token, env, authUser, lastExitCode = 0) {
+    // tilde expansion
+    token = token.replace(/^~(\/|$)/, `/home/${authUser}$1`);
+    // $? special var
+    token = token.replace(/\$\?/g, String(lastExitCode));
+    // $$ PID (mock)
+    token = token.replace(/\$\$/g, "1");
+    // $# argc (0 for interactive)
+    token = token.replace(/\$#/g, "0");
+    // ${VAR:-default} and ${VAR:+value}
+    token = token.replace(/\$\{([^}:]+):-([^}]*)\}/g, (_, name, def) => env[name] ?? def);
+    token = token.replace(/\$\{([^}:]+):\+([^}]*)\}/g, (_, name, val) => env[name] ? val : "");
+    // ${VAR}
+    token = token.replace(/\$\{([^}]+)\}/g, (_, name) => env[name] ?? "");
+    // $VAR (greedy: match longest valid identifier)
+    token = token.replace(/\$([A-Za-z_][A-Za-z0-9_]*)/g, (_, name) => env[name] ?? "");
+    return token;
+}
+/**
+ * Expand glob patterns (*, ?, [abc]) against a list of entries.
+ * Returns the original pattern if no match.
+ */
+export function expandGlob(pattern, entries) {
+    if (!/[*?[]/.test(pattern))
+        return [pattern];
+    const regex = globToRegex(pattern);
+    const matches = entries.filter((e) => regex.test(e));
+    return matches.length > 0 ? matches.sort() : [pattern];
+}
+function globToRegex(pattern) {
+    let re = "^";
+    for (let i = 0; i < pattern.length; i++) {
+        const c = pattern[i];
+        if (c === "*")
+            re += ".*";
+        else if (c === "?")
+            re += ".";
+        else if (c === "[") {
+            const close = pattern.indexOf("]", i + 1);
+            if (close === -1)
+                re += "\\[";
+            else {
+                re += `[${pattern.slice(i + 1, close)}]`;
+                i = close;
+            }
         }
+        else
+            re += c.replace(/[.+^${}()|[\]\\]/g, "\\$&");
     }
-    return { commands, isValid: true };
+    return new RegExp(`${re}$`);
 }
-/** Tokenize input by pipes, respecting quoted strings */
-function tokenizePipeline(input) {
-    const tokens = [];
+// ── Internal parser ───────────────────────────────────────────────────────────
+function parseStatements(input) {
+    // Split by ;, &&, || — respecting quotes and parens
+    const segments = splitByLogicalOps(input);
+    const statements = [];
+    for (const seg of segments) {
+        const commands = parsePipeline(seg.text.trim());
+        const stmt = { pipeline: { commands, isValid: true } };
+        if (seg.op)
+            stmt.op = seg.op;
+        statements.push(stmt);
+    }
+    return statements;
+}
+function splitByLogicalOps(input) {
+    const segments = [];
     let current = "";
-    let inQuotes = false;
-    let quoteChar = "";
+    let depth = 0; // parens/subshell depth
+    let inQ = false;
+    let qChar = "";
     let i = 0;
+    const flush = (op) => {
+        if (current.trim())
+            segments.push({ text: current, op });
+        current = "";
+    };
     while (i < input.length) {
         const ch = input[i];
-        if ((ch === '"' || ch === "'") && (i === 0 || input[i - 1] !== "\\")) {
-            if (!inQuotes) {
-                inQuotes = true;
-                quoteChar = ch;
-            }
-            else if (ch === quoteChar) {
-                inQuotes = false;
-            }
+        const ch2 = input.slice(i, i + 2);
+        if ((ch === '"' || ch === "'") && !inQ) {
+            inQ = true;
+            qChar = ch;
             current += ch;
             i++;
+            continue;
         }
-        else if (ch === "|" && !inQuotes) {
-            if (!current.trim()) {
-                return {
-                    tokens: [],
-                    error: "Syntax error near unexpected token '|'",
-                };
-            }
-            tokens.push(current.trim());
-            current = "";
+        if (inQ && ch === qChar) {
+            inQ = false;
+            current += ch;
             i++;
+            continue;
         }
-        else {
+        if (inQ) {
             current += ch;
             i++;
+            continue;
         }
+        if (ch === "(") {
+            depth++;
+            current += ch;
+            i++;
+            continue;
+        }
+        if (ch === ")") {
+            depth--;
+            current += ch;
+            i++;
+            continue;
+        }
+        if (depth > 0) {
+            current += ch;
+            i++;
+            continue;
+        }
+        if (ch2 === "&&") {
+            flush("&&");
+            i += 2;
+            continue;
+        }
+        if (ch2 === "||") {
+            flush("||");
+            i += 2;
+            continue;
+        }
+        if (ch === ";") {
+            flush(";");
+            i++;
+            continue;
+        }
+        current += ch;
+        i++;
     }
-    if (inQuotes) {
-        return {
-            tokens: [],
-            error: "Syntax error: unterminated quote",
-        };
-    }
-    if (!current.trim()) {
-        return {
-            tokens: [],
-            error: "Syntax error near unexpected token '|'",
-        };
+    flush();
+    return segments;
+}
+function parsePipeline(input) {
+    const pipeTokens = splitByPipe(input);
+    return pipeTokens.map(parseCommandWithRedirections);
+}
+function splitByPipe(input) {
+    const tokens = [];
+    let current = "";
+    let inQ = false;
+    let qChar = "";
+    for (let i = 0; i < input.length; i++) {
+        const ch = input[i];
+        if ((ch === '"' || ch === "'") && !inQ) {
+            inQ = true;
+            qChar = ch;
+            current += ch;
+            continue;
+        }
+        if (inQ && ch === qChar) {
+            inQ = false;
+            current += ch;
+            continue;
+        }
+        if (inQ) {
+            current += ch;
+            continue;
+        }
+        // || was already consumed at statement level, bare | is pipe
+        if (ch === "|" && input[i + 1] !== "|") {
+            if (!current.trim())
+                throw new Error("Syntax error near unexpected token '|'");
+            tokens.push(current.trim());
+            current = "";
+        }
+        else {
+            current += ch;
+        }
     }
-    tokens.push(current.trim());
-    return { tokens };
+    const tail = current.trim();
+    if (!tail && tokens.length > 0)
+        throw new Error("Syntax error near unexpected token '|'");
+    if (tail)
+        tokens.push(tail);
+    return tokens;
 }
-/** Parse a single command with its redirections (>, >>, <) */
 function parseCommandWithRedirections(token) {
     const parts = tokenizeCommand(token);
-    if (parts.length === 0) {
-        return { isValid: true };
-    }
+    if (parts.length === 0)
+        return { name: "", args: [] };
     const cmdParts = [];
     let inputFile;
     let outputFile;
@@ -95,35 +229,23 @@ function parseCommandWithRedirections(token) {
         const part = parts[i];
         if (part === "<") {
             i++;
-            if (i >= parts.length) {
-                return {
-                    isValid: false,
-                    error: "Syntax error: expected filename after <",
-                };
-            }
+            if (i >= parts.length)
+                throw new Error("Syntax error: expected filename after <");
             inputFile = parts[i];
             i++;
         }
         else if (part === ">>") {
             i++;
-            if (i >= parts.length) {
-                return {
-                    isValid: false,
-                    error: "Syntax error: expected filename after >>",
-                };
-            }
+            if (i >= parts.length)
+                throw new Error("Syntax error: expected filename after >>");
             outputFile = parts[i];
             appendOutput = true;
             i++;
         }
         else if (part === ">") {
             i++;
-            if (i >= parts.length) {
-                return {
-                    isValid: false,
-                    error: "Syntax error: expected filename after >",
-                };
-            }
+            if (i >= parts.length)
+                throw new Error("Syntax error: expected filename after >");
             outputFile = parts[i];
             appendOutput = false;
             i++;
@@ -133,55 +255,44 @@ function parseCommandWithRedirections(token) {
             i++;
         }
     }
-    if (cmdParts.length === 0) {
-        return { isValid: true };
-    }
-    const name = cmdParts[0].toLowerCase();
-    const args = cmdParts.slice(1);
-    return {
-        command: {
-            name,
-            args,
-            inputFile,
-            outputFile,
-            appendOutput,
-        },
-        isValid: true,
-    };
+    const name = (cmdParts[0] ?? "").toLowerCase();
+    return { name, args: cmdParts.slice(1), inputFile, outputFile, appendOutput };
 }
-/** Tokenize a command, respecting quotes and handling >> vs > */
 function tokenizeCommand(input) {
     const tokens = [];
     let current = "";
-    let inQuotes = false;
-    let quoteChar = "";
+    let inQ = false;
+    let qChar = "";
     let i = 0;
     while (i < input.length) {
         const ch = input[i];
         const next = input[i + 1];
-        // Handle quotes
-        if ((ch === '"' || ch === "'") && (i === 0 || input[i - 1] !== "\\")) {
-            if (!inQuotes) {
-                inQuotes = true;
-                quoteChar = ch;
-            }
-            else if (ch === quoteChar) {
-                inQuotes = false;
-                quoteChar = "";
-            }
-            else {
-                current += ch;
-            }
+        if ((ch === '"' || ch === "'") && !inQ) {
+            inQ = true;
+            qChar = ch;
+            i++;
+            continue;
+        }
+        if (inQ && ch === qChar) {
+            inQ = false;
+            qChar = "";
             i++;
+            continue;
         }
-        else if (ch === " " && !inQuotes) {
+        if (inQ) {
+            current += ch;
+            i++;
+            continue;
+        }
+        if (ch === " ") {
             if (current) {
                 tokens.push(current);
                 current = "";
             }
             i++;
+            continue;
         }
-        else if ((ch === ">" || ch === "<") && !inQuotes) {
+        if ((ch === ">" || ch === "<") && !inQ) {
             if (current) {
                 tokens.push(current);
                 current = "";
@@ -194,14 +305,12 @@ function tokenizeCommand(input) {
                 tokens.push(ch);
                 i++;
             }
+            continue;
         }
-        else {
-            current += ch;
-            i++;
-        }
+        current += ch;
+        i++;
     }
-    if (current) {
+    if (current)
         tokens.push(current);
-    }
     return tokens;
 }

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.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,WAmB5B,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,eAAO,MAAM,cAAc,EAAE,WAqB5B,CAAC"}

package/dist/commands/adduser.js

@@ -1,5 +1,7 @@
 export const adduserCommand = {
     name: "adduser",
+    description: "Add a new user",
+    category: "users",
     params: ["<username> <password>"],
     run: async ({ authUser, shell, args }) => {
         if (authUser !== "root") {

package/dist/commands/awk.d.ts

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

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

@@ -0,0 +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"}

package/dist/commands/awk.js

@@ -0,0 +1,29 @@
+import { getFlag } from "./command-helpers";
+export const awkCommand = {
+    name: "awk",
+    description: "Pattern scanning and processing language (minimal)",
+    category: "text",
+    params: ["[-F <sep>] '<program>' [file]"],
+    run: ({ args, stdin }) => {
+        const sep = getFlag(args, ["-F"]) ?? " ";
+        const prog = args.find((a) => !a.startsWith("-") && a !== sep);
+        if (!prog)
+            return { stderr: "awk: no program", exitCode: 1 };
+        // Only support print $N and {print $N} patterns
+        const printMatch = prog.match(/^\{?\s*print\s+([^}]+)\s*\}?$/);
+        if (!printMatch)
+            return { stderr: `awk: unsupported program: ${prog}`, exitCode: 1 };
+        const fields = printMatch[1].split(/\s*,\s*/).map((f) => f.trim());
+        const lines = (stdin ?? "").split("\n").filter(Boolean);
+        const out = lines.map((line) => {
+            const parts = line.split(sep === " " ? /\s+/ : sep);
+            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);
+        });
+        return { stdout: out.join("\n"), exitCode: 0 };
+    },
+};

package/dist/commands/base64.d.ts

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

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

@@ -0,0 +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"}

package/dist/commands/base64.js

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

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,WAaxB,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,eAAO,MAAM,UAAU,EAAE,WAexB,CAAC"}

package/dist/commands/cat.js

@@ -2,6 +2,8 @@ import { getArg } from "./command-helpers";
 import { assertPathAccess, resolveReadablePath } from "./helpers";
 export const catCommand = {
     name: "cat",
+    description: "Concatenate and print files",
+    category: "files",
     params: ["<file>"],
     run: ({ authUser, shell, cwd, args }) => {
         const fileArg = getArg(args, 0);

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,WAiBvB,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,eAAO,MAAM,SAAS,EAAE,WAmBvB,CAAC"}

package/dist/commands/cd.js

@@ -1,6 +1,8 @@
 import { assertPathAccess, resolvePath } from "./helpers";
 export const cdCommand = {
     name: "cd",
+    description: "Change directory",
+    category: "navigation",
     params: ["[path]"],
     run: ({ authUser, shell, cwd, args, mode }) => {
         const target = resolvePath(cwd, args[0] ?? "/virtual-env-js");

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;AAGrD,eAAO,MAAM,YAAY,EAAE,WA6B1B,CAAC"}
+{"version":3,"file":"chmod.d.ts","sourceRoot":"","sources":["../../src/commands/chmod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,YAAY,EAAE,WA+B1B,CAAC"}

package/dist/commands/chmod.js

@@ -1,6 +1,8 @@
 import { assertPathAccess, resolvePath } from "./helpers";
 export const chmodCommand = {
     name: "chmod",
+    description: "Change file permissions",
+    category: "files",
     params: ["<mode> <file>"],
     run: ({ authUser, shell, cwd, args }) => {
         const [modeArg, fileArg] = args;

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

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

package/dist/commands/clear.js

@@ -1,5 +1,8 @@
 export const clearCommand = {
     name: "clear",
+    description: "Clear the terminal screen",
+    category: "shell",
     params: [],
-    run: () => ({ clearScreen: true, exitCode: 0 }),
+    // clearScreen flag triggers \x1b[2J\x1b[H in the shell layer
+    run: () => ({ clearScreen: true, stdout: "", exitCode: 0 }),
 };

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,WAuEvB,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,eAAO,MAAM,SAAS,EAAE,WAyEvB,CAAC"}

package/dist/commands/cp.js

@@ -2,6 +2,8 @@ import { ifFlag } from "./command-helpers";
 import { assertPathAccess, resolvePath } from "./helpers";
 export const cpCommand = {
     name: "cp",
+    description: "Copy files or directories",
+    category: "files",
     params: ["[-r] <source> <dest>"],
     run: ({ authUser, shell, cwd, args }) => {
         const recursive = ifFlag(args, ["-r", "-R", "--recursive"]);

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,WAiDzB,CAAC"}
+{"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"}

package/dist/commands/curl.js

@@ -2,6 +2,8 @@ import { parseArgs } from "./command-helpers";
 import { assertPathAccess, normalizeTerminalOutput, resolvePath, runHostCommand, } from "./helpers";
 export const curlCommand = {
     name: "curl",
+    description: "HTTP client",
+    category: "network",
     params: ["[-o file] <url>"],
     run: async ({ authUser, cwd, args, shell }) => {
         const { flagsWithValues, positionals } = parseArgs(args, {

package/dist/commands/cut.d.ts

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

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

@@ -0,0 +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"}

package/dist/commands/cut.js

@@ -0,0 +1,27 @@
+import { getFlag } from "./command-helpers";
+export const cutCommand = {
+    name: "cut",
+    description: "Remove sections from lines",
+    category: "text",
+    params: ["-d <delim> -f <fields> [file]"],
+    run: ({ args, stdin }) => {
+        const delim = getFlag(args, ["-d"]) ?? "\t";
+        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 };
+        });
+        const lines = (stdin ?? "").split("\n");
+        const out = lines.map((line) => {
+            const parts = line.split(delim);
+            const selected = [];
+            for (const col of cols) {
+                for (let i = col.from; i <= Math.min(col.to, parts.length - 1); i++) {
+                    selected.push(parts[i] ?? "");
+                }
+            }
+            return selected.join(delim);
+        });
+        return { stdout: out.join("\n"), exitCode: 0 };
+    },
+};