@math.gl/sql 0.0.0-stage → 5.0.0-beta.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +249 -0
- package/README.md +26 -2
- package/THIRD-PARTY-NOTICES.md +5 -0
- package/dist/arrow/aggregates.d.ts +46 -0
- package/dist/arrow/aggregates.d.ts.map +1 -0
- package/dist/arrow/aggregates.js +289 -0
- package/dist/arrow/aggregates.js.map +1 -0
- package/dist/arrow/buffers.d.ts +30 -0
- package/dist/arrow/buffers.d.ts.map +1 -0
- package/dist/arrow/buffers.js +177 -0
- package/dist/arrow/buffers.js.map +1 -0
- package/dist/arrow/cast.d.ts +19 -0
- package/dist/arrow/cast.d.ts.map +1 -0
- package/dist/arrow/cast.js +138 -0
- package/dist/arrow/cast.js.map +1 -0
- package/dist/arrow/compiler.d.ts +10 -0
- package/dist/arrow/compiler.d.ts.map +1 -0
- package/dist/arrow/compiler.js +1421 -0
- package/dist/arrow/compiler.js.map +1 -0
- package/dist/arrow/float16.d.ts +7 -0
- package/dist/arrow/float16.d.ts.map +1 -0
- package/dist/arrow/float16.js +26 -0
- package/dist/arrow/float16.js.map +1 -0
- package/dist/arrow/index.cjs +3220 -0
- package/dist/arrow/index.cjs.map +6 -0
- package/dist/arrow/index.d.ts +5 -0
- package/dist/arrow/index.d.ts.map +1 -0
- package/dist/arrow/index.js +7 -0
- package/dist/arrow/index.js.map +1 -0
- package/dist/arrow/like.d.ts +3 -0
- package/dist/arrow/like.d.ts.map +1 -0
- package/dist/arrow/like.js +75 -0
- package/dist/arrow/like.js.map +1 -0
- package/dist/arrow/list-values.d.ts +14 -0
- package/dist/arrow/list-values.d.ts.map +1 -0
- package/dist/arrow/list-values.js +180 -0
- package/dist/arrow/list-values.js.map +1 -0
- package/dist/arrow/predicate.d.ts +7 -0
- package/dist/arrow/predicate.d.ts.map +1 -0
- package/dist/arrow/predicate.js +10 -0
- package/dist/arrow/predicate.js.map +1 -0
- package/dist/arrow/query-arrow-aggregate-snapshots.d.ts +24 -0
- package/dist/arrow/query-arrow-aggregate-snapshots.d.ts.map +1 -0
- package/dist/arrow/query-arrow-aggregate-snapshots.js +64 -0
- package/dist/arrow/query-arrow-aggregate-snapshots.js.map +1 -0
- package/dist/arrow/query-arrow-sql.d.ts +8 -0
- package/dist/arrow/query-arrow-sql.d.ts.map +1 -0
- package/dist/arrow/query-arrow-sql.js +191 -0
- package/dist/arrow/query-arrow-sql.js.map +1 -0
- package/dist/arrow/query-arrow-table.d.ts +36 -0
- package/dist/arrow/query-arrow-table.d.ts.map +1 -0
- package/dist/arrow/query-arrow-table.js +208 -0
- package/dist/arrow/query-arrow-table.js.map +1 -0
- package/dist/arrow/query-worker-entry.d.ts +2 -0
- package/dist/arrow/query-worker-entry.d.ts.map +1 -0
- package/dist/arrow/query-worker-entry.js +7 -0
- package/dist/arrow/query-worker-entry.js.map +1 -0
- package/dist/arrow/query-worker.d.ts +65 -0
- package/dist/arrow/query-worker.d.ts.map +1 -0
- package/dist/arrow/query-worker.js +135 -0
- package/dist/arrow/query-worker.js.map +1 -0
- package/dist/arrow/registry.d.ts +4 -0
- package/dist/arrow/registry.d.ts.map +1 -0
- package/dist/arrow/registry.js +65 -0
- package/dist/arrow/registry.js.map +1 -0
- package/dist/arrow/relational-query.d.ts +36 -0
- package/dist/arrow/relational-query.d.ts.map +1 -0
- package/dist/arrow/relational-query.js +174 -0
- package/dist/arrow/relational-query.js.map +1 -0
- package/dist/arrow/replace-arrow-columns.d.ts +8 -0
- package/dist/arrow/replace-arrow-columns.d.ts.map +1 -0
- package/dist/arrow/replace-arrow-columns.js +63 -0
- package/dist/arrow/replace-arrow-columns.js.map +1 -0
- package/dist/arrow/signature.d.ts +6 -0
- package/dist/arrow/signature.d.ts.map +1 -0
- package/dist/arrow/signature.js +51 -0
- package/dist/arrow/signature.js.map +1 -0
- package/dist/arrow/temporal-cast.d.ts +9 -0
- package/dist/arrow/temporal-cast.d.ts.map +1 -0
- package/dist/arrow/temporal-cast.js +60 -0
- package/dist/arrow/temporal-cast.js.map +1 -0
- package/dist/arrow/types.d.ts +62 -0
- package/dist/arrow/types.d.ts.map +1 -0
- package/dist/arrow/types.js +5 -0
- package/dist/arrow/types.js.map +1 -0
- package/dist/arrow/worker-entry.d.ts +2 -0
- package/dist/arrow/worker-entry.d.ts.map +1 -0
- package/dist/arrow/worker-entry.js +9 -0
- package/dist/arrow/worker-entry.js.map +1 -0
- package/dist/arrow/worker.cjs +3973 -0
- package/dist/arrow/worker.cjs.map +6 -0
- package/dist/arrow/worker.d.ts +58 -0
- package/dist/arrow/worker.d.ts.map +1 -0
- package/dist/arrow/worker.js +84 -0
- package/dist/arrow/worker.js.map +1 -0
- package/dist/color/index.cjs +382 -0
- package/dist/color/index.cjs.map +6 -0
- package/dist/color/index.d.ts +26 -0
- package/dist/color/index.d.ts.map +1 -0
- package/dist/color/index.js +306 -0
- package/dist/color/index.js.map +1 -0
- package/dist/diagnostic-log.d.ts +8 -0
- package/dist/diagnostic-log.d.ts.map +1 -0
- package/dist/diagnostic-log.js +15 -0
- package/dist/diagnostic-log.js.map +1 -0
- package/dist/expressions/ast.d.ts +12 -0
- package/dist/expressions/ast.d.ts.map +1 -0
- package/dist/expressions/ast.js +112 -0
- package/dist/expressions/ast.js.map +1 -0
- package/dist/expressions/columnar-predicate.d.ts +56 -0
- package/dist/expressions/columnar-predicate.d.ts.map +1 -0
- package/dist/expressions/columnar-predicate.js +176 -0
- package/dist/expressions/columnar-predicate.js.map +1 -0
- package/dist/expressions/evaluation-error.d.ts +14 -0
- package/dist/expressions/evaluation-error.d.ts.map +1 -0
- package/dist/expressions/evaluation-error.js +26 -0
- package/dist/expressions/evaluation-error.js.map +1 -0
- package/dist/expressions/expression-eval.d.ts +96 -0
- package/dist/expressions/expression-eval.d.ts.map +1 -0
- package/dist/expressions/expression-eval.js +330 -0
- package/dist/expressions/expression-eval.js.map +1 -0
- package/dist/expressions/function-libraries.d.ts +63 -0
- package/dist/expressions/function-libraries.d.ts.map +1 -0
- package/dist/expressions/function-libraries.js +69 -0
- package/dist/expressions/function-libraries.js.map +1 -0
- package/dist/expressions/function-registry.d.ts +93 -0
- package/dist/expressions/function-registry.d.ts.map +1 -0
- package/dist/expressions/function-registry.js +139 -0
- package/dist/expressions/function-registry.js.map +1 -0
- package/dist/expressions/get.d.ts +9 -0
- package/dist/expressions/get.d.ts.map +1 -0
- package/dist/expressions/get.js +32 -0
- package/dist/expressions/get.js.map +1 -0
- package/dist/expressions/index.cjs +1888 -0
- package/dist/expressions/index.cjs.map +6 -0
- package/dist/expressions/index.d.ts +13 -0
- package/dist/expressions/index.d.ts.map +1 -0
- package/dist/expressions/index.js +14 -0
- package/dist/expressions/index.js.map +1 -0
- package/dist/expressions/numeric-functions.d.ts +277 -0
- package/dist/expressions/numeric-functions.d.ts.map +1 -0
- package/dist/expressions/numeric-functions.js +52 -0
- package/dist/expressions/numeric-functions.js.map +1 -0
- package/dist/expressions/parse-expression-string.d.ts +21 -0
- package/dist/expressions/parse-expression-string.d.ts.map +1 -0
- package/dist/expressions/parse-expression-string.js +61 -0
- package/dist/expressions/parse-expression-string.js.map +1 -0
- package/dist/expressions/predicate-expression.d.ts +7 -0
- package/dist/expressions/predicate-expression.d.ts.map +1 -0
- package/dist/expressions/predicate-expression.js +112 -0
- package/dist/expressions/predicate-expression.js.map +1 -0
- package/dist/expressions/scalar-type.d.ts +6 -0
- package/dist/expressions/scalar-type.d.ts.map +1 -0
- package/dist/expressions/scalar-type.js +23 -0
- package/dist/expressions/scalar-type.js.map +1 -0
- package/dist/expressions/vendor/jsep/runtime.d.ts +3 -0
- package/dist/expressions/vendor/jsep/runtime.d.ts.map +1 -0
- package/dist/expressions/vendor/jsep/runtime.js +972 -0
- package/dist/expressions/vendor/jsep/runtime.js.map +1 -0
- package/dist/expressions/vendor/jsep/types.d.ts +148 -0
- package/dist/expressions/vendor/jsep/types.d.ts.map +1 -0
- package/dist/expressions/vendor/jsep/types.js +6 -0
- package/dist/expressions/vendor/jsep/types.js.map +1 -0
- package/dist/index.cjs +4865 -0
- package/dist/index.cjs.map +6 -0
- package/dist/index.d.ts +9 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +10 -0
- package/dist/index.js.map +1 -0
- package/dist/math/index.cjs +444 -0
- package/dist/math/index.cjs.map +6 -0
- package/dist/math/index.d.ts +44 -0
- package/dist/math/index.d.ts.map +1 -0
- package/dist/math/index.js +182 -0
- package/dist/math/index.js.map +1 -0
- package/dist/scales/arrow-domains.d.ts +15 -0
- package/dist/scales/arrow-domains.d.ts.map +1 -0
- package/dist/scales/arrow-domains.js +124 -0
- package/dist/scales/arrow-domains.js.map +1 -0
- package/dist/scales/arrow-scales.cjs +3837 -0
- package/dist/scales/arrow-scales.cjs.map +6 -0
- package/dist/scales/arrow-scales.d.ts +20 -0
- package/dist/scales/arrow-scales.d.ts.map +1 -0
- package/dist/scales/arrow-scales.js +109 -0
- package/dist/scales/arrow-scales.js.map +1 -0
- package/dist/scales/compile-scale.d.ts +7 -0
- package/dist/scales/compile-scale.d.ts.map +1 -0
- package/dist/scales/compile-scale.js +195 -0
- package/dist/scales/compile-scale.js.map +1 -0
- package/dist/scales/hdr-colors.d.ts +13 -0
- package/dist/scales/hdr-colors.d.ts.map +1 -0
- package/dist/scales/hdr-colors.js +115 -0
- package/dist/scales/hdr-colors.js.map +1 -0
- package/dist/scales/index.cjs +1214 -0
- package/dist/scales/index.cjs.map +6 -0
- package/dist/scales/index.d.ts +9 -0
- package/dist/scales/index.d.ts.map +1 -0
- package/dist/scales/index.js +10 -0
- package/dist/scales/index.js.map +1 -0
- package/dist/scales/palettes.d.ts +5 -0
- package/dist/scales/palettes.d.ts.map +1 -0
- package/dist/scales/palettes.js +85 -0
- package/dist/scales/palettes.js.map +1 -0
- package/dist/scales/parse-sql-scale.d.ts +14 -0
- package/dist/scales/parse-sql-scale.d.ts.map +1 -0
- package/dist/scales/parse-sql-scale.js +165 -0
- package/dist/scales/parse-sql-scale.js.map +1 -0
- package/dist/scales/quantile-sketch.d.ts +22 -0
- package/dist/scales/quantile-sketch.d.ts.map +1 -0
- package/dist/scales/quantile-sketch.js +108 -0
- package/dist/scales/quantile-sketch.js.map +1 -0
- package/dist/scales/scale-types.d.ts +92 -0
- package/dist/scales/scale-types.d.ts.map +1 -0
- package/dist/scales/scale-types.js +119 -0
- package/dist/scales/scale-types.js.map +1 -0
- package/dist/scales/streaming-domains.d.ts +18 -0
- package/dist/scales/streaming-domains.d.ts.map +1 -0
- package/dist/scales/streaming-domains.js +109 -0
- package/dist/scales/streaming-domains.js.map +1 -0
- package/dist/sql/bind-sql-predicate.d.ts +4 -0
- package/dist/sql/bind-sql-predicate.d.ts.map +1 -0
- package/dist/sql/bind-sql-predicate.js +11 -0
- package/dist/sql/bind-sql-predicate.js.map +1 -0
- package/dist/sql/index.cjs +1588 -0
- package/dist/sql/index.cjs.map +6 -0
- package/dist/sql/index.d.ts +10 -0
- package/dist/sql/index.d.ts.map +1 -0
- package/dist/sql/index.js +10 -0
- package/dist/sql/index.js.map +1 -0
- package/dist/sql/parse-sql-expression.d.ts +44 -0
- package/dist/sql/parse-sql-expression.d.ts.map +1 -0
- package/dist/sql/parse-sql-expression.js +455 -0
- package/dist/sql/parse-sql-expression.js.map +1 -0
- package/dist/sql/parse-sql-predicate.d.ts +13 -0
- package/dist/sql/parse-sql-predicate.d.ts.map +1 -0
- package/dist/sql/parse-sql-predicate.js +365 -0
- package/dist/sql/parse-sql-predicate.js.map +1 -0
- package/dist/sql/parse-sql-query.d.ts +8 -0
- package/dist/sql/parse-sql-query.d.ts.map +1 -0
- package/dist/sql/parse-sql-query.js +66 -0
- package/dist/sql/parse-sql-query.js.map +1 -0
- package/dist/sql/parse-sql-select.d.ts +55 -0
- package/dist/sql/parse-sql-select.d.ts.map +1 -0
- package/dist/sql/parse-sql-select.js +244 -0
- package/dist/sql/parse-sql-select.js.map +1 -0
- package/dist/sql/parse-sql-statement.d.ts +50 -0
- package/dist/sql/parse-sql-statement.d.ts.map +1 -0
- package/dist/sql/parse-sql-statement.js +182 -0
- package/dist/sql/parse-sql-statement.js.map +1 -0
- package/dist/sql/query-types.d.ts +56 -0
- package/dist/sql/query-types.d.ts.map +1 -0
- package/dist/sql/query-types.js +5 -0
- package/dist/sql/query-types.js.map +1 -0
- package/dist/sql/sql-parse-error.d.ts +13 -0
- package/dist/sql/sql-parse-error.d.ts.map +1 -0
- package/dist/sql/sql-parse-error.js +20 -0
- package/dist/sql/sql-parse-error.js.map +1 -0
- package/dist/sql/sql-predicate-schema.d.ts +164 -0
- package/dist/sql/sql-predicate-schema.d.ts.map +1 -0
- package/dist/sql/sql-predicate-schema.js +249 -0
- package/dist/sql/sql-predicate-schema.js.map +1 -0
- package/dist/sql/sql-predicate-types.d.ts +48 -0
- package/dist/sql/sql-predicate-types.d.ts.map +1 -0
- package/dist/sql/sql-predicate-types.js +9 -0
- package/dist/sql/sql-predicate-types.js.map +1 -0
- package/dist/sql/sql-predicate.d.ts +6 -0
- package/dist/sql/sql-predicate.d.ts.map +1 -0
- package/dist/sql/sql-predicate.js +8 -0
- package/dist/sql/sql-predicate.js.map +1 -0
- package/package.json +92 -4
- package/src/arrow/aggregates.ts +386 -0
- package/src/arrow/buffers.ts +177 -0
- package/src/arrow/cast.ts +160 -0
- package/src/arrow/compiler.ts +1659 -0
- package/src/arrow/float16.ts +25 -0
- package/src/arrow/index.ts +22 -0
- package/src/arrow/like.ts +72 -0
- package/src/arrow/list-values.ts +200 -0
- package/src/arrow/predicate.ts +19 -0
- package/src/arrow/query-arrow-aggregate-snapshots.ts +107 -0
- package/src/arrow/query-arrow-sql.ts +227 -0
- package/src/arrow/query-arrow-table.ts +298 -0
- package/src/arrow/query-worker-entry.ts +8 -0
- package/src/arrow/query-worker.ts +190 -0
- package/src/arrow/registry.ts +86 -0
- package/src/arrow/relational-query.ts +247 -0
- package/src/arrow/replace-arrow-columns.ts +71 -0
- package/src/arrow/signature.ts +50 -0
- package/src/arrow/temporal-cast.ts +66 -0
- package/src/arrow/types.ts +76 -0
- package/src/arrow/worker-entry.ts +10 -0
- package/src/arrow/worker.ts +139 -0
- package/src/color/index.ts +405 -0
- package/src/diagnostic-log.ts +20 -0
- package/src/expressions/ast.ts +141 -0
- package/src/expressions/columnar-predicate.ts +293 -0
- package/src/expressions/evaluation-error.ts +29 -0
- package/src/expressions/expression-eval.ts +480 -0
- package/src/expressions/function-libraries.ts +126 -0
- package/src/expressions/function-registry.ts +171 -0
- package/src/expressions/get.ts +37 -0
- package/src/expressions/index.ts +40 -0
- package/src/expressions/numeric-functions.ts +99 -0
- package/src/expressions/parse-expression-string.ts +80 -0
- package/src/expressions/predicate-expression.ts +128 -0
- package/src/expressions/scalar-type.ts +39 -0
- package/src/expressions/vendor/jsep/LICENSE.txt +23 -0
- package/src/expressions/vendor/jsep/README.md +22 -0
- package/src/expressions/vendor/jsep/runtime.ts +949 -0
- package/src/expressions/vendor/jsep/types.ts +191 -0
- package/src/index.ts +40 -0
- package/src/math/index.ts +235 -0
- package/src/scales/arrow-domains.ts +131 -0
- package/src/scales/arrow-scales.ts +156 -0
- package/src/scales/compile-scale.ts +217 -0
- package/src/scales/hdr-colors.ts +126 -0
- package/src/scales/index.ts +35 -0
- package/src/scales/palettes.ts +86 -0
- package/src/scales/parse-sql-scale.ts +195 -0
- package/src/scales/quantile-sketch.ts +106 -0
- package/src/scales/scale-types.ts +224 -0
- package/src/scales/streaming-domains.ts +133 -0
- package/src/sql/bind-sql-predicate.ts +21 -0
- package/src/sql/index.ts +28 -0
- package/src/sql/parse-sql-expression.ts +457 -0
- package/src/sql/parse-sql-predicate.ts +454 -0
- package/src/sql/parse-sql-query.ts +72 -0
- package/src/sql/parse-sql-select.ts +266 -0
- package/src/sql/parse-sql-statement.ts +242 -0
- package/src/sql/query-types.ts +71 -0
- package/src/sql/sql-parse-error.ts +33 -0
- package/src/sql/sql-predicate-schema.ts +279 -0
- package/src/sql/sql-predicate-types.ts +91 -0
- package/src/sql/sql-predicate.ts +28 -0
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
// math.gl
|
|
2
|
+
// SPDX-License-Identifier: MIT
|
|
3
|
+
// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
|
|
4
|
+
import { isColumnarScalarType } from "./scalar-type.js";
|
|
5
|
+
export function getColumnarPredicateColumns(predicate) {
|
|
6
|
+
return [...new Set(getColumnarPredicatePaths(predicate).map(path => path[0]))];
|
|
7
|
+
}
|
|
8
|
+
export function getColumnarPredicatePath(property) {
|
|
9
|
+
return typeof property.property === 'string' ? [property.property] : [...property.property];
|
|
10
|
+
}
|
|
11
|
+
export function getColumnarPredicatePaths(predicate) {
|
|
12
|
+
const paths = new Map();
|
|
13
|
+
visitColumnarPredicate(predicate, child => {
|
|
14
|
+
if ('property' in child.args[0]) {
|
|
15
|
+
const path = getColumnarPredicatePath(child.args[0]);
|
|
16
|
+
paths.set(path.join('\0'), path);
|
|
17
|
+
}
|
|
18
|
+
});
|
|
19
|
+
return [...paths.values()];
|
|
20
|
+
}
|
|
21
|
+
/** Returns unresolved named parameter names in their first-occurrence order. */
|
|
22
|
+
export function getColumnarPredicateParameterNames(predicate) {
|
|
23
|
+
const parameterNames = new Set();
|
|
24
|
+
visitColumnarPredicate(predicate, child => {
|
|
25
|
+
if (child.op === 'and' || child.op === 'or' || child.op === 'not' || child.op === 'isNull') {
|
|
26
|
+
return;
|
|
27
|
+
}
|
|
28
|
+
const values = child.op === 'in' ? child.args[1] : [child.args[1]];
|
|
29
|
+
for (const value of values) {
|
|
30
|
+
if (isColumnarPredicateParameter(value)) {
|
|
31
|
+
parameterNames.add(value.parameter);
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
});
|
|
35
|
+
return [...parameterNames];
|
|
36
|
+
}
|
|
37
|
+
export function copyColumnarPredicate(predicate) {
|
|
38
|
+
if (predicate.op === 'and' || predicate.op === 'or') {
|
|
39
|
+
return { op: predicate.op, args: predicate.args.map(copyColumnarPredicate) };
|
|
40
|
+
}
|
|
41
|
+
if (predicate.op === 'not') {
|
|
42
|
+
return { op: 'not', args: [copyColumnarPredicate(predicate.args[0])] };
|
|
43
|
+
}
|
|
44
|
+
const leaf = predicate;
|
|
45
|
+
const property = copyColumnarPredicateProperty({
|
|
46
|
+
...leaf.args[0],
|
|
47
|
+
property: [...getColumnarPredicatePath(leaf.args[0])]
|
|
48
|
+
});
|
|
49
|
+
if (leaf.op === 'isNull')
|
|
50
|
+
return { op: 'isNull', args: [property] };
|
|
51
|
+
if (leaf.op === 'in') {
|
|
52
|
+
return { op: 'in', args: [property, leaf.args[1].map(copyColumnarPredicateValue)] };
|
|
53
|
+
}
|
|
54
|
+
return { op: leaf.op, args: [property, copyColumnarPredicateValue(leaf.args[1])] };
|
|
55
|
+
}
|
|
56
|
+
export function validateColumnarPredicate(predicate, availableColumns) {
|
|
57
|
+
visitColumnarPredicate(predicate, child => {
|
|
58
|
+
if (child.op === 'and' || child.op === 'or') {
|
|
59
|
+
if (child.args.length < 2)
|
|
60
|
+
throw new Error(`Columnar predicate ${child.op} requires at least two child predicates`);
|
|
61
|
+
return;
|
|
62
|
+
}
|
|
63
|
+
if (child.op === 'not')
|
|
64
|
+
return;
|
|
65
|
+
const leaf = child;
|
|
66
|
+
const casts = leaf.args[0].casts;
|
|
67
|
+
if (casts !== undefined &&
|
|
68
|
+
(!Array.isArray(casts) ||
|
|
69
|
+
!casts.length ||
|
|
70
|
+
casts.length > 64 ||
|
|
71
|
+
Array.from(casts).some(type => !isColumnarScalarType(type))))
|
|
72
|
+
throw new Error('Invalid columnar predicate casts');
|
|
73
|
+
const path = getColumnarPredicatePath(leaf.args[0]);
|
|
74
|
+
if (!path.length || path.some(component => !component)) {
|
|
75
|
+
throw new Error('Columnar predicate property path must contain non-empty strings');
|
|
76
|
+
}
|
|
77
|
+
if (!availableColumns.has(path[0]))
|
|
78
|
+
throw new Error(`Columnar predicate column not found: ${path.join('.')}`);
|
|
79
|
+
if (leaf.op === 'in' && leaf.args[1].length === 0) {
|
|
80
|
+
throw new Error('Columnar predicate in requires at least one value');
|
|
81
|
+
}
|
|
82
|
+
});
|
|
83
|
+
}
|
|
84
|
+
/** Returns whether a predicate value is an unresolved named parameter. */
|
|
85
|
+
export function isColumnarPredicateParameter(value) {
|
|
86
|
+
const parameterValue = value;
|
|
87
|
+
return (typeof value === 'object' &&
|
|
88
|
+
value !== null &&
|
|
89
|
+
!Array.isArray(value) &&
|
|
90
|
+
Object.keys(value).length === 1 &&
|
|
91
|
+
Object.prototype.hasOwnProperty.call(value, 'parameter') &&
|
|
92
|
+
typeof parameterValue.parameter === 'string' &&
|
|
93
|
+
parameterValue.parameter.length > 0);
|
|
94
|
+
}
|
|
95
|
+
/** Returns whether a runtime value belongs to the portable predicate scalar set. */
|
|
96
|
+
export function isColumnarPredicateValue(value) {
|
|
97
|
+
return (typeof value === 'boolean' ||
|
|
98
|
+
typeof value === 'bigint' ||
|
|
99
|
+
typeof value === 'string' ||
|
|
100
|
+
(typeof value === 'number' && Number.isFinite(value)) ||
|
|
101
|
+
(value instanceof Date && Number.isFinite(value.getTime())) ||
|
|
102
|
+
value instanceof Uint8Array);
|
|
103
|
+
}
|
|
104
|
+
/** Binds every named parameter without mutating the portable predicate. */
|
|
105
|
+
export function bindColumnarPredicateParameters(predicate, parameters) {
|
|
106
|
+
switch (predicate.op) {
|
|
107
|
+
case 'and':
|
|
108
|
+
case 'or':
|
|
109
|
+
return {
|
|
110
|
+
op: predicate.op,
|
|
111
|
+
args: predicate.args.map(child => bindColumnarPredicateParameters(child, parameters))
|
|
112
|
+
};
|
|
113
|
+
case 'not':
|
|
114
|
+
return {
|
|
115
|
+
op: 'not',
|
|
116
|
+
args: [bindColumnarPredicateParameters(predicate.args[0], parameters)]
|
|
117
|
+
};
|
|
118
|
+
case 'isNull':
|
|
119
|
+
return { op: 'isNull', args: [copyColumnarPredicateProperty(predicate.args[0])] };
|
|
120
|
+
case 'in':
|
|
121
|
+
return {
|
|
122
|
+
op: 'in',
|
|
123
|
+
args: [
|
|
124
|
+
copyColumnarPredicateProperty(predicate.args[0]),
|
|
125
|
+
predicate.args[1].map(value => bindColumnarPredicateValue(value, parameters))
|
|
126
|
+
]
|
|
127
|
+
};
|
|
128
|
+
default:
|
|
129
|
+
return {
|
|
130
|
+
op: predicate.op,
|
|
131
|
+
args: [
|
|
132
|
+
copyColumnarPredicateProperty(predicate.args[0]),
|
|
133
|
+
bindColumnarPredicateValue(predicate.args[1], parameters)
|
|
134
|
+
]
|
|
135
|
+
};
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
function visitColumnarPredicate(predicate, visitor) {
|
|
139
|
+
visitor(predicate);
|
|
140
|
+
if (predicate.op === 'and' || predicate.op === 'or')
|
|
141
|
+
predicate.args.forEach(child => visitColumnarPredicate(child, visitor));
|
|
142
|
+
else if (predicate.op === 'not')
|
|
143
|
+
visitColumnarPredicate(predicate.args[0], visitor);
|
|
144
|
+
}
|
|
145
|
+
/** Resolves one parameter reference or returns an already concrete scalar. */
|
|
146
|
+
function bindColumnarPredicateValue(value, parameters) {
|
|
147
|
+
if (!isColumnarPredicateParameter(value))
|
|
148
|
+
return value;
|
|
149
|
+
if (!Object.prototype.hasOwnProperty.call(parameters, value.parameter)) {
|
|
150
|
+
throw new Error(`Columnar predicate parameter ":${value.parameter}" requires a value`);
|
|
151
|
+
}
|
|
152
|
+
const parameterValue = parameters[value.parameter];
|
|
153
|
+
if (isColumnarPredicateParameter(parameterValue)) {
|
|
154
|
+
throw new Error(`Columnar predicate parameter ":${value.parameter}" cannot reference another parameter`);
|
|
155
|
+
}
|
|
156
|
+
if (!isColumnarPredicateValue(parameterValue)) {
|
|
157
|
+
throw new Error(`Columnar predicate parameter ":${value.parameter}" has an unsupported value`);
|
|
158
|
+
}
|
|
159
|
+
return copyColumnarPredicateValue(parameterValue);
|
|
160
|
+
}
|
|
161
|
+
/** Copies a property while preserving its backend-specific property subtype. */
|
|
162
|
+
function copyColumnarPredicateProperty(property) {
|
|
163
|
+
return {
|
|
164
|
+
...property,
|
|
165
|
+
...(property.casts ? { casts: [...property.casts] } : {}),
|
|
166
|
+
property: typeof property.property === 'string' ? property.property : [...property.property]
|
|
167
|
+
};
|
|
168
|
+
}
|
|
169
|
+
function copyColumnarPredicateValue(value) {
|
|
170
|
+
if (value instanceof Uint8Array)
|
|
171
|
+
return value.slice();
|
|
172
|
+
if (value instanceof Date)
|
|
173
|
+
return new Date(value.getTime());
|
|
174
|
+
return value;
|
|
175
|
+
}
|
|
176
|
+
//# sourceMappingURL=columnar-predicate.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"columnar-predicate.js","sourceRoot":"","sources":["../../src/expressions/columnar-predicate.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/** Recoverable data errors; programming, binding and cancellation errors remain ordinary exceptions. */
|
|
2
|
+
export type ExpressionEvaluationErrorCode = 'domain' | 'conversion' | 'overflow' | 'divisionByZero';
|
|
3
|
+
declare const brand: unique symbol;
|
|
4
|
+
/** A classified scalar evaluation failure, eligible for explicit TRY recovery. */
|
|
5
|
+
export declare class ExpressionEvaluationError extends Error {
|
|
6
|
+
readonly code: ExpressionEvaluationErrorCode;
|
|
7
|
+
readonly name = "ExpressionEvaluationError";
|
|
8
|
+
readonly [brand] = true;
|
|
9
|
+
constructor(code: ExpressionEvaluationErrorCode, message: string);
|
|
10
|
+
}
|
|
11
|
+
/** Recognizes classified errors across separately bundled ESM/CommonJS function entry points. */
|
|
12
|
+
export declare function isExpressionEvaluationError(error: unknown): error is ExpressionEvaluationError;
|
|
13
|
+
export {};
|
|
14
|
+
//# sourceMappingURL=evaluation-error.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"evaluation-error.d.ts","sourceRoot":"","sources":["../../src/expressions/evaluation-error.ts"],"names":[],"mappings":"AAIA,wGAAwG;AACxG,MAAM,MAAM,6BAA6B,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,gBAAgB,CAAC;AACpG,QAAA,MAAM,KAAK,eAAwD,CAAC;AAEpE,kFAAkF;AAClF,qBAAa,yBAA0B,SAAQ,KAAK;IAIhD,QAAQ,CAAC,IAAI,EAAE,6BAA6B;IAH9C,SAAkB,IAAI,+BAA+B;IACrD,QAAQ,CAAC,CAAC,KAAK,CAAC,QAAQ;gBAEb,IAAI,EAAE,6BAA6B,EAC5C,OAAO,EAAE,MAAM;CAKlB;AACD,iGAAiG;AACjG,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,yBAAyB,CAO9F"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
// math.gl
|
|
2
|
+
// SPDX-License-Identifier: MIT
|
|
3
|
+
// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
|
|
4
|
+
var _a;
|
|
5
|
+
const brand = Symbol.for('@math.gl/core/ExpressionEvaluationError');
|
|
6
|
+
const codes = ['domain', 'conversion', 'overflow', 'divisionByZero'];
|
|
7
|
+
/** A classified scalar evaluation failure, eligible for explicit TRY recovery. */
|
|
8
|
+
export class ExpressionEvaluationError extends Error {
|
|
9
|
+
constructor(code, message) {
|
|
10
|
+
super(message);
|
|
11
|
+
this.code = code;
|
|
12
|
+
this.name = 'ExpressionEvaluationError';
|
|
13
|
+
this[_a] = true;
|
|
14
|
+
if (!codes.includes(code))
|
|
15
|
+
throw new TypeError('Unknown Arrow evaluation error code');
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
_a = brand;
|
|
19
|
+
/** Recognizes classified errors across separately bundled ESM/CommonJS function entry points. */
|
|
20
|
+
export function isExpressionEvaluationError(error) {
|
|
21
|
+
return (typeof error === 'object' &&
|
|
22
|
+
error !== null &&
|
|
23
|
+
error[brand] === true &&
|
|
24
|
+
codes.includes(error.code));
|
|
25
|
+
}
|
|
26
|
+
//# sourceMappingURL=evaluation-error.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"evaluation-error.js","sourceRoot":"","sources":["../../src/expressions/evaluation-error.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;;AAI5D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;AACpE,MAAM,KAAK,GAAsB,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;AACxF,kFAAkF;AAClF,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAGlD,YACW,IAAmC,EAC5C,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,SAAI,GAAJ,IAAI,CAA+B;QAH5B,SAAI,GAAG,2BAA2B,CAAC;QAC5C,QAAO,GAAG,IAAI,CAAC;QAMtB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;IACxF,CAAC;CACF;KARW,KAAK;AASjB,iGAAiG;AACjG,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAsC,CAAC,KAAK,CAAC,KAAK,IAAI;QACvD,KAAK,CAAC,QAAQ,CAAE,KAAmC,CAAC,IAAI,CAAC,CAC1D,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Sources:
|
|
3
|
+
* - Copyright (c) 2013 Stephen Oney, http://jsep.from.so/, MIT License
|
|
4
|
+
* - Copyright (c) 2023 Don McCurdy, https://github.com/donmccurdy/expression-eval, MIT License
|
|
5
|
+
*/
|
|
6
|
+
import { type DiagnosticLog } from "../diagnostic-log.js";
|
|
7
|
+
import type { Jsep as JsepTypes } from "./vendor/jsep/types.js";
|
|
8
|
+
import { type ExpressionEvaluationOptions } from "./function-libraries.js";
|
|
9
|
+
/**
|
|
10
|
+
* Named values and functions available while evaluating an expression.
|
|
11
|
+
*/
|
|
12
|
+
export type ExpressionContext = Record<string, unknown>;
|
|
13
|
+
/**
|
|
14
|
+
* A JSEP abstract syntax tree node supported by the evaluator.
|
|
15
|
+
*/
|
|
16
|
+
export type Expression = JsepTypes.ArrayExpression | JsepTypes.BinaryExpression | JsepTypes.LogicalExpression | (JsepTypes.CallExpression & {
|
|
17
|
+
/** SQL unquoted function names resolve case-insensitively. */ sqlFunction?: true;
|
|
18
|
+
}) | JsepTypes.ConditionalExpression | JsepTypes.Identifier | JsepTypes.Literal | JsepTypes.MemberExpression | JsepTypes.ThisExpression | JsepTypes.UnaryExpression;
|
|
19
|
+
/**
|
|
20
|
+
* Evaluator implementation for a custom unary operator.
|
|
21
|
+
*
|
|
22
|
+
* @param operand - Value produced by the operator's operand expression.
|
|
23
|
+
* @returns The operator result.
|
|
24
|
+
*/
|
|
25
|
+
export type UnaryOperator = (operand: any) => any;
|
|
26
|
+
/**
|
|
27
|
+
* Evaluator implementation for a custom binary operator.
|
|
28
|
+
*
|
|
29
|
+
* @param left - Value produced by the left operand expression.
|
|
30
|
+
* @param right - Value produced by the right operand expression.
|
|
31
|
+
* @returns The operator result.
|
|
32
|
+
*/
|
|
33
|
+
export type BinaryOperator = (left: any, right: any) => any;
|
|
34
|
+
/**
|
|
35
|
+
* Compiles an expression into a reusable synchronous evaluator.
|
|
36
|
+
*
|
|
37
|
+
* @param expression - Expression source or a previously parsed AST.
|
|
38
|
+
* @param options - Function libraries to add to each evaluation context.
|
|
39
|
+
* @returns A function that evaluates the expression against a context.
|
|
40
|
+
*/
|
|
41
|
+
export declare function compile(expression: string | JsepTypes.Expression, options?: ExpressionEvaluationOptions): (context: ExpressionContext) => unknown;
|
|
42
|
+
/**
|
|
43
|
+
* Compiles an expression into a reusable asynchronous evaluator.
|
|
44
|
+
*
|
|
45
|
+
* @param expression - Expression source or a previously parsed AST.
|
|
46
|
+
* @param options - Function libraries to add to each evaluation context.
|
|
47
|
+
* @returns A function that asynchronously evaluates the expression.
|
|
48
|
+
*/
|
|
49
|
+
export declare function compileAsync(expression: string | JsepTypes.Expression, options?: ExpressionEvaluationOptions): (context: ExpressionContext) => Promise<unknown>;
|
|
50
|
+
/**
|
|
51
|
+
* Registers a custom unary operator with the parser and evaluator.
|
|
52
|
+
*
|
|
53
|
+
* @param operator - Operator token to register.
|
|
54
|
+
* @param fn - Evaluator implementation for the operator.
|
|
55
|
+
*
|
|
56
|
+
* @remarks
|
|
57
|
+
* Registration changes module-global parser state and affects subsequent
|
|
58
|
+
* calls to {@link parse}.
|
|
59
|
+
*/
|
|
60
|
+
export declare function addUnaryOp(operator: string, fn: UnaryOperator): void;
|
|
61
|
+
/**
|
|
62
|
+
* Registers a custom binary operator with the parser and evaluator.
|
|
63
|
+
*
|
|
64
|
+
* @param operator - Operator token to register.
|
|
65
|
+
* @param precedenceOrFn - Parser precedence, or the evaluator implementation
|
|
66
|
+
* when using the default precedence for a built-in operator.
|
|
67
|
+
* @param fn - Evaluator implementation when an explicit precedence is given.
|
|
68
|
+
*
|
|
69
|
+
* @remarks
|
|
70
|
+
* Registration changes module-global parser state and affects subsequent
|
|
71
|
+
* calls to {@link parse}. New operators should provide explicit precedence.
|
|
72
|
+
*/
|
|
73
|
+
export declare function addBinaryOp(operator: string, precedenceOrFn: number | BinaryOperator, fn?: BinaryOperator): void;
|
|
74
|
+
/**
|
|
75
|
+
* Parses expression source into a JSEP abstract syntax tree.
|
|
76
|
+
*
|
|
77
|
+
* @param expression - Expression source or an existing AST.
|
|
78
|
+
* @returns A parsed AST, or the supplied AST unchanged.
|
|
79
|
+
* @throws If the expression string is not valid JSEP syntax.
|
|
80
|
+
*/
|
|
81
|
+
export declare function parse(expression: string | JsepTypes.Expression, options?: {
|
|
82
|
+
log?: DiagnosticLog;
|
|
83
|
+
}): JsepTypes.Expression;
|
|
84
|
+
/**
|
|
85
|
+
* Evaluates a parsed expression synchronously.
|
|
86
|
+
*
|
|
87
|
+
* @param node - Expression AST to evaluate.
|
|
88
|
+
* @param context - Named values and functions available to the expression.
|
|
89
|
+
* @param options - Function libraries to add to the context.
|
|
90
|
+
* @returns The expression value.
|
|
91
|
+
*/
|
|
92
|
+
declare function evaluateWithDiagnostics(node: JsepTypes.Expression, context: ExpressionContext, options?: ExpressionEvaluationOptions): unknown;
|
|
93
|
+
export { evaluateWithDiagnostics as evaluate };
|
|
94
|
+
/** Evaluates an expression asynchronously and reports errors to the supplied logger. */
|
|
95
|
+
export declare function evaluateAsync(node: JsepTypes.Expression, context: ExpressionContext, options?: ExpressionEvaluationOptions): Promise<unknown>;
|
|
96
|
+
//# sourceMappingURL=expression-eval.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"expression-eval.d.ts","sourceRoot":"","sources":["../../src/expressions/expression-eval.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AAGH,OAAO,EAAwB,KAAK,aAAa,EAAC,6BAA0B;AAE5E,OAAO,KAAK,EAAC,IAAI,IAAI,SAAS,EAAC,+BAA4B;AAC3D,OAAO,EAAyB,KAAK,2BAA2B,EAAC,gCAA6B;AAI9F;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,SAAS,CAAC,eAAe,GACzB,SAAS,CAAC,gBAAgB,GAC1B,SAAS,CAAC,iBAAiB,GAC3B,CAAC,SAAS,CAAC,cAAc,GAAG;IAC1B,8DAA8D,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;CACnF,CAAC,GACF,SAAS,CAAC,qBAAqB,GAC/B,SAAS,CAAC,UAAU,GACpB,SAAS,CAAC,OAAO,GACjB,SAAS,CAAC,gBAAgB,GAC1B,SAAS,CAAC,cAAc,GACxB,SAAS,CAAC,eAAe,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;AAuS5D;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC,UAAU,EACzC,OAAO,CAAC,EAAE,2BAA2B,GACpC,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAGzC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC,UAAU,EACzC,OAAO,CAAC,EAAE,2BAA2B,GACpC,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,CAGlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,GAAG,IAAI,CAGpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GAAG,cAAc,EACvC,EAAE,CAAC,EAAE,cAAc,GAClB,IAAI,CASN;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CACnB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC,UAAU,EACzC,OAAO,CAAC,EAAE;IAAC,GAAG,CAAC,EAAE,aAAa,CAAA;CAAC,GAC9B,SAAS,CAAC,UAAU,CAOtB;AAED;;;;;;;GAOG;AACH,iBAAS,uBAAuB,CAC9B,IAAI,EAAE,SAAS,CAAC,UAAU,EAC1B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAOT;AAED,OAAO,EAAC,uBAAuB,IAAI,QAAQ,EAAC,CAAC;AAE7C,wFAAwF;AACxF,wBAAsB,aAAa,CACjC,IAAI,EAAE,SAAS,CAAC,UAAU,EAC1B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,OAAO,CAAC,CAOlB"}
|
|
@@ -0,0 +1,330 @@
|
|
|
1
|
+
// math.gl
|
|
2
|
+
// SPDX-License-Identifier: MIT
|
|
3
|
+
// SPDX-FileCopyrightText: Copyright (c) 2013 Stephen Oney
|
|
4
|
+
// SPDX-FileCopyrightText: Copyright (c) 2023 Don McCurdy
|
|
5
|
+
// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
|
|
6
|
+
// SPDX-FileComment: Sources include jsep and expression-eval under MIT. Original source credits retained below.
|
|
7
|
+
/**
|
|
8
|
+
* Sources:
|
|
9
|
+
* - Copyright (c) 2013 Stephen Oney, http://jsep.from.so/, MIT License
|
|
10
|
+
* - Copyright (c) 2023 Don McCurdy, https://github.com/donmccurdy/expression-eval, MIT License
|
|
11
|
+
*/
|
|
12
|
+
/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-return, @typescript-eslint/restrict-plus-operands */
|
|
13
|
+
import { reportDiagnosticError } from "../diagnostic-log.js";
|
|
14
|
+
import jsepRuntime from "./vendor/jsep/runtime.js";
|
|
15
|
+
import { mergeFunctionLibraries } from "./function-libraries.js";
|
|
16
|
+
const jsep = jsepRuntime;
|
|
17
|
+
const DEFAULT_PRECEDENCE = {
|
|
18
|
+
'||': 1,
|
|
19
|
+
'&&': 2,
|
|
20
|
+
'|': 3,
|
|
21
|
+
'^': 4,
|
|
22
|
+
'&': 5,
|
|
23
|
+
'==': 6,
|
|
24
|
+
'!=': 6,
|
|
25
|
+
'===': 6,
|
|
26
|
+
'!==': 6,
|
|
27
|
+
'<': 7,
|
|
28
|
+
'>': 7,
|
|
29
|
+
'<=': 7,
|
|
30
|
+
'>=': 7,
|
|
31
|
+
'<<': 8,
|
|
32
|
+
'>>': 8,
|
|
33
|
+
'>>>': 8,
|
|
34
|
+
'+': 9,
|
|
35
|
+
'-': 9,
|
|
36
|
+
'*': 10,
|
|
37
|
+
'/': 10,
|
|
38
|
+
'%': 10
|
|
39
|
+
};
|
|
40
|
+
const binops = {
|
|
41
|
+
'||': (a, b) => a || b,
|
|
42
|
+
'&&': (a, b) => a && b,
|
|
43
|
+
'|': (a, b) => a | b,
|
|
44
|
+
'^': (a, b) => a ^ b,
|
|
45
|
+
'&': (a, b) => a & b,
|
|
46
|
+
'==': (a, b) => {
|
|
47
|
+
// biome-ignore lint/suspicious/noDoubleEquals: this operator implements JavaScript loose equality.
|
|
48
|
+
return a == b;
|
|
49
|
+
},
|
|
50
|
+
'!=': (a, b) => {
|
|
51
|
+
// biome-ignore lint/suspicious/noDoubleEquals: this operator implements JavaScript loose inequality.
|
|
52
|
+
return a != b;
|
|
53
|
+
},
|
|
54
|
+
'===': (a, b) => a === b,
|
|
55
|
+
'!==': (a, b) => a !== b,
|
|
56
|
+
'<': (a, b) => a < b,
|
|
57
|
+
'>': (a, b) => a > b,
|
|
58
|
+
'<=': (a, b) => a <= b,
|
|
59
|
+
'>=': (a, b) => a >= b,
|
|
60
|
+
'<<': (a, b) => a << b,
|
|
61
|
+
'>>': (a, b) => a >> b,
|
|
62
|
+
'>>>': (a, b) => a >>> b,
|
|
63
|
+
'+': (a, b) => {
|
|
64
|
+
// @ts-expect-error Addition intentionally supports JS coercion semantics.
|
|
65
|
+
return a + b;
|
|
66
|
+
},
|
|
67
|
+
'-': (a, b) => a - b,
|
|
68
|
+
'*': (a, b) => a * b,
|
|
69
|
+
'/': (a, b) => a / b,
|
|
70
|
+
'%': (a, b) => a % b
|
|
71
|
+
};
|
|
72
|
+
const unops = {
|
|
73
|
+
'-': (a) => -a,
|
|
74
|
+
'+': (a) => {
|
|
75
|
+
// eslint-disable-next-line no-implicit-coercion
|
|
76
|
+
return +a;
|
|
77
|
+
},
|
|
78
|
+
'~': (a) => ~a,
|
|
79
|
+
'!': (a) => !a
|
|
80
|
+
};
|
|
81
|
+
function evaluateArray(list, context) {
|
|
82
|
+
return list.map(value => evaluate(value, context));
|
|
83
|
+
}
|
|
84
|
+
/** Evaluates each expression in an array concurrently. */
|
|
85
|
+
async function evaluateArrayAsync(list, context) {
|
|
86
|
+
return await Promise.all(list.map(value => evaluateExpressionAsync(value, context)));
|
|
87
|
+
}
|
|
88
|
+
/** Resolves a member expression and preserves its receiver for method calls. */
|
|
89
|
+
function evaluateMember(node, context) {
|
|
90
|
+
const object = evaluate(node.object, context);
|
|
91
|
+
const key = node.computed
|
|
92
|
+
? evaluate(node.property, context)
|
|
93
|
+
: node.property.name;
|
|
94
|
+
if (/^__proto__|prototype|constructor$/.test(key)) {
|
|
95
|
+
throw new Error(`Access to member "${key}" disallowed.`);
|
|
96
|
+
}
|
|
97
|
+
return [object, object?.[key]];
|
|
98
|
+
}
|
|
99
|
+
/** Asynchronously resolves a member expression and its receiver. */
|
|
100
|
+
async function evaluateMemberAsync(node, context) {
|
|
101
|
+
const object = (await evaluateExpressionAsync(node.object, context));
|
|
102
|
+
const key = node.computed
|
|
103
|
+
? (await evaluateExpressionAsync(node.property, context))
|
|
104
|
+
: node.property.name;
|
|
105
|
+
if (/^__proto__|prototype|constructor$/.test(key)) {
|
|
106
|
+
throw new Error(`Access to member "${key}" disallowed.`);
|
|
107
|
+
}
|
|
108
|
+
return [object, object?.[key]];
|
|
109
|
+
}
|
|
110
|
+
/** Evaluates one expression node synchronously. */
|
|
111
|
+
// eslint-disable-next-line complexity
|
|
112
|
+
function evaluateExpression(node, context, options) {
|
|
113
|
+
const expression = node;
|
|
114
|
+
const mergedContext = mergeFunctionLibraries(context, options);
|
|
115
|
+
switch (expression.type) {
|
|
116
|
+
case 'ArrayExpression':
|
|
117
|
+
return evaluateArray(expression.elements, mergedContext);
|
|
118
|
+
case 'LogicalExpression':
|
|
119
|
+
case 'BinaryExpression':
|
|
120
|
+
if (expression.operator === '||') {
|
|
121
|
+
return (evaluate(expression.left, mergedContext) || evaluate(expression.right, mergedContext));
|
|
122
|
+
}
|
|
123
|
+
if (expression.operator === '&&') {
|
|
124
|
+
return (evaluate(expression.left, mergedContext) && evaluate(expression.right, mergedContext));
|
|
125
|
+
}
|
|
126
|
+
return binops[expression.operator](evaluate(expression.left, mergedContext), evaluate(expression.right, mergedContext));
|
|
127
|
+
case 'CallExpression': {
|
|
128
|
+
let caller;
|
|
129
|
+
let fn;
|
|
130
|
+
if (expression.callee.type === 'MemberExpression') {
|
|
131
|
+
const member = evaluateMember(expression.callee, mergedContext);
|
|
132
|
+
caller = member[0];
|
|
133
|
+
fn = member[1];
|
|
134
|
+
}
|
|
135
|
+
else {
|
|
136
|
+
fn = evaluate(expression.callee, mergedContext);
|
|
137
|
+
}
|
|
138
|
+
if (typeof fn !== 'function') {
|
|
139
|
+
return undefined;
|
|
140
|
+
}
|
|
141
|
+
return fn.apply(caller, evaluateArray(expression.arguments, mergedContext));
|
|
142
|
+
}
|
|
143
|
+
case 'ConditionalExpression':
|
|
144
|
+
return evaluate(expression.test, mergedContext)
|
|
145
|
+
? evaluate(expression.consequent, mergedContext)
|
|
146
|
+
: evaluate(expression.alternate, mergedContext);
|
|
147
|
+
case 'Identifier':
|
|
148
|
+
return mergedContext[expression.name];
|
|
149
|
+
case 'Literal':
|
|
150
|
+
return expression.value;
|
|
151
|
+
case 'MemberExpression':
|
|
152
|
+
return evaluateMember(expression, mergedContext)[1];
|
|
153
|
+
case 'ThisExpression':
|
|
154
|
+
return mergedContext;
|
|
155
|
+
case 'UnaryExpression':
|
|
156
|
+
return unops[expression.operator](evaluate(expression.argument, mergedContext));
|
|
157
|
+
default:
|
|
158
|
+
return undefined;
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
/** Evaluates a nested expression using an already-merged context. */
|
|
162
|
+
function evaluate(node, context) {
|
|
163
|
+
return evaluateExpression(node, context);
|
|
164
|
+
}
|
|
165
|
+
/**
|
|
166
|
+
* Evaluates a parsed expression asynchronously.
|
|
167
|
+
*
|
|
168
|
+
* @param node - Expression AST to evaluate.
|
|
169
|
+
* @param context - Named values and functions available to the expression.
|
|
170
|
+
* @param options - Function libraries to add to the context.
|
|
171
|
+
* @returns The resolved expression value.
|
|
172
|
+
*
|
|
173
|
+
* @remarks
|
|
174
|
+
* Function calls are awaited, including calls nested inside arrays, member
|
|
175
|
+
* expressions, conditionals, unary expressions, and binary expressions.
|
|
176
|
+
*/
|
|
177
|
+
// eslint-disable-next-line complexity
|
|
178
|
+
async function evaluateExpressionAsync(node, context, options) {
|
|
179
|
+
const expression = node;
|
|
180
|
+
const mergedContext = mergeFunctionLibraries(context, options);
|
|
181
|
+
switch (expression.type) {
|
|
182
|
+
case 'ArrayExpression':
|
|
183
|
+
return await evaluateArrayAsync(expression.elements, mergedContext);
|
|
184
|
+
case 'LogicalExpression':
|
|
185
|
+
case 'BinaryExpression':
|
|
186
|
+
if (expression.operator === '||') {
|
|
187
|
+
return ((await evaluateExpressionAsync(expression.left, mergedContext)) ||
|
|
188
|
+
(await evaluateExpressionAsync(expression.right, mergedContext)));
|
|
189
|
+
}
|
|
190
|
+
if (expression.operator === '&&') {
|
|
191
|
+
return ((await evaluateExpressionAsync(expression.left, mergedContext)) &&
|
|
192
|
+
(await evaluateExpressionAsync(expression.right, mergedContext)));
|
|
193
|
+
}
|
|
194
|
+
return binops[expression.operator](await evaluateExpressionAsync(expression.left, mergedContext), await evaluateExpressionAsync(expression.right, mergedContext));
|
|
195
|
+
case 'CallExpression': {
|
|
196
|
+
let caller;
|
|
197
|
+
let fn;
|
|
198
|
+
if (expression.callee.type === 'MemberExpression') {
|
|
199
|
+
const member = await evaluateMemberAsync(expression.callee, mergedContext);
|
|
200
|
+
caller = member[0];
|
|
201
|
+
fn = member[1];
|
|
202
|
+
}
|
|
203
|
+
else {
|
|
204
|
+
fn = (await evaluateExpressionAsync(expression.callee, mergedContext));
|
|
205
|
+
}
|
|
206
|
+
if (typeof fn !== 'function') {
|
|
207
|
+
return undefined;
|
|
208
|
+
}
|
|
209
|
+
return await fn.apply(caller, await evaluateArrayAsync(expression.arguments, mergedContext));
|
|
210
|
+
}
|
|
211
|
+
case 'ConditionalExpression':
|
|
212
|
+
return (await evaluateExpressionAsync(expression.test, mergedContext))
|
|
213
|
+
? await evaluateExpressionAsync(expression.consequent, mergedContext)
|
|
214
|
+
: await evaluateExpressionAsync(expression.alternate, mergedContext);
|
|
215
|
+
case 'Identifier':
|
|
216
|
+
return mergedContext[expression.name];
|
|
217
|
+
case 'Literal':
|
|
218
|
+
return expression.value;
|
|
219
|
+
case 'MemberExpression':
|
|
220
|
+
return (await evaluateMemberAsync(expression, mergedContext))[1];
|
|
221
|
+
case 'ThisExpression':
|
|
222
|
+
return mergedContext;
|
|
223
|
+
case 'UnaryExpression':
|
|
224
|
+
return unops[expression.operator](await evaluateExpressionAsync(expression.argument, mergedContext));
|
|
225
|
+
default:
|
|
226
|
+
return undefined;
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
/**
|
|
230
|
+
* Compiles an expression into a reusable synchronous evaluator.
|
|
231
|
+
*
|
|
232
|
+
* @param expression - Expression source or a previously parsed AST.
|
|
233
|
+
* @param options - Function libraries to add to each evaluation context.
|
|
234
|
+
* @returns A function that evaluates the expression against a context.
|
|
235
|
+
*/
|
|
236
|
+
export function compile(expression, options) {
|
|
237
|
+
const ast = parse(expression, options);
|
|
238
|
+
return (context) => evaluateWithDiagnostics(ast, context, options);
|
|
239
|
+
}
|
|
240
|
+
/**
|
|
241
|
+
* Compiles an expression into a reusable asynchronous evaluator.
|
|
242
|
+
*
|
|
243
|
+
* @param expression - Expression source or a previously parsed AST.
|
|
244
|
+
* @param options - Function libraries to add to each evaluation context.
|
|
245
|
+
* @returns A function that asynchronously evaluates the expression.
|
|
246
|
+
*/
|
|
247
|
+
export function compileAsync(expression, options) {
|
|
248
|
+
const ast = parse(expression, options);
|
|
249
|
+
return (context) => evaluateAsync(ast, context, options);
|
|
250
|
+
}
|
|
251
|
+
/**
|
|
252
|
+
* Registers a custom unary operator with the parser and evaluator.
|
|
253
|
+
*
|
|
254
|
+
* @param operator - Operator token to register.
|
|
255
|
+
* @param fn - Evaluator implementation for the operator.
|
|
256
|
+
*
|
|
257
|
+
* @remarks
|
|
258
|
+
* Registration changes module-global parser state and affects subsequent
|
|
259
|
+
* calls to {@link parse}.
|
|
260
|
+
*/
|
|
261
|
+
export function addUnaryOp(operator, fn) {
|
|
262
|
+
jsep.addUnaryOp(operator);
|
|
263
|
+
unops[operator] = fn;
|
|
264
|
+
}
|
|
265
|
+
/**
|
|
266
|
+
* Registers a custom binary operator with the parser and evaluator.
|
|
267
|
+
*
|
|
268
|
+
* @param operator - Operator token to register.
|
|
269
|
+
* @param precedenceOrFn - Parser precedence, or the evaluator implementation
|
|
270
|
+
* when using the default precedence for a built-in operator.
|
|
271
|
+
* @param fn - Evaluator implementation when an explicit precedence is given.
|
|
272
|
+
*
|
|
273
|
+
* @remarks
|
|
274
|
+
* Registration changes module-global parser state and affects subsequent
|
|
275
|
+
* calls to {@link parse}. New operators should provide explicit precedence.
|
|
276
|
+
*/
|
|
277
|
+
export function addBinaryOp(operator, precedenceOrFn, fn) {
|
|
278
|
+
if (fn) {
|
|
279
|
+
jsep.addBinaryOp(operator, precedenceOrFn);
|
|
280
|
+
binops[operator] = fn;
|
|
281
|
+
return;
|
|
282
|
+
}
|
|
283
|
+
jsep.addBinaryOp(operator, DEFAULT_PRECEDENCE[operator] || 1);
|
|
284
|
+
binops[operator] = precedenceOrFn;
|
|
285
|
+
}
|
|
286
|
+
/**
|
|
287
|
+
* Parses expression source into a JSEP abstract syntax tree.
|
|
288
|
+
*
|
|
289
|
+
* @param expression - Expression source or an existing AST.
|
|
290
|
+
* @returns A parsed AST, or the supplied AST unchanged.
|
|
291
|
+
* @throws If the expression string is not valid JSEP syntax.
|
|
292
|
+
*/
|
|
293
|
+
export function parse(expression, options) {
|
|
294
|
+
try {
|
|
295
|
+
return typeof expression === 'string' ? jsep(expression) : expression;
|
|
296
|
+
}
|
|
297
|
+
catch (error) {
|
|
298
|
+
reportDiagnosticError(options?.log, error);
|
|
299
|
+
throw error;
|
|
300
|
+
}
|
|
301
|
+
}
|
|
302
|
+
/**
|
|
303
|
+
* Evaluates a parsed expression synchronously.
|
|
304
|
+
*
|
|
305
|
+
* @param node - Expression AST to evaluate.
|
|
306
|
+
* @param context - Named values and functions available to the expression.
|
|
307
|
+
* @param options - Function libraries to add to the context.
|
|
308
|
+
* @returns The expression value.
|
|
309
|
+
*/
|
|
310
|
+
function evaluateWithDiagnostics(node, context, options) {
|
|
311
|
+
try {
|
|
312
|
+
return evaluateExpression(node, context, options);
|
|
313
|
+
}
|
|
314
|
+
catch (error) {
|
|
315
|
+
reportDiagnosticError(options?.log, error);
|
|
316
|
+
throw error;
|
|
317
|
+
}
|
|
318
|
+
}
|
|
319
|
+
export { evaluateWithDiagnostics as evaluate };
|
|
320
|
+
/** Evaluates an expression asynchronously and reports errors to the supplied logger. */
|
|
321
|
+
export async function evaluateAsync(node, context, options) {
|
|
322
|
+
try {
|
|
323
|
+
return await evaluateExpressionAsync(node, context, options);
|
|
324
|
+
}
|
|
325
|
+
catch (error) {
|
|
326
|
+
reportDiagnosticError(options?.log, error);
|
|
327
|
+
throw error;
|
|
328
|
+
}
|
|
329
|
+
}
|
|
330
|
+
//# sourceMappingURL=expression-eval.js.map
|