What's new in WebKit

extension WebPage.FormInfo : Sendable {
}

@MainActor public struct WebViewImmersiveEnvironmentView : View {

    /// Creates an immersive environment view from a ``WebPage/ImmersiveEnvironment``.
    @MainActor public init(_ environment: WebPage.ImmersiveEnvironment)

    /// Creates an immersive environment view from a `WKImmersiveEnvironment`.
    @MainActor public init(_ environment: WKImmersiveEnvironment)

    /// The content and behavior of the view.
    ///
    /// When you implement a custom view, you must implement a computed
    /// `body` property to provide the content for your view. Return a view
    /// that's composed of built-in views that SwiftUI provides, plus other
    /// composite views that you've already defined:
    ///
    ///     struct MyView: View {
    ///         var body: some View {
    ///             Text("Hello, World!")
    ///         }
    ///     }
    ///
    /// For more information about composing views and a view hierarchy,
    /// see <doc:Declaring-a-Custom-View>.
    @MainActor @preconcurrency public var body: some View { get }

    /// The type of view representing the body of this view.
    ///
    /// When you create a custom view, Swift infers this type from your
    /// implementation of the required ``View/body-swift.property`` property.
    @available(visionOS 27.0, *)
    @available(macOS, unavailable, introduced: 9999)
    @available(iOS, unavailable, introduced: 9999)
    @available(tvOS, unavailable)
    @available(watchOS, unavailable)
    public typealias Body = some View
}

extension WebViewImmersiveEnvironmentView : Sendable {
}

@MainActor public protocol WKImmersiveEnvironmentDelegate : NSObjectProtocol {

    /** @abstract Asks the delegate whether to allow an immersive environment from the specified frame.
     @param webView The web view that received the immersive environment request.
     @param frame The frame information from the website requesting the immersive environment.
     @param completionHandler The completion handler you must invoke with the request's answer. `YES` to allow
     the environment presentation, or `NO` to deny it.
     */
    @available(visionOS 27.0, *)
    func webView(_ webView: WKWebView, shouldAllowImmersiveEnvironmentFromFrame frame: WKFrameInfo, completionHandler: @escaping (Bool) -> Void)

    /** @abstract Asks the delegate whether to allow an immersive environment from the specified frame.
     @param webView The web view that received the immersive environment request.
     @param frame The frame information from the website requesting the immersive environment.
     @param completionHandler The completion handler you must invoke with the request's answer. `YES` to allow
     the environment presentation, or `NO` to deny it.
     */
    @available(visionOS 27.0, *)
    func webView(_ webView: WKWebView, shouldAllowImmersiveEnvironmentFrom frame: WKFrameInfo) async -> Bool

    /** @abstract Asks the delegate to present an immersive environment.
     @param webView The web view requesting presentation.
     @param environment The immersive environment to present.
     @param completionHandler The completion handler you must invoke once the presentation transition has completed.
     The error argument should be used in case the presentation failed and the environment couldn't be presented.
     */
    @available(visionOS 27.0, *)
    func webView(_ webView: WKWebView, present environment: WKImmersiveEnvironment, completionHandler: @escaping ((any Error)?) -> Void)

    /** @abstract Asks the delegate to present an immersive environment.
     @param webView The web view requesting presentation.
     @param environment The immersive environment to present.
     @param completionHandler The completion handler you must invoke once the presentation transition has completed.
     The error argument should be used in case the presentation failed and the environment couldn't be presented.
     */
    @available(visionOS 27.0, *)
    func webView(_ webView: WKWebView, presentImmersiveEnvironment environment: WKImmersiveEnvironment) async throws

    /** @abstract Asks the delegate to dismiss an immersive environment.
     @param webView The web view requesting dismissal.
     @param environment The immersive environment to dismiss.
     @param completionHandler The completion handler you must invoke once the dismissal transition has completed.
     */
    @available(visionOS 27.0, *)
    func webView(_ webView: WKWebView, dismiss environment: WKImmersiveEnvironment, completionHandler: @escaping () -> Void)

    /** @abstract Asks the delegate to dismiss an immersive environment.
     @param webView The web view requesting dismissal.
     @param environment The immersive environment to dismiss.
     @param completionHandler The completion handler you must invoke once the dismissal transition has completed.
     */
    @available(visionOS 27.0, *)
    func webView(_ webView: WKWebView, dismissImmersiveEnvironment environment: WKImmersiveEnvironment) async
}

@MainActor public struct FormInfo {

    /// The frame where the form is being submitted will cause a navigation.
    @MainActor public var targetFrame: WebPage.FrameInfo { get }

    /// The frame that caused the form submission.
    @MainActor public var sourceFrame: WebPage.FrameInfo { get }

    /// The URL that the frame is being navigated to.
    @MainActor public var submissionURL: URL { get }

    /// The HTTP method used to submit the form; generally either @"GET" or @"POST".
    @MainActor public var httpMethod: String { get }

    /// A dictionary of the form values that will be submitted during the navigation.
    @MainActor public var formValues: [String : String] { get }
}

@MainActor public struct ImmersiveEnvironment : Sendable {

    /// The frame information of the website that provided this immersive environment.
    @MainActor public var sourceFrame: WebPage.FrameInfo { get }
}