@vanduo-oss/vd3-cbun 1.0.0

package/dist/flowchart/index.cjs

@@ -0,0 +1,3447 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/flowchart/index.js
+var index_exports = {};
+__export(index_exports, {
+  FLOWCHART_EDGE_MARKERS: () => FLOWCHART_EDGE_MARKERS,
+  FLOWCHART_EDGE_ROUTES: () => FLOWCHART_EDGE_ROUTES,
+  FLOWCHART_NODE_TYPES: () => FLOWCHART_NODE_TYPES,
+  FLOWCHART_PORTS: () => FLOWCHART_PORTS,
+  LAYOUT_MODES: () => LAYOUT_MODES,
+  VD_FLOWCHART_VERSION: () => VD_FLOWCHART_VERSION,
+  VdFlowchart: () => VdFlowchart2,
+  VdFlowchartCore: () => VdFlowchart,
+  computeLayout: () => computeLayout
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/flowchart/vue.js
+var import_vue = require("vue");
+
+// src/flowchart/layout.js
+var DIRECTIONS = {
+  right: { main: "x", sign: 1 },
+  left: { main: "x", sign: -1 },
+  down: { main: "y", sign: 1 },
+  up: { main: "y", sign: -1 }
+};
+function num(value, fallback) {
+  const next = Number(value);
+  return Number.isFinite(next) ? next : fallback;
+}
+function buildGraph(nodes, edges) {
+  const byId = new Map(nodes.map((node) => [node.id, node]));
+  const children = new Map(nodes.map((node) => [node.id, []]));
+  const indegree = new Map(nodes.map((node) => [node.id, 0]));
+  edges.forEach((edge) => {
+    const from = edge?.from?.nodeId;
+    const to = edge?.to?.nodeId;
+    if (from === to || !byId.has(from) || !byId.has(to)) return;
+    children.get(from).push(to);
+    indegree.set(to, indegree.get(to) + 1);
+  });
+  return { byId, children, indegree };
+}
+function pickRoots(nodes, indegree, optRoot) {
+  if (optRoot && indegree.has(optRoot)) return [optRoot];
+  const roots = nodes.filter((node) => indegree.get(node.id) === 0).map((node) => node.id);
+  return roots.length ? roots : nodes.length ? [nodes[0].id] : [];
+}
+function spanningForest(allIds, roots, children) {
+  const visited = /* @__PURE__ */ new Set();
+  const depth = /* @__PURE__ */ new Map();
+  const tree = /* @__PURE__ */ new Map();
+  const forestRoots = [];
+  const walk = (id, d) => {
+    visited.add(id);
+    depth.set(id, d);
+    const kids = [];
+    (children.get(id) || []).forEach((child) => {
+      if (!visited.has(child)) {
+        kids.push(child);
+        walk(child, d + 1);
+      }
+    });
+    tree.set(id, kids);
+  };
+  roots.forEach((root) => {
+    if (!visited.has(root)) {
+      forestRoots.push(root);
+      walk(root, 0);
+    }
+  });
+  allIds.forEach((id) => {
+    if (!visited.has(id)) {
+      forestRoots.push(id);
+      walk(id, 0);
+    }
+  });
+  return { depth, tree, forestRoots };
+}
+function treeCenters(forestRoots, tree, depth, sizeOf, options) {
+  const dir = DIRECTIONS[options.direction] || DIRECTIONS.right;
+  const levelGap = num(options.levelGap, 220);
+  const siblingGap = num(options.siblingGap, 140);
+  const crossOf = /* @__PURE__ */ new Map();
+  let cursor = 0;
+  const place = (id) => {
+    const kids = tree.get(id) || [];
+    if (!kids.length) {
+      crossOf.set(id, cursor);
+      cursor += siblingGap;
+      return crossOf.get(id);
+    }
+    const childCenters = kids.map(place);
+    const center = (childCenters[0] + childCenters[childCenters.length - 1]) / 2;
+    crossOf.set(id, center);
+    return center;
+  };
+  forestRoots.forEach((root) => {
+    place(root);
+    cursor += siblingGap;
+  });
+  const centers = /* @__PURE__ */ new Map();
+  crossOf.forEach((cross, id) => {
+    const main = (depth.get(id) || 0) * levelGap * dir.sign;
+    centers.set(
+      id,
+      dir.main === "x" ? { centerX: main, centerY: cross } : { centerX: cross, centerY: main }
+    );
+  });
+  return centers;
+}
+function radialCenters(forestRoots, tree, depth, options) {
+  const ringGap = num(options.radius, 220);
+  const leaves = [];
+  const collect = (id) => {
+    const kids = tree.get(id) || [];
+    if (!kids.length) leaves.push(id);
+    else kids.forEach(collect);
+  };
+  forestRoots.forEach(collect);
+  const total = Math.max(1, leaves.length);
+  const leafAngle = new Map(leaves.map((id, index) => [id, (index + 0.5) / total * Math.PI * 2]));
+  const angleOf = /* @__PURE__ */ new Map();
+  const resolveAngle = (id) => {
+    const kids = tree.get(id) || [];
+    if (!kids.length) {
+      angleOf.set(id, leafAngle.get(id));
+      return angleOf.get(id);
+    }
+    const childAngles = kids.map(resolveAngle);
+    const mean = childAngles.reduce((sum, value) => sum + value, 0) / childAngles.length;
+    angleOf.set(id, mean);
+    return mean;
+  };
+  forestRoots.forEach(resolveAngle);
+  const centers = /* @__PURE__ */ new Map();
+  angleOf.forEach((angle, id) => {
+    const radius = (depth.get(id) || 0) * ringGap;
+    centers.set(id, { centerX: Math.cos(angle) * radius, centerY: Math.sin(angle) * radius });
+  });
+  return centers;
+}
+function gridCenters(nodes, sizeOf, options) {
+  const gap = num(options.gap, 48);
+  const columns = Math.max(
+    1,
+    Math.floor(num(options.columns, Math.ceil(Math.sqrt(nodes.length || 1))))
+  );
+  let cellW = 0;
+  let cellH = 0;
+  nodes.forEach((node) => {
+    const size = sizeOf(node.id);
+    cellW = Math.max(cellW, size.width);
+    cellH = Math.max(cellH, size.height);
+  });
+  cellW += gap;
+  cellH += gap;
+  const sorted = [...nodes].sort((a, b) => a.y - b.y || a.x - b.x);
+  const centers = /* @__PURE__ */ new Map();
+  sorted.forEach((node, index) => {
+    const col = index % columns;
+    const row = Math.floor(index / columns);
+    centers.set(node.id, { centerX: col * cellW, centerY: row * cellH });
+  });
+  return centers;
+}
+function computeLayout(documentData, mode = "tree", options = {}) {
+  const nodes = Array.isArray(documentData?.nodes) ? documentData.nodes : [];
+  const edges = Array.isArray(documentData?.edges) ? documentData.edges : [];
+  if (!nodes.length) return /* @__PURE__ */ new Map();
+  const { byId, children, indegree } = buildGraph(nodes, edges);
+  const sizeOf = (id) => {
+    const node = byId.get(id);
+    return { width: num(node?.width, 160), height: num(node?.height, 96) };
+  };
+  const allIds = nodes.map((node) => node.id);
+  let centers;
+  let anchorId = nodes[0].id;
+  if (mode === "grid") {
+    centers = gridCenters(nodes, sizeOf, options);
+  } else {
+    const rootOpt = options.root == null ? null : String(options.root).trim();
+    const roots = pickRoots(nodes, indegree, rootOpt);
+    anchorId = roots[0] || anchorId;
+    const { depth, tree, forestRoots } = spanningForest(allIds, roots, children);
+    centers = mode === "radial" ? radialCenters(forestRoots, tree, depth, options) : treeCenters(forestRoots, tree, depth, sizeOf, options);
+  }
+  const anchorNode = byId.get(anchorId);
+  const anchorCenter = centers.get(anchorId) || { centerX: 0, centerY: 0 };
+  const dx = anchorNode ? anchorNode.x + anchorNode.width / 2 - anchorCenter.centerX : 0;
+  const dy = anchorNode ? anchorNode.y + anchorNode.height / 2 - anchorCenter.centerY : 0;
+  const result = /* @__PURE__ */ new Map();
+  centers.forEach((center, id) => {
+    const size = sizeOf(id);
+    result.set(id, {
+      x: Math.round((center.centerX + dx - size.width / 2) * 100) / 100,
+      y: Math.round((center.centerY + dy - size.height / 2) * 100) / 100
+    });
+  });
+  return result;
+}
+var LAYOUT_MODES = ["tree", "radial", "grid"];
+
+// src/flowchart/core.js
+var SVG_NS = "http://www.w3.org/2000/svg";
+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 RESIZE_HANDLES = ["n", "ne", "e", "se", "s", "sw", "w", "nw"];
+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 CONNECTION_PORT_HIT_RADIUS = 14;
+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 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.2.0";
+var FLOWCHART_NODE_TYPES = [
+  "rounded-rect",
+  "rect",
+  "diamond",
+  "circle",
+  "textbox",
+  "label",
+  "junction"
+];
+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 DEFAULT_EDGE_ROUTE = "curve";
+var ORTHOGONAL_STUB_LENGTH = 32;
+var ORTHOGONAL_CORNER_RADIUS = 12;
+var ORTHOGONAL_CLEARANCE = 16;
+var EDGE_CURVATURE = 0.5;
+var MIN_CURVE_ARM = 22;
+var MAX_CURVE_ARM = 260;
+var FLOWCHART_EDGE_ROUTE_LABELS = {
+  curve: "Curve",
+  straight: "Straight",
+  orthogonal: "Stepped orthogonal"
+};
+var DEFAULT_NODE_SPECS = {
+  "rounded-rect": { width: 180, height: 96, text: "Step" },
+  rect: { width: 180, height: 96, text: "Process" },
+  diamond: { width: 184, height: 120, text: "Decision" },
+  circle: { width: 128, height: 128, text: "Start" },
+  textbox: { width: 240, height: 144, text: "Notes" },
+  label: { width: 180, height: 72, text: "Label" },
+  junction: {
+    width: 28,
+    height: 28,
+    text: "",
+    minWidth: 28,
+    minHeight: 28,
+    maxWidth: 28,
+    maxHeight: 28,
+    resizable: false,
+    textEditable: false
+  }
+};
+var FLOWCHART_PALETTE_ITEMS = [
+  { kind: "tool", tool: "arrow", label: "arrow" },
+  { kind: "node", type: "rounded-rect", label: "rounded rect" },
+  { kind: "node", type: "rect", label: "rect" },
+  { kind: "node", type: "diamond", label: "diamond" },
+  { kind: "node", type: "circle", label: "circle" },
+  { kind: "node", type: "junction", label: "junction" },
+  { kind: "node", type: "textbox", label: "textbox" },
+  { kind: "node", type: "label", label: "label" }
+];
+var flowchartId = 0;
+function nextId(prefix) {
+  flowchartId += 1;
+  return `${prefix}-${flowchartId}`;
+}
+function hasWindow() {
+  return typeof window !== "undefined" && typeof document !== "undefined";
+}
+function isElement(value) {
+  return hasWindow() && value instanceof Element;
+}
+function isPlainObject(value) {
+  return Boolean(value) && Object.prototype.toString.call(value) === "[object Object]";
+}
+function clamp(value, min, max) {
+  return Math.min(max, Math.max(min, value));
+}
+function toFiniteNumber(value, fallback) {
+  const next = Number(value);
+  return Number.isFinite(next) ? next : fallback;
+}
+function deepClone(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+function formatNumber(value) {
+  return Number(value.toFixed(2));
+}
+function sanitizeId(value) {
+  if (value == null) return "";
+  return String(value).trim();
+}
+function resolveElement(target) {
+  if (!hasWindow()) {
+    throw new Error("Vanduo Flowchart requires a browser DOM target.");
+  }
+  if (typeof target === "string") {
+    const el = document.querySelector(target);
+    if (!el) throw new Error(`Flowchart target not found: ${target}`);
+    return el;
+  }
+  if (isElement(target)) return target;
+  throw new Error("Flowchart target must be an Element or selector string.");
+}
+function createElement(tagName, options = {}) {
+  const element = document.createElement(tagName);
+  if (options.className) element.className = options.className;
+  if (options.text != null) element.textContent = String(options.text);
+  if (options.type) element.type = options.type;
+  if (options.value != null) element.value = String(options.value);
+  if (options.placeholder != null) element.placeholder = String(options.placeholder);
+  if (options.title != null) element.title = String(options.title);
+  if (options.rows != null) element.rows = Number(options.rows);
+  if (options.disabled) element.disabled = true;
+  if (options.tabIndex != null) element.tabIndex = Number(options.tabIndex);
+  return element;
+}
+function svgEl(name, attrs = {}) {
+  const element = document.createElementNS(SVG_NS, name);
+  Object.entries(attrs).forEach(([key, value]) => {
+    if (value != null) {
+      element.setAttribute(key, String(value));
+    }
+  });
+  return element;
+}
+function clearChildren(element) {
+  while (element.firstChild) {
+    element.removeChild(element.firstChild);
+  }
+}
+function ensureUniqueId(preferred, prefix, usedIds) {
+  let candidate = sanitizeId(preferred) || nextId(prefix);
+  while (usedIds.has(candidate)) {
+    candidate = nextId(prefix);
+  }
+  usedIds.add(candidate);
+  return candidate;
+}
+function normalizeNodeType(type) {
+  return FLOWCHART_NODE_TYPES.includes(type) ? type : "rounded-rect";
+}
+function getNodeSpec(type) {
+  return DEFAULT_NODE_SPECS[normalizeNodeType(type)];
+}
+function getNodeSizeBounds(type) {
+  const spec = getNodeSpec(type);
+  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
+  };
+}
+function clampNodeWidth(type, width, fallback) {
+  const bounds = getNodeSizeBounds(type);
+  return clamp(toFiniteNumber(width, fallback), bounds.minWidth, bounds.maxWidth);
+}
+function clampNodeHeight(type, height, fallback) {
+  const bounds = getNodeSizeBounds(type);
+  return clamp(toFiniteNumber(height, fallback), bounds.minHeight, bounds.maxHeight);
+}
+function isNodeResizable(nodeOrType) {
+  const spec = typeof nodeOrType === "string" ? getNodeSpec(nodeOrType) : getNodeSpec(nodeOrType?.type);
+  return spec.resizable !== false;
+}
+function isNodeTextEditable(nodeOrType) {
+  const spec = typeof nodeOrType === "string" ? getNodeSpec(nodeOrType) : getNodeSpec(nodeOrType?.type);
+  return spec.textEditable !== false;
+}
+function normalizeEdgeStrokeWidth(value) {
+  const next = Number(value);
+  if (!Number.isFinite(next)) return DEFAULT_EDGE_STROKE_WIDTH;
+  return formatNumber(clamp(next, MIN_EDGE_STROKE_WIDTH, MAX_EDGE_STROKE_WIDTH));
+}
+function getStrokePresetId(strokeWidth) {
+  const match = EDGE_STROKE_PRESETS.find((preset) => Math.abs(preset.width - strokeWidth) < 0.01);
+  return match?.id || "medium";
+}
+function getStrokePresetWidth(presetId) {
+  const preset = EDGE_STROKE_PRESETS.find((item) => item.id === presetId);
+  return preset?.width ?? DEFAULT_EDGE_STROKE_WIDTH;
+}
+function normalizeViewport(viewport) {
+  return {
+    x: toFiniteNumber(viewport?.x, 0),
+    y: toFiniteNumber(viewport?.y, 0),
+    scale: clamp(toFiniteNumber(viewport?.scale, 1), MIN_SCALE, MAX_SCALE)
+  };
+}
+function normalizeNode(rawNode, index, usedIds) {
+  const type = normalizeNodeType(rawNode?.type);
+  const spec = getNodeSpec(type);
+  return {
+    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),
+    text: rawNode?.text == null ? spec.text : String(rawNode.text),
+    data: isPlainObject(rawNode?.data) ? deepClone(rawNode.data) : {}
+  };
+}
+function normalizeEndpoint(rawEndpoint, fallbackPort) {
+  return {
+    nodeId: sanitizeId(rawEndpoint?.nodeId),
+    port: FLOWCHART_PORTS.includes(rawEndpoint?.port) ? rawEndpoint.port : fallbackPort
+  };
+}
+function normalizeEdgeMarker(value) {
+  return FLOWCHART_EDGE_MARKERS.includes(value) ? value : null;
+}
+function normalizeEdgeRoute(value) {
+  return FLOWCHART_EDGE_ROUTES.includes(value) ? value : DEFAULT_EDGE_ROUTE;
+}
+function syncEdgeKind(edge) {
+  edge.kind = edge.startMarker === "none" && edge.endMarker === "none" ? "line" : "arrow";
+}
+function normalizeEdge(rawEdge, index, nodeIds, usedIds) {
+  const from = normalizeEndpoint(rawEdge?.from, "right");
+  const to = normalizeEndpoint(rawEdge?.to, "left");
+  if (!from.nodeId || !to.nodeId) return null;
+  if (!nodeIds.has(from.nodeId) || !nodeIds.has(to.nodeId)) return null;
+  if (!FLOWCHART_PORTS.includes(from.port) || !FLOWCHART_PORTS.includes(to.port)) return null;
+  const legacyKind = rawEdge?.kind === "line" ? "line" : "arrow";
+  const startMarker = normalizeEdgeMarker(rawEdge?.startMarker) ?? (legacyKind === "line" ? "none" : "none");
+  const endMarker = normalizeEdgeMarker(rawEdge?.endMarker) ?? (legacyKind === "line" ? "none" : "arrow");
+  const edge = {
+    id: ensureUniqueId(rawEdge?.id, "edge", usedIds),
+    from,
+    to,
+    kind: legacyKind,
+    startMarker,
+    endMarker,
+    strokeWidth: normalizeEdgeStrokeWidth(rawEdge?.strokeWidth),
+    route: normalizeEdgeRoute(rawEdge?.route),
+    label: rawEdge?.label == null ? "" : String(rawEdge.label),
+    data: isPlainObject(rawEdge?.data) ? deepClone(rawEdge.data) : {}
+  };
+  syncEdgeKind(edge);
+  return edge;
+}
+function normalizeDocument(input) {
+  let source = input;
+  if (typeof source === "string") {
+    try {
+      source = JSON.parse(source);
+    } catch {
+      source = {};
+    }
+  }
+  if (!isPlainObject(source)) {
+    source = {};
+  }
+  const usedNodeIds = /* @__PURE__ */ new Set();
+  const nodes = (Array.isArray(source.nodes) ? source.nodes : []).map(
+    (node, index) => normalizeNode(node, index, usedNodeIds)
+  );
+  const nodeIds = new Set(nodes.map((node) => node.id));
+  const usedEdgeIds = /* @__PURE__ */ new Set();
+  const edges = (Array.isArray(source.edges) ? source.edges : []).map((edge, index) => normalizeEdge(edge, index, nodeIds, usedEdgeIds)).filter(Boolean);
+  return {
+    version: VD_FLOWCHART_VERSION,
+    viewport: normalizeViewport(source.viewport),
+    nodes,
+    edges
+  };
+}
+function splitLongToken(token, maxChars) {
+  const result = [];
+  let index = 0;
+  while (index < token.length) {
+    result.push(token.slice(index, index + maxChars));
+    index += maxChars;
+  }
+  return result;
+}
+function wrapText(text, maxChars) {
+  const safeMaxChars = Math.max(6, maxChars);
+  const lines = [];
+  String(text || "").split(/\r?\n/).forEach((paragraph) => {
+    const trimmed = paragraph.trim();
+    if (!trimmed) {
+      lines.push("");
+      return;
+    }
+    let current = "";
+    trimmed.split(/\s+/).forEach((word) => {
+      if (word.length > safeMaxChars) {
+        if (current) {
+          lines.push(current);
+          current = "";
+        }
+        splitLongToken(word, safeMaxChars).forEach((chunk) => lines.push(chunk));
+        return;
+      }
+      const next = current ? `${current} ${word}` : word;
+      if (next.length <= safeMaxChars) {
+        current = next;
+        return;
+      }
+      if (current) lines.push(current);
+      current = word;
+    });
+    if (current) lines.push(current);
+  });
+  if (!lines.length) return [""];
+  if (lines.length <= 6) return lines;
+  const clipped = lines.slice(0, 6);
+  clipped[5] = clipped[5].length > safeMaxChars - 3 ? `${clipped[5].slice(0, safeMaxChars - 3)}...` : `${clipped[5]}...`;
+  return clipped;
+}
+function estimateChars(width) {
+  return Math.max(8, Math.floor((width - 24) / 7));
+}
+function getPortPosition(node, port) {
+  switch (port) {
+    case "top":
+      return { x: node.x + node.width / 2, y: node.y };
+    case "right":
+      return { x: node.x + node.width, y: node.y + node.height / 2 };
+    case "bottom":
+      return { x: node.x + node.width / 2, y: node.y + node.height };
+    case "left":
+    default:
+      return { x: node.x, y: node.y + node.height / 2 };
+  }
+}
+function getNearestPort(node, point) {
+  return FLOWCHART_PORTS.reduce((best, port) => {
+    const portPoint = getPortPosition(node, port);
+    const distance = Math.hypot(point.x - portPoint.x, point.y - portPoint.y);
+    if (!best || distance < best.distance) {
+      return { port, point: portPoint, distance };
+    }
+    return best;
+  }, null);
+}
+function getPortNormal(port) {
+  switch (port) {
+    case "top":
+      return { x: 0, y: -1 };
+    case "right":
+      return { x: 1, y: 0 };
+    case "bottom":
+      return { x: 0, y: 1 };
+    case "left":
+    default:
+      return { x: -1, y: 0 };
+  }
+}
+function isPointInsideNode(node, point) {
+  return point.x >= node.x && point.x <= node.x + node.width && point.y >= node.y && point.y <= node.y + node.height;
+}
+function getPortByDirection(node, point) {
+  const centerX = node.x + node.width / 2;
+  const centerY = node.y + node.height / 2;
+  const deltaX = point.x - centerX;
+  const deltaY = point.y - centerY;
+  const port = Math.abs(deltaX) > Math.abs(deltaY) ? deltaX > 0 ? "right" : "left" : deltaY > 0 ? "bottom" : "top";
+  const portPoint = getPortPosition(node, port);
+  return {
+    port,
+    point: portPoint,
+    distance: Math.hypot(point.x - portPoint.x, point.y - portPoint.y)
+  };
+}
+function pickPortForNode(node, point, referencePoint = null) {
+  if (isPointInsideNode(node, point)) {
+    const centerX = node.x + node.width / 2;
+    const centerY = node.y + node.height / 2;
+    const distanceFromCenter = Math.hypot(point.x - centerX, point.y - centerY);
+    if (referencePoint && distanceFromCenter <= CONNECTION_CENTER_LOCK_RADIUS) {
+      return getPortByDirection(node, referencePoint);
+    }
+    return getPortByDirection(node, point);
+  }
+  return getNearestPort(node, point);
+}
+function getDistanceToNodeBounds(node, point) {
+  const left = node.x;
+  const right = node.x + node.width;
+  const top = node.y;
+  const bottom = node.y + node.height;
+  const dx = point.x < left ? left - point.x : point.x > right ? point.x - right : 0;
+  const dy = point.y < top ? top - point.y : point.y > bottom ? point.y - bottom : 0;
+  return Math.hypot(dx, dy);
+}
+function offsetPoint(point, normal, distance) {
+  return {
+    x: point.x + normal.x * distance,
+    y: point.y + normal.y * distance
+  };
+}
+function isHorizontalPort(port) {
+  return port === "left" || port === "right";
+}
+function addDistinctPoint(points, point) {
+  const previous = points[points.length - 1];
+  if (!previous || previous.x !== point.x || previous.y !== point.y) {
+    points.push(point);
+  }
+}
+function buildPathFromPoints(points) {
+  return points.map((point, index) => {
+    const command = index === 0 ? "M" : "L";
+    return `${command} ${formatNumber(point.x)} ${formatNumber(point.y)}`;
+  }).join(" ");
+}
+function buildRoundedPath(points, radius) {
+  if (points.length < 3 || radius <= 0) {
+    return buildPathFromPoints(points);
+  }
+  let d = `M ${formatNumber(points[0].x)} ${formatNumber(points[0].y)}`;
+  for (let index = 1; index < points.length - 1; index += 1) {
+    const prev = points[index - 1];
+    const corner = points[index];
+    const next = points[index + 1];
+    const lenIn = Math.hypot(corner.x - prev.x, corner.y - prev.y);
+    const lenOut = Math.hypot(next.x - corner.x, next.y - corner.y);
+    const r = Math.min(radius, lenIn / 2, lenOut / 2);
+    if (!(r > 0)) {
+      d += ` L ${formatNumber(corner.x)} ${formatNumber(corner.y)}`;
+      continue;
+    }
+    const approach = {
+      x: corner.x - (corner.x - prev.x) / lenIn * r,
+      y: corner.y - (corner.y - prev.y) / lenIn * r
+    };
+    const departure = {
+      x: corner.x + (next.x - corner.x) / lenOut * r,
+      y: corner.y + (next.y - corner.y) / lenOut * r
+    };
+    d += ` L ${formatNumber(approach.x)} ${formatNumber(approach.y)}`;
+    d += ` Q ${formatNumber(corner.x)} ${formatNumber(corner.y)} ${formatNumber(departure.x)} ${formatNumber(departure.y)}`;
+  }
+  const last = points[points.length - 1];
+  d += ` L ${formatNumber(last.x)} ${formatNumber(last.y)}`;
+  return d;
+}
+function getPolylineLabelPoint(points) {
+  let totalLength = 0;
+  for (let index = 1; index < points.length; index += 1) {
+    totalLength += Math.hypot(
+      points[index].x - points[index - 1].x,
+      points[index].y - points[index - 1].y
+    );
+  }
+  if (!totalLength) {
+    const first = points[0] || { x: 0, y: 0 };
+    return { x: formatNumber(first.x), y: formatNumber(first.y) };
+  }
+  const halfway = totalLength / 2;
+  let covered = 0;
+  for (let index = 1; index < points.length; index += 1) {
+    const start = points[index - 1];
+    const end = points[index];
+    const segmentLength = Math.hypot(end.x - start.x, end.y - start.y);
+    if (!segmentLength) continue;
+    if (covered + segmentLength >= halfway) {
+      const ratio = (halfway - covered) / segmentLength;
+      return {
+        x: formatNumber(start.x + (end.x - start.x) * ratio),
+        y: formatNumber(start.y + (end.y - start.y) * ratio)
+      };
+    }
+    covered += segmentLength;
+  }
+  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) {
+  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);
+  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);
+  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 {
+    d: `M ${formatNumber(fromPoint.x)} ${formatNumber(fromPoint.y)} C ${formatNumber(controlA.x)} ${formatNumber(controlA.y)} ${formatNumber(controlB.x)} ${formatNumber(controlB.y)} ${formatNumber(toPoint.x)} ${formatNumber(toPoint.y)}`,
+    labelX: formatNumber(labelX),
+    labelY: formatNumber(labelY)
+  };
+}
+function buildStraightPath(fromPoint, toPoint) {
+  return {
+    d: buildPathFromPoints([fromPoint, toPoint]),
+    labelX: formatNumber((fromPoint.x + toPoint.x) / 2),
+    labelY: formatNumber((fromPoint.y + toPoint.y) / 2)
+  };
+}
+function getNodeRectBounds(node, pad = 0) {
+  if (!node) return null;
+  return {
+    left: node.x - pad,
+    top: node.y - pad,
+    right: node.x + node.width + pad,
+    bottom: node.y + node.height + pad
+  };
+}
+function segmentIntersectsRect(a, b, rect) {
+  if (!rect) return false;
+  const minX = Math.min(a.x, b.x);
+  const maxX = Math.max(a.x, b.x);
+  const minY = Math.min(a.y, b.y);
+  const maxY = Math.max(a.y, b.y);
+  return minX < rect.right && maxX > rect.left && minY < rect.bottom && maxY > rect.top;
+}
+function pickOrthogonalChannel(from, to, low, high) {
+  const costLow = Math.abs(low - from) + Math.abs(low - to);
+  const costHigh = Math.abs(high - from) + Math.abs(high - to);
+  if (costLow < costHigh) return low;
+  if (costHigh < costLow) return high;
+  return to >= from ? high : low;
+}
+function getOrthogonalMidpoints(fromStub, toStub, fromPort, toPort) {
+  const sourceHorizontal = isHorizontalPort(fromPort);
+  const targetHorizontal = isHorizontalPort(toPort);
+  if (sourceHorizontal && targetHorizontal) {
+    const midX = (fromStub.x + toStub.x) / 2;
+    return [
+      { x: midX, y: fromStub.y },
+      { x: midX, y: toStub.y }
+    ];
+  }
+  if (!sourceHorizontal && !targetHorizontal) {
+    const midY = (fromStub.y + toStub.y) / 2;
+    return [
+      { x: fromStub.x, y: midY },
+      { x: toStub.x, y: midY }
+    ];
+  }
+  if (sourceHorizontal) {
+    return [{ x: toStub.x, y: fromStub.y }];
+  }
+  return [{ x: fromStub.x, y: toStub.y }];
+}
+function getOrthogonalPoints(fromPoint, toPoint, fromPort, toPort, fromRect, toRect) {
+  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 sourceHorizontal = isHorizontalPort(fromPort);
+  const targetHorizontal = isHorizontalPort(toPort);
+  const mids = [];
+  if (sourceHorizontal && targetHorizontal) {
+    const facing = fromNormal.x === -toNormal.x;
+    const hasRoom = fromNormal.x > 0 ? fromStub.x <= toStub.x : fromStub.x >= toStub.x;
+    if (facing && hasRoom) {
+      const midX = (fromStub.x + toStub.x) / 2;
+      mids.push({ x: midX, y: fromStub.y }, { x: midX, y: toStub.y });
+    } else {
+      const top = Math.min(fromRect.top, toRect.top);
+      const bottom = Math.max(fromRect.bottom, toRect.bottom);
+      const yChannel = pickOrthogonalChannel(fromStub.y, toStub.y, top, bottom);
+      mids.push({ x: fromStub.x, y: yChannel }, { x: toStub.x, y: yChannel });
+    }
+  } else if (!sourceHorizontal && !targetHorizontal) {
+    const facing = fromNormal.y === -toNormal.y;
+    const hasRoom = fromNormal.y > 0 ? fromStub.y <= toStub.y : fromStub.y >= toStub.y;
+    if (facing && hasRoom) {
+      const midY = (fromStub.y + toStub.y) / 2;
+      mids.push({ x: fromStub.x, y: midY }, { x: toStub.x, y: midY });
+    } else {
+      const left = Math.min(fromRect.left, toRect.left);
+      const right = Math.max(fromRect.right, toRect.right);
+      const xChannel = pickOrthogonalChannel(fromStub.x, toStub.x, left, right);
+      mids.push({ x: xChannel, y: fromStub.y }, { x: xChannel, y: toStub.y });
+    }
+  } else {
+    const cleanCorner = sourceHorizontal ? { x: toStub.x, y: fromStub.y } : { x: fromStub.x, y: toStub.y };
+    const altCorner = sourceHorizontal ? { x: fromStub.x, y: toStub.y } : { x: toStub.x, y: fromStub.y };
+    const legsClear = (corner) => !segmentIntersectsRect(fromStub, corner, fromRect) && !segmentIntersectsRect(fromStub, corner, toRect) && !segmentIntersectsRect(corner, toStub, fromRect) && !segmentIntersectsRect(corner, toStub, toRect);
+    mids.push(legsClear(cleanCorner) || !legsClear(altCorner) ? cleanCorner : altCorner);
+  }
+  const points = [];
+  [fromPoint, fromStub, ...mids, toStub, toPoint].forEach(
+    (point) => addDistinctPoint(points, point)
+  );
+  return points;
+}
+function buildOrthogonalPath(fromPoint, toPoint, fromPort = "right", toPort = "left", fromRect = null, toRect = null) {
+  let points;
+  if (fromRect && toRect) {
+    points = getOrthogonalPoints(fromPoint, toPoint, fromPort, toPort, fromRect, toRect);
+  } else {
+    const fromStub = offsetPoint(fromPoint, getPortNormal(fromPort), ORTHOGONAL_STUB_LENGTH);
+    const toStub = offsetPoint(toPoint, getPortNormal(toPort), ORTHOGONAL_STUB_LENGTH);
+    points = [];
+    [
+      fromPoint,
+      fromStub,
+      ...getOrthogonalMidpoints(fromStub, toStub, fromPort, toPort),
+      toStub,
+      toPoint
+    ].forEach((point) => addDistinctPoint(points, point));
+  }
+  const label = getPolylineLabelPoint(points);
+  return {
+    d: buildRoundedPath(points, ORTHOGONAL_CORNER_RADIUS),
+    labelX: label.x,
+    labelY: label.y
+  };
+}
+function buildEdgePath(edge, fromNode = null, toNode = null) {
+  const fromPort = edge?.from?.port || edge?.fromPort || "right";
+  const toPort = edge?.to?.port || edge?.toPort || "left";
+  const fromPoint = edge?.fromPoint || (fromNode ? getPortPosition(fromNode, fromPort) : null);
+  const toPoint = edge?.toPoint || (toNode ? getPortPosition(toNode, toPort) : null);
+  const route = normalizeEdgeRoute(edge?.route);
+  if (!fromPoint || !toPoint) {
+    return { d: "", labelX: 0, labelY: 0 };
+  }
+  if (route === "straight") {
+    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);
+  }
+  return buildCurvePath(fromPoint, toPoint, fromPort, toPort);
+}
+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));
+  const marker = svgEl("marker", {
+    id,
+    markerWidth: size,
+    markerHeight: size,
+    refX: reversed ? refInset : formatNumber(size - refInset),
+    refY: formatNumber(size / 2),
+    orient: "auto",
+    markerUnits: "userSpaceOnUse"
+  });
+  marker.appendChild(
+    svgEl("path", {
+      d: reversed ? `M ${formatNumber(size)} 0 L 0 ${formatNumber(size / 2)} L ${formatNumber(size)} ${formatNumber(size)} z` : `M 0 0 L ${formatNumber(size)} ${formatNumber(size / 2)} L 0 ${formatNumber(size)} z`,
+      fill: "var(--vd-flowchart-accent)"
+    })
+  );
+  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));
+  const marker = svgEl("marker", {
+    id,
+    markerWidth: size,
+    markerHeight: size,
+    refX: formatNumber(size / 2),
+    refY: formatNumber(size / 2),
+    orient: "auto",
+    markerUnits: "userSpaceOnUse"
+  });
+  marker.appendChild(
+    svgEl("circle", {
+      cx: formatNumber(size / 2),
+      cy: formatNumber(size / 2),
+      r: radius,
+      fill: "var(--vd-flowchart-accent)"
+    })
+  );
+  return marker;
+}
+function getNodeFontMetrics(node) {
+  if (node.type === "label") {
+    return { fontSize: 18, lineHeight: 20 };
+  }
+  if (node.type === "textbox") {
+    return { fontSize: 13, lineHeight: 18 };
+  }
+  return { fontSize: 14, lineHeight: 18 };
+}
+function getResizeHandlePosition(node, handle) {
+  const middleX = node.width / 2;
+  const middleY = node.height / 2;
+  const x = handle.includes("w") ? 0 : handle.includes("e") ? node.width : middleX;
+  const y = handle.includes("n") ? 0 : handle.includes("s") ? node.height : middleY;
+  return { x, y };
+}
+function getResizeCursor(handle) {
+  if (handle === "n" || handle === "s") return "ns-resize";
+  if (handle === "e" || handle === "w") return "ew-resize";
+  if (handle === "ne" || handle === "sw") return "nesw-resize";
+  return "nwse-resize";
+}
+function getBounds(nodes) {
+  if (!nodes.length) {
+    return { left: 0, top: 0, right: 0, bottom: 0 };
+  }
+  return nodes.reduce(
+    (accumulator, node) => ({
+      left: Math.min(accumulator.left, node.x),
+      top: Math.min(accumulator.top, node.y),
+      right: Math.max(accumulator.right, node.x + node.width),
+      bottom: Math.max(accumulator.bottom, node.y + node.height)
+    }),
+    {
+      left: Number.POSITIVE_INFINITY,
+      top: Number.POSITIVE_INFINITY,
+      right: Number.NEGATIVE_INFINITY,
+      bottom: Number.NEGATIVE_INFINITY
+    }
+  );
+}
+function createField(labelText, control) {
+  const wrapper = createElement("div", { className: "vd-flowchart-field" });
+  const label = createElement("label", { text: labelText });
+  wrapper.appendChild(label);
+  wrapper.appendChild(control);
+  return wrapper;
+}
+function createPalettePreview(type) {
+  const preview = svgEl("svg", {
+    class: `vd-flowchart-palette-preview vd-flowchart-palette-preview--${type}`,
+    viewBox: "0 0 72 44",
+    "aria-hidden": "true",
+    focusable: "false"
+  });
+  const baseClass = `vd-flowchart-palette-shape vd-flowchart-palette-shape--${type}`;
+  if (type === "arrow") {
+    preview.appendChild(
+      svgEl("path", {
+        class: "vd-flowchart-palette-arrow",
+        d: "M 12 30 C 28 10 44 10 60 22"
+      })
+    );
+    preview.appendChild(
+      svgEl("path", {
+        class: "vd-flowchart-palette-arrowhead",
+        d: "M 53 16 L 64 22 L 52 27 z"
+      })
+    );
+    return preview;
+  }
+  if (type === "rounded-rect") {
+    preview.appendChild(
+      svgEl("rect", {
+        class: baseClass,
+        x: 10,
+        y: 10,
+        width: 52,
+        height: 24,
+        rx: 8,
+        ry: 8
+      })
+    );
+    return preview;
+  }
+  if (type === "rect") {
+    preview.appendChild(
+      svgEl("rect", {
+        class: baseClass,
+        x: 10,
+        y: 10,
+        width: 52,
+        height: 24,
+        rx: 1,
+        ry: 1
+      })
+    );
+    return preview;
+  }
+  if (type === "diamond") {
+    preview.appendChild(
+      svgEl("polygon", {
+        class: baseClass,
+        points: "36,6 64,22 36,38 8,22"
+      })
+    );
+    return preview;
+  }
+  if (type === "circle") {
+    preview.appendChild(
+      svgEl("ellipse", {
+        class: baseClass,
+        cx: 36,
+        cy: 22,
+        rx: 18,
+        ry: 18
+      })
+    );
+    return preview;
+  }
+  if (type === "junction") {
+    preview.appendChild(
+      svgEl("path", {
+        class: "vd-flowchart-palette-junction-lines",
+        d: "M 12 22 H 27 M 45 22 H 60 M 36 8 V 14 M 36 30 V 36"
+      })
+    );
+    preview.appendChild(
+      svgEl("circle", {
+        class: baseClass,
+        cx: 36,
+        cy: 22,
+        r: 8
+      })
+    );
+    return preview;
+  }
+  if (type === "textbox") {
+    preview.appendChild(
+      svgEl("rect", {
+        class: baseClass,
+        x: 10,
+        y: 8,
+        width: 52,
+        height: 28,
+        rx: 6,
+        ry: 6
+      })
+    );
+    preview.appendChild(
+      svgEl("path", {
+        class: "vd-flowchart-palette-lines",
+        d: "M 20 18 H 52 M 20 25 H 46"
+      })
+    );
+    return preview;
+  }
+  const label = svgEl("text", {
+    class: "vd-flowchart-palette-label-mark",
+    x: 36,
+    y: 24,
+    "text-anchor": "middle",
+    "dominant-baseline": "middle"
+  });
+  label.textContent = "Aa";
+  preview.appendChild(label);
+  return preview;
+}
+var VdFlowchart = class {
+  constructor(options = {}) {
+    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 || {});
+    this.listeners = {};
+    this.selection = null;
+    this.interaction = null;
+    this.activeTool = null;
+    this.paletteSerial = 0;
+    this.destroyed = false;
+    this.lastNodePointer = null;
+    this.reconnectEdgeId = null;
+    this.clipboard = null;
+    this.gridPatternId = nextId("flowchart-grid");
+    this.markerIds = /* @__PURE__ */ new Map();
+    this.textEditor = null;
+    this.historyEnabled = options.history !== false;
+    this.historyLimit = Math.max(1, Math.floor(toFiniteNumber(options.historyLimit, 100)));
+    this.history = [];
+    this.historyIndex = -1;
+    this.isApplyingHistory = false;
+    this.autoFit = Boolean(options.autoFit);
+    this.readyEmitted = false;
+    this.resizeObserver = null;
+    this.handleToolbarClick = this.handleToolbarClick.bind(this);
+    this.handleArrangeChange = this.handleArrangeChange.bind(this);
+    this.handlePaletteClick = this.handlePaletteClick.bind(this);
+    this.handlePointerDown = this.handlePointerDown.bind(this);
+    this.handlePointerMove = this.handlePointerMove.bind(this);
+    this.handlePointerUp = this.handlePointerUp.bind(this);
+    this.handleClick = this.handleClick.bind(this);
+    this.handleDoubleClick = this.handleDoubleClick.bind(this);
+    this.handleWheel = this.handleWheel.bind(this);
+    this.handleKeyDown = this.handleKeyDown.bind(this);
+    this.handleSelectionFieldInput = this.handleSelectionFieldInput.bind(this);
+    this.handleSelectionFieldChange = this.handleSelectionFieldChange.bind(this);
+    this.handleJsonActionClick = this.handleJsonActionClick.bind(this);
+    this.handleResize = this.handleResize.bind(this);
+    this.buildShell();
+    this.bindEvents();
+    this.render();
+    this.seedHistory();
+    this.updateHistoryButtons();
+    this.scheduleReady();
+  }
+  // --- Readiness -----------------------------------------------------------
+  // The editor builds synchronously, but fitView() needs real canvas
+  // dimensions, which only exist after the host is laid out. Emit `ready` once
+  // the canvas reports a non-zero size (the old code fell back to an 800x560
+  // guess); consumers can then fitView() without nextTick/setTimeout. The emit
+  // is always deferred at least a microtask so a listener attached right after
+  // construction — e.g. `new VdFlowchart(...).on('ready', ...)` or the Vue
+  // wrapper — is registered before it fires.
+  scheduleReady() {
+    if (this.readyEmitted || this.destroyed || !hasWindow()) return;
+    const tryEmit = () => {
+      if (this.readyEmitted || this.destroyed) return true;
+      const ready = this.canvasEl.clientWidth > 0 && this.canvasEl.clientHeight > 0;
+      if (!ready) return false;
+      this.readyEmitted = true;
+      if (this.autoFit) this.fitView();
+      this.emit("ready", this);
+      return true;
+    };
+    const startObserving = () => {
+      if (this.readyEmitted || this.destroyed || tryEmit()) return;
+      if (typeof ResizeObserver === "function") {
+        this.resizeObserver = new ResizeObserver(() => {
+          if (tryEmit()) {
+            this.resizeObserver?.disconnect();
+            this.resizeObserver = null;
+          }
+        });
+        this.resizeObserver.observe(this.canvasEl);
+      }
+      const raf = typeof requestAnimationFrame === "function" ? requestAnimationFrame : (cb) => setTimeout(cb, 16);
+      raf(() => tryEmit());
+    };
+    if (typeof queueMicrotask === "function") {
+      queueMicrotask(startObserving);
+    } else {
+      Promise.resolve().then(startObserving);
+    }
+  }
+  buildShell() {
+    this.element.innerHTML = "";
+    this.element.classList.add("vd-flowchart-host");
+    this.root = createElement("div", {
+      className: `vd-flowchart-shell${this.readonly ? " vd-flowchart-readonly" : ""}`
+    });
+    this.toolbar = createElement("div", { className: "vd-flowchart-toolbar" });
+    const toolbarLeft = createElement("div", { className: "vd-flowchart-toolbar-group" });
+    const toolbarRight = createElement("div", { className: "vd-flowchart-toolbar-group" });
+    this.zoomOutButton = createElement("button", { className: "vd-flowchart-btn", text: "-" });
+    this.zoomOutButton.setAttribute("data-flowchart-action", "zoom-out");
+    this.zoomOutButton.setAttribute("type", "button");
+    this.zoomInButton = createElement("button", { className: "vd-flowchart-btn", text: "+" });
+    this.zoomInButton.setAttribute("data-flowchart-action", "zoom-in");
+    this.zoomInButton.setAttribute("type", "button");
+    this.resetViewButton = createElement("button", {
+      className: "vd-flowchart-btn",
+      text: "Reset"
+    });
+    this.resetViewButton.setAttribute("data-flowchart-action", "reset-view");
+    this.resetViewButton.setAttribute("type", "button");
+    this.fitViewButton = createElement("button", { className: "vd-flowchart-btn", text: "Fit" });
+    this.fitViewButton.setAttribute("data-flowchart-action", "fit-view");
+    this.fitViewButton.setAttribute("type", "button");
+    this.undoButton = createElement("button", {
+      className: "vd-flowchart-btn",
+      text: "\u21B6",
+      title: "Undo",
+      disabled: true
+    });
+    this.undoButton.setAttribute("data-flowchart-action", "undo");
+    this.undoButton.setAttribute("type", "button");
+    this.undoButton.setAttribute("aria-label", "Undo");
+    this.redoButton = createElement("button", {
+      className: "vd-flowchart-btn",
+      text: "\u21B7",
+      title: "Redo",
+      disabled: true
+    });
+    this.redoButton.setAttribute("data-flowchart-action", "redo");
+    this.redoButton.setAttribute("type", "button");
+    this.redoButton.setAttribute("aria-label", "Redo");
+    this.arrangeSelect = createElement("select", {
+      className: "vd-flowchart-btn vd-flowchart-arrange",
+      disabled: this.readonly
+    });
+    this.arrangeSelect.setAttribute("aria-label", "Auto-arrange layout");
+    this.arrangeSelect.setAttribute("data-flowchart-arrange", "");
+    [
+      { value: "", label: "Arrange \u25BE" },
+      { value: "tree", label: "Tree" },
+      { value: "radial", label: "Radial" },
+      { value: "grid", label: "Grid" }
+    ].forEach((item, index) => {
+      const option = createElement("option", { value: item.value, text: item.label });
+      option.value = item.value;
+      if (index === 0) option.disabled = true;
+      this.arrangeSelect.appendChild(option);
+    });
+    this.arrangeSelect.selectedIndex = 0;
+    this.clearButton = createElement("button", {
+      className: "vd-flowchart-btn",
+      text: "Clear",
+      disabled: this.readonly
+    });
+    this.clearButton.setAttribute("data-flowchart-action", "clear");
+    this.clearButton.setAttribute("type", "button");
+    this.zoomLabel = createElement("span", {
+      className: "vd-flowchart-toolbar-label",
+      text: "100%"
+    });
+    toolbarLeft.appendChild(this.zoomOutButton);
+    toolbarLeft.appendChild(this.zoomInButton);
+    toolbarLeft.appendChild(this.resetViewButton);
+    toolbarLeft.appendChild(this.fitViewButton);
+    toolbarLeft.appendChild(this.undoButton);
+    toolbarLeft.appendChild(this.redoButton);
+    toolbarLeft.appendChild(this.arrangeSelect);
+    toolbarLeft.appendChild(this.clearButton);
+    toolbarRight.appendChild(this.zoomLabel);
+    this.toolbar.appendChild(toolbarLeft);
+    this.toolbar.appendChild(toolbarRight);
+    this.body = createElement("div", { className: "vd-flowchart-body" });
+    this.palettePanel = createElement("aside", {
+      className: "vd-flowchart-panel vd-flowchart-panel--palette"
+    });
+    this.palettePanel.appendChild(
+      createElement("h4", { className: "vd-flowchart-panel-title", text: "Shapes & tools" })
+    );
+    this.paletteGrid = createElement("div", { className: "vd-flowchart-palette" });
+    FLOWCHART_PALETTE_ITEMS.forEach((item) => {
+      const button = createElement("button", {
+        className: "vd-flowchart-palette-btn"
+      });
+      button.setAttribute("type", "button");
+      if (item.kind === "tool") {
+        button.setAttribute("data-tool", item.tool);
+        button.setAttribute("aria-label", `Use ${item.label}`);
+      } else {
+        button.setAttribute("data-node-type", item.type);
+        button.setAttribute("aria-label", `Add ${item.label}`);
+      }
+      button.appendChild(createPalettePreview(item.tool || item.type));
+      button.appendChild(
+        createElement("span", {
+          className: "vd-flowchart-palette-label",
+          text: item.label
+        })
+      );
+      this.paletteGrid.appendChild(button);
+    });
+    this.palettePanel.appendChild(this.paletteGrid);
+    this.canvasEl = createElement("div", { className: "vd-flowchart-canvas", tabIndex: 0 });
+    this.svg = svgEl("svg", {
+      class: "vd-flowchart-svg",
+      role: "img",
+      "aria-label": "Vanduo Flowchart editor"
+    });
+    const defs = svgEl("defs");
+    this.markerDefs = svgEl("g");
+    defs.appendChild(this.markerDefs);
+    const pattern = svgEl("pattern", {
+      id: this.gridPatternId,
+      width: this.gridSize,
+      height: this.gridSize,
+      patternUnits: "userSpaceOnUse"
+    });
+    pattern.appendChild(
+      svgEl("path", {
+        d: `M ${this.gridSize} 0 L 0 0 0 ${this.gridSize}`,
+        fill: "none",
+        stroke: "var(--vd-flowchart-border)",
+        "stroke-opacity": 0.55,
+        "stroke-width": 1
+      })
+    );
+    defs.appendChild(pattern);
+    this.svg.appendChild(defs);
+    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,
+      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.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.svg.appendChild(this.world);
+    this.canvasEl.appendChild(this.svg);
+    this.inspectorPanel = createElement("aside", {
+      className: "vd-flowchart-panel vd-flowchart-panel--inspector"
+    });
+    this.inspectorPanel.appendChild(
+      createElement("h4", { className: "vd-flowchart-panel-title", text: "Inspector" })
+    );
+    this.selectionMeta = createElement("div", { className: "vd-flowchart-selection-meta" });
+    this.selectionFields = createElement("div", { className: "vd-flowchart-fields" });
+    this.deleteButton = createElement("button", {
+      className: "vd-flowchart-btn vd-flowchart-delete",
+      text: "Delete",
+      disabled: true
+    });
+    this.deleteButton.setAttribute("type", "button");
+    this.inspectorPanel.appendChild(this.selectionMeta);
+    this.inspectorPanel.appendChild(this.selectionFields);
+    this.inspectorPanel.appendChild(this.deleteButton);
+    this.inspectorPanel.appendChild(
+      createElement("h4", { className: "vd-flowchart-panel-title", text: "JSON" })
+    );
+    this.jsonPanel = createElement("div", { className: "vd-flowchart-json" });
+    this.jsonTextarea = createElement("textarea", { rows: 18 });
+    this.jsonActions = createElement("div", { className: "vd-flowchart-json-actions" });
+    this.refreshJsonButton = createElement("button", {
+      className: "vd-flowchart-json-btn",
+      text: "Refresh"
+    });
+    this.refreshJsonButton.setAttribute("type", "button");
+    this.refreshJsonButton.setAttribute("data-json-action", "refresh");
+    this.loadJsonButton = createElement("button", {
+      className: "vd-flowchart-json-btn",
+      text: "Load",
+      disabled: this.readonly
+    });
+    this.loadJsonButton.setAttribute("type", "button");
+    this.loadJsonButton.setAttribute("data-json-action", "load");
+    this.jsonActions.appendChild(this.refreshJsonButton);
+    this.jsonActions.appendChild(this.loadJsonButton);
+    this.jsonPanel.appendChild(this.jsonTextarea);
+    this.jsonPanel.appendChild(this.jsonActions);
+    this.inspectorPanel.appendChild(this.jsonPanel);
+    this.body.appendChild(this.palettePanel);
+    this.body.appendChild(this.canvasEl);
+    this.body.appendChild(this.inspectorPanel);
+    this.root.appendChild(this.toolbar);
+    this.root.appendChild(this.body);
+    this.element.appendChild(this.root);
+  }
+  bindEvents() {
+    this.toolbar.addEventListener("click", this.handleToolbarClick);
+    this.arrangeSelect.addEventListener("change", this.handleArrangeChange);
+    this.paletteGrid.addEventListener("click", this.handlePaletteClick);
+    this.deleteButton.addEventListener("click", () => this.deleteSelection());
+    this.selectionFields.addEventListener("input", this.handleSelectionFieldInput);
+    this.selectionFields.addEventListener("change", this.handleSelectionFieldChange);
+    this.jsonActions.addEventListener("click", this.handleJsonActionClick);
+    this.canvasEl.addEventListener("pointerdown", this.handlePointerDown);
+    this.canvasEl.addEventListener("pointermove", this.handlePointerMove);
+    this.canvasEl.addEventListener("pointerup", this.handlePointerUp);
+    this.canvasEl.addEventListener("pointercancel", this.handlePointerUp);
+    this.canvasEl.addEventListener("click", this.handleClick);
+    this.canvasEl.addEventListener("dblclick", this.handleDoubleClick);
+    this.canvasEl.addEventListener("wheel", this.handleWheel, { passive: false });
+    this.root.addEventListener("keydown", this.handleKeyDown, true);
+    window.addEventListener("pointerup", this.handlePointerUp);
+    window.addEventListener("resize", this.handleResize);
+  }
+  unbindEvents() {
+    this.toolbar.removeEventListener("click", this.handleToolbarClick);
+    this.arrangeSelect.removeEventListener("change", this.handleArrangeChange);
+    this.paletteGrid.removeEventListener("click", this.handlePaletteClick);
+    this.selectionFields.removeEventListener("input", this.handleSelectionFieldInput);
+    this.selectionFields.removeEventListener("change", this.handleSelectionFieldChange);
+    this.jsonActions.removeEventListener("click", this.handleJsonActionClick);
+    this.canvasEl.removeEventListener("pointerdown", this.handlePointerDown);
+    this.canvasEl.removeEventListener("pointermove", this.handlePointerMove);
+    this.canvasEl.removeEventListener("pointerup", this.handlePointerUp);
+    this.canvasEl.removeEventListener("pointercancel", this.handlePointerUp);
+    this.canvasEl.removeEventListener("click", this.handleClick);
+    this.canvasEl.removeEventListener("dblclick", this.handleDoubleClick);
+    this.canvasEl.removeEventListener("wheel", this.handleWheel);
+    this.root.removeEventListener("keydown", this.handleKeyDown, true);
+    window.removeEventListener("pointerup", this.handlePointerUp);
+    window.removeEventListener("resize", this.handleResize);
+  }
+  handleResize() {
+    if (this.destroyed) return;
+    this.render({ inspector: false, json: false });
+  }
+  updatePaletteState() {
+    const arrowArmed = this.activeTool === "arrow";
+    this.paletteGrid.querySelectorAll(".vd-flowchart-palette-btn").forEach((button) => {
+      const tool = button.getAttribute("data-tool");
+      button.classList.toggle("is-active", Boolean(tool) && tool === this.activeTool);
+    });
+    this.canvasEl.classList.toggle("is-arrow-tool", arrowArmed);
+  }
+  setActiveTool(tool) {
+    this.activeTool = tool || null;
+    this.updatePaletteState();
+    this.render({ scene: true, inspector: false, json: false });
+  }
+  handleToolbarClick(event) {
+    const actionButton = event.target.closest("[data-flowchart-action]");
+    if (!actionButton) return;
+    const action = actionButton.getAttribute("data-flowchart-action");
+    if (action === "zoom-in") this.zoomIn();
+    if (action === "zoom-out") this.zoomOut();
+    if (action === "reset-view") this.resetView();
+    if (action === "fit-view") this.fitView();
+    if (action === "undo") this.undo();
+    if (action === "redo") this.redo();
+    if (action === "clear" && !this.readonly) this.clear();
+  }
+  handleArrangeChange(event) {
+    if (this.readonly) return;
+    const mode = event.target.value;
+    if (mode) this.layout(mode);
+    event.target.selectedIndex = 0;
+  }
+  handlePaletteClick(event) {
+    if (this.readonly) return;
+    const toolButton = event.target.closest("[data-tool]");
+    if (toolButton) {
+      const tool = toolButton.getAttribute("data-tool");
+      this.setActiveTool(this.activeTool === tool ? null : tool);
+      return;
+    }
+    const button = event.target.closest("[data-node-type]");
+    if (!button) return;
+    this.setActiveTool(null);
+    this.addNode({ type: button.getAttribute("data-node-type") });
+  }
+  handleJsonActionClick(event) {
+    const button = event.target.closest("[data-json-action]");
+    if (!button) return;
+    const action = button.getAttribute("data-json-action");
+    if (action === "refresh") {
+      this.syncJsonTextarea(true);
+      return;
+    }
+    if (action === "load" && !this.readonly) {
+      this.load(this.jsonTextarea.value);
+    }
+  }
+  handleSelectionFieldInput(event) {
+    const field = event.target.getAttribute("data-field");
+    if (!field) return;
+    if (field === "node-text") {
+      this.updateNode(
+        this.selection?.id,
+        { text: event.target.value },
+        { inspector: false, reason: "node:update" }
+      );
+      return;
+    }
+    if (field === "edge-label") {
+      this.updateEdge(
+        this.selection?.id,
+        { label: event.target.value },
+        { inspector: false, reason: "edge:update" }
+      );
+      return;
+    }
+    if (field === "node-width" || field === "node-height") {
+      const patch = field === "node-width" ? { width: toFiniteNumber(event.target.value, void 0) } : { height: toFiniteNumber(event.target.value, void 0) };
+      this.updateNode(this.selection?.id, patch, { inspector: false, reason: "node:update" });
+    }
+  }
+  handleSelectionFieldChange(event) {
+    const field = event.target.getAttribute("data-field");
+    if (!field) return;
+    if (field === "node-type") {
+      this.updateNode(
+        this.selection?.id,
+        { type: event.target.value },
+        { inspector: true, reason: "node:update" }
+      );
+      return;
+    }
+    if (field === "edge-start-marker") {
+      this.updateEdge(
+        this.selection?.id,
+        { startMarker: event.target.value },
+        { inspector: true, reason: "edge:update" }
+      );
+      return;
+    }
+    if (field === "edge-end-marker") {
+      this.updateEdge(
+        this.selection?.id,
+        { endMarker: event.target.value },
+        { inspector: true, reason: "edge:update" }
+      );
+      return;
+    }
+    if (field === "edge-route") {
+      this.updateEdge(
+        this.selection?.id,
+        { route: event.target.value },
+        { inspector: true, reason: "edge:update" }
+      );
+      return;
+    }
+    if (field === "edge-stroke-preset") {
+      this.updateEdge(
+        this.selection?.id,
+        { strokeWidth: getStrokePresetWidth(event.target.value) },
+        { inspector: true, reason: "edge:update" }
+      );
+    }
+  }
+  handleKeyDown(event) {
+    if (this.readonly) return;
+    if (event.target && (event.target.tagName === "INPUT" || event.target.tagName === "TEXTAREA" || event.target.tagName === "SELECT")) {
+      return;
+    }
+    if (event.key === "Escape" && this.activeTool) {
+      event.preventDefault();
+      this.setActiveTool(null);
+      return;
+    }
+    const modKey = event.metaKey || event.ctrlKey;
+    if (modKey && (event.key === "z" || event.key === "Z")) {
+      event.preventDefault();
+      if (event.shiftKey) {
+        this.redo();
+      } else {
+        this.undo();
+      }
+      return;
+    }
+    if (modKey && (event.key === "y" || event.key === "Y")) {
+      event.preventDefault();
+      this.redo();
+      return;
+    }
+    if (modKey && event.key === "c") {
+      if (this.selection) {
+        event.preventDefault();
+        this.copySelection();
+      }
+      return;
+    }
+    if (modKey && event.key === "v") {
+      if (this.clipboard) {
+        event.preventDefault();
+        this.pasteClipboard();
+      }
+      return;
+    }
+    if (modKey && event.key === "x") {
+      if (this.selection) {
+        event.preventDefault();
+        this.cutSelection();
+      }
+      return;
+    }
+    if (!this.selection) return;
+    if (event.key === "Backspace" || event.key === "Delete") {
+      event.preventDefault();
+      this.deleteSelection();
+    }
+  }
+  copySelection() {
+    if (!this.selection) return false;
+    if (this.selection.kind === "node") {
+      const node = this.findNode(this.selection.id);
+      if (!node) return false;
+      this.clipboard = { kind: "node", data: deepClone(node) };
+      return true;
+    }
+    const edge = this.findEdge(this.selection.id);
+    if (!edge) return false;
+    this.clipboard = { kind: "edge", data: deepClone(edge) };
+    return true;
+  }
+  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) });
+      return true;
+    }
+    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(
+      {
+        ...this.clipboard.data,
+        id: void 0
+      },
+      this.documentData.edges.length,
+      nodeIds,
+      usedIds
+    );
+    if (!edge) return false;
+    this.documentData.edges.push(edge);
+    this.select({ kind: "edge", id: edge.id });
+    this.emitChange("edge:add", { edge: deepClone(edge) });
+    return true;
+  }
+  cutSelection() {
+    if (!this.copySelection()) return false;
+    return this.deleteSelection();
+  }
+  handleDoubleClick(event) {
+    if (this.readonly) return;
+    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 });
+        event.preventDefault();
+        event.stopPropagation();
+        return;
+      }
+    }
+    const nodeTarget = event.target.closest("[data-node-id]");
+    if (!nodeTarget || event.target.closest("[data-edge-id]")) return;
+    const nodeId = nodeTarget.getAttribute("data-node-id");
+    if (this.startTextEdit(nodeId)) {
+      event.preventDefault();
+      event.stopPropagation();
+    }
+  }
+  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]"))
+      return;
+    if (this.startTextEdit(nodeTarget.getAttribute("data-node-id"))) {
+      event.preventDefault();
+      event.stopPropagation();
+    }
+  }
+  handlePointerDown(event) {
+    if (this.destroyed || event.button != null && event.button !== 0) return;
+    if (this.textEditor && !event.target.closest(".vd-flowchart-text-editor")) {
+      this.stopTextEdit({ commit: true });
+    }
+    this.canvasEl.focus();
+    const nodeTarget = event.target.closest("[data-node-id]");
+    const portTarget = event.target.closest("[data-port]");
+    const resizeTarget = event.target.closest("[data-resize-handle]");
+    const edgeTarget = event.target.closest("[data-edge-id]");
+    const endpointTarget = event.target.closest("[data-edge-endpoint]");
+    if (endpointTarget && !this.readonly) {
+      const edgeId = endpointTarget.getAttribute("data-edge-id");
+      const endpoint = endpointTarget.getAttribute("data-edge-endpoint");
+      const edge = this.findEdge(edgeId);
+      if (!edge || endpoint !== "from" && endpoint !== "to") return;
+      const fromNode = this.findNode(edge.from.nodeId);
+      const toNode = this.findNode(edge.to.nodeId);
+      if (!fromNode || !toNode) return;
+      this.reconnectEdgeId = edgeId;
+      this.select({ kind: "edge", id: edgeId });
+      this.interaction = {
+        kind: "reconnect",
+        pointerId: event.pointerId,
+        edgeId,
+        endpoint,
+        target: null,
+        previousSnap: null,
+        fromPoint: getPortPosition(fromNode, edge.from.port),
+        toPoint: getPortPosition(toNode, edge.to.port),
+        fromPort: edge.from.port,
+        toPort: edge.to.port,
+        route: edge.route,
+        strokeWidth: edge.strokeWidth
+      };
+      this.capturePointer(event.pointerId);
+      this.syncConnectingState();
+      this.render({ inspector: false, json: false });
+      event.preventDefault();
+      return;
+    }
+    if (nodeTarget && !portTarget && !resizeTarget && !edgeTarget && !this.readonly) {
+      if (this.activeTool === "arrow") {
+        this.select({ kind: "node", id: nodeTarget.getAttribute("data-node-id") });
+        event.preventDefault();
+        return;
+      }
+      const nodeId = nodeTarget.getAttribute("data-node-id");
+      const now = Date.now();
+      const repeatedNodeClick = this.lastNodePointer && this.lastNodePointer.nodeId === nodeId && now - this.lastNodePointer.time <= 420;
+      this.lastNodePointer = { nodeId, time: now };
+      if ((event.detail >= 2 || repeatedNodeClick) && this.startTextEdit(nodeId)) {
+        event.preventDefault();
+        return;
+      }
+    } else {
+      this.lastNodePointer = null;
+    }
+    if (portTarget && !this.readonly) {
+      const nodeId = portTarget.getAttribute("data-node-id");
+      const port = portTarget.getAttribute("data-port");
+      const node = this.findNode(nodeId);
+      if (!node) return;
+      const sourcePoint = getPortPosition(node, port);
+      this.interaction = {
+        kind: "connect",
+        pointerId: event.pointerId,
+        source: { nodeId, port },
+        target: null,
+        previousSnap: null,
+        fromPoint: sourcePoint,
+        toPoint: sourcePoint,
+        fromPort: port,
+        toPort: "left",
+        route: DEFAULT_EDGE_ROUTE,
+        strokeWidth: DEFAULT_EDGE_STROKE_WIDTH
+      };
+      this.select({ kind: "node", id: nodeId });
+      this.capturePointer(event.pointerId);
+      this.syncConnectingState();
+      this.render({ inspector: false, json: false });
+      event.preventDefault();
+      return;
+    }
+    if (resizeTarget && !this.readonly) {
+      const nodeId = resizeTarget.getAttribute("data-node-id");
+      const handle = resizeTarget.getAttribute("data-resize-handle");
+      const node = this.findNode(nodeId);
+      if (!node || !RESIZE_HANDLES.includes(handle)) return;
+      this.select({ kind: "node", id: nodeId });
+      this.interaction = {
+        kind: "resize-node",
+        pointerId: event.pointerId,
+        nodeId,
+        handle,
+        startWorld: this.clientToWorld(event.clientX, event.clientY),
+        original: deepClone(node),
+        moved: false
+      };
+      this.capturePointer(event.pointerId);
+      event.preventDefault();
+      return;
+    }
+    if (edgeTarget) {
+      const edgeId = edgeTarget.getAttribute("data-edge-id");
+      if (!this.readonly) {
+        this.reconnectEdgeId = edgeId;
+      } else if (this.reconnectEdgeId && this.reconnectEdgeId !== edgeId) {
+        this.reconnectEdgeId = null;
+      }
+      this.select({ kind: "edge", id: edgeId });
+      event.preventDefault();
+      return;
+    }
+    if (nodeTarget) {
+      this.reconnectEdgeId = null;
+      const nodeId = nodeTarget.getAttribute("data-node-id");
+      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.capturePointer(event.pointerId);
+      }
+      return;
+    }
+    this.select(null);
+    this.reconnectEdgeId = null;
+    this.interaction = {
+      kind: "pan",
+      pointerId: event.pointerId,
+      startClientX: event.clientX,
+      startClientY: event.clientY,
+      startViewportX: this.documentData.viewport.x,
+      startViewportY: this.documentData.viewport.y,
+      moved: false
+    };
+    this.capturePointer(event.pointerId);
+    event.preventDefault();
+  }
+  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.render({ inspector: false, json: false });
+      }
+      return;
+    }
+    if (this.interaction.kind === "resize-node") {
+      const node = this.findNode(this.interaction.nodeId);
+      if (!node) return;
+      const world = this.clientToWorld(event.clientX, event.clientY);
+      const deltaX = world.x - this.interaction.startWorld.x;
+      const deltaY = world.y - this.interaction.startWorld.y;
+      const next = this.getResizedNodeBounds(
+        this.interaction.original,
+        this.interaction.handle,
+        deltaX,
+        deltaY
+      );
+      if (next.x !== node.x || next.y !== node.y || next.width !== node.width || next.height !== node.height) {
+        node.x = next.x;
+        node.y = next.y;
+        node.width = next.width;
+        node.height = next.height;
+        this.interaction.moved = true;
+        this.render({ inspector: false, json: false });
+      }
+      return;
+    }
+    if (this.interaction.kind === "pan") {
+      const deltaX = event.clientX - this.interaction.startClientX;
+      const deltaY = event.clientY - this.interaction.startClientY;
+      this.documentData.viewport.x = formatNumber(this.interaction.startViewportX + deltaX);
+      this.documentData.viewport.y = formatNumber(this.interaction.startViewportY + deltaY);
+      this.interaction.moved = true;
+      this.render({ inspector: false, json: false });
+      return;
+    }
+    if (this.interaction.kind === "connect") {
+      const world = this.clientToWorld(event.clientX, event.clientY);
+      const snapTarget = this.findConnectionTarget(
+        world,
+        this.interaction.source.nodeId,
+        this.interaction.previousSnap,
+        this.interaction.fromPoint
+      );
+      if (snapTarget) {
+        this.interaction.target = { nodeId: snapTarget.node.id, port: snapTarget.port };
+        this.interaction.toPoint = snapTarget.point;
+        this.interaction.toPort = snapTarget.port;
+        this.interaction.previousSnap = { nodeId: snapTarget.node.id, port: snapTarget.port };
+        this.render({ inspector: false, json: false });
+        return;
+      }
+      this.interaction.target = null;
+      this.interaction.toPoint = world;
+      this.interaction.toPort = this.interaction.toPort || "left";
+      this.interaction.previousSnap = null;
+      this.render({ inspector: false, json: false });
+      return;
+    }
+    if (this.interaction.kind === "reconnect") {
+      const edge = this.findEdge(this.interaction.edgeId);
+      if (!edge) return;
+      const world = this.clientToWorld(event.clientX, event.clientY);
+      const snapTarget = this.findConnectionTarget(
+        world,
+        null,
+        this.interaction.previousSnap,
+        this.interaction.endpoint === "from" ? this.interaction.toPoint : this.interaction.fromPoint
+      );
+      if (this.interaction.endpoint === "from") {
+        const toNode = this.findNode(edge.to.nodeId);
+        if (!toNode) return;
+        this.interaction.toPoint = getPortPosition(toNode, edge.to.port);
+        this.interaction.toPort = edge.to.port;
+        if (snapTarget) {
+          this.interaction.target = { nodeId: snapTarget.node.id, port: snapTarget.port };
+          this.interaction.fromPoint = snapTarget.point;
+          this.interaction.fromPort = snapTarget.port;
+          this.interaction.previousSnap = { nodeId: snapTarget.node.id, port: snapTarget.port };
+        } else {
+          this.interaction.target = null;
+          this.interaction.fromPoint = world;
+          this.interaction.fromPort = this.interaction.fromPort || edge.from.port;
+          this.interaction.previousSnap = null;
+        }
+      } else {
+        const fromNode = this.findNode(edge.from.nodeId);
+        if (!fromNode) return;
+        this.interaction.fromPoint = getPortPosition(fromNode, edge.from.port);
+        this.interaction.fromPort = edge.from.port;
+        if (snapTarget) {
+          this.interaction.target = { nodeId: snapTarget.node.id, port: snapTarget.port };
+          this.interaction.toPoint = snapTarget.point;
+          this.interaction.toPort = snapTarget.port;
+          this.interaction.previousSnap = { nodeId: snapTarget.node.id, port: snapTarget.port };
+        } else {
+          this.interaction.target = null;
+          this.interaction.toPoint = world;
+          this.interaction.toPort = this.interaction.toPort || edge.to.port;
+          this.interaction.previousSnap = null;
+        }
+      }
+      this.render({ inspector: false, json: false });
+    }
+  }
+  handlePointerUp(event) {
+    if (!this.interaction || event.pointerId != null && this.interaction.pointerId !== event.pointerId) {
+      return;
+    }
+    const interaction = this.interaction;
+    this.interaction = null;
+    this.releasePointerCapture(interaction.pointerId);
+    this.syncConnectingState();
+    if (interaction.kind === "resize-node") {
+      if (interaction.moved) {
+        const node = this.findNode(interaction.nodeId);
+        this.render({ inspector: true, json: true });
+        this.emitChange("node:resize", { node: deepClone(node) });
+      } else {
+        this.render({ inspector: false, json: false });
+      }
+      return;
+    }
+    if (interaction.kind === "drag-node") {
+      if (interaction.moved) {
+        this.render({ inspector: true, json: true });
+        this.emitChange("node:move", { node: deepClone(this.findNode(interaction.nodeId)) });
+      } else {
+        this.render({ inspector: false, json: false });
+      }
+      return;
+    }
+    if (interaction.kind === "pan") {
+      if (interaction.moved) {
+        this.render({ inspector: false, json: true });
+        this.emitViewportChange("viewport:pan");
+      } else {
+        this.render({ inspector: false, json: false });
+      }
+      return;
+    }
+    if (interaction.kind === "connect") {
+      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,
+        interaction.source.nodeId,
+        interaction.previousSnap,
+        interaction.fromPoint
+      );
+      if (snapTarget && snapTarget.node) {
+        const edge = this.addEdge({
+          from: interaction.source,
+          to: {
+            nodeId: snapTarget.node.id,
+            port: snapTarget.port
+          },
+          strokeWidth: interaction.strokeWidth,
+          endMarker: "arrow"
+        });
+        if (edge) {
+          if (this.activeTool === "arrow") this.setActiveTool(null);
+          this.syncConnectingState();
+          return;
+        }
+      }
+      if (this.activeTool === "arrow") this.setActiveTool(null);
+      this.syncConnectingState();
+      this.render({ inspector: false, json: false });
+      return;
+    }
+    if (interaction.kind === "reconnect") {
+      const edge = this.findEdge(interaction.edgeId);
+      if (edge && interaction.target) {
+        const patch = interaction.endpoint === "from" ? { from: { nodeId: interaction.target.nodeId, port: interaction.target.port } } : { to: { nodeId: interaction.target.nodeId, port: interaction.target.port } };
+        const nextFrom = patch.from || edge.from;
+        const nextTo = patch.to || edge.to;
+        if (!(nextFrom.nodeId === nextTo.nodeId && nextFrom.port === nextTo.port)) {
+          this.updateEdge(interaction.edgeId, patch, { inspector: true, reason: "edge:reconnect" });
+        } else {
+          this.render({ inspector: false, json: false });
+        }
+      } else {
+        this.render({ inspector: false, json: false });
+      }
+      this.reconnectEdgeId = interaction.edgeId;
+      this.syncConnectingState();
+      return;
+    }
+  }
+  handleWheel(event) {
+    event.preventDefault();
+    const local = this.clientToLocal(event.clientX, event.clientY);
+    const factor = event.deltaY > 0 ? 1 / 1.12 : 1.12;
+    this.scaleAround(factor, local.x, local.y, "viewport:zoom");
+  }
+  capturePointer(pointerId) {
+    if (typeof this.canvasEl.setPointerCapture !== "function") return;
+    try {
+      this.canvasEl.setPointerCapture(pointerId);
+    } catch {
+    }
+  }
+  releasePointerCapture(pointerId) {
+    if (typeof this.canvasEl.releasePointerCapture !== "function") return;
+    try {
+      this.canvasEl.releasePointerCapture(pointerId);
+    } catch {
+    }
+  }
+  syncConnectingState() {
+    const connecting = this.interaction?.kind === "connect" || this.interaction?.kind === "reconnect";
+    this.canvasEl.classList.toggle("is-connecting", connecting);
+  }
+  shouldShowNodePorts(node) {
+    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;
+  }
+  getMarkerId(markerType, position, strokeWidth) {
+    const width = normalizeEdgeStrokeWidth(strokeWidth);
+    const key = `${markerType}:${position}:${width}`;
+    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");
+    this.markerDefs.appendChild(marker);
+    this.markerIds.set(key, markerId);
+    return markerId;
+  }
+  getEdgeStrokeWidth(edge) {
+    return normalizeEdgeStrokeWidth(edge?.strokeWidth);
+  }
+  getEdgeHitStrokeWidth(edge) {
+    return formatNumber(Math.max(EDGE_HIT_STROKE_MIN, this.getEdgeStrokeWidth(edge) + 12));
+  }
+  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) => {
+      if (node.id === excludeNodeId) return candidate;
+      const distanceToBounds2 = getDistanceToNodeBounds(node, worldPoint);
+      if (distanceToBounds2 > snapPadding) return candidate;
+      const nearest = pickPortForNode(node, worldPoint, referencePoint);
+      if (!nearest) return candidate;
+      const score = distanceToBounds2 * 1e3 + nearest.distance;
+      if (!candidate || score < candidate.score) {
+        return {
+          node,
+          port: nearest.port,
+          point: nearest.point,
+          score
+        };
+      }
+      return candidate;
+    }, null);
+    if (!previousSnap || !best) return best;
+    const previousNode = this.findNode(previousSnap.nodeId);
+    if (!previousNode || previousNode.id === excludeNodeId) return best;
+    const distanceToBounds = getDistanceToNodeBounds(previousNode, worldPoint);
+    if (distanceToBounds > snapPadding) return best;
+    if (best.node.id === previousSnap.nodeId && best.port === previousSnap.port) {
+      return best;
+    }
+    const previousPoint = getPortPosition(previousNode, previousSnap.port);
+    const previousScore = distanceToBounds * 1e3 + Math.hypot(worldPoint.x - previousPoint.x, worldPoint.y - previousPoint.y);
+    if (best.score + hysteresisMargin >= previousScore) {
+      return {
+        node: previousNode,
+        port: previousSnap.port,
+        point: previousPoint,
+        score: previousScore
+      };
+    }
+    return best;
+  }
+  getResizedNodeBounds(original, handle, deltaX, deltaY) {
+    const nextType = original.type;
+    if (!isNodeResizable(nextType)) {
+      return {
+        x: formatNumber(original.x),
+        y: formatNumber(original.y),
+        width: formatNumber(original.width),
+        height: formatNumber(original.height)
+      };
+    }
+    let x = original.x;
+    let y = original.y;
+    let width = original.width;
+    let height = original.height;
+    if (handle.includes("e")) {
+      width = clampNodeWidth(nextType, original.width + deltaX, original.width);
+    }
+    if (handle.includes("s")) {
+      height = clampNodeHeight(nextType, original.height + deltaY, original.height);
+    }
+    if (handle.includes("w")) {
+      width = clampNodeWidth(nextType, original.width - deltaX, original.width);
+      x = original.x + original.width - width;
+    }
+    if (handle.includes("n")) {
+      height = clampNodeHeight(nextType, original.height - deltaY, original.height);
+      y = original.y + original.height - height;
+    }
+    return {
+      x: formatNumber(x),
+      y: formatNumber(y),
+      width: formatNumber(width),
+      height: formatNumber(height)
+    };
+  }
+  clientToLocal(clientX, clientY) {
+    const rect = this.canvasEl.getBoundingClientRect();
+    return {
+      x: clientX - rect.left,
+      y: clientY - rect.top
+    };
+  }
+  localToWorld(localX, localY) {
+    const viewport = this.documentData.viewport;
+    return {
+      x: (localX - viewport.x) / viewport.scale,
+      y: (localY - viewport.y) / viewport.scale
+    };
+  }
+  clientToWorld(clientX, clientY) {
+    const local = this.clientToLocal(clientX, clientY);
+    return this.localToWorld(local.x, local.y);
+  }
+  getViewportCenter() {
+    const width = this.canvasEl.clientWidth || 800;
+    const height = this.canvasEl.clientHeight || 560;
+    return this.localToWorld(width / 2, height / 2);
+  }
+  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);
+    if (nextScale === viewport.scale) return;
+    viewport.scale = nextScale;
+    viewport.x = formatNumber(localX - anchor.x * nextScale);
+    viewport.y = formatNumber(localY - anchor.y * nextScale);
+    this.render({ inspector: false, json: true });
+    this.emitViewportChange(reason);
+  }
+  updateToolbarLabel() {
+    this.zoomLabel.textContent = `${Math.round(this.documentData.viewport.scale * 100)}%`;
+  }
+  startTextEdit(nodeId) {
+    if (this.readonly) return false;
+    const node = this.findNode(nodeId);
+    if (!node || !isNodeTextEditable(node)) return false;
+    if (this.textEditor?.nodeId === node.id) {
+      this.positionTextEditor();
+      this.textEditor.textarea.focus();
+      this.textEditor.textarea.select();
+      return true;
+    }
+    this.stopTextEdit({ commit: true });
+    this.select({ kind: "node", id: node.id });
+    const textarea = createElement("textarea", {
+      className: `vd-flowchart-text-editor vd-flowchart-text-editor--${node.type}`,
+      value: node.text,
+      rows: 1
+    });
+    textarea.setAttribute("data-node-id", node.id);
+    textarea.setAttribute("aria-label", "Edit node text");
+    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.key === "Escape") {
+        event.preventDefault();
+        this.stopTextEdit({ commit: false });
+        return;
+      }
+      if (event.key === "Enter" && (event.ctrlKey || event.metaKey)) {
+        event.preventDefault();
+        this.stopTextEdit({ commit: true });
+      }
+    });
+    textarea.addEventListener("blur", () => {
+      if (this.textEditor?.textarea === textarea) {
+        this.stopTextEdit({ commit: true });
+      }
+    });
+    this.textEditor = {
+      nodeId: node.id,
+      previousText: node.text,
+      textarea
+    };
+    this.canvasEl.appendChild(textarea);
+    this.render({ inspector: true, json: false });
+    window.requestAnimationFrame(() => {
+      if (this.textEditor?.textarea === textarea) {
+        textarea.focus();
+        textarea.select();
+      }
+    });
+    return true;
+  }
+  stopTextEdit(options = {}) {
+    if (!this.textEditor) return false;
+    const commit = options.commit !== false;
+    const editor = this.textEditor;
+    const nextText = editor.textarea.value;
+    this.textEditor = null;
+    editor.textarea.remove();
+    if (commit && !this.readonly && nextText !== editor.previousText) {
+      this.updateNode(
+        editor.nodeId,
+        { text: nextText },
+        { inspector: true, reason: "node:update" }
+      );
+    } else {
+      this.render({ scene: true, inspector: false, json: false });
+    }
+    return true;
+  }
+  positionTextEditor() {
+    if (!this.textEditor) return;
+    const node = this.findNode(this.textEditor.nodeId);
+    if (!node) {
+      this.stopTextEdit({ commit: false });
+      return;
+    }
+    const viewport = this.documentData.viewport;
+    const scale = viewport.scale;
+    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 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);
+    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.lineHeight = `${formatNumber(lineHeight)}px`;
+    textarea.style.padding = `${formatNumber(verticalPadding)}px ${formatNumber(horizontalPadding)}px`;
+  }
+  render(options = {}) {
+    if (this.destroyed) return;
+    const shouldRenderScene = options.scene !== false;
+    const shouldRenderInspector = options.inspector !== false;
+    const shouldRenderJson = options.json !== false;
+    if (shouldRenderScene) this.renderScene();
+    if (shouldRenderInspector) this.renderSelectionPanel();
+    if (shouldRenderJson) this.syncJsonTextarea();
+    this.updateToolbarLabel();
+    this.updatePaletteState();
+    this.positionTextEditor();
+  }
+  renderScene() {
+    const viewport = this.documentData.viewport;
+    this.world.setAttribute(
+      "transform",
+      `matrix(${viewport.scale} 0 0 ${viewport.scale} ${viewport.x} ${viewport.y})`
+    );
+    clearChildren(this.edgesLayer);
+    clearChildren(this.previewLayer);
+    clearChildren(this.nodesLayer);
+    clearChildren(this.overlayLayer);
+    const nodeMap = new Map(this.documentData.nodes.map((node) => [node.id, node]));
+    this.documentData.edges.forEach((edge) => {
+      const edgeElement = this.renderEdge(edge, nodeMap);
+      if (edgeElement) this.edgesLayer.appendChild(edgeElement);
+    });
+    if (this.interaction?.kind === "connect" || this.interaction?.kind === "reconnect") {
+      this.previewLayer.appendChild(this.renderPreviewEdge(this.interaction));
+    }
+    this.documentData.nodes.forEach((node) => {
+      this.nodesLayer.appendChild(this.renderNode(node));
+    });
+    if (this.reconnectEdgeId && !this.readonly) {
+      const reconnectEdge = this.findEdge(this.reconnectEdgeId);
+      if (reconnectEdge) {
+        const fromNode = nodeMap.get(reconnectEdge.from.nodeId);
+        const toNode = nodeMap.get(reconnectEdge.to.nodeId);
+        if (fromNode && toNode) {
+          this.overlayLayer.appendChild(
+            this.renderReconnectEndpoints(reconnectEdge, fromNode, toNode)
+          );
+        }
+      }
+    }
+    this.syncConnectingState();
+  }
+  applyEdgeMarkers(pathElement, edge) {
+    if (edge.startMarker && edge.startMarker !== "none") {
+      pathElement.setAttribute(
+        "marker-start",
+        `url(#${this.getMarkerId(edge.startMarker, "start", this.getEdgeStrokeWidth(edge))})`
+      );
+    }
+    if (edge.endMarker && edge.endMarker !== "none") {
+      pathElement.setAttribute(
+        "marker-end",
+        `url(#${this.getMarkerId(edge.endMarker, "end", this.getEdgeStrokeWidth(edge))})`
+      );
+    }
+  }
+  renderEdge(edge, nodeMap) {
+    const fromNode = nodeMap.get(edge.from.nodeId);
+    const toNode = nodeMap.get(edge.to.nodeId);
+    if (!fromNode || !toNode) return null;
+    const edgePath = buildEdgePath(edge, fromNode, toNode);
+    const selected = this.selection?.kind === "edge" && this.selection.id === edge.id;
+    const inReconnectMode = this.reconnectEdgeId === edge.id;
+    const group = svgEl("g", {
+      class: `vd-flowchart-edge${selected ? " is-selected" : ""}${inReconnectMode ? " is-reconnecting" : ""}`,
+      "data-edge-id": edge.id
+    });
+    const strokeWidth = this.getEdgeStrokeWidth(edge);
+    if (selected) {
+      group.appendChild(
+        svgEl("path", {
+          class: "vd-flowchart-edge-selection",
+          d: edgePath.d,
+          "stroke-width": formatNumber(strokeWidth + 7)
+        })
+      );
+    }
+    const visiblePath = svgEl("path", {
+      class: "vd-flowchart-edge-path",
+      d: edgePath.d,
+      "stroke-width": strokeWidth,
+      "data-edge-id": edge.id
+    });
+    this.applyEdgeMarkers(visiblePath, edge);
+    const hitPath = svgEl("path", {
+      class: "vd-flowchart-edge-hit",
+      d: edgePath.d,
+      "stroke-width": this.getEdgeHitStrokeWidth(edge),
+      "data-edge-id": edge.id
+    });
+    group.appendChild(visiblePath);
+    group.appendChild(hitPath);
+    if (edge.label) {
+      const label = svgEl("text", {
+        class: "vd-flowchart-edge-label",
+        x: edgePath.labelX,
+        y: edgePath.labelY - 8,
+        "text-anchor": "middle",
+        "data-edge-id": edge.id
+      });
+      label.textContent = edge.label;
+      group.appendChild(label);
+    }
+    return group;
+  }
+  renderReconnectEndpoints(edge, fromNode, toNode) {
+    const scale = this.documentData.viewport.scale || 1;
+    const group = svgEl("g", { class: "vd-flowchart-edge-endpoints" });
+    [
+      { endpoint: "from", point: getPortPosition(fromNode, edge.from.port) },
+      { endpoint: "to", point: getPortPosition(toNode, edge.to.port) }
+    ].forEach(({ endpoint, point }) => {
+      group.appendChild(
+        svgEl("circle", {
+          class: "vd-flowchart-edge-endpoint-hit",
+          cx: point.x,
+          cy: point.y,
+          r: RECONNECT_ENDPOINT_HIT_RADIUS / scale,
+          "data-edge-id": edge.id,
+          "data-edge-endpoint": endpoint
+        })
+      );
+      group.appendChild(
+        svgEl("circle", {
+          class: "vd-flowchart-edge-endpoint",
+          cx: point.x,
+          cy: point.y,
+          r: RECONNECT_ENDPOINT_RADIUS / scale,
+          "data-edge-id": edge.id,
+          "data-edge-endpoint": endpoint
+        })
+      );
+    });
+    return group;
+  }
+  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 }
+    });
+    return svgEl("path", {
+      class: "vd-flowchart-preview-path",
+      d: edgePath.d,
+      "stroke-width": this.getEdgeStrokeWidth(interaction)
+    });
+  }
+  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 resizing = this.interaction?.kind === "resize-node" && this.interaction.nodeId === node.id;
+    const editing = this.textEditor?.nodeId === node.id;
+    const group = svgEl("g", {
+      class: `vd-flowchart-node${selected ? " is-selected" : ""}${dragging ? " is-dragging" : ""}${resizing ? " is-resizing" : ""}${editing ? " is-editing" : ""}`,
+      transform: `translate(${formatNumber(node.x)} ${formatNumber(node.y)})`,
+      "data-node-id": node.id
+    });
+    const portsVisible = this.shouldShowNodePorts(node);
+    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,
+      fill: "transparent",
+      "data-node-id": node.id
+    });
+    group.appendChild(hitbox);
+    group.appendChild(this.renderNodeShape(node));
+    group.appendChild(this.renderNodeText(node));
+    if (selected && !this.readonly && isNodeResizable(node)) {
+      group.appendChild(this.renderResizeControls(node));
+    }
+    const scale = this.documentData.viewport.scale || 1;
+    FLOWCHART_PORTS.forEach((port) => {
+      const position = getPortPosition({ ...node, x: 0, y: 0 }, port);
+      const portGroup = svgEl("g", {
+        class: `vd-flowchart-port-group${portsVisible ? " is-visible" : ""}`,
+        "data-node-id": node.id,
+        "data-port": port
+      });
+      portGroup.appendChild(
+        svgEl("circle", {
+          class: "vd-flowchart-port-hit",
+          cx: position.x,
+          cy: position.y,
+          r: CONNECTION_PORT_HIT_RADIUS / scale
+        })
+      );
+      portGroup.appendChild(
+        svgEl("circle", {
+          class: "vd-flowchart-port",
+          cx: position.x,
+          cy: position.y,
+          r: CONNECTION_PORT_RADIUS / scale
+        })
+      );
+      group.appendChild(portGroup);
+    });
+    return group;
+  }
+  renderResizeControls(node) {
+    const scale = this.documentData.viewport.scale || 1;
+    const zone = 14 / scale;
+    const cornerZone = 22 / scale;
+    const handleSize = 9 / scale;
+    const gap = RESIZE_PORT_GAP / scale;
+    const group = svgEl("g", { class: "vd-flowchart-resize-controls" });
+    const zones = {
+      n: { x: 0, y: -zone / 2, width: node.width, height: zone },
+      e: { x: node.width - zone / 2, y: 0, width: zone, height: node.height },
+      s: { x: 0, y: node.height - zone / 2, width: node.width, height: zone },
+      w: { x: -zone / 2, y: 0, width: zone, height: node.height },
+      ne: {
+        x: node.width - cornerZone / 2,
+        y: -cornerZone / 2,
+        width: cornerZone,
+        height: cornerZone
+      },
+      se: {
+        x: node.width - cornerZone / 2,
+        y: node.height - cornerZone / 2,
+        width: cornerZone,
+        height: cornerZone
+      },
+      sw: {
+        x: -cornerZone / 2,
+        y: node.height - cornerZone / 2,
+        width: cornerZone,
+        height: cornerZone
+      },
+      nw: { x: -cornerZone / 2, y: -cornerZone / 2, width: cornerZone, height: cornerZone }
+    };
+    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") {
+        const upperHeight = Math.max(0, node.height / 2 - gap / 2);
+        const lowerY = node.height / 2 + gap / 2;
+        const lowerHeight = Math.max(0, node.height - lowerY);
+        zoneSegments.push(
+          { x: zoneRect.x, y: zoneRect.y, width: zoneRect.width, height: upperHeight },
+          { x: zoneRect.x, y: lowerY, width: zoneRect.width, height: lowerHeight }
+        );
+      } else if (handle === "n" || handle === "s") {
+        const leftWidth = Math.max(0, node.width / 2 - gap / 2);
+        const rightX = node.width / 2 + gap / 2;
+        const rightWidth = Math.max(0, node.width - rightX);
+        zoneSegments.push(
+          { x: zoneRect.x, y: zoneRect.y, width: leftWidth, height: zoneRect.height },
+          { x: rightX, y: zoneRect.y, width: rightWidth, height: zoneRect.height }
+        );
+      } else {
+        zoneSegments.push(zoneRect);
+      }
+      zoneSegments.filter((segment) => segment.width > 0 && segment.height > 0).forEach((segment) => {
+        const hit = svgEl("rect", {
+          class: "vd-flowchart-resize-zone",
+          x: segment.x,
+          y: segment.y,
+          width: segment.width,
+          height: segment.height,
+          "data-node-id": node.id,
+          "data-resize-handle": handle,
+          style: `cursor: ${cursor}`
+        });
+        group.appendChild(hit);
+      });
+      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,
+        "data-node-id": node.id,
+        "data-resize-handle": handle,
+        style: `cursor: ${cursor}`
+      });
+      group.appendChild(dot);
+    });
+    return group;
+  }
+  renderNodeShape(node) {
+    const baseClass = `vd-flowchart-node-shape vd-flowchart-node-shape--${node.type}`;
+    if (node.type === "rounded-rect") {
+      return svgEl("rect", {
+        class: baseClass,
+        x: 0,
+        y: 0,
+        width: node.width,
+        height: node.height,
+        rx: 18,
+        ry: 18
+      });
+    }
+    if (node.type === "rect") {
+      return svgEl("rect", {
+        class: baseClass,
+        x: 0,
+        y: 0,
+        width: node.width,
+        height: node.height,
+        rx: 2,
+        ry: 2
+      });
+    }
+    if (node.type === "diamond") {
+      return svgEl("polygon", {
+        class: baseClass,
+        points: `${node.width / 2},0 ${node.width},${node.height / 2} ${node.width / 2},${node.height} 0,${node.height / 2}`
+      });
+    }
+    if (node.type === "circle") {
+      return svgEl("ellipse", {
+        class: baseClass,
+        cx: node.width / 2,
+        cy: node.height / 2,
+        rx: node.width / 2,
+        ry: node.height / 2
+      });
+    }
+    if (node.type === "junction") {
+      return svgEl("circle", {
+        class: baseClass,
+        cx: node.width / 2,
+        cy: node.height / 2,
+        r: Math.min(node.width, node.height) / 2
+      });
+    }
+    if (node.type === "textbox") {
+      return svgEl("rect", {
+        class: baseClass,
+        x: 0,
+        y: 0,
+        width: node.width,
+        height: node.height,
+        rx: 14,
+        ry: 14
+      });
+    }
+    return svgEl("rect", {
+      class: baseClass,
+      x: 0,
+      y: 0,
+      width: node.width,
+      height: node.height,
+      rx: 0,
+      ry: 0
+    });
+  }
+  renderNodeText(node) {
+    const textElement = svgEl("text", {
+      class: `vd-flowchart-node-text vd-flowchart-node-text--${node.type}`,
+      "data-node-id": node.id
+    });
+    if (node.type === "junction" || !node.text) {
+      return textElement;
+    }
+    if (node.type === "textbox") {
+      const lines2 = wrapText(node.text, estimateChars(node.width - 32));
+      const { lineHeight: lineHeight2 } = getNodeFontMetrics(node);
+      lines2.forEach((line, index) => {
+        const span = svgEl("tspan", {
+          x: 16,
+          y: 28 + index * lineHeight2
+        });
+        span.textContent = line;
+        textElement.appendChild(span);
+      });
+      return textElement;
+    }
+    const lines = wrapText(node.text, estimateChars(node.width));
+    const { lineHeight } = getNodeFontMetrics(node);
+    const totalHeight = (lines.length - 1) * lineHeight;
+    const startY = node.height / 2 - totalHeight / 2;
+    textElement.setAttribute("text-anchor", "middle");
+    textElement.setAttribute("dominant-baseline", "middle");
+    lines.forEach((line, index) => {
+      const span = svgEl("tspan", {
+        x: node.width / 2,
+        y: startY + index * lineHeight,
+        "text-anchor": "middle",
+        "dominant-baseline": "middle"
+      });
+      span.textContent = line;
+      textElement.appendChild(span);
+    });
+    return textElement;
+  }
+  renderSelectionPanel() {
+    clearChildren(this.selectionFields);
+    this.deleteButton.disabled = this.readonly || !this.selection;
+    if (!this.selection) {
+      this.selectionMeta.textContent = "Nothing selected";
+      this.selectionFields.appendChild(
+        createElement("p", {
+          className: "vd-flowchart-selection-empty",
+          text: "Select a node or edge to edit it."
+        })
+      );
+      return;
+    }
+    if (this.selection.kind === "node") {
+      const node = this.findNode(this.selection.id);
+      if (!node) {
+        this.selection = null;
+        this.renderSelectionPanel();
+        return;
+      }
+      this.selectionMeta.textContent = `Node ${node.id} \xB7 ${node.type} \xB7 ${Math.round(node.x)}, ${Math.round(node.y)}`;
+      const typeSelect = createElement("select");
+      typeSelect.setAttribute("data-field", "node-type");
+      FLOWCHART_NODE_TYPES.forEach((type) => {
+        const option = createElement("option", { value: type, text: type.replace("-", " ") });
+        option.value = type;
+        option.selected = type === node.type;
+        typeSelect.appendChild(option);
+      });
+      const textArea = createElement("textarea", { value: node.text, rows: 5 });
+      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));
+      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));
+      this.selectionFields.appendChild(createField("Type", typeSelect));
+      if (isNodeTextEditable(node)) {
+        this.selectionFields.appendChild(createField("Text", textArea));
+      }
+      if (isNodeResizable(node)) {
+        const sizeGrid = createElement("div", { className: "vd-flowchart-field-grid" });
+        sizeGrid.appendChild(createField("Width", widthInput));
+        sizeGrid.appendChild(createField("Height", heightInput));
+        this.selectionFields.appendChild(sizeGrid);
+      } else {
+        this.selectionFields.appendChild(
+          createElement("p", {
+            className: "vd-flowchart-selection-empty",
+            text: "Junctions stay fixed-size and do not carry inline text."
+          })
+        );
+      }
+      return;
+    }
+    const edge = this.findEdge(this.selection.id);
+    if (!edge) {
+      this.selection = null;
+      this.renderSelectionPanel();
+      return;
+    }
+    this.selectionMeta.textContent = `Edge ${edge.id} \xB7 ${edge.route} \xB7 ${formatNumber(edge.strokeWidth)}px \xB7 ${edge.startMarker} \u2192 ${edge.endMarker}`;
+    const routeSelect = createElement("select");
+    routeSelect.setAttribute("data-field", "edge-route");
+    FLOWCHART_EDGE_ROUTES.forEach((route) => {
+      const option = createElement("option", {
+        value: route,
+        text: FLOWCHART_EDGE_ROUTE_LABELS[route]
+      });
+      option.value = route;
+      option.selected = route === edge.route;
+      routeSelect.appendChild(option);
+    });
+    const startSelect = createElement("select");
+    startSelect.setAttribute("data-field", "edge-start-marker");
+    FLOWCHART_EDGE_MARKERS.forEach((marker) => {
+      const option = createElement("option", { value: marker, text: marker });
+      option.value = marker;
+      option.selected = marker === edge.startMarker;
+      startSelect.appendChild(option);
+    });
+    const endSelect = createElement("select");
+    endSelect.setAttribute("data-field", "edge-end-marker");
+    FLOWCHART_EDGE_MARKERS.forEach((marker) => {
+      const option = createElement("option", { value: marker, text: marker });
+      option.value = marker;
+      option.selected = marker === edge.endMarker;
+      endSelect.appendChild(option);
+    });
+    const widthSelect = createElement("select");
+    widthSelect.setAttribute("data-field", "edge-stroke-preset");
+    EDGE_STROKE_PRESETS.forEach((preset) => {
+      const option = createElement("option", { value: preset.id, text: preset.label });
+      option.value = preset.id;
+      option.selected = preset.id === getStrokePresetId(edge.strokeWidth);
+      widthSelect.appendChild(option);
+    });
+    const labelInput = createElement("textarea", { value: edge.label, rows: 4 });
+    labelInput.setAttribute("data-field", "edge-label");
+    const markerGrid = createElement("div", { className: "vd-flowchart-field-grid" });
+    markerGrid.appendChild(createField("Route", routeSelect));
+    markerGrid.appendChild(createField("Weight", widthSelect));
+    markerGrid.appendChild(createField("Start", startSelect));
+    markerGrid.appendChild(createField("End", endSelect));
+    this.selectionFields.appendChild(markerGrid);
+    this.selectionFields.appendChild(createField("Label", labelInput));
+  }
+  syncJsonTextarea(force = false) {
+    if (!force && document.activeElement === this.jsonTextarea) {
+      return;
+    }
+    this.jsonTextarea.value = JSON.stringify(this.toJSON(), null, 2);
+  }
+  getSelectionSnapshot() {
+    if (!this.selection) return null;
+    if (this.selection.kind === "node") {
+      const node = this.findNode(this.selection.id);
+      return node ? { kind: "node", id: node.id, node: deepClone(node) } : null;
+    }
+    const edge = this.findEdge(this.selection.id);
+    return edge ? { kind: "edge", id: edge.id, edge: deepClone(edge) } : null;
+  }
+  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.render({ scene: true, inspector: true, json: false });
+      this.emit("select", { selection: this.getSelectionSnapshot() });
+      return;
+    }
+    this.render({ scene: true, inspector: false, json: false });
+  }
+  selectNode(nodeId) {
+    this.select({ kind: "node", id: sanitizeId(nodeId) });
+    return this;
+  }
+  selectEdge(edgeId) {
+    this.select({ kind: "edge", id: sanitizeId(edgeId) });
+    return this;
+  }
+  deselect() {
+    this.select(null);
+    return this;
+  }
+  resolvePreservedSelection(previousSelection, preserve) {
+    if (!preserve || !previousSelection) return null;
+    const exists = previousSelection.kind === "node" ? Boolean(this.findNode(previousSelection.id)) : Boolean(this.findEdge(previousSelection.id));
+    return exists ? { kind: previousSelection.kind, id: previousSelection.id } : null;
+  }
+  findNode(nodeId) {
+    return this.documentData.nodes.find((node) => node.id === nodeId) || null;
+  }
+  findEdge(edgeId) {
+    return this.documentData.edges.find((edge) => edge.id === edgeId) || null;
+  }
+  emit(eventName, payload) {
+    const listeners = this.listeners[eventName];
+    if (!listeners || !listeners.size) return;
+    listeners.forEach((listener) => listener(payload));
+  }
+  emitChange(reason, extra = {}) {
+    if (this.historyEnabled && !this.isApplyingHistory) {
+      this.recordHistory(reason);
+    }
+    this.syncJsonTextarea();
+    this.emit("change", {
+      reason,
+      document: this.toJSON(),
+      ...extra
+    });
+  }
+  emitViewportChange(reason) {
+    const payload = {
+      reason,
+      viewport: deepClone(this.documentData.viewport),
+      document: this.toJSON()
+    };
+    this.syncJsonTextarea();
+    this.emit("viewport", payload);
+    this.emit("change", payload);
+  }
+  on(eventName, callback) {
+    if (!this.listeners[eventName]) {
+      this.listeners[eventName] = /* @__PURE__ */ new Set();
+    }
+    this.listeners[eventName].add(callback);
+    return this;
+  }
+  off(eventName, callback) {
+    this.listeners[eventName]?.delete(callback);
+    return this;
+  }
+  // --- History (undo / redo) ----------------------------------------------
+  // Every document mutation funnels through emitChange(), so recording there
+  // captures all of them with exactly one entry per committed gesture (live
+  // drag/resize only render()). Viewport pan/zoom go through emitViewportChange
+  // and are intentionally not recorded — undo is for content, not the camera.
+  seedHistory() {
+    if (!this.historyEnabled) return;
+    this.history = [{ reason: "init", targetKey: "", snapshot: this.toJSON() }];
+    this.historyIndex = 0;
+  }
+  recordHistory(reason) {
+    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;
+    if (canCoalesce) {
+      top.snapshot = snapshot;
+      return;
+    }
+    if (this.historyIndex < this.history.length - 1) {
+      this.history.length = this.historyIndex + 1;
+    }
+    this.history.push({ reason, targetKey, snapshot });
+    if (this.history.length > this.historyLimit) {
+      this.history.shift();
+    }
+    this.historyIndex = this.history.length - 1;
+    this.emitHistoryState(reason);
+  }
+  applyHistorySnapshot(snapshot, reason) {
+    this.isApplyingHistory = true;
+    this.stopTextEdit({ commit: false });
+    this.activeTool = null;
+    this.reconnectEdgeId = null;
+    const currentViewport = deepClone(this.documentData.viewport);
+    const previousSelection = this.selection;
+    this.documentData = normalizeDocument(snapshot);
+    this.documentData.viewport = normalizeViewport(currentViewport);
+    this.selection = this.resolvePreservedSelection(previousSelection, true);
+    this.render();
+    this.emitChange(reason);
+    this.isApplyingHistory = false;
+    this.emitHistoryState(reason);
+  }
+  emitHistoryState(reason) {
+    this.updateHistoryButtons();
+    this.emit("history", { reason, canUndo: this.canUndo(), canRedo: this.canRedo() });
+  }
+  canUndo() {
+    return this.historyEnabled && this.historyIndex > 0;
+  }
+  canRedo() {
+    return this.historyEnabled && this.historyIndex < this.history.length - 1;
+  }
+  undo() {
+    if (!this.canUndo()) return this;
+    this.historyIndex -= 1;
+    this.applyHistorySnapshot(this.history[this.historyIndex].snapshot, "undo");
+    return this;
+  }
+  redo() {
+    if (!this.canRedo()) return this;
+    this.historyIndex += 1;
+    this.applyHistorySnapshot(this.history[this.historyIndex].snapshot, "redo");
+    return this;
+  }
+  clearHistory() {
+    this.seedHistory();
+    this.emitHistoryState("history:clear");
+    return this;
+  }
+  updateHistoryButtons() {
+    if (this.undoButton) this.undoButton.disabled = this.readonly || !this.canUndo();
+    if (this.redoButton) this.redoButton.disabled = this.readonly || !this.canRedo();
+  }
+  // Resolve a `relativeTo` anchor into a top-left position for a new node of the
+  // given spec. Accepts a bare node id or `{ node, direction, distance, angle }`;
+  // `direction` (right/down/left/up) is sugar for an angle in screen space
+  // (y-down). Returns null when the anchor node can't be found.
+  resolveRelativePosition(relativeTo, spec) {
+    const ref2 = typeof relativeTo === "string" ? { node: relativeTo } : relativeTo || {};
+    const anchor = this.findNode(sanitizeId(ref2.node ?? ref2.nodeId ?? ref2.id));
+    if (!anchor) return null;
+    const directionAngles = { right: 0, down: 90, left: 180, up: -90 };
+    const angleDeg = ref2.angle != null ? toFiniteNumber(ref2.angle, 0) : directionAngles[ref2.direction] ?? 0;
+    const distance = Math.max(0, toFiniteNumber(ref2.distance, 220));
+    const radians = angleDeg * Math.PI / 180;
+    const centerX = anchor.x + anchor.width / 2 + Math.cos(radians) * distance;
+    const centerY = anchor.y + anchor.height / 2 + Math.sin(radians) * distance;
+    return {
+      x: formatNumber(centerX - spec.width / 2),
+      y: formatNumber(centerY - spec.height / 2)
+    };
+  }
+  addNode(partialNode = {}) {
+    const type = normalizeNodeType(partialNode.type);
+    const spec = DEFAULT_NODE_SPECS[type];
+    const relative = partialNode.relativeTo != null ? this.resolveRelativePosition(partialNode.relativeTo, spec) : null;
+    const center = this.getViewportCenter();
+    const offset = this.paletteSerial % 6 * 26;
+    this.paletteSerial += 1;
+    const fallbackX = relative ? relative.x : formatNumber(center.x - spec.width / 2 + offset);
+    const fallbackY = relative ? relative.y : formatNumber(center.y - spec.height / 2 + offset);
+    const rest = { ...partialNode };
+    delete rest.relativeTo;
+    const usedIds = new Set(this.documentData.nodes.map((node2) => node2.id));
+    const node = normalizeNode(
+      {
+        ...rest,
+        type,
+        x: partialNode.x == null ? fallbackX : partialNode.x,
+        y: partialNode.y == null ? fallbackY : partialNode.y
+      },
+      this.documentData.nodes.length,
+      usedIds
+    );
+    this.documentData.nodes.push(node);
+    this.select({ kind: "node", id: node.id });
+    this.syncJsonTextarea();
+    this.emitChange("node:add", { node: deepClone(node) });
+    return deepClone(node);
+  }
+  // Convenience: place a child node relative to a parent and connect them with
+  // an auto-ported arrow in one call. Returns { node, edge } (edge may be null
+  // if the connection is rejected). The new child is left selected.
+  addChildNode(parentId, options = {}) {
+    if (this.readonly) return null;
+    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 }
+    });
+    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 };
+  }
+  // Arrange nodes with a built-in layout. Positions are computed by the pure
+  // computeLayout() module, then applied in place (NOT via load(), which would
+  // wipe selection/viewport) so the result is one undoable, change-emitting step.
+  layout(mode = "tree", options = {}) {
+    if (this.readonly) return this;
+    const resolvedMode = LAYOUT_MODES.includes(mode) ? mode : "tree";
+    const positions = computeLayout(this.documentData, resolvedMode, options);
+    if (!positions.size) return this;
+    let changed = false;
+    this.documentData.nodes.forEach((node) => {
+      const next = positions.get(node.id);
+      if (!next) return;
+      const x = formatNumber(next.x);
+      const y = formatNumber(next.y);
+      if (x !== node.x || y !== node.y) {
+        node.x = x;
+        node.y = y;
+        changed = true;
+      }
+    });
+    const rerouted = options.reroutePorts === false ? false : this.rerouteEdgePorts();
+    if (!changed && !rerouted) return this;
+    this.render();
+    this.emitChange("layout", { mode: resolvedMode });
+    if (options.fit) this.fitView();
+    return this;
+  }
+  autoArrange(options = {}) {
+    return this.layout("grid", options);
+  }
+  // Re-pick each edge's from/to port from the nodes' current centers, so a
+  // freshly laid-out graph attaches connectors on sensible sides. Returns
+  // whether any port actually changed.
+  rerouteEdgePorts() {
+    let changed = false;
+    this.documentData.edges.forEach((edge) => {
+      const fromNode = this.findNode(edge.from.nodeId);
+      const toNode = this.findNode(edge.to.nodeId);
+      if (!fromNode || !toNode) return;
+      const fromCenter = {
+        x: fromNode.x + fromNode.width / 2,
+        y: fromNode.y + fromNode.height / 2
+      };
+      const toCenter = { x: toNode.x + toNode.width / 2, y: toNode.y + toNode.height / 2 };
+      const nextFrom = getPortByDirection(fromNode, toCenter).port;
+      const nextTo = getPortByDirection(toNode, fromCenter).port;
+      if (nextFrom !== edge.from.port || nextTo !== edge.to.port) {
+        edge.from.port = nextFrom;
+        edge.to.port = nextTo;
+        changed = true;
+      }
+    });
+    return changed;
+  }
+  applyNodePatch(node, patch = {}) {
+    const nextType = normalizeNodeType(patch.type ?? node.type);
+    node.type = nextType;
+    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);
+    if (isPlainObject(patch.data)) {
+      node.data = deepClone(patch.data);
+    }
+  }
+  updateNode(nodeId, patch = {}, options = {}) {
+    const node = this.findNode(nodeId);
+    if (!node) return null;
+    const previousType = node.type;
+    const previousSpec = DEFAULT_NODE_SPECS[previousType];
+    this.applyNodePatch(node, patch);
+    if (patch.type && previousType !== node.type) {
+      const nextSpec = DEFAULT_NODE_SPECS[node.type];
+      if (patch.width == null && node.width === previousSpec.width) {
+        node.width = nextSpec.width;
+      }
+      if (patch.height == null && node.height === previousSpec.height) {
+        node.height = nextSpec.height;
+      }
+      if (node.text === DEFAULT_NODE_SPECS[previousType].text) {
+        node.text = nextSpec.text;
+      }
+    }
+    this.render({
+      scene: true,
+      inspector: options.inspector !== false,
+      json: true
+    });
+    this.emitChange(options.reason || "node:update", { node: deepClone(node) });
+    return deepClone(node);
+  }
+  // Walk outgoing edges (from.nodeId -> to.nodeId) breadth-first to collect a
+  // node and every descendant reachable through the directed graph. The visited
+  // Set doubles as a cycle guard, so a diamond or loop is safe (each node once).
+  collectDescendants(rootId) {
+    const visited = /* @__PURE__ */ new Set([rootId]);
+    const queue = [rootId];
+    while (queue.length) {
+      const current = queue.shift();
+      this.documentData.edges.forEach((edge) => {
+        if (edge.from.nodeId === current && !visited.has(edge.to.nodeId)) {
+          visited.add(edge.to.nodeId);
+          queue.push(edge.to.nodeId);
+        }
+      });
+    }
+    return visited;
+  }
+  removeNode(nodeId, options = {}) {
+    const id = sanitizeId(nodeId);
+    if (!this.findNode(id)) return false;
+    const ids = options.cascade ? this.collectDescendants(id) : /* @__PURE__ */ new Set([id]);
+    return this.removeNodeIds(ids, options.reason || "node:remove", id);
+  }
+  removeNodeIds(ids, reason = "node:remove", primaryId = null) {
+    const idSet = ids instanceof Set ? ids : new Set(ids);
+    const removed = this.documentData.nodes.filter((node) => idSet.has(node.id)).map((node) => node.id);
+    if (!removed.length) return false;
+    if (this.textEditor && idSet.has(this.textEditor.nodeId)) {
+      this.stopTextEdit({ commit: false });
+    }
+    this.documentData.nodes = this.documentData.nodes.filter((node) => !idSet.has(node.id));
+    this.documentData.edges = this.documentData.edges.filter(
+      (edge) => !idSet.has(edge.from.nodeId) && !idSet.has(edge.to.nodeId)
+    );
+    if (this.selection?.kind === "node" && idSet.has(this.selection.id)) {
+      this.selection = null;
+    }
+    this.render();
+    this.emitChange(reason, { nodeId: primaryId ?? removed[0], nodeIds: removed });
+    return true;
+  }
+  updateEdge(edgeId, patch = {}, options = {}) {
+    const edge = this.findEdge(edgeId);
+    if (!edge) return null;
+    const nodeIds = new Set(this.documentData.nodes.map((node) => node.id));
+    const nextFrom = patch.from ? normalizeEndpoint(patch.from, edge.from.port) : edge.from;
+    const nextTo = patch.to ? normalizeEndpoint(patch.to, edge.to.port) : edge.to;
+    if (patch.from != null || patch.to != null) {
+      if (!nodeIds.has(nextFrom.nodeId) || !nodeIds.has(nextTo.nodeId)) return null;
+      if (!FLOWCHART_PORTS.includes(nextFrom.port) || !FLOWCHART_PORTS.includes(nextTo.port))
+        return null;
+      if (nextFrom.nodeId === nextTo.nodeId && nextFrom.port === nextTo.port) return null;
+      edge.from = nextFrom;
+      edge.to = nextTo;
+    }
+    if (patch.kind != null) {
+      edge.kind = patch.kind === "line" ? "line" : "arrow";
+      if (patch.startMarker == null && patch.endMarker == null) {
+        if (edge.kind === "line") {
+          edge.startMarker = "none";
+          edge.endMarker = "none";
+        } else if (edge.endMarker === "none" && edge.startMarker === "none") {
+          edge.endMarker = "arrow";
+        }
+      }
+    }
+    if (patch.startMarker != null) {
+      edge.startMarker = normalizeEdgeMarker(patch.startMarker) || "none";
+    }
+    if (patch.endMarker != null) {
+      edge.endMarker = normalizeEdgeMarker(patch.endMarker) || "none";
+    }
+    if (patch.route != null) {
+      edge.route = normalizeEdgeRoute(patch.route);
+    }
+    if (patch.strokeWidth != null) {
+      edge.strokeWidth = normalizeEdgeStrokeWidth(patch.strokeWidth);
+    }
+    if (patch.label != null) {
+      edge.label = String(patch.label);
+    }
+    if (isPlainObject(patch.data)) {
+      edge.data = deepClone(patch.data);
+    }
+    syncEdgeKind(edge);
+    this.render({
+      scene: true,
+      inspector: options.inspector !== false,
+      json: true
+    });
+    this.emitChange(options.reason || "edge:update", { edge: deepClone(edge) });
+    return deepClone(edge);
+  }
+  // Accept `from`/`to` as a bare node id or `{ nodeId, port }`. When `autoPort`
+  // is set, fill any omitted port by aiming each endpoint at the other node's
+  // center via getPortByDirection — the same geometry the live connect tool
+  // uses, so a programmatic edge picks the same side a dragged one would.
+  resolveEdgeEndpoints(partialEdge) {
+    const toEndpoint = (value) => {
+      if (typeof value === "string") return { nodeId: value };
+      if (isPlainObject(value)) return { ...value };
+      return {};
+    };
+    const from = toEndpoint(partialEdge.from);
+    const to = toEndpoint(partialEdge.to);
+    if (partialEdge.autoPort) {
+      const fromNode = this.findNode(sanitizeId(from.nodeId));
+      const toNode = this.findNode(sanitizeId(to.nodeId));
+      if (fromNode && toNode) {
+        const fromCenter = {
+          x: fromNode.x + fromNode.width / 2,
+          y: fromNode.y + fromNode.height / 2
+        };
+        const toCenter = { x: toNode.x + toNode.width / 2, y: toNode.y + toNode.height / 2 };
+        if (!FLOWCHART_PORTS.includes(from.port))
+          from.port = getPortByDirection(fromNode, toCenter).port;
+        if (!FLOWCHART_PORTS.includes(to.port))
+          to.port = getPortByDirection(toNode, fromCenter).port;
+      }
+    }
+    const rest = { ...partialEdge };
+    delete rest.autoPort;
+    return { ...rest, from, to };
+  }
+  addEdge(partialEdge = {}) {
+    if (this.readonly) return null;
+    const input = this.resolveEdgeEndpoints(partialEdge);
+    const nodeIds = new Set(this.documentData.nodes.map((node) => node.id));
+    const usedIds = new Set(this.documentData.edges.map((edge2) => edge2.id));
+    const edge = normalizeEdge(input, this.documentData.edges.length, nodeIds, usedIds);
+    if (!edge) return null;
+    if (edge.from.nodeId === edge.to.nodeId && edge.from.port === edge.to.port) return null;
+    this.documentData.edges.push(edge);
+    this.select({ kind: "edge", id: edge.id });
+    this.syncJsonTextarea();
+    this.emit("connect", { edge: deepClone(edge) });
+    this.emitChange("edge:add", { edge: deepClone(edge) });
+    return deepClone(edge);
+  }
+  removeEdge(edgeId) {
+    const edgeIndex = this.documentData.edges.findIndex((edge) => edge.id === edgeId);
+    if (edgeIndex === -1) return false;
+    this.documentData.edges.splice(edgeIndex, 1);
+    if (this.selection?.kind === "edge" && this.selection.id === edgeId) {
+      this.selection = null;
+    }
+    this.render();
+    this.emitChange("edge:remove", { edgeId });
+    return true;
+  }
+  deleteSelection() {
+    if (!this.selection || this.readonly) return false;
+    if (this.selection.kind === "node") return this.removeNode(this.selection.id);
+    return this.removeEdge(this.selection.id);
+  }
+  setViewport(viewport) {
+    this.documentData.viewport = normalizeViewport(viewport);
+    this.render({ inspector: false, json: true });
+    this.emitViewportChange("viewport:set");
+    return this;
+  }
+  zoomIn() {
+    const width = this.canvasEl.clientWidth || 800;
+    const height = this.canvasEl.clientHeight || 560;
+    this.scaleAround(1.12, width / 2, height / 2, "viewport:zoom");
+    return this;
+  }
+  zoomOut() {
+    const width = this.canvasEl.clientWidth || 800;
+    const height = this.canvasEl.clientHeight || 560;
+    this.scaleAround(1 / 1.12, width / 2, height / 2, "viewport:zoom");
+    return this;
+  }
+  resetView() {
+    this.documentData.viewport = normalizeViewport({ x: 0, y: 0, scale: 1 });
+    this.render({ inspector: false, json: true });
+    this.emitViewportChange("viewport:reset");
+    return this;
+  }
+  fitView() {
+    if (!this.documentData.nodes.length) {
+      return this.resetView();
+    }
+    const bounds = getBounds(this.documentData.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
+    );
+    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)
+    };
+    this.render({ inspector: false, json: true });
+    this.emitViewportChange("viewport:fit");
+    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.selection = null;
+    this.render();
+    this.emitChange("clear");
+    return this;
+  }
+  load(data, options = {}) {
+    this.stopTextEdit({ commit: false });
+    this.activeTool = null;
+    this.reconnectEdgeId = null;
+    const previousSelection = this.selection;
+    this.documentData = normalizeDocument(data);
+    this.selection = this.resolvePreservedSelection(previousSelection, options.preserveSelection);
+    this.render();
+    this.emitChange("load");
+    return this;
+  }
+  toJSON() {
+    return deepClone({
+      version: VD_FLOWCHART_VERSION,
+      viewport: this.documentData.viewport,
+      nodes: this.documentData.nodes,
+      edges: this.documentData.edges
+    });
+  }
+  destroy() {
+    if (this.destroyed) return;
+    this.destroyed = true;
+    this.activeTool = null;
+    this.stopTextEdit({ commit: false });
+    this.resizeObserver?.disconnect();
+    this.resizeObserver = null;
+    this.unbindEvents();
+    this.element.innerHTML = "";
+    this.element.classList.remove("vd-flowchart-host");
+  }
+};
+
+// src/flowchart/vue.js
+var FORWARDED_EVENTS = ["change", "select", "viewport", "connect", "ready"];
+var VdFlowchart2 = (0, import_vue.defineComponent)({
+  name: "VdFlowchart",
+  props: {
+    /** Flowchart document — `{ nodes, edges }`. */
+    data: { type: Object, default: () => ({}) },
+    /** Render as a non-editable viewer. */
+    readonly: { type: Boolean, default: false },
+    /** Background grid size in px. */
+    gridSize: { type: Number, default: void 0 },
+    /** Keep the current selection across `data`-driven reloads when possible. */
+    preserveSelection: { type: Boolean, default: false },
+    /** Fit the view to content once the editor reports a measurable size. */
+    autoFit: { type: Boolean, default: false },
+    /** 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 }
+  },
+  emits: ["change", "select", "viewport", "connect", "ready"],
+  setup(props, { emit, expose }) {
+    const el = (0, import_vue.ref)(null);
+    let instance = null;
+    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
+      });
+      FORWARDED_EVENTS.forEach((name) => {
+        instance.on(name, (payload) => emit(name, payload));
+      });
+    };
+    (0, import_vue.onMounted)(() => {
+      if (typeof window === "undefined" || !el.value) return;
+      create();
+    });
+    (0, import_vue.watch)(
+      () => props.data,
+      (next) => {
+        if (instance && typeof instance.load === "function") {
+          instance.load(next, { preserveSelection: props.preserveSelection });
+        }
+      },
+      { deep: true }
+    );
+    (0, import_vue.watch)(
+      () => [props.readonly, props.gridSize, props.autoFit, props.history, props.historyLimit],
+      () => {
+        if (!instance) return;
+        instance.destroy();
+        create();
+      }
+    );
+    (0, import_vue.onBeforeUnmount)(() => {
+      if (instance) {
+        instance.destroy();
+        instance = null;
+      }
+    });
+    expose({
+      getInstance: () => instance,
+      undo: () => instance?.undo(),
+      redo: () => instance?.redo(),
+      canUndo: () => Boolean(instance?.canUndo()),
+      canRedo: () => Boolean(instance?.canRedo()),
+      layout: (mode, options) => instance?.layout(mode, options)
+    });
+    return () => (0, import_vue.h)("div", { ref: el, class: "vd-flowchart" });
+  }
+});
+//# sourceMappingURL=index.cjs.map