@vanduo-oss/vd3-flowchart 1.3.0 → 1.5.0

package/dist/index.cjs

@@ -23,6 +23,7 @@ __export(index_exports, {
   FLOWCHART_DOCUMENT_VERSION: () => FLOWCHART_DOCUMENT_VERSION,
   FLOWCHART_EDGE_MARKERS: () => FLOWCHART_EDGE_MARKERS,
   FLOWCHART_EDGE_ROUTES: () => FLOWCHART_EDGE_ROUTES,
+  FLOWCHART_KEYBOARD_SHORTCUTS: () => FLOWCHART_KEYBOARD_SHORTCUTS,
   FLOWCHART_NODE_TYPES: () => FLOWCHART_NODE_TYPES,
   FLOWCHART_PORTS: () => FLOWCHART_PORTS,
   LAYOUT_MODES: () => LAYOUT_MODES,
@@ -220,6 +221,134 @@ function computeLayout(documentData, mode = "tree", options = {}) {
 }
 var LAYOUT_MODES = ["tree", "radial", "grid"];
 
+// src/mindmap.js
+var DIRECTION_PORTS = { right: "right", left: "left", down: "bottom", up: "top" };
+var PORT_DIRECTIONS = { right: "right", left: "left", bottom: "down", top: "up" };
+var OPPOSITE_DIRECTIONS = { right: "left", left: "right", down: "up", up: "down" };
+var DIRECTION_VECTORS = {
+  right: { x: 1, y: 0 },
+  left: { x: -1, y: 0 },
+  down: { x: 0, y: 1 },
+  up: { x: 0, y: -1 }
+};
+var BRANCH_GAP = 72;
+var SIBLING_GAP = 24;
+var COLLISION_GAP = 12;
+var COLLISION_STEP = 12;
+var MAX_COLLISION_STEPS = 400;
+var BRANCH_RING_STEP = 48;
+var MAX_BRANCH_RINGS = 8;
+var NAVIGATION_CONE = Math.tan(Math.PI / 3);
+function centerOf(node) {
+  return { x: node.x + node.width / 2, y: node.y + node.height / 2 };
+}
+function oppositeDirection(direction) {
+  return OPPOSITE_DIRECTIONS[direction] || "left";
+}
+function findSpatialNeighbor(nodes, fromNode, direction) {
+  const vector = DIRECTION_VECTORS[direction];
+  if (!vector || !fromNode) return null;
+  const origin = centerOf(fromNode);
+  let bestCone = null;
+  let bestPlane = null;
+  nodes.forEach((node) => {
+    if (node.id === fromNode.id) return;
+    const center = centerOf(node);
+    const dx = center.x - origin.x;
+    const dy = center.y - origin.y;
+    const along = dx * vector.x + dy * vector.y;
+    if (along <= 0) return;
+    const across = Math.abs(dx * vector.y - dy * vector.x);
+    const score = along + across * 2;
+    if (across <= along * NAVIGATION_CONE && (!bestCone || score < bestCone.score)) {
+      bestCone = { node, score };
+    }
+    if (!bestPlane || score < bestPlane.score) bestPlane = { node, score };
+  });
+  return (bestCone || bestPlane)?.node ?? null;
+}
+function findNearestNode(nodes, point) {
+  let best = null;
+  nodes.forEach((node) => {
+    const center = centerOf(node);
+    const distance = Math.hypot(center.x - point.x, center.y - point.y);
+    if (!best || distance < best.distance) best = { node, distance };
+  });
+  return best?.node ?? null;
+}
+function overlapsAny(rect, nodes) {
+  return nodes.some(
+    (node) => rect.x < node.x + node.width + COLLISION_GAP && rect.x + rect.width + COLLISION_GAP > node.x && rect.y < node.y + node.height + COLLISION_GAP && rect.y + rect.height + COLLISION_GAP > node.y
+  );
+}
+function placeBranchNode({
+  nodes,
+  parent,
+  siblings = [],
+  direction,
+  size,
+  anchor = null,
+  before = false
+}) {
+  const horizontal = direction === "right" || direction === "left";
+  const cross = horizontal ? "y" : "x";
+  const crossSize = horizontal ? "height" : "width";
+  const lastSibling = siblings.reduce(
+    (last, node) => !last || node[cross] + node[crossSize] > last[cross] + last[crossSize] ? node : last,
+    null
+  );
+  const reference = anchor || lastSibling;
+  const rect = { x: 0, y: 0, width: size.width, height: size.height };
+  if (reference) {
+    if (direction === "right") rect.x = reference.x;
+    if (direction === "left") rect.x = reference.x + reference.width - size.width;
+    if (direction === "down") rect.y = reference.y;
+    if (direction === "up") rect.y = reference.y + reference.height - size.height;
+    rect[cross] = before ? reference[cross] - SIBLING_GAP - size[crossSize] : reference[cross] + reference[crossSize] + SIBLING_GAP;
+  } else {
+    if (direction === "right") rect.x = parent.x + parent.width + BRANCH_GAP;
+    if (direction === "left") rect.x = parent.x - BRANCH_GAP - size.width;
+    if (direction === "down") rect.y = parent.y + parent.height + BRANCH_GAP;
+    if (direction === "up") rect.y = parent.y - BRANCH_GAP - size.height;
+    rect[cross] = parent[cross] + parent[crossSize] / 2 - size[crossSize] / 2;
+  }
+  const crossSign = reference ? before ? -1 : 1 : 0;
+  const result = nearestFreeSlot(
+    rect,
+    nodes,
+    cross,
+    horizontal ? "x" : "y",
+    DIRECTION_VECTORS[direction],
+    crossSign
+  );
+  return { x: Math.round(result.x * 100) / 100, y: Math.round(result.y * 100) / 100 };
+}
+function crossOffsetAt(index, crossSign) {
+  if (crossSign) return crossSign * COLLISION_STEP * index;
+  return COLLISION_STEP * Math.ceil(index / 2) * (index % 2 ? 1 : -1);
+}
+function nearestFreeSlot(rect, nodes, cross, main, vector, crossSign) {
+  const origin = { ...rect };
+  const outward = vector.x + vector.y;
+  let best = null;
+  for (let ring = 0; ring <= MAX_BRANCH_RINGS; ring += 1) {
+    const mainOffset = ring * BRANCH_RING_STEP;
+    if (best && mainOffset >= best.cost) break;
+    const candidate = { ...origin, [main]: origin[main] + outward * mainOffset };
+    for (let index = 0; index <= MAX_COLLISION_STEPS; index += 1) {
+      const crossOffset = crossOffsetAt(index, crossSign);
+      const cost = Math.hypot(mainOffset, crossOffset);
+      if (best && cost >= best.cost) break;
+      candidate[cross] = origin[cross] + crossOffset;
+      if (!overlapsAny(candidate, nodes)) {
+        best = { rect: { ...candidate }, cost };
+        break;
+      }
+    }
+  }
+  return best ? best.rect : origin;
+}
+
 // src/core.js
 var SVG_NS = "http://www.w3.org/2000/svg";
 var TOOLBAR_ICON_PATHS = {
@@ -229,6 +358,7 @@ var TOOLBAR_ICON_PATHS = {
   "fit-view": "M216,48V88a8,8,0,0,1-16,0V67.31l-42.34,42.35a8,8,0,0,1-11.32-11.32L188.69,56H168a8,8,0,0,1,0-16h40A8,8,0,0,1,216,48ZM98.34,146.34,56,188.69V168a8,8,0,0,0-16,0v40a8,8,0,0,0,8,8H88a8,8,0,0,0,0-16H67.31l42.35-42.34a8,8,0,0,0-11.32-11.32Zm11.32-36.68L67.31,56H88a8,8,0,0,0,0-16H48a8,8,0,0,0-8,8V88a8,8,0,0,0,16,0V67.31l42.34,42.35a8,8,0,0,0,11.32-11.32ZM208,160a8,8,0,0,0-8,8v20.69l-42.34-42.35a8,8,0,0,0-11.32,11.32L188.69,200H168a8,8,0,0,0,0,16h40a8,8,0,0,0,8-8V168A8,8,0,0,0,208,160Z",
   undo: "M224,128a96,96,0,0,1-94.71,96H128A95.38,95.38,0,0,1,62.1,197.8a8,8,0,0,1,11-11.63A80,80,0,1,0,71.43,71.39a3.07,3.07,0,0,1-.26.25L44.59,96H72a8,8,0,0,1,0,16H24a8,8,0,0,1-8-8V56a8,8,0,0,1,16,0V85.8L60.25,60A96,96,0,0,1,224,128Z",
   redo: "M240,56v48a8,8,0,0,1-8,8H184a8,8,0,0,1,0-16H211.4L184.81,71.64l-.25-.24a80,80,0,1,0-1.67,114.78,8,8,0,0,1,11,11.63A95.44,95.44,0,0,1,128,224h-1.32A96,96,0,1,1,195.75,60L224,85.8V56a8,8,0,1,1,16,0Z",
+  minimap: "M228.92,49.69a8,8,0,0,0-6.86-1.45L160.93,63.52,99.58,32.84a8,8,0,0,0-5.52-.6l-64,16A8,8,0,0,0,24,56V200a8,8,0,0,0,9.94,7.76l61.13-15.28,61.35,30.68A8.15,8.15,0,0,0,160,224a8,8,0,0,0,1.94-.24l64-16A8,8,0,0,0,232,200V56A8,8,0,0,0,228.92,49.69ZM104,52.94l48,24V203.06l-48-24ZM40,62.25l48-12v127.5l-48,12Zm176,131.5-48,12V78.25l48-12Z",
   clear: "M216,48H176V40a24,24,0,0,0-24-24H104A24,24,0,0,0,80,40v8H40a8,8,0,0,0,0,16h8V208a16,16,0,0,0,16,16H192a16,16,0,0,0,16-16V64h8a8,8,0,0,0,0-16ZM96,40a8,8,0,0,1,8-8h48a8,8,0,0,1,8,8v8H96Zm96,168H64V64H192ZM112,104v64a8,8,0,0,1-16,0V104a8,8,0,0,1,16,0Zm48,0v64a8,8,0,0,1-16,0V104a8,8,0,0,1,16,0Z"
 };
 var TOOLBAR_ACTIONS = [
@@ -268,11 +398,12 @@ function createToolbarButton({ action, label, icon, disabled = false }) {
   return button;
 }
 var DEFAULT_GRID_SIZE = 24;
-var MIN_SCALE = 0.35;
-var MAX_SCALE = 3;
-var MIN_NODE_SIZE = 56;
-var MAX_NODE_SIZE = 420;
-var WORLD_EXTENT = 12e3;
+var DEFAULT_MIN_SCALE = 0.35;
+var DEFAULT_MAX_SCALE = 3;
+var DEFAULT_MIN_NODE_SIZE = 56;
+var DEFAULT_MAX_NODE_SIZE = 420;
+var DEFAULT_WORLD_EXTENT = 12e3;
+var WIDE_WORLD_EXTENT = 24e4;
 var MAX_NODES = 1e4;
 var MAX_EDGES = 1e4;
 var RESIZE_HANDLES = ["n", "ne", "e", "se", "s", "sw", "w", "nw"];
@@ -280,21 +411,32 @@ var DEFAULT_EDGE_STROKE_WIDTH = 2.25;
 var MIN_EDGE_STROKE_WIDTH = 1.25;
 var MAX_EDGE_STROKE_WIDTH = 6;
 var CONNECTION_PORT_RADIUS = 6;
+var PORT_HANDLE_OFFSET = 12;
 var CONNECTION_PORT_HIT_RADIUS = 14;
+var PORT_CLICK_SLOP = 4;
+var RESIZE_HANDLE_SIZE = 9;
+var SELECTION_OUTSET = 4;
+var GUIDE_SNAP_DISTANCE = 6;
+var GUIDE_OVERHANG = 12;
+var COLLAPSE_TOGGLE_OFFSET = 36;
+var MINIMAP_WIDTH = 180;
+var MINIMAP_HEIGHT = 120;
+var MINIMAP_MIN_CANVAS_WIDTH = 480;
+var SELECTION_BOX_TYPES = /* @__PURE__ */ new Set(["circle", "diamond", "label"]);
 var RECONNECT_ENDPOINT_RADIUS = 7;
 var RECONNECT_ENDPOINT_HIT_RADIUS = 12;
 var EDGE_HIT_STROKE_MIN = 16;
 var CONNECTION_SNAP_PADDING = 36;
 var CONNECTION_HYSTERESIS = 16;
 var CONNECTION_CENTER_LOCK_RADIUS = 18;
-var RESIZE_PORT_GAP = 34;
+var RESIZE_PORT_GAP = 28;
 var EDGE_STROKE_PRESETS = [
   { id: "thin", label: "Thin", width: 1.75 },
   { id: "medium", label: "Medium", width: DEFAULT_EDGE_STROKE_WIDTH },
   { id: "bold", label: "Bold", width: 3.5 }
 ];
-var VD_FLOWCHART_VERSION = "1.3.0";
-var FLOWCHART_DOCUMENT_VERSION = "1.2.0";
+var VD_FLOWCHART_VERSION = "1.5.0";
+var FLOWCHART_DOCUMENT_VERSION = "1.3.0";
 var FLOWCHART_NODE_TYPES = [
   "rounded-rect",
   "rect",
@@ -307,7 +449,65 @@ var FLOWCHART_NODE_TYPES = [
 var FLOWCHART_PORTS = ["top", "right", "bottom", "left"];
 var FLOWCHART_EDGE_MARKERS = ["none", "arrow", "dot"];
 var FLOWCHART_EDGE_ROUTES = ["curve", "straight", "orthogonal"];
-var COALESCING_REASONS = /* @__PURE__ */ new Set(["node:update", "edge:update"]);
+var FLOWCHART_KEYBOARD_SHORTCUTS = ["mindmap", "basic"];
+function normalizeKeyboardShortcuts(value) {
+  return value === "basic" ? "basic" : "mindmap";
+}
+var ARROW_DIRECTIONS = {
+  ArrowRight: "right",
+  ArrowLeft: "left",
+  ArrowDown: "down",
+  ArrowUp: "up"
+};
+function getShortcutRows(mode, readonly) {
+  const navigation = [
+    ["Arrow keys", "Select the nearest node in that direction"],
+    ["Shift + Arrow", "Select a connection on that side (repeat to cycle)"],
+    ["Shift + click, Shift + drag", "Add nodes to the selection, or select with a box"],
+    ["Cmd/Ctrl + A", "Select all nodes"]
+  ];
+  const view = [
+    ["Cmd/Ctrl + = or -", "Zoom in or out"],
+    ["Cmd/Ctrl + 0", "Zoom to 100%"],
+    ["Shift + 1", "Fit the diagram to the view"]
+  ];
+  const help = [["?", "Show or hide this list"]];
+  if (readonly) {
+    return [...navigation, ...view, ...help, ["Tab", "Leave the canvas"]];
+  }
+  const mindmap = mode === "mindmap" ? [
+    ["Tab", "Add a child node"],
+    ["Enter", "Add a sibling below (Shift + Enter: above)"],
+    ["F2, Space, or type", "Edit the label"],
+    ["Enter while editing", "Save the label (Shift + Enter: new line)"],
+    ["Tab while editing", "Save and add a child"]
+  ] : [
+    ["Enter or F2", "Edit the label"],
+    ["Cmd/Ctrl + Enter", "Save the label"]
+  ];
+  return [
+    ...navigation,
+    ...mindmap,
+    [
+      mode === "mindmap" ? "Enter, F2, or type on a connection" : "Enter or F2 on a connection",
+      "Edit the connection label"
+    ],
+    ["Cmd/Ctrl + /", "Collapse or expand the branch"],
+    ["Alt + Arrow", "Nudge the node (add Shift for 1 px)"],
+    ["Delete or Backspace", "Delete the selection"],
+    ["Cmd/Ctrl + D", "Duplicate the node"],
+    ["Cmd/Ctrl + Z, Shift + Cmd/Ctrl + Z", "Undo, redo"],
+    ["Cmd/Ctrl + C, X, V", "Copy, cut, paste"],
+    ...view,
+    ["Esc", "Cancel editing, then the tool, then deselect"],
+    [
+      mode === "mindmap" ? "Shift + Tab, or Esc then Tab" : "Tab or Shift + Tab",
+      "Leave the canvas"
+    ],
+    ...help
+  ];
+}
+var COALESCING_REASONS = /* @__PURE__ */ new Set(["node:update", "edge:update", "node:nudge"]);
 var DEFAULT_EDGE_ROUTE = "curve";
 var ORTHOGONAL_STUB_LENGTH = 32;
 var ORTHOGONAL_CORNER_RADIUS = 12;
@@ -376,6 +576,17 @@ function deepClone(value) {
 function formatNumber(value) {
   return Number(value.toFixed(2));
 }
+function formatScale(value) {
+  return Number(toFiniteNumber(value, 1).toFixed(4));
+}
+function normalizeBoundPair(min, max, fallbackMin, fallbackMax) {
+  const low = Number(min);
+  const high = Number(max);
+  if (!Number.isFinite(low) || !Number.isFinite(high) || low <= 0 || high <= 0 || low >= high) {
+    return { min: fallbackMin, max: fallbackMax };
+  }
+  return { min: low, max: high };
+}
 function sanitizeId(value) {
   if (value == null) return "";
   return String(value).trim();
@@ -433,21 +644,36 @@ function normalizeNodeType(type) {
 function getNodeSpec(type) {
   return DEFAULT_NODE_SPECS[normalizeNodeType(type)];
 }
-function getNodeSizeBounds(type) {
+function nodeVisualScale(node) {
+  if (!node || node.type === "junction") return 1;
+  const spec = getNodeSpec(node.type);
+  const width = spec.width > 0 ? toFiniteNumber(node.width, spec.width) / spec.width : 1;
+  const height = spec.height > 0 ? toFiniteNumber(node.height, spec.height) / spec.height : 1;
+  return clamp(Math.min(1, width, height), 0.01, 1);
+}
+function edgeVisualScale(fromNode, toNode) {
+  if (fromNode && toNode) return Math.min(nodeVisualScale(fromNode), nodeVisualScale(toNode));
+  if (fromNode) return nodeVisualScale(fromNode);
+  if (toNode) return nodeVisualScale(toNode);
+  return 1;
+}
+function getNodeSizeBounds(type, sizeBounds) {
   const spec = getNodeSpec(type);
+  const min = sizeBounds?.min ?? DEFAULT_MIN_NODE_SIZE;
+  const max = sizeBounds?.max ?? DEFAULT_MAX_NODE_SIZE;
   return {
-    minWidth: spec.minWidth ?? MIN_NODE_SIZE,
-    minHeight: spec.minHeight ?? MIN_NODE_SIZE,
-    maxWidth: spec.maxWidth ?? MAX_NODE_SIZE,
-    maxHeight: spec.maxHeight ?? MAX_NODE_SIZE
+    minWidth: spec.minWidth ?? min,
+    minHeight: spec.minHeight ?? min,
+    maxWidth: spec.maxWidth ?? max,
+    maxHeight: spec.maxHeight ?? max
   };
 }
-function clampNodeWidth(type, width, fallback) {
-  const bounds = getNodeSizeBounds(type);
+function clampNodeWidth(type, width, fallback, sizeBounds) {
+  const bounds = getNodeSizeBounds(type, sizeBounds);
   return clamp(toFiniteNumber(width, fallback), bounds.minWidth, bounds.maxWidth);
 }
-function clampNodeHeight(type, height, fallback) {
-  const bounds = getNodeSizeBounds(type);
+function clampNodeHeight(type, height, fallback, sizeBounds) {
+  const bounds = getNodeSizeBounds(type, sizeBounds);
   return clamp(toFiniteNumber(height, fallback), bounds.minHeight, bounds.maxHeight);
 }
 function isNodeResizable(nodeOrType) {
@@ -471,26 +697,59 @@ function getStrokePresetWidth(presetId) {
   const preset = EDGE_STROKE_PRESETS.find((item) => item.id === presetId);
   return preset?.width ?? DEFAULT_EDGE_STROKE_WIDTH;
 }
-function normalizeViewport(viewport) {
+function normalizeViewport(viewport, scaleBounds) {
+  const min = scaleBounds?.min ?? DEFAULT_MIN_SCALE;
+  const max = scaleBounds?.max ?? DEFAULT_MAX_SCALE;
   return {
     x: toFiniteNumber(viewport?.x, 0),
     y: toFiniteNumber(viewport?.y, 0),
-    scale: clamp(toFiniteNumber(viewport?.scale, 1), MIN_SCALE, MAX_SCALE)
+    scale: clamp(formatScale(toFiniteNumber(viewport?.scale, 1)), min, max)
   };
 }
-function normalizeNode(rawNode, index, usedIds) {
+function normalizeNode(rawNode, index, usedIds, sizeBounds) {
   const type = normalizeNodeType(rawNode?.type);
   const spec = getNodeSpec(type);
-  return {
+  const node = {
     id: ensureUniqueId(rawNode?.id, "node", usedIds),
     type,
     x: toFiniteNumber(rawNode?.x, index * 28),
     y: toFiniteNumber(rawNode?.y, index * 18),
-    width: clampNodeWidth(type, rawNode?.width, spec.width),
-    height: clampNodeHeight(type, rawNode?.height, spec.height),
+    width: clampNodeWidth(type, rawNode?.width, spec.width, sizeBounds),
+    height: clampNodeHeight(type, rawNode?.height, spec.height, sizeBounds),
     text: rawNode?.text == null ? spec.text : String(rawNode.text),
     data: isPlainObject(rawNode?.data) ? deepClone(rawNode.data) : {}
   };
+  if (rawNode?.collapsed === true) node.collapsed = true;
+  return node;
+}
+function computeHiddenNodeIds(nodes, edges) {
+  const collapsed = new Set(nodes.filter((node) => node.collapsed).map((node) => node.id));
+  if (!collapsed.size) return /* @__PURE__ */ new Set();
+  const outgoing = new Map(nodes.map((node) => [node.id, []]));
+  edges.forEach((edge) => {
+    if (edge.from.nodeId === edge.to.nodeId) return;
+    outgoing.get(edge.from.nodeId)?.push(edge.to.nodeId);
+  });
+  const candidates = /* @__PURE__ */ new Set();
+  collapsed.forEach((rootId) => {
+    const queue2 = [...outgoing.get(rootId) || []];
+    for (let index = 0; index < queue2.length; index += 1) {
+      const id = queue2[index];
+      if (id === rootId || candidates.has(id)) continue;
+      candidates.add(id);
+      queue2.push(...outgoing.get(id) || []);
+    }
+  });
+  const queue = nodes.filter((node) => !candidates.has(node.id) && !collapsed.has(node.id)).map((node) => node.id);
+  for (let index = 0; index < queue.length; index += 1) {
+    const id = queue[index];
+    (outgoing.get(id) || []).forEach((childId) => {
+      if (!candidates.has(childId)) return;
+      candidates.delete(childId);
+      if (!collapsed.has(childId)) queue.push(childId);
+    });
+  }
+  return candidates;
 }
 function normalizeEndpoint(rawEndpoint, fallbackPort) {
   return {
@@ -549,7 +808,7 @@ function isSupportedDocumentVersion(value) {
   if (parsed.minor === max.minor && parsed.patch > max.patch) return false;
   return true;
 }
-function normalizeDocument(input) {
+function normalizeDocument(input, limits = {}) {
   let source = input;
   if (typeof source === "string") {
     try {
@@ -572,13 +831,13 @@ function normalizeDocument(input) {
     }
   }
   const usedNodeIds = /* @__PURE__ */ new Set();
-  const nodes = (Array.isArray(source.nodes) ? source.nodes : []).slice(0, MAX_NODES).map((node, index) => normalizeNode(node, index, usedNodeIds));
+  const nodes = (Array.isArray(source.nodes) ? source.nodes : []).slice(0, MAX_NODES).map((node, index) => normalizeNode(node, index, usedNodeIds, limits.sizeBounds));
   const nodeIds = new Set(nodes.map((node) => node.id));
   const usedEdgeIds = /* @__PURE__ */ new Set();
   const edges = (Array.isArray(source.edges) ? source.edges : []).slice(0, MAX_EDGES).map((edge, index) => normalizeEdge(edge, index, nodeIds, usedEdgeIds)).filter(Boolean);
   return {
     version: FLOWCHART_DOCUMENT_VERSION,
-    viewport: normalizeViewport(source.viewport),
+    viewport: normalizeViewport(source.viewport, limits.scaleBounds),
     nodes,
     edges
   };
@@ -643,6 +902,15 @@ function getPortPosition(node, port) {
       return { x: node.x, y: node.y + node.height / 2 };
   }
 }
+function getPortHandlePosition(node, port, scale = 1) {
+  const point = getPortPosition(node, port);
+  const normal = getPortNormal(port);
+  const offset = PORT_HANDLE_OFFSET / scale;
+  return {
+    x: formatNumber(point.x + normal.x * offset),
+    y: formatNumber(point.y + normal.y * offset)
+  };
+}
 function getNearestPort(node, point) {
   return FLOWCHART_PORTS.reduce((best, port) => {
     const portPoint = getPortPosition(node, port);
@@ -786,19 +1054,30 @@ function getPolylineLabelPoint(points) {
   const last = points[points.length - 1] || { x: 0, y: 0 };
   return { x: formatNumber(last.x), y: formatNumber(last.y) };
 }
-function curveControlPoint(point, port, target, curvature) {
+function routeMetrics(edgeScale = 1) {
+  const scale = clamp(toFiniteNumber(edgeScale, 1), 0.01, 1);
+  return {
+    scale,
+    minCurveArm: MIN_CURVE_ARM * scale,
+    maxCurveArm: MAX_CURVE_ARM * scale,
+    stub: ORTHOGONAL_STUB_LENGTH * scale,
+    corner: ORTHOGONAL_CORNER_RADIUS * scale,
+    clearance: ORTHOGONAL_CLEARANCE * scale
+  };
+}
+function curveControlPoint(point, port, target, curvature, metrics = routeMetrics(1)) {
   const normal = getPortNormal(port);
   const dx = target.x - point.x;
   const dy = target.y - point.y;
   const distance = Math.hypot(dx, dy) || 1;
   const align = (normal.x * dx + normal.y * dy) / distance;
   const ease = 0.55 + 0.45 * align;
-  const arm = clamp(distance * curvature * ease, MIN_CURVE_ARM, MAX_CURVE_ARM);
+  const arm = clamp(distance * curvature * ease, metrics.minCurveArm, metrics.maxCurveArm);
   return { x: point.x + normal.x * arm, y: point.y + normal.y * arm };
 }
-function buildCurvePath(fromPoint, toPoint, fromPort = "right", toPort = "left") {
-  const controlA = curveControlPoint(fromPoint, fromPort, toPoint, EDGE_CURVATURE);
-  const controlB = curveControlPoint(toPoint, toPort, fromPoint, EDGE_CURVATURE);
+function buildCurvePath(fromPoint, toPoint, fromPort = "right", toPort = "left", metrics = routeMetrics(1)) {
+  const controlA = curveControlPoint(fromPoint, fromPort, toPoint, EDGE_CURVATURE, metrics);
+  const controlB = curveControlPoint(toPoint, toPort, fromPoint, EDGE_CURVATURE, metrics);
   const labelX = 0.125 * fromPoint.x + 0.375 * controlA.x + 0.375 * controlB.x + 0.125 * toPoint.x;
   const labelY = 0.125 * fromPoint.y + 0.375 * controlA.y + 0.375 * controlB.y + 0.125 * toPoint.y;
   return {
@@ -860,11 +1139,11 @@ function getOrthogonalMidpoints(fromStub, toStub, fromPort, toPort) {
   }
   return [{ x: fromStub.x, y: toStub.y }];
 }
-function getOrthogonalPoints(fromPoint, toPoint, fromPort, toPort, fromRect, toRect) {
+function getOrthogonalPoints(fromPoint, toPoint, fromPort, toPort, fromRect, toRect, metrics = routeMetrics(1)) {
   const fromNormal = getPortNormal(fromPort);
   const toNormal = getPortNormal(toPort);
-  const fromStub = offsetPoint(fromPoint, fromNormal, ORTHOGONAL_STUB_LENGTH);
-  const toStub = offsetPoint(toPoint, toNormal, ORTHOGONAL_STUB_LENGTH);
+  const fromStub = offsetPoint(fromPoint, fromNormal, metrics.stub);
+  const toStub = offsetPoint(toPoint, toNormal, metrics.stub);
   const sourceHorizontal = isHorizontalPort(fromPort);
   const targetHorizontal = isHorizontalPort(toPort);
   const mids = [];
@@ -904,13 +1183,13 @@ function getOrthogonalPoints(fromPoint, toPoint, fromPort, toPort, fromRect, toR
   );
   return points;
 }
-function buildOrthogonalPath(fromPoint, toPoint, fromPort = "right", toPort = "left", fromRect = null, toRect = null) {
+function buildOrthogonalPath(fromPoint, toPoint, fromPort = "right", toPort = "left", fromRect = null, toRect = null, metrics = routeMetrics(1)) {
   let points;
   if (fromRect && toRect) {
-    points = getOrthogonalPoints(fromPoint, toPoint, fromPort, toPort, fromRect, toRect);
+    points = getOrthogonalPoints(fromPoint, toPoint, fromPort, toPort, fromRect, toRect, metrics);
   } else {
-    const fromStub = offsetPoint(fromPoint, getPortNormal(fromPort), ORTHOGONAL_STUB_LENGTH);
-    const toStub = offsetPoint(toPoint, getPortNormal(toPort), ORTHOGONAL_STUB_LENGTH);
+    const fromStub = offsetPoint(fromPoint, getPortNormal(fromPort), metrics.stub);
+    const toStub = offsetPoint(toPoint, getPortNormal(toPort), metrics.stub);
     points = [];
     [
       fromPoint,
@@ -922,7 +1201,7 @@ function buildOrthogonalPath(fromPoint, toPoint, fromPort = "right", toPort = "l
   }
   const label = getPolylineLabelPoint(points);
   return {
-    d: buildRoundedPath(points, ORTHOGONAL_CORNER_RADIUS),
+    d: buildRoundedPath(points, metrics.corner),
     labelX: label.x,
     labelY: label.y
   };
@@ -933,6 +1212,7 @@ function buildEdgePath(edge, fromNode = null, toNode = null) {
   const fromPoint = edge?.fromPoint || (fromNode ? getPortPosition(fromNode, fromPort) : null);
   const toPoint = edge?.toPoint || (toNode ? getPortPosition(toNode, toPort) : null);
   const route = normalizeEdgeRoute(edge?.route);
+  const metrics = routeMetrics(edgeVisualScale(fromNode, toNode));
   if (!fromPoint || !toPoint) {
     return { d: "", labelX: 0, labelY: 0 };
   }
@@ -940,15 +1220,17 @@ function buildEdgePath(edge, fromNode = null, toNode = null) {
     return buildStraightPath(fromPoint, toPoint);
   }
   if (route === "orthogonal") {
-    const fromRect = !edge?.fromPoint && fromNode ? getNodeRectBounds(fromNode, ORTHOGONAL_CLEARANCE) : null;
-    const toRect = !edge?.toPoint && toNode ? getNodeRectBounds(toNode, ORTHOGONAL_CLEARANCE) : null;
-    return buildOrthogonalPath(fromPoint, toPoint, fromPort, toPort, fromRect, toRect);
+    const fromRect = !edge?.fromPoint && fromNode ? getNodeRectBounds(fromNode, metrics.clearance) : null;
+    const toRect = !edge?.toPoint && toNode ? getNodeRectBounds(toNode, metrics.clearance) : null;
+    return buildOrthogonalPath(fromPoint, toPoint, fromPort, toPort, fromRect, toRect, metrics);
   }
-  return buildCurvePath(fromPoint, toPoint, fromPort, toPort);
+  return buildCurvePath(fromPoint, toPoint, fromPort, toPort, metrics);
 }
-function createArrowMarker(id, strokeWidth, reversed = false) {
-  const size = formatNumber(Math.max(9, strokeWidth * 4.4));
-  const refInset = formatNumber(Math.max(1.5, strokeWidth * 0.85));
+function createArrowMarker(id, strokeWidth, reversed = false, edgeScale = 1) {
+  const scale = clamp(toFiniteNumber(edgeScale, 1), 0.01, 1);
+  const effective = Math.max(0.02, strokeWidth * scale);
+  const size = formatNumber(Math.max(9 * scale, effective * 4.4));
+  const refInset = formatNumber(Math.max(1.5 * scale, effective * 0.85));
   const marker = svgEl("marker", {
     id,
     markerWidth: size,
@@ -966,9 +1248,11 @@ function createArrowMarker(id, strokeWidth, reversed = false) {
   );
   return marker;
 }
-function createDotMarker(id, strokeWidth) {
-  const size = formatNumber(Math.max(8, strokeWidth * 3.3));
-  const radius = formatNumber(Math.max(2.75, strokeWidth * 1.45));
+function createDotMarker(id, strokeWidth, edgeScale = 1) {
+  const scale = clamp(toFiniteNumber(edgeScale, 1), 0.01, 1);
+  const effective = Math.max(0.02, strokeWidth * scale);
+  const size = formatNumber(Math.max(8 * scale, effective * 3.3));
+  const radius = formatNumber(Math.max(2.75 * scale, effective * 1.45));
   const marker = svgEl("marker", {
     id,
     markerWidth: size,
@@ -1010,6 +1294,68 @@ function getResizeCursor(handle) {
   if (handle === "ne" || handle === "sw") return "nesw-resize";
   return "nwse-resize";
 }
+function collectGuideLines(nodes) {
+  const x = [];
+  const y = [];
+  nodes.forEach((node) => {
+    const right = node.x + node.width;
+    const bottom = node.y + node.height;
+    [node.x, node.x + node.width / 2, right].forEach(
+      (value) => x.push({ value, start: node.y, end: bottom })
+    );
+    [node.y, node.y + node.height / 2, bottom].forEach(
+      (value) => y.push({ value, start: node.x, end: right })
+    );
+  });
+  const byValue = (a, b) => a.value - b.value;
+  return { x: x.sort(byValue), y: y.sort(byValue) };
+}
+function lowerBound(lines, value) {
+  let low = 0;
+  let high = lines.length;
+  while (low < high) {
+    const middle = low + high >> 1;
+    if (lines[middle].value < value) low = middle + 1;
+    else high = middle;
+  }
+  return low;
+}
+function snapToGuides(lines, candidates, threshold) {
+  let best = null;
+  candidates.forEach((candidate) => {
+    const index = lowerBound(lines, candidate);
+    [lines[index - 1], lines[index]].forEach((line) => {
+      if (!line) return;
+      const offset = line.value - candidate;
+      if (Math.abs(offset) <= threshold && (!best || Math.abs(offset) < Math.abs(best.offset))) {
+        best = { offset };
+      }
+    });
+  });
+  if (!best) return null;
+  const positions = candidates.map((candidate) => candidate + best.offset);
+  best.lines = lines.filter(
+    (line) => positions.some((position) => Math.abs(line.value - position) < 0.5)
+  );
+  return best;
+}
+function guideSegments(axis, lines, box) {
+  const byValue = /* @__PURE__ */ new Map();
+  lines.forEach((line) => {
+    const current = byValue.get(line.value);
+    byValue.set(line.value, {
+      start: Math.min(current?.start ?? Infinity, line.start),
+      end: Math.max(current?.end ?? -Infinity, line.end)
+    });
+  });
+  const boxStart = axis === "x" ? box.top : box.left;
+  const boxEnd = boxStart + (axis === "x" ? box.height : box.width);
+  return [...byValue].map(([value, extent]) => {
+    const start = Math.min(extent.start, boxStart) - GUIDE_OVERHANG;
+    const end = Math.max(extent.end, boxEnd) + GUIDE_OVERHANG;
+    return axis === "x" ? { x1: value, y1: start, x2: value, y2: end } : { x1: start, y1: value, x2: end, y2: value };
+  });
+}
 function getBounds(nodes) {
   if (!nodes.length) {
     return { left: 0, top: 0, right: 0, bottom: 0 };
@@ -1163,9 +1509,26 @@ var VdFlowchart = class {
     this.element = resolveElement(options.element || options.target);
     this.readonly = Boolean(options.readonly);
     this.gridSize = clamp(toFiniteNumber(options.gridSize, DEFAULT_GRID_SIZE), 12, 64);
-    this.documentData = normalizeDocument(options.data || {});
+    const scaleBounds = normalizeBoundPair(
+      options.minScale,
+      options.maxScale,
+      DEFAULT_MIN_SCALE,
+      DEFAULT_MAX_SCALE
+    );
+    const sizeBounds = normalizeBoundPair(
+      options.minNodeSize,
+      options.maxNodeSize,
+      DEFAULT_MIN_NODE_SIZE,
+      DEFAULT_MAX_NODE_SIZE
+    );
+    this.minScale = scaleBounds.min;
+    this.maxScale = scaleBounds.max;
+    this.minNodeSize = sizeBounds.min;
+    this.maxNodeSize = sizeBounds.max;
+    this.documentData = normalizeDocument(options.data || {}, { scaleBounds, sizeBounds });
     this.listeners = {};
     this.selection = null;
+    this.selectedNodeIds = /* @__PURE__ */ new Set();
     this.interaction = null;
     this.activeTool = null;
     this.layoutMode = "tree";
@@ -1173,6 +1536,7 @@ var VdFlowchart = class {
     this.destroyed = false;
     this.lastNodePointer = null;
     this.reconnectEdgeId = null;
+    this.edgeCycleAnchor = null;
     this.clipboard = null;
     this.gridPatternId = nextId("flowchart-grid");
     this.markerIds = /* @__PURE__ */ new Map();
@@ -1182,6 +1546,16 @@ var VdFlowchart = class {
     this.history = [];
     this.historyIndex = -1;
     this.isApplyingHistory = false;
+    this.historyBatchDepth = 0;
+    this.historyBatchDirty = false;
+    this.coalesceInsertedText = false;
+    this.keyboardShortcuts = normalizeKeyboardShortcuts(options.keyboardShortcuts);
+    this.snapGuides = options.snapGuides !== false;
+    this.minimapEnabled = options.minimap !== false;
+    this.autoLayout = Boolean(options.autoLayout);
+    this.minimapFrame = 0;
+    this.minimapDrag = null;
+    this.shortcutsHelpOpen = false;
     this.autoFit = Boolean(options.autoFit);
     this.readyEmitted = false;
     this.resizeObserver = null;
@@ -1222,6 +1596,7 @@ var VdFlowchart = class {
       if (!ready) return false;
       this.readyEmitted = true;
       if (this.autoFit) this.fitView();
+      else this.scheduleMinimap();
       this.emit("ready", this);
       return true;
     };
@@ -1291,8 +1666,25 @@ var VdFlowchart = class {
       className: "vd-flowchart-toolbar-label",
       text: "100%"
     });
+    this.shortcutsButton = createElement("button", {
+      className: "vd-flowchart-btn vd-flowchart-icon-btn vd-flowchart-shortcuts-btn",
+      title: "Keyboard shortcuts (?)",
+      text: "?"
+    });
+    this.shortcutsButton.setAttribute("type", "button");
+    this.shortcutsButton.setAttribute("data-flowchart-action", "shortcuts");
+    this.shortcutsButton.setAttribute("aria-label", "Keyboard shortcuts");
+    this.shortcutsButton.setAttribute("aria-expanded", "false");
+    this.minimapButton = createToolbarButton({
+      action: "minimap",
+      label: "Toggle minimap",
+      icon: "minimap"
+    });
+    this.minimapButton.setAttribute("aria-pressed", this.minimapEnabled ? "true" : "false");
     toolbarLeft.appendChild(this.arrangeSelect);
     toolbarLeft.appendChild(this.clearButton);
+    toolbarRight.appendChild(this.minimapButton);
+    toolbarRight.appendChild(this.shortcutsButton);
     toolbarRight.appendChild(this.zoomLabel);
     this.toolbar.appendChild(toolbarLeft);
     this.toolbar.appendChild(toolbarRight);
@@ -1361,23 +1753,50 @@ var VdFlowchart = class {
     this.world = svgEl("g", { class: "vd-flowchart-world" });
     this.gridRect = svgEl("rect", {
       class: "vd-flowchart-grid",
-      x: -WORLD_EXTENT / 2,
-      y: -WORLD_EXTENT / 2,
-      width: WORLD_EXTENT,
-      height: WORLD_EXTENT,
+      x: -DEFAULT_WORLD_EXTENT / 2,
+      y: -DEFAULT_WORLD_EXTENT / 2,
+      width: DEFAULT_WORLD_EXTENT,
+      height: DEFAULT_WORLD_EXTENT,
       fill: `url(#${this.gridPatternId})`
     });
     this.edgesLayer = svgEl("g", { class: "vd-flowchart-edges" });
     this.previewLayer = svgEl("g", { class: "vd-flowchart-preview" });
     this.nodesLayer = svgEl("g", { class: "vd-flowchart-nodes" });
     this.overlayLayer = svgEl("g", { class: "vd-flowchart-overlay" });
+    this.guidesLayer = svgEl("g", { class: "vd-flowchart-guides" });
     this.world.appendChild(this.gridRect);
     this.world.appendChild(this.edgesLayer);
     this.world.appendChild(this.previewLayer);
     this.world.appendChild(this.nodesLayer);
     this.world.appendChild(this.overlayLayer);
+    this.world.appendChild(this.guidesLayer);
     this.svg.appendChild(this.world);
     this.canvasEl.appendChild(this.svg);
+    this.shortcutsHelp = createElement("div", { className: "vd-flowchart-shortcuts" });
+    this.shortcutsHelp.id = nextId("flowchart-shortcuts");
+    this.shortcutsHelp.setAttribute("role", "dialog");
+    this.shortcutsHelp.setAttribute("aria-label", "Keyboard shortcuts");
+    this.shortcutsHelp.hidden = true;
+    this.shortcutsHelp.addEventListener("pointerdown", (event) => event.stopPropagation());
+    this.shortcutsHelp.addEventListener("wheel", (event) => event.stopPropagation());
+    this.shortcutsButton.setAttribute("aria-controls", this.shortcutsHelp.id);
+    this.canvasEl.appendChild(this.shortcutsHelp);
+    this.minimapEl = createElement("div", { className: "vd-flowchart-minimap" });
+    this.minimapEl.setAttribute("aria-hidden", "true");
+    this.minimapEl.hidden = true;
+    this.minimapSvg = svgEl("svg", {
+      class: "vd-flowchart-minimap-svg",
+      width: MINIMAP_WIDTH,
+      height: MINIMAP_HEIGHT,
+      viewBox: `0 0 ${MINIMAP_WIDTH} ${MINIMAP_HEIGHT}`
+    });
+    this.minimapEl.appendChild(this.minimapSvg);
+    this.minimapEl.addEventListener("pointerdown", (event) => this.handleMinimapPointer(event));
+    this.minimapEl.addEventListener("pointermove", (event) => this.handleMinimapPointer(event));
+    this.minimapEl.addEventListener("pointerup", (event) => this.endMinimapDrag(event));
+    this.minimapEl.addEventListener("pointercancel", (event) => this.endMinimapDrag(event));
+    this.minimapEl.addEventListener("wheel", (event) => event.stopPropagation());
+    this.canvasEl.appendChild(this.minimapEl);
     this.inspectorPanel = createElement("aside", {
       className: "vd-flowchart-panel vd-flowchart-panel--inspector"
     });
@@ -1485,11 +1904,15 @@ var VdFlowchart = class {
     this.graphOutline.appendChild(this.graphList);
     this.root.appendChild(this.graphOutline);
     this.canvasEl.setAttribute("role", "group");
+    this.syncCanvasLabel();
+    this.jsonTextarea.setAttribute("aria-label", "Flowchart JSON");
+  }
+  syncCanvasLabel() {
+    const keys = this.readonly || this.keyboardShortcuts === "basic" ? "Arrow keys select nodes; Enter or F2 edits a label." : "Arrow keys select nodes; Tab adds a child, Enter adds a sibling, F2 edits a label.";
     this.canvasEl.setAttribute(
       "aria-label",
-      "Diagram canvas. Arrow keys select nodes; Enter edits a label. Graph outline provides connections."
+      `Diagram canvas. ${keys} Press ? for all shortcuts. Graph outline provides connections.`
     );
-    this.jsonTextarea.setAttribute("aria-label", "Flowchart JSON");
   }
   renderGraphOutline() {
     if (!this.graphOutline) return;
@@ -1499,8 +1922,9 @@ var VdFlowchart = class {
     const selected = this.selection?.kind === "node" ? this.selection.id : null;
     this.graphStatus.textContent = selected ? `Selected: ${labels.get(selected)}. ${nodes.length} nodes, ${edges.length} connections.` : `${nodes.length} nodes, ${edges.length} connections.`;
     if (!this.graphOutline.open) return;
+    const hidden = this.getHiddenNodeIds();
     const signature = JSON.stringify([
-      nodes.map((node) => [node.id, node.text]),
+      nodes.map((node) => [node.id, node.text, Boolean(node.collapsed), hidden.has(node.id)]),
       edges.map((edge) => [edge.id, edge.from.nodeId, edge.to.nodeId, edge.label])
     ]);
     if (signature !== this.graphSignature) {
@@ -1526,8 +1950,10 @@ var VdFlowchart = class {
         const from = incoming.get(node.id);
         const relationships = [
           to.length ? `Connects to ${to.join(", ")}.` : "No outgoing connections.",
-          from.length ? `Connected from ${from.join(", ")}.` : ""
-        ];
+          from.length ? `Connected from ${from.join(", ")}.` : "",
+          node.collapsed ? "Branch collapsed." : "",
+          hidden.has(node.id) ? "Hidden in a collapsed branch." : ""
+        ].filter(Boolean);
         this.graphList.appendChild(
           createElement("li", { text: `${labels.get(node.id)}. ${relationships.join(" ")}` })
         );
@@ -1612,6 +2038,157 @@ var VdFlowchart = class {
     if (action === "undo") this.undo();
     if (action === "redo") this.redo();
     if (action === "clear" && !this.readonly) this.clear();
+    if (action === "shortcuts") this.toggleShortcutsHelp();
+    if (action === "minimap") this.setMinimapEnabled(!this.minimapEnabled);
+  }
+  setMinimapEnabled(enabled) {
+    this.minimapEnabled = Boolean(enabled);
+    this.minimapButton.setAttribute("aria-pressed", this.minimapEnabled ? "true" : "false");
+    this.drawMinimap();
+    return this;
+  }
+  scheduleMinimap() {
+    if (this.minimapFrame || !hasWindow()) return;
+    const raf = typeof requestAnimationFrame === "function" ? requestAnimationFrame : (callback) => setTimeout(callback, 16);
+    this.minimapFrame = raf(() => {
+      this.minimapFrame = 0;
+      this.drawMinimap();
+    });
+  }
+  // World-to-minimap mapping covering every visible node and the viewport.
+  getMinimapTransform() {
+    const viewport = this.documentData.viewport;
+    const width = this.canvasEl.clientWidth;
+    const height = this.canvasEl.clientHeight;
+    const view = {
+      left: -viewport.x / viewport.scale,
+      top: -viewport.y / viewport.scale,
+      right: (width - viewport.x) / viewport.scale,
+      bottom: (height - viewport.y) / viewport.scale
+    };
+    const content = getBounds(this.getVisibleNodes());
+    const left = Math.min(content.left, view.left);
+    const top = Math.min(content.top, view.top);
+    const spanX = Math.max(1, Math.max(content.right, view.right) - left);
+    const spanY = Math.max(1, Math.max(content.bottom, view.bottom) - top);
+    const padding = 8;
+    const scale = Math.min(
+      (MINIMAP_WIDTH - padding * 2) / spanX,
+      (MINIMAP_HEIGHT - padding * 2) / spanY
+    );
+    return {
+      scale,
+      offsetX: (MINIMAP_WIDTH - spanX * scale) / 2 - left * scale,
+      offsetY: (MINIMAP_HEIGHT - spanY * scale) / 2 - top * scale,
+      view
+    };
+  }
+  drawMinimap() {
+    if (this.destroyed || !this.minimapEl) return;
+    const nodes = this.getVisibleNodes();
+    const visible = this.minimapEnabled && nodes.length > 0 && this.canvasEl.clientWidth >= MINIMAP_MIN_CANVAS_WIDTH;
+    this.minimapEl.hidden = !visible;
+    if (!visible) return;
+    const transform = this.minimapDrag?.transform || this.getMinimapTransform();
+    const view = this.getMinimapTransform().view;
+    const map = (x, y) => ({
+      x: formatNumber(x * transform.scale + transform.offsetX),
+      y: formatNumber(y * transform.scale + transform.offsetY)
+    });
+    clearChildren(this.minimapSvg);
+    nodes.forEach((node) => {
+      const point = map(node.x, node.y);
+      const selected = this.isNodeSelected(node.id);
+      this.minimapSvg.appendChild(
+        svgEl("rect", {
+          class: `vd-flowchart-minimap-node${selected ? " is-selected" : ""}`,
+          x: point.x,
+          y: point.y,
+          width: formatNumber(Math.max(1.5, node.width * transform.scale)),
+          height: formatNumber(Math.max(1.5, node.height * transform.scale)),
+          rx: 1.5
+        })
+      );
+    });
+    const corner = map(view.left, view.top);
+    this.minimapSvg.appendChild(
+      svgEl("rect", {
+        class: "vd-flowchart-minimap-viewport",
+        x: corner.x,
+        y: corner.y,
+        width: formatNumber((view.right - view.left) * transform.scale),
+        height: formatNumber((view.bottom - view.top) * transform.scale)
+      })
+    );
+  }
+  // Centre the main view on the world point under the minimap pointer. The
+  // mapping is frozen for the whole drag so the map does not shift under it.
+  handleMinimapPointer(event) {
+    event.stopPropagation();
+    if (event.type === "pointerdown") {
+      if (event.button != null && event.button !== 0) return;
+      event.preventDefault();
+      this.minimapDrag = { pointerId: event.pointerId, transform: this.getMinimapTransform() };
+      try {
+        this.minimapEl.setPointerCapture?.(event.pointerId);
+      } catch {
+      }
+    }
+    if (!this.minimapDrag || this.minimapDrag.pointerId !== event.pointerId) return;
+    const rect = this.minimapEl.getBoundingClientRect();
+    const { transform } = this.minimapDrag;
+    this.centerViewOn(
+      (event.clientX - rect.left - transform.offsetX) / transform.scale,
+      (event.clientY - rect.top - transform.offsetY) / transform.scale
+    );
+  }
+  endMinimapDrag(event) {
+    event.stopPropagation();
+    if (!this.minimapDrag || this.minimapDrag.pointerId !== event.pointerId) return;
+    this.minimapDrag = null;
+    this.syncJsonTextarea();
+    this.emitViewportChange("viewport:pan");
+    this.drawMinimap();
+  }
+  centerViewOn(worldX, worldY) {
+    const viewport = this.documentData.viewport;
+    const width = this.canvasEl.clientWidth || 800;
+    const height = this.canvasEl.clientHeight || 560;
+    viewport.x = formatNumber(width / 2 - worldX * viewport.scale);
+    viewport.y = formatNumber(height / 2 - worldY * viewport.scale);
+    this.render({ inspector: false, json: false });
+    return this;
+  }
+  toggleShortcutsHelp(force) {
+    const open = typeof force === "boolean" ? force : !this.shortcutsHelpOpen;
+    this.shortcutsHelpOpen = open;
+    this.shortcutsButton.setAttribute("aria-expanded", open ? "true" : "false");
+    if (open) this.renderShortcutsHelp();
+    this.shortcutsHelp.hidden = !open;
+    if (!open && this.shortcutsHelp.contains(document.activeElement)) this.canvasEl.focus();
+    return this;
+  }
+  renderShortcutsHelp() {
+    clearChildren(this.shortcutsHelp);
+    const header = createElement("div", { className: "vd-flowchart-shortcuts-header" });
+    header.appendChild(
+      createElement("h4", { className: "vd-flowchart-panel-title", text: "Keyboard shortcuts" })
+    );
+    const close = createElement("button", {
+      className: "vd-flowchart-btn vd-flowchart-icon-btn",
+      text: "\xD7"
+    });
+    close.setAttribute("type", "button");
+    close.setAttribute("aria-label", "Close keyboard shortcuts");
+    close.addEventListener("click", () => this.toggleShortcutsHelp(false));
+    header.appendChild(close);
+    this.shortcutsHelp.appendChild(header);
+    const list = createElement("dl", { className: "vd-flowchart-shortcuts-list" });
+    getShortcutRows(this.keyboardShortcuts, this.readonly).forEach(([keys, action]) => {
+      list.appendChild(createElement("dt", { text: keys }));
+      list.appendChild(createElement("dd", { text: action }));
+    });
+    this.shortcutsHelp.appendChild(list);
   }
   handleArrangeChange(event) {
     if (this.readonly) return;
@@ -1720,38 +2297,48 @@ var VdFlowchart = class {
       );
     }
   }
+  // Keys the editor consumes stop here, so page-level shortcuts (a docs
+  // site's "/" search, a host's Escape handler) do not also fire.
   handleKeyDown(event) {
-    if (event.target && (event.target.tagName === "INPUT" || event.target.tagName === "TEXTAREA" || event.target.tagName === "SELECT")) {
+    const alreadyHandled = event.defaultPrevented;
+    this.handleEditorKey(event);
+    if (!alreadyHandled && event.defaultPrevented) event.stopPropagation();
+  }
+  handleEditorKey(event) {
+    const target = event.target;
+    if (target && (target.tagName === "INPUT" || target.tagName === "TEXTAREA" || target.tagName === "SELECT" || target.isContentEditable)) {
       return;
     }
-    if (event.target === this.canvasEl) {
-      const nodes = this.documentData.nodes;
-      const index = nodes.findIndex((node) => node.id === this.selection?.id);
-      let next = -1;
-      if (event.key === "ArrowDown" || event.key === "ArrowRight")
-        next = (index + 1) % nodes.length;
-      if (event.key === "ArrowUp" || event.key === "ArrowLeft")
-        next = index < 0 ? nodes.length - 1 : (index - 1 + nodes.length) % nodes.length;
-      if (event.key === "Home") next = 0;
-      if (event.key === "End") next = nodes.length - 1;
-      if (nodes[next]) {
-        event.preventDefault();
-        this.selectNode(nodes[next].id);
-        return;
-      }
-      if (event.key === "Enter" && !this.readonly && this.selection?.kind === "node") {
-        event.preventDefault();
-        this.startTextEdit(this.selection.id);
-        return;
-      }
+    if (event.isComposing) return;
+    const key = event.key;
+    const modKey = event.metaKey || event.ctrlKey;
+    if (key === "Escape" && this.shortcutsHelpOpen) {
+      event.preventDefault();
+      this.toggleShortcutsHelp(false);
+      return;
+    }
+    if (target === this.canvasEl && this.handleCanvasKeyDown(event)) {
+      event.preventDefault();
+      return;
     }
     if (this.readonly) return;
-    if (event.key === "Escape" && this.activeTool) {
+    if (key === "Escape") {
+      if (this.activeTool) this.setActiveTool(null);
+      else if (this.reconnectEdgeId) {
+        this.reconnectEdgeId = null;
+        this.render({ inspector: false, json: false });
+      } else if (this.selection) this.select(null);
+      else return;
       event.preventDefault();
-      this.setActiveTool(null);
       return;
     }
-    const modKey = event.metaKey || event.ctrlKey;
+    if (modKey && (key === "d" || key === "D")) {
+      if (this.selection?.kind === "node") {
+        event.preventDefault();
+        this.duplicateSelection();
+      }
+      return;
+    }
     if (modKey && (event.key === "z" || event.key === "Z")) {
       event.preventDefault();
       if (event.shiftKey) {
@@ -1790,11 +2377,250 @@ var VdFlowchart = class {
     if (!this.selection) return;
     if (event.key === "Backspace" || event.key === "Delete") {
       event.preventDefault();
+      if (this.selection.kind === "node" && !this.hasMultiSelection()) {
+        const removedId = this.selection.id;
+        const parent = this.getParentNode(removedId);
+        const sibling = parent ? this.getChildNodes(parent.id).find((node) => node.id !== removedId) : null;
+        if (this.deleteSelection()) {
+          const next = parent && this.findNode(parent.id) || sibling;
+          if (next) this.select({ kind: "node", id: next.id });
+        }
+        return;
+      }
       this.deleteSelection();
     }
   }
+  // Keys that only apply while the canvas itself has focus. Returns true when
+  // the key was handled (the caller prevents the default action).
+  handleCanvasKeyDown(event) {
+    const key = event.key;
+    const modKey = event.metaKey || event.ctrlKey;
+    const mindmap = this.keyboardShortcuts === "mindmap";
+    const selectedNode = this.selection?.kind === "node" ? this.findNode(this.selection.id) : null;
+    const selectedEdge = this.selection?.kind === "edge" ? this.findEdge(this.selection.id) : null;
+    const movable = !this.readonly && Boolean(selectedNode);
+    const editable = movable && !this.hasMultiSelection();
+    if (key === "?" && !modKey && !event.altKey) {
+      this.toggleShortcutsHelp();
+      return true;
+    }
+    if (modKey && !event.altKey) {
+      if (key === "=" || key === "+") return Boolean(this.zoomIn());
+      if (key === "-" || key === "_") return Boolean(this.zoomOut());
+      if (key === "0") return Boolean(this.zoomTo(1));
+      if (key === "a" || key === "A") {
+        this.selectNodes(this.getVisibleNodes().map((node) => node.id));
+        return true;
+      }
+      if (key === "/" && selectedNode && !this.hasMultiSelection()) {
+        this.toggleCollapsed(selectedNode.id);
+        return true;
+      }
+      return false;
+    }
+    if (event.shiftKey && !event.altKey && (key === "!" || event.code === "Digit1")) {
+      return Boolean(this.fitView());
+    }
+    const direction = ARROW_DIRECTIONS[key];
+    if (direction) {
+      if (event.altKey) {
+        if (movable) {
+          this.nudgeNodes(this.getSelectedNodeIds(), direction, event.shiftKey ? 1 : this.gridSize);
+        }
+        return true;
+      }
+      if (event.shiftKey) {
+        const anchorId = selectedNode?.id ?? (selectedEdge ? this.edgeCycleAnchor : null);
+        return anchorId ? this.selectSideEdge(anchorId, direction) : false;
+      }
+      this.navigateSelection(direction);
+      return true;
+    }
+    const nodes = this.getVisibleNodes();
+    if ((key === "Home" || key === "End") && nodes.length) {
+      this.selectNode(nodes[key === "Home" ? 0 : nodes.length - 1].id);
+      return true;
+    }
+    if (selectedEdge && !this.readonly && !event.altKey) {
+      if (key === "F2" || key === "Enter" || key === " " && mindmap) {
+        return this.startEdgeLabelEdit(selectedEdge.id);
+      }
+      if (mindmap && key.length === 1 && key !== " ") {
+        return this.startEdgeLabelEdit(selectedEdge.id, { initialText: key });
+      }
+      return false;
+    }
+    if (!editable || event.altKey) return false;
+    if (key === "F2" || key === "Enter" && !mindmap || key === " " && mindmap) {
+      this.startTextEdit(selectedNode.id);
+      return true;
+    }
+    if (!mindmap) return false;
+    if (key === "Tab" && !event.shiftKey) {
+      this.insertBranchNode(selectedNode.id, { edit: true });
+      return true;
+    }
+    if (key === "Enter") {
+      this.insertSiblingNode(selectedNode.id, { before: event.shiftKey, edit: true });
+      return true;
+    }
+    if (key.length === 1 && key !== " " && isNodeTextEditable(selectedNode)) {
+      this.startTextEdit(selectedNode.id, { initialText: key });
+      return true;
+    }
+    return false;
+  }
+  // Move the selection to the nearest node in `direction`; with nothing (or an
+  // edge) selected, start from the node closest to the centre of the view.
+  navigateSelection(direction) {
+    const nodes = this.getVisibleNodes();
+    if (!nodes.length) return false;
+    const current = this.selection?.kind === "node" ? this.findNode(this.selection.id) : null;
+    const edge = this.selection?.kind === "edge" ? this.findEdge(this.selection.id) : null;
+    const next = current ? findSpatialNeighbor(nodes, current, direction) : edge ? this.getEdgeEndInDirection(edge, direction) : findNearestNode(nodes, this.getViewportCenter());
+    if (!next) return false;
+    this.selectNode(next.id);
+    this.revealNode(next.id);
+    return true;
+  }
+  // The end of `edge` that best matches `direction`, measured from the label
+  // anchor so either end can be reached from a selected connection.
+  getEdgeEndInDirection(edge, direction) {
+    const fromNode = this.findNode(edge.from.nodeId);
+    const toNode = this.findNode(edge.to.nodeId);
+    if (!fromNode || !toNode) return fromNode || toNode;
+    const { labelX, labelY } = buildEdgePath(edge, fromNode, toNode);
+    const vector = { right: [1, 0], left: [-1, 0], down: [0, 1], up: [0, -1] }[direction];
+    const score = (node) => (node.x + node.width / 2 - labelX) * vector[0] + (node.y + node.height / 2 - labelY) * vector[1];
+    return score(toNode) >= score(fromNode) ? toNode : fromNode;
+  }
+  // Connections attached to `nodeId` on the `direction` side, outgoing or
+  // incoming, in document order.
+  getSideEdges(nodeId, direction) {
+    const port = DIRECTION_PORTS[direction];
+    return this.documentData.edges.filter(
+      (edge) => edge.from.nodeId === nodeId && edge.from.port === port || edge.to.nodeId === nodeId && edge.to.port === port
+    );
+  }
+  // Select a connection on one side of a node; repeating cycles through them.
+  selectSideEdge(nodeId, direction) {
+    const edges = this.getSideEdges(nodeId, direction);
+    if (!edges.length) return false;
+    const currentIndex = this.selection?.kind === "edge" ? edges.findIndex((edge) => edge.id === this.selection.id) : -1;
+    const next = edges[(currentIndex + 1) % edges.length];
+    this.select({ kind: "edge", id: next.id });
+    this.edgeCycleAnchor = nodeId;
+    return true;
+  }
+  nudgeNode(nodeId, direction, distance) {
+    const [node] = this.nudgeNodes([nodeId], direction, distance);
+    return node || null;
+  }
+  // Move nodes together; repeated nudges of the same selection coalesce into
+  // one undo step.
+  nudgeNodes(nodeIds, direction, distance) {
+    const step = { right: [1, 0], left: [-1, 0], down: [0, 1], up: [0, -1] }[direction];
+    if (this.readonly || !step) return [];
+    const nodes = nodeIds.map((id) => this.findNode(id)).filter(Boolean);
+    if (!nodes.length) return [];
+    nodes.forEach((node) => {
+      node.x = formatNumber(node.x + step[0] * distance);
+      node.y = formatNumber(node.y + step[1] * distance);
+    });
+    this.render({ inspector: true, json: true });
+    this.emitChange(
+      "node:nudge",
+      nodes.length > 1 ? { nodeIds: nodes.map((node) => node.id) } : { node: deepClone(nodes[0]) }
+    );
+    return nodes.map((node) => deepClone(node));
+  }
+  zoomTo(scale) {
+    const viewport = this.documentData.viewport;
+    const width = this.canvasEl.clientWidth || 800;
+    const height = this.canvasEl.clientHeight || 560;
+    this.scaleAround(
+      clamp(formatScale(scale), this.minScale, this.maxScale) / viewport.scale,
+      width / 2,
+      height / 2,
+      "viewport:zoom"
+    );
+    return this;
+  }
+  duplicateSelection() {
+    if (this.readonly || this.selection?.kind !== "node") return null;
+    if (this.hasMultiSelection()) return this.pasteNodeGroup(this.captureNodeGroup());
+    const node = this.findNode(this.selection.id);
+    return node ? this.pasteNodeData(node) : null;
+  }
+  // Selected nodes plus the connections that run between them.
+  captureNodeGroup() {
+    const ids = new Set(this.getSelectedNodeIds());
+    return {
+      nodes: deepClone(this.documentData.nodes.filter((node) => ids.has(node.id))),
+      edges: deepClone(
+        this.documentData.edges.filter(
+          (edge) => ids.has(edge.from.nodeId) && ids.has(edge.to.nodeId)
+        )
+      )
+    };
+  }
+  // Paste a captured group offset by one step, remapping ids so internal
+  // connections follow their copies. One change, one undo step.
+  pasteNodeGroup(group) {
+    if (this.readonly || !group?.nodes?.length) return [];
+    const usedNodeIds = new Set(this.documentData.nodes.map((node) => node.id));
+    const idMap = /* @__PURE__ */ new Map();
+    const nodes = group.nodes.map((data, index) => {
+      const node = normalizeNode(
+        { ...data, id: void 0, x: data.x + 24, y: data.y + 24 },
+        this.documentData.nodes.length + index,
+        usedNodeIds,
+        this.nodeSizeBounds()
+      );
+      idMap.set(data.id, node.id);
+      return node;
+    });
+    this.documentData.nodes.push(...nodes);
+    const nodeIds = new Set(this.documentData.nodes.map((node) => node.id));
+    const usedEdgeIds = new Set(this.documentData.edges.map((edge) => edge.id));
+    group.edges.forEach((data, index) => {
+      const edge = normalizeEdge(
+        {
+          ...data,
+          id: void 0,
+          from: { ...data.from, nodeId: idMap.get(data.from.nodeId) },
+          to: { ...data.to, nodeId: idMap.get(data.to.nodeId) }
+        },
+        this.documentData.edges.length + index,
+        nodeIds,
+        usedEdgeIds
+      );
+      if (edge) this.documentData.edges.push(edge);
+    });
+    const ids = nodes.map((node) => node.id);
+    this.selectNodes(ids);
+    this.emitChange("nodes:add", { nodeIds: ids });
+    return nodes.map((node) => deepClone(node));
+  }
+  pasteNodeData(data) {
+    const usedIds = new Set(this.documentData.nodes.map((node2) => node2.id));
+    const node = normalizeNode(
+      { ...data, id: void 0, collapsed: void 0, x: data.x + 24, y: data.y + 24 },
+      this.documentData.nodes.length,
+      usedIds,
+      this.nodeSizeBounds()
+    );
+    this.documentData.nodes.push(node);
+    this.select({ kind: "node", id: node.id });
+    this.emitChange("node:add", { node: deepClone(node) });
+    return deepClone(node);
+  }
   copySelection() {
     if (!this.selection) return false;
+    if (this.hasMultiSelection()) {
+      this.clipboard = { kind: "nodes", data: this.captureNodeGroup() };
+      return true;
+    }
     if (this.selection.kind === "node") {
       const node = this.findNode(this.selection.id);
       if (!node) return false;
@@ -1809,22 +2635,14 @@ var VdFlowchart = class {
   pasteClipboard() {
     if (!this.clipboard || this.readonly) return false;
     if (this.clipboard.kind === "node") {
-      const usedIds2 = new Set(this.documentData.nodes.map((node2) => node2.id));
-      const node = normalizeNode(
-        {
-          ...this.clipboard.data,
-          id: void 0,
-          x: this.clipboard.data.x + 24,
-          y: this.clipboard.data.y + 24
-        },
-        this.documentData.nodes.length,
-        usedIds2
-      );
-      this.documentData.nodes.push(node);
-      this.select({ kind: "node", id: node.id });
-      this.emitChange("node:add", { node: deepClone(node) });
+      this.pasteNodeData(this.clipboard.data);
       return true;
     }
+    if (this.clipboard.kind === "nodes") {
+      const pasted = this.pasteNodeGroup(this.clipboard.data);
+      this.clipboard = { kind: "nodes", data: this.captureNodeGroup() };
+      return pasted.length > 0;
+    }
     const usedIds = new Set(this.documentData.edges.map((edge2) => edge2.id));
     const nodeIds = new Set(this.documentData.nodes.map((node) => node.id));
     const edge = normalizeEdge(
@@ -1851,16 +2669,16 @@ var VdFlowchart = class {
     const edgeTarget = event.target.closest("[data-edge-id]");
     if (edgeTarget && !event.target.closest("[data-edge-endpoint]")) {
       const edgeId = edgeTarget.getAttribute("data-edge-id");
-      if (edgeId && this.findEdge(edgeId)) {
-        this.reconnectEdgeId = edgeId;
-        this.select({ kind: "edge", id: edgeId });
+      if (edgeId && this.startEdgeLabelEdit(edgeId)) {
         event.preventDefault();
         event.stopPropagation();
         return;
       }
     }
     const nodeTarget = event.target.closest("[data-node-id]");
-    if (!nodeTarget || event.target.closest("[data-edge-id]")) return;
+    if (!nodeTarget || event.target.closest("[data-edge-id]") || event.target.closest("[data-collapse-toggle]")) {
+      return;
+    }
     const nodeId = nodeTarget.getAttribute("data-node-id");
     if (this.startTextEdit(nodeId)) {
       event.preventDefault();
@@ -1870,7 +2688,7 @@ var VdFlowchart = class {
   handleClick(event) {
     if (this.readonly || event.detail < 2) return;
     const nodeTarget = event.target.closest("[data-node-id]");
-    if (!nodeTarget || event.target.closest("[data-port]") || event.target.closest("[data-resize-handle]"))
+    if (!nodeTarget || event.target.closest("[data-port]") || event.target.closest("[data-resize-handle]") || event.target.closest("[data-collapse-toggle]"))
       return;
     if (this.startTextEdit(nodeTarget.getAttribute("data-node-id"))) {
       event.preventDefault();
@@ -1883,6 +2701,13 @@ var VdFlowchart = class {
       this.stopTextEdit({ commit: true });
     }
     this.canvasEl.focus();
+    const collapseTarget = event.target.closest("[data-collapse-toggle]");
+    if (collapseTarget) {
+      this.lastNodePointer = null;
+      this.toggleCollapsed(collapseTarget.getAttribute("data-collapse-toggle"));
+      event.preventDefault();
+      return;
+    }
     const nodeTarget = event.target.closest("[data-node-id]");
     const portTarget = event.target.closest("[data-port]");
     const resizeTarget = event.target.closest("[data-resize-handle]");
@@ -1918,6 +2743,13 @@ var VdFlowchart = class {
       event.preventDefault();
       return;
     }
+    if (nodeTarget && !portTarget && !resizeTarget && !edgeTarget && event.shiftKey) {
+      this.reconnectEdgeId = null;
+      this.lastNodePointer = null;
+      this.toggleNodeSelection(nodeTarget.getAttribute("data-node-id"));
+      event.preventDefault();
+      return;
+    }
     if (nodeTarget && !portTarget && !resizeTarget && !edgeTarget && !this.readonly) {
       if (this.activeTool === "arrow") {
         this.select({ kind: "node", id: nodeTarget.getAttribute("data-node-id") });
@@ -1944,6 +2776,9 @@ var VdFlowchart = class {
       this.interaction = {
         kind: "connect",
         pointerId: event.pointerId,
+        startClientX: event.clientX,
+        startClientY: event.clientY,
+        moved: false,
         source: { nodeId, port },
         target: null,
         previousSnap: null,
@@ -1994,22 +2829,27 @@ var VdFlowchart = class {
     if (nodeTarget) {
       this.reconnectEdgeId = null;
       const nodeId = nodeTarget.getAttribute("data-node-id");
-      this.select({ kind: "node", id: nodeId });
+      const groupIds = this.hasMultiSelection() && this.isNodeSelected(nodeId) ? this.getSelectedNodeIds() : [nodeId];
+      if (groupIds.length > 1) this.selectNodes(groupIds, { primary: nodeId });
+      else this.select({ kind: "node", id: nodeId });
       if (!this.readonly) {
-        const node = this.findNode(nodeId);
-        const world = this.clientToWorld(event.clientX, event.clientY);
-        this.interaction = {
-          kind: "drag-node",
-          pointerId: event.pointerId,
-          nodeId,
-          offsetX: world.x - node.x,
-          offsetY: world.y - node.y,
-          moved: false
-        };
+        this.interaction = this.createDragInteraction(event, nodeId, groupIds);
         this.capturePointer(event.pointerId);
       }
       return;
     }
+    if (event.shiftKey) {
+      const startWorld = this.clientToWorld(event.clientX, event.clientY);
+      this.interaction = {
+        kind: "marquee",
+        pointerId: event.pointerId,
+        startWorld,
+        baseIds: this.selection?.kind === "node" ? this.getSelectedNodeIds() : []
+      };
+      this.capturePointer(event.pointerId);
+      event.preventDefault();
+      return;
+    }
     this.select(null);
     this.reconnectEdgeId = null;
     this.interaction = {
@@ -2024,20 +2864,123 @@ var VdFlowchart = class {
     this.capturePointer(event.pointerId);
     event.preventDefault();
   }
+  createDragInteraction(event, nodeId, nodeIds) {
+    const nodes = nodeIds.map((id) => this.findNode(id)).filter(Boolean);
+    const moving = new Set(nodes.map((node) => node.id));
+    return {
+      kind: "drag-node",
+      pointerId: event.pointerId,
+      nodeId,
+      nodeIds: nodes.map((node) => node.id),
+      startWorld: this.clientToWorld(event.clientX, event.clientY),
+      origins: new Map(nodes.map((node) => [node.id, { x: node.x, y: node.y }])),
+      bounds: getBounds(nodes),
+      guideLines: this.snapGuides ? collectGuideLines(this.getVisibleNodes().filter((node) => !moving.has(node.id))) : null,
+      snapDisabled: false,
+      moved: false
+    };
+  }
+  // Translate every dragged node by the pointer delta, snapping the group's
+  // bounds to the nearest alignment guide on each axis. Alt turns snapping
+  // off for the rest of the gesture.
+  moveDraggedNodes(event) {
+    const interaction = this.interaction;
+    const world = this.clientToWorld(event.clientX, event.clientY);
+    let dx = world.x - interaction.startWorld.x;
+    let dy = world.y - interaction.startWorld.y;
+    if (event.altKey) interaction.snapDisabled = true;
+    let guides = [];
+    if (interaction.guideLines && !interaction.snapDisabled) {
+      const box = interaction.bounds;
+      const threshold = GUIDE_SNAP_DISTANCE / this.documentData.viewport.scale;
+      const left = box.left + dx;
+      const top = box.top + dy;
+      const width = box.right - box.left;
+      const height = box.bottom - box.top;
+      const snapX = snapToGuides(
+        interaction.guideLines.x,
+        [left, left + width / 2, left + width],
+        threshold
+      );
+      const snapY = snapToGuides(
+        interaction.guideLines.y,
+        [top, top + height / 2, top + height],
+        threshold
+      );
+      if (snapX) dx += snapX.offset;
+      if (snapY) dy += snapY.offset;
+      const snapped = { left: box.left + dx, top: box.top + dy, width, height };
+      if (snapX) guides = guides.concat(guideSegments("x", snapX.lines, snapped));
+      if (snapY) guides = guides.concat(guideSegments("y", snapY.lines, snapped));
+    }
+    let changed = false;
+    interaction.nodeIds.forEach((id) => {
+      const node = this.findNode(id);
+      const origin = interaction.origins.get(id);
+      if (!node || !origin) return;
+      const nextX = formatNumber(origin.x + dx);
+      const nextY = formatNumber(origin.y + dy);
+      if (nextX === node.x && nextY === node.y) return;
+      node.x = nextX;
+      node.y = nextY;
+      changed = true;
+      this.renderDraggedNode(node);
+    });
+    if (changed) interaction.moved = true;
+    this.renderGuides(guides);
+  }
+  // Live marquee: select every visible node the box touches, added to the
+  // selection the gesture started from.
+  updateMarquee(event) {
+    const interaction = this.interaction;
+    const world = this.clientToWorld(event.clientX, event.clientY);
+    const box = {
+      left: Math.min(interaction.startWorld.x, world.x),
+      top: Math.min(interaction.startWorld.y, world.y),
+      right: Math.max(interaction.startWorld.x, world.x),
+      bottom: Math.max(interaction.startWorld.y, world.y)
+    };
+    clearChildren(this.guidesLayer);
+    this.guidesLayer.appendChild(
+      svgEl("rect", {
+        class: "vd-flowchart-marquee",
+        x: formatNumber(box.left),
+        y: formatNumber(box.top),
+        width: formatNumber(box.right - box.left),
+        height: formatNumber(box.bottom - box.top)
+      })
+    );
+    const hits = this.getVisibleNodes().filter(
+      (node) => node.x <= box.right && node.x + node.width >= box.left && node.y <= box.bottom && node.y + node.height >= box.top
+    ).map((node) => node.id);
+    const ids = [.../* @__PURE__ */ new Set([...interaction.baseIds, ...hits])];
+    const key = ids.join(",");
+    if (key === interaction.lastKey) return;
+    interaction.lastKey = key;
+    this.selectNodes(ids, { primary: hits[hits.length - 1] });
+  }
+  renderGuides(guides) {
+    clearChildren(this.guidesLayer);
+    guides.forEach((guide) => {
+      this.guidesLayer.appendChild(
+        svgEl("line", {
+          class: "vd-flowchart-guide",
+          x1: guide.x1,
+          y1: guide.y1,
+          x2: guide.x2,
+          y2: guide.y2
+        })
+      );
+    });
+  }
   handlePointerMove(event) {
     if (!this.interaction || this.interaction.pointerId !== event.pointerId) return;
     if (this.interaction.kind === "drag-node") {
-      const node = this.findNode(this.interaction.nodeId);
-      if (!node) return;
-      const world = this.clientToWorld(event.clientX, event.clientY);
-      const nextX = formatNumber(world.x - this.interaction.offsetX);
-      const nextY = formatNumber(world.y - this.interaction.offsetY);
-      if (nextX !== node.x || nextY !== node.y) {
-        node.x = nextX;
-        node.y = nextY;
-        this.interaction.moved = true;
-        this.renderDraggedNode(node);
-      }
+      this.moveDraggedNodes(event);
+      return;
+    }
+    if (this.interaction.kind === "marquee") {
+      this.updateMarquee(event);
       return;
     }
     if (this.interaction.kind === "resize-node") {
@@ -2072,6 +3015,14 @@ var VdFlowchart = class {
       return;
     }
     if (this.interaction.kind === "connect") {
+      if (!this.interaction.moved) {
+        const travel = Math.hypot(
+          event.clientX - this.interaction.startClientX,
+          event.clientY - this.interaction.startClientY
+        );
+        if (!(travel > PORT_CLICK_SLOP)) return;
+        this.interaction.moved = true;
+      }
       const world = this.clientToWorld(event.clientX, event.clientY);
       const snapTarget = this.findConnectionTarget(
         world,
@@ -2158,10 +3109,19 @@ var VdFlowchart = class {
       }
       return;
     }
+    if (interaction.kind === "marquee") {
+      clearChildren(this.guidesLayer);
+      return;
+    }
     if (interaction.kind === "drag-node") {
+      clearChildren(this.guidesLayer);
       if (interaction.moved) {
         this.render({ inspector: true, json: true });
-        this.emitChange("node:move", { node: deepClone(this.findNode(interaction.nodeId)) });
+        if (interaction.nodeIds.length > 1) {
+          this.emitChange("nodes:move", { nodeIds: [...interaction.nodeIds] });
+        } else {
+          this.emitChange("node:move", { node: deepClone(this.findNode(interaction.nodeId)) });
+        }
       } else {
         this.render({ inspector: false, json: false });
       }
@@ -2177,6 +3137,14 @@ var VdFlowchart = class {
       return;
     }
     if (interaction.kind === "connect") {
+      if (!interaction.moved && this.activeTool !== "arrow") {
+        this.render({ inspector: false, json: false });
+        this.insertBranchNode(interaction.source.nodeId, {
+          direction: PORT_DIRECTIONS[interaction.source.port],
+          edit: true
+        });
+        return;
+      }
       const world = this.clientToWorld(event.clientX || 0, event.clientY || 0);
       const snapTarget = interaction.target ? { node: this.findNode(interaction.target.nodeId), port: interaction.target.port } : this.findConnectionTarget(
         world,
@@ -2252,16 +3220,17 @@ var VdFlowchart = class {
     if (this.readonly) return false;
     if (this.interaction?.kind === "connect" || this.interaction?.kind === "reconnect") return true;
     if (this.activeTool === "arrow") return true;
-    return this.selection?.kind === "node" && this.selection.id === node.id;
+    return this.selection?.kind === "node" && this.selection.id === node.id && !this.hasMultiSelection();
   }
-  getMarkerId(markerType, position, strokeWidth) {
+  getMarkerId(markerType, position, strokeWidth, edgeScale = 1) {
     const width = normalizeEdgeStrokeWidth(strokeWidth);
-    const key = `${markerType}:${position}:${width}`;
+    const scale = clamp(formatNumber(Math.max(edgeScale, 0.01)), 0.01, 1);
+    const key = `${markerType}:${position}:${width}:${scale}`;
     if (this.markerIds.has(key)) {
       return this.markerIds.get(key);
     }
     const markerId = nextId(`flowchart-${markerType}-${position}`);
-    const marker = markerType === "dot" ? createDotMarker(markerId, width) : createArrowMarker(markerId, width, position === "start");
+    const marker = markerType === "dot" ? createDotMarker(markerId, width, scale) : createArrowMarker(markerId, width, position === "start", scale);
     this.markerDefs.appendChild(marker);
     this.markerIds.set(key, markerId);
     return markerId;
@@ -2269,13 +3238,20 @@ var VdFlowchart = class {
   getEdgeStrokeWidth(edge) {
     return normalizeEdgeStrokeWidth(edge?.strokeWidth);
   }
-  getEdgeHitStrokeWidth(edge) {
-    return formatNumber(Math.max(EDGE_HIT_STROKE_MIN, this.getEdgeStrokeWidth(edge) + 12));
+  getEdgeHitStrokeWidth(edge, edgeScale = 1) {
+    const visual = clamp(toFiniteNumber(edgeScale, 1), 0.01, 1);
+    const base = this.getEdgeStrokeWidth(edge);
+    const view = Math.max(this.documentData?.viewport?.scale || 1, 1e-4);
+    const legacy = Math.max(EDGE_HIT_STROKE_MIN, base + 12);
+    if (visual >= 0.999 && view >= DEFAULT_MIN_SCALE && view <= DEFAULT_MAX_SCALE) {
+      return formatNumber(legacy);
+    }
+    return formatNumber(Math.max(base * visual, EDGE_HIT_STROKE_MIN / view));
   }
   findConnectionTarget(worldPoint, excludeNodeId, previousSnap = null, referencePoint = null) {
     const snapPadding = CONNECTION_SNAP_PADDING / this.documentData.viewport.scale;
     const hysteresisMargin = CONNECTION_HYSTERESIS / this.documentData.viewport.scale;
-    const best = this.documentData.nodes.reduce((candidate, node) => {
+    const best = this.getVisibleNodes().reduce((candidate, node) => {
       if (node.id === excludeNodeId) return candidate;
       const distanceToBounds2 = getDistanceToNodeBounds(node, worldPoint);
       if (distanceToBounds2 > snapPadding) return candidate;
@@ -2327,17 +3303,37 @@ var VdFlowchart = class {
     let width = original.width;
     let height = original.height;
     if (handle.includes("e")) {
-      width = clampNodeWidth(nextType, original.width + deltaX, original.width);
+      width = clampNodeWidth(
+        nextType,
+        original.width + deltaX,
+        original.width,
+        this.nodeSizeBounds()
+      );
     }
     if (handle.includes("s")) {
-      height = clampNodeHeight(nextType, original.height + deltaY, original.height);
+      height = clampNodeHeight(
+        nextType,
+        original.height + deltaY,
+        original.height,
+        this.nodeSizeBounds()
+      );
     }
     if (handle.includes("w")) {
-      width = clampNodeWidth(nextType, original.width - deltaX, original.width);
+      width = clampNodeWidth(
+        nextType,
+        original.width - deltaX,
+        original.width,
+        this.nodeSizeBounds()
+      );
       x = original.x + original.width - width;
     }
     if (handle.includes("n")) {
-      height = clampNodeHeight(nextType, original.height - deltaY, original.height);
+      height = clampNodeHeight(
+        nextType,
+        original.height - deltaY,
+        original.height,
+        this.nodeSizeBounds()
+      );
       y = original.y + original.height - height;
     }
     return {
@@ -2373,7 +3369,7 @@ var VdFlowchart = class {
   scaleAround(factor, localX, localY, reason) {
     const viewport = this.documentData.viewport;
     const anchor = this.localToWorld(localX, localY);
-    const nextScale = clamp(formatNumber(viewport.scale * factor), MIN_SCALE, MAX_SCALE);
+    const nextScale = clamp(formatScale(viewport.scale * factor), this.minScale, this.maxScale);
     if (nextScale === viewport.scale) return;
     viewport.scale = nextScale;
     viewport.x = formatNumber(localX - anchor.x * nextScale);
@@ -2384,7 +3380,10 @@ var VdFlowchart = class {
   updateToolbarLabel() {
     this.zoomLabel.textContent = `${Math.round(this.documentData.viewport.scale * 100)}%`;
   }
-  startTextEdit(nodeId) {
+  // Options: `initialText` replaces the label with typed text (type-to-edit);
+  // `inserted` marks a node created by a keyboard/handle insertion so naming it
+  // shares the insertion's undo step.
+  startTextEdit(nodeId, options = {}) {
     if (this.readonly) return false;
     const node = this.findNode(nodeId);
     if (!node || !isNodeTextEditable(node)) return false;
@@ -2396,9 +3395,10 @@ var VdFlowchart = class {
     }
     this.stopTextEdit({ commit: true });
     this.select({ kind: "node", id: node.id });
+    const replacing = typeof options.initialText === "string";
     const textarea = createElement("textarea", {
       className: `vd-flowchart-text-editor vd-flowchart-text-editor--${node.type}`,
-      value: node.text,
+      value: replacing ? options.initialText : node.text,
       rows: 1
     });
     textarea.setAttribute("data-node-id", node.id);
@@ -2407,19 +3407,7 @@ var VdFlowchart = class {
     textarea.addEventListener("input", () => this.positionTextEditor());
     textarea.addEventListener("pointerdown", (event) => event.stopPropagation());
     textarea.addEventListener("dblclick", (event) => event.stopPropagation());
-    textarea.addEventListener("keydown", (event) => {
-      if (event.key === "Escape") {
-        event.preventDefault();
-        this.stopTextEdit({ commit: false });
-        this.canvasEl.focus();
-        return;
-      }
-      if (event.key === "Enter" && (event.ctrlKey || event.metaKey)) {
-        event.preventDefault();
-        this.stopTextEdit({ commit: true });
-        this.canvasEl.focus();
-      }
-    });
+    textarea.addEventListener("keydown", (event) => this.handleTextEditorKeyDown(event, node));
     textarea.addEventListener("blur", () => {
       if (this.textEditor?.textarea === textarea) {
         this.stopTextEdit({ commit: true });
@@ -2428,18 +3416,97 @@ var VdFlowchart = class {
     this.textEditor = {
       nodeId: node.id,
       previousText: node.text,
+      inserted: Boolean(options.inserted),
       textarea
     };
     this.canvasEl.appendChild(textarea);
     this.render({ inspector: true, json: false });
-    window.requestAnimationFrame(() => {
-      if (this.textEditor?.textarea === textarea) {
-        textarea.focus();
+    const focusEditor = () => {
+      if (this.textEditor?.textarea !== textarea) return;
+      textarea.focus();
+      if (replacing) {
+        textarea.setSelectionRange(textarea.value.length, textarea.value.length);
+      } else {
         textarea.select();
       }
+    };
+    focusEditor();
+    window.requestAnimationFrame(() => {
+      if (document.activeElement !== textarea) focusEditor();
+    });
+    return true;
+  }
+  // Inline label editor for a connection, placed on the label anchor
+  // (curve midpoint). Labels render on one line, so Enter always saves.
+  startEdgeLabelEdit(edgeId, options = {}) {
+    if (this.readonly) return false;
+    const edge = this.findEdge(sanitizeId(edgeId));
+    if (!edge) return false;
+    this.stopTextEdit({ commit: true });
+    this.select({ kind: "edge", id: edge.id });
+    const replacing = typeof options.initialText === "string";
+    const textarea = createElement("textarea", {
+      className: "vd-flowchart-text-editor vd-flowchart-text-editor--edge",
+      value: replacing ? options.initialText : edge.label,
+      rows: 1
+    });
+    textarea.setAttribute("data-edge-id", edge.id);
+    textarea.setAttribute("aria-label", "Edit connection label");
+    textarea.spellcheck = false;
+    textarea.addEventListener("input", () => this.positionTextEditor());
+    textarea.addEventListener("pointerdown", (event) => event.stopPropagation());
+    textarea.addEventListener("dblclick", (event) => event.stopPropagation());
+    textarea.addEventListener("keydown", (event) => {
+      if (event.isComposing) return;
+      if (event.key === "Escape" || event.key === "Enter") {
+        event.preventDefault();
+        this.stopTextEdit({ commit: event.key === "Enter" });
+        this.canvasEl.focus();
+      }
+    });
+    textarea.addEventListener("blur", () => {
+      if (this.textEditor?.textarea === textarea) this.stopTextEdit({ commit: true });
+    });
+    this.textEditor = { nodeId: null, edgeId: edge.id, previousText: edge.label, textarea };
+    this.canvasEl.appendChild(textarea);
+    this.render({ inspector: true, json: false });
+    const focusEditor = () => {
+      if (this.textEditor?.textarea !== textarea) return;
+      textarea.focus();
+      if (replacing) textarea.setSelectionRange(textarea.value.length, textarea.value.length);
+      else textarea.select();
+    };
+    focusEditor();
+    window.requestAnimationFrame(() => {
+      if (document.activeElement !== textarea) focusEditor();
     });
     return true;
   }
+  handleTextEditorKeyDown(event, node) {
+    if (event.isComposing) return;
+    const mindmap = this.keyboardShortcuts === "mindmap";
+    if (event.key === "Escape") {
+      event.preventDefault();
+      this.stopTextEdit({ commit: false });
+      this.canvasEl.focus();
+      return;
+    }
+    if (event.key === "Enter") {
+      const modKey = event.ctrlKey || event.metaKey;
+      const commits = modKey || mindmap && node.type !== "textbox" && !event.shiftKey;
+      if (!commits) return;
+      event.preventDefault();
+      this.stopTextEdit({ commit: true });
+      this.canvasEl.focus();
+      return;
+    }
+    if (event.key === "Tab" && mindmap && !event.shiftKey && !event.altKey && !event.ctrlKey) {
+      event.preventDefault();
+      this.stopTextEdit({ commit: true });
+      this.canvasEl.focus();
+      this.insertBranchNode(node.id, { edit: true });
+    }
+  }
   stopTextEdit(options = {}) {
     if (!this.textEditor) return false;
     const commit = options.commit !== false;
@@ -2447,12 +3514,26 @@ var VdFlowchart = class {
     const nextText = editor.textarea.value;
     this.textEditor = null;
     editor.textarea.remove();
+    if (editor.edgeId) {
+      const label = nextText.replace(/\s*\n\s*/g, " ").trim();
+      if (commit && !this.readonly && label !== editor.previousText) {
+        this.updateEdge(editor.edgeId, { label }, { inspector: true, reason: "edge:update" });
+      } else {
+        this.render({ scene: true, inspector: false, json: false });
+      }
+      return true;
+    }
     if (commit && !this.readonly && nextText !== editor.previousText) {
-      this.updateNode(
-        editor.nodeId,
-        { text: nextText },
-        { inspector: true, reason: "node:update" }
-      );
+      this.coalesceInsertedText = editor.inserted;
+      try {
+        this.updateNode(
+          editor.nodeId,
+          { text: nextText },
+          { inspector: true, reason: "node:update" }
+        );
+      } finally {
+        this.coalesceInsertedText = false;
+      }
     } else {
       this.render({ scene: true, inspector: false, json: false });
     }
@@ -2460,6 +3541,10 @@ var VdFlowchart = class {
   }
   positionTextEditor() {
     if (!this.textEditor) return;
+    if (this.textEditor.edgeId) {
+      this.positionEdgeLabelEditor();
+      return;
+    }
     const node = this.findNode(this.textEditor.nodeId);
     if (!node) {
       this.stopTextEdit({ commit: false });
@@ -2467,24 +3552,50 @@ var VdFlowchart = class {
     }
     const viewport = this.documentData.viewport;
     const scale = viewport.scale;
+    const visual = nodeVisualScale(node);
     const textarea = this.textEditor.textarea;
     const width = node.width * scale;
     const height = node.height * scale;
     const metrics = getNodeFontMetrics(node);
-    const lineHeight = metrics.lineHeight * scale;
+    const lineHeight = metrics.lineHeight * visual * scale;
     const lineCount = Math.max(1, textarea.value.split(/\r?\n/).length);
-    const horizontalPadding = (node.type === "textbox" ? 16 : 12) * scale;
-    const verticalPadding = node.type === "textbox" ? 12 * scale : Math.max(4, (height - lineCount * lineHeight) / 2);
+    const horizontalPadding = (node.type === "textbox" ? 16 : 12) * visual * scale;
+    const verticalPadding = node.type === "textbox" ? 12 * visual * scale : Math.max(4 * visual, (height - lineCount * lineHeight) / 2);
     textarea.style.left = `${formatNumber(viewport.x + node.x * scale)}px`;
     textarea.style.top = `${formatNumber(viewport.y + node.y * scale)}px`;
     textarea.style.width = `${formatNumber(width)}px`;
     textarea.style.height = `${formatNumber(height)}px`;
-    textarea.style.fontSize = `${formatNumber(metrics.fontSize * scale)}px`;
+    textarea.style.fontSize = `${formatNumber(metrics.fontSize * visual * scale)}px`;
     textarea.style.lineHeight = `${formatNumber(lineHeight)}px`;
     textarea.style.padding = `${formatNumber(verticalPadding)}px ${formatNumber(horizontalPadding)}px`;
   }
+  positionEdgeLabelEditor() {
+    const edge = this.findEdge(this.textEditor.edgeId);
+    const fromNode = edge && this.findNode(edge.from.nodeId);
+    const toNode = edge && this.findNode(edge.to.nodeId);
+    if (!edge || !fromNode || !toNode) {
+      this.stopTextEdit({ commit: false });
+      return;
+    }
+    const visual = edgeVisualScale(fromNode, toNode);
+    const { labelX, labelY } = buildEdgePath(edge, fromNode, toNode);
+    const viewport = this.documentData.viewport;
+    const textarea = this.textEditor.textarea;
+    const fontSize = Math.max(11 * visual, 13 * visual * viewport.scale);
+    const width = clamp(textarea.value.length * fontSize * 0.62 + 28 * visual, 96 * visual, 280);
+    const height = fontSize * 1.4 + 12 * visual;
+    const labelOffset = 8 * visual;
+    textarea.style.left = `${formatNumber(viewport.x + labelX * viewport.scale - width / 2)}px`;
+    textarea.style.top = `${formatNumber(viewport.y + (labelY - labelOffset) * viewport.scale - height / 2)}px`;
+    textarea.style.width = `${formatNumber(width)}px`;
+    textarea.style.height = `${formatNumber(height)}px`;
+    textarea.style.fontSize = `${formatNumber(fontSize)}px`;
+    textarea.style.lineHeight = `${formatNumber(fontSize * 1.4)}px`;
+    textarea.style.padding = "6px 10px";
+  }
   render(options = {}) {
     if (this.destroyed) return;
+    this.syncGrid();
     const shouldRenderScene = options.scene !== false;
     const shouldRenderInspector = options.inspector !== false;
     const shouldRenderJson = options.json !== false;
@@ -2495,8 +3606,10 @@ var VdFlowchart = class {
     this.updateToolbarLabel();
     this.updatePaletteState();
     this.positionTextEditor();
+    this.scheduleMinimap();
   }
   renderScene() {
+    this.syncSelectedNodeIds();
     const viewport = this.documentData.viewport;
     this.world.setAttribute(
       "transform",
@@ -2506,7 +3619,14 @@ var VdFlowchart = class {
     clearChildren(this.previewLayer);
     clearChildren(this.nodesLayer);
     clearChildren(this.overlayLayer);
-    const nodeMap = new Map(this.documentData.nodes.map((node) => [node.id, node]));
+    clearChildren(this.markerDefs);
+    this.markerIds = /* @__PURE__ */ new Map();
+    const hidden = this.getHiddenNodeIds();
+    this.sceneHidden = hidden;
+    this.sceneOutgoing = this.getOutgoingMap();
+    const nodeMap = new Map(
+      this.documentData.nodes.filter((node) => !hidden.has(node.id)).map((node) => [node.id, node])
+    );
     this.sceneNodeMap = nodeMap;
     this.nodeElements = /* @__PURE__ */ new Map();
     this.edgeElements = /* @__PURE__ */ new Map();
@@ -2526,6 +3646,7 @@ var VdFlowchart = class {
       this.previewLayer.appendChild(this.renderPreviewEdge(this.interaction));
     }
     this.documentData.nodes.forEach((node) => {
+      if (hidden.has(node.id)) return;
       const element = this.renderNode(node);
       this.nodesLayer.appendChild(element);
       this.nodeElements.set(node.id, element);
@@ -2563,17 +3684,18 @@ var VdFlowchart = class {
       }
     }
   }
-  applyEdgeMarkers(pathElement, edge) {
+  applyEdgeMarkers(pathElement, edge, edgeScale = 1) {
+    const width = this.getEdgeStrokeWidth(edge);
     if (edge.startMarker && edge.startMarker !== "none") {
       pathElement.setAttribute(
         "marker-start",
-        `url(#${this.getMarkerId(edge.startMarker, "start", this.getEdgeStrokeWidth(edge))})`
+        `url(#${this.getMarkerId(edge.startMarker, "start", width, edgeScale)})`
       );
     }
     if (edge.endMarker && edge.endMarker !== "none") {
       pathElement.setAttribute(
         "marker-end",
-        `url(#${this.getMarkerId(edge.endMarker, "end", this.getEdgeStrokeWidth(edge))})`
+        `url(#${this.getMarkerId(edge.endMarker, "end", width, edgeScale)})`
       );
     }
   }
@@ -2581,6 +3703,7 @@ var VdFlowchart = class {
     const fromNode = nodeMap.get(edge.from.nodeId);
     const toNode = nodeMap.get(edge.to.nodeId);
     if (!fromNode || !toNode) return null;
+    const visual = edgeVisualScale(fromNode, toNode);
     const edgePath = buildEdgePath(edge, fromNode, toNode);
     const selected = this.selection?.kind === "edge" && this.selection.id === edge.id;
     const inReconnectMode = this.reconnectEdgeId === edge.id;
@@ -2588,13 +3711,14 @@ var VdFlowchart = class {
       class: `vd-flowchart-edge${selected ? " is-selected" : ""}${inReconnectMode ? " is-reconnecting" : ""}`,
       "data-edge-id": edge.id
     });
-    const strokeWidth = this.getEdgeStrokeWidth(edge);
+    const baseStroke = this.getEdgeStrokeWidth(edge);
+    const strokeWidth = visual < 0.999 ? formatNumber(Math.max(0.02, baseStroke * visual)) : baseStroke;
     if (selected) {
       group.appendChild(
         svgEl("path", {
           class: "vd-flowchart-edge-selection",
           d: edgePath.d,
-          "stroke-width": formatNumber(strokeWidth + 7)
+          "stroke-width": visual < 0.999 ? formatNumber((baseStroke + 7) * visual) : formatNumber(strokeWidth + 7)
         })
       );
     }
@@ -2604,23 +3728,28 @@ var VdFlowchart = class {
       "stroke-width": strokeWidth,
       "data-edge-id": edge.id
     });
-    this.applyEdgeMarkers(visiblePath, edge);
+    this.applyEdgeMarkers(visiblePath, edge, visual);
     const hitPath = svgEl("path", {
       class: "vd-flowchart-edge-hit",
       d: edgePath.d,
-      "stroke-width": this.getEdgeHitStrokeWidth(edge),
+      "stroke-width": this.getEdgeHitStrokeWidth(edge, visual),
       "data-edge-id": edge.id
     });
     group.appendChild(visiblePath);
     group.appendChild(hitPath);
-    if (edge.label) {
+    if (edge.label && this.textEditor?.edgeId !== edge.id) {
+      const labelOffset = visual < 0.999 ? formatNumber(8 * visual) : 8;
       const label = svgEl("text", {
         class: "vd-flowchart-edge-label",
         x: edgePath.labelX,
-        y: edgePath.labelY - 8,
+        y: edgePath.labelY - labelOffset,
         "text-anchor": "middle",
         "data-edge-id": edge.id
       });
+      if (visual < 0.999) {
+        label.style.fontSize = `${formatNumber(Math.max(0.06, 12 * visual))}px`;
+        label.style.strokeWidth = `${formatNumber(Math.max(0.03, 5 * visual))}px`;
+      }
       label.textContent = edge.label;
       group.appendChild(label);
     }
@@ -2659,23 +3788,32 @@ var VdFlowchart = class {
   renderPreviewEdge(interaction) {
     const fromPort = interaction.fromPort || interaction.source?.port || "right";
     const toPort = interaction.toPort || interaction.target?.port || "left";
-    const edgePath = buildEdgePath({
-      strokeWidth: interaction.strokeWidth,
-      route: interaction.route,
-      fromPoint: interaction.fromPoint,
-      toPoint: interaction.toPoint,
-      from: { port: fromPort },
-      to: { port: toPort }
-    });
+    const fromNode = interaction.source?.nodeId ? this.findNode(interaction.source.nodeId) : null;
+    const toNode = interaction.target?.nodeId ? this.findNode(interaction.target.nodeId) : null;
+    const visual = edgeVisualScale(fromNode, toNode);
+    const edgePath = buildEdgePath(
+      {
+        strokeWidth: interaction.strokeWidth,
+        route: interaction.route,
+        fromPoint: interaction.fromPoint,
+        toPoint: interaction.toPoint,
+        from: { port: fromPort },
+        to: { port: toPort }
+      },
+      fromNode,
+      toNode
+    );
+    const baseStroke = this.getEdgeStrokeWidth(interaction);
     return svgEl("path", {
       class: "vd-flowchart-preview-path",
       d: edgePath.d,
-      "stroke-width": this.getEdgeStrokeWidth(interaction)
+      "stroke-width": visual < 0.999 ? formatNumber(Math.max(0.02, baseStroke * visual)) : baseStroke
     });
   }
   renderNode(node) {
-    const selected = this.selection?.kind === "node" && this.selection.id === node.id;
-    const dragging = this.interaction?.kind === "drag-node" && this.interaction.nodeId === node.id;
+    const selected = this.isNodeSelected(node.id);
+    const soloSelected = selected && !this.hasMultiSelection();
+    const dragging = this.interaction?.kind === "drag-node" && this.interaction.nodeIds.includes(node.id);
     const resizing = this.interaction?.kind === "resize-node" && this.interaction.nodeId === node.id;
     const editing = this.textEditor?.nodeId === node.id;
     const group = svgEl("g", {
@@ -2684,24 +3822,45 @@ var VdFlowchart = class {
       "data-node-id": node.id
     });
     const portsVisible = this.shouldShowNodePorts(node);
+    const visual = nodeVisualScale(node);
+    const corner = node.type === "rounded-rect" || node.type === "textbox" ? 16 : node.type === "junction" ? node.width / 2 : 6;
     const hitbox = svgEl("rect", {
       x: 0,
       y: 0,
       width: node.width,
       height: node.height,
-      rx: node.type === "rounded-rect" || node.type === "textbox" ? 16 : node.type === "junction" ? node.width / 2 : 6,
+      rx: visual < 0.999 && node.type !== "junction" ? formatNumber(corner * visual) : corner,
       fill: "transparent",
       "data-node-id": node.id
     });
     group.appendChild(hitbox);
-    group.appendChild(this.renderNodeShape(node));
+    const shape = this.renderNodeShape(node);
+    this.applyScaledNodeShape(node, shape);
+    group.appendChild(shape);
     group.appendChild(this.renderNodeText(node));
-    if (selected && !this.readonly && isNodeResizable(node)) {
+    const scale = this.documentData.viewport.scale || 1;
+    if (soloSelected && !this.readonly && SELECTION_BOX_TYPES.has(node.type)) {
+      const outset = SELECTION_OUTSET / scale;
+      group.appendChild(
+        svgEl("rect", {
+          class: "vd-flowchart-selection-box",
+          x: -outset,
+          y: -outset,
+          width: node.width + outset * 2,
+          height: node.height + outset * 2
+        })
+      );
+    }
+    if (soloSelected && !this.readonly && isNodeResizable(node)) {
       group.appendChild(this.renderResizeControls(node));
     }
-    const scale = this.documentData.viewport.scale || 1;
+    const collapseToggle = this.renderCollapseToggle(node, soloSelected);
+    if (this.readonly) {
+      if (collapseToggle) group.appendChild(collapseToggle);
+      return group;
+    }
     FLOWCHART_PORTS.forEach((port) => {
-      const position = getPortPosition({ ...node, x: 0, y: 0 }, port);
+      const position = getPortHandlePosition({ ...node, x: 0, y: 0 }, port, scale);
       const portGroup = svgEl("g", {
         class: `vd-flowchart-port-group${portsVisible ? " is-visible" : ""}`,
         "data-node-id": node.id,
@@ -2723,15 +3882,68 @@ var VdFlowchart = class {
           r: CONNECTION_PORT_RADIUS / scale
         })
       );
+      const arm = (CONNECTION_PORT_RADIUS - 2.5) / scale;
+      portGroup.appendChild(
+        svgEl("path", {
+          class: "vd-flowchart-port-plus",
+          d: `M ${formatNumber(position.x - arm)} ${formatNumber(position.y)} H ${formatNumber(position.x + arm)} M ${formatNumber(position.x)} ${formatNumber(position.y - arm)} V ${formatNumber(position.y + arm)}`
+        })
+      );
       group.appendChild(portGroup);
     });
+    if (collapseToggle) group.appendChild(collapseToggle);
+    return group;
+  }
+  // "+N" on a collapsed node, or "−" on a single selected node with children,
+  // placed beyond the connection handle on the side its branch leaves from.
+  renderCollapseToggle(node, soloSelected) {
+    const outgoing = this.sceneOutgoing || this.getOutgoingMap();
+    const childIds = (outgoing.get(node.id) || []).filter((id) => id !== node.id);
+    if (!childIds.length) return null;
+    const count = node.collapsed ? this.countCollapsedDescendants(
+      node.id,
+      this.sceneHidden || this.getHiddenNodeIds(),
+      outgoing
+    ) : 0;
+    if (!node.collapsed && !(soloSelected && !this.readonly)) return null;
+    const sides = /* @__PURE__ */ new Map();
+    this.documentData.edges.forEach((edge) => {
+      if (edge.from.nodeId !== node.id || edge.to.nodeId === node.id) return;
+      sides.set(edge.from.port, (sides.get(edge.from.port) || 0) + 1);
+    });
+    const port = [...sides].sort((a, b) => b[1] - a[1])[0]?.[0] || DIRECTION_PORTS[this.getGrowthDirection(node)];
+    const scale = this.documentData.viewport.scale || 1;
+    const anchor = getPortPosition({ ...node, x: 0, y: 0 }, port);
+    const normal = getPortNormal(port);
+    const offset = COLLAPSE_TOGGLE_OFFSET / scale;
+    const cx = formatNumber(anchor.x + normal.x * offset);
+    const cy = formatNumber(anchor.y + normal.y * offset);
+    const label = node.collapsed ? `+${count}` : "\u2212";
+    const radius = (node.collapsed && label.length > 2 ? 12 : 9) / scale;
+    const group = svgEl("g", {
+      class: `vd-flowchart-collapse-toggle${node.collapsed ? " is-collapsed" : ""}`,
+      "data-collapse-toggle": node.id
+    });
+    const title = svgEl("title");
+    title.textContent = node.collapsed ? `Expand ${count} hidden nodes` : "Collapse branch";
+    group.appendChild(title);
+    group.appendChild(svgEl("circle", { cx, cy, r: formatNumber(radius) }));
+    const text = svgEl("text", {
+      x: cx,
+      y: cy,
+      "font-size": formatNumber(10 / scale),
+      "text-anchor": "middle",
+      "dominant-baseline": "central"
+    });
+    text.textContent = label;
+    group.appendChild(text);
     return group;
   }
   renderResizeControls(node) {
     const scale = this.documentData.viewport.scale || 1;
     const zone = 14 / scale;
     const cornerZone = 22 / scale;
-    const handleSize = 9 / scale;
+    const handleSize = RESIZE_HANDLE_SIZE / scale;
     const gap = RESIZE_PORT_GAP / scale;
     const group = svgEl("g", { class: "vd-flowchart-resize-controls" });
     const zones = {
@@ -2761,12 +3973,6 @@ var VdFlowchart = class {
     };
     RESIZE_HANDLES.forEach((handle) => {
       const zoneRect = zones[handle];
-      const position = getResizeHandlePosition(node, handle);
-      const dotOffset = 8 / scale;
-      if (handle.includes("e")) position.x += dotOffset;
-      if (handle.includes("w")) position.x -= dotOffset;
-      if (handle.includes("n")) position.y -= dotOffset;
-      if (handle.includes("s")) position.y += dotOffset;
       const cursor = getResizeCursor(handle);
       const zoneSegments = [];
       if (handle === "e" || handle === "w") {
@@ -2801,14 +4007,19 @@ var VdFlowchart = class {
         });
         group.appendChild(hit);
       });
+      if (handle.length === 1) return;
+      const position = getResizeHandlePosition(node, handle);
+      const outset = SELECTION_OUTSET / scale;
+      position.x += handle.includes("e") ? outset : -outset;
+      position.y += handle.includes("s") ? outset : -outset;
       const dot = svgEl("rect", {
         class: "vd-flowchart-resize-handle",
         x: position.x - handleSize / 2,
         y: position.y - handleSize / 2,
         width: handleSize,
         height: handleSize,
-        rx: handleSize / 3,
-        ry: handleSize / 3,
+        rx: handleSize / 5,
+        ry: handleSize / 5,
         "data-node-id": node.id,
         "data-resize-handle": handle,
         style: `cursor: ${cursor}`
@@ -2817,6 +4028,21 @@ var VdFlowchart = class {
     });
     return group;
   }
+  applyScaledNodeShape(node, shape) {
+    const visual = nodeVisualScale(node);
+    if (!shape || visual >= 0.999) return;
+    const baseStroke = node.type === "junction" ? 1.25 : 1.5;
+    shape.style.strokeWidth = String(formatNumber(Math.max(0.03, baseStroke * visual)));
+    if (node.type === "textbox") {
+      shape.style.strokeDasharray = `${formatNumber(8 * visual)} ${formatNumber(5 * visual)}`;
+    }
+    const baseRadius = node.type === "rounded-rect" ? 18 : node.type === "textbox" ? 14 : node.type === "rect" ? 2 : 0;
+    if (baseRadius > 0) {
+      const scaled = String(formatNumber(baseRadius * visual));
+      shape.setAttribute("rx", scaled);
+      shape.setAttribute("ry", scaled);
+    }
+  }
   renderNodeShape(node) {
     const baseClass = `vd-flowchart-node-shape vd-flowchart-node-shape--${node.type}`;
     if (node.type === "rounded-rect") {
@@ -2893,21 +4119,28 @@ var VdFlowchart = class {
     if (node.type === "junction" || !node.text) {
       return textElement;
     }
+    const visual = nodeVisualScale(node);
+    const metrics = getNodeFontMetrics(node);
+    const lineHeight = visual < 0.999 ? Math.max(0.06, metrics.lineHeight * visual) : metrics.lineHeight;
+    if (visual < 0.999) {
+      textElement.style.fontSize = `${formatNumber(Math.max(0.05, metrics.fontSize * visual))}px`;
+    }
+    const equivalentWidth = visual < 0.999 ? node.width / visual : node.width;
     if (node.type === "textbox") {
-      const lines2 = wrapText(node.text, estimateChars(node.width - 32));
-      const { lineHeight: lineHeight2 } = getNodeFontMetrics(node);
+      const lines2 = wrapText(node.text, estimateChars(equivalentWidth - 32));
+      const padX = visual < 0.999 ? formatNumber(16 * visual) : 16;
+      const startY2 = visual < 0.999 ? formatNumber(28 * visual) : 28;
       lines2.forEach((line, index) => {
         const span = svgEl("tspan", {
-          x: 16,
-          y: 28 + index * lineHeight2
+          x: padX,
+          y: visual < 0.999 ? formatNumber(startY2 + index * lineHeight) : startY2 + index * lineHeight
         });
         span.textContent = line;
         textElement.appendChild(span);
       });
       return textElement;
     }
-    const lines = wrapText(node.text, estimateChars(node.width));
-    const { lineHeight } = getNodeFontMetrics(node);
+    const lines = wrapText(node.text, estimateChars(equivalentWidth));
     const totalHeight = (lines.length - 1) * lineHeight;
     const startY = node.height / 2 - totalHeight / 2;
     textElement.setAttribute("text-anchor", "middle");
@@ -2915,7 +4148,7 @@ var VdFlowchart = class {
     lines.forEach((line, index) => {
       const span = svgEl("tspan", {
         x: node.width / 2,
-        y: startY + index * lineHeight,
+        y: visual < 0.999 ? formatNumber(startY + index * lineHeight) : startY + index * lineHeight,
         "text-anchor": "middle",
         "dominant-baseline": "middle"
       });
@@ -2937,6 +4170,16 @@ var VdFlowchart = class {
       );
       return;
     }
+    if (this.hasMultiSelection()) {
+      this.selectionMeta.textContent = `${this.selectedNodeIds.size} nodes selected`;
+      this.selectionFields.appendChild(
+        createElement("p", {
+          className: "vd-flowchart-selection-empty",
+          text: "Drag, nudge with Alt+Arrow, copy, duplicate, or delete them together."
+        })
+      );
+      return;
+    }
     if (this.selection.kind === "node") {
       const node = this.findNode(this.selection.id);
       if (!node) {
@@ -2957,12 +4200,12 @@ var VdFlowchart = class {
       textArea.setAttribute("data-field", "node-text");
       const widthInput = createElement("input", { value: node.width, type: "number" });
       widthInput.setAttribute("data-field", "node-width");
-      widthInput.setAttribute("min", String(MIN_NODE_SIZE));
-      widthInput.setAttribute("max", String(MAX_NODE_SIZE));
+      widthInput.setAttribute("min", String(this.minNodeSize));
+      widthInput.setAttribute("max", String(this.maxNodeSize));
       const heightInput = createElement("input", { value: node.height, type: "number" });
       heightInput.setAttribute("data-field", "node-height");
-      heightInput.setAttribute("min", String(MIN_NODE_SIZE));
-      heightInput.setAttribute("max", String(MAX_NODE_SIZE));
+      heightInput.setAttribute("min", String(this.minNodeSize));
+      heightInput.setAttribute("max", String(this.maxNodeSize));
       this.selectionFields.appendChild(createField("Type", typeSelect));
       if (isNodeTextEditable(node)) {
         this.selectionFields.appendChild(createField("Text", textArea));
@@ -3051,16 +4294,69 @@ var VdFlowchart = class {
   }
   select(selection) {
     const next = selection && selection.id && selection.kind ? { kind: selection.kind, id: selection.id } : null;
-    const previousKey = this.selection ? `${this.selection.kind}:${this.selection.id}` : "";
-    const nextKey = next ? `${next.kind}:${next.id}` : "";
-    this.selection = next;
-    if (previousKey !== nextKey) {
+    this.applySelection(next, next?.kind === "node" ? [next.id] : []);
+  }
+  // Single funnel for selection changes: `selection` is the primary item and
+  // `selectedNodeIds` every selected node (the primary one included).
+  applySelection(primary, nodeIds) {
+    const previousKey = this.getSelectionKey();
+    this.selection = primary;
+    this.selectedNodeIds = new Set(nodeIds);
+    if (primary?.kind === "node") this.selectedNodeIds.add(primary.id);
+    if (previousKey !== this.getSelectionKey()) {
+      this.edgeCycleAnchor = null;
       this.render({ scene: true, inspector: true, json: false });
-      this.emit("select", { selection: this.getSelectionSnapshot() });
+      this.emit("select", {
+        selection: this.getSelectionSnapshot(),
+        nodeIds: this.getSelectedNodeIds()
+      });
       return;
     }
     this.render({ scene: true, inspector: false, json: false });
   }
+  getSelectionKey() {
+    const primary = this.selection ? `${this.selection.kind}:${this.selection.id}` : "";
+    return `${primary}|${[...this.selectedNodeIds || []].sort().join(",")}`;
+  }
+  // Keep the set valid after mutations that bypass applySelection (undo,
+  // load, removal): drop missing nodes and keep the primary node in the set.
+  syncSelectedNodeIds() {
+    if (this.selection?.kind !== "node") {
+      this.selectedNodeIds = /* @__PURE__ */ new Set();
+      return;
+    }
+    const existing = new Set(this.documentData.nodes.map((node) => node.id));
+    const hidden = this.getHiddenNodeIds();
+    this.selectedNodeIds = new Set(
+      [...this.selectedNodeIds || []].filter((id) => existing.has(id) && !hidden.has(id))
+    );
+    this.selectedNodeIds.add(this.selection.id);
+  }
+  getSelectedNodeIds() {
+    return [...this.selectedNodeIds || []];
+  }
+  isNodeSelected(nodeId) {
+    return Boolean(this.selectedNodeIds?.has(nodeId));
+  }
+  hasMultiSelection() {
+    return (this.selectedNodeIds?.size || 0) > 1;
+  }
+  /** Select several nodes; `primary` (default: the last id) drives single-node UI. */
+  selectNodes(nodeIds, options = {}) {
+    const existing = new Set(this.documentData.nodes.map((node) => node.id));
+    const ids = [...new Set((nodeIds || []).map(sanitizeId))].filter((id) => existing.has(id));
+    const primaryId = ids.includes(options.primary) ? options.primary : ids[ids.length - 1];
+    this.applySelection(primaryId ? { kind: "node", id: primaryId } : null, ids);
+    return this;
+  }
+  toggleNodeSelection(nodeId) {
+    const ids = this.selection?.kind === "node" ? this.getSelectedNodeIds() : [];
+    if (ids.includes(nodeId)) {
+      const rest = ids.filter((id) => id !== nodeId);
+      return this.selectNodes(rest, { primary: rest[rest.length - 1] });
+    }
+    return this.selectNodes([...ids, nodeId], { primary: nodeId });
+  }
   selectNode(nodeId) {
     this.select({ kind: "node", id: sanitizeId(nodeId) });
     return this;
@@ -3081,6 +4377,69 @@ var VdFlowchart = class {
   findNode(nodeId) {
     return this.documentData.nodes.find((node) => node.id === nodeId) || null;
   }
+  getHiddenNodeIds() {
+    return computeHiddenNodeIds(this.documentData.nodes, this.documentData.edges);
+  }
+  getVisibleNodes() {
+    const hidden = this.getHiddenNodeIds();
+    return hidden.size ? this.documentData.nodes.filter((node) => !hidden.has(node.id)) : this.documentData.nodes;
+  }
+  isNodeHidden(nodeId) {
+    return this.getHiddenNodeIds().has(nodeId);
+  }
+  getOutgoingMap() {
+    const outgoing = /* @__PURE__ */ new Map();
+    this.documentData.edges.forEach((edge) => {
+      if (!outgoing.has(edge.from.nodeId)) outgoing.set(edge.from.nodeId, []);
+      outgoing.get(edge.from.nodeId).push(edge.to.nodeId);
+    });
+    return outgoing;
+  }
+  // Hidden nodes under one collapsed node (its "+N" count).
+  countCollapsedDescendants(nodeId, hidden = this.getHiddenNodeIds(), outgoing = this.getOutgoingMap()) {
+    const seen = /* @__PURE__ */ new Set();
+    const queue = [nodeId];
+    for (let index = 0; index < queue.length; index += 1) {
+      (outgoing.get(queue[index]) || []).forEach((childId) => {
+        if (seen.has(childId) || !hidden.has(childId)) return;
+        seen.add(childId);
+        queue.push(childId);
+      });
+    }
+    return seen.size;
+  }
+  setCollapsed(nodeId, collapsed) {
+    if (this.readonly) return false;
+    const node = this.findNode(sanitizeId(nodeId));
+    if (!node) return false;
+    const next = Boolean(collapsed);
+    if (Boolean(node.collapsed) === next) return false;
+    if (next && !this.getChildNodes(node.id).length) return false;
+    if (next) node.collapsed = true;
+    else delete node.collapsed;
+    if (this.selection?.kind === "node") {
+      const hidden = this.getHiddenNodeIds();
+      const visibleIds = this.getSelectedNodeIds().filter((id) => !hidden.has(id));
+      if (hidden.has(this.selection.id)) {
+        this.select({ kind: "node", id: node.id });
+      } else if (visibleIds.length !== this.selectedNodeIds.size) {
+        this.selectNodes(visibleIds, { primary: this.selection.id });
+      }
+    } else if (this.selection?.kind === "edge") {
+      const edge = this.findEdge(this.selection.id);
+      const hidden = this.getHiddenNodeIds();
+      if (edge && (hidden.has(edge.from.nodeId) || hidden.has(edge.to.nodeId))) {
+        this.select({ kind: "node", id: node.id });
+      }
+    }
+    this.render({ inspector: true, json: true });
+    this.emitChange("node:collapse", { node: deepClone(node) });
+    return true;
+  }
+  toggleCollapsed(nodeId) {
+    const node = this.findNode(sanitizeId(nodeId));
+    return node ? this.setCollapsed(node.id, !node.collapsed) : false;
+  }
   findEdge(edgeId) {
     return this.documentData.edges.find((edge) => edge.id === edgeId) || null;
   }
@@ -3091,7 +4450,8 @@ var VdFlowchart = class {
   }
   emitChange(reason, extra = {}) {
     if (this.historyEnabled && !this.isApplyingHistory) {
-      this.recordHistory(reason);
+      if (this.historyBatchDepth > 0) this.historyBatchDirty = true;
+      else this.recordHistory(reason);
     }
     this.syncJsonTextarea();
     this.emit("change", {
@@ -3135,7 +4495,9 @@ var VdFlowchart = class {
     const snapshot = this.toJSON();
     const targetKey = this.selection ? `${this.selection.kind}:${this.selection.id}` : "";
     const top = this.history[this.historyIndex];
-    const canCoalesce = Boolean(top) && this.historyIndex === this.history.length - 1 && COALESCING_REASONS.has(reason) && top.reason === reason && top.targetKey === targetKey;
+    const atTip = Boolean(top) && this.historyIndex === this.history.length - 1;
+    const namesInsertedNode = this.coalesceInsertedText && top?.reason === "node:insert" && reason === "node:update";
+    const canCoalesce = atTip && top.targetKey === targetKey && (namesInsertedNode || COALESCING_REASONS.has(reason) && top.reason === reason);
     if (canCoalesce) {
       top.snapshot = snapshot;
       return;
@@ -3157,8 +4519,8 @@ var VdFlowchart = class {
     this.reconnectEdgeId = null;
     const currentViewport = deepClone(this.documentData.viewport);
     const previousSelection = this.selection;
-    this.documentData = normalizeDocument(snapshot);
-    this.documentData.viewport = normalizeViewport(currentViewport);
+    this.documentData = normalizeDocument(snapshot, this.normalizationLimits());
+    this.documentData.viewport = normalizeViewport(currentViewport, this.scaleBounds());
     this.selection = this.resolvePreservedSelection(previousSelection, true);
     this.render();
     this.emitChange(reason);
@@ -3235,7 +4597,8 @@ var VdFlowchart = class {
         y: partialNode.y == null ? fallbackY : partialNode.y
       },
       this.documentData.nodes.length,
-      usedIds
+      usedIds,
+      this.nodeSizeBounds()
     );
     this.documentData.nodes.push(node);
     this.select({ kind: "node", id: node.id });
@@ -3251,19 +4614,180 @@ var VdFlowchart = class {
     const parent = this.findNode(sanitizeId(parentId));
     if (!parent) return null;
     const { direction = "right", distance, angle, edge: edgeOptions, ...nodeOptions } = options;
-    const node = this.addNode({
-      ...nodeOptions,
-      relativeTo: { node: parent.id, direction, distance, angle }
+    return this.batchHistory("node:add-child", () => {
+      const node = this.addNode({
+        ...nodeOptions,
+        relativeTo: { node: parent.id, direction, distance, angle }
+      });
+      const edge = this.addEdge({
+        from: parent.id,
+        to: node.id,
+        autoPort: true,
+        endMarker: "arrow",
+        ...isPlainObject(edgeOptions) ? edgeOptions : {}
+      });
+      this.select({ kind: "node", id: node.id });
+      return { node, edge };
     });
-    const edge = this.addEdge({
-      from: parent.id,
-      to: node.id,
-      autoPort: true,
-      endMarker: "arrow",
-      ...isPlainObject(edgeOptions) ? edgeOptions : {}
+  }
+  // Run `fn` with history recording suspended, then record a single entry for
+  // everything it changed (change events still fire for each mutation).
+  batchHistory(reason, fn) {
+    this.historyBatchDepth += 1;
+    let result;
+    try {
+      result = fn();
+    } finally {
+      this.historyBatchDepth -= 1;
+    }
+    if (this.historyBatchDepth === 0 && this.historyBatchDirty) {
+      this.historyBatchDirty = false;
+      if (this.historyEnabled && !this.isApplyingHistory) this.recordHistory(reason);
+    }
+    return result;
+  }
+  // Mind-map structure: a node's parent is the source of its first incoming
+  // edge; its children are the targets of its outgoing edges. The side a
+  // branch is on is the port its edge leaves the parent from, which is what
+  // the user sees (centre geometry is ambiguous for diagonal nodes).
+  getParentEdge(nodeId) {
+    return this.documentData.edges.find(
+      (edge) => edge.to.nodeId === nodeId && edge.from.nodeId !== nodeId
+    ) || null;
+  }
+  getParentNode(nodeId) {
+    const edge = this.getParentEdge(nodeId);
+    return edge ? this.findNode(edge.from.nodeId) : null;
+  }
+  getChildNodes(nodeId, direction = null) {
+    const port = direction ? DIRECTION_PORTS[direction] : null;
+    const ids = /* @__PURE__ */ new Set();
+    this.documentData.edges.forEach((edge) => {
+      if (edge.from.nodeId !== nodeId || edge.to.nodeId === nodeId) return;
+      if (!port || edge.from.port === port) ids.add(edge.to.nodeId);
+    });
+    return this.documentData.nodes.filter((node) => ids.has(node.id));
+  }
+  // Direction a branch grows from `node`: the side its parent edge leaves
+  // from, or the emptier horizontal side for a root.
+  getGrowthDirection(node) {
+    const parentEdge = this.getParentEdge(node.id);
+    if (parentEdge) return PORT_DIRECTIONS[parentEdge.from.port] || "right";
+    const right = this.getChildNodes(node.id, "right").length;
+    const left = this.getChildNodes(node.id, "left").length;
+    return left < right ? "left" : "right";
+  }
+  // Shape for a new branch node: copy a sibling when there is one, otherwise
+  // the parent's box shape, falling back to a rounded step.
+  getBranchTemplate(parent, sibling) {
+    const source = sibling || (["rounded-rect", "rect", "textbox"].includes(parent.type) ? parent : null) || null;
+    if (source) return { type: source.type, width: source.width, height: source.height };
+    const spec = DEFAULT_NODE_SPECS["rounded-rect"];
+    return { type: "rounded-rect", width: spec.width, height: spec.height };
+  }
+  /**
+   * Add a node connected from `parentId` on the `direction` side (default: the
+   * branch's growth direction), stacked after `anchorId` or the last sibling on
+   * that side. The node and its edge are one undo step; the new edge copies a
+   * sibling's (or the parent's incoming) edge style. With `edit: true` the
+   * label editor opens with the text selected.
+   */
+  insertBranchNode(parentId, options = {}) {
+    if (this.readonly) return null;
+    const parent = this.findNode(sanitizeId(parentId));
+    if (!parent) return null;
+    const direction = DIRECTION_PORTS[options.direction] ? options.direction : this.getGrowthDirection(parent);
+    const siblings = this.getChildNodes(parent.id, direction);
+    const anchor = options.anchorId ? this.findNode(sanitizeId(options.anchorId)) : null;
+    const lastSibling = siblings[siblings.length - 1] || null;
+    const template = this.getBranchTemplate(parent, anchor || lastSibling);
+    const position = placeBranchNode({
+      nodes: this.documentData.nodes,
+      parent,
+      siblings,
+      direction,
+      size: template,
+      anchor,
+      before: Boolean(options.before)
+    });
+    const styleSource = this.documentData.edges.find(
+      (edge) => edge.from.nodeId === parent.id && edge.to.nodeId === (anchor || lastSibling)?.id
+    ) || this.documentData.edges.find((edge) => edge.to.nodeId === parent.id);
+    const edgeStyle = styleSource ? {
+      route: styleSource.route,
+      strokeWidth: styleSource.strokeWidth,
+      startMarker: styleSource.startMarker,
+      endMarker: styleSource.endMarker
+    } : { endMarker: "arrow" };
+    const result = this.batchHistory("node:insert", () => {
+      if (parent.collapsed) delete parent.collapsed;
+      const node = this.addNode({ ...template, x: position.x, y: position.y });
+      const edge = this.addEdge({
+        from: { nodeId: parent.id, port: DIRECTION_PORTS[direction] },
+        to: { nodeId: node.id, port: DIRECTION_PORTS[oppositeDirection(direction)] },
+        ...edgeStyle
+      });
+      if (edge && anchor) this.placeEdgeBySibling(edge.id, parent.id, anchor.id, options.before);
+      if (this.autoLayout && this.layoutMode !== "grid") this.layout(this.layoutMode);
+      this.select({ kind: "node", id: node.id });
+      return { node, edge };
+    });
+    this.revealNode(result.node.id);
+    if (options.edit) this.startTextEdit(result.node.id, { inserted: true });
+    return result;
+  }
+  // Tree and radial layouts order children by connection order, so a sibling's
+  // connection goes right after (or before) its anchor's instead of last.
+  placeEdgeBySibling(edgeId, parentId, anchorId, before = false) {
+    const edges = this.documentData.edges;
+    const fromIndex = edges.findIndex((edge) => edge.id === edgeId);
+    if (fromIndex === -1) return;
+    const [moved] = edges.splice(fromIndex, 1);
+    const anchorIndex = edges.findIndex(
+      (edge) => edge.from.nodeId === parentId && edge.to.nodeId === anchorId
+    );
+    if (anchorIndex === -1) edges.push(moved);
+    else edges.splice(before ? anchorIndex : anchorIndex + 1, 0, moved);
+  }
+  // Insert a sibling after (or before) `nodeId`; a node without a parent gets a
+  // child instead, which is what Enter on a mind-map root means.
+  insertSiblingNode(nodeId, options = {}) {
+    if (this.readonly) return null;
+    const node = this.findNode(sanitizeId(nodeId));
+    if (!node) return null;
+    const parentEdge = this.getParentEdge(node.id);
+    const parent = parentEdge ? this.findNode(parentEdge.from.nodeId) : null;
+    if (!parent) return this.insertBranchNode(node.id, { edit: options.edit });
+    return this.insertBranchNode(parent.id, {
+      direction: PORT_DIRECTIONS[parentEdge.from.port],
+      anchorId: node.id,
+      before: Boolean(options.before),
+      edit: options.edit
     });
-    this.select({ kind: "node", id: node.id });
-    return { node, edge };
+  }
+  // Pan just enough to bring a node fully into view (with a small margin).
+  revealNode(nodeId) {
+    const node = this.findNode(nodeId);
+    const width = this.canvasEl.clientWidth;
+    const height = this.canvasEl.clientHeight;
+    if (!node || !width || !height) return;
+    const viewport = this.documentData.viewport;
+    const margin = 32;
+    const left = viewport.x + node.x * viewport.scale;
+    const top = viewport.y + node.y * viewport.scale;
+    const right = left + node.width * viewport.scale;
+    const bottom = top + node.height * viewport.scale;
+    let dx = 0;
+    let dy = 0;
+    if (right > width - margin) dx = width - margin - right;
+    if (left + dx < margin) dx = margin - left;
+    if (bottom > height - margin) dy = height - margin - bottom;
+    if (top + dy < margin) dy = margin - top;
+    if (!dx && !dy) return;
+    viewport.x = formatNumber(viewport.x + dx);
+    viewport.y = formatNumber(viewport.y + dy);
+    this.render({ inspector: false, json: true });
+    this.emitViewportChange("viewport:pan");
   }
   // Arrange nodes with a built-in layout. Positions are computed by the pure
   // computeLayout() module, then applied in place (NOT via load(), which would
@@ -3327,8 +4851,8 @@ var VdFlowchart = class {
     node.x = patch.x == null ? node.x : formatNumber(toFiniteNumber(patch.x, node.x));
     node.y = patch.y == null ? node.y : formatNumber(toFiniteNumber(patch.y, node.y));
     node.text = isNodeTextEditable(nextType) ? patch.text == null ? node.text : String(patch.text) : getNodeSpec(nextType).text;
-    node.width = clampNodeWidth(nextType, patch.width, node.width);
-    node.height = clampNodeHeight(nextType, patch.height, node.height);
+    node.width = clampNodeWidth(nextType, patch.width, node.width, this.nodeSizeBounds());
+    node.height = clampNodeHeight(nextType, patch.height, node.height, this.nodeSizeBounds());
     if (isPlainObject(patch.data)) {
       node.data = deepClone(patch.data);
     }
@@ -3511,11 +5035,51 @@ var VdFlowchart = class {
   }
   deleteSelection() {
     if (!this.selection || this.readonly) return false;
+    if (this.hasMultiSelection()) {
+      return this.removeNodeIds(new Set(this.getSelectedNodeIds()), "node:remove");
+    }
     if (this.selection.kind === "node") return this.removeNode(this.selection.id);
     return this.removeEdge(this.selection.id);
   }
+  nodeSizeBounds() {
+    return { min: this.minNodeSize, max: this.maxNodeSize };
+  }
+  scaleBounds() {
+    return { min: this.minScale, max: this.maxScale };
+  }
+  normalizationLimits() {
+    return { scaleBounds: this.scaleBounds(), sizeBounds: this.nodeSizeBounds() };
+  }
+  hasWideCamera() {
+    return this.minScale < DEFAULT_MIN_SCALE || this.maxScale > DEFAULT_MAX_SCALE;
+  }
+  syncGrid() {
+    const wide = this.hasWideCamera();
+    const extent = wide ? WIDE_WORLD_EXTENT : DEFAULT_WORLD_EXTENT;
+    this.gridRect?.setAttribute("x", String(-extent / 2));
+    this.gridRect?.setAttribute("y", String(-extent / 2));
+    this.gridRect?.setAttribute("width", String(extent));
+    this.gridRect?.setAttribute("height", String(extent));
+    const pattern = this.svg?.querySelector("pattern");
+    const path = pattern?.querySelector("path");
+    if (!pattern || !path) return;
+    let tile = this.gridSize;
+    if (wide) {
+      const scale = Math.max(this.minScale, this.documentData?.viewport?.scale || 1);
+      while (tile * scale < 12 && tile < extent / 8) tile *= 4;
+      while (tile * scale > 48 && tile > 1.5) tile /= 4;
+      tile = formatNumber(tile);
+      path.setAttribute("vector-effect", "non-scaling-stroke");
+    } else {
+      path.removeAttribute("vector-effect");
+    }
+    path.setAttribute("stroke-width", "1");
+    pattern.setAttribute("width", String(tile));
+    pattern.setAttribute("height", String(tile));
+    path.setAttribute("d", `M ${tile} 0 L 0 0 0 ${tile}`);
+  }
   setViewport(viewport) {
-    this.documentData.viewport = normalizeViewport(viewport);
+    this.documentData.viewport = normalizeViewport(viewport, this.scaleBounds());
     this.render({ inspector: false, json: true });
     this.emitViewportChange("viewport:set");
     return this;
@@ -3533,45 +5097,80 @@ var VdFlowchart = class {
     return this;
   }
   resetView() {
-    this.documentData.viewport = normalizeViewport({ x: 0, y: 0, scale: 1 });
+    this.documentData.viewport = normalizeViewport({ x: 0, y: 0, scale: 1 }, this.scaleBounds());
     this.render({ inspector: false, json: true });
     this.emitViewportChange("viewport:reset");
     return this;
   }
   fitView() {
-    if (!this.documentData.nodes.length) {
+    const nodes = this.getVisibleNodes();
+    if (!nodes.length) {
       return this.resetView();
     }
-    const bounds = getBounds(this.documentData.nodes);
+    const bounds = getBounds(nodes);
     const width = this.canvasEl.clientWidth || 800;
     const height = this.canvasEl.clientHeight || 560;
     const padding = 80;
     const contentWidth = Math.max(1, bounds.right - bounds.left);
     const contentHeight = Math.max(1, bounds.bottom - bounds.top);
-    const scale = clamp(
-      Math.min((width - padding * 2) / contentWidth, (height - padding * 2) / contentHeight),
-      MIN_SCALE,
-      MAX_SCALE
+    const scale = formatScale(
+      clamp(
+        Math.min((width - padding * 2) / contentWidth, (height - padding * 2) / contentHeight),
+        this.minScale,
+        this.maxScale
+      )
     );
     this.documentData.viewport = {
       x: formatNumber(width / 2 - (bounds.left + bounds.right) / 2 * scale),
       y: formatNumber(height / 2 - (bounds.top + bounds.bottom) / 2 * scale),
-      scale: formatNumber(scale)
+      scale
     };
     this.render({ inspector: false, json: true });
     this.emitViewportChange("viewport:fit");
     return this;
   }
+  fitNode(nodeId, padding = 48) {
+    const node = this.findNode(nodeId);
+    if (!node || this.isNodeHidden(node.id)) return this;
+    const pad = Math.max(0, toFiniteNumber(padding, 48));
+    const width = this.canvasEl.clientWidth || 800;
+    const height = this.canvasEl.clientHeight || 560;
+    const availableWidth = Math.max(1, width - pad * 2);
+    const availableHeight = Math.max(1, height - pad * 2);
+    const scale = formatScale(
+      clamp(
+        Math.min(
+          availableWidth / Math.max(1, node.width),
+          availableHeight / Math.max(1, node.height)
+        ),
+        this.minScale,
+        this.maxScale
+      )
+    );
+    const centerX = node.x + node.width / 2;
+    const centerY = node.y + node.height / 2;
+    this.documentData.viewport = {
+      x: formatNumber(width / 2 - centerX * scale),
+      y: formatNumber(height / 2 - centerY * scale),
+      scale
+    };
+    this.render({ inspector: false, json: true });
+    this.emitViewportChange("viewport:fit-node");
+    return this;
+  }
   clear() {
     this.stopTextEdit({ commit: false });
     this.activeTool = null;
     this.reconnectEdgeId = null;
     this.clipboard = null;
-    this.documentData = normalizeDocument({
-      nodes: [],
-      edges: [],
-      viewport: { x: 0, y: 0, scale: 1 }
-    });
+    this.documentData = normalizeDocument(
+      {
+        nodes: [],
+        edges: [],
+        viewport: { x: 0, y: 0, scale: 1 }
+      },
+      this.normalizationLimits()
+    );
     this.selection = null;
     this.render();
     this.emitChange("clear");
@@ -3600,6 +5199,41 @@ var VdFlowchart = class {
       pattern.querySelector("path").setAttribute("d", `M ${this.gridSize} 0 L 0 0 0 ${this.gridSize}`);
     }
     if ("autoFit" in options) this.autoFit = Boolean(options.autoFit);
+    if ("keyboardShortcuts" in options) {
+      this.keyboardShortcuts = normalizeKeyboardShortcuts(options.keyboardShortcuts);
+    }
+    if ("snapGuides" in options) this.snapGuides = options.snapGuides !== false;
+    if ("minimap" in options) this.setMinimapEnabled(options.minimap !== false);
+    if ("autoLayout" in options) this.autoLayout = Boolean(options.autoLayout);
+    if ("minScale" in options || "maxScale" in options || "minNodeSize" in options || "maxNodeSize" in options) {
+      const nextScale = normalizeBoundPair(
+        "minScale" in options ? options.minScale : this.minScale,
+        "maxScale" in options ? options.maxScale : this.maxScale,
+        DEFAULT_MIN_SCALE,
+        DEFAULT_MAX_SCALE
+      );
+      const nextSize = normalizeBoundPair(
+        "minNodeSize" in options ? options.minNodeSize : this.minNodeSize,
+        "maxNodeSize" in options ? options.maxNodeSize : this.maxNodeSize,
+        DEFAULT_MIN_NODE_SIZE,
+        DEFAULT_MAX_NODE_SIZE
+      );
+      this.minScale = nextScale.min;
+      this.maxScale = nextScale.max;
+      this.minNodeSize = nextSize.min;
+      this.maxNodeSize = nextSize.max;
+      const clamped = clamp(
+        formatScale(this.documentData.viewport.scale),
+        this.minScale,
+        this.maxScale
+      );
+      if (clamped !== this.documentData.viewport.scale) {
+        this.documentData.viewport.scale = clamped;
+        this.pendingBoundsEvent = true;
+      }
+    }
+    this.syncCanvasLabel();
+    if (this.shortcutsHelpOpen) this.renderShortcutsHelp();
     if ("history" in options && options.history !== false !== this.historyEnabled) {
       this.historyEnabled = options.history !== false;
       this.history = [];
@@ -3615,11 +5249,15 @@ var VdFlowchart = class {
       }
     }
     this.render();
+    if (this.pendingBoundsEvent) {
+      this.pendingBoundsEvent = false;
+      this.emitViewportChange("viewport:bounds");
+    }
     this.updateHistoryButtons();
     return this;
   }
   load(data, options = {}) {
-    const documentData = normalizeDocument(data);
+    const documentData = normalizeDocument(data, this.normalizationLimits());
     if (options.silent && JSON.stringify(documentData) === JSON.stringify(this.documentData)) {
       return this;
     }
@@ -3648,6 +5286,10 @@ var VdFlowchart = class {
   destroy() {
     if (this.destroyed) return;
     this.destroyed = true;
+    if (this.minimapFrame && typeof cancelAnimationFrame === "function") {
+      cancelAnimationFrame(this.minimapFrame);
+    }
+    this.minimapFrame = 0;
     this.activeTool = null;
     this.stopTextEdit({ commit: false });
     this.resizeObserver?.disconnect();
@@ -3664,6 +5306,21 @@ var VdFlowchart = class {
 
 // src/vue.js
 var FORWARDED_EVENTS = ["change", "select", "viewport", "connect", "ready"];
+var EDITOR_OPTION_KEYS = [
+  "readonly",
+  "gridSize",
+  "autoFit",
+  "history",
+  "historyLimit",
+  "keyboardShortcuts",
+  "snapGuides",
+  "minimap",
+  "autoLayout",
+  "minScale",
+  "maxScale",
+  "minNodeSize",
+  "maxNodeSize"
+];
 var VdFlowchart2 = (0, import_vue.defineComponent)({
   name: "VdFlowchart",
   props: {
@@ -3680,21 +5337,42 @@ var VdFlowchart2 = (0, import_vue.defineComponent)({
     /** Enable the built-in undo/redo history (default true). */
     history: { type: Boolean, default: true },
     /** Maximum number of history entries to retain. */
-    historyLimit: { type: Number, default: void 0 }
+    historyLimit: { type: Number, default: void 0 },
+    /** Keyboard model: 'mindmap' (Tab child, Enter sibling) or 'basic'. */
+    keyboardShortcuts: { type: String, default: "mindmap" },
+    /** Snap dragged nodes to other nodes' edges and centres (default true). */
+    snapGuides: { type: Boolean, default: true },
+    /** Show the overview minimap in the canvas corner (default true). */
+    minimap: { type: Boolean, default: true },
+    /** Re-run the current layout after keyboard or handle insertions (default false). */
+    autoLayout: { type: Boolean, default: false },
+    /** Lowest camera scale. Defaults to 0.35. Set it together with maxScale. */
+    minScale: { type: Number, default: void 0 },
+    /** Highest camera scale. Defaults to 3. Set it together with minScale. */
+    maxScale: { type: Number, default: void 0 },
+    /** Smallest resizable-node side. Defaults to 56. Set it together with maxNodeSize. */
+    minNodeSize: { type: Number, default: void 0 },
+    /** Largest resizable-node side. Defaults to 420. Set it together with minNodeSize. */
+    maxNodeSize: { type: Number, default: void 0 }
   },
   emits: ["change", "select", "viewport", "connect", "ready"],
   setup(props, { emit, expose }) {
     const el = (0, import_vue.ref)(null);
     let instance = null;
+    const editorOptions = () => Object.fromEntries(
+      EDITOR_OPTION_KEYS.flatMap((key) => {
+        const value = props[key];
+        if ((key === "minScale" || key === "maxScale" || key === "minNodeSize" || key === "maxNodeSize") && value == null) {
+          return [];
+        }
+        return [[key, value]];
+      })
+    );
     const create = () => {
       instance = new VdFlowchart({
         element: el.value,
         data: props.data,
-        readonly: props.readonly,
-        gridSize: props.gridSize,
-        autoFit: props.autoFit,
-        history: props.history,
-        historyLimit: props.historyLimit
+        ...editorOptions()
       });
       FORWARDED_EVENTS.forEach((name) => {
         instance.on(name, (payload) => emit(name, payload));
@@ -3714,16 +5392,9 @@ var VdFlowchart2 = (0, import_vue.defineComponent)({
       { deep: true }
     );
     (0, import_vue.watch)(
-      () => [props.readonly, props.gridSize, props.autoFit, props.history, props.historyLimit],
+      () => EDITOR_OPTION_KEYS.map((key) => props[key]),
       () => {
-        if (!instance) return;
-        instance.updateOptions({
-          readonly: props.readonly,
-          gridSize: props.gridSize,
-          autoFit: props.autoFit,
-          history: props.history,
-          historyLimit: props.historyLimit
-        });
+        if (instance) instance.updateOptions(editorOptions());
       }
     );
     (0, import_vue.onBeforeUnmount)(() => {
@@ -3738,7 +5409,8 @@ var VdFlowchart2 = (0, import_vue.defineComponent)({
       redo: () => instance?.redo(),
       canUndo: () => Boolean(instance?.canUndo()),
       canRedo: () => Boolean(instance?.canRedo()),
-      layout: (mode, options) => instance?.layout(mode, options)
+      layout: (mode, options) => instance?.layout(mode, options),
+      fitNode: (nodeId, padding) => instance?.fitNode(nodeId, padding)
     });
     return () => (0, import_vue.h)("div", { ref: el, class: "vd-flowchart" });
   }