group packages by license and archivedness

Author: tayloraswift

Assets/css/Main.css

@@ -1,12 +1,12 @@
-extension Character:HyperTextOutputStreamable
+extension Character:HTML.OutputStreamable
 {
     @inlinable public static
     func += (html:inout HTML.ContentEncoder, self:Self)
     {
         html += self.utf8
     }
 }
-extension Character:ScalableVectorOutputStreamable
+extension Character:SVG.OutputStreamable
 {
     @inlinable public static
     func += (svg:inout SVG.ContentEncoder, self:Self)

Assets/css/Main.css.map

@@ -1,6 +1,6 @@
-extension String:HyperTextOutputStreamable
+extension String:HTML.OutputStreamable
 {
 }
-extension String:ScalableVectorOutputStreamable
+extension String:SVG.OutputStreamable
 {
 }

Sources/DOM/Conformances/Character (ext).swift

@@ -1,6 +1,6 @@
-extension Substring:HyperTextOutputStreamable
+extension Substring:HTML.OutputStreamable
 {
 }
-extension Substring:ScalableVectorOutputStreamable
+extension Substring:SVG.OutputStreamable
 {
 }

Sources/DOM/Conformances/String (ext).swift

@@ -1,12 +1,12 @@
-extension Unicode.Scalar:HyperTextOutputStreamable
+extension Unicode.Scalar:HTML.OutputStreamable
 {
     @inlinable public static
     func += (html:inout HTML.ContentEncoder, self:Self)
     {
         html += self.utf8
     }
 }
-extension Unicode.Scalar:ScalableVectorOutputStreamable
+extension Unicode.Scalar:SVG.OutputStreamable
 {
     @inlinable public static
     func += (svg:inout SVG.ContentEncoder, self:Self)

Sources/DOM/Conformances/Substring (ext).swift

@@ -0,0 +1,45 @@
+extension HTML
+{
+    public
+    typealias OutputStreamable = _HTMLOutputStreamable
+}
+
+@available(*, deprecated, renamed: "HTML.OutputStreamable")
+public
+typealias HyperTextOutputStreamable = HTML.OutputStreamable
+
+/// The name of this protocol is ``HTML.OutputStreamable``.
+public
+protocol _HTMLOutputStreamable
+{
+    /// Encodes attributes to its parent element when encoded with **single-element subscript
+    /// assignment**. Ignored when streamed generally to an ``HTML.ContentEncoder``.
+    ///
+    /// This operator is declared as a requirement in order to prevent unexpected behavior when
+    /// encoding through generics. Because the attributes are sometimes ignored depending on
+    /// how the value is encoded, we **strongly recommend** against relying on this operator as
+    /// a shortcut for encoding attributes and to witness it instead by declaring conformances
+    /// to well-documented protocols such as ``HTML.OutputStreamableAnchor``.
+    static
+    func += (html:inout HTML.AttributeEncoder, self:Self)
+
+    /// Encodes an instance of this type to the provided HTML stream.
+    static
+    func += (html:inout HTML.ContentEncoder, self:Self)
+}
+extension HTML.OutputStreamable
+{
+    /// Does nothing.
+    @inlinable public static
+    func += (html:inout HTML.AttributeEncoder, self:Self)
+    {
+    }
+}
+extension HTML.OutputStreamable where Self:StringProtocol
+{
+    @inlinable public static
+    func += (html:inout HTML.ContentEncoder, self:Self)
+    {
+        html += self.utf8
+    }
+}

Sources/DOM/Conformances/Unicode.Scalar (ext).swift

@@ -0,0 +1,23 @@
+extension HTML
+{
+    /// A type that adds its ``id`` property to its parent element’s `id` attribute when
+    /// encoded with single-element subscript assignment. Behaves identically to an ordinary
+    /// ``HTML.OutputStreamable`` value when streamed to an ``HTML.ContentEncoder``.
+    public
+    typealias OutputStreamableAnchor = _HTMLOutputStreamableAnchor
+}
+
+/// The name of this protocol is ``HTML.OutputStreamableAnchor``.
+public
+protocol _HTMLOutputStreamableAnchor:HTML.OutputStreamable, Identifiable<String>
+{
+}
+extension HTML.OutputStreamableAnchor
+{
+    /// Encodes the ``id`` property to the parent element’s `id` attribute.
+    @inlinable public static
+    func += (html:inout HTML.AttributeEncoder, self:Self)
+    {
+        html.id = self.id
+    }
+}

Sources/DOM/HTML/HTML.OutputStreamable.swift

@@ -0,0 +1,21 @@
+extension HTML
+{
+    /// A type that wraps its ``display`` value in an `a` element with `href` set to a
+    /// fragment pointing to its ``id`` value.
+    public
+    typealias OutputStreamableHeading = _HTMLOutputStreamableHeading
+}
+
+/// The name of this protocol is ``HTML.OutputStreamableHeading``.
+public
+protocol _HTMLOutputStreamableHeading<Display>:HTML.OutputStreamableAnchor
+{
+    associatedtype Display:HTML.OutputStreamable = String
+
+    var display:Display { get }
+}
+extension HTML.OutputStreamableHeading<String> where Self:CustomStringConvertible
+{
+    @inlinable public
+    var display:String { self.description }
+}