unhead 3.0.0-rc.4 → 3.0.1

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.BxsOjg-Q.mjs';
+import { R as RenderDomHeadOptions } from './shared/unhead.BAv4ddL5.mjs';
+import { p as HeadRenderer, U as Unhead } from './shared/unhead.CyKsApKH.mjs';
+export { c as CreateClientHeadOptions } from './shared/unhead.CyKsApKH.mjs';
 import 'hookable';
-import './shared/unhead.Dyr7L2Ht.mjs';
+import './shared/unhead.5pUZeb0i.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.D_sLwV5L.js';
+import { R as RenderDomHeadOptions } from './shared/unhead.JGBJYEOZ.js';
+import { p as HeadRenderer, U as Unhead } from './shared/unhead.BEof8Qjb.js';
+export { c as CreateClientHeadOptions } from './shared/unhead.BEof8Qjb.js';
 import 'hookable';
-import './shared/unhead.Dyr7L2Ht.js';
+import './shared/unhead.5pUZeb0i.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.CyKsApKH.mjs';
+import { as as ResolvableHead, b0 as UseSeoMetaInput, z as InferLink, T as Link, J as InferScript, aH as Script } from './shared/unhead.5pUZeb0i.mjs';
+import { H as HeadSafe } from './shared/unhead.CUEmFl2d.mjs';
+export { u as useScript } from './shared/unhead.dhQT0IKI.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.BEof8Qjb.js';
+import { as as ResolvableHead, b0 as UseSeoMetaInput, z as InferLink, T as Link, J as InferScript, aH as Script } from './shared/unhead.5pUZeb0i.js';
+import { H as HeadSafe } from './shared/unhead.UFdAtJOd.js';
+export { u as useScript } from './shared/unhead.vQPF0cJs.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 { aL as SerializableHead } from './shared/unhead.5pUZeb0i.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 { aL as SerializableHead } from './shared/unhead.5pUZeb0i.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.CyKsApKH.mjs';
+import { s as HeadTag } from './shared/unhead.5pUZeb0i.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.BEof8Qjb.js';
+import { s as HeadTag } from './shared/unhead.5pUZeb0i.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.CyKsApKH.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.CyKsApKH.mjs';
+export { u as useScript } from './shared/unhead.dhQT0IKI.mjs';
 import 'hookable';
-import './shared/unhead.Dyr7L2Ht.mjs';
+import './shared/unhead.5pUZeb0i.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.BEof8Qjb.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.BEof8Qjb.js';
+export { u as useScript } from './shared/unhead.vQPF0cJs.js';
 import 'hookable';
-import './shared/unhead.Dyr7L2Ht.js';
+import './shared/unhead.5pUZeb0i.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.DvMT2vYs.mjs';
+import { r as RenderSSRHeadOptions, p as HeadRenderer, s as SSRHeadPayload, U as Unhead } from './shared/unhead.CyKsApKH.mjs';
+export { e as CreateServerHeadOptions } from './shared/unhead.CyKsApKH.mjs';
+import { s as HeadTag } from './shared/unhead.5pUZeb0i.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.BRPfhzdc.js';
+import { r as RenderSSRHeadOptions, p as HeadRenderer, s as SSRHeadPayload, U as Unhead } from './shared/unhead.BEof8Qjb.js';
+export { e as CreateServerHeadOptions } from './shared/unhead.BEof8Qjb.js';
+import { s as HeadTag } from './shared/unhead.5pUZeb0i.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__

package/dist/shared/{unhead.Dyr7L2Ht.d.mts → unhead.5pUZeb0i.d.mts}

@@ -878,20 +878,97 @@ interface PingbackLink extends LinkBase {
     rel: 'pingback';
     href: string;
 }
+/**
+ * Me link. Identifies the resource as representing the current user
+ * (IndieWeb / rel-me verification, Mastodon profile verification).
+ *
+ * @see https://html.spec.whatwg.org/multipage/links.html#link-type-me
+ */
+interface MeLink extends LinkBase {
+    rel: 'me';
+    href: string;
+}
+/**
+ * Privacy policy link.
+ *
+ * @see https://html.spec.whatwg.org/multipage/links.html#link-type-privacy-policy
+ */
+interface PrivacyPolicyLink extends LinkBase {
+    rel: 'privacy-policy';
+    href: string;
+}
+/**
+ * Terms of service link.
+ *
+ * @see https://html.spec.whatwg.org/multipage/links.html#link-type-terms-of-service
+ */
+interface TermsOfServiceLink extends LinkBase {
+    rel: 'terms-of-service';
+    href: string;
+}
+/**
+ * Expect link. Blocks rendering until a named element is present and ready.
+ *
+ * @see https://html.spec.whatwg.org/multipage/links.html#link-type-expect
+ */
+interface ExpectLink extends LinkBase {
+    rel: 'expect';
+    href: string;
+    blocking?: 'render';
+}
+/**
+ * Webmention endpoint link (IndieWeb).
+ *
+ * @see https://www.w3.org/TR/webmention/
+ */
+interface WebmentionLink extends LinkBase {
+    rel: 'webmention';
+    href: string;
+}
+/**
+ * Compression dictionary link (experimental).
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/link#compression-dictionary
+ */
+interface CompressionDictionaryLink extends LinkBase {
+    rel: 'compression-dictionary';
+    href: string;
+}
+/**
+ * Alternate stylesheet link. User-selectable alternate stylesheet.
+ * Requires a `title` to appear in the browser's stylesheet picker.
+ *
+ * @see https://html.spec.whatwg.org/multipage/semantics.html#rel-alternate-stylesheet
+ */
+interface AlternateStylesheetLink extends LinkBase, LinkHttpEvents {
+    rel: 'alternate stylesheet';
+    href: string;
+    title: string;
+    media?: string;
+    crossorigin?: '' | 'anonymous' | 'use-credentials';
+    integrity?: string;
+    type?: 'text/css' | (string & Record<never, never>);
+    disabled?: boolean;
+}
 /**
  * Union of all `rel` values that have narrowed link type definitions.
  * Useful for building type guards or conditional logic based on `rel` values.
  */
-type KnownLinkRel = 'stylesheet' | 'preload' | 'modulepreload' | 'prefetch' | 'icon' | 'shortcut icon' | 'apple-touch-icon' | 'mask-icon' | 'manifest' | 'canonical' | 'dns-prefetch' | 'preconnect' | 'prerender' | 'alternate' | 'author' | 'license' | 'help' | 'search' | 'prev' | 'next' | 'pingback';
+type KnownLinkRel = 'stylesheet' | 'alternate stylesheet' | 'preload' | 'modulepreload' | 'prefetch' | 'icon' | 'shortcut icon' | 'apple-touch-icon' | 'mask-icon' | 'manifest' | 'canonical' | 'dns-prefetch' | 'preconnect' | 'prerender' | 'alternate' | 'author' | 'license' | 'help' | 'search' | 'prev' | 'next' | 'pingback' | 'me' | 'webmention' | 'privacy-policy' | 'terms-of-service' | 'expect' | 'compression-dictionary';
 /**
  * Fallback for custom or unknown `rel` types.
  *
- * Not included in the {@link Link} union to prevent silent absorption of known `rel` values.
- * Use this type explicitly when you need a non-standard `rel` value:
+ * Not included in the {@link Link} union to prevent silent absorption of known
+ * `rel` values (e.g. so `rel: 'preload'` without `as` stays an error instead of
+ * collapsing into this permissive shape).
+ *
+ * For non-standard `rel` values not covered by {@link KnownLinkRel}, prefer
+ * {@link defineLink}, which enforces strict narrowing on known rels while
+ * accepting `GenericLink` for anything else:
  *
  * ```ts
- * import type { GenericLink } from 'unhead/types'
- * useHead({ link: [{ rel: 'me', href: '...' } satisfies GenericLink] })
+ * import { defineLink } from 'unhead'
+ * useHead({ link: [defineLink({ rel: 'openid2.provider', href: 'https://...' })] })
  * ```
  */
 interface GenericLink extends LinkBase {
@@ -918,15 +995,33 @@ interface GenericLink extends LinkBase {
  * attributes. For example, `rel="preload"` requires the `as` attribute (see {@link PreloadLink}),
  * and `rel="mask-icon"` requires `color` (see {@link MaskIconLink}).
  *
- * For custom or non-standard `rel` values, use {@link GenericLink} directly:
+ * For non-standard `rel` values not covered by {@link KnownLinkRel}, use {@link defineLink}:
  * ```ts
- * import type { GenericLink } from 'unhead/types'
- * useHead({ link: [{ rel: 'me', href: '...' } satisfies GenericLink] })
+ * import { defineLink } from 'unhead'
+ * useHead({ link: [defineLink({ rel: 'openid2.provider', href: 'https://...' })] })
  * ```
  *
  * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel
  */
-type Link = StylesheetLink | PreloadLink | ModulepreloadLink | PrefetchLink | FaviconLink | AppleTouchIconLink | MaskIconLink | ManifestLink | CanonicalLink | DnsPrefetchLink | PreconnectLink | PrerenderLink | AlternateLanguageLink | AlternateFeedLink | AlternateMediaLink | BareAlternateLink | AuthorLink | LicenseLink | HelpLink | SearchLink | PrevLink | NextLink | PingbackLink;
+type Link = StylesheetLink | AlternateStylesheetLink | PreloadLink | ModulepreloadLink | PrefetchLink | FaviconLink | AppleTouchIconLink | MaskIconLink | ManifestLink | CanonicalLink | DnsPrefetchLink | PreconnectLink | PrerenderLink | AlternateLanguageLink | AlternateFeedLink | AlternateMediaLink | BareAlternateLink | AuthorLink | LicenseLink | HelpLink | SearchLink | PrevLink | NextLink | PingbackLink | MeLink | WebmentionLink | PrivacyPolicyLink | TermsOfServiceLink | ExpectLink | CompressionDictionaryLink;
+/**
+ * Pick {@link Link} union members whose `rel` accepts `R`.
+ *
+ * Unlike `Extract<Link, { rel: R }>`, this handles members whose `rel` is itself
+ * a union (e.g. {@link FaviconLink}'s `'icon' | 'shortcut icon'`).
+ */
+type MatchLinkByRel<R> = Link extends infer M ? M extends {
+    rel: infer MR;
+} ? R extends MR ? M : never : never : never;
+/**
+ * Resolve a single link input to either its strict {@link Link} variant (when
+ * `rel` is a {@link KnownLinkRel}) or {@link GenericLink} (for custom rels).
+ */
+type InferLink<T> = T extends {
+    rel: infer R;
+} ? R extends KnownLinkRel ? MatchLinkByRel<R> : R extends string ? GenericLink & {
+    rel: R;
+} : never : never;
 
 /**
  * Known meta name values
@@ -2109,14 +2204,16 @@ interface NoLoadableScriptProps {
     nomodule?: never;
 }
 /**
- * Content for data scripts - either textContent or innerHTML, not both
+ * Content for data scripts — requires exactly one of `textContent` or
+ * `innerHTML`. Data scripts (JSON-LD, speculation rules, application/json) must
+ * carry inline content; an empty payload is invalid.
  */
 type DataScriptTextContent<T = string | Record<string, unknown>> = {
     /**
      * Sets the textContent of an element. Safer for XSS.
      * Can be a string or an object that will be serialized to JSON.
      */
-    textContent?: T;
+    textContent: T;
     innerHTML?: never;
 } | {
     textContent?: never;
@@ -2124,7 +2221,7 @@ type DataScriptTextContent<T = string | Record<string, unknown>> = {
      * Sets the innerHTML of an element.
      * Can be a string or an object that will be serialized to JSON.
      */
-    innerHTML?: T;
+    innerHTML: T;
 };
 /**
  * External JavaScript (fires events)
@@ -2307,7 +2404,7 @@ interface ImportMapConfig {
     scopes?: Record<string, Record<string, string>>;
 }
 /**
- * Import map
+ * Import map. Requires either `textContent` (recommended) or `innerHTML`.
  */
 type ImportMapScript = ScriptBase & NoLoadableScriptProps & {
     /**
@@ -2317,13 +2414,15 @@ type ImportMapScript = ScriptBase & NoLoadableScriptProps & {
      * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#attr-type
      */
     type: 'importmap';
-    /**
-     * Sets the textContent of an element.
-     * Can be a string or an ImportMapConfig object that will be serialized to JSON.
-     */
+} & ({
+    /** Import map content as a string or ImportMapConfig object (auto-serialized). */
     textContent: string | ImportMapConfig;
     innerHTML?: never;
-};
+} | {
+    textContent?: never;
+    /** Import map content as a string or ImportMapConfig object (auto-serialized). */
+    innerHTML: string | ImportMapConfig;
+});
 /**
  * Application JSON script (generic JSON data)
  */
@@ -2339,12 +2438,16 @@ type ApplicationJsonScript = ScriptBase & NoLoadableScriptProps & DataScriptText
 /**
  * Fallback for custom or unknown `type` values.
  *
- * Not included in the {@link Script} union to prevent silent absorption of known `type` values.
- * Use this type explicitly when you need a non-standard `type` value:
+ * Not included in the {@link Script} union to prevent silent absorption of known
+ * `type` values (e.g. so `type: 'module'` without `src` or inline content stays
+ * an error instead of collapsing into this permissive shape).
+ *
+ * For custom `type` values, prefer {@link defineScript}, which enforces strict
+ * narrowing on known types while accepting `GenericScript` for anything else:
  *
  * ```ts
- * import type { GenericScript } from 'unhead/types'
- * useHead({ script: [{ type: 'text/plain', textContent: '...' } satisfies GenericScript] })
+ * import { defineScript } from 'unhead'
+ * useHead({ script: [defineScript({ type: 'text/plain', textContent: '...' })] })
  * ```
  */
 interface GenericScript extends ScriptBase, ScriptHttpEvents {
@@ -2420,13 +2523,38 @@ interface GenericScript extends ScriptBase, ScriptHttpEvents {
  * Each `type` value maps to a specific interface that enforces per-type constraints.
  * For example, inline scripts require `textContent` and forbid `src`/`async`/`defer`.
  *
- * For custom or non-standard `type` values, use {@link GenericScript} directly:
+ * For custom or non-standard `type` values, use {@link defineScript}:
  * ```ts
- * import type { GenericScript } from 'unhead/types'
- * useHead({ script: [{ type: 'text/plain', textContent: '...' } satisfies GenericScript] })
+ * import { defineScript } from 'unhead'
+ * useHead({ script: [defineScript({ type: 'text/plain', textContent: '...' })] })
  * ```
  */
 type Script = ExternalScript | ModuleScript | InlineScript | InlineModuleScript | JsonLdScript | SpeculationRulesScript | ImportMapScript | ApplicationJsonScript;
+/**
+ * Union of all `type` values that have narrowed script type definitions.
+ */
+type KnownScriptType = '' | 'text/javascript' | 'module' | 'application/ld+json' | 'speculationrules' | 'importmap' | 'application/json';
+/**
+ * Pick {@link Script} union members whose `type` accepts `U`.
+ *
+ * Handles members whose `type` is itself a union (e.g. {@link ExternalScript}'s
+ * `'' | 'text/javascript'`), and members where `type` is optional.
+ */
+type MatchScriptByType<U> = Script extends infer M ? M extends {
+    type?: infer MT;
+} ? U extends MT ? M : never : never : never;
+/**
+ * Resolve a single script input to either its strict {@link Script} variant (when
+ * `type` is a {@link KnownScriptType}) or {@link GenericScript} (for custom types).
+ *
+ * When no `type` field is present, or `type` is non-string, the full {@link Script}
+ * union is returned so discriminators like `src` vs `textContent` still apply.
+ */
+type InferScript<T> = T extends {
+    type: infer U;
+} ? U extends string ? U extends KnownScriptType ? MatchScriptByType<U> : GenericScript & {
+    type: U;
+} : Script : Script;
 
 interface Style extends Pick<GlobalAttributes, 'nonce' | 'id'>, Blocking {
     /**
@@ -2745,4 +2873,4 @@ interface HeadTag extends TagPriority, TagPosition, ResolvesDuplicates, HasTempl
 }
 type HeadTagKeys = (keyof HeadTag)[];
 
-export type { ModulepreloadLink as $, AlternateFeedLink as A, Booleanable as B, CanonicalLink as C, DataKeys as D, ExternalScript as E, FaviconLink as F, GenericLink as G, HasTemplateParams as H, IconLink as I, InternalTagKey as J, JsonLdScript as K, KnownLinkRel as L, LicenseLink as M, Link as N, LinkBase as O, LinkHttpEvents as P, ManifestLink as Q, MaskIconLink as R, MaybeArray as S, MaybeEventFnHandlers as T, Meta as U, MetaBase as V, MetaFlat as W, MetaGeneric as X, MetaNames as Y, MetaProperties as Z, ModuleScript as _, AlternateLanguageLink as a, NameMeta as a0, Never as a1, NextLink as a2, PingbackLink as a3, PreconnectLink as a4, PrefetchLink as a5, PreloadFontLink as a6, PreloadImageLink as a7, PreloadLink as a8, PreloadLinkBase as a9, ScriptBase as aA, ScriptHttpEvents as aB, SearchLink as aC, SerializableHead as aD, SpeculationRules as aE, SpeculationRulesScript as aF, StringInnerContent as aG, Stringable as aH, StylesheetLink as aI, TagKey as aJ, TagPosition as aK, TagPriority as aL, TagUserProperties as aM, TemplateParams as aN, TemplateParamsAugmentations as aO, UnheadBodyAttributesWithoutEvents as aP, UnheadHtmlAttributes as aQ, UnheadMeta as aR, UseHeadInput as aS, UseSeoMetaInput as aT, ValidTagPositions as aU, PreloadOtherLink as aa, PreloadScriptLink as ab, PreloadStyleLink as ac, PrerenderLink as ad, PrevLink as ae, ProcessesTemplateParams as af, PropertyMeta as ag, RawInput as ah, ResolvableBase as ai, ResolvableBodyAttributes as aj, ResolvableHead as ak, ResolvableHtmlAttributes as al, ResolvableLink as am, ResolvableMeta as an, ResolvableNoscript as ao, ResolvableProperties as ap, ResolvableScript as aq, ResolvableStyle as ar, ResolvableTemplateParams as as, ResolvableTitle as at, ResolvableTitleTemplate as au, ResolvableUnion as av, ResolvableValue as aw, ResolvesDuplicates as ax, SchemaAugmentations as ay, Script as az, AlternateLink as b, AlternateMediaLink as c, AppleTouchIconLink as d, ApplicationJsonScript as e, Arrayable as f, AuthorLink as g, BareAlternateLink as h, BodyAttributesWithoutEvents as i, BodyEvents as j, CharsetMeta as k, DeepResolvableProperties as l, DnsPrefetchLink as m, GenericScript as n, GlobalAttributes as o, HeadTag as p, HeadTagKeys as q, HelpLink as r, HttpEquivMeta as s, HttpEventAttributes as t, ImportMapConfig as u, ImportMapScript as v, InlineModuleScript as w, InlineScript as x, InnerContent as y, InnerContentVal as z };
+export type { Meta as $, AlternateFeedLink as A, Booleanable as B, CanonicalLink as C, DataKeys as D, ExpectLink as E, FaviconLink as F, GenericLink as G, HasTemplateParams as H, IconLink as I, InferScript as J, InlineModuleScript as K, InlineScript as L, InnerContent as M, InnerContentVal as N, InternalTagKey as O, JsonLdScript as P, KnownLinkRel as Q, KnownScriptType as R, LicenseLink as S, Link as T, LinkBase as U, LinkHttpEvents as V, ManifestLink as W, MaskIconLink as X, MaybeArray as Y, MaybeEventFnHandlers as Z, MeLink as _, AlternateLanguageLink as a, UseHeadInput as a$, MetaBase as a0, MetaFlat as a1, MetaGeneric as a2, MetaNames as a3, MetaProperties as a4, ModuleScript as a5, ModulepreloadLink as a6, NameMeta as a7, Never as a8, NextLink as a9, ResolvableTemplateParams as aA, ResolvableTitle as aB, ResolvableTitleTemplate as aC, ResolvableUnion as aD, ResolvableValue as aE, ResolvesDuplicates as aF, SchemaAugmentations as aG, Script as aH, ScriptBase as aI, ScriptHttpEvents as aJ, SearchLink as aK, SerializableHead as aL, SpeculationRules as aM, SpeculationRulesScript as aN, StringInnerContent as aO, Stringable as aP, StylesheetLink as aQ, TagKey as aR, TagPosition as aS, TagPriority as aT, TagUserProperties as aU, TemplateParams as aV, TemplateParamsAugmentations as aW, TermsOfServiceLink as aX, UnheadBodyAttributesWithoutEvents as aY, UnheadHtmlAttributes as aZ, UnheadMeta as a_, PingbackLink as aa, PreconnectLink as ab, PrefetchLink as ac, PreloadFontLink as ad, PreloadImageLink as ae, PreloadLink as af, PreloadLinkBase as ag, PreloadOtherLink as ah, PreloadScriptLink as ai, PreloadStyleLink as aj, PrerenderLink as ak, PrevLink as al, PrivacyPolicyLink as am, ProcessesTemplateParams as an, PropertyMeta as ao, RawInput as ap, ResolvableBase as aq, ResolvableBodyAttributes as ar, ResolvableHead as as, ResolvableHtmlAttributes as at, ResolvableLink as au, ResolvableMeta as av, ResolvableNoscript as aw, ResolvableProperties as ax, ResolvableScript as ay, ResolvableStyle as az, AlternateLink as b, UseSeoMetaInput as b0, ValidTagPositions as b1, WebmentionLink as b2, AlternateMediaLink as c, AlternateStylesheetLink as d, AppleTouchIconLink as e, ApplicationJsonScript as f, Arrayable as g, AuthorLink as h, BareAlternateLink as i, BodyAttributesWithoutEvents as j, BodyEvents as k, CharsetMeta as l, CompressionDictionaryLink as m, DeepResolvableProperties as n, DnsPrefetchLink as o, ExternalScript as p, GenericScript as q, GlobalAttributes as r, HeadTag as s, HeadTagKeys as t, HelpLink as u, HttpEquivMeta as v, HttpEventAttributes as w, ImportMapConfig as x, ImportMapScript as y, InferLink as z };