feat: Introduce extended macro and namespace information extraction and storing

Author: krodak

Plugins/BridgeJS/Sources/BridgeJSCore/ExportSwift.swift

@@ -123,10 +123,12 @@ class ExportSwift {
         }
 
         private func visitFunction(node: FunctionDeclSyntax) -> ExportedFunction? {
-            guard node.attributes.hasJSAttribute() else {
+            guard let jsAttribute = node.attributes.firstJSAttribute else {
                 return nil
             }
-            let name = node.name.text
+            
+            let (baseName, namespace) = extractNameAndNamespace(from: node, jsAttribute: jsAttribute)
+            
             var parameters: [Parameter] = []
             for param in node.signature.parameterClause.parameters {
                 guard let type = self.parent.lookupType(for: param.type) else {
@@ -151,21 +153,22 @@ class ExportSwift {
             let abiName: String
             switch state {
             case .topLevel:
-                abiName = "bjs_\(name)"
+                abiName = "bjs_\(baseName)"
             case .classBody(let className):
-                abiName = "bjs_\(className)_\(name)"
+                abiName = "bjs_\(className)_\(baseName)"
             }
 
             guard let effects = collectEffects(signature: node.signature) else {
                 return nil
             }
 
             return ExportedFunction(
-                name: name,
+                name: baseName,
                 abiName: abiName,
                 parameters: parameters,
                 returnType: returnType,
-                effects: effects
+                effects: effects,
+                namespace: namespace
             )
         }
 
@@ -192,6 +195,19 @@ class ExportSwift {
             }
             return Effects(isAsync: isAsync, isThrows: isThrows)
         }
+        
+        private func extractNameAndNamespace(
+            from node: FunctionDeclSyntax,
+            jsAttribute: AttributeSyntax
+        ) -> (name: String, namespace: [String]?) {
+            guard let arguments = jsAttribute.arguments?.as(LabeledExprListSyntax.self),
+                  let firstArg = arguments.first?.expression.as(StringLiteralExprSyntax.self),
+                  let namespaceString = firstArg.segments.first?.as(StringSegmentSyntax.self)?.content.text else {
+                return (node.name.text, nil)
+            }
+            let namespaces = namespaceString.split(separator: ".").map(String.init)
+            return (node.name.text, namespaces)
+        }
 
         override func visit(_ node: InitializerDeclSyntax) -> SyntaxVisitorContinueKind {
             guard node.attributes.hasJSAttribute() else { return .skipChildren }
@@ -227,11 +243,13 @@ class ExportSwift {
             let name = node.name.text
             stateStack.push(state: .classBody(name: name))
 
-            guard node.attributes.hasJSAttribute() else { return .skipChildren }
+            guard let jsAttribute = node.attributes.firstJSAttribute else { return .skipChildren }
+            
             exportedClassByName[name] = ExportedClass(
                 name: name,
                 constructor: nil,
-                methods: []
+                methods: [],
+                namespace: nil
             )
             exportedClassNames.append(name)
             return .visitChildren
@@ -635,9 +653,13 @@ class ExportSwift {
 
 extension AttributeListSyntax {
     fileprivate func hasJSAttribute() -> Bool {
-        return first(where: {
+        firstJSAttribute != nil
+    }
+    
+    fileprivate var firstJSAttribute: AttributeSyntax? {
+        first(where: {
             $0.as(AttributeSyntax.self)?.attributeName.trimmedDescription == "JS"
-        }) != nil
+        })?.as(AttributeSyntax.self)
     }
 }
 

Sources/JavaScriptKit/Macros.swift

@@ -8,6 +8,11 @@
 ///     return "Hello, \(name)!"
 /// }
 ///
+/// // Export a function to JavaScript with namespace
+/// @JS("__Swift.Foundation.UUID.create") public func createUUID() -> String {
+///     return UUID().uuidString
+/// }
+///
 /// // Export a class and its members
 /// @JS class Counter {
 ///     private var count = 0
@@ -33,3 +38,29 @@
 /// - Important: This feature is still experimental. No API stability is guaranteed, and the API may change in future releases.
 @attached(peer)
 public macro JS() = Builtin.ExternalMacro
+
+/// A macro that exposes Swift functions, classes, and methods to JavaScript.
+/// Additionally defines namespaces defined by `namespace` parameter
+///
+/// Apply this macro to Swift declarations that you want to make callable from JavaScript:
+///
+/// ```swift
+/// // Export a function to JavaScript with namespace
+/// @JS("__Swift.Foundation.UUID.create") public func createUUID() -> String {
+///     return UUID().uuidString
+/// }
+/// ```
+///
+/// Resulting TypeScript declaration equivalent will be formatted as follow:
+/// ```typescript
+///
+/// ```
+/// When you build your project with the BridgeJS plugin, these declarations will be
+/// accessible from JavaScript, and TypeScript declaration files (`.d.ts`) will be
+/// automatically generated to provide type safety.
+///
+/// For detailed usage information, see the article <doc:Exporting-Swift-to-JavaScript>.
+///
+/// - Important: This feature is still experimental. No API stability is guaranteed, and the API may change in future releases.
+@attached(peer)
+public macro JS(_ namespace: String) = Builtin.ExternalMacro