@aiquants/virtualscroll 1.20.0 → 1.22.0

package/CHANGELOG.md

@@ -0,0 +1,73 @@
+# Changelog
+
+All notable changes to `@aiquants/virtualscroll` are documented here.
+
+## 1.21.0 — Unreleased
+
+### Breaking
+
+- **`maxSpeedCurve` now shapes the ramp instead of capping the ceiling.** Previously the
+  exponential curve was applied to `maxSpeed` and an easing was applied on top of that
+  (double application), so wherever the exponential ceiling fell below `minSpeed` the mapping
+  collapsed to `maxSpeed === minSpeed` — a **dead zone where pulling the circle changed nothing**.
+  Its width was governed by `exponentialSteepness`: with `minSpeedMultiplier: 0.2` and
+  `exponentialScale: 14`, a steepness of `1` wasted 2.43% of the pull, `3` wasted 8.0%,
+  `7.5` wasted 43.85% and `12` wasted 64.60%. The curve is now applied to the shape only and the
+  ceiling is distance-independent, so speed is strictly monotonic over the whole pull.
+  - **Consumers that pass `maxSpeedCurve` will feel different speeds.** Re-tune rather than
+    carrying old values over. Consumers that do **not** pass `maxSpeedCurve` are unaffected —
+    verified point-by-point against the previous implementation.
+- **`easedOffset` changed meaning.** It is now a fraction of the whole `[minSpeed, maxSpeed]`
+  range applied at zero drag, re-mapped as `offset + (1 - offset) * shape` (the old additive
+  `min(1, shape + offset)` created a *flat region at the top* instead). With a large
+  `maxSpeedMultiplier` — including the automatic `itemCount`-derived one — even `0.1` starts the
+  list at several viewports per second. Raise `minSpeedMultiplier` instead when you only want a
+  faster floor. The bundled demo and the README example dropped `easedOffset` for this reason.
+- **The `aqvs-sample-visual-*` class names were rotated to match their roles.** They were off by
+  one: the pupil carried `-rod`, the highlight carried `-pupil` and the tail carried `-highlight`,
+  so editing `.aqvs-sample-visual-highlight` restyled the tail. The CSS rule bodies were rotated
+  with them, so **every element renders exactly as before** — but a consumer that overrides these
+  class names must follow the rename (`-rod` → `-pupil`, `-pupil` → `-highlight`,
+  `-highlight` → `-rod`).
+- **`FenwickMapTree.calculateAccumulatedError()` now only sums deltas inside `[0, size)`.**
+  `changeSize(0)` keeps deltas so a list that briefly empties during loading can reuse its measured
+  row heights; counting the out-of-range ones made the method report a non-zero error for a
+  perfectly healthy tree the whole time the list was empty (and `rebuildTree()` did not clear it).
+
+### Added
+
+- `pointerDragInputs` on `ScrollPane` / `VirtualScrollBehaviorOptions` 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 is transform-based with no native scroller, so disabling drag removes the only way to
+  scroll on touch devices. `touch-action: none` is applied only when `"touch"` or `"pen"` is
+  allowed (`touch-action` affects pen input too).
+- `computeTapScrollSpeed()` and `TapScrollSpeedInput` are exported so consumers can reproduce the
+  tap-circle speed mapping (for tuning tables, tests or alternative UIs).
+- `FenwickMapTree.base` getter, used by `useFenwickMapTree` to decide whether a `0 → N` growth
+  re-samples or reuses preserved deltas. It is the base height, **not** a "has the tree warmed up"
+  flag — `0` is a legitimate base value.
+- `data-testid="aqvs-scrollbar-thumb"` on the scrollbar thumb, so DOM hooks no longer need a class
+  selector.
+
+### Fixed
+
+- Tap-scroll and inertia no longer fight over the scroll position. Inertia is cancelled both when a
+  pointer touches anywhere in the pane and whenever a scrollbar-originated scroll arrives, so the
+  exclusion holds regardless of order (and on paths with no `pointerdown`, such as the arrow-button
+  keyboard repeat). Position used to oscillate — measured 140 → 100 → 30 → 184.
+- The inertia RAF loop reads the scroll seam through a ref, so a consumer swapping `onScroll`
+  mid-flick no longer keeps getting position updates on the discarded callback.
+- An in-flight drag is now torn down when **any** of its three continuation conditions
+  (`enablePointerDrag`, `pointerDragInputs`, `isScrollable`) turns false. Previously a mid-drag
+  scrollability flip parked the pointer capture and replayed the dropped travel as a single jump
+  (measured: 190px of finger travel came back as 0 → 210).
+- That teardown now carries the click suppression through to the end of the gesture, so scrolling
+  no longer activates the row under the finger.
+- `FenwickMapTree.changeSize()` growing from `0` with preserved deltas rebuilds the tree instead of
+  taking the incremental path (which propagated no deltas at all and left `get()` and `getTotal()`
+  permanently disagreeing), and prunes deltas outside the new size so they cannot reappear as
+  another dataset's row heights.
+- `computeTapScrollSpeed()` sanitizes every numeric input against `NaN` / `±Infinity` and clamps
+  `exponentialSteepness` to `700`. A non-finite speed used to poison the scroll position itself,
+  leaving the pane permanently unscrollable.

package/README.md

@@ -195,7 +195,8 @@ A runnable version lives in the demo at **`/horizontal`** (`pnpm demo:dev`), and
 
 | Property | Type | Description |
 | --- | --- | --- |
-| `enablePointerDrag` | `boolean` | Enable dragging the content area to scroll |
+| `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) |
 | `wheelSpeedMultiplier` | `number` | Multiplier for mouse wheel scrolling speed |
 | `inertiaOptions` | `ScrollPaneInertiaOptions` | Physics tuning for drag inertia |
@@ -339,7 +340,9 @@ The auxiliary tap scroll circle can replace the native scrollbar for large datas
 
 - **Adaptive speed scaling** automatically ramps up to a `120×` multiplier as `itemCount` grows (trillions supported).
 - **Manual overrides** let you clamp or extend speed via `maxSpeedMultiplier` when you need deterministic behavior.
-- **Exponential capping** enables distance-sensitive ceilings with `maxSpeedCurve`, blending gentle near-threshold drag with high-speed travel at extended distances. Use `easedOffset` to slightly raise the entry-level speed without changing the ceiling.
+- **Speed shaping** with `maxSpeedCurve` controls how quickly the speed ramps up as you pull the circle, blending gentle near-threshold drag with high-speed travel at extended distances. The ceiling itself does not depend on the drag distance: `exponentialSteepness` shapes the ramp, and `exponentialScale` caps the ceiling (its effective value is `min(exponentialScale, maxSpeedMultiplier)`).
+  - ⚠️ `easedOffset` is **a fraction of the whole `[minSpeed, maxSpeed]` range applied at zero drag**, not a small nudge. With a large `maxSpeedMultiplier` (including the automatic `itemCount`-derived one) even `0.1` starts the list at several viewports per second and costs you the low-speed resolution. Raise `minSpeedMultiplier` instead when you only want a faster floor.
+- **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.
 
@@ -365,7 +368,6 @@ export function UltraFastExample() {
           maxSpeedCurve: {
             exponentialSteepness: 6,
             exponentialScale: 80,
-            easedOffset: 0.1,
           },
           offsetX: -96,
           opacity: 0.85,

package/dist/ScrollBar.d.cts

@@ -92,6 +92,129 @@ export type ScrollBarProps = {
     /** The index of the last visible item. / 最後の可視アイテムのインデックス。 */
     visibleEndIndex?: number;
 };
+/**
+ * Defaults `computeTapScrollSpeed` callers need to reproduce the shipped speed mapping.
+ * `computeTapScrollSpeed` の呼び出し側が出荷時の速度写像を再現するために必要な既定値。
+ *
+ * ❗ これらは `ScrollBar` が `tapScrollCircleOptions` を解決するときに使う値そのもの。
+ * 公開しないと、`computeTapScrollSpeed` を渡された消費側が「自分の設定で実際に何 px/s 出るか」を
+ * 事前に検証できない (必須フィールドの大半が内部リゾルバの出力になってしまう)。
+ */
+export declare const TAP_SCROLL_SPEED_DEFAULTS: {
+    /** 速度が最大に達する引き距離 (px)。`maxVisualDistance` の既定値。 */
+    readonly maxDistance: 240;
+    /** 最小速度倍率 (ビューポート比)。 */
+    readonly minSpeedMultiplier: 0.2;
+};
+/**
+ * Input for `computeTapScrollSpeed`.
+ * `computeTapScrollSpeed` の入力。
+ */
+export type TapScrollSpeedInput = {
+    /** サークルを引いた距離 (px)。 */
+    distance: number;
+    /** 速度が最大に達する引き距離 (px)。 */
+    maxDistance: number;
+    /** ビューポートの長さ (px)。速度倍率の基準。 */
+    viewportSize: number;
+    /** 最小速度倍率 (ビューポート比)。 */
+    minSpeedMultiplier: number;
+    /** 最大速度倍率 (ビューポート比)。 */
+    maxSpeedMultiplier: number;
+    /** `maxSpeedMultiplier` が消費側から明示されたか (件数由来の自動値ではないか)。 */
+    hasCustomMaxSpeedMultiplier: boolean;
+    /** 速度の立ち上がり形状。未指定なら `normalized ** 1.1` の既定形状。 */
+    curve?: {
+        exponentialSteepness: number;
+        exponentialScale?: number;
+        easedOffset?: number;
+    };
+};
+/**
+ * Maps the tap-circle drag distance onto a scroll speed (px/s).
+ * タップサークルの引き距離をスクロール速度 (px/s) へ写像する処理。
+ *
+ * ❗ **曲線は「速度の上限」ではなく「立ち上がりの形状」を決める。**
+ * かつては指数カーブを上限 (`maxSpeed`) 側へ適用し、その `maxSpeed` へさらに
+ * イージングを掛けていた (二重適用)。その結果、指数側の上限が最小速度を下回る区間で
+ * `maxSpeed === minSpeed` へ潰れ、**引いても速度がまったく変わらない死角**が生まれていた。
+ * 死角の境界は `shape(n) = minSpeed / (viewportSize × exponentialScale)` を満たす点で、
+ * その**幅を支配するのは `exponentialSteepness`** である (比が同じ 0.2/14 でも
+ * steepness 1 なら引き幅の 2.4%、3 なら 8.0%、7.5 なら 43.9%、12 なら 64.6%)。
+ * `easedOffset` も同区間では完全に無効化されていた。
+ *
+ * そこで曲線は形状にのみ適用し、上限は距離に依存しない定数として扱う。
+ * これにより**縮退設定を除いて**速度は引き距離に対して狭義単調になり、平坦域が発生しない。
+ *
+ * 縮退設定 (意図的に定速へ倒す設定であり、欠陥ではない)。いずれも `maxSpeed === minSpeed`
+ * または `offset === 1` に潰れるため、引き距離に依らず定速になる:
+ *
+ * 1. `minSpeedMultiplier >= maxSpeedMultiplier` → 全域で最小速度に固定。
+ *    `ScrollBar.spec.tsx` の `FIXED_SPEED_OPTIONS` がこれを利用している。
+ * 2. `easedOffset === 1` → 全域で最高速に固定。
+ * 3. `exponentialScale <= max(minSpeedMultiplier, 40 / viewportSize)` → 曲線側の上限が
+ *    最小速度以下に潰れるため全域で最小速度に固定。**旧実装の死角と同種の現象**だが、
+ *    こちらは距離に依存しないので「一部区間だけ平坦」にはならず、全域が定速になる。
+ *    曲線を使うなら `exponentialScale > minSpeedMultiplier` を満たすこと。
+ *
+ * 各パラメータ:
+ *
+ * - `exponentialSteepness`: 立ち上がりの鋭さ。大きいほど低速域が長い。0 で線形。
+ *   内部で `[0, 700]` へ丸める (`Math.expm1` が `Infinity` になるのを避けるため)。
+ * - `exponentialScale`: 曲線側の上限 (ビューポート比)。省略時は `maxSpeedMultiplier`。
+ *   実効上限は `min(viewportSize × exponentialScale, linearMaxSpeed)` (いずれも `minSpeed` で下支え)。
+ *   ❗ `maxSpeedMultiplier` を**明示した**場合は `linearMaxSpeed = viewportSize × maxSpeedMultiplier`
+ *   なので「実効上限は `min(exponentialScale, maxSpeedMultiplier)` 倍」と読んでよいが、
+ *   **省略した場合はそうならない**。自動倍率には 1,200 px/s の下限が掛かるため、
+ *   実効上限は `min(viewportSize × exponentialScale, max(viewportSize × 自動倍率, 1200))` になる
+ *   (例: ビューポート 200・自動倍率 0.1・scale 0.5 なら、倍率比では 0.1 倍のはずが実際は 100 px/s)。
+ * - `easedOffset`: **速度レンジ全体 `[minSpeed, maxSpeed]` に対する比率**として、
+ *   引き距離 0 の時点で履かせる下駄 (0〜1)。
+ *   ❗ **「微速の下駄」ではない。** `maxSpeedMultiplier` (特に件数由来の自動値) が
+ *   大きいほど絶対速度も比例して大きくなる。例: ビューポート 800px・実効上限 8 倍で
+ *   `easedOffset: 0.18` なら引き距離 0 の時点で 1,283 px/s (160px 行なら毎秒 8 行) 出る。
+ *   低速域の分解能をその分だけ失うので、微速の下限を上げたいだけなら
+ *   `minSpeedMultiplier` を上げる方が意図に忠実。
+ *   ❗ 旧実装では下駄が `shape` への加算だったうえ、低速域は死角に飲まれて実質無効だった。
+ *   同じ値でも意味と絶対速度が変わるため、旧実装から値を持ち越さないこと。
+ *
+ * `maxSpeedMultiplier` を省略した場合の下限 1,200 px/s はビューポート非依存の絶対値で、
+ * 小さいビューポートほどビューポート比では速くなる (200px なら 6 vp/s、800px なら 1.5 vp/s)。
+ * 既存挙動との互換のため意図的に据え置いている。
+ *
+ * すべての数値入力は非有限 (NaN / ±Infinity) を代替値へ落として消毒する。
+ * 速度が NaN になると `scrollTo` を経てスクロール位置そのものが NaN で汚染され、
+ * 以後の相対移動が連鎖的に壊れて「スクロールが完全に効かなくなる」復旧不能な状態になるため。
+ *
+ * 外部から呼ぶときは `TAP_SCROLL_SPEED_DEFAULTS` と `computeAutoTapScrollMaxSpeedMultiplier()` を
+ * 併せて使うと、`ScrollBar` が実際に解決する値を再現できる:
+ *
+ * ```ts
+ * const options = { maxSpeedCurve: { exponentialSteepness: 3, exponentialScale: 8 } }
+ * const speed = computeTapScrollSpeed({
+ *     distance,
+ *     maxDistance: options.maxVisualDistance ?? TAP_SCROLL_SPEED_DEFAULTS.maxDistance,
+ *     viewportSize,
+ *     minSpeedMultiplier: options.minSpeedMultiplier ?? TAP_SCROLL_SPEED_DEFAULTS.minSpeedMultiplier,
+ *     maxSpeedMultiplier: options.maxSpeedMultiplier ?? computeAutoTapScrollMaxSpeedMultiplier(itemCount),
+ *     hasCustomMaxSpeedMultiplier: options.maxSpeedMultiplier !== undefined,
+ *     curve: options.maxSpeedCurve,
+ * })
+ * ```
+ *
+ * @param input Drag distance and the resolved speed options. 引き距離と解決済みの速度設定。
+ * @returns Scroll speed in px/s (always finite, >= 40). px/s 単位のスクロール速度 (常に有限かつ 40 以上)。
+ */
+export declare const computeTapScrollSpeed: ({ distance, maxDistance, viewportSize, minSpeedMultiplier, maxSpeedMultiplier, hasCustomMaxSpeedMultiplier, curve }: TapScrollSpeedInput) => number;
+/**
+ * Computes the auto-scroll speed multiplier based on item count.
+ *
+ * アイテム数に応じた自動スクロール速度倍率を算出。
+ *
+ * @param itemCount Total number of items. アイテムの総数。
+ * @returns Speed multiplier relative to the viewport size. ビューポート比の速度倍率。
+ */
+export declare const computeAutoTapScrollMaxSpeedMultiplier: (itemCount?: number) => number;
 /**
  * A custom scrollbar component.
  *

package/dist/ScrollBar.d.ts

@@ -92,6 +92,129 @@ export type ScrollBarProps = {
     /** The index of the last visible item. / 最後の可視アイテムのインデックス。 */
     visibleEndIndex?: number;
 };
+/**
+ * Defaults `computeTapScrollSpeed` callers need to reproduce the shipped speed mapping.
+ * `computeTapScrollSpeed` の呼び出し側が出荷時の速度写像を再現するために必要な既定値。
+ *
+ * ❗ これらは `ScrollBar` が `tapScrollCircleOptions` を解決するときに使う値そのもの。
+ * 公開しないと、`computeTapScrollSpeed` を渡された消費側が「自分の設定で実際に何 px/s 出るか」を
+ * 事前に検証できない (必須フィールドの大半が内部リゾルバの出力になってしまう)。
+ */
+export declare const TAP_SCROLL_SPEED_DEFAULTS: {
+    /** 速度が最大に達する引き距離 (px)。`maxVisualDistance` の既定値。 */
+    readonly maxDistance: 240;
+    /** 最小速度倍率 (ビューポート比)。 */
+    readonly minSpeedMultiplier: 0.2;
+};
+/**
+ * Input for `computeTapScrollSpeed`.
+ * `computeTapScrollSpeed` の入力。
+ */
+export type TapScrollSpeedInput = {
+    /** サークルを引いた距離 (px)。 */
+    distance: number;
+    /** 速度が最大に達する引き距離 (px)。 */
+    maxDistance: number;
+    /** ビューポートの長さ (px)。速度倍率の基準。 */
+    viewportSize: number;
+    /** 最小速度倍率 (ビューポート比)。 */
+    minSpeedMultiplier: number;
+    /** 最大速度倍率 (ビューポート比)。 */
+    maxSpeedMultiplier: number;
+    /** `maxSpeedMultiplier` が消費側から明示されたか (件数由来の自動値ではないか)。 */
+    hasCustomMaxSpeedMultiplier: boolean;
+    /** 速度の立ち上がり形状。未指定なら `normalized ** 1.1` の既定形状。 */
+    curve?: {
+        exponentialSteepness: number;
+        exponentialScale?: number;
+        easedOffset?: number;
+    };
+};
+/**
+ * Maps the tap-circle drag distance onto a scroll speed (px/s).
+ * タップサークルの引き距離をスクロール速度 (px/s) へ写像する処理。
+ *
+ * ❗ **曲線は「速度の上限」ではなく「立ち上がりの形状」を決める。**
+ * かつては指数カーブを上限 (`maxSpeed`) 側へ適用し、その `maxSpeed` へさらに
+ * イージングを掛けていた (二重適用)。その結果、指数側の上限が最小速度を下回る区間で
+ * `maxSpeed === minSpeed` へ潰れ、**引いても速度がまったく変わらない死角**が生まれていた。
+ * 死角の境界は `shape(n) = minSpeed / (viewportSize × exponentialScale)` を満たす点で、
+ * その**幅を支配するのは `exponentialSteepness`** である (比が同じ 0.2/14 でも
+ * steepness 1 なら引き幅の 2.4%、3 なら 8.0%、7.5 なら 43.9%、12 なら 64.6%)。
+ * `easedOffset` も同区間では完全に無効化されていた。
+ *
+ * そこで曲線は形状にのみ適用し、上限は距離に依存しない定数として扱う。
+ * これにより**縮退設定を除いて**速度は引き距離に対して狭義単調になり、平坦域が発生しない。
+ *
+ * 縮退設定 (意図的に定速へ倒す設定であり、欠陥ではない)。いずれも `maxSpeed === minSpeed`
+ * または `offset === 1` に潰れるため、引き距離に依らず定速になる:
+ *
+ * 1. `minSpeedMultiplier >= maxSpeedMultiplier` → 全域で最小速度に固定。
+ *    `ScrollBar.spec.tsx` の `FIXED_SPEED_OPTIONS` がこれを利用している。
+ * 2. `easedOffset === 1` → 全域で最高速に固定。
+ * 3. `exponentialScale <= max(minSpeedMultiplier, 40 / viewportSize)` → 曲線側の上限が
+ *    最小速度以下に潰れるため全域で最小速度に固定。**旧実装の死角と同種の現象**だが、
+ *    こちらは距離に依存しないので「一部区間だけ平坦」にはならず、全域が定速になる。
+ *    曲線を使うなら `exponentialScale > minSpeedMultiplier` を満たすこと。
+ *
+ * 各パラメータ:
+ *
+ * - `exponentialSteepness`: 立ち上がりの鋭さ。大きいほど低速域が長い。0 で線形。
+ *   内部で `[0, 700]` へ丸める (`Math.expm1` が `Infinity` になるのを避けるため)。
+ * - `exponentialScale`: 曲線側の上限 (ビューポート比)。省略時は `maxSpeedMultiplier`。
+ *   実効上限は `min(viewportSize × exponentialScale, linearMaxSpeed)` (いずれも `minSpeed` で下支え)。
+ *   ❗ `maxSpeedMultiplier` を**明示した**場合は `linearMaxSpeed = viewportSize × maxSpeedMultiplier`
+ *   なので「実効上限は `min(exponentialScale, maxSpeedMultiplier)` 倍」と読んでよいが、
+ *   **省略した場合はそうならない**。自動倍率には 1,200 px/s の下限が掛かるため、
+ *   実効上限は `min(viewportSize × exponentialScale, max(viewportSize × 自動倍率, 1200))` になる
+ *   (例: ビューポート 200・自動倍率 0.1・scale 0.5 なら、倍率比では 0.1 倍のはずが実際は 100 px/s)。
+ * - `easedOffset`: **速度レンジ全体 `[minSpeed, maxSpeed]` に対する比率**として、
+ *   引き距離 0 の時点で履かせる下駄 (0〜1)。
+ *   ❗ **「微速の下駄」ではない。** `maxSpeedMultiplier` (特に件数由来の自動値) が
+ *   大きいほど絶対速度も比例して大きくなる。例: ビューポート 800px・実効上限 8 倍で
+ *   `easedOffset: 0.18` なら引き距離 0 の時点で 1,283 px/s (160px 行なら毎秒 8 行) 出る。
+ *   低速域の分解能をその分だけ失うので、微速の下限を上げたいだけなら
+ *   `minSpeedMultiplier` を上げる方が意図に忠実。
+ *   ❗ 旧実装では下駄が `shape` への加算だったうえ、低速域は死角に飲まれて実質無効だった。
+ *   同じ値でも意味と絶対速度が変わるため、旧実装から値を持ち越さないこと。
+ *
+ * `maxSpeedMultiplier` を省略した場合の下限 1,200 px/s はビューポート非依存の絶対値で、
+ * 小さいビューポートほどビューポート比では速くなる (200px なら 6 vp/s、800px なら 1.5 vp/s)。
+ * 既存挙動との互換のため意図的に据え置いている。
+ *
+ * すべての数値入力は非有限 (NaN / ±Infinity) を代替値へ落として消毒する。
+ * 速度が NaN になると `scrollTo` を経てスクロール位置そのものが NaN で汚染され、
+ * 以後の相対移動が連鎖的に壊れて「スクロールが完全に効かなくなる」復旧不能な状態になるため。
+ *
+ * 外部から呼ぶときは `TAP_SCROLL_SPEED_DEFAULTS` と `computeAutoTapScrollMaxSpeedMultiplier()` を
+ * 併せて使うと、`ScrollBar` が実際に解決する値を再現できる:
+ *
+ * ```ts
+ * const options = { maxSpeedCurve: { exponentialSteepness: 3, exponentialScale: 8 } }
+ * const speed = computeTapScrollSpeed({
+ *     distance,
+ *     maxDistance: options.maxVisualDistance ?? TAP_SCROLL_SPEED_DEFAULTS.maxDistance,
+ *     viewportSize,
+ *     minSpeedMultiplier: options.minSpeedMultiplier ?? TAP_SCROLL_SPEED_DEFAULTS.minSpeedMultiplier,
+ *     maxSpeedMultiplier: options.maxSpeedMultiplier ?? computeAutoTapScrollMaxSpeedMultiplier(itemCount),
+ *     hasCustomMaxSpeedMultiplier: options.maxSpeedMultiplier !== undefined,
+ *     curve: options.maxSpeedCurve,
+ * })
+ * ```
+ *
+ * @param input Drag distance and the resolved speed options. 引き距離と解決済みの速度設定。
+ * @returns Scroll speed in px/s (always finite, >= 40). px/s 単位のスクロール速度 (常に有限かつ 40 以上)。
+ */
+export declare const computeTapScrollSpeed: ({ distance, maxDistance, viewportSize, minSpeedMultiplier, maxSpeedMultiplier, hasCustomMaxSpeedMultiplier, curve }: TapScrollSpeedInput) => number;
+/**
+ * Computes the auto-scroll speed multiplier based on item count.
+ *
+ * アイテム数に応じた自動スクロール速度倍率を算出。
+ *
+ * @param itemCount Total number of items. アイテムの総数。
+ * @returns Speed multiplier relative to the viewport size. ビューポート比の速度倍率。
+ */
+export declare const computeAutoTapScrollMaxSpeedMultiplier: (itemCount?: number) => number;
 /**
  * A custom scrollbar component.
  *

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":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AAIrD,OAAO,EAA8E,KAAK,0BAA0B,EAAE,MAAM,uBAAuB,CAAA;AAiEnJ;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACpC,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mFAAmF;IACnF,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,SAAS,CAAA;IAC/D,4FAA4F;IAC5F,aAAa,CAAC,EAAE;QACZ,qEAAqE;QACrE,oBAAoB,EAAE,MAAM,CAAA;QAC5B,gEAAgE;QAChE,gBAAgB,CAAC,EAAE,MAAM,CAAA;QACzB,4EAA4E;QAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;KACvB,CAAA;CACJ,CAAA;AAaD,qIAAqI;AACrI,eAAO,MAAM,uBAAuB,oCAAoC,CAAA;AAExE;;;;GAIG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC3C,WAAW,EAAE,UAAU,GAAG,YAAY,CAAA;IACtC,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;IACnB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IACzB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAA;IACpB,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAA;IACtB,wIAAwI;IACxI,QAAQ,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,GAAG,CAAC,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IACrH,iFAAiF;IACjF,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,wFAAwF;IACxF,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,qFAAqF;IACrF,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6DAA6D;IAC7D,sBAAsB,CAAC,EAAE,yBAAyB,CAAA;IAClD,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,SAAS,CAAA;IAC3E,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B,CAAA;AAQD;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB;IAClC,mDAAmD;;IAEnD,wBAAwB;;CAElB,CAAA;AAsNV;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAA;IACpB,wBAAwB;IACxB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,wBAAwB;IACxB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,yDAAyD;IACzD,2BAA2B,EAAE,OAAO,CAAA;IACpC,kDAAkD;IAClD,KAAK,CAAC,EAAE;QAAE,oBAAoB,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC5F,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,eAAO,MAAM,qBAAqB,GAAI,qHAAqH,mBAAmB,KAAG,MAuChL,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sCAAsC,GAAI,YAAY,MAAM,WASxE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,iQAiBvB,cAAc,gCAs9BhB,CAAA"}

package/dist/ScrollPane.d.cts

@@ -47,6 +47,22 @@ export type ScrollPaneProps = {
     enableArrowButtons?: boolean;
     /** Whether dragging the content area scrolls the pane. / コンテンツ領域のドラッグでスクロールさせるかどうか。 */
     enablePointerDrag?: boolean;
+    /**
+     * Pointer types allowed to drag-scroll the content area.
+     * コンテンツ領域のドラッグスクロールを許可するポインタ種別。
+     *
+     * 既定は全種別 (`["mouse", "pen", "touch"]`)。
+     *
+     * ❗ **`enablePointerDrag` を丸ごと切ってはならない。** このペインはコンテンツを transform で
+     * 動かしておりネイティブのスクロール領域を持たない (`.aqvs-scroll-pane-content` は
+     * `overflow: hidden`)。ドラッグを無効にするとタッチ端末からスクロール手段が消える。
+     * マウスドラッグだけが困る (テキスト選択やクリック判定と競合する) 場合は、
+     * ここを `["pen", "touch"]` にして**入力種別ごとに**切ること。
+     *
+     * `touch-action: none` は `"touch"` が含まれるときだけ付与する。マウス専用に絞った場合に
+     * タッチのパンまで奪うと、スクロール手段が無いのに操作も奪う最悪の状態になるため。
+     */
+    pointerDragInputs?: readonly ("mouse" | "pen" | "touch")[];
     /** Optional renderer for thumb overlays. / サム付近に表示するオーバーレイのレンダラー。 */
     renderThumbOverlay?: (props: ScrollBarThumbOverlayRenderProps) => React.ReactNode;
     /** Multiplier applied to wheel delta for faster or slower scrolling. / スクロール速度を調整するためのホイールデルタの倍率。 */

package/dist/ScrollPane.d.ts

@@ -47,6 +47,22 @@ export type ScrollPaneProps = {
     enableArrowButtons?: boolean;
     /** Whether dragging the content area scrolls the pane. / コンテンツ領域のドラッグでスクロールさせるかどうか。 */
     enablePointerDrag?: boolean;
+    /**
+     * Pointer types allowed to drag-scroll the content area.
+     * コンテンツ領域のドラッグスクロールを許可するポインタ種別。
+     *
+     * 既定は全種別 (`["mouse", "pen", "touch"]`)。
+     *
+     * ❗ **`enablePointerDrag` を丸ごと切ってはならない。** このペインはコンテンツを transform で
+     * 動かしておりネイティブのスクロール領域を持たない (`.aqvs-scroll-pane-content` は
+     * `overflow: hidden`)。ドラッグを無効にするとタッチ端末からスクロール手段が消える。
+     * マウスドラッグだけが困る (テキスト選択やクリック判定と競合する) 場合は、
+     * ここを `["pen", "touch"]` にして**入力種別ごとに**切ること。
+     *
+     * `touch-action: none` は `"touch"` が含まれるときだけ付与する。マウス専用に絞った場合に
+     * タッチのパンまで奪うと、スクロール手段が無いのに操作も奪う最悪の状態になるため。
+     */
+    pointerDragInputs?: readonly ("mouse" | "pen" | "touch")[];
     /** Optional renderer for thumb overlays. / サム付近に表示するオーバーレイのレンダラー。 */
     renderThumbOverlay?: (props: ScrollBarThumbOverlayRenderProps) => React.ReactNode;
     /** Multiplier applied to wheel delta for faster or slower scrolling. / スクロール速度を調整するためのホイールデルタの倍率。 */

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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"}

package/dist/VirtualScroll.d.cts

@@ -64,6 +64,15 @@ export type VirtualScrollScrollBarOptions = {
 };
 export type VirtualScrollBehaviorOptions = {
     enablePointerDrag?: boolean;
+    /**
+     * Pointer types allowed to drag-scroll the content area (default: all).
+     * コンテンツ領域のドラッグスクロールを許可するポインタ種別 (既定: 全種別)。
+     *
+     * マウスドラッグだけが困る場合に `["pen", "touch"]` を指定する。
+     * `enablePointerDrag` を丸ごと切るとタッチ端末からスクロール手段が消えるため、
+     * 種別で絞れるならこちらを使うこと (`ScrollPaneProps["pointerDragInputs"]` 参照)。
+     */
+    pointerDragInputs?: ScrollPaneProps["pointerDragInputs"];
     enableKeyboardNavigation?: boolean;
     wheelSpeedMultiplier?: number;
     inertiaOptions?: ScrollPaneProps["inertiaOptions"];

package/dist/VirtualScroll.d.ts

@@ -64,6 +64,15 @@ export type VirtualScrollScrollBarOptions = {
 };
 export type VirtualScrollBehaviorOptions = {
     enablePointerDrag?: boolean;
+    /**
+     * Pointer types allowed to drag-scroll the content area (default: all).
+     * コンテンツ領域のドラッグスクロールを許可するポインタ種別 (既定: 全種別)。
+     *
+     * マウスドラッグだけが困る場合に `["pen", "touch"]` を指定する。
+     * `enablePointerDrag` を丸ごと切るとタッチ端末からスクロール手段が消えるため、
+     * 種別で絞れるならこちらを使うこと (`ScrollPaneProps["pointerDragInputs"]` 参照)。
+     */
+    pointerDragInputs?: ScrollPaneProps["pointerDragInputs"];
     enableKeyboardNavigation?: boolean;
     wheelSpeedMultiplier?: number;
     inertiaOptions?: ScrollPaneProps["inertiaOptions"];

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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"}