@uipath/apollo-react 4.11.0 → 4.12.1-pr556.9394355

package/dist/canvas/components/LoopNode/LoopNode.js

@@ -0,0 +1,406 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { NodeResizeControl, useStore, useUpdateNodeInternals } from "../../xyflow/react.js";
+import { cn } from "@uipath/apollo-wind";
+import { memo, useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useOptionalNodeTypeRegistry } from "../../core/index.js";
+import { useElementValidationStatus, useNodeExecutionState } from "../../hooks/index.js";
+import { resolveAdornments } from "../../utils/adornment-resolver.js";
+import { getOppositePosition } from "../../utils/createPreviewNode.js";
+import { CanvasIcon } from "../../utils/icon-registry.js";
+import { resolveDisplay, resolveHandles } from "../../utils/manifest-resolver.js";
+import { resolveToolbar } from "../../utils/toolbar-resolver.js";
+import { useBaseCanvasMode } from "../BaseCanvas/BaseCanvasModeProvider.js";
+import { useConnectedHandles } from "../BaseCanvas/ConnectedHandlesContext.js";
+import { useSelectionState } from "../BaseCanvas/SelectionStateContext.js";
+import { selectIsConnecting } from "../BaseNode/BaseNode.js";
+import { BaseBadgeSlot } from "../BaseNode/BaseNodeBadgeSlot.js";
+import { getStatusBorder } from "../BaseNode/BaseNodeContainer.js";
+import { MissingManifestNode } from "../BaseNode/BaseNodeMissingManifest.js";
+import { ButtonHandles } from "../ButtonHandle/index.js";
+import { NodeToolbar } from "../Toolbar/index.js";
+import { DEFAULT_LOOP_FRAME_BACKGROUND, DEFAULT_LOOP_FRAME_BORDER, DEFAULT_LOOP_HEADER_HEIGHT_PX, DEFAULT_LOOP_ICON, DEFAULT_LOOP_MIN_HEIGHT, DEFAULT_LOOP_MIN_WIDTH, DEFAULT_LOOP_NODE_TYPE, DEFAULT_LOOP_SHELL_BACKGROUND, DEFAULT_LOOP_TITLE, LOOP_FRAME_INSET_PX, LOOP_SHELL_RADIUS_PX } from "./LoopNode.constants.js";
+import { getLoopBodyCenter, partitionLoopHandleGroups } from "./LoopNode.helpers.js";
+const EMPTY_DATA = {};
+const ENABLE_LOOP_HANDLE_ACTION_BUTTON = (_event)=>{};
+const RESIZE_CONTROLS = [
+    {
+        position: 'top-left',
+        cursor: 'nwse-resize',
+        indicatorClassName: 'top-[-5px] left-[-5px]'
+    },
+    {
+        position: 'top-right',
+        cursor: 'nesw-resize',
+        indicatorClassName: 'top-[-5px] right-[-5px]'
+    },
+    {
+        position: 'bottom-left',
+        cursor: 'nesw-resize',
+        indicatorClassName: 'bottom-[-5px] left-[-5px]'
+    },
+    {
+        position: 'bottom-right',
+        cursor: 'nwse-resize',
+        indicatorClassName: 'bottom-[-5px] right-[-5px]'
+    }
+];
+const RESIZE_CONTROL_STYLE = {
+    background: 'transparent',
+    border: 'none',
+    zIndex: 100
+};
+const ADORNMENT_SLOT_POSITIONS = [
+    'topLeft',
+    'topRight',
+    'bottomLeft',
+    'bottomRight'
+];
+const ADORNMENT_SLOT_SHAPES = {
+    topLeft: 'top-left',
+    topRight: 'top-right',
+    bottomLeft: 'bottom-left',
+    bottomRight: 'bottom-right'
+};
+function resolveInteractionState(dragging, selected, isHovered) {
+    if (dragging) return 'drag';
+    if (selected) return 'selected';
+    if (isHovered) return 'hover';
+    return 'default';
+}
+function LoopNodeComponent(props) {
+    const { id, type = DEFAULT_LOOP_NODE_TYPE, data, selected = false, dragging = false, width = 0, height = 0, onAddChild, onResize: onResizeCallback } = props;
+    const updateNodeInternals = useUpdateNodeInternals();
+    const nodeTypeRegistry = useOptionalNodeTypeRegistry();
+    const headerRef = useRef(null);
+    const [isHovered, setIsHovered] = useState(false);
+    const resolvedData = data ?? EMPTY_DATA;
+    const nodeVersion = 'string' == typeof resolvedData.version ? resolvedData.version : void 0;
+    const suggestionType = resolvedData.suggestionType;
+    const manifest = useMemo(()=>nodeTypeRegistry?.getManifest(type, nodeVersion), [
+        nodeTypeRegistry,
+        type,
+        nodeVersion
+    ]);
+    const { mode } = useBaseCanvasMode();
+    const connectedHandleIds = useConnectedHandles(id);
+    const { multipleNodesSelected } = useSelectionState();
+    const isConnecting = useStore(selectIsConnecting);
+    const needsChildCheck = 'design' === mode && !!onAddChild;
+    const hasChildNodes = useStore(useCallback((state)=>!needsChildCheck || state.nodes.some((node)=>node.parentId === id), [
+        id,
+        needsChildCheck
+    ]));
+    const executionState = useNodeExecutionState(id);
+    const validationState = useElementValidationStatus(id);
+    const statusContext = useMemo(()=>({
+            nodeId: id,
+            executionState,
+            validationState,
+            isConnecting,
+            isSelected: selected,
+            isDragging: dragging,
+            mode
+        }), [
+        dragging,
+        executionState,
+        id,
+        isConnecting,
+        mode,
+        selected,
+        validationState
+    ]);
+    const executionStatus = 'string' == typeof executionState ? executionState : executionState?.status;
+    const display = useMemo(()=>resolveDisplay(manifest?.display, {
+            ...resolvedData,
+            nodeId: id
+        }), [
+        manifest?.display,
+        id,
+        resolvedData
+    ]);
+    const displayTitle = display.label ?? DEFAULT_LOOP_TITLE;
+    const minWidth = DEFAULT_LOOP_MIN_WIDTH;
+    const minHeight = DEFAULT_LOOP_MIN_HEIGHT;
+    const headerIcon = useMemo(()=>/*#__PURE__*/ jsx(CanvasIcon, {
+            icon: display.icon ?? DEFAULT_LOOP_ICON,
+            size: 16
+        }), [
+        display.icon
+    ]);
+    const toolbarConfig = useMemo(()=>manifest ? resolveToolbar(manifest, statusContext, data) : void 0, [
+        data,
+        manifest,
+        statusContext
+    ]);
+    const adornments = useMemo(()=>resolveAdornments(statusContext), [
+        statusContext
+    ]);
+    const resolvedHandleGroups = useMemo(()=>manifest ? resolveHandles(manifest.handleConfiguration, resolvedData) : [], [
+        manifest,
+        resolvedData
+    ]);
+    const { outer: outerHandleGroups, inner: innerHandleGroups } = useMemo(()=>partitionLoopHandleGroups(resolvedHandleGroups), [
+        resolvedHandleGroups
+    ]);
+    useEffect(()=>{
+        const frameId = requestAnimationFrame(()=>{
+            updateNodeInternals(id);
+        });
+        return ()=>{
+            cancelAnimationFrame(frameId);
+        };
+    }, [
+        id,
+        innerHandleGroups,
+        outerHandleGroups,
+        updateNodeInternals,
+        width,
+        height
+    ]);
+    const handleResize = useCallback((_event, params)=>{
+        onResizeCallback?.({
+            width: params.width,
+            height: params.height
+        });
+    }, [
+        onResizeCallback
+    ]);
+    const handleEmptyClick = useCallback(()=>{
+        const measuredHeaderHeight = headerRef.current?.getBoundingClientRect().height ?? 0;
+        const headerHeight = Math.max(measuredHeaderHeight, DEFAULT_LOOP_HEADER_HEIGHT_PX);
+        onAddChild?.({
+            position: getLoopBodyCenter({
+                width,
+                height,
+                headerHeight
+            }),
+            near: 'mid'
+        });
+    }, [
+        height,
+        onAddChild,
+        width
+    ]);
+    const handleMouseEnter = useCallback(()=>setIsHovered(true), []);
+    const handleMouseLeave = useCallback(()=>setIsHovered(false), []);
+    const shouldShowHandles = isConnecting || selected || isHovered;
+    const showHandleAddButtons = 'design' === mode && !multipleNodesSelected && !isConnecting;
+    const showResizeControls = selected && !dragging && 'design' === mode;
+    const showEmptyStateButton = 'design' === mode && !hasChildNodes && !!onAddChild;
+    const interactionState = resolveInteractionState(dragging, selected, isHovered);
+    if (!manifest) return /*#__PURE__*/ jsx("div", {
+        className: "relative",
+        style: {
+            width,
+            height,
+            minWidth,
+            minHeight
+        },
+        onMouseEnter: handleMouseEnter,
+        onMouseLeave: handleMouseLeave,
+        children: /*#__PURE__*/ jsx(MissingManifestNode, {
+            type: type,
+            isSelected: selected,
+            isHovered: isHovered,
+            interactionState: interactionState
+        })
+    });
+    return /*#__PURE__*/ jsxs("div", {
+        "data-loop-container": true,
+        "data-selected": selected ? 'true' : 'false',
+        "data-execution-status": executionStatus,
+        "data-interaction-state": interactionState,
+        "data-suggestion-type": suggestionType,
+        "data-validation-status": validationState?.validationStatus,
+        "aria-busy": resolvedData.loading || void 0,
+        className: cn('group/loop-shell relative flex h-full w-full flex-col overflow-visible border bg-surface-overlay', 'transition-[border-color,box-shadow,opacity] shadow-(--canvas-node-shadow-rest)', 'border-border-subtle', getStatusBorder(suggestionType ?? validationState?.validationStatus ?? executionStatus), isHovered && 'shadow-(--canvas-node-shadow-hover) border-border-hover', selected && 'outline outline-foreground-accent-muted', 'drag' === interactionState && 'cursor-grabbing shadow-(--canvas-node-shadow-lifted)'),
+        style: {
+            width,
+            height,
+            minWidth,
+            minHeight,
+            borderRadius: LOOP_SHELL_RADIUS_PX,
+            background: display.background ?? DEFAULT_LOOP_SHELL_BACKGROUND
+        },
+        onMouseEnter: handleMouseEnter,
+        onMouseLeave: handleMouseLeave,
+        children: [
+            ADORNMENT_SLOT_POSITIONS.map((slot)=>adornments?.[slot] ? /*#__PURE__*/ jsx(BaseBadgeSlot, {
+                    position: ADORNMENT_SLOT_SHAPES[slot],
+                    shape: "rectangle",
+                    children: adornments[slot]
+                }, slot) : null),
+            /*#__PURE__*/ jsx(ResizeCornerIndicators, {
+                selected: showResizeControls
+            }),
+            showResizeControls ? RESIZE_CONTROLS.map(({ position, cursor })=>/*#__PURE__*/ jsx(NodeResizeControl, {
+                    style: RESIZE_CONTROL_STYLE,
+                    position: position,
+                    minWidth: minWidth,
+                    minHeight: minHeight,
+                    onResize: handleResize,
+                    children: /*#__PURE__*/ jsx("div", {
+                        className: "absolute bottom-0 right-0 h-5 w-5 pointer-events-auto",
+                        style: {
+                            cursor
+                        }
+                    })
+                }, position)) : null,
+            /*#__PURE__*/ jsx(Header, {
+                headerRef: headerRef,
+                title: displayTitle,
+                icon: headerIcon,
+                loading: !!resolvedData.loading
+            }),
+            /*#__PURE__*/ jsx(BodyFrame, {
+                isEmpty: showEmptyStateButton,
+                isLoading: !!resolvedData.loading,
+                onAddChild: handleEmptyClick
+            }),
+            toolbarConfig && /*#__PURE__*/ jsx(NodeToolbar, {
+                nodeId: id,
+                config: toolbarConfig,
+                expanded: selected,
+                hidden: dragging || multipleNodesSelected
+            }),
+            [
+                [
+                    'outer',
+                    outerHandleGroups
+                ],
+                [
+                    'inner',
+                    innerHandleGroups
+                ]
+            ].map(([variant, groups])=>/*#__PURE__*/ jsx(HandleGroups, {
+                    nodeId: id,
+                    groups: groups,
+                    variant: variant,
+                    selected: selected,
+                    hovered: isHovered,
+                    shouldShowHandles: shouldShowHandles,
+                    showAddButton: showHandleAddButtons,
+                    showNotches: shouldShowHandles,
+                    nodeWidth: width,
+                    nodeHeight: height,
+                    connectedHandleIds: connectedHandleIds
+                }, variant))
+        ]
+    });
+}
+const LoopNode = /*#__PURE__*/ memo(LoopNodeComponent);
+function Header({ headerRef, title, icon, loading }) {
+    const titleContent = loading ? /*#__PURE__*/ jsx("div", {
+        className: "h-5 w-28 animate-pulse rounded bg-(--canvas-background-overlay)"
+    }) : /*#__PURE__*/ jsx("span", {
+        className: "truncate text-[14px] font-semibold tracking-[-0.15px]",
+        children: title
+    });
+    let iconContent = null;
+    if (loading) iconContent = /*#__PURE__*/ jsx("div", {
+        className: "h-4 w-4 shrink-0 animate-pulse rounded bg-(--canvas-background-overlay)"
+    });
+    else if (icon) iconContent = /*#__PURE__*/ jsx("span", {
+        className: "shrink-0 text-foreground",
+        "aria-hidden": true,
+        children: icon
+    });
+    return /*#__PURE__*/ jsx("div", {
+        ref: headerRef,
+        className: "flex shrink-0 items-center justify-between gap-2.5 pl-4.5 pr-5 pt-3.5 text-foreground cursor-grab active:cursor-grabbing",
+        "data-testid": "loop-node-header",
+        children: /*#__PURE__*/ jsxs("div", {
+            className: "flex min-w-0 items-center gap-2",
+            children: [
+                iconContent,
+                titleContent
+            ]
+        })
+    });
+}
+function EmptyState({ onAddChild }) {
+    return /*#__PURE__*/ jsx("button", {
+        type: "button",
+        onClick: onAddChild,
+        "aria-label": "Add node to loop",
+        className: cn('nodrag nopan', 'pointer-events-auto flex h-8 w-8 items-center justify-center rounded-xl', 'border border-border bg-surface-overlay text-foreground', 'shadow-[0_4px_24px_rgba(0,0,0,0.25)]', 'transition-colors', 'hover:bg-surface-hover hover:border-brand'),
+        children: /*#__PURE__*/ jsx(CanvasIcon, {
+            icon: "plus",
+            size: 14
+        })
+    });
+}
+function BodyFrame({ isEmpty, isLoading, onAddChild }) {
+    return /*#__PURE__*/ jsxs("div", {
+        "data-testid": "loop-body-frame",
+        "data-empty": isEmpty ? 'true' : 'false',
+        className: cn('relative flex flex-1 rounded-[26px] border border-dashed', 'pointer-events-none', isEmpty && 'items-center justify-center'),
+        style: {
+            margin: LOOP_FRAME_INSET_PX,
+            background: DEFAULT_LOOP_FRAME_BACKGROUND,
+            borderColor: DEFAULT_LOOP_FRAME_BORDER
+        },
+        children: [
+            isLoading ? /*#__PURE__*/ jsx("div", {
+                className: "m-6 h-14 w-full animate-pulse rounded-[18px] bg-(--canvas-background-overlay)"
+            }) : null,
+            isEmpty ? /*#__PURE__*/ jsx(EmptyState, {
+                onAddChild: onAddChild
+            }) : null
+        ]
+    });
+}
+function ResizeCornerIndicators({ selected }) {
+    return /*#__PURE__*/ jsx(Fragment, {
+        children: RESIZE_CONTROLS.map(({ position, indicatorClassName })=>/*#__PURE__*/ jsx("div", {
+                "aria-hidden": true,
+                className: cn('pointer-events-none absolute h-1.5 w-1.5 rounded-[1px] border border-brand bg-background transition-opacity', indicatorClassName, selected ? 'opacity-100' : 'opacity-0')
+            }, position))
+    });
+}
+function HandleGroups({ nodeId, variant, groups, selected, hovered, shouldShowHandles, showAddButton, showNotches, nodeWidth, nodeHeight, connectedHandleIds }) {
+    if (0 === groups.length) return null;
+    return /*#__PURE__*/ jsx(Fragment, {
+        children: groups.map((group, groupIndex)=>/*#__PURE__*/ jsx(HandleGroup, {
+                nodeId: nodeId,
+                variant: variant,
+                group: group,
+                selected: selected,
+                hovered: hovered,
+                shouldShowHandles: shouldShowHandles,
+                showAddButton: showAddButton,
+                showNotches: showNotches,
+                nodeWidth: nodeWidth,
+                nodeHeight: nodeHeight,
+                connectedHandleIds: connectedHandleIds
+            }, `${variant}:${group.position}:${groupIndex}`))
+    });
+}
+function HandleGroup({ nodeId, variant, group, selected, hovered, shouldShowHandles, showAddButton, showNotches, nodeWidth, nodeHeight, connectedHandleIds }) {
+    const groupVisible = shouldShowHandles && (group.visible ?? true);
+    const enhancedHandles = useMemo(()=>group.handles.map((handle)=>({
+                ...handle,
+                showHandle: connectedHandleIds.has(handle.id) || groupVisible,
+                showButton: 'inner' === variant && 'source' === handle.type ? false : handle.showButton,
+                onAction: handle.onAction ?? ('inner' !== variant && 'source' === handle.type && handle.showButton ? ENABLE_LOOP_HANDLE_ACTION_BUTTON : void 0)
+            })), [
+        group.handles,
+        connectedHandleIds,
+        groupVisible,
+        variant
+    ]);
+    return /*#__PURE__*/ jsx(ButtonHandles, {
+        nodeId: nodeId,
+        handles: enhancedHandles,
+        position: group.position,
+        connectionPosition: 'inner' === variant ? getOppositePosition(group.position) : group.position,
+        selected: selected,
+        hovered: hovered,
+        showAddButton: showAddButton,
+        showNotches: showNotches,
+        customPositionAndOffsets: group.customPositionAndOffsets,
+        nodeWidth: nodeWidth,
+        nodeHeight: nodeHeight
+    });
+}
+export { LoopNode };

package/dist/canvas/components/LoopNode/LoopNode.types.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/canvas/components/LoopNode/LoopNode.types.d.ts

@@ -0,0 +1,16 @@
+import type { Node, NodeProps } from '../../xyflow/react.ts';
+import type { XYPosition } from '../../xyflow/system.ts';
+import type { BaseNodeData } from '../BaseNode';
+export interface LoopNodeAddChildContext {
+    position: XYPosition;
+    near: 'start' | 'end' | 'mid';
+}
+export type LoopNodeData = BaseNodeData;
+export interface LoopNodeProps extends NodeProps<Node<LoopNodeData>> {
+    onAddChild?: (ctx: LoopNodeAddChildContext) => void;
+    onResize?: (size: {
+        width: number;
+        height: number;
+    }) => void;
+}
+//# sourceMappingURL=LoopNode.types.d.ts.map

package/dist/canvas/components/LoopNode/LoopNode.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoopNode.types.d.ts","sourceRoot":"","sources":["../../../../src/canvas/components/LoopNode/LoopNode.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2CAA2C,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,UAAU,CAAC;IACrB,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,KAAK,CAAC;CAC/B;AAED,MAAM,MAAM,YAAY,GAAG,YAAY,CAAC;AAExC,MAAM,WAAW,aAAc,SAAQ,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAClE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACpD,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC9D"}

package/dist/canvas/components/LoopNode/LoopNodePreview.cjs

@@ -0,0 +1,81 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    applyHandleActionAddPreview: ()=>applyHandleActionAddPreview,
+    createCenteredLoopPreview: ()=>createCenteredLoopPreview
+});
+const react_cjs_namespaceObject = require("../../xyflow/react.cjs");
+const external_constants_cjs_namespaceObject = require("../../constants.cjs");
+const createPreviewGraph_cjs_namespaceObject = require("../../utils/createPreviewGraph.cjs");
+const createPreviewNode_cjs_namespaceObject = require("../../utils/createPreviewNode.cjs");
+const NodeUtils_cjs_namespaceObject = require("../../utils/NodeUtils.cjs");
+const createAddNodePreview_cjs_namespaceObject = require("../AddNodePanel/createAddNodePreview.cjs");
+const external_LoopNode_constants_cjs_namespaceObject = require("./LoopNode.constants.cjs");
+const external_LoopNode_helpers_cjs_namespaceObject = require("./LoopNode.helpers.cjs");
+const LOOP_START_HANDLE_ID = 'start';
+const LOOP_CONTINUE_HANDLE_ID = 'continue';
+function createCenteredLoopPreview(loopId, reactFlowInstance, centerPosition) {
+    const loopNode = reactFlowInstance.getNode(loopId);
+    if (!isLoopNode(loopNode)) return null;
+    const allNodes = reactFlowInstance.getNodes();
+    const loopAbsolutePosition = (0, NodeUtils_cjs_namespaceObject.getAbsolutePosition)(loopNode, allNodes);
+    const relativeCenter = centerPosition ?? (0, external_LoopNode_helpers_cjs_namespaceObject.getLoopRelativeBodyCenter)(loopNode);
+    const snappedCenter = {
+        x: (0, NodeUtils_cjs_namespaceObject.snapToGrid)(loopAbsolutePosition.x + relativeCenter.x),
+        y: (0, NodeUtils_cjs_namespaceObject.snapToGrid)(loopAbsolutePosition.y + relativeCenter.y)
+    };
+    const preview = (0, createPreviewNode_cjs_namespaceObject.createPreviewNode)(loopId, LOOP_START_HANDLE_ID, reactFlowInstance, snappedCenter, void 0, 'source', void 0, react_cjs_namespaceObject.Position.Right, [], 'center');
+    if (!preview) return null;
+    return (0, createPreviewGraph_cjs_namespaceObject.createPreviewGraph)({
+        preview,
+        target: loopId,
+        targetHandleId: LOOP_CONTINUE_HANDLE_ID,
+        reactFlowInstance,
+        containerId: loopId,
+        trailingEdgeId: `${external_constants_cjs_namespaceObject.PREVIEW_NODE_ID}-${loopId}-${LOOP_CONTINUE_HANDLE_ID}`,
+        trailingEdgeStyle: createPreviewGraph_cjs_namespaceObject.PREVIEW_EDGE_STYLE
+    });
+}
+function applyHandleActionAddPreview(event, reactFlowInstance, ignoredNodeTypes = []) {
+    if (event.handleId === LOOP_START_HANDLE_ID && isLoopNode(reactFlowInstance.getNode(event.nodeId))) {
+        const preview = createCenteredLoopPreview(event.nodeId, reactFlowInstance);
+        if (preview) (0, createPreviewNode_cjs_namespaceObject.applyPreviewGraphToReactFlow)(preview, reactFlowInstance);
+        return;
+    }
+    (0, createAddNodePreview_cjs_namespaceObject.createAddNodePreview)(event.nodeId, event.handleId, reactFlowInstance, event.position, 'input' === event.handleType ? 'target' : 'source', ignoredNodeTypes);
+}
+function isLoopNode(node) {
+    return node?.type === external_LoopNode_constants_cjs_namespaceObject.DEFAULT_LOOP_NODE_TYPE;
+}
+exports.applyHandleActionAddPreview = __webpack_exports__.applyHandleActionAddPreview;
+exports.createCenteredLoopPreview = __webpack_exports__.createCenteredLoopPreview;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "applyHandleActionAddPreview",
+    "createCenteredLoopPreview"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/canvas/components/LoopNode/LoopNodePreview.d.ts

@@ -0,0 +1,8 @@
+import { type ReactFlowInstance } from '../../xyflow/react.ts';
+import type { CanvasHandleActionEvent } from '../../utils/CanvasEventBus';
+export declare function createCenteredLoopPreview(loopId: string, reactFlowInstance: ReactFlowInstance, centerPosition?: {
+    x: number;
+    y: number;
+}): import("../..").PreviewGraph | null;
+export declare function applyHandleActionAddPreview(event: CanvasHandleActionEvent, reactFlowInstance: ReactFlowInstance, ignoredNodeTypes?: string[]): void;
+//# sourceMappingURL=LoopNodePreview.d.ts.map

package/dist/canvas/components/LoopNode/LoopNodePreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoopNodePreview.d.ts","sourceRoot":"","sources":["../../../../src/canvas/components/LoopNode/LoopNodePreview.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,0CAA0C,CAAC;AAElD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAW1E,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,iBAAiB,EACpC,cAAc,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,uCAoC1C;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,uBAAuB,EAC9B,iBAAiB,EAAE,iBAAiB,EACpC,gBAAgB,GAAE,MAAM,EAAO,QAqBhC"}

package/dist/canvas/components/LoopNode/LoopNodePreview.js

@@ -0,0 +1,44 @@
+import { Position } from "../../xyflow/react.js";
+import { PREVIEW_NODE_ID } from "../../constants.js";
+import { PREVIEW_EDGE_STYLE, createPreviewGraph } from "../../utils/createPreviewGraph.js";
+import { applyPreviewGraphToReactFlow, createPreviewNode } from "../../utils/createPreviewNode.js";
+import { getAbsolutePosition, snapToGrid } from "../../utils/NodeUtils.js";
+import { createAddNodePreview } from "../AddNodePanel/createAddNodePreview.js";
+import { DEFAULT_LOOP_NODE_TYPE } from "./LoopNode.constants.js";
+import { getLoopRelativeBodyCenter } from "./LoopNode.helpers.js";
+const LOOP_START_HANDLE_ID = 'start';
+const LOOP_CONTINUE_HANDLE_ID = 'continue';
+function createCenteredLoopPreview(loopId, reactFlowInstance, centerPosition) {
+    const loopNode = reactFlowInstance.getNode(loopId);
+    if (!isLoopNode(loopNode)) return null;
+    const allNodes = reactFlowInstance.getNodes();
+    const loopAbsolutePosition = getAbsolutePosition(loopNode, allNodes);
+    const relativeCenter = centerPosition ?? getLoopRelativeBodyCenter(loopNode);
+    const snappedCenter = {
+        x: snapToGrid(loopAbsolutePosition.x + relativeCenter.x),
+        y: snapToGrid(loopAbsolutePosition.y + relativeCenter.y)
+    };
+    const preview = createPreviewNode(loopId, LOOP_START_HANDLE_ID, reactFlowInstance, snappedCenter, void 0, 'source', void 0, Position.Right, [], 'center');
+    if (!preview) return null;
+    return createPreviewGraph({
+        preview,
+        target: loopId,
+        targetHandleId: LOOP_CONTINUE_HANDLE_ID,
+        reactFlowInstance,
+        containerId: loopId,
+        trailingEdgeId: `${PREVIEW_NODE_ID}-${loopId}-${LOOP_CONTINUE_HANDLE_ID}`,
+        trailingEdgeStyle: PREVIEW_EDGE_STYLE
+    });
+}
+function applyHandleActionAddPreview(event, reactFlowInstance, ignoredNodeTypes = []) {
+    if (event.handleId === LOOP_START_HANDLE_ID && isLoopNode(reactFlowInstance.getNode(event.nodeId))) {
+        const preview = createCenteredLoopPreview(event.nodeId, reactFlowInstance);
+        if (preview) applyPreviewGraphToReactFlow(preview, reactFlowInstance);
+        return;
+    }
+    createAddNodePreview(event.nodeId, event.handleId, reactFlowInstance, event.position, 'input' === event.handleType ? 'target' : 'source', ignoredNodeTypes);
+}
+function isLoopNode(node) {
+    return node?.type === DEFAULT_LOOP_NODE_TYPE;
+}
+export { applyHandleActionAddPreview, createCenteredLoopPreview };

package/dist/canvas/components/LoopNode/index.cjs

@@ -0,0 +1,72 @@
+"use strict";
+var __webpack_modules__ = {
+    "./LoopCanvasNode" (module) {
+        module.exports = require("./LoopCanvasNode.cjs");
+    },
+    "./LoopNode?d3ac" (module) {
+        module.exports = require("./LoopNode.cjs");
+    },
+    "./LoopNode.types" (module) {
+        module.exports = require("./LoopNode.types.cjs");
+    }
+};
+var __webpack_module_cache__ = {};
+function __webpack_require__(moduleId) {
+    var cachedModule = __webpack_module_cache__[moduleId];
+    if (void 0 !== cachedModule) return cachedModule.exports;
+    var module = __webpack_module_cache__[moduleId] = {
+        exports: {}
+    };
+    __webpack_modules__[moduleId](module, module.exports, __webpack_require__);
+    return module.exports;
+}
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+(()=>{
+    __webpack_require__.r(__webpack_exports__);
+    var _LoopCanvasNode__rspack_import_0 = __webpack_require__("./LoopCanvasNode");
+    var __rspack_reexport = {};
+    for(const __rspack_import_key in _LoopCanvasNode__rspack_import_0)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_LoopCanvasNode__rspack_import_0[__rspack_import_key];
+    __webpack_require__.d(__webpack_exports__, __rspack_reexport);
+    var _LoopNode__rspack_import_1 = __webpack_require__("./LoopNode?d3ac");
+    var __rspack_reexport = {};
+    for(const __rspack_import_key in _LoopNode__rspack_import_1)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_LoopNode__rspack_import_1[__rspack_import_key];
+    __webpack_require__.d(__webpack_exports__, __rspack_reexport);
+    var _LoopNode_types__rspack_import_2 = __webpack_require__("./LoopNode.types");
+    var __rspack_reexport = {};
+    for(const __rspack_import_key in _LoopNode_types__rspack_import_2)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_LoopNode_types__rspack_import_2[__rspack_import_key];
+    __webpack_require__.d(__webpack_exports__, __rspack_reexport);
+})();
+for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/canvas/components/LoopNode/index.d.ts

@@ -0,0 +1,4 @@
+export * from './LoopCanvasNode';
+export * from './LoopNode';
+export * from './LoopNode.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/canvas/components/LoopNode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/canvas/components/LoopNode/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC"}