# 7. ビューア・エディタ・連携アダプタ 状態:主要形式のビューアとホスト型エディタあり。ネイティブ起動・任意外部コード実行は保留。 ## 正本と表示 文章はHTMLを正本にし、Markdownは編集・import形式として変換します。Office、PDF、画像、音声、動画、Canvas等のバイナリ・固有形式をすべてHTMLへ不可逆変換する意味ではありません。MIME、拡張子、限定された内容判定でProjectionを選びます。 拡張子のないテキストも文字コードと先頭内容を限定的に調べます。長いTXT/JSONは部分取得し、行番号・syntax highlight・ミニマップ等はブラウザのDOMやメモリ上限の中で動かします。 ## 対応領域 CSV、コード、PDF、画像lightbox、音声・動画、ZIP等のarchive、コミック、EML、DEB/PEのメタデータ、Excalidraw等に初期実装があります。Office全般の完全再現や任意archiveの無制限展開を保証するものではありません。 PDFページ数・archiveメタデータ・サムネイルは原則キューで生成し、未生成ならアイコン・待機状態を返します。一部のentry展開はまだ限定された前景処理で、キャッシュ付き生成への移行が必要です。 ## 連携アダプタ アダプタはDocumentの表示・編集を担当します。MIME、対応操作、設定schema、外部origin、リソース上限を宣言します。ランキングやメール収集はアダプタではなくシステム拡張です。 code-server、vim.wasm等はホスト型連携として扱います。workspaceへの配下展開、HTML/Markdown変換、保存競合、短命なsessionをホスト側で制御し、通常のログインcredentialをそのまま渡しません。vim.wasmのruntime改善は現在保留です。ネイティブvim.exe等への直接受け渡しも保留し、補助アプリ不要で自由起動できるとは扱いません。 ## HTMLの安全性 Viewer・履歴・印刷・Editor previewはinert allowlistを使い、保存されたscript/style/iframeを通常ページの権限で実行しません。正本バイト列を勝手に変更せず、表示段階の安全化として区別します。埋め込みは登録済みproviderとsandboxによる明示契約が必要です。 ## ビューアのキーボード操作 通常のViewerでは、`e` 編集、`f` 検索、`v` 表示形式切替、`c` 配下への新規作成、`u` アップロード、`s` 共有リンク、`p` 権限導線を使えます。`Ctrl+↑` は親Path、`Ctrl+↓` は配下一覧、`Ctrl+→` / `Ctrl+←` は前後ページです。入力欄・select・textarea・contenteditable・開いているdialogではショートカットを停止します。 共有リンクは現在の正規URLをコピーし、X Web Intentをユーザー操作で開く方式です。これは公開権限を付与したり、未公開Pageを自動公開したりしません。権限ダイアログがその画面にない場合、City governanceの案内だけを表示します。 ## Macroと変換の二つのモード 編集用のHTML→Markdownではchildren等のmacro宣言を保持します。表示・preview・export向けのProjectionでは認可済みの結果を展開します。展開された一覧を保存本文へ逆流させないことがround-tripの条件です。 ## TODO 変換provider/version・警告・原本保持、未対応構文の欠落検知、draw.io・nwdiag等の統合、widgetの許可・同意・CSP、decoder隔離、プラグイン停止時の安全なfallback。HTML編集の段階的改善は第17章で具体化します。nwdiagはネットワーク構成を記述するソースと、静的SVG/画像としてのProjection、明示的な編集アダプタを分離して設計します。