@eidos.space/just-bash 3.0.2

package/dist/commands/rg/gitignore.d.ts

@@ -0,0 +1,98 @@
+/**
+ * .gitignore parser for rg
+ *
+ * Handles:
+ * - Simple patterns (*.log, node_modules/)
+ * - Negation patterns (!important.log)
+ * - Directory-only patterns (build/)
+ * - Rooted patterns (/root-only)
+ * - Double-star patterns (for matching across directories)
+ */
+import type { IFileSystem } from "../../fs/interface.js";
+export declare class GitignoreParser {
+    private patterns;
+    private basePath;
+    constructor(basePath?: string);
+    /**
+     * Parse .gitignore content and add patterns
+     */
+    parse(content: string): void;
+    /**
+     * Convert a gitignore pattern to a regex
+     */
+    private patternToRegex;
+    /**
+     * Check if a path should be ignored
+     *
+     * @param relativePath Path relative to the gitignore location
+     * @param isDirectory Whether the path is a directory
+     * @returns true if the path should be ignored
+     */
+    matches(relativePath: string, isDirectory: boolean): boolean;
+    /**
+     * Check if a path is explicitly whitelisted by a negation pattern
+     *
+     * @param relativePath Path relative to the gitignore location
+     * @param isDirectory Whether the path is a directory
+     * @returns true if the path is whitelisted by a negation pattern
+     */
+    isWhitelisted(relativePath: string, isDirectory: boolean): boolean;
+    /**
+     * Get the base path for this gitignore
+     */
+    getBasePath(): string;
+}
+/**
+ * Hierarchical gitignore manager
+ *
+ * Loads .gitignore and .ignore files from the root down to the current directory,
+ * applying patterns in order (child patterns override parent patterns).
+ */
+export declare class GitignoreManager {
+    private parsers;
+    private fs;
+    private skipDotIgnore;
+    private skipVcsIgnore;
+    private loadedDirs;
+    constructor(fs: IFileSystem, _rootPath: string, skipDotIgnore?: boolean, skipVcsIgnore?: boolean);
+    /**
+     * Load all .gitignore and .ignore files from root to the specified path
+     */
+    load(targetPath: string): Promise<void>;
+    /**
+     * Load ignore files for a directory during traversal.
+     * Only loads if the directory hasn't been loaded before.
+     */
+    loadForDirectory(dir: string): Promise<void>;
+    /**
+     * Add patterns from raw content at the specified base path.
+     * Used for --ignore-file flag.
+     */
+    addPatternsFromContent(content: string, basePath: string): void;
+    /**
+     * Check if a path should be ignored
+     *
+     * @param absolutePath Absolute path to check
+     * @param isDirectory Whether the path is a directory
+     * @returns true if the path should be ignored
+     */
+    matches(absolutePath: string, isDirectory: boolean): boolean;
+    /**
+     * Check if a path is explicitly whitelisted by a negation pattern.
+     * Used to include hidden files that have negation patterns like "!.foo"
+     *
+     * @param absolutePath Absolute path to check
+     * @param isDirectory Whether the path is a directory
+     * @returns true if the path is whitelisted by a negation pattern
+     */
+    isWhitelisted(absolutePath: string, isDirectory: boolean): boolean;
+    /**
+     * Quick check for common ignored directories
+     * Used for early pruning during traversal
+     */
+    static isCommonIgnored(name: string): boolean;
+}
+/**
+ * Load gitignore files for a search starting at the given path
+ */
+export declare function loadGitignores(fs: IFileSystem, startPath: string, skipDotIgnore?: boolean, skipVcsIgnore?: boolean, customIgnoreFiles?: string[]): Promise<GitignoreManager>;

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

@@ -0,0 +1,61 @@
+/**
+ * RgOptions interface and default values
+ */
+export interface RgOptions {
+    ignoreCase: boolean;
+    caseSensitive: boolean;
+    smartCase: boolean;
+    fixedStrings: boolean;
+    wordRegexp: boolean;
+    lineRegexp: boolean;
+    invertMatch: boolean;
+    multiline: boolean;
+    multilineDotall: boolean;
+    patterns: string[];
+    patternFiles: string[];
+    count: boolean;
+    countMatches: boolean;
+    files: boolean;
+    filesWithMatches: boolean;
+    filesWithoutMatch: boolean;
+    stats: boolean;
+    onlyMatching: boolean;
+    maxCount: number;
+    lineNumber: boolean;
+    noFilename: boolean;
+    withFilename: boolean;
+    nullSeparator: boolean;
+    byteOffset: boolean;
+    column: boolean;
+    vimgrep: boolean;
+    replace: string | null;
+    afterContext: number;
+    beforeContext: number;
+    contextSeparator: string;
+    quiet: boolean;
+    heading: boolean;
+    passthru: boolean;
+    includeZero: boolean;
+    sort: "path" | "none";
+    json: boolean;
+    globs: string[];
+    iglobs: string[];
+    globCaseInsensitive: boolean;
+    types: string[];
+    typesNot: string[];
+    typeAdd: string[];
+    typeClear: string[];
+    hidden: boolean;
+    noIgnore: boolean;
+    noIgnoreDot: boolean;
+    noIgnoreVcs: boolean;
+    ignoreFiles: string[];
+    maxDepth: number;
+    maxFilesize: number;
+    followSymlinks: boolean;
+    searchZip: boolean;
+    searchBinary: boolean;
+    preprocessor: string | null;
+    preprocessorGlobs: string[];
+}
+export declare function createDefaultOptions(): RgOptions;

package/dist/commands/rg/rg-parser.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Argument parsing for rg command - Declarative approach
+ */
+import type { ExecResult } from "../../types.js";
+import { type RgOptions } from "./rg-options.js";
+export interface ParseResult {
+    success: true;
+    options: RgOptions;
+    paths: string[];
+    explicitLineNumbers: boolean;
+}
+export interface ParseError {
+    success: false;
+    error: ExecResult;
+}
+export type ParseArgsResult = ParseResult | ParseError;
+/**
+ * Parse rg command arguments
+ */
+export declare function parseArgs(args: string[]): ParseArgsResult;

package/dist/commands/rg/rg-search.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Core search logic for rg command
+ */
+import type { CommandContext, ExecResult } from "../../types.js";
+import type { RgOptions } from "./rg-options.js";
+export interface SearchContext {
+    ctx: CommandContext;
+    options: RgOptions;
+    paths: string[];
+    explicitLineNumbers: boolean;
+}
+/**
+ * Execute the search with parsed options
+ */
+export declare function executeSearch(searchCtx: SearchContext): Promise<ExecResult>;

package/dist/commands/rg/rg.d.ts

@@ -0,0 +1,14 @@
+/**
+ * rg - ripgrep-like recursive search
+ *
+ * Fast recursive search with smart defaults:
+ * - Recursive by default (unlike grep)
+ * - Respects .gitignore
+ * - Skips hidden files by default
+ * - Skips binary files by default
+ * - Smart case sensitivity (case-insensitive unless pattern has uppercase)
+ */
+import type { Command } from "../../types.js";
+export declare const rgCommand: Command;
+import type { CommandFuzzInfo } from "../fuzz-flags-types.js";
+export declare const flagsForFuzzing: CommandFuzzInfo;

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

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

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

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

package/dist/commands/search-engine/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared search engine for grep and rg commands
+ *
+ * Provides core text searching functionality:
+ * - Line-by-line content matching
+ * - Context lines (before/after)
+ * - Regex building for different modes (basic, extended, fixed, perl)
+ */
+export { type SearchOptions, type SearchResult, searchContent, } from "./matcher.js";
+export { buildRegex, convertReplacement, type RegexMode, type RegexOptions, type RegexResult, } from "./regex.js";

package/dist/commands/search-engine/matcher.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Core content matching logic for search commands
+ */
+import type { UserRegex } from "../../regex/index.js";
+import type { PreFilter } from "./regex.js";
+export interface SearchOptions {
+    /** Select non-matching lines */
+    invertMatch?: boolean;
+    /** Print line number with output lines */
+    showLineNumbers?: boolean;
+    /** Print only a count of matching lines */
+    countOnly?: boolean;
+    /** Count individual matches instead of lines (--count-matches) */
+    countMatches?: boolean;
+    /** Filename prefix for output (empty string for no prefix) */
+    filename?: string;
+    /** Show only the matching parts of lines */
+    onlyMatching?: boolean;
+    /** Print NUM lines of leading context */
+    beforeContext?: number;
+    /** Print NUM lines of trailing context */
+    afterContext?: number;
+    /** Stop after NUM matches (0 = unlimited) */
+    maxCount?: number;
+    /** Separator between context groups (default: --) */
+    contextSeparator?: string;
+    /** Show column number of first match */
+    showColumn?: boolean;
+    /** Output each match separately (vimgrep format) */
+    vimgrep?: boolean;
+    /** Show byte offset of each match */
+    showByteOffset?: boolean;
+    /** Replace matched text with this string */
+    replace?: string | null;
+    /** Print all lines (matches use :, non-matches use -) */
+    passthru?: boolean;
+    /** Enable multiline matching (patterns can span lines) */
+    multiline?: boolean;
+    /** If \K was used, this is the capture group index containing the "real" match */
+    kResetGroup?: number;
+    /**
+     * Optional substring fast-path: skip RE2 entirely for lines where no needle
+     * is present. Pre-computed by buildRegex from the source pattern.
+     */
+    preFilter?: PreFilter | null;
+}
+export interface SearchResult {
+    /** The formatted output string */
+    output: string;
+    /** Whether any matches were found */
+    matched: boolean;
+    /** Number of matches found */
+    matchCount: number;
+}
+/**
+ * Search content for regex matches and format output
+ *
+ * Handles:
+ * - Count only mode (-c)
+ * - Line numbers (-n)
+ * - Invert match (-v)
+ * - Only matching (-o)
+ * - Context lines (-A, -B, -C)
+ * - Max count (-m)
+ */
+export declare function searchContent(content: string, regex: UserRegex, options?: SearchOptions): SearchResult;

package/dist/commands/search-engine/regex.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Regex building utilities for search commands
+ */
+import { type UserRegex } from "../../regex/index.js";
+export type RegexMode = "basic" | "extended" | "fixed" | "perl";
+export interface RegexOptions {
+    mode: RegexMode;
+    ignoreCase?: boolean;
+    wholeWord?: boolean;
+    lineRegexp?: boolean;
+    multiline?: boolean;
+    /** Makes . match newlines in multiline mode (ripgrep --multiline-dotall) */
+    multilineDotall?: boolean;
+}
+export interface RegexResult {
+    regex: UserRegex;
+    /** If \K was used, this is the 1-based index of the capture group containing the "real" match */
+    kResetGroup?: number;
+    /**
+     * Optional fast-path filter: if every needle is absent from a line via
+     * String.indexOf, the regex is guaranteed not to match and RE2 can be skipped.
+     * Extracted only for patterns where it is provably safe (literal alternatives,
+     * optionally wrapped in \b...\b for -w mode). Null for anything more complex.
+     */
+    preFilter?: PreFilter;
+}
+export interface PreFilter {
+    /** Any one of these substrings must appear in a matching line (OR semantics). */
+    needles: string[];
+    /** When true, both needles and the line must be lowercased before indexOf. */
+    ignoreCase: boolean;
+}
+/**
+ * Build a JavaScript RegExp from a pattern with the specified mode
+ */
+export declare function buildRegex(pattern: string, options: RegexOptions): RegexResult;
+/**
+ * Convert replacement string syntax to JavaScript's String.replace format
+ *
+ * Conversions:
+ * - $0 and ${0} -> $& (full match)
+ * - $name -> $<name> (named capture groups)
+ * - ${name} -> $<name> (braced named capture groups)
+ * - Preserves $1, $2, etc. for numbered groups
+ */
+export declare function convertReplacement(replacement: string): string;

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, filename?: string, rangeStates?: Map<string, import("./types.js").RangeState>): 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/lexer.d.ts

@@ -0,0 +1,86 @@
+/**
+ * SED Lexer
+ *
+ * Tokenizes sed scripts into a stream of tokens.
+ * Sed has context-sensitive tokenization - the meaning of characters
+ * depends heavily on what command is being parsed.
+ */
+export declare enum SedTokenType {
+    NUMBER = "NUMBER",
+    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/
+    LABEL_DEF = "LABEL_DEF",// :name
+    BRANCH = "BRANCH",// b [label]
+    BRANCH_ON_SUBST = "BRANCH_ON_SUBST",// t [label]
+    BRANCH_ON_NO_SUBST = "BRANCH_ON_NO_SUBST",// T [label]
+    TEXT_CMD = "TEXT_CMD",// a\, i\, c\ with text
+    FILE_READ = "FILE_READ",// r filename
+    FILE_READ_LINE = "FILE_READ_LINE",// R filename
+    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"
+}
+export interface SedToken {
+    type: SedTokenType;
+    value: string | number;
+    pattern?: string;
+    replacement?: string;
+    flags?: string;
+    source?: string;
+    dest?: string;
+    text?: string;
+    label?: string;
+    filename?: string;
+    command?: string;
+    first?: number;
+    step?: number;
+    offset?: number;
+    line: number;
+    column: number;
+}
+export declare class SedLexer {
+    private input;
+    private pos;
+    private line;
+    private column;
+    constructor(input: string);
+    tokenize(): SedToken[];
+    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;
+    private readSubstitute;
+    private readTransliterate;
+    private readTextCommand;
+    private readBranch;
+    private readVersion;
+    private readFileCommand;
+    private readExecute;
+    private isDigit;
+}

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

@@ -0,0 +1,18 @@
+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/sed.d.ts

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