Underscore _SwiftSyntaxMacros because it is So Very Experimental

Author: DougGregor

Package.swift

@@ -50,7 +50,7 @@ let package = Package(
     .library(name: "SwiftSyntax", type: .static, targets: ["SwiftSyntax"]),
     .library(name: "SwiftSyntaxParser", type: .static, targets: ["SwiftSyntaxParser"]),
     .library(name: "SwiftSyntaxBuilder", type: .static, targets: ["SwiftSyntaxBuilder"]),
-    .library(name: "SwiftSyntaxMacros", type: .static, targets: ["SwiftSyntaxMacros"]),
+    .library(name: "_SwiftSyntaxMacros", type: .static, targets: ["_SwiftSyntaxMacros"]),
   ],
   targets: [
     .target(
@@ -142,7 +142,7 @@ let package = Package(
       ]
     ),
     .target(
-      name: "SwiftSyntaxMacros",
+      name: "_SwiftSyntaxMacros",
       dependencies: [
         "SwiftSyntax", "SwiftSyntaxBuilder", "SwiftParser", "SwiftDiagnostics"
       ],
@@ -155,7 +155,7 @@ let package = Package(
     ),
     .executableTarget(
       name: "swift-parser-cli",
-      dependencies: ["SwiftDiagnostics", "SwiftSyntax", "SwiftParser", "SwiftOperators", "SwiftSyntaxMacros",
+      dependencies: ["SwiftDiagnostics", "SwiftSyntax", "SwiftParser", "SwiftOperators", "_SwiftSyntaxMacros",
                      .product(name: "ArgumentParser", package: "swift-argument-parser")]
     ),
     .testTarget(
@@ -179,7 +179,7 @@ let package = Package(
       name: "SwiftSyntaxMacrosTest",
       dependencies: ["SwiftDiagnostics", "SwiftOperators", "SwiftParser",
                      "_SwiftSyntaxTestSupport", "SwiftSyntaxBuilder",
-                     "SwiftSyntaxMacros"]
+                     "_SwiftSyntaxMacros"]
     ),
     .testTarget(
       name: "PerformanceTest",

Sources/SwiftSyntaxMacros/ExpressionMacro.swift renamed to Sources/_SwiftSyntaxMacros/ExpressionMacro.swift

@@ -3,9 +3,9 @@
 <plist version="1.0">
 <dict>
 	<key>CFBundleName</key>
-	<string>SwiftSyntaxMacros</string>
+	<string>_SwiftSyntaxMacros</string>
 	<key>CFBundleDisplayName</key>
-	<string>SwiftSyntaxMacros</string>
+	<string>_SwiftSyntaxMacros</string>
 	<key>CFBundleIdentifier</key>
 	<string>com.apple.swift-syntax-macros</string>
 	<key>CFBundleDevelopmentRegion</key>

Sources/SwiftSyntaxMacros/Macro.swift renamed to Sources/_SwiftSyntaxMacros/Macro.swift

@@ -1,4 +1,4 @@
-# ``SwiftSyntaxMacros``
+# ``_SwiftSyntaxMacros``
 
 
 
@@ -34,4 +34,4 @@ New example macros can be added by defining new types that conform to the approp
 
 ## What's the future for this library?
 
-Well, that depends. The `SwiftSyntaxMacros` module is part of a potential vision for a macros feature in Swift, where the effect of macro evaluation is as it works here---executable Swift code that transforms a given syntax tree into another syntax tree. That design also integrates macros into the type checker, so that macros are only evaluated on well-typed inputs and are expected to either produce well-typed syntax trees as output or emit diagnostics along the way. If that design is accepted as the design for Swift, much of this module will remain as it is---but the examples themselves will be divided into a builtin set of macros that are always available to the compiler (e.g., to provide the implementation for things like `#line`) or moved into a separate examples module to provide documentation on how to use the feature.
+Well, that depends. The `_SwiftSyntaxMacros` module is part of a potential vision for a macros feature in Swift, where the effect of macro evaluation is as it works here---executable Swift code that transforms a given syntax tree into another syntax tree. That design also integrates macros into the type checker, so that macros are only evaluated on well-typed inputs and are expected to either produce well-typed syntax trees as output or emit diagnostics along the way. If that design is accepted as the design for Swift, much of this module will remain as it is---but the examples themselves will be divided into a builtin set of macros that are always available to the compiler (e.g., to provide the implementation for things like `#line`) or moved into a separate examples module to provide documentation on how to use the feature.

Sources/SwiftSyntaxMacros/MacroEvaluationContext.swift renamed to Sources/_SwiftSyntaxMacros/MacroEvaluationContext.swift

@@ -12,7 +12,7 @@
 
 import SwiftDiagnostics
 import SwiftSyntax
-@_spi(Testing) import SwiftSyntaxMacros
+@_spi(Testing) import _SwiftSyntaxMacros
 import SwiftParser
 import SwiftOperators
 import Foundation

Sources/SwiftSyntaxMacros/MacroResult.swift renamed to Sources/_SwiftSyntaxMacros/MacroResult.swift

@@ -1,7 +1,7 @@
 import XCTest
 import SwiftSyntax
 import SwiftSyntaxBuilder
-@_spi(Testing) import SwiftSyntaxMacros
+@_spi(Testing) import _SwiftSyntaxMacros
 import _SwiftSyntaxTestSupport
 
 final class MacroSystemTests: XCTestCase {