From a0e068c2ba400ff32ff577637d612009a33a24d7 Mon Sep 17 00:00:00 2001 From: Sarah Soutoul Date: Thu, 30 Apr 2026 11:21:34 -0600 Subject: [PATCH 1/3] Add new tab name --- packages/react/src/hooks/useAuth.ts | 2 +- packages/shared/src/react/hooks/useSession.ts | 2 +- packages/shared/src/react/hooks/useUser.ts | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/packages/react/src/hooks/useAuth.ts b/packages/react/src/hooks/useAuth.ts index 1e3619099fb..c8896134628 100644 --- a/packages/react/src/hooks/useAuth.ts +++ b/packages/react/src/hooks/useAuth.ts @@ -33,7 +33,7 @@ type UseAuthOptions = PendingSessionOptions | undefined | null; * * * @unionReturnHeadings - * ["Initialization", "Signed out", "Signed in (no active organization)", "Signed in (with active organization)"] + * ["Loading", "Signed out", "Signed in (no active organization)", "Signed in (with active organization)"] * * @param [options] - An object containing options for the `useAuth()` hook. `treatPendingAsSignedOut` is a boolean that indicates whether pending sessions are considered as signed out or not. Defaults to `true`. * diff --git a/packages/shared/src/react/hooks/useSession.ts b/packages/shared/src/react/hooks/useSession.ts index ce795c7117e..2838ae60430 100644 --- a/packages/shared/src/react/hooks/useSession.ts +++ b/packages/shared/src/react/hooks/useSession.ts @@ -10,7 +10,7 @@ const hookName = `useSession`; * The `useSession()` hook provides access to the current user's [`Session`](https://clerk.com/docs/reference/objects/session) object, as well as helpers for setting the active session. * * @unionReturnHeadings - * ["Initialization", "Signed out", "Signed in"] + * ["Loading", "Signed out", "Signed in"] * * @function * diff --git a/packages/shared/src/react/hooks/useUser.ts b/packages/shared/src/react/hooks/useUser.ts index 4f6388f4986..4987e3ed424 100644 --- a/packages/shared/src/react/hooks/useUser.ts +++ b/packages/shared/src/react/hooks/useUser.ts @@ -8,7 +8,7 @@ const hookName = 'useUser'; * The `useUser()` hook provides access to the current user's [`User`](https://clerk.com/docs/reference/objects/user) object, which contains all the data for a single user in your application and provides methods to manage their account. This hook also allows you to check if the user is signed in and if Clerk has loaded and initialized. * * @unionReturnHeadings - * ["Initialization", "Signed out", "Signed in"] + * ["Loading", "Signed out", "Signed in"] * * @example * ### Get the current user From bf89514d64b44058d92fd7ab62e07475cb24a11c Mon Sep 17 00:00:00 2001 From: Sarah Soutoul Date: Thu, 7 May 2026 14:27:38 -0600 Subject: [PATCH 2/3] Add changeset --- .changeset/slow-breads-pump.md | 2 ++ 1 file changed, 2 insertions(+) create mode 100644 .changeset/slow-breads-pump.md diff --git a/.changeset/slow-breads-pump.md b/.changeset/slow-breads-pump.md new file mode 100644 index 00000000000..a845151cc84 --- /dev/null +++ b/.changeset/slow-breads-pump.md @@ -0,0 +1,2 @@ +--- +--- From 75ea3dd240d470e85213fa05dfeec9e9accaef13 Mon Sep 17 00:00:00 2001 From: Michael Novotny Date: Mon, 11 May 2026 14:01:34 -0500 Subject: [PATCH 3/3] docs(shared): Drop "and initialized" from useUser docblock Aligns with the "Initialization" -> "Loading" tab rename so the docblock no longer mixes terminology. Co-Authored-By: Claude Opus 4.7 (1M context) --- packages/shared/src/react/hooks/useUser.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/shared/src/react/hooks/useUser.ts b/packages/shared/src/react/hooks/useUser.ts index 4987e3ed424..e092c576b6e 100644 --- a/packages/shared/src/react/hooks/useUser.ts +++ b/packages/shared/src/react/hooks/useUser.ts @@ -5,7 +5,7 @@ import { useUserBase } from './base/useUserBase'; const hookName = 'useUser'; /** - * The `useUser()` hook provides access to the current user's [`User`](https://clerk.com/docs/reference/objects/user) object, which contains all the data for a single user in your application and provides methods to manage their account. This hook also allows you to check if the user is signed in and if Clerk has loaded and initialized. + * The `useUser()` hook provides access to the current user's [`User`](https://clerk.com/docs/reference/objects/user) object, which contains all the data for a single user in your application and provides methods to manage their account. This hook also allows you to check if the user is signed in and if Clerk has loaded. * * @unionReturnHeadings * ["Loading", "Signed out", "Signed in"]