unjs
diff --git a/‎README.md‎
Lines changed: 36 additions & 0 deletions b/‎README.md‎
Lines changed: 36 additions & 0 deletions
diff --git a/‎package.json‎
Lines changed: 1 addition & 0 deletions b/‎package.json‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎pnpm-lock.yaml‎
Lines changed: 8 additions & 0 deletions b/‎pnpm-lock.yaml‎
Lines changed: 8 additions & 0 deletions
@@ -39,6 +39,42 @@ export default {
 }
 ```
 
+### Import Tracing
+
+Enable `trace: true` to get rich violation diagnostics with full import chains and code snippets. When enabled, errors are deferred to `buildEnd` so the complete module graph can be collected first.
+
+```js
+ImpoundPlugin.rollup({
+  cwd: dirname(fileURLToPath(import.meta.url)),
+  trace: true,
+  patterns: [
+    [/\.server$/, 'Server-only import', ['Use a server function instead', 'Move this import to a .server.ts file']]
+  ]
+})
+```
+
+Example output:
+
+```
+Invalid import [importing `secret` from `middle.js`]
+
+Trace:
+  1. src/routes/index.tsx:2:34 (entry) (import "../features/auth/session")
+  2. src/features/auth/session.ts
+
+Code:
+  1 | import { logger } from '../utils/logger'
+  2 |
+> 3 | import { getUsers } from '../db/queries.server'
+    |                           ^
+  4 |
+  5 | export function loadAuth() {
+
+Suggestions:
+  - Use a server function instead
+  - Move this import to a .server.ts file
+```
+
 ## 💻 Development
 
 - Clone this repository
 
@@ -29,6 +29,7 @@
     "test:types": "tsc --noEmit"
   },
   "dependencies": {
+    "es-module-lexer": "^2.0.0",
     "exsolve": "^1.0.8",
     "mocked-exports": "^0.1.1",
     "pathe": "^2.0.3",