ts-prorm-orm 1.2.2 → 2.0.0

package/dist/diagrams/index-diagram.js

@@ -1,19 +1,15 @@
 "use strict";
 /**
- * IndexDiagram — an INDEX & CONSTRAINT MAP for a single table.
+ * IndexDiagram - an INDEX & CONSTRAINT MAP for a single table.
  *
  * A table's columns are laid out as a horizontal strip of "column chips".
  * Below the strip, every index/constraint is drawn as a labeled "bracket" that
- * spans the column chips it covers — so composite indexes visibly span multiple
+ * spans the column chips it covers - so composite indexes visibly span multiple
  * columns and overlapping coverage is obvious at a glance.
  *
  * Index kinds (PRIMARY / UNIQUE / INDEX / FULLTEXT / FOREIGN KEY / CHECK) are
- * distinguished by color + a short badge; each row also shows the index name,
- * its access method (btree/hash/gin…) and whether it is unique.
- *
- * `--theme light|dark` drives the canvas/text colors and `--color <name|hex>`
- * drives the accent used for the header and the PRIMARY index — both genuinely
- * change fill/stroke values in the generated SVG.
+ * distinguished by a short ASCII badge; each row also shows the index name,
+ * its access method (btree/hash/gin...) and whether it is unique.
  *
  * Usage:
  *   const diag = new IndexDiagram({ table: 'users', columns: [...], indexes: [...] });
@@ -58,32 +54,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.IndexDiagram = void 0;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const palette_1 = require("./palette");
-const svg_dom_1 = require("./svg-dom");
-// ─── Industry design system ────────────────────────────────────────────────
-// Barlow / JetBrains Mono typography, hairline borders and square "blueprint"
-// corners are fixed by the Industry spec; accent + surface colours still route
-// through resolveAccent / resolveTheme so --color / --theme keep working.
-const IND_FONT_HEAD = '"Barlow Condensed", system-ui, sans-serif';
-const IND_FONT_BODY = '"Barlow", system-ui, sans-serif';
-const IND_FONT_MONO = 'ui-monospace, "JetBrains Mono", "SF Mono", Menlo, monospace';
-const IND_HAIRLINE = 'rgba(29,31,32,0.16)';
-const IND_FONT_IMPORT = "@import url('https://fonts.googleapis.com/css2?family=Barlow:wght@400;500;700&family=Barlow+Condensed:wght@400;600&family=JetBrains+Mono&display=swap');";
-// Industry blueprint: badges share the accent light tint (#eef6ff / #2c455d)
-// with the badge letters carrying the distinction; a couple of kinds drop to
-// the neutral tint so the map still reads categorically without vibrant hues.
-const KIND_STYLES = {
-    PRIMARY: { badge: 'PK', color: '#2c455d', bg: '#eef6ff' },
-    UNIQUE: { badge: 'UQ', color: '#2c455d', bg: '#eef6ff' },
-    INDEX: { badge: 'IX', color: '#5d5d60', bg: '#f5f5f8' },
-    FULLTEXT: { badge: 'FT', color: '#5d5d60', bg: '#f5f5f8' },
-    'FOREIGN KEY': { badge: 'FK', color: '#2c455d', bg: '#eef6ff' },
-    CHECK: { badge: 'CK', color: '#5d5d60', bg: '#f5f5f8' },
+const svg_1 = require("./core/svg");
+const theme_1 = require("./core/theme");
+const layout_1 = require("./core/layout");
+// Short ASCII badge per index kind. No colour distinction: monochrome.
+const KIND_BADGE = {
+    PRIMARY: 'PK',
+    UNIQUE: 'UQ',
+    INDEX: 'IX',
+    FULLTEXT: 'FT',
+    'FOREIGN KEY': 'FK',
+    CHECK: 'CK',
 };
-function kindStyle(kind) {
-    return KIND_STYLES[kind ?? 'INDEX'] ?? KIND_STYLES.INDEX;
+function kindBadge(kind) {
+    return KIND_BADGE[kind ?? 'INDEX'] ?? KIND_BADGE.INDEX;
 }
-// ─── Main class ──────────────────────────────────────────────────────────────
 class IndexDiagram {
     constructor(options) {
         this.opts = {
@@ -98,10 +83,8 @@ class IndexDiagram {
         const longest = label.reduce((m, s) => Math.max(m, s.length), 4);
         return Math.max(IndexDiagram.MIN_CHIP_W, longest * 8 + 24);
     }
-    generate() {
-        const { table, columns, indexes, title, theme, color } = this.opts;
-        const accent = (0, palette_1.resolveAccent)(color);
-        const t = (0, palette_1.resolveTheme)(theme);
+    build() {
+        const { table, columns, indexes, title } = this.opts;
         const PAD = IndexDiagram.PAD;
         const HDR = IndexDiagram.HDR;
         const CHIP_H = IndexDiagram.CHIP_H;
@@ -110,7 +93,6 @@ class IndexDiagram {
         const GAP_AFTER_STRIP = IndexDiagram.GAP_AFTER_STRIP;
         const ROW_H = IndexDiagram.ROW_H;
         const LABEL_W = IndexDiagram.LABEL_W;
-        const R = IndexDiagram.R;
         const chipW = this.chipWidth();
         const nCols = Math.max(columns.length, 1);
         // Geometry of the column strip.
@@ -128,58 +110,62 @@ class IndexDiagram {
         const svgW = contentW + PAD;
         const rowsTop = stripY + CHIP_H + GAP_AFTER_STRIP;
         const svgH = rowsTop + indexes.length * ROW_H + PAD;
-        const uid = table.replace(/\W/g, '') || 'tbl';
-        const doc = new svg_dom_1.SvgDocument(svgW, svgH);
+        const doc = new svg_1.SvgDocument(svgW, svgH);
         const svg = doc.root;
-        // ── Background + embedded Industry web-fonts ────────────────────────────
-        svg.child('rect', { width: svgW, height: svgH, fill: t.canvasBg });
-        svg.child('style').text(IND_FONT_IMPORT);
-        // ── Header bar (solid accent — blueprint label bar, no gradient) ────────
-        svg.child('rect', { x: PAD, y: PAD, width: contentW - PAD, height: HDR, fill: accent.mid });
+        svg.child('rect', { width: svgW, height: svgH, fill: theme_1.INK.ground });
+        // Header bar.
+        svg.child('rect', {
+            x: PAD,
+            y: PAD,
+            width: contentW - PAD,
+            height: HDR,
+            fill: theme_1.INK.wash,
+            stroke: theme_1.INK.line,
+            'stroke-width': theme_1.STROKE.hair,
+        });
         svg
             .child('text', {
             x: PAD + 18,
             y: PAD + 27,
-            'font-family': IND_FONT_HEAD,
-            'font-size': 20,
-            'font-weight': 600,
-            fill: '#FFFFFF',
+            'font-family': theme_1.FONT.family,
+            'font-size': theme_1.FONT.title + 7,
+            'font-weight': 'bold',
+            fill: theme_1.INK.line,
         })
-            .text(title || `Index Map · ${table}`);
+            .text(title || `Index Map - ${table}`);
         svg
             .child('text', {
             x: PAD + 18,
             y: PAD + 47,
-            'font-family': IND_FONT_MONO,
-            'font-size': 11,
-            fill: 'rgba(255,255,255,0.8)',
+            'font-family': theme_1.FONT.mono,
+            'font-size': theme_1.FONT.small + 2,
+            fill: theme_1.INK.muted,
         })
-            .text(`${columns.length} columns · ${indexes.length} indexes`);
-        // "TABLE" pill on the right of the header.
+            .text(`${columns.length} columns, ${indexes.length} indexes`);
         svg
             .child('text', {
             x: contentW - 16,
             y: PAD + 33,
-            'font-family': IND_FONT_MONO,
-            'font-size': 12,
-            'font-weight': 700,
-            fill: 'rgba(255,255,255,0.92)',
+            'font-family': theme_1.FONT.mono,
+            'font-size': theme_1.FONT.small + 3,
+            'font-weight': 'bold',
+            fill: theme_1.INK.line,
             'text-anchor': 'end',
         })
             .text(table);
-        // ── Column strip label ──────────────────────────────────────────────────
+        // Column strip label.
         svg
             .child('text', {
             x: stripX,
             y: stripY - 8,
-            'font-family': IND_FONT_BODY,
-            'font-size': 11,
-            'font-weight': 700,
+            'font-family': theme_1.FONT.family,
+            'font-size': theme_1.FONT.small + 2,
+            'font-weight': 'bold',
             'letter-spacing': 1,
-            fill: t.textSecondary,
+            fill: theme_1.INK.muted,
         })
             .text('COLUMNS');
-        // ── Column chips ────────────────────────────────────────────────────────
+        // Column chips.
         columns.forEach((c, i) => {
             const x = stripX + i * chipStride;
             svg.child('rect', {
@@ -187,45 +173,40 @@ class IndexDiagram {
                 y: stripY,
                 width: chipW,
                 height: CHIP_H,
-                fill: t.cardBg,
-                stroke: t.border,
-                'stroke-width': 1,
+                fill: theme_1.INK.ground,
+                stroke: theme_1.INK.line,
+                'stroke-width': theme_1.STROKE.hair,
             });
             svg
                 .child('text', {
                 x: x + chipW / 2,
                 y: stripY + 20,
-                'font-family': IND_FONT_MONO,
-                'font-size': 13,
-                'font-weight': 700,
-                fill: t.textPrimary,
+                'font-family': theme_1.FONT.mono,
+                'font-size': theme_1.FONT.body + 2,
+                'font-weight': 'bold',
+                fill: theme_1.INK.line,
                 'text-anchor': 'middle',
             })
-                .text(c.name);
+                .text((0, layout_1.truncate)(c.name, chipW - 8, theme_1.FONT.body + 2, true));
             if (c.type) {
                 svg
                     .child('text', {
                     x: x + chipW / 2,
                     y: stripY + 37,
-                    'font-family': IND_FONT_MONO,
-                    'font-size': 10,
-                    fill: t.textSecondary,
+                    'font-family': theme_1.FONT.mono,
+                    'font-size': theme_1.FONT.small,
+                    fill: theme_1.INK.muted,
                     'text-anchor': 'middle',
                 })
                     .text(c.type);
             }
         });
-        // ── Index / constraint rows with spanning brackets ──────────────────────
-        // Each row draws: left label block (badge + name + method) and a spanning
-        // bracket that connects to every covered column chip via connector lines.
+        // Index / constraint rows with spanning brackets.
         const chipBottom = stripY + CHIP_H;
         indexes.forEach((idx, i) => {
             const rowY = rowsTop + i * ROW_H;
             const rowMid = rowY + ROW_H / 2;
-            const style = kindStyle(idx.kind);
             const isPrimary = idx.kind === 'PRIMARY';
-            // The PRIMARY index adopts the accent color so --color is visibly wired in.
-            const lineColor = isPrimary ? accent.mid : style.color;
             // Alternating row background band.
             if (i % 2 === 1) {
                 svg.child('rect', {
@@ -233,34 +214,39 @@ class IndexDiagram {
                     y: rowY,
                     width: contentW - PAD,
                     height: ROW_H,
-                    fill: t.rowAlt,
+                    fill: theme_1.INK.wash,
                 });
             }
-            // ── Left label block ──
-            // Badge chip.
-            const badgeBg = isPrimary ? accent.light : style.bg;
-            const badgeFg = isPrimary ? accent.text : style.color;
-            svg.child('rect', { x: PAD + 8, y: rowMid - 12, width: 30, height: 24, fill: badgeBg });
+            // Left label block: badge chip.
+            svg.child('rect', {
+                x: PAD + 8,
+                y: rowMid - 12,
+                width: 30,
+                height: 24,
+                fill: theme_1.INK.wash,
+                stroke: theme_1.INK.line,
+                'stroke-width': theme_1.STROKE.hair,
+            });
             svg
                 .child('text', {
                 x: PAD + 8 + 15,
                 y: rowMid + 5,
-                'font-family': IND_FONT_MONO,
-                'font-size': 11,
-                'font-weight': 600,
-                fill: badgeFg,
+                'font-family': theme_1.FONT.mono,
+                'font-size': theme_1.FONT.small + 2,
+                'font-weight': 'bold',
+                fill: theme_1.INK.line,
                 'text-anchor': 'middle',
             })
-                .text(style.badge);
+                .text(kindBadge(idx.kind));
             // Index name.
             svg
                 .child('text', {
                 x: PAD + 48,
                 y: rowMid - 2,
-                'font-family': IND_FONT_MONO,
-                'font-size': 12,
-                'font-weight': 700,
-                fill: t.textPrimary,
+                'font-family': theme_1.FONT.mono,
+                'font-size': theme_1.FONT.body + 1,
+                'font-weight': 'bold',
+                fill: theme_1.INK.line,
             })
                 .text(idx.name);
             // Method + unique subtitle.
@@ -274,12 +260,12 @@ class IndexDiagram {
                 .child('text', {
                 x: PAD + 48,
                 y: rowMid + 13,
-                'font-family': IND_FONT_MONO,
-                'font-size': 10,
-                fill: t.textSecondary,
+                'font-family': theme_1.FONT.mono,
+                'font-size': theme_1.FONT.small,
+                fill: theme_1.INK.muted,
             })
-                .text(meta.join(' · '));
-            // ── Spanning bracket over covered columns ──
+                .text(meta.join(', '));
+            // Spanning bracket over covered columns.
             const covered = idx.columns
                 .map((cn) => colCenter[cn])
                 .filter((v) => typeof v === 'number')
@@ -294,25 +280,27 @@ class IndexDiagram {
                     y1: bracketY,
                     x2: last,
                     y2: bracketY,
-                    stroke: lineColor,
-                    'stroke-width': isPrimary ? 3 : 2,
+                    stroke: theme_1.INK.line,
+                    'stroke-width': isPrimary ? theme_1.STROKE.heavy : theme_1.STROKE.hair,
                     'stroke-linecap': 'round',
                 });
                 // A connector path from each covered column chip down to the spine.
                 covered.forEach((cxp) => {
-                    // Curved connector from the bottom of the chip to the spine node.
                     const d = `M ${cxp} ${chipBottom} C ${cxp} ${(chipBottom + bracketY) / 2}, ${cxp} ${(chipBottom + bracketY) / 2}, ${cxp} ${bracketY}`;
                     svg.child('path', {
                         d,
-                        stroke: lineColor,
-                        'stroke-width': 1.5,
+                        stroke: theme_1.INK.line,
+                        'stroke-width': theme_1.STROKE.hair,
                         fill: 'none',
-                        opacity: 0.85,
                     });
-                    // Node dot where the connector meets the spine.
-                    svg.child('circle', { cx: cxp, cy: bracketY, r: isPrimary ? 5 : 4, fill: lineColor });
+                    svg.child('circle', {
+                        cx: cxp,
+                        cy: bracketY,
+                        r: isPrimary ? 5 : 4,
+                        fill: theme_1.INK.line,
+                    });
                 });
-                // Order labels (1,2,3…) for composite indexes so column order reads.
+                // Order labels (1,2,3...) for composite indexes so column order reads.
                 if (covered.length > 1) {
                     idx.columns.forEach((cn, ord) => {
                         const cxp = colCenter[cn];
@@ -322,17 +310,20 @@ class IndexDiagram {
                             .child('text', {
                             x: cxp + 8,
                             y: bracketY - 8,
-                            'font-family': IND_FONT_MONO,
-                            'font-size': 9,
-                            'font-weight': 700,
-                            fill: lineColor,
+                            'font-family': theme_1.FONT.mono,
+                            'font-size': theme_1.FONT.small - 1,
+                            'font-weight': 'bold',
+                            fill: theme_1.INK.line,
                         })
                             .text(String(ord + 1));
                     });
                 }
             }
         });
-        return doc.toString('Generated by ts-prorm-orm IndexDiagram');
+        return doc;
+    }
+    generate() {
+        return this.build().toString('Generated by ts-prorm-orm IndexDiagram');
     }
     /** Write the SVG to a file. Creates parent directories if needed. */
     save(outputPath) {
@@ -355,4 +346,3 @@ IndexDiagram.GAP_AFTER_STRIP = 46;
 IndexDiagram.ROW_H = 54;
 IndexDiagram.LABEL_W = 250; // left column: badge + name + method
 IndexDiagram.MIN_CHIP_W = 96;
-IndexDiagram.R = 12;

package/dist/diagrams/index.d.ts

@@ -3,10 +3,10 @@
  *
  * SVG diagram generators for ORM models and ER schemas.
  *
- * ─── Quick-start ────────────────────────────────────────────────────────
+ * --- Quick-start --------------------------------------------------------
  *
  * 1) Single-model card
- *    ─────────────────
+ *    -----------------
  *    import { ModelDiagram } from './diagrams';
  *
  *    const diag = new ModelDiagram({
@@ -33,7 +33,7 @@
  *
  *
  * 2) Full ER diagram
- *    ────────────────
+ *    ----------------
  *    import { ERDiagram } from './diagrams';
  *
  *    const er = new ERDiagram({
@@ -46,7 +46,7 @@
  *
  *
  * 3) CLI
- *    ────
+ *    ----
  *    # Single model (from JSON spec)
  *    cli diagram:model --file ./User.json --out ./diagrams/User.svg
  *
@@ -59,7 +59,7 @@
  *          --assoc "hasMany:Post:userId" \
  *          --out ./diagrams/User.svg
  *
- * ─── JSON spec format ───────────────────────────────────────────────────
+ * --- JSON spec format ---------------------------------------------------
  *
  *  Single model file:
  *  {
@@ -79,7 +79,7 @@
  *  {
  *    "title": "My App Schema",
  *    "columns": 3,
- *    "models": [ <model-spec>, <model-spec>, … ]
+ *    "models": [ <model-spec>, <model-spec>, ... ]
  *  }
  */
 export { ModelDiagram } from './model-diagram';
@@ -112,9 +112,6 @@ export { PackageDiagram } from './package-diagram';
 export type { PackageDiagramOptions, PackageBox, PackageMember, PackageDependency, } from './package-diagram';
 export { GanttDiagram } from './gantt-diagram';
 export type { GanttDiagramOptions, GanttTask } from './gantt-diagram';
-export { SvgDocument, El } from './svg-dom';
-export { resolveAccent, resolveTheme, rotatedPalettes, accent2Of, ACCENT_PALETTES, INDUSTRY, FONTS, FONT_IMPORT, BADGE_TINTS, } from './palette';
-export type { AccentPalette, ThemeColors } from './palette';
 import { ModelDiagramOptions } from './model-diagram';
 import { ERDiagramOptions } from './er-diagram';
 /**

package/dist/diagrams/index.js

@@ -4,10 +4,10 @@
  *
  * SVG diagram generators for ORM models and ER schemas.
  *
- * ─── Quick-start ────────────────────────────────────────────────────────
+ * --- Quick-start --------------------------------------------------------
  *
  * 1) Single-model card
- *    ─────────────────
+ *    -----------------
  *    import { ModelDiagram } from './diagrams';
  *
  *    const diag = new ModelDiagram({
@@ -34,7 +34,7 @@
  *
  *
  * 2) Full ER diagram
- *    ────────────────
+ *    ----------------
  *    import { ERDiagram } from './diagrams';
  *
  *    const er = new ERDiagram({
@@ -47,7 +47,7 @@
  *
  *
  * 3) CLI
- *    ────
+ *    ----
  *    # Single model (from JSON spec)
  *    cli diagram:model --file ./User.json --out ./diagrams/User.svg
  *
@@ -60,7 +60,7 @@
  *          --assoc "hasMany:Post:userId" \
  *          --out ./diagrams/User.svg
  *
- * ─── JSON spec format ───────────────────────────────────────────────────
+ * --- JSON spec format ---------------------------------------------------
  *
  *  Single model file:
  *  {
@@ -80,11 +80,11 @@
  *  {
  *    "title": "My App Schema",
  *    "columns": 3,
- *    "models": [ <model-spec>, <model-spec>, … ]
+ *    "models": [ <model-spec>, <model-spec>, ... ]
  *  }
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BADGE_TINTS = exports.FONT_IMPORT = exports.FONTS = exports.INDUSTRY = exports.ACCENT_PALETTES = exports.accent2Of = exports.rotatedPalettes = exports.resolveTheme = exports.resolveAccent = exports.El = exports.SvgDocument = exports.GanttDiagram = exports.PackageDiagram = exports.ChenDiagram = exports.TreeDiagram = exports.FlowDiagram = exports.IndexDiagram = exports.SchemaDocDiagram = exports.DependencyDiagram = exports.StateDiagram = exports.SequenceDiagram = exports.RelationalDiagram = exports.ClassDiagram = exports.MigrationDiagram = exports.ERDiagram = exports.ModelDiagram = void 0;
+exports.GanttDiagram = exports.PackageDiagram = exports.ChenDiagram = exports.TreeDiagram = exports.FlowDiagram = exports.IndexDiagram = exports.SchemaDocDiagram = exports.DependencyDiagram = exports.StateDiagram = exports.SequenceDiagram = exports.RelationalDiagram = exports.ClassDiagram = exports.MigrationDiagram = exports.ERDiagram = exports.ModelDiagram = void 0;
 exports.generateModelDiagram = generateModelDiagram;
 exports.generateERDiagram = generateERDiagram;
 exports.generateModelDiagramFromFile = generateModelDiagramFromFile;
@@ -95,7 +95,7 @@ var er_diagram_1 = require("./er-diagram");
 Object.defineProperty(exports, "ERDiagram", { enumerable: true, get: function () { return er_diagram_1.ERDiagram; } });
 var migration_diagram_1 = require("./migration-diagram");
 Object.defineProperty(exports, "MigrationDiagram", { enumerable: true, get: function () { return migration_diagram_1.MigrationDiagram; } });
-// ─── Extended diagram generators (all built on the shared DOM SVG builder) ──
+// --- Extended diagram generators (all built on the shared DOM SVG builder) --
 var class_diagram_1 = require("./class-diagram");
 Object.defineProperty(exports, "ClassDiagram", { enumerable: true, get: function () { return class_diagram_1.ClassDiagram; } });
 var relational_diagram_1 = require("./relational-diagram");
@@ -120,22 +120,7 @@ var package_diagram_1 = require("./package-diagram");
 Object.defineProperty(exports, "PackageDiagram", { enumerable: true, get: function () { return package_diagram_1.PackageDiagram; } });
 var gantt_diagram_1 = require("./gantt-diagram");
 Object.defineProperty(exports, "GanttDiagram", { enumerable: true, get: function () { return gantt_diagram_1.GanttDiagram; } });
-// Shared DOM SVG builder + palette (exposed for custom generators)
-var svg_dom_1 = require("./svg-dom");
-Object.defineProperty(exports, "SvgDocument", { enumerable: true, get: function () { return svg_dom_1.SvgDocument; } });
-Object.defineProperty(exports, "El", { enumerable: true, get: function () { return svg_dom_1.El; } });
-var palette_1 = require("./palette");
-Object.defineProperty(exports, "resolveAccent", { enumerable: true, get: function () { return palette_1.resolveAccent; } });
-Object.defineProperty(exports, "resolveTheme", { enumerable: true, get: function () { return palette_1.resolveTheme; } });
-Object.defineProperty(exports, "rotatedPalettes", { enumerable: true, get: function () { return palette_1.rotatedPalettes; } });
-Object.defineProperty(exports, "accent2Of", { enumerable: true, get: function () { return palette_1.accent2Of; } });
-Object.defineProperty(exports, "ACCENT_PALETTES", { enumerable: true, get: function () { return palette_1.ACCENT_PALETTES; } });
-// Industry design-system tokens
-Object.defineProperty(exports, "INDUSTRY", { enumerable: true, get: function () { return palette_1.INDUSTRY; } });
-Object.defineProperty(exports, "FONTS", { enumerable: true, get: function () { return palette_1.FONTS; } });
-Object.defineProperty(exports, "FONT_IMPORT", { enumerable: true, get: function () { return palette_1.FONT_IMPORT; } });
-Object.defineProperty(exports, "BADGE_TINTS", { enumerable: true, get: function () { return palette_1.BADGE_TINTS; } });
-// ─── Convenience factory functions ──────────────────────────────────────────
+// --- Convenience factory functions ------------------------------------------
 const model_diagram_2 = require("./model-diagram");
 const er_diagram_2 = require("./er-diagram");
 /**

package/dist/diagrams/migration-diagram.d.ts

@@ -1,9 +1,9 @@
 /**
- * MigrationDiagram — generates an SVG showing database schema changes.
+ * MigrationDiagram - generates an SVG showing database schema changes.
  *
  * Features:
  *  - Shows tables with their columns (before/after or just new state)
- *  - Color-coded change indicators: green (added), red (removed), yellow (modified)
+ *  - Change indicators per column: added, removed, modified
  *  - Migration metadata header with timestamp and description
  *  - Support for multiple migration steps
  *  - Compact field rows with type badges
@@ -40,9 +40,12 @@ export interface MigrationDiagramOptions {
     timestamp?: string;
     /** All table changes to visualize */
     changes: TableChange[];
-    /** Theme */
+    /**
+     * Accepted for backward compatibility and ignored: diagrams render in a
+     * single monochrome theme.
+     */
     theme?: 'light' | 'dark';
-    /** Custom accent color */
+    /** Accepted for backward compatibility and ignored. */
     color?: string;
 }
 export declare class MigrationDiagram {
@@ -59,6 +62,7 @@ export declare class MigrationDiagram {
     private renderBanner;
     private renderChangeBox;
     private renderLegend;
+    private build;
     generate(): string;
     /**
      * Write the SVG to a file.