@finos/legend-cube-builder 0.0.0-stage → 0.0.2

package/lib/stores/CubeExecutionState.js

@@ -0,0 +1,196 @@
+/**
+ * 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 { isSchemasError } from '@finos/legend-cube';
+import { assertErrorThrown } from '@finos/legend-shared';
+import { action, computed, flow, makeObservable, observable } from 'mobx';
+import { CubeEngineError, CubeEngineErrorKind, } from '../graph-manager/CubeEngine.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
+ * input's own error.
+ */
+const findUpstreamError = (query, validity, captureId) => {
+    const visit = (nodeId) => {
+        const node = query.getNode(nodeId);
+        if (!node) {
+            return undefined;
+        }
+        for (const inputId of query.getInputIds(nodeId)) {
+            const error = inputId === undefined ? undefined : visit(inputId);
+            if (error) {
+                return error;
+            }
+        }
+        const error = (validity.get(nodeId) ?? []).find((message) => !isSchemasError(message));
+        return error === undefined ? undefined : `${node.describe()}: ${error}`;
+    };
+    return (visit(captureId) ?? 'The node to run, or one of its inputs, has errors.');
+};
+/**
+ * Runs the query up to its capture node (PLAN §8.2, §9). Execution is
+ * explicit; while a run is in flight Execute becomes Stop, and only the latest
+ * run's answer is applied (Settled before M1.8).
+ */
+export class CubeExecutionState {
+    editorState;
+    result;
+    error;
+    /** The abort controller of the run in flight, if any */
+    runController;
+    runCount = 0;
+    constructor(editorState) {
+        makeObservable(this, {
+            result: observable.ref,
+            error: observable.ref,
+            runController: observable.ref,
+            isRunning: computed,
+            isStale: computed,
+            disabledReasons: computed,
+            canExecute: computed,
+            execute: flow,
+            clearError: action,
+            stop: action,
+            reset: action,
+        });
+        this.editorState = editorState;
+    }
+    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 */
+    get isStale() {
+        return (this.result !== undefined &&
+            !this.isRunning &&
+            (this.result.query !== this.editorState.document.query ||
+                this.result.rowLimit !== this.editorState.rowLimit));
+    }
+    /**
+     * Why Execute is unavailable, if it is: it needs a source, a model and a
+     * runtime, and a valid capture node whose inputs are all valid. Invalid
+     * nodes elsewhere don't matter (PLAN §10.3).
+     */
+    get disabledReasons() {
+        const { document, emitter, analysis } = this.editorState;
+        const { query, context } = document;
+        if (!query.nodes.length) {
+            return ['Add a table first.'];
+        }
+        const reasons = [];
+        if (!context) {
+            reasons.push('The cube has no model.');
+        }
+        else if (!context.runtime) {
+            reasons.push('The cube has no runtime.');
+        }
+        const captureId = query.selected;
+        if (captureId === undefined) {
+            reasons.push('Select the node to run.');
+        }
+        else if (!emitter.canEmit(captureId)) {
+            reasons.push(findUpstreamError(query, analysis.validity, captureId));
+        }
+        return reasons;
+    }
+    get canExecute() {
+        return !this.disabledReasons.length;
+    }
+    *execute() {
+        if (this.isRunning || !this.canExecute) {
+            return;
+        }
+        const { document, emitter, analysis, rowLimit, host } = this.editorState;
+        const { query, context } = document;
+        // checked by canExecute
+        const captureId = query.selected;
+        const model = context?.model;
+        const runtime = context?.runtime;
+        const schema = analysis.schemas.get(captureId);
+        if (!model || !runtime || !schema) {
+            return;
+        }
+        const lambda = emitter.emitExecutionLambda({ rowLimit, runtime });
+        const controller = new AbortController();
+        this.runController = controller;
+        this.error = undefined;
+        this.editorState.clearHostIssues();
+        try {
+            const response = (yield host.engine.execute(model, lambda, {
+                abortController: controller,
+            }));
+            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,
+                schema,
+                rows: limited ? response.rows.slice(0, rowLimit) : response.rows,
+                rowLimit,
+                limited,
+                sql: response.sql,
+                durationMs: response.durationMs,
+            };
+        }
+        catch (error) {
+            // a stopped or replaced run shows nothing
+            if (this.runController !== controller || controller.signal.aborted) {
+                return;
+            }
+            assertErrorThrown(error);
+            const engineError = error instanceof CubeEngineError
+                ? error
+                : 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) {
+                this.error = engineError;
+                this.editorState.setHostIssue(engineError.nodeId ?? captureId, engineError);
+            }
+        }
+        finally {
+            if (this.runController === controller) {
+                this.runController = undefined;
+            }
+        }
+    }
+    /** Drops the last run's error: it described a query the cube no longer has */
+    clearError() {
+        this.error = undefined;
+    }
+    /** Cancels the run in flight; it shows no result and no error */
+    stop() {
+        this.runController?.abort();
+        this.runController = undefined;
+    }
+    /** Stops any run and forgets the last one's rows and error, e.g. when another cube is opened */
+    reset() {
+        this.stop();
+        this.result = undefined;
+        this.error = undefined;
+    }
+}
+//# sourceMappingURL=CubeExecutionState.js.map

package/lib/stores/CubeExecutionState.js.map

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

package/lib/stores/CubeHost.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 { GenericLegendApplicationStore } from '@finos/legend-application';
+import type { CubeEngine } from '../graph-manager/CubeEngine.js';
+import type { LocalModelCatalog } from './LocalModelCatalog.js';
+/**
+ * What the application hosting the Cube page gives it (PLAN §3.5, Settled
+ * before M1.8). The host chooses the engine and the models; Cube keeps no
+ * auth, config or telemetry of its own and uses the host's application store
+ * for commands, user data, the clipboard, the theme, notifications, alerts and
+ * telemetry.
+ */
+export interface CubeHost {
+    readonly applicationStore: GenericLegendApplicationStore;
+    readonly engine: CubeEngine;
+    readonly modelCatalog: LocalModelCatalog;
+}
+//# sourceMappingURL=CubeHost.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeHost.d.ts","sourceRoot":"","sources":["../../src/stores/CubeHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,gBAAgB,EAAE,6BAA6B,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;CAC1C"}

package/lib/stores/CubeHost.js

@@ -0,0 +1,17 @@
+/**
+ * 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.
+ */
+export {};
+//# sourceMappingURL=CubeHost.js.map

package/lib/stores/CubeHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeHost.js","sourceRoot":"","sources":["../../src/stores/CubeHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/lib/stores/CubeNodeEditorState.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 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 { NodeRegistry, QueryNode } from '@finos/legend-cube';
+import { CUBE_EDITOR_CLOSED_REASON } from '../__lib__/LegendCubeLabels.js';
+import type { CubeEditorState } from './CubeEditorState.js';
+import type { CubeNodeDraft } from './editors/CubeNodeDraft.js';
+/**
+ * Whether two nodes of the same id save the same: their own fields, as the
+ * spec stores them, and the keys this version doesn't know. A node of a type
+ * the registry doesn't know is the same only as itself.
+ */
+export declare const isSameNodeContent: (registry: NodeRegistry, a: QueryNode, b: QueryNode) => boolean;
+/**
+ * The node editor in the side panel (PLAN §7.4, spec §17.5). Opening it
+ * never changes which node Execute runs. Edits go to a draft, and only Apply,
+ * or closing the panel, stores them, as one undo step; Cancel drops them.
+ *
+ * The panel follows the cube (user's choice, 2026-10-07): when the node it
+ * shows is replaced or removed underneath it, by Undo, a re-check or a
+ * Remove, a panel with edits closes without applying them and says so; one
+ * without edits shows the new node, or closes when the node is gone.
+ */
+export declare class CubeNodeEditorState {
+    readonly editorState: CubeEditorState;
+    /** The id of the node the panel shows, while it is open */
+    nodeId: string | undefined;
+    /** The key of the node the draft was made from */
+    private nodeKey;
+    draft: CubeNodeDraft | undefined;
+    /** Why the panel closed by itself, until it opens again or is dismissed */
+    notice: string | undefined;
+    private readonly disposeSync;
+    constructor(editorState: CubeEditorState);
+    /** The node the panel shows, as the cube has it now */
+    get node(): QueryNode | undefined;
+    /** The node Apply would store, built once per edit */
+    get edited(): QueryNode | undefined;
+    /** The draft saves differently from the node it was made from */
+    get hasChanges(): boolean;
+    /** Opens the panel on a node, closing (and so applying) the one it showed */
+    open(nodeId: string): void;
+    /**
+     * Stores the draft in place of the node, as one undo step, and goes on
+     * editing the stored node. Does nothing without changes, or while the cube
+     * is read-only.
+     */
+    apply(): void;
+    get canSwapInputs(): boolean;
+    /**
+     * Swaps the node's two inputs (a Join's Swap Inputs, spec §17.6), applying
+     * the draft first, as one undo step, then goes on editing the swapped
+     * node, whose settings followed its inputs
+     */
+    swapInputs(): void;
+    /** Applies the draft, then closes the panel (spec §17.5: edits commit on close) */
+    close(): void;
+    /** Closes the panel, dropping the draft */
+    cancel(): void;
+    /**
+     * Closes the panel without applying the draft, e.g. when another cube is
+     * opened, saying so when that drops edits
+     */
+    discard(reason: CUBE_EDITOR_CLOSED_REASON): void;
+    dismissNotice(): void;
+    /** Stops following the cube; call when the page closes */
+    dispose(): void;
+    private bind;
+    private reset;
+    /** Runs whenever the node with the panel's id is another object, or gone */
+    private sync;
+}
+//# sourceMappingURL=CubeNodeEditorState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeNodeEditorState.d.ts","sourceRoot":"","sources":["../../src/stores/CubeNodeEditorState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AASlE,OAAO,EACL,yBAAyB,EAE1B,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGhE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,YAAY,EACtB,GAAG,SAAS,EACZ,GAAG,SAAS,KACX,OAWF,CAAC;AAEF;;;;;;;;;GASG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IAEtC,2DAA2D;IAC3D,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,kDAAkD;IAClD,OAAO,CAAC,OAAO,CAAqB;IACpC,KAAK,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAE3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;gBAEpC,WAAW,EAAE,eAAe;IA0BxC,uDAAuD;IACvD,IAAI,IAAI,IAAI,SAAS,GAAG,SAAS,CAIhC;IAED,sDAAsD;IACtD,IAAI,MAAM,IAAI,SAAS,GAAG,SAAS,CAElC;IAED,iEAAiE;IACjE,IAAI,UAAU,IAAI,OAAO,CAOxB;IAED,6EAA6E;IAC7E,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAc1B;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAkBb,IAAI,aAAa,IAAI,OAAO,CAO3B;IAED;;;;OAIG;IACH,UAAU,IAAI,IAAI;IAclB,mFAAmF;IACnF,KAAK,IAAI,IAAI;IAKb,2CAA2C;IAC3C,MAAM,IAAI,IAAI;IAId;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,yBAAyB,GAAG,IAAI;IAQhD,aAAa,IAAI,IAAI;IAIrB,0DAA0D;IAC1D,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,KAAK;IAMb,4EAA4E;IAC5E,OAAO,CAAC,IAAI;CAiBb"}

package/lib/stores/CubeNodeEditorState.js

@@ -0,0 +1,207 @@
+/**
+ * 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 { action, computed, makeObservable, observable, reaction, } from 'mobx';
+import { CUBE_EDITOR_CLOSED_REASON, getEditorClosedNotice, } from '../__lib__/LegendCubeLabels.js';
+import { createCubeNodeDraft } from './editors/CubeNodeDraftRegistry.js';
+/**
+ * Whether two nodes of the same id save the same: their own fields, as the
+ * spec stores them, and the keys this version doesn't know. A node of a type
+ * the registry doesn't know is the same only as itself.
+ */
+export const isSameNodeContent = (registry, a, b) => {
+    if (a === b) {
+        return true;
+    }
+    const definition = registry.get(a.type);
+    return (definition !== undefined &&
+        a.type === b.type &&
+        JSON.stringify([definition.spec.encode(a), a.rest]) ===
+            JSON.stringify([definition.spec.encode(b), b.rest]));
+};
+/**
+ * The node editor in the side panel (PLAN §7.4, spec §17.5). Opening it
+ * never changes which node Execute runs. Edits go to a draft, and only Apply,
+ * or closing the panel, stores them, as one undo step; Cancel drops them.
+ *
+ * The panel follows the cube (user's choice, 2026-10-07): when the node it
+ * shows is replaced or removed underneath it, by Undo, a re-check or a
+ * Remove, a panel with edits closes without applying them and says so; one
+ * without edits shows the new node, or closes when the node is gone.
+ */
+export class CubeNodeEditorState {
+    editorState;
+    /** The id of the node the panel shows, while it is open */
+    nodeId;
+    /** The key of the node the draft was made from */
+    nodeKey;
+    draft;
+    /** Why the panel closed by itself, until it opens again or is dismissed */
+    notice;
+    disposeSync;
+    constructor(editorState) {
+        makeObservable(this, {
+            nodeId: observable,
+            nodeKey: observable,
+            draft: observable.ref,
+            notice: observable,
+            node: computed,
+            edited: computed,
+            hasChanges: computed,
+            open: action,
+            canSwapInputs: computed,
+            apply: action,
+            swapInputs: action,
+            close: action,
+            cancel: action,
+            discard: action,
+            dismissNotice: action,
+            sync: action,
+        });
+        this.editorState = editorState;
+        this.disposeSync = reaction(() => this.node, () => this.sync());
+    }
+    /** The node the panel shows, as the cube has it now */
+    get node() {
+        return this.nodeId === undefined
+            ? undefined
+            : this.editorState.document.query.getNode(this.nodeId);
+    }
+    /** The node Apply would store, built once per edit */
+    get edited() {
+        return this.draft?.build();
+    }
+    /** The draft saves differently from the node it was made from */
+    get hasChanges() {
+        const { draft, edited } = this;
+        return (draft !== undefined &&
+            edited !== undefined &&
+            !isSameNodeContent(this.editorState.registry, edited, draft.original));
+    }
+    /** Opens the panel on a node, closing (and so applying) the one it showed */
+    open(nodeId) {
+        if (nodeId === this.nodeId) {
+            this.notice = undefined;
+            return;
+        }
+        const node = this.editorState.document.query.getNode(nodeId);
+        if (!node) {
+            return;
+        }
+        this.close();
+        this.notice = undefined;
+        this.bind(node);
+    }
+    /**
+     * Stores the draft in place of the node, as one undo step, and goes on
+     * editing the stored node. Does nothing without changes, or while the cube
+     * is read-only.
+     */
+    apply() {
+        const { node, edited } = this;
+        if (!node ||
+            !edited ||
+            node.key !== this.nodeKey ||
+            !this.hasChanges ||
+            this.editorState.readOnly) {
+            return;
+        }
+        const { query } = this.editorState.document;
+        if (query.canReplace(edited)) {
+            this.editorState.applyQuery(query.replace(edited));
+            this.bind(edited);
+        }
+    }
+    get canSwapInputs() {
+        const { node } = this;
+        return (node !== undefined &&
+            !this.editorState.readOnly &&
+            this.editorState.document.query.canSwapInputs(node.id));
+    }
+    /**
+     * Swaps the node's two inputs (a Join's Swap Inputs, spec §17.6), applying
+     * the draft first, as one undo step, then goes on editing the swapped
+     * node, whose settings followed its inputs
+     */
+    swapInputs() {
+        const { node, edited } = this;
+        if (!node || !edited || node.key !== this.nodeKey || !this.canSwapInputs) {
+            return;
+        }
+        let { query } = this.editorState.document;
+        if (this.hasChanges && query.canReplace(edited)) {
+            query = query.replace(edited);
+        }
+        query = query.swapInputs(node.id);
+        this.editorState.applyQuery(query);
+        this.bind(query.getNode(node.id) ?? node);
+    }
+    /** Applies the draft, then closes the panel (spec §17.5: edits commit on close) */
+    close() {
+        this.apply();
+        this.reset();
+    }
+    /** Closes the panel, dropping the draft */
+    cancel() {
+        this.reset();
+    }
+    /**
+     * Closes the panel without applying the draft, e.g. when another cube is
+     * opened, saying so when that drops edits
+     */
+    discard(reason) {
+        const { nodeId } = this;
+        if (nodeId !== undefined && this.hasChanges) {
+            this.notice = getEditorClosedNotice(nodeId, reason);
+        }
+        this.reset();
+    }
+    dismissNotice() {
+        this.notice = undefined;
+    }
+    /** Stops following the cube; call when the page closes */
+    dispose() {
+        this.disposeSync();
+    }
+    bind(node) {
+        this.nodeId = node.id;
+        this.nodeKey = node.key;
+        this.draft = createCubeNodeDraft(node, this.editorState);
+    }
+    reset() {
+        this.nodeId = undefined;
+        this.nodeKey = undefined;
+        this.draft = undefined;
+    }
+    /** Runs whenever the node with the panel's id is another object, or gone */
+    sync() {
+        const { node } = this;
+        if (this.nodeId === undefined || node?.key === this.nodeKey) {
+            return;
+        }
+        if (this.hasChanges) {
+            this.discard(node
+                ? CUBE_EDITOR_CLOSED_REASON.NODE_CHANGED
+                : CUBE_EDITOR_CLOSED_REASON.NODE_REMOVED);
+        }
+        else if (node) {
+            this.bind(node);
+        }
+        else {
+            this.reset();
+        }
+    }
+}
+//# sourceMappingURL=CubeNodeEditorState.js.map

package/lib/stores/CubeNodeEditorState.js.map

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

package/lib/stores/CubeShowPureState.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 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 { GeneratorFn } from '@finos/legend-shared';
+import { CubeEngineError } from '../graph-manager/CubeEngine.js';
+import type { CubeEditorState } from './CubeEditorState.js';
+/**
+ * Show Pure: the Pure text of what Execute would run, the capture node's
+ * execution lambda with the row limit, as the engine renders it. For display
+ * only: the text is never parsed back (PLAN §8.7).
+ */
+export declare class CubeShowPureState {
+    readonly editorState: CubeEditorState;
+    isOpen: boolean;
+    text: string | undefined;
+    /** Why the engine couldn't render the query; shown in the dialog */
+    error: CubeEngineError | undefined;
+    isRendering: boolean;
+    /** Counts renders, so one that finishes after the dialog closed is dropped */
+    private request;
+    constructor(editorState: CubeEditorState);
+    /** Opens the dialog and renders the query; does nothing when Execute can't run */
+    open(): GeneratorFn<void>;
+    close(): void;
+}
+//# sourceMappingURL=CubeShowPureState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeShowPureState.d.ts","sourceRoot":"","sources":["../../src/stores/CubeShowPureState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EACL,eAAe,EAEhB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IAEtC,MAAM,UAAS;IACf,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,oEAAoE;IACpE,KAAK,EAAE,eAAe,GAAG,SAAS,CAAC;IACnC,WAAW,UAAS;IACpB,8EAA8E;IAC9E,OAAO,CAAC,OAAO,CAAK;gBAER,WAAW,EAAE,eAAe;IAYxC,kFAAkF;IACjF,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC;IAmC1B,KAAK,IAAI,IAAI;CAOd"}