fix(nuxt): absolutely resolve defu in app config template

danielroe · danielroe · commit 40bedf0db0cd · 2026-06-02T14:03:55.000+01:00
Ported from a006fd4. The `nitro/runtime-config` half does not apply: 3.x uses `#internal/nitro` (a nitropack v2 virtual) for `useRuntimeConfig`.
diff --git a/packages/nuxt/src/core/templates.ts b/packages/nuxt/src/core/templates.ts
@@ -4,6 +4,7 @@ import { join, relative, resolve } from 'pathe'
 import type { JSValue } from 'untyped'
 import { generateTypes, resolveSchema } from 'untyped'
 import escapeRE from 'escape-string-regexp'
+import { resolveModulePath } from 'exsolve'
 import { hash } from 'ohash'
 import { camelCase } from 'scule'
 import { filename, reverseResolveAlias } from 'pathe/utils'
@@ -13,6 +14,8 @@ import { annotatePlugins, checkForCircularDependencies } from './app.ts'
 import { EXTENSION_RE } from './utils/index.ts'
 import type { NuxtOptions, NuxtTemplate, NuxtTypeTemplate } from 'nuxt/schema'
 
+const defuPath = resolveModulePath('defu', { try: true, from: import.meta.url }) ?? 'defu'
+
 export const vueShim: NuxtTemplate = {
   filename: 'types/vue-shim.d.ts',
   getContents: ({ nuxt }) => {
@@ -429,7 +432,7 @@ export const appConfigTemplate: NuxtTemplate = {
   getContents ({ app, nuxt }) {
     return `
 import { _replaceAppConfig } from '#app/config'
-import { defuFn } from 'defu'
+import { defuFn } from ${JSON.stringify(defuPath)}
 
 const inlineConfig = ${JSON.stringify(nuxt.options.appConfig, null, 2)}
 
diff --git a/packages/nuxt/test/templates.test.ts b/packages/nuxt/test/templates.test.ts
@@ -0,0 +1,40 @@
+import { existsSync } from 'node:fs'
+import { describe, expect, it } from 'vitest'
+import { resolve } from 'pathe'
+
+// `templates.ts` re-imports `./app.ts`, which reads `defaultTemplates.*` at
+// module init. Pulling `app.ts` in first lets that cycle resolve the same way
+// it does in production; otherwise the test would see partially-initialised
+// exports and crash before any assertions run.
+import '../src/core/app.ts'
+import { appConfigTemplate } from '../src/core/templates.ts'
+
+import type { Nuxt, NuxtApp } from 'nuxt/schema'
+
+function makeNuxt (overrides: Partial<Nuxt['options']> = {}): Nuxt {
+  return {
+    options: {
+      dev: false,
+      appConfig: {},
+      app: { baseURL: '/', buildAssetsDir: '/_nuxt/', cdnURL: '' },
+      ...overrides,
+    },
+  } as unknown as Nuxt
+}
+
+function makeApp (configs: string[] = []): NuxtApp {
+  return { configs } as unknown as NuxtApp
+}
+
+describe('appConfigTemplate', () => {
+  it('emits an absolute path for the `defu` import so Nitro can resolve it under strict pnpm hoist', async () => {
+    const contents = await appConfigTemplate.getContents!({ nuxt: makeNuxt(), app: makeApp(), options: {} })
+
+    expect(contents).not.toMatch(/from ['"]defu['"]/)
+    const match = contents.match(/import \{ defuFn \} from ["']([^"']+)["']/)
+    expect(match, 'expected resolved `defuFn` import').toBeTruthy()
+    const resolved = match![1]!
+    expect(resolve(resolved)).toBe(resolved)
+    expect(existsSync(resolved)).toBe(true)
+  })
+})
