@jbrowse/jexl 2.3.1 → 3.0.1

package/CHANGELOG.md

@@ -6,6 +6,33 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 Nothing yet!
 
+## [v3.0.0]
+
+### BREAKING CHANGES
+
+- **Removed async evaluation support**: Jexl now only supports synchronous evaluation
+- **Renamed methods**: `evalSync()` has been renamed to `eval()`. The async `eval()` method has been removed.
+- **Removed PromiseSync class**: Internal implementation detail removed
+- **Removed transforms**: The transform/pipe operator (`|`) has been completely removed. Use functions instead.
+- **Removed array filtering**: Relative filter expressions (e.g., `array[.property == value]`) have been removed. Bracket notation for array/object access (e.g., `array[0]`, `object["key"]`) still works.
+- **Removed transform methods**: `addTransform()`, `addTransforms()`, and `getTransform()` have been removed.
+
+### Changed
+
+- Simplified codebase by removing Promise/PromiseSync abstraction layer
+- All evaluation is now synchronous, improving performance and simplifying error handling
+- Errors are now thrown directly rather than being rejected Promises
+- Removed pipe operator (`|`) from grammar
+- Removed filter bracket syntax for relative filtering
+
+### Migration Guide
+
+- Replace `await jexl.eval(expr)` with `jexl.eval(expr)` (remove await)
+- Replace `jexl.evalSync(expr)` with `jexl.eval(expr)` (remove Sync suffix)
+- Replace transforms with functions: change `value|transform(arg)` to `transform(value, arg)`
+- Remove uses of relative filtering syntax `array[.prop == value]` (note: direct indexing like `array[0]` still works)
+- Replace `.catch()` error handling with `try/catch` blocks
+
 ## [v2.3.0]
 
 ### Added

package/LICENSE.txt

@@ -1,3 +1,4 @@
+Copyright (c) 2025 Colin Diesh
 Copyright (c) 2020 Tom Shawver
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

package/README.md

@@ -2,6 +2,16 @@
 
 A fork of the jexl lang for jbrowse
 
+## What's New in v3.0
+
+Version 3.0 is a major simplification of Jexl with breaking changes:
+
+- **Synchronous only** - All evaluation is synchronous. No async/await needed.
+- **No transforms** - The pipe operator (`|`) has been removed. Use functions instead.
+- **No filter expressions** - Relative filter syntax like `array[.property == value]` has been removed. Regular bracket notation for indexing (`array[0]`, `object["key"]`) still works.
+
+See [CHANGELOG.md](CHANGELOG.md) for migration guide.
+
 ## Quick Examples
 
 ```javascript
@@ -16,30 +26,26 @@ const context = {
 }
 
 // Template strings with interpolation
-jexl.evalSync('`Hello ${name.first} ${name.last}`', context)
+jexl.eval('`Hello ${name.first} ${name.last}`', context)
 // "Hello Sterling Archer"
 
-jexl.evalSync('`Age in 5 years: ${age + 5}`', context)
+jexl.eval('`Age in 5 years: ${age + 5}`', context)
 // "Age in 5 years: 41"
 
-// Filter arrays
-jexl.evalSync('assoc[.first == "Lana"].last', context)
-// "Kane"
-
 // Math operations
-jexl.evalSync('age * (3 - 1)', context)
+jexl.eval('age * (3 - 1)', context)
 // 72
 
 // String concatenation
-jexl.evalSync('name.first + " " + name.last', context)
+jexl.eval('name.first + " " + name.last', context)
 // "Sterling Archer"
 
 // Conditional logic
-jexl.evalSync('age > 62 ? "retired" : "working"', context)
+jexl.eval('age > 62 ? "retired" : "working"', context)
 // "working"
 
 // Array indexes
-jexl.evalSync('assoc[1].first', context)
+jexl.eval('assoc[1].first', context)
 // "Cyril"
 ```
 
@@ -63,17 +69,17 @@ Template strings use backticks and support expression interpolation with `${}`:
 ```javascript
 const context = { name: 'World', price: 10, qty: 3 }
 
-jexl.evalSync('`Hello ${name}!`', context)
+jexl.eval('`Hello ${name}!`', context)
 // "Hello World!"
 
-jexl.evalSync('`Total: $${price * qty}`', context)
+jexl.eval('`Total: $${price * qty}`', context)
 // "Total: $30"
 
 // Escape backticks and dollar signs with backslash
-jexl.evalSync('`Code: \\`example\\``')
+jexl.eval('`Code: \\`example\\``')
 // "Code: `example`"
 
-jexl.evalSync('`Price: \\$100`')
+jexl.eval('`Price: \\$100`')
 // "Price: $100"
 ```
 
@@ -103,49 +109,10 @@ const context = {
   lastEx: 2
 }
 
-jexl.evalSync('name.first', context) // "Malory"
-jexl.evalSync('name["last"]', context) // "Archer"
-jexl.evalSync('exes[2]', context) // "Burt"
-jexl.evalSync('exes[lastEx - 1]', context) // "Len"
-```
-
-### Filtering Collections
-
-Filter arrays using expressions in brackets. Reference properties with a leading dot:
-
-```javascript
-const context = {
-  employees: [
-    { first: 'Sterling', last: 'Archer', age: 36 },
-    { first: 'Malory', last: 'Archer', age: 75 },
-    { first: 'Lana', last: 'Kane', age: 33 },
-    { first: 'Cyril', last: 'Figgis', age: 45 }
-  ]
-}
-
-jexl.evalSync('employees[.first == "Sterling"]', context)
-// [{ first: 'Sterling', last: 'Archer', age: 36 }]
-
-jexl.evalSync('employees[.age >= 30 && .age < 40]', context)
-// [{ first: 'Sterling', ... }, { first: 'Lana', ... }]
-
-jexl.evalSync('employees[.last == "Kane"].first', context)
-// "Lana"
-```
-
-### Transforms
-
-Apply transforms to values using the pipe operator:
-
-```javascript
-jexl.addTransform('upper', (val) => val.toUpperCase())
-jexl.addTransform('split', (val, char) => val.split(char))
-
-jexl.evalSync('"hello"|upper')
-// "HELLO"
-
-jexl.evalSync('"firstName lastName"|split(" ")[0]')
-// "firstName"
+jexl.eval('name.first', context) // "Malory"
+jexl.eval('name["last"]', context) // "Archer"
+jexl.eval('exes[2]', context) // "Burt"
+jexl.eval('exes[lastEx - 1]', context) // "Len"
 ```
 
 ### Functions
@@ -156,10 +123,10 @@ Call functions in expressions:
 jexl.addFunction('min', Math.min)
 jexl.addFunction('max', Math.max)
 
-jexl.evalSync('min(5, 2, 9)')
+jexl.eval('min(5, 2, 9)')
 // 2
 
-jexl.evalSync('max(temperature, threshold)')
+jexl.eval('max(temperature, threshold)')
 // evaluates with context
 ```
 
@@ -168,10 +135,10 @@ jexl.evalSync('max(temperature, threshold)')
 Separate multiple expressions with semicolons. The result is the value of the last expression:
 
 ```javascript
-jexl.evalSync('5; 10; 15')
+jexl.eval('5; 10; 15')
 // 15
 
-jexl.evalSync('1 + 1; 2 + 2; 3 + 3')
+jexl.eval('1 + 1; 2 + 2; 3 + 3')
 // 6
 ```
 
@@ -180,37 +147,72 @@ jexl.evalSync('1 + 1; 2 + 2; 3 + 3')
 Assign values to variables using `=` (no `let`, `var`, or `const` needed). Assignments mutate the context and return the assigned value:
 
 ```javascript
-jexl.evalSync('x = 5')
+jexl.eval('x = 5')
 // 5
 
-jexl.evalSync('x = 5; x * 2')
+jexl.eval('x = 5; x * 2')
 // 10
 
-jexl.evalSync('x = 5; y = 10; x + y')
+jexl.eval('x = 5; y = 10; x + y')
 // 15
 
 const context = {}
-jexl.evalSync('x = 5; y = x * 2; y', context)
+jexl.eval('x = 5; y = x * 2; y', context)
 // 10
 // context is now { x: 5, y: 10 }
 ```
 
-## Usage
+## API
 
-```javascript
-import jexl from 'jexl'
+### Evaluation
 
-// Synchronous evaluation
-const result = jexl.evalSync('expression', context)
+```javascript
+import jexl from '@jbrowse/jexl'
 
-// Asynchronous evaluation (supports async transforms/functions)
-const result = await jexl.eval('expression', context)
+// Evaluate an expression
+const result = jexl.eval('expression', context)
 
 // Compile once, evaluate many times
 const expr = jexl.compile('name.first + " " + name.last')
-expr.evalSync({ name: { first: 'John', last: 'Doe' } })
+const result = expr.eval({ name: { first: 'John', last: 'Doe' } })
+```
+
+### Adding Custom Functions
+
+```javascript
+// Add a single function
+jexl.addFunction('round', Math.round)
+jexl.addFunction('lower', (str) => str.toLowerCase())
+
+// Add multiple functions
+jexl.addFunctions({
+  min: Math.min,
+  max: Math.max,
+  abs: Math.abs
+})
+
+// Use in expressions
+jexl.eval('round(3.7)') // 4
+jexl.eval('lower(name)', { name: 'HELLO' }) // "hello"
+jexl.eval('max(1, 5, 3)') // 5
+```
+
+### Adding Custom Operators
+
+```javascript
+// Add a binary operator
+jexl.addBinaryOp('~=', 20, (left, right) =>
+  left.toLowerCase() === right.toLowerCase()
+)
+
+jexl.eval('"Hello" ~= "hello"') // true
+
+// Add a unary operator
+jexl.addUnaryOp('~', (right) => Math.floor(right))
+
+jexl.eval('~3.7') // 3
 ```
 
 ## License
 
-MIT License - see LICENSE.txt for details
+MIT License, same as TomFrost/Jexl

package/dist/Expression.d.ts

@@ -1,10 +1,8 @@
-import PromiseSync from './PromiseSync.ts';
 import type { AstNode } from './types.ts';
 interface Grammar {
     elements: Record<string, any>;
     [key: string]: any;
 }
-type PromiseConstructor = typeof Promise | typeof PromiseSync;
 declare class Expression {
     _grammar: Grammar;
     _exprStr: string;
@@ -18,21 +16,13 @@ declare class Expression {
      */
     compile(): this;
     /**
-     * Asynchronously evaluates the expression within an optional context.
-     * @param {Object} [context] A mapping of variables to values, which will be
-     *      made accessible to the Jexl expression when evaluating it
-     * @returns {Promise<*>} resolves with the result of the evaluation.
-     */
-    eval(context?: {}): Promise<any> | PromiseSync<any>;
-    /**
-     * Synchronously evaluates the expression within an optional context.
+     * Evaluates the expression within an optional context.
      * @param {Object} [context] A mapping of variables to values, which will be
      *      made accessible to the Jexl expression when evaluating it
      * @returns {*} the result of the evaluation.
      * @throws {*} on error
      */
-    evalSync(context?: {}): unknown;
-    _eval(context: any, promise: PromiseConstructor): Promise<any> | PromiseSync<any>;
+    eval(context?: {}): any;
     _getAst(): AstNode | null;
 }
 export default Expression;

package/dist/Expression.js

@@ -8,7 +8,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const Lexer_ts_1 = __importDefault(require("./Lexer.js"));
-const PromiseSync_ts_1 = __importDefault(require("./PromiseSync.js"));
 const Evaluator_ts_1 = __importDefault(require("./evaluator/Evaluator.js"));
 const Parser_ts_1 = __importDefault(require("./parser/Parser.js"));
 class Expression {
@@ -32,37 +31,16 @@ class Expression {
         return this;
     }
     /**
-     * Asynchronously evaluates the expression within an optional context.
-     * @param {Object} [context] A mapping of variables to values, which will be
-     *      made accessible to the Jexl expression when evaluating it
-     * @returns {Promise<*>} resolves with the result of the evaluation.
-     */
-    eval(context = {}) {
-        return this._eval(context, Promise);
-    }
-    /**
-     * Synchronously evaluates the expression within an optional context.
+     * Evaluates the expression within an optional context.
      * @param {Object} [context] A mapping of variables to values, which will be
      *      made accessible to the Jexl expression when evaluating it
      * @returns {*} the result of the evaluation.
      * @throws {*} on error
      */
-    evalSync(context = {}) {
-        const res = this._eval(context, PromiseSync_ts_1.default);
-        if (res.error) {
-            if (res.error instanceof Error) {
-                throw res.error;
-            }
-            throw new Error(typeof res.error === 'string' ? res.error : JSON.stringify(res.error));
-        }
-        return res.value;
-    }
-    _eval(context, promise) {
-        return promise.resolve().then(() => {
-            const ast = this._getAst();
-            const evaluator = new Evaluator_ts_1.default(this._grammar, context, undefined, promise);
-            return evaluator.eval(ast);
-        });
+    eval(context = {}) {
+        const ast = this._getAst();
+        const evaluator = new Evaluator_ts_1.default(this._grammar, context);
+        return evaluator.eval(ast);
     }
     _getAst() {
         if (!this._ast) {

package/dist/Expression.js.map

@@ -1 +1 @@
-{"version":3,"file":"Expression.js","sourceRoot":"","sources":["../src/Expression.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAEH,0DAA8B;AAC9B,sEAA0C;AAC1C,4EAAgD;AAChD,mEAAuC;AAWvC,MAAM,UAAU;IAKd,YAAY,OAAgB,EAAE,OAAe;QAC3C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAA;QACvB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAED;;;;;OAKG;IACH,OAAO;QACL,MAAM,KAAK,GAAG,IAAI,kBAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACtC,MAAM,MAAM,GAAG,IAAI,mBAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAC/C,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC5C,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QACxB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;QAC7B,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,OAAO,GAAG,EAAE;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACrC,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,GAAG,EAAE;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,wBAAkB,CAAgB,CAAA;QAClE,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YACd,IAAI,GAAG,CAAC,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC/B,MAAM,GAAG,CAAC,KAAK,CAAA;YACjB,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAA;QACxF,CAAC;QACD,OAAO,GAAG,CAAC,KAAK,CAAA;IAClB,CAAC;IAED,KAAK,CAAC,OAAY,EAAE,OAA2B;QAC7C,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;YACjC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;YAC1B,MAAM,SAAS,GAAG,IAAI,sBAAS,CAC7B,IAAI,CAAC,QAAQ,EACb,OAAO,EACP,SAAS,EACT,OAAO,CACR,CAAA;YACD,OAAO,SAAS,CAAC,IAAI,CAAC,GAAI,CAAC,CAAA;QAC7B,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,EAAE,CAAA;QAChB,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;CACF;AAED,kBAAe,UAAU,CAAA"}
+{"version":3,"file":"Expression.js","sourceRoot":"","sources":["../src/Expression.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAEH,0DAA8B;AAC9B,4EAAgD;AAChD,mEAAuC;AASvC,MAAM,UAAU;IAKd,YAAY,OAAgB,EAAE,OAAe;QAC3C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAA;QACvB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAED;;;;;OAKG;IACH,OAAO;QACL,MAAM,KAAK,GAAG,IAAI,kBAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACtC,MAAM,MAAM,GAAG,IAAI,mBAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAC/C,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC5C,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QACxB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;QAC7B,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,GAAG,EAAE;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;QAC1B,MAAM,SAAS,GAAG,IAAI,sBAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QACvD,OAAO,SAAS,CAAC,IAAI,CAAC,GAAI,CAAC,CAAA;IAC7B,CAAC;IAED,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,EAAE,CAAA;QAChB,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;CACF;AAED,kBAAe,UAAU,CAAA"}

package/dist/Jexl.d.ts

@@ -2,7 +2,6 @@ import Expression from './Expression.ts';
 interface Grammar {
     elements: Record<string, any>;
     functions: Record<string, (...args: any[]) => any>;
-    transforms: Record<string, (val: any, ...args: any[]) => any>;
 }
 /**
  * Jexl is the Javascript Expression Language, capable of parsing and
@@ -26,13 +25,11 @@ declare class Jexl {
      * @param {number} precedence The operator's precedence
      * @param {function} fn A function to run to calculate the result. The function
      *      will be called with two arguments: left and right, denoting the values
-     *      on either side of the operator. It should return either the resulting
-     *      value, or a Promise that resolves with the resulting value.
+     *      on either side of the operator. It should return the resulting value.
      * @param {boolean} [manualEval] If true, the `left` and `right` arguments
      *      will be wrapped in objects with an `eval` function. Calling
-     *      left.eval() or right.eval() will return a promise that resolves to
-     *      that operand's actual value. This is useful to conditionally evaluate
-     *      operands.
+     *      left.eval() or right.eval() will return that operand's actual value.
+     *      This is useful to conditionally evaluate operands.
      */
     addBinaryOp(operator: string, precedence: number, fn: (left: any, right: any) => any, manualEval?: boolean): void;
     /**
@@ -57,26 +54,9 @@ declare class Jexl {
      * @param {string} operator The operator string to be added
      * @param {function} fn A function to run to calculate the result. The function
      *      will be called with one argument: the literal value to the right of the
-     *      operator. It should return either the resulting value, or a Promise
-     *      that resolves with the resulting value.
+     *      operator. It should return the resulting value.
      */
     addUnaryOp(operator: string, fn: (right: any) => any): void;
-    /**
-     * Adds or replaces a transform function in this Jexl instance.
-     * @param {string} name The name of the transform function, as it will be used
-     *      within Jexl expressions
-     * @param {function} fn The function to be executed when this transform is
-     *      invoked. It will be provided with at least one argument:
-     *          - {*} value: The value to be transformed
-     *          - {...*} args: The arguments for this transform
-     */
-    addTransform(name: string, fn: (val: any, ...args: any[]) => any): void;
-    /**
-     * Syntactic sugar for calling {@link #addTransform} repeatedly.  This function
-     * accepts a map of one or more transform names to their transform function.
-     * @param {{}} map A map of transform names to transform functions
-     */
-    addTransforms(map: Record<string, (val: any, ...args: any[]) => any>): void;
     /**
      * Creates an Expression object from the given Jexl expression string, and
      * immediately compiles it. The returned Expression object can then be
@@ -100,28 +80,14 @@ declare class Jexl {
      */
     getFunction(name: string): (...args: any[]) => any;
     /**
-     * Retrieves a previously set transform function.
-     * @param {string} name The name of the transform function
-     * @returns {function} The transform function
-     */
-    getTransform(name: string): (val: any, ...args: any[]) => any;
-    /**
-     * Asynchronously evaluates a Jexl string within an optional context.
-     * @param {string} expression The Jexl expression to be evaluated
-     * @param {Object} [context] A mapping of variables to values, which will be
-     *      made accessible to the Jexl expression when evaluating it
-     * @returns {Promise<*>} resolves with the result of the evaluation.
-     */
-    eval(expression: string, context?: {}): Promise<any> | import("./PromiseSync.ts").default<any>;
-    /**
-     * Synchronously evaluates a Jexl string within an optional context.
+     * Evaluates a Jexl string within an optional context.
      * @param {string} expression The Jexl expression to be evaluated
      * @param {Object} [context] A mapping of variables to values, which will be
      *      made accessible to the Jexl expression when evaluating it
      * @returns {*} the result of the evaluation.
      * @throws {*} on error
      */
-    evalSync(expression: string, context?: {}): unknown;
+    eval(expression: string, context?: {}): any;
     /**
      * A JavaScript template literal to allow expressions to be defined by the
      * syntax: expr`40 + 2`

package/dist/Jexl.js

@@ -34,13 +34,11 @@ class Jexl {
      * @param {number} precedence The operator's precedence
      * @param {function} fn A function to run to calculate the result. The function
      *      will be called with two arguments: left and right, denoting the values
-     *      on either side of the operator. It should return either the resulting
-     *      value, or a Promise that resolves with the resulting value.
+     *      on either side of the operator. It should return the resulting value.
      * @param {boolean} [manualEval] If true, the `left` and `right` arguments
      *      will be wrapped in objects with an `eval` function. Calling
-     *      left.eval() or right.eval() will return a promise that resolves to
-     *      that operand's actual value. This is useful to conditionally evaluate
-     *      operands.
+     *      left.eval() or right.eval() will return that operand's actual value.
+     *      This is useful to conditionally evaluate operands.
      */
     addBinaryOp(operator, precedence, fn, manualEval) {
         this._addGrammarElement(operator, {
@@ -75,8 +73,7 @@ class Jexl {
      * @param {string} operator The operator string to be added
      * @param {function} fn A function to run to calculate the result. The function
      *      will be called with one argument: the literal value to the right of the
-     *      operator. It should return either the resulting value, or a Promise
-     *      that resolves with the resulting value.
+     *      operator. It should return the resulting value.
      */
     addUnaryOp(operator, fn) {
         this._addGrammarElement(operator, {
@@ -85,26 +82,6 @@ class Jexl {
             eval: fn
         });
     }
-    /**
-     * Adds or replaces a transform function in this Jexl instance.
-     * @param {string} name The name of the transform function, as it will be used
-     *      within Jexl expressions
-     * @param {function} fn The function to be executed when this transform is
-     *      invoked. It will be provided with at least one argument:
-     *          - {*} value: The value to be transformed
-     *          - {...*} args: The arguments for this transform
-     */
-    addTransform(name, fn) {
-        this._grammar.transforms[name] = fn;
-    }
-    /**
-     * Syntactic sugar for calling {@link #addTransform} repeatedly.  This function
-     * accepts a map of one or more transform names to their transform function.
-     * @param {{}} map A map of transform names to transform functions
-     */
-    addTransforms(map) {
-        Object.assign(this._grammar.transforms, map);
-    }
     /**
      * Creates an Expression object from the given Jexl expression string, and
      * immediately compiles it. The returned Expression object can then be
@@ -135,35 +112,16 @@ class Jexl {
         return this._grammar.functions[name];
     }
     /**
-     * Retrieves a previously set transform function.
-     * @param {string} name The name of the transform function
-     * @returns {function} The transform function
-     */
-    getTransform(name) {
-        return this._grammar.transforms[name];
-    }
-    /**
-     * Asynchronously evaluates a Jexl string within an optional context.
-     * @param {string} expression The Jexl expression to be evaluated
-     * @param {Object} [context] A mapping of variables to values, which will be
-     *      made accessible to the Jexl expression when evaluating it
-     * @returns {Promise<*>} resolves with the result of the evaluation.
-     */
-    eval(expression, context = {}) {
-        const exprObj = this.createExpression(expression);
-        return exprObj.eval(context);
-    }
-    /**
-     * Synchronously evaluates a Jexl string within an optional context.
+     * Evaluates a Jexl string within an optional context.
      * @param {string} expression The Jexl expression to be evaluated
      * @param {Object} [context] A mapping of variables to values, which will be
      *      made accessible to the Jexl expression when evaluating it
      * @returns {*} the result of the evaluation.
      * @throws {*} on error
      */
-    evalSync(expression, context = {}) {
+    eval(expression, context = {}) {
         const exprObj = this.createExpression(expression);
-        return exprObj.evalSync(context);
+        return exprObj.eval(context);
     }
     /**
      * A JavaScript template literal to allow expressions to be defined by the

package/dist/Jexl.js.map

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

package/dist/evaluator/Evaluator.d.ts

@@ -3,7 +3,6 @@ interface Grammar {
     elements: Record<string, any>;
     [key: string]: any;
 }
-type PromiseConstructor = typeof Promise | any;
 /**
  * The Evaluator takes a Jexl expression tree as generated by the
  * {@link Parser} and calculates its value within a given context. The
@@ -15,78 +14,38 @@ type PromiseConstructor = typeof Promise | any;
  * @param {{}} grammar A grammar object against which to evaluate the expression
  *      tree
  * @param {{}} [context] A map of variable keys to their values. This will be
- *      accessed to resolve the value of each non-relative identifier. Any
- *      Promise values will be passed to the expression as their resolved
- *      value.
+ *      accessed to resolve the value of each non-relative identifier.
  * @param {{}|Array<{}|Array>} [relativeContext] A map or array to be accessed
  *      to resolve the value of a relative identifier.
- * @param {function} promise A constructor for the Promise class to be used;
- *      probably either Promise or PromiseSync.
  */
 declare class Evaluator {
     _grammar: Grammar;
     _context: any;
     _relContext: any;
-    Promise: PromiseConstructor;
-    constructor(grammar: Grammar, context?: any, relativeContext?: any, promise?: PromiseConstructor);
+    constructor(grammar: Grammar, context?: any, relativeContext?: any);
     /**
      * Evaluates an expression tree within the configured context.
      * @param {{}} ast An expression tree object
-     * @returns {Promise<*>} resolves with the resulting value of the expression.
+     * @returns {*} the resulting value of the expression.
      */
     eval(ast: AstNode): any;
     /**
-     * Simultaneously evaluates each expression within an array, and delivers the
-     * response as an array with the resulting values at the same indexes as their
-     * originating expressions.
+     * Evaluates each expression within an array, and delivers the response as an
+     * array with the resulting values at the same indexes as their originating
+     * expressions.
      * @param {Array<string>} arr An array of expression strings to be evaluated
-     * @returns {Promise<Array<{}>>} resolves with the result array
+     * @returns {Array<{}>} the result array
      */
-    evalArray(arr: AstNode[]): any;
+    evalArray(arr: AstNode[]): any[];
     /**
-     * Simultaneously evaluates each expression within a map, and delivers the
-     * response as a map with the same keys, but with the evaluated result for each
-     * as their value.
+     * Evaluates each expression within a map, and delivers the response as a map
+     * with the same keys, but with the evaluated result for each as their value.
      * @param {{}} map A map of expression names to expression trees to be
      *      evaluated
-     * @returns {Promise<{}>} resolves with the result map.
+     * @returns {{}} the result map.
      */
-    evalMap(map: Record<string, AstNode>): any;
-    /**
-     * Applies a filter expression with relative identifier elements to a subject.
-     * The intent is for the subject to be an array of subjects that will be
-     * individually used as the relative context against the provided expression
-     * tree. Only the elements whose expressions result in a truthy value will be
-     * included in the resulting array.
-     *
-     * If the subject is not an array of values, it will be converted to a single-
-     * element array before running the filter.
-     * @param {*} subject The value to be filtered usually an array. If this value is
-     *      not an array, it will be converted to an array with this value as the
-     *      only element.
-     * @param {{}} expr The expression tree to run against each subject. If the
-     *      tree evaluates to a truthy result, then the value will be included in
-     *      the returned array otherwise, it will be eliminated.
-     * @returns {Promise<Array>} resolves with an array of values that passed the
-     *      expression filter.
-     * @private
-     */
-    _filterRelative(subject: any, expr: AstNode): any;
-    /**
-     * Applies a static filter expression to a subject value.  If the filter
-     * expression evaluates to boolean true, the subject is returned if false,
-     * undefined.
-     *
-     * For any other resulting value of the expression, this function will attempt
-     * to respond with the property at that name or index of the subject.
-     * @param {*} subject The value to be filtered.  Usually an Array (for which
-     *      the expression would generally resolve to a numeric index) or an
-     *      Object (for which the expression would generally resolve to a string
-     *      indicating a property name)
-     * @param {{}} expr The expression tree to run against the subject
-     * @returns {Promise<*>} resolves with the value of the drill-down.
-     * @private
-     */
-    _filterStatic(subject: any, expr: AstNode): any;
+    evalMap(map: Record<string, AstNode>): {
+        [k: string]: any;
+    };
 }
 export default Evaluator;