@ammduncan/easel 0.2.14 → 0.2.16

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to easel. This project adheres to [Semantic Versioning](https://semver.org/).
 
+## 0.2.16 — 2026-05-23
+
+### Changed
+- **PDF export quality bumped back up after the 0.2.15 size fix landed.** 0.2.15 traded crispness for size (JPEG 0.92 + DPR 2 → ~800 KB per card) — visible JPEG artefacts on type at zoom. Bumped to JPEG quality 1.0 + DPR 4 for the PDF target. Same compression trick (JPEG-in-PDF vs PNG-in-PDF) keeps the file at ~3–8 MB per card instead of the original 300+ MB; the higher quality settings just bring text back to "razor sharp at any zoom" without giving up the size win.
+- PNG export unchanged (still lossless PNG @ DPR 4).
+
+## 0.2.15 — 2026-05-23
+
+### Fixed
+- **PDF exports were enormous (300+ MB for a single-page card).** Two stacking causes: (1) the iframe always rasterised at `pixelRatio: 4` regardless of target, producing huge bitmaps for tall cards; (2) the parent then embedded the result into jsPDF as a `PNG`, which PDFs store using Flate compression — far less efficient than the DCT compression PDFs natively use for JPEGs. A tall card at DPR 4 → ~6000×10000 pixel PNG → ~300 MB PDF wrapper.
+- Fix: for PDF targets only, the iframe now rasterises as JPEG at `quality: 0.92` and `pixelRatio: 2`, and the parent embeds with `'JPEG'` format + `'FAST'` compression flag + `compress: true` at the document level. PNG exports stay at lossless PNG + pixelRatio 4 — no quality loss for the standalone PNG download.
+- Expected sizes for a typical card: ~3–8 MB (down from ~300 MB), text still crisp on screen and in print.
+
 ## 0.2.14 — 2026-05-23
 
 ### Changed

package/dist/client/viewer.js

@@ -196,8 +196,12 @@
   }
 
   /**
-   * Embed a PNG dataURL into a single-page PDF sized to the image's pixel
-   * dimensions, producing a continuous (no page-breaks) document, then save.
+   * Embed a rasterised dataURL into a single-page PDF sized to the image's
+   * pixel dimensions, producing a continuous (no page-breaks) document, then
+   * save. The iframe sends a JPEG dataURL for PDF targets — PDFs natively use
+   * DCT compression for JPEGs, so embedding stays compact (vs PNGs which
+   * balloon the file). We detect format from the dataURL prefix; PNG still
+   * works as a fallback for any legacy caller that sends one.
    */
   function downloadAsPdf(dataUrl, filename) {
     return new Promise((resolve, reject) => {
@@ -206,6 +210,8 @@
         reject(new Error("jsPDF not loaded"));
         return;
       }
+      const isJpeg = dataUrl.startsWith("data:image/jpeg") || dataUrl.startsWith("data:image/jpg");
+      const imageType = isJpeg ? "JPEG" : "PNG";
       const img = new Image();
       img.onload = () => {
         try {
@@ -216,8 +222,9 @@
             format: [w, h],
             orientation: w > h ? "landscape" : "portrait",
             hotfixes: ["px_scaling"],
+            compress: true,
           });
-          pdf.addImage(dataUrl, "PNG", 0, 0, w, h);
+          pdf.addImage(dataUrl, imageType, 0, 0, w, h, undefined, "FAST");
           pdf.save(filename);
           resolve();
         } catch (err) {
@@ -859,13 +866,23 @@ ${body}
           document.documentElement.scrollHeight,
           document.body ? document.body.scrollHeight : 0,
         );
-        window.htmlToImage.toPng(document.documentElement, {
+        // PNG target → lossless PNG @ pixelRatio 4 for crisp standalone files.
+        // PDF target → JPEG @ quality 1.0 + pixelRatio 4. PDFs natively use
+        // DCT compression for embedded JPEGs, so even at max quality the PDF
+        // stays in the ~3-8 MB range for a typical card (vs ~300 MB if we
+        // embedded as PNG — see 0.2.15). 1.0 + DPR 4 keeps text razor-sharp
+        // at any zoom level; tuned down to 0.92 + DPR 2 in 0.2.15 dropped to
+        // ~800 KB but at the cost of visible JPEG artefacts on type.
+        var rasterFn = format === "pdf" ? window.htmlToImage.toJpeg : window.htmlToImage.toPng;
+        var rasterOpts = {
           backgroundColor: bgColor,
           pixelRatio: 4,
           cacheBust: true,
           width: width,
           height: height,
-        }).then(function(dataUrl){
+        };
+        if (format === "pdf") rasterOpts.quality = 1.0;
+        rasterFn(document.documentElement, rasterOpts).then(function(dataUrl){
           parent.postMessage({ type: "easel:image-ready", pushId: pushId, dataUrl: dataUrl, filename: filename, format: format }, "*");
         }).catch(function(err){
           console.error("[easel] export failed", err);
@@ -889,7 +906,7 @@ ${body}
     const configScript =
       "<script src='https://cdn.jsdelivr.net/npm/html-to-image@1.11.13/dist/html-to-image.js'></script><script>(function(){function a(c){if(!c)return;if(c.theme==='light'||c.theme==='dark'){document.documentElement.setAttribute('data-theme',c.theme);window.__claudeDisplayTheme=c.theme}if(c.preset==='paper'||c.preset==='aurora'||c.preset==='slate'){document.documentElement.setAttribute('data-preset',c.preset);window.__claudeDisplayPreset=c.preset}if(c.density==='carded'||c.density==='flat'){document.documentElement.setAttribute('data-density',c.density);window.__claudeDisplayDensity=c.density}}a(" +
       JSON.stringify({ theme, preset, density }) +
-      ");window.addEventListener('message',function(e){if(!e||!e.data)return;if(e.data.type==='easel:config')a(e.data);if(e.data.type==='easel:theme')a({theme:e.data.theme});if(e.data.type==='easel:print'){try{window.print()}catch(_){}}if(e.data.type==='easel:image'){var pid=e.data.pushId;var fn=e.data.filename||'push.png';var fmt=e.data.format==='pdf'?'pdf':'png';var bg=e.data.bgColor||'#ffffff';if(!window.htmlToImage)return;window.htmlToImage.toPng(document.body,{backgroundColor:bg,pixelRatio:4,cacheBust:true}).then(function(u){parent.postMessage({type:'easel:image-ready',pushId:pid,dataUrl:u,filename:fn,format:fmt},'*')}).catch(function(err){console.error(err);parent.postMessage({type:'easel:image-error',pushId:pid,format:fmt,message:(err&&err.message)?err.message:String(err)},'*')})}})})();</script>";
+      ");window.addEventListener('message',function(e){if(!e||!e.data)return;if(e.data.type==='easel:config')a(e.data);if(e.data.type==='easel:theme')a({theme:e.data.theme});if(e.data.type==='easel:print'){try{window.print()}catch(_){}}if(e.data.type==='easel:image'){var pid=e.data.pushId;var fn=e.data.filename||'push.png';var fmt=e.data.format==='pdf'?'pdf':'png';var bg=e.data.bgColor||'#ffffff';if(!window.htmlToImage)return;var rfn=fmt==='pdf'?window.htmlToImage.toJpeg:window.htmlToImage.toPng;var ropts={backgroundColor:bg,pixelRatio:4,cacheBust:true};if(fmt==='pdf')ropts.quality=1.0;rfn(document.body,ropts).then(function(u){parent.postMessage({type:'easel:image-ready',pushId:pid,dataUrl:u,filename:fn,format:fmt},'*')}).catch(function(err){console.error(err);parent.postMessage({type:'easel:image-error',pushId:pid,format:fmt,message:(err&&err.message)?err.message:String(err)},'*')})}})})();</script>";
     const measureScript = "<script>" + selfMeasureScript(pushId) + "</script>";
     const combined = configScript + measureScript;
     if (/<\/body>/i.test(html)) return html.replace(/<\/body>/i, combined + "</body>");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ammduncan/easel",
-  "version": "0.2.14",
+  "version": "0.2.16",
   "description": "A live browser tab for every Claude Code (and MCP) session. The push MCP tool appends HTML cards to a scrolling feed you keep open in split-screen.",
   "type": "module",
   "license": "MIT",