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・異体字セレクタ |
| Editor | CodeMirror 6、gutter(band + boundary)、オーバーラップ装飾、チャンクセパレータ widget |
| 状態遷移 | auto / pinned / done、anchorLock |
| 範囲追従 | assoc 反転、詳細パネル編集中の例外処理 |
| ツリー | バッジ(✎ / ⚓ / ⚠ SR / ⚠ M / TC / Over / ⊘)、履歴展開 |
| Copy & Mark Done | §5.2 MUST 準拠(await なし同期 clipboard) |
| Undo | 20 段、スナップショット方式 |
| Fit / Refit | fitting フラグ、Over limit 表示、Trim to fit |
| Checkpoint | ChangeSet 復元、行モード差分(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 mode | Content / Changes セグメント(Phase 7) |
| Notes indicator | ✎ バッジを chunkStatus に表示(Phase 7) |
| Notes プリセット select | before/after 独立の <select> 挿入(Phase 7) |
| Menu 動的配置 | positionDropdown で右端見切れ解消(Phase 7) |
起動手順
text_chunker.htmlを HTTPS または localhost で配信- ブラウザで開く(初回
Untitledドキュメント自動作成)
2. Phase 7 で実施した UI 再設計
2.1 課題と対応
| # | 課題 | 対応 |
|---|---|---|
| 1 | メニュー右端が見切れる | positionDropdown() で動的配置(左右振り分け + max-width 調整) |
| 2 | NotesPanel が常時占有 | NotesPanel 完全削除、✎ インジケータ + Notes ダイアログに集約 |
| 3 | Reset to default の意味不明瞭 | Clear に改名、Notes ダイアログ内に配置 |
| 4 | プリセットが before にしか反映されない | <select> で before/after 独立挿入 |
| 5 | プリセットチップが場所を取る | <select> に置換、挿入時はカーソル位置へ |
| 6 | Diff が別ダイアログ | View mode としてエディタ領域に統合 |
| 7 | Copy & 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 パネル廃止
#notesPanelDOM 削除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.0 | v3.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 / endOffset | start / end |
documentId | docId |
理由: 内部実装は既存コードの慣習を維持、外部 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 で発生しうる新規問題
| # | 内容 | 優先度 |
|---|---|---|
| N1 | View mode 中に Alt+↑/↓ でチャンク移動すると、非 done チャンクで自動的に content に戻る | 低(仕様) |
| N2 | Notes ダイアログの Clear が即時実行(確認なし) | 低 |
| N3 | positionDropdown の測定タイミング(display: block 直後) | 検証必要 |
| N4 | Diff モード中の選択範囲が content に戻ったときに保持されない | 中 |
6. 改善のアイデア
6.1 パフォーマンス
| # | 内容 | 期待効果 |
|---|---|---|
| P1 | isChunkOverLimit を Map<cacheKey, boolean> でキャッシュ | renderTree の負荷軽減 |
| P2 | buildLineStarts / buildFenceSet を masterText ハッシュでキャッシュ | recomputeAutoChunks の高速化 |
| P3 | 変更行以降のみカウント再計算(仕様 §10 の差分計算) | 大規模編集の応答性 |
| P4 | renderTree の差分描画(現在は全再構築) | 数百チャンク時の描画 |
| P5 | overheadFor の {i, n} 単位キャッシュ | 分割エンジンの高速化 |
6.2 機能拡張
| # | 内容 | 優先度 |
|---|---|---|
| F1 | 差分ジャンプ(ins/del クリックで該当位置へ) | 中 |
| F2 | Checkpoint の折りたたみ行クリック展開 | 低 |
| F3 | コードブロック抽出の言語拡張(30 言語程度) | 低 |
| F4 | カウントモードのプリセット保存(貼り付け先ごと) | 中 |
| F5 | インポート時の Merge で名前衝突を自動採番 | 低 |
| F6 | View mode を content ↔ diff 切替時にスクロール位置を保存 | 低 |
6.3 保守性
| # | 内容 |
|---|---|
| M1 | renderSimpleDiff を renderDMPLineDiff に統合 |
| M2 | wireUI 内のグローバル keydown を名前空間化 |
| M3 | ダイアログ API を dialogAsync() で Promise 化 |
| M4 | CM6 拡張の 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 エクスポート → インポートの往復確認