Add support for 'union' symbol kinds (#785)

rdar://120374980

Author: QuietMisdreavus

Package.resolved

@@ -1,7 +1,7 @@
 /*
  This source file is part of the Swift.org open source project
 
- Copyright (c) 2021-2022 Apple Inc. and the Swift project authors
+ Copyright (c) 2021-2024 Apple Inc. and the Swift project authors
  Licensed under Apache License v2.0 with Runtime Library Exception
 
  See https://swift.org/LICENSE.txt for license information
@@ -214,6 +214,7 @@ extension AutomaticCuration {
             case .`typeProperty`: return "Type Properties"
             case .`typeSubscript`: return "Type Subscripts"
             case .`typealias`: return "Type Aliases"
+            case .union: return "Unions"
             case .`var`: return "Variables"
             case .module: return "Modules"
             case .extendedModule: return "Extended Modules"
@@ -236,6 +237,7 @@ extension AutomaticCuration {
         .`class`,
         .`protocol`,
         .`struct`,
+        .`union`,
         .`httpRequest`,
         .`dictionary`,
         .`var`,

Sources/SwiftDocC/Infrastructure/Topic Graph/AutomaticCuration.swift

@@ -1,7 +1,7 @@
 /*
  This source file is part of the Swift.org open source project
 
- Copyright (c) 2021-2023 Apple Inc. and the Swift project authors
+ Copyright (c) 2021-2024 Apple Inc. and the Swift project authors
  Licensed under Apache License v2.0 with Runtime Library Exception
 
  See https://swift.org/LICENSE.txt for license information
@@ -527,6 +527,7 @@ public struct DocumentationNode {
         case .`typeProperty`: return .typeProperty
         case .`typeSubscript`: return .typeSubscript
         case .`typealias`: return .typeAlias
+        case .union: return .union
         case .`var`: return .globalVariable
         case .module: return .module
         case .extendedModule: return .extendedModule

Sources/SwiftDocC/Model/DocumentationNode.swift

@@ -1,7 +1,7 @@
 /*
  This source file is part of the Swift.org open source project
 
- Copyright (c) 2021-2022 Apple Inc. and the Swift project authors
+ Copyright (c) 2021-2024 Apple Inc. and the Swift project authors
  Licensed under Apache License v2.0 with Runtime Library Exception
 
  See https://swift.org/LICENSE.txt for license information
@@ -551,13 +551,13 @@ class AutomaticCurationTests: XCTestCase {
         )
     }
 
-    func testNamespacesAreCuratedProperly() throws {
-        let (bundle, context) = try testBundleAndContext(named: "CxxNamespaces")
+    func testCPlusPlusSymbolsAreCuratedProperly() throws {
+        let (bundle, context) = try testBundleAndContext(named: "CxxSymbols")
 
         let rootDocumentationNode = try context.entity(
             with: .init(
                 bundleIdentifier: bundle.identifier,
-                path: "/documentation/CxxNamespaces",
+                path: "/documentation/CxxSymbols",
                 sourceLanguage: .objectiveC
             )
         )
@@ -573,7 +573,10 @@ class AutomaticCurationTests: XCTestCase {
             },
             [
                 "Namespaces",
-                "/documentation/CxxNamespaces/Foo",
+                "/documentation/CxxSymbols/Foo",
+
+                "Unions",
+                "/documentation/CxxSymbols/MyUnion",
             ]
         )
     }

Tests/SwiftDocCTests/Infrastructure/AutomaticCurationTests.swift

@@ -0,0 +1,6 @@
+# ``CxxSymbols``
+
+This bundle contains a small symbol graph that demonstrates symbol kinds added in Clang's C++
+support as currently reflected on its main branch.
+
+<!-- Copyright (c) 2023-2024 Apple Inc and the Swift Project authors. All Rights Reserved. -->