@aiquants/virtualscroll 2.3.0 → 2.5.0

package/CHANGELOG.md

@@ -2,6 +2,168 @@
 
 All notable changes to `@aiquants/virtualscroll` are documented here.
 
+## 2.5.0 (2026-08-20)
+
+**ペイン外入力の橋渡し。** ホイールリスナーは `.aqvs-scroll-pane` にしか付かないため、消費側がペインの
+外に置いた要素 (列ヘッダー帯・固定フッター・横スクロールバー行など) はホイールの死角になっていました。
+明細表では列ヘッダーを仮想スクロールの外に固定するのが定石なので、この死角は必ず生じます。
+
+### Added
+
+- **`VirtualScrollHandle.scrollBy(delta)`** — ペイン自身のホイールと**同一の意味**でデルタ分スクロールする。
+  float のまま相対加算し、スクロールアンカーを張らない (手動スクロール扱いなので既存の保留アンカーは
+  むしろ解除される)。適用後の**論理**位置を返す。
+- **`VirtualScrollHandle.applyWheel(event)` / `ScrollPaneHandle.applyWheel(event)`** — ペイン自身の規則で
+  1 つのホイールを適用し、消費したかを返す。**ホイールの適用規則 (軸分解・ズーム素通し・横成分の委譲先・
+  スクロール可否・慣性停止・速度倍率) はこの 1 つの関数に閉じており**、ペイン根のリスナーもこれを通る。
+- **`useWheelBridge(target, options?)` / `WheelBridgeTarget`** — ペイン外の要素へペインと同じホイール
+  意味論を与える公開フック。返す ref を対象要素へ渡すだけでよい。**ホイールの意味論に影響する設定は
+  受け取らない** (すべて `applyWheel` の向こう側にあるため、ペイン内と帯の上で挙動が食い違うことが
+  表現できない)。オプションは橋渡しの ON/OFF (`WheelBridgeOptions.enableBridge`、既定 `true`) のみ。引数は
+  `{ applyWheel }` を要求する構造的な型なので、`VirtualScroll` / `ScrollPane` のどちらのハンドルでも使える。
+  React 19 の `onWheel` は passive で `preventDefault()` が効かないため、フックが `{ passive: false }` で登録する。
+  自前 ref との合成に対して冪等 (**要素ごと**の台帳を持ち、既に張ってある要素へは張り直さない)。
+  台帳を単一スロットにすると、ある要素の ref が呼び直されただけで別の要素のリスナーが剥がれ、
+  ヘッダー帯とフッター帯で同じフックを使ったときに生きている帯が入れ替わる。
+- **`horizontalKeyInputs`** (`readonly ("arrow" | "shift-arrow")[]`、既定 `[]`) と **`horizontalKeyStep`**
+  (既定 40px) — 行にフォーカスがあるとき `←/→` や `Shift + ←/→` を `onWheelHorizontal` へ横スクロール量
+  として流す。段階的な文字列ではなく**種別の配列**なのは、「素の矢印だけ横スクロール、`Shift + ←/→` は
+  消費側の範囲選択に残す」という実在の要求が段階的な union では表現できないため (`behaviorOptions.pointerDragInputs`
+  と同じ作法)。既定が空なのは、行キーハンドラが capture フェーズに付くため、既定で `←/→` を消費すると
+  ツリーの展開/折りたたみ等を奪ってしまうから。消費するのは `preventDefault()` のみで
+  **伝播は止めない** (縦の矢印キーと同じ契約。`stopPropagation()` は `document` / `window` の bubble
+  リスナーごとイベントを消し、ホットキーライブラリ (`document.addEventListener("keydown", …)` 形式) や
+  キー入力のテレメトリ、消費側が一覧を囲む要素へ張った bubble ハンドラまで巻き添えにする)。
+  **行そのものにフォーカスがあるときだけ**働く (行の中の自作スライダー相当などから矢印を奪わない)。
+  テキスト選択中の `Shift + ←/→` は選択範囲の伸縮として消費側に残す (判定は `Range.intersectsNode` で
+  行い、`Ctrl+A` のような行を跨ぐ選択も検出する)。`enableKeyboardNavigation: false` との併用は
+  機能が丸ごと無効になるため `Logger.warn` で警告する。`horizontalKeyStep` は**有限かつ正**のみを受け付け、不正値は
+  `Logger.warn` のうえキーを消費しない (既定への暗黙の読み替えをしない)。
+- ❗ `onWheelHorizontal` は**キーボード由来の横量も**受け取るようになった。名前は 2.x で公開済みのため
+  据え置き、docstring と仕様書で意味を「横軸が N px 動いた」と明記した。
+
+### Fixed
+
+- **`scrollTo` で連続入力を橋渡しすると 2 つの非対称が出る問題を、専用 API の追加と文書化で解消** —
+  `scrollTo` は行解決のため絶対位置を `Math.floor` するので 1px 未満のデルタが毎回消え (精密トラックパッドで
+  一切動かない)、`scrollToIndex` 経由でアンカーを張るので以後のサイズ変化のたびに一覧が過去の位置へ
+  戻っていた。アンカーを張ること自体はジャンプ API として正しい仕様なので、`scrollTo` の挙動は変えず
+  デルタ用の `scrollBy` を追加し、docstring と仕様書に使い分けと `-1` 番兵の落とし穴を明記した。
+- **README の `tabIndex={-1}` の説明が誤っていた点を訂正** — `tabindex="-1"` はタブ順に**入れません**。
+  実際の問題は「フォーカス可能になり VirtualScroll が実 DOM フォーカスを行へ移すこと」です。
+
+### Changed
+
+- `ScrollPane` のホイール処理を `applyWheel` として切り出し、命令ハンドルへ公開した。挙動は 1 点だけ
+  意図的に変わる: 「縦成分が無い」の判定を生の `deltaY` ではなく **px 換算後**の値で行う。
+  `deltaMode: DOM_DELTA_PAGE` かつ帯が 0 のとき (自己計測の初回コミット等) 換算後は 0 になり、
+  従来は `preventDefault()` だけして 1px も動かず**祖先のスクロールも奪って**いた。適用できる量が
+  無いイベントは消費しない、に揃えた。それ以外は不変 (既存の wheel 系テスト全件で回帰なしを確認)。
+- 内部の軸分解 `resolveWheelAxes` は **ctrl 押下でもデルタを 0 に潰さなくなった** (事実だけを返す解決器へ)。
+  「ズームは横取りしない」という判断は適用側が持つ。従来は解決器が 0 を詰めていたため適用側の ctrl 判定が
+  到達不能な飾りになっており、「ctrl+shift+ホイールを横スクロールとして食う」退行を検出できなかった。
+- コールバック参照の同期を `useEffect` から `useLayoutEffect` へ変更 (差し替え直後の入力が 1 フレーム古い
+  コールバックを読む窓を閉じる)。
+
+- **`ScrollPane.applyWheel` は方針値を ref から読む** — lexical に閉じ込めると、消費側が保持したハンドルが
+  その時点の方針を凍結する (実測: 一覧が絞り込みでスクロール不能になった後も、保持済みハンドルは
+  `preventDefault` し続けてページのスクロールを殺す)。`VirtualScrollHandle.applyWheel` は毎回 ref を辿るため
+  元から凍結せず、両者の非対称を解消した。
+
+- **ペインの入れ子でホイールが 2 回適用される問題を修正** — 内側のペインが消費したホイールが
+  バブリングで外側のペインにも届き、1 ノッチで内外の一覧が両方動いていた (実測: どちらも 100px)。
+  `applyWheel` の内側に「**本パッケージが**消費した」印 (`WeakSet<WheelEvent>`) を持たせ、
+  呼び出し元がどれでも二重適用を弾くようにした。❗ `event.defaultPrevented` では代用できない
+  (「誰かが止めた」と区別が付かず、ページ全体のスクロールロック中に一覧がまったく
+  スクロールできなくなる)。
+- **行の中の要素にフォーカスがあるとき矢印キーを奪わないようにした** (縦横・PageUp/PageDown すべて)。
+  従来は `role` で実装したスライダー相当などが keydown を**どちらのフェーズでも受け取れず**、
+  さらに縦矢印ではフォーカスが隣の行へ飛んでいた。❗ **これは縦キー操作の挙動変更である。**
+  行の中の要素にフォーカスがある状態での `↑↓` / `PageUp` / `PageDown` は、行の走査ではなく
+  その要素へ届くようになった。
+- **`useWheelBridge` の対象を差し替えても古い一覧を掴み続けないようにした** — ref コールバックの
+  identity を固定し、対象ハンドルを ref 越しに読む。クリーンアップを捨てる合成 ref では台帳が
+  「既に張ってある」と判断して張り直さないため、差し替え後の一覧が永久に動かなかった。
+- **警告の網羅と抑制** — `horizontalKeyInputs` を指定しつつ `onWheelHorizontal` が無い組み合わせも
+  警告するようにした (`@aiquants/directory-tree` のように `onWheelHorizontal` を `Omit` で封じる
+  ラッパーで踏みやすい)。`horizontalKeyStep` の検証警告は keydown 毎ではなく prop 変化時に出す
+  (キーリピート中にコンソールが溢れるため)。
+
+### Notes
+
+- `resolveWheelAxes` / `ResolvedWheelAxes` は**公開していません** (内部実装)。公開すると `16px` 行高・
+  同値の扱い・4 フィールドの形が恒久的に凍結されます。消費側が必要とするのは「ペインと同じ意味論で
+  ホイールを流し込むこと」であり、それは `useWheelBridge` が満たします。
+- 行は依然としてタブ順に入りません (`tabIndex={-1}`)。キーボードのみで横スクロールへ到達させたい消費側は
+  `handle.focusItemAtIndex(0)` などでフォーカスの入口を用意してください (ロービングタブインデックスの
+  導入は全消費側のタブ順を変えるため見送り)。デモ (`/horizontal`) にその実演ボタンを追加しました。
+- 既知の限界 (いずれも仕様書 §11.4 に記載): 行内でドラッグ選択/ダブルクリックすると選択が残り、それを
+  畳むキーボード手段が無いため `Shift + ←/→` が効かないままになる / Shadow DOM 内の選択は検出できない /
+  横スクロールは支援技術へ何も伝わらない / 縦スクロールでフォーカス行が仮想化で消えるとフォーカスが
+  `<body>` へ落ちる / 位置を量子化する消費側では `horizontalKeyStep` が量子未満だと 1px も動かない /
+  連続スクロール速度は OS のキーリピート設定に依存する (環境で最大 2.8 倍程度の差)。
+- **橋渡しはペインの外の要素にだけ張ってください。** 内側の要素はペイン自身のリスナーが既に拾っています
+  (二重適用は消費印が弾きますが、意味のない登録です)。
+- **既知の限界 (未修正・既存)**: 中断されたトランジション。`sizeRef` / `wheelPolicyRef` は render 本体で
+  代入するため、`startTransition` 内の絞り込みが Suspense で中断されると**コミットされなかった**
+  `contentSize` が残り、保留中は「スクロール可能な一覧なのにホイールが効かない」状態になります。
+  両 ref を layout effect へ移すのが筋ですが、それだけではタップスクロールの走破が 1 コミット遅れて
+  短くなる退行が実機 E2E で出ることを確認したため、本リリースでは見送りました (恒久対応には
+  クランプ経路の見直しが必要)。❗ 2 つの ref は**必ず同じタイミングで代入すること** — 片方だけを
+  layout effect にすると「消費はするがクランプは古い寸法」で一覧が先頭へ飛びます。
+- **既知の限界 (未修正)**: ペインは端に達してもホイールを消費するため、ページへスクロールが連鎖しません
+  (いわゆるスクロールトラップ)。ネイティブのスクロール領域と異なる挙動で、修正には端判定の追加が必要です。
+  本リリースの範囲外としました。
+- 行の中の要素へフォーカスが入ると、キーボードだけで行へ戻る手段がありません (行はタブ順に入らないため)。
+  消費側で `Escape` などの復帰口を用意してください。
+- `Omit<VirtualScrollProps, "onWheelHorizontal">` で横軸を封じているラッパーは、`horizontalKeyInputs` と
+  `horizontalKeyStep` も同じ `Omit` に加えてください。この 2 つがトップレベルにあるのは、1 箇所の `Omit` で
+  横軸のシーム全体を封じられるようにするためです。
+
+## 2.4.0 (2026-08-19)
+
+**帯の自己計測 (`viewportSize` の optional 化)。** 自分の高さを自分で測れるコンポーネントが消費側に
+自分の高さを渡させていた責務の逆転を解消します。既存消費者は `viewportSize` を渡し続ければ**現行どおり**
+動作します (非破壊)。
+
+### Added
+
+- **`viewportSize` を省略できるようになりました** (`VirtualScroll` / `ScrollPane`)。省略時はペインが
+  `.aqvs-scroll-pane-content` の実高さを `ResizeObserver` で追跡し、クリップ窓・最大スクロール位置・
+  つまみ写像・描画枚数・スクロール可否のすべてがそれに追従します。
+
+  ```tsx
+  // ホストが高さを所有し、VirtualScroll がそれを埋める
+  <div className="min-h-0 flex-1">
+      <VirtualScroll itemCount={n} getItem={getItem} getItemHeight={getItemHeight}>{renderRow}</VirtualScroll>
+  </div>
+  ```
+
+  ホスト側がルート要素の高さを確定させること (`h-full` / `flex-1` + `min-h-0` / 明示 px /
+  `position: absolute` など) が前提です。高さが auto のホストでは帯が 0 のままになるため警告します。
+  `viewportSize` を明示する正当なケースは「帯を計測ではなく**算出**で知っている」場合のみです
+  (例: ドロップダウンが件数 × 行高から高さを決める)。
+- **`ScrollPane` に `onViewportSizeChange` を追加。** 自己計測した帯の高さを所有者へ通知します
+  (`viewportSize` 指定時は呼ばれません)。`VirtualScroll` は描画枚数とアライン計算にこの値を使います。
+
+### Fixed
+
+- **`viewportSize` と実際の帯が食い違ったときに何も検知できなかった問題** — 食い違いは例外も視覚的な
+  破綻も出さずに 5 つの導出値を壊します (はみ出し / 死に帯 / 末尾へ永久に到達できない /
+  つまみが視野外へ消える / ホイールとドラッグの無効化)。`Logger.warn` で 2 種類を通知するようにしました:
+  明示値がルートの実帯と 1px を超えてずれている場合と、自己計測でレイアウト済みなのに帯が 0 の場合です
+  (非表示 = `offsetParent === null` は正常な未計測状態として黙ります)。同じ内容は繰り返し警告しません。
+
+### Changed
+
+- **DOM 契約 (追加のみ)**: 自己計測モードのとき `.aqvs-scroll-pane` に `data-self-measured="true"` が付き、
+  コンテンツ要素のインライン `height` は**書かれなくなります** (CSS の `height: 100%` がレイアウトを所有)。
+  `viewportSize` を渡している既存消費者の DOM は不変です。
+- **CSS (追加のみ)**: `.aqvs-scroll-pane[data-self-measured="true"] { height: 100% }` を追加しました。
+  ルート要素は元々高さを持たず、明示モードではコンテンツのインライン高さに押し広げられて決まっていた
+  ため、高さを書かない自己計測モードではこの規則が無いと帯が 0 に潰れます (実ブラウザで実測)。
+  明示モードには適用しないため、既存消費者のルート要素の箱は変わりません。
+
 ## 2.3.0 (2026-08-19)
 
 DOM 契約が変わるため minor: `.aqvs-scroll-to-edge-overlay` は非表示中に `inert` を、

package/README.md

@@ -82,7 +82,6 @@ function App() {
         itemCount={items.length}
         getItem={getItem}
         getItemHeight={getItemHeight}
-        viewportSize={400}
         overscanCount={5}
       >
         {(item, index) => (
@@ -105,6 +104,31 @@ function App() {
 }
 ```
 
+## Sizing
+
+`viewportSize` is **optional and best omitted**. When it is absent the component measures its own band
+(the content element, via `ResizeObserver`) and every derived value follows automatically.
+
+```tsx
+// The host owns the height; VirtualScroll fills it.
+<div className="min-h-0 flex-1">
+    <VirtualScroll itemCount={n} getItem={getItem} getItemHeight={getItemHeight}>{renderRow}</VirtualScroll>
+</div>
+```
+
+**The host must establish a definite height** (`h-full`, `flex-1` + `min-h-0`, an explicit px height,
+`position: absolute`, …). With an auto-height host the band stays 0 and the package logs a warning —
+there is nothing to measure. In self-measured mode the root carries `data-self-measured="true"` and the
+packaged rule `.aqvs-scroll-pane[data-self-measured="true"] { height: 100% }` stretches it to the host,
+so the stylesheet import is required for this mode as well.
+
+**Pass `viewportSize` only when the band is known by calculation, not measurement** — a dropdown whose
+height comes from row count × row height, for example. If you pass a value that disagrees with the real
+band by more than 1px, the package warns: the clip window, the max scroll position, the thumb mapping,
+the rendered row count and scrollability all derive from it, so all five would be silently wrong (rows
+spilling over the next element, a dead band at the bottom, an end you can never reach, a thumb that
+leaves the viewport, or a list that ignores the wheel entirely).
+
 ## Horizontal Scrolling
 
 `VirtualScroll` virtualizes and scrolls the **vertical** axis only. To add a horizontal axis — e.g. a
@@ -133,7 +157,7 @@ function Grid() {
   return (
     <div style={{ ['--hx' as string]: `${hscroll}px`, display: 'flex', flexDirection: 'column' }}>
       <div style={{ height: 440 }}>
-        <VirtualScroll itemCount={rows.length} getItem={getItem} getItemHeight={getItemHeight} viewportSize={440} onWheelHorizontal={onWheelHorizontal}>
+        <VirtualScroll itemCount={rows.length} getItem={getItem} getItemHeight={getItemHeight} onWheelHorizontal={onWheelHorizontal}>
           {(row) => (
             <div style={{ display: 'flex' }}>
               <div style={{ width: 180, flexShrink: 0 }}>{row.label}{/* frozen column */}</div>
@@ -159,6 +183,123 @@ function Grid() {
 A runnable version lives in the demo at **`/horizontal`** (`pnpm demo:dev`), and
 [`@aiquants/directory-tree`](../directory-tree)'s TreeGrid mode uses this exact pattern in production.
 
+## Bridging input from outside the pane
+
+The wheel listener lives on `.aqvs-scroll-pane` only, so anything you render **outside** it — a frozen
+column header, a sticky footer, the horizontal scrollbar row, an empty-state panel — is a wheel dead
+zone. Data tables pin the header outside the virtual list by convention, so this gap is the norm, not
+an edge case.
+
+Use `useWheelBridge`: it gives that element the pane's own wheel semantics.
+
+```tsx
+import { useRef } from 'react'
+import { useWheelBridge, VirtualScroll, type VirtualScrollHandle } from '@aiquants/virtualscroll'
+
+const listRef = useRef<VirtualScrollHandle>(null)
+const headerRef = useWheelBridge(listRef)
+
+<div ref={headerRef}>frozen header — outside the pane</div>
+<VirtualScroll ref={listRef} onWheelHorizontal={setScrollX} ...>{renderRow}</VirtualScroll>
+```
+
+**The hook takes no configuration that affects wheel semantics, and that is the point.** Wheel speed, the horizontal sink, whether
+the list can scroll, inertia and axis resolution all live behind the handle, in one function
+(`applyWheel`) that the pane's own listener goes through too. Give the bridge its own settings and the
+same grid ends up scrolling at one speed over the rows and another over the header — we measured exactly that
+— 30px vs 10px for one wheel tick at `wheelSpeedMultiplier: 3` — in a work-in-progress build that did give
+the bridge its own settings. With a single home for the rules, that
+mismatch is not expressible. The hook's job is `{ passive: false }` registration, teardown, and the
+`enableBridge` on/off switch — nothing else. Deciding whether an event was already applied belongs to
+`applyWheel`, which tracks the events **this package** consumed (see below).
+
+Its one option is `enableBridge` (default `true`) — a plain on/off switch, not a semantic knob. Pass
+`{ enableBridge: false }` to stop bridging without unmounting the element:
+
+```tsx
+const headerRef = useWheelBridge(listRef, { enableBridge: !isEditing })
+```
+
+It works with `ScrollPane` directly too: the parameter is typed against `WheelBridgeTarget`
+(`{ applyWheel }`), which both `VirtualScrollHandle` and `ScrollPaneHandle` satisfy.
+
+Composing with your own ref is safe — the hook keeps a per-element ledger and skips re-attaching to an
+element it already holds, so the common inline merge cannot pile up listeners (without it, four
+re-renders leave five live wheel listeners on one element). Return the hook's value so React 19 can run
+its cleanup on unmount:
+
+```tsx
+<div ref={(node) => { myRef.current = node; return headerRef(node) }} />
+```
+
+Dropping that `return` still works — the ledger keeps it correct — but the listener then stays on the
+element until the element itself is garbage-collected.
+
+The ledger is keyed **per element**, so one hook can serve several bands (a header and a footer) without
+them fighting over a single slot.
+
+⚠️ **The pane does not chain scrolling to the page at its edges.** It consumes the wheel even when
+already at position 0 or at the maximum, so a user wheeling down a long page has to move the pointer off
+the list to continue. This differs from a native scroll container and is a known limitation.
+
+⚠️ **`onWheel` cannot do this.** React 19 registers `onWheel` as a passive listener, so `preventDefault()`
+is ignored and the page scrolls instead. The hook attaches a `{ passive: false }` listener itself.
+
+⚠️ **Only bridge elements OUTSIDE the pane.** Anything inside the pane is already covered by the pane's
+own listener, so bridging it is a redundant registration — the consumed-event mark keeps it from being
+applied twice, but the extra listener is pure overhead on the wheel hot path.
+
+⚠️ **Do not bridge with `scrollTo`.** It is a *jump* API: it floors the absolute position (sub-pixel
+trackpad deltas vanish entirely) and pins a scroll anchor (every later size change re-pins the list to
+that row, so filtering a list makes it jump back to where it used to be). `scrollBy` is the delta API and
+takes the pane's own path. Also never write `scrollTo(handle.getScrollPosition() + delta)` — the getter
+returns the `-1` sentinel while the pane is unconnected.
+
+### Horizontal scrolling from the keyboard
+
+With `onWheelHorizontal` wired **and `behaviorOptions.enableKeyboardNavigation` left on** (the default),
+`horizontalKeyInputs` lets a focused row emit horizontal deltas too:
+
+| Value | Keys | Use it when |
+| --- | --- | --- |
+| `[]` (default) | — | Never steal the row's own arrow handling |
+| `["shift-arrow"]` | `Shift + ←/→` | Safe alongside tree expand/collapse and grid cell navigation |
+| `["arrow"]` | `←/→` | Grids that bind `Shift + ←/→` to range selection |
+| `["arrow", "shift-arrow"]` | both | Rows that use no arrow keys at all |
+
+It is an array rather than a graduated string because `["arrow"]` — plain arrows scroll, `Shift + ←/→`
+stays with your range selection — is a real requirement that `"none" | "shift-arrows" | "arrows"`
+cannot express, since `"arrows"` subsumes `"shift-arrows"`. `behaviorOptions.pointerDragInputs` takes a
+type array for the same reason.
+
+The default is empty on purpose: the package's row key handler runs in the **capture** phase, ahead of
+your row's own handler. When it consumes a key it calls `preventDefault()` only and deliberately does
+**not** stop propagation — `stopPropagation()` would delete the event from `document` and `window`
+bubble listeners too, breaking global hotkey libraries and keydown telemetry. Check `defaultPrevented`
+in your own handler, exactly as you would for the vertical arrows.
+
+It also fires only when the row **itself** is the event target. Focus sitting on something inside the
+row — a `role="slider"` cell, a link, a nested `overflow-x:auto` region — is never hijacked, so you do
+not have to avoid `["arrow"]` just because your rows contain arrow-key widgets.
+
+`Shift + ←/→` is left alone while a non-collapsed text selection sits inside the row, so keyboard users
+can still extend a selection. `horizontalKeyStep` (default 40) must be finite and positive; anything
+else logs a warning and leaves the key untouched rather than silently substituting the default.
+
+⚠️ **This does nothing when `enableKeyboardNavigation` is `false`** — the row key handler is what reads
+these keys, and turning navigation off removes it. The package emits a `Logger.warn` when it sees that
+combination. Note the next section tells `listbox` / `tree` / `grid` authors to turn navigation off; if
+you follow both, your arrow keys are dead. Pick one.
+
+⚠️ **Rows are not in the page tab sequence** (`tabIndex={-1}`). This feature fires only while a row has
+focus, so if you want keyboard-only users to reach it, give them an entry point — for example call
+`handle.focusItemAtIndex(0)` when the list receives focus.
+
+⚠️ **Wrappers that own the horizontal axis should seal these too.** If you re-export VirtualScroll with
+`Omit<VirtualScrollProps, 'onWheelHorizontal'>`, add `horizontalKeyInputs` and `horizontalKeyStep` to
+that same `Omit`. They sit at the top level, next to `onWheelHorizontal`, precisely so one `Omit` closes
+the whole horizontal seam.
+
 ## Composite widget roles (listbox / tree / grid)
 
 Building a `listbox`, `tree` or `grid` on top of VirtualScroll? Put the role on **`contentProps`**,
@@ -171,8 +312,10 @@ not on a wrapper around `<VirtualScroll>`:
   getItemHeight={() => 36}
   viewportSize={300}
   contentProps={{ id: listboxId, role: "listbox", "aria-label": "Warehouses" }}
-  // Required: with keyboard navigation ON, every row wrapper gets tabIndex={-1}, which puts the
-  // popup in the page tab sequence AND makes the wrappers opaque to the owned-element relationship.
+  // Required: with keyboard navigation ON, every row wrapper gets tabIndex={-1}. That does not add a
+  // tab stop, but it makes the wrappers focusable — VirtualScroll then moves real DOM focus onto a row
+  // — and it makes them opaque to the owned-element relationship.
+  // ⚠️ This also disables `horizontalKeyInputs` — the row key handler goes away with it.
   behaviorOptions={{ enableKeyboardNavigation: false }}>
   {(option) => <div role="option" aria-selected={false}>{option.label}</div>}
 </VirtualScroll>
@@ -204,14 +347,16 @@ exists in the DOM.
 | `itemCount` | `number` | ✅ | Total number of items |
 | `getItem` | `(index: number) => T` | ✅ | Function to get item at index |
 | `getItemHeight` | `(index: number) => number` | ✅ | Function to get item height |
-| `viewportSize` | `number` | ✅ | Height of the visible area |
+| `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) |
 | `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 |
-| `onWheelHorizontal` | `(deltaX: number) => void` | ❌ | Opt-in horizontal wheel delegation. When set, horizontal-dominant wheel / trackpad gestures (and shift+wheel) are delegated to this handler so the parent can implement horizontal scrolling. When omitted, horizontal gestures and shift+wheel bypass vertical scrolling so parent native scrolling works. See [Horizontal Scrolling](#horizontal-scrolling). |
+| `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). |
+| `horizontalKeyInputs` | `readonly ("arrow" \| "shift-arrow")[]` | ❌ | Keyboard gestures that emit a horizontal delta through `onWheelHorizontal` (default: `[]`, so row-level arrow handling is never stolen). 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) |
+| `horizontalKeyStep` | `number` | ❌ | Pixels per horizontal arrow press (default: 40). Must be finite and positive; anything else warns and leaves the key untouched |
 | `background` | `ReactNode` | ❌ | Background element |
 | `initialScrollIndex` | `number` | ❌ | Initial scroll index |
 | `initialScrollOffset` | `number` | ❌ | Initial scroll offset (**logical** px). Not suitable for restoring positions of variable-height lists across remounts — use `initialScrollAnchor` |
@@ -241,7 +386,7 @@ exists in the DOM.
 | --- | --- | --- |
 | `enablePointerDrag` | `boolean` | Enable dragging the content area to scroll (default: true). ⚠️ Setting this to `false` removes the only way to scroll on touch devices — the pane is transform-based and has no native scroller. Use `pointerDragInputs` to exclude a single pointer type instead. |
 | `pointerDragInputs` | `readonly ("mouse" \| "pen" \| "touch")[]` | Pointer types allowed to drag-scroll the content area (default: all three). `touch-action: none` is applied only when `"touch"` or `"pen"` is included. |
-| `enableKeyboardNavigation` | `boolean` | Enable keyboard navigation (default: true) |
+| `enableKeyboardNavigation` | `boolean` | Enable keyboard navigation (default: true). Arrow / Page keys move row focus. ⚠️ They fire **only when the row wrapper itself is the event target** — focus inside a row (a `role="slider"` cell, a link, a nested scroll region) keeps its own keys |
 | `wheelSpeedMultiplier` | `number` | Multiplier for mouse wheel scrolling speed (default: 1) |
 | `inertiaOptions` | `ScrollPaneInertiaOptions` | Physics tuning for drag inertia |
 | `clipItemHeight` | `boolean` | Whether to clip item height (default: false) |
@@ -251,11 +396,13 @@ exists in the DOM.
 
 | Method | Type | Description |
 | --- | --- | --- |
-| `scrollTo` | `(position: number \| ((prev: number) => number)) => number` | Scroll to a **logical** position (updater receives the current logical position). Returns the applied **logical** position (2.0.0) |
+| `scrollTo` | `(position: number \| ((prev: number) => number)) => number` | **Jump** to a **logical** position (updater receives the current logical position). Returns the applied **logical** position (2.0.0). ⚠️ Not for bridging continuous input — see [Bridging input from outside the pane](#bridging-input-from-outside-the-pane) |
+| `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` |
 | `scrollToIndex` | `(index: number, options?: { align?: "top" \| "bottom" \| "center"; offset?: number }) => void` | Scroll to specific item index with optional alignment and offset |
 | `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) |
-| `getViewportSize` | `() => number` | Get viewport size |
+| `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 |
 | `focusItemAtIndex` | `(index: number, options?: { ensureVisible?: boolean }) => void` | Focus item at specific index |
 | `getRange` | `() => VirtualScrollRange` | Get current range information (updated one render behind) |
 | `getScrollAnchor` | `() => { index: number; offsetPx: number } \| null` | Capture the current top visible row anchor for exact restore via `initialScrollAnchor` (`null` when `itemCount` is 0) |
@@ -366,7 +513,6 @@ function AdvancedExample() {
         itemCount={items.length}
         getItem={getItem}
         getItemHeight={getItemHeight}
-        viewportSize={400}
         onRangeChange={handleRangeChange}
         scrollBarOptions={{
           renderThumbOverlay: renderThumbOverlay
@@ -476,7 +622,6 @@ export function UltraFastExample() {
       itemCount={items.length}
       getItem={(index) => items[index]}
       getItemHeight={() => 42}
-      viewportSize={480}
       scrollBarOptions={{
         tapScrollCircleOptions: {
           maxSpeedMultiplier: 80, // Optional: override adaptive speed when needed

package/dist/ScrollPane.d.cts

@@ -19,8 +19,32 @@ export type ScrollPaneProps = {
     children: (scrollPosition: number) => React.ReactNode;
     /** The total size of the content. / コンテンツの総サイズ。 */
     contentSize: number;
-    /** The size of the visible area. / 表示領域のサイズ。 */
-    viewportSize: number;
+    /**
+     * Size of the visible band (px). Omit it to let the pane measure its own band.
+     * 可視帯の高さ (px)。省略するとペインが自分の帯を計測する。
+     *
+     * ❗ **省略が既定の使い方である。** この値は帯のクリップ窓・最大スクロール位置・つまみ写像・
+     * 描画枚数・スクロール可否のすべての基準であり、実際の帯と食い違うと 5 通りの壊れ方が
+     * **例外も警告も出さずに**発生する (はみ出し / 死に帯 / 末尾へ到達不能 / つまみが視野外へ /
+     * ホイールとドラッグの無効化)。自分で測れるものを消費側に渡させると、同じ正解を各画面で
+     * 書き直すことになり、実際に推測値や定数が代入される。
+     *
+     * 省略時は `.aqvs-scroll-pane-content` の実高さ (CSS の `height: 100%` が決める) を
+     * `ResizeObserver` で追跡する。**ホスト側がルート要素の高さを確定させること**が前提で
+     * (`h-full` / `flex-1` + `min-h-0` / 明示 px / `position: absolute` など)、高さが auto の
+     * ホストでは帯が 0 のままになる (開発ビルドで警告する)。
+     *
+     * 明示する正当なケースは「帯の高さを計測ではなく算出で知っている」場合のみである
+     * (例: ドロップダウンが件数 × 行高から高さを決める)。
+     */
+    viewportSize?: number;
+    /**
+     * Notified when the self-measured viewport size changes (not called while `viewportSize` is given).
+     * 自己計測したビューポート高さが変化したときに通知する (`viewportSize` 指定時は呼ばれない)。
+     *
+     * 帯の数値を必要とする親 (`VirtualScroll` は描画枚数とアライン計算に使う) がこの口で受け取る。
+     */
+    onViewportSizeChange?: (viewportSize: number) => void;
     /** The width of the scrollbar. / スクロールバーの幅。 */
     scrollBarWidth?: number;
     /** Whether grabbing the scrollbar thumb is allowed. / スクロールバーのつまみ操作を許可するかどうか。 */
@@ -128,6 +152,16 @@ export type ScrollPaneHandle = {
     getScrollPosition: () => number;
     getContentSize: () => number;
     getViewportSize: () => number;
+    /**
+     * Applies one wheel event with the pane's own rules; returns whether it was consumed.
+     * ペイン自身の規則で 1 つのホイールイベントを適用し、消費したかどうかを返す。
+     *
+     * ペインの**外**に置いた要素 (列ヘッダー帯など) のホイールを、ペイン内と寸分違わぬ意味論で
+     * 流し込むための唯一の口。軸分解・速度倍率・スクロール可否・横委譲先・慣性停止のすべてが
+     * ペイン側の 1 箇所で決まるため、消費側が規則を書き直したり食い違わせたりできない。
+     * 直接使うより `useWheelBridge` (passive:false 登録と後始末込み) を推奨する。
+     */
+    applyWheel: (event: WheelEvent) => boolean;
 };
 /**
  * A component that provides a scrollable view with a custom scrollbar.

package/dist/ScrollPane.d.ts

@@ -19,8 +19,32 @@ export type ScrollPaneProps = {
     children: (scrollPosition: number) => React.ReactNode;
     /** The total size of the content. / コンテンツの総サイズ。 */
     contentSize: number;
-    /** The size of the visible area. / 表示領域のサイズ。 */
-    viewportSize: number;
+    /**
+     * Size of the visible band (px). Omit it to let the pane measure its own band.
+     * 可視帯の高さ (px)。省略するとペインが自分の帯を計測する。
+     *
+     * ❗ **省略が既定の使い方である。** この値は帯のクリップ窓・最大スクロール位置・つまみ写像・
+     * 描画枚数・スクロール可否のすべての基準であり、実際の帯と食い違うと 5 通りの壊れ方が
+     * **例外も警告も出さずに**発生する (はみ出し / 死に帯 / 末尾へ到達不能 / つまみが視野外へ /
+     * ホイールとドラッグの無効化)。自分で測れるものを消費側に渡させると、同じ正解を各画面で
+     * 書き直すことになり、実際に推測値や定数が代入される。
+     *
+     * 省略時は `.aqvs-scroll-pane-content` の実高さ (CSS の `height: 100%` が決める) を
+     * `ResizeObserver` で追跡する。**ホスト側がルート要素の高さを確定させること**が前提で
+     * (`h-full` / `flex-1` + `min-h-0` / 明示 px / `position: absolute` など)、高さが auto の
+     * ホストでは帯が 0 のままになる (開発ビルドで警告する)。
+     *
+     * 明示する正当なケースは「帯の高さを計測ではなく算出で知っている」場合のみである
+     * (例: ドロップダウンが件数 × 行高から高さを決める)。
+     */
+    viewportSize?: number;
+    /**
+     * Notified when the self-measured viewport size changes (not called while `viewportSize` is given).
+     * 自己計測したビューポート高さが変化したときに通知する (`viewportSize` 指定時は呼ばれない)。
+     *
+     * 帯の数値を必要とする親 (`VirtualScroll` は描画枚数とアライン計算に使う) がこの口で受け取る。
+     */
+    onViewportSizeChange?: (viewportSize: number) => void;
     /** The width of the scrollbar. / スクロールバーの幅。 */
     scrollBarWidth?: number;
     /** Whether grabbing the scrollbar thumb is allowed. / スクロールバーのつまみ操作を許可するかどうか。 */
@@ -128,6 +152,16 @@ export type ScrollPaneHandle = {
     getScrollPosition: () => number;
     getContentSize: () => number;
     getViewportSize: () => number;
+    /**
+     * Applies one wheel event with the pane's own rules; returns whether it was consumed.
+     * ペイン自身の規則で 1 つのホイールイベントを適用し、消費したかどうかを返す。
+     *
+     * ペインの**外**に置いた要素 (列ヘッダー帯など) のホイールを、ペイン内と寸分違わぬ意味論で
+     * 流し込むための唯一の口。軸分解・速度倍率・スクロール可否・横委譲先・慣性停止のすべてが
+     * ペイン側の 1 箇所で決まるため、消費側が規則を書き直したり食い違わせたりできない。
+     * 直接使うより `useWheelBridge` (passive:false 登録と後始末込み) を推奨する。
+     */
+    applyWheel: (event: WheelEvent) => boolean;
 };
 /**
  * A component that provides a scrollable view with a custom scrollbar.

package/dist/ScrollPane.d.ts.map

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