@diagrammo/dgmo 0.2.26 → 0.2.28

package/src/cli.ts

@@ -3,7 +3,7 @@ import { execSync } from 'node:child_process';
 import { resolve, basename, extname } from 'node:path';
 import { Resvg } from '@resvg/resvg-js';
 import { render } from './render';
-import { parseDgmo } from './dgmo-router';
+import { parseDgmo, DGMO_CHART_TYPE_MAP } from './dgmo-router';
 import { parseDgmoChartType } from './dgmo-router';
 import { formatDgmoError } from './diagnostics';
 import { getPalette } from './palettes/registry';
@@ -24,6 +24,38 @@ const PALETTES = [
 
 const THEMES = ['light', 'dark', 'transparent'] as const;
 
+const CHART_TYPE_DESCRIPTIONS: Record<string, string> = {
+  bar: 'Bar chart — categorical comparisons',
+  line: 'Line chart — trends over time',
+  'multi-line': 'Multi-line chart — multiple series trends',
+  area: 'Area chart — filled line chart',
+  pie: 'Pie chart — part-to-whole proportions',
+  doughnut: 'Doughnut chart — ring-style pie chart',
+  radar: 'Radar chart — multi-dimensional metrics',
+  'polar-area': 'Polar area chart — radial bar chart',
+  'bar-stacked': 'Stacked bar chart — multi-series categorical',
+  scatter: 'Scatter plot — 2D data points or bubble chart',
+  sankey: 'Sankey diagram — flow/allocation visualization',
+  chord: 'Chord diagram — circular flow relationships',
+  function: 'Function plot — mathematical expressions',
+  heatmap: 'Heatmap — matrix intensity visualization',
+  funnel: 'Funnel chart — conversion pipeline',
+  slope: 'Slope chart — change between two periods',
+  wordcloud: 'Word cloud — term frequency visualization',
+  arc: 'Arc diagram — network relationships',
+  timeline: 'Timeline — events, eras, and date ranges',
+  venn: 'Venn diagram — set overlaps',
+  quadrant: 'Quadrant chart — 2x2 positioning matrix',
+  sequence: 'Sequence diagram — message/interaction flows',
+  flowchart: 'Flowchart — decision trees and process flows',
+  class: 'Class diagram — UML class hierarchies',
+  er: 'ER diagram — database schemas and relationships',
+  org: 'Org chart — hierarchical tree structures',
+  kanban: 'Kanban board — task/workflow columns',
+  c4: 'C4 diagram — system architecture (context, container, component, deployment)',
+  'initiative-status': 'Initiative status — project roadmap with dependency tracking',
+};
+
 function printHelp(): void {
   console.log(`Usage: dgmo <input> [options]
        cat input.dgmo | dgmo [options]
@@ -42,6 +74,8 @@ Options:
   --c4-container <name> Container to drill into (with --c4-level components)
   --no-branding        Omit diagrammo.app branding from exports
   --copy               Copy URL to clipboard (only with -o url)
+  --json               Output structured JSON to stdout
+  --chart-types        List all supported chart types
   --help               Show this help
   --version            Show version`);
 }
@@ -62,6 +96,8 @@ function parseArgs(argv: string[]): {
   version: boolean;
   noBranding: boolean;
   copy: boolean;
+  json: boolean;
+  chartTypes: boolean;
   c4Level: 'context' | 'containers' | 'components' | 'deployment';
   c4System: string | undefined;
   c4Container: string | undefined;
@@ -75,6 +111,8 @@ function parseArgs(argv: string[]): {
     version: false,
     noBranding: false,
     copy: false,
+    json: false,
+    chartTypes: false,
     c4Level: 'context' as 'context' | 'containers' | 'components' | 'deployment',
     c4System: undefined as string | undefined,
     c4Container: undefined as string | undefined,
@@ -134,6 +172,12 @@ function parseArgs(argv: string[]): {
     } else if (arg === '--no-branding') {
       result.noBranding = true;
       i++;
+    } else if (arg === '--json') {
+      result.json = true;
+      i++;
+    } else if (arg === '--chart-types') {
+      result.chartTypes = true;
+      i++;
     } else if (arg === '--copy') {
       result.copy = true;
       i++;
@@ -220,6 +264,23 @@ async function main(): Promise<void> {
     return;
   }
 
+  if (opts.chartTypes) {
+    const types = Object.keys(DGMO_CHART_TYPE_MAP);
+    if (opts.json) {
+      const chartTypes = types.map((id) => ({
+        id,
+        description: CHART_TYPE_DESCRIPTIONS[id] ?? id,
+      }));
+      process.stdout.write(JSON.stringify({ chartTypes }, null, 2) + '\n');
+    } else {
+      for (const id of types) {
+        const desc = CHART_TYPE_DESCRIPTIONS[id];
+        console.log(desc ? `${id} — ${desc.split(' — ')[1]}` : id);
+      }
+    }
+    return;
+  }
+
   // Determine input source
   let content: string;
   let inputBasename: string | undefined;
@@ -249,6 +310,11 @@ async function main(): Promise<void> {
     noInput();
   }
 
+  // Strip any ANSI escape codes that may have leaked into input
+  // (e.g. from shell aliases like cat=bat with --color always)
+  // eslint-disable-next-line no-control-regex
+  content = content.replace(/\x1b\[[0-9;]*m/g, '');
+
   // Resolve org chart imports (tags: and import: directives)
   if (opts.input && parseDgmoChartType(content) === 'org') {
     const inputPath = resolve(opts.input);
@@ -272,14 +338,30 @@ async function main(): Promise<void> {
     process.exit(1);
   }
 
+  const chartType = parseDgmoChartType(content);
+
+  // Helper for JSON error output
+  function exitWithJsonError(error: string, line?: number): never {
+    if (opts.json) {
+      process.stdout.write(JSON.stringify({
+        success: false,
+        error,
+        ...(line != null ? { line } : {}),
+        ...(chartType ? { chartType } : {}),
+      }, null, 2) + '\n');
+    } else {
+      console.error(error);
+    }
+    process.exit(1);
+  }
+
   // URL output — encode DSL directly, no rendering needed
   if (format === 'url') {
     const result = encodeDiagramUrl(content);
     if (result.error) {
-      console.error(
+      exitWithJsonError(
         `Error: Diagram too large for URL sharing (${result.compressedSize} bytes, limit ${result.limit} bytes)`
       );
-      process.exit(1);
     }
 
     if (opts.copy) {
@@ -298,7 +380,15 @@ async function main(): Promise<void> {
       }
     }
 
-    process.stdout.write(result.url + '\n');
+    if (opts.json) {
+      process.stdout.write(JSON.stringify({
+        success: true,
+        url: result.url,
+        ...(chartType ? { chartType } : {}),
+      }, null, 2) + '\n');
+    } else {
+      process.stdout.write(result.url + '\n');
+    }
     return;
   }
 
@@ -308,10 +398,9 @@ async function main(): Promise<void> {
   // which are unavailable in Node.js — check before attempting render.
   const wordcloudRe = /^\s*chart\s*:\s*wordcloud\b/im;
   if (wordcloudRe.test(content)) {
-    console.error(
+    exitWithJsonError(
       'Error: Word clouds are not supported in the CLI (requires Canvas). Use the desktop app or browser instead.'
     );
-    process.exit(1);
   }
 
   // Parse first to collect diagnostics
@@ -320,28 +409,36 @@ async function main(): Promise<void> {
   const warnings = diagnostics.filter((d) => d.severity === 'warning');
 
   // Print warnings even if rendering succeeds
-  for (const w of warnings) {
-    console.error(`\u26A0 ${formatDgmoError(w)}`);
+  if (!opts.json) {
+    for (const w of warnings) {
+      console.error(`\u26A0 ${formatDgmoError(w)}`);
+    }
   }
 
-  // Print errors
-  for (const e of errors) {
-    console.error(`\u2716 ${formatDgmoError(e)}`);
+  // Print errors and exit
+  if (errors.length > 0) {
+    if (opts.json) {
+      const firstError = errors[0];
+      exitWithJsonError(
+        formatDgmoError(firstError),
+        firstError.line,
+      );
+    }
+    for (const e of errors) {
+      console.error(`\u2716 ${formatDgmoError(e)}`);
+    }
   }
 
   // Validate C4 options
   if (opts.c4Level === 'containers' && !opts.c4System) {
-    console.error('Error: --c4-system is required when --c4-level is containers');
-    process.exit(1);
+    exitWithJsonError('Error: --c4-system is required when --c4-level is containers');
   }
   if (opts.c4Level === 'components') {
     if (!opts.c4System) {
-      console.error('Error: --c4-system is required when --c4-level is components');
-      process.exit(1);
+      exitWithJsonError('Error: --c4-system is required when --c4-level is components');
     }
     if (!opts.c4Container) {
-      console.error('Error: --c4-container is required when --c4-level is components');
-      process.exit(1);
+      exitWithJsonError('Error: --c4-container is required when --c4-level is components');
     }
   }
 
@@ -356,7 +453,7 @@ async function main(): Promise<void> {
 
   if (!svg) {
     if (errors.length === 0) {
-      console.error(
+      exitWithJsonError(
         'Error: Failed to render diagram. The input may be empty, invalid, or use an unsupported chart type.'
       );
     }
@@ -366,7 +463,26 @@ async function main(): Promise<void> {
   // Determine output destination
   const pngBg = opts.theme === 'transparent' ? undefined : paletteColors.bg;
 
-  if (opts.output) {
+  if (opts.json) {
+    // JSON mode: write file as normal but output JSON result to stdout
+    let outputPath: string | undefined;
+    if (opts.output) {
+      outputPath = resolve(opts.output);
+      if (format === 'svg') {
+        writeFileSync(outputPath, svg, 'utf-8');
+      } else {
+        writeFileSync(outputPath, svgToPng(svg, pngBg));
+      }
+    } else if (inputBasename) {
+      outputPath = resolve(`${inputBasename}.png`);
+      writeFileSync(outputPath, svgToPng(svg, pngBg));
+    }
+    process.stdout.write(JSON.stringify({
+      success: true,
+      ...(outputPath ? { output: outputPath } : {}),
+      ...(chartType ? { chartType } : {}),
+    }, null, 2) + '\n');
+  } else if (opts.output) {
     // Explicit output path
     const outputPath = resolve(opts.output);
     if (format === 'svg') {

package/src/d3.ts

@@ -350,7 +350,7 @@ export function parseD3(content: string, palette?: PaletteColors): ParsedD3 {
     }
 
     // Skip comments
-    if (line.startsWith('#') || line.startsWith('//')) {
+    if (line.startsWith('//')) {
       continue;
     }
 

package/src/dgmo-mermaid.ts

@@ -82,7 +82,7 @@ export function parseQuadrant(content: string): ParsedQuadrant {
     const lineNumber = i + 1; // 1-indexed for editor
 
     // Skip empty lines and comments
-    if (!line || line.startsWith('#') || line.startsWith('//')) continue;
+    if (!line || line.startsWith('//')) continue;
 
     // Skip the chart: directive (already consumed by router)
     if (/^chart\s*:/i.test(line)) continue;

package/src/dgmo-router.ts

@@ -81,7 +81,7 @@ export function parseDgmoChartType(content: string): string | null {
   for (const line of lines) {
     const trimmed = line.trim();
     // Skip empty lines and comments
-    if (!trimmed || trimmed.startsWith('#') || trimmed.startsWith('//'))
+    if (!trimmed || trimmed.startsWith('//'))
       continue;
     const match = trimmed.match(/^chart\s*:\s*(.+)/i);
     if (match) return match[1].trim().toLowerCase();

package/src/echarts.ts

@@ -75,7 +75,7 @@ export interface ParsedEChart {
   showLabels?: boolean;
   categoryColors?: Record<string, string>;
   diagnostics: DgmoError[];
-  error?: string;
+  error: string | null;
 }
 
 // ============================================================
@@ -116,6 +116,7 @@ export function parseEChart(
     type: 'scatter',
     data: [],
     diagnostics: [],
+    error: null,
   };
 
   // Track current category for grouped scatter charts
@@ -144,7 +145,7 @@ export function parseEChart(
     }
 
     // Skip comments
-    if (trimmed.startsWith('#') || trimmed.startsWith('//')) continue;
+    if (trimmed.startsWith('//')) continue;
 
     // Check for category header: [Category Name]
     const categoryMatch = trimmed.match(/^\[(.+)\]$/);
@@ -964,7 +965,7 @@ function buildScatterOption(
       },
     }),
     grid: {
-      left: parsed.ylabel ? '5%' : '3%',
+      left: parsed.ylabel ? '12%' : '3%',
       right: '4%',
       bottom: hasCategories ? '15%' : parsed.xlabel ? '10%' : '3%',
       top: parsed.title ? '15%' : '5%',
@@ -1289,18 +1290,29 @@ function makeGridAxis(
   splitLineColor: string,
   gridOpacity: number,
   label?: string,
-  data?: string[]
+  data?: string[],
+  nameGapOverride?: number
 ): Record<string, unknown> {
+  const defaultGap = type === 'value' ? 75 : 40;
   return {
     type,
     ...(data && { data }),
     axisLine: { lineStyle: { color: axisLineColor } },
-    axisLabel: { color: textColor, fontSize: 16, fontFamily: FONT_FAMILY },
+    axisLabel: {
+      color: textColor,
+      fontSize: type === 'category' && data ? (data.length > 10 ? 11 : data.length > 5 ? 12 : 16) : 16,
+      fontFamily: FONT_FAMILY,
+      ...(type === 'category' && {
+        interval: 0,
+        formatter: (value: string) =>
+          value.replace(/([a-z])([A-Z])/g, '$1\n$2').replace(/ /g, '\n'),
+      }),
+    },
     splitLine: { lineStyle: { color: splitLineColor, opacity: gridOpacity } },
     ...(label && {
       name: label,
       nameLocation: 'middle',
-      nameGap: 40,
+      nameGap: nameGapOverride ?? defaultGap,
       nameTextStyle: { color: textColor, fontSize: 18, fontFamily: FONT_FAMILY },
     }),
   };
@@ -1385,7 +1397,12 @@ function buildBarOption(
     itemStyle: { color: d.color ?? colors[i % colors.length] },
   }));
 
-  const categoryAxis = makeGridAxis('category', textColor, axisLineColor, splitLineColor, gridOpacity, isHorizontal ? yLabel : xLabel, labels);
+  // When category labels are on the y-axis (horizontal bars), they can be wide —
+  // compute a nameGap that clears the longest label so the ylabel doesn't overlap.
+  const hCatGap = isHorizontal && yLabel
+    ? Math.max(40, Math.max(...labels.map((l) => l.length)) * 8 + 16)
+    : undefined;
+  const categoryAxis = makeGridAxis('category', textColor, axisLineColor, splitLineColor, gridOpacity, isHorizontal ? yLabel : xLabel, labels, hCatGap);
   const valueAxis = makeGridAxis('value', textColor, axisLineColor, splitLineColor, gridOpacity, isHorizontal ? xLabel : yLabel);
 
   // xAxis is always the bottom axis, yAxis is always the left axis in ECharts
@@ -1400,7 +1417,7 @@ function buildBarOption(
       axisPointer: { type: 'shadow' },
     },
     grid: {
-      left: yLabel ? '5%' : '3%',
+      left: yLabel ? '12%' : '3%',
       right: '4%',
       bottom: xLabel ? '10%' : '3%',
       top: parsed.title ? '15%' : '5%',
@@ -1448,7 +1465,7 @@ function buildLineOption(
       axisPointer: { type: 'line' },
     },
     grid: {
-      left: yLabel ? '5%' : '3%',
+      left: yLabel ? '12%' : '3%',
       right: '4%',
       bottom: xLabel ? '10%' : '3%',
       top: parsed.title ? '15%' : '5%',
@@ -1524,7 +1541,7 @@ function buildMultiLineOption(
       textStyle: { color: textColor },
     },
     grid: {
-      left: yLabel ? '5%' : '3%',
+      left: yLabel ? '12%' : '3%',
       right: '4%',
       bottom: '15%',
       top: parsed.title ? '15%' : '5%',
@@ -1563,7 +1580,7 @@ function buildAreaOption(
       axisPointer: { type: 'line' },
     },
     grid: {
-      left: yLabel ? '5%' : '3%',
+      left: yLabel ? '12%' : '3%',
       right: '4%',
       bottom: xLabel ? '10%' : '3%',
       top: parsed.title ? '15%' : '5%',
@@ -1807,7 +1824,10 @@ function buildBarStackedOption(
     };
   });
 
-  const categoryAxis = makeGridAxis('category', textColor, axisLineColor, splitLineColor, gridOpacity, isHorizontal ? yLabel : xLabel, labels);
+  const hCatGap = isHorizontal && yLabel
+    ? Math.max(40, Math.max(...labels.map((l) => l.length)) * 8 + 16)
+    : undefined;
+  const categoryAxis = makeGridAxis('category', textColor, axisLineColor, splitLineColor, gridOpacity, isHorizontal ? yLabel : xLabel, labels, hCatGap);
   const valueAxis = makeGridAxis('value', textColor, axisLineColor, splitLineColor, gridOpacity, isHorizontal ? xLabel : yLabel);
 
   return {
@@ -1825,7 +1845,7 @@ function buildBarStackedOption(
       textStyle: { color: textColor },
     },
     grid: {
-      left: yLabel ? '5%' : '3%',
+      left: yLabel ? '12%' : '3%',
       right: '4%',
       bottom: '15%',
       top: parsed.title ? '15%' : '5%',

package/src/er/parser.ts

@@ -1,6 +1,7 @@
 import { resolveColor } from '../colors';
 import type { PaletteColors } from '../palettes';
 import { makeDgmoError, formatDgmoError, suggest } from '../diagnostics';
+import { measureIndent } from '../utils/parsing';
 import type {
   ParsedERDiagram,
   ERTable,
@@ -13,16 +14,6 @@ import type {
 // Helpers
 // ============================================================
 
-function measureIndent(line: string): number {
-  let indent = 0;
-  for (const ch of line) {
-    if (ch === ' ') indent++;
-    else if (ch === '\t') indent += 4;
-    else break;
-  }
-  return indent;
-}
-
 function tableId(name: string): string {
   return name.toLowerCase().trim();
 }
@@ -50,42 +41,39 @@ const CONSTRAINT_MAP: Record<string, ERConstraint> = {
 // Cardinality parsing
 // ============================================================
 
-// Cardinality keyword map
-const CARD_WORD: Record<string, ERCardinality> = {
-  one: '1',
-  many: '*',
-  '1': '1',
-  '*': '*',
-  '?': '?',
-  zero: '?',
-};
-
 /**
- * Parse a cardinality side token (e.g. "1", "*", "?", "one", "many", "zero").
+ * Parse a cardinality side token (symbolic only: "1", "*", "?").
  */
 function parseCardSide(token: string): ERCardinality | null {
-  return CARD_WORD[token.toLowerCase()] ?? null;
+  if (token === '1' || token === '*' || token === '?') return token;
+  return null;
 }
 
 /**
- * Try to parse a relationship line with cardinality.
+ * Try to parse a relationship line with symbolic cardinality.
  *
- * Supported forms:
+ * Supported form:
  *   tableName 1--* tableName : label
  *   tableName 1-* tableName : label
- *   tableName one-to-many tableName : label
- *   tableName one to many tableName : label
- *   tableName 1 to many tableName : label
  *   tableName ?--1 tableName : label
  */
 const REL_SYMBOLIC_RE =
   /^([a-zA-Z_]\w*)\s+([1*?])\s*-{1,2}\s*([1*?])\s+([a-zA-Z_]\w*)(?:\s*:\s*(.+))?$/;
 
+/** Detects keyword cardinality forms to emit helpful error */
 const REL_KEYWORD_RE =
-  /^([a-zA-Z_]\w*)\s+(one|many|zero|1|\*|\?)[- ]to[- ](one|many|zero|1|\*|\?)\s+([a-zA-Z_]\w*)(?:\s*:\s*(.+))?$/i;
+  /^([a-zA-Z_]\w*)\s+(one|many|zero)[- ]to[- ](one|many|zero)\s+([a-zA-Z_]\w*)(?:\s*:\s*(.+))?$/i;
+
+const KEYWORD_TO_SYMBOL: Record<string, string> = {
+  one: '1',
+  many: '*',
+  zero: '?',
+};
 
 function parseRelationship(
-  trimmed: string
+  trimmed: string,
+  lineNumber: number,
+  pushError: (line: number, message: string) => void,
 ): {
   source: string;
   target: string;
@@ -109,20 +97,16 @@ function parseRelationship(
     }
   }
 
-  // Keyword / natural: one-to-many, one to many, 1 to many, etc.
+  // Keyword / natural: produce helpful error with symbolic suggestion
   const kw = trimmed.match(REL_KEYWORD_RE);
   if (kw) {
-    const fromCard = parseCardSide(kw[2]);
-    const toCard = parseCardSide(kw[3]);
-    if (fromCard && toCard) {
-      return {
-        source: kw[1],
-        target: kw[4],
-        from: fromCard,
-        to: toCard,
-        label: kw[5]?.trim(),
-      };
-    }
+    const fromSym = KEYWORD_TO_SYMBOL[kw[2].toLowerCase()] ?? kw[2];
+    const toSym = KEYWORD_TO_SYMBOL[kw[3].toLowerCase()] ?? kw[3];
+    pushError(
+      lineNumber,
+      `Use symbolic cardinality (1--*, ?--1, *--*) instead of "${kw[2]}-to-${kw[3]}". Example: ${kw[1]} ${fromSym}--${toSym} ${kw[4]}`,
+    );
+    return null;
   }
 
   return null;
@@ -157,6 +141,7 @@ export function parseERDiagram(
     tables: [],
     relationships: [],
     diagnostics: [],
+    error: null,
   };
 
   const fail = (line: number, message: string): ParsedERDiagram => {
@@ -166,6 +151,12 @@ export function parseERDiagram(
     return result;
   };
 
+  const pushError = (line: number, message: string): void => {
+    const diag = makeDgmoError(line, message);
+    result.diagnostics.push(diag);
+    if (!result.error) result.error = formatDgmoError(diag);
+  };
+
   const tableMap = new Map<string, ERTable>();
   let currentTable: ERTable | null = null;
   let contentStarted = false;
@@ -257,7 +248,7 @@ export function parseERDiagram(
     contentStarted = true;
 
     // Try relationship
-    const rel = parseRelationship(trimmed);
+    const rel = parseRelationship(trimmed, lineNumber, pushError);
     if (rel) {
       getOrCreateTable(rel.source, lineNumber);
       getOrCreateTable(rel.target, lineNumber);
@@ -347,7 +338,7 @@ export function looksLikeERDiagram(content: string): boolean {
         hasTableDecl = true;
       }
       // Check for relationship patterns
-      if (REL_SYMBOLIC_RE.test(trimmed) || REL_KEYWORD_RE.test(trimmed)) {
+      if (REL_SYMBOLIC_RE.test(trimmed)) {
         hasRelationship = true;
       }
     }

package/src/er/types.ts

@@ -39,5 +39,5 @@ export interface ParsedERDiagram {
   tables: ERTable[];
   relationships: ERRelationship[];
   diagnostics: DgmoError[];
-  error?: string;
+  error: string | null;
 }

package/src/graph/flowchart-parser.ts

@@ -1,6 +1,7 @@
 import { resolveColor } from '../colors';
 import type { PaletteColors } from '../palettes';
 import { makeDgmoError, formatDgmoError, suggest } from '../diagnostics';
+import { measureIndent, extractColor } from '../utils/parsing';
 import type {
   ParsedGraph,
   GraphNode,
@@ -14,16 +15,6 @@ import type {
 // Helpers
 // ============================================================
 
-function measureIndent(line: string): number {
-  let indent = 0;
-  for (const ch of line) {
-    if (ch === ' ') indent++;
-    else if (ch === '\t') indent += 4;
-    else break;
-  }
-  return indent;
-}
-
 function nodeId(shape: GraphShape, label: string): string {
   return `${shape}:${label.toLowerCase().trim()}`;
 }
@@ -35,21 +26,6 @@ interface NodeRef {
   color?: string;
 }
 
-const COLOR_SUFFIX_RE = /\(([^)]+)\)\s*$/;
-
-function extractColor(
-  label: string,
-  palette?: PaletteColors
-): { label: string; color?: string } {
-  const m = label.match(COLOR_SUFFIX_RE);
-  if (!m) return { label };
-  const colorName = m[1].trim();
-  return {
-    label: label.substring(0, m.index!).trim(),
-    color: resolveColor(colorName, palette),
-  };
-}
-
 /**
  * Try to parse a node reference from a text fragment.
  * Order matters: subroutine & document before process.
@@ -239,6 +215,7 @@ export function parseFlowchart(
     edges: [],
     options: {},
     diagnostics: [],
+    error: null,
   };
 
   const fail = (line: number, message: string): ParsedGraph => {

package/src/graph/types.ts

@@ -45,5 +45,5 @@ export interface ParsedGraph {
   groups?: GraphGroup[];
   options: Record<string, string>;
   diagnostics: DgmoError[];
-  error?: string;
+  error: string | null;
 }

package/src/index.ts

@@ -126,6 +126,11 @@ export type {
   GraphDirection,
 } from './graph/types';
 
+export type { TagGroup, TagEntry } from './utils/tag-groups';
+
+export { parseInlineMarkdown, truncateBareUrl } from './utils/inline-markdown';
+export type { InlineSpan } from './utils/inline-markdown';
+
 export { parseOrg } from './org/parser';
 export type {
   ParsedOrg,