docs(repo): Revise and clarify isLoaded description and tab title

.changeset/lucky-scissors-admire.md

@@ -0,0 +1,2 @@
+---
+---

packages/shared/src/react/hooks/useOrganization.tsx

@@ -69,7 +69,7 @@ export type UseOrganizationParams = {
 export type UseOrganizationReturn<T extends UseOrganizationParams> =
   | {
       /**
-       * 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;
       /**

packages/shared/src/react/hooks/useOrganizationList.tsx

@@ -77,7 +77,7 @@ const undefinedPaginatedResource = {
 export type UseOrganizationListReturn<T extends UseOrganizationListParams> =
   | {
       /**
-       * 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;
       /**

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;
       /**