@diagrammo/dgmo 0.52.0 → 0.54.0

package/dist/{chunk-ROOE4R4Y.js → chunk-T7Y554OK.js}

@@ -1,39 +1,53 @@
 import {
   tryCollectNote
-} from "./chunk-ARGMQ3H4.js";
+} from "./chunk-WWHECSYZ.js";
 import {
   resolveNotes
-} from "./chunk-FMDSF3OV.js";
+} from "./chunk-QZAW5SFH.js";
 import {
   parseInArrowLabel
-} from "./chunk-FFUN5D66.js";
+} from "./chunk-WF64MW5G.js";
 import {
   displayName,
   normalizeName
 } from "./chunk-NOTA6TEI.js";
+import {
+  AUTO_TAG_COLOR_SENTINEL,
+  finalizeAutoTagColors,
+  matchTagBlockHeading,
+  stripDefaultModifier,
+  tagAttrKey,
+  validateTagGroupNames,
+  validateTagValues
+} from "./chunk-AHTTKERF.js";
 import {
   ALL_CHART_TYPES,
   FILL_FAMILY_TOKENS,
   OPTION_NOCOLON_RE,
+  STATE_REGISTRY,
+  cutUnionMetadata,
+  extractColor,
   measureIndent,
   parseFirstLine,
-  tryParseSharedOption
-} from "./chunk-BRENJ2BQ.js";
+  parseMetadataRegion,
+  tryParseSharedOption,
+  withTagAliases
+} from "./chunk-3FRO35WW.js";
 import {
   resolveColorWithDiagnostic
-} from "./chunk-TLVIHFRO.js";
+} from "./chunk-ZKPPI6BF.js";
 import {
   NAME_DIAGNOSTIC_CODES,
   formatDgmoError,
   makeDgmoError,
   nameMergedMessage,
   suggest
-} from "./chunk-CXK4DZH3.js";
+} from "./chunk-4W2PE66Q.js";
 
 // src/graph/state-parser.ts
 var PSEUDOSTATE_ID = "pseudostate:[*]";
 var PSEUDOSTATE_LABEL = "[*]";
-var GROUP_BRACKET_RE = /^\[([^\]]+)\](?:\s+(red|orange|yellow|green|blue|purple|teal|cyan|gray|black|white))?(?:,?\s+collapsed:\s*(\S+))?\s*$/;
+var GROUP_BRACKET_RE = /^\[([^\]]+)\](?:\s+(red|orange|yellow|green|blue|purple|teal|cyan|gray|black|white))?(?:,?\s+(collapsed)(?::\s*(\S+))?)?\s*$/;
 function splitArrows(line) {
   const segments = [];
   const arrowPositions = [];
@@ -126,6 +140,7 @@ function parseState(content, palette) {
     direction: "LR",
     nodes: [],
     edges: [],
+    tagGroups: [],
     options,
     diagnostics: [],
     error: null
@@ -144,6 +159,22 @@ function parseState(content, palette) {
   const groups = [];
   let contentStarted = false;
   let firstLineParsed = false;
+  const tagGroups = result.tagGroups;
+  let currentTagGroup = null;
+  const metaAliasMap = /* @__PURE__ */ new Map();
+  let registry = STATE_REGISTRY;
+  const refreshRegistry = () => {
+    registry = withTagAliases(STATE_REGISTRY, new Set(metaAliasMap.keys()));
+  };
+  function peelStateMeta(text) {
+    if (metaAliasMap.size === 0) return { text, meta: {} };
+    const cut = cutUnionMetadata(text, registry);
+    if (cut === -1) return { text, meta: {} };
+    return {
+      text: text.substring(0, cut).trimEnd(),
+      meta: parseMetadataRegion(text.substring(cut), metaAliasMap)
+    };
+  }
   const nameAliasMap = /* @__PURE__ */ new Map();
   function peelAlias(seg) {
     const trimmed = seg.trim();
@@ -151,10 +182,13 @@ function parseState(content, palette) {
     if (!m) return { seg: trimmed };
     return { seg: m[1].trim(), alias: m[2] };
   }
-  function getOrCreateNode(ref, lineNumber) {
+  function getOrCreateNode(ref, lineNumber, meta) {
     const key = ref.id;
     const existing = nodeMap.get(key);
     if (existing) {
+      if (meta && Object.keys(meta).length > 0) {
+        existing.metadata = { ...existing.metadata ?? {}, ...meta };
+      }
       const incomingDisplay = displayName(ref.label);
       const existingDisplay = displayName(existing.label);
       if (incomingDisplay !== existingDisplay) {
@@ -180,7 +214,8 @@ function parseState(content, palette) {
       shape: ref.shape,
       lineNumber,
       ...ref.color && { color: ref.color },
-      ...currentGroup && { group: currentGroup.id }
+      ...currentGroup && { group: currentGroup.id },
+      ...meta && Object.keys(meta).length > 0 && { metadata: { ...meta } }
     };
     nodeMap.set(key, node);
     result.nodes.push(node);
@@ -202,7 +237,10 @@ function parseState(content, palette) {
     const trimmed = raw.trim();
     const lineNumber = i + 1;
     const indent = measureIndent(raw);
-    if (!trimmed) continue;
+    if (!trimmed) {
+      currentTagGroup = null;
+      continue;
+    }
     if (trimmed.startsWith("//")) continue;
     if (!firstLineParsed && !contentStarted) {
       const firstLineResult = parseFirstLine(trimmed);
@@ -222,6 +260,53 @@ function parseState(content, palette) {
         continue;
       }
     }
+    if (!contentStarted) {
+      const tagBlockMatch = matchTagBlockHeading(trimmed);
+      if (tagBlockMatch) {
+        currentTagGroup = {
+          name: tagBlockMatch.name,
+          ...tagBlockMatch.alias !== void 0 && {
+            alias: tagBlockMatch.alias
+          },
+          entries: [],
+          lineNumber
+        };
+        if (tagBlockMatch.alias) {
+          metaAliasMap.set(
+            normalizeName(tagBlockMatch.alias),
+            tagAttrKey(tagBlockMatch.name)
+          );
+        }
+        metaAliasMap.set(
+          normalizeName(tagBlockMatch.name),
+          tagAttrKey(tagBlockMatch.name)
+        );
+        refreshRegistry();
+        tagGroups.push(currentTagGroup);
+        continue;
+      }
+      if (currentTagGroup && indent > 0) {
+        const { text: cleanEntry, isDefault } = stripDefaultModifier(trimmed);
+        const { label, color } = extractColor(
+          cleanEntry,
+          palette,
+          result.diagnostics,
+          lineNumber
+        );
+        if (isDefault || currentTagGroup.entries.length === 0) {
+          currentTagGroup.defaultValue = label;
+        }
+        currentTagGroup.entries.push({
+          value: label,
+          // Bare value → sentinel; finalizeAutoTagColors assigns a
+          // deterministic palette color after the parse.
+          color: color ?? AUTO_TAG_COLOR_SENTINEL,
+          lineNumber
+        });
+        continue;
+      }
+      currentTagGroup = null;
+    }
     const noteResult = tryCollectNote(
       lines,
       i,
@@ -244,7 +329,7 @@ function parseState(content, palette) {
         result.diagnostics,
         palette
       ) : void 0;
-      const groupCollapsed = groupMatch[3]?.toLowerCase() === "true";
+      const groupCollapsed = groupMatch[3] !== void 0 && (groupMatch[4] === void 0 || groupMatch[4].toLowerCase() === "true");
       currentGroup = {
         id: `group:${groupLabel.toLowerCase()}`,
         label: groupLabel,
@@ -258,8 +343,9 @@ function parseState(content, palette) {
       continue;
     }
     if (!contentStarted) {
-      if (/^direction-tb$/i.test(trimmed)) {
-        result.direction = "TB";
+      const dirBool = trimmed.match(/^direction-(lr|tb)$/i);
+      if (dirBool) {
+        result.direction = dirBool[1].toUpperCase();
         continue;
       }
       if (FILL_FAMILY_TOKENS.has(trimmed.toLowerCase())) {
@@ -278,7 +364,8 @@ function parseState(content, palette) {
         continue;
       }
       const optMatch = trimmed.match(OPTION_NOCOLON_RE);
-      if (optMatch && !trimmed.includes("->")) {
+      const carriesTagMeta = metaAliasMap.size > 0 && cutUnionMetadata(trimmed, registry) !== -1;
+      if (optMatch && !trimmed.includes("->") && !carriesTagMeta) {
         const key = optMatch[1].toLowerCase();
         const value = optMatch[2].trim();
         if (key === "no-color") {
@@ -314,10 +401,11 @@ function parseState(content, palette) {
     ) : null;
     const segments = splitArrows(trimmed);
     if (segments.length === 1) {
-      const peeled = peelAlias(segments[0]);
+      const withMeta = peelStateMeta(segments[0]);
+      const peeled = peelAlias(withMeta.text);
       const ref = parseStateNodeRef(peeled.seg);
       if (ref) {
-        const node = getOrCreateNode(ref, lineNumber);
+        const node = getOrCreateNode(ref, lineNumber, withMeta.meta);
         if (peeled.alias) nameAliasMap.set(peeled.alias, node.id);
         node.lineNumber = lineNumber;
         indentStack.push({ nodeId: node.id, indent });
@@ -374,6 +462,46 @@ function parseState(content, palette) {
       indentStack.push({ nodeId: lastNodeId, indent });
     }
   }
+  if (tagGroups.length > 0) {
+    finalizeAutoTagColors(tagGroups, palette);
+    const defaults = [];
+    for (const group of tagGroups) {
+      if (group.defaultValue) {
+        defaults.push({
+          key: tagAttrKey(group.name),
+          value: group.defaultValue
+        });
+      }
+    }
+    const taggable = result.nodes.filter(
+      (n) => n.shape !== "pseudostate"
+    );
+    for (const node of taggable) {
+      const meta = { ...node.metadata ?? {} };
+      for (const { key, value } of defaults) {
+        if (!(key in meta)) meta[key] = value;
+      }
+      node.metadata = meta;
+    }
+    validateTagValues(
+      taggable.map((n) => ({
+        metadata: n.metadata ?? {},
+        lineNumber: n.lineNumber
+      })),
+      tagGroups,
+      (line, message) => result.diagnostics.push(makeDgmoError(line, message, "warning")),
+      suggest
+    );
+    validateTagGroupNames(
+      tagGroups,
+      (line, message) => result.diagnostics.push(makeDgmoError(line, message, "warning")),
+      (line, message) => {
+        const diag = makeDgmoError(line, message);
+        result.diagnostics.push(diag);
+        if (!result.error) result.error = formatDgmoError(diag);
+      }
+    );
+  }
   if (groups.length > 0) result.groups = groups;
   if (notes.length > 0) {
     result.notes = notes;
@@ -415,4 +543,4 @@ export {
   parseState,
   looksLikeState
 };
-//# sourceMappingURL=chunk-ROOE4R4Y.js.map
+//# sourceMappingURL=chunk-T7Y554OK.js.map

package/dist/chunk-TGOMHUOV.js

@@ -0,0 +1,218 @@
+// src/chart-types.ts
+var chartTypes = [
+  // ── Tier 1 — Narrative / architecture diagrams ────────────
+  {
+    id: "journey-map",
+    description: "User experience flow with emotion scores, phases, and annotations"
+  },
+  {
+    id: "c4",
+    description: "System architecture (context, container, component, deployment)"
+  },
+  {
+    id: "er",
+    description: "Database schemas and relationships"
+  },
+  {
+    id: "class",
+    description: "UML class hierarchies"
+  },
+  {
+    id: "sequence",
+    description: "Message request and response interaction flows",
+    fallback: true
+  },
+  {
+    id: "state",
+    description: "State machine / lifecycle transitions"
+  },
+  {
+    id: "infra",
+    description: "Infrastructure traffic flow with RPS computation"
+  },
+  {
+    id: "gantt",
+    description: "Project scheduling with task dependencies and milestones"
+  },
+  {
+    id: "pert",
+    description: "Project network with three-point estimates, critical path, and uncertainty (Beta-PERT, Monte Carlo)"
+  },
+  {
+    id: "swimlane",
+    description: "Cross-functional process flow with lanes, phases and gateways (BPMN-style)"
+  },
+  {
+    id: "version-control",
+    description: "Git / version-control branch-and-merge graph: commits, branches, merges, rebase, HEAD and remote-tracking (gitGraph-style)"
+  },
+  // ── Tier 2 — Specialized structural diagrams ──────────────
+  {
+    id: "timeline",
+    description: "Events, eras, and date ranges"
+  },
+  {
+    id: "event-line",
+    description: "Annotated narrative timeline \u2014 events on a horizontal line with descriptions (not the date-scaled timeline)"
+  },
+  {
+    id: "body",
+    description: "Human anatomy figure annotated by muscle/bone/joint name \u2014 for medical, exercise, and educational diagrams"
+  },
+  {
+    id: "org",
+    description: "Reporting hierarchy"
+  },
+  {
+    id: "family",
+    description: "Family tree / genealogy: unions (couples), children, remarriage, adoption, and GEDCOM-style metadata"
+  },
+  {
+    id: "sitemap",
+    description: "Site / app navigation structure"
+  },
+  {
+    id: "bracket",
+    description: "Single-elimination tournament bracket: winners auto-advance up a tree; seed the field for a day-0 skeleton or list results for a casual bracket, with two sides mirroring inward to a championship"
+  },
+  {
+    id: "kanban",
+    description: "Task board columns"
+  },
+  {
+    id: "raci",
+    description: "Tasks \xD7 roles responsibility matrix with constraint linting"
+  },
+  {
+    id: "tech-radar",
+    description: "Technology adoption quadrants (adopt/trial/assess/hold)"
+  },
+  {
+    id: "mindmap",
+    description: "Radial hierarchy of ideas branching from a central topic"
+  },
+  {
+    id: "wireframe",
+    description: "Low-fidelity UI layout with panels, controls, and annotations"
+  },
+  {
+    id: "cycle",
+    description: "Cyclical process visualization (PDCA, OODA, DevOps loops)"
+  },
+  {
+    id: "pyramid",
+    description: "Stacked hierarchy of layers with descriptions (Maslow, DIKW)"
+  },
+  {
+    id: "ring",
+    description: "Concentric rings showing nested or hierarchical categories (read core-out)"
+  },
+  {
+    id: "treemap",
+    description: "Nested rectangles sized by value \u2014 show a hierarchy\u2019s proportions (budgets, disk usage, portfolios) with color by category, value heatmap, or branch"
+  },
+  {
+    id: "block",
+    description: "Block diagram: an author-controlled grid of rectangular blocks with nested, collapsible containers \u2014 system/hardware/architecture layouts where the 2-D arrangement is the meaning"
+  },
+  {
+    id: "sketch",
+    description: "GUI-first constrained canvas: uniformly-sized shapes placed freely on a snap grid, arrows between them, meaning through tags \u2014 the markup is generated by the canvas editor"
+  },
+  {
+    id: "goal",
+    description: "Single progress-toward-a-target value (now vs target) as a progress bar, thermometer, or gauge \u2014 KPIs, fundraising, quotas, completion"
+  },
+  {
+    id: "countdown",
+    description: 'Live "N days until X" that ticks every second and is accurate on every load \u2014 trip dates, launches, deadlines; the only dynamic chart type'
+  },
+  {
+    id: "clock",
+    description: "Live world-clock board: current time for people/places across time zones, ticking every second, with optional working-hours status and sundown line"
+  },
+  {
+    id: "map",
+    description: "Geographic concept map: highlight/score regions, drop points of interest, connect with routes or edges"
+  },
+  // ── Tier 3 — Specialized analytical charts ────────────────
+  {
+    id: "quadrant",
+    description: "2x2 positioning matrix"
+  },
+  {
+    id: "venn",
+    description: "Set overlaps"
+  },
+  {
+    id: "funnel",
+    description: "Conversion pipeline"
+  },
+  {
+    id: "slope",
+    description: "Change between 2 time periods"
+  },
+  {
+    id: "sankey",
+    description: "Flow / allocation visualization"
+  },
+  {
+    id: "arc",
+    description: "Network relationships (linear or circular via `layout`)"
+  },
+  {
+    id: "wordcloud",
+    description: "Term frequency visualization"
+  },
+  {
+    id: "heatmap",
+    description: "Matrix intensity visualization"
+  },
+  {
+    id: "function",
+    description: "Mathematical expressions"
+  },
+  // ── Tier 4 — General-purpose data charts ──────────────────
+  {
+    id: "bar",
+    description: "Categorical comparisons for 3 - 5 figures",
+    fallback: true
+  },
+  {
+    id: "line",
+    description: "Trends over time",
+    fallback: true
+  },
+  {
+    id: "pie",
+    description: "Part-to-whole proportions"
+  },
+  {
+    id: "radar",
+    description: "Multi-dimensional metrics"
+  },
+  {
+    id: "polar-area",
+    description: "Radial bar chart"
+  },
+  {
+    id: "scatter",
+    description: "2D data points or bubble chart"
+  },
+  // ── Tier 5 — Generic catch-alls (listed last on purpose) ──
+  {
+    id: "flowchart",
+    description: "Decision trees and process flows",
+    fallback: true
+  },
+  {
+    id: "boxes-and-lines",
+    description: "General-purpose node-edge diagrams with groups and tags",
+    fallback: true
+  }
+];
+
+export {
+  chartTypes
+};
+//# sourceMappingURL=chunk-TGOMHUOV.js.map

package/dist/{chunk-K2I2XOZD.js → chunk-TJN2OIVG.js}

@@ -1,12 +1,9 @@
+import {
+  renderNodeCard
+} from "./chunk-H3HFC3SQ.js";
 import {
   renderInlineText
 } from "./chunk-3HDBAXF5.js";
-import {
-  wrapDescriptionLines
-} from "./chunk-BMR4CIEO.js";
-import {
-  renderNodeCard
-} from "./chunk-OTOHI4JO.js";
 import {
   CARD_RADIUS,
   HEADER_HEIGHT,
@@ -14,12 +11,15 @@ import {
   NODE_STROKE_WIDTH,
   SEPARATOR_GAP
 } from "./chunk-3CIOJ5YJ.js";
+import {
+  wrapDescriptionLines
+} from "./chunk-BMR4CIEO.js";
 import {
   formatDateLabel
-} from "./chunk-7KINELPI.js";
+} from "./chunk-4ZIKWVSQ.js";
 import {
   renderIntegratedLegend
-} from "./chunk-AUIM2NVH.js";
+} from "./chunk-2NZOHEP4.js";
 import {
   TITLE_FONT_SIZE,
   TITLE_FONT_WEIGHT,
@@ -31,21 +31,21 @@ import {
 import {
   CHAR_WIDTH_RATIO,
   wrapTextToWidth
-} from "./chunk-WCT3NYCV.js";
+} from "./chunk-4ASYQ347.js";
 import {
   contrastText,
   getSeriesColors,
   mix,
   shapeFill,
   themeBaseBg
-} from "./chunk-WBM7ZNDI.js";
+} from "./chunk-JYDMBWRP.js";
 import {
   resolveActiveTagGroup,
   resolveTagColor
-} from "./chunk-HHKO6SKY.js";
+} from "./chunk-AHTTKERF.js";
 import {
   resolveColor
-} from "./chunk-TLVIHFRO.js";
+} from "./chunk-ZKPPI6BF.js";
 
 // src/event-line/renderer.ts
 import * as d3Selection from "d3-selection";
@@ -71,6 +71,8 @@ var DATE_SUBTITLE_H = 15;
 var DATE_SUBTITLE_FONT = 10;
 var SHELF_TINT = 13;
 var SHELF_EDGE = 4;
+var SHELF_EDGE_STYLE = "spine";
+var SHELF_LIP = 2;
 var ERA_BLOCK = 30;
 var ERA_BRACKET_CAP = 8;
 var ERA_BRACKET_PAD = 14;
@@ -535,8 +537,21 @@ function renderEventLine(container, parsed, palette, isDark, onClickItem, export
         "fill",
         parsed.options.fillMode ? p.color : mix(p.color, themeBaseBg(palette, isDark), SHELF_TINT)
       );
-      const edgeY = titleNearTop ? shelfTop : shelfTop + shelfH - SHELF_EDGE;
-      cardG.append("rect").attr("x", 0).attr("y", edgeY).attr("width", CARD_W).attr("height", SHELF_EDGE).attr("clip-path", `url(#${clipId})`).attr("fill", p.color).attr("fill-opacity", p.future ? 0.4 : 1);
+      if (SHELF_EDGE_STYLE !== "none" && !parsed.options.fillMode) {
+        const lip = SHELF_EDGE_STYLE === "left" ? {
+          // vertical lip on the spine-relative leading edge
+          x: 0,
+          y: shelfTop,
+          width: SHELF_LIP,
+          height: shelfH
+        } : {
+          x: 0,
+          y: titleNearTop ? shelfTop : shelfTop + shelfH - SHELF_LIP,
+          width: CARD_W,
+          height: SHELF_LIP
+        };
+        cardG.append("rect").attr("x", lip.x).attr("y", lip.y).attr("width", lip.width).attr("height", lip.height).attr("clip-path", `url(#${clipId})`).attr("fill", p.color).attr("fill-opacity", p.future ? 0.4 : 1);
+      }
       const shelfText = parsed.options.fillMode ? contrastText(p.color, palette.textOnFillLight, palette.textOnFillDark) : p.color;
       const titleMid = headBandTop + p.headerH / 2;
       const titleTop = titleMid - (p.titleLines.length - 1) * TITLE_LINE_H / 2;
@@ -982,4 +997,4 @@ export {
   focusEventLine,
   renderEventLineForExport
 };
-//# sourceMappingURL=chunk-K2I2XOZD.js.map
+//# sourceMappingURL=chunk-TJN2OIVG.js.map

package/dist/{chunk-VILVLS7P.js → chunk-TLNVYWPA.js}

@@ -5,12 +5,12 @@ import {
   parseFirstLine,
   splitNameAndMeta,
   warnUnknownMetaKeys
-} from "./chunk-BRENJ2BQ.js";
+} from "./chunk-3FRO35WW.js";
 import {
   makeDgmoError,
   makeFail,
   suggest
-} from "./chunk-CXK4DZH3.js";
+} from "./chunk-4W2PE66Q.js";
 
 // src/tech-radar/parser.ts
 var VALID_POSITIONS = [
@@ -28,11 +28,15 @@ var POSITION_ORDER = [
 ];
 var KNOWN_OPTIONS = /* @__PURE__ */ new Set([]);
 var KNOWN_BOOLEANS = /* @__PURE__ */ new Set([
+  // Blip listing is default-on (decision #48): `no-blip-legend` suppresses it;
+  // `show-blip-legend` is the parse-accepted legacy no-op.
+  "no-blip-legend",
   "show-blip-legend",
   "fill-tint",
   "fill-solid",
   "fill-outline",
-  "no-title"
+  "no-title",
+  "no-legend"
 ]);
 function parseTechRadar(content) {
   const result = {
@@ -334,4 +338,4 @@ function assignGlobalNumbers(result) {
 export {
   parseTechRadar
 };
-//# sourceMappingURL=chunk-VILVLS7P.js.map
+//# sourceMappingURL=chunk-TLNVYWPA.js.map

package/dist/{chunk-GJFAMOGK.js → chunk-U4IN6AHE.js}

@@ -1,16 +1,16 @@
+import {
+  FONT_FAMILY
+} from "./chunk-6KFWC4CO.js";
 import {
   encodeDiagramUrl
-} from "./chunk-J7KJR3R6.js";
+} from "./chunk-U7VO6JAA.js";
 import {
   parseDgmoChartType
-} from "./chunk-ZEF5M5MB.js";
-import {
-  FONT_FAMILY
-} from "./chunk-6KFWC4CO.js";
+} from "./chunk-SBOAZ7YK.js";
 import {
   measureText,
   truncateText
-} from "./chunk-WCT3NYCV.js";
+} from "./chunk-4ASYQ347.js";
 
 // src/error-card.ts
 var DOCS_BASE = "https://diagrammo.app/docs";
@@ -428,4 +428,4 @@ export {
   defaultEmbedBackground,
   getEmbedSvgViewBox
 };
-//# sourceMappingURL=chunk-GJFAMOGK.js.map
+//# sourceMappingURL=chunk-U4IN6AHE.js.map