Custom Layout Engine for Fiber Reconciler

Sources/TokamakCore/Fiber/AlignmentID.swift

@@ -17,7 +17,27 @@
 
 import Foundation
 
+/// Used identify an alignment guide.
+///
+/// Typically, you would define an alignment guide inside
+/// an extension on `HorizontalAlignment` or `VerticalAlignment`:
+///
+///     extension HorizontalAlignment {
+///       private enum MyAlignmentGuide: AlignmentID {
+///         static func defaultValue(in context: ViewDimensions) -> CGFloat {
+///           return 10.0
+///         }
+///       }
+///       public static let myAlignmentGuide = Self(MyAlignmentGuide.self)
+///     }
+///
+/// Which you can then use with the `alignmentGuide` modifier:
+///
+///     Text("Hello, world!")
+///       .alignmentGuide(.myAlignmentGuide) { $0[.trailing] - 3 }
 public protocol AlignmentID {
+  /// The default value for this alignment guide
+  /// when not set via the `alignmentGuide` modifier.
   static func defaultValue(in context: ViewDimensions) -> CGFloat
 }
 

Sources/TokamakCore/Fiber/Fiber.swift

@@ -17,7 +17,7 @@
 
 import Foundation
 
-@_spi(TokamakCore) 
+@_spi(TokamakCore)
 public extension FiberReconciler {
   /// A manager for a single `View`.
   ///

Sources/TokamakCore/Fiber/Layout/ShrinkWrapLayoutComputer.swift

@@ -17,7 +17,7 @@
 
 import Foundation
 
-/// A `LayoutComputer` that takes the size of its children.
+/// A `LayoutComputer` that shrinks to the size of its children.
 final class ShrinkWrapLayoutComputer: LayoutComputer {
   let proposedSize: CGSize
 

Sources/TokamakCore/Fiber/Layout/StackLayoutComputer.swift

@@ -17,6 +17,12 @@
 
 import Foundation
 
+/// A `LayoutComputer` that aligns `Views` along a specified `Axis`
+/// with a given spacing and alignment.
+///
+/// The specified main `Axis` will fit to the combined width/height (depending on the axis)
+/// of the children.
+/// The cross axis will fit to the child with the largest height/width.
 final class StackLayoutComputer: LayoutComputer {
   let proposedSize: CGSize
   let axis: Axis

Sources/TokamakCore/Fiber/ViewGeometry.swift

@@ -18,29 +18,29 @@
 import Foundation
 
 public struct ViewGeometry: Equatable {
-  @_spi(TokamakCore) 
+  @_spi(TokamakCore)
   public let origin: ViewOrigin
 
-  @_spi(TokamakCore) 
+  @_spi(TokamakCore)
   public let dimensions: ViewDimensions
 }
 
 /// The position of the `View` relative to its parent.
 public struct ViewOrigin: Equatable {
-  @_spi(TokamakCore) 
+  @_spi(TokamakCore)
   public let origin: CGPoint
 
-  @_spi(TokamakCore) 
+  @_spi(TokamakCore)
   public var x: CGFloat { origin.x }
-  @_spi(TokamakCore) 
+  @_spi(TokamakCore)
   public var y: CGFloat { origin.y }
 }
 
 public struct ViewDimensions: Equatable {
-  @_spi(TokamakCore) 
+  @_spi(TokamakCore)
   public let size: CGSize
 
-  @_spi(TokamakCore) 
+  @_spi(TokamakCore)
   public let alignmentGuides: [ObjectIdentifier: CGFloat]
 
   public var width: CGFloat { size.width }

Sources/TokamakDOM/DOMFiberRenderer.swift

@@ -17,9 +17,9 @@
 
 import Foundation
 import JavaScriptKit
-@_spi(TokamakCore) 
+@_spi(TokamakCore)
 import TokamakCore
-@_spi(TokamakStaticHTML) 
+@_spi(TokamakStaticHTML)
 import TokamakStaticHTML
 
 public final class DOMElement: FiberElement {

Sources/TokamakStaticHTML/Modifiers/LayoutModifiers.swift

@@ -73,7 +73,7 @@ extension _FrameLayout: DOMViewModifier {
   }
 }
 
-@_spi(TokamakStaticHTML) 
+@_spi(TokamakStaticHTML)
 extension _FrameLayout: HTMLConvertible {
   public var tag: String { "div" }
   public func attributes(shouldLayout: Bool) -> [HTMLAttribute: String] {

Sources/TokamakStaticHTML/StaticHTMLFiberRenderer.swift

@@ -16,7 +16,7 @@
 //
 
 import Foundation
-@_spi(TokamakCore) 
+@_spi(TokamakCore)
 import TokamakCore
 
 public final class HTMLElement: FiberElement, CustomStringConvertible {

Sources/TokamakStaticHTML/Views/Text/Text.swift

@@ -161,26 +161,7 @@ extension Text: AnyHTML {
 
 @_spi(TokamakStaticHTML) extension Text: HTMLConvertible {
   @_spi(TokamakStaticHTML) public var innerHTML: String? {
-    let proxy = _TextProxy(self)
-    let innerHTML: String
-    switch proxy.storage {
-    case let .verbatim(text):
-      innerHTML = proxy.environment.domTextSanitizer(text)
-    case let .segmentedText(segments):
-      innerHTML = segments
-        .map {
-          TextSpan(
-            content: proxy.environment.domTextSanitizer($0.0.rawText),
-            attributes: Self.attributes(
-              from: $0.1,
-              environment: proxy.environment
-            )
-          )
-          .outerHTML(shouldSortAttributes: false, children: [])
-        }
-        .reduce("", +)
-    }
-    return innerHTML.replacingOccurrences(of: "\n", with: "<br />")
+    innerHTML(shouldSortAttributes: false)
   }
 
   public func attributes(shouldLayout: Bool) -> [HTMLAttribute: String] {