clerk · Ephem · Sep 7, 2026
diff --git a/.changeset/local-declaration-maps.md b/.changeset/local-declaration-maps.md
@@ -0,0 +1,2 @@
+---
+---
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -9,6 +9,7 @@
   },
   "typescript.enablePromptUseWorkspaceTsdk": true,
   "typescript.tsdk": "node_modules/typescript/lib",
+  "js/ts.preferGoToSourceDefinition": true,
   "editor.codeActionsOnSave": {
     "source.fixAll.eslint": "explicit",
   },

diff --git a/packages/clerk-js/package.json b/packages/clerk-js/package.json
@@ -53,6 +53,8 @@
   "types": "dist/types/index.d.ts",
   "files": [
     "dist",
+    "!dist/**/*.d.ts.map",
+    "!dist/**/*.d.mts.map",
     "no-rhc"
   ],
   "scripts": {

diff --git a/packages/clerk-js/tsconfig.declarations.json b/packages/clerk-js/tsconfig.declarations.json
@@ -5,7 +5,7 @@
     "noEmit": false,
     "declaration": true,
     "emitDeclarationOnly": true,
-    "declarationMap": false,
+    "declarationMap": true,
     "sourceMap": false,
     "outDir": "./dist",
     "declarationDir": "./dist/types",

diff --git a/packages/eslint-plugin/package.json b/packages/eslint-plugin/package.json
@@ -51,7 +51,9 @@
     "clerk-next-fix-auth-protection": "./dist/next/fix-auth-protection-cli.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "!dist/**/*.d.ts.map",
+    "!dist/**/*.d.mts.map"
   ],
   "scripts": {
     "build": "tsdown",

diff --git a/packages/eslint-plugin/tsdown.config.mts b/packages/eslint-plugin/tsdown.config.mts
@@ -13,7 +13,7 @@ export default defineConfig({
   clean: true,
   minify: false,
   sourcemap: true,
-  dts: true,
+  dts: { sourcemap: true },
   // `eslint` is a peer dependency resolved from the consumer's install; never
   // bundle it into the fix runner / CLI.
   deps: {

diff --git a/packages/express/package.json b/packages/express/package.json
@@ -57,6 +57,8 @@
   "main": "./dist/index.js",
   "files": [
     "dist",
+    "!dist/**/*.d.ts.map",
+    "!dist/**/*.d.mts.map",
     "webhooks",
     "env.d.ts"
   ],

diff --git a/packages/express/tsdown.config.mts b/packages/express/tsdown.config.mts
@@ -17,7 +17,7 @@ export default defineConfig(overrideOptions => {
     clean: true,
     minify: false,
     sourcemap: true,
-    dts: true,
+    dts: { sourcemap: true },
     onSuccess: shouldPublish ? 'pkglab pub --ping' : undefined,
     define: {
       PACKAGE_NAME: `"${pkgJson.name}"`,

diff --git a/packages/fastify/package.json b/packages/fastify/package.json
@@ -57,6 +57,8 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
+    "!dist/**/*.d.ts.map",
+    "!dist/**/*.d.mts.map",
     "webhooks"
   ],
   "scripts": {

diff --git a/packages/fastify/tsdown.config.mts b/packages/fastify/tsdown.config.mts
@@ -17,7 +17,7 @@ export default defineConfig(overrideOptions => {
     clean: true,
     minify: false,
     sourcemap: true,
-    dts: true,
+    dts: { sourcemap: true },
     onSuccess: shouldPublish ? 'pkglab pub --ping' : undefined,
     define: {
       PACKAGE_NAME: `"${pkgJson.name}"`,

diff --git a/packages/hono/package.json b/packages/hono/package.json
@@ -56,7 +56,9 @@
   },
   "main": "./dist/index.js",
   "files": [
-    "dist"
+    "dist",
+    "!dist/**/*.d.ts.map",
+    "!dist/**/*.d.mts.map"
   ],
   "scripts": {
     "build": "tsdown",

diff --git a/packages/hono/tsdown.config.mts b/packages/hono/tsdown.config.mts
@@ -17,7 +17,7 @@ export default defineConfig(overrideOptions => {
     clean: true,
     minify: false,
     sourcemap: true,
-    dts: true,
+    dts: { sourcemap: true },
     onSuccess: shouldPublish ? 'pkglab pub --ping' : undefined,
     define: {
       PACKAGE_NAME: `"${pkgJson.name}"`,

diff --git a/packages/nuxt/package.json b/packages/nuxt/package.json
@@ -55,7 +55,9 @@
   "main": "./dist/module.js",
   "types": "./dist/module.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "!dist/**/*.d.ts.map",
+    "!dist/**/*.d.mts.map"
   ],
   "scripts": {
     "build": "tsdown",

diff --git a/packages/nuxt/tsdown.config.ts b/packages/nuxt/tsdown.config.ts
@@ -27,7 +27,7 @@ export default defineConfig(overrideOptions => {
     unbundle: true,
     sourcemap: true,
     minify: false,
-    dts: true,
+    dts: { sourcemap: true },
     onSuccess: shouldPublish ? 'pkglab pub --ping' : undefined,
     define: {
       PACKAGE_NAME: `"${pkgJson.name}"`,

diff --git a/packages/react-router/package.json b/packages/react-router/package.json
@@ -82,7 +82,9 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "!dist/**/*.d.ts.map",
+    "!dist/**/*.d.mts.map"
   ],
   "scripts": {
     "build": "tsdown",

diff --git a/packages/react-router/tsdown.config.ts b/packages/react-router/tsdown.config.ts
@@ -14,7 +14,7 @@ export default defineConfig(overrideOptions => {
     entry: ['./src/**/*.{ts,tsx,js,jsx}', '!./src/**/*.test.{ts,tsx}'],
     bundle: true,
     clean: true,
-    dts: true,
+    dts: { sourcemap: true },
     minify: false,
     sourcemap: true,
     onSuccess: shouldPublish ? 'pkglab pub --ping' : undefined,

diff --git a/packages/shared/package.json b/packages/shared/package.json
@@ -114,7 +114,9 @@
     "./package.json": "./package.json"
   },
   "files": [
-    "dist"
+    "dist",
+    "!dist/**/*.d.ts.map",
+    "!dist/**/*.d.mts.map"
   ],
   "scripts": {
     "build": "tsdown",

diff --git a/packages/shared/tsdown.config.mts b/packages/shared/tsdown.config.mts
@@ -79,10 +79,8 @@ export default defineConfig(({ watch, env }) => {
     // matching how this package has always published its declarations.
     {
       ...common,
-      dts: { emitDtsOnly: true, sourcemap: false },
-      // Declaration sourcemaps are skipped: rolldown-plugin-dts can't produce them
-      // in this mode (SOURCEMAP_BROKEN warning), and they'd reference src files
-      // that aren't shipped in the tarball anyway.
+      // Local editor go-to-source; maps are correct despite SOURCEMAP_BROKEN and are pack-excluded.
+      dts: { emitDtsOnly: true, sourcemap: true },
       sourcemap: false,
       clean: false,
       unbundle: true,

diff --git a/packages/tanstack-react-start/package.json b/packages/tanstack-react-start/package.json
@@ -58,6 +58,8 @@
   "types": "dist/index.d.ts",
   "files": [
     "dist",
+    "!dist/**/*.d.ts.map",
+    "!dist/**/*.d.mts.map",
     "errors",
     "server",
     "webhooks",

diff --git a/packages/tanstack-react-start/tsdown.config.mts b/packages/tanstack-react-start/tsdown.config.mts
@@ -16,7 +16,7 @@ export default defineConfig(overrideOptions => {
     format: 'esm',
     fixedExtension: false,
     outDir: './dist',
-    dts: true,
+    dts: { sourcemap: true },
     define: {
       PACKAGE_NAME: `"${pkgJson.name}"`,
       PACKAGE_VERSION: `"${pkgJson.version}"`,

diff --git a/packages/ui/package.json b/packages/ui/package.json
@@ -76,7 +76,10 @@
   "types": "dist/index.d.ts",
   "files": [
     "dist",
+    "!dist/**/*.d.ts.map",
+    "!dist/**/*.d.mts.map",
     "dist-mosaic",
+    "!dist-mosaic/**/*.d.ts.map",
     "styles.css.d.ts",
     "register"
   ],

diff --git a/packages/ui/tsdown.config.mts b/packages/ui/tsdown.config.mts
@@ -16,6 +16,7 @@ export default defineConfig(({ watch }) => {
         emitDeclarationOnly: false,
         incremental: false,
         outDir: 'dist',
+        sourcemap: true,
       },
     },
     sourcemap: true,

diff --git a/packages/ui/tsdown.mosaic.config.mts b/packages/ui/tsdown.mosaic.config.mts
@@ -15,7 +15,7 @@ export default defineConfig({
   entry: ['./src/mosaic/styles/index.ts'],
   outDir: './dist-mosaic',
   format: ['esm'],
-  dts: true,
+  dts: { sourcemap: true },
   clean: true,
   target: 'es2022',
   platform: 'browser',

diff --git a/packages/vue/package.json b/packages/vue/package.json
@@ -47,7 +47,9 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "!dist/**/*.d.ts.map",
+    "!dist/**/*.d.mts.map"
   ],
   "scripts": {
     "build": "tsdown --onSuccess \"pnpm build:dts\"",

diff --git a/packages/vue/tsconfig.build.json b/packages/vue/tsconfig.build.json
@@ -2,6 +2,7 @@
   "extends": "./tsconfig.json",
   "compilerOptions": {
     "declaration": true,
+    "declarationMap": true,
     "declarationDir": "./dist",
     "rootDir": "./src",
     "types": ["node"]