# 17. HTMLパーツとWYSIWYGの判断
状態:設計案。全面WYSIWYG採用は未決定。既存エディタを置換しない段階的改善を第一案とします。
2026-09-27 追記:[エディタ改善サブプロジェクト](editor-resilience.md) で
端末下書き・CAS 保存・競合確認・言語分岐・旧版復元・HTML 保護ブロックと
6種の初期挿入パレットを実装。以下の型付きパーツ schema、画像ピッカー、
限定 block 視覚編集、リアルタイム共同編集は引き続き後続段階です。
## 解決したい問題
表、画像とcaption、引用、注意書き、コード、リンク、macro、埋め込みを毎回手書きする負荷を減らします。単にHTMLを隠すことより、既存文書を壊さず効率よく編集できることを重視します。
## 段階案
1. Source+Projection previewを保ち、HTMLパーツ挿入paletteを加える。
2. 選択範囲の整形、リンク・表・画像の型付きdialogを追加する。
3. 対応するblockだけを視覚編集し、未知blockはread-only islandまたはsource編集へ戻す。
4. 完全WYSIWYGはfixture評価と操作上の効果が確認できた場合だけ採用判断する。
HTMLパーツは安定ID、版、schema、HTML template、preview、許可属性、必要providerを持ちます。挿入時に文書へ具体化するパーツと、動的macroを区別します。パーツ更新で過去Revisionを勝手に書き換えません。
## 保存契約
canonical HTMLと編集モデルと安全な表示HTMLは別です。preview展開済みchildren、閲覧者ごとのリンク、署名URL、session値を保存しません。unknownな属性を無言で削除するeditorは、その文書を視覚編集できると表示してはいけません。
保存は対象Page、編集開始Revision、言語、期待versionを照合し、競合時に選択・差分確認へ戻します。autosaveは下書きと本Revisionのどちらかを明示し、previewしただけで公開headを進めません。自動公開範囲では保存が公開へ直結することを表示します。
## round-trip fixture
- children等のmacro、asset provenanceと固定hash、embedded-object。
- code/pre、入れ子list、table、caption、非ASCII Path、RTL、複数言語。
- 未対応HTML、コメント、アクセシビリティ属性、長文・巨大table。
- paste時のscript/event属性/外部参照、安全化後と正本の違い。
- undo/redo、IME変換中、選択維持、キーボード、screen reader。
比較はbyte一致だけでなく、許可した正規化以外の意味・依存参照・未知blockを失わないことを検査します。変更なしで保存した場合に大量diffを作るeditorも不合格候補です。
## 採用判断の条件
HTMLパーツだけで主な不便が解決するならそこで止めます。完全WYSIWYGは、round-trip・IME・大規模文書・保守性・ライセンス・bundle負荷を比較したADRを作ってから選びます。特定ライブラリ採用や共同編集CRDTの導入は今回決めません。
EDITOR-1:fixtureとpalette schema。EDITOR-2:少数パーツの挿入。EDITOR-3:限定block prototype。EDITOR-4:比較評価とgo/no-go。共有編集は別の権限・競合・接続設計を必要とする後続事項です。