@finos/legend-cube-builder 0.0.2 → 0.0.4

package/lib/stores/CubeExtendTyping.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 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 { Extend, type ExtendTyping, type IR, type JsonObject, type ModelContext, type NodeRegistry, type Query, QueryEmitter, type QueryRule, type Schema } from '@finos/legend-cube';
+import { CubeEngineError, type NodeId } from '../graph-manager/CubeEngine.js';
+/** An engine message without the compiler's ` - Context:[…]` trail, which repeats what it was doing */
+export declare const withoutEngineContext: (message: string) => string;
+/** A column to type: its name, and its lambda, located in its text or not */
+export interface CubeExtendTypingColumn {
+    readonly name: string;
+    readonly lambda: JsonObject;
+}
+/**
+ * The lambdas that type an Extend's columns, by key: the input's relation
+ * then the first k columns, for every k. A located lambda keeps its
+ * locations, so an error points into its text; a stored one is marked with
+ * the Extend, so an error lands on it. The input must be valid.
+ */
+export declare const buildCubeExtendTypingLambdas: (query: Query, extend: Extend, columns: readonly CubeExtendTypingColumn[], registry: NodeRegistry, located: boolean) => Map<NodeId, IR>;
+/**
+ * What the engine is given for an Extend's input when it types it, digested
+ * (PLAN §11.7): the input's relation as emitted, and the model. A typing
+ * records it (`upstream`), since the engine sees more than Cube's schema
+ * does; `undefined` when the input can't be emitted, e.g. it is invalid.
+ */
+export declare const getCubeExtendUpstream: (emitter: QueryEmitter, extendId: string, model: ModelContext) => string | undefined;
+/** The digest of what the engine was given for the input, which the typing recorded */
+export declare const getCubeExtendTypingUpstream: (typing: ExtendTyping) => string | undefined;
+/**
+ * Whether the Extend's typing gives its types for this input: typed, for
+ * this schema and these columns, and for this input as the engine is given
+ * it, or recorded without it, as when loaded
+ */
+export declare const isCubeExtendTypingCurrent: (extend: Extend, input: Schema, upstream: string | undefined) => boolean;
+/**
+ * A query rule for the editor (PLAN §11.7): an Extend whose typing recorded
+ * another input than the engine would be given now waits to be typed again
+ * (`ERR_TYPING`), e.g. after an Extend above it gains `->toOne()`, which
+ * Cube's schema doesn't show. A typing that recorded nothing, as one loaded,
+ * is used as it is; an Extend that already waits, or whose input is invalid,
+ * is left to its own checks.
+ */
+export declare const createStaleCubeExtendTypingRule: (registry: NodeRegistry, modelOf: () => ModelContext | undefined) => QueryRule;
+/** What typing an Extend gave: the typing to store, and the error the engine gave, if it failed */
+export interface CubeExtendTypingResult {
+    readonly typing: ExtendTyping;
+    readonly error?: CubeEngineError | undefined;
+}
+/**
+ * The typing the engine's answers give, for this input and these columns:
+ * every column's type, from the whole chain, else the first column whose
+ * chain fails, with the engine's error (a network failure on none)
+ */
+export declare const readCubeExtendTyping: (answers: ReadonlyMap<NodeId, Schema | CubeEngineError>, extend: Extend, input: Schema, columns: readonly CubeExtendTypingColumn[], upstream: string | undefined) => CubeExtendTypingResult;
+/**
+ * Whether two typings say the same: the same kind, signature and input as
+ * the engine was given it, and the same types, or the same failure
+ */
+export declare const isSameCubeExtendTyping: (a: ExtendTyping, b: ExtendTyping) => boolean;
+//# sourceMappingURL=CubeExtendTyping.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeExtendTyping.d.ts","sourceRoot":"","sources":["../../src/stores/CubeExtendTyping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAML,MAAM,EACN,KAAK,YAAY,EAIjB,KAAK,EAAE,EAEP,KAAK,UAAU,EAGf,KAAK,YAAY,EACjB,KAAK,YAAY,EAGjB,KAAK,KAAK,EACV,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,MAAM,EAEZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EAEf,KAAK,MAAM,EACZ,MAAM,gCAAgC,CAAC;AAOxC,uGAAuG;AACvG,eAAO,MAAM,oBAAoB,GAAI,SAAS,MAAM,KAAG,MACT,CAAC;AAE/C,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAMD;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GACvC,OAAO,KAAK,EACZ,QAAQ,MAAM,EACd,SAAS,SAAS,sBAAsB,EAAE,EAC1C,UAAU,YAAY,EACtB,SAAS,OAAO,KACf,GAAG,CAAC,MAAM,EAAE,EAAE,CAwBhB,CAAC;AAcF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,YAAY,EACrB,UAAU,MAAM,EAChB,OAAO,YAAY,KAClB,MAAM,GAAG,SAQX,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,2BAA2B,GACtC,QAAQ,YAAY,KACnB,MAAM,GAAG,SACgD,CAAC;AAI7D;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACpC,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,UAAU,MAAM,GAAG,SAAS,KAC3B,OAQF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,GAExC,UAAU,YAAY,EACtB,SAAS,MAAM,YAAY,GAAG,SAAS,KACtC,SAuBF,CAAC;AAEJ,mGAAmG;AACnG,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CAC9C;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,EACtD,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,SAAS,SAAS,sBAAsB,EAAE,EAC1C,UAAU,MAAM,GAAG,SAAS,KAC3B,sBAyCF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,GAAG,YAAY,EACf,GAAG,YAAY,KACd,OAsBF,CAAC"}

package/lib/stores/CubeExtendTyping.js

@@ -0,0 +1,176 @@
+/**
+ * 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 { buildSchemasAndValidity, colSpec, colSpecArray, EmitRole, ERR_TYPING, Extend, func, getExtendSignature, hashText, isTypingError, lambda, lambdaJson, originOf, printIR, QueryEmitter, stableJsonText, } from '@finos/legend-cube';
+import { CubeEngineError, CubeEngineErrorKind, } from '../graph-manager/CubeEngine.js';
+// Typing an Extend's columns with the engine (PLAN §11.7): its input's
+// relation, as Cube types any node, then one extend per column. The whole
+// chain gives every type; each shorter chain, typed with it, tells which
+// column the engine fails on, since a stored lambda has no locations.
+/** An engine message without the compiler's ` - Context:[…]` trail, which repeats what it was doing */
+export const withoutEngineContext = (message) => message.replace(/ - Context:\[[^\n]*/gu, '');
+/** The key of the lambda that types the first `count` columns */
+const keyOf = (extendId, count) => `${extendId}#${count}`;
+/**
+ * The lambdas that type an Extend's columns, by key: the input's relation
+ * then the first k columns, for every k. A located lambda keeps its
+ * locations, so an error points into its text; a stored one is marked with
+ * the Extend, so an error lands on it. The input must be valid.
+ */
+export const buildCubeExtendTypingLambdas = (query, extend, columns, registry, located) => {
+    const [inputId] = query.getInputIds(extend.id);
+    if (inputId === undefined) {
+        throw new Error(`Extend "${extend.id}" has no input to type it on`);
+    }
+    const input = new QueryEmitter(query, registry).emitRelation(inputId);
+    const lambdas = new Map();
+    columns.reduce((relation, column, index) => {
+        const extended = func('extend', [
+            relation,
+            colSpecArray([
+                colSpec(column.name, lambdaJson(column.lambda, located ? undefined : originOf(extend.id, EmitRole.EXPRESSION))),
+            ]),
+        ]);
+        lambdas.set(keyOf(extend.id, index + 1), lambda([], [extended]));
+        return extended;
+    }, input);
+    return lambdas;
+};
+/** Each model's digest, by the object, so a large model is digested once */
+const MODEL_DIGESTS = new WeakMap();
+const digestModel = (model) => {
+    let digest = MODEL_DIGESTS.get(model);
+    if (digest === undefined) {
+        digest = hashText(stableJsonText(model));
+        MODEL_DIGESTS.set(model, digest);
+    }
+    return digest;
+};
+/**
+ * What the engine is given for an Extend's input when it types it, digested
+ * (PLAN §11.7): the input's relation as emitted, and the model. A typing
+ * records it (`upstream`), since the engine sees more than Cube's schema
+ * does; `undefined` when the input can't be emitted, e.g. it is invalid.
+ */
+export const getCubeExtendUpstream = (emitter, extendId, model) => {
+    const [inputId] = emitter.query.getInputIds(extendId);
+    if (inputId === undefined || !emitter.canEmit(inputId)) {
+        return undefined;
+    }
+    return hashText(`${digestModel(model)}\n${printIR(emitter.emitRelation(inputId))}`);
+};
+/** The digest of what the engine was given for the input, which the typing recorded */
+export const getCubeExtendTypingUpstream = (typing) => typing.kind === 'unresolved' ? undefined : typing.upstream;
+const upstreamOf = getCubeExtendTypingUpstream;
+/**
+ * Whether the Extend's typing gives its types for this input: typed, for
+ * this schema and these columns, and for this input as the engine is given
+ * it, or recorded without it, as when loaded
+ */
+export const isCubeExtendTypingCurrent = (extend, input, upstream) => {
+    const { typing } = extend;
+    const recorded = upstreamOf(typing);
+    return (typing.kind === 'typed' &&
+        extend.currentTyping(input) === typing &&
+        (recorded === undefined || recorded === upstream));
+};
+/**
+ * A query rule for the editor (PLAN §11.7): an Extend whose typing recorded
+ * another input than the engine would be given now waits to be typed again
+ * (`ERR_TYPING`), e.g. after an Extend above it gains `->toOne()`, which
+ * Cube's schema doesn't show. A typing that recorded nothing, as one loaded,
+ * is used as it is; an Extend that already waits, or whose input is invalid,
+ * is left to its own checks.
+ */
+export const createStaleCubeExtendTypingRule = (registry, modelOf) => (query) => {
+    const stale = new Map();
+    const model = modelOf();
+    const recorded = query.nodes.filter((node) => node instanceof Extend && upstreamOf(node.typing) !== undefined);
+    if (!model || !recorded.length) {
+        return stale;
+    }
+    const { validity } = buildSchemasAndValidity(query, registry.queryRules);
+    const emitter = new QueryEmitter(query, registry);
+    recorded.forEach((node) => {
+        if ((validity.get(node.id) ?? []).some(isTypingError)) {
+            return;
+        }
+        const upstream = getCubeExtendUpstream(emitter, node.id, model);
+        if (upstream !== undefined && upstream !== upstreamOf(node.typing)) {
+            stale.set(node.id, [ERR_TYPING]);
+        }
+    });
+    return stale;
+};
+/**
+ * The typing the engine's answers give, for this input and these columns:
+ * every column's type, from the whole chain, else the first column whose
+ * chain fails, with the engine's error (a network failure on none)
+ */
+export const readCubeExtendTyping = (answers, extend, input, columns, upstream) => {
+    const signature = getExtendSignature(input, extend.columns);
+    const whole = answers.get(keyOf(extend.id, columns.length));
+    if (whole !== undefined && !(whole instanceof CubeEngineError)) {
+        return {
+            typing: {
+                kind: 'typed',
+                signature,
+                types: whole.columns
+                    .slice(-columns.length)
+                    .map((column) => column.type),
+                upstream,
+            },
+        };
+    }
+    const failing = columns.findIndex((_, index) => answers.get(keyOf(extend.id, index + 1)) instanceof CubeEngineError);
+    const error = answers.get(keyOf(extend.id, failing + 1)) ??
+        new CubeEngineError(CubeEngineErrorKind.NETWORK, 'The engine gave no type for these columns', extend.id);
+    return {
+        typing: {
+            kind: 'failed',
+            signature,
+            message: withoutEngineContext(error.detail),
+            column: failing < 0 || error.kind === CubeEngineErrorKind.NETWORK
+                ? undefined
+                : failing,
+            upstream,
+        },
+        error,
+    };
+};
+/**
+ * Whether two typings say the same: the same kind, signature and input as
+ * the engine was given it, and the same types, or the same failure
+ */
+export const isSameCubeExtendTyping = (a, b) => {
+    if (upstreamOf(a) !== upstreamOf(b)) {
+        return false;
+    }
+    if (a.kind === 'typed' && b.kind === 'typed') {
+        return (a.signature === b.signature &&
+            a.types.length === b.types.length &&
+            a.types.every((type, index) => {
+                const other = b.types[index];
+                return other !== undefined && type.equals(other);
+            }));
+    }
+    if (a.kind === 'failed' && b.kind === 'failed') {
+        return (a.signature === b.signature &&
+            a.message === b.message &&
+            a.column === b.column);
+    }
+    return a.kind === 'unresolved' && b.kind === 'unresolved';
+};
+//# sourceMappingURL=CubeExtendTyping.js.map

package/lib/stores/CubeExtendTyping.js.map

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

package/lib/stores/CubeGridQuickActions.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 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 Schema } from '@finos/legend-cube';
+import type { CubeResultValue } from '../graph-manager/CubeEngine.js';
+import type { CubeEditorState } from './CubeEditorState.js';
+/**
+ * The name of a Group by's Count rows: `Count Rows`, or with a number after it
+ * when an input column already has that name in any case, e.g. on a Group of
+ * a Group (PLAN §11.5)
+ */
+export declare const getGroupByCountName: (schema: Schema) => string;
+/** One of the grid's quick actions on a cell (spec §12.4) */
+export interface CubeGridQuickAction {
+    /** e.g. `Sort by "SHIP_COUNTRY"` */
+    readonly label: string;
+    /** Why it can't be used, its tooltip then; `undefined` when it can */
+    readonly disabledReason: string | undefined;
+    /** A note shown as its tooltip when it can be used, e.g. on comparing floats */
+    readonly hint: string | undefined;
+    /** Adds its node after the node that runs, as one undo step; nothing runs */
+    readonly apply: () => void;
+}
+/**
+ * The quick actions on a cell of the shown rows (spec §12.4, PLAN §11.4 and
+ * §11.5): "Sort by" adds an ascending Sort on the cell's column, "Group by" a
+ * Group by it with Count rows, and "Filter by" an Equal on its value (Is
+ * Empty on a null), after the node that runs, which they replace as the node
+ * that runs. All need the rows to be from the current query, no run in
+ * flight, and a cube that can change; "Sort by" and "Group by" a type that
+ * compares, and "Filter by" a value its column's type can compare.
+ * Read when the menu opens; `[]` when the position is not a column of the
+ * shown rows.
+ */
+export declare const getCubeGridQuickActions: (editorState: CubeEditorState, position: number, cell: CubeResultValue) => CubeGridQuickAction[];
+//# sourceMappingURL=CubeGridQuickActions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeGridQuickActions.d.ts","sourceRoot":"","sources":["../../src/stores/CubeGridQuickActions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAUL,KAAK,MAAM,EAGZ,MAAM,oBAAoB,CAAC;AAM5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,MAAM,KAAG,MAWpD,CAAC;AAEF,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,GAClC,aAAa,eAAe,EAC5B,UAAU,MAAM,EAChB,MAAM,eAAe,KACpB,mBAAmB,EAoGrB,CAAC"}

package/lib/stores/CubeGridQuickActions.js

@@ -0,0 +1,124 @@
+/**
+ * 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 { AggregationFunction, buildQuickFilterRule, FilterOperator, Filter, foldColumnName, getAggregationAutoName, Group, isOperatorAvailable, isSortableType, Sort, TypeFamily, } from '@finos/legend-cube';
+import { CUBE_QUICK_ACTION_DISABLED_REASON, FILTER_FLOAT_COMPARISON_HINT, READ_ONLY_CUBE_TITLE, } from '../__lib__/LegendCubeLabels.js';
+/**
+ * The name of a Group by's Count rows: `Count Rows`, or with a number after it
+ * when an input column already has that name in any case, e.g. on a Group of
+ * a Group (PLAN §11.5)
+ */
+export const getGroupByCountName = (schema) => {
+    const base = getAggregationAutoName(AggregationFunction.COUNT_ROWS, undefined);
+    const taken = new Set(schema.names().map(foldColumnName));
+    let name = base;
+    for (let suffix = 2; taken.has(foldColumnName(name)); suffix += 1) {
+        name = `${base} ${suffix}`;
+    }
+    return name;
+};
+/**
+ * The quick actions on a cell of the shown rows (spec §12.4, PLAN §11.4 and
+ * §11.5): "Sort by" adds an ascending Sort on the cell's column, "Group by" a
+ * Group by it with Count rows, and "Filter by" an Equal on its value (Is
+ * Empty on a null), after the node that runs, which they replace as the node
+ * that runs. All need the rows to be from the current query, no run in
+ * flight, and a cube that can change; "Sort by" and "Group by" a type that
+ * compares, and "Filter by" a value its column's type can compare.
+ * Read when the menu opens; `[]` when the position is not a column of the
+ * shown rows.
+ */
+export const getCubeGridQuickActions = (editorState, position, cell) => {
+    const { execution, document } = editorState;
+    const { result } = execution;
+    const column = result?.schema.columns[position];
+    if (!result || !column) {
+        return [];
+    }
+    const { query } = document;
+    const afterId = query.selected;
+    const typeName = column.type.displayName;
+    const rule = buildQuickFilterRule(column.name, column.type, cell);
+    // what keeps both from being used, in order
+    const blocked = result.query !== query || execution.isStale
+        ? CUBE_QUICK_ACTION_DISABLED_REASON.STALE_ROWS
+        : // choosing would apply the edits first, leaving these rows stale
+            editorState.hasEditsToApply || editorState.nodeEditor.hasPendingInput()
+                ? CUBE_QUICK_ACTION_DISABLED_REASON.EDITING
+                : execution.isRunning
+                    ? CUBE_QUICK_ACTION_DISABLED_REASON.RUNNING
+                    : editorState.readOnly
+                        ? READ_ONLY_CUBE_TITLE
+                        : undefined;
+    const sortReason = blocked ??
+        (isSortableType(column.type)
+            ? undefined
+            : CUBE_QUICK_ACTION_DISABLED_REASON.notSortable(typeName));
+    const groupReason = blocked ??
+        (isSortableType(column.type)
+            ? undefined
+            : CUBE_QUICK_ACTION_DISABLED_REASON.notGroupable(typeName));
+    const filterReason = blocked ??
+        (rule
+            ? undefined
+            : isOperatorAvailable(FilterOperator.EQUAL, column.type)
+                ? CUBE_QUICK_ACTION_DISABLED_REASON.UNREADABLE_VALUE
+                : CUBE_QUICK_ACTION_DISABLED_REASON.notComparable(typeName));
+    return [
+        {
+            label: `Sort by "${column.name}"`,
+            disabledReason: sortReason,
+            hint: undefined,
+            apply: () => {
+                // as the menu found it: nothing changed since it opened
+                if (sortReason === undefined && editorState.document === document) {
+                    editorState.addConfiguredNode(Sort.byColumn(query.generateId(Sort.TYPE), column.name), afterId);
+                }
+            },
+        },
+        {
+            label: `Group by "${column.name}"`,
+            disabledReason: groupReason,
+            hint: undefined,
+            apply: () => {
+                if (groupReason === undefined && editorState.document === document) {
+                    editorState.addConfiguredNode(new Group(query.generateId(Group.TYPE), [column.name], [
+                        {
+                            column: undefined,
+                            function: AggregationFunction.COUNT_ROWS,
+                            name: getGroupByCountName(result.schema),
+                        },
+                    ]), afterId);
+                }
+            },
+        },
+        {
+            label: `Filter by "${column.name}"`,
+            disabledReason: filterReason,
+            hint: rule?.operator === FilterOperator.EQUAL &&
+                column.type.family === TypeFamily.FLOAT
+                ? FILTER_FLOAT_COMPARISON_HINT
+                : undefined,
+            apply: () => {
+                if (filterReason === undefined &&
+                    rule &&
+                    editorState.document === document) {
+                    editorState.addConfiguredNode(new Filter(query.generateId(Filter.TYPE), rule), afterId);
+                }
+            },
+        },
+    ];
+};
+//# sourceMappingURL=CubeGridQuickActions.js.map

package/lib/stores/CubeGridQuickActions.js.map

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

package/lib/stores/CubeHost.d.ts

@@ -14,7 +14,12 @@
  * limitations under the License.
  */
 import type { GenericLegendApplicationStore } from '@finos/legend-application';
-import type { CubeEngine } from '../graph-manager/CubeEngine.js';
+import type { ModelContext } from '@finos/legend-cube';
+import type { CubeConnectionExplorer } from '../graph-manager/CubeConnectionExplorer.js';
+import type { CubeDataProductCatalog } from '../graph-manager/CubeDataProductCatalog.js';
+import type { CubeIngestCatalog } from '../graph-manager/CubeIngestCatalog.js';
+import { type CubeEngine, type CubeModelOutline } from '../graph-manager/CubeEngine.js';
+import type { CubeProjectCatalog } from '../graph-manager/CubeProjectCatalog.js';
 import type { LocalModelCatalog } from './LocalModelCatalog.js';
 /**
  * What the application hosting the Cube page gives it (PLAN §3.5, Settled
@@ -27,5 +32,31 @@ export interface CubeHost {
     readonly applicationStore: GenericLegendApplicationStore;
     readonly engine: CubeEngine;
     readonly modelCatalog: LocalModelCatalog;
+    /**
+     * Reads the databases behind direct connections (PLAN §6.8); without one,
+     * the source picker offers no database connection
+     */
+    readonly connectionExplorer?: CubeConnectionExplorer | undefined;
+    /**
+     * The deployed data products (PLAN §6.8); without one, the source dialog
+     * offers no data products
+     */
+    readonly dataProductCatalog?: CubeDataProductCatalog | undefined;
+    /**
+     * The deployed ingest definitions (PLAN §6.7); without one, the source
+     * dialog offers no ingest data sets
+     */
+    readonly ingestCatalog?: CubeIngestCatalog | undefined;
+    /**
+     * The published projects in the host's depot (PLAN §6.3); without one, the
+     * source dialog offers no projects
+     */
+    readonly projectCatalog?: CubeProjectCatalog | undefined;
 }
+/**
+ * A model's databases and runtimes, wherever its kind keeps them: a
+ * project's in the host's depot (PLAN §6.3), any other through the model
+ * catalog's engine
+ */
+export declare const loadCubeModelOutline: (host: CubeHost, model: ModelContext) => Promise<CubeModelOutline>;
 //# sourceMappingURL=CubeHost.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"CubeHost.d.ts","sourceRoot":"","sources":["../../src/stores/CubeHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,gBAAgB,EAAE,6BAA6B,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;CAC1C"}
+{"version":3,"file":"CubeHost.d.ts","sourceRoot":"","sources":["../../src/stores/CubeHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACtB,MAAM,gCAAgC,CAAC;AAMxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,gBAAgB,EAAE,6BAA6B,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;IACjE;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;IACjE;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACvD;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CAC1D;AAMD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,QAAQ,EACd,OAAO,YAAY,KAClB,OAAO,CAAC,gBAAgB,CAqB1B,CAAC"}

package/lib/stores/CubeHost.js

@@ -13,5 +13,25 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export {};
+import { CubeEngineError, CubeEngineErrorKind, } from '../graph-manager/CubeEngine.js';
+import { checkCubeProjectModel, getCubeProjectCoordinates, isCubeProjectModel, } from '../graph-manager/CubeProject.js';
+/** Why the host can't list a project model's Databases */
+const NO_PROJECT_CATALOG = "This page can't read published projects: its host has no depot";
+/**
+ * A model's databases and runtimes, wherever its kind keeps them: a
+ * project's in the host's depot (PLAN §6.3), any other through the model
+ * catalog's engine
+ */
+export const loadCubeModelOutline = (host, model) => {
+    if (!isCubeProjectModel(model)) {
+        return host.modelCatalog.loadOutline(model);
+    }
+    const project = getCubeProjectCoordinates(model);
+    if (!project) {
+        return Promise.reject(new CubeEngineError(CubeEngineErrorKind.UNSUPPORTED_MODEL, checkCubeProjectModel(model).join('\n')));
+    }
+    return host.projectCatalog
+        ? host.projectCatalog.loadOutline(project)
+        : Promise.reject(new CubeEngineError(CubeEngineErrorKind.UNSUPPORTED_MODEL, NO_PROJECT_CATALOG));
+};
 //# sourceMappingURL=CubeHost.js.map

package/lib/stores/CubeHost.js.map

@@ -1 +1 @@
-{"version":3,"file":"CubeHost.js","sourceRoot":"","sources":["../../src/stores/CubeHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}
+{"version":3,"file":"CubeHost.js","sourceRoot":"","sources":["../../src/stores/CubeHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,EACL,eAAe,EACf,mBAAmB,GAGpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,iCAAiC,CAAC;AAqCzC,0DAA0D;AAC1D,MAAM,kBAAkB,GACtB,gEAAgE,CAAC;AAEnE;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,IAAc,EACd,KAAmB,EACQ,EAAE;IAC7B,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,eAAe,CACjB,mBAAmB,CAAC,iBAAiB,EACrC,qBAAqB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACxC,CACF,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC,cAAc;QACxB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC;QAC1C,CAAC,CAAC,OAAO,CAAC,MAAM,CACZ,IAAI,eAAe,CACjB,mBAAmB,CAAC,iBAAiB,EACrC,kBAAkB,CACnB,CACF,CAAC;AACR,CAAC,CAAC"}

package/lib/stores/CubeIngestRecheck.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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 { IngestDatasetSource, ModelContext, Schema } from '@finos/legend-cube';
+import { CubeEngineError, type NodeId } from '../graph-manager/CubeEngine.js';
+import type { CubeIngestCatalog } from '../graph-manager/CubeIngestCatalog.js';
+/**
+ * Reads an ingest cube's data sets again (PLAN §6.7): their columns as their
+ * deployed definitions declare them, through the catalog, with no engine
+ * call; `fresh` reads the definitions again rather than what this page visit
+ * read. One answer per source, failures included; never rejects.
+ */
+export declare const recheckCubeIngestSources: (catalog: CubeIngestCatalog | undefined, model: ModelContext, sources: readonly IngestDatasetSource[], fresh?: boolean) => Promise<Map<NodeId, Schema | CubeEngineError>>;
+//# sourceMappingURL=CubeIngestRecheck.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeIngestRecheck.d.ts","sourceRoot":"","sources":["../../src/stores/CubeIngestRecheck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,YAAY,EACZ,MAAM,EACP,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EAEf,KAAK,MAAM,EACZ,MAAM,gCAAgC,CAAC;AAKxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE/E;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,SAAS,iBAAiB,GAAG,SAAS,EACtC,OAAO,YAAY,EACnB,SAAS,SAAS,mBAAmB,EAAE,EACvC,eAAa,KACZ,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,CA+C/C,CAAC"}

package/lib/stores/CubeIngestRecheck.js

@@ -0,0 +1,53 @@
+/**
+ * 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_INGEST_RECHECK_MESSAGE } from '../__lib__/LegendCubeIngestLabels.js';
+import { CubeEngineError, CubeEngineErrorKind, } from '../graph-manager/CubeEngine.js';
+import { checkCubeIngestModel, getCubeIngestSettings, } from '../graph-manager/CubeIngest.js';
+/**
+ * Reads an ingest cube's data sets again (PLAN §6.7): their columns as their
+ * deployed definitions declare them, through the catalog, with no engine
+ * call; `fresh` reads the definitions again rather than what this page visit
+ * read. One answer per source, failures included; never rejects.
+ */
+export const recheckCubeIngestSources = async (catalog, model, sources, fresh = false) => {
+    const failAll = (kind, detail) => new Map(sources.map((source) => [
+        source.id,
+        new CubeEngineError(kind, detail, source.id),
+    ]));
+    if (!catalog) {
+        return failAll(CubeEngineErrorKind.UNSUPPORTED_MODEL, CUBE_INGEST_RECHECK_MESSAGE.NO_CATALOG);
+    }
+    const settings = getCubeIngestSettings(model);
+    if (!settings) {
+        return failAll(CubeEngineErrorKind.UNSUPPORTED_MODEL, checkCubeIngestModel(model).join('\n'));
+    }
+    try {
+        return await catalog.resolveSchemas(settings.environmentType, new Map(sources.map((source) => [
+            source.id,
+            {
+                ingestDefinitionUrn: source.ingestDefinitionUrn,
+                ingestDefinition: source.ingestDefinition,
+                dataSet: source.dataSet,
+            },
+        ])), { fresh });
+    }
+    catch (error) {
+        return error instanceof CubeEngineError
+            ? failAll(error.kind, error.detail)
+            : failAll(CubeEngineErrorKind.NETWORK, error instanceof Error ? error.message : String(error));
+    }
+};
+//# sourceMappingURL=CubeIngestRecheck.js.map

package/lib/stores/CubeIngestRecheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeIngestRecheck.js","sourceRoot":"","sources":["../../src/stores/CubeIngestRecheck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EACL,eAAe,EACf,mBAAmB,GAEpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,gCAAgC,CAAC;AAGxC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,EAC3C,OAAsC,EACtC,KAAmB,EACnB,OAAuC,EACvC,KAAK,GAAG,KAAK,EACmC,EAAE;IAClD,MAAM,OAAO,GAAG,CACd,IAAyB,EACzB,MAAc,EACyB,EAAE,CACzC,IAAI,GAAG,CACL,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QACtB,MAAM,CAAC,EAAE;QACT,IAAI,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;KAC7C,CAAC,CACH,CAAC;IACJ,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,OAAO,CACZ,mBAAmB,CAAC,iBAAiB,EACrC,2BAA2B,CAAC,UAAU,CACvC,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,OAAO,CACZ,mBAAmB,CAAC,iBAAiB,EACrC,oBAAoB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACvC,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,cAAc,CACjC,QAAQ,CAAC,eAAe,EACxB,IAAI,GAAG,CACL,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACtB,MAAM,CAAC,EAAE;YACT;gBACE,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;gBAC/C,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;gBACzC,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB;SACF,CAAC,CACH,EACD,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,KAAK,YAAY,eAAe;YACrC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACnC,CAAC,CAAC,OAAO,CACL,mBAAmB,CAAC,OAAO,EAC3B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;IACR,CAAC;AACH,CAAC,CAAC"}