@speajus/markdown-to-pdf 1.0.12 → 1.0.13

package/dist/browser.d.ts

@@ -1,6 +1,9 @@
+/**
+ * Browser-specific entry point that excludes Node.js dependencies
+ */
 export { createBrowserImageRenderer } from "./browser-image-renderer.js";
 export { createBrowserColorEmojiRenderer } from './color-emoji.js';
-export type { TextStyle, PageLayout, CodeStyle, CodeBlockStyle, BlockquoteStyle, TableStyles, TokenColors, SyntaxHighlightTheme, ThemeConfig, PdfOptions, ColorEmojiRenderer, } from './types.js';
+export type { TextStyle, PageLayout, CodeStyle, CodeBlockStyle, BlockquoteStyle, TableStyles, TokenColors, SyntaxHighlightTheme, ThemeConfig, PdfOptions, ColorEmojiRenderer, CustomFontDefinition, } from './types.js';
 export { defaultTheme, defaultPageLayout, defaultSyntaxHighlightTheme } from './styles.js';
 export { themes, modernTheme, academicTheme, minimalTheme, oceanTheme } from './themes/index.js';
 export { renderMarkdownToPdf } from "./renderer.js";

package/dist/browser.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderMarkdownToPdf = exports.oceanTheme = exports.minimalTheme = exports.academicTheme = exports.modernTheme = exports.themes = exports.defaultSyntaxHighlightTheme = exports.defaultPageLayout = exports.defaultTheme = exports.createBrowserColorEmojiRenderer = exports.createBrowserImageRenderer = void 0;
+/**
+ * Browser-specific entry point that excludes Node.js dependencies
+ */
 var browser_image_renderer_js_1 = require("./browser-image-renderer.js");
 Object.defineProperty(exports, "createBrowserImageRenderer", { enumerable: true, get: function () { return browser_image_renderer_js_1.createBrowserImageRenderer; } });
 var color_emoji_js_1 = require("./color-emoji.js");

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { TextStyle, PageLayout, CodeStyle, CodeBlockStyle, BlockquoteStyle, TableStyles, TokenColors, SyntaxHighlightTheme, ThemeConfig, PdfOptions, ColorEmojiRenderer, } from './types.js';
+export type { TextStyle, PageLayout, CodeStyle, CodeBlockStyle, BlockquoteStyle, TableStyles, TokenColors, SyntaxHighlightTheme, ThemeConfig, PdfOptions, ColorEmojiRenderer, CustomFontDefinition, } from './types.js';
 export { defaultTheme, defaultPageLayout, defaultSyntaxHighlightTheme } from './styles.js';
 export { renderMarkdownToPdf as generatePdf, renderMarkdownToPdf, } from "./renderer.js";
 export { createBrowserImageRenderer } from './browser-image-renderer.js';

package/dist/renderer.js

@@ -67,6 +67,26 @@ async function renderMarkdownToPdf(markdown, options) {
             // fall through without emoji support.
         }
     }
+    // ── Custom font registration ─────────────────────────────────────────────
+    // Register user-supplied font families so they can be referenced by name
+    // in ThemeConfig font fields.  Each variant is registered with a suffix:
+    //   name (regular), name-Bold, name-Italic, name-BoldItalic
+    // Missing variants fall back: boldItalic → bold → regular, italic → regular.
+    const customFontNames = new Set();
+    if (options?.customFonts) {
+        for (const cf of options.customFonts) {
+            try {
+                doc.registerFont(cf.name, cf.regular);
+                doc.registerFont(`${cf.name}-Bold`, cf.bold ?? cf.regular);
+                doc.registerFont(`${cf.name}-Italic`, cf.italic ?? cf.regular);
+                doc.registerFont(`${cf.name}-BoldItalic`, cf.boldItalic ?? cf.bold ?? cf.regular);
+                customFontNames.add(cf.name);
+            }
+            catch {
+                // Font registration failed — skip this font gracefully.
+            }
+        }
+    }
     // ── Color emoji pre-render ─────────────────────────────────────────────
     // When a colorEmoji renderer is provided, pre-scan the entire markdown for
     // every unique emoji and convert them all to PNG buffers up-front.  This
@@ -92,8 +112,38 @@ async function renderMarkdownToPdf(markdown, options) {
             doc.addPage();
         }
     }
-    /** Derive the italic variant of a PDFKit built-in font name. */
+    /** Check whether `font` (or its base name) is a registered custom font. */
+    function isCustomFont(font) {
+        if (customFontNames.has(font))
+            return true;
+        // Also match variant names like "Roboto-Bold"
+        const dash = font.lastIndexOf('-');
+        if (dash > 0)
+            return customFontNames.has(font.substring(0, dash));
+        return false;
+    }
+    /** Return the base (registered) name of a custom font, stripping any variant suffix. */
+    function customFontBase(font) {
+        if (customFontNames.has(font))
+            return font;
+        const dash = font.lastIndexOf('-');
+        if (dash > 0) {
+            const base = font.substring(0, dash);
+            if (customFontNames.has(base))
+                return base;
+        }
+        return font;
+    }
+    /** Derive the italic variant of a font name. */
     function italicVariant(font) {
+        // Custom fonts use Name-Italic / Name-BoldItalic
+        if (isCustomFont(font)) {
+            const base = customFontBase(font);
+            if (font.endsWith('-Bold'))
+                return `${base}-BoldItalic`;
+            return `${base}-Italic`;
+        }
+        // Built-in Times family
         if (font.startsWith('Times'))
             return font.replace(/-Bold$/, '-BoldItalic').replace(/^Times-Roman$/, 'Times-Italic');
         // Helvetica / Courier families use "Oblique"
@@ -101,22 +151,49 @@ async function renderMarkdownToPdf(markdown, options) {
             return font + 'Oblique';
         return font + '-Oblique';
     }
+    /** Resolve the correct font variant (regular / bold / italic / bold-italic). */
+    function resolveFont(baseFont, bold, italic) {
+        if (isCustomFont(baseFont)) {
+            const base = customFontBase(baseFont);
+            if (bold && italic)
+                return `${base}-BoldItalic`;
+            if (bold)
+                return `${base}-Bold`;
+            if (italic)
+                return `${base}-Italic`;
+            return base;
+        }
+        // Built-in PDFKit fonts — strip existing variant suffix before applying,
+        // so that e.g. 'Helvetica-Bold' + bold doesn't produce 'Helvetica-Bold-Bold'.
+        if (baseFont.startsWith('Times')) {
+            if (bold && italic)
+                return 'Times-BoldItalic';
+            if (bold)
+                return 'Times-Bold';
+            if (italic)
+                return 'Times-Italic';
+            return baseFont;
+        }
+        // Helvetica / Courier families: strip any existing variant suffix first
+        const family = baseFont.replace(/-(Bold|Oblique|BoldOblique)$/, '');
+        if (bold && italic)
+            return `${family}-BoldOblique`;
+        if (bold)
+            return `${family}-Bold`;
+        if (italic)
+            return `${family}-Oblique`;
+        return family;
+    }
     function applyBodyFont(bold, italic) {
         if (headingCtx) {
             // Inside a heading — use heading style as the base.
             let font = headingCtx.font;
-            if (italic)
-                font = italicVariant(font);
+            if (bold || italic)
+                font = resolveFont(font, bold, italic);
             doc.font(font).fontSize(headingCtx.fontSize).fillColor(headingCtx.color);
             return;
         }
-        let font = theme.body.font;
-        if (bold && italic)
-            font = 'Helvetica-BoldOblique';
-        else if (bold)
-            font = 'Helvetica-Bold';
-        else if (italic)
-            font = 'Helvetica-Oblique';
+        const font = resolveFont(theme.body.font, bold, italic);
         doc.font(font).fontSize(theme.body.fontSize).fillColor(theme.body.color);
     }
     function resetBodyFont() {
@@ -684,7 +761,7 @@ async function renderMarkdownToPdf(markdown, options) {
                 for (const child of t.tokens) {
                     if (child.type === 'paragraph') {
                         const p = child;
-                        const font = bq.italic ? 'Helvetica-Oblique' : theme.body.font;
+                        const font = bq.italic ? italicVariant(theme.body.font) : theme.body.font;
                         doc.font(font).fontSize(theme.body.fontSize).fillColor(theme.body.color);
                         doc.text('', textX, doc.y, { width: textWidth });
                         await renderInlineTokens(p.tokens, false, false, bq.italic);

package/dist/types.d.ts

@@ -73,6 +73,25 @@ export interface ThemeConfig {
      */
     syntaxHighlight?: SyntaxHighlightTheme;
 }
+/**
+ * A custom font definition providing font data for registration with PDFKit.
+ *
+ * Supply at minimum a `name` and `regular` buffer.  Missing bold / italic /
+ * bold-italic variants fall back: boldItalic → bold → regular,
+ * italic → regular, bold → regular.
+ */
+export interface CustomFontDefinition {
+    /** The name to use in ThemeConfig font fields (e.g. 'Roboto'). */
+    name: string;
+    /** Regular weight font data. */
+    regular: Buffer;
+    /** Bold variant (falls back to regular). */
+    bold?: Buffer;
+    /** Italic variant (falls back to regular). */
+    italic?: Buffer;
+    /** Bold-italic variant (falls back to bold or regular). */
+    boldItalic?: Buffer;
+}
 /** Converts a single emoji string to a PNG `Buffer`. */
 export type ColorEmojiRenderer = (emoji: string) => Promise<Buffer>;
 export interface PdfOptions {
@@ -146,4 +165,12 @@ export interface PdfOptions {
      * monochrome font or the body font.
      */
     colorEmoji?: ColorEmojiRenderer;
+    /**
+     * Custom font definitions to register with PDFKit.
+     *
+     * Each entry provides font data (as `Buffer`s) for a named font family
+     * with optional bold, italic, and bold-italic variants.  The `name` can
+     * then be used in any `ThemeConfig` font field (e.g. `body.font`).
+     */
+    customFonts?: CustomFontDefinition[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speajus/markdown-to-pdf",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "description": "A new project created with Intent by Augment.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",