@finos/legend-cube-builder 0.0.5 → 0.0.6

package/lib/components/tour/CubeTour.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 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 { CubeEditorState } from '../../stores/CubeEditorState.js';
+/**
+ * Above the canvas, the grid and the node editor (1250), below MUI's dialogs
+ * (1300); inside the dialog that hosts the page, if one does
+ */
+export declare const CUBE_TOUR_Z_INDEX = 1290;
+/**
+ * The editor's guided tour (PLAN §11.21): the page dimmed but for the
+ * current step's controls, and a card beside them, or in the middle of the
+ * page for a step that points at nothing. The controls are followed as the
+ * page moves them (a panel resized, the grid loaded). Clicks on the page
+ * are held while it shows; Esc ends it, the arrow keys move through it.
+ */
+export declare const CubeTour: ((props: {
+    editorState: CubeEditorState;
+    /** The page, whose controls the steps point at */
+    root: HTMLElement | null;
+}) => import("react").ReactPortal | null) & {
+    displayName: string;
+};
+//# sourceMappingURL=CubeTour.d.ts.map

package/lib/components/tour/CubeTour.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeTour.d.ts","sourceRoot":"","sources":["../../../src/components/tour/CubeTour.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGvE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAuEtC;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,WACX;IACN,WAAW,EAAE,eAAe,CAAC;IAC7B,kDAAkD;IAClD,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;CAC1B;;CAuMF,CAAC"}

package/lib/components/tour/CubeTour.js

@@ -0,0 +1,183 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * 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 { BasePopper } from '@finos/legend-art';
+import { noop } from '@finos/legend-shared';
+import { observer } from 'mobx-react-lite';
+import { useEffect, useId, useMemo, useRef, useState } from 'react';
+import { createPortal } from 'react-dom';
+import { CUBE_TOUR_ANCHOR_ATTRIBUTE, CUBE_TOUR_LABEL, } from '../../__lib__/LegendCubeTour.js';
+import { CubeButton } from '../CubeButton.js';
+/**
+ * Above the canvas, the grid and the node editor (1250), below MUI's dialogs
+ * (1300); inside the dialog that hosts the page, if one does
+ */
+export const CUBE_TOUR_Z_INDEX = 1290;
+/** Room around the controls shown, and between them and the card */
+const PADDING = 4;
+const GAP = 12;
+/** The card's width (Legend's root is 62.5%, so it is written in pixels) */
+const CARD_WIDTH = 340;
+const DIM = 'rgba(0, 0, 0, 0.45)';
+const MODIFIERS = [
+    { name: 'offset', options: { offset: [0, GAP + PADDING] } },
+    { name: 'flip', options: { padding: GAP } },
+    {
+        name: 'preventOverflow',
+        options: { rootBoundary: 'viewport', padding: GAP, altAxis: true },
+    },
+];
+/** The page's controls that carry the anchor */
+const findAnchored = (root, anchor) => Array.from(root.querySelectorAll(`[${CUBE_TOUR_ANCHOR_ATTRIBUTE}~="${anchor}"]`));
+/** The box around the anchor's controls that have a size; none if none has */
+const boxOf = (root, anchor) => findAnchored(root, anchor)
+    .map((element) => element.getBoundingClientRect())
+    .filter((rect) => rect.width > 0 || rect.height > 0)
+    .reduce((box, rect) => {
+    if (!box) {
+        return {
+            left: rect.left,
+            top: rect.top,
+            width: rect.width,
+            height: rect.height,
+        };
+    }
+    const left = Math.min(box.left, rect.left);
+    const top = Math.min(box.top, rect.top);
+    return {
+        left,
+        top,
+        width: Math.max(box.left + box.width, rect.right) - left,
+        height: Math.max(box.top + box.height, rect.bottom) - top,
+    };
+}, undefined);
+const isSameBox = (a, b) => a === b ||
+    (a !== undefined &&
+        b !== undefined &&
+        a.left === b.left &&
+        a.top === b.top &&
+        a.width === b.width &&
+        a.height === b.height);
+/**
+ * The editor's guided tour (PLAN §11.21): the page dimmed but for the
+ * current step's controls, and a card beside them, or in the middle of the
+ * page for a step that points at nothing. The controls are followed as the
+ * page moves them (a panel resized, the grid loaded). Clicks on the page
+ * are held while it shows; Esc ends it, the arrow keys move through it.
+ */
+export const CubeTour = observer((props) => {
+    const { editorState, root } = props;
+    const { tour } = editorState;
+    const { step } = tour;
+    const titleId = useId();
+    const textId = useId();
+    const [box, setBox] = useState(undefined);
+    const popperRef = useRef(null);
+    const isShown = useMemo(() => (candidate) => candidate.anchor === undefined ||
+        (root !== null && findAnchored(root, candidate.anchor).length > 0), [root]);
+    // the step's controls followed, frame by frame, while it shows
+    const anchor = step?.anchor;
+    useEffect(() => {
+        if (anchor === undefined || !root) {
+            setBox(undefined);
+            return undefined;
+        }
+        let frame = 0;
+        const follow = () => {
+            const next = boxOf(root, anchor);
+            setBox((current) => (isSameBox(current, next) ? current : next));
+            frame = requestAnimationFrame(follow);
+        };
+        follow();
+        return () => cancelAnimationFrame(frame);
+    }, [anchor, root]);
+    useEffect(() => {
+        popperRef.current?.update().catch(noop());
+    }, [box]);
+    // the tour's keys come first: the page's shortcuts wait while it shows
+    const isOpen = step !== undefined;
+    useEffect(() => {
+        if (!isOpen) {
+            return undefined;
+        }
+        const onKeyDown = (event) => {
+            if (event.key === 'Escape') {
+                tour.close();
+            }
+            else if (event.key === 'ArrowRight') {
+                tour.move(1, isShown);
+            }
+            else if (event.key === 'ArrowLeft') {
+                tour.move(-1, isShown);
+            }
+            else {
+                return;
+            }
+            event.preventDefault();
+            event.stopPropagation();
+        };
+        window.addEventListener('keydown', onKeyDown, true);
+        return () => window.removeEventListener('keydown', onKeyDown, true);
+    }, [isOpen, tour, isShown]);
+    const spotlight = useMemo(() => box && {
+        left: box.left - PADDING,
+        top: box.top - PADDING,
+        width: box.width + 2 * PADDING,
+        height: box.height + 2 * PADDING,
+    }, [box]);
+    // the popper reads the spotlight wherever it places the card
+    const latest = useRef(spotlight);
+    latest.current = spotlight;
+    const virtualAnchor = useMemo(() => ({
+        getBoundingClientRect: () => {
+            const current = latest.current ?? {
+                left: 0,
+                top: 0,
+                width: 0,
+                height: 0,
+            };
+            return DOMRect.fromRect({
+                x: current.left,
+                y: current.top,
+                width: current.width,
+                height: current.height,
+            });
+        },
+    }), []);
+    if (!step || !root) {
+        return null;
+    }
+    // counted over the whole tour, steady while an example loads and adds
+    // the controls of later steps; a step skipped skips its number
+    const position = tour.index + 1;
+    const isLast = tour.steps.filter(isShown).at(-1) === step;
+    // a page hosted in a dialog, as Studio hosts Cube, keeps the tour in the
+    // dialog's layer, above the page
+    const container = root.closest('.MuiDialog-root') ?? root.ownerDocument.body;
+    const card = (_jsxs("div", { className: "legend-cube__tour flex flex-col gap-2 rounded-md border border-[var(--color-border-default)] bg-[var(--color-bg-elevated)] p-3 text-[var(--color-text-primary)] shadow-lg", style: { width: CARD_WIDTH, maxWidth: `calc(100vw - ${2 * GAP}px)` }, role: "dialog", "aria-modal": "true", "aria-labelledby": titleId, "aria-describedby": textId, children: [_jsxs("div", { className: "flex items-baseline gap-2", children: [_jsx("h2", { id: titleId, className: "min-w-0 flex-1 text-lg font-medium", children: step.title }), _jsx("span", { className: "shrink-0 text-sm text-[var(--color-text-secondary)]", children: CUBE_TOUR_LABEL.progress(position, tour.steps.length) })] }), _jsxs("p", { id: textId, className: "text-base leading-snug", children: [step.text, tour.openedExample && tour.index === 0 && (_jsxs(_Fragment, { children: [" ", CUBE_TOUR_LABEL.EXAMPLE_OPENED] }))] }), _jsxs("div", { className: "flex items-center gap-2", children: [!isLast && (_jsx("button", { type: "button", className: "text-sm text-[var(--color-text-secondary)] underline hover:text-[var(--color-text-primary)]", onClick: () => tour.close(), children: CUBE_TOUR_LABEL.END })), _jsx("span", { className: "flex-1" }), position > 1 && (_jsx(CubeButton, { onClick: () => tour.move(-1, isShown), children: CUBE_TOUR_LABEL.BACK })), _jsx(CubeButton, { primary: true, 
+                        // the keyboard follows the tour: Enter moves on
+                        autoFocus: true, onClick: () => tour.move(1, isShown), children: isLast ? CUBE_TOUR_LABEL.DONE : CUBE_TOUR_LABEL.NEXT })] })] }, tour.index));
+    return createPortal(_jsx("div", { className: "legend-cube__tour-layer", style: { position: 'fixed', inset: 0, zIndex: CUBE_TOUR_Z_INDEX }, 
+        // the page underneath takes no clicks, and shows no menu, meanwhile
+        onContextMenu: (event) => event.preventDefault(), children: spotlight ? (_jsxs(_Fragment, { children: [_jsx("div", { "aria-hidden": true, style: {
+                        position: 'fixed',
+                        ...spotlight,
+                        borderRadius: 6,
+                        boxShadow: `0 0 0 2px var(--color-accent), 0 0 0 9999px ${DIM}`,
+                        pointerEvents: 'none',
+                    } }), _jsx(BasePopper, { open: true, role: "presentation", popperRef: popperRef, anchorEl: virtualAnchor, container: container, placement: step.placement ?? 'bottom', modifiers: MODIFIERS, style: { zIndex: CUBE_TOUR_Z_INDEX + 1 }, children: card })] })) : (_jsx("div", { className: "flex items-center justify-center", style: { position: 'fixed', inset: 0, background: DIM }, children: card })) }), container);
+});
+//# sourceMappingURL=CubeTour.js.map

package/lib/components/tour/CubeTour.js.map

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

package/lib/index.css

@@ -1,4 +1,4 @@
-/** @license @finos/legend-cube-builder v0.0.5
+/** @license @finos/legend-cube-builder v0.0.6
  * Copyright (c) 2020-present, Goldman Sachs
  *
  * Licensed under the Apache License, Version 2.0 (the "License");

package/lib/index.d.ts

@@ -36,6 +36,7 @@ export { getRuntimesForDatabase } from './graph-manager/CubeModelOutlineHelper.j
 export { buildCubeConnectionExplorer, buildCubeDataProductCatalog, buildCubeIngestCatalog, buildCubeEngine, buildCubeLakehouseEnvironment, buildCubeProjectCatalog, buildCubeServiceCatalog, readCubeIngestDataSets, serializeCubeLambdaForHost, type CubeEngineConfig, type CubeLakehouseServices, } from './graph-manager/protocol/pure/CubeEngineBuilder.js';
 export type { CubeLakehouseEnvironment } from './graph-manager/CubeLakehouseEnvironment.js';
 export { type CubeHost, type CubeHostProject, type CubeHostProjectRuntime, isCubeProjectHost, isCubeSampleDataOffered, } from './stores/CubeHost.js';
+export { buildLegendCubeLakehouseServices, buildLegendCubeProjectCatalog, LegendCubeHost, type LegendCubeHostConfig, type LegendCubeHostParts, } from './stores/LegendCubeHost.js';
 export { getCubeRememberedWarehouse } from './stores/CubeDataProductWarehouse.js';
 export { CUBE_LAMBDA_IMPORT_MESSAGE, CubeLambdaFidelity, getCubeLambdaFidelity, readCubeLambdaDocument, type CubeInitialLambda, type CubeLambdaImportState, type CubeLambdaReading, } from './stores/CubeLambdaImportState.js';
 export { bindCubeLambdaSources, CUBE_LAMBDA_SOURCES_MESSAGE, type CubeLambdaBinding, } from './stores/CubeLambdaSources.js';

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAChF,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,4BAA4B,GAC7B,MAAM,6BAA6B,CAAC;AAErC,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,sBAAsB,EACtB,eAAe,EACf,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,oDAAoD,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AAC5F,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,GACvB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,KAAK,iBAAiB,GACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,cAAc,EACd,KAAK,YAAY,EACjB,eAAe,EACf,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAChF,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,4BAA4B,GAC7B,MAAM,6BAA6B,CAAC;AAErC,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,sBAAsB,EACtB,eAAe,EACf,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,oDAAoD,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AAC5F,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gCAAgC,EAChC,6BAA6B,EAC7B,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,GACvB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,KAAK,iBAAiB,GACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,cAAc,EACd,KAAK,YAAY,EACjB,eAAe,EACf,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,yCAAyC,CAAC"}

package/lib/index.js

@@ -34,6 +34,7 @@ export * from './graph-manager/CubeServiceCatalog.js';
 export { getRuntimesForDatabase } from './graph-manager/CubeModelOutlineHelper.js';
 export { buildCubeConnectionExplorer, buildCubeDataProductCatalog, buildCubeIngestCatalog, buildCubeEngine, buildCubeLakehouseEnvironment, buildCubeProjectCatalog, buildCubeServiceCatalog, readCubeIngestDataSets, serializeCubeLambdaForHost, } from './graph-manager/protocol/pure/CubeEngineBuilder.js';
 export { isCubeProjectHost, isCubeSampleDataOffered, } from './stores/CubeHost.js';
+export { buildLegendCubeLakehouseServices, buildLegendCubeProjectCatalog, LegendCubeHost, } from './stores/LegendCubeHost.js';
 export { getCubeRememberedWarehouse } from './stores/CubeDataProductWarehouse.js';
 export { CUBE_LAMBDA_IMPORT_MESSAGE, CubeLambdaFidelity, getCubeLambdaFidelity, readCubeLambdaDocument, } from './stores/CubeLambdaImportState.js';
 export { bindCubeLambdaSources, CUBE_LAMBDA_SOURCES_MESSAGE, } from './stores/CubeLambdaSources.js';

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,UAAU,EAA0B,MAAM,4BAA4B,CAAC;AAEhF,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAGL,4BAA4B,GAC7B,MAAM,6BAA6B,CAAC;AAErC,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,sBAAsB,EACtB,eAAe,EACf,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,GAG3B,MAAM,oDAAoD,CAAC;AAE5D,OAAO,EAIL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GAIvB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,qBAAqB,EACrB,2BAA2B,GAE5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,cAAc,EAEd,eAAe,EACf,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,UAAU,EAA0B,MAAM,4BAA4B,CAAC;AAEhF,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAGL,4BAA4B,GAC7B,MAAM,6BAA6B,CAAC;AAErC,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,sBAAsB,EACtB,eAAe,EACf,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,GAG3B,MAAM,oDAAoD,CAAC;AAE5D,OAAO,EAIL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gCAAgC,EAChC,6BAA6B,EAC7B,cAAc,GAGf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GAIvB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,qBAAqB,EACrB,2BAA2B,GAE5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,cAAc,EAEd,eAAe,EACf,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,yCAAyC,CAAC"}

package/lib/stores/CubeEditorState.d.ts

@@ -19,6 +19,7 @@ import type { GeneratorFn } from '@finos/legend-shared';
 import { CubeEngineError, type CubeModelOutline } from '../graph-manager/CubeEngine.js';
 import { CubeDataProductRuntimeState } from './CubeDataProductRuntimeState.js';
 import { CubeExamplesState } from './CubeExamplesState.js';
+import { CubeTourState } from './CubeTourState.js';
 import { CubeExportState } from './CubeExportState.js';
 import { CubeGridFetcher } from './CubeGridFetcher.js';
 import { CubeGridState } from './CubeGridState.js';
@@ -29,6 +30,8 @@ import { type CubeEngineCheckedNode } from './CubeEngineChecks.js';
 import { type CubeHost } from './CubeHost.js';
 import { CubeNodeEditorState } from './CubeNodeEditorState.js';
 import { CubeShowPureState } from './CubeShowPureState.js';
+import { CubeJsonViewerState } from './variant/CubeJsonViewerState.js';
+import { CubeJsonExplorerState } from './variant/CubeJsonExplorerState.js';
 import { CubeLambdaImportState } from './CubeLambdaImportState.js';
 import { CubeSourcePickerState } from './CubeSourcePickerState.js';
 import { CubeSpecTransferState } from './CubeSpecTransferState.js';
@@ -78,6 +81,12 @@ export declare class CubeEditorState implements CommandRegistrar {
     readonly specTransfer: CubeSpecTransferState;
     readonly examples: CubeExamplesState;
     readonly showPure: CubeShowPureState;
+    /** The editor's guided tour (PLAN §11.21) */
+    readonly tour: CubeTourState;
+    /** Open JSON: a Variant cell's document as a tree (PLAN §11.20) */
+    readonly jsonViewer: CubeJsonViewerState;
+    /** Explore JSON: a Variant column's fields, and the columns they can become (PLAN §11.20) */
+    readonly jsonExplorer: CubeJsonExplorerState;
     /** Import Pure: the lambda the page opened on, read into the cube (PLAN §11.18) */
     readonly lambdaImport: CubeLambdaImportState;
     readonly nodeEditor: CubeNodeEditorState;
@@ -238,7 +247,7 @@ export declare class CubeEditorState implements CommandRegistrar {
      * way.
      */
     loadModelOutline(model?: ModelContext | undefined): GeneratorFn<void>;
-    /** One of Cube's dialogs is open: the source picker, Examples, the group rows' settings, Import or Export, Show Pure */
+    /** One of Cube's dialogs is open: the source picker, Examples, the group rows' settings, Import or Export, Show Pure, or the tour */
     get isDialogOpen(): boolean;
     /**
      * The page's keyboard shortcuts, while it is open (spec §17.12). Each does
@@ -392,6 +401,13 @@ export declare class CubeEditorState implements CommandRegistrar {
      * read-only cube, or when the query can't take it.
      */
     addConfiguredNode(node: QueryNode, afterId?: string): void;
+    /**
+     * Adds nodes made elsewhere one after another, the first spliced in after
+     * `afterId`, as one undo step, the last then running when that one did
+     * (Explore JSON's Extend then Explode Array). Does nothing in a read-only
+     * cube, or when the query can't take one of them.
+     */
+    addConfiguredNodes(nodes: readonly QueryNode[], afterId?: string): void;
     /** Whether dropping a node on another does anything: connect it, or else move it after it */
     canDropNode(nodeId: string, targetId: string): boolean;
     /**

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

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

package/lib/stores/CubeEditorState.js

@@ -33,6 +33,7 @@ import { CUBE_FUNCTION_MESSAGE, getFunctionDriftWarning, getFunctionRecheckWarni
 import { recheckCubeFunctionSources } from './CubeFunctionRecheck.js';
 import { CubeDataProductRuntimeState } from './CubeDataProductRuntimeState.js';
 import { CubeExamplesState } from './CubeExamplesState.js';
+import { CubeTourState } from './CubeTourState.js';
 import { CubeExportState } from './CubeExportState.js';
 import { CubeGridFetcher } from './CubeGridFetcher.js';
 import { CubeGridState } from './CubeGridState.js';
@@ -46,6 +47,8 @@ import { getCubeExtendUpstream } from './CubeExtendTyping.js';
 import { loadCubeModelOutline } from './CubeHost.js';
 import { CubeNodeEditorState } from './CubeNodeEditorState.js';
 import { CubeShowPureState } from './CubeShowPureState.js';
+import { CubeJsonViewerState } from './variant/CubeJsonViewerState.js';
+import { CubeJsonExplorerState } from './variant/CubeJsonExplorerState.js';
 import { CubeLambdaImportState } from './CubeLambdaImportState.js';
 import { CubeSourcePickerState } from './CubeSourcePickerState.js';
 import { CubeSpecTransferState } from './CubeSpecTransferState.js';
@@ -98,6 +101,12 @@ export class CubeEditorState {
     specTransfer;
     examples;
     showPure;
+    /** The editor's guided tour (PLAN §11.21) */
+    tour;
+    /** Open JSON: a Variant cell's document as a tree (PLAN §11.20) */
+    jsonViewer = new CubeJsonViewerState();
+    /** Explore JSON: a Variant column's fields, and the columns they can become (PLAN §11.20) */
+    jsonExplorer;
     /** Import Pure: the lambda the page opened on, read into the cube (PLAN §11.18) */
     lambdaImport;
     nodeEditor;
@@ -201,6 +210,7 @@ export class CubeEditorState {
             connect: action,
             addNode: action,
             addConfiguredNode: action,
+            addConfiguredNodes: action,
             dropNode: action,
             removeNode: action,
             copiedNode: observable.ref,
@@ -243,6 +253,8 @@ export class CubeEditorState {
         this.specTransfer = new CubeSpecTransferState(this);
         this.examples = new CubeExamplesState(this);
         this.showPure = new CubeShowPureState(this);
+        this.tour = new CubeTourState(this);
+        this.jsonExplorer = new CubeJsonExplorerState(this);
         this.lambdaImport = new CubeLambdaImportState(this);
         this.nodeEditor = new CubeNodeEditorState(this);
         this.rechecking = reaction(() => this.nodesToCheck, (waiting) => {
@@ -546,14 +558,15 @@ export class CubeEditorState {
             this.loadingOutlines.delete(key);
         }
     }
-    /** One of Cube's dialogs is open: the source picker, Examples, the group rows' settings, Import or Export, Show Pure */
+    /** One of Cube's dialogs is open: the source picker, Examples, the group rows' settings, Import or Export, Show Pure, or the tour */
     get isDialogOpen() {
         return (this.sourcePicker.isOpen ||
             this.examples.isOpen ||
             this.grid.isSettingsShown ||
             this.grid.formatColumn !== undefined ||
             this.specTransfer.mode !== undefined ||
-            this.showPure.isOpen);
+            this.showPure.isOpen ||
+            this.tour.isOpen);
     }
     /**
      * The page's keyboard shortcuts, while it is open (spec §17.12). Each does
@@ -1133,11 +1146,28 @@ export class CubeEditorState {
      * read-only cube, or when the query can't take it.
      */
     addConfiguredNode(node, afterId) {
-        const { query } = this.document;
-        if (this.readOnly || !query.canAdd(node, afterId)) {
+        this.addConfiguredNodes([node], afterId);
+    }
+    /**
+     * Adds nodes made elsewhere one after another, the first spliced in after
+     * `afterId`, as one undo step, the last then running when that one did
+     * (Explore JSON's Extend then Explode Array). Does nothing in a read-only
+     * cube, or when the query can't take one of them.
+     */
+    addConfiguredNodes(nodes, afterId) {
+        if (this.readOnly || !nodes.length) {
             return;
         }
-        this.applyQuery(query.add(node, afterId));
+        let query = this.document.query;
+        let after = afterId;
+        for (const node of nodes) {
+            if (!query.canAdd(node, after)) {
+                return;
+            }
+            query = query.add(node, after);
+            after = node.id;
+        }
+        this.applyQuery(query);
     }
     /** Whether dropping a node on another does anything: connect it, or else move it after it */
     canDropNode(nodeId, targetId) {