v1.0.0

Focus 1.0

Focus is stable. From this release it follows semantic versioning. The Versioning docs say what that covers:

• The manifest API: ScreenshotSuite, Screenshot and Card.
• The enums, contracts and exceptions.
• The CLI: its commands, options and exit codes.
• The output file names.
• The card template contract.
• Output-changing defaults: a default that changes existing images needs a new major version.

1.0 adds no features. It is the 0.3 API, now promised. It has been used across eleven packages to generate their documentation screenshots and share cards.

Upgrading from 0.3

• PHP 8.3 or later is now required.
• Internal classes: classes and methods outside the public API are marked @internal, including Runtime\*, Manifest\*, Console\*, Capture and ScreenshotSuite::plan(). Code that used them directly should move to the manifest API. They can change in any release.
• Branch: development continues on the 1.x branch, which is now the default.

Update the constraint to "awcodes/focus": "^1.0", or "^0.3|^1.0" to allow both.

Not in 1.0

Chromium is not pinned to a Focus release yet. A browser or OS font update can change pixels, so generate a repository's images on one machine.

Full changelog: v0.3.0...v1.0.0