Merge branch 'main' into parameter-diff

Author: goergisn

Package.swift

@@ -31,10 +31,10 @@ let package = Package(
         )
     ],
     dependencies: [
-        .package(url: "https://github.com/apple/swift-argument-parser", from: "1.5.0"),
+        .package(url: "https://github.com/apple/swift-argument-parser", from: "1.5.1"),
         .package(url: "https://github.com/swiftlang/swift-syntax", from: "601.0.1"),
-        .package(url: "https://github.com/nicklockwood/SwiftFormat", from: "0.55.5"),
-        .package(url: "https://github.com/apple/swift-docc-plugin", from: "1.4.3"),
+        .package(url: "https://github.com/nicklockwood/SwiftFormat", from: "0.56.3"),
+        .package(url: "https://github.com/apple/swift-docc-plugin", from: "1.4.4"),
         .package(url: "https://github.com/SimplyDanny/SwiftLintPlugins", from: "0.59.1")
     ],
     targets: [

Sources/PublicModules/PADOutputGenerator/Documentation.docc/PADOutputGenerator.md

@@ -33,13 +33,13 @@ _Comparing `old` to `new`_
 ---
 ## SomeModule
 #### ❇️ Added
-```javascript
+```swift
 public protocol NewProtocol {
     var property: String { get }
 }
 ```
 #### 🔀 Changed
-```javascript
+```swift
 // From
 open class SomeClass : SomeProtocol, OldProtocol
 
@@ -53,6 +53,6 @@ Changes:
 */
 ```
 #### 😶‍🌫️ Removed
-```javascript
+```swift
 public protocol OldProtocol
 ```

Sources/PublicModules/PADOutputGenerator/MarkdownOutputGenerator.swift

@@ -164,9 +164,7 @@ private extension MarkdownOutputGenerator {
 
         var lines = [title]
         changes.sorted { lhs, rhs in description(for: lhs) < description(for: rhs) }.forEach {
-            // We're using `javascript` as it produces the nicest looking markdown output on Github
-            // `swift` is available but sometimes produces unexpected syntax highlighting
-            lines.append("```javascript")
+            lines.append("```swift")
             lines.append(description(for: $0))
 
             if !$0.listOfChanges.isEmpty {

Tests/UnitTests/OutputGeneratorTests.swift

@@ -41,7 +41,7 @@ class OutputGeneratorTests: XCTestCase {
         ---
         ## `Target_1`
         #### ❇️ Added
-        ```javascript
+        ```swift
         Some Addition
         ```
 
@@ -72,20 +72,20 @@ class OutputGeneratorTests: XCTestCase {
         ---
         ## `Target_1`
         #### ❇️ Added
-        ```javascript
+        ```swift
         Some Addition
         ```
         #### ❌ Removed
-        ```javascript
+        ```swift
         Some Removal
         ```
         ## `Target_2`
         #### ❇️ Added
-        ```javascript
+        ```swift
         Another Addition
         ```
         #### ❌ Removed
-        ```javascript
+        ```swift
         Another Removal
         ```
 

Tests/UnitTests/Resources/expected-reference-changes.md

@@ -4,7 +4,7 @@ _Comparing `/.../.../UpdatedPackage` to `/.../.../ReferencePackage`_
 ---
 ## `ReferencePackage`
 #### 🔀 Changed
-```javascript
+```swift
 // From
 public protocol CustomProtocol
 
@@ -16,7 +16,7 @@ Changes:
 - Added generic signature `<Self.CustomAssociatedType : Equatable>`
 */
 ```
-```javascript
+```swift
 // From
 public struct CustomStruct : CustomProtocol
 
@@ -30,42 +30,42 @@ Changes:
 ```
 ### `CustomProtocol`
 #### ❇️ Added
-```javascript
+```swift
 public associatedtype CustomAssociatedType
 ```
 #### 🔀 Changed
-```javascript
+```swift
 // From
 public func function<Self where Self : ReferencePackage.CustomProtocol>() -> any Self.CustomAssociatedType
 
 // To
 public func function<Self where Self : ReferencePackage.CustomProtocol>() -> Self.CustomAssociatedType
 ```
-```javascript
+```swift
 // From
 public var getSetVar: any Self.CustomAssociatedType { get set }
 
 // To
 public var getSetVar: Self.CustomAssociatedType { get set }
 ```
-```javascript
+```swift
 // From
 public var getVar: any Self.CustomAssociatedType { get }
 
 // To
 public var getVar: Self.CustomAssociatedType { get }
 ```
 #### 😶‍🌫️ Removed
-```javascript
+```swift
 public typealias CustomAssociatedType = Equatable
 ```
 ### `CustomStruct`
 #### ❇️ Added
-```javascript
+```swift
 public typealias CustomAssociatedType = Int
 ```
 #### 🔀 Changed
-```javascript
+```swift
 // From
 @discardableResult public func function() -> any Equatable
 
@@ -77,14 +77,14 @@ Changes:
 - Added generic signature `<T where T : Strideable>`
 */
 ```
-```javascript
+```swift
 // From
 public var getSetVar: any Equatable { get set }
 
 // To
 public var getSetVar: Int { get set }
 ```
-```javascript
+```swift
 // From
 public var getVar: any Equatable { get set }