Files
buzz/desktop/tests/e2e/upscroll-anchor-contract.perf.ts
npub1cc3ha7z055mu0rwwu7806t2wt8mj3pvu0uv5mfp2c50dahaqhczshdalg6 f8adc9f155 feat(desktop): wire measured column width into row estimates + anchor-contract guard
Two of the deferred scroll-jitter seams, on top of the integrated fix train
(T1.1 gate -> T2 writer -> T3 estimator @ 1fa4551a):

- columnWidthPx: measure the timeline row column once (useElementWidth) and
  thread it into timelineRowReserveStyle so row-height reserves use the real
  wrap width instead of the 64-char fallback. Pre-measure zero passes undefined
  to preserve the estimator's own fallback rather than tripping its min-chars
  floor. On jitter-corpus this shrinks estimate-error R from 75 -> 55 peak
  (better reserves = smaller realized-vs-reserved delta) while the motion gate
  stays GREEN 0.00/0.00 -- R moves only in the estimator lane, the gate only in
  the writer lane, cross-lane invariant intact.

- Wren #4 anchor-contract guard: a companion perf test that reads the PRODUCTION
  computed overflow-anchor on the real conversation scroller (no test override)
  and asserts it resolves to none. The jitter gate forces the property for its
  measurement; this proves the shipped stylesheet actually ships it, so a
  regression that hands correction back to Chromium's native anchoring (masking
  a WKWebView-only on-device break) fails loudly.

The onRealizedHeight seam is intentionally NOT wired: T4 ground truth
(RESEARCH/GUI_SCROLL_RECLAIM_T4.md) shows the upscroll path is append-only with
no unmount, so it needs no JS height cache; a per-event-id cache is only the
deferred, narrowly-scoped T4b for the head-refetch case. Adding an unused
callback now would be dead abstraction.

Validation:
- pnpm --dir desktop typecheck: clean
- biome check on both changed files: clean
- rowHeightEstimate.test.mjs 16/16, useAnchoredScroll.test.mjs 2/2
- perf: upscroll-jitter GREEN 0.00/0.00 (R 55), anchor-contract PASS

Co-authored-by: Tyler Longwell <tlongwell@block.xyz>
Signed-off-by: Tyler Longwell <tlongwell@block.xyz>
2026-07-08 15:01:06 -04:00

52 lines
2.3 KiB
TypeScript

import { expect, test } from "@playwright/test";
import { installMockBridge } from "../helpers/bridge";
/**
* ANCHOR-CONTRACT GUARD (Wren #4) — companion to `upscroll-jitter.perf.ts`.
*
* The jitter gate *forces* `overflow-anchor: none` on the scroller before it
* measures, to reproduce shipped WKWebView (which has no `overflow-anchor` and
* so corrects nothing) on anchoring Chromium. That force is a test convenience,
* not a proof: it would stay green even if production ever stopped shipping the
* property, silently handing correction back to Chromium's native anchoring and
* masking a WKWebView-only regression on device.
*
* This test closes that gap by reading the PRODUCTION computed style — no test
* override — on the real conversation scroller and asserting it resolves to
* `none`. We run on Chromium, whose default `overflow-anchor` is `auto`, so a
* resolved value of `none` can only have come from the shipped stylesheet
* (`utilities.css` `[data-buzz-conversation-scroll]`). The engine-support
* assert keeps the check honest: if it ever runs somewhere without the property
* at all, we want the loud failure, not a vacuous pass on an empty string.
*/
test("CONTRACT: production ships overflow-anchor:none on the conversation scroller", async ({
page,
}) => {
await installMockBridge(page);
await page.goto("/");
await page.waitForFunction(
() => typeof window.__BUZZ_E2E_EMIT_MOCK_MESSAGE__ === "function",
);
await page.getByTestId("channel-jitter-corpus").click();
await expect(page.getByTestId("chat-title")).toHaveText("jitter-corpus");
const timeline = page.getByTestId("message-timeline");
await expect(timeline.locator("[data-message-id]").first()).toBeVisible();
// Sanity: Chromium DOES support overflow-anchor (default `auto`), so a
// resolved `none` below is the production stylesheet's doing, not the engine
// returning an empty/unsupported value.
const anchorSupported = await page.evaluate(() =>
typeof CSS !== "undefined" && typeof CSS.supports === "function"
? CSS.supports("overflow-anchor", "auto")
: false,
);
expect(anchorSupported).toBe(true);
const resolvedOverflowAnchor = await timeline.evaluate(
(element) => getComputedStyle(element).overflowAnchor,
);
expect(resolvedOverflowAnchor).toBe("none");
});