@masumdev/markforge 0.2.4 → 0.3.0

package/dist/index.js

@@ -40,10 +40,17 @@ var src_exports = {};
 __export(src_exports, {
   DEFAULT_CONFIG: () => DEFAULT_CONFIG,
   MARKFORGE_VERSION: () => MARKFORGE_VERSION,
+  Orientation: () => Orientation,
+  OutputFormat: () => OutputFormat,
+  PAPER_DIMENSIONS_TWIP: () => PAPER_DIMENSIONS_TWIP,
+  PaperSizeEnum: () => PaperSizeEnum,
   SYNTAX_COLORS: () => SYNTAX_COLORS,
+  SyntaxTheme: () => SyntaxTheme,
   THEMES: () => THEMES,
-  THEME_ACADEMIC: () => THEME_ACADEMIC,
+  THEME_CORPORATE: () => THEME_CORPORATE,
   THEME_DEFAULT: () => THEME_DEFAULT,
+  Theme: () => Theme,
+  WatermarkPosition: () => WatermarkPosition,
   buildDocxDocument: () => buildDocxDocument,
   buildHtmlDocument: () => buildHtmlDocument,
   buildPdfDocument: () => buildPdfDocument,
@@ -52,6 +59,7 @@ __export(src_exports, {
   escapeHtml: () => escapeHtml,
   findChromeExecutable: () => findChromeExecutable,
   formatServerTimestamp: () => formatServerTimestamp,
+  generateThemeCss: () => generateThemeCss,
   getMarkforgeVersion: () => getMarkforgeVersion,
   getMimeType: () => getMimeType,
   highlightCodeToHtml: () => highlightCodeToHtml,
@@ -59,11 +67,17 @@ __export(src_exports, {
   inlineHtmlImages: () => inlineHtmlImages,
   loadConfig: () => loadConfig,
   markforge: () => compileMarkdown,
+  normalizeHeaderFooter: () => normalizeHeaderFooter,
+  normalizeHeaderFooterSlot: () => normalizeHeaderFooterSlot,
+  normalizeSignatures: () => normalizeSignatures,
+  normalizeWatermark: () => normalizeWatermark,
   parseInlineSpans: () => parseInlineSpans,
-  parseMarginToTwip: () => parseMarginToTwip,
+  parseMarginToTwip: () => parseMarginToTwip2,
   parseMarkdownDocument: () => parseMarkdownDocument,
   renderInlinesToHtml: () => renderInlinesToHtml,
   renderMermaidToPng: () => renderMermaidToPng,
+  replaceDocumentTokens: () => replaceDocumentTokens,
+  resolveDocumentConfig: () => resolveDocumentConfig,
   resolveImage: () => resolveImage,
   slugify: () => slugify,
   tokenizeCodeLine: () => tokenizeCodeLine
@@ -585,6 +599,51 @@ var SYNTAX_COLORS_LIGHT = {
   plain: "24292E"
   // Near-black        — identifiers
 };
+var SYNTAX_THEMES = {
+  "github-dark": SYNTAX_COLORS,
+  "dark": SYNTAX_COLORS,
+  "github-light": SYNTAX_COLORS_LIGHT,
+  "light": SYNTAX_COLORS_LIGHT,
+  "dracula": {
+    keyword: "FF79C6",
+    string: "F1FA8C",
+    comment: "6272A4",
+    number: "BD93F9",
+    boolean: "BD93F9",
+    function: "50FA7B",
+    type: "8BE9FD",
+    operator: "FF79C6",
+    punctuation: "F8F8F2",
+    plain: "F8F8F2"
+  },
+  "monokai": {
+    keyword: "F92672",
+    string: "E6DB74",
+    comment: "75715E",
+    number: "AE81FF",
+    boolean: "AE81FF",
+    function: "A6E22E",
+    type: "66D9EF",
+    operator: "F92672",
+    punctuation: "F8F8F2",
+    plain: "F8F8F2"
+  },
+  "nord": {
+    keyword: "81A1C1",
+    string: "A3BE8C",
+    comment: "616E88",
+    number: "B48EAD",
+    boolean: "81A1C1",
+    function: "88C0D0",
+    type: "8FBCBB",
+    operator: "81A1C1",
+    punctuation: "ECEFF4",
+    plain: "D8DEE9"
+  }
+};
+function getSyntaxPalette(themeName = "github-dark") {
+  return SYNTAX_THEMES[themeName.toLowerCase()] || SYNTAX_THEMES["github-dark"];
+}
 var JS_KEYWORDS = /* @__PURE__ */ new Set([
   "import",
   "from",
@@ -728,9 +787,9 @@ var SQL_KEYWORDS = /* @__PURE__ */ new Set([
   "foreign",
   "references"
 ]);
-function tokenizeCodeLine(line, lang = "", theme = "dark") {
+function tokenizeCodeLine(line, lang = "", theme = "github-dark") {
   var _a;
-  const COLORS = theme === "light" ? SYNTAX_COLORS_LIGHT : SYNTAX_COLORS;
+  const COLORS = getSyntaxPalette(theme);
   if (!line) {
     return [{ text: " ", type: "plain", colorHex: COLORS.plain }];
   }
@@ -813,6 +872,10 @@ function tokenizeCodeLine(line, lang = "", theme = "dark") {
         tokens.push({ text: word, type: "keyword", colorHex: COLORS.keyword, bold: true });
         continue;
       }
+      if (/^[A-Z][a-zA-Z0-9_$]*$/.test(word)) {
+        tokens.push({ text: word, type: "type", colorHex: COLORS.type });
+        continue;
+      }
       let nextNonWs = pos;
       while (nextNonWs < line.length && /\s/.test(line[nextNonWs])) {
         nextNonWs++;
@@ -821,10 +884,6 @@ function tokenizeCodeLine(line, lang = "", theme = "dark") {
         tokens.push({ text: word, type: "function", colorHex: COLORS.function });
         continue;
       }
-      if (/^[A-Z][a-zA-Z0-9_$]*$/.test(word)) {
-        tokens.push({ text: word, type: "type", colorHex: COLORS.type });
-        continue;
-      }
       tokens.push({ text: word, type: "plain", colorHex: COLORS.plain });
       continue;
     }
@@ -837,10 +896,10 @@ function tokenizeCodeLine(line, lang = "", theme = "dark") {
   }
   return tokens;
 }
-function highlightCodeToHtml(code, lang = "") {
+function highlightCodeToHtml(code, lang = "", theme = "github-dark") {
   const lines = (code || "").split("\n");
   const htmlLines = lines.map((line) => {
-    const tokens = tokenizeCodeLine(line, lang);
+    const tokens = tokenizeCodeLine(line, lang, theme);
     return tokens.map((t) => {
       const escaped = t.text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
       if (t.type === "plain") return escaped;
@@ -852,21 +911,62 @@ function highlightCodeToHtml(code, lang = "") {
 
 // src/core/mermaid/mermaidRenderer.ts
 var import_node_child_process2 = require("child_process");
-var fs4 = __toESM(require("fs"));
+var fs5 = __toESM(require("fs"));
 var os2 = __toESM(require("os"));
-var path4 = __toESM(require("path"));
-var import_node_url2 = require("url");
+var path5 = __toESM(require("path"));
+var import_node_url3 = require("url");
 
 // src/core/pdf/pdfBuilder.ts
-var fs3 = __toESM(require("fs"));
-var path3 = __toESM(require("path"));
+var fs4 = __toESM(require("fs"));
+var path4 = __toESM(require("path"));
 var os = __toESM(require("os"));
-var import_node_url = require("url");
+var import_node_url2 = require("url");
 var import_node_child_process = require("child_process");
 
 // src/core/html/htmlBuilder.ts
-var fs2 = __toESM(require("fs"));
-var path2 = __toESM(require("path"));
+var fs3 = __toESM(require("fs"));
+var path3 = __toESM(require("path"));
+
+// src/config/types.ts
+var OutputFormat = /* @__PURE__ */ ((OutputFormat2) => {
+  OutputFormat2["DOCX"] = "docx";
+  OutputFormat2["PDF"] = "pdf";
+  OutputFormat2["HTML"] = "html";
+  OutputFormat2["PNG"] = "png";
+  return OutputFormat2;
+})(OutputFormat || {});
+var Theme = /* @__PURE__ */ ((Theme2) => {
+  Theme2["CORPORATE"] = "corporate";
+  return Theme2;
+})(Theme || {});
+var Orientation = /* @__PURE__ */ ((Orientation2) => {
+  Orientation2["PORTRAIT"] = "portrait";
+  Orientation2["LANDSCAPE"] = "landscape";
+  return Orientation2;
+})(Orientation || {});
+var PaperSizeEnum = /* @__PURE__ */ ((PaperSizeEnum2) => {
+  PaperSizeEnum2["A4"] = "A4";
+  PaperSizeEnum2["LETTER"] = "Letter";
+  PaperSizeEnum2["LEGAL"] = "Legal";
+  PaperSizeEnum2["A3"] = "A3";
+  PaperSizeEnum2["A5"] = "A5";
+  return PaperSizeEnum2;
+})(PaperSizeEnum || {});
+var SyntaxTheme = /* @__PURE__ */ ((SyntaxTheme2) => {
+  SyntaxTheme2["GITHUB_DARK"] = "github-dark";
+  SyntaxTheme2["GITHUB_LIGHT"] = "github-light";
+  SyntaxTheme2["DRACULA"] = "dracula";
+  SyntaxTheme2["MONOKAI"] = "monokai";
+  SyntaxTheme2["NORD"] = "nord";
+  return SyntaxTheme2;
+})(SyntaxTheme || {});
+var WatermarkPosition = /* @__PURE__ */ ((WatermarkPosition2) => {
+  WatermarkPosition2["DIAGONAL"] = "diagonal";
+  WatermarkPosition2["CENTER"] = "center";
+  WatermarkPosition2["TOP_RIGHT"] = "top-right";
+  WatermarkPosition2["BOTTOM_RIGHT"] = "bottom-right";
+  return WatermarkPosition2;
+})(WatermarkPosition || {});
 
 // src/core/html/htmlThemes.ts
 var THEME_COMPONENTS = `
@@ -949,7 +1049,7 @@ hr { border: none; border-top: 1px solid var(--mf-border); margin: 2rem 0; }
   pre { overflow: visible; white-space: pre-wrap; word-break: break-all; }
 }
 `;
-var THEME_DEFAULT = `
+var THEME_CORPORATE = `
 :root {
   --mf-bg: #ffffff;
   --mf-text: #0f172a;
@@ -961,49 +1061,479 @@ var THEME_DEFAULT = `
   --mf-card-bg: #f8fafc;
   --mf-code-bg: #0f172a;
   --mf-code-text: #f8fafc;
-  --mf-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+  --mf-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
   --mf-font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
 }
 body { background-color: var(--mf-bg); color: var(--mf-text); font-family: var(--mf-font-family); font-size: 15px; line-height: 1.65; margin: 0; padding: 2.5rem; }
-.document-container { max-width: 860px; margin: 0 auto; }
+.document-container { max-width: 860px; margin: 0 auto; position: relative; z-index: 1; }
 h1, h2, h3, h4, h5, h6 { color: var(--mf-text); font-weight: 700; margin-top: 1.8rem; margin-bottom: 0.8rem; line-height: 1.25; }
-h1 { font-size: 2.2rem; border-bottom: 2px solid #33CDCF; padding-bottom: 0.5rem; }
-h2 { font-size: 1.6rem; color: #009DA0; border-bottom: 1px solid #CCFBF1; padding-bottom: 0.4rem; }
+h1 { font-size: 2.2rem; border-bottom: 2px solid var(--mf-primary); padding-bottom: 0.5rem; }
+h2 { font-size: 1.6rem; color: var(--mf-primary-dark); border-bottom: 1px solid #CCFBF1; padding-bottom: 0.4rem; }
 h3 { font-size: 1.3rem; }
 h4 { font-size: 1.1rem; }
 p  { margin: 0.8rem 0; }
 `;
-var THEME_ACADEMIC = `
+var THEME_DEFAULT = THEME_CORPORATE;
+var THEMES = {
+  corporate: THEME_CORPORATE,
+  default: THEME_CORPORATE
+};
+function generateThemeCss(theme) {
+  if (!theme || theme === "corporate" || theme === "default" || theme === "corporate" /* CORPORATE */) {
+    return THEME_CORPORATE;
+  }
+  if (typeof theme === "object") {
+    const bg = theme.backgroundColor || "#ffffff";
+    const text = theme.textColor || "#0f172a";
+    const textMuted = theme.textMuted || "#64748b";
+    const primary = theme.primaryColor || "#33CDCF";
+    const primaryDark = theme.primaryDark || primary;
+    const primaryLight = theme.primaryLight || "#ECFDFD";
+    const border = theme.borderColor || "#e2e8f0";
+    const cardBg = theme.cardBackground || "#f8fafc";
+    const codeBg = theme.codeBackground || "#0f172a";
+    const codeText = theme.codeText || "#f8fafc";
+    const font = theme.fontFamily || "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif";
+    const fontMono = theme.fontMono || "ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace";
+    return `
 :root {
-  --mf-bg: #ffffff;
-  --mf-text: #1a1a1a;
-  --mf-text-muted: #555;
-  --mf-primary: #33CDCF;
-  --mf-primary-dark: #009DA0;
-  --mf-primary-light: #ECFDFD;
-  --mf-border: #ccc;
-  --mf-card-bg: #f9f9f9;
-  --mf-code-bg: #1e1e1e;
-  --mf-code-text: #d4d4d4;
-  --mf-font-family: "Merriweather", "Georgia", "Times New Roman", serif;
-  --mf-font-mono: "Courier New", Courier, monospace;
+  --mf-bg: ${bg};
+  --mf-text: ${text};
+  --mf-text-muted: ${textMuted};
+  --mf-primary: ${primary};
+  --mf-primary-dark: ${primaryDark};
+  --mf-primary-light: ${primaryLight};
+  --mf-border: ${border};
+  --mf-card-bg: ${cardBg};
+  --mf-code-bg: ${codeBg};
+  --mf-code-text: ${codeText};
+  --mf-font-family: ${font};
+  --mf-font-mono: ${fontMono};
 }
-body { font-family: var(--mf-font-family); font-size: 16px; line-height: 1.8; padding: 3rem; color: var(--mf-text); }
-.document-container { max-width: 780px; margin: 0 auto; text-align: justify; }
-h1, h2, h3 { font-family: "Times New Roman", Times, serif; font-weight: bold; text-align: left; }
-h1 { font-size: 2rem; border-bottom: 1px solid #000; padding-bottom: 0.3rem; }
-h2 { font-size: 1.4rem; border-bottom: 1px solid #ccc; padding-bottom: 0.2rem; }
-h3 { font-size: 1.2rem; }
-p  { margin: 0.9rem 0; }
+body { background-color: var(--mf-bg); color: var(--mf-text); font-family: var(--mf-font-family); font-size: 15px; line-height: 1.65; margin: 0; padding: 2.5rem; }
+.document-container { max-width: 860px; margin: 0 auto; position: relative; z-index: 1; }
+h1, h2, h3, h4, h5, h6 { color: var(--mf-text); font-weight: 700; margin-top: 1.8rem; margin-bottom: 0.8rem; line-height: 1.25; }
+h1 { font-size: 2.2rem; border-bottom: 2px solid var(--mf-primary); padding-bottom: 0.5rem; }
+h2 { font-size: 1.6rem; color: var(--mf-primary-dark); border-bottom: 1px solid var(--mf-border); padding-bottom: 0.4rem; }
+h3 { font-size: 1.3rem; }
+h4 { font-size: 1.1rem; }
+p  { margin: 0.8rem 0; }
+${theme.customCss || ""}
 `;
-var THEMES = {
-  default: THEME_DEFAULT,
-  academic: THEME_ACADEMIC,
-  github: THEME_DEFAULT,
-  corporate: THEME_DEFAULT,
-  minimal: THEME_DEFAULT,
-  dracula: THEME_DEFAULT
+  }
+  if (typeof theme === "string" && THEMES[theme]) {
+    return THEMES[theme];
+  }
+  return THEME_CORPORATE;
+}
+
+// src/config/loadConfig.ts
+var fs2 = __toESM(require("fs"));
+var path2 = __toESM(require("path"));
+var import_node_url = require("url");
+var YAML = __toESM(require("yaml"));
+var DEFAULT_CONFIG_FILENAMES = [
+  "markforge.config.json",
+  ".markforgerc.json",
+  "markforge.config.yaml",
+  "markforge.config.yml",
+  ".markforgerc.yaml",
+  ".markforgerc.yml",
+  ".markforgerc",
+  "markforge.config.ts",
+  "markforge.config.js",
+  "markforge.config.mjs",
+  "markforge.config.cjs"
+];
+var DEFAULT_CONFIG = {
+  to: ["docx", "pdf"],
+  outputDir: void 0,
+  theme: "default",
+  css: void 0,
+  orientation: "portrait",
+  paperSize: "A4",
+  margins: {
+    top: "2.5cm",
+    bottom: "2.5cm",
+    left: "2.5cm",
+    right: "2.5cm"
+  },
+  header: void 0,
+  footer: {
+    right: "Page {page} of {pages}"
+  },
+  toc: false,
+  watermark: void 0,
+  embedImages: true,
+  metadata: void 0,
+  watch: false,
+  serve: false,
+  port: 4e3,
+  open: false,
+  bundleHtml: true,
+  syntaxTheme: "github-dark"
+};
+function discoverConfigFile(startDir) {
+  const dirsToCheck = [];
+  let curr = path2.resolve(startDir);
+  while (curr) {
+    dirsToCheck.push(curr);
+    const parent = path2.dirname(curr);
+    if (parent === curr) break;
+    curr = parent;
+  }
+  const cwd = path2.resolve(process.cwd());
+  if (!dirsToCheck.includes(cwd)) {
+    dirsToCheck.push(cwd);
+  }
+  for (const dir of dirsToCheck) {
+    for (const filename of DEFAULT_CONFIG_FILENAMES) {
+      const candidate = path2.join(dir, filename);
+      if (fs2.existsSync(candidate) && fs2.statSync(candidate).isFile()) {
+        return candidate;
+      }
+    }
+  }
+  return null;
+}
+async function loadConfig(customPath, startDir = process.cwd()) {
+  let resolvedPath = null;
+  if (customPath) {
+    resolvedPath = path2.isAbsolute(customPath) ? customPath : path2.resolve(process.cwd(), customPath);
+    if (!fs2.existsSync(resolvedPath)) {
+      const altPath = path2.resolve(startDir, customPath);
+      if (fs2.existsSync(altPath)) {
+        resolvedPath = altPath;
+      } else {
+        throw new Error(`Configuration file not found: ${resolvedPath}`);
+      }
+    }
+  } else {
+    resolvedPath = discoverConfigFile(startDir);
+  }
+  if (!resolvedPath) {
+    return {
+      config: { ...DEFAULT_CONFIG },
+      configPath: null
+    };
+  }
+  const ext = path2.extname(resolvedPath).toLowerCase();
+  let userConfig = {};
+  try {
+    if (ext === ".json" || ext === "" || resolvedPath.endsWith(".markforgerc")) {
+      const raw = fs2.readFileSync(resolvedPath, "utf-8").trim();
+      try {
+        userConfig = JSON.parse(raw);
+      } catch {
+        userConfig = YAML.parse(raw) || {};
+      }
+    } else if (ext === ".yaml" || ext === ".yml") {
+      const raw = fs2.readFileSync(resolvedPath, "utf-8");
+      userConfig = YAML.parse(raw) || {};
+    } else if (ext === ".ts" || ext === ".js" || ext === ".mjs" || ext === ".cjs") {
+      try {
+        const fileUrl = `${(0, import_node_url.pathToFileURL)(resolvedPath).href}?t=${Date.now()}`;
+        const mod = await import(fileUrl);
+        const rawExport = mod.default ?? mod.config ?? mod;
+        userConfig = (typeof rawExport === "function" ? await rawExport() : rawExport) || {};
+      } catch (importErr) {
+        try {
+          const mod = require(resolvedPath);
+          const rawExport = mod.default ?? mod.config ?? mod;
+          userConfig = (typeof rawExport === "function" ? await rawExport() : rawExport) || {};
+        } catch {
+          throw importErr;
+        }
+      }
+    }
+  } catch (err) {
+    throw new Error(
+      `Failed to parse configuration file at ${resolvedPath}: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  if (userConfig && typeof userConfig === "object" && "$schema" in userConfig) {
+    delete userConfig.$schema;
+  }
+  const parsedConfig = userConfig;
+  const mergedConfig = {
+    ...DEFAULT_CONFIG,
+    ...parsedConfig,
+    margins: {
+      ...DEFAULT_CONFIG.margins,
+      ...parsedConfig.margins || {}
+    },
+    header: parsedConfig.header !== void 0 ? parsedConfig.header : DEFAULT_CONFIG.header,
+    footer: parsedConfig.footer !== void 0 ? parsedConfig.footer : DEFAULT_CONFIG.footer,
+    metadata: {
+      ...DEFAULT_CONFIG.metadata || {},
+      ...parsedConfig.metadata || {}
+    }
+  };
+  return {
+    config: mergedConfig,
+    configPath: resolvedPath
+  };
+}
+
+// src/config/resolveConfig.ts
+var PAPER_DIMENSIONS_TWIP = {
+  A4: { width: 11906, height: 16838 },
+  // 210mm x 297mm
+  Letter: { width: 12240, height: 15840 },
+  // 8.5in x 11in
+  Legal: { width: 12240, height: 20160 },
+  // 8.5in x 14in
+  A3: { width: 16838, height: 23811 },
+  // 297mm x 420mm
+  A5: { width: 8390, height: 11906 }
+  // 148mm x 210mm
 };
+function parseMarginToTwip(margin, defaultTwip = 1440) {
+  if (typeof margin === "number") return margin;
+  if (!margin) return defaultTwip;
+  const str = margin.trim().toLowerCase();
+  if (str.endsWith("cm")) {
+    const cm = parseFloat(str);
+    return isNaN(cm) ? defaultTwip : Math.round(cm * 566.929);
+  }
+  if (str.endsWith("mm")) {
+    const mm = parseFloat(str);
+    return isNaN(mm) ? defaultTwip : Math.round(mm * 56.6929);
+  }
+  if (str.endsWith("in") || str.endsWith("inch")) {
+    const inch = parseFloat(str);
+    return isNaN(inch) ? defaultTwip : Math.round(inch * 1440);
+  }
+  if (str.endsWith("pt")) {
+    const pt = parseFloat(str);
+    return isNaN(pt) ? defaultTwip : Math.round(pt * 20);
+  }
+  const val = parseFloat(str);
+  return isNaN(val) ? defaultTwip : Math.round(val);
+}
+function formatMarginCss(margin, defaultCss = "2.5cm") {
+  if (margin === void 0 || margin === null) return defaultCss;
+  if (typeof margin === "number") return `${margin}pt`;
+  const str = margin.trim();
+  if (!str) return defaultCss;
+  if (/^[0-9.]+$/.test(str)) return `${str}pt`;
+  return str;
+}
+function replaceDocumentTokens(template = "", meta) {
+  return template.replace(/\{title\}/gi, meta.title || "").replace(/\{subtitle\}/gi, meta.subtitle || "").replace(/\{author\}/gi, meta.author || "").replace(/\{version\}/gi, meta.version || "").replace(/\{date\}/gi, meta.date || "").replace(/\{company\}/gi, meta.company || "");
+}
+function normalizeWatermark(rawWatermark) {
+  if (!rawWatermark) {
+    return void 0;
+  }
+  if (typeof rawWatermark === "string") {
+    const text = rawWatermark.trim();
+    if (!text) return void 0;
+    return {
+      text,
+      color: "#94a3b8",
+      opacity: 0.08,
+      fontSize: 54,
+      rotate: -45,
+      position: "diagonal"
+    };
+  }
+  if (typeof rawWatermark === "object") {
+    if (!rawWatermark.text || !rawWatermark.text.trim()) return void 0;
+    return {
+      text: rawWatermark.text.trim(),
+      color: rawWatermark.color || "#94a3b8",
+      opacity: typeof rawWatermark.opacity === "number" ? rawWatermark.opacity : 0.08,
+      fontSize: rawWatermark.fontSize || 54,
+      rotate: typeof rawWatermark.rotate === "number" ? rawWatermark.rotate : -45,
+      position: rawWatermark.position || "diagonal"
+    };
+  }
+  return void 0;
+}
+function normalizeHeaderFooterSlot(rawSlot, parent, meta) {
+  if (!rawSlot) return void 0;
+  if (typeof rawSlot === "string") {
+    const text = replaceDocumentTokens(rawSlot, meta).trim();
+    if (!text) return void 0;
+    return {
+      text,
+      color: (parent == null ? void 0 : parent.color) || "#94A3B8",
+      fontSize: (parent == null ? void 0 : parent.size) || 9,
+      fontFamily: (parent == null ? void 0 : parent.font) || "Segoe UI",
+      bold: false,
+      italic: false
+    };
+  }
+  if (typeof rawSlot === "object") {
+    const text = replaceDocumentTokens(rawSlot.text || "", meta).trim();
+    if (!text) return void 0;
+    return {
+      text,
+      color: rawSlot.color || (parent == null ? void 0 : parent.color) || "#94A3B8",
+      fontSize: rawSlot.fontSize || (parent == null ? void 0 : parent.size) || 9,
+      fontFamily: rawSlot.fontFamily || (parent == null ? void 0 : parent.font) || "Segoe UI",
+      bold: Boolean(rawSlot.bold),
+      italic: Boolean(rawSlot.italic)
+    };
+  }
+  return void 0;
+}
+function normalizeHeaderFooter(raw, meta) {
+  if (!raw) return void 0;
+  const left = normalizeHeaderFooterSlot(raw.left, raw, meta);
+  const center = normalizeHeaderFooterSlot(raw.center, raw, meta);
+  const right = normalizeHeaderFooterSlot(raw.right, raw, meta);
+  if (!left && !center && !right) return void 0;
+  return {
+    left,
+    center,
+    right,
+    font: raw.font || "Segoe UI",
+    size: raw.size || 9,
+    color: raw.color || "#94A3B8",
+    divider: Boolean(raw.divider),
+    dividerColor: raw.dividerColor || "#E2E8F0"
+  };
+}
+function normalizeSignatures(raw, meta = {}) {
+  if (!raw) return void 0;
+  let rawItems = [];
+  let rawConfig = {};
+  if (Array.isArray(raw)) {
+    rawItems = raw;
+  } else if (typeof raw === "object" && Array.isArray(raw.items)) {
+    rawItems = raw.items;
+    rawConfig = raw;
+  }
+  if (rawItems.length === 0) return void 0;
+  const cappedItems = rawItems.slice(0, 4);
+  const items = cappedItems.map((item) => {
+    const tokenCtx = meta;
+    const rawName = typeof item.name === "string" ? item.name : "";
+    const name = replaceDocumentTokens(rawName, tokenCtx).trim();
+    const title = item.title ? replaceDocumentTokens(item.title, tokenCtx).trim() : void 0;
+    const role = item.role ? replaceDocumentTokens(item.role, tokenCtx).trim() : void 0;
+    let dateStr;
+    if (typeof item.date === "string") {
+      dateStr = replaceDocumentTokens(item.date, tokenCtx).trim();
+    } else if (item.date === true) {
+      dateStr = meta.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    }
+    let signatureHeight = 60;
+    if (typeof item.signatureHeight === "number") {
+      signatureHeight = item.signatureHeight;
+    } else if (typeof item.signatureHeight === "string") {
+      const parsed = parseFloat(item.signatureHeight);
+      if (!isNaN(parsed)) signatureHeight = parsed;
+    }
+    return {
+      title,
+      name: name || "Authorized Signatory",
+      role,
+      date: dateStr,
+      image: item.image,
+      signatureHeight
+    };
+  });
+  const align = rawConfig.align || (items.length === 1 ? "right" : "space-between");
+  const style = rawConfig.style || "line";
+  const borderColor = rawConfig.borderColor || "#CBD5E1";
+  const titleColor = rawConfig.titleColor || "#64748B";
+  const nameColor = rawConfig.nameColor || "#0F172A";
+  const roleColor = rawConfig.roleColor || "#64748B";
+  const spacingBeforeRaw = rawConfig.spacingBefore ?? "2.5rem";
+  const spacingBefore = formatMarginCss(spacingBeforeRaw, "2.5rem");
+  const spacingBeforeTwip = parseMarginToTwip(spacingBeforeRaw, 600);
+  return {
+    items,
+    align,
+    style,
+    borderColor,
+    titleColor,
+    nameColor,
+    roleColor,
+    spacingBefore,
+    spacingBeforeTwip
+  };
+}
+function resolveDocumentConfig(frontmatter = {}, userConfig = {}) {
+  const configMeta = userConfig.metadata || {};
+  const mergedMeta = { ...configMeta, ...frontmatter };
+  const title = mergedMeta.title || "MarkForge Document";
+  const subtitle = mergedMeta.subtitle || void 0;
+  const author = Array.isArray(mergedMeta.author) ? mergedMeta.author.join(", ") : mergedMeta.author || void 0;
+  const date = mergedMeta.date || void 0;
+  const version = mergedMeta.version || void 0;
+  const company = mergedMeta.company || void 0;
+  const lang = mergedMeta.lang || "en";
+  const tokenContext = { title, subtitle, author, version, date, company };
+  const theme = mergedMeta.theme || userConfig.theme || DEFAULT_CONFIG.theme;
+  const orientation = mergedMeta.orientation || userConfig.orientation || DEFAULT_CONFIG.orientation;
+  const paperSize = mergedMeta.paperSize || userConfig.paperSize || DEFAULT_CONFIG.paperSize;
+  const baseDim = PAPER_DIMENSIONS_TWIP[paperSize] || PAPER_DIMENSIONS_TWIP.A4;
+  const paperDimensions = orientation === "landscape" ? { widthTwip: baseDim.height, heightTwip: baseDim.width } : { widthTwip: baseDim.width, heightTwip: baseDim.height };
+  const fmMargin = mergedMeta.margins || {};
+  const cfgMargin = userConfig.margins || {};
+  const defMargin = DEFAULT_CONFIG.margins || {};
+  const topRaw = fmMargin.top ?? cfgMargin.top ?? defMargin.top ?? "2.5cm";
+  const bottomRaw = fmMargin.bottom ?? cfgMargin.bottom ?? defMargin.bottom ?? "2.5cm";
+  const leftRaw = fmMargin.left ?? cfgMargin.left ?? defMargin.left ?? "2.5cm";
+  const rightRaw = fmMargin.right ?? cfgMargin.right ?? defMargin.right ?? "2.5cm";
+  const margins = {
+    top: formatMarginCss(topRaw),
+    bottom: formatMarginCss(bottomRaw),
+    left: formatMarginCss(leftRaw),
+    right: formatMarginCss(rightRaw),
+    topTwip: parseMarginToTwip(topRaw),
+    bottomTwip: parseMarginToTwip(bottomRaw),
+    leftTwip: parseMarginToTwip(leftRaw),
+    rightTwip: parseMarginToTwip(rightRaw)
+  };
+  const rawHeader = mergedMeta.header || userConfig.header || DEFAULT_CONFIG.header;
+  const rawFooter = mergedMeta.footer || userConfig.footer || DEFAULT_CONFIG.footer;
+  const header = normalizeHeaderFooter(rawHeader, tokenContext);
+  const footer = normalizeHeaderFooter(rawFooter, tokenContext);
+  const toc = typeof mergedMeta.toc === "boolean" ? mergedMeta.toc : typeof userConfig.toc === "boolean" ? userConfig.toc : DEFAULT_CONFIG.toc;
+  const rawWatermark = mergedMeta.watermark !== void 0 ? mergedMeta.watermark : userConfig.watermark !== void 0 ? userConfig.watermark : DEFAULT_CONFIG.watermark;
+  const watermark = normalizeWatermark(rawWatermark);
+  const rawSignatures = mergedMeta.signatures || userConfig.signatures;
+  const signatures = normalizeSignatures(rawSignatures, tokenContext);
+  const cssList = [];
+  const addCss = (item) => {
+    if (!item) return;
+    if (Array.isArray(item)) cssList.push(...item);
+    else cssList.push(item);
+  };
+  addCss(userConfig.css);
+  addCss(mergedMeta.css);
+  const embedImages = typeof userConfig.embedImages === "boolean" ? userConfig.embedImages : DEFAULT_CONFIG.embedImages;
+  const bundleHtml = typeof userConfig.bundleHtml === "boolean" ? userConfig.bundleHtml : DEFAULT_CONFIG.bundleHtml;
+  const syntaxTheme = userConfig.syntaxTheme || DEFAULT_CONFIG.syntaxTheme || "github-dark";
+  return {
+    title,
+    subtitle,
+    author,
+    date,
+    version,
+    company,
+    lang,
+    theme,
+    orientation,
+    paperSize,
+    paperDimensions,
+    margins,
+    header,
+    footer,
+    toc,
+    signatures,
+    watermark,
+    css: cssList,
+    embedImages,
+    bundleHtml,
+    syntaxTheme
+  };
+}
 
 // src/core/html/htmlBuilder.ts
 function escapeHtml(str) {
@@ -1056,43 +1586,41 @@ async function renderInlinesToHtml(spans = [], baseDir = process.cwd()) {
   return result;
 }
 async function buildHtmlDocument(doc, config, baseDir = process.cwd()) {
-  var _a;
-  const metadata = { ...config.metadata, ...doc.metadata };
-  const themeName = metadata.theme || config.theme || "default";
-  const baseThemeCss = THEMES[themeName] || THEMES.default;
+  const resolved = resolveDocumentConfig(doc.metadata, config);
+  const baseThemeCss = generateThemeCss(resolved.theme);
   let customCss = "";
-  if (config.css) {
-    const cssList = Array.isArray(config.css) ? config.css : [config.css];
-    for (const cssPath of cssList) {
-      const fullCssPath = path2.isAbsolute(cssPath) ? cssPath : path2.resolve(baseDir, cssPath);
-      if (fs2.existsSync(fullCssPath)) {
-        customCss += `
+  for (const cssPath of resolved.css) {
+    const fullCssPath = path3.isAbsolute(cssPath) ? cssPath : path3.resolve(baseDir, cssPath);
+    if (fs3.existsSync(fullCssPath)) {
+      customCss += `
 /* Custom CSS: ${cssPath} */
-` + fs2.readFileSync(fullCssPath, "utf-8");
-      }
+` + fs3.readFileSync(fullCssPath, "utf-8");
     }
   }
   const inlinedCss = doc.inlinedStyles.join("\n");
   let bodyHtml = "";
-  if (metadata.title) {
+  if (resolved.title) {
     bodyHtml += `  <header class="document-header">
 `;
-    bodyHtml += `    <h1 class="document-title">${escapeHtml(metadata.title)}</h1>
+    bodyHtml += `    <h1 class="document-title">${escapeHtml(resolved.title)}</h1>
 `;
-    if (metadata.subtitle) {
-      bodyHtml += `    <div class="document-subtitle">${escapeHtml(metadata.subtitle)}</div>
+    if (resolved.subtitle) {
+      bodyHtml += `    <div class="document-subtitle">${escapeHtml(resolved.subtitle)}</div>
 `;
     }
-    if (metadata.author || metadata.date) {
+    if (resolved.author || resolved.date || resolved.version) {
       bodyHtml += `    <div class="document-meta">
 `;
-      if (metadata.author) {
-        const authors = Array.isArray(metadata.author) ? metadata.author.join(", ") : metadata.author;
-        bodyHtml += `      <span>Author: ${escapeHtml(authors)}</span>
+      if (resolved.author) {
+        bodyHtml += `      <span>Author: ${escapeHtml(resolved.author)}</span>
+`;
+      }
+      if (resolved.version) {
+        bodyHtml += `      <span>Version: ${escapeHtml(resolved.version)}</span>
 `;
       }
-      if (metadata.date) {
-        bodyHtml += `      <span>Date: ${escapeHtml(metadata.date)}</span>
+      if (resolved.date) {
+        bodyHtml += `      <span>Date: ${escapeHtml(resolved.date)}</span>
 `;
       }
       bodyHtml += `    </div>
@@ -1101,22 +1629,20 @@ async function buildHtmlDocument(doc, config, baseDir = process.cwd()) {
     bodyHtml += `  </header>
 `;
   }
-  if (config.toc || metadata.toc) {
-    if (doc.tocEntries.length > 0) {
-      bodyHtml += `  <nav class="table-of-contents">
+  if (resolved.toc && doc.tocEntries.length > 0) {
+    bodyHtml += `  <nav class="table-of-contents">
 `;
-      bodyHtml += `    <h2>Table of Contents</h2>
+    bodyHtml += `    <h2>Table of Contents</h2>
     <ul>
 `;
-      for (const entry of doc.tocEntries) {
-        const indent = "  ".repeat(entry.level);
-        bodyHtml += `    ${indent}<li><a href="#${entry.id}">${escapeHtml(entry.text)}</a></li>
+    for (const entry of doc.tocEntries) {
+      const indent = "  ".repeat(entry.level);
+      bodyHtml += `    ${indent}<li><a href="#${entry.id}">${escapeHtml(entry.text)}</a></li>
 `;
-      }
-      bodyHtml += `    </ul>
+    }
+    bodyHtml += `    </ul>
   </nav>
 `;
-    }
   }
   for (const node of doc.nodes) {
     if (node.type === "heading") {
@@ -1134,7 +1660,7 @@ async function buildHtmlDocument(doc, config, baseDir = process.cwd()) {
     if (node.type === "codeBlock") {
       const lang = node.language || "";
       const langClass = lang ? ` class="language-${escapeHtml(lang)}"` : "";
-      const highlighted = highlightCodeToHtml(node.text || "", lang);
+      const highlighted = highlightCodeToHtml(node.text || "", lang, resolved.syntaxTheme);
       bodyHtml += `  <pre><code${langClass}>${highlighted}</code></pre>
 `;
       continue;
@@ -1178,15 +1704,12 @@ ${escapeHtml(node.text || "")}
       for (const row of node.children) {
         bodyHtml += `    <tr>
 `;
-        if (row.children) {
-          for (let colIdx = 0; colIdx < row.children.length; colIdx++) {
-            const cell = row.children[colIdx];
-            const tag = row.isHeader ? "th" : "td";
-            const align = ((_a = node.align) == null ? void 0 : _a[colIdx]) ? ` style="text-align: ${node.align[colIdx]}"` : "";
-            const cellInner = await renderInlinesToHtml(cell.inlines, baseDir);
-            bodyHtml += `      <${tag}${align}>${cellInner}</${tag}>
+        for (const cell of row.children || []) {
+          const tag = cell.isHeader ? "th" : "td";
+          const align = cell.align ? ` align="${cell.align}"` : "";
+          const inner = await renderInlinesToHtml(cell.inlines, baseDir);
+          bodyHtml += `      <${tag}${align}>${inner}</${tag}>
 `;
-          }
         }
         bodyHtml += `    </tr>
 `;
@@ -1200,58 +1723,187 @@ ${escapeHtml(node.text || "")}
       bodyHtml += `  <${tag}>
 `;
       for (const item of node.children) {
-        const itemInner = await renderInlinesToHtml(item.inlines, baseDir);
-        let prefix = "";
-        if (item.checked !== void 0) {
-          prefix = `<input type="checkbox" disabled ${item.checked ? "checked" : ""}/> `;
-        }
-        bodyHtml += `    <li>${prefix}${itemInner}</li>
+        const inner = await renderInlinesToHtml(item.inlines, baseDir);
+        bodyHtml += `    <li>${inner}</li>
 `;
       }
       bodyHtml += `  </${tag}>
 `;
       continue;
     }
-    if (node.type === "htmlBlock") {
-      bodyHtml += `  ${node.rawHtml}
+    if (node.type === "thematicBreak") {
+      bodyHtml += `  <hr />
 `;
       continue;
     }
-    if (node.type === "thematicBreak") {
-      bodyHtml += `  <hr />
+    if (node.type === "htmlBlock") {
+      bodyHtml += `  ${node.text}
 `;
       continue;
     }
   }
-  const wmConfig = config.watermark ?? metadata.watermark;
-  let watermarkHtml = "";
   let watermarkCss = "";
-  if (wmConfig) {
-    const wmText = typeof wmConfig === "string" ? wmConfig : wmConfig.text;
-    const opacity = typeof wmConfig === "object" && wmConfig.opacity !== void 0 ? wmConfig.opacity : 0.12;
-    const rotate = typeof wmConfig === "object" && wmConfig.rotate !== void 0 ? wmConfig.rotate : -45;
-    const color = typeof wmConfig === "object" && wmConfig.color ? wmConfig.color : "#94A3B8";
-    const fontSize = typeof wmConfig === "object" && wmConfig.fontSize ? `${wmConfig.fontSize}pt` : "52pt";
+  let watermarkHtml = "";
+  if (resolved.watermark) {
+    const wm = resolved.watermark;
     watermarkCss = `
   .document-watermark {
     position: fixed;
-    top: 50%;
-    left: 50%;
-    transform: translate(-50%, -50%) rotate(${rotate}deg);
-    font-size: ${fontSize};
-    font-weight: 800;
-    color: ${color};
-    opacity: ${opacity};
+    top: 0;
+    left: 0;
+    width: 100vw;
+    height: 100vh;
     pointer-events: none;
+    z-index: 0;
     user-select: none;
-    z-index: 9999;
-    text-transform: uppercase;
-    letter-spacing: 0.15em;
-    white-space: nowrap;
+    -webkit-user-select: none;
   }
-  `;
-    watermarkHtml = `  <div class="document-watermark">${escapeHtml(wmText)}</div>
-`;
+  .document-container {
+    position: relative;
+    z-index: 1;
+  }
+  @media print {
+    .document-watermark {
+      position: fixed;
+      top: 0;
+      left: 0;
+      width: 100vw;
+      height: 100vh;
+      -webkit-print-color-adjust: exact;
+      print-color-adjust: exact;
+    }
+  }
+  `;
+    watermarkHtml = `  <div id="markforge-watermark" class="document-watermark" aria-hidden="true"></div>
+  <script>
+  (function() {
+    try {
+      var canvas = document.createElement('canvas');
+      var dpr = 3;
+      var width = 800;
+      var height = 1100;
+      canvas.width = Math.round(width * dpr);
+      canvas.height = Math.round(height * dpr);
+      var ctx = canvas.getContext('2d');
+      if (ctx) {
+        ctx.scale(dpr, dpr);
+        ctx.translate(width / 2, height / 2);
+        ctx.rotate((${wm.rotate} * Math.PI) / 180);
+        ctx.textAlign = 'center';
+        ctx.textBaseline = 'middle';
+        ctx.font = '900 ${wm.fontSize * 1.5}px system-ui, -apple-system, sans-serif';
+        ctx.fillStyle = '${wm.color}';
+        ctx.globalAlpha = ${wm.opacity};
+        try { ctx.letterSpacing = '0.15em'; } catch(e) {}
+        ctx.fillText(${JSON.stringify(wm.text.toUpperCase())}, 0, 0);
+        var dataUrl = canvas.toDataURL('image/png');
+        var wmEl = document.getElementById('markforge-watermark');
+        if (wmEl) {
+          wmEl.style.backgroundImage = 'url("' + dataUrl + '")';
+          wmEl.style.backgroundRepeat = 'no-repeat';
+          wmEl.style.backgroundPosition = 'center center';
+          wmEl.style.backgroundSize = 'contain';
+        }
+      }
+    } catch(err) {}
+  })();
+  </script>
+`;
+  }
+  let signaturesHtml = "";
+  let signaturesCss = "";
+  if (resolved.signatures && resolved.signatures.items.length > 0) {
+    const sig = resolved.signatures;
+    const numItems = sig.items.length;
+    let justifyCss = "flex-end";
+    if (sig.align === "left") justifyCss = "flex-start";
+    else if (sig.align === "center") justifyCss = "center";
+    else if (sig.align === "space-between") justifyCss = "space-between";
+    signaturesCss = `
+  .markforge-signatures {
+    margin-top: ${sig.spacingBefore};
+    display: grid;
+    grid-template-columns: ${numItems === 1 ? sig.align === "left" ? "minmax(200px, 280px) 1fr" : sig.align === "center" ? "1fr minmax(200px, 280px) 1fr" : "1fr minmax(200px, 280px)" : `repeat(${numItems}, minmax(0, 1fr))`};
+    gap: 2rem;
+    page-break-inside: avoid;
+    break-inside: avoid;
+  }
+  .markforge-signature-card {
+    ${numItems === 1 && sig.align === "center" ? "grid-column: 2;" : ""}
+    ${numItems === 1 && sig.align === "right" ? "grid-column: 2;" : ""}
+    display: flex;
+    flex-direction: column;
+    ${sig.style === "box" ? `border: 1px solid ${sig.borderColor}; border-radius: 6px; padding: 14px 18px; background-color: var(--mf-card-bg, #F8FAFC);` : ""}
+  }
+  .markforge-sig-title {
+    font-size: 0.85rem;
+    color: ${sig.titleColor};
+    font-weight: 600;
+    margin-bottom: 6px;
+  }
+  .markforge-sig-space {
+    height: var(--sig-height, 60px);
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    margin-bottom: 6px;
+  }
+  .markforge-sig-space img {
+    max-height: 100%;
+    max-width: 100%;
+    object-fit: contain;
+  }
+  .markforge-sig-line {
+    ${sig.style === "line" ? `border-bottom: 1.5px solid ${sig.borderColor}; margin-bottom: 8px;` : ""}
+  }
+  .markforge-sig-name {
+    font-size: 0.95rem;
+    font-weight: 700;
+    color: ${sig.nameColor};
+  }
+  .markforge-sig-role {
+    font-size: 0.82rem;
+    color: ${sig.roleColor};
+    margin-top: 2px;
+  }
+  .markforge-sig-date {
+    font-size: 0.78rem;
+    color: ${sig.roleColor};
+    margin-top: 2px;
+  }
+  @media print {
+    .markforge-signatures {
+      page-break-inside: avoid;
+      break-inside: avoid;
+    }
+  }
+  `;
+    const itemCards = sig.items.map((item) => {
+      const titleHtml = item.title ? `<div class="markforge-sig-title">${escapeHtml(item.title)}</div>` : "";
+      let signSpaceHtml = "";
+      if (item.image) {
+        signSpaceHtml = `<div class="markforge-sig-space" style="--sig-height: ${item.signatureHeight}px;"><img src="${escapeHtml(item.image)}" alt="Signature" /></div>`;
+      } else {
+        signSpaceHtml = `<div class="markforge-sig-space" style="--sig-height: ${item.signatureHeight}px;"></div>`;
+      }
+      const lineHtml = sig.style === "line" ? `<div class="markforge-sig-line"></div>` : "";
+      const nameHtml = `<div class="markforge-sig-name">${escapeHtml(item.name)}</div>`;
+      const roleHtml = item.role ? `<div class="markforge-sig-role">${escapeHtml(item.role)}</div>` : "";
+      const dateHtml = item.date ? `<div class="markforge-sig-date">Date: ${escapeHtml(item.date)}</div>` : "";
+      return `    <div class="markforge-signature-card">
+      ${titleHtml}
+      ${signSpaceHtml}
+      ${lineHtml}
+      ${nameHtml}
+      ${roleHtml}
+      ${dateHtml}
+    </div>`;
+    }).join("\n");
+    signaturesHtml = `
+  <div class="markforge-signatures">
+${itemCards}
+  </div>
+`;
   }
   const hasMermaid = doc.nodes.some((n) => n.type === "mermaid");
   const mermaidScript = hasMermaid ? `<script src="https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.min.js"></script>
@@ -1269,24 +1921,24 @@ ${escapeHtml(node.text || "")}
       }
     });
   </script>` : "";
-  const documentTitle = metadata.title || "MarkForge Document";
   return `<!DOCTYPE html>
-<html lang="${metadata.lang || "en"}">
+<html lang="${resolved.lang}">
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${escapeHtml(documentTitle)}</title>
+  <title>${escapeHtml(resolved.title)}</title>
   <style>
 ${THEME_COMPONENTS}
 ${baseThemeCss}
 ${customCss}
 ${inlinedCss}
 ${watermarkCss}
+${signaturesCss}
   </style>
 </head>
 <body>
 ${watermarkHtml}  <div class="document-container">
-${bodyHtml}  </div>
+${bodyHtml}${signaturesHtml}  </div>
   ${mermaidScript}
 </body>
 </html>`;
@@ -1294,10 +1946,10 @@ ${bodyHtml}  </div>
 
 // src/core/pdf/pdfBuilder.ts
 function findChromeExecutable() {
-  if (process.env.CHROME_PATH && fs3.existsSync(process.env.CHROME_PATH)) {
+  if (process.env.CHROME_PATH && fs4.existsSync(process.env.CHROME_PATH)) {
     return process.env.CHROME_PATH;
   }
-  if (process.env.PUPPETEER_EXECUTABLE_PATH && fs3.existsSync(process.env.PUPPETEER_EXECUTABLE_PATH)) {
+  if (process.env.PUPPETEER_EXECUTABLE_PATH && fs4.existsSync(process.env.PUPPETEER_EXECUTABLE_PATH)) {
     return process.env.PUPPETEER_EXECUTABLE_PATH;
   }
   const isWin = process.platform === "win32";
@@ -1319,14 +1971,14 @@ function findChromeExecutable() {
     "/Applications/Chromium.app/Contents/MacOS/Chromium",
     "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
     "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
+    // Windows — Microsoft Edge (Native Windows 10/11 browser, enterprise whitelist friendly)
+    `${winProgramFiles}\\Microsoft\\Edge\\Application\\msedge.exe`,
+    `${winProgramFilesX86}\\Microsoft\\Edge\\Application\\msedge.exe`,
+    `${winLocalAppData}\\Microsoft\\Edge\\Application\\msedge.exe`,
     // Windows — Google Chrome
     `${winProgramFiles}\\Google\\Chrome\\Application\\chrome.exe`,
     `${winProgramFilesX86}\\Google\\Chrome\\Application\\chrome.exe`,
     `${winLocalAppData}\\Google\\Chrome\\Application\\chrome.exe`,
-    // Windows — Microsoft Edge (ships with Windows 10/11)
-    `${winProgramFiles}\\Microsoft\\Edge\\Application\\msedge.exe`,
-    `${winProgramFilesX86}\\Microsoft\\Edge\\Application\\msedge.exe`,
-    `${winLocalAppData}\\Microsoft\\Edge\\Application\\msedge.exe`,
     // Windows — Brave Browser
     `${winProgramFiles}\\BraveSoftware\\Brave-Browser\\Application\\brave.exe`,
     `${winProgramFilesX86}\\BraveSoftware\\Brave-Browser\\Application\\brave.exe`,
@@ -1336,7 +1988,7 @@ function findChromeExecutable() {
   ].filter(Boolean);
   for (const candidate of candidates) {
     try {
-      if (fs3.existsSync(candidate)) {
+      if (fs4.existsSync(candidate)) {
         return candidate;
       }
     } catch {
@@ -1349,7 +2001,7 @@ function findChromeExecutable() {
       const res = (0, import_node_child_process.spawnSync)(cmd, [name], { encoding: "utf-8" });
       if (res.status === 0 && res.stdout.trim()) {
         const binPath = res.stdout.split(/\r?\n/)[0].trim();
-        if (fs3.existsSync(binPath)) return binPath;
+        if (fs4.existsSync(binPath)) return binPath;
       }
     }
   } catch {
@@ -1357,22 +2009,50 @@ function findChromeExecutable() {
   return null;
 }
 function injectPagedMediaStyles(html, config, metadata) {
-  var _a, _b, _c, _d;
-  const merged = { ...config.metadata, ...metadata };
-  const orientation = merged.orientation || config.orientation || "portrait";
-  const size = merged.paperSize || config.paperSize || "A4";
-  const margins = merged.margins || config.margins || {};
-  const top = margins.top || ((_a = config.margins) == null ? void 0 : _a.top) || "2.5cm";
-  const bottom = margins.bottom || ((_b = config.margins) == null ? void 0 : _b.bottom) || "2.5cm";
-  const left = margins.left || ((_c = config.margins) == null ? void 0 : _c.left) || "2.5cm";
-  const right = margins.right || ((_d = config.margins) == null ? void 0 : _d.right) || "2.5cm";
-  const headerCfg = merged.header;
-  const footerCfg = merged.footer;
-  const headerLeft = (headerCfg == null ? void 0 : headerCfg.left) ?? "";
-  const headerCenter = (headerCfg == null ? void 0 : headerCfg.center) ?? "";
-  const headerRight = (headerCfg == null ? void 0 : headerCfg.right) ?? "";
-  const footerLeft = ((footerCfg == null ? void 0 : footerCfg.left) ?? "").replace("{page}", "").replace("{pages}", "").trim();
-  const esc = (s) => s.replace(/"/g, '"').replace(/\\/g, "\\\\");
+  var _a, _b, _c, _d, _e, _f;
+  const resolved = resolveDocumentConfig(metadata || {}, config);
+  const size = resolved.paperSize;
+  const orientation = resolved.orientation;
+  const top = resolved.margins.top;
+  const bottom = resolved.margins.bottom;
+  const left = resolved.margins.left;
+  const right = resolved.margins.right;
+  const esc = (s) => s.replace(/"/g, '\\"').replace(/\\/g, "\\\\");
+  const buildZoneCss = (pos, zone, isPageCounter = false) => {
+    if (!zone && !isPageCounter) return "";
+    const color = (zone == null ? void 0 : zone.color) || "#94a3b8";
+    const fontSize = (zone == null ? void 0 : zone.fontSize) ? `${zone.fontSize}pt` : "9pt";
+    const fontFamily = (zone == null ? void 0 : zone.fontFamily) ? `font-family: ${zone.fontFamily};` : "";
+    const fontWeight = (zone == null ? void 0 : zone.bold) ? "font-weight: bold;" : "";
+    const fontStyle = (zone == null ? void 0 : zone.italic) ? "font-style: italic;" : "";
+    let content = "";
+    if (isPageCounter) {
+      if ((zone == null ? void 0 : zone.text) && (zone.text.includes("{page}") || zone.text.includes("{pages}"))) {
+        const parts = zone.text.split(/(\{page\}|\{pages\})/gi);
+        const cssParts = parts.map((part) => {
+          if (part.toLowerCase() === "{page}") return "counter(page)";
+          if (part.toLowerCase() === "{pages}") return "counter(pages)";
+          return `"${esc(part)}"`;
+        });
+        content = cssParts.join(" ");
+      } else if (zone == null ? void 0 : zone.text) {
+        content = `"${esc(zone.text)}"`;
+      } else {
+        content = `"Page " counter(page) " of " counter(pages)`;
+      }
+    } else if (zone == null ? void 0 : zone.text) {
+      content = `"${esc(zone.text)}"`;
+    }
+    if (!content) return "";
+    return `@${pos} {
+      content: ${content};
+      font-size: ${fontSize};
+      color: ${color};
+      ${fontFamily}
+      ${fontWeight}
+      ${fontStyle}
+    }`;
+  };
   const pagedCss = `
   @page {
     size: ${size} ${orientation};
@@ -1380,15 +2060,12 @@ function injectPagedMediaStyles(html, config, metadata) {
     margin-bottom: ${bottom};
     margin-left: ${left};
     margin-right: ${right};
-    ${headerLeft ? `@top-left { content: "${esc(headerLeft)}"; font-size: 9pt; color: #94a3b8; }` : ""}
-    ${headerCenter ? `@top-center { content: "${esc(headerCenter)}"; font-size: 9pt; color: #94a3b8; }` : ""}
-    ${headerRight ? `@top-right { content: "${esc(headerRight)}"; font-size: 9pt; color: #94a3b8; }` : ""}
-    ${footerLeft ? `@bottom-left { content: "${esc(footerLeft)}"; font-size: 9pt; color: #94a3b8; }` : ""}
-    @bottom-right {
-      content: "Page " counter(page) " of " counter(pages);
-      font-size: 9pt;
-      color: #94a3b8;
-    }
+    ${buildZoneCss("top-left", (_a = resolved.header) == null ? void 0 : _a.left)}
+    ${buildZoneCss("top-center", (_b = resolved.header) == null ? void 0 : _b.center)}
+    ${buildZoneCss("top-right", (_c = resolved.header) == null ? void 0 : _c.right)}
+    ${buildZoneCss("bottom-left", (_d = resolved.footer) == null ? void 0 : _d.left)}
+    ${buildZoneCss("bottom-center", (_e = resolved.footer) == null ? void 0 : _e.center)}
+    ${buildZoneCss("bottom-right", (_f = resolved.footer) == null ? void 0 : _f.right, true)}
   }
   @media print {
     body { padding: 0; }
@@ -1445,56 +2122,72 @@ async function buildPdfDocument(doc, config, baseDir = process.cwd()) {
   if (chromePath) {
     const tmpId = Math.random().toString(36).substring(2, 9);
     const tmpDir = os.tmpdir();
-    const tmpHtml = path3.join(tmpDir, `markforge_${tmpId}.html`);
-    const tmpPdf = path3.join(tmpDir, `markforge_${tmpId}.pdf`);
+    const tmpHtml = path4.join(tmpDir, `markforge_${tmpId}.html`);
+    const tmpPdf = path4.join(tmpDir, `markforge_${tmpId}.pdf`);
+    const tmpProfile = path4.join(tmpDir, `markforge_prof_${tmpId}`);
+    const isolatedFlags = [
+      `--user-data-dir=${tmpProfile}`,
+      "--no-first-run",
+      "--no-default-browser-check",
+      "--disable-sync",
+      "--disable-background-networking",
+      "--disable-component-update",
+      "--disable-default-apps",
+      "--disable-extensions",
+      "--disable-domain-reliability",
+      "--disable-client-side-phishing-detection",
+      "--disable-breakpad",
+      "--disable-component-extensions-with-background-pages",
+      "--disable-features=Translate,OptimizationHints,MediaRouter,DialMediaRouteProvider,CalculatedNewTabPage,ChromeWhatsNewUI,PrivacySandboxSettings4",
+      "--password-store=basic",
+      "--use-mock-keychain",
+      "--mute-audio",
+      "--no-service-autorun",
+      "--disable-gpu",
+      "--no-sandbox",
+      "--disable-setuid-sandbox",
+      "--allow-file-access-from-files",
+      "--disable-web-security",
+      "--force-color-profile=srgb",
+      "--no-pdf-header-footer"
+    ];
     try {
-      fs3.writeFileSync(tmpHtml, pagedHtml, "utf-8");
-      const fileUrl = (0, import_node_url.pathToFileURL)(tmpHtml).href;
+      fs4.writeFileSync(tmpHtml, pagedHtml, "utf-8");
+      const fileUrl = (0, import_node_url2.pathToFileURL)(tmpHtml).href;
       let res = (0, import_node_child_process.spawnSync)(
         chromePath,
         [
           "--headless=new",
-          "--disable-gpu",
-          "--no-sandbox",
-          "--disable-setuid-sandbox",
-          "--allow-file-access-from-files",
-          "--disable-web-security",
-          "--force-color-profile=srgb",
+          ...isolatedFlags,
           "--run-all-compositor-stages-before-draw",
           "--virtual-time-budget=8000",
-          "--no-pdf-header-footer",
           `--print-to-pdf=${tmpPdf}`,
           fileUrl
         ],
         { timeout: 3e4 }
       );
-      if ((res.status !== 0 || !fs3.existsSync(tmpPdf)) && chromePath) {
+      if ((res.status !== 0 || !fs4.existsSync(tmpPdf)) && chromePath) {
         res = (0, import_node_child_process.spawnSync)(
           chromePath,
           [
             "--headless",
-            "--disable-gpu",
-            "--no-sandbox",
-            "--disable-setuid-sandbox",
-            "--allow-file-access-from-files",
-            "--disable-web-security",
-            "--force-color-profile=srgb",
-            "--no-pdf-header-footer",
+            ...isolatedFlags,
             `--print-to-pdf=${tmpPdf}`,
             fileUrl
           ],
           { timeout: 3e4 }
         );
       }
-      if (fs3.existsSync(tmpPdf) && fs3.statSync(tmpPdf).size > 0) {
-        const pdfBuffer = fs3.readFileSync(tmpPdf);
+      if (fs4.existsSync(tmpPdf) && fs4.statSync(tmpPdf).size > 0) {
+        const pdfBuffer = fs4.readFileSync(tmpPdf);
         return pdfBuffer;
       }
     } catch {
     } finally {
       try {
-        if (fs3.existsSync(tmpHtml)) fs3.unlinkSync(tmpHtml);
-        if (fs3.existsSync(tmpPdf)) fs3.unlinkSync(tmpPdf);
+        if (fs4.existsSync(tmpHtml)) fs4.unlinkSync(tmpHtml);
+        if (fs4.existsSync(tmpPdf)) fs4.unlinkSync(tmpPdf);
+        if (fs4.existsSync(tmpProfile)) fs4.rmSync(tmpProfile, { recursive: true, force: true });
       } catch {
       }
     }
@@ -1510,8 +2203,8 @@ async function renderMermaidToPng(mermaidCode, _baseDir = process.cwd()) {
   }
   const tmpId = Math.random().toString(36).substring(2, 9);
   const tmpDir = os2.tmpdir();
-  const tmpHtml = path4.join(tmpDir, `mermaid_${tmpId}.html`);
-  const tmpScreenshot = path4.join(tmpDir, `mermaid_${tmpId}.png`);
+  const tmpHtml = path5.join(tmpDir, `mermaid_${tmpId}.html`);
+  const tmpScreenshot = path5.join(tmpDir, `mermaid_${tmpId}.png`);
   const htmlContent = `<!DOCTYPE html>
 <html>
 <head>
@@ -1550,8 +2243,8 @@ ${mermaidCode}
 </body>
 </html>`;
   try {
-    fs4.writeFileSync(tmpHtml, htmlContent, "utf-8");
-    const fileUrl = (0, import_node_url2.pathToFileURL)(tmpHtml).href;
+    fs5.writeFileSync(tmpHtml, htmlContent, "utf-8");
+    const fileUrl = (0, import_node_url3.pathToFileURL)(tmpHtml).href;
     const res = (0, import_node_child_process2.spawnSync)(
       chromePath,
       [
@@ -1569,15 +2262,15 @@ ${mermaidCode}
       ],
       { timeout: 15e3 }
     );
-    if (res.status === 0 && fs4.existsSync(tmpScreenshot)) {
-      const buffer = fs4.readFileSync(tmpScreenshot);
+    if (res.status === 0 && fs5.existsSync(tmpScreenshot)) {
+      const buffer = fs5.readFileSync(tmpScreenshot);
       return buffer;
     }
   } catch {
   } finally {
     try {
-      if (fs4.existsSync(tmpHtml)) fs4.unlinkSync(tmpHtml);
-      if (fs4.existsSync(tmpScreenshot)) fs4.unlinkSync(tmpScreenshot);
+      if (fs5.existsSync(tmpHtml)) fs5.unlinkSync(tmpHtml);
+      if (fs5.existsSync(tmpScreenshot)) fs5.unlinkSync(tmpScreenshot);
     } catch {
     }
   }
@@ -1585,7 +2278,7 @@ ${mermaidCode}
 }
 
 // src/core/docx/docxBuilder.ts
-function parseMarginToTwip(margin, defaultTwip = 1440) {
+function parseMarginToTwip2(margin, defaultTwip = 1440) {
   if (typeof margin === "number") return margin;
   if (!margin) return defaultTwip;
   const str = margin.trim().toLowerCase();
@@ -1608,7 +2301,7 @@ function parseMarginToTwip(margin, defaultTwip = 1440) {
   const val = parseFloat(str);
   return isNaN(val) ? defaultTwip : Math.round(val);
 }
-async function convertInlinesToTextRuns(spans = [], baseDir = process.cwd()) {
+async function convertInlinesToTextRuns(spans = [], baseDir = process.cwd(), options = {}) {
   const runs = [];
   for (const span of spans) {
     if (span.type === "image" && span.url) {
@@ -1638,7 +2331,10 @@ async function convertInlinesToTextRuns(spans = [], baseDir = process.cwd()) {
             new import_docx.TextRun({
               text: span.content,
               style: "Hyperlink",
-              color: "0969DA",
+              color: "009DA0",
+              font: options.font,
+              size: options.size,
+              bold: options.bold,
               underline: {}
             })
           ],
@@ -1651,7 +2347,11 @@ async function convertInlinesToTextRuns(spans = [], baseDir = process.cwd()) {
       runs.push(
         new import_docx.TextRun({
           text: span.content,
-          bold: true
+          bold: true,
+          font: options.font,
+          size: options.size,
+          color: options.color,
+          italics: options.italics
         })
       );
       continue;
@@ -1660,7 +2360,11 @@ async function convertInlinesToTextRuns(spans = [], baseDir = process.cwd()) {
       runs.push(
         new import_docx.TextRun({
           text: span.content,
-          italics: true
+          italics: true,
+          font: options.font,
+          size: options.size,
+          color: options.color,
+          bold: options.bold
         })
       );
       continue;
@@ -1669,7 +2373,10 @@ async function convertInlinesToTextRuns(spans = [], baseDir = process.cwd()) {
       runs.push(
         new import_docx.TextRun({
           text: span.content,
-          strike: true
+          strike: true,
+          font: options.font,
+          size: options.size,
+          color: options.color
         })
       );
       continue;
@@ -1677,22 +2384,23 @@ async function convertInlinesToTextRuns(spans = [], baseDir = process.cwd()) {
     if (span.type === "code") {
       runs.push(
         new import_docx.TextRun({
-          text: ` ${span.content} `,
+          text: span.content,
           font: "Consolas",
+          size: options.size ? options.size - 2 : 19,
+          color: "0F172A",
           shading: {
             type: import_docx.ShadingType.CLEAR,
-            fill: "F1F5F9",
-            color: "0F172A"
+            fill: "F1F5F9"
           }
         })
       );
       continue;
     }
     if (span.type === "htmlInline") {
-      let colorHex;
+      let colorHex = options.color;
       let bgHex;
-      let isBold = false;
-      let isItalic = false;
+      let isBold = !!options.bold;
+      let isItalic = !!options.italics;
       if (span.style) {
         if (span.style.color) {
           colorHex = span.style.color.replace("#", "").trim();
@@ -1708,13 +2416,9 @@ async function convertInlinesToTextRuns(spans = [], baseDir = process.cwd()) {
         }
       }
       if (span.children && span.children.length > 0) {
-        const childRuns = await convertInlinesToTextRuns(span.children, baseDir);
+        const childRuns = await convertInlinesToTextRuns(span.children, baseDir, options);
         for (const child of childRuns) {
-          if (child instanceof import_docx.TextRun) {
-            runs.push(child);
-          } else {
-            runs.push(child);
-          }
+          runs.push(child);
         }
         continue;
       }
@@ -1724,6 +2428,8 @@ async function convertInlinesToTextRuns(spans = [], baseDir = process.cwd()) {
           color: colorHex,
           bold: isBold,
           italics: isItalic,
+          font: options.font,
+          size: options.size,
           shading: bgHex ? { type: import_docx.ShadingType.CLEAR, fill: bgHex } : void 0
         })
       );
@@ -1731,91 +2437,239 @@ async function convertInlinesToTextRuns(spans = [], baseDir = process.cwd()) {
     }
     runs.push(
       new import_docx.TextRun({
-        text: span.content
+        text: span.content,
+        font: options.font,
+        size: options.size,
+        color: options.color,
+        bold: options.bold,
+        italics: options.italics
       })
     );
   }
   return runs;
 }
 async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
-  const metadata = { ...config.metadata, ...doc.metadata };
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+  const resolved = resolveDocumentConfig(doc.metadata, config);
   const docElements = [];
-  if (metadata.title) {
+  const themeProps = typeof resolved.theme === "object" ? resolved.theme : {};
+  const primaryHex = (themeProps.primaryColor || "#33CDCF").replace("#", "");
+  const primaryDarkHex = (themeProps.primaryDark || "#009DA0").replace("#", "");
+  const textHex = (themeProps.textColor || "#0F172A").replace("#", "");
+  const textMutedHex = (themeProps.textMuted || "#64748B").replace("#", "");
+  const borderHex = (themeProps.borderColor || "#E2E8F0").replace("#", "");
+  const cardBgHex = (themeProps.cardBackground || "#F8FAFC").replace("#", "");
+  const defaultFont = themeProps.fontFamily ? themeProps.fontFamily.split(",")[0].replace(/['"]/g, "").trim() : "Segoe UI";
+  if (resolved.title) {
     docElements.push(
       new import_docx.Paragraph({
-        text: metadata.title,
-        heading: import_docx.HeadingLevel.TITLE,
-        spacing: { before: 200, after: 120 }
+        children: [
+          new import_docx.TextRun({
+            text: resolved.title,
+            bold: true,
+            size: 44,
+            // 22pt
+            color: textHex,
+            font: defaultFont
+          })
+        ],
+        spacing: { before: 120, after: 80 }
       })
     );
-    if (metadata.subtitle) {
+    if (resolved.subtitle) {
       docElements.push(
         new import_docx.Paragraph({
           children: [
             new import_docx.TextRun({
-              text: metadata.subtitle,
-              italics: true,
-              color: "64748B",
-              size: 24
+              text: resolved.subtitle,
+              color: textMutedHex,
+              size: 24,
               // 12pt
+              font: defaultFont
             })
           ],
-          spacing: { after: 180 }
+          spacing: { before: 60, after: 120 }
         })
       );
     }
-    if (metadata.author || metadata.date) {
+    if (resolved.author || resolved.date || resolved.version || resolved.company) {
       const metaParts = [];
-      if (metadata.author) metaParts.push(`Author: ${Array.isArray(metadata.author) ? metadata.author.join(", ") : metadata.author}`);
-      if (metadata.date) metaParts.push(`Date: ${metadata.date}`);
+      if (resolved.author) metaParts.push(`Author: ${resolved.author}`);
+      if (resolved.version) metaParts.push(`Version: ${resolved.version}`);
+      if (resolved.date) metaParts.push(`Date: ${resolved.date}`);
       docElements.push(
         new import_docx.Paragraph({
           children: [
             new import_docx.TextRun({
-              text: metaParts.join("  |  "),
-              color: "94A3B8",
-              size: 20
-              // 10pt
+              text: metaParts.join("    "),
+              color: textMutedHex,
+              size: 18,
+              // 9pt
+              font: defaultFont
             })
           ],
-          spacing: { after: 360 },
+          spacing: { before: 40, after: 240 },
           border: {
             bottom: {
-              color: "E2E8F0",
-              space: 10,
+              color: borderHex,
+              space: 12,
               style: import_docx.BorderStyle.SINGLE,
-              size: 6
+              size: 4
             }
           }
         })
       );
     }
   }
-  for (const node of doc.nodes) {
-    if (node.type === "heading") {
-      let headingLevel = import_docx.HeadingLevel.HEADING_1;
-      if (node.level === 2) headingLevel = import_docx.HeadingLevel.HEADING_2;
-      if (node.level === 3) headingLevel = import_docx.HeadingLevel.HEADING_3;
-      if (node.level === 4) headingLevel = import_docx.HeadingLevel.HEADING_4;
-      if (node.level === 5) headingLevel = import_docx.HeadingLevel.HEADING_5;
-      if (node.level === 6) headingLevel = import_docx.HeadingLevel.HEADING_6;
-      const runs = await convertInlinesToTextRuns(node.inlines, baseDir);
-      docElements.push(
+  if (resolved.toc) {
+    const headingNodes = doc.nodes.filter(
+      (n) => n.type === "heading" && typeof n.level === "number" && n.level >= 1 && n.level <= 3
+    );
+    if (headingNodes.length > 0) {
+      const tocParagraphs = [
         new import_docx.Paragraph({
-          heading: headingLevel,
-          children: runs,
-          spacing: { before: 240, after: 120 }
+          children: [
+            new import_docx.TextRun({
+              text: "TABLE OF CONTENTS",
+              bold: true,
+              size: 18,
+              // 9pt
+              color: textMutedHex,
+              font: defaultFont
+            })
+          ],
+          spacing: { after: 120 },
+          border: {
+            bottom: {
+              color: borderHex,
+              space: 6,
+              style: import_docx.BorderStyle.SINGLE,
+              size: 4
+            }
+          }
         })
-      );
+      ];
+      for (const h of headingNodes) {
+        const indentLeft = (h.level - 1) * 240;
+        tocParagraphs.push(
+          new import_docx.Paragraph({
+            indent: { left: indentLeft },
+            children: [
+              new import_docx.TextRun({
+                text: h.text,
+                bold: h.level === 1,
+                color: primaryDarkHex,
+                size: h.level === 1 ? 21 : 20,
+                font: defaultFont
+              })
+            ],
+            spacing: { before: 20, after: 20 }
+          })
+        );
+      }
+      const tocCard = new import_docx.Table({
+        width: { size: 100, type: import_docx.WidthType.PERCENTAGE },
+        columnWidths: [9e3],
+        rows: [
+          new import_docx.TableRow({
+            children: [
+              new import_docx.TableCell({
+                width: { size: 9e3, type: import_docx.WidthType.DXA },
+                shading: { fill: cardBgHex, type: import_docx.ShadingType.CLEAR },
+                margins: { top: 140, bottom: 140, left: 180, right: 180 },
+                borders: {
+                  top: { style: import_docx.BorderStyle.SINGLE, size: 4, color: borderHex },
+                  bottom: { style: import_docx.BorderStyle.SINGLE, size: 4, color: borderHex },
+                  left: { style: import_docx.BorderStyle.SINGLE, size: 4, color: borderHex },
+                  right: { style: import_docx.BorderStyle.SINGLE, size: 4, color: borderHex }
+                },
+                children: tocParagraphs
+              })
+            ]
+          })
+        ]
+      });
+      docElements.push(tocCard);
+      docElements.push(new import_docx.Paragraph({ spacing: { after: 200 } }));
+    }
+  }
+  for (const node of doc.nodes) {
+    if (node.type === "heading") {
+      if (node.level === 1) {
+        const runs = await convertInlinesToTextRuns(node.inlines, baseDir, {
+          font: defaultFont,
+          size: 34,
+          // 17pt
+          color: textHex,
+          bold: true
+        });
+        docElements.push(
+          new import_docx.Paragraph({
+            heading: import_docx.HeadingLevel.HEADING_1,
+            children: runs,
+            spacing: { before: 360, after: 140 },
+            border: {
+              bottom: {
+                color: primaryHex,
+                space: 6,
+                style: import_docx.BorderStyle.SINGLE,
+                size: 16
+              }
+            }
+          })
+        );
+      } else if (node.level === 2) {
+        const runs = await convertInlinesToTextRuns(node.inlines, baseDir, {
+          font: defaultFont,
+          size: 26,
+          // 13pt
+          color: primaryDarkHex,
+          bold: true
+        });
+        docElements.push(
+          new import_docx.Paragraph({
+            heading: import_docx.HeadingLevel.HEADING_2,
+            children: runs,
+            spacing: { before: 280, after: 100 },
+            border: {
+              bottom: {
+                color: borderHex,
+                space: 4,
+                style: import_docx.BorderStyle.SINGLE,
+                size: 4
+              }
+            }
+          })
+        );
+      } else {
+        const runs = await convertInlinesToTextRuns(node.inlines, baseDir, {
+          font: defaultFont,
+          size: 22,
+          // 11pt
+          color: textHex,
+          bold: true
+        });
+        docElements.push(
+          new import_docx.Paragraph({
+            heading: node.level === 3 ? import_docx.HeadingLevel.HEADING_3 : import_docx.HeadingLevel.HEADING_4,
+            children: runs,
+            spacing: { before: 200, after: 80 }
+          })
+        );
+      }
       continue;
     }
     if (node.type === "paragraph") {
-      const runs = await convertInlinesToTextRuns(node.inlines, baseDir);
+      const runs = await convertInlinesToTextRuns(node.inlines, baseDir, {
+        font: defaultFont,
+        size: 22,
+        // 11pt
+        color: "334155"
+      });
       docElements.push(
         new import_docx.Paragraph({
           children: runs,
-          spacing: { before: 60, after: 140 }
+          spacing: { before: 40, after: 140, line: 280 }
         })
       );
       continue;
@@ -1887,7 +2741,11 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
         bgFill = "F5F3FF";
         title = "IMPORTANT";
       }
-      const runs = await convertInlinesToTextRuns(node.inlines, baseDir);
+      const runs = await convertInlinesToTextRuns(node.inlines, baseDir, {
+        font: defaultFont,
+        size: 21,
+        color: "334155"
+      });
       const calloutTable = new import_docx.Table({
         width: { size: 100, type: import_docx.WidthType.PERCENTAGE },
         columnWidths: [9e3],
@@ -1902,7 +2760,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
                   top: { style: import_docx.BorderStyle.NONE },
                   bottom: { style: import_docx.BorderStyle.NONE },
                   right: { style: import_docx.BorderStyle.NONE },
-                  left: { style: import_docx.BorderStyle.SINGLE, size: 16, color: borderColor }
+                  left: { style: import_docx.BorderStyle.SINGLE, size: 20, color: borderColor }
                 },
                 children: [
                   new import_docx.Paragraph({
@@ -1911,13 +2769,15 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
                         text: `[${title}]`,
                         bold: true,
                         color: borderColor,
+                        font: defaultFont,
                         size: 20
                       })
                     ],
-                    spacing: { after: 60 }
+                    spacing: { after: 40 }
                   }),
                   new import_docx.Paragraph({
-                    children: runs
+                    children: runs,
+                    spacing: { line: 270 }
                   })
                 ]
               })
@@ -1935,17 +2795,27 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
       if (lines.length > 0) {
         for (const lineText of lines) {
           const spans = parseInlineSpans(lineText.replace(/^>\s?/, "").trim());
-          const lineRuns = await convertInlinesToTextRuns(spans, baseDir);
+          const lineRuns = await convertInlinesToTextRuns(spans, baseDir, {
+            font: defaultFont,
+            size: 21,
+            color: "475569",
+            italics: true
+          });
           quoteParagraphs.push(
             new import_docx.Paragraph({
               children: lineRuns,
-              spacing: { before: 40, after: 40 }
+              spacing: { before: 20, after: 20, line: 260 }
             })
           );
         }
       } else {
-        const runs = await convertInlinesToTextRuns(node.inlines, baseDir);
-        quoteParagraphs.push(new import_docx.Paragraph({ children: runs }));
+        const runs = await convertInlinesToTextRuns(node.inlines, baseDir, {
+          font: defaultFont,
+          size: 21,
+          color: "475569",
+          italics: true
+        });
+        quoteParagraphs.push(new import_docx.Paragraph({ children: runs, spacing: { line: 260 } }));
       }
       const quoteTable = new import_docx.Table({
         width: { size: 100, type: import_docx.WidthType.PERCENTAGE },
@@ -1961,7 +2831,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
                   top: { style: import_docx.BorderStyle.NONE },
                   bottom: { style: import_docx.BorderStyle.NONE },
                   right: { style: import_docx.BorderStyle.NONE },
-                  left: { style: import_docx.BorderStyle.SINGLE, size: 12, color: "33CDCF" }
+                  left: { style: import_docx.BorderStyle.SINGLE, size: 16, color: primaryHex }
                 },
                 children: quoteParagraphs
               })
@@ -1996,7 +2866,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
         docElements.push(
           new import_docx.Paragraph({
             children: [
-              new import_docx.TextRun({ text: "[Mermaid Diagram: " + (node.text || "").slice(0, 40) + "...]", bold: true, color: "33CDCF" })
+              new import_docx.TextRun({ text: "[Mermaid Diagram: " + (node.text || "").slice(0, 40) + "...]", bold: true, color: primaryHex })
             ],
             spacing: { before: 60, after: 60 }
           })
@@ -2008,8 +2878,11 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
       const tableRows = [];
       const numCols = ((_b = (_a = node.children[0]) == null ? void 0 : _a.children) == null ? void 0 : _b.length) || 1;
       const colWidth = Math.floor(9e3 / numCols);
-      for (const rowNode of node.children) {
+      for (let rowIdx = 0; rowIdx < node.children.length; rowIdx++) {
+        const rowNode = node.children[rowIdx];
         const cells = [];
+        const isHeader = rowNode.isHeader;
+        const rowBg = isHeader ? "F1F5F9" : rowIdx % 2 === 0 ? "FFFFFF" : "F8FAFC";
         if (rowNode.children) {
           for (let colIdx = 0; colIdx < rowNode.children.length; colIdx++) {
             const cellNode = rowNode.children[colIdx];
@@ -2017,22 +2890,27 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
             let alignment = import_docx.AlignmentType.LEFT;
             if (align === "center") alignment = import_docx.AlignmentType.CENTER;
             if (align === "right") alignment = import_docx.AlignmentType.RIGHT;
-            const runs = await convertInlinesToTextRuns(cellNode.inlines, baseDir);
+            const runs = await convertInlinesToTextRuns(cellNode.inlines, baseDir, {
+              font: defaultFont,
+              size: 20,
+              color: isHeader ? "0F172A" : "334155",
+              bold: isHeader
+            });
             cells.push(
               new import_docx.TableCell({
                 width: { size: colWidth, type: import_docx.WidthType.DXA },
-                shading: rowNode.isHeader ? { fill: "F1F5F9", type: import_docx.ShadingType.CLEAR } : void 0,
-                margins: { top: 100, bottom: 100, left: 120, right: 120 },
+                shading: { fill: rowBg, type: import_docx.ShadingType.CLEAR },
+                margins: { top: 100, bottom: 100, left: 140, right: 140 },
                 borders: {
-                  top: { style: import_docx.BorderStyle.SINGLE, size: 4, color: "CBD5E1" },
-                  bottom: { style: import_docx.BorderStyle.SINGLE, size: 4, color: "CBD5E1" },
-                  left: { style: import_docx.BorderStyle.SINGLE, size: 4, color: "CBD5E1" },
-                  right: { style: import_docx.BorderStyle.SINGLE, size: 4, color: "CBD5E1" }
+                  top: { style: import_docx.BorderStyle.SINGLE, size: 4, color: "E2E8F0" },
+                  bottom: { style: import_docx.BorderStyle.SINGLE, size: isHeader ? 8 : 4, color: isHeader ? "CBD5E1" : "E2E8F0" },
+                  left: { style: import_docx.BorderStyle.SINGLE, size: 4, color: "E2E8F0" },
+                  right: { style: import_docx.BorderStyle.SINGLE, size: 4, color: "E2E8F0" }
                 },
                 children: [
                   new import_docx.Paragraph({
                     alignment,
-                    children: rowNode.isHeader ? runs.map((r) => r instanceof import_docx.TextRun ? new import_docx.TextRun({ ...r, bold: true, color: "0F172A" }) : r) : runs
+                    children: runs
                   })
                 ]
               })
@@ -2041,7 +2919,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
         }
         tableRows.push(
           new import_docx.TableRow({
-            tableHeader: rowNode.isHeader,
+            tableHeader: isHeader,
             children: cells
           })
         );
@@ -2057,7 +2935,11 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
     }
     if (node.type === "list" && node.children) {
       for (const item of node.children) {
-        const runs = await convertInlinesToTextRuns(item.inlines, baseDir);
+        const runs = await convertInlinesToTextRuns(item.inlines, baseDir, {
+          font: defaultFont,
+          size: 21,
+          color: "334155"
+        });
         let prefix = "";
         if (item.checked !== void 0) {
           prefix = item.checked ? "[X] " : "[ ] ";
@@ -2069,7 +2951,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
               ...prefix ? [new import_docx.TextRun({ text: prefix, bold: true, font: "Consolas" })] : [],
               ...runs
             ],
-            spacing: { before: 40, after: 40 }
+            spacing: { before: 20, after: 20, line: 260 }
           })
         );
       }
@@ -2144,88 +3026,258 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
       continue;
     }
   }
-  const headerObj = metadata.header || config.header;
-  const footerObj = metadata.footer || config.footer;
-  const headerTabStops = [
-    { type: import_docx.TabStopType.CENTER, position: 4513 },
-    { type: import_docx.TabStopType.RIGHT, position: 9026 }
-  ];
-  const docHeader = headerObj ? new import_docx.Header({
+  if (resolved.signatures && resolved.signatures.items.length > 0) {
+    const sig = resolved.signatures;
+    const numItems = sig.items.length;
+    const contentWidth = Math.max(
+      1e3,
+      resolved.paperDimensions.widthTwip - resolved.margins.leftTwip - resolved.margins.rightTwip
+    );
+    docElements.push(new import_docx.Paragraph({ spacing: { before: sig.spacingBeforeTwip } }));
+    const sigCells = [];
+    const colWidths = [];
+    if (numItems === 1) {
+      const cardWidth = Math.min(3400, Math.floor(contentWidth * 0.42));
+      const spacerWidth = contentWidth - cardWidth;
+      const cardCell = await buildDocxSignatureCell(sig.items[0], sig, cardWidth, defaultFont, baseDir);
+      if (sig.align === "left") {
+        colWidths.push(cardWidth, spacerWidth);
+        sigCells.push(cardCell, createEmptyDocxCell(spacerWidth));
+      } else if (sig.align === "center") {
+        const sideWidth = Math.floor(spacerWidth / 2);
+        colWidths.push(sideWidth, cardWidth, sideWidth);
+        sigCells.push(createEmptyDocxCell(sideWidth), cardCell, createEmptyDocxCell(sideWidth));
+      } else {
+        colWidths.push(spacerWidth, cardWidth);
+        sigCells.push(createEmptyDocxCell(spacerWidth), cardCell);
+      }
+    } else {
+      const colWidth = Math.floor(contentWidth / numItems);
+      for (let i = 0; i < numItems; i++) {
+        colWidths.push(colWidth);
+        const cell = await buildDocxSignatureCell(sig.items[i], sig, colWidth, defaultFont, baseDir);
+        sigCells.push(cell);
+      }
+    }
+    const sigTable = new import_docx.Table({
+      width: { size: 100, type: import_docx.WidthType.PERCENTAGE },
+      columnWidths: colWidths,
+      borders: {
+        top: { style: import_docx.BorderStyle.NONE, size: 0, color: "auto" },
+        bottom: { style: import_docx.BorderStyle.NONE, size: 0, color: "auto" },
+        left: { style: import_docx.BorderStyle.NONE, size: 0, color: "auto" },
+        right: { style: import_docx.BorderStyle.NONE, size: 0, color: "auto" },
+        insideHorizontal: { style: import_docx.BorderStyle.NONE, size: 0, color: "auto" },
+        insideVertical: { style: import_docx.BorderStyle.NONE, size: 0, color: "auto" }
+      },
+      rows: [
+        new import_docx.TableRow({
+          cantSplit: true,
+          children: sigCells
+        })
+      ]
+    });
+    docElements.push(sigTable);
+  }
+  const contentWidthTwip = Math.max(
+    1e3,
+    resolved.paperDimensions.widthTwip - resolved.margins.leftTwip - resolved.margins.rightTwip
+  );
+  const centerPos = Math.round(contentWidthTwip / 2);
+  const rightPos = contentWidthTwip;
+  const headerRuns = [];
+  if ((_d = resolved.header) == null ? void 0 : _d.left) {
+    headerRuns.push(
+      new import_docx.TextRun({
+        text: resolved.header.left.text,
+        color: resolved.header.left.color.replace("#", ""),
+        size: (resolved.header.left.fontSize || 9) * 2,
+        font: resolved.header.left.fontFamily || defaultFont,
+        bold: resolved.header.left.bold,
+        italics: resolved.header.left.italic
+      })
+    );
+  }
+  headerRuns.push(new import_docx.TextRun({ text: "	" }));
+  if ((_e = resolved.header) == null ? void 0 : _e.center) {
+    headerRuns.push(
+      new import_docx.TextRun({
+        text: resolved.header.center.text,
+        color: resolved.header.center.color.replace("#", ""),
+        size: (resolved.header.center.fontSize || 9) * 2,
+        font: resolved.header.center.fontFamily || defaultFont,
+        bold: resolved.header.center.bold,
+        italics: resolved.header.center.italic
+      })
+    );
+  }
+  headerRuns.push(new import_docx.TextRun({ text: "	" }));
+  if ((_f = resolved.header) == null ? void 0 : _f.right) {
+    headerRuns.push(
+      new import_docx.TextRun({
+        text: resolved.header.right.text,
+        color: resolved.header.right.color.replace("#", ""),
+        size: (resolved.header.right.fontSize || 9) * 2,
+        font: resolved.header.right.fontFamily || defaultFont,
+        bold: resolved.header.right.bold,
+        italics: resolved.header.right.italic
+      })
+    );
+  }
+  const docHeader = resolved.header ? new import_docx.Header({
     children: [
       new import_docx.Paragraph({
-        tabStops: headerTabStops,
-        children: [
-          // Left zone
-          ...headerObj.left ? [
+        tabStops: [
+          {
+            type: import_docx.TabStopType.CENTER,
+            position: centerPos
+          },
+          {
+            type: import_docx.TabStopType.RIGHT,
+            position: rightPos
+          }
+        ],
+        border: resolved.header.divider ? {
+          bottom: {
+            style: import_docx.BorderStyle.SINGLE,
+            size: 4,
+            space: 6,
+            color: (resolved.header.dividerColor || "#CBD5E1").replace("#", "")
+          }
+        } : void 0,
+        children: headerRuns,
+        spacing: { after: 120 }
+      })
+    ]
+  }) : void 0;
+  const footerRuns = [];
+  if ((_g = resolved.footer) == null ? void 0 : _g.left) {
+    footerRuns.push(
+      new import_docx.TextRun({
+        text: resolved.footer.left.text,
+        color: resolved.footer.left.color.replace("#", ""),
+        size: (resolved.footer.left.fontSize || 9) * 2,
+        font: resolved.footer.left.fontFamily || defaultFont,
+        bold: resolved.footer.left.bold,
+        italics: resolved.footer.left.italic
+      })
+    );
+  }
+  footerRuns.push(new import_docx.TextRun({ text: "	" }));
+  if ((_h = resolved.footer) == null ? void 0 : _h.center) {
+    footerRuns.push(
+      new import_docx.TextRun({
+        text: resolved.footer.center.text,
+        color: resolved.footer.center.color.replace("#", ""),
+        size: (resolved.footer.center.fontSize || 9) * 2,
+        font: resolved.footer.center.fontFamily || defaultFont,
+        bold: resolved.footer.center.bold,
+        italics: resolved.footer.center.italic
+      })
+    );
+  }
+  footerRuns.push(new import_docx.TextRun({ text: "	" }));
+  if ((_i = resolved.footer) == null ? void 0 : _i.right) {
+    const rZone = resolved.footer.right;
+    const rColor = rZone.color.replace("#", "");
+    const rSize = (rZone.fontSize || 9) * 2;
+    const rFont = rZone.fontFamily || defaultFont;
+    const rBold = rZone.bold;
+    const rItalics = rZone.italic;
+    if (rZone.text.includes("{page}") || rZone.text.includes("{pages}")) {
+      const parts = rZone.text.split(/(\{page\}|\{pages\})/gi);
+      for (const part of parts) {
+        if (part.toLowerCase() === "{page}") {
+          footerRuns.push(
             new import_docx.TextRun({
-              text: headerObj.left.replace("{title}", metadata.title || ""),
-              color: "94A3B8",
-              size: 18
+              children: [import_docx.PageNumber.CURRENT],
+              color: rColor,
+              size: rSize,
+              font: rFont,
+              bold: rBold,
+              italics: rItalics
             })
-          ] : [],
-          // Center zone (tab + text)
-          ...headerObj.center ? [
-            new import_docx.TextRun({ text: "	", color: "94A3B8", size: 18 }),
+          );
+        } else if (part.toLowerCase() === "{pages}") {
+          footerRuns.push(
             new import_docx.TextRun({
-              text: headerObj.center.replace("{title}", metadata.title || ""),
-              color: "94A3B8",
-              size: 18
+              children: [import_docx.PageNumber.TOTAL_PAGES],
+              color: rColor,
+              size: rSize,
+              font: rFont,
+              bold: rBold,
+              italics: rItalics
             })
-          ] : [],
-          // Right zone (tab + text) — skip extra tab if center already used one
-          ...headerObj.right ? [
-            new import_docx.TextRun({
-              text: headerObj.left || headerObj.center ? "	" : "",
-              color: "94A3B8",
-              size: 18
-            }),
+          );
+        } else if (part) {
+          footerRuns.push(
             new import_docx.TextRun({
-              text: headerObj.right.replace("{title}", metadata.title || ""),
-              color: "94A3B8",
-              size: 18
+              text: part,
+              color: rColor,
+              size: rSize,
+              font: rFont,
+              bold: rBold,
+              italics: rItalics
             })
-          ] : []
-        ]
-      })
-    ]
-  }) : void 0;
-  const docFooter = footerObj ? new import_docx.Footer({
+          );
+        }
+      }
+    } else {
+      footerRuns.push(
+        new import_docx.TextRun({
+          text: rZone.text,
+          color: rColor,
+          size: rSize,
+          font: rFont,
+          bold: rBold,
+          italics: rItalics
+        })
+      );
+    }
+  }
+  const docFooter = resolved.footer ? new import_docx.Footer({
     children: [
       new import_docx.Paragraph({
-        tabStops: headerTabStops,
-        children: [
-          // Left zone
-          ...footerObj.left ? [
-            new import_docx.TextRun({
-              text: footerObj.left.replace("{page}", "").replace("{pages}", "").trim(),
-              color: "94A3B8",
-              size: 18
-            })
-          ] : [],
-          // Right zone: always includes page number if right is configured or footer exists
-          new import_docx.TextRun({ text: "	", color: "94A3B8", size: 18 }),
-          new import_docx.TextRun({ text: "Page ", color: "94A3B8", size: 18 }),
-          new import_docx.TextRun({ children: [import_docx.PageNumber.CURRENT], color: "94A3B8", size: 18 }),
-          new import_docx.TextRun({ text: " of ", color: "94A3B8", size: 18 }),
-          new import_docx.TextRun({ children: [import_docx.PageNumber.TOTAL_PAGES], color: "94A3B8", size: 18 })
-        ]
+        tabStops: [
+          {
+            type: import_docx.TabStopType.CENTER,
+            position: centerPos
+          },
+          {
+            type: import_docx.TabStopType.RIGHT,
+            position: rightPos
+          }
+        ],
+        border: resolved.footer.divider ? {
+          top: {
+            style: import_docx.BorderStyle.SINGLE,
+            size: 4,
+            space: 6,
+            color: (resolved.footer.dividerColor || "#CBD5E1").replace("#", "")
+          }
+        } : void 0,
+        children: footerRuns,
+        spacing: { before: 120 }
       })
     ]
   }) : void 0;
-  const topMargin = parseMarginToTwip(((_d = metadata.margins) == null ? void 0 : _d.top) || ((_e = config.margins) == null ? void 0 : _e.top), 1440);
-  const bottomMargin = parseMarginToTwip(((_f = metadata.margins) == null ? void 0 : _f.bottom) || ((_g = config.margins) == null ? void 0 : _g.bottom), 1440);
-  const leftMargin = parseMarginToTwip(((_h = metadata.margins) == null ? void 0 : _h.left) || ((_i = config.margins) == null ? void 0 : _i.left), 1440);
-  const rightMargin = parseMarginToTwip(((_j = metadata.margins) == null ? void 0 : _j.right) || ((_k = config.margins) == null ? void 0 : _k.right), 1440);
-  const isLandscape = (metadata.orientation || config.orientation) === "landscape";
+  const isLandscape = resolved.orientation === "landscape";
   const document = new import_docx.Document({
     styles: {
       default: {
         document: {
           run: {
-            font: "Segoe UI",
-            size: 22,
-            // 11pt
-            color: "0F172A"
+            font: defaultFont,
+            size: 21,
+            // 10.5pt
+            color: textHex
+          },
+          paragraph: {
+            spacing: {
+              line: 276,
+              // 1.15 line spacing
+              after: 140
+            }
           }
         }
       }
@@ -2235,13 +3287,15 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
         properties: {
           page: {
             size: {
+              width: resolved.paperDimensions.widthTwip,
+              height: resolved.paperDimensions.heightTwip,
               orientation: isLandscape ? import_docx.PageOrientation.LANDSCAPE : import_docx.PageOrientation.PORTRAIT
             },
             margin: {
-              top: topMargin,
-              bottom: bottomMargin,
-              left: leftMargin,
-              right: rightMargin,
+              top: resolved.margins.topTwip,
+              bottom: resolved.margins.bottomTwip,
+              left: resolved.margins.leftTwip,
+              right: resolved.margins.rightTwip,
               header: 720,
               footer: 720
             }
@@ -2255,153 +3309,139 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
   });
   return await import_docx.Packer.toBuffer(document);
 }
-
-// src/config/loadConfig.ts
-var fs5 = __toESM(require("fs"));
-var path5 = __toESM(require("path"));
-var import_node_url3 = require("url");
-var YAML = __toESM(require("yaml"));
-var DEFAULT_CONFIG_FILENAMES = [
-  "markforge.config.json",
-  ".markforgerc.json",
-  "markforge.config.yaml",
-  "markforge.config.yml",
-  ".markforgerc.yaml",
-  ".markforgerc.yml",
-  ".markforgerc",
-  "markforge.config.ts",
-  "markforge.config.js",
-  "markforge.config.mjs",
-  "markforge.config.cjs"
-];
-var DEFAULT_CONFIG = {
-  to: ["docx", "pdf"],
-  outputDir: void 0,
-  theme: "default",
-  css: void 0,
-  orientation: "portrait",
-  paperSize: "A4",
-  margins: {
-    top: "2.5cm",
-    bottom: "2.5cm",
-    left: "2.5cm",
-    right: "2.5cm"
-  },
-  header: void 0,
-  footer: {
-    right: "Page {page} of {pages}"
-  },
-  toc: false,
-  watermark: void 0,
-  embedImages: true,
-  metadata: void 0,
-  watch: false,
-  serve: false,
-  port: 4e3,
-  open: false,
-  bundleHtml: true,
-  syntaxTheme: "github-dark"
-};
-function discoverConfigFile(startDir) {
-  const dirsToCheck = [];
-  let curr = path5.resolve(startDir);
-  while (curr) {
-    dirsToCheck.push(curr);
-    const parent = path5.dirname(curr);
-    if (parent === curr) break;
-    curr = parent;
-  }
-  const cwd = path5.resolve(process.cwd());
-  if (!dirsToCheck.includes(cwd)) {
-    dirsToCheck.push(cwd);
-  }
-  for (const dir of dirsToCheck) {
-    for (const filename of DEFAULT_CONFIG_FILENAMES) {
-      const candidate = path5.join(dir, filename);
-      if (fs5.existsSync(candidate) && fs5.statSync(candidate).isFile()) {
-        return candidate;
-      }
-    }
+async function buildDocxSignatureCell(item, sig, widthDxa, defaultFont, baseDir) {
+  const cellParagraphs = [];
+  if (item.title) {
+    cellParagraphs.push(
+      new import_docx.Paragraph({
+        children: [
+          new import_docx.TextRun({
+            text: item.title,
+            font: defaultFont,
+            size: 18,
+            // 9pt
+            color: sig.titleColor.replace("#", ""),
+            bold: true
+          })
+        ],
+        spacing: { after: 60 }
+      })
+    );
   }
-  return null;
-}
-async function loadConfig(customPath, startDir = process.cwd()) {
-  let resolvedPath = null;
-  if (customPath) {
-    resolvedPath = path5.isAbsolute(customPath) ? customPath : path5.resolve(process.cwd(), customPath);
-    if (!fs5.existsSync(resolvedPath)) {
-      const altPath = path5.resolve(startDir, customPath);
-      if (fs5.existsSync(altPath)) {
-        resolvedPath = altPath;
-      } else {
-        throw new Error(`Configuration file not found: ${resolvedPath}`);
-      }
+  if (item.image) {
+    const resolvedImg = await resolveImage(item.image, baseDir);
+    if (resolvedImg) {
+      cellParagraphs.push(
+        new import_docx.Paragraph({
+          children: [
+            new import_docx.ImageRun({
+              data: resolvedImg.buffer,
+              transformation: {
+                width: 140,
+                height: 60
+              },
+              type: "png"
+            })
+          ],
+          spacing: { before: 40, after: 40 }
+        })
+      );
+    } else {
+      cellParagraphs.push(new import_docx.Paragraph({ spacing: { before: 240, after: 240 } }));
     }
   } else {
-    resolvedPath = discoverConfigFile(startDir);
+    cellParagraphs.push(new import_docx.Paragraph({ spacing: { before: 240, after: 240 } }));
   }
-  if (!resolvedPath) {
-    return {
-      config: { ...DEFAULT_CONFIG },
-      configPath: null
-    };
+  if (sig.style === "line") {
+    cellParagraphs.push(
+      new import_docx.Paragraph({
+        border: {
+          bottom: {
+            style: import_docx.BorderStyle.SINGLE,
+            size: 6,
+            space: 2,
+            color: sig.borderColor.replace("#", "")
+          }
+        },
+        spacing: { after: 60 }
+      })
+    );
   }
-  const ext = path5.extname(resolvedPath).toLowerCase();
-  let userConfig = {};
-  try {
-    if (ext === ".json" || ext === "" || resolvedPath.endsWith(".markforgerc")) {
-      const raw = fs5.readFileSync(resolvedPath, "utf-8").trim();
-      try {
-        userConfig = JSON.parse(raw);
-      } catch {
-        userConfig = YAML.parse(raw) || {};
-      }
-    } else if (ext === ".yaml" || ext === ".yml") {
-      const raw = fs5.readFileSync(resolvedPath, "utf-8");
-      userConfig = YAML.parse(raw) || {};
-    } else if (ext === ".ts" || ext === ".js" || ext === ".mjs" || ext === ".cjs") {
-      try {
-        const fileUrl = `${(0, import_node_url3.pathToFileURL)(resolvedPath).href}?t=${Date.now()}`;
-        const mod = await import(fileUrl);
-        const rawExport = mod.default ?? mod.config ?? mod;
-        userConfig = (typeof rawExport === "function" ? await rawExport() : rawExport) || {};
-      } catch (importErr) {
-        try {
-          const mod = require(resolvedPath);
-          const rawExport = mod.default ?? mod.config ?? mod;
-          userConfig = (typeof rawExport === "function" ? await rawExport() : rawExport) || {};
-        } catch {
-          throw importErr;
-        }
-      }
-    }
-  } catch (err) {
-    throw new Error(
-      `Failed to parse configuration file at ${resolvedPath}: ${err instanceof Error ? err.message : String(err)}`
+  cellParagraphs.push(
+    new import_docx.Paragraph({
+      children: [
+        new import_docx.TextRun({
+          text: item.name,
+          font: defaultFont,
+          size: 21,
+          // 10.5pt
+          bold: true,
+          color: sig.nameColor.replace("#", "")
+        })
+      ],
+      spacing: { before: sig.style === "line" ? 40 : 20, after: 20 }
+    })
+  );
+  if (item.role) {
+    cellParagraphs.push(
+      new import_docx.Paragraph({
+        children: [
+          new import_docx.TextRun({
+            text: item.role,
+            font: defaultFont,
+            size: 18,
+            // 9pt
+            color: sig.roleColor.replace("#", "")
+          })
+        ],
+        spacing: { after: 20 }
+      })
     );
   }
-  if (userConfig && typeof userConfig === "object" && "$schema" in userConfig) {
-    delete userConfig.$schema;
+  if (item.date) {
+    cellParagraphs.push(
+      new import_docx.Paragraph({
+        children: [
+          new import_docx.TextRun({
+            text: `Date: ${item.date}`,
+            font: defaultFont,
+            size: 17,
+            // 8.5pt
+            color: sig.roleColor.replace("#", "")
+          })
+        ],
+        spacing: { after: 20 }
+      })
+    );
   }
-  const parsedConfig = userConfig;
-  const mergedConfig = {
-    ...DEFAULT_CONFIG,
-    ...parsedConfig,
-    margins: {
-      ...DEFAULT_CONFIG.margins,
-      ...parsedConfig.margins || {}
+  const isBox = sig.style === "box";
+  const boxBorder = { style: import_docx.BorderStyle.SINGLE, size: 4, color: sig.borderColor.replace("#", "") };
+  const noneBorder = { style: import_docx.BorderStyle.NONE, size: 0, color: "auto" };
+  return new import_docx.TableCell({
+    width: { size: widthDxa, type: import_docx.WidthType.DXA },
+    shading: isBox ? { fill: "F8FAFC", type: import_docx.ShadingType.CLEAR } : void 0,
+    margins: isBox ? { top: 140, bottom: 140, left: 160, right: 160 } : { top: 60, bottom: 60, left: 60, right: 60 },
+    borders: {
+      top: isBox ? boxBorder : noneBorder,
+      bottom: isBox ? boxBorder : noneBorder,
+      left: isBox ? boxBorder : noneBorder,
+      right: isBox ? boxBorder : noneBorder
     },
-    header: parsedConfig.header !== void 0 ? parsedConfig.header : DEFAULT_CONFIG.header,
-    footer: parsedConfig.footer !== void 0 ? parsedConfig.footer : DEFAULT_CONFIG.footer,
-    metadata: {
-      ...DEFAULT_CONFIG.metadata || {},
-      ...parsedConfig.metadata || {}
-    }
-  };
-  return {
-    config: mergedConfig,
-    configPath: resolvedPath
-  };
+    children: cellParagraphs
+  });
+}
+function createEmptyDocxCell(widthDxa) {
+  const noneBorder = { style: import_docx.BorderStyle.NONE, size: 0, color: "auto" };
+  return new import_docx.TableCell({
+    width: { size: widthDxa, type: import_docx.WidthType.DXA },
+    borders: {
+      top: noneBorder,
+      bottom: noneBorder,
+      left: noneBorder,
+      right: noneBorder
+    },
+    children: [new import_docx.Paragraph({})]
+  });
 }
 
 // src/core/engine.ts
@@ -2526,7 +3566,7 @@ try {
   }
 } catch {
 }
-var FALLBACK_VERSION = "0.2.2";
+var FALLBACK_VERSION = "0.3.0";
 function readVersionFromPackageJson(fromDir) {
   let currentDir = fromDir;
   for (let i = 0; i < 6; i++) {
@@ -2564,10 +3604,17 @@ function getMarkforgeVersion(fromDir = getPackageDir()) {
 0 && (module.exports = {
   DEFAULT_CONFIG,
   MARKFORGE_VERSION,
+  Orientation,
+  OutputFormat,
+  PAPER_DIMENSIONS_TWIP,
+  PaperSizeEnum,
   SYNTAX_COLORS,
+  SyntaxTheme,
   THEMES,
-  THEME_ACADEMIC,
+  THEME_CORPORATE,
   THEME_DEFAULT,
+  Theme,
+  WatermarkPosition,
   buildDocxDocument,
   buildHtmlDocument,
   buildPdfDocument,
@@ -2576,6 +3623,7 @@ function getMarkforgeVersion(fromDir = getPackageDir()) {
   escapeHtml,
   findChromeExecutable,
   formatServerTimestamp,
+  generateThemeCss,
   getMarkforgeVersion,
   getMimeType,
   highlightCodeToHtml,
@@ -2583,11 +3631,17 @@ function getMarkforgeVersion(fromDir = getPackageDir()) {
   inlineHtmlImages,
   loadConfig,
   markforge,
+  normalizeHeaderFooter,
+  normalizeHeaderFooterSlot,
+  normalizeSignatures,
+  normalizeWatermark,
   parseInlineSpans,
   parseMarginToTwip,
   parseMarkdownDocument,
   renderInlinesToHtml,
   renderMermaidToPng,
+  replaceDocumentTokens,
+  resolveDocumentConfig,
   resolveImage,
   slugify,
   tokenizeCodeLine