@finos/legend-cube-builder 0.0.4 → 0.0.5

package/lib/stores/CubeLambdaImportState.d.ts

@@ -0,0 +1,118 @@
+/**
+ * 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 { CubeDocument, type IR } from '@finos/legend-cube';
+import { type GeneratorFn, type PlainObject } from '@finos/legend-shared';
+import type { CubeEditorState } from './CubeEditorState.js';
+/** A lambda a host opens the page on: its protocol JSON, and what to call it */
+export interface CubeInitialLambda {
+    readonly lambda: PlainObject;
+    /** What the page calls it, e.g. `materialized view TRADES_VIEW` */
+    readonly label: string;
+}
+/** Whether Cube writes the cube it read back as the lambda it read */
+export declare enum CubeLambdaFidelity {
+    /** The same Pure, so saving it changes nothing */
+    EXACT = "exact",
+    /** Pure that reads the same rows, written Cube's way */
+    REWRITTEN = "rewritten",
+    /**
+     * Not known: a step isn't valid, an expression couldn't be checked, or a
+     * step read with unknown columns is written another way
+     */
+    UNCHECKED = "unchecked"
+}
+export declare const CUBE_LAMBDA_IMPORT_MESSAGE: {
+    READING: (label: string) => string;
+    CANT_READ: (label: string) => string;
+    NOT_NEW: string;
+    REWRITTEN: (label: string) => string;
+    UNCHECKED: (label: string) => string;
+    GRID_LIMIT: string;
+    /** What the banner calls a lambda imported from the Import Pure dialog */
+    IMPORTED: string;
+    NOT_JSON: (reason: string) => string;
+};
+/** The source id the engine's grammar gives what Import Pure parses, so its errors name it */
+export declare const CUBE_IMPORT_PURE_SOURCE_ID = "cube:import-pure";
+export interface CubeLambdaImportError {
+    readonly message: string;
+    readonly detail?: string | undefined;
+}
+/** A lambda read into a cube: the cube, and what to compare it with once checked */
+export interface CubeLambdaReading {
+    readonly document: CubeDocument;
+    /** The lambda as read, which the cube is compared with */
+    readonly lambda: IR;
+    /** Whether it was a run's lambda, with `from()`, rather than a matview's relation */
+    readonly isRun: boolean;
+    /**
+     * The steps read without being checked, as the columns before them weren't
+     * known: read as Cube writes them, so the cube can't be vouched for unless
+     * it is written back the same
+     */
+    readonly unchecked: readonly string[];
+    readonly notes: readonly string[];
+}
+/**
+ * A lambda's protocol JSON read into a cube on the editor's host: its sources
+ * bound, its steps read, its expressions given their code. Throws a
+ * `CubeLambdaReadError`, or the engine's error, naming what can't be read.
+ */
+export declare const readCubeLambdaDocument: (editorState: CubeEditorState, json: unknown) => Promise<CubeLambdaReading>;
+/**
+ * Whether the cube, written again as the lambda was written (a matview's
+ * relation, or a run with no row limit), is the lambda it was read from.
+ * Written another way, it reads the same rows only when every step was
+ * checked as it was read: a step read with unknown columns, e.g. a select
+ * taken for the one a Join writes, may not.
+ */
+export declare const getCubeLambdaFidelity: (editorState: CubeEditorState, reading: Pick<CubeLambdaReading, "lambda" | "isRun" | "unchecked">) => CubeLambdaFidelity;
+/**
+ * Opens the page on a host's lambda (`CubeEditor`'s `initialLambda`): read
+ * into a cube, opened as the first one, with no undo step; a lambda that
+ * can't be read leaves the cube empty and says why. Once the cube's
+ * expressions are checked, whether Cube writes it back the same way.
+ */
+export declare class CubeLambdaImportState {
+    readonly editorState: CubeEditorState;
+    /** What the page calls the lambda it opened on */
+    label: string | undefined;
+    isReading: boolean;
+    error: CubeLambdaImportError | undefined;
+    /** Whether Cube writes the cube back as the lambda; none until checked */
+    fidelity: CubeLambdaFidelity | undefined;
+    notes: readonly string[];
+    /** Import Pure, from the Cube menu: the dialog, its text, why its last import failed */
+    isDialogOpen: boolean;
+    text: string;
+    isImporting: boolean;
+    dialogError: CubeLambdaImportError | undefined;
+    constructor(editorState: CubeEditorState);
+    open(initial: CubeInitialLambda): GeneratorFn<void>;
+    openDialog(): void;
+    closeDialog(): void;
+    setText(text: string): void;
+    /**
+     * Import Pure (PLAN §11.18): the dialog's text, Pure or the engine's JSON
+     * of a lambda, read into a cube that replaces this one, as one undo step;
+     * then, once checked, whether Cube writes it back the same. A lambda that
+     * can't be read leaves the cube as it was, and says why in the dialog.
+     */
+    importText(): GeneratorFn<void>;
+    /** Closes the banner */
+    dismiss(): void;
+}
+//# sourceMappingURL=CubeLambdaImportState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeLambdaImportState.d.ts","sourceRoot":"","sources":["../../src/stores/CubeLambdaImportState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,YAAY,EAaZ,KAAK,EAAE,EAGR,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAO9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAS5D,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,sEAAsE;AACtE,oBAAY,kBAAkB;IAC5B,kDAAkD;IAClD,KAAK,UAAU;IACf,wDAAwD;IACxD,SAAS,cAAc;IACvB;;;OAGG;IACH,SAAS,cAAc;CACxB;AAED,eAAO,MAAM,0BAA0B;qBACpB,MAAM,KAAG,MAAM;uBACb,MAAM,KAAG,MAAM;;uBAEf,MAAM,KAAG,MAAM;uBAEf,MAAM,KAAG,MAAM;;IAIlC,0EAA0E;;uBAEvD,MAAM,KAAG,MAAM;CACnC,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAaD,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;IACpB,qFAAqF;IACrF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AA4ED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,aAAa,eAAe,EAC5B,MAAM,OAAO,KACZ,OAAO,CAAC,iBAAiB,CA8B3B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,aAAa,eAAe,EAC5B,SAAS,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC,KACjE,kBAqBF,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,qBAAqB;IAChC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,kDAAkD;IAClD,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,UAAS;IAClB,KAAK,EAAE,qBAAqB,GAAG,SAAS,CAAC;IACzC,0EAA0E;IAC1E,QAAQ,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACzC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAM;IAC9B,wFAAwF;IACxF,YAAY,UAAS;IACrB,IAAI,SAAM;IACV,WAAW,UAAS;IACpB,WAAW,EAAE,qBAAqB,GAAG,SAAS,CAAC;gBAEnC,WAAW,EAAE,eAAe;IAqBvC,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,WAAW,CAAC,IAAI,CAAC;IAiCpD,UAAU,IAAI,IAAI;IAKlB,WAAW,IAAI,IAAI;IAKnB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B;;;;;OAKG;IACF,UAAU,IAAI,WAAW,CAAC,IAAI,CAAC;IA2DhC,wBAAwB;IACxB,OAAO,IAAI,IAAI;CAKhB"}

package/lib/stores/CubeLambdaImportState.js

@@ -0,0 +1,302 @@
+/**
+ * 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 { CubeDocument, CubeLambdaReadError, ExpressionFilter, Extend, findCubeLambdaExtends, findCubeLambdaSources, isSameCubeIR, lambda, QueryEmitter, readCubeQuery, splitCubeLambda, Schema, } from '@finos/legend-cube';
+import { assertErrorThrown, parseLosslessJSON, } from '@finos/legend-shared';
+import { action, flow, makeObservable, observable, when } from 'mobx';
+import { CubeEngineError } from '../graph-manager/CubeEngine.js';
+import { CUBE_EXPRESSION_CODEC, readCubeLambdaJson, } from '../graph-manager/protocol/pure/CubeEngineBuilder.js';
+import { bindCubeLambdaSources } from './CubeLambdaSources.js';
+/** Whether Cube writes the cube it read back as the lambda it read */
+export var CubeLambdaFidelity;
+(function (CubeLambdaFidelity) {
+    /** The same Pure, so saving it changes nothing */
+    CubeLambdaFidelity["EXACT"] = "exact";
+    /** Pure that reads the same rows, written Cube's way */
+    CubeLambdaFidelity["REWRITTEN"] = "rewritten";
+    /**
+     * Not known: a step isn't valid, an expression couldn't be checked, or a
+     * step read with unknown columns is written another way
+     */
+    CubeLambdaFidelity["UNCHECKED"] = "unchecked";
+})(CubeLambdaFidelity || (CubeLambdaFidelity = {}));
+export const CUBE_LAMBDA_IMPORT_MESSAGE = {
+    READING: (label) => `Reading ${label}…`,
+    CANT_READ: (label) => `Cube can't read ${label}`,
+    NOT_NEW: 'Cube opens a lambda on a new cube only.',
+    REWRITTEN: (label) => `Cube writes ${label} another way, which reads the same rows: what Cube shows and saves is its own Pure.`,
+    UNCHECKED: (label) => `Cube couldn't check that its steps read the same rows as ${label}: review them.`,
+    GRID_LIMIT: "The limit beside from() is read as a Limit step: it may be the grid's row limit of the run the Pure was copied from.",
+    /** What the banner calls a lambda imported from the Import Pure dialog */
+    IMPORTED: 'the Pure imported',
+    NOT_JSON: (reason) => `Can't read the JSON: ${reason}`,
+};
+/** The source id the engine's grammar gives what Import Pure parses, so its errors name it */
+export const CUBE_IMPORT_PURE_SOURCE_ID = 'cube:import-pure';
+const toImportError = (error) => {
+    if (error instanceof CubeEngineError) {
+        return {
+            message: error.firstLine,
+            detail: error.detail !== error.firstLine ? error.detail : undefined,
+        };
+    }
+    assertErrorThrown(error);
+    return { message: error.message };
+};
+/** The engine's grammar of an expression's lambda, as the editor shows it */
+const codeOf = async (editorState, expression) => (await editorState.host.engine.renderPure(CUBE_EXPRESSION_CODEC.read(expression))).trim();
+/** Each Filter by Expression's and Extend column's code, the engine's grammar of its lambda */
+const withExpressionCode = async (editorState, query) => {
+    let next = query;
+    for (const node of query.nodes) {
+        if (node instanceof ExpressionFilter && node.lambda && !node.code) {
+            next = next.replace(node.withCondition(await codeOf(editorState, node.lambda), node.lambda));
+        }
+        else if (node instanceof Extend) {
+            const columns = [];
+            for (const column of node.columns) {
+                columns.push(column.lambda && !column.code
+                    ? { ...column, code: await codeOf(editorState, column.lambda) }
+                    : column);
+            }
+            next = next.replace(node.withColumns(columns));
+        }
+    }
+    return next;
+};
+/**
+ * The schema of each chain of extends of the lambda, typed by the engine in
+ * one call before the steps are read, so the steps after an Extend can be
+ * checked; none when the engine can't type them, as then the editor will
+ * say why
+ */
+const typeExtends = async (editorState, context, chains) => {
+    const schemas = new Map();
+    if (!chains.length) {
+        return schemas;
+    }
+    try {
+        const typed = await editorState.host.engine.typeLambdas(context.model, new Map(chains.map(({ typed: relation }, index) => [
+            `extend${index}`,
+            lambda([], [relation]),
+        ])));
+        chains.forEach(({ read }, index) => {
+            const schema = typed.get(`extend${index}`);
+            if (schema instanceof Schema) {
+                schemas.set(read, schema);
+            }
+        });
+    }
+    catch {
+        // typed again by the editor, which says why it can't
+    }
+    return schemas;
+};
+/**
+ * A lambda's protocol JSON read into a cube on the editor's host: its sources
+ * bound, its steps read, its expressions given their code. Throws a
+ * `CubeLambdaReadError`, or the engine's error, naming what can't be read.
+ */
+export const readCubeLambdaDocument = async (editorState, json) => {
+    const read = readCubeLambdaJson(json);
+    const parts = splitCubeLambda(read);
+    const binding = await bindCubeLambdaSources(editorState, findCubeLambdaSources(parts));
+    const { query, unchecked } = readCubeQuery(parts, {
+        bindSource: binding.bindSource,
+        expressions: CUBE_EXPRESSION_CODEC,
+        relationSchemas: await typeExtends(editorState, binding.context, findCubeLambdaExtends(parts)),
+        registry: editorState.registry,
+    });
+    return {
+        document: new CubeDocument({
+            context: {
+                ...binding.context,
+                ...(parts.runtime !== undefined ? { runtime: parts.runtime } : {}),
+            },
+            query: await withExpressionCode(editorState, query),
+        }),
+        lambda: read,
+        isRun: parts.runtime !== undefined,
+        unchecked,
+        notes: parts.limitBesideFrom ? [CUBE_LAMBDA_IMPORT_MESSAGE.GRID_LIMIT] : [],
+    };
+};
+/**
+ * Whether the cube, written again as the lambda was written (a matview's
+ * relation, or a run with no row limit), is the lambda it was read from.
+ * Written another way, it reads the same rows only when every step was
+ * checked as it was read: a step read with unknown columns, e.g. a select
+ * taken for the one a Join writes, may not.
+ */
+export const getCubeLambdaFidelity = (editorState, reading) => {
+    const { query, context } = editorState.document;
+    const selected = query.selected;
+    const emitter = new QueryEmitter(query, editorState.registry);
+    if (selected === undefined || !emitter.canEmit(selected)) {
+        return CubeLambdaFidelity.UNCHECKED;
+    }
+    const written = reading.isRun && context?.runtime !== undefined
+        ? emitter.emitExecutionLambda({ runtime: context.runtime })
+        : lambda([], [emitter.emitRelation(selected, { withRowOrder: true })]);
+    if (isSameCubeIR(written, reading.lambda, {
+        readExpression: CUBE_EXPRESSION_CODEC.read,
+    })) {
+        return CubeLambdaFidelity.EXACT;
+    }
+    return reading.unchecked.length
+        ? CubeLambdaFidelity.UNCHECKED
+        : CubeLambdaFidelity.REWRITTEN;
+};
+/**
+ * Opens the page on a host's lambda (`CubeEditor`'s `initialLambda`): read
+ * into a cube, opened as the first one, with no undo step; a lambda that
+ * can't be read leaves the cube empty and says why. Once the cube's
+ * expressions are checked, whether Cube writes it back the same way.
+ */
+export class CubeLambdaImportState {
+    editorState;
+    /** What the page calls the lambda it opened on */
+    label;
+    isReading = false;
+    error;
+    /** Whether Cube writes the cube back as the lambda; none until checked */
+    fidelity;
+    notes = [];
+    /** Import Pure, from the Cube menu: the dialog, its text, why its last import failed */
+    isDialogOpen = false;
+    text = '';
+    isImporting = false;
+    dialogError;
+    constructor(editorState) {
+        makeObservable(this, {
+            label: observable,
+            isReading: observable,
+            error: observable.ref,
+            fidelity: observable,
+            notes: observable.ref,
+            isDialogOpen: observable,
+            text: observable,
+            isImporting: observable,
+            dialogError: observable.ref,
+            open: flow,
+            dismiss: action,
+            openDialog: action,
+            closeDialog: action,
+            setText: action,
+            importText: flow,
+        });
+        this.editorState = editorState;
+    }
+    *open(initial) {
+        const { editorState } = this;
+        this.label = initial.label;
+        this.isReading = true;
+        this.error = undefined;
+        this.fidelity = undefined;
+        try {
+            const reading = (yield readCubeLambdaDocument(editorState, initial.lambda));
+            // the user may have started a cube while it was read
+            if (!editorState.isEmptyCube) {
+                throw new CubeLambdaReadError(CUBE_LAMBDA_IMPORT_MESSAGE.NOT_NEW);
+            }
+            editorState.openDocument(reading.document);
+            this.notes = reading.notes;
+            this.isReading = false;
+            // checked as the editor checks any expression: then compared
+            yield when(() => !editorState.isResolvingSources &&
+                !editorState.isCheckingExpressions &&
+                !editorState.nodesToCheck.length);
+            this.fidelity = getCubeLambdaFidelity(editorState, reading);
+        }
+        catch (error) {
+            this.error = toImportError(error);
+        }
+        finally {
+            this.isReading = false;
+        }
+    }
+    openDialog() {
+        this.isDialogOpen = true;
+        this.dialogError = undefined;
+    }
+    closeDialog() {
+        this.isDialogOpen = false;
+        this.isImporting = false;
+    }
+    setText(text) {
+        this.text = text;
+        this.dialogError = undefined;
+    }
+    /**
+     * Import Pure (PLAN §11.18): the dialog's text, Pure or the engine's JSON
+     * of a lambda, read into a cube that replaces this one, as one undo step;
+     * then, once checked, whether Cube writes it back the same. A lambda that
+     * can't be read leaves the cube as it was, and says why in the dialog.
+     */
+    *importText() {
+        const { editorState } = this;
+        const text = this.text.trim();
+        if (!text || this.isImporting) {
+            return;
+        }
+        this.isImporting = true;
+        this.dialogError = undefined;
+        try {
+            let json;
+            if (text.startsWith('{')) {
+                try {
+                    json = parseLosslessJSON(text);
+                }
+                catch (error) {
+                    assertErrorThrown(error);
+                    throw new CubeLambdaReadError(CUBE_LAMBDA_IMPORT_MESSAGE.NOT_JSON(error.message));
+                }
+            }
+            else {
+                json = (yield editorState.host.engine.parseExpression(text, CUBE_IMPORT_PURE_SOURCE_ID)).lambda;
+            }
+            const reading = (yield readCubeLambdaDocument(editorState, json));
+            if (!this.isDialogOpen) {
+                // closed while it was read
+                return;
+            }
+            editorState.importDocument(reading.document, false);
+            this.isDialogOpen = false;
+            this.text = '';
+            this.label = CUBE_LAMBDA_IMPORT_MESSAGE.IMPORTED;
+            this.error = undefined;
+            this.fidelity = undefined;
+            this.notes = reading.notes;
+            this.isImporting = false;
+            yield when(() => !editorState.isResolvingSources &&
+                !editorState.isCheckingExpressions &&
+                !editorState.nodesToCheck.length);
+            this.fidelity = getCubeLambdaFidelity(editorState, reading);
+        }
+        catch (error) {
+            this.dialogError = toImportError(error);
+        }
+        finally {
+            this.isImporting = false;
+        }
+    }
+    /** Closes the banner */
+    dismiss() {
+        this.error = undefined;
+        this.fidelity = undefined;
+        this.notes = [];
+    }
+}
+//# sourceMappingURL=CubeLambdaImportState.js.map

package/lib/stores/CubeLambdaImportState.js.map

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

package/lib/stores/CubeLambdaSources.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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 CubeContext, type CubeSourceStep, type IR } from '@finos/legend-cube';
+import type { CubeEditorState } from './CubeEditorState.js';
+export declare const CUBE_LAMBDA_SOURCES_MESSAGE: {
+    NONE: string;
+    MIXED: string;
+    NOT_YET: string;
+    NO_INGEST: string;
+    NO_DATA_PRODUCTS: string;
+    INGEST_SETTINGS: string;
+    NO_DEFINITION: (definition: string) => string;
+    NO_DATA_SET: (dataSet: string, definition: string) => string;
+    DATA_SET_UNREADABLE: (dataSet: string, definition: string, reason: string) => string;
+    NO_DATA_PRODUCT: (dataProduct: string) => string;
+    DATA_PRODUCTS: (dataProduct: string) => string;
+    NO_ACCESS_POINT: (accessPoint: string, dataProduct: string) => string;
+    ACCESS_POINT_UNREADABLE: (accessPoint: string, dataProduct: string, reason: string) => string;
+    TABLE_MODEL: string;
+};
+/** What the lambda's sources bind to: the cube's model and runtime, and the step of each */
+export interface CubeLambdaBinding {
+    readonly context: CubeContext;
+    readonly bindSource: (source: IR) => CubeSourceStep;
+}
+/**
+ * The cube's model and runtime and the step of each source, for a lambda's
+ * sources, all of one kind (PLAN §11.18). Throws a `CubeLambdaReadError` that
+ * names a source Cube can't bind, or what to add first.
+ */
+export declare const bindCubeLambdaSources: (editorState: CubeEditorState, sources: readonly IR[]) => Promise<CubeLambdaBinding>;
+//# sourceMappingURL=CubeLambdaSources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeLambdaSources.d.ts","sourceRoot":"","sources":["../../src/stores/CubeLambdaSources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EASL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,EAAE,EACR,MAAM,oBAAoB,CAAC;AAe5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAQ5D,eAAO,MAAM,2BAA2B;;;;;;;gCASV,MAAM,KAAG,MAAM;2BAEpB,MAAM,cAAc,MAAM,KAAG,MAAM;mCAG/C,MAAM,cACH,MAAM,UACV,MAAM,KACb,MAAM;mCACsB,MAAM,KAAG,MAAM;iCAEjB,MAAM,KAAG,MAAM;mCAEb,MAAM,eAAe,MAAM,KAAG,MAAM;2CAGpD,MAAM,eACN,MAAM,UACX,MAAM,KACb,MAAM;;CAGV,CAAC;AAEF,4FAA4F;AAC5F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,KAAK,cAAc,CAAC;CACrD;AAmRD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,aAAa,eAAe,EAC5B,SAAS,SAAS,EAAE,EAAE,KACrB,OAAO,CAAC,iBAAiB,CAkB3B,CAAC"}