log

Text Chunker 開発引き継ぎレポート(Phase 7 反映)

Text Chunker 開発引き継ぎレポート(Phase 7 反映)

本稿は Text Chunker の Phase 1〜7 実装完了時点での引き継ぎ記録である。 現行仕様は 2026-09-27-text-chunker-spec を参照。


1. 現状の到達点

成果物

  • 単一 HTML ファイル(text_chunker.html、約 5,200 行)
  • 5 バッチ分割で生成したコードを結合済み
  • ES Modules + CodeMirror 6 + IndexedDB

実装済み機能(Phase 1〜7 全完了)

カテゴリ内容
分割エンジンsplitGap / chooseEnd / verifyFit / overlapStart、NoRoom 対応、{n} 収束 3 回
出力合成ノート(before/after/lastAfter)、ラッパー(always/asNeeded/never)、CRLF 変換
カウントutf16 / codepoint / jp2 / utf8 の 4 モード + CRLF 重み
安全位置サロゲートペア・結合文字・ZWJ・異体字セレクタ
EditorCodeMirror 6、gutter(band + boundary)、オーバーラップ装飾、チャンクセパレータ widget
状態遷移auto / pinned / done、anchorLock
範囲追従assoc 反転、詳細パネル編集中の例外処理
ツリーバッジ(✎ / ⚓ / ⚠ SR / ⚠ M / TC / Over / ⊘)、履歴展開
Copy & Mark Done§5.2 MUST 準拠(await なし同期 clipboard)
Undo20 段、スナップショット方式
Fit / Refitfitting フラグ、Over limit 表示、Trim to fit
CheckpointChangeSet 復元、行モード差分(diff-match-patch)
ダイアログ13 種(Notes / Split / Output / Snippets / Code blocks / Storage / Stats / Log / Count / App / Export / Import / Preview)
検索/置換@codemirror/search
JSON 入出力Replace / Merge、Include history
永続化IDB → LS → Memory フォールバック、Web Locks
テーマdark / light / system
レスポンシブvisualViewport 追従、サイドバー drawer
View modeContent / Changes セグメント(Phase 7)
Notes indicator✎ バッジを chunkStatus に表示(Phase 7)
Notes プリセット selectbefore/after 独立の <select> 挿入(Phase 7)
Menu 動的配置positionDropdown で右端見切れ解消(Phase 7)

起動手順

  1. text_chunker.html を HTTPS または localhost で配信
  2. ブラウザで開く(初回 Untitled ドキュメント自動作成)

2. Phase 7 で実施した UI 再設計

2.1 課題と対応

#課題対応
1メニュー右端が見切れるpositionDropdown() で動的配置(左右振り分け + max-width 調整)
2NotesPanel が常時占有NotesPanel 完全削除、✎ インジケータ + Notes ダイアログに集約
3Reset to default の意味不明瞭Clear に改名、Notes ダイアログ内に配置
4プリセットが before にしか反映されない<select> で before/after 独立挿入
5プリセットチップが場所を取る<select> に置換、挿入時はカーソル位置へ
6Diff が別ダイアログView mode としてエディタ領域に統合
7Copy & Mark Done 行のボタン過多editorTop を 4 要素に削減(View Seg / Undo / Copy&MkDone / ⋮)
8語彙の不統一Align to next / Merge down / Split before/after / Trim to fit / Show changes に統一

2.2 editorTop の再構成

Before:
[◀Prev] [Next▶] | [↤Head] [Tail↦] | [✂Split start] [Split end] | [chunkStatus] | [Preview] [Notes] [Diff] [Detail] [Copy&MkDone] [Undo] [Refit] [⋮]
After:
[◀] [▶] | [↤] [↦] | [chunkStatus ✎] | [Content|Changes] | [↶] | [Copy & Mark Done] | [⋮]
  • Prev/Next、Head/Tail はアイコンのみ(ツールチップ付き)
  • Split はコンテキストメニューへ
  • Preview / Notes / Detail / Refit は ⋮ メニューへ
  • View mode セグメントを追加

2.3 Diff の統合

  • ビューモード 'content' | 'diff' を app.ui.viewMode に追加
  • #diffView を #editorContainer 内に追加
  • done チャンク選択時のみ Changes ボタンが有効
  • 差分ナビゲーション(▲ / ▼ / N / M)を実装

2.4 Notes パネル廃止

  • #notesPanel DOM 削除
  • ensureNotesPanel / syncNotesPanel / applyNotesFromPanel 削除
  • #chunkStatus .line1 に .notesIndicator(✎)を追加
  • ✎ クリックで Notes ダイアログを開く

3. 仕様書からの乖離点

3.1 UI 方針 — IDE 風レイアウトを維持

仕様 v3.1 §5.1 は下部タブ [Next] [Chunks] [Edit] を要求するが、現行実装は IDE 風レイアウトを採用。ユーザー判断により、仕様のタブ構造は破棄し、以下で代替:

仕様現行実装
Next タブ(主画面)editorTop + View Mode セグメント
Chunks タブサイドバーツリー
Edit タブメインエディタ
ステータスバーのタップでカウント選択#chunkStatus クリックで openCountModeSheet()
ドキュメント名タップ → Rename#topDocName クリックで renameDocument()

理由: 1 つの画面で全操作が完結し、モバイルでも 1 タップで文脈を切り替えられる。

3.2 履歴の復元方式

仕様 v3.1 §6.4 は「最小 ChangeSet を 1 トランザクションで適用」を要求。現行実装は ChangeSet.of() + mapPos で完全準拠(Phase 5 で実装)。

逆差分の保存形式は、仕様の Array<[from,to,insert]> をそのまま採用。旧フォーマット(patch 文字列)との互換レイヤーも保持。

3.3 カウントモードの切り替え

仕様 v3.1 §5.1 は「タップで選択シートを開く方式に変更(タップのたびに切り替える方式は禁止)」と明記。現行実装は openCountModeSheet() で準拠。

3.4 手動分割

仕様 v3.1 §11 は「カーソル位置で境界を指定する機能は作らない」と明記するが、ユーザー判断で v3.0 由来の便利機能として復活。

  • manualSplitAtCursor('start') — カーソルが新チャンクの先頭(UI: Split before)
  • manualSplitAtCursor('end') — カーソルが新チャンクの末尾(UI: Split after)

3.5 v3.0 機能の一部復活

機能v3.0v3.1現行
overlapping 警告✓削除✓ 復活
Merge with next✓削除✓ 復活(UI: Merge down)
Align with next chunk✓削除✓ 復活(UI: Align to next)
anchorLock✓削除✓ 復活

3.6 NotesPanel の廃止

仕様 v3.1 §5.6 は NotesPanel を明示していないが、Phase 4.5 で追加していた。Phase 7 で削除。

理由:

  • 常時占有でエディタ領域を圧迫
  • ✎ インジケータで存在確認は十分
  • 編集は Notes ダイアログで行う方が一貫性がある

4. 代替実装した部分

4.1 diff 表示の二系統共存

用途実装
done チャンクの diff(renderDiff)renderSimpleDiff — 自前 LCS
Checkpoint の diff(previewCheckpoint)renderDMPLineDiff — diff-match-patch 行モード

理由: Checkpoint の diff は大規模(数万行)になりうるため dmp が必須。done diff は小規模なので自前 LCS で十分。

4.2 データモデルのキー名変換

内部(実装)外部(JSON)
startOffset / endOffsetstart / end
documentIddocId

理由: 内部実装は既存コードの慣習を維持、外部 JSON は v3.1 仕様に準拠。

4.3 IDB バージョン

  • 仕様 v3.1: DB 名 textChunker、version 1
  • 現行実装: DB 名 text-chunker-v31、version 2

理由: 既存データ(旧バージョン)との互換のため。

4.4 テーマ適用方法

  • 仕様 v3.1: Settings.theme に従い prefers-color-scheme を参照
  • 現行実装: themeCompartment で CodeMirror 6 のテーマを動的切り替え + data-theme 属性

5. 残りの課題

5.1 受入テスト未実施

§14 の T1〜T20 はコード上は準備完了だが、実機検証は未実施。

優先度の高いテスト:

  • T2(CRLF コピー)
  • T14(Source removed バッジ)
  • T15(Total changed バッジ)
  • T16(NoRoom バナー)
  • T19(clipboard 失敗時の手動シート)
  • T20(Web Locks 単一タブ制限)

5.2 実機検証

項目状態
iOS Safari 16+未検証
Android Chrome未検証
デスクトップ Chrome / Edge / Firefox未検証
visualViewport(ソフトキーボード)未検証
Web Locks の 2 タブ動作未検証

5.3 パフォーマンス検証

目標状態
50 万字で再分割 300ms 以内未検証
100 万字で破綻しない未検証

5.4 Phase 7 で発生しうる新規問題

#内容優先度
N1View mode 中に Alt+↑/↓ でチャンク移動すると、非 done チャンクで自動的に content に戻る低(仕様)
N2Notes ダイアログの Clear が即時実行(確認なし)低
N3positionDropdown の測定タイミング(display: block 直後)検証必要
N4Diff モード中の選択範囲が content に戻ったときに保持されない中

6. 改善のアイデア

6.1 パフォーマンス

#内容期待効果
P1isChunkOverLimit を Map<cacheKey, boolean> でキャッシュrenderTree の負荷軽減
P2buildLineStarts / buildFenceSet を masterText ハッシュでキャッシュrecomputeAutoChunks の高速化
P3変更行以降のみカウント再計算(仕様 §10 の差分計算)大規模編集の応答性
P4renderTree の差分描画(現在は全再構築)数百チャンク時の描画
P5overheadFor の {i, n} 単位キャッシュ分割エンジンの高速化

6.2 機能拡張

#内容優先度
F1差分ジャンプ(ins/del クリックで該当位置へ)中
F2Checkpoint の折りたたみ行クリック展開低
F3コードブロック抽出の言語拡張(30 言語程度)低
F4カウントモードのプリセット保存(貼り付け先ごと)中
F5インポート時の Merge で名前衝突を自動採番低
F6View mode を content ↔ diff 切替時にスクロール位置を保存低

6.3 保守性

#内容
M1renderSimpleDiff を renderDMPLineDiff に統合
M2wireUI 内のグローバル keydown を名前空間化
M3ダイアログ API を dialogAsync() で Promise 化
M4CM6 拡張の Compartment 整理(themeCompartment と editModeCompartment の統合検討)
M5#diffView の ins/del スタイルをライトテーマで最適化

6.4 仕様の再統合

  • v3.1 §5.2 の「Next タブ」UX を、IDE 風レイアウトの editorTop + View mode で機能的に等価にする改訂を提案
  • 現行 UI を正として、meta/SCHEMA.md の log として本稿を位置付ける

7. 参考リンク

  • 仕様書(現行): 2026-09-27-text-chunker-spec
  • v3.0 仕様(旧): 廃止、v3.1 に統合
  • v3.1 仕様(旧): 部分的に本仕様書に吸収

8. 引き継ぎチェックリスト

  • 5 バッチのコードを結合 → 単一 HTML として保存
  • ブラウザで開いて起動確認(エラーなし)
  • File / Chunks メニューを画面右端で開く → 見切れないこと
  • チャンク選択 → ✎ インジケータで note 有無を確認
  • Notes ダイアログ → before/after それぞれのプリセット挿入
  • チャンクを Mark Done → Changes セグメントで diff 表示
  • History 展開 → checkpoint 復元
  • ライトテーマ切替 → 各要素の見た目確認
  • §14 の T1〜T20 を順次実行
  • iOS Safari / Android Chrome で visualViewport 確認
  • Web Locks の 2 タブ制限確認
  • 50 万字 / 100 万字でのパフォーマンス計測
  • JSON エクスポート → インポートの往復確認