unhead 3.0.0 → 3.0.2

package/dist/client.d.mts

@@ -1,9 +1,9 @@
-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';
+export { C as ClientUnhead, c as createHead } from './shared/unhead.DJ6joC2O.mjs';
+import { R as RenderDomHeadOptions } from './shared/unhead.BXRLaj2l.mjs';
+import { p as HeadRenderer, U as Unhead } from './shared/unhead.DsHmk_XC.mjs';
+export { c as CreateClientHeadOptions } from './shared/unhead.DsHmk_XC.mjs';
 import 'hookable';
-import './shared/unhead.Dyr7L2Ht.mjs';
+import './shared/unhead.BJTN1X0i.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.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';
+export { C as ClientUnhead, c as createHead } from './shared/unhead.CpT6Kxc0.js';
+import { R as RenderDomHeadOptions } from './shared/unhead.YGcEMcjf.js';
+import { p as HeadRenderer, U as Unhead } from './shared/unhead.BRWMyYIW.js';
+export { c as CreateClientHeadOptions } from './shared/unhead.BRWMyYIW.js';
 import 'hookable';
-import './shared/unhead.Dyr7L2Ht.js';
+import './shared/unhead.BJTN1X0i.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.D4TxP3zZ.mjs';
+import { c as createDomRenderer, r as renderDOMHead$1 } from './shared/unhead.pv34ME7O.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.fg-0ge_u.mjs';
-import './shared/unhead.DQiBmCqH.mjs';
+import './shared/unhead.DiRbsb3I.mjs';
 import 'hookable';
 
 const P = { critical: -8, high: -1, low: 2 };

package/dist/index.d.mts

@@ -1,13 +1,62 @@
-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 { U as Unhead, k as HeadEntryOptions, A as ActiveHeadEntry, p as HeadRenderer, d as CreateHeadOptions } from './shared/unhead.DsHmk_XC.mjs';
+import { at as ResolvableHead, b1 as UseSeoMetaInput, J as InferLink, U as Link, K as InferScript, aI as Script } from './shared/unhead.BJTN1X0i.mjs';
+import { H as HeadSafe } from './shared/unhead.CZPkBynw.mjs';
+export { u as useScript } from './shared/unhead.Dp1MlAYz.mjs';
 import 'hookable';
 
 declare function useHead<T extends Unhead<any>, I = ResolvableHead>(unhead: T, input?: ResolvableHead, options?: HeadEntryOptions): ActiveHeadEntry<I>;
 declare function useHeadSafe<T extends Unhead<any>>(unhead: T, input?: HeadSafe, options?: HeadEntryOptions): ActiveHeadEntry<HeadSafe>;
 declare function useSeoMeta<T extends Unhead<any>>(unhead: T, input?: UseSeoMetaInput, options?: HeadEntryOptions): ActiveHeadEntry<UseSeoMetaInput>;
 
+/**
+ * Typed helper for declaring a `<link>` element inside {@link useHead}.
+ *
+ * Known `rel` values stay strict: `rel: 'preload'` still requires `as`,
+ * preload fonts still require `crossorigin`, `rel: 'mask-icon'` still requires
+ * `color`, etc. Non-standard `rel` values not covered by `KnownLinkRel` (e.g.
+ * OpenID endpoints, custom protocol discovery links) are accepted via
+ * `GenericLink` without losing strictness on the rest of the union.
+ *
+ * Standard rels like `'me'`, `'webmention'`, `'privacy-policy'`, and
+ * `'terms-of-service'` are already in the `Link` union, so they work with
+ * `useHead` directly without this helper.
+ *
+ * @example
+ * ```ts
+ * import { defineLink, useHead } from 'unhead'
+ *
+ * useHead({
+ *   link: [
+ *     defineLink({ rel: 'openid2.provider', href: 'https://example.com/openid' }),
+ *     defineLink({ rel: 'EditURI', href: '/rsd.xml', type: 'application/rsd+xml' }),
+ *   ],
+ * })
+ * ```
+ */
+declare function defineLink<const T extends {
+    rel: string;
+}>(link: T & InferLink<T>): Link;
+/**
+ * Typed helper for declaring a `<script>` element inside {@link useHead}.
+ *
+ * Known `type` values stay strict: `type: 'module'` still requires `src` or inline
+ * content, `type: 'application/ld+json'` still requires `textContent`, etc. Custom
+ * or non-standard `type` values (e.g. `'text/plain'`, `'text/html'`) are accepted
+ * via {@link GenericScript} without losing strictness on the rest of the union.
+ *
+ * @example
+ * ```ts
+ * import { defineScript, useHead } from 'unhead'
+ *
+ * useHead({
+ *   script: [
+ *     defineScript({ type: 'text/plain', textContent: 'debug-token' }),
+ *   ],
+ * })
+ * ```
+ */
+declare function defineScript<const T extends object>(script: T & InferScript<T>): Script;
+
 declare function createUnhead<T = ResolvableHead, R = unknown>(renderer: HeadRenderer<R>, resolvedOptions?: CreateHeadOptions): Unhead<T, R>;
 
-export { createUnhead, useHead, useHeadSafe, useSeoMeta };
+export { createUnhead, defineLink, defineScript, useHead, useHeadSafe, useSeoMeta };

package/dist/index.d.ts

@@ -1,13 +1,62 @@
-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 { U as Unhead, k as HeadEntryOptions, A as ActiveHeadEntry, p as HeadRenderer, d as CreateHeadOptions } from './shared/unhead.BRWMyYIW.js';
+import { at as ResolvableHead, b1 as UseSeoMetaInput, J as InferLink, U as Link, K as InferScript, aI as Script } from './shared/unhead.BJTN1X0i.js';
+import { H as HeadSafe } from './shared/unhead.BhElfVXO.js';
+export { u as useScript } from './shared/unhead.DH3TZMHc.js';
 import 'hookable';
 
 declare function useHead<T extends Unhead<any>, I = ResolvableHead>(unhead: T, input?: ResolvableHead, options?: HeadEntryOptions): ActiveHeadEntry<I>;
 declare function useHeadSafe<T extends Unhead<any>>(unhead: T, input?: HeadSafe, options?: HeadEntryOptions): ActiveHeadEntry<HeadSafe>;
 declare function useSeoMeta<T extends Unhead<any>>(unhead: T, input?: UseSeoMetaInput, options?: HeadEntryOptions): ActiveHeadEntry<UseSeoMetaInput>;
 
+/**
+ * Typed helper for declaring a `<link>` element inside {@link useHead}.
+ *
+ * Known `rel` values stay strict: `rel: 'preload'` still requires `as`,
+ * preload fonts still require `crossorigin`, `rel: 'mask-icon'` still requires
+ * `color`, etc. Non-standard `rel` values not covered by `KnownLinkRel` (e.g.
+ * OpenID endpoints, custom protocol discovery links) are accepted via
+ * `GenericLink` without losing strictness on the rest of the union.
+ *
+ * Standard rels like `'me'`, `'webmention'`, `'privacy-policy'`, and
+ * `'terms-of-service'` are already in the `Link` union, so they work with
+ * `useHead` directly without this helper.
+ *
+ * @example
+ * ```ts
+ * import { defineLink, useHead } from 'unhead'
+ *
+ * useHead({
+ *   link: [
+ *     defineLink({ rel: 'openid2.provider', href: 'https://example.com/openid' }),
+ *     defineLink({ rel: 'EditURI', href: '/rsd.xml', type: 'application/rsd+xml' }),
+ *   ],
+ * })
+ * ```
+ */
+declare function defineLink<const T extends {
+    rel: string;
+}>(link: T & InferLink<T>): Link;
+/**
+ * Typed helper for declaring a `<script>` element inside {@link useHead}.
+ *
+ * Known `type` values stay strict: `type: 'module'` still requires `src` or inline
+ * content, `type: 'application/ld+json'` still requires `textContent`, etc. Custom
+ * or non-standard `type` values (e.g. `'text/plain'`, `'text/html'`) are accepted
+ * via {@link GenericScript} without losing strictness on the rest of the union.
+ *
+ * @example
+ * ```ts
+ * import { defineScript, useHead } from 'unhead'
+ *
+ * useHead({
+ *   script: [
+ *     defineScript({ type: 'text/plain', textContent: 'debug-token' }),
+ *   ],
+ * })
+ * ```
+ */
+declare function defineScript<const T extends object>(script: T & InferScript<T>): Script;
+
 declare function createUnhead<T = ResolvableHead, R = unknown>(renderer: HeadRenderer<R>, resolvedOptions?: CreateHeadOptions): Unhead<T, R>;
 
-export { createUnhead, useHead, useHeadSafe, useSeoMeta };
+export { createUnhead, defineLink, defineScript, useHead, useHeadSafe, useSeoMeta };

package/dist/index.mjs

@@ -35,4 +35,11 @@ function useSeoMeta(unhead, input = {}, options) {
   return entry;
 }
 
-export { useHead, useHeadSafe, useSeoMeta };
+function defineLink(link) {
+  return link;
+}
+function defineScript(script) {
+  return script;
+}
+
+export { defineLink, defineScript, useHead, useHeadSafe, useSeoMeta };

package/dist/parser.d.mts

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

package/dist/parser.d.ts

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

package/dist/plugins.d.mts

@@ -1,5 +1,5 @@
-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 { n as HeadPluginInput, U as Unhead, o as HeadPluginOptions } from './shared/unhead.DsHmk_XC.mjs';
+import { t as HeadTag } from './shared/unhead.BJTN1X0i.mjs';
 import 'hookable';
 
 declare const AliasSortingPlugin: HeadPluginInput;

package/dist/plugins.d.ts

@@ -1,5 +1,5 @@
-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 { n as HeadPluginInput, U as Unhead, o as HeadPluginOptions } from './shared/unhead.BRWMyYIW.js';
+import { t as HeadTag } from './shared/unhead.BJTN1X0i.js';
 import 'hookable';
 
 declare const AliasSortingPlugin: HeadPluginInput;

package/dist/scripts.d.mts

@@ -1,8 +1,8 @@
-import { R as RecordingEntry } from './shared/unhead.D6A03PN3.mjs';
-export { a as AsVoidFunctions, j as EventHandlerOptions, u as ScriptInstance, z as UseFunctionType, B as UseScriptContext, F as UseScriptInput, G as UseScriptOptions, I as UseScriptResolvedInput, J as UseScriptReturn, K as UseScriptStatus, W as WarmupStrategy } from './shared/unhead.D6A03PN3.mjs';
-export { u as useScript } from './shared/unhead.DyN7hSCT.mjs';
+import { R as RecordingEntry } from './shared/unhead.DsHmk_XC.mjs';
+export { a as AsVoidFunctions, j as EventHandlerOptions, u as ScriptInstance, z as UseFunctionType, B as UseScriptContext, F as UseScriptInput, G as UseScriptOptions, I as UseScriptResolvedInput, J as UseScriptReturn, K as UseScriptStatus, W as WarmupStrategy } from './shared/unhead.DsHmk_XC.mjs';
+export { u as useScript } from './shared/unhead.Dp1MlAYz.mjs';
 import 'hookable';
-import './shared/unhead.Dyr7L2Ht.mjs';
+import './shared/unhead.BJTN1X0i.mjs';
 
 declare function createSpyProxy<T extends Record<string, any> | any[]>(target: T, onApply: (stack: RecordingEntry[][]) => void): T;
 

package/dist/scripts.d.ts

@@ -1,8 +1,8 @@
-import { R as RecordingEntry } from './shared/unhead.DmIUoNyg.js';
-export { a as AsVoidFunctions, j as EventHandlerOptions, u as ScriptInstance, z as UseFunctionType, B as UseScriptContext, F as UseScriptInput, G as UseScriptOptions, I as UseScriptResolvedInput, J as UseScriptReturn, K as UseScriptStatus, W as WarmupStrategy } from './shared/unhead.DmIUoNyg.js';
-export { u as useScript } from './shared/unhead.Cp3HtzBy.js';
+import { R as RecordingEntry } from './shared/unhead.BRWMyYIW.js';
+export { a as AsVoidFunctions, j as EventHandlerOptions, u as ScriptInstance, z as UseFunctionType, B as UseScriptContext, F as UseScriptInput, G as UseScriptOptions, I as UseScriptResolvedInput, J as UseScriptReturn, K as UseScriptStatus, W as WarmupStrategy } from './shared/unhead.BRWMyYIW.js';
+export { u as useScript } from './shared/unhead.DH3TZMHc.js';
 import 'hookable';
-import './shared/unhead.Dyr7L2Ht.js';
+import './shared/unhead.BJTN1X0i.js';
 
 declare function createSpyProxy<T extends Record<string, any> | any[]>(target: T, onApply: (stack: RecordingEntry[][]) => void): T;
 

package/dist/server.d.mts

@@ -1,7 +1,7 @@
-export { S as ServerUnhead, c as createHead } from './shared/unhead.B825tVHL.mjs';
-import { r as RenderSSRHeadOptions, p as HeadRenderer, s as SSRHeadPayload, U as Unhead } from './shared/unhead.D6A03PN3.mjs';
-export { e as CreateServerHeadOptions } from './shared/unhead.D6A03PN3.mjs';
-import { p as HeadTag } from './shared/unhead.Dyr7L2Ht.mjs';
+export { S as ServerUnhead, c as createHead } from './shared/unhead.C6alnWbQ.mjs';
+import { r as RenderSSRHeadOptions, p as HeadRenderer, s as SSRHeadPayload, U as Unhead } from './shared/unhead.DsHmk_XC.mjs';
+export { e as CreateServerHeadOptions } from './shared/unhead.DsHmk_XC.mjs';
+import { t as HeadTag } from './shared/unhead.BJTN1X0i.mjs';
 import 'hookable';
 
 declare function createServerRenderer(options?: RenderSSRHeadOptions): HeadRenderer<SSRHeadPayload>;

package/dist/server.d.ts

@@ -1,7 +1,7 @@
-export { S as ServerUnhead, c as createHead } from './shared/unhead.cnX_MFeG.js';
-import { r as RenderSSRHeadOptions, p as HeadRenderer, s as SSRHeadPayload, U as Unhead } from './shared/unhead.DmIUoNyg.js';
-export { e as CreateServerHeadOptions } from './shared/unhead.DmIUoNyg.js';
-import { p as HeadTag } from './shared/unhead.Dyr7L2Ht.js';
+export { S as ServerUnhead, c as createHead } from './shared/unhead.D4KaR-FM.js';
+import { r as RenderSSRHeadOptions, p as HeadRenderer, s as SSRHeadPayload, U as Unhead } from './shared/unhead.BRWMyYIW.js';
+export { e as CreateServerHeadOptions } from './shared/unhead.BRWMyYIW.js';
+import { t as HeadTag } from './shared/unhead.BJTN1X0i.js';
 import 'hookable';
 
 declare function createServerRenderer(options?: RenderSSRHeadOptions): HeadRenderer<SSRHeadPayload>;

package/dist/server.mjs

@@ -1,10 +1,10 @@
-import { r as renderSSRHead$1 } from './shared/unhead.Sr8_Iw6G.mjs';
-export { a as capoTagWeight, c as createHead, b as createServerRenderer, e as escapeHtml, p as propsToString, s as ssrRenderTags, t as tagToString } from './shared/unhead.Sr8_Iw6G.mjs';
+import { r as renderSSRHead$1 } from './shared/unhead.C5ypJnIO.mjs';
+export { a as capoTagWeight, c as createHead, b as createServerRenderer, e as escapeHtml, p as propsToString, s as ssrRenderTags, t as tagToString } from './shared/unhead.C5ypJnIO.mjs';
 import { parseHtmlForUnheadExtraction, applyHeadToHtml, parseHtmlForIndexes } from './parser.mjs';
 import './shared/unhead.CfgPMHXt.mjs';
 import './shared/unhead.DvIxXxuO.mjs';
 import 'hookable';
-import './shared/unhead.DQiBmCqH.mjs';
+import './shared/unhead.DiRbsb3I.mjs';
 import './shared/unhead.fg-0ge_u.mjs';
 
 // @__NO_SIDE_EFFECTS__