@diagrammo/dgmo 0.78.0 → 0.80.0

package/dist/{chunk-RHZZVIGA.js → chunk-THHXUZTB.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-WTTIODDV.js";
 import {
   buildPlacedNotes
-} from "./chunk-LMWXBFLA.js";
+} from "./chunk-2R2M2C6V.js";
 import {
   noteCanvasShift
 } from "./chunk-6EK55ART.js";
@@ -12,10 +12,10 @@ import {
   measureText,
   truncateText,
   wrapTextToWidth
-} from "./chunk-MTGGOCND.js";
+} from "./chunk-YC6GVLTI.js";
 import {
   resolveNotes
-} from "./chunk-E6PNTYRK.js";
+} from "./chunk-VS5WMPWM.js";
 
 // src/boxes-and-lines/label-placement.ts
 var EDGE_LABEL_FONT_SIZE = 11;
@@ -312,7 +312,7 @@ function computeNodeSize(node, reserveValueRow) {
   return { width: w, height: Math.max(NODE_HEIGHT, totalHeight) };
 }
 async function layoutBoxesAndLines(parsed, collapseInfo, layoutOptions) {
-  const { layoutBoxesAndLinesSearch } = await import("./layout-search-TSV4FURP.js");
+  const { layoutBoxesAndLinesSearch } = await import("./layout-search-GWCIKHO4.js");
   const searchOpts = {
     ...layoutOptions?.hideDescriptions !== void 0 && {
       hideDescriptions: layoutOptions.hideDescriptions
@@ -468,4 +468,4 @@ export {
   computeNodeSize,
   layoutBoxesAndLines
 };
-//# sourceMappingURL=chunk-RHZZVIGA.js.map
+//# sourceMappingURL=chunk-THHXUZTB.js.map

package/dist/{chunk-IZTU6WVR.js → chunk-TR5BFNRR.js}

@@ -13,7 +13,7 @@ import {
   LEGEND_TOGGLE_DOT_R,
   measureLegendText,
   truncateLegendText
-} from "./chunk-MFK7LF66.js";
+} from "./chunk-UDUJVGCZ.js";
 
 // src/utils/number-format.ts
 function compactNumber(n) {
@@ -577,4 +577,4 @@ export {
   getMaxLegendReservedHeight,
   getLegendExtent
 };
-//# sourceMappingURL=chunk-IZTU6WVR.js.map
+//# sourceMappingURL=chunk-TR5BFNRR.js.map

package/dist/{chunk-76NHL5UG.js → chunk-TU5ZNZWE.js}

@@ -1,10 +1,10 @@
 import {
   extractColor,
   measureIndent
-} from "./chunk-M5OOAP65.js";
+} from "./chunk-OD42CAXD.js";
 import {
   makeDgmoError
-} from "./chunk-5SI6T5A5.js";
+} from "./chunk-OAQE624Z.js";
 
 // src/utils/notes/parse.ts
 function parseNoteHeader(rest) {
@@ -73,4 +73,4 @@ function tryCollectNote(lines, index, indent, palette, diagnostics) {
 export {
   tryCollectNote
 };
-//# sourceMappingURL=chunk-76NHL5UG.js.map
+//# sourceMappingURL=chunk-TU5ZNZWE.js.map

package/dist/{chunk-CTERZC4K.js → chunk-TZZ3CSDF.js}

@@ -1,14 +1,14 @@
 import {
   measureText,
   wrapTextToWidth
-} from "./chunk-MTGGOCND.js";
+} from "./chunk-YC6GVLTI.js";
 import {
   fillModeFromOptions
-} from "./chunk-M5OOAP65.js";
+} from "./chunk-OD42CAXD.js";
 import {
   mix,
   shapeFill
-} from "./chunk-YVLTNNME.js";
+} from "./chunk-ARUQ55BK.js";
 
 // src/journey-map/layout.ts
 var PADDING = 24;
@@ -290,4 +290,4 @@ export {
   scoreToCurveY,
   layoutJourneyMap
 };
-//# sourceMappingURL=chunk-CTERZC4K.js.map
+//# sourceMappingURL=chunk-TZZ3CSDF.js.map

package/dist/{chunk-VUJQ6RU6.js → chunk-U3BJC66Q.js}

@@ -8,7 +8,7 @@ import {
   tagAttrKey,
   validateTagGroupNames,
   validateTagValues
-} from "./chunk-R4YGH7DJ.js";
+} from "./chunk-LDJFPEQ5.js";
 import {
   TREEMAP_REGISTRY,
   extractColor,
@@ -21,14 +21,14 @@ import {
   stripQuotes,
   warnUnknownMetaKeys,
   withTagAliases
-} from "./chunk-M5OOAP65.js";
+} from "./chunk-OD42CAXD.js";
 import {
   emit,
   formatDgmoError,
   makeDgmoError,
   makeFail,
   suggest
-} from "./chunk-5SI6T5A5.js";
+} from "./chunk-OAQE624Z.js";
 
 // src/treemap/diagnostics.ts
 var TREEMAP_DX = {
@@ -445,4 +445,4 @@ export {
   TREEMAP_DIAGNOSTICS,
   parseTreemap
 };
-//# sourceMappingURL=chunk-VUJQ6RU6.js.map
+//# sourceMappingURL=chunk-U3BJC66Q.js.map

package/dist/{chunk-P4SQV3XD.js → chunk-U3IPFKK7.js}

@@ -4,10 +4,10 @@ import {
 import {
   isTagBlockHeading,
   matchTagBlockHeading
-} from "./chunk-R4YGH7DJ.js";
+} from "./chunk-LDJFPEQ5.js";
 import {
   makeDgmoError
-} from "./chunk-5SI6T5A5.js";
+} from "./chunk-OAQE624Z.js";
 
 // src/pert/share-normalize.ts
 var START_DATE_NOW_RE = /^(\s*start-date\s+)now(\s*)$/i;
@@ -456,4 +456,4 @@ export {
   normalizePertSourceForShare,
   resolveOrgImports
 };
-//# sourceMappingURL=chunk-P4SQV3XD.js.map
+//# sourceMappingURL=chunk-U3IPFKK7.js.map

package/dist/{chunk-MFK7LF66.js → chunk-UDUJVGCZ.js}

@@ -1,10 +1,10 @@
 import {
   measureText,
   truncateText
-} from "./chunk-MTGGOCND.js";
+} from "./chunk-YC6GVLTI.js";
 import {
   mix
-} from "./chunk-YVLTNNME.js";
+} from "./chunk-ARUQ55BK.js";
 
 // src/utils/legend-constants.ts
 var LEGEND_HEIGHT = 28;
@@ -59,4 +59,4 @@ export {
   LEGEND_TOGGLE_OFF_OPACITY,
   LEGEND_GEAR_PILL_W
 };
-//# sourceMappingURL=chunk-MFK7LF66.js.map
+//# sourceMappingURL=chunk-UDUJVGCZ.js.map

package/dist/{chunk-7WTFX6OA.js → chunk-V4IRPJ6J.js}

@@ -16,11 +16,11 @@ import {
   fillModeFromToken,
   measureIndent,
   parseFirstLine
-} from "./chunk-M5OOAP65.js";
+} from "./chunk-OD42CAXD.js";
 import {
   makeDgmoError,
   makeFail
-} from "./chunk-5SI6T5A5.js";
+} from "./chunk-OAQE624Z.js";
 
 // src/countdown/parser.ts
 var RETIRED_SLOTS = /* @__PURE__ */ new Set(["on", "at", "from"]);
@@ -424,4 +424,4 @@ export {
   targetToMs2 as targetToMs,
   parseCountdown
 };
-//# sourceMappingURL=chunk-7WTFX6OA.js.map
+//# sourceMappingURL=chunk-V4IRPJ6J.js.map

package/dist/{chunk-7NNJXYXU.js → chunk-VHFZK72U.js}

@@ -9,16 +9,16 @@ import {
   matchTagBlockHeading,
   stripDefaultModifier,
   tagAttrKey
-} from "./chunk-R4YGH7DJ.js";
+} from "./chunk-LDJFPEQ5.js";
 import {
   extractColor,
   fillModeFromToken,
   measureIndent,
   parseFirstLine
-} from "./chunk-M5OOAP65.js";
+} from "./chunk-OD42CAXD.js";
 import {
   emit
-} from "./chunk-5SI6T5A5.js";
+} from "./chunk-OAQE624Z.js";
 
 // src/body/diagnostics.ts
 var BODY_DX = {
@@ -264,4 +264,4 @@ export {
   parseBody,
   extractSymbols
 };
-//# sourceMappingURL=chunk-7NNJXYXU.js.map
+//# sourceMappingURL=chunk-VHFZK72U.js.map

package/dist/{chunk-VSPNH7LC.js → chunk-VLC6WNRD.js}

@@ -4,6 +4,7 @@ var TITLE_FONT_WEIGHT = "bold";
 var TITLE_Y = 30;
 var TITLE_OFFSET = 40;
 var CAPTION_FONT_SIZE = 13;
+var CAPTION_FONT_WEIGHT = "normal";
 var CAPTION_LINE_HEIGHT = 18;
 var CAPTION_TOP_GAP = 12;
 var CAPTION_BOX_PADDING_X = 16;
@@ -15,9 +16,10 @@ export {
   TITLE_Y,
   TITLE_OFFSET,
   CAPTION_FONT_SIZE,
+  CAPTION_FONT_WEIGHT,
   CAPTION_LINE_HEIGHT,
   CAPTION_TOP_GAP,
   CAPTION_BOX_PADDING_X,
   CAPTION_BOX_PADDING_Y
 };
-//# sourceMappingURL=chunk-VSPNH7LC.js.map
+//# sourceMappingURL=chunk-VLC6WNRD.js.map

package/dist/{chunk-7SMVTA7I.js → chunk-VPSZKOKK.js}

@@ -1,15 +1,19 @@
+import {
+  MAP_DIAGNOSTICS
+} from "./chunk-EOYPX6SF.js";
 import {
   parseClock
-} from "./chunk-SH4PPRU7.js";
+} from "./chunk-X36EJABT.js";
 import {
   parseBracket
-} from "./chunk-6VTLVU7D.js";
+} from "./chunk-B66G5S4G.js";
 import {
   parseRaci
-} from "./chunk-TN754B3R.js";
+} from "./chunk-PYX7QA7B.js";
 import {
+  BODY_DIAGNOSTICS,
   parseBody
-} from "./chunk-7NNJXYXU.js";
+} from "./chunk-VHFZK72U.js";
 import {
   EXTENDED_CHART_DOORS,
   parseChart,
@@ -18,81 +22,90 @@ import {
   parseHeatmap,
   parseSankey,
   parseScatter
-} from "./chunk-M526IKKH.js";
+} from "./chunk-WT65QX7I.js";
 import {
   parseCycle
-} from "./chunk-CRLVJZWX.js";
+} from "./chunk-I7BVPBPI.js";
 import {
   parseJourneyMap
-} from "./chunk-N56W4R66.js";
+} from "./chunk-WV3RUC2Z.js";
 import {
   parsePyramid
-} from "./chunk-LKS56RDT.js";
+} from "./chunk-37HNPLQA.js";
 import {
   parseRing
-} from "./chunk-OKXWPKUC.js";
+} from "./chunk-HFIS5H44.js";
 import {
+  TREEMAP_DIAGNOSTICS,
   parseTreemap
-} from "./chunk-VUJQ6RU6.js";
+} from "./chunk-U3BJC66Q.js";
 import {
   parseBlock
-} from "./chunk-2NLBIZEW.js";
+} from "./chunk-JSQXK2X7.js";
 import {
   parseGoal
-} from "./chunk-KWSBNLSC.js";
+} from "./chunk-IHOX6RQZ.js";
 import {
   parseCountdown
-} from "./chunk-7WTFX6OA.js";
+} from "./chunk-V4IRPJ6J.js";
 import {
   parseMap
-} from "./chunk-7BNRHSSF.js";
+} from "./chunk-BKM2CJBC.js";
 import {
   parseBoxesAndLines
-} from "./chunk-QVMV4KCA.js";
+} from "./chunk-3AWWQ2AI.js";
 import {
   parseSketch
-} from "./chunk-B6PVPAS5.js";
+} from "./chunk-GCW3FSLR.js";
+import {
+  SKETCH_DIAGNOSTICS
+} from "./chunk-EGY3TS62.js";
 import {
+  SWIMLANE_DIAGNOSTICS,
   parseSwimlane
-} from "./chunk-3ZLQM6XN.js";
+} from "./chunk-I26QNBHS.js";
 import {
+  FAMILY_DIAGNOSTICS,
   parseFamily
-} from "./chunk-GINNZHVN.js";
+} from "./chunk-23MSLKPP.js";
 import {
   parseMindmap
-} from "./chunk-57GSSHBR.js";
+} from "./chunk-2TTDR565.js";
 import {
   parseTechRadar
-} from "./chunk-VBJCGGNF.js";
+} from "./chunk-3KGW6JUX.js";
 import {
+  PERT_DIAGNOSTICS,
   looksLikePert,
   parsePert
-} from "./chunk-KAZQX2EY.js";
+} from "./chunk-JN3OA44O.js";
 import {
   isLiveLinkLine,
   parseLiveLink
-} from "./chunk-Y2CYNRL7.js";
+} from "./chunk-7TTKMWTA.js";
 import {
+  EVENT_LINE_DIAGNOSTICS,
   parseEventLine
-} from "./chunk-RC6GGF6X.js";
+} from "./chunk-7EHMSQVV.js";
 import {
   parseTimelineEventLine
-} from "./chunk-UCZBRGJN.js";
+} from "./chunk-54E35DTP.js";
 import {
+  VERSION_CONTROL_DIAGNOSTICS,
   parseVersionControl
-} from "./chunk-7BMX2M3F.js";
+} from "./chunk-3VUWBXW2.js";
 import {
   parseKanban
-} from "./chunk-3GLTQZKE.js";
+} from "./chunk-LA4FDGQO.js";
 import {
   parseC4
-} from "./chunk-A7Y32YD6.js";
+} from "./chunk-H4YK6Q7A.js";
 import {
   parseInfra
-} from "./chunk-NS3KIRSW.js";
+} from "./chunk-4ROEQ3XT.js";
 import {
   parseGantt
-} from "./chunk-FJADQOFQ.js";
+} from "./chunk-QQLY52Q7.js";
 import {
   makeYearContext,
   parseDateToken,
@@ -102,42 +115,52 @@ import {
 import {
   looksLikeSequence,
   parseSequenceDgmo
-} from "./chunk-XCR3PDFF.js";
+} from "./chunk-WRQ54IZS.js";
 import {
   looksLikeFlowchart,
   parseFlowchart
-} from "./chunk-NWNSXHA5.js";
+} from "./chunk-SH6QDU4T.js";
+import {
+  GRAPH_DIAGNOSTICS
+} from "./chunk-7TF3QOOD.js";
 import {
   looksLikeState,
   parseState
-} from "./chunk-6Z2NUJSX.js";
+} from "./chunk-O4CG5ZRH.js";
 import {
   looksLikeClassDiagram,
   parseClassDiagram
-} from "./chunk-LTTZX6RD.js";
+} from "./chunk-QMBVPA4R.js";
 import {
   looksLikeERDiagram,
   parseERDiagram
-} from "./chunk-SFSJ6XWV.js";
+} from "./chunk-WM2CR4NX.js";
+import {
+  ARROW_DIAGNOSTIC_CODES
+} from "./chunk-IMA4D3ZK.js";
 import {
   looksLikeOrg,
   parseOrg
-} from "./chunk-QAPFXLAC.js";
+} from "./chunk-J5FSJRQN.js";
 import {
   looksLikeSitemap,
   parseSitemap
-} from "./chunk-NN5IDH2I.js";
+} from "./chunk-XH4JUOYQ.js";
+import {
+  RACI_DIAGNOSTICS
+} from "./chunk-ALKJBGIV.js";
 import {
   parseWireframe
-} from "./chunk-3OWIYK52.js";
+} from "./chunk-3MNFBPFK.js";
 import {
   matchTagBlockHeading,
   stripDefaultModifier,
   tagAttrKey,
   validateTagGroupNames,
   validateTagValues
-} from "./chunk-R4YGH7DJ.js";
+} from "./chunk-LDJFPEQ5.js";
 import {
+  ALIAS_DIAGNOSTICS,
   TIMELINE_REGISTRY,
   chartTypes,
   collectIndentedValues,
@@ -149,19 +172,21 @@ import {
   peelTrailingColorName,
   splitNameAndMeta,
   withTagAliases
-} from "./chunk-M5OOAP65.js";
+} from "./chunk-OD42CAXD.js";
 import {
   resolveColorWithDiagnostic
-} from "./chunk-XOGQY4EC.js";
+} from "./chunk-3NGB6XAX.js";
 import {
   NEGATIVE_VALUE_DX,
   TITLE_DIRECTIVE_DX,
   dedupeDiagnostics,
   emit,
+  emptyMetadataValueMessage,
   formatDgmoError,
   makeDgmoError,
+  nameMergedMessage,
   suggest
-} from "./chunk-5SI6T5A5.js";
+} from "./chunk-OAQE624Z.js";
 
 // src/visualizations/types.ts
 var DEFAULT_CLOUD_OPTIONS = {
@@ -1435,6 +1460,175 @@ function tokenizeFreeformText(text) {
   return Array.from(counts.entries()).map(([text2, count]) => ({ text: text2, weight: count, lineNumber: 0 })).sort((a, b) => b.weight - a.weight);
 }
 
+// src/utils/arrows-diagnostics.ts
+var ARROW_DIAGNOSTICS = [
+  // --- ACTIVE (TD-13): emitted by validateLabelCharacters ---
+  {
+    code: ARROW_DIAGNOSTIC_CODES.ARROW_SUBSTRING_IN_LABEL,
+    // 'E_ARROW_SUBSTRING_IN_LABEL'
+    severity: "error",
+    chartType: null,
+    title: "Arrow symbol inside label",
+    // Verbatim from validateLabelCharacters (arrows.ts, TD-13).
+    message: 'Arrow symbols (-> or ~>) are not allowed inside a label. Reword the label without them \u2014 e.g. "A -chains to-> B". See "In-Arrow Message Labels" \u2192 Forbidden.',
+    // 🔴 This said `A -> B: uses -> to chain` until 2026-09-01 — it recommended
+    // the one syntax that breaks silently. In a sequence diagram the colon form
+    // is a hard error; in boxes-and-lines it parses clean and invents a node
+    // literally named "B: uses to chain" (verified: nodes come back
+    // `["A","B: uses to chain"]` with zero diagnostics). The label belongs
+    // BETWEEN the dashes, and it can never contain an arrow, so the repair is
+    // to reword it rather than move it.
+    hint: 'The label goes between the dashes \u2014 `A -chains to-> B` \u2014 and cannot contain an arrow at all, so reword it rather than move it. Do not use `A -> B: label`: outside sequence diagrams that silently creates a node named "B: label".',
+    // End-to-end trigger via a symbolic parser (class), whose label is
+    // everything after the target name, so the inner `~>` survives to the
+    // validator instead of being absorbed as a second arrow token.
+    example: "class\nFoo\n  --|> Bar uses ~> chain"
+  },
+  // --- ACTIVE (TD-14): emitted by validateLabelCharacters ---
+  {
+    code: ARROW_DIAGNOSTIC_CODES.CONTROL_CHAR_IN_LABEL,
+    // 'E_CONTROL_CHAR_IN_LABEL'
+    severity: "error",
+    chartType: null,
+    title: "Control character in label",
+    // Verbatim from validateLabelCharacters (arrows.ts, TD-14). The emitter
+    // interpolates the offending codepoint as a 4-digit upper-hex string
+    // (e.g. '0000'); tolerate `{}` for the param-less catalog view.
+    message: (p) => `Label contains a control character (U+${typeof p.hex === "string" ? p.hex : "XXXX"}). Remove it and use plain text.`,
+    hint: "Delete the control character (C0 U+0000\u2013U+001F except tab, or U+007F); use plain text.",
+    // `\u0000` is a literal NUL inside the label, which triggers
+    // E_CONTROL_CHAR_IN_LABEL end-to-end on any chain-tokenizing chart.
+    // (Escaped, not a raw NUL byte, to keep the source file text-safe.)
+    example: "sequence\nA -has\0nul-> B"
+  }
+];
+
+// src/colors-diagnostics.ts
+var COLOR_DIAGNOSTICS = [
+  {
+    // src/colors.ts:317/347/359 — makeDgmoError(..., 'warning', INVALID_COLOR_CODE='E_INVALID_COLOR')
+    // Runtime: emitted as warning despite E_ prefix
+    code: "E_INVALID_COLOR",
+    severity: "warning",
+    chartType: null,
+    title: "Invalid DGMO color",
+    message: (p) => `Color "${String(
+      p.token ?? p.color ?? ""
+    )}" is not a valid DGMO color \u2014 DGMO accepts only these 11 named colors: <names> (no hex, no CSS color names).`,
+    hint: "Use one of the 11 named palette colors instead of a hex/rgb()/hsl() or CSS color name.",
+    example: `version-control
+main
+  Initial commit
+develop from main crimson
+  Set up CI
+`
+  }
+];
+
+// src/diagnostics-registry.ts
+var UNIVERSAL_DIAGNOSTICS = [
+  // ── Universal name handling ──
+  {
+    code: "I_NAME_MERGED",
+    severity: "warning",
+    chartType: null,
+    title: "Names merged (case/whitespace)",
+    message: (p) => nameMergedMessage({
+      incomingDisplay: String(p.incomingDisplay ?? "Backend"),
+      incomingLine: Number(p.incomingLine ?? 2),
+      existingDisplay: String(p.existingDisplay ?? "backend"),
+      existingLine: Number(p.existingLine ?? 1)
+    }),
+    hint: "Use one consistent spelling, or add `# allow-merge` on the line if the merge is intentional.",
+    example: "infra\ninternet\n  -> gw\ngw\n  -> svc\nGW\n  -> svc\n"
+  },
+  // ── Unified metadata grammar (0.18.0) ──
+  {
+    code: "E_TAG_DECLARED_AFTER_CONTENT",
+    severity: "error",
+    chartType: null,
+    title: "Tag declared after content",
+    message: "A `tag` declaration appears after the first content line \u2014 declare all tags before any content.",
+    hint: "Move `tag` declarations to the top of the diagram.",
+    example: "block\n[A]\ntag warn red"
+  },
+  {
+    code: "W_ACTIVE_TAG_NO_MATCH",
+    severity: "warning",
+    chartType: null,
+    title: "Active tag group not found",
+    message: "`active-tag` names a group the diagram does not declare, so nothing is coloured.",
+    hint: "Check the spelling against the declared `tag` groups, or use `active-tag none` to colour nothing on purpose.",
+    // The group name in this example is misspelled on purpose — showing a name
+    // that matches no declared group is the example's whole job. Ignored for
+    // this file rather than added to cspell.json, which would excuse the same
+    // typo anywhere in the library. cspell:ignore Rnak
+    example: "org Crew\nactive-tag Rnak\n\ntag Rank as r\n  Captain red\n\nBlackbeard r: Captain\n"
+  },
+  {
+    code: "W_EMPTY_METADATA_VALUE",
+    severity: "warning",
+    chartType: null,
+    title: "Empty metadata value",
+    message: (p) => emptyMetadataValueMessage(String(p.key ?? "color")),
+    hint: "Provide a value or remove the key.",
+    example: "mindmap\nRoot color:\n  Child"
+  },
+  {
+    code: "W_LEGEND_INLINE_UNSUPPORTED",
+    severity: "warning",
+    chartType: null,
+    title: "legend-inline not supported",
+    message: () => "'legend-inline' isn't supported for this chart type \u2014 the title and legend render stacked.",
+    hint: "Remove legend-inline, or use a chart type with a top-center capsule legend (e.g. bar, line, state, treemap, sequence, gantt).",
+    example: "pie Share\nApples 30\nPears 70"
+  },
+  {
+    code: "W_CANVAS_WIDTH_IGNORED",
+    severity: "warning",
+    chartType: null,
+    title: "Requested width not applied",
+    message: () => "This chart type sizes itself from its content, so the canvas came out wider than the width that was requested.",
+    hint: "The width is a maximum for chart types that fit their content to it; one that lays out from its own nodes (org, sitemap, class, er, infra, and the rest of the structured family) is as wide as its content needs. Remove the width, or give the diagram less to draw.",
+    example: "org Team\nJane\n  Sam"
+  },
+  // ── Data-chart `title` directive (decision #48) ──
+  TITLE_DIRECTIVE_DX,
+  // ── Negative value on a magnitude channel (pie/polar-area/radar/funnel/
+  //    sankey/arc/wordcloud/treemap size/map size:/width:) ──
+  NEGATIVE_VALUE_DX
+];
+var REGISTRY = [
+  ...UNIVERSAL_DIAGNOSTICS,
+  ...SWIMLANE_DIAGNOSTICS,
+  ...RACI_DIAGNOSTICS,
+  ...TREEMAP_DIAGNOSTICS,
+  ...EVENT_LINE_DIAGNOSTICS,
+  ...BODY_DIAGNOSTICS,
+  ...VERSION_CONTROL_DIAGNOSTICS,
+  ...ARROW_DIAGNOSTICS,
+  ...MAP_DIAGNOSTICS,
+  ...PERT_DIAGNOSTICS,
+  ...GRAPH_DIAGNOSTICS,
+  ...COLOR_DIAGNOSTICS,
+  ...SKETCH_DIAGNOSTICS,
+  ...FAMILY_DIAGNOSTICS,
+  ...ALIAS_DIAGNOSTICS
+];
+function listDiagnosticCodes() {
+  return [...REGISTRY].sort((a, b) => a.code.localeCompare(b.code));
+}
+function attachHints(diagnostics) {
+  return diagnostics.map((d) => {
+    if (d.hint !== void 0 || d.code === void 0) return d;
+    const hint = getDiagnosticSpec(d.code)?.hint;
+    return hint === void 0 ? d : { ...d, hint };
+  });
+}
+function getDiagnosticSpec(code) {
+  return REGISTRY.find((s) => s.code === code);
+}
+
 // src/slope/parser.ts
 function parseSlope(content, palette) {
   return parseVisualization(content, palette);
@@ -1466,7 +1660,7 @@ function parseQuadrant(content, palette) {
 }
 
 // src/chart-type-registry.ts
-var REGISTRY = {
+var REGISTRY2 = {
   // ── Structured diagrams ───────────────────────────────────
   sequence: { category: "diagram", parse: parseSequenceDgmo },
   flowchart: { category: "diagram", parse: parseFlowchart },
@@ -1541,7 +1735,7 @@ var REGISTRY = {
   // card sizes to its own text and scales to fit.
   "live-link": { category: "diagram", parse: parseLiveLink }
 };
-var CHART_TYPE_REGISTRY = Object.entries(REGISTRY).map(([id, d]) => ({ id, ...d }));
+var CHART_TYPE_REGISTRY = Object.entries(REGISTRY2).map(([id, d]) => ({ id, ...d }));
 var REGISTRY_BY_ID = new Map(
   CHART_TYPE_REGISTRY.map((d) => [d.id, d])
 );
@@ -1617,7 +1811,9 @@ var ALL_KNOWN_TYPES = new Set(knownChartTypeIds);
 function parseDgmo(content) {
   const result = parseDgmoUndeduped(content);
   return {
-    diagnostics: dedupeDiagnostics(result.diagnostics),
+    // `attachHints` backfills the registry's repair sentence by code, so the
+    // hint travels however the diagnostic was constructed. See its own comment.
+    diagnostics: attachHints(dedupeDiagnostics(result.diagnostics)),
     chartType: result.chartType
   };
 }
@@ -1705,6 +1901,8 @@ export {
   parseWordcloud,
   parseVenn,
   parseQuadrant,
+  listDiagnosticCodes,
+  getDiagnosticSpec,
   looksLikeGantt,
   looksLikeC4,
   parseDgmoChartType,
@@ -1716,4 +1914,4 @@ export {
   knownChartTypeIds,
   parseDgmo
 };
-//# sourceMappingURL=chunk-7SMVTA7I.js.map
+//# sourceMappingURL=chunk-VPSZKOKK.js.map