Refactor: Remove explicit activity parameter from composables

*   **Implementation Refactoring:**
    *   Functions in `commonMain` that were previously concrete (e.g., `rememberBannerAd`, `rememberNativeAd`) have been converted to `expect` functions.
    *   The implementation logic has been moved to the `actual` declarations in the `androidMain` and `iosMain` source sets to handle platform-specific details.

*   **API Dump Update:**
    *   The `basic-ads.api` file has been updated to reflect these signature changes.

Author: robertjamison

basic-ads/api/basic-ads.api

@@ -90,6 +90,9 @@ public final class app/lexilabs/basic/ads/BannerAdListener : com/google/android/
 public final class app/lexilabs/basic/ads/BasicAds {
 	public static final field $stable I
 	public static final field INSTANCE Lapp/lexilabs/basic/ads/BasicAds;
+	public final fun DisableMediationAdapterInitialization (Landroidx/compose/runtime/Composer;I)V
+	public final fun Initialize (Landroidx/compose/runtime/Composer;I)V
+	public final fun OpenDebugMenu (Ljava/lang/String;Landroidx/compose/runtime/Composer;I)V
 	public final fun disableMediationAdapterInitialization (Ljava/lang/Object;)V
 	public final fun getConfiguration ()Lapp/lexilabs/basic/ads/RequestConfiguration;
 	public final fun getErrorDomain ()Ljava/lang/String;
@@ -169,6 +172,7 @@ public final class app/lexilabs/basic/ads/ConsentRequestParameters$Builder {
 }
 
 public final class app/lexilabs/basic/ads/ConvertersKt {
+	public static final fun getActivity (Landroid/content/Context;)Landroid/app/Activity;
 	public static final fun toAndroid (Lapp/lexilabs/basic/ads/AdSize;)Lcom/google/android/gms/ads/AdSize;
 	public static final fun toAndroid (Lapp/lexilabs/basic/ads/RequestConfiguration$PublisherPrivacyPersonalizationState;)Lcom/google/android/gms/ads/RequestConfiguration$PublisherPrivacyPersonalizationState;
 	public static final fun toAndroid (Lapp/lexilabs/basic/ads/RequestConfiguration;)Lcom/google/android/gms/ads/RequestConfiguration;
@@ -295,52 +299,67 @@ public final class app/lexilabs/basic/ads/composable/BannerAdKt {
 public final class app/lexilabs/basic/ads/composable/ConsentPopupKt {
 	public static final fun ConsentPopup (Lapp/lexilabs/basic/ads/Consent;Lkotlin/jvm/functions/Function1;Landroidx/compose/runtime/Composer;II)V
 	public static final fun ConsentPopup (Ljava/lang/Object;Lkotlin/jvm/functions/Function1;Landroidx/compose/runtime/Composer;II)V
+	public static final fun ConsentPopup (Lkotlin/jvm/functions/Function1;Landroidx/compose/runtime/Composer;I)V
 }
 
 public final class app/lexilabs/basic/ads/composable/InterstitialAdKt {
 	public static final fun InterstitialAd (Lapp/lexilabs/basic/ads/InterstitialAdHandler;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Landroidx/compose/runtime/Composer;II)V
 	public static final fun InterstitialAd (Ljava/lang/Object;Ljava/lang/String;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Landroidx/compose/runtime/Composer;II)V
+	public static final fun InterstitialAd (Ljava/lang/String;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Landroidx/compose/runtime/Composer;II)V
 }
 
 public final class app/lexilabs/basic/ads/composable/NativeAdKt {
 	public static final fun NativeAd (Lapp/lexilabs/basic/ads/nativead/NativeAdHandler;Lapp/lexilabs/basic/ads/nativead/NativeAdTemplate;Landroidx/compose/runtime/Composer;II)V
+	public static final fun NativeAd (Lapp/lexilabs/basic/ads/nativead/NativeAdTemplate;Ljava/lang/String;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Landroidx/compose/runtime/Composer;II)V
 	public static final fun NativeAd (Ljava/lang/Object;Lapp/lexilabs/basic/ads/nativead/NativeAdTemplate;Ljava/lang/String;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Landroidx/compose/runtime/Composer;II)V
 }
 
 public final class app/lexilabs/basic/ads/composable/RememberBannerAdKt {
 	public static final fun rememberBannerAd (Ljava/lang/Object;Ljava/lang/String;Lapp/lexilabs/basic/ads/AdSize;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Landroidx/compose/runtime/Composer;II)Landroidx/compose/runtime/MutableState;
+	public static final fun rememberBannerAd (Ljava/lang/String;Lapp/lexilabs/basic/ads/AdSize;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Landroidx/compose/runtime/Composer;II)Landroidx/compose/runtime/MutableState;
 }
 
 public final class app/lexilabs/basic/ads/composable/RememberConsentKt {
+	public static final fun rememberConsent (Landroidx/compose/runtime/Composer;I)Landroidx/compose/runtime/MutableState;
+	public static final fun rememberConsent (Lapp/lexilabs/basic/ads/ConsentDebugSettings;Landroidx/compose/runtime/Composer;I)Landroidx/compose/runtime/MutableState;
+	public static final fun rememberConsent (Lapp/lexilabs/basic/ads/ConsentRequestParameters;Landroidx/compose/runtime/Composer;I)Landroidx/compose/runtime/MutableState;
 	public static final fun rememberConsent (Ljava/lang/Object;Landroidx/compose/runtime/Composer;I)Landroidx/compose/runtime/MutableState;
 }
 
 public final class app/lexilabs/basic/ads/composable/RememberInterstitialAdKt {
 	public static final fun rememberInterstitialAd (Ljava/lang/Object;Ljava/lang/String;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Landroidx/compose/runtime/Composer;II)Landroidx/compose/runtime/MutableState;
+	public static final fun rememberInterstitialAd (Ljava/lang/String;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Landroidx/compose/runtime/Composer;II)Landroidx/compose/runtime/MutableState;
 }
 
 public final class app/lexilabs/basic/ads/composable/RememberNativeAdKt {
 	public static final fun rememberNativeAd (Ljava/lang/Object;Ljava/lang/String;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Landroidx/compose/runtime/Composer;II)Landroidx/compose/runtime/MutableState;
+	public static final fun rememberNativeAd (Ljava/lang/String;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Landroidx/compose/runtime/Composer;II)Landroidx/compose/runtime/MutableState;
 }
 
 public final class app/lexilabs/basic/ads/composable/RememberRewardedAdKt {
 	public static final fun rememberRewardedAd (Ljava/lang/Object;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Landroidx/compose/runtime/Composer;II)Landroidx/compose/runtime/MutableState;
 	public static final fun rememberRewardedAd (Ljava/lang/Object;Ljava/lang/String;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Landroidx/compose/runtime/Composer;II)Landroidx/compose/runtime/MutableState;
+	public static final fun rememberRewardedAd (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Landroidx/compose/runtime/Composer;II)Landroidx/compose/runtime/MutableState;
+	public static final fun rememberRewardedAd (Ljava/lang/String;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Landroidx/compose/runtime/Composer;II)Landroidx/compose/runtime/MutableState;
 }
 
 public final class app/lexilabs/basic/ads/composable/RememberRewardedInterstitialAdKt {
 	public static final fun rememberRewardedInterstitialAd (Ljava/lang/Object;Ljava/lang/String;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Landroidx/compose/runtime/Composer;II)Landroidx/compose/runtime/MutableState;
+	public static final fun rememberRewardedInterstitialAd (Ljava/lang/String;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Landroidx/compose/runtime/Composer;II)Landroidx/compose/runtime/MutableState;
 }
 
 public final class app/lexilabs/basic/ads/composable/RewardedAdKt {
 	public static final fun RewardedAd (Lapp/lexilabs/basic/ads/RewardedAdHandler;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Landroidx/compose/runtime/Composer;II)V
 	public static final fun RewardedAd (Ljava/lang/Object;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Landroidx/compose/runtime/Composer;III)V
 	public static final fun RewardedAd (Ljava/lang/Object;Ljava/lang/String;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Landroidx/compose/runtime/Composer;II)V
+	public static final fun RewardedAd (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Landroidx/compose/runtime/Composer;II)V
+	public static final fun RewardedAd (Ljava/lang/String;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Landroidx/compose/runtime/Composer;II)V
 }
 
 public final class app/lexilabs/basic/ads/composable/RewardedInterstitialAdKt {
 	public static final fun RewardedInterstitialAd (Lapp/lexilabs/basic/ads/RewardedInterstitialAdHandler;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Landroidx/compose/runtime/Composer;II)V
 	public static final fun RewardedInterstitialAd (Ljava/lang/Object;Ljava/lang/String;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Landroidx/compose/runtime/Composer;II)V
+	public static final fun RewardedInterstitialAd (Ljava/lang/String;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function0;Lkotlin/jvm/functions/Function1;Lkotlin/jvm/functions/Function0;Landroidx/compose/runtime/Composer;II)V
 }
 
 public final class app/lexilabs/basic/ads/nativead/NativeAdConvertersKt {

basic-ads/src/androidMain/kotlin/app/lexilabs/basic/ads/composable/RememberBannerAd.kt

@@ -67,4 +67,63 @@ public actual fun rememberBannerAd(
         else -> { /** DO NOTHING **/ }
     }
     return ad
+}
+
+/**
+ * A Composable function that remembers a [BannerAdHandler] across compositions.
+ *
+ * This function creates and manages a [BannerAdHandler] instance, ensuring it persists
+ * across recompositions. It automatically attempts to load an ad when the ad's state
+ * is [AdState.DISMISSED] or [AdState.NONE].
+ *
+ * **Note:** This Composable depends on the Google Mobile Ads SDK. Ensure that the
+ * SDK is properly integrated into your project.
+ *
+ * @param activity The current Activity or Context. This is crucial for the ad to function correctly.
+ *                 It's recommended to pass the result of `LocalContext.current as Activity`.
+ * @param adUnitId The ad unit ID for the banner ad. Defaults to [AdUnitId.BANNER_DEFAULT].
+ * @param adSize The size of the banner ad. Defaults to [AdSize.FULL_BANNER].
+ * @param onLoad A callback invoked when the ad has successfully loaded.
+ * @param onFailure A callback invoked when the ad fails to load. It provides an [Exception]
+ *                  with details about the failure.
+ * @param onDismissed A callback invoked when the ad is dismissed by the user.
+ * @param onShown A callback invoked when the ad is shown on the screen.
+ * @param onImpression A callback invoked when an impression is recorded for the ad.
+ * @param onClick A callback invoked when the ad is clicked by the user.
+ * @return A [MutableState] holding the [BannerAdHandler]. You can use this state to
+ *         interact with the ad (e.g., to display it in your UI).
+ */
+@DependsOnGoogleMobileAds
+@Deprecated("The `activity` argument is no longer required as of v1.1.0-beta01")
+@RequiresPermission("android.permission.INTERNET")
+@Composable
+public actual fun rememberBannerAd(
+    activity: Any?,
+    adUnitId: String,
+    adSize: AdSize,
+    onLoad: () -> Unit,
+    onFailure: (Exception) -> Unit,
+    onDismissed: () -> Unit,
+    onShown: () -> Unit,
+    onImpression: () -> Unit,
+    onClick: () -> Unit
+): MutableState<BannerAdHandler> {
+    val ad = remember(activity) { mutableStateOf(BannerAdHandler(activity)) }
+    when(ad.value.state){
+        AdState.DISMISSED,
+        AdState.NONE -> {
+            ad.value.load(
+                adUnitId = adUnitId,
+                adSize = adSize,
+                onLoad = onLoad,
+                onFailure = onFailure,
+                onDismissed = onDismissed,
+                onShown = onShown,
+                onImpression = onImpression,
+                onClick = onClick
+            )
+        }
+        else -> { /** DO NOTHING **/ }
+    }
+    return ad
 }

basic-ads/src/androidMain/kotlin/app/lexilabs/basic/ads/composable/RememberConsent.kt

@@ -102,3 +102,31 @@ public actual fun rememberConsent(debugSettings: ConsentDebugSettings): MutableS
     return consent
 }
 
+/**
+ * Composable function to remember and manage user consent for ads.
+ *
+ * This function creates and remembers a [Consent] object, which handles interactions
+ * with the Google User Messaging Platform (UMP) SDK to obtain and manage user consent
+ * for personalized advertising.
+ *
+ * It initializes the consent state and checks if privacy options are required and if ads can be requested.
+ *
+ * @param activity The current Activity context. This is crucial for the UMP SDK to function correctly.
+ *                 It's recommended to pass the result of `LocalContext.current as? Activity`.
+ * @return A [MutableState] holding the [Consent] object. This allows observing and reacting
+ *         to changes in the consent status within your Composable UI.
+ *
+ * @see Consent
+ * @see DependsOnGoogleUserMessagingPlatform
+ */
+@DependsOnGoogleUserMessagingPlatform
+@Deprecated("The `activity` argument is no longer required as of v1.1.0-beta01")
+@Composable
+public actual fun rememberConsent(
+    activity: Any?
+): MutableState<Consent> {
+    val consent = remember(activity) { mutableStateOf(Consent(activity)) }
+    consent.value.isPrivacyOptionsRequired()
+    consent.value.canRequestAds()
+    return consent
+}

basic-ads/src/androidMain/kotlin/app/lexilabs/basic/ads/composable/RememberInterstitialAd.kt

@@ -43,4 +43,40 @@ public actual fun rememberInterstitialAd(
         else -> { /** DO NOTHING **/ }
     }
     return ad
+}
+
+/**
+ * Composable function to remember an interstitial ad.
+ *
+ * This function creates and manages an [InterstitialAdHandler] instance,
+ * automatically loading an ad when the state is [AdState.DISMISSED] or [AdState.NONE].
+ *
+ * @param activity The activity context, required for ad loading.
+ * @param adUnitId The ad unit ID for the interstitial ad. Defaults to [AdUnitId.INTERSTITIAL_DEFAULT].
+ * @param onLoad A callback function invoked when the ad is successfully loaded.
+ * @param onFailure A callback function invoked when ad loading fails, providing the [Exception] that occurred.
+ * @return A [MutableState] holding the [InterstitialAdHandler]. You can use this to control and observe the ad's state (e.g., to show the ad).
+ */
+@DependsOnGoogleMobileAds
+@Deprecated("The `activity` argument is no longer required as of v1.1.0-beta01")
+@Composable
+public actual fun rememberInterstitialAd(
+    activity: Any?,
+    adUnitId: String,
+    onLoad: () -> Unit,
+    onFailure: (Exception) -> Unit
+): MutableState<InterstitialAdHandler> {
+    val ad = remember(activity) { mutableStateOf(InterstitialAdHandler(activity)) }
+    when(ad.value.state){
+        AdState.DISMISSED,
+        AdState.NONE -> {
+            ad.value.load(
+                adUnitId = adUnitId,
+                onLoad = onLoad,
+                onFailure = onFailure
+            )
+        }
+        else -> { /** DO NOTHING **/ }
+    }
+    return ad
 }

basic-ads/src/androidMain/kotlin/app/lexilabs/basic/ads/composable/RememberNativeAd.kt

@@ -12,6 +12,7 @@ import app.lexilabs.basic.ads.AdUnitId
 import app.lexilabs.basic.ads.DependsOnGoogleMobileAds
 import app.lexilabs.basic.ads.getActivity
 import app.lexilabs.basic.ads.nativead.NativeAdHandler
+import kotlin.text.String
 
 /**
  * Remembers a [NativeAdHandler] across compositions.
@@ -60,4 +61,55 @@ public actual fun rememberNativeAd(
         else -> { /** DO NOTHING **/ }
     }
     return ad
+}
+
+/**
+ * Remembers a [NativeAdHandler] across compositions.
+ * @param activity the current Activity (only needed for Android Impl)
+ * @param adUnitId Your AdMob AdUnitId [String]
+ * @param onLoad Lambda expression that executes after the [NativeAdHandler] has fully loaded
+ * @param onFailure Lambda expression that executes after the ad fails to load or redirect
+ * @param onDismissed Lambda that executes when the user closes the ad
+ * @param onShown Lambda expression that executes after the ad is presented
+ * @param onImpression Lambda expression that executes after the user has seen the ad
+ * @param onClick Lambda expression that executes after the user clicks the ad
+ * @return a [MutableState] of [NativeAdHandler]
+ * @see AdUnitId.autoSelect
+ */
+@DependsOnGoogleMobileAds
+@Deprecated("The `activity` argument is no longer required as of v1.1.0-beta01")
+@RequiresPermission("android.permission.INTERNET")
+@Composable
+public actual fun rememberNativeAd(
+    activity: Any?,
+    adUnitId: String,
+    onLoad: () -> Unit,
+    onFailure: (Exception) -> Unit,
+    onDismissed: () -> Unit,
+    onShown: () -> Unit,
+    onImpression: () -> Unit,
+    onClick: () -> Unit,
+): MutableState<NativeAdHandler> {
+    val ad = remember(activity) { mutableStateOf(NativeAdHandler(activity)) }
+    DisposableEffect(ad) {
+        onDispose {
+            ad.value.destroy()
+        }
+    }
+    when(ad.value.state){
+        AdState.DISMISSED,
+        AdState.NONE -> {
+            ad.value.load(
+                adUnitId = adUnitId,
+                onLoad = onLoad,
+                onFailure = onFailure,
+                onDismissed = onDismissed,
+                onShown = onShown,
+                onImpression = onImpression,
+                onClick = onClick
+            )
+        }
+        else -> { /** DO NOTHING **/ }
+    }
+    return ad
 }