@unhead/schema 1.1.29 → 1.1.31

package/dist/index.d.ts

@@ -8,6 +8,15 @@ interface ResolvesDuplicates {
      * to be made you can provide a unique key for each entry.
      */
     key?: string;
+    /**
+     * The strategy to use when a duplicate tag is encountered.
+     *
+     * - `replace` - Replace the existing tag with the new tag
+     * - `merge` - Merge the existing tag with the new tag
+     *
+     * @default 'replace' (some tags will default to 'merge', such as htmlAttr)
+     */
+    tagDuplicateStrategy?: 'replace' | 'merge';
     /**
      * @deprecated Use `key` instead
      */
@@ -16,12 +25,6 @@ interface ResolvesDuplicates {
      * @deprecated Use `key` instead
      */
     vmid?: string;
-    /**
-     * Specify where to render the tag.
-     *
-     * @default 'head'
-     */
-    tagDuplicateStrategy?: 'replace' | 'merge';
 }
 type ValidTagPositions = 'head' | 'bodyClose' | 'bodyOpen';
 interface TagPosition {
@@ -63,11 +66,11 @@ interface TagPriority {
      * (besides some special tags).
      *
      * The following special tags have default priorities:
-     * * -2 <meta charset ...>
-     * * -1 <base>
-     * * 0 <meta http-equiv="content-security-policy" ...>
+     * * -2 `<meta charset ...>`
+     * * -1 `<base>`
+     * * 0 `<meta http-equiv="content-security-policy" ...>`
      *
-     * All other tags have a default priority of 10: <meta>, <script>, <link>, <style>, etc
+     * All other tags have a default priority of 10: `<meta>`, `<script>`, `<link>`, `<style>`, etc
      */
     tagPriority?: number | 'critical' | 'high' | 'low' | `before:${string}` | `after:${string}`;
 }
@@ -182,21 +185,21 @@ interface HeadUtils {
 }
 interface Head<E extends MergeHead = SchemaAugmentations> extends HeadUtils {
     /**
-     * The <title> HTML element defines the document's title that is shown in a browser's title bar or a page's tab.
+     * The `<title>` HTML element defines the document's title that is shown in a browser's title bar or a page's tab.
      * It only contains text; tags within the element are ignored.
      *
      * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/title
      */
     title?: Title | Promise<Title>;
     /**
-     * The <base> HTML element specifies the base URL to use for all relative URLs in a document.
+     * The `<base>` HTML element specifies the base URL to use for all relative URLs in a document.
      * There can be only one <base> element in a document.
      *
      * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/base
      */
     base?: Base<E['base']>;
     /**
-     * The <link> HTML element specifies relationships between the current document and an external resource.
+     * The `<link>` HTML element specifies relationships between the current document and an external resource.
      * This element is most commonly used to link to stylesheets, but is also used to establish site icons
      * (both "favicon" style icons and icons for the home screen and apps on mobile devices) among other things.
      *
@@ -204,39 +207,39 @@ interface Head<E extends MergeHead = SchemaAugmentations> extends HeadUtils {
      */
     link?: Link<E['link']>[];
     /**
-     * The <meta> element represents metadata that cannot be expressed in other HTML elements, like <link> or <script>.
+     * The `<meta>` element represents metadata that cannot be expressed in other HTML elements, like `<link>` or `<script>`.
      *
      * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meta
      */
     meta?: Meta<E['meta']>[];
     /**
-     * The <style> HTML element contains style information for a document, or part of a document.
-     * It contains CSS, which is applied to the contents of the document containing the <style> element.
+     * The `<style>` HTML element contains style information for a document, or part of a document.
+     * It contains CSS, which is applied to the contents of the document containing the `<style>` element.
      *
      * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/style
      */
     style?: (Style<E['style']> | string)[];
     /**
-     * The <script> HTML element is used to embed executable code or data; this is typically used to embed or refer to JavaScript code.
+     * The `<script>` HTML element is used to embed executable code or data; this is typically used to embed or refer to JavaScript code.
      *
      * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script
      */
     script?: (Script<E['script']> | string)[];
     /**
-     * The <noscript> HTML element defines a section of HTML to be inserted if a script type on the page is unsupported
+     * The `<noscript>` HTML element defines a section of HTML to be inserted if a script type on the page is unsupported
      * or if scripting is currently turned off in the browser.
      *
      * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/noscript
      */
     noscript?: (Noscript<E['noscript']> | string)[];
     /**
-     * Attributes for the <html> HTML element.
+     * Attributes for the `<html>` HTML element.
      *
      * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/html
      */
     htmlAttrs?: HtmlAttributes<E['htmlAttrs']>;
     /**
-     * Attributes for the <body> HTML element.
+     * Attributes for the `<body>` HTML element.
      *
      * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/body
      */
@@ -333,13 +336,13 @@ interface HeadEntry<Input> {
      *
      * @internal
      */
-    _m?: RuntimeMode;
+    mode?: RuntimeMode;
     /**
      * Transformer function for the entry.
      *
      * @internal
      */
-    _t?: (input: Input) => Input;
+    transform?: (input: unknown) => unknown;
     /**
      * Head entry index
      *
@@ -352,6 +355,18 @@ interface HeadEntry<Input> {
      * @internal
      */
     _sde: SideEffectsRecord;
+    /**
+     * Default tag position.
+     *
+     * @internal
+     */
+    tagPosition?: TagPosition['tagPosition'];
+    /**
+     * Default tag priority.
+     *
+     * @internal
+     */
+    tagPriority?: TagPriority['tagPriority'];
 }
 type HeadPlugin = Omit<CreateHeadOptions, 'plugins'>;
 /**
@@ -372,6 +387,7 @@ interface ActiveHeadEntry<Input> {
     dispose: () => void;
 }
 interface CreateHeadOptions {
+    mode?: 'server' | 'client';
     domDelayFn?: (fn: () => void) => void;
     document?: Document;
     plugins?: HeadPlugin[];

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@unhead/schema",
   "type": "module",
-  "version": "1.1.29",
-  "packageManager": "pnpm@8.6.2",
+  "version": "1.1.31",
+  "packageManager": "pnpm@8.6.7",
   "author": "Harlan Wilton <harlan@harlanzw.com>",
   "license": "MIT",
   "funding": "https://github.com/sponsors/harlan-zw",
@@ -36,7 +36,7 @@
   ],
   "dependencies": {
     "hookable": "^5.5.3",
-    "zhead": "^2.0.7"
+    "zhead": "^2.0.9"
   },
   "scripts": {
     "build": "unbuild .",