@gabrielbryk/jq-ts 1.1.0 → 1.2.0

package/dist/index.d.cts

@@ -1,56 +1,97 @@
 //#region src/span.d.ts
+/**
+ * Represents a range of characters in the source text.
+ */
 interface Span {
   start: number;
   end: number;
 }
 //#endregion
 //#region src/ast.d.ts
+/**
+ * Represents a literal value in the jq AST.
+ * Can be null, boolean, number, or string.
+ */
 type LiteralValue = null | boolean | number | string;
+/**
+ * Represents the identity filter `.`
+ * Returns the input unchanged.
+ */
 interface IdentityNode {
   kind: 'Identity';
   span: Span;
 }
+/**
+ * Represents a literal value filter (e.g., `1`, `"hello"`, `true`, `null`).
+ * Outputs the literal value, ignoring the input.
+ */
 interface LiteralNode {
   kind: 'Literal';
   value: LiteralValue;
   span: Span;
 }
+/**
+ * Represents a variable reference (e.g., `$v`).
+ */
 interface VarNode {
   kind: 'Var';
   name: string;
   span: Span;
 }
+/**
+ * Represents field access using dot notation (e.g., `.foo`).
+ */
 interface FieldAccessNode {
   kind: 'FieldAccess';
   target: FilterNode;
   field: string;
   span: Span;
 }
+/**
+ * Represents index access (e.g., `.[0]`, `.["foo"]`).
+ */
 interface IndexAccessNode {
   kind: 'IndexAccess';
   target: FilterNode;
   index: FilterNode;
   span: Span;
 }
+/**
+ * Represents an iterator (e.g., `.[]`).
+ * Iterates over the values of an array or object.
+ */
 interface IterateNode {
   kind: 'Iterate';
   target: FilterNode;
   span: Span;
 }
+/**
+ * Represents an array construction (e.g., `[ .a, .b ]`).
+ */
 interface ArrayNode {
   kind: 'Array';
   items: FilterNode[];
   span: Span;
 }
+/**
+ * Represents an object entry in an object construction.
+ */
 interface ObjectEntry {
   key: ObjectKey;
   value: FilterNode;
 }
+/**
+ * Represents an object construction (e.g., `{ a: 1, b: 2 }`).
+ */
 interface ObjectNode {
   kind: 'Object';
   entries: ObjectEntry[];
   span: Span;
 }
+/**
+ * Represents a key in an object construction.
+ * Can be a simple identifier, a string literal, or a parenthesized expression.
+ */
 type ObjectKey = {
   kind: 'KeyIdentifier';
   name: string;
@@ -64,30 +105,48 @@ type ObjectKey = {
   expr: FilterNode;
   span: Span;
 };
+/**
+ * Represents the pipe operator `|`.
+ * Passes the output of the left filter as input to the right filter.
+ */
 interface PipeNode {
   kind: 'Pipe';
   left: FilterNode;
   right: FilterNode;
   span: Span;
 }
+/**
+ * Represents the comma operator `,`.
+ * Outputs the results of the left filter followed by the results of the right filter.
+ */
 interface CommaNode {
   kind: 'Comma';
   left: FilterNode;
   right: FilterNode;
   span: Span;
 }
+/**
+ * Represents the alternative operator `//`.
+ * If the left filter yields empty or false/null, runs the right filter.
+ */
 interface AltNode {
   kind: 'Alt';
   left: FilterNode;
   right: FilterNode;
   span: Span;
 }
+/**
+ * Represents unary operators (e.g., `-`, `not`).
+ */
 interface UnaryNode {
   kind: 'Unary';
   op: 'Neg' | 'Not';
   expr: FilterNode;
   span: Span;
 }
+/**
+ * Represents binary operators (arithmetic, comparison).
+ */
 interface BinaryNode {
   kind: 'Binary';
   op: '+' | '-' | '*' | '/' | '%' | 'Eq' | 'Neq' | 'Lt' | 'Lte' | 'Gt' | 'Gte';
@@ -95,6 +154,10 @@ interface BinaryNode {
   right: FilterNode;
   span: Span;
 }
+/**
+ * Represents boolean binary operators (`and`, `or`).
+ * These have short-circuiting behavior.
+ */
 interface BoolNode {
   kind: 'Bool';
   op: 'And' | 'Or';
@@ -106,12 +169,20 @@ interface IfBranch {
   cond: FilterNode;
   then: FilterNode;
 }
+/**
+ * Represents an if-then-else expression within jq.
+ * `if cond then true_branch else false_branch end`
+ */
 interface IfNode {
   kind: 'If';
   branches: IfBranch[];
   else: FilterNode;
   span: Span;
 }
+/**
+ * Represents a variable binding expression.
+ * `expression as $var | body`
+ */
 interface AsNode {
   kind: 'As';
   bind: FilterNode;
@@ -119,12 +190,20 @@ interface AsNode {
   body: FilterNode;
   span: Span;
 }
+/**
+ * Represents a function call.
+ * `funcname(arg1; arg2)`
+ */
 interface CallNode {
   kind: 'Call';
   name: string;
   args: FilterNode[];
   span: Span;
 }
+/**
+ * Represents the `reduce` expression.
+ * `reduce inputs as $var (init; update)`
+ */
 interface ReduceNode {
   kind: 'Reduce';
   source: FilterNode;
@@ -133,6 +212,10 @@ interface ReduceNode {
   update: FilterNode;
   span: Span;
 }
+/**
+ * Represents the `foreach` expression.
+ * `foreach inputs as $var (init; update; extract)`
+ */
 interface ForeachNode {
   kind: 'Foreach';
   source: FilterNode;
@@ -142,17 +225,80 @@ interface ForeachNode {
   extract?: FilterNode;
   span: Span;
 }
+/**
+ * Represents a `try-catch` expression.
+ * `try body catch handler` or `try body` (handler is null)
+ */
 interface TryNode {
   kind: 'Try';
   body: FilterNode;
   handler?: FilterNode;
   span: Span;
 }
+/**
+ * Represents the `recurse` builtin when used as a node (deprecated/internal mainly, usually Call).
+ * KEPT FOR COMPATIBILITY/Internal use.
+ */
 interface RecurseNode {
   kind: 'Recurse';
   span: Span;
 }
-type FilterNode = IdentityNode | LiteralNode | VarNode | FieldAccessNode | IndexAccessNode | IterateNode | ArrayNode | ObjectNode | PipeNode | CommaNode | AltNode | UnaryNode | BinaryNode | BoolNode | IfNode | AsNode | CallNode | ReduceNode | ForeachNode | TryNode | RecurseNode;
+/**
+ * Represents assignment operators (e.g., `=`, `|=`, `+=`).
+ */
+interface AssignmentNode {
+  kind: 'Assignment';
+  op: '=' | '|=' | '+=' | '-=' | '*=' | '/=' | '%=' | '//=';
+  left: FilterNode;
+  right: FilterNode;
+  span: Span;
+}
+/**
+ * Represents a function definition.
+ * `def name(args): body; next`
+ */
+interface DefNode {
+  kind: 'Def';
+  name: string;
+  args: string[];
+  body: FilterNode;
+  next: FilterNode;
+  span: Span;
+}
+/**
+ * Represents a named label for breaking.
+ * `label $out | ... break $out ...`
+ */
+interface LabelNode {
+  kind: 'Label';
+  label: string;
+  body: FilterNode;
+  span: Span;
+}
+/**
+ * Represents a break statement targeting a label.
+ * `break $out`
+ */
+interface BreakNode {
+  kind: 'Break';
+  label: string;
+  span: Span;
+}
+/**
+ * Represents an array slice operation.
+ * `.[start:end]`
+ */
+interface SliceNode {
+  kind: 'Slice';
+  target: FilterNode;
+  start: FilterNode | null;
+  end: FilterNode | null;
+  span: Span;
+}
+/**
+ * Union of all possible AST nodes in the jq syntax tree.
+ */
+type FilterNode = IdentityNode | LiteralNode | VarNode | FieldAccessNode | IndexAccessNode | IterateNode | ArrayNode | ObjectNode | PipeNode | CommaNode | AltNode | UnaryNode | BinaryNode | BoolNode | IfNode | AsNode | AssignmentNode | CallNode | ReduceNode | ForeachNode | TryNode | RecurseNode | DefNode | LabelNode | BreakNode | SliceNode;
 //#endregion
 //#region src/parser.d.ts
 /**
@@ -251,11 +397,33 @@ interface ValueObject {
   [key: string]: Value;
 }
 //#endregion
-//#region src/eval.d.ts
+//#region src/eval/types.d.ts
+/**
+ * Options passed to the evaluator.
+ */
 interface EvalOptions {
   limits?: LimitsConfig;
 }
-declare const runAst: (ast: FilterNode, input: Value, options?: EvalOptions) => Value[];
+//#endregion
+//#region src/eval/dispatch.d.ts
+/**
+ * Configuration options for the evaluation engine.
+ */
+interface EvalOptions$1 {
+  /**
+   * Limit configuration to prevent infinite loops or excessive resource usage.
+   */
+  limits?: LimitsConfig;
+}
+/**
+ * Runs a jq AST against an input value.
+ *
+ * @param ast - The parsed AST.
+ * @param input - The initial input value (JSON).
+ * @param options - Execution options.
+ * @returns An array of all values yielded by the filter.
+ */
+declare const runAst: (ast: FilterNode, input: Value, options?: EvalOptions$1) => Value[];
 //#endregion
 //#region src/errors.d.ts
 /**

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/span.ts","../src/ast.ts","../src/parser.ts","../src/validate.ts","../src/limits.ts","../src/value.ts","../src/eval.ts","../src/errors.ts","../src/index.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/span.ts","../src/ast.ts","../src/parser.ts","../src/validate.ts","../src/limits.ts","../src/value.ts","../src/eval/types.ts","../src/eval/dispatch.ts","../src/errors.ts","../src/index.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.d.mts

@@ -1,56 +1,97 @@
 //#region src/span.d.ts
+/**
+ * Represents a range of characters in the source text.
+ */
 interface Span {
   start: number;
   end: number;
 }
 //#endregion
 //#region src/ast.d.ts
+/**
+ * Represents a literal value in the jq AST.
+ * Can be null, boolean, number, or string.
+ */
 type LiteralValue = null | boolean | number | string;
+/**
+ * Represents the identity filter `.`
+ * Returns the input unchanged.
+ */
 interface IdentityNode {
   kind: 'Identity';
   span: Span;
 }
+/**
+ * Represents a literal value filter (e.g., `1`, `"hello"`, `true`, `null`).
+ * Outputs the literal value, ignoring the input.
+ */
 interface LiteralNode {
   kind: 'Literal';
   value: LiteralValue;
   span: Span;
 }
+/**
+ * Represents a variable reference (e.g., `$v`).
+ */
 interface VarNode {
   kind: 'Var';
   name: string;
   span: Span;
 }
+/**
+ * Represents field access using dot notation (e.g., `.foo`).
+ */
 interface FieldAccessNode {
   kind: 'FieldAccess';
   target: FilterNode;
   field: string;
   span: Span;
 }
+/**
+ * Represents index access (e.g., `.[0]`, `.["foo"]`).
+ */
 interface IndexAccessNode {
   kind: 'IndexAccess';
   target: FilterNode;
   index: FilterNode;
   span: Span;
 }
+/**
+ * Represents an iterator (e.g., `.[]`).
+ * Iterates over the values of an array or object.
+ */
 interface IterateNode {
   kind: 'Iterate';
   target: FilterNode;
   span: Span;
 }
+/**
+ * Represents an array construction (e.g., `[ .a, .b ]`).
+ */
 interface ArrayNode {
   kind: 'Array';
   items: FilterNode[];
   span: Span;
 }
+/**
+ * Represents an object entry in an object construction.
+ */
 interface ObjectEntry {
   key: ObjectKey;
   value: FilterNode;
 }
+/**
+ * Represents an object construction (e.g., `{ a: 1, b: 2 }`).
+ */
 interface ObjectNode {
   kind: 'Object';
   entries: ObjectEntry[];
   span: Span;
 }
+/**
+ * Represents a key in an object construction.
+ * Can be a simple identifier, a string literal, or a parenthesized expression.
+ */
 type ObjectKey = {
   kind: 'KeyIdentifier';
   name: string;
@@ -64,30 +105,48 @@ type ObjectKey = {
   expr: FilterNode;
   span: Span;
 };
+/**
+ * Represents the pipe operator `|`.
+ * Passes the output of the left filter as input to the right filter.
+ */
 interface PipeNode {
   kind: 'Pipe';
   left: FilterNode;
   right: FilterNode;
   span: Span;
 }
+/**
+ * Represents the comma operator `,`.
+ * Outputs the results of the left filter followed by the results of the right filter.
+ */
 interface CommaNode {
   kind: 'Comma';
   left: FilterNode;
   right: FilterNode;
   span: Span;
 }
+/**
+ * Represents the alternative operator `//`.
+ * If the left filter yields empty or false/null, runs the right filter.
+ */
 interface AltNode {
   kind: 'Alt';
   left: FilterNode;
   right: FilterNode;
   span: Span;
 }
+/**
+ * Represents unary operators (e.g., `-`, `not`).
+ */
 interface UnaryNode {
   kind: 'Unary';
   op: 'Neg' | 'Not';
   expr: FilterNode;
   span: Span;
 }
+/**
+ * Represents binary operators (arithmetic, comparison).
+ */
 interface BinaryNode {
   kind: 'Binary';
   op: '+' | '-' | '*' | '/' | '%' | 'Eq' | 'Neq' | 'Lt' | 'Lte' | 'Gt' | 'Gte';
@@ -95,6 +154,10 @@ interface BinaryNode {
   right: FilterNode;
   span: Span;
 }
+/**
+ * Represents boolean binary operators (`and`, `or`).
+ * These have short-circuiting behavior.
+ */
 interface BoolNode {
   kind: 'Bool';
   op: 'And' | 'Or';
@@ -106,12 +169,20 @@ interface IfBranch {
   cond: FilterNode;
   then: FilterNode;
 }
+/**
+ * Represents an if-then-else expression within jq.
+ * `if cond then true_branch else false_branch end`
+ */
 interface IfNode {
   kind: 'If';
   branches: IfBranch[];
   else: FilterNode;
   span: Span;
 }
+/**
+ * Represents a variable binding expression.
+ * `expression as $var | body`
+ */
 interface AsNode {
   kind: 'As';
   bind: FilterNode;
@@ -119,12 +190,20 @@ interface AsNode {
   body: FilterNode;
   span: Span;
 }
+/**
+ * Represents a function call.
+ * `funcname(arg1; arg2)`
+ */
 interface CallNode {
   kind: 'Call';
   name: string;
   args: FilterNode[];
   span: Span;
 }
+/**
+ * Represents the `reduce` expression.
+ * `reduce inputs as $var (init; update)`
+ */
 interface ReduceNode {
   kind: 'Reduce';
   source: FilterNode;
@@ -133,6 +212,10 @@ interface ReduceNode {
   update: FilterNode;
   span: Span;
 }
+/**
+ * Represents the `foreach` expression.
+ * `foreach inputs as $var (init; update; extract)`
+ */
 interface ForeachNode {
   kind: 'Foreach';
   source: FilterNode;
@@ -142,17 +225,80 @@ interface ForeachNode {
   extract?: FilterNode;
   span: Span;
 }
+/**
+ * Represents a `try-catch` expression.
+ * `try body catch handler` or `try body` (handler is null)
+ */
 interface TryNode {
   kind: 'Try';
   body: FilterNode;
   handler?: FilterNode;
   span: Span;
 }
+/**
+ * Represents the `recurse` builtin when used as a node (deprecated/internal mainly, usually Call).
+ * KEPT FOR COMPATIBILITY/Internal use.
+ */
 interface RecurseNode {
   kind: 'Recurse';
   span: Span;
 }
-type FilterNode = IdentityNode | LiteralNode | VarNode | FieldAccessNode | IndexAccessNode | IterateNode | ArrayNode | ObjectNode | PipeNode | CommaNode | AltNode | UnaryNode | BinaryNode | BoolNode | IfNode | AsNode | CallNode | ReduceNode | ForeachNode | TryNode | RecurseNode;
+/**
+ * Represents assignment operators (e.g., `=`, `|=`, `+=`).
+ */
+interface AssignmentNode {
+  kind: 'Assignment';
+  op: '=' | '|=' | '+=' | '-=' | '*=' | '/=' | '%=' | '//=';
+  left: FilterNode;
+  right: FilterNode;
+  span: Span;
+}
+/**
+ * Represents a function definition.
+ * `def name(args): body; next`
+ */
+interface DefNode {
+  kind: 'Def';
+  name: string;
+  args: string[];
+  body: FilterNode;
+  next: FilterNode;
+  span: Span;
+}
+/**
+ * Represents a named label for breaking.
+ * `label $out | ... break $out ...`
+ */
+interface LabelNode {
+  kind: 'Label';
+  label: string;
+  body: FilterNode;
+  span: Span;
+}
+/**
+ * Represents a break statement targeting a label.
+ * `break $out`
+ */
+interface BreakNode {
+  kind: 'Break';
+  label: string;
+  span: Span;
+}
+/**
+ * Represents an array slice operation.
+ * `.[start:end]`
+ */
+interface SliceNode {
+  kind: 'Slice';
+  target: FilterNode;
+  start: FilterNode | null;
+  end: FilterNode | null;
+  span: Span;
+}
+/**
+ * Union of all possible AST nodes in the jq syntax tree.
+ */
+type FilterNode = IdentityNode | LiteralNode | VarNode | FieldAccessNode | IndexAccessNode | IterateNode | ArrayNode | ObjectNode | PipeNode | CommaNode | AltNode | UnaryNode | BinaryNode | BoolNode | IfNode | AsNode | AssignmentNode | CallNode | ReduceNode | ForeachNode | TryNode | RecurseNode | DefNode | LabelNode | BreakNode | SliceNode;
 //#endregion
 //#region src/parser.d.ts
 /**
@@ -251,11 +397,33 @@ interface ValueObject {
   [key: string]: Value;
 }
 //#endregion
-//#region src/eval.d.ts
+//#region src/eval/types.d.ts
+/**
+ * Options passed to the evaluator.
+ */
 interface EvalOptions {
   limits?: LimitsConfig;
 }
-declare const runAst: (ast: FilterNode, input: Value, options?: EvalOptions) => Value[];
+//#endregion
+//#region src/eval/dispatch.d.ts
+/**
+ * Configuration options for the evaluation engine.
+ */
+interface EvalOptions$1 {
+  /**
+   * Limit configuration to prevent infinite loops or excessive resource usage.
+   */
+  limits?: LimitsConfig;
+}
+/**
+ * Runs a jq AST against an input value.
+ *
+ * @param ast - The parsed AST.
+ * @param input - The initial input value (JSON).
+ * @param options - Execution options.
+ * @returns An array of all values yielded by the filter.
+ */
+declare const runAst: (ast: FilterNode, input: Value, options?: EvalOptions$1) => Value[];
 //#endregion
 //#region src/errors.d.ts
 /**