@finos/legend-cube-builder 0.0.3 → 0.0.5

package/lib/stores/CubeExecutionState.js

@@ -13,10 +13,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { isSchemasError, needsDatabaseType, } from '@finos/legend-cube';
+import { isSchemasError, } from '@finos/legend-cube';
 import { assertErrorThrown } from '@finos/legend-shared';
-import { action, computed, flow, flowResult, makeObservable, observable, } from 'mobx';
+import { action, computed, flow, makeObservable, observable } from 'mobx';
 import { CubeEngineError, CubeEngineErrorKind, } from '../graph-manager/CubeEngine.js';
+import { CUBE_RUN_LABEL } from '../__lib__/LegendCubeLabels.js';
+import { runCubeQuery } from './CubeQueryRun.js';
 /**
  * The first error found walking up from the capture node, named by its node.
  * A node that is invalid only because an input is gets passed over for that
@@ -70,11 +72,14 @@ export class CubeExecutionState {
     get isRunning() {
         return this.runController !== undefined;
     }
-    /** The shown result no longer matches the query or the row limit; it is kept until the next run */
+    /** The shown result no longer matches the query, the context or the row limit; it is kept until the next run */
     get isStale() {
         return (this.result !== undefined &&
             !this.isRunning &&
             (this.result.query !== this.editorState.document.query ||
+                this.result.context !== this.editorState.document.context ||
+                this.result.warehouse !==
+                    this.editorState.dataProductRuntime.effectiveWarehouse ||
                 this.result.rowLimit !== this.editorState.rowLimit));
     }
     /**
@@ -97,9 +102,11 @@ export class CubeExecutionState {
         }
         const captureId = query.selected;
         if (captureId === undefined) {
-            reasons.push('Select the node to run.');
+            reasons.push('Pick the step to run: Run this step, from its menu or editor.');
         }
-        else if (!emitter.canEmit(captureId)) {
+        else if (!emitter.canEmit(captureId) ||
+            // as the editor sees it: an Extend typed for another input waits
+            (analysis.validity.get(captureId) ?? []).length > 0) {
             reasons.push(findUpstreamError(query, analysis.validity, captureId));
         }
         return reasons;
@@ -111,8 +118,9 @@ export class CubeExecutionState {
         if (this.isRunning || !this.canExecute) {
             return;
         }
-        const { document, emitter, analysis, rowLimit, host } = this.editorState;
+        const { document, analysis, rowLimit } = this.editorState;
         const { query, context } = document;
+        const warehouse = this.editorState.dataProductRuntime.effectiveWarehouse;
         // checked by canExecute
         const captureId = query.selected;
         const model = context?.model;
@@ -126,47 +134,33 @@ export class CubeExecutionState {
         this.runController = controller;
         this.error = undefined;
         this.editorState.clearHostIssues();
+        // an export's failure is of the run it exported
+        this.editorState.export.clearError();
         try {
-            // a Drop, Slice, Limit or Distinct is written for the database it runs on
-            // (PLAN §11.4), which the model's outline gives: loaded once, waited
-            // for only then; the query, model and runtime are the ones captured
-            let databaseType;
-            if (needsDatabaseType(query, captureId)) {
-                yield flowResult(this.editorState.loadModelOutline(model));
-                if (this.runController !== controller || controller.signal.aborted) {
-                    return;
-                }
-                databaseType = this.editorState.getRunDatabaseType(query, captureId, model, runtime);
-            }
-            const lambda = emitter.emitExecutionLambda({
-                rowLimit,
+            // the query, model and runtime are the ones captured
+            const run = (yield runCubeQuery(this.editorState, {
+                query,
+                model,
                 runtime,
-                databaseType,
-            });
-            const response = (yield host.engine.execute(model, lambda, {
+                schema,
+                rowLimit,
                 abortController: controller,
+                label: CUBE_RUN_LABEL.EXECUTE,
             }));
             if (this.runController !== controller) {
                 return;
             }
-            // rows are read by position, so the engine's columns must be the query's
-            if (response.columns.length !== schema.columns.length) {
-                throw new CubeEngineError(CubeEngineErrorKind.EXECUTION, `The engine returned ${response.columns.length} columns, but the query has ${schema.columns.length}`, captureId);
-            }
-            const misplaced = schema.columns.findIndex((column, position) => response.columns[position] !== column.name);
-            if (misplaced !== -1) {
-                throw new CubeEngineError(CubeEngineErrorKind.EXECUTION, `The engine returned the column "${response.columns[misplaced]}" at position ${misplaced + 1}, but the query has "${schema.columns[misplaced]?.name}" there`, captureId);
-            }
-            const limited = response.rows.length > rowLimit;
             this.result = {
                 id: ++this.runCount,
                 query,
+                context,
+                warehouse,
                 schema,
-                rows: limited ? response.rows.slice(0, rowLimit) : response.rows,
+                rows: run.rows,
                 rowLimit,
-                limited,
-                sql: response.sql,
-                durationMs: response.durationMs,
+                limited: run.limited,
+                sql: run.sql,
+                durationMs: run.durationMs,
             };
         }
         catch (error) {
@@ -180,9 +174,11 @@ export class CubeExecutionState {
                 : new CubeEngineError(CubeEngineErrorKind.EXECUTION, error.message, captureId);
             // the rows of an earlier run are never shown as this run's
             this.result = undefined;
-            // an error belongs to the query it came from: one that changed while
-            // the run was in flight drops it, as an edit after the run would
-            if (this.editorState.document.query === query) {
+            // an error belongs to the query and the context it came from: one
+            // that changed while the run was in flight drops it, as an edit after
+            // the run would
+            if (this.editorState.document.query === query &&
+                this.editorState.document.context === context) {
                 this.error = engineError;
                 this.editorState.setHostIssue(engineError.nodeId ?? captureId, engineError);
             }
@@ -205,6 +201,11 @@ export class CubeExecutionState {
     /** Stops any run and forgets the last one's rows and error, e.g. when another cube is opened */
     reset() {
         this.stop();
+        this.editorState.gridFetcher.purge();
+        this.editorState.export.stop();
+        // an export's failure is of the run it exported (review of M7)
+        this.editorState.export.clearError();
+        this.editorState.grid.closeSettings();
         this.result = undefined;
         this.error = undefined;
     }

package/lib/stores/CubeExecutionState.js.map

@@ -1 +1 @@
-{"version":3,"file":"CubeExecutionState.js","sourceRoot":"","sources":["../../src/stores/CubeExecutionState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,cAAc,EACd,iBAAiB,GAGlB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAoB,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EACL,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,cAAc,EACd,UAAU,GACX,MAAM,MAAM,CAAC;AACd,OAAO,EACL,eAAe,EACf,mBAAmB,GAGpB,MAAM,gCAAgC,CAAC;AAoBxC;;;;GAIG;AACH,MAAM,iBAAiB,GAAG,CACxB,KAAY,EACZ,QAAgD,EAChD,SAAiB,EACT,EAAE;IACV,MAAM,KAAK,GAAG,CAAC,MAAc,EAAsB,EAAE;QACnD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjE,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAC7C,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CACtC,CAAC;QACF,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,KAAK,EAAE,CAAC;IAC1E,CAAC,CAAC;IACF,OAAO,CACL,KAAK,CAAC,SAAS,CAAC,IAAI,oDAAoD,CACzE,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IACpB,WAAW,CAAkB;IAEtC,MAAM,CAAkC;IACxC,KAAK,CAA8B;IACnC,wDAAwD;IAChD,aAAa,CAA8B;IAC3C,QAAQ,GAAG,CAAC,CAAC;IAErB,YAAY,WAA4B;QACtC,cAAc,CAAsC,IAAI,EAAE;YACxD,MAAM,EAAE,UAAU,CAAC,GAAG;YACtB,KAAK,EAAE,UAAU,CAAC,GAAG;YACrB,aAAa,EAAE,UAAU,CAAC,GAAG;YAC7B,SAAS,EAAE,QAAQ;YACnB,OAAO,EAAE,QAAQ;YACjB,eAAe,EAAE,QAAQ;YACzB,UAAU,EAAE,QAAQ;YACpB,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,MAAM;YAClB,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC;IAC1C,CAAC;IAED,mGAAmG;IACnG,IAAI,OAAO;QACT,OAAO,CACL,IAAI,CAAC,MAAM,KAAK,SAAS;YACzB,CAAC,IAAI,CAAC,SAAS;YACf,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK;gBACpD,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CACtD,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,IAAI,eAAe;QACjB,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;QACzD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACxB,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACzC,CAAC;aAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC;QACjC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;IACtC,CAAC;IAED,CAAC,OAAO;QACN,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,OAAO;QACT,CAAC;QACD,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;QACzE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;QACpC,wBAAwB;QACxB,MAAM,SAAS,GAAG,KAAK,CAAC,QAAkB,CAAC;QAC3C,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,CAAC;QAC7B,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;QACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QACD,2EAA2E;QAC3E,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,0EAA0E;YAC1E,qEAAqE;YACrE,oEAAoE;YACpE,IAAI,YAAgC,CAAC;YACrC,IAAI,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;gBACxC,MAAM,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC3D,IAAI,IAAI,CAAC,aAAa,KAAK,UAAU,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnE,OAAO;gBACT,CAAC;gBACD,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAChD,KAAK,EACL,SAAS,EACT,KAAK,EACL,OAAO,CACR,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;gBACzC,QAAQ;gBACR,OAAO;gBACP,YAAY;aACb,CAAC,CAAC;YACH,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE;gBACzD,eAAe,EAAE,UAAU;aAC5B,CAAC,CAAe,CAAC;YAClB,IAAI,IAAI,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;gBACtC,OAAO;YACT,CAAC;YACD,yEAAyE;YACzE,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACtD,MAAM,IAAI,eAAe,CACvB,mBAAmB,CAAC,SAAS,EAC7B,uBAAuB,QAAQ,CAAC,OAAO,CAAC,MAAM,+BAA+B,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EACpG,SAAS,CACV,CAAC;YACJ,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CACxC,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,IAAI,CACjE,CAAC;YACF,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;gBACrB,MAAM,IAAI,eAAe,CACvB,mBAAmB,CAAC,SAAS,EAC7B,mCAAmC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,iBAAiB,SAAS,GAAG,CAAC,wBAAwB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,SAAS,EAC5J,SAAS,CACV,CAAC;YACJ,CAAC;YACD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;YAChD,IAAI,CAAC,MAAM,GAAG;gBACZ,EAAE,EAAE,EAAE,IAAI,CAAC,QAAQ;gBACnB,KAAK;gBACL,MAAM;gBACN,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI;gBAChE,QAAQ;gBACR,OAAO;gBACP,GAAG,EAAE,QAAQ,CAAC,GAAG;gBACjB,UAAU,EAAE,QAAQ,CAAC,UAAU;aAChC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0CAA0C;YAC1C,IAAI,IAAI,CAAC,aAAa,KAAK,UAAU,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnE,OAAO;YACT,CAAC;YACD,iBAAiB,CAAC,KAAK,CAAC,CAAC;YACzB,MAAM,WAAW,GACf,KAAK,YAAY,eAAe;gBAC9B,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,IAAI,eAAe,CACjB,mBAAmB,CAAC,SAAS,EAC7B,KAAK,CAAC,OAAO,EACb,SAAS,CACV,CAAC;YACR,2DAA2D;YAC3D,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YACxB,qEAAqE;YACrE,iEAAiE;YACjE,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC9C,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC;gBACzB,IAAI,CAAC,WAAW,CAAC,YAAY,CAC3B,WAAW,CAAC,MAAM,IAAI,SAAS,EAC/B,WAAW,CACZ,CAAC;YACJ,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,IAAI,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;gBACtC,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,UAAU;QACR,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,iEAAiE;IACjE,IAAI;QACF,IAAI,CAAC,aAAa,EAAE,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;IACjC,CAAC;IAED,gGAAgG;IAChG,KAAK;QACH,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"CubeExecutionState.js","sourceRoot":"","sources":["../../src/stores/CubeExecutionState.ts"],"names":[],"mappings":"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"}

package/lib/stores/CubeExportState.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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 ColumnDirection } from '@finos/legend-cube';
+import { type GeneratorFn } from '@finos/legend-shared';
+import { CubeEngineError } from '../graph-manager/CubeEngine.js';
+import type { CubeEditorState } from './CubeEditorState.js';
+import type { CubeExecutionResult } from './CubeExecutionState.js';
+export declare const CUBE_EXPORT_CONTEXT_CHANGED = "The cube's model, runtime or warehouse changed since this run: execute again to export it.";
+/** A file name for a cube's export, from its name, e.g. `Largest_buys.csv` */
+export declare const getCubeExportFileName: (name: string | undefined, extension: "csv" | "xlsx") => string;
+/**
+ * The results' export (spec §12.5, PLAN §11.10): CSV of the whole query,
+ * run on the engine with no row limit, sorted as the grid is, saved by the
+ * browser. Only the run on screen is exported, in the context it ran in. A
+ * failure is kept for the grid region; Stop aborts the export.
+ */
+export declare class CubeExportState {
+    readonly editorState: CubeEditorState;
+    error: CubeEngineError | undefined;
+    private controller;
+    constructor(editorState: CubeEditorState);
+    get isExporting(): boolean;
+    /** The run's whole query as CSV, sorted as the grid is (by the run's column names) */
+    exportCsv(result: CubeExecutionResult, sorts?: readonly ColumnDirection[]): GeneratorFn<void>;
+    stop(): void;
+    clearError(): void;
+}
+//# sourceMappingURL=CubeExportState.d.ts.map

package/lib/stores/CubeExportState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeExportState.d.ts","sourceRoot":"","sources":["../../src/stores/CubeExportState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAEL,KAAK,eAAe,EAKrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAS9B,OAAO,EACL,eAAe,EAEhB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,eAAO,MAAM,2BAA2B,+FACsD,CAAC;AAE/F,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,GAAG,SAAS,EACxB,WAAW,KAAK,GAAG,MAAM,KACxB,MAGF,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,KAAK,EAAE,eAAe,GAAG,SAAS,CAAC;IACnC,OAAO,CAAC,UAAU,CAA8B;gBAEpC,WAAW,EAAE,eAAe;IAYxC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,sFAAsF;IACrF,SAAS,CACR,MAAM,EAAE,mBAAmB,EAC3B,KAAK,GAAE,SAAS,eAAe,EAAO,GACrC,WAAW,CAAC,IAAI,CAAC;IAkGpB,IAAI,IAAI,IAAI;IAKZ,UAAU,IAAI,IAAI;CAGnB"}

package/lib/stores/CubeExportState.js

@@ -0,0 +1,134 @@
+/**
+ * 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 { checkDrilldown, deriveDrilldownLevel, needsDatabaseType, QueryEmitter, } from '@finos/legend-cube';
+import { assertErrorThrown, ContentType, downloadFileUsingDataURI, } from '@finos/legend-shared';
+import { action, computed, flow, flowResult, makeObservable, observable, } from 'mobx';
+import { CubeEngineError, CubeEngineErrorKind, } from '../graph-manager/CubeEngine.js';
+import { CUBE_RUN_LABEL } from '../__lib__/LegendCubeLabels.js';
+export const CUBE_EXPORT_CONTEXT_CHANGED = "The cube's model, runtime or warehouse changed since this run: execute again to export it.";
+/** A file name for a cube's export, from its name, e.g. `Largest_buys.csv` */
+export const getCubeExportFileName = (name, extension) => {
+    const base = name?.trim().replace(/[^\w.-]+/gu, '_') ?? '';
+    return `${base.length ? base : 'cube'}.${extension}`;
+};
+/**
+ * The results' export (spec §12.5, PLAN §11.10): CSV of the whole query,
+ * run on the engine with no row limit, sorted as the grid is, saved by the
+ * browser. Only the run on screen is exported, in the context it ran in. A
+ * failure is kept for the grid region; Stop aborts the export.
+ */
+export class CubeExportState {
+    editorState;
+    error;
+    controller;
+    constructor(editorState) {
+        makeObservable(this, {
+            error: observable.ref,
+            controller: observable.ref,
+            isExporting: computed,
+            exportCsv: flow,
+            stop: action,
+            clearError: action,
+        });
+        this.editorState = editorState;
+    }
+    get isExporting() {
+        return this.controller !== undefined;
+    }
+    /** The run's whole query as CSV, sorted as the grid is (by the run's column names) */
+    *exportCsv(result, sorts = []) {
+        const { editorState } = this;
+        const model = result.context?.model;
+        const runtime = result.context?.runtime;
+        const captureId = result.query.selected;
+        if (this.isExporting || !model || !runtime || captureId === undefined) {
+            return;
+        }
+        this.error = undefined;
+        // the warehouse is read from the page when the query runs
+        if (result.context !== editorState.document.context ||
+            result.warehouse !== editorState.dataProductRuntime.effectiveWarehouse) {
+            this.error = new CubeEngineError(CubeEngineErrorKind.EXECUTION, CUBE_EXPORT_CONTEXT_CHANGED, captureId);
+            return;
+        }
+        const controller = new AbortController();
+        this.controller = controller;
+        const startedAt = Date.now();
+        // kept for the Runs panel, once written (PLAN §11.16)
+        let lambda;
+        try {
+            // the run's rows, sorted as the grid is: no drill-down level
+            const { query } = deriveDrilldownLevel({
+                query: result.query,
+                captureId,
+                schema: result.schema,
+                drilldown: checkDrilldown({ columns: [], aggregations: [] }, result.schema),
+                keys: [],
+                sorts,
+            });
+            const runId = query.selected;
+            let databaseType;
+            if (needsDatabaseType(query, runId)) {
+                yield flowResult(editorState.loadModelOutline(model));
+                databaseType = editorState.getRunDatabaseType(query, runId, model, runtime);
+            }
+            if (controller.signal.aborted) {
+                return;
+            }
+            lambda = new QueryEmitter(query, editorState.registry).emitExecutionLambda({ runtime, databaseType });
+            const csv = (yield editorState.host.engine.exportCsv(model, lambda, {
+                abortController: controller,
+            }));
+            // stopped while it ran: `stop()` lets go of it
+            if (this.controller !== controller) {
+                return;
+            }
+            downloadFileUsingDataURI(getCubeExportFileName(editorState.document.name, 'csv'), csv, ContentType.TEXT_CSV);
+            editorState.runStats.record(CUBE_RUN_LABEL.EXPORT_CSV, {
+                durationMs: Date.now() - startedAt,
+                lambda,
+            });
+        }
+        catch (error) {
+            if (controller.signal.aborted) {
+                return;
+            }
+            assertErrorThrown(error);
+            this.error =
+                error instanceof CubeEngineError
+                    ? error
+                    : new CubeEngineError(CubeEngineErrorKind.EXECUTION, error.message, captureId);
+            editorState.runStats.record(CUBE_RUN_LABEL.EXPORT_CSV, {
+                durationMs: Date.now() - startedAt,
+                lambda,
+                error: this.error.firstLine,
+            });
+        }
+        finally {
+            if (this.controller === controller) {
+                this.controller = undefined;
+            }
+        }
+    }
+    stop() {
+        this.controller?.abort();
+        this.controller = undefined;
+    }
+    clearError() {
+        this.error = undefined;
+    }
+}
+//# sourceMappingURL=CubeExportState.js.map

package/lib/stores/CubeExportState.js.map

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

package/lib/stores/CubeExpressionFilterCheck.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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 ExpressionCheck, type ExpressionFilter, type IR, type JsonObject, type NodeRegistry, type Query, Schema } from '@finos/legend-cube';
+import { CubeEngineError, type NodeId } from '../graph-manager/CubeEngine.js';
+/** A name for the condition typed alone that no input column has, as databases that ignore case compare names */
+export declare const getConditionColumnName: (input: Schema) => string;
+/**
+ * The lambdas that check a condition, by key: the input's relation filtered
+ * with it, and the input's relation extended with it under a name no input
+ * column has. A located lambda keeps its locations, so an error points into
+ * its text; a stored one is marked with the filter, so an error lands on it.
+ * The input must be valid.
+ */
+export declare const buildCubeConditionCheckLambdas: (query: Query, filter: ExpressionFilter, condition: JsonObject, input: Schema, registry: NodeRegistry, located: boolean) => Map<NodeId, IR>;
+/** What checking a condition gave: the check to store, and the error the engine gave, if it failed */
+export interface CubeConditionCheckResult {
+    readonly check: ExpressionCheck;
+    readonly error?: CubeEngineError | undefined;
+}
+/**
+ * The check the engine's answers give, for this input and this condition:
+ * checked when the filter types; else failed, with the condition's type when
+ * it types alone but isn't one Boolean, and the engine's error: the
+ * condition's own when it fails alone, as it names no `filter`, else the
+ * filter's (a network failure when there is neither)
+ */
+export declare const readCubeConditionCheck: (answers: ReadonlyMap<NodeId, Schema | CubeEngineError>, filter: ExpressionFilter, input: Schema, upstream: string | undefined) => CubeConditionCheckResult;
+/** The digest of what the engine was given for the input, which the check recorded */
+export declare const getCubeConditionCheckUpstream: (check: ExpressionCheck) => string | undefined;
+/**
+ * Whether the filter's check says its condition is one Boolean for this
+ * input: checked, for this schema and this condition, and for this input as
+ * the engine is given it, or recorded without it, as when loaded
+ */
+export declare const isCubeConditionCheckCurrent: (filter: ExpressionFilter, input: Schema, upstream: string | undefined) => boolean;
+/** Whether two checks say the same: the same kind, signature and input as the engine was given it, and the same failure */
+export declare const isSameCubeConditionCheck: (a: ExpressionCheck, b: ExpressionCheck) => boolean;
+//# sourceMappingURL=CubeExpressionFilterCheck.d.ts.map

package/lib/stores/CubeExpressionFilterCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeExpressionFilterCheck.d.ts","sourceRoot":"","sources":["../../src/stores/CubeExpressionFilterCheck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAIrB,KAAK,EAAE,EACP,KAAK,UAAU,EAGf,KAAK,YAAY,EAEjB,KAAK,KAAK,EAEV,MAAM,EAGP,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EAEf,KAAK,MAAM,EACZ,MAAM,gCAAgC,CAAC;AAexC,iHAAiH;AACjH,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,KAAG,MAOtD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,GACzC,OAAO,KAAK,EACZ,QAAQ,gBAAgB,EACxB,WAAW,UAAU,EACrB,OAAO,MAAM,EACb,UAAU,YAAY,EACtB,SAAS,OAAO,KACf,GAAG,CAAC,MAAM,EAAE,EAAE,CAgChB,CAAC;AAMF,sGAAsG;AACtG,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CAC9C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,EACtD,QAAQ,gBAAgB,EACxB,OAAO,MAAM,EACb,UAAU,MAAM,GAAG,SAAS,KAC3B,wBAmCF,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,6BAA6B,GACxC,OAAO,eAAe,KACrB,MAAM,GAAG,SAC8C,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GACtC,QAAQ,gBAAgB,EACxB,OAAO,MAAM,EACb,UAAU,MAAM,GAAG,SAAS,KAC3B,OAQF,CAAC;AAEF,2HAA2H;AAC3H,eAAO,MAAM,wBAAwB,GACnC,GAAG,eAAe,EAClB,GAAG,eAAe,KACjB,OAeF,CAAC"}

package/lib/stores/CubeExpressionFilterCheck.js

@@ -0,0 +1,134 @@
+/**
+ * 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 { colSpec, colSpecArray, EmitRole, foldColumnName, func, getExpressionFilterSignature, lambda, lambdaJson, originOf, QueryEmitter, Schema, TypeFamily, } from '@finos/legend-cube';
+import { CubeEngineError, CubeEngineErrorKind, } from '../graph-manager/CubeEngine.js';
+import { withoutEngineContext } from './CubeExtendTyping.js';
+// Checking a Filter by Expression's condition with the engine (PLAN §11.11):
+// its input's relation, as Cube types any node, then `filter` with the
+// condition. A condition that isn't one Boolean fails there with no location
+// and the whole relation type, so the same call types the condition alone,
+// as an extend column, which gives its type for Cube's own message.
+/** The key of the lambda that filters the input with the condition */
+const filterKeyOf = (filterId) => `${filterId}#filter`;
+/** The key of the lambda that types the condition alone, as an extend column */
+const conditionKeyOf = (filterId) => `${filterId}#condition`;
+/** A name for the condition typed alone that no input column has, as databases that ignore case compare names */
+export const getConditionColumnName = (input) => {
+    const taken = new Set(input.names().map(foldColumnName));
+    let name = 'cube_condition';
+    for (let suffix = 2; taken.has(foldColumnName(name)); suffix += 1) {
+        name = `cube_condition_${suffix}`;
+    }
+    return name;
+};
+/**
+ * The lambdas that check a condition, by key: the input's relation filtered
+ * with it, and the input's relation extended with it under a name no input
+ * column has. A located lambda keeps its locations, so an error points into
+ * its text; a stored one is marked with the filter, so an error lands on it.
+ * The input must be valid.
+ */
+export const buildCubeConditionCheckLambdas = (query, filter, condition, input, registry, located) => {
+    const [inputId] = query.getInputIds(filter.id);
+    if (inputId === undefined) {
+        throw new Error(`Filter by expression "${filter.id}" has no input to check it on`);
+    }
+    const relation = new QueryEmitter(query, registry).emitRelation(inputId);
+    const origin = located ? undefined : originOf(filter.id, EmitRole.EXPRESSION);
+    return new Map([
+        [
+            filterKeyOf(filter.id),
+            lambda([], [func('filter', [relation, lambdaJson(condition, origin)])]),
+        ],
+        [
+            conditionKeyOf(filter.id),
+            lambda([], [
+                func('extend', [
+                    relation,
+                    colSpecArray([
+                        colSpec(getConditionColumnName(input), lambdaJson(condition, origin)),
+                    ]),
+                ]),
+            ]),
+        ],
+    ]);
+};
+/** A condition's type as the message names it: `Integer`, `Boolean[0..1]` */
+const describeConditionType = (column) => `${column.type.displayName}${column.nullable ? '[0..1]' : ''}`;
+/**
+ * The check the engine's answers give, for this input and this condition:
+ * checked when the filter types; else failed, with the condition's type when
+ * it types alone but isn't one Boolean, and the engine's error: the
+ * condition's own when it fails alone, as it names no `filter`, else the
+ * filter's (a network failure when there is neither)
+ */
+export const readCubeConditionCheck = (answers, filter, input, upstream) => {
+    const signature = getExpressionFilterSignature(input, filter.lambda);
+    const filtered = answers.get(filterKeyOf(filter.id));
+    if (filtered instanceof Schema) {
+        return { check: { kind: 'checked', signature, upstream } };
+    }
+    const alone = answers.get(conditionKeyOf(filter.id));
+    const conditionColumn = alone instanceof Schema ? alone.columns.at(-1) : undefined;
+    const resultType = conditionColumn &&
+        !(conditionColumn.type.family === TypeFamily.BOOLEAN &&
+            !conditionColumn.nullable)
+        ? describeConditionType(conditionColumn)
+        : undefined;
+    const error = (alone instanceof CubeEngineError ? alone : undefined) ??
+        filtered ??
+        new CubeEngineError(CubeEngineErrorKind.NETWORK, 'The engine gave no answer for this condition', filter.id);
+    return {
+        check: {
+            kind: 'failed',
+            signature,
+            message: withoutEngineContext(error.detail),
+            resultType,
+            upstream,
+        },
+        error,
+    };
+};
+/** The digest of what the engine was given for the input, which the check recorded */
+export const getCubeConditionCheckUpstream = (check) => check.kind === 'unresolved' ? undefined : check.upstream;
+/**
+ * Whether the filter's check says its condition is one Boolean for this
+ * input: checked, for this schema and this condition, and for this input as
+ * the engine is given it, or recorded without it, as when loaded
+ */
+export const isCubeConditionCheckCurrent = (filter, input, upstream) => {
+    const { check } = filter;
+    const recorded = getCubeConditionCheckUpstream(check);
+    return (check.kind === 'checked' &&
+        filter.currentCheck(input) === check &&
+        (recorded === undefined || recorded === upstream));
+};
+/** Whether two checks say the same: the same kind, signature and input as the engine was given it, and the same failure */
+export const isSameCubeConditionCheck = (a, b) => {
+    if (getCubeConditionCheckUpstream(a) !== getCubeConditionCheckUpstream(b)) {
+        return false;
+    }
+    if (a.kind === 'checked' && b.kind === 'checked') {
+        return a.signature === b.signature;
+    }
+    if (a.kind === 'failed' && b.kind === 'failed') {
+        return (a.signature === b.signature &&
+            a.message === b.message &&
+            a.resultType === b.resultType);
+    }
+    return a.kind === 'unresolved' && b.kind === 'unresolved';
+};
+//# sourceMappingURL=CubeExpressionFilterCheck.js.map

package/lib/stores/CubeExpressionFilterCheck.js.map

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

package/lib/stores/CubeExtendTyping.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 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 Extend, type ExtendTyping, type IR, type JsonObject, type ModelContext, type NodeRegistry, type Query, QueryEmitter, type Schema } from '@finos/legend-cube';
+import { CubeEngineError, type NodeId } from '../graph-manager/CubeEngine.js';
+/** An engine message without the compiler's ` - Context:[…]` trail, which repeats what it was doing */
+export declare const withoutEngineContext: (message: string) => string;
+/** A column to type: its name, and its lambda, located in its text or not */
+export interface CubeExtendTypingColumn {
+    readonly name: string;
+    readonly lambda: JsonObject;
+}
+/**
+ * The lambdas that type an Extend's columns, by key: the input's relation
+ * then the first k columns, for every k. A located lambda keeps its
+ * locations, so an error points into its text; a stored one is marked with
+ * the Extend, so an error lands on it. The input must be valid.
+ */
+export declare const buildCubeExtendTypingLambdas: (query: Query, extend: Extend, columns: readonly CubeExtendTypingColumn[], registry: NodeRegistry, located: boolean) => Map<NodeId, IR>;
+/**
+ * What the engine is given for a node's input when it types an Extend or
+ * checks a Filter by Expression, digested (PLAN §11.7, §11.11): the input's
+ * relation as emitted, and the model. A typing or a check records it
+ * (`upstream`), since the engine sees more than Cube's schema does;
+ * `undefined` when the input can't be emitted, e.g. it is invalid.
+ */
+export declare const getCubeExtendUpstream: (emitter: QueryEmitter, extendId: string, model: ModelContext) => string | undefined;
+/** The digest of what the engine was given for the input, which the typing recorded */
+export declare const getCubeExtendTypingUpstream: (typing: ExtendTyping) => string | undefined;
+/**
+ * Whether the Extend's typing gives its types for this input: typed, for
+ * this schema and these columns, and for this input as the engine is given
+ * it, or recorded without it, as when loaded
+ */
+export declare const isCubeExtendTypingCurrent: (extend: Extend, input: Schema, upstream: string | undefined) => boolean;
+/** What typing an Extend gave: the typing to store, and the error the engine gave, if it failed */
+export interface CubeExtendTypingResult {
+    readonly typing: ExtendTyping;
+    readonly error?: CubeEngineError | undefined;
+}
+/**
+ * The typing the engine's answers give, for this input and these columns:
+ * every column's type, from the whole chain, else the first column whose
+ * chain fails, with the engine's error (a network failure on none)
+ */
+export declare const readCubeExtendTyping: (answers: ReadonlyMap<NodeId, Schema | CubeEngineError>, extend: Extend, input: Schema, columns: readonly CubeExtendTypingColumn[], upstream: string | undefined) => CubeExtendTypingResult;
+/**
+ * Whether two typings say the same: the same kind, signature and input as
+ * the engine was given it, and the same types, or the same failure
+ */
+export declare const isSameCubeExtendTyping: (a: ExtendTyping, b: ExtendTyping) => boolean;
+//# sourceMappingURL=CubeExtendTyping.d.ts.map

package/lib/stores/CubeExtendTyping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeExtendTyping.d.ts","sourceRoot":"","sources":["../../src/stores/CubeExtendTyping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAIL,KAAK,MAAM,EACX,KAAK,YAAY,EAIjB,KAAK,EAAE,EACP,KAAK,UAAU,EAGf,KAAK,YAAY,EACjB,KAAK,YAAY,EAGjB,KAAK,KAAK,EACV,YAAY,EACZ,KAAK,MAAM,EAEZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EAEf,KAAK,MAAM,EACZ,MAAM,gCAAgC,CAAC;AAOxC,uGAAuG;AACvG,eAAO,MAAM,oBAAoB,GAAI,SAAS,MAAM,KAAG,MACT,CAAC;AAE/C,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAMD;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GACvC,OAAO,KAAK,EACZ,QAAQ,MAAM,EACd,SAAS,SAAS,sBAAsB,EAAE,EAC1C,UAAU,YAAY,EACtB,SAAS,OAAO,KACf,GAAG,CAAC,MAAM,EAAE,EAAE,CAwBhB,CAAC;AAcF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,YAAY,EACrB,UAAU,MAAM,EAChB,OAAO,YAAY,KAClB,MAAM,GAAG,SAQX,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,2BAA2B,GACtC,QAAQ,YAAY,KACnB,MAAM,GAAG,SACgD,CAAC;AAI7D;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACpC,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,UAAU,MAAM,GAAG,SAAS,KAC3B,OAQF,CAAC;AAEF,mGAAmG;AACnG,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CAC9C;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,EACtD,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,SAAS,SAAS,sBAAsB,EAAE,EAC1C,UAAU,MAAM,GAAG,SAAS,KAC3B,sBAyCF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,GAAG,YAAY,EACf,GAAG,YAAY,KACd,OAsBF,CAAC"}