@jerryan/just-bash 3.5.0

package/dist/commands/worker-request-controller.d.ts

@@ -0,0 +1,36 @@
+import type { Worker } from "node:worker_threads";
+type CancelReason = "abort" | "timeout";
+export interface WorkerRequestControllerOptions {
+    commandName: string;
+    timeoutMs: number;
+    signal?: AbortSignal;
+    maxMessageBytes: number;
+}
+/**
+ * Execution-owned lifecycle for a single worker request.  Queue implementations
+ * remain command-specific, but cancellation is armed before enqueueing and all
+ * request-owned listeners/timers are removed exactly once.
+ */
+export declare class WorkerRequestController {
+    private readonly options;
+    readonly protocolToken: string;
+    readonly deadline: number;
+    private readonly cleanups;
+    private cancelHandler;
+    private canceledReason;
+    private closed;
+    constructor(options: WorkerRequestControllerOptions);
+    /** Arm cancellation before the caller makes the request visible in a queue. */
+    arm(onCancel: (reason: CancelReason) => void): void;
+    get isCanceled(): boolean;
+    remainingTimeMs(): number;
+    timeoutMessage(noun?: string): string;
+    abortMessage(): string;
+    assertMessageSize(value: unknown, direction: "request" | "response"): void;
+    terminate(worker: Worker | null | undefined): Promise<boolean>;
+    close(): void;
+    private cancel;
+}
+/** Conservative, allocation-free estimate for structured-clone payloads. */
+export declare function estimateMessageBytes(value: unknown, stopAfter: number): number;
+export {};

package/dist/commands/xan/aggregation.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Aggregation functions for xan command
+ */
+import { type EvaluateOptions } from "../query-engine/index.js";
+import { type CsvData, type CsvRow } from "./csv.js";
+export interface AggregationLimits {
+    maxArrayElements?: number;
+    maxStringLength?: number;
+    maxIterations?: number;
+    maxDepth?: number;
+    /** Charge command-wide work before performing attacker-sized operations. */
+    consumeWork?: (units?: number) => void;
+}
+/** Conservative comparison work to reserve before allocating a sorted copy. */
+export declare function estimateSortingWork(length: number): number;
+/** Aggregation specification from parsed expression */
+export interface AggSpec {
+    func: string;
+    expr: string;
+    alias: string;
+}
+/**
+ * Parse aggregation expression: "func(expr) as alias" or "func(expr)"
+ * Handles nested parentheses in expressions like sum(add(a, b))
+ */
+export declare function parseAggExpr(expr: string, limits?: AggregationLimits): AggSpec[];
+/** Compute aggregation on data */
+export declare function computeAgg(data: CsvData, spec: AggSpec, evalOptions?: EvaluateOptions, limits?: AggregationLimits): number | string | boolean | null;
+/** Build aggregation result row */
+export declare function buildAggRow(data: CsvData, specs: AggSpec[], evalOptions?: EvaluateOptions, limits?: AggregationLimits): CsvRow;

package/dist/commands/xan/bounded-output.d.ts

@@ -0,0 +1,4 @@
+import { BoundedStringBuilder } from "../../bounded-builder.js";
+export declare class XanOutputBuilder extends BoundedStringBuilder {
+    constructor(maxBytes: number);
+}

package/dist/commands/xan/column-selection.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared utilities for xan subcommands
+ */
+import type { AstNode } from "../query-engine/parser.js";
+import { type MoonbladeLimits } from "./moonblade-parser.js";
+/**
+ * Parse a moonblade expression and transform to jq AST
+ */
+export declare function parseMoonbladeExpr(expr: string, limits?: MoonbladeLimits): AstNode;
+/**
+ * Parse column specification which can include:
+ * - Column names (e.g., "name,email")
+ * - Column indices (e.g., "0,2")
+ * - Numeric ranges (e.g., "0-2" means columns 0, 1, 2)
+ * - Column name ranges (e.g., "name:email" means columns from name to email)
+ * - Glob patterns (e.g., "vec_*", "*_count")
+ * - Negation (e.g., "!name" excludes column)
+ * Returns an array of column names
+ */
+export declare function parseColumnSpec(spec: string, headers: string[]): string[];

package/dist/commands/xan/csv.d.ts

@@ -0,0 +1,62 @@
+/**
+ * CSV parsing and formatting utilities for xan command
+ */
+import type { ExecResult, RuntimeCommandContext } from "../../types.js";
+export interface CsvRow {
+    [key: string]: string | number | boolean | null;
+}
+export type CsvData = CsvRow[];
+export type CsvCells = Array<Array<string | number | boolean | null>>;
+export interface CsvParseLimits {
+    maxStringLength?: number;
+    maxArrayElements?: number;
+    maxRows?: number;
+    maxCells?: number;
+}
+/** RuntimeCommand-wide prospective accounting for attacker-amplified CSV results. */
+export declare class DerivedCsvBudget {
+    private readonly ctx;
+    private readonly site;
+    private rows;
+    private cells;
+    constructor(ctx: RuntimeCommandContext, site: string);
+    consumeWork(units?: number): void;
+    addRow(cellCount: number): void;
+    /** Reserve a known result cardinality before constructing any result rows. */
+    addRows(rowCount: number, cellCount: number): void;
+}
+/**
+ * Create a null-prototype CsvRow to prevent prototype pollution.
+ * User-controlled CSV column names could match dangerous keys like
+ * __proto__, constructor, or prototype. Using a null-prototype object
+ * ensures these don't access the prototype chain.
+ */
+export declare function createSafeRow(): CsvRow;
+/**
+ * Set a property on a CsvRow.
+ * Since CsvRow uses null-prototype, this is safe from prototype pollution.
+ */
+export declare function safeSetRow(row: CsvRow, key: string, value: string | number | boolean | null): void;
+/**
+ * Convert a plain object row to a safe null-prototype row.
+ */
+export declare function toSafeRow(plainRow: Record<string, unknown>): CsvRow;
+/** Parse CSV input string to array of row objects */
+export declare function parseCsv(input: string, limits?: CsvParseLimits): {
+    headers: string[];
+    data: CsvData;
+};
+/** Parse headerless/ragged CSV incrementally while enforcing aggregate limits. */
+export declare function parseCsvRows(input: string, limits?: CsvParseLimits): CsvCells;
+/** Format array of row objects back to CSV string */
+export declare function formatCsv(headers: string[], data: CsvData, ctx?: RuntimeCommandContext): string;
+/** Format object rows in header order, omitting the header record itself. */
+export declare function formatCsvWithoutHeaders(headers: string[], data: CsvData, ctx: RuntimeCommandContext): string;
+/** Format already-materialized cells without Papa.unparse's unbounded copy. */
+export declare function formatCsvRows(data: readonly (readonly unknown[])[], ctx?: RuntimeCommandContext, headers?: readonly unknown[]): string;
+/** Read CSV input from file or stdin */
+export declare function readCsvInput(args: string[], ctx: RuntimeCommandContext): Promise<{
+    headers: string[];
+    data: CsvData;
+    error?: ExecResult;
+}>;

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

@@ -0,0 +1,89 @@
+/**
+ * Moonblade expression parser for xan
+ *
+ * Parses moonblade expressions (xan's expression language) and transforms
+ * them to jq AST for evaluation by the shared query engine.
+ *
+ * Grammar based on xan's grammar.pest
+ */
+import type { RuntimeCommandContext } from "../../types.js";
+export interface MoonbladeLimits {
+    maxSourceLength?: number;
+    maxTokens?: number;
+    maxDepth?: number;
+    maxOperations?: number;
+    maxAstNodes?: number;
+}
+export declare function getMoonbladeLimits(ctx: RuntimeCommandContext): MoonbladeLimits;
+export type MoonbladeExpr = {
+    type: "int";
+    value: number;
+} | {
+    type: "float";
+    value: number;
+} | {
+    type: "string";
+    value: string;
+} | {
+    type: "bool";
+    value: boolean;
+} | {
+    type: "null";
+} | {
+    type: "identifier";
+    name: string;
+    unsure: boolean;
+} | {
+    type: "underscore";
+} | {
+    type: "func";
+    name: string;
+    args: Array<{
+        name?: string;
+        expr: MoonbladeExpr;
+    }>;
+} | {
+    type: "list";
+    elements: MoonbladeExpr[];
+} | {
+    type: "map";
+    entries: Array<{
+        key: string;
+        value: MoonbladeExpr;
+    }>;
+} | {
+    type: "regex";
+    pattern: string;
+    caseInsensitive: boolean;
+} | {
+    type: "slice";
+    start?: MoonbladeExpr;
+    end?: MoonbladeExpr;
+} | {
+    type: "lambda";
+    params: string[];
+    body: MoonbladeExpr;
+} | {
+    type: "lambdaBinding";
+    name: string;
+} | {
+    type: "pipeline";
+    exprs: MoonbladeExpr[];
+};
+export interface NamedExpr {
+    expr: MoonbladeExpr;
+    name: string | string[];
+}
+export interface Aggregation {
+    aggName: string;
+    funcName: string;
+    args: MoonbladeExpr[];
+}
+/**
+ * Parse named expressions like: "expr1, expr2 as name, expr3 as (a, b)"
+ */
+export declare function parseNamedExpressions(input: string, limits?: MoonbladeLimits): NamedExpr[];
+/**
+ * Parse a moonblade expression string into AST
+ */
+export declare function parseMoonblade(input: string, limits?: MoonbladeLimits): MoonbladeExpr;

package/dist/commands/xan/moonblade-to-jq.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Transform moonblade AST to jq AST
+ *
+ * This module converts moonblade expressions (xan's expression language)
+ * to jq AST for evaluation by the shared query engine.
+ */
+import type { AstNode } from "../query-engine/parser.js";
+import type { MoonbladeExpr, MoonbladeLimits } from "./moonblade-parser.js";
+/**
+ * Transform moonblade AST to jq AST
+ */
+export declare function moonbladeToJq(expr: MoonbladeExpr, rowContext?: boolean, limits?: MoonbladeLimits): AstNode;

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

@@ -0,0 +1,32 @@
+/**
+ * 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 interface TokenizerLimits {
+    maxSourceLength?: number;
+    maxTokens?: number;
+}
+export declare class Tokenizer {
+    private input;
+    private pos;
+    private tokens;
+    private readonly maxSourceLength;
+    private readonly maxTokens;
+    constructor(input: string, limits?: TokenizerLimits);
+    tokenize(): Token[];
+    private assertTokenCapacity;
+    private skipWhitespace;
+    private nextToken;
+    private match;
+    private isIdentStart;
+    private isIdentChar;
+    private readNumber;
+    private readString;
+    private readRegex;
+    private readIdentifier;
+}

package/dist/commands/xan/subcommands.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Barrel file for xan subcommand handlers
+ *
+ * This file re-exports all subcommands from their individual modules
+ * for cleaner organization and easier maintenance.
+ */
+export { cmdAgg, cmdFrequency, cmdGroupby, cmdStats } from "./xan-agg.js";
+export { cmdDrop, cmdEnum, cmdRename, cmdSelect } from "./xan-columns.js";
+export { cmdCount, cmdHead, cmdHeaders, cmdReverse, cmdSlice, cmdTail, } from "./xan-core.js";
+export { cmdFixlengths, cmdFrom, cmdPartition, cmdShuffle, cmdSplit, cmdTo, cmdTranspose, } from "./xan-data.js";
+export { cmdDedup, cmdFilter, cmdSort, cmdTop } from "./xan-filter.js";
+export { cmdMap, cmdTransform } from "./xan-map.js";
+export { cmdExplode, cmdImplode, cmdJoin, cmdMerge, cmdPivot, } from "./xan-reshape.js";
+export { cmdBehead, cmdCat, cmdFlatmap, cmdFmt, cmdSample, cmdSearch, } from "./xan-simple.js";
+export { cmdFlatten, cmdView } from "./xan-view.js";

package/dist/commands/xan/xan-agg.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Aggregation commands: agg, groupby, frequency, stats
+ */
+import type { ExecResult, RuntimeCommandContext } from "../../types.js";
+export declare function cmdAgg(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+export declare function cmdGroupby(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+export declare function cmdFrequency(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+export declare function cmdStats(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;

package/dist/commands/xan/xan-columns.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Column operation commands: select, drop, rename, enum
+ */
+import type { ExecResult, RuntimeCommandContext } from "../../types.js";
+export declare function cmdSelect(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+export declare function cmdDrop(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+export declare function cmdRename(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+export declare function cmdEnum(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;

package/dist/commands/xan/xan-core.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Core xan commands: headers, count, head, tail, slice, reverse
+ */
+import type { ExecResult, RuntimeCommandContext } from "../../types.js";
+export declare function cmdHeaders(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+export declare function cmdCount(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+export declare function cmdHead(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+export declare function cmdTail(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+export declare function cmdSlice(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+export declare function cmdReverse(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;

package/dist/commands/xan/xan-data.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Data utility commands: transpose, shuffle, fixlengths, split, partition
+ * Commands that exist in real xan
+ */
+import type { ExecResult, RuntimeCommandContext } from "../../types.js";
+/**
+ * Transpose: swap rows and columns
+ * Usage: xan transpose [FILE]
+ *   First column becomes header row, first row becomes header column
+ */
+export declare function cmdTranspose(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+/**
+ * Shuffle: randomly reorder rows
+ * Usage: xan shuffle [OPTIONS] [FILE]
+ *   --seed N    Random seed for reproducibility
+ */
+export declare function cmdShuffle(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+/**
+ * Fixlengths: fix ragged CSV by padding/truncating rows
+ * Usage: xan fixlengths [OPTIONS] [FILE]
+ *   -l, --length N    Target number of columns (default: max row length)
+ *   -d, --default V   Default value for missing fields (default: empty)
+ */
+export declare function cmdFixlengths(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+/**
+ * Split: split CSV into multiple files by row count
+ * Usage: xan split [OPTIONS] FILE
+ *   -c, --chunks N    Split into N equal chunks
+ *   -S, --size N      Split into chunks of N rows each
+ *   -o, --output DIR  Output directory (default: current)
+ *
+ * In sandbox mode, outputs as JSON with parts as array
+ */
+export declare function cmdSplit(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+/**
+ * Partition: split CSV by column value into separate outputs
+ * Usage: xan partition COLUMN [OPTIONS] [FILE]
+ *   -o, --output DIR  Output directory (default: current)
+ */
+export declare function cmdPartition(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+/**
+ * To: convert CSV to other formats
+ * Usage: xan to FORMAT [OPTIONS] [FILE]
+ *   FORMAT: json
+ */
+export declare function cmdTo(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+/**
+ * From: convert other formats to CSV
+ * Usage: xan from [OPTIONS] [FILE]
+ *   -f, --format FORMAT   Input format (json)
+ */
+export declare function cmdFrom(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;

package/dist/commands/xan/xan-filter.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Filter and sort commands: filter, sort, dedup, top
+ */
+import type { ExecResult, RuntimeCommandContext } from "../../types.js";
+export declare function cmdFilter(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+export declare function cmdSort(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+export declare function cmdDedup(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+export declare function cmdTop(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;

package/dist/commands/xan/xan-map.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Map command: add computed columns
+ */
+import type { ExecResult, RuntimeCommandContext } from "../../types.js";
+export declare function cmdMap(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+/**
+ * Transform command: modify existing columns in-place
+ * Usage: xan transform COLUMN EXPR [FILE]
+ *   -r, --rename NAME  Rename the column after transformation
+ */
+export declare function cmdTransform(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;

package/dist/commands/xan/xan-reshape.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Reshape commands: explode, implode, flatmap, pivot, join, merge
+ */
+import type { ExecResult, RuntimeCommandContext } from "../../types.js";
+/**
+ * Explode: split delimited column values into multiple rows
+ * Usage: xan explode COLUMN [OPTIONS] [FILE]
+ *   -s, --separator SEP  Value separator (default: |)
+ *   --drop-empty         Drop rows where column is empty
+ *   -r, --rename NAME    Rename the column
+ */
+export declare function cmdExplode(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+/**
+ * Implode: combine consecutive rows with same key, joining column values
+ * Usage: xan implode COLUMN [OPTIONS] [FILE]
+ *   -s, --separator SEP  Value separator (default: |)
+ *   -r, --rename NAME    Rename the column
+ */
+export declare function cmdImplode(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+/**
+ * Join: join two CSV files on key columns
+ * Usage: xan join KEY1 FILE1 KEY2 FILE2 [OPTIONS]
+ *   --left       Left outer join (keep all rows from first file)
+ *   --right      Right outer join (keep all rows from second file)
+ *   --full       Full outer join (keep all rows from both files)
+ *   -D, --default VALUE  Default value for missing fields
+ */
+export declare function cmdJoin(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+/**
+ * Pivot: reshape data by turning row values into columns
+ * Usage: xan pivot COLUMN AGG_EXPR [OPTIONS] [FILE]
+ *   -g, --groupby COLS   Group by these columns (default: all other columns)
+ */
+export declare function cmdPivot(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+/**
+ * Merge: merge multiple sorted CSV files
+ * Usage: xan merge [OPTIONS] FILE1 FILE2 ...
+ *   -s, --sort COLUMN   Sort column (files must be pre-sorted by this)
+ */
+export declare function cmdMerge(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;

package/dist/commands/xan/xan-simple.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Simple commands: behead, sample, cat, search, flatmap, fmt
+ */
+import type { ExecResult, RuntimeCommandContext } from "../../types.js";
+/**
+ * Behead: remove header row from CSV (output data rows only)
+ * Usage: xan behead [FILE]
+ */
+export declare function cmdBehead(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+/**
+ * Sample: randomly sample N rows from CSV
+ * Usage: xan sample [OPTIONS] <sample-size> [FILE]
+ *   --seed SEED    Random seed for reproducibility
+ */
+export declare function cmdSample(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+/**
+ * Cat: concatenate CSV files
+ * Usage: xan cat [OPTIONS] FILE1 FILE2 ...
+ *   -p, --pad    Pad missing columns with empty values
+ */
+export declare function cmdCat(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+/**
+ * Search: filter rows by regex match on any/specific columns
+ * Usage: xan search [OPTIONS] PATTERN [FILE]
+ *   -s, --select COLS    Only search in these columns
+ *   -v, --invert         Invert match (exclude matching rows)
+ *   -i, --ignore-case    Case insensitive match
+ */
+export declare function cmdSearch(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+/**
+ * Flatmap: like map but expression can return multiple rows
+ * Usage: xan flatmap EXPR [FILE]
+ *   The expression should return an array; each element becomes a row
+ */
+export declare function cmdFlatmap(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+/**
+ * Fmt: format CSV as a table (alias for view with options)
+ * Usage: xan fmt [OPTIONS] [FILE]
+ */
+export declare function cmdFmt(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;

package/dist/commands/xan/xan-view.d.ts

@@ -0,0 +1,12 @@
+/**
+ * View commands: pretty print CSV as table or flattened records
+ */
+import type { ExecResult, RuntimeCommandContext } from "../../types.js";
+/**
+ * Flatten: display records vertically, one field per line
+ * Usage: xan flatten [OPTIONS] [FILE]
+ *   -l, --limit N    Maximum number of rows to display
+ *   -s, --select COLS  Select columns to display
+ */
+export declare function cmdFlatten(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;
+export declare function cmdView(args: string[], ctx: RuntimeCommandContext): Promise<ExecResult>;

package/dist/commands/xan/xan.d.ts

@@ -0,0 +1,10 @@
+/**
+ * xan - CSV toolkit command
+ *
+ * Provides ergonomic CLI for CSV operations, translating commands to jq expressions
+ * and using the shared query engine. Inspired by xsv and xan tools.
+ */
+import type { RuntimeCommand } from "../../types.js";
+export declare const xanCommand: RuntimeCommand;
+import type { CommandFuzzInfo } from "../fuzz-flags-types.js";
+export declare const flagsForFuzzing: CommandFuzzInfo;

package/dist/commands/xargs/xargs.d.ts

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

package/dist/commands/yq/formats.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Format parsing and output for yq command
+ *
+ * Supports YAML, JSON, XML, INI, CSV, and TOML formats with conversion between them.
+ */
+import type { QueryValue } from "../query-engine/index.js";
+import { type SanitizeParsedDataLimits } from "../query-engine/safe-object.js";
+export type InputFormat = "yaml" | "xml" | "json" | "ini" | "csv" | "toml";
+export type OutputFormat = "yaml" | "json" | "xml" | "ini" | "csv" | "toml";
+/**
+ * Type guard to validate input format strings at runtime
+ */
+export declare function isValidInputFormat(value: unknown): value is InputFormat;
+/**
+ * Type guard to validate output format strings at runtime
+ */
+export declare function isValidOutputFormat(value: unknown): value is OutputFormat;
+export interface FormatOptions {
+    /** Input format (default: yaml) */
+    inputFormat: InputFormat;
+    /** Output format (default: yaml) */
+    outputFormat: OutputFormat;
+    /** Output raw strings without quotes (json only) */
+    raw: boolean;
+    /** Compact output (json only) */
+    compact: boolean;
+    /** Pretty print output */
+    prettyPrint: boolean;
+    /** Indentation level */
+    indent: number;
+    /** XML attribute prefix (default: +@) */
+    xmlAttributePrefix: string;
+    /** XML text content name (default: +content) */
+    xmlContentName: string;
+    /** CSV delimiter (empty = auto-detect) */
+    csvDelimiter: string;
+    /** CSV has header row */
+    csvHeader: boolean;
+}
+export declare const defaultFormatOptions: FormatOptions;
+/**
+ * Detect input format from file extension
+ */
+export declare function detectFormatFromExtension(filename: string): InputFormat | null;
+/**
+ * Parse input data from the given format into a QueryValue
+ */
+export declare function parseInput(input: string, options: FormatOptions, limits?: SanitizeParsedDataLimits): QueryValue;
+/**
+ * Parse all YAML documents from input (for slurp mode)
+ */
+export declare function parseAllYamlDocuments(input: string, limits?: SanitizeParsedDataLimits): QueryValue[];
+/**
+ * Extract front-matter from content
+ * Front-matter is YAML/TOML/JSON at the start of a file between --- or +++ delimiters
+ * Returns { frontMatter: parsed data, content: remaining content } or null if no front-matter
+ */
+export declare function extractFrontMatter(input: string, limits?: SanitizeParsedDataLimits): {
+    frontMatter: QueryValue;
+    content: string;
+} | null;
+/**
+ * Format a QueryValue for output in the given format
+ */
+export declare function formatOutput(value: QueryValue, options: FormatOptions, maxBytes?: number): string;

package/dist/commands/yq/yq.d.ts

@@ -0,0 +1,13 @@
+/**
+ * yq - RuntimeCommand-line YAML/XML/INI/CSV/TOML processor
+ *
+ * Uses jq-style query expressions to process YAML, XML, INI, CSV, and TOML files.
+ * Shares the query engine with jq for consistent filtering behavior.
+ *
+ * Inspired by mikefarah/yq (https://github.com/mikefarah/yq)
+ * This is a reimplementation for the just-bash sandboxed environment.
+ */
+import type { RuntimeCommand } from "../../types.js";
+export declare const yqCommand: RuntimeCommand;
+import type { CommandFuzzInfo } from "../fuzz-flags-types.js";
+export declare const flagsForFuzzing: CommandFuzzInfo;