ts-prorm-orm 1.1.0 → 1.2.0

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

@@ -0,0 +1,69 @@
+/**
+ * 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.
+ *
+ * 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.
+ *
+ * Usage:
+ *   const diag = new PackageDiagram({ packages: [...], dependencies: [...] });
+ *   diag.save('./diagrams/packages.svg');
+ *   // or:
+ *   const svgString = diag.generate();
+ */
+export interface PackageMember {
+    name: string;
+    kind?: string;
+}
+export interface PackageBox {
+    name: string;
+    members: PackageMember[];
+}
+export interface PackageDependency {
+    from: string;
+    to: string;
+    label?: string;
+}
+export interface PackageDiagramOptions {
+    packages: PackageBox[];
+    dependencies?: PackageDependency[];
+    title?: string;
+    theme?: 'light' | 'dark';
+    /** Named palette or hex accent for the first/primary package. */
+    color?: string;
+    /** Number of packages per row (auto if omitted). */
+    columns?: number;
+}
+export declare class PackageDiagram {
+    private opts;
+    private static readonly PAD;
+    private static readonly GAP_X;
+    private static readonly GAP_Y;
+    private static readonly TAB_H;
+    private static readonly TAB_W;
+    private static readonly HDR_H;
+    private static readonly MEMBER_W;
+    private static readonly MEMBER_H;
+    private static readonly MEMBER_GAP;
+    private static readonly BODY_PAD;
+    private static readonly MEMBER_COLS;
+    private static readonly TITLE_H;
+    constructor(options: PackageDiagramOptions);
+    /** Compute the pixel size of a single package folder. */
+    private packageSize;
+    generate(): string;
+    /** Compute connection points on the borders of two package boxes. */
+    private edgePoints;
+    /** Draw one UML folder-shaped package with its member grid. */
+    private drawPackage;
+    /**
+     * Write the SVG to a file. Creates parent directories if needed.
+     */
+    save(outputPath: string): string;
+}

package/dist/diagrams/package-diagram.js

@@ -57,6 +57,15 @@ 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');";
 // ─── Main class ─────────────────────────────────────────────────────────────
 class PackageDiagram {
     constructor(options) {
@@ -137,8 +146,9 @@ class PackageDiagram {
         const totalH = rowY[rowCount - 1] + rowHeights[rowCount - 1] + P.PAD;
         const doc = new svg_dom_1.SvgDocument(totalW, totalH);
         const svg = doc.root;
-        // ── Background ───────────────────────────────────────────────────────
+        // ── Background + embedded Industry web-fonts ──────────────────────────
         svg.child('rect', { class: 'canvas', width: totalW, height: totalH, fill: t.canvasBg });
+        svg.child('style').text(IND_FONT_IMPORT);
         // ── Arrow marker (in defs) ───────────────────────────────────────────
         const marker = doc.defs().child('marker', {
             id: 'pkgArrow',
@@ -162,9 +172,9 @@ class PackageDiagram {
                 class: 'title',
                 x: P.PAD,
                 y: P.PAD + 26,
-                'font-family': 'system-ui,-apple-system,sans-serif',
+                'font-family': IND_FONT_HEAD,
                 'font-size': 22,
-                'font-weight': 800,
+                'font-weight': 600,
                 fill: t.textPrimary,
             })
                 .text(title);
@@ -195,7 +205,7 @@ class PackageDiagram {
                 class: 'dependency-label',
                 x: mx,
                 y: my - 6,
-                'font-family': 'system-ui,sans-serif',
+                'font-family': IND_FONT_BODY,
                 'font-size': 11,
                 'font-style': 'italic',
                 fill: t.textSecondary,
@@ -232,66 +242,55 @@ class PackageDiagram {
         const P = PackageDiagram;
         const { pkg, x, y, w, bodyY, accent } = pl;
         const bodyH = pl.h;
-        // Folder tab (top-left small rect).
+        // Folder tab (top-left small rect — square, solid accent).
         svg.child('rect', {
             class: 'package-tab',
             x,
             y,
             width: P.TAB_W,
             height: P.TAB_H,
-            rx: 4,
             fill: accent.mid,
             stroke: accent.from,
-            'stroke-width': 1.5,
+            'stroke-width': 1,
         });
-        // Body rect.
+        // Body rect (white interior, hairline border).
         svg.child('rect', {
             class: 'package-body',
             x,
             y: bodyY,
             width: w,
             height: bodyH,
-            rx: 6,
             fill: t.cardBg,
-            stroke: accent.from,
-            'stroke-width': 1.8,
+            stroke: IND_HAIRLINE,
+            'stroke-width': 1,
         });
-        // Header strip inside body (accent tint).
+        // Header strip inside body (solid accent — blueprint label bar).
         svg.child('rect', {
             class: 'package-header',
             x,
             y: bodyY,
             width: w,
             height: P.HDR_H,
-            rx: 6,
-            fill: accent.light,
-        });
-        // Cover bottom radius of header so it butts the members.
-        svg.child('rect', {
-            x,
-            y: bodyY + P.HDR_H - 6,
-            width: w,
-            height: 6,
-            fill: accent.light,
+            fill: accent.mid,
         });
         svg.child('line', {
             x1: x,
             y1: bodyY + P.HDR_H,
             x2: x + w,
             y2: bodyY + P.HDR_H,
-            stroke: accent.from,
+            stroke: IND_HAIRLINE,
             'stroke-width': 1,
         });
-        // Package name (in the tab-aligned header).
+        // Package name (white on the accent header bar).
         svg
             .child('text', {
             class: 'package-name',
             x: x + P.BODY_PAD,
             y: bodyY + 26,
-            'font-family': 'system-ui,-apple-system,sans-serif',
+            'font-family': IND_FONT_HEAD,
             'font-size': 15,
-            'font-weight': 800,
-            fill: accent.text,
+            'font-weight': 600,
+            fill: '#FFFFFF',
         })
             .text(pkg.name);
         // Member boxes in a grid.
@@ -308,9 +307,8 @@ class PackageDiagram {
                 y: my,
                 width: P.MEMBER_W,
                 height: P.MEMBER_H,
-                rx: 5,
-                fill: t.rowAlt,
-                stroke: accent.mid,
+                fill: t.cardBg,
+                stroke: IND_HAIRLINE,
                 'stroke-width': 1,
             });
             // Left accent stripe.
@@ -328,7 +326,7 @@ class PackageDiagram {
                 class: 'member-name',
                 x: mx + 14,
                 y: m.kind ? my + 18 : my + 25,
-                'font-family': "'SF Mono','Fira Code',monospace",
+                'font-family': IND_FONT_MONO,
                 'font-size': 12,
                 'font-weight': 700,
                 fill: t.textPrimary,
@@ -340,7 +338,7 @@ class PackageDiagram {
                     class: 'member-kind',
                     x: mx + 14,
                     y: my + 32,
-                    'font-family': 'system-ui,sans-serif',
+                    'font-family': IND_FONT_BODY,
                     'font-size': 9,
                     fill: t.textSecondary,
                 })

package/dist/diagrams/palette.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Shared accent-color and theme resolution for the diagram generators.
+ *
+ * `--color <name>` (or a custom hex string) picks an accent palette used for
+ * header bars / banners / entity colors.
+ * `--theme light|dark` picks a background/text theme.
+ *
+ * Both are genuinely applied by ModelDiagram, ERDiagram, RelationalDiagram,
+ * SchemaDocDiagram, ChenDiagram (and MigrationDiagram) — changing either flag
+ * changes real fill/stroke values in the generated SVG.
+ *
+ * ─── Industry design system ────────────────────────────────────────────────
+ * The DEFAULT look is the "Industry" blueprint design: a #f2f2f3 ground, white
+ * cards, hairline dividers, square corners, a solid #5980a6 accent header bar,
+ * and Barlow / Barlow Condensed / JetBrains Mono typography. The old vibrant
+ * multi-stop gradient palettes are retained as explicit `--color` overrides,
+ * but `industry` is now `ACCENT_PALETTES[0]` (the fallback of `resolveAccent`).
+ *
+ * The exported API is intentionally stable — `AccentPalette` / `ThemeColors`
+ * keep their existing fields (new fields are additive & optional), and
+ * `resolveAccent` / `resolveTheme` / `rotatedPalettes` keep their signatures —
+ * so sibling generators and other callers that import them keep working.
+ */
+export interface AccentPalette {
+    name: string;
+    /** Darkest gradient stop / primary header color (also used as a solid fill) */
+    from: string;
+    /** Mid gradient stop — the canonical solid accent fill in the Industry look */
+    mid: string;
+    /** Lightest gradient stop (used for 3-stop gradients / light accents) */
+    to: string;
+    /** Light background tint (badges, footers) */
+    light: string;
+    /** Readable text color on `light` background */
+    text: string;
+    /** Secondary accent (blueprint two-tone; FK marks, alt entities) */
+    accent2?: string;
+    /** Light tint of the secondary accent */
+    accent2Light?: string;
+    /** Readable text on `accent2Light` */
+    accent2Text?: string;
+}
+export declare const INDUSTRY: {
+    readonly ground: "#f2f2f3";
+    readonly surface: "#e9e9ea";
+    readonly card: "#ffffff";
+    readonly text: "#1d1f20";
+    readonly muted: "#7a7a7d";
+    readonly accent: "#5980a6";
+    readonly accent2: "#728fab";
+    readonly accentLight: "#eef6ff";
+    readonly accentText: "#2c455d";
+    readonly accent2Light: "#d6ebff";
+    readonly accent2Text: "#314457";
+    /** Hairline divider — rgba(29,31,32,0.16) */
+    readonly divider: "rgba(29,31,32,0.16)";
+    readonly neutral: {
+        readonly 100: "#f5f5f8";
+        readonly 200: "#e7e7ea";
+        readonly 300: "#d4d4d7";
+        readonly 400: "#b7b7ba";
+        readonly 500: "#98989b";
+        readonly 600: "#7a7a7d";
+        readonly 700: "#5d5d60";
+        readonly 800: "#424244";
+        readonly 900: "#2b2b2d";
+    };
+};
+export declare const FONTS: {
+    /** headings & labels */
+    readonly heading: "\"Barlow Condensed\", system-ui, sans-serif";
+    /** body copy */
+    readonly body: "\"Barlow\", system-ui, sans-serif";
+    /** code / types / mono */
+    readonly mono: "ui-monospace, \"JetBrains Mono\", \"SF Mono\", Menlo, monospace";
+};
+/**
+ * A Google-Fonts @import so browser-rendered SVGs pick up Barlow / Barlow
+ * Condensed / JetBrains Mono. Non-browser renderers fall back to the system
+ * fonts declared alongside each family in `FONTS`.
+ */
+export declare const FONT_IMPORT = "@import url('https://fonts.googleapis.com/css2?family=Barlow:wght@400;500;600;700&family=Barlow+Condensed:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap');";
+/** Constraint / cardinality badge tints in the Industry system. */
+export declare const BADGE_TINTS: {
+    /** PK / UQ — accent tint */
+    readonly accent: {
+        readonly bg: "#eef6ff";
+        readonly fg: "#2c455d";
+    };
+    /** FK — accent-2 tint */
+    readonly accent2: {
+        readonly bg: "#d6ebff";
+        readonly fg: "#314457";
+    };
+    /** NN / AI / TS — neutral tint */
+    readonly neutral: {
+        readonly bg: "#f5f5f8";
+        readonly fg: "#424244";
+    };
+};
+export declare const ACCENT_PALETTES: AccentPalette[];
+/**
+ * Resolve a `--color` flag value to a concrete palette.
+ * Accepts a named palette (case-insensitive) or a hex color string.
+ * Falls back to the default Industry palette.
+ */
+export declare function resolveAccent(color?: string): AccentPalette;
+/** The secondary accent for a resolved palette, with an Industry fallback. */
+export declare function accent2Of(p: AccentPalette): {
+    color: string;
+    light: string;
+    text: string;
+};
+/**
+ * Rotate the palette list so it starts at the resolved accent (used by
+ * ERDiagram / RelationalDiagram to color multiple entities while still honoring
+ * --color for the first/primary entity).
+ */
+export declare function rotatedPalettes(color?: string): AccentPalette[];
+export interface ThemeColors {
+    /** Outer page/canvas background */
+    canvasBg: string;
+    /** Card / entity-box background */
+    cardBg: string;
+    /** Alternating row background (even rows use cardBg) */
+    rowAlt: string;
+    /** Column-header strip background */
+    colHeaderBg: string;
+    /** Primary body text color */
+    textPrimary: string;
+    /** Secondary/muted text color */
+    textSecondary: string;
+    /** Hairline border/divider color */
+    border: string;
+    /** Footer bar background */
+    footerBg: string;
+}
+export declare function resolveTheme(theme?: 'light' | 'dark'): ThemeColors;

package/dist/diagrams/palette.js

@@ -3,20 +3,109 @@
  * Shared accent-color and theme resolution for the diagram generators.
  *
  * `--color <name>` (or a custom hex string) picks an accent palette used for
- * header gradients / banners / entity colors.
+ * header bars / banners / entity colors.
  * `--theme light|dark` picks a background/text theme.
  *
- * Both are genuinely applied by ModelDiagram, ERDiagram and MigrationDiagram —
- * changing either flag changes real fill/stroke values in the generated SVG.
+ * Both are genuinely applied by ModelDiagram, ERDiagram, RelationalDiagram,
+ * SchemaDocDiagram, ChenDiagram (and MigrationDiagram) — changing either flag
+ * changes real fill/stroke values in the generated SVG.
+ *
+ * ─── Industry design system ────────────────────────────────────────────────
+ * The DEFAULT look is the "Industry" blueprint design: a #f2f2f3 ground, white
+ * cards, hairline dividers, square corners, a solid #5980a6 accent header bar,
+ * and Barlow / Barlow Condensed / JetBrains Mono typography. The old vibrant
+ * multi-stop gradient palettes are retained as explicit `--color` overrides,
+ * but `industry` is now `ACCENT_PALETTES[0]` (the fallback of `resolveAccent`).
+ *
+ * The exported API is intentionally stable — `AccentPalette` / `ThemeColors`
+ * keep their existing fields (new fields are additive & optional), and
+ * `resolveAccent` / `resolveTheme` / `rotatedPalettes` keep their signatures —
+ * so sibling generators and other callers that import them keep working.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ACCENT_PALETTES = void 0;
+exports.ACCENT_PALETTES = exports.BADGE_TINTS = exports.FONT_IMPORT = exports.FONTS = exports.INDUSTRY = void 0;
 exports.resolveAccent = resolveAccent;
+exports.accent2Of = accent2Of;
 exports.rotatedPalettes = rotatedPalettes;
 exports.resolveTheme = resolveTheme;
+// ─── Industry design tokens (shared by every generator) ─────────────────────
+exports.INDUSTRY = {
+    ground: '#f2f2f3',
+    surface: '#e9e9ea',
+    card: '#ffffff',
+    text: '#1d1f20',
+    muted: '#7a7a7d',
+    accent: '#5980a6',
+    accent2: '#728fab',
+    accentLight: '#eef6ff',
+    accentText: '#2c455d',
+    accent2Light: '#d6ebff',
+    accent2Text: '#314457',
+    /** Hairline divider — rgba(29,31,32,0.16) */
+    divider: 'rgba(29,31,32,0.16)',
+    neutral: {
+        100: '#f5f5f8',
+        200: '#e7e7ea',
+        300: '#d4d4d7',
+        400: '#b7b7ba',
+        500: '#98989b',
+        600: '#7a7a7d',
+        700: '#5d5d60',
+        800: '#424244',
+        900: '#2b2b2d',
+    },
+};
+// ─── Typography (Barlow / Barlow Condensed / JetBrains Mono) ─────────────────
+exports.FONTS = {
+    /** headings & labels */
+    heading: '"Barlow Condensed", system-ui, sans-serif',
+    /** body copy */
+    body: '"Barlow", system-ui, sans-serif',
+    /** code / types / mono */
+    mono: 'ui-monospace, "JetBrains Mono", "SF Mono", Menlo, monospace',
+};
+/**
+ * A Google-Fonts @import so browser-rendered SVGs pick up Barlow / Barlow
+ * Condensed / JetBrains Mono. Non-browser renderers fall back to the system
+ * fonts declared alongside each family in `FONTS`.
+ */
+exports.FONT_IMPORT = "@import url('https://fonts.googleapis.com/css2?family=Barlow:wght@400;500;600;700&family=Barlow+Condensed:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap');";
+/** Constraint / cardinality badge tints in the Industry system. */
+exports.BADGE_TINTS = {
+    /** PK / UQ — accent tint */
+    accent: { bg: exports.INDUSTRY.accentLight, fg: exports.INDUSTRY.accentText },
+    /** FK — accent-2 tint */
+    accent2: { bg: exports.INDUSTRY.accent2Light, fg: exports.INDUSTRY.accent2Text },
+    /** NN / AI / TS — neutral tint */
+    neutral: { bg: exports.INDUSTRY.neutral[100], fg: exports.INDUSTRY.neutral[800] },
+};
 // Named palette entries. Order matters: it is also the default cycling order
-// used by ERDiagram when no explicit --color is given.
+// used by ERDiagram / RelationalDiagram when no explicit --color is given, so
+// the two Industry entries lead — a schema with no `--color` renders as a
+// blueprint two-tone (accent → accent-2) rather than a rainbow.
 exports.ACCENT_PALETTES = [
+    {
+        name: 'industry',
+        from: exports.INDUSTRY.accent,
+        mid: exports.INDUSTRY.accent,
+        to: exports.INDUSTRY.accent,
+        light: exports.INDUSTRY.accentLight,
+        text: exports.INDUSTRY.accentText,
+        accent2: exports.INDUSTRY.accent2,
+        accent2Light: exports.INDUSTRY.accent2Light,
+        accent2Text: exports.INDUSTRY.accent2Text,
+    },
+    {
+        name: 'industry-2',
+        from: exports.INDUSTRY.accent2,
+        mid: exports.INDUSTRY.accent2,
+        to: exports.INDUSTRY.accent2,
+        light: exports.INDUSTRY.accent2Light,
+        text: exports.INDUSTRY.accent2Text,
+        accent2: exports.INDUSTRY.accent,
+        accent2Light: exports.INDUSTRY.accentLight,
+        accent2Text: exports.INDUSTRY.accentText,
+    },
     { name: 'blue', from: '#1E3A8A', mid: '#2563EB', to: '#60A5FA', light: '#DBEAFE', text: '#1E3A8A' },
     { name: 'violet', from: '#5B21B6', mid: '#7C3AED', to: '#A78BFA', light: '#EDE9FE', text: '#5B21B6' },
     { name: 'emerald', from: '#065F46', mid: '#059669', to: '#34D399', light: '#D1FAE5', text: '#065F46' },
@@ -34,7 +123,7 @@ const HEX_RE = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i;
 /**
  * Resolve a `--color` flag value to a concrete palette.
  * Accepts a named palette (case-insensitive) or a hex color string.
- * Falls back to the default "blue" palette.
+ * Falls back to the default Industry palette.
  */
 function resolveAccent(color) {
     if (color) {
@@ -42,15 +131,33 @@ function resolveAccent(color) {
         if (named)
             return named;
         if (HEX_RE.test(color)) {
-            return { name: color, from: color, mid: color, to: color, light: `${color}22`, text: color };
+            return {
+                name: color,
+                from: color,
+                mid: color,
+                to: color,
+                light: `${color}22`,
+                text: color,
+                accent2: exports.INDUSTRY.accent2,
+                accent2Light: exports.INDUSTRY.accent2Light,
+                accent2Text: exports.INDUSTRY.accent2Text,
+            };
         }
     }
     return exports.ACCENT_PALETTES[0];
 }
+/** The secondary accent for a resolved palette, with an Industry fallback. */
+function accent2Of(p) {
+    return {
+        color: p.accent2 ?? exports.INDUSTRY.accent2,
+        light: p.accent2Light ?? exports.INDUSTRY.accent2Light,
+        text: p.accent2Text ?? exports.INDUSTRY.accent2Text,
+    };
+}
 /**
  * Rotate the palette list so it starts at the resolved accent (used by
- * ERDiagram to color multiple entities while still honoring --color for the
- * first/primary entity).
+ * ERDiagram / RelationalDiagram to color multiple entities while still honoring
+ * --color for the first/primary entity).
  */
 function rotatedPalettes(color) {
     if (!color)
@@ -60,25 +167,27 @@ function rotatedPalettes(color) {
         return exports.ACCENT_PALETTES;
     return [...exports.ACCENT_PALETTES.slice(idx), ...exports.ACCENT_PALETTES.slice(0, idx)];
 }
+// Industry light theme — the ground/surface/card/hairline blueprint.
 const LIGHT_THEME = {
-    canvasBg: '#EFF6FF',
-    cardBg: '#FFFFFF',
-    rowAlt: '#F8FAFC',
-    colHeaderBg: '#F1F5F9',
-    textPrimary: '#1E293B',
-    textSecondary: '#64748B',
-    border: '#E2E8F0',
-    footerBg: '#1E293B',
+    canvasBg: exports.INDUSTRY.ground,
+    cardBg: exports.INDUSTRY.card,
+    rowAlt: exports.INDUSTRY.neutral[100],
+    colHeaderBg: exports.INDUSTRY.surface,
+    textPrimary: exports.INDUSTRY.text,
+    textSecondary: exports.INDUSTRY.muted,
+    border: exports.INDUSTRY.divider,
+    footerBg: exports.INDUSTRY.surface,
 };
+// Industry dark theme — same blueprint reasoning, inverted onto neutral-900.
 const DARK_THEME = {
-    canvasBg: '#0B1120',
-    cardBg: '#1E293B',
-    rowAlt: '#26374B',
-    colHeaderBg: '#111827',
-    textPrimary: '#F1F5F9',
-    textSecondary: '#94A3B8',
-    border: '#334155',
-    footerBg: '#020617',
+    canvasBg: '#1d1f20',
+    cardBg: '#2b2b2d',
+    rowAlt: '#242426',
+    colHeaderBg: '#242426',
+    textPrimary: '#f5f5f8',
+    textSecondary: '#b7b7ba',
+    border: 'rgba(245,245,248,0.18)',
+    footerBg: '#242426',
 };
 function resolveTheme(theme) {
     return theme === 'dark' ? DARK_THEME : LIGHT_THEME;

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

@@ -0,0 +1,82 @@
+/**
+ * RelationalDiagram — renders a relational schema as entity boxes with their
+ * columns and draws connectors between related tables using proper crow's-foot
+ * cardinality notation.
+ *
+ * Each entity is a box listing its columns; primary-key columns are marked and
+ * underlined, foreign-key columns are marked. Relationship connectors terminate
+ * with crow's-foot endpoints:
+ *   - "one"       → a small perpendicular tick (single bar)
+ *   - "many"      → the three-pronged crow's foot
+ *   - "optional"  → a small circle just outside the endpoint (zero cardinality)
+ *
+ * Supported relationship types: one-to-one, one-to-many, many-to-one,
+ * many-to-many. Entities are laid out on a grid and connectors are routed
+ * between the nearest entity edges.
+ *
+ * Everything is built against a real DOM document via the shared `SvgDocument`
+ * / `El` builder — never by concatenating markup strings — and the viewBox is
+ * auto-sized to the content. Both `theme` and `color` change real fill/stroke
+ * values in the output (via `resolveTheme` / `resolveAccent`).
+ *
+ * Usage:
+ *   const rel = new RelationalDiagram({
+ *     title: 'Shop Schema',
+ *     entities: [ …RelEntity ],
+ *     relationships: [ …RelRelationship ],
+ *   });
+ *   rel.save('./diagrams/schema.svg');
+ *   // or: const svg = rel.generate();
+ */
+export interface RelColumn {
+    name: string;
+    type?: string;
+    primaryKey?: boolean;
+    foreignKey?: boolean;
+}
+export interface RelEntity {
+    name: string;
+    columns: RelColumn[];
+}
+export type RelRelationshipType = 'one-to-one' | 'one-to-many' | 'many-to-one' | 'many-to-many';
+export interface RelRelationship {
+    from: string;
+    to: string;
+    type: RelRelationshipType;
+    label?: string;
+}
+export interface RelationalDiagramOptions {
+    entities: RelEntity[];
+    relationships?: RelRelationship[];
+    title?: string;
+    theme?: 'light' | 'dark';
+    color?: string;
+    /** Number of entity columns in the layout grid. @default 3 */
+    columns?: number;
+}
+export declare class RelationalDiagram {
+    private opts;
+    private static readonly BOX_W;
+    private static readonly HDR_H;
+    private static readonly ROW_H;
+    private static readonly BOX_MIN_H;
+    private static readonly BANNER_H;
+    private static readonly MARGIN;
+    private static readonly H_GAP;
+    private static readonly V_GAP;
+    constructor(options: RelationalDiagramOptions);
+    private boxHeight;
+    private computeLayout;
+    private renderBox;
+    private edgePoint;
+    private chooseSides;
+    private crowFoot;
+    private oneBar;
+    private renderRelationship;
+    generate(): string;
+    /**
+     * Write the SVG to a file, creating parent directories as needed.
+     * Returns the resolved absolute path.
+     */
+    save(outputPath: string): string;
+}