@finos/legend-cube-builder 0.0.0-stage → 0.0.2

package/lib/components/canvas/CubeCanvasContextMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeCanvasContextMenu.d.ts","sourceRoot":"","sources":["../../../src/components/canvas/CubeCanvasContextMenu.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAYH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGvE;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;iBAGf,eAAe;aAAW,MAAM,GAAG,SAAS;2GAiD9D,CAAC"}

package/lib/components/canvas/CubeCanvasContextMenu.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx, jsxs as _jsxs } 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 { MenuContent, MenuContentDivider, MenuContentItem, MenuContentItemIcon, MenuContentItemLabel, } from '@finos/legend-art';
+import { observer } from 'mobx-react-lite';
+import { forwardRef } from 'react';
+import { CubeNodeIcon } from '../CubeNodeIcon.js';
+/**
+ * The canvas's context menu (spec §17.4): the palette, then what can be done
+ * to the node it was opened on. On a node, a palette item is added after it;
+ * around the nodes, on its own. Every item shows, disabled when it can't be
+ * done, so Swap Inputs can be found. The node comes through props: a menu
+ * opened around the nodes has none.
+ */
+export const CubeCanvasContextMenu = observer(forwardRef(function CubeCanvasContextMenu(props, ref) {
+    const { editorState, nodeId } = props;
+    const { query } = editorState.document;
+    const { registry } = editorState;
+    const paletteItem = (definition) => (_jsxs(MenuContentItem, { disabled: !editorState.canAddNode(definition.type, nodeId), onClick: () => editorState.addNode(definition.type, nodeId), children: [_jsx(MenuContentItemIcon, { children: _jsx(CubeNodeIcon, { icon: definition.icon }) }), _jsxs(MenuContentItemLabel, { children: [definition.label, definition.beta ? ' (BETA)' : ''] })] }, definition.type));
+    return (_jsxs(MenuContent, { ref: ref, children: [registry.sources.map(paletteItem), _jsx(MenuContentDivider, {}), registry.transforms.map(paletteItem), _jsx(MenuContentDivider, {}), _jsx(MenuContentItem, { title: "Execute runs the query up to this node", disabled: nodeId === undefined || !query.canSelect(nodeId), onClick: () => nodeId !== undefined && editorState.select(nodeId), children: "Select" }), _jsx(MenuContentItem, { disabled: nodeId === undefined || !editorState.canRemoveNode(nodeId), onClick: () => nodeId !== undefined && editorState.removeNode(nodeId), children: "Remove" }), _jsx(MenuContentItem, { title: "Swap the node's two inputs, e.g. a Join's Left and Right", disabled: nodeId === undefined || !editorState.canSwapInputs(nodeId), onClick: () => nodeId !== undefined && editorState.swapInputs(nodeId), children: "Swap Inputs" })] }));
+}));
+//# sourceMappingURL=CubeCanvasContextMenu.js.map

package/lib/components/canvas/CubeCanvasContextMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeCanvasContextMenu.js","sourceRoot":"","sources":["../../../src/components/canvas/CubeCanvasContextMenu.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAC3C,UAAU,CAGR,SAAS,qBAAqB,CAAC,KAAK,EAAE,GAAG;IACzC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IACtC,MAAM,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC;IACvC,MAAM,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC;IACjC,MAAM,WAAW,GAAG,CAAC,UAA6B,EAAmB,EAAE,CAAC,CACtE,MAAC,eAAe,IAEd,QAAQ,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,EAC1D,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,aAE3D,KAAC,mBAAmB,cAClB,KAAC,YAAY,IAAC,IAAI,EAAE,UAAU,CAAC,IAAI,GAAI,GACnB,EACtB,MAAC,oBAAoB,eAClB,UAAU,CAAC,KAAK,EAChB,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IACZ,KAVlB,UAAU,CAAC,IAAI,CAWJ,CACnB,CAAC;IACF,OAAO,CACL,MAAC,WAAW,IAAC,GAAG,EAAE,GAAG,aAClB,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAClC,KAAC,kBAAkB,KAAG,EACrB,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,EACrC,KAAC,kBAAkB,KAAG,EACtB,KAAC,eAAe,IACd,KAAK,EAAC,wCAAwC,EAC9C,QAAQ,EAAE,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,EAC1D,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,KAAK,SAAS,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,uBAGjD,EAClB,KAAC,eAAe,IACd,QAAQ,EAAE,MAAM,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,EACpE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,KAAK,SAAS,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,uBAGrD,EAClB,KAAC,eAAe,IACd,KAAK,EAAC,0DAA0D,EAChE,QAAQ,EAAE,MAAM,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,EACpE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,KAAK,SAAS,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,4BAGrD,IACN,CACf,CAAC;AACJ,CAAC,CAAC,CACH,CAAC"}

package/lib/components/canvas/CubeCanvasDnd.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 type { CubeEditorState } from '../../stores/CubeEditorState.js';
+export declare enum CUBE_DND_TYPE {
+    PALETTE_ITEM = "legend-cube.palette-item",
+    NODE = "legend-cube.node"
+}
+/** A palette item carries the type of node it adds */
+export interface CubePaletteDragItem {
+    readonly nodeType: string;
+}
+/** A node carries only its id */
+export interface CubeNodeDragItem {
+    readonly nodeId: string;
+}
+export type CubeDragItem = CubePaletteDragItem | CubeNodeDragItem;
+/**
+ * Whether dropping the item on the node does anything, which also decides
+ * whether the node lights up under it: a palette item is spliced in after
+ * the node, another node connects to it or else moves after it
+ */
+export declare const canDropOnCubeNode: (editorState: CubeEditorState, item: CubeDragItem, targetId: string) => boolean;
+export declare const dropOnCubeNode: (editorState: CubeEditorState, item: CubeDragItem, targetId: string) => void;
+/**
+ * A palette item dropped on the canvas around the nodes: a transform is
+ * added unconnected, a source opens the picker. A drop on a node is the
+ * node's, taken or refused, never the canvas's.
+ */
+export declare const dropOnCubeCanvas: (editorState: CubeEditorState, item: CubeDragItem, isOverNode: boolean) => void;
+//# sourceMappingURL=CubeCanvasDnd.d.ts.map

package/lib/components/canvas/CubeCanvasDnd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeCanvasDnd.d.ts","sourceRoot":"","sources":["../../../src/components/canvas/CubeCanvasDnd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAMvE,oBAAY,aAAa;IACvB,YAAY,6BAA6B;IACzC,IAAI,qBAAqB;CAC1B;AAED,sDAAsD;AACtD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;AAKlE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,aAAa,eAAe,EAC5B,MAAM,YAAY,EAClB,UAAU,MAAM,KACf,OAGkD,CAAC;AAEtD,eAAO,MAAM,cAAc,GACzB,aAAa,eAAe,EAC5B,MAAM,YAAY,EAClB,UAAU,MAAM,KACf,IAMF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,aAAa,eAAe,EAC5B,MAAM,YAAY,EAClB,YAAY,OAAO,KAClB,IAIF,CAAC"}

package/lib/components/canvas/CubeCanvasDnd.js

@@ -0,0 +1,51 @@
+/**
+ * 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.
+ */
+// Drag and drop on the canvas (spec §17.3): palette items and nodes are
+// dragged; nodes and the canvas take drops. The app's HTML5 backend provider
+// wraps every Legend application, so Cube mounts none of its own.
+export var CUBE_DND_TYPE;
+(function (CUBE_DND_TYPE) {
+    CUBE_DND_TYPE["PALETTE_ITEM"] = "legend-cube.palette-item";
+    CUBE_DND_TYPE["NODE"] = "legend-cube.node";
+})(CUBE_DND_TYPE || (CUBE_DND_TYPE = {}));
+const isNodeDragItem = (item) => 'nodeId' in item;
+/**
+ * Whether dropping the item on the node does anything, which also decides
+ * whether the node lights up under it: a palette item is spliced in after
+ * the node, another node connects to it or else moves after it
+ */
+export const canDropOnCubeNode = (editorState, item, targetId) => isNodeDragItem(item)
+    ? editorState.canDropNode(item.nodeId, targetId)
+    : editorState.canAddNode(item.nodeType, targetId);
+export const dropOnCubeNode = (editorState, item, targetId) => {
+    if (isNodeDragItem(item)) {
+        editorState.dropNode(item.nodeId, targetId);
+    }
+    else {
+        editorState.addNode(item.nodeType, targetId);
+    }
+};
+/**
+ * A palette item dropped on the canvas around the nodes: a transform is
+ * added unconnected, a source opens the picker. A drop on a node is the
+ * node's, taken or refused, never the canvas's.
+ */
+export const dropOnCubeCanvas = (editorState, item, isOverNode) => {
+    if (!isOverNode && !isNodeDragItem(item)) {
+        editorState.addNode(item.nodeType);
+    }
+};
+//# sourceMappingURL=CubeCanvasDnd.js.map

package/lib/components/canvas/CubeCanvasDnd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeCanvasDnd.js","sourceRoot":"","sources":["../../../src/components/canvas/CubeCanvasDnd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,wEAAwE;AACxE,6EAA6E;AAC7E,kEAAkE;AAElE,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,0DAAyC,CAAA;IACzC,0CAAyB,CAAA;AAC3B,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB;AAcD,MAAM,cAAc,GAAG,CAAC,IAAkB,EAA4B,EAAE,CACtE,QAAQ,IAAI,IAAI,CAAC;AAEnB;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,WAA4B,EAC5B,IAAkB,EAClB,QAAgB,EACP,EAAE,CACX,cAAc,CAAC,IAAI,CAAC;IAClB,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC;IAChD,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,WAA4B,EAC5B,IAAkB,EAClB,QAAgB,EACV,EAAE;IACR,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,WAA4B,EAC5B,IAAkB,EAClB,UAAmB,EACb,EAAE;IACR,IAAI,CAAC,UAAU,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;AACH,CAAC,CAAC"}

package/lib/components/canvas/CubeCanvasEdge.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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 EdgeProps } from '@xyflow/react';
+import type { CubeCanvasFlowEdge } from './CubeCanvasElements.js';
+/**
+ * A connection, with its port's label (Left or Right on a Join) shown as text
+ * beside the input it feeds, not in a tooltip (spec §17.3). The label is HTML:
+ * React Flow's own edge label measures SVG text, which jsdom can't.
+ */
+export declare const CubeCanvasEdge: React.FC<EdgeProps<CubeCanvasFlowEdge>>;
+//# sourceMappingURL=CubeCanvasEdge.d.ts.map

package/lib/components/canvas/CubeCanvasEdge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeCanvasEdge.d.ts","sourceRoot":"","sources":["../../../src/components/canvas/CubeCanvasEdge.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAGL,KAAK,SAAS,EAEf,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAKlE;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAuBlE,CAAC"}

package/lib/components/canvas/CubeCanvasEdge.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } 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 { BaseEdge, EdgeLabelRenderer, getBezierPath, } from '@xyflow/react';
+import { LEGEND_CUBE_TEST_ID } from '../../__lib__/LegendCubeTesting.js';
+/** The gap between an input's label and the node it feeds */
+const LABEL_GAP = 6;
+/**
+ * A connection, with its port's label (Left or Right on a Join) shown as text
+ * beside the input it feeds, not in a tooltip (spec §17.3). The label is HTML:
+ * React Flow's own edge label measures SVG text, which jsdom can't.
+ */
+export const CubeCanvasEdge = (props) => {
+    const { id, targetX, targetY, markerEnd, data } = props;
+    const [path] = getBezierPath(props);
+    return (_jsxs(_Fragment, { children: [_jsx(BaseEdge, { id: id, path: path, markerEnd: markerEnd }), data?.label && (_jsx(EdgeLabelRenderer, { children: _jsx("div", { className: "absolute rounded bg-[var(--color-bg-panel)] px-1 text-sm text-[var(--color-text-secondary)]", style: {
+                        transform: `translate(-100%, -100%) translate(${targetX - LABEL_GAP}px, ${targetY - 2}px)`,
+                    }, "data-testid": LEGEND_CUBE_TEST_ID.CANVAS_EDGE_LABEL, children: data.label }) }))] }));
+};
+//# sourceMappingURL=CubeCanvasEdge.js.map

package/lib/components/canvas/CubeCanvasEdge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeCanvasEdge.js","sourceRoot":"","sources":["../../../src/components/canvas/CubeCanvasEdge.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,QAAQ,EACR,iBAAiB,EAEjB,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAGzE,6DAA6D;AAC7D,MAAM,SAAS,GAAG,CAAC,CAAC;AAEpB;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAA4C,CACrE,KAAK,EACL,EAAE;IACF,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IACxD,MAAM,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,CACL,8BACE,KAAC,QAAQ,IAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,GAAI,EACrD,IAAI,EAAE,KAAK,IAAI,CACd,KAAC,iBAAiB,cAChB,cACE,SAAS,EAAC,6FAA6F,EACvG,KAAK,EAAE;wBACL,SAAS,EAAE,qCAAqC,OAAO,GAAG,SAAS,OAAO,OAAO,GAAG,CAAC,KAAK;qBAC3F,iBACY,mBAAmB,CAAC,iBAAiB,YAEjD,IAAI,CAAC,KAAK,GACP,GACY,CACrB,IACA,CACJ,CAAC;AACJ,CAAC,CAAC"}

package/lib/components/canvas/CubeCanvasElements.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 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 Query, type QueryNode } from '@finos/legend-cube';
+import { type Edge, type Node } from '@xyflow/react';
+import type { CubeEditorState } from '../../stores/CubeEditorState.js';
+import { type CubeCanvasPosition } from './CubeCanvasLayout.js';
+export declare const CUBE_CANVAS_NODE_TYPE = "cube";
+export declare const CUBE_CANVAS_EDGE_TYPE = "cube";
+/** The one output of every node; its inputs are named by its ports */
+export declare const CUBE_OUTPUT_HANDLE_ID = "output";
+/** Shown when a node has no validity entry at all, which inference never leaves out */
+export declare const MISSING_VALIDITY_TOOLTIP = "This node depends on some invalid inputs.";
+export type CubeCanvasNodeData = {
+    readonly node: QueryNode;
+};
+export type CubeCanvasEdgeData = {
+    readonly label: string | undefined;
+};
+export type CubeCanvasFlowNode = Node<CubeCanvasNodeData, 'cube'>;
+export type CubeCanvasFlowEdge = Edge<CubeCanvasEdgeData, 'cube'>;
+type CubeCanvasHandle = NonNullable<Node['handles']>[number];
+/** How far down the node's left side each input handle sits: evenly spaced, in port order */
+export declare const getInputHandleOffset: (index: number, count: number) => number;
+/**
+ * Where the node's handles are, so edges are drawn without measuring the DOM:
+ * its inputs down its left side in port order (a Join's Left above its
+ * Right), its output in the middle of its right side. New objects each time:
+ * React Flow writes into them.
+ */
+export declare const getCubeCanvasHandles: (node: QueryNode) => CubeCanvasHandle[];
+export declare const buildCubeCanvasNodes: (query: Query, positions: ReadonlyMap<string, CubeCanvasPosition>) => CubeCanvasFlowNode[];
+/** Each connection, labelled with its port's label when the target has one, e.g. Left and Right on a Join */
+export declare const buildCubeCanvasEdges: (query: Query) => CubeCanvasFlowEdge[];
+/** How a node looks on the canvas (spec §17.3): each state is its own class modifier */
+export interface CubeCanvasNodeStatus {
+    /** Execute runs the query up to this node */
+    readonly isCapture: boolean;
+    /** It has errors of its own, the query rules' included; not the engine's */
+    readonly isInvalid: boolean;
+    /** An input is missing, or an input is invalid */
+    readonly isIncomplete: boolean;
+    /** The engine is typing its table */
+    readonly isResolving: boolean;
+    /** The last run failed on it */
+    readonly hasEngineError: boolean;
+    /** Its errors, then its warnings, its description and its id, one a line */
+    readonly tooltip: string;
+}
+export declare const getCubeCanvasNodeStatus: (editorState: CubeEditorState, node: QueryNode) => CubeCanvasNodeStatus;
+export {};
+//# sourceMappingURL=CubeCanvasElements.d.ts.map

package/lib/components/canvas/CubeCanvasElements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeCanvasElements.d.ts","sourceRoot":"","sources":["../../../src/components/canvas/CubeCanvasElements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAGL,KAAK,KAAK,EACV,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,IAAI,EAAc,KAAK,IAAI,EAAY,MAAM,eAAe,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAM/B,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAC5C,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAC5C,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,WAAW,CAAC;AAE9C,uFAAuF;AACvF,eAAO,MAAM,wBAAwB,8CACQ,CAAC;AAE9C,MAAM,MAAM,kBAAkB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAC9D,MAAM,MAAM,kBAAkB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACxE,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;AAClE,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;AAClE,KAAK,gBAAgB,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,6FAA6F;AAC7F,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,KAAG,MACb,CAAC;AAExD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,SAAS,KAAG,gBAAgB,EAetE,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,KAAK,EACZ,WAAW,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,KACjD,kBAAkB,EAShB,CAAC;AAEN,6GAA6G;AAC7G,eAAO,MAAM,oBAAoB,GAAI,OAAO,KAAK,KAAG,kBAAkB,EAclE,CAAC;AAEL,wFAAwF;AACxF,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,qCAAqC;IACrC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,gCAAgC;IAChC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,uBAAuB,GAClC,aAAa,eAAe,EAC5B,MAAM,SAAS,KACd,oBAuBF,CAAC"}

package/lib/components/canvas/CubeCanvasElements.js

@@ -0,0 +1,96 @@
+/**
+ * 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 { isIncompleteError, isSchemasError, } from '@finos/legend-cube';
+import { MarkerType, Position } from '@xyflow/react';
+import { CUBE_CANVAS_NODE_HEIGHT, CUBE_CANVAS_NODE_WIDTH, } from './CubeCanvasLayout.js';
+// The query as React Flow draws it: one node per query node, one edge per
+// connection. Rebuilt from the query on every change; React Flow keeps no
+// state of its own that matters (PLAN §7.2)
+export const CUBE_CANVAS_NODE_TYPE = 'cube';
+export const CUBE_CANVAS_EDGE_TYPE = 'cube';
+/** The one output of every node; its inputs are named by its ports */
+export const CUBE_OUTPUT_HANDLE_ID = 'output';
+/** Shown when a node has no validity entry at all, which inference never leaves out */
+export const MISSING_VALIDITY_TOOLTIP = 'This node depends on some invalid inputs.';
+/** How far down the node's left side each input handle sits: evenly spaced, in port order */
+export const getInputHandleOffset = (index, count) => (CUBE_CANVAS_NODE_HEIGHT * (index + 1)) / (count + 1);
+/**
+ * Where the node's handles are, so edges are drawn without measuring the DOM:
+ * its inputs down its left side in port order (a Join's Left above its
+ * Right), its output in the middle of its right side. New objects each time:
+ * React Flow writes into them.
+ */
+export const getCubeCanvasHandles = (node) => [
+    ...node.ports.map((port, index) => ({
+        id: port,
+        type: 'target',
+        position: Position.Left,
+        x: 0,
+        y: getInputHandleOffset(index, node.ports.length),
+    })),
+    {
+        id: CUBE_OUTPUT_HANDLE_ID,
+        type: 'source',
+        position: Position.Right,
+        x: CUBE_CANVAS_NODE_WIDTH,
+        y: CUBE_CANVAS_NODE_HEIGHT / 2,
+    },
+];
+export const buildCubeCanvasNodes = (query, positions) => query.nodes.map((node) => ({
+    id: node.id,
+    type: CUBE_CANVAS_NODE_TYPE,
+    position: { ...(positions.get(node.id) ?? { x: 0, y: 0 }) },
+    width: CUBE_CANVAS_NODE_WIDTH,
+    height: CUBE_CANVAS_NODE_HEIGHT,
+    handles: getCubeCanvasHandles(node),
+    data: { node },
+}));
+/** Each connection, labelled with its port's label when the target has one, e.g. Left and Right on a Join */
+export const buildCubeCanvasEdges = (query) => query.connections.map((connection) => {
+    const target = query.getNode(connection.target);
+    const label = target?.portLabels[target.ports.indexOf(connection.port)];
+    return {
+        id: connection.toString(),
+        type: CUBE_CANVAS_EDGE_TYPE,
+        source: connection.source,
+        target: connection.target,
+        sourceHandle: CUBE_OUTPUT_HANDLE_ID,
+        targetHandle: connection.port,
+        markerEnd: { type: MarkerType.ArrowClosed },
+        data: { label },
+    };
+});
+export const getCubeCanvasNodeStatus = (editorState, node) => {
+    const ownErrors = editorState.analysis.validity.get(node.id);
+    // the tooltip adds the engine's error; the states keep it apart
+    const errors = editorState.getNodeErrors(node.id);
+    const warnings = editorState.warnings.get(node.key) ?? [];
+    return {
+        isCapture: editorState.document.query.selected === node.id,
+        isInvalid: (ownErrors ?? []).some((error) => !isIncompleteError(error) && !isSchemasError(error)),
+        isIncomplete: (ownErrors ?? []).some((error) => isIncompleteError(error) || isSchemasError(error)),
+        isResolving: editorState.isPendingSource(node),
+        hasEngineError: editorState.hostIssues.has(node.id),
+        tooltip: [
+            ...(ownErrors ? [] : [MISSING_VALIDITY_TOOLTIP]),
+            ...errors,
+            ...warnings,
+            node.describe(),
+            node.id,
+        ].join('\n'),
+    };
+};
+//# sourceMappingURL=CubeCanvasElements.js.map

package/lib/components/canvas/CubeCanvasElements.js.map

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

package/lib/components/canvas/CubeCanvasLayout.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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 { Query } from '@finos/legend-cube';
+/** Every node is drawn this size, so edges need no DOM measurement (PLAN §7.2) */
+export declare const CUBE_CANVAS_NODE_WIDTH = 200;
+export declare const CUBE_CANVAS_NODE_HEIGHT = 72;
+/** A node's top-left corner on the canvas */
+export interface CubeCanvasPosition {
+    readonly x: number;
+    readonly y: number;
+}
+/**
+ * Where each node goes, laid out left to right (spec §17.3): a pure function
+ * of the query, recomputed on every change, so undo, import and every edit
+ * need no layout state. Nodes go in sorted by id and connections by port,
+ * source and target, so an edit that only reorders them moves nothing.
+ */
+export declare const layoutCubeQuery: (query: Query) => Map<string, CubeCanvasPosition>;
+//# sourceMappingURL=CubeCanvasLayout.d.ts.map

package/lib/components/canvas/CubeCanvasLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeCanvasLayout.d.ts","sourceRoot":"","sources":["../../../src/components/canvas/CubeCanvasLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAc,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE5D,kFAAkF;AAClF,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAK1C,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,KAAK,KACX,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAsChC,CAAC"}

package/lib/components/canvas/CubeCanvasLayout.js

@@ -0,0 +1,63 @@
+/**
+ * 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 dagre from '@dagrejs/dagre';
+/** Every node is drawn this size, so edges need no DOM measurement (PLAN §7.2) */
+export const CUBE_CANVAS_NODE_WIDTH = 200;
+export const CUBE_CANVAS_NODE_HEIGHT = 72;
+const RANK_SEPARATION = 80;
+const NODE_SEPARATION = 32;
+// by code unit, so the order never depends on the locale
+const compareText = (a, b) => a < b ? -1 : a > b ? 1 : 0;
+const compareConnections = (a, b) => compareText(a.port, b.port) ||
+    compareText(a.source, b.source) ||
+    compareText(a.target, b.target);
+/**
+ * Where each node goes, laid out left to right (spec §17.3): a pure function
+ * of the query, recomputed on every change, so undo, import and every edit
+ * need no layout state. Nodes go in sorted by id and connections by port,
+ * source and target, so an edit that only reorders them moves nothing.
+ */
+export const layoutCubeQuery = (query) => {
+    const graph = new dagre.graphlib.Graph({ multigraph: true });
+    graph.setGraph({
+        rankdir: 'LR',
+        ranksep: RANK_SEPARATION,
+        nodesep: NODE_SEPARATION,
+    });
+    graph.setDefaultEdgeLabel(() => ({}));
+    [...query.nodes]
+        .sort((a, b) => compareText(a.id, b.id))
+        .forEach((node) => graph.setNode(node.id, {
+        width: CUBE_CANVAS_NODE_WIDTH,
+        height: CUBE_CANVAS_NODE_HEIGHT,
+    }));
+    [...query.connections]
+        .sort(compareConnections)
+        .forEach((connection) => graph.setEdge(connection.source, connection.target, {}, connection.port));
+    dagre.layout(graph);
+    return new Map(query.nodes.map((node) => {
+        // dagre gives each node's centre
+        const { x, y } = graph.node(node.id);
+        return [
+            node.id,
+            {
+                x: x - CUBE_CANVAS_NODE_WIDTH / 2,
+                y: y - CUBE_CANVAS_NODE_HEIGHT / 2,
+            },
+        ];
+    }));
+};
+//# sourceMappingURL=CubeCanvasLayout.js.map

package/lib/components/canvas/CubeCanvasLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeCanvasLayout.js","sourceRoot":"","sources":["../../../src/components/canvas/CubeCanvasLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,MAAM,gBAAgB,CAAC;AAGnC,kFAAkF;AAClF,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAC1C,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAE1C,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,eAAe,GAAG,EAAE,CAAC;AAQ3B,yDAAyD;AACzD,MAAM,WAAW,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CACnD,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7B,MAAM,kBAAkB,GAAG,CAAC,CAAa,EAAE,CAAa,EAAU,EAAE,CAClE,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IAC3B,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;IAC/B,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;AAElC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,KAAY,EACqB,EAAE;IACnC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAGnC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IACzB,KAAK,CAAC,QAAQ,CAAC;QACb,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,eAAe;QACxB,OAAO,EAAE,eAAe;KACzB,CAAC,CAAC;IACH,KAAK,CAAC,mBAAmB,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;SACb,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;SACvC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAChB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE;QACrB,KAAK,EAAE,sBAAsB;QAC7B,MAAM,EAAE,uBAAuB;KAChC,CAAC,CACH,CAAC;IACJ,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;SACnB,IAAI,CAAC,kBAAkB,CAAC;SACxB,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CACtB,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,CACzE,CAAC;IACJ,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpB,OAAO,IAAI,GAAG,CACZ,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACvB,iCAAiC;QACjC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrC,OAAO;YACL,IAAI,CAAC,EAAE;YACP;gBACE,CAAC,EAAE,CAAC,GAAG,sBAAsB,GAAG,CAAC;gBACjC,CAAC,EAAE,CAAC,GAAG,uBAAuB,GAAG,CAAC;aACnC;SACF,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC,CAAC"}

package/lib/components/canvas/CubeCanvasNode.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 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 NodeProps } from '@xyflow/react';
+import { type CubeCanvasFlowNode } from './CubeCanvasElements.js';
+/**
+ * A node on the canvas: its type's icon and its description, never its id,
+ * which is in the tooltip (spec §17.3). Its look tells its state at a glance.
+ * It can be dragged onto another node, and takes palette items and other
+ * nodes, lighting up only for a drop that would do something. Its handles
+ * sit beside its draggable body, not in it, so dragging from a handle
+ * connects rather than drags the node.
+ */
+export declare const CubeCanvasNode: ((props: NodeProps<CubeCanvasFlowNode>) => import("react/jsx-runtime").JSX.Element) & {
+    displayName: string;
+};
+//# sourceMappingURL=CubeCanvasNode.d.ts.map

package/lib/components/canvas/CubeCanvasNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeCanvasNode.d.ts","sourceRoot":"","sources":["../../../src/components/canvas/CubeCanvasNode.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAU,KAAK,SAAS,EAAY,MAAM,eAAe,CAAC;AAMjE,OAAO,EAEL,KAAK,kBAAkB,EAGxB,MAAM,yBAAyB,CAAC;AAWjC;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,WACjB,SAAS,CAAC,kBAAkB,CAAC;;CA4FtC,CAAC"}

package/lib/components/canvas/CubeCanvasNode.js

@@ -0,0 +1,72 @@
+import { jsx as _jsx, jsxs as _jsxs } 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 { clsx, ContextMenu } from '@finos/legend-art';
+import { Handle, Position } from '@xyflow/react';
+import { observer } from 'mobx-react-lite';
+import { useRef } from 'react';
+import { useDrag, useDrop } from 'react-dnd';
+import { LEGEND_CUBE_TEST_ID } from '../../__lib__/LegendCubeTesting.js';
+import { CubeNodeIcon } from '../CubeNodeIcon.js';
+import { CUBE_OUTPUT_HANDLE_ID, getCubeCanvasNodeStatus, getInputHandleOffset, } from './CubeCanvasElements.js';
+import { useCubeCanvasEditorState } from './CubeCanvasContext.js';
+import { CubeCanvasContextMenu } from './CubeCanvasContextMenu.js';
+import { canDropOnCubeNode, CUBE_DND_TYPE, dropOnCubeNode, } from './CubeCanvasDnd.js';
+/**
+ * A node on the canvas: its type's icon and its description, never its id,
+ * which is in the tooltip (spec §17.3). Its look tells its state at a glance.
+ * It can be dragged onto another node, and takes palette items and other
+ * nodes, lighting up only for a drop that would do something. Its handles
+ * sit beside its draggable body, not in it, so dragging from a handle
+ * connects rather than drags the node.
+ */
+export const CubeCanvasNode = observer((props) => {
+    const { node } = props.data;
+    const editorState = useCubeCanvasEditorState();
+    const status = getCubeCanvasNodeStatus(editorState, node);
+    const connectable = !editorState.readOnly && node.acceptsNewInputs;
+    const ref = useRef(null);
+    const [, dragConnector] = useDrag(() => ({
+        type: CUBE_DND_TYPE.NODE,
+        item: { nodeId: node.id },
+        canDrag: () => !editorState.readOnly,
+    }), [editorState, node.id]);
+    const [{ isDropTarget }, dropConnector] = useDrop(() => ({
+        accept: [CUBE_DND_TYPE.NODE, CUBE_DND_TYPE.PALETTE_ITEM],
+        canDrop: (item) => canDropOnCubeNode(editorState, item, node.id),
+        drop: (item) => dropOnCubeNode(editorState, item, node.id),
+        collect: (monitor) => ({
+            isDropTarget: monitor.isOver({ shallow: true }) && monitor.canDrop(),
+        }),
+    }), [editorState, node.id]);
+    dragConnector(dropConnector(ref));
+    return (_jsxs(ContextMenu, { className: "h-full w-full", content: _jsx(CubeCanvasContextMenu, { editorState: editorState, nodeId: node.id }), menuProps: { elevation: 7 }, children: [node.ports.map((port, index) => (_jsx(Handle, { id: port, type: "target", position: Position.Left, isConnectable: connectable, style: { top: getInputHandleOffset(index, node.ports.length) } }, port))), _jsxs("div", { ref: ref, className: clsx(
+                // React Flow must leave the mouse to the HTML drag: 'nodrag' keeps
+                // it from moving the node, 'nopan' from panning the canvas
+                'legend-cube__node nodrag nopan flex h-full w-full items-center gap-2 rounded border bg-[var(--color-bg-panel)] px-2 text-base text-[var(--color-text-primary)]', status.isInvalid
+                    ? 'border-[var(--color-status-error)]'
+                    : status.isIncomplete
+                        ? 'border-dashed border-[var(--color-status-warn)]'
+                        : 'border-[var(--color-border-default)]', {
+                    'legend-cube__node--selected ring-2 ring-[var(--color-accent)]': status.isCapture,
+                    'legend-cube__node--invalid': status.isInvalid,
+                    'legend-cube__node--incomplete': status.isIncomplete,
+                    'legend-cube__node--resolving animate-pulse': status.isResolving,
+                    'legend-cube__node--engine-error bg-[var(--color-status-error-bg)]': status.hasEngineError,
+                    'legend-cube__node--drop-target outline-dashed outline-2 outline-[var(--color-accent)]': isDropTarget,
+                }), title: status.tooltip, "aria-current": status.isCapture, "data-testid": LEGEND_CUBE_TEST_ID.CANVAS_NODE, children: [_jsx(CubeNodeIcon, { icon: editorState.registry.get(node.type)?.icon, className: "shrink-0 text-lg text-[var(--color-text-secondary)]" }), _jsx("span", { className: "line-clamp-2 min-w-0 break-words leading-tight", children: node.describe() })] }), _jsx(Handle, { id: CUBE_OUTPUT_HANDLE_ID, type: "source", position: Position.Right, isConnectable: !editorState.readOnly })] }));
+});
+//# sourceMappingURL=CubeCanvasNode.js.map

package/lib/components/canvas/CubeCanvasNode.js.map

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