chore: Merge master into develop after 3.0.0

[soulevilx]

Summary

• Merge `master` back into `develop` after the `v3.0.0` tag, GitHub Release, and Packagist publish.

Test plan

• Required GitHub Actions checks on this PR.

Summary by CodeRabbit

• Documentation
  • Added release notes for version 3.0.0, dated August 19, 2026.
  • Updated the README with PHP 8.5+ compatibility, package details, latest stable release information, and a changelog link.

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

[qodo-code-review]

ⓘ Qodo reviews are paused because the subscription is no longer active. Ask your workspace admin to reactivate the subscription to resume reviews. Manage billing

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c63c820f-0d3c-4f57-9a2f-daa272539b1b

📥 Commits

Reviewing files that changed from the base of the PR and between 2cf025e and 5582a38.

📒 Files selected for processing (2)

• CHANGELOG.md
• README.md

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.

---

📝 Walkthrough

Walkthrough

The changelog now records the dated 3.0.0 release. The README identifies the PHP requirement, Composer package, latest stable release, and changelog link.

Changes

Release metadata

Layer / File(s)	Summary
Release and package overview metadata CHANGELOG.md, README.md	The changelog replaces the pending release note with the dated 3.0.0 heading. The README adds PHP, Composer, stable release, and changelog metadata.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Merge Risk: ⚪ Minimal · up to 5582a

This documentation-only change is merge-ready after normal link and release checks; no actionable merge-blocking risk remains.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The description states the merge purpose but omits most required template sections, testing commands, risk details, documentation impact, and checklist items.	Add the required sections from the template, including What changed, Why, How tested with commands and results, Documentation impact, Risk / rollback, and the completed Checklist.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly describes merging master into develop after the 3.0.0 release.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches 💡 1

🛠️ Fix failing CI checks 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch master

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[codacy-production]

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

🟢 Coverage ∅ diff coverage · +0.00% coverage variation

Metric	Results
Coverage variation	✅ +0.00% coverage variation (-1.00%)
Diff coverage	✅ ∅ diff coverage

View coverage diff in Codacy

Coverage variation details

	Coverable lines	Covered lines	Coverage
Common ancestor commit (2cf025e)	3219	3166	98.35%
Head commit (5582a38)	3219 (+0)	3166 (+0)	98.35% (+0.00%)

Coverage variation is the difference between the coverage for the head and common ancestor commits of the pull request branch: <coverage of head commit> - <coverage of common ancestor commit>

Diff coverage details

	Coverable lines	Covered lines	Diff coverage
Pull request (#63)	0	0	∅ (not applicable)

Diff coverage is the percentage of lines that are covered by tests out of the coverable lines that the pull request added or modified: <covered lines added or modified>/<coverable lines added or modified> * 100%

_{NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.}