/** * Desktop node-graph canvas for dialogue steps. * Pan empty space, drag cards, wheel zoom, wire outputs → inputs. */ const CARD_W = 168; const CARD_H = 72; const PORT_R = 7; const EDGE_PAD = 36; const MIN_ZOOM = 0.35; const MAX_ZOOM = 2.25; const AUTO_PAN = 14; /** * @param {{ * getDraft: () => object | null, * onOpenStep: (stepId: string) => void, * onCreateStep: (worldX: number, worldY: number) => void, * onChange: () => void * }} options */ export function createDialogueCanvas ({ getDraft, onOpenStep, onCreateStep, onChange }) { const wrap = document.createElement("div"); wrap.className = "dialogue-canvas-wrap"; const viewport = document.createElement("div"); viewport.className = "dialogue-canvas-viewport"; viewport.tabIndex = 0; const world = document.createElement("div"); world.className = "dialogue-canvas-world"; const edgesSvg = document.createElementNS("http://www.w3.org/2000/svg", "svg"); edgesSvg.classList.add("dialogue-canvas-edges"); edgesSvg.setAttribute("overflow", "visible"); const cardsLayer = document.createElement("div"); cardsLayer.className = "dialogue-canvas-cards"; const rubberPath = document.createElementNS("http://www.w3.org/2000/svg", "path"); rubberPath.classList.add("dialogue-canvas-rubber"); rubberPath.setAttribute("fill", "none"); const ctxMenu = document.createElement("div"); ctxMenu.className = "dialogue-canvas-context"; ctxMenu.hidden = true; const createBtn = document.createElement("button"); createBtn.type = "button"; createBtn.textContent = "Create new step"; ctxMenu.append(createBtn); const tooltip = document.createElement("div"); tooltip.className = "dialogue-canvas-tooltip"; tooltip.hidden = true; world.append(edgesSvg, cardsLayer); edgesSvg.append(rubberPath); viewport.append(world); wrap.append(viewport, ctxMenu, tooltip); /** @type {{ x: number, y: number, zoom: number }} */ let view = { x: 40, y: 40, zoom: 1 }; /** @type {null | { * mode: "pan" | "card" | "wire", * startClientX: number, * startClientY: number, * originViewX?: number, * originViewY?: number, * step?: object, * originEditorX?: number, * originEditorY?: number, * moved: boolean, * portKey?: string, * fromStepId?: string, * portIndex?: number * }} */ let drag = null; /** @type {null | { stepId: string, portIndex: number, portKey: string }} */ let wiring = null; let ctxWorld = { x: 0, y: 0 }; /** @type {number | null} */ let autoPanRaf = null; let lastPointer = { x: 0, y: 0 }; function applyTransform () { world.style.transform = `translate(${view.x}px, ${view.y}px) scale(${view.zoom})`; } function clientToWorld (clientX, clientY) { const rect = viewport.getBoundingClientRect(); return { x: (clientX - rect.left - view.x) / view.zoom, y: (clientY - rect.top - view.y) / view.zoom }; } function hideContext () { ctxMenu.hidden = true; } function hideTooltip () { tooltip.hidden = true; } function showTooltip (text, clientX, clientY) { if (!text) { hideTooltip(); return; } tooltip.hidden = false; tooltip.textContent = text; const rect = wrap.getBoundingClientRect(); tooltip.style.left = `${clientX - rect.left + 12}px`; tooltip.style.top = `${clientY - rect.top + 12}px`; } function stepPosition (step, index) { const x = Number.isFinite(step.editorX) ? step.editorX : 40 + (index % 4) * (CARD_W + 48); const y = Number.isFinite(step.editorY) ? step.editorY : 40 + Math.floor(index / 4) * (CARD_H + 64); return { x, y }; } function outputPorts (step) { const exit = step?.exit ?? { kind: "end" }; if (exit.kind === "continue") { return [{ key: "continue", label: "Continue", nextStepId: exit.nextStepId ?? null, setNext (id) { exit.nextStepId = id; } }]; } if (exit.kind === "triggers") { return (exit.triggers ?? []).map((trig, i) => ({ key: `trigger:${i}`, /** Player-facing button text (not the internal trigger id / legacy label). */ label: (trig.text ?? "").trim() || trig.trigger || `Trigger ${i + 1}`, nextStepId: trig.nextStepId ?? null, setNext (id) { trig.nextStepId = id; } })); } if (exit.kind === "branches") { return (exit.branches ?? []).map((branch, i) => ({ key: `branch:${i}`, label: branch.label?.trim() ? branch.label : `Branch ${i + 1}`, nextStepId: branch.nextStepId ?? null, setNext (id) { branch.nextStepId = id; } })); } return []; } function portWorldPos (step, index, portIndex, kind) { const pos = stepPosition(step, index); if (kind === "in") { return { x: pos.x + CARD_W / 2, y: pos.y }; } const ports = outputPorts(step); const n = Math.max(1, ports.length); const spacing = CARD_W / (n + 1); return { x: pos.x + spacing * (portIndex + 1), y: pos.y + CARD_H }; } function bezier (x1, y1, x2, y2) { const dy = Math.max(40, Math.abs(y2 - y1) * 0.45); return `M ${x1} ${y1} C ${x1} ${y1 + dy}, ${x2} ${y2 - dy}, ${x2} ${y2}`; } function clearWiring () { wiring = null; rubberPath.setAttribute("d", ""); rubberPath.classList.remove("active"); wrap.classList.remove("dialogue-canvas-wiring"); for (const el of cardsLayer.querySelectorAll(".dialogue-canvas-input.show")) { el.classList.remove("show"); } } function setWiring (stepId, portIndex, portKey) { wiring = { stepId, portIndex, portKey }; wrap.classList.add("dialogue-canvas-wiring"); for (const el of cardsLayer.querySelectorAll(".dialogue-canvas-input")) { if (el.getAttribute("data-step-id") !== stepId) { el.classList.add("show"); } } } function stopAutoPan () { if (autoPanRaf != null) { cancelAnimationFrame(autoPanRaf); autoPanRaf = null; } } function tickAutoPan () { autoPanRaf = null; if (!drag || drag.mode !== "card") { return; } const rect = viewport.getBoundingClientRect(); let dx = 0; let dy = 0; if (lastPointer.x < rect.left + EDGE_PAD) { dx = AUTO_PAN; } else if (lastPointer.x > rect.right - EDGE_PAD) { dx = -AUTO_PAN; } if (lastPointer.y < rect.top + EDGE_PAD) { dy = AUTO_PAN; } else if (lastPointer.y > rect.bottom - EDGE_PAD) { dy = -AUTO_PAN; } if (dx || dy) { view.x += dx; view.y += dy; applyTransform(); const worldPt = clientToWorld(lastPointer.x, lastPointer.y); drag.step.editorX = worldPt.x - CARD_W / 2; drag.step.editorY = worldPt.y - CARD_H / 2; refreshCardsOnly(); redrawEdges(); } autoPanRaf = requestAnimationFrame(tickAutoPan); } function redrawEdges () { const draft = getDraft(); for (const el of [...edgesSvg.children]) { if (el !== rubberPath) { el.remove(); } } if (rubberPath.parentNode !== edgesSvg) { edgesSvg.append(rubberPath); } if (!draft?.steps?.length) { return; } draft.steps.forEach((step, index) => { const ports = outputPorts(step); ports.forEach((port, portIndex) => { if (!port.nextStepId) { return; } const targetIndex = draft.steps.findIndex((s) => s.stepId === port.nextStepId); if (targetIndex < 0) { return; } const from = portWorldPos(step, index, portIndex, "out"); const to = portWorldPos(draft.steps[targetIndex], targetIndex, 0, "in"); const path = document.createElementNS("http://www.w3.org/2000/svg", "path"); path.classList.add("dialogue-canvas-edge"); const rewiring = !!wiring && wiring.stepId === step.stepId && wiring.portIndex === portIndex; if (rewiring) { path.classList.add("is-rewiring"); } path.setAttribute("d", bezier(from.x, from.y, to.x, to.y)); path.setAttribute("fill", "none"); edgesSvg.insertBefore(path, rubberPath); }); }); } function refreshCardsOnly () { const draft = getDraft(); if (!draft) { cardsLayer.replaceChildren(); return; } const existing = new Map( [...cardsLayer.querySelectorAll(".dialogue-canvas-card")] .map((el) => [el.getAttribute("data-step-id"), el]) ); const keep = new Set(); draft.steps.forEach((step, index) => { keep.add(step.stepId); let card = existing.get(step.stepId); if (!card) { card = buildCard(step, index); cardsLayer.append(card); } else { updateCard(card, step, index); } const pos = stepPosition(step, index); card.style.left = `${pos.x}px`; card.style.top = `${pos.y}px`; }); for (const [id, el] of existing) { if (!keep.has(id)) { el.remove(); } } } function buildCard (step, index) { const card = document.createElement("div"); card.className = "dialogue-canvas-card"; card.setAttribute("data-step-id", step.stepId); const input = document.createElement("button"); input.type = "button"; input.className = "dialogue-canvas-input"; input.title = "Connect here"; input.setAttribute("data-step-id", step.stepId); input.addEventListener("pointerdown", (event) => { event.stopPropagation(); event.preventDefault(); if (!wiring) { return; } if (wiring.stepId === step.stepId) { return; } const draft = getDraft(); const from = draft?.steps?.find((s) => s.stepId === wiring.stepId); if (!from) { return; } const ports = outputPorts(from); const port = ports[wiring.portIndex]; if (!port) { return; } port.setNext(step.stepId); clearWiring(); onChange(); refresh(); }); const label = document.createElement("div"); label.className = "dialogue-canvas-card-label"; const meta = document.createElement("div"); meta.className = "dialogue-canvas-card-meta"; const portsRow = document.createElement("div"); portsRow.className = "dialogue-canvas-ports"; card.append(input, label, meta, portsRow); card.addEventListener("pointerdown", (event) => { if (event.button !== 0) { return; } if (event.target.closest(".dialogue-canvas-port, .dialogue-canvas-input")) { return; } event.preventDefault(); hideContext(); const draft = getDraft(); const live = draft?.steps?.find((s) => s.stepId === step.stepId); if (!live) { return; } const pos = stepPosition(live, draft.steps.indexOf(live)); if (!Number.isFinite(live.editorX)) { live.editorX = pos.x; } if (!Number.isFinite(live.editorY)) { live.editorY = pos.y; } drag = { mode: "card", startClientX: event.clientX, startClientY: event.clientY, step: live, originEditorX: live.editorX, originEditorY: live.editorY, moved: false }; lastPointer = { x: event.clientX, y: event.clientY }; card.classList.add("dragging"); card.setPointerCapture(event.pointerId); stopAutoPan(); autoPanRaf = requestAnimationFrame(tickAutoPan); }); updateCard(card, step, index); return card; } function updateCard (card, step, index) { card.setAttribute("data-step-id", step.stepId); const draft = getDraft(); const isEntry = draft && (draft.entryStepId === step.stepId || (!draft.entryStepId && draft.steps[0] === step)); card.classList.toggle("is-entry", !!isEntry); const label = card.querySelector(".dialogue-canvas-card-label"); if (label) { label.textContent = step.label || step.stepId; } const meta = card.querySelector(".dialogue-canvas-card-meta"); if (meta) { const kind = step.exit?.kind ?? "end"; meta.textContent = isEntry ? `entry · ${kind}` : kind; } const input = card.querySelector(".dialogue-canvas-input"); if (input) { input.setAttribute("data-step-id", step.stepId); input.classList.toggle("show", !!wiring && wiring.stepId !== step.stepId); } const portsRow = card.querySelector(".dialogue-canvas-ports"); if (!portsRow) { return; } portsRow.replaceChildren(); const ports = outputPorts(step); ports.forEach((port, portIndex) => { const btn = document.createElement("button"); btn.type = "button"; btn.className = "dialogue-canvas-port"; btn.title = port.label; btn.classList.toggle("linked", !!port.nextStepId); btn.classList.toggle("selected", !!wiring && wiring.stepId === step.stepId && wiring.portIndex === portIndex); btn.addEventListener("pointerdown", (event) => { event.stopPropagation(); event.preventDefault(); hideContext(); // Clicking an output always starts/continues wire mode (existing link stays until // a new input is chosen; that edge is drawn red via is-rewiring). setWiring(step.stepId, portIndex, port.key); drag = { mode: "wire", startClientX: event.clientX, startClientY: event.clientY, moved: false, fromStepId: step.stepId, portIndex, portKey: port.key }; const from = portWorldPos(step, index, portIndex, "out"); const worldPt = clientToWorld(event.clientX, event.clientY); rubberPath.classList.add("active"); rubberPath.setAttribute("d", bezier(from.x, from.y, worldPt.x, worldPt.y)); refreshCardsOnly(); redrawEdges(); }); btn.addEventListener("pointerenter", (event) => { showTooltip(port.label, event.clientX, event.clientY); }); btn.addEventListener("pointerleave", () => hideTooltip()); btn.addEventListener("pointermove", (event) => { showTooltip(port.label, event.clientX, event.clientY); }); portsRow.append(btn); }); } function refresh () { applyTransform(); refreshCardsOnly(); redrawEdges(); } function onPointerMove (event) { lastPointer = { x: event.clientX, y: event.clientY }; if (!drag) { if (wiring) { const draft = getDraft(); const fromStep = draft?.steps?.find((s) => s.stepId === wiring.stepId); if (!fromStep) { return; } const index = draft.steps.indexOf(fromStep); const from = portWorldPos(fromStep, index, wiring.portIndex, "out"); const worldPt = clientToWorld(event.clientX, event.clientY); rubberPath.setAttribute("d", bezier(from.x, from.y, worldPt.x, worldPt.y)); } return; } const dx = event.clientX - drag.startClientX; const dy = event.clientY - drag.startClientY; if (Math.hypot(dx, dy) > 4) { drag.moved = true; } if (drag.mode === "pan") { view.x = drag.originViewX + dx; view.y = drag.originViewY + dy; applyTransform(); return; } if (drag.mode === "card") { drag.step.editorX = drag.originEditorX + dx / view.zoom; drag.step.editorY = drag.originEditorY + dy / view.zoom; refreshCardsOnly(); redrawEdges(); return; } if (drag.mode === "wire") { const draft = getDraft(); const fromStep = draft?.steps?.find((s) => s.stepId === drag.fromStepId); if (!fromStep) { return; } const index = draft.steps.indexOf(fromStep); const from = portWorldPos(fromStep, index, drag.portIndex, "out"); const worldPt = clientToWorld(event.clientX, event.clientY); rubberPath.setAttribute("d", bezier(from.x, from.y, worldPt.x, worldPt.y)); } } function onPointerUp (event) { if (!drag) { return; } const finished = drag; drag = null; stopAutoPan(); for (const el of cardsLayer.querySelectorAll(".dragging")) { el.classList.remove("dragging"); } if (finished.mode === "card") { if (!finished.moved) { onOpenStep(finished.step.stepId); } else { onChange(); } refresh(); return; } if (finished.mode === "wire") { // Keep wiring selected until input click or cancel if (!wiring) { clearWiring(); } refresh(); return; } if (finished.mode === "pan" && !finished.moved && event.button === 0) { clearWiring(); refresh(); } } viewport.addEventListener("pointerdown", (event) => { if (event.button === 2) { return; } if (event.button !== 0) { return; } if (event.target.closest(".dialogue-canvas-card, .dialogue-canvas-context")) { return; } hideContext(); drag = { mode: "pan", startClientX: event.clientX, startClientY: event.clientY, originViewX: view.x, originViewY: view.y, moved: false }; viewport.setPointerCapture(event.pointerId); }); viewport.addEventListener("contextmenu", (event) => { event.preventDefault(); // RMB cancels an in-progress wire/rewire. if (wiring) { clearWiring(); hideContext(); refresh(); return; } if (event.target.closest(".dialogue-canvas-card")) { return; } const worldPt = clientToWorld(event.clientX, event.clientY); ctxWorld = worldPt; const rect = wrap.getBoundingClientRect(); ctxMenu.hidden = false; ctxMenu.style.left = `${event.clientX - rect.left}px`; ctxMenu.style.top = `${event.clientY - rect.top}px`; }); createBtn.addEventListener("click", () => { hideContext(); onCreateStep(ctxWorld.x, ctxWorld.y); }); viewport.addEventListener("wheel", (event) => { event.preventDefault(); const rect = viewport.getBoundingClientRect(); const mx = event.clientX - rect.left; const my = event.clientY - rect.top; const before = { x: (mx - view.x) / view.zoom, y: (my - view.y) / view.zoom }; const factor = event.deltaY < 0 ? 1.08 : 1 / 1.08; view.zoom = Math.min(MAX_ZOOM, Math.max(MIN_ZOOM, view.zoom * factor)); view.x = mx - before.x * view.zoom; view.y = my - before.y * view.zoom; applyTransform(); }, { passive: false }); window.addEventListener("pointermove", onPointerMove); window.addEventListener("pointerup", onPointerUp); window.addEventListener("pointercancel", onPointerUp); window.addEventListener("keydown", (event) => { if (event.key === "Escape") { clearWiring(); hideContext(); refresh(); } }); applyTransform(); return { el: wrap, refresh, clearWiring: () => { clearWiring(); refresh(); }, destroy () { stopAutoPan(); window.removeEventListener("pointermove", onPointerMove); window.removeEventListener("pointerup", onPointerUp); window.removeEventListener("pointercancel", onPointerUp); wrap.remove(); } }; } export function blankDialogueStep (stepId, editorX, editorY) { const step = { stepId, label: stepId, lines: [{ speaker: "npc", text: "…", effects: [] }], itemRewards: [], itemTakes: [], questRewards: [], exit: { kind: "end" } }; if (Number.isFinite(editorX)) { step.editorX = editorX; } if (Number.isFinite(editorY)) { step.editorY = editorY; } return step; } /** Clear nextStepId references to a deleted step. */ export function scrubDialogueStepLinks (draft, removedStepId) { if (!draft?.steps) { return; } for (const step of draft.steps) { const exit = step.exit; if (!exit) { continue; } if (exit.kind === "continue" && exit.nextStepId === removedStepId) { exit.nextStepId = null; } if (exit.kind === "triggers") { for (const trig of exit.triggers ?? []) { if (trig.nextStepId === removedStepId) { trig.nextStepId = null; } } } if (exit.kind === "branches") { for (const branch of exit.branches ?? []) { if (branch.nextStepId === removedStepId) { branch.nextStepId = null; } } } } } export function stepHasEdges (draft, step) { const exit = step?.exit ?? { kind: "end" }; let outgoing = false; if (exit.kind === "continue") { outgoing = !!exit.nextStepId; } else if (exit.kind === "triggers") { outgoing = (exit.triggers ?? []).some((t) => !!t.nextStepId); } else if (exit.kind === "branches") { outgoing = (exit.branches ?? []).some((b) => !!b.nextStepId); } const incoming = (draft?.steps ?? []).some((other) => { if (other === step) { return false; } const e = other.exit; if (!e) { return false; } if (e.kind === "continue") { return e.nextStepId === step.stepId; } if (e.kind === "triggers") { return (e.triggers ?? []).some((t) => t.nextStepId === step.stepId); } if (e.kind === "branches") { return (e.branches ?? []).some((b) => b.nextStepId === step.stepId); } return false; }); return incoming || outgoing; }