Release next-1.0.0 (#65)

* Now follows the new Website, Document and Element patterns
* Fixes a small amount of element rendering issues
* Move style modifier tests into seperate file
* Tests for aria labels, style modifiers and HTML escaping all passing
* Script rendering tests passing

Author: maclong9

CONTRIBUTING.md

@@ -104,7 +104,7 @@ swift package --disable-sandbox preview-documentation
 ```
 
 > [!NOTE]
-> You can also run `Build Documentation` inside of Xcode to view the documentation in 
+> You can also run `Build Documentation` inside of Xcode to view the documentation in
 
 ### Adding New Elements
 
@@ -367,7 +367,7 @@ WebUI supports two different ways to apply responsive styles:
    ```swift
    Text { "Responsive Content" }
      .font(size: .sm)
-     .responsive {
+     .on {
        md {
          font(size: .lg)
          background(color: .neutral(._700))

Sources/WebUI/Core/Document.swift

@@ -0,0 +1,62 @@
+public enum Attribute {
+    /// Builds an HTML attribute string if the value exists.
+    ///
+    /// - Parameters:
+    ///   - name: Attribute name (e.g., "id", "class", "src").
+    ///   - value: Attribute value, optional.
+    /// - Returns: Formatted attribute string (e.g., `id="header"`) or nil if value is empty.
+    public static func string(_ name: String, _ value: String?) -> String? {
+        guard let value = value, !value.isEmpty else { return nil }
+        let escapedValue = HTMLEscaper.escapeAttribute(value)
+        return "\(name)=\"\(escapedValue)\""
+    }
+
+    /// Builds an HTML attribute string for a non-optional value.
+    ///
+    /// - Parameters:
+    ///   - name: Attribute name (e.g., "id", "class", "src").
+    ///   - value: Attribute value.
+    /// - Returns: Formatted attribute string (e.g., `id="header"`) or nil if value is empty.
+    public static func string(_ name: String, _ value: String) -> String? {
+        guard !value.isEmpty else { return nil }
+        let escapedValue = HTMLEscaper.escapeAttribute(value)
+        return "\(name)=\"\(escapedValue)\""
+    }
+
+    /// Builds a boolean HTML attribute if enabled.
+    ///
+    /// - Parameters:
+    ///   - name: Attribute name (e.g., "disabled", "checked", "required").
+    ///   - enabled: Boolean enabling the attribute, optional.
+    /// - Returns: Attribute name if true, nil otherwise.
+    public static func bool(_ name: String, _ enabled: Bool?) -> String? {
+        enabled == true ? name : nil
+    }
+
+    /// Builds an HTML attribute string from a typed enum value.
+    ///
+    /// - Parameters:
+    ///   - name: Attribute name (e.g., "type", "role").
+    ///   - value: Enum value with String rawValue, optional.
+    /// - Returns: Formatted attribute string (e.g., `type="submit"`) or nil if value is nil or empty.
+    public static func typed<T: RawRepresentable>(_ name: String, _ value: T?) -> String?
+    where T.RawValue == String {
+        guard let stringValue = value?.rawValue, !stringValue.isEmpty else { return nil }
+        let escapedValue = HTMLEscaper.escapeAttribute(stringValue)
+        return "\(name)=\"\(escapedValue)\""
+    }
+
+    /// Builds an HTML attribute string from a non-optional typed enum value.
+    ///
+    /// - Parameters:
+    ///   - name: Attribute name (e.g., "type", "role").
+    ///   - value: Enum value with String rawValue.
+    /// - Returns: Formatted attribute string (e.g., `type="submit"`) or nil if value is empty.
+    public static func typed<T: RawRepresentable>(_ name: String, _ value: T) -> String?
+    where T.RawValue == String {
+        let stringValue = value.rawValue
+        guard !stringValue.isEmpty else { return nil }
+        let escapedValue = HTMLEscaper.escapeAttribute(stringValue)
+        return "\(name)=\"\(escapedValue)\""
+    }
+}

Sources/WebUI/Core/HTML/Attribute.swift

@@ -0,0 +1,81 @@
+import Foundation
+
+/// Utility for building HTML attributes
+///
+/// The `AttributeBuilder` provides helper methods for generating HTML attribute strings
+/// in a consistent way across all elements.
+public enum AttributeBuilder {
+    /// Builds a collection of HTML attributes from common parameters
+    ///
+    /// - Parameters:
+    ///   - id: Optional unique identifier for the HTML element
+    ///   - classes: Optional array of CSS class names
+    ///   - role: Optional ARIA role for accessibility
+    ///   - label: Optional ARIA label for accessibility
+    ///   - data: Optional dictionary of data attributes
+    ///   - additional: Optional array of additional attribute strings
+    /// - Returns: Array of attribute strings for use in HTML tags
+    public static func buildAttributes(
+        id: String? = nil,
+        classes: [String]? = nil,
+        role: AriaRole? = nil,
+        label: String? = nil,
+        data: [String: String]? = nil,
+        additional: [String] = []
+    ) -> [String] {
+        var attributes: [String] = []
+
+        if let id = id {
+            attributes.append(Attribute.string("id", id)!)
+        }
+
+        if let classes = classes, !classes.isEmpty {
+            attributes.append(Attribute.string("class", classes.joined(separator: " "))!)
+        }
+
+        if let role = role {
+            attributes.append(Attribute.typed("role", role)!)
+        }
+
+        if let label = label {
+            attributes.append(Attribute.string("aria-label", label)!)
+        }
+
+        if let data = data {
+            for (key, value) in data {
+                attributes.append(Attribute.string("data-\(key)", value)!)
+            }
+        }
+
+        attributes.append(contentsOf: additional)
+
+        return attributes
+    }
+
+    /// Renders a complete HTML tag with attributes and content
+    ///
+    /// - Parameters:
+    ///   - tag: The HTML tag name
+    ///   - attributes: Array of attribute strings
+    ///   - content: Optional content to include between opening and closing tags
+    ///   - isSelfClosing: Whether this is a self-closing tag
+    ///   - noClosingTag: Whether this should be rendered without a self-close and without a seperate close
+    /// - Returns: Complete HTML tag as a string
+    public static func renderTag(
+        _ tag: String,
+        attributes: [String],
+        content: String = "",
+        isSelfClosing: Bool = false,
+        hasNoClosingTag: Bool = false,
+    ) -> String {
+        let attributeString = attributes.isEmpty ? "" : " " + attributes.joined(separator: " ")
+
+        if isSelfClosing {
+            return "<\(tag)\(attributeString) />"
+        } else if hasNoClosingTag {
+            return "<\(tag)\(attributeString)>"
+        } else {
+            return "<\(tag)\(attributeString)>\(content)</\(tag)>"
+        }
+    }
+}