@finos/legend-cube-builder 0.0.2 → 0.0.4

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/CubeExtendDraft.d.ts

@@ -0,0 +1,110 @@
+/**
+ * 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 CubeType, Extend, type ExtendColumn, type ExtendTyping, 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 a row's code the last time it was validated */
+export interface CubeExtendCheckedCode {
+    readonly code: string;
+    readonly lambda: JsonObject;
+    readonly located: JsonObject;
+}
+/** A row's problem from the last Validate: the engine's message, where it is in the code, and a hint */
+export interface CubeExtendRowProblem {
+    readonly message: string;
+    readonly location?: CubeSourceLocation | undefined;
+    readonly hint?: string | undefined;
+}
+/** One new column in the editor */
+export interface CubeExtendRow {
+    /** Identifies the row in the editor, and its code to the engine */
+    readonly key: number;
+    readonly name: string;
+    readonly code: string;
+    readonly checked?: CubeExtendCheckedCode | undefined;
+    readonly problem?: CubeExtendRowProblem | undefined;
+    /** The type the engine gave, while the row is as it was typed */
+    readonly type?: CubeType | undefined;
+}
+/** What a new column's code starts as (PLAN §11.7 Q2) */
+export declare const NEW_EXPRESSION_CODE = "x | ";
+/**
+ * The Extend editor's draft (PLAN §11.7): a row per new column, its name and
+ * its code, `x | …`. Validate (F10) has the engine check each changed code,
+ * type the columns as a chain after the input, located so an error points
+ * into the code, and plan the query for the cube's database. Apply waits
+ * until every row's code is the one validated; the node then holds the
+ * engine's lambdas and their typing, so it needn't be typed again.
+ */
+export declare class CubeExtendDraft extends CubeNodeDraft<Extend> {
+    readonly editorState: CubeEditorState;
+    rows: readonly CubeExtendRow[];
+    /** The typing the last Validate gave, for the rows as they were then */
+    typing: ExtendTyping | 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: Extend, editorState: CubeEditorState);
+    /** The input's schema, when the input is valid */
+    get inputSchema(): Schema | undefined;
+    /** A row named `col_<n>`, the first such name no column has, in any case */
+    private newRow;
+    /** The columns the rows build: a row's lambda only while its code is the one validated */
+    get columns(): ExtendColumn[];
+    /** Every row's code is the one the engine last checked */
+    get isValidated(): boolean;
+    /** Why Apply waits: a validation running, or a code not validated yet */
+    get applyDisabledReason(): string | undefined;
+    private change;
+    addRow(): void;
+    removeRow(key: number): void;
+    /** Moves a row up (-1) or down (+1); a later column may use it, so its typing waits */
+    moveRow(key: number, offset: number): void;
+    setName(key: number, name: string): void;
+    /** A code edit drops the row's problem and type, until the next Validate */
+    setCode(key: number, code: string): void;
+    build(): Extend;
+    /**
+     * Goes on from an Extend that differs from the original only in its
+     * typing, e.g. typed in the background after an Apply, keeping the rows;
+     * rows not validated in this draft take the new types
+     */
+    follow(node: QueryNode): boolean;
+    /**
+     * Checks every row with the engine (F10): parses each code changed since
+     * the last Validate, then, when every code parses and the input is valid,
+     * types the columns after the input, located in their codes, and plans the
+     * query up to this node for the cube's database; a plan that fails is
+     * planned again column by column to find the first that fails. Each
+     * problem goes on its row.
+     */
+    validate(): GeneratorFn<void>;
+    /** Cube's problems, each on its row; whether there was one */
+    private putCubeProblems;
+    /** The problem on its row, or on every row when the engine named none */
+    private putProblem;
+    /**
+     * Plans the query up to the typed candidate, as a run would; when it
+     * fails with several columns, the first k columns for every k, to name
+     * the column the database can't run
+     */
+    private planFrom;
+}
+//# sourceMappingURL=CubeExtendDraft.d.ts.map

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

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