just-bash 2.5.4 → 2.6.0

package/dist/commands/query-engine/parser.d.ts

@@ -4,136 +4,6 @@
  * Tokenizes and parses jq-style filter expressions into an AST.
  * Used by jq, yq, and other query-based commands.
  */
-export type TokenType = "DOT" | "PIPE" | "COMMA" | "COLON" | "SEMICOLON" | "LPAREN" | "RPAREN" | "LBRACKET" | "RBRACKET" | "LBRACE" | "RBRACE" | "QUESTION" | "PLUS" | "MINUS" | "STAR" | "SLASH" | "PERCENT" | "EQ" | "NE" | "LT" | "LE" | "GT" | "GE" | "AND" | "OR" | "NOT" | "ALT" | "ASSIGN" | "UPDATE_ADD" | "UPDATE_SUB" | "UPDATE_MUL" | "UPDATE_DIV" | "UPDATE_MOD" | "UPDATE_ALT" | "UPDATE_PIPE" | "IDENT" | "NUMBER" | "STRING" | "IF" | "THEN" | "ELIF" | "ELSE" | "END" | "AS" | "TRY" | "CATCH" | "TRUE" | "FALSE" | "NULL" | "REDUCE" | "FOREACH" | "DOTDOT" | "EOF";
-export interface Token {
-    type: TokenType;
-    value?: string | number;
-    pos: number;
-}
-export type AstNode = IdentityNode | FieldNode | IndexNode | SliceNode | IterateNode | PipeNode | CommaNode | LiteralNode | ArrayNode | ObjectNode | ParenNode | BinaryOpNode | UnaryOpNode | CondNode | TryNode | CallNode | VarBindNode | VarRefNode | RecurseNode | OptionalNode | StringInterpNode | UpdateOpNode | ReduceNode | ForeachNode;
-export interface IdentityNode {
-    type: "Identity";
-}
-export interface FieldNode {
-    type: "Field";
-    name: string;
-    base?: AstNode;
-}
-export interface IndexNode {
-    type: "Index";
-    index: AstNode;
-    base?: AstNode;
-}
-export interface SliceNode {
-    type: "Slice";
-    start?: AstNode;
-    end?: AstNode;
-    base?: AstNode;
-}
-export interface IterateNode {
-    type: "Iterate";
-    base?: AstNode;
-}
-export interface PipeNode {
-    type: "Pipe";
-    left: AstNode;
-    right: AstNode;
-}
-export interface CommaNode {
-    type: "Comma";
-    left: AstNode;
-    right: AstNode;
-}
-export interface LiteralNode {
-    type: "Literal";
-    value: unknown;
-}
-export interface ArrayNode {
-    type: "Array";
-    elements?: AstNode;
-}
-export interface ObjectNode {
-    type: "Object";
-    entries: {
-        key: AstNode | string;
-        value: AstNode;
-    }[];
-}
-export interface ParenNode {
-    type: "Paren";
-    expr: AstNode;
-}
-export interface BinaryOpNode {
-    type: "BinaryOp";
-    op: "+" | "-" | "*" | "/" | "%" | "==" | "!=" | "<" | "<=" | ">" | ">=" | "and" | "or" | "//";
-    left: AstNode;
-    right: AstNode;
-}
-export interface UnaryOpNode {
-    type: "UnaryOp";
-    op: "-" | "not";
-    operand: AstNode;
-}
-export interface CondNode {
-    type: "Cond";
-    cond: AstNode;
-    then: AstNode;
-    elifs: {
-        cond: AstNode;
-        then: AstNode;
-    }[];
-    else?: AstNode;
-}
-export interface TryNode {
-    type: "Try";
-    body: AstNode;
-    catch?: AstNode;
-}
-export interface CallNode {
-    type: "Call";
-    name: string;
-    args: AstNode[];
-}
-export interface VarBindNode {
-    type: "VarBind";
-    name: string;
-    value: AstNode;
-    body: AstNode;
-}
-export interface VarRefNode {
-    type: "VarRef";
-    name: string;
-}
-export interface RecurseNode {
-    type: "Recurse";
-}
-export interface OptionalNode {
-    type: "Optional";
-    expr: AstNode;
-}
-export interface StringInterpNode {
-    type: "StringInterp";
-    parts: (string | AstNode)[];
-}
-export interface UpdateOpNode {
-    type: "UpdateOp";
-    op: "+=" | "-=" | "*=" | "/=" | "%=" | "//=" | "=" | "|=";
-    path: AstNode;
-    value: AstNode;
-}
-export interface ReduceNode {
-    type: "Reduce";
-    expr: AstNode;
-    varName: string;
-    init: AstNode;
-    update: AstNode;
-}
-export interface ForeachNode {
-    type: "Foreach";
-    expr: AstNode;
-    varName: string;
-    init: AstNode;
-    update: AstNode;
-    extract?: AstNode;
-}
+export type { ArrayNode, AstNode, BinaryOpNode, BreakNode, CallNode, CommaNode, CondNode, DefNode, DestructurePattern, FieldNode, ForeachNode, IdentityNode, IndexNode, IterateNode, LabelNode, LiteralNode, ObjectNode, OptionalNode, ParenNode, PipeNode, RecurseNode, ReduceNode, SliceNode, StringInterpNode, Token, TokenType, TryNode, UnaryOpNode, UpdateOpNode, VarBindNode, VarRefNode, } from "./parser-types.js";
+import type { AstNode } from "./parser-types.js";
 export declare function parse(input: string): AstNode;

package/dist/commands/query-engine/path-operations.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Query Path Utilities
+ *
+ * Utility functions for path-based operations on query values.
+ */
+import type { QueryValue } from "./value-operations.js";
+/**
+ * Set a value at a given path within a query value.
+ * Creates intermediate arrays/objects as needed.
+ */
+export declare function setPath(value: QueryValue, path: (string | number)[], newVal: QueryValue): QueryValue;
+/**
+ * Delete a value at a given path within a query value.
+ */
+export declare function deletePath(value: QueryValue, path: (string | number)[]): QueryValue;

package/dist/commands/query-engine/value-operations.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Query Value Utilities
+ *
+ * Utility functions for working with jq/query values.
+ */
+export type QueryValue = unknown;
+/**
+ * Check if a value is truthy in jq semantics.
+ * In jq: false and null are falsy, everything else is truthy.
+ */
+export declare function isTruthy(v: QueryValue): boolean;
+/**
+ * Deep equality check for query values.
+ */
+export declare function deepEqual(a: QueryValue, b: QueryValue): boolean;
+/**
+ * Compare two values for sorting.
+ * Returns negative if a < b, positive if a > b, 0 if equal.
+ */
+export declare function compare(a: QueryValue, b: QueryValue): number;
+/**
+ * Deep merge two objects.
+ * Values from b override values from a, except nested objects are merged recursively.
+ */
+export declare function deepMerge(a: Record<string, unknown>, b: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Calculate the nesting depth of a value (array or object).
+ */
+export declare function getValueDepth(value: QueryValue, maxCheck?: number): number;
+/**
+ * Compare two values using jq's comparison semantics.
+ * jq sorts by type first (null < bool < number < string < array < object),
+ * then by value within type.
+ */
+export declare function compareJq(a: QueryValue, b: QueryValue): number;
+/**
+ * Check if value a contains value b using jq's containment semantics.
+ */
+export declare function containsDeep(a: QueryValue, b: QueryValue): boolean;

package/dist/commands/registry.d.ts

@@ -1,6 +1,6 @@
 import type { Command } from "../types.js";
 /** All available built-in command names (excludes network commands) */
-export type CommandName = "echo" | "cat" | "printf" | "ls" | "mkdir" | "touch" | "rm" | "cp" | "mv" | "ln" | "chmod" | "pwd" | "readlink" | "head" | "tail" | "wc" | "stat" | "grep" | "fgrep" | "egrep" | "rg" | "sed" | "awk" | "sort" | "uniq" | "comm" | "cut" | "paste" | "tr" | "rev" | "nl" | "fold" | "expand" | "unexpand" | "strings" | "split" | "column" | "join" | "tee" | "find" | "basename" | "dirname" | "tree" | "du" | "env" | "printenv" | "alias" | "unalias" | "history" | "xargs" | "true" | "false" | "clear" | "bash" | "sh" | "jq" | "base64" | "diff" | "date" | "sleep" | "timeout" | "seq" | "expr" | "md5sum" | "sha1sum" | "sha256sum" | "file" | "html-to-markdown" | "help" | "which" | "tac" | "hostname" | "od" | "gzip" | "gunzip" | "zcat" | "tar" | "yq" | "xan" | "sqlite3";
+export type CommandName = "echo" | "cat" | "printf" | "ls" | "mkdir" | "rmdir" | "touch" | "rm" | "cp" | "mv" | "ln" | "chmod" | "pwd" | "readlink" | "head" | "tail" | "wc" | "stat" | "grep" | "fgrep" | "egrep" | "rg" | "sed" | "awk" | "sort" | "uniq" | "comm" | "cut" | "paste" | "tr" | "rev" | "nl" | "fold" | "expand" | "unexpand" | "strings" | "split" | "column" | "join" | "tee" | "find" | "basename" | "dirname" | "tree" | "du" | "env" | "printenv" | "alias" | "unalias" | "history" | "xargs" | "true" | "false" | "clear" | "bash" | "sh" | "jq" | "base64" | "diff" | "date" | "sleep" | "timeout" | "seq" | "expr" | "md5sum" | "sha1sum" | "sha256sum" | "file" | "html-to-markdown" | "help" | "which" | "tac" | "hostname" | "od" | "gzip" | "gunzip" | "zcat" | "tar" | "yq" | "xan" | "sqlite3" | "time" | "whoami";
 /** Network command names (only available when network is configured) */
 export type NetworkCommandName = "curl";
 /** All command names including network commands */

package/dist/commands/rmdir/rmdir.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "../../types.js";
+export declare const rmdirCommand: Command;

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

@@ -10,11 +10,13 @@ export declare enum SedTokenType {
     DOLLAR = "DOLLAR",// $ - last line
     PATTERN = "PATTERN",// /regex/
     STEP = "STEP",// first~step
+    RELATIVE_OFFSET = "RELATIVE_OFFSET",// +N (GNU extension: ,+N range)
     LBRACE = "LBRACE",// {
     RBRACE = "RBRACE",// }
     SEMICOLON = "SEMICOLON",// ;
     NEWLINE = "NEWLINE",
     COMMA = "COMMA",// , - address range separator
+    NEGATION = "NEGATION",// ! - negate address
     COMMAND = "COMMAND",// p, d, h, H, g, G, x, n, N, P, D, q, Q, z, =, l, F, v
     SUBSTITUTE = "SUBSTITUTE",// s/pattern/replacement/flags
     TRANSLITERATE = "TRANSLITERATE",// y/source/dest/
@@ -28,6 +30,7 @@ export declare enum SedTokenType {
     FILE_WRITE = "FILE_WRITE",// w filename
     FILE_WRITE_LINE = "FILE_WRITE_LINE",// W filename
     EXECUTE = "EXECUTE",// e [command]
+    VERSION = "VERSION",// v [version]
     EOF = "EOF",
     ERROR = "ERROR"
 }
@@ -45,6 +48,7 @@ export interface SedToken {
     command?: string;
     first?: number;
     step?: number;
+    offset?: number;
     line: number;
     column: number;
 }
@@ -58,9 +62,16 @@ export declare class SedLexer {
     private makeToken;
     private peek;
     private advance;
+    /**
+     * Read an escaped string until the delimiter is reached.
+     * Handles escape sequences: \n -> newline, \t -> tab, \X -> X
+     * Returns null if newline is encountered before delimiter.
+     */
+    private readEscapedString;
     private skipWhitespace;
     private nextToken;
     private readNumber;
+    private readRelativeOffset;
     private readPattern;
     private readLabelDef;
     private readCommand;
@@ -68,6 +79,7 @@ export declare class SedLexer {
     private readTransliterate;
     private readTextCommand;
     private readBranch;
+    private readVersion;
     private readFileCommand;
     private readExecute;
     private isDigit;

package/dist/commands/sed/parser.d.ts

@@ -2,8 +2,17 @@ import type { SedCommand } from "./types.js";
 /**
  * Parse multiple sed scripts into a list of commands.
  * This is the main entry point for parsing sed scripts.
+ *
+ * Also detects #n or #r special comments at the start of the first script:
+ * - #n enables silent mode (equivalent to -n flag)
+ * - #r enables extended regex mode (equivalent to -r/-E flag)
+ *
+ * Handles backslash continuation across -e arguments:
+ * - If a script ends with \, the next script is treated as continuation
  */
 export declare function parseMultipleScripts(scripts: string[], extendedRegex?: boolean): {
     commands: SedCommand[];
     error?: string;
+    silentMode?: boolean;
+    extendedRegexMode?: boolean;
 };

package/dist/commands/sed/sed-regex.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Regex conversion utilities for sed command
+ */
+/**
+ * Convert Basic Regular Expression (BRE) to Extended Regular Expression (ERE).
+ * In BRE: +, ?, |, (, ) are literal; \+, \?, \|, \(, \) are special
+ * In ERE: +, ?, |, (, ) are special; \+, \?, \|, \(, \) are literal
+ * Also converts POSIX character classes to JavaScript equivalents.
+ */
+export declare function breToEre(pattern: string): string;
+/**
+ * Normalize regex patterns for JavaScript RegExp.
+ * Converts GNU sed extensions to JavaScript-compatible syntax.
+ *
+ * Handles:
+ * - {,n} → {0,n} (GNU extension: "0 to n times")
+ */
+export declare function normalizeForJs(pattern: string): string;
+/**
+ * Escape pattern space for the `l` (list) command.
+ * Shows non-printable characters as escape sequences and ends with $.
+ */
+export declare function escapeForList(input: string): string;

package/dist/commands/sed/types.d.ts

@@ -2,12 +2,16 @@ export interface StepAddress {
     first: number;
     step: number;
 }
+export interface RelativeOffset {
+    offset: number;
+}
 export type SedAddress = number | "$" | {
     pattern: string;
-} | StepAddress;
+} | StepAddress | RelativeOffset;
 export interface AddressRange {
     start?: SedAddress;
     end?: SedAddress;
+    negated?: boolean;
 }
 export type SedCommandType = "substitute" | "print" | "printFirstLine" | "delete" | "deleteFirstLine" | "append" | "insert" | "change" | "hold" | "holdAppend" | "get" | "getAppend" | "exchange" | "next" | "nextAppend" | "quit" | "quitSilent" | "transliterate" | "lineNumber" | "branch" | "branchOnSubst" | "branchOnNoSubst" | "label" | "zap" | "group" | "list" | "printFilename" | "version" | "readFile" | "readFileLine" | "writeFile" | "writeFirstLine" | "execute";
 export interface SubstituteCommand {
@@ -177,10 +181,14 @@ export interface SedState {
     quit: boolean;
     quitSilent: boolean;
     exitCode?: number;
+    errorMessage?: string;
     appendBuffer: string[];
+    changedText?: string;
     substitutionMade: boolean;
     lineNumberOutput: string[];
+    nCommandOutput: string[];
     restartCycle: boolean;
+    inDRestartedCycle: boolean;
     currentFilename?: string;
     pendingFileReads: Array<{
         filename: string;
@@ -195,10 +203,14 @@ export interface SedState {
         replacePattern: boolean;
     };
     rangeStates: Map<string, RangeState>;
+    lastPattern?: string;
+    branchRequest?: string;
+    linesConsumedInCycle: number;
 }
 export interface RangeState {
     active: boolean;
     startLine?: number;
+    completed?: boolean;
 }
 export interface SedExecutionLimits {
     maxIterations: number;

package/dist/commands/tar/tar-options.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Option parsing for tar command
+ */
+import type { ExecResult } from "../../types.js";
+export interface TarOptions {
+    create: boolean;
+    append: boolean;
+    update: boolean;
+    extract: boolean;
+    list: boolean;
+    file: string;
+    autoCompress: boolean;
+    gzip: boolean;
+    bzip2: boolean;
+    xz: boolean;
+    zstd: boolean;
+    verbose: boolean;
+    toStdout: boolean;
+    keepOldFiles: boolean;
+    touch: boolean;
+    directory: string;
+    preserve: boolean;
+    strip: number;
+    exclude: string[];
+    filesFrom: string;
+    excludeFrom: string;
+    wildcards: boolean;
+}
+export declare function parseOptions(args: string[]): {
+    ok: true;
+    options: TarOptions;
+    files: string[];
+} | {
+    ok: false;
+    error: ExecResult;
+};

package/dist/commands/time/time.d.ts

@@ -0,0 +1,25 @@
+import type { Command } from "../../types.js";
+/**
+ * time - time command execution
+ *
+ * Usage: time [-f FORMAT] [-o FILE] [-a] [-v] [-p] command [arguments...]
+ *
+ * Times the execution of a command and outputs timing statistics.
+ *
+ * Options:
+ *   -f FORMAT    Use FORMAT for output (GNU time format specifiers)
+ *   -o FILE      Write timing output to FILE
+ *   -a           Append to output file (with -o)
+ *   -v           Verbose output
+ *   -p           POSIX portable output format
+ *
+ * Format specifiers:
+ *   %e    Elapsed real time in seconds
+ *   %M    Maximum resident set size (KB)
+ *   %S    System CPU time (seconds)
+ *   %U    User CPU time (seconds)
+ *
+ * Note: In this JavaScript implementation, user/system CPU time and memory
+ * metrics are not available, so %M, %S, %U output 0.
+ */
+export declare const timeCommand: Command;

package/dist/commands/whoami/whoami.d.ts

@@ -0,0 +1,9 @@
+/**
+ * whoami - print effective user name
+ *
+ * Usage: whoami
+ *
+ * In sandboxed environment, always returns "user".
+ */
+import type { Command } from "../../types.js";
+export declare const whoami: Command;

package/dist/commands/xan/moonblade-tokenizer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Moonblade expression tokenizer
+ */
+export type TokenType = "int" | "float" | "string" | "regex" | "ident" | "true" | "false" | "null" | "(" | ")" | "[" | "]" | "{" | "}" | "," | ":" | ";" | "=>" | "+" | "-" | "*" | "/" | "//" | "%" | "**" | "++" | "==" | "!=" | "<" | "<=" | ">" | ">=" | "eq" | "ne" | "lt" | "le" | "gt" | "ge" | "&&" | "||" | "and" | "or" | "!" | "." | "|" | "in" | "not in" | "as" | "=" | "_" | "eof";
+export interface Token {
+    type: TokenType;
+    value: string;
+    pos: number;
+}
+export declare class Tokenizer {
+    private input;
+    private pos;
+    private tokens;
+    constructor(input: string);
+    tokenize(): Token[];
+    private skipWhitespace;
+    private nextToken;
+    private match;
+    private isIdentStart;
+    private isIdentChar;
+    private readNumber;
+    private readString;
+    private readRegex;
+    private readIdentifier;
+}

package/dist/fs/in-memory-fs/in-memory-fs.d.ts

@@ -48,4 +48,16 @@ export declare class InMemoryFs implements IFileSystem {
     symlink(target: string, linkPath: string): Promise<void>;
     link(existingPath: string, newPath: string): Promise<void>;
     readlink(path: string): Promise<string>;
+    /**
+     * Resolve all symlinks in a path to get the canonical physical path.
+     * This is equivalent to POSIX realpath().
+     */
+    realpath(path: string): Promise<string>;
+    /**
+     * Set access and modification times of a file
+     * @param path - The file path
+     * @param _atime - Access time (ignored, kept for API compatibility)
+     * @param mtime - Modification time
+     */
+    utimes(path: string, _atime: Date, mtime: Date): Promise<void>;
 }

package/dist/fs/interface.d.ts

@@ -184,6 +184,22 @@ export interface IFileSystem {
      * @throws Error if path doesn't exist
      */
     lstat(path: string): Promise<FsStat>;
+    /**
+     * Resolve all symlinks in a path to get the canonical physical path.
+     * This is equivalent to POSIX realpath() - it resolves all symlinks
+     * in the path and returns the absolute physical path.
+     * Used by pwd -P and cd -P for symlink resolution.
+     * @throws Error if path doesn't exist or contains a broken symlink
+     */
+    realpath(path: string): Promise<string>;
+    /**
+     * Set access and modification times of a file
+     * @param path - The file path
+     * @param atime - Access time (currently ignored, kept for API compatibility)
+     * @param mtime - Modification time
+     * @throws Error if path doesn't exist
+     */
+    utimes(path: string, atime: Date, mtime: Date): Promise<void>;
 }
 /**
  * Extended file initialization options with optional metadata

package/dist/fs/mountable-fs/mountable-fs.d.ts

@@ -101,8 +101,20 @@ export declare class MountableFs implements IFileSystem {
     symlink(target: string, linkPath: string): Promise<void>;
     link(existingPath: string, newPath: string): Promise<void>;
     readlink(path: string): Promise<string>;
+    /**
+     * Resolve all symlinks in a path to get the canonical physical path.
+     * This is equivalent to POSIX realpath().
+     */
+    realpath(path: string): Promise<string>;
     /**
      * Perform a cross-mount copy operation.
      */
     private crossMountCopy;
+    /**
+     * Set access and modification times of a file
+     * @param path - The file path
+     * @param atime - Access time
+     * @param mtime - Modification time
+     */
+    utimes(path: string, atime: Date, mtime: Date): Promise<void>;
 }

package/dist/fs/overlay-fs/overlay-fs.d.ts

@@ -4,8 +4,8 @@
  * Reads come from the real filesystem, writes go to an in-memory layer.
  * Changes don't persist to disk and can't escape the root directory.
  */
+import { type FileContent } from "../encoding.js";
 import type { CpOptions, DirentEntry, FsStat, IFileSystem, MkdirOptions, ReadFileOptions, RmOptions, WriteFileOptions } from "../interface.js";
-import { type FileContent } from "../utils.js";
 export interface OverlayFsOptions {
     /**
      * The root directory on the real filesystem.
@@ -104,4 +104,16 @@ export declare class OverlayFs implements IFileSystem {
     symlink(target: string, linkPath: string): Promise<void>;
     link(existingPath: string, newPath: string): Promise<void>;
     readlink(path: string): Promise<string>;
+    /**
+     * Resolve all symlinks in a path to get the canonical physical path.
+     * This is equivalent to POSIX realpath().
+     */
+    realpath(path: string): Promise<string>;
+    /**
+     * Set access and modification times of a file
+     * @param path - The file path
+     * @param _atime - Access time (ignored, kept for API compatibility)
+     * @param mtime - Modification time
+     */
+    utimes(path: string, _atime: Date, mtime: Date): Promise<void>;
 }

package/dist/fs/read-write-fs/read-write-fs.d.ts

@@ -4,8 +4,8 @@
  * All operations go directly to the underlying Node.js filesystem.
  * This is a true read-write filesystem with no overlay or sandboxing.
  */
+import { type FileContent } from "../encoding.js";
 import type { CpOptions, DirentEntry, FsStat, IFileSystem, MkdirOptions, ReadFileOptions, RmOptions, WriteFileOptions } from "../interface.js";
-import { type FileContent } from "../utils.js";
 export interface ReadWriteFsOptions {
     /**
      * The root directory on the real filesystem.
@@ -44,4 +44,16 @@ export declare class ReadWriteFs implements IFileSystem {
     symlink(target: string, linkPath: string): Promise<void>;
     link(existingPath: string, newPath: string): Promise<void>;
     readlink(path: string): Promise<string>;
+    /**
+     * Resolve all symlinks in a path to get the canonical physical path.
+     * This is equivalent to POSIX realpath().
+     */
+    realpath(path: string): Promise<string>;
+    /**
+     * Set access and modification times of a file
+     * @param path - The file path
+     * @param atime - Access time
+     * @param mtime - Modification time
+     */
+    utimes(path: string, atime: Date, mtime: Date): Promise<void>;
 }

package/dist/interpreter/alias-expansion.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Alias Expansion
+ *
+ * Handles bash alias expansion for SimpleCommandNodes.
+ *
+ * Alias expansion rules:
+ * 1. Only expands if command name is a literal unquoted word
+ * 2. Alias value is substituted for the command name
+ * 3. If alias value ends with a space, the next word is also checked for alias expansion
+ * 4. Recursive expansion is allowed but limited to prevent infinite loops
+ */
+import type { SimpleCommandNode } from "../ast/types.js";
+/**
+ * Context needed for alias expansion operations
+ */
+export interface AliasExpansionContext {
+    env: Record<string, string | undefined>;
+}
+/**
+ * Expand alias in a SimpleCommandNode if applicable.
+ * Returns a new node with the alias expanded, or the original node if no expansion.
+ */
+export declare function expandAlias(ctx: AliasExpansionContext, node: SimpleCommandNode, aliasExpansionStack: Set<string>): SimpleCommandNode;

package/dist/interpreter/arithmetic.d.ts

@@ -21,9 +21,4 @@
  */
 import type { ArithExpr } from "../ast/types.js";
 import type { InterpreterContext } from "./types.js";
-/**
- * Synchronous version of evaluateArithmetic for simple expressions.
- * Does not support command substitution - those will return 0.
- */
-export declare function evaluateArithmeticSync(ctx: InterpreterContext, expr: ArithExpr): number;
-export declare function evaluateArithmetic(ctx: InterpreterContext, expr: ArithExpr): Promise<number>;
+export declare function evaluateArithmetic(ctx: InterpreterContext, expr: ArithExpr, isExpansionContext?: boolean): Promise<number>;

package/dist/interpreter/assignment-expansion.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Assignment Expansion Helpers
+ *
+ * Handles expansion of assignment arguments for local/declare/typeset builtins.
+ * - Array assignments: name=(elem1 elem2 ...)
+ * - Scalar assignments: name=value, name+=value, name[index]=value
+ */
+import type { WordNode } from "../ast/types.js";
+import type { InterpreterContext } from "./types.js";
+/**
+ * Check if a Word represents an array assignment (name=(...)) and expand it
+ * while preserving quote structure for elements.
+ * Returns the expanded string like "name=(elem1 elem2 ...)" or null if not an array assignment.
+ */
+export declare function expandLocalArrayAssignment(ctx: InterpreterContext, word: WordNode): Promise<string | null>;
+/**
+ * Check if a Word represents a scalar assignment (name=value, name+=value, or name[index]=value)
+ * and expand it WITHOUT glob expansion on the value part.
+ * Returns the expanded string like "name=expanded_value" or null if not a scalar assignment.
+ *
+ * This is important for bash compatibility: `local var=$x` where x='a b' should
+ * set var to "a b", not try to glob-expand it.
+ */
+export declare function expandScalarAssignmentArg(ctx: InterpreterContext, word: WordNode): Promise<string | null>;