Skip to content

Public Options init, tests, CI matrix, DocC Pages & contributor docs - #20

Merged
PierreJanineh merged 5 commits into
developfrom
docs/add-claude-md
May 30, 2026
Merged

Public Options init, tests, CI matrix, DocC Pages & contributor docs#20
PierreJanineh merged 5 commits into
developfrom
docs/add-claude-md

Conversation

@PierreJanineh

Copy link
Copy Markdown
Member

📋 Description

Hardens the package for public contributors and fixes a latent public-API bug.

  • Options public init — the synthesized memberwise initializer was internal-only, so Options(...) could not be constructed from a consumer module (only .setX() modifiers worked). Adds an explicit public init preserving all defaults.
  • Tests — new ProgressUITests target (9 tests): Options defaults/init, Progressable.calculate(from:) bucketing, GrowDirection alignment.
  • CIactions/checkout@v4, runs swift test, builds across all 6 advertised platforms; push scoped to main + concurrency to avoid redundant runs.
  • DocC → GitHub Pagesswift-docc-plugin + a workflow that publishes the ProgressUI.docc catalog on push to main.
  • Docs — fixed two uncompilable README examples; added CHANGELOG.md, CONTRIBUTING.md, DocC landing page, and Git Flow conventions in CLAUDE.md.
  • Templates — moved the PR template to .github/PULL_REQUEST_TEMPLATE.md so it auto-applies; added a required ProgressUI-version field to the bug report; refreshed Xcode/iOS example versions to 26.

🔄 Type of Change

  • 🐛 Bug fix (public Options init)
  • ✨ New feature (tests, DocC Pages)
  • 📝 Documentation update
  • 🔧 Refactor or internal change (CI)

✅ How Has This Been Tested?

  • xcrun swift test9 tests, 0 failures.
  • xcrun swift build green; DocC generation validated locally (produces index.html).

Test Summary

  • Unit tests
  • UI/Integration tests
  • Manual (DocC build)

⚠️ Setup prerequisite: enable Pages → Source: GitHub Actions in repo settings for the docs workflow to deploy.

🤖 Generated with Claude Code

PierreJanineh and others added 5 commits May 30, 2026 20:02
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Options: add public memberwise initializer so consumers can construct
  Options(...) directly (synthesized memberwise init was internal-only).
- Tests: add ProgressUITests target (Options defaults/init, Progressable
  bucketing, GrowDirection alignment).
- CI: bump checkout v3->v4, run `swift test`, build across all supported
  platforms (iOS/macOS/macCatalyst/watchOS/tvOS/visionOS).
- Docs: fix uncompilable README examples; add DocC catalog, CHANGELOG,
  CONTRIBUTING; document Git Flow branching/release conventions in CLAUDE.md.
- Templates: move PR template to default path so it auto-applies; add a
  required ProgressUI-version field to the bug report; refresh Xcode/iOS
  example versions.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Add swift-docc-plugin (build-tool only) to Package.swift.
- Add Documentation workflow that builds the ProgressUI.docc catalog for
  static hosting and deploys it to GitHub Pages on push to main.
- Gitignore Package.resolved (no lockfile imposed on consumers) and the
  generated /docs site.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Build on push for `main` only; `develop` is reached via PR, which already
  runs the suite, so per-merge double runs are eliminated.
- Add a concurrency group to cancel superseded runs for the same ref.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@PierreJanineh
PierreJanineh merged commit 93a9f63 into develop May 30, 2026
7 checks passed
@PierreJanineh
PierreJanineh deleted the docs/add-claude-md branch May 30, 2026 18:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant