Use jsdoc style comments.

Author: yuchenshi

packages/firebase/index.d.ts

@@ -9999,59 +9999,59 @@ declare namespace firebase.firestore {
     | 'apple.com';
 
   interface FirebaseIdToken {
-    // Always set to https://securetoken.google.com/PROJECT_ID
+    /** Always set to https://securetoken.google.com/PROJECT_ID */
     iss: string;
 
-    // Always set to PROJECT_ID
+    /** Always set to PROJECT_ID */
     aud: string;
 
-    // The user's unique id
+    /** The user's unique id */
     sub: string;
 
-    // The token issue time, in seconds since epoch
+    /** The token issue time, in seconds since epoch */
     iat: number;
 
-    // The token expiry time, normally 'iat' + 3600
+    /** The token expiry time, normally 'iat' + 3600 */
     exp: number;
 
-    // The user's unique id, must be equal to 'sub'
+    /** The user's unique id, must be equal to 'sub' */
     user_id: string;
 
-    // The time the user authenticated, normally 'iat'
+    /** The time the user authenticated, normally 'iat' */
     auth_time: number;
 
-    // The sign in provider, only set when the provider is 'anonymous'
+    /** The sign in provider, only set when the provider is 'anonymous' */
     provider_id?: 'anonymous';
 
-    // The user's primary email
+    /** The user's primary email */
     email?: string;
 
-    // The user's email verification status
+    /** The user's email verification status */
     email_verified?: boolean;
 
-    // The user's primary phone number
+    /** The user's primary phone number */
     phone_number?: string;
 
-    // The user's display name
+    /** The user's display name */
     name?: string;
 
-    // The user's profile photo URL
+    /** The user's profile photo URL */
     picture?: string;
 
-    // Information on all identities linked to this user
+    /** Information on all identities linked to this user */
     firebase: {
-      // The primary sign-in provider
+      /** The primary sign-in provider */
       sign_in_provider: FirebaseSignInProvider;
 
-      // A map of providers to the user's list of unique identifiers from
-      // each provider
+      /** A map of providers to the user's list of unique identifiers from each provider */
       identities?: { [provider in FirebaseSignInProvider]?: string[] };
     };
 
-    // Custom claims set by the developer
+    /** Custom claims set by the developer */
     [claim: string]: unknown;
 
-    uid?: never; // Try to catch a common mistake of "uid" (should be "sub" instead).
+    // NO LONGER SUPPORTED. Use "sub" instead. (Not a jsdoc comment to avoid generating docs.)
+    uid?: never;
   }
 
   export type EmulatorMockTokenOptions = (