BridgeJS now supports exporting Swift protocols as TypeScript interfaces. JavaScript objects implementing these interfaces can be passed to Swift code, where they are automatically wrapped in generated Swift struct that forward method calls and property accesses to the JavaScript implementation.

When you mark a protocol with@JS, BridgeJS generates:

A TypeScript interface with the protocol's method signatures and properties
A Swift wrapper struct (Any{ProtocolName}) that conforms to the protocol
JavaScript bridge code that forwards calls between Swift and JavaScript

Current Limitations

This PR covers support for methods and basic types in parameters and return types, as these types are supported in both Export / Import directions.
Support for properties,Optional and others will be posted in separate PR as changeset is quite large.

Testing

Basic tests with protocol implementation on JS and Swift side used as delegate property of protocol type are added.

Documentation

Added toSources/JavaScriptKit/Documentation.docc/Articles/BridgeJS/Exporting-Swift/Exporting-Swift-Protocols.md

krodak requested a review fromkateinoigakukun

October 17, 2025 11:55

krodak self-assigned this

Oct 17, 2025

krodak force-pushed thefeat/protocol-support-methods branch 3 times, most recently fromc1d778e toe96d1e8Compare

October 17, 2025 15:11

BridgeJS: Initial protocol support

7efb593

[fe09c4b1] Simplify export swift[b42bb7c1] WIP: Simplify protocol method generation[75e1ed37] BridgeJSLink simplification[b1fcc4d0] Cleanup[70aa0332] WIP: Final wrap[2f648eaf] WIP: Protocols simplification[f2f89b33] WIP: Fix for parameters in methods[6026fc1d] WIP: Test protocol methods with parameters

krodak force-pushed thefeat/protocol-support-methods branch frome96d1e8 to7efb593Compare

October 17, 2025 16:18