@aiquants/daily-report 0.6.2 → 0.7.0

package/dist/client.d.mts

@@ -1,8 +1,8 @@
 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-rbG114od.mjs';
-import { D as DailyReportItem, a as DailyReportDetail, b as DailyReportUser } from './types-D1PKubyo.mjs';
+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-Df49KA7B.mjs';
 import { ShouldRevalidateFunction } from 'react-router';
 import 'zod';
 
@@ -15,6 +15,36 @@ declare const BusinessDayThumbOverlay: ({ orientation, thumbCenter, label, isDra
     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 DailyReportCommentItemProps = {
     comment: UIComment;
     reportHubId: number;
@@ -122,6 +152,11 @@ type DailyReportFieldLabels = {
     content: string;
     interviewers: string;
     comments: string;
+    attachments: string;
+    /** 実体の消失が確認された添付に添える注記。 */
+    attachmentMissing: string;
+    /** 添付をダウンロードするリンクのラベル。 */
+    attachmentDownload: string;
     tabArticle: string;
     tabRelations: string;
     relationsEmpty: string;
@@ -542,6 +577,49 @@ 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, DAILY_REPORT_FETCH_DEBOUNCE_MS, DEFAULT_ITEM_HEIGHT, DailyReportActionProvider, DailyReportCache, 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, type SourceTypeConfig, TAP_SCROLL_CIRCLE_OPTIONS, UnreadIndicator, VIRTUAL_SCROLL_OVERSCAN_COUNT, WHEEL_RESET_TIMEOUT_MS, acquireMutationLock, applyDailyReportServerUpdates, clearDailyReportCache, createDailyReportClientLoader, dailyReportShouldRevalidate, defaultDailyReportClientConfig, defaultDailyReportFieldLabels, deleteDailyReportCache, fetchDailyReportIds, getCachedReport, registerRecentDeletion, releaseMutationLock, resolveSourceTypeConfig, subscribeCacheReady, updateDailyReportCache, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };
+export { BusinessDayThumbOverlay, CONTENT_DRAG_POINTER_INPUTS, DAILY_REPORT_FETCH_DEBOUNCE_MS, DEFAULT_ITEM_HEIGHT, DailyReportActionProvider, DailyReportAttachmentIndicator, DailyReportAttachmentList, DailyReportCache, 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, type SourceTypeConfig, TAP_SCROLL_CIRCLE_OPTIONS, UnreadIndicator, VIRTUAL_SCROLL_OVERSCAN_COUNT, WHEEL_RESET_TIMEOUT_MS, acquireMutationLock, applyDailyReportServerUpdates, clearDailyReportCache, createDailyReportClientLoader, dailyReportShouldRevalidate, defaultDailyReportClientConfig, defaultDailyReportFieldLabels, deleteDailyReportCache, fetchDailyReportIds, getCachedReport, registerRecentDeletion, releaseMutationLock, resolveSourceTypeConfig, subscribeCacheReady, updateDailyReportCache, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };

package/dist/client.d.ts

@@ -1,8 +1,8 @@
 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-eXcMG-Ej.js';
-import { D as DailyReportItem, a as DailyReportDetail, b as DailyReportUser } from './types-D1PKubyo.js';
+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-RHckD7TS.js';
 import { ShouldRevalidateFunction } from 'react-router';
 import 'zod';
 
@@ -15,6 +15,36 @@ declare const BusinessDayThumbOverlay: ({ orientation, thumbCenter, label, isDra
     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 DailyReportCommentItemProps = {
     comment: UIComment;
     reportHubId: number;
@@ -122,6 +152,11 @@ type DailyReportFieldLabels = {
     content: string;
     interviewers: string;
     comments: string;
+    attachments: string;
+    /** 実体の消失が確認された添付に添える注記。 */
+    attachmentMissing: string;
+    /** 添付をダウンロードするリンクのラベル。 */
+    attachmentDownload: string;
     tabArticle: string;
     tabRelations: string;
     relationsEmpty: string;
@@ -542,6 +577,49 @@ 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, DAILY_REPORT_FETCH_DEBOUNCE_MS, DEFAULT_ITEM_HEIGHT, DailyReportActionProvider, DailyReportCache, 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, type SourceTypeConfig, TAP_SCROLL_CIRCLE_OPTIONS, UnreadIndicator, VIRTUAL_SCROLL_OVERSCAN_COUNT, WHEEL_RESET_TIMEOUT_MS, acquireMutationLock, applyDailyReportServerUpdates, clearDailyReportCache, createDailyReportClientLoader, dailyReportShouldRevalidate, defaultDailyReportClientConfig, defaultDailyReportFieldLabels, deleteDailyReportCache, fetchDailyReportIds, getCachedReport, registerRecentDeletion, releaseMutationLock, resolveSourceTypeConfig, subscribeCacheReady, updateDailyReportCache, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };
+export { BusinessDayThumbOverlay, CONTENT_DRAG_POINTER_INPUTS, DAILY_REPORT_FETCH_DEBOUNCE_MS, DEFAULT_ITEM_HEIGHT, DailyReportActionProvider, DailyReportAttachmentIndicator, DailyReportAttachmentList, DailyReportCache, 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, type SourceTypeConfig, TAP_SCROLL_CIRCLE_OPTIONS, UnreadIndicator, VIRTUAL_SCROLL_OVERSCAN_COUNT, WHEEL_RESET_TIMEOUT_MS, acquireMutationLock, applyDailyReportServerUpdates, clearDailyReportCache, createDailyReportClientLoader, dailyReportShouldRevalidate, defaultDailyReportClientConfig, defaultDailyReportFieldLabels, deleteDailyReportCache, fetchDailyReportIds, getCachedReport, registerRecentDeletion, releaseMutationLock, resolveSourceTypeConfig, subscribeCacheReady, updateDailyReportCache, useDailyReportActionContext, useDailyReportComments, useDailyReportConfig, useDailyReportDetail, useDailyReportPrefetch, useDailyReportSseConnection, useDynamicViewportHeight, writeCache };