summaryrefslogtreecommitdiff
path: root/packages/SystemUI/src
diff options
context:
space:
mode:
author burakov <burakov@google.com> 2024-07-12 14:34:03 +0000
committer Danny Burakov <burakov@google.com> 2024-07-12 15:01:31 +0000
commit7f22aa27f8f9f5b185320d1f4de9fea86c253fb5 (patch)
tree464a805bac22b7cb2fc5aeafb81147b44a972009 /packages/SystemUI/src
parent64d09c0bd7c9cb9a1025f49cc845f5af5d3cd927 (diff)
[bc25] Add comments to prevent error-prone use of `ShadeMode`.
Flag: com.android.systemui.dual_shade Flag: com.android.systemui.scene_container Bug: 338033836 Test: N/A, this is only a documentation change. Change-Id: I004190355a88c166ecd171eea259652922f8e725
Diffstat (limited to 'packages/SystemUI/src')
-rw-r--r--packages/SystemUI/src/com/android/systemui/shade/domain/interactor/ShadeInteractor.kt6
-rw-r--r--packages/SystemUI/src/com/android/systemui/shade/shared/model/ShadeMode.kt2
2 files changed, 7 insertions, 1 deletions
diff --git a/packages/SystemUI/src/com/android/systemui/shade/domain/interactor/ShadeInteractor.kt b/packages/SystemUI/src/com/android/systemui/shade/domain/interactor/ShadeInteractor.kt
index c1f8a0be646d..45f359efbb7a 100644
--- a/packages/SystemUI/src/com/android/systemui/shade/domain/interactor/ShadeInteractor.kt
+++ b/packages/SystemUI/src/com/android/systemui/shade/domain/interactor/ShadeInteractor.kt
@@ -55,7 +55,11 @@ interface ShadeInteractor : BaseShadeInteractor {
/** Whether the shade can be expanded from QQS to QS. */
val isExpandToQsEnabled: Flow<Boolean>
- /** The version of the shade layout to use. */
+ /**
+ * The version of the shade layout to use.
+ *
+ * Note: Most likely, you want to read [isShadeLayoutWide] instead of this.
+ */
val shadeMode: StateFlow<ShadeMode>
/**
diff --git a/packages/SystemUI/src/com/android/systemui/shade/shared/model/ShadeMode.kt b/packages/SystemUI/src/com/android/systemui/shade/shared/model/ShadeMode.kt
index 8214a24a9a38..a8199a402ef1 100644
--- a/packages/SystemUI/src/com/android/systemui/shade/shared/model/ShadeMode.kt
+++ b/packages/SystemUI/src/com/android/systemui/shade/shared/model/ShadeMode.kt
@@ -29,6 +29,8 @@ sealed interface ShadeMode {
/**
* The split shade where, on large screens and unfolded foldables, the QS and notification parts
* are placed side-by-side and expand/collapse as a single panel.
+ *
+ * Note: This isn't the only mode where the shade is wide.
*/
data object Split : ShadeMode