Docs: Improve KDoc for public API

This commit enhances the KDoc documentation across several public API classes and handlers to improve clarity and developer experience.

*   **Ad Handlers:**
    *   Added `@property` documentation for the `state` property in `InterstitialAdHandler`, `RewardedAdHandler`, and `RewardedInterstitialAdHandler`.
    *   Added `@property` documentation for `state` and `adSize` in `BannerAdHandler`.

*   **`RewardItem`:**
    *   Added a class-level KDoc summary and `@property` documentation for `amount` and `type`.

*   **`RequestConfiguration`:**
    *   Added descriptive comments for all constants related to child-directed treatment, age of consent, and maximum ad content rating.

*   **`ConsentDebugSettings`:**
    *   Updated the KDoc for the `DebugGeography` enum to use `@property` tags for better readability in generated documentation.

Author: robertjamison

basic-ads/src/commonMain/kotlin/app/lexilabs/basic/ads/BannerAdHandler.kt

@@ -54,6 +54,8 @@ package app.lexilabs.basic.ads
  * ```
  *
  * @param activity The platform-specific activity or context required for displaying the ad (e.g., an Android `Activity`).
+ * @property state The current [AdState] of the banner ad.
+ * @property adSize The active [AdSize] of the banner ad.
  */
 @DependsOnGoogleMobileAds
 public expect class BannerAdHandler(activity: Any?) {

basic-ads/src/commonMain/kotlin/app/lexilabs/basic/ads/ConsentDebugSettings.kt

@@ -95,11 +95,11 @@ public expect class ConsentDebugSettings {
      * These settings allow developers to simulate user locations to test how the
      * [Consent.requestConsentInfoUpdate] behaves under different geographical regulations.
      *
-     * @see DEBUG_GEOGRAPHY_DISABLED Disables debug geography settings. The consent SDK will behave as if the device is not in a debug geography.
-     * @see DEBUG_GEOGRAPHY_EEA Simulates the device being located within the European Economic Area (EEA).
-     * @see DEBUG_GEOGRAPHY_NOT_EEA Simulates the device being located outside the European Economic Area (EEA).
-     * @see DEBUG_GEOGRAPHY_REGULATED_US_STATE Simulates the device being located in a US state with specific privacy regulations (e.g., California).
-     * @see DEBUG_GEOGRAPHY_OTHER Simulates the device being located in a region not covered by the other specific debug geographies.
+     * @property DEBUG_GEOGRAPHY_DISABLED Disables debug geography settings. The consent SDK will behave as if the device is not in a debug geography.
+     * @property DEBUG_GEOGRAPHY_EEA Simulates the device being located within the European Economic Area (EEA).
+     * @property DEBUG_GEOGRAPHY_NOT_EEA Simulates the device being located outside the European Economic Area (EEA).
+     * @property DEBUG_GEOGRAPHY_REGULATED_US_STATE Simulates the device being located in a US state with specific privacy regulations (e.g., California).
+     * @property DEBUG_GEOGRAPHY_OTHER Simulates the device being located in a region not covered by the other specific debug geographies.
      */
     public enum class DebugGeography {
         DEBUG_GEOGRAPHY_DISABLED,

basic-ads/src/commonMain/kotlin/app/lexilabs/basic/ads/InterstitialAdHandler.kt

@@ -34,6 +34,7 @@ import androidx.annotation.MainThread
  * ad.show()
  * ```
  *
+ * @property state The current [AdState] of the interstitial ad.
  * @see load
  * @see setListeners
  * @see show

basic-ads/src/commonMain/kotlin/app/lexilabs/basic/ads/RequestConfiguration.kt

@@ -37,16 +37,27 @@ public data class RequestConfiguration(
     }
 
     public companion object {
+        /** Indicates that the child-directed status is not specified. */
         public const val TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED: Int = -1
+        /** Indicates that the app is not child-directed. */
         public const val TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE: Int = 0
+        /** Indicates that the app is child-directed. */
         public const val TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE: Int = 1
+        /** Indicates that the user is under the age of consent. */
         public const val TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE: Int = 1
+        /** Indicates that the user is not under the age of consent. */
         public const val TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE: Int = 0
+        /** Indicates that the under-age-of-consent status is not specified. */
         public const val TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED: Int = -1
+        /** Indicates that the maximum ad content rating is not specified. */
         public const val MAX_AD_CONTENT_RATING_UNSPECIFIED: String = ""
+        /** Content suitable for all audiences. */
         public const val MAX_AD_CONTENT_RATING_G: String = "G"
+        /** Content suitable for most audiences with parental guidance. */
         public const val MAX_AD_CONTENT_RATING_PG: String = "PG"
+        /** Content suitable for teen and older audiences. */
         public const val MAX_AD_CONTENT_RATING_T: String = "T"
+        /** Content suitable only for mature audiences. */
         public const val MAX_AD_CONTENT_RATING_MA: String = "MA"
 
     }

basic-ads/src/commonMain/kotlin/app/lexilabs/basic/ads/RewardItem.kt

@@ -1,7 +1,14 @@
 package app.lexilabs.basic.ads
 
+/**
+ * Represents a reward that the user can earn.
+ *
+ * @property amount The amount of the reward.
+ * @property type The type of the reward.
+ */
 public expect class RewardItem {
+    /** The amount of the reward. */
     public val amount: Int
+    /** The type of the reward. */
     public val type: String
 }
-

basic-ads/src/commonMain/kotlin/app/lexilabs/basic/ads/RewardedAdHandler.kt

@@ -32,6 +32,7 @@ package app.lexilabs.basic.ads
  * ad.show()
  * ```
  *
+ * @property state The current [AdState] of the rewarded ad.
  * @see load
  * @see setListeners
  * @see show

basic-ads/src/commonMain/kotlin/app/lexilabs/basic/ads/RewardedInterstitialAdHandler.kt

@@ -32,6 +32,7 @@ package app.lexilabs.basic.ads
  * ad.show()
  * ```
  *
+ * @property state The current [AdState] of the rewarded interstitial ad.
  * @see load
  * @see setListeners
  * @see show