fix!: sync renderDOMHead() (#628)

* fix!: sync `renderDOMHead`

* doc: missing

Author: harlan-zw

docs/0.vue/head/guides/1.core-concepts/4.pausing-dom-rendering.md

@@ -10,8 +10,7 @@ In Vue, this is especially useful when you're using `<Suspense>`{lang="html"}.
 ::code-group
 
 ```ts [Universal]
-import { renderDOMHead } from '@unhead/dom'
-import { createHead } from 'unhead'
+import { createHead, renderDOMHead } from 'unhead/client'
 
 const head = createHead()
 
@@ -29,7 +28,7 @@ loadPage().then(() => {
 ```
 
 ```ts [Vue]
-import { renderDOMHead } from '@unhead/dom'
+import { renderDOMHead } from 'unhead/client'
 import { createHead } from '@unhead/vue'
 import { useRouter } from 'vue-router'
 

docs/head/1.guides/2.advanced/11.extending-unhead.md

@@ -195,12 +195,16 @@ For a complete list of available hooks and their signatures, refer to the hooks
 ```ts
 // From packages/unhead/src/types/hooks.ts
 export interface HeadHooks {
-  'entries:resolve': (ctx: CallbackParams<'entries:resolve'>) => void | Promise<void>
-  'tags:resolve': (ctx: CallbackParams<'tags:resolve'>) => void | Promise<void>
-  'tag:normalise': (ctx: TagAugmentation) => void | Promise<void>
-  'tag:resolve': (ctx: CallbackParams<'tag:resolve'>) => void | Promise<void>
-  'tag:validate': (ctx: TagAugmentation) => void | Promise<void>
-  'tag:generated': (ctx: TagAugmentation) => void | Promise<void>
+  'entries:updated': (ctx: Unhead<any>) => HookResult
+  'entries:resolve': (ctx: EntryResolveCtx<any>) => SyncHookResult
+  'entries:normalize': (ctx: { tags: HeadTag[], entry: HeadEntry<any> }) => SyncHookResult
+  'tag:normalise': (ctx: { tag: HeadTag, entry: HeadEntry<any>, resolvedOptions: CreateClientHeadOptions }) => SyncHookResult
+  'tags:beforeResolve': (ctx: TagResolveContext) => SyncHookResult
+  'tags:resolve': (ctx: TagResolveContext) => SyncHookResult
+  'tags:afterResolve': (ctx: TagResolveContext) => SyncHookResult
+  'dom:beforeRender': (ctx: DomBeforeRenderCtx) => SyncHookResult
   // ...additional hooks
 }
 ```
+
+Note: `SyncHookResult` is `void` (synchronous only), while `HookResult` is `void | Promise<void>`.

docs/head/7.api/hooks/09.dom-before-render.md

@@ -11,7 +11,7 @@ The `dom:beforeRender` hook is called before tags are rendered to the DOM in cli
 
 ```ts
 export interface Hook {
-  'dom:beforeRender': (ctx: DomBeforeRenderCtx) => HookResult
+  'dom:beforeRender': (ctx: DomBeforeRenderCtx) => SyncHookResult
 }
 ```
 
@@ -25,7 +25,7 @@ The `DomBeforeRenderCtx` interface extends `ShouldRenderContext`:
 
 ```ts
 interface DomBeforeRenderCtx extends ShouldRenderContext {
-  tags: DomRenderTagContext[] // Note: this is deprecated and will always be empty
+  tags: HeadTag[]
 }
 
 interface ShouldRenderContext {
@@ -35,7 +35,7 @@ interface ShouldRenderContext {
 
 ### Returns
 
-`HookResult` which is either `void` or `Promise<void>`
+`SyncHookResult` which is `void`. This hook is synchronous and cannot be async.
 
 ## Usage Example
 

packages/unhead/src/client/createHead.ts

@@ -22,7 +22,7 @@ export function createHead<T = ResolvableHead>(options: CreateClientHeadOptions
       {
         key: 'client',
         hooks: {
-          'entries:updated': render,
+          'entries:updated': (head) => { render(head) },
         },
       },
     ],