@canmingir/link 1.2.18 → 1.2.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canmingir/link",
-  "version": "1.2.18",
+  "version": "1.2.20",
   "type": "module",
   "exports": {
     ".": "./index.js",

package/src/lib/Flow/connectors/DynamicConnector.jsx

@@ -1,3 +1,5 @@
+import { Box } from "@mui/material";
+
 import React, { useId, useLayoutEffect, useMemo, useState } from "react";
 
 const DynamicConnector = ({
@@ -19,6 +21,11 @@ const DynamicConnector = ({
   gradient = null,
   curvature = 0.5,
   connectorType = "curved",
+  label = null,
+  labelStyle = {},
+  labelPosition = 0.5,
+  labelOffsetX = 0,
+  labelOffsetY = -10,
 }) => {
   const uniqueId = useId();
   const [dims, setDims] = useState(null);
@@ -143,118 +150,169 @@ const DynamicConnector = ({
   const dashArray = getDashArray();
 
   return (
-    <svg
-      style={{
-        position: "absolute",
-        inset: 0,
-        pointerEvents: "none",
-        overflow: "visible",
-        zIndex: 0,
-      }}
-      width="100%"
-      height="100%"
-      viewBox={`0 0 ${dims.w} ${dims.h}`}
-    >
-      <defs>
-        {gradient && (
-          <linearGradient
-            id={ids.gradient}
-            gradientUnits="userSpaceOnUse"
-            x1={points.parent.x}
-            y1={points.parent.y}
-            x2={points.children[0]?.x || points.parent.x}
-            y2={points.children[0]?.y || points.parent.y}
-          >
-            <stop offset="0%" stopColor={gradient.from} />
-            <stop offset="100%" stopColor={gradient.to} />
-          </linearGradient>
-        )}
-
-        {showArrow && (
-          <marker
-            id={ids.arrow}
-            viewBox="0 0 10 10"
-            refX="9"
-            refY="5"
-            markerWidth={arrowSize}
-            markerHeight={arrowSize}
-            orient="auto-start-reverse"
-          >
-            <path
-              d="M 0 0 L 10 5 L 0 10 z"
-              fill={gradient ? `url(#${ids.gradient})` : stroke}
-            />
-          </marker>
-        )}
-
-        {animated && <style>{animationStyle}</style>}
-      </defs>
-
-      {points.children.map((child, i) => {
-        const pathD = getPath(points.parent, child);
-        const pathStroke = gradient ? `url(#${ids.gradient})` : stroke;
-
-        return (
-          <g key={i}>
-            <path
-              d={pathD}
-              fill="none"
-              stroke={pathStroke}
-              strokeWidth={strokeWidth}
-              strokeDasharray={animated ? "8,4" : dashArray}
-              strokeLinecap="round"
-              strokeLinejoin="round"
-              markerEnd={showArrow ? `url(#${ids.arrow})` : undefined}
-              style={{
-                transition: "stroke 0.2s ease, stroke-width 0.2s ease",
-                ...(animated
-                  ? {
-                      animation: `flowAnimation ${
-                        0.5 / animationSpeed
-                      }s linear infinite`,
-                    }
-                  : {}),
-              }}
-            />
-          </g>
-        );
-      })}
-
-      {showDots && (
-        <>
-          <circle
-            cx={points.parent.x}
-            cy={points.parent.y}
-            r={dotRadius}
-            fill={gradient ? gradient.from : effectiveDotColor}
-            stroke="#fff"
-            strokeWidth={1.5}
-            style={{
-              filter: "drop-shadow(0 1px 2px rgba(0,0,0,0.15))",
-            }}
-          />
-
-          {points.children.map((child, i) => {
-            const dotFill = gradient ? gradient.to : effectiveDotColor;
-
-            return (
-              <circle
-                key={i}
-                cx={child.x}
-                cy={child.y}
-                r={dotRadius}
-                fill={dotFill}
-                stroke="#fff"
-                strokeWidth={1.5}
+    <>
+      <svg
+        style={{
+          position: "absolute",
+          inset: 0,
+          pointerEvents: "none",
+          overflow: "visible",
+          zIndex: 0,
+        }}
+        width="100%"
+        height="100%"
+        viewBox={`0 0 ${dims.w} ${dims.h}`}
+      >
+        <defs>
+          {gradient && (
+            <linearGradient
+              id={ids.gradient}
+              gradientUnits="userSpaceOnUse"
+              x1={points.parent.x}
+              y1={points.parent.y}
+              x2={points.children[0]?.x || points.parent.x}
+              y2={points.children[0]?.y || points.parent.y}
+            >
+              <stop offset="0%" stopColor={gradient.from} />
+              <stop offset="100%" stopColor={gradient.to} />
+            </linearGradient>
+          )}
+
+          {showArrow && (
+            <marker
+              id={ids.arrow}
+              viewBox="0 0 10 10"
+              refX="9"
+              refY="5"
+              markerWidth={arrowSize}
+              markerHeight={arrowSize}
+              orient="auto-start-reverse"
+            >
+              <path
+                d="M 0 0 L 10 5 L 0 10 z"
+                fill={gradient ? `url(#${ids.gradient})` : stroke}
+              />
+            </marker>
+          )}
+
+          {animated && <style>{animationStyle}</style>}
+        </defs>
+
+        {points.children.map((child, i) => {
+          const pathD = getPath(points.parent, child);
+          const pathStroke = gradient ? `url(#${ids.gradient})` : stroke;
+
+          const labelX =
+            points.parent.x +
+            (child.x - points.parent.x) * labelPosition +
+            labelOffsetX;
+          const labelY =
+            points.parent.y +
+            (child.y - points.parent.y) * labelPosition +
+            labelOffsetY;
+
+          return (
+            <g key={i}>
+              <path
+                d={pathD}
+                fill="none"
+                stroke={pathStroke}
+                strokeWidth={strokeWidth}
+                strokeDasharray={animated ? "8,4" : dashArray}
+                strokeLinecap="round"
+                strokeLinejoin="round"
+                markerEnd={showArrow ? `url(#${ids.arrow})` : undefined}
                 style={{
-                  filter: "drop-shadow(0 1px 2px rgba(0,0,0,0.15))",
+                  transition: "stroke 0.2s ease, stroke-width 0.2s ease",
+                  ...(animated
+                    ? {
+                        animation: `flowAnimation ${
+                          0.5 / animationSpeed
+                        }s linear infinite`,
+                      }
+                    : {}),
                 }}
               />
-            );
-          })}
-        </>
-      )}
-    </svg>
+            </g>
+          );
+        })}
+
+        {showDots && (
+          <>
+            <circle
+              cx={points.parent.x}
+              cy={points.parent.y}
+              r={dotRadius}
+              fill={gradient ? gradient.from : effectiveDotColor}
+              stroke="#fff"
+              strokeWidth={1.5}
+              style={{
+                filter: "drop-shadow(0 1px 2px rgba(0,0,0,0.15))",
+              }}
+            />
+
+            {points.children.map((child, i) => {
+              const dotFill = gradient ? gradient.to : effectiveDotColor;
+
+              return (
+                <circle
+                  key={i}
+                  cx={child.x}
+                  cy={child.y}
+                  r={dotRadius}
+                  fill={dotFill}
+                  stroke="#fff"
+                  strokeWidth={1.5}
+                  style={{
+                    filter: "drop-shadow(0 1px 2px rgba(0,0,0,0.15))",
+                  }}
+                />
+              );
+            })}
+          </>
+        )}
+      </svg>
+
+      {label &&
+        points.children.map((child, i) => {
+          const labelX =
+            points.parent.x +
+            (child.x - points.parent.x) * labelPosition +
+            labelOffsetX;
+          const labelY =
+            points.parent.y +
+            (child.y - points.parent.y) * labelPosition +
+            labelOffsetY;
+
+          return (
+            <Box
+              key={`label-${i}`}
+              sx={{
+                position: "absolute",
+                left: labelX,
+                top: labelY,
+                transform: "translate(-50%, -50%)",
+                px: 1,
+                py: 0.5,
+                borderRadius: 1,
+                backgroundColor: "background.paper",
+                border: 1,
+                borderColor: labelStyle.color || stroke,
+                fontSize: labelStyle.fontSize || "12px",
+                fontWeight: labelStyle.fontWeight || 600,
+                color: labelStyle.textColor || stroke,
+                pointerEvents: "none",
+                userSelect: "none",
+                zIndex: 10,
+                boxShadow: 1,
+                whiteSpace: "nowrap",
+              }}
+            >
+              {label}
+            </Box>
+          );
+        })}
+    </>
   );
 };
 

package/src/lib/Flow/core/Flow.jsx

@@ -11,6 +11,7 @@ export const Flow = ({
   plugin,
   editable = false,
   onChange,
+  height,
 }) => {
   const [floatingNodes, setFloatingNodes] = useState([]);
 
@@ -72,6 +73,7 @@ export const Flow = ({
       onCut={editable ? handleCut : undefined}
       onConnect={editable ? handleConnect : undefined}
       floatingNodes={floatingNodes}
+      height={height}
     />
   );
 };

package/src/lib/Flow/core/FlowNode.jsx

@@ -16,6 +16,7 @@ const FlowNode = ({
   style,
   plugin,
   node,
+  height,
   ...props
 }) => {
   if (!isRoot) {
@@ -48,6 +49,7 @@ const FlowNode = ({
         variant={variant}
         style={style}
         plugin={plugin}
+        height={height}
       >
         {node && (
           <FlowNodeView

package/src/lib/Flow/core/FlowViewport.jsx

@@ -16,6 +16,9 @@ const FlowViewport = ({
   variant,
   style,
   plugin,
+  height = "100vh",
+  sx = {},
+  ...rest
 }) => {
   const clampZoom = (zoom) => Math.min(2.5, Math.max(0.25, zoom));
 
@@ -50,16 +53,34 @@ const FlowViewport = ({
   }, []);
 
   useEffect(() => {
+    const container = containerRef.current;
+    if (!container) return;
+
     const onWheel = (e) => {
       const wantsZoom = e.ctrlKey || e.metaKey;
-      if (!wantsZoom) return;
-      e.preventDefault();
-      const direction = e.deltaY > 0 ? -1 : 1;
-      const factor = direction > 0 ? 1.1 : 1 / 1.1;
-      setZoom((z) => clampZoom(z * factor));
+
+      if (wantsZoom) {
+        e.preventDefault();
+        const direction = e.deltaY > 0 ? -1 : 1;
+        const factor = direction > 0 ? 1.1 : 1 / 1.1;
+        setZoom((z) => clampZoom(z * factor));
+      } else if (e.shiftKey) {
+        e.preventDefault();
+        const delta = e.deltaX !== 0 ? e.deltaX : e.deltaY;
+        setOffset((prev) => ({
+          x: prev.x - delta,
+          y: prev.y,
+        }));
+      } else {
+        e.preventDefault();
+        setOffset((prev) => ({
+          x: prev.x - e.deltaX,
+          y: prev.y - e.deltaY,
+        }));
+      }
     };
-    window.addEventListener("wheel", onWheel, { passive: false });
-    return () => window.removeEventListener("wheel", onWheel);
+    container.addEventListener("wheel", onWheel, { passive: false });
+    return () => container.removeEventListener("wheel", onWheel);
   }, []);
 
   useEffect(() => {
@@ -225,10 +246,10 @@ const FlowViewport = ({
           transform: `translate(${offset.x}px, ${offset.y}px) scale(${zoom})`,
           transformOrigin: "center center",
           width: "100%",
-          height: "100%",
+          height: height,
           display: "flex",
           alignItems: "center",
-          justifyContent: "center",
+          justifyContent: variant === "horizontal" ? "flex-start" : "center",
           transition: isDragging ? "none" : "transform 0.1s ease-out",
           pointerEvents: "auto",
           position: "relative",

package/src/lib/Flow/hooks/useNodeStyle.js

@@ -38,6 +38,15 @@ export const useNodeStyle = ({ node, type, variant, style, plugin }) => {
         }) || {};
     }
 
+    let pluginEdgeTokens = {};
+    if (resolvedPlugin && typeof resolvedPlugin.edge === "function") {
+      pluginEdgeTokens =
+        resolvedPlugin.edge({
+          node,
+          style: styleTokens,
+        }) || {};
+    }
+
     const rawNodeStyle = {
       ...baseStyle,
       ...variantTokens,
@@ -47,9 +56,14 @@ export const useNodeStyle = ({ node, type, variant, style, plugin }) => {
 
     const nodeStyle = applySemanticTokens(rawNodeStyle, baseStyle);
 
+    const edgeStyle = {
+      ...pluginEdgeTokens,
+    };
+
     return {
       baseStyle,
       nodeStyle,
+      edgeStyle,
       plugin: resolvedPlugin,
     };
   }, [node, type, variant, style, plugin]);

package/src/lib/Flow/nodes/FlowNodeView.jsx

@@ -24,6 +24,7 @@ const FlowNodeView = ({
   const {
     baseStyle,
     nodeStyle,
+    edgeStyle,
     plugin: _plugin,
   } = useNodeStyle({
     node,
@@ -60,11 +61,29 @@ const FlowNodeView = ({
     selectionColor = baseStyle.selectionColor ?? "#64748b",
   } = nodeStyle;
 
+  const edgeProps = {
+    lineColor: edgeStyle.lineColor ?? lineColor,
+    lineWidth: edgeStyle.lineWidth ?? lineWidth,
+    lineStyle: edgeStyle.lineStyle ?? lineStyle,
+    showDots: edgeStyle.showDots ?? showDots,
+    dotRadius: edgeStyle.dotRadius ?? dotRadius,
+    dotColor: edgeStyle.dotColor ?? dotColor,
+    showArrow: edgeStyle.showArrow ?? showArrow,
+    arrowSize: edgeStyle.arrowSize ?? arrowSize,
+    animated: edgeStyle.animated ?? animated,
+    animationSpeed: edgeStyle.animationSpeed ?? animationSpeed,
+    gradient: edgeStyle.gradient ?? gradient,
+    curvature: edgeStyle.curvature ?? curvature,
+    connectorType: edgeStyle.connectorType ?? connectorType,
+  };
+
   const isHorizontal = direction === "horizontal";
 
-  const strokeWidth = toPxNumber(lineWidth, 1.5);
+  const strokeWidth = toPxNumber(edgeProps.lineWidth, 1.5);
   const dashStyle =
-    lineStyle === "dashed" || lineStyle === "dotted" ? lineStyle : "solid";
+    edgeProps.lineStyle === "dashed" || edgeProps.lineStyle === "dotted"
+      ? edgeProps.lineStyle
+      : "solid";
 
   const containerRef = useRef(null);
   const parentRef = useRef(null);
@@ -153,26 +172,89 @@ const FlowNodeView = ({
 
       {hasChildren && (
         <>
-          <DynamicConnector
-            containerEl={containerRef.current}
-            parentEl={parentRef.current}
-            childEls={childElList}
-            stroke={lineColor}
-            strokeWidth={strokeWidth}
-            lineStyle={dashStyle}
-            tick={connectorTick}
-            orientation={direction}
-            showDots={showDots}
-            dotRadius={dotRadius}
-            dotColor={dotColor}
-            showArrow={showArrow}
-            arrowSize={arrowSize}
-            animated={animated}
-            animationSpeed={animationSpeed}
-            gradient={gradient}
-            curvature={curvature}
-            connectorType={connectorType}
-          />
+          {node.children.map((child, index) => {
+            let childEdgeProps = { ...edgeProps };
+            if (_plugin && typeof _plugin.edge === "function") {
+              const childSpecificStyle = _plugin.edge({
+                node,
+                child,
+                style: nodeStyle,
+              });
+              if (childSpecificStyle) {
+                childEdgeProps = {
+                  lineColor:
+                    childSpecificStyle.lineColor ?? childEdgeProps.lineColor,
+                  lineWidth:
+                    childSpecificStyle.lineWidth ?? childEdgeProps.lineWidth,
+                  lineStyle:
+                    childSpecificStyle.lineStyle ?? childEdgeProps.lineStyle,
+                  showDots:
+                    childSpecificStyle.showDots ?? childEdgeProps.showDots,
+                  dotRadius:
+                    childSpecificStyle.dotRadius ?? childEdgeProps.dotRadius,
+                  dotColor:
+                    childSpecificStyle.dotColor ?? childEdgeProps.dotColor,
+                  showArrow:
+                    childSpecificStyle.showArrow ?? childEdgeProps.showArrow,
+                  arrowSize:
+                    childSpecificStyle.arrowSize ?? childEdgeProps.arrowSize,
+                  animated:
+                    childSpecificStyle.animated ?? childEdgeProps.animated,
+                  animationSpeed:
+                    childSpecificStyle.animationSpeed ??
+                    childEdgeProps.animationSpeed,
+                  gradient:
+                    childSpecificStyle.gradient ?? childEdgeProps.gradient,
+                  curvature:
+                    childSpecificStyle.curvature ?? childEdgeProps.curvature,
+                  connectorType:
+                    childSpecificStyle.connectorType ??
+                    childEdgeProps.connectorType,
+                  label: childSpecificStyle.label,
+                  labelStyle: childSpecificStyle.labelStyle,
+                  labelPosition: childSpecificStyle.labelPosition,
+                  labelOffsetX: childSpecificStyle.labelOffsetX,
+                  labelOffsetY: childSpecificStyle.labelOffsetY,
+                };
+              }
+            }
+
+            const childStrokeWidth = toPxNumber(childEdgeProps.lineWidth, 1.5);
+            const childDashStyle =
+              childEdgeProps.lineStyle === "dashed" ||
+              childEdgeProps.lineStyle === "dotted"
+                ? childEdgeProps.lineStyle
+                : "solid";
+
+            return (
+              <DynamicConnector
+                key={child.id}
+                containerEl={containerRef.current}
+                parentEl={parentRef.current}
+                childEls={[childElList[index]]}
+                stroke={childEdgeProps.lineColor}
+                strokeWidth={childStrokeWidth}
+                lineStyle={childDashStyle}
+                tick={connectorTick}
+                orientation={direction}
+                showDots={childEdgeProps.showDots}
+                dotRadius={childEdgeProps.dotRadius}
+                dotColor={childEdgeProps.dotColor}
+                showArrow={childEdgeProps.showArrow}
+                arrowSize={childEdgeProps.arrowSize}
+                animated={childEdgeProps.animated}
+                animationSpeed={childEdgeProps.animationSpeed}
+                gradient={childEdgeProps.gradient}
+                curvature={childEdgeProps.curvature}
+                connectorType={childEdgeProps.connectorType}
+                label={childEdgeProps.label}
+                labelStyle={childEdgeProps.labelStyle}
+                labelPosition={childEdgeProps.labelPosition}
+                labelOffsetX={childEdgeProps.labelOffsetX}
+                labelOffsetY={childEdgeProps.labelOffsetY}
+              />
+            );
+          })}
 
           <Box
             sx={{