@loaders.gl/sql 5.0.0-alpha.1 → 5.0.0-alpha.3

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 (94) hide show
  1. package/LICENSE +14 -3
  2. package/README.md +107 -0
  3. package/dist/arrow-query.cjs +1373 -0
  4. package/dist/arrow-query.cjs.map +6 -0
  5. package/dist/arrow-query.d.ts +5 -0
  6. package/dist/arrow-query.d.ts.map +1 -0
  7. package/dist/arrow-query.js +6 -0
  8. package/dist/arrow-query.js.map +1 -0
  9. package/dist/arrow-table-source.d.ts +27 -0
  10. package/dist/arrow-table-source.d.ts.map +1 -0
  11. package/dist/arrow-table-source.js +79 -0
  12. package/dist/arrow-table-source.js.map +1 -0
  13. package/dist/bind-sql-predicate.d.ts +4 -0
  14. package/dist/bind-sql-predicate.d.ts.map +1 -0
  15. package/dist/bind-sql-predicate.js +11 -0
  16. package/dist/bind-sql-predicate.js.map +1 -0
  17. package/dist/compile-table-query.d.ts +55 -0
  18. package/dist/compile-table-query.d.ts.map +1 -0
  19. package/dist/compile-table-query.js +255 -0
  20. package/dist/compile-table-query.js.map +1 -0
  21. package/dist/duckdb-sql-source.d.ts.map +1 -1
  22. package/dist/duckdb-sql-source.js +21 -7
  23. package/dist/duckdb-sql-source.js.map +1 -1
  24. package/dist/index.cjs +3154 -35
  25. package/dist/index.cjs.map +3 -4
  26. package/dist/index.d.ts +16 -1
  27. package/dist/index.d.ts.map +1 -1
  28. package/dist/index.js +9 -0
  29. package/dist/index.js.map +1 -1
  30. package/dist/parse-sql-predicate.d.ts +10 -0
  31. package/dist/parse-sql-predicate.d.ts.map +1 -0
  32. package/dist/parse-sql-predicate.js +322 -0
  33. package/dist/parse-sql-predicate.js.map +1 -0
  34. package/dist/query-arrow-table.d.ts +83 -0
  35. package/dist/query-arrow-table.d.ts.map +1 -0
  36. package/dist/query-arrow-table.js +660 -0
  37. package/dist/query-arrow-table.js.map +1 -0
  38. package/dist/snowflake-sql-source.d.ts.map +1 -1
  39. package/dist/snowflake-sql-source.js +8 -5
  40. package/dist/snowflake-sql-source.js.map +1 -1
  41. package/dist/sql-predicate-schema.d.ts +156 -0
  42. package/dist/sql-predicate-schema.d.ts.map +1 -0
  43. package/dist/sql-predicate-schema.js +226 -0
  44. package/dist/sql-predicate-schema.js.map +1 -0
  45. package/dist/sql-predicate-types.d.ts +45 -0
  46. package/dist/sql-predicate-types.d.ts.map +1 -0
  47. package/dist/sql-predicate-types.js +9 -0
  48. package/dist/sql-predicate-types.js.map +1 -0
  49. package/dist/sql-predicate-zod.cjs +54 -0
  50. package/dist/sql-predicate-zod.cjs.map +6 -0
  51. package/dist/sql-predicate-zod.d.ts +11 -0
  52. package/dist/sql-predicate-zod.d.ts.map +1 -0
  53. package/dist/sql-predicate-zod.js +45 -0
  54. package/dist/sql-predicate-zod.js.map +1 -0
  55. package/dist/sql-predicate.cjs +607 -0
  56. package/dist/sql-predicate.cjs.map +6 -0
  57. package/dist/sql-predicate.d.ts +6 -0
  58. package/dist/sql-predicate.d.ts.map +1 -0
  59. package/dist/sql-predicate.js +8 -0
  60. package/dist/sql-predicate.js.map +1 -0
  61. package/dist/sql-source.d.ts +16 -3
  62. package/dist/sql-source.d.ts.map +1 -1
  63. package/dist/sql-source.js +34 -5
  64. package/dist/sql-source.js.map +1 -1
  65. package/dist/sql-types.d.ts +3 -0
  66. package/dist/sql-types.d.ts.map +1 -1
  67. package/dist/table-query-capabilities.d.ts +6 -0
  68. package/dist/table-query-capabilities.d.ts.map +1 -0
  69. package/dist/table-query-capabilities.js +26 -0
  70. package/dist/table-query-capabilities.js.map +1 -0
  71. package/dist/table-query.cjs +286 -0
  72. package/dist/table-query.cjs.map +6 -0
  73. package/dist/table-query.d.ts +29 -0
  74. package/dist/table-query.d.ts.map +1 -0
  75. package/dist/table-query.js +30 -0
  76. package/dist/table-query.js.map +1 -0
  77. package/package.json +45 -8
  78. package/src/arrow-query.ts +17 -0
  79. package/src/arrow-table-source.ts +111 -0
  80. package/src/bind-sql-predicate.ts +21 -0
  81. package/src/compile-table-query.ts +354 -0
  82. package/src/duckdb-sql-source.ts +30 -6
  83. package/src/index.ts +57 -0
  84. package/src/parse-sql-predicate.ts +381 -0
  85. package/src/query-arrow-table.ts +843 -0
  86. package/src/snowflake-sql-source.ts +7 -4
  87. package/src/sql-predicate-schema.ts +251 -0
  88. package/src/sql-predicate-types.ts +87 -0
  89. package/src/sql-predicate-zod.ts +52 -0
  90. package/src/sql-predicate.ts +28 -0
  91. package/src/sql-source.ts +40 -5
  92. package/src/sql-types.ts +4 -0
  93. package/src/table-query-capabilities.ts +29 -0
  94. package/src/table-query.ts +78 -0
@@ -1,7 +1,7 @@
1
1
  import type { ArrowTable, Schema } from '@loaders.gl/schema';
2
2
  import { DataSource } from '@loaders.gl/loader-utils';
3
3
  import type { CoreAPI, RequiredOptions } from '@loaders.gl/loader-utils';
4
- import type { SQLAdapter, SQLAdapterFactory, SQLCatalogInfo, SQLMetadata, SQLQueryOptions, SQLSchemaInfo, SQLSourceOptions, SQLTableInfo } from "./sql-types.js";
4
+ import type { SQLAdapter, SQLAdapterFactory, SQLCatalogInfo, SQLMetadata, SQLQuery, SQLQueryOptions, SQLSchemaInfo, SQLSourceOptions, SQLTableInfo } from "./sql-types.js";
5
5
  /** Registers a runtime adapter for a SQL source type. */
6
6
  export declare function registerSQLAdapter(type: string, factory: SQLAdapterFactory): void;
7
7
  /** Returns the registered adapter factory for a SQL source type. */
@@ -10,6 +10,17 @@ export declare function getSQLAdapterFactory(type: string): SQLAdapterFactory |
10
10
  export declare const SQL_SOURCE_DEFAULT_OPTIONS: Omit<RequiredOptions<SQLSourceOptions>, 'core'>;
11
11
  /** Shared SQL-backed data source implementation. */
12
12
  export declare class SQLDataSource extends DataSource<string, SQLSourceOptions> {
13
+ /** Optimization and execution capabilities of portable table-bound queries. */
14
+ readonly tableQueryCapabilities: Readonly<{
15
+ projection: import("@loaders.gl/loader-utils").TableQueryOperatorSupport;
16
+ predicate: import("@loaders.gl/loader-utils").TableQueryOperatorSupport;
17
+ limit: import("@loaders.gl/loader-utils").TableQueryOperatorSupport;
18
+ streaming: boolean;
19
+ cancellation: boolean;
20
+ expressions?: import("@loaders.gl/loader-utils").TableQueryOperatorSupport;
21
+ orderBy?: import("@loaders.gl/loader-utils").TableQueryOperatorSupport;
22
+ aggregates?: import("@loaders.gl/loader-utils").TableQueryOperatorSupport;
23
+ }>;
13
24
  private readonly sourceType;
14
25
  private readonly adapterFactory?;
15
26
  private adapterPromise;
@@ -33,12 +44,14 @@ export declare class SQLDataSource extends DataSource<string, SQLSourceOptions>
33
44
  tableName: string;
34
45
  }): Promise<Schema>;
35
46
  /** Executes a SQL query and returns object rows. */
36
- queryRows(sqlText: string, options?: SQLQueryOptions): Promise<Record<string, unknown>[]>;
47
+ queryRows(query: SQLQuery, options?: SQLQueryOptions): Promise<Record<string, unknown>[]>;
37
48
  /** Executes a SQL query and returns a loaders.gl Arrow table. */
38
- queryArrow(sqlText: string, options?: SQLQueryOptions): Promise<ArrowTable>;
49
+ queryArrow(query: SQLQuery, options?: SQLQueryOptions): Promise<ArrowTable>;
39
50
  /** Closes any underlying adapter connection. */
40
51
  close(): Promise<void>;
41
52
  protected getAdapter(): Promise<SQLAdapter>;
53
+ /** Converts a portable query object to SQL while leaving raw SQL text unchanged. */
54
+ private compileQuery;
42
55
  private loadAdapter;
43
56
  private loadMetadata;
44
57
  }
@@ -1 +1 @@
1
- {"version":3,"file":"sql-source.d.ts","sourceRoot":"","sources":["../src/sql-source.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,UAAU,EAAE,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAC,UAAU,EAAC,MAAM,0BAA0B,CAAC;AACpD,OAAO,KAAK,EAAC,OAAO,EAAE,eAAe,EAAC,MAAM,0BAA0B,CAAC;AAEvE,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,YAAY,EACb,uBAAoB;AAKrB,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAEjF;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEhF;AAED,8CAA8C;AAC9C,eAAO,MAAM,0BAA0B,EAAE,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAuBtF,CAAC;AAEF,oDAAoD;AACpD,qBAAa,aAAc,SAAQ,UAAU,CAAC,MAAM,EAAE,gBAAgB,CAAC;IACrE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAoB;IACpD,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,eAAe,CAAqC;gBAG1D,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,MAAM,EAClB,cAAc,GAAE,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAA8B,EAC5F,cAAc,CAAC,EAAE,iBAAiB,EAClC,OAAO,CAAC,EAAE,OAAO;IAOnB,6DAA6D;IACvD,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAOzC,4DAA4D;IACtD,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAK/C,2DAA2D;IACrD,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAKjE,0DAA0D;IACpD,UAAU,CAAC,OAAO,CAAC,EAAE;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAKhG,mDAAmD;IAC7C,cAAc,CAAC,OAAO,EAAE;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,MAAM,CAAC;IAKnB,oDAAoD;IAC9C,SAAS,CACb,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAKrC,iEAAiE;IAC3D,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IASrF,gDAAgD;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;cAUZ,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;YAOnC,WAAW;YA0BX,YAAY;CAe3B"}
1
+ {"version":3,"file":"sql-source.d.ts","sourceRoot":"","sources":["../src/sql-source.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,UAAU,EAAE,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAC,UAAU,EAAC,MAAM,0BAA0B,CAAC;AACpD,OAAO,KAAK,EAAC,OAAO,EAAE,eAAe,EAAC,MAAM,0BAA0B,CAAC;AAEvE,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,QAAQ,EACR,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,YAAY,EACb,uBAAoB;AAQrB,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAEjF;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEhF;AAED,8CAA8C;AAC9C,eAAO,MAAM,0BAA0B,EAAE,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAuBtF,CAAC;AAEF,oDAAoD;AACpD,qBAAa,aAAc,SAAQ,UAAU,CAAC,MAAM,EAAE,gBAAgB,CAAC;IACrE,+EAA+E;IAC/E,QAAQ,CAAC,sBAAsB;;;;;;;;;OAA4C;IAC3E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAoB;IACpD,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,eAAe,CAAqC;gBAG1D,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,MAAM,EAClB,cAAc,GAAE,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAA8B,EAC5F,cAAc,CAAC,EAAE,iBAAiB,EAClC,OAAO,CAAC,EAAE,OAAO;IAOnB,6DAA6D;IACvD,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAOzC,4DAA4D;IACtD,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAK/C,2DAA2D;IACrD,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAKjE,0DAA0D;IACpD,UAAU,CAAC,OAAO,CAAC,EAAE;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAKhG,mDAAmD;IAC7C,cAAc,CAAC,OAAO,EAAE;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,MAAM,CAAC;IAKnB,oDAAoD;IAC9C,SAAS,CACb,KAAK,EAAE,QAAQ,EACf,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAMrC,iEAAiE;IAC3D,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IAUrF,gDAAgD;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;cAUZ,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAOjD,oFAAoF;IACpF,OAAO,CAAC,YAAY;YAmBN,WAAW;YA0BX,YAAY;CAe3B"}
@@ -2,7 +2,9 @@
2
2
  // SPDX-License-Identifier: MIT
3
3
  // Copyright (c) vis.gl contributors
4
4
  import { DataSource } from '@loaders.gl/loader-utils';
5
+ import { compileSQLTableQuery } from "./compile-table-query.js";
5
6
  import { convertRowsToArrowTable, isNodeRuntime } from "./sql-utils.js";
7
+ import { SQL_DATA_SOURCE_TABLE_QUERY_CAPABILITIES } from "./table-query-capabilities.js";
6
8
  const SQL_ADAPTER_FACTORIES = new Map();
7
9
  /** Registers a runtime adapter for a SQL source type. */
8
10
  export function registerSQLAdapter(type, factory) {
@@ -39,6 +41,8 @@ export const SQL_SOURCE_DEFAULT_OPTIONS = {
39
41
  };
40
42
  /** Shared SQL-backed data source implementation. */
41
43
  export class SQLDataSource extends DataSource {
44
+ /** Optimization and execution capabilities of portable table-bound queries. */
45
+ tableQueryCapabilities = SQL_DATA_SOURCE_TABLE_QUERY_CAPABILITIES;
42
46
  sourceType;
43
47
  adapterFactory;
44
48
  adapterPromise = null;
@@ -76,17 +80,19 @@ export class SQLDataSource extends DataSource {
76
80
  return await adapter.getTableSchema(options);
77
81
  }
78
82
  /** Executes a SQL query and returns object rows. */
79
- async queryRows(sqlText, options = {}) {
83
+ async queryRows(query, options = {}) {
80
84
  const adapter = await this.getAdapter();
81
- return await adapter.executeRows(sqlText, options);
85
+ const compiledQuery = this.compileQuery(query, options);
86
+ return await adapter.executeRows(compiledQuery.sql, compiledQuery.options);
82
87
  }
83
88
  /** Executes a SQL query and returns a loaders.gl Arrow table. */
84
- async queryArrow(sqlText, options = {}) {
89
+ async queryArrow(query, options = {}) {
85
90
  const adapter = await this.getAdapter();
91
+ const compiledQuery = this.compileQuery(query, options);
86
92
  if (adapter.executeArrow) {
87
- return await adapter.executeArrow(sqlText, options);
93
+ return await adapter.executeArrow(compiledQuery.sql, compiledQuery.options);
88
94
  }
89
- const rows = await adapter.executeRows(sqlText, options);
95
+ const rows = await adapter.executeRows(compiledQuery.sql, compiledQuery.options);
90
96
  return convertRowsToArrowTable(rows);
91
97
  }
92
98
  /** Closes any underlying adapter connection. */
@@ -105,6 +111,21 @@ export class SQLDataSource extends DataSource {
105
111
  }
106
112
  return await this.adapterPromise;
107
113
  }
114
+ /** Converts a portable query object to SQL while leaving raw SQL text unchanged. */
115
+ compileQuery(query, options) {
116
+ if (typeof query === 'string') {
117
+ return { sql: query, options };
118
+ }
119
+ const namedParameters = options.parameters && !Array.isArray(options.parameters) ? options.parameters : undefined;
120
+ const compiledQuery = compileSQLTableQuery(query, {
121
+ dialect: getSQLTableQueryDialect(this.sourceType),
122
+ parameters: namedParameters
123
+ });
124
+ return {
125
+ sql: compiledQuery.sql,
126
+ options: { signal: options.signal, parameters: compiledQuery.parameters }
127
+ };
128
+ }
108
129
  async loadAdapter() {
109
130
  try {
110
131
  const runtimeFactory = isNodeRuntime()
@@ -143,4 +164,12 @@ export class SQLDataSource extends DataSource {
143
164
  };
144
165
  }
145
166
  }
167
+ /** Maps a SQL source adapter to the dialect used by the portable query compiler. */
168
+ function getSQLTableQueryDialect(sourceType) {
169
+ if (sourceType === 'duckdb-sql')
170
+ return 'duckdb';
171
+ if (sourceType === 'snowflake-sql')
172
+ return 'snowflake';
173
+ throw new Error(`Portable table queries are not supported for SQL source type "${sourceType}".`);
174
+ }
146
175
  //# sourceMappingURL=sql-source.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"sql-source.js","sourceRoot":"","sources":["../src/sql-source.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"sql-source.js","sourceRoot":"","sources":["../src/sql-source.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,9 @@
1
1
  import type { ArrowTable, Schema } from '@loaders.gl/schema';
2
2
  import type { CoreAPI, DataSourceOptions } from '@loaders.gl/loader-utils';
3
+ import type { SQLTableQuery } from "./compile-table-query.js";
3
4
  export type SQLParameterValues = unknown[] | Record<string, unknown>;
5
+ /** Raw SQL text or a portable query bound to one database table. */
6
+ export type SQLQuery = string | SQLTableQuery;
4
7
  /** Query-level options for SQL data sources. */
5
8
  export type SQLQueryOptions = {
6
9
  parameters?: SQLParameterValues;
@@ -1 +1 @@
1
- {"version":3,"file":"sql-types.d.ts","sourceRoot":"","sources":["../src/sql-types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"sql-types.d.ts","sourceRoot":"","sources":["../src/sql-types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import type { TableQueryCapabilities } from '@loaders.gl/loader-utils';
2
+ /** Portable query capabilities of the in-memory Arrow executor. */
3
+ export declare const ARROW_TABLE_QUERY_CAPABILITIES: TableQueryCapabilities;
4
+ /** Portable query capabilities shared by the current SQL data-source adapters. */
5
+ export declare const SQL_DATA_SOURCE_TABLE_QUERY_CAPABILITIES: TableQueryCapabilities;
6
+ //# sourceMappingURL=table-query-capabilities.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"table-query-capabilities.d.ts","sourceRoot":"","sources":["../src/table-query-capabilities.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,0BAA0B,CAAC;AAErE,mEAAmE;AACnE,eAAO,MAAM,8BAA8B,EAAE,sBAS3C,CAAC;AAEH,kFAAkF;AAClF,eAAO,MAAM,wCAAwC,EAAE,sBASrD,CAAC"}
@@ -0,0 +1,26 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+ /** Portable query capabilities of the in-memory Arrow executor. */
5
+ export const ARROW_TABLE_QUERY_CAPABILITIES = Object.freeze({
6
+ projection: 'residual',
7
+ predicate: 'residual',
8
+ limit: 'residual',
9
+ streaming: false,
10
+ cancellation: true,
11
+ expressions: 'residual',
12
+ orderBy: 'residual',
13
+ aggregates: 'residual'
14
+ });
15
+ /** Portable query capabilities shared by the current SQL data-source adapters. */
16
+ export const SQL_DATA_SOURCE_TABLE_QUERY_CAPABILITIES = Object.freeze({
17
+ projection: 'pushdown',
18
+ predicate: 'pushdown',
19
+ limit: 'pushdown',
20
+ streaming: false,
21
+ cancellation: false,
22
+ expressions: 'pushdown',
23
+ orderBy: 'pushdown',
24
+ aggregates: 'pushdown'
25
+ });
26
+ //# sourceMappingURL=table-query-capabilities.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"table-query-capabilities.js","sourceRoot":"","sources":["../src/table-query-capabilities.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC,mEAAmE;AACnE,MAAM,CAAC,MAAM,8BAA8B,GAA2B,MAAM,CAAC,MAAM,CAAC;IAClF,UAAU,EAAE,UAAU;IACtB,SAAS,EAAE,UAAU;IACrB,KAAK,EAAE,UAAU;IACjB,SAAS,EAAE,KAAK;IAChB,YAAY,EAAE,IAAI;IAClB,WAAW,EAAE,UAAU;IACvB,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,UAAU;CACvB,CAAC,CAAC;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,wCAAwC,GAA2B,MAAM,CAAC,MAAM,CAAC;IAC5F,UAAU,EAAE,UAAU;IACtB,SAAS,EAAE,UAAU;IACrB,KAAK,EAAE,UAAU;IACjB,SAAS,EAAE,KAAK;IAChB,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,UAAU;IACvB,OAAO,EAAE,UAAU;IACnB,UAAU,EAAE,UAAU;CACvB,CAAC,CAAC"}
@@ -0,0 +1,286 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // dist/table-query.js
21
+ var table_query_exports = {};
22
+ __export(table_query_exports, {
23
+ explainTableQuery: () => explainTableQuery2,
24
+ getSQLPredicateColumnNames: () => getSQLPredicateColumnNames,
25
+ planTableQuery: () => planTableQuery2
26
+ });
27
+ module.exports = __toCommonJS(table_query_exports);
28
+
29
+ // ../loader-utils/src/lib/scan-utils/columnar-predicate.ts
30
+ function getColumnarPredicateColumns(predicate) {
31
+ return [...new Set(getColumnarPredicatePaths(predicate).map((path) => path[0]))];
32
+ }
33
+ function getColumnarPredicatePath(property) {
34
+ return typeof property.property === "string" ? [property.property] : [...property.property];
35
+ }
36
+ function getColumnarPredicatePaths(predicate) {
37
+ const paths = /* @__PURE__ */ new Map();
38
+ visitColumnarPredicate(predicate, (child) => {
39
+ if ("property" in child.args[0]) {
40
+ const path = getColumnarPredicatePath(child.args[0]);
41
+ paths.set(path.join("\0"), path);
42
+ }
43
+ });
44
+ return [...paths.values()];
45
+ }
46
+ function validateColumnarPredicate(predicate, availableColumns) {
47
+ visitColumnarPredicate(predicate, (child) => {
48
+ if (child.op === "and" || child.op === "or") {
49
+ if (child.args.length < 2)
50
+ throw new Error(`Columnar predicate ${child.op} requires at least two child predicates`);
51
+ return;
52
+ }
53
+ if (child.op === "not") return;
54
+ const leaf = child;
55
+ const path = getColumnarPredicatePath(leaf.args[0]);
56
+ if (!path.length || path.some((component) => !component)) {
57
+ throw new Error("Columnar predicate property path must contain non-empty strings");
58
+ }
59
+ if (!availableColumns.has(path[0]))
60
+ throw new Error(`Columnar predicate column not found: ${path.join(".")}`);
61
+ if (leaf.op === "in" && leaf.args[1].length === 0) {
62
+ throw new Error("Columnar predicate in requires at least one value");
63
+ }
64
+ });
65
+ }
66
+ function isColumnarPredicateParameter(value) {
67
+ const parameterValue = value;
68
+ return typeof value === "object" && value !== null && !Array.isArray(value) && Object.keys(value).length === 1 && Object.hasOwn(value, "parameter") && typeof parameterValue.parameter === "string" && parameterValue.parameter.length > 0;
69
+ }
70
+ function visitColumnarPredicate(predicate, visitor) {
71
+ visitor(predicate);
72
+ if (predicate.op === "and" || predicate.op === "or")
73
+ predicate.args.forEach((child) => visitColumnarPredicate(child, visitor));
74
+ else if (predicate.op === "not") visitColumnarPredicate(predicate.args[0], visitor);
75
+ }
76
+
77
+ // ../loader-utils/src/lib/scan-utils/table-query.ts
78
+ function planTableQuery(sourceColumnNames, options = {}) {
79
+ validateTableQueryOptions(sourceColumnNames, options);
80
+ const outputColumnNames = options.columns ? [...options.columns] : [...sourceColumnNames];
81
+ const predicateColumnNames = options.predicate ? getColumnarPredicateColumns(options.predicate) : [];
82
+ const requiredColumnNames = /* @__PURE__ */ new Set([...outputColumnNames, ...predicateColumnNames]);
83
+ const scanColumnNames = sourceColumnNames.filter(
84
+ (columnName) => requiredColumnNames.has(columnName)
85
+ );
86
+ const steps = [
87
+ Object.freeze({ kind: "scan", columns: Object.freeze(scanColumnNames) })
88
+ ];
89
+ if (options.predicate) {
90
+ steps.push(Object.freeze({ kind: "filter", predicate: options.predicate }));
91
+ }
92
+ steps.push(Object.freeze({ kind: "project", columns: Object.freeze(outputColumnNames) }));
93
+ if (options.limit !== void 0) {
94
+ steps.push(Object.freeze({ kind: "limit", limit: options.limit }));
95
+ }
96
+ return Object.freeze(steps);
97
+ }
98
+ function validateTableQueryOptions(sourceColumnNames, options) {
99
+ const availableColumnNames = new Set(sourceColumnNames);
100
+ const outputColumnNames = options.columns ?? sourceColumnNames;
101
+ const seenColumnNames = /* @__PURE__ */ new Set();
102
+ for (const columnName of outputColumnNames) {
103
+ if (!availableColumnNames.has(columnName)) {
104
+ throw new Error(`Table query column not found: ${columnName}`);
105
+ }
106
+ if (seenColumnNames.has(columnName)) {
107
+ throw new Error(`Table query column was selected more than once: ${columnName}`);
108
+ }
109
+ seenColumnNames.add(columnName);
110
+ }
111
+ validateTableQueryLimit(options.limit);
112
+ if (options.predicate) {
113
+ validateColumnarPredicate(options.predicate, availableColumnNames);
114
+ }
115
+ }
116
+ function validateTableQueryLimit(limit) {
117
+ if (limit !== void 0 && (!Number.isSafeInteger(limit) || limit < 0)) {
118
+ throw new Error("Table query limit must be a non-negative safe integer.");
119
+ }
120
+ }
121
+
122
+ // ../loader-utils/src/lib/scan-utils/table-query-explain.ts
123
+ function explainTableQuery(sourceColumnNames, options, capabilities) {
124
+ const plan = planTableQuery(sourceColumnNames, options);
125
+ const outputColumns = options.columns ? [...options.columns] : [...sourceColumnNames];
126
+ const predicateColumns = options.predicate ? getColumnarPredicateColumns(options.predicate) : [];
127
+ const requiredColumns = [...plan[0].kind === "scan" ? plan[0].columns : []];
128
+ return Object.freeze({
129
+ sourceColumns: Object.freeze([...sourceColumnNames]),
130
+ outputColumns: Object.freeze(outputColumns),
131
+ requiredColumns: Object.freeze(requiredColumns),
132
+ predicateColumns: Object.freeze(predicateColumns),
133
+ plan,
134
+ capabilities: Object.freeze({ ...capabilities }),
135
+ operators: Object.freeze({
136
+ projection: createOperatorExplanation(options.columns !== void 0, capabilities.projection),
137
+ predicate: createOperatorExplanation(options.predicate !== void 0, capabilities.predicate),
138
+ limit: createOperatorExplanation(options.limit !== void 0, capabilities.limit)
139
+ })
140
+ });
141
+ }
142
+ function createOperatorExplanation(enabled, support) {
143
+ return Object.freeze({ enabled, support });
144
+ }
145
+
146
+ // dist/sql-predicate-types.js
147
+ function isSQLPredicateParameter(value) {
148
+ return isColumnarPredicateParameter(value);
149
+ }
150
+
151
+ // dist/sql-predicate-schema.js
152
+ var MAXIMUM_PREDICATE_DEPTH = 64;
153
+ var MAXIMUM_PREDICATE_NODES = 4096;
154
+ function validateSQLPredicate(value) {
155
+ const state = { nodes: 0 };
156
+ validatePredicateNode(value, "$", 0, state);
157
+ }
158
+ function validatePredicateNode(value, path, depth, state) {
159
+ if (depth > MAXIMUM_PREDICATE_DEPTH) {
160
+ throw new Error(`SQL predicate ${path} exceeds the maximum nesting depth`);
161
+ }
162
+ state.nodes++;
163
+ if (state.nodes > MAXIMUM_PREDICATE_NODES) {
164
+ throw new Error("SQL predicate exceeds the maximum node count");
165
+ }
166
+ if (!isRecord(value) || !hasExactKeys(value, ["op", "args"])) {
167
+ throw new Error(`SQL predicate ${path} must contain only op and args`);
168
+ }
169
+ if (typeof value.op !== "string" || !Array.isArray(value.args)) {
170
+ throw new Error(`SQL predicate ${path} requires string op and array args`);
171
+ }
172
+ switch (value.op) {
173
+ case "and":
174
+ case "or":
175
+ if (value.args.length < 2) {
176
+ throw new Error(`SQL predicate ${path}.${value.op} requires at least two arguments`);
177
+ }
178
+ for (let index = 0; index < value.args.length; index++) {
179
+ validatePredicateNode(value.args[index], `${path}.args[${index}]`, depth + 1, state);
180
+ }
181
+ return;
182
+ case "not":
183
+ if (value.args.length !== 1) {
184
+ throw new Error(`SQL predicate ${path}.not requires exactly one argument`);
185
+ }
186
+ validatePredicateNode(value.args[0], `${path}.args[0]`, depth + 1, state);
187
+ return;
188
+ case "isNull":
189
+ if (value.args.length !== 1) {
190
+ throw new Error(`SQL predicate ${path}.isNull requires exactly one argument`);
191
+ }
192
+ validatePredicateProperty(value.args[0], `${path}.args[0]`);
193
+ return;
194
+ case "in":
195
+ if (value.args.length !== 2 || !Array.isArray(value.args[1]) || value.args[1].length === 0) {
196
+ throw new Error(`SQL predicate ${path}.in requires a property and non-empty value list`);
197
+ }
198
+ validatePredicateProperty(value.args[0], `${path}.args[0]`);
199
+ value.args[1].forEach((item, index) => validatePredicateValue(item, `${path}.args[1][${index}]`));
200
+ return;
201
+ case "=":
202
+ case "<>":
203
+ case "<":
204
+ case "<=":
205
+ case ">":
206
+ case ">=":
207
+ if (value.args.length !== 2) {
208
+ throw new Error(`SQL predicate ${path}.${value.op} requires exactly two arguments`);
209
+ }
210
+ validatePredicateProperty(value.args[0], `${path}.args[0]`);
211
+ validatePredicateValue(value.args[1], `${path}.args[1]`);
212
+ return;
213
+ default:
214
+ throw new Error(`SQL predicate ${path} has unsupported operator ${JSON.stringify(value.op)}`);
215
+ }
216
+ }
217
+ function validatePredicateProperty(value, path) {
218
+ if (!isRecord(value) || !hasAllowedKeys(value, ["property", "quoted"]) || typeof value.property !== "string" || value.property.length === 0 || value.quoted !== void 0 && typeof value.quoted !== "boolean") {
219
+ throw new Error(`SQL predicate ${path} requires a non-empty property reference`);
220
+ }
221
+ }
222
+ function validatePredicateValue(value, path) {
223
+ if (isSQLPredicateParameter(value)) {
224
+ return;
225
+ }
226
+ if (typeof value === "boolean" || typeof value === "bigint" || typeof value === "string" || 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
+ function isRecord(value) {
238
+ return typeof value === "object" && value !== null && !Array.isArray(value);
239
+ }
240
+ function hasExactKeys(value, expectedKeys) {
241
+ const keys = Object.keys(value);
242
+ return keys.length === expectedKeys.length && expectedKeys.every((key) => keys.includes(key));
243
+ }
244
+ function hasAllowedKeys(value, allowedKeys) {
245
+ return Object.keys(value).every((key) => allowedKeys.includes(key));
246
+ }
247
+
248
+ // dist/table-query-capabilities.js
249
+ var ARROW_TABLE_QUERY_CAPABILITIES = Object.freeze({
250
+ projection: "residual",
251
+ predicate: "residual",
252
+ limit: "residual",
253
+ streaming: false,
254
+ cancellation: true,
255
+ expressions: "residual",
256
+ orderBy: "residual",
257
+ aggregates: "residual"
258
+ });
259
+ var SQL_DATA_SOURCE_TABLE_QUERY_CAPABILITIES = Object.freeze({
260
+ projection: "pushdown",
261
+ predicate: "pushdown",
262
+ limit: "pushdown",
263
+ streaming: false,
264
+ cancellation: false,
265
+ expressions: "pushdown",
266
+ orderBy: "pushdown",
267
+ aggregates: "pushdown"
268
+ });
269
+
270
+ // dist/table-query.js
271
+ function planTableQuery2(sourceColumnNames, options = {}) {
272
+ if (options.predicate) {
273
+ validateSQLPredicate(options.predicate);
274
+ }
275
+ return planTableQuery(sourceColumnNames, options);
276
+ }
277
+ function explainTableQuery2(sourceColumnNames, options = {}) {
278
+ if (options.predicate) {
279
+ validateSQLPredicate(options.predicate);
280
+ }
281
+ return explainTableQuery(sourceColumnNames, options, SQL_DATA_SOURCE_TABLE_QUERY_CAPABILITIES);
282
+ }
283
+ function getSQLPredicateColumnNames(predicate) {
284
+ return getColumnarPredicateColumns(predicate);
285
+ }
286
+ //# sourceMappingURL=table-query.cjs.map
@@ -0,0 +1,6 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../src/table-query.ts", "../../loader-utils/src/lib/scan-utils/columnar-predicate.ts", "../../loader-utils/src/lib/scan-utils/table-query.ts", "../../loader-utils/src/lib/scan-utils/table-query-explain.ts", "../src/sql-predicate-types.ts", "../src/sql-predicate-schema.ts", "../src/table-query-capabilities.ts"],
4
+ "mappings": "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",
5
+ "names": ["explainTableQuery", "planTableQuery", "planTableQuery", "explainTableQuery"]
6
+ }
@@ -0,0 +1,29 @@
1
+ import { type TableQueryFilterStep as ColumnarTableQueryFilterStep, type TableQueryLimitStep as ColumnarTableQueryLimitStep, type TableQueryOptions as ColumnarTableQueryOptions, type TableQueryPlan as ColumnarTableQueryPlan, type TableQueryPlanStep as ColumnarTableQueryPlanStep, type TableQueryProjectStep as ColumnarTableQueryProjectStep, type TableQueryScanStep as ColumnarTableQueryScanStep } from '@loaders.gl/loader-utils';
2
+ import type { SQLPredicate } from "./sql-predicate-types.js";
3
+ /** Immutable, backend-neutral request for a table query. */
4
+ export type TableQueryOptions = ColumnarTableQueryOptions<SQLPredicate>;
5
+ /** Reads the minimum source columns required by the remaining table-query plan. */
6
+ export type TableQueryScanStep = ColumnarTableQueryScanStep;
7
+ /** Applies a portable SQL predicate while all predicate columns remain available. */
8
+ export type TableQueryFilterStep = ColumnarTableQueryFilterStep<SQLPredicate>;
9
+ /** Narrows the result to requested output columns. */
10
+ export type TableQueryProjectStep = ColumnarTableQueryProjectStep;
11
+ /** Retains the first rows in source order after filtering and projection. */
12
+ export type TableQueryLimitStep = ColumnarTableQueryLimitStep;
13
+ /** One immutable operation in a normalized table-query plan. */
14
+ export type TableQueryPlanStep = ColumnarTableQueryPlanStep<SQLPredicate>;
15
+ /** Immutable logical query plan shared by Arrow and GPU dataframe backends. */
16
+ export type TableQueryPlan = ColumnarTableQueryPlan<SQLPredicate>;
17
+ export type TableQueryExplain = import('@loaders.gl/loader-utils').TableQueryExplain<SQLPredicate>;
18
+ /**
19
+ * Produces the canonical scan, filter, project, and limit sequence for a table query.
20
+ *
21
+ * Predicate columns are retained by the scan even if callers omit them from the output projection.
22
+ * This makes SQL `WHERE` semantics independent of a backend's internal API call order.
23
+ */
24
+ export declare function planTableQuery(sourceColumnNames: readonly string[], options?: TableQueryOptions): TableQueryPlan;
25
+ /** Explains a portable SQL table query without executing it. */
26
+ export declare function explainTableQuery(sourceColumnNames: readonly string[], options?: TableQueryOptions): TableQueryExplain;
27
+ /** Returns every source column referenced by one portable predicate, in first-use order. */
28
+ export declare function getSQLPredicateColumnNames(predicate: SQLPredicate): string[];
29
+ //# sourceMappingURL=table-query.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"table-query.d.ts","sourceRoot":"","sources":["../src/table-query.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,oBAAoB,IAAI,4BAA4B,EACzD,KAAK,mBAAmB,IAAI,2BAA2B,EACvD,KAAK,iBAAiB,IAAI,yBAAyB,EACnD,KAAK,cAAc,IAAI,sBAAsB,EAC7C,KAAK,kBAAkB,IAAI,0BAA0B,EACrD,KAAK,qBAAqB,IAAI,6BAA6B,EAC3D,KAAK,kBAAkB,IAAI,0BAA0B,EACtD,MAAM,0BAA0B,CAAC;AAGlC,OAAO,KAAK,EAAC,YAAY,EAAC,iCAA8B;AAExD,4DAA4D;AAC5D,MAAM,MAAM,iBAAiB,GAAG,yBAAyB,CAAC,YAAY,CAAC,CAAC;AAExE,mFAAmF;AACnF,MAAM,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAE5D,qFAAqF;AACrF,MAAM,MAAM,oBAAoB,GAAG,4BAA4B,CAAC,YAAY,CAAC,CAAC;AAE9E,sDAAsD;AACtD,MAAM,MAAM,qBAAqB,GAAG,6BAA6B,CAAC;AAElE,6EAA6E;AAC7E,MAAM,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAE9D,gEAAgE;AAChE,MAAM,MAAM,kBAAkB,GAAG,0BAA0B,CAAC,YAAY,CAAC,CAAC;AAE1E,+EAA+E;AAC/E,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;AAClE,MAAM,MAAM,iBAAiB,GAAG,OAAO,0BAA0B,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC;AAGnG;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,OAAO,GAAE,iBAAsB,GAC9B,cAAc,CAKhB;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAC/B,iBAAiB,EAAE,SAAS,MAAM,EAAE,EACpC,OAAO,GAAE,iBAAsB,GAC9B,iBAAiB,CASnB;AAED,4FAA4F;AAC5F,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,YAAY,GAAG,MAAM,EAAE,CAE5E"}
@@ -0,0 +1,30 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+ import { getColumnarPredicateColumns, explainTableQuery as explainColumnarTableQuery, planTableQuery as planColumnarTableQuery } from '@loaders.gl/loader-utils';
5
+ import { validateSQLPredicate } from "./sql-predicate-schema.js";
6
+ import { SQL_DATA_SOURCE_TABLE_QUERY_CAPABILITIES } from "./table-query-capabilities.js";
7
+ /**
8
+ * Produces the canonical scan, filter, project, and limit sequence for a table query.
9
+ *
10
+ * Predicate columns are retained by the scan even if callers omit them from the output projection.
11
+ * This makes SQL `WHERE` semantics independent of a backend's internal API call order.
12
+ */
13
+ export function planTableQuery(sourceColumnNames, options = {}) {
14
+ if (options.predicate) {
15
+ validateSQLPredicate(options.predicate);
16
+ }
17
+ return planColumnarTableQuery(sourceColumnNames, options);
18
+ }
19
+ /** Explains a portable SQL table query without executing it. */
20
+ export function explainTableQuery(sourceColumnNames, options = {}) {
21
+ if (options.predicate) {
22
+ validateSQLPredicate(options.predicate);
23
+ }
24
+ return explainColumnarTableQuery(sourceColumnNames, options, SQL_DATA_SOURCE_TABLE_QUERY_CAPABILITIES);
25
+ }
26
+ /** Returns every source column referenced by one portable predicate, in first-use order. */
27
+ export function getSQLPredicateColumnNames(predicate) {
28
+ return getColumnarPredicateColumns(predicate);
29
+ }
30
+ //# sourceMappingURL=table-query.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"table-query.js","sourceRoot":"","sources":["../src/table-query.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,EACL,2BAA2B,EAC3B,iBAAiB,IAAI,yBAAyB,EAC9C,cAAc,IAAI,sBAAsB,EAQzC,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAC,oBAAoB,EAAC,kCAA+B;AAwB5D,OAAO,EAAC,wCAAwC,EAAC,sCAAmC;AAEpF;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,iBAAoC,EACpC,UAA6B,EAAE;IAE/B,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,oBAAoB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,sBAAsB,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,iBAAiB,CAC/B,iBAAoC,EACpC,UAA6B,EAAE;IAE/B,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,oBAAoB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,yBAAyB,CAC9B,iBAAiB,EACjB,OAAO,EACP,wCAAwC,CACzC,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,0BAA0B,CAAC,SAAuB;IAChE,OAAO,2BAA2B,CAAC,SAAS,CAAC,CAAC;AAChD,CAAC"}