format

Author: milaGGL

handwritten/firestore/dev/src/pipelines/expression.ts

@@ -2878,40 +2878,40 @@ export abstract class Expression
 
   /**
    * @beta
-   * Creates an expression that returns the `elseValue` argument if this expression results in a null value, else
+   * Creates an expression that returns the `elseValue` argument if this expression evaluates to null, else
    * return the result of this expression evaluation.
    *
    * @remarks
-   * This function provides a fallback for both absent and explicit null values. In contrast, {@link ifAbsent}
+   * This function provides a fallback for both absent and explicit null values. In contrast, {@link Expression#ifAbsent}
    * only triggers for missing fields.
    *
    * @example
    * ```typescript
-   * // Returns the user's preferred name, or if that is null or absent, returns their full name.
+   * // Returns the user's preferred name, or if that is null, returns their full name.
    * field("preferredName").ifNull(field("fullName"))
    * ```
    *
-   * @param elseExpression The Expression that will be evaluated if this Expression evaluates to a null or absent value.
+   * @param elseExpression The Expression that will be evaluated if this Expression evaluates to null.
    * @returns A new [Expression] representing the ifNull operation.
    */
   ifNull(elseExpression: Expression): FunctionExpression;
 
   /**
    * @beta
-   * Creates an expression that returns the `elseValue` argument if this expression results in a null value, else
+   * Creates an expression that returns the `elseValue` argument if this expression evaluates to null, else
    * return the result of this expression evaluation.
    *
    * @remarks
-   * This function provides a fallback for both absent and explicit null values. In contrast, {@link ifAbsent}
+   * This function provides a fallback for both absent and explicit null values. In contrast, {@link Expression#ifAbsent}
    * only triggers for missing fields.
    *
    * @example
    * ```typescript
-   * // Returns the user's display name, or returns "Anonymous" if the field is null or absent.
+   * // Returns the user's display name, or returns "Anonymous" if the field is null.
    * field("displayName").ifNull("Anonymous")
    * ```
    *
-   * @param elseValue The value that will be returned if this Expression evaluates to a null or absent value.
+   * @param elseValue The value that will be returned if this Expression evaluates to null.
    * @returns A new [Expression] representing the ifNull operation.
    */
   ifNull(elseValue: unknown): FunctionExpression;
@@ -9268,16 +9268,16 @@ export function ifAbsent(
  *
  * @remarks
  * This function provides a fallback for both absent and explicit null values. In contrast,
- * {@link ifAbsent} only triggers for missing fields.
+ * {@link Expression#ifAbsent} only triggers for missing fields.
  *
  * @example
  * ```typescript
- * // Returns the user's preferred name, or if that is null or absent, returns their full name.
+ * // Returns the user's preferred name, or if that is null, returns their full name.
  * ifNull(field("preferredName"), field("fullName"))
  * ```
  *
- * @param ifExpr The expression to check for null or absence.
- * @param elseExpr The expression that will be evaluated and returned if `ifExpr` is null or absent.
+ * @param ifExpr The expression to check for null.
+ * @param elseExpr The expression that will be evaluated and returned if `ifExpr` is null.
  * @returns A new `Expression` representing the ifNull operation.
  */
 export function ifNull(
@@ -9292,16 +9292,16 @@ export function ifNull(
  *
  * @remarks
  * This function provides a fallback for both absent and explicit null values. In contrast,
- * {@link ifAbsent} only triggers for missing fields.
+ * {@link Expression#ifAbsent} only triggers for missing fields.
  *
  * @example
  * ```typescript
- * // Returns the user's display name, or returns "Anonymous" if the field is null or absent.
+ * // Returns the user's display name, or returns "Anonymous" if the field is null.
  * ifNull(field("displayName"), "Anonymous")
  * ```
  *
- * @param ifExpr The expression to check for null or absence.
- * @param elseValue The value that will be returned if `ifExpr` evaluates to a null or absent value.
+ * @param ifExpr The expression to check for null.
+ * @param elseValue The value that will be returned if `ifExpr` evaluates to null.
  * @returns A new `Expression` representing the ifNull operation.
  */
 export function ifNull(
@@ -9316,17 +9316,17 @@ export function ifNull(
  *
  * @remarks
  * This function provides a fallback for both absent and explicit null values. In contrast,
- * {@link ifAbsent} only triggers for missing fields.
+ * {@link Expression#ifAbsent} only triggers for missing fields.
  *
  * @example
  * ```typescript
- * // Returns the user's preferred name, or if that is null or absent, returns their full name.
+ * // Returns the user's preferred name, or if that is null, returns their full name.
  * ifNull("preferredName", field("fullName"))
  * ```
  *
- * @param ifFieldName The field to check for null or absence.
+ * @param ifFieldName The field to check for null.
  * @param elseExpr The expression that will be evaluated and returned if `ifFieldName` is
- * null or absent.
+ * null.
  * @returns A new `Expression` representing the ifNull operation.
  */
 export function ifNull(
@@ -9341,16 +9341,16 @@ export function ifNull(
  *
  * @remarks
  * This function provides a fallback for both absent and explicit null values. In contrast,
- * {@link ifAbsent} only triggers for missing fields.
+ * {@link Expression#ifAbsent} only triggers for missing fields.
  *
  * @example
  * ```typescript
- * // Returns the user's display name, or returns "Anonymous" if the field is null or absent.
+ * // Returns the user's display name, or returns "Anonymous" if the field is null.
  * ifNull("displayName", "Anonymous")
  * ```
  *
- * @param ifFieldName The field to check for null or absence.
- * @param elseValue The value that will be returned if `ifFieldName` is null or absent.
+ * @param ifFieldName The field to check for null.
+ * @param elseValue The value that will be returned if `ifFieldName` is null.
  * @returns A new `Expression` representing the ifNull operation.
  */
 export function ifNull(

handwritten/firestore/types/firestore.d.ts

@@ -5456,7 +5456,7 @@ declare namespace FirebaseFirestore {
 
       /**
        * @beta
-       * Creates an expression that returns the `elseValue` argument if this expression results in a null value, else
+       * Creates an expression that returns the `elseValue` argument if this expression evaluates to null, else
        * return the result of this expression evaluation.
        *
        * @remarks
@@ -5465,18 +5465,18 @@ declare namespace FirebaseFirestore {
        *
        * @example
        * ```typescript
-       * // Returns the user's display name, or returns "Anonymous" if the field is null or absent.
+       * // Returns the user's display name, or returns "Anonymous" if the field is null.
        * field("displayName").ifNull("Anonymous")
        * ```
        *
-       * @param elseValue The value that will be returned if this Expression evaluates to a null value.
+       * @param elseValue The value that will be returned if this Expression evaluates to null.
        * @returns A new `Expression` representing the ifNull operation.
        */
       ifNull(elseValue: unknown): FunctionExpression;
 
       /**
        * @beta
-       * Creates an expression that returns the `elseValue` argument if this expression results in a null value, else
+       * Creates an expression that returns the `elseValue` argument if this expression evaluates to null, else
        * return the result of this expression evaluation.
        *
        * @remarks
@@ -5485,18 +5485,18 @@ declare namespace FirebaseFirestore {
        *
        * @example
        * ```typescript
-       * // Returns the user's preferred name, or if that is null or absent, returns their full name.
+       * // Returns the user's preferred name, or if that is null, returns their full name.
        * field("preferredName").ifNull(field("fullName"))
        * ```
        *
-       * @param elseExpression The Expression that will be evaluated if this Expression evaluates to a null value.
+       * @param elseExpression The Expression that will be evaluated if this Expression evaluates to null.
        * @returns A new `Expression` representing the ifNull operation.
        */
       ifNull(elseExpression: Expression): FunctionExpression;
 
       /**
        * @beta
-       * Creates an expression that Returns the first non-null, non-absent argument, without evaluating
+       * Creates an expression that returns the first non-null, non-absent argument, without evaluating
        * the rest of the arguments. When all arguments are null or absent, returns the last argument.
        *
        * @example
@@ -10958,12 +10958,12 @@ declare namespace FirebaseFirestore {
      *
      * @example
      * ```typescript
-     * // Returns the user's preferred name, or if that is null or absent, returns their full name.
+     * // Returns the user's preferred name, or if that is null, returns their full name.
      * ifNull(field("preferredName"), field("fullName"))
      * ```
      *
      * @param ifExpr The expression to check for null.
-     * @param elseExpr The value that will be returned if `ifExpr` evaluates to a null value.
+     * @param elseExpr The value that will be returned if `ifExpr` evaluates to null.
      * @returns A new {@code Expression} representing the ifNull operation.
      */
     export function ifNull(
@@ -10982,12 +10982,12 @@ declare namespace FirebaseFirestore {
      *
      * @example
      * ```typescript
-     * // Returns the user's display name, or returns "Anonymous" if the field is null or absent.
+     * // Returns the user's display name, or returns "Anonymous" if the field is null.
      * ifNull(field("displayName"), "Anonymous")
      * ```
      *
      * @param ifExpr The expression to check for null.
-     * @param elseValue The value that will be returned if `ifExpr` evaluates to a null value.
+     * @param elseValue The value that will be returned if `ifExpr` evaluates to null.
      * @returns A new {@code Expression} representing the ifNull operation.
      */
     export function ifNull(
@@ -11006,7 +11006,7 @@ declare namespace FirebaseFirestore {
      *
      * @example
      * ```typescript
-     * // Returns the user's preferred name, or if that is null or absent, returns their full name.
+     * // Returns the user's preferred name, or if that is null, returns their full name.
      * ifNull("preferredName", field("fullName"))
      * ```
      *
@@ -11031,7 +11031,7 @@ declare namespace FirebaseFirestore {
      *
      * @example
      * ```typescript
-     * // Returns the user's display name, or returns "Anonymous" if the field is null or absent.
+     * // Returns the user's display name, or returns "Anonymous" if the field is null.
      * ifNull("displayName", "Anonymous")
      * ```
      *