@math.gl/sql 0.0.0-stage → 5.0.0-beta.12

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.
Files changed (353) hide show
  1. package/LICENSE +249 -0
  2. package/README.md +26 -2
  3. package/THIRD-PARTY-NOTICES.md +5 -0
  4. package/dist/arrow/aggregates.d.ts +46 -0
  5. package/dist/arrow/aggregates.d.ts.map +1 -0
  6. package/dist/arrow/aggregates.js +289 -0
  7. package/dist/arrow/aggregates.js.map +1 -0
  8. package/dist/arrow/buffers.d.ts +30 -0
  9. package/dist/arrow/buffers.d.ts.map +1 -0
  10. package/dist/arrow/buffers.js +177 -0
  11. package/dist/arrow/buffers.js.map +1 -0
  12. package/dist/arrow/cast.d.ts +19 -0
  13. package/dist/arrow/cast.d.ts.map +1 -0
  14. package/dist/arrow/cast.js +138 -0
  15. package/dist/arrow/cast.js.map +1 -0
  16. package/dist/arrow/compiler.d.ts +10 -0
  17. package/dist/arrow/compiler.d.ts.map +1 -0
  18. package/dist/arrow/compiler.js +1538 -0
  19. package/dist/arrow/compiler.js.map +1 -0
  20. package/dist/arrow/float16.d.ts +7 -0
  21. package/dist/arrow/float16.d.ts.map +1 -0
  22. package/dist/arrow/float16.js +26 -0
  23. package/dist/arrow/float16.js.map +1 -0
  24. package/dist/arrow/index.cjs +3321 -0
  25. package/dist/arrow/index.cjs.map +6 -0
  26. package/dist/arrow/index.d.ts +5 -0
  27. package/dist/arrow/index.d.ts.map +1 -0
  28. package/dist/arrow/index.js +7 -0
  29. package/dist/arrow/index.js.map +1 -0
  30. package/dist/arrow/like.d.ts +3 -0
  31. package/dist/arrow/like.d.ts.map +1 -0
  32. package/dist/arrow/like.js +75 -0
  33. package/dist/arrow/like.js.map +1 -0
  34. package/dist/arrow/list-values.d.ts +14 -0
  35. package/dist/arrow/list-values.d.ts.map +1 -0
  36. package/dist/arrow/list-values.js +201 -0
  37. package/dist/arrow/list-values.js.map +1 -0
  38. package/dist/arrow/predicate.d.ts +7 -0
  39. package/dist/arrow/predicate.d.ts.map +1 -0
  40. package/dist/arrow/predicate.js +10 -0
  41. package/dist/arrow/predicate.js.map +1 -0
  42. package/dist/arrow/query-arrow-aggregate-snapshots.d.ts +24 -0
  43. package/dist/arrow/query-arrow-aggregate-snapshots.d.ts.map +1 -0
  44. package/dist/arrow/query-arrow-aggregate-snapshots.js +64 -0
  45. package/dist/arrow/query-arrow-aggregate-snapshots.js.map +1 -0
  46. package/dist/arrow/query-arrow-sql.d.ts +8 -0
  47. package/dist/arrow/query-arrow-sql.d.ts.map +1 -0
  48. package/dist/arrow/query-arrow-sql.js +223 -0
  49. package/dist/arrow/query-arrow-sql.js.map +1 -0
  50. package/dist/arrow/query-arrow-table.d.ts +36 -0
  51. package/dist/arrow/query-arrow-table.d.ts.map +1 -0
  52. package/dist/arrow/query-arrow-table.js +208 -0
  53. package/dist/arrow/query-arrow-table.js.map +1 -0
  54. package/dist/arrow/query-worker-entry.d.ts +2 -0
  55. package/dist/arrow/query-worker-entry.d.ts.map +1 -0
  56. package/dist/arrow/query-worker-entry.js +7 -0
  57. package/dist/arrow/query-worker-entry.js.map +1 -0
  58. package/dist/arrow/query-worker.d.ts +65 -0
  59. package/dist/arrow/query-worker.d.ts.map +1 -0
  60. package/dist/arrow/query-worker.js +135 -0
  61. package/dist/arrow/query-worker.js.map +1 -0
  62. package/dist/arrow/registry.d.ts +4 -0
  63. package/dist/arrow/registry.d.ts.map +1 -0
  64. package/dist/arrow/registry.js +66 -0
  65. package/dist/arrow/registry.js.map +1 -0
  66. package/dist/arrow/relational-query.d.ts +36 -0
  67. package/dist/arrow/relational-query.d.ts.map +1 -0
  68. package/dist/arrow/relational-query.js +174 -0
  69. package/dist/arrow/relational-query.js.map +1 -0
  70. package/dist/arrow/replace-arrow-columns.d.ts +8 -0
  71. package/dist/arrow/replace-arrow-columns.d.ts.map +1 -0
  72. package/dist/arrow/replace-arrow-columns.js +63 -0
  73. package/dist/arrow/replace-arrow-columns.js.map +1 -0
  74. package/dist/arrow/signature.d.ts +6 -0
  75. package/dist/arrow/signature.d.ts.map +1 -0
  76. package/dist/arrow/signature.js +51 -0
  77. package/dist/arrow/signature.js.map +1 -0
  78. package/dist/arrow/temporal-cast.d.ts +9 -0
  79. package/dist/arrow/temporal-cast.d.ts.map +1 -0
  80. package/dist/arrow/temporal-cast.js +60 -0
  81. package/dist/arrow/temporal-cast.js.map +1 -0
  82. package/dist/arrow/types.d.ts +62 -0
  83. package/dist/arrow/types.d.ts.map +1 -0
  84. package/dist/arrow/types.js +5 -0
  85. package/dist/arrow/types.js.map +1 -0
  86. package/dist/arrow/unnest-arrow-column.d.ts +22 -0
  87. package/dist/arrow/unnest-arrow-column.d.ts.map +1 -0
  88. package/dist/arrow/unnest-arrow-column.js +112 -0
  89. package/dist/arrow/unnest-arrow-column.js.map +1 -0
  90. package/dist/arrow/worker-entry.d.ts +2 -0
  91. package/dist/arrow/worker-entry.d.ts.map +1 -0
  92. package/dist/arrow/worker-entry.js +9 -0
  93. package/dist/arrow/worker-entry.js.map +1 -0
  94. package/dist/arrow/worker.cjs +4074 -0
  95. package/dist/arrow/worker.cjs.map +6 -0
  96. package/dist/arrow/worker.d.ts +58 -0
  97. package/dist/arrow/worker.d.ts.map +1 -0
  98. package/dist/arrow/worker.js +84 -0
  99. package/dist/arrow/worker.js.map +1 -0
  100. package/dist/color-functions/index.cjs +382 -0
  101. package/dist/color-functions/index.cjs.map +6 -0
  102. package/dist/color-functions/index.d.ts +26 -0
  103. package/dist/color-functions/index.d.ts.map +1 -0
  104. package/dist/color-functions/index.js +306 -0
  105. package/dist/color-functions/index.js.map +1 -0
  106. package/dist/diagnostic-log.d.ts +8 -0
  107. package/dist/diagnostic-log.d.ts.map +1 -0
  108. package/dist/diagnostic-log.js +15 -0
  109. package/dist/diagnostic-log.js.map +1 -0
  110. package/dist/expressions/ast.d.ts +12 -0
  111. package/dist/expressions/ast.d.ts.map +1 -0
  112. package/dist/expressions/ast.js +114 -0
  113. package/dist/expressions/ast.js.map +1 -0
  114. package/dist/expressions/columnar-predicate.d.ts +56 -0
  115. package/dist/expressions/columnar-predicate.d.ts.map +1 -0
  116. package/dist/expressions/columnar-predicate.js +176 -0
  117. package/dist/expressions/columnar-predicate.js.map +1 -0
  118. package/dist/expressions/evaluation-error.d.ts +14 -0
  119. package/dist/expressions/evaluation-error.d.ts.map +1 -0
  120. package/dist/expressions/evaluation-error.js +26 -0
  121. package/dist/expressions/evaluation-error.js.map +1 -0
  122. package/dist/expressions/expression-eval.d.ts +105 -0
  123. package/dist/expressions/expression-eval.d.ts.map +1 -0
  124. package/dist/expressions/expression-eval.js +330 -0
  125. package/dist/expressions/expression-eval.js.map +1 -0
  126. package/dist/expressions/function-libraries.d.ts +63 -0
  127. package/dist/expressions/function-libraries.d.ts.map +1 -0
  128. package/dist/expressions/function-libraries.js +69 -0
  129. package/dist/expressions/function-libraries.js.map +1 -0
  130. package/dist/expressions/function-registry.d.ts +93 -0
  131. package/dist/expressions/function-registry.d.ts.map +1 -0
  132. package/dist/expressions/function-registry.js +139 -0
  133. package/dist/expressions/function-registry.js.map +1 -0
  134. package/dist/expressions/get.d.ts +9 -0
  135. package/dist/expressions/get.d.ts.map +1 -0
  136. package/dist/expressions/get.js +32 -0
  137. package/dist/expressions/get.js.map +1 -0
  138. package/dist/expressions/index.cjs +1888 -0
  139. package/dist/expressions/index.cjs.map +6 -0
  140. package/dist/expressions/index.d.ts +13 -0
  141. package/dist/expressions/index.d.ts.map +1 -0
  142. package/dist/expressions/index.js +14 -0
  143. package/dist/expressions/index.js.map +1 -0
  144. package/dist/expressions/numeric-functions.d.ts +277 -0
  145. package/dist/expressions/numeric-functions.d.ts.map +1 -0
  146. package/dist/expressions/numeric-functions.js +52 -0
  147. package/dist/expressions/numeric-functions.js.map +1 -0
  148. package/dist/expressions/parse-expression-string.d.ts +21 -0
  149. package/dist/expressions/parse-expression-string.d.ts.map +1 -0
  150. package/dist/expressions/parse-expression-string.js +61 -0
  151. package/dist/expressions/parse-expression-string.js.map +1 -0
  152. package/dist/expressions/predicate-expression.d.ts +7 -0
  153. package/dist/expressions/predicate-expression.d.ts.map +1 -0
  154. package/dist/expressions/predicate-expression.js +112 -0
  155. package/dist/expressions/predicate-expression.js.map +1 -0
  156. package/dist/expressions/scalar-type.d.ts +6 -0
  157. package/dist/expressions/scalar-type.d.ts.map +1 -0
  158. package/dist/expressions/scalar-type.js +23 -0
  159. package/dist/expressions/scalar-type.js.map +1 -0
  160. package/dist/expressions/vendor/jsep/runtime.d.ts +3 -0
  161. package/dist/expressions/vendor/jsep/runtime.d.ts.map +1 -0
  162. package/dist/expressions/vendor/jsep/runtime.js +972 -0
  163. package/dist/expressions/vendor/jsep/runtime.js.map +1 -0
  164. package/dist/expressions/vendor/jsep/types.d.ts +148 -0
  165. package/dist/expressions/vendor/jsep/types.d.ts.map +1 -0
  166. package/dist/expressions/vendor/jsep/types.js +6 -0
  167. package/dist/expressions/vendor/jsep/types.js.map +1 -0
  168. package/dist/index.cjs +5294 -0
  169. package/dist/index.cjs.map +6 -0
  170. package/dist/index.d.ts +11 -0
  171. package/dist/index.d.ts.map +1 -0
  172. package/dist/index.js +11 -0
  173. package/dist/index.js.map +1 -0
  174. package/dist/math-functions/index.cjs +444 -0
  175. package/dist/math-functions/index.cjs.map +6 -0
  176. package/dist/math-functions/index.d.ts +44 -0
  177. package/dist/math-functions/index.d.ts.map +1 -0
  178. package/dist/math-functions/index.js +182 -0
  179. package/dist/math-functions/index.js.map +1 -0
  180. package/dist/parser/bind-sql-predicate.d.ts +4 -0
  181. package/dist/parser/bind-sql-predicate.d.ts.map +1 -0
  182. package/dist/parser/bind-sql-predicate.js +11 -0
  183. package/dist/parser/bind-sql-predicate.js.map +1 -0
  184. package/dist/parser/index.cjs +1807 -0
  185. package/dist/parser/index.cjs.map +6 -0
  186. package/dist/parser/index.d.ts +12 -0
  187. package/dist/parser/index.d.ts.map +1 -0
  188. package/dist/parser/index.js +11 -0
  189. package/dist/parser/index.js.map +1 -0
  190. package/dist/parser/parameter-snapshots.d.ts +21 -0
  191. package/dist/parser/parameter-snapshots.d.ts.map +1 -0
  192. package/dist/parser/parameter-snapshots.js +85 -0
  193. package/dist/parser/parameter-snapshots.js.map +1 -0
  194. package/dist/parser/parse-sql-expression.d.ts +50 -0
  195. package/dist/parser/parse-sql-expression.d.ts.map +1 -0
  196. package/dist/parser/parse-sql-expression.js +501 -0
  197. package/dist/parser/parse-sql-expression.js.map +1 -0
  198. package/dist/parser/parse-sql-predicate.d.ts +13 -0
  199. package/dist/parser/parse-sql-predicate.d.ts.map +1 -0
  200. package/dist/parser/parse-sql-predicate.js +365 -0
  201. package/dist/parser/parse-sql-predicate.js.map +1 -0
  202. package/dist/parser/parse-sql-query.d.ts +9 -0
  203. package/dist/parser/parse-sql-query.d.ts.map +1 -0
  204. package/dist/parser/parse-sql-query.js +81 -0
  205. package/dist/parser/parse-sql-query.js.map +1 -0
  206. package/dist/parser/parse-sql-select.d.ts +57 -0
  207. package/dist/parser/parse-sql-select.d.ts.map +1 -0
  208. package/dist/parser/parse-sql-select.js +247 -0
  209. package/dist/parser/parse-sql-select.js.map +1 -0
  210. package/dist/parser/parse-sql-statement.d.ts +54 -0
  211. package/dist/parser/parse-sql-statement.d.ts.map +1 -0
  212. package/dist/parser/parse-sql-statement.js +207 -0
  213. package/dist/parser/parse-sql-statement.js.map +1 -0
  214. package/dist/parser/query-types.d.ts +56 -0
  215. package/dist/parser/query-types.d.ts.map +1 -0
  216. package/dist/parser/query-types.js +5 -0
  217. package/dist/parser/query-types.js.map +1 -0
  218. package/dist/parser/sql-parameters.d.ts +29 -0
  219. package/dist/parser/sql-parameters.d.ts.map +1 -0
  220. package/dist/parser/sql-parameters.js +110 -0
  221. package/dist/parser/sql-parameters.js.map +1 -0
  222. package/dist/parser/sql-parse-error.d.ts +13 -0
  223. package/dist/parser/sql-parse-error.d.ts.map +1 -0
  224. package/dist/parser/sql-parse-error.js +20 -0
  225. package/dist/parser/sql-parse-error.js.map +1 -0
  226. package/dist/parser/sql-predicate-schema.d.ts +164 -0
  227. package/dist/parser/sql-predicate-schema.d.ts.map +1 -0
  228. package/dist/parser/sql-predicate-schema.js +249 -0
  229. package/dist/parser/sql-predicate-schema.js.map +1 -0
  230. package/dist/parser/sql-predicate-types.d.ts +48 -0
  231. package/dist/parser/sql-predicate-types.d.ts.map +1 -0
  232. package/dist/parser/sql-predicate-types.js +9 -0
  233. package/dist/parser/sql-predicate-types.js.map +1 -0
  234. package/dist/parser/sql-predicate.d.ts +6 -0
  235. package/dist/parser/sql-predicate.d.ts.map +1 -0
  236. package/dist/parser/sql-predicate.js +8 -0
  237. package/dist/parser/sql-predicate.js.map +1 -0
  238. package/dist/scales/arrow-domains.d.ts +22 -0
  239. package/dist/scales/arrow-domains.d.ts.map +1 -0
  240. package/dist/scales/arrow-domains.js +166 -0
  241. package/dist/scales/arrow-domains.js.map +1 -0
  242. package/dist/scales/arrow-scales.d.ts +44 -0
  243. package/dist/scales/arrow-scales.d.ts.map +1 -0
  244. package/dist/scales/arrow-scales.js +255 -0
  245. package/dist/scales/arrow-scales.js.map +1 -0
  246. package/dist/scales/compile-scale.d.ts +2 -0
  247. package/dist/scales/compile-scale.d.ts.map +1 -0
  248. package/dist/scales/compile-scale.js +5 -0
  249. package/dist/scales/compile-scale.js.map +1 -0
  250. package/dist/scales/conformance.cjs +180 -0
  251. package/dist/scales/conformance.cjs.map +6 -0
  252. package/dist/scales/conformance.d.ts +26 -0
  253. package/dist/scales/conformance.d.ts.map +1 -0
  254. package/dist/scales/conformance.js +164 -0
  255. package/dist/scales/conformance.js.map +1 -0
  256. package/dist/scales/hdr-colors.d.ts +2 -0
  257. package/dist/scales/hdr-colors.d.ts.map +1 -0
  258. package/dist/scales/hdr-colors.js +5 -0
  259. package/dist/scales/hdr-colors.js.map +1 -0
  260. package/dist/scales/index.cjs +4334 -0
  261. package/dist/scales/index.cjs.map +6 -0
  262. package/dist/scales/index.d.ts +10 -0
  263. package/dist/scales/index.d.ts.map +1 -0
  264. package/dist/scales/index.js +11 -0
  265. package/dist/scales/index.js.map +1 -0
  266. package/dist/scales/palettes.d.ts +2 -0
  267. package/dist/scales/palettes.d.ts.map +1 -0
  268. package/dist/scales/palettes.js +5 -0
  269. package/dist/scales/palettes.js.map +1 -0
  270. package/dist/scales/parse-sql-scale.d.ts +27 -0
  271. package/dist/scales/parse-sql-scale.d.ts.map +1 -0
  272. package/dist/scales/parse-sql-scale.js +257 -0
  273. package/dist/scales/parse-sql-scale.js.map +1 -0
  274. package/dist/scales/quantile-sketch.d.ts +2 -0
  275. package/dist/scales/quantile-sketch.d.ts.map +1 -0
  276. package/dist/scales/quantile-sketch.js +5 -0
  277. package/dist/scales/quantile-sketch.js.map +1 -0
  278. package/dist/scales/scale-types.d.ts +2 -0
  279. package/dist/scales/scale-types.d.ts.map +1 -0
  280. package/dist/scales/scale-types.js +5 -0
  281. package/dist/scales/scale-types.js.map +1 -0
  282. package/dist/scales/streaming-domains.d.ts +18 -0
  283. package/dist/scales/streaming-domains.d.ts.map +1 -0
  284. package/dist/scales/streaming-domains.js +115 -0
  285. package/dist/scales/streaming-domains.js.map +1 -0
  286. package/package.json +92 -4
  287. package/src/arrow/aggregates.ts +386 -0
  288. package/src/arrow/buffers.ts +177 -0
  289. package/src/arrow/cast.ts +160 -0
  290. package/src/arrow/compiler.ts +1778 -0
  291. package/src/arrow/float16.ts +25 -0
  292. package/src/arrow/index.ts +22 -0
  293. package/src/arrow/like.ts +72 -0
  294. package/src/arrow/list-values.ts +221 -0
  295. package/src/arrow/predicate.ts +19 -0
  296. package/src/arrow/query-arrow-aggregate-snapshots.ts +107 -0
  297. package/src/arrow/query-arrow-sql.ts +255 -0
  298. package/src/arrow/query-arrow-table.ts +298 -0
  299. package/src/arrow/query-worker-entry.ts +8 -0
  300. package/src/arrow/query-worker.ts +194 -0
  301. package/src/arrow/registry.ts +87 -0
  302. package/src/arrow/relational-query.ts +247 -0
  303. package/src/arrow/replace-arrow-columns.ts +71 -0
  304. package/src/arrow/signature.ts +50 -0
  305. package/src/arrow/temporal-cast.ts +66 -0
  306. package/src/arrow/types.ts +76 -0
  307. package/src/arrow/unnest-arrow-column.ts +145 -0
  308. package/src/arrow/worker-entry.ts +10 -0
  309. package/src/arrow/worker.ts +143 -0
  310. package/src/color-functions/index.ts +405 -0
  311. package/src/diagnostic-log.ts +20 -0
  312. package/src/expressions/ast.ts +143 -0
  313. package/src/expressions/columnar-predicate.ts +293 -0
  314. package/src/expressions/evaluation-error.ts +29 -0
  315. package/src/expressions/expression-eval.ts +489 -0
  316. package/src/expressions/function-libraries.ts +126 -0
  317. package/src/expressions/function-registry.ts +171 -0
  318. package/src/expressions/get.ts +37 -0
  319. package/src/expressions/index.ts +40 -0
  320. package/src/expressions/numeric-functions.ts +99 -0
  321. package/src/expressions/parse-expression-string.ts +80 -0
  322. package/src/expressions/predicate-expression.ts +128 -0
  323. package/src/expressions/scalar-type.ts +39 -0
  324. package/src/expressions/vendor/jsep/LICENSE.txt +23 -0
  325. package/src/expressions/vendor/jsep/runtime.ts +949 -0
  326. package/src/expressions/vendor/jsep/types.ts +191 -0
  327. package/src/index.ts +54 -0
  328. package/src/math-functions/index.ts +235 -0
  329. package/src/parser/bind-sql-predicate.ts +21 -0
  330. package/src/parser/index.ts +43 -0
  331. package/src/parser/parameter-snapshots.ts +103 -0
  332. package/src/parser/parse-sql-expression.ts +500 -0
  333. package/src/parser/parse-sql-predicate.ts +454 -0
  334. package/src/parser/parse-sql-query.ts +90 -0
  335. package/src/parser/parse-sql-select.ts +272 -0
  336. package/src/parser/parse-sql-statement.ts +260 -0
  337. package/src/parser/query-types.ts +71 -0
  338. package/src/parser/sql-parameters.ts +174 -0
  339. package/src/parser/sql-parse-error.ts +33 -0
  340. package/src/parser/sql-predicate-schema.ts +279 -0
  341. package/src/parser/sql-predicate-types.ts +91 -0
  342. package/src/parser/sql-predicate.ts +28 -0
  343. package/src/scales/arrow-domains.ts +190 -0
  344. package/src/scales/arrow-scales.ts +363 -0
  345. package/src/scales/compile-scale.ts +5 -0
  346. package/src/scales/conformance.ts +186 -0
  347. package/src/scales/hdr-colors.ts +5 -0
  348. package/src/scales/index.ts +37 -0
  349. package/src/scales/palettes.ts +5 -0
  350. package/src/scales/parse-sql-scale.ts +300 -0
  351. package/src/scales/quantile-sketch.ts +5 -0
  352. package/src/scales/scale-types.ts +5 -0
  353. package/src/scales/streaming-domains.ts +139 -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
+ }