@masumdev/markforge 0.3.0 → 0.4.0

package/dist/{App-AM2CWXHJ.mjs → chunk-CRV7R2BG.mjs}

@@ -7,197 +7,9 @@ try {
     });
   }
 } catch {}
-import {
-  MARKFORGE_VERSION
-} from "./chunk-HKB4CSPZ.mjs";
 import {
   DEFAULT_CONFIG
-} from "./chunk-IYGPJIK5.mjs";
-import "./chunk-YZHGBG4N.mjs";
-
-// src/ui/App.tsx
-import { useState, useEffect } from "react";
-import { Box as Box4 } from "ink";
-
-// src/ui/Header.tsx
-import * as path from "path";
-import { Box, Text } from "ink";
-import { jsx, jsxs } from "react/jsx-runtime";
-function formatDisplayPath(p) {
-  if (!p) return "";
-  try {
-    const rel = path.relative(process.cwd(), p);
-    return rel && !rel.startsWith("..") && rel.length < p.length ? `./${rel}` : p;
-  } catch {
-    return p;
-  }
-}
-var Header = ({
-  inputFile,
-  theme = "corporate",
-  targetFormats = ["docx", "pdf"]
-}) => {
-  const themeLabel = typeof theme === "object" ? "Custom (ThemeProps)" : String(theme || "corporate");
-  return /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginY: 1, children: /* @__PURE__ */ jsxs(
-    Box,
-    {
-      borderStyle: "round",
-      borderColor: "cyan",
-      paddingX: 2,
-      paddingY: 1,
-      flexDirection: "column",
-      children: [
-        /* @__PURE__ */ jsxs(Box, { justifyContent: "space-between", alignItems: "center", children: [
-          /* @__PURE__ */ jsxs(Box, { children: [
-            /* @__PURE__ */ jsx(Text, { bold: true, color: "cyan", children: "MARKFORGE" }),
-            /* @__PURE__ */ jsx(Text, { color: "gray", children: " | Document Publishing Engine" })
-          ] }),
-          /* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsxs(Text, { color: "black", backgroundColor: "cyan", bold: true, children: [
-            " ",
-            "v",
-            MARKFORGE_VERSION,
-            " "
-          ] }) })
-        ] }),
-        /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
-          inputFile && /* @__PURE__ */ jsxs(Box, { children: [
-            /* @__PURE__ */ jsx(Text, { color: "gray", children: "Source:  " }),
-            /* @__PURE__ */ jsx(Text, { color: "white", bold: true, children: formatDisplayPath(inputFile) })
-          ] }),
-          /* @__PURE__ */ jsxs(Box, { justifyContent: "space-between", marginTop: 0, children: [
-            /* @__PURE__ */ jsxs(Box, { children: [
-              /* @__PURE__ */ jsx(Text, { color: "gray", children: "Theme:   " }),
-              /* @__PURE__ */ jsx(Text, { color: "magenta", bold: true, children: themeLabel })
-            ] }),
-            targetFormats && targetFormats.length > 0 && /* @__PURE__ */ jsxs(Box, { children: [
-              /* @__PURE__ */ jsx(Text, { color: "gray", children: "Targets: " }),
-              /* @__PURE__ */ jsx(Text, { color: "yellow", bold: true, children: targetFormats.map((f) => f.toUpperCase()).join(", ") })
-            ] })
-          ] })
-        ] }),
-        /* @__PURE__ */ jsxs(Box, { marginTop: 1, justifyContent: "space-between", children: [
-          /* @__PURE__ */ jsxs(Box, { children: [
-            /* @__PURE__ */ jsx(Text, { color: "gray", children: "Author: " }),
-            /* @__PURE__ */ jsx(Text, { color: "cyan", bold: true, children: "Ma'sum" }),
-            /* @__PURE__ */ jsx(Text, { color: "gray", children: " (@masumrpg)" })
-          ] }),
-          /* @__PURE__ */ jsxs(Box, { children: [
-            /* @__PURE__ */ jsx(Text, { color: "gray", children: "GitHub: " }),
-            /* @__PURE__ */ jsx(Text, { color: "blue", underline: true, children: "https://github.com/masumrpg" })
-          ] })
-        ] })
-      ]
-    }
-  ) });
-};
-
-// src/ui/LiveProgress.tsx
-import { Box as Box2, Text as Text2 } from "ink";
-import Spinner from "ink-spinner";
-import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
-var LiveProgress = ({ status, isCompiling }) => {
-  if (!isCompiling) return null;
-  return /* @__PURE__ */ jsxs2(Box2, { marginY: 1, alignItems: "center", children: [
-    /* @__PURE__ */ jsx2(Text2, { color: "cyan", children: /* @__PURE__ */ jsx2(Spinner, { type: "dots" }) }),
-    /* @__PURE__ */ jsxs2(Box2, { marginLeft: 1, children: [
-      /* @__PURE__ */ jsx2(Text2, { color: "yellow", children: "[COMPILING] " }),
-      /* @__PURE__ */ jsx2(Text2, { color: "white", children: status })
-    ] })
-  ] });
-};
-
-// src/ui/SummaryTable.tsx
-import * as path2 from "path";
-import { Box as Box3, Text as Text3 } from "ink";
-import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
-function formatBytes(bytes) {
-  if (bytes === 0) return "0 B";
-  const k = 1024;
-  const sizes = ["B", "KB", "MB", "GB"];
-  const i = Math.floor(Math.log(bytes) / Math.log(k));
-  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(1))} ${sizes[i]}`;
-}
-function formatDisplayPath2(p) {
-  if (!p) return "";
-  try {
-    const rel = path2.relative(process.cwd(), p);
-    return rel && !rel.startsWith("..") && rel.length < p.length ? `./${rel}` : p;
-  } catch {
-    return p;
-  }
-}
-var SummaryTable = ({ result }) => {
-  if (!result) return null;
-  const hasErrors = result.errors.length > 0;
-  return /* @__PURE__ */ jsx3(Box3, { flexDirection: "column", marginY: 1, children: /* @__PURE__ */ jsxs3(
-    Box3,
-    {
-      borderStyle: "round",
-      borderColor: hasErrors ? "red" : "green",
-      paddingX: 2,
-      paddingY: 1,
-      flexDirection: "column",
-      children: [
-        /* @__PURE__ */ jsxs3(Box3, { justifyContent: "space-between", alignItems: "center", children: [
-          /* @__PURE__ */ jsx3(Box3, { children: /* @__PURE__ */ jsx3(Text3, { bold: true, color: hasErrors ? "red" : "green", children: hasErrors ? "[COMPILATION FAILED]" : "[COMPILATION SUCCESSFUL]" }) }),
-          /* @__PURE__ */ jsxs3(Box3, { children: [
-            /* @__PURE__ */ jsx3(Text3, { color: "gray", children: "Duration: " }),
-            /* @__PURE__ */ jsxs3(Text3, { color: "yellow", bold: true, children: [
-              result.durationMs,
-              "ms"
-            ] })
-          ] })
-        ] }),
-        result.files.length > 0 && /* @__PURE__ */ jsxs3(Box3, { marginTop: 1, flexDirection: "column", children: [
-          /* @__PURE__ */ jsxs3(Text3, { bold: true, color: "white", children: [
-            "Generated Documents (",
-            result.files.length,
-            "):"
-          ] }),
-          result.files.map((f, i) => {
-            const formatColor = f.format === "docx" ? "blue" : f.format === "pdf" ? "red" : "yellow";
-            const paddedBadge = `[${f.format.toUpperCase()}]`.padEnd(7, " ");
-            return /* @__PURE__ */ jsxs3(Box3, { marginTop: 0, flexDirection: "column", marginLeft: 1, children: [
-              /* @__PURE__ */ jsxs3(Box3, { justifyContent: "space-between", alignItems: "center", children: [
-                /* @__PURE__ */ jsxs3(Box3, { children: [
-                  /* @__PURE__ */ jsx3(Text3, { color: formatColor, bold: true, children: paddedBadge }),
-                  /* @__PURE__ */ jsx3(Text3, { color: "white", bold: true, children: f.fileName })
-                ] }),
-                /* @__PURE__ */ jsx3(Text3, { color: "cyan", bold: true, children: formatBytes(f.sizeBytes) })
-              ] }),
-              /* @__PURE__ */ jsx3(Box3, { marginLeft: 2, children: /* @__PURE__ */ jsxs3(Text3, { color: "gray", children: [
-                "\u2514\u2500 ",
-                formatDisplayPath2(f.filePath)
-              ] }) })
-            ] }, i);
-          })
-        ] }),
-        hasErrors && /* @__PURE__ */ jsxs3(Box3, { marginTop: 1, flexDirection: "column", children: [
-          /* @__PURE__ */ jsx3(Text3, { bold: true, color: "red", children: "Errors:" }),
-          result.errors.map((err, i) => /* @__PURE__ */ jsx3(Box3, { marginLeft: 2, children: /* @__PURE__ */ jsxs3(Text3, { color: "red", children: [
-            "- ",
-            err
-          ] }) }, i))
-        ] }),
-        /* @__PURE__ */ jsxs3(Box3, { marginTop: 1, justifyContent: "space-between", alignItems: "center", children: [
-          /* @__PURE__ */ jsxs3(Box3, { children: [
-            /* @__PURE__ */ jsx3(Text3, { color: "gray", children: "Author: " }),
-            /* @__PURE__ */ jsx3(Text3, { color: "cyan", bold: true, children: "Ma'sum" }),
-            /* @__PURE__ */ jsx3(Text3, { color: "gray", children: " (@masumrpg)" })
-          ] }),
-          /* @__PURE__ */ jsxs3(Box3, { children: [
-            /* @__PURE__ */ jsx3(Text3, { color: "gray", children: "GitHub: " }),
-            /* @__PURE__ */ jsx3(Text3, { color: "blue", underline: true, children: "https://github.com/masumrpg" })
-          ] })
-        ] })
-      ]
-    }
-  ) });
-};
-
-// src/core/engine.ts
-import * as fs5 from "fs";
-import * as path7 from "path";
+} from "./chunk-BPHDY6VB.mjs";
 
 // src/core/parser.ts
 import matter from "gray-matter";
@@ -231,6 +43,26 @@ function parseInlineSpans(text) {
       remaining = remaining.slice(imgMatch[0].length);
       continue;
     }
+    const fnMatch = remaining.match(/^\[\^([\w-]+)\]/);
+    if (fnMatch) {
+      const fnId = fnMatch[1];
+      spans.push({
+        type: "footnoteRef",
+        content: fnId,
+        footnoteId: fnId
+      });
+      remaining = remaining.slice(fnMatch[0].length);
+      continue;
+    }
+    const mathMatch = remaining.match(/^\$([^$\n]+?)\$/);
+    if (mathMatch && !mathMatch[1].startsWith("$")) {
+      spans.push({
+        type: "mathInline",
+        content: mathMatch[1]
+      });
+      remaining = remaining.slice(mathMatch[0].length);
+      continue;
+    }
     const linkMatch = remaining.match(/^\[([^\]]+)\]\(([^)\s]+)(?:\s+"([^"]+)")?\)/);
     if (linkMatch) {
       spans.push({
@@ -330,7 +162,7 @@ function parseInlineSpans(text) {
       remaining = remaining.slice(fullTag.length);
       continue;
     }
-    const nextSpecial = remaining.search(/[\*\_\[\!`~<]/);
+    const nextSpecial = remaining.search(/[\*\_\[\!`~<\$]/);
     if (nextSpecial === -1) {
       spans.push({
         type: "text",
@@ -356,6 +188,35 @@ function parseInlineSpans(text) {
 function slugify(text) {
   return text.toLowerCase().replace(/[^\w\s-]/g, "").replace(/[\s_-]+/g, "-").replace(/^-+|-+$/g, "");
 }
+function applyHeadingNumbering(nodes, tocEntries, options) {
+  const depth = options.depth ?? 3;
+  const skipH1 = options.skipH1 ?? false;
+  const prefix = options.prefix ?? "";
+  const counters = [0, 0, 0, 0, 0, 0];
+  for (const node of nodes) {
+    if (node.type === "heading" && node.level) {
+      const lvl = node.level;
+      if (lvl > depth) continue;
+      if (lvl === 1 && skipH1) continue;
+      const idx = lvl - 1;
+      counters[idx]++;
+      for (let c = idx + 1; c < counters.length; c++) {
+        counters[c] = 0;
+      }
+      const startIdx = skipH1 ? 1 : 0;
+      const parts = counters.slice(startIdx, idx + 1).filter((n) => n > 0);
+      const numberStr = parts.join(".") + ".";
+      const fullPrefix = prefix ? `${prefix} ${numberStr} ` : `${numberStr} `;
+      const originalText = node.text || "";
+      node.text = fullPrefix + originalText;
+      node.inlines = parseInlineSpans(node.text);
+      const toc = tocEntries.find((t) => t.id === node.id);
+      if (toc) {
+        toc.text = node.text;
+      }
+    }
+  }
+}
 function parseMarkdownDocument(rawMarkdown) {
   const { data: frontmatter, content } = matter(rawMarkdown);
   const metadata = frontmatter || {};
@@ -367,6 +228,7 @@ function parseMarkdownDocument(rawMarkdown) {
   const lines = cleanContent.split(/\r?\n/);
   const nodes = [];
   const tocEntries = [];
+  const footnoteDefs = [];
   let i = 0;
   while (i < lines.length) {
     const line = lines[i];
@@ -395,6 +257,29 @@ function parseMarkdownDocument(rawMarkdown) {
       i++;
       continue;
     }
+    if (line.trim().startsWith("$$")) {
+      const mathLines = [];
+      const singleLine = line.trim().match(/^\$\$(.+)\$\$$/);
+      if (singleLine) {
+        nodes.push({
+          type: "mathBlock",
+          text: singleLine[1].trim()
+        });
+        i++;
+        continue;
+      }
+      i++;
+      while (i < lines.length && !lines[i].trim().startsWith("$$")) {
+        mathLines.push(lines[i]);
+        i++;
+      }
+      if (i < lines.length) i++;
+      nodes.push({
+        type: "mathBlock",
+        text: mathLines.join("\n").trim()
+      });
+      continue;
+    }
     const codeBlockMatch = line.match(/^```(\w+)?/);
     if (codeBlockMatch) {
       const language = (codeBlockMatch[1] || "text").trim().toLowerCase();
@@ -421,6 +306,100 @@ function parseMarkdownDocument(rawMarkdown) {
       }
       continue;
     }
+    const colsMatch = line.trim().match(/^:::columns(?:\s+\[?([\w\s=.-]+)\]?)?$/i);
+    if (colsMatch) {
+      const attrStr = colsMatch[1] || "";
+      let colsCount = 2;
+      let colGap = "1.5rem";
+      if (attrStr) {
+        const numMatch = attrStr.trim().match(/^(\d+)$/);
+        const cMatch = attrStr.match(/cols=(\d+)/i) || attrStr.match(/columns=(\d+)/i);
+        const gMatch = attrStr.match(/gap=([^\s]+)/i);
+        if (numMatch) colsCount = parseInt(numMatch[1], 10);
+        else if (cMatch) colsCount = parseInt(cMatch[1], 10);
+        if (gMatch) colGap = gMatch[1];
+      }
+      const columnNodes = [];
+      let currentColumnLines = [];
+      let inColBlock = false;
+      i++;
+      while (i < lines.length) {
+        const curLine = lines[i];
+        const trimmed = curLine.trim();
+        if (/^:::col(?:umn)?$/i.test(trimmed)) {
+          if (currentColumnLines.length > 0) {
+            const subDoc = parseMarkdownDocument(currentColumnLines.join("\n"));
+            columnNodes.push({
+              type: "column",
+              children: subDoc.nodes
+            });
+            currentColumnLines = [];
+          }
+          inColBlock = true;
+          i++;
+        } else if (trimmed === ":::") {
+          if (inColBlock) {
+            if (currentColumnLines.length > 0) {
+              const subDoc = parseMarkdownDocument(currentColumnLines.join("\n"));
+              columnNodes.push({
+                type: "column",
+                children: subDoc.nodes
+              });
+              currentColumnLines = [];
+            }
+            inColBlock = false;
+            i++;
+          } else {
+            if (currentColumnLines.length > 0) {
+              const subDoc = parseMarkdownDocument(currentColumnLines.join("\n"));
+              columnNodes.push({
+                type: "column",
+                children: subDoc.nodes
+              });
+              currentColumnLines = [];
+            }
+            i++;
+            break;
+          }
+        } else {
+          currentColumnLines.push(curLine);
+          i++;
+        }
+      }
+      if (currentColumnLines.length > 0) {
+        const subDoc = parseMarkdownDocument(currentColumnLines.join("\n"));
+        columnNodes.push({
+          type: "column",
+          children: subDoc.nodes
+        });
+      }
+      nodes.push({
+        type: "columns",
+        columnsCount: columnNodes.length > 0 ? columnNodes.length : colsCount,
+        columnGap: colGap,
+        children: columnNodes
+      });
+      continue;
+    }
+    const fnDefMatch = line.match(/^\[\^([\w-]+)\]:\s+(.+)$/);
+    if (fnDefMatch) {
+      const fnId = fnDefMatch[1];
+      const fnText = fnDefMatch[2].trim();
+      const inlines = parseInlineSpans(fnText);
+      footnoteDefs.push({
+        id: fnId,
+        text: fnText,
+        inlines
+      });
+      nodes.push({
+        type: "footnoteDef",
+        footnoteId: fnId,
+        text: fnText,
+        inlines
+      });
+      i++;
+      continue;
+    }
     const calloutMatch = line.match(/^>\s*\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\]\s*$/i);
     if (calloutMatch) {
       const calloutType = calloutMatch[1].toUpperCase();
@@ -544,7 +523,7 @@ function parseMarkdownDocument(rawMarkdown) {
       continue;
     }
     const paraLines = [];
-    while (i < lines.length && lines[i].trim() && !lines[i].match(/^#{1,6}\s+/) && !lines[i].startsWith("```") && !lines[i].startsWith(">") && !lines[i].trim().startsWith("|") && !lines[i].match(/^(\s*)([-*+]|\d+\.)\s+/)) {
+    while (i < lines.length && lines[i].trim() && !lines[i].match(/^#{1,6}\s+/) && !lines[i].startsWith("```") && !lines[i].startsWith("$$") && !lines[i].startsWith(">") && !lines[i].trim().startsWith("|") && !lines[i].match(/^:::columns/) && !lines[i].match(/^\[\^[\w-]+\]:\s+/) && !lines[i].match(/^(\s*)([-*+]|\d+\.)\s+/)) {
       paraLines.push(lines[i]);
       i++;
     }
@@ -555,43 +534,29 @@ function parseMarkdownDocument(rawMarkdown) {
       inlines: parseInlineSpans(paraText)
     });
   }
+  if (metadata.numberHeadings) {
+    const opts = typeof metadata.numberHeadings === "boolean" ? { enabled: metadata.numberHeadings } : metadata.numberHeadings;
+    if (opts.enabled !== false) {
+      applyHeadingNumbering(nodes, tocEntries, opts);
+    }
+  }
   return {
     metadata,
     content: cleanContent,
     nodes,
     tocEntries,
-    inlinedStyles
+    inlinedStyles,
+    footnoteDefs
   };
 }
 
-// src/core/docx/docxBuilder.ts
-import {
-  Document,
-  Paragraph,
-  TextRun,
-  HeadingLevel,
-  Table,
-  TableRow,
-  TableCell,
-  WidthType,
-  BorderStyle,
-  AlignmentType,
-  ImageRun,
-  Header as Header2,
-  Footer,
-  PageNumber,
-  Packer,
-  PageOrientation,
-  convertInchesToTwip,
-  convertMillimetersToTwip,
-  ShadingType,
-  ExternalHyperlink,
-  TabStopType
-} from "docx";
+// src/core/html/htmlBuilder.ts
+import * as fs2 from "fs";
+import * as path2 from "path";
 
 // src/core/imageResolver.ts
 import * as fs from "fs";
-import * as path3 from "path";
+import * as path from "path";
 var memoryImageCache = /* @__PURE__ */ new Map();
 function getMimeType(filePathOrUrl) {
   const clean = filePathOrUrl.split("?")[0].toLowerCase();
@@ -648,9 +613,14 @@ async function resolveImage(src, baseDir = process.cwd()) {
       memoryImageCache.set(cacheKey, resolved2);
       return resolved2;
     }
-    const localPath = path3.isAbsolute(src) ? src : path3.resolve(baseDir, src);
+    let localPath = path.isAbsolute(src) ? src : path.resolve(baseDir, src);
     if (!fs.existsSync(localPath)) {
-      return null;
+      const cwdPath = path.resolve(process.cwd(), src);
+      if (fs.existsSync(cwdPath)) {
+        localPath = cwdPath;
+      } else {
+        return null;
+      }
     }
     const buffer = fs.readFileSync(localPath);
     const mimeType = getMimeType(localPath);
@@ -670,6 +640,164 @@ async function resolveImage(src, baseDir = process.cwd()) {
   }
 }
 
+// src/core/html/htmlThemes.ts
+var THEME_COMPONENTS = `
+/* Fallback CSS variables \u2014 overridden by each named theme's :root block */
+:root {
+  --mf-bg: #ffffff;
+  --mf-text: #0f172a;
+  --mf-text-muted: #64748b;
+  --mf-primary: #33CDCF;
+  --mf-primary-dark: #009DA0;
+  --mf-primary-light: #ECFDFD;
+  --mf-border: #e2e8f0;
+  --mf-card-bg: #f8fafc;
+  --mf-code-bg: #0f172a;
+  --mf-code-text: #f8fafc;
+  --mf-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+  --mf-font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+}
+
+/* Document header */
+.document-header { margin-bottom: 2.5rem; padding-bottom: 1.5rem; border-bottom: 2px solid var(--mf-border); }
+.document-title { font-size: 2.5rem; font-weight: 800; margin: 0 0 0.5rem 0; }
+.document-subtitle { font-size: 1.25rem; color: var(--mf-text-muted); margin: 0 0 1rem 0; }
+.document-meta { font-size: 0.9rem; color: var(--mf-text-muted); display: flex; gap: 1.5rem; flex-wrap: wrap; }
+
+/* Table of Contents */
+.table-of-contents { background: var(--mf-card-bg); border: 1px solid var(--mf-border); border-radius: 8px; padding: 1.5rem 2rem; margin: 2rem 0; }
+.table-of-contents h2 { font-size: 1rem; text-transform: uppercase; letter-spacing: 0.08em; color: var(--mf-text-muted); margin: 0 0 1rem 0; }
+.table-of-contents ul { list-style: none; padding: 0; margin: 0; }
+.table-of-contents li { padding: 0.25rem 0; }
+.table-of-contents a { color: var(--mf-primary-dark); text-decoration: none; }
+.table-of-contents a:hover { text-decoration: underline; }
+
+/* Links */
+a { color: var(--mf-primary-dark); font-weight: 600; text-decoration: none; }
+a:hover { text-decoration: underline; }
+
+/* Blockquote */
+blockquote { border-left: 4px solid var(--mf-primary); background-color: var(--mf-card-bg); margin: 1.2rem 0; padding: 0.8rem 1.2rem; border-radius: 0 8px 8px 0; color: #334155; font-style: italic; }
+
+/* Callout / Alert Boxes */
+.callout { border-left: 4px solid var(--mf-primary); background: var(--mf-card-bg); border-radius: 6px; padding: 1rem 1.2rem; margin: 1.2rem 0; -webkit-print-color-adjust: exact; print-color-adjust: exact; }
+.callout-title { font-weight: 700; font-size: 0.85rem; text-transform: uppercase; letter-spacing: 0.05em; margin-bottom: 0.4rem; }
+.callout-NOTE      { border-color: #33CDCF; background: #ECFDFD; -webkit-print-color-adjust: exact; print-color-adjust: exact; }
+.callout-NOTE      .callout-title { color: #009DA0; }
+.callout-TIP       { border-color: #10b981; background: #ecfdf5; -webkit-print-color-adjust: exact; print-color-adjust: exact; }
+.callout-TIP       .callout-title { color: #10b981; }
+.callout-WARNING   { border-color: #f59e0b; background: #fffbeb; -webkit-print-color-adjust: exact; print-color-adjust: exact; }
+.callout-WARNING   .callout-title { color: #f59e0b; }
+.callout-CAUTION   { border-color: #ef4444; background: #fef2f2; -webkit-print-color-adjust: exact; print-color-adjust: exact; }
+.callout-CAUTION   .callout-title { color: #ef4444; }
+.callout-IMPORTANT { border-color: #8b5cf6; background: #f5f3ff; -webkit-print-color-adjust: exact; print-color-adjust: exact; }
+.callout-IMPORTANT .callout-title { color: #8b5cf6; }
+
+/* Inline Code */
+code { font-family: var(--mf-font-mono); font-size: 0.88em; background-color: #f1f5f9; padding: 0.2em 0.4em; border-radius: 4px; color: #0f172a; }
+
+/* Code Blocks */
+pre { background-color: var(--mf-code-bg); color: var(--mf-code-text); padding: 1.2rem; border-radius: 8px; overflow-x: auto; font-family: var(--mf-font-mono); font-size: 0.9rem; line-height: 1.5; margin: 1.2rem 0; }
+pre code { background-color: transparent; color: inherit; padding: 0; }
+
+/* Tables */
+table { width: 100%; border-collapse: collapse; margin: 1.5rem 0; font-size: 0.95rem; }
+th, td { border: 1px solid var(--mf-border); padding: 0.75rem 1rem; text-align: left; }
+th { background-color: var(--mf-card-bg); font-weight: 600; color: #0f172a; }
+tr:nth-child(even) { background-color: var(--mf-card-bg); }
+
+/* Images */
+img { max-width: 100%; height: auto; border-radius: 6px; margin: 1rem 0; }
+
+/* Dividers */
+hr { border: none; border-top: 1px solid var(--mf-border); margin: 2rem 0; }
+
+/* Print / PDF */
+@media print {
+  body { padding: 0; }
+  .document-container { max-width: 100%; }
+  pre, table, blockquote, .callout { break-inside: avoid; }
+  /* Remove scrollbars \u2014 PDF has no scrolling */
+  pre { overflow: visible; white-space: pre-wrap; word-break: break-all; }
+}
+`;
+var THEME_CORPORATE = `
+:root {
+  --mf-bg: #ffffff;
+  --mf-text: #0f172a;
+  --mf-text-muted: #64748b;
+  --mf-primary: #33CDCF;
+  --mf-primary-dark: #009DA0;
+  --mf-primary-light: #ECFDFD;
+  --mf-border: #e2e8f0;
+  --mf-card-bg: #f8fafc;
+  --mf-code-bg: #0f172a;
+  --mf-code-text: #f8fafc;
+  --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; 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 #CCFBF1; padding-bottom: 0.4rem; }
+h3 { font-size: 1.3rem; }
+h4 { font-size: 1.1rem; }
+p  { margin: 0.8rem 0; }
+`;
+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: ${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 { 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 || ""}
+`;
+  }
+  if (typeof theme === "string" && THEMES[theme]) {
+    return THEMES[theme];
+  }
+  return THEME_CORPORATE;
+}
+
 // src/core/syntax/syntaxHighlighter.ts
 var SYNTAX_COLORS = {
   keyword: "FF7B72",
@@ -1025,182 +1153,6 @@ function highlightCodeToHtml(code, lang = "", theme = "github-dark") {
   return htmlLines.join("\n");
 }
 
-// src/core/mermaid/mermaidRenderer.ts
-import { spawnSync as spawnSync2 } from "child_process";
-import * as fs4 from "fs";
-import * as os2 from "os";
-import * as path6 from "path";
-import { pathToFileURL as pathToFileURL2 } from "url";
-
-// src/core/pdf/pdfBuilder.ts
-import * as fs3 from "fs";
-import * as path5 from "path";
-import * as os from "os";
-import { pathToFileURL } from "url";
-import { spawnSync } from "child_process";
-
-// src/core/html/htmlBuilder.ts
-import * as fs2 from "fs";
-import * as path4 from "path";
-
-// src/core/html/htmlThemes.ts
-var THEME_COMPONENTS = `
-/* Fallback CSS variables \u2014 overridden by each named theme's :root block */
-:root {
-  --mf-bg: #ffffff;
-  --mf-text: #0f172a;
-  --mf-text-muted: #64748b;
-  --mf-primary: #33CDCF;
-  --mf-primary-dark: #009DA0;
-  --mf-primary-light: #ECFDFD;
-  --mf-border: #e2e8f0;
-  --mf-card-bg: #f8fafc;
-  --mf-code-bg: #0f172a;
-  --mf-code-text: #f8fafc;
-  --mf-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
-  --mf-font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
-}
-
-/* Document header */
-.document-header { margin-bottom: 2.5rem; padding-bottom: 1.5rem; border-bottom: 2px solid var(--mf-border); }
-.document-title { font-size: 2.5rem; font-weight: 800; margin: 0 0 0.5rem 0; }
-.document-subtitle { font-size: 1.25rem; color: var(--mf-text-muted); margin: 0 0 1rem 0; }
-.document-meta { font-size: 0.9rem; color: var(--mf-text-muted); display: flex; gap: 1.5rem; flex-wrap: wrap; }
-
-/* Table of Contents */
-.table-of-contents { background: var(--mf-card-bg); border: 1px solid var(--mf-border); border-radius: 8px; padding: 1.5rem 2rem; margin: 2rem 0; }
-.table-of-contents h2 { font-size: 1rem; text-transform: uppercase; letter-spacing: 0.08em; color: var(--mf-text-muted); margin: 0 0 1rem 0; }
-.table-of-contents ul { list-style: none; padding: 0; margin: 0; }
-.table-of-contents li { padding: 0.25rem 0; }
-.table-of-contents a { color: var(--mf-primary-dark); text-decoration: none; }
-.table-of-contents a:hover { text-decoration: underline; }
-
-/* Links */
-a { color: var(--mf-primary-dark); font-weight: 600; text-decoration: none; }
-a:hover { text-decoration: underline; }
-
-/* Blockquote */
-blockquote { border-left: 4px solid var(--mf-primary); background-color: var(--mf-card-bg); margin: 1.2rem 0; padding: 0.8rem 1.2rem; border-radius: 0 8px 8px 0; color: #334155; font-style: italic; }
-
-/* Callout / Alert Boxes */
-.callout { border-left: 4px solid var(--mf-primary); background: var(--mf-card-bg); border-radius: 6px; padding: 1rem 1.2rem; margin: 1.2rem 0; -webkit-print-color-adjust: exact; print-color-adjust: exact; }
-.callout-title { font-weight: 700; font-size: 0.85rem; text-transform: uppercase; letter-spacing: 0.05em; margin-bottom: 0.4rem; }
-.callout-NOTE      { border-color: #33CDCF; background: #ECFDFD; -webkit-print-color-adjust: exact; print-color-adjust: exact; }
-.callout-NOTE      .callout-title { color: #009DA0; }
-.callout-TIP       { border-color: #10b981; background: #ecfdf5; -webkit-print-color-adjust: exact; print-color-adjust: exact; }
-.callout-TIP       .callout-title { color: #10b981; }
-.callout-WARNING   { border-color: #f59e0b; background: #fffbeb; -webkit-print-color-adjust: exact; print-color-adjust: exact; }
-.callout-WARNING   .callout-title { color: #f59e0b; }
-.callout-CAUTION   { border-color: #ef4444; background: #fef2f2; -webkit-print-color-adjust: exact; print-color-adjust: exact; }
-.callout-CAUTION   .callout-title { color: #ef4444; }
-.callout-IMPORTANT { border-color: #8b5cf6; background: #f5f3ff; -webkit-print-color-adjust: exact; print-color-adjust: exact; }
-.callout-IMPORTANT .callout-title { color: #8b5cf6; }
-
-/* Inline Code */
-code { font-family: var(--mf-font-mono); font-size: 0.88em; background-color: #f1f5f9; padding: 0.2em 0.4em; border-radius: 4px; color: #0f172a; }
-
-/* Code Blocks */
-pre { background-color: var(--mf-code-bg); color: var(--mf-code-text); padding: 1.2rem; border-radius: 8px; overflow-x: auto; font-family: var(--mf-font-mono); font-size: 0.9rem; line-height: 1.5; margin: 1.2rem 0; }
-pre code { background-color: transparent; color: inherit; padding: 0; }
-
-/* Tables */
-table { width: 100%; border-collapse: collapse; margin: 1.5rem 0; font-size: 0.95rem; }
-th, td { border: 1px solid var(--mf-border); padding: 0.75rem 1rem; text-align: left; }
-th { background-color: var(--mf-card-bg); font-weight: 600; color: #0f172a; }
-tr:nth-child(even) { background-color: var(--mf-card-bg); }
-
-/* Images */
-img { max-width: 100%; height: auto; border-radius: 6px; margin: 1rem 0; }
-
-/* Dividers */
-hr { border: none; border-top: 1px solid var(--mf-border); margin: 2rem 0; }
-
-/* Print / PDF */
-@media print {
-  body { padding: 0; }
-  .document-container { max-width: 100%; }
-  pre, table, blockquote, .callout { break-inside: avoid; }
-  /* Remove scrollbars \u2014 PDF has no scrolling */
-  pre { overflow: visible; white-space: pre-wrap; word-break: break-all; }
-}
-`;
-var THEME_CORPORATE = `
-:root {
-  --mf-bg: #ffffff;
-  --mf-text: #0f172a;
-  --mf-text-muted: #64748b;
-  --mf-primary: #33CDCF;
-  --mf-primary-dark: #009DA0;
-  --mf-primary-light: #ECFDFD;
-  --mf-border: #e2e8f0;
-  --mf-card-bg: #f8fafc;
-  --mf-code-bg: #0f172a;
-  --mf-code-text: #f8fafc;
-  --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; 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 #CCFBF1; padding-bottom: 0.4rem; }
-h3 { font-size: 1.3rem; }
-h4 { font-size: 1.1rem; }
-p  { margin: 0.8rem 0; }
-`;
-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: ${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 { 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 || ""}
-`;
-  }
-  if (typeof theme === "string" && THEMES[theme]) {
-    return THEMES[theme];
-  }
-  return THEME_CORPORATE;
-}
-
 // src/config/resolveConfig.ts
 var PAPER_DIMENSIONS_TWIP = {
   A4: { width: 11906, height: 16838 },
@@ -1246,7 +1198,8 @@ function formatMarginCss(margin, defaultCss = "2.5cm") {
   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 || "");
+  const currentYear = meta.year || (/* @__PURE__ */ new Date()).getFullYear().toString();
+  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(/\{year\}/gi, currentYear).replace(/\{company\}/gi, meta.company || "");
 }
 function normalizeWatermark(rawWatermark) {
   if (!rawWatermark) {
@@ -1383,6 +1336,129 @@ function normalizeSignatures(raw, meta = {}) {
     spacingBeforeTwip
   };
 }
+function normalizeCoverPage(rawCover, tokenCtx = {}) {
+  if (!rawCover) return void 0;
+  const cfg = typeof rawCover === "object" ? rawCover : {};
+  if (cfg.enabled === false) return void 0;
+  const preset = cfg.preset || "modern";
+  const title = cfg.title ? replaceDocumentTokens(String(cfg.title), tokenCtx) : tokenCtx.title || "Document Title";
+  const subtitle = cfg.subtitle ? replaceDocumentTokens(String(cfg.subtitle), tokenCtx) : tokenCtx.subtitle;
+  const author = Array.isArray(cfg.author) ? cfg.author.join(", ") : cfg.author ? replaceDocumentTokens(String(cfg.author), tokenCtx) : tokenCtx.author;
+  const company = cfg.company ? replaceDocumentTokens(String(cfg.company), tokenCtx) : tokenCtx.company;
+  const version = cfg.version ? replaceDocumentTokens(String(cfg.version), tokenCtx) : tokenCtx.version;
+  let dateStr;
+  if (typeof cfg.date === "string") {
+    dateStr = replaceDocumentTokens(cfg.date, tokenCtx);
+  } else if (cfg.date === true) {
+    dateStr = tokenCtx.date || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  } else {
+    dateStr = tokenCtx.date;
+  }
+  const badge = cfg.badge ? replaceDocumentTokens(String(cfg.badge), tokenCtx) : void 0;
+  const badgeColor = typeof cfg.badgeColor === "string" ? cfg.badgeColor : void 0;
+  const badgeTextColor = typeof cfg.badgeTextColor === "string" ? cfg.badgeTextColor : void 0;
+  const logo = typeof cfg.logo === "string" ? cfg.logo : void 0;
+  const logoWidth = cfg.logoWidth;
+  const bgGradient = typeof cfg.bgGradient === "string" ? cfg.bgGradient : void 0;
+  const textColor = typeof cfg.textColor === "string" ? cfg.textColor : void 0;
+  const footerText = cfg.footerText ? replaceDocumentTokens(String(cfg.footerText), tokenCtx) : void 0;
+  return {
+    enabled: true,
+    preset,
+    title,
+    subtitle,
+    author,
+    company,
+    version,
+    date: dateStr,
+    badge,
+    badgeColor,
+    badgeTextColor,
+    logo,
+    logoWidth,
+    bgGradient,
+    textColor,
+    footerText
+  };
+}
+function normalizeBackCover(rawBack, tokenCtx = {}) {
+  if (!rawBack) return void 0;
+  const cfg = typeof rawBack === "object" ? rawBack : {};
+  if (cfg.enabled === false) return void 0;
+  const preset = cfg.preset || "modern";
+  const title = cfg.title ? replaceDocumentTokens(String(cfg.title), tokenCtx) : "Thank You";
+  const subtitle = cfg.subtitle ? replaceDocumentTokens(String(cfg.subtitle), tokenCtx) : void 0;
+  const company = cfg.company ? replaceDocumentTokens(String(cfg.company), tokenCtx) : tokenCtx.company;
+  const address = cfg.address ? replaceDocumentTokens(String(cfg.address), tokenCtx) : void 0;
+  const email = cfg.email ? replaceDocumentTokens(String(cfg.email), tokenCtx) : void 0;
+  const phone = cfg.phone ? replaceDocumentTokens(String(cfg.phone), tokenCtx) : void 0;
+  const website = cfg.website ? replaceDocumentTokens(String(cfg.website), tokenCtx) : void 0;
+  let socialMap;
+  if (cfg.social && typeof cfg.social === "object") {
+    socialMap = {};
+    for (const [k, v] of Object.entries(cfg.social)) {
+      if (typeof v === "string") {
+        socialMap[k] = replaceDocumentTokens(v, tokenCtx);
+      }
+    }
+  }
+  const currentYear = (/* @__PURE__ */ new Date()).getFullYear().toString();
+  const copyright = cfg.copyright ? replaceDocumentTokens(String(cfg.copyright), { ...tokenCtx, year: currentYear }) : company ? `Copyright (c) ${currentYear} ${company}. All Rights Reserved.` : void 0;
+  const badge = cfg.badge ? replaceDocumentTokens(String(cfg.badge), tokenCtx) : void 0;
+  const badgeColor = typeof cfg.badgeColor === "string" ? cfg.badgeColor : void 0;
+  const badgeTextColor = typeof cfg.badgeTextColor === "string" ? cfg.badgeTextColor : void 0;
+  const logo = typeof cfg.logo === "string" ? cfg.logo : void 0;
+  const logoWidth = cfg.logoWidth;
+  const bgGradient = typeof cfg.bgGradient === "string" ? cfg.bgGradient : void 0;
+  const textColor = typeof cfg.textColor === "string" ? cfg.textColor : void 0;
+  return {
+    enabled: true,
+    preset,
+    title,
+    subtitle,
+    company,
+    address,
+    email,
+    phone,
+    website,
+    social: socialMap,
+    copyright,
+    badge,
+    badgeColor,
+    badgeTextColor,
+    logo,
+    logoWidth,
+    bgGradient,
+    textColor
+  };
+}
+function normalizeNumberHeadings(raw) {
+  if (raw === void 0 || raw === false) return void 0;
+  if (raw === true) {
+    return { enabled: true, depth: 3, skipH1: false, prefix: "" };
+  }
+  if (typeof raw === "object") {
+    const obj = raw;
+    if (obj.enabled === false) return void 0;
+    return {
+      enabled: true,
+      depth: obj.depth ?? 3,
+      skipH1: obj.skipH1 ?? false,
+      prefix: obj.prefix ?? ""
+    };
+  }
+  return void 0;
+}
+function normalizeSecurity(raw) {
+  if (!raw) return void 0;
+  const sec = raw;
+  if (!sec.userPassword && !sec.ownerPassword && !sec.permissions) return void 0;
+  return {
+    userPassword: sec.userPassword,
+    ownerPassword: sec.ownerPassword,
+    permissions: sec.permissions
+  };
+}
 function resolveDocumentConfig(frontmatter = {}, userConfig = {}) {
   const configMeta = userConfig.metadata || {};
   const mergedMeta = { ...configMeta, ...frontmatter };
@@ -1425,6 +1501,15 @@ function resolveDocumentConfig(frontmatter = {}, userConfig = {}) {
   const watermark = normalizeWatermark(rawWatermark);
   const rawSignatures = mergedMeta.signatures || userConfig.signatures;
   const signatures = normalizeSignatures(rawSignatures, tokenContext);
+  const rawCover = mergedMeta.coverPage !== void 0 ? mergedMeta.coverPage : userConfig.coverPage;
+  const coverPage = normalizeCoverPage(rawCover, tokenContext);
+  const rawBack = mergedMeta.backCover !== void 0 ? mergedMeta.backCover : userConfig.backCover;
+  const backCover = normalizeBackCover(rawBack, tokenContext);
+  const rawNumberHeadings = mergedMeta.numberHeadings !== void 0 ? mergedMeta.numberHeadings : userConfig.numberHeadings;
+  const numberHeadings = normalizeNumberHeadings(rawNumberHeadings);
+  const rawSecurity = mergedMeta.security || userConfig.security;
+  const security = normalizeSecurity(rawSecurity);
+  const math = mergedMeta.math !== false && userConfig.math !== false;
   const cssList = [];
   const addCss = (item) => {
     if (!item) return;
@@ -1454,6 +1539,11 @@ function resolveDocumentConfig(frontmatter = {}, userConfig = {}) {
     toc,
     signatures,
     watermark,
+    coverPage,
+    backCover,
+    numberHeadings,
+    security,
+    math,
     css: cssList,
     embedImages,
     bundleHtml,
@@ -1461,6 +1551,45 @@ function resolveDocumentConfig(frontmatter = {}, userConfig = {}) {
   };
 }
 
+// src/core/math/mathRenderer.ts
+import katex from "katex";
+function renderMathToHtml(latex, displayMode = false) {
+  try {
+    return katex.renderToString(latex.trim(), {
+      displayMode,
+      throwOnError: false,
+      output: "htmlAndMathml",
+      strict: false
+    });
+  } catch {
+    return `<span class="katex-fallback">${latex}</span>`;
+  }
+}
+var KATEX_INLINE_CSS = `
+.katex { font: normal 1.21em KaTeX_Main, Times New Roman, serif; line-height: 1.2; text-indent: 0; text-rendering: auto; border-color: currentColor; }
+.katex * { -ms-high-contrast-adjust: none !important; }
+.katex .katex-html { display: inline-block; }
+.katex .katex-mathml { clip: rect(1px, 1px, 1px, 1px); border: 0; height: 1px; overflow: hidden; padding: 0; position: absolute; width: 1px; }
+.katex-display { display: block; margin: 1em 0; text-align: center; }
+.katex-display > .katex { display: inline-block; text-align: initial; }
+.katex .base { position: relative; white-space: nowrap; width: min-content; }
+.katex .strut { display: inline-block; }
+.katex .mord { display: inline-block; }
+.katex .mbin { display: inline-block; }
+.katex .mrel { display: inline-block; }
+.katex .mopen { display: inline-block; }
+.katex .mclose { display: inline-block; }
+.katex .mpunct { display: inline-block; }
+.katex .minner { display: inline-block; }
+.katex .mop { display: inline-block; }
+.katex .frac-line { width: 100%; border-bottom-style: solid; }
+.katex .vlist-t { display: inline-table; table-layout: fixed; }
+.katex .vlist-r { display: table-row; }
+.katex .vlist { display: table-cell; vertical-align: bottom; position: relative; }
+.katex .msupsub { text-align: left; }
+.katex .sqrt > .root { margin-left: 0.27777778em; margin-right: -0.55555556em; }
+`;
+
 // src/core/html/htmlBuilder.ts
 function escapeHtml(str) {
   return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
@@ -1499,78 +1628,30 @@ async function renderInlinesToHtml(spans = [], baseDir = process.cwd()) {
       result += `<del>${inner}</del>`;
       continue;
     }
-    if (span.type === "code") {
-      result += `<code>${escapeHtml(span.content)}</code>`;
-      continue;
-    }
-    if (span.type === "htmlInline") {
-      result += span.content;
-      continue;
-    }
-    result += escapeHtml(span.content);
-  }
-  return result;
-}
-async function buildHtmlDocument(doc, config, baseDir = process.cwd()) {
-  const resolved = resolveDocumentConfig(doc.metadata, config);
-  const baseThemeCss = generateThemeCss(resolved.theme);
-  let customCss = "";
-  for (const cssPath of resolved.css) {
-    const fullCssPath = path4.isAbsolute(cssPath) ? cssPath : path4.resolve(baseDir, cssPath);
-    if (fs2.existsSync(fullCssPath)) {
-      customCss += `
-/* Custom CSS: ${cssPath} */
-` + fs2.readFileSync(fullCssPath, "utf-8");
-    }
-  }
-  const inlinedCss = doc.inlinedStyles.join("\n");
-  let bodyHtml = "";
-  if (resolved.title) {
-    bodyHtml += `  <header class="document-header">
-`;
-    bodyHtml += `    <h1 class="document-title">${escapeHtml(resolved.title)}</h1>
-`;
-    if (resolved.subtitle) {
-      bodyHtml += `    <div class="document-subtitle">${escapeHtml(resolved.subtitle)}</div>
-`;
-    }
-    if (resolved.author || resolved.date || resolved.version) {
-      bodyHtml += `    <div class="document-meta">
-`;
-      if (resolved.author) {
-        bodyHtml += `      <span>Author: ${escapeHtml(resolved.author)}</span>
-`;
-      }
-      if (resolved.version) {
-        bodyHtml += `      <span>Version: ${escapeHtml(resolved.version)}</span>
-`;
-      }
-      if (resolved.date) {
-        bodyHtml += `      <span>Date: ${escapeHtml(resolved.date)}</span>
-`;
-      }
-      bodyHtml += `    </div>
-`;
+    if (span.type === "code") {
+      result += `<code>${escapeHtml(span.content)}</code>`;
+      continue;
     }
-    bodyHtml += `  </header>
-`;
-  }
-  if (resolved.toc && doc.tocEntries.length > 0) {
-    bodyHtml += `  <nav class="table-of-contents">
-`;
-    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>
-`;
+    if (span.type === "mathInline") {
+      result += renderMathToHtml(span.content, false);
+      continue;
     }
-    bodyHtml += `    </ul>
-  </nav>
-`;
+    if (span.type === "footnoteRef") {
+      const id = escapeHtml(span.footnoteId || span.content);
+      result += `<sup><a href="#fn-${id}" id="fnref-${id}" class="markforge-fnref">[${escapeHtml(span.content)}]</a></sup>`;
+      continue;
+    }
+    if (span.type === "htmlInline") {
+      result += span.content;
+      continue;
+    }
+    result += escapeHtml(span.content);
   }
-  for (const node of doc.nodes) {
+  return result;
+}
+async function renderNodesToHtml(nodes, resolved, baseDir = process.cwd()) {
+  let bodyHtml = "";
+  for (const node of nodes) {
     if (node.type === "heading") {
       const inner = await renderInlinesToHtml(node.inlines, baseDir);
       bodyHtml += `  <h${node.level} id="${node.id}">${inner}</h${node.level}>
@@ -1580,6 +1661,26 @@ async function buildHtmlDocument(doc, config, baseDir = process.cwd()) {
     if (node.type === "paragraph") {
       const inner = await renderInlinesToHtml(node.inlines, baseDir);
       bodyHtml += `  <p>${inner}</p>
+`;
+      continue;
+    }
+    if (node.type === "mathBlock") {
+      bodyHtml += `  <div class="math-block">${renderMathToHtml(node.text || "", true)}</div>
+`;
+      continue;
+    }
+    if (node.type === "columns") {
+      const cols = node.columnsCount || 2;
+      const gap = node.columnGap || "1.5rem";
+      let colChildrenHtml = "";
+      for (const col of node.children || []) {
+        const colInner = await renderNodesToHtml(col.children || [], resolved, baseDir);
+        colChildrenHtml += `    <div class="markforge-col">
+${colInner}    </div>
+`;
+      }
+      bodyHtml += `  <div class="markforge-columns" style="--cols: ${cols}; --col-gap: ${gap};">
+${colChildrenHtml}  </div>
 `;
       continue;
     }
@@ -1668,6 +1769,429 @@ ${escapeHtml(node.text || "")}
       continue;
     }
   }
+  return bodyHtml;
+}
+async function renderCoverPageHtml(cover, baseDir = process.cwd()) {
+  let logoHtml = "";
+  if (cover.logo) {
+    const resolvedLogo = await resolveImage(cover.logo, baseDir);
+    const src = resolvedLogo ? resolvedLogo.dataUri : cover.logo;
+    const widthStyle = cover.logoWidth ? `max-width: ${typeof cover.logoWidth === "number" ? cover.logoWidth + "px" : cover.logoWidth}; max-height: 80px; width: auto; height: auto;` : "max-height: 60px; max-width: 180px; width: auto; height: auto;";
+    logoHtml = `<div class="cover-logo"><img src="${src}" alt="Logo" style="${widthStyle} object-fit: contain;" /></div>`;
+  }
+  const badgeHtml = cover.badge ? `<div class="cover-badge" style="${cover.badgeColor ? `background-color: ${cover.badgeColor};` : ""}${cover.badgeTextColor ? `color: ${cover.badgeTextColor};` : ""}">${escapeHtml(cover.badge)}</div>` : "";
+  const titleHtml = `<h1 class="cover-title">${escapeHtml(cover.title)}</h1>`;
+  const subtitleHtml = cover.subtitle ? `<div class="cover-subtitle">${escapeHtml(cover.subtitle)}</div>` : "";
+  const metaItems = [];
+  if (cover.company) metaItems.push(`<div class="cover-meta-item"><span class="cover-meta-label">Organization:</span> <span class="cover-meta-value">${escapeHtml(cover.company)}</span></div>`);
+  if (cover.author) metaItems.push(`<div class="cover-meta-item"><span class="cover-meta-label">Author:</span> <span class="cover-meta-value">${escapeHtml(cover.author)}</span></div>`);
+  if (cover.version) metaItems.push(`<div class="cover-meta-item"><span class="cover-meta-label">Version:</span> <span class="cover-meta-value">${escapeHtml(cover.version)}</span></div>`);
+  if (cover.date) metaItems.push(`<div class="cover-meta-item"><span class="cover-meta-label">Date:</span> <span class="cover-meta-value">${escapeHtml(cover.date)}</span></div>`);
+  const metaHtml = metaItems.length > 0 ? `<div class="cover-meta">${metaItems.join("\n")}</div>` : "";
+  const footerHtml = cover.footerText ? `<div class="cover-footer-text">${escapeHtml(cover.footerText)}</div>` : "";
+  const css = `
+  .markforge-cover {
+    min-height: 100vh;
+    box-sizing: border-box;
+    display: flex;
+    flex-direction: column;
+    justify-content: space-between;
+    padding: 4rem 3.5rem;
+    page-break-after: always;
+    break-after: page;
+    position: relative;
+    z-index: 2;
+    background: ${cover.bgGradient || "#FFFFFF"};
+    -webkit-print-color-adjust: exact;
+    print-color-adjust: exact;
+    color: ${cover.textColor || "#0F172A"};
+  }
+  .markforge-cover.cover-modern {
+    border-top: 8px solid #0D998D;
+  }
+  .markforge-cover.cover-corporate-split {
+    border-left: 12px solid #0D998D;
+  }
+  .markforge-cover.cover-card {
+    background: #F8FAFC;
+  }
+  .cover-top {
+    display: flex;
+    justify-content: space-between;
+    align-items: flex-start;
+    width: 100%;
+  }
+  .cover-badge {
+    display: inline-block;
+    padding: 0.35rem 0.85rem;
+    font-size: 0.78rem;
+    font-weight: 700;
+    letter-spacing: 0.08em;
+    text-transform: uppercase;
+    background-color: #ECFDFD;
+    color: #0D998D;
+    border-radius: 4px;
+    border: 1px solid #33CDCF;
+  }
+  .cover-body {
+    margin: auto 0;
+  }
+  .cover-title {
+    font-size: 2.8rem;
+    font-weight: 800;
+    line-height: 1.15;
+    margin: 0 0 1rem 0;
+    color: inherit;
+  }
+  .cover-subtitle {
+    font-size: 1.35rem;
+    font-weight: 400;
+    color: #64748B;
+    margin: 0 0 2rem 0;
+    line-height: 1.4;
+  }
+  .cover-meta {
+    display: flex;
+    flex-direction: column;
+    gap: 0.5rem;
+    border-top: 1.5px solid #E2E8F0;
+    padding-top: 1.5rem;
+    max-width: 480px;
+  }
+  .cover-meta-item {
+    font-size: 0.92rem;
+    display: flex;
+    gap: 0.75rem;
+  }
+  .cover-meta-label {
+    font-weight: 600;
+    color: #64748B;
+    min-width: 110px;
+  }
+  .cover-meta-value {
+    font-weight: 500;
+    color: #0F172A;
+  }
+  .cover-bottom {
+    display: flex;
+    justify-content: space-between;
+    align-items: flex-end;
+    font-size: 0.82rem;
+    color: #94A3B8;
+  }
+  @media print {
+    .markforge-cover {
+      page-break-after: always;
+      break-after: page;
+      height: 100vh;
+      min-height: 100vh;
+      max-height: 100vh;
+      box-sizing: border-box;
+      overflow: hidden;
+      margin: 0;
+      -webkit-print-color-adjust: exact;
+      print-color-adjust: exact;
+    }
+  }
+  `;
+  const html = `  <section class="markforge-cover cover-${cover.preset}">
+    <div class="cover-top">
+      ${logoHtml}
+      ${badgeHtml}
+    </div>
+    <div class="cover-body">
+      ${titleHtml}
+      ${subtitleHtml}
+      ${metaHtml}
+    </div>
+    <div class="cover-bottom">
+      ${footerHtml}
+    </div>
+  </section>
+`;
+  return { html, css };
+}
+async function renderBackCoverHtml(backCover, baseDir = process.cwd()) {
+  let logoHtml = "";
+  if (backCover.logo) {
+    const resolved = await resolveImage(backCover.logo, baseDir);
+    const src = resolved ? resolved.dataUri : backCover.logo;
+    const widthStyle = backCover.logoWidth ? `style="width: ${typeof backCover.logoWidth === "number" ? `${backCover.logoWidth}px` : backCover.logoWidth}; max-width: 100%;"` : `style="max-width: 160px; height: auto;"`;
+    logoHtml = `<div class="back-logo"><img src="${src}" alt="Brand Logo" ${widthStyle} /></div>`;
+  }
+  const badgeHtml = backCover.badge ? `<div class="back-badge" style="${backCover.badgeColor ? `background-color: ${backCover.badgeColor};` : ""}${backCover.badgeTextColor ? `color: ${backCover.badgeTextColor};` : ""}">${escapeHtml(backCover.badge)}</div>` : "";
+  const titleHtml = `<h1 class="back-title">${escapeHtml(backCover.title)}</h1>`;
+  const subtitleHtml = backCover.subtitle ? `<div class="back-subtitle">${escapeHtml(backCover.subtitle)}</div>` : "";
+  const contactItems = [];
+  if (backCover.company) contactItems.push(`<div class="back-contact-item"><span class="back-contact-label">Organization:</span> <span class="back-contact-value">${escapeHtml(backCover.company)}</span></div>`);
+  if (backCover.address) contactItems.push(`<div class="back-contact-item"><span class="back-contact-label">Address:</span> <span class="back-contact-value">${escapeHtml(backCover.address)}</span></div>`);
+  if (backCover.email) contactItems.push(`<div class="back-contact-item"><span class="back-contact-label">Email:</span> <a href="mailto:${escapeHtml(backCover.email)}" class="back-contact-link">${escapeHtml(backCover.email)}</a></div>`);
+  if (backCover.phone) contactItems.push(`<div class="back-contact-item"><span class="back-contact-label">Phone:</span> <span class="back-contact-value">${escapeHtml(backCover.phone)}</span></div>`);
+  if (backCover.website) contactItems.push(`<div class="back-contact-item"><span class="back-contact-label">Website:</span> <a href="${escapeHtml(backCover.website)}" target="_blank" class="back-contact-link">${escapeHtml(backCover.website)}</a></div>`);
+  if (backCover.social) {
+    for (const [network, url] of Object.entries(backCover.social)) {
+      if (url) {
+        contactItems.push(`<div class="back-contact-item"><span class="back-contact-label">${escapeHtml(network.toUpperCase())}:</span> <a href="${escapeHtml(url)}" target="_blank" class="back-contact-link">${escapeHtml(url)}</a></div>`);
+      }
+    }
+  }
+  const contactHtml = contactItems.length > 0 ? `<div class="back-contact-grid">${contactItems.join("\n")}</div>` : "";
+  const copyrightHtml = backCover.copyright ? `<div class="back-copyright">${escapeHtml(backCover.copyright)}</div>` : "";
+  const isDark = backCover.preset === "corporate";
+  const css = `
+  .markforge-back-cover {
+    min-height: 100vh;
+    box-sizing: border-box;
+    display: flex;
+    flex-direction: column;
+    justify-content: space-between;
+    padding: 4rem 3.5rem;
+    page-break-before: always;
+    break-before: page;
+    position: relative;
+    z-index: 2;
+    background: ${backCover.bgGradient || (isDark ? "#0F172A" : "#FFFFFF")};
+    color: ${backCover.textColor || (isDark ? "#F8FAFC" : "#0F172A")};
+  }
+  .markforge-back-cover.back-modern {
+    border-bottom: 8px solid #0D998D;
+  }
+  .markforge-back-cover.back-corporate {
+    border-left: 12px solid #33CDCF;
+  }
+  .markforge-back-cover.back-card {
+    background: #F8FAFC;
+  }
+  .back-top {
+    display: flex;
+    justify-content: space-between;
+    align-items: flex-start;
+    width: 100%;
+  }
+  .back-badge {
+    display: inline-block;
+    padding: 0.35rem 0.85rem;
+    font-size: 0.78rem;
+    font-weight: 700;
+    letter-spacing: 0.08em;
+    text-transform: uppercase;
+    background-color: #ECFDFD;
+    color: #0D998D;
+    border-radius: 4px;
+    border: 1px solid #33CDCF;
+  }
+  .back-body {
+    margin: auto 0;
+  }
+  .back-title {
+    font-size: 2.6rem;
+    font-weight: 800;
+    line-height: 1.15;
+    margin: 0 0 0.75rem 0;
+    color: inherit;
+  }
+  .back-subtitle {
+    font-size: 1.25rem;
+    font-weight: 400;
+    color: ${isDark ? "#94A3B8" : "#64748B"};
+    margin: 0 0 2rem 0;
+    line-height: 1.4;
+  }
+  .back-contact-grid {
+    display: flex;
+    flex-direction: column;
+    gap: 0.6rem;
+    border-top: 1.5px solid ${isDark ? "#334155" : "#E2E8F0"};
+    padding-top: 1.5rem;
+    max-width: 540px;
+  }
+  .back-contact-item {
+    font-size: 0.92rem;
+    display: flex;
+    gap: 0.75rem;
+  }
+  .back-contact-label {
+    font-weight: 600;
+    color: ${isDark ? "#94A3B8" : "#64748B"};
+    min-width: 110px;
+  }
+  .back-contact-link {
+    color: #0D998D;
+    text-decoration: none;
+    font-weight: 600;
+  }
+  .back-contact-link:hover {
+    text-decoration: underline;
+  }
+  .back-copyright {
+    font-size: 0.82rem;
+    color: ${isDark ? "#64748B" : "#94A3B8"};
+    border-top: 1px solid ${isDark ? "#1E293B" : "#F1F5F9"};
+    padding-top: 1rem;
+    margin-top: 2rem;
+  }
+  @media print {
+    .markforge-back-cover {
+      page: back-cover-page;
+      page-break-before: always;
+      break-before: page;
+      page-break-after: avoid;
+      break-after: avoid;
+      min-height: 100vh;
+      height: 100vh;
+      max-height: 100vh;
+      margin: 0;
+      box-sizing: border-box;
+      overflow: hidden;
+      -webkit-print-color-adjust: exact;
+      print-color-adjust: exact;
+    }
+  }
+  `;
+  const html = `  <section class="markforge-back-cover back-${backCover.preset}">
+    <div class="back-top">
+      ${logoHtml}
+      ${badgeHtml}
+    </div>
+    <div class="back-body">
+      ${titleHtml}
+      ${subtitleHtml}
+      ${contactHtml}
+    </div>
+    ${copyrightHtml}
+  </section>
+`;
+  return { html, css };
+}
+async function buildHtmlDocument(doc, config, baseDir = process.cwd()) {
+  var _a;
+  const resolved = resolveDocumentConfig(doc.metadata, config);
+  const baseThemeCss = generateThemeCss(resolved.theme);
+  let customCss = "";
+  for (const cssPath of resolved.css) {
+    const fullCssPath = path2.isAbsolute(cssPath) ? cssPath : path2.resolve(baseDir, cssPath);
+    if (fs2.existsSync(fullCssPath)) {
+      customCss += `
+/* Custom CSS: ${cssPath} */
+` + fs2.readFileSync(fullCssPath, "utf-8");
+    }
+  }
+  const inlinedCss = doc.inlinedStyles.join("\n");
+  const extraCss = `
+  .markforge-columns {
+    display: grid;
+    grid-template-columns: repeat(var(--cols, 2), minmax(0, 1fr));
+    gap: var(--col-gap, 1.5rem);
+    margin: 1.5rem 0;
+  }
+  .markforge-col {
+    min-width: 0;
+  }
+  .markforge-fnref {
+    text-decoration: none;
+    font-size: 0.8em;
+    vertical-align: super;
+    color: #0D998D;
+    font-weight: 700;
+  }
+  .markforge-footnotes {
+    margin-top: 3rem;
+    padding-top: 1rem;
+    font-size: 0.88rem;
+    color: #64748B;
+  }
+  .markforge-footnotes hr {
+    border: 0;
+    border-top: 1px solid #E2E8F0;
+    margin-bottom: 1rem;
+  }
+  .markforge-fn-return {
+    text-decoration: none;
+    color: #0D998D;
+  }
+  .math-block {
+    margin: 1.5rem 0;
+    text-align: center;
+    overflow-x: auto;
+  }
+  `;
+  let coverHtml = "";
+  let coverCss = "";
+  if (resolved.coverPage && resolved.coverPage.enabled) {
+    const coverRes = await renderCoverPageHtml(resolved.coverPage, baseDir);
+    coverHtml = coverRes.html;
+    coverCss = coverRes.css;
+  }
+  let backHtml = "";
+  let backCss = "";
+  if (resolved.backCover && resolved.backCover.enabled) {
+    const backRes = await renderBackCoverHtml(resolved.backCover, baseDir);
+    backHtml = backRes.html;
+    backCss = backRes.css;
+  }
+  let bodyHtml = "";
+  if (resolved.title && !((_a = resolved.coverPage) == null ? void 0 : _a.enabled)) {
+    bodyHtml += `  <header class="document-header">
+`;
+    bodyHtml += `    <h1 class="document-title">${escapeHtml(resolved.title)}</h1>
+`;
+    if (resolved.subtitle) {
+      bodyHtml += `    <div class="document-subtitle">${escapeHtml(resolved.subtitle)}</div>
+`;
+    }
+    if (resolved.author || resolved.date || resolved.version) {
+      bodyHtml += `    <div class="document-meta">
+`;
+      if (resolved.author) {
+        bodyHtml += `      <span>Author: ${escapeHtml(resolved.author)}</span>
+`;
+      }
+      if (resolved.version) {
+        bodyHtml += `      <span>Version: ${escapeHtml(resolved.version)}</span>
+`;
+      }
+      if (resolved.date) {
+        bodyHtml += `      <span>Date: ${escapeHtml(resolved.date)}</span>
+`;
+      }
+      bodyHtml += `    </div>
+`;
+    }
+    bodyHtml += `  </header>
+`;
+  }
+  if (resolved.toc && doc.tocEntries.length > 0) {
+    bodyHtml += `  <nav class="table-of-contents">
+`;
+    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>
+`;
+    }
+    bodyHtml += `    </ul>
+  </nav>
+`;
+  }
+  bodyHtml += await renderNodesToHtml(doc.nodes, resolved, baseDir);
+  let footnotesHtml = "";
+  if (doc.footnoteDefs && doc.footnoteDefs.length > 0) {
+    let fnListHtml = "";
+    for (const def of doc.footnoteDefs) {
+      const defInner = await renderInlinesToHtml(def.inlines, baseDir);
+      fnListHtml += `    <li id="fn-${escapeHtml(def.id)}">${defInner} <a href="#fnref-${escapeHtml(def.id)}" class="markforge-fn-return">&#8617;</a></li>
+`;
+    }
+    footnotesHtml = `
+  <footer class="markforge-footnotes">
+    <hr />
+    <ol>
+${fnListHtml}    </ol>
+  </footer>
+`;
+  }
   let watermarkCss = "";
   let watermarkHtml = "";
   if (resolved.watermark) {
@@ -1677,12 +2201,16 @@ ${escapeHtml(node.text || "")}
     position: fixed;
     top: 0;
     left: 0;
-    width: 100vw;
-    height: 100vh;
+    right: 0;
+    bottom: 0;
+    width: 100%;
+    height: 100%;
     pointer-events: none;
     z-index: 0;
     user-select: none;
     -webkit-user-select: none;
+    -webkit-print-color-adjust: exact;
+    print-color-adjust: exact;
   }
   .document-container {
     position: relative;
@@ -1693,8 +2221,12 @@ ${escapeHtml(node.text || "")}
       position: fixed;
       top: 0;
       left: 0;
+      right: 0;
+      bottom: 0;
       width: 100vw;
       height: 100vh;
+      pointer-events: none;
+      z-index: 0;
       -webkit-print-color-adjust: exact;
       print-color-adjust: exact;
     }
@@ -1705,16 +2237,16 @@ ${escapeHtml(node.text || "")}
   (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 dpr = 2;
+      var width = 1200;
+      var height = 1600;
+      canvas.width = width * dpr;
+      canvas.height = 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.rotate((-Math.abs(${wm.rotate || 45}) * Math.PI) / 180);
         ctx.textAlign = 'center';
         ctx.textBaseline = 'middle';
         ctx.font = '900 ${wm.fontSize * 1.5}px system-ui, -apple-system, sans-serif';
@@ -1741,10 +2273,6 @@ ${escapeHtml(node.text || "")}
   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};
@@ -1856,6 +2384,10 @@ ${itemCards}
   <style>
 ${THEME_COMPONENTS}
 ${baseThemeCss}
+${KATEX_INLINE_CSS}
+${extraCss}
+${coverCss}
+${backCss}
 ${customCss}
 ${inlinedCss}
 ${watermarkCss}
@@ -1863,14 +2395,102 @@ ${signaturesCss}
   </style>
 </head>
 <body>
-${watermarkHtml}  <div class="document-container">
-${bodyHtml}${signaturesHtml}  </div>
+${watermarkHtml}${coverHtml}  <div class="document-container">
+${bodyHtml}${footnotesHtml}${signaturesHtml}  </div>
   ${mermaidScript}
-</body>
+${backHtml}</body>
 </html>`;
 }
 
 // src/core/pdf/pdfBuilder.ts
+import * as fs3 from "fs";
+import * as path3 from "path";
+import * as os from "os";
+import { pathToFileURL } from "url";
+import { spawnSync } from "child_process";
+import { PDFDocument } from "pdf-lib";
+import { encryptPDF } from "@pdfsmaller/pdf-encrypt";
+function escapeXml(str) {
+  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function generateWatermarkPngBuffer(chromePath, wm) {
+  const tmpHtml = path3.join(os.tmpdir(), `markforge-wm-${Date.now()}-${Math.random().toString(36).slice(2)}.html`);
+  const tmpPng = path3.join(os.tmpdir(), `markforge-wm-${Date.now()}-${Math.random().toString(36).slice(2)}.png`);
+  try {
+    const text = escapeXml(wm.text.toUpperCase());
+    const fontSize = (wm.fontSize || 52) * 1.5;
+    const color = wm.color || "#E11D48";
+    const opacity = wm.opacity !== void 0 ? wm.opacity : 0.12;
+    const rotate = wm.rotate !== void 0 ? wm.rotate : -45;
+    const html = `<!DOCTYPE html>
+<html>
+<head>
+<meta charset="utf-8">
+<style>
+  html, body {
+    margin: 0;
+    padding: 0;
+    width: 1200px;
+    height: 1600px;
+    background: transparent;
+    overflow: hidden;
+  }
+  .wm-box {
+    width: 1200px;
+    height: 1600px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    transform: rotate(${rotate}deg);
+  }
+  .wm-text {
+    font-family: system-ui, -apple-system, sans-serif;
+    font-weight: 900;
+    font-size: ${fontSize}px;
+    color: ${color};
+    opacity: ${opacity};
+    letter-spacing: 0.15em;
+    text-transform: uppercase;
+    white-space: nowrap;
+  }
+</style>
+</head>
+<body>
+  <div class="wm-box"><span class="wm-text">${text}</span></div>
+</body>
+</html>`;
+    fs3.writeFileSync(tmpHtml, html, "utf8");
+    const fileUrl = pathToFileURL(tmpHtml).href;
+    const isWin = process.platform === "win32";
+    spawnSync(
+      chromePath,
+      [
+        "--headless=new",
+        "--disable-gpu",
+        "--disable-sync",
+        "--disable-extensions",
+        ...isWin ? [] : ["--no-sandbox", "--disable-setuid-sandbox"],
+        `--screenshot=${tmpPng}`,
+        "--window-size=1200,1600",
+        "--default-background-color=00000000",
+        fileUrl
+      ],
+      { timeout: 15e3, windowsHide: true }
+    );
+    if (fs3.existsSync(tmpPng) && fs3.statSync(tmpPng).size > 0) {
+      return fs3.readFileSync(tmpPng);
+    }
+    return null;
+  } catch {
+    return null;
+  } finally {
+    try {
+      if (fs3.existsSync(tmpHtml)) fs3.unlinkSync(tmpHtml);
+      if (fs3.existsSync(tmpPng)) fs3.unlinkSync(tmpPng);
+    } catch {
+    }
+  }
+}
 function findChromeExecutable() {
   if (process.env.CHROME_PATH && fs3.existsSync(process.env.CHROME_PATH)) {
     return process.env.CHROME_PATH;
@@ -1935,7 +2555,7 @@ function findChromeExecutable() {
   return null;
 }
 function injectPagedMediaStyles(html, config, metadata) {
-  var _a, _b, _c, _d, _e, _f;
+  var _a, _b, _c, _d, _e, _f, _g, _h;
   const resolved = resolveDocumentConfig(metadata || {}, config);
   const size = resolved.paperSize;
   const orientation = resolved.orientation;
@@ -1979,6 +2599,38 @@ function injectPagedMediaStyles(html, config, metadata) {
       ${fontStyle}
     }`;
   };
+  const coverPageCss = ((_a = resolved.coverPage) == null ? void 0 : _a.enabled) ? `
+  @page :first {
+    margin-top: 0;
+    margin-bottom: 0;
+    margin-left: 0;
+    margin-right: 0;
+    background-image: none !important;
+    @top-left { content: none; }
+    @top-center { content: none; }
+    @top-right { content: none; }
+    @bottom-left { content: none; }
+    @bottom-center { content: none; }
+    @bottom-right { content: none; }
+  }` : "";
+  const backCoverCss = ((_b = resolved.backCover) == null ? void 0 : _b.enabled) ? `
+  @page back-cover-page {
+    size: ${size} ${orientation};
+    margin: 0;
+    background-image: none !important;
+    @top-left { content: none; }
+    @top-center { content: none; }
+    @top-right { content: none; }
+    @bottom-left { content: none; }
+    @bottom-center { content: none; }
+    @bottom-right { content: none; }
+  }
+  .markforge-back-cover {
+    page: back-cover-page;
+    min-height: 100vh;
+    height: 100vh;
+    box-sizing: border-box;
+  }` : "";
   const pagedCss = `
   @page {
     size: ${size} ${orientation};
@@ -1986,15 +2638,18 @@ function injectPagedMediaStyles(html, config, metadata) {
     margin-bottom: ${bottom};
     margin-left: ${left};
     margin-right: ${right};
-    ${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)}
+    ${buildZoneCss("top-left", (_c = resolved.header) == null ? void 0 : _c.left)}
+    ${buildZoneCss("top-center", (_d = resolved.header) == null ? void 0 : _d.center)}
+    ${buildZoneCss("top-right", (_e = resolved.header) == null ? void 0 : _e.right)}
+    ${buildZoneCss("bottom-left", (_f = resolved.footer) == null ? void 0 : _f.left)}
+    ${buildZoneCss("bottom-center", (_g = resolved.footer) == null ? void 0 : _g.center)}
+    ${buildZoneCss("bottom-right", (_h = resolved.footer) == null ? void 0 : _h.right, true)}
   }
+  ${coverPageCss}
+  ${backCoverCss}
   @media print {
     body { padding: 0; }
+    .document-watermark { display: none !important; }
     h1, h2, h3, pre, table, blockquote, .callout {
       break-inside: avoid;
     }
@@ -2042,15 +2697,17 @@ startxref
   return Buffer.from(pdfBody, "utf-8");
 }
 async function buildPdfDocument(doc, config, baseDir = process.cwd()) {
+  var _a, _b, _c;
   const baseHtml = await buildHtmlDocument(doc, config, baseDir);
   const pagedHtml = injectPagedMediaStyles(baseHtml, config, doc.metadata);
   const chromePath = findChromeExecutable();
   if (chromePath) {
     const tmpId = Math.random().toString(36).substring(2, 9);
     const tmpDir = os.tmpdir();
-    const tmpHtml = path5.join(tmpDir, `markforge_${tmpId}.html`);
-    const tmpPdf = path5.join(tmpDir, `markforge_${tmpId}.pdf`);
-    const tmpProfile = path5.join(tmpDir, `markforge_prof_${tmpId}`);
+    const tmpHtml = path3.join(tmpDir, `markforge_${tmpId}.html`);
+    const tmpPdf = path3.join(tmpDir, `markforge_${tmpId}.pdf`);
+    const tmpProfile = path3.join(tmpDir, `markforge_prof_${tmpId}`);
+    const isWin = process.platform === "win32";
     const isolatedFlags = [
       `--user-data-dir=${tmpProfile}`,
       "--no-first-run",
@@ -2061,7 +2718,6 @@ async function buildPdfDocument(doc, config, baseDir = process.cwd()) {
       "--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",
@@ -2070,12 +2726,10 @@ async function buildPdfDocument(doc, config, baseDir = process.cwd()) {
       "--mute-audio",
       "--no-service-autorun",
       "--disable-gpu",
-      "--no-sandbox",
-      "--disable-setuid-sandbox",
-      "--allow-file-access-from-files",
-      "--disable-web-security",
+      ...isWin ? [] : ["--no-sandbox", "--disable-setuid-sandbox"],
       "--force-color-profile=srgb",
-      "--no-pdf-header-footer"
+      "--no-pdf-header-footer",
+      "--window-size=1200,1600"
     ];
     try {
       fs3.writeFileSync(tmpHtml, pagedHtml, "utf-8");
@@ -2090,7 +2744,7 @@ async function buildPdfDocument(doc, config, baseDir = process.cwd()) {
           `--print-to-pdf=${tmpPdf}`,
           fileUrl
         ],
-        { timeout: 3e4 }
+        { timeout: 3e4, windowsHide: true }
       );
       if ((res.status !== 0 || !fs3.existsSync(tmpPdf)) && chromePath) {
         res = spawnSync(
@@ -2101,12 +2755,78 @@ async function buildPdfDocument(doc, config, baseDir = process.cwd()) {
             `--print-to-pdf=${tmpPdf}`,
             fileUrl
           ],
-          { timeout: 3e4 }
+          { timeout: 3e4, windowsHide: true }
         );
       }
       if (fs3.existsSync(tmpPdf) && fs3.statSync(tmpPdf).size > 0) {
         const pdfBuffer = fs3.readFileSync(tmpPdf);
-        return pdfBuffer;
+        try {
+          const pdfDoc = await PDFDocument.load(pdfBuffer);
+          const resolved = resolveDocumentConfig(doc.metadata, config);
+          if (resolved.title) pdfDoc.setTitle(resolved.title);
+          if (resolved.author) pdfDoc.setAuthor(resolved.author);
+          if (resolved.subtitle) pdfDoc.setSubject(resolved.subtitle);
+          pdfDoc.setCreator("MarkForge Enterprise Document Generator");
+          pdfDoc.setProducer("MarkForge (by Ma'sum)");
+          pdfDoc.setModificationDate(/* @__PURE__ */ new Date());
+          if (((_a = resolved.backCover) == null ? void 0 : _a.enabled) && pdfDoc.getPageCount() > 2) {
+            pdfDoc.removePage(pdfDoc.getPageCount() - 1);
+          }
+          if (resolved.watermark) {
+            const wmPng = generateWatermarkPngBuffer(chromePath, resolved.watermark);
+            if (wmPng) {
+              const embeddedPng = await pdfDoc.embedPng(wmPng);
+              const pages = pdfDoc.getPages();
+              const startPageIndex = ((_b = resolved.coverPage) == null ? void 0 : _b.enabled) ? 1 : 0;
+              const endPageIndex = ((_c = resolved.backCover) == null ? void 0 : _c.enabled) ? pages.length - 1 : pages.length;
+              for (let i = startPageIndex; i < endPageIndex; i++) {
+                const page = pages[i];
+                const { width, height } = page.getSize();
+                page.drawImage(embeddedPng, {
+                  x: 0,
+                  y: 0,
+                  width,
+                  height
+                });
+              }
+            }
+          }
+          const savedBytes = await pdfDoc.save();
+          let finalBuffer = Buffer.from(savedBytes);
+          if (resolved.security) {
+            const sec = resolved.security;
+            const hasUserPassword = typeof sec.userPassword === "string" && sec.userPassword.length > 0;
+            const hasOwnerPassword = typeof sec.ownerPassword === "string" && sec.ownerPassword.length > 0;
+            if (hasUserPassword || hasOwnerPassword) {
+              try {
+                const userPass = sec.userPassword ?? "";
+                const ownerPass = sec.ownerPassword ?? userPass;
+                const perms = sec.permissions;
+                const encryptedBytes = await encryptPDF(
+                  new Uint8Array(finalBuffer),
+                  userPass,
+                  {
+                    ownerPassword: ownerPass,
+                    algorithm: "AES-256",
+                    allowPrinting: (perms == null ? void 0 : perms.printing) !== "none",
+                    allowHighQualityPrint: (perms == null ? void 0 : perms.printing) === "highResolution",
+                    allowModifying: (perms == null ? void 0 : perms.modifying) ?? true,
+                    allowCopying: (perms == null ? void 0 : perms.copying) ?? true,
+                    allowAnnotating: (perms == null ? void 0 : perms.annotating) ?? true,
+                    allowFillingForms: (perms == null ? void 0 : perms.fillingForms) ?? true,
+                    allowExtraction: (perms == null ? void 0 : perms.contentAccessibility) ?? true,
+                    allowAssembly: (perms == null ? void 0 : perms.documentAssembly) ?? true
+                  }
+                );
+                finalBuffer = Buffer.from(encryptedBytes);
+              } catch {
+              }
+            }
+          }
+          return finalBuffer;
+        } catch {
+          return pdfBuffer;
+        }
       }
     } catch {
     } finally {
@@ -2121,7 +2841,37 @@ async function buildPdfDocument(doc, config, baseDir = process.cwd()) {
   return createFallbackPdfBuffer(doc.metadata.title || "MarkForge Document");
 }
 
+// src/core/docx/docxBuilder.ts
+import {
+  Document,
+  Paragraph,
+  TextRun,
+  HeadingLevel,
+  Table,
+  TableRow,
+  TableCell,
+  WidthType,
+  BorderStyle,
+  AlignmentType,
+  ImageRun,
+  Header,
+  Footer,
+  PageNumber,
+  Packer,
+  PageOrientation,
+  convertInchesToTwip,
+  convertMillimetersToTwip,
+  ShadingType,
+  ExternalHyperlink,
+  TabStopType
+} from "docx";
+
 // src/core/mermaid/mermaidRenderer.ts
+import { spawnSync as spawnSync2 } from "child_process";
+import * as fs4 from "fs";
+import * as os2 from "os";
+import * as path4 from "path";
+import { pathToFileURL as pathToFileURL2 } from "url";
 async function renderMermaidToPng(mermaidCode, _baseDir = process.cwd()) {
   const chromePath = findChromeExecutable();
   if (!chromePath) {
@@ -2129,8 +2879,8 @@ async function renderMermaidToPng(mermaidCode, _baseDir = process.cwd()) {
   }
   const tmpId = Math.random().toString(36).substring(2, 9);
   const tmpDir = os2.tmpdir();
-  const tmpHtml = path6.join(tmpDir, `mermaid_${tmpId}.html`);
-  const tmpScreenshot = path6.join(tmpDir, `mermaid_${tmpId}.png`);
+  const tmpHtml = path4.join(tmpDir, `mermaid_${tmpId}.html`);
+  const tmpScreenshot = path4.join(tmpDir, `mermaid_${tmpId}.png`);
   const htmlContent = `<!DOCTYPE html>
 <html>
 <head>
@@ -2338,6 +3088,29 @@ async function convertInlinesToTextRuns(spans = [], baseDir = process.cwd(), opt
       );
       continue;
     }
+    if (span.type === "mathInline") {
+      runs.push(
+        new TextRun({
+          text: span.content,
+          font: "Cambria Math",
+          italics: true,
+          size: options.size,
+          color: options.color || "0F172A"
+        })
+      );
+      continue;
+    }
+    if (span.type === "footnoteRef") {
+      runs.push(
+        new TextRun({
+          text: `[${span.content}]`,
+          superScript: true,
+          color: "009DA0",
+          bold: true
+        })
+      );
+      continue;
+    }
     runs.push(
       new TextRun({
         text: span.content,
@@ -2352,7 +3125,7 @@ async function convertInlinesToTextRuns(spans = [], baseDir = process.cwd(), opt
   return runs;
 }
 async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
   const resolved = resolveDocumentConfig(doc.metadata, config);
   const docElements = [];
   const themeProps = typeof resolved.theme === "object" ? resolved.theme : {};
@@ -2363,7 +3136,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
   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) {
+  if (resolved.title && !((_a = resolved.coverPage) == null ? void 0 : _a.enabled)) {
     docElements.push(
       new Paragraph({
         children: [
@@ -2779,7 +3552,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
     }
     if (node.type === "table" && node.children) {
       const tableRows = [];
-      const numCols = ((_b = (_a = node.children[0]) == null ? void 0 : _a.children) == null ? void 0 : _b.length) || 1;
+      const numCols = ((_c = (_b = node.children[0]) == null ? void 0 : _b.children) == null ? void 0 : _c.length) || 1;
       const colWidth = Math.floor(9e3 / numCols);
       for (let rowIdx = 0; rowIdx < node.children.length; rowIdx++) {
         const rowNode = node.children[rowIdx];
@@ -2789,7 +3562,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
         if (rowNode.children) {
           for (let colIdx = 0; colIdx < rowNode.children.length; colIdx++) {
             const cellNode = rowNode.children[colIdx];
-            const align = (_c = node.align) == null ? void 0 : _c[colIdx];
+            const align = (_d = node.align) == null ? void 0 : _d[colIdx];
             let alignment = AlignmentType.LEFT;
             if (align === "center") alignment = AlignmentType.CENTER;
             if (align === "right") alignment = AlignmentType.RIGHT;
@@ -2928,6 +3701,113 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
       }
       continue;
     }
+    if (node.type === "mathBlock") {
+      docElements.push(
+        new Paragraph({
+          alignment: AlignmentType.CENTER,
+          children: [
+            new TextRun({
+              text: node.text || "",
+              font: "Cambria Math",
+              italics: true,
+              size: 24,
+              // 12pt
+              color: textHex
+            })
+          ],
+          spacing: { before: 180, after: 180 },
+          shading: { fill: cardBgHex, type: ShadingType.CLEAR },
+          border: {
+            top: { style: BorderStyle.SINGLE, size: 4, color: borderHex },
+            bottom: { style: BorderStyle.SINGLE, size: 4, color: borderHex },
+            left: { style: BorderStyle.SINGLE, size: 4, color: borderHex },
+            right: { style: BorderStyle.SINGLE, size: 4, color: borderHex }
+          }
+        })
+      );
+      continue;
+    }
+    if (node.type === "columns") {
+      const cols = node.columnsCount || 2;
+      const contentWidth = Math.max(
+        1e3,
+        resolved.paperDimensions.widthTwip - resolved.margins.leftTwip - resolved.margins.rightTwip
+      );
+      const cellWidthDxa = Math.floor(contentWidth / cols);
+      const cells = [];
+      for (const col of node.children || []) {
+        const colParagraphs = [];
+        for (const childNode of col.children || []) {
+          if (childNode.type === "heading") {
+            const runs = await convertInlinesToTextRuns(childNode.inlines, baseDir, { font: defaultFont, bold: true, size: 24, color: primaryDarkHex });
+            colParagraphs.push(new Paragraph({ children: runs, spacing: { before: 120, after: 60 } }));
+          } else if (childNode.type === "paragraph") {
+            const runs = await convertInlinesToTextRuns(childNode.inlines, baseDir, { font: defaultFont, size: 21, color: textHex });
+            colParagraphs.push(new Paragraph({ children: runs, spacing: { after: 100 } }));
+          } else if (childNode.type === "list" && childNode.children) {
+            for (const item of childNode.children) {
+              const runs = await convertInlinesToTextRuns(item.inlines, baseDir, { font: defaultFont, size: 21, color: textHex });
+              colParagraphs.push(new Paragraph({ children: [new TextRun({ text: "\u2022  ", font: defaultFont, color: primaryHex }), ...runs], spacing: { after: 40 } }));
+            }
+          }
+        }
+        if (colParagraphs.length === 0) colParagraphs.push(new Paragraph({}));
+        cells.push(
+          new TableCell({
+            width: { size: cellWidthDxa, type: WidthType.DXA },
+            borders: {
+              top: { style: BorderStyle.NONE, size: 0, color: "auto" },
+              bottom: { style: BorderStyle.NONE, size: 0, color: "auto" },
+              left: { style: BorderStyle.NONE, size: 0, color: "auto" },
+              right: { style: BorderStyle.NONE, size: 0, color: "auto" }
+            },
+            margins: { top: 60, bottom: 60, left: 100, right: 100 },
+            children: colParagraphs
+          })
+        );
+      }
+      docElements.push(
+        new Table({
+          width: { size: 100, type: WidthType.PERCENTAGE },
+          rows: [new TableRow({ children: cells })]
+        })
+      );
+      docElements.push(new Paragraph({ spacing: { after: 120 } }));
+      continue;
+    }
+  }
+  if (doc.footnoteDefs && doc.footnoteDefs.length > 0) {
+    docElements.push(
+      new Paragraph({
+        border: {
+          top: { style: BorderStyle.SINGLE, size: 4, color: borderHex, space: 8 }
+        },
+        spacing: { before: 360, after: 120 }
+      })
+    );
+    for (const def of doc.footnoteDefs) {
+      const defRuns = await convertInlinesToTextRuns(def.inlines, baseDir, {
+        font: defaultFont,
+        size: 18,
+        // 9pt
+        color: textMutedHex
+      });
+      docElements.push(
+        new Paragraph({
+          children: [
+            new TextRun({
+              text: `[${def.id}] `,
+              bold: true,
+              color: primaryDarkHex,
+              font: defaultFont,
+              size: 18
+            }),
+            ...defRuns
+          ],
+          spacing: { after: 60 }
+        })
+      );
+    }
   }
   if (resolved.signatures && resolved.signatures.items.length > 0) {
     const sig = resolved.signatures;
@@ -2989,7 +3869,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
   const centerPos = Math.round(contentWidthTwip / 2);
   const rightPos = contentWidthTwip;
   const headerRuns = [];
-  if ((_d = resolved.header) == null ? void 0 : _d.left) {
+  if ((_e = resolved.header) == null ? void 0 : _e.left) {
     headerRuns.push(
       new TextRun({
         text: resolved.header.left.text,
@@ -3002,7 +3882,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
     );
   }
   headerRuns.push(new TextRun({ text: "	" }));
-  if ((_e = resolved.header) == null ? void 0 : _e.center) {
+  if ((_f = resolved.header) == null ? void 0 : _f.center) {
     headerRuns.push(
       new TextRun({
         text: resolved.header.center.text,
@@ -3015,7 +3895,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
     );
   }
   headerRuns.push(new TextRun({ text: "	" }));
-  if ((_f = resolved.header) == null ? void 0 : _f.right) {
+  if ((_g = resolved.header) == null ? void 0 : _g.right) {
     headerRuns.push(
       new TextRun({
         text: resolved.header.right.text,
@@ -3027,7 +3907,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
       })
     );
   }
-  const docHeader = resolved.header ? new Header2({
+  const docHeader = resolved.header ? new Header({
     children: [
       new Paragraph({
         tabStops: [
@@ -3054,7 +3934,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
     ]
   }) : void 0;
   const footerRuns = [];
-  if ((_g = resolved.footer) == null ? void 0 : _g.left) {
+  if ((_h = resolved.footer) == null ? void 0 : _h.left) {
     footerRuns.push(
       new TextRun({
         text: resolved.footer.left.text,
@@ -3067,7 +3947,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
     );
   }
   footerRuns.push(new TextRun({ text: "	" }));
-  if ((_h = resolved.footer) == null ? void 0 : _h.center) {
+  if ((_i = resolved.footer) == null ? void 0 : _i.center) {
     footerRuns.push(
       new TextRun({
         text: resolved.footer.center.text,
@@ -3080,7 +3960,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
     );
   }
   footerRuns.push(new TextRun({ text: "	" }));
-  if ((_i = resolved.footer) == null ? void 0 : _i.right) {
+  if ((_j = resolved.footer) == null ? void 0 : _j.right) {
     const rZone = resolved.footer.right;
     const rColor = rZone.color.replace("#", "");
     const rSize = (rZone.fontSize || 9) * 2;
@@ -3165,6 +4045,91 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
     ]
   }) : void 0;
   const isLandscape = resolved.orientation === "landscape";
+  const docSections = [];
+  if (resolved.coverPage && resolved.coverPage.enabled) {
+    const coverElements = await buildDocxCoverPageElements(
+      resolved.coverPage,
+      defaultFont,
+      textHex,
+      primaryHex,
+      primaryDarkHex,
+      textMutedHex,
+      baseDir
+    );
+    docSections.push({
+      properties: {
+        page: {
+          size: {
+            width: resolved.paperDimensions.widthTwip,
+            height: resolved.paperDimensions.heightTwip,
+            orientation: isLandscape ? PageOrientation.LANDSCAPE : PageOrientation.PORTRAIT
+          },
+          margin: {
+            top: resolved.margins.topTwip,
+            bottom: resolved.margins.bottomTwip,
+            left: resolved.margins.leftTwip,
+            right: resolved.margins.rightTwip
+          }
+        }
+      },
+      headers: void 0,
+      footers: void 0,
+      children: coverElements
+    });
+  }
+  docSections.push({
+    properties: {
+      page: {
+        size: {
+          width: resolved.paperDimensions.widthTwip,
+          height: resolved.paperDimensions.heightTwip,
+          orientation: isLandscape ? PageOrientation.LANDSCAPE : PageOrientation.PORTRAIT
+        },
+        margin: {
+          top: resolved.margins.topTwip,
+          bottom: resolved.margins.bottomTwip,
+          left: resolved.margins.leftTwip,
+          right: resolved.margins.rightTwip,
+          header: 720,
+          footer: 720
+        }
+      }
+    },
+    headers: docHeader ? { default: docHeader } : void 0,
+    footers: docFooter ? { default: docFooter } : void 0,
+    children: docElements
+  });
+  if (resolved.backCover && resolved.backCover.enabled) {
+    const backElements = await buildDocxBackCoverElements(
+      resolved.backCover,
+      defaultFont,
+      textHex,
+      primaryHex,
+      primaryDarkHex,
+      textMutedHex,
+      baseDir
+    );
+    docSections.push({
+      properties: {
+        page: {
+          size: {
+            width: resolved.paperDimensions.widthTwip,
+            height: resolved.paperDimensions.heightTwip,
+            orientation: isLandscape ? PageOrientation.LANDSCAPE : PageOrientation.PORTRAIT
+          },
+          margin: {
+            top: resolved.margins.topTwip,
+            bottom: resolved.margins.bottomTwip,
+            left: resolved.margins.leftTwip,
+            right: resolved.margins.rightTwip
+          }
+        }
+      },
+      headers: void 0,
+      footers: void 0,
+      children: backElements
+    });
+  }
   const document = new Document({
     styles: {
       default: {
@@ -3185,33 +4150,250 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
         }
       }
     },
-    sections: [
-      {
-        properties: {
-          page: {
-            size: {
-              width: resolved.paperDimensions.widthTwip,
-              height: resolved.paperDimensions.heightTwip,
-              orientation: isLandscape ? PageOrientation.LANDSCAPE : PageOrientation.PORTRAIT
-            },
-            margin: {
-              top: resolved.margins.topTwip,
-              bottom: resolved.margins.bottomTwip,
-              left: resolved.margins.leftTwip,
-              right: resolved.margins.rightTwip,
-              header: 720,
-              footer: 720
-            }
-          }
-        },
-        headers: docHeader ? { default: docHeader } : void 0,
-        footers: docFooter ? { default: docFooter } : void 0,
-        children: docElements
-      }
-    ]
+    sections: docSections
   });
   return await Packer.toBuffer(document);
 }
+async function buildDocxBackCoverElements(backCover, defaultFont, textHex, primaryHex, primaryDarkHex, textMutedHex, baseDir) {
+  var _a;
+  const elements = [];
+  elements.push(new Paragraph({ spacing: { before: 1800 } }));
+  if (backCover.logo) {
+    const resolvedLogo = await resolveImage(backCover.logo, baseDir);
+    if (resolvedLogo) {
+      const logoW = typeof backCover.logoWidth === "number" ? backCover.logoWidth : 140;
+      const logoType = ((_a = resolvedLogo.mimeType) == null ? void 0 : _a.includes("png")) ? "png" : "jpg";
+      elements.push(
+        new Paragraph({
+          children: [
+            new ImageRun({
+              data: resolvedLogo.buffer,
+              transformation: {
+                width: logoW,
+                height: Math.round(logoW * 0.75)
+              },
+              type: logoType
+            })
+          ],
+          spacing: { after: 240 }
+        })
+      );
+    }
+  }
+  if (backCover.badge) {
+    elements.push(
+      new Paragraph({
+        children: [
+          new TextRun({
+            text: `[ ${backCover.badge.toUpperCase()} ]`,
+            font: defaultFont,
+            size: 20,
+            bold: true,
+            color: primaryDarkHex
+          })
+        ],
+        spacing: { after: 240 }
+      })
+    );
+  }
+  elements.push(
+    new Paragraph({
+      children: [
+        new TextRun({
+          text: backCover.title,
+          font: defaultFont,
+          size: 52,
+          // 26pt
+          bold: true,
+          color: textHex
+        })
+      ],
+      spacing: { after: 140 }
+    })
+  );
+  if (backCover.subtitle) {
+    elements.push(
+      new Paragraph({
+        children: [
+          new TextRun({
+            text: backCover.subtitle,
+            font: defaultFont,
+            size: 24,
+            // 12pt
+            color: textMutedHex
+          })
+        ],
+        spacing: { after: 480 }
+      })
+    );
+  }
+  elements.push(
+    new Paragraph({
+      border: {
+        bottom: { style: BorderStyle.SINGLE, size: 16, color: primaryHex, space: 8 }
+      },
+      spacing: { after: 480 }
+    })
+  );
+  const contactRuns = [];
+  if (backCover.company) contactRuns.push(new TextRun({ text: `Organization:  ${backCover.company}
+`, font: defaultFont, size: 21, color: textHex }));
+  if (backCover.address) contactRuns.push(new TextRun({ text: `Address:  ${backCover.address}
+`, font: defaultFont, size: 21, color: textHex }));
+  if (backCover.email) contactRuns.push(new TextRun({ text: `Email:  ${backCover.email}
+`, font: defaultFont, size: 21, color: textHex }));
+  if (backCover.phone) contactRuns.push(new TextRun({ text: `Phone:  ${backCover.phone}
+`, font: defaultFont, size: 21, color: textHex }));
+  if (backCover.website) contactRuns.push(new TextRun({ text: `Website:  ${backCover.website}
+`, font: defaultFont, size: 21, color: textHex }));
+  if (backCover.social) {
+    for (const [net, url] of Object.entries(backCover.social)) {
+      if (url) {
+        contactRuns.push(new TextRun({ text: `${net.toUpperCase()}:  ${url}
+`, font: defaultFont, size: 21, color: textHex }));
+      }
+    }
+  }
+  if (contactRuns.length > 0) {
+    elements.push(
+      new Paragraph({
+        children: contactRuns,
+        spacing: { before: 360, after: 360 }
+      })
+    );
+  }
+  if (backCover.copyright) {
+    elements.push(
+      new Paragraph({
+        children: [
+          new TextRun({
+            text: backCover.copyright,
+            font: defaultFont,
+            size: 18,
+            color: "94A3B8"
+          })
+        ],
+        spacing: { before: 720 }
+      })
+    );
+  }
+  return elements;
+}
+async function buildDocxCoverPageElements(cover, defaultFont, textHex, primaryHex, primaryDarkHex, textMutedHex, baseDir) {
+  var _a;
+  const elements = [];
+  elements.push(new Paragraph({ spacing: { before: 1800 } }));
+  if (cover.logo) {
+    const resolvedLogo = await resolveImage(cover.logo, baseDir);
+    if (resolvedLogo) {
+      const logoW = typeof cover.logoWidth === "number" ? cover.logoWidth : 140;
+      const logoType = ((_a = resolvedLogo.mimeType) == null ? void 0 : _a.includes("png")) ? "png" : "jpg";
+      elements.push(
+        new Paragraph({
+          children: [
+            new ImageRun({
+              data: resolvedLogo.buffer,
+              transformation: {
+                width: logoW,
+                height: Math.round(logoW * 0.75)
+              },
+              type: logoType
+            })
+          ],
+          spacing: { after: 240 }
+        })
+      );
+    }
+  }
+  if (cover.badge) {
+    elements.push(
+      new Paragraph({
+        children: [
+          new TextRun({
+            text: `[ ${cover.badge.toUpperCase()} ]`,
+            font: defaultFont,
+            size: 20,
+            bold: true,
+            color: primaryDarkHex
+          })
+        ],
+        spacing: { after: 240 }
+      })
+    );
+  }
+  elements.push(
+    new Paragraph({
+      children: [
+        new TextRun({
+          text: cover.title,
+          font: defaultFont,
+          size: 56,
+          // 28pt
+          bold: true,
+          color: textHex
+        })
+      ],
+      spacing: { after: 140 }
+    })
+  );
+  if (cover.subtitle) {
+    elements.push(
+      new Paragraph({
+        children: [
+          new TextRun({
+            text: cover.subtitle,
+            font: defaultFont,
+            size: 26,
+            // 13pt
+            color: textMutedHex
+          })
+        ],
+        spacing: { after: 480 }
+      })
+    );
+  }
+  elements.push(
+    new Paragraph({
+      border: {
+        bottom: { style: BorderStyle.SINGLE, size: 16, color: primaryHex, space: 8 }
+      },
+      spacing: { after: 480 }
+    })
+  );
+  if (cover.company || cover.author || cover.version || cover.date) {
+    const metaRuns = [];
+    if (cover.company) metaRuns.push(new TextRun({ text: `Organization:  ${cover.company}
+`, font: defaultFont, size: 21, color: textHex }));
+    if (cover.author) metaRuns.push(new TextRun({ text: `Author:  ${cover.author}
+`, font: defaultFont, size: 21, color: textHex }));
+    if (cover.version) metaRuns.push(new TextRun({ text: `Version:  ${cover.version}
+`, font: defaultFont, size: 21, color: textHex }));
+    if (cover.date) metaRuns.push(new TextRun({ text: `Date:  ${cover.date}
+`, font: defaultFont, size: 21, color: textHex }));
+    elements.push(
+      new Paragraph({
+        children: metaRuns,
+        spacing: { before: 360, after: 360 }
+      })
+    );
+  }
+  if (cover.footerText) {
+    elements.push(
+      new Paragraph({
+        children: [
+          new TextRun({
+            text: cover.footerText,
+            font: defaultFont,
+            size: 18,
+            color: "94A3B8"
+          })
+        ],
+        spacing: { before: 720 }
+      })
+    );
+  }
+  return elements;
+}
 async function buildDocxSignatureCell(item, sig, widthDxa, defaultFont, baseDir) {
   const cellParagraphs = [];
   if (item.title) {
@@ -3347,126 +4529,9 @@ function createEmptyDocxCell(widthDxa) {
   });
 }
 
-// src/core/engine.ts
-async function compileMarkdown(inputFilePathOrContent, userConfig = {}, onProgress) {
-  const startTime = Date.now();
-  const config = { ...DEFAULT_CONFIG, ...userConfig };
-  let rawMarkdown = "";
-  let baseDir = process.cwd();
-  let inputFileName = "document.md";
-  let isFilePath = false;
-  if (fs5.existsSync(inputFilePathOrContent)) {
-    isFilePath = true;
-    rawMarkdown = fs5.readFileSync(inputFilePathOrContent, "utf-8");
-    baseDir = path7.dirname(path7.resolve(inputFilePathOrContent));
-    inputFileName = path7.basename(inputFilePathOrContent);
-  } else {
-    rawMarkdown = inputFilePathOrContent;
-  }
-  onProgress == null ? void 0 : onProgress(`Parsing markdown AST: ${inputFileName}...`);
-  const parsedDoc = parseMarkdownDocument(rawMarkdown);
-  const baseName = inputFileName.replace(/\.(md|mdx|markdown)$/i, "");
-  const outputDir = config.outputDir ? path7.isAbsolute(config.outputDir) ? config.outputDir : path7.resolve(process.cwd(), config.outputDir) : baseDir;
-  if (!fs5.existsSync(outputDir)) {
-    fs5.mkdirSync(outputDir, { recursive: true });
-  }
-  const formats = Array.isArray(config.to) ? config.to : [config.to || "docx", "pdf"];
-  const generatedFiles = [];
-  const errors = [];
-  for (const fmt of formats) {
-    try {
-      if (fmt === "docx") {
-        onProgress == null ? void 0 : onProgress(`Generating DOCX document: ${baseName}.docx...`);
-        const docxBuffer = await buildDocxDocument(parsedDoc, config, baseDir);
-        const docxPath = path7.join(outputDir, `${baseName}.docx`);
-        fs5.writeFileSync(docxPath, docxBuffer);
-        generatedFiles.push({
-          format: "docx",
-          filePath: docxPath,
-          fileName: `${baseName}.docx`,
-          sizeBytes: docxBuffer.length
-        });
-      } else if (fmt === "html") {
-        onProgress == null ? void 0 : onProgress(`Generating HTML document: ${baseName}.html...`);
-        const htmlString = await buildHtmlDocument(parsedDoc, config, baseDir);
-        const htmlPath = path7.join(outputDir, `${baseName}.html`);
-        fs5.writeFileSync(htmlPath, htmlString, "utf-8");
-        generatedFiles.push({
-          format: "html",
-          filePath: htmlPath,
-          fileName: `${baseName}.html`,
-          sizeBytes: Buffer.byteLength(htmlString, "utf-8")
-        });
-      } else if (fmt === "pdf") {
-        onProgress == null ? void 0 : onProgress(`Generating PDF document: ${baseName}.pdf...`);
-        const pdfBuffer = await buildPdfDocument(parsedDoc, config, baseDir);
-        const pdfPath = path7.join(outputDir, `${baseName}.pdf`);
-        fs5.writeFileSync(pdfPath, pdfBuffer);
-        generatedFiles.push({
-          format: "pdf",
-          filePath: pdfPath,
-          fileName: `${baseName}.pdf`,
-          sizeBytes: pdfBuffer.length
-        });
-      }
-    } catch (err) {
-      const errMsg = err instanceof Error ? err.message : String(err);
-      errors.push(`Failed to generate ${fmt}: ${errMsg}`);
-    }
-  }
-  const durationMs = Date.now() - startTime;
-  return {
-    inputFile: isFilePath ? inputFilePathOrContent : "inline-string",
-    durationMs,
-    metadata: parsedDoc.metadata,
-    files: generatedFiles,
-    errors
-  };
-}
-
-// src/ui/App.tsx
-import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
-var App = ({ inputFile, config, onComplete }) => {
-  const [status, setStatus] = useState("Initializing...");
-  const [isCompiling, setIsCompiling] = useState(true);
-  const [result, setResult] = useState(null);
-  useEffect(() => {
-    async function run() {
-      try {
-        const res = await compileMarkdown(inputFile, config, (msg) => setStatus(msg));
-        setResult(res);
-        setIsCompiling(false);
-        onComplete == null ? void 0 : onComplete(res);
-      } catch (err) {
-        const errMsg = err instanceof Error ? err.message : String(err);
-        const errResult = {
-          inputFile,
-          durationMs: 0,
-          metadata: {},
-          files: [],
-          errors: [errMsg]
-        };
-        setResult(errResult);
-        setIsCompiling(false);
-        onComplete == null ? void 0 : onComplete(errResult);
-      }
-    }
-    run();
-  }, [inputFile, config, onComplete]);
-  const targetFormats = Array.isArray(config.to) ? config.to : config.to ? [String(config.to)] : ["docx", "pdf"];
-  return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsx4(
-      Header,
-      {
-        inputFile,
-        theme: config.theme,
-        targetFormats
-      }
-    ),
-    /* @__PURE__ */ jsx4(LiveProgress, { status, isCompiling }),
-    /* @__PURE__ */ jsx4(SummaryTable, { result })
-  ] });
-};
 export {
-  App
+  parseMarkdownDocument,
+  buildHtmlDocument,
+  buildPdfDocument,
+  buildDocxDocument
 };