@finos/legend-cube-builder 0.0.3 → 0.0.5

package/lib/__test-utils__/CubeCanvasTestUtils.js

@@ -33,5 +33,5 @@ export const TEST__findCanvasNode = async (nodeId, container = document) => {
 /** Every node drawn on the canvas */
 export const TEST__getCanvasNodes = () => screen.queryAllByTestId(LEGEND_CUBE_TEST_ID.CANVAS_NODE);
 /** The node's tooltip, one line an item: errors, warnings, description, id */
-export const TEST__getCanvasNodeTooltip = (node) => (node.getAttribute('title') ?? '').split('\n');
+export const TEST__getCanvasNodeTooltip = (node) => (node.getAttribute('aria-description') ?? '').split('\n');
 //# sourceMappingURL=CubeCanvasTestUtils.js.map

package/lib/__test-utils__/CubeCanvasTestUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"CubeCanvasTestUtils.js","sourceRoot":"","sources":["../../src/__test-utils__/CubeCanvasTestUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE,8EAA8E;AAC9E,gCAAgC;AAEhC,qEAAqE;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,MAAc,EACd,YAAwB,QAAQ,EACZ,EAAE,CACtB,SAAS,CAAC,aAAa,CACrB,8BAA8B,MAAM,oBAAoB,mBAAmB,CAAC,WAAW,IAAI,CAC5F,CAAC;AAEJ,oEAAoE;AACpE,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EACvC,MAAc,EACd,YAAwB,QAAQ,EACV,EAAE;IACxB,IAAI,IAAI,GAAuB,IAAI,CAAC;IACpC,MAAM,OAAO,CAAC,GAAG,EAAE;QACjB,IAAI,GAAG,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,wBAAwB,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,IAA8B,CAAC;AACxC,CAAC,CAAC;AAEF,qCAAqC;AACrC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAkB,EAAE,CACtD,MAAM,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;AAE3D,8EAA8E;AAC9E,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,IAAiB,EAAY,EAAE,CACxE,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"CubeCanvasTestUtils.js","sourceRoot":"","sources":["../../src/__test-utils__/CubeCanvasTestUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE,8EAA8E;AAC9E,gCAAgC;AAEhC,qEAAqE;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,MAAc,EACd,YAAwB,QAAQ,EACZ,EAAE,CACtB,SAAS,CAAC,aAAa,CACrB,8BAA8B,MAAM,oBAAoB,mBAAmB,CAAC,WAAW,IAAI,CAC5F,CAAC;AAEJ,oEAAoE;AACpE,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EACvC,MAAc,EACd,YAAwB,QAAQ,EACV,EAAE;IACxB,IAAI,IAAI,GAAuB,IAAI,CAAC;IACpC,MAAM,OAAO,CAAC,GAAG,EAAE;QACjB,IAAI,GAAG,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,wBAAwB,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,IAA8B,CAAC;AACxC,CAAC,CAAC;AAEF,qCAAqC;AACrC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAkB,EAAE,CACtD,MAAM,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;AAE3D,8EAA8E;AAC9E,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,IAAiB,EAAY,EAAE,CACxE,CAAC,IAAI,CAAC,YAAY,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC"}

package/lib/__test-utils__/CubeConnectionTestSupport.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type PlainObject } from '@finos/legend-shared';
+/**
+ * Reads a database through a connection: the engine introspects it and
+ * returns a model holding one Database, `{_type: 'data', elements}`
+ */
+export declare const CUBE_ENGINE_TEST__schemaExploration: (input: object) => Promise<PlainObject>;
+//# sourceMappingURL=CubeConnectionTestSupport.d.ts.map

package/lib/__test-utils__/CubeConnectionTestSupport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeConnectionTestSupport.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/CubeConnectionTestSupport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAQ9B;;;GAGG;AACH,eAAO,MAAM,mCAAmC,GAC9C,OAAO,MAAM,KACZ,OAAO,CAAC,WAAW,CASd,CAAC"}

package/lib/__test-utils__/CubeConnectionTestSupport.js

@@ -0,0 +1,30 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import axios, {} from 'axios';
+import { ContentType, HttpHeader, } from '@finos/legend-shared';
+import { ENGINE_TEST_SUPPORT_API_URL } from '@finos/legend-graph/test';
+// Engine calls for the engine tests of direct connections (PLAN §6.8), as
+// plain JSON: the connection must reach the engine exactly as it is saved,
+// which legend-graph's connection serializers don't do (they drop a DuckDB
+// connection's setup SQL)
+/**
+ * Reads a database through a connection: the engine introspects it and
+ * returns a model holding one Database, `{_type: 'data', elements}`
+ */
+export const CUBE_ENGINE_TEST__schemaExploration = async (input) => (await axios.post(`${ENGINE_TEST_SUPPORT_API_URL}/pure/v1/utilities/database/schemaExploration`, input, {
+    headers: { [HttpHeader.CONTENT_TYPE]: ContentType.APPLICATION_JSON },
+})).data;
+//# sourceMappingURL=CubeConnectionTestSupport.js.map

package/lib/__test-utils__/CubeConnectionTestSupport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeConnectionTestSupport.js","sourceRoot":"","sources":["../../src/__test-utils__/CubeConnectionTestSupport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,EAAsB,MAAM,OAAO,CAAC;AAClD,OAAO,EACL,WAAW,EACX,UAAU,GAEX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,0EAA0E;AAC1E,2EAA2E;AAC3E,2EAA2E;AAC3E,0BAA0B;AAE1B;;;GAGG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,KAAK,EACtD,KAAa,EACS,EAAE,CACxB,CACE,MAAM,KAAK,CAAC,IAAI,CACd,GAAG,2BAA2B,+CAA+C,EAC7E,KAAK,EACL;IACE,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC,gBAAgB,EAAE;CACrE,CACF,CACF,CAAC,IAAI,CAAC"}

package/lib/__test-utils__/CubeDirectConnectionFixtures.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { PlainObject } from '@finos/legend-shared';
+export declare const DIRECT_H2_SCHEMA = "CUBE_DIRECT";
+export declare const DIRECT_DUCKDB_SCHEMA = "cube_direct";
+/**
+ * An H2 database the engine creates in its own H2 server, in the schema given:
+ * each test file uses its own, as files run at once against one engine
+ */
+export declare const directH2Connection: (schema: string) => PlainObject;
+/**
+ * An in-memory DuckDB database (an empty path), so no file is read or
+ * written, in the schema given
+ */
+export declare const directDuckDBConnection: (schema: string) => PlainObject;
+export declare const DIRECT_H2_CONNECTION: PlainObject<T>;
+export declare const DIRECT_DUCKDB_CONNECTION: PlainObject<T>;
+//# sourceMappingURL=CubeDirectConnectionFixtures.d.ts.map

package/lib/__test-utils__/CubeDirectConnectionFixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeDirectConnectionFixtures.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/CubeDirectConnectionFixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAOxD,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAC9C,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,MAAM,KAAG,WAclD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,QAAQ,MAAM,KAAG,WAetD,CAAC;AAEH,eAAO,MAAM,oBAAoB,gBAAuC,CAAC;AACzE,eAAO,MAAM,wBAAwB,gBACS,CAAC"}

package/lib/__test-utils__/CubeDirectConnectionFixtures.js

@@ -0,0 +1,63 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Connections to small, self-contained test databases, as the protocol JSON a
+// direct-connection cube saves (PLAN §6.8). Each setup first drops what it
+// creates, because the engine keeps an H2 server and a DuckDB connection
+// between calls, and uses its own schema, so tests can share an engine
+export const DIRECT_H2_SCHEMA = 'CUBE_DIRECT';
+export const DIRECT_DUCKDB_SCHEMA = 'cube_direct';
+/**
+ * An H2 database the engine creates in its own H2 server, in the schema given:
+ * each test file uses its own, as files run at once against one engine
+ */
+export const directH2Connection = (schema) => ({
+    _type: 'RelationalDatabaseConnection',
+    type: 'H2',
+    databaseType: 'H2',
+    datasourceSpecification: {
+        _type: 'h2Local',
+        testDataSetupSqls: [
+            `drop schema if exists ${schema} cascade`,
+            `create schema ${schema}`,
+            `create table ${schema}.ORDERS (ORDER_ID INT PRIMARY KEY, CUSTOMER_ID VARCHAR(5) NOT NULL, AMOUNT DECIMAL(10,2))`,
+            `insert into ${schema}.ORDERS values (1, 'ALFKI', 12.34), (2, 'ANATR', 5.00)`,
+        ],
+    },
+    authenticationStrategy: { _type: 'h2Default' },
+});
+/**
+ * An in-memory DuckDB database (an empty path), so no file is read or
+ * written, in the schema given
+ */
+export const directDuckDBConnection = (schema) => ({
+    _type: 'RelationalDatabaseConnection',
+    type: 'DuckDB',
+    databaseType: 'DuckDB',
+    datasourceSpecification: {
+        _type: 'duckDB',
+        path: '',
+        testDataSetupSqls: [
+            `drop schema if exists ${schema} cascade`,
+            `create schema ${schema}`,
+            `create table ${schema}.orders (order_id INTEGER PRIMARY KEY, customer_id VARCHAR(5) NOT NULL, amount DECIMAL(10,2))`,
+            `insert into ${schema}.orders values (1, 'ALFKI', 12.34), (2, 'ANATR', 5.00)`,
+        ],
+    },
+    authenticationStrategy: { _type: 'test' },
+});
+export const DIRECT_H2_CONNECTION = directH2Connection(DIRECT_H2_SCHEMA);
+export const DIRECT_DUCKDB_CONNECTION = directDuckDBConnection(DIRECT_DUCKDB_SCHEMA);
+//# sourceMappingURL=CubeDirectConnectionFixtures.js.map

package/lib/__test-utils__/CubeDirectConnectionFixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeDirectConnectionFixtures.js","sourceRoot":"","sources":["../../src/__test-utils__/CubeDirectConnectionFixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,8EAA8E;AAC9E,2EAA2E;AAC3E,yEAAyE;AACzE,uEAAuE;AAEvE,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAC;AAElD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAc,EAAe,EAAE,CAAC,CAAC;IAClE,KAAK,EAAE,8BAA8B;IACrC,IAAI,EAAE,IAAI;IACV,YAAY,EAAE,IAAI;IAClB,uBAAuB,EAAE;QACvB,KAAK,EAAE,SAAS;QAChB,iBAAiB,EAAE;YACjB,yBAAyB,MAAM,UAAU;YACzC,iBAAiB,MAAM,EAAE;YACzB,gBAAgB,MAAM,2FAA2F;YACjH,eAAe,MAAM,wDAAwD;SAC9E;KACF;IACD,sBAAsB,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;CAC/C,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAAc,EAAe,EAAE,CAAC,CAAC;IACtE,KAAK,EAAE,8BAA8B;IACrC,IAAI,EAAE,QAAQ;IACd,YAAY,EAAE,QAAQ;IACtB,uBAAuB,EAAE;QACvB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,EAAE;QACR,iBAAiB,EAAE;YACjB,yBAAyB,MAAM,UAAU;YACzC,iBAAiB,MAAM,EAAE;YACzB,gBAAgB,MAAM,+FAA+F;YACrH,eAAe,MAAM,wDAAwD;SAC9E;KACF;IACD,sBAAsB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;CAC1C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,wBAAwB,GACnC,sBAAsB,CAAC,oBAAoB,CAAC,CAAC"}

package/lib/__test-utils__/CubeEngineTestSupport.d.ts

@@ -33,7 +33,7 @@ export declare const CUBE_ENGINE_TEST__jsonToGrammar_lambda: (lambda: PlainObjec
  * does in the browser. A body given as text (with lossless numbers) is sent
  * as it is.
  */
-export declare const CUBE_ENGINE_TEST__execute: (input: object | string) => Promise<{
+export declare const CUBE_ENGINE_TEST__execute: (input: object | string, serializationFormat?: string) => Promise<{
     ok: boolean;
     status: number;
     text: () => Promise<string>;
@@ -44,4 +44,16 @@ export declare const CUBE_ENGINE_TEST__execute: (input: object | string) => Prom
  * numbers) is sent as it is
  */
 export declare const CUBE_ENGINE_TEST__generatePlanSql: (input: object | string) => Promise<string[]>;
+/**
+ * The protocol JSON of a value specification's text, parsed with its source
+ * information under the source id, given as the client's unread response
+ * (an Extend column's expression, PLAN §11.7), so it is read losslessly
+ */
+export declare const CUBE_ENGINE_TEST__grammarToJson_valueSpecification: (code: string, sourceId: string) => Promise<{
+    ok: boolean;
+    status: number;
+    text: () => Promise<string>;
+}>;
+/** Generates the execution plan of a query, never running it; a body given as text is sent as it is */
+export declare const CUBE_ENGINE_TEST__generatePlan: (input: object | string) => Promise<PlainObject>;
 //# sourceMappingURL=CubeEngineTestSupport.d.ts.map

package/lib/__test-utils__/CubeEngineTestSupport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CubeEngineTestSupport.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/CubeEngineTestSupport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAa9B,qDAAqD;AACrD,eAAO,MAAM,2BAA2B,QAAa,OAAO,CAAC,MAAM,CAMlE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sCAAsC,GACjD,MAAM,MAAM,KACX,OAAO,CAAC,OAAO,CAcf,CAAC;AAEJ,uFAAuF;AACvF,eAAO,MAAM,yCAAyC,GACpD,OAAO,MAAM,KACZ,OAAO,CAAC,WAAW,CAOd,CAAC;AAET,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,KACZ,OAAO,CAAC,WAAW,CAOd,CAAC;AAET,0DAA0D;AAC1D,eAAO,MAAM,sCAAsC,GACjD,QAAQ,WAAW,EACnB,cAAc,MAAM,GAAG,SAAS,KAC/B,OAAO,CAAC,MAAM,CAeT,CAAC;AAET;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,GAAG,MAAM,KACrB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,CAiBtE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,GAC5C,OAAO,MAAM,GAAG,MAAM,KACrB,OAAO,CAAC,MAAM,EAAE,CA0BlB,CAAC"}
+{"version":3,"file":"CubeEngineTestSupport.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/CubeEngineTestSupport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAa9B,qDAAqD;AACrD,eAAO,MAAM,2BAA2B,QAAa,OAAO,CAAC,MAAM,CAMlE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sCAAsC,GACjD,MAAM,MAAM,KACX,OAAO,CAAC,OAAO,CAcf,CAAC;AAEJ,uFAAuF;AACvF,eAAO,MAAM,yCAAyC,GACpD,OAAO,MAAM,KACZ,OAAO,CAAC,WAAW,CAOd,CAAC;AAET,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,KACZ,OAAO,CAAC,WAAW,CAOd,CAAC;AAET,0DAA0D;AAC1D,eAAO,MAAM,sCAAsC,GACjD,QAAQ,WAAW,EACnB,cAAc,MAAM,GAAG,SAAS,KAC/B,OAAO,CAAC,MAAM,CAeT,CAAC;AAET;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,MAAM,GAAG,MAAM,EACtB,4BAA+B,KAC9B,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,CAiBtE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,GAC5C,OAAO,MAAM,GAAG,MAAM,KACrB,OAAO,CAAC,MAAM,EAAE,CA0BlB,CAAC;AACF;;;;GAIG;AACH,eAAO,MAAM,kDAAkD,GAC7D,MAAM,MAAM,EACZ,UAAU,MAAM,KACf,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,CAiBtE,CAAC;AAEF,uGAAuG;AACvG,eAAO,MAAM,8BAA8B,GACzC,OAAO,MAAM,GAAG,MAAM,KACrB,OAAO,CAAC,WAAW,CAOd,CAAC"}

package/lib/__test-utils__/CubeEngineTestSupport.js

@@ -59,10 +59,10 @@ export const CUBE_ENGINE_TEST__jsonToGrammar_lambda = async (lambda, renderStyle
  * does in the browser. A body given as text (with lossless numbers) is sent
  * as it is.
  */
-export const CUBE_ENGINE_TEST__execute = async (input) => {
+export const CUBE_ENGINE_TEST__execute = async (input, serializationFormat = 'DEFAULT') => {
     const response = await axios.post(`${PURE_API}/execution/execute`, input, {
         headers: JSON_HEADERS,
-        params: { serializationFormat: 'DEFAULT' },
+        params: { serializationFormat },
         responseType: 'text',
         transformResponse: (data) => data,
         validateStatus: () => true,
@@ -103,4 +103,25 @@ export const CUBE_ENGINE_TEST__generatePlanSql = async (input) => {
     visit(parseLosslessJSON(data));
     return sql;
 };
+/**
+ * The protocol JSON of a value specification's text, parsed with its source
+ * information under the source id, given as the client's unread response
+ * (an Extend column's expression, PLAN §11.7), so it is read losslessly
+ */
+export const CUBE_ENGINE_TEST__grammarToJson_valueSpecification = async (code, sourceId) => {
+    const response = await axios.post(`${PURE_API}/grammar/grammarToJson/valueSpecification`, code, {
+        headers: { [HttpHeader.CONTENT_TYPE]: ContentType.TEXT_PLAIN },
+        params: { sourceId, returnSourceInformation: true },
+        responseType: 'text',
+        transformResponse: (data) => data,
+        validateStatus: () => true,
+    });
+    return {
+        ok: response.status >= 200 && response.status < 300,
+        status: response.status,
+        text: async () => response.data,
+    };
+};
+/** Generates the execution plan of a query, never running it; a body given as text is sent as it is */
+export const CUBE_ENGINE_TEST__generatePlan = async (input) => (await axios.post(`${PURE_API}/execution/generatePlan`, input, { headers: JSON_HEADERS })).data;
 //# sourceMappingURL=CubeEngineTestSupport.js.map

package/lib/__test-utils__/CubeEngineTestSupport.js.map

@@ -1 +1 @@
-{"version":3,"file":"CubeEngineTestSupport.js","sourceRoot":"","sources":["../../src/__test-utils__/CubeEngineTestSupport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CubeEngineTestSupport.js","sourceRoot":"","sources":["../../src/__test-utils__/CubeEngineTestSupport.ts"],"names":[],"mappings":"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"}

package/lib/__test-utils__/CubeExpressionTestUtils.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { ExpressionFilter, Extend, type JsonObject, type Query } from '@finos/legend-cube';
+/** `x | <body>` and the pieces of a body */
+export declare const TEST__expression: {
+    lambda: (body: JsonObject) => JsonObject;
+    /** `$x.<name>` */
+    column: (name: string) => JsonObject;
+    call: (name: string, ...parameters: JsonObject[]) => JsonObject;
+    /** The two operands of `+`, `*`, … */
+    pair: (first: JsonObject, second: JsonObject) => JsonObject;
+    integer: (value: number) => JsonObject;
+    string: (value: string) => JsonObject;
+};
+/** A new column: its name, its lambda, and the type the engine gives it */
+export type TEST__ExtendColumn = readonly [string, JsonObject, string];
+/**
+ * An Extend of these columns, typed as given for the input Cube infers for
+ * `input`'s selected node, so it is valid without the engine; the engine
+ * tests check the types are the engine's. With an invalid input, untyped.
+ */
+export declare const TEST__typedExtend: (id: string, input: Query, columns: readonly TEST__ExtendColumn[]) => Extend;
+/**
+ * A Filter by Expression of this condition, checked for the input Cube infers
+ * for `input`'s selected node, so it is valid without the engine; the engine
+ * tests check the engine takes it. With an invalid input, not checked.
+ */
+export declare const TEST__checkedExpressionFilter: (id: string, input: Query, code: string, lambda: JsonObject) => ExpressionFilter;
+/** `a: x | $x.ORDER_ID + 1` and `b: x | $x.a * 2`, the second using the first, both Integer */
+export declare const TEST__ORDER_ID_EXTEND_COLUMNS: readonly TEST__ExtendColumn[];
+//# sourceMappingURL=CubeExpressionTestUtils.d.ts.map

package/lib/__test-utils__/CubeExpressionTestUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeExpressionTestUtils.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/CubeExpressionTestUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAEL,gBAAgB,EAChB,MAAM,EAGN,KAAK,UAAU,EAEf,KAAK,KAAK,EACX,MAAM,oBAAoB,CAAC;AAM5B,4CAA4C;AAC5C,eAAO,MAAM,gBAAgB;mBACZ,UAAU,KAAG,UAAU;IAKtC,kBAAkB;mBACH,MAAM,KAAG,UAAU;iBAKrB,MAAM,iBAAiB,UAAU,EAAE,KAAG,UAAU;IAK7D,sCAAsC;kBACxB,UAAU,UAAU,UAAU,KAAG,UAAU;qBAKxC,MAAM,KAAG,UAAU;oBAIpB,MAAM,KAAG,UAAU;CACpC,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,kBAAkB,GAAG,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,IAAI,MAAM,EACV,OAAO,KAAK,EACZ,SAAS,SAAS,kBAAkB,EAAE,KACrC,MAkBF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,GACxC,IAAI,MAAM,EACV,OAAO,KAAK,EACZ,MAAM,MAAM,EACZ,QAAQ,UAAU,KACjB,gBAWF,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,6BAA6B,EAAE,SAAS,kBAAkB,EA2BtE,CAAC"}

package/lib/__test-utils__/CubeExpressionTestUtils.js

@@ -0,0 +1,100 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { buildSchemasAndValidity, ExpressionFilter, Extend, getExpressionFilterSignature, getExtendSignature, PrimitiveType, } from '@finos/legend-cube';
+// Extend columns and filter conditions for tests (PLAN §11.7, §11.11),
+// written as the engine's JSON, as a node stores it: number literals as their
+// digits
+/** `x | <body>` and the pieces of a body */
+export const TEST__expression = {
+    lambda: (body) => ({
+        _type: 'lambda',
+        parameters: [{ _type: 'var', name: 'x' }],
+        body: [body],
+    }),
+    /** `$x.<name>` */
+    column: (name) => ({
+        _type: 'property',
+        property: name,
+        parameters: [{ _type: 'var', name: 'x' }],
+    }),
+    call: (name, ...parameters) => ({
+        _type: 'func',
+        function: name,
+        parameters,
+    }),
+    /** The two operands of `+`, `*`, … */
+    pair: (first, second) => ({
+        _type: 'collection',
+        multiplicity: { lowerBound: 2, upperBound: 2 },
+        values: [first, second],
+    }),
+    integer: (value) => ({
+        _type: 'integer',
+        value: String(value),
+    }),
+    string: (value) => ({ _type: 'string', value }),
+};
+/**
+ * An Extend of these columns, typed as given for the input Cube infers for
+ * `input`'s selected node, so it is valid without the engine; the engine
+ * tests check the types are the engine's. With an invalid input, untyped.
+ */
+export const TEST__typedExtend = (id, input, columns) => {
+    const schema = buildSchemasAndValidity(input).schemas.get(input.selected ?? '');
+    const extendColumns = columns.map(([name, lambda]) => ({
+        name,
+        code: name,
+        lambda,
+    }));
+    // an invalid input, e.g. a table not resolved yet: nothing to type it for
+    if (!schema) {
+        return new Extend(id, extendColumns);
+    }
+    return new Extend(id, extendColumns, {
+        kind: 'typed',
+        signature: getExtendSignature(schema, extendColumns),
+        types: columns.map(([, , type]) => PrimitiveType.get(type)),
+    });
+};
+/**
+ * A Filter by Expression of this condition, checked for the input Cube infers
+ * for `input`'s selected node, so it is valid without the engine; the engine
+ * tests check the engine takes it. With an invalid input, not checked.
+ */
+export const TEST__checkedExpressionFilter = (id, input, code, lambda) => {
+    const filter = new ExpressionFilter(id, code, lambda);
+    const schema = buildSchemasAndValidity(input).schemas.get(input.selected ?? '');
+    return schema
+        ? filter.withCheck({
+            kind: 'checked',
+            signature: getExpressionFilterSignature(schema, lambda),
+        })
+        : filter;
+};
+/** `a: x | $x.ORDER_ID + 1` and `b: x | $x.a * 2`, the second using the first, both Integer */
+export const TEST__ORDER_ID_EXTEND_COLUMNS = [
+    [
+        'a',
+        TEST__expression.lambda(TEST__expression.call('plus', TEST__expression.pair(TEST__expression.column('ORDER_ID'), TEST__expression.integer(1)))),
+        'Integer',
+    ],
+    [
+        'b',
+        TEST__expression.lambda(TEST__expression.call('times', TEST__expression.pair(TEST__expression.column('a'), TEST__expression.integer(2)))),
+        'Integer',
+    ],
+];
+//# sourceMappingURL=CubeExpressionTestUtils.js.map

package/lib/__test-utils__/CubeExpressionTestUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeExpressionTestUtils.js","sourceRoot":"","sources":["../../src/__test-utils__/CubeExpressionTestUtils.ts"],"names":[],"mappings":"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"}

package/lib/__test-utils__/CubeFunctionTestOutline.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Schema } from '@finos/legend-cube';
+import type { CubeModelOutline, CubeOutlineFunction } from '../graph-manager/CubeEngine.js';
+export declare const ARCHIVE_RUNTIME = "northwind::ArchiveRuntime";
+export declare const ALL_ORDERS: CubeOutlineFunction;
+export declare const ORDERS_ABOVE: CubeOutlineFunction;
+export declare const SHIPPED: CubeOutlineFunction;
+export declare const ARCHIVED: CubeOutlineFunction;
+export declare const ORDERS_OF: CubeOutlineFunction;
+export declare const FUNCTIONS_OUTLINE: CubeModelOutline;
+export declare const FUNCTION_SCHEMA: Schema;
+//# sourceMappingURL=CubeFunctionTestOutline.d.ts.map

package/lib/__test-utils__/CubeFunctionTestOutline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeFunctionTestOutline.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/CubeFunctionTestOutline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAmB,MAAM,EAAgB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AAUxC,eAAO,MAAM,eAAe,8BAA8B,CAAC;AAc3D,eAAO,MAAM,UAAU,qBAAkB,CAAC;AAC1C,eAAO,MAAM,YAAY,qBAGvB,CAAC;AACH,eAAO,MAAM,OAAO,qBAAoD,CAAC;AACzE,eAAO,MAAM,QAAQ,qBAAmD,CAAC;AACzE,eAAO,MAAM,SAAS,qBAOrB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,gBAa/B,CAAC;AAEF,eAAO,MAAM,eAAe,QAE1B,CAAC"}

package/lib/__test-utils__/CubeFunctionTestOutline.js

@@ -0,0 +1,56 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { resolveCubeType, Schema, SchemaColumn } from '@finos/legend-cube';
+import { NORTHWIND_DATABASE, NORTHWIND_RUNTIME, } from './CubeNorthwindTestQueries.js';
+import { FAKE_NORTHWIND_OUTLINE } from './FakeCubeEngine.js';
+// The fake Northwind outline with functions that return a relation (PLAN
+// §6.5), and a second runtime: one function of each kind
+export const ARCHIVE_RUNTIME = 'northwind::ArchiveRuntime';
+const fn = (name, parameters = [], extra = {}) => ({
+    path: `northwind::${name}`,
+    signature: `northwind::${name}__Relation_1_`,
+    parameters,
+    columns: [{ name: 'ORDER_ID', type: 'Integer' }],
+    ...extra,
+});
+export const ALL_ORDERS = fn('allOrders');
+export const ORDERS_ABOVE = fn('ordersAbove', [
+    { name: 'min', type: 'Float', multiplicity: '[1]' },
+    { name: 'status', type: 'String', multiplicity: '[0..1]' },
+]);
+export const SHIPPED = fn('shipped', [], { runtime: NORTHWIND_RUNTIME });
+export const ARCHIVED = fn('archived', [], { runtime: ARCHIVE_RUNTIME });
+export const ORDERS_OF = fn('ordersOf', [{ name: 'ids', type: 'Integer', multiplicity: '[*]' }], {
+    problem: 'Its parameter "ids" takes [*] values; Cube takes one value, or none',
+});
+export const FUNCTIONS_OUTLINE = {
+    ...FAKE_NORTHWIND_OUTLINE,
+    runtimes: [
+        ...FAKE_NORTHWIND_OUTLINE.runtimes,
+        {
+            path: ARCHIVE_RUNTIME,
+            storePaths: [NORTHWIND_DATABASE],
+            connections: [
+                { storePath: NORTHWIND_DATABASE, databaseType: 'Postgres' },
+            ],
+        },
+    ],
+    functions: [ALL_ORDERS, ORDERS_ABOVE, SHIPPED, ARCHIVED, ORDERS_OF],
+};
+export const FUNCTION_SCHEMA = new Schema([
+    new SchemaColumn('ORDER_ID', resolveCubeType('Integer'), true),
+]);
+//# sourceMappingURL=CubeFunctionTestOutline.js.map

package/lib/__test-utils__/CubeFunctionTestOutline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeFunctionTestOutline.js","sourceRoot":"","sources":["../../src/__test-utils__/CubeFunctionTestOutline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAK3E,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,yEAAyE;AACzE,yDAAyD;AAEzD,MAAM,CAAC,MAAM,eAAe,GAAG,2BAA2B,CAAC;AAE3D,MAAM,EAAE,GAAG,CACT,IAAY,EACZ,aAAgD,EAAE,EAClD,QAAsC,EAAE,EACnB,EAAE,CAAC,CAAC;IACzB,IAAI,EAAE,cAAc,IAAI,EAAE;IAC1B,SAAS,EAAE,cAAc,IAAI,eAAe;IAC5C,UAAU;IACV,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAChD,GAAG,KAAK;CACT,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC,aAAa,EAAE;IAC5C,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE;IACnD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE;CAC3D,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,EAAE,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CACzB,UAAU,EACV,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EACvD;IACE,OAAO,EACL,qEAAqE;CACxE,CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAqB;IACjD,GAAG,sBAAsB;IACzB,QAAQ,EAAE;QACR,GAAG,sBAAsB,CAAC,QAAQ;QAClC;YACE,IAAI,EAAE,eAAe;YACrB,UAAU,EAAE,CAAC,kBAAkB,CAAC;YAChC,WAAW,EAAE;gBACX,EAAE,SAAS,EAAE,kBAAkB,EAAE,YAAY,EAAE,UAAU,EAAE;aAC5D;SACF;KACF;IACD,SAAS,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC;CACpE,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,MAAM,CAAC;IACxC,IAAI,YAAY,CAAC,UAAU,EAAE,eAAe,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;CAC/D,CAAC,CAAC"}

package/lib/__test-utils__/CubeLambdaCorpus.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type CubeDocument, type CubeSourceStep, type IR, type Query } from '@finos/legend-cube';
+export interface TEST__CubeLambdaSample {
+    /** `<file>/<node id>` */
+    readonly key: string;
+    readonly document: CubeDocument;
+    readonly nodeId: string;
+    /** The node's relation, as a matview saves it: `{| <relation>}`, written with its rows' order */
+    readonly relation: IR;
+    /** A run of the node with no row limit, as Show Pure shows it: lets, the capture's sort, `from()` */
+    readonly run: IR;
+}
+/** Every node of every sample that can be written, by key */
+export declare const TEST__cubeLambdaSamples: () => TEST__CubeLambdaSample[];
+/** Each table of the lambda bound to the sample's own source of it, with its saved columns */
+export declare const TEST__bindSampleSources: (document: CubeDocument) => (source: IR) => CubeSourceStep;
+/**
+ * The query with each Filter by Expression checked, as the editor has the
+ * engine check them on import: the samples' conditions are all Booleans
+ */
+export declare const TEST__checkedAsTheEngineWould: (query: Query) => Query;
+//# sourceMappingURL=CubeLambdaCorpus.d.ts.map

package/lib/__test-utils__/CubeLambdaCorpus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeLambdaCorpus.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/CubeLambdaCorpus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EASL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,EAAE,EACP,KAAK,KAAK,EACX,MAAM,oBAAoB,CAAC;AAa5B,MAAM,WAAW,sBAAsB;IACrC,yBAAyB;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iGAAiG;IACjG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;IACtB,qGAAqG;IACrG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC;CAClB;AAED,6DAA6D;AAC7D,eAAO,MAAM,uBAAuB,QAAO,sBAAsB,EA6B3D,CAAC;AAEP,8FAA8F;AAC9F,eAAO,MAAM,uBAAuB,GACjC,UAAU,YAAY,MACtB,QAAQ,EAAE,KAAG,cAwBb,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,6BAA6B,GAAI,OAAO,KAAK,KAAG,KAkBlD,CAAC"}