バージョン1.3:Markdown関連依存の監査と検証
バージョン1.3:Markdown関連依存の監査と検証
対象と結論
本書は1.3時点の監査記録。1.4でも固定依存・ロックファイル・Mermaidの版は変更していない。 1.4で追加した出力用Markdown解析とPDF/Quick Look/AIは現行実装仕様、 そのテストは1.4検証記録を参照する。以下の1.3印刷・Universal 2の説明は当時のもの。
確認日:2026年10月25日。採用依存は build 17 で更新し、最終の 1.3 / build 18 でも検証した。 macOSアプリ、iOS/iPadOSアプリ、UIテスト用ホスト、ローカル配布・検証・アップロードの バージョンチェックを同じ値に揃えた。本書は依存と技術検証を扱い、ストアの審査状態は扱わない。
依存構成
| 用途 | 採用バージョン | 今回の対応 |
|---|---|---|
| Markdown本文の表示:Textual | 0.5.0 | 採用版を維持 |
Markdown構文解析:Foundation AttributedString(markdown:) |
OSに付属 | Textualの実装を確認。独立したSwiftパッケージではない |
| 数式表示:SwiftUIMath | 0.1.0 | 採用版を維持 |
| 並行処理補助:ConcurrencyExtras | 1.4.3 | 1.4.0から更新。SwiftPMとXcode両方のロックを更新 |
| 図表:Mermaid | 12.2.0 | 11.15.0から更新 |
| コードの色分け:Prism.js | 1.29.0 | Textual 0.5.0に内蔵された版を維持 |
この表は 1.3 の固定版を示す。将来の最新版へ自動追従することを意味しない。
Textualの AttributedStringMarkdownParser はFoundationで構文を解析し、
presentation intentを保持したままSwiftUIで表示する。独立した swift-markdown は使っていない。
アプリ独自の HTMLBreakMarkdownParser はその結果を受け取り、コード以外の <br> を改行へ変換する。
独自の MarkdownContentParser は目次・セクション・Mermaidフェンスを分離する。
macOS印刷は独自の簡易フォーマッターを使うため、本文表示と同一のレンダラーではない。
Prism.jsについての制約
Prism 1.30.0への直接更新は未実施。Textualの内部リソースであり、公開されたランタイム差し替えAPIがない。
.build/checkouts を書き換える方式は再現性がなく、Textualの独自フォークも今回導入しない。
したがって「すべての内部部品が単体最新版」ではなく、Textual の公開版と
アプリが直接同梱する Mermaid をそれぞれ固定した状態である。
Mermaid 12への移行
- npm公式配布物の
dist/mermaid.min.jsをローカル同梱する。CDNや実行時ダウンロードは使わない。 layout: "dagre"とlook: "classic"を明示し、12系の既定レイアウト変更による見た目の変化を抑える。securityLevel: "strict"、外部通信を許可しないCSP、SVG内リンク除去、外部画面遷移拒否を維持する。- 本番とテストが
MermaidRendererResourcesから同じHTML・JavaScriptを読み込む。 - 対象 OS の WebKit で描画を検証した。ただし最小対象の iOS 18 での実行試験は未実施である。
- MITライセンスと第三者依存一覧を更新した。
公式ファイルのバイト列は変更しない。再取得は以下で行う。
./Scripts/update-mermaid.sh
スクリプトは一時ディレクトリで公式アーカイブを取得し、アーカイブとランタイムのSHA-256を
検証してから配置する。バージョンとハッシュは同梱の Mermaid/version.json にも記録する。
今後更新するときは、バージョンだけでなくハッシュ・互換性・テスト期待値もレビューする。
検証内容
- 日本語、強調、リンク、表、インラインコード、HTML改行の解析・属性維持。
- 既存の目次分離、Mermaid分離、コードフェンス、Live Reload、印刷、ウィンドウ配置のMac回帰テスト。
- 実際のWebKitによるflowchart / sequence / class / state / ER / mindmapのSVG生成。
- ライト・ダーク、80%・160%の文字サイズ、dagre/classic設定の維持。
- 不正な図のソース付きエラー表示、リンク除去、外部fetch拒否、HTTP(S)リソース未取得。
- 同梱Mermaidのバージョン・SHA-256検証。
- アプリホストのInfo.plistが1.3 / build 18であることを確認するXcodeテスト。
- iPhone・iPadで目次操作、文字サイズの変更・再起動後保持・標準へリセット。
実行環境と結果
Xcode 27.1、macOS 27.0.1(Apple silicon)、macOS 27.0 SDK / iOS 27.1 SDK を使用。 build 18 のテスト件数・Duo を含む最終結果と制限は 検証記録 に集約する。 Mac Universal 2 と iOS arm64 の App Store 配布署名付き書き出しも、検証スクリプトを通過した。
テスト記録は .build/results/、確認画像は .build/qa/ に保存し、Git 管理対象外とする。
アプリの Info.plist 検証は Xcode のアプリホストで行う。SwiftPM の通常テストバイナリには依存しない。
配布物の検証手順は 公開チェックリスト を参照する。
検証の限界
実機 Files/iCloud Drive、iOS 18 の実行、性能・アクセシビリティの追試は別途必要。 テストや配布署名の成功は、実機動作・ストアでの承認を保証するものではない。 シミュレーターのOSビルド番号に関するXcode診断、WebKitプロセス終了時のシステムログ、 未使用のAppIntentsに関するメタデータ抽出警告は記録されているが、テスト失敗・ビルド失敗ではない。