fix: improve local capture fidelity

Author: Bloomingg

CHANGELOG.md

@@ -4,6 +4,25 @@ All user-visible changes to Web2UI — Copy for Figma are recorded here.
 
 ## Unreleased
 
+## 0.1.3 — 2026-08-02
+
+- Recovered failed image and CSS-background assets with bounded, single-frame screenshots while
+  preserving editable child layers; fallback slots now prioritize image nodes and larger regions.
+- Normalized WebP, AVIF, safely styled SVG, modern-color SVG, and tinted raster assets to
+  Figma-compatible PNG data before clipboard export, without increasing the public asset budget.
+- Reserved the local asset budget for page imagery before optional generated glyphs and fixed
+  transformed linear, radial, and angular gradients in the clipboard SVG.
+- Added real Manifest V3 regression coverage that verifies page images and fallback screenshots
+  remain embedded exactly once and never become external clipboard references.
+- Preserved browser-measured legacy and image clipping, nested clip-path ownership, and
+  positioned-auto paint order instead of flattening a larger page shell.
+- Added bounded screenshot recovery for browser-resolved generated content such as CSS counters,
+  including pseudo-element paint outside the host box. Thin unsupported masked decorations may be
+  omitted with a scoped warning so their editable host content remains intact.
+- Locked the measured capture viewport and preserved authored horizontal scroll positions while
+  capturing nested fallback regions, preventing fallback pixels from being shifted by reflow or
+  contaminated by neighboring content.
+
 ## 0.1.2 — 2026-07-24
 
 - Moved the public source, issue, security, and release links to `Lynavo/web2ui` after the

README.md

@@ -86,7 +86,9 @@ feature or reproduce the full semantic model of a native Figma document.
 - **Full Page capture** with bounded scrolling and page-settling behavior.
 - **Viewport presets** for Browser, 1920, 1440, 1024, 768, and 390 pixels.
 - **Theme selection** using the browser preference or forced light/dark emulation.
-- **Local asset recovery** for page-declared images, SVG, fonts, and CSS backgrounds.
+- **Local asset recovery** for page-declared images, SVG, fonts, and CSS backgrounds, including
+  Figma-compatible PNG normalization for browser-decodable formats that are unsafe to paste
+  directly.
 - **Bounded single-frame raster fallbacks** for content that cannot be represented safely as
   editable vectors.
 - **Editable text where possible**, carrying measured geometry, paints, effects, clipping, and
@@ -275,8 +277,11 @@ Canvas, video, WebGL, unsupported SVG, very large assets, browser-only effects,
 and rapidly changing pages use the `local-static-v1` profile. It takes at most one current-frame
 sample for each attempted fallback region, attempts no more than 12 regions, does not converge
 animation timelines or recover transparent layers from multiple screenshots, and may rasterize,
-approximate, omit, or report the region as a warning. The clipboard output does not preserve native
-components, variables, prototypes, or Auto Layout semantics.
+approximate, omit, or report the region as a warning. Within that fixed limit, image nodes are
+attempted before CSS-background hosts and larger regions are attempted first. Browser-resolved
+generated content such as CSS counters may become a local screenshot, while unsupported 1–2px
+masked decorations may be omitted to keep the host's text and structure editable. The clipboard
+output does not preserve native components, variables, prototypes, or Auto Layout semantics.
 
 ## Troubleshooting
 

docs/ARCHITECTURE.md

@@ -46,17 +46,27 @@ operations, performs conversion, and stores the current result.
 computed paints, text measurements, stacking information, fonts, and asset requests. It is the
 correct place to measure facts that only a browser can know. Later modules should consume those
 facts rather than infer them from class names, URL suffixes, text shape, or layer names.
+This includes legacy rectangular clips, image clip bounds, positioned-auto paint bands, and the
+nearest owner of a dense unsupported clip-path cluster.
 
 Consent-overlay handling, full-page scrolling, asset recovery, and single-frame raster fallbacks
 are coordinated by the extension adapters. Cleanup runs in `finally` paths so capture markers,
 hidden overlays, emulation, debugger attachment, and scroll position are restored on success or
 failure.
+The debugger locks both Browser and preset captures to the viewport measured at capture start;
+this prevents clipped screenshots from changing Chromium's layout width between fallback regions.
 
 The public dynamic-content behavior is `local-static-v1`. It takes at most one current-frame sample
 for each attempted fallback region, attempts no more than 12 regions, and does not finish animation
 timelines, perform multi-frame quality retries, recover transparent layers from a second screenshot,
-or use a hosted rendering environment. Failed or deferred regions become explicit labeled
-placeholders and retain the extractor's node-scoped warning.
+or use a hosted rendering environment. The fixed queue prioritizes image nodes, then CSS-background
+hosts, and uses captured area as the tie-breaker. Failed or deferred image regions become explicit
+labeled placeholders; unresolved background paints remain warning-scoped when their isolated
+single-frame recovery is unavailable. Browser-resolved generated content that cannot be expressed
+as literal text uses one host screenshot whose bounds include measurable pseudo-element paint.
+Unsupported masked pseudo-elements no thicker than 2px are omitted only when they have no filter,
+shadow, or outline that would extend their paint; the omission is warning-scoped and the host tree
+remains editable.
 
 ### Contract module
 
@@ -117,8 +127,20 @@ The content runtime discovers assets declared by the page. The service worker ad
 only HTTP(S) URLs, omits credentials and referrer data, follows bounded time and byte limits, and
 returns bytes to the active capture. Inline SVG is checked before it enters a portable plan.
 These reads may contact the page's own origin or CDN; they never target a Web2UI service.
-If a declared asset is unavailable, conversion keeps the rest of the page usable: image nodes
-receive a neutral placeholder, missing paints are omitted, and the node-scoped warning is retained.
+PNG, JPEG, and GIF can remain direct clipboard assets. WebP, AVIF, tinted rasters, narrowly safe
+styled SVGs, and SVG colors that Figma may not preserve are browser-decoded to PNG under the same
+4 MiB per-asset and approximately 18 MiB total budgets. Required page imagery is admitted before
+optional generated glyphs.
+
+If a declared image is unavailable, it is marked for the bounded screenshot flow instead of being
+silently omitted. An unresolved CSS background is captured in isolation and replaces only the
+host's background fill, leaving its child text and elements editable. Fallbacks are scrolled into
+view and captured with a live page-coordinate clip while Chromium's beyond-viewport screenshot mode
+remains disabled; this avoids that path temporarily reflowing the page. The live box is used when
+its measured dimensions remain stable, while the captured rectangle preserves expanded
+pseudo-element paint. `scrollIntoView` may move nested scrollers, so their authored horizontal
+positions are restored before pixel capture and all ancestor scroll positions are restored during
+cleanup. If recovery still fails, the node-scoped warning is retained.
 
 ### Local persistence
 

docs/TESTING.md

@@ -73,7 +73,12 @@ out/e2e/playwright/local-copy/
 
 The test verifies both capture modes, popup behavior, viewport/theme choices, clipboard
 preparation, result survival across a service-worker restart, and absence of capture data sent to
-a Web2UI host. The browser profile and screenshots are disposable and must not be committed.
+a Web2UI host. It also checks the raw clipboard SVG for exactly-once inline page assets, a recovered
+CSS-background screenshot, the preservation of a nested horizontal scroller during a canvas
+fallback, fixed pixel canaries for the canvas frame and isolated background, and the absence of
+external image references. Clipboard previews render in an independent clean browser so transient
+debugger viewport emulation cannot corrupt the evidence. The browser profile and screenshots are
+disposable and must not be committed.
 
 ## Writing reliable tests
 

manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Web2UI — Copy for Figma",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "minimum_chrome_version": "106",
   "description": "Capture the visible area or full page locally, then copy it for Figma.",
   "action": {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "web2ui-extension",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "private": true,
   "description": "Local-only Chrome extension that captures web pages and copies them for Figma.",
   "license": "AGPL-3.0-only",
@@ -53,5 +53,11 @@
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.62.1",
     "vitest": "^3.2.6"
+  },
+  "pnpm": {
+    "overrides": {
+      "brace-expansion@<2.0.0": "1.1.18",
+      "brace-expansion@>=4.0.0 <5.1.0": "5.0.9"
+    }
   }
 }