@diagrammo/dgmo 0.47.0 → 0.48.0

package/src/er/types.ts

@@ -1,52 +0,0 @@
-// ============================================================
-// ER Diagram Types
-// ============================================================
-
-export type ERConstraint = 'pk' | 'fk' | 'unique' | 'nullable';
-
-export type ERCardinality = '1' | '*' | '?';
-
-export interface ERColumn {
-  readonly name: string;
-  readonly type?: string;
-  readonly constraints: readonly ERConstraint[];
-  readonly lineNumber: number;
-}
-
-export interface ERTable {
-  readonly id: string;
-  readonly name: string;
-  readonly color?: string;
-  readonly columns: readonly ERColumn[];
-  readonly metadata: Readonly<Record<string, string>>;
-  readonly lineNumber: number;
-}
-
-export interface ERRelationship {
-  readonly source: string; // table id
-  readonly target: string; // table id
-  readonly cardinality: {
-    readonly from: ERCardinality;
-    readonly to: ERCardinality;
-  };
-  readonly label?: string;
-  readonly lineNumber: number;
-}
-
-import type { DgmoError } from '../diagnostics';
-import type { TagGroup } from '../utils/tag-groups';
-import type { DiagramNote } from '../utils/notes';
-
-export interface ParsedERDiagram {
-  readonly type: 'er';
-  readonly title?: string;
-  readonly titleLineNumber?: number;
-  readonly options: Readonly<Record<string, string>>;
-  readonly tables: readonly ERTable[];
-  readonly relationships: readonly ERRelationship[];
-  readonly tagGroups: readonly TagGroup[];
-  /** Generic node notes (`note <Table> …`); resolved in layout. */
-  readonly notes?: readonly DiagramNote[];
-  readonly diagnostics: readonly DgmoError[];
-  readonly error: string | null;
-}

package/src/error-card.ts

@@ -1,269 +0,0 @@
-// ============================================================
-// Error Card — fallback image rendered when a diagram can't parse
-// ============================================================
-//
-// When `render(text, { onError: 'svg' })` (the default) hits parse errors,
-// hosts that embed dgmo — remark/astro/docusaurus/fumadocs, Obsidian, the
-// web editor — show whatever SVG we return in place of the diagram. A blank
-// or cryptic box is a dead end for the author, so we render a friendly card:
-// a frown mark, the dgmo wordmark, and per-error the line number, the
-// message, and the actual offending source line with a caret at the column.
-//
-// Pure string builder — no DOM, so it works in every consumer (SSR, browser,
-// resvg→PNG in the CLI). resvg has no color-mix(); all colors are pre-resolved.
-
-import { truncateText, measureText } from './utils/text-measure';
-import { FONT_FAMILY } from './fonts';
-import { encodeDiagramUrl } from './sharing';
-import type { PaletteConfig } from './palettes/types';
-import type { Theme } from './themes';
-import type { DgmoError } from './diagnostics';
-
-const MONO_FAMILY =
-  "ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, monospace";
-
-const W = 660;
-const PAD = 24;
-const CONTENT_W = W - PAD * 2;
-const MAX_ERRORS = 4;
-// Monospace advance ≈ 0.6em — used to place the caret under the bad column.
-const MONO_CH = 0.6;
-const CODE_FS = 12.5;
-
-/**
- * Render a self-contained SVG error card for a failed diagram parse.
- *
- * @param errors  Error-severity diagnostics (line-numbered).
- * @param source  Original DGMO source, used to quote the offending lines.
- */
-export function renderErrorCard(
-  errors: DgmoError[],
-  source: string,
-  palette: PaletteConfig,
-  theme?: Theme
-): string {
-  const c = palette[theme === 'dark' ? 'dark' : 'light'];
-  const isTransparent = theme === 'transparent';
-  const card = c.surface;
-  const codeBg = c.bg;
-  const border = c.border;
-  const danger = c.destructive ?? c.colors.red;
-  const text = c.text;
-  const muted = c.textMuted;
-  const srcLines = source.split('\n');
-
-  const shown = errors.slice(0, MAX_ERRORS);
-  const overflow = errors.length - shown.length;
-
-  const parts: string[] = [];
-  let y = PAD + 8;
-
-  // ── Header: frown mark + title, dgmo wordmark right ────────
-  parts.push(frownMark(PAD + 14, y + 12, danger));
-  parts.push(
-    `<text x="${PAD + 38}" y="${y + 11}" fill="${text}" font-family="${FONT_FAMILY}" font-size="16" font-weight="700">Couldn't render this diagram</text>`,
-    `<text x="${W - PAD}" y="${y + 10}" text-anchor="end" fill="${muted}" font-family="${FONT_FAMILY}" font-size="12" font-weight="600" letter-spacing="0.5">dgmo</text>`
-  );
-  y += 24;
-  const errLabel = errors.length === 1 ? '1 error' : `${errors.length} errors`;
-  parts.push(
-    `<text x="${PAD + 38}" y="${y + 4}" fill="${muted}" font-family="${FONT_FAMILY}" font-size="12.5">${errLabel} — fix the lines below and re-render</text>`
-  );
-  y += 22;
-  parts.push(
-    `<line x1="${PAD}" y1="${y}" x2="${W - PAD}" y2="${y}" stroke="${border}" stroke-width="1"/>`
-  );
-  y += 24;
-
-  // ── Per-error blocks ───────────────────────────────────────
-  for (const e of shown) {
-    const hasLine = e.line > 0;
-
-    // Line badge (skip when line is unknown / 0), with the message inline.
-    let msgX = PAD;
-    if (hasLine) {
-      const label = e.column ? `Line ${e.line}:${e.column}` : `Line ${e.line}`;
-      const badgeW = 14 + label.length * 7;
-      parts.push(
-        `<rect x="${PAD}" y="${y - 13}" width="${badgeW}" height="19" rx="4" fill="${danger}"/>`,
-        `<text x="${PAD + badgeW / 2}" y="${y + 1}" text-anchor="middle" fill="${c.bg}" font-family="${FONT_FAMILY}" font-size="11.5" font-weight="700">${escapeXml(label)}</text>`
-      );
-      msgX = PAD + badgeW + 12;
-    }
-
-    // Message: first line sits to the right of the badge, continuation lines
-    // wrap to the full content width on the rows below.
-    const lines = wrapMessage(e.message, CONTENT_W - (msgX - PAD), CONTENT_W);
-    lines.forEach((line, i) => {
-      parts.push(
-        `<text x="${i === 0 ? msgX : PAD}" y="${y + 1}" fill="${text}" font-family="${FONT_FAMILY}" font-size="13">${escapeXml(line)}</text>`
-      );
-      if (i < lines.length - 1) y += 18;
-    });
-    y += 24;
-
-    // Offending source line with two lines of context above and below.
-    // The bad line gets a red highlight band; a caret marks the column.
-    if (hasLine) {
-      const CTX = 2;
-      const first = Math.max(1, e.line - CTX);
-      const last = Math.min(srcLines.length, e.line + CTX);
-      const rowH = 18;
-      const hasCaret = e.column !== undefined && e.column > 0;
-      // Gutter sized to the widest line number in the window.
-      const gutterW = `${last}`.length * CODE_FS * MONO_CH + 16;
-      const codeX = PAD + gutterW;
-      const codeMaxW = CONTENT_W - gutterW - 12;
-      const topY = y - 14;
-      const rowCount = last - first + 1;
-      const blockH = rowCount * rowH + (hasCaret ? 14 : 0) + 10;
-
-      const rowParts: string[] = [];
-      let ry = y + 3; // baseline of the topmost row
-      for (let n = first; n <= last; n++) {
-        const raw = (srcLines[n - 1] ?? '').replace(/\t/g, '  ');
-        const codeText = truncateText(raw, CODE_FS, codeMaxW);
-        const isBad = n === e.line;
-        if (isBad) {
-          // Red band behind the offending row (opacity keeps code readable).
-          rowParts.push(
-            `<rect x="${PAD + 1}" y="${ry - 13}" width="${CONTENT_W - 2}" height="${rowH}" fill="${danger}" fill-opacity="0.16"/>`
-          );
-        }
-        rowParts.push(
-          `<text x="${PAD + 8}" y="${ry + 1}" fill="${isBad ? danger : muted}" font-family="${MONO_FAMILY}" font-size="${CODE_FS}" font-weight="${isBad ? 700 : 400}">${escapeXml(`${n}`)}</text>`,
-          `<text x="${codeX}" y="${ry + 1}" fill="${text}" font-family="${MONO_FAMILY}" font-size="${CODE_FS}" xml:space="preserve">${escapeXml(codeText)}</text>`
-        );
-        if (isBad && hasCaret) {
-          const caretX = codeX + (e.column! - 1) * CODE_FS * MONO_CH;
-          rowParts.push(
-            `<text x="${caretX}" y="${ry + 15}" fill="${danger}" font-family="${MONO_FAMILY}" font-size="${CODE_FS}" font-weight="700">^</text>`
-          );
-          ry += 14; // reserve the caret's row before the next context line
-        }
-        ry += rowH;
-      }
-
-      parts.push(
-        `<rect x="${PAD}" y="${topY}" width="${CONTENT_W}" height="${blockH}" rx="5" fill="${codeBg}" stroke="${border}" stroke-width="1"/>`,
-        `<line x1="${codeX - 8}" y1="${topY}" x2="${codeX - 8}" y2="${topY + blockH}" stroke="${border}" stroke-width="1"/>`,
-        rowParts.join('')
-      );
-      y = topY + blockH + 10;
-    }
-
-    y += 14;
-  }
-
-  if (overflow > 0) {
-    parts.push(
-      `<text x="${PAD}" y="${y}" fill="${muted}" font-family="${FONT_FAMILY}" font-size="12.5" font-style="italic">+ ${overflow} more error${overflow === 1 ? '' : 's'}</text>`
-    );
-    y += 22;
-  }
-
-  // ── Footer: open-in-editor call to action ──────────────────
-  // A live fix path: the Diagrammo mark + a link that opens the online editor
-  // preloaded with THIS (broken) source, so the author can fix it and copy it
-  // back into their code fence. The <a> is clickable when the SVG is embedded
-  // inline (remark/astro/docusaurus/fumadocs, Obsidian, the web editor) and
-  // still renders as visible text in a rasterized PNG export (resvg keeps the
-  // anchor's children). Falls back to the bare editor URL when the source is
-  // too large to compress into a share link.
-  y += 2;
-  parts.push(
-    `<line x1="${PAD}" y1="${y}" x2="${W - PAD}" y2="${y}" stroke="${border}" stroke-width="1"/>`
-  );
-  y += 24;
-  const encoded = encodeDiagramUrl(source);
-  const editUrl =
-    'url' in encoded && encoded.url
-      ? encoded.url
-      : 'https://online.diagrammo.app';
-  const iconSize = 18;
-  const linkColor = c.colors.blue ?? c.text;
-  parts.push(
-    `<a href="${escapeXml(editUrl)}" target="_blank" rel="noopener noreferrer">` +
-      diagrammoIcon(PAD, y - 14, iconSize) +
-      `<text x="${PAD + iconSize + 8}" y="${y}" fill="${linkColor}" font-family="${FONT_FAMILY}" font-size="12.5" font-weight="600" text-decoration="underline">Edit &amp; fix this diagram at online.diagrammo.app ↗</text>` +
-      `</a>`
-  );
-  y += 8;
-
-  const height = Math.round(y + PAD - 14);
-  const pageBg = isTransparent
-    ? ''
-    : `<rect width="100%" height="100%" fill="${c.bg}"/>`;
-
-  return [
-    `<svg xmlns="http://www.w3.org/2000/svg" width="${W}" height="${height}" viewBox="0 0 ${W} ${height}" font-family="${FONT_FAMILY}">`,
-    pageBg,
-    `<rect x="0.5" y="0.5" width="${W - 1}" height="${height - 1}" rx="10" fill="${card}" stroke="${border}" stroke-width="1"/>`,
-    parts.join(''),
-    `</svg>`,
-  ].join('');
-}
-
-// Greedy word-wrap where the first line is narrower (it shares its row with
-// the line badge) and continuation lines use the full content width.
-function wrapMessage(
-  message: string,
-  firstWidth: number,
-  fullWidth: number
-): string[] {
-  const words = message.split(/\s+/).filter(Boolean);
-  if (words.length === 0) return [''];
-  const lines: string[] = [];
-  let cur = '';
-  for (const word of words) {
-    const limit = lines.length === 0 ? firstWidth : fullWidth;
-    const test = cur ? `${cur} ${word}` : word;
-    if (measureText(test, 13) <= limit || !cur) {
-      cur = test;
-    } else {
-      lines.push(cur);
-      cur = word;
-    }
-  }
-  if (cur) lines.push(cur);
-  return lines;
-}
-
-// Frown face: ringed circle, two eyes, a downturned mouth.
-function frownMark(cx: number, cy: number, color: string): string {
-  const r = 12;
-  return [
-    `<circle cx="${cx}" cy="${cy}" r="${r}" fill="none" stroke="${color}" stroke-width="2"/>`,
-    `<circle cx="${cx - 4.5}" cy="${cy - 3}" r="1.6" fill="${color}"/>`,
-    `<circle cx="${cx + 4.5}" cy="${cy - 3}" r="1.6" fill="${color}"/>`,
-    `<path d="M ${cx - 5} ${cy + 6} Q ${cx} ${cy + 1} ${cx + 5} ${cy + 6}" fill="none" stroke="${color}" stroke-width="2" stroke-linecap="round"/>`,
-  ].join('');
-}
-
-// The Diagrammo mark (the app favicon): rounded square, gold arch, a 3-bar
-// chart and 3 lines. Scaled from its native 100×100 box to `size` px at (x,y).
-// Brand colors are literal hex (the mark is fixed, not palette-tinted) and
-// pre-resolved so resvg renders it in PNG exports too.
-function diagrammoIcon(x: number, y: number, size: number): string {
-  const s = size / 100;
-  return (
-    `<g transform="translate(${x} ${y}) scale(${s})">` +
-    `<rect width="100" height="100" rx="18" fill="#1f2933"/>` +
-    `<path d="M41 71 L41 63.51 A28 28 0 1 1 59 63.51 L59 71" fill="none" stroke="#c9a227" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>` +
-    `<rect x="36" y="43" width="7" height="9" rx="1.9" fill="#c0504d"/>` +
-    `<rect x="45" y="37" width="7" height="15" rx="1.9" fill="#5b9357"/>` +
-    `<rect x="54" y="30" width="7" height="22" rx="1.9" fill="#3b6ea5"/>` +
-    `<rect x="36" y="75" width="28" height="4.6" rx="2.3" fill="#7d5ba6"/>` +
-    `<rect x="36" y="82" width="28" height="4.6" rx="2.3" fill="#7d5ba6"/>` +
-    `<rect x="36" y="89" width="28" height="4.6" rx="2.3" fill="#7d5ba6"/>` +
-    `</g>`
-  );
-}
-
-function escapeXml(s: string): string {
-  return s
-    .replace(/&/g, '&amp;')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;')
-    .replace(/"/g, '&quot;');
-}

package/src/event-line/diagnostics.ts

@@ -1,117 +0,0 @@
-// ============================================================
-// Event Line Diagram — Diagnostic Catalog
-// ============================================================
-//
-// Declarative metadata for every coded diagnostic the event-line parser
-// (`src/event-line/parser.ts`) can emit. The parser emits these via
-// `emit(EVENT_LINE_DX.<KEY>, line, params)` — the canonical wording lives here
-// only, never re-typed at the call site — so consumers (CLI `diagnostics`,
-// console error-review, MCP `validate_diagram`, spec docs) can enumerate the
-// catalog and the parser output can't drift from it.
-//
-// Every message builder tolerates being called with `{}` so the catalog can
-// render a representative string with no live params.
-//
-// NOTE: the parser ALSO emits the universal `E_TAG_DECLARED_AFTER_CONTENT`
-// (`tag` after content); that is catalogued with the universal metadata codes,
-// not here.
-
-import type { DiagnosticSpec } from '../diagnostics';
-
-/** Keyed specs — referenced by the parser's `emit()` call sites. */
-export const EVENT_LINE_DX = {
-  // parser.ts: 'event-line has no events.'
-  NO_EVENTS: {
-    code: 'E_EVENT_LINE_NO_EVENTS',
-    severity: 'error',
-    chartType: 'event-line',
-    title: 'No events',
-    message: 'event-line has no events.',
-    hint: 'Add at least one event line (e.g. `2020 Something happened`) below the header.',
-    example: `event-line Empty`,
-  },
-  // parser.ts parseEventHeader:
-  //   `Use ISO dates (YYYY, YYYY-MM, or YYYY-MM-DD). Got '${firstToken}'.`
-  BAD_DATE: {
-    code: 'E_EVENT_LINE_BAD_DATE',
-    // Runtime: emitted at `warning` despite the E_ prefix (see registry allowlist).
-    severity: 'warning',
-    chartType: 'event-line',
-    title: 'Non-ISO date',
-    message: (p) =>
-      `Use ISO dates (YYYY, YYYY-MM, or YYYY-MM-DD). Got '${p.token ?? '7/16/1969'}'.`,
-    hint: 'Write dates as YYYY, YYYY-MM, or YYYY-MM-DD — slash and dot separators are not parsed.',
-    example: `event-line X
-
-7/16/1969 Liftoff
-  Departs.`,
-  },
-  // parser.ts emits three wordings under this one code (each passes the full
-  // wording as `reason`):
-  //   directive handler: `event-line is horizontal-only in v1; \`direction ${dir}\`
-  //                        (vertical orientation) is a fast-follow.`
-  //   `section` seam:     'Group events with `[Name]` era brackets (§28.6a), not `section`.'
-  //   parseEventHeader:   'event-line events are points; a date range (`->`) is not
-  //                        supported — using the start date.'
-  UNSUPPORTED: {
-    code: 'E_EVENT_LINE_UNSUPPORTED',
-    // Runtime: emitted at `warning` despite the E_ prefix (see registry allowlist).
-    severity: 'warning',
-    chartType: 'event-line',
-    title: 'Unsupported construct',
-    message: (p) =>
-      typeof p.reason === 'string' && p.reason
-        ? p.reason
-        : 'event-line is horizontal-only in v1; `direction TB` (vertical orientation) is a fast-follow.',
-    hint: 'Only horizontal (`direction LR`) is supported; use `[Name]` era brackets (not `section`); events are single points, not date ranges (`->`).',
-    example: `event-line X
-direction TB
-
-2020 A
-  one`,
-  },
-  // parser.ts validateEraDateOrder, two wordings switched by `rel`/`edge`:
-  //   `… but dated after era "${ahead.era}" begins (${ahead.date}). …`   rel=after,  edge=begins
-  //   `… but dated before era "${behind.era}" ends (${behind.date}). …`  rel=before, edge=ends
-  ERA_DATE_ORDER: {
-    code: 'E_EVENT_LINE_ERA_DATE_ORDER',
-    // Runtime: emitted at `warning` despite the E_ prefix (see registry allowlist).
-    severity: 'warning',
-    chartType: 'event-line',
-    title: 'Event breaks era chronology',
-    message: (p) =>
-      `"${p.label ?? 'Sean Curtis CTO'}" (${p.date ?? '2025-04-15'}) is in era "${p.era ?? 'Curtis'}" but dated ${p.rel ?? 'after'} era "${p.otherEra ?? 'Vasanth'}" ${p.edge ?? 'begins'} (${p.otherDate ?? '2025-05-09'}). event-line eras run left-to-right by date — fix the date or move it to the right era, or their brackets will overlap.`,
-    hint: 'Eras render as date-spanning brackets; keep every event dated within its era, or move it to the era that covers its date.',
-    example: `event-line X
-
-[Vasanth]
-  2025-04-01 Opening Day Outage
-  2025-05-09 Fire Kevin C
-
-[Curtis]
-  2025-04-15 Sean Curtis CTO
-  2025-09-01 The incident`,
-  },
-  // parser.ts validateEventDateOrder:
-  //   `"${ev.label}" (${ev.date}) is out of order — it is dated before
-  //    "${prev.label}" (${prev.date}) listed above it. event-line reads
-  //    left-to-right by date; list events chronologically.`
-  DATE_ORDER: {
-    code: 'E_EVENT_LINE_DATE_ORDER',
-    // Runtime: emitted at `warning` despite the E_ prefix (see registry allowlist).
-    severity: 'warning',
-    chartType: 'event-line',
-    title: 'Events out of chronological order',
-    message: (p) =>
-      `"${p.label ?? 'C'}" (${p.date ?? '2022'}) is out of order — it is dated before "${p.prevLabel ?? 'B'}" (${p.prevDate ?? '2024'}) listed above it. event-line reads left-to-right by date; list events chronologically.`,
-    hint: 'List dated events chronologically top-to-bottom; a later-listed event dated before the one above it is almost always a slip.',
-    example: `event-line X
-
-2020 A
-2024 B
-2022 C`,
-  },
-} satisfies Record<string, DiagnosticSpec>;
-
-export const EVENT_LINE_DIAGNOSTICS: DiagnosticSpec[] =
-  Object.values(EVENT_LINE_DX);