@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,92 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Portable, JSON-safe vocabulary for data-driven visualization scales.
|
|
3
|
+
* A specification describes an unresolved scale. It never contains an evaluator,
|
|
4
|
+
* so it can be serialized, transferred to workers, or used by other renderers.
|
|
5
|
+
*/
|
|
6
|
+
export type ScaleColor = readonly [number, number, number, number];
|
|
7
|
+
/** Numeric or categorical value accepted by a scale. */
|
|
8
|
+
export type ScaleValue = number | string;
|
|
9
|
+
/** Fixed values or a request to derive the domain from a column. */
|
|
10
|
+
export type ScaleDomain = {
|
|
11
|
+
readonly type: 'fixed';
|
|
12
|
+
readonly values: readonly ScaleValue[];
|
|
13
|
+
} | {
|
|
14
|
+
readonly type: 'extent';
|
|
15
|
+
readonly column: string;
|
|
16
|
+
readonly includeZero?: boolean;
|
|
17
|
+
} | {
|
|
18
|
+
readonly type: 'symmetric';
|
|
19
|
+
readonly column: string;
|
|
20
|
+
readonly pivot: number;
|
|
21
|
+
} | {
|
|
22
|
+
readonly type: 'percentile';
|
|
23
|
+
readonly column: string;
|
|
24
|
+
readonly lower: number;
|
|
25
|
+
readonly upper: number;
|
|
26
|
+
} | {
|
|
27
|
+
readonly type: 'categories';
|
|
28
|
+
readonly column: string;
|
|
29
|
+
readonly order?: 'sorted' | 'first-seen';
|
|
30
|
+
};
|
|
31
|
+
/** Numeric output, explicit colors, or a named palette to resolve. */
|
|
32
|
+
export type ScaleRange = {
|
|
33
|
+
readonly type: 'numeric';
|
|
34
|
+
readonly values: readonly number[];
|
|
35
|
+
} | {
|
|
36
|
+
readonly type: 'colors';
|
|
37
|
+
/** Color values remain in the declared encoding, without implicit clipping. */
|
|
38
|
+
readonly values: readonly ScaleColor[];
|
|
39
|
+
} | {
|
|
40
|
+
readonly type: 'palette';
|
|
41
|
+
readonly name: string;
|
|
42
|
+
readonly count?: number;
|
|
43
|
+
};
|
|
44
|
+
/** A scale's storage type is distinct from its primaries, transfer and interpolation. */
|
|
45
|
+
export type ScaleColorEncoding = {
|
|
46
|
+
readonly primaries: 'srgb' | 'display-p3' | 'rec2020';
|
|
47
|
+
readonly transfer: 'srgb' | 'linear' | 'pq' | 'hlg';
|
|
48
|
+
readonly format: 'rgba8unorm' | 'rgba16unorm' | 'rgba16float' | 'rgba32float';
|
|
49
|
+
/** Scene-linear reference white, when known. */
|
|
50
|
+
readonly referenceWhiteNits?: number;
|
|
51
|
+
};
|
|
52
|
+
/** Serializable scale inputs and optional presentation metadata. */
|
|
53
|
+
export type ScaleSpec = {
|
|
54
|
+
readonly id?: string;
|
|
55
|
+
readonly type: 'linear' | 'sqrt' | 'log' | 'symlog' | 'sequential' | 'diverging' | 'ordinal' | 'quantize' | 'quantile' | 'threshold' | 'piecewise';
|
|
56
|
+
readonly domain: ScaleDomain;
|
|
57
|
+
readonly range: ScaleRange;
|
|
58
|
+
readonly clamp?: boolean;
|
|
59
|
+
readonly pivot?: number;
|
|
60
|
+
readonly interpolation?: 'srgb' | 'linear-srgb' | 'oklab' | 'jzazbz';
|
|
61
|
+
readonly encoding?: ScaleColorEncoding;
|
|
62
|
+
readonly nullColor?: ScaleColor;
|
|
63
|
+
readonly underColor?: ScaleColor;
|
|
64
|
+
readonly overColor?: ScaleColor;
|
|
65
|
+
readonly label?: string;
|
|
66
|
+
readonly units?: string;
|
|
67
|
+
};
|
|
68
|
+
/**
|
|
69
|
+
* The resolved descriptor records *actual* domain and class breaks, not an
|
|
70
|
+
* inferred palette. Consumers can generate faithful ticks and legend labels.
|
|
71
|
+
*/
|
|
72
|
+
export type ResolvedScaleDescriptor = Omit<ScaleSpec, 'domain' | 'range'> & {
|
|
73
|
+
readonly domain: readonly ScaleValue[];
|
|
74
|
+
readonly range: Exclude<ScaleRange, {
|
|
75
|
+
readonly type: 'palette';
|
|
76
|
+
}>;
|
|
77
|
+
readonly thresholds?: readonly number[];
|
|
78
|
+
readonly palette?: string;
|
|
79
|
+
};
|
|
80
|
+
/** Runtime evaluator is intentionally separate from the JSON-safe descriptor. */
|
|
81
|
+
export type ResolvedScale = {
|
|
82
|
+
readonly descriptor: ResolvedScaleDescriptor;
|
|
83
|
+
sample(value: ScaleValue | null): number | ScaleColor | null;
|
|
84
|
+
};
|
|
85
|
+
/** Validates the serializable contract without resolving data-dependent domains. */
|
|
86
|
+
export declare function validateScaleSpec(spec: ScaleSpec): ScaleSpec;
|
|
87
|
+
/**
|
|
88
|
+
* Binds an already resolved domain/range to the same evaluator that produces
|
|
89
|
+
* layer colors. No independent legend interpolation is performed here.
|
|
90
|
+
*/
|
|
91
|
+
export declare function createResolvedScale(descriptor: ResolvedScaleDescriptor, sample: ResolvedScale['sample']): ResolvedScale;
|
|
92
|
+
//# sourceMappingURL=scale-types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scale-types.d.ts","sourceRoot":"","sources":["../../src/scales/scale-types.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
// math.gl
|
|
2
|
+
// SPDX-License-Identifier: MIT
|
|
3
|
+
// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
|
|
4
|
+
function assertFinite(value, description) {
|
|
5
|
+
if (!Number.isFinite(value))
|
|
6
|
+
throw new Error(`${description} must be finite`);
|
|
7
|
+
}
|
|
8
|
+
function checkColor(color, label) {
|
|
9
|
+
if (!Array.isArray(color) || color.length !== 4) {
|
|
10
|
+
throw new Error(`${label} must contain four channels`);
|
|
11
|
+
}
|
|
12
|
+
color.forEach((channel, index) => assertFinite(channel, `${label}[${index}]`));
|
|
13
|
+
}
|
|
14
|
+
/** Validates the serializable contract without resolving data-dependent domains. */
|
|
15
|
+
export function validateScaleSpec(spec) {
|
|
16
|
+
if (!spec || typeof spec !== 'object')
|
|
17
|
+
throw new Error('Scale specification is required');
|
|
18
|
+
const kinds = [
|
|
19
|
+
'linear',
|
|
20
|
+
'sqrt',
|
|
21
|
+
'log',
|
|
22
|
+
'symlog',
|
|
23
|
+
'sequential',
|
|
24
|
+
'diverging',
|
|
25
|
+
'ordinal',
|
|
26
|
+
'quantize',
|
|
27
|
+
'quantile',
|
|
28
|
+
'threshold',
|
|
29
|
+
'piecewise'
|
|
30
|
+
];
|
|
31
|
+
if (!kinds.includes(spec.type))
|
|
32
|
+
throw new Error(`Unsupported scale type: ${spec.type}`);
|
|
33
|
+
const minimumStops = spec.type === 'ordinal' ? 1 : 2;
|
|
34
|
+
const domain = spec.domain;
|
|
35
|
+
if (!domain || typeof domain !== 'object')
|
|
36
|
+
throw new Error('Scale domain is required');
|
|
37
|
+
switch (domain.type) {
|
|
38
|
+
case 'fixed':
|
|
39
|
+
if (!Array.isArray(domain.values) ||
|
|
40
|
+
domain.values.length < minimumStops ||
|
|
41
|
+
domain.values.some(value => typeof value !== 'string' && (typeof value !== 'number' || !Number.isFinite(value))))
|
|
42
|
+
throw new Error(`Fixed scale domain requires at least ${minimumStops} finite or string values`);
|
|
43
|
+
break;
|
|
44
|
+
case 'extent':
|
|
45
|
+
case 'categories':
|
|
46
|
+
if (typeof domain.column !== 'string' || !domain.column) {
|
|
47
|
+
throw new Error('Scale domain requires a column');
|
|
48
|
+
}
|
|
49
|
+
break;
|
|
50
|
+
case 'symmetric':
|
|
51
|
+
if (!domain.column)
|
|
52
|
+
throw new Error('Symmetric domain requires a column');
|
|
53
|
+
assertFinite(domain.pivot, 'Scale pivot');
|
|
54
|
+
break;
|
|
55
|
+
case 'percentile':
|
|
56
|
+
if (!domain.column ||
|
|
57
|
+
!Number.isFinite(domain.lower) ||
|
|
58
|
+
!Number.isFinite(domain.upper) ||
|
|
59
|
+
domain.lower < 0 ||
|
|
60
|
+
domain.upper > 1 ||
|
|
61
|
+
domain.lower >= domain.upper) {
|
|
62
|
+
throw new Error('Percentile domain requires 0 <= lower < upper <= 1');
|
|
63
|
+
}
|
|
64
|
+
break;
|
|
65
|
+
default:
|
|
66
|
+
throw new Error('Unsupported scale domain');
|
|
67
|
+
}
|
|
68
|
+
if (!spec.range)
|
|
69
|
+
throw new Error('Scale range is required');
|
|
70
|
+
switch (spec.range.type) {
|
|
71
|
+
case 'numeric':
|
|
72
|
+
if (spec.range.values.length < minimumStops)
|
|
73
|
+
throw new Error(`Numeric range requires at least ${minimumStops} values`);
|
|
74
|
+
spec.range.values.forEach(value => assertFinite(value, 'Numeric range'));
|
|
75
|
+
break;
|
|
76
|
+
case 'colors':
|
|
77
|
+
if (spec.range.values.length < minimumStops)
|
|
78
|
+
throw new Error(`Color range requires at least ${minimumStops} colors`);
|
|
79
|
+
spec.range.values.forEach((value, index) => checkColor(value, `Color stop ${index}`));
|
|
80
|
+
break;
|
|
81
|
+
case 'palette':
|
|
82
|
+
if (!spec.range.name ||
|
|
83
|
+
(spec.range.count !== undefined &&
|
|
84
|
+
(!Number.isSafeInteger(spec.range.count) || spec.range.count < 2))) {
|
|
85
|
+
throw new Error('Palette requires a name and optional positive count >= 2');
|
|
86
|
+
}
|
|
87
|
+
break;
|
|
88
|
+
default:
|
|
89
|
+
throw new Error('Unsupported scale range');
|
|
90
|
+
}
|
|
91
|
+
if (spec.pivot !== undefined)
|
|
92
|
+
assertFinite(spec.pivot, 'Scale pivot');
|
|
93
|
+
if (spec.encoding?.referenceWhiteNits !== undefined &&
|
|
94
|
+
(!Number.isFinite(spec.encoding.referenceWhiteNits) || spec.encoding.referenceWhiteNits <= 0)) {
|
|
95
|
+
throw new Error('referenceWhiteNits must be a positive finite number');
|
|
96
|
+
}
|
|
97
|
+
for (const key of ['nullColor', 'underColor', 'overColor']) {
|
|
98
|
+
if (spec[key])
|
|
99
|
+
checkColor(spec[key], key);
|
|
100
|
+
}
|
|
101
|
+
return spec;
|
|
102
|
+
}
|
|
103
|
+
/**
|
|
104
|
+
* Binds an already resolved domain/range to the same evaluator that produces
|
|
105
|
+
* layer colors. No independent legend interpolation is performed here.
|
|
106
|
+
*/
|
|
107
|
+
export function createResolvedScale(descriptor, sample) {
|
|
108
|
+
validateScaleSpec({
|
|
109
|
+
...descriptor,
|
|
110
|
+
domain: { type: 'fixed', values: descriptor.domain }
|
|
111
|
+
});
|
|
112
|
+
if (descriptor.thresholds) {
|
|
113
|
+
if (descriptor.thresholds.some((value, i) => !Number.isFinite(value) || (i > 0 && value <= descriptor.thresholds[i - 1]))) {
|
|
114
|
+
throw new Error('Thresholds must be finite and strictly ordered');
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
return Object.freeze({ descriptor, sample });
|
|
118
|
+
}
|
|
119
|
+
//# sourceMappingURL=scale-types.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scale-types.js","sourceRoot":"","sources":["../../src/scales/scale-types.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { RecordBatch } from 'apache-arrow';
|
|
2
|
+
import type { ScaleDomain, ScaleValue } from "./scale-types.js";
|
|
3
|
+
export type StreamingDomainOptions = {
|
|
4
|
+
/** Maximum retained weighted samples per referenced percentile column. */
|
|
5
|
+
quantileCapacity?: number;
|
|
6
|
+
/** Also keep quantile sketches for these columns, e.g. SCALE_QUANTILE inputs. */
|
|
7
|
+
quantileColumns?: readonly string[];
|
|
8
|
+
};
|
|
9
|
+
/**
|
|
10
|
+
* Incremental domain accumulator. Each Arrow batch is visited once per
|
|
11
|
+
* referenced column, even when multiple visual scales depend on that column.
|
|
12
|
+
*/
|
|
13
|
+
export declare function createStreamingDomainAccumulator(domains: readonly ScaleDomain[], options?: StreamingDomainOptions): {
|
|
14
|
+
update(batch: RecordBatch): void;
|
|
15
|
+
result(): readonly (readonly ScaleValue[])[];
|
|
16
|
+
quantileBreaks(column: string, classes: number): readonly number[];
|
|
17
|
+
};
|
|
18
|
+
//# sourceMappingURL=streaming-domains.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"streaming-domains.d.ts","sourceRoot":"","sources":["../../src/scales/streaming-domains.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAC,WAAW,EAAE,UAAU,EAAC,yBAAsB;AAa3D,MAAM,MAAM,sBAAsB,GAAG;IACnC,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,OAAO,GAAE,sBAA2B,GACnC;IACD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,MAAM,IAAI,SAAS,CAAC,SAAS,UAAU,EAAE,CAAC,EAAE,CAAC;IAC7C,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CACpE,CAgGA"}
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
// math.gl
|
|
2
|
+
// SPDX-License-Identifier: MIT
|
|
3
|
+
// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
|
|
4
|
+
import { arrowScaleValue } from "./arrow-domains.js";
|
|
5
|
+
import { ScaleQuantileSketch } from "./quantile-sketch.js";
|
|
6
|
+
/**
|
|
7
|
+
* Incremental domain accumulator. Each Arrow batch is visited once per
|
|
8
|
+
* referenced column, even when multiple visual scales depend on that column.
|
|
9
|
+
*/
|
|
10
|
+
export function createStreamingDomainAccumulator(domains, options = {}) {
|
|
11
|
+
const columns = new Map();
|
|
12
|
+
const quantileColumns = new Set(options.quantileColumns ?? []);
|
|
13
|
+
for (const domain of domains) {
|
|
14
|
+
if (domain.type === 'fixed')
|
|
15
|
+
continue;
|
|
16
|
+
const previous = columns.get(domain.column);
|
|
17
|
+
if (previous) {
|
|
18
|
+
if ((domain.type === 'percentile' || quantileColumns.has(domain.column)) &&
|
|
19
|
+
!previous.sketch) {
|
|
20
|
+
previous.sketch = new ScaleQuantileSketch(options.quantileCapacity);
|
|
21
|
+
}
|
|
22
|
+
if (domain.type === 'categories')
|
|
23
|
+
previous.categories ?? (previous.categories = new Set());
|
|
24
|
+
continue;
|
|
25
|
+
}
|
|
26
|
+
columns.set(domain.column, {
|
|
27
|
+
min: Infinity,
|
|
28
|
+
max: -Infinity,
|
|
29
|
+
seen: 0,
|
|
30
|
+
...(domain.type === 'categories' ? { categories: new Set() } : {}),
|
|
31
|
+
...(domain.type === 'percentile' || quantileColumns.has(domain.column)
|
|
32
|
+
? { sketch: new ScaleQuantileSketch(options.quantileCapacity) }
|
|
33
|
+
: {})
|
|
34
|
+
});
|
|
35
|
+
}
|
|
36
|
+
for (const name of quantileColumns) {
|
|
37
|
+
if (!columns.has(name))
|
|
38
|
+
columns.set(name, {
|
|
39
|
+
min: Infinity,
|
|
40
|
+
max: -Infinity,
|
|
41
|
+
seen: 0,
|
|
42
|
+
sketch: new ScaleQuantileSketch(options.quantileCapacity)
|
|
43
|
+
});
|
|
44
|
+
}
|
|
45
|
+
return {
|
|
46
|
+
update(batch) {
|
|
47
|
+
for (const [name, state] of columns) {
|
|
48
|
+
const vector = batch.getChild(name);
|
|
49
|
+
if (!vector)
|
|
50
|
+
throw new Error(`Missing scale column: ${name}`);
|
|
51
|
+
for (let row = 0; row < vector.length; row++) {
|
|
52
|
+
const value = arrowScaleValue(vector.get(row));
|
|
53
|
+
if (value === null || value === undefined)
|
|
54
|
+
continue;
|
|
55
|
+
if (typeof value === 'string') {
|
|
56
|
+
state.categories?.add(value);
|
|
57
|
+
}
|
|
58
|
+
else if (typeof value === 'number' && Number.isFinite(value)) {
|
|
59
|
+
state.categories?.add(value);
|
|
60
|
+
state.seen++;
|
|
61
|
+
state.min = Math.min(state.min, value);
|
|
62
|
+
state.max = Math.max(state.max, value);
|
|
63
|
+
state.sketch?.add(value);
|
|
64
|
+
}
|
|
65
|
+
else {
|
|
66
|
+
throw new Error(`Scale column ${name} has unsupported value at row ${row}`);
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
},
|
|
71
|
+
result() {
|
|
72
|
+
return domains.map(domain => {
|
|
73
|
+
if (domain.type === 'fixed')
|
|
74
|
+
return [...domain.values];
|
|
75
|
+
const state = columns.get(domain.column);
|
|
76
|
+
if (domain.type === 'categories') {
|
|
77
|
+
const labels = [...state.categories];
|
|
78
|
+
return domain.order === 'first-seen'
|
|
79
|
+
? labels
|
|
80
|
+
: labels.sort((a, b) => typeof a === 'number' && typeof b === 'number' ? a - b : a < b ? -1 : a > b ? 1 : 0);
|
|
81
|
+
}
|
|
82
|
+
if (!state.seen)
|
|
83
|
+
return [];
|
|
84
|
+
if (domain.type === 'percentile') {
|
|
85
|
+
return [state.sketch.quantile(domain.lower), state.sketch.quantile(domain.upper)];
|
|
86
|
+
}
|
|
87
|
+
if (domain.type === 'symmetric') {
|
|
88
|
+
const radius = Math.max(Math.abs(state.min - domain.pivot), Math.abs(state.max - domain.pivot));
|
|
89
|
+
return [domain.pivot - radius, domain.pivot + radius];
|
|
90
|
+
}
|
|
91
|
+
if (domain.includeZero)
|
|
92
|
+
return [Math.min(state.min, 0), Math.max(state.max, 0)];
|
|
93
|
+
return [state.min, state.max];
|
|
94
|
+
});
|
|
95
|
+
},
|
|
96
|
+
quantileBreaks(column, classes) {
|
|
97
|
+
if (!Number.isSafeInteger(classes) || classes < 2) {
|
|
98
|
+
throw new Error('Scale class count must be at least two');
|
|
99
|
+
}
|
|
100
|
+
const sketch = columns.get(column)?.sketch;
|
|
101
|
+
if (!sketch)
|
|
102
|
+
throw new Error(`Column ${column} has no quantile sketch`);
|
|
103
|
+
if (!sketch.length)
|
|
104
|
+
return [];
|
|
105
|
+
return Array.from({ length: classes - 1 }, (_, i) => sketch.quantile((i + 1) / classes));
|
|
106
|
+
}
|
|
107
|
+
};
|
|
108
|
+
}
|
|
109
|
+
//# sourceMappingURL=streaming-domains.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"streaming-domains.js","sourceRoot":"","sources":["../../src/scales/streaming-domains.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import { type BoundSQLPredicate, type SQLPredicate, type SQLPredicateParameterValues } from "./sql-predicate-types.js";
|
|
2
|
+
/** Binds named parameter references in a portable SQL predicate without mutating the input AST. */
|
|
3
|
+
export declare function bindSQLPredicate(predicate: SQLPredicate, parameters: SQLPredicateParameterValues): BoundSQLPredicate;
|
|
4
|
+
//# sourceMappingURL=bind-sql-predicate.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bind-sql-predicate.d.ts","sourceRoot":"","sources":["../../src/sql/bind-sql-predicate.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,2BAA2B,EACjC,iCAA8B;AAE/B,mGAAmG;AACnG,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,YAAY,EACvB,UAAU,EAAE,2BAA2B,GACtC,iBAAiB,CAGnB"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
// math.gl
|
|
2
|
+
// SPDX-License-Identifier: MIT
|
|
3
|
+
// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
|
|
4
|
+
import { bindColumnarPredicateParameters } from "../expressions/columnar-predicate.js";
|
|
5
|
+
import { validateSQLPredicate } from "./sql-predicate-schema.js";
|
|
6
|
+
/** Binds named parameter references in a portable SQL predicate without mutating the input AST. */
|
|
7
|
+
export function bindSQLPredicate(predicate, parameters) {
|
|
8
|
+
validateSQLPredicate(predicate);
|
|
9
|
+
return bindColumnarPredicateParameters(predicate, parameters);
|
|
10
|
+
}
|
|
11
|
+
//# sourceMappingURL=bind-sql-predicate.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bind-sql-predicate.js","sourceRoot":"","sources":["../../src/sql/bind-sql-predicate.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAE5D,OAAO,EAAC,+BAA+B,EAAC,6CAA0C;AAElF,OAAO,EAAC,oBAAoB,EAAC,kCAA+B;AAO5D,mGAAmG;AACnG,MAAM,UAAU,gBAAgB,CAC9B,SAAuB,EACvB,UAAuC;IAEvC,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,+BAA+B,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAChE,CAAC"}
|