@masumdev/markforge 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,344 @@
+type MarkforgeFormat = "docx" | "pdf" | "html" | "png";
+type MarkforgeTheme = "default" | "academic" | "github" | "corporate" | "minimal" | "dracula" | (string & {});
+type DocumentOrientation = "portrait" | "landscape";
+type PaperSize = "A4" | "Letter" | "Legal" | "A3" | "A5";
+interface PageMargins {
+    top?: string | number;
+    bottom?: string | number;
+    left?: string | number;
+    right?: string | number;
+}
+interface HeaderFooterItem {
+    left?: string;
+    center?: string;
+    right?: string;
+    font?: string;
+    size?: number;
+    color?: string;
+    divider?: boolean;
+}
+interface WatermarkOptions {
+    text: string;
+    color?: string;
+    opacity?: number;
+    fontSize?: number;
+    rotate?: number;
+    position?: "diagonal" | "center" | "top-right" | "bottom-right";
+}
+interface FrontmatterMetadata {
+    title?: string;
+    subtitle?: string;
+    author?: string | string[];
+    date?: string;
+    version?: string;
+    theme?: MarkforgeTheme;
+    orientation?: DocumentOrientation;
+    paperSize?: PaperSize;
+    margins?: PageMargins;
+    header?: HeaderFooterItem;
+    footer?: HeaderFooterItem;
+    toc?: boolean;
+    watermark?: string | WatermarkOptions | false;
+    css?: string | string[];
+    coverPage?: boolean;
+    lang?: string;
+    [key: string]: unknown;
+}
+interface MarkforgeConfig {
+    /**
+     * Target format(s) to compile markdown to.
+     * @default ["docx", "pdf"]
+     */
+    to?: MarkforgeFormat | MarkforgeFormat[];
+    /**
+     * Output directory where compiled documents will be saved.
+     * Defaults to the same directory as the input file.
+     */
+    outputDir?: string;
+    /**
+     * Built-in visual theme name.
+     * @default "default"
+     */
+    theme?: MarkforgeTheme;
+    /**
+     * Path(s) to custom CSS stylesheets to inject into the document.
+     */
+    css?: string | string[];
+    /**
+     * Page orientation.
+     * @default "portrait"
+     */
+    orientation?: DocumentOrientation;
+    /**
+     * Paper size.
+     * @default "A4"
+     */
+    paperSize?: PaperSize;
+    /**
+     * Custom page margins.
+     */
+    margins?: PageMargins;
+    /**
+     * Header template configuration.
+     */
+    header?: HeaderFooterItem;
+    /**
+     * Footer template configuration.
+     */
+    footer?: HeaderFooterItem;
+    /**
+     * Whether to automatically generate a Table of Contents (TOC).
+     * @default false
+     */
+    toc?: boolean;
+    /**
+     * Optional watermark configuration to display across pages.
+     * By default, no watermark is displayed.
+     */
+    watermark?: string | WatermarkOptions | false;
+    /**
+     * Whether to embed all images (local and remote) directly into the document.
+     * @default true
+     */
+    embedImages?: boolean;
+    /**
+     * Custom metadata overrides for title, author, date, etc.
+     */
+    metadata?: Partial<FrontmatterMetadata>;
+    /**
+     * Watch files and automatically recompile on changes.
+     * @default false
+     */
+    watch?: boolean;
+    /**
+     * Start local HTTP preview server.
+     * @default false
+     */
+    serve?: boolean;
+    /**
+     * Port for the local preview server.
+     * @default 4000
+     */
+    port?: number;
+    /**
+     * Automatically open the document in the default browser upon compilation.
+     * @default false
+     */
+    open?: boolean;
+    /**
+     * Whether to generate standalone self-contained HTML bundle.
+     * @default true
+     */
+    bundleHtml?: boolean;
+    /**
+     * Code syntax highlighting theme.
+     * @default "github-dark"
+     */
+    syntaxTheme?: string;
+}
+interface GeneratedOutputFile {
+    format: MarkforgeFormat;
+    filePath: string;
+    fileName: string;
+    sizeBytes: number;
+}
+interface CompilationResult {
+    inputFile: string;
+    durationMs: number;
+    metadata: FrontmatterMetadata;
+    files: GeneratedOutputFile[];
+    errors: string[];
+}
+
+/**
+ * Formats local timestamp with timezone offset.
+ */
+declare function formatServerTimestamp(date?: Date): string;
+/**
+ * Compiles a markdown or MDX file into the specified document formats.
+ */
+declare function compileMarkdown(inputFilePathOrContent: string, userConfig?: MarkforgeConfig, onProgress?: (msg: string) => void): Promise<CompilationResult>;
+
+type MarkdownNodeType = "heading" | "paragraph" | "blockquote" | "callout" | "list" | "listItem" | "table" | "tableRow" | "tableCell" | "codeBlock" | "mermaid" | "htmlBlock" | "thematicBreak" | "image" | "toc";
+interface MarkdownInlineSpan {
+    type: "text" | "bold" | "italic" | "code" | "link" | "strikethrough" | "image" | "htmlInline";
+    content: string;
+    url?: string;
+    title?: string;
+    alt?: string;
+    width?: number | string;
+    height?: number | string;
+    children?: MarkdownInlineSpan[];
+    style?: Record<string, string>;
+}
+interface MarkdownASTNode {
+    type: MarkdownNodeType;
+    level?: number;
+    ordered?: boolean;
+    checked?: boolean;
+    language?: string;
+    calloutType?: "NOTE" | "TIP" | "IMPORTANT" | "WARNING" | "CAUTION";
+    align?: ("left" | "center" | "right" | null)[];
+    isHeader?: boolean;
+    inlines?: MarkdownInlineSpan[];
+    text?: string;
+    children?: MarkdownASTNode[];
+    rawHtml?: string;
+    id?: string;
+    style?: Record<string, string>;
+}
+interface ParsedMarkdownDocument {
+    metadata: FrontmatterMetadata;
+    content: string;
+    nodes: MarkdownASTNode[];
+    tocEntries: {
+        id: string;
+        text: string;
+        level: number;
+    }[];
+    inlinedStyles: string[];
+}
+/**
+ * Parses inline formatting (bold, italic, code, links, images, HTML spans)
+ */
+declare function parseInlineSpans(text: string): MarkdownInlineSpan[];
+/**
+ * Extracts slug from heading text for TOC & anchor links.
+ */
+declare function slugify(text: string): string;
+/**
+ * Parses raw markdown string into rich structured AST nodes.
+ */
+declare function parseMarkdownDocument(rawMarkdown: string): ParsedMarkdownDocument;
+
+/**
+ * Converts CSS margin string (e.g. "2.5cm", "1in", "20mm", 1440) to Word Twips.
+ */
+declare function parseMarginToTwip(margin?: string | number, defaultTwip?: number): number;
+/**
+ * Builds a complete docx.Document from a parsed Markdown document.
+ */
+declare function buildDocxDocument(doc: ParsedMarkdownDocument, config: MarkforgeConfig, baseDir?: string): Promise<Buffer>;
+
+/**
+ * Escapes HTML characters safely.
+ */
+declare function escapeHtml(str: string): string;
+/**
+ * Converts Markdown inline spans to HTML markup.
+ */
+declare function renderInlinesToHtml(spans?: MarkdownInlineSpan[], baseDir?: string): Promise<string>;
+/**
+ * Builds standalone self-contained HTML from a parsed Markdown document.
+ */
+declare function buildHtmlDocument(doc: ParsedMarkdownDocument, config: MarkforgeConfig, baseDir?: string): Promise<string>;
+
+/**
+ * Finds available Chrome or Chromium binary for headless PDF rendering.
+ */
+declare function findChromeExecutable(): string | null;
+/**
+ * Injects CSS Paged Media styles into HTML for print & PDF formatting.
+ */
+declare function injectPagedMediaStyles(html: string, config: MarkforgeConfig, metadata?: Record<string, unknown>): string;
+/**
+ * Builds a true binary PDF document from parsed Markdown.
+ */
+declare function buildPdfDocument(doc: ParsedMarkdownDocument, config: MarkforgeConfig, baseDir?: string): Promise<Buffer>;
+
+interface ResolvedImage {
+    src: string;
+    buffer: Buffer;
+    mimeType: string;
+    width?: number;
+    height?: number;
+    dataUri: string;
+    isSvg: boolean;
+}
+/**
+ * Infers MIME type from file extension or data URI header.
+ */
+declare function getMimeType(filePathOrUrl: string): string;
+/**
+ * Resolves an image source (relative path, remote URL, or base64 data URI) into a binary buffer.
+ */
+declare function resolveImage(src: string, baseDir?: string): Promise<ResolvedImage | null>;
+/**
+ * Inlines all image sources in an HTML string with Base64 data URIs.
+ */
+declare function inlineHtmlImages(html: string, baseDir?: string): Promise<string>;
+
+/**
+ * MarkForge Syntax Highlighter Engine
+ * Provides tokenizer & styling for Markdown code blocks across DOCX, HTML, and PDF.
+ */
+interface SyntaxToken {
+    text: string;
+    type: "keyword" | "string" | "comment" | "number" | "boolean" | "function" | "type" | "operator" | "punctuation" | "plain";
+    colorHex: string;
+    bold?: boolean;
+    italic?: boolean;
+}
+declare const SYNTAX_COLORS: {
+    keyword: string;
+    string: string;
+    comment: string;
+    number: string;
+    boolean: string;
+    function: string;
+    type: string;
+    operator: string;
+    punctuation: string;
+    plain: string;
+};
+/**
+ * Tokenizes a single line of code into styled tokens based on language.
+ */
+declare function tokenizeCodeLine(line: string, lang?: string, theme?: "dark" | "light"): SyntaxToken[];
+/**
+ * Converts a code snippet to syntax-highlighted HTML with colored span tokens.
+ */
+declare function highlightCodeToHtml(code: string, lang?: string): string;
+
+/**
+ * Renders Mermaid diagram definition into an SVG/PNG buffer for DOCX and HTML embedding.
+ */
+declare function renderMermaidToPng(mermaidCode: string, _baseDir?: string): Promise<Buffer | null>;
+
+/**
+ * Default theme — full design system with Blu-by-BCA-Digital cyan palette.
+ */
+declare const THEME_DEFAULT = "\n:root {\n  --mf-bg: #ffffff;\n  --mf-text: #0f172a;\n  --mf-text-muted: #64748b;\n  --mf-primary: #33CDCF;\n  --mf-primary-dark: #009DA0;\n  --mf-primary-light: #ECFDFD;\n  --mf-border: #e2e8f0;\n  --mf-card-bg: #f8fafc;\n  --mf-code-bg: #0f172a;\n  --mf-code-text: #f8fafc;\n  --mf-font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;\n  --mf-font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;\n}\nbody { 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; }\n.document-container { max-width: 860px; margin: 0 auto; }\nh1, h2, h3, h4, h5, h6 { color: var(--mf-text); font-weight: 700; margin-top: 1.8rem; margin-bottom: 0.8rem; line-height: 1.25; }\nh1 { font-size: 2.2rem; border-bottom: 2px solid #33CDCF; padding-bottom: 0.5rem; }\nh2 { font-size: 1.6rem; color: #009DA0; border-bottom: 1px solid #CCFBF1; padding-bottom: 0.4rem; }\nh3 { font-size: 1.3rem; }\nh4 { font-size: 1.1rem; }\np  { margin: 0.8rem 0; }\n";
+/**
+ * Academic theme — serif typography for formal papers/reports.
+ */
+declare const THEME_ACADEMIC = "\n:root {\n  --mf-bg: #ffffff;\n  --mf-text: #1a1a1a;\n  --mf-text-muted: #555;\n  --mf-primary: #33CDCF;\n  --mf-primary-dark: #009DA0;\n  --mf-primary-light: #ECFDFD;\n  --mf-border: #ccc;\n  --mf-card-bg: #f9f9f9;\n  --mf-code-bg: #1e1e1e;\n  --mf-code-text: #d4d4d4;\n  --mf-font-family: \"Merriweather\", \"Georgia\", \"Times New Roman\", serif;\n  --mf-font-mono: \"Courier New\", Courier, monospace;\n}\nbody { font-family: var(--mf-font-family); font-size: 16px; line-height: 1.8; padding: 3rem; color: var(--mf-text); }\n.document-container { max-width: 780px; margin: 0 auto; text-align: justify; }\nh1, h2, h3 { font-family: \"Times New Roman\", Times, serif; font-weight: bold; text-align: left; }\nh1 { font-size: 2rem; border-bottom: 1px solid #000; padding-bottom: 0.3rem; }\nh2 { font-size: 1.4rem; border-bottom: 1px solid #ccc; padding-bottom: 0.2rem; }\nh3 { font-size: 1.2rem; }\np  { margin: 0.9rem 0; }\n";
+declare const THEMES: Record<string, string>;
+
+/**
+ * Type-safe configuration helper for markforge.config.ts
+ */
+declare function defineConfig(config: MarkforgeConfig): MarkforgeConfig;
+
+declare const DEFAULT_CONFIG: Required<Omit<MarkforgeConfig, "outputDir" | "css" | "margins" | "header" | "footer" | "watermark" | "metadata" | "syntaxTheme">> & {
+    outputDir?: string;
+    css?: string | string[];
+    margins?: MarkforgeConfig["margins"];
+    header?: MarkforgeConfig["header"];
+    footer?: MarkforgeConfig["footer"];
+    watermark?: string;
+    metadata?: MarkforgeConfig["metadata"];
+    syntaxTheme?: string;
+};
+/**
+ * Resolves and loads markforge configuration from disk.
+ */
+declare function loadConfig(customPath?: string, cwd?: string): Promise<{
+    config: MarkforgeConfig;
+    configPath: string | null;
+}>;
+
+declare const MARKFORGE_VERSION = "0.1.0";
+declare function getMarkforgeVersion(fromDir?: string): string;
+
+export { type CompilationResult, DEFAULT_CONFIG, type DocumentOrientation, type FrontmatterMetadata, type GeneratedOutputFile, type HeaderFooterItem, MARKFORGE_VERSION, type MarkdownASTNode, type MarkdownInlineSpan, type MarkdownNodeType, type MarkforgeConfig, type MarkforgeFormat, type MarkforgeTheme, type PageMargins, type PaperSize, type ParsedMarkdownDocument, type ResolvedImage, SYNTAX_COLORS, type SyntaxToken, THEMES, THEME_ACADEMIC, THEME_DEFAULT, type WatermarkOptions, buildDocxDocument, buildHtmlDocument, buildPdfDocument, compileMarkdown, defineConfig, escapeHtml, findChromeExecutable, formatServerTimestamp, getMarkforgeVersion, getMimeType, highlightCodeToHtml, injectPagedMediaStyles, inlineHtmlImages, loadConfig, compileMarkdown as markforge, parseInlineSpans, parseMarginToTwip, parseMarkdownDocument, renderInlinesToHtml, renderMermaidToPng, resolveImage, slugify, tokenizeCodeLine };

package/dist/index.d.ts

@@ -0,0 +1,344 @@
+type MarkforgeFormat = "docx" | "pdf" | "html" | "png";
+type MarkforgeTheme = "default" | "academic" | "github" | "corporate" | "minimal" | "dracula" | (string & {});
+type DocumentOrientation = "portrait" | "landscape";
+type PaperSize = "A4" | "Letter" | "Legal" | "A3" | "A5";
+interface PageMargins {
+    top?: string | number;
+    bottom?: string | number;
+    left?: string | number;
+    right?: string | number;
+}
+interface HeaderFooterItem {
+    left?: string;
+    center?: string;
+    right?: string;
+    font?: string;
+    size?: number;
+    color?: string;
+    divider?: boolean;
+}
+interface WatermarkOptions {
+    text: string;
+    color?: string;
+    opacity?: number;
+    fontSize?: number;
+    rotate?: number;
+    position?: "diagonal" | "center" | "top-right" | "bottom-right";
+}
+interface FrontmatterMetadata {
+    title?: string;
+    subtitle?: string;
+    author?: string | string[];
+    date?: string;
+    version?: string;
+    theme?: MarkforgeTheme;
+    orientation?: DocumentOrientation;
+    paperSize?: PaperSize;
+    margins?: PageMargins;
+    header?: HeaderFooterItem;
+    footer?: HeaderFooterItem;
+    toc?: boolean;
+    watermark?: string | WatermarkOptions | false;
+    css?: string | string[];
+    coverPage?: boolean;
+    lang?: string;
+    [key: string]: unknown;
+}
+interface MarkforgeConfig {
+    /**
+     * Target format(s) to compile markdown to.
+     * @default ["docx", "pdf"]
+     */
+    to?: MarkforgeFormat | MarkforgeFormat[];
+    /**
+     * Output directory where compiled documents will be saved.
+     * Defaults to the same directory as the input file.
+     */
+    outputDir?: string;
+    /**
+     * Built-in visual theme name.
+     * @default "default"
+     */
+    theme?: MarkforgeTheme;
+    /**
+     * Path(s) to custom CSS stylesheets to inject into the document.
+     */
+    css?: string | string[];
+    /**
+     * Page orientation.
+     * @default "portrait"
+     */
+    orientation?: DocumentOrientation;
+    /**
+     * Paper size.
+     * @default "A4"
+     */
+    paperSize?: PaperSize;
+    /**
+     * Custom page margins.
+     */
+    margins?: PageMargins;
+    /**
+     * Header template configuration.
+     */
+    header?: HeaderFooterItem;
+    /**
+     * Footer template configuration.
+     */
+    footer?: HeaderFooterItem;
+    /**
+     * Whether to automatically generate a Table of Contents (TOC).
+     * @default false
+     */
+    toc?: boolean;
+    /**
+     * Optional watermark configuration to display across pages.
+     * By default, no watermark is displayed.
+     */
+    watermark?: string | WatermarkOptions | false;
+    /**
+     * Whether to embed all images (local and remote) directly into the document.
+     * @default true
+     */
+    embedImages?: boolean;
+    /**
+     * Custom metadata overrides for title, author, date, etc.
+     */
+    metadata?: Partial<FrontmatterMetadata>;
+    /**
+     * Watch files and automatically recompile on changes.
+     * @default false
+     */
+    watch?: boolean;
+    /**
+     * Start local HTTP preview server.
+     * @default false
+     */
+    serve?: boolean;
+    /**
+     * Port for the local preview server.
+     * @default 4000
+     */
+    port?: number;
+    /**
+     * Automatically open the document in the default browser upon compilation.
+     * @default false
+     */
+    open?: boolean;
+    /**
+     * Whether to generate standalone self-contained HTML bundle.
+     * @default true
+     */
+    bundleHtml?: boolean;
+    /**
+     * Code syntax highlighting theme.
+     * @default "github-dark"
+     */
+    syntaxTheme?: string;
+}
+interface GeneratedOutputFile {
+    format: MarkforgeFormat;
+    filePath: string;
+    fileName: string;
+    sizeBytes: number;
+}
+interface CompilationResult {
+    inputFile: string;
+    durationMs: number;
+    metadata: FrontmatterMetadata;
+    files: GeneratedOutputFile[];
+    errors: string[];
+}
+
+/**
+ * Formats local timestamp with timezone offset.
+ */
+declare function formatServerTimestamp(date?: Date): string;
+/**
+ * Compiles a markdown or MDX file into the specified document formats.
+ */
+declare function compileMarkdown(inputFilePathOrContent: string, userConfig?: MarkforgeConfig, onProgress?: (msg: string) => void): Promise<CompilationResult>;
+
+type MarkdownNodeType = "heading" | "paragraph" | "blockquote" | "callout" | "list" | "listItem" | "table" | "tableRow" | "tableCell" | "codeBlock" | "mermaid" | "htmlBlock" | "thematicBreak" | "image" | "toc";
+interface MarkdownInlineSpan {
+    type: "text" | "bold" | "italic" | "code" | "link" | "strikethrough" | "image" | "htmlInline";
+    content: string;
+    url?: string;
+    title?: string;
+    alt?: string;
+    width?: number | string;
+    height?: number | string;
+    children?: MarkdownInlineSpan[];
+    style?: Record<string, string>;
+}
+interface MarkdownASTNode {
+    type: MarkdownNodeType;
+    level?: number;
+    ordered?: boolean;
+    checked?: boolean;
+    language?: string;
+    calloutType?: "NOTE" | "TIP" | "IMPORTANT" | "WARNING" | "CAUTION";
+    align?: ("left" | "center" | "right" | null)[];
+    isHeader?: boolean;
+    inlines?: MarkdownInlineSpan[];
+    text?: string;
+    children?: MarkdownASTNode[];
+    rawHtml?: string;
+    id?: string;
+    style?: Record<string, string>;
+}
+interface ParsedMarkdownDocument {
+    metadata: FrontmatterMetadata;
+    content: string;
+    nodes: MarkdownASTNode[];
+    tocEntries: {
+        id: string;
+        text: string;
+        level: number;
+    }[];
+    inlinedStyles: string[];
+}
+/**
+ * Parses inline formatting (bold, italic, code, links, images, HTML spans)
+ */
+declare function parseInlineSpans(text: string): MarkdownInlineSpan[];
+/**
+ * Extracts slug from heading text for TOC & anchor links.
+ */
+declare function slugify(text: string): string;
+/**
+ * Parses raw markdown string into rich structured AST nodes.
+ */
+declare function parseMarkdownDocument(rawMarkdown: string): ParsedMarkdownDocument;
+
+/**
+ * Converts CSS margin string (e.g. "2.5cm", "1in", "20mm", 1440) to Word Twips.
+ */
+declare function parseMarginToTwip(margin?: string | number, defaultTwip?: number): number;
+/**
+ * Builds a complete docx.Document from a parsed Markdown document.
+ */
+declare function buildDocxDocument(doc: ParsedMarkdownDocument, config: MarkforgeConfig, baseDir?: string): Promise<Buffer>;
+
+/**
+ * Escapes HTML characters safely.
+ */
+declare function escapeHtml(str: string): string;
+/**
+ * Converts Markdown inline spans to HTML markup.
+ */
+declare function renderInlinesToHtml(spans?: MarkdownInlineSpan[], baseDir?: string): Promise<string>;
+/**
+ * Builds standalone self-contained HTML from a parsed Markdown document.
+ */
+declare function buildHtmlDocument(doc: ParsedMarkdownDocument, config: MarkforgeConfig, baseDir?: string): Promise<string>;
+
+/**
+ * Finds available Chrome or Chromium binary for headless PDF rendering.
+ */
+declare function findChromeExecutable(): string | null;
+/**
+ * Injects CSS Paged Media styles into HTML for print & PDF formatting.
+ */
+declare function injectPagedMediaStyles(html: string, config: MarkforgeConfig, metadata?: Record<string, unknown>): string;
+/**
+ * Builds a true binary PDF document from parsed Markdown.
+ */
+declare function buildPdfDocument(doc: ParsedMarkdownDocument, config: MarkforgeConfig, baseDir?: string): Promise<Buffer>;
+
+interface ResolvedImage {
+    src: string;
+    buffer: Buffer;
+    mimeType: string;
+    width?: number;
+    height?: number;
+    dataUri: string;
+    isSvg: boolean;
+}
+/**
+ * Infers MIME type from file extension or data URI header.
+ */
+declare function getMimeType(filePathOrUrl: string): string;
+/**
+ * Resolves an image source (relative path, remote URL, or base64 data URI) into a binary buffer.
+ */
+declare function resolveImage(src: string, baseDir?: string): Promise<ResolvedImage | null>;
+/**
+ * Inlines all image sources in an HTML string with Base64 data URIs.
+ */
+declare function inlineHtmlImages(html: string, baseDir?: string): Promise<string>;
+
+/**
+ * MarkForge Syntax Highlighter Engine
+ * Provides tokenizer & styling for Markdown code blocks across DOCX, HTML, and PDF.
+ */
+interface SyntaxToken {
+    text: string;
+    type: "keyword" | "string" | "comment" | "number" | "boolean" | "function" | "type" | "operator" | "punctuation" | "plain";
+    colorHex: string;
+    bold?: boolean;
+    italic?: boolean;
+}
+declare const SYNTAX_COLORS: {
+    keyword: string;
+    string: string;
+    comment: string;
+    number: string;
+    boolean: string;
+    function: string;
+    type: string;
+    operator: string;
+    punctuation: string;
+    plain: string;
+};
+/**
+ * Tokenizes a single line of code into styled tokens based on language.
+ */
+declare function tokenizeCodeLine(line: string, lang?: string, theme?: "dark" | "light"): SyntaxToken[];
+/**
+ * Converts a code snippet to syntax-highlighted HTML with colored span tokens.
+ */
+declare function highlightCodeToHtml(code: string, lang?: string): string;
+
+/**
+ * Renders Mermaid diagram definition into an SVG/PNG buffer for DOCX and HTML embedding.
+ */
+declare function renderMermaidToPng(mermaidCode: string, _baseDir?: string): Promise<Buffer | null>;
+
+/**
+ * Default theme — full design system with Blu-by-BCA-Digital cyan palette.
+ */
+declare const THEME_DEFAULT = "\n:root {\n  --mf-bg: #ffffff;\n  --mf-text: #0f172a;\n  --mf-text-muted: #64748b;\n  --mf-primary: #33CDCF;\n  --mf-primary-dark: #009DA0;\n  --mf-primary-light: #ECFDFD;\n  --mf-border: #e2e8f0;\n  --mf-card-bg: #f8fafc;\n  --mf-code-bg: #0f172a;\n  --mf-code-text: #f8fafc;\n  --mf-font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;\n  --mf-font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;\n}\nbody { 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; }\n.document-container { max-width: 860px; margin: 0 auto; }\nh1, h2, h3, h4, h5, h6 { color: var(--mf-text); font-weight: 700; margin-top: 1.8rem; margin-bottom: 0.8rem; line-height: 1.25; }\nh1 { font-size: 2.2rem; border-bottom: 2px solid #33CDCF; padding-bottom: 0.5rem; }\nh2 { font-size: 1.6rem; color: #009DA0; border-bottom: 1px solid #CCFBF1; padding-bottom: 0.4rem; }\nh3 { font-size: 1.3rem; }\nh4 { font-size: 1.1rem; }\np  { margin: 0.8rem 0; }\n";
+/**
+ * Academic theme — serif typography for formal papers/reports.
+ */
+declare const THEME_ACADEMIC = "\n:root {\n  --mf-bg: #ffffff;\n  --mf-text: #1a1a1a;\n  --mf-text-muted: #555;\n  --mf-primary: #33CDCF;\n  --mf-primary-dark: #009DA0;\n  --mf-primary-light: #ECFDFD;\n  --mf-border: #ccc;\n  --mf-card-bg: #f9f9f9;\n  --mf-code-bg: #1e1e1e;\n  --mf-code-text: #d4d4d4;\n  --mf-font-family: \"Merriweather\", \"Georgia\", \"Times New Roman\", serif;\n  --mf-font-mono: \"Courier New\", Courier, monospace;\n}\nbody { font-family: var(--mf-font-family); font-size: 16px; line-height: 1.8; padding: 3rem; color: var(--mf-text); }\n.document-container { max-width: 780px; margin: 0 auto; text-align: justify; }\nh1, h2, h3 { font-family: \"Times New Roman\", Times, serif; font-weight: bold; text-align: left; }\nh1 { font-size: 2rem; border-bottom: 1px solid #000; padding-bottom: 0.3rem; }\nh2 { font-size: 1.4rem; border-bottom: 1px solid #ccc; padding-bottom: 0.2rem; }\nh3 { font-size: 1.2rem; }\np  { margin: 0.9rem 0; }\n";
+declare const THEMES: Record<string, string>;
+
+/**
+ * Type-safe configuration helper for markforge.config.ts
+ */
+declare function defineConfig(config: MarkforgeConfig): MarkforgeConfig;
+
+declare const DEFAULT_CONFIG: Required<Omit<MarkforgeConfig, "outputDir" | "css" | "margins" | "header" | "footer" | "watermark" | "metadata" | "syntaxTheme">> & {
+    outputDir?: string;
+    css?: string | string[];
+    margins?: MarkforgeConfig["margins"];
+    header?: MarkforgeConfig["header"];
+    footer?: MarkforgeConfig["footer"];
+    watermark?: string;
+    metadata?: MarkforgeConfig["metadata"];
+    syntaxTheme?: string;
+};
+/**
+ * Resolves and loads markforge configuration from disk.
+ */
+declare function loadConfig(customPath?: string, cwd?: string): Promise<{
+    config: MarkforgeConfig;
+    configPath: string | null;
+}>;
+
+declare const MARKFORGE_VERSION = "0.1.0";
+declare function getMarkforgeVersion(fromDir?: string): string;
+
+export { type CompilationResult, DEFAULT_CONFIG, type DocumentOrientation, type FrontmatterMetadata, type GeneratedOutputFile, type HeaderFooterItem, MARKFORGE_VERSION, type MarkdownASTNode, type MarkdownInlineSpan, type MarkdownNodeType, type MarkforgeConfig, type MarkforgeFormat, type MarkforgeTheme, type PageMargins, type PaperSize, type ParsedMarkdownDocument, type ResolvedImage, SYNTAX_COLORS, type SyntaxToken, THEMES, THEME_ACADEMIC, THEME_DEFAULT, type WatermarkOptions, buildDocxDocument, buildHtmlDocument, buildPdfDocument, compileMarkdown, defineConfig, escapeHtml, findChromeExecutable, formatServerTimestamp, getMarkforgeVersion, getMimeType, highlightCodeToHtml, injectPagedMediaStyles, inlineHtmlImages, loadConfig, compileMarkdown as markforge, parseInlineSpans, parseMarginToTwip, parseMarkdownDocument, renderInlinesToHtml, renderMermaidToPng, resolveImage, slugify, tokenizeCodeLine };