added _SendableAnyHTMLBox (#60)

* added _SendableAnyHTMLBox

* ifed out embedded and swift 6 only test case

* gosh darn complier crashes...

* added swift github issue link

Author: sliemeobn

Sources/Elementary/ServerSupport/SendOnceBox.swift

@@ -0,0 +1,31 @@
+#if swift(>=6.0) && !hasFeature(Embedded)
+import Synchronization
+
+@available(macOS 15.0, *)
+final class SendOnceBox: Sendable, SendOnceBoxing {
+    // final class SendOnceBox<Value>: Sendable, SendOnceBoxing {
+    typealias Value = any HTML
+    // NOTE: generics+Synchronization crashes the compiler ATM
+    // https://github.com/swiftlang/swift/issues/78048
+
+    let mutex: Mutex<Value?>
+
+    init(_ value: sending Value) {
+        mutex = Mutex(value)
+    }
+
+    func tryTake() -> sending Value? {
+        mutex.withLock { value -> sending Value? in
+            let result = value
+            value = nil
+            return result
+        }
+    }
+}
+
+// NOTE: this is for macOS runtime availability of SendOnceBox and can be removed when macOS 15 is the minimum
+protocol SendOnceBoxing<Value>: AnyObject, Sendable {
+    associatedtype Value
+    func tryTake() -> sending Value?
+}
+#endif

Sources/Elementary/ServerSupport/SendableAnyHTMLBox.swift

@@ -0,0 +1,46 @@
+#if !hasFeature(Embedded)
+/// A wrapper around an `any HTML` value that can be safely sent once.
+///
+/// Note: For non-sendable values, this will only allow the value to be taken only once.
+/// Sendable values can safely be taken multiple times.
+public struct _SendableAnyHTMLBox: Sendable {
+    var storage: Storage
+
+    enum Storage {
+        case sendable(any HTML & Sendable)
+        #if swift(>=6.0)
+        // NOTE: protocol can be removed when macOS 15 is the minimum
+        case sendOnceBox(any SendOnceBoxing<any HTML>)
+        #endif
+    }
+
+    public init(_ html: any HTML & Sendable) {
+        storage = .sendable(html)
+    }
+
+    #if swift(>=6.0)
+    @available(macOS 15, *)
+    public init(_ html: sending any HTML) {
+        storage = .sendOnceBox(SendOnceBox(html))
+    }
+    #endif
+
+    #if swift(>=6.0)
+    public consuming func tryTake() -> sending (any HTML)? {
+        switch storage {
+        case let .sendable(html):
+            return html
+        case let .sendOnceBox(box):
+            return box.tryTake()
+        }
+    }
+    #else
+    public consuming func tryTake() -> (any HTML & Sendable)? {
+        switch storage {
+        case let .sendable(html):
+            return html
+        }
+    }
+    #endif
+}
+#endif

Tests/ElementaryTests/SendableAnyHTMLBox.swift

@@ -0,0 +1,32 @@
+import Elementary
+import XCTest
+
+@available(macOS 15.0, *)
+final class SendOnceHTMLValueTests: XCTestCase {
+    func testHoldsSendableValue() {
+        let html = div { "Hello, World!" }
+        let box = _SendableAnyHTMLBox(html)
+        XCTAssertNotNil(box.tryTake())
+        XCTAssertNotNil(box.tryTake())
+    }
+
+    #if swift(>=6.0)
+    func testHoldsNonSendable() {
+        let html = MyComponent()
+        let box = _SendableAnyHTMLBox(html)
+        XCTAssertNotNil(box.tryTake())
+        XCTAssertNil(box.tryTake())
+    }
+    #endif
+}
+
+class NonSendable {
+    var x: Int = 0
+}
+
+struct MyComponent: HTML {
+    let ns = NonSendable()
+    var content: some HTML {
+        div { "\(ns.x)" }
+    }
+}