feat(bill-customization): introduce PlaygroundContext for per-caller playground behavior

Replace the FeatureFlag.CurrencyCreator gating on the playground scaffold with a PlaygroundContext passed through Event.Load, so the overlay and available features can diverge between Advanced (Standalone) and Currency Creator (inline, Background-only) entry points.

Signed-off-by: Brandon McAnsh <git@bmcreations.dev>

Author: bmc08gt

apps/flipcash/features/bill-customization/src/main/kotlin/com/flipcash/app/bill/customization/BillCustomizationScaffold.kt

@@ -41,8 +41,6 @@ import androidx.lifecycle.compose.collectAsStateWithLifecycle
 import com.flipcash.app.bill.customization.components.BillPlayground
 import com.flipcash.app.bills.AnimatedBill
 import com.flipcash.app.core.bill.Bill
-import com.flipcash.app.featureflags.FeatureFlag
-import com.flipcash.app.featureflags.LocalFeatureFlags
 import com.flipcash.features.bill.playground.R
 import com.getcode.theme.CodeTheme
 import com.getcode.ui.components.AppBarDefaults
@@ -54,18 +52,14 @@ import com.getcode.ui.utils.AnimationUtils
 @Composable
 fun BillPlaygroundScaffold(content: @Composable () -> Unit) {
     val controller = LocalBillPlaygroundController.current
-    val featureFlags = LocalFeatureFlags.current
     val playgroundState by controller.state.collectAsStateWithLifecycle()
 
-    val currencyCreatorEnabled by featureFlags.observe(FeatureFlag.CurrencyCreator)
-        .collectAsStateWithLifecycle()
-
     val isUsingPlayground by remember(
         playgroundState.isCustomizing,
-        currencyCreatorEnabled
+        playgroundState.context,
     ) {
         derivedStateOf {
-            playgroundState.isCustomizing && !currencyCreatorEnabled
+            playgroundState.isCustomizing && playgroundState.context.renderAsOverlay
         }
     }
 
@@ -79,9 +73,13 @@ fun BillPlaygroundScaffold(content: @Composable () -> Unit) {
 
     val customizationsOptions = playgroundState.customizations
 
-    val augmentedBill by remember(playgroundState.bill, customizationsOptions) {
+    val augmentedBill by remember(
+        playgroundState.bill,
+        customizationsOptions,
+        playgroundState.context,
+    ) {
         derivedStateOf {
-            if (currencyCreatorEnabled) return@derivedStateOf null
+            if (!playgroundState.context.renderAsOverlay) return@derivedStateOf null
             val bill = playgroundState.bill ?: return@derivedStateOf null
             if (bill !is Bill.Cash) return@derivedStateOf null
             bill.copy(

apps/flipcash/features/currency-creator/src/main/kotlin/com/flipcash/app/currencycreator/internal/CurrencyCreatorViewModel.kt

@@ -152,6 +152,8 @@ internal class CurrencyCreatorViewModel @Inject constructor(
             val success: Boolean = false,
         ) : Event
 
+        data class CustomizationsChanged(val customizations: TokenBillCustomizations): Event
+
         data class LaunchToken(val method: PurchaseMethod) : Event
         data object Purchase : Event
         data class PurchaseWithReserves(val token: Token, val amount: Fiat) : Event
@@ -352,6 +354,7 @@ internal class CurrencyCreatorViewModel @Inject constructor(
         eventFlow
             .filterIsInstance<Event.LaunchToken>()
             .map { event ->
+                println("customizations=${stateFlow.value.customizations}")
                 val request = TokenCreateRequest(
                     name = ModerationAttestation.Text(
                         text = stateFlow.value.nameFieldState.text.toString(),
@@ -548,6 +551,10 @@ internal class CurrencyCreatorViewModel @Inject constructor(
                     )
                 }
 
+                is Event.CustomizationsChanged -> { state ->
+                    state.copy(customizations = event.customizations)
+                }
+
                 is Event.LaunchToken -> { state -> state }
                 is Event.Purchase -> { state -> state }
                 is Event.CheckName -> { state -> state }

apps/flipcash/features/currency-creator/src/main/kotlin/com/flipcash/app/currencycreator/internal/screens/BillCustomizationScreen.kt

@@ -21,6 +21,7 @@ import androidx.compose.ui.Modifier
 import androidx.lifecycle.compose.collectAsStateWithLifecycle
 import com.flipcash.app.bill.customization.Event
 import com.flipcash.app.bill.customization.LocalBillPlaygroundController
+import com.flipcash.app.bill.customization.PlaygroundContext
 import com.flipcash.app.bill.customization.components.BillPlayground
 import com.flipcash.app.bills.RenderedBill
 import com.flipcash.app.core.bill.Bill
@@ -42,7 +43,8 @@ internal fun BillCustomizationScreen() {
         controller.dispatchEvent(
             Event.Load(
                 customizations = state.customizations,
-                amount = state.purchaseAmount
+                amount = state.purchaseAmount,
+                context = PlaygroundContext.CurrencyCreator,
             )
         )
     }
@@ -60,19 +62,23 @@ internal fun BillCustomizationContent(
 
     val augmentedBill by remember(
         playgroundState.bill,
-        playgroundState.customizations
+        state.customizations
     ) {
         derivedStateOf {
             val bill = playgroundState.bill ?: return@derivedStateOf null
             if (bill !is Bill.Cash) return@derivedStateOf null
             bill.copy(
                 token = bill.token.copy(
-                    billCustomizations = playgroundState.customizations
+                    billCustomizations = state.customizations
                 )
             )
         }
     }
 
+    LaunchedEffect(playgroundState.customizations) {
+        dispatch(CurrencyCreatorViewModel.Event.CustomizationsChanged(playgroundState.customizations))
+    }
+
     Column(
         modifier = Modifier.fillMaxSize(),
         horizontalAlignment = Alignment.CenterHorizontally

apps/flipcash/features/scanner/src/main/kotlin/com/flipcash/app/scanner/internal/ui/components/DecorView.kt

@@ -39,8 +39,6 @@ import androidx.compose.ui.unit.dp
 import androidx.lifecycle.compose.collectAsStateWithLifecycle
 import com.flipcash.app.bill.customization.LocalBillPlaygroundController
 import com.flipcash.app.core.bill.BillState
-import com.flipcash.app.featureflags.FeatureFlag
-import com.flipcash.app.featureflags.LocalFeatureFlags
 import com.flipcash.app.scanner.internal.ScannerDecorItem
 import com.flipcash.app.session.SessionState
 import com.flipcash.features.scanner.R
@@ -59,17 +57,14 @@ internal fun DecorView(
     onAction: (ScannerDecorItem) -> Unit,
 ) {
     val billPlayground = LocalBillPlaygroundController.current
-    val featureFlags = LocalFeatureFlags.current
     val playgroundState by billPlayground.state.collectAsStateWithLifecycle()
-    val currencyCreatorEnabled by featureFlags.observe(FeatureFlag.CurrencyCreator)
-        .collectAsStateWithLifecycle()
 
     val isUsingPlayground by remember(
         playgroundState.isCustomizing,
-        currencyCreatorEnabled
+        playgroundState.context,
     ) {
         derivedStateOf {
-            playgroundState.isCustomizing && !currencyCreatorEnabled
+            playgroundState.isCustomizing && playgroundState.context.renderAsOverlay
         }
     }
 

apps/flipcash/shared/bill-customization/src/main/kotlin/com/flipcash/app/bill/customization/BillPlaygroundController.kt

@@ -29,6 +29,7 @@ interface BillPlaygroundController {
 
 data class PlaygroundState(
     val bill: Bill? = null,
+    val context: PlaygroundContext = PlaygroundContext.Standalone,
     val features: List<PlaygroundFeature> = PlaygroundFeature.entries.toList(),
     val selectedFeature: PlaygroundFeature = PlaygroundFeature.Background,
     val backgroundState: ColorState = ColorState(),
@@ -103,6 +104,7 @@ sealed interface Event {
     data class Load(
         val customizations: TokenBillCustomizations? = null,
         val amount: Fiat = 5.toFiat(),
+        val context: PlaygroundContext = PlaygroundContext.Standalone,
     ): Event
     data class SelectFeature(val feature: PlaygroundFeature): Event
     sealed interface Colors: Event {

apps/flipcash/shared/bill-customization/src/main/kotlin/com/flipcash/app/bill/customization/PlaygroundContext.kt

@@ -0,0 +1,22 @@
+package com.flipcash.app.bill.customization
+
+import com.flipcash.app.bill.customization.models.PlaygroundFeature
+
+sealed interface PlaygroundContext {
+    val renderAsOverlay: Boolean
+    val availableFeatures: List<PlaygroundFeature>
+
+    /** Playground opened as a standalone overlay (Advanced → Bill Creator). */
+    data object Standalone : PlaygroundContext {
+        override val renderAsOverlay: Boolean = true
+        override val availableFeatures: List<PlaygroundFeature>
+            get() = PlaygroundFeature.entries
+    }
+
+    /** Playground embedded inside the Currency Creator flow. */
+    data object CurrencyCreator : PlaygroundContext {
+        override val renderAsOverlay: Boolean = false
+        override val availableFeatures: List<PlaygroundFeature>
+            get() = listOf(PlaygroundFeature.Background)
+    }
+}

apps/flipcash/shared/bill-customization/src/main/kotlin/com/flipcash/app/bill/customization/internal/InternalBillPlaygroundController.kt

@@ -5,6 +5,7 @@ import androidx.lifecycle.ViewModel
 import androidx.lifecycle.viewModelScope
 import com.flipcash.app.bill.customization.BillPlaygroundController
 import com.flipcash.app.bill.customization.Event
+import com.flipcash.app.bill.customization.PlaygroundContext
 import com.flipcash.app.bill.customization.PlaygroundState
 import com.flipcash.app.bill.customization.internal.features.BackgroundController
 import com.flipcash.app.bill.customization.internal.features.BlendMode
@@ -81,7 +82,12 @@ class InternalBillPlaygroundController(
     override val canCopy: Boolean
         get() = false
 
-    private fun customizeFor(token: Token, amount: Fiat, customizations: TokenBillCustomizations?) {
+    private fun customizeFor(
+        token: Token,
+        amount: Fiat,
+        customizations: TokenBillCustomizations?,
+        context: PlaygroundContext,
+    ) {
         // create amount for the bill
         val demoAmount = LocalFiat(
             usdf = amount,
@@ -101,14 +107,24 @@ class InternalBillPlaygroundController(
             data = payloadInfo.codeData.toList()
         )
 
-        _state.update { it.copy(bill = bill) }
+        _state.update { current ->
+            val features = context.availableFeatures
+            val selectedFeature = current.selectedFeature.takeIf { it in features }
+                ?: features.first()
+            current.copy(
+                bill = bill,
+                context = context,
+                features = features,
+                selectedFeature = selectedFeature,
+            )
+        }
     }
 
     override fun dispatchEvent(event: Event) {
         when (event) {
             // high level actions
             is Event.Load -> {
-                customizeFor(Token.usdf, event.amount, event.customizations)
+                customizeFor(Token.usdf, event.amount, event.customizations, event.context)
             }
 
             // selecting feature from tab row