build(deps): bump unhead + @unhead/vue to v3.0.0

[PierreBrisorgueil]

Summary

• What changed: Bump both unhead and @unhead/vue from ^2.1.13 to ^3.0.0 (resolved to 3.0.2) in a single coordinated PR.
• Why: @unhead/vue depends on unhead and both must share the same major version — mixing v2/v3 will break. Supersedes and replaces the two separate Dependabot PRs build(deps): bump @unhead/vue from 2.1.13 to 3.0.0 #3934 and build(deps): bump unhead from 2.1.13 to 3.0.0 #3937.
• Related issues: Supersedes build(deps): bump @unhead/vue from 2.1.13 to 3.0.0 #3934, build(deps): bump unhead from 2.1.13 to 3.0.0 #3937

Scope

• Modules impacted: src/main.js, src/modules/app/app.vue, src/modules/home/components/home.faq.component.vue (runtime usage — no code changes required)
• Cross-module impact: none
• Risk level: low

v3 breaking changes audit

Breaking change	Used here?	Action
@unhead/vue/legacy deprecated	No — using @unhead/vue/client	none
useServerHead* removed	No	none
children / hid / vmid / body: true / mode removed	No — only title, htmlAttrs, meta, link, script.innerHTML	none
Vite plugin import renamed	No plugin in use	none
Synchronous render pipeline	Transparent to callers	none

No downstream-visible behavioral change — no MIGRATION.md entry required.

Validation

• npm run lint
• npm run test:unit — 897/897 passing, coverage 99.07% stmts / 93.93% branches / 98.72% funcs / 99.49% lines
• npm run build
• Manual audit: grepped src/ for all deprecated v3 properties — none found

Guardrails check

• No secrets or credentials introduced
• No risky rename/move of core stack paths
• Changes remain merge-friendly for downstream projects
• Tests added or updated when behavior changed (no behavior change, existing tests cover useHead call shape)

Optional: Infra/Stack alignment details

Before vs After (key changes only)

Area	Before	After	Notes
unhead	^2.1.13	^3.0.0 (3.0.2)	major bump
@unhead/vue	^2.1.13	^3.0.0 (3.0.2)	major bump, must match

• Upstream parity target / source: unjs/unhead v3.0.0 release
• Automation or policy impact: closes two Dependabot PRs, single future Dependabot source
• Rollback plan: revert this commit

Notes for reviewers

• Security considerations: none — dependency update, no attack surface change
• Mergeability considerations: supersedes build(deps): bump @unhead/vue from 2.1.13 to 3.0.0 #3934 and build(deps): bump unhead from 2.1.13 to 3.0.0 #3937 (will be closed once this is merged)
• Follow-up tasks: none

Summary by CodeRabbit

• Chores
  • Updated Unhead Vue integration and core package dependencies to latest major versions (v3.0.0).

[coderabbitai]

Warning

Rate limit exceeded

@PierreBrisorgueil has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 20 minutes and 13 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 20 minutes and 13 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 1fd8aabc-bdbc-4d69-b253-4fc8c97ba24f

📥 Commits

Reviewing files that changed from the base of the PR and between 60ae16d and 074d316.

⛔ Files ignored due to path filters (1)

• package-lock.json is excluded by !**/package-lock.json

📒 Files selected for processing (1)

• package.json

Walkthrough

The PR updates Unhead-related dependencies to major version 3.0.0. Both @unhead/vue and unhead packages are upgraded from version 2.1.13, which involves a major version change and potential breaking changes.

Changes

Cohort / File(s)	Summary
Dependency Version Upgrade package.json	Updated @unhead/vue and unhead from ^2.1.13 to ^3.0.0, indicating a major version upgrade with potential breaking changes.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately and concisely summarizes the main change: upgrading unhead and @unhead/vue dependencies to v3.0.0, following conventional commit format.
Description check	✅ Passed	The description comprehensively covers all required template sections including summary, scope, validation checklist, guardrails, infra details, and reviewer notes with thorough breaking-changes audit.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chore/bump-unhead-v3

---

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 and usage tips.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 99.46%. Comparing base (3fa094b) to head (074d316).
⚠️ Report is 3 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #3948   +/-   ##
=======================================
  Coverage   99.46%   99.46%           
=======================================
  Files          29       29           
  Lines         940      940           
  Branches      252      252           
=======================================
  Hits          935      935           
  Misses          5        5           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[Copilot]

Pull request overview

Updates the project’s head management stack by upgrading @unhead/vue and unhead to the v3 major line to keep the framework wrapper and core package aligned.

Changes:

• Bump @unhead/vue from ^2.1.13 to ^3.0.0.
• Bump unhead from ^2.1.13 to ^3.0.0.
• Regenerate package-lock.json to resolve to v3.0.2 and capture updated transitive dependencies.

Reviewed changes

Copilot reviewed 1 out of 2 changed files in this pull request and generated 1 comment.

File	Description
package.json	Updates @unhead/vue and unhead dependency ranges to v3.
package-lock.json	Locks resolved versions (notably @unhead/vue@3.0.2 / unhead@3.0.2) and updates the dependency graph accordingly.

[PierreBrisorgueil]

@coderabbitai review

[coderabbitai]

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.