@loancrate/json-selector 4.0.0 → 5.1.0

package/dist/parser.d.ts

@@ -1,6 +1,14 @@
-import { JsonSelector } from "./ast";
+import { JsonSelector, JsonSelectorCurrent, JsonSelectorRoot } from "./ast";
+export declare const CURRENT_NODE: Readonly<JsonSelectorCurrent>;
+export declare const ROOT_NODE: Readonly<JsonSelectorRoot>;
+export interface ParserOptions {
+    /** Requires valid JSON content in backtick literals; throws on invalid JSON instead of falling back to a string. */
+    strictJsonLiterals?: boolean;
+    /** Enables backslash escape in raw strings (both \' and \\ are unescaped). Defaults to true. */
+    rawStringBackslashEscape?: boolean;
+}
 /**
- * Pratt Parser for JSON Selectors
+ * Hand-written parser for JSON Selectors.
  *
  * Uses precedence-climbing (Pratt parsing) with binding power (0-55 range) to handle
  * operator precedence efficiently. The parser uses two main methods:
@@ -8,8 +16,10 @@ import { JsonSelector } from "./ast";
  * - led() for infix/postfix operators (with left context)
  */
 export declare class Parser {
+    private readonly input;
     private readonly lexer;
-    constructor(input: string);
+    private readonly strictJsonLiterals;
+    constructor(input: string, options?: ParserOptions);
     /**
      * Main entry point: parse a complete expression
      */
@@ -21,6 +31,11 @@ export declare class Parser {
      * @returns Parsed expression node
      */
     private expression;
+    /**
+     * Continue Pratt parsing from a given left-hand side node.
+     * Applies led (left denotation) operators while their binding power exceeds rbp.
+     */
+    private expressionFrom;
     /**
      * NUD (Null Denotation): Handle prefix operators and primary expressions
      * Called when we don't have a left-hand side yet
@@ -31,6 +46,16 @@ export declare class Parser {
      * Called when we have a left-hand side
      */
     private led;
+    /**
+     * Parse lexical scope expression:
+     *   let $a = expr, $b = expr in body
+     *
+     * Called after consuming contextual "let".
+     */
+    private parseLetExpression;
+    private parseCompare;
+    private parseArithmetic;
+    private foldUnaryArithmeticLiteral;
     /**
      * Parse bracket expression: foo[0], foo[:], foo[*], foo['id']
      * Also handles leading brackets (no LHS): [0], [:], [*], ['id']
@@ -59,25 +84,70 @@ export declare class Parser {
      * 2. Terminate the projection
      *
      * Uses PROJECTION_STOP_THRESHOLD to distinguish:
-     * - Below threshold: terminators (pipe, or, and, comparisons, EOF, closing brackets)
+     * - Below threshold: terminators (pipe, ternary, or, and, comparisons, EOF, closing brackets)
      * - At/above threshold: continuation operators (flatten, filter, star, dot, bracket access)
      *
      * This allows proper precedence: `foo[] | bar` pipes the projection result,
      * while `foo[].bar` continues the projection to select .bar from each element.
      *
-     * NOTE: Unlike jmespath which uses binding power (rbp) to control projection continuation,
-     * we use a fixed threshold. This is because our AST structure is different: jmespath chains
-     * projections (project(project(x, y), z)) while we nest them in the projection field
-     * (project(x, project(y, z))). Both approaches produce the same JMESPath-compatible results,
+     * NOTE: Unlike the reference implementation which uses binding power (rbp) to control
+     * projection continuation, we use a fixed threshold. This is because our AST structure is
+     * different: the reference chains projections (project(project(x, y), z)) while we nest
+     * them in the projection field (project(x, project(y, z))). Both approaches produce the same results,
      * but our nested structure creates clearer semantics for expressions like foo[*].bar[*].
      */
     private parseProjectionRHS;
+    /**
+     * Parse the continuation of a projection: the chain of postfix operators
+     * (dot, bracket, filter) that apply to each projected element.
+     *
+     * Returns undefined if the next token does not continue the projection
+     * (e.g. pipe, comparison, EOF, or closing brackets).
+     */
+    private parseProjectionContinuation;
     /**
      * Parse slice after [ and optional start have been consumed: [start:end:step]
      *
-     * Called when pattern is [:...] (start undefined) or [n:...] (start known).
+     * Called when pattern is [:...] (start undefined) or [n:...] / [-n:...] (start known).
      */
     private parseSlice;
+    /**
+     * After consuming [ and a number, determine if this is an index or slice.
+     */
+    private parseIndexOrSlice;
+    private tryConsumeSignedNumber;
     private parseIdentifier;
+    /**
+     * Parse comma-separated expressions and closing bracket into a multi-select list.
+     * Called after the first expression has already been parsed.
+     */
+    private parseMultiSelectListFromBracket;
+    /**
+     * Parse function call: name(arg1, arg2, ...)
+     * Called after identifier has been consumed and ( has been peeked
+     */
+    private parseFunctionCall;
+    /**
+     * Parse multi-select hash: {key: expr, key: expr, ...}
+     */
+    private parseMultiSelectHash;
+    /**
+     * Parse a single key: value entry in a multi-select hash
+     */
+    private parseMultiSelectHashEntry;
+    /**
+     * Parse object projection: creates the objectProject node and parses
+     * any continuation operators.
+     */
+    private parseObjectProjection;
+    /**
+     * Parse dot-bracket: foo.[...] which could be:
+     * - Multi-select list: foo.[a, b]
+     * - Array projection: foo.[*]
+     *
+     * Note: foo.[0], foo.[:], and foo.['id'] are rejected as syntax errors.
+     */
+    private parseDotBracket;
+    private unexpectedToken;
 }
 //# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAyC,MAAM,OAAO,CAAC;AAiE5E;;;;;;;GAOG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;gBAElB,KAAK,EAAE,MAAM;IAIzB;;OAEG;IACH,KAAK,IAAI,YAAY;IAWrB;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAclB;;;OAGG;IACH,OAAO,CAAC,GAAG;IA+EX;;;OAGG;IACH,OAAO,CAAC,GAAG;IA6GX;;;;;;;;;;OAUG;IACH,OAAO,CAAC,sBAAsB;IA4D9B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,kBAAkB;IA2D1B;;;;OAIG;IACH,OAAO,CAAC,UAAU;IA8BlB,OAAO,CAAC,eAAe;CAcxB"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EAGZ,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,OAAO,CAAC;AAUf,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,mBAAmB,CAErD,CAAC;AACH,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,gBAAgB,CAE/C,CAAC;AAkEH,MAAM,WAAW,aAAa;IAC5B,oHAAoH;IACpH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gGAAgG;IAChG,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;gBAEjC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;IAQlD;;OAEG;IACH,KAAK,IAAI,YAAY;IASrB;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAIlB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAUtB;;;OAGG;IACH,OAAO,CAAC,GAAG;IAwIX;;;OAGG;IACH,OAAO,CAAC,GAAG;IAyJX;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAyB1B,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,0BAA0B;IAqBlC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,sBAAsB;IA2G9B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;;;;;OAMG;IACH,OAAO,CAAC,2BAA2B;IAYnC;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAsBlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,sBAAsB;IAqB9B,OAAO,CAAC,eAAe;IAevB;;;OAGG;IACH,OAAO,CAAC,+BAA+B;IASvC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA8B5B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAOjC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAwDvB,OAAO,CAAC,eAAe;CAaxB"}

package/dist/set.d.ts

@@ -1,3 +1,5 @@
+import { type AccessorOptions } from "./access";
 import { JsonSelector } from "./ast";
-export declare function setWithJsonSelector(selector: JsonSelector, context: unknown, value: unknown): unknown;
+/** Writes a value at the location identified by a selector, returning the previous value at that path. */
+export declare function setWithJsonSelector(selector: JsonSelector, context: unknown, value: unknown, options?: Partial<AccessorOptions>): unknown;
 //# sourceMappingURL=set.d.ts.map

package/dist/set.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../src/set.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAErC,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAKT"}
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../src/set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAGrC,0GAA0G;AAC1G,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GACjC,OAAO,CAKT"}

package/dist/token.d.ts

@@ -4,8 +4,8 @@ export declare const enum TokenType {
     RPAREN = 2,
     LBRACKET = 3,
     RBRACKET = 4,
-    LBRACE = 5,// Reserved for future use (multi-select hashes)
-    RBRACE = 6,// Reserved for future use (multi-select hashes)
+    LBRACE = 5,
+    RBRACE = 6,
     DOT = 7,
     COMMA = 8,
     COLON = 9,
@@ -19,26 +19,35 @@ export declare const enum TokenType {
     LTE = 17,
     GT = 18,
     GTE = 19,
-    AT = 20,
-    DOLLAR = 21,
-    STAR = 22,
-    QUESTION = 23,// Reserved for future use (ternary operator)
-    FILTER_BRACKET = 24,
-    FLATTEN_BRACKET = 25,
-    IDENTIFIER = 26,
-    QUOTED_STRING = 27,
-    RAW_STRING = 28,
-    BACKTICK_LITERAL = 29,
-    NUMBER = 30,
-    NULL = 31,
-    TRUE = 32,
-    FALSE = 33
+    PLUS = 20,// "+" (addition, unary plus)
+    MINUS = 21,// "-" (subtraction, unary minus; also Unicode "−")
+    MULTIPLY = 22,// "×" (Unicode U+00D7 multiplication sign only)
+    DIVIDE = 23,// "/" or "÷" (Unicode U+00F7)
+    MODULO = 24,// "%"
+    INT_DIVIDE = 25,// "//"
+    AT = 26,
+    DOLLAR = 27,
+    STAR = 28,
+    QUESTION = 29,// Ternary operator
+    AMPERSAND = 30,
+    FILTER_BRACKET = 31,
+    FLATTEN_BRACKET = 32,
+    IDENTIFIER = 33,
+    QUOTED_STRING = 34,
+    RAW_STRING = 35,
+    BACKTICK_LITERAL = 36,
+    NUMBER = 37,
+    NULL = 38,
+    TRUE = 39,
+    FALSE = 40,
+    VARIABLE = 41,
+    ASSIGN = 42
 }
 export declare const TOKEN_LIMIT: number;
 interface TokenBase {
     offset: number;
 }
-type StringTokenTypes = TokenType.IDENTIFIER | TokenType.QUOTED_STRING | TokenType.RAW_STRING | TokenType.BACKTICK_LITERAL;
+type StringTokenTypes = TokenType.IDENTIFIER | TokenType.QUOTED_STRING | TokenType.RAW_STRING | TokenType.BACKTICK_LITERAL | TokenType.VARIABLE;
 export interface StringToken extends TokenBase {
     type: StringTokenTypes;
     text: string;
@@ -74,6 +83,7 @@ export type Token = StringToken | NumberToken | NullToken | TrueToken | FalseTok
 export type TokenTypeMap = {
     [K in TokenType]: K extends StringTokenTypes ? StringToken : K extends TokenType.NUMBER ? NumberToken : K extends TokenType.NULL ? NullToken : K extends TokenType.TRUE ? TrueToken : K extends TokenType.FALSE ? FalseToken : SymbolToken;
 };
+export declare const EOF_DESCRIPTION = "end of input";
 export declare function describeTokenType(type: TokenType): string;
 export {};
 //# sourceMappingURL=token.d.ts.map

package/dist/token.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../src/token.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../src/token.ts"],"names":[],"mappings":"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"}

package/dist/util.d.ts

@@ -1,6 +1,10 @@
 import { JsonValue } from "type-fest";
 export declare function isArray(value: unknown): value is unknown[];
 export declare function asArray(value: unknown): unknown[];
+/** Tuple type that guarantees at least one element is present. */
+export type NonEmptyArray<T> = [T, ...T[]];
+/** Type guard that narrows an array to {@link NonEmptyArray}, confirming it has at least one element. */
+export declare function isNonEmptyArray<T>(arr: T[]): arr is NonEmptyArray<T>;
 export declare function isObject(value: unknown): value is Record<string, unknown>;
 export declare function isFalseOrEmpty(value: unknown): boolean;
 export declare function getField(obj: unknown, name: string): unknown;
@@ -11,4 +15,5 @@ export declare function formatLiteral(value: JsonValue): string;
 export declare function isValidIdentifier(s: string): boolean;
 export declare function formatIdentifier(s: string): string;
 export declare function formatRawString(s: string): string;
+export declare function describeValueType(value: unknown): string;
 //# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,EAAE,CAE1D;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,CAEjD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQtD;AAWD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAI7D;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAIjE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEtD;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIjD"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,EAAE,CAE1D;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,CAEjD;AAED,kEAAkE;AAClE,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAE3C,yGAAyG;AACzG,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,IAAI,aAAa,CAAC,CAAC,CAAC,CAEpE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQtD;AAWD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAI7D;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAIjE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAEtD;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQxD"}

package/dist/visitor.d.ts

@@ -1,4 +1,4 @@
-import { JsonSelector, JsonSelectorAnd, JsonSelectorCompare, JsonSelectorCurrent, JsonSelectorFieldAccess, JsonSelectorFilter, JsonSelectorFlatten, JsonSelectorIdAccess, JsonSelectorIdentifier, JsonSelectorIndexAccess, JsonSelectorLiteral, JsonSelectorNot, JsonSelectorOr, JsonSelectorPipe, JsonSelectorProject, JsonSelectorRoot, JsonSelectorSlice } from "./ast";
+import { JsonSelector, JsonSelectorAnd, JsonSelectorArithmetic, JsonSelectorCompare, JsonSelectorCurrent, JsonSelectorExpressionRef, JsonSelectorFieldAccess, JsonSelectorFilter, JsonSelectorFlatten, JsonSelectorFunctionCall, JsonSelectorIdAccess, JsonSelectorIdentifier, JsonSelectorIndexAccess, JsonSelectorLet, JsonSelectorLiteral, JsonSelectorMultiSelectHash, JsonSelectorMultiSelectList, JsonSelectorNot, JsonSelectorObjectProject, JsonSelectorOr, JsonSelectorPipe, JsonSelectorProject, JsonSelectorRoot, JsonSelectorSlice, JsonSelectorTernary, JsonSelectorUnaryArithmetic, JsonSelectorVariableRef } from "./ast";
 export interface Visitor<R, C> {
     current(node: JsonSelectorCurrent, context: C): R;
     root(node: JsonSelectorRoot, context: C): R;
@@ -13,9 +13,19 @@ export interface Visitor<R, C> {
     flatten(node: JsonSelectorFlatten, context: C): R;
     not(node: JsonSelectorNot, context: C): R;
     compare(node: JsonSelectorCompare, context: C): R;
+    arithmetic(node: JsonSelectorArithmetic, context: C): R;
+    unaryArithmetic(node: JsonSelectorUnaryArithmetic, context: C): R;
     and(node: JsonSelectorAnd, context: C): R;
     or(node: JsonSelectorOr, context: C): R;
+    ternary(node: JsonSelectorTernary, context: C): R;
     pipe(node: JsonSelectorPipe, context: C): R;
+    functionCall(node: JsonSelectorFunctionCall, context: C): R;
+    expressionRef(node: JsonSelectorExpressionRef, context: C): R;
+    variableRef(node: JsonSelectorVariableRef, context: C): R;
+    let(node: JsonSelectorLet, context: C): R;
+    multiSelectList(node: JsonSelectorMultiSelectList, context: C): R;
+    multiSelectHash(node: JsonSelectorMultiSelectHash, context: C): R;
+    objectProject(node: JsonSelectorObjectProject, context: C): R;
 }
 export declare function visitJsonSelector<R, C>(selector: JsonSelector, visitor: Visitor<R, C>, context: C): R;
 //# sourceMappingURL=visitor.d.ts.map

package/dist/visitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"visitor.d.ts","sourceRoot":"","sources":["../src/visitor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,OAAO,CAAC;AAEf,MAAM,WAAW,OAAO,CAAC,CAAC,EAAE,CAAC;IAC3B,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAClD,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAClD,UAAU,CAAC,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACxD,WAAW,CAAC,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAC1D,WAAW,CAAC,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAC1D,QAAQ,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAClD,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAClD,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAC1C,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;CAC7C;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,CAAC,EACpC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EACtB,OAAO,EAAE,CAAC,GACT,CAAC,CAmCH"}
+{"version":3,"file":"visitor.d.ts","sourceRoot":"","sources":["../src/visitor.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loancrate/json-selector",
-  "version": "4.0.0",
+  "version": "5.1.0",
   "description": "LoanCrate JSON Selectors",
   "keywords": [
     "json",
@@ -41,9 +41,10 @@
     "build": "rimraf dist && rollup -c rollup.config.mjs",
     "changeset": "changeset",
     "format": "prettier --write .",
+    "format:check": "prettier --check .",
     "lint": "eslint src test benchmark",
     "lint:ci": "eslint src test benchmark --max-warnings 0 --format junit --output-file test-results/eslint/junit.xml",
-    "prepare": "npm run build",
+    "prepare": "husky && npm run build",
     "prepublishOnly": "npm run test && npm run lint",
     "release": "changeset publish",
     "test": "jest",
@@ -66,6 +67,7 @@
     "@types/node": "^22.19.1",
     "eslint": "^9.39.1",
     "eslint-formatter-junit": "^9.0.1",
+    "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-jest": "^29.2.1",
     "globals": "^16.5.0",
     "husky": "^9.1.7",