@aiquants/daily-report 0.11.0 → 0.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiquants/daily-report",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Reusable daily-report feature package: shared types/schemas, React (Router v7) UI with virtual scrolling + optimistic updates + SSE sync, and a drizzle (mssql) server layer with DI ports (auth, user resolution, redis, external sources).",
   "sideEffects": [
     "**/*.css"
@@ -70,10 +70,10 @@
     "tailwindcss-animate": "^1.0.7",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.8",
+    "vitest": "^4.1.10",
     "zod": "^3.25.76",
     "@aiquants/swipe-overlay": "1.2.4",
-    "@aiquants/virtualscroll": "1.24.0"
+    "@aiquants/virtualscroll": "1.25.0"
   },
   "peerDependencies": {
     "drizzle-orm": ">=1.0.0-beta.4 <2.0.0",
@@ -82,7 +82,7 @@
     "react-router": "^7.0.0",
     "zod": ">=3.25.0 <5.0.0",
     "@aiquants/swipe-overlay": "^1.2.4",
-    "@aiquants/virtualscroll": "^1.24.0"
+    "@aiquants/virtualscroll": "^1.25.0"
   },
   "peerDependenciesMeta": {
     "drizzle-orm": {

package/src/client/components/daily-report-detail-list.tsx

@@ -83,14 +83,18 @@ const formatInterviewerLabel = (interviewer: DailyReportDetail["interviewers"][n
  * Scroll restore slot for DailyReportDetailList that survives tab unmounting.
  * タブアンマウントをまたいで DailyReportDetailList のスクロール位置を持ち回る共有スロット。
  *
- * offset は VirtualScroll の論理座標。anchorReportHubId は「その offset を記録した時点の
- * 選択日報」。復元はアンカーが現在の選択と一致するときだけ行う: 選択が他ビューで変わって
- * いたら、復元よりも「選択日報へのスクロール」(既存 UX) を優先する。
- * measuredHeights は実測カード高さ (reportHubId → px)。ピクセル復元は「保存時と同じ高さ
- * 空間」でだけ正しいため、実測をアンマウント越しに持ち回って座標空間を保存する。
+ * topItem は先頭可視カードの**同一性アンカー** (reportHubId + 行内オフセット px + 保存時 index)。
+ * ❗ 生の論理 px を保存してはならない: 可変高さでは px→行変換が再マウントの推定空間で行われ、
+ * 深い位置で別のカードに着地する (実機で確定した実害バグ)。同一性アンカーは一覧が留守中に
+ * 変わっても findIndex で正しいカードへ再解決される。index は該当カードが消えていたときの
+ * 近似フォールバック。offsetPx はカード上端がビューポート上端より上に隠れている px (論理座標)。
+ * anchorReportHubId は「記録時点の選択日報」。復元はこれが現在の選択と一致するときだけ行う:
+ * 選択が他ビューで変わっていたら、復元よりも「選択日報へのスクロール」(既存 UX) を優先する。
+ * measuredHeights は実測カード高さ (reportHubId → px)。着地窓の行内オフセットの厳密さと
+ * 総高さ推定の質を保つため、実測をアンマウント越しに持ち回る。
  */
 export type DailyReportDetailListScrollRestore = {
-    offset: number
+    topItem: { reportHubId: number; index: number; offsetPx: number } | null
     anchorReportHubId: number | null
     measuredHeights: Map<number, number>
 }
@@ -112,16 +116,25 @@ type DailyReportDetailListProps = {
  * 動的高さの仮想スクロールで日報詳細カードを描画するコンポーネント。
  */
 export const DailyReportDetailList = ({ dailyReportItems, userId, selectedItemId, onSelectItem, scrollRestoreRef }: DailyReportDetailListProps) => {
-    // 復元位置と「復元マウントかどうか」はマウント時に一度だけ共有スロットから決める。
-    // 復元判定はアンカー (記録時の選択日報) の一致のみで行う。❗ `offset > 0` を復元判定に
-    // 流用してはならない: 先頭 (論理 0) まで戻してからタブを離れた復元マウントが「非復元」に
-    // 誤分類され、初回の選択スクロールが復元位置 (先頭) を上書きしてしまう
-    const [{ offset: initialScrollOffset, restored: isRestoredMount }] = useState(() => {
+    // 復元アンカーと「復元マウントかどうか」はマウント時に一度だけ共有スロットから決める。
+    // 復元判定は選択アンカー (記録時の選択日報) の一致のみで行う。❗ 位置の有無や大小を復元
+    // 判定に流用してはならない: 先頭まで戻してからタブを離れた復元マウントが「非復元」に
+    // 誤分類され、初回の選択スクロールが復元位置 (先頭) を上書きしてしまう。
+    // topItem は reportHubId の同一性で現在の一覧へ再解決する (留守中の並び替え・挿入に不変)。
+    // 消えていたら保存時 index への近似フォールバック (行内オフセットは破棄 = カード上端合わせ)
+    const [{ initialScrollAnchor, restored: isRestoredMount }] = useState(() => {
         const restore = scrollRestoreRef?.current
-        if (restore && restore.anchorReportHubId === (selectedItemId ?? null)) {
-            return { offset: restore.offset, restored: true }
+        if (!restore || restore.anchorReportHubId !== (selectedItemId ?? null)) {
+            return { initialScrollAnchor: undefined, restored: false }
         }
-        return { offset: 0, restored: false }
+        if (!restore.topItem) {
+            return { initialScrollAnchor: undefined, restored: true }
+        }
+        const foundIndex = dailyReportItems.findIndex((item) => item.reportHubId === restore.topItem?.reportHubId)
+        if (foundIndex !== -1) {
+            return { initialScrollAnchor: { index: foundIndex, offsetPx: restore.topItem.offsetPx }, restored: true }
+        }
+        return { initialScrollAnchor: { index: restore.topItem.index, offsetPx: 0 }, restored: true }
     })
     // 復元マウントの初回だけ「選択日報へのスクロール」をスキップするための武装フラグと、
     // 消費条件 (マウント時と同じ選択であること) の基準値。
@@ -133,13 +146,10 @@ export const DailyReportDetailList = ({ dailyReportItems, userId, selectedItemId
     // 実測高さは ref にインプレースで持つ。以前は測定行ごとに `new Map(prev)` を作っており
     // 行数に対して O(n^2) だった。VirtualScroll へは updateItemSize で個別に伝えるため、
     // ここで state を持って再レンダーを起こす必要はない (getItemHeight は ref を直接読む)。
-    // ❗ 共有スロットがあればその Map を使う (アンマウントで実測空間を捨てない): ピクセル
-    // 復元は「保存時と同じ高さ空間」に近いほど正しい。ローカル Map で作り直すと全カードが
-    // 既定高さ推定に戻り、同じ offset が別のカード位置に着地する。
-    // 既知の限界: VirtualScroll の Fenwick 具現化はマウント時サンプル窓 (先頭約 51 行) に
-    // 限られるため、それより深く実測してからの復元は具現化されない行が推定値で寄与し、
-    // カード単位の漂着が残り得る (一覧 100 件超 + 51 枚超を連続実測した深い復元のみ。
-    // 恒久解は index アンカー復元 API — virtualscroll 側のフォローアップ設計を参照)
+    // ❗ 共有スロットがあればその Map を使う (アンマウントで実測空間を捨てない): 同一性アンカー
+    // 復元の下で、実測の持ち回りは (a) アンカーカードの行内オフセットの厳密さ (そのカードの
+    // 実測高さが行内 px の座標系そのもの) と (b) 総高さ推定・周辺カードの初期配置の質を保つ。
+    // カードの同一性は topItem (reportHubId) が保証するため、深い復元でも別カードへは漂着しない
     const itemHeightsRef = useRef<Map<number, number>>(scrollRestoreRef?.current.measuredHeights ?? new Map())
     const scrollContainerRef = useRef<HTMLDivElement | null>(null)
     const virtualScrollRef = useRef<VirtualScrollHandle>(null)
@@ -264,36 +274,48 @@ export const DailyReportDetailList = ({ dailyReportItems, userId, selectedItemId
         [getItem, itemCount, schedulePrefetchForRange],
     )
 
-    const handleScroll = useCallback(
-        (position: number) => {
-            // onScroll が配信する論理座標をそのまま共有スロットへ書く (保存と復元で座標系を一致させる)。
-            // ❗ getScrollPosition() の読み戻しへ戻さないこと: あれはペイン座標 (inset 込み) で、
-            // 論理座標を受け取る initialScrollOffset との往復ごとに inset 分ずれる
-            const restore = scrollRestoreRef?.current
-            if (restore) {
-                restore.offset = position
+    // ❗ teardown 用ハンドルミラー: React は削除コミットの mutation phase で virtualScrollRef を
+    // null 化するため、アンマウント時の RAF flush (最終 onScroll 配信) の時点では素の ref が
+    // 読めない。最後に観測した非 null ハンドルを保持し、フリング中のタブ切替でも最終アンカーを
+    // 取りこぼさない (closure 経由の読取は detach 後も直近コミットの値で安全)
+    const lastVirtualScrollHandleRef = useRef<VirtualScrollHandle | null>(null)
+
+    const handleScroll = useCallback(() => {
+        // スクロールのたびに先頭可視カードの同一性アンカーを共有スロットへ書き戻す。
+        // ❗ 生の論理 px (onScroll 引数や getScrollPosition) を保存してはならない:
+        // 可変高さでは再マウントの推定空間で px→行変換が狂い、別のカードに着地する。
+        // getScrollAnchor は可視ウィンドウの実測が照合済みのツリーで計算されるため常に正確
+        if (virtualScrollRef.current) {
+            lastVirtualScrollHandleRef.current = virtualScrollRef.current
+        }
+        const restore = scrollRestoreRef?.current
+        const handle = virtualScrollRef.current ?? lastVirtualScrollHandleRef.current
+        if (restore && handle) {
+            const anchor = handle.getScrollAnchor()
+            const item = anchor ? dailyReportItemsRef.current[anchor.index] : undefined
+            if (anchor && item) {
+                restore.topItem = { reportHubId: item.reportHubId, index: anchor.index, offsetPx: anchor.offsetPx }
             }
+        }
 
-            const container = scrollContainerRef.current
-            if (!container) return
+        const container = scrollContainerRef.current
+        if (!container) return
 
-            if (container.dataset.scrolling !== "true") {
-                container.dataset.scrolling = "true"
-            }
+        if (container.dataset.scrolling !== "true") {
+            container.dataset.scrolling = "true"
+        }
 
-            if (scrollEndTimerRef.current) {
-                clearTimeout(scrollEndTimerRef.current)
-            }
+        if (scrollEndTimerRef.current) {
+            clearTimeout(scrollEndTimerRef.current)
+        }
 
-            scrollEndTimerRef.current = setTimeout(() => {
-                if (container) {
-                    delete container.dataset.scrolling
-                }
-                scrollEndTimerRef.current = null
-            }, 150)
-        },
-        [scrollRestoreRef],
-    )
+        scrollEndTimerRef.current = setTimeout(() => {
+            if (container) {
+                delete container.dataset.scrolling
+            }
+            scrollEndTimerRef.current = null
+        }, 150)
+    }, [scrollRestoreRef])
 
     const renderThumbOverlay = useCallback((props: ScrollBarThumbOverlayRenderProps) => <BusinessDayThumbOverlay {...props} label={overlayLabel} isWheelScrollActive={isWheelScrollActive} />, [overlayLabel, isWheelScrollActive])
 
@@ -387,7 +409,7 @@ export const DailyReportDetailList = ({ dailyReportItems, userId, selectedItemId
                     getItemKey={getItemKey}
                     getItemHeight={getItemHeight}
                     viewportSize={viewportHeight}
-                    initialScrollOffset={initialScrollOffset}
+                    initialScrollAnchor={initialScrollAnchor}
                     overscanCount={VIRTUAL_SCROLL_OVERSCAN_COUNT}
                     scrollBarOptions={{
                         width: SCROLL_BAR_WIDTH,

package/src/client/components/daily-report-resolved-content.tsx

@@ -42,7 +42,7 @@ export const DailyReportResolvedContent = ({ userId }: DailyReportResolvedConten
     // タブは非制御でこのコンポーネントはタブ切替時に再レンダーされないため、レンダー時読取は
     // 古い値の焼き込みになる (タブ復帰でスクロール位置がリセットされた実害バグの根本原因)
     const listScrollOffsetRef = useRef<number>(0)
-    const detailListScrollRestoreRef = useRef<DailyReportDetailListScrollRestore>({ offset: 0, anchorReportHubId: null, measuredHeights: new Map() })
+    const detailListScrollRestoreRef = useRef<DailyReportDetailListScrollRestore>({ topItem: null, anchorReportHubId: null, measuredHeights: new Map() })
 
     // 選択状態の管理 (タブ間で共有)
     const [selectedItemId, setSelectedItemId] = useState<number | null>(() => {

package/src/client/components/daily-report-scroll-restoration.spec.tsx

@@ -25,6 +25,7 @@ import type { DailyReportDetail, DailyReportItem } from "../../shared/types"
 type CapturedProps = {
     testId?: string
     initialScrollOffset?: number
+    initialScrollAnchor?: { index: number; offsetPx?: number }
     onScroll?: (position: number, totalHeight: number) => void
     getItemHeight?: (index: number) => number
 }
@@ -32,6 +33,8 @@ type CapturedProps = {
 const captured: CapturedProps[] = []
 /** 代役の命令ハンドル経由で観測した scrollToIndex 呼び出し。 */
 const scrollToIndexCalls: Array<{ testId?: string; index: number }> = []
+/** 代役の getScrollAnchor が返す値 (テストごとに差し替える)。 */
+let scriptedAnchor: { index: number; offsetPx: number } | null = { index: 0, offsetPx: 0 }
 
 /**
  * Stand-in for VirtualScroll that renders every item and records scroll wiring.
@@ -51,12 +54,20 @@ vi.mock("@aiquants/virtualscroll", async () => {
                 } & CapturedProps,
                 ref: React.Ref<unknown>,
             ) => {
-                captured.push({ testId: props.testId, initialScrollOffset: props.initialScrollOffset, onScroll: props.onScroll, getItemHeight: (props as { getItemHeight?: (index: number) => number }).getItemHeight })
+                captured.push({
+                    testId: props.testId,
+                    initialScrollOffset: props.initialScrollOffset,
+                    initialScrollAnchor: (props as CapturedProps).initialScrollAnchor,
+                    onScroll: props.onScroll,
+                    getItemHeight: (props as { getItemHeight?: (index: number) => number }).getItemHeight,
+                })
                 useHandle(ref, () => ({
                     scrollTo: () => 0,
                     scrollToIndex: (index: number) => {
                         scrollToIndexCalls.push({ testId: props.testId, index })
                     },
+                    // テストごとに scriptedAnchor で差し替える (handleScroll の保存経路の検証用)
+                    getScrollAnchor: () => scriptedAnchor,
                     getScrollPosition: () => 0,
                     getContentSize: () => 0,
                     getViewportSize: () => 0,
@@ -171,6 +182,7 @@ const allOf = (testId: string) => captured.filter((entry) => entry.testId === te
 beforeEach(() => {
     captured.length = 0
     scrollToIndexCalls.length = 0
+    scriptedAnchor = { index: 0, offsetPx: 0 }
     contextItemsRef.current = []
     vi.stubGlobal(
         "ResizeObserver",
@@ -217,56 +229,56 @@ describe("DailyReportList のスクロール共有スロット", () => {
     })
 })
 
-describe("DailyReportDetailList のアンカー付き復元", () => {
-    it("アンカーが現在の選択と一致すれば復元し、初回の選択スクロールはスキップする", () => {
-        const restoreRef = { current: { offset: 900, anchorReportHubId: 42, measuredHeights: new Map<number, number>() } }
+describe("DailyReportDetailList の同一性アンカー復元", () => {
+    const cfg = { apiBasePath: "/daily_report/api", fieldLabels: { attachments: "添付ファイル", attachmentMissing: "実体が見つかりません", attachmentDownload: "ダウンロード" } }
+    const slot = (over: Partial<{ topItem: { reportHubId: number; index: number; offsetPx: number } | null; anchorReportHubId: number | null }> = {}) => ({
+        current: { topItem: null as { reportHubId: number; index: number; offsetPx: number } | null, anchorReportHubId: null as number | null, measuredHeights: new Map<number, number>(), ...over },
+    })
+
+    it("選択アンカー一致なら topItem を同一性で再解決して復元し、初回の選択スクロールはスキップする", () => {
+        const restoreRef = slot({ topItem: { reportHubId: 41, index: 0, offsetPx: 137 }, anchorReportHubId: 42 })
         renderView(<DailyReportDetailList dailyReportItems={[buildItem(41), buildItem(42)]} selectedItemId={42} scrollRestoreRef={restoreRef} />)
-        expect(latestOf("daily-report-detail-list").initialScrollOffset).toBe(900)
-        // 復元マウントでは scrollToIndex(選択) が走らない (復元位置の上書き防止)
+        expect(latestOf("daily-report-detail-list").initialScrollAnchor).toEqual({ index: 0, offsetPx: 137 })
         expect(scrollToIndexCalls.filter((c) => c.testId === "daily-report-detail-list")).toEqual([])
     })
 
-    it("復元マウント後の選択変更では従来どおり選択日報へスクロールする (スキップは 1 回だけ)", () => {
-        const restoreRef = { current: { offset: 900, anchorReportHubId: 42, measuredHeights: new Map<number, number>() } }
-        const items = [buildItem(41), buildItem(42)]
-        const view = renderView(<DailyReportDetailList dailyReportItems={items} selectedItemId={42} scrollRestoreRef={restoreRef} />)
-        view.rerender(
-            <DailyReportConfigProvider config={{ apiBasePath: "/daily_report/api", fieldLabels: { attachments: "添付ファイル", attachmentMissing: "実体が見つかりません", attachmentDownload: "ダウンロード" } }}>
-                <DailyReportDetailList dailyReportItems={items} selectedItemId={41} scrollRestoreRef={restoreRef} />
-            </DailyReportConfigProvider>,
-        )
-        expect(scrollToIndexCalls.filter((c) => c.testId === "daily-report-detail-list")).toEqual([{ testId: "daily-report-detail-list", index: 0 }])
-        // アンカー同期の副作用が選択変更を追従する
-        expect(restoreRef.current.anchorReportHubId).toBe(41)
+    it("留守中に一覧が並び替わっても、topItem は reportHubId の同一性で新しい index へ再解決される", () => {
+        // 保存時: カード 41 が index 0。復帰時: 先頭に 43 が挿入され 41 は index 1 へ移動
+        const restoreRef = slot({ topItem: { reportHubId: 41, index: 0, offsetPx: 137 }, anchorReportHubId: 42 })
+        renderView(<DailyReportDetailList dailyReportItems={[buildItem(43), buildItem(41), buildItem(42)]} selectedItemId={42} scrollRestoreRef={restoreRef} />)
+        expect(latestOf("daily-report-detail-list").initialScrollAnchor).toEqual({ index: 1, offsetPx: 137 })
     })
 
-    it("アンカーが選択と不一致なら復元せず、従来どおり選択日報へスクロールする", () => {
-        const restoreRef = { current: { offset: 900, anchorReportHubId: 41, measuredHeights: new Map<number, number>() } }
+    it("topItem のカードが留守中に消えていたら、保存時 index への近似フォールバック (行内オフセットは破棄)", () => {
+        const restoreRef = slot({ topItem: { reportHubId: 99, index: 1, offsetPx: 137 }, anchorReportHubId: 42 })
         renderView(<DailyReportDetailList dailyReportItems={[buildItem(41), buildItem(42)]} selectedItemId={42} scrollRestoreRef={restoreRef} />)
-        expect(latestOf("daily-report-detail-list").initialScrollOffset).toBe(0)
-        expect(scrollToIndexCalls.filter((c) => c.testId === "daily-report-detail-list")).toEqual([{ testId: "daily-report-detail-list", index: 1 }])
+        expect(latestOf("daily-report-detail-list").initialScrollAnchor).toEqual({ index: 1, offsetPx: 0 })
+        // 復元マウント扱いなので初回の選択スクロールはスキップされる
+        expect(scrollToIndexCalls.filter((c) => c.testId === "daily-report-detail-list")).toEqual([])
     })
 
-    it("アンカー一致かつ offset 0 の復元マウントでも初回の選択スクロールをスキップする (先頭復元の上書き防止)", () => {
-        // 復元判定は「アンカー一致」であって「offset > 0」ではない: 先頭まで戻してから
-        // タブを離れた場合も復元マウントであり、選択日報へ跳んではならない
-        const restoreRef = { current: { offset: 0, anchorReportHubId: 42, measuredHeights: new Map<number, number>() } }
+    it("先頭 (topItem が行 0 の offsetPx 0) の復元でも復元マウント扱いで、選択スクロールが先頭を上書きしない", () => {
+        const restoreRef = slot({ topItem: { reportHubId: 41, index: 0, offsetPx: 0 }, anchorReportHubId: 42 })
         renderView(<DailyReportDetailList dailyReportItems={[buildItem(41), buildItem(42)]} selectedItemId={42} scrollRestoreRef={restoreRef} />)
-        expect(latestOf("daily-report-detail-list").initialScrollOffset).toBe(0)
+        expect(latestOf("daily-report-detail-list").initialScrollAnchor).toEqual({ index: 0, offsetPx: 0 })
         expect(scrollToIndexCalls.filter((c) => c.testId === "daily-report-detail-list")).toEqual([])
     })
 
-    it("アンカー日報がアンマウント中に消えていても、次の正当な選択変更のスクロールを飲み込まない", () => {
-        // 武装したままの skip フラグが「解決できないアンカー」で残留し、その後の選択変更
-        // (新規作成ボタン等) を 1 回無言で飲み込む退行の検知。武装解除して通常スクロールする
-        const restoreRef = { current: { offset: 900, anchorReportHubId: 42, measuredHeights: new Map<number, number>() } }
-        const items = [buildItem(41), buildItem(43)] // 42 は削除済み
+    it("選択アンカー不一致なら復元せず、従来どおり選択日報へスクロールする", () => {
+        const restoreRef = slot({ topItem: { reportHubId: 41, index: 0, offsetPx: 900 }, anchorReportHubId: 41 })
+        renderView(<DailyReportDetailList dailyReportItems={[buildItem(41), buildItem(42)]} selectedItemId={42} scrollRestoreRef={restoreRef} />)
+        expect(latestOf("daily-report-detail-list").initialScrollAnchor).toBeUndefined()
+        expect(scrollToIndexCalls.filter((c) => c.testId === "daily-report-detail-list")).toEqual([{ testId: "daily-report-detail-list", index: 1 }])
+    })
+
+    it("消えたアンカー選択の復元でも、次の正当な選択変更のスクロールを飲み込まない", () => {
+        const restoreRef = slot({ topItem: { reportHubId: 41, index: 0, offsetPx: 900 }, anchorReportHubId: 42 })
+        const items = [buildItem(41), buildItem(43)] // 選択 42 は削除済み
         const view = renderView(<DailyReportDetailList dailyReportItems={items} selectedItemId={42} scrollRestoreRef={restoreRef} />)
-        expect(latestOf("daily-report-detail-list").initialScrollOffset).toBe(900)
         expect(scrollToIndexCalls.filter((c) => c.testId === "daily-report-detail-list")).toEqual([])
 
         view.rerender(
-            <DailyReportConfigProvider config={{ apiBasePath: "/daily_report/api", fieldLabels: { attachments: "添付ファイル", attachmentMissing: "実体が見つかりません", attachmentDownload: "ダウンロード" } }}>
+            <DailyReportConfigProvider config={cfg}>
                 <DailyReportDetailList dailyReportItems={items} selectedItemId={43} scrollRestoreRef={restoreRef} />
             </DailyReportConfigProvider>,
         )
@@ -274,11 +286,11 @@ describe("DailyReportDetailList のアンカー付き復元", () => {
     })
 
     it("null アンカーの復元マウントでも、最初の選択確定のスクロールを飲み込まない", () => {
-        const restoreRef = { current: { offset: 900, anchorReportHubId: null, measuredHeights: new Map<number, number>() } }
+        const restoreRef = slot({ topItem: { reportHubId: 41, index: 0, offsetPx: 900 }, anchorReportHubId: null })
         const items = [buildItem(41), buildItem(42)]
         const view = renderView(<DailyReportDetailList dailyReportItems={items} selectedItemId={null} scrollRestoreRef={restoreRef} />)
         view.rerender(
-            <DailyReportConfigProvider config={{ apiBasePath: "/daily_report/api", fieldLabels: { attachments: "添付ファイル", attachmentMissing: "実体が見つかりません", attachmentDownload: "ダウンロード" } }}>
+            <DailyReportConfigProvider config={cfg}>
                 <DailyReportDetailList dailyReportItems={items} selectedItemId={41} scrollRestoreRef={restoreRef} />
             </DailyReportConfigProvider>,
         )
@@ -286,15 +298,12 @@ describe("DailyReportDetailList のアンカー付き復元", () => {
     })
 
     it("復元スキップの消費は「スクロール済み」として記録され、直後の items 参照更新で復元が壊れない", () => {
-        // skip 消費時に lastScrolledRef を記録しないと、次の items 配列更新 (SSE チャンク等) で
-        // 効果が再実行され、消費済みフラグの保護が無いまま選択スクロールが復元位置を上書きする
-        const restoreRef = { current: { offset: 900, anchorReportHubId: 42, measuredHeights: new Map<number, number>() } }
+        const restoreRef = slot({ topItem: { reportHubId: 41, index: 0, offsetPx: 900 }, anchorReportHubId: 42 })
         const view = renderView(<DailyReportDetailList dailyReportItems={[buildItem(41), buildItem(42)]} selectedItemId={42} scrollRestoreRef={restoreRef} />)
         expect(scrollToIndexCalls.filter((c) => c.testId === "daily-report-detail-list")).toEqual([])
 
-        // 同一内容・新しい配列 identity で再レンダー (ストリーム更新の最小モデル)
         view.rerender(
-            <DailyReportConfigProvider config={{ apiBasePath: "/daily_report/api", fieldLabels: { attachments: "添付ファイル", attachmentMissing: "実体が見つかりません", attachmentDownload: "ダウンロード" } }}>
+            <DailyReportConfigProvider config={cfg}>
                 <DailyReportDetailList dailyReportItems={[buildItem(41), buildItem(42)]} selectedItemId={42} scrollRestoreRef={restoreRef} />
             </DailyReportConfigProvider>,
         )
@@ -302,25 +311,19 @@ describe("DailyReportDetailList のアンカー付き復元", () => {
     })
 
     it("不一致経路の武装解除は恒久: 後からマウント時と同じ選択へ戻っても飲み込まない", () => {
-        // 武装解除を「一致分岐の中」へ動かす退行 (不一致では解除されない) の検知。
-        // 不一致で解除されないと、後でマウント時選択と同じ値へ選択が戻ったときに
-        // 残留フラグが消費され、正当なスクロールを 1 回飲み込む
-        const restoreRef = { current: { offset: 900, anchorReportHubId: 42, measuredHeights: new Map<number, number>() } }
-        const config = { apiBasePath: "/daily_report/api", fieldLabels: { attachments: "添付ファイル", attachmentMissing: "実体が見つかりません", attachmentDownload: "ダウンロード" } }
+        const restoreRef = slot({ topItem: { reportHubId: 41, index: 0, offsetPx: 900 }, anchorReportHubId: 42 })
         const view = renderView(<DailyReportDetailList dailyReportItems={[buildItem(41), buildItem(43)]} selectedItemId={42} scrollRestoreRef={restoreRef} />)
 
-        // 不一致の選択変更 → 武装解除してスクロール (既存テストと同じ前段)
         view.rerender(
-            <DailyReportConfigProvider config={config}>
+            <DailyReportConfigProvider config={cfg}>
                 <DailyReportDetailList dailyReportItems={[buildItem(41), buildItem(43)]} selectedItemId={43} scrollRestoreRef={restoreRef} />
             </DailyReportConfigProvider>,
         )
         expect(scrollToIndexCalls.filter((c) => c.testId === "daily-report-detail-list")).toEqual([{ testId: "daily-report-detail-list", index: 1 }])
 
-        // アンカー日報が復活し、マウント時と同じ 42 を選択 → 解除済みなので通常どおりスクロールする
         const revived = [buildItem(41), buildItem(43), buildItem(42)]
         view.rerender(
-            <DailyReportConfigProvider config={config}>
+            <DailyReportConfigProvider config={cfg}>
                 <DailyReportDetailList dailyReportItems={revived} selectedItemId={42} scrollRestoreRef={restoreRef} />
             </DailyReportConfigProvider>,
         )
@@ -331,21 +334,57 @@ describe("DailyReportDetailList のアンカー付き復元", () => {
     })
 
     it("実測カード高さは共有スロットの Map をそのまま使い、アンマウント越しに座標空間を保存する", () => {
-        // ピクセル復元は「保存時と同じ高さ空間」でだけ正しい。スロットの Map が
-        // getItemHeight へ直結していること (= 再マウントで既定高さ推定に戻らないこと) を固定する
         const measuredHeights = new Map<number, number>([[42, 777]])
-        const restoreRef = { current: { offset: 900, anchorReportHubId: 42, measuredHeights } }
+        const restoreRef = { current: { topItem: { reportHubId: 42, index: 1, offsetPx: 900 }, anchorReportHubId: 42, measuredHeights } }
         renderView(<DailyReportDetailList dailyReportItems={[buildItem(41), buildItem(42)]} selectedItemId={42} scrollRestoreRef={restoreRef} />)
         const getItemHeight = latestOf("daily-report-detail-list").getItemHeight
-        expect(getItemHeight?.(1)).toBe(777) // index 1 = reportHubId 42 の実測値
-        expect(getItemHeight?.(0)).not.toBe(777) // 未実測カードは既定推定
+        expect(getItemHeight?.(1)).toBe(777)
+        expect(getItemHeight?.(0)).not.toBe(777)
     })
 
-    it("onScroll は offset のみ書き、アンカーは選択同期の副作用が管理する", () => {
-        const restoreRef = { current: { offset: 0, anchorReportHubId: null as number | null, measuredHeights: new Map<number, number>() } }
-        renderView(<DailyReportDetailList dailyReportItems={[buildItem(42)]} selectedItemId={42} scrollRestoreRef={restoreRef} />)
+    it("選択変更時にアンカー同期の副作用が anchorReportHubId を新しい選択へ追従させる (null 以外からの変更も)", () => {
+        // 復元判定の生命線: この同期が「非 null からの変更」で止まると、古い選択のまま
+        // アンカー一致判定が誤爆し、次回復元の可否が壊れる
+        const restoreRef = slot({ topItem: { reportHubId: 41, index: 0, offsetPx: 900 }, anchorReportHubId: 42 })
+        const items = [buildItem(41), buildItem(42), buildItem(43)]
+        const view = renderView(<DailyReportDetailList dailyReportItems={items} selectedItemId={42} scrollRestoreRef={restoreRef} />)
+        expect(restoreRef.current.anchorReportHubId).toBe(42)
+
+        view.rerender(
+            <DailyReportConfigProvider config={cfg}>
+                <DailyReportDetailList dailyReportItems={items} selectedItemId={43} scrollRestoreRef={restoreRef} />
+            </DailyReportConfigProvider>,
+        )
+        expect(restoreRef.current.anchorReportHubId).toBe(43)
+        expect(scrollToIndexCalls.filter((c) => c.testId === "daily-report-detail-list")).toEqual([{ testId: "daily-report-detail-list", index: 2 }])
+    })
+
+    it("アンマウント時の RAF flush (ref null 化後) でも最終アンカーが書き戻される (ハンドルミラー)", () => {
+        // React は削除コミットで virtualScrollRef を null 化してから RAF flush の onScroll が
+        // 届く。ミラーが無いと最終フリング分のアンカーが失われる
+        const restoreRef = slot({ anchorReportHubId: null })
+        const view = renderView(<DailyReportDetailList dailyReportItems={[buildItem(41), buildItem(42)]} selectedItemId={42} scrollRestoreRef={restoreRef} />)
+        // マウント中に一度スクロール (ミラーがハンドルを捕捉)
+        scriptedAnchor = { index: 0, offsetPx: 11 }
+        const onScroll = latestOf("daily-report-detail-list").onScroll
+        act(() => onScroll?.(11, 100000))
+        expect(restoreRef.current.topItem).toEqual({ reportHubId: 41, index: 0, offsetPx: 11 })
+
+        // アンマウント → React が ref を null 化 → その後に flush 相当の onScroll が届く
+        view.unmount()
+        scriptedAnchor = { index: 1, offsetPx: 77 }
+        onScroll?.(777, 100000)
+        expect(restoreRef.current.topItem).toEqual({ reportHubId: 42, index: 1, offsetPx: 77 })
+    })
+
+    it("スクロールのたびに getScrollAnchor の結果が topItem (同一性 + 行内オフセット) として書き戻される", () => {
+        const restoreRef = slot({ anchorReportHubId: null })
+        renderView(<DailyReportDetailList dailyReportItems={[buildItem(41), buildItem(42)]} selectedItemId={42} scrollRestoreRef={restoreRef} />)
+        scriptedAnchor = { index: 1, offsetPx: 55 }
         act(() => latestOf("daily-report-detail-list").onScroll?.(555, 100000))
-        expect(restoreRef.current).toEqual({ offset: 555, anchorReportHubId: 42, measuredHeights: expect.any(Map) })
+        expect(restoreRef.current.topItem).toEqual({ reportHubId: 42, index: 1, offsetPx: 55 })
+        // アンカー (選択同期) は副作用が管理している
+        expect(restoreRef.current.anchorReportHubId).toBe(42)
     })
 })