modern-document 0.1.0

package/brands/default/brand.json

@@ -0,0 +1,21 @@
+{
+  "name": "Modern Document",
+  "tagline": "Dokumenty, které stojí za přečtení.",
+  "web": "moderndocument.app",
+  "email": "hello@moderndocument.app",
+  "colors": {
+    "primary": "#0F0F0F",
+    "accent": "#2563EB",
+    "muted": "#868B93",
+    "surface": "#F6F6F8"
+  },
+  "fonts": {
+    "heading": "Georgia, serif",
+    "body": "-apple-system, 'Segoe UI', 'Helvetica Neue', Arial, sans-serif"
+  },
+  "style": "modern",
+  "footer": {
+    "showContact": true,
+    "note": ""
+  }
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "modern-document",
+  "version": "0.1.0",
+  "description": "Markdown → branded HTML/PDF documents. CLI, MCP server, and web app.",
+  "type": "module",
+  "main": "src/core/index.js",
+  "exports": {
+    ".": "./src/core/index.js",
+    "./mcp": "./src/mcp/server.js"
+  },
+  "bin": {
+    "moddoc": "src/cli/index.js"
+  },
+  "files": [
+    "src/core/",
+    "src/mcp/",
+    "src/cli/",
+    "brands/"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "mcp": "node src/mcp/server.js"
+  },
+  "keywords": [
+    "markdown",
+    "document",
+    "pdf",
+    "html",
+    "brand",
+    "mcp",
+    "mcp-server",
+    "claude",
+    "proposal",
+    "invoice"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.4"
+  },
+  "optionalDependencies": {
+    "puppeteer": "^24.0.0"
+  },
+  "devDependencies": {
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "@vitejs/plugin-react": "^4.5.2",
+    "vite": "^6.3.5"
+  }
+}

package/src/cli/index.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+import { readFile, writeFile } from "node:fs/promises";
+import { resolve, extname, basename } from "node:path";
+import { build, mergeBrand, loadBrand, listComponents, exportPdf } from "../core/index.js";
+
+const args = process.argv.slice(2);
+const cmd = args[0];
+
+function flag(name) {
+  const i = args.indexOf(name);
+  if (i === -1) return null;
+  return args[i + 1] || true;
+}
+
+function usage() {
+  console.log(`
+  moddoc — Modern Document CLI
+
+  Usage:
+    moddoc build <file.md>           Build HTML from markdown
+    moddoc pdf <file.html>           Convert HTML to PDF
+    moddoc pipe <file.md>            Full pipeline: MD → HTML + PDF
+    moddoc components                List available components
+    moddoc styles                    List available style presets
+    moddoc mcp                       Start MCP server (for Claude Code)
+
+  Options:
+    -o <path>        Output file path
+    --brand <path>   Path to brand.json
+    --style <name>   Style preset: modern | formal | minimal | executive | creative | technical | invoice | compact
+    --title <text>   Document title
+  `);
+}
+
+async function getBrand() {
+  const brandPath = flag("--brand");
+  const style = flag("--style");
+  if (brandPath) {
+    const b = await loadBrand(resolve(brandPath));
+    if (style) b.style = style;
+    return b;
+  }
+  return mergeBrand(style ? { style } : {});
+}
+
+async function main() {
+  if (!cmd || cmd === "--help" || cmd === "-h") {
+    usage();
+    process.exit(0);
+  }
+
+  if (cmd === "build") {
+    const input = args[1];
+    if (!input) { console.error("Error: specify input file"); process.exit(1); }
+    const md = await readFile(resolve(input), "utf-8");
+    const brand = await getBrand();
+    const title = flag("--title");
+    const html = build(md, brand, { title });
+    const out = flag("-o") || input.replace(extname(input), ".html");
+    await writeFile(resolve(out), html, "utf-8");
+    console.log(`✓ ${out} (${(Buffer.byteLength(html, "utf-8") / 1024).toFixed(1)} KB)`);
+  }
+
+  else if (cmd === "pdf") {
+    const input = args[1];
+    if (!input) { console.error("Error: specify input HTML file"); process.exit(1); }
+    const html = await readFile(resolve(input), "utf-8");
+    const out = flag("-o") || input.replace(extname(input), ".pdf");
+    await exportPdf(html, resolve(out));
+    console.log(`✓ ${out}`);
+  }
+
+  else if (cmd === "pipe") {
+    const input = args[1];
+    if (!input) { console.error("Error: specify input file"); process.exit(1); }
+    const md = await readFile(resolve(input), "utf-8");
+    const brand = await getBrand();
+    const title = flag("--title");
+    const html = build(md, brand, { title });
+    const base = basename(input, extname(input));
+    const htmlOut = flag("-o") || `${base}.html`;
+    const pdfOut = htmlOut.replace(extname(htmlOut), ".pdf");
+    await writeFile(resolve(htmlOut), html, "utf-8");
+    console.log(`✓ ${htmlOut} (${(Buffer.byteLength(html, "utf-8") / 1024).toFixed(1)} KB)`);
+    await exportPdf(html, resolve(pdfOut));
+    console.log(`✓ ${pdfOut}`);
+  }
+
+  else if (cmd === "components") {
+    const components = listComponents();
+    for (const c of components) {
+      console.log(`\n${c.name} — ${c.description}`);
+      console.log(`  Variants: ${c.variants.join(", ")}`);
+      console.log(`  Example:  ${c.example}`);
+    }
+  }
+
+  else if (cmd === "styles") {
+    const { STYLE_PRESETS } = await import("../core/build.js");
+    for (const [key, s] of Object.entries(STYLE_PRESETS)) {
+      console.log(`  ${key.padEnd(12)} ${s.label} — ${s.desc}`);
+    }
+  }
+
+  else if (cmd === "mcp") {
+    await import("../mcp/server.js");
+  }
+
+  else {
+    console.error(`Unknown command: ${cmd}`);
+    usage();
+    process.exit(1);
+  }
+}
+
+main().catch((err) => {
+  console.error(err.message);
+  process.exit(1);
+});

package/src/core/brand.js

@@ -0,0 +1,53 @@
+export const DEFAULT_BRAND = {
+  name: "Modern Document",
+  tagline: "Dokumenty, které stojí za přečtení.",
+  web: "moderndocument.app",
+  email: "hello@moderndocument.app",
+  logo: null,
+  icon: null,
+  colors: {
+    primary: "#0F0F0F",
+    accent: "#2563EB",
+    muted: "#868B93",
+    surface: "#F6F6F8",
+  },
+  fonts: {
+    heading: "Georgia, serif",
+    body: "-apple-system, 'Segoe UI', 'Helvetica Neue', Arial, sans-serif",
+  },
+  style: "modern",
+  footer: {
+    showContact: true,
+    note: "",
+  },
+};
+
+export function mergeBrand(custom = {}) {
+  return {
+    ...DEFAULT_BRAND,
+    ...custom,
+    colors: { ...DEFAULT_BRAND.colors, ...custom.colors },
+    fonts: { ...DEFAULT_BRAND.fonts, ...custom.fonts },
+    footer: { ...DEFAULT_BRAND.footer, ...custom.footer },
+  };
+}
+
+export async function loadBrand(brandPath) {
+  const { readFile } = await import("node:fs/promises");
+  const { resolve, dirname } = await import("node:path");
+  const raw = JSON.parse(await readFile(brandPath, "utf-8"));
+
+  const brandDir = dirname(resolve(brandPath));
+
+  for (const key of ["logo", "icon"]) {
+    if (raw[key] && !raw[key].startsWith("data:")) {
+      const filePath = resolve(brandDir, raw[key]);
+      const buf = await readFile(filePath);
+      const ext = filePath.split(".").pop().toLowerCase();
+      const mime = ext === "svg" ? "image/svg+xml" : `image/${ext}`;
+      raw[key] = `data:${mime};base64,${buf.toString("base64")}`;
+    }
+  }
+
+  return mergeBrand(raw);
+}

package/src/core/build.js

@@ -0,0 +1,318 @@
+import { parseMd } from "./markdown.js";
+
+// ─── Style presets ───
+// Styles define LAYOUT PERSONALITY only (sizes, weights, spacing, density).
+// They never override brand colors/fonts — those always flow through CSS vars.
+const STYLE_PRESETS = {
+  // ── General document styles ──
+  modern: {
+    label: "Moderní",
+    desc: "Vzdušný, velké lehké nadpisy. Pro nabídky a prezentace.",
+    h1Size: "2.75rem", h1Weight: "400", h1Spacing: "-0.025em",
+    h2Size: "1.75rem", h2Weight: "400", h2Border: "line", h2Accent: false,
+    h3Size: "1.0625rem", h4Style: "uppercase",
+    bodySize: "0.9375rem", lineHeight: "1.75",
+    tableStyle: "minimal", boxRadius: "8px",
+    coverStyle: "center", headerStyle: "border",
+    sectionSpacing: "3rem", componentSpacing: "1.5rem",
+  },
+  formal: {
+    label: "Formální",
+    desc: "Konzervativní, kompaktní. Smlouvy, právní dokumenty.",
+    h1Size: "2.25rem", h1Weight: "400", h1Spacing: "-0.01em",
+    h2Size: "1.5rem", h2Weight: "400", h2Border: "line", h2Accent: false,
+    h3Size: "1rem", h4Style: "uppercase",
+    bodySize: "0.875rem", lineHeight: "1.7",
+    tableStyle: "bordered", boxRadius: "4px",
+    coverStyle: "top", headerStyle: "border",
+    sectionSpacing: "2.5rem", componentSpacing: "1.25rem",
+  },
+  minimal: {
+    label: "Minimální",
+    desc: "Čistý, tučné nadpisy, max whitespace. Reporty, tech docs.",
+    h1Size: "2rem", h1Weight: "600", h1Spacing: "-0.02em",
+    h2Size: "1.375rem", h2Weight: "600", h2Border: "none", h2Accent: false,
+    h3Size: "1.0625rem", h4Style: "normal",
+    bodySize: "0.9375rem", lineHeight: "1.8",
+    tableStyle: "clean", boxRadius: "6px",
+    coverStyle: "center", headerStyle: "clean",
+    sectionSpacing: "3rem", componentSpacing: "1.5rem",
+  },
+  executive: {
+    label: "Executive",
+    desc: "Autoritativní, accent linky. Board reporty, C-level.",
+    h1Size: "2.5rem", h1Weight: "700", h1Spacing: "-0.02em",
+    h2Size: "1.5rem", h2Weight: "600", h2Border: "accent", h2Accent: true,
+    h3Size: "1.0625rem", h4Style: "uppercase",
+    bodySize: "0.9375rem", lineHeight: "1.7",
+    tableStyle: "bordered", boxRadius: "6px",
+    coverStyle: "hero", headerStyle: "border",
+    sectionSpacing: "3rem", componentSpacing: "1.5rem",
+  },
+  creative: {
+    label: "Kreativní",
+    desc: "Výrazný, velký kontrast. Agenturní nabídky, portfolio.",
+    h1Size: "3.25rem", h1Weight: "800", h1Spacing: "-0.03em",
+    h2Size: "1.875rem", h2Weight: "700", h2Border: "none", h2Accent: true,
+    h3Size: "1.125rem", h4Style: "uppercase",
+    bodySize: "1rem", lineHeight: "1.75",
+    tableStyle: "clean", boxRadius: "12px",
+    coverStyle: "hero", headerStyle: "clean",
+    sectionSpacing: "3.5rem", componentSpacing: "2rem",
+  },
+  technical: {
+    label: "Technický",
+    desc: "Data-dense, monospace akcenty. Analýzy, audity, API docs.",
+    h1Size: "1.875rem", h1Weight: "600", h1Spacing: "-0.01em",
+    h2Size: "1.375rem", h2Weight: "600", h2Border: "line", h2Accent: false,
+    h3Size: "1rem", h4Style: "mono",
+    bodySize: "0.875rem", lineHeight: "1.65",
+    tableStyle: "bordered", boxRadius: "4px",
+    coverStyle: "top", headerStyle: "border",
+    sectionSpacing: "2rem", componentSpacing: "1rem",
+  },
+
+  // ── Specialized document styles ──
+  invoice: {
+    label: "Faktura",
+    desc: "Specifický layout pro faktury — from/to, line items, totals.",
+    h1Size: "2rem", h1Weight: "700", h1Spacing: "-0.01em",
+    h2Size: "1.25rem", h2Weight: "600", h2Border: "none", h2Accent: false,
+    h3Size: "1rem", h4Style: "uppercase",
+    bodySize: "0.875rem", lineHeight: "1.6",
+    tableStyle: "invoice", boxRadius: "4px",
+    coverStyle: "none", headerStyle: "invoice",
+    sectionSpacing: "2rem", componentSpacing: "1rem",
+  },
+  compact: {
+    label: "Kompaktní",
+    desc: "Max obsahu na stránku. SOW, smlouvy, detailní specifikace.",
+    h1Size: "1.75rem", h1Weight: "600", h1Spacing: "-0.01em",
+    h2Size: "1.25rem", h2Weight: "600", h2Border: "line", h2Accent: false,
+    h3Size: "0.9375rem", h4Style: "normal",
+    bodySize: "0.8125rem", lineHeight: "1.6",
+    tableStyle: "bordered", boxRadius: "4px",
+    coverStyle: "none", headerStyle: "border",
+    sectionSpacing: "1.75rem", componentSpacing: "0.75rem",
+  },
+};
+
+export { STYLE_PRESETS };
+
+// ─── Table CSS variants ───
+function tableCSS(style) {
+  if (style === "bordered")
+    return `table{border:1px solid var(--border)} thead th{border-bottom:2px solid var(--primary);background:var(--surface);padding:0.625rem 1rem} tbody td{padding:0.625rem 1rem;border-bottom:1px solid var(--border)}`;
+  if (style === "clean")
+    return `thead th{border-bottom:1px solid var(--border-strong);padding:0 1rem 0.5rem 0;font-weight:600;text-transform:none;letter-spacing:0;font-size:0.8125rem;color:var(--primary)} tbody td{padding:0.625rem 1rem 0.625rem 0;border-bottom:1px solid var(--border)}`;
+  if (style === "invoice")
+    return `table{border:1px solid var(--border);border-radius:4px;overflow:hidden} thead th{background:var(--primary);color:#fff;padding:0.625rem 1rem;font-size:0.75rem;font-weight:600;letter-spacing:0.04em;text-transform:uppercase;text-align:left} thead th:last-child{text-align:right} tbody td{padding:0.625rem 1rem;border-bottom:1px solid var(--border);font-size:0.8125rem} tbody td:last-child{text-align:right;font-weight:600;font-variant-numeric:tabular-nums} tbody tr:last-child td{border-bottom:none}`;
+  // minimal (default)
+  return `thead th{font-weight:700;text-align:left;color:var(--text-light);font-size:0.6875rem;letter-spacing:0.08em;text-transform:uppercase;padding:0 1rem 0.75rem 0;border-bottom:2px solid var(--primary)} tbody td{padding:0.75rem 1rem 0.75rem 0;border-bottom:1px solid var(--border)} tbody tr:last-child td{border-bottom:2px solid var(--primary)}`;
+}
+
+// ─── Style-specific CSS overrides ───
+function styleCSS(s) {
+  let css = "";
+
+  // h2 accent bar (short colored line instead of full border)
+  if (s.h2Accent) {
+    css += `h2::before{content:"";display:block;width:40px;height:3px;background:var(--accent);margin-bottom:0.75rem;border-radius:2px}`;
+  }
+
+  // h4 mono style for technical preset
+  if (s.h4Style === "mono") {
+    css += `h4{font-family:var(--mono, 'SF Mono', Consolas, monospace);font-size:0.75rem;font-weight:600;letter-spacing:0.02em;text-transform:none;color:var(--accent);margin:1.5rem 0 0.5rem}`;
+  } else if (s.h4Style === "normal") {
+    css += `h4{font-family:var(--body);font-size:0.8125rem;font-weight:600;letter-spacing:0;text-transform:none;color:var(--primary);margin:1.5rem 0 0.5rem}`;
+  }
+
+  // Cover hero style (colored background block)
+  if (s.coverStyle === "hero") {
+    css += `.cover{background:var(--primary);color:#fff;border-radius:${s.boxRadius};padding:3rem 2.5rem;margin:-3rem -2rem 2.5rem;min-height:50vh;display:flex;flex-direction:column;justify-content:center}
+.cover h1,.cover h2,.cover h3,.cover h4,.cover p,.cover strong{color:#fff}
+.cover p{opacity:0.85}`;
+  }
+
+  // Header clean (no border)
+  if (s.headerStyle === "clean") {
+    css += `.doc-header{border-bottom:none;padding-bottom:0.5rem}`;
+  }
+
+  // Invoice-specific components
+  if (s.headerStyle === "invoice") {
+    css += `.doc-header{display:flex;justify-content:space-between;align-items:flex-start;border-bottom:none;padding-bottom:1.5rem;margin-bottom:1.5rem}
+.invoice-label{font-family:var(--heading);font-size:2.5rem;font-weight:700;color:var(--primary);letter-spacing:-0.02em;text-transform:uppercase;line-height:1}
+.invoice-meta{text-align:right}
+.invoice-meta .kv-row{justify-content:flex-end;gap:1rem;border:none;padding:0.2rem 0}
+.invoice-parties{display:grid;grid-template-columns:1fr 1fr;gap:2rem;margin:0 0 2rem}
+.invoice-party h4{margin-top:0}
+.invoice-total{display:flex;justify-content:flex-end;margin:1.5rem 0}
+.invoice-total-box{background:var(--surface);border-radius:${s.boxRadius};padding:1rem 1.5rem;min-width:250px}
+.invoice-total-box .kv-row{border-color:var(--border)}
+.invoice-total-box .kv-row:last-child{border-bottom:none;font-size:1.25rem;padding-top:0.75rem;margin-top:0.25rem;border-top:2px solid var(--primary)}
+.invoice-total-box .kv-row:last-child .kv-val{font-size:1.25rem}
+.invoice-payment{background:var(--surface);border-radius:${s.boxRadius};padding:1.25rem 1.5rem;margin:2rem 0}`;
+  }
+
+  return css;
+}
+
+// ─── Base component CSS ───
+function componentCSS(s) {
+  const r = s.boxRadius;
+  const cs = s.componentSpacing;
+  return `
+.box{background:var(--surface);border-radius:${r};padding:1.25rem 1.5rem;margin:${cs} 0}
+.box-dark{background:var(--primary);color:#fff;border-radius:${r};padding:1.25rem 1.5rem;margin:${cs} 0}
+.box-dark h3,.box-dark h4,.box-dark strong{color:#fff}
+.box-outline{border:1.5px solid var(--border);border-radius:${r};padding:1.25rem 1.5rem;margin:${cs} 0}
+.box-accent{border-left:3px solid var(--accent);padding:1rem 1.5rem;margin:${cs} 0;background:var(--surface)}
+.note{font-size:0.8125rem;color:var(--muted);border-left:2px solid var(--border);padding:0.5rem 1rem;margin:1rem 0}
+.note-important{border-left-color:var(--accent);color:var(--text)}
+.kv{margin:${cs} 0}
+.kv-row{display:flex;justify-content:space-between;padding:0.5rem 0;border-bottom:1px solid var(--border);font-size:0.875rem}
+.kv-key{color:var(--muted)}.kv-val{font-weight:600;color:var(--primary)}
+.metrics{display:grid;grid-template-columns:repeat(auto-fit,minmax(120px,1fr));gap:1.5rem;margin:2rem 0}
+.metric{text-align:center}
+.metric-value{font-family:var(--heading);font-size:2.5rem;font-weight:700;color:var(--primary);line-height:1.1}
+.metric-label{font-size:0.75rem;color:var(--muted);margin-top:0.25rem;text-transform:uppercase;letter-spacing:0.06em}
+.stats-row{display:flex;gap:2rem;margin:${cs} 0}
+.stat{text-align:center;flex:1}
+.progress{margin:${cs} 0}
+.progress-row{margin-bottom:0.75rem}
+.progress-row label{display:flex;justify-content:space-between;font-size:0.8125rem;margin-bottom:0.25rem}
+.progress-bar{height:6px;background:var(--surface);border-radius:3px;overflow:hidden}
+.progress-fill{height:100%;background:var(--accent);border-radius:3px}
+.timeline{position:relative;padding-left:2rem;margin:2rem 0}
+.timeline::before{content:"";position:absolute;left:0;top:0;bottom:0;width:2px;background:var(--border)}
+.timeline-item{position:relative;margin-bottom:2rem}
+.timeline-item::before{content:"";position:absolute;left:-2rem;top:0.3rem;width:10px;height:10px;border-radius:50%;background:var(--accent);border:2px solid var(--bg)}
+.timeline-date{font-size:0.75rem;color:var(--muted);margin-bottom:0.25rem;text-transform:uppercase;letter-spacing:0.06em}
+.steps{counter-reset:step;margin:2rem 0}
+.step{display:flex;gap:1rem;margin-bottom:1.5rem;align-items:flex-start}
+.step-num{width:32px;height:32px;border-radius:50%;background:var(--primary);color:#fff;display:flex;align-items:center;justify-content:center;font-size:0.8125rem;font-weight:700;flex-shrink:0}
+.step-content{flex:1}
+.cols{display:grid;gap:2rem;margin:${cs} 0}
+.cols-2{grid-template-columns:1fr 1fr}
+.cols-3{grid-template-columns:1fr 1fr 1fr}
+.cols-60-40{grid-template-columns:3fr 2fr}
+.comparison{display:grid;grid-template-columns:1fr 1fr;gap:0;margin:2rem 0;border:1px solid var(--border);border-radius:${r};overflow:hidden}
+.comp-a,.comp-b{padding:1.25rem 1.5rem}
+.comp-a{border-right:1px solid var(--border)}
+ul.checklist{list-style:none;padding-left:0}
+ul.checklist li{padding-left:1.75rem;position:relative;margin-bottom:0.5rem}
+ul.checklist li::before{content:"☐";position:absolute;left:0;color:var(--muted)}
+ul.checklist li.done::before{content:"☑";color:var(--accent)}
+.badge{display:inline-block;font-size:0.6875rem;font-weight:600;padding:0.2rem 0.6rem;border-radius:4px;text-transform:uppercase;letter-spacing:0.04em;background:var(--surface);color:var(--muted)}
+.badge-success{background:#E8F5E9;color:#2E7D32}
+.badge-warning{background:#FFF8E1;color:#F57F17}
+.badge-danger{background:#FFEBEE;color:#C62828}
+.cover{min-height:60vh;display:flex;flex-direction:column;justify-content:center;padding:3rem 0;margin-bottom:2rem}
+.page-break{break-after:page;height:0;margin:0;border:none}
+.divider-logo{text-align:center;margin:${s.sectionSpacing} 0;opacity:0.15}
+.divider-logo img{height:24px}
+.pull-quote{font-family:var(--heading);font-size:1.5rem;font-weight:400;line-height:1.4;color:var(--primary);border:none;padding:2rem 0;margin:2rem 0;text-align:center;font-style:italic}
+.signatures{display:flex;gap:3rem;margin:3rem 0}
+.sig{flex:1;text-align:center}
+.sig-line{border-top:1px solid var(--primary);margin-bottom:0.5rem;margin-top:3rem}
+.sig-name{font-size:0.8125rem;font-weight:600}
+.doc-figure{margin:2rem 0;text-align:center}
+.doc-figure img{max-width:100%;height:auto;border-radius:6px;display:block;margin:0 auto}
+.doc-figure figcaption{font-size:0.75rem;color:var(--muted);margin-top:0.5rem;font-style:italic}
+.doc-img-inline{max-height:1.5em;vertical-align:middle;display:inline}
+.doc-img-full{width:100%;height:auto;border-radius:6px;margin:${cs} 0}
+.doc-img-half{width:50%;height:auto;border-radius:6px;margin:1rem}
+.doc-img-float-left{float:left;max-width:40%;margin:0.5rem 1.5rem 1rem 0;border-radius:6px}
+.doc-img-float-right{float:right;max-width:40%;margin:0.5rem 0 1rem 1.5rem;border-radius:6px}
+.doc-gallery{display:grid;grid-template-columns:repeat(auto-fit,minmax(200px,1fr));gap:0.75rem;margin:2rem 0}
+.doc-gallery img{width:100%;height:auto;border-radius:6px;object-fit:cover;aspect-ratio:4/3}
+.doc-nav{position:sticky;top:0;z-index:10;background:var(--bg);border-bottom:1px solid var(--border);padding:0.75rem 0;margin-bottom:2rem}
+@media(max-width:600px){.cols-2,.cols-3,.cols-60-40{grid-template-columns:1fr}.comparison{grid-template-columns:1fr}.comp-a{border-right:none;border-bottom:1px solid var(--border)}.signatures{flex-direction:column;gap:1.5rem}}
+@media print{.doc-nav{display:none}.cover{min-height:auto;page-break-after:always}.page-break{break-after:page}.box,.box-dark,.box-outline,.box-accent,.note,.kv,.metrics,.timeline-item,.step,.comparison,.doc-figure{break-inside:avoid}.doc-figure img{max-height:40vh}.doc-img-float-left,.doc-img-float-right{float:none;max-width:60%;margin:1rem auto;display:block}}
+`;
+}
+
+// ─── Build HTML ───
+export function build(content, brand, { title, isHtml = false } = {}) {
+  const body = isHtml ? content : parseMd(content);
+  const s = STYLE_PRESETS[brand.style] || STYLE_PRESETS.modern;
+  const c = brand.colors;
+  const f = brand.fonts;
+
+  const logo = brand.logo
+    ? `<div class="doc-header"><img src="${brand.logo}" alt="${brand.name}" class="doc-logo"/></div>`
+    : brand.name
+      ? `<div class="doc-header"><div class="doc-logo-text">${brand.name}</div>${brand.tagline ? `<div class="doc-tagline">${brand.tagline}</div>` : ""}</div>`
+      : "";
+
+  const footerParts = [];
+  if (brand.name) footerParts.push(brand.name);
+  if (brand.footer?.showContact && brand.web) footerParts.push(brand.web);
+  if (brand.footer?.showContact && brand.email) footerParts.push(brand.email);
+  const footerIcon = brand.icon
+    ? `<img src="${brand.icon}" alt="" class="doc-footer-icon"/>`
+    : "";
+  const footerNote = brand.footer?.note
+    ? `<div class="doc-footer-note">${brand.footer.note}</div>`
+    : "";
+  const footer = footerParts.length
+    ? `<footer class="doc-footer">${footerIcon}<div class="doc-footer-meta">${footerParts.join(" · ")}</div>${footerNote}</footer>`
+    : "";
+
+  // h2 border style
+  let h2BorderCSS = "";
+  if (s.h2Border === "line") h2BorderCSS = `padding-top:2rem;border-top:1px solid var(--border);`;
+  else if (s.h2Border === "accent") h2BorderCSS = `padding-top:2rem;`;
+
+  return `<!DOCTYPE html>
+<html lang="cs">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>${title || brand.name || "Dokument"}</title>
+<style>
+*,*::before,*::after{margin:0;padding:0;box-sizing:border-box}
+:root{--primary:${c.primary};--accent:${c.accent};--muted:${c.muted};--surface:${c.surface};--bg:#FFFFFF;--border:#E8E8ED;--border-strong:#D2D2D7;--text:#2C2C2E;--text-light:#636366;--heading:${f.heading};--body:${f.body}}
+html{font-size:16px;-webkit-font-smoothing:antialiased;text-rendering:optimizeLegibility}
+body{font-family:var(--body);font-size:${s.bodySize};font-weight:400;line-height:${s.lineHeight};color:var(--text);background:var(--bg);max-width:720px;margin:0 auto;padding:3rem 2rem 4rem}
+.doc-header{margin-bottom:2.5rem;padding-bottom:1.75rem;border-bottom:1px solid var(--border)}
+.doc-logo{max-height:40px;width:auto;display:block}
+.doc-logo-text{font-family:var(--heading);font-size:1.25rem;font-weight:700;color:var(--primary);letter-spacing:-0.01em}
+.doc-tagline{font-size:0.8125rem;color:var(--muted);margin-top:0.25rem}
+h1{font-family:var(--heading);font-size:${s.h1Size};font-weight:${s.h1Weight};line-height:1.1;letter-spacing:${s.h1Spacing};color:var(--primary);margin-bottom:1.5rem}
+h2{font-family:var(--heading);font-size:${s.h2Size};font-weight:${s.h2Weight};line-height:1.2;letter-spacing:-0.01em;color:var(--primary);margin:${s.sectionSpacing} 0 1.25rem;${h2BorderCSS}}
+h2:first-child,h1+h2{border-top:none;padding-top:0}
+h2:first-child::before{display:none}
+h3{font-family:var(--body);font-size:${s.h3Size};font-weight:600;line-height:1.35;color:var(--primary);margin:2rem 0 0.625rem}
+h4{font-family:var(--body);font-size:0.75rem;font-weight:700;letter-spacing:0.12em;text-transform:uppercase;color:var(--muted);margin:1.5rem 0 0.5rem}
+p{margin-bottom:1rem} strong{font-weight:600;color:var(--primary)} em{font-style:italic}
+a{color:var(--accent);text-decoration:underline;text-underline-offset:3px;text-decoration-thickness:1px}
+hr{border:none;height:1px;background:var(--border);margin:${s.sectionSpacing} 0}
+ul,ol{margin:0 0 1rem;padding-left:1.25rem} li{margin-bottom:0.5rem;line-height:1.65} li::marker{color:var(--muted)}
+table{width:100%;border-collapse:collapse;margin:${s.componentSpacing} 0 2rem;font-size:0.8125rem;line-height:1.5}
+${tableCSS(s.tableStyle)}
+${componentCSS(s)}
+${styleCSS(s)}
+.doc-footer{margin-top:4rem;padding-top:2rem;border-top:1px solid var(--border);text-align:center}
+.doc-footer-icon{height:20px;width:auto;margin-bottom:0.75rem;opacity:0.25}
+.doc-footer-meta{font-size:0.75rem;color:var(--muted);letter-spacing:0.02em}
+.doc-footer-note{font-size:0.6875rem;color:var(--muted);margin-top:0.5rem;opacity:0.7}
+@media print{
+  @page{size:A4;margin:20mm 18mm 22mm 18mm}
+  body{max-width:none;padding:0;font-size:10pt;line-height:1.6}
+  h1{font-size:26pt} h2{font-size:15pt;margin-top:1.5rem;padding-top:1rem;break-before:auto}
+  h2,h3,h4{break-after:avoid} table,blockquote{break-inside:avoid} tr{break-inside:avoid}
+  thead{display:table-header-group} p{orphans:3;widows:3} .doc-footer{break-inside:avoid}
+  a{text-decoration:none;color:var(--text)}
+  *{-webkit-print-color-adjust:exact;print-color-adjust:exact}
+}
+</style>
+</head>
+<body>
+${logo}
+${body}
+${footer}
+</body>
+</html>`;
+}

package/src/core/components.js

@@ -0,0 +1,146 @@
+export const COMPONENTS = [
+  {
+    name: "box",
+    description: "Zvýrazněný box s pozadím",
+    variants: ["box", "box-dark", "box-outline", "box-accent"],
+    example: '<div class="box"><h3>Titulek</h3><p>Obsah boxu</p></div>',
+  },
+  {
+    name: "note",
+    description: "Poznámka / upozornění",
+    variants: ["note", "note-important"],
+    example: '<div class="note"><p>Důležitá poznámka</p></div>',
+  },
+  {
+    name: "kv",
+    description: "Páry klíč–hodnota",
+    variants: ["kv"],
+    example:
+      '<div class="kv"><div class="kv-row"><span class="kv-key">Klient</span><span class="kv-val">ACME s.r.o.</span></div></div>',
+  },
+  {
+    name: "metrics",
+    description: "Velká čísla v gridu",
+    variants: ["metrics"],
+    example:
+      '<div class="metrics"><div class="metric"><div class="metric-value">42</div><div class="metric-label">Projektů</div></div></div>',
+  },
+  {
+    name: "timeline",
+    description: "Časová osa",
+    variants: ["timeline"],
+    example:
+      '<div class="timeline"><div class="timeline-item"><div class="timeline-date">Leden 2026</div><div class="timeline-content"><h4>Kick-off</h4><p>Zahájení projektu</p></div></div></div>',
+  },
+  {
+    name: "steps",
+    description: "Číslované kroky",
+    variants: ["steps"],
+    example:
+      '<div class="steps"><div class="step"><div class="step-num">1</div><div class="step-content"><h4>Analýza</h4><p>Zmapujeme potřeby</p></div></div></div>',
+  },
+  {
+    name: "columns",
+    description: "Vícesloupcový layout",
+    variants: ["cols cols-2", "cols cols-3", "cols cols-60-40"],
+    example:
+      '<div class="cols cols-2"><div>Levý sloupec</div><div>Pravý sloupec</div></div>',
+  },
+  {
+    name: "comparison",
+    description: "Porovnání dvou variant",
+    variants: ["comparison"],
+    example:
+      '<div class="comparison"><div class="comp-a"><h4>Varianta A</h4><p>Popis</p></div><div class="comp-b"><h4>Varianta B</h4><p>Popis</p></div></div>',
+  },
+  {
+    name: "badge",
+    description: "Status štítek",
+    variants: ["badge", "badge-success", "badge-warning", "badge-danger"],
+    example: '<span class="badge badge-success">Aktivní</span>',
+  },
+  {
+    name: "checklist",
+    description: "Seznam s checkboxy",
+    variants: ["checklist"],
+    example:
+      '<ul class="checklist"><li class="done">Hotovo</li><li>Zbývá</li></ul>',
+  },
+  {
+    name: "pull-quote",
+    description: "Velký citát",
+    variants: ["pull-quote"],
+    example:
+      '<blockquote class="pull-quote">Design is not how it looks, but how it works.</blockquote>',
+  },
+  {
+    name: "cover",
+    description: "Titulní strana dokumentu",
+    variants: ["cover"],
+    example:
+      '<div class="cover"><h1>Název dokumentu</h1><p>Podtitulek</p></div>',
+  },
+  {
+    name: "page-break",
+    description: "Zalomení stránky při tisku",
+    variants: ["page-break"],
+    example: '<div class="page-break"></div>',
+  },
+  {
+    name: "figure",
+    description: "Obrázek s volitelným popiskem (markdown syntaxe)",
+    variants: ["doc-figure"],
+    example: '![Popis obrázku](cesta/foto.jpg "Popisek pod obrázkem")',
+  },
+  {
+    name: "image-layout",
+    description: "CSS třídy pro pozicování obrázků",
+    variants: ["doc-img-full", "doc-img-half", "doc-img-float-left", "doc-img-float-right"],
+    example: '<img src="foto.jpg" class="doc-img-float-left" alt="Foto"/>',
+  },
+  {
+    name: "gallery",
+    description: "Grid galerie obrázků",
+    variants: ["doc-gallery"],
+    example: '<div class="doc-gallery"><img src="a.jpg" alt=""/><img src="b.jpg" alt=""/><img src="c.jpg" alt=""/></div>',
+  },
+  {
+    name: "signatures",
+    description: "Podpisové bloky",
+    variants: ["signatures"],
+    example:
+      '<div class="signatures"><div class="sig"><div class="sig-line"></div><div class="sig-name">Jan Novák</div></div></div>',
+  },
+  // ── Invoice-specific components ──
+  {
+    name: "invoice-label",
+    description: "Velký nápis FAKTURA (pro styl invoice)",
+    variants: ["invoice-label"],
+    example: '<div class="invoice-label">FAKTURA</div>',
+  },
+  {
+    name: "invoice-parties",
+    description: "Dva sloupce dodavatel/odběratel (pro styl invoice)",
+    variants: ["invoice-parties"],
+    example:
+      '<div class="invoice-parties"><div><h4>Dodavatel</h4><p><strong>Firma s.r.o.</strong><br>Ulice 123<br>Praha</p></div><div><h4>Odběratel</h4><p><strong>Klient a.s.</strong><br>Ulice 456<br>Brno</p></div></div>',
+  },
+  {
+    name: "invoice-total",
+    description: "Součet faktury — mezisoučet, DPH, celkem (pro styl invoice)",
+    variants: ["invoice-total", "invoice-total-box"],
+    example:
+      '<div class="invoice-total"><div class="invoice-total-box"><div class="kv"><div class="kv-row"><span class="kv-key">Mezisoučet</span><span class="kv-val">50 000 Kč</span></div><div class="kv-row"><span class="kv-key">DPH 21%</span><span class="kv-val">10 500 Kč</span></div><div class="kv-row"><span class="kv-key">Celkem</span><span class="kv-val">60 500 Kč</span></div></div></div></div>',
+  },
+  {
+    name: "invoice-payment",
+    description: "Platební údaje (pro styl invoice)",
+    variants: ["invoice-payment"],
+    example:
+      '<div class="invoice-payment"><h4>Platební údaje</h4><div class="kv"><div class="kv-row"><span class="kv-key">Banka</span><span class="kv-val">Fio banka</span></div><div class="kv-row"><span class="kv-key">Číslo účtu</span><span class="kv-val">1234567890/2010</span></div><div class="kv-row"><span class="kv-key">VS</span><span class="kv-val">20260001</span></div></div></div>',
+  },
+];
+
+export function listComponents() {
+  return COMPONENTS;
+}

package/src/core/index.js

@@ -0,0 +1,5 @@
+export { build, STYLE_PRESETS } from "./build.js";
+export { parseMd } from "./markdown.js";
+export { DEFAULT_BRAND, mergeBrand, loadBrand } from "./brand.js";
+export { COMPONENTS, listComponents } from "./components.js";
+export { exportPdf } from "./pdf.js";

package/src/core/markdown.js

@@ -0,0 +1,69 @@
+export function parseMd(md) {
+  return md
+    // Images: ![alt](src) and ![alt](src "caption")
+    .replace(
+      /^!\[([^\]]*)\]\(([^)\s]+)(?:\s+"([^"]*)")?\)\s*$/gm,
+      (_, alt, src, caption) => {
+        const img = `<img src="${src}" alt="${alt}" loading="lazy"/>`;
+        if (caption) {
+          return `<figure class="doc-figure">${img}<figcaption>${caption}</figcaption></figure>`;
+        }
+        return `<figure class="doc-figure">${img}</figure>`;
+      },
+    )
+    // Inline images (within text): ![alt](src)
+    .replace(
+      /!\[([^\]]*)\]\(([^)]+)\)/g,
+      (_, alt, src) => `<img src="${src}" alt="${alt}" class="doc-img-inline" loading="lazy"/>`,
+    )
+    // Tables
+    .replace(
+      /^(\|.+\|)\n(\|[-| :]+\|)\n((?:\|.+\|\n?)*)/gm,
+      (_, header, _sep, body) => {
+        const ths = header
+          .split("|")
+          .filter((c) => c.trim())
+          .map((c) => `<th>${c.trim()}</th>`)
+          .join("");
+        const rows = body
+          .trim()
+          .split("\n")
+          .map((row) => {
+            const cells = row
+              .split("|")
+              .filter((c) => c.trim())
+              .map((c) => {
+                const t = c.trim();
+                const bold = t.startsWith("**") && t.endsWith("**");
+                return `<td>${bold ? `<strong>${t.slice(2, -2)}</strong>` : t}</td>`;
+              })
+              .join("");
+            return `<tr>${cells}</tr>`;
+          })
+          .join("\n");
+        return `<table><thead><tr>${ths}</tr></thead><tbody>${rows}</tbody></table>`;
+      },
+    )
+    // Headings
+    .replace(/^#### (.+)$/gm, "<h4>$1</h4>")
+    .replace(/^### (.+)$/gm, "<h3>$1</h3>")
+    .replace(/^## (.+)$/gm, "<h2>$1</h2>")
+    .replace(/^# (.+)$/gm, "<h1>$1</h1>")
+    // Horizontal rule
+    .replace(/^---+$/gm, "<hr/>")
+    // Inline formatting
+    .replace(/\*\*\*(.+?)\*\*\*/g, "<strong><em>$1</em></strong>")
+    .replace(/\*\*(.+?)\*\*/g, "<strong>$1</strong>")
+    .replace(/\*(.+?)\*/g, "<em>$1</em>")
+    // Lists
+    .replace(/^(\d+)\. (.+)$/gm, "<oli>$2</oli>")
+    .replace(/^[-*] (.+)$/gm, "<uli>$1</uli>")
+    .replace(/((?:<uli>.+<\/uli>\n?)+)/g, (m) =>
+      `<ul>${m.replace(/<\/?uli>/g, (s) => (s === "<uli>" ? "<li>" : "</li>"))}</ul>`,
+    )
+    .replace(/((?:<oli>.+<\/oli>\n?)+)/g, (m) =>
+      `<ol>${m.replace(/<\/?oli>/g, (s) => (s === "<oli>" ? "<li>" : "</li>"))}</ol>`,
+    )
+    // Paragraphs (lines not starting with HTML tag)
+    .replace(/^(?!<[a-z/]|$)(.+)$/gm, "<p>$1</p>");
+}

package/src/core/pdf.js

@@ -0,0 +1,24 @@
+export async function exportPdf(html, outputPath, { format = "A4" } = {}) {
+  let puppeteer;
+  try {
+    puppeteer = await import("puppeteer");
+  } catch {
+    throw new Error(
+      "Puppeteer is required for PDF export. Install it: npm install puppeteer",
+    );
+  }
+
+  const browser = await puppeteer.default.launch({ headless: true });
+  try {
+    const page = await browser.newPage();
+    await page.setContent(html, { waitUntil: "networkidle0" });
+    await page.pdf({
+      path: outputPath,
+      format,
+      printBackground: true,
+      margin: { top: "20mm", right: "18mm", bottom: "22mm", left: "18mm" },
+    });
+  } finally {
+    await browser.close();
+  }
+}

package/src/mcp/server.js

@@ -0,0 +1,225 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { writeFile, readFile } from "node:fs/promises";
+import { resolve, dirname, basename, extname } from "node:path";
+import { build, mergeBrand, loadBrand, listComponents, exportPdf } from "../core/index.js";
+
+const server = new McpServer({
+  name: "modern-document",
+  version: "0.1.0",
+  description: "Build branded HTML/PDF documents from markdown",
+});
+
+// Load default brand from MODDOC_BRAND env var if set
+let defaultBrandConfig = null;
+if (process.env.MODDOC_BRAND) {
+  try {
+    defaultBrandConfig = await loadBrand(resolve(process.env.MODDOC_BRAND));
+  } catch (e) {
+    console.error(`Warning: Could not load brand from MODDOC_BRAND="${process.env.MODDOC_BRAND}": ${e.message}`);
+  }
+}
+
+// ─── build_document ───
+server.tool(
+  "build_document",
+  "Build a branded HTML document from markdown content. Returns the HTML and optionally saves to file.",
+  {
+    content: z.string().describe("Markdown or HTML content to render"),
+    title: z.string().optional().describe("Document title"),
+    brand: z.string().optional().describe("Path to brand.json file"),
+    brandOverrides: z
+      .object({
+        name: z.string().optional(),
+        tagline: z.string().optional(),
+        web: z.string().optional(),
+        email: z.string().optional(),
+        colors: z
+          .object({
+            primary: z.string().optional(),
+            accent: z.string().optional(),
+            muted: z.string().optional(),
+            surface: z.string().optional(),
+          })
+          .optional(),
+        fonts: z
+          .object({
+            heading: z.string().optional(),
+            body: z.string().optional(),
+          })
+          .optional(),
+        style: z.enum(["modern", "formal", "minimal", "executive", "creative", "technical", "invoice", "compact"]).optional(),
+      })
+      .optional()
+      .describe("Inline brand overrides"),
+    outputPath: z.string().optional().describe("Where to save the HTML file"),
+    isHtml: z
+      .boolean()
+      .optional()
+      .describe("Set to true if content is already HTML, not markdown"),
+  },
+  async ({ content, title, brand: brandPath, brandOverrides, outputPath, isHtml }) => {
+    let brandConfig;
+    if (brandPath) {
+      brandConfig = await loadBrand(resolve(brandPath));
+      if (brandOverrides) brandConfig = mergeBrand({ ...brandConfig, ...brandOverrides });
+    } else if (defaultBrandConfig) {
+      brandConfig = brandOverrides ? mergeBrand({ ...defaultBrandConfig, ...brandOverrides }) : defaultBrandConfig;
+    } else {
+      brandConfig = mergeBrand(brandOverrides);
+    }
+
+    const html = build(content, brandConfig, { title, isHtml });
+    const sizeKB = (Buffer.byteLength(html, "utf-8") / 1024).toFixed(1);
+
+    if (outputPath) {
+      const fullPath = resolve(outputPath);
+      await writeFile(fullPath, html, "utf-8");
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Document saved to ${fullPath} (${sizeKB} KB)\n\nThe HTML file is self-contained — it can be opened directly in any browser, sent via email/chat, or printed to PDF.`,
+          },
+        ],
+      };
+    }
+
+    return {
+      content: [{ type: "text", text: html }],
+    };
+  },
+);
+
+// ─── export_pdf ───
+server.tool(
+  "export_pdf",
+  "Convert an HTML document to A4 PDF using headless browser rendering.",
+  {
+    htmlPath: z.string().describe("Path to the HTML file to convert"),
+    outputPath: z.string().optional().describe("Where to save the PDF (default: same name .pdf)"),
+    format: z.enum(["A4", "Letter"]).optional().describe("Paper format"),
+  },
+  async ({ htmlPath, outputPath, format }) => {
+    const fullHtmlPath = resolve(htmlPath);
+    const html = await readFile(fullHtmlPath, "utf-8");
+    const pdfPath = outputPath
+      ? resolve(outputPath)
+      : fullHtmlPath.replace(extname(fullHtmlPath), ".pdf");
+
+    await exportPdf(html, pdfPath, { format: format || "A4" });
+
+    return {
+      content: [
+        {
+          type: "text",
+          text: `PDF saved to ${pdfPath}`,
+        },
+      ],
+    };
+  },
+);
+
+// ─── full_pipeline ───
+server.tool(
+  "full_pipeline",
+  "Complete pipeline: markdown → branded HTML → PDF in one step.",
+  {
+    content: z.string().describe("Markdown content"),
+    title: z.string().optional().describe("Document title"),
+    brand: z.string().optional().describe("Path to brand.json"),
+    brandOverrides: z
+      .object({
+        name: z.string().optional(),
+        colors: z
+          .object({
+            primary: z.string().optional(),
+            accent: z.string().optional(),
+          })
+          .optional(),
+        style: z.enum(["modern", "formal", "minimal", "executive", "creative", "technical", "invoice", "compact"]).optional(),
+      })
+      .optional(),
+    outputDir: z.string().optional().describe("Output directory (default: current)"),
+    filename: z.string().optional().describe("Base filename without extension"),
+    formats: z
+      .array(z.enum(["html", "pdf"]))
+      .optional()
+      .describe("Which formats to generate (default: both)"),
+  },
+  async ({ content, title, brand: brandPath, brandOverrides, outputDir, filename, formats }) => {
+    let brandConfig;
+    if (brandPath) {
+      brandConfig = await loadBrand(resolve(brandPath));
+      if (brandOverrides) brandConfig = mergeBrand({ ...brandConfig, ...brandOverrides });
+    } else if (defaultBrandConfig) {
+      brandConfig = brandOverrides ? mergeBrand({ ...defaultBrandConfig, ...brandOverrides }) : defaultBrandConfig;
+    } else {
+      brandConfig = mergeBrand(brandOverrides);
+    }
+
+    const base = filename || "document";
+    const dir = outputDir ? resolve(outputDir) : process.cwd();
+    const wantHtml = !formats || formats.includes("html");
+    const wantPdf = !formats || formats.includes("pdf");
+
+    const html = build(content, brandConfig, { title });
+    const results = [];
+
+    if (wantHtml) {
+      const htmlPath = resolve(dir, `${base}.html`);
+      await writeFile(htmlPath, html, "utf-8");
+      results.push(`HTML: ${htmlPath} (${(Buffer.byteLength(html, "utf-8") / 1024).toFixed(1)} KB)`);
+    }
+
+    if (wantPdf) {
+      const pdfPath = resolve(dir, `${base}.pdf`);
+      await exportPdf(html, pdfPath);
+      results.push(`PDF: ${pdfPath}`);
+    }
+
+    return {
+      content: [{ type: "text", text: results.join("\n") }],
+    };
+  },
+);
+
+// ─── list_components ───
+server.tool(
+  "list_components",
+  "List all available HTML components you can use in documents (boxes, timelines, metrics, etc.).",
+  {},
+  async () => {
+    const components = listComponents();
+    const text = components
+      .map(
+        (c) =>
+          `### ${c.name}\n${c.description}\nVariants: ${c.variants.join(", ")}\n\`\`\`html\n${c.example}\n\`\`\``,
+      )
+      .join("\n\n");
+    return {
+      content: [{ type: "text", text }],
+    };
+  },
+);
+
+// ─── list_styles ───
+server.tool(
+  "list_styles",
+  "List available document style presets.",
+  {},
+  async () => {
+    const { STYLE_PRESETS } = await import("../core/build.js");
+    const lines = Object.entries(STYLE_PRESETS).map(
+      ([key, s]) => `**${key}** — ${s.label}: ${s.desc}`
+    );
+    return {
+      content: [{ type: "text", text: lines.join("\n\n") }],
+    };
+  },
+);
+
+// ─── Start ───
+const transport = new StdioServerTransport();
+await server.connect(transport);