@aiquants/daily-report 0.11.0 → 0.12.0

package/dist/client.d.mts

@@ -90,14 +90,22 @@ declare const DailyReportCommentForm: ({ reportHubId, businessDate, onAddComment
  * 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)。着地窓の行内オフセットの厳密さと
+ * 総高さ推定の質を保つため、実測をアンマウント越しに持ち回る。
  */
 type DailyReportDetailListScrollRestore = {
-    offset: number;
+    topItem: {
+        reportHubId: number;
+        index: number;
+        offsetPx: number;
+    } | null;
     anchorReportHubId: number | null;
     measuredHeights: Map<number, number>;
 };

package/dist/client.d.ts

@@ -90,14 +90,22 @@ declare const DailyReportCommentForm: ({ reportHubId, businessDate, onAddComment
  * 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)。着地窓の行内オフセットの厳密さと
+ * 総高さ推定の質を保つため、実測をアンマウント越しに持ち回る。
  */
 type DailyReportDetailListScrollRestore = {
-    offset: number;
+    topItem: {
+        reportHubId: number;
+        index: number;
+        offsetPx: number;
+    } | null;
     anchorReportHubId: number | null;
     measuredHeights: Map<number, number>;
 };