romhml · sandros94 · Aug 1, 2026 · Aug 1, 2026 · Aug 1, 2026
diff --git a/.nuxtrc b/.nuxtrc
@@ -1 +1 @@
-setups.@nuxt/test-utils="4.0.3"
+setups.@nuxt/test-utils="4.1.0"
diff --git a/packages/nuxt/.nuxtrc b/packages/nuxt/.nuxtrc
@@ -1 +1 @@
-setups.@nuxt/test-utils="4.0.3"
+setups.@nuxt/test-utils="4.1.0"
diff --git a/packages/nuxt/package.json b/packages/nuxt/package.json
@@ -37,6 +37,7 @@
   "devDependencies": {
     "@nuxt/module-builder": "^1.0.3",
     "@nuxt/schema": "catalog:",
+    "@nuxtjs/i18n": "^10.6.0",
     "nuxt": "catalog: "
   },
   "keywords": [

diff --git a/packages/nuxt/src/module.ts b/packages/nuxt/src/module.ts
@@ -42,9 +42,10 @@ export default defineNuxtModule<ModuleOptions>({
       })
     })
 
-    // Injects a placeholder page for the renderer to silence warnings if the router integration is enabled.
-    nuxt.hooks.hookOnce('pages:extend', (pages) => {
-      if (pages.length) pages.push({ path: '/__compodium__/renderer', file: resolve('./runtime/renderer-placeholder.vue') })
+    // Placeholder page for the renderer to silence router warnings; re-added idempotently on pages rebuilds, with `name` and `meta.i18n: false` opting it out of `@nuxtjs/i18n` localization and redirects.
+    nuxt.hooks.hook('pages:extend', (pages) => {
+      if (!pages.length || pages.some(page => page.path === '/__compodium__/renderer')) return
+      pages.push({ path: '/__compodium__/renderer', name: 'compodium-renderer', file: resolve('./runtime/renderer-placeholder.vue'), meta: { i18n: false } })
     })
 
     if (nuxt.options.experimental?.typedPages) {

diff --git a/packages/nuxt/test/fixtures/i18n/app/app.vue b/packages/nuxt/test/fixtures/i18n/app/app.vue
@@ -0,0 +1,3 @@
+<template>
+  <NuxtPage />
+</template>
diff --git a/packages/nuxt/test/fixtures/i18n/app/components/BasicComponent.vue b/packages/nuxt/test/fixtures/i18n/app/components/BasicComponent.vue
@@ -0,0 +1,9 @@
+<script setup lang="ts">
+defineProps<{
+  label: string
+}>()
+</script>
+
+<template>
+  <div>{{ label }}</div>
+</template>
diff --git a/packages/nuxt/test/fixtures/i18n/app/pages/[...slug].vue b/packages/nuxt/test/fixtures/i18n/app/pages/[...slug].vue
@@ -0,0 +1,3 @@
+<template>
+  <div>catch-all</div>
+</template>
diff --git a/packages/nuxt/test/fixtures/i18n/app/pages/index.vue b/packages/nuxt/test/fixtures/i18n/app/pages/index.vue
@@ -0,0 +1,3 @@
+<template>
+  <div>i18n</div>
+</template>
diff --git a/packages/nuxt/test/fixtures/i18n/nuxt.config.ts b/packages/nuxt/test/fixtures/i18n/nuxt.config.ts
@@ -0,0 +1,15 @@
+export default defineNuxtConfig({
+  modules: ['../../../src/module', '@nuxtjs/i18n'],
+
+  i18n: {
+    defaultLocale: 'en',
+    strategy: 'prefix',
+    // Runs the localization middleware during SSR too, so the tests can observe
+    // the redirect behavior the browser-side router applies on every navigation.
+    experimental: { nitroContextDetection: false },
+    locales: [
+      { code: 'en', language: 'en-GB', name: 'English' },
+      { code: 'it', language: 'it-IT', name: 'Italiano' }
+    ]
+  }
+})
diff --git a/packages/nuxt/test/fixtures/i18n/package.json b/packages/nuxt/test/fixtures/i18n/package.json
@@ -0,0 +1,5 @@
+{
+  "private": true,
+  "name": "i18n",
+  "type": "module"
+}
diff --git a/packages/nuxt/test/i18n.nuxt.test.ts b/packages/nuxt/test/i18n.nuxt.test.ts
@@ -0,0 +1,50 @@
+import { describe, it, expect, vi } from 'vitest'
+import { setup, $fetch } from '@nuxt/test-utils/e2e'
+import { joinURL } from 'ufo'
+import { fileURLToPath } from 'node:url'
+import { writeFile, rm } from 'node:fs/promises'
+import { dirname } from 'pathe'
+
+describe('i18n', async () => {
+  const rootDir = fileURLToPath(joinURL(dirname(import.meta.url), './fixtures/i18n'))
+
+  await setup({
+    rootDir,
+    dev: true,
+    port: 4547,
+    setupTimeout: 30000
+  })
+
+  it('renders the localized index page', async () => {
+    const html = await $fetch('/en')
+    expect(html).toContain('<div>i18n</div>')
+  })
+
+  describe('renderer', () => {
+    it('is mounted on the unprefixed path with strategy prefix', async () => {
+      const html = await $fetch('/__compodium__/renderer')
+      expect(html).toContain('<div id="compodium-default-preview"')
+    })
+
+    it('is not redirected by browser language detection', async () => {
+      const html = await $fetch('/__compodium__/renderer', {
+        headers: { 'accept-language': 'it-IT,it;q=0.9' }
+      })
+      expect(html).toContain('<div id="compodium-default-preview"')
+    })
+
+    it('survives a pages rebuild', async () => {
+      const tempPage = joinURL(rootDir, 'app/pages/temp.vue')
+      await writeFile(tempPage, '<template><div>temp page</div></template>\n')
+      try {
+        await vi.waitFor(async () => {
+          expect(await $fetch('/en/temp')).toContain('temp page')
+        }, { timeout: 15000, interval: 500 })
+        const html = await $fetch('/__compodium__/renderer')
+        expect(html).toContain('<div id="compodium-default-preview"')
+      } finally {
+        await rm(tempPage, { force: true })
+      }
+    })
+  })
+})
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
Original file line number	Diff line number	Diff line change
		@@ -1 +1 @@
		setups.@nuxt/test-utils="4.0.3"
		setups.@nuxt/test-utils="4.1.0"