@unhead/svelte 3.0.0-beta.1 → 3.0.0-beta.11

package/dist/client.d.mts

@@ -1,9 +1,10 @@
-import { CreateClientHeadOptions, Unhead } from 'unhead/types';
+import { ClientUnhead } from 'unhead/client';
+export { renderDOMHead } from 'unhead/client';
+import { CreateClientHeadOptions } from 'unhead/types';
 export { CreateClientHeadOptions, Unhead } from 'unhead/types';
 export { UnheadContextKey } from './server.mjs';
-export { renderDOMHead } from 'unhead/client';
 import 'unhead/server';
 
-declare function createHead(options?: CreateClientHeadOptions): Unhead;
+declare function createHead(options?: CreateClientHeadOptions): ClientUnhead;
 
 export { createHead };

package/dist/client.d.ts

@@ -1,9 +1,10 @@
-import { CreateClientHeadOptions, Unhead } from 'unhead/types';
+import { ClientUnhead } from 'unhead/client';
+export { renderDOMHead } from 'unhead/client';
+import { CreateClientHeadOptions } from 'unhead/types';
 export { CreateClientHeadOptions, Unhead } from 'unhead/types';
 export { UnheadContextKey } from './server.js';
-export { renderDOMHead } from 'unhead/client';
 import 'unhead/server';
 
-declare function createHead(options?: CreateClientHeadOptions): Unhead;
+declare function createHead(options?: CreateClientHeadOptions): ClientUnhead;
 
 export { createHead };

package/dist/client.mjs

@@ -1,15 +1,13 @@
 import { tick } from 'svelte';
-import { createHead as createHead$1, createDebouncedFn, renderDOMHead } from 'unhead/client';
+import { createDomRenderer, createDebouncedFn, createHead as createHead$1 } from 'unhead/client';
 export { renderDOMHead } from 'unhead/client';
-export { U as UnheadContextKey } from './shared/svelte.Cczd8v9v.mjs';
+export { U as UnheadContextKey } from './shared/svelte.89y3fBMp.mjs';
 
 function createHead(options = {}) {
-  const head = createHead$1({
-    domOptions: {
-      render: createDebouncedFn(() => renderDOMHead(head), (fn) => tick().then(fn))
-    },
-    ...options
-  });
+  const domRenderer = createDomRenderer();
+  let head;
+  const debouncedRenderer = createDebouncedFn(() => domRenderer(head), (fn) => tick().then(fn));
+  head = createHead$1({ render: debouncedRenderer, ...options });
   return head;
 }
 

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { onMount, onDestroy, getContext } from 'svelte';
 import { useHead as useHead$1, useHeadSafe as useHeadSafe$1, useScript as useScript$1, useSeoMeta as useSeoMeta$1 } from 'unhead';
-import { U as UnheadContextKey } from './shared/svelte.Cczd8v9v.mjs';
+import { U as UnheadContextKey } from './shared/svelte.89y3fBMp.mjs';
 
 const autoImports = {
   "@unhead/svelte": [
@@ -19,9 +19,11 @@ function useUnhead() {
   return instance;
 }
 function withSideEffects(instance) {
-  onDestroy(() => {
-    instance.dispose();
-  });
+  if (typeof window !== "undefined") {
+    onDestroy(() => {
+      instance.dispose();
+    });
+  }
   return instance;
 }
 function useHead(input = {}, options = {}) {

package/dist/server.d.mts

@@ -1,4 +1,4 @@
-export { createHead, extractUnheadInputFromHtml, renderSSRHead, transformHtmlTemplate } from 'unhead/server';
+export { createHead, renderSSRHead, transformHtmlTemplate } from 'unhead/server';
 export { CreateServerHeadOptions, SSRHeadPayload, Unhead } from 'unhead/types';
 
 declare const UnheadContextKey: unique symbol;

package/dist/server.d.ts

@@ -1,4 +1,4 @@
-export { createHead, extractUnheadInputFromHtml, renderSSRHead, transformHtmlTemplate } from 'unhead/server';
+export { createHead, renderSSRHead, transformHtmlTemplate } from 'unhead/server';
 export { CreateServerHeadOptions, SSRHeadPayload, Unhead } from 'unhead/types';
 
 declare const UnheadContextKey: unique symbol;

package/dist/server.mjs

@@ -1,2 +1,2 @@
-export { U as UnheadContextKey } from './shared/svelte.Cczd8v9v.mjs';
-export { createHead, extractUnheadInputFromHtml, renderSSRHead, transformHtmlTemplate } from 'unhead/server';
+export { U as UnheadContextKey } from './shared/svelte.89y3fBMp.mjs';
+export { createHead, renderSSRHead, transformHtmlTemplate } from 'unhead/server';

package/dist/shared/svelte.89y3fBMp.mjs

@@ -0,0 +1,3 @@
+const UnheadContextKey = Symbol.for("unhead");
+
+export { UnheadContextKey as U };

package/dist/stream/client.d.mts

@@ -0,0 +1,11 @@
+export { UnheadContextKey } from '../server.mjs';
+export { CreateStreamableClientHeadOptions, UnheadStreamQueue, createStreamableHead } from 'unhead/stream/client';
+import 'unhead/server';
+import 'unhead/types';
+
+/**
+ * Client-side HeadStream - returns empty string (script already executed during SSR streaming)
+ */
+declare function HeadStream(): string;
+
+export { HeadStream };

package/dist/stream/client.d.ts

@@ -0,0 +1,11 @@
+export { UnheadContextKey } from '../server.js';
+export { CreateStreamableClientHeadOptions, UnheadStreamQueue, createStreamableHead } from 'unhead/stream/client';
+import 'unhead/server';
+import 'unhead/types';
+
+/**
+ * Client-side HeadStream - returns empty string (script already executed during SSR streaming)
+ */
+declare function HeadStream(): string;
+
+export { HeadStream };

package/dist/stream/client.mjs

@@ -0,0 +1,8 @@
+export { U as UnheadContextKey } from '../shared/svelte.89y3fBMp.mjs';
+export { createStreamableHead } from 'unhead/stream/client';
+
+function HeadStream() {
+  return "";
+}
+
+export { HeadStream };

package/dist/stream/server.d.mts

@@ -0,0 +1,37 @@
+import { WebStreamableHeadContext } from 'unhead/stream/server';
+export { CreateStreamableServerHeadOptions, StreamingTemplateParts, WebStreamableHeadContext, prepareStreamingTemplate, renderSSRHeadShell, renderSSRHeadSuspenseChunk, wrapStream } from 'unhead/stream/server';
+import { CreateStreamableServerHeadOptions } from 'unhead/types';
+export { Unhead } from 'unhead/types';
+export { UnheadContextKey } from '../server.mjs';
+import 'unhead/server';
+
+/**
+ * Streaming script function for Svelte.
+ * Returns HTML string to be rendered with {@html}.
+ *
+ * Note: Svelte SSR is synchronous, so all head entries are captured in the shell.
+ * This function exists for API parity with React/Solid but returns empty for Svelte
+ * since there are no streaming head updates to emit.
+ */
+declare function HeadStream(): string;
+/**
+ * Svelte streaming context returned by createStreamableHead.
+ * Type alias for WebStreamableHeadContext from core.
+ */
+type SvelteStreamableHeadContext = WebStreamableHeadContext;
+/**
+ * Creates a head instance configured for Svelte streaming SSR.
+ *
+ * @example
+ * ```ts
+ * const { head, wrapStream } = createStreamableHead()
+ * setContext(UnheadContextKey, head)
+ *
+ * const stream = render(App)
+ * return wrapStream(stream, template)
+ * ```
+ */
+declare function createStreamableHead(options?: CreateStreamableServerHeadOptions): SvelteStreamableHeadContext;
+
+export { HeadStream, createStreamableHead };
+export type { SvelteStreamableHeadContext };

package/dist/stream/server.d.ts

@@ -0,0 +1,37 @@
+import { WebStreamableHeadContext } from 'unhead/stream/server';
+export { CreateStreamableServerHeadOptions, StreamingTemplateParts, WebStreamableHeadContext, prepareStreamingTemplate, renderSSRHeadShell, renderSSRHeadSuspenseChunk, wrapStream } from 'unhead/stream/server';
+import { CreateStreamableServerHeadOptions } from 'unhead/types';
+export { Unhead } from 'unhead/types';
+export { UnheadContextKey } from '../server.js';
+import 'unhead/server';
+
+/**
+ * Streaming script function for Svelte.
+ * Returns HTML string to be rendered with {@html}.
+ *
+ * Note: Svelte SSR is synchronous, so all head entries are captured in the shell.
+ * This function exists for API parity with React/Solid but returns empty for Svelte
+ * since there are no streaming head updates to emit.
+ */
+declare function HeadStream(): string;
+/**
+ * Svelte streaming context returned by createStreamableHead.
+ * Type alias for WebStreamableHeadContext from core.
+ */
+type SvelteStreamableHeadContext = WebStreamableHeadContext;
+/**
+ * Creates a head instance configured for Svelte streaming SSR.
+ *
+ * @example
+ * ```ts
+ * const { head, wrapStream } = createStreamableHead()
+ * setContext(UnheadContextKey, head)
+ *
+ * const stream = render(App)
+ * return wrapStream(stream, template)
+ * ```
+ */
+declare function createStreamableHead(options?: CreateStreamableServerHeadOptions): SvelteStreamableHeadContext;
+
+export { HeadStream, createStreamableHead };
+export type { SvelteStreamableHeadContext };

package/dist/stream/server.mjs

@@ -0,0 +1,23 @@
+import { createStreamableHead as createStreamableHead$1, wrapStream } from 'unhead/stream/server';
+export { prepareStreamingTemplate, renderSSRHeadShell, renderSSRHeadSuspenseChunk, wrapStream } from 'unhead/stream/server';
+export { U as UnheadContextKey } from '../shared/svelte.89y3fBMp.mjs';
+
+function HeadStream() {
+  return "";
+}
+function createStreamableHead(options = {}) {
+  const { head } = createStreamableHead$1(options);
+  let shellRendered = false;
+  head._shellRendered = () => shellRendered;
+  return {
+    head,
+    wrapStream: (stream, template) => {
+      const preRenderedState = head.render();
+      head.entries.clear();
+      shellRendered = true;
+      return wrapStream(head, stream, template, preRenderedState);
+    }
+  };
+}
+
+export { HeadStream, createStreamableHead };

package/dist/stream/vite.d.mts

@@ -0,0 +1,27 @@
+import * as vite from 'vite';
+import { StreamingPluginOptions } from 'unhead/stream/vite';
+
+/**
+ * Vite plugin for Svelte streaming SSR support.
+ * Automatically injects HeadStream into Svelte components.
+ *
+ * @returns Vite plugin configuration object with:
+ *   - `name`: Plugin identifier
+ *   - `enforce`: Plugin execution order ('pre')
+ *   - `transform`: Transform hook for processing .svelte files
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { unheadSveltePlugin } from '@unhead/svelte/stream/vite'
+ *
+ * export default {
+ *   plugins: [
+ *     unheadSveltePlugin()
+ *   ]
+ * }
+ * ```
+ */
+declare function unheadSveltePlugin(options?: Pick<StreamingPluginOptions, 'mode'>): vite.Plugin<any>;
+
+export { unheadSveltePlugin as default, unheadSveltePlugin };

package/dist/stream/vite.d.ts

@@ -0,0 +1,27 @@
+import * as vite from 'vite';
+import { StreamingPluginOptions } from 'unhead/stream/vite';
+
+/**
+ * Vite plugin for Svelte streaming SSR support.
+ * Automatically injects HeadStream into Svelte components.
+ *
+ * @returns Vite plugin configuration object with:
+ *   - `name`: Plugin identifier
+ *   - `enforce`: Plugin execution order ('pre')
+ *   - `transform`: Transform hook for processing .svelte files
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { unheadSveltePlugin } from '@unhead/svelte/stream/vite'
+ *
+ * export default {
+ *   plugins: [
+ *     unheadSveltePlugin()
+ *   ]
+ * }
+ * ```
+ */
+declare function unheadSveltePlugin(options?: Pick<StreamingPluginOptions, 'mode'>): vite.Plugin<any>;
+
+export { unheadSveltePlugin as default, unheadSveltePlugin };

package/dist/stream/vite.mjs

@@ -0,0 +1,66 @@
+import MagicString from 'magic-string';
+import { parseAndWalk } from 'oxc-walker';
+import { createStreamingPlugin } from 'unhead/stream/vite';
+
+function transform(code, id, isSSR, s) {
+  if (!code.includes("useHead") && !code.includes("useSeoMeta") && !code.includes("useHeadSafe"))
+    return false;
+  const scriptCloseMatch = code.match(/<\/script>/);
+  if (!scriptCloseMatch)
+    return false;
+  const templateStart = scriptCloseMatch.index + scriptCloseMatch[0].length;
+  s.appendRight(templateStart, "\n{@html HeadStream()}");
+  const importPath = `@unhead/svelte/stream/${isSSR ? "server" : "client"}`;
+  const scriptMatch = code.match(/<script[^>]*>/i);
+  if (!scriptMatch)
+    return true;
+  const scriptEnd = scriptMatch.index + scriptMatch[0].length;
+  const scriptCloseIndex = code.indexOf("<\/script>", scriptEnd);
+  if (scriptCloseIndex === -1)
+    return true;
+  const scriptContent = code.slice(scriptEnd, scriptCloseIndex);
+  let existingImport = null;
+  parseAndWalk(scriptContent, id, {
+    parseOptions: { lang: "ts" },
+    enter(node) {
+      if (node.type === "ImportDeclaration" && node.source.value === importPath) {
+        existingImport = {
+          start: scriptEnd + node.start,
+          end: scriptEnd + node.end,
+          specifiers: node.specifiers?.map((spec) => spec.local?.name).filter(Boolean) || []
+        };
+        this.skip();
+      }
+    }
+  });
+  const foundImport = existingImport;
+  if (foundImport) {
+    if (!foundImport.specifiers.includes("HeadStream")) {
+      const inner = foundImport.specifiers.join(", ");
+      const newImports = inner ? `${inner}, HeadStream` : "HeadStream";
+      s.overwrite(foundImport.start, foundImport.end, `import { ${newImports} } from '${importPath}'`);
+    }
+  } else {
+    s.appendRight(scriptEnd, `
+import { HeadStream } from '${importPath}'`);
+  }
+  return true;
+}
+function unheadSveltePlugin(options) {
+  return createStreamingPlugin({
+    framework: "@unhead/svelte",
+    filter: /\.svelte$/,
+    mode: options?.mode,
+    transform(code, id, opts) {
+      const s = new MagicString(code);
+      if (!transform(code, id, opts?.ssr ?? false, s))
+        return null;
+      return {
+        code: s.toString(),
+        map: s.generateMap({ includeContent: true, source: id })
+      };
+    }
+  });
+}
+
+export { unheadSveltePlugin as default, unheadSveltePlugin };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@unhead/svelte",
   "type": "module",
-  "version": "3.0.0-beta.1",
+  "version": "3.0.0-beta.11",
   "description": "Full-stack <head> manager built for Svelte.",
   "author": "Harlan Wilton <harlan@harlanzw.com>",
   "license": "MIT",
@@ -29,6 +29,14 @@
       "types": "./dist/client.d.ts",
       "default": "./dist/client.mjs"
     },
+    "./stream/server": {
+      "types": "./dist/stream/server.d.ts",
+      "default": "./dist/stream/server.mjs"
+    },
+    "./stream/client": {
+      "types": "./dist/stream/client.d.ts",
+      "default": "./dist/stream/client.mjs"
+    },
     "./utils": {
       "types": "./dist/utils.d.ts",
       "default": "./dist/utils.mjs"
@@ -36,6 +44,10 @@
     "./plugins": {
       "types": "./dist/plugins.d.ts",
       "default": "./dist/plugins.mjs"
+    },
+    "./stream/vite": {
+      "types": "./dist/stream/vite.d.ts",
+      "default": "./dist/stream/vite.mjs"
     }
   },
   "main": "dist/index.mjs",
@@ -48,6 +60,21 @@
       ],
       "client": [
         "dist/client"
+      ],
+      "stream/server": [
+        "dist/stream/server"
+      ],
+      "stream/client": [
+        "dist/stream/client"
+      ],
+      "plugins": [
+        "dist/plugins"
+      ],
+      "utils": [
+        "dist/utils"
+      ],
+      "stream/vite": [
+        "dist/stream/vite"
       ]
     }
   },
@@ -56,7 +83,13 @@
     "dist"
   ],
   "peerDependencies": {
-    "svelte": ">=5.38.0"
+    "svelte": ">=5.38.0",
+    "vite": ">=6"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
   },
   "build": {
     "external": [
@@ -64,12 +97,16 @@
     ]
   },
   "dependencies": {
-    "unhead": "3.0.0-beta.1"
+    "magic-string": "^0.30.21",
+    "oxc-parser": "^0.106.0",
+    "oxc-walker": "^0.7.0",
+    "unhead": "3.0.0-beta.11"
   },
   "devDependencies": {
-    "@sveltejs/vite-plugin-svelte": "^6.2.1",
-    "@testing-library/svelte": "^5.2.9",
-    "svelte": "^5.46.0"
+    "@sveltejs/vite-plugin-svelte": "^6.2.4",
+    "@testing-library/svelte": "^5.3.1",
+    "svelte": "^5.46.1",
+    "vite": "^7.3.1"
   },
   "scripts": {
     "build": "unbuild .",

package/dist/shared/svelte.Cczd8v9v.mjs

@@ -1,3 +0,0 @@
-const UnheadContextKey = Symbol("unhead");
-
-export { UnheadContextKey as U };