@flanksource/clicky-ui 0.3.40 → 0.3.42

package/dist/data/GraphDiagram.cjs

@@ -3,23 +3,21 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const jsxRuntime = require("react/jsx-runtime");
 const react = require("react");
 const utils = require("../lib/utils.cjs");
+const IconButton = require("../components/IconButton.cjs");
+const graphColumnsLayout = require("./graph-columns-layout.cjs");
 const graphLayout = require("./graph-layout.cjs");
+const GraphDiagramEdges = require("./GraphDiagramEdges.cjs");
+const GraphDiagramNodes = require("./GraphDiagramNodes.cjs");
+const graphDiagramModel = require("./graph-diagram-model.cjs");
+const useEdgeFocus = require("./use-edge-focus.cjs");
+const usePanZoom = require("./use-pan-zoom.cjs");
+const graphEdgeRouting = require("./graph-edge-routing.cjs");
+const UiZoomOut = require("../icons/components/UiZoomOut.cjs");
+const UiZoomIn = require("../icons/components/UiZoomIn.cjs");
+const UiFullscreen = require("../icons/components/UiFullscreen.cjs");
+const UiHome = require("../icons/components/UiHome.cjs");
 const DEFAULT_NODE_WIDTH = 168;
 const DEFAULT_NODE_HEIGHT = 60;
-const TONE_TEXT_CLASS = {
-  neutral: "text-muted-foreground",
-  success: "text-emerald-600 dark:text-emerald-400",
-  danger: "text-red-600 dark:text-red-400",
-  warning: "text-amber-600 dark:text-amber-400",
-  info: "text-sky-600 dark:text-sky-400"
-};
-const TONE_NODE_CLASS = {
-  neutral: "border-border bg-card text-foreground",
-  success: "border-emerald-500/50 bg-emerald-500/10 text-foreground",
-  danger: "border-red-500/50 bg-red-500/10 text-foreground",
-  warning: "border-amber-500/50 bg-amber-500/10 text-foreground",
-  info: "border-sky-500/50 bg-sky-500/10 text-foreground"
-};
 function assertEdgesReferenceKnownNodes(nodes, edges) {
   const ids = new Set(nodes.map((node) => node.id));
   for (const edge of edges) {
@@ -31,10 +29,31 @@ function assertEdgesReferenceKnownNodes(nodes, edges) {
     }
   }
 }
-function layoutNodes(layout, nodes, nodeWidth, nodeHeight) {
+function requireLevel(node) {
+  if (node.level === void 0 || !Number.isFinite(node.level)) {
+    throw new Error(`GraphDiagram: node "${node.id}" needs a finite level for the "columns" layout`);
+  }
+  return node.level;
+}
+function layoutNodes(nodes, edges, { layout, nodeWidth, nodeHeight, columnGap, rowGap }) {
   switch (layout) {
     case "ring":
-      return graphLayout.ringLayout(nodes, { nodeWidth, nodeHeight });
+      return { ...graphLayout.ringLayout(nodes, { nodeWidth, nodeHeight }), groups: [] };
+    case "columns":
+      return graphColumnsLayout.columnsLayout(
+        nodes.map((node) => ({
+          id: node.id,
+          level: requireLevel(node),
+          ...node.group !== void 0 ? { group: node.group } : {}
+        })),
+        edges,
+        {
+          nodeWidth,
+          nodeHeight,
+          ...columnGap !== void 0 ? { columnGap } : {},
+          ...rowGap !== void 0 ? { rowGap } : {}
+        }
+      );
     default:
       throw new Error(`GraphDiagram: unknown layout "${layout}"`);
   }
@@ -42,25 +61,25 @@ function layoutNodes(layout, nodes, nodeWidth, nodeHeight) {
 function toPercent(value, extent) {
   return `${value / extent * 100}%`;
 }
-function requireRoute(routes, edgeId) {
-  const route = routes[edgeId];
-  if (!route) {
-    throw new Error(`GraphDiagram: no route computed for edge "${edgeId}"`);
-  }
-  return route;
+function stageStyle(size, natural, panZoom) {
+  if (!natural) return { aspectRatio: `${size.width} / ${size.height}` };
+  if (!panZoom) return size;
+  const { x, y, scale } = panZoom.transform;
+  return { ...size, transform: `translate(${x}px, ${y}px) scale(${scale})`, transformOrigin: "0 0" };
 }
-function requirePosition(positions, nodeId) {
-  const position = positions[nodeId];
-  if (!position) {
-    throw new Error(`GraphDiagram: no layout position computed for node "${nodeId}"`);
-  }
-  return position;
+function ZoomControls({ panZoom, resettable }) {
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "absolute right-2 top-2 flex cursor-default gap-0.5 rounded-md border border-border bg-background p-0.5 shadow-sm", children: [
+    /* @__PURE__ */ jsxRuntime.jsx(IconButton.IconButton, { icon: UiZoomOut.UiZoomOut, label: "Zoom out", className: "size-6", onClick: panZoom.zoomOut }),
+    /* @__PURE__ */ jsxRuntime.jsx(IconButton.IconButton, { icon: UiZoomIn.UiZoomIn, label: "Zoom in", className: "size-6", onClick: panZoom.zoomIn }),
+    /* @__PURE__ */ jsxRuntime.jsx(IconButton.IconButton, { icon: UiFullscreen.UiFullscreen, label: "Fit to view", className: "size-6", onClick: panZoom.fit }),
+    resettable && /* @__PURE__ */ jsxRuntime.jsx(IconButton.IconButton, { icon: UiHome.UiHome, label: "Reset view", className: "size-6", onClick: panZoom.reset })
+  ] });
 }
-function handleNodeKeyDown(event, select) {
-  if (event.key === "Enter" || event.key === " ") {
-    event.preventDefault();
-    select();
-  }
+function openingFit(positions, fitMinScale, focusId) {
+  return {
+    ...fitMinScale !== void 0 ? { minScale: fitMinScale } : {},
+    ...focusId !== void 0 ? { focus: graphDiagramModel.requireEntry(positions, focusId, "layout position") } : {}
+  };
 }
 function GraphDiagram({
   nodes,
@@ -68,132 +87,100 @@ function GraphDiagram({
   layout = "ring",
   selectedId,
   onNodeSelect,
+  onNodeExpand,
+  selectedEdgeId,
+  onEdgeSelect,
+  edgeFocus = "auto",
+  groups,
   nodeWidth = DEFAULT_NODE_WIDTH,
   nodeHeight = DEFAULT_NODE_HEIGHT,
+  columnGap,
+  rowGap,
+  zoomable = false,
+  fitMinScale,
+  focusId,
   maxHeight,
   ariaLabel,
   className
 }) {
   assertEdgesReferenceKnownNodes(nodes, edges);
-  const { width, height, positions } = react.useMemo(
-    () => layoutNodes(layout, nodes, nodeWidth, nodeHeight),
-    [layout, nodes, nodeWidth, nodeHeight]
+  const markerPrefix = `graph-diagram-${react.useId().replace(/[^a-zA-Z0-9_-]/g, "")}`;
+  const { width, height, positions, groups: groupBoxes } = react.useMemo(
+    () => layoutNodes(nodes, edges, { layout, nodeWidth, nodeHeight, columnGap, rowGap }),
+    [layout, nodes, edges, nodeWidth, nodeHeight, columnGap, rowGap]
   );
   const routes = react.useMemo(
-    () => graphLayout.routeEdges(edges, positions, { nodeWidth, nodeHeight }),
-    [edges, positions, nodeWidth, nodeHeight]
-  );
-  const tones = react.useMemo(
-    () => Array.from(new Set(edges.map((edge) => edge.tone ?? "neutral"))),
-    [edges]
+    () => graphEdgeRouting.routeEdges(edges, positions, { nodeWidth, nodeHeight }, { anchor: layout === "columns" ? "side" : "center" }),
+    [edges, positions, nodeWidth, nodeHeight, layout]
   );
-  return /* @__PURE__ */ jsxRuntime.jsx(
+  const panZoom = usePanZoom.usePanZoom({
+    enabled: zoomable,
+    contentWidth: width,
+    contentHeight: height,
+    opening: openingFit(positions, fitMinScale, focusId)
+  });
+  const natural = layout === "columns" || zoomable;
+  const place = natural ? ({ x, y }) => ({ left: x, top: y }) : ({ x, y }) => ({ left: toPercent(x, width), top: toPercent(y, height) });
+  const focus = useEdgeFocus.useEdgeFocus({ mode: edgeFocus, edges, selectedId, selectedEdgeId });
+  const edgeSelection = { selectedEdgeId, onEdgeSelect, focus: focus.state };
+  return /* @__PURE__ */ jsxRuntime.jsxs(
     "div",
     {
-      className: utils.cn("w-full overflow-auto", className),
+      ref: panZoom.viewportRef,
+      className: utils.cn(
+        "w-full",
+        zoomable ? "relative touch-none overflow-hidden" : "overflow-auto",
+        zoomable && (panZoom.panning ? "cursor-grabbing select-none" : "cursor-grab"),
+        className
+      ),
       style: maxHeight != null ? { maxHeight } : void 0,
-      children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative w-full", style: { aspectRatio: `${width} / ${height}` }, children: [
+      ...panZoom.handlers,
+      children: [
         /* @__PURE__ */ jsxRuntime.jsxs(
-          "svg",
+          "div",
           {
-            viewBox: `0 0 ${width} ${height}`,
-            preserveAspectRatio: "xMidYMid meet",
-            role: "img",
-            "aria-label": ariaLabel,
-            className: "absolute inset-0 h-full w-full",
+            ref: panZoom.contentRef,
+            "data-graph-stage": "",
+            className: utils.cn("relative", natural ? !zoomable && "mx-auto" : "w-full"),
+            style: stageStyle({ width, height }, natural, zoomable ? panZoom : void 0),
             children: [
-              /* @__PURE__ */ jsxRuntime.jsx("defs", { children: tones.map((tone) => /* @__PURE__ */ jsxRuntime.jsx(
-                "marker",
+              /* @__PURE__ */ jsxRuntime.jsx(GraphDiagramNodes.GraphDiagramGroupBoxes, { boxes: groupBoxes, groups }),
+              /* @__PURE__ */ jsxRuntime.jsx(
+                GraphDiagramEdges.GraphDiagramEdgePaths,
                 {
-                  id: `graph-diagram-arrow-${tone}`,
-                  viewBox: "0 0 10 10",
-                  refX: 8,
-                  refY: 5,
-                  markerWidth: 7,
-                  markerHeight: 7,
-                  orient: "auto-start-reverse",
-                  children: /* @__PURE__ */ jsxRuntime.jsx("path", { d: "M0,0 L10,5 L0,10 z", className: utils.cn(TONE_TEXT_CLASS[tone], "fill-current") })
-                },
-                tone
-              )) }),
-              edges.map((edge) => {
-                const tone = edge.tone ?? "neutral";
-                return /* @__PURE__ */ jsxRuntime.jsx(
-                  "path",
+                  edges,
+                  nodes,
+                  routes,
+                  width,
+                  height,
+                  ariaLabel,
+                  markerPrefix,
+                  onEdgeHover: focus.onEdgeHover,
+                  ...edgeSelection
+                }
+              ),
+              /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "pointer-events-none absolute inset-0", children: [
+                /* @__PURE__ */ jsxRuntime.jsx(GraphDiagramEdges.GraphDiagramEdgeLabels, { edges, routes, place, spread: natural, ...edgeSelection }),
+                /* @__PURE__ */ jsxRuntime.jsx(
+                  GraphDiagramNodes.GraphDiagramNodes,
                   {
-                    d: requireRoute(routes, edge.id).path,
-                    fill: "none",
-                    stroke: "currentColor",
-                    strokeWidth: 1.5,
-                    strokeDasharray: edge.dashed ? "5 4" : void 0,
-                    markerEnd: `url(#graph-diagram-arrow-${tone})`,
-                    className: TONE_TEXT_CLASS[tone]
-                  },
-                  edge.id
-                );
-              })
+                    nodes,
+                    positions,
+                    place,
+                    nodeWidth,
+                    nodeHeight,
+                    selectedId,
+                    onNodeSelect,
+                    onNodeExpand,
+                    onNodeHover: focus.onNodeHover
+                  }
+                )
+              ] })
             ]
           }
         ),
-        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "absolute inset-0", children: [
-          edges.map((edge) => {
-            if (!edge.label) return null;
-            const route = requireRoute(routes, edge.id);
-            const tone = edge.tone ?? "neutral";
-            return /* @__PURE__ */ jsxRuntime.jsx(
-              "span",
-              {
-                className: utils.cn(
-                  "absolute -translate-x-1/2 -translate-y-1/2 whitespace-nowrap rounded-full border border-border bg-background px-1.5 py-0.5 text-[10px] font-medium shadow-sm",
-                  TONE_TEXT_CLASS[tone]
-                ),
-                style: { left: toPercent(route.labelX, width), top: toPercent(route.labelY, height) },
-                children: edge.label
-              },
-              `label-${edge.id}`
-            );
-          }),
-          nodes.map((node) => {
-            const position = requirePosition(positions, node.id);
-            const selected = selectedId != null && node.id === selectedId;
-            const tone = node.tone ?? "neutral";
-            const shapeClass = node.shape === "pill" ? "rounded-full" : "rounded-lg";
-            const interactive = onNodeSelect != null;
-            return /* @__PURE__ */ jsxRuntime.jsxs(
-              "div",
-              {
-                className: utils.cn(
-                  "absolute flex -translate-x-1/2 -translate-y-1/2 flex-col items-center justify-center gap-0.5 border px-3 py-1.5 text-center text-xs shadow-sm",
-                  shapeClass,
-                  TONE_NODE_CLASS[tone],
-                  selected && "ring-2 ring-primary ring-offset-2 ring-offset-background",
-                  interactive && "cursor-pointer"
-                ),
-                style: {
-                  left: toPercent(position.x, width),
-                  top: toPercent(position.y, height),
-                  width: nodeWidth,
-                  height: nodeHeight
-                },
-                ...interactive ? {
-                  role: "button",
-                  tabIndex: 0,
-                  "aria-pressed": selected,
-                  onClick: () => onNodeSelect(node.id),
-                  onKeyDown: (event) => handleNodeKeyDown(event, () => onNodeSelect(node.id))
-                } : {},
-                "aria-label": node.ariaLabel,
-                children: [
-                  /* @__PURE__ */ jsxRuntime.jsx("span", { className: "line-clamp-2 font-medium leading-tight", children: node.label }),
-                  node.detail != null && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "line-clamp-1 text-[10px] leading-tight text-muted-foreground", children: node.detail }),
-                  node.badge != null && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "mt-0.5", children: node.badge })
-                ]
-              },
-              node.id
-            );
-          })
-        ] })
-      ] })
+        zoomable && /* @__PURE__ */ jsxRuntime.jsx(ZoomControls, { panZoom, resettable: fitMinScale !== void 0 })
+      ]
     }
   );
 }

package/dist/data/GraphDiagram.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"GraphDiagram.cjs","sources":["../../src/data/GraphDiagram.tsx"],"sourcesContent":["import { useMemo, type KeyboardEvent, type ReactNode } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport type { BadgeTone } from \"./Badge\";\nimport { ringLayout, routeEdges, type GraphLayoutPosition } from \"./graph-layout\";\n\n// GraphDiagram renders a generic, type-agnostic node/edge diagram — a small\n// cycle of resources and processes, a dependency graph, any relationship that\n// doesn't read well as a left-to-right column layout because it has back\n// edges or reciprocal pairs. It knows nothing about the domain: a producer\n// maps its data into GraphDiagramNode/GraphDiagramEdge and gets the same\n// ring layout, curved-edge routing, and selection behaviour.\n\nexport interface GraphDiagramNode {\n  id: string;\n  label: ReactNode;\n  detail?: ReactNode;\n  badge?: ReactNode;\n  tone?: BadgeTone;\n  shape?: \"pill\" | \"rect\";\n  /** Accessible name for the node, when `label` alone isn't enough. */\n  ariaLabel?: string;\n}\n\nexport interface GraphDiagramEdge {\n  id: string;\n  from: string;\n  to: string;\n  label?: string;\n  tone?: BadgeTone;\n  dashed?: boolean;\n}\n\nexport type GraphDiagramLayout = \"ring\";\n\nexport interface GraphDiagramProps {\n  nodes: GraphDiagramNode[];\n  edges: GraphDiagramEdge[];\n  /** Only \"ring\" today; a \"columns\" layout is planned. */\n  layout?: GraphDiagramLayout;\n  selectedId?: string;\n  onNodeSelect?: (id: string) => void;\n  nodeWidth?: number;\n  nodeHeight?: number;\n  maxHeight?: number | string;\n  ariaLabel: string;\n  className?: string;\n}\n\nconst DEFAULT_NODE_WIDTH = 168;\nconst DEFAULT_NODE_HEIGHT = 60;\n\nconst TONE_TEXT_CLASS: Record<BadgeTone, string> = {\n  neutral: \"text-muted-foreground\",\n  success: \"text-emerald-600 dark:text-emerald-400\",\n  danger: \"text-red-600 dark:text-red-400\",\n  warning: \"text-amber-600 dark:text-amber-400\",\n  info: \"text-sky-600 dark:text-sky-400\",\n};\n\nconst TONE_NODE_CLASS: Record<BadgeTone, string> = {\n  neutral: \"border-border bg-card text-foreground\",\n  success: \"border-emerald-500/50 bg-emerald-500/10 text-foreground\",\n  danger: \"border-red-500/50 bg-red-500/10 text-foreground\",\n  warning: \"border-amber-500/50 bg-amber-500/10 text-foreground\",\n  info: \"border-sky-500/50 bg-sky-500/10 text-foreground\",\n};\n\nfunction assertEdgesReferenceKnownNodes(nodes: GraphDiagramNode[], edges: GraphDiagramEdge[]): void {\n  const ids = new Set(nodes.map((node) => node.id));\n  for (const edge of edges) {\n    if (!ids.has(edge.from)) {\n      throw new Error(`GraphDiagram: edge \"${edge.id}\" references unknown node \"${edge.from}\"`);\n    }\n    if (!ids.has(edge.to)) {\n      throw new Error(`GraphDiagram: edge \"${edge.id}\" references unknown node \"${edge.to}\"`);\n    }\n  }\n}\n\nfunction layoutNodes(\n  layout: GraphDiagramLayout,\n  nodes: GraphDiagramNode[],\n  nodeWidth: number,\n  nodeHeight: number,\n): { width: number; height: number; positions: Record<string, GraphLayoutPosition> } {\n  switch (layout) {\n    case \"ring\":\n      return ringLayout(nodes, { nodeWidth, nodeHeight });\n    default:\n      throw new Error(`GraphDiagram: unknown layout \"${layout satisfies never}\"`);\n  }\n}\n\nfunction toPercent(value: number, extent: number): string {\n  return `${(value / extent) * 100}%`;\n}\n\nfunction requireRoute<T>(routes: Record<string, T>, edgeId: string): T {\n  const route = routes[edgeId];\n  if (!route) {\n    throw new Error(`GraphDiagram: no route computed for edge \"${edgeId}\"`);\n  }\n  return route;\n}\n\nfunction requirePosition(\n  positions: Record<string, GraphLayoutPosition>,\n  nodeId: string,\n): GraphLayoutPosition {\n  const position = positions[nodeId];\n  if (!position) {\n    throw new Error(`GraphDiagram: no layout position computed for node \"${nodeId}\"`);\n  }\n  return position;\n}\n\nfunction handleNodeKeyDown(event: KeyboardEvent<HTMLDivElement>, select: () => void): void {\n  if (event.key === \"Enter\" || event.key === \" \") {\n    event.preventDefault();\n    select();\n  }\n}\n\nexport function GraphDiagram({\n  nodes,\n  edges,\n  layout = \"ring\",\n  selectedId,\n  onNodeSelect,\n  nodeWidth = DEFAULT_NODE_WIDTH,\n  nodeHeight = DEFAULT_NODE_HEIGHT,\n  maxHeight,\n  ariaLabel,\n  className,\n}: GraphDiagramProps) {\n  assertEdgesReferenceKnownNodes(nodes, edges);\n\n  const { width, height, positions } = useMemo(\n    () => layoutNodes(layout, nodes, nodeWidth, nodeHeight),\n    [layout, nodes, nodeWidth, nodeHeight],\n  );\n\n  const routes = useMemo(\n    () => routeEdges(edges, positions, { nodeWidth, nodeHeight }),\n    [edges, positions, nodeWidth, nodeHeight],\n  );\n\n  const tones = useMemo(\n    () => Array.from(new Set(edges.map((edge) => edge.tone ?? \"neutral\"))),\n    [edges],\n  );\n\n  return (\n    <div\n      className={cn(\"w-full overflow-auto\", className)}\n      style={maxHeight != null ? { maxHeight } : undefined}\n    >\n      <div className=\"relative w-full\" style={{ aspectRatio: `${width} / ${height}` }}>\n        <svg\n          viewBox={`0 0 ${width} ${height}`}\n          preserveAspectRatio=\"xMidYMid meet\"\n          role=\"img\"\n          aria-label={ariaLabel}\n          className=\"absolute inset-0 h-full w-full\"\n        >\n          <defs>\n            {tones.map((tone) => (\n              <marker\n                key={tone}\n                id={`graph-diagram-arrow-${tone}`}\n                viewBox=\"0 0 10 10\"\n                refX={8}\n                refY={5}\n                markerWidth={7}\n                markerHeight={7}\n                orient=\"auto-start-reverse\"\n              >\n                <path d=\"M0,0 L10,5 L0,10 z\" className={cn(TONE_TEXT_CLASS[tone], \"fill-current\")} />\n              </marker>\n            ))}\n          </defs>\n          {edges.map((edge) => {\n            const tone = edge.tone ?? \"neutral\";\n            return (\n              <path\n                key={edge.id}\n                d={requireRoute(routes, edge.id).path}\n                fill=\"none\"\n                stroke=\"currentColor\"\n                strokeWidth={1.5}\n                strokeDasharray={edge.dashed ? \"5 4\" : undefined}\n                markerEnd={`url(#graph-diagram-arrow-${tone})`}\n                className={TONE_TEXT_CLASS[tone]}\n              />\n            );\n          })}\n        </svg>\n\n        <div className=\"absolute inset-0\">\n          {edges.map((edge) => {\n            if (!edge.label) return null;\n            const route = requireRoute(routes, edge.id);\n            const tone = edge.tone ?? \"neutral\";\n            return (\n              <span\n                key={`label-${edge.id}`}\n                className={cn(\n                  \"absolute -translate-x-1/2 -translate-y-1/2 whitespace-nowrap rounded-full border border-border bg-background px-1.5 py-0.5 text-[10px] font-medium shadow-sm\",\n                  TONE_TEXT_CLASS[tone],\n                )}\n                style={{ left: toPercent(route.labelX, width), top: toPercent(route.labelY, height) }}\n              >\n                {edge.label}\n              </span>\n            );\n          })}\n\n          {nodes.map((node) => {\n            const position = requirePosition(positions, node.id);\n            const selected = selectedId != null && node.id === selectedId;\n            const tone = node.tone ?? \"neutral\";\n            const shapeClass = node.shape === \"pill\" ? \"rounded-full\" : \"rounded-lg\";\n            const interactive = onNodeSelect != null;\n\n            return (\n              <div\n                key={node.id}\n                className={cn(\n                  \"absolute flex -translate-x-1/2 -translate-y-1/2 flex-col items-center justify-center gap-0.5 border px-3 py-1.5 text-center text-xs shadow-sm\",\n                  shapeClass,\n                  TONE_NODE_CLASS[tone],\n                  selected && \"ring-2 ring-primary ring-offset-2 ring-offset-background\",\n                  interactive && \"cursor-pointer\",\n                )}\n                style={{\n                  left: toPercent(position.x, width),\n                  top: toPercent(position.y, height),\n                  width: nodeWidth,\n                  height: nodeHeight,\n                }}\n                {...(interactive\n                  ? {\n                      role: \"button\" as const,\n                      tabIndex: 0,\n                      \"aria-pressed\": selected,\n                      onClick: () => onNodeSelect(node.id),\n                      onKeyDown: (event: KeyboardEvent<HTMLDivElement>) =>\n                        handleNodeKeyDown(event, () => onNodeSelect(node.id)),\n                    }\n                  : {})}\n                aria-label={node.ariaLabel}\n              >\n                <span className=\"line-clamp-2 font-medium leading-tight\">{node.label}</span>\n                {node.detail != null && (\n                  <span className=\"line-clamp-1 text-[10px] leading-tight text-muted-foreground\">\n                    {node.detail}\n                  </span>\n                )}\n                {node.badge != null && <span className=\"mt-0.5\">{node.badge}</span>}\n              </div>\n            );\n          })}\n        </div>\n      </div>\n    </div>\n  );\n}\n"],"names":["ringLayout","useMemo","routeEdges","jsx","cn","jsxs"],"mappings":"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"}
+{"version":3,"file":"GraphDiagram.cjs","sources":["../../src/data/GraphDiagram.tsx"],"sourcesContent":["import { useId, useMemo, type CSSProperties } from \"react\";\nimport { cn } from \"../lib/utils\";\nimport { IconButton } from \"../components/IconButton\";\nimport { UiFullscreen, UiHome, UiZoomIn, UiZoomOut } from \"../icons\";\nimport { columnsLayout, type ColumnsLayoutResult } from \"./graph-columns-layout\";\nimport { ringLayout, routeEdges, type GraphLayoutPosition } from \"./graph-layout\";\nimport { GraphDiagramEdgeLabels, GraphDiagramEdgePaths } from \"./GraphDiagramEdges\";\nimport { GraphDiagramGroupBoxes, GraphDiagramNodes } from \"./GraphDiagramNodes\";\nimport {\n  requireEntry,\n  type GraphDiagramEdge,\n  type GraphDiagramEdgeFocus,\n  type GraphDiagramGroup,\n  type GraphDiagramLayout,\n  type GraphDiagramNode,\n  type GraphPlacer,\n} from \"./graph-diagram-model\";\nimport { useEdgeFocus } from \"./use-edge-focus\";\nimport { usePanZoom, type FitOptions, type PanZoom } from \"./use-pan-zoom\";\n\nexport type {\n  GraphDiagramEdge,\n  GraphDiagramEdgeFocus,\n  GraphDiagramGroup,\n  GraphDiagramLayout,\n  GraphDiagramNode,\n} from \"./graph-diagram-model\";\n\n// GraphDiagram renders a generic, type-agnostic node/edge diagram. It knows\n// nothing about the domain: a producer maps its data into\n// GraphDiagramNode/GraphDiagramEdge and gets layout, edge routing and\n// selection behaviour.\n//\n// \"ring\" suits a small cycle of resources and processes — relationships with\n// back edges or reciprocal pairs. \"columns\" suits a directed graph with a\n// natural depth (a call graph, a dependency chain): nodes sit in the column of\n// their `level`, grouped and boxed by `group`.\n//\n// The \"columns\" layout, and any zoomable diagram, is drawn at its natural\n// pixel size so node boxes, edges and group boxes share one coordinate system\n// at every container width and zoom level. A non-zoomable \"ring\" keeps scaling\n// its node positions to the container width.\n\nexport interface GraphDiagramProps {\n  nodes: GraphDiagramNode[];\n  edges: GraphDiagramEdge[];\n  /** Defaults to \"ring\". \"columns\" needs a `level` on every node. */\n  layout?: GraphDiagramLayout;\n  selectedId?: string;\n  onNodeSelect?: (id: string) => void;\n  /** Called by a node's `+N` control (see `expandCount`); does not select the node. */\n  onNodeExpand?: (id: string) => void;\n  selectedEdgeId?: string;\n  /** Makes edges, and their label pills, selectable. */\n  onEdgeSelect?: (id: string) => void;\n  /**\n   * Whether an edge shows its pill only while in focus, and fades while another is. Defaults to\n   * \"auto\": a diagram with more than 32 edges is focused, a smaller one shows everything.\n   */\n  edgeFocus?: GraphDiagramEdgeFocus;\n  /** \"columns\" layout: captions for the group rectangles. A group without an entry shows its id. */\n  groups?: GraphDiagramGroup[];\n  nodeWidth?: number;\n  nodeHeight?: number;\n  /** \"columns\" layout: horizontal gap between columns in px. Leave room for edge label pills. */\n  columnGap?: number;\n  /** \"columns\" layout: vertical gap between stacked nodes in px. */\n  rowGap?: number;\n  /** Ctrl/meta + wheel (or pinch) zooms, dragging the background pans, and zoom controls appear. */\n  zoomable?: boolean;\n  /**\n   * Zoomable: the smallest scale the diagram opens at, so its text stays readable. A diagram too\n   * large for it opens overflowing, centred on `focusId`, and is panned to reach the rest. `Fit to\n   * view` still shows everything, and `Reset view` returns here. Unset, the diagram opens whole.\n   */\n  fitMinScale?: number;\n  /** Zoomable: the node an overflowing diagram opens centred on. Defaults to the diagram's centre. */\n  focusId?: string;\n  maxHeight?: number | string;\n  ariaLabel: string;\n  className?: string;\n}\n\nconst DEFAULT_NODE_WIDTH = 168;\nconst DEFAULT_NODE_HEIGHT = 60;\n\ninterface LayoutOptions {\n  layout: GraphDiagramLayout;\n  nodeWidth: number;\n  nodeHeight: number;\n  columnGap: number | undefined;\n  rowGap: number | undefined;\n}\n\nfunction assertEdgesReferenceKnownNodes(nodes: GraphDiagramNode[], edges: GraphDiagramEdge[]): void {\n  const ids = new Set(nodes.map((node) => node.id));\n  for (const edge of edges) {\n    if (!ids.has(edge.from)) {\n      throw new Error(`GraphDiagram: edge \"${edge.id}\" references unknown node \"${edge.from}\"`);\n    }\n    if (!ids.has(edge.to)) {\n      throw new Error(`GraphDiagram: edge \"${edge.id}\" references unknown node \"${edge.to}\"`);\n    }\n  }\n}\n\nfunction requireLevel(node: GraphDiagramNode): number {\n  if (node.level === undefined || !Number.isFinite(node.level)) {\n    throw new Error(`GraphDiagram: node \"${node.id}\" needs a finite level for the \"columns\" layout`);\n  }\n  return node.level;\n}\n\nfunction layoutNodes(\n  nodes: GraphDiagramNode[],\n  edges: GraphDiagramEdge[],\n  { layout, nodeWidth, nodeHeight, columnGap, rowGap }: LayoutOptions,\n): ColumnsLayoutResult {\n  switch (layout) {\n    case \"ring\":\n      return { ...ringLayout(nodes, { nodeWidth, nodeHeight }), groups: [] };\n    case \"columns\":\n      return columnsLayout(\n        nodes.map((node) => ({\n          id: node.id,\n          level: requireLevel(node),\n          ...(node.group !== undefined ? { group: node.group } : {}),\n        })),\n        edges,\n        {\n          nodeWidth,\n          nodeHeight,\n          ...(columnGap !== undefined ? { columnGap } : {}),\n          ...(rowGap !== undefined ? { rowGap } : {}),\n        },\n      );\n    default:\n      throw new Error(`GraphDiagram: unknown layout \"${layout satisfies never}\"`);\n  }\n}\n\nfunction toPercent(value: number, extent: number): string {\n  return `${(value / extent) * 100}%`;\n}\n\nfunction stageStyle(size: { width: number; height: number }, natural: boolean, panZoom: PanZoom | undefined): CSSProperties {\n  if (!natural) return { aspectRatio: `${size.width} / ${size.height}` };\n  if (!panZoom) return size;\n  const { x, y, scale } = panZoom.transform;\n  return { ...size, transform: `translate(${x}px, ${y}px) scale(${scale})`, transformOrigin: \"0 0\" };\n}\n\n/** `resettable`: the diagram opens at another view than the whole of it, so there is one to return to. */\nfunction ZoomControls({ panZoom, resettable }: { panZoom: PanZoom; resettable: boolean }) {\n  return (\n    <div className=\"absolute right-2 top-2 flex cursor-default gap-0.5 rounded-md border border-border bg-background p-0.5 shadow-sm\">\n      <IconButton icon={UiZoomOut} label=\"Zoom out\" className=\"size-6\" onClick={panZoom.zoomOut} />\n      <IconButton icon={UiZoomIn} label=\"Zoom in\" className=\"size-6\" onClick={panZoom.zoomIn} />\n      <IconButton icon={UiFullscreen} label=\"Fit to view\" className=\"size-6\" onClick={panZoom.fit} />\n      {resettable && <IconButton icon={UiHome} label=\"Reset view\" className=\"size-6\" onClick={panZoom.reset} />}\n    </div>\n  );\n}\n\n/** How a zoomable diagram opens: no smaller than `fitMinScale`, centred on the `focusId` node. */\nfunction openingFit(\n  positions: Record<string, GraphLayoutPosition>,\n  fitMinScale: number | undefined,\n  focusId: string | undefined,\n): FitOptions {\n  return {\n    ...(fitMinScale !== undefined ? { minScale: fitMinScale } : {}),\n    ...(focusId !== undefined ? { focus: requireEntry(positions, focusId, \"layout position\") } : {}),\n  };\n}\n\nexport function GraphDiagram({\n  nodes,\n  edges,\n  layout = \"ring\",\n  selectedId,\n  onNodeSelect,\n  onNodeExpand,\n  selectedEdgeId,\n  onEdgeSelect,\n  edgeFocus = \"auto\",\n  groups,\n  nodeWidth = DEFAULT_NODE_WIDTH,\n  nodeHeight = DEFAULT_NODE_HEIGHT,\n  columnGap,\n  rowGap,\n  zoomable = false,\n  fitMinScale,\n  focusId,\n  maxHeight,\n  ariaLabel,\n  className,\n}: GraphDiagramProps) {\n  assertEdgesReferenceKnownNodes(nodes, edges);\n  const markerPrefix = `graph-diagram-${useId().replace(/[^a-zA-Z0-9_-]/g, \"\")}`;\n\n  const { width, height, positions, groups: groupBoxes } = useMemo(\n    () => layoutNodes(nodes, edges, { layout, nodeWidth, nodeHeight, columnGap, rowGap }),\n    [layout, nodes, edges, nodeWidth, nodeHeight, columnGap, rowGap],\n  );\n  const routes = useMemo(\n    () =>\n      routeEdges(edges, positions, { nodeWidth, nodeHeight }, { anchor: layout === \"columns\" ? \"side\" : \"center\" }),\n    [edges, positions, nodeWidth, nodeHeight, layout],\n  );\n\n  const panZoom = usePanZoom({\n    enabled: zoomable,\n    contentWidth: width,\n    contentHeight: height,\n    opening: openingFit(positions, fitMinScale, focusId),\n  });\n  const natural = layout === \"columns\" || zoomable;\n  const place: GraphPlacer = natural\n    ? ({ x, y }) => ({ left: x, top: y })\n    : ({ x, y }) => ({ left: toPercent(x, width), top: toPercent(y, height) });\n  const focus = useEdgeFocus({ mode: edgeFocus, edges, selectedId, selectedEdgeId });\n  const edgeSelection = { selectedEdgeId, onEdgeSelect, focus: focus.state };\n\n  return (\n    <div\n      ref={panZoom.viewportRef}\n      className={cn(\n        \"w-full\",\n        zoomable ? \"relative touch-none overflow-hidden\" : \"overflow-auto\",\n        zoomable && (panZoom.panning ? \"cursor-grabbing select-none\" : \"cursor-grab\"),\n        className,\n      )}\n      style={maxHeight != null ? { maxHeight } : undefined}\n      {...panZoom.handlers}\n    >\n      <div\n        ref={panZoom.contentRef}\n        data-graph-stage=\"\"\n        className={cn(\"relative\", natural ? !zoomable && \"mx-auto\" : \"w-full\")}\n        style={stageStyle({ width, height }, natural, zoomable ? panZoom : undefined)}\n      >\n        <GraphDiagramGroupBoxes boxes={groupBoxes} groups={groups} />\n        <GraphDiagramEdgePaths\n          edges={edges}\n          nodes={nodes}\n          routes={routes}\n          width={width}\n          height={height}\n          ariaLabel={ariaLabel}\n          markerPrefix={markerPrefix}\n          onEdgeHover={focus.onEdgeHover}\n          {...edgeSelection}\n        />\n        <div className=\"pointer-events-none absolute inset-0\">\n          <GraphDiagramEdgeLabels edges={edges} routes={routes} place={place} spread={natural} {...edgeSelection} />\n          <GraphDiagramNodes\n            nodes={nodes}\n            positions={positions}\n            place={place}\n            nodeWidth={nodeWidth}\n            nodeHeight={nodeHeight}\n            selectedId={selectedId}\n            onNodeSelect={onNodeSelect}\n            onNodeExpand={onNodeExpand}\n            onNodeHover={focus.onNodeHover}\n          />\n        </div>\n      </div>\n      {zoomable && <ZoomControls panZoom={panZoom} resettable={fitMinScale !== undefined} />}\n    </div>\n  );\n}\n"],"names":["ringLayout","columnsLayout","jsxs","jsx","IconButton","UiZoomOut","UiZoomIn","UiFullscreen","UiHome","requireEntry","useId","useMemo","routeEdges","usePanZoom","useEdgeFocus","cn","GraphDiagramGroupBoxes","GraphDiagramEdgePaths","GraphDiagramEdgeLabels","GraphDiagramNodes"],"mappings":"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"}

package/dist/data/GraphDiagram.d.ts

@@ -1,36 +1,43 @@
-import { ReactNode } from 'react';
-import { BadgeTone } from './Badge.js';
-export interface GraphDiagramNode {
-    id: string;
-    label: ReactNode;
-    detail?: ReactNode;
-    badge?: ReactNode;
-    tone?: BadgeTone;
-    shape?: "pill" | "rect";
-    /** Accessible name for the node, when `label` alone isn't enough. */
-    ariaLabel?: string;
-}
-export interface GraphDiagramEdge {
-    id: string;
-    from: string;
-    to: string;
-    label?: string;
-    tone?: BadgeTone;
-    dashed?: boolean;
-}
-export type GraphDiagramLayout = "ring";
+import { GraphDiagramEdge, GraphDiagramEdgeFocus, GraphDiagramGroup, GraphDiagramLayout, GraphDiagramNode } from './graph-diagram-model.js';
+export type { GraphDiagramEdge, GraphDiagramEdgeFocus, GraphDiagramGroup, GraphDiagramLayout, GraphDiagramNode, } from './graph-diagram-model.js';
 export interface GraphDiagramProps {
     nodes: GraphDiagramNode[];
     edges: GraphDiagramEdge[];
-    /** Only "ring" today; a "columns" layout is planned. */
+    /** Defaults to "ring". "columns" needs a `level` on every node. */
     layout?: GraphDiagramLayout;
     selectedId?: string;
     onNodeSelect?: (id: string) => void;
+    /** Called by a node's `+N` control (see `expandCount`); does not select the node. */
+    onNodeExpand?: (id: string) => void;
+    selectedEdgeId?: string;
+    /** Makes edges, and their label pills, selectable. */
+    onEdgeSelect?: (id: string) => void;
+    /**
+     * Whether an edge shows its pill only while in focus, and fades while another is. Defaults to
+     * "auto": a diagram with more than 32 edges is focused, a smaller one shows everything.
+     */
+    edgeFocus?: GraphDiagramEdgeFocus;
+    /** "columns" layout: captions for the group rectangles. A group without an entry shows its id. */
+    groups?: GraphDiagramGroup[];
     nodeWidth?: number;
     nodeHeight?: number;
+    /** "columns" layout: horizontal gap between columns in px. Leave room for edge label pills. */
+    columnGap?: number;
+    /** "columns" layout: vertical gap between stacked nodes in px. */
+    rowGap?: number;
+    /** Ctrl/meta + wheel (or pinch) zooms, dragging the background pans, and zoom controls appear. */
+    zoomable?: boolean;
+    /**
+     * Zoomable: the smallest scale the diagram opens at, so its text stays readable. A diagram too
+     * large for it opens overflowing, centred on `focusId`, and is panned to reach the rest. `Fit to
+     * view` still shows everything, and `Reset view` returns here. Unset, the diagram opens whole.
+     */
+    fitMinScale?: number;
+    /** Zoomable: the node an overflowing diagram opens centred on. Defaults to the diagram's centre. */
+    focusId?: string;
     maxHeight?: number | string;
     ariaLabel: string;
     className?: string;
 }
-export declare function GraphDiagram({ nodes, edges, layout, selectedId, onNodeSelect, nodeWidth, nodeHeight, maxHeight, ariaLabel, className, }: GraphDiagramProps): import("react").JSX.Element;
+export declare function GraphDiagram({ nodes, edges, layout, selectedId, onNodeSelect, onNodeExpand, selectedEdgeId, onEdgeSelect, edgeFocus, groups, nodeWidth, nodeHeight, columnGap, rowGap, zoomable, fitMinScale, focusId, maxHeight, ariaLabel, className, }: GraphDiagramProps): import("react").JSX.Element;
 //# sourceMappingURL=GraphDiagram.d.ts.map

package/dist/data/GraphDiagram.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GraphDiagram.d.ts","sourceRoot":"","sources":["../../src/data/GraphDiagram.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAUzC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAExC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,wDAAwD;IACxD,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6ED,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,KAAK,EACL,MAAe,EACf,UAAU,EACV,YAAY,EACZ,SAA8B,EAC9B,UAAgC,EAChC,SAAS,EACT,SAAS,EACT,SAAS,GACV,EAAE,iBAAiB,+BAoInB"}
+{"version":3,"file":"GraphDiagram.d.ts","sourceRoot":"","sources":["../../src/data/GraphDiagram.tsx"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EAEtB,MAAM,uBAAuB,CAAC;AAI/B,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAiB/B,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,mEAAmE;IACnE,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,qFAAqF;IACrF,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;;;OAGG;IACH,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,kGAAkG;IAClG,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+FAA+F;IAC/F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oGAAoG;IACpG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA+FD,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,KAAK,EACL,MAAe,EACf,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,SAAkB,EAClB,MAAM,EACN,SAA8B,EAC9B,UAAgC,EAChC,SAAS,EACT,MAAM,EACN,QAAgB,EAChB,WAAW,EACX,OAAO,EACP,SAAS,EACT,SAAS,EACT,SAAS,GACV,EAAE,iBAAiB,+BA2EnB"}