Modernize 2026

[ctreffs]

Modernize 2026: Swift 6.1, Documentation & Workflows

This PR represents a comprehensive modernization of the Fireblade ECS project, bringing it up to date with the latest Swift standards (6.1), achieving near-100% documentation coverage, and standardizing the CI/CD pipeline.

1. Swift 6.1 Modernization

• Language Update: Updated project to Swift 6.1.
• Strict Concurrency: Addressed concurrency warnings and adopted strict checking where applicable.
• Code Cleanup: Removed deprecated APIs and modernized syntax.
• Generic Constraints: Updated generic constraints to align with modern Swift practices.
• Benchmarks Optimization: Introduced benchmarks package trait to conditionally compile performance tests, reducing build times for standard users.

2. Comprehensive Documentation (Goal: 100%)

• Full API Coverage: Systematically documented all public APIs, including Nexus, Entity, Family, and core component protocols.
• Complexity Analysis: Added O(1), O(n), etc., complexity notes to performance-critical methods.
• DocC Integration: Resolved all documentation compiler warnings.
• Metrics: Achieved >95% documentation coverage across Globals, Members, and Types.

3. Workflow Standardization & CI/CD

• Reference Implementation: Synchronized GitHub Actions with FirebladeMath standards.
• New Platforms: Added ci-ios.yml for iOS simulator testing.
• WASM Support: Aligned ci-wasm.yml with the standard workflow structure, targeting swift-6.1-RELEASE.
• Documentation Pipeline:
  • Replaced documentation.yml with docs.yml.
  • Implemented versioned documentation (main, latest) output.
  • Added automated HTML redirects and post-deployment smoke tests.

4. Developer Experience (DevEx)

• Makefile Improvements:
  • Added/Updated targets: docs-generate, docs-check-coverage, docs-check-links.
  • Fixed clean target.
  • Aligned Makefile variables (REPO_NAME, DOCS_VERSION_PATH) for better tooling integration.