@masumdev/markforge 0.4.1 → 0.5.0

package/dist/{chunk-R6DT335C.mjs → chunk-H3ZUUSHP.mjs}

@@ -568,6 +568,7 @@ import * as path2 from "path";
 // src/core/imageResolver.ts
 import * as fs from "fs";
 import * as path from "path";
+import { fileURLToPath } from "url";
 var memoryImageCache = /* @__PURE__ */ new Map();
 function getMimeType(filePathOrUrl) {
   const clean = filePathOrUrl.split("?")[0].toLowerCase();
@@ -624,9 +625,19 @@ async function resolveImage(src, baseDir = process.cwd()) {
       memoryImageCache.set(cacheKey, resolved2);
       return resolved2;
     }
-    let localPath = path.isAbsolute(src) ? src : path.resolve(baseDir, src);
+    let localPath = src;
+    if (src.startsWith("file://")) {
+      try {
+        localPath = fileURLToPath(src);
+      } catch {
+        localPath = src;
+      }
+    }
+    if (!path.isAbsolute(localPath)) {
+      localPath = path.resolve(baseDir, localPath);
+    }
     if (!fs.existsSync(localPath)) {
-      const cwdPath = path.resolve(process.cwd(), src);
+      const cwdPath = path.resolve(process.cwd(), src.startsWith("file://") ? localPath : src);
       if (fs.existsSync(cwdPath)) {
         localPath = cwdPath;
       } else {
@@ -2164,7 +2175,7 @@ async function renderBackCoverHtml(backCover, baseDir = process.cwd()) {
 `;
   return { html, css };
 }
-async function buildHtmlDocument(doc, config, baseDir = process.cwd()) {
+async function buildHtmlDocument(doc, config = {}, baseDir = process.cwd()) {
   var _a, _b;
   const resolved = resolveDocumentConfig(doc.metadata, config);
   const baseThemeCss = generateThemeCss(resolved.theme);
@@ -2522,8 +2533,11 @@ function escapeXml(str) {
   return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
 }
 function generateWatermarkPngBuffer(chromePath, wm) {
-  const tmpHtml = path3.join(os.tmpdir(), `markforge-wm-${Date.now()}-${Math.random().toString(36).slice(2)}.html`);
-  const tmpPng = path3.join(os.tmpdir(), `markforge-wm-${Date.now()}-${Math.random().toString(36).slice(2)}.png`);
+  const tmpId = Math.random().toString(36).substring(2, 9);
+  const tmpDir = os.tmpdir();
+  const tmpHtml = path3.join(tmpDir, `markforge-wm-${tmpId}.html`);
+  const tmpPng = path3.join(tmpDir, `markforge-wm-${tmpId}.png`);
+  const tmpProfile = path3.join(tmpDir, `markforge-wm-prof-${tmpId}`);
   try {
     const text = escapeXml(wm.text.toUpperCase());
     const fontSize = (wm.fontSize || 52) * 1.5;
@@ -2574,6 +2588,9 @@ function generateWatermarkPngBuffer(chromePath, wm) {
       chromePath,
       [
         "--headless=new",
+        `--user-data-dir=${tmpProfile}`,
+        "--no-first-run",
+        "--no-default-browser-check",
         "--disable-gpu",
         "--disable-sync",
         "--disable-extensions",
@@ -2595,6 +2612,7 @@ function generateWatermarkPngBuffer(chromePath, wm) {
     try {
       if (fs3.existsSync(tmpHtml)) fs3.unlinkSync(tmpHtml);
       if (fs3.existsSync(tmpPng)) fs3.unlinkSync(tmpPng);
+      if (fs3.existsSync(tmpProfile)) fs3.rmSync(tmpProfile, { recursive: true, force: true });
     } catch {
     }
   }
@@ -2610,6 +2628,8 @@ function findChromeExecutable() {
   const winLocalAppData = process.env.LOCALAPPDATA ?? "";
   const winProgramFiles = process.env.PROGRAMFILES ?? "C:\\Program Files";
   const winProgramFilesX86 = process.env["PROGRAMFILES(X86)"] ?? "C:\\Program Files (x86)";
+  const winProgramW6432 = process.env.ProgramW6432 ?? "C:\\Program Files";
+  const winUserProfile = process.env.USERPROFILE ?? "";
   const candidates = [
     // Linux
     "/usr/bin/google-chrome",
@@ -2628,17 +2648,34 @@ function findChromeExecutable() {
     // Windows — Microsoft Edge (Native Windows 10/11 browser, enterprise whitelist friendly)
     `${winProgramFiles}\\Microsoft\\Edge\\Application\\msedge.exe`,
     `${winProgramFilesX86}\\Microsoft\\Edge\\Application\\msedge.exe`,
+    `${winProgramW6432}\\Microsoft\\Edge\\Application\\msedge.exe`,
     `${winLocalAppData}\\Microsoft\\Edge\\Application\\msedge.exe`,
-    // Windows — Google Chrome
+    `${winLocalAppData}\\Microsoft\\Edge Dev\\Application\\msedge.exe`,
+    `${winLocalAppData}\\Microsoft\\Edge Beta\\Application\\msedge.exe`,
+    // Windows — Google Chrome & Chrome SxS (Canary)
     `${winProgramFiles}\\Google\\Chrome\\Application\\chrome.exe`,
     `${winProgramFilesX86}\\Google\\Chrome\\Application\\chrome.exe`,
+    `${winProgramW6432}\\Google\\Chrome\\Application\\chrome.exe`,
     `${winLocalAppData}\\Google\\Chrome\\Application\\chrome.exe`,
+    `${winLocalAppData}\\Google\\Chrome SxS\\Application\\chrome.exe`,
     // Windows — Brave Browser
     `${winProgramFiles}\\BraveSoftware\\Brave-Browser\\Application\\brave.exe`,
     `${winProgramFilesX86}\\BraveSoftware\\Brave-Browser\\Application\\brave.exe`,
+    `${winProgramW6432}\\BraveSoftware\\Brave-Browser\\Application\\brave.exe`,
     `${winLocalAppData}\\BraveSoftware\\Brave-Browser\\Application\\brave.exe`,
     // Windows — Chromium
-    `${winLocalAppData}\\Chromium\\Application\\chrome.exe`
+    `${winLocalAppData}\\Chromium\\Application\\chrome.exe`,
+    // Windows — Scoop Package Manager
+    `${winUserProfile}\\scoop\\apps\\googlechrome\\current\\chrome.exe`,
+    `${winUserProfile}\\scoop\\apps\\chromium\\current\\chrome.exe`,
+    `${winUserProfile}\\scoop\\apps\\brave\\current\\brave.exe`,
+    `${winUserProfile}\\scoop\\apps\\msedge\\current\\msedge.exe`,
+    `${winUserProfile}\\scoop\\shims\\chrome.exe`,
+    `${winUserProfile}\\scoop\\shims\\msedge.exe`,
+    // Windows — Chocolatey
+    "C:\\ProgramData\\chocolatey\\bin\\chrome.exe",
+    "C:\\ProgramData\\chocolatey\\bin\\msedge.exe",
+    "C:\\ProgramData\\chocolatey\\bin\\brave.exe"
   ].filter(Boolean);
   for (const candidate of candidates) {
     try {
@@ -2649,13 +2686,15 @@ function findChromeExecutable() {
     }
   }
   try {
-    const cmd = isWin ? "where" : "which";
-    const names = isWin ? ["chrome", "msedge", "brave", "google-chrome", "chromium", "chromium-browser"] : ["google-chrome", "google-chrome-stable", "chromium", "chromium-browser", "microsoft-edge", "brave-browser"];
+    const cmd = isWin ? "where.exe" : "which";
+    const names = isWin ? ["chrome.exe", "msedge.exe", "brave.exe", "chrome", "msedge", "brave", "google-chrome", "chromium", "chromium-browser"] : ["google-chrome", "google-chrome-stable", "chromium", "chromium-browser", "microsoft-edge", "brave-browser"];
     for (const name of names) {
-      const res = spawnSync(cmd, [name], { encoding: "utf-8" });
+      const res = spawnSync(cmd, [name], { encoding: "utf-8", windowsHide: true });
       if (res.status === 0 && res.stdout.trim()) {
-        const binPath = res.stdout.split(/\r?\n/)[0].trim();
-        if (fs3.existsSync(binPath)) return binPath;
+        const lines = res.stdout.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+        for (const line of lines) {
+          if (fs3.existsSync(line)) return line;
+        }
       }
     }
   } catch {
@@ -3003,7 +3042,8 @@ import {
   ExternalHyperlink,
   TabStopType,
   PageBreak,
-  NumberFormat
+  NumberFormat,
+  SectionType
 } from "docx";
 
 // src/core/mermaid/mermaidRenderer.ts
@@ -3021,6 +3061,8 @@ async function renderMermaidToPng(mermaidCode, _baseDir = process.cwd()) {
   const tmpDir = os2.tmpdir();
   const tmpHtml = path4.join(tmpDir, `mermaid_${tmpId}.html`);
   const tmpScreenshot = path4.join(tmpDir, `mermaid_${tmpId}.png`);
+  const tmpProfile = path4.join(tmpDir, `mermaid_prof_${tmpId}`);
+  const isWin = process.platform === "win32";
   const htmlContent = `<!DOCTYPE html>
 <html>
 <head>
@@ -3064,10 +3106,14 @@ ${mermaidCode}
     const res = spawnSync2(
       chromePath,
       [
-        "--headless",
+        "--headless=new",
+        `--user-data-dir=${tmpProfile}`,
+        "--no-first-run",
+        "--no-default-browser-check",
         "--disable-gpu",
-        "--no-sandbox",
-        "--disable-setuid-sandbox",
+        "--disable-sync",
+        "--disable-extensions",
+        ...isWin ? [] : ["--no-sandbox", "--disable-setuid-sandbox"],
         "--allow-file-access-from-files",
         "--disable-web-security",
         "--disable-software-rasterizer",
@@ -3076,7 +3122,7 @@ ${mermaidCode}
         `--screenshot=${tmpScreenshot}`,
         fileUrl
       ],
-      { timeout: 15e3 }
+      { timeout: 15e3, windowsHide: true }
     );
     if (res.status === 0 && fs4.existsSync(tmpScreenshot)) {
       const buffer = fs4.readFileSync(tmpScreenshot);
@@ -3087,6 +3133,7 @@ ${mermaidCode}
     try {
       if (fs4.existsSync(tmpHtml)) fs4.unlinkSync(tmpHtml);
       if (fs4.existsSync(tmpScreenshot)) fs4.unlinkSync(tmpScreenshot);
+      if (fs4.existsSync(tmpProfile)) fs4.rmSync(tmpProfile, { recursive: true, force: true });
     } catch {
     }
   }
@@ -4205,6 +4252,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
     );
     docSections.push({
       properties: {
+        type: SectionType.NEXT_PAGE,
         page: {
           size: {
             width: resolved.paperDimensions.widthTwip,
@@ -4219,13 +4267,14 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
           }
         }
       },
-      headers: void 0,
-      footers: void 0,
+      headers: { default: new Header({ children: [] }) },
+      footers: { default: new Footer({ children: [] }) },
       children: coverElements
     });
   }
   docSections.push({
     properties: {
+      type: SectionType.NEXT_PAGE,
       page: {
         pageNumbers: {
           start: 1,
@@ -4246,8 +4295,8 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
         }
       }
     },
-    headers: docHeader ? { default: docHeader } : void 0,
-    footers: docFooter ? { default: docFooter } : void 0,
+    headers: docHeader ? { default: docHeader } : { default: new Header({ children: [] }) },
+    footers: docFooter ? { default: docFooter } : { default: new Footer({ children: [] }) },
     children: docElements
   });
   if (resolved.backCover && resolved.backCover.enabled) {
@@ -4262,6 +4311,7 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
     );
     docSections.push({
       properties: {
+        type: SectionType.NEXT_PAGE,
         page: {
           size: {
             width: resolved.paperDimensions.widthTwip,
@@ -4276,8 +4326,8 @@ async function buildDocxDocument(doc, config, baseDir = process.cwd()) {
           }
         }
       },
-      headers: void 0,
-      footers: void 0,
+      headers: { default: new Header({ children: [] }) },
+      footers: { default: new Footer({ children: [] }) },
       children: backElements
     });
   }
@@ -4681,8 +4731,12 @@ function createEmptyDocxCell(widthDxa) {
 }
 
 export {
+  applyHeadingNumbering,
   parseMarkdownDocument,
+  replaceDocumentTokens,
+  resolveDocumentConfig,
   buildHtmlDocument,
+  findChromeExecutable,
   buildPdfDocument,
   buildDocxDocument
 };

package/dist/cli.mjs

@@ -71,7 +71,7 @@ async function main() {
   if (options.serve !== false && options.serve !== void 0) {
     const rawPort = options.serve === true ? 3e3 : parseInt(String(options.serve), 10);
     const port = isNaN(rawPort) ? 3e3 : rawPort;
-    const { startPreviewServer } = await import("./previewServer-4EELOUAV.mjs");
+    const { startPreviewServer } = await import("./previewServer-U47WQ5FV.mjs");
     const instance = await startPreviewServer({
       filePath: resolvedInputPath,
       port,
@@ -99,7 +99,7 @@ async function main() {
   }
   const [{ render }, { App }] = await Promise.all([
     import("ink"),
-    import("./App-TPDCT2VL.mjs")
+    import("./App-JOOTPDJN.mjs")
   ]);
   render(
     /* @__PURE__ */ jsx(

package/dist/index.d.mts

@@ -4,9 +4,10 @@ declare enum OutputFormat {
     DOCX = "docx",
     PDF = "pdf",
     HTML = "html",
-    PNG = "png"
+    PNG = "png",
+    TXT = "txt"
 }
-type MarkforgeFormat = "docx" | "pdf" | "html" | "png" | OutputFormat;
+type MarkforgeFormat = "docx" | "pdf" | "html" | "png" | "txt" | OutputFormat;
 interface ThemeProps {
     /**
      * Primary brand accent color (e.g. "#33CDCF", "#2563EB", "#7C3AED", "#E11D48").
@@ -238,7 +239,13 @@ interface CoverPageConfig {
      */
     footerText?: string;
 }
-type BackCoverPreset = "modern" | "corporate" | "minimal" | "contact-card";
+declare enum BackCoverPreset {
+    MODERN = "modern",
+    CORPORATE = "corporate",
+    MINIMAL = "minimal",
+    CONTACT_CARD = "contact-card"
+}
+type BackCoverPresetType = "modern" | "corporate" | "minimal" | "contact-card" | BackCoverPreset;
 interface BackCoverSocial {
     github?: string;
     twitter?: string;
@@ -260,7 +267,7 @@ interface BackCoverConfig {
      * - "contact-card": Floating elevated glassmorphic contact card with full metadata grid.
      * @default "modern"
      */
-    preset?: BackCoverPreset;
+    preset?: BackCoverPresetType;
     /**
      * Headline title shown on the back cover.
      * @default "Thank You"
@@ -405,8 +412,19 @@ interface DocumentMetadata {
     backCover?: boolean | BackCoverConfig;
     [key: string]: unknown;
 }
-type SignatureAlign = "left" | "center" | "right" | "space-between";
-type SignatureStyle = "line" | "box" | "clean";
+declare enum SignatureAlign {
+    LEFT = "left",
+    CENTER = "center",
+    RIGHT = "right",
+    SPACE_BETWEEN = "space-between"
+}
+type SignatureAlignOption = "left" | "center" | "right" | "space-between" | SignatureAlign;
+declare enum SignatureStyle {
+    LINE = "line",
+    BOX = "box",
+    CLEAN = "clean"
+}
+type SignatureStyleOption = "line" | "box" | "clean" | SignatureStyle;
 interface SignatureItem {
     /**
      * Title or sign-off label above signature (e.g. "Prepared by", "Approved by", "Acknowledged by").
@@ -443,7 +461,7 @@ interface SignatureBlockConfig {
      * Horizontal alignment of the signature block.
      * @default "right" for 1 item, "space-between" for >= 2 items
      */
-    align?: SignatureAlign;
+    align?: SignatureAlignOption;
     /**
      * Visual layout style of the signature block:
      * - "line": Traditional signature with a horizontal separator line above name.
@@ -451,7 +469,7 @@ interface SignatureBlockConfig {
      * - "clean": Minimalist blank vertical space without borders.
      * @default "line"
      */
-    style?: SignatureStyle;
+    style?: SignatureStyleOption;
     /**
      * Border or divider line color.
      * @default "#CBD5E1"
@@ -766,8 +784,8 @@ interface NormalizedSignatureItem {
 }
 interface NormalizedSignatureBlock {
     items: NormalizedSignatureItem[];
-    align: SignatureAlign;
-    style: SignatureStyle;
+    align: SignatureAlignOption;
+    style: SignatureStyleOption;
     borderColor: string;
     titleColor: string;
     nameColor: string;
@@ -966,7 +984,7 @@ declare function renderBackCoverHtml(backCover: NormalizedBackCover, baseDir?: s
 /**
  * Builds standalone self-contained HTML from a parsed Markdown document.
  */
-declare function buildHtmlDocument(doc: ParsedMarkdownDocument, config: MarkforgeConfig, baseDir?: string): Promise<string>;
+declare function buildHtmlDocument(doc: ParsedMarkdownDocument, config?: MarkforgeConfig, baseDir?: string): Promise<string>;
 
 /**
  * Finds available Chrome or Chromium binary for headless PDF rendering.
@@ -981,6 +999,20 @@ declare function injectPagedMediaStyles(html: string, config: MarkforgeConfig, m
  */
 declare function buildPdfDocument(doc: ParsedMarkdownDocument, config: MarkforgeConfig, baseDir?: string): Promise<Buffer>;
 
+/**
+ * Converts inline AST spans into clean, readable plain text.
+ */
+declare function renderInlinesToText(spans?: MarkdownInlineSpan[], meta?: Record<string, unknown>): string;
+/**
+ * Builds a structured, beautifully formatted plain text (.txt) document from markdown AST.
+ */
+declare function buildTextDocument(doc: ParsedMarkdownDocument, config?: MarkforgeConfig, _baseDir?: string): Promise<string>;
+
+/**
+ * Builds a high-resolution PNG document image buffer using headless Chromium screenshot.
+ */
+declare function buildPngDocument(doc: ParsedMarkdownDocument, config?: MarkforgeConfig, baseDir?: string): Promise<Buffer>;
+
 interface ResolvedImage {
     src: string;
     buffer: Buffer;
@@ -1114,4 +1146,4 @@ declare const MARKFORGE_VERSION: string;
  */
 declare function getMarkforgeVersion(fromDir?: string): string;
 
-export { type BackCoverConfig, type BackCoverPreset, type BackCoverSocial, type CompilationResult, type CoverPageConfig, CoverPagePreset, DEFAULT_CONFIG, type DocumentLayoutConfig, type DocumentMetadata, type DocumentOrientation, type FootnoteDefinition, type FrontmatterMetadata, type GeneratedOutputFile, type HeaderFooterItem, type HeaderFooterSlot, KATEX_INLINE_CSS, MARKFORGE_VERSION, type MarkdownASTNode, type MarkdownInlineSpan, type MarkdownNodeType, type MarkforgeConfig, type MarkforgeFormat, type MarkforgeTheme, type NormalizedBackCover, type NormalizedCoverPage, type NormalizedHeaderFooter, type NormalizedHeaderFooterZone, type NormalizedMargins, type NormalizedNumberHeadings, type NormalizedSecurity, type NormalizedSignatureBlock, type NormalizedSignatureItem, type NormalizedWatermark, type NumberHeadingsConfig, Orientation, OutputFormat, PAPER_DIMENSIONS_TWIP, type PageMargins, type PaperSize, PaperSizeEnum, type ParsedMarkdownDocument, type PdfPermissions, type PreviewServerInstance, type PreviewServerOptions, type ResolvedDocumentConfig, type ResolvedImage, SYNTAX_COLORS, type SecurityConfig, type SignatureAlign, type SignatureBlockConfig, type SignatureItem, type SignatureStyle, SyntaxTheme, type SyntaxToken, THEMES, THEME_CORPORATE, THEME_DEFAULT, Theme, type ThemeProps, type WatermarkOptions, WatermarkPosition, applyHeadingNumbering, buildDocxDocument, buildHtmlDocument, buildPdfDocument, compileMarkdown, defineConfig, escapeHtml, findChromeExecutable, formatServerTimestamp, generateThemeCss, getMarkforgeVersion, getMimeType, highlightCodeToHtml, injectPagedMediaStyles, inlineHtmlImages, loadConfig, compileMarkdown as markforge, normalizeBackCover, normalizeCoverPage, normalizeHeaderFooter, normalizeHeaderFooterSlot, normalizeNumberHeadings, normalizeSecurity, normalizeSignatures, normalizeWatermark, parseInlineSpans, parseMarginToTwip, parseMarkdownDocument as parseMarkdown, parseMarkdownDocument, renderBackCoverHtml, renderCoverPageHtml, renderInlinesToHtml, renderMathToHtml, renderMermaidToPng, renderNodesToHtml, replaceDocumentTokens, resolveDocumentConfig, resolveImage, slugify, startPreviewServer, tokenizeCodeLine };
+export { type BackCoverConfig, BackCoverPreset, type BackCoverPresetType, type BackCoverSocial, type CompilationResult, type CoverPageConfig, CoverPagePreset, type CoverPreset, DEFAULT_CONFIG, type DocumentLayoutConfig, type DocumentMetadata, type DocumentOrientation, type FootnoteDefinition, type FrontmatterMetadata, type GeneratedOutputFile, type HeaderFooterItem, type HeaderFooterSlot, KATEX_INLINE_CSS, MARKFORGE_VERSION, type MarkdownASTNode, type MarkdownInlineSpan, type MarkdownNodeType, type MarkforgeConfig, type MarkforgeFormat, type MarkforgeTheme, type NormalizedBackCover, type NormalizedCoverPage, type NormalizedHeaderFooter, type NormalizedHeaderFooterZone, type NormalizedMargins, type NormalizedNumberHeadings, type NormalizedSecurity, type NormalizedSignatureBlock, type NormalizedSignatureItem, type NormalizedWatermark, type NumberHeadingsConfig, Orientation, OutputFormat, PAPER_DIMENSIONS_TWIP, type PageMargins, type PaperSize, PaperSizeEnum, type ParsedMarkdownDocument, type PdfPermissions, type PreviewServerInstance, type PreviewServerOptions, type ResolvedDocumentConfig, type ResolvedImage, SYNTAX_COLORS, type SecurityConfig, SignatureAlign, type SignatureAlignOption, type SignatureBlockConfig, type SignatureItem, SignatureStyle, type SignatureStyleOption, SyntaxTheme, type SyntaxToken, THEMES, THEME_CORPORATE, THEME_DEFAULT, Theme, type ThemeProps, type WatermarkOptions, WatermarkPosition, applyHeadingNumbering, buildDocxDocument, buildHtmlDocument, buildPdfDocument, buildPngDocument, buildTextDocument, buildTextDocument as buildTxtDocument, compileMarkdown, defineConfig, escapeHtml, findChromeExecutable, formatServerTimestamp, generateThemeCss, getMarkforgeVersion, getMimeType, highlightCodeToHtml, injectPagedMediaStyles, inlineHtmlImages, loadConfig, compileMarkdown as markforge, normalizeBackCover, normalizeCoverPage, normalizeHeaderFooter, normalizeHeaderFooterSlot, normalizeNumberHeadings, normalizeSecurity, normalizeSignatures, normalizeWatermark, parseInlineSpans, parseMarginToTwip, parseMarkdownDocument as parseMarkdown, parseMarkdownDocument, renderBackCoverHtml, renderCoverPageHtml, renderInlinesToHtml, renderInlinesToText, renderMathToHtml, renderMermaidToPng, renderNodesToHtml, replaceDocumentTokens, resolveDocumentConfig, resolveImage, slugify, startPreviewServer, tokenizeCodeLine };

package/dist/index.d.ts

@@ -4,9 +4,10 @@ declare enum OutputFormat {
     DOCX = "docx",
     PDF = "pdf",
     HTML = "html",
-    PNG = "png"
+    PNG = "png",
+    TXT = "txt"
 }
-type MarkforgeFormat = "docx" | "pdf" | "html" | "png" | OutputFormat;
+type MarkforgeFormat = "docx" | "pdf" | "html" | "png" | "txt" | OutputFormat;
 interface ThemeProps {
     /**
      * Primary brand accent color (e.g. "#33CDCF", "#2563EB", "#7C3AED", "#E11D48").
@@ -238,7 +239,13 @@ interface CoverPageConfig {
      */
     footerText?: string;
 }
-type BackCoverPreset = "modern" | "corporate" | "minimal" | "contact-card";
+declare enum BackCoverPreset {
+    MODERN = "modern",
+    CORPORATE = "corporate",
+    MINIMAL = "minimal",
+    CONTACT_CARD = "contact-card"
+}
+type BackCoverPresetType = "modern" | "corporate" | "minimal" | "contact-card" | BackCoverPreset;
 interface BackCoverSocial {
     github?: string;
     twitter?: string;
@@ -260,7 +267,7 @@ interface BackCoverConfig {
      * - "contact-card": Floating elevated glassmorphic contact card with full metadata grid.
      * @default "modern"
      */
-    preset?: BackCoverPreset;
+    preset?: BackCoverPresetType;
     /**
      * Headline title shown on the back cover.
      * @default "Thank You"
@@ -405,8 +412,19 @@ interface DocumentMetadata {
     backCover?: boolean | BackCoverConfig;
     [key: string]: unknown;
 }
-type SignatureAlign = "left" | "center" | "right" | "space-between";
-type SignatureStyle = "line" | "box" | "clean";
+declare enum SignatureAlign {
+    LEFT = "left",
+    CENTER = "center",
+    RIGHT = "right",
+    SPACE_BETWEEN = "space-between"
+}
+type SignatureAlignOption = "left" | "center" | "right" | "space-between" | SignatureAlign;
+declare enum SignatureStyle {
+    LINE = "line",
+    BOX = "box",
+    CLEAN = "clean"
+}
+type SignatureStyleOption = "line" | "box" | "clean" | SignatureStyle;
 interface SignatureItem {
     /**
      * Title or sign-off label above signature (e.g. "Prepared by", "Approved by", "Acknowledged by").
@@ -443,7 +461,7 @@ interface SignatureBlockConfig {
      * Horizontal alignment of the signature block.
      * @default "right" for 1 item, "space-between" for >= 2 items
      */
-    align?: SignatureAlign;
+    align?: SignatureAlignOption;
     /**
      * Visual layout style of the signature block:
      * - "line": Traditional signature with a horizontal separator line above name.
@@ -451,7 +469,7 @@ interface SignatureBlockConfig {
      * - "clean": Minimalist blank vertical space without borders.
      * @default "line"
      */
-    style?: SignatureStyle;
+    style?: SignatureStyleOption;
     /**
      * Border or divider line color.
      * @default "#CBD5E1"
@@ -766,8 +784,8 @@ interface NormalizedSignatureItem {
 }
 interface NormalizedSignatureBlock {
     items: NormalizedSignatureItem[];
-    align: SignatureAlign;
-    style: SignatureStyle;
+    align: SignatureAlignOption;
+    style: SignatureStyleOption;
     borderColor: string;
     titleColor: string;
     nameColor: string;
@@ -966,7 +984,7 @@ declare function renderBackCoverHtml(backCover: NormalizedBackCover, baseDir?: s
 /**
  * Builds standalone self-contained HTML from a parsed Markdown document.
  */
-declare function buildHtmlDocument(doc: ParsedMarkdownDocument, config: MarkforgeConfig, baseDir?: string): Promise<string>;
+declare function buildHtmlDocument(doc: ParsedMarkdownDocument, config?: MarkforgeConfig, baseDir?: string): Promise<string>;
 
 /**
  * Finds available Chrome or Chromium binary for headless PDF rendering.
@@ -981,6 +999,20 @@ declare function injectPagedMediaStyles(html: string, config: MarkforgeConfig, m
  */
 declare function buildPdfDocument(doc: ParsedMarkdownDocument, config: MarkforgeConfig, baseDir?: string): Promise<Buffer>;
 
+/**
+ * Converts inline AST spans into clean, readable plain text.
+ */
+declare function renderInlinesToText(spans?: MarkdownInlineSpan[], meta?: Record<string, unknown>): string;
+/**
+ * Builds a structured, beautifully formatted plain text (.txt) document from markdown AST.
+ */
+declare function buildTextDocument(doc: ParsedMarkdownDocument, config?: MarkforgeConfig, _baseDir?: string): Promise<string>;
+
+/**
+ * Builds a high-resolution PNG document image buffer using headless Chromium screenshot.
+ */
+declare function buildPngDocument(doc: ParsedMarkdownDocument, config?: MarkforgeConfig, baseDir?: string): Promise<Buffer>;
+
 interface ResolvedImage {
     src: string;
     buffer: Buffer;
@@ -1114,4 +1146,4 @@ declare const MARKFORGE_VERSION: string;
  */
 declare function getMarkforgeVersion(fromDir?: string): string;
 
-export { type BackCoverConfig, type BackCoverPreset, type BackCoverSocial, type CompilationResult, type CoverPageConfig, CoverPagePreset, DEFAULT_CONFIG, type DocumentLayoutConfig, type DocumentMetadata, type DocumentOrientation, type FootnoteDefinition, type FrontmatterMetadata, type GeneratedOutputFile, type HeaderFooterItem, type HeaderFooterSlot, KATEX_INLINE_CSS, MARKFORGE_VERSION, type MarkdownASTNode, type MarkdownInlineSpan, type MarkdownNodeType, type MarkforgeConfig, type MarkforgeFormat, type MarkforgeTheme, type NormalizedBackCover, type NormalizedCoverPage, type NormalizedHeaderFooter, type NormalizedHeaderFooterZone, type NormalizedMargins, type NormalizedNumberHeadings, type NormalizedSecurity, type NormalizedSignatureBlock, type NormalizedSignatureItem, type NormalizedWatermark, type NumberHeadingsConfig, Orientation, OutputFormat, PAPER_DIMENSIONS_TWIP, type PageMargins, type PaperSize, PaperSizeEnum, type ParsedMarkdownDocument, type PdfPermissions, type PreviewServerInstance, type PreviewServerOptions, type ResolvedDocumentConfig, type ResolvedImage, SYNTAX_COLORS, type SecurityConfig, type SignatureAlign, type SignatureBlockConfig, type SignatureItem, type SignatureStyle, SyntaxTheme, type SyntaxToken, THEMES, THEME_CORPORATE, THEME_DEFAULT, Theme, type ThemeProps, type WatermarkOptions, WatermarkPosition, applyHeadingNumbering, buildDocxDocument, buildHtmlDocument, buildPdfDocument, compileMarkdown, defineConfig, escapeHtml, findChromeExecutable, formatServerTimestamp, generateThemeCss, getMarkforgeVersion, getMimeType, highlightCodeToHtml, injectPagedMediaStyles, inlineHtmlImages, loadConfig, compileMarkdown as markforge, normalizeBackCover, normalizeCoverPage, normalizeHeaderFooter, normalizeHeaderFooterSlot, normalizeNumberHeadings, normalizeSecurity, normalizeSignatures, normalizeWatermark, parseInlineSpans, parseMarginToTwip, parseMarkdownDocument as parseMarkdown, parseMarkdownDocument, renderBackCoverHtml, renderCoverPageHtml, renderInlinesToHtml, renderMathToHtml, renderMermaidToPng, renderNodesToHtml, replaceDocumentTokens, resolveDocumentConfig, resolveImage, slugify, startPreviewServer, tokenizeCodeLine };
+export { type BackCoverConfig, BackCoverPreset, type BackCoverPresetType, type BackCoverSocial, type CompilationResult, type CoverPageConfig, CoverPagePreset, type CoverPreset, DEFAULT_CONFIG, type DocumentLayoutConfig, type DocumentMetadata, type DocumentOrientation, type FootnoteDefinition, type FrontmatterMetadata, type GeneratedOutputFile, type HeaderFooterItem, type HeaderFooterSlot, KATEX_INLINE_CSS, MARKFORGE_VERSION, type MarkdownASTNode, type MarkdownInlineSpan, type MarkdownNodeType, type MarkforgeConfig, type MarkforgeFormat, type MarkforgeTheme, type NormalizedBackCover, type NormalizedCoverPage, type NormalizedHeaderFooter, type NormalizedHeaderFooterZone, type NormalizedMargins, type NormalizedNumberHeadings, type NormalizedSecurity, type NormalizedSignatureBlock, type NormalizedSignatureItem, type NormalizedWatermark, type NumberHeadingsConfig, Orientation, OutputFormat, PAPER_DIMENSIONS_TWIP, type PageMargins, type PaperSize, PaperSizeEnum, type ParsedMarkdownDocument, type PdfPermissions, type PreviewServerInstance, type PreviewServerOptions, type ResolvedDocumentConfig, type ResolvedImage, SYNTAX_COLORS, type SecurityConfig, SignatureAlign, type SignatureAlignOption, type SignatureBlockConfig, type SignatureItem, SignatureStyle, type SignatureStyleOption, SyntaxTheme, type SyntaxToken, THEMES, THEME_CORPORATE, THEME_DEFAULT, Theme, type ThemeProps, type WatermarkOptions, WatermarkPosition, applyHeadingNumbering, buildDocxDocument, buildHtmlDocument, buildPdfDocument, buildPngDocument, buildTextDocument, buildTextDocument as buildTxtDocument, compileMarkdown, defineConfig, escapeHtml, findChromeExecutable, formatServerTimestamp, generateThemeCss, getMarkforgeVersion, getMimeType, highlightCodeToHtml, injectPagedMediaStyles, inlineHtmlImages, loadConfig, compileMarkdown as markforge, normalizeBackCover, normalizeCoverPage, normalizeHeaderFooter, normalizeHeaderFooterSlot, normalizeNumberHeadings, normalizeSecurity, normalizeSignatures, normalizeWatermark, parseInlineSpans, parseMarginToTwip, parseMarkdownDocument as parseMarkdown, parseMarkdownDocument, renderBackCoverHtml, renderCoverPageHtml, renderInlinesToHtml, renderInlinesToText, renderMathToHtml, renderMermaidToPng, renderNodesToHtml, replaceDocumentTokens, resolveDocumentConfig, resolveImage, slugify, startPreviewServer, tokenizeCodeLine };