@aiquants/daily-report 0.20.0 → 0.20.1

package/src/client/streaming/daily-report-ids-stream-session.ts

@@ -1,319 +0,0 @@
-/**
- * Module-resident session and React hook for the daily-report ids stream.
- * 日報 ID ストリームのモジュール常駐セッションと React フック。
- *
- * セッション (クライアント実体 + 完走時刻) をモジュールスコープに置くことで、
- * ページのアンマウント/再マウントをまたいで受信済みデータが生き残り、
- * 再訪時はローディング画面なしで即座に一覧を復元できる。鮮度は
- * 「完走から一定時間経過後の再訪でバックグラウンド再検証」(SWR) で担保する。
- * マウント中のリアルタイム性は SSE が担うため、これで欠落窓は実質「離脱中」のみになる。
- */
-import { useSyncExternalStore } from "react"
-import type { DailyReportItem } from "../../shared/types"
-import { defaultDailyReportClientConfig } from "../config-context"
-import { clearDailyReportCache } from "../hooks/use-daily-report"
-import { DailyReportIdsStreamClient, type DailyReportIdsStreamState } from "./daily-report-ids-stream-client"
-
-/** 完走からこの時間を過ぎた再訪で、バックグラウンド再検証を走らせる。 */
-const REVALIDATE_AFTER_MS = 60_000
-
-/** セッション 1 世代分の記録。 */
-type SessionRecord = {
-    client: DailyReportIdsStreamClient
-    /** セッションの持ち主 (難読化ユーザー ID。未登録ユーザーは null)。 */
-    userKey: string | null
-    /** 正規化済み API ベースパス (既定値解決済み)。 */
-    apiBasePath: string
-    unsubscribe: () => void
-}
-
-let session: SessionRecord | null = null
-
-/** 可視性/フォーカスのリスナーを登録済みか (モジュール寿命で 1 組だけ持つ)。 */
-let freshnessListenersBound = false
-
-/** セッションの生成/破棄とクライアント publish の両方を伝えるリスナー群。 */
-const sessionListeners = new Set<() => void>()
-
-/** セッション未生成時に返す不変スナップショット (SSR の getServerSnapshot も兼ねる)。 */
-const IDLE_STATE: DailyReportIdsStreamState = {
-    items: [],
-    loadedCount: 0,
-    totalCount: null,
-    phase: "idle",
-    isRevalidating: false,
-    hasCompletedOnce: false,
-    completedAt: null,
-    error: null,
-}
-
-/**
- * Full-document reload indirection (mockable seam for auth-expiry tests).
- * ドキュメント全体を再読込する間接層 (認証切れテストで差し替え可能にする継ぎ目)。
- */
-export const reloadDocument = (): void => {
-    if (typeof window !== "undefined") {
-        window.location.reload()
-    }
-}
-
-/** 全セッションリスナーへ変更を通知する。 */
-const notifySessionListeners = (): void => {
-    for (const listener of sessionListeners) {
-        listener()
-    }
-}
-
-/** 現行セッションを破棄する (ユーザー切替・HMR・テストリセット用)。 */
-const destroySession = (): void => {
-    if (!session) return
-    session.unsubscribe()
-    session.client.dispose()
-    session = null
-    notifySessionListeners()
-}
-
-/**
- * Ensures a stream session for the given user, creating/refreshing as needed.
- * 指定ユーザーのストリームセッションを確立する処理 (必要に応じ生成/再検証)。
- *
- * - ユーザーまたは API パスが変わっていれば作り直す (別ユーザーのデータを見せない)。
- * - failed なら自動 retry (再訪 = ユーザーの再試行意思とみなす)。
- * - 完走から {@link REVALIDATE_AFTER_MS} 経過していればバックグラウンド再検証。
- *
- * SSR では何もしない。clientLoader とページマウントの両方から呼ばれ、冪等。
- *
- * @param options.apiBasePath API ベースパス (config の apiBasePath)。
- * @param options.userKey 難読化ユーザー ID (未登録ユーザーは null)。
- */
-export const ensureDailyReportIdsStreamSession = (options: { apiBasePath?: string; userKey: string | null }): void => {
-    if (typeof window === "undefined") return
-
-    // 呼び出し元によって undefined / 既定文字列が混在するため、比較前に必ず正規化する。
-    // 正規化を欠くと clientLoader (undefined) とページ effect (既定文字列) の往復で
-    // セッションが毎回破棄され、モジュール常駐による即時復元が丸ごと無効化される
-    const apiBasePath = options.apiBasePath ?? defaultDailyReportClientConfig.apiBasePath
-
-    if (session && (session.userKey !== options.userKey || session.apiBasePath !== apiBasePath)) {
-        // ユーザーが変わる場合はモジュール常駐の詳細キャッシュも破棄する
-        // (旧ユーザーが閲覧した下書き詳細等が TTL 内の新ユーザーへ供給されるのを防ぐ)
-        if (session.userKey !== options.userKey) {
-            clearDailyReportCache()
-        }
-        destroySession()
-    }
-
-    if (!session) {
-        const client = new DailyReportIdsStreamClient({ apiBasePath })
-        session = {
-            client,
-            userKey: options.userKey,
-            apiBasePath,
-            // 通知はそのままセッションリスナーへ中継する (完走時刻はクライアントが state に刻む)
-            unsubscribe: client.subscribe(notifySessionListeners),
-        }
-        // 再訪以外にも新規走査の起動経路を確保する (可視化復帰 / フォーカス取得)
-        ensureFreshnessListeners()
-        client.start()
-        notifySessionListeners()
-        return
-    }
-
-    runFreshnessCheck(session)
-}
-
-/**
- * Retries a failed session or starts a background revalidation when stale.
- * failed セッションの retry、または鮮度切れ時のバックグラウンド再検証を起動する処理。
- *
- * 再検証が既に走行中 (`isRevalidating`) の間は何もしない。ガードを欠くと、1 回の
- * 再訪で走る複数の確立呼び出し (clientLoader の prime / ensure / ページ effect) が
- * それぞれ走行中の再検証を中断して先頭からやり直し、NDJSON を多重ダウンロードする。
- */
-const runFreshnessCheck = (record: SessionRecord): void => {
-    const state = record.client.getState()
-    if (state.phase === "failed") {
-        record.client.retry()
-        return
-    }
-    if (state.phase === "complete" && !state.isRevalidating && state.completedAt !== null && Date.now() - state.completedAt > REVALIDATE_AFTER_MS) {
-        record.client.refresh()
-    }
-}
-
-/**
- * Registers the visibility/focus listeners that drive freshness checks (idempotent).
- * 鮮度チェックを駆動する可視性/フォーカスリスナーを登録する処理 (冪等)。
- *
- * ❗ これが無いと**新規走査を起動する経路が「再訪 (ナビゲーション)」しか無くなる**。
- * `REVALIDATE_AFTER_MS` はタイマーではなく再訪時の閾値なので、タブを開いたまま放置する
- * という本ページの主要な使われ方では新しい走査が二度と走らず、走査時点の不整合
- * (削除済み行の残留・作成された行の欠落) がセッション中ずっと残り続ける。
- *
- * 定期タイマーは置かない。開いているタブの数だけ全量走査が周期的に走り、サーバー負荷が
- * 利用者の意図と無関係に増える。可視化復帰とフォーカス取得は「利用者が今この画面を見た」
- * という意図そのものであり、頻度も自然に抑えられる (`runFreshnessCheck` 側で完走からの
- * 経過時間と再検証中フラグにより二重に間引かれる)。
- */
-const ensureFreshnessListeners = (): void => {
-    if (freshnessListenersBound || typeof document === "undefined" || typeof window === "undefined") {
-        return
-    }
-    freshnessListenersBound = true
-    // セッション破棄後に発火してもよいよう、ハンドラ側で存在チェックする
-    // (リスナーはモジュール寿命で 1 組だけ持ち、付け外しをしない)
-    const check = (): void => {
-        if (session) {
-            runFreshnessCheck(session)
-        }
-    }
-    document.addEventListener("visibilitychange", () => {
-        if (document.visibilityState === "visible") {
-            check()
-        }
-    })
-    window.addEventListener("focus", check)
-}
-
-/**
- * Bootstraps the session from the clientLoader: create when absent, else reconcile.
- * clientLoader からのセッション起動処理。不在なら生成、既存なら照合と鮮度確認。
- *
- * コールドロードの最重要ゲート対策: 生成をページマウントの effect まで遅らせると、
- * ストリームの最初のバイト要求が「serverLoader 完了 → ハイドレーション → effect flush」
- * の後ろに直列化される。ローダー時点で生成すればハイドレーションと並行してフェッチが走る。
- *
- * パス契約: 生成時のパスは factory オプション (未指定は既定値へ正規化)。
- * `config.apiBasePath` だけを上書きした利用者では初回のみ誤パスで生成されるが、
- * ページマウント側の ensure がパス不一致を検知して作り直す (自己修復・初回 1 回きり)。
- * **既存セッションのパスはここでは照合しない** — 照合すると、factory 未指定 ×
- * config 上書きの組み合わせでナビゲーションごとにセッションが破棄されるスラッシングになる。
- *
- * @param options.apiBasePath 生成時に使う API ベースパス (未指定は既定値)。
- * @param options.userKey 難読化ユーザー ID (未登録ユーザーは null)。
- */
-export const bootstrapDailyReportIdsStreamSession = (options: { apiBasePath?: string; userKey: string | null }): void => {
-    if (typeof window === "undefined") return
-    if (!session) {
-        ensureDailyReportIdsStreamSession(options)
-        return
-    }
-    if (session.userKey !== options.userKey) {
-        // 別ユーザーのデータは描画前に破棄し (詳細キャッシュ含む)、新ユーザーのストリームを即時開始する
-        clearDailyReportCache()
-        destroySession()
-        ensureDailyReportIdsStreamSession(options)
-        return
-    }
-    runFreshnessCheck(session)
-}
-
-/**
- * Kicks a freshness check for an existing session before the user is known.
- * ユーザー確定前に既存セッションの鮮度確認だけを先行させる処理。
- *
- * clientLoader が serverLoader を await する前に呼び、再訪 (支配的経路) の
- * 再検証開始を数十〜数百 ms 前倒しする。セッションが無ければ何もしない
- * (誰のデータを読むべきか分からないため)。直後の reconcile が userKey を照合し、
- * ユーザーが変わっていればセッションごと破棄されるので先行は安全。
- * 走行中の再検証は中断しない (runFreshnessCheck の isRevalidating ガード)。
- */
-export const primeDailyReportIdsStreamSession = (): void => {
-    if (typeof window === "undefined" || !session) return
-    runFreshnessCheck(session)
-}
-
-/**
- * Relays an externally-known item upsert into the resident stream data.
- * 外部由来のアイテム upsert を常駐ストリームデータへ中継する処理。
- *
- * プロバイダーの作成/公開系ミューテーション (ローカル操作と SSE) から呼ばれる。
- * これを欠くと、鮮度窓内の再訪で「作成したばかりの日報が消える」。
- */
-export const upsertDailyReportIdsStreamItem = (item: DailyReportItem): void => {
-    session?.client.applyExternalUpsert(item)
-}
-
-/**
- * Relays an externally-known item removal into the resident stream data.
- * 外部由来のアイテム削除を常駐ストリームデータへ中継する処理。
- *
- * report-delete SSE・ローカル削除・stale 安全弁から呼ばれる。
- * これを欠くと、鮮度窓内の再訪で「削除したはずの日報が蘇る」。
- */
-export const removeDailyReportIdsStreamItem = (reportHubId: number): void => {
-    session?.client.applyExternalRemoval(reportHubId)
-}
-
-/**
- * Restarts a failed stream (UI retry button entry point).
- * failed ストリームを再開する処理 (UI の再試行ボタン入口)。
- */
-export const retryDailyReportIdsStream = (): void => {
-    session?.client.retry()
-}
-
-/**
- * Re-validates the stream, optionally bypassing the server-side cache.
- * ストリームを再検証する処理 (サーバーキャッシュのバイパス指定可)。
- *
- * 開発向けリロード/キャッシュクリアボタンから呼ばれる。
- *
- * @param options.forceRefresh サーバー側 SqlResultCache をバイパスするか。
- */
-export const refreshDailyReportIdsStream = (options: { forceRefresh?: boolean } = {}): void => {
-    session?.client.refresh(options)
-}
-
-/**
- * Returns the current session's owner key (undefined when no session exists).
- * 現行セッションの持ち主 (userKey) を返す処理 (セッション不在時は undefined)。
- *
- * 遅延解決するミューテーション継続の門番に使う。POST /action の待機中にリロード無しの
- * ユーザー切替が起きると、切替時の三重遮断 (セッション破棄 + 詳細キャッシュ破棄 +
- * プロバイダーリマウント) の**後**に旧ユーザーの継続が解決し、モジュール常駐状態
- * (新ユーザーのセッション・詳細キャッシュ) へ旧ユーザーのデータを注入してしまう。
- * 継続側は開始時点の userKey とこの値を比較し、不一致 (undefined 含む) なら
- * モジュール常駐状態への書き込みを放棄する (fail-closed)。
- */
-export const getDailyReportIdsStreamSessionUserKey = (): string | null | undefined => session?.userKey
-
-/** セッション購読 (useSyncExternalStore 用)。 */
-const subscribeSession = (listener: () => void): (() => void) => {
-    sessionListeners.add(listener)
-    return () => sessionListeners.delete(listener)
-}
-
-/** 現在のスナップショットを返す (セッション未生成時は不変の IDLE)。 */
-const getSessionSnapshot = (): DailyReportIdsStreamState => session?.client.getState() ?? IDLE_STATE
-
-/** SSR スナップショット (常に IDLE)。 */
-const getServerSnapshot = (): DailyReportIdsStreamState => IDLE_STATE
-
-/**
- * React binding for the module-resident ids stream session.
- * モジュール常駐 ids ストリームセッションの React バインディング。
- *
- * セッションが後から生成されても再購読なしで追従する (リスナーはセッションではなく
- * モジュールに属する)。スナップショット参照は publish 単位で安定している。
- *
- * @returns Current stream state. 現在のストリーム状態。
- */
-export const useDailyReportIdsStream = (): DailyReportIdsStreamState => {
-    return useSyncExternalStore(subscribeSession, getSessionSnapshot, getServerSnapshot)
-}
-
-/**
- * Destroys the session (test isolation helper).
- * セッションを破棄するテスト用ヘルパー。
- */
-export const resetDailyReportIdsStreamSessionForTesting = (): void => {
-    destroySession()
-}
-
-// HMR: モジュール差し替え時に旧セッションの接続とリスナーを確実に始末する
-if (typeof import.meta !== "undefined" && (import.meta as { hot?: { dispose: (cb: () => void) => void } }).hot) {
-    ;(import.meta as unknown as { hot: { dispose: (cb: () => void) => void } }).hot.dispose(() => {
-        destroySession()
-    })
-}

package/src/client/ui/button.tsx

@@ -1,42 +0,0 @@
-import { Slot } from "@radix-ui/react-slot"
-import { cva, type VariantProps } from "class-variance-authority"
-import * as React from "react"
-import { cn } from "./cn"
-
-const buttonVariants = cva(
-    "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0",
-    {
-        variants: {
-            variant: {
-                default: "bg-primary text-primary-foreground hover:bg-primary/90",
-                destructive: "bg-destructive text-destructive-foreground hover:bg-destructive/90",
-                outline: "border border-input bg-background hover:bg-accent hover:text-accent-foreground",
-                secondary: "bg-secondary text-secondary-foreground hover:bg-secondary/80",
-                ghost: "hover:bg-accent hover:text-accent-foreground",
-                link: "text-primary underline-offset-4 hover:underline",
-            },
-            size: {
-                default: "h-10 px-4 py-2",
-                sm: "h-9 rounded-md px-3",
-                lg: "h-11 rounded-md px-8",
-                icon: "h-10 w-10",
-            },
-        },
-        defaultVariants: {
-            variant: "default",
-            size: "default",
-        },
-    },
-)
-
-export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
-    asChild?: boolean
-}
-
-const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(({ className, variant, size, asChild = false, ...props }, ref) => {
-    const Comp = asChild ? Slot : "button"
-    return <Comp className={cn(buttonVariants({ variant, size, className }))} ref={ref} {...props} />
-})
-Button.displayName = "Button"
-
-export { Button, buttonVariants }

package/src/client/ui/cn.ts

@@ -1,14 +0,0 @@
-/**
- * Tailwind class combiner (clsx + tailwind-merge).
- * Tailwind クラスを結合・重複解決するユーティリティ。
- */
-import { type ClassValue, clsx } from "clsx"
-import { twMerge } from "tailwind-merge"
-
-/**
- * Combines class values and resolves Tailwind conflicts.
- * クラス値を結合し Tailwind の衝突を解決する処理。
- */
-export function cn(...inputs: ClassValue[]) {
-    return twMerge(clsx(inputs))
-}

package/src/client/ui/input.tsx

@@ -1,21 +0,0 @@
-import type * as React from "react"
-
-import { cn } from "./cn"
-
-function Input({ className, type, ...props }: React.ComponentProps<"input">) {
-    return (
-        <input
-            type={type}
-            data-slot="input"
-            className={cn(
-                "flex h-9 w-full min-w-0 rounded-md border border-input bg-transparent px-3 py-1 text-base shadow-xs outline-none transition-[color,box-shadow] selection:bg-primary selection:text-primary-foreground file:inline-flex file:h-7 file:border-0 file:bg-transparent file:font-medium file:text-foreground file:text-sm placeholder:text-muted-foreground disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 md:text-sm dark:bg-input/30",
-                "focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50",
-                "aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40",
-                className,
-            )}
-            {...props}
-        />
-    )
-}
-
-export { Input }

package/src/client/ui/label.tsx

@@ -1,16 +0,0 @@
-import * as LabelPrimitive from "@radix-ui/react-label"
-import type * as React from "react"
-
-import { cn } from "./cn"
-
-function Label({ className, ...props }: React.ComponentProps<typeof LabelPrimitive.Root>) {
-    return (
-        <LabelPrimitive.Root
-            data-slot="label"
-            className={cn("flex select-none items-center gap-2 font-medium text-sm leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-50 group-data-[disabled=true]:pointer-events-none group-data-[disabled=true]:opacity-50", className)}
-            {...props}
-        />
-    )
-}
-
-export { Label }

package/src/client/ui/switch.tsx

@@ -1,19 +0,0 @@
-import * as SwitchPrimitives from "@radix-ui/react-switch"
-import * as React from "react"
-
-import { cn } from "./cn"
-
-const Switch = React.forwardRef<React.ElementRef<typeof SwitchPrimitives.Root>, React.ComponentPropsWithoutRef<typeof SwitchPrimitives.Root>>(({ className, ...props }, ref) => (
-    <SwitchPrimitives.Root
-        className={cn(
-            "peer inline-flex h-6 w-11 shrink-0 cursor-pointer items-center rounded-full border-2 border-transparent transition-colors focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background disabled:cursor-not-allowed disabled:opacity-50 data-[state=checked]:bg-primary data-[state=unchecked]:bg-input",
-            className,
-        )}
-        {...props}
-        ref={ref}>
-        <SwitchPrimitives.Thumb className={cn("pointer-events-none block h-5 w-5 rounded-full bg-background shadow-lg ring-0 transition-transform data-[state=checked]:translate-x-5 data-[state=unchecked]:translate-x-0")} />
-    </SwitchPrimitives.Root>
-))
-Switch.displayName = SwitchPrimitives.Root.displayName
-
-export { Switch }

package/src/client/ui/tabs.tsx

@@ -1,40 +0,0 @@
-import * as TabsPrimitive from "@radix-ui/react-tabs"
-import * as React from "react"
-
-import { cn } from "./cn"
-
-const Tabs = TabsPrimitive.Root
-
-const TabsList = React.forwardRef<React.ElementRef<typeof TabsPrimitive.List>, React.ComponentPropsWithoutRef<typeof TabsPrimitive.List>>(({ className, ...props }, ref) => (
-    <TabsPrimitive.List ref={ref} className={cn("inline-flex h-10 items-center justify-center rounded-md bg-muted p-1 text-muted-foreground", className)} {...props} />
-))
-TabsList.displayName = TabsPrimitive.List.displayName
-
-const TabsTrigger = React.forwardRef<React.ElementRef<typeof TabsPrimitive.Trigger>, React.ComponentPropsWithoutRef<typeof TabsPrimitive.Trigger>>(({ className, ...props }, ref) => (
-    <TabsPrimitive.Trigger
-        ref={ref}
-        className={cn(
-            "inline-flex items-center justify-center whitespace-nowrap rounded-sm px-3 py-1.5 font-medium text-sm ring-offset-background transition-all focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 data-[state=active]:bg-background data-[state=active]:text-foreground data-[state=active]:shadow-2xs",
-            className,
-        )}
-        {...props}
-    />
-))
-TabsTrigger.displayName = TabsPrimitive.Trigger.displayName
-
-// https://github.com/radix-ui/primitives/issues/2359
-const TabsContent = React.forwardRef<React.ElementRef<typeof TabsPrimitive.Content>, React.ComponentPropsWithoutRef<typeof TabsPrimitive.Content>>(({ className, ...props }, ref) => (
-    <TabsPrimitive.Content
-        ref={ref}
-        // forceMount={true} //<=======Add this line
-        className={cn(
-            "data-[state=inactive]:hidden", //<=========Add this line
-            "mt-2 ring-offset-background focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2",
-            className,
-        )}
-        {...props}
-    />
-))
-TabsContent.displayName = TabsPrimitive.Content.displayName
-
-export { Tabs, TabsContent, TabsList, TabsTrigger }

package/src/client/ui/textarea.tsx

@@ -1,19 +0,0 @@
-import type * as React from "react"
-
-import { cn } from "./cn"
-
-function Textarea({ className, ...props }: React.ComponentProps<"textarea">) {
-    return (
-        <textarea
-            data-slot="textarea"
-            className={cn(
-                "flex min-h-15 w-full rounded-md border border-input bg-transparent px-3 py-2 text-base shadow-xs placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:cursor-not-allowed disabled:opacity-50 md:text-sm dark:bg-input/30",
-                "aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40",
-                className,
-            )}
-            {...props}
-        />
-    )
-}
-
-export { Textarea }

package/src/client/utils/constants.spec.ts

@@ -1,96 +0,0 @@
-/**
- * Value-pinning tests for the shared scroll tuning constants.
- * 共有スクロール調整値の値を固定するテスト。
- *
- * ❗ **「共有定数を参照していること」だけを見るテストでは守れない。** 参照はそのままに
- * 値だけを是正前へ戻す変更は、ビューを描画するテストでは検出できない
- * (どちらも同じオブジェクト参照になるため)。ここで値そのものを固定する。
- *
- * `TAP_SCROLL_CIRCLE_OPTIONS` の docstring は「ビューポート 800px での実測表」を
- * 根拠として掲げている。その表をパッケージ本体の `computeTapScrollSpeed` で
- * 実際に再現し、**文書と実装が食い違ったらテストが落ちる**ようにする。
- */
-import { computeTapScrollSpeed, TAP_SCROLL_SPEED_DEFAULTS } from "@aiquants/virtualscroll"
-import { describe, expect, it } from "vitest"
-import { CONTENT_DRAG_POINTER_INPUTS, TAP_SCROLL_CIRCLE_OPTIONS } from "./constants"
-
-/** docstring の実測表が前提とするビューポート。 */
-const VIEWPORT_SIZE = 800
-
-/** 引き幅の基準 (パッケージの既定 `maxVisualDistance`)。 */
-const MAX_DISTANCE = TAP_SCROLL_SPEED_DEFAULTS.maxDistance
-
-/**
- * `ScrollBar` の `minSpeedMultiplier` 既定値。
- *
- * ❗ `TAP_SCROLL_CIRCLE_OPTIONS` は `minSpeedMultiplier` を指定せず既定に委ねている。
- * **値をここへ写さず、パッケージが公開している定数を読む。** 写すと、既定が変わったときに
- * この表が「間違った値のまま緑で通り続ける」状態になる。
- */
-const DEFAULT_MIN_SPEED_MULTIPLIER = TAP_SCROLL_SPEED_DEFAULTS.minSpeedMultiplier
-
-/** タップサークルを `ratio` (0〜1) だけ引いたときの速度 (px/s)。 */
-const speedAt = (ratio: number) =>
-    computeTapScrollSpeed({
-        distance: ratio * MAX_DISTANCE,
-        maxDistance: MAX_DISTANCE,
-        viewportSize: VIEWPORT_SIZE,
-        minSpeedMultiplier: DEFAULT_MIN_SPEED_MULTIPLIER,
-        maxSpeedMultiplier: TAP_SCROLL_CIRCLE_OPTIONS.maxSpeedMultiplier ?? 0,
-        hasCustomMaxSpeedMultiplier: TAP_SCROLL_CIRCLE_OPTIONS.maxSpeedMultiplier !== undefined,
-        curve: TAP_SCROLL_CIRCLE_OPTIONS.maxSpeedCurve,
-    })
-
-describe("TAP_SCROLL_CIRCLE_OPTIONS", () => {
-    it("チューニング値が固定されている", () => {
-        expect(TAP_SCROLL_CIRCLE_OPTIONS.maxSpeedMultiplier).toBe(8)
-        expect(TAP_SCROLL_CIRCLE_OPTIONS.maxSpeedCurve).toEqual({ exponentialSteepness: 3, exponentialScale: 8 })
-    })
-
-    it("easedOffset を使わない (低速域の分解能を下駄で潰さない)", () => {
-        // `easedOffset` は速度レンジ全体に対する比率として引き距離 0 へ適用される。
-        // 0.18 を入れると引き距離 0 で 1,283 px/s (160px 行で毎秒 8 行) から始まってしまう
-        expect(TAP_SCROLL_CIRCLE_OPTIONS.maxSpeedCurve?.easedOffset).toBeUndefined()
-    })
-
-    it("minSpeedMultiplier を指定せずパッケージ既定に委ねている", () => {
-        expect(TAP_SCROLL_CIRCLE_OPTIONS.minSpeedMultiplier).toBeUndefined()
-    })
-
-    it.each([
-        [0, 160],
-        [0.25, 525],
-        [0.5, 1298],
-        [1, 6400],
-    ])("docstring の実測表を再現する (引き %s → 約 %s px/s)", (ratio, expected) => {
-        expect(speedAt(ratio)).toBeCloseTo(expected, 0)
-    })
-
-    it("引き距離に対して狭義単調で、死角 (速度が変わらない区間) が無い", () => {
-        // 旧値 (steepness 7.5 / scale 14) では引き幅の 43.85% が死角だった
-        const samples = Array.from({ length: 101 }, (_, index) => speedAt(index / 100))
-        for (let index = 1; index < samples.length; index += 1) {
-            expect(samples[index], `ratio=${index / 100}`).toBeGreaterThan(samples[index - 1])
-        }
-    })
-
-    it("最高速が 1 フレームでオーバースキャン分を飛び越さない", () => {
-        // 60fps で 1 フレーム 106.7px = 160px 行の 0.67 行。オーバースキャン 15 行に対して十分小さい
-        expect(speedAt(1) / 60).toBeLessThan(160)
-    })
-})
-
-describe("CONTENT_DRAG_POINTER_INPUTS", () => {
-    it("直接操作 (指・ペン) を必ず含む", () => {
-        // ❗ ここが最重要。`ScrollPane` はネイティブのスクロール領域を持たないため、
-        // "touch" を外すとタッチ端末から一覧をスクロールする手段が完全に消える
-        expect(CONTENT_DRAG_POINTER_INPUTS).toContain("touch")
-        expect(CONTENT_DRAG_POINTER_INPUTS).toContain("pen")
-    })
-
-    it("マウスだけを除外する", () => {
-        // マウスのドラッグは行のタップ判定・テキスト選択と競合するため外す
-        expect(CONTENT_DRAG_POINTER_INPUTS).not.toContain("mouse")
-        expect([...CONTENT_DRAG_POINTER_INPUTS]).toEqual(["pen", "touch"])
-    })
-})