7.0.0

Changed

• BREAKING — raised the swift-design-system pin to 4.0.0, swift-latex-view to 0.5.0, and
  swift-visual-testing to 3.0.0. DesignSystem types appear in this package's public API, so its
  major becomes this one's.
• Every dark reference image is re-recorded, because the old ones were the defect.
  swift-visual-testing hardcoded a light UITraitCollection into every device config, so a dark
  capture was drawn over a light ground — and for a text view, which paints no background of its
  own, that ground is the whole image. All 69 committed dark references measured a light mean
  pixel; none does now. 77 images changed in total: 65 dark, plus 12 light that had drifted and
  were passing under perceptualPrecision: 0.98.

Fixed

• Display math rendered as a correctly sized, completely transparent bitmap. ImageRenderer
  draws only what SwiftUI draws, and LaTeXView's display body wraps the formula in a horizontal
  ScrollView so wide math can scroll — a platform-backed view, which ImageRenderer lays out and
  then leaves empty. The same Text renders with ink on its own and with none inside a
  ScrollView. Every display formula therefore reserved its line height and drew nothing, which is
  why latex-display.dark.png was blank. Both modes now rasterize through the inline body, and
  display style — limits above and below the operator, full-size fractions — is asked of the
  typesetting engine directly with \displaystyle. Source the engine cannot parse is left alone,
  since LaTeXView falls back to drawing the source it was given and prefixing it would put
  \displaystyle in front of the text the reader sees.

• MarkdownTextViewFactory.setDecorationPalette(_:on:) took a UITextView and silently did
  nothing when handed anything that was not a MarkdownTextView — no error, no log, just code
  blocks with no background and no way for the caller to find out. It takes the concrete type now,
  so the mistake is a compile error.

• Code block backgrounds, thematic breaks, table row separators, and block quote bars now follow
  the appearance the document is drawn in. MarkdownDecorationPalette turned the theme's colors
  into CGColor when it was built, which is in makeUIView / updateUIView, where the current
  trait collection is not the text view's. A CGColor is a concrete color, so a dynamic
  UIColor asked for one there resolved light and stayed light: the body text followed the user
  into dark mode and every decoration kept its light color. In the package's own dark-appearance
  snapshots the quote bar, the rules, and the table separators all measured rgb(208,208,210) —
  the same value as in light — while the text beside them measured rgb(243,243,249). An aside's
  tinted bar was already right, because that color is read from the text storage inside
  draw(at:in:); the palette default beside it was not.

  The palette now carries UIColor / NSColor, and the color becomes a CGColor inside the
  drawing call. On iOS the code block background is a CAShapeLayer fill, which can only hold a
  concrete color, so it is resolved against the view's own trait collection and repainted when a
  trait that decides how a color resolves changes.

6.0.0

Fixed

• MarkdownView now reads MarkdownRenderingOptions.renderMath. Until now only MathText
  read it, so passing renderMath: false still typeset the math in the document.
  Images and Mermaid render as before.
• MarkdownEditor no longer overwrites the theme's baseFontSize. The font size of the theme
  placed in the environment now takes effect as it is.

Removed

• Removed baseFontSize from the MarkdownEditor initializer. MarkdownEditorTheme is now
  the one place that decides the body text size.
• Removed RuleTransform.allowCoalescing. No rule set it and nothing read it.
• Removed the .markdownSource attribute key. It was written in 4 places and had no reader.

Changed

• Put the toolbar labels, the mode picker display names, and the logs for image, Mermaid, and highlighting failures into English.

5.0.0

Changed

• Bumped the swift-design-system pin to 3.0.0 and the swift-latex-view pin to 0.3.0.

4.0.0

3.0.0 以降に溜まっていた実バグの修正と、公開 API の全面的な見直しをまとめたメジャー。

要点: ①表示されているリンクと実際に開く先が違う等の実バグを 13 件修正 ②ライブ
プレビューの O(n²) を線形化（1 万行で 16.3 秒 → 0.12 秒）③配線されていない公開 API を
全廃 ④外部デザインシステムへの必須依存を解消し、既定でダークモードに追従 ⑤約束を
黙って別の挙動にすり替える経路を塞ぐ ⑥エディタの拡張点を公開。

移行の要点は下の「破壊的変更」に項目ごとの 移行 として書いてある。

修正

• MarkdownEditorController.canUndo / canRedo が SwiftUI を更新しなかったのを修正。
  UndoManager を読む計算プロパティなのに objectWillChange を流していなかったため、
  利用者が自作した「元に戻す」ボタンが永久に無効のままだった。undo 通知を購読して
  publish する。購読先の object を絞らないのは、NSTextView.undoManager が
  レスポンダチェーン経由で解決され bind(_:) の時点ではまだ nil だから
• コードブロックの中身が数式に置換される不具合を修正。~~~ フェンス・4 スペースの
  インデントコード・$ が先行する場合のインラインコードスパンが、いずれも数式スキャナの
  保護対象から漏れていた（~~~python\ncost = $5$\n~~~ の中身が cost = 0 になっていた）
• CRLF 改行のソースで、行末まで伸びるトークン（見出し本文・コードブロック）の範囲に
  \r が 1 コードユニット含まれ、ハイライトが行末まで伸びていたのを修正
• インデントされた閉じフェンス（リスト項目内など）を認識できず、以降のドキュメント全体が
  コードとして着色され続けていたのを修正

破壊的変更

• 配線されていない公開 API を全廃した。 いずれも本体レンダリング経路からの参照が
  0 件で、Catalog のデモとテストだけが参照していた。

  • Style プロトコル 5 系統（HeadingStyle / CodeBlockStyle / TableStyle /
    LinkStyle / AsideStyle）と既定実装 17 型を削除。
    移行: 見た目の調整は MarkdownPalette / MarkdownMetrics / MarkdownTypeScale
    で行う（下記「テーマ」参照）
  • MarkdownRenderingOptions を renderMath 1 フィールドに縮小。他 7 つと
    .compact / .plainText を削除。移行: 該当する代替は無い。画像の抑止は
    .markdownImagePolicy(.bundleOnly) が近い
  • EditorHistory / MarkdownEditorEngine を削除。undo/redo はシステムの
    UndoManager が担っており二重実装だった。移行: 不要（既に UndoManager 経由）
  • MathBlockView / CodeBlockView / MermaidDiagramView / AdaptiveMermaidView /
    MermaidFallbackView を削除。移行: MarkdownView を使う
  • MathRenderer.displayMath(_:) 要件を削除。移行: ディスプレイ数式は
    MarkdownAttachmentRendering.renderedImage(for:theme:) で描く

• 外部デザインシステムへの必須依存を外した。

  • SwiftMarkdownView / SwiftMarkdownEditor は swift-design-system を
    リンクしなくなった。色・寸法・文字サイズは MarkdownPalette /
    MarkdownMetrics / MarkdownTypeScale として自前で抽象化してある
  • 既定パレットがシステムの意味色になり、ライト/ダークに自動追従する。
    従来の既定は LightColorPalette() 固定で colorScheme を見ておらず、
    素で使うとダークモードで文字が読めなかった。README の回避手順は不要になった
  • 移行: .markdownTheme(themeProvider) を使っていた場合は
    SwiftMarkdownViewDesignSystem product を依存に追加して import する。
    呼び出し自体は変わらない。エディタは SwiftMarkdownEditorDesignSystem の
    .markdownEditorDesignSystemTheme()
  • 移行: MarkdownEditorTheme.fromDesignSystem(palette:) は
    SwiftMarkdownEditorDesignSystem へ移動した

• MathRenderer の要件を 1 本にまとめた。
  inlineMath(_:palette:) と inlineMath(_:fontSize:palette:) の 2 本立てをやめ、
  inlineMath(_:fontSize:textColor:) だけにした。旧デフォルト実装は fontSize を
  破棄しており、同梱の LaTeXMathRenderer は両方実装していたため、
  サードパーティ実装でのみ数式のサイズが周囲に追従しないという出方をしていた。
  移行: palette の代わりに解決済みの textColor を受け取る。fontSize が
  nil のときは実装側の既定サイズを使う

• MathRenderer が MarkdownAttachmentRendering を継承するようになった。
  従来は無関係な 2 プロトコルを MarkdownView 内の as? で繋いでおり、
  自作 MathRenderer を注入しても無言で無視され、数式が $latex$ のまま
  表示された。移行: renderedImage(for:theme:) を実装する。組版しないなら
  nil を返せば読み取り可能なテキストに落ちる

• MermaidScriptSource.inline が実際に機能するようになった。
  従来は .url と .localFile しか解釈せず、それ以外は無条件で CDN に落ちていた。
  オフライン動作のつもりで .inline を選んだ利用者のアプリから、気づかないまま
  外部通信が飛んでいた。 あわせて .localFile も、file URL を <script src> に
  渡す実装（WebView の origin からは読めない）から、中身を読み込んで埋め込む方式に
  改めた。読み込めない場合はログを出して描画しない — CDN には落ちない

• MarkdownAttachmentRendering が Sendable を要求するようになった。
  戻り値の MarkdownRenderedImage が @unchecked Sendable を名乗る一方、
  生成側に並行性の契約が無かった

• SyntaxHighlighter の失敗を握り潰さなくなった。
  try? で捨てていたため、doc がスローを約束しているのに利用者は自作ハイライターの
  失敗を「なぜか色が付かない」としてしか観測できなかった。今は理由をログに出す
  （描画自体は素のコードで続行する）

• 実装詳細の再輸出をやめた。 import SwiftMarkdownView から見えていた
  MarkdownAttributedBuilder / MarkdownCodeHighlighting / MarkdownCodeRegion /
  MarkdownSyntaxHighlighting / MarkdownImageRequest / MarkdownImageAttachments /
  MarkdownBlockDecoration と NSAttributedString.Key 拡張を package に降格した。
  引き続き見えるのは MarkdownTextTheme / MarkdownAttachment /
  MarkdownRenderedImage / MarkdownAttachmentRendering の 4 型で、いずれも
  自作アタッチメントレンダラを書くのに必要

• BundledMermaidScriptProvider を failable にした。 リソースが見つからない場合は
  nil を返す。従来はデバッグビルドで assertionFailure を出しつつ、リリースでは
  無言で CDN にフォールバックしていた。移行: if let か ?? で受ける。
  bundle / filename プロパティは解決済みの url に置き換わった

  // 見つからなければ Mermaid を描画しない
  if let provider = BundledMermaidScriptProvider() {
      view.markdownMermaidScriptProvider(provider)
  }
  // 明示的に CDN へ倒す判断も、利用者が書く
  let provider = BundledMermaidScriptProvider() ?? CDNMermaidScriptProvider()

• グローバル定数 defaultMermaidScriptProvider を削除した。
  移行: .markdownMermaidScriptProvider(.cdn) を使う。あわせて同 modifier の
  引数を any MermaidScriptProvider から some MermaidScriptProvider に変えた
  （実存パラメータだと先頭ドット構文の推論が効かないため）

• 旧 modifier 名の deprecated エイリアスを削除した。
  syntaxHighlighter / mermaidScriptProvider / mathRenderer の 3 件。
  移行: markdown prefix 付きの名前に置き換える
  （残り 3 件の headingStyle / codeBlockStyle / asideStyle は本体ごと廃止済み）

• MarkdownEditorController のコマンド名を実挙動に合わせた。 いずれも
  適用済みなら解除する toggle なのに、toggleHeading / toggleQuote だけが
  toggle を名乗っていた。移行:

  • bold() → toggleBold()
  • italic() → toggleItalic()
  • code() → toggleInlineCode()
  • strikethrough() → toggleStrikethrough()
  • bulletList() → toggleBulletList()
  • wrap(_:) → toggleWrap(_:)
  • linePrefix(_:) → toggleLinePrefix(_:)

• エディタ 4 ターゲットの公開面を確定した。 SwiftMarkdownEditorCore /
  Rules / TextKit は .library product として宣言されていなかったが、
  SwiftPM は依存グラフ内の全ターゲットをモジュール検索パスに載せるため、
  外部から import できてしまっていた（実測で確認）。つまり利用者は未文書な
  挙動に依存し、こちらは何が契約かを決めていない状態だった。

  • import SwiftMarkdownEditor 1 つで、init の引数型（InputRuleProcessor）も
    テーマ型（MarkdownEditorTheme）も独自コマンドの部品（EditTransform /
    MarkdownFormatting）も届くよう再輸出した
  • 契約でないものは package に降格: LineIndex / InlineSpan /
    InlineSpanParser / StyleRun / LivePreviewStyler
  • 移行: 3 ターゲットを個別に import していた場合は
    import SwiftMarkdownEditor だけで足りる

• MarkdownTokenizer と MathScanner の公開面を狭めた。

  • MarkdownTokenizer.isInsideFencedCode(_:offset:) は public のまま。独自 InputRule が
    コードブロック内でオートフォーマットを抑えるのに要る（同梱の ListContinuationRule が実例）
  • MarkdownTokenizer.tokenize(_:) / fencedCodeRanges(_:) と MathScanner 全体は
    package へ。いずれも呼び出し元がパッケージ内のハイライタ・前処理だけだった
  • 移行: 該当する外部ユースケースは想定していない。トークン列を直接扱う必要が
    生じた場合は issue で相談してほしい

• PlatformColor / PlatformFont の二重定義を解消した。
  MarkdownAttributedKit と SwiftMarkdownEditorTextKit が同名の public typealias を
  別々に宣言しており、両方を import した利用者のスコープで曖昧になっていた。
  定義は MarkdownPlatform ターゲット 1 か所に集約した。移行: 型は同一
  （UIColor/NSColor）なので通常は変更不要

• 画像の読み込みに MarkdownImagePolicy を導入し、既定でローカルファイルシステムへの
  アクセスを行わなくなった。![alt](source) の source はドキュメント由来の文字列で、
  LLM 出力やユーザー投稿の場合がある。従来は file: URL と裸のファイルパスを無条件に
  開いていたため、描画するだけでアプリのファイルを読みにいく指定が成立していた。

  • 既定（.default）: リモート（http/https）とバンドルリソース名のみ
  • .bundleOnly: ネットワークも使わない
  • .trustedDocument: 従来どおりローカルファイルを許可
  • 設定は .markdownImagePolicy(_:) で行う

• あわせてリモート取得にサイズ上限（既定 10 MB）とタイムアウト（既定 15 秒）を追加し、
  失敗を try? で握りつぶすのをやめてログに理由を出すようにした

• BundledMermaidScriptProvider はバンドルにスクリプトが無い場合、デバッグビルドで
  assertionFailure を発生させる。従来は無言で CDN にフォールバックしており、
  オフライン動作を期待した利用者のアプリから気づかないまま外部通信が発生していた

追加

• MarkdownPalette / MarkdownMetrics / MarkdownTypeScale と、それぞれの
  既定実装・環境値・View modifier。外部依存なしで見た目を差し替えられる:

  struct BrandPalette: MarkdownPalette {
      var text: Color { .primary }
      var secondaryText: Color { .secondary }
      var heading: Color { .indigo }
      var link: Color { .blue }
      var codeBackground: Color { Color.gray.opacity(0.12) }
      var rule: Color { Color.gray.opacity(0.4) }
  }
  
  MarkdownView(source).markdownPalette(BrandPalette())

• SwiftMarkdownViewDesignSystem / SwiftMarkdownEditorDesignSystem product。
  swift-design-system のトークンを上記の抽象へ写すブリッジ

• MarkdownEditorTheme の環境値と .markdownEditorTheme(_:) modifier

• macOS の検索バーについて、ホストアプリ側で .commands { TextEditingCommands() } が
  要ることを README とソースコメントに明記した。エディタは usesFindBar を有効にしているが、
  ⌘F はアプリの Edit メニュー経由で届き、SwiftUI の既定メニューには Find が含まれない。
  宣言しないと検索バーは出てこない（実機で確認）

• エディタの拡張点を公開した。 差別化の中核でありながら、テーマ以外は
  ほぼ差し替え不能だった:

  • MarkdownEditorToolbarItem — ツールバーを項目の配列で構成する。既定は
    .standard。label（読み上げ名）は省略できず、key を与えると
    ショートカットも付く。ショートカットは項目定義から供給されるので、
    ツールバーを差し替えても失われない。空配列を渡すとツールバーを表示しない
  • MarkdownFormattingToolbar を public 化。自前のモード UI と組み合わせられる
  • MarkdownEditorController.state / apply(_:) を public 化。これで
    MarkdownFormatting の純関数と組み合わせて任意コマンドが書ける。従来は
    apply も readState も private で、現在のテキストと選択を読むことすら
    できなかった
  • MarkdownEditor(controller:) でコントローラを注入できる。外部から
    プログラム的にコマンドを送れる
  • MarkdownEditor(text:mode:...) でモードを Binding として外に出せる

  MarkdownEditor(
      text: $text,
      mode: $mode,
      toolbar: [
          .bold, .italic,
          .separator,
          .item(icon: "highlighter", label: "マーカー", key: "h") { controller in
              guard let state = controller.state else { return }
              controller.apply(MarkdownFormatting.wrap(
                  text: state.text, selection: state.selection, delimiter: "=="
              ))
          }
      ],
      controller: controller
  )

• MarkdownContent(blocks:) を public 化。MarkdownView.init(_ content:) の doc は
  「レンダリング前にコンテンツを加工したい場合に使用する」と書いていたが、
  ブロック配列から組み直す入口が internal で実行不可能だった

変更

• View modifier の命名を markdown prefix に統一した。View の extension は
  グローバル名前空間で、headingStyle や codeBlockStyle のような一般名は利用者の
  アプリや他ライブラリと衝突しうる。旧名は deprecated エイリアスとして残しており、
  Xcode の Fix-it で移行できる（削除は次のメジャー）
  • syntaxHighlighter → markdownSyntaxHighlighter
  • mathRenderer → markdownMathRenderer
  • mermaidScriptProvider → markdownMermaidScriptProvider
• tvOS / watchOS のプラットフォーム宣言を削除。依存パッケージが iOS / macOS しか
  宣言しておらず、...

3.0.0

Full Changelog: 2.0.0...3.0.0

2.0.0

What's Changed

• chore: tests.yml と snapshot-report.yml を手動(dispatch)に変更 by @taniguchi-kyoichi in #24

New Contributors

• @taniguchi-kyoichi made their first contribution in #24

Full Changelog: v1.4.3...2.0.0

v1.0.10

🎉 v1.0.10 リリース

swift-markdown-view v1.0.10 がリリースされました。

📝 変更内容

修正

• 列挙リスト内の太字レンダリング問題を修正
  • InlineRenderer に bodyFont パラメータを追加し、全テキスト run に明示的な font 属性を設定
  • SwiftUI の View レベル .font() が AttributedString の最初の run を上書きする問題を解消
  • ParagraphView, HeadingView, TableCellView から .typography() を除去し、Typography トークンの font を直接渡す方式に変更

変更

• スナップショットテストを SwiftVisualTesting に移行
  • swift-snapshot-testing 直接依存を swift-visual-testing に置換
  • 全テストファイルを @SnapshotSuite / @ComponentSnapshot マクロベースに書き換え
  • テスト設定: iPhone 16、Light/Dark テーマ、日本語のみ
  • 非同期テスト（CodeBlock, Mermaid, Complex）は VisualTesting.assertComponentSnapshot() 直接 API を使用
  • 全スナップショットテストファイルに #if canImport(UIKit) ガードを追加（macOS ビルド対応）

📦 インストール

dependencies: [
    .package(url: "https://github.com/no-problem-dev/swift-markdown-view.git", .upToNextMajor(from: "1.0.10"))
]

🔗 リンク

• 変更履歴
• ドキュメント

v1.0.9

🎉 v1.0.9 リリース

swift-markdown-view v1.0.9 がリリースされました。

📝 変更内容

修正

• Package.swift の依存関係を安定版に更新
  • swift-tools-version を 6.0 から 6.2 にアップグレード
  • swift-markdown の依存を branch: main から安定版 0.7.3 に変更
  • すべての依存関係を .upToNextMajor(from:) 形式で統一
  • これにより、安定版依存を要求するプロジェクトで使用可能になりました

📦 インストール

dependencies: [
    .package(url: "https://github.com/no-problem-dev/swift-markdown-view.git", .upToNextMajor(from: "1.0.9"))
]

🔗 リンク

• 変更履歴
• ドキュメント

v1.0.8

🎉 v1.0.8 リリース

swift-markdown-view v1.0.8 がリリースされました。

📝 変更内容

変更

• シンタックスハイライトの簡素化
  • RegexSyntaxHighlighter を削除し、PlainTextHighlighter をデフォルトに変更
  • シンタックスハイライトを使用する場合は SwiftMarkdownViewHighlightJS モジュールを使用
  • API の複雑さを低減し、依存関係を明確化

ドキュメント

• README の正確化

  • 削除済みの機能（RegexSyntaxHighlighter、SyntaxTokenizer）への参照を削除
  • シンタックスハイライトの説明を現在の実装に合わせて更新
  • Mermaid ダイアグラムの動作環境（iOS 26+ 要件）を明記
  • 依存関係に HighlightSwift（オプション）を追記
  • 日本語/英語両方の README を同期更新

• Documentation.docc の包括的整備

  • SyntaxHighlighting.md を日本語化
  • MermaidDiagrams.md を新規作成（日本語）
  • Asides.md を新規作成（日本語）
  • SwiftMarkdownViewHighlightJS モジュールのドキュメントを新規作成
  • theme-settings.json を追加（統一テーマ設定）
  • メインドキュメントにパッケージ構成とモジュール相互参照を追加

• ワークフロー更新

  • docc.yml に --enable-experimental-combined-documentation を追加
  • SwiftMarkdownViewHighlightJS ターゲットを追加（複数モジュール統合ドキュメント対応）

修正

• LinkStyle.swift / TableStyle.swift のドキュメントコメント参照を修正

📦 インストール

dependencies: [
    .package(url: "https://github.com/no-problem-dev/swift-markdown-view.git", .upToNextMajor(from: "1.0.8"))
]

🔗 リンク

• 変更履歴
• ドキュメント

v1.0.7

🎉 v1.0.7 リリース

swift-markdown-view v1.0.7 がリリースされました。

📝 変更内容

追加

• Aside (callout/admonition) サポート: 注意書きやヒントなどのコールアウト表示

  • AsideKind: 24種類の定義済みタイプ（note, warning, tip, important など）+ カスタムタイプ
  • AsideStyle プロトコル: カスタマイズ可能なレンダリング
  • DefaultAsideStyle: セマンティックなアイコンと色を持つデフォルトスタイル
  • AsideView: アイコン、タイトル、コンテンツ、左ボーダーを持つビュー

• 適応型シンタックスハイライト: ダーク/ライトモード自動対応

  • adaptiveSyntaxHighlighting() ビューモディファイア
  • HighlightJSSyntaxHighlighter.forColorScheme() ファクトリメソッド

変更

• カタログビューの改善

  • CodeSnippetView と MarkdownPreviewCard で HighlightedCodeView を使用
  • SyntaxHighlighterCatalogView でハードコードされた色の代わりに colorPalette を使用
  • プレビューモディファイアを簡素化（ルートレベルのテーマ適用に依存）

• DesignSystem カタログビューを削除（DesignSystem パッケージに移動）

• RegexSyntaxHighlighter.fromPalette メソッドを削除（HighlightJS が主要）

破壊的変更

• MarkdownBlock.blockquote が MarkdownBlock.aside(kind:content:) に置き換え

テスト

• Asideユニットテスト（20+ケース）
• Asideスナップショットテスト（29ケース）

📦 インストール

dependencies: [
    .package(url: "https://github.com/no-problem-dev/swift-markdown-view.git", .upToNextMajor(from: "1.0.7"))
]

🔗 リンク

• 変更履歴
• ドキュメント