@loancrate/json-selector 4.0.0 → 5.1.0

package/dist/evaluate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../src/evaluate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,OAAO,CAAC;AAIlE,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,OAAO,EAChB,WAAW,UAAU,GACpB,OAAO,CA2FT;AAED,wBAAgB,OAAO,CACrB,KAAK,EAAE,OAAO,EAAE,EAChB,UAAU,EAAE,YAAY,GAAG,SAAS,EACpC,WAAW,EAAE,OAAO,GACnB,OAAO,EAAE,CAAC;AACb,wBAAgB,OAAO,CACrB,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,YAAY,GAAG,SAAS,EACpC,WAAW,EAAE,OAAO,GACnB,OAAO,EAAE,GAAG,IAAI,CAAC;AAkBpB,wBAAgB,MAAM,CACpB,KAAK,EAAE,OAAO,EAAE,EAChB,SAAS,EAAE,YAAY,EACvB,WAAW,EAAE,OAAO,GACnB,OAAO,EAAE,CAAC;AACb,wBAAgB,MAAM,CACpB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,YAAY,EACvB,WAAW,EAAE,OAAO,GACnB,OAAO,EAAE,GAAG,IAAI,CAAC;AAepB,wBAAgB,KAAK,CACnB,KAAK,EAAE,OAAO,EAAE,EAChB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,CAAC,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,EAAE,CAAC;AACb,wBAAgB,KAAK,CACnB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,CAAC,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,EAAE,GAAG,IAAI,CAAC;AAwBpB,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAiB9C;AAcD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;AACrD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC;AAK1D,wBAAgB,OAAO,CACrB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,2BAA2B,GACpC,OAAO,CAAC;AACX,wBAAgB,OAAO,CACrB,EAAE,EAAE,OAAO,EACX,EAAE,EAAE,OAAO,EACX,QAAQ,EAAE,2BAA2B,GACpC,OAAO,GAAG,IAAI,CAAC"}
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../src/evaluate.ts"],"names":[],"mappings":"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"}

package/dist/evaluation-context.d.ts

@@ -0,0 +1,17 @@
+import type { FunctionProvider } from "./functions/provider";
+/**
+ * Immutable runtime evaluation scope shared across expression evaluation.
+ * This context is evaluation-only; parser/lexer compatibility options are
+ * configured separately via parse options.
+ */
+export type EvaluationContext = {
+    /** The root document (`$`). */
+    rootContext: unknown;
+    /** Function provider for built-in and custom functions. */
+    functionProvider: FunctionProvider;
+    /** Lexical-scope variable bindings (name without `$` -> value). */
+    bindings?: ReadonlyMap<string, unknown>;
+    /** Evaluates multi-select expressions on null context instead of short-circuiting to null. Defaults to true. */
+    evaluateNullMultiSelect?: boolean;
+};
+//# sourceMappingURL=evaluation-context.d.ts.map

package/dist/evaluation-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation-context.d.ts","sourceRoot":"","sources":["../src/evaluation-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,+BAA+B;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,2DAA2D;IAC3D,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,gHAAgH;IAChH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC"}

package/dist/format.d.ts

@@ -1,6 +1,12 @@
 import { JsonSelector } from "./ast";
+/** Options controlling how a selector AST is formatted. */
 export interface FormatJsonSelectorOptions {
+    /**
+     * @deprecated This option has no effect. The AST now includes an `explicit`
+     * flag for current nodes and the formatter ensures valid output in all cases.
+     */
     currentImplied: boolean;
 }
-export declare function formatJsonSelector(selector: JsonSelector, options?: Partial<FormatJsonSelectorOptions>): string;
+/** Converts a selector AST back into its canonical string representation. */
+export declare function formatJsonSelector(selector: JsonSelector, _options?: Partial<FormatJsonSelectorOptions>): string;
 //# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAwB,MAAM,OAAO,CAAC;AAmD3D,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,OAAO,CAAC,yBAAyB,CAAM,GAC/C,MAAM,CAqFR"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAwB,MAAM,OAAO,CAAC;AAqE3D,2DAA2D;AAC3D,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAC5C,MAAM,CAQR"}

package/dist/functions/FallbackMapView.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Read-only {@link Map} view that layers a primary map over an optional fallback,
+ * with primary entries taking precedence on key collisions.
+ */
+export declare class FallbackMapView<K, V extends {}> implements ReadonlyMap<K, V> {
+    protected readonly primary: ReadonlyMap<K, V>;
+    protected readonly fallback?: ReadonlyMap<K, V> | undefined;
+    constructor(primary: ReadonlyMap<K, V>, fallback?: ReadonlyMap<K, V> | undefined);
+    get(name: K): V | undefined;
+    has(name: K): boolean;
+    get size(): number;
+    entries(): MapIterator<[K, V]>;
+    keys(): MapIterator<K>;
+    values(): MapIterator<V>;
+    [Symbol.iterator](): MapIterator<[K, V]>;
+    forEach(callbackfn: (value: V, key: K, map: ReadonlyMap<K, V>) => void, thisArg?: unknown): void;
+}
+//# sourceMappingURL=FallbackMapView.d.ts.map

package/dist/functions/FallbackMapView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FallbackMapView.d.ts","sourceRoot":"","sources":["../../src/functions/FallbackMapView.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,eAAe,CAAC,CAAC,EAAE,CAAC,SAAS,EAAE,CAAE,YAAW,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;IAEtE,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7C,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;gBAD5B,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,EAC1B,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,YAAA;IAGjD,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAI3B,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO;IAIrB,IAAI,IAAI,IAAI,MAAM,CAUjB;IAEA,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAa9B,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC;IAMtB,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC;IAMzB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAIxC,OAAO,CACL,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,EAC9D,OAAO,CAAC,EAAE,OAAO,GAChB,IAAI;CAKR"}

package/dist/functions/builtins/array.d.ts

@@ -0,0 +1,4 @@
+import { FunctionDefinition } from "../types";
+/** Registers all JMESPath array/object manipulation functions. */
+export declare function registerArrayFunctions(register: (def: FunctionDefinition) => void): void;
+//# sourceMappingURL=array.d.ts.map

package/dist/functions/builtins/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../src/functions/builtins/array.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAG9C,kEAAkE;AAClE,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAC1C,IAAI,CA4QN"}

package/dist/functions/builtins/index.d.ts

@@ -0,0 +1,4 @@
+import { FunctionProvider } from "../provider";
+/** Returns a lazily-initialized singleton {@link FunctionProvider} containing all standard JMESPath built-in functions. */
+export declare function getBuiltinFunctionProvider(): FunctionProvider;
+//# sourceMappingURL=index.d.ts.map

package/dist/functions/builtins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/functions/builtins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAU/C,2HAA2H;AAC3H,wBAAgB,0BAA0B,IAAI,gBAAgB,CAgB7D"}

package/dist/functions/builtins/math.d.ts

@@ -0,0 +1,4 @@
+import { FunctionDefinition } from "../types";
+/** Registers all JMESPath numeric functions. */
+export declare function registerMathFunctions(register: (def: FunctionDefinition) => void): void;
+//# sourceMappingURL=math.d.ts.map

package/dist/functions/builtins/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../../src/functions/builtins/math.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAG9C,gDAAgD;AAChD,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAC1C,IAAI,CA8HN"}

package/dist/functions/builtins/string.d.ts

@@ -0,0 +1,4 @@
+import { FunctionDefinition } from "../types";
+/** Registers all JMESPath string functions. */
+export declare function registerStringFunctions(register: (def: FunctionDefinition) => void): void;
+//# sourceMappingURL=string.d.ts.map

package/dist/functions/builtins/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../../src/functions/builtins/string.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAQ9C,+CAA+C;AAC/C,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAC1C,IAAI,CAwXN"}

package/dist/functions/builtins/type.d.ts

@@ -0,0 +1,4 @@
+import { FunctionDefinition } from "../types";
+/** Registers JMESPath type introspection and type conversion functions. */
+export declare function registerTypeFunctions(register: (def: FunctionDefinition) => void): void;
+//# sourceMappingURL=type.d.ts.map

package/dist/functions/builtins/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../src/functions/builtins/type.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAG9C,2EAA2E;AAC3E,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAC1C,IAAI,CAwDN"}

package/dist/functions/datatype.d.ts

@@ -0,0 +1,90 @@
+import { JsonSelector } from "../ast";
+/** Describes a single scalar type in the function argument type system. */
+export interface PrimitiveType {
+    kind: "any" | "boolean" | "number" | "string" | "object" | "null" | "expref";
+}
+/** String literal union of all primitive type kind discriminators. */
+export type PrimitiveTypeKind = PrimitiveType["kind"];
+/** Matches any value regardless of type. */
+export declare const ANY_TYPE: Readonly<{
+    readonly kind: "any";
+}>;
+/** Matches only `true` or `false` values. */
+export declare const BOOLEAN_TYPE: Readonly<{
+    readonly kind: "boolean";
+}>;
+/** Matches only numeric values (integers and floats). */
+export declare const NUMBER_TYPE: Readonly<{
+    readonly kind: "number";
+}>;
+/** Matches only string values. */
+export declare const STRING_TYPE: Readonly<{
+    readonly kind: "string";
+}>;
+/** Matches only plain objects (not arrays or null). */
+export declare const OBJECT_TYPE: Readonly<{
+    readonly kind: "object";
+}>;
+/** Matches only `null` (or `undefined`, which is treated as null). */
+export declare const NULL_TYPE: Readonly<{
+    readonly kind: "null";
+}>;
+/** Matches only expression references created with `&expr` syntax. */
+export declare const EXPREF_TYPE: Readonly<{
+    readonly kind: "expref";
+}>;
+/** Describes an array type whose elements must all conform to a given {@link DataType}. */
+export interface ArrayType {
+    kind: "array";
+    elementType: DataType;
+}
+/** Creates an {@link ArrayType} requiring all elements to match the given type. */
+export declare function arrayOf(elementType: ConcreteType): ArrayType;
+/** Array type accepting elements of any type. */
+export declare const ANY_ARRAY_TYPE: Readonly<ArrayType>;
+/** Array type accepting only numeric elements. */
+export declare const NUMBER_ARRAY_TYPE: Readonly<ArrayType>;
+/** Array type accepting only string elements. */
+export declare const STRING_ARRAY_TYPE: Readonly<ArrayType>;
+/** A non-union type: either a primitive or an array with typed elements. */
+export type ConcreteType = PrimitiveType | ArrayType;
+/** String literal union of all non-union type kind discriminators. */
+export type ConcreteTypeKind = ConcreteType["kind"];
+/** A type that accepts values matching any one of its constituent concrete types. */
+export interface UnionType {
+    kind: "union";
+    types: ConcreteType[];
+}
+/** Creates a {@link UnionType} that matches values conforming to any of the given types. */
+export declare function unionOf(types: [ConcreteType, ConcreteType, ...ConcreteType[]]): UnionType;
+/** The complete function type system: a concrete type, an array type, or a union of types. */
+export type DataType = ConcreteType | UnionType;
+/** String literal union of all type kind discriminators including `"union"`. */
+export type DataTypeKind = DataType["kind"];
+declare const EXPREF_SYMBOL: unique symbol;
+/**
+ * An unevaluated expression passed to a function via `&expr` syntax.
+ * Higher-order functions like `sort_by` and `map` receive these and
+ * evaluate them against each element using the provided `evaluate` callback.
+ */
+interface ExpressionRef {
+    [EXPREF_SYMBOL]: JsonSelector;
+}
+/** Wraps a selector AST node as an opaque reference for deferred evaluation by higher-order functions. */
+export declare function makeExpressionRef(expression: JsonSelector): ExpressionRef;
+/** Extracts the wrapped {@link JsonSelector} from an expression reference, or returns `null` if the value is not one. */
+export declare function getExpressionRef(arg: unknown): JsonSelector | null;
+/**
+ * Determine the {@link DataTypeKind} of a runtime value.
+ */
+export declare function getDataTypeKind(value: unknown): ConcreteTypeKind;
+/**
+ * Determine the {@link DataType} of a runtime value.
+ */
+export declare function getDataType(value: unknown): ConcreteType;
+/** Tests whether a runtime value conforms to the given {@link DataType}, including recursive element checks for arrays. */
+export declare function matchesType(value: unknown, type: DataType): boolean;
+/** Renders a {@link DataType} as a human-readable string for use in error messages and diagnostics. */
+export declare function formatType(type: DataType): string;
+export {};
+//# sourceMappingURL=datatype.d.ts.map

package/dist/functions/datatype.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datatype.d.ts","sourceRoot":"","sources":["../../src/functions/datatype.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAKtC,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;CAC9E;AAED,sEAAsE;AACtE,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAEtD,4CAA4C;AAC5C,eAAO,MAAM,QAAQ;;EAEc,CAAC;AAEpC,6CAA6C;AAC7C,eAAO,MAAM,YAAY;;EAEU,CAAC;AAEpC,yDAAyD;AACzD,eAAO,MAAM,WAAW;;EAEW,CAAC;AAEpC,kCAAkC;AAClC,eAAO,MAAM,WAAW;;EAEW,CAAC;AAEpC,uDAAuD;AACvD,eAAO,MAAM,WAAW;;EAEW,CAAC;AAEpC,sEAAsE;AACtE,eAAO,MAAM,SAAS;;EAEa,CAAC;AAEpC,sEAAsE;AACtE,eAAO,MAAM,WAAW;;EAEW,CAAC;AAIpC,2FAA2F;AAC3F,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,QAAQ,CAAC;CACvB;AAED,mFAAmF;AACnF,wBAAgB,OAAO,CAAC,WAAW,EAAE,YAAY,GAAG,SAAS,CAE5D;AAED,iDAAiD;AACjD,eAAO,MAAM,cAAc,qBAAmC,CAAC;AAE/D,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,qBAAsC,CAAC;AAErE,iDAAiD;AACjD,eAAO,MAAM,iBAAiB,qBAAsC,CAAC;AAErE,4EAA4E;AAC5E,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,SAAS,CAAC;AAErD,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAIpD,qFAAqF;AACrF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,4FAA4F;AAC5F,wBAAgB,OAAO,CACrB,KAAK,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAAC,GACrD,SAAS,CAEX;AAED,8FAA8F;AAC9F,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;AAEhD,gFAAgF;AAChF,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;AAI5C,QAAA,MAAM,aAAa,eAAmB,CAAC;AAEvC;;;;GAIG;AACH,UAAU,aAAa;IACrB,CAAC,aAAa,CAAC,EAAE,YAAY,CAAC;CAC/B;AAED,0GAA0G;AAC1G,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,YAAY,GAAG,aAAa,CAEzE;AAMD,yHAAyH;AACzH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAElE;AAID;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAsBhE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAsBxD;AAwBD,2HAA2H;AAC3H,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAiBnE;AAED,uGAAuG;AACvG,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAYjD"}

package/dist/functions/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./builtins";
+export * from "./datatype";
+export { FunctionProvider } from "./provider";
+export * from "./registry";
+export * from "./types";
+export * from "./validation";
+//# sourceMappingURL=index.d.ts.map

package/dist/functions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/functions/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC"}

package/dist/functions/provider.d.ts

@@ -0,0 +1,6 @@
+import { FunctionCallArgs, FunctionDefinition } from "./types";
+/** Immutable lookup table mapping function names to their {@link FunctionDefinition}s. */
+export type FunctionProvider = ReadonlyMap<string, FunctionDefinition>;
+/** Resolves expression-ref arguments, validates argument types against the function's signatures, and invokes the handler. */
+export declare function callFunction(provider: FunctionProvider, name: string, request: FunctionCallArgs): unknown;
+//# sourceMappingURL=provider.d.ts.map

package/dist/functions/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/functions/provider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAe,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAG5E,0FAA0F;AAC1F,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAEvE,8HAA8H;AAC9H,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAkBT"}

package/dist/functions/registry.d.ts

@@ -0,0 +1,20 @@
+import { FallbackMapView } from "./FallbackMapView";
+import { FunctionProvider } from "./provider";
+import { FunctionDefinition } from "./types";
+/**
+ * Function registry for built-in and custom functions.
+ * Pass `null` as the base provider to omit built-in functions.
+ */
+export declare class FunctionRegistry extends FallbackMapView<string, FunctionDefinition> {
+    private readonly custom;
+    constructor(baseProvider?: FunctionProvider | null);
+    /**
+     * Register a custom function (can override built-ins).
+     */
+    register(def: FunctionDefinition): void;
+    /**
+     * Unregister a custom function.
+     */
+    unregister(name: string): boolean;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/functions/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/functions/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,eAAe,CACnD,MAAM,EACN,kBAAkB,CACnB;IACC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;gBAGvD,YAAY,GAAE,gBAAgB,GAAG,IAAmC;IAOtE;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI;IAIvC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAGlC"}

package/dist/functions/types.d.ts

@@ -0,0 +1,68 @@
+import { JsonSelector } from "../ast";
+import type { EvaluationContext } from "../evaluation-context";
+import { NonEmptyArray } from "../util";
+import { DataType } from "./datatype";
+/**
+ * Common evaluation context shared by function call and handler bindings.
+ */
+export interface EvaluationBindings extends EvaluationContext {
+    /** The current evaluation context (`@`). */
+    context: unknown;
+    /** Callback to evaluate a {@link JsonSelector} against a given context. */
+    evaluate: (selector: JsonSelector, ctx: unknown) => unknown;
+}
+/**
+ * Bindings passed to `callFunction` to invoke a function.
+ */
+export interface FunctionCallArgs extends EvaluationBindings {
+    /** Unevaluated expression arguments from the AST. */
+    args: JsonSelector[];
+}
+/**
+ * A resolved function argument: any JSON value or an {@link ExpressionRef}.
+ */
+export type FunctionArg = unknown;
+/**
+ * Bindings passed to a {@link FunctionHandler} when it is called.
+ */
+export interface FunctionCallBindings extends EvaluationBindings {
+    /** Validated arguments (already checked against the matching signature). */
+    args: FunctionArg[];
+}
+/**
+ * Describes a single function parameter: which types it accepts and whether it is optional.
+ */
+export interface ArgumentSignature {
+    /** Name of this parameter for error messages. */
+    name: string;
+    /** Type accepted at this parameter position. */
+    type: DataType;
+    /** If true, the caller may omit this argument. Optional parameters must be trailing. */
+    optional?: boolean;
+    /**
+     * If true, this parameter accepts any number of additional arguments of the same type.
+     * Must only appear on the last parameter in a signature.
+     * When combined with `optional`, zero variadic arguments are accepted;
+     * otherwise at least one argument at this position is required.
+     */
+    variadic?: boolean;
+}
+/**
+ * Implementation of a built-in or custom function.
+ */
+export type FunctionHandler = (bindings: FunctionCallBindings) => unknown;
+/**
+ * A registered function: its name, accepted signatures (overloads), and implementation.
+ */
+export interface FunctionDefinition {
+    /** Function name as it appears in expressions (e.g. `"length"`). */
+    name: string;
+    /**
+     * One or more overloaded signatures. Each inner array is a complete parameter list;
+     * validation succeeds if the arguments match any one of them.
+     */
+    signatures: NonEmptyArray<ArgumentSignature[]>;
+    /** Implementation called after argument validation succeeds. */
+    handler: FunctionHandler;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/functions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/functions/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,qDAAqD;IACrD,IAAI,EAAE,YAAY,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,4EAA4E;IAC5E,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,IAAI,EAAE,QAAQ,CAAC;IACf,wFAAwF;IACxF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,oBAAoB,KAAK,OAAO,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,UAAU,EAAE,aAAa,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAC/C,gEAAgE;IAChE,OAAO,EAAE,eAAe,CAAC;CAC1B"}

package/dist/functions/validation.d.ts

@@ -0,0 +1,30 @@
+import { NonEmptyArray } from "../util";
+import { DataType } from "./datatype";
+import { ArgumentSignature, FunctionArg } from "./types";
+/**
+ * Validate function arguments against a list of possible signatures.
+ * Returns the index of the matching signature, or throws an error.
+ */
+export declare function validateArguments(name: string, args: FunctionArg[], signatures: NonEmptyArray<ArgumentSignature[]>): void;
+/**
+ * Validate that a number is an integer.
+ */
+export declare function requireInteger(functionName: string, argumentName: string, value: number): number;
+/**
+ * Validate that a number is a non-negative integer.
+ */
+export declare function requireNonNegativeInteger(functionName: string, argumentName: string, value: number): number;
+/**
+ * Helper to create a required argument signature.
+ */
+export declare function arg(name: string, type: DataType): ArgumentSignature;
+/**
+ * Helper to create an optional argument signature.
+ */
+export declare function optArg(name: string, type: DataType): ArgumentSignature;
+/**
+ * Helper to create a variadic argument signature.
+ * Must be the last parameter in a signature. Accepts one or more arguments of the given type.
+ */
+export declare function varArg(name: string, type: DataType): ArgumentSignature;
+//# sourceMappingURL=validation.d.ts.map

package/dist/functions/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/functions/validation.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAwC,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,WAAW,EAAE,EACnB,UAAU,EAAE,aAAa,CAAC,iBAAiB,EAAE,CAAC,GAC7C,IAAI,CAaN;AAyID;;GAEG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GACZ,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GACZ,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,iBAAiB,CAEnE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,iBAAiB,CAEtE;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,iBAAiB,CAEtE"}

package/dist/get.d.ts

@@ -1,3 +1,5 @@
+import { type AccessorOptions } from "./access";
 import { JsonSelector } from "./ast";
-export declare function getWithJsonSelector(selector: JsonSelector, context: unknown): unknown;
+/** Evaluates a selector against a context and returns the selected value (read-only convenience wrapper). */
+export declare function getWithJsonSelector(selector: JsonSelector, context: unknown, options?: Partial<AccessorOptions>): unknown;
 //# sourceMappingURL=get.d.ts.map

package/dist/get.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../src/get.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAErC,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,OAAO,GACf,OAAO,CAET"}
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../src/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAGrC,6GAA6G;AAC7G,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GACjC,OAAO,CAET"}

package/dist/index.d.ts

@@ -1,8 +1,13 @@
 export * from "./access";
 export * from "./ast";
+export * from "./bind";
+export * from "./errors";
+export * from "./evaluation-context";
 export { evaluateJsonSelector } from "./evaluate";
 export * from "./format";
+export * from "./functions";
 export * from "./get";
 export * from "./parse";
+export type { ParserOptions } from "./parser";
 export * from "./set";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AAErC,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,cAAc,OAAO,CAAC"}