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

package/lib/stores/CubeSpecTransferState.js

@@ -0,0 +1,167 @@
+/**
+ * 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 { CubeSpecDecodeError, MAX_SPEC_BYTES, parseCubeSpec, serializeCubeSpec, } from '@finos/legend-cube';
+import { ContentType, downloadFileUsingDataURI, readFileAsText, } from '@finos/legend-shared';
+import { action, flow, makeObservable, observable } from 'mobx';
+export var CUBE_SPEC_TRANSFER_MODE;
+(function (CUBE_SPEC_TRANSFER_MODE) {
+    CUBE_SPEC_TRANSFER_MODE["EXPORT"] = "export";
+    CUBE_SPEC_TRANSFER_MODE["IMPORT"] = "import";
+})(CUBE_SPEC_TRANSFER_MODE || (CUBE_SPEC_TRANSFER_MODE = {}));
+const errorMessage = (error) => error instanceof Error ? error.message : String(error);
+/** Why a spec can't be imported; a broken document names the path of the problem */
+export const getSpecImportError = (error) => error instanceof CubeSpecDecodeError
+    ? error.path
+        ? `Can't import the spec: ${error.path} ${error.detail}`
+        : `Can't import the spec: it ${error.detail}`
+    : `Can't import the spec: ${errorMessage(error)}`;
+/** A file name for a cube's spec, from its name */
+export const getCubeSpecFileName = (name) => {
+    const base = name?.trim().replace(/[^\w.-]+/gu, '_') ?? '';
+    return `${base.length ? base : 'cube'}.cube.json`;
+};
+/**
+ * Export and import of the saved spec (PLAN §10.3), the only way to keep a
+ * cube until the Cube store (M8). Both are developer tools for now, labelled
+ * "(dev)" (Settled before M1.8).
+ */
+export class CubeSpecTransferState {
+    editorState;
+    mode;
+    /** The spec to export, once written */
+    exportText;
+    /** The spec text to import, pasted or read from a file */
+    importText = '';
+    /** Why the export or the import failed */
+    error;
+    isReadingFile = false;
+    /** Counts file reads, so a read that finishes after another starts is dropped */
+    fileRequest = 0;
+    constructor(editorState) {
+        makeObservable(this, {
+            mode: observable,
+            exportText: observable,
+            importText: observable,
+            error: observable,
+            isReadingFile: observable,
+            fileRequest: observable,
+            openExport: action,
+            openImport: action,
+            close: action,
+            setImportText: action,
+            importSpec: action,
+            readImportFile: flow,
+        });
+        this.editorState = editorState;
+    }
+    /** Writes the cube's spec, invalid queries included; a spec over the size cap is refused */
+    openExport() {
+        this.mode = CUBE_SPEC_TRANSFER_MODE.EXPORT;
+        this.error = undefined;
+        this.exportText = undefined;
+        const { document, registry } = this.editorState;
+        try {
+            this.exportText = serializeCubeSpec(document, registry);
+        }
+        catch (error) {
+            this.error = errorMessage(error);
+        }
+    }
+    openImport() {
+        this.mode = CUBE_SPEC_TRANSFER_MODE.IMPORT;
+        this.error = undefined;
+        this.importText = '';
+        this.isReadingFile = false;
+    }
+    close() {
+        this.mode = undefined;
+        this.exportText = undefined;
+        this.importText = '';
+        this.error = undefined;
+        this.fileRequest++;
+        this.isReadingFile = false;
+    }
+    setImportText(text) {
+        this.importText = text;
+        this.error = undefined;
+    }
+    async copyExport() {
+        if (this.exportText !== undefined) {
+            await this.editorState.host.applicationStore.clipboardService.copyTextToClipboard(this.exportText, { notifySuccessMessage: 'Cube spec copied to the clipboard' });
+        }
+    }
+    downloadExport() {
+        if (this.exportText !== undefined) {
+            downloadFileUsingDataURI(getCubeSpecFileName(this.editorState.document.name), this.exportText, ContentType.APPLICATION_JSON);
+        }
+    }
+    /** Reads a spec file into the import text; a file over the size cap is refused unread */
+    *readImportFile(file) {
+        const request = ++this.fileRequest;
+        this.error = undefined;
+        if (file.size > MAX_SPEC_BYTES) {
+            // a file being read before this one is dropped
+            this.isReadingFile = false;
+            this.error = `The file is too large to import: a spec is at most ${MAX_SPEC_BYTES} bytes`;
+            return;
+        }
+        this.isReadingFile = true;
+        try {
+            const text = (yield readFileAsText(file));
+            if (request === this.fileRequest) {
+                this.importText = text;
+            }
+        }
+        catch (error) {
+            if (request === this.fileRequest) {
+                // the browser's FileReader rejects with its error event, not an Error
+                const reason = error instanceof Error
+                    ? error.message
+                    : error instanceof ProgressEvent &&
+                        error.target instanceof FileReader
+                        ? (error.target.error?.message ?? 'the browser could not read it')
+                        : String(error);
+                this.error = `Can't read the file: ${reason}`;
+            }
+        }
+        finally {
+            if (request === this.fileRequest) {
+                this.isReadingFile = false;
+            }
+        }
+    }
+    /**
+     * Opens the spec in place of the cube, as one undo step, and never runs it.
+     * A spec that can't be read leaves the cube as it was and says why: a
+     * broken document names the path of the problem, e.g. `query.nodes[2].database`.
+     */
+    importSpec() {
+        let decoded;
+        try {
+            decoded = parseCubeSpec(this.importText, {
+                registry: this.editorState.registry,
+            });
+        }
+        catch (error) {
+            this.error = getSpecImportError(error);
+            return false;
+        }
+        this.editorState.importDocument(decoded.document, decoded.readOnly);
+        this.close();
+        return true;
+    }
+}
+//# sourceMappingURL=CubeSpecTransferState.js.map

package/lib/stores/CubeSpecTransferState.js.map

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

package/lib/stores/LocalModelCatalog.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 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 { ModelContext } from '@finos/legend-cube';
+import type { CubeEngine, CubeModelOutline } from '../graph-manager/CubeEngine.js';
+export interface BundledModel {
+    readonly id: string;
+    readonly label: string;
+    readonly model: ModelContext;
+}
+export declare const BUNDLED_MODELS: readonly BundledModel[];
+/** The model context of pasted Pure text */
+export declare const createTextModel: (code: string) => ModelContext;
+/**
+ * Loads the outlines of models through the engine port, each model's once:
+ * the picker asks again whenever it opens
+ */
+export declare class LocalModelCatalog {
+    readonly models: readonly BundledModel[];
+    private readonly engine;
+    private readonly outlines;
+    constructor(engine: CubeEngine);
+    loadOutline(model: ModelContext): Promise<CubeModelOutline>;
+}
+//# sourceMappingURL=LocalModelCatalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LocalModelCatalog.d.ts","sourceRoot":"","sources":["../../src/stores/LocalModelCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EACjB,MAAM,gCAAgC,CAAC;AAOxC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAMhD,CAAC;AAEH,4CAA4C;AAC5C,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,YACP,CAAC;AAEzC;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,MAAM,0BAAkB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgD;gBAE7D,MAAM,EAAE,UAAU;IAI9B,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAW5D"}

package/lib/stores/LocalModelCatalog.js

@@ -0,0 +1,49 @@
+/**
+ * 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 { CUBE_NORTHWIND_MODEL } from './fixtures/CubeNorthwindModel.js';
+export const BUNDLED_MODELS = Object.freeze([
+    {
+        id: 'cube-northwind',
+        label: 'Northwind (Cube fixture)',
+        model: CUBE_NORTHWIND_MODEL,
+    },
+]);
+/** The model context of pasted Pure text */
+export const createTextModel = (code) => Object.freeze({ _type: 'text', code });
+/**
+ * Loads the outlines of models through the engine port, each model's once:
+ * the picker asks again whenever it opens
+ */
+export class LocalModelCatalog {
+    models = BUNDLED_MODELS;
+    engine;
+    outlines = new Map();
+    constructor(engine) {
+        this.engine = engine;
+    }
+    loadOutline(model) {
+        const key = JSON.stringify(model);
+        let outline = this.outlines.get(key);
+        if (!outline) {
+            outline = this.engine.loadModel(model);
+            // a failed load is tried again next time
+            outline.catch(() => this.outlines.delete(key));
+            this.outlines.set(key, outline);
+        }
+        return outline;
+    }
+}
+//# sourceMappingURL=LocalModelCatalog.js.map

package/lib/stores/LocalModelCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalModelCatalog.js","sourceRoot":"","sources":["../../src/stores/LocalModelCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAYxE,MAAM,CAAC,MAAM,cAAc,GAA4B,MAAM,CAAC,MAAM,CAAC;IACnE;QACE,EAAE,EAAE,gBAAgB;QACpB,KAAK,EAAE,0BAA0B;QACjC,KAAK,EAAE,oBAAoB;KAC5B;CACF,CAAC,CAAC;AAEH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAgB,EAAE,CAC5D,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAEzC;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IACnB,MAAM,GAAG,cAAc,CAAC;IAChB,MAAM,CAAa;IACnB,QAAQ,GAAG,IAAI,GAAG,EAAqC,CAAC;IAEzE,YAAY,MAAkB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,WAAW,CAAC,KAAmB;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACvC,yCAAyC;YACzC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/lib/stores/editors/CubeFilterDraft.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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 { CompositeFilter, CompositeFilterOperator, type Filter, type FilterOperator, type FilterRule, type FilterValue, type Schema } from '@finos/legend-cube';
+import { CubeNodeDraft } from './CubeNodeDraft.js';
+/** A condition with no column picked and no value: what Add puts in a group */
+export declare const isBlankFilterRow: (rule: FilterRule) => boolean;
+/**
+ * The rule without its blank conditions, and without the groups and
+ * negations left empty by that; `undefined` when nothing else is left
+ */
+export declare const pruneBlankFilterRows: (rule: FilterRule) => FilterRule | undefined;
+/**
+ * The Filter editor's draft (spec §8.5, §17.6): the filter as a tree that
+ * always has an And/Or group at its top, so rows can be added to it. Each
+ * rule keeps its key across edits, so the editor's rows keep theirs.
+ *
+ * When built, blank conditions are left out, and a tree of nothing else
+ * stores no filter at all (user's choice, 2026-10-07): an Apply with an
+ * untouched blank row changes nothing. Rules this version can't read are
+ * kept as they were.
+ */
+export declare class CubeFilterDraft extends CubeNodeDraft<Filter> {
+    tree: CompositeFilter;
+    /** Anything was changed; until then, `build()` gives the original back */
+    private touched;
+    constructor(original: Filter);
+    private update;
+    setGroupOperator(groupKey: number, operator: CompositeFilterOperator): void;
+    /** Adds a blank condition at the end of the group */
+    addCondition(groupKey: number): void;
+    /** Adds a group holding one blank condition at the end of the group */
+    addGroup(groupKey: number): void;
+    /** Removes a rule; the top group stays */
+    removeRule(key: number): void;
+    /**
+     * Negates a rule as simply as it can (`negateFilter`): a comparison takes
+     * its negated operator, e.g. `is` and `is not`, a negation gives back its
+     * rule, anything else is wrapped in Not. The top group can't be negated.
+     */
+    toggleNegation(key: number): void;
+    /** Changes a condition's column, keeping its operator and value when they still fit */
+    setColumn(key: number, columnName: string, schema: Schema): void;
+    /** Changes a condition's operator, dropping its value when the operator takes another shape */
+    setOperator(key: number, operator: FilterOperator): void;
+    setValue(key: number, value: FilterValue | undefined): void;
+    build(): Filter;
+}
+//# sourceMappingURL=CubeFilterDraft.d.ts.map

package/lib/stores/editors/CubeFilterDraft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeFilterDraft.d.ts","sourceRoot":"","sources":["../../../src/stores/editors/CubeFilterDraft.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAIL,eAAe,EACf,uBAAuB,EAEvB,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,EAIhB,KAAK,MAAM,EAEZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,GAAI,MAAM,UAAU,KAAG,OAG1B,CAAC;AAE3B;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,UAAU,KACf,UAAU,GAAG,SAyBf,CAAC;AAqCF;;;;;;;;;GASG;AACH,qBAAa,eAAgB,SAAQ,aAAa,CAAC,MAAM,CAAC;IACxD,IAAI,EAAE,eAAe,CAAC;IACtB,0EAA0E;IAC1E,OAAO,CAAC,OAAO,CAAS;gBAEZ,QAAQ,EAAE,MAAM;IAiB5B,OAAO,CAAC,MAAM;IAYd,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,uBAAuB,GAAG,IAAI;IAM3E,qDAAqD;IACrD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQpC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAWhC,0CAA0C;IAC1C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAM7B;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMjC,uFAAuF;IACvF,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQhE,+FAA+F;IAC/F,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI;IAQxD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI;IAM3D,KAAK,IAAI,MAAM;CAiBhB"}

package/lib/stores/editors/CubeFilterDraft.js

@@ -0,0 +1,186 @@
+/**
+ * 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 { changeFilterColumn, changeFilterOperator, ColumnComparisonFilter, CompositeFilter, CompositeFilterOperator, encodeFilterRule, negateFilter, normalizeFilter, NotFilter, unwrapFilter, } from '@finos/legend-cube';
+import { action, makeObservable, observable } from 'mobx';
+import { CubeNodeDraft } from './CubeNodeDraft.js';
+/** A condition with no column picked and no value: what Add puts in a group */
+export const isBlankFilterRow = (rule) => rule instanceof ColumnComparisonFilter &&
+    rule.columnName === '' &&
+    rule.value === undefined;
+/**
+ * The rule without its blank conditions, and without the groups and
+ * negations left empty by that; `undefined` when nothing else is left
+ */
+export const pruneBlankFilterRows = (rule) => {
+    if (isBlankFilterRow(rule)) {
+        return undefined;
+    }
+    if (rule instanceof CompositeFilter) {
+        const rules = rule.rules
+            .map(pruneBlankFilterRows)
+            .filter((child) => child !== undefined);
+        if (!rules.length) {
+            return undefined;
+        }
+        return rules.length === rule.rules.length &&
+            rules.every((child, index) => child === rule.rules[index])
+            ? rule
+            : rule.withRules(rules);
+    }
+    if (rule instanceof NotFilter) {
+        const inner = pruneBlankFilterRows(rule.rule);
+        return inner === undefined
+            ? undefined
+            : inner === rule.rule
+                ? rule
+                : rule.withRule(inner);
+    }
+    return rule;
+};
+/**
+ * The tree with the rule of `key` replaced by what `replace` gives, or
+ * removed when it gives `undefined`; a negation whose rule is removed goes
+ * too. Rules that don't change stay the same objects.
+ */
+const replaceRule = (rule, key, replace) => {
+    if (rule.key === key) {
+        return replace(rule);
+    }
+    if (rule instanceof CompositeFilter) {
+        const rules = rule.rules
+            .map((child) => replaceRule(child, key, replace))
+            .filter((child) => child !== undefined);
+        return rules.length === rule.rules.length &&
+            rules.every((child, index) => child === rule.rules[index])
+            ? rule
+            : rule.withRules(rules);
+    }
+    if (rule instanceof NotFilter) {
+        const inner = replaceRule(rule.rule, key, replace);
+        return inner === undefined
+            ? undefined
+            : inner === rule.rule
+                ? rule
+                : rule.withRule(inner);
+    }
+    return rule;
+};
+const blankRow = () => new ColumnComparisonFilter('');
+/**
+ * The Filter editor's draft (spec §8.5, §17.6): the filter as a tree that
+ * always has an And/Or group at its top, so rows can be added to it. Each
+ * rule keeps its key across edits, so the editor's rows keep theirs.
+ *
+ * When built, blank conditions are left out, and a tree of nothing else
+ * stores no filter at all (user's choice, 2026-10-07): an Apply with an
+ * untouched blank row changes nothing. Rules this version can't read are
+ * kept as they were.
+ */
+export class CubeFilterDraft extends CubeNodeDraft {
+    tree;
+    /** Anything was changed; until then, `build()` gives the original back */
+    touched = false;
+    constructor(original) {
+        super(original);
+        makeObservable(this, {
+            tree: observable.ref,
+            touched: observable,
+            setGroupOperator: action,
+            addCondition: action,
+            addGroup: action,
+            removeRule: action,
+            toggleNegation: action,
+            setColumn: action,
+            setOperator: action,
+            setValue: action,
+        });
+        this.tree = normalizeFilter(original.filter);
+    }
+    update(key, replace) {
+        const tree = replaceRule(this.tree, key, replace);
+        // the top group stays a group
+        if (tree instanceof CompositeFilter && tree !== this.tree) {
+            this.tree = tree;
+            this.touched = true;
+        }
+    }
+    setGroupOperator(groupKey, operator) {
+        this.update(groupKey, (rule) => rule instanceof CompositeFilter ? rule.withOperator(operator) : rule);
+    }
+    /** Adds a blank condition at the end of the group */
+    addCondition(groupKey) {
+        this.update(groupKey, (rule) => rule instanceof CompositeFilter
+            ? rule.withRules([...rule.rules, blankRow()])
+            : rule);
+    }
+    /** Adds a group holding one blank condition at the end of the group */
+    addGroup(groupKey) {
+        this.update(groupKey, (rule) => rule instanceof CompositeFilter
+            ? rule.withRules([
+                ...rule.rules,
+                new CompositeFilter(CompositeFilterOperator.AND, [blankRow()]),
+            ])
+            : rule);
+    }
+    /** Removes a rule; the top group stays */
+    removeRule(key) {
+        if (key !== this.tree.key) {
+            this.update(key, () => undefined);
+        }
+    }
+    /**
+     * Negates a rule as simply as it can (`negateFilter`): a comparison takes
+     * its negated operator, e.g. `is` and `is not`, a negation gives back its
+     * rule, anything else is wrapped in Not. The top group can't be negated.
+     */
+    toggleNegation(key) {
+        if (key !== this.tree.key) {
+            this.update(key, negateFilter);
+        }
+    }
+    /** Changes a condition's column, keeping its operator and value when they still fit */
+    setColumn(key, columnName, schema) {
+        this.update(key, (rule) => rule instanceof ColumnComparisonFilter
+            ? changeFilterColumn(rule, columnName, schema)
+            : rule);
+    }
+    /** Changes a condition's operator, dropping its value when the operator takes another shape */
+    setOperator(key, operator) {
+        this.update(key, (rule) => rule instanceof ColumnComparisonFilter
+            ? changeFilterOperator(rule, operator)
+            : rule);
+    }
+    setValue(key, value) {
+        this.update(key, (rule) => rule instanceof ColumnComparisonFilter ? rule.withValue(value) : rule);
+    }
+    build() {
+        const { original } = this;
+        if (!this.touched) {
+            return original;
+        }
+        const pruned = pruneBlankFilterRows(this.tree);
+        const filter = pruned === undefined ? undefined : unwrapFilter(pruned);
+        // a saved group of one rule comes back as the rule: it saves differently
+        // but means the same, so it is no change
+        const isUnchanged = filter === undefined
+            ? original.filter === undefined
+            : original.filter !== undefined &&
+                JSON.stringify(encodeFilterRule(filter)) ===
+                    JSON.stringify(encodeFilterRule(unwrapFilter(original.filter)));
+        return isUnchanged ? original : original.withFilter(filter);
+    }
+}
+//# sourceMappingURL=CubeFilterDraft.js.map

package/lib/stores/editors/CubeFilterDraft.js.map

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

package/lib/stores/editors/CubeJoinDraft.d.ts

@@ -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.
+ */
+import { Join, JoinType, type Query, RelationalTableSource, type SchemaInferenceResult } from '@finos/legend-cube';
+import type { CubeModelOutline } from '../../graph-manager/CubeEngine.js';
+import { CubeNodeDraft } from './CubeNodeDraft.js';
+/** One pair of key columns, matched by position; `''` until a column is picked */
+export interface CubeJoinKeyPair {
+    /** Identifies the row in the editor */
+    readonly key: number;
+    readonly left: string;
+    readonly right: string;
+}
+/**
+ * The Join editor's draft (spec §17.6): the join type and the key column
+ * pairs. A pair with no column picked on either side is left out when built,
+ * as a Filter's blank rows are (user's choice, 2026-10-07).
+ */
+export declare class CubeJoinDraft extends CubeNodeDraft<Join> {
+    joinType: JoinType;
+    pairs: CubeJoinKeyPair[];
+    /** Anything was changed; until then, `build()` gives the original back */
+    private touched;
+    /**
+     * The key lists the pairs built before any edit, so edits undone by hand
+     * give the original back, even for saved lists of unequal length
+     */
+    private readonly initialKeyLists;
+    constructor(original: Join);
+    setJoinType(joinType: JoinType): void;
+    addPair(): void;
+    removePair(key: number): void;
+    setLeftColumn(key: number, left: string): void;
+    setRightColumn(key: number, right: string): void;
+    build(): Join;
+}
+/**
+ * The table sources a column of a node's output comes from: followed back
+ * through the inputs whose output has the column. A join key of the same name
+ * on both sides comes from the side the join keeps (the left for INNER and
+ * LEFT OUTER, the right for RIGHT OUTER), and from both for FULL OUTER, which
+ * merges them.
+ */
+export declare const findColumnSources: (query: Query, analysis: SchemaInferenceResult, nodeId: string, columnName: string) => RelationalTableSource[];
+/**
+ * Whether the column of the node's output comes from a table column whose
+ * type Cube can't read (OTHER or ARRAY), so it was typed as a bare String
+ * (PLAN §8.7). Unknown until the model's outline has loaded.
+ */
+export declare const isUntypedColumn: (outline: CubeModelOutline | undefined, query: Query, analysis: SchemaInferenceResult, nodeId: string, columnName: string) => boolean;
+//# sourceMappingURL=CubeJoinDraft.d.ts.map

package/lib/stores/editors/CubeJoinDraft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeJoinDraft.d.ts","sourceRoot":"","sources":["../../../src/stores/editors/CubeJoinDraft.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAEL,IAAI,EACJ,QAAQ,EACR,KAAK,KAAK,EACV,qBAAqB,EACrB,KAAK,qBAAqB,EAC3B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAeD;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,aAAa,CAAC,IAAI,CAAC;IACpD,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,0EAA0E;IAC1E,OAAO,CAAC,OAAO,CAAS;IACxB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;gBAE3C,QAAQ,EAAE,IAAI;IA6B1B,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAKrC,OAAO,IAAI,IAAI;IAKf,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK7B,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAO9C,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOhD,KAAK,IAAI,IAAI;CAed;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,KAAK,EACZ,UAAU,qBAAqB,EAC/B,QAAQ,MAAM,EACd,YAAY,MAAM,KACjB,qBAAqB,EAuBvB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,gBAAgB,GAAG,SAAS,EACrC,OAAO,KAAK,EACZ,UAAU,qBAAqB,EAC/B,QAAQ,MAAM,EACd,YAAY,MAAM,KACjB,OAQA,CAAC"}