@unhead/vue 3.0.4 → 3.0.5

package/dist/stream/client.d.mts

@@ -6,9 +6,18 @@ import { V as VueHeadClient, U as UseHeadInput } from '../shared/vue.CajUUuy2.mj
 import 'unhead/types';
 
 /**
- * Client-side HeadStream - renders nothing (script already executed during SSR streaming)
+ * Client-side counterpart to the server `HeadStream`. Always emits a
+ * `<script data-allow-mismatch="children">` with empty `innerHTML`. The
+ * matching vnode type on both sides lets Vue hydrate the node; the
+ * `data-allow-mismatch` attribute silences the inner-content difference
+ * between the server-emitted streaming patch and this empty client vnode.
+ *
+ * The already-executed server script stays in the DOM after hydration — it's
+ * inert (scripts only execute on parse) and the placeholder is cheap.
  */
-declare const HeadStream: vue.DefineComponent<{}, () => null, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+declare const HeadStream: vue.DefineComponent<{}, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 /**
  * Creates a client head by wrapping the core instance from the iife script.
  */

package/dist/stream/client.d.ts

@@ -6,9 +6,18 @@ import { V as VueHeadClient, U as UseHeadInput } from '../shared/vue.CajUUuy2.js
 import 'unhead/types';
 
 /**
- * Client-side HeadStream - renders nothing (script already executed during SSR streaming)
+ * Client-side counterpart to the server `HeadStream`. Always emits a
+ * `<script data-allow-mismatch="children">` with empty `innerHTML`. The
+ * matching vnode type on both sides lets Vue hydrate the node; the
+ * `data-allow-mismatch` attribute silences the inner-content difference
+ * between the server-emitted streaming patch and this empty client vnode.
+ *
+ * The already-executed server script stays in the DOM after hydration — it's
+ * inert (scripts only execute on parse) and the placeholder is cheap.
  */
-declare const HeadStream: vue.DefineComponent<{}, () => null, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+declare const HeadStream: vue.DefineComponent<{}, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 /**
  * Creates a client head by wrapping the core instance from the iife script.
  */

package/dist/stream/client.mjs

@@ -1,5 +1,5 @@
 import { createStreamableHead as createStreamableHead$1 } from 'unhead/stream/client';
-import { defineComponent } from 'vue';
+import { defineComponent, h } from 'vue';
 import { v as vueInstall } from '../shared/vue.D51lypTh.mjs';
 import { V as VueResolver } from '../shared/vue.CkLIG7eN.mjs';
 export { V as VueHeadMixin } from '../shared/vue.C54fV9ES.mjs';
@@ -9,7 +9,7 @@ import 'unhead/utils';
 const HeadStream = defineComponent({
   name: "HeadStream",
   setup() {
-    return () => null;
+    return () => h("script", { "data-allow-mismatch": "children" });
   }
 });
 // @__NO_SIDE_EFFECTS__

package/dist/stream/server.d.mts

@@ -5,12 +5,18 @@ import { ResolvableHead, SSRHeadPayload, CreateStreamableServerHeadOptions } fro
 import { V as VueHeadClient } from '../shared/vue.CajUUuy2.mjs';
 
 /**
- * Streaming script component - outputs inline script with current head state.
- * The Vite plugin with streaming: true auto-injects this.
+ * Emits a `<script data-allow-mismatch="children">` whose `innerHTML` is the
+ * pending head-update JS (if any). The client counterpart renders an identical
+ * `<script data-allow-mismatch="children">` with empty innerHTML: symmetric
+ * vnode types let Vue's hydrator match the node, and `data-allow-mismatch`
+ * silences the inner-content difference.
+ *
+ * The Vite plugin injects one `<HeadStream />` at the top of every SFC
+ * `<template>` that uses `useHead` / `useSeoMeta`.
  */
 declare const HeadStream: vue.DefineComponent<{}, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
     [key: string]: any;
-}> | null, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 /**
  * Vue-specific context returned by createStreamableHead.
  * Extends WebStreamableHeadContext with Vue-specific head type.
@@ -34,10 +40,7 @@ interface VueStreamableHeadContext extends Omit<WebStreamableHeadContext<Resolva
  *   app.mixin(VueHeadMixin)
  *   router.push(url)
  *
- *   // Create stream first - Vue starts rendering synchronously
  *   const vueStream = renderToWebStream(app)
- *
- *   // Wait for router - by now Vue's sync render has pushed head entries
  *   await router.isReady()
  *
  *   return wrapStream(vueStream, template)

package/dist/stream/server.d.ts

@@ -5,12 +5,18 @@ import { ResolvableHead, SSRHeadPayload, CreateStreamableServerHeadOptions } fro
 import { V as VueHeadClient } from '../shared/vue.CajUUuy2.js';
 
 /**
- * Streaming script component - outputs inline script with current head state.
- * The Vite plugin with streaming: true auto-injects this.
+ * Emits a `<script data-allow-mismatch="children">` whose `innerHTML` is the
+ * pending head-update JS (if any). The client counterpart renders an identical
+ * `<script data-allow-mismatch="children">` with empty innerHTML: symmetric
+ * vnode types let Vue's hydrator match the node, and `data-allow-mismatch`
+ * silences the inner-content difference.
+ *
+ * The Vite plugin injects one `<HeadStream />` at the top of every SFC
+ * `<template>` that uses `useHead` / `useSeoMeta`.
  */
 declare const HeadStream: vue.DefineComponent<{}, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
     [key: string]: any;
-}> | null, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 /**
  * Vue-specific context returned by createStreamableHead.
  * Extends WebStreamableHeadContext with Vue-specific head type.
@@ -34,10 +40,7 @@ interface VueStreamableHeadContext extends Omit<WebStreamableHeadContext<Resolva
  *   app.mixin(VueHeadMixin)
  *   router.push(url)
  *
- *   // Create stream first - Vue starts rendering synchronously
  *   const vueStream = renderToWebStream(app)
- *
- *   // Wait for router - by now Vue's sync render has pushed head entries
  *   await router.isReady()
  *
  *   return wrapStream(vueStream, template)

package/dist/stream/server.mjs

@@ -12,11 +12,9 @@ const HeadStream = defineComponent({
     const head = injectHead();
     return () => {
       if (!head._shellRendered?.())
-        return null;
+        return h("script", { "data-allow-mismatch": "children" });
       const update = renderSSRHeadSuspenseChunk(head);
-      if (!update)
-        return null;
-      return h("script", { innerHTML: update });
+      return h("script", { "data-allow-mismatch": "children", "innerHTML": update || "" });
     };
   }
 });

package/dist/stream/vite.d.mts

@@ -2,13 +2,9 @@ import * as vite from 'vite';
 import { StreamingPluginOptions } from 'unhead/stream/vite';
 
 /**
- * Vite plugin for Vue streaming SSR support.
- * Automatically injects HeadStream components into Vue SFC templates.
- *
- * @returns Vite plugin configuration object with:
- *   - `name`: Plugin identifier
- *   - `enforce`: Plugin execution order ('pre')
- *   - `transform`: Transform hook for processing .vue files
+ * Vite plugin for Vue streaming SSR support. Automatically injects
+ * `<HeadStream />` into Vue SFC templates for components that use head
+ * composables.
  *
  * @example
  * ```ts
@@ -17,8 +13,8 @@ import { StreamingPluginOptions } from 'unhead/stream/vite';
  *
  * export default {
  *   plugins: [
- *     unheadVuePlugin()
- *   ]
+ *     unheadVuePlugin(),
+ *   ],
  * }
  * ```
  */

package/dist/stream/vite.d.ts

@@ -2,13 +2,9 @@ import * as vite from 'vite';
 import { StreamingPluginOptions } from 'unhead/stream/vite';
 
 /**
- * Vite plugin for Vue streaming SSR support.
- * Automatically injects HeadStream components into Vue SFC templates.
- *
- * @returns Vite plugin configuration object with:
- *   - `name`: Plugin identifier
- *   - `enforce`: Plugin execution order ('pre')
- *   - `transform`: Transform hook for processing .vue files
+ * Vite plugin for Vue streaming SSR support. Automatically injects
+ * `<HeadStream />` into Vue SFC templates for components that use head
+ * composables.
  *
  * @example
  * ```ts
@@ -17,8 +13,8 @@ import { StreamingPluginOptions } from 'unhead/stream/vite';
  *
  * export default {
  *   plugins: [
- *     unheadVuePlugin()
- *   ]
+ *     unheadVuePlugin(),
+ *   ],
  * }
  * ```
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@unhead/vue",
   "type": "module",
-  "version": "3.0.4",
+  "version": "3.0.5",
   "description": "Full-stack <head> manager built for Vue.",
   "author": "Harlan Wilton <harlan@harlanzw.com>",
   "license": "MIT",
@@ -143,16 +143,16 @@
     ]
   },
   "dependencies": {
-    "hookable": "^6.1.0",
+    "hookable": "^6.1.1",
     "magic-string": "^0.30.21",
-    "oxc-parser": "^0.125.0",
+    "oxc-parser": "^0.127.0",
     "oxc-walker": "^0.7.0",
-    "@unhead/bundler": "3.0.4",
-    "unhead": "3.0.4"
+    "@unhead/bundler": "3.0.5",
+    "unhead": "3.0.5"
   },
   "devDependencies": {
     "@vue/server-renderer": "^3.5.32",
-    "vite": "^8.0.8",
+    "vite": "^8.0.9",
     "vue": "^3.5.32"
   },
   "scripts": {