ts-prorm-orm 1.2.2 → 2.0.0

package/dist/diagrams/model-diagram.js

@@ -1,23 +1,10 @@
 "use strict";
 /**
- * ModelDiagram — generates a fully-rendered SVG card for a single ORM model,
- * styled to the "Industry" blueprint design system.
+ * ModelDiagram - a single model as one panel.
  *
- * Look:
- *  - Solid accent (#5980a6) header bar with the model name in Barlow Condensed
- *  - White card body, 1px hairline dividers, SQUARE corners, no drop shadow
- *  - L-shaped corner registration marks around the frame (blueprint)
- *  - One row per column: name (Barlow) + type (mono, neutral-700) + constraint
- *    badges — PK/UQ (accent tint), FK (accent-2 tint), NN/AI/TS (neutral tint)
- *  - Associations listed at the bottom with cardinality marks
- *  - Hairline footer strip with table name + metadata
- *  - Auto-sized SVG viewBox
- *
- * Usage:
- *   const diag = new ModelDiagram({ name: 'User', fields: { … }, associations: […] });
- *   diag.save('./diagrams/User.svg');
- *   // or:
- *   const svgString = diag.generate();
+ * Header carries the model name and its table name; rows are the columns, with
+ * a key marker on the left and the SQL type on the right; associations follow
+ * below a rule. Nothing else is drawn.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -53,11 +40,20 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ModelDiagram = void 0;
+exports.text = exports.line = exports.measureText = exports.ModelDiagram = void 0;
+exports.resolveType = resolveType;
+exports.fieldMarker = marker;
+exports.fieldAnnotations = annotations;
+exports.describeAssociation = describeAssociation;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const palette_1 = require("./palette");
-const svg_dom_1 = require("./svg-dom");
+const svg_1 = require("./core/svg");
+const theme_1 = require("./core/theme");
+const layout_1 = require("./core/layout");
+Object.defineProperty(exports, "line", { enumerable: true, get: function () { return layout_1.line; } });
+Object.defineProperty(exports, "measureText", { enumerable: true, get: function () { return layout_1.measureText; } });
+Object.defineProperty(exports, "text", { enumerable: true, get: function () { return layout_1.text; } });
+/** Render a field's type as a plain SQL-ish string. */
 function resolveType(field) {
     const t = field.type;
     if (typeof t === 'string')
@@ -70,485 +66,110 @@ function resolveType(field) {
     }
     return 'UNKNOWN';
 }
-/** Cardinality marks per association type (mono, blueprint). */
-const ASSOC_META = {
-    hasOne: { mark: '1:1', label: 'hasOne' },
-    hasMany: { mark: '1:N', label: 'hasMany' },
-    belongsTo: { mark: 'N:1', label: 'belongsTo' },
-    belongsToMany: { mark: 'N:N', label: 'belongsToMany' },
-};
-// ─── Main class ────────────────────────────────────────────────────────────
+/**
+ * Key marker for a column: PK, FK, U for unique, or blank.
+ *
+ * A single short token rather than a coloured badge - it survives greyscale
+ * printing and costs one column of width.
+ */
+function marker(field) {
+    if (field.primaryKey)
+        return 'PK';
+    if (field.foreignKey || field.references)
+        return 'FK';
+    if (field.unique)
+        return 'U';
+    return undefined;
+}
+/** Trailing annotations for a column, e.g. "not null", "default 0". */
+function annotations(field) {
+    const parts = [];
+    if (field.autoIncrement)
+        parts.push('auto');
+    if (field.allowNull === false && !field.primaryKey)
+        parts.push('not null');
+    if (field.defaultValue !== undefined && field.defaultValue !== null) {
+        parts.push(`default ${String(field.defaultValue)}`);
+    }
+    if (field.enum?.length)
+        parts.push(`enum(${field.enum.length})`);
+    return parts.join(', ');
+}
+/** Describe one association in a single line. */
+function describeAssociation(a) {
+    const via = a.through
+        ? ` through ${a.through}`
+        : a.foreignKey
+            ? ` on ${a.foreignKey}`
+            : '';
+    const alias = a.as ? ` as ${a.as}` : '';
+    return `${a.type} ${a.target}${via}${alias}`;
+}
 class ModelDiagram {
     constructor(options) {
-        // NOTE: spread `...options` FIRST so the defaults below win. Spreading last
-        // would re-apply raw null/undefined values (e.g. `associations: null`) over
-        // the guarded defaults and crash later when they are dereferenced.
-        this.opts = {
-            ...options,
-            name: options.name ?? 'Model',
-            tableName: options.tableName ?? (options.name ?? 'model').toLowerCase() + 's',
-            fields: options.fields ?? {},
-            associations: options.associations ?? [],
-            timestamps: options.timestamps ?? true,
-            paranoid: options.paranoid ?? false,
-            underscored: options.underscored ?? false,
-            comment: options.comment ?? '',
-            theme: options.theme ?? 'light',
-            color: options.color ?? '',
-        };
+        this.opts = options;
     }
-    // ── Row badge helper ────────────────────────────────────────────────────
-    badges(field, isTS) {
-        const b = [];
-        const A = palette_1.BADGE_TINTS.accent;
-        const A2 = palette_1.BADGE_TINTS.accent2;
-        const N = palette_1.BADGE_TINTS.neutral;
-        if (field.primaryKey)
-            b.push({ text: 'PK', bg: A.bg, fg: A.fg });
-        if (field.foreignKey || field.references)
-            b.push({ text: 'FK', bg: A2.bg, fg: A2.fg });
-        if (field.autoIncrement)
-            b.push({ text: 'AI', bg: N.bg, fg: N.fg });
-        if (field.unique && !field.primaryKey)
-            b.push({ text: 'UQ', bg: A.bg, fg: A.fg });
-        if (field.allowNull === false)
-            b.push({ text: 'NN', bg: N.bg, fg: N.fg });
-        if (isTS)
-            b.push({ text: 'TS', bg: N.bg, fg: N.fg });
-        return b;
-    }
-    // ── SVG badge (drawn into a parent group) — square, hairline, mono ────────
-    drawBadge(parent, b, x, y) {
-        const w = b.text.length * 8 + 12;
-        parent.child('rect', {
-            x,
-            y,
-            width: w,
-            height: 18,
-            rx: 0,
-            fill: b.bg,
-            stroke: palette_1.INDUSTRY.divider,
-            'stroke-width': 1,
+    /** Column rows, including the implicit timestamp columns when enabled. */
+    fieldRows() {
+        const rows = Object.entries(this.opts.fields).map(([name, field]) => {
+            const note = annotations(field);
+            return {
+                label: field.name ?? name,
+                detail: note ? `${resolveType(field)}  ${note}` : resolveType(field),
+                marker: marker(field),
+            };
         });
-        parent
-            .child('text', {
-            x: x + w / 2,
-            y: y + 13,
-            'font-family': palette_1.FONTS.heading,
-            'font-size': 11,
-            'font-weight': 600,
-            'letter-spacing': 0.4,
-            fill: b.fg,
-            'text-anchor': 'middle',
-        })
-            .text(b.text);
-        return w;
+        if (this.opts.timestamps) {
+            const stamp = (n) => ({ label: n, detail: 'DATE' });
+            rows.push({ ...stamp('createdAt'), rule: true });
+            rows.push(stamp('updatedAt'));
+            if (this.opts.paranoid)
+                rows.push(stamp('deletedAt'));
+        }
+        return rows;
     }
-    // ── L-shaped corner registration marks around the frame ──────────────────
-    cornerMarks(svg, x, y, w, h) {
-        const len = 9;
-        const col = palette_1.INDUSTRY.neutral[500];
-        const sw = 1;
-        const seg = (x1, y1, x2, y2) => svg.child('line', { x1, y1, x2, y2, stroke: col, 'stroke-width': sw });
-        // top-left
-        seg(x, y, x + len, y);
-        seg(x, y, x, y + len);
-        // top-right
-        seg(x + w - len, y, x + w, y);
-        seg(x + w, y, x + w, y + len);
-        // bottom-left
-        seg(x, y + h, x + len, y + h);
-        seg(x, y + h - len, x, y + h);
-        // bottom-right
-        seg(x + w - len, y + h, x + w, y + h);
-        seg(x + w, y + h - len, x + w, y + h);
+    associationRows() {
+        return (this.opts.associations ?? []).map((a, i) => ({
+            label: describeAssociation(a),
+            rule: i === 0,
+        }));
     }
-    // ── Generate full SVG string (built via a real DOM document) ──────────────
-    generate() {
-        const { name, tableName, fields, associations, timestamps, paranoid, comment, theme, color } = this.opts;
-        const accent = (0, palette_1.resolveAccent)(color);
-        const a2 = (0, palette_1.accent2Of)(accent);
-        const t = (0, palette_1.resolveTheme)(theme);
-        const W = ModelDiagram.W;
-        const HDR = ModelDiagram.HDR;
-        const COL_HDR = ModelDiagram.COL_HDR;
-        const ROW_H = ModelDiagram.ROW_H;
-        const ASSOC_HDR = ModelDiagram.ASSOC_HDR;
-        const ASSOC_ROW = ModelDiagram.ASSOC_ROW;
-        const FOOTER = ModelDiagram.FOOTER;
-        const PAD = ModelDiagram.PAD;
-        // ── Build field list (add timestamps if requested) ──────────────────
-        const fieldEntries = Object.entries(fields);
-        const tsFields = ['createdAt', 'updatedAt'];
-        if (paranoid)
-            tsFields.push('deletedAt');
-        if (timestamps) {
-            tsFields.forEach((tf) => {
-                if (!fieldEntries.find(([k]) => k === tf)) {
-                    fieldEntries.push([tf, { type: 'DATE', allowNull: tf === 'deletedAt' }]);
-                }
-            });
-        }
-        const hasAssoc = associations.length > 0;
-        const assocBlockH = hasAssoc ? ASSOC_HDR + associations.length * ASSOC_ROW : 0;
-        const cardH = HDR + COL_HDR + fieldEntries.length * ROW_H + assocBlockH + FOOTER;
-        const svgW = W + 2 * PAD;
-        const svgH = cardH + 2 * PAD;
-        const cx = PAD;
-        const cy = PAD;
-        const doc = new svg_dom_1.SvgDocument(svgW, svgH);
-        const svg = doc.root;
-        // Web fonts for browser renderers.
-        doc.style(palette_1.FONT_IMPORT);
-        // ── Ground ──────────────────────────────────────────────────────────
-        svg.child('rect', { width: svgW, height: svgH, fill: t.canvasBg });
-        // ── Card surface + hairline frame (square) ──────────────────────────
-        svg.child('rect', { x: cx, y: cy, width: W, height: cardH, fill: t.cardBg });
-        svg.child('rect', {
-            x: cx,
-            y: cy,
-            width: W,
-            height: cardH,
-            fill: 'none',
-            stroke: t.border,
-            'stroke-width': 1,
-        });
-        // Corner registration marks.
-        this.cornerMarks(svg, cx, cy, W, cardH);
-        // ── Header (solid accent bar) ───────────────────────────────────────
-        svg.child('rect', { x: cx, y: cy, width: W, height: HDR, fill: accent.mid });
-        svg
-            .child('text', {
-            x: cx + 18,
-            y: cy + 30,
-            'font-family': palette_1.FONTS.heading,
-            'font-size': 24,
-            'font-weight': 600,
-            'letter-spacing': 0.2,
-            fill: '#FFFFFF',
-        })
-            .text(name);
-        if (comment) {
-            svg
-                .child('text', {
-                x: cx + 18,
-                y: cy + 47,
-                'font-family': palette_1.FONTS.body,
-                'font-size': 11,
-                fill: 'rgba(255,255,255,0.82)',
-            })
-                .text(comment.length > 60 ? comment.slice(0, 59) + '…' : comment);
-        }
-        // Right-aligned kicker label.
-        svg
-            .child('text', {
-            x: cx + W - 16,
-            y: cy + 22,
-            'font-family': palette_1.FONTS.heading,
-            'font-size': 11,
-            'font-weight': 600,
-            'letter-spacing': 1.4,
-            fill: 'rgba(255,255,255,0.85)',
-            'text-anchor': 'end',
-        })
-            .text('ORM MODEL');
-        svg
-            .child('text', {
-            x: cx + W - 16,
-            y: cy + 40,
-            'font-family': palette_1.FONTS.mono,
-            'font-size': 11,
-            fill: 'rgba(255,255,255,0.72)',
-            'text-anchor': 'end',
-        })
-            .text(tableName.length > 26 ? tableName.slice(0, 25) + '…' : tableName);
-        // ── Column header row ───────────────────────────────────────────────
-        const colHdrY = cy + HDR;
-        svg.child('rect', { x: cx, y: colHdrY, width: W, height: COL_HDR, fill: t.colHeaderBg });
-        const colHdr = (x, label) => svg
-            .child('text', {
-            x,
-            y: colHdrY + 20,
-            'font-family': palette_1.FONTS.heading,
-            'font-size': 11,
-            'font-weight': 600,
-            fill: t.textSecondary,
-            'letter-spacing': 1,
-        })
-            .text(label);
-        colHdr(cx + 18, 'COLUMN');
-        colHdr(cx + 230, 'TYPE');
-        colHdr(cx + 380, 'CONSTRAINTS');
-        svg.child('line', {
-            x1: cx,
-            y1: colHdrY + COL_HDR,
-            x2: cx + W,
-            y2: colHdrY + COL_HDR,
-            stroke: t.border,
-            'stroke-width': 1,
-        });
-        // ── Field rows ──────────────────────────────────────────────────────
-        const fieldSectionY = colHdrY + COL_HDR;
-        fieldEntries.forEach(([colName, field], i) => {
-            const typeStr = resolveType(field);
-            const rowY = fieldSectionY + i * ROW_H;
-            const midY = rowY + ROW_H / 2;
-            const textBase = midY + 4;
-            const rowBg = i % 2 === 0 ? t.cardBg : t.rowAlt;
-            const isTS = tsFields.includes(colName);
-            const isPK = !!field.primaryKey;
-            const isFK = !!(field.foreignKey || field.references);
-            svg.child('rect', { x: cx, y: rowY, width: W, height: ROW_H, fill: rowBg });
-            // Left accent stripe: PK → accent, FK → accent-2.
-            if (isPK)
-                svg.child('rect', { x: cx, y: rowY, width: 3, height: ROW_H, fill: accent.mid });
-            else if (isFK)
-                svg.child('rect', { x: cx, y: rowY, width: 3, height: ROW_H, fill: a2.color });
-            // Field name (body font).
-            const nameW = isPK || isFK ? 600 : 400;
-            const nameC = isPK ? accent.text : isFK ? a2.text : t.textPrimary;
-            const dispName = colName.length > 24 ? colName.slice(0, 23) + '…' : colName;
-            svg
-                .child('text', {
-                x: cx + 18,
-                y: textBase,
-                'font-family': palette_1.FONTS.body,
-                'font-size': 13,
-                'font-weight': nameW,
-                fill: nameC,
-            })
-                .text(dispName);
-            // Type (mono, neutral-700).
-            const typTxt = typeStr.length > 22 ? typeStr.slice(0, 21) + '…' : typeStr;
-            svg
-                .child('text', {
-                x: cx + 230,
-                y: textBase,
-                'font-family': palette_1.FONTS.mono,
-                'font-size': 12,
-                fill: palette_1.INDUSTRY.neutral[700],
-            })
-                .text(typTxt);
-            // Constraint badges.
-            let bx = cx + 380;
-            for (const b of this.badges(field, isTS)) {
-                bx += this.drawBadge(svg, b, bx, rowY + (ROW_H - 18) / 2) + 5;
-            }
-            // FK reference label (below the name).
-            if (isFK && field.references) {
-                svg
-                    .child('text', {
-                    x: cx + 18,
-                    y: rowY + ROW_H - 6,
-                    'font-family': palette_1.FONTS.mono,
-                    'font-size': 9,
-                    fill: t.textSecondary,
-                })
-                    .text(`→ ${field.references.model}.${field.references.key}`);
-            }
-            svg.child('line', {
-                x1: cx,
-                y1: rowY + ROW_H,
-                x2: cx + W,
-                y2: rowY + ROW_H,
-                stroke: t.border,
-                'stroke-width': 1,
-            });
-        });
-        // ── Associations ────────────────────────────────────────────────────
-        const assocBaseY = fieldSectionY + fieldEntries.length * ROW_H;
-        if (hasAssoc) {
-            svg.child('rect', { x: cx, y: assocBaseY, width: W, height: ASSOC_HDR, fill: palette_1.INDUSTRY.accentLight });
-            svg.child('rect', { x: cx, y: assocBaseY, width: 3, height: ASSOC_HDR, fill: accent.mid });
-            svg
-                .child('text', {
-                x: cx + 18,
-                y: assocBaseY + 22,
-                'font-family': palette_1.FONTS.heading,
-                'font-size': 12,
-                'font-weight': 600,
-                fill: accent.text,
-                'letter-spacing': 1,
-            })
-                .text('ASSOCIATIONS');
-            svg.child('line', {
-                x1: cx,
-                y1: assocBaseY + ASSOC_HDR,
-                x2: cx + W,
-                y2: assocBaseY + ASSOC_HDR,
-                stroke: t.border,
-                'stroke-width': 1,
-            });
-            associations.forEach((assoc, i) => {
-                const aY = assocBaseY + ASSOC_HDR + i * ASSOC_ROW;
-                const meta = ASSOC_META[assoc.type] ?? { mark: '?', label: assoc.type };
-                const rowBg = i % 2 === 0 ? t.cardBg : t.rowAlt;
-                const aTextY = aY + 18;
-                svg.child('rect', { x: cx, y: aY, width: W, height: ASSOC_ROW, fill: rowBg });
-                // Cardinality mark (mono, accent tint chip).
-                const cbw = 36;
-                svg.child('rect', {
-                    x: cx + 14,
-                    y: aY + 5,
-                    width: cbw,
-                    height: 18,
-                    fill: palette_1.INDUSTRY.accentLight,
-                    stroke: palette_1.INDUSTRY.divider,
-                    'stroke-width': 1,
-                });
-                svg
-                    .child('text', {
-                    x: cx + 14 + cbw / 2,
-                    y: aY + 18,
-                    'font-family': palette_1.FONTS.mono,
-                    'font-size': 11,
-                    'font-weight': 600,
-                    fill: accent.text,
-                    'text-anchor': 'middle',
-                })
-                    .text(meta.mark);
-                svg
-                    .child('text', {
-                    x: cx + 60,
-                    y: aTextY,
-                    'font-family': palette_1.FONTS.body,
-                    'font-size': 12,
-                    'font-weight': 500,
-                    fill: t.textPrimary,
-                })
-                    .text(meta.label);
-                svg
-                    .child('text', {
-                    x: cx + 162,
-                    y: aTextY,
-                    'font-family': palette_1.FONTS.mono,
-                    'font-size': 12,
-                    'font-weight': 600,
-                    fill: accent.text,
-                })
-                    .text(assoc.target);
-                if (assoc.foreignKey) {
-                    svg
-                        .child('text', {
-                        x: cx + 300,
-                        y: aTextY,
-                        'font-family': palette_1.FONTS.mono,
-                        'font-size': 10,
-                        fill: t.textSecondary,
-                    })
-                        .text(`(${assoc.foreignKey})`);
-                }
-                if (assoc.through) {
-                    svg
-                        .child('text', {
-                        x: cx + 400,
-                        y: aTextY,
-                        'font-family': palette_1.FONTS.mono,
-                        'font-size': 10,
-                        fill: a2.text,
-                    })
-                        .text(`via: ${assoc.through}`);
-                }
-                if (assoc.as) {
-                    svg
-                        .child('text', {
-                        x: cx + W - 14,
-                        y: aTextY,
-                        'font-family': palette_1.FONTS.mono,
-                        'font-size': 10,
-                        fill: t.textSecondary,
-                        'text-anchor': 'end',
-                    })
-                        .text(`as: ${assoc.as}`);
-                }
-                svg.child('line', {
-                    x1: cx,
-                    y1: aY + ASSOC_ROW,
-                    x2: cx + W,
-                    y2: aY + ASSOC_ROW,
-                    stroke: t.border,
-                    'stroke-width': 1,
-                });
-            });
-        }
-        // ── Footer (hairline strip) ─────────────────────────────────────────
-        const footerY = assocBaseY + assocBlockH;
-        svg.child('rect', { x: cx, y: footerY, width: W, height: FOOTER, fill: t.footerBg });
-        svg.child('line', {
-            x1: cx,
-            y1: footerY,
-            x2: cx + W,
-            y2: footerY,
-            stroke: t.border,
-            'stroke-width': 1,
-        });
-        const footTable = svg.child('text', {
-            x: cx + 18,
-            y: footerY + 25,
-            'font-family': palette_1.FONTS.heading,
-            'font-size': 11,
-            'font-weight': 600,
-            'letter-spacing': 0.6,
-            fill: t.textSecondary,
-        });
-        footTable.text('TABLE ');
-        footTable
-            .child('tspan', { 'font-family': palette_1.FONTS.mono, 'font-weight': 400, fill: accent.text })
-            .text(tableName);
-        if (timestamps) {
-            svg
-                .child('text', {
-                x: cx + 250,
-                y: footerY + 25,
-                'font-family': palette_1.FONTS.body,
-                'font-size': 11,
-                fill: t.textSecondary,
-            })
-                .text('timestamps');
-        }
-        if (paranoid) {
-            svg
-                .child('text', {
-                x: cx + 350,
-                y: footerY + 25,
-                'font-family': palette_1.FONTS.body,
-                'font-size': 11,
-                fill: t.textSecondary,
-            })
-                .text('paranoid');
+    /** Build the SVG document. */
+    build() {
+        const rows = [...this.fieldRows(), ...this.associationRows()];
+        const opts = {
+            title: this.opts.name,
+            subtitle: this.opts.tableName ?? this.opts.name.toLowerCase(),
+            rows,
+            minWidth: 260,
+        };
+        const size = (0, layout_1.panelSize)(opts);
+        const titleH = theme_1.FONT.title + theme_1.SPACE.md;
+        const footerH = this.opts.comment ? theme_1.ROW_HEIGHT : 0;
+        const width = size.w + theme_1.SPACE.xl * 2;
+        const height = titleH + size.h + footerH + theme_1.SPACE.xl * 2;
+        const doc = new svg_1.SvgDocument(width, height);
+        const body = doc.root.child('g');
+        body.child('rect', { x: 0, y: 0, width, height, fill: theme_1.INK.ground });
+        const afterTitle = (0, layout_1.documentTitle)(body, theme_1.SPACE.xl, theme_1.SPACE.lg, `Model: ${this.opts.name}`);
+        const box = (0, layout_1.panel)(body, theme_1.SPACE.xl, afterTitle, opts);
+        if (this.opts.comment) {
+            (0, layout_1.footer)(body, theme_1.SPACE.xl, box.y + box.h + theme_1.ROW_HEIGHT, [this.opts.comment]);
         }
-        svg
-            .child('text', {
-            x: cx + W - 14,
-            y: footerY + 25,
-            'font-family': palette_1.FONTS.body,
-            'font-size': 11,
-            fill: t.textSecondary,
-            'text-anchor': 'end',
-        })
-            .text(`${fieldEntries.length} column${fieldEntries.length !== 1 ? 's' : ''}`);
-        return doc.toString('Generated by ts-prorm-orm ModelDiagram');
+        return { doc, body, box };
+    }
+    /** Generate the SVG source. */
+    generate() {
+        return this.build().doc.toString(`ModelDiagram ${this.opts.name}`);
     }
-    /**
-     * Write the SVG to a file. Creates parent directories if needed.
-     */
+    /** Write the SVG to `outputPath`, creating parent directories. */
     save(outputPath) {
         const resolved = path.resolve(outputPath);
         const dir = path.dirname(resolved);
         if (!fs.existsSync(dir))
             fs.mkdirSync(dir, { recursive: true });
-        const svg = this.generate();
-        fs.writeFileSync(resolved, svg, 'utf-8');
+        fs.writeFileSync(resolved, this.generate(), 'utf-8');
         return resolved;
     }
 }
 exports.ModelDiagram = ModelDiagram;
-// Layout constants (px)
-ModelDiagram.W = 600;
-ModelDiagram.HDR = 56;
-ModelDiagram.COL_HDR = 30;
-ModelDiagram.ROW_H = 38;
-ModelDiagram.ASSOC_HDR = 34;
-ModelDiagram.ASSOC_ROW = 28;
-ModelDiagram.FOOTER = 40;
-ModelDiagram.PAD = 28;

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

@@ -1,15 +1,13 @@
 /**
- * PackageDiagram — a UML package / namespace grouping diagram.
+ * PackageDiagram - a UML package / namespace grouping diagram.
  *
  * Groups models/tables into packages (schemas, modules, bounded-contexts).
  * Each package is drawn as the classic UML "folder" shape: a small tab rect
  * on the top-left plus a body rect beneath it. Package members are laid out
  * as small labeled boxes in a grid inside the body. Dashed dependency arrows
- * (e.g. «import») connect packages.
+ * (e.g. <<import>>) connect packages.
  *
- * Each package receives a distinct accent from `rotatedPalettes`; the theme
- * drives the canvas/text colors. Both `color` and `theme` options genuinely
- * change fill/stroke values in the produced SVG, and the viewBox is auto-sized.
+ * The viewBox is auto-sized to the laid-out geometry.
  *
  * Usage:
  *   const diag = new PackageDiagram({ packages: [...], dependencies: [...] });
@@ -34,8 +32,12 @@ export interface PackageDiagramOptions {
     packages: PackageBox[];
     dependencies?: PackageDependency[];
     title?: string;
+    /**
+     * Accepted for backward compatibility and ignored: diagrams render in a
+     * single monochrome theme.
+     */
     theme?: 'light' | 'dark';
-    /** Named palette or hex accent for the first/primary package. */
+    /** Accepted for backward compatibility and ignored. */
     color?: string;
     /** Number of packages per row (auto if omitted). */
     columns?: number;
@@ -57,6 +59,7 @@ export declare class PackageDiagram {
     constructor(options: PackageDiagramOptions);
     /** Compute the pixel size of a single package folder. */
     private packageSize;
+    private build;
     generate(): string;
     /** Compute connection points on the borders of two package boxes. */
     private edgePoints;