@aiquants/virtualscroll 2.7.0 → 3.1.0

package/CHANGELOG.md

@@ -2,6 +2,60 @@
 
 All notable changes to `@aiquants/virtualscroll` are documented here.
 
+## 3.1.0 (2026-08-20)
+
+**A-5 のアクセシビリティ / 入力ユーティリティ 3 点。すべて opt-in で、未使用時の挙動・DOM 形状は
+一切変わりません。**
+
+- **Escape 行復帰** (`behaviorOptions.enableEscapeRowReturn`、既定 `false`): 行内のリンクや
+  ウィジェットにフォーカスがある状態で `Escape` を押すと行ラッパーへフォーカスを戻します
+  (行はタブ順に入らないため、既定ではキーボードで行へ戻る手段が無かった)。`Escape` は最多重負荷の
+  キーのため、**bubble フェーズ**で聞き (行内ウィジェットの `stopPropagation` / `preventDefault` が
+  常に勝つ)、IME 合成中 (`isComposing`)・**編集可能なターゲット (input / textarea / select /
+  contentEditable — ネイティブの Escape 既定動作は `defaultPrevented` に現れず検査で守れない)**・
+  行自身フォーカス時は何もしません。作用時は `preventDefault()` のみで伝播は止めません
+  (矢印キーと同じ契約)。
+- **ライブリージョン** (`liveRegion` prop): 可視範囲を支援技術へ読み上げる `role="status"`
+  (polite / atomic) の隠し要素をペインの兄弟として描画します。文言は消費側の `format` が組み立て
+  (パッケージは文字列を内蔵しない)、範囲静定後の trailing デバウンス (`debounceMs`、既定 400) で
+  1 回だけ更新します。不正な `debounceMs` は警告して無効化 (黙って既定へ読み替えない)。実行時に
+  prop を外すと残留文言もクリアします (再有効化時に古い範囲を読み上げさせない)。
+- **`createResidualQuantizer`**: 位置を行/列単位へスナップする消費側向けの残差持ち越し型デルタ
+  量子化器。高解像度トラックパッドの量子未満デルタが都度 0 に丸められて「ゆっくり撫でると動かない」
+  問題を、残差蓄積 + 量子単位の放出で解消します。方向反転で残差を破棄 (既定、幽霊スクロール防止)、
+  非有限デルタと `Number.MAX_SAFE_INTEGER` 超のデルタは蓄積を汚さず 0 (2^53 超では放出が量子の
+  正確な倍数でなくなるため)、不正な量子は生成時に throw (Fail Fast)。時間起点の破棄は意図的に
+  内蔵せず、消費側の `reset()` に委ねます。
+
+A-5 のうち**固定リピートタイマは実装を見送り**ました: 長押しの連続スクロール速度は OS のキー
+リピート設定に委ねます (運動障害等でリピートを意図的に遅くした利用者の設定とパッケージ内タイマが
+戦うため。需要が実証された場合に opt-in で再検討)。
+
+## 3.0.0 (2026-08-20)
+
+**💥 BREAKING: `horizontalKeyInputs` から `"shift-arrow"` を撤去。** `Shift + ←/→` による横キーボード
+スクロールは実装取りやめとなり、Shift 併用の矢印キーは**無条件で**ブラウザへ返ります (選択範囲の伸縮)。
+型は `readonly ("arrow" | "shift-arrow")[]` → `readonly "arrow"[]` に狭まります。
+
+**撤去の理由** — 2.x の「行内に選択があるときだけ譲る」検出 (`getSelection()` + 交差判定) には実測で
+確認された構造的欠陥が残り、どの改良案も別の正しいユーザー意図を誤判定するため、機能ごと撤去しました:
+
+- **Shadow DOM 内の選択が検出できない**: Chrome は `document.getSelection()` を retarget するため
+  保護が無言にすり抜け、選択中でも `Shift + →` が横スクロールへ奪われる (実測・chromium 148)。
+  可搬な代替 API が存在しない (`ShadowRoot.getSelection()` は非標準、`getComposedRanges()` は対応限定)。
+- **`Ctrl+A` で全面ロックアウト**: ページ全体の選択は全行と交差するため、選択を解くまで一覧全体で
+  `Shift + ←/→` が死ぬ (実測・chromium 148)。
+- **選択を畳むキーボード手段が無い**: 非編集領域の選択を Chrome は矢印キーで畳まないため、
+  一度ドラッグ選択すると `Shift + ←/→` がクリックまで復帰しない。
+
+**移行**: `["shift-arrow"]` / `["arrow", "shift-arrow"]` を渡していた場合は `["arrow"]` へ変更して
+ください。型を迂回して実行時に旧語彙の配列を渡しても**不活性** (何も消費しない) であり、旧挙動への
+フォールバックはありません。Shift 系の横入力が必要な場合は `shift + ホイール` が引き続き使えます
+(選択と衝突しません)。なお撤去は横矢印のみで、縦の `Shift + ↑/↓` によるフォーカス走査は従来どおりです
+(ファイラ型のレンジ選択が消費側で成立するための意図的な非対称)。
+素の `←/→` の挙動・`horizontalKeyStep`・発火条件 (行フォーカス前提、`preventDefault` のみで伝播は
+止めない、等) はすべて従来どおりです。あわせて内部の選択検出 (`hasTextSelectionWithin`) を削除しました。
+
 ## 2.7.0 (2026-08-20)
 
 **端でホイールがページへ連鎖する。** ネイティブのスクロール領域と同じく、その向きへ**もう動けない**

package/README.md

@@ -13,6 +13,7 @@ High-performance virtual scrolling component for React with variable item height
 - ↔️ **Horizontal Delegation**: Opt-in `onWheelHorizontal` hands horizontal wheel / trackpad (and shift+wheel) gestures to the parent — build frozen-column data grids
 - 🎨 **Customizable**: Flexible styling and theming options
 - 🌀 **Ultrafast Tap Scroll**: Adaptive tap scroll circle that scales speed up to 120× for massive datasets
+- ♿ **Accessibility opt-ins**: Escape row-return (`enableEscapeRowReturn`) and a screen-reader live region (`liveRegion`) announcing the visible range with your own wording
 - 🔧 **TypeScript**: Full TypeScript support with comprehensive type definitions
 
 ## Installation
@@ -266,14 +267,15 @@ With `onWheelHorizontal` wired **and `behaviorOptions.enableKeyboardNavigation`
 | 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 |
+| `["arrow"]` | `←/→` | Lists that want keyboard access to the horizontal axis |
 
-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.
+`Shift + ←/→` is **never** consumed (the `"shift-arrow"` input was removed in 3.0.0): in the browser it
+extends the text selection, and the 2.x "yield only while a selection exists" detection had structural
+defects — selections inside Shadow DOM are invisible to `document.getSelection()` (the guard silently
+fails), and `Ctrl+A` makes every row intersect the selection, locking horizontal keys out until the
+selection is cleared. Shift-flavored horizontal input remains available via `shift + wheel`, which does
+not conflict with selection. The prop stays an array (one vocabulary entry today) to match
+`behaviorOptions.pointerDragInputs` and to keep future additions non-breaking.
 
 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
@@ -285,8 +287,7 @@ It also fires only when the row **itself** is the event target. Focus sitting on
 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
+`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
@@ -303,6 +304,71 @@ focus, so if you want keyboard-only users to reach it, give them an entry point
 that same `Omit`. They sit at the top level, next to `onWheelHorizontal`, precisely so one `Omit` closes
 the whole horizontal seam.
 
+## Escape row-return
+
+Rows are not in the tab order (`tabIndex={-1}`), so once focus enters a link or widget inside a
+row there is by default no keyboard way back to the row — the anchor for arrow-key navigation.
+`behaviorOptions.enableEscapeRowReturn` (default: `false`) makes `Escape` return focus to the row
+wrapper (scrolling it into view if needed).
+
+It is off by default because `Escape` is the most overloaded key on the page (closing modals and
+dropdowns, cancelling IME composition, clearing selection). The feature therefore listens in the
+**bubble** phase — a dropdown opened inside a cell handles its own `Escape` first and can keep it
+with `stopPropagation()` or `preventDefault()` — skips IME composition (`isComposing`), leaves
+**editable targets** (`input` / `textarea` / `select` / `contentEditable`) entirely alone (their
+native `Escape` default actions, like Blink/WebKit clearing an `<input type="search">`, never show
+up in `defaultPrevented` and would otherwise be silently suppressed), and never acts while the row
+itself has focus (an `Escape` on the row means whatever *you* decide — e.g. deselect). When it
+does act it calls `preventDefault()` only and does not stop propagation, the same contract as the
+arrow keys.
+
+## Screen-reader live region
+
+Virtualization removes off-screen rows from the DOM, so a screen-reader user scrolling the list
+gets no feedback about where they are. The opt-in `liveRegion` prop renders a visually hidden
+`role="status"` element (polite, atomic) next to the pane and updates it after the visible range
+settles:
+
+```tsx
+<VirtualScroll
+    liveRegion={{
+        format: ({ visibleStartIndex, visibleEndIndex, itemCount }) => `rows ${visibleStartIndex + 1}-${visibleEndIndex + 1} of ${itemCount}`,
+        debounceMs: 400, // default; trailing — announces once after the last range change
+    }}
+    ...
+/>
+```
+
+The package ships **no built-in strings** — wording and language are yours (`format` returning the
+same string leaves the DOM untouched; `""` clears the region). An invalid `debounceMs` (negative /
+non-finite) logs a warning and disables announcements instead of silently substituting the
+default. ⚠️ If your app already maintains its own live region for the list, keep using
+`onRangeChange` instead — two regions double-announce.
+
+## Residual quantizer for snapping consumers
+
+Consumers that snap positions to a fixed quantum (row height, column width) lose sub-quantum
+deltas: a high-resolution trackpad emits many small deltas, each rounds to zero rows, and a slow
+swipe never moves. `createResidualQuantizer` carries the remainder across events:
+
+```tsx
+import { createResidualQuantizer } from "@aiquants/virtualscroll"
+
+const quantizer = createResidualQuantizer({ quantum: ROW_HEIGHT })
+const onWheelVertical = (deltaY: number) => {
+    const emitted = quantizer.push(deltaY) // always a multiple of the quantum (possibly 0)
+    if (emitted !== 0) snapScrollBy(emitted)
+}
+```
+
+By default the residue is dropped on direction reversal (so a stale forward remainder cannot delay
+the first backward step); call `reset()` from your own idle timer or when the snapped layout
+changes. `quantum` must be finite and positive (anything else throws — fail fast). Non-finite
+deltas and deltas beyond `Number.MAX_SAFE_INTEGER` emit 0 without poisoning the accumulator —
+past 2^53 the float product stops being an *exact* multiple of the quantum, the very property a
+snapping consumer relies on. The quantizer is deliberately time-free: idle expiry policies differ
+per UI, so they stay on your side of the seam.
+
 ## Suspended transitions (React 18/19 `startTransition` + `Suspense`)
 
 Scroll state is judged against the **last committed** dimensions, never against a render that got
@@ -371,7 +437,7 @@ exists in the DOM.
 | `onScroll` | `(position: number, totalHeight: number) => void` | ❌ | Scroll event handler |
 | `onRangeChange` | `(range: VirtualScrollRange) => void` | ❌ | Range change handler |
 | `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) |
+| `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) |
 | `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 |
@@ -382,6 +448,7 @@ exists in the DOM.
 | `onItemFocus` | `(index: number) => void` | ❌ | Callback when an item is focused |
 | `scrollBarOptions` | `VirtualScrollScrollBarOptions` | ❌ | Options for the scrollbar |
 | `behaviorOptions` | `VirtualScrollBehaviorOptions` | ❌ | Options for scrolling behavior |
+| `liveRegion` | `VirtualScrollLiveRegionOptions` | ❌ | Opt-in screen-reader live region announcing the visible range (nothing rendered when omitted). See [Screen-reader live region](#screen-reader-live-region) |
 | `contentProps` | `React.AriaAttributes & { id?: string; role?: React.AriaRole }` | ❌ | ARIA / identity attributes for the scrollable **content** element — the correct host for a composite widget role. See [Composite widget roles](#composite-widget-roles-listbox--tree--grid). |
 
 ### VirtualScrollScrollBarOptions
@@ -403,6 +470,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). 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 |
+| `enableEscapeRowReturn` | `boolean` | Opt-in (default: false): pressing `Escape` while focus sits on an element **inside** a row returns focus to the row wrapper. Listens in the bubble phase and respects `preventDefault` / `stopPropagation` / IME composition, so widgets inside the row keep first claim on their own `Escape`. Requires `enableKeyboardNavigation` |
 | `wheelSpeedMultiplier` | `number` | Multiplier for mouse wheel scrolling speed (default: 1) |
 | `inertiaOptions` | `ScrollPaneInertiaOptions` | Physics tuning for drag inertia |
 | `overscrollBehavior` | `"auto" \| "contain"` | Wheel behavior at the edges (default `"auto"` = chain to ancestors like a native scroller; `"contain"` = keep consuming, pre-2.7.0 trapping) |

package/dist/VirtualScroll.d.cts

@@ -150,6 +150,34 @@ export type VirtualScrollBehaviorOptions = {
      */
     pointerDragInputs?: ScrollPaneProps["pointerDragInputs"];
     enableKeyboardNavigation?: boolean;
+    /**
+     * When `true`, pressing `Escape` while focus sits on an element INSIDE a row returns focus to
+     * the row wrapper (default: `false`).
+     * `true` のとき、行の**中**の要素にフォーカスがある状態で `Escape` を押すと行ラッパーへ
+     * フォーカスを戻す (既定 `false`)。
+     *
+     * 行はタブ順に入らない (`tabIndex={-1}`) ため、行内のリンクやウィジェットへ入った後、
+     * キーボードだけで行 (縦横矢印ナビゲーションの起点) へ戻る手段が既定では存在しない。
+     * このオプションはその復帰口をパッケージ側で提供する。
+     *
+     * ❗ **既定 OFF なのは `Escape` が最も多重負荷のキーだからである** (モーダルやドロップダウンを
+     * 閉じる・IME 確定取消・選択解除)。次の防御で行内ウィジェットの `Escape` を奪わない:
+     *
+     * - **bubble フェーズで聞く** (矢印キーの capture とは逆)。行内で開いたドロップダウン等が
+     *   自分の `Escape` を先に処理でき、`stopPropagation()` すれば本機能には届かない。
+     * - `event.defaultPrevented` 済みなら何もしない (preventDefault だけの消費側も尊重)。
+     * - IME 合成中 (`isComposing`) は何もしない (確定取消を奪わない)。
+     * - **編集可能なターゲット (input / textarea / select / contentEditable) では何もしない。**
+     *   ネイティブの既定動作 (Blink / WebKit の `<input type="search">` は Escape でクリアされる) は
+     *   `defaultPrevented` に現れないため、スクリプト先約の検査では守れない。
+     * - 行そのものにフォーカスがあるときは何もしない (行上の `Escape` の意味 — 選択解除など — は
+     *   消費側の所有物)。
+     *
+     * 作用時は `preventDefault()` のみで伝播は止めない (矢印キーと同じ契約)。復帰は
+     * `focusItemAtIndex` 経由なので、行が画面外なら同時にスクロールで可視化される。
+     * `behaviorOptions.enableKeyboardNavigation` が前提 (行ハンドラ自体が付かないため)。
+     */
+    enableEscapeRowReturn?: boolean;
     wheelSpeedMultiplier?: number;
     inertiaOptions?: ScrollPaneProps["inertiaOptions"];
     /**
@@ -176,6 +204,48 @@ export type VirtualScrollBehaviorOptions = {
      */
     resetOnGetItemHeightChange?: boolean;
 };
+/**
+ * Range info handed to {@link VirtualScrollLiveRegionOptions.format}.
+ * {@link VirtualScrollLiveRegionOptions.format} へ渡す範囲情報。
+ */
+export type VirtualScrollLiveRegionRange = {
+    /** Index of the first visible item / 可視先頭アイテムのインデックス */
+    visibleStartIndex: number;
+    /** Index of the last visible item / 可視末尾アイテムのインデックス */
+    visibleEndIndex: number;
+    /** Total item count / 総アイテム数 */
+    itemCount: number;
+};
+/**
+ * Opt-in screen-reader live region announcing the visible range (see the `liveRegion` prop).
+ * 可視範囲を読み上げる opt-in のスクリーンリーダー用ライブリージョン (`liveRegion` prop 参照)。
+ */
+export type VirtualScrollLiveRegionOptions = {
+    /**
+     * Formats the announcement text. Called after the visible range settles; returning the same
+     * string as last time leaves the DOM untouched (no re-announcement), returning `""` clears
+     * the region. The package ships NO built-in strings — wording and language are the
+     * consumer's (a generic package must not hardcode a locale).
+     * 読み上げ文言を組み立てる。可視範囲が静定した後に呼ばれ、前回と同じ文字列なら DOM を
+     * 触らない (再読み上げしない)。`""` を返すとリージョンを空にする。パッケージは文言を
+     * 一切内蔵しない — 言語と文面は消費側の所有物 (汎用パッケージはロケールをハードコード
+     * できない)。
+     *
+     * @param range - The settled visible range / 静定した可視範囲
+     * @returns Announcement text / 読み上げ文言
+     */
+    format: (range: VirtualScrollLiveRegionRange) => string;
+    /**
+     * Debounce (ms) after the last range change before announcing (default: 400). Must be a
+     * finite number ≥ 0 — anything else logs a warning and disables announcements (no silent
+     * substitution). Announcing every wheel tick makes the reader chatter over the content;
+     * announcing too late reads a stale position. 0 announces on the next effect flush.
+     * 最後の範囲変化から読み上げまでのデバウンス (ms、既定 400)。有限かつ 0 以上であること —
+     * それ以外は警告して読み上げを無効化する (黙って既定へ読み替えない)。ホイール 1 ノッチ
+     * ごとに読むと内容の読み上げに被り、遅すぎると古い位置を読む。0 は次の effect で即時。
+     */
+    debounceMs?: number;
+};
 /**
  * Props for the VirtualScroll component.
  *
@@ -221,6 +291,24 @@ export type VirtualScrollProps<T> = {
     testId?: string;
     onScroll?: (scrollPosition: number, totalHeight: number) => void;
     onRangeChange?: (range: VirtualScrollRange) => void;
+    /**
+     * Opt-in `aria-live` region announcing the visible range to assistive technology (default:
+     * none rendered). Virtualization removes off-screen rows from the DOM, so a screen-reader
+     * user scrolling the list otherwise gets no feedback about where they are. Provide a
+     * {@link VirtualScrollLiveRegionOptions.format} to opt in; the region is a visually hidden
+     * `role="status"` element (polite, atomic) rendered as a sibling of the pane, updated after
+     * the range settles ({@link VirtualScrollLiveRegionOptions.debounceMs}).
+     *
+     * 可視範囲を支援技術へ読み上げる opt-in の `aria-live` リージョン (既定: 描画しない)。
+     * 仮想化は画面外の行を DOM から取り除くため、スクリーンリーダーの利用者はスクロールしても
+     * 現在位置の手掛かりを得られない。{@link VirtualScrollLiveRegionOptions.format} を渡すと、
+     * 視覚的に隠した `role="status"` 要素 (polite・atomic) をペインの兄弟として描画し、範囲が
+     * 静定した後に更新する。
+     *
+     * ❗ **ホスト側に既存のライブリージョンがある場合は併用しないこと** (二重読み上げになる)。
+     * その場合は `onRangeChange` から自前のリージョンを更新する従来手段を使う。
+     */
+    liveRegion?: VirtualScrollLiveRegionOptions;
     background?: ReactNode;
     children: (item: T, index: number) => ReactNode;
     initialScrollIndex?: number;
@@ -257,15 +345,21 @@ export type VirtualScrollProps<T> = {
      * `onWheelHorizontal` へ横スクロール量を流すキーボード操作の種別 (既定: 無効)。
      *
      * - `[]` / 未指定 (既定): 横キーボードスクロールを行わない。
-     * - `["shift-arrow"]`: `Shift + ←/→` のみ。木の展開/折りたたみ (`←/→`) やグリッドのセル移動と
-     *   衝突しないため、既存の行 UI を持つ消費側でも安全に有効化できる。
-     * - `["arrow"]`: 素の `←/→` のみ。`Shift + ←/→` を選択範囲の拡張に使うグリッド向け。
-     * - `["arrow", "shift-arrow"]`: 両方。
+     * - `["arrow"]`: 素の `←/→` のみ。
+     *
+     * ❗ **`Shift + ←/→` は常に消費しない (3.0.0 で `"shift-arrow"` 入力を撤去)。** ブラウザ標準では
+     * Shift+矢印は選択範囲の伸縮であり、横取りすると行内テキストを選び直す手段がキーボードから消える。
+     * 2.x では「選択があるときだけ譲る」検出 (`getSelection` の交差判定) で共存させていたが、
+     * (a) Shadow DOM 内では選択が可搬に検出できない (Chromium の `window.getSelection()` は shadow root
+     * 内部を見せず、内部選択は非標準 API でしか取れない)、(b) `Ctrl+A` の全選択では全行が選択と交差して
+     * 横キーボードスクロールが選択解除まで全面ロックアウトする、という構造的欠陥が残った。検出の
+     * 精度を上げる案はどれも別の正しいユーザー意図を誤判定するため、機能ごと撤去して Shift 側を
+     * 無条件でブラウザへ返す。横スクロールの Shift 系入力が必要なら `shift+ホイール` が引き続き使える
+     * (`resolveWheelAxes` の軸規則。こちらは選択と衝突しない)。
      *
-     * ❗ **配列なのは 4 状態が独立に必要だからである。** `"none" | "shift-arrows" | "arrows"` のような
-     * 段階的な文字列にすると `"arrows"` が `"shift-arrows"` を含んでしまい、「素の矢印だけ横スクロール、
-     * `Shift + ←/→` は消費側の範囲選択に残す」(Excel / データグリッドの標準) が**表現できない**。
-     * 同じ理由で種別配列を採るのが `pointerDragInputs` であり、本パッケージの既存の作法に揃えてある。
+     * ❗ **語彙が 1 つでも配列なのは意図的である。** 種別配列は `pointerDragInputs` と同じ本パッケージの
+     * 作法であり、将来の入力種別追加が型の破壊なしにできる。boolean へ畳むと prop 名が変わり、横軸を
+     * `Omit<>` で封じているラッパー (例: `@aiquants/directory-tree`) の封印リストまで連鎖破壊する。
      *
      * ❗ **既定が無効なのは、行ハンドラを奪わないためである。** 本パッケージの行キーハンドラは
      * capture フェーズに付くため、消費側の行 (bubble) より先に走る。既定で `←/→` を消費すると
@@ -298,7 +392,7 @@ export type VirtualScrollProps<T> = {
      * `Omit<VirtualScrollProps, "onWheelHorizontal">` で横軸を封じている) が `behaviorOptions` を
      * そのまま素通しするため、封じたはずのシームへ横から到達できてしまう。
      */
-    horizontalKeyInputs?: readonly ("arrow" | "shift-arrow")[];
+    horizontalKeyInputs?: readonly "arrow"[];
     /**
      * Pixels emitted per horizontal arrow key press (default: 40, matching browser arrow scrolling).
      * 横矢印キー 1 回あたりの移動量 (px。既定 40 = ブラウザの矢印スクロール相当)。

package/dist/VirtualScroll.d.ts

@@ -150,6 +150,34 @@ export type VirtualScrollBehaviorOptions = {
      */
     pointerDragInputs?: ScrollPaneProps["pointerDragInputs"];
     enableKeyboardNavigation?: boolean;
+    /**
+     * When `true`, pressing `Escape` while focus sits on an element INSIDE a row returns focus to
+     * the row wrapper (default: `false`).
+     * `true` のとき、行の**中**の要素にフォーカスがある状態で `Escape` を押すと行ラッパーへ
+     * フォーカスを戻す (既定 `false`)。
+     *
+     * 行はタブ順に入らない (`tabIndex={-1}`) ため、行内のリンクやウィジェットへ入った後、
+     * キーボードだけで行 (縦横矢印ナビゲーションの起点) へ戻る手段が既定では存在しない。
+     * このオプションはその復帰口をパッケージ側で提供する。
+     *
+     * ❗ **既定 OFF なのは `Escape` が最も多重負荷のキーだからである** (モーダルやドロップダウンを
+     * 閉じる・IME 確定取消・選択解除)。次の防御で行内ウィジェットの `Escape` を奪わない:
+     *
+     * - **bubble フェーズで聞く** (矢印キーの capture とは逆)。行内で開いたドロップダウン等が
+     *   自分の `Escape` を先に処理でき、`stopPropagation()` すれば本機能には届かない。
+     * - `event.defaultPrevented` 済みなら何もしない (preventDefault だけの消費側も尊重)。
+     * - IME 合成中 (`isComposing`) は何もしない (確定取消を奪わない)。
+     * - **編集可能なターゲット (input / textarea / select / contentEditable) では何もしない。**
+     *   ネイティブの既定動作 (Blink / WebKit の `<input type="search">` は Escape でクリアされる) は
+     *   `defaultPrevented` に現れないため、スクリプト先約の検査では守れない。
+     * - 行そのものにフォーカスがあるときは何もしない (行上の `Escape` の意味 — 選択解除など — は
+     *   消費側の所有物)。
+     *
+     * 作用時は `preventDefault()` のみで伝播は止めない (矢印キーと同じ契約)。復帰は
+     * `focusItemAtIndex` 経由なので、行が画面外なら同時にスクロールで可視化される。
+     * `behaviorOptions.enableKeyboardNavigation` が前提 (行ハンドラ自体が付かないため)。
+     */
+    enableEscapeRowReturn?: boolean;
     wheelSpeedMultiplier?: number;
     inertiaOptions?: ScrollPaneProps["inertiaOptions"];
     /**
@@ -176,6 +204,48 @@ export type VirtualScrollBehaviorOptions = {
      */
     resetOnGetItemHeightChange?: boolean;
 };
+/**
+ * Range info handed to {@link VirtualScrollLiveRegionOptions.format}.
+ * {@link VirtualScrollLiveRegionOptions.format} へ渡す範囲情報。
+ */
+export type VirtualScrollLiveRegionRange = {
+    /** Index of the first visible item / 可視先頭アイテムのインデックス */
+    visibleStartIndex: number;
+    /** Index of the last visible item / 可視末尾アイテムのインデックス */
+    visibleEndIndex: number;
+    /** Total item count / 総アイテム数 */
+    itemCount: number;
+};
+/**
+ * Opt-in screen-reader live region announcing the visible range (see the `liveRegion` prop).
+ * 可視範囲を読み上げる opt-in のスクリーンリーダー用ライブリージョン (`liveRegion` prop 参照)。
+ */
+export type VirtualScrollLiveRegionOptions = {
+    /**
+     * Formats the announcement text. Called after the visible range settles; returning the same
+     * string as last time leaves the DOM untouched (no re-announcement), returning `""` clears
+     * the region. The package ships NO built-in strings — wording and language are the
+     * consumer's (a generic package must not hardcode a locale).
+     * 読み上げ文言を組み立てる。可視範囲が静定した後に呼ばれ、前回と同じ文字列なら DOM を
+     * 触らない (再読み上げしない)。`""` を返すとリージョンを空にする。パッケージは文言を
+     * 一切内蔵しない — 言語と文面は消費側の所有物 (汎用パッケージはロケールをハードコード
+     * できない)。
+     *
+     * @param range - The settled visible range / 静定した可視範囲
+     * @returns Announcement text / 読み上げ文言
+     */
+    format: (range: VirtualScrollLiveRegionRange) => string;
+    /**
+     * Debounce (ms) after the last range change before announcing (default: 400). Must be a
+     * finite number ≥ 0 — anything else logs a warning and disables announcements (no silent
+     * substitution). Announcing every wheel tick makes the reader chatter over the content;
+     * announcing too late reads a stale position. 0 announces on the next effect flush.
+     * 最後の範囲変化から読み上げまでのデバウンス (ms、既定 400)。有限かつ 0 以上であること —
+     * それ以外は警告して読み上げを無効化する (黙って既定へ読み替えない)。ホイール 1 ノッチ
+     * ごとに読むと内容の読み上げに被り、遅すぎると古い位置を読む。0 は次の effect で即時。
+     */
+    debounceMs?: number;
+};
 /**
  * Props for the VirtualScroll component.
  *
@@ -221,6 +291,24 @@ export type VirtualScrollProps<T> = {
     testId?: string;
     onScroll?: (scrollPosition: number, totalHeight: number) => void;
     onRangeChange?: (range: VirtualScrollRange) => void;
+    /**
+     * Opt-in `aria-live` region announcing the visible range to assistive technology (default:
+     * none rendered). Virtualization removes off-screen rows from the DOM, so a screen-reader
+     * user scrolling the list otherwise gets no feedback about where they are. Provide a
+     * {@link VirtualScrollLiveRegionOptions.format} to opt in; the region is a visually hidden
+     * `role="status"` element (polite, atomic) rendered as a sibling of the pane, updated after
+     * the range settles ({@link VirtualScrollLiveRegionOptions.debounceMs}).
+     *
+     * 可視範囲を支援技術へ読み上げる opt-in の `aria-live` リージョン (既定: 描画しない)。
+     * 仮想化は画面外の行を DOM から取り除くため、スクリーンリーダーの利用者はスクロールしても
+     * 現在位置の手掛かりを得られない。{@link VirtualScrollLiveRegionOptions.format} を渡すと、
+     * 視覚的に隠した `role="status"` 要素 (polite・atomic) をペインの兄弟として描画し、範囲が
+     * 静定した後に更新する。
+     *
+     * ❗ **ホスト側に既存のライブリージョンがある場合は併用しないこと** (二重読み上げになる)。
+     * その場合は `onRangeChange` から自前のリージョンを更新する従来手段を使う。
+     */
+    liveRegion?: VirtualScrollLiveRegionOptions;
     background?: ReactNode;
     children: (item: T, index: number) => ReactNode;
     initialScrollIndex?: number;
@@ -257,15 +345,21 @@ export type VirtualScrollProps<T> = {
      * `onWheelHorizontal` へ横スクロール量を流すキーボード操作の種別 (既定: 無効)。
      *
      * - `[]` / 未指定 (既定): 横キーボードスクロールを行わない。
-     * - `["shift-arrow"]`: `Shift + ←/→` のみ。木の展開/折りたたみ (`←/→`) やグリッドのセル移動と
-     *   衝突しないため、既存の行 UI を持つ消費側でも安全に有効化できる。
-     * - `["arrow"]`: 素の `←/→` のみ。`Shift + ←/→` を選択範囲の拡張に使うグリッド向け。
-     * - `["arrow", "shift-arrow"]`: 両方。
+     * - `["arrow"]`: 素の `←/→` のみ。
+     *
+     * ❗ **`Shift + ←/→` は常に消費しない (3.0.0 で `"shift-arrow"` 入力を撤去)。** ブラウザ標準では
+     * Shift+矢印は選択範囲の伸縮であり、横取りすると行内テキストを選び直す手段がキーボードから消える。
+     * 2.x では「選択があるときだけ譲る」検出 (`getSelection` の交差判定) で共存させていたが、
+     * (a) Shadow DOM 内では選択が可搬に検出できない (Chromium の `window.getSelection()` は shadow root
+     * 内部を見せず、内部選択は非標準 API でしか取れない)、(b) `Ctrl+A` の全選択では全行が選択と交差して
+     * 横キーボードスクロールが選択解除まで全面ロックアウトする、という構造的欠陥が残った。検出の
+     * 精度を上げる案はどれも別の正しいユーザー意図を誤判定するため、機能ごと撤去して Shift 側を
+     * 無条件でブラウザへ返す。横スクロールの Shift 系入力が必要なら `shift+ホイール` が引き続き使える
+     * (`resolveWheelAxes` の軸規則。こちらは選択と衝突しない)。
      *
-     * ❗ **配列なのは 4 状態が独立に必要だからである。** `"none" | "shift-arrows" | "arrows"` のような
-     * 段階的な文字列にすると `"arrows"` が `"shift-arrows"` を含んでしまい、「素の矢印だけ横スクロール、
-     * `Shift + ←/→` は消費側の範囲選択に残す」(Excel / データグリッドの標準) が**表現できない**。
-     * 同じ理由で種別配列を採るのが `pointerDragInputs` であり、本パッケージの既存の作法に揃えてある。
+     * ❗ **語彙が 1 つでも配列なのは意図的である。** 種別配列は `pointerDragInputs` と同じ本パッケージの
+     * 作法であり、将来の入力種別追加が型の破壊なしにできる。boolean へ畳むと prop 名が変わり、横軸を
+     * `Omit<>` で封じているラッパー (例: `@aiquants/directory-tree`) の封印リストまで連鎖破壊する。
      *
      * ❗ **既定が無効なのは、行ハンドラを奪わないためである。** 本パッケージの行キーハンドラは
      * capture フェーズに付くため、消費側の行 (bubble) より先に走る。既定で `←/→` を消費すると
@@ -298,7 +392,7 @@ export type VirtualScrollProps<T> = {
      * `Omit<VirtualScrollProps, "onWheelHorizontal">` で横軸を封じている) が `behaviorOptions` を
      * そのまま素通しするため、封じたはずのシームへ横から到達できてしまう。
      */
-    horizontalKeyInputs?: readonly ("arrow" | "shift-arrow")[];
+    horizontalKeyInputs?: readonly "arrow"[];
     /**
      * Pixels emitted per horizontal arrow key press (default: 40, matching browser arrow scrolling).
      * 横矢印キー 1 回あたりの移動量 (px。既定 40 = ブラウザの矢印スクロール相当)。

package/dist/VirtualScroll.d.ts.map

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