@seliseblocks/mailcraft 0.2.14 → 0.2.16

package/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to `@seliseblocks/mailcraft` are documented here.
 
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.16] — 2026-09-05
+
+### Fixed
+- **The screenshot viewer opens and slides smoothly.** Three sources of jank, all on the main thread at once: the capture's heavy bursts (render, layout, serialize, rasterize, encode) started inside the entrance animation and stuttered it — the skeleton now goes up immediately and the capture waits for the chrome to finish arriving; the skeleton's shimmer animated `background-position`, a full-card repaint per frame exactly while that work ran — it sweeps on a composited `transform` now; and the tall capture image wasn't pinned to its own compositor layer, so a slide could re-rasterize megapixels mid-transition — `will-change: transform` keeps it promoted, and the image is fully decoded off-screen before it fades in.
+- **Faster reopen on photo-heavy templates.** Every capture re-fetched and re-inlined each external image; the inlined bytes are now cached per URL for the session (a failed fetch is evicted, so a transient network error is not pinned).
+- **The viewer no longer reads as a modal stacked on the export dialog.** Opened from the dialog's Screenshot button, the dialog is parked while the viewer is up and restored when it closes; the backdrop also dims deeper (0.86 → 0.94), so bright chrome underneath stops bleeding through the viewer's own header.
+
+## [0.2.15] — 2026-09-05
+
+### Added
+- **Compressed screenshots.** `screenshotPng(options)` takes `{ format: 'png' | 'jpeg' | 'webp', quality: 0–1, scale }`, so a long template can be captured as a JPG or WebP at a fraction of the PNG's size (PNG stays the lossless default). The capture itself is still one lossless render; a lossy pick re-encodes it at download time against the template's page colour, and never captures twice. `downloadScreenshot(blob?, options?)` passes the options through and names the file by the format that was actually encoded (a browser without a WebP encoder falls back to PNG, per spec). Copy still hands the clipboard a PNG — it accepts nothing else.
+- **The screenshot viewer's actions are one floating control bar now.** Play/pause and Copy sit as quiet segments beside a segmented **PNG | JPG | WEBP** picker (all three visible, the active one lit) and a solid Download button that renames itself with the chosen format. The capture's dimensions and screen position moved up under the Screenshot kicker, where a full header line keeps them from truncating; on narrow cards Copy folds to its icon so Download keeps its label.
+- **The demo templates have product and hero imagery now.** Six of the example templates (back in stock, cart left behind, rate your headphones, meet Nova, The Sunday Brief, your order shipped) were shipping with no images at all — colour tiles stood in where a product shot or hero belongs. Each now carries flat SVG illustrations as self-contained `data:` URIs, so the gallery keeps working from `file://`, offline, and inside the screenshot capture's no-network rule. All six still converge as save round-trip fixed points.
+
+### Changed
+- The `action.downloadPng` message key is retired in favour of `story.download` (`'Download {fmt}'`) and the new `story.format` hint, in all 31 locales. A host override table using the old key should move to the new ones.
+
 ## [0.2.14] — 2026-09-03
 
 ### Fixed

package/DOCS.md

@@ -542,9 +542,9 @@ template, not to your app.
 | `importHtml(html)` | number of rows produced |
 | `loadTemplate({ name, html })` | — |
 | `undo()` / `redo()` | — |
-| `screenshotPng()` | full template as a PNG `Blob` |
-| `previewScreenshot()` | opens the story-style viewer |
-| `downloadScreenshot(blob?)` / `copyScreenshot(blob?)` | save / clipboard — captures first if no blob is passed |
+| `screenshotPng(options?)` | full template as an image `Blob`. PNG by default (lossless); `{ format: 'jpeg' \| 'webp', quality: 0–1 }` compresses it to a fraction of the size, and `scale` (default 2) trades resolution for bytes. Read the returned `blob.type` — a browser without a WebP encoder hands back PNG |
+| `previewScreenshot()` | opens the story-style viewer, with its own PNG / JPG / WebP download toggle |
+| `downloadScreenshot(blob?, options?)` / `copyScreenshot(blob?)` | save / clipboard — captures first (with `options`) if no blob is passed; the filename extension follows the blob's actual type |
 
 ### Events
 
@@ -580,7 +580,6 @@ The complete catalog of UI strings that `.messages` accepts — every key the ed
 | `action.codeHint` | Edit the raw HTML with a live preview |
 | `action.deleteHint` | Delete — ⌫ |
 | `action.download` | Download |
-| `action.downloadPng` | Download PNG |
 | `action.duplicateHint` | Duplicate — ⌘D |
 | `action.export` | Export |
 | `action.exportHint` | Export your email |
@@ -707,8 +706,10 @@ The complete catalog of UI strings that `.messages` accepts — every key the ed
 | `storage.loading` | Loading files… |
 | `storage.uploading` | Uploading {count}… |
 | `story.copy` | Copy |
+| `story.download` | Download {fmt} |
 | `story.failed` | Screenshot failed |
 | `story.failedHint` | An image in the template could not be loaded for capture. |
+| `story.format` | Image format — PNG is lossless, JPG and WebP are smaller files |
 | `story.kicker` | Screenshot |
 | `story.meta` | {w}×{h} · screen {i} of {n} |
 | `story.pause` | Pause |

package/README.md

@@ -101,7 +101,8 @@ ATTRS     variables="a,b,c" | locale="de" | theme="dark" | dir="rtl"
 PROPS     .variables .toolbar .footer .uiFont .accent .messages .aiProvider .iconProvider
           .storageProvider .storageLimits
 METHODS   exportHtml() importHtml(html) loadTemplate(tpl) undo() redo()
-          screenshotPng() previewScreenshot() downloadScreenshot() copyScreenshot()
+          screenshotPng({format:'png'|'jpeg'|'webp', quality, scale}?)
+          previewScreenshot() downloadScreenshot() copyScreenshot()
 
 KEYS      Bound on window, so they survive toolbar="none":
           Esc (leave field / deselect + close), Ctrl/Cmd+Z, Shift+Ctrl/Cmd+Z,

package/README.md.txt

@@ -101,7 +101,8 @@ ATTRS     variables="a,b,c" | locale="de" | theme="dark" | dir="rtl"
 PROPS     .variables .toolbar .footer .uiFont .accent .messages .aiProvider .iconProvider
           .storageProvider .storageLimits
 METHODS   exportHtml() importHtml(html) loadTemplate(tpl) undo() redo()
-          screenshotPng() previewScreenshot() downloadScreenshot() copyScreenshot()
+          screenshotPng({format:'png'|'jpeg'|'webp', quality, scale}?)
+          previewScreenshot() downloadScreenshot() copyScreenshot()
 
 KEYS      Bound on window, so they survive toolbar="none":
           Esc (leave field / deselect + close), Ctrl/Cmd+Z, Shift+Ctrl/Cmd+Z,