@diagrammo/dgmo 0.84.0 → 0.85.0

package/dist/advanced.d.ts

@@ -1034,8 +1034,19 @@ declare function isSequenceNote(el: SequenceElement): el is SequenceNote;
  */
 interface SequenceGroup {
     readonly name: string;
+    /**
+     * Every participant under this group, nested ones included, in source
+     * order. Transitive so a frame — outer or inner — can size itself from one
+     * list; `parent` is what distinguishes the two. Members of a nested group
+     * are contiguous inside their parent's list because the source order that
+     * built it is the order they were written in.
+     */
     readonly participantIds: readonly ParticipantId[];
     readonly lineNumber: number;
+    /** Name of the enclosing group, when this one is indented inside another. */
+    readonly parent?: string;
+    /** 0 for a top-level group, 1 for one nested inside it. Capped at MAX_GROUP_DEPTH - 1. */
+    readonly depth: number;
     /** Pipe-delimited tag metadata (e.g. `[Backend | t: Product]`) */
     readonly metadata?: Readonly<Record<string, string>>;
     /** Whether this group is collapsed by default */

package/dist/advanced.js

@@ -16,7 +16,7 @@ import {
   computeActivations,
   groupMessagesBySection,
   renderSequenceDiagram
-} from "./chunk-AYA6C64M.js";
+} from "./chunk-NJS62BAG.js";
 import {
   renderRing,
   renderRingForExport
@@ -320,8 +320,8 @@ import {
   renderSlopeChart,
   renderVenn,
   renderWordCloud
-} from "./chunk-QZRYCRT7.js";
-import "./chunk-VKGQX6P2.js";
+} from "./chunk-ADAGWVWJ.js";
+import "./chunk-OZTDXMRQ.js";
 import {
   CHART_TYPE_DESCRIPTIONS,
   chartTypeParsers,
@@ -331,7 +331,7 @@ import {
   knownChartTypeIds,
   parseDgmo,
   parseVisualization
-} from "./chunk-KABGWUND.js";
+} from "./chunk-T327J6CE.js";
 import "./chunk-EOYPX6SF.js";
 import {
   normalizePlace,
@@ -527,7 +527,7 @@ import {
 } from "./chunk-RE27AX7O.js";
 import {
   parseDgmoChartType
-} from "./chunk-ECIXBEG2.js";
+} from "./chunk-JVRDKR5R.js";
 import {
   allTasks,
   parseRaci
@@ -548,7 +548,7 @@ import {
   isSequenceNote,
   looksLikeSequence,
   parseSequenceDgmo
-} from "./chunk-6EV2F6W7.js";
+} from "./chunk-VPASQOR3.js";
 import {
   RULE_COUNT,
   inferParticipantType

package/dist/block.js

@@ -4,12 +4,12 @@ import {
 } from "./chunk-D3K4U3ZM.js";
 import {
   render
-} from "./chunk-QZRYCRT7.js";
+} from "./chunk-ADAGWVWJ.js";
 import {
   docsLink,
   renderErrorCard
-} from "./chunk-VKGQX6P2.js";
-import "./chunk-KABGWUND.js";
+} from "./chunk-OZTDXMRQ.js";
+import "./chunk-T327J6CE.js";
 import "./chunk-EOYPX6SF.js";
 import "./chunk-WP2RLGDI.js";
 import "./chunk-A2RUBBVT.js";
@@ -68,7 +68,7 @@ import "./chunk-KAO7JL4I.js";
 import {
   encodeDiagramUrl
 } from "./chunk-RE27AX7O.js";
-import "./chunk-ECIXBEG2.js";
+import "./chunk-JVRDKR5R.js";
 import "./chunk-3RYBTEF5.js";
 import "./chunk-UNNJCSSQ.js";
 import "./chunk-3TYUXC7D.js";
@@ -77,7 +77,7 @@ import "./chunk-EQW6HOP4.js";
 import {
   scanMonthNameDates
 } from "./chunk-DAOFNU6J.js";
-import "./chunk-6EV2F6W7.js";
+import "./chunk-VPASQOR3.js";
 import "./chunk-C3Z4DX3V.js";
 import "./chunk-JRUEIRJB.js";
 import "./chunk-7TF3QOOD.js";

package/dist/chart-meta.js

@@ -10,7 +10,7 @@ import {
 } from "./chunk-RE27AX7O.js";
 import {
   parseDgmoChartType
-} from "./chunk-ECIXBEG2.js";
+} from "./chunk-JVRDKR5R.js";
 import {
   parseRaci
 } from "./chunk-3RYBTEF5.js";
@@ -19,7 +19,7 @@ import "./chunk-3TYUXC7D.js";
 import "./chunk-HMWZQ53A.js";
 import "./chunk-EQW6HOP4.js";
 import "./chunk-DAOFNU6J.js";
-import "./chunk-6EV2F6W7.js";
+import "./chunk-VPASQOR3.js";
 import "./chunk-C3Z4DX3V.js";
 import "./chunk-JRUEIRJB.js";
 import "./chunk-7TF3QOOD.js";

package/dist/{chunk-QZRYCRT7.js → chunk-ADAGWVWJ.js}

@@ -8,7 +8,7 @@ import {
   parseVenn,
   parseVisualization,
   parseWordcloud
-} from "./chunk-KABGWUND.js";
+} from "./chunk-T327J6CE.js";
 import {
   MAP_DX
 } from "./chunk-EOYPX6SF.js";
@@ -1951,7 +1951,7 @@ function resolveArcChordOverride(content, detectedType, palette) {
 }
 async function renderForExport(content, theme, palette, viewState, options) {
   const exportMode = options?.exportMode ?? false;
-  const { parseDgmoChartType } = await import("./dgmo-router-YW4SBNYB.js");
+  const { parseDgmoChartType } = await import("./dgmo-router-VILEOWQ2.js");
   const detectedTypeRaw = parseDgmoChartType(content);
   const override = resolveArcChordOverride(content, detectedTypeRaw, palette);
   const renderContent = override?.content ?? content;
@@ -2877,7 +2877,7 @@ async function exportTreemap(ctx) {
 async function exportLiveLink(ctx) {
   const { content, theme, palette } = ctx;
   const { parseLiveLink } = await import("./parser-6TXNMXNB.js");
-  const { renderLiveLinkCard } = await import("./renderer-QZW4RCZW.js");
+  const { renderLiveLinkCard } = await import("./renderer-5A6VWIVX.js");
   const effectivePalette = await resolveExportPalette(theme, palette);
   return renderLiveLinkCard(parseLiveLink(content), effectivePalette, theme);
 }
@@ -3087,8 +3087,8 @@ async function exportVisualization(ctx) {
   const effectivePalette = await resolveExportPalette(theme, palette);
   const isDark = ctx.isDark;
   const container = createExportContainer(ctx.width, ctx.height);
-  const { parseSequenceDgmo } = await import("./parser-6PHQJO42.js");
-  const { renderSequenceDiagram } = await import("./renderer-GWNSV76V.js");
+  const { parseSequenceDgmo } = await import("./parser-PVIWHVGY.js");
+  const { renderSequenceDiagram } = await import("./renderer-DRLLZZ6P.js");
   const seqParsed = parseSequenceDgmo(content, effectivePalette);
   if (seqParsed.error || seqParsed.participants.length === 0) return "";
   const collapsedSections = viewState?.cs ? new Set(viewState.cs) : void 0;

package/dist/{chunk-ECIXBEG2.js → chunk-JVRDKR5R.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-HMWZQ53A.js";
 import {
   looksLikeSequence
-} from "./chunk-6EV2F6W7.js";
+} from "./chunk-VPASQOR3.js";
 import {
   looksLikeFlowchart
 } from "./chunk-JRUEIRJB.js";

package/dist/{chunk-AYA6C64M.js → chunk-NJS62BAG.js}

@@ -43,7 +43,7 @@ import {
   isSequenceBlock,
   isSequenceNote,
   isSequenceSection
-} from "./chunk-6EV2F6W7.js";
+} from "./chunk-VPASQOR3.js";
 import {
   resolveActiveTagGroup,
   tagAttrKey
@@ -74,12 +74,28 @@ function applyCollapseProjection(parsed, collapsedGroups) {
       collapsedGroupIds: /* @__PURE__ */ new Map()
     };
   }
+  const byName = new Map(parsed.groups.map((g) => [g.name, g]));
+  const insideCollapsed = (group) => {
+    let parentName = group.parent;
+    const seen = /* @__PURE__ */ new Set();
+    while (parentName !== void 0 && !seen.has(parentName)) {
+      seen.add(parentName);
+      const ancestor = byName.get(parentName);
+      if (!ancestor) return false;
+      if (collapsedGroups.has(ancestor.lineNumber)) return true;
+      parentName = ancestor.parent;
+    }
+    return false;
+  };
   const memberToGroup = /* @__PURE__ */ new Map();
   const collapsedGroupNames = /* @__PURE__ */ new Set();
-  for (const group of parsed.groups) {
-    if (collapsedGroups.has(group.lineNumber)) {
-      collapsedGroupNames.add(group.name);
-      for (const memberId of group.participantIds) {
+  const byDepth = [...parsed.groups].sort((a, b) => a.depth - b.depth);
+  for (const group of byDepth) {
+    if (!collapsedGroups.has(group.lineNumber)) continue;
+    if (insideCollapsed(group)) continue;
+    collapsedGroupNames.add(group.name);
+    for (const memberId of group.participantIds) {
+      if (!memberToGroup.has(memberId)) {
         memberToGroup.set(memberId, group.name);
       }
     }
@@ -114,9 +130,14 @@ function applyCollapseProjection(parsed, collapsedGroups) {
     to: remap(msg.to)
   }));
   const elements = remapElements(parsed.elements, memberToGroup);
-  const groups = parsed.groups.filter(
-    (g) => !collapsedGroups.has(g.lineNumber)
-  );
+  const groups = parsed.groups.filter((g) => !collapsedGroups.has(g.lineNumber) && !insideCollapsed(g)).map((g) => {
+    const remapped = [];
+    for (const id of g.participantIds) {
+      const to = memberToGroup.get(id) ?? id;
+      if (!remapped.includes(to)) remapped.push(to);
+    }
+    return { ...g, participantIds: remapped };
+  });
   return {
     participants,
     messages,
@@ -163,7 +184,7 @@ function remapElements(elements, memberToGroup) {
 
 // src/sequence/tag-resolution.ts
 function propagateGroupTags(participantMeta, groups) {
-  for (const group of groups) {
+  for (const group of [...groups].sort((a, b) => b.depth - a.depth)) {
     if (!group.metadata) continue;
     for (const id of group.participantIds) {
       const meta = participantMeta.get(id);
@@ -592,6 +613,7 @@ function applyPositionOverrides(participants) {
 function applyGroupOrdering(participants, groups, messages = []) {
   const idToGroup = /* @__PURE__ */ new Map();
   for (const group of groups) {
+    if (group.parent !== void 0) continue;
     for (const id of group.participantIds) {
       idToGroup.set(id, group);
     }
@@ -672,6 +694,7 @@ function renderSequenceDiagram(container, parsed, palette, isDark, _onNavigateTo
   if (groups.length > 0) {
     const pToG = /* @__PURE__ */ new Map();
     for (let gi = 0; gi < groups.length; gi++) {
+      if (groups[gi].parent !== void 0) continue;
       for (const pid of groups[gi].participantIds) pToG.set(pid, gi);
     }
     const LOOSE = -1;
@@ -1063,7 +1086,11 @@ function renderSequenceDiagram(container, parsed, palette, isDark, _onNavigateTo
   for (const region of sectionRegions) {
     sectionMsgCounts.set(region.section.lineNumber, region.msgIndices.length);
   }
+  const sEdgePad = ctx.aesthetic(20);
   const GROUP_PADDING_X = 15;
+  const GROUP_NEST_INSET_X = 6;
+  const GROUP_NEST_MIN_PAD_X = 4;
+  const GROUP_NEST_INSET_Y = 6;
   const GROUP_PADDING_TOP = 22;
   const GROUP_PADDING_BOTTOM = 8;
   const GROUP_LABEL_SIZE = 11;
@@ -1108,11 +1135,13 @@ function renderSequenceDiagram(container, parsed, palette, isDark, _onNavigateTo
     titleBaselineY: ctx.structural(TITLE_Y),
     titleFontSize: ctx.text(TITLE_FONT_SIZE)
   });
-  const groupOffset = parsed.groups.length > 0 ? GROUP_PADDING_TOP + GROUP_LABEL_SIZE : 0;
+  const maxGroupDepth = parsed.groups.reduce((d, g) => Math.max(d, g.depth), 0);
+  const groupOffset = parsed.groups.length > 0 ? (maxGroupDepth + 1) * GROUP_PADDING_TOP + GROUP_LABEL_SIZE : 0;
+  const groupBottomPad = (depth) => GROUP_PADDING_BOTTOM + (maxGroupDepth - depth) * GROUP_NEST_INSET_Y;
   const participantStartY = sTopMargin + titleOffset + (header.inline ? 0 : legendTopSpace) + sParticipantYOffset + groupOffset;
   const lifelineStartY0 = participantStartY + sBoxH;
   const hasActors = participants.some((p) => p.type === "actor");
-  const messageStartOffset = sMsgStartOffset + (hasActors ? 20 : 0) + (parsed.groups.length > 0 ? GROUP_PADDING_BOTTOM : 0);
+  const messageStartOffset = sMsgStartOffset + (hasActors ? 20 : 0) + (parsed.groups.length > 0 ? groupBottomPad(0) : 0);
   const stepYPositions = [];
   const sectionYPositions = /* @__PURE__ */ new Map();
   let layoutEndY;
@@ -1219,13 +1248,16 @@ function renderSequenceDiagram(container, parsed, palette, isDark, _onNavigateTo
     sWithinGap = sGap * 0.88;
     sBetweenGap = (totalGaps * sGap - numWithinGaps * sWithinGap) / numGroupGaps;
   }
+  const edgeProjection = (id) => {
+    if (!id) return sBoxW / 2;
+    const framed = parsed.groups.some(
+      (g) => g.participantIds.includes(id)
+    );
+    return framed ? sBoxW / 2 + GROUP_PADDING_X : sBoxW / 2;
+  };
   const rightmostId = participants[participants.length - 1]?.id;
-  let rightProjection = sBoxW / 2;
+  let rightProjection = edgeProjection(rightmostId);
   if (rightmostId) {
-    if (parsed.groups.some(
-      (g) => g.participantIds.includes(rightmostId)
-    ))
-      rightProjection = Math.max(rightProjection, sBoxW / 2 + GROUP_PADDING_X);
     for (const step of renderSteps) {
       if (step.from === step.to && step.from === rightmostId) {
         const selfProj = sActivationWidth + sSelfCallWidth;
@@ -1253,8 +1285,11 @@ function renderSequenceDiagram(container, parsed, palette, isDark, _onNavigateTo
     if (elements && hasBlockWithRightmost(elements))
       rightProjection = Math.max(rightProjection, sBoxW / 2 + blockFramePadX);
   }
-  let rightMargin = Math.max(rightProjection + 10, sGap / 2);
-  let leftMargin = sGap / 2;
+  let rightMargin = Math.max(rightProjection + sEdgePad, sGap / 2);
+  let leftMargin = Math.max(
+    edgeProjection(participants[0]?.id) + sEdgePad,
+    sGap / 2
+  );
   const diagramWidth = Math.max(0, participants.length - 1) * sGap;
   let totalWidth = Math.max(
     leftMargin + diagramWidth + rightMargin,
@@ -1392,6 +1427,7 @@ function renderSequenceDiagram(container, parsed, palette, isDark, _onNavigateTo
       collapsedGroupNames.add(group.name);
       collapsedGroupMeta.set(group.name, {
         lineNumber: group.lineNumber,
+        depth: group.depth,
         participantIds: group.participantIds,
         ...group.metadata !== void 0 && { metadata: group.metadata }
       });
@@ -1414,14 +1450,35 @@ function renderSequenceDiagram(container, parsed, palette, isDark, _onNavigateTo
   const hasExpandedGroup = groups.some(
     (g) => g.participantIds.some((id) => participantX.has(id))
   );
-  for (const group of groups) {
+  const framedGroups = [...groups].sort((a, b) => a.depth - b.depth);
+  const allColumnXs = [...participantX.values()].sort((a, b) => a - b);
+  const frameExtents = /* @__PURE__ */ new Map();
+  for (const group of framedGroups) {
     if (group.participantIds.length === 0) continue;
     const memberXs = group.participantIds.map((id) => participantX.get(id)).filter((x) => x !== void 0);
     if (memberXs.length === 0) continue;
-    const minX = Math.min(...memberXs) - sBoxW / 2 - GROUP_PADDING_X;
-    const maxX = Math.max(...memberXs) + sBoxW / 2 + GROUP_PADDING_X;
-    const boxY = participantStartY - GROUP_PADDING_TOP;
-    const boxH = sBoxH + GROUP_PADDING_TOP + GROUP_PADDING_BOTTOM;
+    const firstX = Math.min(...memberXs);
+    const lastX = Math.max(...memberXs);
+    const padX = Math.max(
+      GROUP_NEST_MIN_PAD_X,
+      GROUP_PADDING_X - group.depth * GROUP_NEST_INSET_X
+    );
+    let minX = firstX - sBoxW / 2 - padX;
+    let maxX = lastX + sBoxW / 2 + padX;
+    if (group.depth > 0) {
+      const prevX = allColumnXs.filter((x) => x < firstX).pop();
+      const nextX = allColumnXs.find((x) => x > lastX);
+      if (prevX !== void 0) minX = (prevX + firstX) / 2;
+      if (nextX !== void 0) maxX = (lastX + nextX) / 2;
+      const parent = group.parent ? frameExtents.get(group.parent) : void 0;
+      if (parent) {
+        minX = Math.max(minX, parent.minX + GROUP_NEST_MIN_PAD_X);
+        maxX = Math.min(maxX, parent.maxX - GROUP_NEST_MIN_PAD_X);
+      }
+    }
+    frameExtents.set(group.name, { minX, maxX });
+    const boxY = participantStartY - (maxGroupDepth + 1 - group.depth) * GROUP_PADDING_TOP;
+    const boxH = sBoxH + (participantStartY - boxY) + groupBottomPad(group.depth);
     const groupTagValue = tagKey && group.metadata?.[tagKey];
     const groupTagColor = getTagColor(groupTagValue || void 0);
     const fillColor = groupTagColor ? mix(groupTagColor, themeBaseBg(palette, isDark), isDark ? 15 : 20) : isDark ? palette.surface : palette.bg;
@@ -1496,8 +1553,8 @@ function renderSequenceDiagram(container, parsed, palette, isDark, _onNavigateTo
       const drillColor = effectiveTagColor ?? mix(palette.textMuted, themeBaseBg(palette, isDark), 55);
       const drillBarH = ctx.structural(COLLAPSE_BAR_HEIGHT);
       const boxW = sBoxW;
-      const padTop = hasExpandedGroup ? GROUP_PADDING_TOP : 0;
-      const padBottom = hasExpandedGroup ? GROUP_PADDING_BOTTOM : 0;
+      const padTop = hasExpandedGroup ? (maxGroupDepth + 1 - meta.depth) * GROUP_PADDING_TOP : 0;
+      const padBottom = hasExpandedGroup ? groupBottomPad(meta.depth) : 0;
       const fullH = sBoxH + padTop + padBottom;
       const clipId = `clip-drill-group-${participant.id.replace(/[^a-zA-Z0-9-]/g, "-")}`;
       const participantG = svg.select(
@@ -1515,7 +1572,7 @@ function renderSequenceDiagram(container, parsed, palette, isDark, _onNavigateTo
       participantG.append("clipPath").attr("id", clipId).append("rect").attr("x", -boxW / 2).attr("y", -padTop).attr("width", boxW).attr("height", fullH).attr("rx", 6);
       participantG.append("rect").attr("class", "sequence-drill-bar").attr("x", -boxW / 2).attr("y", -padTop + fullH - drillBarH).attr("width", boxW).attr("height", drillBarH).attr("fill", drillColor).attr("clip-path", `url(#${clipId})`);
     }
-    const llY = isCollapsedGroup ? lifelineStartY + (hasExpandedGroup ? GROUP_PADDING_BOTTOM : 0) : participant.type === "actor" ? lifelineStartY + ACTOR_LABEL_CLEARANCE : lifelineStartY;
+    const llY = isCollapsedGroup ? lifelineStartY + (hasExpandedGroup ? groupBottomPad(collapsedGroupMeta.get(participant.id)?.depth ?? 0) : 0) : participant.type === "actor" ? lifelineStartY + ACTOR_LABEL_CLEARANCE : lifelineStartY;
     const llColor = effectiveTagColor || palette.textMuted;
     for (const [segTop, segBottom] of lifelineSegments(
       cx,

package/dist/{chunk-VKGQX6P2.js → chunk-OZTDXMRQ.js}

@@ -11,7 +11,7 @@ import {
 } from "./chunk-RE27AX7O.js";
 import {
   parseDgmoChartType
-} from "./chunk-ECIXBEG2.js";
+} from "./chunk-JVRDKR5R.js";
 import {
   chartTypes
 } from "./chunk-44GP7PD5.js";

package/dist/{chunk-KABGWUND.js → chunk-T327J6CE.js}

@@ -96,7 +96,7 @@ import {
 } from "./chunk-BAZT6CIF.js";
 import {
   parseDgmoChartType
-} from "./chunk-ECIXBEG2.js";
+} from "./chunk-JVRDKR5R.js";
 import {
   parseRaci
 } from "./chunk-3RYBTEF5.js";
@@ -114,8 +114,9 @@ import {
   toInternal
 } from "./chunk-DAOFNU6J.js";
 import {
+  SEQUENCE_DIAGNOSTICS,
   parseSequenceDgmo
-} from "./chunk-6EV2F6W7.js";
+} from "./chunk-VPASQOR3.js";
 import {
   parseFlowchart
 } from "./chunk-JRUEIRJB.js";
@@ -1608,6 +1609,7 @@ var REGISTRY = [
   ...PERT_DIAGNOSTICS,
   ...GRAPH_DIAGNOSTICS,
   ...COLOR_DIAGNOSTICS,
+  ...SEQUENCE_DIAGNOSTICS,
   ...SKETCH_DIAGNOSTICS,
   ...FAMILY_DIAGNOSTICS,
   ...ALIAS_DIAGNOSTICS

package/dist/{chunk-6EV2F6W7.js → chunk-VPASQOR3.js}

@@ -41,6 +41,22 @@ import {
   suggest
 } from "./chunk-BYU54C3S.js";
 
+// src/sequence/diagnostics.ts
+var SEQUENCE_DIAGNOSTIC_CODES = {
+  GROUP_DEPTH: "E_SEQ_GROUP_DEPTH"
+};
+var SEQUENCE_DIAGNOSTICS = [
+  {
+    code: SEQUENCE_DIAGNOSTIC_CODES.GROUP_DEPTH,
+    severity: "error",
+    chartType: "sequence",
+    title: "Group nested too deep",
+    message: (p) => `Group "${String(p.label ?? "?")}" is nested ${String(p.depth ?? "?")} levels deep \u2014 participant groups nest to depth ${String(p.max ?? "?")}; its participants join the group above it`,
+    hint: "Move the inner [Group] up a level \u2014 two levels of bracket is the bound.",
+    example: "sequence\n[Monolith]\n  [Linux]\n    [Container]\n      App"
+  }
+];
+
 // src/sequence/parser.ts
 var KNOWN_SEQ_OPTIONS = /* @__PURE__ */ new Set(["active-tag"]);
 var KNOWN_SEQ_BOOLEANS = /* @__PURE__ */ new Set([
@@ -70,6 +86,7 @@ function isSequenceNote(el) {
 }
 var IS_A_PATTERN = /^([^:]+?)\s+is\s+an?\s+(\w+)(?:\s+(.+))?$/i;
 var COLORED_PARTICIPANT_PATTERN = /^(\S+?)\((red|orange|yellow|green|blue|purple|teal|cyan|gray|black|white)\)\s*$/;
+var MAX_GROUP_DEPTH = 2;
 var GROUP_HEADING_PATTERN = /^\[([^\]|]+?)(?:\(([^)]+)\))?\]\s*(.*)$/;
 var GROUP_HEADING_FALLBACK = /^\[([^\]]+)\]\s*(.*)$/;
 var SECTION_PATTERN = /^==\s+(.+?)(?:\s*==)?\s*$/;
@@ -218,8 +235,8 @@ function parseSequenceDgmo(content, palette) {
     return nameAliasMap.resolve(trimmed) ?? trimmed;
   };
   const fail = makeFail(result);
-  const pushError = (line, message) => {
-    const diag = makeDgmoError(line, message);
+  const pushError = (line, message, code) => {
+    const diag = makeDgmoError(line, message, "error", code);
     result.diagnostics.push(diag);
     if (!result.error) result.error = formatDgmoError(diag);
   };
@@ -249,7 +266,31 @@ function parseSequenceDgmo(content, palette) {
     }
     break;
   }
-  let activeGroup = null;
+  const groupStack = [];
+  const activeGroup = () => groupStack.length > 0 ? groupStack[groupStack.length - 1].group : null;
+  const closeGroupsTo = (indent) => {
+    while (groupStack.length > 0 && groupStack[groupStack.length - 1].indent >= indent) {
+      groupStack.pop();
+    }
+  };
+  const joinActiveGroup = (key, id, lineNumber) => {
+    const innermost = activeGroup();
+    if (!innermost || innermost.participantIds.includes(key)) return;
+    const existingGroup = participantGroupMap.get(key);
+    if (existingGroup) {
+      pushError(
+        lineNumber,
+        `Participant '${id}' is already in group '${existingGroup}' \u2014 participants can only belong to one group`
+      );
+      return;
+    }
+    for (const frame of groupStack) {
+      if (!frame.group.participantIds.includes(key)) {
+        frame.group.participantIds.push(key);
+      }
+    }
+    participantGroupMap.set(key, innermost.name);
+  };
   const participantIds = /* @__PURE__ */ new Set();
   const idByKey = /* @__PURE__ */ new Map();
   const addParticipant = (name, lineNumber, extras) => {
@@ -364,7 +405,7 @@ function parseSequenceDgmo(content, palette) {
     const lineNumber = i + 1;
     nameAliasMap.at(lineNumber);
     if (!trimmed) {
-      activeGroup = null;
+      closeGroupsTo(0);
       currentTagGroup = null;
       continue;
     }
@@ -407,14 +448,29 @@ function parseSequenceDgmo(content, palette) {
         );
       }
       contentStarted = true;
-      activeGroup = {
+      const headingIndent = measureIndent(raw);
+      closeGroupsTo(headingIndent);
+      const depth = groupStack.length;
+      if (depth >= MAX_GROUP_DEPTH) {
+        pushError(
+          lineNumber,
+          `Group '${groupName}' is nested ${String(depth + 1)} levels deep \u2014 participant groups nest to depth ${String(MAX_GROUP_DEPTH)}; its participants join the group above it`,
+          SEQUENCE_DIAGNOSTIC_CODES.GROUP_DEPTH
+        );
+        continue;
+      }
+      const parentGroup = activeGroup();
+      const group = {
         name: groupName,
         participantIds: [],
         lineNumber,
+        depth,
+        ...parentGroup ? { parent: parentGroup.name } : {},
         ...groupMeta ? { metadata: groupMeta } : {},
         ...isCollapsed ? { collapsed: true } : {}
       };
-      result.groups.push(activeGroup);
+      result.groups.push(group);
+      groupStack.push({ group, indent: headingIndent });
       continue;
     }
     if (trimmed.startsWith("[")) {
@@ -431,9 +487,7 @@ function parseSequenceDgmo(content, palette) {
         continue;
       }
     }
-    if (activeGroup && measureIndent(raw) === 0) {
-      activeGroup = null;
-    }
+    closeGroupsTo(measureIndent(raw));
     if (trimmed.startsWith("//")) continue;
     if (trimmed.startsWith("#")) {
       pushError(lineNumber, "Use // for comments");
@@ -623,18 +677,7 @@ function parseSequenceDgmo(content, palette) {
         ...position !== void 0 && { position },
         ...isAMeta !== void 0 && { metadata: isAMeta }
       });
-      if (activeGroup && !activeGroup.participantIds.includes(key)) {
-        const existingGroup = participantGroupMap.get(key);
-        if (existingGroup) {
-          pushError(
-            lineNumber,
-            `Participant '${id}' is already in group '${existingGroup}' \u2014 participants can only belong to one group`
-          );
-        } else {
-          activeGroup.participantIds.push(key);
-          participantGroupMap.set(key, activeGroup.name);
-        }
-      }
+      joinActiveGroup(key, id, lineNumber);
       continue;
     }
     const { core: colorCore, meta: colorMeta } = splitPipe(trimmed, lineNumber);
@@ -650,18 +693,7 @@ function parseSequenceDgmo(content, palette) {
       const key = addParticipant(id, lineNumber, {
         ...colorMeta !== void 0 && { metadata: colorMeta }
       });
-      if (activeGroup && !activeGroup.participantIds.includes(key)) {
-        const existingGroup = participantGroupMap.get(key);
-        if (existingGroup) {
-          pushError(
-            lineNumber,
-            `Participant '${id}' is already in group '${existingGroup}' \u2014 participants can only belong to one group`
-          );
-        } else {
-          activeGroup.participantIds.push(key);
-          participantGroupMap.set(key, activeGroup.name);
-        }
-      }
+      joinActiveGroup(key, id, lineNumber);
       continue;
     }
     {
@@ -670,7 +702,7 @@ function parseSequenceDgmo(content, palette) {
         meta: bareMeta,
         alias: bareAlias
       } = splitPipe(trimmed, lineNumber);
-      const inGroup = activeGroup && measureIndent(raw) > 0;
+      const inGroup = activeGroup() !== null && measureIndent(raw) > 0;
       if (/^\S+$/.test(bareCore) && !ARROW_PATTERN.test(bareCore) && (inGroup || !bodyStarted || bareMeta)) {
         contentStarted = true;
         const id = bareCore;
@@ -682,18 +714,7 @@ function parseSequenceDgmo(content, palette) {
           ...position !== void 0 && { position },
           ...bareMeta !== void 0 && { metadata: bareMeta }
         });
-        if (activeGroup && !activeGroup.participantIds.includes(key)) {
-          const existingGroup = participantGroupMap.get(key);
-          if (existingGroup) {
-            pushError(
-              lineNumber,
-              `Participant '${id}' is already in group '${existingGroup}' \u2014 participants can only belong to one group`
-            );
-          } else {
-            activeGroup.participantIds.push(key);
-            participantGroupMap.set(key, activeGroup.name);
-          }
-        }
+        joinActiveGroup(key, id, lineNumber);
         continue;
       }
     }
@@ -1066,6 +1087,7 @@ function looksLikeSequence(content) {
 }
 
 export {
+  SEQUENCE_DIAGNOSTICS,
   isSequenceBlock,
   isSequenceSection,
   isSequenceNote,

package/dist/{dgmo-router-YW4SBNYB.js → dgmo-router-VILEOWQ2.js}

@@ -6,7 +6,7 @@ import {
   isExtendedChartType,
   knownChartTypeIds,
   parseDgmo
-} from "./chunk-KABGWUND.js";
+} from "./chunk-T327J6CE.js";
 import "./chunk-EOYPX6SF.js";
 import "./chunk-WP2RLGDI.js";
 import "./chunk-A2RUBBVT.js";
@@ -46,14 +46,14 @@ import {
   looksLikeC4,
   looksLikeGantt,
   parseDgmoChartType
-} from "./chunk-ECIXBEG2.js";
+} from "./chunk-JVRDKR5R.js";
 import "./chunk-3RYBTEF5.js";
 import "./chunk-UNNJCSSQ.js";
 import "./chunk-3TYUXC7D.js";
 import "./chunk-HMWZQ53A.js";
 import "./chunk-EQW6HOP4.js";
 import "./chunk-DAOFNU6J.js";
-import "./chunk-6EV2F6W7.js";
+import "./chunk-VPASQOR3.js";
 import "./chunk-C3Z4DX3V.js";
 import "./chunk-JRUEIRJB.js";
 import "./chunk-7TF3QOOD.js";

package/dist/index.js

@@ -11,15 +11,15 @@ import {
 } from "./chunk-SQAG3UXH.js";
 import {
   render
-} from "./chunk-QZRYCRT7.js";
+} from "./chunk-ADAGWVWJ.js";
 import {
   renderErrorCard
-} from "./chunk-VKGQX6P2.js";
+} from "./chunk-OZTDXMRQ.js";
 import {
   getDiagnosticSpec,
   listDiagnosticCodes,
   parseDgmo
-} from "./chunk-KABGWUND.js";
+} from "./chunk-T327J6CE.js";
 import "./chunk-EOYPX6SF.js";
 import "./chunk-WP2RLGDI.js";
 import "./chunk-A2RUBBVT.js";
@@ -82,14 +82,14 @@ import {
   decodeDiagramUrl,
   encodeDiagramUrl
 } from "./chunk-RE27AX7O.js";
-import "./chunk-ECIXBEG2.js";
+import "./chunk-JVRDKR5R.js";
 import "./chunk-3RYBTEF5.js";
 import "./chunk-UNNJCSSQ.js";
 import "./chunk-3TYUXC7D.js";
 import "./chunk-HMWZQ53A.js";
 import "./chunk-EQW6HOP4.js";
 import "./chunk-DAOFNU6J.js";
-import "./chunk-6EV2F6W7.js";
+import "./chunk-VPASQOR3.js";
 import "./chunk-C3Z4DX3V.js";
 import "./chunk-JRUEIRJB.js";
 import "./chunk-7TF3QOOD.js";

package/dist/{parser-6PHQJO42.js → parser-PVIWHVGY.js}

@@ -4,7 +4,7 @@ import {
   isSequenceSection,
   looksLikeSequence,
   parseSequenceDgmo
-} from "./chunk-6EV2F6W7.js";
+} from "./chunk-VPASQOR3.js";
 import "./chunk-C3Z4DX3V.js";
 import "./chunk-N7VMGZCU.js";
 import "./chunk-NOTA6TEI.js";

package/dist/{renderer-QZW4RCZW.js → renderer-5A6VWIVX.js}

@@ -1,8 +1,8 @@
 import {
   renderLiveLinkCard
 } from "./chunk-A6YINTY6.js";
-import "./chunk-VKGQX6P2.js";
-import "./chunk-KABGWUND.js";
+import "./chunk-OZTDXMRQ.js";
+import "./chunk-T327J6CE.js";
 import "./chunk-EOYPX6SF.js";
 import "./chunk-WP2RLGDI.js";
 import "./chunk-A2RUBBVT.js";
@@ -41,14 +41,14 @@ import "./chunk-GUTZCRBT.js";
 import "./chunk-BAZT6CIF.js";
 import "./chunk-KAO7JL4I.js";
 import "./chunk-RE27AX7O.js";
-import "./chunk-ECIXBEG2.js";
+import "./chunk-JVRDKR5R.js";
 import "./chunk-3RYBTEF5.js";
 import "./chunk-UNNJCSSQ.js";
 import "./chunk-3TYUXC7D.js";
 import "./chunk-HMWZQ53A.js";
 import "./chunk-EQW6HOP4.js";
 import "./chunk-DAOFNU6J.js";
-import "./chunk-6EV2F6W7.js";
+import "./chunk-VPASQOR3.js";
 import "./chunk-C3Z4DX3V.js";
 import "./chunk-JRUEIRJB.js";
 import "./chunk-7TF3QOOD.js";

package/dist/{renderer-GWNSV76V.js → renderer-DRLLZZ6P.js}

@@ -7,7 +7,7 @@ import {
   groupMessagesBySection,
   renderSequenceDiagram,
   summarizeSectionParticipation
-} from "./chunk-AYA6C64M.js";
+} from "./chunk-NJS62BAG.js";
 import "./chunk-WMIKC5XO.js";
 import {
   parseInlineMarkdown,
@@ -22,7 +22,7 @@ import "./chunk-FM3WAVB6.js";
 import "./chunk-ICLB27PZ.js";
 import "./chunk-RH2PROYG.js";
 import "./chunk-KAO7JL4I.js";
-import "./chunk-6EV2F6W7.js";
+import "./chunk-VPASQOR3.js";
 import "./chunk-C3Z4DX3V.js";
 import "./chunk-N7VMGZCU.js";
 import "./chunk-NOTA6TEI.js";

package/docs/language-reference.md

@@ -629,6 +629,18 @@ Names that previously inferred to a removed type — `AuthService`, `WebApp`, `C
 ```
 
 - Metadata goes outside brackets: `[Backend] t: Eng`
+- **Groups nest one level deep.** Indent a `[Group]` under another and its members one level deeper again; dedenting rejoins the outer group, so `FanScreen` below belongs to `Monolith`, not to `Linux`. A third level is refused with `E_SEQ_GROUP_DEPTH` and its participants join the group above.
+
+```
+[Monolith]
+  Camera
+  [Linux]
+    FacialCapture
+    GAEEdgeSW
+  FanScreen
+  StaffScreen
+```
+
 - **Color participants by category with a tag group** (§1.3). Declare the group with named palette colors, then assign each participant `<alias>: <Value>` — the tag is on the participant, not the group line or a message:
 
 ```

package/gallery/fixtures/sequence-groups-nested.dgmo

@@ -0,0 +1,50 @@
+sequence Night Signal Chain
+
+tag Owner as o
+  Crown red
+  Guild blue
+
+[Flagship] o: Crown
+  Lookout
+  [Gun Deck] o: Guild
+    PowderRoom
+    RangeMaster
+  Helm
+  QuarterMaster
+
+[Harbour Watch] o: Crown
+  [Watchtower] o: Guild
+    BeaconKeeper
+    TideGauge
+
+[Signal Chain]
+  Runner o: Crown
+  [Cipher Room] collapsed
+    CipherClerk
+    CodeBook
+
+== Sighting ==
+Lookout -sail on the horizon-> Helm
+Helm -range the target-> RangeMaster
+
+note right of RangeMaster
+  Bearing and elevation are
+  read off the same glass, so
+  one clerk owns both numbers
+
+RangeMaster -draw two charges-> PowderRoom
+PowderRoom -charges ready-> RangeMaster
+RangeMaster -laid and ready-> QuarterMaster
+
+== Raising the Alarm ==
+QuarterMaster -light the beacon-> BeaconKeeper
+BeaconKeeper -read the tide-> TideGauge
+TideGauge -water is making-> BeaconKeeper
+BeaconKeeper -beacon lit-> Runner
+
+== Passing the Word ==
+Runner -carry the dispatch-> CipherClerk
+CipherClerk -look up the night code-> CodeBook
+CodeBook -tonight's cipher-> CipherClerk
+CipherClerk -sealed dispatch-> Runner
+Runner -word is away-> QuarterMaster

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diagrammo/dgmo",
-  "version": "0.84.0",
+  "version": "0.85.0",
   "description": "DGMO diagram markup language — parser, renderer, and color system",
   "license": "MIT",
   "author": "Diagrammo LLC",