🔗 Linked issue

❓ Type of change

• 📖 Documentation (updates to the documentation or readme)
• 🐞 Bug fix (a non-breaking change that fixes an issue)
• 👌 Enhancement (improving an existing functionality)
• ✨ New feature (a non-breaking change that adds functionality)
• 🧹 Chore (updates to the build process or auxiliary tools and libraries)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

This PR converts renderDOMHead from async to sync execution, improving performance and simplifying the client-side rendering pipeline. This means all dom:* related hooks can only be processed sync as well.

-await renderDOMHead(...)
+renderDOMHead(...)

⚠️ Breaking Changes Migration

renderDOMHead is now synchronous

Before:

await renderDOMHead(head, { document })

After:

renderDOMHead(head, { document })
// or check return value
const didRender = renderDOMHead(head, { document })

Hook return types changed

If you have custom plugins using these hooks, update return types:

Before:

const plugin = {
  hooks: {
    'dom:beforeRender': async (ctx) => {
      await someAsyncOperation()
      ctx.shouldRender = true
    },
    'entries:resolve': async (ctx) => {
      await processEntries(ctx)
    }
  }
}

After:

const plugin = {
  hooks: {
    'dom:beforeRender': (ctx) => {
      // Must be synchronous now
      ctx.shouldRender = true
    },
    'entries:resolve': (ctx) => {
      // Must be synchronous now
      processEntriesSync(ctx)
    }
  }
}