just-bash 2.0.0 → 2.2.0

package/dist/commands/column/column.d.ts

@@ -0,0 +1,9 @@
+/**
+ * column - columnate lists
+ *
+ * Usage: column [OPTION]... [FILE]...
+ *
+ * Columnate input. Fill rows first by default, or create a table with -t.
+ */
+import type { Command } from "../../types.js";
+export declare const column: Command;

package/dist/commands/expand/expand.d.ts

@@ -0,0 +1,10 @@
+/**
+ * expand - convert tabs to spaces
+ *
+ * Usage: expand [OPTION]... [FILE]...
+ *
+ * Convert TABs in each FILE to spaces, writing to standard output.
+ * If no FILE is specified, standard input is read.
+ */
+import type { Command } from "../../types.js";
+export declare const expand: Command;

package/dist/commands/expand/unexpand.d.ts

@@ -0,0 +1,10 @@
+/**
+ * unexpand - convert spaces to tabs
+ *
+ * Usage: unexpand [OPTION]... [FILE]...
+ *
+ * Convert blanks in each FILE to TABs, writing to standard output.
+ * If no FILE is specified, standard input is read.
+ */
+import type { Command } from "../../types.js";
+export declare const unexpand: Command;

package/dist/commands/fold/fold.d.ts

@@ -0,0 +1,10 @@
+/**
+ * fold - wrap each input line to fit in specified width
+ *
+ * Usage: fold [OPTION]... [FILE]...
+ *
+ * Wrap input lines in each FILE, writing to standard output.
+ * If no FILE is specified, standard input is read.
+ */
+import type { Command } from "../../types.js";
+export declare const fold: Command;

package/dist/commands/join/join.d.ts

@@ -0,0 +1,10 @@
+/**
+ * join - join lines of two files on a common field
+ *
+ * Usage: join [OPTION]... FILE1 FILE2
+ *
+ * For each pair of input lines with identical join fields, write a line to
+ * standard output. The default join field is the first, delimited by blanks.
+ */
+import type { Command } from "../../types.js";
+export declare const join: Command;

package/dist/commands/nl/nl.d.ts

@@ -0,0 +1,10 @@
+/**
+ * nl - number lines of files
+ *
+ * Usage: nl [OPTION]... [FILE]...
+ *
+ * Write each FILE to standard output, with line numbers added.
+ * If no FILE is specified, standard input is read.
+ */
+import type { Command } from "../../types.js";
+export declare const nl: Command;

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

@@ -0,0 +1,25 @@
+/**
+ * Query expression evaluator
+ *
+ * Evaluates a parsed query AST against any value.
+ * Used by jq, yq, and other query-based commands.
+ */
+import type { AstNode } from "./parser.js";
+export type QueryValue = unknown;
+export interface QueryExecutionLimits {
+    maxIterations?: number;
+}
+export interface EvalContext {
+    vars: Map<string, QueryValue>;
+    limits: Required<QueryExecutionLimits>;
+    env?: Record<string, string | undefined>;
+    /** Original document root for parent/root navigation */
+    root?: QueryValue;
+    /** Current path from root for parent navigation */
+    currentPath?: (string | number)[];
+}
+export interface EvaluateOptions {
+    limits?: QueryExecutionLimits;
+    env?: Record<string, string | undefined>;
+}
+export declare function evaluate(value: QueryValue, ast: AstNode, ctxOrOptions?: EvalContext | EvaluateOptions): QueryValue[];

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

@@ -0,0 +1,8 @@
+/**
+ * Shared query engine for jq-style filtering
+ *
+ * Provides parser and evaluator for jq-style queries that can be used
+ * with any data format (JSON, YAML, XML, etc.).
+ */
+export * from "./evaluator.js";
+export * from "./parser.js";

package/dist/commands/{jq → query-engine}/parser.d.ts

@@ -1,7 +1,8 @@
 /**
- * jq filter parser
+ * Query expression parser
  *
- * Tokenizes and parses jq filter expressions into an AST.
+ * 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 {

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 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" | "comm" | "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" | "md5sum" | "sha1sum" | "sha256sum" | "file" | "html-to-markdown" | "help" | "which" | "tac" | "hostname" | "od" | "gzip" | "gunzip" | "zcat";
+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" | "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" | "yq" | "xan";
 /** Network command names (only available when network is configured) */
 export type NetworkCommandName = "curl";
 /** All command names including network commands */

package/dist/commands/rev/rev.d.ts

@@ -0,0 +1,11 @@
+/**
+ * rev - reverse lines characterwise
+ *
+ * Usage: rev [file ...]
+ *
+ * Copies the specified files to standard output, reversing the order
+ * of characters in every line. If no files are specified, standard
+ * input is read.
+ */
+import type { Command } from "../../types.js";
+export declare const rev: Command;

package/dist/commands/split/split.d.ts

@@ -0,0 +1,10 @@
+/**
+ * split - split a file into pieces
+ *
+ * Usage: split [OPTION]... [FILE [PREFIX]]
+ *
+ * Output pieces of FILE to PREFIXaa, PREFIXab, ...;
+ * default size is 1000 lines, and default PREFIX is 'x'.
+ */
+import type { Command } from "../../types.js";
+export declare const split: Command;

package/dist/commands/strings/strings.d.ts

@@ -0,0 +1,10 @@
+/**
+ * strings - print the sequences of printable characters in files
+ *
+ * Usage: strings [OPTION]... [FILE]...
+ *
+ * For each FILE, print the printable character sequences that are at least
+ * MIN characters long. If no FILE is specified, standard input is read.
+ */
+import type { Command } from "../../types.js";
+export declare const strings: Command;

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

@@ -0,0 +1,20 @@
+/**
+ * Aggregation functions for xan command
+ */
+import { type EvaluateOptions } from "../query-engine/index.js";
+import type { CsvData, CsvRow } from "./csv.js";
+/** 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): AggSpec[];
+/** Compute aggregation on data */
+export declare function computeAgg(data: CsvData, spec: AggSpec, evalOptions?: EvaluateOptions): number | string | boolean | null;
+/** Build aggregation result row */
+export declare function buildAggRow(data: CsvData, specs: AggSpec[], evalOptions?: EvaluateOptions): CsvRow;

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

@@ -0,0 +1,16 @@
+/**
+ * CSV parsing and formatting utilities for xan command
+ */
+import type { CommandContext, ExecResult } from "../../types.js";
+export interface CsvRow {
+    [key: string]: string | number | boolean | null;
+}
+export type CsvData = CsvRow[];
+/** Format array of row objects back to CSV string */
+export declare function formatCsv(headers: string[], data: CsvData): string;
+/** Read CSV input from file or stdin */
+export declare function readCsvInput(args: string[], ctx: CommandContext): Promise<{
+    headers: string[];
+    data: CsvData;
+    error?: ExecResult;
+}>;

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

@@ -0,0 +1,80 @@
+/**
+ * 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
+ */
+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): NamedExpr[];
+/**
+ * Parse a moonblade expression string into AST
+ */
+export declare function parseMoonblade(input: string): 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 } from "./moonblade-parser.js";
+/**
+ * Transform moonblade AST to jq AST
+ */
+export declare function moonbladeToJq(expr: MoonbladeExpr, rowContext?: boolean): AstNode;

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 { CommandContext, ExecResult } from "../../types.js";
+export declare function cmdAgg(args: string[], ctx: CommandContext): Promise<ExecResult>;
+export declare function cmdGroupby(args: string[], ctx: CommandContext): Promise<ExecResult>;
+export declare function cmdFrequency(args: string[], ctx: CommandContext): Promise<ExecResult>;
+export declare function cmdStats(args: string[], ctx: CommandContext): Promise<ExecResult>;

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

@@ -0,0 +1,8 @@
+/**
+ * Column operation commands: select, drop, rename, enum
+ */
+import type { CommandContext, ExecResult } from "../../types.js";
+export declare function cmdSelect(args: string[], ctx: CommandContext): Promise<ExecResult>;
+export declare function cmdDrop(args: string[], ctx: CommandContext): Promise<ExecResult>;
+export declare function cmdRename(args: string[], ctx: CommandContext): Promise<ExecResult>;
+export declare function cmdEnum(args: string[], ctx: CommandContext): 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 { CommandContext, ExecResult } from "../../types.js";
+export declare function cmdHeaders(args: string[], ctx: CommandContext): Promise<ExecResult>;
+export declare function cmdCount(args: string[], ctx: CommandContext): Promise<ExecResult>;
+export declare function cmdHead(args: string[], ctx: CommandContext): Promise<ExecResult>;
+export declare function cmdTail(args: string[], ctx: CommandContext): Promise<ExecResult>;
+export declare function cmdSlice(args: string[], ctx: CommandContext): Promise<ExecResult>;
+export declare function cmdReverse(args: string[], ctx: CommandContext): 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 { CommandContext, ExecResult } 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: CommandContext): Promise<ExecResult>;
+/**
+ * Shuffle: randomly reorder rows
+ * Usage: xan shuffle [OPTIONS] [FILE]
+ *   --seed N    Random seed for reproducibility
+ */
+export declare function cmdShuffle(args: string[], ctx: CommandContext): 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: CommandContext): 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: CommandContext): 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: CommandContext): Promise<ExecResult>;
+/**
+ * To: convert CSV to other formats
+ * Usage: xan to FORMAT [OPTIONS] [FILE]
+ *   FORMAT: json
+ */
+export declare function cmdTo(args: string[], ctx: CommandContext): 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: CommandContext): Promise<ExecResult>;

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * Map command: add computed columns
+ */
+import type { CommandContext, ExecResult } from "../../types.js";
+export declare function cmdMap(args: string[], ctx: CommandContext): 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: CommandContext): Promise<ExecResult>;

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

@@ -0,0 +1,40 @@
+/**
+ * Reshape commands: explode, implode, flatmap, pivot, join, merge
+ */
+import type { CommandContext, ExecResult } 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: CommandContext): 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: CommandContext): 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: CommandContext): 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: CommandContext): 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: CommandContext): Promise<ExecResult>;

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

@@ -0,0 +1,40 @@
+/**
+ * Simple commands: behead, sample, cat, search, flatmap, fmt
+ */
+import type { CommandContext, ExecResult } from "../../types.js";
+/**
+ * Behead: remove header row from CSV (output data rows only)
+ * Usage: xan behead [FILE]
+ */
+export declare function cmdBehead(args: string[], ctx: CommandContext): 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: CommandContext): 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: CommandContext): 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: CommandContext): 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: CommandContext): 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: CommandContext): Promise<ExecResult>;

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

@@ -0,0 +1,19 @@
+/**
+ * Shared utilities for xan subcommands
+ */
+import type { AstNode } from "../query-engine/parser.js";
+/**
+ * Parse a moonblade expression and transform to jq AST
+ */
+export declare function parseMoonbladeExpr(expr: string): 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/xan-view.d.ts

@@ -0,0 +1,12 @@
+/**
+ * View commands: pretty print CSV as table or flattened records
+ */
+import type { CommandContext, ExecResult } 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: CommandContext): Promise<ExecResult>;
+export declare function cmdView(args: string[], ctx: CommandContext): Promise<ExecResult>;

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

@@ -0,0 +1,8 @@
+/**
+ * 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 { Command } from "../../types.js";
+export declare const xanCommand: Command;

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

@@ -0,0 +1,64 @@
+/**
+ * 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";
+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): QueryValue;
+/**
+ * Parse all YAML documents from input (for slurp mode)
+ */
+export declare function parseAllYamlDocuments(input: string): 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): {
+    frontMatter: QueryValue;
+    content: string;
+} | null;
+/**
+ * Format a QueryValue for output in the given format
+ */
+export declare function formatOutput(value: QueryValue, options: FormatOptions): string;

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

@@ -0,0 +1,11 @@
+/**
+ * yq - Command-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 { Command } from "../../types.js";
+export declare const yqCommand: Command;