change approach to jsdoc @deprecated notice

Author: alexcarpenter

.changeset/auth-misimport-runtime-error.md

@@ -2,4 +2,4 @@
 "@clerk/nextjs": patch
 ---
 
-Improved error message when `auth` is accidentally imported from `@clerk/nextjs` instead of `@clerk/nextjs/server`. Previously, bundlers would show a generic `'auth' is not exported` error. Now, a clear runtime error points developers to the correct import path.
+Improved developer experience when `auth` is accidentally imported from `@clerk/nextjs` instead of `@clerk/nextjs/server`. The `auth` export now includes a `@deprecated` JSDoc tag with a clear message guiding developers to the correct import path, visible on hover in IDEs.

packages/nextjs/src/__tests__/auth-misimport.test.ts

@@ -85,7 +85,7 @@ export const ClerkProvider = ComponentsModule.ClerkProvider as ServerComponentsS
 export const Show = ComponentsModule.Show as ServerComponentsServerModuleTypes['Show'];
 
 /**
- * `auth` is not available from this import path.
+ * @deprecated `auth()` must be imported from `@clerk/nextjs/server`, not `@clerk/nextjs`.
  *
  * **To fix this error:**
  * ```diff
@@ -96,4 +96,4 @@ export const Show = ComponentsModule.Show as ServerComponentsServerModuleTypes['
  * The `auth` function is only available in server-side contexts:
  * API Routes, Server Components, Server Actions, and Middleware.
  */
-export { auth } from './server-only-stubs';
+export declare const auth: never;