バージョン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に関するメタデータ抽出警告は記録されているが、テスト失敗・ビルド失敗ではない。

一次資料