Contents

swift-standards/swift-html-standard

Compatibility wrapper providing unified access to WHATWG HTML implementation with familiar API structure.

Overview

swift-html-standard is a lightweight wrapper around swift-whatwg-html that provides a simplified, unified API structure. It offers three main products for different use cases: complete HTML implementation, attributes-only, or elements-only.

This package serves as the recommended entry point for projects migrating from swift-html-standard or seeking a simpler import structure than the modular swift-whatwg-html organization.

Features

  • Zero-cost abstraction: Direct re-exports with no wrapper types or runtime overhead
  • Simplified imports: Three focused products instead of 26 individual modules
  • Complete WHATWG compliance: Full backing by swift-whatwg-html implementation
  • Flexible granularity: Import everything, just attributes, or just elements
  • Swift 6 concurrency: Full Sendable conformance with strict concurrency mode
  • Migration path: Drop-in replacement for swift-html-standard with minimal changes

Installation

Swift Package Manager

Add to your Package.swift:

dependencies: [
    .package(url: "https://github.com/swift-standards/swift-html-standard", from: "0.1.0")
]

Quick Start

Complete Implementation

import HTML_Standard

// Access all HTML elements and attributes
let input = Input(
    name: Name("email"),
    disabled: nil,
    form: nil,
    type: .email(Input.Email(value: Value("")))
)

Attributes Only

import HTML_Standard_Attributes

// Access only HTML attribute types
let name = Name("username")
let placeholder = Placeholder("Enter username")
let required = Required()

Elements Only

import HTML_Standard_Elements

// Access only HTML element types
let form = Form(
    action: Action("/submit"),
    method: Method.post,
    enctype: EncType.multipart
)

Usage

Available Products

HTML Standard

Complete implementation with all elements and attributes:

import HTML_Standard

// Everything is available
let video = Video(
    src: Src("/video.mp4"),
    controls: Controls(),
    preload: Video.Preload.metadata
)
HTML Standard Attributes

All attribute modules (GlobalAttributes, FormAttributes, LinkAttributes, MediaAttributes, TableAttributes, ScriptAttributes, Metadata):

import HTML_Standard_Attributes

// Attribute types only
let href = Href("https://example.com")
let rel = Rel.stylesheet
let target = Target.blank
HTML Standard Elements

All element modules organized by WHATWG spec sections:

import HTML_Standard_Elements

// Element types with convenient aliases
typealias Element = HTMLElement  // WHATWG_HTML.Element
typealias VoidElement = HTMLVoidElement  // WHATWG_HTML.VoidElement

let section = Section()
let article = Article()

Type Aliases

The Elements product provides convenient aliases:

import HTML_Standard_Elements

// These are equivalent:
let element1: HTMLElement = ...
let element2: WHATWG_HTML.Element = ...

let void1: HTMLVoidElement = ...
let void2: WHATWG_HTML.VoidElement = ...

Migration from swift-html-standard

Replace imports:

// Old
import HTMLTypes
import HTMLAttributeTypes
import HTMLElementTypes

// New
import HTML_Standard
import HTML_Standard_Attributes
import HTML_Standard_Elements

Type names remain the same - only imports change.

Requirements

  • Swift 6.2+
  • macOS 15.0+ / iOS 18.0+ / tvOS 18.0+ / watchOS 11.0+
  • Swift 6 language mode with strict concurrency

Architecture

Package Structure

swift-html-standard/
├── HTML Standard/            # Complete implementation
│   └── Re-exports WHATWG HTML
├── HTML Standard Attributes/ # Attributes only
│   ├── WHATWG HTML Shared
│   ├── WHATWG HTML GlobalAttributes
│   ├── WHATWG HTML FormAttributes
│   ├── WHATWG HTML LinkAttributes
│   ├── WHATWG HTML MediaAttributes
│   ├── WHATWG HTML TableAttributes
│   ├── WHATWG HTML ScriptAttributes
│   └── WHATWG HTML Metadata
└── HTML Standard Elements/   # Elements only
    ├── WHATWG HTML Shared
    └── WHATWG HTML Elements

Design Principles

  1. Zero-cost wrapper: All types are re-exported directly, no intermediate layers
  2. Simplified organization: Three products instead of 26 modules
  3. Familiar structure: Matches expectations from swift-html-standard
  4. Full compliance: Backed by complete WHATWG HTML Living Standard implementation
  5. Flexible imports: Choose the granularity you need

Contributing

Contributions are welcome! This package is a thin wrapper, so most contributions should go to swift-whatwg-html. For wrapper-specific issues:

  • Ensure changes maintain zero-cost abstraction
  • Tests pass with Swift 6.2
  • Code follows existing style

License

This project is licensed under the Apache License 2.0. See LICENSE.md for details.

Package Metadata

Repository: swift-standards/swift-html-standard

Default branch: main

README: README.md