diff -ruN /Applications/Xcode_26.0.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/BrowserEngineKit.framework/Headers/BELayerHierarchyHandle.h /Applications/Xcode_26.0.0-beta4.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/BrowserEngineKit.framework/Headers/BELayerHierarchyHandle.h
--- /Applications/Xcode_26.0.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/BrowserEngineKit.framework/Headers/BELayerHierarchyHandle.h	2025-06-28 23:25:29
+++ /Applications/Xcode_26.0.0-beta4.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/BrowserEngineKit.framework/Headers/BELayerHierarchyHandle.h	2025-07-12 04:48:02
@@ -28,14 +28,16 @@
 - (xpc_object_t)createXPCRepresentation NS_SWIFT_NAME(createXPCRepresentation());
 #endif
 
-/// takes ownership of the port right (even if it returns nil).
+/// Decodes a handle form a `mach_port_t` send right and its accompanying metadata.
+/// - This method takes ownership of the port right (even if it returns an error).
 + (nullable BELayerHierarchyHandle *)handleWithPort:(mach_port_t)port
                                                data:(NSData *)data
                                               error:(NSError **)error NS_SWIFT_NAME(init(port:data:)) API_AVAILABLE(ios(26.0)) API_UNAVAILABLE(macos, watchos, tvos, visionos);
 
-/// passes a copy of the send right or `MACH_PORT_NULL` if inert.
-/// the receiver is responsible for disposing of `copiedPort`.
-/// the port and data should be consumed together and _only_ once by `init(port:data:)`.
+/// Encodes the handle into a `mach_port_t` send right and its accompanying metadata.
+/// - The block is responsible for disposing of `copiedPort` - failure to manage its lifecycle will leak the port. Note that some functions (like ``handleWithPort:data:error:``) will assume control of the right for you.
+/// - `copiedPort` will be `MACH_PORT_NULL` if the ``BELayerHierarchy`` pointed to by the handle is already invalidated.
+/// - The port and data should ultimately be consumed together  by ``handleWithPort:data:error:``.
 - (void)encodeWithBlock:(void(^ NS_NOESCAPE)(mach_port_t copiedPort, NSData *data))block NS_SWIFT_NAME(encode(_:)) API_AVAILABLE(ios(26.0)) API_UNAVAILABLE(macos, watchos, tvos, visionos);
 
 @end
diff -ruN /Applications/Xcode_26.0.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/BrowserEngineKit.framework/Headers/BELayerHierarchyHostingTransactionCoordinator.h /Applications/Xcode_26.0.0-beta4.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/BrowserEngineKit.framework/Headers/BELayerHierarchyHostingTransactionCoordinator.h
--- /Applications/Xcode_26.0.0-beta3.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/BrowserEngineKit.framework/Headers/BELayerHierarchyHostingTransactionCoordinator.h	2025-06-28 23:25:29
+++ /Applications/Xcode_26.0.0-beta4.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/BrowserEngineKit.framework/Headers/BELayerHierarchyHostingTransactionCoordinator.h	2025-07-12 04:48:01
@@ -45,14 +45,16 @@
 /// note that coordinators should have as constrained a lifespan as possible and will timeout if held open too long.
 - (void)commit NS_SWIFT_UI_ACTOR NS_SWIFT_NAME(commit());
 
-/// takes ownership of the port right (even if it returns nil).
+/// Decodes a coordinator form a `mach_port_t` send right and its accompanying metadata.
+/// - This method takes ownership of the port right (even if it returns an error).
 + (nullable BELayerHierarchyHostingTransactionCoordinator *)coordinatorWithPort:(mach_port_t)port
                                                                            data:(NSData *)data
                                                                           error:(NSError **)error NS_SWIFT_NAME(init(port:data:)) API_AVAILABLE(ios(26.0)) API_UNAVAILABLE(macos, watchos, tvos, visionos);
 
-/// passes a copy of the send right or `MACH_PORT_NULL` if inert.
-/// the receiver is responsible for disposing of `copiedPort`.
-/// the port and data should be consumed together and _only_ once by `init(port:data:)`.
+/// Encodes the coordinator into a `mach_port_t` send right and its accompanying metadata.
+/// - The block is responsible for disposing of `copiedPort` - failure to manage its lifecycle will leak the port. Note that some functions (like ``coordinatorWithPort:data:error:``) will assume control of the right for you.
+/// - `copiedPort` will be `MACH_PORT_NULL` if the receiver is already invalidated.
+/// - The port and data should ultimately be consumed together and _only_ once by ``coordinatorWithPort:data:error:``.
 - (void)encodeWithBlock:(void(^ NS_NOESCAPE)(mach_port_t copiedPort, NSData *data))block NS_SWIFT_NAME(encode(_:)) API_AVAILABLE(ios(26.0)) API_UNAVAILABLE(macos, watchos, tvos, visionos);
 
 @end