@bytechain.cn/colamd-themes 0.3.0

package/dist/renderer.js

@@ -0,0 +1,204 @@
+/**
+ * Puppeteer-based rendering engine for ColaMD HTML/PDF export.
+ *
+ * Uses @bytechain.cn/colamd/renderer to create a headless Milkdown editor,
+ * apply themes, render mermaid/math, and export standalone HTML or PDF.
+ *
+ * Architecture:
+ *   Local HTTP server (serves renderer.js + page HTML)
+ *     → Puppeteer page (same-origin, no CORS)
+ *       → createColaMDEditor()
+ *       → applyTheme() + setMarkdown() + ensureAllPluginsRendered()
+ *       → buildExportHTML() / page.pdf()
+ */
+import puppeteer from "puppeteer";
+import { createServer } from "node:http";
+import { existsSync, createReadStream } from "node:fs";
+import { resolve, dirname } from "node:path";
+// ── File resolution ──
+/** Locate the ColaMD renderer ESM bundle in node_modules. */
+function findRendererPath() {
+    const candidates = [
+        resolve(dirname(new URL(import.meta.url).pathname), "../node_modules/@bytechain.cn/colamd/dist/lib/colamd-renderer.js"),
+        resolve(process.cwd(), "node_modules/@bytechain.cn/colamd/dist/lib/colamd-renderer.js"),
+    ];
+    for (const p of candidates) {
+        if (existsSync(p))
+            return p;
+    }
+    throw new Error("Cannot find @bytechain.cn/colamd renderer. " +
+        "Install it: npm install @bytechain.cn/colamd");
+}
+// ── Local HTTP server ──
+const SHELL_HTML = `<!DOCTYPE html>
+<html><head>
+<meta charset="utf-8">
+<style>body{margin:0;padding:0}#editor{width:100%;min-height:100vh}</style>
+</head><body><div id="editor"></div></body></html>`;
+function startLocalServer(rendererPath) {
+    return new Promise((resolveStart, reject) => {
+        const server = createServer((req, res) => {
+            if (req.url === "/" || req.url === "/index.html") {
+                res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+                res.end(SHELL_HTML);
+            }
+            else if (req.url === "/colamd-renderer.js") {
+                res.writeHead(200, { "Content-Type": "application/javascript; charset=utf-8" });
+                createReadStream(rendererPath).pipe(res);
+            }
+            else {
+                res.writeHead(404);
+                res.end();
+            }
+        });
+        server.listen(0, "127.0.0.1", () => {
+            const addr = server.address();
+            const port = typeof addr === "object" && addr ? addr.port : 0;
+            resolveStart({
+                port,
+                close: () => new Promise((resolveClose) => server.close(() => resolveClose())),
+            });
+        });
+        server.on("error", reject);
+    });
+}
+// ── Renderer ──
+export class ColamdRenderer {
+    browser = null;
+    page = null;
+    server = null;
+    ready = false;
+    /** Launch Puppeteer and prepare the editor page. */
+    async init() {
+        if (this.browser)
+            return;
+        // Start local HTTP server for the renderer bundle
+        const rendererPath = findRendererPath();
+        this.server = await startLocalServer(rendererPath);
+        const origin = `http://127.0.0.1:${this.server.port}`;
+        // Launch Puppeteer
+        this.browser = await puppeteer.launch({
+            headless: true,
+            args: ["--no-sandbox", "--disable-setuid-sandbox"],
+        });
+        this.page = await this.browser.newPage();
+        // Navigate to shell page (same origin as renderer script)
+        await this.page.goto(`${origin}/`, { waitUntil: "domcontentloaded" });
+        // Load the ColaMD renderer as ESM (same-origin, no CORS)
+        await this.page.addScriptTag({
+            type: "module",
+            content: `
+        import { createColaMDEditor } from '${origin}/colamd-renderer.js';
+        window.__colamdReady = createColaMDEditor({
+          rootId: 'editor',
+          editable: false
+        }).then(handle => {
+          window.__colamdHandle = handle;
+          return true;
+        }).catch(err => {
+          window.__colamdError = err.message;
+          return false;
+        });
+      `,
+        });
+        // Wait for the editor to initialize
+        await this.page.waitForFunction(() => window.__colamdHandle || window.__colamdError, { timeout: 30000 });
+        const error = await this.page.evaluate(() => window.__colamdError);
+        if (error)
+            throw new Error(`Editor init failed: ${error}`);
+        this.ready = true;
+    }
+    /**
+     * Render markdown to a standalone HTML document.
+     */
+    async render(input) {
+        if (!this.ready || !this.page)
+            await this.init();
+        const page = this.page;
+        // Apply theme
+        if (input.themeName) {
+            await page.evaluate((name, css) => {
+                window.__colamdHandle.applyTheme(name, css || undefined);
+            }, input.themeName, input.customCSS);
+        }
+        // Set markdown content
+        await page.evaluate((md) => {
+            window.__colamdHandle.setMarkdown(md);
+        }, input.markdown);
+        // Wait for all plugins (mermaid, math) to finish rendering
+        await page.evaluate(async () => {
+            await window.__colamdHandle.ensureAllPluginsRendered();
+        });
+        // Additional settle time for complex diagrams
+        await new Promise((r) => setTimeout(r, 500));
+        // Build export HTML
+        const html = await page.evaluate(() => {
+            return window.__colamdHandle.buildExportHTML();
+        });
+        // Inject custom title if provided
+        const finalHtml = input.title
+            ? html.replace(/<title>[^<]*<\/title>/, `<title>${input.title}</title>`)
+            : html;
+        return { html: finalHtml };
+    }
+    /**
+     * Render markdown and export as PDF.
+     */
+    async exportPDF(input, options = {}) {
+        if (!this.ready || !this.page)
+            await this.init();
+        // First render to HTML
+        const { html } = await this.render(input);
+        // Load the HTML in a fresh page for PDF generation
+        const pdfPage = await this.browser.newPage();
+        await pdfPage.setContent(html, { waitUntil: "load", timeout: 30000 });
+        // Emulate screen media to preserve theme colors
+        await pdfPage.emulateMediaType("screen");
+        const pdfBuffer = await pdfPage.pdf({
+            format: options.format ?? "A4",
+            printBackground: options.printBackground ?? true,
+            margin: options.margin ?? { top: "15mm", right: "15mm", bottom: "15mm", left: "15mm" },
+        });
+        await pdfPage.close();
+        return Buffer.from(pdfBuffer);
+    }
+    /** Shut down the browser and local server. */
+    async close() {
+        if (this.browser) {
+            await this.browser.close();
+            this.browser = null;
+            this.page = null;
+            this.ready = false;
+        }
+        if (this.server) {
+            await this.server.close();
+            this.server = null;
+        }
+    }
+}
+/**
+ * One-shot render: init → render → close.
+ * Convenience for single-file export.
+ */
+export async function renderMarkdown(input) {
+    const renderer = new ColamdRenderer();
+    try {
+        return await renderer.render(input);
+    }
+    finally {
+        await renderer.close();
+    }
+}
+/**
+ * One-shot PDF export: init → render PDF → close.
+ */
+export async function renderPDF(input, options) {
+    const renderer = new ColamdRenderer();
+    try {
+        return await renderer.exportPDF(input, options);
+    }
+    finally {
+        await renderer.close();
+    }
+}
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"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"}