@aiquants/daily-report 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI Quants
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,150 @@
+# @aiquants/daily-report
+
+Reusable **daily-report** feature package: a virtual-scrolling report list/detail UI with optimistic updates and SSE real-time sync (React Router v7), plus a drizzle (**mssql**) server layer — all app-specific concerns (auth, user resolution, id obfuscation, redis, legacy tables, chrome) injected via DI ports.
+
+Follows the `@aiquants/authz-*` DI layering — every app-specific concern (auth, user resolution, id obfuscation, redis, legacy tables) is injected via ports, so the package itself carries no application- or domain-specific knowledge. Packaged as one module with three entries:
+
+| Entry | Contents | Environment |
+| :--- | :--- | :--- |
+| `@aiquants/daily-report` | Types, zod SSE schemas, business-date / text / comment utilities | isomorphic |
+| `@aiquants/daily-report/client` | `DailyReportPage`, list/detail components, hooks, action context, route helpers | browser (React) |
+| `@aiquants/daily-report/server` | `createDailyReportServer` (service + loaders/actions), `defineDailyReportSchema`, SSE fan-out reader, SQL result cache | node |
+
+## Install
+
+Monorepo (already a pnpm workspace package):
+
+```jsonc
+// consumer package.json
+"dependencies": { "@aiquants/daily-report": "workspace:*" }
+```
+
+External projects:
+
+```bash
+pnpm add @aiquants/daily-report react react-dom react-router drizzle-orm zod
+```
+
+`react` / `react-dom` / `react-router` / `drizzle-orm` / `zod` are **peer dependencies**. Build / test: `pnpm run build` (tsup → dist) / `pnpm run test` (vitest).
+
+### Tailwind CSS
+
+Components carry Tailwind utility classes in JSX (no compiled CSS is shipped). Add the package source to your app's Tailwind scan targets:
+
+```css
+/* app tailwind.css (Tailwind v4) */
+@source "../node_modules/@aiquants/daily-report/src/**/*.{ts,tsx}";
+/* monorepo: @source "../../../../packages/daily-report/src/**/*.{ts,tsx}"; */
+```
+
+## Required database schema
+
+Six tables: `DailyReportHub` (中核・出所横断), `DailyReportInternal` (アプリ内作成本文), `DailyReportComment`, `DailyReportLabel`, `DailyReportHub_Label`, `DailyReportUserStatus` (既読・スター)。
+
+Existing apps can inject their own drizzle models (structural typing — see `DailyReportTables`). Greenfield projects can generate definitions:
+
+```ts
+import { defineDailyReportSchema } from "@aiquants/daily-report/server"
+const tables = defineDailyReportSchema("dbo_app", { userTable: Users })
+```
+
+`DailyReportHub.source_id_num` is a computed column (`TRY_CAST(source_id AS BIGINT)`), used to join external legacy sources.
+
+## Server wiring (DI)
+
+```ts
+// app/services/daily-report/config.server.ts
+import { createDailyReportServer, type DailyReportDb, type DailyReportRedisProvider } from "@aiquants/daily-report/server"
+
+export const dailyReportServer = createDailyReportServer({
+    db: db as unknown as DailyReportDb,          // drizzle mssql handle
+    tables: { hub, internal, comment, label, hubLabel, userStatus },
+    userTable: Users,                            // { id, displayName }
+    resolveUserId: async (externalId) => {/* 外部 ID (Google sub 等) → 内部数値 ID */},
+    encodeUserId: (id) => encodeId(id),          // 内部 ID の難読化 (例: sqids)
+    authenticate: authenticateInLoader,          // (request, { failureRedirect }) => { user?, cookie? }
+    redis: redisProvider as unknown as DailyReportRedisProvider, // 省略可 (SSE/epoch 無効化)
+    externalSources: [                           // 省略可: 別システムのレガシー日報テーブルの取り込み
+        { sourceType: "legacy", table: LegacyReport, idColumn: LegacyReport.reportId, mapRow: mapLegacyRow },
+    ],
+    draftLabelName: "draft",                     // 必須: 自 DB のドラフトラベル名 (パッケージは既定値を持たない)
+})
+```
+
+Route mounts (React Router v7, file convention は自由):
+
+```ts
+// daily_report._index/loader.server.ts
+export const loader = async (args) => {
+    const r = await dailyReportServer.index.loader(args)
+    return data(r.data, { headers: r.headers })
+}
+// daily_report.api.$endpoint/route.tsx
+export const loader = (args) => dailyReportServer.api.loader(args)
+export const action = (args) => dailyReportServer.api.action(args)
+// sse.daily_report.$endpoint/route.tsx
+export const loader = (args) => dailyReportServer.sse.loader(args)
+```
+
+### DI ports
+
+- `authenticate(request, { failureRedirect })` — セッション検証。`failureRedirect: string` のとき未認証は redirect を throw する実装にする。
+- `resolveUserId(externalId)` — 外部 ID → 内部数値 ID (`null` = 未登録)。プロセス内キャッシュは `disableUserIdCache` で無効化可 (テスト用)。
+- `encodeUserId(id)` — クライアントへ出す ID の難読化。既存 ID 空間を維持するためアプリ側実装を注入する。
+- `redis` — `getClient()` (get/incr/xAdd/xRange/xRevRange) + `createClient()` (blocking xRead)。`node-redis` v5 クライアントが構造的に適合する。省略時: SSE publish はスキップ (warn)、epoch 無効。
+- `externalSources[]` — `Hub.source_type` 一致時に `Hub.source_id_num = idColumn` で LEFT JOIN し `mapRow` で表示フィールドへ変換。
+- `draftLabelName` — **必須**。ドラフト状態を表す自 DB のラベル名。サーバー側のクロスユーザー可視性フィルタ (他ユーザーの下書きを隠す) に使うため、パッケージはサイレントな既定値を持たない。
+- 主要チューニング: `idsTtlMs` (180s) / `businessDateTtlMs` (300s) / `streamKey` / `streamMaxLen` / `loginRedirectPath`。
+
+## Client wiring
+
+```tsx
+// daily_report._index/route.tsx
+import { createDailyReportClientLoader, DailyReportPage, dailyReportShouldRevalidate } from "@aiquants/daily-report/client"
+
+export const shouldRevalidate = dailyReportShouldRevalidate
+export const clientLoader = createDailyReportClientLoader()   // /daily_report/api/ids を defer 取得
+
+export default function Route() {
+    const { user, userId, dailyReportIds } = useLoaderData<typeof clientLoader>()
+    return (
+        <YourAppLayout>
+            <DailyReportPage
+                user={user}
+                userId={userId}
+                dailyReportIds={dailyReportIds}
+                config={{
+                    renderHeader: ({ title, annotation }) => <YourHeader title={title} annotation={annotation} />,
+                    showDevControls: import.meta.env.DEV,   // SSE 購読トグル等
+                    draftLabelName: "draft",                // ドラフト状態のラベル名 (自 DB に合わせる)
+                    fieldLabels: {                          // 詳細/一覧カードの見出しラベル (下記参照。部分上書き可)
+                        businessDate: "日付", content: "本文", comments: "コメント", /* ... 各キーを自アプリの言語・表記へ */
+                    },
+                    // apiBasePath: "/daily_report/api", ssePath: "/sse/daily_report/updates"
+                }}
+            />
+        </YourAppLayout>
+    )
+}
+```
+
+`DailyReportPage` はレイアウト非依存 (ヘッダーは `renderHeader` スロット、エラー境界・フッター制御はアプリ側)。細粒度に使う場合は `DailyReportActionProvider` / `DailyReportResolvedContent` / `useDailyReportDetail` 等を個別 import できる。
+
+### フィールドラベル (`fieldLabels`)
+
+詳細/一覧カードの見出し (`id` / `businessDate` / `author` / `visitTime` / `createdAt` / `updatedAt` / `updatedBy` / `category` / `categoryInfo` / `creationCategory` / `customer` / `subject` / `content` / `interviewers` / `comments` / `tabArticle` / `tabRelations` / `relationsEmpty`) はすべて DI。**パッケージは中立な英語 (`Business date` / `Customer` / `Content` 等) のみを既定で同梱**し、各見出しの言語・表記は消費アプリが `fieldLabels` で上書きする。これによりパッケージ本体は業務ドメイン固有の表記を持たない。部分指定した分だけ既定へ上書きされる (`DailyReportConfigProvider` が 1 段深くマージ)。
+
+## Realtime architecture
+
+1. 変更系サービスは `invalidate → epoch increment → SSE publish` の順で Redis Stream (`daily-report:sse-stream`) へ発行。
+2. `DailyReportSseReader` が単一の blocking `xRead` ループで全 SSE 接続へ fan-out (接続ごとの Redis TCP を排除)。
+3. `sse.loader` は `Last-Event-ID` / `lastEventId` による catch-up (`xRange`) と 5 秒 keep-alive を実装。`recipientRawUserId` はサーバー側でフィルタ後に除去される (内部 ID 漏洩防止)。
+4. クライアントは `useDailyReportSseConnection` が指数バックオフ再接続し、アクションコンテキストが楽観的更新と SSE エコーを `clientTempId` で照合する。
+
+## API surface (抜粋)
+
+- server: `createDailyReportServer` / `createDailyReportService` / `createDailyReportHandlers` / `defineDailyReportSchema` / `DailyReportSseReader` / `SqlResultCache` / `transformJsonArray` / `jsonResponseWithETag` / `generateETag` / `isStreamIdLte`
+- client: `DailyReportPage` / `DailyReportResolvedContent` / `DailyReportList` / `DailyReportDetailList` / `DailyReportActionProvider` / `useDailyReportActionContext` / `useDailyReportDetail` / `useDailyReportPrefetch` / `useDailyReportComments` / `useDailyReportSseConnection` / `DailyReportConfigProvider` / `createDailyReportClientLoader` / `dailyReportShouldRevalidate`
+- shared: `DailyReportItem` / `DailyReportDetail` / `DailyReportUser` / `dailyReportSseMessageSchema` (8 種 discriminated union) / `normalizeBusinessDateKey` / `mergeComments`
+
+MIT

package/dist/client.d.mts

@@ -0,0 +1,449 @@
+import * as react from 'react';
+import { ReactNode, Context, RefObject } from 'react';
+import { ScrollBarThumbOverlayRenderProps, ScrollPaneInertiaOptions, ScrollBarTapCircleOptions } from '@aiquants/virtualscroll';
+import { U as UIComment, D as DailyReportSseMessage } from './sse-schema-yl5AaSsj.mjs';
+import { D as DailyReportItem, a as DailyReportDetail, b as DailyReportUser } from './types-CVhwLhSN.mjs';
+import { ShouldRevalidateFunction } from 'react-router';
+import 'zod';
+
+/**
+ * Tooltip bubble that anchors to the scrollbar thumb while interacting.
+ * スクロール操作中にスクロールバーのサムへ連動表示するツールチップのコンポーネント。
+ */
+declare const BusinessDayThumbOverlay: ({ orientation, thumbCenter, label, isDragging, isTapScrollActive, isWheelScrollActive }: ScrollBarThumbOverlayRenderProps & {
+    label: string;
+    isWheelScrollActive: boolean;
+}) => react.JSX.Element | null;
+
+type DailyReportCommentItemProps = {
+    comment: UIComment;
+    reportHubId: number;
+    businessDate: string;
+    onOptimisticDelete: (commentId: number) => void;
+    pendingDeleteId: number | string | null;
+    onPendingDeleteIdChange: (id: number | string | null) => void;
+    onTrashClick: (e: React.MouseEvent | React.TouchEvent, commentId: number | string) => void;
+    resolvedIdMap?: Map<number, number>;
+};
+/**
+ * Renders a single comment item with delete functionality.
+ * 削除機能付きの単一コメントアイテムを描画するコンポーネント。
+ */
+declare const DailyReportCommentItem: ({ comment, reportHubId: _reportHubId, businessDate: _businessDate, onOptimisticDelete, pendingDeleteId, onPendingDeleteIdChange, onTrashClick, resolvedIdMap }: DailyReportCommentItemProps) => react.JSX.Element;
+
+type DailyReportCommentListProps = {
+    comments: UIComment[];
+    reportHubId: number;
+    businessDate: string;
+    onDeleteComment?: (commentId: number) => void;
+    pendingDeleteId: number | string | null;
+    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;
+
+type DailyReportDetailListProps = {
+    dailyReportItems: DailyReportItem[];
+    userId?: string | null;
+    selectedItemId?: number | null;
+    onSelectItem?: (id: number | null) => void;
+};
+/**
+ * Daily report detail cards rendered with dynamic height virtual scroll.
+ * 動的高さの仮想スクロールで日報詳細カードを描画するコンポーネント。
+ */
+declare const DailyReportDetailList: ({ dailyReportItems, userId, selectedItemId, onSelectItem }: DailyReportDetailListProps) => react.JSX.Element;
+
+type DailyReportEditFormProps = {
+    report: DailyReportDetail;
+    onCancel?: () => void;
+    onPublishSuccess?: () => void;
+};
+declare const DailyReportEditForm: ({ report, onCancel, onPublishSuccess }: DailyReportEditFormProps) => react.JSX.Element;
+
+type DailyReportListProps = {
+    dailyReportItems: DailyReportItem[];
+    initialSelectedBusinessDate?: string | null;
+    initialSelectedReportHubId?: number | null;
+    autoMarkRead?: boolean;
+    selectedReportHubId: number | null;
+    onSelectItem: (reportHubId: number | null) => void;
+    userId?: string | null;
+};
+/**
+ * Daily report list cards with key metadata and preview content via virtual scrolling.
+ * 主なメタデータと内容プレビューを仮想スクロール表示する日報リスト。
+ */
+declare const DailyReportList: ({ dailyReportItems, initialSelectedBusinessDate, initialSelectedReportHubId, autoMarkRead, selectedReportHubId, onSelectItem, userId }: DailyReportListProps) => react.JSX.Element;
+
+/** ヘッダー描画スロットに渡される引数。 */
+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;
+    tabArticle: string;
+    tabRelations: string;
+    relationsEmpty: string;
+};
+/** クライアント層の設定一式。 */
+type DailyReportClientConfig = {
+    /** 画面タイトル (ヘッダーへ渡す)。 */
+    title: string;
+    /** API ベースパス (例 `/daily_report/api`)。末尾スラッシュ無し。 */
+    apiBasePath: string;
+    /** SSE エンドポイントパス (例 `/sse/daily_report/updates`)。 */
+    ssePath: string;
+    /** 下書き状態を表すラベル名。UI の編集モード判定に使う。既定はプレースホルダーなので消費側で自アプリのラベル名へ上書きする。 */
+    draftLabelName: string;
+    /** 詳細/一覧カードのフィールド見出しラベル。既定は中立英語。アプリが自ドメインの表記を注入する。 */
+    fieldLabels: DailyReportFieldLabels;
+    /** ヘッダー描画スロット。アプリのヘッダーコンポーネントを差し込む。 */
+    renderHeader: (props: DailyReportHeaderProps) => ReactNode;
+    /** 開発向けコントロール (SSE 購読トグル等) を表示するか。 */
+    showDevControls: boolean;
+};
+/**
+ * Partial client-config override. `fieldLabels` may itself be partially overridden.
+ * クライアント設定の部分上書き型。`fieldLabels` も部分上書き可 (プロバイダーが深くマージする)。
+ */
+type DailyReportClientConfigInput = Partial<Omit<DailyReportClientConfig, "fieldLabels">> & {
+    fieldLabels?: Partial<DailyReportFieldLabels>;
+};
+/** 中立英語のフィールドラベル既定 (ドメイン非依存)。 */
+declare const defaultDailyReportFieldLabels: DailyReportFieldLabels;
+/** 既定設定 (消費側は必要なフィールドのみ部分上書きする)。 */
+declare const defaultDailyReportClientConfig: DailyReportClientConfig;
+/**
+ * Provides a partial override of the daily-report client configuration.
+ * 日報クライアント設定の部分上書きを提供するプロバイダー。
+ */
+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;
+
+/**
+ * Error display component for daily report data fetch failures.
+ * 日報データの取得失敗時に表示するエラーコンポーネント。
+ */
+declare const DailyReportLoadError: () => react.JSX.Element;
+/**
+ * Suspense fallback while daily report identifiers resolve.
+ * 日報 ID 解決中のサスペンスフォールバック。
+ */
+declare const DailyReportLoading: () => react.JSX.Element;
+type DailyReportPageProps = {
+    /** 表示中ユーザー (楽観的コメントの作者名等に使用)。 */
+    user?: DailyReportUser;
+    /** 難読化済みの内部ユーザー ID (未登録ユーザーは null)。 */
+    userId?: string | null;
+    /** clientLoader で defer した日報 ID 一覧 (Promise) または解決済み配列。 */
+    dailyReportIds?: Promise<DailyReportItem[]> | DailyReportItem[] | null;
+    /** クライアント設定の部分上書き (ヘッダー描画・パス・ラベル名・フィールドラベルなど)。 */
+    config?: DailyReportClientConfigInput;
+};
+/**
+ * Chrome-agnostic daily report page with client configuration provider.
+ * 設定プロバイダー込みの日報ページコンポーネント。
+ */
+declare const DailyReportPage: ({ config, ...rest }: DailyReportPageProps) => react.JSX.Element;
+
+type DailyReportResolvedContentProps = {
+    dailyReportItems: DailyReportItem[];
+    userId?: string | null;
+};
+/**
+ * Displays fetched daily reports with layout and tabbed virtual scroll views.
+ * レイアウトとタブ付き仮想スクロールで取得済み日報を表示するコンポーネント。
+ */
+declare const DailyReportResolvedContent: ({ dailyReportItems: _initialItems, 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: {
+        title?: string;
+        content?: string;
+    }, businessDate: string) => Promise<void>;
+    publishReport: (reportHubId: number, businessDate: string) => Promise<void>;
+    deleteReport: (reportHubId: number, businessDate: string) => Promise<void>;
+    /** stale アイテムをリストから除去する安全弁 */
+    removeStaleItem: (reportHubId: number) => 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;
+
+/**
+ * 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;
+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: (_reportHubIdd: number, report: DailyReportDetail) => void;
+type DailyReportDetailResource = {
+    report: DailyReportDetail | null;
+    error: Error | null;
+    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?: {
+        familyName?: string;
+        givenName?: string;
+    };
+    emails?: {
+        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>;
+    handleDeleteComment: (cId: number) => Promise<void> | null;
+    pendingDeleteId: string | number | null;
+    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;
+    minFallbackHeight?: number;
+};
+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;
+/**
+ * Fetches the deferred daily report id list from the API endpoint.
+ * API エンドポイントから日報 ID 一覧を遅延取得する処理。
+ */
+declare const fetchDailyReportIds: (apiBasePath?: string) => Promise<DailyReportItem[]>;
+/**
+ * Creates a React Router clientLoader that merges server data with deferred report ids.
+ * サーバーデータへ遅延日報 ID を合成する React Router clientLoader を生成する処理。
+ *
+ * 返す関数へ `hydrate = true as const` を付与済み (初期ハイドレーションでも実行される)。
+ */
+declare const createDailyReportClientLoader: <TServerData extends Record<string, unknown>>(options?: {
+    apiBasePath?: string;
+}) => {
+    (args: {
+        serverLoader: () => Promise<unknown>;
+    }): Promise<TServerData & {
+        dailyReportIds: Promise<DailyReportItem[]>;
+    }>;
+    hydrate: true;
+};
+
+/**
+ * Shared constants for Daily Report data fetching parameters.
+ * 日報データ取得で利用する共通パラメーター。
+ */
+declare const DAILY_REPORT_FETCH_DEBOUNCE_MS = 180;
+declare const DEFAULT_ITEM_HEIGHT = 160;
+declare const ITEM_VERTICAL_PADDING = 6;
+declare const ITEM_CONTAINER_HEIGHT: number;
+declare const FAST_SCROLL_WHEEL_MULTIPLIER = 0.8;
+declare const FAST_SCROLL_INERTIA_OPTIONS: ScrollPaneInertiaOptions;
+declare const PREFETCH_LOOKAHEAD = 20;
+declare const PREFETCH_MAX_DATES = 6;
+declare const EMPTY_ITEM: DailyReportItem;
+declare const EMPTY_DETAIL: DailyReportDetailResource;
+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;
+declare const TAP_SCROLL_CIRCLE_OPTIONS: ScrollBarTapCircleOptions;
+
+export { BusinessDayThumbOverlay, DAILY_REPORT_FETCH_DEBOUNCE_MS, DEFAULT_ITEM_HEIGHT, DailyReportActionProvider, type DailyReportClientConfig, type DailyReportClientConfigInput, DailyReportCommentForm, DailyReportCommentItem, DailyReportCommentList, DailyReportConfigProvider, DailyReportDetailList, type DailyReportDetailResource, DailyReportEditForm, type DailyReportFieldLabels, type DailyReportHeaderProps, 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, TAP_SCROLL_CIRCLE_OPTIONS, UnreadIndicator, VIRTUAL_SCROLL_OVERSCAN_COUNT, WHEEL_RESET_TIMEOUT_MS, acquireMutationLock, applyDailyReportServerUpdates, createDailyReportClientLoader, dailyReportShouldRevalidate, defaultDailyReportClientConfig, defaultDailyReportFieldLabels, deleteDailyReportCache, fetchDailyReportIds, getCachedReport, registerRecentDeletion, releaseMutationLock, subscribeCacheReady, updateDailyReportCache, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };