@aiquants/daily-report 0.20.0 → 0.21.0

package/dist/client.d.mts

@@ -1,50 +1,23 @@
-import * as react 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-CqgYQgbH.mjs';
-import { U as UIComment, D as DailyReportSseMessage } from './sse-schema-ChSFm-4q.mjs';
-import { ShouldRevalidateFunction } from 'react-router';
-import 'zod';
-
-/**
- * Tooltip bubble that anchors to the scrollbar thumb while interacting.
- * スクロール操作中にスクロールバーのサムへ連動表示するツールチップのコンポーネント。
- */
+import * as react from "react";
+import { RefObject, ReactNode, Context } from "react";
+import { ScrollBarThumbOverlayRenderProps, VirtualScrollLocale, VirtualScrollLabels, ScrollPaneInertiaOptions, ScrollBarTapCircleOptions } from "@aiquants/virtualscroll";
+import { D as DailyReportAttachmentSummary, a as DailyReportItem, b as DailyReportDetail, c as DailyReportUser } from "./types-CqgYQgbH.mjs";
+import { U as UIComment, D as DailyReportSseMessage } from "./sse-schema-DCxpdETM.mjs";
+import { ShouldRevalidateFunction } from "react-router";
+import "zod";
 declare const BusinessDayThumbOverlay: ({ orientation, thumbCenter, label, isDragging, isTapScrollActive, isWheelScrollActive }: ScrollBarThumbOverlayRenderProps & {
     label: string;
     isWheelScrollActive: boolean;
 }) => react.JSX.Element | null;
-
 type DailyReportAttachmentIndicatorProps = {
-    /** 添付の件数。0 なら何も描画しない。 */
     count: number;
-    /** 読み上げ・ツールチップ用の見出し。消費アプリの `fieldLabels.attachments` を渡す。 */
     label: string;
 };
-/**
- * Renders the attachment marker, or nothing when the report has no attachment.
- * 添付の目印を描画する (添付が無ければ何も描画しない)。
- *
- * @param props Attachment count and the label. 添付件数と見出し。
- * @returns The marker element, or null. 目印の要素 (添付が無ければ null)。
- */
 declare const DailyReportAttachmentIndicator: ({ count, label }: DailyReportAttachmentIndicatorProps) => react.JSX.Element | null;
-
 type DailyReportAttachmentListProps = {
-    /** 表示する添付一覧。空配列ならこのコンポーネントは何も描画しない。 */
     attachments: DailyReportAttachmentSummary[];
 };
-/**
- * Renders the attachment section of a daily report detail card.
- * 日報詳細カードの添付ファイル節を描画するコンポーネント。
- *
- * 表示文言はすべて `fieldLabels` から取る (パッケージは業務ドメインの語彙も言語も持たない)。
- *
- * @param props Attachments to render. 描画する添付一覧。
- * @returns The section element, or null when there is nothing to show. 節の要素 (表示対象が無ければ null)。
- */
 declare const DailyReportAttachmentList: ({ attachments }: DailyReportAttachmentListProps) => react.JSX.Element | null;
-
 type DailyReportPostedCommentProps = {
     comment: UIComment;
     reportHubId: number;
@@ -55,12 +28,7 @@ type DailyReportPostedCommentProps = {
     onTrashClick: (e: React.MouseEvent | React.TouchEvent, commentId: number | string) => void;
     resolvedIdMap?: Map<number, number>;
 };
-/**
- * Renders a single comment item with delete functionality.
- * 削除機能付きの単一コメントアイテムを描画するコンポーネント。
- */
 declare const DailyReportPostedComment: ({ comment, reportHubId: _reportHubId, businessDate: _businessDate, onOptimisticDelete, pendingDeleteId, onPendingDeleteIdChange, onTrashClick, resolvedIdMap }: DailyReportPostedCommentProps) => react.JSX.Element;
-
 type DailyReportCommentListProps = {
     comments: UIComment[];
     reportHubId: number;
@@ -70,36 +38,13 @@ type DailyReportCommentListProps = {
     onPendingDeleteIdChange: (id: number | string | null) => void;
     resolvedIdMap?: Map<number, number>;
 };
-/**
- * Renders a list of daily report comments.
- * 日報コメントのリストを描画するコンポーネント。
- */
 declare const DailyReportCommentList: ({ comments, reportHubId, businessDate, onDeleteComment, pendingDeleteId, onPendingDeleteIdChange, resolvedIdMap }: DailyReportCommentListProps) => react.JSX.Element | null;
 type DailyReportCommentFormProps = {
     reportHubId: number;
     businessDate: string;
     onAddComment?: (content: string) => Promise<void> | void;
 };
-/**
- * Renders a form to add a new comment to a daily report.
- * 日報に新しいコメントを追加するためのフォームを描画するコンポーネント。
- */
 declare const DailyReportCommentForm: ({ reportHubId, businessDate, onAddComment }: DailyReportCommentFormProps) => react.JSX.Element;
-
-/**
- * Scroll restore slot for DailyReportDetailList that survives tab unmounting.
- * タブアンマウントをまたいで DailyReportDetailList のスクロール位置を持ち回る共有スロット。
- *
- * topItem は先頭可視カードの**同一性アンカー** (reportHubId + 行内オフセット px + 保存時 index)。
- * ❗ 生の論理 px を保存してはならない: 可変高さでは px→行変換が再マウントの推定空間で行われ、
- * 深い位置で別のカードに着地する (実機で確定した実害バグ)。同一性アンカーは一覧が留守中に
- * 変わっても findIndex で正しいカードへ再解決される。index は該当カードが消えていたときの
- * 近似フォールバック。offsetPx はカード上端がビューポート上端より上に隠れている px (論理座標)。
- * anchorReportHubId は「記録時点の選択日報」。復元はこれが現在の選択と一致するときだけ行う:
- * 選択が他ビューで変わっていたら、復元よりも「選択日報へのスクロール」(既存 UX) を優先する。
- * measuredHeights は実測カード高さ (reportHubId → px)。着地窓の行内オフセットの厳密さと
- * 総高さ推定の質を保つため、実測をアンマウント越しに持ち回る。
- */
 type DailyReportDetailListScrollRestore = {
     topItem: {
         reportHubId: number;
@@ -114,260 +59,272 @@ type DailyReportDetailListProps = {
     userId?: string | null;
     selectedItemId?: number | null;
     onSelectItem?: (id: number | null) => 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, scrollRestoreRef }: DailyReportDetailListProps) => react.JSX.Element;
-
 type DailyReportEditFormProps = {
     report: DailyReportDetail;
     onCancel?: () => void;
     onPublishSuccess?: () => void;
 };
 declare const DailyReportEditForm: ({ report, onCancel, onPublishSuccess }: DailyReportEditFormProps) => react.JSX.Element;
-
-/**
- * Renders the streaming progress / recovery badge for the ids stream.
- * ids ストリームの進捗・復旧バッジを描画するコンポーネント。
- */
 declare const DailyReportIdsStreamStatus: () => react.JSX.Element | null;
-
-/**
- * Props for the DailyReportList component.
- * DailyReportList コンポーネントのプロパティ型定義。
- */
 type DailyReportListProps = {
     dailyReportItems: DailyReportItem[];
     autoMarkRead?: boolean;
     selectedReportHubId: number | null;
     onSelectItem: (reportHubId: number | null) => void;
     userId?: string | null;
-    /**
-     * Shared slot to preserve scroll position across unmounted tab switches.
-     * タブ切替 (アンマウント) をまたいでスクロール位置を持ち回る共有スロット。
-     * 値は VirtualScroll の論理座標 (inset 非依存。onScroll が配信する座標系)。
-     * マウント時に一度だけ読み、スクロールのたびに書き戻す。
-     */
     scrollOffsetRef?: RefObject<number>;
 };
-/**
- * Daily report list cards with key metadata and preview content via virtual scrolling.
- * 主なメタデータと内容プレビューを仮想スクロール表示する日報リスト。
- */
 declare const DailyReportList: ({ dailyReportItems, autoMarkRead, selectedReportHubId, onSelectItem, userId, scrollOffsetRef }: DailyReportListProps) => react.JSX.Element;
-
-/** ヘッダー描画スロットに渡される引数。 */
+type DailyReportLocale = VirtualScrollLocale;
+type DailyReportOperation = "create" | "update" | "publish" | "delete" | "addComment" | "deleteComment" | "toggleStar" | "toggleRead";
+type DailyReportLabels = VirtualScrollLabels & {
+    readonly id: string;
+    readonly businessDate: string;
+    readonly author: string;
+    readonly visitTime: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly updatedBy: string;
+    readonly category: string;
+    readonly categoryInfo: string;
+    readonly creationCategory: string;
+    readonly customer: string;
+    readonly subject: string;
+    readonly content: string;
+    readonly interviewers: string;
+    readonly comments: string;
+    readonly attachments: string;
+    readonly attachmentMissing: string;
+    readonly attachmentDownload: string;
+    readonly tabArticle: string;
+    readonly tabRelations: string;
+    readonly relationsEmpty: string;
+    readonly title: string;
+    readonly tabList: string;
+    readonly tabTree: string;
+    readonly tabDetailList: string;
+    readonly treeComingSoon: string;
+    readonly totalCountLoading: string;
+    readonly createReport: string;
+    readonly createReportTitle: string;
+    readonly devControls: string;
+    readonly devSseToggle: string;
+    readonly devReload: string;
+    readonly devClearCache: string;
+    readonly autoRead: string;
+    readonly autoReadTitle: string;
+    readonly loadErrorBadge: string;
+    readonly loadError: string;
+    readonly reload: string;
+    readonly loadingIds: string;
+    readonly streamFailed: string;
+    readonly streamRetry: string;
+    readonly streamRevalidating: string;
+    readonly listEmpty: string;
+    readonly selectPrompt: string;
+    readonly loading: string;
+    readonly reportNotFound: string;
+    readonly contentEmpty: string;
+    readonly contentEmptyPreview: string;
+    readonly confirmDelete: string;
+    readonly deleteFailed: string;
+    readonly starAdd: string;
+    readonly starRemove: string;
+    readonly markRead: string;
+    readonly markUnread: string;
+    readonly deleteReport: string;
+    readonly resizeHandle: string;
+    readonly overlayBackdrop: string;
+    readonly overlayDialog: string;
+    readonly close: string;
+    readonly formTitle: string;
+    readonly formTitlePlaceholder: string;
+    readonly formContent: string;
+    readonly formContentPlaceholder: string;
+    readonly formCancel: string;
+    readonly formSave: string;
+    readonly formPublish: string;
+    readonly commentPlaceholder: string;
+    readonly commentSend: string;
+    readonly commentDelete: string;
+    readonly commentDeleteConfirm: string;
+    readonly unknownUser: string;
+    readonly sourceInternal: string;
+    readonly totalCount: (count: number) => string;
+    readonly debounce: (milliseconds: number) => string;
+    readonly streamProgressCount: (loaded: number) => string;
+    readonly streamProgressRatio: (loaded: number, total: number, percent: number) => string;
+    readonly streamRetrying: (loaded: number) => string;
+    readonly reportLoadFailed: (reportHubId: number) => string;
+    readonly reportSummaryLoadFailed: (reportHubId: number) => string;
+    readonly interviewerWithAffiliation: (name: string, affiliation: string) => string;
+    readonly operationFailed: (operation: DailyReportOperation) => string;
+};
+type DailyReportLabelOverrides = {
+    readonly [K in keyof DailyReportLabels]?: DailyReportLabels[K];
+};
+declare const DAILY_REPORT_LABEL_KEYS: readonly [
+    "scrollUp",
+    "scrollDown",
+    "scrollLeft",
+    "scrollRight",
+    "scrollToTop",
+    "scrollToBottom",
+    "noItems",
+    "id",
+    "businessDate",
+    "author",
+    "visitTime",
+    "createdAt",
+    "updatedAt",
+    "updatedBy",
+    "category",
+    "categoryInfo",
+    "creationCategory",
+    "customer",
+    "subject",
+    "content",
+    "interviewers",
+    "comments",
+    "attachments",
+    "attachmentMissing",
+    "attachmentDownload",
+    "tabArticle",
+    "tabRelations",
+    "relationsEmpty",
+    "title",
+    "tabList",
+    "tabTree",
+    "tabDetailList",
+    "treeComingSoon",
+    "totalCountLoading",
+    "createReport",
+    "createReportTitle",
+    "devControls",
+    "devSseToggle",
+    "devReload",
+    "devClearCache",
+    "autoRead",
+    "autoReadTitle",
+    "loadErrorBadge",
+    "loadError",
+    "reload",
+    "loadingIds",
+    "streamFailed",
+    "streamRetry",
+    "streamRevalidating",
+    "listEmpty",
+    "selectPrompt",
+    "loading",
+    "reportNotFound",
+    "contentEmpty",
+    "contentEmptyPreview",
+    "confirmDelete",
+    "deleteFailed",
+    "starAdd",
+    "starRemove",
+    "markRead",
+    "markUnread",
+    "deleteReport",
+    "resizeHandle",
+    "overlayBackdrop",
+    "overlayDialog",
+    "close",
+    "formTitle",
+    "formTitlePlaceholder",
+    "formContent",
+    "formContentPlaceholder",
+    "formCancel",
+    "formSave",
+    "formPublish",
+    "commentPlaceholder",
+    "commentSend",
+    "commentDelete",
+    "commentDeleteConfirm",
+    "unknownUser",
+    "sourceInternal",
+    "totalCount",
+    "debounce",
+    "streamProgressCount",
+    "streamProgressRatio",
+    "streamRetrying",
+    "reportLoadFailed",
+    "reportSummaryLoadFailed",
+    "interviewerWithAffiliation",
+    "operationFailed"
+];
+declare const DAILY_REPORT_LABEL_CATALOGS: Readonly<Record<DailyReportLocale, DailyReportLabels>>;
+declare const resolveDailyReportLabels: (locale: DailyReportLocale | undefined, overrides: DailyReportLabelOverrides | undefined) => DailyReportLabels;
 type DailyReportHeaderProps = {
     title: string;
     annotation?: ReactNode;
 };
-/**
- * Display labels for the report detail/list fields, sections, and side-pane tabs.
- * 日報の詳細/一覧カードのフィールド・セクション・タブ見出しの表示ラベル群。
- *
- * パッケージは中立な英語ラベルのみを既定として同梱し、ドメイン固有の表現 (言語・業務語彙) は
- * 消費アプリが `fieldLabels` で注入する。これによりパッケージ本体が業務ドメイン知識を持たない。
- */
-type DailyReportFieldLabels = {
-    id: string;
-    businessDate: string;
-    author: string;
-    visitTime: string;
-    createdAt: string;
-    updatedAt: string;
-    updatedBy: string;
-    category: string;
-    categoryInfo: string;
-    creationCategory: string;
-    customer: string;
-    subject: string;
-    content: string;
-    interviewers: string;
-    comments: string;
-    attachments: string;
-    /** 実体の消失が確認された添付に添える注記。 */
-    attachmentMissing: string;
-    /** 添付をダウンロードするリンクのラベル。 */
-    attachmentDownload: string;
-    tabArticle: string;
-    tabRelations: string;
-    relationsEmpty: string;
-};
-/**
- * Mutation-failure notification payload (for a host-supplied error surface).
- * ミューテーション失敗の通知情報 (ホストが独自の通知 UI を出すための口)。
- */
 type DailyReportErrorInfo = {
-    /** 失敗した操作の種別 (create / update / publish / delete / addComment / deleteComment / toggleStar / toggleRead)。 */
-    operation: string;
-    /** 表示用のメッセージ (パッケージ内蔵バナー用)。 */
+    operation: DailyReportOperation;
     message: string;
-    /** 元例外 (診断用)。 */
     cause?: unknown;
 };
-/** データソースごとのバッジ表示設定。 */
 type SourceTypeConfig = {
     label: string;
     badgeClassName?: string;
-    /** コメント投稿を許可するかどうか (既定 true)。false の場合、該当ソースの日報でコメント投稿フォームを非表示にする。 */
     allowComment?: boolean;
 };
-/** クライアント層の設定一式。 */
 type DailyReportClientConfig = {
-    /** 画面タイトル (ヘッダーへ渡す)。 */
-    title: string;
-    /** API ベースパス (例 `/daily_report/api`)。末尾スラッシュ無し。 */
     apiBasePath: string;
-    /** SSE エンドポイントパス (例 `/sse/daily_report/updates`)。 */
     ssePath: string;
-    /** 下書き状態を表すラベル名。UI の編集モード判定に使う。既定はプレースホルダーなので消費側で自アプリのラベル名へ上書きする。 */
     draftLabelName: string;
-    /** 詳細/一覧カード of field 見出しラベル。既定は中立英語。アプリが自ドメインの表記を注入する。 */
-    fieldLabels: DailyReportFieldLabels;
-    /** 外部ソース区分ごとのバッジ表示設定。 */
-    sourceTypeConfigs?: Record<string, SourceTypeConfig>;
-    /** ヘッダー描画スロット。アプリのヘッダーコンポーネントを差し込む。 */
+    locale: DailyReportLocale;
+    labels: DailyReportLabels;
+    sourceTypeConfigs: Record<string, SourceTypeConfig>;
     renderHeader: (props: DailyReportHeaderProps) => ReactNode;
-    /** 開発向けコントロール (SSE 購読トグル等) を表示するか。 */
     showDevControls: boolean;
-    /**
-     * ミューテーション失敗時の通知ポート。未指定ならパッケージ内蔵の role="alert"
-     * バナーで表示する。ホストが独自トースト等を持つ場合はここへ委譲する。
-     */
     onError?: (info: DailyReportErrorInfo) => void;
 };
-/**
- * Partial client-config override. `fieldLabels` may itself be partially overridden.
- * クライアント設定の部分上書き型。`fieldLabels` も部分上書き可 (プロバイダーが深くマージする)。
- */
-type DailyReportClientConfigInput = Partial<Omit<DailyReportClientConfig, "fieldLabels">> & {
-    fieldLabels?: Partial<DailyReportFieldLabels>;
-    sourceTypeConfigs?: Record<string, SourceTypeConfig>;
+type DailyReportClientConfigInput = Partial<Omit<DailyReportClientConfig, "locale" | "labels">> & {
+    locale?: DailyReportLocale;
+    labels?: DailyReportLabelOverrides;
 };
-/** 中立英語のフィールドラベル既定 (ドメイン非依存)。 */
-declare const defaultDailyReportFieldLabels: DailyReportFieldLabels;
-/** 既定設定 (消費側は必要なフィールドのみ部分上書きする)。 */
-declare const defaultDailyReportClientConfig: DailyReportClientConfig;
-/**
- * Provides a partial override of the daily-report client configuration.
- * 日報クライアント設定の部分上書きを提供するプロバイダー。
- */
+type DailyReportClientConfigDefaults = Readonly<Pick<DailyReportClientConfig, "apiBasePath" | "ssePath" | "draftLabelName" | "renderHeader" | "showDevControls">>;
+declare const defaultDailyReportClientConfig: DailyReportClientConfigDefaults;
 declare const DailyReportConfigProvider: ({ config, children }: {
     config?: DailyReportClientConfigInput;
     children: ReactNode;
 }) => react.JSX.Element;
-/**
- * Reads the daily-report client configuration (defaults when no provider).
- * 日報クライアント設定を読む (プロバイダー未設置時は既定値)。
- */
 declare const useDailyReportConfig: () => DailyReportClientConfig;
-/**
- * Resolves source type badge configuration with case-insensitive fallback.
- * ケースインセンシティブなフォールバック付きでデータソースバッジ設定を解決する。
- */
 declare const resolveSourceTypeConfig: (sourceType?: string | null, sourceTypeConfigs?: Record<string, SourceTypeConfig>) => SourceTypeConfig | undefined;
-
-/**
- * Error display when the ids stream terminally failed before any data arrived.
- * データ未受信のまま ID ストリームが力尽きたときのエラー表示コンポーネント。
- *
- * 再試行はストリームセッションの retry へ直結する (受信済みカーソルから再開)。
- */
 declare const DailyReportLoadError: () => react.JSX.Element;
-/**
- * Loading screen shown only until the first stream chunk arrives.
- * 最初のストリームチャンクが届くまでの間だけ表示するローディング画面。
- */
 declare const DailyReportLoading: () => react.JSX.Element;
 type DailyReportPageProps = {
-    /** 表示中ユーザー (楽観的コメントの作者名等に使用)。 */
     user?: DailyReportUser;
-    /** 難読化済みの内部ユーザー ID (未登録ユーザーは null)。 */
     userId?: string | null;
-    /** クライアント設定の部分上書き (ヘッダー描画・パス・ラベル名・フィールドラベルなど)。 */
     config?: DailyReportClientConfigInput;
 };
-/**
- * Chrome-agnostic daily report page with client configuration provider.
- * 設定プロバイダー込みの日報ページコンポーネント。
- */
 declare const DailyReportPage: ({ config, ...rest }: DailyReportPageProps) => react.JSX.Element;
-
 type DailyReportResolvedContentProps = {
     userId?: string | null;
 };
-/**
- * Displays streamed daily reports with layout and tabbed virtual scroll views.
- * レイアウトとタブ付き仮想スクロールでストリーム受信済み日報を表示するコンポーネント。
- *
- * アイテムは Action Context (ストリームチャンクをマージ済み) から読む。
- */
 declare const DailyReportResolvedContent: ({ userId }: DailyReportResolvedContentProps) => react.JSX.Element;
-
 type UnreadIndicatorProps = {
     className?: string;
 };
-/**
- * A simple blue dot indicator used to represent unread status.
- * 未読状態を表すためのシンプルな青いドットインジケーター。
- */
 declare const UnreadIndicator: ({ className }: UnreadIndicatorProps) => react.JSX.Element;
-
 type DailyReportActionContextType = {
-    /** 表示中ユーザー (楽観的コメントの作者名等に使用)。 */
     user?: DailyReportUser;
-    /** reportHubId -> Map<tempCommentId, content> (追加コメントの一時IDと内容) */
     pendingAddCommentIds: React.MutableRefObject<Map<number, Map<number, string>>>;
-    /** reportHubId -> Set<tempCommentId> (削除された一時ID) */
     pendingDeleteCommentIds: React.MutableRefObject<Map<number, Set<number>>>;
-    /** reportHubId -> boolean (スターの保留状態) */
     pendingStarUpdates: React.MutableRefObject<Map<number, boolean>>;
-    /** reportHubId -> boolean (既読の保留状態) */
     pendingReadUpdates: React.MutableRefObject<Map<number, boolean>>;
-    /** tempId -> realId (解決されたID) */
     resolvedIdMap: React.MutableRefObject<Map<number, number>>;
-    /** 状態変更通知用バージョン */
     version: number;
-    /** 日報リスト */
     items: DailyReportItem[];
-    /** SSE購読が有効かどうか */
     isSseEnabled: boolean;
-    /** SSE購読の有効/無効を切り替える */
     toggleSse: () => void;
-    /**
-     * コメントを追加します。
-     * @param reportHubId 日報HubID
-     * @param content コメント内容
-     * @param businessDate 営業日
-     */
     addComment: (reportHubId: number, content: string, businessDate: string) => Promise<void>;
-    /**
-     * コメントを削除します。
-     * @param reportHubId 日報HubID
-     * @param commentId コメントID (一時IDまたは実ID)
-     * @param businessDate 営業日
-     */
     deleteComment: (reportHubId: number, commentId: number, businessDate: string) => Promise<void>;
-    /**
-     * スターの状態を切り替えます。
-     * @param reportHubId 日報HubID
-     * @param isStarred 新しいスター状態
-     * @param businessDate 営業日
-     */
     toggleStar: (reportHubId: number, isStarred: boolean, businessDate: string) => Promise<void>;
-    /**
-     * 既読の状態を切り替えます。
-     * @param reportHubId 日報HubID
-     * @param isRead 新しい既読状態
-     * @param businessDate 営業日
-     */
     toggleRead: (reportHubId: number, isRead: boolean, businessDate: string) => Promise<void>;
     createReport: (businessDate: string) => Promise<number>;
     updateReport: (reportHubId: number, data: {
@@ -376,59 +333,28 @@ type DailyReportActionContextType = {
     }, businessDate: string) => Promise<void>;
     publishReport: (reportHubId: number, businessDate: string) => Promise<void>;
     deleteReport: (reportHubId: number, businessDate: string) => Promise<void>;
-    /** stale アイテムをリストから除去する安全弁 */
     removeStaleItem: (reportHubId: number) => void;
-    /** データのみリロード (ページリロードなし) */
     refetchData: () => Promise<void>;
-    /** キャッシュを破棄してデータのみ再読み込み (ページリロードなし) */
     clearCacheAndRefetch: () => Promise<void>;
 };
 declare global {
     var __DailyReportActionContext: Context<DailyReportActionContextType | null> | undefined;
 }
 declare const useDailyReportActionContext: () => DailyReportActionContextType;
-/**
- * Provides a context for daily report actions including comments, stars, leads, and basic CRUD operations.
- * Also manages optimistic UI updates and real-time synchronization via SSE.
- * 日報のアクション（コメント追加・削除、スター、既読）を管理するプロバイダー。
- * 楽観的UI更新とAPI通信の抽象化を提供します。
- */
 declare const DailyReportActionProvider: ({ children, user, initialItems, userId }: {
     children: ReactNode;
     user?: DailyReportUser;
     initialItems?: DailyReportItem[];
     userId?: string | null;
 }) => react.JSX.Element;
-
 type DailyReportErrorSurface = {
-    /** ミューテーション失敗を通知する。 */
     notifyError: (info: DailyReportErrorInfo) => void;
 };
-/**
- * Returns the error-surface API (safe no-op outside the provider).
- * 通知 API を返す処理 (Provider 外では no-op)。
- */
 declare const useDailyReportErrorSurface: () => DailyReportErrorSurface;
-/**
- * Provides the mutation error surface and renders the default alert banner.
- * ミューテーション通知シームを供給し、既定のアラートバナーを描画するプロバイダー。
- *
- * `config.onError` があればホストへ委譲し、内蔵バナーは描画しない (二重表示防止)。
- */
 declare const DailyReportErrorProvider: ({ children }: {
     children: ReactNode;
 }) => react.JSX.Element;
-
-/**
- * Animates numeric changes with ease-out cubic.
- * 数値変化をイーズアウト 3 次で補間するフック。
- *
- * @param value Target value. 目標値。
- * @param durationMs Animation duration. アニメーション時間 (既定 250ms)。
- * @returns Displayed (interpolated) value. 表示用の補間値。
- */
 declare const useAnimatedNumber: (value: number, durationMs?: number) => number;
-
 type CacheEntry<T> = {
     data: T;
     expiresAt: number;
@@ -443,114 +369,30 @@ declare const DailyReportCache: {
     lastMutations: Map<number, number>;
     recentDeletes: Map<number, number>;
     lastPrune: number;
-    /**
-     * Prune expired entries from the cache.
-     * キャッシュから期限切れのエントリを削除する。
-     */
     prune(): void;
-    /**
-     * Clear all cached entries and pending requests.
-     * すべてのキャッシュエントリおよび待機中リクエストをクリアする。
-     */
     clear(): void;
-    /**
-     * Check if the cache entry is still valid.
-     * キャッシュエントリがまだ有効かを確認する。
-     */
     isValid: (ex: number) => boolean;
-    /**
-     * Notify all listeners of a report update.
-     * レポートの更新をすべてのリスナーに通知する。
-     */
     notify: (id: number) => void;
-    /**
-     * Retrieve a cached report by ID.
-     * ID でキャッシュされたレポートを取得する。
-     */
     getReport(id: number, ignoreExpiry?: boolean): DailyReportDetail | null;
-    /**
-     * Retrieve a cached list of reports by business date key.
-     * 営業日キーでレポートのキャッシュリストを取得する。
-     */
     getList(dateKey: string | null, ignoreExpiry?: boolean): DailyReportDetail[] | null;
-    /**
-     * Set a report in the cache and optionally sync with the list cache.
-     * キャッシュにレポートを設定し、必要に応じてリストキャッシュと同期する。
-     */
     set(report: DailyReportDetail, expiresAt: number, syncList?: boolean): void;
-    /**
-     * Update a cached report with partial data.
-     * 部分的なデータでキャッシュされたレポートを更新する。
-     */
     update(id: number, updates: Partial<DailyReportDetail>, strict?: boolean): void;
-    /**
-     * Delete a report from the cache and update the corresponding list.
-     * キャッシュからレポートを削除し、対応するリストを更新する。
-     */
     delete(id: number, date: string): void;
-    /**
-     * Merge server report with cached report to handle optimistic updates and zombies.
-     * サーバーレポートとキャッシュレポートをマージして、楽観的更新とゾンビコメントを処理する。
-     */
     merge(serverReport: DailyReportDetail, cachedReport?: DailyReportDetail | null): DailyReportDetail;
-    /**
-     * Hydrate the cache with fetched reports, handling comment merges and locks.
-     * フェッチされたレポートでキャッシュをハイドレートし、コメントのマージとロックを処理する。
-     */
     cacheMany(reports: DailyReportDetail[], dateKey: string | null, fetchStart: number): DailyReportDetail[];
 };
-/**
- * Update the cache for a single report.
- * 単一レポートのキャッシュを更新する。
- */
 declare const writeCache: (r: DailyReportDetail, exp: number, sync?: boolean) => void;
-/**
- * Get a cached report by ID.
- * ID でキャッシュされたレポートを取得する。
- */
 declare const getCachedReport: (id: number, opts?: {
     ignoreExpiry?: boolean;
 }) => DailyReportDetail | null;
-/**
- * Update specific fields of a cached report.
- * キャッシュされたレポートの特定のフィールドを更新する。
- */
 declare const updateDailyReportCache: (id: number, u: Partial<DailyReportDetail>) => void;
-/**
- * Delete a report from the cache.
- * キャッシュからレポートを削除する。
- */
 declare const deleteDailyReportCache: (id: number, d: string) => void;
-/**
- * Clear all daily report cache store entries.
- * 日報の全キャッシュストアを消去する。
- */
 declare const clearDailyReportCache: () => void;
 declare const acquireMutationLock: (id: number) => void;
 declare const releaseMutationLock: (id: number) => void;
 declare const registerRecentDeletion: (cId: number) => Map<number, number>;
-/**
- * Subscribe to cache-ready events for a specific report.
- * Returns an unsubscribe function.
- *
- * 特定レポートのキャッシュ書き込みを監視する。
- * 解除関数を返す。
- */
 declare const subscribeCacheReady: (reportHubId: number, callback: () => void) => (() => void);
 declare const applyDailyReportServerUpdates: (_reportHubId: number, report: DailyReportDetail) => void;
-/**
- * Applies a broadcast (cross-user SSE) report while preserving the viewer's own per-viewer state.
- * 全ユーザー放送 (SSE) の report を、受信者自身の per-viewer 状態を保持したまま反映する処理。
- *
- * SSE の report-create/update/publish が運ぶ isRead/isStarred は**操作した本人の状態**。
- * そのまま書くと受信者の既読/スター表示が他人の状態で上書きされる。共有フィールドだけを
- * 取り込み、per-viewer フィールドは受信者のキャッシュ値を保持する。ローカルに無い日報は
- * 種まきしない (送信者の per-viewer 値で汚すより、次のフェッチが受信者視点の正しい値を
- * 取るのに任せるほうが安全)。
- *
- * ❗ 信頼できる経路 (自分の HTTP 応答・recipient フィルタ済みの自分宛 status-update) は
- * {@link applyDailyReportServerUpdates} を使うこと — そちらは値をそのまま書く。
- */
 declare const applyBroadcastReportUpdate: (report: DailyReportDetail) => void;
 type DailyReportDetailResource = {
     report: DailyReportDetail | null;
@@ -558,17 +400,8 @@ type DailyReportDetailResource = {
     isLoading: boolean;
     isRefetching: boolean;
 };
-/**
- * Provides a fetcher-driven daily report detail reader with business-date aware caching.
- * 営業日キャッシュ対応の日報詳細取得フック。
- */
 declare const useDailyReportDetail: (reportHubId: number, businessDate: string | null) => DailyReportDetailResource;
-/**
- * Provides a business-date aware prefetch helper.
- * 営業日キャッシュを活用した日報プリフェッチ補助フック。
- */
 declare const useDailyReportPrefetch: () => (date: string | null) => void;
-
 type User = {
     displayName?: string;
     name?: {
@@ -579,10 +412,6 @@ type User = {
         value: string;
     }[];
 };
-/**
- * Manages daily report comments, integrating server data with optimistic local updates.
- * サーバーデータとローカルの楽観的更新を統合して日報コメントを管理するフック。
- */
 declare const useDailyReportComments: (report: DailyReportDetail | null, user: User | null | undefined, userId?: string | null) => {
     uiComments: UIComment[];
     handleAddComment: (content: string) => Promise<void>;
@@ -591,27 +420,13 @@ declare const useDailyReportComments: (report: DailyReportDetail | null, user: U
     setPendingDeleteId: react.Dispatch<react.SetStateAction<string | number | null>>;
     resolvedIdMap: Map<number, number>;
 };
-
 type UseDailyReportSseConnectionOptions = {
     isSseEnabled: boolean;
     onMessage: (payload: Exclude<DailyReportSseMessage, {
         type: "connected";
     }>) => void;
 };
-/**
- * Manages Daily Report SSE connection lifecycle with reconnect handling.
- * Handles open, message parse/dispatch, error logging, retry, and cleanup.
- *
- * 日報 SSE 接続のライフサイクルを管理する Hook。
- * 接続開始、メッセージ解析と配送、エラー時再接続、クリーンアップを管理します。
- */
 declare const useDailyReportSseConnection: ({ isSseEnabled, onMessage }: UseDailyReportSseConnectionOptions) => void;
-
-/**
- * Shared hook for calculating viewport height of virtual scroll containers.
- * 仮想スクロールコンテナのビューポート高さを計測する共通フック。
- */
-
 type UseDynamicViewportHeightOptions = {
     enableMutationObserver?: boolean;
     bottomGap?: number;
@@ -621,37 +436,8 @@ type UseDynamicViewportHeightResult = {
     viewportHeight: number;
     updateViewportHeight: () => void;
 };
-/**
- * Computes and updates the viewport height for scroll containers while reacting to layout changes.
- * レイアウト変化に追従しながらスクロールコンテナのビューポート高さを算出して更新する関数。
- */
 declare const useDynamicViewportHeight: (containerRef: RefObject<HTMLDivElement | null>, options?: UseDynamicViewportHeightOptions) => UseDynamicViewportHeightResult;
-
-/**
- * React Router route helpers for the daily-report page (revalidation policy / client loader).
- * 日報ページ向け React Router ルートヘルパー (再検証ポリシー / クライアントローダー)。
- */
-
-/**
- * Prevents loader revalidation when POP navigations keep identical URL state.
- * URL 状態が同一の POP ナビゲーション時にローダー再検証を抑止。
- */
 declare const dailyReportShouldRevalidate: ShouldRevalidateFunction;
-/**
- * Creates a React Router clientLoader that bootstraps the ids stream session.
- * ID ストリームセッションを起動する React Router clientLoader を生成する処理。
- *
- * ID 一覧は Promise で返さず、モジュール常駐のストリームセッションが供給する
- * (ページ側は `useDailyReportIdsStream` で購読する)。ローダー時点でセッションを
- * 生成することが**コールドロードの最重要最適化** — ページマウントの effect まで
- * 遅らせると、ストリームの開始が「ハイドレーション完了 + effect flush」の後ろに
- * 直列化される。再訪 (セッション既存) は serverLoader を待たずに鮮度確認を先行させる。
- *
- * `config.apiBasePath` を上書きするアプリは同じ値を `options.apiBasePath` にも渡すこと
- * (渡し忘れは初回 1 回だけ誤パス生成 → ページマウントの ensure が自己修復する)。
- *
- * 返す関数へ `hydrate = true as const` を付与済み (初期ハイドレーションでも実行される)。
- */
 declare const createDailyReportClientLoader: <TServerData extends Record<string, unknown>>(options?: {
     apiBasePath?: string;
 }) => {
@@ -660,382 +446,98 @@ declare const createDailyReportClientLoader: <TServerData extends Record<string,
     }): Promise<TServerData>;
     hydrate: true;
 };
-
-/** ストリームのライフサイクル局面。 */
 type DailyReportIdsStreamPhase = "idle" | "streaming" | "retrying" | "complete" | "failed" | "auth-required";
-/** publish されるスナップショット。publish 間で参照が安定している。 */
 type DailyReportIdsStreamState = {
-    /** 受信済みアイテム (reportHubId で重複排除済み)。 */
     items: DailyReportItem[];
-    /** 一意アイテム件数 (`items.length` と同値。表示用の別名)。 */
     loadedCount: number;
-    /** サーバー申告の全体件数。先頭行未着なら null。 */
     totalCount: number | null;
-    /** ライフサイクル局面。 */
     phase: DailyReportIdsStreamPhase;
-    /** complete 後のバックグラウンド再検証が走っているか。 */
     isRevalidating: boolean;
-    /** 一度でも完走したか (再検証中の UI 判定に使う)。 */
     hasCompletedOnce: boolean;
-    /**
-     * 直近の「実際の完走」時刻 (未完走は null)。鮮度判定 (SWR 窓) の唯一の根拠。
-     * 完走の publish でのみ更新される — 再検証の諦めなど phase が complete のままの
-     * publish で更新すると、古いデータが新鮮扱いされ再検証が永久に走らなくなる。
-     */
     completedAt: number | null;
-    /** 直近の失敗 (成功で null に戻る)。 */
     error: Error | null;
 };
-/** テスト注入用の依存一式。 */
 type DailyReportIdsStreamClientOptions = {
-    /** API ベースパス (既定 `/daily_report/api`)。 */
     apiBasePath?: string;
-    /** fetch 実装 (既定 globalThis.fetch)。 */
     fetchFn?: (input: string, init: {
         signal: AbortSignal;
         headers: Record<string, string>;
         cache: RequestCache;
     }) => Promise<Response>;
-    /** タイマー実装 (既定 setTimeout / clearTimeout)。 */
     setTimeoutFn?: (handler: () => void, ms: number) => ReturnType<typeof setTimeout>;
     clearTimeoutFn?: (id: ReturnType<typeof setTimeout>) => void;
-    /**
-     * 1 回の read が無音でいられる上限 (ms)。0 以下で無効。
-     * これを超えたら接続を half-open とみなして中断し、retryable として
-     * カーソル再開へ倒す。サーバーのハートビート間隔より必ず長く取る
-     * (生きているが遅いだけの全量クエリ待ちを誤って切らないため)。
-     */
     readStallTimeoutMs?: number;
-    /** 警告ロガー (既定 console.warn)。 */
     warn?: (...args: unknown[]) => void;
-    /**
-     * チャンク由来 publish の合体窓 (ms)。0 で無効 (毎チャンク即時 publish)。
-     * 高速回線ではネットワーク read が密集し、publish ごとに全件ソート + 全行再レンダーが
-     * 走るため、先頭は即時 (初回描画優先)・後続は窓内で合体するスロットルを掛ける。
-     * 完走 publish と外部ミューテーション (ユーザー操作の即時フィードバック) は対象外。
-     */
     publishCoalesceMs?: number;
 };
-/**
- * NDJSON ids stream client with dedupe, cursor resume, and exponential backoff.
- * 重複排除・カーソル再開・指数バックオフを備えた NDJSON ids ストリームクライアント。
- */
 declare class DailyReportIdsStreamClient {
     private readonly apiBasePath;
     private readonly fetchFn;
     private readonly setTimeoutFn;
     private readonly clearTimeoutFn;
     private readonly warn;
-    /** 1 回の read が無音でいられる上限 (ms)。0 以下で無効。 */
     private readonly readStallTimeoutMs;
-    /** reportHubId → アイテム。挿入順を保ち、再開の重複到着を吸収する。 */
     private readonly itemMap;
     private readonly listeners;
     private state;
     private lastCursor;
-    /**
-     * 最後に受け取ったスナップショットトークン。カーソルと**対**で意味を持つ。
-     *
-     * サーバーはこのトークンが現在の配列と一致するときだけカーソルを信用する。
-     * トークンを欠いたカーソルは安全側 (先頭から再送) へ倒されるため、対で送れないなら
-     * 送らないのと同じコスト (全量再送) になる。
-     */
     private lastSnapshot;
     private consecutiveFailures;
     private started;
     private disposed;
-    /** 実行中ループの世代。refresh/dispose で進め、旧ループの続行を無効化する。 */
     private loopGeneration;
     private activeAbortController;
-    /**
-     * 先頭 (cursor 無し) から始まった走査で観測した ID の集合。
-     * 完走時にこの集合へ含まれない Map エントリを剪定し、サーバー側で削除された
-     * 日報がモジュール常駐データに永久残留するのを防ぐ。途中失敗のカーソル再開は
-     * 同じ走査の続きなので集合を引き継ぐ (全区間の和 = サーバーの全量)。
-     */
     private activeSeenIds;
-    /**
-     * 外部削除のトゥームストーン。サーバーは配列全体を先に確定させてから送出するため、
-     * 走査中に届いた削除の後、同じ削除前スナップショットの後続チャンクが同 ID を
-     * 再配送してくる。これを吸収せずに素通しすると、削除済み日報が Map へ戻り
-     * 完走剪定も免れてしまう (観測集合に再記録されるため)。新しい走査の開始
-     * (削除コミット後のスナップショット) でクリアする。
-     */
     private readonly externalRemovalTombstones;
-    /**
-     * 走行中の再検証中に届いた明示的キャッシュバイパス要求の持ち越しフラグ。
-     * 走行中の再検証は中断しない方針のため、要求を黙って捨てず完走後に連結実行する。
-     */
     private pendingForceRefresh;
     private wakeRetryWait;
     private readonly handleOnline;
-    /** チャンク由来 publish の合体窓 (ms)。 */
     private readonly publishCoalesceMs;
-    /** 合体窓のトレーリングタイマー。 */
     private publishCoalesceTimer;
-    /** 直近のアイテム publish 時刻 (leading edge 判定用)。 */
     private lastItemsPublishAt;
     constructor(options?: DailyReportIdsStreamClientOptions);
-    /**
-     * Returns the current snapshot (stable reference between publishes).
-     * 現在のスナップショットを返す処理 (publish 間で参照が安定)。
-     */
     getState(): DailyReportIdsStreamState;
-    /**
-     * Subscribes to snapshot updates.
-     * スナップショット更新の購読を登録する処理。
-     *
-     * @param listener Change callback. 変更通知コールバック。
-     * @returns Unsubscribe function. 購読解除関数。
-     */
     subscribe(listener: () => void): () => void;
-    /**
-     * Starts the initial stream (idempotent).
-     * 初回ストリーミングを開始する処理 (冪等)。
-     */
     start(): void;
-    /**
-     * Restarts after a terminal failure (no-op unless phase is "failed").
-     * failed からの手動再開処理 (failed 以外では何もしない)。
-     *
-     * 受信済みデータと再開カーソルは保持したまま続きから読む。
-     */
     retry(): void;
-    /**
-     * Revalidates a completed stream in the background (SWR-style).
-     * 完走済みストリームをバックグラウンドで再検証する処理 (SWR)。
-     *
-     * カーソルを捨てて先頭から読み直し、Map の重複排除で差分を上書き吸収し、
-     * 完走時に「今回の走査で観測されなかった行」を剪定する (サーバー側削除の反映)。
-     * failed のときはカーソルを保持した再開に切り替える (forceRefresh 指定は失わない)。
-     * streaming/retrying 中は何もしない。
-     *
-     * @param options.forceRefresh サーバー側 SqlResultCache をバイパスするか。
-     */
     refresh(options?: {
         forceRefresh?: boolean;
     }): void;
-    /**
-     * Applies an externally-known upsert (SSE / local mutation) to the resident data.
-     * 外部由来 (SSE / ローカル操作) の upsert を常駐データへ反映する処理。
-     *
-     * これを欠くと、マウント中に作成された日報がストリームセッションに存在せず、
-     * 鮮度窓内の再訪 (再検証なし) で一覧から消える。アクティブな走査中は観測集合にも
-     * 刻み、完走時の剪定で「生きていると分かっている行」を誤って落とさないようにする。
-     */
     applyExternalUpsert(item: DailyReportItem): void;
-    /**
-     * Applies an externally-known removal (SSE report-delete / stale valve) to the resident data.
-     * 外部由来 (SSE report-delete / stale 安全弁) の削除を常駐データへ反映する処理。
-     *
-     * 走査中の後続チャンク (削除前スナップショット) による同一行の再配送は、
-     * クライアント側トゥームストーンが次の新しい走査までブロックする。
-     */
     applyExternalRemoval(reportHubId: number): void;
-    /**
-     * Aborts everything and detaches listeners (terminal).
-     * すべてを中断しリスナーを外す終了処理 (以後再利用不可)。
-     */
     dispose(): void;
-    /**
-     * Connection-retry loop: stream → classify → backoff → resume.
-     * 接続リトライループ。ストリーム → 結果分類 → バックオフ → カーソル再開。
-     */
     private runStreamLoop;
-    /**
-     * Prunes map entries not observed by the completed full scan.
-     * 完走した全量走査で観測されなかった Map エントリを剪定する処理。
-     *
-     * サーバー側で削除された日報の残留 (再訪時の亡霊復活・loadedCount > totalCount) を防ぐ。
-     * 観測集合が無い場合 (理論上到達しない防御) は何も消さない。
-     */
     private pruneUnseenItems;
-    /**
-     * Runs one streaming attempt and classifies its outcome.
-     * 1 回のストリーミング試行を実行し、結末を分類する処理。
-     */
     private streamOnce;
-    /**
-     * Reads one chunk, racing the read against a stall watchdog.
-     * 1 チャンクを読む処理。読み取りを stall ウォッチドッグと競争させる。
-     *
-     * サーバーが無音のまま接続を half-open で放置しても (NAT/プロキシのアイドル切断・
-     * VPN 断・スリープ)、`reader.read()` は永久に保留したままになる。これを検知するため
-     * read とタイマーを競争させ、無音が上限を超えたら番兵を返す。生きているが遅いだけの
-     * 全量クエリ待ちはサーバーのハートビート (空行) が read を解決するので誤検知しない。
-     * `readStallTimeoutMs <= 0` のときは素の read (タイマーを張らない・テスト用)。
-     *
-     * @returns 読み取り結果、または stall を表す番兵。read の reject はそのまま伝播する。
-     */
     private readWithStallGuard;
-    /**
-     * Merges chunk items into the dedupe map.
-     * チャンクのアイテム群を重複排除 Map へ取り込む処理。
-     *
-     * @returns True when anything was added or changed. 追加または内容変化があれば true。
-     */
-    /**
-     * Absorbs one chunk line, applying its restart directive first.
-     * チャンク行を 1 行吸収する処理。再開指示があれば最初に適用する。
-     *
-     * ❗ リセット (restarted) とトークン記録を**この関数の内部**に置くのは意図的。
-     * 「吸収より前に初期化せよ」を呼び出し側の責務にすると、順序を間違えたとき
-     * 再開直後の行が新しい観測集合へ入らず完走剪定で即座に消える。関数へ畳み込めば
-     * 呼び出し側に順序という概念が存在しなくなる。
-     */
     private absorbChunkLine;
-    /** アイテム配列を再スナップショットして即時 publish する。 */
     private publishItems;
-    /**
-     * チャンク由来のアイテム publish をスロットルする (leading edge 即時 + trailing 合体)。
-     * 最初のチャンクは即時に描画へ届け、窓内に密集した後続チャンクは 1 回の publish
-     * (= 1 回の全件ソートと再レンダー) へ合体する。合体窓 0 は無効 (常に即時)。
-     */
     private schedulePublishItems;
-    /** 保留中のトレーリング publish を破棄する (完走 publish が全量を運ぶ場合など)。 */
     private cancelScheduledPublishItems;
-    /** 部分状態をマージした新スナップショットを作り、購読者へ通知する。 */
     private publish;
-    /** 再開カーソル付きのストリーム URL を構築する。 */
     private buildStreamUrl;
-    /**
-     * バックオフ待機。online イベント・dispose・後続ループの開始で早期解除される。
-     *
-     * タイマー ID は待機ごとのローカルに閉じ、共有スロット (wakeRetryWait) は
-     * 「まだ自分を指しているときだけ」外す。単一スロットへ素朴に書くと、
-     * 追い越された旧待機の finish が新しいループのタイマーを消してしまい、
-     * 再検証が永久に固まる (実測済みの競合)。
-     */
     private waitBeforeRetry;
 }
-
-/**
- * Full-document reload indirection (mockable seam for auth-expiry tests).
- * ドキュメント全体を再読込する間接層 (認証切れテストで差し替え可能にする継ぎ目)。
- */
 declare const reloadDocument: () => void;
-/**
- * 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)。
- */
 declare const ensureDailyReportIdsStreamSession: (options: {
     apiBasePath?: string;
     userKey: string | null;
 }) => void;
-/**
- * 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)。
- */
 declare const bootstrapDailyReportIdsStreamSession: (options: {
     apiBasePath?: string;
     userKey: string | null;
 }) => void;
-/**
- * Kicks a freshness check for an existing session before the user is known.
- * ユーザー確定前に既存セッションの鮮度確認だけを先行させる処理。
- *
- * clientLoader が serverLoader を await する前に呼び、再訪 (支配的経路) の
- * 再検証開始を数十〜数百 ms 前倒しする。セッションが無ければ何もしない
- * (誰のデータを読むべきか分からないため)。直後の reconcile が userKey を照合し、
- * ユーザーが変わっていればセッションごと破棄されるので先行は安全。
- * 走行中の再検証は中断しない (runFreshnessCheck の isRevalidating ガード)。
- */
 declare const primeDailyReportIdsStreamSession: () => void;
-/**
- * Relays an externally-known item upsert into the resident stream data.
- * 外部由来のアイテム upsert を常駐ストリームデータへ中継する処理。
- *
- * プロバイダーの作成/公開系ミューテーション (ローカル操作と SSE) から呼ばれる。
- * これを欠くと、鮮度窓内の再訪で「作成したばかりの日報が消える」。
- */
 declare const upsertDailyReportIdsStreamItem: (item: DailyReportItem) => void;
-/**
- * Relays an externally-known item removal into the resident stream data.
- * 外部由来のアイテム削除を常駐ストリームデータへ中継する処理。
- *
- * report-delete SSE・ローカル削除・stale 安全弁から呼ばれる。
- * これを欠くと、鮮度窓内の再訪で「削除したはずの日報が蘇る」。
- */
 declare const removeDailyReportIdsStreamItem: (reportHubId: number) => void;
-/**
- * Restarts a failed stream (UI retry button entry point).
- * failed ストリームを再開する処理 (UI の再試行ボタン入口)。
- */
 declare const retryDailyReportIdsStream: () => void;
-/**
- * Re-validates the stream, optionally bypassing the server-side cache.
- * ストリームを再検証する処理 (サーバーキャッシュのバイパス指定可)。
- *
- * 開発向けリロード/キャッシュクリアボタンから呼ばれる。
- *
- * @param options.forceRefresh サーバー側 SqlResultCache をバイパスするか。
- */
 declare const refreshDailyReportIdsStream: (options?: {
     forceRefresh?: boolean;
 }) => void;
-/**
- * Returns the current session's owner key (undefined when no session exists).
- * 現行セッションの持ち主 (userKey) を返す処理 (セッション不在時は undefined)。
- *
- * 遅延解決するミューテーション継続の門番に使う。POST /action の待機中にリロード無しの
- * ユーザー切替が起きると、切替時の三重遮断 (セッション破棄 + 詳細キャッシュ破棄 +
- * プロバイダーリマウント) の**後**に旧ユーザーの継続が解決し、モジュール常駐状態
- * (新ユーザーのセッション・詳細キャッシュ) へ旧ユーザーのデータを注入してしまう。
- * 継続側は開始時点の userKey とこの値を比較し、不一致 (undefined 含む) なら
- * モジュール常駐状態への書き込みを放棄する (fail-closed)。
- */
 declare const getDailyReportIdsStreamSessionUserKey: () => string | null | undefined;
-/**
- * React binding for the module-resident ids stream session.
- * モジュール常駐 ids ストリームセッションの React バインディング。
- *
- * セッションが後から生成されても再購読なしで追従する (リスナーはセッションではなく
- * モジュールに属する)。スナップショット参照は publish 単位で安定している。
- *
- * @returns Current stream state. 現在のストリーム状態。
- */
 declare const useDailyReportIdsStream: () => DailyReportIdsStreamState;
-/**
- * Destroys the session (test isolation helper).
- * セッションを破棄するテスト用ヘルパー。
- */
 declare const resetDailyReportIdsStreamSessionForTesting: () => void;
-
-/**
- * Shared constants for Daily Report data fetching parameters.
- * 日報データ取得で利用する共通パラメーター。
- */
 declare const DAILY_REPORT_FETCH_DEBOUNCE_MS = 120;
-/**
- * Delay before the provider auto-connects SSE, freeing a browser connection slot for first paint.
- * SSE を自動接続するまでの遅延。初回描画とその中身フェッチへ接続枠を譲るための猶予。
- *
- * HTTP/1.1 のオリジン当たり 6 接続のうち、ids ストリームと SSE で 2 枠を常時占有する。
- * SSE 接続を初回描画直後まで遅らせ、その 1 枠を初回の中身フェッチ (`/business-date`) に回す。
- * リアルタイム更新の初動がこの分だけ遅れるが、その間の状態はストリーム / SWR が担保する。
- */
 declare const SSE_INITIAL_CONNECT_DEFER_MS = 1000;
 declare const DEFAULT_ITEM_HEIGHT = 160;
 declare const ITEM_VERTICAL_PADDING = 6;
@@ -1050,49 +552,9 @@ declare const WHEEL_RESET_TIMEOUT_MS = 240;
 declare const VIRTUAL_SCROLL_OVERSCAN_COUNT = 15;
 declare const SCROLL_BAR_WIDTH = 8;
 declare const MAX_PREVIEW_LINES = 3;
-/**
- * Tap-scroll circle tuning shared by every daily-report list.
- * 日報のすべての一覧が共有するタップスクロールサークルの調整値。
- *
- * ❗ **List タブと DetailList タブで同じ値を使うこと。** 片方だけ独自定義にすると、
- * 同じ指の位置でタブごとに速度が何十倍も違う (実測で最大 77 倍) という事故になる。
- *
- * 値の根拠 (ビューポート 800px で実測):
- *
- * | 引き距離 | 速度 | List (行 160px) |
- * | --- | --- | --- |
- * | 0 | 160 px/s | 1 行/秒 |
- * | 1/4 | 525 px/s | 3.3 行/秒 |
- * | 1/2 | 1,298 px/s | 8 行/秒 |
- * | 最大 | 6,400 px/s | 40 行/秒 (0.67 行/フレーム) |
- *
- * - `exponentialSteepness: 3` — 引き幅の前半をゆっくりにして微速の分解能を確保する。
- *   大きくしすぎると低速域が最小速度へ張り付いて**引いても動かない死角**になる
- *   (旧値 7.5 では引き幅の 43.85% が死角だった)。
- * - `exponentialScale: 8` — 最高速の上限 (ビューポート比)。`maxSpeedMultiplier` と揃えて
- *   上限がどちらで決まるかを一意にする。1 フレームあたりの移動をオーバースキャン
- *   (`VIRTUAL_SCROLL_OVERSCAN_COUNT`) の行数より十分小さく保つ値にすること。
- * - `easedOffset` は使わない。最小速度 160 px/s で十分に遅く、下駄を履かせると
- *   低速域の分解能がその分だけ失われる。
- *
- * 長距離の移動はタップスクロールではなくスクロールバーのつまみ (と
- * `BusinessDayThumbOverlay` の日付表示) が担う。ここを速くして解こうとしない。
- */
 declare const TAP_SCROLL_CIRCLE_OPTIONS: ScrollBarTapCircleOptions;
-/**
- * Pointer types allowed to drag-scroll the list content.
- * 一覧のコンテンツ領域をドラッグしてスクロールできるポインタ種別。
- *
- * ❗ **`enablePointerDrag` を丸ごと切ってはならない。** `ScrollPane` はコンテンツを
- * transform で動かしておりネイティブのスクロール領域を持たない
- * (`.aqvs-scroll-pane-content` は `overflow: hidden`) ため、切るとタッチ端末から
- * スクロール手段が消える (一度そうしてしまい、モバイルで一切スクロールできなくなった)。
- *
- * マウスのドラッグだけを外す。行のタップ判定 (`useTapClick`) ・テキスト選択と競合するため。
- * 画面幅のメディアクエリで切り替える案は採らなかった。画面幅は入力手段を表さないので
- * 「主入力がマウスのタッチ対応ノート」のような端末を取りこぼす。判定は**イベントの
- * ポインタ種別**で行うため、同一端末でマウスと指を使い分けても常に正しく振る舞う。
- */
-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, 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, DailyReportPostedComment, 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 };
+declare const CONTENT_DRAG_POINTER_INPUTS: readonly [
+    "pen",
+    "touch"
+];
+export { BusinessDayThumbOverlay, CONTENT_DRAG_POINTER_INPUTS, DAILY_REPORT_FETCH_DEBOUNCE_MS, DAILY_REPORT_LABEL_CATALOGS, DAILY_REPORT_LABEL_KEYS, DEFAULT_ITEM_HEIGHT, type DailyReportActionContextType, DailyReportActionProvider, DailyReportAttachmentIndicator, DailyReportAttachmentList, DailyReportCache, type DailyReportClientConfig, type DailyReportClientConfigDefaults, type DailyReportClientConfigInput, DailyReportCommentForm, DailyReportCommentList, DailyReportConfigProvider, DailyReportDetailList, type DailyReportDetailListScrollRestore, type DailyReportDetailResource, DailyReportEditForm, type DailyReportErrorInfo, DailyReportErrorProvider, type DailyReportHeaderProps, DailyReportIdsStreamClient, type DailyReportIdsStreamClientOptions, type DailyReportIdsStreamPhase, type DailyReportIdsStreamState, DailyReportIdsStreamStatus, type DailyReportLabelOverrides, type DailyReportLabels, DailyReportList, DailyReportLoadError, DailyReportLoading, type DailyReportLocale, type DailyReportOperation, DailyReportPage, type DailyReportPageProps, DailyReportPostedComment, 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, deleteDailyReportCache, ensureDailyReportIdsStreamSession, getCachedReport, getDailyReportIdsStreamSessionUserKey, primeDailyReportIdsStreamSession, refreshDailyReportIdsStream, registerRecentDeletion, releaseMutationLock, reloadDocument, removeDailyReportIdsStreamItem, resetDailyReportIdsStreamSessionForTesting, resolveDailyReportLabels, resolveSourceTypeConfig, retryDailyReportIdsStream, subscribeCacheReady, updateDailyReportCache, upsertDailyReportIdsStreamItem, useAnimatedNumber, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportErrorSurface, useDailyReportIdsStream, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };