@speajus/markdown-to-pdf 1.0.15 → 1.0.16

package/dist/browser.d.ts

@@ -2,8 +2,7 @@
  * 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, CustomFontDefinition, } from './types.js';
-export { defaultTheme, defaultPageLayout, defaultSyntaxHighlightTheme } from './styles.js';
+export type { TextStyle, PageLayout, CodeStyle, CodeBlockStyle, BlockquoteStyle, TableStyles, TokenColors, SyntaxHighlightTheme, SpacingConfig, ThemeConfig, PdfOptions, CustomFontDefinition, } from './types.js';
+export { defaultTheme, defaultPageLayout, defaultSyntaxHighlightTheme, defaultSpacing } from './styles.js';
 export { themes, modernTheme, academicTheme, minimalTheme, oceanTheme } from './themes/index.js';
 export { renderMarkdownToPdf } from "./renderer.js";

package/dist/browser.js

@@ -1,17 +1,16 @@
 "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;
+exports.renderMarkdownToPdf = exports.oceanTheme = exports.minimalTheme = exports.academicTheme = exports.modernTheme = exports.themes = exports.defaultSpacing = exports.defaultSyntaxHighlightTheme = exports.defaultPageLayout = exports.defaultTheme = 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");
-Object.defineProperty(exports, "createBrowserColorEmojiRenderer", { enumerable: true, get: function () { return color_emoji_js_1.createBrowserColorEmojiRenderer; } });
 var styles_js_1 = require("./styles.js");
 Object.defineProperty(exports, "defaultTheme", { enumerable: true, get: function () { return styles_js_1.defaultTheme; } });
 Object.defineProperty(exports, "defaultPageLayout", { enumerable: true, get: function () { return styles_js_1.defaultPageLayout; } });
 Object.defineProperty(exports, "defaultSyntaxHighlightTheme", { enumerable: true, get: function () { return styles_js_1.defaultSyntaxHighlightTheme; } });
+Object.defineProperty(exports, "defaultSpacing", { enumerable: true, get: function () { return styles_js_1.defaultSpacing; } });
 var index_js_1 = require("./themes/index.js");
 Object.defineProperty(exports, "themes", { enumerable: true, get: function () { return index_js_1.themes; } });
 Object.defineProperty(exports, "modernTheme", { enumerable: true, get: function () { return index_js_1.modernTheme; } });

package/dist/highlight.prism.d.ts

@@ -57,6 +57,8 @@ export interface RenderCodeOptions {
     lineNumbers?: boolean;
     drawBackground?: boolean;
     theme?: Partial<SyntaxHighlightTheme>;
+    /** Corner radius for the code block background. @default 0 */
+    borderRadius?: number;
 }
 export declare function colorFor(tokenType: string | null, theme: SyntaxHighlightTheme): string;
 /**

package/dist/highlight.prism.js

@@ -172,12 +172,17 @@ function renderCode(doc, code, opts) {
         : 0;
     const codeX = x + padding + gutterWidth;
     const blockHeight = lines.length * lineH + padding * 2;
+    const borderRadius = opts.borderRadius ?? 0;
     // --- Background ---
     if (drawBackground) {
-        doc
-            .save()
-            .rect(x, y, blockWidth, blockHeight)
-            .fill(theme.background);
+        doc.save();
+        if (borderRadius > 0) {
+            doc.roundedRect(x, y, blockWidth, blockHeight, borderRadius);
+        }
+        else {
+            doc.rect(x, y, blockWidth, blockHeight);
+        }
+        doc.fill(theme.background);
         doc.restore();
     }
     // --- Set font once ---

package/dist/index.d.ts

@@ -1,8 +1,6 @@
-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 type { TextStyle, PageLayout, CodeStyle, CodeBlockStyle, BlockquoteStyle, TableStyles, TokenColors, SyntaxHighlightTheme, SpacingConfig, ThemeConfig, PdfOptions, CustomFontDefinition, } from './types.js';
+export { defaultTheme, defaultPageLayout, defaultSyntaxHighlightTheme, defaultSpacing } from './styles.js';
 export { renderMarkdownToPdf as generatePdf, renderMarkdownToPdf, } from "./renderer.js";
 export { createBrowserImageRenderer } from './browser-image-renderer.js';
 export { createNodeImageRenderer } from './node-image-renderer.js';
-export { createBrowserColorEmojiRenderer } from './color-emoji.js';
-export { createNodeColorEmojiRenderer } from './node-color-emoji.js';
 export { loadHighlightLanguages } from './highlight.prism.js';

package/dist/index.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadHighlightLanguages = exports.createNodeColorEmojiRenderer = exports.createBrowserColorEmojiRenderer = exports.createNodeImageRenderer = exports.createBrowserImageRenderer = exports.renderMarkdownToPdf = exports.generatePdf = exports.defaultSyntaxHighlightTheme = exports.defaultPageLayout = exports.defaultTheme = void 0;
+exports.loadHighlightLanguages = exports.createNodeImageRenderer = exports.createBrowserImageRenderer = exports.renderMarkdownToPdf = exports.generatePdf = exports.defaultSpacing = exports.defaultSyntaxHighlightTheme = exports.defaultPageLayout = exports.defaultTheme = void 0;
 var styles_js_1 = require("./styles.js");
 Object.defineProperty(exports, "defaultTheme", { enumerable: true, get: function () { return styles_js_1.defaultTheme; } });
 Object.defineProperty(exports, "defaultPageLayout", { enumerable: true, get: function () { return styles_js_1.defaultPageLayout; } });
 Object.defineProperty(exports, "defaultSyntaxHighlightTheme", { enumerable: true, get: function () { return styles_js_1.defaultSyntaxHighlightTheme; } });
+Object.defineProperty(exports, "defaultSpacing", { enumerable: true, get: function () { return styles_js_1.defaultSpacing; } });
 var renderer_js_1 = require("./renderer.js");
 Object.defineProperty(exports, "generatePdf", { enumerable: true, get: function () { return renderer_js_1.renderMarkdownToPdf; } });
 Object.defineProperty(exports, "renderMarkdownToPdf", { enumerable: true, get: function () { return renderer_js_1.renderMarkdownToPdf; } });
@@ -12,9 +13,5 @@ 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 node_image_renderer_js_1 = require("./node-image-renderer.js");
 Object.defineProperty(exports, "createNodeImageRenderer", { enumerable: true, get: function () { return node_image_renderer_js_1.createNodeImageRenderer; } });
-var color_emoji_js_1 = require("./color-emoji.js");
-Object.defineProperty(exports, "createBrowserColorEmojiRenderer", { enumerable: true, get: function () { return color_emoji_js_1.createBrowserColorEmojiRenderer; } });
-var node_color_emoji_js_1 = require("./node-color-emoji.js");
-Object.defineProperty(exports, "createNodeColorEmojiRenderer", { enumerable: true, get: function () { return node_color_emoji_js_1.createNodeColorEmojiRenderer; } });
 var highlight_prism_js_1 = require("./highlight.prism.js");
 Object.defineProperty(exports, "loadHighlightLanguages", { enumerable: true, get: function () { return highlight_prism_js_1.loadHighlightLanguages; } });

package/dist/renderer.js

@@ -10,10 +10,8 @@ const marked_1 = require("marked");
 const stream_1 = require("stream");
 const defaults_js_1 = require("./defaults.js");
 const highlight_prism_js_1 = require("./highlight.prism.js");
-const emoji_js_1 = require("./emoji.js");
-const color_emoji_js_1 = require("./color-emoji.js");
-/** Name used to register the emoji font with PDFKit */
-const EMOJI_FONT_NAME = 'NotoEmoji';
+/** Name used to identify the emoji font (for safeFont checks). */
+const EMOJI_FONT_NAME = 'EmojiFont';
 /** Standard PDF fonts built into PDFKit — always available without filesystem access. */
 const STANDARD_PDF_FONTS = new Set([
     'Helvetica', 'Helvetica-Bold', 'Helvetica-Oblique', 'Helvetica-BoldOblique',
@@ -31,49 +29,61 @@ async function renderMarkdownToPdf(markdown, options) {
     }
     const lineNumbers = options?.lineNumbers ?? false;
     const zebraStripes = options?.zebraStripes !== false;
-    const emojiFontOpt = options?.emojiFont ?? true;
+    // ── Resolve effective emoji font setting ──────────────────────────────
+    // PdfOptions.emojiFont (boolean | string | Buffer) overrides theme when
+    // explicitly set; otherwise fall back to theme.emojiFont ('twemoji'|'openmoji'|'none').
+    const themeEmojiFont = theme.emojiFont ?? 'twemoji';
+    const emojiFontOpt = options?.emojiFont !== undefined
+        ? options.emojiFont
+        : themeEmojiFont === 'none'
+            ? false
+            : themeEmojiFont; // 'twemoji' | 'openmoji'
     // Use provided image renderer or create default Node.js renderer
     const imageRenderer = options?.renderImage ?? defaults_js_1.DEFAULTS.renderImage(basePath);
     const { margins } = layout;
-    const doc = new pdfkit_1.default({ size: layout.pageSize, margins });
-    const stream = new stream_1.PassThrough();
-    const chunks = [];
-    doc.pipe(stream);
-    stream.on('data', (chunk) => chunks.push(chunk));
-    // ── Emoji font registration ───────────────────────────────────────────────
-    // The font registration block uses dynamic require() for `path` and `fs` so
-    // that the renderer module can also be imported in browser environments where
-    // those Node.js built-ins are unavailable.  If they aren't available the
-    // try/catch simply falls through and emoji support is disabled (unless the
-    // caller passes a Buffer directly via the `emojiFont` option).
-    let emojiEnabled = false;
+    // ── Resolve emoji font for pdfkit native color emoji support ────────────
+    // The fork at jspears/pdfkit#support-color-emoji-google handles emoji
+    // segmentation and rendering (COLR/CPAL, SBIX, CBDT) internally when
+    // an `emojiFont` option is passed to the PDFDocument constructor.
+    let resolvedEmojiFont;
     if (emojiFontOpt !== false) {
         try {
             if (Buffer.isBuffer(emojiFontOpt)) {
-                // Raw font data — works in both Node.js and browser environments.
-                doc.registerFont(EMOJI_FONT_NAME, emojiFontOpt);
-                emojiEnabled = true;
+                resolvedEmojiFont = emojiFontOpt;
             }
             else {
-                // Resolve a file path — requires Node.js built-ins.
                 // eslint-disable-next-line @typescript-eslint/no-require-imports
                 const nodePath = require('path');
                 // eslint-disable-next-line @typescript-eslint/no-require-imports
                 const nodeFs = require('fs');
-                const fontPath = typeof emojiFontOpt === 'string'
-                    ? emojiFontOpt
-                    : nodePath.join(__dirname, 'fonts', 'NotoEmoji-Regular.ttf');
+                let fontPath;
+                if (typeof emojiFontOpt === 'string' && emojiFontOpt !== 'twemoji' && emojiFontOpt !== 'openmoji' && emojiFontOpt !== 'none') {
+                    fontPath = emojiFontOpt; // custom file path
+                }
+                else if (emojiFontOpt === 'openmoji') {
+                    fontPath = nodePath.join(__dirname, 'fonts', 'OpenMoji-Color.ttf');
+                }
+                else {
+                    fontPath = nodePath.join(__dirname, 'fonts', 'Twemoji.Mozilla.ttf');
+                }
                 if (nodeFs.existsSync(fontPath)) {
-                    doc.registerFont(EMOJI_FONT_NAME, fontPath);
-                    emojiEnabled = true;
+                    resolvedEmojiFont = fontPath;
                 }
             }
         }
         catch {
-            // Font registration failed or Node.js APIs not available (browser) —
-            // fall through without emoji support.
+            // Node.js APIs not available (browser) — no emoji font.
         }
     }
+    const doc = new pdfkit_1.default({
+        size: layout.pageSize,
+        margins,
+        ...(resolvedEmojiFont ? { emojiFont: resolvedEmojiFont } : {}),
+    });
+    const stream = new stream_1.PassThrough();
+    const chunks = [];
+    doc.pipe(stream);
+    stream.on('data', (chunk) => chunks.push(chunk));
     // ── 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:
@@ -108,15 +118,8 @@ async function renderMarkdownToPdf(markdown, options) {
     catch {
         // Node.js `fs` not available — we're in a browser environment.
     }
-    // ── 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
-    // lets `renderTextWithEmoji` remain synchronous during page rendering.
-    let emojiImageCache;
-    const colorEmojiEnabled = !!options?.colorEmoji;
-    if (options?.colorEmoji) {
-        emojiImageCache = await (0, color_emoji_js_1.preRenderEmoji)(markdown, options.colorEmoji, (0, emoji_js_1.getEmojiRegex)());
-    }
+    // ── Spacing config ────────────────────────────────────────────────────
+    const sp = { ...styles_js_1.defaultSpacing, ...theme.spacing };
     const tokens = marked_1.marked.lexer(markdown);
     const contentWidth = doc.page.width - margins.left - margins.right;
     // ── Table cell context ──────────────────────────────────────────────────
@@ -257,20 +260,16 @@ async function renderMarkdownToPdf(markdown, options) {
         doc.font(safeFont(theme.body.font)).fontSize(theme.body.fontSize).fillColor(theme.body.color);
     }
     /**
-     * Render a text string switching to the emoji font for emoji characters.
-     *
-     * Preserves the caller's current font / fontSize / fillColor for the
-     * non-emoji portions.  The `continued` flag behaves exactly like the
-     * native PDFKit option — pass `true` to keep the line open.
+     * Render text, delegating to `doc.text()`.
      *
-     * When `colorEmojiEnabled` is true and `emojiImageCache` is populated,
-     * emoji characters are rendered as inline PNG images instead of font
-     * glyphs, with manual (x, y) positioning to keep them in the text flow.
+     * pdfkit's native color emoji support (via the `emojiFont` constructor
+     * option) handles emoji segmentation and rendering internally, so this
+     * function only normalises call signatures and handles table cell context.
      *
-     * Supports both `renderTextWithEmoji(text, opts?)` and the positioned
-     * form `renderTextWithEmoji(text, x, y, opts?)` used by table cells.
+     * Supports both `renderText(text, opts?)` and the positioned form
+     * `renderText(text, x, y, opts?)` used by table cells.
      */
-    function renderTextWithEmoji(text, xOrOpts, yOrUndefined, posOpts) {
+    function renderText(text, xOrOpts, yOrUndefined, posOpts) {
         // Normalise the two call signatures into a single (opts, firstX, firstY).
         let opts;
         let firstX;
@@ -290,163 +289,12 @@ async function renderMarkdownToPdf(markdown, options) {
             opts = { ...opts, width: cellCtx.width, align: cellCtx.align };
             cellCtx.used = true;
         }
-        const hasEmoji = (0, emoji_js_1.containsEmoji)(text);
-        // ── Fast path: no emoji handling needed ──────────────────────────────
-        if ((!emojiEnabled && !colorEmojiEnabled) || !hasEmoji) {
-            if (firstX !== undefined) {
-                doc.text(text, firstX, firstY, opts);
-            }
-            else {
-                doc.text(text, opts);
-            }
-            return;
-        }
-        // Remember the caller's font state so we can restore after emoji runs.
-        const prevFont = doc._font?.name ?? safeFont(theme.body.font);
-        const prevSize = doc._fontSize ?? theme.body.fontSize;
-        const segments = (0, emoji_js_1.splitEmojiSegments)(text);
-        // ── Color emoji path: render emoji as inline PNG images ──────────────
-        // Strategy: two-pass rendering.
-        //   Pass 1 – Render all text through doc.text() with `continued`,
-        //            exactly like the monochrome path.  For emoji segments,
-        //            render a space-placeholder to reserve width.  Read the
-        //            real X position from PDFKit's internal wrapper state
-        //            (_wrapper.startX + _wrapper.continuedX) — doc.x stays
-        //            at the left margin after continued:true so it is NOT
-        //            usable for positioning.
-        //   Pass 2 – Overlay emoji PNG images at the recorded positions.
-        if (colorEmojiEnabled && emojiImageCache && emojiImageCache.size > 0) {
-            const emojiRe = (0, emoji_js_1.getEmojiRegex)();
-            const emojiSize = prevSize; // match font size
-            const emojiPlacements = [];
-            // Read the actual text-flow X from PDFKit's internal LineWrapper.
-            // After doc.text(…, {continued:true}), _wrapper.continuedX tracks
-            // cumulative rendered width; startX is the original doc.x at
-            // wrapper creation time.
-            const getFlowX = () => {
-                const w = doc._wrapper;
-                if (w)
-                    return w.startX + w.continuedX;
-                return firstX ?? doc.x;
-            };
-            // Build a space-placeholder string whose width ≈ emojiSize.
-            doc.font(prevFont).fontSize(prevSize);
-            const spaceW = doc.widthOfString(' ');
-            const spacesPerEmoji = Math.max(1, Math.round(emojiSize / spaceW));
-            const placeholder = ' '.repeat(spacesPerEmoji);
-            const placeholderW = doc.widthOfString(placeholder);
-            // Vertical alignment: centre emoji within the current line height.
-            const lineH = doc.currentLineHeight(true);
-            const yOffset = Math.max(0, (lineH - emojiSize) / 2);
-            // Only use explicit (firstX, firstY) coordinates on the very first
-            // doc.text() call, and only when no wrapper already exists (i.e.
-            // we are not continuing from a prior renderTextWithEmoji call).
-            let usedExplicitCoords = false;
-            for (let i = 0; i < segments.length; i++) {
-                const seg = segments[i];
-                const isLast = i === segments.length - 1;
-                const cont = isLast ? !!opts.continued : true;
-                if (seg.isEmoji) {
-                    emojiRe.lastIndex = 0;
-                    let em;
-                    while ((em = emojiRe.exec(seg.text)) !== null) {
-                        const png = emojiImageCache.get(em[0]);
-                        const isLastEmoji = isLast && emojiRe.lastIndex >= seg.text.length;
-                        const eCont = isLastEmoji ? !!opts.continued : true;
-                        if (png) {
-                            // Position BEFORE rendering the placeholder.
-                            const emojiX = getFlowX();
-                            // For positioned calls (table cells), doc.y may be stale from
-                            // a previous cell — use the explicit firstY instead.
-                            const emojiY = (!usedExplicitCoords && firstY !== undefined) ? firstY : doc.y;
-                            doc.font(prevFont).fontSize(prevSize);
-                            if (!usedExplicitCoords && firstX !== undefined) {
-                                doc.text(placeholder, firstX, firstY, { ...opts, continued: eCont });
-                                usedExplicitCoords = true;
-                            }
-                            else {
-                                doc.text(placeholder, { ...opts, continued: eCont });
-                            }
-                            // Compute alignment-aware X position for the emoji image.
-                            let placedX = emojiX + (placeholderW - emojiSize) / 2;
-                            if (firstX !== undefined && typeof opts.width === 'number' && !doc._wrapper) {
-                                // Table cell with alignment — PDFKit already rendered the
-                                // placeholder at the aligned position; match it.
-                                const cellW = opts.width;
-                                const a = opts.align || 'left';
-                                if (a === 'center')
-                                    placedX = firstX + (cellW - emojiSize) / 2;
-                                else if (a === 'right')
-                                    placedX = firstX + cellW - emojiSize;
-                            }
-                            emojiPlacements.push({
-                                png,
-                                x: placedX,
-                                y: emojiY + yOffset,
-                            });
-                        }
-                        else {
-                            // Fallback: monochrome glyph.
-                            if (emojiEnabled)
-                                doc.font(EMOJI_FONT_NAME).fontSize(prevSize);
-                            if (!usedExplicitCoords && firstX !== undefined) {
-                                doc.text(em[0], firstX, firstY, { ...opts, continued: isLastEmoji ? !!opts.continued : true });
-                                usedExplicitCoords = true;
-                            }
-                            else {
-                                doc.text(em[0], { ...opts, continued: isLastEmoji ? !!opts.continued : true });
-                            }
-                            doc.font(prevFont).fontSize(prevSize);
-                        }
-                    }
-                }
-                else {
-                    // ── Text segment ──
-                    doc.font(prevFont).fontSize(prevSize);
-                    if (!usedExplicitCoords && firstX !== undefined) {
-                        doc.text(seg.text, firstX, firstY, { ...opts, continued: cont });
-                        usedExplicitCoords = true;
-                    }
-                    else {
-                        doc.text(seg.text, { ...opts, continued: cont });
-                    }
-                }
-            }
-            // ── Pass 2: overlay emoji images at recorded positions ──
-            const savedY = doc.y;
-            const savedX = doc.x;
-            for (const ep of emojiPlacements) {
-                doc.image(ep.png, ep.x, ep.y, {
-                    width: emojiSize,
-                    height: emojiSize,
-                });
-            }
-            doc.y = savedY;
-            doc.x = savedX;
-            doc.font(prevFont).fontSize(prevSize);
-            return;
+        if (firstX !== undefined) {
+            doc.text(text, firstX, firstY, opts);
         }
-        // ── Monochrome font path (original behaviour) ────────────────────────
-        for (let i = 0; i < segments.length; i++) {
-            const seg = segments[i];
-            const isLast = i === segments.length - 1;
-            const cont = isLast ? !!opts.continued : true;
-            if (seg.isEmoji) {
-                doc.font(EMOJI_FONT_NAME).fontSize(prevSize);
-            }
-            else {
-                doc.font(prevFont).fontSize(prevSize);
-            }
-            // Only pass explicit x,y for the very first segment.
-            if (i === 0 && firstX !== undefined) {
-                doc.text(seg.text, firstX, firstY, { ...opts, continued: cont });
-            }
-            else {
-                doc.text(seg.text, { ...opts, continued: cont });
-            }
+        else {
+            doc.text(text, opts);
         }
-        // Restore the original font so subsequent calls aren't surprised.
-        doc.font(prevFont).fontSize(prevSize);
     }
     function renderCodespan(text, continued) {
         const cs = theme.code.inline;
@@ -504,7 +352,7 @@ async function renderMarkdownToPdf(markdown, options) {
             doc.font(safeFont(theme.body.font)).fontSize(theme.body.fontSize).fillColor(theme.linkColor);
         }
         const linkText = tok.text || tok.href;
-        renderTextWithEmoji(linkText, { continued, underline: true, link: tok.href });
+        renderText(linkText, { continued, underline: true, link: tok.href });
         doc.fillColor(headingCtx ? headingCtx.color : theme.body.color);
     }
     async function renderInlineTokens(inlineTokens, continued, insideBold = false, insideItalic = false) {
@@ -520,7 +368,7 @@ async function renderMarkdownToPdf(markdown, options) {
                     }
                     else {
                         applyBodyFont(insideBold, insideItalic);
-                        renderTextWithEmoji(t.text, { continued: cont, underline: false, strike: false });
+                        renderText(t.text, { continued: cont, underline: false, strike: false });
                     }
                     break;
                 }
@@ -548,12 +396,12 @@ async function renderMarkdownToPdf(markdown, options) {
                 }
                 case 'del': {
                     applyBodyFont(insideBold, insideItalic);
-                    renderTextWithEmoji(tok.text, { continued: cont, strike: true, underline: false });
+                    renderText(tok.text, { continued: cont, strike: true, underline: false });
                     break;
                 }
                 case 'escape': {
                     applyBodyFont(insideBold, insideItalic);
-                    renderTextWithEmoji(tok.text, { continued: cont, underline: false, strike: false });
+                    renderText(tok.text, { continued: cont, underline: false, strike: false });
                     break;
                 }
                 case 'br': {
@@ -564,7 +412,7 @@ async function renderMarkdownToPdf(markdown, options) {
                     const raw = tok.text ?? tok.raw ?? '';
                     if (raw) {
                         applyBodyFont(insideBold, insideItalic);
-                        renderTextWithEmoji(raw, { continued: cont, underline: false, strike: false });
+                        renderText(raw, { continued: cont, underline: false, strike: false });
                     }
                     break;
                 }
@@ -588,9 +436,12 @@ async function renderMarkdownToPdf(markdown, options) {
                 displayWidth = img.width * (displayHeight / img.height);
             }
             ensureSpace(displayHeight + 10);
-            const imgX = doc.x;
+            // Compute horizontal position based on imageAlign
+            const imgX = theme.imageAlign === 'center'
+                ? margins.left + (contentWidth - displayWidth) / 2
+                : doc.x;
             const imgY = doc.y;
-            doc.image(imgBuffer, { width: displayWidth, height: displayHeight });
+            doc.image(imgBuffer, imgX, imgY, { width: displayWidth, height: displayHeight });
             // If the image is wrapped in a link, overlay a clickable annotation
             if (linkUrl) {
                 doc.link(imgX, imgY, displayWidth, displayHeight, linkUrl);
@@ -605,13 +456,13 @@ async function renderMarkdownToPdf(markdown, options) {
         }
     }
     async function renderList(list, depth) {
-        const indent = margins.left + depth * 20;
+        const indent = margins.left + depth * sp.listIndent;
         for (let idx = 0; idx < list.items.length; idx++) {
             const item = list.items[idx];
             ensureSpace(theme.body.fontSize * 2);
             resetBodyFont();
             const bullet = list.ordered ? `${list.start + idx}.` : '•';
-            doc.text(bullet, indent, doc.y, { continued: true, width: contentWidth - depth * 20 });
+            doc.text(bullet, indent, doc.y, { continued: true, width: contentWidth - depth * sp.listIndent });
             doc.text(' ', { continued: true });
             // Render item inline tokens
             const itemTokens = item.tokens;
@@ -622,7 +473,7 @@ async function renderMarkdownToPdf(markdown, options) {
                         await renderInlineTokens(t.tokens, false);
                     }
                     else {
-                        renderTextWithEmoji(t.text);
+                        renderText(t.text);
                     }
                 }
                 else if (child.type === 'paragraph') {
@@ -632,7 +483,7 @@ async function renderMarkdownToPdf(markdown, options) {
                     await renderList(child, depth + 1);
                 }
             }
-            doc.moveDown(0.2);
+            doc.moveDown(sp.listItemSpacing);
         }
     }
     async function renderCellTokens(cell, x, y, width, align, bold) {
@@ -646,7 +497,7 @@ async function renderMarkdownToPdf(markdown, options) {
         else {
             // Fallback: plain text (no inline tokens)
             applyBodyFont(bold, false);
-            renderTextWithEmoji(cell.text, x, y, { width, align });
+            renderText(cell.text, x, y, { width, align });
         }
         doc.y = savedY;
     }
@@ -715,8 +566,8 @@ async function renderMarkdownToPdf(markdown, options) {
                 const t = token;
                 const key = `h${t.depth}`;
                 const style = theme.headings[key];
-                const spaceAbove = style.fontSize * 0.8;
-                const spaceBelow = style.fontSize * 0.3;
+                const spaceAbove = style.fontSize * sp.headingSpaceAbove;
+                const spaceBelow = style.fontSize * sp.headingSpaceBelow;
                 ensureSpace(spaceAbove + style.fontSize + spaceBelow);
                 doc.moveDown(spaceAbove / doc.currentLineHeight());
                 doc.font(safeFont(style.font)).fontSize(style.fontSize).fillColor(style.color);
@@ -725,7 +576,7 @@ async function renderMarkdownToPdf(markdown, options) {
                     await renderInlineTokens(t.tokens, false, style.bold ?? false, style.italic ?? false);
                 }
                 else {
-                    renderTextWithEmoji(t.text);
+                    renderText(t.text);
                 }
                 headingCtx = null;
                 // Draw an underline beneath h1 and h2
@@ -748,7 +599,7 @@ async function renderMarkdownToPdf(markdown, options) {
                 ensureSpace(theme.body.fontSize * 2);
                 resetBodyFont();
                 await renderInlineTokens(t.tokens, false);
-                doc.moveDown(0.5);
+                doc.moveDown(sp.paragraphSpacing);
                 break;
             }
             case 'code': {
@@ -772,10 +623,11 @@ async function renderMarkdownToPdf(markdown, options) {
                         lineNumbers,
                         drawBackground: true,
                         theme: theme.syntaxHighlight,
+                        borderRadius: cs.borderRadius,
                     });
                     doc.x = margins.left;
                     doc.y = newY;
-                    doc.moveDown(0.5);
+                    doc.moveDown(sp.codeBlockSpacing);
                     resetBodyFont();
                 }
                 else {
@@ -786,8 +638,14 @@ async function renderMarkdownToPdf(markdown, options) {
                     ensureSpace(blockH + 10);
                     const x = margins.left;
                     const y = doc.y;
+                    const cbRadius = cs.borderRadius ?? 0;
                     doc.save();
-                    doc.rect(x, y, contentWidth, blockH).fill(cs.backgroundColor);
+                    if (cbRadius > 0) {
+                        doc.roundedRect(x, y, contentWidth, blockH, cbRadius).fill(cs.backgroundColor);
+                    }
+                    else {
+                        doc.rect(x, y, contentWidth, blockH).fill(cs.backgroundColor);
+                    }
                     doc.restore();
                     doc.font(safeFont(cs.font)).fontSize(cs.fontSize).fillColor(cs.color);
                     let textY = y + cs.padding;
@@ -797,7 +655,7 @@ async function renderMarkdownToPdf(markdown, options) {
                     }
                     doc.x = margins.left;
                     doc.y = y + blockH;
-                    doc.moveDown(0.5);
+                    doc.moveDown(sp.codeBlockSpacing);
                     resetBodyFont();
                 }
                 break;
@@ -806,7 +664,7 @@ async function renderMarkdownToPdf(markdown, options) {
                 const t = token;
                 const bq = theme.blockquote;
                 ensureSpace(30);
-                const bqPadding = 6; // vertical padding above and below text
+                const bqPadding = bq.padding ?? 6;
                 const startY = doc.y;
                 doc.y += bqPadding; // add top padding before text
                 const textX = margins.left + bq.borderWidth + bq.indent;
@@ -818,7 +676,7 @@ async function renderMarkdownToPdf(markdown, options) {
                         doc.font(safeFont(font)).fontSize(theme.body.fontSize).fillColor(theme.body.color);
                         doc.text('', textX, doc.y, { width: textWidth });
                         await renderInlineTokens(p.tokens, false, false, bq.italic);
-                        doc.moveDown(0.3);
+                        doc.moveDown(sp.blockquoteSpacing);
                     }
                     else {
                         await renderToken(child);
@@ -826,11 +684,18 @@ async function renderMarkdownToPdf(markdown, options) {
                 }
                 doc.y += bqPadding; // add bottom padding after text
                 const endY = doc.y;
+                // Draw optional background fill behind blockquote area
+                if (bq.backgroundColor) {
+                    doc.save();
+                    doc.rect(margins.left + bq.borderWidth, startY, contentWidth - bq.borderWidth, endY - startY).fill(bq.backgroundColor);
+                    doc.restore();
+                }
+                // Draw left border
                 doc.save();
                 doc.rect(margins.left, startY, bq.borderWidth, endY - startY).fill(bq.borderColor);
                 doc.restore();
                 doc.x = margins.left;
-                doc.moveDown(0.3);
+                doc.moveDown(sp.blockquoteSpacing);
                 resetBodyFont();
                 break;
             }
@@ -841,7 +706,7 @@ async function renderMarkdownToPdf(markdown, options) {
             }
             case 'hr': {
                 ensureSpace(20);
-                doc.moveDown(0.5);
+                doc.moveDown(sp.hrSpacing);
                 const y = doc.y;
                 doc.save();
                 doc.strokeColor(theme.horizontalRuleColor).lineWidth(1)
@@ -850,7 +715,7 @@ async function renderMarkdownToPdf(markdown, options) {
                     .stroke();
                 doc.restore();
                 doc.y = y;
-                doc.moveDown(0.5);
+                doc.moveDown(sp.hrSpacing);
                 resetBodyFont();
                 break;
             }

package/dist/styles.d.ts

@@ -1,4 +1,6 @@
-import type { ThemeConfig, PageLayout, SyntaxHighlightTheme } from './types.js';
+import type { ThemeConfig, PageLayout, SpacingConfig, SyntaxHighlightTheme } from './types.js';
+/** Default spacing values — used as fallbacks when theme.spacing is partial or absent. */
+export declare const defaultSpacing: Required<SpacingConfig>;
 /** Prism.js default light theme — used as the default (print-friendly). */
 export declare const defaultSyntaxHighlightTheme: SyntaxHighlightTheme;
 export declare const defaultTheme: ThemeConfig;

package/dist/styles.js

@@ -1,6 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultPageLayout = exports.defaultTheme = exports.defaultSyntaxHighlightTheme = void 0;
+exports.defaultPageLayout = exports.defaultTheme = exports.defaultSyntaxHighlightTheme = exports.defaultSpacing = void 0;
+/** Default spacing values — used as fallbacks when theme.spacing is partial or absent. */
+exports.defaultSpacing = {
+    headingSpaceAbove: 0.8,
+    headingSpaceBelow: 0.3,
+    paragraphSpacing: 0.5,
+    listItemSpacing: 0.2,
+    listIndent: 20,
+    blockquoteSpacing: 0.3,
+    codeBlockSpacing: 0.5,
+    hrSpacing: 0.5,
+};
 /** Prism.js default light theme — used as the default (print-friendly). */
 exports.defaultSyntaxHighlightTheme = {
     background: '#f5f2f0',
@@ -81,6 +92,9 @@ exports.defaultTheme = {
         zebraColor: '#f9f9f9',
     },
     syntaxHighlight: exports.defaultSyntaxHighlightTheme,
+    spacing: { ...exports.defaultSpacing },
+    imageAlign: 'left',
+    emojiFont: 'twemoji',
 };
 exports.defaultPageLayout = {
     pageSize: 'LETTER',

package/dist/themes/index.js

@@ -39,6 +39,9 @@ exports.modernTheme = {
             default: '#2d3436',
         },
     },
+    spacing: { ...styles_js_1.defaultSpacing },
+    imageAlign: 'left',
+    emojiFont: 'twemoji',
 };
 /** Academic — serif fonts, formal look inspired by LaTeX */
 exports.academicTheme = {
@@ -75,6 +78,9 @@ exports.academicTheme = {
             default: '#1a1a2e',
         },
     },
+    spacing: { ...styles_js_1.defaultSpacing },
+    imageAlign: 'left',
+    emojiFont: 'twemoji',
 };
 /** Minimal — lots of whitespace, muted greys */
 exports.minimalTheme = {
@@ -111,6 +117,9 @@ exports.minimalTheme = {
             default: '#333333',
         },
     },
+    spacing: { ...styles_js_1.defaultSpacing },
+    imageAlign: 'left',
+    emojiFont: 'twemoji',
 };
 /** Ocean — deep blue palette */
 exports.oceanTheme = {
@@ -147,6 +156,9 @@ exports.oceanTheme = {
             default: '#1b2631',
         },
     },
+    spacing: { ...styles_js_1.defaultSpacing },
+    imageAlign: 'left',
+    emojiFont: 'twemoji',
 };
 /** Record of all built-in themes keyed by display name */
 exports.themes = {

package/dist/types.d.ts

@@ -23,12 +23,15 @@ export interface CodeStyle {
 }
 export interface CodeBlockStyle extends CodeStyle {
     padding: number;
+    borderRadius?: number;
 }
 export interface BlockquoteStyle {
     borderColor: string;
     borderWidth: number;
     italic: boolean;
     indent: number;
+    backgroundColor?: string;
+    padding?: number;
 }
 export interface TableStyles {
     headerBackground: string;
@@ -49,6 +52,16 @@ export interface SyntaxHighlightTheme {
     lineHighlight: string;
     tokens: TokenColors;
 }
+export interface SpacingConfig {
+    headingSpaceAbove?: number;
+    headingSpaceBelow?: number;
+    paragraphSpacing?: number;
+    listItemSpacing?: number;
+    listIndent?: number;
+    blockquoteSpacing?: number;
+    codeBlockSpacing?: number;
+    hrSpacing?: number;
+}
 export interface ThemeConfig {
     headings: {
         h1: TextStyle;
@@ -72,6 +85,16 @@ export interface ThemeConfig {
      * When omitted, falls back to a VS Code Dark+ inspired palette.
      */
     syntaxHighlight?: SyntaxHighlightTheme;
+    /** Configurable spacing multipliers and indentation values. */
+    spacing?: SpacingConfig;
+    /** Image horizontal alignment. */
+    imageAlign?: 'left' | 'center';
+    /** Emoji font to use for rendering emoji characters.
+     * - `'twemoji'` (default) — use the bundled Twemoji.Mozilla.ttf color emoji font.
+     * - `'openmoji'` — use the bundled OpenMoji-Color.ttf (COLR) emoji font.
+     * - `'none'` — disable emoji font; emoji render with the body font.
+     */
+    emojiFont?: 'twemoji' | 'openmoji' | 'none';
 }
 /**
  * A custom font definition providing font data for registration with PDFKit.
@@ -92,8 +115,6 @@ export interface CustomFontDefinition {
     /** 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 {
     theme?: ThemeConfig;
     pageLayout?: PageLayout;
@@ -151,20 +172,6 @@ export interface PdfOptions {
      * @default true
      */
     emojiFont?: boolean | string | Buffer;
-    /**
-     * Color emoji renderer.
-     *
-     * When provided, emoji characters are rendered as inline color PNG images
-     * (sourced from Twemoji SVGs) instead of monochrome font glyphs.
-     *
-     * Use `createNodeColorEmojiRenderer()` (Node.js) or
-     * `createBrowserColorEmojiRenderer()` (browser) to obtain a renderer.
-     *
-     * Takes priority over `emojiFont` for emoji that are successfully rendered.
-     * Emoji that fail to render (e.g. missing from Twemoji) fall back to the
-     * monochrome font or the body font.
-     */
-    colorEmoji?: ColorEmojiRenderer;
     /**
      * Custom font definitions to register with PDFKit.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speajus/markdown-to-pdf",
-  "version": "1.0.15",
+  "version": "1.0.16",
   "description": "A new project created with Intent by Augment.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -29,6 +29,8 @@
     "README.md"
   ],
   "scripts": {
+    "build:pdfkit": "node -e \"const fs=require('fs'),p=require('path'),{execSync:e}=require('child_process'),d=p.join('node_modules','pdfkit','js');if(!fs.existsSync(d)){const t='/tmp/pdfkit-build-'+Date.now();e('git clone --depth 1 --branch support-color-emoji-google https://github.com/jspears/pdfkit.git '+t,{stdio:'inherit'});const pd=p.resolve('node_modules/pdfkit');for(const f of['lib','rollup.config.js','.babelrc','yarn.lock']){const s=p.join(t,f);if(fs.existsSync(s)){e('cp -r '+s+' '+pd,{stdio:'inherit'})}}e('cd '+pd+' && npm install --ignore-scripts && npx rollup -c',{stdio:'inherit'});e('rm -rf '+t,{stdio:'inherit'})}\"",
+    "postinstall": "node -e \"if(require('fs').existsSync('src')){require('child_process').execSync('npm run build:pdfkit',{stdio:'inherit'})}\" || true",
     "docs:dev": "cd docs && $npm_execpath dev",
     "build": "tsc && mkdir -p dist/fonts && cp src/fonts/* dist/fonts/",
     "generate": "tsx samples/generate.ts",
@@ -50,7 +52,7 @@
   "dependencies": {
     "@resvg/resvg-js": "^2.6.2",
     "marked": "^17.0.2",
-    "pdfkit": "^0.17.2",
+    "pdfkit": "github:jspears/pdfkit#support-color-emoji-google",
     "prismjs": "^1.30.0"
   },
   "devDependencies": {

package/dist/color-emoji.d.ts

@@ -1,43 +0,0 @@
-/**
- * Color emoji rendering via SVG → PNG conversion.
- *
- * Converts emoji characters to color PNG images using Twemoji SVG assets,
- * with factory functions for Node.js and browser environments.
- */
-/** Pixel size at which emoji PNGs are rasterised (scaled to font size by PDFKit). */
-export declare const EMOJI_RENDER_SIZE = 128;
-/**
- * Convert an emoji string to its Twemoji SVG filename (without extension).
- *
- * Twemoji filenames use lower-case hex codepoints separated by hyphens,
- * with the variation selector U+FE0F omitted.
- *
- * @example
- *   emojiToTwemojiCodepoints('🎉')        // '1f389'
- *   emojiToTwemojiCodepoints('👨‍👩‍👧‍👦') // '1f468-200d-1f469-200d-1f467-200d-1f466'
- */
-export declare function emojiToTwemojiCodepoints(emoji: string): string;
-/** Build the full Twemoji CDN URL for a single emoji. */
-export declare function twemojiSvgUrl(emoji: string): string;
-/** Ensure the SVG has explicit pixel dimensions for consistent rasterisation. */
-export declare function sizeSvg(svg: string, size: number): string;
-/** Converts a single emoji string to a PNG `Buffer`. */
-export type ColorEmojiRenderer = (emoji: string) => Promise<Buffer>;
-/**
- * Creates a color-emoji renderer for **browser** environments.
- *
- * Fetches Twemoji SVGs via `fetch()`, rasterises them on a `<canvas>`, and
- * returns a PNG `Buffer`. Results are cached.
- */
-export declare function createBrowserColorEmojiRenderer(): ColorEmojiRenderer;
-/**
- * Scans the full markdown text for all unique emoji and pre-renders them to
- * PNG `Buffer`s.  The returned `Map` allows `renderTextWithEmoji` to stay
- * synchronous during rendering.
- *
- * @param text     The raw markdown (or any text) to scan.
- * @param renderer A `ColorEmojiRenderer` (Node.js or browser factory).
- * @param emojiRe  The emoji-matching regex (from `emoji.ts`).
- * @returns A `Map` from individual emoji string → PNG Buffer.
- */
-export declare function preRenderEmoji(text: string, renderer: ColorEmojiRenderer, emojiRe: RegExp): Promise<Map<string, Buffer>>;

package/dist/color-emoji.js

@@ -1,142 +0,0 @@
-"use strict";
-/**
- * Color emoji rendering via SVG → PNG conversion.
- *
- * Converts emoji characters to color PNG images using Twemoji SVG assets,
- * with factory functions for Node.js and browser environments.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EMOJI_RENDER_SIZE = void 0;
-exports.emojiToTwemojiCodepoints = emojiToTwemojiCodepoints;
-exports.twemojiSvgUrl = twemojiSvgUrl;
-exports.sizeSvg = sizeSvg;
-exports.createBrowserColorEmojiRenderer = createBrowserColorEmojiRenderer;
-exports.preRenderEmoji = preRenderEmoji;
-/**
- * Twemoji SVG CDN base URL.
- * Uses the community-maintained fork (`jdecked/twemoji`) since the original
- * Twitter project was discontinued.
- */
-const TWEMOJI_BASE = 'https://cdn.jsdelivr.net/gh/jdecked/twemoji@latest/assets/svg/';
-/** Pixel size at which emoji PNGs are rasterised (scaled to font size by PDFKit). */
-exports.EMOJI_RENDER_SIZE = 128;
-// ── Codepoint helpers ──────────────────────────────────────────────────────
-/**
- * Convert an emoji string to its Twemoji SVG filename (without extension).
- *
- * Twemoji filenames use lower-case hex codepoints separated by hyphens,
- * with the variation selector U+FE0F omitted.
- *
- * @example
- *   emojiToTwemojiCodepoints('🎉')        // '1f389'
- *   emojiToTwemojiCodepoints('👨‍👩‍👧‍👦') // '1f468-200d-1f469-200d-1f467-200d-1f466'
- */
-function emojiToTwemojiCodepoints(emoji) {
-    const cps = [];
-    for (const ch of emoji) {
-        const cp = ch.codePointAt(0);
-        if (cp === undefined)
-            continue;
-        // Twemoji filenames omit VS16 (U+FE0F)
-        if (cp === 0xfe0f)
-            continue;
-        cps.push(cp.toString(16));
-    }
-    return cps.join('-');
-}
-/** Build the full Twemoji CDN URL for a single emoji. */
-function twemojiSvgUrl(emoji) {
-    return `${TWEMOJI_BASE}${emojiToTwemojiCodepoints(emoji)}.svg`;
-}
-// ── SVG sizing ─────────────────────────────────────────────────────────────
-/** Ensure the SVG has explicit pixel dimensions for consistent rasterisation. */
-function sizeSvg(svg, size) {
-    // Replace existing width/height attributes …
-    let out = svg;
-    if (/width="[^"]*"/.test(out)) {
-        out = out.replace(/width="[^"]*"/, `width="${size}"`);
-        out = out.replace(/height="[^"]*"/, `height="${size}"`);
-        return out;
-    }
-    // … or insert them.
-    return out.replace('<svg', `<svg width="${size}" height="${size}"`);
-}
-// ── Browser factory ─────────────────────────────────────────────────────────
-/**
- * Creates a color-emoji renderer for **browser** environments.
- *
- * Fetches Twemoji SVGs via `fetch()`, rasterises them on a `<canvas>`, and
- * returns a PNG `Buffer`. Results are cached.
- */
-function createBrowserColorEmojiRenderer() {
-    const cache = new Map();
-    return async (emoji) => {
-        const hit = cache.get(emoji);
-        if (hit)
-            return hit;
-        const url = twemojiSvgUrl(emoji);
-        const res = await fetch(url);
-        if (!res.ok)
-            throw new Error(`HTTP ${res.status} fetching ${url}`);
-        const svgText = await res.text();
-        const sized = sizeSvg(svgText, exports.EMOJI_RENDER_SIZE);
-        // Render SVG → Canvas → PNG Blob → Buffer
-        const png = await new Promise((resolve, reject) => {
-            const img = new Image();
-            img.onload = () => {
-                const canvas = document.createElement('canvas');
-                canvas.width = exports.EMOJI_RENDER_SIZE;
-                canvas.height = exports.EMOJI_RENDER_SIZE;
-                const ctx = canvas.getContext('2d');
-                if (!ctx) {
-                    reject(new Error('Canvas 2D context unavailable'));
-                    return;
-                }
-                ctx.drawImage(img, 0, 0, exports.EMOJI_RENDER_SIZE, exports.EMOJI_RENDER_SIZE);
-                canvas.toBlob((blob) => {
-                    if (!blob) {
-                        reject(new Error('toBlob failed'));
-                        return;
-                    }
-                    blob.arrayBuffer().then((ab) => resolve(Buffer.from(ab)), reject);
-                }, 'image/png');
-            };
-            img.onerror = () => reject(new Error(`Failed to load SVG as image: ${url}`));
-            img.src = `data:image/svg+xml;base64,${btoa(sized)}`;
-        });
-        cache.set(emoji, png);
-        return png;
-    };
-}
-// ── Pre-render helper ───────────────────────────────────────────────────────
-/**
- * Scans the full markdown text for all unique emoji and pre-renders them to
- * PNG `Buffer`s.  The returned `Map` allows `renderTextWithEmoji` to stay
- * synchronous during rendering.
- *
- * @param text     The raw markdown (or any text) to scan.
- * @param renderer A `ColorEmojiRenderer` (Node.js or browser factory).
- * @param emojiRe  The emoji-matching regex (from `emoji.ts`).
- * @returns A `Map` from individual emoji string → PNG Buffer.
- */
-async function preRenderEmoji(text, renderer, emojiRe) {
-    const unique = new Set();
-    emojiRe.lastIndex = 0;
-    let m;
-    while ((m = emojiRe.exec(text)) !== null) {
-        unique.add(m[0]);
-    }
-    const map = new Map();
-    // Render all unique emoji in parallel
-    await Promise.all([...unique].map(async (emoji) => {
-        try {
-            const png = await renderer(emoji);
-            map.set(emoji, png);
-        }
-        catch {
-            // If a specific emoji fails (missing from Twemoji), skip it —
-            // it will fall back to the monochrome font or the body font.
-        }
-    }));
-    return map;
-}

package/dist/emoji.d.ts

@@ -1,35 +0,0 @@
-/**
- * Emoji detection and text segmentation utilities.
- *
- * Splits a string into runs of "emoji" vs "non-emoji" characters so the
- * renderer can switch to an emoji font (e.g. Noto Emoji) for glyph coverage.
- */
-export interface TextSegment {
-    text: string;
-    isEmoji: boolean;
-}
-/**
- * Returns `true` when the whole string is emoji (one or more).
- */
-export declare function isEmoji(text: string): boolean;
-/**
- * Split `text` into contiguous runs of emoji and non-emoji characters.
- *
- * Example:
- *   splitEmojiSegments("Hello 🎉🔥 world")
- *   => [
- *        { text: "Hello ", isEmoji: false },
- *        { text: "🎉🔥", isEmoji: true },
- *        { text: " world", isEmoji: false },
- *      ]
- */
-export declare function splitEmojiSegments(text: string): TextSegment[];
-/**
- * Quick check: does the string contain at least one emoji?
- */
-export declare function containsEmoji(text: string): boolean;
-/**
- * Returns the module-level emoji regex.  Useful for external callers
- * (e.g. `preRenderEmoji`) that need to scan text with the same pattern.
- */
-export declare function getEmojiRegex(): RegExp;

package/dist/emoji.js

@@ -1,137 +0,0 @@
-"use strict";
-/**
- * Emoji detection and text segmentation utilities.
- *
- * Splits a string into runs of "emoji" vs "non-emoji" characters so the
- * renderer can switch to an emoji font (e.g. Noto Emoji) for glyph coverage.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isEmoji = isEmoji;
-exports.splitEmojiSegments = splitEmojiSegments;
-exports.containsEmoji = containsEmoji;
-exports.getEmojiRegex = getEmojiRegex;
-/**
- * Regex that matches a single emoji "unit".
- *
- * Covers:
- *  - Emoji presentation sequences  (base + U+FE0F)
- *  - Keycap sequences              (digit + U+FE0F + U+20E3)
- *  - Flag sequences                (regional indicators)
- *  - ZWJ sequences                 (family, profession, etc.)
- *  - Tag sequences                 (e.g. England flag)
- *  - Modifier sequences            (skin-tone)
- *  - Standalone emoji codepoints   in Emoticons, Dingbats, Symbols, etc.
- *
- * We use a wide net via Unicode property escapes where the runtime supports
- * them, falling back to explicit ranges for broad compatibility.
- */
-const EMOJI_RE = buildEmojiRegex();
-function buildEmojiRegex() {
-    // Modern runtimes (Node 10+) support Unicode property escapes.
-    // We try that first because it is maintained by the Unicode consortium
-    // and stays current with new emoji releases.
-    try {
-        // \p{Emoji_Presentation} — characters rendered as emoji by default
-        // \p{Emoji_Modifier_Base} — characters that accept skin-tone modifiers
-        // The rest handles ZWJ, keycap, flag, and tag sequences.
-        return new RegExp(
-        // Regional indicator flag pairs — MUST come first so that
-        // individual RI symbols are not consumed by the ZWJ / standalone
-        // branches before they can pair up.
-        '(?:[\\u{1F1E6}-\\u{1F1FF}]){2}' +
-            '|' +
-            // Tag sequences (e.g. flag of England)
-            '\\u{1F3F4}[\\u{E0060}-\\u{E007E}]+\\u{E007F}' +
-            '|' +
-            // Keycap sequences: digit/# /* + VS16 + combining enclosing keycap
-            '[0-9#*]\\uFE0F?\\u20E3' +
-            '|' +
-            // ZWJ sequences (family, professions, etc.)
-            '(?:' +
-            '(?:\\p{Emoji_Presentation}|\\p{Emoji_Modifier_Base})' +
-            '(?:\\p{Emoji_Modifier})?' +
-            '(?:\\u200D(?:\\p{Emoji_Presentation}|\\p{Emoji_Modifier_Base})(?:\\p{Emoji_Modifier})?)*)' +
-            '|' +
-            // Standalone emoji with optional VS16 — exclude RI range
-            // (U+1F1E6–U+1F1FF) so lone indicators don't match here.
-            '[\\u{1F000}-\\u{1F1E5}\\u{1F200}-\\u{1FAFF}\\u{2600}-\\u{27BF}\\u{2300}-\\u{23FF}\\u{2B50}\\u{2B55}\\u{FE00}-\\u{FE0F}\\u{200D}]\\uFE0F?' +
-            '', 'gu');
-    }
-    catch {
-        // Fallback: cover the most common emoji ranges without property escapes.
-        return new RegExp('[' +
-            '\\u{1F600}-\\u{1F64F}' + // Emoticons
-            '\\u{1F300}-\\u{1F5FF}' + // Misc Symbols & Pictographs
-            '\\u{1F680}-\\u{1F6FF}' + // Transport & Map
-            '\\u{1F900}-\\u{1F9FF}' + // Supplemental Symbols
-            '\\u{1FA00}-\\u{1FA6F}' + // Chess Symbols
-            '\\u{1FA70}-\\u{1FAFF}' + // Symbols Extended-A
-            '\\u{2600}-\\u{26FF}' + // Misc Symbols
-            '\\u{2700}-\\u{27BF}' + // Dingbats
-            '\\u{FE00}-\\u{FE0F}' + // Variation Selectors
-            '\\u{200D}' + // ZWJ
-            '\\u{1F1E6}-\\u{1F1FF}' + // Regional Indicators
-            ']+', 'gu');
-    }
-}
-/**
- * Returns `true` when the whole string is emoji (one or more).
- */
-function isEmoji(text) {
-    const stripped = text.replace(EMOJI_RE, '');
-    return stripped.trim().length === 0 && text.length > 0;
-}
-/**
- * Split `text` into contiguous runs of emoji and non-emoji characters.
- *
- * Example:
- *   splitEmojiSegments("Hello 🎉🔥 world")
- *   => [
- *        { text: "Hello ", isEmoji: false },
- *        { text: "🎉🔥", isEmoji: true },
- *        { text: " world", isEmoji: false },
- *      ]
- */
-function splitEmojiSegments(text) {
-    if (!text)
-        return [];
-    const segments = [];
-    let lastIndex = 0;
-    // Reset global regex state
-    EMOJI_RE.lastIndex = 0;
-    let match;
-    while ((match = EMOJI_RE.exec(text)) !== null) {
-        // Push any non-emoji text before this match
-        if (match.index > lastIndex) {
-            segments.push({ text: text.slice(lastIndex, match.index), isEmoji: false });
-        }
-        // Merge consecutive emoji matches into one segment
-        const prev = segments[segments.length - 1];
-        if (prev && prev.isEmoji) {
-            prev.text += match[0];
-        }
-        else {
-            segments.push({ text: match[0], isEmoji: true });
-        }
-        lastIndex = EMOJI_RE.lastIndex;
-    }
-    // Trailing non-emoji text
-    if (lastIndex < text.length) {
-        segments.push({ text: text.slice(lastIndex), isEmoji: false });
-    }
-    return segments;
-}
-/**
- * Quick check: does the string contain at least one emoji?
- */
-function containsEmoji(text) {
-    EMOJI_RE.lastIndex = 0;
-    return EMOJI_RE.test(text);
-}
-/**
- * Returns the module-level emoji regex.  Useful for external callers
- * (e.g. `preRenderEmoji`) that need to scan text with the same pattern.
- */
-function getEmojiRegex() {
-    return EMOJI_RE;
-}

package/dist/node-color-emoji.d.ts

@@ -1,15 +0,0 @@
-/**
- * Node.js color emoji renderer using `@resvg/resvg-js`.
- *
- * Separated from `color-emoji.ts` so that the browser entry point
- * (`src/browser.ts`) can import the shared helpers and browser factory
- * without pulling in the native `@resvg/resvg-js` addon.
- */
-import type { ColorEmojiRenderer } from './color-emoji.js';
-/**
- * Creates a color-emoji renderer for **Node.js** using `@resvg/resvg-js`.
- *
- * Fetches Twemoji SVGs over HTTPS on first use and caches the resulting
- * PNGs for the lifetime of the returned function.
- */
-export declare function createNodeColorEmojiRenderer(): ColorEmojiRenderer;

package/dist/node-color-emoji.js

@@ -1,57 +0,0 @@
-"use strict";
-/**
- * Node.js color emoji renderer using `@resvg/resvg-js`.
- *
- * Separated from `color-emoji.ts` so that the browser entry point
- * (`src/browser.ts`) can import the shared helpers and browser factory
- * without pulling in the native `@resvg/resvg-js` addon.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createNodeColorEmojiRenderer = createNodeColorEmojiRenderer;
-const color_emoji_js_1 = require("./color-emoji.js");
-/**
- * Creates a color-emoji renderer for **Node.js** using `@resvg/resvg-js`.
- *
- * Fetches Twemoji SVGs over HTTPS on first use and caches the resulting
- * PNGs for the lifetime of the returned function.
- */
-function createNodeColorEmojiRenderer() {
-    const cache = new Map();
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const { Resvg } = require('@resvg/resvg-js');
-    function fetchSvg(url) {
-        return new Promise((resolve, reject) => {
-            // eslint-disable-next-line @typescript-eslint/no-require-imports
-            const mod = url.startsWith('https') ? require('https') : require('http');
-            mod.get(url, (res) => {
-                if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-                    res.resume();
-                    fetchSvg(res.headers.location).then(resolve, reject);
-                    return;
-                }
-                if (!res.statusCode || res.statusCode < 200 || res.statusCode >= 300) {
-                    res.resume();
-                    reject(new Error(`HTTP ${res.statusCode} fetching ${url}`));
-                    return;
-                }
-                const chunks = [];
-                res.on('data', (c) => chunks.push(c));
-                res.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
-                res.on('error', reject);
-            }).on('error', reject);
-        });
-    }
-    return async (emoji) => {
-        const hit = cache.get(emoji);
-        if (hit)
-            return hit;
-        const svg = await fetchSvg((0, color_emoji_js_1.twemojiSvgUrl)(emoji));
-        const sized = (0, color_emoji_js_1.sizeSvg)(svg, color_emoji_js_1.EMOJI_RENDER_SIZE);
-        const resvg = new Resvg(Buffer.from(sized), {
-            fitTo: { mode: 'width', value: color_emoji_js_1.EMOJI_RENDER_SIZE },
-        });
-        const png = Buffer.from(resvg.render().asPng());
-        cache.set(emoji, png);
-        return png;
-    };
-}