@unhead/bundler 3.0.4 → 3.1.0

package/dist/shared/{bundler.BgFGu6g_.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"]);
@@ -295,6 +604,7 @@ const UseSeoMetaTransform = createUnplugin((options = {}) => {
       const s = new MagicString(code);
       const importRewrites = /* @__PURE__ */ new Map();
       const valueReferenced = /* @__PURE__ */ new Set();
+      const untransformedCallees = /* @__PURE__ */ new Set();
       walk(ast.program, {
         scopeTracker,
         enter(node, parent) {
@@ -322,8 +632,11 @@ const UseSeoMetaTransform = createUnplugin((options = {}) => {
           if (!SEO_META_NAMES.has(originalName))
             return;
           const properties = node.arguments[0]?.properties;
-          if (!properties)
+          if (!properties) {
+            if (importDecl)
+              untransformedCallees.add(originalName);
             return;
+          }
           let output = [];
           const title = properties.find((property) => property.key?.name === "title");
           const titleTemplate = properties.find((property) => property.key?.name === "titleTemplate");
@@ -422,6 +735,8 @@ const UseSeoMetaTransform = createUnplugin((options = {}) => {
                 importRewrites.set(importDecl, /* @__PURE__ */ new Set());
               importRewrites.get(importDecl).add(originalName);
             }
+          } else if (importDecl) {
+            untransformedCallees.add(originalName);
           }
         }
       });
@@ -434,7 +749,7 @@ const UseSeoMetaTransform = createUnplugin((options = {}) => {
             const importedName = spec.imported.name;
             if (transformedNames.has(importedName)) {
               newSpecifiers.add(importedName.includes("Server") ? "useServerHead" : "useHead");
-              if (valueReferenced.has(importedName))
+              if (valueReferenced.has(importedName) || untransformedCallees.has(importedName))
                 newSpecifiers.add(importedName);
             } else {
               newSpecifiers.add(importedName);
@@ -457,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 };

package/dist/shared/{bundler.BwKIGaKX.d.mts → bundler.LjD9SWtb.d.mts}

@@ -51,10 +51,25 @@ interface VitePluginOptions extends UnpluginOptions {
     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 */
+    /**
+     * @internal
+     * @deprecated Pass via the `internal` second argument of `Unhead()` instead.
+     * Retained as a passthrough so existing framework wrappers keep working.
+     */
     _framework?: string;
 }
+/**
+ * Internal extension carrying the framework package name (e.g. `@unhead/vue`)
+ * so the base bundler factory can import runtime plugins from the right path.
+ * Never exposed on public option types; framework wrappers pass this via
+ * the factory helpers in `./framework`.
+ *
+ * @internal
+ */
+interface InternalFrameworkContext {
+    framework?: string;
+}
 interface UnheadDevtoolsOptions {
 }
 
-export type { MinifyFn as M, UnpluginOptions as U, VitePluginOptions as V };
+export type { InternalFrameworkContext as I, MinifyFn as M, VitePluginOptions as V };

package/dist/shared/{bundler.BwKIGaKX.d.ts → bundler.LjD9SWtb.d.ts}

@@ -51,10 +51,25 @@ interface VitePluginOptions extends UnpluginOptions {
     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 */
+    /**
+     * @internal
+     * @deprecated Pass via the `internal` second argument of `Unhead()` instead.
+     * Retained as a passthrough so existing framework wrappers keep working.
+     */
     _framework?: string;
 }
+/**
+ * Internal extension carrying the framework package name (e.g. `@unhead/vue`)
+ * so the base bundler factory can import runtime plugins from the right path.
+ * Never exposed on public option types; framework wrappers pass this via
+ * the factory helpers in `./framework`.
+ *
+ * @internal
+ */
+interface InternalFrameworkContext {
+    framework?: string;
+}
 interface UnheadDevtoolsOptions {
 }
 
-export type { MinifyFn as M, UnpluginOptions as U, VitePluginOptions as V };
+export type { InternalFrameworkContext as I, MinifyFn as M, VitePluginOptions as V };

package/dist/vite.d.mts

@@ -1,6 +1,14 @@
 import { Plugin } from 'vite';
-import { V as VitePluginOptions } from './shared/bundler.BwKIGaKX.mjs';
+import { V as VitePluginOptions, I as InternalFrameworkContext } from './shared/bundler.LjD9SWtb.mjs';
 
-declare function Unhead(options?: VitePluginOptions): Plugin[];
+/**
+ * Vite plugin factory that composes the core Unhead build-time transforms
+ * (tree-shake, seo-meta, minify, SSR static replace, devtools).
+ *
+ * Framework packages (e.g. `@unhead/vue/vite`) should not call this directly;
+ * use the `createFrameworkVitePlugin` helper in `./framework` which threads
+ * `_framework` correctly without exposing it on public options.
+ */
+declare function Unhead(options?: VitePluginOptions, internal?: InternalFrameworkContext): Plugin[];
 
 export { Unhead, VitePluginOptions };

package/dist/vite.d.ts

@@ -1,6 +1,14 @@
 import { Plugin } from 'vite';
-import { V as VitePluginOptions } from './shared/bundler.BwKIGaKX.js';
+import { V as VitePluginOptions, I as InternalFrameworkContext } from './shared/bundler.LjD9SWtb.js';
 
-declare function Unhead(options?: VitePluginOptions): Plugin[];
+/**
+ * Vite plugin factory that composes the core Unhead build-time transforms
+ * (tree-shake, seo-meta, minify, SSR static replace, devtools).
+ *
+ * Framework packages (e.g. `@unhead/vue/vite`) should not call this directly;
+ * use the `createFrameworkVitePlugin` helper in `./framework` which threads
+ * `_framework` correctly without exposing it on public options.
+ */
+declare function Unhead(options?: VitePluginOptions, internal?: InternalFrameworkContext): Plugin[];
 
 export { Unhead, VitePluginOptions };