unhead 0.6.5 → 0.6.6

package/dist/index.cjs

@@ -490,10 +490,12 @@ const EventHandlersPlugin = () => {
           const handler = value;
           $el.setAttribute(eventDedupeKey, "");
           $eventListenerTarget.addEventListener(eventName, handler);
-          ctx.entry._sde[sdeKey] = () => {
-            $eventListenerTarget.removeEventListener(eventName, handler);
-            $el.removeAttribute(eventDedupeKey);
-          };
+          if (ctx.entry) {
+            ctx.entry._sde[sdeKey] = () => {
+              $eventListenerTarget.removeEventListener(eventName, handler);
+              $el.removeAttribute(eventDedupeKey);
+            };
+          }
         });
         if (ctx.tag._delayedSrc) {
           $el.setAttribute("src", ctx.tag._delayedSrc);
@@ -527,15 +529,18 @@ const getActiveHead = () => exports.activeHead;
 
 function useHead(input, options = {}) {
   const head = getActiveHead();
-  const isBrowser = IsBrowser || head.resolvedOptions?.document;
-  if (options.mode === "server" && isBrowser || options.mode === "client" && !isBrowser)
-    return;
-  return head.push(input, options);
+  if (head) {
+    const isBrowser = IsBrowser || head.resolvedOptions?.document;
+    if (options.mode === "server" && isBrowser || options.mode === "client" && !isBrowser)
+      return;
+    return head.push(input, options);
+  }
 }
 const useTagTitle = (title) => useHead({ title });
 const useTagBase = (base) => useHead({ base });
 const useTagMeta = (meta) => useHead({ meta: asArray(meta) });
 const useTagMetaFlat = (meta) => useTagMeta(unpackMeta(meta));
+const useSeoMeta = useTagMetaFlat;
 const useTagLink = (link) => useHead({ link: asArray(link) });
 const useTagScript = (script) => useHead({ script: asArray(script) });
 const useTagStyle = (style) => useHead({ style: asArray(style) });
@@ -571,7 +576,26 @@ function normaliseEntryTags(e) {
   });
 }
 
+const CorePlugins = () => [
+  DedupesTagsPlugin(),
+  SortTagsPlugin(),
+  TitleTemplatePlugin(),
+  ProvideTagHashPlugin(),
+  EventHandlersPlugin(),
+  DeprecatedTagAttrPlugin()
+];
+const DOMPlugins = (options = {}) => [
+  PatchDomOnEntryUpdatesPlugin({ document: options?.document, delayFn: options?.domDelayFn })
+];
 function createHead(options = {}) {
+  const head = createHeadCore({
+    ...options,
+    plugins: [...DOMPlugins(options), ...options?.plugins || []]
+  });
+  setActiveHead(head);
+  return head;
+}
+function createHeadCore(options = {}) {
   let entries = [];
   let _sde = {};
   let _eid = 0;
@@ -579,13 +603,7 @@ function createHead(options = {}) {
   if (options?.hooks)
     hooks.addHooks(options.hooks);
   options.plugins = [
-    DeprecatedTagAttrPlugin(),
-    DedupesTagsPlugin(),
-    SortTagsPlugin(),
-    TitleTemplatePlugin(),
-    EventHandlersPlugin(),
-    ProvideTagHashPlugin(),
-    PatchDomOnEntryUpdatesPlugin({ document: options?.document, delayFn: options?.domDelayFn }),
+    ...CorePlugins(),
     ...options?.plugins || []
   ];
   options.plugins.forEach((p) => p.hooks && hooks.addHooks(p.hooks));
@@ -655,7 +673,6 @@ function createHead(options = {}) {
     }
   };
   head.hooks.callHook("init", head);
-  setActiveHead(head);
   return head;
 }
 
@@ -672,6 +689,7 @@ const composableNames = [
   "useTagBase",
   "useTagMeta",
   "useTagMetaFlat",
+  "useSeoMeta",
   "useTagLink",
   "useTagScript",
   "useTagStyle",
@@ -699,6 +717,8 @@ const unheadComposablesImports = [
   }
 ];
 
+exports.CorePlugins = CorePlugins;
+exports.DOMPlugins = DOMPlugins;
 exports.DedupesTagsPlugin = DedupesTagsPlugin;
 exports.DeprecatedTagAttrPlugin = DeprecatedTagAttrPlugin;
 exports.EventHandlersPlugin = EventHandlersPlugin;
@@ -710,6 +730,7 @@ exports.TitleTemplatePlugin = TitleTemplatePlugin;
 exports.asArray = asArray;
 exports.composableNames = composableNames;
 exports.createHead = createHead;
+exports.createHeadCore = createHeadCore;
 exports.defineHeadPlugin = defineHeadPlugin;
 exports.getActiveHead = getActiveHead;
 exports.hashCode = hashCode;
@@ -719,6 +740,7 @@ exports.unheadComposablesImports = unheadComposablesImports;
 exports.useBodyAttrs = useBodyAttrs;
 exports.useHead = useHead;
 exports.useHtmlAttrs = useHtmlAttrs;
+exports.useSeoMeta = useSeoMeta;
 exports.useServerBodyAttrs = useServerBodyAttrs;
 exports.useServerHead = useServerHead;
 exports.useServerHtmlAttrs = useServerHtmlAttrs;

package/dist/index.d.ts

@@ -37,6 +37,7 @@ declare const useTagTitle: (title: Title) => ActiveHeadEntry<any> | void;
 declare const useTagBase: (base: Base) => ActiveHeadEntry<any> | void;
 declare const useTagMeta: (meta: Arrayable<Meta>) => ActiveHeadEntry<any> | void;
 declare const useTagMetaFlat: (meta: MetaFlatInput) => ActiveHeadEntry<any> | void;
+declare const useSeoMeta: (meta: MetaFlatInput) => ActiveHeadEntry<any> | void;
 declare const useTagLink: (link: Arrayable<Link>) => ActiveHeadEntry<any> | void;
 declare const useTagScript: (script: Arrayable<Script>) => ActiveHeadEntry<any> | void;
 declare const useTagStyle: (style: Arrayable<Style>) => ActiveHeadEntry<any> | void;
@@ -59,10 +60,19 @@ declare const useServerBodyAttrs: (attrs: BodyAttributes) => ActiveHeadEntry<any
 declare const useServerTitleTemplate: (titleTemplate: TitleTemplate) => ActiveHeadEntry<any> | void;
 
 declare let activeHead: Unhead<any> | undefined;
-declare const setActiveHead: <T extends Unhead<_unhead_schema.Head<_unhead_schema.SchemaAugmentations>>>(head: T | undefined) => T | undefined;
-declare const getActiveHead: <T extends Unhead<_unhead_schema.Head<_unhead_schema.SchemaAugmentations>>>() => T;
+declare const setActiveHead: (head: Unhead<any> | undefined) => Unhead<any> | undefined;
+declare const getActiveHead: () => Unhead<any> | undefined;
 
+declare const CorePlugins: () => _unhead_schema.HeadPlugin[];
+declare const DOMPlugins: (options?: CreateHeadOptions) => _unhead_schema.HeadPlugin[];
 declare function createHead<T extends {} = Head>(options?: CreateHeadOptions): Unhead<T>;
+/**
+ * Creates a core instance of unhead. Does not provide a global ctx for composables to work
+ * and does not register DOM plugins.
+ *
+ * @param options
+ */
+declare function createHeadCore<T extends {} = Head>(options?: CreateHeadOptions): Unhead<T>;
 
 declare function defineHeadPlugin(plugin: HeadPlugin): HeadPlugin;
 
@@ -74,4 +84,4 @@ declare const unheadComposablesImports: {
     imports: string[];
 }[];
 
-export { Arrayable, DedupesTagsPlugin, DedupesTagsPluginOptions, DeprecatedTagAttrPlugin, EventHandlersPlugin, HasElementTags, PatchDomOnEntryUpdatesPlugin, ProvideTagHashPlugin, SortTagsPlugin, TitleTemplatePlugin, activeHead, asArray, composableNames, createHead, defineHeadPlugin, getActiveHead, hashCode, normaliseEntryTags, setActiveHead, unheadComposablesImports, useBodyAttrs, useHead, useHtmlAttrs, useServerBodyAttrs, useServerHead, useServerHtmlAttrs, useServerTagBase, useServerTagLink, useServerTagMeta, useServerTagMetaFlat, useServerTagNoscript, useServerTagScript, useServerTagStyle, useServerTagTitle, useServerTitleTemplate, useTagBase, useTagLink, useTagMeta, useTagMetaFlat, useTagNoscript, useTagScript, useTagStyle, useTagTitle, useTitleTemplate };
+export { Arrayable, CorePlugins, DOMPlugins, DedupesTagsPlugin, DedupesTagsPluginOptions, DeprecatedTagAttrPlugin, EventHandlersPlugin, HasElementTags, PatchDomOnEntryUpdatesPlugin, ProvideTagHashPlugin, SortTagsPlugin, TitleTemplatePlugin, activeHead, asArray, composableNames, createHead, createHeadCore, defineHeadPlugin, getActiveHead, hashCode, normaliseEntryTags, setActiveHead, unheadComposablesImports, useBodyAttrs, useHead, useHtmlAttrs, useSeoMeta, useServerBodyAttrs, useServerHead, useServerHtmlAttrs, useServerTagBase, useServerTagLink, useServerTagMeta, useServerTagMetaFlat, useServerTagNoscript, useServerTagScript, useServerTagStyle, useServerTagTitle, useServerTitleTemplate, useTagBase, useTagLink, useTagMeta, useTagMetaFlat, useTagNoscript, useTagScript, useTagStyle, useTagTitle, useTitleTemplate };

package/dist/index.mjs

@@ -488,10 +488,12 @@ const EventHandlersPlugin = () => {
           const handler = value;
           $el.setAttribute(eventDedupeKey, "");
           $eventListenerTarget.addEventListener(eventName, handler);
-          ctx.entry._sde[sdeKey] = () => {
-            $eventListenerTarget.removeEventListener(eventName, handler);
-            $el.removeAttribute(eventDedupeKey);
-          };
+          if (ctx.entry) {
+            ctx.entry._sde[sdeKey] = () => {
+              $eventListenerTarget.removeEventListener(eventName, handler);
+              $el.removeAttribute(eventDedupeKey);
+            };
+          }
         });
         if (ctx.tag._delayedSrc) {
           $el.setAttribute("src", ctx.tag._delayedSrc);
@@ -525,15 +527,18 @@ const getActiveHead = () => activeHead;
 
 function useHead(input, options = {}) {
   const head = getActiveHead();
-  const isBrowser = IsBrowser || head.resolvedOptions?.document;
-  if (options.mode === "server" && isBrowser || options.mode === "client" && !isBrowser)
-    return;
-  return head.push(input, options);
+  if (head) {
+    const isBrowser = IsBrowser || head.resolvedOptions?.document;
+    if (options.mode === "server" && isBrowser || options.mode === "client" && !isBrowser)
+      return;
+    return head.push(input, options);
+  }
 }
 const useTagTitle = (title) => useHead({ title });
 const useTagBase = (base) => useHead({ base });
 const useTagMeta = (meta) => useHead({ meta: asArray(meta) });
 const useTagMetaFlat = (meta) => useTagMeta(unpackMeta(meta));
+const useSeoMeta = useTagMetaFlat;
 const useTagLink = (link) => useHead({ link: asArray(link) });
 const useTagScript = (script) => useHead({ script: asArray(script) });
 const useTagStyle = (style) => useHead({ style: asArray(style) });
@@ -569,7 +574,26 @@ function normaliseEntryTags(e) {
   });
 }
 
+const CorePlugins = () => [
+  DedupesTagsPlugin(),
+  SortTagsPlugin(),
+  TitleTemplatePlugin(),
+  ProvideTagHashPlugin(),
+  EventHandlersPlugin(),
+  DeprecatedTagAttrPlugin()
+];
+const DOMPlugins = (options = {}) => [
+  PatchDomOnEntryUpdatesPlugin({ document: options?.document, delayFn: options?.domDelayFn })
+];
 function createHead(options = {}) {
+  const head = createHeadCore({
+    ...options,
+    plugins: [...DOMPlugins(options), ...options?.plugins || []]
+  });
+  setActiveHead(head);
+  return head;
+}
+function createHeadCore(options = {}) {
   let entries = [];
   let _sde = {};
   let _eid = 0;
@@ -577,13 +601,7 @@ function createHead(options = {}) {
   if (options?.hooks)
     hooks.addHooks(options.hooks);
   options.plugins = [
-    DeprecatedTagAttrPlugin(),
-    DedupesTagsPlugin(),
-    SortTagsPlugin(),
-    TitleTemplatePlugin(),
-    EventHandlersPlugin(),
-    ProvideTagHashPlugin(),
-    PatchDomOnEntryUpdatesPlugin({ document: options?.document, delayFn: options?.domDelayFn }),
+    ...CorePlugins(),
     ...options?.plugins || []
   ];
   options.plugins.forEach((p) => p.hooks && hooks.addHooks(p.hooks));
@@ -653,7 +671,6 @@ function createHead(options = {}) {
     }
   };
   head.hooks.callHook("init", head);
-  setActiveHead(head);
   return head;
 }
 
@@ -670,6 +687,7 @@ const composableNames = [
   "useTagBase",
   "useTagMeta",
   "useTagMetaFlat",
+  "useSeoMeta",
   "useTagLink",
   "useTagScript",
   "useTagStyle",
@@ -697,4 +715,4 @@ const unheadComposablesImports = [
   }
 ];
 
-export { DedupesTagsPlugin, DeprecatedTagAttrPlugin, EventHandlersPlugin, HasElementTags, PatchDomOnEntryUpdatesPlugin, ProvideTagHashPlugin, SortTagsPlugin, TitleTemplatePlugin, activeHead, asArray, composableNames, createHead, defineHeadPlugin, getActiveHead, hashCode, normaliseEntryTags, setActiveHead, unheadComposablesImports, useBodyAttrs, useHead, useHtmlAttrs, useServerBodyAttrs, useServerHead, useServerHtmlAttrs, useServerTagBase, useServerTagLink, useServerTagMeta, useServerTagMetaFlat, useServerTagNoscript, useServerTagScript, useServerTagStyle, useServerTagTitle, useServerTitleTemplate, useTagBase, useTagLink, useTagMeta, useTagMetaFlat, useTagNoscript, useTagScript, useTagStyle, useTagTitle, useTitleTemplate };
+export { CorePlugins, DOMPlugins, DedupesTagsPlugin, DeprecatedTagAttrPlugin, EventHandlersPlugin, HasElementTags, PatchDomOnEntryUpdatesPlugin, ProvideTagHashPlugin, SortTagsPlugin, TitleTemplatePlugin, activeHead, asArray, composableNames, createHead, createHeadCore, defineHeadPlugin, getActiveHead, hashCode, normaliseEntryTags, setActiveHead, unheadComposablesImports, useBodyAttrs, useHead, useHtmlAttrs, useSeoMeta, useServerBodyAttrs, useServerHead, useServerHtmlAttrs, useServerTagBase, useServerTagLink, useServerTagMeta, useServerTagMetaFlat, useServerTagNoscript, useServerTagScript, useServerTagStyle, useServerTagTitle, useServerTitleTemplate, useTagBase, useTagLink, useTagMeta, useTagMetaFlat, useTagNoscript, useTagScript, useTagStyle, useTagTitle, useTitleTemplate };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "unhead",
   "type": "module",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "packageManager": "pnpm@7.14.0",
   "author": "Harlan Wilton <harlan@harlanzw.com>",
   "license": "MIT",
@@ -30,8 +30,8 @@
     "dist"
   ],
   "dependencies": {
-    "@unhead/dom": "0.6.5",
-    "@unhead/schema": "0.6.5",
+    "@unhead/dom": "0.6.6",
+    "@unhead/schema": "0.6.6",
     "hookable": "^5.4.1"
   },
   "devDependencies": {