@aiquants/virtualscroll 3.8.1 → 3.9.0

package/CHANGELOG.md

@@ -2,6 +2,119 @@
 
 All notable changes to `@aiquants/virtualscroll` are documented here.
 
+## 3.9.0 (2026-10-04)
+
+### Added
+
+- **自分で動かした位置を同期で知らせる `onScrollAdjust`**: `VirtualScroll` が入力なしにスクロール位置を自分で動かすたびに、
+  間引かず同期で、動かし終えてから呼ぶ。理由 (`cause`) は 4 つ: `"item-resize"` (`updateItemSize` が先頭の可視行より上の
+  行の高さを変え、位置を同じ差だけ動かした。`updateItemSize` から戻る前)、`"reconciliation"` (描画が、描いた行のうち先頭の
+  可視行より上の行に `getItemHeight` の新しい高さを見つけ、その描画の後のマイクロタスクが位置を同じ差だけ動かした)、
+  `"drift"` (寸法の変化の後、最後の `scrollToIndex` または `initialScrollAnchor` の保留中の揃えを、確定の後の effect で
+  留め直した)、`"re-issue"` (前の中身の寸法でクランプされた補正を、新しい寸法の確定の後の effect でもう一度発行した)。
+  引数は `{ position, delta, cause }` (`VirtualScrollAdjustment`。論理 px) で、`position` は動かした後の `getScrollPosition()`
+  の値、`delta` は適用した変化 (0 にはならない)。中で読む `getScrollPosition()` と `getScrollAnchor()` は動かした後の位置と
+  行の高さを返す。利用者やホストが始めたスクロール (ホイール・ドラッグと慣性・スクロールバー・行のキー移動・`scrollTo` /
+  `scrollBy` / `scrollToIndex` / `applyWheel`) と、`getScrollPosition()` を変えない変化では呼ばない。`onScroll` /
+  `onRangeChange` は間引いたうえで 1 フレーム遅れるため、項目の同一性で自前の錨を持つホストがそこでだけ錨を記録すると、
+  次の範囲の知らせより前に確定した一覧の変化が、既に動いた位置を巻き戻していた (補正の分ずれる、または隣の項目に着地する)。
+  そうしたホストはここでも錨を記録する (README「Position changes the list makes on its own」)。型
+  `VirtualScrollAdjustment` / `VirtualScrollAdjustmentCause` をバレルから公開する。`VirtualGrid` は公開しない (位置が 2 軸で、
+  自分で動かすのは縦だけのため)。
+- **スタイルの口の表と空状態のクラス**: README の節を「Custom styling」へ改め、スタイルの口 (描かれる部品と組の
+  `aqvs-*` クラス) を表にした。空状態の `.aqvs-no-items-container` (表示域の上端の箱) と `.aqvs-no-items-text`
+  (`labels.noItems` の文言。既定の文字色 `#6b7280` は明るい背景でしか 4.5:1 に届かない) を加えた。表のクラスの改名・削除は
+  破壊的変更として扱う。
+- **テスト**: `VirtualScroll.spec.ts` +15 (下記 Fixed の揃える関数の 2 件と守る端の選び方の 3 件、端数のビューポートで
+  揃えた端を越えないことのコンポーネントの 4 件、`onScrollAdjust` の 6 件 — 4 つの理由をそれぞれ実物で起こし 1 回ずつ適用した
+  差で知らせ、中で読むハンドルが動かした後の位置と錨を返すこと、利用者とホストのスクロール (`scrollBy`・`scrollTo`・
+  `scrollToIndex`・ホイール・スクロールバーの矢印・行の PageDown・ポインタのドラッグとその慣性・つまみのドラッグ・トラックの
+  押下) では知らせないこと)、`renderedClassContract.spec.tsx` +3 (README の表のクラスがこの契約が部品を引く表とちょうど一致し
+  空状態の 2 つを含むこと、どのクラスも名指す部品 (ARIA のロール・`data-*`・文言で引いた要素) のすべてに付いて描かれること、
+  空の一覧の文言と箱)、`scrollStepRepaint.spec.tsx` +2 (下記 Fixed のつまみ)。
+
+### Fixed
+
+- **端に揃えた行の余白を装置の画素への揃えが削っていた**: 行ラッパーの平行移動は最も近い格子点へ揃えていた (`Math.round`。
+  ちょうど半分は +∞ 側)。そのためビューポートの高さが端数のとき、最大位置の最後の行や `align: "bottom"` で見せた行が、
+  表示域の終端を最大で半装置画素越えた (比 1 の 705.5px のビューポートで、終端の 8px の余白が 7.5px。ホストの視覚の検査では
+  比 1.5 で 0.3335px が切れた)。揃えは守る端を選ぶ。位置 0 と、最後の `scrollToIndex` の `align: "top"` (既定。offset の
+  有無を問わない) の着地位置では、格子点を正確な値以上に取り (`Math.ceil`)、中身を始端側へ動かさない。最大位置と、最後の
+  `align: "bottom"` の着地位置では、正確な値以下に取り (`Math.floor`)、中身を終端側へ動かさない。それ以外 (中央揃え・
+  利用者やホストのスクロール) は従来どおり最も近い格子点。覚えた揃えは、揃えた行をその場に留めるレイアウトシフトの補正と
+  ドリフト補正で一緒に動き、ほかのスクロールで忘れる。位置 0 は最大位置に勝ち、どちらも覚えた揃えに勝つ。端から 2^-10 px
+  以内は端とみなす。揃えた端を保つため、`scrollToIndex` は揃えた位置へ厳密に着地し (従来は 0.5px 以下の差ではペインを
+  動かさなかった)、ドリフト補正は 2^-10 px を超えるずれで留め直す (従来は 1px 超)。平行移動は 2D で装置の画素の整数の
+  ままなので、`perspective: none` との画素の同一性は変わらない。揃える関数は `snapToDevicePixelGrid(cssPx, ratio, edge)`
+  (`edge` は `"none"` / `"start"` / `"end"`) として新しいモジュール `devicePixelGrid.ts` へ移した (モジュールレベル。
+  バレル非公開)。
+- **層の中の行も整数の画素に描かれるという説明を正した**: 行ラッパーの docstring と README は「層の中の端数のレイアウト
+  位置は描画が画素へ揃える」としていたが、Chromium は角の丸い枠線・輪・輪郭を層の中の正確な位置で滲ませて描く (比 1.25 で、
+  描画のアンカーから 7814px の行の 1px の枠線が 75% と 50% の被覆で描かれた)。揃えるのは層の平行移動だけで、行が装置の画素
+  の整数から始まるのは、その上の行の高さの和が装置 px の整数のときだけ。README に、そのためのホストの契約 (行の高さを、
+  L × 比 が整数になる格子 L の倍数にする。比が 4 分の 1 刻みなら L = 4px) を書いた。
+- **スクロールバーのつまみを `top` で動かしていた**: つまみの器を `top` (横のバーは `left`) で動かしていたため、描画の窓を
+  変えないスクロールの 1 段ごとに、文書の根からのレイアウトが 1 回足されていた (Chromium で、描画の窓を変えない 40px の
+  60 段が、`top` で動かすと Layout 60 回・13.9ms、つまみを止めると 30 回・9.1ms)。器は `top: 0; left: 0` に置いたまま、
+  行ラッパーと同じく描くウィンドウの装置の画素の格子へ最も近い点で揃えた `translateY` (横は `translateX`) で動かし、遷移は
+  付けない。描画の窓を変えない 1 段がつまみの器へ書くのは `transform` と `aria-valuenow` だけになった。オーバーレイの props の
+  `thumbPosition` / `thumbCenter` は揃える前の厳密な値のまま。ドラッグとホバーの当たり判定は器の `top` を読まない (位置は
+  状態から、当たりは `getBoundingClientRect` から求め、平行移動を含む)。ウィンドウを持たない文書へ描くと、行ラッパーと同じく
+  つまみの取り付けで `Error` を投げる (同じ確定で両方が投げると React はまとめた `AggregateError` を投げる)。装置の画素比の
+  監視 (`(resolution: <比>dppx)` のメディアクエリ) はウィンドウごとに 1 つで、行ラッパーとつまみが共有する。
+- **テスト**: `ScrollBar.spec.tsx` (つまみの位置を平行移動から読み、`top` / `left` が 0 であることを確かめる 2 件の改修)、
+  `externalScrollBridge.spec.tsx` (`scrollTo` が 1px 未満の差を積み上げないことの対比を整数の位置から始める 1 件の改修。
+  `scrollTo` は floor した位置へ厳密に着地するので、端数の位置 0.75 から 1.0 を求めると 1 へ 1 度だけ跳ぶ)、
+  `reducedMotion.spec.tsx` (部品をパッケージ自身のクラスで引く箇所に、規則のセレクタが名指すクラスそのものが検査の対象で
+  あるという例外の注記を付け、サークルの中かどうかの判定・グリッドのサークルとその器・セルは `data-*` で引く)、E2E
+  `scrollbar-handle-speed.spec.ts` (つまみの厳密な位置はデモのつまみのオーバーレイの印から読んで等速の CV を変えずに検査し、
+  描かれたつまみがそれから半装置画素 + レイアウトの単位 1 つ以内であることを全サンプルで確かめる。つまみの `top` が常に 0 に
+  なったため、従来の `top` の読み取りでは CV が 0 になり検査が空になるところだった)。
+
+## 3.8.2 (2026-10-03)
+
+### Fixed
+
+- **動きを減らす設定で、パッケージが動かす部品をすべて止める**: `prefers-reduced-motion: reduce` では、配布 CSS の
+  ただ 1 つの規則が、パッケージが動かすすべての部品へ `transition: none !important; animation: none !important` を
+  宣言する。対象はタップスクロールサークル (バーとグリッド) とその中の全要素 (既定のビジュアル・
+  `tapScrollCircleSampleVisual`・消費側の `renderVisual`)、バーのサークルの器 (出入り)、矢印ボタン (色)、
+  スクロールバーのつまみ (ホバーとドラッグの太り。80ms と 60ms)、端へ戻るボタン (押下の縮みと地色。150ms) と
+  その覆い (出入り。500ms)。ビジュアルがインラインで書く 40〜260ms の遷移にも勝つ (カスケードは重要度をインライン
+  かどうかより先に比べる)。状態そのものは即座に切り替わる (つまみは太り、ボタンは押下で縮み、サークルは緩急なしで
+  ドラッグに追従する)。行と消費側の部品の遷移には触れない。Chromium 148 では、動きを減らす設定でこれらの部品と
+  サークルの中のインラインの遷移の `transition-duration` が 0.08〜0.5s から `0s` になり、行の中身が自分で持つ
+  0.2s の遷移はそのまま。パッケージの CSS を読み込まないホストでは遷移が残る。
+- **テスト**: `scrollStepRepaint.spec.tsx` 4 件 (新規。行ラッパーのインラインの様式が top・平行移動・
+  `will-change: transform` の 3 つだけで `perspective` を持たないこと、配布 CSS が行ラッパーと行の器に
+  perspective・3D の文脈・filter を与えず行の器が transform を持たないこと、描画の窓を変えない 1 段の DOM の
+  書き込みがラッパーの `transform` だけであること、窓を 1 行ずらす 1 段は行の器の追加と削除だけで残る行へ
+  書き込まないこと) と `reducedMotion.spec.tsx` 5 件 (新規。動きを減らす設定の規則がただ 1 つで、そのセレクタが
+  同じファイルで遷移を宣言する部品のすべてとサークルの子孫にちょうど一致すること、既定のビジュアルと
+  `tapScrollCircleSampleVisual` の全要素が規則に一致しインラインの遷移が通常の重要度であること、一覧とグリッドの
+  全要素で規則に一致することと動く部品かサークルの中にあることが同値で、行・セル・バーの器・トラック・行ラッパーは
+  一致しないこと)。
+
+### Notes
+
+- **行ラッパーは 2D の平行移動だけの合成層のまま**: 行ラッパーは 3.8.1 と同じく `will-change: transform` だけを持つ。
+  `perspective` や 3D の変換は Chromium に描画の切り取り (表示領域を 4000px 広げた範囲) を外させるが、行を非 2D の
+  変換の下で合成させ、画素比によっては層ごと再標本化させる。ラッパーに `perspective: 16777216px` を置くと、
+  Chromium 148 で比 1.25 の明色では 420×708 の一覧の 111,871〜142,452 装置画素が 8 位置すべてで変わり、2px の
+  選択の輪と 2px のフォーカスの輪の間の帯が上下の辺で混ざった (一覧の終端では 4 辺とも)。比 1 の暗色でも 8 位置の
+  うち 4 位置で最大 107 画素が変わり、比 1.5・1.75・2・3 は同一だった。`will-change: transform` だけの層では、
+  1px の枠線・2px の輪・2px の隙間・2px のフォーカスの輪を持つ選択中の面が、比 1・1.25・1.5・1.75・2・3、明色と
+  暗色、8 位置 (0〜1,572,864.5px と 2 万行の終端) のすべての辺で、枠線の色の画素、floor(2 × 比) 個の輪の画素、
+  1 個までの混ざり、floor(2 × 比) 個の隙間の画素、floor(2 × 比) 個のフォーカスの輪の画素で描かれる。
+- **窓をずらす 1 段の描き直しの費用**: 行をマウントしない 1 段 (8px) はラッパーの `transform` だけを書き、どの行も
+  描き直さない (描く層 0、PrePaint と Layerize で 0.4ms)。窓をずらす 1 段は行の器を足し引きするだけで残る行へ
+  書き込まないが、マウントで層が描き直しを要するので Chromium は描画の範囲をヒステリシス無しで今の位置へ置き直し
+  (`CullRectUpdater::ShouldProactivelyUpdate`)、中身が自分のはみ出しを切る残る行 (`kMayBeClippedByCullRect`) を
+  描き直す。Chromium 148 (1280×800・比 1・overscan 15・省略記号で終わる文の行。20 段 × 3 回の中央値) で、次の行を
+  選んで 1 行スクロールする 1 段は、高さ 160px の行で 36 層 (Paint 0.99ms、Paint・PrePaint・Layerize の和 2.6ms、
+  ラスター 3.7ms)、448px の行で 26 層 (0.66ms・1.9ms・2.6ms)。`perspective` を置いた場合は 160px の行で 6 層
+  (Paint 0.40ms) だった。
+
 ## 3.8.1 (2026-10-03)
 
 ### Fixed

package/README.md

@@ -139,29 +139,145 @@ leaves the viewport, or a list that ignores the wheel entirely).
 
 The rows move inside one wrapper that is translated with `transform: translateY(…)` on its own compositor
 layer (`will-change: transform`). That translate is snapped to the device-pixel grid of the window the list
-is painted in, `Math.round(offset × devicePixelRatio) / devicePixelRatio`: whole CSS pixels at a ratio of 1,
-steps of 0.8 px at 1.25, 2/3 px at 1.5 and 0.5 px at 2. Fractional scroll positions (trackpad and inertia
-deltas, centred alignment, fractional row heights or insets) therefore never move the layer by a fraction of
-a device pixel. A layer moved by a fraction is resampled as a whole: 2 px borders, outlines, focus rings and
-the gaps between them smear across neighbouring pixel rows, and text blurs.
+is painted in: whole CSS pixels at a ratio of 1, steps of 0.8 px at 1.25, 2/3 px at 1.5 and 0.5 px at 2.
+Fractional scroll positions (trackpad and inertia deltas, centred alignment, fractional row heights or
+insets) therefore never move the layer by a fraction of a device pixel. A layer moved by a fraction is
+resampled as a whole: 2 px borders, outlines, focus rings and the gaps between them smear across
+neighbouring pixel rows, and text blurs.
 
+The snap keeps the edge the list is aligned to, so aligned content never loses part of its gutter to the
+rounding:
+
+| Where the list rests | Grid point | Result |
+| --- | --- | --- |
+| At position 0, or where the last `scrollToIndex` with `align: "top"` (the default, with or without `offset`) landed | At or after the exact translate: `Math.ceil(offset × ratio) / ratio` | The content never moves toward the viewport start, so the first row (or the aligned row, less its `offset`) never crosses it |
+| At the maximum position, or where the last `scrollToIndex` with `align: "bottom"` landed | At or before the exact translate: `Math.floor(offset × ratio) / ratio` | The content never moves toward the viewport end, so the last row and the bottom inset (or the aligned row) never cross it |
+| Anywhere else (a centred row, a scroll the user or the host started) | The nearest one: `Math.round(offset × ratio) / ratio` | At most half a device pixel either way |
+
+- `scrollToIndex` lands exactly on the aligned position (clamped to the content), and a size change that
+  moves a pending alignment by more than 2^-10 px pins it again, so an aligned edge holds through fractional
+  row heights. A remembered alignment moves with the layout-shift compensation and the drift
+  correction that keep the aligned row in place, and any other scroll forgets it. Position 0 wins over the
+  maximum position (a list that does not scroll stays top-aligned), and both win over a remembered
+  alignment. A position within 2^-10 px of one of these counts as that position.
+- Only the wrapper translate is snapped. The rows inside it paint at their exact layout positions, where
+  rounded borders, rings and outlines are anti-aliased, so a row starts on a whole device pixel only when the
+  sum of the row heights above it is a whole number of device pixels. A host that needs crisp row edges keeps
+  every row height on a lattice L with L × ratio a whole number: L = 4 px gives whole device pixels at every
+  ratio in quarter steps (1, 1.25, 1.5, 1.75, 2, …). Other zoom levels need other lattices (10 px at 1.1);
+  at a ratio the host's lattice does not fit, the rows keep their fractional positions.
+- Every position the component reports (`onScroll`, `onRangeChange`, `onScrollAdjust`, `getScrollPosition()`,
+  `getScrollAnchor()`) stays exact. The rows are drawn less than one device pixel away from the exact scroll
+  position (at most half a device pixel where no edge is kept). `VirtualGrid` rows are drawn by the same
+  wrapper, so they are snapped vertically as well.
 - The ratio comes from the window of the list's own document, and it is read while the wrapper renders.
   Before the wrapper is attached, the component expects the window of the page that runs React, and the
   attach confirms it. A list rendered into its own window's document is therefore snapped in its first
   commit, with no extra render. A list rendered into an iframe or a second window switches to that
   window's ratio when the wrapper attaches, with one extra synchronous render before the browser paints.
   The ratio is read again whenever it changes (browser zoom, or moving the window to a screen of another
-  density), through a `(resolution: <ratio>dppx)` media query.
-- Only the wrapper translate is snapped. Row positions inside it keep their exact values (the browser paints
-  fractional positions inside a layer on whole pixels already), and every position the component reports
-  (`onScroll`, `onRangeChange`, `getScrollPosition()`, `getScrollAnchor()`) stays exact. The rows are drawn
-  at most half a device pixel away from the exact scroll position. `VirtualGrid` rows are drawn by the same
-  wrapper, so they are snapped vertically as well.
+  density), through one `(resolution: <ratio>dppx)` media query per window, shared by the wrappers and the
+  scrollbar thumbs painted there.
 - Server-rendered HTML carries the exact offset, since there is no screen on the server. Hydration renders
   the same exact offset, so it reports no mismatch, and the snapped offset replaces it right after hydration.
 - Rendering into a document without a window (for example one made with
-  `document.implementation.createHTMLDocument()`) throws when the wrapper attaches: nothing is painted there,
-  so there is no ratio to snap to.
+  `document.implementation.createHTMLDocument()`) throws when the wrapper or a scrollbar thumb attaches:
+  nothing is painted there, so there is no ratio to snap to.
+
+## What a scroll step paints
+
+The items wrapper is a plain compositor layer: `will-change: transform`, moved by a 2D translate that is
+snapped to the device-pixel grid (see above), with nothing that takes its subtree out of 2D compositing.
+Measured in Chromium 148 (1280×800, ratio 1, overscan 15, rows whose text ends in an ellipsis; 20 steps,
+3 runs, median of the run medians):
+
+- A step that mounts no row writes only the wrapper's `transform` and repaints no row. An 8 px step paints
+  0 layers; PrePaint and Layerize take 0.4 ms.
+- A step that shifts the rendering window adds and removes row containers and writes nothing to the rows it
+  keeps, yet Chromium repaints the kept rows whose content clips its own overflow (an ellipsis, a card with
+  `overflow: hidden`). A mount makes the layer need a repaint, so Chromium re-centres the area it paints the
+  layer in (the visible area grown by 4000 px) without its usual hysteresis
+  (`CullRectUpdater::ShouldProactivelyUpdate`), and every row painted with `kMayBeClippedByCullRect` is
+  repainted. Selecting the next row and scrolling one row paints 36 layers with 160 px rows (Paint 0.99 ms;
+  Paint, PrePaint and Layerize 2.6 ms; raster 3.7 ms) and 26 layers with 448 px rows (0.66 ms, 1.9 ms,
+  2.6 ms).
+- The wrapper declares no `perspective` and no 3D transform, although either would make Chromium paint the
+  subtree without that area: the rows would then be composited under a non-2D transform, which Chromium
+  resamples at some ratios. With `perspective: 16777216px` on the wrapper, at ratio 1.25 in a light theme
+  111,871 to 142,452 device pixels of a 420×708 list changed at each of 8 offsets, and the band between a
+  2 px selection ring and a 2 px focus outline blended on the top and bottom edges (on all four edges at the
+  end of the list); at ratio 1 in a dark theme up to 107 pixels changed at 4 of the 8 offsets. Ratios 1.5,
+  1.75, 2 and 3 were identical. The same step would have painted 6 layers (Paint 0.40 ms).
+- With the plain layer, a selected row whose surface has a 1 px border, a 2 px ring, a 2 px gap and a 2 px
+  outline renders on every side, at ratios 1, 1.25, 1.5, 1.75, 2 and 3, light and dark, and at 8 offsets
+  (0 to 1,572,864.5 px and the end of a 20,000-row list), as a full border pixel, floor(2 × ratio) ring
+  pixels, at most one blended pixel, floor(2 × ratio) gap pixels and floor(2 × ratio) outline pixels.
+- The scrollbar thumb moves the same way. Its wrapper stays at `top: 0` (`left: 0` on a horizontal bar) and is
+  moved by a 2D translate (`translateY`, `translateX` on a horizontal bar) snapped to the same device-pixel
+  grid, with no transition, so a step writes only that `transform` and the slider's `aria-valuenow`, and the
+  thumb adds no layout. A thumb positioned by `top` adds a layout from the document root to every step: in
+  Chromium, 60 steps of 40 px that kept the rendering window (200,000 rows of 160 px inside nested flex
+  columns beside a 600-row sidebar) ran 60 layouts in 13.9 ms with the thumb moved by `top`, and 30 layouts in
+  9.1 ms with the thumb held still. `thumbPosition` in the `renderThumbOverlay` props stays the exact,
+  unsnapped offset.
+
+## Position changes the list makes on its own
+
+`onScroll` and `onRangeChange` report every position, throttled (`callbackThrottleMs`) and one animation frame
+late. Four moves are made by the list itself, without a scroll from the user or the host, and `onScrollAdjust`
+reports each of them synchronously and unthrottled once it is complete: `getScrollPosition()` and
+`getScrollAnchor()` read inside the callback already return the moved position and the new row heights.
+
+| `cause` | The move | When it runs |
+| --- | --- | --- |
+| `"item-resize"` | `updateItemSize` changed a row above the first visible row, and the position moved by the same delta, so the visible rows stay where they were | Inside `updateItemSize`, before it returns |
+| `"reconciliation"` | A render found a new `getItemHeight` value for a rendered row above the first visible row, and the position moved by the same delta | In the microtask after that render |
+| `"drift"` | After a size change (content, viewport, item count or insets), the pending alignment of the last `scrollToIndex` (or of `initialScrollAnchor`) was pinned again | In an effect after the commit |
+| `"re-issue"` | A compensation that the pane clamped against the previous content size (several compensations in one batch near the end of the list) was issued again once the new size had committed | In an effect after the commit |
+
+The argument is `{ position, delta, cause }` (`VirtualScrollAdjustment`): `position` is the **logical**
+position after the move, what `getScrollPosition()` returns, and `delta` is the change the move applied to it
+(never 0). Scrolls the user or the host start (wheel, drags and their inertia, the scrollbar, keyboard row
+navigation, `scrollTo` / `scrollBy` / `scrollToIndex` / `applyWheel`) are not reported here, and neither is a
+change that leaves `getScrollPosition()` where it was (a top-inset change keeps the logical position).
+
+A host that keeps its own scroll anchor by item identity, re-finding the first visible item by key after a
+list change (rows inserted or removed above it), records that anchor from `onRangeChange` and after its own
+scrolls. It must also re-record it from `onScrollAdjust`. Otherwise a list change committed before the next
+range report restores a position the list has already moved, and the view shifts by the compensation or
+lands on a neighbouring item.
+
+```tsx
+const recordAnchor = () => {
+    const anchor = listRef.current?.getScrollAnchor()
+    if (anchor) anchorRef.current = { key: keyOf(anchor.index), offsetPx: anchor.offsetPx }
+}
+
+<VirtualScroll ref={listRef} onRangeChange={recordAnchor} onScrollAdjust={recordAnchor} {...props}>
+    {renderRow}
+</VirtualScroll>
+```
+
+## Reduced motion
+
+Under `prefers-reduced-motion: reduce`, every part that the package animates changes state without a
+transition or an animation. One rule in the shipped stylesheet sets
+`transition: none !important; animation: none !important` on:
+
+- the tap scroll circle (the bar's and the grid's) and every element inside it: the default visual,
+  `tapScrollCircleSampleVisual` or your own `renderVisual`. Their inline transitions lose to `!important`,
+  because the cascade compares importance before it considers the `style` attribute;
+- the bar's circle wrapper (its fade);
+- the arrow buttons (their colour fade);
+- the scrollbar thumb (its thickening on hover and while dragged, 80 ms and 60 ms);
+- the scroll-to-edge buttons (their shrink while pressed and their background fade, 150 ms) and their
+  overlay (its fade, 500 ms).
+
+The states themselves still change, at once: the thumb still thickens on hover and while dragged, an edge
+button still shrinks while pressed, and the circle follows the drag without easing. Rows and everything you
+render in them keep their own transitions. A host that does not load the package stylesheet keeps the
+transitions. In Chromium 148 the computed `transition-duration` of these parts drops from 0.08–0.5 s to
+`0s`, while a row's own 0.2 s transition stays 0.2 s.
 
 ## Horizontal Scrolling
 
@@ -668,11 +784,12 @@ exists in the DOM.
 | `getItemHeight` | `(index: number) => number` | ✅ | Function to get item height |
 | `viewportSize` | `number` | ❌ | Height of the visible band. **Omit it** — the component then measures its host with a `ResizeObserver`. Pass it only when you know the band by calculation rather than measurement (e.g. a dropdown sized from row count × row height). See [Sizing](#sizing) |
 | `overscanCount` | `number` | ❌ | Number of items to render outside viewport (default: 15) |
-| `className` | `string` | ❌ | CSS class name. Lands on the scroll root (`.aqvs-scroll-pane`) — see [Custom Scrollbar Styling](#custom-scrollbar-styling) |
+| `className` | `string` | ❌ | CSS class name. Lands on the scroll root (`.aqvs-scroll-pane`) — see [Custom styling](#custom-styling) |
 | `getItemKey` | `(index: number) => React.Key` | ❌ | Stable React key per index (defaults to the index) |
 | `testId` | `string` | ❌ | Emitted as `data-testid` on the scroll root. DOM hooks should use `data-*`, never class selectors |
 | `onScroll` | `(position: number, totalHeight: number) => void` | ❌ | Scroll event handler |
 | `onRangeChange` | `(range: VirtualScrollRange) => void` | ❌ | Range change handler |
+| `onScrollAdjust` | `(adjustment: VirtualScrollAdjustment) => void` | ❌ | Called synchronously, without throttling, each time the list moves its own scroll position (layout-shift compensation, the re-pinning of a pending alignment, the second stage of a clamped compensation). `adjustment` is `{ position, delta, cause }` in **logical** px, and handle reads inside the callback already see the adjusted state. Never called for scrolls the user or the host start. See [Position changes the list makes on its own](#position-changes-the-list-makes-on-its-own) |
 | `onWheelHorizontal` | `(deltaX: number) => void` | ❌ | Opt-in horizontal delegation. Horizontal-dominant wheel / trackpad gestures (and shift+wheel) are delegated to this handler so the parent can implement horizontal scrolling. ⚠️ **Keyboard deltas arrive here too** when `horizontalKeyInputs` is set. When omitted, horizontal gestures bypass vertical scrolling so parent native scrolling works. See [Horizontal Scrolling](#horizontal-scrolling). |
 | `onPanHorizontal` | `(deltaX: number) => void` | ❌ | Opt-in delegation of the horizontal component of pointer pans (touch / pen drags) — the pan twin of `onWheelHorizontal` with the same sign convention, per-move increments divided by the press-time x-axis ancestor scale (3.2.0). When set, purely horizontal pans also activate the drag. Same seal family as `onWheelHorizontal` — wrappers sealing the horizontal axis must `Omit` this name too. |
 | `horizontalKeyInputs` | `readonly "arrow"[]` | ❌ | Keyboard gestures that emit a horizontal delta through `onWheelHorizontal` (default: `[]`, so row-level arrow handling is never stolen). `Shift + ←/→` is never consumed. Fires only when the row itself is the event target. ⚠️ Requires `behaviorOptions.enableKeyboardNavigation` (default `true`) — with it off the rows have no key handler at all and this prop does nothing (the package warns) |
@@ -726,7 +843,7 @@ exists in the DOM.
 | `scrollBy` | `(delta: number) => number` | Scroll **by a delta** with the pane's own wheel semantics (float accumulation, no anchor). Use this — not `scrollTo` — to bridge continuous input from outside the pane. Returns the applied **logical** position |
 | `applyWheel` | `(event: WheelEvent) => boolean` | Apply one wheel event with the pane's own rules; returns whether it was consumed. The single entry point for wheel input originating outside the pane — normally reached through `useWheelBridge` |
 | *(ScrollPaneHandle only)* `scrollTo` | `(pos, dimsOverride?)` | The pane-level jump. `dimsOverride` is an explicit clamp-space for callers that know **fresher-than-committed** dims (the layout-shift compensation passes `committed + delta`). Do not pass it casually — a wrong override clamps against dims that are not on screen |
-| `scrollToIndex` | `(index: number, options?: { align?: "top" \| "bottom" \| "center"; offset?: number }) => void` | Scroll to specific item index with optional alignment and offset |
+| `scrollToIndex` | `(index: number, options?: { align?: "top" \| "bottom" \| "center"; offset?: number }) => void` | Scroll to specific item index with optional alignment and offset. Lands exactly on the aligned position (clamped to the content); a `"top"` (default) or `"bottom"` alignment is remembered there, so the device-pixel snap keeps that edge — see [Device-pixel snapping](#device-pixel-snapping) |
 | `getScrollPosition` | `() => number` | Get current **logical** scroll position (2.0.0; `-1` when the pane is not connected) |
 | `getContentSize` | `() => number` | Get total content size (insets included). Returns the `-1` sentinel while the pane is unconnected |
 | `getViewportSize` | `() => number` | Get viewport size. Returns the `-1` sentinel while the pane is unconnected |
@@ -735,7 +852,7 @@ exists in the DOM.
 | `getScrollAnchor` | `() => { index: number; offsetPx: number } \| null` | Capture the current top visible row anchor for exact restore via `initialScrollAnchor` (`null` when `itemCount` is 0) |
 | `getFenwickTreeTotalHeight` | `() => number` | Total content height managed by the Fenwick tree (insets excluded) |
 | `getFenwickSize` | `() => number` | Item count managed by the Fenwick tree |
-| `updateItemSize` | `(index: number, size: number) => void` | Manually update one item's size (with layout-shift compensation). `getItemHeight(index)` must return the same value afterwards |
+| `updateItemSize` | `(index: number, size: number) => void` | Manually update one item's size (with layout-shift compensation: a row above the first visible row moves the position by the same delta before this returns, reported through `onScrollAdjust` as `"item-resize"`). `getItemHeight(index)` must return the same value afterwards |
 
 **Coordinate system (2.0.0)**: every position the handle and callbacks accept or return is
 **logical** (content px, insets excluded) — `onScroll` / `onRangeChange` / `initialScroll*` /
@@ -852,10 +969,11 @@ function AdvancedExample() {
 }
 ```
 
-### Custom Scrollbar Styling
+### Custom styling
 
-`className` lands on the **scroll root** (`.aqvs-scroll-pane`). The bar, its track, thumb, arrow buttons
-and the scroll-to-edge pills are all descendants of that element, so one wrapper class reaches every part:
+`className` lands on the **scroll root** (`.aqvs-scroll-pane`). The rows, the bar with its track, thumb and
+arrow buttons, the scroll-to-edge pills and the empty-state message are all descendants of that element, so
+one wrapper class reaches every part:
 
 ```tsx
 <VirtualScroll
@@ -885,6 +1003,9 @@ and the scroll-to-edge pills are all descendants of that element, so one wrapper
 .custom-virtual-scroll .aqvs-scrollbar-arrow-button:enabled:hover { background-color: #cfe8f7; }
 .custom-virtual-scroll .aqvs-scroll-to-edge-button { background-color: rgba(0, 122, 204, 0.85); }
 .custom-virtual-scroll .aqvs-scroll-to-edge-button:hover { background-color: rgba(0, 92, 153, 0.9); }
+
+/* The empty state (itemCount 0). Restate the colour on a dark background: the default #6b7280 reaches 4.5:1 only on a light one. */
+.custom-virtual-scroll .aqvs-no-items-text { color: #94a3b8; padding-block: 1rem; }
 ```
 
 The packaged rules live in `@layer components` in **both** artifacts, so an ordinary (unlayered) rule in
@@ -916,11 +1037,28 @@ Three consequences are worth knowing:
   users. Forcing `opacity: 1` on the hidden overlay therefore paints a pill that cannot be clicked or focused.
   Scope such rules to `[data-visible="true"]` as well.
 
-The parts you are most likely to target: `.aqvs-scroll-pane` (root), `.aqvs-scroll-pane-content` (row
-viewport), `.aqvs-scrollbar` (+ `-vertical` / `-horizontal`), `.aqvs-scrollbar-track`,
-`.aqvs-scrollbar-thumb-wrapper`, `.aqvs-scrollbar-thumb` (+ `-vertical` / `-horizontal`),
-`.aqvs-scrollbar-arrow-button`, `.aqvs-scroll-to-edge-overlay` / `-button`, `.aqvs-tap-scroll-circle`,
-`.aqvs-item-container`.
+The styling hooks are the classes below. Each one is rendered on the part it names, and renaming or
+removing one is a breaking change:
+
+| Class | Part |
+| --- | --- |
+| `.aqvs-scroll-pane` | The scroll root, where `className` lands |
+| `.aqvs-scroll-pane-content` | The row viewport |
+| `.aqvs-item-container` | Each row's container |
+| `.aqvs-no-items-container` | The empty state (`itemCount` 0): the box at the top of the viewport |
+| `.aqvs-no-items-text` | The empty state's message (`labels.noItems`), centred, `color: #6b7280` |
+| `.aqvs-scrollbar` | The bar (`role="scrollbar"`) |
+| `.aqvs-scrollbar-vertical` | A vertical bar |
+| `.aqvs-scrollbar-horizontal` | A horizontal bar |
+| `.aqvs-scrollbar-track` | The track behind the thumb |
+| `.aqvs-scrollbar-thumb-wrapper` | The thumb's wrapper (`role="slider"`); the package positions it with an inline translate |
+| `.aqvs-scrollbar-thumb` | The thumb, with `data-thumb-state` |
+| `.aqvs-scrollbar-thumb-vertical` | The thumb of a vertical bar |
+| `.aqvs-scrollbar-thumb-horizontal` | The thumb of a horizontal bar |
+| `.aqvs-scrollbar-arrow-button` | The arrow buttons |
+| `.aqvs-scroll-to-edge-overlay` | The scroll-to-edge pills' overlay (`enableScrollToTopBottomButtons`) |
+| `.aqvs-scroll-to-edge-button` | A scroll-to-edge pill |
+| `.aqvs-tap-scroll-circle` | The tap scroll circle |
 
 ### Tap Scroll Circle Configuration
 
@@ -940,6 +1078,8 @@ The auxiliary tap scroll circle can replace the native scrollbar for large datas
 - **Per-pointer drag control**: `behaviorOptions.pointerDragInputs` restricts content drag-scrolling to specific pointer types, e.g. `["pen", "touch"]` to keep touch scrolling while freeing the mouse for text selection. Do **not** use `enablePointerDrag: false` for that — the pane has no native scroller, so disabling drag removes the only way to scroll on touch devices.
 - **Full layout control** (`size`, `offsetX`, `offsetY`) keeps the circle accessible on both desktop and touch devices.
 - **Visibility tuning** exposes an `opacity` knob so you can match subdued or high-contrast UI themes.
+- **Reduced motion**: the circle and every element inside it follow the package-wide rule in
+  [Reduced motion](#reduced-motion).
 
 ```tsx
 import { VirtualScroll } from "@aiquants/virtualscroll"

package/dist/ScrollBar.d.cts

@@ -296,9 +296,15 @@ export declare const computeTapScrollSpeed: ({ distance, maxDistance, viewportSi
  */
 export declare const computeAutoTapScrollMaxSpeedMultiplier: (itemCount?: number) => number;
 /**
- * A custom scrollbar component.
+ * A custom scrollbar component. The thumb wrapper stays at the start of the track (`top: 0; left: 0`) and moves along it
+ * by a 2D translate snapped to the device-pixel grid of the window that paints it, so a scroll step rewrites only that
+ * transform and runs no layout. `thumbPosition` in the overlay props stays the exact, unsnapped offset. Rendering into a
+ * document without a window throws when the thumb attaches (there is no device-pixel ratio to snap to).
  *
- * カスタムスクロールバーコンポーネント。
+ * カスタムスクロールバーコンポーネント。つまみの器はトラックの始端 (`top: 0; left: 0`) に置いたまま、描くウィンドウの装置の
+ * 画素の格子へ揃えた 2D の平行移動でトラックに沿って動くので、スクロールの 1 段が書き換えるのはその transform だけで、
+ * レイアウトは走らない。オーバーレイの props の `thumbPosition` は揃える前の厳密なオフセットのまま。ウィンドウを持たない
+ * 文書へ描くと、つまみの取り付けで例外を投げる (揃える装置の画素比が無い)。
  */
 export declare const ScrollBar: ({ contentSize, viewportSize, scrollPosition, onScroll, enableThumbDrag, enableTrackClick, enableArrowButtons, enableArrowButtonTabStops, horizontal, enableHorizontalTapCircle, stretchMainSize, scrollBarWidth, className, ariaControls, tapScrollCircleOptions, itemCount, renderThumbOverlay, visibleStartIndex, visibleEndIndex, locale, labels, }: ScrollBarProps) => import("react").JSX.Element;
 export {};

package/dist/ScrollBar.d.ts

@@ -296,9 +296,15 @@ export declare const computeTapScrollSpeed: ({ distance, maxDistance, viewportSi
  */
 export declare const computeAutoTapScrollMaxSpeedMultiplier: (itemCount?: number) => number;
 /**
- * A custom scrollbar component.
+ * A custom scrollbar component. The thumb wrapper stays at the start of the track (`top: 0; left: 0`) and moves along it
+ * by a 2D translate snapped to the device-pixel grid of the window that paints it, so a scroll step rewrites only that
+ * transform and runs no layout. `thumbPosition` in the overlay props stays the exact, unsnapped offset. Rendering into a
+ * document without a window throws when the thumb attaches (there is no device-pixel ratio to snap to).
  *
- * カスタムスクロールバーコンポーネント。
+ * カスタムスクロールバーコンポーネント。つまみの器はトラックの始端 (`top: 0; left: 0`) に置いたまま、描くウィンドウの装置の
+ * 画素の格子へ揃えた 2D の平行移動でトラックに沿って動くので、スクロールの 1 段が書き換えるのはその transform だけで、
+ * レイアウトは走らない。オーバーレイの props の `thumbPosition` は揃える前の厳密なオフセットのまま。ウィンドウを持たない
+ * 文書へ描くと、つまみの取り付けで例外を投げる (揃える装置の画素比が無い)。
  */
 export declare const ScrollBar: ({ contentSize, viewportSize, scrollPosition, onScroll, enableThumbDrag, enableTrackClick, enableArrowButtons, enableArrowButtonTabStops, horizontal, enableHorizontalTapCircle, stretchMainSize, scrollBarWidth, className, ariaControls, tapScrollCircleOptions, itemCount, renderThumbOverlay, visibleStartIndex, visibleEndIndex, locale, labels, }: ScrollBarProps) => import("react").JSX.Element;
 export {};

package/dist/ScrollBar.d.ts.map

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