@unhead/bundler 3.0.5 → 3.1.1

package/dist/devtools-ui/_nuxt/uY6k474J.js

@@ -0,0 +1 @@
+import{as as $,G as y,aa as t,u as x,o as B,ap as r,aR as D,C as d,l as S,a5 as _,x as n,ag as w,t as f,aj as u,v as k,i as b,b as V,af as j,B as v,k as N,a7 as O}from"./DsxXb4gA.js";import{_ as z}from"./ChL3K-7X.js";function I(o=2e3){const{copy:l,copied:s}=$({legacy:!0,copiedDuring:o});return{copy:l,copied:s}}const R=y({__name:"DevtoolsCopyButton",props:{text:{}},setup(o){const{copy:l,copied:s}=I();return(p,c)=>{const a=S,g=B;return t(),x(g,{text:r(s)?"Copied!":"Copy"},{default:D(()=>[d(a,{icon:r(s)?"i-carbon-checkmark":"i-carbon-copy","aria-label":r(s)?"Copied":"Copy to clipboard",size:"xs",variant:"ghost",color:"neutral",class:_(r(s)?"text-green-500":""),onClick:c[0]||(c[0]=i=>r(l)(o.text))},null,8,["icon","aria-label","class"])]),_:1},8,["text"])}}}),h=Object.assign(R,{__name:"DevtoolsCopyButton"}),U={class:"devtools-snippet"},K={key:0,class:"devtools-snippet-header"},L={class:"text-xs font-mono text-muted"},T=y({__name:"DevtoolsSnippet",props:{label:{},code:{},lang:{default:"json"}},setup(o){return(l,s)=>{const p=h,c=z;return t(),n("div",U,[o.label||l.$slots.header?(t(),n("div",K,[w(l.$slots,"header",{},()=>[f("code",L,u(o.label),1)],!0),d(p,{text:o.code},null,8,["text"])])):k("",!0),d(c,{code:o.code,lang:o.lang,class:"devtools-snippet-block"},null,8,["code","lang"])])}}}),A=Object.assign(b(T,[["__scopeId","data-v-1994adf5"]]),{__name:"DevtoolsSnippet"}),E={class:"divide-y divide-[var(--ui-border)]"},F={class:"devtools-kv-key"},G=["href"],q=["href"],H=y({__name:"DevtoolsKeyValue",props:{items:{},striped:{type:Boolean,default:!1}},setup(o){const l=/^https?:\/\/\S+$/,s=/^#(?:[0-9a-f]{3,4}){1,2}$|^rgba?\([\d\s,./]+\)$|^hsla?\([\d\s%,./]+\)$/i;function p(a){return!a.link&&!a.code&&typeof a.value=="string"&&l.test(a.value)}function c(a){return typeof a.value=="string"&&s.test(a.value.trim())}return(a,g)=>{const i=N,m=A,C=h;return t(),n("div",E,[(t(!0),n(V,null,j(o.items,e=>(t(),n("div",{key:e.key,class:_(["devtools-kv-row group",{"devtools-kv-striped":o.striped,"devtools-kv-stacked":!!e.code}])},[f("span",F,u(e.key),1),f("div",{class:_(["devtools-kv-value-wrap",{"w-full":!!e.code}])},[e.link?(t(),n("a",{key:0,href:e.link,target:"_blank",rel:"noopener noreferrer",class:"text-xs text-muted hover:text-default flex items-center gap-1"},[v(u(e.value)+" ",1),d(i,{name:"i-carbon-launch",class:"text-xs"})],8,G)):e.code&&e.value!==void 0&&e.value!==""?(t(),x(m,{key:1,code:String(e.value),lang:e.code,class:"w-full"},null,8,["code","lang"])):p(e)?(t(),n("a",{key:2,href:String(e.value),target:"_blank",rel:"noopener noreferrer",class:"text-xs text-muted hover:text-default flex items-center gap-1"},[v(u(e.value)+" ",1),d(i,{name:"i-carbon-launch",class:"text-xs"})],8,q)):(t(),n("span",{key:3,class:_(["devtools-kv-value flex items-center gap-1.5",{"font-mono":e.mono!==!1,"text-green-500":e.value===!0,"text-red-400":e.value===!1,"text-muted italic":e.value===void 0||e.value===""}])},[c(e)?(t(),n("span",{key:0,class:"inline-block w-3 h-3 rounded-sm shrink-0 border border-[var(--ui-border)]",style:O({background:String(e.value).trim()})},null,4)):k("",!0),v(" "+u(e.value===void 0||e.value===""?"(empty)":e.value),1)],2)),!e.code&&e.copyable&&e.value!==void 0&&e.value!==""?(t(),x(C,{key:4,text:String(e.value),class:"opacity-0 group-hover:opacity-100 transition-opacity"},null,8,["text"])):k("",!0)],2)],2))),128))])}}}),P=Object.assign(b(H,[["__scopeId","data-v-983967b4"]]),{__name:"DevtoolsKeyValue"});export{A as _,P as a};

package/dist/devtools-ui/_nuxt/xSwJ5b7x.js

@@ -0,0 +1 @@
+import{_ as I}from"./GDfpgsTy.js";import{_ as M,i as y,d as i,g as p,f as T,a as C,n as D,h as U,c as G,j as H}from"./DAKdquko.js";import{G as q,aH as J,aa as a,x as r,t as o,a5 as k,u as f,k as L,v as g,ag as N,B as c,aj as m,a2 as E,i as F,ap as e,aR as h,b as R,af as B,C as x,n as K,s as w,ai as Q}from"./DsxXb4gA.js";import{_ as W}from"./ChL3K-7X.js";import{_ as X}from"./2R9QS7Fj.js";const Y=["open"],Z={class:"flex-1 min-w-0"},ee={class:"text-sm font-semibold"},te={key:0,class:"text-xs text-muted mt-0.5"},se=q({__name:"DevtoolsSection",props:E({icon:{},text:{},description:{},collapse:{type:Boolean,default:!0},padding:{type:Boolean,default:!0}},{open:{default:!0},openModifiers:{}}),emits:["update:open"],setup(d){const v=J(d,"open");function b(u){v.value=u.target.open}return(u,S)=>{const n=L;return a(),r("details",{open:v.value,class:"section-block",onToggle:b},[o("summary",{class:k(["section-header",d.collapse?"":"pointer-events-none"])},[o("div",{class:k(["section-title",v.value?"":"opacity-60"])},[d.icon?(a(),f(n,{key:0,name:d.icon,class:"text-lg text-muted shrink-0"},null,8,["name"])):g("",!0),o("div",Z,[o("div",ee,[N(u.$slots,"text",{},()=>[c(m(d.text),1)],!0)]),d.description||u.$slots.description?(a(),r("div",te,[N(u.$slots,"description",{},()=>[c(m(d.description),1)],!0)])):g("",!0)]),N(u.$slots,"actions",{},void 0,!0),d.collapse?(a(),f(n,{key:1,name:"i-carbon-chevron-down",class:"section-chevron text-muted"})):g("",!0)],2)],2),o("div",{class:k(d.padding?"p-3":"")},[N(u.$slots,"default",{},void 0,!0)],2)],40,Y)}}}),ae=Object.assign(F(se,[["__scopeId","data-v-4f7a0867"]]),{__name:"DevtoolsSection"}),oe={class:"space-y-4"},ne={class:"font-medium"},re={class:"flex items-center gap-2"},le={class:"font-medium text-sm"},ie={class:"text-xs text-muted mt-1 truncate"},ce={key:0,class:"space-y-4"},de={key:0},me={class:"space-y-0.5"},ue={class:"text-sm font-mono"},pe={key:0,class:"text-xs text-muted font-mono ml-auto truncate max-w-[200px]"},xe={class:"space-y-0.5 p-2"},fe={class:"text-sm font-mono"},ge={key:0,class:"text-xs text-muted font-mono ml-auto truncate max-w-[200px]"},_e={class:"flex gap-3 pt-2 border-t border-default"},he=["href"],ve=["href"],ye={class:"flex gap-3 justify-center pt-2"},ke={href:"https://validator.schema.org/",target:"_blank",rel:"noopener noreferrer",class:"text-xs text-muted hover:text-default flex items-center gap-1"},be={href:"https://search.google.com/test/rich-results",target:"_blank",rel:"noopener noreferrer",class:"text-xs text-muted hover:text-default flex items-center gap-1"},je=q({__name:"schema",setup(d){const v=w(()=>{const n=Q.value.tags.filter(t=>t.tag==="script"&&t.props?.type==="application/ld+json");if(!n.length)return null;for(const t of n)try{return JSON.parse(t.innerHTML||"{}")}catch{continue}return null}),b=w(()=>{const n=v.value;return n?n["@graph"]&&Array.isArray(n["@graph"])?n["@graph"].filter(t=>!t||typeof t!="object"||Object.keys(t).length===1&&t["@id"]?!1:!!t["@type"]):n["@type"]?[n]:[]:[]}),u=w(()=>b.value.filter(n=>H(i(n)))),S=w(()=>{let n=0,t=0;for(const j of u.value){const $=C(j);n+=$.missingRequired.length,t+=$.missingRecommended.length}return{errors:n,warnings:t}});return(n,t)=>{const j=I,$=M,_=L,O=K,V=ae,P=W,z=X;return a(),r("div",oe,[e(v)?(a(),r(R,{key:1},[e(S).errors>0?(a(),f($,{key:0,variant:"error"},{default:h(()=>[o("p",ne,m(e(S).errors)+" missing required propert"+m(e(S).errors>1?"ies":"y"),1)]),_:1})):g("",!0),(a(!0),r(R,null,B(e(b),(s,A)=>(a(),f(z,{key:A},{header:h(()=>[o("div",re,[x(_,{name:e(U)(e(i)(s)),class:"text-lg"},null,8,["name"]),o("span",le,m(e(i)(s)),1)]),o("p",ie,m(e(G)(s)),1)]),default:h(()=>[e(y)[e(i)(s)]?(a(),r("div",ce,[e(y)[e(i)(s)]?.required.length?(a(),r("div",de,[t[2]||(t[2]=o("div",{class:"text-xs font-semibold uppercase tracking-wider text-muted mb-2"}," Required ",-1)),o("div",me,[(a(!0),r(R,null,B(e(y)[e(i)(s)].required,l=>(a(),r("div",{key:l,class:"flex items-center gap-2 px-2 py-1.5 rounded-md"},[x(_,{name:e(p)(s,l)!==void 0?"i-carbon-checkmark-filled":"i-carbon-close-filled",class:k(["text-sm shrink-0",e(p)(s,l)!==void 0?"text-green-500":"text-red-400"])},null,8,["name","class"]),o("span",ue,m(l),1),e(p)(s,l)!==void 0?(a(),r("span",pe,m(e(T)(e(p)(s,l))),1)):(a(),f(O,{key:1,color:"error",variant:"subtle",size:"xs",class:"ml-auto"},{default:h(()=>[...t[1]||(t[1]=[c(" missing ",-1)])]),_:1}))]))),128))])])):g("",!0),e(y)[e(i)(s)]?.recommended.length?(a(),f(V,{key:1,open:!1,icon:"i-carbon-warning-filled",text:`Recommended (${e(C)(s).missingRecommended.length} missing)`,padding:!1},{default:h(()=>[o("div",xe,[(a(!0),r(R,null,B(e(y)[e(i)(s)].recommended,l=>(a(),r("div",{key:l,class:"flex items-center gap-2 px-2 py-1.5 rounded-md"},[x(_,{name:e(p)(s,l)!==void 0?"i-carbon-checkmark-filled":"i-carbon-warning-filled",class:k(["text-sm shrink-0",e(p)(s,l)!==void 0?"text-green-500":"text-amber-400"])},null,8,["name","class"]),o("span",fe,m(l),1),e(p)(s,l)!==void 0?(a(),r("span",ge,m(e(T)(e(p)(s,l))),1)):(a(),f(O,{key:1,color:"warning",variant:"subtle",size:"xs",class:"ml-auto"},{default:h(()=>[...t[3]||(t[3]=[c(" missing ",-1)])]),_:1}))]))),128))])]),_:2},1032,["text"])):g("",!0),o("div",_e,[o("a",{href:e(D)(e(i)(s)).schemaOrg,target:"_blank",rel:"noopener noreferrer",class:"text-xs text-muted hover:text-default flex items-center gap-1"},[x(_,{name:"i-carbon-launch",class:"text-xs"}),t[4]||(t[4]=c(" Schema.org ",-1))],8,he),e(D)(e(i)(s)).googlePage?(a(),r("a",{key:0,href:e(D)(e(i)(s)).googlePage,target:"_blank",rel:"noopener noreferrer",class:"text-xs text-muted hover:text-default flex items-center gap-1"},[x(_,{name:"i-carbon-launch",class:"text-xs"}),t[5]||(t[5]=c(" Google Docs ",-1))],8,ve)):g("",!0)])])):g("",!0),o("div",{class:k(["max-h-[400px] overflow-auto",{"mt-4 pt-4 border-t border-default":e(y)[e(i)(s)]}])},[x(P,{code:JSON.stringify(s,null,2),lang:"json"},null,8,["code"])],2)]),_:2},1024))),128)),o("div",ye,[o("a",ke,[x(_,{name:"i-carbon-launch",class:"text-xs"}),t[6]||(t[6]=c(" Schema.org Validator ",-1))]),o("a",be,[x(_,{name:"i-carbon-launch",class:"text-xs"}),t[7]||(t[7]=c(" Google Rich Results Test ",-1))])])],64)):(a(),f(j,{key:0,icon:"i-carbon-chart-relationship",title:"No structured data detected"},{description:h(()=>[...t[0]||(t[0]=[c(" Add JSON-LD structured data via ",-1),o("code",{class:"bg-elevated px-1.5 py-0.5 rounded text-xs"},"useSchemaOrg()",-1),c(" or ",-1),o("code",{class:"bg-elevated px-1.5 py-0.5 rounded text-xs"},"useHead()",-1),c(" with a script tag. ",-1)])]),_:1}))])}}});export{je as default};

package/dist/devtools-ui/index.html

@@ -1 +1 @@
-<!DOCTYPE html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><link rel="stylesheet" href="/__unhead/_nuxt/entry.clcQIxBm.css" crossorigin><link rel="modulepreload" as="script" crossorigin href="/__unhead/_nuxt/DVtdvxJ7.js"><script type="module" src="/__unhead/_nuxt/DVtdvxJ7.js" crossorigin></script><script>"use strict";(()=>{const t=window,e=document.documentElement,c=["dark","light"],n=getStorageValue("localStorage","nuxt-color-mode")||"system";let i=n==="system"?u():n;const r=e.getAttribute("data-color-mode-forced");r&&(i=r),l(i),t["__NUXT_COLOR_MODE__"]={preference:n,value:i,getColorScheme:u,addColorScheme:l,removeColorScheme:d};function l(o){const s=""+o+"",a="";e.classList?e.classList.add(s):e.className+=" "+s,a&&e.setAttribute("data-"+a,o)}function d(o){const s=""+o+"",a="";e.classList?e.classList.remove(s):e.className=e.className.replace(new RegExp(s,"g"),""),a&&e.removeAttribute("data-"+a)}function f(o){return t.matchMedia("(prefers-color-scheme"+o+")")}function u(){if(t.matchMedia&&f("").media!=="not all"){for(const o of c)if(f(":"+o).matches)return o}return"light"}})();function getStorageValue(t,e){switch(t){case"localStorage":return window.localStorage.getItem(e);case"sessionStorage":return window.sessionStorage.getItem(e);case"cookie":return getCookie(e);default:return null}}function getCookie(t){const c=("; "+window.document.cookie).split("; "+t+"=");if(c.length===2)return c.pop()?.split(";").shift()}</script></head><body><div id="__nuxt" class="isolate"></div><div id="teleports"></div><script>window.__NUXT__={};window.__NUXT__.config={public:{},app:{baseURL:"/__unhead/",buildId:"35b427b0-d95c-4e8c-ba8f-41688b3cc0a3",buildAssetsDir:"/_nuxt/",cdnURL:""}}</script><script type="application/json" data-nuxt-data="nuxt-app" data-ssr="false" id="__NUXT_DATA__">[{"prerenderedAt":1,"serverRendered":2},1776871536684,false]</script></body></html>
+<!DOCTYPE html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><link rel="stylesheet" href="/__unhead/_nuxt/entry.BIq0UsGv.css" crossorigin><link rel="modulepreload" as="script" crossorigin href="/__unhead/_nuxt/DsxXb4gA.js"><script type="module" src="/__unhead/_nuxt/DsxXb4gA.js" crossorigin></script><script>"use strict";(()=>{const t=window,e=document.documentElement,c=["dark","light"],n=getStorageValue("localStorage","nuxt-color-mode")||"system";let i=n==="system"?u():n;const r=e.getAttribute("data-color-mode-forced");r&&(i=r),l(i),t["__NUXT_COLOR_MODE__"]={preference:n,value:i,getColorScheme:u,addColorScheme:l,removeColorScheme:d};function l(o){const s=""+o+"",a="";e.classList?e.classList.add(s):e.className+=" "+s,a&&e.setAttribute("data-"+a,o)}function d(o){const s=""+o+"",a="";e.classList?e.classList.remove(s):e.className=e.className.replace(new RegExp(s,"g"),""),a&&e.removeAttribute("data-"+a)}function f(o){return t.matchMedia("(prefers-color-scheme"+o+")")}function u(){if(t.matchMedia&&f("").media!=="not all"){for(const o of c)if(f(":"+o).matches)return o}return"light"}})();function getStorageValue(t,e){switch(t){case"localStorage":return window.localStorage.getItem(e);case"sessionStorage":return window.sessionStorage.getItem(e);case"cookie":return getCookie(e);default:return null}}function getCookie(t){const c=("; "+window.document.cookie).split("; "+t+"=");if(c.length===2)return c.pop()?.split(";").shift()}</script></head><body><div id="__nuxt" class="isolate"></div><div id="teleports"></div><script>window.__NUXT__={};window.__NUXT__.config={public:{},app:{baseURL:"/__unhead/",buildId:"131284c6-b351-4ba5-8ac9-6320fa409f91",buildAssetsDir:"/_nuxt/",cdnURL:""}}</script><script type="application/json" data-nuxt-data="nuxt-app" data-ssr="false" id="__NUXT_DATA__">[{"prerenderedAt":1,"serverRendered":2},1779859459057,false]</script></body></html>

package/dist/framework.d.mts

@@ -0,0 +1,72 @@
+import { UnpluginInstance } from 'unplugin';
+import { Plugin } from 'vite';
+import { V as VitePluginOptions } from './shared/bundler.LjD9SWtb.mjs';
+
+/**
+ * Per-framework factory config. `framework` is the package name (e.g.
+ * `@unhead/vue`) used internally by the base bundler to import runtime
+ * plugins from the right path; `streamingPlugin` is the framework's
+ * streaming unplugin instance (as returned by `createUnplugin`).
+ */
+interface FrameworkPluginConfig<S> {
+    framework: string;
+    streamingPlugin: UnpluginInstance<S | undefined, boolean>;
+}
+interface UnheadFrameworkOptions<S> extends VitePluginOptions {
+    /** Enable streaming SSR support. */
+    streaming?: true | S | false;
+    /**
+     * Inject the runtime `ValidatePlugin`. **Vite-only**: ignored by `.webpack()`,
+     * `.rspack()`, and `.rollup()` because injection happens via the Vite
+     * `CreateHeadTransform` plugin, which has no equivalent on other bundlers.
+     */
+    validate?: VitePluginOptions['validate'];
+    /**
+     * Enable the Vite Devtools integration. **Vite-only**: ignored by `.webpack()`,
+     * `.rspack()`, and `.rollup()` since `unheadDevtools` depends on
+     * `@vitejs/devtools-kit`.
+     */
+    devtools?: VitePluginOptions['devtools'];
+}
+/**
+ * Shape returned by the unified framework factory. Mirrors the subset of
+ * `UnpluginInstance` methods that Nuxt's `addBuildPlugin` consumes, so a
+ * call site can forward the factory object directly.
+ *
+ * Note: `rollup()` is provided for completeness (e.g. SSG static builds)
+ * but does **not** detect SSR context. `SSRStaticReplace` always sees
+ * `ssr=false` here because rollup has no equivalent of vite's
+ * `env.isSsrBuild` or webpack's `compiler.options.name === 'server'` hook;
+ * `head.ssr` references will always be statically rewritten to `false`.
+ * Use `.vite()` or `.webpack()` for SSR builds.
+ */
+interface UnheadBundlerFactory {
+    vite: () => Plugin[];
+    webpack: () => any[];
+    rspack: () => any[];
+    rollup: () => any[];
+}
+/**
+ * Unified framework factory. Returns an object with per-bundler dispatch
+ * methods so consumers (e.g. Nuxt's `addBuildPlugin`) can forward it
+ * directly without per-bundler imports.
+ *
+ * @example
+ * ```ts
+ * // framework-side:
+ * export const Unhead = createFrameworkPlugin({
+ *   framework: '@unhead/vue',
+ *   streamingPlugin: unheadVueStreamingPlugin,
+ * })
+ *
+ * // consumer-side (vite):
+ * plugins: [...Unhead({ streaming: true }).vite()]
+ *
+ * // consumer-side (nuxt kit):
+ * addBuildPlugin(Unhead({ streaming: true }))
+ * ```
+ */
+declare function createFrameworkPlugin<S>({ framework, streamingPlugin }: FrameworkPluginConfig<S>): (options?: UnheadFrameworkOptions<S>) => UnheadBundlerFactory;
+
+export { createFrameworkPlugin };
+export type { FrameworkPluginConfig, UnheadBundlerFactory, UnheadFrameworkOptions };

package/dist/framework.d.ts

@@ -0,0 +1,72 @@
+import { UnpluginInstance } from 'unplugin';
+import { Plugin } from 'vite';
+import { V as VitePluginOptions } from './shared/bundler.LjD9SWtb.js';
+
+/**
+ * Per-framework factory config. `framework` is the package name (e.g.
+ * `@unhead/vue`) used internally by the base bundler to import runtime
+ * plugins from the right path; `streamingPlugin` is the framework's
+ * streaming unplugin instance (as returned by `createUnplugin`).
+ */
+interface FrameworkPluginConfig<S> {
+    framework: string;
+    streamingPlugin: UnpluginInstance<S | undefined, boolean>;
+}
+interface UnheadFrameworkOptions<S> extends VitePluginOptions {
+    /** Enable streaming SSR support. */
+    streaming?: true | S | false;
+    /**
+     * Inject the runtime `ValidatePlugin`. **Vite-only**: ignored by `.webpack()`,
+     * `.rspack()`, and `.rollup()` because injection happens via the Vite
+     * `CreateHeadTransform` plugin, which has no equivalent on other bundlers.
+     */
+    validate?: VitePluginOptions['validate'];
+    /**
+     * Enable the Vite Devtools integration. **Vite-only**: ignored by `.webpack()`,
+     * `.rspack()`, and `.rollup()` since `unheadDevtools` depends on
+     * `@vitejs/devtools-kit`.
+     */
+    devtools?: VitePluginOptions['devtools'];
+}
+/**
+ * Shape returned by the unified framework factory. Mirrors the subset of
+ * `UnpluginInstance` methods that Nuxt's `addBuildPlugin` consumes, so a
+ * call site can forward the factory object directly.
+ *
+ * Note: `rollup()` is provided for completeness (e.g. SSG static builds)
+ * but does **not** detect SSR context. `SSRStaticReplace` always sees
+ * `ssr=false` here because rollup has no equivalent of vite's
+ * `env.isSsrBuild` or webpack's `compiler.options.name === 'server'` hook;
+ * `head.ssr` references will always be statically rewritten to `false`.
+ * Use `.vite()` or `.webpack()` for SSR builds.
+ */
+interface UnheadBundlerFactory {
+    vite: () => Plugin[];
+    webpack: () => any[];
+    rspack: () => any[];
+    rollup: () => any[];
+}
+/**
+ * Unified framework factory. Returns an object with per-bundler dispatch
+ * methods so consumers (e.g. Nuxt's `addBuildPlugin`) can forward it
+ * directly without per-bundler imports.
+ *
+ * @example
+ * ```ts
+ * // framework-side:
+ * export const Unhead = createFrameworkPlugin({
+ *   framework: '@unhead/vue',
+ *   streamingPlugin: unheadVueStreamingPlugin,
+ * })
+ *
+ * // consumer-side (vite):
+ * plugins: [...Unhead({ streaming: true }).vite()]
+ *
+ * // consumer-side (nuxt kit):
+ * addBuildPlugin(Unhead({ streaming: true }))
+ * ```
+ */
+declare function createFrameworkPlugin<S>({ framework, streamingPlugin }: FrameworkPluginConfig<S>): (options?: UnheadFrameworkOptions<S>) => UnheadBundlerFactory;
+
+export { createFrameworkPlugin };
+export type { FrameworkPluginConfig, UnheadBundlerFactory, UnheadFrameworkOptions };

package/dist/framework.mjs

@@ -0,0 +1,102 @@
+import { S as SSRStaticReplace, u as unheadDevtools, C as CreateHeadTransform, T as TreeshakeServerComposables, U as UseSeoMetaTransform, M as MinifyTransform, c as createHeadTransformContext } from './shared/bundler.D9eYJXZg.mjs';
+import 'node:fs';
+import 'node:path';
+import 'node:url';
+import 'magic-string';
+import 'oxc-walker';
+import '@vitejs/devtools-kit';
+import 'oxc-parser';
+import 'ufo';
+import 'unplugin';
+import 'node:vm';
+import 'unhead/utils';
+
+function resolveCoreDefs(options) {
+  const defs = [];
+  const common = { filter: options.filter, sourcemap: options.sourcemap };
+  if (options.treeshake !== false) {
+    const treeshakeOpts = typeof options.treeshake === "object" ? options.treeshake : {};
+    defs.push({ instance: TreeshakeServerComposables, options: { ...common, ...treeshakeOpts } });
+  }
+  if (options.transformSeoMeta !== false) {
+    const seoMetaOpts = typeof options.transformSeoMeta === "object" ? options.transformSeoMeta : {};
+    defs.push({ instance: UseSeoMetaTransform, options: { ...common, ...seoMetaOpts } });
+  }
+  if (options.minify !== false) {
+    const minifyOpts = typeof options.minify === "object" ? options.minify : options.minify === true ? { js: true, css: true } : {};
+    if (minifyOpts.js || minifyOpts.css) {
+      defs.push({ instance: MinifyTransform, options: { ...common, ...minifyOpts } });
+    }
+  }
+  return defs;
+}
+function dispatch(bundler, defs) {
+  const out = [];
+  for (const { instance, options } of defs) {
+    const plugin = instance[bundler](options);
+    if (Array.isArray(plugin))
+      out.push(...plugin);
+    else out.push(plugin);
+  }
+  return out;
+}
+function resolveStreamingOpts(streaming) {
+  return streaming && typeof streaming === "object" ? streaming : void 0;
+}
+function pushPlugin(out, value) {
+  if (Array.isArray(value))
+    out.push(...value);
+  else out.push(value);
+}
+function createFrameworkPlugin({ framework, streamingPlugin }) {
+  return (options = {}) => {
+    const { streaming, validate, devtools, ...coreOpts } = options;
+    const defs = resolveCoreDefs(coreOpts);
+    const streamOpts = resolveStreamingOpts(streaming);
+    const wantStreaming = !!streaming;
+    return {
+      vite: () => {
+        const plugins = dispatch("vite", defs);
+        const ctx = createHeadTransformContext();
+        if (validate !== false) {
+          ctx.addRuntimePlugin({
+            import: { name: "ValidatePlugin", source: `${framework}/plugins`, as: "__unhead_validate" },
+            client: "_h.use(__unhead_validate({ root: __ROOT__ }))"
+          });
+        }
+        if (devtools !== false) {
+          const devtoolsOpts = typeof devtools === "object" ? devtools : {};
+          plugins.push(unheadDevtools({ ...devtoolsOpts, _ctx: ctx }));
+        }
+        plugins.push(SSRStaticReplace.vite({}));
+        plugins.push(CreateHeadTransform(ctx));
+        if (wantStreaming)
+          pushPlugin(plugins, streamingPlugin.vite(streamOpts));
+        return plugins;
+      },
+      webpack: () => {
+        const plugins = dispatch("webpack", defs);
+        plugins.push(SSRStaticReplace.webpack({}));
+        if (wantStreaming)
+          pushPlugin(plugins, streamingPlugin.webpack(streamOpts));
+        return plugins;
+      },
+      rspack: () => {
+        const plugins = dispatch("rspack", defs);
+        plugins.push(SSRStaticReplace.rspack({}));
+        if (wantStreaming)
+          pushPlugin(plugins, streamingPlugin.rspack(streamOpts));
+        return plugins;
+      },
+      rollup: () => {
+        const plugins = dispatch("rollup", defs);
+        plugins.push(SSRStaticReplace.rollup({}));
+        if (wantStreaming)
+          pushPlugin(plugins, streamingPlugin.rollup(streamOpts));
+        return plugins;
+      }
+    };
+  };
+}
+
+export { createFrameworkPlugin };

package/dist/minify/esbuild.d.mts

@@ -1,4 +1,4 @@
-import { M as MinifyFn } from '../shared/bundler.BwKIGaKX.mjs';
+import { M as MinifyFn } from '../shared/bundler.LjD9SWtb.mjs';
 
 declare function createJSMinifier(): MinifyFn;
 

package/dist/minify/esbuild.d.ts

@@ -1,4 +1,4 @@
-import { M as MinifyFn } from '../shared/bundler.BwKIGaKX.js';
+import { M as MinifyFn } from '../shared/bundler.LjD9SWtb.js';
 
 declare function createJSMinifier(): MinifyFn;
 

package/dist/minify/lightningcss.d.mts

@@ -1,4 +1,4 @@
-import { M as MinifyFn } from '../shared/bundler.BwKIGaKX.mjs';
+import { M as MinifyFn } from '../shared/bundler.LjD9SWtb.mjs';
 
 declare function createCSSMinifier(): MinifyFn;
 

package/dist/minify/lightningcss.d.ts

@@ -1,4 +1,4 @@
-import { M as MinifyFn } from '../shared/bundler.BwKIGaKX.js';
+import { M as MinifyFn } from '../shared/bundler.LjD9SWtb.js';
 
 declare function createCSSMinifier(): MinifyFn;
 

package/dist/minify/rolldown.d.mts

@@ -1,4 +1,4 @@
-import { M as MinifyFn } from '../shared/bundler.BwKIGaKX.mjs';
+import { M as MinifyFn } from '../shared/bundler.LjD9SWtb.mjs';
 
 declare function createJSMinifier(): MinifyFn;
 

package/dist/minify/rolldown.d.ts

@@ -1,4 +1,4 @@
-import { M as MinifyFn } from '../shared/bundler.BwKIGaKX.js';
+import { M as MinifyFn } from '../shared/bundler.LjD9SWtb.js';
 
 declare function createJSMinifier(): MinifyFn;
 

package/dist/shared/{bundler.CXyDmCqn.mjs → bundler.D9eYJXZg.mjs}

@@ -1,12 +1,321 @@
-import { pathToFileURL } from 'node:url';
+import { existsSync, readFileSync } from 'node:fs';
+import { relative, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import MagicString from 'magic-string';
+import { parseAndWalk, ScopeTracker, walk, ScopeTrackerImport } from 'oxc-walker';
+import { defineRpcFunction } from '@vitejs/devtools-kit';
 import { parseSync } from 'oxc-parser';
-import { ScopeTracker, walk, ScopeTrackerImport } from 'oxc-walker';
 import { parseURL, parseQuery } from 'ufo';
 import { createUnplugin } from 'unplugin';
 import { createContext, runInContext } from 'node:vm';
 import { resolveMetaKeyType, resolveMetaKeyValue, resolvePackedMetaObjectValue } from 'unhead/utils';
 
+const getConfigRpc = defineRpcFunction({
+  name: "unhead:get-config",
+  type: "static",
+  setup: (ctx) => ({
+    handler: () => ({
+      cwd: ctx.cwd,
+      mode: ctx.mode
+    })
+  })
+});
+
+async function tryRequire() {
+  try {
+    const mod = await import('@unhead/cli');
+    return { runLint: mod.runLint };
+  } catch {
+    return null;
+  }
+}
+const runLintRpc = defineRpcFunction({
+  name: "unhead:run-lint",
+  type: "static",
+  setup: (ctx) => ({
+    handler: async (args = {}) => {
+      const lib = await tryRequire();
+      if (!lib) {
+        return {
+          available: false,
+          message: "Install @unhead/cli (and eslint as a peer) to enable in-devtools auditing."
+        };
+      }
+      const start = Date.now();
+      const mode = args.mode === "migrate" ? "migrate" : "audit";
+      const cwd = ctx.cwd;
+      const { results, errorCount, warningCount, fixableErrorCount, fixableWarningCount } = await lib.runLint({
+        patterns: ["**/*.{js,mjs,cjs,ts,mts,cts,jsx,tsx,vue,svelte}"],
+        mode,
+        cwd,
+        ignore: ["**/node_modules/**", "**/dist/**", "**/.output/**", "**/.nuxt/**"]
+      });
+      const files = results.map((r) => ({
+        filePath: r.filePath,
+        relativePath: relative(cwd, r.filePath),
+        errorCount: r.errorCount,
+        warningCount: r.warningCount,
+        fixableErrorCount: r.fixableErrorCount,
+        fixableWarningCount: r.fixableWarningCount,
+        fixed: typeof r.output === "string",
+        messages: (r.messages || []).map((m) => ({
+          ruleId: m.ruleId ?? null,
+          message: m.message,
+          severity: m.severity === 2 ? "error" : "warn",
+          line: m.line,
+          column: m.column,
+          endLine: m.endLine,
+          endColumn: m.endColumn,
+          // Only `fix` is auto-applied by `--fix`; suggestions are editor-only.
+          fixable: Boolean(m.fix)
+        }))
+      })).filter((f) => f.errorCount > 0 || f.warningCount > 0 || f.fixed);
+      const filesFixed = files.filter((f) => f.fixed).length;
+      return {
+        available: true,
+        mode,
+        files,
+        errorCount,
+        warningCount,
+        fixableErrorCount,
+        fixableWarningCount,
+        filesFixed,
+        durationMs: Date.now() - start
+      };
+    }
+  })
+});
+
+const HEAD_COMPOSABLES = ["useHead", "useSeoMeta", "useHeadSafe", "useScript"];
+const FILE_RE$1 = /\.(vue|tsx?|jsx?|svelte)$/;
+const LEADING_SLASH_RE = /^\//;
+const UNHEAD_VERSION_RE = /__UNHEAD_VERSION__ = ['"]'?["']/;
+const UNHEAD_ICON = `data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='32' height='32' viewBox='0 0 24 24'%3E%3Cdefs%3E%3ClinearGradient id='g' x1='0%25' y1='0%25' x2='100%25' y2='100%25'%3E%3Cstop offset='0%25' stop-color='%23FBBF24'/%3E%3Cstop offset='100%25' stop-color='%23f0db4f'/%3E%3C/linearGradient%3E%3Cmask id='m'%3E%3Crect width='100%25' height='100%25' fill='white'/%3E%3Cpath d='M12 32 L1 32 L15 15 Z' fill='black'/%3E%3C/mask%3E%3C/defs%3E%3Cpath fill='none' stroke='url(%23g)' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='M6 4v14a2 2 0 0 0 2 2h8a2 2 0 0 0 2-2V4' mask='url(%23m)'/%3E%3C/svg%3E`;
+const DEVTOOLS_UI_ROUTE = "/__unhead/";
+function transformSourceLocations(code, id, root) {
+  if (!HEAD_COMPOSABLES.some((c) => code.includes(c)))
+    return;
+  const s = new MagicString(code);
+  let transformed = false;
+  const relativePath = id.startsWith(root) ? id.slice(root.length).replace(LEADING_SLASH_RE, "") : id;
+  parseAndWalk(code, id, {
+    parseOptions: { lang: "ts" },
+    enter(node) {
+      if (node.type !== "CallExpression")
+        return;
+      const callee = node.callee;
+      if (!callee)
+        return;
+      const name = callee.type === "Identifier" ? callee.name : callee.type === "MemberExpression" && callee.property?.type === "Identifier" ? callee.property.name : null;
+      if (!name || !HEAD_COMPOSABLES.includes(name))
+        return;
+      const args = node.arguments;
+      if (!args || args.length === 0)
+        return;
+      const lineNumber = code.slice(0, node.start).split("\n").length;
+      const sourceValue = `${relativePath}:${lineNumber}`;
+      if (args.length === 1) {
+        const argEnd = args[0].end;
+        s.appendRight(argEnd, `, { _source: ${JSON.stringify(sourceValue)} }`);
+        transformed = true;
+      } else if (args.length >= 2 && args[1].type === "ObjectExpression") {
+        const objStart = args[1].start + 1;
+        s.appendRight(objStart, ` _source: ${JSON.stringify(sourceValue)},`);
+        transformed = true;
+      }
+    }
+  });
+  if (!transformed)
+    return;
+  return {
+    code: s.toString(),
+    map: s.generateMap({ includeContent: true, source: id })
+  };
+}
+function unheadDevtools(options) {
+  let root = "";
+  let enabled = false;
+  let bridgeCode;
+  let unheadVersion = "";
+  const pkgDir = fileURLToPath(new URL("..", import.meta.url));
+  const devtoolsUiDir = fileURLToPath(new URL("./devtools-ui", import.meta.url));
+  return {
+    name: "@unhead/devtools",
+    apply: "serve",
+    configResolved(config) {
+      root = config.root;
+      enabled = config.plugins.some((p) => p.name?.startsWith("vite:devtools"));
+      if (!enabled)
+        return;
+      if (options?._ctx) {
+        options._ctx.addRuntimePlugin({
+          import: { name: "devtoolsPlugin", source: "@unhead/bundler", as: "__unhead_devtoolsPlugin" },
+          client: "window.__unhead_devtools__=_h",
+          server: "_h.use(__unhead_devtoolsPlugin())"
+        });
+      }
+      try {
+        const unheadPkg = resolve(pkgDir, "node_modules/unhead/package.json");
+        if (existsSync(unheadPkg))
+          unheadVersion = JSON.parse(readFileSync(unheadPkg, "utf-8")).version || "";
+      } catch {
+      }
+      const bridgePath = resolve(pkgDir, "dist/devtools/bridge.mjs");
+      if (existsSync(bridgePath))
+        bridgeCode = readFileSync(bridgePath, "utf-8");
+    },
+    configureServer(server) {
+      if (!enabled)
+        return;
+      server.middlewares.use("/@unhead/bridge.mjs", async (_req, res) => {
+        const result = await server.transformRequest("/@unhead/bridge.mjs");
+        res.setHeader("Content-Type", "application/javascript");
+        res.end(result?.code || 'console.warn("[unhead devtools] bridge not built")');
+      });
+    },
+    resolveId(id) {
+      if (!enabled)
+        return;
+      if (id === "/@unhead/bridge.mjs")
+        return id;
+    },
+    load(id) {
+      if (!enabled || id !== "/@unhead/bridge.mjs")
+        return;
+      if (!bridgeCode)
+        return 'console.warn("[unhead devtools] bridge not built")';
+      let code = bridgeCode;
+      if (unheadVersion)
+        code = code.replace(UNHEAD_VERSION_RE, `__UNHEAD_VERSION__ = '${unheadVersion}'`);
+      const kitClientPath = resolve(pkgDir, "node_modules/@vitejs/devtools-kit/dist/client.js");
+      if (existsSync(kitClientPath))
+        return code.replace(`'@vitejs/devtools-kit/client'`, `'${kitClientPath}'`);
+      return code;
+    },
+    transform: {
+      filter: { id: FILE_RE$1 },
+      handler(code, id) {
+        if (!enabled)
+          return;
+        return transformSourceLocations(code, id, root);
+      }
+    },
+    transformIndexHtml: {
+      // Run before non-pre HTML transforms so the injected module import
+      // goes through the full Vite plugin pipeline.
+      order: "pre",
+      handler() {
+        if (!enabled)
+          return [];
+        return [{
+          tag: "script",
+          attrs: { type: "module" },
+          children: `import("/@unhead/bridge.mjs")`,
+          injectTo: "head"
+        }];
+      }
+    },
+    devtools: {
+      setup(ctx) {
+        if (existsSync(devtoolsUiDir)) {
+          ctx.views.hostStatic(DEVTOOLS_UI_ROUTE, devtoolsUiDir);
+        }
+        ctx.docks.register({
+          id: "unhead",
+          title: "Unhead",
+          icon: UNHEAD_ICON,
+          type: "iframe",
+          url: DEVTOOLS_UI_ROUTE
+        });
+        ctx.rpc.register(getConfigRpc);
+        ctx.rpc.register(runLintRpc);
+      }
+    }
+  };
+}
+
+const FILE_RE = /\.(vue|tsx?|jsx?|svelte)$/;
+const UNHEAD_SOURCE_RE = /^(?:@unhead\/[^/]+|unhead)(?:\/[^?]*)?$/;
+function createHeadTransformContext() {
+  const registrations = [];
+  return {
+    addRuntimePlugin(reg) {
+      registrations.push(reg);
+    },
+    getRegistrations() {
+      return registrations;
+    }
+  };
+}
+function CreateHeadTransform(ctx) {
+  let root = "";
+  return {
+    name: "@unhead/create-head-transform",
+    apply: "serve",
+    configResolved(config) {
+      root = config.root;
+    },
+    transform: {
+      filter: { id: FILE_RE },
+      handler(code, id) {
+        const registrations = ctx.getRegistrations();
+        if (!registrations.length)
+          return;
+        if (!code.includes("createHead"))
+          return;
+        const isServer = this.environment?.config?.consumer === "server";
+        const envRegistrations = registrations.filter((r) => isServer ? r.server : r.client);
+        if (!envRegistrations.length)
+          return;
+        const s = new MagicString(code);
+        let transformed = false;
+        const directCreateHeadNames = /* @__PURE__ */ new Set();
+        const namespaceNames = /* @__PURE__ */ new Set();
+        parseAndWalk(code, id, {
+          parseOptions: { lang: "ts" },
+          enter(node) {
+            if (node.type === "ImportDeclaration") {
+              const source = node.source?.value;
+              if (typeof source !== "string" || !UNHEAD_SOURCE_RE.test(source))
+                return;
+              for (const spec of node.specifiers || []) {
+                if (spec.type === "ImportSpecifier" && spec.imported?.name === "createHead")
+                  directCreateHeadNames.add(spec.local.name);
+                else if (spec.type === "ImportNamespaceSpecifier")
+                  namespaceNames.add(spec.local.name);
+              }
+              return;
+            }
+            if (node.type !== "CallExpression")
+              return;
+            const callee = node.callee;
+            if (!callee)
+              return;
+            const isDirect = callee.type === "Identifier" && directCreateHeadNames.has(callee.name);
+            const isNamespaced = callee.type === "MemberExpression" && callee.object?.type === "Identifier" && namespaceNames.has(callee.object.name) && callee.property?.type === "Identifier" && callee.property.name === "createHead";
+            if (!isDirect && !isNamespaced)
+              return;
+            const statements = envRegistrations.map((r) => (isServer ? r.server : r.client).replace(/__ROOT__/g, JSON.stringify(root))).join(",");
+            s.prependLeft(node.start, `((_h)=>(${statements},_h))(`);
+            s.appendRight(node.end, `)`);
+            transformed = true;
+          }
+        });
+        if (!transformed)
+          return;
+        for (const reg of envRegistrations) {
+          s.prepend(`import { ${reg.import.name} as ${reg.import.as} } from '${reg.import.source}';
+`);
+        }
+        return {
+          code: s.toString(),
+          map: s.generateMap({ includeContent: true, source: id })
+        };
+      }
+    }
+  };
+}
+
 const NODE_MODULES_RE$2 = /[\\/]node_modules[\\/]/;
 const TRANSFORM_RE$2 = /\.(?:(?:c|m)?j|t)sx?$/;
 const SKIP_JS_TYPES = /* @__PURE__ */ new Set(["application/json", "application/ld+json", "speculationrules", "importmap"]);
@@ -463,4 +772,4 @@ const UseSeoMetaTransform = createUnplugin((options = {}) => {
   };
 });
 
-export { MinifyTransform as M, SSRStaticReplace as S, TreeshakeServerComposables as T, UseSeoMetaTransform as U };
+export { CreateHeadTransform as C, MinifyTransform as M, SSRStaticReplace as S, TreeshakeServerComposables as T, UseSeoMetaTransform as U, createHeadTransformContext as c, unheadDevtools as u };