Add deprecated signatures to SwiftSyntaxCompatibility.swift. Adjust release notes.

Author: MAJKFL

Release Notes/601.md

@@ -14,10 +14,6 @@
 - `Error` protocol now has an `asDiagnostics(at:)` method.
   - Description: This method translates an error into one or more diagnostics, recognizing `DiagnosticsError` and `DiagnosticMessage` instances or providing its own `Diagnostic` as needed.
   - Pull Request: https://github.com/swiftlang/swift-syntax/pull/1816
-  
-- `ClosureCaptureSyntax` now has a new node structure.
-  - Description: `ClosureCaptureSyntax` now has an `initializer` property instead of `equal` and `expression`. Additionally, the `name` property is no longer optional.
-  - Pull request: https://github.com/swiftlang/swift-syntax/pull/2763
 
 ## API Behavior Changes
 
@@ -33,7 +29,7 @@
   - Pull request: https://github.com/apple/swift-syntax/pull/2604
 
 - `ClosureCaptureSyntax.init(leadingTrivia:specifier:name:equal:expression:trailingComma:trailingTrivia:)` deprecated in favor of a new `ClosureCaptureSyntax.init(leadingTrivia:_:specifier:_:name:_:initializer:_:trailingComma:_:trailingTrivia:)` initializer.
-  - Description: The change is due to a new `ClosureCaptureSyntax` node structure.
+  - Description: `ClosureCaptureSyntax` now has an `initializer` property instead of `equal` and `expression`. Additionally, the `name` property is no longer optional.
   - Pull request: https://github.com/swiftlang/swift-syntax/pull/2763 
 
 ## API-Incompatible Changes
@@ -42,6 +38,10 @@
   - Description: Allows retrieving the radix value from the `literal.text`.
   - Issue: https://github.com/apple/swift-syntax/issues/405
   - Pull Request: https://github.com/apple/swift-syntax/pull/2605
+  
+- `ClosureCaptureSyntax.name` is no longer optional.
+  - Description: Due to the new `ClosureCaptureSyntax` node structure, `name` property is non-optional.
+  - Pull request: https://github.com/swiftlang/swift-syntax/pull/2763 
 
 ## Template
 

Sources/SwiftSyntax/Convenience.swift

@@ -10,37 +10,6 @@
 //
 //===----------------------------------------------------------------------===//
 
-extension ClosureCaptureSyntax {
-
-  /// Creates a ``ClosureCaptureSyntax`` with a `name`, and automatically adds an `equal` token to it since the name is non-optional.
-  ///
-  /// - SeeAlso: ``ClosureCaptureSyntax/init(leadingTrivia:_:specifier:_:name:_:initializer:_:trailingComma:_:trailingTrivia:)``.
-  ///
-  @available(
-    *,
-    deprecated,
-    message: "Use 'init(leadingTrivia:_:specifier:_:name:_:initializer:_:trailingComma:_:trailingTrivia:)' instead"
-  )
-  public init(
-    leadingTrivia: Trivia? = nil,
-    specifier: ClosureCaptureSpecifierSyntax? = nil,
-    name: TokenSyntax,
-    equal: TokenSyntax = TokenSyntax.equalToken(),
-    expression: some ExprSyntaxProtocol,
-    trailingComma: TokenSyntax? = nil,
-    trailingTrivia: Trivia? = nil
-  ) {
-    self.init(
-      leadingTrivia: leadingTrivia,
-      specifier: specifier,
-      name: name,
-      initializer: InitializerClauseSyntax(equal: equal, value: expression),
-      trailingComma: trailingComma,
-      trailingTrivia: trailingTrivia
-    )
-  }
-}
-
 extension EnumCaseParameterSyntax {
 
   /// Creates an ``EnumCaseParameterSyntax`` with a `firstName`, and automatically adds a `colon` to it.

Sources/SwiftSyntax/SwiftSyntaxCompatibility.swift

@@ -144,6 +144,189 @@ extension DeclGroupSyntax {
   }
 }
 
+extension ClosureCaptureSyntax {
+  @available(*, deprecated, renamed: "unexpectedBetweenNameAndInitializer")
+  public var unexpectedBetweenNameAndAssignToken: UnexpectedNodesSyntax? {
+    get {
+      return unexpectedBetweenNameAndInitializer
+    }
+    set {
+      unexpectedBetweenNameAndInitializer = newValue
+    }
+  }
+
+  @available(*, deprecated, renamed: "initializer.equal")
+  public var assignToken: TokenSyntax? {
+    get {
+      return initializer?.equal
+    }
+    set {
+      initializer?.equal = newValue ?? .equalToken(presence: .missing)
+    }
+  }
+
+  @available(*, deprecated, renamed: "initializer.unexpectedBetweenEqualAndValue")
+  public var unexpectedBetweenAssignTokenAndExpression: UnexpectedNodesSyntax? {
+    get {
+      return initializer?.unexpectedBetweenEqualAndValue
+    }
+    set {
+      initializer?.unexpectedBetweenEqualAndValue = newValue
+    }
+  }
+
+  @available(*, deprecated, renamed: "ClosureCaptureSyntax(leadingTrivia:_:specifier:_:name:_:initializer:_:trailingComma:_:trailingTrivia:)")
+  @_disfavoredOverload
+  public init(
+      leadingTrivia: Trivia? = nil,
+      _ unexpectedBeforeSpecifier: UnexpectedNodesSyntax? = nil,
+      specifier: ClosureCaptureSpecifierSyntax? = nil,
+      _ unexpectedBetweenSpecifierAndName: UnexpectedNodesSyntax? = nil,
+      name: TokenSyntax? = nil,
+      _ unexpectedBetweenNameAndAssignToken: UnexpectedNodesSyntax? = nil,
+      assignToken: TokenSyntax? = nil,
+      _ unexpectedBetweenAssignTokenAndExpression: UnexpectedNodesSyntax? = nil,
+      expression: some ExprSyntaxProtocol,
+      _ unexpectedBetweenExpressionAndTrailingComma: UnexpectedNodesSyntax? = nil,
+      trailingComma: TokenSyntax? = nil,
+      _ unexpectedAfterTrailingComma: UnexpectedNodesSyntax? = nil,
+      trailingTrivia: Trivia? = nil
+
+  ) {
+    self.init(
+      leadingTrivia: leadingTrivia,
+      unexpectedBeforeSpecifier,
+      specifier: specifier,
+      unexpectedBetweenSpecifierAndName,
+      name: name ?? .identifier("", presence: .missing),
+      unexpectedBetweenNameAndAssignToken,
+      initializer: InitializerClauseSyntax(
+        equal: assignToken ?? .equalToken(presence: .missing),
+        unexpectedBetweenAssignTokenAndExpression,
+        value: expression
+      ),
+      unexpectedBetweenExpressionAndTrailingComma,
+      trailingComma: trailingComma,
+      unexpectedAfterTrailingComma,
+      trailingTrivia: trailingTrivia
+    )
+  }
+  
+  /// Creates a ``ClosureCaptureSyntax`` with a `name`, and automatically adds an `equal` token to it since the name is non-optional.
+  ///
+  /// - SeeAlso: ``ClosureCaptureSyntax/init(leadingTrivia:_:specifier:_:name:_:initializer:_:trailingComma:_:trailingTrivia:)``.
+  ///
+  @available(
+    *,
+    deprecated,
+    message: "Use 'init(leadingTrivia:_:specifier:_:name:_:initializer:_:trailingComma:_:trailingTrivia:)' instead"
+  )
+  public init(
+    leadingTrivia: Trivia? = nil,
+    specifier: ClosureCaptureSpecifierSyntax? = nil,
+    name: TokenSyntax,
+    equal: TokenSyntax = TokenSyntax.equalToken(),
+    expression: some ExprSyntaxProtocol,
+    trailingComma: TokenSyntax? = nil,
+    trailingTrivia: Trivia? = nil
+  ) {
+    self.init(
+      leadingTrivia: leadingTrivia,
+      specifier: specifier,
+      name: name,
+      initializer: InitializerClauseSyntax(equal: equal, value: expression),
+      trailingComma: trailingComma,
+      trailingTrivia: trailingTrivia
+    )
+  }
+  
+  @available(*, deprecated, renamed: "unexpectedBetweenNameAndInitializer")
+  public var unexpectedBetweenNameAndEqual: UnexpectedNodesSyntax? {
+    get {
+      return unexpectedBetweenNameAndInitializer
+    }
+    set {
+      unexpectedBetweenNameAndInitializer = newValue
+    }
+  }
+  
+  @available(*, deprecated, renamed: "initializer.equal")
+  public var equal: TokenSyntax? {
+    get {
+      return initializer?.equal
+    }
+    set {
+      initializer?.equal = newValue ?? .equalToken(presence: .missing)
+    }
+  }
+  
+  @available(*, deprecated, renamed: "initializer.unexpectedBetweenEqualAndValue")
+  public var unexpectedBetweenEqualAndExpression: UnexpectedNodesSyntax? {
+    get {
+      return initializer?.unexpectedBetweenEqualAndValue
+    }
+    set {
+      initializer?.unexpectedBetweenEqualAndValue = newValue
+    }
+  }
+  
+  @available(*, deprecated, renamed: "initializer.value")
+  public var expression: ExprSyntax {
+    get {
+      return initializer?.value ?? ExprSyntax(MissingExprSyntax())
+    }
+    set(value) {
+      initializer?.value = value
+    }
+  }
+
+  @available(*, deprecated, renamed: "unexpectedBetweenInitializerAndTrailingComma")
+  public var unexpectedBetweenExpressionAndTrailingComma: UnexpectedNodesSyntax? {
+    get {
+      return unexpectedBetweenInitializerAndTrailingComma
+    }
+    set(value) {
+      unexpectedBetweenInitializerAndTrailingComma = value
+    }
+  }
+  
+  @available(*, deprecated, renamed: "ClosureCaptureSyntax(leadingTrivia:_:specifier:_:name:_:initializer:_:trailingComma:_:trailingTrivia:)")
+  @_disfavoredOverload
+  public init(
+    leadingTrivia: Trivia? = nil,
+    _ unexpectedBeforeSpecifier: UnexpectedNodesSyntax? = nil,
+    specifier: ClosureCaptureSpecifierSyntax? = nil,
+    _ unexpectedBetweenSpecifierAndName: UnexpectedNodesSyntax? = nil,
+    name: TokenSyntax? = nil,
+    _ unexpectedBetweenNameAndEqual: UnexpectedNodesSyntax? = nil,
+    equal: TokenSyntax? = nil,
+    _ unexpectedBetweenEqualAndExpression: UnexpectedNodesSyntax? = nil,
+    expression: some ExprSyntaxProtocol,
+    _ unexpectedBetweenExpressionAndTrailingComma: UnexpectedNodesSyntax? = nil,
+    trailingComma: TokenSyntax? = nil,
+    _ unexpectedAfterTrailingComma: UnexpectedNodesSyntax? = nil,
+    trailingTrivia: Trivia? = nil
+  ) {
+    self.init(
+      leadingTrivia: leadingTrivia,
+      unexpectedBeforeSpecifier,
+      specifier: specifier,
+      unexpectedBetweenSpecifierAndName,
+      name: name ?? .identifier("", presence: .missing),
+      unexpectedBetweenNameAndEqual,
+      initializer: InitializerClauseSyntax(
+        equal: equal ?? .equalToken(presence: .missing),
+        unexpectedBetweenEqualAndExpression,
+        value: expression
+      ),
+      unexpectedBetweenExpressionAndTrailingComma,
+      trailingComma: trailingComma,
+      unexpectedAfterTrailingComma,
+      trailingTrivia: trailingTrivia
+    )
+  }
+}
+
 extension EffectSpecifiersSyntax {
   @available(*, deprecated, renamed: "unexpectedBetweenAsyncSpecifierAndThrowsClause")
   public var unexpectedBetweenAsyncSpecifierAndThrowsSpecifier: UnexpectedNodesSyntax? {