Adding annotations to BottomSheetBehavior

PiperOrigin-RevId: 260217762

Author: ikim24

lib/java/com/google/android/material/bottomsheet/BottomSheetBehavior.java

@@ -30,6 +30,7 @@
 import android.os.Build.VERSION_CODES;
 import android.os.Parcel;
 import android.os.Parcelable;
+import androidx.annotation.FloatRange;
 import androidx.annotation.IntDef;
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
@@ -136,17 +137,17 @@ public abstract static class BottomSheetCallback {
   /**
    * This flag will preserve the fitToContents boolean value on configuration change.
    */
-  public static final int SAVE_FIT_TO_CONTENTS = 0x2;
+  public static final int SAVE_FIT_TO_CONTENTS = 1 << 1;
 
   /**
    * This flag will preserve the hideable boolean value on configuration change.
    */
-  public static final int SAVE_HIDEABLE = 0x4;
+  public static final int SAVE_HIDEABLE = 1 << 2;
 
   /**
    * This flag will preserve the skipCollapsed boolean value on configuration change.
    */
-  public static final int SAVE_SKIP_COLLAPSED = 0x8;
+  public static final int SAVE_SKIP_COLLAPSED = 1 << 3;
 
   /**
    * This flag will preserve all aforementioned values on configuration change.
@@ -160,7 +161,22 @@ public abstract static class BottomSheetCallback {
    */
   public static final int SAVE_NONE = 0;
 
-  private int saveFlags = SAVE_NONE;
+  /** @hide */
+  @RestrictTo(LIBRARY_GROUP)
+  @IntDef(
+      flag = true,
+      value = {
+        SAVE_PEEK_HEIGHT,
+        SAVE_FIT_TO_CONTENTS,
+        SAVE_HIDEABLE,
+        SAVE_SKIP_COLLAPSED,
+        SAVE_ALL,
+        SAVE_NONE,
+      })
+  @Retention(RetentionPolicy.SOURCE)
+  public @interface SaveFlags {}
+
+  @SaveFlags private int saveFlags = SAVE_NONE;
 
   private static final float HIDE_THRESHOLD = 0.5f;
 
@@ -728,7 +744,7 @@ public final int getPeekHeight() {
    * @param ratio a float between 0 and 1, representing the {@link #STATE_HALF_EXPANDED} ratio.
    * @attr com.google.android.material.R.styleable#BottomSheetBehavior_Layout_behavior_halfExpandedRatio
    */
-  public void setHalfExpandedRatio(float ratio) {
+  public void setHalfExpandedRatio(@FloatRange(from = 0.0f, to = 1.0f) float ratio) {
 
     if ((ratio <= 0) || (ratio >= 1)) {
       throw new IllegalArgumentException("ratio must be a float value between 0 and 1");
@@ -757,6 +773,7 @@ public void setExpandedOffset(int offset) {
    *
    * @attr com.google.android.material.R.styleable#BottomSheetBehavior_Layout_behavior_halfExpandedRatio
    */
+  @FloatRange(from = 0.0f, to = 1.0f)
   public float getHalfExpandedRatio() {
     return halfExpandedRatio;
   }
@@ -818,7 +835,7 @@ public boolean getSkipCollapsed() {
    * @see #getSaveFlags()
    * @attr ref com.google.android.material.R.styleable#BottomSheetBehavior_Layout_behavior_saveFlags
    */
-  public void setSaveFlags(int flags) {
+  public void setSaveFlags(@SaveFlags int flags) {
     this.saveFlags = flags;
   }
   /**
@@ -827,6 +844,7 @@ public void setSaveFlags(int flags) {
    * @see #setSaveFlags(int)
    * @attr ref com.google.android.material.R.styleable#BottomSheetBehavior_Layout_behavior_saveFlags
    */
+  @SaveFlags
    public int getSaveFlags() {
     return this.saveFlags;
   }
@@ -1273,7 +1291,10 @@ int getPeekHeightMin() {
    * Disables the shaped corner {@link ShapeAppearanceModel} interpolation transition animations.
    * Will have no effect unless the sheet utilizes a {@link MaterialShapeDrawable} with set shape
    * theming properties. Only For use in UI testing.
+   *
+   * @hide
    */
+  @RestrictTo(LIBRARY_GROUP)
   @VisibleForTesting
   public void disableShapeAnimations() {
     // Sets the shape value animator to null, prevents animations from occuring during testing.