@eidos.space/just-bash 3.0.2

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

@@ -0,0 +1,6 @@
+import type { Command } from "../../types.js";
+export declare const aliasCommand: Command;
+export declare const unaliasCommand: Command;
+import type { CommandFuzzInfo } from "../fuzz-flags-types.js";
+export declare const flagsForFuzzing: CommandFuzzInfo;
+export declare const unaliasFlagsForFuzzing: CommandFuzzInfo;

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

@@ -0,0 +1,202 @@
+/**
+ * AWK Abstract Syntax Tree Types
+ *
+ * Follows the same discriminated union pattern as the main bash AST.
+ */
+export type AwkExpr = AwkNumberLiteral | AwkStringLiteral | AwkRegexLiteral | AwkFieldRef | AwkVariable | AwkArrayAccess | AwkBinaryOp | AwkUnaryOp | AwkTernaryOp | AwkFunctionCall | AwkAssignment | AwkPreIncrement | AwkPreDecrement | AwkPostIncrement | AwkPostDecrement | AwkGetline | AwkInExpr | AwkTuple;
+export interface AwkNumberLiteral {
+    type: "number";
+    value: number;
+}
+export interface AwkStringLiteral {
+    type: "string";
+    value: string;
+}
+export interface AwkRegexLiteral {
+    type: "regex";
+    pattern: string;
+}
+export interface AwkFieldRef {
+    type: "field";
+    index: AwkExpr;
+}
+export interface AwkVariable {
+    type: "variable";
+    name: string;
+}
+export interface AwkArrayAccess {
+    type: "array_access";
+    array: string;
+    key: AwkExpr;
+}
+export interface AwkBinaryOp {
+    type: "binary";
+    operator: "+" | "-" | "*" | "/" | "%" | "^" | "==" | "!=" | "<" | ">" | "<=" | ">=" | "~" | "!~" | "&&" | "||" | " ";
+    left: AwkExpr;
+    right: AwkExpr;
+}
+export interface AwkUnaryOp {
+    type: "unary";
+    operator: "!" | "-" | "+";
+    operand: AwkExpr;
+}
+export interface AwkPreIncrement {
+    type: "pre_increment";
+    operand: AwkVariable | AwkArrayAccess | AwkFieldRef;
+}
+export interface AwkPreDecrement {
+    type: "pre_decrement";
+    operand: AwkVariable | AwkArrayAccess | AwkFieldRef;
+}
+export interface AwkPostIncrement {
+    type: "post_increment";
+    operand: AwkVariable | AwkArrayAccess | AwkFieldRef;
+}
+export interface AwkPostDecrement {
+    type: "post_decrement";
+    operand: AwkVariable | AwkArrayAccess | AwkFieldRef;
+}
+export interface AwkTernaryOp {
+    type: "ternary";
+    condition: AwkExpr;
+    consequent: AwkExpr;
+    alternate: AwkExpr;
+}
+export interface AwkFunctionCall {
+    type: "call";
+    name: string;
+    args: AwkExpr[];
+}
+export interface AwkAssignment {
+    type: "assignment";
+    operator: "=" | "+=" | "-=" | "*=" | "/=" | "%=" | "^=";
+    target: AwkFieldRef | AwkVariable | AwkArrayAccess;
+    value: AwkExpr;
+}
+export interface AwkInExpr {
+    type: "in";
+    key: AwkExpr;
+    array: string;
+}
+export interface AwkGetline {
+    type: "getline";
+    variable?: string;
+    file?: AwkExpr;
+    command?: AwkExpr;
+}
+export interface AwkTuple {
+    type: "tuple";
+    elements: AwkExpr[];
+}
+export type AwkStmt = AwkExpressionStmt | AwkPrintStmt | AwkPrintfStmt | AwkIfStmt | AwkWhileStmt | AwkDoWhileStmt | AwkForStmt | AwkForInStmt | AwkBreakStmt | AwkContinueStmt | AwkNextStmt | AwkNextFileStmt | AwkExitStmt | AwkReturnStmt | AwkDeleteStmt | AwkBlock;
+export interface AwkExpressionStmt {
+    type: "expr_stmt";
+    expression: AwkExpr;
+}
+export interface AwkPrintStmt {
+    type: "print";
+    args: AwkExpr[];
+    output?: {
+        redirect: ">" | ">>";
+        file: AwkExpr;
+    };
+}
+export interface AwkPrintfStmt {
+    type: "printf";
+    format: AwkExpr;
+    args: AwkExpr[];
+    output?: {
+        redirect: ">" | ">>";
+        file: AwkExpr;
+    };
+}
+export interface AwkIfStmt {
+    type: "if";
+    condition: AwkExpr;
+    consequent: AwkStmt;
+    alternate?: AwkStmt;
+}
+export interface AwkWhileStmt {
+    type: "while";
+    condition: AwkExpr;
+    body: AwkStmt;
+}
+export interface AwkDoWhileStmt {
+    type: "do_while";
+    body: AwkStmt;
+    condition: AwkExpr;
+}
+export interface AwkForStmt {
+    type: "for";
+    init?: AwkExpr;
+    condition?: AwkExpr;
+    update?: AwkExpr;
+    body: AwkStmt;
+}
+export interface AwkForInStmt {
+    type: "for_in";
+    variable: string;
+    array: string;
+    body: AwkStmt;
+}
+export interface AwkBlock {
+    type: "block";
+    statements: AwkStmt[];
+}
+export interface AwkBreakStmt {
+    type: "break";
+}
+export interface AwkContinueStmt {
+    type: "continue";
+}
+export interface AwkNextStmt {
+    type: "next";
+}
+export interface AwkNextFileStmt {
+    type: "nextfile";
+}
+export interface AwkExitStmt {
+    type: "exit";
+    code?: AwkExpr;
+}
+export interface AwkReturnStmt {
+    type: "return";
+    value?: AwkExpr;
+}
+export interface AwkDeleteStmt {
+    type: "delete";
+    target: AwkArrayAccess | AwkVariable;
+}
+export type AwkPattern = AwkBeginPattern | AwkEndPattern | AwkExprPattern | AwkRegexPattern | AwkRangePattern;
+export interface AwkBeginPattern {
+    type: "begin";
+}
+export interface AwkEndPattern {
+    type: "end";
+}
+export interface AwkExprPattern {
+    type: "expr_pattern";
+    expression: AwkExpr;
+}
+export interface AwkRegexPattern {
+    type: "regex_pattern";
+    pattern: string;
+}
+export interface AwkRangePattern {
+    type: "range";
+    start: AwkPattern;
+    end: AwkPattern;
+}
+export interface AwkRule {
+    pattern?: AwkPattern;
+    action: AwkBlock;
+}
+export interface AwkFunctionDef {
+    name: string;
+    params: string[];
+    body: AwkBlock;
+}
+export interface AwkProgram {
+    functions: AwkFunctionDef[];
+    rules: AwkRule[];
+}

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

@@ -0,0 +1,9 @@
+/**
+ * AWK Command - New AST-based Implementation
+ *
+ * This is the new implementation using proper lexer/parser/interpreter architecture.
+ */
+import type { Command } from "../../types.js";
+export declare const awkCommand2: Command;
+import type { CommandFuzzInfo } from "../fuzz-flags-types.js";
+export declare const flagsForFuzzing: CommandFuzzInfo;

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

@@ -0,0 +1,17 @@
+/**
+ * AWK Built-in Functions
+ *
+ * Implementation of AWK built-in functions for the AST-based interpreter.
+ */
+import type { AwkExpr } from "./ast.js";
+import type { AwkRuntimeContext } from "./interpreter/context.js";
+import type { AwkValue } from "./interpreter/types.js";
+/**
+ * Interface for evaluating expressions (passed from interpreter)
+ */
+export interface AwkEvaluator {
+    evalExpr: (expr: AwkExpr) => Promise<AwkValue>;
+}
+export type AwkBuiltinFn = (args: AwkExpr[], ctx: AwkRuntimeContext, evaluator: AwkEvaluator) => AwkValue | Promise<AwkValue>;
+export declare function formatPrintf(format: string, values: AwkValue[]): string;
+export declare const awkBuiltins: Map<string, AwkBuiltinFn>;

package/dist/commands/awk/interpreter/context.d.ts

@@ -0,0 +1,75 @@
+/**
+ * AWK Runtime Context
+ *
+ * Holds all state for AWK program execution.
+ */
+import { type RegexLike } from "../../../regex/index.js";
+import type { FeatureCoverageWriter } from "../../../types.js";
+import type { AwkFunctionDef } from "../ast.js";
+import type { AwkFileSystem, AwkValue } from "./types.js";
+export interface AwkRuntimeContext {
+    FS: string;
+    OFS: string;
+    ORS: string;
+    OFMT: string;
+    NR: number;
+    NF: number;
+    FNR: number;
+    FILENAME: string;
+    RSTART: number;
+    RLENGTH: number;
+    SUBSEP: string;
+    fields: string[];
+    line: string;
+    vars: Record<string, AwkValue>;
+    arrays: Record<string, Record<string, AwkValue>>;
+    arrayAliases: Map<string, string>;
+    ARGC: number;
+    ARGV: Record<string, string>;
+    ENVIRON: Record<string, string>;
+    functions: Map<string, AwkFunctionDef>;
+    lines?: string[];
+    lineIndex?: number;
+    fieldSep: RegexLike;
+    maxIterations: number;
+    maxRecursionDepth: number;
+    maxOutputSize: number;
+    currentRecursionDepth: number;
+    exitCode: number;
+    shouldExit: boolean;
+    shouldNext: boolean;
+    shouldNextFile: boolean;
+    loopBreak: boolean;
+    loopContinue: boolean;
+    returnValue?: AwkValue;
+    hasReturn: boolean;
+    inEndBlock: boolean;
+    output: string;
+    fs?: AwkFileSystem;
+    cwd?: string;
+    openedFiles: Set<string>;
+    random?: () => number;
+    exec?: (cmd: string) => Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }>;
+    coverage?: FeatureCoverageWriter;
+    requireDefenseContext?: boolean;
+}
+export interface CreateContextOptions {
+    fieldSep?: RegexLike;
+    maxIterations?: number;
+    maxRecursionDepth?: number;
+    maxOutputSize?: number;
+    fs?: AwkFileSystem;
+    cwd?: string;
+    exec?: (cmd: string) => Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }>;
+    coverage?: FeatureCoverageWriter;
+    requireDefenseContext?: boolean;
+}
+export declare function createRuntimeContext(options?: CreateContextOptions): AwkRuntimeContext;

package/dist/commands/awk/interpreter/expressions.d.ts

@@ -0,0 +1,17 @@
+/**
+ * AWK Expression Evaluation
+ *
+ * Async expression evaluator supporting file I/O operations.
+ */
+import type { AwkExpr } from "../ast.js";
+import type { AwkRuntimeContext } from "./context.js";
+import type { AwkValue } from "./types.js";
+export type BlockExecutor = (ctx: AwkRuntimeContext, statements: import("../ast.js").AwkStmt[]) => Promise<void>;
+/**
+ * Set the block executor function (called from statements.ts to avoid circular deps)
+ */
+export declare function setBlockExecutor(fn: BlockExecutor): void;
+/**
+ * Evaluate an AWK expression asynchronously.
+ */
+export declare function evalExpr(ctx: AwkRuntimeContext, expr: AwkExpr): Promise<AwkValue>;

package/dist/commands/awk/interpreter/fields.d.ts

@@ -0,0 +1,25 @@
+/**
+ * AWK Field Operations
+ *
+ * Handles $0, $1, $2, etc. field access and modification.
+ */
+import type { AwkRuntimeContext } from "./context.js";
+import type { AwkValue } from "./types.js";
+/**
+ * Get a field value by index.
+ * $0 is the whole line, $1 is first field, etc.
+ */
+export declare function getField(ctx: AwkRuntimeContext, index: number): AwkValue;
+/**
+ * Set a field value by index.
+ * Setting $0 re-splits the line. Setting other fields rebuilds $0.
+ */
+export declare function setField(ctx: AwkRuntimeContext, index: number, value: AwkValue): void;
+/**
+ * Update context with a new line (used when processing input).
+ */
+export declare function setCurrentLine(ctx: AwkRuntimeContext, line: string): void;
+/**
+ * Update field separator and recompile regex.
+ */
+export declare function setFieldSeparator(ctx: AwkRuntimeContext, fs: string): void;

package/dist/commands/awk/interpreter/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AWK Interpreter Module
+ *
+ * Re-exports the public API for the AWK interpreter.
+ */
+export { type AwkRuntimeContext, type CreateContextOptions, createRuntimeContext, } from "./context.js";
+export { AwkInterpreter } from "./interpreter.js";
+export type { AwkFileSystem, AwkValue } from "./types.js";

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

@@ -0,0 +1,54 @@
+/**
+ * AWK Interpreter
+ *
+ * Main interpreter class that orchestrates AWK program execution.
+ */
+import type { AwkProgram } from "../ast.js";
+import type { AwkRuntimeContext } from "./context.js";
+export declare class AwkInterpreter {
+    private ctx;
+    private program;
+    private rangeStates;
+    constructor(ctx: AwkRuntimeContext);
+    private assertDefenseContext;
+    private withDefenseContext;
+    /**
+     * Initialize the interpreter with a program.
+     * Must be called before executeBegin/executeLine/executeEnd.
+     */
+    execute(program: AwkProgram): void;
+    /**
+     * Execute all BEGIN blocks.
+     */
+    executeBegin(): Promise<void>;
+    /**
+     * Execute rules for a single input line.
+     */
+    executeLine(line: string): Promise<void>;
+    /**
+     * Execute all END blocks.
+     * END blocks run even after exit is called, but exit from within
+     * an END block stops further END block execution.
+     */
+    executeEnd(): Promise<void>;
+    /**
+     * Get the accumulated output.
+     */
+    getOutput(): string;
+    /**
+     * Get the exit code.
+     */
+    getExitCode(): number;
+    /**
+     * Get the runtime context (for access to control flow flags, etc.)
+     */
+    getContext(): AwkRuntimeContext;
+    /**
+     * Check if a rule matches the current line.
+     */
+    private matchesRule;
+    /**
+     * Check if a pattern matches.
+     */
+    private matchPattern;
+}

package/dist/commands/awk/interpreter/statements.d.ts

@@ -0,0 +1,11 @@
+/**
+ * AWK Statement Execution
+ *
+ * Async statement executor supporting file I/O operations.
+ */
+import type { AwkStmt } from "../ast.js";
+import type { AwkRuntimeContext } from "./context.js";
+/**
+ * Execute a block of statements.
+ */
+export declare function executeBlock(ctx: AwkRuntimeContext, statements: AwkStmt[]): Promise<void>;

package/dist/commands/awk/interpreter/type-coercion.d.ts

@@ -0,0 +1,32 @@
+/**
+ * AWK Type Conversion Helpers
+ *
+ * Pure functions for type conversion and truthiness checking.
+ */
+import type { AwkValue } from "./types.js";
+/**
+ * Check if a value is truthy in AWK.
+ * - Numbers: truthy if non-zero
+ * - Empty string: falsy
+ * - String "0": falsy (canonical string representation of zero)
+ * - All other non-empty strings: truthy (including "00", "0.0", etc.)
+ */
+export declare function isTruthy(val: AwkValue): boolean;
+/**
+ * Convert an AWK value to a number.
+ * Strings are parsed as floats, empty/non-numeric strings become 0.
+ */
+export declare function toNumber(val: AwkValue): number;
+/**
+ * Convert an AWK value to a string.
+ * Numbers are formatted without trailing zeros.
+ */
+export declare function toAwkString(val: AwkValue): string;
+/**
+ * Check if a value looks like a number for comparison purposes.
+ */
+export declare function looksLikeNumber(val: AwkValue): boolean;
+/**
+ * Test if a string matches a regex pattern.
+ */
+export declare function matchRegex(pattern: string, text: string): boolean;

package/dist/commands/awk/interpreter/types.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AWK Interpreter Types
+ */
+export type AwkValue = string | number;
+/**
+ * File system interface for AWK file operations
+ */
+export interface AwkFileSystem {
+    readFile: (path: string) => Promise<string>;
+    writeFile: (path: string, content: string) => Promise<void>;
+    appendFile: (path: string, content: string) => Promise<void>;
+    resolvePath: (cwd: string, path: string) => string;
+}

package/dist/commands/awk/interpreter/variables.d.ts

@@ -0,0 +1,35 @@
+/**
+ * AWK Variable and Array Operations
+ *
+ * Handles user variables, built-in variables, and arrays.
+ */
+import type { AwkRuntimeContext } from "./context.js";
+import type { AwkValue } from "./types.js";
+/**
+ * Get a variable value. Handles built-in variables.
+ */
+export declare function getVariable(ctx: AwkRuntimeContext, name: string): AwkValue;
+/**
+ * Set a variable value. Handles built-in variables with special behavior.
+ */
+export declare function setVariable(ctx: AwkRuntimeContext, name: string, value: AwkValue): void;
+/**
+ * Get an array element value.
+ */
+export declare function getArrayElement(ctx: AwkRuntimeContext, array: string, key: string): AwkValue;
+/**
+ * Set an array element value.
+ */
+export declare function setArrayElement(ctx: AwkRuntimeContext, array: string, key: string, value: AwkValue): void;
+/**
+ * Check if an array element exists.
+ */
+export declare function hasArrayElement(ctx: AwkRuntimeContext, array: string, key: string): boolean;
+/**
+ * Delete an array element.
+ */
+export declare function deleteArrayElement(ctx: AwkRuntimeContext, array: string, key: string): void;
+/**
+ * Delete an entire array.
+ */
+export declare function deleteArray(ctx: AwkRuntimeContext, array: string): void;

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

@@ -0,0 +1,100 @@
+/**
+ * AWK Lexer
+ *
+ * Tokenizes AWK source code into a stream of tokens.
+ */
+export declare enum TokenType {
+    NUMBER = "NUMBER",
+    STRING = "STRING",
+    REGEX = "REGEX",
+    IDENT = "IDENT",
+    BEGIN = "BEGIN",
+    END = "END",
+    IF = "IF",
+    ELSE = "ELSE",
+    WHILE = "WHILE",
+    DO = "DO",
+    FOR = "FOR",
+    IN = "IN",
+    BREAK = "BREAK",
+    CONTINUE = "CONTINUE",
+    NEXT = "NEXT",
+    NEXTFILE = "NEXTFILE",
+    EXIT = "EXIT",
+    RETURN = "RETURN",
+    DELETE = "DELETE",
+    FUNCTION = "FUNCTION",
+    PRINT = "PRINT",
+    PRINTF = "PRINTF",
+    GETLINE = "GETLINE",
+    PLUS = "PLUS",
+    MINUS = "MINUS",
+    STAR = "STAR",
+    SLASH = "SLASH",
+    PERCENT = "PERCENT",
+    CARET = "CARET",
+    EQ = "EQ",
+    NE = "NE",
+    LT = "LT",
+    GT = "GT",
+    LE = "LE",
+    GE = "GE",
+    MATCH = "MATCH",
+    NOT_MATCH = "NOT_MATCH",
+    AND = "AND",
+    OR = "OR",
+    NOT = "NOT",
+    ASSIGN = "ASSIGN",
+    PLUS_ASSIGN = "PLUS_ASSIGN",
+    MINUS_ASSIGN = "MINUS_ASSIGN",
+    STAR_ASSIGN = "STAR_ASSIGN",
+    SLASH_ASSIGN = "SLASH_ASSIGN",
+    PERCENT_ASSIGN = "PERCENT_ASSIGN",
+    CARET_ASSIGN = "CARET_ASSIGN",
+    INCREMENT = "INCREMENT",
+    DECREMENT = "DECREMENT",
+    QUESTION = "QUESTION",
+    COLON = "COLON",
+    COMMA = "COMMA",
+    SEMICOLON = "SEMICOLON",
+    NEWLINE = "NEWLINE",
+    LPAREN = "LPAREN",
+    RPAREN = "RPAREN",
+    LBRACE = "LBRACE",
+    RBRACE = "RBRACE",
+    LBRACKET = "LBRACKET",
+    RBRACKET = "RBRACKET",
+    DOLLAR = "DOLLAR",
+    APPEND = "APPEND",
+    PIPE = "PIPE",
+    EOF = "EOF"
+}
+export interface Token {
+    type: TokenType;
+    value: string | number;
+    line: number;
+    column: number;
+}
+export declare class AwkLexer {
+    private input;
+    private pos;
+    private line;
+    private column;
+    private lastTokenType;
+    constructor(input: string);
+    tokenize(): Token[];
+    private makeToken;
+    private peek;
+    private advance;
+    private skipWhitespace;
+    private nextToken;
+    private canBeRegex;
+    private readString;
+    private readRegex;
+    private readNumber;
+    private readIdentifier;
+    private readOperator;
+    private isDigit;
+    private isAlpha;
+    private isAlphaNumeric;
+}

package/dist/commands/awk/parser2-print.d.ts

@@ -0,0 +1,35 @@
+/**
+ * AWK Parser Print Context Helpers
+ *
+ * Handles parsing in print/printf context where > and >> are redirection
+ * operators rather than comparison operators.
+ */
+import type { AwkExpr, AwkStmt } from "./ast.js";
+import type { Token, TokenType } from "./lexer.js";
+/**
+ * Interface for parser methods needed by print parsing helpers.
+ * Used to avoid circular dependencies.
+ */
+export interface PrintParserContext {
+    tokens: Token[];
+    pos: number;
+    current(): Token;
+    advance(): Token;
+    match(...types: TokenType[]): boolean;
+    check(type: TokenType): boolean;
+    expect(type: TokenType, message?: string): Token;
+    skipNewlines(): void;
+    parseExpression(): AwkExpr;
+    parseTernary(): AwkExpr;
+    parsePrimary(): AwkExpr;
+    parseAddSub(): AwkExpr;
+    setPos(pos: number): void;
+}
+/**
+ * Parse a print statement.
+ */
+export declare function parsePrintStatement(p: PrintParserContext): AwkStmt;
+/**
+ * Parse a printf statement.
+ */
+export declare function parsePrintfStatement(p: PrintParserContext): AwkStmt;