@aiquants/virtualscroll 3.11.1 → 3.11.2

package/src/useWheelBridge.ts

@@ -95,6 +95,12 @@ export const useWheelBridge = (target: RefObject<WheelBridgeTarget | null>, opti
     // WeakMap なので、外し損ねた要素があっても要素ごと GC される。
     const attachedRef = useRef<WeakMap<HTMLElement, (event: WheelEvent) => void>>(new WeakMap())
 
+    /**
+     * The ref callback for an element outside the pane: it attaches one non-passive wheel listener per element, which applies each
+     * wheel event to the target, and returns the cleanup that removes it (React 19). Its identity never changes.
+     * ペインの外の要素に付ける ref コールバック。要素ごとに 1 つの非 passive なホイールのリスナーを付け (ホイールのイベントをそれぞれ対象へ当てる)、
+     * それを外す後始末を返す (React 19)。同一性は変わらない。
+     */
     return useCallback((node: HTMLElement | null) => {
         // ❗ null 呼び出しでは何も外さない。どの要素の話か分からないため、ここで外すと
         // 無関係の要素を巻き添えにする。解除は下のクリーンアップ (要素を知っている) が行う。
@@ -111,6 +117,10 @@ export const useWheelBridge = (target: RefObject<WheelBridgeTarget | null>, opti
             return
         }
 
+        /**
+         * Applies one wheel event to the target unless the bridge is disabled.
+         * ブリッジが無効でなければ、ホイールのイベント 1 つを対象へ当てる処理。
+         */
         const listener = (event: WheelEvent) => {
             if (optionsRef.current?.enableBridge === false) {
                 return
@@ -126,6 +136,10 @@ export const useWheelBridge = (target: RefObject<WheelBridgeTarget | null>, opti
         node.addEventListener("wheel", listener, { passive: false })
         attachedRef.current.set(node, listener)
 
+        /**
+         * Removes the element's listener, when it is still the one this call attached.
+         * 要素のリスナーを、この呼び出しが付けたものである限り外す処理。
+         */
         // React 19 はこのクリーンアップを受け取ると `null` 呼び出しの代わりに実行する。
         // ❗ listener の一致判定は**意図的な防御**である。ref コールバックの identity は固定
         // (依存配列が空) なので、要素がマウントされている限り React は張り直さず、現状この分岐が