From 15fb99dad7712d38a719ab070689c4e0536d0972 Mon Sep 17 00:00:00 2001 From: Sarah Soutoul Date: Thu, 16 Apr 2026 11:43:03 -0600 Subject: [PATCH 1/3] Change wording of isLoaded --- packages/shared/src/react/hooks/useOrganization.tsx | 2 +- .../shared/src/react/hooks/useOrganizationList.tsx | 2 +- packages/shared/src/types/hooks.ts | 12 ++++++------ 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/packages/shared/src/react/hooks/useOrganization.tsx b/packages/shared/src/react/hooks/useOrganization.tsx index 9766524d52c..2927b03caf1 100644 --- a/packages/shared/src/react/hooks/useOrganization.tsx +++ b/packages/shared/src/react/hooks/useOrganization.tsx @@ -69,7 +69,7 @@ export type UseOrganizationParams = { export type UseOrganizationReturn = | { /** - * A boolean that indicates whether Clerk has completed initialization. Initially `false`, becomes `true` once Clerk loads. + * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads but may temporarily return to `false` while auth state is updating, such as when switching organizations. */ isLoaded: false; /** diff --git a/packages/shared/src/react/hooks/useOrganizationList.tsx b/packages/shared/src/react/hooks/useOrganizationList.tsx index 18448f5b2c3..7f11d666f7e 100644 --- a/packages/shared/src/react/hooks/useOrganizationList.tsx +++ b/packages/shared/src/react/hooks/useOrganizationList.tsx @@ -77,7 +77,7 @@ const undefinedPaginatedResource = { export type UseOrganizationListReturn = | { /** - * A boolean that indicates whether Clerk has completed initialization and there is an authenticated user. Initially `false`, becomes `true` once Clerk loads with a user. + * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads but may temporarily return to `false` while auth state is updating, such as when switching organizations. */ isLoaded: false; /** diff --git a/packages/shared/src/types/hooks.ts b/packages/shared/src/types/hooks.ts index 8babc35277a..25b93b19203 100644 --- a/packages/shared/src/types/hooks.ts +++ b/packages/shared/src/types/hooks.ts @@ -26,7 +26,7 @@ type CheckAuthorizationSignedOut = CheckAuthorizationWithoutOrgOrUser; export type UseAuthReturn = | { /** - * A boolean that indicates whether Clerk has completed initialization. Initially `false`, becomes `true` once Clerk loads. + * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads but may temporarily return to `false` while auth state is updating, such as when switching organizations. */ isLoaded: false; /** @@ -123,7 +123,7 @@ export type UseAuthReturn = export type UseSignInReturn = | { /** - * A boolean that indicates whether Clerk has completed initialization. Initially `false`, becomes `true` once Clerk loads. + * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads but may temporarily return to `false` while auth state is updating, such as when switching organizations. */ isLoaded: false; /** @@ -147,7 +147,7 @@ export type UseSignInReturn = export type UseSignUpReturn = | { /** - * A boolean that indicates whether Clerk has completed initialization. Initially `false`, becomes `true` once Clerk loads. + * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads but may temporarily return to `false` while auth state is updating, such as when switching organizations. */ isLoaded: false; /** @@ -171,7 +171,7 @@ export type UseSignUpReturn = export type UseSessionReturn = | { /** - * A boolean that indicates whether Clerk has completed initialization. Initially `false`, becomes `true` once Clerk loads. + * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads but may temporarily return to `false` while auth state is updating, such as when switching organizations. */ isLoaded: false; /** @@ -200,7 +200,7 @@ export type UseSessionReturn = export type UseSessionListReturn = | { /** - * A boolean that indicates whether Clerk has completed initialization. Initially `false`, becomes `true` once Clerk loads. + * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads but may temporarily return to `false` while auth state is updating, such as when switching organizations. */ isLoaded: false; /** @@ -224,7 +224,7 @@ export type UseSessionListReturn = export type UseUserReturn = | { /** - * A boolean that indicates whether Clerk has completed initialization. Initially `false`, becomes `true` once Clerk loads. + * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads but may temporarily return to `false` while auth state is updating, such as when switching organizations. */ isLoaded: false; /** From 69a82588c872058ebce5e56347d283e95ce00662 Mon Sep 17 00:00:00 2001 From: Robert Soriano Date: Mon, 20 Apr 2026 11:21:41 -0700 Subject: [PATCH 2/3] chore: empty changeset --- .changeset/lucky-scissors-admire.md | 2 ++ 1 file changed, 2 insertions(+) create mode 100644 .changeset/lucky-scissors-admire.md diff --git a/.changeset/lucky-scissors-admire.md b/.changeset/lucky-scissors-admire.md new file mode 100644 index 00000000000..a845151cc84 --- /dev/null +++ b/.changeset/lucky-scissors-admire.md @@ -0,0 +1,2 @@ +--- +--- From 2370534e55d72ffdeed42b2fe1f3183ab03c8759 Mon Sep 17 00:00:00 2001 From: Michael Novotny Date: Tue, 21 Apr 2026 10:17:42 -0500 Subject: [PATCH 3/3] docs(shared): Refine isLoaded wording and scope revert clause to hooks that actually revert Co-Authored-By: Claude Opus 4.7 (1M context) --- packages/shared/src/react/hooks/useOrganization.tsx | 2 +- .../shared/src/react/hooks/useOrganizationList.tsx | 2 +- packages/shared/src/types/hooks.ts | 12 ++++++------ 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/packages/shared/src/react/hooks/useOrganization.tsx b/packages/shared/src/react/hooks/useOrganization.tsx index 2927b03caf1..3959db652b5 100644 --- a/packages/shared/src/react/hooks/useOrganization.tsx +++ b/packages/shared/src/react/hooks/useOrganization.tsx @@ -69,7 +69,7 @@ export type UseOrganizationParams = { export type UseOrganizationReturn = | { /** - * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads but may temporarily return to `false` while auth state is updating, such as when switching organizations. + * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads, and can revert to `false` while auth state is updating (for example, when switching organizations via `setActive()`). */ isLoaded: false; /** diff --git a/packages/shared/src/react/hooks/useOrganizationList.tsx b/packages/shared/src/react/hooks/useOrganizationList.tsx index 7f11d666f7e..d1774640619 100644 --- a/packages/shared/src/react/hooks/useOrganizationList.tsx +++ b/packages/shared/src/react/hooks/useOrganizationList.tsx @@ -77,7 +77,7 @@ const undefinedPaginatedResource = { export type UseOrganizationListReturn = | { /** - * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads but may temporarily return to `false` while auth state is updating, such as when switching organizations. + * A boolean that indicates whether Clerk has loaded the current authentication state and there is an authenticated user. Initially `false`, becomes `true` once Clerk loads with a user, and can revert to `false` while auth state is updating (for example, when switching organizations via `setActive()`). */ isLoaded: false; /** diff --git a/packages/shared/src/types/hooks.ts b/packages/shared/src/types/hooks.ts index 25b93b19203..dfd6167f4b4 100644 --- a/packages/shared/src/types/hooks.ts +++ b/packages/shared/src/types/hooks.ts @@ -26,7 +26,7 @@ type CheckAuthorizationSignedOut = CheckAuthorizationWithoutOrgOrUser; export type UseAuthReturn = | { /** - * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads but may temporarily return to `false` while auth state is updating, such as when switching organizations. + * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads, and can revert to `false` while auth state is updating (for example, when switching organizations via `setActive()`). */ isLoaded: false; /** @@ -123,7 +123,7 @@ export type UseAuthReturn = export type UseSignInReturn = | { /** - * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads but may temporarily return to `false` while auth state is updating, such as when switching organizations. + * A boolean that indicates whether Clerk has completed initialization. Initially `false`, becomes `true` once Clerk loads. */ isLoaded: false; /** @@ -147,7 +147,7 @@ export type UseSignInReturn = export type UseSignUpReturn = | { /** - * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads but may temporarily return to `false` while auth state is updating, such as when switching organizations. + * A boolean that indicates whether Clerk has completed initialization. Initially `false`, becomes `true` once Clerk loads. */ isLoaded: false; /** @@ -171,7 +171,7 @@ export type UseSignUpReturn = export type UseSessionReturn = | { /** - * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads but may temporarily return to `false` while auth state is updating, such as when switching organizations. + * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads, and can revert to `false` while auth state is updating (for example, when switching organizations via `setActive()`). */ isLoaded: false; /** @@ -200,7 +200,7 @@ export type UseSessionReturn = export type UseSessionListReturn = | { /** - * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads but may temporarily return to `false` while auth state is updating, such as when switching organizations. + * A boolean that indicates whether Clerk has completed initialization. Initially `false`, becomes `true` once Clerk loads. */ isLoaded: false; /** @@ -224,7 +224,7 @@ export type UseSessionListReturn = export type UseUserReturn = | { /** - * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads but may temporarily return to `false` while auth state is updating, such as when switching organizations. + * A boolean that indicates whether Clerk has loaded the current authentication state. Initially `false`, becomes `true` once Clerk loads, and can revert to `false` while auth state is updating (for example, when switching organizations via `setActive()`). */ isLoaded: false; /**