deprecated/obsoleted declarations now always sort after non-deprecated decls in an extension

Author: tayloraswift

Sources/UnidocLinker/Groups/DynamicContext.SortLeague.swift renamed to Sources/UnidocLinker/Groups/DynamicContext.SortPriority.Phylum.swift

@@ -1,9 +1,10 @@
+
 import Sources
 import Unidoc
 
-extension DynamicContext
+extension DynamicContext.SortPriority
 {
-    enum SortLeague:Equatable, Comparable
+    enum Phylum:Equatable, Comparable
     {
         case `var`
         case `func`
@@ -27,7 +28,7 @@ extension DynamicContext
         case  method(Unidoc.Decl.Objectivity)
     }
 }
-extension DynamicContext.SortLeague
+extension DynamicContext.SortPriority.Phylum
 {
     init(_ phylum:Unidoc.Decl, position:SourcePosition? = nil)
     {

Sources/UnidocLinker/Groups/DynamicContext.SortPriority.swift

@@ -0,0 +1,8 @@
+extension DynamicContext
+{
+    enum SortPriority:Equatable, Comparable
+    {
+        case available  (Phylum, String, Int32)
+        case removed    (Phylum, String, Int32)
+    }
+}

Sources/UnidocLinker/Groups/DynamicContext.swift

@@ -233,7 +233,7 @@ extension DynamicContext
 extension DynamicContext
 {
     /// Get the sort-priority of a declaration.
-    func priority(of decl:Unidoc.Scalar) -> (SortLeague, String, Int32)?
+    func priority(of decl:Unidoc.Scalar) -> SortPriority?
     {
         self[decl.package]?.priority(of: decl)
     }

Sources/UnidocLinker/Snapshots/SnapshotObject.swift

@@ -80,14 +80,16 @@ extension SnapshotObject
 }
 extension SnapshotObject
 {
-    func priority(of decl:Unidoc.Scalar) -> (DynamicContext.SortLeague, String, Int32)?
+    func priority(of decl:Unidoc.Scalar) -> DynamicContext.SortPriority?
     {
         if  let local:Int32 = decl - self.zone,
             let decl:SymbolGraph.Decl = snapshot.graph.decls[local]?.decl
         {
-            let league:DynamicContext.SortLeague = .init(decl.phylum,
+            let phylum:DynamicContext.SortPriority.Phylum = .init(decl.phylum,
                 position: decl.location?.position)
-            return (league, decl.path.last, local)
+            return decl.signature.availability.isGenerallyRecommended ?
+                .available(phylum, decl.path.last, local) :
+                .removed(phylum, decl.path.last, local)
         }
         else
         {

Sources/UnidocPages/Groups/Inliner.Groups.Generics.swift

@@ -23,6 +23,8 @@ extension Inliner.Groups.Generics
         self.init(parameters: generics.reduce(into: []) { $0.insert($1.name) })
     }
 
+    var count:Int { self.parameters.count }
+
     /// Returns the number of free generic parameters remaining after applying any same-type
     /// constraints in the given list.
     func count(substituting constraints:[GenericConstraint<Unidoc.Scalar?>]) -> Int