tuffgal 0.1.0-alpha.13 → 0.1.0-alpha.14

package/CHANGELOG.md

@@ -8,6 +8,12 @@ this project uses [Pride Versioning](https://pridever.org) → `PROUD.DEFAULT.SH
 
 _Nothing just yet_
 
+## [0.1.0-alpha.14] — 2026-07-04
+
+### Fixed
+
+A `viewport` capture no longer resets the page's scroll offset before shooting.
+
 ## [0.1.0-alpha.13] — 2026-06-30
 
 ### Changed
@@ -187,7 +193,8 @@ styling or interactivity.
 Initial public alpha. Tuffgal extracted from [Linklater](https://github.com/nschneble/linklater)'s
 in-tree visual testing workspace.
 
-[Unreleased]: https://github.com/nschneble/tuffgal/compare/v0.1.0-alpha.13...HEAD
+[Unreleased]: https://github.com/nschneble/tuffgal/compare/v0.1.0-alpha.14...HEAD
+[0.1.0-alpha.14]: https://github.com/nschneble/tuffgal/releases/tag/v0.1.0-alpha.14
 [0.1.0-alpha.13]: https://github.com/nschneble/tuffgal/releases/tag/v0.1.0-alpha.13
 [0.1.0-alpha.12]: https://github.com/nschneble/tuffgal/releases/tag/v0.1.0-alpha.12
 [0.1.0-alpha.11]: https://github.com/nschneble/tuffgal/releases/tag/v0.1.0-alpha.11

package/dist/screenshots/capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/screenshots/capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,KAAK,GAAE,OAAO,EAAO,EACrB,IAAI,GAAE,WAAwB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAsBjB"}
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/screenshots/capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,KAAK,GAAE,OAAO,EAAO,EACrB,IAAI,GAAE,WAAwB,GAC7B,OAAO,CAAC,MAAM,CAAC,CA8BjB"}

package/dist/screenshots/capture.js

@@ -9,19 +9,27 @@
  * composites the entire scrollable document however tall.
  */
 export async function capturePage(page, masks = [], mode = 'viewport') {
-    // Both capture modes shoot at the page's current scroll offset.
-    // `position: sticky` / `fixed` elements resolve their offset against that
-    // scroll position, so a page captured mid-scroll renders its sticky chrome
-    // (sidebars, headers) shifted down by `scrollY` — the same UI produces a
-    // different image purely because an earlier step left the viewport scrolled.
-    // (`fullPage` composites the whole document but inherits the same offset.)
-    // Resetting to the origin first
-    // pins those elements to their static-baseline position so the capture is
-    // deterministic. `instant` defeats any `scroll-behavior: smooth` the page
-    // sets, which would otherwise animate and reintroduce a timing race.
-    // String form so the snippet runs in the page (DOM) context without
-    // pulling the DOM lib into this Node-side module's type environment.
-    await page.evaluate(`window.scrollTo({ top: 0, left: 0, behavior: 'instant' })`);
+    // `fullPage` composites the whole scrollable document into one image. When
+    // the document is captured at a non-zero offset, `position: sticky` / `fixed`
+    // chrome (sidebars, headers) resolves against that scroll position and lands
+    // shifted down by `scrollY` in the stitch — the same UI produces a different
+    // image purely because an earlier step left the viewport scrolled. Resetting
+    // to the origin first pins those elements to their static-baseline position
+    // so the capture is deterministic. `instant` defeats any `scroll-behavior:
+    // smooth` the page sets, which would otherwise animate and reintroduce a
+    // timing race.
+    //
+    // A `viewport` shot captures exactly the box the flow scrolled to, so it must
+    // NOT reset — a story that scrolls to a below-the-fold section (a Settings
+    // panel, a success banner) would otherwise capture the top of the page
+    // instead of the region it navigated to. The flow lands at a deterministic
+    // offset, so the viewport shot is deterministic without any reset.
+    //
+    // String form so the snippet runs in the page (DOM) context without pulling
+    // the DOM lib into this Node-side module's type environment.
+    if (mode === 'fullPage') {
+        await page.evaluate(`window.scrollTo({ top: 0, left: 0, behavior: 'instant' })`);
+    }
     return page.screenshot({
         fullPage: mode === 'fullPage',
         animations: 'disabled',

package/dist/screenshots/capture.js.map

@@ -1 +1 @@
-{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/screenshots/capture.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAU,EACV,QAAmB,EAAE,EACrB,OAAoB,UAAU;IAE9B,gEAAgE;IAChE,0EAA0E;IAC1E,2EAA2E;IAC3E,yEAAyE;IACzE,6EAA6E;IAC7E,2EAA2E;IAC3E,gCAAgC;IAChC,0EAA0E;IAC1E,0EAA0E;IAC1E,qEAAqE;IACrE,oEAAoE;IACpE,qEAAqE;IACrE,MAAM,IAAI,CAAC,QAAQ,CACjB,2DAA2D,CAC5D,CAAC;IACF,OAAO,IAAI,CAAC,UAAU,CAAC;QACrB,QAAQ,EAAE,IAAI,KAAK,UAAU;QAC7B,UAAU,EAAE,UAAU;QACtB,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/screenshots/capture.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAU,EACV,QAAmB,EAAE,EACrB,OAAoB,UAAU;IAE9B,2EAA2E;IAC3E,8EAA8E;IAC9E,6EAA6E;IAC7E,6EAA6E;IAC7E,6EAA6E;IAC7E,4EAA4E;IAC5E,2EAA2E;IAC3E,yEAAyE;IACzE,eAAe;IACf,EAAE;IACF,8EAA8E;IAC9E,2EAA2E;IAC3E,uEAAuE;IACvE,2EAA2E;IAC3E,mEAAmE;IACnE,EAAE;IACF,4EAA4E;IAC5E,6DAA6D;IAC7D,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,MAAM,IAAI,CAAC,QAAQ,CACjB,2DAA2D,CAC5D,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC,UAAU,CAAC;QACrB,QAAQ,EAAE,IAAI,KAAK,UAAU;QAC7B,UAAU,EAAE,UAAU;QACtB,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tuffgal",
-  "version": "0.1.0-alpha.13",
+  "version": "0.1.0-alpha.14",
   "description": "JSON-driven visual regression for web apps.",
   "license": "MIT",
   "author": "Nick Schneble",