@briza/illogical 1.7.1 → 1.7.3

package/types/common/evaluable.d.ts

@@ -35,13 +35,15 @@ export interface Evaluable {
      * Simplifies this Evaluable when possible.
      *
      * @param {Context} ctx context for the evaluation
-     * @param {string[]} strictKeys keys to be considered present even if they are not present in the context
-     * @param {string[]} optionalKeys keys to be considered not present unless they are in the context or in
+     * @param {string[] | Set<string>} strictKeys keys to be considered present even if they are not present in the
+     *  context. Passing as a Set is recommended for performance reasons.
+     * @param {string[] | Set<string>} optionalKeys keys to be considered not present unless they are in the context or in
      *  `strictKeys`; when `strictKeys` is `undefined` and `optionalKeys` is an array, every key that is not in
-     *  `optionalKeys` is considered to be present and thus will be evaluated
+     *  `optionalKeys` is considered to be present and thus will be evaluated. Passing as a Set is recommended for
+     *  performance reasons.
      * @returns {Result | Evaluable} simplified value or itself
      */
-    simplify(ctx: Context, strictKeys?: string[], optionalKeys?: string[]): Result | Evaluable;
+    simplify(ctx: Context, strictKeys?: string[] | Set<string>, optionalKeys?: string[] | Set<string>): Result | Evaluable;
     /**
      * Serializes the Evaluable to its input format.
      *

package/types/expression/logical/index.d.ts

@@ -22,7 +22,7 @@ export declare abstract class Logical implements Evaluable {
     /**
      * {@link Evaluable.simplify}
      */
-    abstract simplify(ctx: Context, strictKeys?: string[], optionalKeys?: string[]): Result | Evaluable;
+    abstract simplify(ctx: Context, strictKeys?: string[] | Set<string>, optionalKeys?: string[] | Set<string>): Result | Evaluable;
     /**
      * Get the strict representation of the expression.
      * @return {string}

package/types/index.d.ts

@@ -68,13 +68,14 @@ declare class Engine {
      *
      * @param {ExpressionInput} exp  Raw expression.
      * @param {Context} context Evaluation data context.
-     * @param {string[]} strictKeys keys to be considered present even if they are not present in the context
-     * @param {string[]} optionalKeys keys to be considered not present unless they are in the context or in
+     * @param {string[] | Set<string>} strictKeys keys to be considered present even if they are not present in the
+     *  context. Passing as a Set is recommended for performance reasons.
+     * @param {string[] | Set<string>} optionalKeys keys to be considered not present unless they are in the context or in
      *  `strictKeys`; when `strictKeys` is `undefined` and `optionalKeys` is an array, every key that is not in
-     *  `optionalKeys` is considered to be present and thus will be evaluated
+     *  `optionalKeys` is considered to be present and thus will be evaluated. Passing as a Set is recommended for
+     *  performance reasons.
      * @returns {Inpunt | boolean}
      */
-    simplify(exp: ExpressionInput, context: Context, strictKeys?: string[], optionalKeys?: string[]): Input | boolean;
-    unsafeSimplify(exp: ExpressionInput, context: Context, strictKeys?: string[], optionalKeys?: string[]): Input | boolean;
+    simplify(exp: ExpressionInput, context: Context, strictKeys?: string[] | Set<string>, optionalKeys?: string[] | Set<string>): Input | boolean;
 }
 export default Engine;

package/types/operand/index.d.ts

@@ -13,7 +13,7 @@ export declare abstract class Operand implements Evaluable {
     /**
      * {@link Evaluable.simplify}
      */
-    abstract simplify(ctx: Context, strictKeys?: string[], optionalKeys?: string[]): Result | Evaluable;
+    abstract simplify(ctx: Context, strictKeys?: string[] | Set<string>, optionalKeys?: string[] | Set<string>): Result | Evaluable;
     /**
      * {@link Evaluable.serialize}
      */

package/types/operand/reference.d.ts

@@ -24,10 +24,11 @@ export declare class Reference extends Operand {
      * @return {boolean}
      */
     evaluate(ctx: Context): Result;
+    private checkStrictAndOptional;
     /**
      * {@link Evaluable.simplify}
      */
-    simplify(ctx: Context, strictKeys?: string[], optionalKeys?: string[]): Result | Evaluable;
+    simplify(ctx: Context, strictKeys?: string[] | Set<string>, optionalKeys?: string[] | Set<string>): Result | Evaluable;
     /**
      * {@link Evaluable.serialize}
      */

package/types/unsafe/simplify.d.ts

@@ -1,4 +1,4 @@
 import { Context, Evaluable } from '../common/evaluable';
 import { Input } from '../parser';
 import { Options } from '../parser/options';
-export declare const unsafeSimplify: (context: Context, opts: Options, strictKeys?: string[], optionalKeys?: string[]) => (input: Input) => Input | Evaluable;
+export declare const unsafeSimplify: (context: Context, opts: Options, strictKeys?: Set<string>, optionalKeys?: Set<string>) => (input: Input) => Input | Evaluable;