@bobfrankston/brother-label 1.0.13 → 1.1.1

package/render.d.ts

@@ -1,40 +1,17 @@
 /**
- * HTML to bitmap rendering module
- * Standalone utility for converting HTML to PNG images
+ * Backward-compat shim. The HTML rendering logic now lives in
+ * @bobfrankston/label-core. This file just re-exports those entry points so
+ * existing deep imports keep working.
  */
-export interface RenderOptions {
+export { renderHtmlString, renderHtmlFile, renderHtmlUrl, closeBrowser, type RenderOptions, } from "@bobfrankston/label-core";
+import { renderHtmlFile as _renderHtmlFile } from "@bobfrankston/label-core";
+/** @deprecated Use renderHtmlFile from @bobfrankston/label-core. */
+export declare const renderHtml: typeof _renderHtmlFile;
+/** @deprecated Render to a file by calling renderHtmlFile then fs.writeFileSync. */
+export declare function renderHtmlToFile(htmlPath: string, outputPath: string, options: {
     width?: number;
     height: number;
     tapeMm?: number;
     deviceScaleFactor?: number;
-    keepScale?: boolean;
-}
-/**
- * Close the shared browser instance
- */
-export declare function closeBrowser(): Promise<void>;
-/**
- * Render HTML file to PNG buffer
- * Processes <img qr="..."> tags to inline base64 QR codes
- */
-export declare function renderHtmlFile(htmlPath: string, options: RenderOptions): Promise<Buffer>;
-/**
- * Render HTML string to PNG buffer
- * Processes <img qr="..."> tags to inline base64 QR codes via DOM
- * @param html - HTML content string
- * @param options - Render dimensions (width auto-detected if omitted)
- * @param basePath - Optional base path for resolving relative resources
- */
-export declare function renderHtmlString(html: string, options: RenderOptions, basePath?: string): Promise<Buffer>;
-/**
- * Render HTML from URL to PNG buffer
- * Processes <img qr="..."> tags to inline base64 QR codes via DOM
- * If width is not specified, auto-detects from content
- */
-export declare function renderHtmlUrl(url: string, options: RenderOptions): Promise<Buffer>;
-/**
- * Render HTML file and save to PNG file
- */
-export declare function renderHtmlToFile(htmlPath: string, outputPath: string, options: RenderOptions): Promise<void>;
-export declare const renderHtml: typeof renderHtmlFile;
+}): Promise<void>;
 //# sourceMappingURL=render.d.ts.map

package/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["render.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,aAAa;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AA+ED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAKlD;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAM9F;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqE/G;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA+DxF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAClC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,GACvB,OAAO,CAAC,IAAI,CAAC,CAGf;AAGD,eAAO,MAAM,UAAU,uBAAiB,CAAC"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["render.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,YAAY,EACZ,KAAK,aAAa,GACrB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE7E,oEAAoE;AACpE,eAAO,MAAM,UAAU,wBAAkB,CAAC;AAE1C,oFAAoF;AACpF,wBAAsB,gBAAgB,CAClC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,GACzF,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/render.js

@@ -1,240 +1,16 @@
 /**
- * HTML to bitmap rendering module
- * Standalone utility for converting HTML to PNG images
- */
-import puppeteer from "puppeteer";
-import * as path from "path";
-import * as fs from "fs";
-import { Jimp } from "jimp";
-import QRCode from "qrcode";
-let browserInstance = null;
-const DEFAULT_SCALE = 3; // Render at 3x for quality, then scale down
-const CSS_DPI = 96; // CSS interprets mm at 96 DPI
-const MM_PER_INCH = 25.4;
-/**
- * Generate QR code data URLs for all qr attributes found in page
- * Returns map of qr data -> data URL
- */
-async function generateQrDataUrls(qrValues) {
-    const map = new Map();
-    for (const data of qrValues) {
-        if (!map.has(data)) {
-            const dataUrl = await QRCode.toDataURL(data, {
-                type: "image/png",
-                margin: 0,
-                errorCorrectionLevel: "M",
-                color: { dark: "#000000", light: "#ffffff" },
-            });
-            map.set(data, dataUrl);
-        }
-    }
-    return map;
-}
-/**
- * Process <img qr="..."> elements in page via DOM manipulation
- */
-async function processQrElements(page) {
-    // Get all qr attribute values from the page
-    const qrValues = await page.evaluate(() => {
-        const imgs = document.querySelectorAll("img[qr]");
-        return Array.from(imgs).map(img => img.getAttribute("qr") || "");
-    });
-    if (qrValues.length === 0)
-        return;
-    // Generate QR codes
-    const qrMap = await generateQrDataUrls(qrValues);
-    // Convert map to object for passing to page context
-    const qrUrls = {};
-    qrMap.forEach((url, data) => { qrUrls[data] = url; });
-    // Replace qr attributes with src in the DOM
-    await page.evaluate((urls) => {
-        const imgs = document.querySelectorAll("img[qr]");
-        imgs.forEach(img => {
-            const qrData = img.getAttribute("qr");
-            if (qrData && urls[qrData]) {
-                img.setAttribute("src", urls[qrData]);
-                img.removeAttribute("qr");
-            }
-        });
-    }, qrUrls);
-}
-/**
- * Scale image buffer down to target dimensions
- */
-async function scaleDown(buffer, targetWidth, targetHeight) {
-    const image = await Jimp.read(buffer);
-    image.resize({ w: targetWidth, h: targetHeight });
-    return image.getBuffer("image/png");
-}
-/**
- * Get or create a shared browser instance for better performance
- */
-async function getBrowser() {
-    if (!browserInstance || !browserInstance.connected) {
-        browserInstance = await puppeteer.launch({ headless: true });
-    }
-    return browserInstance;
-}
-/**
- * Close the shared browser instance
- */
-export async function closeBrowser() {
-    if (browserInstance) {
-        await browserInstance.close();
-        browserInstance = null;
-    }
-}
-/**
- * Render HTML file to PNG buffer
- * Processes <img qr="..."> tags to inline base64 QR codes
- */
-export async function renderHtmlFile(htmlPath, options) {
-    const absolutePath = path.resolve(htmlPath);
-    if (!fs.existsSync(absolutePath)) {
-        throw new Error(`HTML file not found: ${absolutePath}`);
-    }
-    return renderHtmlUrl(`file://${absolutePath}`, options);
-}
-/**
- * Render HTML string to PNG buffer
- * Processes <img qr="..."> tags to inline base64 QR codes via DOM
- * @param html - HTML content string
- * @param options - Render dimensions (width auto-detected if omitted)
- * @param basePath - Optional base path for resolving relative resources
- */
-export async function renderHtmlString(html, options, basePath) {
-    const browser = await getBrowser();
-    const page = await browser.newPage();
-    const scaleFactor = options.deviceScaleFactor ?? DEFAULT_SCALE;
-    const autoWidth = !options.width || options.width === 0;
-    // If tapeMm provided, use CSS-equivalent viewport height; otherwise use target height directly
-    const cssHeight = options.tapeMm
-        ? Math.round(options.tapeMm * CSS_DPI / MM_PER_INCH)
-        : options.height;
-    const targetHeight = options.height;
-    try {
-        // Use large initial width for auto-detection, or specified width
-        const initialWidth = autoWidth ? 4000 : options.width;
-        await page.setViewport({
-            width: initialWidth,
-            height: cssHeight,
-            deviceScaleFactor: scaleFactor,
-        });
-        if (basePath) {
-            // Set base URL for relative resource resolution
-            const baseUrl = `file://${path.resolve(basePath)}/`;
-            await page.goto(baseUrl, { waitUntil: "domcontentloaded" });
-            await page.setContent(html, { waitUntil: "networkidle0" });
-        }
-        else {
-            await page.setContent(html, { waitUntil: "networkidle0" });
-        }
-        // Process <img qr="..."> elements
-        await processQrElements(page);
-        // Auto-detect content width if needed
-        let finalCssWidth = initialWidth;
-        if (autoWidth) {
-            finalCssWidth = await page.evaluate(() => {
-                // Try first child of body (likely the main container)
-                const firstChild = document.body.firstElementChild;
-                if (firstChild) {
-                    const rect = firstChild.getBoundingClientRect();
-                    if (rect.width > 0 && rect.width < 3000) {
-                        return Math.ceil(rect.width);
-                    }
-                }
-                // Fall back to scroll width (actual content width)
-                return document.body.scrollWidth;
-            });
-            await page.setViewport({
-                width: finalCssWidth,
-                height: cssHeight,
-                deviceScaleFactor: scaleFactor,
-            });
-        }
-        const pngBuffer = await page.screenshot({ type: "png" });
-        // Scale to target dimensions
-        // If tapeMm was used, scale from CSS dimensions to target 300 DPI dimensions
-        const scale = targetHeight / cssHeight;
-        const finalWidth = Math.round(finalCssWidth * scale);
-        if (scaleFactor > 1 || options.tapeMm) {
-            return scaleDown(Buffer.from(pngBuffer), finalWidth, targetHeight);
-        }
-        return Buffer.from(pngBuffer);
-    }
-    finally {
-        await page.close();
-    }
-}
-/**
- * Render HTML from URL to PNG buffer
- * Processes <img qr="..."> tags to inline base64 QR codes via DOM
- * If width is not specified, auto-detects from content
- */
-export async function renderHtmlUrl(url, options) {
-    const browser = await getBrowser();
-    const page = await browser.newPage();
-    const scaleFactor = options.deviceScaleFactor ?? DEFAULT_SCALE;
-    const autoWidth = !options.width || options.width === 0;
-    // If tapeMm provided, use CSS-equivalent viewport height; otherwise use target height directly
-    const cssHeight = options.tapeMm
-        ? Math.round(options.tapeMm * CSS_DPI / MM_PER_INCH)
-        : options.height;
-    const targetHeight = options.height;
-    try {
-        // Use large initial width for auto-detection, or specified width
-        const initialWidth = autoWidth ? 4000 : options.width;
-        await page.setViewport({
-            width: initialWidth,
-            height: cssHeight,
-            deviceScaleFactor: scaleFactor,
-        });
-        await page.goto(url, { waitUntil: "networkidle0" });
-        // Process <img qr="..."> elements
-        await processQrElements(page);
-        // Auto-detect content width if needed
-        let finalCssWidth = initialWidth;
-        if (autoWidth) {
-            finalCssWidth = await page.evaluate(() => {
-                // Try first child of body (likely the main container)
-                const firstChild = document.body.firstElementChild;
-                if (firstChild) {
-                    const rect = firstChild.getBoundingClientRect();
-                    if (rect.width > 0 && rect.width < 3000) {
-                        return Math.ceil(rect.width);
-                    }
-                }
-                // Fall back to scroll width (actual content width)
-                return document.body.scrollWidth;
-            });
-            // Resize viewport to actual content width
-            await page.setViewport({
-                width: finalCssWidth,
-                height: cssHeight,
-                deviceScaleFactor: scaleFactor,
-            });
-        }
-        const pngBuffer = await page.screenshot({ type: "png" });
-        // Scale to target dimensions
-        // If tapeMm was used, scale from CSS dimensions to target 300 DPI dimensions
-        const scale = targetHeight / cssHeight;
-        const finalWidth = Math.round(finalCssWidth * scale);
-        if (scaleFactor > 1 || options.tapeMm) {
-            return scaleDown(Buffer.from(pngBuffer), finalWidth, targetHeight);
-        }
-        return Buffer.from(pngBuffer);
-    }
-    finally {
-        await page.close();
-    }
-}
-/**
- * Render HTML file and save to PNG file
- */
+ * Backward-compat shim. The HTML rendering logic now lives in
+ * @bobfrankston/label-core. This file just re-exports those entry points so
+ * existing deep imports keep working.
+ */
+export { renderHtmlString, renderHtmlFile, renderHtmlUrl, closeBrowser, } from "@bobfrankston/label-core";
+import { renderHtmlFile as _renderHtmlFile } from "@bobfrankston/label-core";
+/** @deprecated Use renderHtmlFile from @bobfrankston/label-core. */
+export const renderHtml = _renderHtmlFile;
+/** @deprecated Render to a file by calling renderHtmlFile then fs.writeFileSync. */
 export async function renderHtmlToFile(htmlPath, outputPath, options) {
-    const buffer = await renderHtmlFile(htmlPath, options);
+    const fs = await import("fs");
+    const buffer = await _renderHtmlFile(htmlPath, options);
     fs.writeFileSync(outputPath, buffer);
 }
-// Legacy export for compatibility
-export const renderHtml = renderHtmlFile;
 //# sourceMappingURL=render.js.map

package/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["render.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * HTML to bitmap rendering module\r\n * Standalone utility for converting HTML to PNG images\r\n */\r\n\r\nimport puppeteer, { Browser } from \"puppeteer\";\r\nimport * as path from \"path\";\r\nimport * as fs from \"fs\";\r\nimport { Jimp } from \"jimp\";\r\nimport QRCode from \"qrcode\";\r\n\r\nexport interface RenderOptions {\r\n    width?: number;              // If omitted or 0, auto-detect from content\r\n    height: number;              // Target output height in pixels (300 DPI)\r\n    tapeMm?: number;             // Tape size in mm - if set, viewport matches CSS mm interpretation\r\n    deviceScaleFactor?: number;  // Default 3 for high quality (288 DPI effective)\r\n    keepScale?: boolean;         // If true, don't scale down - keep full resolution output\r\n}\r\n\r\nlet browserInstance: Browser | null = null;\r\n\r\nconst DEFAULT_SCALE = 3;  // Render at 3x for quality, then scale down\r\nconst CSS_DPI = 96;       // CSS interprets mm at 96 DPI\r\nconst MM_PER_INCH = 25.4;\r\n\r\n/**\r\n * Generate QR code data URLs for all qr attributes found in page\r\n * Returns map of qr data -> data URL\r\n */\r\nasync function generateQrDataUrls(qrValues: string[]): Promise<Map<string, string>> {\r\n    const map = new Map<string, string>();\r\n    for (const data of qrValues) {\r\n        if (!map.has(data)) {\r\n            const dataUrl = await QRCode.toDataURL(data, {\r\n                type: \"image/png\",\r\n                margin: 0,\r\n                errorCorrectionLevel: \"M\",\r\n                color: { dark: \"#000000\", light: \"#ffffff\" },\r\n            });\r\n            map.set(data, dataUrl);\r\n        }\r\n    }\r\n    return map;\r\n}\r\n\r\n/**\r\n * Process <img qr=\"...\"> elements in page via DOM manipulation\r\n */\r\nasync function processQrElements(page: puppeteer.Page): Promise<void> {\r\n    // Get all qr attribute values from the page\r\n    const qrValues = await page.evaluate(() => {\r\n        const imgs = document.querySelectorAll(\"img[qr]\");\r\n        return Array.from(imgs).map(img => img.getAttribute(\"qr\") || \"\");\r\n    });\r\n\r\n    if (qrValues.length === 0) return;\r\n\r\n    // Generate QR codes\r\n    const qrMap = await generateQrDataUrls(qrValues);\r\n\r\n    // Convert map to object for passing to page context\r\n    const qrUrls: Record<string, string> = {};\r\n    qrMap.forEach((url, data) => { qrUrls[data] = url; });\r\n\r\n    // Replace qr attributes with src in the DOM\r\n    await page.evaluate((urls: Record<string, string>) => {\r\n        const imgs = document.querySelectorAll(\"img[qr]\");\r\n        imgs.forEach(img => {\r\n            const qrData = img.getAttribute(\"qr\");\r\n            if (qrData && urls[qrData]) {\r\n                img.setAttribute(\"src\", urls[qrData]);\r\n                img.removeAttribute(\"qr\");\r\n            }\r\n        });\r\n    }, qrUrls);\r\n}\r\n\r\n/**\r\n * Scale image buffer down to target dimensions\r\n */\r\nasync function scaleDown(buffer: Buffer, targetWidth: number, targetHeight: number): Promise<Buffer> {\r\n    const image = await Jimp.read(buffer);\r\n    image.resize({ w: targetWidth, h: targetHeight });\r\n    return image.getBuffer(\"image/png\");\r\n}\r\n\r\n/**\r\n * Get or create a shared browser instance for better performance\r\n */\r\nasync function getBrowser(): Promise<Browser> {\r\n    if (!browserInstance || !browserInstance.connected) {\r\n        browserInstance = await puppeteer.launch({ headless: true });\r\n    }\r\n    return browserInstance;\r\n}\r\n\r\n/**\r\n * Close the shared browser instance\r\n */\r\nexport async function closeBrowser(): Promise<void> {\r\n    if (browserInstance) {\r\n        await browserInstance.close();\r\n        browserInstance = null;\r\n    }\r\n}\r\n\r\n/**\r\n * Render HTML file to PNG buffer\r\n * Processes <img qr=\"...\"> tags to inline base64 QR codes\r\n */\r\nexport async function renderHtmlFile(htmlPath: string, options: RenderOptions): Promise<Buffer> {\r\n    const absolutePath = path.resolve(htmlPath);\r\n    if (!fs.existsSync(absolutePath)) {\r\n        throw new Error(`HTML file not found: ${absolutePath}`);\r\n    }\r\n    return renderHtmlUrl(`file://${absolutePath}`, options);\r\n}\r\n\r\n/**\r\n * Render HTML string to PNG buffer\r\n * Processes <img qr=\"...\"> tags to inline base64 QR codes via DOM\r\n * @param html - HTML content string\r\n * @param options - Render dimensions (width auto-detected if omitted)\r\n * @param basePath - Optional base path for resolving relative resources\r\n */\r\nexport async function renderHtmlString(html: string, options: RenderOptions, basePath?: string): Promise<Buffer> {\r\n    const browser = await getBrowser();\r\n    const page = await browser.newPage();\r\n    const scaleFactor = options.deviceScaleFactor ?? DEFAULT_SCALE;\r\n    const autoWidth = !options.width || options.width === 0;\r\n\r\n    // If tapeMm provided, use CSS-equivalent viewport height; otherwise use target height directly\r\n    const cssHeight = options.tapeMm\r\n        ? Math.round(options.tapeMm * CSS_DPI / MM_PER_INCH)\r\n        : options.height;\r\n    const targetHeight = options.height;\r\n\r\n    try {\r\n        // Use large initial width for auto-detection, or specified width\r\n        const initialWidth = autoWidth ? 4000 : options.width!;\r\n        await page.setViewport({\r\n            width: initialWidth,\r\n            height: cssHeight,\r\n            deviceScaleFactor: scaleFactor,\r\n        });\r\n\r\n        if (basePath) {\r\n            // Set base URL for relative resource resolution\r\n            const baseUrl = `file://${path.resolve(basePath)}/`;\r\n            await page.goto(baseUrl, { waitUntil: \"domcontentloaded\" });\r\n            await page.setContent(html, { waitUntil: \"networkidle0\" });\r\n        } else {\r\n            await page.setContent(html, { waitUntil: \"networkidle0\" });\r\n        }\r\n\r\n        // Process <img qr=\"...\"> elements\r\n        await processQrElements(page);\r\n\r\n        // Auto-detect content width if needed\r\n        let finalCssWidth = initialWidth;\r\n        if (autoWidth) {\r\n            finalCssWidth = await page.evaluate(() => {\r\n                // Try first child of body (likely the main container)\r\n                const firstChild = document.body.firstElementChild as HTMLElement;\r\n                if (firstChild) {\r\n                    const rect = firstChild.getBoundingClientRect();\r\n                    if (rect.width > 0 && rect.width < 3000) {\r\n                        return Math.ceil(rect.width);\r\n                    }\r\n                }\r\n                // Fall back to scroll width (actual content width)\r\n                return document.body.scrollWidth;\r\n            });\r\n            await page.setViewport({\r\n                width: finalCssWidth,\r\n                height: cssHeight,\r\n                deviceScaleFactor: scaleFactor,\r\n            });\r\n        }\r\n\r\n        const pngBuffer = await page.screenshot({ type: \"png\" });\r\n\r\n        // Scale to target dimensions\r\n        // If tapeMm was used, scale from CSS dimensions to target 300 DPI dimensions\r\n        const scale = targetHeight / cssHeight;\r\n        const finalWidth = Math.round(finalCssWidth * scale);\r\n\r\n        if (scaleFactor > 1 || options.tapeMm) {\r\n            return scaleDown(Buffer.from(pngBuffer), finalWidth, targetHeight);\r\n        }\r\n        return Buffer.from(pngBuffer);\r\n    } finally {\r\n        await page.close();\r\n    }\r\n}\r\n\r\n/**\r\n * Render HTML from URL to PNG buffer\r\n * Processes <img qr=\"...\"> tags to inline base64 QR codes via DOM\r\n * If width is not specified, auto-detects from content\r\n */\r\nexport async function renderHtmlUrl(url: string, options: RenderOptions): Promise<Buffer> {\r\n    const browser = await getBrowser();\r\n    const page = await browser.newPage();\r\n    const scaleFactor = options.deviceScaleFactor ?? DEFAULT_SCALE;\r\n    const autoWidth = !options.width || options.width === 0;\r\n\r\n    // If tapeMm provided, use CSS-equivalent viewport height; otherwise use target height directly\r\n    const cssHeight = options.tapeMm\r\n        ? Math.round(options.tapeMm * CSS_DPI / MM_PER_INCH)\r\n        : options.height;\r\n    const targetHeight = options.height;\r\n\r\n    try {\r\n        // Use large initial width for auto-detection, or specified width\r\n        const initialWidth = autoWidth ? 4000 : options.width!;\r\n        await page.setViewport({\r\n            width: initialWidth,\r\n            height: cssHeight,\r\n            deviceScaleFactor: scaleFactor,\r\n        });\r\n\r\n        await page.goto(url, { waitUntil: \"networkidle0\" });\r\n\r\n        // Process <img qr=\"...\"> elements\r\n        await processQrElements(page);\r\n\r\n        // Auto-detect content width if needed\r\n        let finalCssWidth = initialWidth;\r\n        if (autoWidth) {\r\n            finalCssWidth = await page.evaluate(() => {\r\n                // Try first child of body (likely the main container)\r\n                const firstChild = document.body.firstElementChild as HTMLElement;\r\n                if (firstChild) {\r\n                    const rect = firstChild.getBoundingClientRect();\r\n                    if (rect.width > 0 && rect.width < 3000) {\r\n                        return Math.ceil(rect.width);\r\n                    }\r\n                }\r\n                // Fall back to scroll width (actual content width)\r\n                return document.body.scrollWidth;\r\n            });\r\n            // Resize viewport to actual content width\r\n            await page.setViewport({\r\n                width: finalCssWidth,\r\n                height: cssHeight,\r\n                deviceScaleFactor: scaleFactor,\r\n            });\r\n        }\r\n\r\n        const pngBuffer = await page.screenshot({ type: \"png\" });\r\n\r\n        // Scale to target dimensions\r\n        // If tapeMm was used, scale from CSS dimensions to target 300 DPI dimensions\r\n        const scale = targetHeight / cssHeight;\r\n        const finalWidth = Math.round(finalCssWidth * scale);\r\n\r\n        if (scaleFactor > 1 || options.tapeMm) {\r\n            return scaleDown(Buffer.from(pngBuffer), finalWidth, targetHeight);\r\n        }\r\n        return Buffer.from(pngBuffer);\r\n    } finally {\r\n        await page.close();\r\n    }\r\n}\r\n\r\n/**\r\n * Render HTML file and save to PNG file\r\n */\r\nexport async function renderHtmlToFile(\r\n    htmlPath: string,\r\n    outputPath: string,\r\n    options: RenderOptions\r\n): Promise<void> {\r\n    const buffer = await renderHtmlFile(htmlPath, options);\r\n    fs.writeFileSync(outputPath, buffer);\r\n}\r\n\r\n// Legacy export for compatibility\r\nexport const renderHtml = renderHtmlFile;\r\n"]}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["render.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,YAAY,GAEf,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE7E,oEAAoE;AACpE,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAC;AAE1C,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,QAAgB,EAChB,UAAkB,EAClB,OAAwF;IAExF,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxD,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC","sourcesContent":["/**\n * Backward-compat shim. The HTML rendering logic now lives in\n * @bobfrankston/label-core. This file just re-exports those entry points so\n * existing deep imports keep working.\n */\n\nexport {\n    renderHtmlString,\n    renderHtmlFile,\n    renderHtmlUrl,\n    closeBrowser,\n    type RenderOptions,\n} from \"@bobfrankston/label-core\";\n\nimport { renderHtmlFile as _renderHtmlFile } from \"@bobfrankston/label-core\";\n\n/** @deprecated Use renderHtmlFile from @bobfrankston/label-core. */\nexport const renderHtml = _renderHtmlFile;\n\n/** @deprecated Render to a file by calling renderHtmlFile then fs.writeFileSync. */\nexport async function renderHtmlToFile(\n    htmlPath: string,\n    outputPath: string,\n    options: { width?: number; height: number; tapeMm?: number; deviceScaleFactor?: number }\n): Promise<void> {\n    const fs = await import(\"fs\");\n    const buffer = await _renderHtmlFile(htmlPath, options);\n    fs.writeFileSync(outputPath, buffer);\n}\n"]}

package/render.ts

@@ -1,280 +1,29 @@
-/**
- * HTML to bitmap rendering module
- * Standalone utility for converting HTML to PNG images
- */
-
-import puppeteer, { Browser } from "puppeteer";
-import * as path from "path";
-import * as fs from "fs";
-import { Jimp } from "jimp";
-import QRCode from "qrcode";
-
-export interface RenderOptions {
-    width?: number;              // If omitted or 0, auto-detect from content
-    height: number;              // Target output height in pixels (300 DPI)
-    tapeMm?: number;             // Tape size in mm - if set, viewport matches CSS mm interpretation
-    deviceScaleFactor?: number;  // Default 3 for high quality (288 DPI effective)
-    keepScale?: boolean;         // If true, don't scale down - keep full resolution output
-}
-
-let browserInstance: Browser | null = null;
-
-const DEFAULT_SCALE = 3;  // Render at 3x for quality, then scale down
-const CSS_DPI = 96;       // CSS interprets mm at 96 DPI
-const MM_PER_INCH = 25.4;
-
-/**
- * Generate QR code data URLs for all qr attributes found in page
- * Returns map of qr data -> data URL
- */
-async function generateQrDataUrls(qrValues: string[]): Promise<Map<string, string>> {
-    const map = new Map<string, string>();
-    for (const data of qrValues) {
-        if (!map.has(data)) {
-            const dataUrl = await QRCode.toDataURL(data, {
-                type: "image/png",
-                margin: 0,
-                errorCorrectionLevel: "M",
-                color: { dark: "#000000", light: "#ffffff" },
-            });
-            map.set(data, dataUrl);
-        }
-    }
-    return map;
-}
-
-/**
- * Process <img qr="..."> elements in page via DOM manipulation
- */
-async function processQrElements(page: puppeteer.Page): Promise<void> {
-    // Get all qr attribute values from the page
-    const qrValues = await page.evaluate(() => {
-        const imgs = document.querySelectorAll("img[qr]");
-        return Array.from(imgs).map(img => img.getAttribute("qr") || "");
-    });
-
-    if (qrValues.length === 0) return;
-
-    // Generate QR codes
-    const qrMap = await generateQrDataUrls(qrValues);
-
-    // Convert map to object for passing to page context
-    const qrUrls: Record<string, string> = {};
-    qrMap.forEach((url, data) => { qrUrls[data] = url; });
-
-    // Replace qr attributes with src in the DOM
-    await page.evaluate((urls: Record<string, string>) => {
-        const imgs = document.querySelectorAll("img[qr]");
-        imgs.forEach(img => {
-            const qrData = img.getAttribute("qr");
-            if (qrData && urls[qrData]) {
-                img.setAttribute("src", urls[qrData]);
-                img.removeAttribute("qr");
-            }
-        });
-    }, qrUrls);
-}
-
-/**
- * Scale image buffer down to target dimensions
- */
-async function scaleDown(buffer: Buffer, targetWidth: number, targetHeight: number): Promise<Buffer> {
-    const image = await Jimp.read(buffer);
-    image.resize({ w: targetWidth, h: targetHeight });
-    return image.getBuffer("image/png");
-}
-
-/**
- * Get or create a shared browser instance for better performance
- */
-async function getBrowser(): Promise<Browser> {
-    if (!browserInstance || !browserInstance.connected) {
-        browserInstance = await puppeteer.launch({ headless: true });
-    }
-    return browserInstance;
-}
-
-/**
- * Close the shared browser instance
- */
-export async function closeBrowser(): Promise<void> {
-    if (browserInstance) {
-        await browserInstance.close();
-        browserInstance = null;
-    }
-}
-
-/**
- * Render HTML file to PNG buffer
- * Processes <img qr="..."> tags to inline base64 QR codes
- */
-export async function renderHtmlFile(htmlPath: string, options: RenderOptions): Promise<Buffer> {
-    const absolutePath = path.resolve(htmlPath);
-    if (!fs.existsSync(absolutePath)) {
-        throw new Error(`HTML file not found: ${absolutePath}`);
-    }
-    return renderHtmlUrl(`file://${absolutePath}`, options);
-}
-
-/**
- * Render HTML string to PNG buffer
- * Processes <img qr="..."> tags to inline base64 QR codes via DOM
- * @param html - HTML content string
- * @param options - Render dimensions (width auto-detected if omitted)
- * @param basePath - Optional base path for resolving relative resources
- */
-export async function renderHtmlString(html: string, options: RenderOptions, basePath?: string): Promise<Buffer> {
-    const browser = await getBrowser();
-    const page = await browser.newPage();
-    const scaleFactor = options.deviceScaleFactor ?? DEFAULT_SCALE;
-    const autoWidth = !options.width || options.width === 0;
-
-    // If tapeMm provided, use CSS-equivalent viewport height; otherwise use target height directly
-    const cssHeight = options.tapeMm
-        ? Math.round(options.tapeMm * CSS_DPI / MM_PER_INCH)
-        : options.height;
-    const targetHeight = options.height;
-
-    try {
-        // Use large initial width for auto-detection, or specified width
-        const initialWidth = autoWidth ? 4000 : options.width!;
-        await page.setViewport({
-            width: initialWidth,
-            height: cssHeight,
-            deviceScaleFactor: scaleFactor,
-        });
-
-        if (basePath) {
-            // Set base URL for relative resource resolution
-            const baseUrl = `file://${path.resolve(basePath)}/`;
-            await page.goto(baseUrl, { waitUntil: "domcontentloaded" });
-            await page.setContent(html, { waitUntil: "networkidle0" });
-        } else {
-            await page.setContent(html, { waitUntil: "networkidle0" });
-        }
-
-        // Process <img qr="..."> elements
-        await processQrElements(page);
-
-        // Auto-detect content width if needed
-        let finalCssWidth = initialWidth;
-        if (autoWidth) {
-            finalCssWidth = await page.evaluate(() => {
-                // Try first child of body (likely the main container)
-                const firstChild = document.body.firstElementChild as HTMLElement;
-                if (firstChild) {
-                    const rect = firstChild.getBoundingClientRect();
-                    if (rect.width > 0 && rect.width < 3000) {
-                        return Math.ceil(rect.width);
-                    }
-                }
-                // Fall back to scroll width (actual content width)
-                return document.body.scrollWidth;
-            });
-            await page.setViewport({
-                width: finalCssWidth,
-                height: cssHeight,
-                deviceScaleFactor: scaleFactor,
-            });
-        }
-
-        const pngBuffer = await page.screenshot({ type: "png" });
-
-        // Scale to target dimensions
-        // If tapeMm was used, scale from CSS dimensions to target 300 DPI dimensions
-        const scale = targetHeight / cssHeight;
-        const finalWidth = Math.round(finalCssWidth * scale);
-
-        if (scaleFactor > 1 || options.tapeMm) {
-            return scaleDown(Buffer.from(pngBuffer), finalWidth, targetHeight);
-        }
-        return Buffer.from(pngBuffer);
-    } finally {
-        await page.close();
-    }
-}
-
-/**
- * Render HTML from URL to PNG buffer
- * Processes <img qr="..."> tags to inline base64 QR codes via DOM
- * If width is not specified, auto-detects from content
- */
-export async function renderHtmlUrl(url: string, options: RenderOptions): Promise<Buffer> {
-    const browser = await getBrowser();
-    const page = await browser.newPage();
-    const scaleFactor = options.deviceScaleFactor ?? DEFAULT_SCALE;
-    const autoWidth = !options.width || options.width === 0;
-
-    // If tapeMm provided, use CSS-equivalent viewport height; otherwise use target height directly
-    const cssHeight = options.tapeMm
-        ? Math.round(options.tapeMm * CSS_DPI / MM_PER_INCH)
-        : options.height;
-    const targetHeight = options.height;
-
-    try {
-        // Use large initial width for auto-detection, or specified width
-        const initialWidth = autoWidth ? 4000 : options.width!;
-        await page.setViewport({
-            width: initialWidth,
-            height: cssHeight,
-            deviceScaleFactor: scaleFactor,
-        });
-
-        await page.goto(url, { waitUntil: "networkidle0" });
-
-        // Process <img qr="..."> elements
-        await processQrElements(page);
-
-        // Auto-detect content width if needed
-        let finalCssWidth = initialWidth;
-        if (autoWidth) {
-            finalCssWidth = await page.evaluate(() => {
-                // Try first child of body (likely the main container)
-                const firstChild = document.body.firstElementChild as HTMLElement;
-                if (firstChild) {
-                    const rect = firstChild.getBoundingClientRect();
-                    if (rect.width > 0 && rect.width < 3000) {
-                        return Math.ceil(rect.width);
-                    }
-                }
-                // Fall back to scroll width (actual content width)
-                return document.body.scrollWidth;
-            });
-            // Resize viewport to actual content width
-            await page.setViewport({
-                width: finalCssWidth,
-                height: cssHeight,
-                deviceScaleFactor: scaleFactor,
-            });
-        }
-
-        const pngBuffer = await page.screenshot({ type: "png" });
-
-        // Scale to target dimensions
-        // If tapeMm was used, scale from CSS dimensions to target 300 DPI dimensions
-        const scale = targetHeight / cssHeight;
-        const finalWidth = Math.round(finalCssWidth * scale);
-
-        if (scaleFactor > 1 || options.tapeMm) {
-            return scaleDown(Buffer.from(pngBuffer), finalWidth, targetHeight);
-        }
-        return Buffer.from(pngBuffer);
-    } finally {
-        await page.close();
-    }
-}
-
-/**
- * Render HTML file and save to PNG file
- */
-export async function renderHtmlToFile(
-    htmlPath: string,
-    outputPath: string,
-    options: RenderOptions
-): Promise<void> {
-    const buffer = await renderHtmlFile(htmlPath, options);
-    fs.writeFileSync(outputPath, buffer);
-}
-
-// Legacy export for compatibility
-export const renderHtml = renderHtmlFile;
+/**
+ * Backward-compat shim. The HTML rendering logic now lives in
+ * @bobfrankston/label-core. This file just re-exports those entry points so
+ * existing deep imports keep working.
+ */
+
+export {
+    renderHtmlString,
+    renderHtmlFile,
+    renderHtmlUrl,
+    closeBrowser,
+    type RenderOptions,
+} from "@bobfrankston/label-core";
+
+import { renderHtmlFile as _renderHtmlFile } from "@bobfrankston/label-core";
+
+/** @deprecated Use renderHtmlFile from @bobfrankston/label-core. */
+export const renderHtml = _renderHtmlFile;
+
+/** @deprecated Render to a file by calling renderHtmlFile then fs.writeFileSync. */
+export async function renderHtmlToFile(
+    htmlPath: string,
+    outputPath: string,
+    options: { width?: number; height: number; tapeMm?: number; deviceScaleFactor?: number }
+): Promise<void> {
+    const fs = await import("fs");
+    const buffer = await _renderHtmlFile(htmlPath, options);
+    fs.writeFileSync(outputPath, buffer);
+}