feat: @unhead/bundler and /vite subpath exports (#726)

* feat: unified vite plugin per framework, rename @unhead/addons to @unhead/bundler

Adds `./vite` export to each framework package (@unhead/vue, @unhead/react,
@unhead/svelte, @unhead/solid-js) that composes build optimizations and
streaming SSR into a single plugin call.

Before:
  import Unhead from '@unhead/addons/vite'
  import { unheadVuePlugin } from '@unhead/vue/stream/vite'
  plugins: [vue(), Unhead(), unheadVuePlugin()]

After:
  import unhead from '@unhead/vue/vite'
  plugins: [vue(), unhead()]

Other changes:
- Rename @unhead/addons to @unhead/bundler
- Deprecated @unhead/addons alias in packages-aliased/
- Normalize plugin options: all accept `false` to disable
- Streaming is opt-in (`streaming: true`)
- Deprecate `treeshake.enabled` in favor of `treeshake: false`
- Add `moduleType: 'js'` to streaming load hooks for Rolldown compat
- Use hook filter objects on resolveId/load for Rolldown performance
- Remove stale Vite 4 compat code

* docs: update install guides to use unified vite plugin

Replace duplicated tree-shaking snippets in schema-org install docs with
framework-specific examples using the new unified plugin. Rewrite the main
Vite Plugin guide as the canonical reference for all frameworks. Update
minify docs to reference the unified plugin.

* docs: use generic wording for vite plugin recommendation

Focus on the primary benefits (tree-shaking server code, transforming
head composables) rather than the niche schema-org stripping.

Author: harlan-zw

bench/ssr-harlanzw-com-e2e.bench.ts

@@ -1,5 +1,5 @@
 import type { Head } from 'unhead/types'
-import { InferSeoMetaPlugin } from '@unhead/addons'
+import { InferSeoMetaPlugin } from '@unhead/bundler'
 import { definePerson, defineWebPage, defineWebSite, useSchemaOrg } from '@unhead/schema-org/vue'
 import { bench, describe } from 'vitest'
 import { useHead, useSeoMeta, useServerHead } from '../packages/vue/src'

bench/ssr-harlanzw-com-e2e.test.ts

@@ -1,5 +1,5 @@
 import type { Head } from 'unhead/types'
-import { InferSeoMetaPlugin } from '@unhead/addons'
+import { InferSeoMetaPlugin } from '@unhead/bundler'
 import { definePerson, defineWebPage, defineWebSite, useSchemaOrg } from '@unhead/schema-org/vue'
 import { TemplateParamsPlugin } from 'unhead/plugins'
 import { describe, it } from 'vitest'

bench/ssr-harlanzw-no-schema-e2e.bench.ts

@@ -1,5 +1,5 @@
 import type { Head } from 'unhead/types'
-import { InferSeoMetaPlugin } from '@unhead/addons'
+import { InferSeoMetaPlugin } from '@unhead/bundler'
 import { bench, describe } from 'vitest'
 import { useHead, useSeoMeta } from '../packages/vue/src'
 import { createHead as createServerHead, renderSSRHead } from '../packages/vue/src/server'

bench/vitest.config.ts

@@ -8,7 +8,7 @@ export default defineProject({
       'unhead/server': resolve(__dirname, '../packages/unhead/src/server'),
       'unhead/types': resolve(__dirname, '../packages/unhead/src/types'),
       'unhead': resolve(__dirname, '../packages/unhead/src'),
-      '@unhead/addons': resolve(__dirname, '../packages/addons/src'),
+      '@unhead/bundler': resolve(__dirname, '../packages/bundler/src'),
       '@unhead/schema-org': resolve(__dirname, '../packages/schema-org/src'),
       '@unhead/vue': resolve(__dirname, '../packages/vue/src'),
     },

docs/0.angular/schema-org/guides/get-started/0.installation.md

@@ -67,22 +67,9 @@ useSchemaOrg([
 ])
 ```
 
-## Recommended: Tree-shaking for SSR
+## Recommended: Vite Plugin
 
-If you're using Vite SSR, it's highly recommended to add the [Unhead tree-shaking plugin](/docs/head/guides/advanced/vite-plugin).
-
-This will remove the `@unhead/schema-org` dependency from your client bundle, and only include it in your server bundle.
-
-```ts [@unhead/schema-org]
-import UnheadVite from '@unhead/addons/vite'
-import { defineConfig } from 'vite'
-
-export default defineConfig({
-  plugins: [
-    UnheadVite(),
-  ]
-})
-```
+If you're using Vite, the [Vite plugin](/docs/head/guides/advanced/vite-plugin) optimizes your production bundle by tree-shaking server-only code and transforming head composables at build time. See the [Vite Plugin guide](/docs/head/guides/advanced/vite-plugin) for framework-specific setup.
 
 ## Optional: Auto-Imports
 

docs/0.react/schema-org/guides/get-started/0.installation.md

@@ -65,20 +65,16 @@ useSchemaOrg([
 ])
 ```
 
-## Recommended: Tree-shaking for SSR
+## Recommended: Vite Plugin
 
-If you're using Vite SSR, it's highly recommended to add the [Unhead tree-shaking plugin](/docs/head/guides/advanced/vite-plugin).
+If you're using Vite, the [Vite plugin](/docs/head/guides/advanced/vite-plugin) optimizes your production bundle by tree-shaking server-only code and transforming head composables at build time:
 
-This will remove the `@unhead/schema-org` dependency from your client bundle, and only include it in your server bundle.
-
-```ts [@unhead/schema-org]
-import UnheadVite from '@unhead/addons/vite'
-import { defineConfig } from 'vite'
+```ts
+import react from '@vitejs/plugin-react'
+import unhead from '@unhead/react/vite'
 
 export default defineConfig({
-  plugins: [
-    UnheadVite(),
-  ]
+  plugins: [react(), unhead()],
 })
 ```
 

docs/0.solid-js/schema-org/guides/get-started/0.installation.md

@@ -115,25 +115,19 @@ const head = createHead({
 
 See the [Schema.org Params](/docs/schema-org/guides/core-concepts/params) for all available options.
 
-## Recommended: Tree-shaking for SSR
+## Recommended: Vite Plugin
 
-If you're using Vite SSR with Solid.js, it's highly recommended to add the [Unhead tree-shaking plugin](/docs/head/guides/advanced/vite-plugin):
+If you're using Vite, the [Vite plugin](/docs/head/guides/advanced/vite-plugin) optimizes your production bundle by tree-shaking server-only code and transforming head composables at build time:
 
 ```ts [vite.config.ts]
-import UnheadVite from '@unhead/addons/vite'
-import { defineConfig } from 'vite'
-import solidPlugin from 'vite-plugin-solid'
+import solid from 'vite-plugin-solid'
+import unhead from '@unhead/solid-js/vite'
 
 export default defineConfig({
-  plugins: [
-    solidPlugin(),
-    UnheadVite(),
-  ]
+  plugins: [unhead(), solid()],
 })
 ```
 
-This will remove the `@unhead/schema-org` dependency from your client bundle, and only include it in your server bundle.
-
 ## Optional: Auto-Imports
 
 If you're using Vite with [unplugin-auto-import](https://github.com/antfu/unplugin-auto-import), you can configure automatic imports for Schema.org composables:

docs/0.svelte/schema-org/guides/get-started/0.installation.md

@@ -65,20 +65,16 @@ useSchemaOrg([
 ])
 ```
 
-## Recommended: Tree-shaking for SSR
+## Recommended: Vite Plugin
 
-If you're using Vite SSR, it's highly recommended to add the [Unhead tree-shaking plugin](/docs/head/guides/advanced/vite-plugin).
+If you're using Vite, the [Vite plugin](/docs/head/guides/advanced/vite-plugin) optimizes your production bundle by tree-shaking server-only code and transforming head composables at build time:
 
-This will remove the `@unhead/schema-org` dependency from your client bundle, and only include it in your server bundle.
-
-```ts [@unhead/schema-org]
-import UnheadVite from '@unhead/addons/vite'
-import { defineConfig } from 'vite'
+```ts
+import { svelte } from '@sveltejs/vite-plugin-svelte'
+import unhead from '@unhead/svelte/vite'
 
 export default defineConfig({
-  plugins: [
-    UnheadVite(),
-  ]
+  plugins: [unhead(), svelte()],
 })
 ```
 

docs/0.typescript/schema-org/guides/get-started/0.installation.md

@@ -65,22 +65,9 @@ useSchemaOrg([
 ])
 ```
 
-## Recommended: Tree-shaking for SSR
+## Recommended: Vite Plugin
 
-If you're using Vite SSR, it's highly recommended to add the [Unhead tree-shaking plugin](/docs/head/guides/advanced/vite-plugin).
-
-This will remove the `@unhead/schema-org` dependency from your client bundle, and only include it in your server bundle.
-
-```ts [@unhead/schema-org]
-import UnheadVite from '@unhead/addons/vite'
-import { defineConfig } from 'vite'
-
-export default defineConfig({
-  plugins: [
-    UnheadVite(),
-  ]
-})
-```
+If you're using Vite, the [Vite plugin](/docs/head/guides/advanced/vite-plugin) optimizes your production bundle by tree-shaking server-only code and transforming head composables at build time. See the [Vite Plugin guide](/docs/head/guides/advanced/vite-plugin) for framework-specific setup.
 
 ## Optional: Auto-Imports
 

docs/0.vue/schema-org/guides/0.get-started/0.installation.md

@@ -69,20 +69,16 @@ useSchemaOrg([
 ])
 ```
 
-## Recommended: Tree-shaking for SSR
+## Recommended: Vite Plugin
 
-If you're using Vite SSR, it's highly recommended to add the [Unhead tree-shaking plugin](/docs/head/guides/advanced/vite-plugin).
+If you're using Vite, the [Vite plugin](/docs/head/guides/advanced/vite-plugin) optimizes your production bundle by tree-shaking server-only code and transforming head composables at build time:
 
-This will remove the `@unhead/schema-org` dependency from your client bundle, and only include it in your server bundle.
-
-```ts [@unhead/schema-org]
-import UnheadVite from '@unhead/addons/vite'
-import { defineConfig } from 'vite'
+```ts
+import vue from '@vitejs/plugin-vue'
+import unhead from '@unhead/vue/vite'
 
 export default defineConfig({
-  plugins: [
-    UnheadVite(),
-  ]
+  plugins: [vue(), unhead()],
 })
 ```