@finos/legend-cube-builder 0.0.4 → 0.0.6

package/lib/stores/CubeTourState.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type CubeTourStep } from '../__lib__/LegendCubeTour.js';
+import type { CubeEditorState } from './CubeEditorState.js';
+/** Whether a step can be shown: its controls are on the page */
+export type CubeTourStepShown = (step: CubeTourStep) => boolean;
+/**
+ * The editor's guided tour (PLAN §11.21): one step at a time, each pointing
+ * at its controls; a step whose controls aren't on the page is skipped. It
+ * starts on the cube as it is, the node editor's edits applied first; on an
+ * empty cube, where examples are offered, it opens one to show (one undo
+ * step). Nothing starts it but the user.
+ */
+export declare class CubeTourState {
+    readonly editorState: CubeEditorState;
+    readonly steps: readonly CubeTourStep[];
+    isOpen: boolean;
+    /** The step shown, an index into `steps` */
+    index: number;
+    /** Whether this tour opened its example */
+    openedExample: boolean;
+    constructor(editorState: CubeEditorState);
+    get step(): CubeTourStep | undefined;
+    /**
+     * Starts the tour at its first step; not while the node editor keeps its
+     * edits open, as other actions wait for it
+     */
+    start(): void;
+    /**
+     * The step `by` steps on (1) or back (-1), skipping those not shown; past
+     * the last, the tour ends; before the first, it stays
+     */
+    move(by: 1 | -1, isShown: CubeTourStepShown): void;
+    close(): void;
+}
+//# sourceMappingURL=CubeTourState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeTourState.d.ts","sourceRoot":"","sources":["../../src/stores/CubeTourState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,gEAAgE;AAChE,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC;AAEhE;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAoB;IAE3D,MAAM,UAAS;IACf,4CAA4C;IAC5C,KAAK,SAAK;IACV,2CAA2C;IAC3C,aAAa,UAAS;gBAEV,WAAW,EAAE,eAAe;IAaxC,IAAI,IAAI,IAAI,YAAY,GAAG,SAAS,CAEnC;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI;IAwBb;;;OAGG;IACH,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAiBlD,KAAK,IAAI,IAAI;CAId"}

package/lib/stores/CubeTourState.js

@@ -0,0 +1,92 @@
+/**
+ * Copyright (c) 2026-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { action, computed, flowResult, makeObservable, observable } from 'mobx';
+import { CUBE_EDITOR_TOUR, CUBE_TOUR_EXAMPLE_ID, } from '../__lib__/LegendCubeTour.js';
+import { isCubeSampleDataOffered } from './CubeHost.js';
+/**
+ * The editor's guided tour (PLAN §11.21): one step at a time, each pointing
+ * at its controls; a step whose controls aren't on the page is skipped. It
+ * starts on the cube as it is, the node editor's edits applied first; on an
+ * empty cube, where examples are offered, it opens one to show (one undo
+ * step). Nothing starts it but the user.
+ */
+export class CubeTourState {
+    editorState;
+    steps = CUBE_EDITOR_TOUR;
+    isOpen = false;
+    /** The step shown, an index into `steps` */
+    index = 0;
+    /** Whether this tour opened its example */
+    openedExample = false;
+    constructor(editorState) {
+        makeObservable(this, {
+            isOpen: observable,
+            index: observable,
+            openedExample: observable,
+            step: computed,
+            start: action,
+            move: action,
+            close: action,
+        });
+        this.editorState = editorState;
+    }
+    get step() {
+        return this.isOpen ? this.steps[this.index] : undefined;
+    }
+    /**
+     * Starts the tour at its first step; not while the node editor keeps its
+     * edits open, as other actions wait for it
+     */
+    start() {
+        const { editorState } = this;
+        if (this.isOpen || !editorState.nodeEditor.finish()) {
+            return;
+        }
+        const example = editorState.document.query.isEmpty &&
+            !editorState.readOnly &&
+            isCubeSampleDataOffered(editorState.host)
+            ? editorState.examples.examples.find((candidate) => candidate.id === CUBE_TOUR_EXAMPLE_ID)
+            : undefined;
+        this.openedExample = example !== undefined;
+        this.index = 0;
+        this.isOpen = true;
+        if (example) {
+            // the tour goes on while it opens and runs: its steps show as they can
+            flowResult(editorState.examples.openExample(example)).catch(editorState.host.applicationStore.alertUnhandledError);
+        }
+    }
+    /**
+     * The step `by` steps on (1) or back (-1), skipping those not shown; past
+     * the last, the tour ends; before the first, it stays
+     */
+    move(by, isShown) {
+        for (let index = this.index + by; index >= 0 && index < this.steps.length; index += by) {
+            const step = this.steps[index];
+            if (step && isShown(step)) {
+                this.index = index;
+                return;
+            }
+        }
+        if (by === 1) {
+            this.close();
+        }
+    }
+    close() {
+        this.isOpen = false;
+        this.index = 0;
+    }
+}
+//# sourceMappingURL=CubeTourState.js.map

package/lib/stores/CubeTourState.js.map

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

package/lib/stores/LegendCubeHost.d.ts

@@ -0,0 +1,88 @@
+/**
+ * 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 { GenericLegendApplicationStore } from '@finos/legend-application';
+import type { CubeConnectionExplorer } from '../graph-manager/CubeConnectionExplorer.js';
+import type { CubeDataProductCatalog } from '../graph-manager/CubeDataProductCatalog.js';
+import type { CubeEngine } from '../graph-manager/CubeEngine.js';
+import { CubeEngineClientSettings } from '../graph-manager/CubeEngineClientSettings.js';
+import type { CubeIngestCatalog } from '../graph-manager/CubeIngestCatalog.js';
+import type { CubeProjectCatalog } from '../graph-manager/CubeProjectCatalog.js';
+import type { CubeServiceCatalog } from '../graph-manager/CubeServiceCatalog.js';
+import { type CubeEngineConfig, type CubeLakehouseServices } from '../graph-manager/protocol/pure/CubeEngineBuilder.js';
+import type { CubeHost } from './CubeHost.js';
+import { LocalModelCatalog } from './LocalModelCatalog.js';
+/**
+ * The servers of a Legend deployment hosting the Cube page, as its config
+ * names them (PLAN §11.18): the engine, and each of the others only where the
+ * deployment has one. Legend Query and Legend Analytics each read theirs from
+ * their own config.
+ */
+export interface LegendCubeHostConfig {
+    readonly engine: CubeEngineConfig;
+    /** Published projects (PLAN §6.3) and, with a lakehouse, the data products' models */
+    readonly depotServerUrl?: string | undefined;
+    /** The lakehouse's contracts: data products need it, and a depot (PLAN §6.8) */
+    readonly lakehouseContractUrl?: string | undefined;
+    /** The lakehouse platform, which names the ingest servers: ingest data sets need it (PLAN §6.7) */
+    readonly lakehousePlatformUrl?: string | undefined;
+    /** The marketplace server, whose search the data product tab uses */
+    readonly marketplaceServerUrl?: string | undefined;
+    /** Legend Marketplace, which a production data product links to */
+    readonly marketplaceApplicationUrl?: string | undefined;
+    /** Legend Marketplace's production-parallel deployment, which a production-parallel data product links to */
+    readonly marketplaceProductionParallelUrl?: string | undefined;
+    /** The stereotype marking access point groups open to everyone, as Studio and Marketplace configure it */
+    readonly enterpriseStereotype?: CubeLakehouseServices['enterpriseStereotype'];
+    /** The lakehouse environment the host remembers for the viewer */
+    readonly getPreferredEnvironment?: (() => string | undefined) | undefined;
+}
+/**
+ * What Cube needs to read and run data products (PLAN §6.8), with the
+ * deployment's lakehouse and depot: none without both, so a deployment
+ * without them offers no data products. With a marketplace server too, its
+ * search is used; with the lakehouse platform, ingest data sets are offered.
+ */
+export declare const buildLegendCubeLakehouseServices: (applicationStore: GenericLegendApplicationStore, config: LegendCubeHostConfig) => CubeLakehouseServices | undefined;
+/** The published projects in the deployment's depot, or none without a depot */
+export declare const buildLegendCubeProjectCatalog: (applicationStore: GenericLegendApplicationStore, config: LegendCubeHostConfig) => CubeProjectCatalog | undefined;
+/** What tests give the host in place of what it would build */
+export interface LegendCubeHostParts {
+    readonly engine?: CubeEngine | undefined;
+    readonly connectionExplorer?: CubeConnectionExplorer | undefined;
+    readonly projectCatalog?: CubeProjectCatalog | undefined;
+}
+/**
+ * A Legend deployment as the host of the Cube page (PLAN §3.5, §11.18): the
+ * application's store, the engine and the bundled models, direct database
+ * connections read through the engine, the services in its registry, and
+ * the deployment's projects, data products and ingest data sets where it has
+ * the servers for them. Legend Query and Legend Analytics each build one per
+ * visit to the page, from their own config.
+ */
+export declare class LegendCubeHost implements CubeHost {
+    readonly applicationStore: GenericLegendApplicationStore;
+    readonly engine: CubeEngine;
+    readonly modelCatalog: LocalModelCatalog;
+    readonly connectionExplorer: CubeConnectionExplorer;
+    readonly dataProductCatalog: CubeDataProductCatalog | undefined;
+    readonly ingestCatalog: CubeIngestCatalog | undefined;
+    readonly projectCatalog: CubeProjectCatalog | undefined;
+    readonly serviceCatalog: CubeServiceCatalog;
+    /** The engine URL and compression Cube's engine clients share, which Dev Settings changes */
+    readonly engineClientSettings: CubeEngineClientSettings;
+    constructor(applicationStore: GenericLegendApplicationStore, config: LegendCubeHostConfig, parts?: LegendCubeHostParts);
+}
+//# sourceMappingURL=LegendCubeHost.d.ts.map

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

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

package/lib/stores/LegendCubeHost.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 { DepotServerClient } from '@finos/legend-server-depot';
+import { LakehouseContractServerClient, LakehouseIngestServerClient, LakehousePlatformServerClient, } from '@finos/legend-server-lakehouse';
+import { MarketplaceServerClient } from '@finos/legend-server-marketplace';
+import { EXTERNAL_APPLICATION_NAVIGATION__generateCubeMarketplaceDataProductUrl } from '../__lib__/LegendCubeNavigation.js';
+import { CubeDataProductEnvironmentType } from '../graph-manager/CubeDataProduct.js';
+import { CubeEngineClientSettings } from '../graph-manager/CubeEngineClientSettings.js';
+import { buildCubeConnectionExplorer, buildCubeDataProductCatalog, buildCubeEngine, buildCubeIngestCatalog, buildCubeLakehouseEnvironment, buildCubeProjectCatalog, buildCubeServiceCatalog, } from '../graph-manager/protocol/pure/CubeEngineBuilder.js';
+import { getCubeRememberedWarehouse } from './CubeDataProductWarehouse.js';
+import { LocalModelCatalog } from './LocalModelCatalog.js';
+/**
+ * What Cube needs to read and run data products (PLAN §6.8), with the
+ * deployment's lakehouse and depot: none without both, so a deployment
+ * without them offers no data products. With a marketplace server too, its
+ * search is used; with the lakehouse platform, ingest data sets are offered.
+ */
+export const buildLegendCubeLakehouseServices = (applicationStore, config) => {
+    const { tracerService } = applicationStore;
+    if (!config.lakehouseContractUrl || !config.depotServerUrl) {
+        return undefined;
+    }
+    const contractServerClient = new LakehouseContractServerClient({
+        baseUrl: config.lakehouseContractUrl,
+    });
+    contractServerClient.setTracerService(tracerService);
+    const depotServerClient = new DepotServerClient({
+        serverUrl: config.depotServerUrl,
+    });
+    depotServerClient.setTracerService(tracerService);
+    let marketplaceServerClient;
+    if (config.marketplaceServerUrl) {
+        marketplaceServerClient = new MarketplaceServerClient({
+            serverUrl: config.marketplaceServerUrl,
+            // the client only stores it, never reading it, and Cube calls no subscription route
+            subscriptionUrl: '',
+        });
+        marketplaceServerClient.setTracerService(tracerService);
+    }
+    // ingest data sets need the platform, which names the ingest servers; the
+    // ingest client has no server of its own: each call names one
+    let platformServerClient;
+    let ingestServerClient;
+    if (config.lakehousePlatformUrl) {
+        platformServerClient = new LakehousePlatformServerClient(config.lakehousePlatformUrl);
+        platformServerClient.setTracerService(tracerService);
+        ingestServerClient = new LakehouseIngestServerClient(undefined);
+        ingestServerClient.setTracerService(tracerService);
+    }
+    return {
+        platformServerClient,
+        ingestServerClient,
+        contractServerClient,
+        depotServerClient,
+        marketplaceServerClient,
+        getAccessToken: () => applicationStore.getAccessToken(),
+        getCurrentUser: () => applicationStore.identityService.currentUser,
+        getPreferredEnvironment: config.getPreferredEnvironment,
+        enterpriseStereotype: config.enterpriseStereotype,
+        // the marketplace of the deployment's class, where its deployment is
+        getMarketplaceLink: (target) => {
+            const marketplaceUrl = target.environmentType ===
+                CubeDataProductEnvironmentType.PRODUCTION_PARALLEL
+                ? config.marketplaceProductionParallelUrl
+                : config.marketplaceApplicationUrl;
+            return marketplaceUrl
+                ? EXTERNAL_APPLICATION_NAVIGATION__generateCubeMarketplaceDataProductUrl(marketplaceUrl, target.dataProductId, target.deploymentId, target.accessPointGroup)
+                : undefined;
+        },
+    };
+};
+/** The published projects in the deployment's depot, or none without a depot */
+export const buildLegendCubeProjectCatalog = (applicationStore, config) => {
+    if (!config.depotServerUrl) {
+        return undefined;
+    }
+    const depotServerClient = new DepotServerClient({
+        serverUrl: config.depotServerUrl,
+    });
+    depotServerClient.setTracerService(applicationStore.tracerService);
+    return buildCubeProjectCatalog(depotServerClient);
+};
+/**
+ * A Legend deployment as the host of the Cube page (PLAN §3.5, §11.18): the
+ * application's store, the engine and the bundled models, direct database
+ * connections read through the engine, the services in its registry, and
+ * the deployment's projects, data products and ingest data sets where it has
+ * the servers for them. Legend Query and Legend Analytics each build one per
+ * visit to the page, from their own config.
+ */
+export class LegendCubeHost {
+    applicationStore;
+    engine;
+    modelCatalog;
+    connectionExplorer;
+    dataProductCatalog;
+    ingestCatalog;
+    projectCatalog;
+    serviceCatalog;
+    /** The engine URL and compression Cube's engine clients share, which Dev Settings changes */
+    engineClientSettings;
+    constructor(applicationStore, config, parts) {
+        this.applicationStore = applicationStore;
+        const { tracerService } = applicationStore;
+        this.engineClientSettings = new CubeEngineClientSettings(config.engine);
+        const lakehouse = buildLegendCubeLakehouseServices(applicationStore, config);
+        this.ingestCatalog = lakehouse
+            ? buildCubeIngestCatalog(config.engine, tracerService, lakehouse, this.engineClientSettings)
+            : undefined;
+        this.engine =
+            parts?.engine ??
+                buildCubeEngine(config.engine, tracerService, {
+                    ingestCatalog: this.ingestCatalog,
+                    lakehouseEnvironment: lakehouse
+                        ? buildCubeLakehouseEnvironment(lakehouse)
+                        : undefined,
+                    getRememberedWarehouse: () => getCubeRememberedWarehouse(applicationStore.userDataService),
+                    clientSettings: this.engineClientSettings,
+                });
+        this.dataProductCatalog = lakehouse
+            ? buildCubeDataProductCatalog(lakehouse)
+            : undefined;
+        this.modelCatalog = new LocalModelCatalog(this.engine);
+        // its own client, configured as the engine's
+        this.connectionExplorer =
+            parts?.connectionExplorer ??
+                buildCubeConnectionExplorer(config.engine, tracerService, this.engineClientSettings);
+        // it reads nothing until the source dialog's Project tab opens
+        this.projectCatalog =
+            parts?.projectCatalog ??
+                buildLegendCubeProjectCatalog(applicationStore, config);
+        // in progress (PLAN §6.4); it reads nothing until the Service tab opens
+        this.serviceCatalog = buildCubeServiceCatalog(config.engine, tracerService, this.engineClientSettings);
+    }
+}
+//# sourceMappingURL=LegendCubeHost.js.map

package/lib/stores/LegendCubeHost.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"LocalModelCatalog.d.ts","sourceRoot":"","sources":["../../src/stores/LocalModelCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EACjB,MAAM,gCAAgC,CAAC;AAYxC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAClD;AAED,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAkBhD,CAAC;AAEH,4CAA4C;AAC5C,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,YACP,CAAC;AAEzC;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,MAAM,0BAAkB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgD;gBAE7D,MAAM,EAAE,UAAU;IAI9B,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAW5D"}
+{"version":3,"file":"LocalModelCatalog.d.ts","sourceRoot":"","sources":["../../src/stores/LocalModelCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EACjB,MAAM,gCAAgC,CAAC;AAexC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAClD;AAED,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAoBhD,CAAC;AAEH,4CAA4C;AAC5C,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,YACP,CAAC;AAEzC;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,MAAM,0BAAkB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgD;gBAE7D,MAAM,EAAE,UAAU;IAI9B,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAW5D"}

package/lib/stores/LocalModelCatalog.js

@@ -15,7 +15,7 @@
  */
 import { CUBE_NORTHWIND_MODEL, CUBE_NORTHWIND_SAMPLE_MODEL, } from './fixtures/CubeNorthwindModel.js';
 import { CUBE_SPORTS_MODEL } from './fixtures/CubeSportsModel.js';
-import { CUBE_TRADES_MODEL } from './fixtures/CubeTradesModel.js';
+import { CUBE_TRADES_MODEL, CUBE_TRADES_MODEL_BEFORE_FUNCTIONS, } from './fixtures/CubeTradesModel.js';
 export const BUNDLED_MODELS = Object.freeze([
     {
         id: 'cube-northwind',
@@ -33,6 +33,8 @@ export const BUNDLED_MODELS = Object.freeze([
         id: 'cube-sample-trades',
         label: 'Trades',
         model: CUBE_TRADES_MODEL,
+        // before its functions (PLAN §6.5)
+        earlierModels: [CUBE_TRADES_MODEL_BEFORE_FUNCTIONS],
     },
 ]);
 /** The model context of pasted Pure text */

package/lib/stores/LocalModelCatalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"LocalModelCatalog.js","sourceRoot":"","sources":["../../src/stores/LocalModelCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,EACL,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAclE,MAAM,CAAC,MAAM,cAAc,GAA4B,MAAM,CAAC,MAAM,CAAC;IACnE;QACE,EAAE,EAAE,gBAAgB;QACpB,KAAK,EAAE,WAAW;QAClB,KAAK,EAAE,2BAA2B;QAClC,sEAAsE;QACtE,aAAa,EAAE,CAAC,oBAAoB,CAAC;KACtC;IACD;QACE,EAAE,EAAE,oBAAoB;QACxB,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,iBAAiB;KACzB;IACD;QACE,EAAE,EAAE,oBAAoB;QACxB,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,iBAAiB;KACzB;CACF,CAAC,CAAC;AAEH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAgB,EAAE,CAC5D,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAEzC;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IACnB,MAAM,GAAG,cAAc,CAAC;IAChB,MAAM,CAAa;IACnB,QAAQ,GAAG,IAAI,GAAG,EAAqC,CAAC;IAEzE,YAAY,MAAkB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,WAAW,CAAC,KAAmB;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACvC,yCAAyC;YACzC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}
+{"version":3,"file":"LocalModelCatalog.js","sourceRoot":"","sources":["../../src/stores/LocalModelCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,EACL,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EACL,iBAAiB,EACjB,kCAAkC,GACnC,MAAM,+BAA+B,CAAC;AAcvC,MAAM,CAAC,MAAM,cAAc,GAA4B,MAAM,CAAC,MAAM,CAAC;IACnE;QACE,EAAE,EAAE,gBAAgB;QACpB,KAAK,EAAE,WAAW;QAClB,KAAK,EAAE,2BAA2B;QAClC,sEAAsE;QACtE,aAAa,EAAE,CAAC,oBAAoB,CAAC;KACtC;IACD;QACE,EAAE,EAAE,oBAAoB;QACxB,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,iBAAiB;KACzB;IACD;QACE,EAAE,EAAE,oBAAoB;QACxB,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,iBAAiB;QACxB,mCAAmC;QACnC,aAAa,EAAE,CAAC,kCAAkC,CAAC;KACpD;CACF,CAAC,CAAC;AAEH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAgB,EAAE,CAC5D,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAEzC;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IACnB,MAAM,GAAG,cAAc,CAAC;IAChB,MAAM,CAAa;IACnB,QAAQ,GAAG,IAAI,GAAG,EAAqC,CAAC;IAEzE,YAAY,MAAkB;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,WAAW,CAAC,KAAmB;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACvC,yCAAyC;YACzC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

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

@@ -0,0 +1,87 @@
+/**
+ * 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 Explode } from '@finos/legend-cube';
+import { type GeneratorFn } from '@finos/legend-shared';
+import type { CubeEditorState } from '../CubeEditorState.js';
+import type { CubeJsonSample } from '../variant/CubeJsonShape.js';
+import { CubeNodeDraft } from './CubeNodeDraft.js';
+/** An array a sample of the column holds, to explode */
+export interface CubeExplodeArray {
+    /** The keys from the column to it, empty for the column itself */
+    readonly path: readonly string[];
+    /** What it held, e.g. `list of object` */
+    readonly description: string;
+    /** Its share, 0 to 1, of the places it could be */
+    readonly presence: number;
+}
+/**
+ * The Explode Array editor's draft (PLAN §11.20): the Variant column, the
+ * keys to its array and the new column's name. The arrays to pick from come
+ * from a sample of the column's documents, read after the node's input as
+ * Explore JSON reads them. Until a name is typed, the name follows the
+ * column and keys (`<last key>_element`, free in the input); picking another
+ * column drops the keys and the sample, which were the other column's.
+ */
+export declare class CubeExplodeDraft extends CubeNodeDraft<Explode> {
+    readonly editorState: CubeEditorState;
+    column: string;
+    path: readonly string[];
+    name: string;
+    /** What a sample of the column held, once read */
+    sample: {
+        readonly column: string;
+        readonly sample: CubeJsonSample;
+    } | undefined;
+    isSampling: boolean;
+    /** Why the sample couldn't be read */
+    sampleError: string | undefined;
+    /** The name follows the column and keys until one is typed */
+    private namedByDefault;
+    private controller;
+    /** Anything was changed; until then, `build()` gives the original back */
+    private touched;
+    constructor(original: Explode, editorState: CubeEditorState);
+    /** The element's default name for a column and keys: `<last key>_element`, free in the input */
+    private defaultName;
+    /**
+     * Why Find arrays can't read the column: the database the node's input
+     * runs on has no JSON functions; `undefined` when it can, or isn't known
+     */
+    get sampleProblem(): string | undefined;
+    /** The node's input: its id and schema, once known */
+    private get input();
+    /** The arrays the sample found, if it was of the picked column */
+    get arrays(): CubeExplodeArray[] | undefined;
+    private edited;
+    /** Picks the column; another column's keys and sample are dropped */
+    setColumn(column: string): void;
+    setKey(index: number, key: string): void;
+    addKey(): void;
+    removeKey(index: number): void;
+    /** Takes the keys of an array the sample found */
+    pickArray(path: readonly string[]): void;
+    /** Types the name: it no longer follows the column and keys */
+    setName(name: string): void;
+    stopSample(): void;
+    /**
+     * Reads the picked column's first values after the node's input, as
+     * Explore JSON does (listed in Runs, can be stopped), for the arrays they
+     * hold; picking another column abandons it
+     */
+    readSample(): GeneratorFn<void>;
+    build(): Explode;
+}
+//# sourceMappingURL=CubeExplodeDraft.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CubeExplodeDraft.d.ts","sourceRoot":"","sources":["../../../src/stores/editors/CubeExplodeDraft.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,KAAK,OAAO,EAGb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAG3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAS7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAgBD;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,aAAa,CAAC,OAAO,CAAC;IAC1D,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,MAAM,EACF;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;KAAE,GAC5D,SAAS,CAAC;IACd,UAAU,UAAS;IACnB,sCAAsC;IACtC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,8DAA8D;IAC9D,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,UAAU,CAA8B;IAChD,0EAA0E;IAC1E,OAAO,CAAC,OAAO,CAAS;gBAEZ,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe;IAgC3D,gGAAgG;IAChG,OAAO,CAAC,WAAW;IASnB;;;OAGG;IACH,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAatC;IAED,sDAAsD;IACtD,OAAO,KAAK,KAAK,GAKhB;IAED,kEAAkE;IAClE,IAAI,MAAM,IAAI,gBAAgB,EAAE,GAAG,SAAS,CAK3C;IAED,OAAO,CAAC,MAAM;IAOd,qEAAqE;IACrE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAY/B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAKxC,MAAM,IAAI,IAAI;IAKd,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK9B,kDAAkD;IAClD,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAKxC,+DAA+D;IAC/D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM3B,UAAU,IAAI,IAAI;IAMlB;;;;OAIG;IACF,UAAU,IAAI,WAAW,CAAC,IAAI,CAAC;IAuChC,KAAK,IAAI,OAAO;CASjB"}