@diagrammo/dgmo 0.90.0 → 0.91.0

package/dist/advanced.js

@@ -1,7 +1,7 @@
 import {
   renderCountdown,
   renderCountdownForExport
-} from "./chunk-A5PUOHIS.js";
+} from "./chunk-SWBHH2UW.js";
 import {
   renderClock,
   renderClockForExport
@@ -9,7 +9,7 @@ import {
 import {
   renderBracket,
   renderBracketForExport
-} from "./chunk-RY5RRKYN.js";
+} from "./chunk-RVTYIGWZ.js";
 import {
   renderRaci,
   renderRaciForExport
@@ -23,11 +23,11 @@ import {
   computeActivations,
   groupMessagesBySection,
   renderSequenceDiagram
-} from "./chunk-4IYJOXGS.js";
+} from "./chunk-TLPY4ZBI.js";
 import {
   mapContentAspect,
   mapExportDimensions
-} from "./chunk-AHWA36O7.js";
+} from "./chunk-II4XJETG.js";
 import {
   renderPyramid,
   renderPyramidForExport
@@ -40,12 +40,12 @@ import {
   layoutTreemapRadial,
   renderTreemapRadial,
   renderTreemapRadialForExport
-} from "./chunk-S4LLHDGK.js";
+} from "./chunk-CXIPV2FY.js";
 import {
   layoutTreemap,
   renderTreemap,
   renderTreemapForExport
-} from "./chunk-5M6PMV5Z.js";
+} from "./chunk-5VPWIC6T.js";
 import {
   renderLiveLinkCard
 } from "./chunk-A6YINTY6.js";
@@ -54,16 +54,16 @@ import {
   layoutBlock,
   renderBlock,
   renderBlockForExport
-} from "./chunk-MIVSVEK4.js";
+} from "./chunk-PZVTFQI2.js";
 import {
   renderGoal,
   renderGoalForExport
-} from "./chunk-G5BGW4BX.js";
-import "./chunk-A5EE66RQ.js";
+} from "./chunk-6NO3MNBC.js";
+import "./chunk-53BJIOLF.js";
 import {
   renderState,
   renderStateForExport
-} from "./chunk-YKGUSW6D.js";
+} from "./chunk-JA2S7PHR.js";
 import {
   collapseStateGroups
 } from "./chunk-SQ7IY53Q.js";
@@ -74,11 +74,11 @@ import {
   renderQuadrantFocusForExport,
   renderTechRadar,
   renderTechRadarForExport
-} from "./chunk-PIHAUVA4.js";
+} from "./chunk-RHXIUUWB.js";
 import {
   renderJourneyMap,
   renderJourneyMapForExport
-} from "./chunk-PQ5NW3QZ.js";
+} from "./chunk-2UV627GG.js";
 import {
   layoutJourneyMap
 } from "./chunk-HLE5QGZJ.js";
@@ -86,15 +86,15 @@ import {
   computeCycleLayout,
   renderCycle,
   renderCycleForExport
-} from "./chunk-K4GUO7FV.js";
+} from "./chunk-F2436VRR.js";
 import {
   resolveMap
-} from "./chunk-3AX6MCI6.js";
+} from "./chunk-SPQVER4T.js";
 import {
   renderMap,
   renderMapForExport,
   renderMapLayout
-} from "./chunk-GYBKG4Z6.js";
+} from "./chunk-2A4OFZ2Z.js";
 import "./chunk-G2KHLANR.js";
 import {
   albersSkewFallback,
@@ -102,7 +102,7 @@ import {
   mapBackgroundColor,
   mapNeutralLandColor,
   rebuildMapProjection
-} from "./chunk-QRIW46LR.js";
+} from "./chunk-57L2JPP2.js";
 import {
   decodeFeatures,
   regionAt
@@ -113,19 +113,19 @@ import {
   inferRoles,
   parseAndLayoutInfra,
   renderInfra
-} from "./chunk-R2PTZ6QM.js";
+} from "./chunk-WTE27AJT.js";
 import {
   computeInfra
-} from "./chunk-ICZ7M6IZ.js";
+} from "./chunk-EQJ3U5EW.js";
 import {
   layoutInfra
-} from "./chunk-3FCSOYN4.js";
+} from "./chunk-5P2L5QXE.js";
 import {
   measurePertAnalysisBlock,
   renderPert,
   renderPertAnalysisBlock,
   renderPertForExport
-} from "./chunk-LNQDICFJ.js";
+} from "./chunk-CPGKRI7H.js";
 import {
   analyzePert,
   buildSimulationContext,
@@ -137,44 +137,57 @@ import {
 import {
   layoutPert,
   relayoutPert
-} from "./chunk-64KSPLU2.js";
+} from "./chunk-273GB7WK.js";
 import {
   calculateSchedule,
   collectTasks,
   resolveTaskName
-} from "./chunk-Y6GQQ4Y2.js";
+} from "./chunk-LKR4FACF.js";
 import {
   buildTagLaneRowList,
   renderGantt
-} from "./chunk-3HBR3YAN.js";
+} from "./chunk-HSGWR2FL.js";
 import {
   renderFamily,
   renderFamilyForExport
-} from "./chunk-OWJVSJLA.js";
+} from "./chunk-XLAREWBK.js";
 import {
   collapseMindmapTree
 } from "./chunk-UZ7EZW3B.js";
 import {
   renderMindmap,
   renderMindmapForExport
-} from "./chunk-I6FWHICD.js";
+} from "./chunk-GCDW3WAY.js";
 import {
   layoutMindmap
-} from "./chunk-LBRHDWEA.js";
+} from "./chunk-CVZBLHHW.js";
 import {
   layoutWireframe
-} from "./chunk-LYRDIVSY.js";
+} from "./chunk-GLCMUTO5.js";
 import {
   renderWireframe
-} from "./chunk-NP2SE6MQ.js";
+} from "./chunk-SMTWQ66K.js";
 import {
   renderFlowchart,
   renderFlowchartForExport
-} from "./chunk-J3ODKAWN.js";
+} from "./chunk-MNL547RV.js";
 import "./chunk-26EVL454.js";
 import {
   layoutGraph
-} from "./chunk-ZNNVI5SR.js";
+} from "./chunk-CU2PZLZP.js";
+import {
+  CONTAINER_FILL_OPACITY,
+  CONTAINER_STROKE_OPACITY,
+  CONTAINER_STROKE_WIDTH,
+  SKETCH_VISUALS,
+  renderSketch,
+  renderSketchForExport,
+  sketchColors,
+  sketchContainerFill,
+  sketchEdgeGeometry,
+  sketchLabelSpot,
+  sketchNeutralFill
+} from "./chunk-MJKQ5ZYY.js";
 import {
   IMAGE_NOT_UPLOADED,
   WHITEBOARD_LABEL_MIN_FONT,
@@ -198,7 +211,7 @@ import {
   whiteboardShapeAt,
   whiteboardShapeContains,
   wrapWhiteboardLabel
-} from "./chunk-S7C32S2T.js";
+} from "./chunk-EDPDAUBL.js";
 import {
   renderC4ComponentsForExport,
   renderC4Containers,
@@ -207,25 +220,30 @@ import {
   renderC4ContextForExport,
   renderC4Deployment,
   renderC4DeploymentForExport
-} from "./chunk-FDRHBQUG.js";
+} from "./chunk-PUZ63XZM.js";
+import {
+  CYLINDER_RY,
+  QUEUE_CAP,
+  layoutC4Components,
+  layoutC4Containers,
+  layoutC4Context,
+  layoutC4Deployment,
+  rollUpContextRelationships
+} from "./chunk-K3BYD3WU.js";
 import {
   renderBoxesAndLines,
   renderBoxesAndLinesForExport
-} from "./chunk-2EDJPHXQ.js";
-import {
-  layoutBoxesAndLines
-} from "./chunk-W7QN5BC5.js";
+} from "./chunk-N254IJM2.js";
 import {
   layoutSwimlane
 } from "./chunk-AUS7V54P.js";
-import "./chunk-EJS3K44P.js";
-import "./chunk-QT3KDDXK.js";
 import {
   renderSwimlaneForExport
-} from "./chunk-RRBV4HIM.js";
+} from "./chunk-DLX7MEN4.js";
+import "./chunk-XBJJP2HN.js";
 import {
   layoutFamily
-} from "./chunk-IJ27L3R4.js";
+} from "./chunk-MA42PIGJ.js";
 import "./chunk-IVKC4GID.js";
 import {
   computeCardArchive,
@@ -233,26 +251,31 @@ import {
   isArchiveColumn,
   renderKanban,
   renderKanbanForExport
-} from "./chunk-EB7AEM2H.js";
+} from "./chunk-IMKPFW67.js";
 import {
   renderClassDiagram,
   renderClassDiagramForExport
-} from "./chunk-QOZ4RVQY.js";
+} from "./chunk-YZG37S7L.js";
 import {
   layoutClassDiagram
-} from "./chunk-7Z2VFRP5.js";
+} from "./chunk-5U6DXIMV.js";
 import {
   renderERDiagram,
   renderERDiagramForExport
-} from "./chunk-PXEUQ7EG.js";
+} from "./chunk-G22UV5AF.js";
 import "./chunk-KATED53P.js";
 import {
   layoutERDiagram
-} from "./chunk-IIOLFAGJ.js";
-import "./chunk-HTNLLT34.js";
-import "./chunk-6EK55ART.js";
+} from "./chunk-5DIBB2QG.js";
+import "./chunk-JJUDOR4I.js";
+import "./chunk-NWPMLX2V.js";
+import "./chunk-EJS3K44P.js";
+import {
+  layoutBoxesAndLines
+} from "./chunk-Q3N7PI3B.js";
 import "./chunk-RJNZHFNG.js";
 import "./chunk-5DH3KYFH.js";
+import "./chunk-QT3KDDXK.js";
 import {
   SKETCH_AUTO_LAYOUT_DEFAULTS,
   SKETCH_FOOT_H,
@@ -267,37 +290,14 @@ import {
   layoutSketch,
   sketchSlotToPx
 } from "./chunk-6BQSDF77.js";
-import {
-  CONTAINER_FILL_OPACITY,
-  CONTAINER_STROKE_OPACITY,
-  CONTAINER_STROKE_WIDTH,
-  SKETCH_VISUALS,
-  renderSketch,
-  renderSketchForExport,
-  sketchColors,
-  sketchContainerFill,
-  sketchEdgeGeometry,
-  sketchLabelSpot,
-  sketchNeutralFill
-} from "./chunk-DXPT2HPH.js";
-import "./chunk-XBJJP2HN.js";
-import {
-  CYLINDER_RY,
-  QUEUE_CAP,
-  layoutC4Components,
-  layoutC4Containers,
-  layoutC4Context,
-  layoutC4Deployment,
-  rollUpContextRelationships
-} from "./chunk-VCHYS3RD.js";
 import {
   renderBody,
   renderBodyForExport
-} from "./chunk-ICYPGWOV.js";
+} from "./chunk-D7DXNQW5.js";
 import {
   renderVersionControl,
   renderVersionControlForExport
-} from "./chunk-HJRP6PXL.js";
+} from "./chunk-BQVTV4LB.js";
 import {
   collapseOrgTree,
   focusOrgTree
@@ -305,13 +305,13 @@ import {
 import {
   renderOrg,
   renderOrgForExport
-} from "./chunk-JRQ4LBQI.js";
+} from "./chunk-B6EUFLRP.js";
 import {
   layoutOrg
-} from "./chunk-GQVXYRPC.js";
+} from "./chunk-MI6SJJQU.js";
 import {
   layoutSitemap
-} from "./chunk-54YUDXGP.js";
+} from "./chunk-D7PP35BA.js";
 import {
   collapseSitemapTree
 } from "./chunk-UNCCZ3NU.js";
@@ -319,13 +319,13 @@ import "./chunk-BS7SV7C3.js";
 import {
   renderSitemap,
   renderSitemapForExport
-} from "./chunk-U762HK4D.js";
+} from "./chunk-TPEYEOXA.js";
 import {
   clearEventLineMuted,
   focusEventLine,
   renderEventLine,
   renderEventLineForExport
-} from "./chunk-TQ644YGV.js";
+} from "./chunk-IWTUXGHN.js";
 import "./chunk-NPWVOFB3.js";
 import {
   parseInlineMarkdown,
@@ -349,11 +349,11 @@ import {
   renderSlopeChart,
   renderVenn,
   renderWordCloud
-} from "./chunk-RCBHL2B5.js";
+} from "./chunk-3LINSNJT.js";
 import {
   layoutBracket
 } from "./chunk-ABP5BUD6.js";
-import "./chunk-POBNN5DP.js";
+import "./chunk-7BBRSOKS.js";
 import {
   CHART_TYPE_DESCRIPTIONS,
   chartTypeParsers,
@@ -363,7 +363,7 @@ import {
   knownChartTypeIds,
   parseDgmo,
   parseVisualization
-} from "./chunk-HIVJBESO.js";
+} from "./chunk-VMD2CYVP.js";
 import "./chunk-EOYPX6SF.js";
 import {
   parseCountdown,
@@ -407,15 +407,15 @@ import {
 } from "./chunk-A2RUBBVT.js";
 import {
   parseBracket
-} from "./chunk-X3WYJ5T7.js";
+} from "./chunk-3YTAOMMN.js";
 import {
   parseBody
-} from "./chunk-SMEVBJJJ.js";
+} from "./chunk-IUBCDNT2.js";
 import "./chunk-BDXC7MDK.js";
 import {
   renderLegendSvg,
   renderLegendSvgFromConfig
-} from "./chunk-EEYQFJVK.js";
+} from "./chunk-KFXY5IW2.js";
 import "./chunk-KMU65FYM.js";
 import "./chunk-EPDBWATV.js";
 import {
@@ -424,12 +424,12 @@ import {
   parseChart,
   parseDataRowValues,
   parseExtendedChart
-} from "./chunk-WHRIN7N3.js";
+} from "./chunk-HFG7KQOY.js";
 import "./chunk-2CW5ZTNH.js";
 import {
   formatDateLabel,
   renderTimeline
-} from "./chunk-3BQCSQQJ.js";
+} from "./chunk-FJCYK4K3.js";
 import {
   computeTimeTicks
 } from "./chunk-YRYKTYMQ.js";
@@ -438,7 +438,7 @@ import {
 } from "./chunk-24YPR5EH.js";
 import {
   renderLegendD3
-} from "./chunk-NJYA4QSN.js";
+} from "./chunk-QVKTAU7P.js";
 import "./chunk-XCKNFFKM.js";
 import "./chunk-X6IZP2BD.js";
 import "./chunk-SEKNYIMO.js";
@@ -460,10 +460,10 @@ import {
 } from "./chunk-MKFQ5E7J.js";
 import {
   parseCycle
-} from "./chunk-NFWRIC2V.js";
+} from "./chunk-AR4QVMWG.js";
 import {
   parseJourneyMap
-} from "./chunk-COPSI54O.js";
+} from "./chunk-PSGSFRRE.js";
 import {
   parsePyramid
 } from "./chunk-M6J25PAZ.js";
@@ -472,10 +472,10 @@ import {
 } from "./chunk-EWERNTOX.js";
 import {
   parseTreemap
-} from "./chunk-RNXX2GOQ.js";
+} from "./chunk-HWXUQCDY.js";
 import {
   parseBlock
-} from "./chunk-JX4RCC6B.js";
+} from "./chunk-V3KHZQPK.js";
 import "./chunk-XSVWUOUZ.js";
 import {
   parseGoal
@@ -483,13 +483,13 @@ import {
 import {
   looksLikeMap,
   parseMap
-} from "./chunk-YE7D2S75.js";
+} from "./chunk-HYV6GSXM.js";
 import {
   parseBoxesAndLines
-} from "./chunk-GXP344YZ.js";
+} from "./chunk-RMTOZALT.js";
 import {
   parseSketch
-} from "./chunk-NMKLX57Y.js";
+} from "./chunk-SKF7XLCM.js";
 import "./chunk-NWSPPGIE.js";
 import {
   WHITEBOARD_COLORS,
@@ -508,42 +508,42 @@ import {
 } from "./chunk-IHK3Y2HG.js";
 import {
   parseSwimlane
-} from "./chunk-PNCKZFPE.js";
+} from "./chunk-J2SQNZ6D.js";
 import {
   parseFamily
-} from "./chunk-C4W62JZO.js";
+} from "./chunk-IS6WFBX7.js";
 import "./chunk-QQJUTGQH.js";
 import {
   parseMindmap
-} from "./chunk-DNMICILX.js";
+} from "./chunk-XQTRGKQ3.js";
 import {
   parseEventLine
-} from "./chunk-RJYFHEP4.js";
+} from "./chunk-VGSSAMLA.js";
 import {
   addDurationToDate,
   parseTimelineDate
 } from "./chunk-OYKNMFUY.js";
 import {
   parseVersionControl
-} from "./chunk-SVQDLYX7.js";
+} from "./chunk-HLVGZXM5.js";
 import {
   parseKanban
-} from "./chunk-IRVQT4GR.js";
+} from "./chunk-JJQWCI35.js";
 import {
   parseC4
-} from "./chunk-LC5LY5V2.js";
+} from "./chunk-EP7BT3HU.js";
 import {
   INFRA_BEHAVIOR_KEYS,
   extractSymbols as extractSymbols4,
   parseInfra
-} from "./chunk-CUY56BK4.js";
+} from "./chunk-G3EUQMV4.js";
 import {
   parseGantt
-} from "./chunk-NUYWNKHH.js";
+} from "./chunk-6QEXWMBP.js";
 import {
   normalizePertSourceForShare,
   resolveOrgImports
-} from "./chunk-EK7JYFCL.js";
+} from "./chunk-R7BSF7Z7.js";
 import {
   decodeDiagramUrl,
   decodeViewState,
@@ -552,7 +552,7 @@ import {
 } from "./chunk-RE27AX7O.js";
 import {
   parseDgmoChartType
-} from "./chunk-YWRZG6GN.js";
+} from "./chunk-2AM6VA3A.js";
 import {
   allTasks,
   parseRaci
@@ -561,7 +561,7 @@ import {
   extractPertSymbols,
   looksLikePert,
   parsePert
-} from "./chunk-AAC3XQWV.js";
+} from "./chunk-37QQXKFV.js";
 import "./chunk-2SKMEL7V.js";
 import {
   parseLiveLink
@@ -588,7 +588,7 @@ import {
   isSequenceNote,
   looksLikeSequence,
   parseSequenceDgmo
-} from "./chunk-62VWZ3SE.js";
+} from "./chunk-ZB2Q67NO.js";
 import {
   RULE_COUNT,
   inferParticipantType
@@ -597,23 +597,23 @@ import {
   extractSymbols,
   looksLikeFlowchart,
   parseFlowchart
-} from "./chunk-SLO22FPS.js";
-import "./chunk-7TF3QOOD.js";
+} from "./chunk-634LDSN6.js";
+import "./chunk-TIVMAITN.js";
 import {
   looksLikeState,
   parseState
-} from "./chunk-NY56FM55.js";
+} from "./chunk-XLPJJ35N.js";
 import "./chunk-NXMESY4J.js";
 import {
   extractSymbols as extractSymbols2,
   looksLikeClassDiagram,
   parseClassDiagram
-} from "./chunk-OSIUWQ3N.js";
+} from "./chunk-WNTPJZU7.js";
 import {
   extractSymbols as extractSymbols3,
   looksLikeERDiagram,
   parseERDiagram
-} from "./chunk-5TZPIKNV.js";
+} from "./chunk-3SLRZKLB.js";
 import "./chunk-KSZHIAI2.js";
 import "./chunk-O753JUEZ.js";
 import {
@@ -624,11 +624,11 @@ import {
 import {
   findOrgNodeIdByName,
   parseOrg
-} from "./chunk-FS2LZBHG.js";
+} from "./chunk-UWJP4JSZ.js";
 import {
   looksLikeSitemap,
   parseSitemap
-} from "./chunk-5M52RPAS.js";
+} from "./chunk-F26ZPBSF.js";
 import "./chunk-IYULMRBE.js";
 import {
   displayName,
@@ -637,7 +637,7 @@ import {
 } from "./chunk-NOTA6TEI.js";
 import {
   parseWireframe
-} from "./chunk-CYF2X3CG.js";
+} from "./chunk-ROCBGUJN.js";
 import {
   RACI_ERROR_CODES,
   RACI_WARNING_CODES,
@@ -650,7 +650,7 @@ import {
   resolveTagColor,
   resolveTagValue,
   tagAttrKey
-} from "./chunk-HX2KJEPD.js";
+} from "./chunk-QKJ6MQXW.js";
 import {
   ALL_CHART_TYPES,
   chartTypes,
@@ -1630,6 +1630,279 @@ function startClocks(root = document) {
   window.setInterval(() => tickClocks(document), 1e3);
 }
 
+// src/validate-diagram.ts
+var FLOWCHART_STRUCTURE_CODE = "E_FLOWCHART_STRUCTURE";
+function structureError(line2, message) {
+  return { line: line2, message, severity: "error", code: FLOWCHART_STRUCTURE_CODE };
+}
+function validateFlowchartStructure(dgmo) {
+  let parsed;
+  try {
+    parsed = parseFlowchart(dgmo);
+  } catch {
+    return [];
+  }
+  const nodes = parsed.nodes ?? [];
+  const edges = parsed.edges ?? [];
+  if (nodes.length === 0 || edges.length === 0) return [];
+  const out = /* @__PURE__ */ new Map();
+  const inc = /* @__PURE__ */ new Map();
+  for (const n of nodes) {
+    out.set(n.id, []);
+    inc.set(n.id, []);
+  }
+  for (const e of edges) {
+    out.get(e.source)?.push(e.target);
+    inc.get(e.target)?.push(e.source);
+  }
+  const issues = [];
+  for (const n of nodes) {
+    if (n.shape !== "decision") continue;
+    const branches = out.get(n.id)?.length ?? 0;
+    if (branches < 2) {
+      issues.push(
+        structureError(
+          n.lineNumber,
+          `Decision "${n.label}" has ${branches === 0 ? "no" : "only one"} outgoing branch \u2014 a decision needs at least two (e.g. -yes-> / -no->, or specific labels like -retirement-> / -survivor->).`
+        )
+      );
+    }
+  }
+  const starts = nodes.filter(
+    (n) => (inc.get(n.id)?.length ?? 0) === 0 && (out.get(n.id)?.length ?? 0) > 0
+  );
+  const ends = nodes.filter(
+    (n) => (out.get(n.id)?.length ?? 0) === 0 && (inc.get(n.id)?.length ?? 0) > 0
+  );
+  if (starts.length === 0) {
+    issues.push(
+      structureError(
+        0,
+        "Flowchart has no entry point \u2014 every node has an incoming arrow, so the flow loops with no start. Add a start node that nothing points to."
+      )
+    );
+  }
+  if (ends.length === 0) {
+    issues.push(
+      structureError(
+        0,
+        "Flowchart has no end \u2014 every node has an outgoing arrow, so the flow never stops. Add a terminal node where the flow ends."
+      )
+    );
+  }
+  if (starts.length > 0 && ends.length > 0) {
+    const forward = reach(
+      starts.map((n) => n.id),
+      out
+    );
+    const backward = reach(
+      ends.map((n) => n.id),
+      inc
+    );
+    for (const n of nodes) {
+      if (!forward.has(n.id) || !backward.has(n.id)) {
+        issues.push(
+          structureError(
+            n.lineNumber,
+            `Node "${n.label}" is not connected to the flow \u2014 it must lie on a path from the start to an end. Wire it into the diagram or remove it.`
+          )
+        );
+      }
+    }
+  }
+  return issues;
+}
+function reach(seeds, adj) {
+  const seen = new Set(seeds);
+  const queue = [...seeds];
+  while (queue.length > 0) {
+    const id = queue.shift();
+    for (const next of adj.get(id) ?? []) {
+      if (!seen.has(next)) {
+        seen.add(next);
+        queue.push(next);
+      }
+    }
+  }
+  return seen;
+}
+function validateDiagram(source, options = {}) {
+  const chartType = parseDgmoChartType(source);
+  let diagnostics;
+  if (chartType === "map" && options.mapData) {
+    try {
+      diagnostics = resolveMap(
+        parseMap(source),
+        options.mapData
+      ).diagnostics.slice();
+    } catch {
+      diagnostics = parseDgmo(source).diagnostics.slice();
+    }
+  } else {
+    diagnostics = parseDgmo(source).diagnostics.slice();
+  }
+  if (chartType === "flowchart") {
+    diagnostics.push(...validateFlowchartStructure(source));
+  }
+  const blocking = (d) => d.severity === "error" || d.code === INVALID_COLOR_CODE;
+  return {
+    chartType,
+    errors: diagnostics.filter(blocking),
+    warnings: diagnostics.filter((d) => !blocking(d))
+  };
+}
+var plural = (n, word) => `${n} ${word}${n > 1 ? "s" : ""}`;
+function formatDiagramValidation(v) {
+  const { chartType, errors, warnings } = v;
+  if (errors.length === 0 && warnings.length === 0) {
+    return {
+      text: `Valid ${chartType ? `${chartType} diagram` : "diagram"} \u2014 no errors or warnings.`,
+      isError: false
+    };
+  }
+  const typeLabel = chartType ? ` in ${chartType} diagram` : "";
+  const parts = [];
+  if (errors.length > 0) {
+    parts.push(
+      `${plural(errors.length, "error")}${warnings.length > 0 ? `, ${plural(warnings.length, "warning")}` : ""}${typeLabel}
+`
+    );
+    parts.push("Errors:");
+    for (const e of errors) parts.push(`  ${formatDgmoError(e)}`);
+  }
+  if (warnings.length > 0) {
+    if (errors.length === 0) {
+      parts.push(
+        `Valid with ${plural(warnings.length, "warning")}${typeLabel}
+`
+      );
+    } else {
+      parts.push("");
+    }
+    parts.push("Warnings:");
+    for (const w of warnings) parts.push(`  ${formatDgmoError(w)}`);
+  }
+  return { text: parts.join("\n"), isError: errors.length > 0 };
+}
+
+// src/agent-reference.ts
+function parseTypeAliases(markdown) {
+  const m = markdown.match(/<!--\s*TYPE-ALIASES:\s*([^>]*?)-->/);
+  const map = /* @__PURE__ */ new Map();
+  if (!m) return map;
+  for (const pair of (m[1] ?? "").trim().split(/\s+/)) {
+    const [alias, target] = pair.split("=");
+    if (alias && target) map.set(alias.trim(), target.trim());
+  }
+  return map;
+}
+function extractColorRule(markdown) {
+  const m = markdown.match(
+    /<!--\s*COLORS start\s*-->([\s\S]*?)<!--\s*COLORS end\s*-->/
+  );
+  return m ? (m[1] ?? "").trim() : null;
+}
+function extractTitleRule(markdown) {
+  const m = markdown.match(
+    /<!--\s*TITLE start\s*-->([\s\S]*?)<!--\s*TITLE end\s*-->/
+  );
+  return m ? (m[1] ?? "").trim() : null;
+}
+function extractCategorizeRule(markdown) {
+  const m = markdown.match(
+    /<!--\s*CATEGORIZE start\s*-->([\s\S]*?)<!--\s*CATEGORIZE end\s*-->/
+  );
+  return m ? (m[1] ?? "").trim() : null;
+}
+function extractSection(markdown, chartType) {
+  const aliases = parseTypeAliases(markdown);
+  const resolved = aliases.get(chartType) ?? chartType;
+  const startRe = new RegExp(`<!--\\s*TYPE:${resolved}\\s*-->`);
+  const startMatch = startRe.exec(markdown);
+  if (!startMatch) return null;
+  const after = startMatch.index + startMatch[0].length;
+  const rest = markdown.slice(after);
+  const nextType = rest.search(/<!--\s*TYPE:[a-z0-9-]+\s*-->/);
+  const nextH2 = rest.search(/^## /m);
+  const ends = [nextType, nextH2].filter((n) => n !== -1);
+  const end = ends.length ? after + Math.min(...ends) : markdown.length;
+  return markdown.slice(after, end).trim();
+}
+function referenceForChartType(markdown, chartType) {
+  const raw = extractSection(markdown, chartType);
+  if (!raw) return null;
+  const section = raw.replace(
+    /[ \t]*<!--\s*TIPS (?:start|end)\s*-->[ \t]*\n?/g,
+    ""
+  );
+  const universal = [
+    extractColorRule(markdown),
+    extractTitleRule(markdown),
+    extractCategorizeRule(markdown)
+  ].filter(Boolean);
+  return universal.length ? `${universal.join("\n\n")}
+
+---
+
+${section}` : section;
+}
+function formatChartTypeList() {
+  const meta = new Map(chartTypes.map((c) => [c.id, c]));
+  const types = Object.keys(CHART_TYPE_DESCRIPTIONS).filter(
+    (id) => !meta.get(id)?.internal
+  );
+  const lines = types.map((id) => {
+    const desc = CHART_TYPE_DESCRIPTIONS[id];
+    const mark = meta.get(id)?.beta ? " [beta \u2014 expect rough edges]" : "";
+    return desc ? `- ${id}${mark}: ${desc}` : `- ${id}${mark}`;
+  });
+  return `Supported chart types (${types.length}):
+
+${lines.join("\n")}`;
+}
+function isExampleFor(name, chartType) {
+  const slash = name.indexOf("/");
+  if (slash !== -1) return name.slice(0, slash) === chartType;
+  return name === chartType || name.startsWith(chartType + "-");
+}
+var EXAMPLES_SHOWN = 5;
+async function formatExamples(names, read, chartType) {
+  const sorted = [...names].sort();
+  if (!chartType) {
+    return {
+      text: `Available examples (${sorted.length}):
+
+${sorted.map((n) => `- ${n}`).join("\n")}
+
+Call get_examples with a chart_type to see the full DGMO source.`,
+      isError: false
+    };
+  }
+  const matching = sorted.filter((n) => isExampleFor(n, chartType));
+  if (matching.length === 0) {
+    return {
+      text: `No examples found for "${chartType}". Use get_examples() without arguments to see all available examples.`,
+      isError: true
+    };
+  }
+  const parts = [];
+  for (const n of matching.slice(0, EXAMPLES_SHOWN)) {
+    const source = await read(n);
+    parts.push(`## ${n}
+
+\`\`\`dgmo
+${source.trim()}
+\`\`\``);
+  }
+  let text = parts.join("\n\n---\n\n");
+  if (matching.length > EXAMPLES_SHOWN) {
+    text += `
+
+(Showing ${EXAMPLES_SHOWN} of ${matching.length} examples)`;
+  }
+  return { text, isError: false };
+}
+
 // src/map/load-data.ts
 async function loadNodeBuiltins() {
   const [{ readFile }, { fileURLToPath }, { dirname, resolve }] = await Promise.all([
@@ -2174,15 +2447,170 @@ function fontPortabilityWarning(runs) {
   }).join(", ");
   return `This diagram uses characters the bundled Inter font does not contain: ${described}. They were drawn with a font installed on this machine, so the image is correct here \u2014 but a machine without a font for those characters draws nothing at all, with no error. Install a font covering them wherever this runs, or check the output there.`;
 }
+
+// src/cloud-space.ts
+var CLOUD_API = "https://api.diagrammo.app";
+var CloudSpaceError = class extends Error {
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+    this.name = "CloudSpaceError";
+  }
+  status;
+};
+function describeStatus(status, detail) {
+  const why = detail ? `: ${detail.replace(/\.+$/, "")}` : "";
+  switch (status) {
+    case 401:
+      return `The API key was refused (401)${why}. Check DGMO_API_KEY \u2014 it may be mistyped or revoked.`;
+    case 403:
+      return `The API key may not do this (403)${why}.`;
+    case 404:
+      return `Not found (404)${why}. Check the space, folder, title or id.`;
+    case 409:
+      return `Another write to this diagram landed first (409)${why}. Try again.`;
+    default:
+      return `The Cloud API answered ${status}${why}.`;
+  }
+}
+async function call(target, method, rest, body) {
+  const doFetch = target.fetch ?? fetch;
+  const url = `${CLOUD_API}/spaces/${encodeURIComponent(target.spaceId)}${rest}`;
+  let res;
+  try {
+    res = await doFetch(url, {
+      method,
+      headers: {
+        authorization: `Bearer ${target.apiKey}`,
+        accept: "application/json",
+        ...body === void 0 ? {} : { "content-type": "application/json" }
+      },
+      ...body === void 0 ? {} : { body: JSON.stringify(body) }
+    });
+  } catch (err) {
+    throw new CloudSpaceError(
+      `Could not reach ${CLOUD_API}: ${err.message}`
+    );
+  }
+  const text = await res.text();
+  let data;
+  try {
+    data = text ? JSON.parse(text) : null;
+  } catch {
+    data = null;
+  }
+  if (!res.ok) {
+    const problem = data ?? {};
+    const detail = typeof problem.detail === "string" ? problem.detail : typeof problem.title === "string" ? problem.title : "";
+    throw new CloudSpaceError(describeStatus(res.status, detail), res.status);
+  }
+  return { status: res.status, data };
+}
+var sameName = (a, b) => a.replace(/[A-Z]/g, (c) => c.toLowerCase()) === b.replace(/[A-Z]/g, (c) => c.toLowerCase());
+var rootIsNull = (id) => id === "" ? null : id;
+function folderPath(folders, folderId) {
+  const byId = new Map(folders.map((f) => [f.id, f]));
+  const names = [];
+  const start = rootIsNull(folderId);
+  let cur = start === null ? void 0 : byId.get(start);
+  while (cur && names.length <= folders.length) {
+    names.unshift(cur.name);
+    const up = rootIsNull(cur.parentId);
+    cur = up === null ? void 0 : byId.get(up);
+  }
+  return names.join("/");
+}
+function resolveFolder(folders, path) {
+  const parts = (path ?? "").split("/").map((p) => p.trim()).filter(Boolean);
+  let parentId = null;
+  for (const name of parts) {
+    const hit = folders.find(
+      (f) => rootIsNull(f.parentId) === parentId && sameName(f.name, name)
+    );
+    if (!hit)
+      throw new CloudSpaceError(
+        `No folder "${parts.join("/")}" in this space (stopped at "${name}").`,
+        404
+      );
+    parentId = hit.id;
+  }
+  return parentId;
+}
+var contentsOf = (target) => call(target, "GET", "/contents").then((r) => r.data);
+async function putSpaceDiagram(target, diagram) {
+  const contents = await contentsOf(target);
+  const folderId = resolveFolder(contents.folders, diagram.folder);
+  const { status, data } = await call(target, "PUT", "/diagrams", {
+    title: diagram.title,
+    source: diagram.source,
+    chartType: parseDgmoChartType(diagram.source),
+    folderId
+  });
+  return {
+    action: status === 201 ? "created" : "updated",
+    id: data.id,
+    title: data.title,
+    folder: folderPath(contents.folders, data.folderId),
+    version: data.version
+  };
+}
+async function getSpaceDiagram(target, which) {
+  const contents = await contentsOf(target);
+  let id;
+  if ("id" in which) id = which.id;
+  else {
+    const folderId = resolveFolder(contents.folders, which.folder);
+    const hit = contents.items.find(
+      (d) => rootIsNull(d.folderId) === folderId && sameName(d.title, which.title)
+    );
+    if (!hit)
+      throw new CloudSpaceError(
+        `No diagram titled "${which.title}" in ${folderId === null ? "the space root" : `folder "${which.folder}"`}.`,
+        404
+      );
+    id = hit.id;
+  }
+  const { data } = await call(
+    target,
+    "GET",
+    `/diagrams/${encodeURIComponent(id)}`
+  );
+  return {
+    id: data.id,
+    title: data.title,
+    folder: folderPath(contents.folders, data.folderId),
+    chartType: data.chartType,
+    version: data.version,
+    updatedAt: data.updatedAt,
+    source: data.source
+  };
+}
+async function listSpaceDiagrams(target) {
+  const contents = await contentsOf(target);
+  return contents.items.map((d) => ({
+    id: d.id,
+    title: d.title,
+    folder: folderPath(contents.folders, d.folderId),
+    chartType: d.chartType,
+    version: d.version,
+    updatedAt: d.updatedAt
+  })).sort(
+    (a, b) => `${a.folder}/${a.title}`.localeCompare(`${b.folder}/${b.title}`)
+  );
+}
 export {
   ALL_CHART_TYPES,
   ARROW_DIAGNOSTIC_CODES,
   CHART_TYPE_DESCRIPTIONS,
+  CLOUD_API,
   CONTAINER_FILL_OPACITY,
   CONTAINER_STROKE_OPACITY,
   CONTAINER_STROKE_WIDTH,
   CYLINDER_RY,
+  CloudSpaceError,
   DEFAULT_FONT_NAME,
+  EXAMPLES_SHOWN,
+  FLOWCHART_STRUCTURE_CODE,
   FONT_FAMILY,
   DEFAULT_DIM_OPACITY as HOVER_DIM_OPACITY,
   IMAGE_NOT_UPLOADED,
@@ -2282,11 +2710,15 @@ export {
   emitWhiteboardElement,
   encodeDiagramUrl,
   encodeViewState,
+  extractCategorizeRule,
   extractSymbols2 as extractClassSymbols,
+  extractColorRule,
   extractSymbols3 as extractErSymbols,
   extractSymbols as extractFlowchartSymbols,
   extractSymbols4 as extractInfraSymbols,
   extractPertSymbols,
+  extractSection,
+  extractTitleRule,
   findOrgNodeIdByName,
   fitWhiteboardLabel,
   fitWrapped,
@@ -2294,8 +2726,11 @@ export {
   focusEventLine,
   focusOrgTree,
   fontPortabilityWarning,
+  formatChartTypeList,
   formatDateLabel,
   formatDgmoError,
+  formatDiagramValidation,
+  formatExamples,
   formatOffsetLabel,
   getAllChartTypes,
   getAvailablePalettes,
@@ -2307,6 +2742,7 @@ export {
   getRenderCategory,
   getSeriesColors,
   getSimpleChartLegendGroups,
+  getSpaceDiagram,
   groupMessagesBySection,
   hexToHSL,
   hexToHSLString,
@@ -2316,6 +2752,7 @@ export {
   inkOutlinePath,
   invalidColorDiagnostic,
   isArchiveColumn,
+  isExampleFor,
   isExtendedChartType,
   isInvalidColorToken,
   isRecognizedColorName,
@@ -2350,6 +2787,7 @@ export {
   layoutTreemapRadial,
   layoutWireframe,
   legendEntryWidth,
+  listSpaceDiagrams,
   loadMapData,
   looksLikeClassDiagram,
   looksLikeERDiagram,
@@ -2421,15 +2859,18 @@ export {
   parseTechRadar,
   parseTimelineDate,
   parseTreemap,
+  parseTypeAliases,
   parseVersionControl,
   parseVisualization,
   parseWhiteboard,
   parseWireframe,
+  putSpaceDiagram,
   cellAppendMarker as raciCellAppendMarker,
   cellCycle as raciCellCycle,
   cellRemove as raciCellRemove,
   cellReplace as raciCellReplace,
   rebuildMapProjection,
+  referenceForChartType,
   registerPalette,
   relayoutPert,
   render,
@@ -2562,6 +3003,8 @@ export {
   uncoveredCharacters,
   parseDgmo as validate,
   validateComputed,
+  validateDiagram,
+  validateFlowchartStructure,
   validateInfra,
   validateLabelCharacters,
   validateThemeFile,