unhead 3.0.0-beta.9 → 3.0.0-rc.1

package/dist/client.d.mts

@@ -1,9 +1,9 @@
-export { C as ClientUnhead, c as createHead } from './shared/unhead.B9UFuLCK.mjs';
-import { R as RenderDomHeadOptions } from './shared/unhead.DECeL1s3.mjs';
-import { p as HeadRenderer, q as Unhead } from './shared/unhead.CzbvM4Ih.mjs';
-export { n as CreateClientHeadOptions } from './shared/unhead.CzbvM4Ih.mjs';
+export { C as ClientUnhead, c as createHead } from './shared/unhead.Db0zAB-x.mjs';
+import { R as RenderDomHeadOptions } from './shared/unhead.DbDvRsnF.mjs';
+import { p as HeadRenderer, U as Unhead } from './shared/unhead.D6A03PN3.mjs';
+export { c as CreateClientHeadOptions } from './shared/unhead.D6A03PN3.mjs';
 import 'hookable';
-import './shared/unhead.5ph757u1.mjs';
+import './shared/unhead.Dyr7L2Ht.mjs';
 
 declare function createDomRenderer(options?: RenderDomHeadOptions): HeadRenderer<boolean>;
 

package/dist/client.d.ts

@@ -1,9 +1,9 @@
-export { C as ClientUnhead, c as createHead } from './shared/unhead.CuATeS8P.js';
-import { R as RenderDomHeadOptions } from './shared/unhead.C-4k1ONY.js';
-import { p as HeadRenderer, q as Unhead } from './shared/unhead.CmjOtSnf.js';
-export { n as CreateClientHeadOptions } from './shared/unhead.CmjOtSnf.js';
+export { C as ClientUnhead, c as createHead } from './shared/unhead.DFKqTFly.js';
+import { R as RenderDomHeadOptions } from './shared/unhead.DvZZ4Zb_.js';
+import { p as HeadRenderer, U as Unhead } from './shared/unhead.DmIUoNyg.js';
+export { c as CreateClientHeadOptions } from './shared/unhead.DmIUoNyg.js';
 import 'hookable';
-import './shared/unhead.5ph757u1.js';
+import './shared/unhead.Dyr7L2Ht.js';
 
 declare function createDomRenderer(options?: RenderDomHeadOptions): HeadRenderer<boolean>;
 

package/dist/client.mjs

@@ -1,8 +1,8 @@
-import { c as createDomRenderer, r as renderDOMHead$1 } from './shared/unhead.CdKxe2-O.mjs';
-import { c as createUnhead, r as registerPlugin } from './shared/unhead.Bkfgmqxw.mjs';
+import { c as createDomRenderer, r as renderDOMHead$1 } from './shared/unhead.D4TxP3zZ.mjs';
+import { c as createUnhead, r as registerPlugin } from './shared/unhead.CfgPMHXt.mjs';
 import { c as createHooks } from './shared/unhead.DvIxXxuO.mjs';
-import './shared/unhead.C2yODEXq.mjs';
-import './shared/unhead.zRLmrZrG.mjs';
+import './shared/unhead.fg-0ge_u.mjs';
+import './shared/unhead.DQiBmCqH.mjs';
 import 'hookable';
 
 const P = { critical: -8, high: -1, low: 2 };
@@ -32,6 +32,8 @@ function createHead(options = {}) {
       hooks.callHook("entries:updated", head);
     },
     push(input, _options) {
+      const onRendered = _options?.onRendered;
+      const unhook = onRendered ? hooks.hook("dom:rendered", onRendered) : void 0;
       const active = core.push(input, _options);
       core.entries.get(active._i)._o = input;
       dirty = true;
@@ -44,6 +46,7 @@ function createHead(options = {}) {
           hooks.callHook("entries:updated", head);
         },
         dispose() {
+          unhook?.();
           if (core.entries.has(active._i)) {
             active.dispose();
             head.invalidate();

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { H as HeadSafe } from './shared/unhead.OoU46jDW.mjs';
-import { aj as ResolvableHead, am as UseSeoMetaInput } from './shared/unhead.5ph757u1.mjs';
-import { q as Unhead, o as HeadEntryOptions, k as ActiveHeadEntry, p as HeadRenderer, C as CreateHeadOptions } from './shared/unhead.CzbvM4Ih.mjs';
-export { u as useScript } from './shared/unhead.sufKyII-.mjs';
+import { U as Unhead, k as HeadEntryOptions, A as ActiveHeadEntry, p as HeadRenderer, d as CreateHeadOptions } from './shared/unhead.D6A03PN3.mjs';
+import { ak as ResolvableHead, aT as UseSeoMetaInput } from './shared/unhead.Dyr7L2Ht.mjs';
+import { H as HeadSafe } from './shared/unhead.BiaRAmcT.mjs';
+export { u as useScript } from './shared/unhead.DyN7hSCT.mjs';
 import 'hookable';
 
 declare function useHead<T extends Unhead<any>, I = ResolvableHead>(unhead: T, input?: ResolvableHead, options?: HeadEntryOptions): ActiveHeadEntry<I>;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { H as HeadSafe } from './shared/unhead.BqsuEzgR.js';
-import { aj as ResolvableHead, am as UseSeoMetaInput } from './shared/unhead.5ph757u1.js';
-import { q as Unhead, o as HeadEntryOptions, k as ActiveHeadEntry, p as HeadRenderer, C as CreateHeadOptions } from './shared/unhead.CmjOtSnf.js';
-export { u as useScript } from './shared/unhead.Cfuv4vVm.js';
+import { U as Unhead, k as HeadEntryOptions, A as ActiveHeadEntry, p as HeadRenderer, d as CreateHeadOptions } from './shared/unhead.DmIUoNyg.js';
+import { ak as ResolvableHead, aT as UseSeoMetaInput } from './shared/unhead.Dyr7L2Ht.js';
+import { H as HeadSafe } from './shared/unhead.DKz0V2If.js';
+export { u as useScript } from './shared/unhead.Cp3HtzBy.js';
 import 'hookable';
 
 declare function useHead<T extends Unhead<any>, I = ResolvableHead>(unhead: T, input?: ResolvableHead, options?: HeadEntryOptions): ActiveHeadEntry<I>;

package/dist/index.mjs

@@ -1,8 +1,8 @@
-import { S as SafeInputPlugin, F as FlatMetaPlugin } from './shared/unhead.2y8V0W4A.mjs';
-export { c as createUnhead } from './shared/unhead.Bkfgmqxw.mjs';
-export { u as useScript } from './shared/unhead.D2jdZ2BM.mjs';
-import './shared/unhead.CxhEb2IP.mjs';
-import './shared/unhead.C2yODEXq.mjs';
+import { S as SafeInputPlugin, F as FlatMetaPlugin } from './shared/unhead.D_bywjUE.mjs';
+export { c as createUnhead } from './shared/unhead.CfgPMHXt.mjs';
+export { u as useScript } from './shared/unhead.DctB-0lW.mjs';
+import './shared/unhead.JWUDzlIs.mjs';
+import './shared/unhead.fg-0ge_u.mjs';
 import './shared/unhead.DvIxXxuO.mjs';
 import 'hookable';
 

package/dist/minify.d.mts

@@ -0,0 +1,19 @@
+/**
+ * Lightweight CSS minifier in pure JS (no native deps).
+ * Strips comments and collapses whitespace while preserving string literals.
+ */
+declare function minifyCSS(code: string): string;
+
+/**
+ * Lightweight JS minifier in pure JS (no native deps).
+ * Strips comments and collapses whitespace while preserving string literals.
+ */
+declare function minifyJS(code: string): string;
+
+/**
+ * Minify JSON by re-serializing (strips whitespace).
+ * Returns the original string unchanged if parsing fails.
+ */
+declare function minifyJSON(code: string): string;
+
+export { minifyCSS, minifyJS, minifyJSON };

package/dist/minify.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Lightweight CSS minifier in pure JS (no native deps).
+ * Strips comments and collapses whitespace while preserving string literals.
+ */
+declare function minifyCSS(code: string): string;
+
+/**
+ * Lightweight JS minifier in pure JS (no native deps).
+ * Strips comments and collapses whitespace while preserving string literals.
+ */
+declare function minifyJS(code: string): string;
+
+/**
+ * Minify JSON by re-serializing (strips whitespace).
+ * Returns the original string unchanged if parsing fails.
+ */
+declare function minifyJSON(code: string): string;
+
+export { minifyCSS, minifyJS, minifyJSON };

package/dist/minify.mjs

@@ -0,0 +1,138 @@
+function minifyCSS(code) {
+  let result = "";
+  let i = 0;
+  let parenDepth = 0;
+  const len = code.length;
+  while (i < len) {
+    const ch = code[i];
+    if (ch === "'" || ch === '"') {
+      const quote = ch;
+      result += ch;
+      i++;
+      while (i < len && code[i] !== quote) {
+        if (code[i] === "\\" && i + 1 < len)
+          result += code[i++];
+        result += code[i++];
+      }
+      if (i < len)
+        result += code[i++];
+    } else if (ch === "/" && code[i + 1] === "*") {
+      i += 2;
+      while (i < len && !(code[i] === "*" && code[i + 1] === "/"))
+        i++;
+      i += 2;
+    } else if (ch === "(") {
+      parenDepth++;
+      result += ch;
+      i++;
+    } else if (ch === ")") {
+      parenDepth = Math.max(0, parenDepth - 1);
+      result += ch;
+      i++;
+    } else if (ch === " " || ch === "	" || ch === "\n" || ch === "\r") {
+      while (i < len && (code[i] === " " || code[i] === "	" || code[i] === "\n" || code[i] === "\r"))
+        i++;
+      const prev = result.at(-1);
+      const next = code[i];
+      if (next === "!")
+        continue;
+      if (parenDepth > 0) {
+        if (prev && next && !isCSSCalcPunctuation(prev) && !isCSSCalcPunctuation(next))
+          result += " ";
+      } else if (prev && next && !isCSSPunctuation(prev) && !isCSSPunctuation(next)) {
+        result += " ";
+      }
+    } else if (ch === ";") {
+      let j = i + 1;
+      while (j < len && (code[j] === " " || code[j] === "	" || code[j] === "\n" || code[j] === "\r"))
+        j++;
+      if (code[j] === "}") {
+        i++;
+      } else {
+        result += ch;
+        i++;
+      }
+    } else if (ch === "0" && code[i + 1] === "." && code[i + 2] >= "0" && code[i + 2] <= "9") {
+      const prev = result.at(-1);
+      if (prev && prev >= "0" && prev <= "9") {
+        result += ch;
+        i++;
+      } else {
+        i++;
+      }
+    } else {
+      result += ch;
+      i++;
+    }
+  }
+  return result.trim();
+}
+function isCSSPunctuation(ch) {
+  return ch === "{" || ch === "}" || ch === ";" || ch === ":" || ch === "," || ch === ">" || ch === "~" || ch === "+" || ch === "(" || ch === ")";
+}
+function isCSSCalcPunctuation(ch) {
+  return ch === "*" || ch === "/" || ch === "(" || ch === ")" || ch === ",";
+}
+
+function minifyJS(code) {
+  let result = "";
+  let i = 0;
+  const len = code.length;
+  while (i < len) {
+    const ch = code[i];
+    if (ch === "'" || ch === '"' || ch === "`") {
+      const quote = ch;
+      result += ch;
+      i++;
+      while (i < len && code[i] !== quote) {
+        if (code[i] === "\\" && i + 1 < len) {
+          result += code[i++];
+        }
+        result += code[i++];
+      }
+      if (i < len)
+        result += code[i++];
+    } else if (ch === "/" && code[i + 1] === "/") {
+      i += 2;
+      while (i < len && code[i] !== "\n")
+        i++;
+    } else if (ch === "/" && code[i + 1] === "*") {
+      i += 2;
+      while (i < len && !(code[i] === "*" && code[i + 1] === "/"))
+        i++;
+      i += 2;
+    } else if (ch === " " || ch === "	" || ch === "\n" || ch === "\r") {
+      let hasNewline = false;
+      while (i < len && (code[i] === " " || code[i] === "	" || code[i] === "\n" || code[i] === "\r")) {
+        if (code[i] === "\n")
+          hasNewline = true;
+        i++;
+      }
+      const prev = result.at(-1);
+      const next = code[i];
+      if (hasNewline && prev && next && prev !== "{" && prev !== "}" && prev !== ";" && next !== "}" && next !== ";")
+        result += "\n";
+      else if (prev && next && isIdentChar(prev) && isIdentChar(next))
+        result += " ";
+      else if (prev && next && (prev === "+" && next === "+" || prev === "-" && next === "-"))
+        result += " ";
+    } else {
+      result += ch;
+      i++;
+    }
+  }
+  return result.trim();
+}
+function isIdentChar(ch) {
+  return ch >= "a" && ch <= "z" || ch >= "A" && ch <= "Z" || ch >= "0" && ch <= "9" || ch === "_" || ch === "$";
+}
+
+function minifyJSON(code) {
+  try {
+    return JSON.stringify(JSON.parse(code));
+  } catch {
+    return code;
+  }
+}
+
+export { minifyCSS, minifyJS, minifyJSON };

package/dist/parser.d.mts

@@ -1,4 +1,4 @@
-import { ak as SerializableHead } from './shared/unhead.5ph757u1.mjs';
+import { aD as SerializableHead } from './shared/unhead.Dyr7L2Ht.mjs';
 
 declare const TagIdMap: {
     readonly html: 0;

package/dist/parser.d.ts

@@ -1,4 +1,4 @@
-import { ak as SerializableHead } from './shared/unhead.5ph757u1.js';
+import { aD as SerializableHead } from './shared/unhead.Dyr7L2Ht.js';
 
 declare const TagIdMap: {
     readonly html: 0;

package/dist/plugins.d.mts

@@ -1,12 +1,29 @@
-import { i as HeadPluginInput, q as Unhead, h as HeadPluginOptions } from './shared/unhead.CzbvM4Ih.mjs';
+import { n as HeadPluginInput, U as Unhead, o as HeadPluginOptions } from './shared/unhead.D6A03PN3.mjs';
+import { p as HeadTag } from './shared/unhead.Dyr7L2Ht.mjs';
 import 'hookable';
-import './shared/unhead.5ph757u1.mjs';
 
 declare const AliasSortingPlugin: HeadPluginInput;
 
 interface CanonicalPluginOptions {
     canonicalHost?: string;
     customResolver?: (url: string) => string;
+    /**
+     * Query parameters to preserve in canonical and og:url tags.
+     * All other query parameters will be stripped by default.
+     *
+     * Set to `false` to disable query filtering (keep all params).
+     *
+     * @default [] (strips all query params)
+     */
+    queryWhitelist?: string[] | false;
+    /**
+     * Whether canonical URLs should have a trailing slash.
+     *
+     * - `true` - always add trailing slash
+     * - `false` - always remove trailing slash
+     * - `undefined` - leave as-is (default)
+     */
+    trailingSlash?: boolean;
 }
 /**
  * CanonicalPlugin resolves paths in tags that require a canonical host to be set.
@@ -14,6 +31,7 @@ interface CanonicalPluginOptions {
  *  - Resolves paths in meta tags like `og:image` and `twitter:image`.
  *  - Resolves paths in the `og:url` meta tag.
  *  - Resolves paths in the `link` tag with the `rel="canonical"` attribute.
+ *  - Filters query parameters from canonical and og:url tags.
  * @example
  * const plugin = CanonicalPlugin({
  *   canonicalHost: 'https://example.com',
@@ -43,7 +61,7 @@ interface InferSeoMetaPluginOptions {
     /**
      * Transform the og description.
      *
-     * @param title
+     * @param description
      */
     ogDescription?: ((description?: string) => string);
     /**
@@ -55,10 +73,110 @@ interface InferSeoMetaPluginOptions {
 }
 declare function InferSeoMetaPlugin(options?: InferSeoMetaPluginOptions): HeadPluginInput;
 
+interface MinifyPluginOptions {
+    /**
+     * Custom JS minifier. Set to `false` to disable JS minification.
+     * Defaults to built-in lightweight minifier.
+     */
+    js?: false | ((code: string) => string);
+    /**
+     * Custom CSS minifier. Set to `false` to disable CSS minification.
+     * Defaults to built-in lightweight minifier.
+     */
+    css?: false | ((code: string) => string);
+    /**
+     * Minify JSON script types (application/ld+json, application/json).
+     * @default true
+     */
+    json?: boolean;
+}
+/**
+ * Minifies inline script and style tag content during SSR rendering.
+ *
+ * Uses lightweight pure-JS minifiers by default (zero native dependencies, safe for edge/serverless).
+ * Custom minifiers can be provided for heavier optimization.
+ *
+ * Note: The `ssr:render` hook runs synchronously in the render pipeline, so custom minifiers must be synchronous.
+ *
+ * @example
+ * ```ts
+ * import { MinifyPlugin } from 'unhead/plugins'
+ *
+ * const head = createHead({
+ *   plugins: [MinifyPlugin()]
+ * })
+ * ```
+ */
+declare function MinifyPlugin(options?: MinifyPluginOptions): HeadPluginInput;
+
 declare const PromisesPlugin: HeadPluginInput;
 
 declare const SafeInputPlugin: HeadPluginInput;
 
 declare const TemplateParamsPlugin: HeadPluginInput;
 
-export { AliasSortingPlugin, CanonicalPlugin, FlatMetaPlugin, InferSeoMetaPlugin, PromisesPlugin, SafeInputPlugin, TemplateParamsPlugin, defineHeadPlugin };
+type RuleSeverity = 'warn' | 'info' | 'off';
+type ValidationRuleId = 'canonical-og-url-mismatch' | 'charset-not-early' | 'defer-on-module-script' | 'deprecated-option-mode' | 'deprecated-prop-body' | 'deprecated-prop-children' | 'deprecated-prop-hid-vmid' | 'duplicate-resource-hint' | 'empty-meta-content' | 'empty-title' | 'html-in-title' | 'inline-script-size' | 'inline-style-size' | 'meta-beyond-1mb' | 'missing-alias-sorting-plugin' | 'missing-description' | 'missing-template-params-plugin' | 'missing-title' | 'non-absolute-canonical' | 'non-absolute-og-url' | 'og-image-missing-dimensions' | 'og-missing-description' | 'og-missing-title' | 'possible-typo' | 'preconnect-missing-crossorigin' | 'prefetch-preload-conflict' | 'preload-async-defer-conflict' | 'preload-fetchpriority-conflict' | 'preload-font-crossorigin' | 'preload-missing-as' | 'preload-not-modulepreload' | 'redundant-dns-prefetch' | 'render-blocking-script' | 'robots-conflict' | 'script-src-with-content' | 'too-many-fetchpriority-high' | 'too-many-preconnects' | 'too-many-preloads' | 'twitter-handle-missing-at' | 'unresolved-template-param' | 'viewport-user-scalable';
+interface ValidationRuleOptions {
+    'charset-not-early': {
+        maxPosition: number;
+    };
+    'inline-script-size': {
+        maxKB: number;
+    };
+    'inline-style-size': {
+        maxKB: number;
+    };
+    'meta-beyond-1mb': {
+        maxBytes: number;
+    };
+    'too-many-fetchpriority-high': {
+        max: number;
+    };
+    'too-many-preloads': {
+        max: number;
+    };
+    'too-many-preconnects': {
+        max: number;
+    };
+}
+type RuleConfig<Id extends ValidationRuleId> = Id extends keyof ValidationRuleOptions ? RuleSeverity | [severity: RuleSeverity, options: ValidationRuleOptions[Id]] : RuleSeverity;
+type RulesConfig = {
+    [K in ValidationRuleId]?: RuleConfig<K>;
+};
+interface HeadValidationRule {
+    id: ValidationRuleId;
+    message: string;
+    severity: 'warn' | 'info';
+    source?: string;
+    tag?: HeadTag;
+}
+interface ValidatePluginOptions {
+    /**
+     * Callback to handle validation results. Receives all rules found per resolve cycle.
+     * Defaults to `console.warn` for each rule.
+     */
+    onReport?: (rules: HeadValidationRule[]) => void;
+    /**
+     * Configure rule severity and options. Accepts a severity string or an ESLint-style
+     * `[severity, options]` tuple for rules that support configuration.
+     *
+     * @example
+     * ```ts
+     * rules: {
+     *   'missing-description': 'off',
+     *   'too-many-preloads': ['warn', { max: 10 }],
+     *   'inline-style-size': ['info', { maxKB: 20 }],
+     * }
+     * ```
+     */
+    rules?: RulesConfig;
+    /**
+     * Project root path. When set, source locations are displayed as relative paths.
+     */
+    root?: string;
+}
+declare function ValidatePlugin(options?: ValidatePluginOptions): HeadPluginInput;
+
+export { AliasSortingPlugin, CanonicalPlugin, FlatMetaPlugin, InferSeoMetaPlugin, MinifyPlugin, PromisesPlugin, SafeInputPlugin, TemplateParamsPlugin, ValidatePlugin, defineHeadPlugin };
+export type { CanonicalPluginOptions, HeadValidationRule, MinifyPluginOptions, RuleConfig, RuleSeverity, RulesConfig, ValidatePluginOptions, ValidationRuleId, ValidationRuleOptions };

package/dist/plugins.d.ts

@@ -1,12 +1,29 @@
-import { i as HeadPluginInput, q as Unhead, h as HeadPluginOptions } from './shared/unhead.CmjOtSnf.js';
+import { n as HeadPluginInput, U as Unhead, o as HeadPluginOptions } from './shared/unhead.DmIUoNyg.js';
+import { p as HeadTag } from './shared/unhead.Dyr7L2Ht.js';
 import 'hookable';
-import './shared/unhead.5ph757u1.js';
 
 declare const AliasSortingPlugin: HeadPluginInput;
 
 interface CanonicalPluginOptions {
     canonicalHost?: string;
     customResolver?: (url: string) => string;
+    /**
+     * Query parameters to preserve in canonical and og:url tags.
+     * All other query parameters will be stripped by default.
+     *
+     * Set to `false` to disable query filtering (keep all params).
+     *
+     * @default [] (strips all query params)
+     */
+    queryWhitelist?: string[] | false;
+    /**
+     * Whether canonical URLs should have a trailing slash.
+     *
+     * - `true` - always add trailing slash
+     * - `false` - always remove trailing slash
+     * - `undefined` - leave as-is (default)
+     */
+    trailingSlash?: boolean;
 }
 /**
  * CanonicalPlugin resolves paths in tags that require a canonical host to be set.
@@ -14,6 +31,7 @@ interface CanonicalPluginOptions {
  *  - Resolves paths in meta tags like `og:image` and `twitter:image`.
  *  - Resolves paths in the `og:url` meta tag.
  *  - Resolves paths in the `link` tag with the `rel="canonical"` attribute.
+ *  - Filters query parameters from canonical and og:url tags.
  * @example
  * const plugin = CanonicalPlugin({
  *   canonicalHost: 'https://example.com',
@@ -43,7 +61,7 @@ interface InferSeoMetaPluginOptions {
     /**
      * Transform the og description.
      *
-     * @param title
+     * @param description
      */
     ogDescription?: ((description?: string) => string);
     /**
@@ -55,10 +73,110 @@ interface InferSeoMetaPluginOptions {
 }
 declare function InferSeoMetaPlugin(options?: InferSeoMetaPluginOptions): HeadPluginInput;
 
+interface MinifyPluginOptions {
+    /**
+     * Custom JS minifier. Set to `false` to disable JS minification.
+     * Defaults to built-in lightweight minifier.
+     */
+    js?: false | ((code: string) => string);
+    /**
+     * Custom CSS minifier. Set to `false` to disable CSS minification.
+     * Defaults to built-in lightweight minifier.
+     */
+    css?: false | ((code: string) => string);
+    /**
+     * Minify JSON script types (application/ld+json, application/json).
+     * @default true
+     */
+    json?: boolean;
+}
+/**
+ * Minifies inline script and style tag content during SSR rendering.
+ *
+ * Uses lightweight pure-JS minifiers by default (zero native dependencies, safe for edge/serverless).
+ * Custom minifiers can be provided for heavier optimization.
+ *
+ * Note: The `ssr:render` hook runs synchronously in the render pipeline, so custom minifiers must be synchronous.
+ *
+ * @example
+ * ```ts
+ * import { MinifyPlugin } from 'unhead/plugins'
+ *
+ * const head = createHead({
+ *   plugins: [MinifyPlugin()]
+ * })
+ * ```
+ */
+declare function MinifyPlugin(options?: MinifyPluginOptions): HeadPluginInput;
+
 declare const PromisesPlugin: HeadPluginInput;
 
 declare const SafeInputPlugin: HeadPluginInput;
 
 declare const TemplateParamsPlugin: HeadPluginInput;
 
-export { AliasSortingPlugin, CanonicalPlugin, FlatMetaPlugin, InferSeoMetaPlugin, PromisesPlugin, SafeInputPlugin, TemplateParamsPlugin, defineHeadPlugin };
+type RuleSeverity = 'warn' | 'info' | 'off';
+type ValidationRuleId = 'canonical-og-url-mismatch' | 'charset-not-early' | 'defer-on-module-script' | 'deprecated-option-mode' | 'deprecated-prop-body' | 'deprecated-prop-children' | 'deprecated-prop-hid-vmid' | 'duplicate-resource-hint' | 'empty-meta-content' | 'empty-title' | 'html-in-title' | 'inline-script-size' | 'inline-style-size' | 'meta-beyond-1mb' | 'missing-alias-sorting-plugin' | 'missing-description' | 'missing-template-params-plugin' | 'missing-title' | 'non-absolute-canonical' | 'non-absolute-og-url' | 'og-image-missing-dimensions' | 'og-missing-description' | 'og-missing-title' | 'possible-typo' | 'preconnect-missing-crossorigin' | 'prefetch-preload-conflict' | 'preload-async-defer-conflict' | 'preload-fetchpriority-conflict' | 'preload-font-crossorigin' | 'preload-missing-as' | 'preload-not-modulepreload' | 'redundant-dns-prefetch' | 'render-blocking-script' | 'robots-conflict' | 'script-src-with-content' | 'too-many-fetchpriority-high' | 'too-many-preconnects' | 'too-many-preloads' | 'twitter-handle-missing-at' | 'unresolved-template-param' | 'viewport-user-scalable';
+interface ValidationRuleOptions {
+    'charset-not-early': {
+        maxPosition: number;
+    };
+    'inline-script-size': {
+        maxKB: number;
+    };
+    'inline-style-size': {
+        maxKB: number;
+    };
+    'meta-beyond-1mb': {
+        maxBytes: number;
+    };
+    'too-many-fetchpriority-high': {
+        max: number;
+    };
+    'too-many-preloads': {
+        max: number;
+    };
+    'too-many-preconnects': {
+        max: number;
+    };
+}
+type RuleConfig<Id extends ValidationRuleId> = Id extends keyof ValidationRuleOptions ? RuleSeverity | [severity: RuleSeverity, options: ValidationRuleOptions[Id]] : RuleSeverity;
+type RulesConfig = {
+    [K in ValidationRuleId]?: RuleConfig<K>;
+};
+interface HeadValidationRule {
+    id: ValidationRuleId;
+    message: string;
+    severity: 'warn' | 'info';
+    source?: string;
+    tag?: HeadTag;
+}
+interface ValidatePluginOptions {
+    /**
+     * Callback to handle validation results. Receives all rules found per resolve cycle.
+     * Defaults to `console.warn` for each rule.
+     */
+    onReport?: (rules: HeadValidationRule[]) => void;
+    /**
+     * Configure rule severity and options. Accepts a severity string or an ESLint-style
+     * `[severity, options]` tuple for rules that support configuration.
+     *
+     * @example
+     * ```ts
+     * rules: {
+     *   'missing-description': 'off',
+     *   'too-many-preloads': ['warn', { max: 10 }],
+     *   'inline-style-size': ['info', { maxKB: 20 }],
+     * }
+     * ```
+     */
+    rules?: RulesConfig;
+    /**
+     * Project root path. When set, source locations are displayed as relative paths.
+     */
+    root?: string;
+}
+declare function ValidatePlugin(options?: ValidatePluginOptions): HeadPluginInput;
+
+export { AliasSortingPlugin, CanonicalPlugin, FlatMetaPlugin, InferSeoMetaPlugin, MinifyPlugin, PromisesPlugin, SafeInputPlugin, TemplateParamsPlugin, ValidatePlugin, defineHeadPlugin };
+export type { CanonicalPluginOptions, HeadValidationRule, MinifyPluginOptions, RuleConfig, RuleSeverity, RulesConfig, ValidatePluginOptions, ValidationRuleId, ValidationRuleOptions };