@aiquants/daily-report 0.42.0 → 0.43.0

package/CHANGELOG.md

@@ -2,6 +2,152 @@
 
 All notable changes to `@aiquants/daily-report` are documented here.
 
+## 0.43.0 (2026-10-14)
+
+### Added
+
+- **クライアントの入口の区分のトークンの畳み方** `foldDailyReportSourceTypeToken` (共有の入口と同じ関数): ブラウザーへ配る経路のモジュールは
+  `@aiquants/daily-report/client` から読む。共有の入口は束を分けないので、そこから読んだ経路のモジュールは共有のモジュールの 2 つ目の写しを経路のチャンクへ
+  持ち込む (経路のチャンクごとに 3,992 B、gzip で 1,691 B)。
+- **ストリームへ書く形の SSE のメッセージのスキーマと型** `dailyReportSseStreamMessageSchema`・`DailyReportSseStreamMessage` (server エントリ): 共有リーダーが読んだ
+  エントリの値 (`DailyReportSseEntryMessage.parsed`) はこの形 (下の Breaking)。
+- **E2E の試験の口の行の 2 段目の描画の数** `rowPass.counters()` (`DailyReportViewTestHandle`。両ビューの `__virtualScroll`): ビューのマウントからの送り手の 4 つの数を
+  読んだ時点の値で返す (`syncReleases`: 確定か知らせのマイクロタスクの確定の中で同期的に描いた単位・`oversizeFrames`: 最初の単位だけで分け前を超えたキーの無い
+  フレーム・`lateFrames`: 飛ばした遅れたキーの無いフレーム・`lateForcedFrames`: 遅れていても単位を当てはめたキーの無いフレーム)。ホストの性能の計測は押し続けの
+  前と後に読んで差を取り、送り手の定数も規則も写さない。型だけの公開なのでバンドルは増えない。
+
+### Changed
+
+- **検索窓の既定の入力例を短くした**: `searchPlaceholder` の既定を `検索` (en: `Search`) にした。320 px の画面の入力欄 (全角 4 字ぶん) でも切れない。
+  名前 (`searchInputLabel`) は `日報を検索` (en: `Search reports`) のまま。
+- **キーを押し続ける間も、行の単位はキーの無いフレームで 1 つの確定として描く** (行の 2 段目の描画): 殻の行の本体・カードの差し替え・検索の印の変化は、
+  どれもビューに 1 つの送り手が自分のフレームのコールバックの中で 1 つの確定 (`flushSync`) として当てはめ、そのフレームの間隔がキーの仕事を持たないときだけ
+  当てはめる: 前のコールバックの後にビューのウィンドウへ keydown か keyup が配られず (受動の捕獲段の聞き手が数えるだけで、DOM を読まない)、長押しの流れが
+  フレームのコールバックで段を当てはめず、流れが溜めた段を持たないフレーム。送り手が自分のフレームで当てはめる単位は押し続けの外の 1 回の押下でも同じ規則で、
+  キーの描くフレームに載ることは無い (単位を確定する場所はほかに 2 つで、見えるようになった行の単位は見えるようにした確定の中で、押し続けの外で見えている行へ
+  届いた入力は届いた確定か知らせた処理の終わりの確定で描く。下の「行は 1 つの入力の元から単位でだけ描く」)。
+  眠った送り手が起きた後の最初のコールバックは測るだけ。0.42.0 の、次の繰り返しの keydown を見込んで `MessageChannel` の枠で当てはめる形はやめた。
+  - **単位の仕事はそのフレームで終わる**: DetailList の行の高さの監視は、配達を 1 つの同期の確定で確定するので、本体の高さ・VirtualScroll の位置 (可視の先頭より
+    上の行の補正を含む)・遠い行を飛ばしてよいかの宣言は、本体を配置したフレームの中で決まり、次のキーのフレームで置き直さない。配達の確定が見せた行と
+    箱を変えた本体は配達が終わる前に測って確定し、観測はビューの次のフレームのコールバックで始める (配達の中で観測を始めないので、
+    `ResizeObserver loop completed with undelivered notifications` を出さない)。行の高さの配達はビューに 1 つで、スクロール領域が付くところで行の 2 段目の描画と
+    一緒にビューのウィンドウへつなぐので、観測器もフレームの時計もビューが描かれるウィンドウのもの (iframe の中のビューも、その iframe の観測器と時計を使う)。
+  - **フレームごとの単位の数は測った費用で決める**: 最初の単位はいつも、次の単位はその種類の測った費用 (最新 32 回の p90。8 回に満たなければ足さない) の和が
+    フレームの間隔の半分とフレームの残りに収まる間だけ当てはめる。費用は行の箱 (List の決まった箱・DetailList の測る本体) と単位の変化 (殻の上の本体・箱を
+    変えうる変化・印だけ) の組の 6 つの種類ごとに測るので、安い印の単位がカードの見積もりを下げない。今の費用では DetailList はフレームにカード 1 枚、List は 1〜3 行。
+  - **遅れて始まったフレームは飛ばす**: コールバックの前に GC や長い処理が走ったフレームは、最初の単位の見積もりがフレームの残り (間隔から余白 2 ms と遅れを
+    引いた時間) を超えれば当てはめずに次のキーの無いフレームを待つ。見える帯か届く帯の単位が待つ遅れたフレームは続けて 1 つまで。
+  - **押し続けの間は進む向きの先の行を先に描く**: 遠い帯の行のうち、進む向きの前のものは近い帯の後に距離の順に描き (押し続けが届く帯へ入れる行は先に本体を
+    持つ)、後ろのものは押し続けが終わってから描く。同じ順位の単位は先に加えたものが先 (下の Fixed)。
+  - **行は 1 つの入力の元から単位でだけ描く**: 両ビューの行コンテナは、日報の詳細と検索の印を行ごとの入力の元から殻のマウントの時点で購読し、届いた値を行の単位で
+    描く (届いた答えが行コンテナをその場で描き直さない)。見えている行へ届いた値は、押し続けの外なら届いた確定か知らせた処理の終わりの 1 つの確定で描く。
+  - **日報の詳細は日報ごとに 1 つの記録を分け合う**: 詳細の記録と読み込みは、画面の API の基点と詳細の読み方ごとに 1 つの置き場が日報 id ごとに持ち、id の最初の
+    読み手が読み込みを始め、最後の読み手が止める (止めた後に届いた答えは捨てる)。キャッシュの書き込みはその id の読み手にだけ、答え 1 つに 1 回知らせる。
+    `useDailyReportDetail(reportHubId, businessDate)` は引数と返す値をそのままに、置き場の記録を既定の優先度の状態で返す。同じ日報を描く行と側面ペインは記録を
+    分け合うので、どちらかが読む間は取り直しを重ねず、同じ読み込みを待った読み手は誤りも 1 回ずつ受ける。分け合うのは決着した日報で、決着した読み込みの誤りは
+    分け合わない: 誤りを持つ記録へ後から加わった読み手 (載った行・入力の先導の帯に入った id・側面ペイン) は頼み直し、答えが誤りを消す。頼み直すのは新しい購読だけ
+    (描き直しと同じ聞き手の 2 度目の購読では頼み直さないので、誤りを描き続ける行が頼み直しを繰り返さない) で、閲覧者のセッションの断り (401・403) は日報と同じく
+    分け合って頼み直さない。鮮度も新しい読み手が加わるときに確かめる: キャッシュの項目が期限切れになった記録へ、答えを待っていないときに新しい読み手が加わると
+    (日報を選び直して作り直される側面ペイン・載った行・先導の帯に入った id)、行が記録を開いたままでも `DAILY_REPORT_FETCH_DEBOUNCE_MS` の後に取り直す (期限切れの
+    日報を描いたままで、答えまでに加わる読み手は 1 本の要求を分け合う)。描いている日報の取り直しが一時の失敗で終わっても日報を誤りに替えず (0.42.0 は読み手が誤りを
+    描いた)、`[DailyReportDetailLoader]` へ警告を書いて、次の新しい読み手がまた取り直す。セッションの断りは描いている日報の上でも誤りになる。
+  - **検索の答えを見せている間、ビューは行の入力を先に読む**: 描いている行と、描いている範囲の両端の先の 24〜40 行の詳細と印を置き場へ購読させておく (進む側が
+    24 行を切ると 8 行ずつ伸ばし、跳んだ後は両側 32 行)。押し続けの間に載る行は詳細と印を置き場に見つけ、最初の本体から印つきのカードを描く。押し続けの間の
+    要求は置き場ごとに 40 回のキーで 4〜5 本、跳んだ後は置き場ごとに 1 本で、描いている窓と 2 × 32 行の 95〜96 件を運ぶ (描いている窓だけの約 31 件から増える)。
+    借りは置き場ごとに持ち、置き場が替わると替わった置き場の購読だけを返す: 新しい答え (印の置き場の替わり) は印だけを借り直し、詳細の借りと送っている詳細の
+    要求はそのまま (同じ ID をもう一度頼まない)。営業日で読む一覧は今までどおり営業日の先読み (`useDailyReportPrefetch`)。
+  - **検索の印は行の単位の確定で描く**: 印を知っているカードは最初の確定から印つきで描き (素の文字を塗ってから印を塗り直さない)、届いた印は行の 1 つの単位で描く
+    (印だけの変化は行の箱を変えないので、行は飛ばしてよいまま)。一致の説明は、カードを確定した処理のうちに揃う。印の葉は配置の効果 1 つで登録し、集計の登録は
+    札を返して札の登録だけを消す。側面ペインは今までどおり、最初の描画を素の文字で描き、印を後追いの描画で塗る。組み立てた CSS は 0.42.0 と同じで、行の落ち着いた DOM は
+    0.42.0 と画面に出さない文だけが違う (下の 2 つの項: カードの無い行の説明と List のカードの一致の説明)。
+  - 性能の試験 (9 つの条件、30 ms の繰り返しで 40 回のキーの押し続け、各 3 回): キーの届く範囲の内の keydown とキーのフレームの中で描いた行の本体は 0 (0.42.0 は
+    実行ごとに keydown の中で 0〜7、キーのフレームで 2〜7)、キーの仕事と同じフレームで確定した単位 0、予算を超えたフレームは、0.42.0 の計測の数え方 (描画の段から次の描画の段まで) で
+    DetailList の行 110・16,000 行・80,000 行から (答えを見せたまま) 1 / 4 / 2 → 0 / 0 / 2、今の数え方 (ブラウザーのフレームごとに、vsync か前の確定から自分の
+    確定まで。vsync の前の GC はそのフレームに入らない) で 0.43.0 は 0 / 0 / 1、表示の遅れの p95 は 25.57 / 26.28 ms → 20.52 / 21.95 ms (80,000 行からは 26.35 → 26.68 ms で、
+    キーのフレームの層の描き直しが決める)、キーの処理の時間の p95 は最大 3.85 ms、見える範囲へ入った行がカードを待つ時間 (0.42.0 の最大 331.5 ms) は 0。
+    CPU を 4 倍遅くした押し続けでは、見える範囲へ入るどの行もその確定でカードと印まで描き、次のフレームまでの p95 は 108.6 ms (0.42.0 は 50.2 ms。キーの
+    フレームそのものの描画が決める)。
+- **要求の隔離は `@aiquants/request-isolation` の判定**: 別オリジンの判定 (`crossOriginRefusal`) を共有のパッケージから読む (依存 `@aiquants/request-isolation`
+  `^0.1.0` が加わる)。どの要求への答えも変わらない。拒否の記録の行は、判定が拒んだ理由を持つ (`reason=cross-origin-fetch` は Fetch Metadata が別のオリジンを
+  示した要求、`reason=foreign-origin` は Fetch Metadata が無く、`Origin` が宛先のホストを名乗らない安全でないメソッドの要求。下の Breaking)。
+- **自分の作成・更新・公開を、自分のほかのタブと端末は自分の既読とスターのまま受け取る**: 日報を埋め込む SSE の知らせ (`report-create`・`report-update`・
+  `report-publish`) は、閲覧者がその書き込みの操作者か (`viewerIsActor`) を接続ごとに持つ。クライアントは真なら知らせの既読とスターを自分の書き込みの答えとして
+  書き (作った日報は既読)、偽なら今までどおりほかの閲覧者の書き込みとして閲覧者ごとの欄を手元の値か偽に合わせる。操作者の内部 ID は閲覧者へ届かない
+  (下の Breaking)。
+- **作成の答えは読み直した日報だけ**: `createDailyReport` は確定の後に日報を読み直せなければ、書いた値から組んだ日報で答えず、名前の付いた誤りで止まる
+  (下の Breaking)。
+- **カードの無い行は描いている状態で説明する**: 殻とカードの無い行は今までどおり営業日の ISO 表記で名付け、目に見える状態をアクティブな子孫の読み上げへ届ける
+  (`aria-describedby`): 読み込みに失敗した行は誤りの段落 (List は `reportSummaryLoadFailed`、DetailList は `reportLoadFailed`)、List のサーバーに無かった行は
+  不在の段落 (`reportNotFound`)、DetailList の編集フォームの行 (表示中ユーザーの下書きが自動で開く編集を含む) は画面に出さない編集の状態 (新しいラベル
+  `rowEditingState({ isDraft })`: en `Editing draft` / `Editing`、ja 「下書きを編集中」 / 「編集中」。位置を外れた要素なので行の高さは変わらない)。殻と読み込み中の
+  スケルトンは説明を持たない。0.42.0 はどれも日付だけを読ませた。固有キーは 110 から 111 (文字列のキー 89・整形関数 22。キーの表は全 122 キー。下の Breaking)。
+  カードと誤りの面はどちらも単位の写しから描くので、単位を待つ間に届いた読み込みの誤りは、単位が描くまで行をスケルトンのまま読み込み中にする (「見つかりません」を
+  挟まない)。
+- **List のカードの一致の説明は DetailList の一致の印と同じ文を言う**: 検索の答えを見せている間の List のカードの隠した一致の説明は、同じ答えの下の同じ日報について
+  DetailList の行の一致の印と同じ 1 つの規則で、当たったキーワードの数の文 (2 つ以上のキーワードの OR)・当たりを描いた欄の文・表示外の文を言う (カードの葉が当たりを
+  1 つも描かない日報、たとえばプレビューの外の本文にだけ当たった日報は、表示外の文)。0.42.0 の List は当たりを描いた欄の文だけで、答えの行の多くが何も言わなかった。
+  見える印は持たず、要素は箱を持たないので行の高さは変わらない。
+- **開発者向け**:
+  - `publish:*` は verify の後に基準を書き (`--write`)、ビルドし直してから `--exact` と漏洩の検査を走らせる (検査は `--exact` が測ったビルドを読む)。公開の配線の
+    検査は、最後のビルドから漏洩の検査までに読み取り専用の検査だけを認める。
+  - 押し続けの下の行の 2 段目の描画は偽の時計の spec (`rows/hold-schedule.spec.ts`。本物の送り手と選択の置き場と長押しの流れ) が、行の高さの配達
+    (`rows/row-height-delivery.ts`) とその落ち着かせる範囲は仕様に沿った偽の ResizeObserver (`test-helpers/fake-resize-observer.ts`。偽物の規則そのものも
+    `test-helpers/fake-resize-observer.spec.ts` が確かめる) とテストが回すフレームのウィンドウの上の `rows/row-height-delivery.spec.ts` が確かめ、行の落ち着いた DOM は
+    0.42.0 の写し (`components/__fixtures__/settled-rows-0.42.0.json`) に意図した変更 (画面に出さない文だけ) を当てたものと比べる。
+  - 送り手のフレームのコールバックの名前 (`rows/row-pass.ts` の `runFrame`。ホストの性能の計測が source map で単位のフレームを数える名前) は
+    `rows/row-pass.guard.spec.ts` が守る (名前を変える・移す・包むと、性能の計測の後ではなくパッケージのテストで落ちる)。
+
+### Fixed
+
+- **同じ順位の待つ単位は先に加えたものが先**: 待つ単位の順位を位ごとに比べる。0.42.0 は一覧を去った日報の単位 (距離が分からない) どうしを NaN で比べ、後に
+  加えたものを先にした。
+
+### Breaking
+
+- **閲覧者へ届く日報の知らせは `viewerIsActor` を必ず持つ**: `DailyReportSseMessage` (共有の入口) の `report-create`・`report-update`・`report-publish` は
+  `viewerIsActor: boolean` を持ち、`dailyReportSseMessageSchema` はそれの無い知らせを通さない。
+  Migration: 日報の知らせを組み立てて SSE のハンドラーやクライアントへ渡すホストの試験は、`viewerIsActor` を足す (ほかの閲覧者の書き込みなら `false`)。
+- **ストリームのエントリを読んだ値はストリームへ書く形**: `DailyReportSseEntryMessage.parsed` は `DailyReportSseStreamMessage` (日報を埋め込む 3 種別はサーバーだけが
+  読む `actorRawUserId` を必ず持ち、`viewerIsActor` を持たない)。
+  Migration: 自分の共有リーダー (`DailyReportSseReaderPort`) を渡すホストは、エントリを `dailyReportSseStreamMessageSchema` で読む (server エントリの
+  `readDailyReportSseStreamEntry` がこの読み方をする)。ストリームへ直接書くホスト (結合試験など) は、日報を埋め込む知らせに書き込みの操作者の内部 ID を
+  `actorRawUserId` で書く。
+- **SSE のワイヤの版は v4**: ストリームのキーは `<streamKey>:v4` で、0.42.0 が書いた v3 のエントリは読まない (開き直したクライアントは 1 度だけ一覧を合わせ直す)。
+  Migration: 同じストリームを読み書きするサーバーは同じ版へ揃えて配備する (版の違うサーバーは別のキーへ書き、互いのエントリを配らない)。v3 のストリームは
+  書かれなくなるので、手で消してよい。
+- **拒否の記録の行は `reason=` を持つ**: `cross_site_rejected route=<経路> reason=<cross-origin-fetch|foreign-origin> site=… mode=… dest=… method=…`。
+  Migration: 行を読むログの検索や監視は、`route=` の後の `reason=` を受ける。
+- **作成が読み直せなければ誤りで止まる**: `createDailyReport` は、確定の後の知らせの中身の読み取りが日報を見つけなければ
+  `[daily-report] createDailyReport: report <id> was committed but its detail read returned nothing` (何も知らせない)、操作者の範囲の読み直しが日報を返さなければ
+  `[daily-report] createDailyReport: the actor's scope cannot read report <id> it just created` (知らせの後) を投げる。どちらも確定の後の競合か欠陥で、作成の関門を
+  通った作成者は自分の下書きを読める。
+  Migration: 手で書いた db の代役でサービスの作成を試す試験は、作成の後の 2 つの読み取り (知らせの中身と操作者の範囲) に作った日報を答える。
+- **閲覧者へ届く SSE の知らせは宛先を持たない**: `DailyReportSseMessage` (共有の入口) と `dailyReportSseMessageSchema` のどの種別も `recipientRawUserId` を宣言しない
+  (0.42.0 は `status-update`・`comment-add`・`comment-delete` と日報を埋め込む 3 種別が持った)。宛先はストリームへ書く形 (`DailyReportSseStreamMessage`・
+  `dailyReportSseStreamMessageSchema`) だけが持ち、`status-update`・`comment-add`・`comment-delete` も宛先を持つ書く形のスキーマで読む。届く形で読んだ値は宛先を落とす。
+  Migration: 知らせの宛先を読むホストのコード (自分の宛先の絞り込みなど) は、書く形 (`DailyReportSseStreamMessage`) から読む。ストリームへ直接書くホストは
+  今までどおり宛先を書く (書く形が受ける)。
+- **`DailyReportSseEntryMessage` は `text` を持たない**: 共有リーダーが読んだエントリの値は、書く形のスキーマが検証したメッセージ (`parsed`) と書かれたままの JSON の値
+  (`published`。宛先の絞り込みだけが読む) の 2 つ。
+  Migration: 自分の共有リーダーを渡すホストは、エントリの値に `text` を作らない (server エントリの `readDailyReportSseStreamEntry` の読み方)。
+- **閲覧者へ書く SSE のフレームは、読んだメッセージから組んだ届く形の鍵だけの 1 行**: どのフレームも、書く形のスキーマが読んだメッセージからサーバーだけが読む欄
+  (`recipientRawUserId`・`actorRawUserId`) を除いて、届く形のメッセージとして組んだ JSON。書く形のスキーマが知らない鍵は届かず、書かれた値が整形の改行を持っていても
+  フレームは 1 行 (0.42.0 は宛先もコメントの秘匿も要らない知らせを書かれた字面のまま送り、ほかは書かれた値から宛先を除いて送ったので、知らない鍵も届いた)。
+  Migration: 知らせに欄を足すホストは、書く形と届く形の両方のスキーマに足す (書く形にだけ足した欄は閲覧者へ届かない)。届く形のスキーマは今までどおり知らない鍵を
+  拒まずに落とすので、長く開いたタブは新しいサーバーが欄を足した知らせも読み続ける。
+- **client の型 `DailyReportLabels` に必須のキー `rowEditingState({ isDraft })` が増えた** (上の Changed の「カードの無い行は描いている状態で説明する」)。
+  Migration: `DailyReportLabels` を丸ごと組むホスト (試験の代役など) はこのキーも書く。上書き (`DailyReportLabelOverrides`) は部分のままでよい。
+
+### Known issues
+
+- **速いホイールの往復**: 描いている窓のずっと先まで 1 度にホイールで送り (DetailList で 20,000 px など)、同じ量で戻すと、始めの位置から 644〜1,116 px ずれた所に着く
+  (0.42.0 は始めの位置へ戻った)。送る間に殻のまま通り過ぎた行が後でペインの上で描かれて、測る前の見積もり (352 px。測ったどの行より低い) から測った高さへ伸び、
+  VirtualScroll の位置の補正が見えている行をその場に保つため (見えている行は動かない)。次の版で、2 段目の描画の順をペインの進む向きの距離で決め、測る前の見積もりを
+  測った高さから導く。
+- **遅い端末での押し続け**: CPU を 4 倍遅くすると、キーを押し続ける間の描画は約 9 枚/秒 (次のフレームまでの p95 は 108.6 ms で、目標の 33 ms を満たさない。
+  0.42.0 は 50.2 ms)。どの行も見える範囲へ入るその確定でカードと印まで描き終える。時間を決めるのはキーのフレームそのもののスタイル・配置・塗りで、キー 1 つの
+  仕事を安くするのは次の版の作業。
+
 ## 0.42.0 (2026-10-12)
 
 ### Added