unhead 3.0.1 → 3.0.3

package/dist/shared/unhead.CH30252c.mjs

@@ -0,0 +1,129 @@
+import { d as defineHeadPlugin } from './unhead.CUXLLRtV.mjs';
+import { p as processTemplateParams } from './unhead.BGFxPGPQ.mjs';
+
+const sortTags = (a, b) => a._w === b._w ? a._p - b._p : a._w - b._w;
+const formatKey = (k) => !k.includes(":key") ? k.split(":").join(":key:") : k;
+const AliasSortingPlugin = defineHeadPlugin({
+  key: "aliasSorting",
+  hooks: {
+    "tags:resolve": (ctx) => {
+      let m = false;
+      for (const t of ctx.tags) {
+        const p = t.tagPriority;
+        if (!p)
+          continue;
+        const s = String(p);
+        if (s.startsWith("before:")) {
+          const k = formatKey(s.slice(7));
+          const l = ctx.tagMap.get(k);
+          if (l) {
+            if (typeof l.tagPriority === "number")
+              t.tagPriority = l.tagPriority;
+            t._p = l._p - 1;
+            m = true;
+          }
+        } else if (s.startsWith("after:")) {
+          const k = formatKey(s.slice(6));
+          const l = ctx.tagMap.get(k);
+          if (l) {
+            if (typeof l.tagPriority === "number")
+              t.tagPriority = l.tagPriority;
+            t._p = l._p + 1;
+            m = true;
+          }
+        }
+      }
+      if (m)
+        ctx.tags = ctx.tags.sort(sortTags);
+    }
+  }
+});
+
+async function walkPromises(v) {
+  const type = typeof v;
+  if (type === "function") {
+    return v;
+  }
+  if (v instanceof Promise) {
+    return await v;
+  }
+  if (Array.isArray(v)) {
+    return await Promise.all(v.map((r) => walkPromises(r)));
+  }
+  if (v?.constructor === Object) {
+    const next = {};
+    for (const key of Object.keys(v)) {
+      next[key] = await walkPromises(v[key]);
+    }
+    return next;
+  }
+  return v;
+}
+const PromisesPlugin = /* @__PURE__ */ defineHeadPlugin({
+  key: "promises",
+  hooks: {
+    "entries:resolve": async (ctx) => {
+      const promises = [];
+      for (const k in ctx.entries) {
+        if (!ctx.entries[k]._promisesProcessed) {
+          promises.push(
+            walkPromises(ctx.entries[k].input).then((val) => {
+              ctx.entries[k].input = val;
+              ctx.entries[k]._promisesProcessed = true;
+            })
+          );
+        }
+      }
+      await Promise.all(promises);
+    }
+  }
+});
+
+const SupportedAttrs = {
+  meta: "content",
+  link: "href",
+  htmlAttrs: "lang"
+};
+const contentAttrs = ["innerHTML", "textContent"];
+const TemplateParamsPlugin = /* @__PURE__ */ defineHeadPlugin((head) => {
+  return {
+    key: "template-params",
+    hooks: {
+      "tags:resolve": ({ tagMap, tags }) => {
+        const params = tagMap.get("templateParams")?.props || {};
+        const sep = params.separator || "|";
+        delete params.separator;
+        params.pageTitle = processTemplateParams(
+          // find templateParams
+          params.pageTitle || head._title || "",
+          params,
+          sep
+        );
+        for (const tag of tags) {
+          if (tag.processTemplateParams === false) {
+            continue;
+          }
+          const v = SupportedAttrs[tag.tag];
+          if (v && typeof tag.props[v] === "string") {
+            tag.props[v] = processTemplateParams(tag.props[v], params, sep);
+          } else if (tag.processTemplateParams || tag.tag === "titleTemplate" || tag.tag === "title") {
+            for (const p of contentAttrs) {
+              if (typeof tag[p] === "string")
+                tag[p] = processTemplateParams(tag[p], params, sep, tag.tag === "script" && tag.props.type.endsWith("json"));
+            }
+          }
+        }
+        head._templateParams = params;
+        head._separator = sep;
+      },
+      "tags:afterResolve": ({ tagMap }) => {
+        const title = tagMap.get("title");
+        if (title?.textContent && title.processTemplateParams !== false) {
+          title.textContent = processTemplateParams(title.textContent, head._templateParams, head._separator);
+        }
+      }
+    }
+  };
+});
+
+export { AliasSortingPlugin as A, PromisesPlugin as P, TemplateParamsPlugin as T };

package/dist/shared/{unhead.BxsOjg-Q.d.mts → unhead.CSqfLsrn.d.mts}

@@ -1,6 +1,6 @@
 import { HookableCore } from 'hookable';
-import { U as Unhead, C as ClientHeadHooks, c as CreateClientHeadOptions } from './unhead.CyKsApKH.mjs';
-import { as as ResolvableHead } from './unhead.5pUZeb0i.mjs';
+import { U as Unhead, C as ClientHeadHooks, c as CreateClientHeadOptions } from './unhead.DFLvtb3Z.mjs';
+import { at as ResolvableHead } from './unhead.DBv5uRwR.mjs';
 
 interface ClientUnhead<T = ResolvableHead> extends Unhead<T, boolean> {
     hooks: HookableCore<ClientHeadHooks>;

package/dist/shared/unhead.CUXLLRtV.mjs

@@ -0,0 +1,5 @@
+function defineHeadPlugin(plugin) {
+  return plugin;
+}
+
+export { defineHeadPlugin as d };

package/dist/shared/{unhead.BEof8Qjb.d.ts → unhead.CZmLNN-R.d.ts}

@@ -1,5 +1,5 @@
 import { HookableCore } from 'hookable';
-import { q as GenericScript, aJ as ScriptHttpEvents, D as DataKeys, Z as MaybeEventFnHandlers, w as HttpEventAttributes, aG as SchemaAugmentations, s as HeadTag, as as ResolvableHead, aS as TagPosition, aT as TagPriority, an as ProcessesTemplateParams, aF as ResolvesDuplicates, aV as TemplateParams } from './unhead.5pUZeb0i.js';
+import { r as GenericScript, aK as ScriptHttpEvents, D as DataKeys, _ as MaybeEventFnHandlers, x as HttpEventAttributes, aH as SchemaAugmentations, t as HeadTag, at as ResolvableHead, aT as TagPosition, aU as TagPriority, ao as ProcessesTemplateParams, aG as ResolvesDuplicates, aW as TemplateParams } from './unhead.DBv5uRwR.js';
 
 type UseScriptStatus = 'awaitingLoad' | 'loading' | 'loaded' | 'error' | 'removed';
 type UseScriptContext<T extends Record<symbol | string, any>> = ScriptInstance<T>;

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

@@ -16,6 +16,14 @@ type _ResolvablePropertiesRaw<T> = {
 };
 type ResolvableProperties<T> = Prettify<_ResolvablePropertiesRaw<T>>;
 type ResolvableUnion<T> = T extends string | number | boolean ? ResolvableValue<T> : T extends object ? DeepResolvableProperties<T> : ResolvableValue<T>;
+/**
+ * Recursively marks all properties and arrays as readonly.
+ * Applied to `InferScript`/`InferLink` return types so that
+ * `defineScript`/`defineLink` accept both mutable and `as const` inputs.
+ */
+type DeepReadonly<T> = T extends (...a: any[]) => any ? T : T extends ReadonlyArray<infer U> ? readonly DeepReadonly<U>[] : T extends object ? {
+    readonly [K in keyof T]: DeepReadonly<T[K]>;
+} : T;
 type DeepResolvableProperties<T> = {
     [K in keyof T]?: T[K] extends string | object ? T[K] extends string ? ResolvableUnion<T[K]> : T[K] extends object ? DeepResolvableProperties<T[K]> : ResolvableUnion<T[K]> : ResolvableUnion<T[K]>;
 };
@@ -1019,7 +1027,7 @@ type MatchLinkByRel<R> = Link extends infer M ? M extends {
  */
 type InferLink<T> = T extends {
     rel: infer R;
-} ? R extends KnownLinkRel ? MatchLinkByRel<R> : R extends string ? GenericLink & {
+} ? R extends KnownLinkRel ? DeepReadonly<MatchLinkByRel<R>> : R extends string ? DeepReadonly<GenericLink> & {
     rel: R;
 } : never : never;
 
@@ -1134,7 +1142,7 @@ interface MetaFlatArticle {
      * Writers of the article.
      * @example ['https://example.com/some.html', 'https://example.com/one.html']
      */
-    articleAuthor?: string[];
+    articleAuthor?: readonly string[];
     /**
      * When the article is out of date after.
      * @example '1970-01-01T00:00:00.000Z'
@@ -1159,14 +1167,14 @@ interface MetaFlatArticle {
      * Tag words associated with this article.
      * @example ['Apple', 'Steve Jobs']
      */
-    articleTag?: string[];
+    articleTag?: readonly string[];
 }
 interface MetaFlatBook {
     /**
      * Who wrote this book.
      * @example ['https://example.com/some.html', 'https://example.com/one.html']
      */
-    bookAuthor?: string[];
+    bookAuthor?: readonly string[];
     /**
      * The ISBN.
      * @example '978-3-16-148410-0'
@@ -1181,7 +1189,7 @@ interface MetaFlatBook {
      * Tag words associated with this book.
      * @example ['Apple', 'Steve Jobs']
      */
-    bookTag?: string[];
+    bookTag?: readonly string[];
 }
 interface MetaFlatProfile {
     /**
@@ -2125,12 +2133,41 @@ type NoscriptContent = {
 type Noscript = Pick<GlobalAttributes, 'id' | 'class' | 'style'> & NoscriptContent;
 
 interface SpeculationRules {
-    prefetch?: (SpeculationRuleList | SpeculationRuleDocument)[];
-    prerender?: (SpeculationRuleList | SpeculationRuleDocument)[];
+    prefetch?: readonly SpeculationRule[];
+    prerender?: readonly SpeculationRule[];
 }
-interface SpeculationRuleBase {
+/**
+ * A single speculation rule entry.
+ *
+ * List rules provide explicit `urls`; document rules provide a `where` selector.
+ * Both shapes share the same interface so TypeScript doesn't require exact
+ * literal `source` values, which avoids widening issues inside `useHead`.
+ *
+ * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md
+ */
+interface SpeculationRule {
+    /**
+     * The rule source type.
+     *
+     * `'list'` for explicit URL lists, `'document'` for selector-based rules.
+     *
+     * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md
+     */
+    source?: 'list' | 'document' | (string & Record<never, never>);
     /**
-     * A hint about how likely the user is to navigate to the URL
+     * Explicit URLs to speculate on (list rules).
+     *
+     * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md#list-rules
+     */
+    urls?: readonly string[];
+    /**
+     * Selector conditions for document rules.
+     *
+     * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md#document-rules
+     */
+    where?: SpeculationRuleWhere;
+    /**
+     * A hint about how likely the user is to navigate to the URL.
      *
      * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md#scores
      */
@@ -2140,36 +2177,28 @@ interface SpeculationRuleBase {
      *
      * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md#using-the-documents-base-url-for-external-speculation-rule-sets
      */
-    relative_to?: 'document';
+    relative_to?: 'document' | (string & Record<never, never>);
     /**
-     * Assertions in the rule about the capabilities of the user agent while executing them.
+     * Assertions about user agent capabilities required to execute the rule.
      *
      * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md#requirements
      */
-    requires?: 'anonymous-client-ip-when-cross-origin'[];
+    requires?: readonly ('anonymous-client-ip-when-cross-origin' | (string & Record<never, never>))[];
     /**
-     * Indicating where the page expects the prerendered content to be activated.
+     * Where the page expects the prerendered content to be activated.
      *
      * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md#window-name-targeting-hints
      */
-    target_hint?: '_blank' | '_self' | '_parent' | '_top';
+    target_hint?: '_blank' | '_self' | '_parent' | '_top' | (string & Record<never, never>);
     /**
-     * The policy to use for the speculative request.
+     * The referrer policy for the speculative request.
      *
      * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md#explicit-referrer-policy
      */
     referrer_policy?: ReferrerPolicy;
 }
-interface SpeculationRuleList extends SpeculationRuleBase {
-    source: 'list';
-    urls: string[];
-}
 type SpeculationRuleFn = 'and' | 'or' | 'href_matches' | 'selector_matches' | 'not';
-type SpeculationRuleWhere = Partial<Record<SpeculationRuleFn, Partial<(Record<SpeculationRuleFn, (Partial<Record<SpeculationRuleFn, string>>) | string>)>[]>>;
-interface SpeculationRuleDocument extends SpeculationRuleBase {
-    source: 'document';
-    where: SpeculationRuleWhere;
-}
+type SpeculationRuleWhere = Partial<Record<SpeculationRuleFn, readonly Partial<(Record<SpeculationRuleFn, (Partial<Record<SpeculationRuleFn, string>>) | string>)>[]>>;
 
 /**
  * Events that fire on script elements (load/error)
@@ -2552,9 +2581,9 @@ type MatchScriptByType<U> = Script extends infer M ? M extends {
  */
 type InferScript<T> = T extends {
     type: infer U;
-} ? U extends string ? U extends KnownScriptType ? MatchScriptByType<U> : GenericScript & {
+} ? U extends string ? U extends KnownScriptType ? DeepReadonly<MatchScriptByType<U>> : DeepReadonly<GenericScript> & {
     type: U;
-} : Script : Script;
+} : DeepReadonly<Script> : DeepReadonly<Script>;
 
 interface Style extends Pick<GlobalAttributes, 'nonce' | 'id'>, Blocking {
     /**
@@ -2873,4 +2902,4 @@ interface HeadTag extends TagPriority, TagPosition, ResolvesDuplicates, HasTempl
 }
 type HeadTagKeys = (keyof HeadTag)[];
 
-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 };
+export type { MeLink 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, InferLink as J, InferScript as K, InlineModuleScript as L, InlineScript as M, InnerContent as N, InnerContentVal as O, InternalTagKey as P, JsonLdScript as Q, KnownLinkRel as R, KnownScriptType as S, LicenseLink as T, Link as U, LinkBase as V, LinkHttpEvents as W, ManifestLink as X, MaskIconLink as Y, MaybeArray as Z, MaybeEventFnHandlers as _, AlternateLanguageLink as a, UnheadMeta as a$, Meta as a0, MetaBase as a1, MetaFlat as a2, MetaGeneric as a3, MetaNames as a4, MetaProperties as a5, ModuleScript as a6, ModulepreloadLink as a7, NameMeta as a8, Never as a9, ResolvableStyle as aA, ResolvableTemplateParams as aB, ResolvableTitle as aC, ResolvableTitleTemplate as aD, ResolvableUnion as aE, ResolvableValue as aF, ResolvesDuplicates as aG, SchemaAugmentations as aH, Script as aI, ScriptBase as aJ, ScriptHttpEvents as aK, SearchLink as aL, SerializableHead as aM, SpeculationRules as aN, SpeculationRulesScript as aO, StringInnerContent as aP, Stringable as aQ, StylesheetLink as aR, TagKey as aS, TagPosition as aT, TagPriority as aU, TagUserProperties as aV, TemplateParams as aW, TemplateParamsAugmentations as aX, TermsOfServiceLink as aY, UnheadBodyAttributesWithoutEvents as aZ, UnheadHtmlAttributes as a_, NextLink as aa, PingbackLink as ab, PreconnectLink as ac, PrefetchLink as ad, PreloadFontLink as ae, PreloadImageLink as af, PreloadLink as ag, PreloadLinkBase as ah, PreloadOtherLink as ai, PreloadScriptLink as aj, PreloadStyleLink as ak, PrerenderLink as al, PrevLink as am, PrivacyPolicyLink as an, ProcessesTemplateParams as ao, PropertyMeta as ap, RawInput as aq, ResolvableBase as ar, ResolvableBodyAttributes as as, ResolvableHead as at, ResolvableHtmlAttributes as au, ResolvableLink as av, ResolvableMeta as aw, ResolvableNoscript as ax, ResolvableProperties as ay, ResolvableScript as az, AlternateLink as b, UseHeadInput as b0, UseSeoMetaInput as b1, ValidTagPositions as b2, WebmentionLink as b3, 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, DeepReadonly as n, DeepResolvableProperties as o, DnsPrefetchLink as p, ExternalScript as q, GenericScript as r, GlobalAttributes as s, HeadTag as t, HeadTagKeys as u, HelpLink as v, HttpEquivMeta as w, HttpEventAttributes as x, ImportMapConfig as y, ImportMapScript as z };

package/dist/shared/{unhead.5pUZeb0i.d.ts → unhead.DBv5uRwR.d.ts}

@@ -16,6 +16,14 @@ type _ResolvablePropertiesRaw<T> = {
 };
 type ResolvableProperties<T> = Prettify<_ResolvablePropertiesRaw<T>>;
 type ResolvableUnion<T> = T extends string | number | boolean ? ResolvableValue<T> : T extends object ? DeepResolvableProperties<T> : ResolvableValue<T>;
+/**
+ * Recursively marks all properties and arrays as readonly.
+ * Applied to `InferScript`/`InferLink` return types so that
+ * `defineScript`/`defineLink` accept both mutable and `as const` inputs.
+ */
+type DeepReadonly<T> = T extends (...a: any[]) => any ? T : T extends ReadonlyArray<infer U> ? readonly DeepReadonly<U>[] : T extends object ? {
+    readonly [K in keyof T]: DeepReadonly<T[K]>;
+} : T;
 type DeepResolvableProperties<T> = {
     [K in keyof T]?: T[K] extends string | object ? T[K] extends string ? ResolvableUnion<T[K]> : T[K] extends object ? DeepResolvableProperties<T[K]> : ResolvableUnion<T[K]> : ResolvableUnion<T[K]>;
 };
@@ -1019,7 +1027,7 @@ type MatchLinkByRel<R> = Link extends infer M ? M extends {
  */
 type InferLink<T> = T extends {
     rel: infer R;
-} ? R extends KnownLinkRel ? MatchLinkByRel<R> : R extends string ? GenericLink & {
+} ? R extends KnownLinkRel ? DeepReadonly<MatchLinkByRel<R>> : R extends string ? DeepReadonly<GenericLink> & {
     rel: R;
 } : never : never;
 
@@ -1134,7 +1142,7 @@ interface MetaFlatArticle {
      * Writers of the article.
      * @example ['https://example.com/some.html', 'https://example.com/one.html']
      */
-    articleAuthor?: string[];
+    articleAuthor?: readonly string[];
     /**
      * When the article is out of date after.
      * @example '1970-01-01T00:00:00.000Z'
@@ -1159,14 +1167,14 @@ interface MetaFlatArticle {
      * Tag words associated with this article.
      * @example ['Apple', 'Steve Jobs']
      */
-    articleTag?: string[];
+    articleTag?: readonly string[];
 }
 interface MetaFlatBook {
     /**
      * Who wrote this book.
      * @example ['https://example.com/some.html', 'https://example.com/one.html']
      */
-    bookAuthor?: string[];
+    bookAuthor?: readonly string[];
     /**
      * The ISBN.
      * @example '978-3-16-148410-0'
@@ -1181,7 +1189,7 @@ interface MetaFlatBook {
      * Tag words associated with this book.
      * @example ['Apple', 'Steve Jobs']
      */
-    bookTag?: string[];
+    bookTag?: readonly string[];
 }
 interface MetaFlatProfile {
     /**
@@ -2125,12 +2133,41 @@ type NoscriptContent = {
 type Noscript = Pick<GlobalAttributes, 'id' | 'class' | 'style'> & NoscriptContent;
 
 interface SpeculationRules {
-    prefetch?: (SpeculationRuleList | SpeculationRuleDocument)[];
-    prerender?: (SpeculationRuleList | SpeculationRuleDocument)[];
+    prefetch?: readonly SpeculationRule[];
+    prerender?: readonly SpeculationRule[];
 }
-interface SpeculationRuleBase {
+/**
+ * A single speculation rule entry.
+ *
+ * List rules provide explicit `urls`; document rules provide a `where` selector.
+ * Both shapes share the same interface so TypeScript doesn't require exact
+ * literal `source` values, which avoids widening issues inside `useHead`.
+ *
+ * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md
+ */
+interface SpeculationRule {
+    /**
+     * The rule source type.
+     *
+     * `'list'` for explicit URL lists, `'document'` for selector-based rules.
+     *
+     * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md
+     */
+    source?: 'list' | 'document' | (string & Record<never, never>);
     /**
-     * A hint about how likely the user is to navigate to the URL
+     * Explicit URLs to speculate on (list rules).
+     *
+     * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md#list-rules
+     */
+    urls?: readonly string[];
+    /**
+     * Selector conditions for document rules.
+     *
+     * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md#document-rules
+     */
+    where?: SpeculationRuleWhere;
+    /**
+     * A hint about how likely the user is to navigate to the URL.
      *
      * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md#scores
      */
@@ -2140,36 +2177,28 @@ interface SpeculationRuleBase {
      *
      * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md#using-the-documents-base-url-for-external-speculation-rule-sets
      */
-    relative_to?: 'document';
+    relative_to?: 'document' | (string & Record<never, never>);
     /**
-     * Assertions in the rule about the capabilities of the user agent while executing them.
+     * Assertions about user agent capabilities required to execute the rule.
      *
      * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md#requirements
      */
-    requires?: 'anonymous-client-ip-when-cross-origin'[];
+    requires?: readonly ('anonymous-client-ip-when-cross-origin' | (string & Record<never, never>))[];
     /**
-     * Indicating where the page expects the prerendered content to be activated.
+     * Where the page expects the prerendered content to be activated.
      *
      * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md#window-name-targeting-hints
      */
-    target_hint?: '_blank' | '_self' | '_parent' | '_top';
+    target_hint?: '_blank' | '_self' | '_parent' | '_top' | (string & Record<never, never>);
     /**
-     * The policy to use for the speculative request.
+     * The referrer policy for the speculative request.
      *
      * @see https://github.com/WICG/nav-speculation/blob/main/triggers.md#explicit-referrer-policy
      */
     referrer_policy?: ReferrerPolicy;
 }
-interface SpeculationRuleList extends SpeculationRuleBase {
-    source: 'list';
-    urls: string[];
-}
 type SpeculationRuleFn = 'and' | 'or' | 'href_matches' | 'selector_matches' | 'not';
-type SpeculationRuleWhere = Partial<Record<SpeculationRuleFn, Partial<(Record<SpeculationRuleFn, (Partial<Record<SpeculationRuleFn, string>>) | string>)>[]>>;
-interface SpeculationRuleDocument extends SpeculationRuleBase {
-    source: 'document';
-    where: SpeculationRuleWhere;
-}
+type SpeculationRuleWhere = Partial<Record<SpeculationRuleFn, readonly Partial<(Record<SpeculationRuleFn, (Partial<Record<SpeculationRuleFn, string>>) | string>)>[]>>;
 
 /**
  * Events that fire on script elements (load/error)
@@ -2552,9 +2581,9 @@ type MatchScriptByType<U> = Script extends infer M ? M extends {
  */
 type InferScript<T> = T extends {
     type: infer U;
-} ? U extends string ? U extends KnownScriptType ? MatchScriptByType<U> : GenericScript & {
+} ? U extends string ? U extends KnownScriptType ? DeepReadonly<MatchScriptByType<U>> : DeepReadonly<GenericScript> & {
     type: U;
-} : Script : Script;
+} : DeepReadonly<Script> : DeepReadonly<Script>;
 
 interface Style extends Pick<GlobalAttributes, 'nonce' | 'id'>, Blocking {
     /**
@@ -2873,4 +2902,4 @@ interface HeadTag extends TagPriority, TagPosition, ResolvesDuplicates, HasTempl
 }
 type HeadTagKeys = (keyof HeadTag)[];
 
-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 };
+export type { MeLink 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, InferLink as J, InferScript as K, InlineModuleScript as L, InlineScript as M, InnerContent as N, InnerContentVal as O, InternalTagKey as P, JsonLdScript as Q, KnownLinkRel as R, KnownScriptType as S, LicenseLink as T, Link as U, LinkBase as V, LinkHttpEvents as W, ManifestLink as X, MaskIconLink as Y, MaybeArray as Z, MaybeEventFnHandlers as _, AlternateLanguageLink as a, UnheadMeta as a$, Meta as a0, MetaBase as a1, MetaFlat as a2, MetaGeneric as a3, MetaNames as a4, MetaProperties as a5, ModuleScript as a6, ModulepreloadLink as a7, NameMeta as a8, Never as a9, ResolvableStyle as aA, ResolvableTemplateParams as aB, ResolvableTitle as aC, ResolvableTitleTemplate as aD, ResolvableUnion as aE, ResolvableValue as aF, ResolvesDuplicates as aG, SchemaAugmentations as aH, Script as aI, ScriptBase as aJ, ScriptHttpEvents as aK, SearchLink as aL, SerializableHead as aM, SpeculationRules as aN, SpeculationRulesScript as aO, StringInnerContent as aP, Stringable as aQ, StylesheetLink as aR, TagKey as aS, TagPosition as aT, TagPriority as aU, TagUserProperties as aV, TemplateParams as aW, TemplateParamsAugmentations as aX, TermsOfServiceLink as aY, UnheadBodyAttributesWithoutEvents as aZ, UnheadHtmlAttributes as a_, NextLink as aa, PingbackLink as ab, PreconnectLink as ac, PrefetchLink as ad, PreloadFontLink as ae, PreloadImageLink as af, PreloadLink as ag, PreloadLinkBase as ah, PreloadOtherLink as ai, PreloadScriptLink as aj, PreloadStyleLink as ak, PrerenderLink as al, PrevLink as am, PrivacyPolicyLink as an, ProcessesTemplateParams as ao, PropertyMeta as ap, RawInput as aq, ResolvableBase as ar, ResolvableBodyAttributes as as, ResolvableHead as at, ResolvableHtmlAttributes as au, ResolvableLink as av, ResolvableMeta as aw, ResolvableNoscript as ax, ResolvableProperties as ay, ResolvableScript as az, AlternateLink as b, UseHeadInput as b0, UseSeoMetaInput as b1, ValidTagPositions as b2, WebmentionLink as b3, 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, DeepReadonly as n, DeepResolvableProperties as o, DnsPrefetchLink as p, ExternalScript as q, GenericScript as r, GlobalAttributes as s, HeadTag as t, HeadTagKeys as u, HelpLink as v, HttpEquivMeta as w, HttpEventAttributes as x, ImportMapConfig as y, ImportMapScript as z };

package/dist/shared/{unhead.CyKsApKH.d.mts → unhead.DFLvtb3Z.d.mts}

@@ -1,5 +1,5 @@
 import { HookableCore } from 'hookable';
-import { q as GenericScript, aJ as ScriptHttpEvents, D as DataKeys, Z as MaybeEventFnHandlers, w as HttpEventAttributes, aG as SchemaAugmentations, s as HeadTag, as as ResolvableHead, aS as TagPosition, aT as TagPriority, an as ProcessesTemplateParams, aF as ResolvesDuplicates, aV as TemplateParams } from './unhead.5pUZeb0i.mjs';
+import { r as GenericScript, aK as ScriptHttpEvents, D as DataKeys, _ as MaybeEventFnHandlers, x as HttpEventAttributes, aH as SchemaAugmentations, t as HeadTag, at as ResolvableHead, aT as TagPosition, aU as TagPriority, ao as ProcessesTemplateParams, aG as ResolvesDuplicates, aW as TemplateParams } from './unhead.DBv5uRwR.mjs';
 
 type UseScriptStatus = 'awaitingLoad' | 'loading' | 'loaded' | 'error' | 'removed';
 type UseScriptContext<T extends Record<symbol | string, any>> = ScriptInstance<T>;

package/dist/shared/{unhead.D_sLwV5L.d.ts → unhead.DMQDfSsC.d.ts}

@@ -1,6 +1,6 @@
 import { HookableCore } from 'hookable';
-import { U as Unhead, C as ClientHeadHooks, c as CreateClientHeadOptions } from './unhead.BEof8Qjb.js';
-import { as as ResolvableHead } from './unhead.5pUZeb0i.js';
+import { U as Unhead, C as ClientHeadHooks, c as CreateClientHeadOptions } from './unhead.CZmLNN-R.js';
+import { at as ResolvableHead } from './unhead.DBv5uRwR.js';
 
 interface ClientUnhead<T = ResolvableHead> extends Unhead<T, boolean> {
     hooks: HookableCore<ClientHeadHooks>;

package/dist/shared/{unhead.BAv4ddL5.d.mts → unhead.DR0woClT.d.mts}

@@ -1,4 +1,4 @@
-import { s as HeadTag } from './unhead.5pUZeb0i.mjs';
+import { t as HeadTag } from './unhead.DBv5uRwR.mjs';
 
 interface RenderDomHeadOptions {
     /**

package/dist/shared/{unhead.vQPF0cJs.d.ts → unhead.DeVAJflP.d.ts}

@@ -1,4 +1,4 @@
-import { U as Unhead, F as UseScriptInput, G as UseScriptOptions, J as UseScriptReturn } from './unhead.BEof8Qjb.js';
+import { U as Unhead, F as UseScriptInput, G as UseScriptOptions, J as UseScriptReturn } from './unhead.CZmLNN-R.js';
 
 /**
  * Load third-party scripts with SSR support and a proxied API.

package/dist/shared/unhead.YnmwhfIN.mjs

@@ -0,0 +1,64 @@
+import { c as createUnhead, r as registerPlugin } from './unhead.CfgPMHXt.mjs';
+import { c as createHooks } from './unhead.DvIxXxuO.mjs';
+import { c as createDomRenderer } from './unhead.pv34ME7O.mjs';
+
+const P = { critical: -8, high: -1, low: 2 };
+const tagWeight = (tag) => typeof tag.tagPriority === "number" ? tag.tagPriority : 100 + (P[tag.tagPriority] || 0);
+function createHead(options = {}) {
+  options.document = options.document || (typeof window !== "undefined" ? document : void 0);
+  const renderer = options.render || createDomRenderer({ document: options.document });
+  const initialPayload = options.document?.head.querySelector('script[id="unhead:payload"]')?.innerHTML || false;
+  const core = createUnhead(renderer, { document: options.document, propResolvers: options.propResolvers, _tagWeight: tagWeight, init: [] });
+  const hooks = createHooks(options.hooks);
+  let dirty = false;
+  const head = {
+    ...core,
+    ssr: false,
+    hooks,
+    use: (p) => registerPlugin(head, p),
+    get dirty() {
+      return dirty;
+    },
+    set dirty(v) {
+      dirty = v;
+    },
+    render: () => renderer(head),
+    invalidate() {
+      for (const e of core.entries.values()) delete e._tags;
+      dirty = true;
+      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;
+      hooks.callHook("entries:updated", head);
+      return {
+        _i: active._i,
+        patch(input2) {
+          active.patch(input2);
+          dirty = true;
+          hooks.callHook("entries:updated", head);
+        },
+        dispose() {
+          unhook?.();
+          if (core.entries.has(active._i)) {
+            active.dispose();
+            head.invalidate();
+          }
+        }
+      };
+    }
+  };
+  hooks.hook("entries:updated", () => {
+    renderer(head);
+  });
+  options.plugins?.forEach((p) => registerPlugin(head, p));
+  initialPayload && head.push(JSON.parse(initialPayload));
+  options.init?.forEach((e) => e && head.push(e));
+  return head;
+}
+
+export { createHead as c };

package/dist/shared/{unhead.DvMT2vYs.d.mts → unhead.myNKutCo.d.mts}

@@ -1,6 +1,6 @@
 import { HookableCore } from 'hookable';
-import { U as Unhead, s as SSRHeadPayload, v as ServerHeadHooks, e as CreateServerHeadOptions } from './unhead.CyKsApKH.mjs';
-import { as as ResolvableHead } from './unhead.5pUZeb0i.mjs';
+import { U as Unhead, s as SSRHeadPayload, v as ServerHeadHooks, e as CreateServerHeadOptions } from './unhead.DFLvtb3Z.mjs';
+import { at as ResolvableHead } from './unhead.DBv5uRwR.mjs';
 
 interface ServerUnhead<T = ResolvableHead> extends Unhead<T, SSRHeadPayload> {
     hooks: HookableCore<ServerHeadHooks>;

package/dist/shared/{unhead.CUEmFl2d.d.mts → unhead.vAjfKrQR.d.mts}

@@ -1,4 +1,4 @@
-import { ap as RawInput, as as ResolvableHead, aE as ResolvableValue, ax as ResolvableProperties, G as GenericLink, D as DataKeys, aG as SchemaAugmentations, a2 as MetaGeneric, q as GenericScript, aZ as UnheadHtmlAttributes, aY as UnheadBodyAttributesWithoutEvents } from './unhead.5pUZeb0i.mjs';
+import { aq as RawInput, at as ResolvableHead, aF as ResolvableValue, ay as ResolvableProperties, G as GenericLink, D as DataKeys, aH as SchemaAugmentations, a3 as MetaGeneric, r as GenericScript, a_ as UnheadHtmlAttributes, aZ as UnheadBodyAttributesWithoutEvents } from './unhead.DBv5uRwR.mjs';
 
 type Base = RawInput<'base'>;
 type HtmlAttributes = RawInput<'htmlAttrs'>;

package/dist/stream/client.d.mts

@@ -1,6 +1,6 @@
-import { C as ClientUnhead } from '../shared/unhead.BxsOjg-Q.mjs';
-import { c as CreateClientHeadOptions, U as Unhead } from '../shared/unhead.CyKsApKH.mjs';
-import { aL as SerializableHead, as as ResolvableHead } from '../shared/unhead.5pUZeb0i.mjs';
+import { C as ClientUnhead } from '../shared/unhead.CSqfLsrn.mjs';
+import { c as CreateClientHeadOptions, U as Unhead } from '../shared/unhead.DFLvtb3Z.mjs';
+import { aM as SerializableHead, at as ResolvableHead } from '../shared/unhead.DBv5uRwR.mjs';
 import 'hookable';
 
 interface UnheadStreamQueue {

package/dist/stream/client.d.ts

@@ -1,6 +1,6 @@
-import { C as ClientUnhead } from '../shared/unhead.D_sLwV5L.js';
-import { c as CreateClientHeadOptions, U as Unhead } from '../shared/unhead.BEof8Qjb.js';
-import { aL as SerializableHead, as as ResolvableHead } from '../shared/unhead.5pUZeb0i.js';
+import { C as ClientUnhead } from '../shared/unhead.DMQDfSsC.js';
+import { c as CreateClientHeadOptions, U as Unhead } from '../shared/unhead.CZmLNN-R.js';
+import { aM as SerializableHead, at as ResolvableHead } from '../shared/unhead.DBv5uRwR.js';
 import 'hookable';
 
 interface UnheadStreamQueue {