@finos/legend-cube-builder 0.0.3 → 0.0.5

package/lib/stores/CubeExamples.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 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 { CubeDocument, type ModelContext } from '@finos/legend-cube';
+export interface CubeExample {
+    readonly id: string;
+    /** The id of the dataset it reads */
+    readonly dataset: string;
+    readonly name: string;
+    /** One line on what it shows */
+    readonly description: string;
+    /** A new cube, ready to open */
+    createDocument(): CubeDocument;
+}
+/** A bundled model the examples read: a new cube can start on it too */
+export interface CubeExampleDataset {
+    readonly id: string;
+    readonly name: string;
+    /** One line on what it holds */
+    readonly description: string;
+    /** Its tables, as the Model tab lists them */
+    readonly tables: readonly string[];
+    readonly model: ModelContext;
+    readonly runtime: string;
+    readonly database: string;
+    readonly schema: string;
+}
+/** The datasets, in the order the examples show them */
+export declare const CUBE_EXAMPLE_DATASETS: readonly CubeExampleDataset[];
+export declare const CUBE_EXAMPLES: readonly CubeExample[];
+//# sourceMappingURL=CubeExamples.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeExamples.d.ts","sourceRoot":"","sources":["../../src/stores/CubeExamples.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAOL,YAAY,EAOZ,KAAK,YAAY,EAUlB,MAAM,oBAAoB,CAAC;AA8B5B,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gCAAgC;IAChC,cAAc,IAAI,YAAY,CAAC;CAChC;AAED,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAgDD,wDAAwD;AACxD,eAAO,MAAM,qBAAqB,EAAE,SAAS,kBAAkB,EACZ,CAAC;AA+CpD,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EA+U9C,CAAC"}

package/lib/stores/CubeExamples.js

@@ -0,0 +1,333 @@
+/**
+ * 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, Pivot, ColumnComparisonFilter, CompositeFilter, CompositeFilterOperator, Connection, CubeDocument, Filter, FilterOperator, Group, Join, JoinType, Limit, Partition, Query, Rename, RelationalTableSource, Restrict, Sort, SortDirection, WindowRankFunction, } from '@finos/legend-cube';
+import { CUBE_NORTHWIND_DATABASE, CUBE_NORTHWIND_SAMPLE_MODEL, CUBE_NORTHWIND_RUNTIME, } from './fixtures/CubeNorthwindModel.js';
+import { CUBE_SPORTS_DATABASE, CUBE_SPORTS_MODEL, CUBE_SPORTS_RUNTIME, CUBE_SPORTS_SCHEMA, } from './fixtures/CubeSportsModel.js';
+import { CUBE_TRADES_DATABASE, CUBE_TRADES_MODEL, CUBE_TRADES_RUNTIME, CUBE_TRADES_SCHEMA, } from './fixtures/CubeTradesModel.js';
+import { CUBE_SALES_DATABASE, CUBE_SALES_MODEL, CUBE_SALES_RUNTIME, CUBE_SALES_SCHEMA, } from './fixtures/CubeSalesDuckDbModel.js';
+const NORTHWIND = {
+    id: 'northwind',
+    name: 'Northwind',
+    description: 'A small trading company: its orders, customers, products and employees',
+    tables: ['ORDERS', 'CUSTOMERS', 'PRODUCTS', 'CATEGORIES', 'EMPLOYEES', '…'],
+    model: CUBE_NORTHWIND_SAMPLE_MODEL,
+    runtime: CUBE_NORTHWIND_RUNTIME,
+    database: CUBE_NORTHWIND_DATABASE,
+    schema: 'NORTHWIND',
+};
+const SPORTS = {
+    id: 'sports',
+    name: 'Sports',
+    description: 'Made-up events of 2025 in ten sports, with viewers and attendance by region',
+    tables: ['EVENTS', 'SPORTS'],
+    model: CUBE_SPORTS_MODEL,
+    runtime: CUBE_SPORTS_RUNTIME,
+    database: CUBE_SPORTS_DATABASE,
+    schema: CUBE_SPORTS_SCHEMA,
+};
+const TRADES = {
+    id: 'trades',
+    name: 'Trades',
+    description: 'Made-up trades of the first half of 2026 by six desks, with dollar notionals',
+    tables: ['TRADES', 'DESKS', 'INSTRUMENTS'],
+    model: CUBE_TRADES_MODEL,
+    runtime: CUBE_TRADES_RUNTIME,
+    database: CUBE_TRADES_DATABASE,
+    schema: CUBE_TRADES_SCHEMA,
+};
+const SALES = {
+    id: 'sales',
+    name: 'Sales (DuckDB)',
+    description: 'Made-up sales of tea and coffee by country and year, on DuckDB, which runs Pivot',
+    tables: ['sales'],
+    model: CUBE_SALES_MODEL,
+    runtime: CUBE_SALES_RUNTIME,
+    database: CUBE_SALES_DATABASE,
+    schema: CUBE_SALES_SCHEMA,
+};
+/** The datasets, in the order the examples show them */
+export const CUBE_EXAMPLE_DATASETS = Object.freeze([NORTHWIND, SPORTS, TRADES, SALES]);
+/**
+ * A cube over the model: the nodes in order, each after the one before it
+ * unless the connections say otherwise, with the last one selected
+ */
+const example = (model, id, name, description, build) => ({
+    id,
+    dataset: model.id,
+    name,
+    description,
+    createDocument: () => {
+        const { nodes, connections } = build((sourceId, table) => new RelationalTableSource(sourceId, {
+            database: model.database,
+            schema: model.schema,
+            table,
+        }));
+        return new CubeDocument({
+            name,
+            context: { model: model.model, runtime: model.runtime },
+            query: new Query(nodes, connections, nodes.at(-1)?.id),
+        });
+    },
+});
+/** Connections that feed each node after the first one into the next */
+const chain = (ids) => ids.slice(1).map((id, index) => new Connection(ids[index] ?? '', id, 'tds'));
+const equal = (column, value) => new ColumnComparisonFilter(column, FilterOperator.EQUAL, {
+    kind: 'string',
+    value,
+});
+export const CUBE_EXAMPLES = Object.freeze([
+    example(NORTHWIND, 'northwind-top-customers', 'Top customers by orders', 'Joins orders to customers, counts each customer’s orders, keeps the ten with most', (table) => ({
+        nodes: [
+            table('relational101', 'ORDERS'),
+            table('relational102', 'CUSTOMERS'),
+            new Rename('rename101', [{ from: 'CUSTOMER_ID', to: 'CUSTOMER' }]),
+            new Join('join101', {
+                leftColumns: ['CUSTOMER_ID'],
+                rightColumns: ['CUSTOMER'],
+                joinType: JoinType.INNER,
+            }),
+            new Group('group101', ['COMPANY_NAME', 'COUNTRY'], [
+                {
+                    column: undefined,
+                    function: AggregationFunction.COUNT_ROWS,
+                    name: 'ORDER_COUNT',
+                },
+            ]),
+            new Sort('sort101', [
+                { column: 'ORDER_COUNT', direction: SortDirection.DESC },
+                { column: 'COMPANY_NAME', direction: SortDirection.ASC },
+            ]),
+            new Limit('limit101', 10),
+        ],
+        connections: [
+            new Connection('relational102', 'rename101', 'tds'),
+            new Connection('relational101', 'join101', 'leftTds'),
+            new Connection('rename101', 'join101', 'rightTds'),
+            ...chain(['join101', 'group101', 'sort101', 'limit101']),
+        ],
+    })),
+    example(NORTHWIND, 'northwind-stock-by-category', 'Products in stock by category', 'Joins products to their categories, then counts the products and units in stock of each', (table) => ({
+        nodes: [
+            table('relational101', 'PRODUCTS'),
+            table('relational102', 'CATEGORIES'),
+            new Rename('rename101', [{ from: 'CATEGORY_ID', to: 'CATEGORY' }]),
+            new Join('join101', {
+                leftColumns: ['CATEGORY_ID'],
+                rightColumns: ['CATEGORY'],
+                joinType: JoinType.INNER,
+            }),
+            new Group('group101', ['CATEGORY_NAME'], [
+                {
+                    column: undefined,
+                    function: AggregationFunction.COUNT_ROWS,
+                    name: 'PRODUCT_COUNT',
+                },
+                {
+                    column: 'UNITS_IN_STOCK',
+                    function: AggregationFunction.SUM,
+                    name: 'UNITS',
+                },
+            ]),
+            new Sort('sort101', [
+                { column: 'UNITS', direction: SortDirection.DESC },
+            ]),
+        ],
+        connections: [
+            new Connection('relational102', 'rename101', 'tds'),
+            new Connection('relational101', 'join101', 'leftTds'),
+            new Connection('rename101', 'join101', 'rightTds'),
+            ...chain(['join101', 'group101', 'sort101']),
+        ],
+    })),
+    example(SPORTS, 'sports-top-watched', 'Top watched sports', 'Joins events to their sports, then adds up each sport’s viewers', (table) => ({
+        nodes: [
+            table('relational101', 'EVENTS'),
+            table('relational102', 'SPORTS'),
+            new Join('join101', {
+                leftColumns: ['SPORT_ID'],
+                rightColumns: ['ID'],
+                joinType: JoinType.INNER,
+            }),
+            new Group('group101', ['SPORT'], [
+                {
+                    column: 'VIEWERS',
+                    function: AggregationFunction.SUM,
+                    name: 'TOTAL_VIEWERS',
+                },
+                {
+                    column: undefined,
+                    function: AggregationFunction.COUNT_ROWS,
+                    name: 'EVENT_COUNT',
+                },
+            ]),
+            new Sort('sort101', [
+                { column: 'TOTAL_VIEWERS', direction: SortDirection.DESC },
+            ]),
+        ],
+        connections: [
+            new Connection('relational101', 'join101', 'leftTds'),
+            new Connection('relational102', 'join101', 'rightTds'),
+            ...chain(['join101', 'group101', 'sort101']),
+        ],
+    })),
+    example(SPORTS, 'sports-europe-finals', 'Most watched finals in Europe', 'Filters the events to European finals and keeps the ten most watched', (table) => ({
+        nodes: [
+            table('relational101', 'EVENTS'),
+            new Filter('filter101', new CompositeFilter(CompositeFilterOperator.AND, [
+                equal('STAGE', 'Final'),
+                equal('REGION', 'Europe'),
+            ])),
+            new Sort('sort101', [
+                { column: 'VIEWERS', direction: SortDirection.DESC },
+            ]),
+            new Limit('limit101', 10),
+        ],
+        connections: chain(['relational101', 'filter101', 'sort101', 'limit101']),
+    })),
+    example(TRADES, 'trades-notional-by-desk', 'Notional by desk and asset class', 'Joins trades to their desks and instruments, then adds up the dollar notional of each desk and asset class', (table) => ({
+        nodes: [
+            table('relational101', 'TRADES'),
+            table('relational102', 'DESKS'),
+            new Join('join101', {
+                leftColumns: ['DESK_ID'],
+                rightColumns: ['ID'],
+                joinType: JoinType.INNER,
+            }),
+            table('relational103', 'INSTRUMENTS'),
+            new Rename('rename101', [{ from: 'ID', to: 'INSTRUMENT_KEY' }]),
+            new Join('join102', {
+                leftColumns: ['INSTRUMENT_ID'],
+                rightColumns: ['INSTRUMENT_KEY'],
+                joinType: JoinType.INNER,
+            }),
+            new Group('group101', ['DESK', 'ASSET_CLASS'], [
+                {
+                    column: 'NOTIONAL_USD',
+                    function: AggregationFunction.SUM,
+                    name: 'TOTAL_NOTIONAL_USD',
+                },
+                {
+                    column: undefined,
+                    function: AggregationFunction.COUNT_ROWS,
+                    name: 'TRADE_COUNT',
+                },
+            ]),
+            new Sort('sort101', [
+                { column: 'DESK', direction: SortDirection.ASC },
+                { column: 'TOTAL_NOTIONAL_USD', direction: SortDirection.DESC },
+            ]),
+        ],
+        connections: [
+            new Connection('relational101', 'join101', 'leftTds'),
+            new Connection('relational102', 'join101', 'rightTds'),
+            new Connection('relational103', 'rename101', 'tds'),
+            new Connection('join101', 'join102', 'leftTds'),
+            new Connection('rename101', 'join102', 'rightTds'),
+            ...chain(['join102', 'group101', 'sort101']),
+        ],
+    })),
+    example(TRADES, 'trades-desk-league', 'Desk league table', 'Joins trades to their desks, adds up each desk’s dollar notional, then ranks the desks within their region', (table) => ({
+        nodes: [
+            table('relational101', 'TRADES'),
+            table('relational102', 'DESKS'),
+            new Join('join101', {
+                leftColumns: ['DESK_ID'],
+                rightColumns: ['ID'],
+                joinType: JoinType.INNER,
+            }),
+            new Group('group101', ['DESK', 'REGION'], [
+                {
+                    column: 'NOTIONAL_USD',
+                    function: AggregationFunction.SUM,
+                    name: 'TOTAL_NOTIONAL_USD',
+                },
+                {
+                    column: undefined,
+                    function: AggregationFunction.COUNT_ROWS,
+                    name: 'TRADE_COUNT',
+                },
+            ]),
+            new Partition('partition101', ['REGION'], [{ column: 'TOTAL_NOTIONAL_USD', direction: SortDirection.DESC }], [
+                {
+                    column: undefined,
+                    function: WindowRankFunction.RANK,
+                    name: 'RANK_IN_REGION',
+                },
+            ]),
+            new Sort('sort101', [
+                { column: 'REGION', direction: SortDirection.ASC },
+                { column: 'RANK_IN_REGION', direction: SortDirection.ASC },
+            ]),
+        ],
+        connections: [
+            new Connection('relational101', 'join101', 'leftTds'),
+            new Connection('relational102', 'join101', 'rightTds'),
+            ...chain(['join101', 'group101', 'partition101', 'sort101']),
+        ],
+    })),
+    example(TRADES, 'trades-largest-buys', 'Largest buys', 'Filters the trades to buys and keeps the twenty largest by dollar notional', (table) => ({
+        nodes: [
+            table('relational101', 'TRADES'),
+            new Filter('filter101', equal('SIDE', 'BUY')),
+            new Sort('sort101', [
+                { column: 'NOTIONAL_USD', direction: SortDirection.DESC },
+            ]),
+            new Limit('limit101', 20),
+            new Restrict('restrict101', [
+                'TRADE_ID',
+                'TRADE_DATE',
+                'INSTRUMENT_ID',
+                'QUANTITY',
+                'PRICE',
+                'NOTIONAL_USD',
+            ]),
+        ],
+        connections: chain([
+            'relational101',
+            'filter101',
+            'sort101',
+            'limit101',
+            'restrict101',
+        ]),
+    })),
+    example(SALES, 'sales-by-year', 'Sales by country and year', 'Pivots the sales by year: a row per country, a column per year summing the amounts', (table) => ({
+        nodes: [
+            table('relational101', '"sales"'),
+            new Pivot('pivot101', ['country'], 'year', ['2022', '2023', '2024'].map((value) => ({
+                kind: 'integer',
+                value,
+            })), { column: 'amount', function: AggregationFunction.SUM }),
+            new Sort('sort101', [
+                { column: 'country', direction: SortDirection.ASC },
+            ]),
+        ],
+        connections: chain(['relational101', 'pivot101', 'sort101']),
+    })),
+    example(SALES, 'sales-by-product', 'Sales count by country and product', 'Pivots the sales by product: a row per country, a column per product counting its sales', (table) => ({
+        nodes: [
+            table('relational101', '"sales"'),
+            new Pivot('pivot101', ['country'], 'product', ['Coffee', 'Tea'].map((value) => ({
+                kind: 'string',
+                value,
+            })), { column: undefined, function: AggregationFunction.COUNT_ROWS }),
+            new Sort('sort101', [
+                { column: 'country', direction: SortDirection.ASC },
+            ]),
+        ],
+        connections: chain(['relational101', 'pivot101', 'sort101']),
+    })),
+]);
+//# sourceMappingURL=CubeExamples.js.map

package/lib/stores/CubeExamples.js.map

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

package/lib/stores/CubeExamplesState.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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 { GeneratorFn } from '@finos/legend-shared';
+import { type CubeExample, type CubeExampleDataset } from './CubeExamples.js';
+import type { CubeEditorState } from './CubeEditorState.js';
+/**
+ * The Examples dialog (PLAN §6.9): the sample datasets, each with its example
+ * cubes. An example opens in place of the cube, as Import does (one undo
+ * step), and runs once its tables are typed. A dataset starts a new cube on
+ * its model, in the source dialog's Sample Data tab. Either works whatever the
+ * cube is, read-only included, since it replaces it.
+ */
+export declare class CubeExamplesState {
+    readonly editorState: CubeEditorState;
+    readonly datasets: readonly CubeExampleDataset[];
+    readonly examples: readonly CubeExample[];
+    isOpen: boolean;
+    constructor(editorState: CubeEditorState);
+    /** A dataset's examples, in order */
+    examplesOf(dataset: CubeExampleDataset): readonly CubeExample[];
+    open(): void;
+    close(): void;
+    /**
+     * Starts a new cube on the dataset's model, in place of the cube (one undo
+     * step), and opens the source dialog's Sample Data tab on it to add a first
+     * table, with a way back to the examples
+     */
+    startOnDataset(dataset: CubeExampleDataset): void;
+    /** Opens the example in place of the cube, then runs it */
+    openExample(example: CubeExample): GeneratorFn<void>;
+}
+//# sourceMappingURL=CubeExamplesState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeExamplesState.d.ts","sourceRoot":"","sources":["../../src/stores/CubeExamplesState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AASxD,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAyB;IACzE,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAiB;IAE1D,MAAM,UAAS;gBAEH,WAAW,EAAE,eAAe;IAWxC,qCAAqC;IACrC,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,WAAW,EAAE;IAI/D,IAAI,IAAI,IAAI;IAIZ,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAajD,2DAA2D;IAC1D,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC;CAiBtD"}

package/lib/stores/CubeExamplesState.js

@@ -0,0 +1,81 @@
+/**
+ * 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 { CubeDocument } from '@finos/legend-cube';
+import { action, flow, flowResult, makeObservable, observable, when, } from 'mobx';
+import { CUBE_EXAMPLE_DATASETS, CUBE_EXAMPLES, } from './CubeExamples.js';
+import { CubeSourcePickerTabKey } from './source-picker/CubeSourcePickerTab.js';
+/**
+ * The Examples dialog (PLAN §6.9): the sample datasets, each with its example
+ * cubes. An example opens in place of the cube, as Import does (one undo
+ * step), and runs once its tables are typed. A dataset starts a new cube on
+ * its model, in the source dialog's Sample Data tab. Either works whatever the
+ * cube is, read-only included, since it replaces it.
+ */
+export class CubeExamplesState {
+    editorState;
+    datasets = CUBE_EXAMPLE_DATASETS;
+    examples = CUBE_EXAMPLES;
+    isOpen = false;
+    constructor(editorState) {
+        makeObservable(this, {
+            isOpen: observable,
+            open: action,
+            close: action,
+            startOnDataset: action,
+            openExample: flow,
+        });
+        this.editorState = editorState;
+    }
+    /** A dataset's examples, in order */
+    examplesOf(dataset) {
+        return this.examples.filter((example) => example.dataset === dataset.id);
+    }
+    open() {
+        this.isOpen = true;
+    }
+    close() {
+        this.isOpen = false;
+    }
+    /**
+     * Starts a new cube on the dataset's model, in place of the cube (one undo
+     * step), and opens the source dialog's Sample Data tab on it to add a first
+     * table, with a way back to the examples
+     */
+    startOnDataset(dataset) {
+        this.close();
+        this.editorState.importDocument(new CubeDocument({
+            context: { model: dataset.model, runtime: dataset.runtime },
+        }), false);
+        this.editorState.sourcePicker.openFromExamples(CubeSourcePickerTabKey.MODEL);
+    }
+    /** Opens the example in place of the cube, then runs it */
+    *openExample(example) {
+        this.close();
+        const document = example.createDocument();
+        this.editorState.importDocument(document, false);
+        yield when(() => !this.editorState.isResolvingSources);
+        const { execution } = this.editorState;
+        // not if the user has moved on, e.g. undone the opening: typing the
+        // tables replaces the document but keeps its context, which is this
+        // opening's own
+        if (this.editorState.document.context === document.context &&
+            execution.canExecute &&
+            !execution.isRunning) {
+            yield flowResult(execution.execute());
+        }
+    }
+}
+//# sourceMappingURL=CubeExamplesState.js.map

package/lib/stores/CubeExamplesState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeExamplesState.js","sourceRoot":"","sources":["../../src/stores/CubeExamplesState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EACL,MAAM,EACN,IAAI,EACJ,UAAU,EACV,cAAc,EACd,UAAU,EACV,IAAI,GACL,MAAM,MAAM,CAAC;AACd,OAAO,EACL,qBAAqB,EACrB,aAAa,GAGd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,OAAO,iBAAiB;IACnB,WAAW,CAAkB;IAC7B,QAAQ,GAAkC,qBAAqB,CAAC;IAChE,QAAQ,GAA2B,aAAa,CAAC;IAE1D,MAAM,GAAG,KAAK,CAAC;IAEf,YAAY,WAA4B;QACtC,cAAc,CAAC,IAAI,EAAE;YACnB,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,MAAM;YACb,cAAc,EAAE,MAAM;YACtB,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,qCAAqC;IACrC,UAAU,CAAC,OAA2B;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI;QACF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,OAA2B;QACxC,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,WAAW,CAAC,cAAc,CAC7B,IAAI,YAAY,CAAC;YACf,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;SAC5D,CAAC,EACF,KAAK,CACN,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,gBAAgB,CAC5C,sBAAsB,CAAC,KAAK,CAC7B,CAAC;IACJ,CAAC;IAED,2DAA2D;IAC3D,CAAC,WAAW,CAAC,OAAoB;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;QAC1C,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACjD,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;QACvD,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;QACvC,oEAAoE;QACpE,oEAAoE;QACpE,gBAAgB;QAChB,IACE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO;YACtD,SAAS,CAAC,UAAU;YACpB,CAAC,SAAS,CAAC,SAAS,EACpB,CAAC;YACD,MAAM,UAAU,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;CACF"}

package/lib/stores/CubeExecutionState.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { type Query, type Schema } from '@finos/legend-cube';
+import { type CubeContext, type Query, type Schema } from '@finos/legend-cube';
 import { type GeneratorFn } from '@finos/legend-shared';
 import { CubeEngineError, type CubeResultValue } from '../graph-manager/CubeEngine.js';
 import type { CubeEditorState } from './CubeEditorState.js';
@@ -23,6 +23,10 @@ export interface CubeExecutionResult {
     readonly id: number;
     /** The query that ran: results are stale once the document holds another */
     readonly query: Query;
+    /** The context it ran in: results are stale once the document holds another, e.g. another warehouse */
+    readonly context: CubeContext | undefined;
+    /** The warehouse a data product cube ran on, its own or the viewer's: results are stale once another is used */
+    readonly warehouse: string | undefined;
     /** The capture node's schema when the run started; the grid's columns, by position */
     readonly schema: Schema;
     /** At most `rowLimit` rows */
@@ -47,7 +51,7 @@ export declare class CubeExecutionState {
     private runCount;
     constructor(editorState: CubeEditorState);
     get isRunning(): boolean;
-    /** The shown result no longer matches the query or the row limit; it is kept until the next run */
+    /** The shown result no longer matches the query, the context or the row limit; it is kept until the next run */
     get isStale(): boolean;
     /**
      * Why Execute is unavailable, if it is: it needs a source, a model and a

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

@@ -1 +1 @@
-{"version":3,"file":"CubeExecutionState.d.ts","sourceRoot":"","sources":["../../src/stores/CubeExecutionState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAGL,KAAK,KAAK,EACV,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAS3E,OAAO,EACL,eAAe,EAGf,KAAK,eAAe,EACrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,sGAAsG;AACtG,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,sFAAsF;IACtF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,eAAe,EAAE,CAAC,EAAE,CAAC;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAiCD;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IAEtC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACxC,KAAK,EAAE,eAAe,GAAG,SAAS,CAAC;IACnC,wDAAwD;IACxD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAAK;gBAET,WAAW,EAAE,eAAe;IAiBxC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,mGAAmG;IACnG,IAAI,OAAO,IAAI,OAAO,CAOrB;IAED;;;;OAIG;IACH,IAAI,eAAe,IAAI,MAAM,EAAE,CAmB9B;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAEA,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC;IA4G7B,8EAA8E;IAC9E,UAAU,IAAI,IAAI;IAIlB,iEAAiE;IACjE,IAAI,IAAI,IAAI;IAKZ,gGAAgG;IAChG,KAAK,IAAI,IAAI;CAKd"}
+{"version":3,"file":"CubeExecutionState.d.ts","sourceRoot":"","sources":["../../src/stores/CubeExecutionState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,KAAK,EACV,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE3E,OAAO,EACL,eAAe,EAEf,KAAK,eAAe,EACrB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,sGAAsG;AACtG,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,uGAAuG;IACvG,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;IAC1C,gHAAgH;IAChH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,sFAAsF;IACtF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,eAAe,EAAE,CAAC,EAAE,CAAC;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAiCD;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IAEtC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACxC,KAAK,EAAE,eAAe,GAAG,SAAS,CAAC;IACnC,wDAAwD;IACxD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAAK;gBAET,WAAW,EAAE,eAAe;IAiBxC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,gHAAgH;IAChH,IAAI,OAAO,IAAI,OAAO,CAUrB;IAED;;;;OAIG;IACH,IAAI,eAAe,IAAI,MAAM,EAAE,CAyB9B;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAEA,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC;IAoF7B,8EAA8E;IAC9E,UAAU,IAAI,IAAI;IAIlB,iEAAiE;IACjE,IAAI,IAAI,IAAI;IAKZ,gGAAgG;IAChG,KAAK,IAAI,IAAI;CAUd"}