just-bash 1.0.0

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

@@ -0,0 +1,44 @@
+export interface AwkContext {
+    FS: string;
+    OFS: string;
+    NR: number;
+    NF: number;
+    FNR: number;
+    FILENAME: string;
+    RSTART: number;
+    RLENGTH: number;
+    fields: string[];
+    line: string;
+    vars: Record<string, string | number>;
+    arrays: Record<string, Record<string, string | number>>;
+    functions: Record<string, AwkFunction>;
+    random?: () => number;
+    lines?: string[];
+    lineIndex?: number;
+    fieldSep?: RegExp;
+    maxIterations?: number;
+    exitCode?: number;
+    shouldExit?: boolean;
+    shouldNext?: boolean;
+    loopBreak?: boolean;
+    loopContinue?: boolean;
+}
+export interface AwkFunction {
+    params: string[];
+    body: string;
+}
+export interface PatternRange {
+    start: string;
+    end: string;
+}
+export interface AwkRule {
+    pattern: string | null;
+    range?: PatternRange;
+    action: string;
+}
+export interface ParsedProgram {
+    begin: string | null;
+    main: AwkRule[];
+    end: string | null;
+    functions: Record<string, AwkFunction>;
+}

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

@@ -0,0 +1,5 @@
+/**
+ * base64 - Encode or decode base64
+ */
+import type { Command } from "../../types.js";
+export declare const base64Command: Command;

package/dist/commands/basename/basename.d.ts

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

package/dist/commands/bash/bash.d.ts

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

package/dist/commands/cat/cat.d.ts

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

package/dist/commands/chmod/chmod.d.ts

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

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

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

package/dist/commands/cp/cp.d.ts

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

package/dist/commands/curl/curl.d.ts

@@ -0,0 +1,8 @@
+/**
+ * curl - Transfer data from or to a server
+ *
+ * This is a simplified implementation of curl that uses the secure fetch wrapper.
+ * Network access must be explicitly configured via BashEnvOptions.network.
+ */
+import type { Command } from "../../types.js";
+export declare const curlCommand: Command;

package/dist/commands/curl/form.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Form data handling for curl command
+ */
+import type { FormField } from "./types.js";
+/**
+ * URL-encode form data in curl's --data-urlencode format
+ * Supports: name=content, =content, name@file, @file
+ */
+export declare function encodeFormData(input: string): string;
+/**
+ * Parse -F/--form field specification
+ * Supports: name=value, name=@file, name=<file, name=value;type=mime
+ */
+export declare function parseFormField(spec: string): FormField | null;
+/**
+ * Generate multipart form data body and boundary
+ */
+export declare function generateMultipartBody(fields: FormField[], fileContents: Map<string, string>): {
+    body: string;
+    boundary: string;
+};

package/dist/commands/curl/help.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Help text for curl command
+ */
+export declare const curlHelp: {
+    name: string;
+    summary: string;
+    usage: string;
+    options: string[];
+};

package/dist/commands/curl/parse.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Option parsing for curl command
+ */
+import type { ExecResult } from "../../types.js";
+import type { CurlOptions } from "./types.js";
+/**
+ * Parse curl command line arguments
+ */
+export declare function parseOptions(args: string[]): CurlOptions | ExecResult;

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

@@ -0,0 +1,31 @@
+/**
+ * Types for curl command
+ */
+export interface FormField {
+    name: string;
+    value: string;
+    filename?: string;
+    contentType?: string;
+}
+export interface CurlOptions {
+    method: string;
+    headers: Record<string, string>;
+    data?: string;
+    dataBinary: boolean;
+    formFields: FormField[];
+    user?: string;
+    uploadFile?: string;
+    cookieJar?: string;
+    outputFile?: string;
+    useRemoteName: boolean;
+    headOnly: boolean;
+    includeHeaders: boolean;
+    silent: boolean;
+    showError: boolean;
+    failSilently: boolean;
+    followRedirects: boolean;
+    writeOut?: string;
+    verbose: boolean;
+    timeoutMs?: number;
+    url?: string;
+}

package/dist/commands/curl/utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Utility functions for curl command
+ */
+/**
+ * Format response headers for output
+ */
+export declare function formatHeaders(headers: Record<string, string>): string;
+/**
+ * Extract filename from URL for -O option
+ */
+export declare function extractFilename(url: string): string;
+/**
+ * Apply write-out format string replacements
+ */
+export declare function applyWriteOut(format: string, result: {
+    status: number;
+    headers: Record<string, string>;
+    url: string;
+    bodyLength: number;
+}): string;

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

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

package/dist/commands/date/date.d.ts

@@ -0,0 +1,5 @@
+/**
+ * date - Display the current date and time
+ */
+import type { Command } from "../../types.js";
+export declare const dateCommand: Command;

package/dist/commands/diff/diff.d.ts

@@ -0,0 +1,5 @@
+/**
+ * diff - Compare files line by line
+ */
+import type { Command } from "../../types.js";
+export declare const diffCommand: Command;

package/dist/commands/dirname/dirname.d.ts

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

package/dist/commands/du/du.d.ts

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

package/dist/commands/echo/echo.d.ts

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

package/dist/commands/env/env.d.ts

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

package/dist/commands/expr/expr.d.ts

@@ -0,0 +1,7 @@
+import type { Command } from "../../types.js";
+/**
+ * expr - evaluate expressions
+ *
+ * Basic implementation supporting arithmetic operations and string operations.
+ */
+export declare const exprCommand: Command;

package/dist/commands/find/find.d.ts

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

package/dist/commands/find/matcher.d.ts

@@ -0,0 +1,3 @@
+import type { EvalContext, Expression } from "./types.js";
+export declare function evaluateExpression(expr: Expression, ctx: EvalContext): boolean;
+export declare function collectNewerRefs(expr: Expression | null): string[];

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

@@ -0,0 +1,2 @@
+import type { ParseResult } from "./types.js";
+export declare function parseExpressions(args: string[], startIndex: number): ParseResult;

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

@@ -0,0 +1,70 @@
+export type Expression = {
+    type: "name";
+    pattern: string;
+    ignoreCase?: boolean;
+} | {
+    type: "path";
+    pattern: string;
+    ignoreCase?: boolean;
+} | {
+    type: "type";
+    fileType: "f" | "d";
+} | {
+    type: "empty";
+} | {
+    type: "mtime";
+    days: number;
+    comparison: "exact" | "more" | "less";
+} | {
+    type: "newer";
+    refPath: string;
+} | {
+    type: "size";
+    value: number;
+    unit: SizeUnit;
+    comparison: "exact" | "more" | "less";
+} | {
+    type: "perm";
+    mode: number;
+    matchType: "exact" | "all" | "any";
+} | {
+    type: "not";
+    expr: Expression;
+} | {
+    type: "and";
+    left: Expression;
+    right: Expression;
+} | {
+    type: "or";
+    left: Expression;
+    right: Expression;
+};
+export type SizeUnit = "c" | "k" | "M" | "G" | "b";
+export type FindAction = {
+    type: "exec";
+    command: string[];
+    batchMode: boolean;
+} | {
+    type: "print";
+} | {
+    type: "print0";
+} | {
+    type: "delete";
+};
+export interface EvalContext {
+    name: string;
+    relativePath: string;
+    isFile: boolean;
+    isDirectory: boolean;
+    isEmpty: boolean;
+    mtime: number;
+    size: number;
+    mode: number;
+    newerRefTimes: Map<string, number>;
+}
+export interface ParseResult {
+    expr: Expression | null;
+    pathIndex: number;
+    error?: string;
+    actions: FindAction[];
+}

package/dist/commands/grep/grep.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "../../types.js";
+export declare const grepCommand: Command;
+export declare const fgrepCommand: Command;
+export declare const egrepCommand: Command;

package/dist/commands/head/head-tail-shared.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Shared utilities for head and tail commands.
+ */
+import type { CommandContext, ExecResult } from "../../types.js";
+export interface HeadTailOptions {
+    lines: number;
+    bytes: number | null;
+    quiet: boolean;
+    verbose: boolean;
+    files: string[];
+    /** tail-specific: start from line N instead of last N lines */
+    fromLine?: boolean;
+}
+export type HeadTailParseResult = {
+    ok: true;
+    options: HeadTailOptions;
+} | {
+    ok: false;
+    error: ExecResult;
+};
+/**
+ * Parse head/tail command arguments.
+ * Both commands share most options, with tail having additional +N syntax.
+ */
+export declare function parseHeadTailArgs(args: string[], cmdName: "head" | "tail"): HeadTailParseResult;
+/**
+ * Process files for head/tail commands.
+ * Handles stdin, multiple files, headers, and error handling.
+ */
+export declare function processHeadTailFiles(ctx: CommandContext, options: HeadTailOptions, cmdName: "head" | "tail", contentProcessor: (content: string) => string): Promise<ExecResult>;
+/**
+ * Get the first N lines or bytes from content.
+ */
+export declare function getHead(content: string, lines: number, bytes: number | null): string;
+/**
+ * Get the last N lines or bytes from content.
+ */
+export declare function getTail(content: string, lines: number, bytes: number | null, fromLine: boolean): string;

package/dist/commands/head/head.d.ts

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

package/dist/commands/help/help.d.ts

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

package/dist/commands/help.d.ts

@@ -0,0 +1,16 @@
+import type { ExecResult } from "../types.js";
+export interface HelpInfo {
+    name: string;
+    summary: string;
+    usage: string;
+    description?: string | string[];
+    options?: string[];
+    examples?: string[];
+    notes?: string[];
+}
+export declare function showHelp(info: HelpInfo): ExecResult;
+export declare function hasHelpFlag(args: string[]): boolean;
+/**
+ * Returns an error result for an unknown option
+ */
+export declare function unknownOption(cmdName: string, option: string): ExecResult;

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

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

package/dist/commands/html-to-markdown/html-to-markdown.d.ts

@@ -0,0 +1,7 @@
+/**
+ * html-to-markdown - Convert HTML to Markdown using TurndownService
+ *
+ * This is a non-standard command that converts HTML from stdin to Markdown.
+ */
+import type { Command } from "../../types.js";
+export declare const htmlToMarkdownCommand: Command;

package/dist/commands/jq/jq.d.ts

@@ -0,0 +1,14 @@
+/**
+ * jq - Command-line JSON processor
+ *
+ * Supports a subset of jq syntax:
+ * - . (identity)
+ * - .key, .key.nested (object access)
+ * - .[0], .[-1] (array indexing)
+ * - .[] (array/object iteration)
+ * - .key[] (access then iterate)
+ * - keys, values, length, type
+ * - Pipes: .foo | .bar
+ */
+import type { Command } from "../../types.js";
+export declare const jqCommand: Command;

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

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

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

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

package/dist/commands/mkdir/mkdir.d.ts

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

package/dist/commands/mv/mv.d.ts

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

package/dist/commands/paste/paste.d.ts

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

package/dist/commands/printf/printf.d.ts

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

package/dist/commands/pwd/pwd.d.ts

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

package/dist/commands/readlink/readlink.d.ts

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

package/dist/commands/registry.d.ts

@@ -0,0 +1,33 @@
+import type { Command } from "../types.js";
+/** All available built-in command names (excludes network commands like curl) */
+export type CommandName = "echo" | "cat" | "printf" | "ls" | "mkdir" | "touch" | "rm" | "cp" | "mv" | "ln" | "chmod" | "pwd" | "readlink" | "head" | "tail" | "wc" | "stat" | "grep" | "fgrep" | "egrep" | "sed" | "awk" | "sort" | "uniq" | "cut" | "paste" | "tr" | "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" | "html-to-markdown" | "help" | "which";
+/** Network command names (only available when network is configured) */
+export type NetworkCommandName = "curl";
+/** All command names including network commands */
+export type AllCommandName = CommandName | NetworkCommandName;
+/**
+ * Gets all available command names (excludes network commands)
+ */
+export declare function getCommandNames(): string[];
+/**
+ * Gets all network command names
+ */
+export declare function getNetworkCommandNames(): string[];
+/**
+ * Creates all lazy commands for registration (excludes network commands)
+ * @param filter Optional array of command names to include. If not provided, all commands are created.
+ */
+export declare function createLazyCommands(filter?: CommandName[]): Command[];
+/**
+ * Creates network commands for registration (curl, etc.)
+ * These are only registered when network is explicitly configured.
+ */
+export declare function createNetworkCommands(): Command[];
+/**
+ * Clears the command cache (for testing)
+ */
+export declare function clearCommandCache(): void;
+/**
+ * Gets the number of loaded commands (for testing)
+ */
+export declare function getLoadedCommandCount(): number;

package/dist/commands/rm/rm.d.ts

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

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

@@ -0,0 +1,7 @@
+import type { SedCommand, SedExecutionLimits, SedState } from "./types.js";
+export declare function createInitialState(totalLines: number): SedState;
+export interface ExecuteContext {
+    lines: string[];
+    currentLineIndex: number;
+}
+export declare function executeCommands(commands: SedCommand[], state: SedState, ctx?: ExecuteContext, limits?: SedExecutionLimits): number;

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

@@ -0,0 +1,5 @@
+import type { SedCommand } from "./types.js";
+export declare function parseMultipleScripts(scripts: string[], extendedRegex?: boolean): {
+    commands: SedCommand[];
+    error?: string;
+};

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

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

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

@@ -0,0 +1,141 @@
+export interface StepAddress {
+    first: number;
+    step: number;
+}
+export type SedAddress = number | "$" | {
+    pattern: string;
+} | StepAddress;
+export interface AddressRange {
+    start?: SedAddress;
+    end?: SedAddress;
+}
+export type SedCommandType = "substitute" | "print" | "printFirstLine" | "delete" | "deleteFirstLine" | "append" | "insert" | "change" | "hold" | "holdAppend" | "get" | "getAppend" | "exchange" | "next" | "nextAppend" | "quit" | "transliterate" | "lineNumber" | "branch" | "branchOnSubst" | "branchOnNoSubst" | "label" | "zap" | "group";
+export interface SubstituteCommand {
+    type: "substitute";
+    address?: AddressRange;
+    pattern: string;
+    replacement: string;
+    global: boolean;
+    ignoreCase: boolean;
+    printOnMatch: boolean;
+    nthOccurrence?: number;
+    extendedRegex?: boolean;
+}
+export interface PrintCommand {
+    type: "print";
+    address?: AddressRange;
+}
+export interface DeleteCommand {
+    type: "delete";
+    address?: AddressRange;
+}
+export interface AppendCommand {
+    type: "append";
+    address?: AddressRange;
+    text: string;
+}
+export interface InsertCommand {
+    type: "insert";
+    address?: AddressRange;
+    text: string;
+}
+export interface ChangeCommand {
+    type: "change";
+    address?: AddressRange;
+    text: string;
+}
+export interface HoldCommand {
+    type: "hold";
+    address?: AddressRange;
+}
+export interface HoldAppendCommand {
+    type: "holdAppend";
+    address?: AddressRange;
+}
+export interface GetCommand {
+    type: "get";
+    address?: AddressRange;
+}
+export interface GetAppendCommand {
+    type: "getAppend";
+    address?: AddressRange;
+}
+export interface ExchangeCommand {
+    type: "exchange";
+    address?: AddressRange;
+}
+export interface NextCommand {
+    type: "next";
+    address?: AddressRange;
+}
+export interface QuitCommand {
+    type: "quit";
+    address?: AddressRange;
+}
+export interface NextAppendCommand {
+    type: "nextAppend";
+    address?: AddressRange;
+}
+export interface TransliterateCommand {
+    type: "transliterate";
+    address?: AddressRange;
+    source: string;
+    dest: string;
+}
+export interface LineNumberCommand {
+    type: "lineNumber";
+    address?: AddressRange;
+}
+export interface BranchCommand {
+    type: "branch";
+    address?: AddressRange;
+    label?: string;
+}
+export interface BranchOnSubstCommand {
+    type: "branchOnSubst";
+    address?: AddressRange;
+    label?: string;
+}
+export interface LabelCommand {
+    type: "label";
+    name: string;
+}
+export interface BranchOnNoSubstCommand {
+    type: "branchOnNoSubst";
+    address?: AddressRange;
+    label?: string;
+}
+export interface PrintFirstLineCommand {
+    type: "printFirstLine";
+    address?: AddressRange;
+}
+export interface DeleteFirstLineCommand {
+    type: "deleteFirstLine";
+    address?: AddressRange;
+}
+export interface ZapCommand {
+    type: "zap";
+    address?: AddressRange;
+}
+export interface GroupCommand {
+    type: "group";
+    address?: AddressRange;
+    commands: SedCommand[];
+}
+export type SedCommand = SubstituteCommand | PrintCommand | PrintFirstLineCommand | DeleteCommand | DeleteFirstLineCommand | AppendCommand | InsertCommand | ChangeCommand | HoldCommand | HoldAppendCommand | GetCommand | GetAppendCommand | ExchangeCommand | NextCommand | QuitCommand | NextAppendCommand | TransliterateCommand | LineNumberCommand | BranchCommand | BranchOnSubstCommand | BranchOnNoSubstCommand | LabelCommand | ZapCommand | GroupCommand;
+export interface SedState {
+    patternSpace: string;
+    holdSpace: string;
+    lineNumber: number;
+    totalLines: number;
+    deleted: boolean;
+    printed: boolean;
+    quit: boolean;
+    appendBuffer: string[];
+    substitutionMade: boolean;
+    lineNumberOutput: string[];
+    restartCycle: boolean;
+}
+export interface SedExecutionLimits {
+    maxIterations: number;
+}