René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[BridgeJS] Support @JS var declarations for global scope imports","articleBody":"## Motivation\n\nCurrently, importing JavaScript APIs from the global scope requires users to write TypeScript declaration files and import APIs through the standard BridgeJS workflow. For simple use cases where users only need to access a few well-known global APIs like `console.log()` or `document.getElementById()`, this approach can feel heavyweight and requires additional setup steps.\n\n## Proposed Solution\n\nAllow users to declare global scope imports directly in Swift using `@JS var` declarations with protocol interfaces, eliminating the need for separate `.d.ts` files for simple global API access.\n\n## High-level API\n\n```swift\n@JS protocol JSConsole {\n    func log(_ message: String) throws(JSException)\n    func error(_ message: String) throws(JSException)\n}\n\n@JSGetter(from: .global) var console: JSConsole\n\n@JS class JSElement {\n    var innerHTML: String { get set }\n    func addEventListener(_ event: String, _ handler: @escaping () -\u003e Void) throws(JSException)\n}\n\n@JS protocol JSDocument {\n    func getElementById(_ id: String) throws(JSException) -\u003e JSElement?\n}\n\n@JS(from: .global, jsName: \"document\") var jsDocument: JSDocument\n\n@JSImport(from: .module(\"uuid\"), jsName: \"v4\")\nfunc uuidv4() throws(JSException) -\u003e String\n\n@JSImport(from: .module(\"./custom-component.js\"), jsName: \"defineCustomComponents\")\nfunc jsDefineCustomComponents() throws(JSException)\n\n@JS func run() {\n    print(uuidv4())\n    jsDefineCustomComponents()\n}\n\n```\n\n## Implementation\n\nThis feature would require adding a macro plugin to support `@JS var [name]: [Type]` declarations that generates getter/setter accessors interacting with the code generated by `@JS protocol`\n\nIf it works well, we might be able to make ImportTS just to generate `@JS` annotated Swift code and centralize ABI-facing code in ExportSwift","author":{"url":"https://github.com/kateinoigakukun","@type":"Person","name":"kateinoigakukun"},"datePublished":"2025-11-09T07:36:48.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":4},"url":"https://github.com/466/JavaScriptKit/issues/466"}