@diagrammo/dgmo 0.8.23 → 0.8.25

package/dist/internal.d.cts

@@ -103,6 +103,27 @@ declare function computeCardArchive(content: string, parsed: ParsedKanban, cardI
 /** Check if a column name is the archive column (case-insensitive). */
 declare function isArchiveColumn(name: string): boolean;
 
+/**
+ * Participant types that can be declared via "Name is a type" syntax.
+ */
+type ParticipantType = 'default' | 'service' | 'database' | 'actor' | 'queue' | 'cache' | 'gateway' | 'external' | 'networking' | 'frontend';
+/**
+ * A declared or inferred participant in the sequence diagram.
+ */
+interface SequenceParticipant {
+    /** Internal identifier (e.g. "AuthService") */
+    id: string;
+    /** Display label — uses aka alias if provided, otherwise id */
+    label: string;
+    /** Participant shape type */
+    type: ParticipantType;
+    /** Source line number (1-based) */
+    lineNumber: number;
+    /** Explicit layout position override (0-based from left, negative from right) */
+    position?: number;
+    /** Pipe-delimited tag metadata (e.g. `| role: Gateway`) */
+    metadata?: Record<string, string>;
+}
 /**
  * A message between two participants.
  */
@@ -153,6 +174,18 @@ interface SequenceNote {
     endLineNumber: number;
 }
 type SequenceElement = SequenceMessage | SequenceBlock | SequenceSection | SequenceNote;
+/**
+ * A named group of participants rendered as a labeled box.
+ */
+interface SequenceGroup {
+    name: string;
+    participantIds: string[];
+    lineNumber: number;
+    /** Pipe-delimited tag metadata (e.g. `[Backend | t: Product]`) */
+    metadata?: Record<string, string>;
+    /** Whether this group is collapsed by default */
+    collapsed?: boolean;
+}
 
 interface SectionMessageGroup {
     section: SequenceSection;
@@ -164,16 +197,71 @@ interface SectionMessageGroup {
  * Only top-level sections are collapsible — sections inside blocks are excluded.
  */
 declare function groupMessagesBySection(elements: SequenceElement[], messages: SequenceMessage[]): SectionMessageGroup[];
+interface RenderStep {
+    type: 'call' | 'return';
+    from: string;
+    to: string;
+    label: string;
+    messageIndex: number;
+    async?: boolean;
+}
+/**
+ * Build an ordered render sequence from flat messages.
+ * Uses a call stack to infer where returns should be placed:
+ * returns appear after all nested sub-calls complete.
+ */
+declare function buildRenderSequence(messages: SequenceMessage[]): RenderStep[];
+interface Activation {
+    participantId: string;
+    startStep: number;
+    endStep: number;
+    depth: number;
+}
+/**
+ * Compute activation rectangles from render steps.
+ * Each call pushes onto the callee's stack; each return pops it.
+ */
+declare function computeActivations(steps: RenderStep[]): Activation[];
+/**
+ * Reorder participants based on explicit `position` overrides.
+ * Positive positions are 0-based from the left; negative positions count from the right (-1 = last).
+ * Unpositioned participants maintain their relative order, filling remaining slots.
+ */
+declare function applyPositionOverrides(participants: SequenceParticipant[]): SequenceParticipant[];
+/**
+ * Reorder participants so that members of the same group are adjacent.
+ * Groups are positioned at the point where their first member would naturally
+ * appear based on message order (first-occurrence positioning). This prevents
+ * groups declared at the top of the file from being placed before participants
+ * that appear in messages earlier.
+ *
+ * Explicit `position` overrides are handled separately by `applyPositionOverrides`.
+ */
+declare function applyGroupOrdering(participants: SequenceParticipant[], groups: SequenceGroup[], messages?: SequenceMessage[]): SequenceParticipant[];
 /**
  * Build a mapping from each note's lineNumber to the lineNumber of its
  * associated message (the last message before the note in document order).
- * Used by the app to expand notes when cursor is on the associated message.
+ * Used by the app to highlight the associated message when cursor is on a note.
  */
 declare function buildNoteMessageMap(elements: SequenceElement[]): Map<number, number>;
+
+interface ArcLink {
+    source: string;
+    target: string;
+    value: number;
+    color: string | null;
+    lineNumber: number;
+}
+type ArcOrder = 'appearance' | 'name' | 'group' | 'degree';
+interface ArcNodeGroup {
+    name: string;
+    nodes: string[];
+    color: string | null;
+    lineNumber: number;
+}
 /**
- * Collect all note line numbers from a sequence diagram's elements.
- * Used by the app to compute the "expand all" set.
+ * Orders arc diagram nodes based on the selected ordering strategy.
  */
-declare function collectNoteLineNumbers(elements: SequenceElement[]): number[];
+declare function orderArcNodes(links: ArcLink[], order: ArcOrder, groups: ArcNodeGroup[]): string[];
 
-export { buildNoteMessageMap, collectNoteLineNumbers, computeCardArchive, computeCardMove, groupMessagesBySection, isArchiveColumn, parseDataRowValues };
+export { applyGroupOrdering, applyPositionOverrides, buildNoteMessageMap, buildRenderSequence, computeActivations, computeCardArchive, computeCardMove, groupMessagesBySection, isArchiveColumn, orderArcNodes, parseDataRowValues };

package/dist/internal.d.ts

@@ -103,6 +103,27 @@ declare function computeCardArchive(content: string, parsed: ParsedKanban, cardI
 /** Check if a column name is the archive column (case-insensitive). */
 declare function isArchiveColumn(name: string): boolean;
 
+/**
+ * Participant types that can be declared via "Name is a type" syntax.
+ */
+type ParticipantType = 'default' | 'service' | 'database' | 'actor' | 'queue' | 'cache' | 'gateway' | 'external' | 'networking' | 'frontend';
+/**
+ * A declared or inferred participant in the sequence diagram.
+ */
+interface SequenceParticipant {
+    /** Internal identifier (e.g. "AuthService") */
+    id: string;
+    /** Display label — uses aka alias if provided, otherwise id */
+    label: string;
+    /** Participant shape type */
+    type: ParticipantType;
+    /** Source line number (1-based) */
+    lineNumber: number;
+    /** Explicit layout position override (0-based from left, negative from right) */
+    position?: number;
+    /** Pipe-delimited tag metadata (e.g. `| role: Gateway`) */
+    metadata?: Record<string, string>;
+}
 /**
  * A message between two participants.
  */
@@ -153,6 +174,18 @@ interface SequenceNote {
     endLineNumber: number;
 }
 type SequenceElement = SequenceMessage | SequenceBlock | SequenceSection | SequenceNote;
+/**
+ * A named group of participants rendered as a labeled box.
+ */
+interface SequenceGroup {
+    name: string;
+    participantIds: string[];
+    lineNumber: number;
+    /** Pipe-delimited tag metadata (e.g. `[Backend | t: Product]`) */
+    metadata?: Record<string, string>;
+    /** Whether this group is collapsed by default */
+    collapsed?: boolean;
+}
 
 interface SectionMessageGroup {
     section: SequenceSection;
@@ -164,16 +197,71 @@ interface SectionMessageGroup {
  * Only top-level sections are collapsible — sections inside blocks are excluded.
  */
 declare function groupMessagesBySection(elements: SequenceElement[], messages: SequenceMessage[]): SectionMessageGroup[];
+interface RenderStep {
+    type: 'call' | 'return';
+    from: string;
+    to: string;
+    label: string;
+    messageIndex: number;
+    async?: boolean;
+}
+/**
+ * Build an ordered render sequence from flat messages.
+ * Uses a call stack to infer where returns should be placed:
+ * returns appear after all nested sub-calls complete.
+ */
+declare function buildRenderSequence(messages: SequenceMessage[]): RenderStep[];
+interface Activation {
+    participantId: string;
+    startStep: number;
+    endStep: number;
+    depth: number;
+}
+/**
+ * Compute activation rectangles from render steps.
+ * Each call pushes onto the callee's stack; each return pops it.
+ */
+declare function computeActivations(steps: RenderStep[]): Activation[];
+/**
+ * Reorder participants based on explicit `position` overrides.
+ * Positive positions are 0-based from the left; negative positions count from the right (-1 = last).
+ * Unpositioned participants maintain their relative order, filling remaining slots.
+ */
+declare function applyPositionOverrides(participants: SequenceParticipant[]): SequenceParticipant[];
+/**
+ * Reorder participants so that members of the same group are adjacent.
+ * Groups are positioned at the point where their first member would naturally
+ * appear based on message order (first-occurrence positioning). This prevents
+ * groups declared at the top of the file from being placed before participants
+ * that appear in messages earlier.
+ *
+ * Explicit `position` overrides are handled separately by `applyPositionOverrides`.
+ */
+declare function applyGroupOrdering(participants: SequenceParticipant[], groups: SequenceGroup[], messages?: SequenceMessage[]): SequenceParticipant[];
 /**
  * Build a mapping from each note's lineNumber to the lineNumber of its
  * associated message (the last message before the note in document order).
- * Used by the app to expand notes when cursor is on the associated message.
+ * Used by the app to highlight the associated message when cursor is on a note.
  */
 declare function buildNoteMessageMap(elements: SequenceElement[]): Map<number, number>;
+
+interface ArcLink {
+    source: string;
+    target: string;
+    value: number;
+    color: string | null;
+    lineNumber: number;
+}
+type ArcOrder = 'appearance' | 'name' | 'group' | 'degree';
+interface ArcNodeGroup {
+    name: string;
+    nodes: string[];
+    color: string | null;
+    lineNumber: number;
+}
 /**
- * Collect all note line numbers from a sequence diagram's elements.
- * Used by the app to compute the "expand all" set.
+ * Orders arc diagram nodes based on the selected ordering strategy.
  */
-declare function collectNoteLineNumbers(elements: SequenceElement[]): number[];
+declare function orderArcNodes(links: ArcLink[], order: ArcOrder, groups: ArcNodeGroup[]): string[];
 
-export { buildNoteMessageMap, collectNoteLineNumbers, computeCardArchive, computeCardMove, groupMessagesBySection, isArchiveColumn, parseDataRowValues };
+export { applyGroupOrdering, applyPositionOverrides, buildNoteMessageMap, buildRenderSequence, computeActivations, computeCardArchive, computeCardMove, groupMessagesBySection, isArchiveColumn, orderArcNodes, parseDataRowValues };

package/dist/internal.js

@@ -1,3 +1,8 @@
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+
 // src/utils/parsing.ts
 function normalizeNumericToken(token) {
   if (!token.includes(",") && !token.includes("_")) return null;
@@ -21,10 +26,15 @@ function normalizeNumericToken(token) {
     return sign + unsigned.replace(/_/g, "");
   return null;
 }
+var init_parsing = __esm({
+  "src/utils/parsing.ts"() {
+    "use strict";
+  }
+});
 
 // src/chart.ts
-function parseDataRowValues(line, options) {
-  const segments = line.split(",");
+function parseDataRowValues(line2, options) {
+  const segments = line2.split(",");
   const normalized = [];
   for (let i = 0; i < segments.length; i++) {
     const seg = segments[i].trim();
@@ -101,9 +111,14 @@ function parseDataRowValues(line, options) {
   if (!label) return null;
   return { label, values: [num] };
 }
+var init_chart = __esm({
+  "src/chart.ts"() {
+    "use strict";
+    init_parsing();
+  }
+});
 
 // src/kanban/mutations.ts
-var ARCHIVE_COLUMN_NAME = "archive";
 function computeCardMove(content, parsed, cardId, targetColumnId, targetIndex) {
   let sourceCard = null;
   let sourceColumn = null;
@@ -207,9 +222,13 @@ function computeCardArchive(content, parsed, cardId) {
 function isArchiveColumn(name) {
   return name.toLowerCase() === ARCHIVE_COLUMN_NAME;
 }
-
-// src/sequence/renderer.ts
-import * as d3Selection from "d3-selection";
+var ARCHIVE_COLUMN_NAME;
+var init_mutations = __esm({
+  "src/kanban/mutations.ts"() {
+    "use strict";
+    ARCHIVE_COLUMN_NAME = "archive";
+  }
+});
 
 // src/sequence/parser.ts
 function isSequenceBlock(el) {
@@ -221,24 +240,14 @@ function isSequenceSection(el) {
 function isSequenceNote(el) {
   return "kind" in el && el.kind === "note";
 }
+var init_parser = __esm({
+  "src/sequence/parser.ts"() {
+    "use strict";
+  }
+});
 
 // src/sequence/renderer.ts
-var PARTICIPANT_GAP = 160;
-var PARTICIPANT_BOX_WIDTH = 120;
-var NOTE_MAX_W = 200;
-var NOTE_FOLD = 10;
-var NOTE_PAD_H = 8;
-var NOTE_GAP = 15;
-var NOTE_CHAR_W = 6;
-var NOTE_CHARS_PER_LINE = Math.floor(
-  (NOTE_MAX_W - NOTE_PAD_H * 2 - NOTE_FOLD) / NOTE_CHAR_W
-);
-var ACTIVATION_WIDTH = 10;
-var NOTE_LANE_MAX = PARTICIPANT_GAP - ACTIVATION_WIDTH - NOTE_GAP;
-var LABEL_CHAR_WIDTH = 7.5;
-var LABEL_MAX_CHARS = Math.floor(
-  (PARTICIPANT_BOX_WIDTH - 10) / LABEL_CHAR_WIDTH
-);
+import * as d3Selection from "d3-selection";
 function groupMessagesBySection(elements, messages) {
   const groups = [];
   let currentGroup = null;
@@ -279,6 +288,180 @@ function groupMessagesBySection(elements, messages) {
   }
   return groups;
 }
+function buildRenderSequence(messages) {
+  const steps = [];
+  const stack = [];
+  for (let mi = 0; mi < messages.length; mi++) {
+    const msg = messages[mi];
+    while (stack.length > 0) {
+      const top = stack[stack.length - 1];
+      if (top.to === msg.from) break;
+      stack.pop();
+      steps.push({
+        type: "return",
+        from: top.to,
+        to: top.from,
+        label: "",
+        messageIndex: top.messageIndex
+      });
+    }
+    steps.push({
+      type: "call",
+      from: msg.from,
+      to: msg.to,
+      label: msg.label,
+      messageIndex: mi,
+      ...msg.async ? { async: true } : {}
+    });
+    if (msg.async) {
+      continue;
+    }
+    if (msg.from === msg.to) {
+      steps.push({
+        type: "return",
+        from: msg.to,
+        to: msg.from,
+        label: "",
+        messageIndex: mi
+      });
+    } else {
+      stack.push({
+        from: msg.from,
+        to: msg.to,
+        messageIndex: mi
+      });
+    }
+  }
+  while (stack.length > 0) {
+    const top = stack.pop();
+    steps.push({
+      type: "return",
+      from: top.to,
+      to: top.from,
+      label: "",
+      messageIndex: top.messageIndex
+    });
+  }
+  return steps;
+}
+function computeActivations(steps) {
+  const activations = [];
+  const stacks = /* @__PURE__ */ new Map();
+  const getStack = (id) => {
+    if (!stacks.has(id)) stacks.set(id, []);
+    return stacks.get(id);
+  };
+  for (let i = 0; i < steps.length; i++) {
+    const step = steps[i];
+    if (step.type === "call") {
+      const s = getStack(step.to);
+      s.push(i);
+    } else {
+      const s = getStack(step.from);
+      if (s.length > 0) {
+        const startIdx = s.pop();
+        activations.push({
+          participantId: step.from,
+          startStep: startIdx,
+          endStep: i,
+          depth: s.length
+        });
+      }
+    }
+  }
+  return activations;
+}
+function applyPositionOverrides(participants) {
+  if (!participants.some((p) => p.position !== void 0)) return participants;
+  const total = participants.length;
+  const positioned = [];
+  const unpositioned = [];
+  for (const p of participants) {
+    if (p.position !== void 0) {
+      let idx = p.position < 0 ? total + p.position : p.position;
+      idx = Math.max(0, Math.min(total - 1, idx));
+      positioned.push({ participant: p, index: idx });
+    } else {
+      unpositioned.push(p);
+    }
+  }
+  positioned.sort((a, b) => a.index - b.index);
+  const result = new Array(total).fill(null);
+  const usedIndices = /* @__PURE__ */ new Set();
+  for (const { participant, index } of positioned) {
+    let idx = index;
+    if (usedIndices.has(idx)) {
+      for (let offset = 1; offset < total; offset++) {
+        if (idx + offset < total && !usedIndices.has(idx + offset)) {
+          idx = idx + offset;
+          break;
+        }
+        if (idx - offset >= 0 && !usedIndices.has(idx - offset)) {
+          idx = idx - offset;
+          break;
+        }
+      }
+    }
+    result[idx] = participant;
+    usedIndices.add(idx);
+  }
+  let uIdx = 0;
+  for (let i = 0; i < total; i++) {
+    if (result[i] === null) {
+      result[i] = unpositioned[uIdx++];
+    }
+  }
+  return result;
+}
+function applyGroupOrdering(participants, groups, messages = []) {
+  if (groups.length === 0) return participants;
+  const idToGroup = /* @__PURE__ */ new Map();
+  for (const group of groups) {
+    for (const id of group.participantIds) {
+      idToGroup.set(id, group);
+    }
+  }
+  const appearanceOrder = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const msg of messages) {
+    for (const id of [msg.from, msg.to]) {
+      if (!seen.has(id)) {
+        seen.add(id);
+        appearanceOrder.push(id);
+      }
+    }
+  }
+  for (const p of participants) {
+    if (!seen.has(p.id)) {
+      seen.add(p.id);
+      appearanceOrder.push(p.id);
+    }
+  }
+  const result = [];
+  const placed = /* @__PURE__ */ new Set();
+  const placedGroups = /* @__PURE__ */ new Set();
+  for (const id of appearanceOrder) {
+    if (placed.has(id)) continue;
+    const group = idToGroup.get(id);
+    if (group && !placedGroups.has(group)) {
+      placedGroups.add(group);
+      for (const gid of group.participantIds) {
+        const p = participants.find((pp) => pp.id === gid);
+        if (p && !placed.has(gid)) {
+          result.push(p);
+          placed.add(gid);
+        }
+      }
+    } else if (!group) {
+      const p = participants.find((pp) => pp.id === id);
+      if (p) {
+        result.push(p);
+        placed.add(id);
+      }
+    }
+  }
+  return result;
+}
 function buildNoteMessageMap(elements) {
   const map = /* @__PURE__ */ new Map();
   let lastMessageLine = -1;
@@ -305,33 +488,146 @@ function buildNoteMessageMap(elements) {
   walk(elements);
   return map;
 }
-function collectNoteLineNumbers(elements) {
-  const result = [];
-  const walk = (els) => {
-    for (const el of els) {
-      if (isSequenceNote(el)) {
-        result.push(el.lineNumber);
-      } else if (isSequenceBlock(el)) {
-        walk(el.children);
-        if (el.elseIfBranches) {
-          for (const branch of el.elseIfBranches) {
-            walk(branch.children);
+var PARTICIPANT_GAP, PARTICIPANT_BOX_WIDTH, NOTE_MAX_W, NOTE_FOLD, NOTE_PAD_H, NOTE_GAP, NOTE_CHAR_W, NOTE_CHARS_PER_LINE, ACTIVATION_WIDTH, NOTE_LANE_MAX, LABEL_CHAR_WIDTH, LABEL_MAX_CHARS;
+var init_renderer = __esm({
+  "src/sequence/renderer.ts"() {
+    "use strict";
+    init_parser();
+    PARTICIPANT_GAP = 160;
+    PARTICIPANT_BOX_WIDTH = 120;
+    NOTE_MAX_W = 200;
+    NOTE_FOLD = 10;
+    NOTE_PAD_H = 8;
+    NOTE_GAP = 15;
+    NOTE_CHAR_W = 6;
+    NOTE_CHARS_PER_LINE = Math.floor(
+      (NOTE_MAX_W - NOTE_PAD_H * 2 - NOTE_FOLD) / NOTE_CHAR_W
+    );
+    ACTIVATION_WIDTH = 10;
+    NOTE_LANE_MAX = PARTICIPANT_GAP - ACTIVATION_WIDTH - NOTE_GAP;
+    LABEL_CHAR_WIDTH = 7.5;
+    LABEL_MAX_CHARS = Math.floor(
+      (PARTICIPANT_BOX_WIDTH - 10) / LABEL_CHAR_WIDTH
+    );
+  }
+});
+
+// src/d3.ts
+import * as d3Scale from "d3-scale";
+import * as d3Selection2 from "d3-selection";
+import * as d3Shape from "d3-shape";
+import * as d3Array from "d3-array";
+import cloud from "d3-cloud";
+function orderArcNodes(links, order, groups) {
+  const nodeSet = /* @__PURE__ */ new Set();
+  for (const link of links) {
+    nodeSet.add(link.source);
+    nodeSet.add(link.target);
+  }
+  const allNodes = Array.from(nodeSet);
+  if (order === "name") {
+    return allNodes.slice().sort((a, b) => a.localeCompare(b));
+  }
+  if (order === "degree") {
+    const degree = /* @__PURE__ */ new Map();
+    for (const node of allNodes) degree.set(node, 0);
+    for (const link of links) {
+      degree.set(link.source, degree.get(link.source) + link.value);
+      degree.set(link.target, degree.get(link.target) + link.value);
+    }
+    return allNodes.slice().sort((a, b) => {
+      const diff = degree.get(b) - degree.get(a);
+      return diff !== 0 ? diff : a.localeCompare(b);
+    });
+  }
+  if (order === "group") {
+    if (groups.length > 0) {
+      const ordered = [];
+      const placed = /* @__PURE__ */ new Set();
+      for (const group of groups) {
+        for (const node of group.nodes) {
+          if (!placed.has(node)) {
+            ordered.push(node);
+            placed.add(node);
           }
         }
-        walk(el.elseChildren);
       }
+      for (const node of allNodes) {
+        if (!placed.has(node)) {
+          ordered.push(node);
+          placed.add(node);
+        }
+      }
+      return ordered;
     }
-  };
-  walk(elements);
-  return result;
+    const adj = /* @__PURE__ */ new Map();
+    for (const node of allNodes) adj.set(node, /* @__PURE__ */ new Set());
+    for (const link of links) {
+      adj.get(link.source).add(link.target);
+      adj.get(link.target).add(link.source);
+    }
+    const degree = /* @__PURE__ */ new Map();
+    for (const node of allNodes) degree.set(node, 0);
+    for (const link of links) {
+      degree.set(link.source, degree.get(link.source) + link.value);
+      degree.set(link.target, degree.get(link.target) + link.value);
+    }
+    const visited = /* @__PURE__ */ new Set();
+    const components = [];
+    const remaining = new Set(allNodes);
+    while (remaining.size > 0) {
+      let root = "";
+      let maxDeg = -1;
+      for (const node of remaining) {
+        if (degree.get(node) > maxDeg) {
+          maxDeg = degree.get(node);
+          root = node;
+        }
+      }
+      const component = [];
+      const queue = [root];
+      visited.add(root);
+      remaining.delete(root);
+      while (queue.length > 0) {
+        const curr = queue.shift();
+        component.push(curr);
+        for (const neighbor of adj.get(curr)) {
+          if (!visited.has(neighbor)) {
+            visited.add(neighbor);
+            remaining.delete(neighbor);
+            queue.push(neighbor);
+          }
+        }
+      }
+      components.push(component);
+    }
+    components.sort((a, b) => b.length - a.length);
+    return components.flat();
+  }
+  return allNodes;
 }
+var init_d3 = __esm({
+  "src/d3.ts"() {
+    "use strict";
+  }
+});
+
+// src/internal.ts
+init_chart();
+init_mutations();
+init_renderer();
+init_d3();
 export {
+  applyGroupOrdering,
+  applyPositionOverrides,
   buildNoteMessageMap,
-  collectNoteLineNumbers,
+  buildRenderSequence,
+  computeActivations,
   computeCardArchive,
   computeCardMove,
   groupMessagesBySection,
   isArchiveColumn,
+  orderArcNodes,
   parseDataRowValues
 };
 //# sourceMappingURL=internal.js.map