organize frontend HTML under the Swiftinit namespace

Author: tayloraswift

Package.swift

@@ -55,6 +55,8 @@ let package:Package = .init(
         .library(name: "Sitemaps", targets: ["Sitemaps"]),
         .library(name: "Sources", targets: ["Sources"]),
 
+        .library(name: "Swiftinit", targets: ["Swiftinit"]),
+
         .library(name: "SymbolGraphBuilder", targets: ["SymbolGraphBuilder"]),
         .library(name: "SymbolGraphCompiler", targets: ["SymbolGraphCompiler"]),
         .library(name: "SymbolGraphLinker", targets: ["SymbolGraphLinker"]),
@@ -66,8 +68,8 @@ let package:Package = .init(
 
         .library(name: "UA", targets: ["UA"]),
         .library(name: "Unidoc", targets: ["Unidoc"]),
+        .library(name: "UnidocAPI", targets: ["UnidocAPI"]),
         .library(name: "UnidocAssets", targets: ["UnidocAssets"]),
-        .library(name: "UnidocAutomation", targets: ["UnidocAutomation"]),
         .library(name: "UnidocDB", targets: ["UnidocDB"]),
         .library(name: "UnidocDiagnostics", targets: ["UnidocDiagnostics"]),
         .library(name: "UnidocLinker", targets: ["UnidocLinker"]),
@@ -365,6 +367,11 @@ let package:Package = .init(
 
         .target(name: "Sources"),
 
+        .target(name: "Swiftinit", dependencies:
+            [
+                .target(name: "URI"),
+            ]),
+
         .target(name: "Symbols", dependencies:
             [
                 .target(name: "Sources"),
@@ -439,15 +446,16 @@ let package:Package = .init(
 
         .target(name: "Unidoc"),
 
-        .target(name: "UnidocAssets", dependencies:
+        .target(name: "UnidocAPI", dependencies:
             [
-                .target(name: "UnidocPages"),
-                .target(name: "System"),
+                .target(name: "JSON"),
+                .target(name: "Unidoc"),
             ]),
 
-        .target(name: "UnidocAutomation", dependencies:
+        .target(name: "UnidocAssets", dependencies:
             [
-                .target(name: "JSON"),
+                .target(name: "UnidocPages"),
+                .target(name: "System"),
             ]),
 
         .target(name: "UnidocDB", dependencies:
@@ -478,7 +486,8 @@ let package:Package = .init(
                 .target(name: "GitHubAPI"),
                 .target(name: "HTTP"),
                 .target(name: "MarkdownRendering"),
-                .target(name: "UnidocAutomation"),
+                .target(name: "Swiftinit"),
+                .target(name: "UnidocAPI"),
                 .target(name: "UnidocProfiling"),
                 .target(name: "UnidocQueries"),
                 .target(name: "URI"),
@@ -504,7 +513,7 @@ let package:Package = .init(
                 .target(name: "JSON"),
                 .target(name: "MD5"),
                 .target(name: "SymbolGraphs"),
-                .target(name: "Unidoc"),
+                .target(name: "UnidocAPI"),
             ]),
 
         .target(name: "UnixTime"),
@@ -532,7 +541,7 @@ let package:Package = .init(
             [
                 .target(name: "HTTPClient"),
                 .target(name: "SymbolGraphBuilder"),
-                .target(name: "UnidocAutomation"),
+                .target(name: "UnidocAPI"),
                 .target(name: "UnidocLinker"),
                 .target(name: "UnidocRecords"),
             ]),

Sources/Swiftinit/Swiftinit.Method.swift

@@ -0,0 +1,22 @@
+extension Swiftinit
+{
+    public
+    typealias Method = _SwiftinitMethod
+}
+
+/// The name of this protocol is ``Swiftinit.Method``.
+public
+protocol _SwiftinitMethod:LosslessStringConvertible
+{
+}
+extension Swiftinit.Method where Self:RawRepresentable<String>
+{
+    @inlinable public
+    var description:String { self.rawValue }
+
+    @inlinable public
+    init?(_ description:String)
+    {
+        self.init(rawValue: description)
+    }
+}

Sources/Swiftinit/Swiftinit.StaticRoot.swift

@@ -0,0 +1,33 @@
+import URI
+
+extension Swiftinit
+{
+    public
+    typealias StaticRoot = _SwiftinitStaticRoot
+}
+
+/// The name of this protocol is ``Swiftinit.StaticRoot``.
+public
+protocol _SwiftinitStaticRoot
+{
+    associatedtype Get = Never
+    associatedtype Post = Never
+
+    static
+    var root:String { get }
+}
+extension Swiftinit.StaticRoot
+{
+    @inlinable public static
+    var uri:URI { [.push(self.root)] }
+}
+extension Swiftinit.StaticRoot where Get:Swiftinit.Method
+{
+    @inlinable public static
+    subscript(get:Get) -> URI { Self.uri.path / "\(get)" }
+}
+extension Swiftinit.StaticRoot where Post:Swiftinit.Method
+{
+    @inlinable public static
+    subscript(post:Post) -> URI { Self.uri.path / "\(post)" }
+}

Sources/UnidocServer/Swiftinit.swift renamed to Sources/Swiftinit/Swiftinit.swift

@@ -0,0 +1,8 @@
+extension Swiftinit.API
+{
+    @frozen public
+    enum Get:String, Swiftinit.Method
+    {
+        case build
+    }
+}

Sources/Swiftinit/Tree/Swiftinit.API.Get.swift

@@ -1,9 +1,7 @@
-import UnidocAutomation
-
-extension UnidocAPI
+extension Swiftinit.API
 {
     @frozen public
-    enum Post:String
+    enum Post:String, Swiftinit.Method
     {
         case alignPackage = "align-package"
         case indexRepo = "index-repo"
@@ -12,6 +10,3 @@ extension UnidocAPI
         case unlink
     }
 }
-extension UnidocAPI.Post:StaticAPI
-{
-}

Sources/UnidocPages/API/UnidocAPI.Post.swift renamed to Sources/Swiftinit/Tree/Swiftinit.API.Post.swift

@@ -1,14 +1,9 @@
-import UnidocAutomation
-
-extension UnidocAPI
+extension Swiftinit.API
 {
     @frozen public
-    enum Put:String
+    enum Put:String, Swiftinit.Method
     {
         case snapshot = "snapshot"
         case graph = "symbolgraph"
     }
 }
-extension UnidocAPI.Put:StaticAPI
-{
-}

Sources/UnidocPages/API/UnidocAPI.Put.swift renamed to Sources/Swiftinit/Tree/Swiftinit.API.Put.swift

@@ -0,0 +1,9 @@
+extension Swiftinit
+{
+    @frozen public
+    enum API:StaticRoot
+    {
+        @inlinable public static
+        var root:String { "api" }
+    }
+}

Sources/Swiftinit/Tree/Swiftinit.API.swift

@@ -0,0 +1,9 @@
+extension Swiftinit
+{
+    @frozen public
+    enum Admin:StaticRoot
+    {
+        @inlinable public static
+        var root:String { "admin" }
+    }
+}

Sources/Swiftinit/Tree/Swiftinit.Admin.swift

@@ -0,0 +1,9 @@
+extension Swiftinit
+{
+    public
+    enum Asset:StaticRoot
+    {
+        @inlinable public static
+        var root:String { "asset" }
+    }
+}