@masumdev/markforge 0.3.0 → 0.4.1

package/dist/index.mjs

@@ -49,6 +49,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({
@@ -148,7 +168,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",
@@ -169,11 +189,51 @@ function parseInlineSpans(text) {
       remaining = remaining.slice(nextSpecial);
     }
   }
-  return spans;
+  const merged = [];
+  for (const s of spans) {
+    const prev = merged[merged.length - 1];
+    if (prev && prev.type === "text" && s.type === "text") {
+      prev.content += s.content;
+    } else {
+      merged.push(s);
+    }
+  }
+  return merged;
 }
 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) {
+      if (node._numbered) continue;
+      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);
+      node._numbered = true;
+      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 || {};
@@ -185,6 +245,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];
@@ -213,6 +274,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();
@@ -239,6 +323,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();
@@ -362,7 +540,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++;
     }
@@ -373,12 +551,19 @@ 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
   };
 }
 
@@ -404,7 +589,9 @@ import {
   convertMillimetersToTwip,
   ShadingType,
   ExternalHyperlink,
-  TabStopType
+  TabStopType,
+  PageBreak,
+  NumberFormat
 } from "docx";
 
 // src/core/imageResolver.ts
@@ -466,9 +653,14 @@ async function resolveImage(src, baseDir = process.cwd()) {
       memoryImageCache.set(cacheKey, resolved2);
       return resolved2;
     }
-    const localPath = path.isAbsolute(src) ? src : path.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);
@@ -873,6 +1065,8 @@ import * as path4 from "path";
 import * as os from "os";
 import { pathToFileURL as pathToFileURL2 } from "url";
 import { spawnSync } from "child_process";
+import { PDFDocument } from "pdf-lib";
+import { encryptPDF } from "@pdfsmaller/pdf-encrypt";
 
 // src/core/html/htmlBuilder.ts
 import * as fs3 from "fs";
@@ -944,7 +1138,7 @@ var THEME_COMPONENTS = `
 .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 { background: var(--mf-card-bg); border: 1px solid var(--mf-border); border-radius: 8px; padding: 1.5rem 2rem; margin: 2rem 0; page-break-after: always; break-after: page; }
 .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; }
@@ -1017,11 +1211,13 @@ var THEME_CORPORATE = `
 }
 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; }
+h1, h2, h3, h4, h5, h6 { color: var(--mf-primary-dark); font-weight: 700; margin-top: 1.8rem; margin-bottom: 0.8rem; line-height: 1.25; }
+h1 { font-size: 2.2rem; color: var(--mf-primary-dark); border-bottom: 2.5px 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; }
+h3 { font-size: 1.3rem; color: var(--mf-primary-dark); }
+h4 { font-size: 1.1rem; color: var(--mf-primary-dark); }
+h5 { font-size: 1.0rem; color: var(--mf-primary-dark); }
+h6 { font-size: 0.9rem; color: var(--mf-primary-dark); }
 p  { margin: 0.8rem 0; }
 `;
 var THEME_DEFAULT = THEME_CORPORATE;
@@ -1063,11 +1259,13 @@ function generateThemeCss(theme) {
 }
 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; }
+h1, h2, h3, h4, h5, h6 { color: var(--mf-primary-dark); font-weight: 700; margin-top: 1.8rem; margin-bottom: 0.8rem; line-height: 1.25; }
+h1 { font-size: 2.2rem; color: var(--mf-primary-dark); border-bottom: 2.5px 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; }
+h3 { font-size: 1.3rem; color: var(--mf-primary-dark); }
+h4 { font-size: 1.1rem; color: var(--mf-primary-dark); }
+h5 { font-size: 1.0rem; color: var(--mf-primary-dark); }
+h6 { font-size: 0.9rem; color: var(--mf-primary-dark); }
 p  { margin: 0.8rem 0; }
 ${theme.customCss || ""}
 `;
@@ -1115,6 +1313,12 @@ var DEFAULT_CONFIG = {
   },
   toc: false,
   watermark: void 0,
+  signatures: void 0,
+  coverPage: void 0,
+  backCover: void 0,
+  numberHeadings: void 0,
+  security: void 0,
+  math: true,
   embedImages: true,
   metadata: void 0,
   watch: false,
@@ -1270,15 +1474,45 @@ function formatMarginCss(margin, defaultCss = "2.5cm") {
   if (/^[0-9.]+$/.test(str)) return `${str}pt`;
   return str;
 }
-function replaceDocumentTokens(template = "", meta) {
-  return template.replace(/\{title\}/gi, meta.title || "").replace(/\{subtitle\}/gi, meta.subtitle || "").replace(/\{author\}/gi, meta.author || "").replace(/\{version\}/gi, meta.version || "").replace(/\{date\}/gi, meta.date || "").replace(/\{company\}/gi, meta.company || "");
+function replaceDocumentTokens(template = "", meta = {}) {
+  if (!template) return "";
+  const currentYear = meta.year ? String(meta.year) : (/* @__PURE__ */ new Date()).getFullYear().toString();
+  const tokenMap = {
+    title: meta.title ? String(meta.title) : "",
+    subtitle: meta.subtitle ? String(meta.subtitle) : "",
+    author: meta.author ? Array.isArray(meta.author) ? meta.author.join(", ") : String(meta.author) : "",
+    version: meta.version ? String(meta.version) : "",
+    date: meta.date ? String(meta.date) : "",
+    company: meta.company ? String(meta.company) : "",
+    year: currentYear
+  };
+  if (meta.metadata && typeof meta.metadata === "object") {
+    for (const [key, val] of Object.entries(meta.metadata)) {
+      if (val !== void 0 && val !== null) {
+        tokenMap[key.toLowerCase()] = String(val);
+      }
+    }
+  }
+  for (const [key, val] of Object.entries(meta)) {
+    if (val !== void 0 && val !== null && typeof val !== "object") {
+      tokenMap[key.toLowerCase()] = String(val);
+    }
+  }
+  return template.replace(/\{([a-zA-Z0-9_\-]+)\}/gi, (match, tokenKey) => {
+    const lowerKey = tokenKey.toLowerCase();
+    if (lowerKey in tokenMap) {
+      return tokenMap[lowerKey];
+    }
+    return match;
+  });
 }
-function normalizeWatermark(rawWatermark) {
+function normalizeWatermark(rawWatermark, tokens) {
   if (!rawWatermark) {
     return void 0;
   }
   if (typeof rawWatermark === "string") {
-    const text = rawWatermark.trim();
+    let text = rawWatermark.trim();
+    if (tokens) text = replaceDocumentTokens(text, tokens);
     if (!text) return void 0;
     return {
       text,
@@ -1291,8 +1525,10 @@ function normalizeWatermark(rawWatermark) {
   }
   if (typeof rawWatermark === "object") {
     if (!rawWatermark.text || !rawWatermark.text.trim()) return void 0;
+    let text = rawWatermark.text.trim();
+    if (tokens) text = replaceDocumentTokens(text, tokens);
     return {
-      text: rawWatermark.text.trim(),
+      text,
       color: rawWatermark.color || "#94a3b8",
       opacity: typeof rawWatermark.opacity === "number" ? rawWatermark.opacity : 0.08,
       fontSize: rawWatermark.fontSize || 54,
@@ -1408,6 +1644,174 @@ 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 ? String(tokenCtx.title) : "Document Title";
+  const subtitle = cfg.subtitle ? replaceDocumentTokens(String(cfg.subtitle), tokenCtx) : tokenCtx.subtitle ? String(tokenCtx.subtitle) : void 0;
+  const author = Array.isArray(cfg.author) ? cfg.author.join(", ") : cfg.author ? replaceDocumentTokens(String(cfg.author), tokenCtx) : tokenCtx.author ? String(tokenCtx.author) : void 0;
+  const company = cfg.company ? replaceDocumentTokens(String(cfg.company), tokenCtx) : tokenCtx.company ? String(tokenCtx.company) : void 0;
+  const version = cfg.version ? replaceDocumentTokens(String(cfg.version), tokenCtx) : tokenCtx.version ? String(tokenCtx.version) : void 0;
+  let dateStr;
+  if (typeof cfg.date === "string") {
+    dateStr = replaceDocumentTokens(cfg.date, tokenCtx);
+  } else if (cfg.date === true) {
+    dateStr = tokenCtx.date ? String(tokenCtx.date) : (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  } else {
+    dateStr = tokenCtx.date ? String(tokenCtx.date) : 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 : typeof cfg.backgroundColor === "string" ? cfg.backgroundColor : void 0;
+  const backgroundColor = typeof cfg.backgroundColor === "string" ? cfg.backgroundColor : void 0;
+  const textColor = typeof cfg.textColor === "string" ? cfg.textColor : void 0;
+  const titleColor = typeof cfg.titleColor === "string" ? cfg.titleColor : void 0;
+  const subtitleColor = typeof cfg.subtitleColor === "string" ? cfg.subtitleColor : void 0;
+  const accentColor = typeof cfg.accentColor === "string" ? cfg.accentColor : void 0;
+  const footerText = cfg.footerText ? replaceDocumentTokens(String(cfg.footerText), tokenCtx) : void 0;
+  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 }) : void 0;
+  return {
+    enabled: true,
+    preset,
+    title,
+    subtitle,
+    author,
+    company,
+    version,
+    date: dateStr,
+    badge,
+    badgeColor,
+    badgeTextColor,
+    logo,
+    logoWidth,
+    bgGradient,
+    backgroundColor,
+    textColor,
+    titleColor,
+    subtitleColor,
+    accentColor,
+    footerText,
+    address,
+    email,
+    phone,
+    website,
+    social: socialMap,
+    copyright
+  };
+}
+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 author = Array.isArray(cfg.author) ? cfg.author.join(", ") : cfg.author ? replaceDocumentTokens(String(cfg.author), tokenCtx) : tokenCtx.author ? String(tokenCtx.author) : void 0;
+  const company = cfg.company ? replaceDocumentTokens(String(cfg.company), tokenCtx) : tokenCtx.company ? String(tokenCtx.company) : void 0;
+  const version = cfg.version ? replaceDocumentTokens(String(cfg.version), tokenCtx) : tokenCtx.version ? String(tokenCtx.version) : void 0;
+  const date = typeof cfg.date === "string" ? replaceDocumentTokens(cfg.date, tokenCtx) : tokenCtx.date ? String(tokenCtx.date) : void 0;
+  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 footerText = cfg.footerText ? replaceDocumentTokens(String(cfg.footerText), tokenCtx) : 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 : typeof cfg.backgroundColor === "string" ? cfg.backgroundColor : void 0;
+  const backgroundColor = typeof cfg.backgroundColor === "string" ? cfg.backgroundColor : void 0;
+  const textColor = typeof cfg.textColor === "string" ? cfg.textColor : void 0;
+  const titleColor = typeof cfg.titleColor === "string" ? cfg.titleColor : void 0;
+  const subtitleColor = typeof cfg.subtitleColor === "string" ? cfg.subtitleColor : void 0;
+  const accentColor = typeof cfg.accentColor === "string" ? cfg.accentColor : void 0;
+  return {
+    enabled: true,
+    preset,
+    title,
+    subtitle,
+    author,
+    company,
+    version,
+    date,
+    address,
+    email,
+    phone,
+    website,
+    social: socialMap,
+    copyright,
+    footerText,
+    badge,
+    badgeColor,
+    badgeTextColor,
+    logo,
+    logoWidth,
+    bgGradient,
+    backgroundColor,
+    textColor,
+    titleColor,
+    subtitleColor,
+    accentColor
+  };
+}
+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 };
@@ -1418,7 +1822,15 @@ function resolveDocumentConfig(frontmatter = {}, userConfig = {}) {
   const version = mergedMeta.version || void 0;
   const company = mergedMeta.company || void 0;
   const lang = mergedMeta.lang || "en";
-  const tokenContext = { title, subtitle, author, version, date, company };
+  const tokenContext = {
+    ...mergedMeta,
+    title,
+    subtitle,
+    author,
+    version,
+    date,
+    company
+  };
   const theme = mergedMeta.theme || userConfig.theme || DEFAULT_CONFIG.theme;
   const orientation = mergedMeta.orientation || userConfig.orientation || DEFAULT_CONFIG.orientation;
   const paperSize = mergedMeta.paperSize || userConfig.paperSize || DEFAULT_CONFIG.paperSize;
@@ -1447,9 +1859,18 @@ function resolveDocumentConfig(frontmatter = {}, userConfig = {}) {
   const footer = normalizeHeaderFooter(rawFooter, tokenContext);
   const toc = typeof mergedMeta.toc === "boolean" ? mergedMeta.toc : typeof userConfig.toc === "boolean" ? userConfig.toc : DEFAULT_CONFIG.toc;
   const rawWatermark = mergedMeta.watermark !== void 0 ? mergedMeta.watermark : userConfig.watermark !== void 0 ? userConfig.watermark : DEFAULT_CONFIG.watermark;
-  const watermark = normalizeWatermark(rawWatermark);
+  const watermark = normalizeWatermark(rawWatermark, tokenContext);
   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;
@@ -1479,6 +1900,11 @@ function resolveDocumentConfig(frontmatter = {}, userConfig = {}) {
     toc,
     signatures,
     watermark,
+    coverPage,
+    backCover,
+    numberHeadings,
+    security,
+    math,
     css: cssList,
     embedImages,
     bundleHtml,
@@ -1486,11 +1912,50 @@ 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;");
 }
-async function renderInlinesToHtml(spans = [], baseDir = process.cwd()) {
+async function renderInlinesToHtml(spans = [], baseDir = process.cwd(), tokens) {
   let result = "";
   for (const span of spans) {
     if (span.type === "image" && span.url) {
@@ -1504,23 +1969,23 @@ async function renderInlinesToHtml(spans = [], baseDir = process.cwd()) {
       continue;
     }
     if (span.type === "link" && span.url) {
-      const inner = span.children ? await renderInlinesToHtml(span.children, baseDir) : escapeHtml(span.content);
+      const inner = span.children ? await renderInlinesToHtml(span.children, baseDir, tokens) : escapeHtml(tokens ? replaceDocumentTokens(span.content, tokens) : span.content);
       const title = span.title ? ` title="${escapeHtml(span.title)}"` : "";
       result += `<a href="${escapeHtml(span.url)}"${title}>${inner}</a>`;
       continue;
     }
     if (span.type === "bold") {
-      const inner = span.children ? await renderInlinesToHtml(span.children, baseDir) : escapeHtml(span.content);
+      const inner = span.children ? await renderInlinesToHtml(span.children, baseDir, tokens) : escapeHtml(tokens ? replaceDocumentTokens(span.content, tokens) : span.content);
       result += `<strong>${inner}</strong>`;
       continue;
     }
     if (span.type === "italic") {
-      const inner = span.children ? await renderInlinesToHtml(span.children, baseDir) : escapeHtml(span.content);
+      const inner = span.children ? await renderInlinesToHtml(span.children, baseDir, tokens) : escapeHtml(tokens ? replaceDocumentTokens(span.content, tokens) : span.content);
       result += `<em>${inner}</em>`;
       continue;
     }
     if (span.type === "strikethrough") {
-      const inner = span.children ? await renderInlinesToHtml(span.children, baseDir) : escapeHtml(span.content);
+      const inner = span.children ? await renderInlinesToHtml(span.children, baseDir, tokens) : escapeHtml(tokens ? replaceDocumentTokens(span.content, tokens) : span.content);
       result += `<del>${inner}</del>`;
       continue;
     }
@@ -1528,83 +1993,57 @@ async function renderInlinesToHtml(spans = [], baseDir = process.cwd()) {
       result += `<code>${escapeHtml(span.content)}</code>`;
       continue;
     }
+    if (span.type === "mathInline") {
+      result += renderMathToHtml(span.content, false);
+      continue;
+    }
+    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);
+    const content = tokens ? replaceDocumentTokens(span.content, tokens) : span.content;
+    result += escapeHtml(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 = path3.isAbsolute(cssPath) ? cssPath : path3.resolve(baseDir, cssPath);
-    if (fs3.existsSync(fullCssPath)) {
-      customCss += `
-/* Custom CSS: ${cssPath} */
-` + fs3.readFileSync(fullCssPath, "utf-8");
-    }
-  }
-  const inlinedCss = doc.inlinedStyles.join("\n");
+async function renderNodesToHtml(nodes, resolved, baseDir = process.cwd(), tokens) {
   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>
-`;
-    }
-    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>
-`;
-  }
-  for (const node of doc.nodes) {
+  const tokenCtx = tokens || resolved;
+  for (const node of nodes) {
     if (node.type === "heading") {
-      const inner = await renderInlinesToHtml(node.inlines, baseDir);
+      const inner = await renderInlinesToHtml(node.inlines, baseDir, tokenCtx);
       bodyHtml += `  <h${node.level} id="${node.id}">${inner}</h${node.level}>
 `;
       continue;
     }
     if (node.type === "paragraph") {
-      const inner = await renderInlinesToHtml(node.inlines, baseDir);
+      const inner = await renderInlinesToHtml(node.inlines, baseDir, tokenCtx);
       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, tokenCtx);
+        colChildrenHtml += `    <div class="markforge-col">
+${colInner}    </div>
+`;
+      }
+      bodyHtml += `  <div class="markforge-columns" style="--cols: ${cols}; --col-gap: ${gap};">
+${colChildrenHtml}  </div>
 `;
       continue;
     }
@@ -1624,7 +2063,7 @@ ${escapeHtml(node.text || "")}
       continue;
     }
     if (node.type === "callout") {
-      const inner = await renderInlinesToHtml(node.inlines, baseDir);
+      const inner = await renderInlinesToHtml(node.inlines, baseDir, tokenCtx);
       const CALLOUT_STYLES = {
         NOTE: { bg: "#ECFDFD", border: "#33CDCF", titleColor: "#009DA0" },
         TIP: { bg: "#ecfdf5", border: "#10b981", titleColor: "#10b981" },
@@ -1644,7 +2083,7 @@ ${escapeHtml(node.text || "")}
       continue;
     }
     if (node.type === "blockquote") {
-      const inner = await renderInlinesToHtml(node.inlines, baseDir);
+      const inner = await renderInlinesToHtml(node.inlines, baseDir, tokenCtx);
       bodyHtml += `  <blockquote>${inner}</blockquote>
 `;
       continue;
@@ -1658,7 +2097,7 @@ ${escapeHtml(node.text || "")}
         for (const cell of row.children || []) {
           const tag = cell.isHeader ? "th" : "td";
           const align = cell.align ? ` align="${cell.align}"` : "";
-          const inner = await renderInlinesToHtml(cell.inlines, baseDir);
+          const inner = await renderInlinesToHtml(cell.inlines, baseDir, tokenCtx);
           bodyHtml += `      <${tag}${align}>${inner}</${tag}>
 `;
         }
@@ -1674,7 +2113,7 @@ ${escapeHtml(node.text || "")}
       bodyHtml += `  <${tag}>
 `;
       for (const item of node.children) {
-        const inner = await renderInlinesToHtml(item.inlines, baseDir);
+        const inner = await renderInlinesToHtml(item.inlines, baseDir, tokenCtx);
         bodyHtml += `    <li>${inner}</li>
 `;
       }
@@ -1693,70 +2132,508 @@ ${escapeHtml(node.text || "")}
       continue;
     }
   }
-  let watermarkCss = "";
-  let watermarkHtml = "";
-  if (resolved.watermark) {
-    const wm = resolved.watermark;
-    watermarkCss = `
-  .document-watermark {
-    position: fixed;
-    top: 0;
-    left: 0;
-    width: 100vw;
-    height: 100vh;
-    pointer-events: none;
-    z-index: 0;
-    user-select: none;
-    -webkit-user-select: none;
+  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>`;
   }
-  .document-container {
+  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: 1;
+    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 {
-    .document-watermark {
-      position: fixed;
-      top: 0;
-      left: 0;
-      width: 100vw;
+    .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;
     }
   }
   `;
-    watermarkHtml = `  <div id="markforge-watermark" class="document-watermark" aria-hidden="true"></div>
-  <script>
-  (function() {
-    try {
-      var canvas = document.createElement('canvas');
-      var dpr = 3;
-      var width = 800;
-      var height = 1100;
-      canvas.width = Math.round(width * dpr);
-      canvas.height = Math.round(height * dpr);
-      var ctx = canvas.getContext('2d');
-      if (ctx) {
-        ctx.scale(dpr, dpr);
-        ctx.translate(width / 2, height / 2);
-        ctx.rotate((${wm.rotate} * Math.PI) / 180);
-        ctx.textAlign = 'center';
-        ctx.textBaseline = 'middle';
-        ctx.font = '900 ${wm.fontSize * 1.5}px system-ui, -apple-system, sans-serif';
-        ctx.fillStyle = '${wm.color}';
-        ctx.globalAlpha = ${wm.opacity};
-        try { ctx.letterSpacing = '0.15em'; } catch(e) {}
-        ctx.fillText(${JSON.stringify(wm.text.toUpperCase())}, 0, 0);
-        var dataUrl = canvas.toDataURL('image/png');
-        var wmEl = document.getElementById('markforge-watermark');
-        if (wmEl) {
-          wmEl.style.backgroundImage = 'url("' + dataUrl + '")';
-          wmEl.style.backgroundRepeat = 'no-repeat';
-          wmEl.style.backgroundPosition = 'center center';
-          wmEl.style.backgroundSize = 'contain';
-        }
-      }
-    } catch(err) {}
+  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, _b;
+  const resolved = resolveDocumentConfig(doc.metadata, config);
+  const baseThemeCss = generateThemeCss(resolved.theme);
+  let customCss = "";
+  for (const cssPath of resolved.css) {
+    const fullCssPath = path3.isAbsolute(cssPath) ? cssPath : path3.resolve(baseDir, cssPath);
+    if (fs3.existsSync(fullCssPath)) {
+      customCss += `
+/* Custom CSS: ${cssPath} */
+` + fs3.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 (((_b = resolved.numberHeadings) == null ? void 0 : _b.enabled) !== false && resolved.numberHeadings) {
+    applyHeadingNumbering(doc.nodes, doc.tocEntries, resolved.numberHeadings);
+  }
+  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>
+`;
+  }
+  const mergedTokens = {
+    ...config.metadata,
+    ...doc.metadata,
+    ...resolved,
+    title: resolved.title,
+    subtitle: resolved.subtitle,
+    author: resolved.author,
+    version: resolved.version,
+    date: resolved.date,
+    company: resolved.company
+  };
+  const nodesHtml = await renderNodesToHtml(doc.nodes, resolved, baseDir, mergedTokens);
+  bodyHtml += `  <main class="markforge-content-body">
+${nodesHtml}  </main>
+`;
+  let footnotesHtml = "";
+  if (doc.footnoteDefs && doc.footnoteDefs.length > 0) {
+    let fnListHtml = "";
+    for (const def of doc.footnoteDefs) {
+      const defInner = await renderInlinesToHtml(def.inlines, baseDir, mergedTokens);
+      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) {
+    const wm = resolved.watermark;
+    watermarkCss = `
+  .document-watermark {
+    position: fixed;
+    top: 0;
+    left: 0;
+    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;
+    z-index: 1;
+  }
+  @media print {
+    .document-watermark {
+      display: none !important;
+    }
+  }
+  `;
+    watermarkHtml = `  <div id="markforge-watermark" class="document-watermark" aria-hidden="true"></div>
+  <script>
+  (function() {
+    try {
+      var canvas = document.createElement('canvas');
+      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((-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';
+        ctx.fillStyle = '${wm.color}';
+        ctx.globalAlpha = ${wm.opacity};
+        try { ctx.letterSpacing = '0.15em'; } catch(e) {}
+        ctx.fillText(${JSON.stringify(wm.text.toUpperCase())}, 0, 0);
+        var dataUrl = canvas.toDataURL('image/png');
+        var wmEl = document.getElementById('markforge-watermark');
+        if (wmEl) {
+          wmEl.style.backgroundImage = 'url("' + dataUrl + '")';
+          wmEl.style.backgroundRepeat = 'no-repeat';
+          wmEl.style.backgroundPosition = 'center center';
+          wmEl.style.backgroundSize = 'contain';
+        }
+      }
+    } catch(err) {}
   })();
   </script>
 `;
@@ -1766,10 +2643,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};
@@ -1881,6 +2754,10 @@ ${itemCards}
   <style>
 ${THEME_COMPONENTS}
 ${baseThemeCss}
+${KATEX_INLINE_CSS}
+${extraCss}
+${coverCss}
+${backCss}
 ${customCss}
 ${inlinedCss}
 ${watermarkCss}
@@ -1888,14 +2765,95 @@ ${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
+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 = path4.join(os.tmpdir(), `markforge-wm-${Date.now()}-${Math.random().toString(36).slice(2)}.html`);
+  const tmpPng = path4.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>`;
+    fs4.writeFileSync(tmpHtml, html, "utf8");
+    const fileUrl = pathToFileURL2(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 (fs4.existsSync(tmpPng) && fs4.statSync(tmpPng).size > 0) {
+      return fs4.readFileSync(tmpPng);
+    }
+    return null;
+  } catch {
+    return null;
+  } finally {
+    try {
+      if (fs4.existsSync(tmpHtml)) fs4.unlinkSync(tmpHtml);
+      if (fs4.existsSync(tmpPng)) fs4.unlinkSync(tmpPng);
+    } catch {
+    }
+  }
+}
 function findChromeExecutable() {
   if (process.env.CHROME_PATH && fs4.existsSync(process.env.CHROME_PATH)) {
     return process.env.CHROME_PATH;
@@ -1960,7 +2918,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, _i, _j, _k, _l, _m;
   const resolved = resolveDocumentConfig(metadata || {}, config);
   const size = resolved.paperSize;
   const orientation = resolved.orientation;
@@ -2004,6 +2962,66 @@ 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;
+    break-before: page;
+    break-after: avoid;
+  }` : "";
+  const tocPageCss = resolved.toc ? `
+  @page toc-page {
+    size: ${size} ${orientation};
+    margin-top: ${top};
+    margin-bottom: ${bottom};
+    margin-left: ${left};
+    margin-right: ${right};
+    ${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)}
+    @bottom-right {
+      content: counter(page, lower-roman);
+      font-size: 9pt;
+      color: #94a3b8;
+    }
+  }
+  .table-of-contents {
+    page: toc-page;
+    page-break-after: always;
+    break-after: page;
+  }
+  .markforge-content-body {
+    counter-reset: page 1;
+  }` : "";
   const pagedCss = `
   @page {
     size: ${size} ${orientation};
@@ -2011,15 +3029,19 @@ 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", (_h = resolved.header) == null ? void 0 : _h.left)}
+    ${buildZoneCss("top-center", (_i = resolved.header) == null ? void 0 : _i.center)}
+    ${buildZoneCss("top-right", (_j = resolved.header) == null ? void 0 : _j.right)}
+    ${buildZoneCss("bottom-left", (_k = resolved.footer) == null ? void 0 : _k.left)}
+    ${buildZoneCss("bottom-center", (_l = resolved.footer) == null ? void 0 : _l.center)}
+    ${buildZoneCss("bottom-right", (_m = resolved.footer) == null ? void 0 : _m.right, true)}
   }
+  ${coverPageCss}
+  ${tocPageCss}
+  ${backCoverCss}
   @media print {
     body { padding: 0; }
+    .document-watermark { display: none !important; }
     h1, h2, h3, pre, table, blockquote, .callout {
       break-inside: avoid;
     }
@@ -2067,6 +3089,7 @@ 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();
@@ -2076,6 +3099,7 @@ async function buildPdfDocument(doc, config, baseDir = process.cwd()) {
     const tmpHtml = path4.join(tmpDir, `markforge_${tmpId}.html`);
     const tmpPdf = path4.join(tmpDir, `markforge_${tmpId}.pdf`);
     const tmpProfile = path4.join(tmpDir, `markforge_prof_${tmpId}`);
+    const isWin = process.platform === "win32";
     const isolatedFlags = [
       `--user-data-dir=${tmpProfile}`,
       "--no-first-run",
@@ -2086,7 +3110,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",
@@ -2095,12 +3118,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 {
       fs4.writeFileSync(tmpHtml, pagedHtml, "utf-8");
@@ -2115,7 +3136,7 @@ async function buildPdfDocument(doc, config, baseDir = process.cwd()) {
           `--print-to-pdf=${tmpPdf}`,
           fileUrl
         ],
-        { timeout: 3e4 }
+        { timeout: 3e4, windowsHide: true }
       );
       if ((res.status !== 0 || !fs4.existsSync(tmpPdf)) && chromePath) {
         res = spawnSync(
@@ -2126,12 +3147,79 @@ async function buildPdfDocument(doc, config, baseDir = process.cwd()) {
             `--print-to-pdf=${tmpPdf}`,
             fileUrl
           ],
-          { timeout: 3e4 }
+          { timeout: 3e4, windowsHide: true }
         );
       }
       if (fs4.existsSync(tmpPdf) && fs4.statSync(tmpPdf).size > 0) {
         const pdfBuffer = fs4.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 totalPages = pdfDoc.getPageCount();
+              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) ? totalPages - 1 : totalPages;
+              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 {
@@ -2386,6 +3474,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,
@@ -2400,7 +3511,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, _k;
   const resolved = resolveDocumentConfig(doc.metadata, config);
   const docElements = [];
   const themeProps = typeof resolved.theme === "object" ? resolved.theme : {};
@@ -2411,7 +3522,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: [
@@ -2472,6 +3583,9 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
       );
     }
   }
+  if (((_b = resolved.numberHeadings) == null ? void 0 : _b.enabled) !== false && resolved.numberHeadings) {
+    applyHeadingNumbering(doc.nodes, doc.tocEntries, resolved.numberHeadings);
+  }
   if (resolved.toc) {
     const headingNodes = doc.nodes.filter(
       (n) => n.type === "heading" && typeof n.level === "number" && n.level >= 1 && n.level <= 3
@@ -2541,7 +3655,11 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
         ]
       });
       docElements.push(tocCard);
-      docElements.push(new Paragraph({ spacing: { after: 200 } }));
+      docElements.push(
+        new Paragraph({
+          children: [new PageBreak()]
+        })
+      );
     }
   }
   for (const node of doc.nodes) {
@@ -2551,7 +3669,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
           font: defaultFont,
           size: 34,
           // 17pt
-          color: textHex,
+          color: primaryDarkHex,
           bold: true
         });
         docElements.push(
@@ -2597,7 +3715,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
           font: defaultFont,
           size: 22,
           // 11pt
-          color: textHex,
+          color: primaryDarkHex,
           bold: true
         });
         docElements.push(
@@ -2827,7 +3945,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 = ((_d = (_c = node.children[0]) == null ? void 0 : _c.children) == null ? void 0 : _d.length) || 1;
       const colWidth = Math.floor(9e3 / numCols);
       for (let rowIdx = 0; rowIdx < node.children.length; rowIdx++) {
         const rowNode = node.children[rowIdx];
@@ -2837,7 +3955,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 = (_e = node.align) == null ? void 0 : _e[colIdx];
             let alignment = AlignmentType.LEFT;
             if (align === "center") alignment = AlignmentType.CENTER;
             if (align === "right") alignment = AlignmentType.RIGHT;
@@ -2976,16 +4094,123 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
       }
       continue;
     }
-  }
-  if (resolved.signatures && resolved.signatures.items.length > 0) {
-    const sig = resolved.signatures;
-    const numItems = sig.items.length;
-    const contentWidth = Math.max(
-      1e3,
-      resolved.paperDimensions.widthTwip - resolved.margins.leftTwip - resolved.margins.rightTwip
-    );
-    docElements.push(new Paragraph({ spacing: { before: sig.spacingBeforeTwip } }));
-    const sigCells = [];
+    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;
+    const numItems = sig.items.length;
+    const contentWidth = Math.max(
+      1e3,
+      resolved.paperDimensions.widthTwip - resolved.margins.leftTwip - resolved.margins.rightTwip
+    );
+    docElements.push(new Paragraph({ spacing: { before: sig.spacingBeforeTwip } }));
+    const sigCells = [];
     const colWidths = [];
     if (numItems === 1) {
       const cardWidth = Math.min(3400, Math.floor(contentWidth * 0.42));
@@ -3037,7 +4262,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 ((_f = resolved.header) == null ? void 0 : _f.left) {
     headerRuns.push(
       new TextRun({
         text: resolved.header.left.text,
@@ -3050,7 +4275,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
     );
   }
   headerRuns.push(new TextRun({ text: "	" }));
-  if ((_e = resolved.header) == null ? void 0 : _e.center) {
+  if ((_g = resolved.header) == null ? void 0 : _g.center) {
     headerRuns.push(
       new TextRun({
         text: resolved.header.center.text,
@@ -3063,7 +4288,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
     );
   }
   headerRuns.push(new TextRun({ text: "	" }));
-  if ((_f = resolved.header) == null ? void 0 : _f.right) {
+  if ((_h = resolved.header) == null ? void 0 : _h.right) {
     headerRuns.push(
       new TextRun({
         text: resolved.header.right.text,
@@ -3102,7 +4327,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
     ]
   }) : void 0;
   const footerRuns = [];
-  if ((_g = resolved.footer) == null ? void 0 : _g.left) {
+  if ((_i = resolved.footer) == null ? void 0 : _i.left) {
     footerRuns.push(
       new TextRun({
         text: resolved.footer.left.text,
@@ -3115,7 +4340,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
     );
   }
   footerRuns.push(new TextRun({ text: "	" }));
-  if ((_h = resolved.footer) == null ? void 0 : _h.center) {
+  if ((_j = resolved.footer) == null ? void 0 : _j.center) {
     footerRuns.push(
       new TextRun({
         text: resolved.footer.center.text,
@@ -3128,7 +4353,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
     );
   }
   footerRuns.push(new TextRun({ text: "	" }));
-  if ((_i = resolved.footer) == null ? void 0 : _i.right) {
+  if ((_k = resolved.footer) == null ? void 0 : _k.right) {
     const rZone = resolved.footer.right;
     const rColor = rZone.color.replace("#", "");
     const rSize = (rZone.fontSize || 9) * 2;
@@ -3213,6 +4438,95 @@ 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: {
+        pageNumbers: {
+          start: 1,
+          formatType: NumberFormat.DECIMAL
+        },
+        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: {
@@ -3233,33 +4547,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) {
@@ -3487,14 +5018,885 @@ async function compileMarkdown(inputFilePathOrContent, userConfig = {}, onProgre
   };
 }
 
+// src/server/previewServer.ts
+import * as http from "http";
+import * as fs7 from "fs";
+import * as path7 from "path";
+async function startPreviewServer(options) {
+  const absoluteFilePath = path7.resolve(process.cwd(), options.filePath);
+  if (!fs7.existsSync(absoluteFilePath)) {
+    throw new Error(`MarkForge preview error: File not found at "${absoluteFilePath}"`);
+  }
+  const baseDir = path7.dirname(absoluteFilePath);
+  const { config: fileConfig } = await loadConfig(void 0, baseDir);
+  const baseConfig = options.config || fileConfig;
+  const port = options.port || 3e3;
+  const sseClients = /* @__PURE__ */ new Set();
+  const broadcastReload = () => {
+    sseClients.forEach((client) => {
+      try {
+        client.write(`event: reload
+data: ${Date.now()}
+
+`);
+      } catch {
+        sseClients.delete(client);
+      }
+    });
+  };
+  let debounceTimer = null;
+  const watcher = fs7.watch(baseDir, { recursive: false }, (_event, filename) => {
+    if (!filename) return;
+    const changedPath = path7.resolve(baseDir, filename);
+    if (changedPath === absoluteFilePath || filename.includes("markforge") || filename.endsWith(".css")) {
+      if (debounceTimer) clearTimeout(debounceTimer);
+      debounceTimer = setTimeout(() => {
+        broadcastReload();
+      }, 150);
+    }
+  });
+  const server = http.createServer(async (req, res) => {
+    const url = new URL(req.url || "/", `http://localhost:${port}`);
+    if (url.pathname === "/events") {
+      res.writeHead(200, {
+        "Content-Type": "text/event-stream",
+        "Cache-Control": "no-cache, no-transform",
+        Connection: "keep-alive"
+      });
+      res.write(`data: connected
+
+`);
+      sseClients.add(res);
+      req.on("close", () => {
+        sseClients.delete(res);
+      });
+      return;
+    }
+    if (url.pathname === "/api/file-content" && req.method === "GET") {
+      try {
+        const content = fs7.readFileSync(absoluteFilePath, "utf-8");
+        res.writeHead(200, { "Content-Type": "application/json" });
+        res.end(
+          JSON.stringify({
+            content,
+            fileName: path7.basename(absoluteFilePath),
+            filePath: absoluteFilePath
+          })
+        );
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        res.writeHead(500, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ error: msg }));
+      }
+      return;
+    }
+    if (url.pathname === "/api/save-content" && req.method === "POST") {
+      let body = "";
+      req.on("data", (chunk) => {
+        body += chunk;
+      });
+      req.on("end", () => {
+        try {
+          const parsed = JSON.parse(body);
+          if (typeof parsed.content === "string") {
+            fs7.writeFileSync(absoluteFilePath, parsed.content, "utf-8");
+            broadcastReload();
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ success: true, savedAt: Date.now() }));
+          } else {
+            res.writeHead(400, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: "Missing content field in request body" }));
+          }
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : String(err);
+          res.writeHead(500, { "Content-Type": "application/json" });
+          res.end(JSON.stringify({ error: msg }));
+        }
+      });
+      return;
+    }
+    if (url.pathname === "/api/export" && (req.method === "GET" || req.method === "POST")) {
+      const format = url.searchParams.get("format") || "docx";
+      try {
+        const mdContent = fs7.readFileSync(absoluteFilePath, "utf-8");
+        const doc = parseMarkdownDocument(mdContent);
+        const { config: resolvedConfig } = await loadConfig(void 0, baseDir);
+        const mergedConfig = { ...baseConfig, ...resolvedConfig };
+        const fileBase = path7.basename(absoluteFilePath, path7.extname(absoluteFilePath));
+        if (format === "docx") {
+          const buffer = await buildDocxDocument(doc, mergedConfig, baseDir);
+          res.writeHead(200, {
+            "Content-Type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+            "Content-Disposition": `attachment; filename="${fileBase}.docx"`
+          });
+          res.end(buffer);
+          return;
+        } else if (format === "pdf") {
+          const buffer = await buildPdfDocument(doc, mergedConfig, baseDir);
+          res.writeHead(200, {
+            "Content-Type": "application/pdf",
+            "Content-Disposition": `attachment; filename="${fileBase}.pdf"`
+          });
+          res.end(buffer);
+          return;
+        } else {
+          const html = await buildHtmlDocument(doc, mergedConfig, baseDir);
+          res.writeHead(200, {
+            "Content-Type": "text/html; charset=utf-8",
+            "Content-Disposition": `attachment; filename="${fileBase}.html"`
+          });
+          res.end(html);
+          return;
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        res.writeHead(500, { "Content-Type": "text/plain" });
+        res.end(`Export failed: ${msg}`);
+        return;
+      }
+    }
+    if (url.pathname === "/document-content") {
+      try {
+        const mdContent = fs7.readFileSync(absoluteFilePath, "utf-8");
+        const doc = parseMarkdownDocument(mdContent);
+        const { config: resolvedConfig } = await loadConfig(void 0, baseDir);
+        const html = await buildHtmlDocument(doc, { ...baseConfig, ...resolvedConfig }, baseDir);
+        const injectedScript = `
+        <script>
+        (function() {
+          var evtSource = new EventSource('/events');
+          evtSource.addEventListener('reload', function() {
+            var scrollPos = window.scrollY;
+            sessionStorage.setItem('markforge_scroll', scrollPos);
+            window.location.reload();
+          });
+          window.addEventListener('load', function() {
+            var saved = sessionStorage.getItem('markforge_scroll');
+            if (saved) {
+              window.scrollTo(0, parseInt(saved, 10));
+            }
+          });
+        })();
+        </script>
+        `;
+        const finalHtml = html.replace("</body>", `${injectedScript}</body>`);
+        res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+        res.end(finalHtml);
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        res.writeHead(500, { "Content-Type": "text/html; charset=utf-8" });
+        res.end(`<div style="padding:2rem;font-family:sans-serif;color:#ef4444;background:#fef2f2;border:1px solid #f87171;border-radius:8px;"><h3>MarkForge Compilation Error</h3><pre>${escapeHtml2(msg)}</pre></div>`);
+      }
+      return;
+    }
+    if (url.pathname === "/" || url.pathname === "/index.html") {
+      const fileName = path7.basename(absoluteFilePath);
+      const initialContent = fs7.readFileSync(absoluteFilePath, "utf-8");
+      const appHtml = `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>MarkForge Live Studio - ${escapeHtml2(fileName)}</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
+  <style>
+    :root {
+      --mf-primary: #0D998D;
+      --mf-primary-dark: #008277;
+      --mf-primary-light: #ECFDFD;
+      --mf-primary-border: #33CDCF;
+      --mf-dark: #0F172A;
+      --mf-slate: #1E293B;
+      --mf-editor-bg: #0F172A;
+      --mf-editor-gutter: #1E293B;
+      --mf-editor-text: #F8FAFC;
+      --mf-muted: #64748B;
+      --mf-light-border: #E2E8F0;
+      --mf-bg: #F1F5F9;
+    }
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body {
+      font-family: 'Plus Jakarta Sans', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      background: var(--mf-bg);
+      color: var(--mf-dark);
+      display: flex;
+      flex-direction: column;
+      height: 100vh;
+      overflow: hidden;
+    }
+    header {
+      background: #FFFFFF;
+      border-bottom: 1px solid var(--mf-light-border);
+      min-height: 56px;
+      display: flex;
+      flex-wrap: wrap;
+      align-items: center;
+      justify-content: space-between;
+      padding: 0.4rem 1.2rem;
+      z-index: 10;
+      box-shadow: 0 1px 3px rgba(15, 23, 42, 0.04);
+      gap: 0.75rem;
+    }
+    .brand-section {
+      display: flex;
+      align-items: center;
+      gap: 0.75rem;
+    }
+    .brand-badge {
+      font-size: 0.72rem;
+      font-weight: 800;
+      letter-spacing: 0.08em;
+      background: var(--mf-dark);
+      color: #FFFFFF;
+      padding: 0.25rem 0.55rem;
+      border-radius: 4px;
+      text-transform: uppercase;
+    }
+    .file-name {
+      font-size: 0.9rem;
+      font-weight: 700;
+      color: var(--mf-dark);
+    }
+    .sync-status {
+      display: flex;
+      align-items: center;
+      gap: 0.35rem;
+      font-size: 0.75rem;
+      font-weight: 600;
+      color: var(--mf-primary-dark);
+      background: var(--mf-primary-light);
+      padding: 0.2rem 0.55rem;
+      border-radius: 9999px;
+      border: 1px solid var(--mf-primary-border);
+    }
+    .sync-dot {
+      width: 7px;
+      height: 7px;
+      background-color: var(--mf-primary);
+      border-radius: 50%;
+      box-shadow: 0 0 0 2px rgba(13, 153, 141, 0.2);
+    }
+    .toolbar-section {
+      display: flex;
+      align-items: center;
+      gap: 0.3rem;
+      background: #F8FAFC;
+      padding: 0.25rem 0.4rem;
+      border-radius: 6px;
+      border: 1px solid var(--mf-light-border);
+    }
+    .tool-btn {
+      font-family: 'JetBrains Mono', monospace;
+      font-size: 0.75rem;
+      font-weight: 600;
+      padding: 0.25rem 0.45rem;
+      background: transparent;
+      border: 1px solid transparent;
+      border-radius: 4px;
+      cursor: pointer;
+      color: var(--mf-slate);
+      transition: all 0.1s ease;
+    }
+    .tool-btn:hover {
+      background: #FFFFFF;
+      border-color: var(--mf-light-border);
+      color: var(--mf-primary-dark);
+    }
+    .tool-divider {
+      width: 1px;
+      height: 16px;
+      background: var(--mf-light-border);
+      margin: 0 0.15rem;
+    }
+    .controls {
+      display: flex;
+      align-items: center;
+      gap: 0.5rem;
+    }
+    .view-toggles {
+      display: flex;
+      background: #F1F5F9;
+      padding: 2px;
+      border-radius: 6px;
+      border: 1px solid var(--mf-light-border);
+    }
+    .toggle-btn {
+      font-family: inherit;
+      font-size: 0.74rem;
+      font-weight: 600;
+      padding: 0.25rem 0.55rem;
+      border: none;
+      background: transparent;
+      border-radius: 4px;
+      cursor: pointer;
+      color: var(--mf-muted);
+      transition: all 0.15s ease;
+    }
+    .toggle-btn.active {
+      background: #FFFFFF;
+      color: var(--mf-dark);
+      box-shadow: 0 1px 2px rgba(15, 23, 42, 0.08);
+    }
+    .btn {
+      font-family: inherit;
+      font-size: 0.78rem;
+      font-weight: 600;
+      padding: 0.35rem 0.75rem;
+      border-radius: 6px;
+      cursor: pointer;
+      text-decoration: none;
+      transition: all 0.15s ease;
+      display: inline-flex;
+      align-items: center;
+      gap: 0.3rem;
+      border: 1px solid var(--mf-light-border);
+      background: #FFFFFF;
+      color: var(--mf-dark);
+    }
+    .btn:hover {
+      background: #F8FAFC;
+      border-color: #CBD5E1;
+    }
+    .btn-primary {
+      background: var(--mf-primary);
+      color: #FFFFFF;
+      border-color: var(--mf-primary);
+    }
+    .btn-primary:hover {
+      background: var(--mf-primary-dark);
+      border-color: var(--mf-primary-dark);
+    }
+    .save-indicator {
+      font-size: 0.75rem;
+      font-weight: 600;
+      color: var(--mf-muted);
+      min-width: 65px;
+      text-align: right;
+    }
+    .save-indicator.saved {
+      color: var(--mf-primary-dark);
+    }
+    .save-indicator.saving {
+      color: #D97706;
+    }
+    .save-indicator.unsaved {
+      color: #E11D48;
+    }
+
+    /* Main Workspace Splitter Layout */
+    main.workspace {
+      flex: 1;
+      display: flex;
+      height: calc(100vh - 56px);
+      overflow: hidden;
+      background: var(--mf-bg);
+      position: relative;
+    }
+    .editor-pane {
+      width: 50%;
+      height: 100%;
+      display: flex;
+      flex-direction: column;
+      background: var(--mf-editor-bg);
+      border-right: 1px solid #334155;
+      overflow: hidden;
+    }
+    .editor-header {
+      background: #090D16;
+      border-bottom: 1px solid #1E293B;
+      padding: 0.4rem 0.8rem;
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      color: #94A3B8;
+      font-size: 0.74rem;
+      font-weight: 500;
+    }
+    .editor-container {
+      flex: 1;
+      display: flex;
+      position: relative;
+      overflow: hidden;
+      background: var(--mf-editor-bg);
+    }
+    .line-numbers {
+      width: 44px;
+      padding: 0.8rem 0.4rem;
+      font-family: 'JetBrains Mono', monospace;
+      font-size: 13px;
+      line-height: 1.55;
+      color: #475569;
+      text-align: right;
+      user-select: none;
+      background: var(--mf-editor-gutter);
+      overflow: hidden;
+      border-right: 1px solid #1E293B;
+    }
+    .code-editor {
+      flex: 1;
+      padding: 0.8rem 1rem;
+      font-family: 'JetBrains Mono', monospace;
+      font-size: 13px;
+      line-height: 1.55;
+      color: var(--mf-editor-text);
+      background: transparent;
+      border: none;
+      outline: none;
+      resize: none;
+      white-space: pre;
+      overflow-wrap: normal;
+      overflow: auto;
+      tab-size: 2;
+    }
+
+    /* Draggable Splitter Handle */
+    .splitter {
+      width: 8px;
+      cursor: col-resize;
+      background: #E2E8F0;
+      transition: background 0.15s ease;
+      position: relative;
+      z-index: 5;
+    }
+    .splitter:hover, .splitter.active {
+      background: var(--mf-primary);
+    }
+
+    /* Right Preview Pane */
+    .preview-pane {
+      width: 50%;
+      height: 100%;
+      display: flex;
+      flex-direction: column;
+      background: #FFFFFF;
+      overflow: hidden;
+    }
+    .preview-header {
+      background: #FFFFFF;
+      border-bottom: 1px solid var(--mf-light-border);
+      padding: 0.35rem 0.8rem;
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      color: var(--mf-muted);
+      font-size: 0.74rem;
+      font-weight: 600;
+    }
+    .viewport-selector {
+      display: flex;
+      gap: 0.25rem;
+    }
+    .vp-btn {
+      font-size: 0.72rem;
+      padding: 0.15rem 0.4rem;
+      border: 1px solid var(--mf-light-border);
+      background: #F8FAFC;
+      border-radius: 4px;
+      cursor: pointer;
+      color: var(--mf-muted);
+    }
+    .vp-btn.active {
+      background: var(--mf-primary-light);
+      color: var(--mf-primary-dark);
+      border-color: var(--mf-primary-border);
+    }
+    .preview-wrapper {
+      flex: 1;
+      display: flex;
+      justify-content: center;
+      align-items: stretch;
+      background: #F1F5F9;
+      overflow: hidden;
+    }
+    iframe {
+      width: 100%;
+      height: 100%;
+      border: none;
+      background: #FFFFFF;
+      transition: max-width 0.2s ease;
+    }
+    .author-footer {
+      font-size: 0.72rem;
+      color: var(--mf-muted);
+      padding-right: 0.5rem;
+    }
+    .author-footer a {
+      color: var(--mf-primary-dark);
+      text-decoration: none;
+      font-weight: 600;
+    }
+  </style>
+</head>
+<body>
+  <header>
+    <div class="brand-section">
+      <span class="brand-badge">MARKFORGE STUDIO</span>
+      <span class="file-name" title="${escapeHtml2(absoluteFilePath)}">${escapeHtml2(fileName)}</span>
+      <div class="sync-status">
+        <div class="sync-dot"></div>
+        <span>Live Sync Active</span>
+      </div>
+    </div>
+
+    <!-- Quick Formatting Toolbar -->
+    <div class="toolbar-section">
+      <button class="tool-btn" onclick="insertFormat('h1')" title="Heading 1">H1</button>
+      <button class="tool-btn" onclick="insertFormat('h2')" title="Heading 2">H2</button>
+      <button class="tool-btn" onclick="insertFormat('h3')" title="Heading 3">H3</button>
+      <div class="tool-divider"></div>
+      <button class="tool-btn" onclick="insertFormat('bold')" title="Bold">B</button>
+      <button class="tool-btn" onclick="insertFormat('italic')" title="Italic">I</button>
+      <button class="tool-btn" onclick="insertFormat('code')" title="Inline Code">&lt;&gt;</button>
+      <button class="tool-btn" onclick="insertFormat('quote')" title="Blockquote">&gt;</button>
+      <div class="tool-divider"></div>
+      <button class="tool-btn" onclick="insertFormat('table')" title="GFM Table">Table</button>
+      <button class="tool-btn" onclick="insertFormat('list')" title="List">List</button>
+      <button class="tool-btn" onclick="insertFormat('task')" title="Task Checklist">Task</button>
+      <div class="tool-divider"></div>
+      <button class="tool-btn" onclick="insertFormat('callout')" title="Callout Box">Callout</button>
+      <button class="tool-btn" onclick="insertFormat('math')" title="LaTeX Math">Math</button>
+      <button class="tool-btn" onclick="insertFormat('columns')" title="Multi-Columns">Columns</button>
+      <button class="tool-btn" onclick="insertFormat('footnote')" title="Footnote">Footnote</button>
+      <button class="tool-btn" onclick="insertFormat('mermaid')" title="Mermaid Diagram">Mermaid</button>
+    </div>
+
+    <!-- Controls & View Mode -->
+    <div class="controls">
+      <div class="view-toggles">
+        <button class="toggle-btn active" id="btn-split" onclick="setViewMode('split')">Split</button>
+        <button class="toggle-btn" id="btn-edit" onclick="setViewMode('edit')">Editor</button>
+        <button class="toggle-btn" id="btn-prev" onclick="setViewMode('prev')">Preview</button>
+      </div>
+      <span class="save-indicator saved" id="save-status">Saved</span>
+      <button class="btn btn-primary" onclick="saveContentManual()" title="Save (Ctrl+S)">Save</button>
+      <button class="btn" onclick="exportDoc('docx')" title="Download Word Document">DOCX</button>
+      <button class="btn" onclick="exportDoc('pdf')" title="Download PDF Document">PDF</button>
+      <button class="btn" onclick="printDoc()" title="Print / PDF dialog">Print</button>
+    </div>
+  </header>
+
+  <main class="workspace" id="workspace">
+    <!-- Left: Code Editor Pane -->
+    <div class="editor-pane" id="editor-pane">
+      <div class="editor-header">
+        <span>MARKDOWN SOURCE</span>
+        <span id="editor-stats">Lines: 1 | Words: 0 | UTF-8</span>
+      </div>
+      <div class="editor-container">
+        <div class="line-numbers" id="line-numbers">1</div>
+        <textarea class="code-editor" id="code-editor" spellcheck="false" placeholder="Write markdown here...">${escapeHtml2(initialContent)}</textarea>
+      </div>
+    </div>
+
+    <!-- Middle: Draggable Splitter Handle -->
+    <div class="splitter" id="splitter"></div>
+
+    <!-- Right: Rendered Preview Pane -->
+    <div class="preview-pane" id="preview-pane">
+      <div class="preview-header">
+        <span>RENDERED PREVIEW</span>
+        <div class="viewport-selector">
+          <button class="vp-btn active" onclick="setViewport('100%')" id="vp-full">100% Full</button>
+          <button class="vp-btn" onclick="setViewport('820px')" id="vp-a4">A4 (820px)</button>
+          <button class="vp-btn" onclick="setViewport('440px')" id="vp-mob">Mobile</button>
+        </div>
+        <span class="author-footer">Created by <a href="https://github.com/masumrpg" target="_blank">Ma'sum (@masumrpg)</a></span>
+      </div>
+      <div class="preview-wrapper">
+        <iframe id="preview-frame" src="/document-content"></iframe>
+      </div>
+    </div>
+  </main>
+
+  <script>
+    var editor = document.getElementById('code-editor');
+    var lineNumbers = document.getElementById('line-numbers');
+    var stats = document.getElementById('editor-stats');
+    var saveStatus = document.getElementById('save-status');
+    var previewFrame = document.getElementById('preview-frame');
+    var editorPane = document.getElementById('editor-pane');
+    var previewPane = document.getElementById('preview-pane');
+    var splitter = document.getElementById('splitter');
+    var isDirty = false;
+    var autoSaveTimeout = null;
+
+    // Update Line Numbers & Stats
+    function updateStatsAndLines() {
+      var lines = editor.value.split('\\n');
+      var lineCount = lines.length;
+      var numHtml = '';
+      for (var i = 1; i <= lineCount; i++) {
+        numHtml += i + '<br>';
+      }
+      lineNumbers.innerHTML = numHtml;
+
+      var words = editor.value.trim().length > 0 ? editor.value.trim().split(/\\s+/).length : 0;
+      var chars = editor.value.length;
+      stats.textContent = 'Lines: ' + lineCount + ' | Words: ' + words + ' | Chars: ' + chars + ' | UTF-8';
+    }
+
+    // Synchronize vertical scroll between Line Numbers and Textarea
+    editor.addEventListener('scroll', function() {
+      lineNumbers.scrollTop = editor.scrollTop;
+    });
+
+    // Handle Input & Debounced Auto-Save
+    editor.addEventListener('input', function() {
+      updateStatsAndLines();
+      setSaveState('unsaved');
+      if (autoSaveTimeout) clearTimeout(autoSaveTimeout);
+      autoSaveTimeout = setTimeout(function() {
+        saveContent();
+      }, 600);
+    });
+
+    function setSaveState(state) {
+      if (state === 'saved') {
+        saveStatus.textContent = 'Saved';
+        saveStatus.className = 'save-indicator saved';
+        isDirty = false;
+      } else if (state === 'saving') {
+        saveStatus.textContent = 'Saving...';
+        saveStatus.className = 'save-indicator saving';
+      } else {
+        saveStatus.textContent = 'Changes...';
+        saveStatus.className = 'save-indicator unsaved';
+        isDirty = true;
+      }
+    }
+
+    // Save Content via API
+    function saveContent(callback) {
+      setSaveState('saving');
+      fetch('/api/save-content', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ content: editor.value }),
+      })
+      .then(function(res) { return res.json(); })
+      .then(function(data) {
+        if (data.success) {
+          setSaveState('saved');
+          if (callback) callback();
+        } else {
+          saveStatus.textContent = 'Save Error';
+        }
+      })
+      .catch(function() {
+        saveStatus.textContent = 'Save Error';
+      });
+    }
+
+    function saveContentManual() {
+      saveContent();
+    }
+
+    // Keyboard Shortcuts: Tab (2 spaces), Shift+Tab, Ctrl+S
+    editor.addEventListener('keydown', function(e) {
+      if ((e.ctrlKey || e.metaKey) && e.key === 's') {
+        e.preventDefault();
+        saveContent();
+        return;
+      }
+
+      if (e.key === 'Tab') {
+        e.preventDefault();
+        var start = this.selectionStart;
+        var end = this.selectionEnd;
+        this.value = this.value.substring(0, start) + '  ' + this.value.substring(end);
+        this.selectionStart = this.selectionEnd = start + 2;
+        updateStatsAndLines();
+        setSaveState('unsaved');
+        if (autoSaveTimeout) clearTimeout(autoSaveTimeout);
+        autoSaveTimeout = setTimeout(saveContent, 600);
+      }
+    });
+
+    // Formatting Snippet Injector
+    function insertFormat(type) {
+      var start = editor.selectionStart;
+      var end = editor.selectionEnd;
+      var selected = editor.value.substring(start, end);
+      var replacement = '';
+
+      switch (type) {
+        case 'h1': replacement = '# ' + (selected || 'Heading 1'); break;
+        case 'h2': replacement = '## ' + (selected || 'Heading 2'); break;
+        case 'h3': replacement = '### ' + (selected || 'Heading 3'); break;
+        case 'bold': replacement = '**' + (selected || 'bold text') + '**'; break;
+        case 'italic': replacement = '*' + (selected || 'italic text') + '*'; break;
+        case 'code': replacement = '\`' + (selected || 'inline code') + '\`'; break;
+        case 'quote': replacement = '> ' + (selected || 'Quote text'); break;
+        case 'table':
+          replacement = '\\n| Column 1 | Column 2 | Column 3 |\\n| :--- | :---: | ---: |\\n| Data A | Data B | Data C |\\n| Data D | Data E | Data F |\\n';
+          break;
+        case 'list': replacement = '- ' + (selected || 'List item'); break;
+        case 'task': replacement = '- [ ] ' + (selected || 'Task item'); break;
+        case 'callout':
+          replacement = '> [!NOTE]\\n> ' + (selected || 'This is an important callout note.');
+          break;
+        case 'math':
+          replacement = '$$\\n' + (selected || '\\\\int_{-\\\\infty}^{\\\\infty} e^{-x^2} dx = \\\\sqrt{\\\\pi}') + '\\n$$';
+          break;
+        case 'columns':
+          replacement = ':::columns 2\\n:::col\\n### Left Column\\n' + (selected || 'Content on the left.') + '\\n:::\\n:::col\\n### Right Column\\nContent on the right.\\n:::\\n:::';
+          break;
+        case 'footnote':
+          replacement = (selected || 'Statement with footnote') + '[^1]\\n\\n[^1]: Note description text.';
+          break;
+        case 'mermaid':
+          replacement = '\\n\`\`\`mermaid\\ngraph TD\\n    A[Start] --> B(Process)\\n    B --> C{Decision}\\n    C -->|Yes| D[Done]\\n    C -->|No| B\\n\`\`\`\\n';
+          break;
+      }
+
+      editor.value = editor.value.substring(0, start) + replacement + editor.value.substring(end);
+      editor.selectionStart = editor.selectionEnd = start + replacement.length;
+      editor.focus();
+      updateStatsAndLines();
+      setSaveState('unsaved');
+      if (autoSaveTimeout) clearTimeout(autoSaveTimeout);
+      autoSaveTimeout = setTimeout(saveContent, 600);
+    }
+
+    // View Mode Toggle (Split / Editor Only / Preview Only)
+    function setViewMode(mode) {
+      document.getElementById('btn-split').classList.remove('active');
+      document.getElementById('btn-edit').classList.remove('active');
+      document.getElementById('btn-prev').classList.remove('active');
+
+      if (mode === 'split') {
+        document.getElementById('btn-split').classList.add('active');
+        editorPane.style.display = 'flex';
+        editorPane.style.width = '50%';
+        previewPane.style.display = 'flex';
+        previewPane.style.width = '50%';
+        splitter.style.display = 'block';
+      } else if (mode === 'edit') {
+        document.getElementById('btn-edit').classList.add('active');
+        editorPane.style.display = 'flex';
+        editorPane.style.width = '100%';
+        previewPane.style.display = 'none';
+        splitter.style.display = 'none';
+      } else if (mode === 'prev') {
+        document.getElementById('btn-prev').classList.add('active');
+        editorPane.style.display = 'none';
+        previewPane.style.display = 'flex';
+        previewPane.style.width = '100%';
+        splitter.style.display = 'none';
+      }
+    }
+
+    // Viewport Width Resizer
+    function setViewport(width) {
+      document.getElementById('vp-full').classList.remove('active');
+      document.getElementById('vp-a4').classList.remove('active');
+      document.getElementById('vp-mob').classList.remove('active');
+
+      if (width === '100%') {
+        document.getElementById('vp-full').classList.add('active');
+        previewFrame.style.maxWidth = '100%';
+      } else if (width === '820px') {
+        document.getElementById('vp-a4').classList.add('active');
+        previewFrame.style.maxWidth = '820px';
+      } else if (width === '440px') {
+        document.getElementById('vp-mob').classList.add('active');
+        previewFrame.style.maxWidth = '440px';
+      }
+    }
+
+    // Draggable Splitter Handle Logic
+    var isDragging = false;
+    splitter.addEventListener('mousedown', function(e) {
+      isDragging = true;
+      splitter.classList.add('active');
+      document.body.style.cursor = 'col-resize';
+      document.body.style.userSelect = 'none';
+    });
+
+    window.addEventListener('mousemove', function(e) {
+      if (!isDragging) return;
+      var totalWidth = document.getElementById('workspace').clientWidth;
+      var newEditorWidth = (e.clientX / totalWidth) * 100;
+      if (newEditorWidth > 15 && newEditorWidth < 85) {
+        editorPane.style.width = newEditorWidth + '%';
+        previewPane.style.width = (100 - newEditorWidth) + '%';
+      }
+    });
+
+    window.addEventListener('mouseup', function() {
+      if (isDragging) {
+        isDragging = false;
+        splitter.classList.remove('active');
+        document.body.style.cursor = '';
+        document.body.style.userSelect = '';
+      }
+    });
+
+    // Document Print Action
+    function printDoc() {
+      previewFrame.contentWindow.print();
+    }
+
+    // Document Export Action
+    function exportDoc(format) {
+      saveContent(function() {
+        window.location.href = '/api/export?format=' + format;
+      });
+    }
+
+    // Initialize line stats
+    updateStatsAndLines();
+  </script>
+</body>
+</html>`;
+      res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+      res.end(appHtml);
+      return;
+    }
+    res.writeHead(404, { "Content-Type": "text/plain" });
+    res.end("Not Found");
+  });
+  return new Promise((resolve6, reject) => {
+    server.listen(port, () => {
+      const url = `http://localhost:${port}`;
+      resolve6({
+        server,
+        port,
+        url,
+        close: async () => {
+          watcher.close();
+          sseClients.forEach((client) => {
+            try {
+              client.end();
+            } catch {
+            }
+          });
+          sseClients.clear();
+          return new Promise((res) => {
+            server.close(() => res());
+          });
+        }
+      });
+    });
+    server.on("error", (err) => {
+      reject(err);
+    });
+  });
+}
+function escapeHtml2(str) {
+  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
+}
+
 // src/config/defineConfig.ts
 function defineConfig(config) {
   return config;
 }
 
 // src/version.ts
-import * as fs7 from "fs";
-import * as path7 from "path";
+import * as fs8 from "fs";
+import * as path8 from "path";
 import { fileURLToPath } from "url";
 try {
   if (typeof globalThis !== "undefined" && (!globalThis.localStorage || typeof globalThis.localStorage.getItem !== "function")) {
@@ -3516,32 +5918,33 @@ try {
   }
 } catch {
 }
-var FALLBACK_VERSION = "0.3.0";
 function readVersionFromPackageJson(fromDir) {
   let currentDir = fromDir;
-  for (let i = 0; i < 6; i++) {
+  for (let i = 0; i < 10; i++) {
     try {
-      const pkgJsonPath = path7.join(currentDir, "package.json");
-      if (fs7.existsSync(pkgJsonPath)) {
-        const pkg = JSON.parse(fs7.readFileSync(pkgJsonPath, "utf-8"));
+      const pkgJsonPath = path8.join(currentDir, "package.json");
+      if (fs8.existsSync(pkgJsonPath)) {
+        const pkg = JSON.parse(fs8.readFileSync(pkgJsonPath, "utf-8"));
         if (pkg.name === "@masumdev/markforge" && pkg.version) {
           return pkg.version;
         }
       }
     } catch {
     }
-    const parentDir = path7.dirname(currentDir);
+    const parentDir = path8.dirname(currentDir);
     if (parentDir === currentDir) break;
     currentDir = parentDir;
   }
-  return FALLBACK_VERSION;
+  throw new Error(
+    "Failed to resolve '@masumdev/markforge' package version: package.json was not found or is missing a valid 'version' field."
+  );
 }
 function getPackageDir() {
   if (typeof __dirname !== "undefined") {
     return __dirname;
   }
   try {
-    return path7.dirname(fileURLToPath(import.meta.url));
+    return path8.dirname(fileURLToPath(import.meta.url));
   } catch {
     return process.cwd();
   }
@@ -3552,6 +5955,7 @@ function getMarkforgeVersion(fromDir = getPackageDir()) {
 }
 export {
   DEFAULT_CONFIG,
+  KATEX_INLINE_CSS,
   MARKFORGE_VERSION,
   Orientation,
   OutputFormat,
@@ -3564,6 +5968,7 @@ export {
   THEME_DEFAULT,
   Theme,
   WatermarkPosition,
+  applyHeadingNumbering,
   buildDocxDocument,
   buildHtmlDocument,
   buildPdfDocument,
@@ -3580,18 +5985,28 @@ export {
   inlineHtmlImages,
   loadConfig,
   compileMarkdown as markforge,
+  normalizeBackCover,
+  normalizeCoverPage,
   normalizeHeaderFooter,
   normalizeHeaderFooterSlot,
+  normalizeNumberHeadings,
+  normalizeSecurity,
   normalizeSignatures,
   normalizeWatermark,
   parseInlineSpans,
   parseMarginToTwip2 as parseMarginToTwip,
+  parseMarkdownDocument as parseMarkdown,
   parseMarkdownDocument,
+  renderBackCoverHtml,
+  renderCoverPageHtml,
   renderInlinesToHtml,
+  renderMathToHtml,
   renderMermaidToPng,
+  renderNodesToHtml,
   replaceDocumentTokens,
   resolveDocumentConfig,
   resolveImage,
   slugify,
+  startPreviewServer,
   tokenizeCodeLine
 };