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

package/README.md

@@ -231,7 +231,7 @@ 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 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.
 
 `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/runtime/fullPage.d.ts

@@ -22,48 +22,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;;;;;;;;;;;;;;;;;;GAkBG;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

@@ -18,32 +18,103 @@
  * 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 +122,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;AA4bF,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';
@@ -508,13 +508,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/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

@@ -17,4 +17,11 @@ type Story = StoryObj<typeof meta>;
 export declare const ScrollsAnInnerBox: Story;
 /** The same page without `fullPage`: one screen, the rest scrolled away. */
 export declare const OneScreen: 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,4EAA4E;AAC5E,eAAO,MAAM,SAAS,EAAE,KAKvB,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,
@@ -39,3 +40,21 @@ export const OneScreen = {
     },
     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;AA+HD;;;;;;;;;;;;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';
@@ -243,16 +243,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

@@ -32,10 +32,13 @@ 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,
+     * 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,
      * 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
@@ -48,7 +51,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/runtime/fullPage.js

@@ -19,34 +19,105 @@
  * 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 +126,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

@@ -251,16 +251,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.gc7b05dc",
   "description": "Storybook screenshot capture for the Vitest addon",
   "type": "module",
   "main": "./dist/index.js",