Introduce ExpressibleAs protocols

Author: kimdv

Sources/SwiftSyntaxBuilder/Buildables.swift.gyb

@@ -39,10 +39,17 @@ public protocol ${kind}ListBuildable: SyntaxListBuildable {
   func build${kind}List(format: Format, leadingTrivia: Trivia?) -> [${build_kind}]
 }
 
+%     buildable_type = kind + 'Buildable'
+public protocol ExpressibleAs${buildable_type} {
+  func create${buildable_type}() -> ${buildable_type}
+}
+
 %     if kind == 'Syntax':
-public protocol ${kind}Buildable: ${kind}ListBuildable {
+public protocol ${buildable_type}: ExpressibleAs${buildable_type}, ${kind}ListBuildable {
+%     elif kind == 'Decl':
+public protocol ${buildable_type}: ExpressibleAs${buildable_type}, SyntaxBuildable, ${kind}ListBuildable, ExpressibleAsMemberDeclListItem, ExpressibleAsCodeBlockItem {
 %     else:
-public protocol ${kind}Buildable: SyntaxBuildable, ${kind}ListBuildable {
+public protocol ${buildable_type}: ExpressibleAs${buildable_type}, SyntaxBuildable, ${kind}ListBuildable {
 %     end
   /// Builds a `${build_kind}`.
   /// - Parameter format: The `Format` to use.
@@ -51,7 +58,13 @@ public protocol ${kind}Buildable: SyntaxBuildable, ${kind}ListBuildable {
   func build${kind}(format: Format, leadingTrivia: Trivia?) -> ${build_kind}
 }
 
-extension ${kind}Buildable {
+extension ${buildable_type} {
+  public func create${buildable_type}() -> ${buildable_type} {
+    self
+  }
+}
+
+extension ${buildable_type} {
 %     if kind != 'Syntax':
   /// Builds a `${build_kind}`.
   /// - Returns: A `${build_kind}`.
@@ -82,6 +95,20 @@ extension ${kind}Buildable {
     [build${kind}(format: format, leadingTrivia: leadingTrivia)]
   }
 }
+%     if kind == 'Decl':
+
+extension DeclBuildable {
+  public func createMemberDeclListItem() -> MemberDeclListItem { 
+    MemberDeclListItem(decl: self)
+  }
+}
+
+extension DeclBuildable {
+  public func createCodeBlockItem() -> CodeBlockItem { 
+    CodeBlockItem(item: self)
+  }
+}
+%     end
 
 %   end
 % end
@@ -196,5 +223,26 @@ public struct ${node.syntax_kind}: SyntaxBuildable {
   }
 }
 
+%   end
+%   if node.is_buildable() or node.is_syntax_collection():
+public protocol ExpressibleAs${node.syntax_kind} {
+  func create${node.syntax_kind}() -> ${node.syntax_kind}
+}
+
+extension ${node.syntax_kind}: ExpressibleAs${node.syntax_kind} {
+  public func create${node.syntax_kind}() -> ${node.syntax_kind} {
+    self
+  }
+}
+
 %   end
 % end
+public protocol ExpressibleAsTokenSyntax {
+  func createTokenSyntax() -> TokenSyntax
+}
+
+extension TokenSyntax: ExpressibleAsTokenSyntax {
+  public func createTokenSyntax() -> TokenSyntax {
+    self
+  }
+}

Sources/SwiftSyntaxBuilder/ResultBuilders.swift.gyb

@@ -29,11 +29,11 @@ public struct ${node.syntax_kind}Builder {
 
   /// The type of individual statement expressions in the transformed function,
   /// which defaults to Component if buildExpression() is not provided.
-  public typealias Expression = ${element_type}
+  public typealias Expression = ExpressibleAs${element_type}
 
   /// The type of a partial result, which will be carried through all of the
   /// build methods.
-  public typealias Component = [${element_type}]
+  public typealias Component = [ExpressibleAs${element_type}]
 
   /// The type of the final returned result, which defaults to Component if
   /// buildFinalResult() is not provided.
@@ -84,7 +84,7 @@ public struct ${node.syntax_kind}Builder {
   /// If declared, this will be called on the partial result from the outermost
   /// block statement to produce the final returned result.
   public static func buildFinalResult(_ component: Component) -> FinalResult {
-    .init(component)
+    .init(component.map { $0.create${element_type}() })
   }
 }
 

Sources/SwiftSyntaxBuilder/StringLiteralExprConvenienceInitializers.swift

@@ -13,14 +13,14 @@
 import SwiftSyntax
 
 extension StringLiteralExpr {
-  public init(_ value: String) {
+  public init(_ value: String, openQuote: TokenSyntax = .stringQuote, closeQuote: TokenSyntax = .stringQuote) {
     let content = SyntaxFactory.makeToken(TokenKind.stringSegment(value), presence: .present)
     let segment = StringSegment(content: content)
     let segments = StringLiteralSegments([segment])
 
-    self.init(openQuote: .stringQuote,
+    self.init(openQuote: openQuote,
               segments: segments,
-              closeQuote: .stringQuote)
+              closeQuote: closeQuote)
   }
 }