chore(repo): Adjust Typedoc union output (#5641)

Author: LekoArts

.changeset/busy-humans-draw.md

@@ -0,0 +1,5 @@
+---
+'@clerk/types': patch
+---
+
+Improve JSDoc comments

.typedoc/custom-theme.mjs

@@ -297,7 +297,9 @@ class ClerkMarkdownThemeContext extends MarkdownThemeContext {
         const items = headings.map(i => `'${i}'`).join(', ');
         const tabs = md.map(i => `<Tab>${i}</Tab>`).join('\n');
 
-        return `<Tabs items={[${items}]}>
+        return `This function returns a discriminated union type. There are multiple variants of this type available which you can select by clicking on one of the tabs.
+
+<Tabs items={[${items}]}>
 ${tabs}
 </Tabs>`;
       },

packages/types/src/hooks.ts

@@ -43,7 +43,7 @@ export type UseAuthReturn =
        */
       sessionId: undefined;
       /**
-       * The JWT claims for the current session.
+       * The current user's [session claims](https://clerk.com/docs/backend-requests/resources/session-tokens).
        */
       sessionClaims: undefined;
       /**