added initial logic to support streaming and other result representations and...

- `HTMLEncoding` now conforms to `Equatable`, and added `typeAnnotation` computed property

Author: RandomHashTags

.swift-version

@@ -1 +1 @@
-6.0.3
+6.1.2

Sources/HTMLKit/HTMLKit.swift

@@ -10,24 +10,27 @@
 @freestanding(expression)
 public macro escapeHTML(
     encoding: HTMLEncoding = .string,
+    representation: HTMLResultRepresentation = .literalOptimized,
     _ innerHTML: CustomStringConvertible & Sendable...
 ) -> String = #externalMacro(module: "HTMLKitMacros", type: "EscapeHTML")
 
 // MARK: HTML
 /// - Returns: The inferred concrete type that conforms to `CustomStringConvertible & Sendable`.
 @freestanding(expression)
 //@available(*, deprecated, message: "innerHTML is now initialized using brackets instead of parentheses")
-public macro html<T: CustomStringConvertible & Sendable>(
+public macro html<T>(
     encoding: HTMLEncoding = .string,
+    representation: HTMLResultRepresentation = .literalOptimized,
     lookupFiles: [StaticString] = [],
     _ innerHTML: CustomStringConvertible & Sendable...
 ) -> T = #externalMacro(module: "HTMLKitMacros", type: "HTMLElementMacro")
 
 // MARK: HTML
 /// - Returns: The inferred concrete type that conforms to `CustomStringConvertible & Sendable`.
 @freestanding(expression)
-public macro html<T: CustomStringConvertible & Sendable>(
+public macro html<T>(
     encoding: HTMLEncoding = .string,
+    representation: HTMLResultRepresentation = .literalOptimized,
     lookupFiles: [StaticString] = [],
     _ innerHTML: () -> CustomStringConvertible & Sendable...
 ) -> T = #externalMacro(module: "HTMLKitMacros", type: "HTMLElementMacro")
@@ -36,6 +39,7 @@ public macro html<T: CustomStringConvertible & Sendable>(
 @freestanding(expression)
 public macro anyHTML(
     encoding: HTMLEncoding = .string,
+    representation: HTMLResultRepresentation = .literalOptimized,
     lookupFiles: [StaticString] = [],
     _ innerHTML: CustomStringConvertible & Sendable...
 ) -> any CustomStringConvertible & Sendable = #externalMacro(module: "HTMLKitMacros", type: "HTMLElementMacro")
@@ -47,6 +51,7 @@ public macro anyHTML(
 @freestanding(expression)
 public macro uncheckedHTML<T: CustomStringConvertible & Sendable>(
     encoding: HTMLEncoding = .string,
+    representation: HTMLResultRepresentation = .literalOptimized,
     lookupFiles: [StaticString] = [],
     _ innerHTML: CustomStringConvertible & Sendable...
 ) -> T = #externalMacro(module: "HTMLKitMacros", type: "HTMLElementMacro")
@@ -58,6 +63,7 @@ public macro uncheckedHTML<T: CustomStringConvertible & Sendable>(
 @freestanding(expression)
 public macro rawHTML<T: CustomStringConvertible & Sendable>(
     encoding: HTMLEncoding = .string,
+    representation: HTMLResultRepresentation = .literalOptimized,
     lookupFiles: [StaticString] = [],
     minify: Bool = false,
     _ innerHTML: CustomStringConvertible & Sendable...
@@ -69,6 +75,7 @@ public macro rawHTML<T: CustomStringConvertible & Sendable>(
 @freestanding(expression)
 public macro anyRawHTML(
     encoding: HTMLEncoding = .string,
+    representation: HTMLResultRepresentation = .literalOptimized,
     lookupFiles: [StaticString] = [],
     minify: Bool = false,
     _ innerHTML: CustomStringConvertible & Sendable...

Sources/HTMLKitMacros/EscapeHTML.swift

@@ -11,6 +11,7 @@ enum EscapeHTML: ExpressionMacro {
             expansion: node,
             ignoresCompilerWarnings: false,
             encoding: .string,
+            representation: .literalOptimized,
             key: "",
             arguments: node.arguments,
             escape: true,

Sources/HTMLKitMacros/HTMLElement.swift

@@ -12,6 +12,7 @@ enum HTMLElementMacro: ExpressionMacro {
             expansion: node,
             ignoresCompilerWarnings: node.macroName.text == "uncheckedHTML",
             encoding: .string,
+            representation: .literalOptimized,
             key: "",
             arguments: node.arguments,
             escape: true,

Sources/HTMLKitMacros/RawHTML.swift

@@ -11,6 +11,7 @@ enum RawHTML: ExpressionMacro {
             expansion: node,
             ignoresCompilerWarnings: false,
             encoding: .string,
+            representation: .literalOptimized,
             key: "",
             arguments: node.arguments,
             escape: false,