refactor(kit): extract trace utilities

danielroe · danielroe · commit ddaedfa51df5 · 2025-10-25T15:33:33.000+09:00
diff --git a/packages/kit/src/internal/esm.ts b/packages/kit/src/internal/esm.ts
@@ -2,6 +2,8 @@ import { pathToFileURL } from 'node:url'
 import { interopDefault } from 'mlly'
 import { resolveModulePath } from 'exsolve'
 import { createJiti } from 'jiti'
+import { getUserCaller, warn } from './trace'
+import { resolveAlias } from '../resolve'
 
 export interface ResolveModuleOptions {
   /** @deprecated use `url` with URLs pointing at a file - never a directory */
@@ -58,17 +60,14 @@ export function tryImportModule<T = unknown> (id: string, opts?: ImportModuleOpt
   }
 }
 
-const warnings = new Set<string>()
-
 /**
  * @deprecated Please use `importModule` instead.
  */
 export function requireModule<T = unknown> (id: string, opts?: ImportModuleOptions) {
-  if (!warnings.has(id)) {
-    // TODO: add more information on stack trace
-    console.warn('[@nuxt/kit] `requireModule` is deprecated. Please use `importModule` instead.')
-    warnings.add(id)
-  }
+  const caller = getUserCaller()
+  const explanation = caller ? ` (used at \`${resolveAlias(caller.source)}:${caller.line}:${caller.column}\`)` : ''
+  const warning = `[@nuxt/kit] \`requireModule\` is deprecated${explanation}. Please use \`importModule\` instead.`
+  warn(warning)
   const resolvedPath = resolveModule(id, opts)
   const jiti = createJiti(import.meta.url, {
     interopDefault: opts?.interopDefault !== false,
diff --git a/packages/kit/src/internal/trace.ts b/packages/kit/src/internal/trace.ts
@@ -0,0 +1,30 @@
+import { captureStackTrace } from 'errx'
+
+const distURL = import.meta.url.replace(/\/dist\/.*$/, '/')
+
+export function getUserCaller () {
+  if (!import.meta.dev) {
+    return null
+  }
+
+  const { source, line, column } = captureStackTrace().find(entry => !entry.source.startsWith(distURL)) ?? {}
+
+  if (!source) {
+    return null
+  }
+
+  return {
+    source: source.replace(/^file:\/\//, ''),
+    line,
+    column,
+  }
+}
+
+const warnings = new Set<string>()
+
+export function warn (warning: string) {
+  if (!warnings.has(warning)) {
+    console.warn(warning)
+    warnings.add(warning)
+  }
+}
