@aiquants/virtualscroll 3.6.1 → 3.7.1

package/src/ScrollPane.tsx

@@ -1,6 +1,8 @@
 import { forwardRef, useCallback, useEffect, useId, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState } from "react"
 import { twMerge } from "tailwind-merge"
+import type { VirtualScrollLabelOverrides, VirtualScrollLocale } from "./labels.ts"
 import { Logger } from "./logger.ts"
+import { capturePointer, isPointerCaptured, releaseCapturedPointer } from "./pointerCapture.ts"
 import { ScrollBar, type ScrollBarTapCircleOptions, type ScrollBarThumbOverlayRenderProps, TAP_SCROLL_CANCEL_EVENT } from "./ScrollBar.tsx"
 import { getAxisScale, minmax } from "./utils.ts"
 import { resolveWheelAxes } from "./wheelAxes.ts"
@@ -167,6 +169,20 @@ export type ScrollPaneProps = {
      * `className` / `style` / `ref` を表現できない型にしてあり、この口からレイアウトを壊せない。
      */
     contentProps?: React.AriaAttributes & { id?: string; role?: React.AriaRole }
+    /**
+     * UI chrome locale forwarded to the pane's ScrollBar (arrow aria-labels; default `"en"`).
+     * An unsupported value throws a RangeError at render.
+     * ペインの ScrollBar へ転送する UI クロームロケール (矢印の aria-label、既定 `"en"`)。
+     * 非対応値は描画時に RangeError。
+     */
+    locale?: VirtualScrollLocale
+    /**
+     * Per-key label overrides forwarded to the pane's ScrollBar, laid over the catalog of `locale`.
+     * Unknown keys and blank values throw a RangeError at render.
+     * ペインの ScrollBar へ転送するキー単位のラベル上書き (`locale` のカタログへ重ねる)。
+     * 未知キーと空白値は描画時に RangeError。
+     */
+    labels?: VirtualScrollLabelOverrides
 }
 
 export type ScrollPaneInertiaOptions = {
@@ -332,6 +348,8 @@ export const ScrollPane = forwardRef<ScrollPaneHandle, ScrollPaneProps>(
             renderOverlay,
             initialScrollPosition = 0,
             contentProps,
+            locale,
+            labels,
         },
         ref,
     ) => {
@@ -1116,11 +1134,22 @@ export const ScrollPane = forwardRef<ScrollPaneHandle, ScrollPaneProps>(
             state.velocitySamples = []
             state.scale = 1
             // 状態を確定させてから解放する (同期 lostpointercapture に引き継ぎを壊させない)
-            if (element?.hasPointerCapture(releasedPointerId)) {
-                element.releasePointerCapture(releasedPointerId)
+            if (element !== null) {
+                releaseCapturedPointer(element, releasedPointerId)
             }
         }, [enablePointerDrag, pointerDragInputs, isScrollable])
 
+        /**
+         * Wires the pointer drag-scroll of the content area and tears it down on unmount.
+         * コンテンツ領域のポインタドラッグスクロールを結線し、アンマウント時に解除する処理。
+         *
+         * キャプチャの取得・解放・保持確認はすべて `pointerCapture.ts` の能力判定を通す。
+         * Pointer Capture API の無い環境 (jsdom 等) でもドラッグは `window` のリスナーで追従し、例外は投げない。
+         *
+         * 目的: ドラッグ・慣性・click 抑止のリスナーをコンテンツ要素と `window` へ登録する。
+         * 依存関係: [id]
+         * クリーンアップ: リスナーを外し、保持中のキャプチャを解放してドラッグ状態を初期化する。
+         */
         useEffect(() => {
             const element = contentAreaRef.current
             if (!element) {
@@ -1169,6 +1198,16 @@ export const ScrollPane = forwardRef<ScrollPaneHandle, ScrollPaneProps>(
                 state.shouldCancelNextClick = false
             }
 
+            /**
+             * Confirms the drag once the activation threshold is crossed and moves the capture onto the content area.
+             * 発動閾値を跨いだ時点でドラッグを確定し、キャプチャをコンテンツ領域へ移す処理。
+             *
+             * キャプチャを取れない場合 (非アクティブなポインタ・Pointer Capture API の非対応環境) も
+             * ドラッグは確定させる。追従は `window` の `pointermove` が受け持つため、キャプチャが無くても止まらない。
+             *
+             * @param event The pointer move that crossed the threshold. 閾値を跨いだ pointermove。
+             * @returns Nothing. なし。
+             */
             const startDragging = (event: PointerEvent) => {
                 const state = dragStateRef.current
                 if (state.isDragging) {
@@ -1176,16 +1215,13 @@ export const ScrollPane = forwardRef<ScrollPaneHandle, ScrollPaneProps>(
                 }
                 state.isDragging = true
                 state.shouldCancelNextClick = true
-                if (!element.hasPointerCapture(event.pointerId)) {
+                if (!isPointerCaptured(element, event.pointerId)) {
                     // 注意: キャプチャは pointerdown 時ではなくドラッグ確定時に取得する。
                     // pointerdown で即キャプチャすると click がキャプチャ要素へリターゲットされ、
                     // ペイン内の子要素 (行など) の click ハンドラが一切発火しなくなる (Chromium 実測)。
                     // ドラッグ確定後は shouldCancelNextClick で click を意図的に抑止するため副作用がない。
-                    try {
-                        element.setPointerCapture(event.pointerId)
-                    } catch {
-                        // ポインタが既に非アクティブだと NotFoundError になり得る。キャプチャ無しでもドラッグは継続可能。
-                    }
+                    // 取得に失敗してもキャプチャ無しでドラッグは継続できるため、結果は見ない。
+                    capturePointer(element, event.pointerId)
                 }
                 pushVelocitySample(event.clientY)
             }
@@ -1227,13 +1263,16 @@ export const ScrollPane = forwardRef<ScrollPaneHandle, ScrollPaneProps>(
              */
             const isAuthoritativeForDrag = (event: PointerEvent) => event.isTrusted || event.target === element
 
-            // pointerup を受け取れないままドラッグ継続が不可能になったときの共通終了処理。
-            // Shared teardown for cases where the drag can no longer continue without receiving a pointerup.
+            /**
+             * Shared teardown for cases where the drag can no longer continue without receiving a pointerup.
+             * pointerup を受け取れないままドラッグ継続が不可能になったときの共通終了処理。
+             *
+             * @param pointerId The pointer whose drag is aborted. ドラッグを打ち切るポインタ ID。
+             * @returns Nothing. なし。
+             */
             const abortDrag = (pointerId: number) => {
                 const state = dragStateRef.current
-                if (element.hasPointerCapture(pointerId)) {
-                    element.releasePointerCapture(pointerId)
-                }
+                releaseCapturedPointer(element, pointerId)
                 state.shouldCancelNextClick = false
                 clearClickTimer()
                 resetDragState()
@@ -1320,6 +1359,13 @@ export const ScrollPane = forwardRef<ScrollPaneHandle, ScrollPaneProps>(
                 return true
             }
 
+            /**
+             * Ends the drag on pointerup, arms the click suppression and hands the fling velocity to inertia.
+             * pointerup でドラッグを終え、click 抑止を張り、フリック速度を慣性へ渡す処理。
+             *
+             * @param event The terminal pointerup. 終端の pointerup。
+             * @returns Nothing. なし。
+             */
             const handlePointerUp = (event: PointerEvent) => {
                 const state = dragStateRef.current
                 if (state.pointerId !== event.pointerId) {
@@ -1377,9 +1423,7 @@ export const ScrollPane = forwardRef<ScrollPaneHandle, ScrollPaneProps>(
                 // handleLostPointerCapture は pointerId 不一致で無視されるため、abortDrag による
                 // shouldCancelNextClick / clickResetTimer の破棄 (click 抑止の喪失) が起きない。
                 resetDragState()
-                if (element.hasPointerCapture(event.pointerId)) {
-                    element.releasePointerCapture(event.pointerId)
-                }
+                releaseCapturedPointer(element, event.pointerId)
 
                 if (Math.abs(inertiaVelocity) >= threshold) {
                     startInertiaRef.current?.(inertiaVelocity)
@@ -1541,8 +1585,8 @@ export const ScrollPane = forwardRef<ScrollPaneHandle, ScrollPaneProps>(
                 toggleListeners(element, elementEntries, "remove")
                 toggleListeners(window, windowEntries, "remove")
                 const state = dragStateRef.current
-                if (state.pointerId !== null && element.hasPointerCapture(state.pointerId)) {
-                    element.releasePointerCapture(state.pointerId)
+                if (state.pointerId !== null) {
+                    releaseCapturedPointer(element, state.pointerId)
                 }
                 clearClickTimer()
                 resetDragState()
@@ -1638,6 +1682,8 @@ export const ScrollPane = forwardRef<ScrollPaneHandle, ScrollPaneProps>(
                     renderThumbOverlay={renderThumbOverlay}
                     visibleStartIndex={visibleStartIndex}
                     visibleEndIndex={visibleEndIndex}
+                    locale={locale}
+                    labels={labels}
                 />
                 {renderOverlay?.()}
             </div>

package/src/TapScrollCircle.tsx

@@ -6,6 +6,7 @@
 import type { CSSProperties, ReactNode, PointerEvent as ReactPointerEvent } from "react"
 import { forwardRef, memo, useCallback, useImperativeHandle, useRef, useState } from "react"
 import { twMerge } from "tailwind-merge"
+import { capturePointer, releaseCapturedPointer } from "./pointerCapture.ts"
 
 export type TapScrollCircleDragState = {
     /** Whether the pointer is actively dragging. / ポインターがドラッグ中かどうか。 */
@@ -205,13 +206,20 @@ export const TapScrollCircle = memo(
             [applyDragState, axis],
         )
 
+        /**
+         * Releases the root's capture of the pointer when it holds one.
+         * ルートが指定ポインタのキャプチャを保持していれば解放する処理。
+         *
+         * @param pointerId The pointer to release, or null when no pointer is tracked. 解放するポインタ ID。追跡中のポインタが無ければ null。
+         * @returns Nothing. なし。
+         */
         const releasePointerCapture = useCallback((pointerId: number | null) => {
             if (pointerId === null) {
                 return
             }
             const element = rootRef.current
-            if (element?.hasPointerCapture(pointerId)) {
-                element.releasePointerCapture(pointerId)
+            if (element !== null) {
+                releaseCapturedPointer(element, pointerId)
             }
         }, [])
 
@@ -228,6 +236,15 @@ export const TapScrollCircle = memo(
             [applyDragState, releasePointerCapture],
         )
 
+        /**
+         * Starts a circle drag, or records a second pointer as the hand-off candidate during a drag.
+         * サークルのドラッグを開始する処理。ドラッグ中に押された別ポインタはハンドオフ候補として記録する。
+         *
+         * キャプチャを取得できなくても (非アクティブなポインタ・Pointer Capture API の非対応環境) ドラッグは開始する。
+         *
+         * @param event The pointerdown on the circle. サークル上の pointerdown。
+         * @returns Nothing. なし。
+         */
         const handlePointerDown = useCallback(
             (event: ReactPointerEvent<HTMLDivElement>) => {
                 // ドラッグ中に発生した別ポインター (2 本目のタッチ) は待機候補として記録し、
@@ -246,14 +263,9 @@ export const TapScrollCircle = memo(
                 const { left, top, width, height } = element.getBoundingClientRect()
                 centerRef.current = { x: left + width / 2, y: top + height / 2 }
                 pointerIdRef.current = event.pointerId
-                try {
-                    element.setPointerCapture(event.pointerId)
-                } catch {
-                    // ポインタが既に非アクティブ (ウインドウ外へ出た等) だと setPointerCapture は
-                    // NotFoundError を投げ得る。キャプチャ無しでもドラッグ処理は継続できるため握り潰す。
-                    // setPointerCapture can throw NotFoundError if the pointer is already inactive
-                    // (e.g. moved outside the browser window); dragging still works without capture.
-                }
+                // ポインタが既に非アクティブ (ウインドウ外へ出た等) でも API 非対応でも、
+                // キャプチャ無しでドラッグ処理は継続できるため結果は見ない。
+                capturePointer(element, event.pointerId)
                 updateDragState(event.clientX, event.clientY, true)
             },
             [updateDragState],
@@ -274,6 +286,16 @@ export const TapScrollCircle = memo(
             [updateDragState],
         )
 
+        /**
+         * Ends the circle drag on pointerup, handing control to a live pending pointer when one exists.
+         * pointerup でサークルのドラッグを終える処理。生きている待機候補ポインタがあれば制御を移譲する。
+         *
+         * 候補の生死は `capturePointer` の結果で判定する。`"inactive-pointer"` だけを死とみなし、
+         * API 非対応・それ以外の拒否は生死不明として移譲を続ける。
+         *
+         * @param event The pointerup or pointercancel on the circle. サークル上の pointerup / pointercancel。
+         * @returns Nothing. なし。
+         */
         const handlePointerUp = useCallback(
             (event: ReactPointerEvent<HTMLDivElement>) => {
                 if (pointerIdRef.current !== event.pointerId) {
@@ -296,21 +318,9 @@ export const TapScrollCircle = memo(
                     // pointers, so a dead candidate resets the state instead of getting promoted.
                     releasePointerCapture(event.pointerId)
                     const element = rootRef.current
-                    let candidateAlive = true
-                    if (element !== null && typeof element.setPointerCapture === "function") {
-                        try {
-                            element.setPointerCapture(pending.pointerId)
-                        } catch (error) {
-                            // NotFoundError = 候補ポインタが既に非アクティブ (サークル外で解放済み等)。
-                            // クロスレルム (iframe への portal 等) では DOMException の instanceof が
-                            // false になるため、name ベースで判定する (DOMException も name を持つので包含)。
-                            // それ以外 (キャプチャ未実装環境等) は生死不明のため移譲を継続する。
-                            const errorName = typeof error === "object" && error !== null && "name" in error ? (error as { name?: unknown }).name : undefined
-                            if (errorName === "NotFoundError") {
-                                candidateAlive = false
-                            }
-                        }
-                    }
+                    // NotFoundError (= サークル外で解放済み等) だけが死の証拠。API 非対応やそれ以外の拒否は
+                    // 生死不明のため移譲を継続する (候補を捨てると 2 本目の指が効かなくなる)。
+                    const candidateAlive = element === null || capturePointer(element, pending.pointerId) !== "inactive-pointer"
                     if (candidateAlive) {
                         pointerIdRef.current = pending.pointerId
                         updateDragState(pending.clientX, pending.clientY, true)

package/src/VirtualGrid.tsx

@@ -24,6 +24,7 @@
 import { type CSSProperties, forwardRef, type HTMLAttributes, type ReactNode, useCallback, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState } from "react"
 import { twMerge } from "tailwind-merge"
 import type { TapScrollAxisSpeedParams } from "./computeTapScrollVelocity.ts"
+import type { VirtualScrollLabelOverrides, VirtualScrollLocale } from "./labels.ts"
 import { Logger } from "./logger.ts"
 import { resolveTapScrollCircleOptions, ScrollBar, type ScrollBarTapCircleOptions } from "./ScrollBar.tsx"
 import type { ScrollPaneProps } from "./ScrollPane.tsx"
@@ -216,7 +217,7 @@ export type VirtualGridRange = {
     totalHeight: number
 }
 
-/** Live-region options: the consumer owns wording/locale (no built-in strings — row-parity). / liveRegion オプション: 文言とロケールは消費側所有 (内蔵文字列なし — 行側と同一方針)。 */
+/** Live-region options: the consumer owns announcement wording/locale; the built-in catalog (`locale` / `labels`) covers only the seven chrome strings (arrows, pills, empty state) — row-parity. / liveRegion オプション: 読み上げの文言とロケールは消費側所有。内蔵カタログ (`locale` / `labels`) はクローム 7 文言 (矢印・ピル・空状態) のみ対象 — 行側と同一方針。 */
 export type VirtualGridLiveRegionOptions = {
     /** Builds the announcement (same string = no re-announce, "" clears). / 読み上げ文言の組み立て (同一文字列 = 再読み上げなし、"" でクリア)。 */
     buildMessage: (range: VirtualGridRange) => string
@@ -392,6 +393,21 @@ export type VirtualGridProps<T> = {
     behaviorOptions?: VirtualGridBehaviorOptions
     scrollBarOptions?: VirtualScrollScrollBarOptions
     liveRegion?: VirtualGridLiveRegionOptions
+    /**
+     * UI chrome locale (default `"en"`), forwarded to the embedded vertical VirtualScroll (its
+     * arrows and the 0-row / all-frozen / degenerate-band empty state) and the horizontal bar
+     * arrows. An unsupported value throws a RangeError at render.
+     * UI クロームロケール (既定 `"en"`)。内蔵の縦 VirtualScroll (矢印と 0 行・全行固定・退化帯の
+     * 空状態) と横バーの矢印へ転送。非対応値は描画時に RangeError。
+     */
+    locale?: VirtualScrollLocale
+    /**
+     * Per-key label overrides laid over the catalog of `locale`, forwarded to the same two
+     * surfaces as `locale`. Unknown keys and blank values throw a RangeError at render.
+     * `locale` のカタログへ重ねるキー単位のラベル上書き (`locale` と同じ 2 面へ転送)。
+     * 未知キーと空白値は描画時に RangeError。
+     */
+    labels?: VirtualScrollLabelOverrides
     className?: string
     testId?: string
 }
@@ -749,6 +765,8 @@ const VirtualGridInner = <T,>(
         behaviorOptions,
         scrollBarOptions,
         liveRegion,
+        locale,
+        labels,
         className,
         testId,
     }: VirtualGridProps<T>,
@@ -1910,6 +1928,8 @@ const VirtualGridInner = <T,>(
                     onRangeChange={handleRangeChangeWithLive}
                     onWheelHorizontal={consumeHorizontalDelta}
                     onPanHorizontal={consumeHorizontalDelta}
+                    locale={locale}
+                    labels={labels}
                     testId={testId ? `${testId}-rows` : undefined}>
                     {renderRow}
                 </VirtualScroll>
@@ -1951,6 +1971,8 @@ const VirtualGridInner = <T,>(
                         return applyHxRef.current(typeof request === "function" ? request(previous ?? hxRef.current) : request)
                     }}
                     scrollBarWidth={scrollBarWidth}
+                    locale={locale}
+                    labels={labels}
                 />
             </div>
             {tapCircleEnabled && gridScrollable && (

package/src/VirtualScroll.tsx

@@ -1,4 +1,5 @@
 import React, { forwardRef, type ReactNode, useCallback, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState } from "react"
+import { resolveVirtualScrollLabels, type VirtualScrollLabelOverrides, type VirtualScrollLocale } from "./labels.ts"
 import { Logger } from "./logger.ts"
 import { ScrollPane, type ScrollPaneContentInsets, type ScrollPaneHandle, type ScrollPaneProps } from "./ScrollPane.tsx"
 import { useFenwickMapTree } from "./useFenwickMapTree.ts"
@@ -224,12 +225,13 @@ 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).
+     * the region. The live-region wording and its language are consumer-owned: the package's
+     * built-in catalog (`locale` / `labels`) covers only the seven chrome strings (scrollbar arrow
+     * aria-labels, the scroll-to-edge pills and the empty state), never announcements.
      * 読み上げ文言を組み立てる。可視範囲が静定した後に呼ばれ、前回と同じ文字列なら DOM を
-     * 触らない (再読み上げしない)。`""` を返すとリージョンを空にする。パッケージは文言を
-     * 一切内蔵しない — 言語と文面は消費側の所有物 (汎用パッケージはロケールをハードコード
-     * できない)。
+     * 触らない (再読み上げしない)。`""` を返すとリージョンを空にする。読み上げの文面と言語は
+     * 消費側の所有物 — パッケージの内蔵カタログ (`locale` / `labels`) が扱うのはクローム 7 文言
+     * (スクロールバー矢印の aria-label、端スクロールピル、空状態) だけで、読み上げは対象外。
      *
      * @param range - The settled visible range / 静定した可視範囲
      * @returns Announcement text / 読み上げ文言
@@ -310,6 +312,23 @@ export type VirtualScrollProps<T> = {
      * その場合は `onRangeChange` から自前のリージョンを更新する従来手段を使う。
      */
     liveRegion?: VirtualScrollLiveRegionOptions
+    /**
+     * UI chrome locale of the built-in strings (default `"en"`): the scrollbar arrow aria-labels,
+     * the scroll-to-edge pills and the empty-state text. Live-region wording is not affected (see
+     * {@link VirtualScrollLiveRegionOptions.format}). An unsupported value throws a RangeError at
+     * render; no language negotiation happens.
+     * 内蔵文言 (スクロールバー矢印の aria-label、端スクロールピル、空状態文言) の UI クロームロケール
+     * (既定 `"en"`)。ライブリージョンの文言には影響しない ({@link VirtualScrollLiveRegionOptions.format}
+     * 参照)。非対応値は描画時に RangeError、言語ネゴシエーションなし。
+     */
+    locale?: VirtualScrollLocale
+    /**
+     * Per-key overrides laid over the catalog of `locale`; forwarded to the pane's scrollbar as-is.
+     * Unknown keys and blank values throw a RangeError at render.
+     * `locale` のカタログへ重ねるキー単位の上書き。ペインのスクロールバーへもそのまま転送。
+     * 未知キーと空白値は描画時に RangeError。
+     */
+    labels?: VirtualScrollLabelOverrides
     background?: ReactNode
     children: (item: T, index: number) => ReactNode
     initialScrollIndex?: number
@@ -1023,10 +1042,13 @@ const VirtualScrollInner = <T,>(
         horizontalKeyStep = DEFAULT_HORIZONTAL_KEY_STEP,
         contentProps,
         liveRegion,
+        locale,
+        labels,
     }: VirtualScrollProps<T>,
     ref: React.Ref<VirtualScrollHandle>,
 ) => {
     const { width: scrollBarWidth, enableThumbDrag, enableTrackClick, enableArrowButtons, enableScrollToTopBottomButtons, renderThumbOverlay, tapScrollCircleOptions } = scrollBarOptions ?? {}
+    const resolvedLabels = useMemo(() => resolveVirtualScrollLabels(locale, labels), [locale, labels])
 
     const { enablePointerDrag, pointerDragInputs, enableKeyboardNavigation = true, enableEscapeRowReturn = false, wheelSpeedMultiplier, inertiaOptions, overscrollBehavior, clipItemHeight = false, resetOnGetItemHeightChange = false } = behaviorOptions ?? {}
 
@@ -2168,9 +2190,11 @@ const VirtualScrollInner = <T,>(
     }, [contentSize, renderingEndIndex, renderingStartIndex, resolvedInsets.top, scheduleRangeEffect, scrollPosition, visibleEndIndex, visibleStartIndex])
 
     /**
-     * Renders the auto-hiding Top/Bottom pill overlay, neutralized while hidden.
+     * Renders the auto-hiding top/bottom pill overlay (texts from the resolved `scrollToTop` /
+     * `scrollToBottom` labels), neutralized while hidden.
      *
-     * 自動非表示の Top/Bottom ピルのオーバーレイを描画し、非表示中は無効化する処理。
+     * 自動非表示の先頭/末尾ピルのオーバーレイ (文言は解決済みラベルの `scrollToTop` /
+     * `scrollToBottom`) を描画し、非表示中は無効化する処理。
      *
      * ❗ 非表示は `opacity: 0` で表現するため、要素は DOM に残り続ける (フェードのために
      * アンマウントしない)。`opacity` はフォーカス可能性に影響せず、CSS の `pointer-events: none`
@@ -2213,7 +2237,7 @@ const VirtualScrollInner = <T,>(
                                 scrollToIndex(0)
                                 setShowScrollButtons(false)
                             }}>
-                            Top
+                            {resolvedLabels.scrollToTop}
                         </button>
                     </div>
                 ) : (
@@ -2229,13 +2253,13 @@ const VirtualScrollInner = <T,>(
                                 scrollToIndex(itemCount - 1)
                                 setShowScrollButtons(false)
                             }}>
-                            Bottom
+                            {resolvedLabels.scrollToBottom}
                         </button>
                     </div>
                 )}
             </div>
         )
-    }, [enableScrollToTopBottomButtons, showScrollButtons, scrollDirection, scrollToIndex, itemCount])
+    }, [enableScrollToTopBottomButtons, showScrollButtons, scrollDirection, scrollToIndex, itemCount, resolvedLabels])
 
     // 量子化アンカー (fix: LayoutUnit/f32 精度対策)。行 top はコンテンツ絶対座標そのままではなく
     // 「絶対座標 - アンカー」で描画し、ラッパー側 translateY にアンカーを足し戻す。
@@ -2258,7 +2282,7 @@ const VirtualScrollInner = <T,>(
             return {
                 visibleItems: (
                     <div className="aqvs-no-items-container">
-                        <div className="aqvs-no-items-text">No items</div>
+                        <div className="aqvs-no-items-text">{resolvedLabels.noItems}</div>
                     </div>
                 ),
                 renderAnchor: 0,
@@ -2397,6 +2421,7 @@ const VirtualScrollInner = <T,>(
         registerItemRef,
         renderingEndIndex,
         renderingStartIndex,
+        resolvedLabels,
         updateScrollPositionImmediate,
         visibleStartIndex,
     ])
@@ -2588,7 +2613,9 @@ const VirtualScrollInner = <T,>(
             visibleStartIndex={visibleStartIndex}
             visibleEndIndex={visibleEndIndex}
             renderOverlay={renderOverlay}
-            initialScrollPosition={initialValues.position}>
+            initialScrollPosition={initialValues.position}
+            locale={locale}
+            labels={labels}>
             {renderVisibleItems}
         </ScrollPane>
     )

package/src/index.ts

@@ -6,6 +6,7 @@
  */
 
 export { computeTapScrollVelocity, type TapScrollAxisSpeedParams, type TapScrollVelocityInput } from "./computeTapScrollVelocity.ts"
+export { resolveVirtualScrollLabels, resolveVirtualScrollLocale, VIRTUAL_SCROLL_LABEL_CATALOGS, VIRTUAL_SCROLL_LABEL_KEYS, VIRTUAL_SCROLL_LOCALES, type VirtualScrollLabelOverrides, type VirtualScrollLabels, type VirtualScrollLocale } from "./labels.ts"
 export { createResidualQuantizer, type ResidualQuantizer, type ResidualQuantizerOptions } from "./residualQuantizer.ts"
 export { computeAutoTapScrollMaxSpeedMultiplier, computeTapScrollSpeed, ScrollBar, type ScrollBarProps, type ScrollBarTapCircleOptions, type ScrollBarThumbOverlayRenderProps, TAP_SCROLL_SPEED_DEFAULTS, type TapScrollSpeedInput } from "./ScrollBar.tsx"
 export { ScrollPane, type ScrollPaneContentInsets, type ScrollPaneHandle, type ScrollPaneInertiaOptions, type ScrollPaneProps } from "./ScrollPane.tsx"