@aiquants/virtualscroll 2.7.0 → 3.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiquants/virtualscroll",
-  "version": "2.7.0",
+  "version": "3.0.0",
   "description": "High-performance virtual scrolling component for React with variable item heights",
   "sideEffects": [
     "**/*.css"

package/src/VirtualScroll.tsx

@@ -253,15 +253,21 @@ export type VirtualScrollProps<T> = {
      * `onWheelHorizontal` へ横スクロール量を流すキーボード操作の種別 (既定: 無効)。
      *
      * - `[]` / 未指定 (既定): 横キーボードスクロールを行わない。
-     * - `["shift-arrow"]`: `Shift + ←/→` のみ。木の展開/折りたたみ (`←/→`) やグリッドのセル移動と
-     *   衝突しないため、既存の行 UI を持つ消費側でも安全に有効化できる。
-     * - `["arrow"]`: 素の `←/→` のみ。`Shift + ←/→` を選択範囲の拡張に使うグリッド向け。
-     * - `["arrow", "shift-arrow"]`: 両方。
+     * - `["arrow"]`: 素の `←/→` のみ。
      *
-     * ❗ **配列なのは 4 状態が独立に必要だからである。** `"none" | "shift-arrows" | "arrows"` のような
-     * 段階的な文字列にすると `"arrows"` が `"shift-arrows"` を含んでしまい、「素の矢印だけ横スクロール、
-     * `Shift + ←/→` は消費側の範囲選択に残す」(Excel / データグリッドの標準) が**表現できない**。
-     * 同じ理由で種別配列を採るのが `pointerDragInputs` であり、本パッケージの既存の作法に揃えてある。
+     * ❗ **`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` の軸規則。こちらは選択と衝突しない)。
+     *
+     * ❗ **語彙が 1 つでも配列なのは意図的である。** 種別配列は `pointerDragInputs` と同じ本パッケージの
+     * 作法であり、将来の入力種別追加が型の破壊なしにできる。boolean へ畳むと prop 名が変わり、横軸を
+     * `Omit<>` で封じているラッパー (例: `@aiquants/directory-tree`) の封印リストまで連鎖破壊する。
      *
      * ❗ **既定が無効なのは、行ハンドラを奪わないためである。** 本パッケージの行キーハンドラは
      * capture フェーズに付くため、消費側の行 (bubble) より先に走る。既定で `←/→` を消費すると
@@ -294,7 +300,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 = ブラウザの矢印スクロール相当)。
@@ -390,32 +396,6 @@ const ANCHOR_REBASE_DISTANCE = 1_048_576 // 2^20 px
  */
 const DEFAULT_HORIZONTAL_KEY_STEP = 40
 
-/**
- * Reports whether a non-collapsed text selection currently sits inside the given element.
- * 指定要素の中に折り畳まれていないテキスト選択が存在するかを返す処理。
- *
- * `Shift + ←/→` はブラウザ標準では選択範囲の伸縮である。行の中でテキストを選んでいる最中に
- * 横スクロールへ横取りすると、**選び直す手段がキーボードから消える**。選択が空 (キャレットだけ) の
- * ときは伸縮の起点が無いため横取りしてよい。
- *
- * @param element - Element to test the selection against / 選択範囲の所在を調べる要素
- * @returns True when a non-collapsed selection is inside the element / 折り畳まれていない選択が内側にある場合に true
- */
-const hasTextSelectionWithin = (element: HTMLElement): boolean => {
-    const selection = element.ownerDocument.defaultView?.getSelection()
-    if (!selection || selection.isCollapsed || selection.rangeCount === 0) {
-        return false
-    }
-    // ❗ 起点 (anchorNode) の包含では不十分。`Ctrl+A` のようにページ全体を選ぶと起点は行の外に落ち、
-    // 「行の上に見えている選択」を取りこぼす (実ブラウザで実測)。範囲が行と**交差**するかで判定する。
-    for (let index = 0; index < selection.rangeCount; index += 1) {
-        if (selection.getRangeAt(index).intersectsNode(element)) {
-            return true
-        }
-    }
-    return false
-}
-
 /**
  * Converts a numeric size into a non-negative bigint for large collection handling.
  *
@@ -1915,14 +1895,14 @@ const VirtualScrollInner = <T,>(
                 if (!emitHorizontal) {
                     return
                 }
-                // 押されたジェスチャが許可種別に含まれるかを確認する
-                const gesture = event.shiftKey ? "shift-arrow" : "arrow"
-                if (!horizontalKeyInputs?.includes(gesture)) {
+                // ❗ Shift 併用は無条件で消費しない (3.0.0 で "shift-arrow" 入力を撤去)。ブラウザ標準では
+                // 選択範囲の伸縮であり、選択の有無での条件分岐はしない — 選択検出は Shadow DOM で
+                // 可搬に成立せず、Ctrl+A 全選択では全行が交差して解除まで全面ロックアウトするため
+                if (event.shiftKey) {
                     return
                 }
-                // ❗ テキスト選択中の Shift+←/→ は選択範囲の伸縮であり、横スクロールで奪ってはならない
-                // (実ブラウザで実測: 奪うと行内のテキストを選び直せなくなる)
-                if (event.shiftKey && hasTextSelectionWithin(event.currentTarget)) {
+                // 押されたジェスチャが許可種別に含まれるかを確認する
+                if (!horizontalKeyInputs?.includes("arrow")) {
                     return
                 }
                 // ❗ 不正な移動量は既定へ黙って読み替えず、消費もしない (Strict No-Fallback)。