add frontend tool for sorting the package list by name, owner, or star count

Author: tayloraswift

Assets/js/Main.js

@@ -0,0 +1,17 @@
+extension DOM
+{
+    @usableFromInline
+    typealias Attribute = _DOMAttribute
+}
+
+/// The name of this protocol is ``DOM.Attribute``.
+@usableFromInline
+protocol _DOMAttribute
+{
+    var name:String { get }
+}
+extension DOM.Attribute where Self:RawRepresentable<String>
+{
+    @inlinable internal
+    var name:String { self.rawValue }
+}

Assets/js/Main.js.map

@@ -1,15 +1,15 @@
 extension DOM
 {
-    @frozen @usableFromInline internal
-    struct Property<Attribute> where Attribute:RawRepresentable<String>
+    @frozen @usableFromInline
+    struct Property<ID> where ID:Attribute
     {
         @usableFromInline internal
-        let attribute:Attribute
+        let attribute:ID
         @usableFromInline internal
         let value:String
 
         @inlinable internal
-        init(_ attribute:Attribute, _ value:String)
+        init(_ attribute:ID, _ value:String)
         {
             self.attribute = attribute
             self.value = value
@@ -22,7 +22,7 @@ extension DOM.Property
     func += (utf8:inout [UInt8], self:Self)
     {
         utf8.append(0x20) // ' '
-        utf8 += self.attribute.rawValue.utf8
+        utf8 += self.attribute.name.utf8
 
         if  self.value.isEmpty
         {

Sources/DOM/DOM.Attribute.swift

@@ -4,7 +4,7 @@ extension HTML
 {
     @GenerateDynamicMemberFactory(excluding: "rel")
     @frozen public
-    enum Attribute:String, Equatable, Hashable, Sendable
+    enum Attribute:String, DOM.Attribute, Equatable, Hashable, Sendable
     {
         case accept
         case accept_charset = "accept-charset"

Sources/DOM/DOM.Property.swift

@@ -0,0 +1,19 @@
+extension HTML.AttributeEncoder
+{
+    @frozen @usableFromInline
+    enum CustomData
+    {
+        case data(String)
+    }
+}
+extension HTML.AttributeEncoder.CustomData:DOM.Attribute
+{
+    @inlinable internal
+    var name:String
+    {
+        switch self
+        {
+        case .data(let suffix): "data-\(suffix)"
+        }
+    }
+}

Sources/DOM/HTML/HTML.Attribute.swift

@@ -47,6 +47,25 @@ extension HTML.AttributeEncoder
         }
     }
 }
+extension HTML.AttributeEncoder
+{
+    @inlinable public
+    subscript(data suffix:String) -> String?
+    {
+        get
+        {
+            nil
+        }
+        set(text)
+        {
+            if  let text:String
+            {
+                self.utf8 += DOM.Property<CustomData>.init(.data(suffix), text)
+            }
+        }
+    }
+}
+
 extension HTML.AttributeEncoder
 {
     @inlinable public

Sources/DOM/HTML/HTML.AttributeEncoder.CustomData.swift

@@ -4,7 +4,7 @@ extension SVG
 {
     @GenerateDynamicMemberFactory
     @frozen public
-    enum Attribute:String, Equatable, Hashable, Sendable
+    enum Attribute:String, DOM.Attribute, Equatable, Hashable, Sendable
     {
         case accent_height = "accent-height"
         case accumulate

Sources/DOM/HTML/HTML.AttributeEncoder.swift

@@ -1,5 +1,5 @@
 @frozen @usableFromInline internal
-enum XMLNS:String, Equatable, Hashable, Sendable
+enum XMLNS:String, DOM.Attribute, Equatable, Hashable, Sendable
 {
     case xmlns
 }

Sources/DOM/SVG/SVG.Attribute.swift

@@ -7,13 +7,28 @@ extension Swiftinit
     {
         private
         let package:Unidoc.PackageOutput
+        /// Cached for sort performance.
+        let order:String
 
         init(_ package:Unidoc.PackageOutput)
         {
             self.package = package
+
+            let name:String = package.metadata.repo?.origin.name
+                ?? package.metadata.symbol.identifier
+            self.order = name.lowercased()
         }
     }
 }
+extension Swiftinit.PackageCard
+{
+    var owner:String? { self.package.metadata.repo?.origin.owner }
+    var stars:Int? { self.package.metadata.repo?.stars }
+    var name:String
+    {
+        self.package.metadata.repo?.origin.name ?? self.package.metadata.symbol.identifier
+    }
+}
 extension Swiftinit.PackageCard:HTML.OutputStreamable
 {
     static
@@ -30,8 +45,7 @@ extension Swiftinit.PackageCard:HTML.OutputStreamable
                     $0.href = "\(Swiftinit.Tags[self.package.metadata.symbol])"
                     $0.class = dead ? "dead" : nil
 
-                } = self.package.metadata.repo?.origin.name ??
-                    self.package.metadata.symbol.identifier
+                } = self.name
 
                 $0[.span] { $0.class = "owner" } = self.package.metadata.repo?.origin.owner
             }