@qoretechnologies/qlip 0.1.3-pr.30.gc00bad8 → 0.1.3-pr.30.gffaaa15

package/README.md

@@ -194,6 +194,7 @@ export const LoggedIn = {
     qlip: {
       skip: false,
       viewport: { width: 1280, height: 720 },
+      fullSizeCaptures: false,
       disableAnimations: true,
       pauseAnimationsAtEnd: false,
       fullPage: false,
@@ -219,6 +220,7 @@ Options precedence:
 qlipVitestPlugin({
   outputDir: './qlip/screenshots',
   viewport: { width: 1280, height: 720 },
+  fullSizeCaptures: false,
   disableAnimations: false,
   pauseAnimationsAtEnd: false,
   fullPage: false,
@@ -231,7 +233,11 @@ qlipVitestPlugin({
 });
 ```
 
-`fullPage` grows the viewport to the page's full content height for the capture and puts it back afterwards. A story that pins a phone viewport is otherwise photographed one screen tall; a browser "full page" screenshot would not help, because an app shell usually scrolls an inner box rather than the document. qlip measures the document and every scrolling element, grows the viewport, re-measures until nothing scrolls, and caps the height at `fullPageMaxHeight` (default 10000). A page whose content grows with the viewport (a tile sized to its column, a `vh` box) would ask for more every round; a round that asks for no more than the previous growth gave is taken as that, and the capture stays at the height the real content asked for. Under Vitest browser mode the test iframe is scaled down to fit the browser window, so the plugin also grows the window — the Playwright context viewport — through a browser command it registers (`qlipBrowserViewport`), and restores it first; the capture is 1:1, not a shrunk picture of a tall page. The same holds for any pinned `viewport` the window cannot hold: an 844px-tall phone story in a 720px window used to come back at 85%, and now grows the window too. The test-runner path grows its Playwright viewport the same way. The manifest keeps reporting the pinned `viewport` — that is the baseline key; the image is simply taller, and a capture whose content height changed shows on the server as a dimensions change rather than a pixel diff.
+`fullPage` grows the viewport to the page's full content height for the capture and puts it back afterwards. A story that pins a phone viewport is otherwise photographed one screen tall; a browser "full page" screenshot would not help, because an app shell usually scrolls an inner box rather than the document. qlip measures the document and every scrolling element, grows the viewport by what they hide, and re-measures after each growth until nothing scrolls. Two kinds of box are not chased. A box that keeps its height when the viewport grows (a fixed-height code block, a capped list) stays scrolled, and the growth it asked for is given back, so the capture is not padded with blank space. Content that grows with the viewport (a tile sized to its column, a `vh` hero) would ask for more every round; it stops at the height its real content asked for. The height is capped at `fullPageMaxHeight` (default 10000); a page taller than that is captured at the cap with a `[qlip] fullPage:` warning naming the story. Under Vitest browser mode the test iframe is scaled down to fit the browser window, so a `fullPage` capture also grows the window — the Playwright context viewport — through a browser command the plugin registers (`qlipBrowserViewport`), and restores it first; the capture is 1:1, not a shrunk picture of a tall page. `fullSizeCaptures` does the same for every capture (below). The test-runner path grows its Playwright viewport the same way. The manifest keeps reporting the pinned `viewport` — that is the baseline key; the image is simply taller, and a capture whose content height changed shows on the server as a dimensions change rather than a pixel diff.
+
+`fullSizeCaptures` captures every story at the full size of its `viewport`. Under Vitest browser mode the browser window stays at the Playwright context viewport — 1280×720 headless, unless you configure it — whatever the story's `viewport` says, and Vitest scales the test iframe down to fit the window. The layout is the story's, but the pixels are shrunk: a 1920×1080 story comes back 1280×720, a 390×844 phone story 333×720, with its text and any fine difference shrunk with it. With `fullSizeCaptures: true` the window grows to hold the viewport for each capture and is put back afterwards, so the PNG is exactly the viewport. The runner path always captures at full size, and `fullPage` always grows the window.
+
+It is off by default, so upgrading qlip changes no baselines, and it will become the default in a future minor release. Turning it on changes the size of every capture whose viewport is larger than the window (stories that fit it are unaffected), and the server reports each of those as changed against its baseline, a dimensions change. Turn it on in one change on your default branch and accept those captures once.
 
 `waitForIdleMs` waits for DOM mutations to settle before taking a screenshot. This is especially useful for animation libraries like `react-spring` that update inline styles via `requestAnimationFrame`, which bypasses CSS-based animation disabling. Increase it if you still catch mid-transition frames, or lower it for faster runs when your UI is static. `maxWaitForIdleMs` caps the wait so stories with continuously changing UI still complete.
 

package/dist/config/parameters.d.ts

@@ -5,6 +5,7 @@ export interface QlipResolvedOptions {
         width: number;
         height: number;
     };
+    fullSizeCaptures: boolean;
     disableAnimations: boolean;
     pauseAnimationsAtEnd: boolean;
     disableBackdropFilter: boolean;

package/dist/config/parameters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../src/config/parameters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE5G,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,EAAE,gBAAgB,EAAE,CAAC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,yBAAyB,EAAE,MAAM,EAAE,CAAC;CACrC;AAED,eAAO,MAAM,kBAAkB,GAAI,gCAIhC;IACD,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC,KAAG,mBAqDH,CAAC"}
+{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../src/config/parameters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE5G,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,EAAE,gBAAgB,EAAE,CAAC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,yBAAyB,EAAE,MAAM,EAAE,CAAC;CACrC;AAED,eAAO,MAAM,kBAAkB,GAAI,gCAIhC;IACD,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC,KAAG,mBAyDH,CAAC"}

package/dist/config/parameters.js

@@ -2,6 +2,9 @@ export const resolveQlipOptions = ({ defaults, story, override, }) => {
     return {
         skip: override?.skip ?? story?.skip ?? defaults.skip,
         viewport: override?.viewport ?? story?.viewport ?? defaults.viewport,
+        fullSizeCaptures: override?.fullSizeCaptures ??
+            story?.fullSizeCaptures ??
+            defaults.fullSizeCaptures,
         disableAnimations: override?.disableAnimations ??
             story?.disableAnimations ??
             defaults.disableAnimations,

package/dist/plugin/vitestPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vitestPlugin.d.ts","sourceRoot":"","sources":["../../src/plugin/vitestPlugin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAU5C,OAAO,EAAE,iBAAiB,EAAqB,MAAM,aAAa,CAAC;AAanE,eAAO,MAAM,gBAAgB,GAAI,UAAS,iBAAsB,KAAG,MA8QlE,CAAC"}
+{"version":3,"file":"vitestPlugin.d.ts","sourceRoot":"","sources":["../../src/plugin/vitestPlugin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAU5C,OAAO,EAAE,iBAAiB,EAAqB,MAAM,aAAa,CAAC;AAanE,eAAO,MAAM,gBAAgB,GAAI,UAAS,iBAAsB,KAAG,MAkRlE,CAAC"}

package/dist/plugin/vitestPlugin.js

@@ -33,6 +33,9 @@ export const qlipVitestPlugin = (options = {}) => {
                 defaults: {
                     outputDir,
                     viewport: options.viewport ?? DEFAULT_VIEWPORT,
+                    // Off by default — turning it on resizes every capture that was
+                    // being scaled to fit the window. See QlipCaptureOptions.
+                    fullSizeCaptures: options.fullSizeCaptures ?? false,
                     skip: false,
                     disableAnimations: options.disableAnimations ?? false,
                     pauseAnimationsAtEnd: options.pauseAnimationsAtEnd ?? false,
@@ -190,9 +193,10 @@ export const qlipVitestPlugin = (options = {}) => {
                     setupFiles: [setupFile],
                     globalSetup: [globalSetupFile],
                     reporters: reportersList,
-                    // The runtime grows the browser window for a `fullPage` capture
-                    // through this command; it runs here, where the Playwright page
-                    // is. `mergeConfig` merges it beside any commands the consumer
+                    // The runtime grows the browser window for a `fullPage` capture,
+                    // and for every capture with `fullSizeCaptures`, through this
+                    // command; it runs here, where the Playwright page is.
+                    // `mergeConfig` merges it beside any commands the consumer
                     // declares.
                     browser: {
                         commands: {

package/dist/runtime/fullPage.d.ts

@@ -10,9 +10,11 @@
  * viewport) stays as configured, and Vitest scales the iframe down to fit it.
  * A 3,600px-tall iframe in a 1,440px window is photographed at 40% — the
  * whole page, unreadable — and so is a plain 844px-tall phone story in a
- * 720px window, at 85%. `createCaptureViewport` therefore grows the window
- * to hold whatever viewport a capture asks for, pinned or grown, and puts
- * both back afterwards, the window first, so the iframe lands at scale 1.
+ * 720px window, at 85%. `createCaptureViewport` therefore grows the window,
+ * when it is given one, to hold whatever viewport a capture asks for, pinned
+ * or grown, and puts both back afterwards, the window first, so the iframe
+ * lands at scale 1. The runtime gives it the window for a `fullPage` capture
+ * and, with `fullSizeCaptures` on, for every capture.
  *
  * This module has no imports: the runtime, the test-runner and the unit
  * project (which has no DOM and feeds it fakes) all share it.
@@ -22,48 +24,75 @@ export interface FullPageSize {
     height: number;
 }
 /**
- * How tall the page really is: the document, and every box that scrolls
- * its own content. Each scrolling box counts from its own offset, so a box
- * that starts 105px down and scrolls 3,484px asks for 3,589px plus its own
- * border and horizontal scrollbar.
+ * How tall the page needs the viewport to be for nothing on it to scroll:
+ * the document, and every box that scrolls its own content. A scrolling box
+ * asks for the viewport plus whatever it hides — a box that fills the
+ * viewport grows with it one for one, whatever sits above or below it — and
+ * a box that already fits asks for the viewport minus its spare room.
+ * Answers 0 when nothing scrolls.
+ *
+ * A box only counts while growing the viewport can still reveal it, which
+ * only a re-measure after a growth can tell, so the rounds of one capture
+ * share a memory (`reset` starts a new one):
+ * - A box that kept its height when the viewport grew has a height of its
+ *   own (a 200px code block, a capped list). More viewport never reveals its
+ *   content, so it stops counting, and growth it asked for is given back.
+ * - A box whose content grew as much as the box did is sized to it (a tile
+ *   that follows its column). Chasing it only stretches the tile, so it keeps
+ *   asking for what it asked before it scaled. The document gets the same
+ *   test (a `vh` hero).
+ * - A box whose hidden content shrank was revealed and keeps counting, even
+ *   when a growth reveals less than it added.
+ *
+ * The document's own `scrollHeight` is the viewport again once the viewport
+ * outgrows it, so its tallest height while it still scrolled is remembered.
  *
  * Closure-free, so the test-runner can hand it to Playwright's
  * `page.evaluate()`, which re-evaluates the function's source inside the
  * page; there it reads the real `document` and `window`. `env` exists for
  * the unit test, which has neither.
  */
-export declare const measureContentHeight: (env?: {
-    doc: Pick<Document, "documentElement" | "body" | "querySelectorAll">;
-    win: Pick<Window, "getComputedStyle" | "scrollY">;
+export declare const measureContentHeight: (options?: {
+    reset?: boolean;
+    env?: {
+        doc: Pick<Document, "documentElement" | "body" | "querySelectorAll">;
+        win: Pick<Window, "getComputedStyle" | "innerHeight">;
+    };
 }) => number;
+/** Where `growViewportToContent` left the viewport, and why. */
+export interface FullPageGrowth {
+    /** The height the viewport ended at: the pinned height when nothing grew. */
+    height: number;
+    /** What the content last asked for, before the `maxHeight` cap. */
+    wanted: number;
+}
 /**
  * Grows the viewport until nothing on the page scrolls. Growing the viewport
  * re-lays the page out — a scrolling box that was 700px tall becomes 3,500px
  * and may reveal another box below it that scrolls in turn — so the height is
  * measured again after every growth, until a round asks for nothing more or
- * `maxRounds` is spent.
+ * `maxRounds` is spent. Content that does not grow with the viewport, or
+ * grows with it, is `measure`'s call (see `measureContentHeight`); when a
+ * round asks for less than the viewport already is, that growth went to such
+ * a box, and it is given back.
  *
- * A page can also ask for more because it GREW WITH the viewport: a tile
- * sized to its column, a `vh` box. Such content asks for about as much again
- * as the last growth gave it, every round, and would be chased to the cap —
- * a capture that is one screen of content over thousands of pixels of
- * stretched tile. So a round that asks for no more than the previous growth
- * is taken as content that scales, not content that was revealed, and the
- * viewport stays where it is. (Revealed content asks for its own height,
- * unrelated to the growth; it is only missed when it happens to be shorter
- * than the growth that revealed it.)
- *
- * Returns the height the viewport ended at, or `null` when it never had to
- * grow (the caller restores only in that case).
+ * `measure` is told when it is the capture's first round, so it can start a
+ * new memory.
  */
 export declare const growViewportToContent: ({ viewport, maxHeight, setViewport, measure, settle, maxRounds, }: {
     viewport: FullPageSize;
     maxHeight: number;
     setViewport: (width: number, height: number) => Promise<void>;
-    measure: () => number | Promise<number>;
+    measure: (first: boolean) => number | Promise<number>;
     settle: () => Promise<void>;
     maxRounds?: number;
-}) => Promise<number | null>;
+}) => Promise<FullPageGrowth>;
+/**
+ * The warning for a `fullPage` capture the height cap cut short, or `null`:
+ * a page taller than `fullPageMaxHeight` is captured at the cap, and a cut-off
+ * page must not pass for the whole one.
+ */
+export declare const fullPageCapWarning: (storyId: string, growth: FullPageGrowth, maxHeight: number) => string | null;
 /**
  * The browser-window half of the viewport, as the qlip plugin's browser
  * command exposes it: called without a size it answers the window's current

package/dist/runtime/fullPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fullPage.d.ts","sourceRoot":"","sources":["../../src/runtime/fullPage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM;IACzC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,GAAG,kBAAkB,CAAC,CAAC;IACrE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAC,CAAC;CACnD,KAAG,MAiBH,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,qBAAqB,GAAU,mEAOzC;IACD,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,OAAO,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAmBxB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACnC,IAAI,CAAC,EAAE,YAAY,GAAG,IAAI,KACvB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;AAElC;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAAI,6CAInC;IACD,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;CAC7C,KAAG;IACF,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CA4C9B,CAAC"}
+{"version":3,"file":"fullPage.d.ts","sourceRoot":"","sources":["../../src/runtime/fullPage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AA8BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE;QACJ,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,GAAG,kBAAkB,CAAC,CAAC;QACrE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,aAAa,CAAC,CAAC;KACvD,CAAC;CACH,KAAG,MAsEH,CAAC;AAEF,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAAU,mEAOzC;IACD,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,KAAG,OAAO,CAAC,cAAc,CAmBzB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAS,MAAM,EACf,QAAQ,cAAc,EACtB,WAAW,MAAM,KAChB,MAAM,GAAG,IAKF,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACnC,IAAI,CAAC,EAAE,YAAY,GAAG,IAAI,KACvB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;AAElC;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAAI,6CAInC;IACD,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;CAC7C,KAAG;IACF,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CA4C9B,CAAC"}

package/dist/runtime/fullPage.js

@@ -10,40 +10,113 @@
  * viewport) stays as configured, and Vitest scales the iframe down to fit it.
  * A 3,600px-tall iframe in a 1,440px window is photographed at 40% — the
  * whole page, unreadable — and so is a plain 844px-tall phone story in a
- * 720px window, at 85%. `createCaptureViewport` therefore grows the window
- * to hold whatever viewport a capture asks for, pinned or grown, and puts
- * both back afterwards, the window first, so the iframe lands at scale 1.
+ * 720px window, at 85%. `createCaptureViewport` therefore grows the window,
+ * when it is given one, to hold whatever viewport a capture asks for, pinned
+ * or grown, and puts both back afterwards, the window first, so the iframe
+ * lands at scale 1. The runtime gives it the window for a `fullPage` capture
+ * and, with `fullSizeCaptures` on, for every capture.
  *
  * This module has no imports: the runtime, the test-runner and the unit
  * project (which has no DOM and feeds it fakes) all share it.
  */
 /**
- * How tall the page really is: the document, and every box that scrolls
- * its own content. Each scrolling box counts from its own offset, so a box
- * that starts 105px down and scrolls 3,484px asks for 3,589px plus its own
- * border and horizontal scrollbar.
+ * How tall the page needs the viewport to be for nothing on it to scroll:
+ * the document, and every box that scrolls its own content. A scrolling box
+ * asks for the viewport plus whatever it hides — a box that fills the
+ * viewport grows with it one for one, whatever sits above or below it — and
+ * a box that already fits asks for the viewport minus its spare room.
+ * Answers 0 when nothing scrolls.
+ *
+ * A box only counts while growing the viewport can still reveal it, which
+ * only a re-measure after a growth can tell, so the rounds of one capture
+ * share a memory (`reset` starts a new one):
+ * - A box that kept its height when the viewport grew has a height of its
+ *   own (a 200px code block, a capped list). More viewport never reveals its
+ *   content, so it stops counting, and growth it asked for is given back.
+ * - A box whose content grew as much as the box did is sized to it (a tile
+ *   that follows its column). Chasing it only stretches the tile, so it keeps
+ *   asking for what it asked before it scaled. The document gets the same
+ *   test (a `vh` hero).
+ * - A box whose hidden content shrank was revealed and keeps counting, even
+ *   when a growth reveals less than it added.
+ *
+ * The document's own `scrollHeight` is the viewport again once the viewport
+ * outgrows it, so its tallest height while it still scrolled is remembered.
  *
  * Closure-free, so the test-runner can hand it to Playwright's
  * `page.evaluate()`, which re-evaluates the function's source inside the
  * page; there it reads the real `document` and `window`. `env` exists for
  * the unit test, which has neither.
  */
-export const measureContentHeight = (env) => {
-    const doc = env?.doc ?? document;
-    const win = env?.win ?? window;
-    let height = Math.max(doc.documentElement.scrollHeight, doc.body?.scrollHeight ?? 0);
+export const measureContentHeight = (options) => {
+    const doc = options?.env?.doc ?? document;
+    const win = options?.env?.win ?? window;
+    const holder = win;
+    if (options?.reset || !holder.__qlipFullPage) {
+        holder.__qlipFullPage = {
+            viewport: 0,
+            docHeight: 0,
+            docOverflow: 0,
+            docScales: false,
+            boxes: new WeakMap(),
+            fixed: new WeakSet(),
+            scales: new WeakSet(),
+        };
+    }
+    const memory = holder.__qlipFullPage;
+    const viewport = win.innerHeight;
+    const grew = memory.viewport > 0 && viewport > memory.viewport + 1;
+    const docScroll = Math.max(doc.documentElement.scrollHeight, doc.body?.scrollHeight ?? 0);
+    const docOverflow = Math.max(0, docScroll - viewport);
+    if (grew && memory.docOverflow > 0 && docOverflow >= memory.docOverflow - 1) {
+        memory.docScales = true;
+    }
+    memory.docOverflow = docOverflow;
+    if (docOverflow > 1 && !memory.docScales) {
+        memory.docHeight = Math.max(memory.docHeight, docScroll);
+    }
+    let height = memory.docHeight;
     for (const el of Array.from(doc.querySelectorAll('*'))) {
-        if (el.scrollHeight <= el.clientHeight + 1) {
-            continue;
+        const seen = memory.boxes.get(el);
+        if (!seen) {
+            if (el.scrollHeight <= el.clientHeight + 1) {
+                continue;
+            }
+            const overflowY = win.getComputedStyle(el).overflowY;
+            if (overflowY !== 'auto' && overflowY !== 'scroll') {
+                continue;
+            }
+        }
+        const overflow = Math.max(0, el.scrollHeight - el.clientHeight);
+        if (seen && grew) {
+            if (el.clientHeight <= seen.clientHeight + 1) {
+                memory.fixed.add(el);
+            }
+            else if (seen.overflow > 0 && overflow >= seen.overflow - 1) {
+                memory.scales.add(el);
+            }
         }
-        const overflowY = win.getComputedStyle(el).overflowY;
-        if (overflowY !== 'auto' && overflowY !== 'scroll') {
+        if (memory.fixed.has(el)) {
             continue;
         }
-        const top = el.getBoundingClientRect().top + win.scrollY;
-        const chrome = el.offsetHeight - el.clientHeight;
-        height = Math.max(height, Math.ceil(top + el.scrollHeight + chrome));
+        // A box that fits reports its own height as scrollHeight, so its content
+        // height is the one it had while it still scrolled.
+        const content = overflow > 1 ? Math.max(seen?.content ?? 0, el.scrollHeight) : (seen?.content ?? el.scrollHeight);
+        let need;
+        if (seen && memory.scales.has(el)) {
+            need = seen.need;
+        }
+        else if (overflow > 1) {
+            need = viewport + overflow;
+        }
+        else {
+            need = viewport - Math.max(0, el.clientHeight - content);
+        }
+        need = Math.ceil(need);
+        memory.boxes.set(el, { clientHeight: el.clientHeight, overflow, content, need });
+        height = Math.max(height, need);
     }
+    memory.viewport = viewport;
     return height;
 };
 /**
@@ -51,41 +124,44 @@ export const measureContentHeight = (env) => {
  * re-lays the page out — a scrolling box that was 700px tall becomes 3,500px
  * and may reveal another box below it that scrolls in turn — so the height is
  * measured again after every growth, until a round asks for nothing more or
- * `maxRounds` is spent.
- *
- * A page can also ask for more because it GREW WITH the viewport: a tile
- * sized to its column, a `vh` box. Such content asks for about as much again
- * as the last growth gave it, every round, and would be chased to the cap —
- * a capture that is one screen of content over thousands of pixels of
- * stretched tile. So a round that asks for no more than the previous growth
- * is taken as content that scales, not content that was revealed, and the
- * viewport stays where it is. (Revealed content asks for its own height,
- * unrelated to the growth; it is only missed when it happens to be shorter
- * than the growth that revealed it.)
+ * `maxRounds` is spent. Content that does not grow with the viewport, or
+ * grows with it, is `measure`'s call (see `measureContentHeight`); when a
+ * round asks for less than the viewport already is, that growth went to such
+ * a box, and it is given back.
  *
- * Returns the height the viewport ended at, or `null` when it never had to
- * grow (the caller restores only in that case).
+ * `measure` is told when it is the capture's first round, so it can start a
+ * new memory.
  */
 export const growViewportToContent = async ({ viewport, maxHeight, setViewport, measure, settle, maxRounds = 4, }) => {
     let height = viewport.height;
-    let grown = false;
-    let previous = null;
+    let wanted = 0;
     for (let round = 0; round < maxRounds; round += 1) {
-        const asked = Math.min(Math.ceil(await measure()), maxHeight);
-        if (asked <= height) {
+        wanted = Math.ceil(await measure(round === 0));
+        const asked = Math.min(Math.max(wanted, viewport.height), maxHeight);
+        if (asked === height) {
             break;
         }
-        if (previous && asked - previous.asked <= previous.growth) {
-            break;
-        }
-        previous = { asked, growth: asked - height };
+        const givingBack = asked < height;
         height = asked;
-        grown = true;
         await setViewport(viewport.width, height);
         await settle();
+        if (givingBack) {
+            // Every box still counted asked for no more than this, so it fits.
+            break;
+        }
     }
-    return grown ? height : null;
+    return { height, wanted };
 };
+/**
+ * The warning for a `fullPage` capture the height cap cut short, or `null`:
+ * a page taller than `fullPageMaxHeight` is captured at the cap, and a cut-off
+ * page must not pass for the whole one.
+ */
+export const fullPageCapWarning = (storyId, growth, maxHeight) => growth.wanted > maxHeight
+    ? `[qlip] fullPage: ${storyId} is ${String(growth.wanted)}px tall but was captured at ` +
+        `the ${String(maxHeight)}px cap; raise fullPageMaxHeight (Chromium allows up to 16384) ` +
+        'to capture all of it.'
+    : null;
 /**
  * The two viewports a capture sizes, and how each is put back. `set` grows
  * the window to hold the iframe whenever the iframe would not fit (never

package/dist/runtime/screenshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../src/runtime/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,qBAAqB,EACrB,gBAAgB,EAEjB,MAAM,aAAa,CAAC;AAoCrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AA8L1C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,0BAA0B,GACrC,SAAS,MAAM;AACf;;;;;;;GAOG;AACH,gBAAgB,MAAM,KACrB;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAiCvD,CAAC;AAwDF;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,GAAI,qEAIxC;IACD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,qBAAqB,EAAE,OAAO,CAAC;CAChC,SA+DA,CAAC;AAwbF,eAAO,MAAM,UAAU,GACrB,KAAK,gBAAgB,EACrB,gBAAgB,MAAM,GAAG,qBAAqB,EAC9C,UAAU,qBAAqB,kBA0BhC,CAAC;AAEF,KAAK,eAAe,GAAG,WAAW,GAAG;IAAE,KAAK,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC;AA8ClE,eAAO,MAAM,qBAAqB,GAAU,KAAK,eAAe,kBAiG/D,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAU,KAAK,eAAe,kBAkEhE,CAAC"}
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../src/runtime/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,qBAAqB,EACrB,gBAAgB,EAEjB,MAAM,aAAa,CAAC;AAqCrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AA8L1C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,0BAA0B,GACrC,SAAS,MAAM;AACf;;;;;;;GAOG;AACH,gBAAgB,MAAM,KACrB;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAiCvD,CAAC;AAwDF;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,GAAI,qEAIxC;IACD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,qBAAqB,EAAE,OAAO,CAAC;CAChC,SA+DA,CAAC;AAicF,eAAO,MAAM,UAAU,GACrB,KAAK,gBAAgB,EACrB,gBAAgB,MAAM,GAAG,qBAAqB,EAC9C,UAAU,qBAAqB,kBA0BhC,CAAC;AAEF,KAAK,eAAe,GAAG,WAAW,GAAG;IAAE,KAAK,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC;AA8ClE,eAAO,MAAM,qBAAqB,GAAU,KAAK,eAAe,kBAiG/D,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAU,KAAK,eAAe,kBAkEhE,CAAC"}

package/dist/runtime/screenshot.js

@@ -1,5 +1,5 @@
 import { resolveQlipOptions } from '../config/parameters.js';
-import { createCaptureViewport, growViewportToContent, measureContentHeight, } from './fullPage.js';
+import { createCaptureViewport, fullPageCapWarning, growViewportToContent, measureContentHeight, } from './fullPage.js';
 import { monotonicNow, realClearInterval, realSetInterval, realSetTimeout, } from './clock.js';
 import { AUTO_ERROR_SCREENSHOT_BASE, MANIFEST_FRAGMENT_DIR, buildAutoLogPath, buildAutoScreenshotPath, buildManualLogPath, buildManualScreenshotPath, fragmentFileName, joinPath, sanitizeSegment, } from '../fs/output.js';
 import { flushConsoleLogs, initRuntimeState, markStorybookWarning, nextFragmentSeq, nextStepName, pruneStaleErrorEntries, pushEntry, updateStats, } from './context.js';
@@ -491,13 +491,17 @@ const captureScreenshot = async ({ kind, story, screenshotName, options, testErr
     // throws.
     let error = testError ?? null;
     let cleanupMasks = null;
-    // The browser window grows to hold whatever viewport the capture asks for,
-    // pinned or full-page, or the capture comes back scaled down to fit the
-    // window (see ./fullPage.ts).
+    // Unless the browser window grows with it, a viewport larger than the
+    // window is captured scaled down to fit it (see ./fullPage.ts). Growing it
+    // resizes captures that already have baselines, so it is opt-in
+    // (`fullSizeCaptures`); a `fullPage` capture always grows it, since scaled
+    // it is unreadable.
     const captureViewport = createCaptureViewport({
         pinned: resolved.viewport,
         iframe: (width, height) => page.viewport(width, height),
-        window: commands.qlipBrowserViewport,
+        window: resolved.fullSizeCaptures || resolved.fullPage
+            ? commands.qlipBrowserViewport
+            : undefined,
     });
     try {
         await captureViewport.set(resolved.viewport.width, resolved.viewport.height);
@@ -508,13 +512,17 @@ const captureScreenshot = async ({ kind, story, screenshotName, options, testErr
         });
         await waitForDomIdle(resolved.waitForIdleMs, resolved.maxWaitForIdleMs);
         if (resolved.fullPage) {
-            await growViewportToContent({
+            const growth = await growViewportToContent({
                 viewport: resolved.viewport,
                 maxHeight: resolved.fullPageMaxHeight,
                 setViewport: captureViewport.set,
-                measure: () => measureContentHeight(),
+                measure: (first) => measureContentHeight({ reset: first }),
                 settle: () => waitForDomIdle(resolved.waitForIdleMs, resolved.maxWaitForIdleMs),
             });
+            const warning = fullPageCapWarning(story.id, growth, resolved.fullPageMaxHeight);
+            if (warning) {
+                console.warn(warning);
+            }
         }
         cleanupMasks = applyIgnoreMasks(resolved.ignoreElements);
         await page.screenshot({ path: absolutePath, save: true });

package/dist/stories/Page.stories.d.ts

@@ -9,6 +9,13 @@ declare const meta: {
 export default meta;
 type Story = StoryObj<typeof meta>;
 export declare const LoggedOut: Story;
+/**
+ * A desktop viewport wider and taller than the 1280×720 headless browser
+ * window. `fullSizeCaptures` grows the window to hold it, so the capture is
+ * 1920×1080; without it Vitest would scale the story down to 1280×720. The
+ * e2e test reads the PNG.
+ */
+export declare const DesktopFullSize: Story;
 export declare const LoggedIn: Story;
 export declare const ElementWithFullHeight: Story;
 export declare const WithConsoleError: Story;

package/dist/stories/Page.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Page.stories.d.ts","sourceRoot":"","sources":["../../src/stories/Page.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAO5D,QAAA,MAAM,IAAI;;;;;;CAOmB,CAAC;AAE9B,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAGnC,eAAO,MAAM,SAAS,EAAE,KAAU,CAAC;AAGnC,eAAO,MAAM,QAAQ,EAAE,KAatB,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,KAQnC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KAS9B,CAAC"}
+{"version":3,"file":"Page.stories.d.ts","sourceRoot":"","sources":["../../src/stories/Page.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAO5D,QAAA,MAAM,IAAI;;;;;;CAOmB,CAAC;AAE9B,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAGnC,eAAO,MAAM,SAAS,EAAE,KAAU,CAAC;AAEnC;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,KAI7B,CAAC;AAGF,eAAO,MAAM,QAAQ,EAAE,KAatB,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,KAQnC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KAS9B,CAAC"}

package/dist/stories/Page.stories.js

@@ -12,6 +12,17 @@ const meta = {
 };
 export default meta;
 export const LoggedOut = {};
+/**
+ * A desktop viewport wider and taller than the 1280×720 headless browser
+ * window. `fullSizeCaptures` grows the window to hold it, so the capture is
+ * 1920×1080; without it Vitest would scale the story down to 1280×720. The
+ * e2e test reads the PNG.
+ */
+export const DesktopFullSize = {
+    parameters: {
+        qlip: { viewport: { width: 1920, height: 1080 }, fullSizeCaptures: true },
+    },
+};
 // More on component testing: https://storybook.js.org/docs/writing-tests/interaction-testing
 export const LoggedIn = {
     play: async (ctx) => {

package/dist/stories/TallPage.d.ts

@@ -11,4 +11,10 @@ export interface ITallPageProps {
  * screenshot can see it.
  */
 export declare const TallPage: ({ sections }: ITallPageProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * An ordinary page, nothing pinned, whose only scroller is a fixed-height
+ * box (a code block, a capped list). Growing the viewport never grows that
+ * box, so a `fullPage` capture has nothing to reveal and stays one screen.
+ */
+export declare const FixedBoxPage: () => import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=TallPage.d.ts.map

package/dist/stories/TallPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TallPage.d.ts","sourceRoot":"","sources":["../../src/stories/TallPage.tsx"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GAAI,cAAmB,cAAc,4CAiCzD,CAAC"}
+{"version":3,"file":"TallPage.d.ts","sourceRoot":"","sources":["../../src/stories/TallPage.tsx"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GAAI,cAAmB,cAAc,4CAiCzD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,+CAWxB,CAAC"}

package/dist/stories/TallPage.js

@@ -22,3 +22,9 @@ export const TallPage = ({ sections = 12 }) => (_jsxs("div", { style: { height:
                     borderBottom: '1px solid #e5e7eb',
                     background: index % 2 ? '#f9fafb' : '#fff',
                 }, children: [_jsxs("h2", { style: { margin: 0 }, children: ["Section ", index + 1] }), _jsxs("p", { children: ["Message ", index + 1, " of ", sections, "."] })] }, index))) })] }));
+/**
+ * An ordinary page, nothing pinned, whose only scroller is a fixed-height
+ * box (a code block, a capped list). Growing the viewport never grows that
+ * box, so a `fullPage` capture has nothing to reveal and stays one screen.
+ */
+export const FixedBoxPage = () => (_jsxs("div", { style: { padding: 16, fontFamily: 'sans-serif' }, children: [_jsx("h1", { style: { margin: 0 }, children: "Release notes" }), _jsx("pre", { "data-testid": "fixed-box", style: { height: 200, margin: '16px 0', overflowY: 'auto', border: '1px solid #d1d5db' }, children: Array.from({ length: 100 }, (_, index) => `line ${String(index + 1)}`).join('\n') }), _jsx("p", { style: { margin: 0 }, children: "The page ends here." })] }));

package/dist/stories/TallPage.stories.d.ts

@@ -15,6 +15,23 @@ type Story = StoryObj<typeof meta>;
  * The manifest keeps the pinned viewport as the baseline key.
  */
 export declare const ScrollsAnInnerBox: Story;
-/** The same page without `fullPage`: one screen, the rest scrolled away. */
+/**
+ * The same page without `fullPage`: one screen, the rest scrolled away. The
+ * 844px-tall viewport does not fit the 720px headless browser window, so
+ * Vitest scales the story down to fit it and the capture comes back 333×720
+ * — the size such a capture has always had. The e2e test reads it.
+ */
 export declare const OneScreen: Story;
+/**
+ * `OneScreen` with `fullSizeCaptures`: qlip grows the browser window to hold
+ * the viewport, so the capture is exactly 390×844.
+ */
+export declare const OneScreenFullSize: Story;
+/**
+ * `fullPage` on an ordinary page whose only scroller is a fixed-height box:
+ * more viewport never reveals it, so qlip gives the growth back and the
+ * capture stays one screen — not a screen of page over a tall blank strip.
+ * The e2e test reads the PNG's height.
+ */
+export declare const FixedHeightBox: Story;
 //# sourceMappingURL=TallPage.stories.d.ts.map

package/dist/stories/TallPage.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TallPage.stories.d.ts","sourceRoot":"","sources":["../../src/stories/TallPage.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAK5D,QAAA,MAAM,IAAI;;;;;;CAMuB,CAAC;AAElC,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAgBnC;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAK/B,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,SAAS,EAAE,KAKvB,CAAC"}
+{"version":3,"file":"TallPage.stories.d.ts","sourceRoot":"","sources":["../../src/stories/TallPage.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAK5D,QAAA,MAAM,IAAI;;;;;;CAMuB,CAAC;AAElC,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAgBnC;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAK/B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,KAKvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAK/B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,KAU5B,CAAC"}

package/dist/stories/TallPage.stories.js

@@ -1,5 +1,6 @@
+import { jsx as _jsx } from "react/jsx-runtime";
 import { expect, within } from 'storybook/test';
-import { TallPage } from './TallPage.js';
+import { FixedBoxPage, TallPage } from './TallPage.js';
 const meta = {
     title: 'Example/TallPage',
     component: TallPage,
@@ -32,10 +33,43 @@ export const ScrollsAnInnerBox = {
     },
     play: expectsAnInnerScroller,
 };
-/** The same page without `fullPage`: one screen, the rest scrolled away. */
+/**
+ * The same page without `fullPage`: one screen, the rest scrolled away. The
+ * 844px-tall viewport does not fit the 720px headless browser window, so
+ * Vitest scales the story down to fit it and the capture comes back 333×720
+ * — the size such a capture has always had. The e2e test reads it.
+ */
 export const OneScreen = {
     parameters: {
         qlip: { viewport: PHONE },
     },
     play: expectsAnInnerScroller,
 };
+/**
+ * `OneScreen` with `fullSizeCaptures`: qlip grows the browser window to hold
+ * the viewport, so the capture is exactly 390×844.
+ */
+export const OneScreenFullSize = {
+    parameters: {
+        qlip: { viewport: PHONE, fullSizeCaptures: true },
+    },
+    play: expectsAnInnerScroller,
+};
+/**
+ * `fullPage` on an ordinary page whose only scroller is a fixed-height box:
+ * more viewport never reveals it, so qlip gives the growth back and the
+ * capture stays one screen — not a screen of page over a tall blank strip.
+ * The e2e test reads the PNG's height.
+ */
+export const FixedHeightBox = {
+    render: () => _jsx(FixedBoxPage, {}),
+    parameters: {
+        qlip: { viewport: PHONE, fullPage: true },
+    },
+    play: async ({ canvasElement }) => {
+        const box = canvasElement.querySelector('[data-testid="fixed-box"]');
+        if (!box)
+            throw new Error('box not rendered');
+        await expect(box.scrollHeight).toBeGreaterThan(box.clientHeight);
+    },
+};

package/dist/test-runner/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test-runner/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAcH,OAAO,KAAK,EACV,kBAAkB,EAGlB,iBAAiB,EACjB,cAAc,EAGf,MAAM,aAAa,CAAC;AACrB,OAAO,EAGL,YAAY,EAIb,MAAM,qBAAqB,CAAC;AAS7B;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnE,UAAU,CAAC,IAAI,EAAE;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACtE;;;;;;;;;;;;;;OAcG;IACH,eAAe,CAAC,EAAE,CAChB,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,gBAAgB,KACtB,OAAO,CAAC;QAAE,UAAU,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,cAAc,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;CAC1D;AA+HD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,mBAAmB,EACzB,SAAS,gBAAgB,EACzB,UAAS,mBAAwB,KAChC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAelC,CAAC;AAmJF,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test-runner/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAkBH,OAAO,KAAK,EACV,kBAAkB,EAGlB,iBAAiB,EACjB,cAAc,EAGf,MAAM,aAAa,CAAC;AACrB,OAAO,EAGL,YAAY,EAIb,MAAM,qBAAqB,CAAC;AAS7B;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnE,UAAU,CAAC,IAAI,EAAE;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACtE;;;;;;;;;;;;;;OAcG;IACH,eAAe,CAAC,EAAE,CAChB,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,gBAAgB,KACtB,OAAO,CAAC;QAAE,UAAU,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,cAAc,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;CAC1D;AAkID;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,mBAAmB,EACzB,SAAS,gBAAgB,EACzB,UAAS,mBAAwB,KAChC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAelC,CAAC;AA0JF,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/test-runner/index.js

@@ -44,7 +44,7 @@
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { resolveQlipOptions } from '../config/parameters.js';
-import { growViewportToContent, measureContentHeight } from '../runtime/fullPage.js';
+import { fullPageCapWarning, growViewportToContent, measureContentHeight, } from '../runtime/fullPage.js';
 import { DEFAULT_OUTPUT_DIR, DEFAULT_VIEWPORT, MANIFEST_FRAGMENT_DIR, TOOL_NAME, buildAutoScreenshotPath, generateBuildId, } from '../fs/output.js';
 import { writeEntryFragment, getOrInitStore, nextStepName, peekStore, pushEntry, } from './manifest-store.js';
 import { applyAnimationControlInPage, applyIgnoreMasksInPage, removeIgnoreMasksInPage, waitForDomIdleInPage, } from './prep-scripts.js';
@@ -60,6 +60,9 @@ const buildResolvedDefaults = (override) => {
     return {
         outputDir: DEFAULT_OUTPUT_DIR,
         viewport: fallbackViewport,
+        // Not read on this path: `page.setViewportSize` sizes the page itself,
+        // so every capture here is full size already.
+        fullSizeCaptures: override?.fullSizeCaptures ?? false,
         skip: false,
         disableAnimations: override?.disableAnimations ?? false,
         pauseAnimationsAtEnd: override?.pauseAnimationsAtEnd ?? false,
@@ -243,16 +246,23 @@ const qlipCaptureInner = async (page, context, options) => {
         if (resolved.fullPage) {
             // Here the viewport IS the browser window, so growing it is one call;
             // the measure runs inside the page (see ../runtime/fullPage.ts).
-            grownTo = await growViewportToContent({
+            const growth = await growViewportToContent({
                 viewport: resolved.viewport,
                 maxHeight: resolved.fullPageMaxHeight,
                 setViewport: (width, height) => page.setViewportSize({ width, height }),
-                measure: () => page.evaluate(measureContentHeight, undefined),
+                measure: (first) => page.evaluate(measureContentHeight, { reset: first }),
                 settle: () => page.evaluate(waitForDomIdleInPage, {
                     idleMs: resolved.waitForIdleMs,
                     maxWaitMs: resolved.maxWaitForIdleMs,
                 }),
             });
+            if (growth.height !== resolved.viewport.height) {
+                grownTo = growth.height;
+            }
+            const warning = fullPageCapWarning(context.id, growth, resolved.fullPageMaxHeight);
+            if (warning) {
+                console.warn(warning);
+            }
         }
         if (resolved.ignoreElements.length > 0) {
             maskIds = await page.evaluate(applyIgnoreMasksInPage, {

package/dist/types.d.ts

@@ -6,12 +6,29 @@ export interface QlipCaptureOptions {
     skip?: boolean;
     /**
      * The capture's viewport, and the baseline key on the server. Under
-     * Vitest browser mode a viewport the browser window cannot hold grows the
-     * window for the capture (and puts it back), because Vitest otherwise
-     * scales the test iframe down to fit and the capture comes back smaller
-     * than the viewport it names.
+     * Vitest browser mode a viewport larger than the browser window is
+     * captured scaled down to fit it, unless `fullSizeCaptures` is on.
      */
     viewport?: QlipViewport;
+    /**
+     * Capture at the full size of `viewport`, pixel for pixel. Under Vitest
+     * browser mode the browser window (the Playwright context viewport,
+     * 1280×720 headless unless configured) does not follow `viewport`: Vitest
+     * sizes the test iframe to the viewport and scales the iframe down to fit
+     * the window. The layout is the viewport's, but the pixels are shrunk: a
+     * 1920×1080 story is captured at 1280×720, a 390×844 phone story at
+     * 333×720. With this on, the window grows to hold the viewport for the
+     * capture and is put back afterwards, so the capture is exactly `viewport`.
+     *
+     * Off by default: turning it on changes the size of every capture that was
+     * being scaled, and the server reports each one as changed against its
+     * baseline, so accept them once. A `fullPage` capture grows the window
+     * either way. The Storybook test-runner path sizes the page's own viewport
+     * and always captures at full size.
+     *
+     * @default false
+     */
+    fullSizeCaptures?: boolean;
     disableAnimations?: boolean;
     pauseAnimationsAtEnd?: boolean;
     /**
@@ -32,15 +49,18 @@ export interface QlipCaptureOptions {
      * and a Playwright "full page" shot would not help, because an app shell
      * usually scrolls an inner box, not the document. The height is measured
      * from the document AND every scrolling element (an `overflow-y: auto |
-     * scroll` box whose `scrollHeight` exceeds its `clientHeight`, placed at
-     * its offset), re-measured after each growth until nothing scrolls, and
-     * capped at `fullPageMaxHeight`. Under Vitest browser mode the browser
-     * window (the Playwright context viewport) grows with the test iframe,
-     * or the capture would be scaled down to fit the window; both are put
-     * back afterwards. The manifest still reports the pinned `viewport` —
-     * that is the baseline key; the picture is simply taller. A capture whose
-     * content height changed shows on the server as a dimensions change
-     * rather than a pixel diff.
+     * scroll` box whose `scrollHeight` exceeds its `clientHeight`), and
+     * re-measured after each growth until nothing scrolls. A box that keeps
+     * its height when the viewport grows (a fixed-height code block) stays
+     * scrolled and gives its growth back, and content that grows with the
+     * viewport is not chased. Capped at `fullPageMaxHeight`. Under Vitest
+     * browser mode the browser window (the Playwright context viewport) grows
+     * with the test iframe whatever `fullSizeCaptures` says, or the capture
+     * would be scaled down to fit the window; both are put back afterwards.
+     * The manifest still reports the pinned `viewport` — that is the baseline
+     * key; the picture is simply taller. A capture whose content height
+     * changed shows on the server as a dimensions change rather than a pixel
+     * diff.
      *
      * @default false
      */
@@ -48,7 +68,8 @@ export interface QlipCaptureOptions {
     /**
      * The tallest a `fullPage` capture may grow to, in CSS pixels. Chromium
      * refuses viewports past 16384; the default leaves room for very long
-     * pages without inviting a runaway layout.
+     * pages without inviting a runaway layout. A page taller than this is
+     * captured at the cap, with a `[qlip] fullPage:` warning naming the story.
      *
      * @default 10000
      */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist-cjs/config/parameters.js

@@ -5,6 +5,9 @@ const resolveQlipOptions = ({ defaults, story, override, }) => {
     return {
         skip: override?.skip ?? story?.skip ?? defaults.skip,
         viewport: override?.viewport ?? story?.viewport ?? defaults.viewport,
+        fullSizeCaptures: override?.fullSizeCaptures ??
+            story?.fullSizeCaptures ??
+            defaults.fullSizeCaptures,
         disableAnimations: override?.disableAnimations ??
             story?.disableAnimations ??
             defaults.disableAnimations,

package/dist-cjs/runtime/fullPage.js

@@ -11,42 +11,115 @@
  * viewport) stays as configured, and Vitest scales the iframe down to fit it.
  * A 3,600px-tall iframe in a 1,440px window is photographed at 40% — the
  * whole page, unreadable — and so is a plain 844px-tall phone story in a
- * 720px window, at 85%. `createCaptureViewport` therefore grows the window
- * to hold whatever viewport a capture asks for, pinned or grown, and puts
- * both back afterwards, the window first, so the iframe lands at scale 1.
+ * 720px window, at 85%. `createCaptureViewport` therefore grows the window,
+ * when it is given one, to hold whatever viewport a capture asks for, pinned
+ * or grown, and puts both back afterwards, the window first, so the iframe
+ * lands at scale 1. The runtime gives it the window for a `fullPage` capture
+ * and, with `fullSizeCaptures` on, for every capture.
  *
  * This module has no imports: the runtime, the test-runner and the unit
  * project (which has no DOM and feeds it fakes) all share it.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCaptureViewport = exports.growViewportToContent = exports.measureContentHeight = void 0;
+exports.createCaptureViewport = exports.fullPageCapWarning = exports.growViewportToContent = exports.measureContentHeight = void 0;
 /**
- * How tall the page really is: the document, and every box that scrolls
- * its own content. Each scrolling box counts from its own offset, so a box
- * that starts 105px down and scrolls 3,484px asks for 3,589px plus its own
- * border and horizontal scrollbar.
+ * How tall the page needs the viewport to be for nothing on it to scroll:
+ * the document, and every box that scrolls its own content. A scrolling box
+ * asks for the viewport plus whatever it hides — a box that fills the
+ * viewport grows with it one for one, whatever sits above or below it — and
+ * a box that already fits asks for the viewport minus its spare room.
+ * Answers 0 when nothing scrolls.
+ *
+ * A box only counts while growing the viewport can still reveal it, which
+ * only a re-measure after a growth can tell, so the rounds of one capture
+ * share a memory (`reset` starts a new one):
+ * - A box that kept its height when the viewport grew has a height of its
+ *   own (a 200px code block, a capped list). More viewport never reveals its
+ *   content, so it stops counting, and growth it asked for is given back.
+ * - A box whose content grew as much as the box did is sized to it (a tile
+ *   that follows its column). Chasing it only stretches the tile, so it keeps
+ *   asking for what it asked before it scaled. The document gets the same
+ *   test (a `vh` hero).
+ * - A box whose hidden content shrank was revealed and keeps counting, even
+ *   when a growth reveals less than it added.
+ *
+ * The document's own `scrollHeight` is the viewport again once the viewport
+ * outgrows it, so its tallest height while it still scrolled is remembered.
  *
  * Closure-free, so the test-runner can hand it to Playwright's
  * `page.evaluate()`, which re-evaluates the function's source inside the
  * page; there it reads the real `document` and `window`. `env` exists for
  * the unit test, which has neither.
  */
-const measureContentHeight = (env) => {
-    const doc = env?.doc ?? document;
-    const win = env?.win ?? window;
-    let height = Math.max(doc.documentElement.scrollHeight, doc.body?.scrollHeight ?? 0);
+const measureContentHeight = (options) => {
+    const doc = options?.env?.doc ?? document;
+    const win = options?.env?.win ?? window;
+    const holder = win;
+    if (options?.reset || !holder.__qlipFullPage) {
+        holder.__qlipFullPage = {
+            viewport: 0,
+            docHeight: 0,
+            docOverflow: 0,
+            docScales: false,
+            boxes: new WeakMap(),
+            fixed: new WeakSet(),
+            scales: new WeakSet(),
+        };
+    }
+    const memory = holder.__qlipFullPage;
+    const viewport = win.innerHeight;
+    const grew = memory.viewport > 0 && viewport > memory.viewport + 1;
+    const docScroll = Math.max(doc.documentElement.scrollHeight, doc.body?.scrollHeight ?? 0);
+    const docOverflow = Math.max(0, docScroll - viewport);
+    if (grew && memory.docOverflow > 0 && docOverflow >= memory.docOverflow - 1) {
+        memory.docScales = true;
+    }
+    memory.docOverflow = docOverflow;
+    if (docOverflow > 1 && !memory.docScales) {
+        memory.docHeight = Math.max(memory.docHeight, docScroll);
+    }
+    let height = memory.docHeight;
     for (const el of Array.from(doc.querySelectorAll('*'))) {
-        if (el.scrollHeight <= el.clientHeight + 1) {
-            continue;
+        const seen = memory.boxes.get(el);
+        if (!seen) {
+            if (el.scrollHeight <= el.clientHeight + 1) {
+                continue;
+            }
+            const overflowY = win.getComputedStyle(el).overflowY;
+            if (overflowY !== 'auto' && overflowY !== 'scroll') {
+                continue;
+            }
+        }
+        const overflow = Math.max(0, el.scrollHeight - el.clientHeight);
+        if (seen && grew) {
+            if (el.clientHeight <= seen.clientHeight + 1) {
+                memory.fixed.add(el);
+            }
+            else if (seen.overflow > 0 && overflow >= seen.overflow - 1) {
+                memory.scales.add(el);
+            }
         }
-        const overflowY = win.getComputedStyle(el).overflowY;
-        if (overflowY !== 'auto' && overflowY !== 'scroll') {
+        if (memory.fixed.has(el)) {
             continue;
         }
-        const top = el.getBoundingClientRect().top + win.scrollY;
-        const chrome = el.offsetHeight - el.clientHeight;
-        height = Math.max(height, Math.ceil(top + el.scrollHeight + chrome));
+        // A box that fits reports its own height as scrollHeight, so its content
+        // height is the one it had while it still scrolled.
+        const content = overflow > 1 ? Math.max(seen?.content ?? 0, el.scrollHeight) : (seen?.content ?? el.scrollHeight);
+        let need;
+        if (seen && memory.scales.has(el)) {
+            need = seen.need;
+        }
+        else if (overflow > 1) {
+            need = viewport + overflow;
+        }
+        else {
+            need = viewport - Math.max(0, el.clientHeight - content);
+        }
+        need = Math.ceil(need);
+        memory.boxes.set(el, { clientHeight: el.clientHeight, overflow, content, need });
+        height = Math.max(height, need);
     }
+    memory.viewport = viewport;
     return height;
 };
 exports.measureContentHeight = measureContentHeight;
@@ -55,42 +128,46 @@ exports.measureContentHeight = measureContentHeight;
  * re-lays the page out — a scrolling box that was 700px tall becomes 3,500px
  * and may reveal another box below it that scrolls in turn — so the height is
  * measured again after every growth, until a round asks for nothing more or
- * `maxRounds` is spent.
- *
- * A page can also ask for more because it GREW WITH the viewport: a tile
- * sized to its column, a `vh` box. Such content asks for about as much again
- * as the last growth gave it, every round, and would be chased to the cap —
- * a capture that is one screen of content over thousands of pixels of
- * stretched tile. So a round that asks for no more than the previous growth
- * is taken as content that scales, not content that was revealed, and the
- * viewport stays where it is. (Revealed content asks for its own height,
- * unrelated to the growth; it is only missed when it happens to be shorter
- * than the growth that revealed it.)
+ * `maxRounds` is spent. Content that does not grow with the viewport, or
+ * grows with it, is `measure`'s call (see `measureContentHeight`); when a
+ * round asks for less than the viewport already is, that growth went to such
+ * a box, and it is given back.
  *
- * Returns the height the viewport ended at, or `null` when it never had to
- * grow (the caller restores only in that case).
+ * `measure` is told when it is the capture's first round, so it can start a
+ * new memory.
  */
 const growViewportToContent = async ({ viewport, maxHeight, setViewport, measure, settle, maxRounds = 4, }) => {
     let height = viewport.height;
-    let grown = false;
-    let previous = null;
+    let wanted = 0;
     for (let round = 0; round < maxRounds; round += 1) {
-        const asked = Math.min(Math.ceil(await measure()), maxHeight);
-        if (asked <= height) {
+        wanted = Math.ceil(await measure(round === 0));
+        const asked = Math.min(Math.max(wanted, viewport.height), maxHeight);
+        if (asked === height) {
             break;
         }
-        if (previous && asked - previous.asked <= previous.growth) {
-            break;
-        }
-        previous = { asked, growth: asked - height };
+        const givingBack = asked < height;
         height = asked;
-        grown = true;
         await setViewport(viewport.width, height);
         await settle();
+        if (givingBack) {
+            // Every box still counted asked for no more than this, so it fits.
+            break;
+        }
     }
-    return grown ? height : null;
+    return { height, wanted };
 };
 exports.growViewportToContent = growViewportToContent;
+/**
+ * The warning for a `fullPage` capture the height cap cut short, or `null`:
+ * a page taller than `fullPageMaxHeight` is captured at the cap, and a cut-off
+ * page must not pass for the whole one.
+ */
+const fullPageCapWarning = (storyId, growth, maxHeight) => growth.wanted > maxHeight
+    ? `[qlip] fullPage: ${storyId} is ${String(growth.wanted)}px tall but was captured at ` +
+        `the ${String(maxHeight)}px cap; raise fullPageMaxHeight (Chromium allows up to 16384) ` +
+        'to capture all of it.'
+    : null;
+exports.fullPageCapWarning = fullPageCapWarning;
 /**
  * The two viewports a capture sizes, and how each is put back. `set` grows
  * the window to hold the iframe whenever the iframe would not fit (never

package/dist-cjs/test-runner/index.js

@@ -67,6 +67,9 @@ const buildResolvedDefaults = (override) => {
     return {
         outputDir: output_js_1.DEFAULT_OUTPUT_DIR,
         viewport: fallbackViewport,
+        // Not read on this path: `page.setViewportSize` sizes the page itself,
+        // so every capture here is full size already.
+        fullSizeCaptures: override?.fullSizeCaptures ?? false,
         skip: false,
         disableAnimations: override?.disableAnimations ?? false,
         pauseAnimationsAtEnd: override?.pauseAnimationsAtEnd ?? false,
@@ -251,16 +254,23 @@ const qlipCaptureInner = async (page, context, options) => {
         if (resolved.fullPage) {
             // Here the viewport IS the browser window, so growing it is one call;
             // the measure runs inside the page (see ../runtime/fullPage.ts).
-            grownTo = await (0, fullPage_js_1.growViewportToContent)({
+            const growth = await (0, fullPage_js_1.growViewportToContent)({
                 viewport: resolved.viewport,
                 maxHeight: resolved.fullPageMaxHeight,
                 setViewport: (width, height) => page.setViewportSize({ width, height }),
-                measure: () => page.evaluate(fullPage_js_1.measureContentHeight, undefined),
+                measure: (first) => page.evaluate(fullPage_js_1.measureContentHeight, { reset: first }),
                 settle: () => page.evaluate(prep_scripts_js_1.waitForDomIdleInPage, {
                     idleMs: resolved.waitForIdleMs,
                     maxWaitMs: resolved.maxWaitForIdleMs,
                 }),
             });
+            if (growth.height !== resolved.viewport.height) {
+                grownTo = growth.height;
+            }
+            const warning = (0, fullPage_js_1.fullPageCapWarning)(context.id, growth, resolved.fullPageMaxHeight);
+            if (warning) {
+                console.warn(warning);
+            }
         }
         if (resolved.ignoreElements.length > 0) {
             maskIds = await page.evaluate(prep_scripts_js_1.applyIgnoreMasksInPage, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qoretechnologies/qlip",
-  "version": "0.1.3-pr.30.gc00bad8",
+  "version": "0.1.3-pr.30.gffaaa15",
   "description": "Storybook screenshot capture for the Vitest addon",
   "type": "module",
   "main": "./dist/index.js",