fix(bundler): retain installed parser fallback

Author: harlan-zw

docs/head/1.guides/build-plugins/0.overview.md

@@ -10,12 +10,6 @@ The Vue, React, Svelte, and Solid.js packages each ship a Vite plugin at `@unhea
 
 Install your framework's Unhead package, then add the plugin to your Vite config:
 
-Vite 8 reuses the parser included with Rolldown. If your build does not provide Rolldown, install the optional Oxc fallback:
-
-```bash
-pnpm add -D oxc-parser
-```
-
 ::FrameworkCode
 
 #vue

packages/bundler/README.md

@@ -26,12 +26,6 @@ yarn add @unhead/bundler
 pnpm add @unhead/bundler
 ```
 
-Vite 8 reuses Rolldown's parser. Other build setups also need the optional Oxc fallback:
-
-```bash
-pnpm add -D oxc-parser
-```
-
 ## Usage
 
 ### Vite Plugin

packages/bundler/package.json

@@ -83,7 +83,6 @@
     "@vitejs/devtools-kit": "^0.4.1",
     "esbuild": ">=0.17.0",
     "lightningcss": ">=1.20.0",
-    "oxc-parser": ">=0.98.0",
     "rolldown": ">=1.0.0-beta.0",
     "unhead": "workspace:^",
     "vite": ">=6.4.2",
@@ -102,9 +101,6 @@
     "lightningcss": {
       "optional": true
     },
-    "oxc-parser": {
-      "optional": true
-    },
     "rolldown": {
       "optional": true
     },
@@ -117,13 +113,13 @@
   },
   "dependencies": {
     "magic-string": "catalog:",
+    "oxc-parser": "catalog:",
     "oxc-walker": "catalog:",
     "ufo": "catalog:",
     "unplugin": "catalog:"
   },
   "devDependencies": {
     "@vitejs/devtools-kit": "catalog:",
-    "oxc-parser": "catalog:",
     "rollup": "catalog:",
     "unhead": "workspace:*",
     "vite": "catalog:"

packages/bundler/src/unplugin/parser.ts

@@ -81,7 +81,7 @@ function getParser(): ParserResolutionSuccess {
   if (resolution._tag === 'missing') {
     throw Object.assign(
       new Error(
-        'Unhead build transforms need a parser. Vite 8 provides Rolldown; otherwise install oxc-parser with `pnpm add -D oxc-parser`.',
+        'Unhead could not load a parser for its build transforms. Reinstall @unhead/bundler to restore its oxc-parser dependency.',
         { cause: new AggregateError(resolution.failures.map(failure => failure.cause), 'Parser resolution failed') },
       ),
       { _tag: 'MissingParserError' as const },

packages/bundler/test/package.test.ts

@@ -15,11 +15,11 @@ const packageJson = JSON.parse(
 ) as PackageJson
 
 describe('@unhead/bundler package', () => {
-  it('keeps oxc-parser as an optional fallback', () => {
-    expect(packageJson.dependencies).not.toHaveProperty('oxc-parser')
-    expect(packageJson.peerDependencies).toHaveProperty('oxc-parser')
-    expect(packageJson.peerDependenciesMeta?.['oxc-parser']).toEqual({ optional: true })
-    expect(packageJson.devDependencies).toHaveProperty('oxc-parser')
+  it('installs oxc-parser as the fallback parser', () => {
+    expect(packageJson.dependencies).toHaveProperty('oxc-parser')
+    expect(packageJson.peerDependencies).not.toHaveProperty('oxc-parser')
+    expect(packageJson.peerDependenciesMeta).not.toHaveProperty('oxc-parser')
+    expect(packageJson.devDependencies).not.toHaveProperty('oxc-parser')
   })
 
   it('keeps Vite DevTools packages optional', () => {