feat: GutenbergKit synchronizes featured images (#24588)

* feat: GutenbergKit synchronizes featured images

Handle featured image updates by updating associated post data, so that
the correct featured image is persisted and displayed in the post
settings UI.

* refactor: Simplify class to a struct

* fix: Ensure newly uploaded featured images display

The stub serves as a placeholder and is populated later once the app
needs to display the image.

* build: Update GutenbergKit version

Author: dcalhoun

Modules/Package.resolved

@@ -55,7 +55,7 @@ let package = Package(
         .package(url: "https://github.com/zendesk/support_sdk_ios", from: "8.0.3"),
         // We can't use wordpress-rs branches nor commits here. Only tags work.
         .package(url: "https://github.com/Automattic/wordpress-rs", revision: "alpha-20250523"),
-        .package(url: "https://github.com/wordpress-mobile/GutenbergKit", revision: "fdfe788530bbff864ce7147b5a68608d7025e078"),
+        .package(url: "https://github.com/wordpress-mobile/GutenbergKit", from: "0.3.0"),
         .package(
             url: "https://github.com/Automattic/color-studio",
             revision: "bf141adc75e2769eb469a3e095bdc93dc30be8de"

Modules/Package.swift

@@ -80,6 +80,10 @@ extension CommentGutenbergEditorViewController: GutenbergKit.EditorViewControlle
         // Do nothing
     }
 
+    func editor(_ viewController: GutenbergKit.EditorViewController, didUpdateFeaturedImage mediaID: Int) {
+        // Do nothing
+    }
+
     func editor(_ viewController: GutenbergKit.EditorViewController, didLogException error: GutenbergKit.GutenbergJSException) {
         // Do nothing
     }

WordPress/Classes/ViewRelated/Comments/Controllers/Editor/CommentGutenbergEditorViewController.swift

@@ -0,0 +1,20 @@
+import Foundation
+import WordPressShared
+
+struct NewGutenbergFeaturedImageHelper {
+    private let post: AbstractPost
+    let event: WPAnalyticsEvent = .editorPostFeaturedImageChanged
+
+    init(post: AbstractPost) {
+        self.post = post
+    }
+
+    func setFeaturedImage(mediaID: Int) {
+        let media = Media.existingOrStubMediaWith(mediaID: NSNumber(value: mediaID), inBlog: post.blog)
+        post.featuredImage = media
+        WPAnalytics.track(event, properties: [
+            "via": "gutenberg_kit",
+            "action": "added"
+        ])
+    }
+}

WordPress/Classes/ViewRelated/NewGutenberg/NewGutenbergFeaturedImageHelper.swift

@@ -27,6 +27,8 @@ class NewGutenbergViewController: UIViewController, PostEditor, PublishingEditor
         return GutenbergMediaPickerHelper(context: self, post: post)
     }()
 
+    lazy var featuredImageHelper = NewGutenbergFeaturedImageHelper(post: post)
+
     // MARK: - PostEditor
 
     private(set) lazy var postEditorStateContext: PostEditorStateContext = {
@@ -417,6 +419,17 @@ extension NewGutenbergViewController: GutenbergKit.EditorViewControllerDelegate
         gutenbergDidRequestToggleUndoButton(!state.hasUndo)
     }
 
+    func editor(_ viewController: GutenbergKit.EditorViewController, didUpdateFeaturedImage mediaID: Int) {
+        let featuredImageID = post.featuredImage?.mediaID?.intValue
+
+        guard featuredImageID != mediaID else {
+            // If the featured image ID is the same, no need to update
+            return
+        }
+
+        self.featuredImageHelper.setFeaturedImage(mediaID: mediaID)
+    }
+
     func editor(_ viewController: GutenbergKit.EditorViewController, didLogException error: GutenbergKit.GutenbergJSException) {
         logException(error) {
             // Do nothing