@bobfrankston/brother-label 1.0.1

package/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["render.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,SAAsB,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,MAAM,MAAM,QAAQ,CAAC;AAS5B,IAAI,eAAe,GAAmB,IAAI,CAAC;AAE3C,MAAM,aAAa,GAAG,CAAC,CAAC,CAAE,4CAA4C;AAEtE;;;GAGG;AACH,KAAK,UAAU,kBAAkB,CAAC,QAAkB;IAChD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;gBACzC,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE,CAAC;gBACT,oBAAoB,EAAE,GAAG;gBACzB,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;aAC/C,CAAC,CAAC;YACH,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAAC,IAAoB;IACjD,4CAA4C;IAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;QACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAClD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAElC,oBAAoB;IACpB,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAEjD,oDAAoD;IACpD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtD,4CAA4C;IAC5C,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,IAA4B,EAAE,EAAE;QACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YACf,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzB,GAAG,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;gBACtC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC,EAAE,MAAM,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,SAAS,CAAC,MAAc,EAAE,WAAmB,EAAE,YAAoB;IAC9E,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;IAClD,OAAO,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,UAAU;IACrB,IAAI,CAAC,eAAe,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC;QACjD,eAAe,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,eAAe,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAC9B,IAAI,eAAe,EAAE,CAAC;QAClB,MAAM,eAAe,CAAC,KAAK,EAAE,CAAC;QAC9B,eAAe,GAAG,IAAI,CAAC;IAC3B,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,OAAsB;IACzE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,wBAAwB,YAAY,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,aAAa,CAAC,UAAU,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,OAAsB,EAAE,QAAiB;IAC1F,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IAErC,IAAI,CAAC;QACD,MAAM,IAAI,CAAC,WAAW,CAAC;YACnB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,CAAC;SACpD,CAAC,CAAC;QAEH,IAAI,QAAQ,EAAE,CAAC;YACX,gDAAgD;YAChD,MAAM,OAAO,GAAG,UAAU,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;YACpD,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC5D,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,kCAAkC;QAClC,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,IAAI,aAAa,CAAC;QAC/D,IAAI,WAAW,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACxC,OAAO,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;YAAS,CAAC;QACP,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,OAAsB;IACnE,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IAErC,IAAI,CAAC;QACD,MAAM,IAAI,CAAC,WAAW,CAAC;YACnB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,CAAC;SACpD,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;QAEpD,kCAAkC;QAClC,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,IAAI,aAAa,CAAC;QAC/D,IAAI,WAAW,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACxC,OAAO,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;YAAS,CAAC;QACP,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,QAAgB,EAChB,UAAkB,EAClB,OAAsB;IAEtB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvD,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,kCAAkC;AAClC,MAAM,CAAC,MAAM,UAAU,GAAG,cAAc,CAAC"}

package/render.ts

@@ -0,0 +1,201 @@
+/**
+ * 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;
+    height: number;
+    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
+
+/**
+ * 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
+ * @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();
+
+    try {
+        await page.setViewport({
+            width: options.width,
+            height: options.height,
+            deviceScaleFactor: options.deviceScaleFactor ?? 3,
+        });
+
+        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);
+
+        const pngBuffer = await page.screenshot({ type: "png" });
+        const scaleFactor = options.deviceScaleFactor ?? DEFAULT_SCALE;
+        if (scaleFactor > 1 && !options.keepScale) {
+            return scaleDown(Buffer.from(pngBuffer), options.width, options.height);
+        }
+        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
+ */
+export async function renderHtmlUrl(url: string, options: RenderOptions): Promise<Buffer> {
+    const browser = await getBrowser();
+    const page = await browser.newPage();
+
+    try {
+        await page.setViewport({
+            width: options.width,
+            height: options.height,
+            deviceScaleFactor: options.deviceScaleFactor ?? 3,
+        });
+
+        await page.goto(url, { waitUntil: "networkidle0" });
+
+        // Process <img qr="..."> elements
+        await processQrElements(page);
+
+        const pngBuffer = await page.screenshot({ type: "png" });
+        const scaleFactor = options.deviceScaleFactor ?? DEFAULT_SCALE;
+        if (scaleFactor > 1 && !options.keepScale) {
+            return scaleDown(Buffer.from(pngBuffer), options.width, options.height);
+        }
+        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;

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": ".",
+    "rootDir": ".",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["*.ts"],
+  "exclude": ["node_modules"]
+}