@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.
Files changed (334) 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 +1421 -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 +3220 -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 +180 -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 +191 -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 +65 -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/worker-entry.d.ts +2 -0
  87. package/dist/arrow/worker-entry.d.ts.map +1 -0
  88. package/dist/arrow/worker-entry.js +9 -0
  89. package/dist/arrow/worker-entry.js.map +1 -0
  90. package/dist/arrow/worker.cjs +3973 -0
  91. package/dist/arrow/worker.cjs.map +6 -0
  92. package/dist/arrow/worker.d.ts +58 -0
  93. package/dist/arrow/worker.d.ts.map +1 -0
  94. package/dist/arrow/worker.js +84 -0
  95. package/dist/arrow/worker.js.map +1 -0
  96. package/dist/color/index.cjs +382 -0
  97. package/dist/color/index.cjs.map +6 -0
  98. package/dist/color/index.d.ts +26 -0
  99. package/dist/color/index.d.ts.map +1 -0
  100. package/dist/color/index.js +306 -0
  101. package/dist/color/index.js.map +1 -0
  102. package/dist/diagnostic-log.d.ts +8 -0
  103. package/dist/diagnostic-log.d.ts.map +1 -0
  104. package/dist/diagnostic-log.js +15 -0
  105. package/dist/diagnostic-log.js.map +1 -0
  106. package/dist/expressions/ast.d.ts +12 -0
  107. package/dist/expressions/ast.d.ts.map +1 -0
  108. package/dist/expressions/ast.js +112 -0
  109. package/dist/expressions/ast.js.map +1 -0
  110. package/dist/expressions/columnar-predicate.d.ts +56 -0
  111. package/dist/expressions/columnar-predicate.d.ts.map +1 -0
  112. package/dist/expressions/columnar-predicate.js +176 -0
  113. package/dist/expressions/columnar-predicate.js.map +1 -0
  114. package/dist/expressions/evaluation-error.d.ts +14 -0
  115. package/dist/expressions/evaluation-error.d.ts.map +1 -0
  116. package/dist/expressions/evaluation-error.js +26 -0
  117. package/dist/expressions/evaluation-error.js.map +1 -0
  118. package/dist/expressions/expression-eval.d.ts +96 -0
  119. package/dist/expressions/expression-eval.d.ts.map +1 -0
  120. package/dist/expressions/expression-eval.js +330 -0
  121. package/dist/expressions/expression-eval.js.map +1 -0
  122. package/dist/expressions/function-libraries.d.ts +63 -0
  123. package/dist/expressions/function-libraries.d.ts.map +1 -0
  124. package/dist/expressions/function-libraries.js +69 -0
  125. package/dist/expressions/function-libraries.js.map +1 -0
  126. package/dist/expressions/function-registry.d.ts +93 -0
  127. package/dist/expressions/function-registry.d.ts.map +1 -0
  128. package/dist/expressions/function-registry.js +139 -0
  129. package/dist/expressions/function-registry.js.map +1 -0
  130. package/dist/expressions/get.d.ts +9 -0
  131. package/dist/expressions/get.d.ts.map +1 -0
  132. package/dist/expressions/get.js +32 -0
  133. package/dist/expressions/get.js.map +1 -0
  134. package/dist/expressions/index.cjs +1888 -0
  135. package/dist/expressions/index.cjs.map +6 -0
  136. package/dist/expressions/index.d.ts +13 -0
  137. package/dist/expressions/index.d.ts.map +1 -0
  138. package/dist/expressions/index.js +14 -0
  139. package/dist/expressions/index.js.map +1 -0
  140. package/dist/expressions/numeric-functions.d.ts +277 -0
  141. package/dist/expressions/numeric-functions.d.ts.map +1 -0
  142. package/dist/expressions/numeric-functions.js +52 -0
  143. package/dist/expressions/numeric-functions.js.map +1 -0
  144. package/dist/expressions/parse-expression-string.d.ts +21 -0
  145. package/dist/expressions/parse-expression-string.d.ts.map +1 -0
  146. package/dist/expressions/parse-expression-string.js +61 -0
  147. package/dist/expressions/parse-expression-string.js.map +1 -0
  148. package/dist/expressions/predicate-expression.d.ts +7 -0
  149. package/dist/expressions/predicate-expression.d.ts.map +1 -0
  150. package/dist/expressions/predicate-expression.js +112 -0
  151. package/dist/expressions/predicate-expression.js.map +1 -0
  152. package/dist/expressions/scalar-type.d.ts +6 -0
  153. package/dist/expressions/scalar-type.d.ts.map +1 -0
  154. package/dist/expressions/scalar-type.js +23 -0
  155. package/dist/expressions/scalar-type.js.map +1 -0
  156. package/dist/expressions/vendor/jsep/runtime.d.ts +3 -0
  157. package/dist/expressions/vendor/jsep/runtime.d.ts.map +1 -0
  158. package/dist/expressions/vendor/jsep/runtime.js +972 -0
  159. package/dist/expressions/vendor/jsep/runtime.js.map +1 -0
  160. package/dist/expressions/vendor/jsep/types.d.ts +148 -0
  161. package/dist/expressions/vendor/jsep/types.d.ts.map +1 -0
  162. package/dist/expressions/vendor/jsep/types.js +6 -0
  163. package/dist/expressions/vendor/jsep/types.js.map +1 -0
  164. package/dist/index.cjs +4865 -0
  165. package/dist/index.cjs.map +6 -0
  166. package/dist/index.d.ts +9 -0
  167. package/dist/index.d.ts.map +1 -0
  168. package/dist/index.js +10 -0
  169. package/dist/index.js.map +1 -0
  170. package/dist/math/index.cjs +444 -0
  171. package/dist/math/index.cjs.map +6 -0
  172. package/dist/math/index.d.ts +44 -0
  173. package/dist/math/index.d.ts.map +1 -0
  174. package/dist/math/index.js +182 -0
  175. package/dist/math/index.js.map +1 -0
  176. package/dist/scales/arrow-domains.d.ts +15 -0
  177. package/dist/scales/arrow-domains.d.ts.map +1 -0
  178. package/dist/scales/arrow-domains.js +124 -0
  179. package/dist/scales/arrow-domains.js.map +1 -0
  180. package/dist/scales/arrow-scales.cjs +3837 -0
  181. package/dist/scales/arrow-scales.cjs.map +6 -0
  182. package/dist/scales/arrow-scales.d.ts +20 -0
  183. package/dist/scales/arrow-scales.d.ts.map +1 -0
  184. package/dist/scales/arrow-scales.js +109 -0
  185. package/dist/scales/arrow-scales.js.map +1 -0
  186. package/dist/scales/compile-scale.d.ts +7 -0
  187. package/dist/scales/compile-scale.d.ts.map +1 -0
  188. package/dist/scales/compile-scale.js +195 -0
  189. package/dist/scales/compile-scale.js.map +1 -0
  190. package/dist/scales/hdr-colors.d.ts +13 -0
  191. package/dist/scales/hdr-colors.d.ts.map +1 -0
  192. package/dist/scales/hdr-colors.js +115 -0
  193. package/dist/scales/hdr-colors.js.map +1 -0
  194. package/dist/scales/index.cjs +1214 -0
  195. package/dist/scales/index.cjs.map +6 -0
  196. package/dist/scales/index.d.ts +9 -0
  197. package/dist/scales/index.d.ts.map +1 -0
  198. package/dist/scales/index.js +10 -0
  199. package/dist/scales/index.js.map +1 -0
  200. package/dist/scales/palettes.d.ts +5 -0
  201. package/dist/scales/palettes.d.ts.map +1 -0
  202. package/dist/scales/palettes.js +85 -0
  203. package/dist/scales/palettes.js.map +1 -0
  204. package/dist/scales/parse-sql-scale.d.ts +14 -0
  205. package/dist/scales/parse-sql-scale.d.ts.map +1 -0
  206. package/dist/scales/parse-sql-scale.js +165 -0
  207. package/dist/scales/parse-sql-scale.js.map +1 -0
  208. package/dist/scales/quantile-sketch.d.ts +22 -0
  209. package/dist/scales/quantile-sketch.d.ts.map +1 -0
  210. package/dist/scales/quantile-sketch.js +108 -0
  211. package/dist/scales/quantile-sketch.js.map +1 -0
  212. package/dist/scales/scale-types.d.ts +92 -0
  213. package/dist/scales/scale-types.d.ts.map +1 -0
  214. package/dist/scales/scale-types.js +119 -0
  215. package/dist/scales/scale-types.js.map +1 -0
  216. package/dist/scales/streaming-domains.d.ts +18 -0
  217. package/dist/scales/streaming-domains.d.ts.map +1 -0
  218. package/dist/scales/streaming-domains.js +109 -0
  219. package/dist/scales/streaming-domains.js.map +1 -0
  220. package/dist/sql/bind-sql-predicate.d.ts +4 -0
  221. package/dist/sql/bind-sql-predicate.d.ts.map +1 -0
  222. package/dist/sql/bind-sql-predicate.js +11 -0
  223. package/dist/sql/bind-sql-predicate.js.map +1 -0
  224. package/dist/sql/index.cjs +1588 -0
  225. package/dist/sql/index.cjs.map +6 -0
  226. package/dist/sql/index.d.ts +10 -0
  227. package/dist/sql/index.d.ts.map +1 -0
  228. package/dist/sql/index.js +10 -0
  229. package/dist/sql/index.js.map +1 -0
  230. package/dist/sql/parse-sql-expression.d.ts +44 -0
  231. package/dist/sql/parse-sql-expression.d.ts.map +1 -0
  232. package/dist/sql/parse-sql-expression.js +455 -0
  233. package/dist/sql/parse-sql-expression.js.map +1 -0
  234. package/dist/sql/parse-sql-predicate.d.ts +13 -0
  235. package/dist/sql/parse-sql-predicate.d.ts.map +1 -0
  236. package/dist/sql/parse-sql-predicate.js +365 -0
  237. package/dist/sql/parse-sql-predicate.js.map +1 -0
  238. package/dist/sql/parse-sql-query.d.ts +8 -0
  239. package/dist/sql/parse-sql-query.d.ts.map +1 -0
  240. package/dist/sql/parse-sql-query.js +66 -0
  241. package/dist/sql/parse-sql-query.js.map +1 -0
  242. package/dist/sql/parse-sql-select.d.ts +55 -0
  243. package/dist/sql/parse-sql-select.d.ts.map +1 -0
  244. package/dist/sql/parse-sql-select.js +244 -0
  245. package/dist/sql/parse-sql-select.js.map +1 -0
  246. package/dist/sql/parse-sql-statement.d.ts +50 -0
  247. package/dist/sql/parse-sql-statement.d.ts.map +1 -0
  248. package/dist/sql/parse-sql-statement.js +182 -0
  249. package/dist/sql/parse-sql-statement.js.map +1 -0
  250. package/dist/sql/query-types.d.ts +56 -0
  251. package/dist/sql/query-types.d.ts.map +1 -0
  252. package/dist/sql/query-types.js +5 -0
  253. package/dist/sql/query-types.js.map +1 -0
  254. package/dist/sql/sql-parse-error.d.ts +13 -0
  255. package/dist/sql/sql-parse-error.d.ts.map +1 -0
  256. package/dist/sql/sql-parse-error.js +20 -0
  257. package/dist/sql/sql-parse-error.js.map +1 -0
  258. package/dist/sql/sql-predicate-schema.d.ts +164 -0
  259. package/dist/sql/sql-predicate-schema.d.ts.map +1 -0
  260. package/dist/sql/sql-predicate-schema.js +249 -0
  261. package/dist/sql/sql-predicate-schema.js.map +1 -0
  262. package/dist/sql/sql-predicate-types.d.ts +48 -0
  263. package/dist/sql/sql-predicate-types.d.ts.map +1 -0
  264. package/dist/sql/sql-predicate-types.js +9 -0
  265. package/dist/sql/sql-predicate-types.js.map +1 -0
  266. package/dist/sql/sql-predicate.d.ts +6 -0
  267. package/dist/sql/sql-predicate.d.ts.map +1 -0
  268. package/dist/sql/sql-predicate.js +8 -0
  269. package/dist/sql/sql-predicate.js.map +1 -0
  270. package/package.json +92 -4
  271. package/src/arrow/aggregates.ts +386 -0
  272. package/src/arrow/buffers.ts +177 -0
  273. package/src/arrow/cast.ts +160 -0
  274. package/src/arrow/compiler.ts +1659 -0
  275. package/src/arrow/float16.ts +25 -0
  276. package/src/arrow/index.ts +22 -0
  277. package/src/arrow/like.ts +72 -0
  278. package/src/arrow/list-values.ts +200 -0
  279. package/src/arrow/predicate.ts +19 -0
  280. package/src/arrow/query-arrow-aggregate-snapshots.ts +107 -0
  281. package/src/arrow/query-arrow-sql.ts +227 -0
  282. package/src/arrow/query-arrow-table.ts +298 -0
  283. package/src/arrow/query-worker-entry.ts +8 -0
  284. package/src/arrow/query-worker.ts +190 -0
  285. package/src/arrow/registry.ts +86 -0
  286. package/src/arrow/relational-query.ts +247 -0
  287. package/src/arrow/replace-arrow-columns.ts +71 -0
  288. package/src/arrow/signature.ts +50 -0
  289. package/src/arrow/temporal-cast.ts +66 -0
  290. package/src/arrow/types.ts +76 -0
  291. package/src/arrow/worker-entry.ts +10 -0
  292. package/src/arrow/worker.ts +139 -0
  293. package/src/color/index.ts +405 -0
  294. package/src/diagnostic-log.ts +20 -0
  295. package/src/expressions/ast.ts +141 -0
  296. package/src/expressions/columnar-predicate.ts +293 -0
  297. package/src/expressions/evaluation-error.ts +29 -0
  298. package/src/expressions/expression-eval.ts +480 -0
  299. package/src/expressions/function-libraries.ts +126 -0
  300. package/src/expressions/function-registry.ts +171 -0
  301. package/src/expressions/get.ts +37 -0
  302. package/src/expressions/index.ts +40 -0
  303. package/src/expressions/numeric-functions.ts +99 -0
  304. package/src/expressions/parse-expression-string.ts +80 -0
  305. package/src/expressions/predicate-expression.ts +128 -0
  306. package/src/expressions/scalar-type.ts +39 -0
  307. package/src/expressions/vendor/jsep/LICENSE.txt +23 -0
  308. package/src/expressions/vendor/jsep/README.md +22 -0
  309. package/src/expressions/vendor/jsep/runtime.ts +949 -0
  310. package/src/expressions/vendor/jsep/types.ts +191 -0
  311. package/src/index.ts +40 -0
  312. package/src/math/index.ts +235 -0
  313. package/src/scales/arrow-domains.ts +131 -0
  314. package/src/scales/arrow-scales.ts +156 -0
  315. package/src/scales/compile-scale.ts +217 -0
  316. package/src/scales/hdr-colors.ts +126 -0
  317. package/src/scales/index.ts +35 -0
  318. package/src/scales/palettes.ts +86 -0
  319. package/src/scales/parse-sql-scale.ts +195 -0
  320. package/src/scales/quantile-sketch.ts +106 -0
  321. package/src/scales/scale-types.ts +224 -0
  322. package/src/scales/streaming-domains.ts +133 -0
  323. package/src/sql/bind-sql-predicate.ts +21 -0
  324. package/src/sql/index.ts +28 -0
  325. package/src/sql/parse-sql-expression.ts +457 -0
  326. package/src/sql/parse-sql-predicate.ts +454 -0
  327. package/src/sql/parse-sql-query.ts +72 -0
  328. package/src/sql/parse-sql-select.ts +266 -0
  329. package/src/sql/parse-sql-statement.ts +242 -0
  330. package/src/sql/query-types.ts +71 -0
  331. package/src/sql/sql-parse-error.ts +33 -0
  332. package/src/sql/sql-predicate-schema.ts +279 -0
  333. package/src/sql/sql-predicate-types.ts +91 -0
  334. package/src/sql/sql-predicate.ts +28 -0
@@ -0,0 +1,164 @@
1
+ import { type SQLPredicate } from "./sql-predicate-types.js";
2
+ /**
3
+ * JSON Schema for the JSON-serializable portion of the math.gl SQL predicate AST.
4
+ *
5
+ * In-process predicates additionally accept `bigint`, `Date`, and `Uint8Array` values, which JSON
6
+ * Schema cannot represent directly.
7
+ */
8
+ export declare const SQL_PREDICATE_JSON_SCHEMA: {
9
+ readonly $schema: "https://json-schema.org/draft/2020-12/schema";
10
+ readonly $id: "https://math.gl/schemas/sql-predicate.schema.json";
11
+ readonly title: "math.gl SQL predicate";
12
+ readonly oneOf: readonly [{
13
+ readonly $ref: "#/$defs/comparison";
14
+ }, {
15
+ readonly $ref: "#/$defs/in";
16
+ }, {
17
+ readonly $ref: "#/$defs/isNull";
18
+ }, {
19
+ readonly $ref: "#/$defs/logical";
20
+ }, {
21
+ readonly $ref: "#/$defs/not";
22
+ }];
23
+ readonly $defs: {
24
+ readonly property: {
25
+ readonly type: "object";
26
+ readonly required: readonly ["property"];
27
+ readonly properties: {
28
+ readonly property: {
29
+ readonly type: "string";
30
+ readonly minLength: 1;
31
+ };
32
+ readonly quoted: {
33
+ readonly type: "boolean";
34
+ };
35
+ readonly casts: {
36
+ readonly type: "array";
37
+ readonly minItems: 1;
38
+ readonly maxItems: 64;
39
+ readonly items: {
40
+ readonly enum: readonly string[];
41
+ };
42
+ };
43
+ };
44
+ readonly additionalProperties: false;
45
+ };
46
+ readonly value: {
47
+ readonly oneOf: readonly [{
48
+ readonly type: readonly ["boolean", "number", "string"];
49
+ }, {
50
+ readonly type: "object";
51
+ readonly required: readonly ["parameter"];
52
+ readonly properties: {
53
+ readonly parameter: {
54
+ readonly type: "string";
55
+ readonly minLength: 1;
56
+ };
57
+ };
58
+ readonly additionalProperties: false;
59
+ }];
60
+ };
61
+ readonly comparison: {
62
+ readonly type: "object";
63
+ readonly required: readonly ["op", "args"];
64
+ readonly properties: {
65
+ readonly op: {
66
+ readonly enum: readonly ["=", "<>", "<", "<=", ">", ">="];
67
+ };
68
+ readonly args: {
69
+ readonly type: "array";
70
+ readonly prefixItems: readonly [{
71
+ readonly $ref: "#/$defs/property";
72
+ }, {
73
+ readonly $ref: "#/$defs/value";
74
+ }];
75
+ readonly minItems: 2;
76
+ readonly maxItems: 2;
77
+ };
78
+ };
79
+ readonly additionalProperties: false;
80
+ };
81
+ readonly in: {
82
+ readonly type: "object";
83
+ readonly required: readonly ["op", "args"];
84
+ readonly properties: {
85
+ readonly op: {
86
+ readonly const: "in";
87
+ };
88
+ readonly args: {
89
+ readonly type: "array";
90
+ readonly prefixItems: readonly [{
91
+ readonly $ref: "#/$defs/property";
92
+ }, {
93
+ readonly type: "array";
94
+ readonly items: {
95
+ readonly $ref: "#/$defs/value";
96
+ };
97
+ readonly minItems: 1;
98
+ }];
99
+ readonly minItems: 2;
100
+ readonly maxItems: 2;
101
+ };
102
+ };
103
+ readonly additionalProperties: false;
104
+ };
105
+ readonly isNull: {
106
+ readonly type: "object";
107
+ readonly required: readonly ["op", "args"];
108
+ readonly properties: {
109
+ readonly op: {
110
+ readonly const: "isNull";
111
+ };
112
+ readonly args: {
113
+ readonly type: "array";
114
+ readonly prefixItems: readonly [{
115
+ readonly $ref: "#/$defs/property";
116
+ }];
117
+ readonly minItems: 1;
118
+ readonly maxItems: 1;
119
+ };
120
+ };
121
+ readonly additionalProperties: false;
122
+ };
123
+ readonly logical: {
124
+ readonly type: "object";
125
+ readonly required: readonly ["op", "args"];
126
+ readonly properties: {
127
+ readonly op: {
128
+ readonly enum: readonly ["and", "or"];
129
+ };
130
+ readonly args: {
131
+ readonly type: "array";
132
+ readonly items: {
133
+ readonly $ref: "#";
134
+ };
135
+ readonly minItems: 2;
136
+ };
137
+ };
138
+ readonly additionalProperties: false;
139
+ };
140
+ readonly not: {
141
+ readonly type: "object";
142
+ readonly required: readonly ["op", "args"];
143
+ readonly properties: {
144
+ readonly op: {
145
+ readonly const: "not";
146
+ };
147
+ readonly args: {
148
+ readonly type: "array";
149
+ readonly prefixItems: readonly [{
150
+ readonly $ref: "#";
151
+ }];
152
+ readonly minItems: 1;
153
+ readonly maxItems: 1;
154
+ };
155
+ };
156
+ readonly additionalProperties: false;
157
+ };
158
+ };
159
+ };
160
+ /** Returns whether an unknown value is a valid portable SQL predicate. */
161
+ export declare function isSQLPredicate(value: unknown): value is SQLPredicate;
162
+ /** Validates an unknown portable SQL predicate or throws a path-specific error. */
163
+ export declare function validateSQLPredicate(value: unknown): asserts value is SQLPredicate;
164
+ //# sourceMappingURL=sql-predicate-schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sql-predicate-schema.d.ts","sourceRoot":"","sources":["../../src/sql/sql-predicate-schema.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,YAAY,EAElB,iCAA8B;AAK/B;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAsBW,SAAS,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqFxD,CAAC;AAEX,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAOpE;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAGlF"}
@@ -0,0 +1,249 @@
1
+ // math.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+ import { isColumnarScalarType, COLUMNAR_SCALAR_TYPES } from "../expressions/scalar-type.js";
5
+ import { isSQLPredicateParameter } from "./sql-predicate-types.js";
6
+ const MAXIMUM_PREDICATE_DEPTH = 64;
7
+ const MAXIMUM_PREDICATE_NODES = 4096;
8
+ /**
9
+ * JSON Schema for the JSON-serializable portion of the math.gl SQL predicate AST.
10
+ *
11
+ * In-process predicates additionally accept `bigint`, `Date`, and `Uint8Array` values, which JSON
12
+ * Schema cannot represent directly.
13
+ */
14
+ export const SQL_PREDICATE_JSON_SCHEMA = {
15
+ $schema: 'https://json-schema.org/draft/2020-12/schema',
16
+ $id: 'https://math.gl/schemas/sql-predicate.schema.json',
17
+ title: 'math.gl SQL predicate',
18
+ oneOf: [
19
+ { $ref: '#/$defs/comparison' },
20
+ { $ref: '#/$defs/in' },
21
+ { $ref: '#/$defs/isNull' },
22
+ { $ref: '#/$defs/logical' },
23
+ { $ref: '#/$defs/not' }
24
+ ],
25
+ $defs: {
26
+ property: {
27
+ type: 'object',
28
+ required: ['property'],
29
+ properties: {
30
+ property: { type: 'string', minLength: 1 },
31
+ quoted: { type: 'boolean' },
32
+ casts: {
33
+ type: 'array',
34
+ minItems: 1,
35
+ maxItems: 64,
36
+ items: { enum: COLUMNAR_SCALAR_TYPES }
37
+ }
38
+ },
39
+ additionalProperties: false
40
+ },
41
+ value: {
42
+ oneOf: [
43
+ { type: ['boolean', 'number', 'string'] },
44
+ {
45
+ type: 'object',
46
+ required: ['parameter'],
47
+ properties: { parameter: { type: 'string', minLength: 1 } },
48
+ additionalProperties: false
49
+ }
50
+ ]
51
+ },
52
+ comparison: {
53
+ type: 'object',
54
+ required: ['op', 'args'],
55
+ properties: {
56
+ op: { enum: ['=', '<>', '<', '<=', '>', '>='] },
57
+ args: {
58
+ type: 'array',
59
+ prefixItems: [{ $ref: '#/$defs/property' }, { $ref: '#/$defs/value' }],
60
+ minItems: 2,
61
+ maxItems: 2
62
+ }
63
+ },
64
+ additionalProperties: false
65
+ },
66
+ in: {
67
+ type: 'object',
68
+ required: ['op', 'args'],
69
+ properties: {
70
+ op: { const: 'in' },
71
+ args: {
72
+ type: 'array',
73
+ prefixItems: [
74
+ { $ref: '#/$defs/property' },
75
+ { type: 'array', items: { $ref: '#/$defs/value' }, minItems: 1 }
76
+ ],
77
+ minItems: 2,
78
+ maxItems: 2
79
+ }
80
+ },
81
+ additionalProperties: false
82
+ },
83
+ isNull: {
84
+ type: 'object',
85
+ required: ['op', 'args'],
86
+ properties: {
87
+ op: { const: 'isNull' },
88
+ args: {
89
+ type: 'array',
90
+ prefixItems: [{ $ref: '#/$defs/property' }],
91
+ minItems: 1,
92
+ maxItems: 1
93
+ }
94
+ },
95
+ additionalProperties: false
96
+ },
97
+ logical: {
98
+ type: 'object',
99
+ required: ['op', 'args'],
100
+ properties: {
101
+ op: { enum: ['and', 'or'] },
102
+ args: { type: 'array', items: { $ref: '#' }, minItems: 2 }
103
+ },
104
+ additionalProperties: false
105
+ },
106
+ not: {
107
+ type: 'object',
108
+ required: ['op', 'args'],
109
+ properties: {
110
+ op: { const: 'not' },
111
+ args: {
112
+ type: 'array',
113
+ prefixItems: [{ $ref: '#' }],
114
+ minItems: 1,
115
+ maxItems: 1
116
+ }
117
+ },
118
+ additionalProperties: false
119
+ }
120
+ }
121
+ };
122
+ /** Returns whether an unknown value is a valid portable SQL predicate. */
123
+ export function isSQLPredicate(value) {
124
+ try {
125
+ validateSQLPredicate(value);
126
+ return true;
127
+ }
128
+ catch {
129
+ return false;
130
+ }
131
+ }
132
+ /** Validates an unknown portable SQL predicate or throws a path-specific error. */
133
+ export function validateSQLPredicate(value) {
134
+ const state = { nodes: 0 };
135
+ validatePredicateNode(value, '$', 0, state);
136
+ }
137
+ /** Validates one recursive predicate node. */
138
+ function validatePredicateNode(value, path, depth, state) {
139
+ if (depth > MAXIMUM_PREDICATE_DEPTH) {
140
+ throw new Error(`SQL predicate ${path} exceeds the maximum nesting depth`);
141
+ }
142
+ state.nodes++;
143
+ if (state.nodes > MAXIMUM_PREDICATE_NODES) {
144
+ throw new Error('SQL predicate exceeds the maximum node count');
145
+ }
146
+ if (!isRecord(value) || !hasExactKeys(value, ['op', 'args'])) {
147
+ throw new Error(`SQL predicate ${path} must contain only op and args`);
148
+ }
149
+ if (typeof value['op'] !== 'string' || !Array.isArray(value['args'])) {
150
+ throw new Error(`SQL predicate ${path} requires string op and array args`);
151
+ }
152
+ switch (value['op']) {
153
+ case 'and':
154
+ case 'or':
155
+ if (value['args'].length < 2) {
156
+ throw new Error(`SQL predicate ${path}.${value['op']} requires at least two arguments`);
157
+ }
158
+ for (let index = 0; index < value['args'].length; index++) {
159
+ validatePredicateNode(value['args'][index], `${path}.args[${index}]`, depth + 1, state);
160
+ }
161
+ return;
162
+ case 'not':
163
+ if (value['args'].length !== 1) {
164
+ throw new Error(`SQL predicate ${path}.not requires exactly one argument`);
165
+ }
166
+ validatePredicateNode(value['args'][0], `${path}.args[0]`, depth + 1, state);
167
+ return;
168
+ case 'isNull':
169
+ if (value['args'].length !== 1) {
170
+ throw new Error(`SQL predicate ${path}.isNull requires exactly one argument`);
171
+ }
172
+ validatePredicateProperty(value['args'][0], `${path}.args[0]`);
173
+ return;
174
+ case 'in':
175
+ if (value['args'].length !== 2 ||
176
+ !Array.isArray(value['args'][1]) ||
177
+ value['args'][1].length === 0) {
178
+ throw new Error(`SQL predicate ${path}.in requires a property and non-empty value list`);
179
+ }
180
+ validatePredicateProperty(value['args'][0], `${path}.args[0]`);
181
+ for (let index = 0; index < value['args'][1].length; index++) {
182
+ validatePredicateValue(value['args'][1][index], `${path}.args[1][${index}]`);
183
+ }
184
+ return;
185
+ case '=':
186
+ case '<>':
187
+ case '<':
188
+ case '<=':
189
+ case '>':
190
+ case '>=':
191
+ if (value['args'].length !== 2) {
192
+ throw new Error(`SQL predicate ${path}.${value['op']} requires exactly two arguments`);
193
+ }
194
+ validatePredicateProperty(value['args'][0], `${path}.args[0]`);
195
+ validatePredicateValue(value['args'][1], `${path}.args[1]`);
196
+ return;
197
+ default:
198
+ throw new Error(`SQL predicate ${path} has unsupported operator ${JSON.stringify(value['op'])}`);
199
+ }
200
+ }
201
+ /** Validates one property reference. */
202
+ function validatePredicateProperty(value, path) {
203
+ if (!isRecord(value) ||
204
+ !hasAllowedKeys(value, ['property', 'quoted', 'casts']) ||
205
+ typeof value['property'] !== 'string' ||
206
+ value['property'].length === 0 ||
207
+ (value['quoted'] !== undefined && typeof value['quoted'] !== 'boolean')) {
208
+ throw new Error(`SQL predicate ${path} requires a non-empty property reference`);
209
+ }
210
+ const casts = value['casts'];
211
+ if (casts !== undefined &&
212
+ (!Array.isArray(casts) ||
213
+ !casts.length ||
214
+ casts.length > 64 ||
215
+ Array.from(casts).some(type => !isColumnarScalarType(type))))
216
+ throw new Error(`SQL predicate ${path} has invalid casts`);
217
+ }
218
+ /** Validates one structured-cloneable predicate scalar. */
219
+ function validatePredicateValue(value, path) {
220
+ if (isSQLPredicateParameter(value)) {
221
+ return;
222
+ }
223
+ if (typeof value === 'boolean' ||
224
+ typeof value === 'bigint' ||
225
+ typeof value === 'string' ||
226
+ value instanceof Uint8Array) {
227
+ return;
228
+ }
229
+ if (typeof value === 'number' && Number.isFinite(value)) {
230
+ return;
231
+ }
232
+ if (value instanceof Date && Number.isFinite(value.getTime())) {
233
+ return;
234
+ }
235
+ throw new Error(`SQL predicate ${path} contains an unsupported scalar value`);
236
+ }
237
+ /** Returns whether an unknown value is a non-null object. */
238
+ function isRecord(value) {
239
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
240
+ }
241
+ /** Returns whether an object contains exactly the expected enumerable keys. */
242
+ function hasExactKeys(value, expectedKeys) {
243
+ const keys = Object.keys(value);
244
+ return keys.length === expectedKeys.length && expectedKeys.every(key => keys.includes(key));
245
+ }
246
+ function hasAllowedKeys(value, allowedKeys) {
247
+ return Object.keys(value).every(key => allowedKeys.includes(key));
248
+ }
249
+ //# sourceMappingURL=sql-predicate-schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sql-predicate-schema.js","sourceRoot":"","sources":["../../src/sql/sql-predicate-schema.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,48 @@
1
+ import type { ColumnarScalarType } from "../expressions/scalar-type.js";
2
+ import { type ColumnarComparisonPredicate, type ColumnarInPredicate, type ColumnarLogicalPredicate, type ColumnarNotPredicate, type ColumnarNullPredicate, type ColumnarPredicate, type ColumnarPredicateInputValue, type ColumnarPredicateParameter, type ColumnarPredicateParameterValues, type ColumnarPredicateValue } from "../expressions/columnar-predicate.js";
3
+ /** Scalar values supported by portable SQL predicate expressions. */
4
+ export type SQLPredicateScalar = ColumnarPredicateValue;
5
+ /** Named parameter reference retained in a portable SQL predicate until execution time. */
6
+ export type SQLPredicateParameter = ColumnarPredicateParameter;
7
+ /** Scalar value or unresolved named parameter accepted by a portable predicate expression. */
8
+ export type SQLPredicateValue = ColumnarPredicateInputValue;
9
+ /** Runtime values used to bind named predicate parameters before a backend executes them. */
10
+ export type SQLPredicateParameterValues = ColumnarPredicateParameterValues;
11
+ /** Reference to one column in a portable SQL predicate expression. */
12
+ export type SQLPredicateProperty = Readonly<{
13
+ /** Column or qualified column name. */
14
+ property: string;
15
+ /** Whether the complete property was a quoted SQL identifier. */
16
+ quoted?: boolean;
17
+ /** Explicit conversions, applied in order before predicate comparison. */
18
+ casts?: readonly ColumnarScalarType[];
19
+ }>;
20
+ /** Binary comparison between a column and a scalar value. */
21
+ export type SQLComparisonPredicate = Readonly<ColumnarComparisonPredicate<SQLPredicateValue, SQLPredicateProperty>>;
22
+ /** Membership test between a column and scalar values. */
23
+ export type SQLInPredicate = Readonly<ColumnarInPredicate<SQLPredicateValue, SQLPredicateProperty>>;
24
+ /** Null test for one column. */
25
+ export type SQLNullPredicate = Readonly<ColumnarNullPredicate<SQLPredicateProperty>>;
26
+ /** Conjunction or disjunction of two or more predicates. */
27
+ export type SQLLogicalPredicate = Readonly<ColumnarLogicalPredicate<SQLPredicateValue, SQLPredicateProperty>>;
28
+ /** Negation of one predicate. */
29
+ export type SQLNotPredicate = Readonly<ColumnarNotPredicate<SQLPredicateValue, SQLPredicateProperty>>;
30
+ /**
31
+ * Portable predicate AST emitted by the math.gl SQL expression parser.
32
+ *
33
+ * The expression shape is directionally aligned with CQL2 JSON, but this deliberately small
34
+ * subset does not claim CQL2 conformance.
35
+ */
36
+ export type SQLPredicate = SQLComparisonPredicate | SQLInPredicate | SQLNullPredicate | SQLLogicalPredicate | SQLNotPredicate;
37
+ /** Portable SQL predicate whose named parameters have all been replaced by concrete scalars. */
38
+ export type BoundSQLPredicate = ColumnarPredicate<SQLPredicateScalar, SQLPredicateProperty>;
39
+ /** Options for parsing one SQL predicate expression. */
40
+ export type SQLPredicateParserOptions = Readonly<{
41
+ /** Named values referenced using SQL parameters such as `:minimumFare`. */
42
+ parameters?: SQLPredicateParameterValues;
43
+ /** Retains named references in the emitted AST instead of resolving them while parsing. */
44
+ preserveParameters?: boolean;
45
+ }>;
46
+ /** Returns whether a value is a named parameter reference. */
47
+ export declare function isSQLPredicateParameter(value: unknown): value is SQLPredicateParameter;
48
+ //# sourceMappingURL=sql-predicate-types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sql-predicate-types.d.ts","sourceRoot":"","sources":["../../src/sql/sql-predicate-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,kBAAkB,EAAC,sCAAmC;AAEnE,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,gCAAgC,EACrC,KAAK,sBAAsB,EAC5B,6CAA0C;AAE3C,qEAAqE;AACrE,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAExD,2FAA2F;AAC3F,MAAM,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAE/D,8FAA8F;AAC9F,MAAM,MAAM,iBAAiB,GAAG,2BAA2B,CAAC;AAE5D,6FAA6F;AAC7F,MAAM,MAAM,2BAA2B,GAAG,gCAAgC,CAAC;AAE3E,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACvC,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAC3C,2BAA2B,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CACrE,CAAC;AAEF,0DAA0D;AAC1D,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAEpG,gCAAgC;AAChC,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,qBAAqB,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAErF,4DAA4D;AAC5D,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CACxC,wBAAwB,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAClE,CAAC;AAEF,iCAAiC;AACjC,MAAM,MAAM,eAAe,GAAG,QAAQ,CACpC,oBAAoB,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAC9D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACpB,sBAAsB,GACtB,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,CAAC;AAEpB,gGAAgG;AAChG,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAC;AAE5F,wDAAwD;AACxD,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,2EAA2E;IAC3E,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,2FAA2F;IAC3F,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC,CAAC;AAEH,8DAA8D;AAC9D,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAEtF"}
@@ -0,0 +1,9 @@
1
+ // math.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+ import { isColumnarPredicateParameter } from "../expressions/columnar-predicate.js";
5
+ /** Returns whether a value is a named parameter reference. */
6
+ export function isSQLPredicateParameter(value) {
7
+ return isColumnarPredicateParameter(value);
8
+ }
9
+ //# sourceMappingURL=sql-predicate-types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sql-predicate-types.js","sourceRoot":"","sources":["../../src/sql/sql-predicate-types.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAI5D,OAAO,EACL,4BAA4B,EAW7B,6CAA0C;AAqE3C,8DAA8D;AAC9D,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,4BAA4B,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC"}
@@ -0,0 +1,6 @@
1
+ export { parseSQLPredicate } from "./parse-sql-predicate.js";
2
+ export { isSQLPredicate, SQL_PREDICATE_JSON_SCHEMA, validateSQLPredicate } from "./sql-predicate-schema.js";
3
+ export { bindSQLPredicate } from "./bind-sql-predicate.js";
4
+ export { isSQLPredicateParameter } from "./sql-predicate-types.js";
5
+ export type { BoundSQLPredicate, SQLComparisonPredicate, SQLInPredicate, SQLLogicalPredicate, SQLNotPredicate, SQLNullPredicate, SQLPredicate, SQLPredicateParameter, SQLPredicateParameterValues, SQLPredicateParserOptions, SQLPredicateProperty, SQLPredicateScalar, SQLPredicateValue } from "./sql-predicate-types.js";
6
+ //# sourceMappingURL=sql-predicate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sql-predicate.d.ts","sourceRoot":"","sources":["../../src/sql/sql-predicate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,iBAAiB,EAAC,iCAA8B;AACxD,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,oBAAoB,EACrB,kCAA+B;AAChC,OAAO,EAAC,gBAAgB,EAAC,gCAA6B;AACtD,OAAO,EAAC,uBAAuB,EAAC,iCAA8B;AAE9D,YAAY,EACV,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,2BAA2B,EAC3B,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EAClB,iCAA8B"}
@@ -0,0 +1,8 @@
1
+ // math.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+ export { parseSQLPredicate } from "./parse-sql-predicate.js";
5
+ export { isSQLPredicate, SQL_PREDICATE_JSON_SCHEMA, validateSQLPredicate } from "./sql-predicate-schema.js";
6
+ export { bindSQLPredicate } from "./bind-sql-predicate.js";
7
+ export { isSQLPredicateParameter } from "./sql-predicate-types.js";
8
+ //# sourceMappingURL=sql-predicate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sql-predicate.js","sourceRoot":"","sources":["../../src/sql/sql-predicate.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAE5D,OAAO,EAAC,iBAAiB,EAAC,iCAA8B;AACxD,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,oBAAoB,EACrB,kCAA+B;AAChC,OAAO,EAAC,gBAAgB,EAAC,gCAA6B;AACtD,OAAO,EAAC,uBAAuB,EAAC,iCAA8B"}
package/package.json CHANGED
@@ -1,6 +1,94 @@
1
1
  {
2
2
  "name": "@math.gl/sql",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "5.0.0-beta.11",
4
+ "description": "Lightweight SQL query engine for Apache Arrow tables",
5
+ "license": "MIT",
6
+ "type": "module",
7
+ "publishConfig": {
8
+ "access": "public"
9
+ },
10
+ "repository": {
11
+ "type": "git",
12
+ "url": "https://github.com/visgl/math.gl.git"
13
+ },
14
+ "types": "dist/index.d.ts",
15
+ "main": "dist/index.cjs",
16
+ "module": "dist/index.js",
17
+ "files": [
18
+ "dist",
19
+ "src",
20
+ "!src/**/README.md",
21
+ "README.md",
22
+ "LICENSE",
23
+ "THIRD-PARTY-NOTICES.md"
24
+ ],
25
+ "exports": {
26
+ ".": {
27
+ "types": "./dist/index.d.ts",
28
+ "import": "./dist/index.js",
29
+ "require": "./dist/index.cjs"
30
+ },
31
+ "./scales": {
32
+ "types": "./dist/scales/index.d.ts",
33
+ "import": "./dist/scales/index.js",
34
+ "require": "./dist/scales/index.cjs"
35
+ },
36
+ "./arrow-scales": {
37
+ "types": "./dist/scales/arrow-scales.d.ts",
38
+ "import": "./dist/scales/arrow-scales.js",
39
+ "require": "./dist/scales/arrow-scales.cjs"
40
+ },
41
+ "./parser": {
42
+ "types": "./dist/sql/index.d.ts",
43
+ "import": "./dist/sql/index.js",
44
+ "require": "./dist/sql/index.cjs"
45
+ },
46
+ "./expressions": {
47
+ "types": "./dist/expressions/index.d.ts",
48
+ "import": "./dist/expressions/index.js",
49
+ "require": "./dist/expressions/index.cjs"
50
+ },
51
+ "./arrow": {
52
+ "types": "./dist/arrow/index.d.ts",
53
+ "import": "./dist/arrow/index.js",
54
+ "require": "./dist/arrow/index.cjs"
55
+ },
56
+ "./worker": {
57
+ "types": "./dist/arrow/worker.d.ts",
58
+ "import": "./dist/arrow/worker.js",
59
+ "require": "./dist/arrow/worker.cjs"
60
+ },
61
+ "./worker-entry.js": "./dist/arrow/worker-entry.js",
62
+ "./query-worker-entry.js": "./dist/arrow/query-worker-entry.js",
63
+ "./math-functions": {
64
+ "types": "./dist/math/index.d.ts",
65
+ "import": "./dist/math/index.js",
66
+ "require": "./dist/math/index.cjs"
67
+ },
68
+ "./color-functions": {
69
+ "types": "./dist/color/index.d.ts",
70
+ "import": "./dist/color/index.js",
71
+ "require": "./dist/color/index.cjs"
72
+ }
73
+ },
74
+ "sideEffects": [
75
+ "./dist/arrow/worker-entry.js",
76
+ "./src/arrow/worker-entry.ts",
77
+ "./dist/arrow/query-worker-entry.js",
78
+ "./src/arrow/query-worker-entry.ts"
79
+ ],
80
+ "dependencies": {
81
+ "@math.gl/arrow": "5.0.0-beta.11",
82
+ "@math.gl/core": "5.0.0-beta.11",
83
+ "@math.gl/geometry": "5.0.0-beta.11",
84
+ "@math.gl/tasks": "5.0.0-beta.11"
85
+ },
86
+ "peerDependencies": {
87
+ "apache-arrow": ">=17.0.0"
88
+ },
89
+ "peerDependenciesMeta": {
90
+ "apache-arrow": {
91
+ "optional": true
92
+ }
93
+ }
94
+ }