Changelog

[0.10.0] - 2026-11-14

React Headless Primitives, Document Hooks & Reactive Preview Engine

• Dedicated Subpath Export (@masumdev/markforge/react):
  • Exported native React components, hooks, and TypeScript definitions via @masumdev/markforge/react with dedicated dist/react.d.ts type definitions and tree-shakeable CJS/ESM bundles.
  • Also re-exported from root @masumdev/markforge for maximum developer convenience.
• <MarkforgeDocument /> Declarative Document Canvas:
  • Renders Markdown/MDX into a reactive React component tree.
  • Supports mode="continuous" (responsive web reading layout) and mode="paginated" (A4 sheet cards with drop shadows, page breaks, and print simulation).
  • Built-in theme styling (corporate, academic, github, minimal, or custom ThemeProps), KaTeX equations, Mermaid diagram containers, and unselectable watermark overlays.
• 100% Flexible Headless Component Slots (components Prop):
  • Supports slot overrides for heading, paragraph, codeBlock, blockquote, callout, table, mermaid, math, columns, coverPage, and backCover.
  • Enables developers to plug in their own UI components (e.g. custom syntax highlighters, interactive alert boxes, zoomable diagrams).
• Headless React Hooks:
  • useMarkforge(): Memoized AST parser, TOC extractor, statistics calculator (words, characters, reading minutes, estimated pages), and programmatic export helpers (exportPdf(), exportDocx(), exportHtml()).
  • useMarkforgeToc(): Automatic Scroll Spy with IntersectionObserver to track the active heading in viewport and smooth scrolling navigation.
• Upgraded CLI Live Preview Server (previewServer.ts):
  • Migrated /document-content preview frame from static HTML string builder to React server-side component markup (renderToStaticMarkup).
  • Eliminates flickering and scroll jumps during live editing with Server-Sent Events (SSE).

---

[0.9.0] - 2026-11-13

Native ESM Mermaid Engine, Universal Diagram Theming & Proportional Layout

• Modern ESM Module Mermaid Loader (mermaid@11):
  • Migrated from legacy scripts to modern ESM module https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs with <script type="module">.
  • Replaced diagram containers with semantic <pre class="mermaid"> elements as recommended by official Mermaid documentation to prevent whitespace normalization issues.
• Theme-Adaptive Mermaid Engine (theme & themeVariables):
  • Dynamically synchronizes Mermaid theme (default, neutral, dark, forest, base) and color variables (primaryColor, primaryBorderColor, lineColor, fontFamily) with the active document theme.
  • Zero external icon dependencies: Cleaned out raw Font Awesome text and font dependencies, allowing Mermaid’s native geometry, shape coloring, and arrow connections to render cleanly.
• Print & PDF Page Break Protection:
  • Added .markforge-mermaid-container to avoidInsideBlocks (break-inside: avoid !important; page-break-inside: avoid !important;) in pdfBuilder.ts.
  • Added print media constraints (max-height: 700px !important;) ensuring large diagrams scale down gracefully without splitting or leaving empty container boxes across pages.
• Support for Comprehensive Diagram Types:
  • Full native rendering fidelity for Flowcharts, Sequence Diagrams, State Diagrams, ER Diagrams, Class Diagrams, and Gantt Charts.
  • Proportional 2x Retina PNG rendering for Microsoft Word (DOCX) via getImageDimensions.
• Badges Standardization:
  • Standardized badge suites across all open-source libraries in the monorepo with flat-square styling and XERJ Corpus Hub contributor verification.

---

[0.8.0] - 2026-11-12

Native Word Equations (OMML), Synchronized TOC with Dot Leaders & Proportional Logos

• Native Microsoft Word Equation (OMML <m:oMath>) Engine:
  • Implemented stack-based MathML-to-OMML parser (parseMathML) in docxBuilder.ts to convert KaTeX mathematical formulas into native Microsoft Word Equations (<m:oMath>).
  • Supports fractions (<m:f>), superscripts (<m:sSup>), subscripts (<m:sSub>), sub-superscripts, radicals/roots (<m:rad>), and mathematical operator glyphs ($\le$, $\ge$, $\lambda$, $\mu$, $\rho$, $\Delta t$, etc.).
  • Both inline math ($...$) and display block math ($$...$$) are now fully editable native Word equation components instead of raw LaTeX text.
• Table of Contents (TOC) with Dot Leaders & Synchronized Page Numbering:
  • Implemented dot leader formatting (. . . . .) leading to right-aligned page numbers across both PDF and DOCX.
  • Symmetrical outline normalization (normalizeForMatch) eliminates mismatches between Chromium PDF outline headings and Word document headings caused by symbols (&), line breaks, or whitespace differences.
  • Enforced strict monotonic non-decreasing page constraint (Math.max(lastPage, ...)) so subsequent sections and chapters never jump backward in page numbering.
  • Automatic manual numbering prefix cleanup in applyHeadingNumbering to prevent duplicate numbering artifacts like 7.1. 1. Title.
• Proportional Cover Page & Back Cover Logo Dimensions:
  • Zero-dependency buffer inspection (getImageDimensions) reads intrinsic dimensions of PNG, JPEG, GIF, SVG, WebP, and BMP files.
  • Added calculateProportionalLogoDimensions in docxBuilder.ts to strictly preserve natural logo aspect ratios and prevent vertical or horizontal stretching in Microsoft Word.

---

[0.7.0] - 2026-11-12

Microsoft Edge Priority, Manual Browser Path & Logo Aspect Ratio

• Microsoft Edge Priority & Windows Auto-Discovery:
  • Headless PDF and screenshot generation on Windows now prioritizes Microsoft Edge (msedge.exe) as the system-native Chromium browser across Program Files, Program Files (x86), SystemDrive, and LocalAppData.
  • Guarantees seamless out-of-the-box PDF compilation on Windows 10 & Windows 11 without requiring a separate Google Chrome installation.
• Manual Browser Path Configuration (browserPath / chromiumPath):
  • Added browserPath (and alias chromiumPath) to markforge.config.ts, Markdown frontmatter, and API options.
  • Added CLI flags --browser-path <path> and --chromium-path <path>.
  • Added support for MARKFORGE_BROWSER_PATH and EDGE_PATH environment variables alongside existing CHROME_PATH and PUPPETEER_EXECUTABLE_PATH.
• Proportional Cover Page & Back Cover Logo Aspect Ratio Preservation:
  • Implemented zero-dependency getImageDimensions in imageResolver.ts supporting PNG, JPEG, GIF, SVG, WebP, and BMP buffer header parsing.
  • Added calculateProportionalLogoDimensions in docxBuilder.ts to strictly maintain natural image aspect ratios and prevent vertical logo stretching in Microsoft Word (DOCX).
  • Added logoHeight configuration and frontmatter property for optional explicit height overrides.
• Windows Defender & Enterprise EDR Compliance:
  • Eliminated subprocess registry execution (reg.exe) in favor of direct, zero-process filesystem checks (fs.existsSync).
  • Removed risky infostealer-associated flags (--password-store=basic, --use-mock-keychain) from headless browser launches.
  • Removed --disable-web-security from Mermaid diagram rendering.
  • Enforced strict browser sandboxing on Windows, ensuring --no-sandbox is never passed on Windows environments.

---

[0.6.0] - 2026-11-08

Page Breaks, Typography Control & Unified Configuration

• Page Breaks & Typography Pagination Controller (pageBreaks):
  • Implemented configurable print and PDF layout pagination rules via pageBreaks in markforge.config.ts and Markdown frontmatter.
  • Orphan Headings Prevention (avoidOrphanHeadings: true): Guarantees headings (h1 through h6) are never isolated at the bottom of a page without subsequent content (break-after: avoid !important; page-break-after: avoid !important;).
  • Chapter & Section Breaks (beforeH1 & beforeH2): Configurable option to force major chapters to automatically begin on a fresh page (break-before: page;).
  • Repeating Table Headers (repeatTableHeaders: true): Repeats <thead> on subsequent pages when tables span across multiple pages (display: table-header-group !important;).
  • Block Integrity Protection (avoidInsideBlocks: true): Prevents code blocks (pre), callout boxes, blockquotes, multi-columns (:::columns), and signatures from splitting awkwardly across pages.
  • Table Rows Protection (avoidInsideTableRows: true): Prevents individual <tr> rows from being sliced in the middle of text lines.
  • Typographic Orphans & Widows Control: Configurable orphans and widows thresholds (default: 3) for clean paragraph flow.
• Manual Page Break Directives:
  • Added native AST support for explicit page breaks in Markdown: <!-- pagebreak -->, <!-- page-break -->, \pagebreak, :::pagebreak, :::break, or <div class="pagebreak"></div>.
  • Compiles cleanly into CSS Paged Media in PDF/HTML and native section breaks (new PageBreak()) in Microsoft Word DOCX.
• Unified Symmetrical Configuration & Frontmatter Routing:
  • Added support for root-level document metadata (title, author, company, subtitle, date, version, lang) in both config files and frontmatter without requiring a nested metadata: { ... } wrapper.
  • Frontmatter to: and outputDir: properties now dynamically route compilation outputs directly without requiring CLI overrides.
  • Injected missing PDF header and footer divider rules (header.divider and footer.divider) into CSS Paged Media.
  • Added full support for watermark.position ("diagonal" | "center" | "top-right" | "bottom-right"), DOCX watermark stamping, and DOCX language proofing.
• CLI Watch Mode & Native Open Flags:
  • Implemented the reactive file watcher loop for -w, --watch using Node fs.watch.
  • Implemented the cross-platform file opener for -O, --open to automatically launch generated documents in the OS default viewer.
  • Added --no-toc flag to allow disabling Table of Contents directly from the CLI.

---

[0.5.2] - 2026-09-11

OS-Specific PDF Page Normalization

• Platform-Aware Blank Page Pruning:
  • Implemented platform-aware handling for Chromium headless print. On Windows (win32), DirectWrite renders page bounds with subpixel precision without trailing pages, while on Linux/Unix, trailing overflow blank pages after 100vh sections are cleanly pruned, ensuring exact and consistent page counts across all operating systems.

---

[0.5.1] - 2026-09-11

Cross-Platform PDF Back Cover Preservation

• CSS Height Standardizing:
  • Adjusted .markforge-back-cover print media CSS height to calc(100vh - 2px) with overflow: hidden; and page-break-after: avoid; break-after: avoid;, eliminating subpixel page overflow across Windows (DirectWrite / Edge / Chrome) and Linux (FreeType).
• Eliminated Blind Page Truncation:
  • Removed trailing page deletion (pdfDoc.removePage) in the PDF builder pipeline that previously led to the back cover closing card being inadvertently deleted on Windows multi-page documents.

---

[0.5.0] - 2026-09-03

Plain Text (.txt) Document Publishing Engine

• Plain Text (.txt) Output Format:
  • Added native support for compiling Markdown documents into structured plain text files (OutputFormat.TXT or "txt" in to: array / --to txt).
  • Structured document rendering with centered title banner, Table of Contents, double (=) and single (-) divider rules, callout tags (| [NOTE]), blockquotes (> text), code blocks with language annotations, and task item checkboxes ([x] / [ ]).
  • ASCII grid-aligned tables with dynamic column width calculation and text padding.
  • Complete support for footnotes ([1] text), approval signatures, and back cover closing card with dynamic metadata token replacement.
  • Terminal CLI and Ink UI integration with green badge color highlighting for [TXT] documents in the compilation summary table.

---

[0.4.1] - 2026-08-30

Enhancements, Security, CLI, and Configuration Refinements

• Watermark Suppression on Front & Back Covers:
  • Excluded the vector/PNG watermark overlay from both the Front Cover Page (page 0) and the Back Cover Closing Page (final page) in PDF generation.
  • Suppressed the HTML fixed canvas watermark in print media (@media print { .document-watermark { display: none !important; } }) to ensure only explicit pdf-lib page indexing controls watermark rendering.
• Symmetric & Unified Cover & Back Cover Styling Configuration:
  • Unified configuration property names across CoverPageConfig and BackCoverConfig for complete API consistency.
  • Added support for backgroundColor, bgGradient, textColor, titleColor, subtitleColor, accentColor, badge, badgeColor, badgeTextColor, logo, logoWidth, footerText, copyright, address, email, phone, website, and social across front and back covers in HTML, PDF, and DOCX.
• Heading Color Harmonization (h1 through h6):
  • Unified all heading levels (h1, h2, h3, h4, h5, h6) to use brand primary dark styling (var(--mf-primary-dark)) across HTML, PDF, and DOCX for visual consistency.
  • h1: 2.5px solid primary border underline; h2: 1px subtle teal border underline.
• Strict Package.json Version Resolution:
  • Removed fallback version constant in version.ts. The engine now resolves version strictly from the nearest @masumdev/markforge package.json at runtime and throws an explicit error if missing or unreadable.
• Comprehensive Terminal CLI Parameter & Configuration Banner:
  • Ink CLI header box and Live Preview banner (--serve) now display all resolved configuration details: source path, config path, visual theme, syntax highlighter, layout, output directory, and active module list (TOC, Numbering, Cover, BackCover, Watermark, Security, Math, Syntax).
• Arbitrary Dynamic Metadata & Nested Record Token Interpolation:
  • Enhanced replaceDocumentTokens to dynamically unpack and replace tokens defined in top-level metadata or nested metadata dictionaries (e.g. {metakuda} or {custom_key}).
  • Fixed AST parser inline text chunking to merge adjacent plain text spans, ensuring token names containing underscores (_) or hyphens are not split across separate tokens.
• Table of Contents (TOC) Page Break Isolation:
  • Table of Contents is now fully isolated from subsequent document body content via page-break-after: always; break-after: page; in PDF/HTML and a dedicated section break in Microsoft Word DOCX.
• Academic & Enterprise Page Numbering Schema:
  • Front Cover: Unnumbered, running headers/footers suppressed.
  • Table of Contents: Formal lowercase Roman numerals (i, ii, …).
  • Main Document Body: Counter reset (counter-reset: page 1;) with standard decimal numbers (1, 2, ...).
  • Back Cover: Unnumbered, isolated final closing section.
• Config-Driven Section Numbering (numberHeadings):
  • Propagated top-level configuration options (numberHeadings: { enabled, depth, skipH1, prefix }) directly into AST parsing and compilation across HTML, PDF, and DOCX.

---

[0.4.0] - 2026-08-29

Major Enterprise Features & Security Release

• ISO 32000-2 AES-256 PDF Security & Password Encryption (security):
  • Native standard PDF encryption with independent userPassword (password required to open the document) and ownerPassword (master password required to modify document permissions).
  • Granular permissions enforcement: printing, modifying, copying, annotating, fillingForms, contentAccessibility, and documentAssembly.
  • Supports permission-only protection mode when userPassword is left empty.
• 100% Unselectable Image XObject Watermark:
  • Replaced live text glyphs with transparent Chromium-rendered PNG buffers embedded via pdfDoc.drawImage() as PDF Image XObjects.
  • Eliminates 100% of selectable text stream tokens (Tj/TJ), preventing any cursor interference or unwanted text highlights during document review.
  • Automatically centered diagonally (rotate: -45) across content pages and excluded from Front Cover and Back Cover.
• Cover Page Builder with Company Logo Embedding (coverPage):
  • Four enterprise design presets: modern, corporate-split, minimal, and card.
  • Native image embedding for brand logos across DOCX, PDF, and HTML with configurable logoWidth.
  • Generates dedicated unnumbered first sections in Microsoft Word DOCX and suppresses running headers/footers via CSS @page :first in PDF.
• Back Cover / Closing Page Builder (backCover):
  • Four closing design presets: modern, corporate, minimal, and contact-card.
  • Full-bleed edge-to-edge dark closing card in PDF and isolated final section in DOCX.
  • Company profile grid including address, email, phone, website, and social links.
• Math & LaTeX Equation Rendering (math):
  • Native KaTeX in-memory math parsing for inline formulas ($E=mc^2$) and display block equations ($$\int e^x dx$$).
  • Self-contained inlined KaTeX CSS for zero-network HTML and PDF generation.
  • Cambria Math typography and shaded equation containers in Microsoft Word DOCX.
• Multi-Column Container Directives (:::columns, :::col):
  • Multi-column container syntax with configurable columns count and gap (:::columns 2 or :::columns [cols=3 gap=2rem]).
  • Emitted as CSS Grid layouts in HTML/PDF and native borderless multi-cell table structures in DOCX.
• Hierarchical Section Numbering (numberHeadings):
  • Automated decimal heading prefixes (1., 1.1., 1.1.1.) with configurable depth and optional H1 skip.
  • Synchronized Table of Contents entries and anchor slugs.
• Footnotes & Endnotes ([^1], [^1]: text):
  • Markdown footnote references ([^id]) and bottom definition parsing.
  • Formatted as superscripts with return links in HTML/PDF and dedicated numbered sections in Word DOCX.
• Windows Enterprise & Strict Corporate Policy Compliance:
  • Prioritizes Microsoft Edge (msedge.exe) with AppLocker and GPO whitelist compatibility.
  • Isolated process arguments without suspicious flags (--disable-sync, isolated temp profile).
  • Added windowsHide: true on child processes to eliminate console prompt flashes on Windows.
• Interactive Live-Reload Preview Server (markforge --serve):
  • Real-time Server-Sent Events (SSE) /events broadcast on file or config changes.
  • Automatic scroll position and reading preservation across live reloads.

---

[0.3.0] - 2026-08-29

Features & Enhancements

• Comprehensive Programmatic API Suite:
  • Added full programmatic compilation examples in apps/cli/markforge/examples/:
    • 1-minimal.ts: Zero-configuration Markdown-to-MultiFormat execution.
    • 2-intermediate.ts: Themes, syntax palettes, TOC, and live progress callbacks.
    • 3-full-custom.ts: 100% feature utilization including dynamic tokens, per-zone header/footer slots, watermarks, signatures, and ThemeProps.
    • 4-low-level-ast.ts: Direct in-memory binary Buffer generation (DOCX, PDF, and HTML) without writing to disk.
• Terminal CLI ASCII Redesign & Author Branding:
  • Modernized Ink CLI layout with clean ASCII borders and tree-style file summaries.
  • Added author attribution (Author: Ma'sum (@masumrpg)) and direct repository links.
  • Removed all emojis across CLI terminal outputs for maximum shell compatibility.
• Author Identity & Workspace Normalization:
  • Normalized author identity to Ma'sum and updated GitHub profiles to https://github.com/masumrpg.

---

[0.2.5] - 2026-08-29

Features & Enhancements

• Document Signatures & Approval Blocks (signatures):
  • Add formal approval and sign-off blocks with 1 to 4 signatory slots.
  • Multi-alignment support (left, center, right, space-between).
  • Multiple visual styles: line (classic underline divider), box (bordered card), and clean (borderless).
  • Dynamic token interpolation ({author}, {company}, {date}) and optional digital signature image/seal embedding.
• Native Word Paragraph TabStops for Running Headers & Footers:
  • Replaced 3-column table headers and footers with native Microsoft Word OpenXML TabStopType.CENTER and TabStopType.RIGHT paragraph architecture.
  • Eliminates 100% of table gridline boundaries in LibreOffice Writer, Google Docs, and Microsoft Word when dividers are disabled.
• Synchronized Header & Footer Divider Lines:
  • Solid horizontal separator lines render cleanly via border.bottom / border.top on Word paragraphs and fixed print dividers (@media print) on Chromium PDF.
• DOCX Visual & Typography Overhaul:
  • Enhanced title area with 22pt bold title, 12pt subtitle, and bottom border.
  • Auto-generated Table of Contents card with shaded container (#F8FAFC, border #E2E8F0).
  • Shaded zebra table rows with alternating fills.

---

[0.2.4] - 2026-08-29

Features & Enhancements

• Granular Header & Footer Slot Customization (HeaderFooterSlot):
  • Each running header and footer zone (left, center, right) can now be individually styled with custom color, fontSize (in points), fontFamily, bold, and italic.
  • Fully implemented across DOCX TextRuns and PDF CSS Paged Media (@top-* and @bottom-*).
• Flagship Theme.CORPORATE Preset & ThemeProps Interface:
  • Simplified built-in themes to Theme.CORPORATE while providing the typed ThemeProps interface for total custom document theming (backgroundColor, textColor, primaryColor, fontFamily, fontMono, customCss).
• TypeScript Enums:
  • Full autocompletion and type-safety with OutputFormat, Theme, Orientation, PaperSizeEnum, SyntaxTheme, and WatermarkPosition.
• Background-Layered Watermark:
  • Watermarks are positioned strictly at the background layer (z-index: 0) under content to avoid obscuring tables, text, or images.

---

[0.1.0] - 2026-08-28

Initial Release

• Core markdown parser supporting standard CommonMark and GitHub Flavored Markdown (GFM).
• Binary DOCX document builder using docx library.
• Pixel-perfect PDF generation via headless Chromium.
• Standalone HTML document generator with embedded CSS tokens.
• Syntax highlighting engine with customizable palettes.
• Mermaid diagram parser and image renderer.