index on main: 9511ee2 Update README

Author: kateinoigakukun

Package.swift

@@ -42,7 +42,7 @@ let package = Package(
     targets: [
         .target(
             name: "JavaScriptKit",
-            dependencies: ["_CJavaScriptKit"],
+            dependencies: ["_CJavaScriptKit", "JavaScriptKitMacros"],
             exclude: useLegacyResourceBundling ? [] : ["Runtime"],
             resources: useLegacyResourceBundling ? [.copy("Runtime")] : [],
             cSettings: shouldBuildForEmbedded
@@ -59,6 +59,14 @@ let package = Package(
                     ] : [])
         ),
         .target(name: "_CJavaScriptKit"),
+        .macro(
+            name: "JavaScriptKitMacros",
+            dependencies: [
+                .product(name: "SwiftSyntaxMacros", package: "swift-syntax"),
+                .product(name: "SwiftCompilerPlugin", package: "swift-syntax")
+            ]
+        ),
+
         .testTarget(
             name: "JavaScriptKitTests",
             dependencies: ["JavaScriptKit"],

Sources/JavaScriptKit/Macros.swift

@@ -107,3 +107,22 @@ public enum JSEnumStyle: String {
 /// - 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? = nil, enumStyle: JSEnumStyle = .const) = Builtin.ExternalMacro
+
+@attached(accessor)
+public macro JSImportVariable(from: String, jsName: String) = #externalMacro(module: "JavaScriptKitMacros", type: "JSImportVariableMacro")
+
+@attached(body)
+@attached(peer)
+public macro JSImportFunction(from: String, jsName: String) = #externalMacro(module: "JavaScriptKitMacros", type: "JSImportFunctionMacro")
+
+// @JSImportVariable(from: "globalThis", jsName: "console")
+public var console: JSObject {
+    @_extern(wasm, module: "globalThis", name: "console")
+    func console() -> UInt32
+}
+
+@JSImportFunction(from: "globalThis", jsName: "document")
+public var document: JSObject
+
+@JSImportFunction(from: "globalThis", jsName: "alert")
+public func alert(message: String) -> Void

Sources/JavaScriptKitMacros/JSImportMacro.swift

@@ -0,0 +1,76 @@
+import SwiftSyntax
+import SwiftSyntaxBuilder
+import SwiftSyntaxMacros
+
+enum JSImportFunctionMacro {}
+
+extension JSImportFunctionMacro: BodyMacro {
+  package static func expansion(
+    of node: AttributeSyntax,
+    providingBodyFor declaration: some DeclSyntaxProtocol & WithOptionalCodeBlockSyntax,
+    in context: some MacroExpansionContext
+  ) throws -> [CodeBlockItemSyntax] {
+    return [
+        "fatalError(\"Not implemented\")"
+    ]
+  }
+}
+
+enum JSImportVariableMacro {}
+
+extension JSImportVariableMacro: AccessorMacro {
+  package static func expansion(
+    of node: AttributeSyntax,
+    providingAccessorsOf declaration: some DeclSyntaxProtocol,
+    in context: some MacroExpansionContext
+) throws -> [AccessorDeclSyntax] {
+    return [
+        AccessorDeclSyntax(
+            accessorSpecifier: .keyword(.get),
+            effectSpecifiers: AccessorEffectSpecifiersSyntax(
+                asyncSpecifier: nil,
+                throwsClause: nil
+            ),
+            body: CodeBlockSyntax {
+                "fatalError(\"Not implemented\")"
+            }
+        )
+    ]
+  }
+}
+
+extension JSImportFunctionMacro: AccessorMacro {
+  package static func expansion(
+    of node: AttributeSyntax,
+    providingAccessorsOf declaration: some DeclSyntaxProtocol,
+    in context: some MacroExpansionContext
+) throws -> [AccessorDeclSyntax] {
+    return [
+        AccessorDeclSyntax(
+            accessorSpecifier: .keyword(.get),
+            effectSpecifiers: AccessorEffectSpecifiersSyntax(
+                asyncSpecifier: nil,
+                throwsClause: nil
+            ),
+            body: CodeBlockSyntax {
+                "fatalError(\"Not implemented\")"
+            }
+        )
+    ]
+  }
+}
+
+extension JSImportFunctionMacro: PeerMacro {
+  package static func expansion(
+    of node: AttributeSyntax,
+    providingPeersOf declaration: some DeclSyntaxProtocol,
+    in context: some MacroExpansionContext
+) throws -> [DeclSyntax] {
+    let functionDecl: DeclSyntax = """
+        func \(raw: context.makeUniqueName("jsImportFunction"))() -> UInt32 {
+          fatalError("Not implemented")
+        }
+    """
+    return [functionDecl]
+  }
+}

Sources/JavaScriptKitMacros/JavaScriptKitMacrosPlugin.swift

@@ -0,0 +1,10 @@
+import SwiftCompilerPlugin
+import SwiftSyntaxMacros
+
+@main
+struct JavaScriptKitMacrosPlugin: CompilerPlugin {
+  var providingMacros: [Macro.Type] = [
+    JSImportFunctionMacro.self,
+    JSImportVariableMacro.self,
+  ]
+}