@finos/legend-cube-builder 0.0.3 → 0.0.5

package/lib/stores/LocalModelCatalog.js.map

@@ -1 +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"}
+{"version":3,"file":"LocalModelCatalog.js","sourceRoot":"","sources":["../../src/stores/LocalModelCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,EACL,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EACL,iBAAiB,EACjB,kCAAkC,GACnC,MAAM,+BAA+B,CAAC;AAcvC,MAAM,CAAC,MAAM,cAAc,GAA4B,MAAM,CAAC,MAAM,CAAC;IACnE;QACE,EAAE,EAAE,gBAAgB;QACpB,KAAK,EAAE,WAAW;QAClB,KAAK,EAAE,2BAA2B;QAClC,sEAAsE;QACtE,aAAa,EAAE,CAAC,oBAAoB,CAAC;KACtC;IACD;QACE,EAAE,EAAE,oBAAoB;QACxB,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,iBAAiB;KACzB;IACD;QACE,EAAE,EAAE,oBAAoB;QACxB,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,iBAAiB;QACxB,mCAAmC;QACnC,aAAa,EAAE,CAAC,kCAAkC,CAAC;KACpD;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/CubeAggregationRows.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 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 { AggregationSetting, type AggregationUse, type ColumnAggregation, type Schema } from '@finos/legend-cube';
+/** A row's settings as typed, by key: Lag's and Lead's offset, NTile's bucket count */
+export type CubeAggregationSettingTexts = Readonly<Partial<Record<AggregationSetting, string>>>;
+/**
+ * One aggregation row: a column (`undefined` for a function that takes none,
+ * `''` until picked), a function (`''` until picked; an unknown one is kept
+ * as saved) and an output name
+ */
+export interface CubeAggregationRow {
+    /** Identifies the row in the editor */
+    readonly key: number;
+    readonly column: string | undefined;
+    readonly function: string;
+    readonly name: string;
+    /**
+     * The settings as typed (PLAN §11.9): the function's own, and a saved one
+     * it doesn't take, kept so it is reported until the function is picked again
+     */
+    readonly settings: CubeAggregationSettingTexts;
+    /** The settings as saved, kept while their text is as it opened, so one that isn't a whole number stays reported */
+    readonly savedSettings?: Pick<ColumnAggregation, 'offset' | 'buckets'>;
+    /**
+     * The name was typed: it no longer follows the column and the function.
+     * A name equal to the auto-name follows them again.
+     */
+    readonly named: boolean;
+}
+export declare const blankAggregationRow: () => CubeAggregationRow;
+/** Whether the use knows the function and it takes no column: Count rows, and in a window the rank functions */
+export declare const takesNoAggregationColumn: (fn: string, use: AggregationUse) => boolean;
+/**
+ * Whether a row builds an aggregation: it has a column, or its function takes
+ * none, or it holds a function the use doesn't know with no column (a newer
+ * client's, or in a Group a window function such as Rank), kept as saved
+ * (Q4). A blank row, or a column function whose column isn't picked yet, is
+ * left out.
+ */
+export declare const isBuiltAggregationRow: (row: CubeAggregationRow, use: AggregationUse) => boolean;
+/** The rows of saved aggregations, or one blank row when there are none */
+export declare const aggregationRowsOf: (aggregations: readonly ColumnAggregation[], use: AggregationUse) => CubeAggregationRow[];
+/** The aggregations the rows build, in order (`isBuiltAggregationRow`) */
+export declare const aggregationsOfRows: (rows: readonly CubeAggregationRow[], use: AggregationUse) => ColumnAggregation[];
+/** The row with its column picked; with no function yet, Count */
+export declare const withRowColumn: (row: CubeAggregationRow, column: string, use: AggregationUse) => CubeAggregationRow;
+/**
+ * The row with its function picked: a function that takes no column clears
+ * it, and back to a column function leaves one to pick. It keeps only the
+ * function's own setting, as typed, or its default.
+ */
+export declare const withRowFunction: (row: CubeAggregationRow, fn: string, use: AggregationUse) => CubeAggregationRow;
+/** The row with a setting typed, kept exactly as text */
+export declare const withRowSetting: (row: CubeAggregationRow, setting: AggregationSetting, text: string) => CubeAggregationRow;
+/** The row with its name typed, kept exactly; the auto-name itself follows again */
+export declare const withRowName: (row: CubeAggregationRow, name: string, use: AggregationUse) => CubeAggregationRow;
+export declare const isSameAggregations: (a: readonly ColumnAggregation[], b: readonly ColumnAggregation[]) => boolean;
+/**
+ * Picked columns in the input's order, then those the input doesn't have, in
+ * the order they were picked: a saved column the input lost stays listed
+ * until it is unticked (a Group's keys, a Partition's columns, Q2)
+ */
+export declare const inInputOrder: (names: readonly string[], schema: Schema) => string[];
+/** The picked columns with one ticked or unticked, in the input's order (`inInputOrder`) */
+export declare const toggledColumns: (columns: readonly string[], name: string, schema: Schema) => string[];
+export declare const isSameList: (a: readonly string[], b: readonly string[]) => boolean;
+//# sourceMappingURL=CubeAggregationRows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeAggregationRows.d.ts","sourceRoot":"","sources":["../../../src/stores/editors/CubeAggregationRows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAGL,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EAItB,KAAK,MAAM,EAEZ,MAAM,oBAAoB,CAAC;AAQ5B,uFAAuF;AACvF,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAChD,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAC5C,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAC/C,oHAAoH;IACpH,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;IACvE;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAID,eAAO,MAAM,mBAAmB,QAAO,kBAOrC,CAAC;AA2CH,gHAAgH;AAChH,eAAO,MAAM,wBAAwB,GACnC,IAAI,MAAM,EACV,KAAK,cAAc,KAClB,OAA0E,CAAC;AAE9E;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,KAAK,kBAAkB,EACvB,KAAK,cAAc,KAClB,OAGwE,CAAC;AAc5E,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,GAC5B,cAAc,SAAS,iBAAiB,EAAE,EAC1C,KAAK,cAAc,KAClB,kBAAkB,EAqBQ,CAAC;AAE9B,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,GAC7B,MAAM,SAAS,kBAAkB,EAAE,EACnC,KAAK,cAAc,KAClB,iBAAiB,EAQb,CAAC;AAER,kEAAkE;AAClE,eAAO,MAAM,aAAa,GACxB,KAAK,kBAAkB,EACvB,QAAQ,MAAM,EACd,KAAK,cAAc,KAClB,kBAIA,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,KAAK,kBAAkB,EACvB,IAAI,MAAM,EACV,KAAK,cAAc,KAClB,kBAoBF,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,cAAc,GACzB,KAAK,kBAAkB,EACvB,SAAS,kBAAkB,EAC3B,MAAM,MAAM,KACX,kBAGD,CAAC;AAEH,oFAAoF;AACpF,eAAO,MAAM,WAAW,GACtB,KAAK,kBAAkB,EACvB,MAAM,MAAM,EACZ,KAAK,cAAc,KAClB,kBAID,CAAC;AAEH,eAAO,MAAM,kBAAkB,GAC7B,GAAG,SAAS,iBAAiB,EAAE,EAC/B,GAAG,SAAS,iBAAiB,EAAE,KAC9B,OASA,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,YAAY,GACvB,OAAO,SAAS,MAAM,EAAE,EACxB,QAAQ,MAAM,KACb,MAAM,EAGR,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,cAAc,GACzB,SAAS,SAAS,MAAM,EAAE,EAC1B,MAAM,MAAM,EACZ,QAAQ,MAAM,KACb,MAAM,EAMN,CAAC;AAEJ,eAAO,MAAM,UAAU,GACrB,GAAG,SAAS,MAAM,EAAE,EACpB,GAAG,SAAS,MAAM,EAAE,KACnB,OACmE,CAAC"}

package/lib/stores/editors/CubeAggregationRows.js

@@ -0,0 +1,164 @@
+/**
+ * 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 { AGGREGATION_SETTING_DEFAULTS, AggregationFunction, AggregationSetting, getAggregationAutoName, getAggregationSetting, isAggregationFunctionOf, takesAggregationColumn, } from '@finos/legend-cube';
+import { parseWholeNumberText } from './CubeIntegerText.js';
+let nextRowKey = 1;
+export const blankAggregationRow = () => ({
+    key: nextRowKey++,
+    column: '',
+    function: '',
+    name: '',
+    settings: {},
+    named: false,
+});
+/** The settings a saved aggregation holds, as texts */
+const settingTextsOf = ({ offset, buckets, }) => ({
+    ...(offset === undefined
+        ? {}
+        : { [AggregationSetting.OFFSET]: String(offset) }),
+    ...(buckets === undefined
+        ? {}
+        : { [AggregationSetting.BUCKETS]: String(buckets) }),
+});
+/**
+ * The settings the texts give: a whole number, or the saved number while the
+ * text is as it opened (so a saved 2.5 stays 2.5, reported, never dropped), or
+ * none, which the node reports
+ */
+const settingsOfTexts = (texts, saved = {}) => {
+    const [offset, buckets] = [
+        AggregationSetting.OFFSET,
+        AggregationSetting.BUCKETS,
+    ].map((key) => {
+        const text = texts[key];
+        const savedValue = saved[key];
+        return text === undefined
+            ? undefined
+            : (parseWholeNumberText(text) ??
+                (savedValue !== undefined && text === String(savedValue)
+                    ? savedValue
+                    : undefined));
+    });
+    return {
+        ...(offset === undefined ? {} : { offset }),
+        ...(buckets === undefined ? {} : { buckets }),
+    };
+};
+/** Whether the use knows the function and it takes no column: Count rows, and in a window the rank functions */
+export const takesNoAggregationColumn = (fn, use) => isAggregationFunctionOf(fn, use) && !takesAggregationColumn(fn);
+/**
+ * Whether a row builds an aggregation: it has a column, or its function takes
+ * none, or it holds a function the use doesn't know with no column (a newer
+ * client's, or in a Group a window function such as Rank), kept as saved
+ * (Q4). A blank row, or a column function whose column isn't picked yet, is
+ * left out.
+ */
+export const isBuiltAggregationRow = (row, use) => Boolean(row.column) ||
+    takesNoAggregationColumn(row.function, use) ||
+    (row.column === undefined && !isAggregationFunctionOf(row.function, use));
+/** The row with its name following the column and the function, unless typed */
+const withAutoName = (row, use) => row.named
+    ? row
+    : {
+        ...row,
+        name: getAggregationAutoName(row.function, row.column, use) ?? '',
+    };
+/** The rows of saved aggregations, or one blank row when there are none */
+export const aggregationRowsOf = (aggregations, use) => aggregations.length
+    ? aggregations.map((aggregation) => {
+        const { column, function: fn, name } = aggregation;
+        return {
+            key: nextRowKey++,
+            column,
+            function: fn,
+            name,
+            settings: settingTextsOf(aggregation),
+            savedSettings: {
+                ...(aggregation.offset === undefined
+                    ? {}
+                    : { offset: aggregation.offset }),
+                ...(aggregation.buckets === undefined
+                    ? {}
+                    : { buckets: aggregation.buckets }),
+            },
+            named: name !== (getAggregationAutoName(fn, column, use) ?? ''),
+        };
+    })
+    : [blankAggregationRow()];
+/** The aggregations the rows build, in order (`isBuiltAggregationRow`) */
+export const aggregationsOfRows = (rows, use) => rows
+    .filter((row) => isBuiltAggregationRow(row, use))
+    .map(({ column, function: fn, name, settings, savedSettings }) => ({
+    column,
+    function: fn,
+    name,
+    ...settingsOfTexts(settings, savedSettings),
+}));
+/** The row with its column picked; with no function yet, Count */
+export const withRowColumn = (row, column, use) => withAutoName({ ...row, column, function: row.function || AggregationFunction.COUNT }, use);
+/**
+ * The row with its function picked: a function that takes no column clears
+ * it, and back to a column function leaves one to pick. It keeps only the
+ * function's own setting, as typed, or its default.
+ */
+export const withRowFunction = (row, fn, use) => {
+    const setting = getAggregationSetting(fn);
+    return withAutoName({
+        ...row,
+        function: fn,
+        column: takesNoAggregationColumn(fn, use)
+            ? undefined
+            : (row.column ?? ''),
+        settings: setting === undefined
+            ? {}
+            : {
+                [setting]: row.settings[setting] ??
+                    String(AGGREGATION_SETTING_DEFAULTS[setting]),
+            },
+    }, use);
+};
+/** The row with a setting typed, kept exactly as text */
+export const withRowSetting = (row, setting, text) => ({
+    ...row,
+    settings: { ...row.settings, [setting]: text },
+});
+/** The row with its name typed, kept exactly; the auto-name itself follows again */
+export const withRowName = (row, name, use) => ({
+    ...row,
+    name,
+    named: name !== (getAggregationAutoName(row.function, row.column, use) ?? ''),
+});
+export const isSameAggregations = (a, b) => a.length === b.length &&
+    a.every((aggregation, index) => aggregation.column === b[index]?.column &&
+        aggregation.function === b[index]?.function &&
+        aggregation.name === b[index]?.name &&
+        aggregation.offset === b[index]?.offset &&
+        aggregation.buckets === b[index]?.buckets);
+/**
+ * Picked columns in the input's order, then those the input doesn't have, in
+ * the order they were picked: a saved column the input lost stays listed
+ * until it is unticked (a Group's keys, a Partition's columns, Q2)
+ */
+export const inInputOrder = (names, schema) => [
+    ...schema.names().filter((name) => names.includes(name)),
+    ...names.filter((name) => schema.lookup(name) === undefined),
+];
+/** The picked columns with one ticked or unticked, in the input's order (`inInputOrder`) */
+export const toggledColumns = (columns, name, schema) => inInputOrder(columns.includes(name)
+    ? columns.filter((picked) => picked !== name)
+    : [...columns, name], schema);
+export const isSameList = (a, b) => a.length === b.length && a.every((name, index) => name === b[index]);
+//# sourceMappingURL=CubeAggregationRows.js.map

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

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

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

@@ -0,0 +1,30 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { Concat } from '@finos/legend-cube';
+import { CubeNodeDraft } from './CubeNodeDraft.js';
+/**
+ * The Concat editor's draft (PLAN §11.5): its one setting, Convert types
+ * (Q5), which converts types that differ within numbers, strings or dates
+ * to the type they share
+ */
+export declare class CubeConcatDraft extends CubeNodeDraft<Concat> {
+    widenTypes: boolean;
+    constructor(original: Concat);
+    setWidenTypes(widenTypes: boolean): void;
+    /** The original while the setting is as it was */
+    build(): Concat;
+}
+//# sourceMappingURL=CubeConcatDraft.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeConcatDraft.d.ts","sourceRoot":"","sources":["../../../src/stores/editors/CubeConcatDraft.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,aAAa,CAAC,MAAM,CAAC;IACxD,UAAU,EAAE,OAAO,CAAC;gBAER,QAAQ,EAAE,MAAM;IAS5B,aAAa,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI;IAIxC,kDAAkD;IAClD,KAAK,IAAI,MAAM;CAMhB"}

package/lib/stores/editors/CubeConcatDraft.js

@@ -0,0 +1,44 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { action, makeObservable, observable } from 'mobx';
+import { CubeNodeDraft } from './CubeNodeDraft.js';
+/**
+ * The Concat editor's draft (PLAN §11.5): its one setting, Convert types
+ * (Q5), which converts types that differ within numbers, strings or dates
+ * to the type they share
+ */
+export class CubeConcatDraft extends CubeNodeDraft {
+    widenTypes;
+    constructor(original) {
+        super(original);
+        makeObservable(this, {
+            widenTypes: observable,
+            setWidenTypes: action,
+        });
+        this.widenTypes = original.widenTypes;
+    }
+    setWidenTypes(widenTypes) {
+        this.widenTypes = widenTypes;
+    }
+    /** The original while the setting is as it was */
+    build() {
+        const { original, widenTypes } = this;
+        return widenTypes === original.widenTypes
+            ? original
+            : original.withWidenTypes(widenTypes);
+    }
+}
+//# sourceMappingURL=CubeConcatDraft.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeConcatDraft.js","sourceRoot":"","sources":["../../../src/stores/editors/CubeConcatDraft.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,aAAqB;IACxD,UAAU,CAAU;IAEpB,YAAY,QAAgB;QAC1B,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChB,cAAc,CAAC,IAAI,EAAE;YACnB,UAAU,EAAE,UAAU;YACtB,aAAa,EAAE,MAAM;SACtB,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;IACxC,CAAC;IAED,aAAa,CAAC,UAAmB;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,kDAAkD;IAClD,KAAK;QACH,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QACtC,OAAO,UAAU,KAAK,QAAQ,CAAC,UAAU;YACvC,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC;CACF"}

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

@@ -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 { type Difference, type Schema, type SchemaColumn } from '@finos/legend-cube';
+import { type CubeJoinKeyPair, type CubeJoinKeysDraft } from './CubeJoinKeyPairs.js';
+import { CubeNodeDraft } from './CubeNodeDraft.js';
+/**
+ * The Difference editor's draft (spec §17.6, PLAN §11.7): pairs of key
+ * columns, as a Join's (a pair with no column picked is left out when built),
+ * and the difference columns, stored in the Left input's order but kept in a
+ * saved order until the picks change (M4's Q2). Until something changes,
+ * `build()` gives the original back.
+ */
+export declare class CubeDifferenceDraft extends CubeNodeDraft<Difference> implements CubeJoinKeysDraft {
+    pairs: readonly CubeJoinKeyPair[];
+    differenceColumns: readonly string[];
+    /** 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 */
+    private readonly initialKeyLists;
+    constructor(original: Difference);
+    addPair(): void;
+    removePair(key: number): void;
+    setLeftColumn(key: number, left: string): void;
+    setRightColumn(key: number, right: string): void;
+    /** Ticks or unticks a difference column; the columns then follow the Left input's order */
+    toggleDifferenceColumn(name: string, leftSchema: Schema): void;
+    clearDifferenceColumns(): void;
+    build(): Difference;
+}
+/**
+ * Why a column of the Left input can't be a difference column, `undefined`
+ * when it can: it is a join column on either side, or not a number, or not in
+ * the Right input with the same type (PLAN §11.7)
+ */
+export declare const getDifferenceColumnUnpickableReason: (column: SchemaColumn, rightSchema: Schema, joinColumns: readonly string[]) => string | undefined;
+//# sourceMappingURL=CubeDifferenceDraft.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeDifferenceDraft.d.ts","sourceRoot":"","sources":["../../../src/stores/editors/CubeDifferenceDraft.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,KAAK,UAAU,EAEf,KAAK,MAAM,EACX,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EAGvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;GAMG;AACH,qBAAa,mBACX,SAAQ,aAAa,CAAC,UAAU,CAChC,YAAW,iBAAiB;IAE5B,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAClC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,0EAA0E;IAC1E,OAAO,CAAC,OAAO,CAAS;IACxB,oGAAoG;IACpG,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;gBAE3C,QAAQ,EAAE,UAAU;IAkBhC,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,2FAA2F;IAC3F,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAS9D,sBAAsB,IAAI,IAAI;IAK9B,KAAK,IAAI,UAAU;CAepB;AAED;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,GAC9C,QAAQ,YAAY,EACpB,aAAa,MAAM,EACnB,aAAa,SAAS,MAAM,EAAE,KAC7B,MAAM,GAAG,SAWX,CAAC"}

package/lib/stores/editors/CubeDifferenceDraft.js

@@ -0,0 +1,111 @@
+/**
+ * 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 { isNumericFamily, } from '@finos/legend-cube';
+import { action, makeObservable, observable } from 'mobx';
+import { CUBE_DIFFERENCE_COLUMN_REASONS } from '../../__lib__/LegendCubeLabels.js';
+import { isSameList, toggledColumns } from './CubeAggregationRows.js';
+import { blankJoinKeyPair, joinKeyListsOf, joinKeyPairsOf, } from './CubeJoinKeyPairs.js';
+import { CubeNodeDraft } from './CubeNodeDraft.js';
+/**
+ * The Difference editor's draft (spec §17.6, PLAN §11.7): pairs of key
+ * columns, as a Join's (a pair with no column picked is left out when built),
+ * and the difference columns, stored in the Left input's order but kept in a
+ * saved order until the picks change (M4's Q2). Until something changes,
+ * `build()` gives the original back.
+ */
+export class CubeDifferenceDraft extends CubeNodeDraft {
+    pairs;
+    differenceColumns;
+    /** Anything was changed; until then, `build()` gives the original back */
+    touched = false;
+    /** The key lists the pairs built before any edit, so edits undone by hand give the original back */
+    initialKeyLists;
+    constructor(original) {
+        super(original);
+        makeObservable(this, {
+            pairs: observable.ref,
+            differenceColumns: observable.ref,
+            touched: observable,
+            addPair: action,
+            removePair: action,
+            setLeftColumn: action,
+            setRightColumn: action,
+            toggleDifferenceColumn: action,
+            clearDifferenceColumns: action,
+        });
+        this.pairs = joinKeyPairsOf(original.leftColumns, original.rightColumns);
+        this.initialKeyLists = joinKeyListsOf(this.pairs);
+        this.differenceColumns = original.differenceColumns;
+    }
+    addPair() {
+        this.pairs = [...this.pairs, blankJoinKeyPair()];
+        this.touched = true;
+    }
+    removePair(key) {
+        this.pairs = this.pairs.filter((pair) => pair.key !== key);
+        this.touched = true;
+    }
+    setLeftColumn(key, left) {
+        this.pairs = this.pairs.map((pair) => pair.key === key ? { ...pair, left } : pair);
+        this.touched = true;
+    }
+    setRightColumn(key, right) {
+        this.pairs = this.pairs.map((pair) => pair.key === key ? { ...pair, right } : pair);
+        this.touched = true;
+    }
+    /** Ticks or unticks a difference column; the columns then follow the Left input's order */
+    toggleDifferenceColumn(name, leftSchema) {
+        this.differenceColumns = toggledColumns(this.differenceColumns, name, leftSchema);
+        this.touched = true;
+    }
+    clearDifferenceColumns() {
+        this.differenceColumns = [];
+        this.touched = true;
+    }
+    build() {
+        const [leftColumns, rightColumns] = joinKeyListsOf(this.pairs);
+        const [initialLeft, initialRight] = this.initialKeyLists;
+        const { original } = this;
+        return !this.touched ||
+            (isSameList(leftColumns, initialLeft) &&
+                isSameList(rightColumns, initialRight) &&
+                isSameList(this.differenceColumns, original.differenceColumns))
+            ? original
+            : original.withSettings({
+                leftColumns,
+                rightColumns,
+                differenceColumns: this.differenceColumns,
+            });
+    }
+}
+/**
+ * Why a column of the Left input can't be a difference column, `undefined`
+ * when it can: it is a join column on either side, or not a number, or not in
+ * the Right input with the same type (PLAN §11.7)
+ */
+export const getDifferenceColumnUnpickableReason = (column, rightSchema, joinColumns) => {
+    const rightType = rightSchema.type(column.name);
+    return joinColumns.includes(column.name)
+        ? CUBE_DIFFERENCE_COLUMN_REASONS.JOIN_COLUMN
+        : !isNumericFamily(column.type.family)
+            ? CUBE_DIFFERENCE_COLUMN_REASONS.NOT_NUMERIC
+            : rightType === undefined
+                ? CUBE_DIFFERENCE_COLUMN_REASONS.NOT_IN_RIGHT
+                : !rightType.equals(column.type)
+                    ? CUBE_DIFFERENCE_COLUMN_REASONS.TYPE_DIFFERS(rightType.displayName)
+                    : undefined;
+};
+//# sourceMappingURL=CubeDifferenceDraft.js.map

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

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

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

@@ -0,0 +1,91 @@
+/**
+ * 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, ExpressionFilter, type JsonObject, type QueryNode, type Schema } from '@finos/legend-cube';
+import type { GeneratorFn } from '@finos/legend-shared';
+import { type CubeSourceLocation } from '../../graph-manager/CubeEngine.js';
+import type { CubeEditorState } from '../CubeEditorState.js';
+import { CubeNodeDraft } from './CubeNodeDraft.js';
+/** What the engine made of the condition's code the last time it was validated */
+export interface CubeConditionCheckedCode {
+    readonly code: string;
+    readonly lambda: JsonObject;
+    readonly located: JsonObject;
+}
+/** The condition's problem from the last Validate: a message, where it is in the code, and a hint */
+export interface CubeConditionProblem {
+    readonly message: string;
+    readonly location?: CubeSourceLocation | undefined;
+    readonly hint?: string | undefined;
+    /**
+     * Cube refused the condition before asking the engine (a backslash, `%` or
+     * `_` on DuckDB, a pattern that isn't a literal): the panel's problems show
+     * it, so the editor doesn't say it again (PLAN §11.14)
+     */
+    readonly refused?: true;
+}
+/** What a new condition's code starts as (PLAN §11.11) */
+export declare const NEW_CONDITION_CODE = "x | ";
+/**
+ * The Filter by Expression editor's draft (PLAN §11.11): the condition's
+ * code, `x | …`. Validate (F10) has the engine parse it, checks Cube's rules,
+ * has the engine check it after the input, located so an error points into
+ * the code, then plans the query up to this node for the cube's database.
+ * Apply waits until the code is the one validated; the node then holds the
+ * engine's lambda and its check, so it needn't be checked again.
+ */
+export declare class CubeExpressionFilterDraft extends CubeNodeDraft<ExpressionFilter> {
+    readonly editorState: CubeEditorState;
+    code: string;
+    /** What the engine made of the code the last time it parsed it */
+    checked: CubeConditionCheckedCode | undefined;
+    /** The problem from the last Validate, while the code is the one validated */
+    problem: CubeConditionProblem | undefined;
+    /** The check the last Validate gave, for the code as it was then */
+    check: ExpressionCheck | undefined;
+    validating: boolean;
+    /** Anything was changed; until then, `build()` gives the original back */
+    private touched;
+    /** The database type the last plan was for, named in its problem */
+    private planDatabaseType;
+    constructor(original: ExpressionFilter, editorState: CubeEditorState);
+    /** The input's schema, when the input is valid */
+    get inputSchema(): Schema | undefined;
+    /** The code is the one the engine last parsed */
+    get isValidated(): boolean;
+    /** The code is the one validated, and the engine said it is one Boolean of a row */
+    get isChecked(): boolean;
+    /** Why Apply waits: a validation running, or the code not validated yet */
+    get applyDisabledReason(): string | undefined;
+    /** A code edit drops the problem, until the next Validate */
+    setCode(code: string): void;
+    build(): ExpressionFilter;
+    /**
+     * Goes on from a filter that differs from the original only in its check,
+     * e.g. checked in the background after an Apply, keeping the code
+     */
+    follow(node: QueryNode): boolean;
+    /**
+     * Checks the condition with the engine (F10): parses the code when it
+     * changed since the last Validate, checks Cube's own rules and the
+     * database's, then, when the input is valid, checks the condition after
+     * the input, located in the code, and plans the query up to this node for
+     * the cube's database
+     */
+    validate(): GeneratorFn<void>;
+    /** Plans the query up to the checked candidate, as a run with it selected would; the database's refusal, if any */
+    private planFrom;
+}
+//# sourceMappingURL=CubeExpressionFilterDraft.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeExpressionFilterDraft.d.ts","sourceRoot":"","sources":["../../../src/stores/editors/CubeExpressionFilterDraft.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAEL,KAAK,eAAe,EACpB,gBAAgB,EAEhB,KAAK,UAAU,EAIf,KAAK,SAAS,EACd,KAAK,MAAM,EAEZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAexD,OAAO,EAIL,KAAK,kBAAkB,EAExB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAS7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,kFAAkF;AAClF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;CAC9B;AAED,qGAAqG;AACrG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;CACzB;AAED,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,SAAS,CAAC;AA2BzC;;;;;;;GAOG;AACH,qBAAa,yBAA0B,SAAQ,aAAa,CAAC,gBAAgB,CAAC;IAC5E,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAC9C,8EAA8E;IAC9E,OAAO,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAC1C,oEAAoE;IACpE,KAAK,EAAE,eAAe,GAAG,SAAS,CAAC;IACnC,UAAU,UAAS;IACnB,0EAA0E;IAC1E,OAAO,CAAC,OAAO,CAAS;IACxB,oEAAoE;IACpE,OAAO,CAAC,gBAAgB,CAAqB;gBAEjC,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe;IAuBpE,kDAAkD;IAClD,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAMpC;IAED,iDAAiD;IACjD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,oFAAoF;IACpF,IAAI,SAAS,IAAI,OAAO,CAWvB;IAED,2EAA2E;IAC3E,IAAa,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAMrD;IAED,6DAA6D;IAC7D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS3B,KAAK,IAAI,gBAAgB;IAYzB;;;OAGG;IACM,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO;IAczC;;;;;;OAMG;IACF,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC;IAuG9B,mHAAmH;YACrG,QAAQ;CAwCvB"}