docs: use kdoc for hw constants

Author: ovitrif

app/src/main/java/to/bitkit/ui/components/HwWalletComponents.kt

@@ -23,10 +23,16 @@ import to.bitkit.ui.theme.Colors
  * HwWalletComponents - Reusable components and utilities for the Hardware Wallet UI.
  * */
 
-// Illustration proportions, taken from the Figma hardware wallet frames (256-wide Visual in a 375 frame).
+/** Illustration width as a fraction of the sheet width — the 256-wide Visual in the 375-wide Figma frame. */
 internal const val HW_ILLUSTRATION_SIZE_RATIO = 256f / 375f
+
+/** Trezor illustration left bleed past the frame, as a fraction of the sheet width (Figma device frames). */
 private const val HW_DEVICE_TREZOR_BLEED_RATIO = 84f / 375f
+
+/** Ledger illustration right bleed past the frame, as a fraction of the sheet width (Figma device frames). */
 private const val HW_DEVICE_LEDGER_BLEED_RATIO = 53f / 375f
+
+/** Vertical stagger between the two device illustrations, as a fraction of the sheet width. */
 private const val HW_DEVICE_STAGGER_RATIO = 12f / 375f
 
 @Composable

app/src/main/java/to/bitkit/ui/sheets/hardware/HardwareSheet.kt

@@ -37,6 +37,7 @@ import to.bitkit.ui.shared.modifiers.sheetHeight
 import to.bitkit.ui.utils.composableWithDefaultTransitions
 import to.bitkit.viewmodels.AppViewModel
 
+/** Runtime nearby-devices permissions needed to BLE-scan: SCAN + CONNECT on Android 12+, else fine location. */
 private val bluetoothPermissions: List<String>
     get() = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
         listOf(

app/src/main/java/to/bitkit/ui/sheets/hardware/HwConnectViewModel.kt

@@ -32,6 +32,7 @@ class HwConnectViewModel @Inject constructor(
     private val hwWalletRepo: HwWalletRepo,
 ) : ViewModel() {
     companion object {
+        /** Delay between scan attempts while searching for a nearby device. */
         private val SCAN_INTERVAL = 2.seconds
     }
 

app/src/main/java/to/bitkit/ui/sheets/hardware/HwPairedSheet.kt

@@ -37,7 +37,7 @@ import to.bitkit.ui.theme.AppThemeSurface
 import to.bitkit.ui.theme.Colors
 import to.bitkit.ui.utils.withAccent
 
-// Width reuses the shared 256-wide Figma Visual ratio; aspect is the coin_stack_3 asset's intrinsic 756x926.
+/** Width reuses the shared 256-wide Figma Visual ratio; aspect is the coin_stack_3 asset's intrinsic 756x926. */
 private const val COINS_ASPECT_RATIO = 756f / 926f
 
 @Composable

app/src/main/java/to/bitkit/ui/sheets/hardware/HwSearchingSheet.kt

@@ -37,16 +37,19 @@ import to.bitkit.ui.theme.AppThemeSurface
 import to.bitkit.ui.theme.Colors
 import to.bitkit.ui.utils.withAccent
 
+/** Diameter of the loading visual (outer dashed ring). */
 private val ANIMATION_SIZE = 280.dp
 
-// Relative sizes from the Figma "Loading Animation" HW frame (311 outer ring): arrows 256, inner ring 207.
+/** Arrows width as a fraction of the loader — 256 in the 311-wide Figma "Loading Animation" HW ring. */
 private const val ARROWS_SIZE_RATIO = 256f / 311f
+
+/** Inner dashed-ring width as a fraction of the loader — 207 in the 311-wide Figma HW ring. */
 private const val INNER_RING_SIZE_RATIO = 207f / 311f
 
-// Figma "Loading Animation" HW variants Smart-Animate linearly through their keyframes:
-// the arrows rotate 90° per 1s step (a counter-clockwise turn every 4s) while the two dashed
-// rings counter-rotate ~180° per 1s step (a turn every ~2s).
+/** Arrows rotation period: the Figma HW variants step 90° per 1s, a counter-clockwise turn every 4s. */
 private const val ARROWS_SPIN_MS = 4000
+
+/** Dashed-ring rotation period: the two rings counter-rotate ~180° per 1s, a turn every ~2s. */
 private const val RING_SPIN_MS = 2000
 
 @Composable