@unhead/bundler 3.0.0-rc.1

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import { HeadPluginInput } from 'unhead/types';
+export { InferSeoMetaPlugin } from 'unhead/plugins';
+
+declare const DefaultCriticalTags: {
+    htmlAttrs: {
+        lang: string;
+    };
+    meta: ({
+        charset: string;
+        name?: undefined;
+        content?: undefined;
+    } | {
+        name: string;
+        content: string;
+        charset?: undefined;
+    })[];
+};
+
+/**
+ * Unhead plugin that propagates source location metadata from entry options to tags.
+ *
+ * On the server, it also serializes the full devtools state into a
+ * `<script id="unhead:devtools">` payload so the client bridge can display
+ * server-only entries.
+ */
+declare function devtoolsPlugin(): HeadPluginInput;
+
+export { DefaultCriticalTags, devtoolsPlugin };

package/dist/index.mjs

@@ -0,0 +1,79 @@
+export { InferSeoMetaPlugin } from 'unhead/plugins';
+
+const DefaultCriticalTags = {
+  htmlAttrs: {
+    lang: "en"
+  },
+  meta: [
+    { charset: "utf-8" },
+    { name: "viewport", content: "width=device-width, initial-scale=1" }
+  ]
+};
+
+function devtoolsPlugin() {
+  return (head) => {
+    return {
+      key: "devtools",
+      hooks: {
+        "entries:normalize": function({ tags, entry }) {
+          const source = entry.options?._source;
+          if (!source)
+            return;
+          for (const tag of tags) {
+            if (!tag._source)
+              tag._source = source;
+          }
+        },
+        "tags:resolve": function(ctx) {
+          if (!head.ssr)
+            return;
+          const entries = [];
+          for (const [id, entry] of head.entries) {
+            let input = {};
+            try {
+              input = JSON.parse(JSON.stringify(entry.input || {}, (_k, v) => {
+                if (typeof v === "function")
+                  return `\u0192 ${v.name || "anonymous"}()`;
+                if (typeof v === "undefined")
+                  return "\u2298 undefined";
+                return v;
+              }));
+            } catch {
+            }
+            entries.push({
+              id,
+              source: entry.options?._source,
+              input,
+              tagCount: (entry._tags || []).length,
+              mode: "server"
+            });
+          }
+          const tags = [];
+          for (const tag of ctx.tags) {
+            if (tag.props?.id === "unhead:devtools" || tag.props?.id === "unhead:payload")
+              continue;
+            tags.push({
+              tag: tag.tag,
+              props: { ...tag.props },
+              innerHTML: tag.innerHTML,
+              textContent: tag.textContent,
+              position: tag.tagPosition,
+              priority: tag._w,
+              dedupeKey: tag._d,
+              source: tag._source,
+              mode: "server"
+            });
+          }
+          ctx.tags.push({
+            tag: "script",
+            // Escape `<` so a serialized `<\/script>` cannot close the inline JSON block early
+            innerHTML: JSON.stringify({ entries, tags }).replace(/</g, "\\u003C"),
+            props: { id: "unhead:devtools", type: "application/json" }
+          });
+        }
+      }
+    };
+  };
+}
+
+export { DefaultCriticalTags, devtoolsPlugin };

package/dist/minify/esbuild.d.mts

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

package/dist/minify/esbuild.d.ts

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

package/dist/minify/esbuild.mjs

@@ -0,0 +1,10 @@
+import { transform } from 'esbuild';
+
+function createJSMinifier() {
+  return async (code) => {
+    const result = await transform(code, { minify: true, loader: "js" });
+    return result.code.trim();
+  };
+}
+
+export { createJSMinifier };

package/dist/minify/lightningcss.d.mts

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

package/dist/minify/lightningcss.d.ts

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

package/dist/minify/lightningcss.mjs

@@ -0,0 +1,14 @@
+import { transform } from 'lightningcss';
+
+function createCSSMinifier() {
+  return async (code) => {
+    const result = transform({
+      filename: "inline.css",
+      code: new TextEncoder().encode(code),
+      minify: true
+    });
+    return new TextDecoder().decode(result.code).trim();
+  };
+}
+
+export { createCSSMinifier };

package/dist/minify/rolldown.d.mts

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

package/dist/minify/rolldown.d.ts

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

package/dist/minify/rolldown.mjs

@@ -0,0 +1,10 @@
+import { minify } from 'rolldown/experimental';
+
+function createJSMinifier() {
+  return async (code) => {
+    const result = await minify("inline.js", code);
+    return result.code.trim();
+  };
+}
+
+export { createJSMinifier };

package/dist/shared/bundler.BwKIGaKX.d.mts

@@ -0,0 +1,60 @@
+type MinifyFn = (code: string) => Promise<string | null>;
+interface MinifyTransformOptions extends BaseTransformerTypes {
+    /**
+     * Custom JS minifier function, or `false` to disable JS minification.
+     *
+     * Use a subpath import to get a preconfigured minifier:
+     * - `@unhead/bundler/minify/rolldown` (Vite 8+)
+     * - `@unhead/bundler/minify/esbuild` (Vite 7)
+     */
+    js?: false | MinifyFn;
+    /**
+     * Custom CSS minifier function, or `false` to disable CSS minification.
+     *
+     * Use `@unhead/bundler/minify/lightningcss` for a preconfigured minifier.
+     */
+    css?: false | MinifyFn;
+}
+
+interface TreeshakeServerComposablesOptions extends BaseTransformerTypes {
+    /**
+     * @deprecated Use `treeshake: false` at the top level instead.
+     */
+    enabled?: boolean;
+}
+
+interface UseSeoMetaTransformOptions extends BaseTransformerTypes {
+    /**
+     * Whether to transform imports of `useSeoMeta` and `useServerSeoMeta` to `useHead` and `useServerHead`.
+     */
+    imports?: boolean;
+    /**
+     * Extra import paths to consider where `useSeoMeta()` may be imported from.
+     */
+    importPaths?: string[];
+}
+
+interface BaseTransformerTypes {
+    sourcemap?: boolean;
+    filter?: {
+        exclude?: RegExp[];
+        include?: RegExp[];
+    };
+}
+interface UnpluginOptions extends BaseTransformerTypes {
+    treeshake?: TreeshakeServerComposablesOptions | false;
+    transformSeoMeta?: UseSeoMetaTransformOptions | false;
+    minify?: MinifyTransformOptions | false;
+}
+interface VitePluginOptions extends UnpluginOptions {
+    /** Vite DevTools integration (dev-only). Enabled by default, set `false` to disable. */
+    devtools?: UnheadDevtoolsOptions | false;
+    /** Inject ValidatePlugin in dev to surface head tag warnings in the console. Enabled by default, set `false` to disable. */
+    validate?: boolean;
+    /** @internal */
+    _framework?: string;
+}
+interface UnheadDevtoolsOptions {
+}
+
+export type { MinifyFn as M, UnpluginOptions as U, VitePluginOptions as V };

package/dist/shared/bundler.BwKIGaKX.d.ts

@@ -0,0 +1,60 @@
+type MinifyFn = (code: string) => Promise<string | null>;
+interface MinifyTransformOptions extends BaseTransformerTypes {
+    /**
+     * Custom JS minifier function, or `false` to disable JS minification.
+     *
+     * Use a subpath import to get a preconfigured minifier:
+     * - `@unhead/bundler/minify/rolldown` (Vite 8+)
+     * - `@unhead/bundler/minify/esbuild` (Vite 7)
+     */
+    js?: false | MinifyFn;
+    /**
+     * Custom CSS minifier function, or `false` to disable CSS minification.
+     *
+     * Use `@unhead/bundler/minify/lightningcss` for a preconfigured minifier.
+     */
+    css?: false | MinifyFn;
+}
+
+interface TreeshakeServerComposablesOptions extends BaseTransformerTypes {
+    /**
+     * @deprecated Use `treeshake: false` at the top level instead.
+     */
+    enabled?: boolean;
+}
+
+interface UseSeoMetaTransformOptions extends BaseTransformerTypes {
+    /**
+     * Whether to transform imports of `useSeoMeta` and `useServerSeoMeta` to `useHead` and `useServerHead`.
+     */
+    imports?: boolean;
+    /**
+     * Extra import paths to consider where `useSeoMeta()` may be imported from.
+     */
+    importPaths?: string[];
+}
+
+interface BaseTransformerTypes {
+    sourcemap?: boolean;
+    filter?: {
+        exclude?: RegExp[];
+        include?: RegExp[];
+    };
+}
+interface UnpluginOptions extends BaseTransformerTypes {
+    treeshake?: TreeshakeServerComposablesOptions | false;
+    transformSeoMeta?: UseSeoMetaTransformOptions | false;
+    minify?: MinifyTransformOptions | false;
+}
+interface VitePluginOptions extends UnpluginOptions {
+    /** Vite DevTools integration (dev-only). Enabled by default, set `false` to disable. */
+    devtools?: UnheadDevtoolsOptions | false;
+    /** Inject ValidatePlugin in dev to surface head tag warnings in the console. Enabled by default, set `false` to disable. */
+    validate?: boolean;
+    /** @internal */
+    _framework?: string;
+}
+interface UnheadDevtoolsOptions {
+}
+
+export type { MinifyFn as M, UnpluginOptions as U, VitePluginOptions as V };