From 3d02e524bf61f54884add36c441b613d02a9673f Mon Sep 17 00:00:00 2001
From: attila <attila@juce.com>
Date: Thu, 11 Dec 2025 16:43:49 +0100
Subject: [PATCH] Update required ARA SDK version to 2.3.0

---
 BREAKING_CHANGES.md                           | 23 +++++++++++++++++++
 docs/ARA.md                                   |  4 ++--
 .../Source/Plugins/ARAPlugin.h                |  4 ++++
 .../juce_audio_plugin_client_ARA.cpp          |  2 +-
 4 files changed, 30 insertions(+), 3 deletions(-)

diff --git a/BREAKING_CHANGES.md b/BREAKING_CHANGES.md
index 6b08357c9d..9680019c62 100644
--- a/BREAKING_CHANGES.md
+++ b/BREAKING_CHANGES.md
@@ -1,5 +1,28 @@
 # JUCE breaking changes
 
+# develop
+
+## Change
+
+The ARA SDK required by JUCE has been updated to version 2.3.0.
+
+**Possible Issues**
+
+ARA Plugin builds using earlier versions of the ARA SDK will fail to compile.
+Additionally, the new ARA SDK version replaces the ARA::ChannelArrangement type
+with ARA::ChannelFormat.
+
+**Workaround**
+
+The ARA SDK configured in JUCE must be updated to version 2.3.0. If the plugin
+code depended on the ARA::ChannelArrangement type, it must use
+ARA::ChannelFormat in its stead.
+
+**Rationale**
+
+Version 2.3.0 is the latest official release of the ARA SDK.
+
+
 # Version 8.0.11
 
 ## Change
diff --git a/docs/ARA.md b/docs/ARA.md
index 8eef8fbf86..17ade2eb4d 100644
--- a/docs/ARA.md
+++ b/docs/ARA.md
@@ -5,12 +5,12 @@ in JUCE there are some steps you need to take to enable all ARA related function
 
 ## External dependencies
 
-- ARA SDK 2.2.0
+- ARA SDK 2.3.0
 
 You can download the ARA SDK from Celemony's Github. The command below will recursively clone the
 right version into the `ARA_SDK` directory
 
-    git clone --recursive --branch releases/2.2.0 https://github.com/Celemony/ARA_SDK
+    git clone --recursive --branch releases/2.3.0 https://github.com/Celemony/ARA_SDK
 
 ## Enabling ARA features in JUCE
 
diff --git a/extras/AudioPluginHost/Source/Plugins/ARAPlugin.h b/extras/AudioPluginHost/Source/Plugins/ARAPlugin.h
index b552348e18..8e2a09d472 100644
--- a/extras/AudioPluginHost/Source/Plugins/ARAPlugin.h
+++ b/extras/AudioPluginHost/Source/Plugins/ARAPlugin.h
@@ -472,6 +472,10 @@ public:
     {
         ignoreUnused (playbackRegionHostRef, range, scopeFlags);
     }
+
+    void notifyDocumentDataChanged() noexcept override
+    {
+    }
 };
 
 class PlaybackController final : public ARA::Host::PlaybackControllerInterface
diff --git a/modules/juce_audio_plugin_client/juce_audio_plugin_client_ARA.cpp b/modules/juce_audio_plugin_client/juce_audio_plugin_client_ARA.cpp
index 2769d7e122..2bd7c48cf0 100644
--- a/modules/juce_audio_plugin_client/juce_audio_plugin_client_ARA.cpp
+++ b/modules/juce_audio_plugin_client/juce_audio_plugin_client_ARA.cpp
@@ -50,7 +50,7 @@ JUCE_BEGIN_IGNORE_WARNINGS_MSVC (4100)
 #include <ARA_Library/PlugIn/ARAPlug.cpp>
 #include <ARA_Library/Dispatch/ARAPlugInDispatch.cpp>
 #include <ARA_Library/Utilities/ARAPitchInterpretation.cpp>
-#include <ARA_Library/Utilities/ARAChannelArrangement.cpp>
+#include <ARA_Library/Utilities/ARAChannelFormat.cpp>
 
 JUCE_END_IGNORE_WARNINGS_MSVC
 JUCE_END_IGNORE_WARNINGS_GCC_LIKE