@uipath/apollo-react 4.14.1 → 4.15.0-pr605.2728a1c

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

@@ -0,0 +1,400 @@
+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, useState } from "react";
+import { useOptionalNodeTypeRegistry } from "../../core/index.js";
+import { useElementValidationStatus, useNodeExecutionState } from "../../hooks/index.js";
+import { resolveAdornments } from "../../utils/adornment-resolver.js";
+import { CanvasIcon } from "../../utils/icon-registry.js";
+import { getNodeTypeVersion, resolveDisplay, resolveHandles } from "../../utils/manifest-resolver.js";
+import { snapToGrid } from "../../utils/NodeUtils.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_HEIGHT, DEFAULT_LOOP_ICON, DEFAULT_LOOP_MIN_HEIGHT, DEFAULT_LOOP_MIN_WIDTH, DEFAULT_LOOP_SHELL_BACKGROUND, DEFAULT_LOOP_TITLE, DEFAULT_LOOP_WIDTH, LOOP_FRAME_INSET_PX, LOOP_SHELL_RADIUS_PX } from "./LoopNode.constants.js";
+import { resolveLoopHandleGroups } from "./LoopNode.helpers.js";
+const EMPTY_DATA = {};
+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 useHasChildNodes(id, enabled) {
+    return useStore(useCallback((state)=>!enabled || state.nodes.some((node)=>node.parentId === id), [
+        id,
+        enabled
+    ]));
+}
+function useLoopNodeInternalsRefresh(id, handleGroups, width, height) {
+    const updateNodeInternals = useUpdateNodeInternals();
+    useEffect(()=>{
+        const frameId = requestAnimationFrame(()=>{
+            updateNodeInternals(id);
+        });
+        return ()=>{
+            cancelAnimationFrame(frameId);
+        };
+    }, [
+        id,
+        handleGroups,
+        updateNodeInternals,
+        width,
+        height
+    ]);
+}
+function LoopNodeComponent(props) {
+    const { id, type, data, selected = false, dragging = false, width = 0, height = 0, onAddFirstChild, onResize, toolbarConfig: toolbarConfigProp, adornments: adornmentsProp, executionStatusOverride, suggestionType: suggestionTypeProp } = props;
+    const nodeTypeRegistry = useOptionalNodeTypeRegistry();
+    const [isHovered, setIsHovered] = useState(false);
+    const resolvedData = data ?? EMPTY_DATA;
+    const isLoading = !!resolvedData.loading;
+    const nodeVersion = getNodeTypeVersion(resolvedData);
+    const suggestionType = suggestionTypeProp ?? resolvedData.suggestionType;
+    const manifest = useMemo(()=>nodeTypeRegistry?.getManifest(type, nodeVersion), [
+        nodeTypeRegistry,
+        type,
+        nodeVersion
+    ]);
+    const { mode } = useBaseCanvasMode();
+    const isDesignMode = 'design' === mode;
+    const connectedHandleIds = useConnectedHandles(id);
+    const { multipleNodesSelected } = useSelectionState();
+    const isConnecting = useStore(selectIsConnecting);
+    const hasChildNodes = useHasChildNodes(id, isDesignMode && !!onAddFirstChild);
+    const executionState = useNodeExecutionState(id);
+    const validationState = useElementValidationStatus(id);
+    const statusContext = useMemo(()=>({
+            nodeId: id,
+            executionState: executionStatusOverride ?? executionState,
+            validationState,
+            isConnecting,
+            isSelected: selected,
+            isDragging: dragging,
+            mode
+        }), [
+        dragging,
+        executionStatusOverride,
+        executionState,
+        id,
+        isConnecting,
+        mode,
+        selected,
+        validationState
+    ]);
+    const executionStatus = executionStatusOverride ?? ('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 displayIcon = display.icon ?? DEFAULT_LOOP_ICON;
+    const containerWidth = width || DEFAULT_LOOP_WIDTH;
+    const containerHeight = height || DEFAULT_LOOP_HEIGHT;
+    const nodeSizeStyle = {
+        width: containerWidth,
+        height: containerHeight,
+        minWidth: DEFAULT_LOOP_MIN_WIDTH,
+        minHeight: DEFAULT_LOOP_MIN_HEIGHT
+    };
+    const toolbarConfig = useMemo(()=>{
+        if (void 0 !== toolbarConfigProp) return null === toolbarConfigProp ? void 0 : toolbarConfigProp;
+        return manifest ? resolveToolbar(manifest, statusContext, data) : void 0;
+    }, [
+        data,
+        manifest,
+        statusContext,
+        toolbarConfigProp
+    ]);
+    const adornments = useMemo(()=>({
+            ...resolveAdornments(statusContext),
+            ...adornmentsProp ?? {}
+        }), [
+        adornmentsProp,
+        statusContext
+    ]);
+    const resolvedHandleGroups = useMemo(()=>manifest ? resolveHandles(manifest.handleConfiguration, resolvedData) : [], [
+        manifest,
+        resolvedData
+    ]);
+    const loopHandleGroups = useMemo(()=>resolveLoopHandleGroups(resolvedHandleGroups), [
+        resolvedHandleGroups
+    ]);
+    useLoopNodeInternalsRefresh(id, loopHandleGroups, containerWidth, containerHeight);
+    const handleResize = useCallback((_event, params)=>{
+        onResize?.({
+            width: snapToGrid(params.width),
+            height: snapToGrid(params.height)
+        });
+    }, [
+        onResize
+    ]);
+    const handleEmptyClick = useCallback(()=>{
+        onAddFirstChild?.();
+    }, [
+        onAddFirstChild
+    ]);
+    const handleMouseEnter = useCallback(()=>setIsHovered(true), []);
+    const handleMouseLeave = useCallback(()=>setIsHovered(false), []);
+    const handleOuterHandleAction = useCallback((_event)=>{
+        setIsHovered(false);
+    }, []);
+    const shouldShowHandles = (isConnecting || selected || isHovered) && !dragging;
+    const showHandleAddButtons = isDesignMode && !multipleNodesSelected && !isConnecting && !dragging;
+    const showResizeControls = selected && !dragging && isDesignMode;
+    const showEmptyStateButton = isDesignMode && !hasChildNodes && !!onAddFirstChild;
+    const interactionState = resolveInteractionState(dragging, selected, isHovered);
+    if (!manifest) return /*#__PURE__*/ jsx("div", {
+        className: "relative",
+        style: nodeSizeStyle,
+        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: {
+            ...nodeSizeStyle,
+            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, {
+                visible: showResizeControls
+            }),
+            showResizeControls ? /*#__PURE__*/ jsx(ResizeControls, {
+                onResize: handleResize
+            }) : null,
+            /*#__PURE__*/ jsx(Header, {
+                title: displayTitle,
+                icon: displayIcon,
+                loading: isLoading
+            }),
+            /*#__PURE__*/ jsx(BodyFrame, {
+                isEmpty: showEmptyStateButton,
+                isLoading: isLoading,
+                onAddFirstChild: handleEmptyClick
+            }),
+            toolbarConfig && /*#__PURE__*/ jsx(NodeToolbar, {
+                nodeId: id,
+                config: toolbarConfig,
+                expanded: selected || isHovered,
+                hidden: dragging || multipleNodesSelected,
+                portalToNodeOverlay: true
+            }),
+            /*#__PURE__*/ jsx(HandleGroups, {
+                nodeId: id,
+                groups: loopHandleGroups,
+                selected: selected,
+                hovered: isHovered,
+                shouldShowHandles: shouldShowHandles,
+                showAddButton: showHandleAddButtons,
+                showNotches: shouldShowHandles,
+                nodeWidth: containerWidth,
+                nodeHeight: containerHeight,
+                connectedHandleIds: connectedHandleIds,
+                onOuterHandleAction: handleOuterHandleAction
+            })
+        ]
+    });
+}
+const LoopNode = /*#__PURE__*/ memo(LoopNodeComponent);
+function Header({ 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-normal",
+        children: title
+    });
+    const iconContent = loading ? /*#__PURE__*/ jsx("div", {
+        className: "h-4 w-4 shrink-0 animate-pulse rounded bg-(--canvas-background-overlay)"
+    }) : icon ? /*#__PURE__*/ jsx("span", {
+        className: "shrink-0 text-foreground",
+        "aria-hidden": true,
+        children: /*#__PURE__*/ jsx(CanvasIcon, {
+            icon: icon,
+            size: 16
+        })
+    }) : null;
+    return /*#__PURE__*/ jsx("div", {
+        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({ onAddFirstChild }) {
+    return /*#__PURE__*/ jsx("button", {
+        type: "button",
+        onClick: onAddFirstChild,
+        "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-(--canvas-node-shadow-lifted)', 'transition-colors', 'hover:bg-surface-hover hover:border-brand'),
+        children: /*#__PURE__*/ jsx(CanvasIcon, {
+            icon: "plus",
+            size: 14
+        })
+    });
+}
+function BodyFrame({ isEmpty, isLoading, onAddFirstChild }) {
+    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, {
+                onAddFirstChild: onAddFirstChild
+            }) : null
+        ]
+    });
+}
+function ResizeControls({ onResize }) {
+    return /*#__PURE__*/ jsx(Fragment, {
+        children: RESIZE_CONTROLS.map(({ position, cursor })=>/*#__PURE__*/ jsx(NodeResizeControl, {
+                style: RESIZE_CONTROL_STYLE,
+                position: position,
+                minWidth: DEFAULT_LOOP_MIN_WIDTH,
+                minHeight: DEFAULT_LOOP_MIN_HEIGHT,
+                onResize: onResize,
+                children: /*#__PURE__*/ jsx("div", {
+                    className: "absolute bottom-0 right-0 h-5 w-5 pointer-events-auto",
+                    style: {
+                        cursor
+                    }
+                })
+            }, position))
+    });
+}
+function ResizeCornerIndicators({ visible }) {
+    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, visible ? 'opacity-100' : 'opacity-0')
+            }, position))
+    });
+}
+function HandleGroups({ groups, ...handleGroupProps }) {
+    if (0 === groups.length) return null;
+    return /*#__PURE__*/ jsx(Fragment, {
+        children: groups.map((group, groupIndex)=>/*#__PURE__*/ jsx(HandleGroup, {
+                ...handleGroupProps,
+                group: group
+            }, `${group.boundary}:${group.position}:${groupIndex}`))
+    });
+}
+function HandleGroup({ nodeId, group, selected, hovered, shouldShowHandles, showAddButton, showNotches, nodeWidth, nodeHeight, connectedHandleIds, onOuterHandleAction }) {
+    const groupVisible = shouldShowHandles && (group.visible ?? true);
+    const position = group.position;
+    const enhancedHandles = useMemo(()=>group.handles.map((handle)=>{
+            const isInnerSourceHandle = 'inner' === group.boundary && 'source' === handle.type;
+            const shouldResetHoverOnAction = 'outer' === group.boundary && 'source' === handle.type && handle.showButton;
+            return {
+                ...handle,
+                showHandle: connectedHandleIds.has(handle.id) || groupVisible,
+                showButton: isInnerSourceHandle ? false : handle.showButton,
+                onAction: handle.onAction ?? (shouldResetHoverOnAction ? onOuterHandleAction : void 0)
+            };
+        }), [
+        group.boundary,
+        group.handles,
+        connectedHandleIds,
+        groupVisible,
+        onOuterHandleAction
+    ]);
+    return /*#__PURE__*/ jsx(ButtonHandles, {
+        nodeId: nodeId,
+        handles: enhancedHandles,
+        position: position,
+        connectionPosition: group.connectionPosition,
+        selected: selected,
+        hovered: hovered,
+        showAddButton: showAddButton,
+        showNotches: showNotches,
+        customPositionAndOffsets: group.customPositionAndOffsets,
+        nodeWidth: nodeWidth,
+        nodeHeight: nodeHeight,
+        portalActions: 'outer' === group.boundary
+    });
+}
+export { LoopNode };