@aiquants/daily-report 0.9.1 → 0.11.0

package/dist/client.d.mts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ReactNode, Context, RefObject } from 'react';
+import { RefObject, ReactNode, Context } from 'react';
 import { ScrollBarThumbOverlayRenderProps, ScrollPaneInertiaOptions, ScrollBarTapCircleOptions } from '@aiquants/virtualscroll';
 import { D as DailyReportAttachmentSummary, a as DailyReportItem, b as DailyReportDetail, c as DailyReportUser } from './types-Ct1ggzy-.mjs';
 import { U as UIComment, D as DailyReportSseMessage } from './sse-schema-BiUnufrI.mjs';
@@ -86,19 +86,37 @@ type DailyReportCommentFormProps = {
  */
 declare const DailyReportCommentForm: ({ reportHubId, businessDate, onAddComment }: DailyReportCommentFormProps) => react.JSX.Element;
 
+/**
+ * Scroll restore slot for DailyReportDetailList that survives tab unmounting.
+ * タブアンマウントをまたいで DailyReportDetailList のスクロール位置を持ち回る共有スロット。
+ *
+ * offset は VirtualScroll の論理座標。anchorReportHubId は「その offset を記録した時点の
+ * 選択日報」。復元はアンカーが現在の選択と一致するときだけ行う: 選択が他ビューで変わって
+ * いたら、復元よりも「選択日報へのスクロール」(既存 UX) を優先する。
+ * measuredHeights は実測カード高さ (reportHubId → px)。ピクセル復元は「保存時と同じ高さ
+ * 空間」でだけ正しいため、実測をアンマウント越しに持ち回って座標空間を保存する。
+ */
+type DailyReportDetailListScrollRestore = {
+    offset: number;
+    anchorReportHubId: number | null;
+    measuredHeights: Map<number, number>;
+};
 type DailyReportDetailListProps = {
     dailyReportItems: DailyReportItem[];
     userId?: string | null;
     selectedItemId?: number | null;
     onSelectItem?: (id: number | null) => void;
-    initialScrollOffset?: number;
-    onScrollOffsetChange?: (offset: number) => void;
+    /**
+     * スクロール位置の共有スロット。マウント時に一度だけ読み、スクロールのたびに書き戻す。
+     * ❗ 値をレンダー時に読んで props へ焼き込む方式は禁止 (daily-report-list.tsx 参照)
+     */
+    scrollRestoreRef?: RefObject<DailyReportDetailListScrollRestore>;
 };
 /**
  * Daily report detail cards rendered with dynamic height virtual scroll.
  * 動的高さの仮想スクロールで日報詳細カードを描画するコンポーネント。
  */
-declare const DailyReportDetailList: ({ dailyReportItems, userId, selectedItemId, onSelectItem, initialScrollOffset, onScrollOffsetChange }: DailyReportDetailListProps) => react.JSX.Element;
+declare const DailyReportDetailList: ({ dailyReportItems, userId, selectedItemId, onSelectItem, scrollRestoreRef }: DailyReportDetailListProps) => react.JSX.Element;
 
 type DailyReportEditFormProps = {
     report: DailyReportDetail;
@@ -119,14 +137,20 @@ type DailyReportListProps = {
     selectedReportHubId: number | null;
     onSelectItem: (reportHubId: number | null) => void;
     userId?: string | null;
-    initialScrollOffset?: number;
-    onScrollOffsetChange?: (offset: number) => void;
+    /**
+     * タブ切替 (アンマウント) をまたいでスクロール位置を持ち回る共有スロット。
+     * 値は VirtualScroll の**論理座標** (inset 非依存。onScroll が配信する座標系)。
+     * マウント時に一度だけ読み、スクロールのたびに書き戻す。
+     * ❗ 値をレンダー時に読んで props へ焼き込む方式は禁止: 非制御タブでは親が
+     * 再レンダーされず、復帰マウントに古い値が渡る (実測で再現した実害バグ)
+     */
+    scrollOffsetRef?: RefObject<number>;
 };
 /**
  * Daily report list cards with key metadata and preview content via virtual scrolling.
  * 主なメタデータと内容プレビューを仮想スクロール表示する日報リスト。
  */
-declare const DailyReportList: ({ dailyReportItems, autoMarkRead, selectedReportHubId, onSelectItem, userId, initialScrollOffset, onScrollOffsetChange }: DailyReportListProps) => react.JSX.Element;
+declare const DailyReportList: ({ dailyReportItems, autoMarkRead, selectedReportHubId, onSelectItem, userId, scrollOffsetRef }: DailyReportListProps) => react.JSX.Element;
 
 /** ヘッダー描画スロットに渡される引数。 */
 type DailyReportHeaderProps = {
@@ -1043,4 +1067,4 @@ declare const TAP_SCROLL_CIRCLE_OPTIONS: ScrollBarTapCircleOptions;
  */
 declare const CONTENT_DRAG_POINTER_INPUTS: readonly ["pen", "touch"];
 
-export { BusinessDayThumbOverlay, CONTENT_DRAG_POINTER_INPUTS, DAILY_REPORT_FETCH_DEBOUNCE_MS, DEFAULT_ITEM_HEIGHT, type DailyReportActionContextType, DailyReportActionProvider, DailyReportAttachmentIndicator, DailyReportAttachmentList, DailyReportCache, type DailyReportClientConfig, type DailyReportClientConfigInput, DailyReportCommentForm, DailyReportCommentItem, DailyReportCommentList, DailyReportConfigProvider, DailyReportDetailList, type DailyReportDetailResource, DailyReportEditForm, type DailyReportErrorInfo, DailyReportErrorProvider, type DailyReportFieldLabels, type DailyReportHeaderProps, DailyReportIdsStreamClient, type DailyReportIdsStreamClientOptions, type DailyReportIdsStreamPhase, type DailyReportIdsStreamState, DailyReportIdsStreamStatus, DailyReportList, DailyReportLoadError, DailyReportLoading, DailyReportPage, type DailyReportPageProps, DailyReportResolvedContent, EMPTY_DETAIL, EMPTY_ITEM, FAST_SCROLL_INERTIA_OPTIONS, FAST_SCROLL_WHEEL_MULTIPLIER, ITEM_CONTAINER_HEIGHT, ITEM_VERTICAL_PADDING, MAX_PREVIEW_LINES, PREFETCH_LOOKAHEAD, PREFETCH_MAX_DATES, SCROLL_BAR_WIDTH, SSE_INITIAL_CONNECT_DEFER_MS, type SourceTypeConfig, TAP_SCROLL_CIRCLE_OPTIONS, UnreadIndicator, VIRTUAL_SCROLL_OVERSCAN_COUNT, WHEEL_RESET_TIMEOUT_MS, acquireMutationLock, applyBroadcastReportUpdate, applyDailyReportServerUpdates, bootstrapDailyReportIdsStreamSession, clearDailyReportCache, createDailyReportClientLoader, dailyReportShouldRevalidate, defaultDailyReportClientConfig, defaultDailyReportFieldLabels, deleteDailyReportCache, ensureDailyReportIdsStreamSession, getCachedReport, getDailyReportIdsStreamSessionUserKey, primeDailyReportIdsStreamSession, refreshDailyReportIdsStream, registerRecentDeletion, releaseMutationLock, reloadDocument, removeDailyReportIdsStreamItem, resetDailyReportIdsStreamSessionForTesting, resolveSourceTypeConfig, retryDailyReportIdsStream, subscribeCacheReady, updateDailyReportCache, upsertDailyReportIdsStreamItem, useAnimatedNumber, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportErrorSurface, useDailyReportIdsStream, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };
+export { BusinessDayThumbOverlay, CONTENT_DRAG_POINTER_INPUTS, DAILY_REPORT_FETCH_DEBOUNCE_MS, DEFAULT_ITEM_HEIGHT, type DailyReportActionContextType, DailyReportActionProvider, DailyReportAttachmentIndicator, DailyReportAttachmentList, DailyReportCache, type DailyReportClientConfig, type DailyReportClientConfigInput, DailyReportCommentForm, DailyReportCommentItem, DailyReportCommentList, DailyReportConfigProvider, DailyReportDetailList, type DailyReportDetailListScrollRestore, type DailyReportDetailResource, DailyReportEditForm, type DailyReportErrorInfo, DailyReportErrorProvider, type DailyReportFieldLabels, type DailyReportHeaderProps, DailyReportIdsStreamClient, type DailyReportIdsStreamClientOptions, type DailyReportIdsStreamPhase, type DailyReportIdsStreamState, DailyReportIdsStreamStatus, DailyReportList, DailyReportLoadError, DailyReportLoading, DailyReportPage, type DailyReportPageProps, DailyReportResolvedContent, EMPTY_DETAIL, EMPTY_ITEM, FAST_SCROLL_INERTIA_OPTIONS, FAST_SCROLL_WHEEL_MULTIPLIER, ITEM_CONTAINER_HEIGHT, ITEM_VERTICAL_PADDING, MAX_PREVIEW_LINES, PREFETCH_LOOKAHEAD, PREFETCH_MAX_DATES, SCROLL_BAR_WIDTH, SSE_INITIAL_CONNECT_DEFER_MS, type SourceTypeConfig, TAP_SCROLL_CIRCLE_OPTIONS, UnreadIndicator, VIRTUAL_SCROLL_OVERSCAN_COUNT, WHEEL_RESET_TIMEOUT_MS, acquireMutationLock, applyBroadcastReportUpdate, applyDailyReportServerUpdates, bootstrapDailyReportIdsStreamSession, clearDailyReportCache, createDailyReportClientLoader, dailyReportShouldRevalidate, defaultDailyReportClientConfig, defaultDailyReportFieldLabels, deleteDailyReportCache, ensureDailyReportIdsStreamSession, getCachedReport, getDailyReportIdsStreamSessionUserKey, primeDailyReportIdsStreamSession, refreshDailyReportIdsStream, registerRecentDeletion, releaseMutationLock, reloadDocument, removeDailyReportIdsStreamItem, resetDailyReportIdsStreamSessionForTesting, resolveSourceTypeConfig, retryDailyReportIdsStream, subscribeCacheReady, updateDailyReportCache, upsertDailyReportIdsStreamItem, useAnimatedNumber, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportErrorSurface, useDailyReportIdsStream, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ReactNode, Context, RefObject } from 'react';
+import { RefObject, ReactNode, Context } from 'react';
 import { ScrollBarThumbOverlayRenderProps, ScrollPaneInertiaOptions, ScrollBarTapCircleOptions } from '@aiquants/virtualscroll';
 import { D as DailyReportAttachmentSummary, a as DailyReportItem, b as DailyReportDetail, c as DailyReportUser } from './types-Ct1ggzy-.js';
 import { U as UIComment, D as DailyReportSseMessage } from './sse-schema-YZh7Pz7i.js';
@@ -86,19 +86,37 @@ type DailyReportCommentFormProps = {
  */
 declare const DailyReportCommentForm: ({ reportHubId, businessDate, onAddComment }: DailyReportCommentFormProps) => react.JSX.Element;
 
+/**
+ * Scroll restore slot for DailyReportDetailList that survives tab unmounting.
+ * タブアンマウントをまたいで DailyReportDetailList のスクロール位置を持ち回る共有スロット。
+ *
+ * offset は VirtualScroll の論理座標。anchorReportHubId は「その offset を記録した時点の
+ * 選択日報」。復元はアンカーが現在の選択と一致するときだけ行う: 選択が他ビューで変わって
+ * いたら、復元よりも「選択日報へのスクロール」(既存 UX) を優先する。
+ * measuredHeights は実測カード高さ (reportHubId → px)。ピクセル復元は「保存時と同じ高さ
+ * 空間」でだけ正しいため、実測をアンマウント越しに持ち回って座標空間を保存する。
+ */
+type DailyReportDetailListScrollRestore = {
+    offset: number;
+    anchorReportHubId: number | null;
+    measuredHeights: Map<number, number>;
+};
 type DailyReportDetailListProps = {
     dailyReportItems: DailyReportItem[];
     userId?: string | null;
     selectedItemId?: number | null;
     onSelectItem?: (id: number | null) => void;
-    initialScrollOffset?: number;
-    onScrollOffsetChange?: (offset: number) => void;
+    /**
+     * スクロール位置の共有スロット。マウント時に一度だけ読み、スクロールのたびに書き戻す。
+     * ❗ 値をレンダー時に読んで props へ焼き込む方式は禁止 (daily-report-list.tsx 参照)
+     */
+    scrollRestoreRef?: RefObject<DailyReportDetailListScrollRestore>;
 };
 /**
  * Daily report detail cards rendered with dynamic height virtual scroll.
  * 動的高さの仮想スクロールで日報詳細カードを描画するコンポーネント。
  */
-declare const DailyReportDetailList: ({ dailyReportItems, userId, selectedItemId, onSelectItem, initialScrollOffset, onScrollOffsetChange }: DailyReportDetailListProps) => react.JSX.Element;
+declare const DailyReportDetailList: ({ dailyReportItems, userId, selectedItemId, onSelectItem, scrollRestoreRef }: DailyReportDetailListProps) => react.JSX.Element;
 
 type DailyReportEditFormProps = {
     report: DailyReportDetail;
@@ -119,14 +137,20 @@ type DailyReportListProps = {
     selectedReportHubId: number | null;
     onSelectItem: (reportHubId: number | null) => void;
     userId?: string | null;
-    initialScrollOffset?: number;
-    onScrollOffsetChange?: (offset: number) => void;
+    /**
+     * タブ切替 (アンマウント) をまたいでスクロール位置を持ち回る共有スロット。
+     * 値は VirtualScroll の**論理座標** (inset 非依存。onScroll が配信する座標系)。
+     * マウント時に一度だけ読み、スクロールのたびに書き戻す。
+     * ❗ 値をレンダー時に読んで props へ焼き込む方式は禁止: 非制御タブでは親が
+     * 再レンダーされず、復帰マウントに古い値が渡る (実測で再現した実害バグ)
+     */
+    scrollOffsetRef?: RefObject<number>;
 };
 /**
  * Daily report list cards with key metadata and preview content via virtual scrolling.
  * 主なメタデータと内容プレビューを仮想スクロール表示する日報リスト。
  */
-declare const DailyReportList: ({ dailyReportItems, autoMarkRead, selectedReportHubId, onSelectItem, userId, initialScrollOffset, onScrollOffsetChange }: DailyReportListProps) => react.JSX.Element;
+declare const DailyReportList: ({ dailyReportItems, autoMarkRead, selectedReportHubId, onSelectItem, userId, scrollOffsetRef }: DailyReportListProps) => react.JSX.Element;
 
 /** ヘッダー描画スロットに渡される引数。 */
 type DailyReportHeaderProps = {
@@ -1043,4 +1067,4 @@ declare const TAP_SCROLL_CIRCLE_OPTIONS: ScrollBarTapCircleOptions;
  */
 declare const CONTENT_DRAG_POINTER_INPUTS: readonly ["pen", "touch"];
 
-export { BusinessDayThumbOverlay, CONTENT_DRAG_POINTER_INPUTS, DAILY_REPORT_FETCH_DEBOUNCE_MS, DEFAULT_ITEM_HEIGHT, type DailyReportActionContextType, DailyReportActionProvider, DailyReportAttachmentIndicator, DailyReportAttachmentList, DailyReportCache, type DailyReportClientConfig, type DailyReportClientConfigInput, DailyReportCommentForm, DailyReportCommentItem, DailyReportCommentList, DailyReportConfigProvider, DailyReportDetailList, type DailyReportDetailResource, DailyReportEditForm, type DailyReportErrorInfo, DailyReportErrorProvider, type DailyReportFieldLabels, type DailyReportHeaderProps, DailyReportIdsStreamClient, type DailyReportIdsStreamClientOptions, type DailyReportIdsStreamPhase, type DailyReportIdsStreamState, DailyReportIdsStreamStatus, DailyReportList, DailyReportLoadError, DailyReportLoading, DailyReportPage, type DailyReportPageProps, DailyReportResolvedContent, EMPTY_DETAIL, EMPTY_ITEM, FAST_SCROLL_INERTIA_OPTIONS, FAST_SCROLL_WHEEL_MULTIPLIER, ITEM_CONTAINER_HEIGHT, ITEM_VERTICAL_PADDING, MAX_PREVIEW_LINES, PREFETCH_LOOKAHEAD, PREFETCH_MAX_DATES, SCROLL_BAR_WIDTH, SSE_INITIAL_CONNECT_DEFER_MS, type SourceTypeConfig, TAP_SCROLL_CIRCLE_OPTIONS, UnreadIndicator, VIRTUAL_SCROLL_OVERSCAN_COUNT, WHEEL_RESET_TIMEOUT_MS, acquireMutationLock, applyBroadcastReportUpdate, applyDailyReportServerUpdates, bootstrapDailyReportIdsStreamSession, clearDailyReportCache, createDailyReportClientLoader, dailyReportShouldRevalidate, defaultDailyReportClientConfig, defaultDailyReportFieldLabels, deleteDailyReportCache, ensureDailyReportIdsStreamSession, getCachedReport, getDailyReportIdsStreamSessionUserKey, primeDailyReportIdsStreamSession, refreshDailyReportIdsStream, registerRecentDeletion, releaseMutationLock, reloadDocument, removeDailyReportIdsStreamItem, resetDailyReportIdsStreamSessionForTesting, resolveSourceTypeConfig, retryDailyReportIdsStream, subscribeCacheReady, updateDailyReportCache, upsertDailyReportIdsStreamItem, useAnimatedNumber, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportErrorSurface, useDailyReportIdsStream, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };
+export { BusinessDayThumbOverlay, CONTENT_DRAG_POINTER_INPUTS, DAILY_REPORT_FETCH_DEBOUNCE_MS, DEFAULT_ITEM_HEIGHT, type DailyReportActionContextType, DailyReportActionProvider, DailyReportAttachmentIndicator, DailyReportAttachmentList, DailyReportCache, type DailyReportClientConfig, type DailyReportClientConfigInput, DailyReportCommentForm, DailyReportCommentItem, DailyReportCommentList, DailyReportConfigProvider, DailyReportDetailList, type DailyReportDetailListScrollRestore, type DailyReportDetailResource, DailyReportEditForm, type DailyReportErrorInfo, DailyReportErrorProvider, type DailyReportFieldLabels, type DailyReportHeaderProps, DailyReportIdsStreamClient, type DailyReportIdsStreamClientOptions, type DailyReportIdsStreamPhase, type DailyReportIdsStreamState, DailyReportIdsStreamStatus, DailyReportList, DailyReportLoadError, DailyReportLoading, DailyReportPage, type DailyReportPageProps, DailyReportResolvedContent, EMPTY_DETAIL, EMPTY_ITEM, FAST_SCROLL_INERTIA_OPTIONS, FAST_SCROLL_WHEEL_MULTIPLIER, ITEM_CONTAINER_HEIGHT, ITEM_VERTICAL_PADDING, MAX_PREVIEW_LINES, PREFETCH_LOOKAHEAD, PREFETCH_MAX_DATES, SCROLL_BAR_WIDTH, SSE_INITIAL_CONNECT_DEFER_MS, type SourceTypeConfig, TAP_SCROLL_CIRCLE_OPTIONS, UnreadIndicator, VIRTUAL_SCROLL_OVERSCAN_COUNT, WHEEL_RESET_TIMEOUT_MS, acquireMutationLock, applyBroadcastReportUpdate, applyDailyReportServerUpdates, bootstrapDailyReportIdsStreamSession, clearDailyReportCache, createDailyReportClientLoader, dailyReportShouldRevalidate, defaultDailyReportClientConfig, defaultDailyReportFieldLabels, deleteDailyReportCache, ensureDailyReportIdsStreamSession, getCachedReport, getDailyReportIdsStreamSessionUserKey, primeDailyReportIdsStreamSession, refreshDailyReportIdsStream, registerRecentDeletion, releaseMutationLock, reloadDocument, removeDailyReportIdsStreamItem, resetDailyReportIdsStreamSessionForTesting, resolveSourceTypeConfig, retryDailyReportIdsStream, subscribeCacheReady, updateDailyReportCache, upsertDailyReportIdsStreamItem, useAnimatedNumber, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportErrorSurface, useDailyReportIdsStream, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };