@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,176 @@
1
+ // math.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+ import { isColumnarScalarType } from "./scalar-type.js";
5
+ export function getColumnarPredicateColumns(predicate) {
6
+ return [...new Set(getColumnarPredicatePaths(predicate).map(path => path[0]))];
7
+ }
8
+ export function getColumnarPredicatePath(property) {
9
+ return typeof property.property === 'string' ? [property.property] : [...property.property];
10
+ }
11
+ export function getColumnarPredicatePaths(predicate) {
12
+ const paths = new Map();
13
+ visitColumnarPredicate(predicate, child => {
14
+ if ('property' in child.args[0]) {
15
+ const path = getColumnarPredicatePath(child.args[0]);
16
+ paths.set(path.join('\0'), path);
17
+ }
18
+ });
19
+ return [...paths.values()];
20
+ }
21
+ /** Returns unresolved named parameter names in their first-occurrence order. */
22
+ export function getColumnarPredicateParameterNames(predicate) {
23
+ const parameterNames = new Set();
24
+ visitColumnarPredicate(predicate, child => {
25
+ if (child.op === 'and' || child.op === 'or' || child.op === 'not' || child.op === 'isNull') {
26
+ return;
27
+ }
28
+ const values = child.op === 'in' ? child.args[1] : [child.args[1]];
29
+ for (const value of values) {
30
+ if (isColumnarPredicateParameter(value)) {
31
+ parameterNames.add(value.parameter);
32
+ }
33
+ }
34
+ });
35
+ return [...parameterNames];
36
+ }
37
+ export function copyColumnarPredicate(predicate) {
38
+ if (predicate.op === 'and' || predicate.op === 'or') {
39
+ return { op: predicate.op, args: predicate.args.map(copyColumnarPredicate) };
40
+ }
41
+ if (predicate.op === 'not') {
42
+ return { op: 'not', args: [copyColumnarPredicate(predicate.args[0])] };
43
+ }
44
+ const leaf = predicate;
45
+ const property = copyColumnarPredicateProperty({
46
+ ...leaf.args[0],
47
+ property: [...getColumnarPredicatePath(leaf.args[0])]
48
+ });
49
+ if (leaf.op === 'isNull')
50
+ return { op: 'isNull', args: [property] };
51
+ if (leaf.op === 'in') {
52
+ return { op: 'in', args: [property, leaf.args[1].map(copyColumnarPredicateValue)] };
53
+ }
54
+ return { op: leaf.op, args: [property, copyColumnarPredicateValue(leaf.args[1])] };
55
+ }
56
+ export function validateColumnarPredicate(predicate, availableColumns) {
57
+ visitColumnarPredicate(predicate, child => {
58
+ if (child.op === 'and' || child.op === 'or') {
59
+ if (child.args.length < 2)
60
+ throw new Error(`Columnar predicate ${child.op} requires at least two child predicates`);
61
+ return;
62
+ }
63
+ if (child.op === 'not')
64
+ return;
65
+ const leaf = child;
66
+ const casts = leaf.args[0].casts;
67
+ if (casts !== undefined &&
68
+ (!Array.isArray(casts) ||
69
+ !casts.length ||
70
+ casts.length > 64 ||
71
+ Array.from(casts).some(type => !isColumnarScalarType(type))))
72
+ throw new Error('Invalid columnar predicate casts');
73
+ const path = getColumnarPredicatePath(leaf.args[0]);
74
+ if (!path.length || path.some(component => !component)) {
75
+ throw new Error('Columnar predicate property path must contain non-empty strings');
76
+ }
77
+ if (!availableColumns.has(path[0]))
78
+ throw new Error(`Columnar predicate column not found: ${path.join('.')}`);
79
+ if (leaf.op === 'in' && leaf.args[1].length === 0) {
80
+ throw new Error('Columnar predicate in requires at least one value');
81
+ }
82
+ });
83
+ }
84
+ /** Returns whether a predicate value is an unresolved named parameter. */
85
+ export function isColumnarPredicateParameter(value) {
86
+ const parameterValue = value;
87
+ return (typeof value === 'object' &&
88
+ value !== null &&
89
+ !Array.isArray(value) &&
90
+ Object.keys(value).length === 1 &&
91
+ Object.prototype.hasOwnProperty.call(value, 'parameter') &&
92
+ typeof parameterValue.parameter === 'string' &&
93
+ parameterValue.parameter.length > 0);
94
+ }
95
+ /** Returns whether a runtime value belongs to the portable predicate scalar set. */
96
+ export function isColumnarPredicateValue(value) {
97
+ return (typeof value === 'boolean' ||
98
+ typeof value === 'bigint' ||
99
+ typeof value === 'string' ||
100
+ (typeof value === 'number' && Number.isFinite(value)) ||
101
+ (value instanceof Date && Number.isFinite(value.getTime())) ||
102
+ value instanceof Uint8Array);
103
+ }
104
+ /** Binds every named parameter without mutating the portable predicate. */
105
+ export function bindColumnarPredicateParameters(predicate, parameters) {
106
+ switch (predicate.op) {
107
+ case 'and':
108
+ case 'or':
109
+ return {
110
+ op: predicate.op,
111
+ args: predicate.args.map(child => bindColumnarPredicateParameters(child, parameters))
112
+ };
113
+ case 'not':
114
+ return {
115
+ op: 'not',
116
+ args: [bindColumnarPredicateParameters(predicate.args[0], parameters)]
117
+ };
118
+ case 'isNull':
119
+ return { op: 'isNull', args: [copyColumnarPredicateProperty(predicate.args[0])] };
120
+ case 'in':
121
+ return {
122
+ op: 'in',
123
+ args: [
124
+ copyColumnarPredicateProperty(predicate.args[0]),
125
+ predicate.args[1].map(value => bindColumnarPredicateValue(value, parameters))
126
+ ]
127
+ };
128
+ default:
129
+ return {
130
+ op: predicate.op,
131
+ args: [
132
+ copyColumnarPredicateProperty(predicate.args[0]),
133
+ bindColumnarPredicateValue(predicate.args[1], parameters)
134
+ ]
135
+ };
136
+ }
137
+ }
138
+ function visitColumnarPredicate(predicate, visitor) {
139
+ visitor(predicate);
140
+ if (predicate.op === 'and' || predicate.op === 'or')
141
+ predicate.args.forEach(child => visitColumnarPredicate(child, visitor));
142
+ else if (predicate.op === 'not')
143
+ visitColumnarPredicate(predicate.args[0], visitor);
144
+ }
145
+ /** Resolves one parameter reference or returns an already concrete scalar. */
146
+ function bindColumnarPredicateValue(value, parameters) {
147
+ if (!isColumnarPredicateParameter(value))
148
+ return value;
149
+ if (!Object.prototype.hasOwnProperty.call(parameters, value.parameter)) {
150
+ throw new Error(`Columnar predicate parameter ":${value.parameter}" requires a value`);
151
+ }
152
+ const parameterValue = parameters[value.parameter];
153
+ if (isColumnarPredicateParameter(parameterValue)) {
154
+ throw new Error(`Columnar predicate parameter ":${value.parameter}" cannot reference another parameter`);
155
+ }
156
+ if (!isColumnarPredicateValue(parameterValue)) {
157
+ throw new Error(`Columnar predicate parameter ":${value.parameter}" has an unsupported value`);
158
+ }
159
+ return copyColumnarPredicateValue(parameterValue);
160
+ }
161
+ /** Copies a property while preserving its backend-specific property subtype. */
162
+ function copyColumnarPredicateProperty(property) {
163
+ return {
164
+ ...property,
165
+ ...(property.casts ? { casts: [...property.casts] } : {}),
166
+ property: typeof property.property === 'string' ? property.property : [...property.property]
167
+ };
168
+ }
169
+ function copyColumnarPredicateValue(value) {
170
+ if (value instanceof Uint8Array)
171
+ return value.slice();
172
+ if (value instanceof Date)
173
+ return new Date(value.getTime());
174
+ return value;
175
+ }
176
+ //# sourceMappingURL=columnar-predicate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"columnar-predicate.js","sourceRoot":"","sources":["../../src/expressions/columnar-predicate.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAE5D,OAAO,EAAC,oBAAoB,EAA0B,yBAAsB;AA+E5E,MAAM,UAAU,2BAA2B,CACzC,SAA+C;IAE/C,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAmC;IAC1E,OAAO,OAAO,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,SAA+C;IAE/C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC1C,sBAAsB,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE;QACxC,IAAI,UAAU,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACrD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,kCAAkC,CAChD,SAAoD;IAEpD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,sBAAsB,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE;QACxC,IAAI,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,KAAK,CAAC,EAAE,KAAK,IAAI,IAAI,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,KAAK,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC3F,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,4BAA4B,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,cAAc,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,SAA4B;IAChE,IAAI,SAAS,CAAC,EAAE,KAAK,KAAK,IAAI,SAAS,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;QACpD,OAAO,EAAC,EAAE,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,qBAAqB,CAAC,EAAC,CAAC;IAC7E,CAAC;IACD,IAAI,SAAS,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC3B,OAAO,EAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,qBAAqB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAC,CAAC;IACvE,CAAC;IACD,MAAM,IAAI,GAAG,SAGY,CAAC;IAC1B,MAAM,QAAQ,GAAG,6BAA6B,CAAC;QAC7C,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACf,QAAQ,EAAE,CAAC,GAAG,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;KACtD,CAAC,CAAC;IACH,IAAI,IAAI,CAAC,EAAE,KAAK,QAAQ;QAAE,OAAO,EAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAC,CAAC;IAClE,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,EAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,EAAC,CAAC;IACpF,CAAC;IACD,OAAO,EAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,SAAqC,EACrC,gBAAqC;IAErC,sBAAsB,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE;QACxC,IAAI,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,KAAK,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;YAC5C,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,CAAC,EAAE,yCAAyC,CAAC,CAAC;YAC3F,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,EAAE,KAAK,KAAK;YAAE,OAAO;QAC/B,MAAM,IAAI,GAAG,KAAkF,CAAC;QAChG,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACjC,IACE,KAAK,KAAK,SAAS;YACnB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBACpB,CAAC,KAAK,CAAC,MAAM;gBACb,KAAK,CAAC,MAAM,GAAG,EAAE;gBACjB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;YAE9D,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5E,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,4BAA4B,CAAC,KAAc;IACzD,MAAM,cAAc,GAAG,KAA8B,CAAC;IACtD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;QAC/B,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC;QACxD,OAAO,cAAc,CAAC,SAAS,KAAK,QAAQ;QAC5C,cAAc,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CACpC,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,CACL,OAAO,KAAK,KAAK,SAAS;QAC1B,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACrD,CAAC,KAAK,YAAY,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3D,KAAK,YAAY,UAAU,CAC5B,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,+BAA+B,CAG7C,SAAoD,EACpD,UAA4C;IAE5C,QAAQ,SAAS,CAAC,EAAE,EAAE,CAAC;QACrB,KAAK,KAAK,CAAC;QACX,KAAK,IAAI;YACP,OAAO;gBACL,EAAE,EAAE,SAAS,CAAC,EAAE;gBAChB,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,+BAA+B,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;aACtF,CAAC;QACJ,KAAK,KAAK;YACR,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,CAAC,+BAA+B,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;aACvE,CAAC;QACJ,KAAK,QAAQ;YACX,OAAO,EAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,6BAA6B,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAC,CAAC;QAClF,KAAK,IAAI;YACP,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE;oBACJ,6BAA6B,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAChD,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,0BAA0B,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;iBAC9E;aACF,CAAC;QACJ;YACE,OAAO;gBACL,EAAE,EAAE,SAAS,CAAC,EAAE;gBAChB,IAAI,EAAE;oBACJ,6BAA6B,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAChD,0BAA0B,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC;iBAC1D;aACF,CAAC;IACN,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAC7B,SAA+C,EAC/C,OAAkE;IAElE,OAAO,CAAC,SAAS,CAAC,CAAC;IACnB,IAAI,SAAS,CAAC,EAAE,KAAK,KAAK,IAAI,SAAS,CAAC,EAAE,KAAK,IAAI;QACjD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;SACrE,IAAI,SAAS,CAAC,EAAE,KAAK,KAAK;QAAE,sBAAsB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACtF,CAAC;AAED,8EAA8E;AAC9E,SAAS,0BAA0B,CACjC,KAAkC,EAClC,UAA4C;IAE5C,IAAI,CAAC,4BAA4B,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,CAAC,SAAS,oBAAoB,CAAC,CAAC;IACzF,CAAC;IACD,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACnD,IAAI,4BAA4B,CAAC,cAAc,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,kCAAkC,KAAK,CAAC,SAAS,sCAAsC,CACxF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,wBAAwB,CAAC,cAAc,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,CAAC,SAAS,4BAA4B,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,0BAA0B,CAAC,cAAc,CAAC,CAAC;AACpD,CAAC;AAED,gFAAgF;AAChF,SAAS,6BAA6B,CACpC,QAAmB;IAEnB,OAAO;QACL,GAAG,QAAQ;QACX,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAC,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,QAAQ,EAAE,OAAO,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC;KAChF,CAAC;AACjB,CAAC;AAED,SAAS,0BAA0B,CAAC,KAA6B;IAC/D,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC;IACtD,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5D,OAAO,KAAK,CAAC;AACf,CAAC"}
@@ -0,0 +1,14 @@
1
+ /** Recoverable data errors; programming, binding and cancellation errors remain ordinary exceptions. */
2
+ export type ExpressionEvaluationErrorCode = 'domain' | 'conversion' | 'overflow' | 'divisionByZero';
3
+ declare const brand: unique symbol;
4
+ /** A classified scalar evaluation failure, eligible for explicit TRY recovery. */
5
+ export declare class ExpressionEvaluationError extends Error {
6
+ readonly code: ExpressionEvaluationErrorCode;
7
+ readonly name = "ExpressionEvaluationError";
8
+ readonly [brand] = true;
9
+ constructor(code: ExpressionEvaluationErrorCode, message: string);
10
+ }
11
+ /** Recognizes classified errors across separately bundled ESM/CommonJS function entry points. */
12
+ export declare function isExpressionEvaluationError(error: unknown): error is ExpressionEvaluationError;
13
+ export {};
14
+ //# sourceMappingURL=evaluation-error.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"evaluation-error.d.ts","sourceRoot":"","sources":["../../src/expressions/evaluation-error.ts"],"names":[],"mappings":"AAIA,wGAAwG;AACxG,MAAM,MAAM,6BAA6B,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,gBAAgB,CAAC;AACpG,QAAA,MAAM,KAAK,eAAwD,CAAC;AAEpE,kFAAkF;AAClF,qBAAa,yBAA0B,SAAQ,KAAK;IAIhD,QAAQ,CAAC,IAAI,EAAE,6BAA6B;IAH9C,SAAkB,IAAI,+BAA+B;IACrD,QAAQ,CAAC,CAAC,KAAK,CAAC,QAAQ;gBAEb,IAAI,EAAE,6BAA6B,EAC5C,OAAO,EAAE,MAAM;CAKlB;AACD,iGAAiG;AACjG,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,yBAAyB,CAO9F"}
@@ -0,0 +1,26 @@
1
+ // math.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+ var _a;
5
+ const brand = Symbol.for('@math.gl/core/ExpressionEvaluationError');
6
+ const codes = ['domain', 'conversion', 'overflow', 'divisionByZero'];
7
+ /** A classified scalar evaluation failure, eligible for explicit TRY recovery. */
8
+ export class ExpressionEvaluationError extends Error {
9
+ constructor(code, message) {
10
+ super(message);
11
+ this.code = code;
12
+ this.name = 'ExpressionEvaluationError';
13
+ this[_a] = true;
14
+ if (!codes.includes(code))
15
+ throw new TypeError('Unknown Arrow evaluation error code');
16
+ }
17
+ }
18
+ _a = brand;
19
+ /** Recognizes classified errors across separately bundled ESM/CommonJS function entry points. */
20
+ export function isExpressionEvaluationError(error) {
21
+ return (typeof error === 'object' &&
22
+ error !== null &&
23
+ error[brand] === true &&
24
+ codes.includes(error.code));
25
+ }
26
+ //# sourceMappingURL=evaluation-error.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"evaluation-error.js","sourceRoot":"","sources":["../../src/expressions/evaluation-error.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;;AAI5D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;AACpE,MAAM,KAAK,GAAsB,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;AACxF,kFAAkF;AAClF,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAGlD,YACW,IAAmC,EAC5C,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,SAAI,GAAJ,IAAI,CAA+B;QAH5B,SAAI,GAAG,2BAA2B,CAAC;QAC5C,QAAO,GAAG,IAAI,CAAC;QAMtB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;IACxF,CAAC;CACF;KARW,KAAK;AASjB,iGAAiG;AACjG,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAsC,CAAC,KAAK,CAAC,KAAK,IAAI;QACvD,KAAK,CAAC,QAAQ,CAAE,KAAmC,CAAC,IAAI,CAAC,CAC1D,CAAC;AACJ,CAAC"}
@@ -0,0 +1,105 @@
1
+ /**
2
+ * Sources:
3
+ * - Copyright (c) 2013 Stephen Oney, http://jsep.from.so/, MIT License
4
+ * - Copyright (c) 2023 Don McCurdy, https://github.com/donmccurdy/expression-eval, MIT License
5
+ */
6
+ import { type DiagnosticLog } from "../diagnostic-log.js";
7
+ import type { Jsep as JsepTypes } from "./vendor/jsep/types.js";
8
+ import { type ExpressionEvaluationOptions } from "./function-libraries.js";
9
+ /**
10
+ * Named values and functions available while evaluating an expression.
11
+ */
12
+ export type ExpressionContext = Record<string, unknown>;
13
+ /**
14
+ * A JSEP abstract syntax tree node supported by the evaluator.
15
+ */
16
+ export type Expression = JsepTypes.ArrayExpression | JsepTypes.BinaryExpression | JsepTypes.LogicalExpression | (JsepTypes.CallExpression & {
17
+ /** SQL unquoted function names resolve case-insensitively. */ sqlFunction?: true;
18
+ }) | JsepTypes.ConditionalExpression | JsepTypes.Identifier | {
19
+ /** Literal node discriminator. */
20
+ type: 'Literal';
21
+ /** Original spelling when the literal came from source text. */
22
+ raw?: string;
23
+ /** Scalar value, including structured-cloneable binary and date parameters. */
24
+ value: JsepTypes.Literal['value'] | Date | Uint8Array;
25
+ /** Optional pre-encoded UTF-8 storage corresponding to a string value. */
26
+ utf8?: Uint8Array;
27
+ } | JsepTypes.MemberExpression | JsepTypes.ThisExpression | JsepTypes.UnaryExpression;
28
+ /**
29
+ * Evaluator implementation for a custom unary operator.
30
+ *
31
+ * @param operand - Value produced by the operator's operand expression.
32
+ * @returns The operator result.
33
+ */
34
+ export type UnaryOperator = (operand: any) => any;
35
+ /**
36
+ * Evaluator implementation for a custom binary operator.
37
+ *
38
+ * @param left - Value produced by the left operand expression.
39
+ * @param right - Value produced by the right operand expression.
40
+ * @returns The operator result.
41
+ */
42
+ export type BinaryOperator = (left: any, right: any) => any;
43
+ /**
44
+ * Compiles an expression into a reusable synchronous evaluator.
45
+ *
46
+ * @param expression - Expression source or a previously parsed AST.
47
+ * @param options - Function libraries to add to each evaluation context.
48
+ * @returns A function that evaluates the expression against a context.
49
+ */
50
+ export declare function compile(expression: string | JsepTypes.Expression, options?: ExpressionEvaluationOptions): (context: ExpressionContext) => unknown;
51
+ /**
52
+ * Compiles an expression into a reusable asynchronous evaluator.
53
+ *
54
+ * @param expression - Expression source or a previously parsed AST.
55
+ * @param options - Function libraries to add to each evaluation context.
56
+ * @returns A function that asynchronously evaluates the expression.
57
+ */
58
+ export declare function compileAsync(expression: string | JsepTypes.Expression, options?: ExpressionEvaluationOptions): (context: ExpressionContext) => Promise<unknown>;
59
+ /**
60
+ * Registers a custom unary operator with the parser and evaluator.
61
+ *
62
+ * @param operator - Operator token to register.
63
+ * @param fn - Evaluator implementation for the operator.
64
+ *
65
+ * @remarks
66
+ * Registration changes module-global parser state and affects subsequent
67
+ * calls to {@link parse}.
68
+ */
69
+ export declare function addUnaryOp(operator: string, fn: UnaryOperator): void;
70
+ /**
71
+ * Registers a custom binary operator with the parser and evaluator.
72
+ *
73
+ * @param operator - Operator token to register.
74
+ * @param precedenceOrFn - Parser precedence, or the evaluator implementation
75
+ * when using the default precedence for a built-in operator.
76
+ * @param fn - Evaluator implementation when an explicit precedence is given.
77
+ *
78
+ * @remarks
79
+ * Registration changes module-global parser state and affects subsequent
80
+ * calls to {@link parse}. New operators should provide explicit precedence.
81
+ */
82
+ export declare function addBinaryOp(operator: string, precedenceOrFn: number | BinaryOperator, fn?: BinaryOperator): void;
83
+ /**
84
+ * Parses expression source into a JSEP abstract syntax tree.
85
+ *
86
+ * @param expression - Expression source or an existing AST.
87
+ * @returns A parsed AST, or the supplied AST unchanged.
88
+ * @throws If the expression string is not valid JSEP syntax.
89
+ */
90
+ export declare function parse(expression: string | JsepTypes.Expression, options?: {
91
+ log?: DiagnosticLog;
92
+ }): JsepTypes.Expression;
93
+ /**
94
+ * Evaluates a parsed expression synchronously.
95
+ *
96
+ * @param node - Expression AST to evaluate.
97
+ * @param context - Named values and functions available to the expression.
98
+ * @param options - Function libraries to add to the context.
99
+ * @returns The expression value.
100
+ */
101
+ declare function evaluateWithDiagnostics(node: JsepTypes.Expression, context: ExpressionContext, options?: ExpressionEvaluationOptions): unknown;
102
+ export { evaluateWithDiagnostics as evaluate };
103
+ /** Evaluates an expression asynchronously and reports errors to the supplied logger. */
104
+ export declare function evaluateAsync(node: JsepTypes.Expression, context: ExpressionContext, options?: ExpressionEvaluationOptions): Promise<unknown>;
105
+ //# sourceMappingURL=expression-eval.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"expression-eval.d.ts","sourceRoot":"","sources":["../../src/expressions/expression-eval.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AAGH,OAAO,EAAwB,KAAK,aAAa,EAAC,6BAA0B;AAE5E,OAAO,KAAK,EAAC,IAAI,IAAI,SAAS,EAAC,+BAA4B;AAC3D,OAAO,EAAyB,KAAK,2BAA2B,EAAC,gCAA6B;AAI9F;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,SAAS,CAAC,eAAe,GACzB,SAAS,CAAC,gBAAgB,GAC1B,SAAS,CAAC,iBAAiB,GAC3B,CAAC,SAAS,CAAC,cAAc,GAAG;IAC1B,8DAA8D,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;CACnF,CAAC,GACF,SAAS,CAAC,qBAAqB,GAC/B,SAAS,CAAC,UAAU,GACpB;IACE,kCAAkC;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,UAAU,CAAC;IACtD,0EAA0E;IAC1E,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB,GACD,SAAS,CAAC,gBAAgB,GAC1B,SAAS,CAAC,cAAc,GACxB,SAAS,CAAC,eAAe,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;AAuS5D;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC,UAAU,EACzC,OAAO,CAAC,EAAE,2BAA2B,GACpC,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAGzC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC,UAAU,EACzC,OAAO,CAAC,EAAE,2BAA2B,GACpC,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,CAGlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,GAAG,IAAI,CAGpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GAAG,cAAc,EACvC,EAAE,CAAC,EAAE,cAAc,GAClB,IAAI,CASN;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CACnB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC,UAAU,EACzC,OAAO,CAAC,EAAE;IAAC,GAAG,CAAC,EAAE,aAAa,CAAA;CAAC,GAC9B,SAAS,CAAC,UAAU,CAOtB;AAED;;;;;;;GAOG;AACH,iBAAS,uBAAuB,CAC9B,IAAI,EAAE,SAAS,CAAC,UAAU,EAC1B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAOT;AAED,OAAO,EAAC,uBAAuB,IAAI,QAAQ,EAAC,CAAC;AAE7C,wFAAwF;AACxF,wBAAsB,aAAa,CACjC,IAAI,EAAE,SAAS,CAAC,UAAU,EAC1B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,OAAO,CAAC,CAOlB"}