@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,293 @@
|
|
|
1
|
+
// math.gl
|
|
2
|
+
// SPDX-License-Identifier: MIT
|
|
3
|
+
// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
|
|
4
|
+
|
|
5
|
+
import {isColumnarScalarType, type ColumnarScalarType} from './scalar-type';
|
|
6
|
+
|
|
7
|
+
/** Scalar values supported by format-neutral columnar predicates. */
|
|
8
|
+
export type ColumnarPredicateValue = boolean | number | bigint | string | Date | Uint8Array;
|
|
9
|
+
|
|
10
|
+
/** Named value retained in a portable predicate until an executor binds it. */
|
|
11
|
+
export type ColumnarPredicateParameter = Readonly<{
|
|
12
|
+
/** Parameter name without a query-language prefix. */
|
|
13
|
+
parameter: string;
|
|
14
|
+
}>;
|
|
15
|
+
|
|
16
|
+
/** Concrete scalar or unresolved named value accepted while constructing a predicate. */
|
|
17
|
+
export type ColumnarPredicateInputValue = ColumnarPredicateValue | ColumnarPredicateParameter;
|
|
18
|
+
|
|
19
|
+
/** Runtime values used to bind named predicate parameters. */
|
|
20
|
+
export type ColumnarPredicateParameterValues = Readonly<Record<string, ColumnarPredicateValue>>;
|
|
21
|
+
|
|
22
|
+
/** Reference to a top-level or nested column. */
|
|
23
|
+
export type ColumnarPredicateProperty = {
|
|
24
|
+
property: string | readonly string[];
|
|
25
|
+
/** Explicit scalar conversions in innermost-to-outermost order. */
|
|
26
|
+
casts?: readonly ColumnarScalarType[];
|
|
27
|
+
};
|
|
28
|
+
|
|
29
|
+
export type ColumnarComparisonPredicate<
|
|
30
|
+
ValueT = ColumnarPredicateValue,
|
|
31
|
+
PropertyT extends ColumnarPredicateProperty = ColumnarPredicateProperty
|
|
32
|
+
> = {
|
|
33
|
+
op: '=' | '<>' | '<' | '<=' | '>' | '>=';
|
|
34
|
+
args: readonly [PropertyT, ValueT];
|
|
35
|
+
};
|
|
36
|
+
|
|
37
|
+
export type ColumnarInPredicate<
|
|
38
|
+
ValueT = ColumnarPredicateValue,
|
|
39
|
+
PropertyT extends ColumnarPredicateProperty = ColumnarPredicateProperty
|
|
40
|
+
> = {
|
|
41
|
+
op: 'in';
|
|
42
|
+
args: readonly [PropertyT, readonly ValueT[]];
|
|
43
|
+
};
|
|
44
|
+
|
|
45
|
+
export type ColumnarNullPredicate<
|
|
46
|
+
PropertyT extends ColumnarPredicateProperty = ColumnarPredicateProperty
|
|
47
|
+
> = {
|
|
48
|
+
op: 'isNull';
|
|
49
|
+
args: readonly [PropertyT];
|
|
50
|
+
};
|
|
51
|
+
|
|
52
|
+
export type ColumnarLogicalPredicate<
|
|
53
|
+
ValueT = ColumnarPredicateValue,
|
|
54
|
+
PropertyT extends ColumnarPredicateProperty = ColumnarPredicateProperty
|
|
55
|
+
> = {
|
|
56
|
+
op: 'and' | 'or';
|
|
57
|
+
args: readonly ColumnarPredicate<ValueT, PropertyT>[];
|
|
58
|
+
};
|
|
59
|
+
|
|
60
|
+
export type ColumnarNotPredicate<
|
|
61
|
+
ValueT = ColumnarPredicateValue,
|
|
62
|
+
PropertyT extends ColumnarPredicateProperty = ColumnarPredicateProperty
|
|
63
|
+
> = {
|
|
64
|
+
op: 'not';
|
|
65
|
+
args: readonly [ColumnarPredicate<ValueT, PropertyT>];
|
|
66
|
+
};
|
|
67
|
+
|
|
68
|
+
/** Small serializable expression tree suitable for scan planning and exact filtering. */
|
|
69
|
+
export type ColumnarPredicate<
|
|
70
|
+
ValueT = ColumnarPredicateValue,
|
|
71
|
+
PropertyT extends ColumnarPredicateProperty = ColumnarPredicateProperty
|
|
72
|
+
> =
|
|
73
|
+
| ColumnarComparisonPredicate<ValueT, PropertyT>
|
|
74
|
+
| ColumnarInPredicate<ValueT, PropertyT>
|
|
75
|
+
| ColumnarNullPredicate<PropertyT>
|
|
76
|
+
| ColumnarLogicalPredicate<ValueT, PropertyT>
|
|
77
|
+
| ColumnarNotPredicate<ValueT, PropertyT>;
|
|
78
|
+
|
|
79
|
+
/** Predicate form that may retain named parameters before physical execution. */
|
|
80
|
+
export type ParameterizedColumnarPredicate<
|
|
81
|
+
PropertyT extends ColumnarPredicateProperty = ColumnarPredicateProperty
|
|
82
|
+
> = ColumnarPredicate<ColumnarPredicateInputValue, PropertyT>;
|
|
83
|
+
|
|
84
|
+
export function getColumnarPredicateColumns<ValueT, PropertyT extends ColumnarPredicateProperty>(
|
|
85
|
+
predicate: ColumnarPredicate<ValueT, PropertyT>
|
|
86
|
+
): string[] {
|
|
87
|
+
return [...new Set(getColumnarPredicatePaths(predicate).map(path => path[0]))];
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
export function getColumnarPredicatePath(property: ColumnarPredicateProperty): string[] {
|
|
91
|
+
return typeof property.property === 'string' ? [property.property] : [...property.property];
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
export function getColumnarPredicatePaths<ValueT, PropertyT extends ColumnarPredicateProperty>(
|
|
95
|
+
predicate: ColumnarPredicate<ValueT, PropertyT>
|
|
96
|
+
): string[][] {
|
|
97
|
+
const paths = new Map<string, string[]>();
|
|
98
|
+
visitColumnarPredicate(predicate, child => {
|
|
99
|
+
if ('property' in child.args[0]) {
|
|
100
|
+
const path = getColumnarPredicatePath(child.args[0]);
|
|
101
|
+
paths.set(path.join('\0'), path);
|
|
102
|
+
}
|
|
103
|
+
});
|
|
104
|
+
return [...paths.values()];
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
/** Returns unresolved named parameter names in their first-occurrence order. */
|
|
108
|
+
export function getColumnarPredicateParameterNames<PropertyT extends ColumnarPredicateProperty>(
|
|
109
|
+
predicate: ParameterizedColumnarPredicate<PropertyT>
|
|
110
|
+
): string[] {
|
|
111
|
+
const parameterNames = new Set<string>();
|
|
112
|
+
visitColumnarPredicate(predicate, child => {
|
|
113
|
+
if (child.op === 'and' || child.op === 'or' || child.op === 'not' || child.op === 'isNull') {
|
|
114
|
+
return;
|
|
115
|
+
}
|
|
116
|
+
const values = child.op === 'in' ? child.args[1] : [child.args[1]];
|
|
117
|
+
for (const value of values) {
|
|
118
|
+
if (isColumnarPredicateParameter(value)) {
|
|
119
|
+
parameterNames.add(value.parameter);
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
});
|
|
123
|
+
return [...parameterNames];
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
export function copyColumnarPredicate(predicate: ColumnarPredicate): ColumnarPredicate {
|
|
127
|
+
if (predicate.op === 'and' || predicate.op === 'or') {
|
|
128
|
+
return {op: predicate.op, args: predicate.args.map(copyColumnarPredicate)};
|
|
129
|
+
}
|
|
130
|
+
if (predicate.op === 'not') {
|
|
131
|
+
return {op: 'not', args: [copyColumnarPredicate(predicate.args[0])]};
|
|
132
|
+
}
|
|
133
|
+
const leaf = predicate as
|
|
134
|
+
| ColumnarComparisonPredicate
|
|
135
|
+
| ColumnarInPredicate
|
|
136
|
+
| ColumnarNullPredicate;
|
|
137
|
+
const property = copyColumnarPredicateProperty({
|
|
138
|
+
...leaf.args[0],
|
|
139
|
+
property: [...getColumnarPredicatePath(leaf.args[0])]
|
|
140
|
+
});
|
|
141
|
+
if (leaf.op === 'isNull') return {op: 'isNull', args: [property]};
|
|
142
|
+
if (leaf.op === 'in') {
|
|
143
|
+
return {op: 'in', args: [property, leaf.args[1].map(copyColumnarPredicateValue)]};
|
|
144
|
+
}
|
|
145
|
+
return {op: leaf.op, args: [property, copyColumnarPredicateValue(leaf.args[1])]};
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
export function validateColumnarPredicate(
|
|
149
|
+
predicate: ColumnarPredicate<unknown>,
|
|
150
|
+
availableColumns: ReadonlySet<string>
|
|
151
|
+
): void {
|
|
152
|
+
visitColumnarPredicate(predicate, child => {
|
|
153
|
+
if (child.op === 'and' || child.op === 'or') {
|
|
154
|
+
if (child.args.length < 2)
|
|
155
|
+
throw new Error(`Columnar predicate ${child.op} requires at least two child predicates`);
|
|
156
|
+
return;
|
|
157
|
+
}
|
|
158
|
+
if (child.op === 'not') return;
|
|
159
|
+
const leaf = child as ColumnarComparisonPredicate | ColumnarInPredicate | ColumnarNullPredicate;
|
|
160
|
+
const casts = leaf.args[0].casts;
|
|
161
|
+
if (
|
|
162
|
+
casts !== undefined &&
|
|
163
|
+
(!Array.isArray(casts) ||
|
|
164
|
+
!casts.length ||
|
|
165
|
+
casts.length > 64 ||
|
|
166
|
+
Array.from(casts).some(type => !isColumnarScalarType(type)))
|
|
167
|
+
)
|
|
168
|
+
throw new Error('Invalid columnar predicate casts');
|
|
169
|
+
const path = getColumnarPredicatePath(leaf.args[0]);
|
|
170
|
+
if (!path.length || path.some(component => !component)) {
|
|
171
|
+
throw new Error('Columnar predicate property path must contain non-empty strings');
|
|
172
|
+
}
|
|
173
|
+
if (!availableColumns.has(path[0]))
|
|
174
|
+
throw new Error(`Columnar predicate column not found: ${path.join('.')}`);
|
|
175
|
+
if (leaf.op === 'in' && leaf.args[1].length === 0) {
|
|
176
|
+
throw new Error('Columnar predicate in requires at least one value');
|
|
177
|
+
}
|
|
178
|
+
});
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
/** Returns whether a predicate value is an unresolved named parameter. */
|
|
182
|
+
export function isColumnarPredicateParameter(value: unknown): value is ColumnarPredicateParameter {
|
|
183
|
+
const parameterValue = value as {parameter?: unknown};
|
|
184
|
+
return (
|
|
185
|
+
typeof value === 'object' &&
|
|
186
|
+
value !== null &&
|
|
187
|
+
!Array.isArray(value) &&
|
|
188
|
+
Object.keys(value).length === 1 &&
|
|
189
|
+
Object.prototype.hasOwnProperty.call(value, 'parameter') &&
|
|
190
|
+
typeof parameterValue.parameter === 'string' &&
|
|
191
|
+
parameterValue.parameter.length > 0
|
|
192
|
+
);
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
/** Returns whether a runtime value belongs to the portable predicate scalar set. */
|
|
196
|
+
export function isColumnarPredicateValue(value: unknown): value is ColumnarPredicateValue {
|
|
197
|
+
return (
|
|
198
|
+
typeof value === 'boolean' ||
|
|
199
|
+
typeof value === 'bigint' ||
|
|
200
|
+
typeof value === 'string' ||
|
|
201
|
+
(typeof value === 'number' && Number.isFinite(value)) ||
|
|
202
|
+
(value instanceof Date && Number.isFinite(value.getTime())) ||
|
|
203
|
+
value instanceof Uint8Array
|
|
204
|
+
);
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
/** Binds every named parameter without mutating the portable predicate. */
|
|
208
|
+
export function bindColumnarPredicateParameters<
|
|
209
|
+
PropertyT extends ColumnarPredicateProperty = ColumnarPredicateProperty
|
|
210
|
+
>(
|
|
211
|
+
predicate: ParameterizedColumnarPredicate<PropertyT>,
|
|
212
|
+
parameters: ColumnarPredicateParameterValues
|
|
213
|
+
): ColumnarPredicate<ColumnarPredicateValue, PropertyT> {
|
|
214
|
+
switch (predicate.op) {
|
|
215
|
+
case 'and':
|
|
216
|
+
case 'or':
|
|
217
|
+
return {
|
|
218
|
+
op: predicate.op,
|
|
219
|
+
args: predicate.args.map(child => bindColumnarPredicateParameters(child, parameters))
|
|
220
|
+
};
|
|
221
|
+
case 'not':
|
|
222
|
+
return {
|
|
223
|
+
op: 'not',
|
|
224
|
+
args: [bindColumnarPredicateParameters(predicate.args[0], parameters)]
|
|
225
|
+
};
|
|
226
|
+
case 'isNull':
|
|
227
|
+
return {op: 'isNull', args: [copyColumnarPredicateProperty(predicate.args[0])]};
|
|
228
|
+
case 'in':
|
|
229
|
+
return {
|
|
230
|
+
op: 'in',
|
|
231
|
+
args: [
|
|
232
|
+
copyColumnarPredicateProperty(predicate.args[0]),
|
|
233
|
+
predicate.args[1].map(value => bindColumnarPredicateValue(value, parameters))
|
|
234
|
+
]
|
|
235
|
+
};
|
|
236
|
+
default:
|
|
237
|
+
return {
|
|
238
|
+
op: predicate.op,
|
|
239
|
+
args: [
|
|
240
|
+
copyColumnarPredicateProperty(predicate.args[0]),
|
|
241
|
+
bindColumnarPredicateValue(predicate.args[1], parameters)
|
|
242
|
+
]
|
|
243
|
+
};
|
|
244
|
+
}
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
function visitColumnarPredicate<ValueT, PropertyT extends ColumnarPredicateProperty>(
|
|
248
|
+
predicate: ColumnarPredicate<ValueT, PropertyT>,
|
|
249
|
+
visitor: (predicate: ColumnarPredicate<ValueT, PropertyT>) => void
|
|
250
|
+
): void {
|
|
251
|
+
visitor(predicate);
|
|
252
|
+
if (predicate.op === 'and' || predicate.op === 'or')
|
|
253
|
+
predicate.args.forEach(child => visitColumnarPredicate(child, visitor));
|
|
254
|
+
else if (predicate.op === 'not') visitColumnarPredicate(predicate.args[0], visitor);
|
|
255
|
+
}
|
|
256
|
+
|
|
257
|
+
/** Resolves one parameter reference or returns an already concrete scalar. */
|
|
258
|
+
function bindColumnarPredicateValue(
|
|
259
|
+
value: ColumnarPredicateInputValue,
|
|
260
|
+
parameters: ColumnarPredicateParameterValues
|
|
261
|
+
): ColumnarPredicateValue {
|
|
262
|
+
if (!isColumnarPredicateParameter(value)) return value;
|
|
263
|
+
if (!Object.prototype.hasOwnProperty.call(parameters, value.parameter)) {
|
|
264
|
+
throw new Error(`Columnar predicate parameter ":${value.parameter}" requires a value`);
|
|
265
|
+
}
|
|
266
|
+
const parameterValue = parameters[value.parameter];
|
|
267
|
+
if (isColumnarPredicateParameter(parameterValue)) {
|
|
268
|
+
throw new Error(
|
|
269
|
+
`Columnar predicate parameter ":${value.parameter}" cannot reference another parameter`
|
|
270
|
+
);
|
|
271
|
+
}
|
|
272
|
+
if (!isColumnarPredicateValue(parameterValue)) {
|
|
273
|
+
throw new Error(`Columnar predicate parameter ":${value.parameter}" has an unsupported value`);
|
|
274
|
+
}
|
|
275
|
+
return copyColumnarPredicateValue(parameterValue);
|
|
276
|
+
}
|
|
277
|
+
|
|
278
|
+
/** Copies a property while preserving its backend-specific property subtype. */
|
|
279
|
+
function copyColumnarPredicateProperty<PropertyT extends ColumnarPredicateProperty>(
|
|
280
|
+
property: PropertyT
|
|
281
|
+
): PropertyT {
|
|
282
|
+
return {
|
|
283
|
+
...property,
|
|
284
|
+
...(property.casts ? {casts: [...property.casts]} : {}),
|
|
285
|
+
property: typeof property.property === 'string' ? property.property : [...property.property]
|
|
286
|
+
} as PropertyT;
|
|
287
|
+
}
|
|
288
|
+
|
|
289
|
+
function copyColumnarPredicateValue(value: ColumnarPredicateValue): ColumnarPredicateValue {
|
|
290
|
+
if (value instanceof Uint8Array) return value.slice();
|
|
291
|
+
if (value instanceof Date) return new Date(value.getTime());
|
|
292
|
+
return value;
|
|
293
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
// math.gl
|
|
2
|
+
// SPDX-License-Identifier: MIT
|
|
3
|
+
// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
|
|
4
|
+
|
|
5
|
+
/** Recoverable data errors; programming, binding and cancellation errors remain ordinary exceptions. */
|
|
6
|
+
export type ExpressionEvaluationErrorCode = 'domain' | 'conversion' | 'overflow' | 'divisionByZero';
|
|
7
|
+
const brand = Symbol.for('@math.gl/core/ExpressionEvaluationError');
|
|
8
|
+
const codes: readonly string[] = ['domain', 'conversion', 'overflow', 'divisionByZero'];
|
|
9
|
+
/** A classified scalar evaluation failure, eligible for explicit TRY recovery. */
|
|
10
|
+
export class ExpressionEvaluationError extends Error {
|
|
11
|
+
override readonly name = 'ExpressionEvaluationError';
|
|
12
|
+
readonly [brand] = true;
|
|
13
|
+
constructor(
|
|
14
|
+
readonly code: ExpressionEvaluationErrorCode,
|
|
15
|
+
message: string
|
|
16
|
+
) {
|
|
17
|
+
super(message);
|
|
18
|
+
if (!codes.includes(code)) throw new TypeError('Unknown Arrow evaluation error code');
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
/** Recognizes classified errors across separately bundled ESM/CommonJS function entry points. */
|
|
22
|
+
export function isExpressionEvaluationError(error: unknown): error is ExpressionEvaluationError {
|
|
23
|
+
return (
|
|
24
|
+
typeof error === 'object' &&
|
|
25
|
+
error !== null &&
|
|
26
|
+
(error as Record<PropertyKey, unknown>)[brand] === true &&
|
|
27
|
+
codes.includes((error as ExpressionEvaluationError).code)
|
|
28
|
+
);
|
|
29
|
+
}
|