agentic-mermaid 0.1.0 → 0.1.1

package/dist/agent.js

@@ -67,7 +67,8 @@ var WARNING_SEVERITY = {
   DECISION_BRANCH_UNLABELED: "warning",
   COMMENT_DROPPED: "warning",
   UNSUPPORTED_SYNTAX: "warning",
-  CONTENT_DROPPED_ON_ROUNDTRIP: "warning"
+  CONTENT_DROPPED_ON_ROUNDTRIP: "warning",
+  INEFFECTIVE_CONFIG: "warning"
 };
 var WARNING_TIER = {
   EMPTY_DIAGRAM: "structural",
@@ -91,7 +92,8 @@ var WARNING_TIER = {
   DECISION_BRANCH_UNLABELED: "lint",
   COMMENT_DROPPED: "lint",
   UNSUPPORTED_SYNTAX: "lint",
-  CONTENT_DROPPED_ON_ROUNDTRIP: "lint"
+  CONTENT_DROPPED_ON_ROUNDTRIP: "lint",
+  INEFFECTIVE_CONFIG: "lint"
 };
 var DEFAULT_LABEL_CHAR_CAP = 40;
 
@@ -686,7 +688,7 @@ var MUTATION_OPS_BY_FAMILY = {
   timeline: ["set_title", "add_section", "remove_section", "set_section_label", "add_period", "remove_period", "set_period_label", "add_event", "remove_event", "set_event_text"],
   class: ["set_title", "add_class", "remove_class", "rename_class", "add_member", "remove_member", "add_relation", "remove_relation", "add_note", "remove_note"],
   er: ["add_entity", "remove_entity", "rename_entity", "add_attribute", "remove_attribute", "add_relation", "remove_relation"],
-  journey: ["set_title", "add_section", "remove_section", "set_section_label", "add_task", "remove_task", "set_task_text", "set_task_score", "set_task_actors", "rename_actor"],
+  journey: ["set_title", "add_section", "remove_section", "set_section_label", "add_task", "remove_task", "set_task_text", "set_task_score", "set_task_actors", "rename_actor", "move_task", "move_section", "set_accessibility_title", "set_accessibility_description"],
   architecture: ["add_service", "remove_service", "rename_service", "set_service_label", "set_service_icon", "move_service", "add_group", "remove_group", "add_edge", "remove_edge"],
   xychart: ["set_title", "set_x_axis", "set_y_axis", "add_series", "remove_series", "set_series_values", "set_series_name", "reorder_series"],
   pie: ["set_title", "set_show_data", "add_slice", "remove_slice", "rename_slice", "set_slice_value", "reorder_slice"],
@@ -1904,33 +1906,164 @@ function mutateTimeline(input, op) {
   return ok(body);
 }
 
-// src/agent/journey-body.ts
-var TITLE_RE2 = /^title\s+(.+)$/i;
+// src/journey/parse-core.ts
+var JOURNEY_MIN_SCORE = 1;
+var JOURNEY_MAX_SCORE = 5;
+var JOURNEY_TITLE_RE = /^title\s+(.+)$/i;
+var JOURNEY_SECTION_RE = /^section\s+(.+)$/i;
+var JOURNEY_TASK_RE = /^(.+?)\s*:\s*([0-9]+)\s*(?::\s*(.*))?$/;
+var TASK_LIKE_RE = /^(.+?)\s*:\s*([^:]+?)(?:\s*:\s*.*)?$/;
 var ACC_LINE_RE = (directive) => new RegExp(`^${directive}\\s*:[ \\t]*(.+)$`, "i");
-var SECTION_RE = /^section\s+(.+)$/i;
-var TASK_RE = /^(.+?)\s*:\s*([0-9]+)\s*(?::\s*(.*))?$/;
-function normalizeText(value) {
-  return normalizeJourneyLabel(value).split(/\r?\n/).map((part) => part.trim()).filter(Boolean).join("\n");
-}
-function normalizeActorText(value) {
-  return normalizeText(value).split(/\r?\n/).map((part) => part.trim()).filter(Boolean).join(" / ");
-}
+var ACC_DESCR_BLOCK_START_RE = /^accDescr\s*:?\s*\{\s*(.*)$/i;
 function normalizeJourneyLabel(label) {
   return label.replace(/<br\s*\/?>/gi, "\n").replace(/\\n/g, "\n").replace(/<\/?(?:sub|sup|small|mark)\s*>/gi, "").replace(/\*\*(.+?)\*\*/g, "<b>$1</b>").replace(/(?<!\*)\*([^\s*](?:[^*]*[^\s*])?)\*(?!\*)/g, "<i>$1</i>").replace(/~~(.+?)~~/g, "<s>$1</s>");
 }
-function formatJourneyInline(value) {
-  return value.split(/\r?\n/).map((part) => part.trim()).join("<br>");
+function normalizeJourneyText(value) {
+  return normalizeJourneyLabel(value).split(/\r?\n/).map((part) => part.trim()).filter(Boolean).join("\n");
+}
+function normalizeJourneyActor(value) {
+  return normalizeJourneyText(value).split("\n").join(" / ");
 }
 function isJourneyComment(line2) {
   return line2.startsWith("%%") || line2.startsWith("#") || line2.startsWith("%");
 }
-function validScore(score) {
-  return Number.isInteger(score) && score >= 1 && score <= 5;
+function isValidJourneyScore(score) {
+  return Number.isInteger(score) && score >= JOURNEY_MIN_SCORE && score <= JOURNEY_MAX_SCORE;
+}
+function walkJourneyLines(lines, startIndex, events) {
+  for (let i2 = startIndex; i2 < lines.length; i2++) {
+    const line2 = lines[i2].trim();
+    if (!line2) continue;
+    if (isJourneyComment(line2)) continue;
+    const accDescrStart = line2.match(ACC_DESCR_BLOCK_START_RE);
+    if (accDescrStart) {
+      const collected = collectJourneyAccessibilityBlock(accDescrStart[1] ?? "", lines, i2);
+      if (!collected) {
+        const outcome = events.issue?.({
+          code: "unclosed_accdescr",
+          lineIndex: i2,
+          statement: line2,
+          detail: 'Journey accDescr block is missing a closing "}"'
+        });
+        if (outcome === "stop") return;
+        return;
+      }
+      events.accDescr?.(normalizeJourneyText(collected.text), i2);
+      i2 = collected.nextIndex;
+      continue;
+    }
+    for (const statement of splitJourneyStatements(line2)) {
+      const outcome = classifyStatement(statement, i2, events);
+      if (outcome === "stop") return;
+    }
+  }
+}
+function classifyStatement(statement, lineIndex, events) {
+  const issue = (code, detail) => events.issue?.({ code, lineIndex, statement, detail });
+  const accTitle = matchAccessibilityLine(statement, "accTitle");
+  if (accTitle !== void 0) {
+    events.accTitle?.(accTitle, lineIndex);
+    return;
+  }
+  const accDescr = matchAccessibilityLine(statement, "accDescr");
+  if (accDescr !== void 0) {
+    events.accDescr?.(accDescr, lineIndex);
+    return;
+  }
+  const titleMatch = statement.match(JOURNEY_TITLE_RE);
+  if (titleMatch) {
+    const text3 = normalizeJourneyText(titleMatch[1]);
+    if (!text3) return issue("empty_title", `Journey title is empty: "${statement}"`);
+    events.title?.(text3, lineIndex);
+    return;
+  }
+  const sectionMatch = statement.match(JOURNEY_SECTION_RE);
+  if (sectionMatch) {
+    const label = normalizeJourneyText(sectionMatch[1]);
+    if (!label || label.includes(":")) {
+      return issue("section_colon", `Journey section labels must not contain ':': "${statement}"`);
+    }
+    events.section?.(label, lineIndex);
+    return;
+  }
+  const taskMatch = statement.match(JOURNEY_TASK_RE);
+  if (taskMatch) {
+    const text3 = normalizeJourneyText(taskMatch[1]);
+    if (!text3) return issue("empty_task_text", `Journey task text is empty: "${statement}"`);
+    const rawScore = taskMatch[2];
+    const score = Number.parseInt(rawScore, 10);
+    if (!isValidJourneyScore(score)) return issue("invalid_score", invalidScoreDetail(text3, rawScore));
+    const actors = (taskMatch[3] ?? "").split(",").map(normalizeJourneyActor).filter(Boolean);
+    events.task?.(text3, score, actors, lineIndex);
+    return;
+  }
+  const taskLike = statement.match(TASK_LIKE_RE);
+  if (taskLike) {
+    const text3 = normalizeJourneyText(taskLike[1]);
+    const rawScore = taskLike[2].trim();
+    if (text3 && rawScore) return issue("invalid_score", invalidScoreDetail(text3, rawScore));
+  }
+  return issue(
+    "unrecognized_line",
+    `Invalid user journey line: "${statement}". Expected title, section, accessibility metadata, or "Task name: 3: Actor"`
+  );
+}
+function invalidScoreDetail(text3, rawScore) {
+  return `Journey task "${text3}" has invalid score ${rawScore}. Expected an integer from ${JOURNEY_MIN_SCORE} through ${JOURNEY_MAX_SCORE}`;
+}
+var HTML_ENTITY_RE = /^&(?:[a-zA-Z][a-zA-Z0-9]{1,31}|#[0-9]{1,7}|#x[0-9a-fA-F]{1,6});$/;
+function splitJourneyStatements(line2) {
+  if (!line2.includes(";")) return [line2];
+  const parts = [];
+  let start = 0;
+  for (let i2 = 0; i2 < line2.length; i2++) {
+    if (line2[i2] !== ";") continue;
+    const amp = line2.lastIndexOf("&", i2);
+    if (amp >= start && HTML_ENTITY_RE.test(line2.slice(amp, i2 + 1))) continue;
+    parts.push(line2.slice(start, i2));
+    start = i2 + 1;
+  }
+  parts.push(line2.slice(start));
+  return parts.map((part) => part.trim()).filter((part) => part && !isJourneyComment(part));
+}
+function matchAccessibilityLine(line2, directive) {
+  const match = line2.match(ACC_LINE_RE(directive));
+  return match ? normalizeJourneyText(match[1]) : void 0;
+}
+function collectJourneyAccessibilityBlock(initial, lines, startIndex) {
+  const initialEnd = initial.indexOf("}");
+  if (initialEnd !== -1) {
+    return {
+      text: initial.slice(0, initialEnd).trim(),
+      nextIndex: startIndex
+    };
+  }
+  const parts = [initial.trim()].filter(Boolean);
+  for (let i2 = startIndex + 1; i2 < lines.length; i2++) {
+    const line2 = lines[i2];
+    const end = line2.indexOf("}");
+    if (end !== -1) {
+      const beforeBrace = line2.slice(0, end).trim();
+      if (beforeBrace) parts.push(beforeBrace);
+      return {
+        text: parts.join("\n"),
+        nextIndex: i2
+      };
+    }
+    parts.push(line2);
+  }
+  return null;
+}
+
+// src/agent/journey-body.ts
+function formatJourneyInline(value) {
+  return value.split(/\r?\n/).map((part) => part.trim()).join("<br>");
 }
 function parseJourneyBody(lines) {
   const body = { kind: "journey", sections: [] };
   let currentSection;
   let sIdx = 0, tIdx = 0;
+  let firstIssue;
   const implicitSection = () => {
     if (!currentSection) {
       currentSection = { id: `section-${sIdx++}`, tasks: [] };
@@ -1938,60 +2071,36 @@ function parseJourneyBody(lines) {
     }
     return currentSection;
   };
-  for (let i2 = 0; i2 < lines.length; i2++) {
-    const raw2 = lines[i2];
-    const line2 = raw2.trim();
-    if (!line2) continue;
-    if (isJourneyComment(line2)) continue;
-    const accTitle = parseAccessibilityLine(line2, "accTitle");
-    if (accTitle !== void 0) {
-      body.accessibilityTitle = accTitle;
-      continue;
-    }
-    const accDescrStart = line2.match(/^accDescr\s*:?\s*\{\s*(.*)$/i);
-    if (accDescrStart) {
-      const initial = accDescrStart[1] ?? "";
-      const parsed = collectAccessibilityBlock(initial, lines, i2);
-      if (!parsed) return null;
-      body.accessibilityDescription = normalizeAccessibilityText(parsed.text);
-      i2 = parsed.nextIndex;
-      continue;
-    }
-    const accDescr = parseAccessibilityLine(line2, "accDescr");
-    if (accDescr !== void 0) {
-      body.accessibilityDescription = accDescr;
-      continue;
-    }
-    const tm = line2.match(TITLE_RE2);
-    if (tm) {
-      const title = normalizeText(tm[1]);
-      if (!title) return null;
-      body.title = title;
-      continue;
-    }
-    const sm = line2.match(SECTION_RE);
-    if (sm) {
-      const label = normalizeText(sm[1]);
-      if (!label || label.includes(":")) return null;
+  walkJourneyLines(lines, 0, {
+    title: (text3) => {
+      body.title = text3;
+    },
+    accTitle: (text3) => {
+      body.accessibilityTitle = text3;
+    },
+    accDescr: (text3) => {
+      body.accessibilityDescription = text3;
+    },
+    section: (label) => {
       currentSection = { id: `section-${sIdx++}`, label, tasks: [] };
       body.sections.push(currentSection);
-      continue;
-    }
-    const km = line2.match(TASK_RE);
-    if (km) {
-      const text3 = normalizeText(km[1]);
-      const score = Number.parseInt(km[2], 10);
-      if (!text3 || !validScore(score)) return null;
-      const actors = (km[3] ?? "").split(",").map(normalizeActorText).filter(Boolean);
+    },
+    task: (text3, score, actors) => {
       implicitSection().tasks.push({ id: `task-${tIdx++}`, text: text3, score, actors });
-      continue;
+    },
+    issue: (issue) => {
+      firstIssue = issue;
+      return "stop";
     }
-    return null;
-  }
+  });
+  if (firstIssue) return { ok: false, issue: firstIssue };
   if (body.sections.length === 0 && body.sections.every((s2) => s2.tasks.length === 0) && !body.title && !body.accessibilityTitle && !body.accessibilityDescription) {
-    return null;
+    return {
+      ok: false,
+      issue: { code: "empty_journey", lineIndex: 0, statement: "", detail: "Journey has no title, sections, or scored tasks" }
+    };
   }
-  return body;
+  return { ok: true, body };
 }
 function renderJourney(body) {
   const lines = ["journey"];
@@ -2046,53 +2155,38 @@ function makeIdAllocator(body) {
 }
 function normalizeOpText(value, field, opts = {}) {
   if (typeof value !== "string") return err({ code: "INVALID_OP", message: `Journey ${field} must be a string` });
-  const normalized = normalizeText(value);
+  const normalized = normalizeJourneyText(value);
   if (!normalized || !opts.allowColon && normalized.includes(":")) {
     return err({ code: "INVALID_OP", message: `Journey ${field} must be non-empty and must not contain :` });
   }
   return ok(normalized);
 }
+function resolveInsertIndex(index, length) {
+  if (index === void 0) return ok(length);
+  if (!Number.isInteger(index) || index < 0 || index > length) {
+    return err({ code: "INVALID_OP", message: `Journey insert index ${index} out of range (0..${length})` });
+  }
+  return ok(index);
+}
+function normalizeAccessibilityOpText(value, field) {
+  if (value === null) return ok(void 0);
+  if (typeof value !== "string") return err({ code: "INVALID_OP", message: `Journey ${field} must be a string or null` });
+  const normalized = normalizeJourneyText(value);
+  if (!normalized || /[;{}]/.test(normalized)) {
+    return err({ code: "INVALID_OP", message: `Journey ${field} must be non-empty and must not contain ;, {, or }` });
+  }
+  return ok(normalized);
+}
 function normalizeActors(actors) {
   const out = [];
   for (const raw2 of actors ?? []) {
     if (typeof raw2 !== "string") return err({ code: "INVALID_OP", message: "Journey actor must be a string" });
-    const normalized = normalizeActorText(raw2);
+    const normalized = normalizeJourneyActor(raw2);
     if (!normalized) return err({ code: "INVALID_OP", message: "Journey actor must be non-empty" });
     out.push(normalized);
   }
   return ok(out);
 }
-function normalizeAccessibilityText(value) {
-  return normalizeJourneyLabel(value).split(/\r?\n/).map((part) => part.trim()).filter(Boolean).join("\n");
-}
-function parseAccessibilityLine(line2, directive) {
-  const match = line2.match(ACC_LINE_RE(directive));
-  return match ? normalizeAccessibilityText(match[1]) : void 0;
-}
-function collectAccessibilityBlock(initial, lines, startIndex) {
-  const initialEnd = initial.indexOf("}");
-  if (initialEnd !== -1) {
-    return {
-      text: initial.slice(0, initialEnd).trim(),
-      nextIndex: startIndex
-    };
-  }
-  const parts = [initial.trim()].filter(Boolean);
-  for (let i2 = startIndex + 1; i2 < lines.length; i2++) {
-    const line2 = lines[i2];
-    const end = line2.indexOf("}");
-    if (end !== -1) {
-      const beforeBrace = line2.slice(0, end).trim();
-      if (beforeBrace) parts.push(beforeBrace);
-      return {
-        text: parts.join("\n"),
-        nextIndex: i2
-      };
-    }
-    parts.push(line2);
-  }
-  return null;
-}
 function mutateJourney(body, op) {
   const next = cloneJourney(body);
   const nextId = makeIdAllocator(next);
@@ -2111,7 +2205,9 @@ function mutateJourney(body, op) {
     case "add_section": {
       const label = normalizeOpText(op.label, "section label");
       if (!label.ok) return label;
-      next.sections.push({ id: nextId("section"), label: label.value, tasks: [] });
+      const index = resolveInsertIndex(op.index, next.sections.length);
+      if (!index.ok) return index;
+      next.sections.splice(index.value, 0, { id: nextId("section"), label: label.value, tasks: [] });
       break;
     }
     case "remove_section": {
@@ -2132,10 +2228,12 @@ function mutateJourney(body, op) {
       if (!s2) return err({ code: "SECTION_NOT_FOUND", message: `No section at index ${op.sectionIndex}` });
       const text3 = normalizeOpText(op.text, "task text");
       if (!text3.ok) return text3;
-      if (!validScore(op.score)) return err({ code: "INVALID_OP", message: `Journey score must be an integer 1..5, got ${op.score}` });
+      if (!isValidJourneyScore(op.score)) return err({ code: "INVALID_OP", message: `Journey score must be an integer 1..5, got ${op.score}` });
       const actors = normalizeActors(op.actors);
       if (!actors.ok) return actors;
-      s2.tasks.push({ id: nextId("task"), text: text3.value, score: op.score, actors: actors.value });
+      const index = resolveInsertIndex(op.index, s2.tasks.length);
+      if (!index.ok) return index;
+      s2.tasks.splice(index.value, 0, { id: nextId("task"), text: text3.value, score: op.score, actors: actors.value });
       break;
     }
     case "remove_task": {
@@ -2157,7 +2255,7 @@ function mutateJourney(body, op) {
     case "set_task_score": {
       const t2 = getTask(op.sectionIndex, op.taskIndex);
       if (!t2) return err({ code: "TASK_NOT_FOUND", message: `No task at (${op.sectionIndex},${op.taskIndex})` });
-      if (!validScore(op.score)) return err({ code: "INVALID_OP", message: `Journey score must be an integer 1..5, got ${op.score}` });
+      if (!isValidJourneyScore(op.score)) return err({ code: "INVALID_OP", message: `Journey score must be an integer 1..5, got ${op.score}` });
       t2.score = op.score;
       break;
     }
@@ -2169,6 +2267,45 @@ function mutateJourney(body, op) {
       t2.actors = actors.value;
       break;
     }
+    case "move_task": {
+      const from = getSection(op.fromSection);
+      if (!from) return err({ code: "SECTION_NOT_FOUND", message: `No section at index ${op.fromSection}` });
+      if (!from.tasks[op.fromIndex]) return err({ code: "TASK_NOT_FOUND", message: `No task at index ${op.fromIndex}` });
+      const to = getSection(op.toSection);
+      if (!to) return err({ code: "SECTION_NOT_FOUND", message: `No section at index ${op.toSection}` });
+      const [task] = from.tasks.splice(op.fromIndex, 1);
+      if (!Number.isInteger(op.toIndex) || op.toIndex < 0 || op.toIndex > to.tasks.length) {
+        return err({ code: "TASK_NOT_FOUND", message: `No insert position ${op.toIndex} in section ${op.toSection} (0..${to.tasks.length})` });
+      }
+      to.tasks.splice(op.toIndex, 0, task);
+      if (from !== to && from.label === void 0 && from.tasks.length === 0) {
+        next.sections.splice(next.sections.indexOf(from), 1);
+      }
+      break;
+    }
+    case "move_section": {
+      if (!getSection(op.from)) return err({ code: "SECTION_NOT_FOUND", message: `No section at index ${op.from}` });
+      if (!Number.isInteger(op.to) || op.to < 0 || op.to >= next.sections.length) {
+        return err({ code: "SECTION_NOT_FOUND", message: `No section position ${op.to} (0..${next.sections.length - 1})` });
+      }
+      const [section] = next.sections.splice(op.from, 1);
+      next.sections.splice(op.to, 0, section);
+      break;
+    }
+    case "set_accessibility_title": {
+      const title = normalizeAccessibilityOpText(op.title, "accessibility title");
+      if (!title.ok) return title;
+      if (title.value === void 0) delete next.accessibilityTitle;
+      else next.accessibilityTitle = title.value;
+      break;
+    }
+    case "set_accessibility_description": {
+      const description = normalizeAccessibilityOpText(op.description, "accessibility description");
+      if (!description.ok) return description;
+      if (description.value === void 0) delete next.accessibilityDescription;
+      else next.accessibilityDescription = description.value;
+      break;
+    }
     case "rename_actor": {
       const from = normalizeOpText(op.from, "actor", { allowColon: true });
       if (!from.ok) return from;
@@ -2234,7 +2371,7 @@ var JUNCTION_RE = new RegExp(`^junction\\s+(${IDENT})(?:\\s+in\\s+(${IDENT}))?\\
 var SOURCE_RE = new RegExp(`^(${IDENT}):(L|R|T|B)$`);
 var TARGET_RE = new RegExp(`^(L|R|T|B):(${IDENT})$`);
 var SIDES = /* @__PURE__ */ new Set(["L", "R", "T", "B"]);
-function normalizeText2(value) {
+function normalizeText(value) {
   return value.split(/\r?\n/).map((part) => part.trim()).filter(Boolean).join(" ");
 }
 function parseArrow(token) {
@@ -2245,7 +2382,7 @@ function parseArrow(token) {
   if (t2 === "--") return { hasArrowStart: false, hasArrowEnd: false };
   const m2 = t2.match(/^(<)?-\[(.*)\]-(>)?$/);
   if (!m2) return null;
-  const label = normalizeText2(m2[2] ?? "") || void 0;
+  const label = normalizeText(m2[2] ?? "") || void 0;
   if (label && (label.includes("[") || label.includes("]"))) return null;
   return { label, hasArrowStart: Boolean(m2[1]), hasArrowEnd: Boolean(m2[3]) };
 }
@@ -2285,7 +2422,7 @@ function parseArchitectureBody(lines) {
       ids.add(id);
       groupIds.add(id);
       const icon = gm[2]?.trim() || void 0;
-      const label = normalizeText2(gm[3] ?? id);
+      const label = normalizeText(gm[3] ?? id);
       const parentId = gm[4] ?? void 0;
       if (parentId) pendingParents.push({ parent: parentId });
       groups.push({ id, label, icon, parentId });
@@ -2298,7 +2435,7 @@ function parseArchitectureBody(lines) {
       ids.add(id);
       endpointIds.add(id);
       const icon = sm[2]?.trim() || void 0;
-      const label = normalizeText2(sm[3] ?? id);
+      const label = normalizeText(sm[3] ?? id);
       const parentId = sm[4] ?? void 0;
       if (parentId) pendingParents.push({ parent: parentId });
       services.push({ id, label, icon, parentId });
@@ -2389,7 +2526,7 @@ function validId(value, field) {
 }
 function normalizeLabel(value, field) {
   if (typeof value !== "string") return err({ code: "INVALID_OP", message: `Architecture ${field} must be a string` });
-  const normalized = normalizeText2(value);
+  const normalized = normalizeText(value);
   if (!normalized || normalized.includes("[") || normalized.includes("]")) {
     return err({ code: "INVALID_OP", message: `Architecture ${field} must be non-empty and must not contain [ or ]` });
   }
@@ -2603,7 +2740,7 @@ function isFiniteNumber(n2) {
 var NUMBER = String.raw`[+-]?(?:\d+(?:\.\d+)?|\.\d+)`;
 var RANGE_RE = new RegExp(`^(${NUMBER})\\s*-->\\s*(${NUMBER})$`);
 var BARE_TEXT_RE = /^[^"'\[\];]+$/;
-function normalizeText3(value) {
+function normalizeText2(value) {
   return value.split(/\r?\n/).map((part) => part.trim()).filter(Boolean).join(" ");
 }
 function isBareText(value) {
@@ -2705,7 +2842,7 @@ function parseXyChartBody(lines) {
     if (line2.startsWith("%%")) continue;
     const titleMatch = line2.match(/^title\s+(.+)$/);
     if (titleMatch) {
-      const title = bareToken(normalizeText3(titleMatch[1]));
+      const title = bareToken(normalizeText2(titleMatch[1]));
       if (title === null) return null;
       body.title = title;
       continue;
@@ -2783,7 +2920,7 @@ function makeSeriesIdAllocator(body) {
 }
 function validBareText(value, field) {
   if (typeof value !== "string") return err({ code: "INVALID_OP", message: `XY chart ${field} must be a string` });
-  const normalized = normalizeText3(value);
+  const normalized = normalizeText2(value);
   if (!isBareText(normalized)) {
     return err({ code: "INVALID_OP", message: `XY chart ${field} must be non-empty bare text (no quotes, brackets, ; or -->)` });
   }
@@ -3142,7 +3279,7 @@ function formatNumber3(n2) {
 function isCoord(n2) {
   return typeof n2 === "number" && Number.isFinite(n2) && n2 >= 0 && n2 <= 1;
 }
-var TITLE_RE3 = /^title\s+(.+)$/i;
+var TITLE_RE2 = /^title\s+(.+)$/i;
 var AXIS_RE = /^([xy])-axis\s+(.+)$/i;
 var QUADRANT_RE = /^quadrant-([1-4])\s+(.+)$/i;
 var POINT_RE = /^(.+?)\s*:\s*\[\s*([^,\]]+)\s*,\s*([^,\]]+)\s*\]\s*$/;
@@ -3177,7 +3314,7 @@ function parseQuadrantBody(lines) {
     if (line2.startsWith("%%")) continue;
     if (/^classDef\b/i.test(line2) || line2.includes(":::")) return null;
     let m2;
-    if (m2 = line2.match(TITLE_RE3)) {
+    if (m2 = line2.match(TITLE_RE2)) {
       const title = m2[1].trim();
       if (!title) return null;
       body.title = title;
@@ -4840,8 +4977,8 @@ function applyGanttFrontmatterConfig(model, frontmatter) {
 // src/agent/gantt-body.ts
 var DIRECTIVE_LINE_RE = /^(dateFormat|axisFormat|tickInterval|inclusiveEndDates|topAxis|excludes|includes|todayMarker|weekday|weekend|click|accTitle|accDescr)\b/i;
 var ACC_DESCR_BLOCK_OPEN_RE = /^accDescr\s*\{\s*$/i;
-var TITLE_RE4 = /^title\s+(.+)$/i;
-var SECTION_RE2 = /^section\s+(.+)$/i;
+var TITLE_RE3 = /^title\s+(.+)$/i;
+var SECTION_RE = /^section\s+(.+)$/i;
 var TASK_ID_RE = /^[\w-]+$/;
 function parseGanttBody(trimmedLines, rawLines) {
   const raw2 = rawLines ?? trimmedLines;
@@ -4890,13 +5027,13 @@ function parseGanttBody(trimmedLines, rawLines) {
       continue;
     }
     let m2;
-    if (m2 = line2.match(TITLE_RE4)) {
+    if (m2 = line2.match(TITLE_RE3)) {
       body.title = m2[1].trim();
       statements.push({ kind: "title" });
       i2++;
       continue;
     }
-    if (m2 = line2.match(SECTION_RE2)) {
+    if (m2 = line2.match(SECTION_RE)) {
       body.sections.push({ id: `section-${sIdx++}`, label: m2[1].trim(), tasks: [] });
       currentSection = body.sections.length - 1;
       statements.push({ kind: "section", ref: currentSection });
@@ -5028,7 +5165,7 @@ function validateTask(task) {
   const colon = line2.indexOf(":");
   const label = colon > 0 ? line2.slice(0, colon).trim() : "";
   const meta = colon > 0 ? parseGanttTaskMeta(line2.slice(colon + 1).trim()) : null;
-  const reparsesAsDirective = TITLE_RE4.test(line2) || SECTION_RE2.test(line2) || DIRECTIVE_LINE_RE.test(line2);
+  const reparsesAsDirective = TITLE_RE3.test(line2) || SECTION_RE.test(line2) || DIRECTIVE_LINE_RE.test(line2);
   if (!meta || label !== task.label || reparsesAsDirective) {
     return { code: "INVALID_OP", message: `Gantt task does not round-trip through its canonical line ("${line2}")` };
   }
@@ -5043,7 +5180,7 @@ function validateSectionLabel(label) {
     return { code: "INVALID_OP", message: 'Gantt section label must be non-empty and must not contain ":" or newlines' };
   }
   const line2 = `section ${label.trim()}`;
-  if (!SECTION_RE2.test(line2)) return { code: "INVALID_OP", message: "Gantt section label does not round-trip" };
+  if (!SECTION_RE.test(line2)) return { code: "INVALID_OP", message: "Gantt section label does not round-trip" };
   return null;
 }
 function allTaskIds(body) {
@@ -6182,78 +6319,54 @@ registerFamily({
 function extractJourneyLabels(source) {
   const out = [];
   const lines = source.split(/\r?\n/);
-  for (let i2 = 0; i2 < lines.length; i2++) {
-    const raw2 = lines[i2].trim();
-    if (!raw2 || raw2.startsWith("%%")) continue;
-    let m2;
-    if (m2 = raw2.match(/^accDescr\s*:?\s*\{\s*(.*)$/i)) {
-      const first = m2[1];
-      const end = first.indexOf("}");
-      if (end >= 0) {
-        const text3 = first.slice(0, end).trim();
-        if (text3) out.push({ text: text3, target: `line${i2 + 1}` });
-      } else {
-        const text3 = first.trim();
-        if (text3) out.push({ text: text3, target: `line${i2 + 1}` });
-        for (i2 += 1; i2 < lines.length; i2++) {
-          const line2 = lines[i2].trim();
-          const close = line2.indexOf("}");
-          const text4 = (close >= 0 ? line2.slice(0, close) : line2).trim();
-          if (text4) out.push({ text: text4, target: `line${i2 + 1}` });
-          if (close >= 0) break;
-        }
-      }
-    } else if (m2 = raw2.match(/^accTitle\s*:?\s*(.+)$/i)) {
-      out.push({ text: m2[1].trim(), target: `line${i2 + 1}` });
-    } else if (m2 = raw2.match(/^accDescr\s*:?\s*(.+)$/i)) {
-      out.push({ text: m2[1].replace(/^\{/, "").replace(/\}$/, "").trim(), target: `line${i2 + 1}` });
-    } else if (m2 = raw2.match(/^title\s+(.+)$/i)) {
-      out.push({ text: m2[1].trim(), target: `line${i2 + 1}` });
-    } else if (m2 = raw2.match(/^section\s+(.+)$/i)) {
-      out.push({ text: m2[1].trim(), target: `line${i2 + 1}` });
-    } else if (m2 = raw2.match(/^(.+?):\s*\d+(?:\s*:\s*(.*))?$/)) {
-      out.push({ text: m2[1].trim(), target: `line${i2 + 1}` });
-      for (const actor of (m2[2] ?? "").split(",")) {
-        const text3 = actor.trim();
-        if (text3) out.push({ text: text3, target: `line${i2 + 1}` });
-      }
+  const headerIndex = lines.findIndex((line2) => /^\s*journey\b/i.test(line2));
+  const push = (text3, lineIndex) => {
+    for (const part of text3.split("\n")) {
+      if (part) out.push({ text: part, target: `line${lineIndex + 1}` });
     }
-  }
+  };
+  walkJourneyLines(lines, headerIndex + 1, {
+    title: push,
+    accTitle: push,
+    accDescr: push,
+    section: push,
+    task: (text3, _score, actors, lineIndex) => {
+      push(text3, lineIndex);
+      for (const actor of actors) push(actor, lineIndex);
+    }
+  });
   return out;
 }
 function verifyOpaqueJourney(body) {
   if (body.kind !== "opaque" || body.family !== "journey") return [];
   const warnings = [];
   const lines = body.source.split(/\r?\n/);
-  for (let i2 = 0; i2 < lines.length; i2++) {
-    const diagnostic = invalidJourneyScoreDiagnostic(lines[i2].trim());
-    if (!diagnostic) continue;
+  const headerIndex = lines.findIndex((line2) => /^\s*journey\b/i.test(line2));
+  let blocking;
+  walkJourneyLines(lines, headerIndex + 1, {
+    issue: (issue) => {
+      if (issue.code === "invalid_score") {
+        warnings.push({
+          code: "UNSUPPORTED_SYNTAX",
+          line: issue.lineIndex + 1,
+          syntax: "journey_invalid_score",
+          message: `${issue.detail}.`
+        });
+        return;
+      }
+      blocking ??= issue;
+    }
+  });
+  if (blocking) {
     warnings.push({
       code: "UNSUPPORTED_SYNTAX",
-      line: i2 + 1,
-      syntax: "journey_invalid_score",
-      message: `Journey task "${diagnostic.text}" uses invalid score ${diagnostic.rawScore}; Mermaid Journey scores must be integers from 1 through 5.`
+      line: blocking.lineIndex + 1,
+      syntax: `journey_${blocking.code}`,
+      message: `${blocking.detail}. The diagram is preserved verbatim as source; fix this line to unlock typed journey mutation.`
     });
   }
   return warnings;
 }
-function invalidJourneyScoreDiagnostic(raw2) {
-  if (!raw2 || raw2.startsWith("%%")) return null;
-  if (/^(?:journey|title|section)\b/i.test(raw2)) return null;
-  if (/^acc(?:Title|Descr)\b/i.test(raw2)) return null;
-  const numeric = raw2.match(/^(.+?)\s*:\s*([0-9]+)\s*(?::\s*(.*))?$/);
-  if (numeric) {
-    const score = Number.parseInt(numeric[2], 10);
-    if (Number.isInteger(score) && score >= 1 && score <= 5) return null;
-    return { text: numeric[1].trim(), rawScore: numeric[2] };
-  }
-  const taskLike = raw2.match(/^(.+?)\s*:\s*([^:]+?)(?:\s*:\s*.*)?$/);
-  if (!taskLike) return null;
-  const text3 = taskLike[1].trim();
-  const rawScore = taskLike[2].trim();
-  if (!text3 || !rawScore) return null;
-  return { text: text3, rawScore };
-}
 registerFamily({
   id: "journey",
   detect: (l2) => l2.startsWith("journey"),
@@ -6263,7 +6376,10 @@ registerFamily({
   verify: (body, opts) => body.kind === "journey" ? verifyJourney(body, opts) : verifyOpaqueJourney(body),
   ...structuredFamilyHooks("journey", {
     headerOk: (h2) => /^journey\s*$/i.test(h2),
-    parseBody: parseJourneyBody,
+    parseBody: (lines) => {
+      const outcome = parseJourneyBody(lines);
+      return outcome.ok ? outcome.body : null;
+    },
     serialize: renderJourney,
     mutate: mutateJourney
   })
@@ -7052,15 +7168,19 @@ var ER_SCHEMA = {
 };
 var JOURNEY_SCHEMA = {
   set_title: { fields: { title: strOrNull() } },
-  add_section: { fields: { label: str() } },
+  add_section: { fields: { label: str(), index: withNote(num(false), "insert position; omit to append") } },
   remove_section: { fields: { index: num() } },
   set_section_label: { fields: { index: num(), label: str() } },
-  add_task: { fields: { sectionIndex: num(), text: str(), score: withNote(num(), "integer 1..5"), actors: strArr(false) } },
+  add_task: { fields: { sectionIndex: num(), text: str(), score: withNote(num(), "integer 1..5"), actors: strArr(false), index: withNote(num(false), "insert position; omit to append") } },
   remove_task: { fields: { sectionIndex: num(), taskIndex: num() } },
   set_task_text: { fields: { sectionIndex: num(), taskIndex: num(), text: str() } },
   set_task_score: { fields: { sectionIndex: num(), taskIndex: num(), score: withNote(num(), "integer 1..5") } },
   set_task_actors: { fields: { sectionIndex: num(), taskIndex: num(), actors: strArr() } },
-  rename_actor: { fields: { from: str(), to: str() } }
+  rename_actor: { fields: { from: str(), to: str() } },
+  move_task: { fields: { fromSection: num(), fromIndex: num(), toSection: num(), toIndex: withNote(num(), "insert position in the target section, applied after removal") } },
+  move_section: { fields: { from: num(), to: num() } },
+  set_accessibility_title: { fields: { title: strOrNull() } },
+  set_accessibility_description: { fields: { description: strOrNull() } }
 };
 var ARCHITECTURE_SCHEMA = {
   add_service: { fields: { id: str(), label: str(false), icon: strOrNull(false), group: strOrNull(false) } },
@@ -7503,6 +7623,22 @@ function isSixDigitHex(s2) {
 function luma255(r4, g2, b2) {
   return (r4 * 299 + g2 * 587 + b2 * 114) / 1e3;
 }
+function wcagRelativeLuminance(hex) {
+  const rgb = tryParseHex(hex);
+  if (!rgb) return null;
+  const lin = (channel) => {
+    const c2 = channel / 255;
+    return c2 <= 0.04045 ? c2 / 12.92 : ((c2 + 0.055) / 1.055) ** 2.4;
+  };
+  return 0.2126 * lin(rgb[0]) + 0.7152 * lin(rgb[1]) + 0.0722 * lin(rgb[2]);
+}
+function wcagContrastRatio(a2, b2) {
+  const la = wcagRelativeLuminance(a2);
+  const lb = wcagRelativeLuminance(b2);
+  if (la === null || lb === null) return null;
+  const [hi, lo] = la > lb ? [la, lb] : [lb, la];
+  return (hi + 0.05) / (lo + 0.05);
+}
 
 // src/theme.ts
 var DEFAULTS = {
@@ -7703,12 +7839,37 @@ function isColorDark(color) {
   const [r4, g2, b2] = parseHex(color);
   return luma255(r4, g2, b2) / 255 < 0.4;
 }
+function isPlainFontFamily(font) {
+  return /^[A-Za-z0-9][A-Za-z0-9 _-]*$/.test(font);
+}
+var RASTER_FONT_FALLBACK = "'Inter'";
+function resolveRasterFontFamily(fallback) {
+  if (!fallback.includes("var(")) return fallback;
+  const inner = /^var\(\s*--[\w-]+\s*,\s*([^()]+)\)$/.exec(fallback)?.[1]?.trim();
+  return inner || RASTER_FONT_FALLBACK;
+}
 function inlineFontVarForRaster(svg2) {
-  return svg2.replace(/var\(--font,\s*('[^']*')\)/g, "$1");
+  const marker = "var(--font,";
+  let out = "";
+  let i2 = 0;
+  while (true) {
+    const at = svg2.indexOf(marker, i2);
+    if (at === -1) return out + svg2.slice(i2);
+    out += svg2.slice(i2, at);
+    let depth = 1;
+    let j2 = at + marker.length;
+    while (j2 < svg2.length && depth > 0) {
+      if (svg2[j2] === "(") depth++;
+      else if (svg2[j2] === ")") depth--;
+      j2++;
+    }
+    out += resolveRasterFontFamily(svg2.slice(at + marker.length, j2 - 1).trim());
+    i2 = j2;
+  }
 }
 function buildStyleBlock(font, hasMonoFont, shadow, embedFontImport = true) {
   const fontImports = embedFontImport ? [
-    `@import url('https://fonts.googleapis.com/css2?family=${encodeURIComponent(font)}:wght@400;500;600;700&amp;display=swap');`,
+    ...isPlainFontFamily(font) ? [`@import url('https://fonts.googleapis.com/css2?family=${encodeURIComponent(font)}:wght@400;500;600;700&amp;display=swap');`] : [],
     ...hasMonoFont ? [`@import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500&amp;display=swap');`] : []
   ] : [];
   const derivedVars = `
@@ -7726,8 +7887,9 @@ function buildStyleBlock(font, hasMonoFont, shadow, embedFontImport = true) {
     --_inner-stroke:  color-mix(in srgb, var(--fg) ${MIX.innerStroke}%, var(--bg));
     --_key-badge:     color-mix(in srgb, var(--fg) ${MIX.keyBadge}%, var(--bg));`;
   const shadowRules = shadow ? '\n  .node, .class-node, .entity, .actor[data-type="participant"], .note, .block, .timeline-event, .journey-task { filter: url(#bm-shadow); }' : "";
-  const fontFamilyDecl = `  text { font-family: var(--font, '${font}'), system-ui, sans-serif; }`;
-  const styleHead = embedFontImport ? [`  ${fontImports.join("\n  ")}`, fontFamilyDecl] : [fontFamilyDecl];
+  const fontFallback = isPlainFontFamily(font) ? `'${font}'` : font;
+  const fontFamilyDecl = `  text { font-family: var(--font, ${fontFallback}), system-ui, sans-serif; }`;
+  const styleHead = fontImports.length > 0 ? [`  ${fontImports.join("\n  ")}`, fontFamilyDecl] : [fontFamilyDecl];
   return [
     "<style>",
     ...styleHead,
@@ -7805,6 +7967,11 @@ function inlineResolvedColors(svg2, colors) {
   vars.set("_key-badge", rc.keyBadge);
   let text3 = svg2;
   const SKIP_VARS = /* @__PURE__ */ new Set(["font"]);
+  if (colors.font) {
+    for (const m2 of colors.font.matchAll(/var\(\s*--([\w-]+)/g)) {
+      if (!vars.has(m2[1])) SKIP_VARS.add(m2[1]);
+    }
+  }
   for (let pass = 0; pass < 10; pass++) {
     const prev = text3;
     text3 = text3.replace(/var\(--([\w-]+)\)/g, (match, name) => {
@@ -15268,7 +15435,7 @@ function indentLines(s2, n2) {
 ${pad}`);
 }
 function group(fields) {
-  const join2 = fields.join ?? "\n";
+  const join3 = fields.join ?? "\n";
   const segments = [fields.open];
   for (const child of fields.children) {
     segments.push(indentLines(child.node.crisp, child.indent));
@@ -15276,13 +15443,13 @@ function group(fields) {
   segments.push(fields.close);
   return {
     kind: "group",
-    crisp: segments.join(join2),
+    crisp: segments.join(join3),
     id: fields.id,
     role: fields.role,
     open: fields.open,
     close: fields.close,
     children: fields.children,
-    join: join2,
+    join: join3,
     channels: fields.channels
   };
 }
@@ -15305,8 +15472,8 @@ function prelude(fields, crisp) {
 }
 
 // src/scene/backend.ts
-function composeGroup(open, close, join2, children) {
-  return [open, ...children.map((c2) => indentLines(c2.serialized, c2.indent)), close].join(join2);
+function composeGroup(open, close, join3, children) {
+  return [open, ...children.map((c2) => indentLines(c2.serialized, c2.indent)), close].join(join3);
 }
 function pageRectFor(doc, ctx) {
   const prelude2 = doc.parts[0];
@@ -16131,21 +16298,21 @@ function parseSequenceDiagram(lines) {
   const blockStack = [];
   for (let i2 = 1; i2 < lines.length; i2++) {
     const line2 = lines[i2];
-    const accTitle = parseAccessibilityLine2(line2, "accTitle");
+    const accTitle = parseAccessibilityLine(line2, "accTitle");
     if (accTitle !== void 0) {
       diagram.accessibilityTitle = accTitle;
       continue;
     }
     const accDescrStart = line2.match(/^accDescr\s*:?\s*\{\s*(.*)$/i);
     if (accDescrStart) {
-      const parsed = collectAccessibilityBlock2(accDescrStart[1] ?? "", lines, i2);
+      const parsed = collectAccessibilityBlock(accDescrStart[1] ?? "", lines, i2);
       if (parsed) {
         diagram.accessibilityDescription = normalizeBrTags(parsed.text);
         i2 = parsed.nextIndex;
       }
       continue;
     }
-    const accDescr = parseAccessibilityLine2(line2, "accDescr");
+    const accDescr = parseAccessibilityLine(line2, "accDescr");
     if (accDescr !== void 0) {
       diagram.accessibilityDescription = accDescr;
       continue;
@@ -16263,11 +16430,11 @@ function parseSequenceDiagram(lines) {
   }
   return diagram;
 }
-function parseAccessibilityLine2(line2, directive) {
+function parseAccessibilityLine(line2, directive) {
   const match = line2.match(new RegExp(`^${directive}\\s*:?[ \\t]+(.+)$`, "i"));
   return match ? normalizeBrTags(match[1].trim()) : void 0;
 }
-function collectAccessibilityBlock2(initial, lines, startIndex) {
+function collectAccessibilityBlock(initial, lines, startIndex) {
   const initialEnd = initial.indexOf("}");
   if (initialEnd !== -1) return { text: initial.slice(0, initialEnd).trim(), nextIndex: startIndex };
   const parts = [initial.trim()].filter(Boolean);
@@ -17136,19 +17303,19 @@ function parseClassDiagram(lines) {
   let braceDepth = 0;
   for (let i2 = 1; i2 < lines.length; i2++) {
     const line2 = lines[i2];
-    const accTitle = parseAccessibilityLine3(line2, "accTitle");
+    const accTitle = parseAccessibilityLine2(line2, "accTitle");
     if (accTitle !== void 0) {
       diagram.accessibilityTitle = accTitle;
       continue;
     }
     const accDescrStart = line2.match(/^accDescr\s*:?\s*\{\s*(.*)$/i);
     if (accDescrStart) {
-      const parsed = collectAccessibilityBlock3(accDescrStart[1] ?? "", lines, i2);
+      const parsed = collectAccessibilityBlock2(accDescrStart[1] ?? "", lines, i2);
       diagram.accessibilityDescription = normalizeBrTags(parsed.text);
       i2 = parsed.nextIndex;
       continue;
     }
-    const accDescr = parseAccessibilityLine3(line2, "accDescr");
+    const accDescr = parseAccessibilityLine2(line2, "accDescr");
     if (accDescr !== void 0) {
       diagram.accessibilityDescription = accDescr;
       continue;
@@ -17247,11 +17414,11 @@ function parseClassDiagram(lines) {
   diagram.classes = [...classMap.values()];
   return diagram;
 }
-function parseAccessibilityLine3(line2, directive) {
+function parseAccessibilityLine2(line2, directive) {
   const match = line2.match(new RegExp(`^${directive}\\s*:?[ \\t]+(.+)$`, "i"));
   return match ? normalizeBrTags(match[1].trim()) : void 0;
 }
-function collectAccessibilityBlock3(initial, lines, startIndex) {
+function collectAccessibilityBlock2(initial, lines, startIndex) {
   const initialEnd = initial.indexOf("}");
   if (initialEnd !== -1) return { text: initial.slice(0, initialEnd).trim(), nextIndex: startIndex };
   const parts = [initial.trim()].filter(Boolean);
@@ -17999,19 +18166,19 @@ function parseErDiagram(lines) {
   let currentEntity = null;
   for (let i2 = 1; i2 < lines.length; i2++) {
     const line2 = lines[i2];
-    const accTitle = parseAccessibilityLine4(line2, "accTitle");
+    const accTitle = parseAccessibilityLine3(line2, "accTitle");
     if (accTitle !== void 0) {
       diagram.accessibilityTitle = accTitle;
       continue;
     }
     const accDescrStart = line2.match(/^accDescr\s*:?\s*\{\s*(.*)$/i);
     if (accDescrStart) {
-      const parsed = collectAccessibilityBlock4(accDescrStart[1] ?? "", lines, i2);
+      const parsed = collectAccessibilityBlock3(accDescrStart[1] ?? "", lines, i2);
       diagram.accessibilityDescription = normalizeBrTags(parsed.text);
       i2 = parsed.nextIndex;
       continue;
     }
-    const accDescr = parseAccessibilityLine4(line2, "accDescr");
+    const accDescr = parseAccessibilityLine3(line2, "accDescr");
     if (accDescr !== void 0) {
       diagram.accessibilityDescription = accDescr;
       continue;
@@ -18045,11 +18212,11 @@ function parseErDiagram(lines) {
   diagram.entities = [...entityMap.values()];
   return diagram;
 }
-function parseAccessibilityLine4(line2, directive) {
+function parseAccessibilityLine3(line2, directive) {
   const match = line2.match(new RegExp(`^${directive}\\s*:?[ \\t]+(.+)$`, "i"));
   return match ? normalizeBrTags(match[1].trim()) : void 0;
 }
-function collectAccessibilityBlock4(initial, lines, startIndex) {
+function collectAccessibilityBlock3(initial, lines, startIndex) {
   const initialEnd = initial.indexOf("}");
   if (initialEnd !== -1) return { text: initial.slice(0, initialEnd).trim(), nextIndex: startIndex };
   const parts = [initial.trim()].filter(Boolean);
@@ -19678,15 +19845,6 @@ function readTimelineScale(themeVariables, prefix, index) {
 }
 
 // src/journey/parser.ts
-function normalizeActorLabel(label) {
-  return normalizeJourneyLabel2(label.trim()).split("\n").map((part) => part.trim()).filter(Boolean).join(" / ");
-}
-function normalizeJourneyLabel2(label) {
-  return label.replace(/<br\s*\/?>/gi, "\n").replace(/\\n/g, "\n").replace(/<\/?(?:sub|sup|small|mark)\s*>/gi, "").replace(/\*\*(.+?)\*\*/g, "<b>$1</b>").replace(/(?<!\*)\*([^\s*](?:[^*]*[^\s*])?)\*(?!\*)/g, "<i>$1</i>").replace(/~~(.+?)~~/g, "<s>$1</s>");
-}
-function isJourneyComment2(line2) {
-  return line2.startsWith("%%") || line2.startsWith("#") || line2.startsWith("%");
-}
 function parseJourneyDiagram(lines) {
   const diagram = { sections: [] };
   let currentSection;
@@ -19701,67 +19859,25 @@ function parseJourneyDiagram(lines) {
     diagram.sections.push(currentSection);
     return currentSection;
   };
-  for (let i2 = 1; i2 < lines.length; i2++) {
-    const line2 = lines[i2];
-    if (/^journey\b/i.test(line2)) continue;
-    if (isJourneyComment2(line2)) continue;
-    const accTitle = parseAccessibilityLine5(line2, "accTitle");
-    if (accTitle !== void 0) {
-      diagram.accessibilityTitle = accTitle;
-      continue;
-    }
-    const accDescrStart = line2.match(/^accDescr\s*:?\s*\{\s*(.*)$/i);
-    if (accDescrStart) {
-      const initial = accDescrStart[1] ?? "";
-      const parsed = collectAccessibilityBlock5(initial, lines, i2);
-      diagram.accessibilityDescription = normalizeJourneyLabel2(parsed.text);
-      i2 = parsed.nextIndex;
-      continue;
-    }
-    const accDescr = parseAccessibilityLine5(line2, "accDescr");
-    if (accDescr !== void 0) {
-      diagram.accessibilityDescription = accDescr;
-      continue;
-    }
-    const titleMatch = line2.match(/^title\s+(.+)$/i);
-    if (titleMatch) {
-      diagram.title = normalizeJourneyLabel2(titleMatch[1].trim());
-      continue;
-    }
-    const sectionMatch = line2.match(/^section\s+(.+)$/i);
-    if (sectionMatch) {
-      const label = normalizeJourneyLabel2(sectionMatch[1].trim());
-      if (label.includes(":")) {
-        throw syntaxError({
-          what: `Invalid user journey section: "${line2}"`,
-          expectedForm: "section Section name",
-          example: "section Go to work"
-        });
-      }
+  walkJourneyLines(lines, 1, {
+    title: (text3) => {
+      diagram.title = text3;
+    },
+    accTitle: (text3) => {
+      diagram.accessibilityTitle = text3;
+    },
+    accDescr: (text3) => {
+      diagram.accessibilityDescription = text3;
+    },
+    section: (label) => {
       currentSection = {
         id: `section-${sectionIndex++}`,
         label,
         tasks: []
       };
       diagram.sections.push(currentSection);
-      continue;
-    }
-    const taskMatch = line2.match(/^(.+?)\s*:\s*([0-9]+)\s*(?::\s*(.*))?$/);
-    if (taskMatch) {
-      const text3 = normalizeJourneyLabel2(taskMatch[1].trim());
-      const rawScore = taskMatch[2];
-      const score = Number.parseInt(rawScore, 10);
-      if (!text3) {
-        throw syntaxError({
-          what: `Invalid user journey task: "${line2}"`,
-          expectedForm: "Task name: score: Actor[, Actor\u2026]",
-          example: "Pay: 3: Shopper"
-        });
-      }
-      if (!Number.isInteger(score) || score < 1 || score > 5) {
-        throw invalidJourneyScoreError(text3, rawScore);
-      }
-      const actors = (taskMatch[3] ?? "").split(",").map(normalizeActorLabel).filter(Boolean);
+    },
+    task: (text3, score, actors) => {
       const task = {
         id: `task-${taskIndex++}`,
         text: text3,
@@ -19769,57 +19885,38 @@ function parseJourneyDiagram(lines) {
         actors
       };
       ensureSection().tasks.push(task);
-      continue;
-    }
-    const invalidScore = parseInvalidTaskScore(line2);
-    if (invalidScore) {
-      throw invalidJourneyScoreError(invalidScore.text, invalidScore.rawScore);
+    },
+    issue: (issue) => {
+      throw journeyIssueError(issue);
     }
-    throw new Error(`Invalid user journey line: "${line2}". Expected title, section, accessibility metadata, or "Task name: 3: Actor"`);
-  }
+  });
   if (diagram.sections.length === 0 && !diagram.title && diagram.sections.every((section) => section.tasks.length === 0) && !diagram.accessibilityTitle && !diagram.accessibilityDescription) {
     throw new Error("Journey diagram must include at least one scored task, a section, or a title");
   }
   return diagram;
 }
-function parseInvalidTaskScore(line2) {
-  const match = line2.match(/^(.+?)\s*:\s*([^:]+?)(?:\s*:\s*.*)?$/);
-  if (!match) return null;
-  const text3 = normalizeJourneyLabel2(match[1].trim());
-  const rawScore = match[2].trim();
-  if (!text3 || !rawScore) return null;
-  return { text: text3, rawScore };
-}
-function invalidJourneyScoreError(text3, rawScore) {
-  return new Error(`Journey task "${text3}" has invalid score ${rawScore}. Expected an integer from 1 through 5`);
-}
-function parseAccessibilityLine5(line2, directive) {
-  const match = line2.match(new RegExp(`^${directive}\\s*:[ \\t]*(.+)$`, "i"));
-  return match ? normalizeJourneyLabel2(match[1].trim()) : void 0;
-}
-function collectAccessibilityBlock5(initial, lines, startIndex) {
-  const initialEnd = initial.indexOf("}");
-  if (initialEnd !== -1) {
-    return {
-      text: initial.slice(0, initialEnd).trim(),
-      nextIndex: startIndex
-    };
-  }
-  const parts = [initial.trim()].filter(Boolean);
-  for (let i2 = startIndex + 1; i2 < lines.length; i2++) {
-    const line2 = lines[i2];
-    const end = line2.indexOf("}");
-    if (end !== -1) {
-      const beforeBrace = line2.slice(0, end).trim();
-      if (beforeBrace) parts.push(beforeBrace);
-      return {
-        text: parts.join("\n"),
-        nextIndex: i2
-      };
-    }
-    parts.push(line2);
+function journeyIssueError(issue) {
+  switch (issue.code) {
+    case "section_colon":
+      return syntaxError({
+        what: `Invalid user journey section: "${issue.statement}"`,
+        expectedForm: "section Section name",
+        example: "section Go to work"
+      });
+    case "empty_task_text":
+      return syntaxError({
+        what: `Invalid user journey task: "${issue.statement}"`,
+        expectedForm: "Task name: score: Actor[, Actor\u2026]",
+        example: "Pay: 3: Shopper"
+      });
+    case "invalid_score":
+    case "unclosed_accdescr":
+      return new Error(issue.detail);
+    case "empty_title":
+    case "unrecognized_line":
+    case "empty_journey":
+      return new Error(`Invalid user journey line: "${issue.statement}". Expected title, section, accessibility metadata, or "Task name: 3: Actor"`);
   }
-  throw new Error('Journey accDescr block is missing a closing "}"');
 }
 
 // src/journey/layout.ts
@@ -19835,6 +19932,7 @@ var JY = {
   sectionHeaderPadX: 16,
   sectionTaskGap: 30,
   sectionSpanPadX: 10,
+  sectionGap: 8,
   legendGap: 26,
   legendMinWidth: 96,
   legendTitleGap: 26,
@@ -19855,8 +19953,10 @@ var JY = {
   taskToGuideGap: 56,
   scoreStep: 40,
   markerRadius: 16,
-  baselineGap: 58,
-  minPlotWidth: 320
+  baselineGap: 32,
+  baselineClearance: 6,
+  arrowOverhang: 28,
+  minPlotWidth: 200
 };
 var JOURNEY_STYLE_DEFAULTS = {
   nodeLabelFontSize: JY.taskFontSize,
@@ -19931,7 +20031,12 @@ function layoutJourneyDiagram(diagram, options = {}) {
     )
   ) : 0;
   const sectionMetrics = diagram.sections.map((section) => {
-    const label = section.label ? applyTextTransform(section.label, style.groupTextTransform) : void 0;
+    const label = section.label ? wrapLabelToWidth(
+      applyTextTransform(section.label, style.groupTextTransform),
+      visual.maxLabelWidth,
+      style.groupHeaderFontSize,
+      style.groupHeaderFontWeight
+    ) : void 0;
     const labelWidth = label ? measureMultilineText(label, style.groupHeaderFontSize, style.groupHeaderFontWeight).width : 0;
     const tasks = section.tasks.map((task) => measureTask(task.text, task.actors.length, style, visual));
     const emptyWidth = Math.max(visual.taskMinWidth, labelWidth + JY.sectionHeaderPadX * 2);
@@ -19959,57 +20064,53 @@ function layoutJourneyDiagram(diagram, options = {}) {
   for (let sectionIndex = 0; sectionIndex < diagram.sections.length; sectionIndex++) {
     const section = diagram.sections[sectionIndex];
     const metric = sectionMetrics[sectionIndex];
+    const framed = !!metric.label;
+    if (sectionIndex > 0) cursorX += JY.sectionGap;
+    const taskSpan = metric.tasks.length > 0 ? metric.tasks.reduce((sum, task) => sum + task.width, 0) + (metric.tasks.length - 1) * visual.taskGap : 0;
+    const spanWidth = framed ? Math.max(
+      taskSpan > 0 ? taskSpan + JY.sectionSpanPadX * 2 : metric.emptyWidth,
+      metric.labelWidth + JY.sectionHeaderPadX * 2
+    ) : Math.max(taskSpan, metric.tasks.length === 0 ? metric.emptyWidth : 0);
+    const spanX = cursorX;
     const tasks = [];
-    let sectionStartX = cursorX;
-    let sectionEndX = cursorX;
-    if (section.tasks.length === 0) {
-      if (cursorX > plotLeft) cursorX += visual.taskGap;
-      sectionStartX = cursorX;
-      cursorX += metric.emptyWidth;
-      sectionEndX = cursorX;
-    } else {
-      for (let taskIndex = 0; taskIndex < section.tasks.length; taskIndex++) {
-        const task = section.tasks[taskIndex];
-        const taskMetric = metric.tasks[taskIndex];
-        if (cursorX > plotLeft) cursorX += visual.taskGap;
-        if (tasks.length === 0) sectionStartX = cursorX;
-        const x2 = cursorX;
-        const centerX = x2 + taskMetric.width / 2;
-        const markerY = scoreToY(task.score, guideTop);
-        const actorDots = positionActorDots(task, actorIndex, centerX, taskY + taskMetric.height - style.nodePaddingY - JY.actorDotRadius);
-        tasks.push({
-          id: task.id,
-          sectionId: section.id,
-          text: taskMetric.text,
-          score: task.score,
-          actors: task.actors,
-          x: x2,
-          y: taskY,
-          width: taskMetric.width,
-          height: taskMetric.height,
-          textX: centerX,
-          textY: taskY + style.nodePaddingY + taskMetric.textHeight / 2,
-          centerX,
-          track: {
-            x: centerX,
-            y1: taskY + taskMetric.height,
-            y2: baselineY
-          },
-          marker: {
-            cx: centerX,
-            cy: markerY,
-            r: JY.markerRadius,
-            score: task.score
-          },
-          actorDots
-        });
-        cursorX += taskMetric.width;
-        sectionEndX = cursorX;
-      }
+    let taskX = spanX + (spanWidth - taskSpan) / 2;
+    for (let taskIndex = 0; taskIndex < section.tasks.length; taskIndex++) {
+      const task = section.tasks[taskIndex];
+      const taskMetric = metric.tasks[taskIndex];
+      if (taskIndex > 0) taskX += visual.taskGap;
+      const x2 = taskX;
+      const centerX = x2 + taskMetric.width / 2;
+      const markerY = scoreToY(task.score, guideTop);
+      const actorDots = positionActorDots(task, actorIndex, centerX, taskY + taskMetric.height - style.nodePaddingY - JY.actorDotRadius);
+      tasks.push({
+        id: task.id,
+        sectionId: section.id,
+        text: taskMetric.text,
+        score: task.score,
+        actors: task.actors,
+        x: x2,
+        y: taskY,
+        width: taskMetric.width,
+        height: taskMetric.height,
+        textX: centerX,
+        textY: taskY + style.nodePaddingY + taskMetric.textHeight / 2,
+        centerX,
+        track: {
+          x: centerX,
+          y1: taskY + taskMetric.height,
+          y2: baselineY
+        },
+        marker: {
+          cx: centerX,
+          cy: markerY,
+          r: JY.markerRadius,
+          score: task.score
+        },
+        actorDots
+      });
+      taskX += taskMetric.width;
     }
-    const framed = !!metric.label;
-    const spanX = framed ? sectionStartX - JY.sectionSpanPadX : sectionStartX;
-    const spanWidth = framed ? Math.max(metric.labelWidth + JY.sectionHeaderPadX * 2, sectionEndX - sectionStartX + JY.sectionSpanPadX * 2) : Math.max(0, sectionEndX - sectionStartX);
+    cursorX = spanX + spanWidth;
     sections.push({
       id: section.id,
       label: metric.label,
@@ -20024,7 +20125,7 @@ function layoutJourneyDiagram(diagram, options = {}) {
       tasks
     });
   }
-  const naturalPlotRight = cursorX;
+  const naturalPlotRight = cursorX + JY.arrowOverhang;
   const plotRight = Math.max(naturalPlotRight, plotLeft + JY.minPlotWidth);
   const maxSectionRight = Math.max(plotRight, ...sections.map((section) => section.x + section.width));
   const width = maxSectionRight + visual.paddingX;
@@ -20043,7 +20144,7 @@ function layoutJourneyDiagram(diagram, options = {}) {
   });
   const legendBottom = actors.length > 0 ? actors[actors.length - 1].y + JY.legendDotRadius : 0;
   const height = Math.max(
-    baselineY + JY.markerRadius + visual.paddingY,
+    baselineY + JY.baselineClearance + visual.paddingY,
     legendBottom + visual.paddingY
   );
   return {
@@ -20084,7 +20185,12 @@ function layoutJourneyDiagram(diagram, options = {}) {
   };
 }
 function measureTask(text3, actorCount, style, visual) {
-  const taskText = applyTextTransform(text3, style.nodeTextTransform);
+  const taskText = wrapLabelToWidth(
+    applyTextTransform(text3, style.nodeTextTransform),
+    visual.maxLabelWidth,
+    style.nodeLabelFontSize,
+    style.nodeLabelFontWeight
+  );
   const textMetrics = measureMultilineText(taskText, style.nodeLabelFontSize, style.nodeLabelFontWeight);
   const actorDotsWidth = actorCount > 0 ? actorCount * JY.actorDotRadius * 2 + (actorCount - 1) * JY.actorDotGap : 0;
   const width = Math.max(
@@ -20147,7 +20253,8 @@ function breakWordToWidth(word, maxWidth, fontSize, fontWeight) {
   for (const char of [...word]) {
     const candidate = current + char;
     if (current && measureTextWidth(stripFormattingTags(candidate), fontSize, fontWeight) > maxWidth) {
-      lines.push(`${current}-`);
+      const breakIsFullwidth = isFullwidthChar(current[current.length - 1]) && isFullwidthChar(char);
+      lines.push(breakIsFullwidth ? current : `${current}-`);
       current = char;
     } else {
       current = candidate;
@@ -20156,6 +20263,9 @@ function breakWordToWidth(word, maxWidth, fontSize, fontWeight) {
   if (current) lines.push(current);
   return lines.join("\n");
 }
+function isFullwidthChar(char) {
+  return /[ᄀ-ᅟ⺀-꓏가-힣豈-﫿︰-﹏＀-｠￠-￦\u{1F300}-\u{1FAFF}\u{20000}-\u{2FA1F}]/u.test(char);
+}
 function cssFontSizeToPx(value, fallback) {
   if (typeof value === "number" && Number.isFinite(value) && value > 0) return value;
   if (typeof value !== "string") return fallback;
@@ -20191,9 +20301,9 @@ function positionActorDots(task, actorIndex, centerX, y2) {
   });
 }
 function scoreToY(score, guideTop) {
-  return guideTop + (JOURNEY_MAX_SCORE - score) * JY.scoreStep;
+  return guideTop + (JOURNEY_MAX_SCORE2 - score) * JY.scoreStep;
 }
-var JOURNEY_MAX_SCORE = 5;
+var JOURNEY_MAX_SCORE2 = 5;
 
 // src/xychart/colors.ts
 var CHART_ACCENT_FALLBACK = "#3b82f6";
@@ -20284,7 +20394,7 @@ var JY2 = {
   legendLabelGap: 12,
   legendTitleGap: 26
 };
-var JOURNEY_MAX_SCORE2 = 5;
+var JOURNEY_MAX_SCORE3 = 5;
 function renderJourneySvg(ctx) {
   return DefaultBackend.render(lowerJourneyScene(ctx), { seed: 0 });
 }
@@ -20295,13 +20405,18 @@ function lowerJourneyScene(ctx) {
   const parts = [];
   const style = resolveJourneyStyle(options);
   const visual = resolveJourneyVisualConfig(options);
-  const paints = journeyPaints(style, visual, colors);
+  const paints = journeyPaints(style, visual, colors, {
+    sectionCount: diagram.sections.length,
+    actorCount: diagram.actors.length
+  });
   const accessibility = buildJourneyAccessibility(diagram);
   const uid = journeyNamespace(diagram);
   const arrowMarkerId = `${uid}-arrowhead`;
   const titleId = `${uid}-title`;
   const descId = `${uid}-desc`;
-  const journeyCss = journeyStyles(style, visual, paints);
+  const curveMarkers = options.journey?.experienceCurve !== false ? diagram.sections.flatMap((section) => section.tasks.map((task) => task.marker)) : [];
+  const drawCurve = curveMarkers.length >= 2;
+  const journeyCss = journeyStyles(style, visual, paints, drawCurve);
   parts.push(prelude(
     {
       id: "prelude",
@@ -20313,7 +20428,7 @@ function lowerJourneyScene(ctx) {
       hasMonoFont: false,
       extraCss: journeyCss
     },
-    openJourneySvgTag(diagram, colors, transparent, accessibility, titleId, descId)
+    openJourneySvgTag(diagram, colors, transparent, accessibility, titleId, descId, options.mermaidConfig?.journey?.useMaxWidth === true)
   ));
   if (accessibility.title) {
     parts.push(raw(
@@ -20342,6 +20457,9 @@ function lowerJourneyScene(ctx) {
       parts.push(renderSectionFrame(section, style, paints, index));
     }
   });
+  if (drawCurve) {
+    parts.push(renderExperienceCurve(curveMarkers, style, paints));
+  }
   for (const section of diagram.sections) {
     for (const task of section.tasks) {
       parts.push(renderTask(task, section.label, style, paints));
@@ -20397,8 +20515,9 @@ function buildJourneyAccessibility(diagram) {
     description: diagram.accessibilityDescription
   };
 }
-function openJourneySvgTag(diagram, colors, transparent, accessibility, titleId, descId) {
+function openJourneySvgTag(diagram, colors, transparent, accessibility, titleId, descId, useMaxWidth) {
   return svgOpenTag(diagram.width, diagram.height, colors, transparent, {
+    ...useMaxWidth ? { width: "100%", height: "100%", style: `max-width:${diagram.width}px` } : {},
     attrs: buildAccessibilityAttrs(accessibility.title, accessibility.description, titleId, descId, "user journey")
   });
 }
@@ -20413,7 +20532,7 @@ function buildJourneyDefs(colors, paints, arrowMarkerId) {
 ${defs.join("\n")}
 </defs>`;
 }
-function journeyStyles(style, visual, paints) {
+function journeyStyles(style, visual, paints, drawCurve) {
   const sectionPalette = sectionPaletteCss(paints);
   const sectionBandPalette = sectionBandPaletteCss(paints);
   const sectionLabelPalette = sectionLabelPaletteCss(paints);
@@ -20428,7 +20547,8 @@ ${sectionBandPalette}
 ${sectionLabelPalette}
   .journey-task-box { fill: ${paints.nodeFill}; stroke: ${paints.nodeStroke}; stroke-width: ${style.nodeLineWidth}; }
   .journey-task-text { fill: ${style.nodeTextColor ?? "var(--_text)"};${visual.taskFontFamily ? ` font-family: ${visual.taskFontFamily};` : ""} }
-  .journey-track { stroke: color-mix(in srgb, ${paints.nodeStroke} 78%, var(--bg)); stroke-width: ${style.lineWidth}; stroke-dasharray: 4 7; }
+  .journey-track { stroke: color-mix(in srgb, ${paints.nodeStroke} 78%, var(--bg)); stroke-width: ${style.lineWidth}; stroke-dasharray: 4 7; }${drawCurve ? `
+  .journey-curve { fill: none; stroke: color-mix(in srgb, ${paints.arrow} 55%, var(--bg)); stroke-width: ${Math.max(2, style.lineWidth * 2)}; stroke-linecap: round; }` : ""}
   .journey-guide { stroke: color-mix(in srgb, ${paints.nodeStroke} 62%, var(--bg)); stroke-width: 1; }
   .journey-score-label { fill: ${style.edgeTextColor ?? "var(--_text-sec)"}; }
   .journey-baseline { stroke: ${paints.arrow}; stroke-width: ${Math.max(2, style.lineWidth * 2)}; }
@@ -20441,6 +20561,34 @@ ${sectionLabelPalette}
 ${actorPalette2}
 </style>`;
 }
+function renderExperienceCurve(markers, style, paints) {
+  const points = markers.map((marker) => ({ x: marker.cx, y: marker.cy }));
+  const d2 = smoothCurvePath(points);
+  return connector(
+    {
+      id: "experience-curve",
+      role: "series",
+      geometry: { kind: "path", d: d2, points },
+      lineStyle: "solid",
+      paint: {
+        stroke: `color-mix(in srgb, ${paints.arrow} 55%, var(--bg))`,
+        strokeWidth: String(Math.max(2, style.lineWidth * 2))
+      }
+    },
+    `<path class="journey-curve" d="${d2}" />`
+  );
+}
+function smoothCurvePath(points) {
+  const first = points[0];
+  let d2 = `M${first.x},${first.y}`;
+  for (let i2 = 1; i2 < points.length; i2++) {
+    const from = points[i2 - 1];
+    const to = points[i2];
+    const dx = (to.x - from.x) / 3;
+    d2 += ` C${from.x + dx},${from.y} ${to.x - dx},${to.y} ${to.x},${to.y}`;
+  }
+  return d2;
+}
 function renderScoreGuide(guide, style, arrowMarkerId) {
   const children = [];
   for (const tick of guide.ticks) {
@@ -20456,7 +20604,7 @@ function renderScoreGuide(guide, style, arrowMarkerId) {
             stroke: `color-mix(in srgb, ${style.nodeBorderColor ?? "var(--_node-stroke)"} 62%, var(--bg))`,
             strokeWidth: "1"
           },
-          channels: { value: tick.score / JOURNEY_MAX_SCORE2 }
+          channels: { value: tick.score / JOURNEY_MAX_SCORE3 }
         },
         `<line class="journey-guide" x1="${tick.x1}" y1="${tick.y}" x2="${tick.x2}" y2="${tick.y}" />`
       )
@@ -20473,7 +20621,7 @@ function renderScoreGuide(guide, style, arrowMarkerId) {
           fontSize: style.edgeLabelFontSize,
           anchor: "end",
           paint: { fill: style.edgeTextColor ?? "var(--_text-sec)" },
-          channels: { value: tick.score / JOURNEY_MAX_SCORE2 }
+          channels: { value: tick.score / JOURNEY_MAX_SCORE3 }
         },
         renderMultilineText(
           String(tick.score),
@@ -20664,7 +20812,7 @@ function renderSectionLabelBand(section, style, paints, sectionIndex) {
 function renderTask(task, sectionLabel, style, paints) {
   const sectionAttr = sectionLabel ? ` data-section="${escapeAttr(sectionLabel)}"` : "";
   const actorAttr = task.actors.length > 0 ? ` data-actors="${escapeAttr(task.actors.join(", "))}"` : "";
-  const value = task.score / JOURNEY_MAX_SCORE2;
+  const value = task.score / JOURNEY_MAX_SCORE3;
   const channels = sectionLabel ? { value, category: sectionLabel } : { value };
   const children = [
     { indent: 2, node: renderTrack(task.track, task, style, paints) },
@@ -20696,7 +20844,7 @@ function renderTrack(track, task, style, paints) {
         strokeWidth: String(style.lineWidth),
         strokeDasharray: "4 7"
       },
-      channels: { value: task.score / JOURNEY_MAX_SCORE2 }
+      channels: { value: task.score / JOURNEY_MAX_SCORE3 }
     },
     `<line class="journey-track" x1="${track.x}" y1="${track.y1}" x2="${track.x}" y2="${track.y2}" />`
   );
@@ -20827,18 +20975,18 @@ function mouthPath(marker) {
   if (marker.score === 2) return `M${cx - 8},${cy + 10} Q${cx},${cy + 2} ${cx + 8},${cy + 10}`;
   return `M${cx - 9},${cy + 11} Q${cx},${cy} ${cx + 9},${cy + 11}`;
 }
-function journeyPaints(style, visual, colors) {
+function journeyPaints(style, visual, colors, counts) {
   const arrow = style.edgeStrokeColor ?? "var(--_arrow)";
   const nodeFill = style.nodeFillColor ?? "var(--_node-fill)";
   const nodeStroke = style.nodeBorderColor ?? "var(--_node-stroke)";
   const groupFill = style.groupFillColor ?? `color-mix(in srgb, ${arrow} 8%, var(--bg))`;
   const groupStroke = style.groupBorderColor ?? "var(--_node-stroke)";
   const groupText = style.groupTextColor ?? "var(--_text-sec)";
-  const sectionBases = paletteBases(arrow, colors, style);
+  const sectionBases = paletteBases(arrow, colors, style, counts.sectionCount);
   const configuredSectionCount = Math.max(
     visual.sectionFills.length,
     visual.sectionColours.length,
-    sectionBases.length
+    Math.min(sectionBases.length, Math.max(counts.sectionCount, 1))
   );
   const sectionFills = Array.from({ length: configuredSectionCount }, (_unused, index) => {
     const explicitFill = visual.sectionFills[index % visual.sectionFills.length];
@@ -20846,7 +20994,7 @@ function journeyPaints(style, visual, colors) {
   });
   const sectionBands = Array.from({ length: configuredSectionCount }, (_unused, index) => {
     const explicitFill = visual.sectionFills[index % visual.sectionFills.length];
-    return explicitFill ? `color-mix(in srgb, ${explicitFill} ${index === 0 ? 14 : 16}%, var(--bg))` : style.groupHeaderFillColor ?? `color-mix(in srgb, ${sectionBases[index % sectionBases.length]} ${index === 0 ? 14 : 16}%, var(--bg))`;
+    return explicitFill ?? style.groupHeaderFillColor ?? `color-mix(in srgb, ${sectionBases[index % sectionBases.length]} ${index === 0 ? 14 : 16}%, var(--bg))`;
   });
   const sectionStrokes = Array.from({ length: configuredSectionCount }, (_unused, index) => {
     const explicitFill = visual.sectionFills[index % visual.sectionFills.length];
@@ -20854,9 +21002,13 @@ function journeyPaints(style, visual, colors) {
   });
   const sectionTextColors = Array.from(
     { length: configuredSectionCount },
-    (_unused, index) => visual.sectionColours[index % visual.sectionColours.length] ?? style.groupTextColor ?? "var(--_text)"
+    (_unused, index) => contrastGuardedLabelColor(
+      visual.sectionColours.length > 0 ? visual.sectionColours[index % visual.sectionColours.length] : void 0,
+      sectionBands[index],
+      style.groupTextColor ?? "var(--_text)"
+    )
   );
-  const actorColors = visual.actorColours.length > 0 ? visual.actorColours : actorPalette(arrow, colors, style);
+  const actorColors = visual.actorColours.length > 0 ? visual.actorColours : actorPalette(arrow, colors, style, counts.actorCount);
   return {
     arrow,
     nodeFill,
@@ -20875,8 +21027,8 @@ function journeyPaints(style, visual, colors) {
     scoreFaceInk: style.edgeTextColor ?? style.nodeTextColor ?? "var(--_text)"
   };
 }
-function paletteBases(arrow, colors, style) {
-  const series = concreteSeriesColors(colors, style, 6);
+function paletteBases(arrow, colors, style, sectionCount) {
+  const series = concreteSeriesColors(colors, style, Math.max(6, sectionCount));
   if (series) return series;
   return [
     arrow,
@@ -20887,10 +21039,29 @@ function paletteBases(arrow, colors, style) {
     "var(--fg)"
   ];
 }
-function actorPalette(arrow, colors, style) {
-  const series = concreteSeriesColors(colors, style, 8);
-  if (series) return series;
-  return [
+function contrastGuardedLabelColor(explicit, band, fallback) {
+  if (!tryParseHex(band)) return explicit ?? fallback;
+  if (explicit) {
+    const ratio = wcagContrastRatio(explicit, band);
+    if (ratio === null || ratio >= 4.5) return explicit;
+  }
+  return contrastTextColor(band) ?? explicit ?? fallback;
+}
+function actorPalette(arrow, colors, style, actorCount) {
+  const count = Math.max(actorCount, 1);
+  if (isHexColor(colors.bg) && isHexColor(colors.fg)) {
+    const resolved = resolveColors(colors);
+    const accent = firstHexColor(style.edgeStrokeColor, colors.accent, resolved.arrow);
+    if (accent) {
+      const [accentHue, accentSat] = hexToHsl(accent);
+      const dark = isDarkBackground(colors.bg);
+      const baseHue = accentSat < 20 ? 230 : accentHue;
+      const saturation = Math.min(72, Math.max(42, accentSat < 20 ? 46 : accentSat));
+      const lightness = dark ? 64 : 38;
+      return Array.from({ length: count }, (_unused, index) => hslToHex((baseHue + index * 137.508) % 360, saturation, lightness));
+    }
+  }
+  const fallback = [
     arrow,
     "var(--line, var(--_line))",
     "var(--accent, var(--_arrow))",
@@ -20900,6 +21071,7 @@ function actorPalette(arrow, colors, style) {
     "color-mix(in srgb, var(--accent, var(--_arrow)) 62%, var(--bg))",
     "color-mix(in srgb, var(--line, var(--_line)) 72%, var(--bg))"
   ];
+  return fallback.slice(0, Math.max(count <= fallback.length ? count : fallback.length, 1));
 }
 function concreteSeriesColors(colors, style, count) {
   if (!isHexColor(colors.bg) || !isHexColor(colors.fg)) return void 0;
@@ -22814,7 +22986,7 @@ function letterAttr7(value) {
 }
 
 // src/quadrant/parser.ts
-var TITLE_RE5 = /^title\s+(.+)$/i;
+var TITLE_RE4 = /^title\s+(.+)$/i;
 var AXIS_RE2 = /^([xy])-axis\s+(.+)$/i;
 var QUADRANT_RE2 = /^quadrant-([1-4])\s+(.+)$/i;
 var POINT_RE2 = /^(.+?)\s*:\s*\[\s*([^,\]]+)\s*,\s*([^,\]]+)\s*\]\s*(.*)$/;
@@ -22844,7 +23016,7 @@ function parseQuadrantChart(lines) {
       continue;
     }
     let m2;
-    if (m2 = line2.match(TITLE_RE5)) {
+    if (m2 = line2.match(TITLE_RE4)) {
       title = normalizeBrTags(m2[1].trim());
       continue;
     }
@@ -30013,6 +30185,72 @@ function renderErAscii(text3, config, colorMode, theme) {
   return canvasToString(canvas, { roleCanvas: rc, colorMode, theme });
 }
 
+// src/ascii/wrap.ts
+var segmenter = new Intl.Segmenter(void 0, { granularity: "grapheme" });
+function graphemes(text3) {
+  return Array.from(segmenter.segment(text3), (s2) => s2.segment);
+}
+function wrapText(text3, maxWidth, options) {
+  if (!maxWidth || !Number.isFinite(maxWidth) || maxWidth <= 0) return text3.split("\n");
+  const limit = Math.max(1, Math.floor(maxWidth));
+  const lines = [];
+  for (const paragraph of text3.split("\n")) {
+    lines.push(...wrapParagraph(paragraph, limit, options));
+  }
+  return lines.length > 0 ? lines : [""];
+}
+function wrapParagraph(text3, maxWidth, options) {
+  if (visualWidth(text3) <= maxWidth) return [text3];
+  const words = text3.split(/\s+/).filter(Boolean);
+  if (words.length === 0) return [""];
+  const lines = [];
+  let current = "";
+  for (const word of words) {
+    if (!current) {
+      const chunks2 = breakWord(word, maxWidth, options);
+      lines.push(...chunks2.slice(0, -1));
+      current = chunks2[chunks2.length - 1] ?? "";
+      continue;
+    }
+    const candidate = `${current} ${word}`;
+    if (visualWidth(candidate) <= maxWidth) {
+      current = candidate;
+      continue;
+    }
+    lines.push(current);
+    const chunks = breakWord(word, maxWidth, options);
+    lines.push(...chunks.slice(0, -1));
+    current = chunks[chunks.length - 1] ?? "";
+  }
+  if (current) lines.push(current);
+  return lines;
+}
+function breakWord(word, maxWidth, options) {
+  if (visualWidth(word) <= maxWidth) return [word];
+  const hyphenate = options?.hyphenate ?? true;
+  const clusters = graphemes(word);
+  const lines = [];
+  let start = 0;
+  while (start < clusters.length) {
+    let end = start + 1;
+    while (end < clusters.length && fitsWithBreak(clusters, start, end + 1, maxWidth, hyphenate)) end++;
+    const chunk = clusters.slice(start, end).join("");
+    const hyphen = end < clusters.length && breakNeedsHyphen(clusters[end - 1], clusters[end], hyphenate) && visualWidth(chunk) + 1 <= maxWidth;
+    lines.push(hyphen ? `${chunk}-` : chunk);
+    start = end;
+  }
+  return lines;
+}
+function fitsWithBreak(clusters, start, end, maxWidth, hyphenate) {
+  const width = visualWidth(clusters.slice(start, end).join(""));
+  const hyphen = end < clusters.length && breakNeedsHyphen(clusters[end - 1], clusters[end], hyphenate) ? 1 : 0;
+  return width + hyphen <= maxWidth;
+}
+function breakNeedsHyphen(before, after, hyphenate) {
+  if (!hyphenate) return false;
+  return !(visualWidth(before) === 2 && visualWidth(after) === 2);
+}
+
 // src/ascii/timeline.ts
 function renderStyledLine(segments, colorMode, theme) {
   const chars = [];
@@ -30025,7 +30263,7 @@ function renderStyledLine(segments, colorMode, theme) {
   }
   return colorizeLine(chars, roles, theme, colorMode);
 }
-function renderTimelineAscii(lines, config, colorMode = "none", theme = DEFAULT_ASCII_THEME) {
+function renderTimelineAscii(lines, config, colorMode = "none", theme = DEFAULT_ASCII_THEME, maxWidth) {
   const diagram = parseTimelineDiagram(lines);
   const useAscii = config.useAscii;
   const marker = useAscii ? "o" : "\u25CB";
@@ -30039,7 +30277,7 @@ function renderTimelineAscii(lines, config, colorMode = "none", theme = DEFAULT_
     out.push(segments.length === 0 ? "" : renderStyledLine(segments, colorMode, theme));
   };
   if (diagram.title) {
-    for (const line2 of diagram.title.split("\n")) {
+    for (const line2 of wrapText(diagram.title, maxWidth)) {
       pushLine([{ text: line2, role: "text" }]);
     }
     pushLine();
@@ -30047,15 +30285,19 @@ function renderTimelineAscii(lines, config, colorMode = "none", theme = DEFAULT_
   for (let sectionIndex = 0; sectionIndex < diagram.sections.length; sectionIndex++) {
     const section = diagram.sections[sectionIndex];
     if (section.label) {
-      pushLine([
-        { text: "[", role: "border" },
-        { text: section.label.replace(/\n/g, " / "), role: "text" },
-        { text: "]", role: "border" }
-      ]);
+      const labelLines = wrapText(section.label.replace(/\n/g, " / "), maxWidth ? Math.max(1, maxWidth - 2) : void 0);
+      labelLines.forEach((line2, index) => {
+        const segments = [
+          index === 0 ? { text: "[", role: "border" } : { text: " ", role: null },
+          { text: line2, role: "text" }
+        ];
+        if (index === labelLines.length - 1) segments.push({ text: "]", role: "border" });
+        pushLine(segments);
+      });
     }
     for (let periodIndex = 0; periodIndex < section.periods.length; periodIndex++) {
       const period = section.periods[periodIndex];
-      const periodLines = period.label.split("\n");
+      const periodLines = wrapText(period.label, maxWidth ? Math.max(1, maxWidth - 3) : void 0);
       pushLine([
         { text: marker, role: "junction" },
         { text: " ", role: null },
@@ -30069,7 +30311,7 @@ function renderTimelineAscii(lines, config, colorMode = "none", theme = DEFAULT_
       }
       for (let eventIndex = 0; eventIndex < period.events.length; eventIndex++) {
         const event = period.events[eventIndex];
-        const eventLines = event.text.split("\n");
+        const eventLines = wrapText(event.text, maxWidth ? Math.max(1, maxWidth - 6) : void 0);
         const junction = eventIndex === period.events.length - 1 ? lastBranch : branch;
         pushLine([
           { text: vertical, role: "line" },
@@ -30313,6 +30555,10 @@ function renderScoreSegments(score, useAscii) {
   ];
   return segments.filter((segment) => segment.text.length > 0);
 }
+var SCORE_BLOCKS = ["\u2581", "\u2582", "\u2584", "\u2586", "\u2588"];
+function renderScoreStrip(diagram, useAscii) {
+  return diagram.sections.map((section) => section.tasks.map((task) => useAscii ? String(task.score) : SCORE_BLOCKS[task.score - 1]).join("")).filter((group2) => group2.length > 0).join(" ");
+}
 function renderJourneyAscii(text3, config, colorMode = "none", theme = DEFAULT_ASCII_THEME, maxWidth) {
   const lines = preprocessMermaidLines(text3);
   const diagram = parseJourneyDiagram(lines);
@@ -30327,16 +30573,30 @@ function renderJourneyAscii(text3, config, colorMode = "none", theme = DEFAULT_A
     }
     pushLine();
   }
+  const scoreStrip = renderScoreStrip(diagram, useAscii);
+  if (scoreStrip) {
+    const stripPrefix = "scores: ";
+    const stripLines = wrapText(scoreStrip, maxWidth ? Math.max(1, maxWidth - stripPrefix.length) : void 0, { hyphenate: false });
+    stripLines.forEach((line2, index) => {
+      pushLine([
+        index === 0 ? { text: stripPrefix, role: "border" } : { text: " ".repeat(stripPrefix.length), role: null },
+        { text: line2, role: "arrow" }
+      ]);
+    });
+    pushLine();
+  }
   for (let sectionIndex = 0; sectionIndex < diagram.sections.length; sectionIndex++) {
     const section = diagram.sections[sectionIndex];
     if (section.label) {
-      for (const line2 of wrapText(section.label.replace(/\n/g, " / "), maxWidth ? Math.max(1, maxWidth - 2) : void 0)) {
-        pushLine([
-          { text: "[", role: "border" },
-          { text: line2, role: "text" },
-          { text: "]", role: "border" }
-        ]);
-      }
+      const labelLines = wrapText(section.label.replace(/\n/g, " / "), maxWidth ? Math.max(1, maxWidth - 2) : void 0);
+      labelLines.forEach((line2, index) => {
+        const segments = [
+          index === 0 ? { text: "[", role: "border" } : { text: " ", role: null },
+          { text: line2, role: "text" }
+        ];
+        if (index === labelLines.length - 1) segments.push({ text: "]", role: "border" });
+        pushLine(segments);
+      });
     }
     for (let taskIndex = 0; taskIndex < section.tasks.length; taskIndex++) {
       const task = section.tasks[taskIndex];
@@ -30376,60 +30636,6 @@ function renderJourneyAscii(text3, config, colorMode = "none", theme = DEFAULT_A
   }
   return out.join("\n").trimEnd();
 }
-function wrapText(text3, maxWidth) {
-  if (!maxWidth || !Number.isFinite(maxWidth) || maxWidth <= 0) return text3.split("\n");
-  const limit = Math.max(1, Math.floor(maxWidth));
-  const lines = [];
-  for (const paragraph of text3.split("\n")) {
-    lines.push(...wrapParagraph(paragraph, limit));
-  }
-  return lines.length > 0 ? lines : [""];
-}
-function wrapParagraph(text3, maxWidth) {
-  if (visualWidth(text3) <= maxWidth) return [text3];
-  const words = text3.split(/\s+/).filter(Boolean);
-  if (words.length === 0) return [""];
-  const lines = [];
-  let current = "";
-  for (const word of words) {
-    if (!current) {
-      const chunks2 = breakWord(word, maxWidth);
-      lines.push(...chunks2.slice(0, -1));
-      current = chunks2[chunks2.length - 1] ?? "";
-      continue;
-    }
-    const candidate = `${current} ${word}`;
-    if (visualWidth(candidate) <= maxWidth) {
-      current = candidate;
-      continue;
-    }
-    lines.push(current);
-    const chunks = breakWord(word, maxWidth);
-    lines.push(...chunks.slice(0, -1));
-    current = chunks[chunks.length - 1] ?? "";
-  }
-  if (current) lines.push(current);
-  return lines;
-}
-function breakWord(word, maxWidth) {
-  if (visualWidth(word) <= maxWidth) return [word];
-  const lines = [];
-  let current = "";
-  let width = 0;
-  for (const char of word) {
-    const charWidth = visualWidth(char);
-    if (current && width + charWidth > maxWidth) {
-      lines.push(current);
-      current = char;
-      width = charWidth;
-    } else {
-      current += char;
-      width += charWidth;
-    }
-  }
-  if (current) lines.push(current);
-  return lines;
-}
 
 // src/ascii/xychart.ts
 var PLOT_WIDTH = 60;
@@ -31418,7 +31624,7 @@ registerRenderHooks("timeline", {
   layout: (ctx) => layoutResult(layoutTimelineDiagram(parseTimelineDiagram(ctx.source.lines), ctx.options)),
   renderSvg: svg(renderTimelineSvg),
   lowerScene: scene(lowerTimelineScene),
-  renderAscii: (ctx) => renderTimelineAscii(ctx.source.lines, ctx.config, ctx.colorMode, ctx.theme)
+  renderAscii: (ctx) => renderTimelineAscii(ctx.source.lines, ctx.config, ctx.colorMode, ctx.theme, ctx.options.maxWidth)
 });
 registerRenderHooks("journey", {
   layout: (ctx) => layoutResult(layoutJourneyDiagram(parseJourneyDiagram(ctx.source.lines), ctx.renderOptions)),
@@ -34446,7 +34652,8 @@ function journeyToRendered(d2) {
         nodes.push({ id: t2.id, x: f3(t2.x), y: f3(t2.y), w: f3(t2.width), h: f3(t2.height), shape: "rectangle", label: t2.text });
         memberIds.push(t2.id);
       }
-      groups.push({ id: s2.id, x: f3(s2.x), y: f3(s2.y), w: f3(s2.width), h: f3(s2.height), members: memberIds, label: s2.label });
+      const bottom = s2.tasks.length > 0 ? Math.max(s2.y + s2.height, ...s2.tasks.map((t2) => t2.y + t2.height)) : s2.y + s2.height;
+      groups.push({ id: s2.id, x: f3(s2.x), y: f3(s2.y), w: f3(s2.width), h: f3(bottom - s2.y), members: memberIds, label: s2.label });
     }
     return { version: 1, kind: d2.kind, nodes, edges: [], groups, bounds: { w: f3(positioned.width), h: f3(positioned.height) } };
   } catch {
@@ -34923,6 +35130,35 @@ function withRenderParity(input, result, opts) {
     return { ...result, ok: false, warnings: [...result.warnings, { code: "RENDER_FAILED", reason }] };
   }
 }
+var JOURNEY_NOOP_CONFIG_FIELDS = [
+  "boxMargin",
+  "boxTextMargin",
+  "noteMargin",
+  "messageMargin",
+  "messageAlign",
+  "bottomMarginAdj",
+  "rightAngles",
+  "activationWidth",
+  "textPlacement"
+];
+function journeyIneffectiveConfigWarnings(d2) {
+  const configs = [
+    d2.meta.frontmatter?.journey,
+    ...d2.meta.initDirectives.map((directive) => directive.parsed?.journey)
+  ];
+  const present = /* @__PURE__ */ new Set();
+  for (const config of configs) {
+    if (!config || typeof config !== "object") continue;
+    for (const field of JOURNEY_NOOP_CONFIG_FIELDS) {
+      if (field in config) present.add(field);
+    }
+  }
+  return [...present].sort().map((field) => ({
+    code: "INEFFECTIVE_CONFIG",
+    field,
+    message: `Journey config field "${field}" is accepted for Mermaid config-shape compatibility but has no effect on journey geometry or paint.`
+  }));
+}
 function verifyStructure(input, opts = {}) {
   const d2 = typeof input === "string" ? unwrap(input) : input;
   if (!d2) return finalize([{ code: "EMPTY_DIAGRAM" }], emptyRenderedLayout("flowchart"), opts);
@@ -34930,7 +35166,8 @@ function verifyStructure(input, opts = {}) {
   const metaWarnings = d2.meta.droppedComments?.length ? [{ code: "COMMENT_DROPPED", count: d2.meta.droppedComments.length, lines: d2.meta.droppedComments.map((c2) => c2.line) }] : [];
   const sourceWarnings = d2.kind === "flowchart" ? flowchartUnsupportedSyntaxWarnings(d2.canonicalSource) : [];
   const faithfulnessWarnings = roundtripFaithfulnessWarnings(d2);
-  const pluginWarnings = dedupedConcat(dedupedConcat(dedupedConcat(metaWarnings, dispatchFamilyVerify(d2, opts)), sourceWarnings), faithfulnessWarnings);
+  const configWarnings = d2.kind === "journey" ? journeyIneffectiveConfigWarnings(d2) : [];
+  const pluginWarnings = dedupedConcat(dedupedConcat(dedupedConcat(dedupedConcat(metaWarnings, dispatchFamilyVerify(d2, opts)), sourceWarnings), faithfulnessWarnings), configWarnings);
   if (d2.body.kind === "sequence") return mergeFinalize(verifySequence(d2, cap, opts), pluginWarnings, opts);
   if (d2.body.kind === "timeline") return mergeFinalize(verifyTimeline(d2, cap, opts), pluginWarnings, opts);
   if (d2.body.kind === "gantt") {
@@ -34943,7 +35180,9 @@ function verifyStructure(input, opts = {}) {
     const layout = layoutFamilyToRendered(d2) ?? emptyRenderedLayout(d2.kind);
     const familyGeometry = d2.body.kind === "class" || d2.body.kind === "er" ? layoutGeometryWarnings(layout, { edgeAnchors: true, nodeOverlaps: true }) : layoutGeometryWarnings(layout, {
       nodeOverlaps: d2.body.kind === "journey",
-      groupContainment: d2.body.kind === "xychart" || d2.body.kind === "quadrant"
+      // Journey sections are groups with task members (family-layouts.ts),
+      // so a task laid outside its section band is a reportable breach.
+      groupContainment: d2.body.kind === "xychart" || d2.body.kind === "quadrant" || d2.body.kind === "journey"
     });
     return finalize(dedupedConcat(pluginWarnings, familyGeometry), layout, opts);
   }
@@ -35968,6 +36207,25 @@ function factsJourney(out, body) {
       if (s2.label) add(out, `journey task ${clean(t2.text)} section ${clean(s2.label)}`);
     });
   });
+  const tasks = body.sections.flatMap((s2) => s2.tasks);
+  add(out, `journey sections ${body.sections.length}`);
+  add(out, `journey tasks ${tasks.length}`);
+  const participation = /* @__PURE__ */ new Map();
+  for (const t2 of tasks) for (const a2 of t2.actors) participation.set(a2, (participation.get(a2) ?? 0) + 1);
+  add(out, `journey actors ${participation.size}`);
+  if (tasks.length > 0) {
+    const scores = tasks.map((t2) => t2.score);
+    const min = Math.min(...scores);
+    const max = Math.max(...scores);
+    const average = Math.round(scores.reduce((sum, score) => sum + score, 0) / scores.length * 100) / 100;
+    add(out, `journey score range ${min}..${max}`);
+    add(out, `journey average score ${num2(average)}`);
+    for (const t2 of tasks) {
+      if (t2.score === min) add(out, `journey lowest task ${clean(t2.text)} score ${num2(t2.score)}`);
+      if (t2.score === max) add(out, `journey highest task ${clean(t2.text)} score ${num2(t2.score)}`);
+    }
+  }
+  for (const [actor, count] of participation) add(out, `journey actor ${clean(actor)} tasks ${count}`);
 }
 function factsArchitecture(out, body) {
   for (const g2 of body.groups) {
@@ -36135,7 +36393,8 @@ function describeMermaidTree(d2) {
     }
   } else if (d2.body.kind === "journey") {
     for (const s2 of d2.body.sections) for (const t2 of s2.tasks) {
-      tree.nodes.push({ id: t2.id, label: t2.text });
+      const actors = t2.actors.length ? `; ${t2.actors.join(", ")}` : "";
+      tree.nodes.push({ id: t2.id, label: `${t2.text} (score ${t2.score}${actors})` });
     }
   } else if (d2.body.kind === "architecture") {
     for (const g2 of d2.body.groups) tree.nodes.push({ id: g2.id, label: g2.label || g2.id });
@@ -36790,16 +37049,223 @@ function sourceLineHints(d2) {
 
 // src/agent/png.ts
 import { fileURLToPath } from "url";
-import { join, dirname } from "path";
+import { join as join2, dirname } from "path";
 import { existsSync } from "fs";
 import { Resvg } from "@resvg/resvg-js";
+
+// src/agent/font-coverage.ts
+import { readdirSync, readFileSync, statSync } from "fs";
+import { join } from "path";
+import { decodeXML as decodeXML3 } from "entities";
+var TAG_TTCF = 1953784678;
+var TAG_OTTO = 1330926671;
+var TAG_TRUE = 1953658213;
+var TAG_CMAP = 1668112752;
+function parseFontFile(bytes) {
+  const dv = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  try {
+    if (dv.getUint32(0) === TAG_TTCF) {
+      const numFonts = dv.getUint32(8);
+      const lookups = [];
+      for (let i2 = 0; i2 < numFonts; i2++) lookups.push(...parseSfnt(dv, dv.getUint32(12 + i2 * 4)));
+      return lookups;
+    }
+    return parseSfnt(dv, 0);
+  } catch {
+    return [];
+  }
+}
+function parseSfnt(dv, base) {
+  const version = dv.getUint32(base);
+  if (version !== 65536 && version !== TAG_OTTO && version !== TAG_TRUE) return [];
+  const numTables = dv.getUint16(base + 4);
+  for (let i2 = 0; i2 < numTables; i2++) {
+    const rec = base + 12 + i2 * 16;
+    if (dv.getUint32(rec) === TAG_CMAP) return parseCmapTable(dv, dv.getUint32(rec + 8));
+  }
+  return [];
+}
+function parseCmapTable(dv, cmap) {
+  const lookups = [];
+  const numTables = dv.getUint16(cmap + 2);
+  for (let i2 = 0; i2 < numTables; i2++) {
+    const rec = cmap + 4 + i2 * 8;
+    const platform = dv.getUint16(rec);
+    const encoding = dv.getUint16(rec + 2);
+    if (!(platform === 0 || platform === 3 && (encoding === 1 || encoding === 10))) continue;
+    const sub = cmap + dv.getUint32(rec + 4);
+    const format = dv.getUint16(sub);
+    if (format === 4) lookups.push(format4Lookup(dv, sub));
+    else if (format === 12) lookups.push(format12Lookup(dv, sub));
+    else if (format === 6) lookups.push(format6Lookup(dv, sub));
+    else if (format === 0) lookups.push(format0Lookup(dv, sub));
+  }
+  return lookups;
+}
+function format4Lookup(dv, sub) {
+  const segCount = dv.getUint16(sub + 6) / 2;
+  const endsAt = sub + 14;
+  const startsAt = endsAt + segCount * 2 + 2;
+  const deltasAt = startsAt + segCount * 2;
+  const rangeOffsetsAt = deltasAt + segCount * 2;
+  return {
+    has(cp) {
+      if (cp > 65535) return false;
+      let lo = 0;
+      let hi = segCount - 1;
+      while (lo < hi) {
+        const mid = lo + hi >> 1;
+        if (dv.getUint16(endsAt + mid * 2) < cp) lo = mid + 1;
+        else hi = mid;
+      }
+      if (dv.getUint16(startsAt + lo * 2) > cp || cp === 65535) return false;
+      const rangeOffset = dv.getUint16(rangeOffsetsAt + lo * 2);
+      if (rangeOffset === 0) return (cp + dv.getInt16(deltasAt + lo * 2) & 65535) !== 0;
+      const glyphAt = rangeOffsetsAt + lo * 2 + rangeOffset + (cp - dv.getUint16(startsAt + lo * 2)) * 2;
+      if (glyphAt + 2 > dv.byteLength) return false;
+      const glyph = dv.getUint16(glyphAt);
+      return glyph !== 0 && (glyph + dv.getInt16(deltasAt + lo * 2) & 65535) !== 0;
+    }
+  };
+}
+function format12Lookup(dv, sub) {
+  const numGroups = dv.getUint32(sub + 12);
+  const groupsAt = sub + 16;
+  return {
+    has(cp) {
+      let lo = 0;
+      let hi = numGroups - 1;
+      while (lo <= hi) {
+        const mid = lo + hi >> 1;
+        const at = groupsAt + mid * 12;
+        if (cp < dv.getUint32(at)) hi = mid - 1;
+        else if (cp > dv.getUint32(at + 4)) lo = mid + 1;
+        else return dv.getUint32(at + 8) + (cp - dv.getUint32(at)) !== 0;
+      }
+      return false;
+    }
+  };
+}
+function format6Lookup(dv, sub) {
+  const first = dv.getUint16(sub + 6);
+  const count = dv.getUint16(sub + 8);
+  return {
+    has: (cp) => cp >= first && cp < first + count && dv.getUint16(sub + 10 + (cp - first) * 2) !== 0
+  };
+}
+function format0Lookup(dv, sub) {
+  return { has: (cp) => cp < 256 && dv.getUint8(sub + 6 + cp) !== 0 };
+}
+var FONT_EXT = /\.(ttf|otf|ttc|otc)$/i;
+var fileLookupCache = /* @__PURE__ */ new Map();
+function fontFilesUnder(dir, depth = 4) {
+  if (depth < 0) return [];
+  let entries;
+  try {
+    entries = readdirSync(dir).sort();
+  } catch {
+    return [];
+  }
+  const files = [];
+  for (const entry of entries) {
+    const path = join(dir, entry);
+    try {
+      const stat = statSync(path);
+      if (stat.isDirectory()) files.push(...fontFilesUnder(path, depth - 1));
+      else if (FONT_EXT.test(entry)) files.push(path);
+    } catch {
+    }
+  }
+  return files;
+}
+function lookupsForDirs(dirs) {
+  const lookups = [];
+  for (const dir of dirs) {
+    for (const file of fontFilesUnder(dir)) {
+      let parsed = fileLookupCache.get(file);
+      if (!parsed) {
+        try {
+          parsed = parseFontFile(readFileSync(file));
+        } catch {
+          parsed = [];
+        }
+        fileLookupCache.set(file, parsed);
+      }
+      lookups.push(...parsed);
+    }
+  }
+  return lookups;
+}
+function extractSvgTextContent(svg2) {
+  let out = "";
+  for (const m2 of svg2.matchAll(/<text\b[^>]*>([\s\S]*?)<\/text>/g)) {
+    out += m2[1].replace(/<[^>]*>/g, "");
+  }
+  return decodeXML3(out);
+}
+function isIgnorable(cp) {
+  return cp <= 32 || cp === 127 || cp >= 8203 && cp <= 8207 || // zero-width space/joiners, directional marks
+  cp === 8232 || cp === 8233 || cp >= 65024 && cp <= 65039 || // variation selectors (emoji presentation)
+  cp === 65279;
+}
+function classifyScript(cp) {
+  const ranges = [
+    [1328, 1423, "Armenian"],
+    [1424, 1535, "Hebrew"],
+    [1536, 1919, "Arabic"],
+    [2304, 2431, "Devanagari"],
+    [2432, 2559, "Bengali"],
+    [3584, 3711, "Thai"],
+    [4256, 4351, "Georgian"],
+    [4352, 4607, "CJK"],
+    // Hangul jamo
+    [9728, 10175, "emoji"],
+    // misc symbols + dingbats
+    [11904, 40959, "CJK"],
+    // radicals, kana, CJK symbols, unified ideographs
+    [43360, 43391, "CJK"],
+    [44032, 55295, "CJK"],
+    // Hangul syllables
+    [63744, 64255, "CJK"],
+    // compatibility ideographs
+    [65072, 65103, "CJK"],
+    [65280, 65519, "CJK"],
+    // fullwidth/halfwidth forms
+    [127462, 127487, "emoji"],
+    // regional indicators (flags)
+    [126976, 129791, "emoji"],
+    [131072, 262143, "CJK"]
+    // ideograph extensions
+  ];
+  for (const [lo, hi, script] of ranges) if (cp >= lo && cp <= hi) return script;
+  return "other";
+}
+function findUncoveredScripts(svg2, fontDirs) {
+  const text3 = extractSvgTextContent(svg2);
+  if (!text3) return [];
+  const unique2 = /* @__PURE__ */ new Set();
+  for (const ch of text3) unique2.add(ch.codePointAt(0));
+  const lookups = lookupsForDirs(fontDirs);
+  const byScript = /* @__PURE__ */ new Map();
+  for (const cp of unique2) {
+    if (isIgnorable(cp)) continue;
+    if (lookups.some((l2) => l2.has(cp))) continue;
+    const script = classifyScript(cp);
+    const bucket = byScript.get(script);
+    if (bucket) bucket.push(cp);
+    else byScript.set(script, [cp]);
+  }
+  return [...byScript.entries()].sort(([a2], [b2]) => a2 < b2 ? -1 : 1).map(([script, cps]) => ({ script, chars: cps.sort((a2, b2) => a2 - b2).map((cp) => String.fromCodePoint(cp)) }));
+}
+
+// src/agent/png.ts
 var cachedFontDir = null;
 function resolveFontDir() {
   if (cachedFontDir !== null) return cachedFontDir;
   const here = typeof import.meta.url === "string" ? fileURLToPath(import.meta.url) : __filename;
   let dir = dirname(here);
   for (let i2 = 0; i2 < 6; i2++) {
-    const candidate = join(dir, "assets", "fonts");
+    const candidate = join2(dir, "assets", "fonts");
     if (existsSync(candidate)) {
       cachedFontDir = candidate;
       return candidate;
@@ -36818,16 +37284,36 @@ function renderMermaidPNG(input, opts = {}) {
   );
   const scale = opts.scale ?? 2;
   const fontDir = resolveFontDir();
+  const loadSystemFonts = opts.loadSystemFonts ?? false;
+  const fontDirs = [...fontDir ? [fontDir] : [], ...opts.fontDirs ?? []];
+  if (!loadSystemFonts) {
+    const emit = opts.onWarning ?? ((w2) => process.stderr.write(`agentic-mermaid renderMermaidPNG: warning ${w2.code}: ${w2.message}
+`));
+    for (const { script, chars } of findUncoveredScripts(svg2, fontDirs)) {
+      const examples = chars.slice(0, 5).join(" ");
+      emit({
+        code: "PNG_FONT_COVERAGE",
+        script,
+        chars,
+        message: `no bundled font covers ${chars.length} ${script} character${chars.length === 1 ? "" : "s"} (${examples}); they will draw as empty tofu boxes. Point fontDirs (CLI: --font-dirs <dir>) at a font that covers them, or opt in to system fonts with loadSystemFonts: true (CLI: --system-fonts).`
+      });
+    }
+  }
   const resvgOpts = {
     background: opts.background ?? "white",
     fitTo: opts.fitTo?.width ? { mode: "width", value: opts.fitTo.width } : opts.fitTo?.height ? { mode: "height", value: opts.fitTo.height } : { mode: "zoom", value: scale },
     font: {
-      loadSystemFonts: false,
-      // Bundled fonts (DejaVu Sans + the faces built-in styles reference)
-      // for cross-runtime determinism, plus caller-supplied directories.
-      // Falls back to resvg's built-in fonts if nothing is found.
-      fontDirs: [...fontDir ? [fontDir] : [], ...opts.fontDirs ?? []],
-      defaultFontFamily: "DejaVu Sans"
+      loadSystemFonts,
+      // Bundled fonts (Inter + DejaVu Sans + the faces built-in styles
+      // reference) for cross-runtime determinism, plus caller-supplied
+      // directories. Falls back to resvg's built-in fonts if nothing is found.
+      fontDirs,
+      // Inter is the metrics font: src/text-metrics.ts is calibrated for it
+      // and the SVG @import requests it, so rasterizing with anything else
+      // (DejaVu is ~14% wider) pushes long labels outside their measured
+      // boxes. resvg falls back per-glyph across every loaded font, so
+      // DejaVu still covers glyphs Inter lacks (arrows, math, Armenian, …).
+      defaultFontFamily: "Inter"
     }
   };
   const resvg = new Resvg(svg2, resvgOpts);