@finos/legend-cube-builder 0.0.3 → 0.0.5

package/lib/stores/CubeExtendTyping.js

@@ -0,0 +1,149 @@
+/**
+ * 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 { colSpec, colSpecArray, EmitRole, func, getExtendSignature, hashText, 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 a node's input when it types an Extend or
+ * checks a Filter by Expression, digested (PLAN §11.7, §11.11): the input's
+ * relation as emitted, and the model. A typing or a check 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));
+};
+/**
+ * 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/CubeFunctionRecheck.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 FunctionSource, type IR, type ModelContext, type Schema } from '@finos/legend-cube';
+import { CubeEngineError, type CubeEngine, type NodeId } from '../graph-manager/CubeEngine.js';
+/**
+ * The lambda that types a function source, `{| sales::ordersAbove(…)}`: its
+ * values where they are valid, else a placeholder of the parameter's type, or
+ * `[]` for an empty optional one
+ */
+export declare const buildCubeFunctionTypingLambda: (source: FunctionSource) => IR;
+/**
+ * Types a cube's functions again with the engine (PLAN §6.5), in one call:
+ * their columns as the engine types the call. One answer per source,
+ * failures included; never rejects.
+ */
+export declare const recheckCubeFunctionSources: (engine: CubeEngine, model: ModelContext, sources: readonly FunctionSource[]) => Promise<Map<NodeId, Schema | CubeEngineError>>;
+//# sourceMappingURL=CubeFunctionRecheck.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeFunctionRecheck.d.ts","sourceRoot":"","sources":["../../src/stores/CubeFunctionRecheck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAGL,KAAK,cAAc,EAEnB,KAAK,EAAE,EAGP,KAAK,YAAY,EACjB,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EAEf,KAAK,UAAU,EACf,KAAK,MAAM,EACZ,MAAM,gCAAgC,CAAC;AAcxC;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,GAAI,QAAQ,cAAc,KAAG,EAatE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,QAAQ,UAAU,EAClB,OAAO,YAAY,EACnB,SAAS,SAAS,cAAc,EAAE,KACjC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC,CAqB/C,CAAC"}

package/lib/stores/CubeFunctionRecheck.js

@@ -0,0 +1,67 @@
+/**
+ * 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 { emitFunctionSource, getLiteralKinds, lambda, } from '@finos/legend-cube';
+import { CubeEngineError, CubeEngineErrorKind, } from '../graph-manager/CubeEngine.js';
+/** A value of each kind, which only types the call: a function's columns don't depend on its values */
+const PLACEHOLDERS = {
+    string: { kind: 'string', value: '' },
+    boolean: { kind: 'boolean', value: false },
+    integer: { kind: 'integer', value: '0' },
+    float: { kind: 'float', value: '0' },
+    decimal: { kind: 'decimal', value: '0' },
+    strictDate: { kind: 'strictDate', value: '2000-01-01' },
+    dateTime: { kind: 'dateTime', value: '2000-01-01T00:00:00' },
+    enum: { kind: 'enum', value: '' },
+};
+/**
+ * The lambda that types a function source, `{| sales::ordersAbove(…)}`: its
+ * values where they are valid, else a placeholder of the parameter's type, or
+ * `[]` for an empty optional one
+ */
+export const buildCubeFunctionTypingLambda = (source) => {
+    const values = source.parameters.map((parameter, index) => {
+        const value = source.values[index];
+        if (value !== undefined && value.kind !== 'invalid') {
+            return value;
+        }
+        if (value === undefined && parameter.optional) {
+            return undefined;
+        }
+        const [kind] = getLiteralKinds(parameter.type);
+        return kind ? PLACEHOLDERS[kind] : undefined;
+    });
+    return lambda([], [emitFunctionSource(source.withValues(values))]);
+};
+/**
+ * Types a cube's functions again with the engine (PLAN §6.5), in one call:
+ * their columns as the engine types the call. One answer per source,
+ * failures included; never rejects.
+ */
+export const recheckCubeFunctionSources = async (engine, model, sources) => {
+    try {
+        return await engine.typeLambdas(model, new Map(sources.map((source) => [
+            source.id,
+            buildCubeFunctionTypingLambda(source),
+        ])));
+    }
+    catch (error) {
+        const failure = error instanceof CubeEngineError
+            ? error
+            : new CubeEngineError(CubeEngineErrorKind.NETWORK, error instanceof Error ? error.message : String(error));
+        return new Map(sources.map((source) => [source.id, failure]));
+    }
+};
+//# sourceMappingURL=CubeFunctionRecheck.js.map

package/lib/stores/CubeFunctionRecheck.js.map

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

package/lib/stores/CubeGridFetcher.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 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 ColumnDirection, type DrilldownCell, type DrilldownLevel } from '@finos/legend-cube';
+import { type CubeResultValue } from '../graph-manager/CubeEngine.js';
+import type { CubeEditorState } from './CubeEditorState.js';
+import type { CubeExecutionResult } from './CubeExecutionState.js';
+/** A row of a level, by the run's column positions */
+export interface CubeGridRow {
+    /** Each run column's value, `undefined` where the level shows none (a group row's column with no aggregation) */
+    readonly cells: readonly (CubeResultValue | undefined)[];
+    /** On a group row, how many of the run's rows the group holds */
+    readonly count?: number | undefined;
+}
+/** The rows of one level of the grid: the run's rows, or groups of them */
+export interface CubeGridLevelRows {
+    readonly level: DrilldownLevel;
+    readonly rows: readonly CubeGridRow[];
+    /** The engine returned more than the run's row limit */
+    readonly limited: boolean;
+}
+/** An answer for rows the grid no longer shows: a newer run, or the grid purged its rows; it is dropped */
+export declare class CubeGridFetchDropped extends Error {
+    constructor();
+}
+/** The most rows the cache holds across its levels; the oldest levels go first (PLAN §11.10) */
+export declare const MAX_CUBE_GRID_CACHED_ROWS = 200000;
+export declare const CUBE_GRID_CONTEXT_CHANGED = "The cube's model, runtime or warehouse changed since this run: execute again to see more of its rows.";
+/**
+ * Fetches the levels of the grid's server-side mode (PLAN §11.10): each a
+ * query derived from the run on screen, never the live cube, with the
+ * drill-down the cube has now and the grid's sort, run as Execute runs
+ * (`runCubeQuery`), with the run's model, runtime and row limit. Answers are
+ * cached by the derived query, the oldest dropped past
+ * `MAX_CUBE_GRID_CACHED_ROWS` rows. `purge()` drops them all, aborts the
+ * fetches in flight and drops their answers, as a new run does.
+ */
+export declare class CubeGridFetcher {
+    readonly editorState: CubeEditorState;
+    /** The most rows the cache holds */
+    readonly maxCachedRows: number;
+    /** Bumped by each purge: an answer of an older generation is dropped */
+    private generation;
+    private resultId;
+    /** In the order last used, the oldest first */
+    private readonly cache;
+    private readonly controllers;
+    constructor(editorState: CubeEditorState, maxCachedRows?: number);
+    /** How many rows the cache holds */
+    get cachedRows(): number;
+    /** Drops every cached level, and aborts the fetches in flight, whose answers are then dropped */
+    purge(): void;
+    /**
+     * The rows of the level under the expanded groups' keys (outermost first;
+     * none for the top level), sorted by the grid. Rejects with a
+     * `CubeEngineError`, or a `CubeGridFetchDropped` when the answer is for rows
+     * the grid no longer shows.
+     */
+    fetchLevel(result: CubeExecutionResult, keys: readonly DrilldownCell[], sorts: readonly ColumnDirection[]): Promise<CubeGridLevelRows>;
+    /** Drops the least recently used levels until the cache holds at most its rows, never the one just answered */
+    private evict;
+}
+//# sourceMappingURL=CubeGridFetcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeGridFetcher.d.ts","sourceRoot":"","sources":["../../src/stores/CubeGridFetcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAGL,KAAK,eAAe,EAEpB,KAAK,aAAa,EAClB,KAAK,cAAc,EAIpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAGnE,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,iHAAiH;IACjH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,EAAE,CAAC;IACzD,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;IACtC,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,2GAA2G;AAC3G,qBAAa,oBAAqB,SAAQ,KAAK;;CAK9C;AAED,gGAAgG;AAChG,eAAO,MAAM,yBAAyB,SAAU,CAAC;AAEjD,eAAO,MAAM,yBAAyB,0GACmE,CAAC;AAkC1G;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,oCAAoC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,wEAAwE;IACxE,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAqB;IACrC,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8B;gBAGxD,WAAW,EAAE,eAAe,EAC5B,aAAa,SAA4B;IAM3C,oCAAoC;IACpC,IAAI,UAAU,IAAI,MAAM,CAKvB;IAED,iGAAiG;IACjG,KAAK,IAAI,IAAI;IAOb;;;;;OAKG;IACH,UAAU,CACR,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,SAAS,aAAa,EAAE,EAC9B,KAAK,EAAE,SAAS,eAAe,EAAE,GAChC,OAAO,CAAC,iBAAiB,CAAC;IAyI7B,+GAA+G;IAC/G,OAAO,CAAC,KAAK;CAUd"}

package/lib/stores/CubeGridFetcher.js

@@ -0,0 +1,197 @@
+/**
+ * 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, checkDrilldown, deriveDrilldownLevel, printIR, QueryEmitter, SortDirection, } from '@finos/legend-cube';
+import { NULL_CELL_TEXT } from '../__lib__/LegendCubeLabels.js';
+import { CubeEngineError, CubeEngineErrorKind, } from '../graph-manager/CubeEngine.js';
+import { runCubeQuery } from './CubeQueryRun.js';
+/** An answer for rows the grid no longer shows: a newer run, or the grid purged its rows; it is dropped */
+export class CubeGridFetchDropped extends Error {
+    constructor() {
+        super('The rows were asked for by a grid that no longer shows them');
+        this.name = 'CubeGridFetchDropped';
+    }
+}
+/** The most rows the cache holds across its levels; the oldest levels go first (PLAN §11.10) */
+export const MAX_CUBE_GRID_CACHED_ROWS = 200_000;
+export const CUBE_GRID_CONTEXT_CHANGED = "The cube's model, runtime or warehouse changed since this run: execute again to see more of its rows.";
+/** How a fetch is shown in the run stats, e.g. `Rows of SHIP_COUNTRY "France"` */
+const describeFetch = (level, keys, levels, sorts) => {
+    const of = keys
+        .map((key, index) => `${levels[index]} ${key === null ? NULL_CELL_TEXT : JSON.stringify(String(key))}`)
+        .join(', ');
+    const sorted = sorts
+        .map(({ column, direction }) => `${column} ${direction === SortDirection.DESC ? 'descending' : 'ascending'}`)
+        .join(', ');
+    return [
+        level.isLeaf ? 'Rows' : `Groups by ${level.groupColumns.at(-1)}`,
+        of ? ` of ${of}` : '',
+        sorted ? `, sorted by ${sorted}` : '',
+    ].join('');
+};
+/**
+ * Fetches the levels of the grid's server-side mode (PLAN §11.10): each a
+ * query derived from the run on screen, never the live cube, with the
+ * drill-down the cube has now and the grid's sort, run as Execute runs
+ * (`runCubeQuery`), with the run's model, runtime and row limit. Answers are
+ * cached by the derived query, the oldest dropped past
+ * `MAX_CUBE_GRID_CACHED_ROWS` rows. `purge()` drops them all, aborts the
+ * fetches in flight and drops their answers, as a new run does.
+ */
+export class CubeGridFetcher {
+    editorState;
+    /** The most rows the cache holds */
+    maxCachedRows;
+    /** Bumped by each purge: an answer of an older generation is dropped */
+    generation = 0;
+    resultId;
+    /** In the order last used, the oldest first */
+    cache = new Map();
+    controllers = new Set();
+    constructor(editorState, maxCachedRows = MAX_CUBE_GRID_CACHED_ROWS) {
+        this.editorState = editorState;
+        this.maxCachedRows = maxCachedRows;
+    }
+    /** How many rows the cache holds */
+    get cachedRows() {
+        return Array.from(this.cache.values()).reduce((total, cached) => total + cached.rows, 0);
+    }
+    /** Drops every cached level, and aborts the fetches in flight, whose answers are then dropped */
+    purge() {
+        this.generation += 1;
+        this.cache.clear();
+        this.controllers.forEach((controller) => controller.abort());
+        this.controllers.clear();
+    }
+    /**
+     * The rows of the level under the expanded groups' keys (outermost first;
+     * none for the top level), sorted by the grid. Rejects with a
+     * `CubeEngineError`, or a `CubeGridFetchDropped` when the answer is for rows
+     * the grid no longer shows.
+     */
+    fetchLevel(result, keys, sorts) {
+        if (result.id !== this.resultId) {
+            this.purge();
+            this.resultId = result.id;
+        }
+        const { editorState } = this;
+        const model = result.context?.model;
+        const runtime = result.context?.runtime;
+        const captureId = result.query.selected;
+        if (!model || !runtime || captureId === undefined) {
+            return Promise.reject(new Error('A run has a model, a runtime and a node'));
+        }
+        // the warehouse is read from the page when the query runs, so a fetch
+        // under another one would run the run's query elsewhere
+        if (result.context !== editorState.document.context ||
+            result.warehouse !== editorState.dataProductRuntime.effectiveWarehouse) {
+            return Promise.reject(new CubeEngineError(CubeEngineErrorKind.EXECUTION, CUBE_GRID_CONTEXT_CHANGED, captureId));
+        }
+        let level;
+        const drilldown = checkDrilldown(editorState.document.meta.drilldown ?? { columns: [], aggregations: [] }, result.schema);
+        try {
+            level = deriveDrilldownLevel({
+                query: result.query,
+                captureId,
+                schema: result.schema,
+                drilldown,
+                keys,
+                sorts,
+            });
+        }
+        catch (error) {
+            return Promise.reject(new CubeEngineError(CubeEngineErrorKind.EXECUTION, error instanceof Error ? error.message : String(error), captureId));
+        }
+        const runId = level.query.selected;
+        // Cube's own checks first, so the engine never gets a query Cube knows is wrong
+        const { schemas, validity } = buildSchemasAndValidity(level.query, editorState.registry.queryRules);
+        const problem = (validity.get(runId) ?? [])[0];
+        const schema = schemas.get(runId);
+        if (problem !== undefined || !schema) {
+            return Promise.reject(new CubeEngineError(CubeEngineErrorKind.EXECUTION, `These rows can't be fetched: ${problem ?? 'the query has no columns'}`, captureId));
+        }
+        // the whole run, so a sort the row order keeps is in it
+        const key = printIR(new QueryEmitter(level.query, editorState.registry).emitExecutionLambda({
+            rowLimit: result.rowLimit,
+            runtime,
+        }));
+        const cached = this.cache.get(key);
+        if (cached) {
+            // last used now
+            this.cache.delete(key);
+            this.cache.set(key, cached);
+            return cached.promise;
+        }
+        const generation = this.generation;
+        const controller = new AbortController();
+        this.controllers.add(controller);
+        const entry = {
+            rows: 0,
+            promise: runCubeQuery(editorState, {
+                query: level.query,
+                model,
+                runtime,
+                schema,
+                rowLimit: result.rowLimit,
+                abortController: controller,
+                label: describeFetch(level, keys, drilldown.columns, sorts),
+            })
+                .then((run) => {
+                if (generation !== this.generation) {
+                    throw new CubeGridFetchDropped();
+                }
+                const positions = result.schema.columns.map(({ name }) => {
+                    const output = level.columns.get(name);
+                    return output === undefined
+                        ? -1
+                        : schema.columns.findIndex((column) => column.name === output);
+                });
+                const countAt = level.countColumn
+                    ? schema.columns.findIndex((column) => column.name === level.countColumn)
+                    : -1;
+                const rows = run.rows.map((row) => ({
+                    cells: positions.map((position) => position === -1 ? undefined : (row[position] ?? null)),
+                    ...(countAt === -1 ? {} : { count: Number(row[countAt]) }),
+                }));
+                entry.rows = rows.length;
+                this.evict(key);
+                return { level, rows, limited: run.limited };
+            })
+                .catch((error) => {
+                if (this.cache.get(key) === entry) {
+                    this.cache.delete(key);
+                }
+                throw generation !== this.generation
+                    ? new CubeGridFetchDropped()
+                    : error;
+            })
+                .finally(() => this.controllers.delete(controller)),
+        };
+        this.cache.set(key, entry);
+        return entry.promise;
+    }
+    /** Drops the least recently used levels until the cache holds at most its rows, never the one just answered */
+    evict(keep) {
+        for (const [key] of this.cache) {
+            if (this.cachedRows <= this.maxCachedRows) {
+                return;
+            }
+            if (key !== keep) {
+                this.cache.delete(key);
+            }
+        }
+    }
+}
+//# sourceMappingURL=CubeGridFetcher.js.map

package/lib/stores/CubeGridFetcher.js.map

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

package/lib/stores/CubeGridQuickActions.d.ts

@@ -13,8 +13,15 @@
  * 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"` */
@@ -26,15 +33,28 @@ export interface CubeGridQuickAction {
     /** Adds its node after the node that runs, as one undo step; nothing runs */
     readonly apply: () => void;
 }
+/** What a cell of the grid holds */
+export declare enum CubeGridCellKind {
+    /** A run row's value, or a group row's key */
+    VALUE = "value",
+    /** A group row's aggregation of its rows' values (PLAN §11.10) */
+    AGGREGATE = "aggregate",
+    /** A group row's column with no aggregation: nothing */
+    EMPTY = "empty"
+}
 /**
- * The quick actions on a cell of the shown rows (spec §12.4, PLAN §11.4):
- * "Sort by" adds an ascending Sort on the cell's column, 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. Both need the rows to be from the
- * current query, no run in flight, and a cube that can change; "Sort by" a
- * type that sorts, and "Filter by" a value its column's type can compare.
+ * The quick actions on a cell of the shown rows (spec §12.4, PLAN §11.4,
+ * §11.5 and §11.10): "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; on a float, In the value and its 32-bit value
+ * when they differ, so a `REAL` value is found, as a drill-down's key is,
+ * PLAN §11.14), after the node that runs, which they replace as
+ * the node that runs; a group row's cell other than its key has no value of a
+ * row, so "Filter by" is disabled there. 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[];
+export declare const getCubeGridQuickActions: (editorState: CubeEditorState, position: number, cell: CubeResultValue, cellKind?: CubeGridCellKind) => CubeGridQuickAction[];
 //# sourceMappingURL=CubeGridQuickActions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"CubeGridQuickActions.d.ts","sourceRoot":"","sources":["../../src/stores/CubeGridQuickActions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgBH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,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;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAClC,aAAa,eAAe,EAC5B,UAAU,MAAM,EAChB,MAAM,eAAe,KACpB,mBAAmB,EAqErB,CAAC"}
+{"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,oCAAoC;AACpC,oBAAY,gBAAgB;IAC1B,8CAA8C;IAC9C,KAAK,UAAU;IACf,kEAAkE;IAClE,SAAS,cAAc;IACvB,wDAAwD;IACxD,KAAK,UAAU;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB,GAClC,aAAa,eAAe,EAC5B,UAAU,MAAM,EAChB,MAAM,eAAe,EACrB,2BAAiC,KAChC,mBAAmB,EA4GrB,CAAC"}