@diagrammo/dgmo 0.2.6 → 0.2.8

package/dist/index.d.cts

@@ -515,12 +515,17 @@ interface SequenceMessage {
 /**
  * A conditional or loop block in the sequence diagram.
  */
+interface ElseIfBranch {
+    label: string;
+    children: SequenceElement[];
+}
 interface SequenceBlock {
     kind: 'block';
     type: 'if' | 'loop' | 'parallel';
     label: string;
     children: SequenceElement[];
     elseChildren: SequenceElement[];
+    elseIfBranches?: ElseIfBranch[];
     lineNumber: number;
 }
 /**
@@ -532,8 +537,20 @@ interface SequenceSection {
     color?: string;
     lineNumber: number;
 }
-type SequenceElement = SequenceMessage | SequenceBlock | SequenceSection;
+/**
+ * An annotation attached to a message, rendered as a folded-corner box.
+ */
+interface SequenceNote {
+    kind: 'note';
+    text: string;
+    position: 'right' | 'left';
+    participantId: string;
+    lineNumber: number;
+    endLineNumber: number;
+}
+type SequenceElement = SequenceMessage | SequenceBlock | SequenceSection | SequenceNote;
 declare function isSequenceBlock(el: SequenceElement): el is SequenceBlock;
+declare function isSequenceNote(el: SequenceElement): el is SequenceNote;
 /**
  * A named group of participants rendered as a labeled box.
  */
@@ -617,6 +634,95 @@ declare function buildMermaidQuadrant(parsed: ParsedQuadrant, options?: {
     mutedTextColor?: string;
 }): string;
 
+type GraphShape = 'terminal' | 'process' | 'decision' | 'io' | 'subroutine' | 'document';
+type GraphDirection = 'TB' | 'LR';
+interface GraphNode {
+    id: string;
+    label: string;
+    shape: GraphShape;
+    color?: string;
+    group?: string;
+    lineNumber: number;
+}
+interface GraphEdge {
+    source: string;
+    target: string;
+    label?: string;
+    color?: string;
+    lineNumber: number;
+}
+interface GraphGroup {
+    id: string;
+    label: string;
+    color?: string;
+    nodeIds: string[];
+    lineNumber: number;
+}
+interface ParsedGraph {
+    type: 'flowchart';
+    title?: string;
+    direction: GraphDirection;
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    groups?: GraphGroup[];
+    error?: string;
+}
+
+declare function parseFlowchart(content: string, palette?: PaletteColors): ParsedGraph;
+/**
+ * Detect if content looks like a flowchart (without explicit `chart: flowchart` header).
+ * Checks for shape delimiters combined with `->` arrows.
+ * Avoids false-positives on sequence diagrams (which use bare names with `->`)
+ */
+declare function looksLikeFlowchart(content: string): boolean;
+
+interface LayoutNode {
+    id: string;
+    label: string;
+    shape: GraphShape;
+    color?: string;
+    group?: string;
+    lineNumber: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface LayoutEdge {
+    source: string;
+    target: string;
+    points: {
+        x: number;
+        y: number;
+    }[];
+    label?: string;
+    color?: string;
+    lineNumber: number;
+}
+interface LayoutGroup {
+    id: string;
+    label: string;
+    color?: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface LayoutResult {
+    nodes: LayoutNode[];
+    edges: LayoutEdge[];
+    groups: LayoutGroup[];
+    width: number;
+    height: number;
+}
+declare function layoutGraph(graph: ParsedGraph): LayoutResult;
+
+declare function renderFlowchart(container: HTMLDivElement, graph: ParsedGraph, layout: LayoutResult, palette: PaletteColors, isDark: boolean, onClickItem?: (lineNumber: number) => void, exportDims?: {
+    width?: number;
+    height?: number;
+}): void;
+declare function renderFlowchartForExport(content: string, theme: 'light' | 'dark' | 'transparent', palette: PaletteColors): string;
+
 interface SectionMessageGroup {
     section: SequenceSection;
     messageIndices: number[];
@@ -705,4 +811,4 @@ declare function resolveColor(color: string, palette?: {
 /** @deprecated Use getSeriesColors(palette) from '@/lib/palettes' instead. */
 declare const seriesColors: string[];
 
-export { type Activation, type ArcLink, type ArcNodeGroup, type ChartDataPoint, type ChartType, type D3ChartType, type D3ExportDimensions, DGMO_CHART_TYPE_MAP, type DgmoFramework, type EChartsChartType, type PaletteColors, type PaletteConfig, type ParsedChart, type ParsedD3, type ParsedEChart, type ParsedQuadrant, type ParsedSequenceDgmo, type ParticipantType, RULE_COUNT, type RenderStep, type SectionMessageGroup, type SequenceBlock, type SequenceElement, type SequenceGroup, type SequenceMessage, type SequenceParticipant, type SequenceRenderOptions, type SequenceSection, addDurationToDate, applyGroupOrdering, applyPositionOverrides, boldPalette, buildEChartsOption, buildEChartsOptionFromChart, buildMermaidQuadrant, buildMermaidThemeVars, buildRenderSequence, buildThemeCSS, catppuccinPalette, colorNames, computeActivations, computeTimeTicks, contrastText, formatDateLabel, getAvailablePalettes, getDgmoFramework, getPalette, getSeriesColors, groupMessagesBySection, gruvboxPalette, hexToHSL, hexToHSLString, hslToHex, inferParticipantType, isSequenceBlock, isValidHex, looksLikeSequence, mute, nord, nordPalette, oneDarkPalette, orderArcNodes, parseChart, parseD3, parseDgmoChartType, parseEChart, parseQuadrant, parseSequenceDgmo, parseTimelineDate, registerPalette, renderArcDiagram, renderD3ForExport, renderEChartsForExport, renderQuadrant, renderSequenceDiagram, renderSlopeChart, renderTimeline, renderVenn, renderWordCloud, resolveColor, rosePinePalette, seriesColors, shade, solarizedPalette, tint, tokyoNightPalette };
+export { type Activation, type ArcLink, type ArcNodeGroup, type ChartDataPoint, type ChartType, type D3ChartType, type D3ExportDimensions, DGMO_CHART_TYPE_MAP, type DgmoFramework, type EChartsChartType, type ElseIfBranch, type GraphDirection, type GraphEdge, type GraphGroup, type GraphNode, type GraphShape, type LayoutEdge, type LayoutGroup, type LayoutNode, type LayoutResult, type PaletteColors, type PaletteConfig, type ParsedChart, type ParsedD3, type ParsedEChart, type ParsedGraph, type ParsedQuadrant, type ParsedSequenceDgmo, type ParticipantType, RULE_COUNT, type RenderStep, type SectionMessageGroup, type SequenceBlock, type SequenceElement, type SequenceGroup, type SequenceMessage, type SequenceNote, type SequenceParticipant, type SequenceRenderOptions, type SequenceSection, addDurationToDate, applyGroupOrdering, applyPositionOverrides, boldPalette, buildEChartsOption, buildEChartsOptionFromChart, buildMermaidQuadrant, buildMermaidThemeVars, buildRenderSequence, buildThemeCSS, catppuccinPalette, colorNames, computeActivations, computeTimeTicks, contrastText, formatDateLabel, getAvailablePalettes, getDgmoFramework, getPalette, getSeriesColors, groupMessagesBySection, gruvboxPalette, hexToHSL, hexToHSLString, hslToHex, inferParticipantType, isSequenceBlock, isSequenceNote, isValidHex, layoutGraph, looksLikeFlowchart, looksLikeSequence, mute, nord, nordPalette, oneDarkPalette, orderArcNodes, parseChart, parseD3, parseDgmoChartType, parseEChart, parseFlowchart, parseQuadrant, parseSequenceDgmo, parseTimelineDate, registerPalette, renderArcDiagram, renderD3ForExport, renderEChartsForExport, renderFlowchart, renderFlowchartForExport, renderQuadrant, renderSequenceDiagram, renderSlopeChart, renderTimeline, renderVenn, renderWordCloud, resolveColor, rosePinePalette, seriesColors, shade, solarizedPalette, tint, tokyoNightPalette };

package/dist/index.d.ts

@@ -515,12 +515,17 @@ interface SequenceMessage {
 /**
  * A conditional or loop block in the sequence diagram.
  */
+interface ElseIfBranch {
+    label: string;
+    children: SequenceElement[];
+}
 interface SequenceBlock {
     kind: 'block';
     type: 'if' | 'loop' | 'parallel';
     label: string;
     children: SequenceElement[];
     elseChildren: SequenceElement[];
+    elseIfBranches?: ElseIfBranch[];
     lineNumber: number;
 }
 /**
@@ -532,8 +537,20 @@ interface SequenceSection {
     color?: string;
     lineNumber: number;
 }
-type SequenceElement = SequenceMessage | SequenceBlock | SequenceSection;
+/**
+ * An annotation attached to a message, rendered as a folded-corner box.
+ */
+interface SequenceNote {
+    kind: 'note';
+    text: string;
+    position: 'right' | 'left';
+    participantId: string;
+    lineNumber: number;
+    endLineNumber: number;
+}
+type SequenceElement = SequenceMessage | SequenceBlock | SequenceSection | SequenceNote;
 declare function isSequenceBlock(el: SequenceElement): el is SequenceBlock;
+declare function isSequenceNote(el: SequenceElement): el is SequenceNote;
 /**
  * A named group of participants rendered as a labeled box.
  */
@@ -617,6 +634,95 @@ declare function buildMermaidQuadrant(parsed: ParsedQuadrant, options?: {
     mutedTextColor?: string;
 }): string;
 
+type GraphShape = 'terminal' | 'process' | 'decision' | 'io' | 'subroutine' | 'document';
+type GraphDirection = 'TB' | 'LR';
+interface GraphNode {
+    id: string;
+    label: string;
+    shape: GraphShape;
+    color?: string;
+    group?: string;
+    lineNumber: number;
+}
+interface GraphEdge {
+    source: string;
+    target: string;
+    label?: string;
+    color?: string;
+    lineNumber: number;
+}
+interface GraphGroup {
+    id: string;
+    label: string;
+    color?: string;
+    nodeIds: string[];
+    lineNumber: number;
+}
+interface ParsedGraph {
+    type: 'flowchart';
+    title?: string;
+    direction: GraphDirection;
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    groups?: GraphGroup[];
+    error?: string;
+}
+
+declare function parseFlowchart(content: string, palette?: PaletteColors): ParsedGraph;
+/**
+ * Detect if content looks like a flowchart (without explicit `chart: flowchart` header).
+ * Checks for shape delimiters combined with `->` arrows.
+ * Avoids false-positives on sequence diagrams (which use bare names with `->`)
+ */
+declare function looksLikeFlowchart(content: string): boolean;
+
+interface LayoutNode {
+    id: string;
+    label: string;
+    shape: GraphShape;
+    color?: string;
+    group?: string;
+    lineNumber: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface LayoutEdge {
+    source: string;
+    target: string;
+    points: {
+        x: number;
+        y: number;
+    }[];
+    label?: string;
+    color?: string;
+    lineNumber: number;
+}
+interface LayoutGroup {
+    id: string;
+    label: string;
+    color?: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface LayoutResult {
+    nodes: LayoutNode[];
+    edges: LayoutEdge[];
+    groups: LayoutGroup[];
+    width: number;
+    height: number;
+}
+declare function layoutGraph(graph: ParsedGraph): LayoutResult;
+
+declare function renderFlowchart(container: HTMLDivElement, graph: ParsedGraph, layout: LayoutResult, palette: PaletteColors, isDark: boolean, onClickItem?: (lineNumber: number) => void, exportDims?: {
+    width?: number;
+    height?: number;
+}): void;
+declare function renderFlowchartForExport(content: string, theme: 'light' | 'dark' | 'transparent', palette: PaletteColors): string;
+
 interface SectionMessageGroup {
     section: SequenceSection;
     messageIndices: number[];
@@ -705,4 +811,4 @@ declare function resolveColor(color: string, palette?: {
 /** @deprecated Use getSeriesColors(palette) from '@/lib/palettes' instead. */
 declare const seriesColors: string[];
 
-export { type Activation, type ArcLink, type ArcNodeGroup, type ChartDataPoint, type ChartType, type D3ChartType, type D3ExportDimensions, DGMO_CHART_TYPE_MAP, type DgmoFramework, type EChartsChartType, type PaletteColors, type PaletteConfig, type ParsedChart, type ParsedD3, type ParsedEChart, type ParsedQuadrant, type ParsedSequenceDgmo, type ParticipantType, RULE_COUNT, type RenderStep, type SectionMessageGroup, type SequenceBlock, type SequenceElement, type SequenceGroup, type SequenceMessage, type SequenceParticipant, type SequenceRenderOptions, type SequenceSection, addDurationToDate, applyGroupOrdering, applyPositionOverrides, boldPalette, buildEChartsOption, buildEChartsOptionFromChart, buildMermaidQuadrant, buildMermaidThemeVars, buildRenderSequence, buildThemeCSS, catppuccinPalette, colorNames, computeActivations, computeTimeTicks, contrastText, formatDateLabel, getAvailablePalettes, getDgmoFramework, getPalette, getSeriesColors, groupMessagesBySection, gruvboxPalette, hexToHSL, hexToHSLString, hslToHex, inferParticipantType, isSequenceBlock, isValidHex, looksLikeSequence, mute, nord, nordPalette, oneDarkPalette, orderArcNodes, parseChart, parseD3, parseDgmoChartType, parseEChart, parseQuadrant, parseSequenceDgmo, parseTimelineDate, registerPalette, renderArcDiagram, renderD3ForExport, renderEChartsForExport, renderQuadrant, renderSequenceDiagram, renderSlopeChart, renderTimeline, renderVenn, renderWordCloud, resolveColor, rosePinePalette, seriesColors, shade, solarizedPalette, tint, tokyoNightPalette };
+export { type Activation, type ArcLink, type ArcNodeGroup, type ChartDataPoint, type ChartType, type D3ChartType, type D3ExportDimensions, DGMO_CHART_TYPE_MAP, type DgmoFramework, type EChartsChartType, type ElseIfBranch, type GraphDirection, type GraphEdge, type GraphGroup, type GraphNode, type GraphShape, type LayoutEdge, type LayoutGroup, type LayoutNode, type LayoutResult, type PaletteColors, type PaletteConfig, type ParsedChart, type ParsedD3, type ParsedEChart, type ParsedGraph, type ParsedQuadrant, type ParsedSequenceDgmo, type ParticipantType, RULE_COUNT, type RenderStep, type SectionMessageGroup, type SequenceBlock, type SequenceElement, type SequenceGroup, type SequenceMessage, type SequenceNote, type SequenceParticipant, type SequenceRenderOptions, type SequenceSection, addDurationToDate, applyGroupOrdering, applyPositionOverrides, boldPalette, buildEChartsOption, buildEChartsOptionFromChart, buildMermaidQuadrant, buildMermaidThemeVars, buildRenderSequence, buildThemeCSS, catppuccinPalette, colorNames, computeActivations, computeTimeTicks, contrastText, formatDateLabel, getAvailablePalettes, getDgmoFramework, getPalette, getSeriesColors, groupMessagesBySection, gruvboxPalette, hexToHSL, hexToHSLString, hslToHex, inferParticipantType, isSequenceBlock, isSequenceNote, isValidHex, layoutGraph, looksLikeFlowchart, looksLikeSequence, mute, nord, nordPalette, oneDarkPalette, orderArcNodes, parseChart, parseD3, parseDgmoChartType, parseEChart, parseFlowchart, parseQuadrant, parseSequenceDgmo, parseTimelineDate, registerPalette, renderArcDiagram, renderD3ForExport, renderEChartsForExport, renderFlowchart, renderFlowchartForExport, renderQuadrant, renderSequenceDiagram, renderSlopeChart, renderTimeline, renderVenn, renderWordCloud, resolveColor, rosePinePalette, seriesColors, shade, solarizedPalette, tint, tokyoNightPalette };