feat: add components for bolt (#11140)

Author: wmontwe

app-k9mail/build.gradle.kts

@@ -144,7 +144,6 @@ android {
 dependencies {
     implementation(projects.appCommon)
     implementation(projects.core.ui.compose.common)
-    implementation(projects.core.ui.compose.theme2)
     implementation(projects.core.ui.legacy.theme2.k9mail)
     implementation(projects.feature.launcher)
     implementation(projects.feature.mail.message.list.api)

app-thunderbird/build.gradle.kts

@@ -224,7 +224,6 @@ val fullReleaseImplementation by configurations.creating
 dependencies {
     implementation(projects.appCommon)
     implementation(projects.core.ui.compose.common)
-    implementation(projects.core.ui.compose.theme2)
     implementation(projects.core.ui.legacy.theme2.thunderbird)
     implementation(projects.feature.launcher)
 

app-ui-catalog/README.md

@@ -1,6 +1,6 @@
 # Thunderbird UI Catalog
 
-Uses [`:core:ui:compose:designsystem`](../core/ui/compose/designsystem/README.md)
+Uses [`:components:ui:bolt`](../components/ui/bolt/README.md)
 
 This is a catalog of all the components in the Thunderbird design system.
 

app-ui-catalog/build.gradle.kts

@@ -27,11 +27,9 @@ android {
 
 dependencies {
     implementation(projects.core.ui.navigation)
-
-    implementation(projects.core.ui.compose.designsystem)
     implementation(projects.core.ui.legacy.designsystem)
 
-    implementation(projects.core.ui.compose.theme2)
+    implementation(projects.core.ui.contract)
 
     implementation(libs.jetbrains.compose.material3)
     implementation(libs.jetbrains.compose.material.icons.extended)

build-plugin/src/main/kotlin/thunderbird.app.android.compose.gradle.kts

@@ -30,6 +30,7 @@ android {
 }
 
 dependencies {
+    val isComponentsBuild = rootProject.name == "components"
     val composeBom = platform(libs.androidx.compose.bom)
     implementation(composeBom)
     androidTestImplementation(composeBom)
@@ -45,4 +46,9 @@ dependencies {
     androidTestImplementation(libs.bundles.shared.android.app.compose.androidTest)
 
     implementation(libs.androidx.activity.compose)
+
+    if (!isComponentsBuild) {
+        implementation(libs.tb.mobile.components.ui.bolt)
+        testImplementation(libs.tb.mobile.components.ui.testing)
+    }
 }

build-plugin/src/main/kotlin/thunderbird.library.android.compose.gradle.kts

@@ -18,6 +18,7 @@ androidComponents {
 }
 
 dependencies {
+    val isComponentsBuild = rootProject.name == "components"
     val composeBom = platform(libs.androidx.compose.bom)
     implementation(composeBom)
     androidTestImplementation(composeBom)
@@ -31,4 +32,9 @@ dependencies {
     testImplementation(libs.bundles.shared.android.compose.test)
 
     androidTestImplementation(libs.bundles.shared.android.compose.androidTest)
+
+    if (!isComponentsBuild) {
+        implementation(libs.tb.mobile.components.ui.bolt)
+        testImplementation(libs.tb.mobile.components.ui.testing)
+    }
 }

build-plugin/src/main/kotlin/thunderbird.library.kmp.compose.gradle.kts

@@ -36,6 +36,8 @@ kotlin {
     }
 
     sourceSets {
+        val isComponentsBuild = rootProject.name == "components"
+
         commonMain.dependencies {
             implementation(project.dependencies.platform(libs.kotlin.bom))
             implementation(project.dependencies.platform(libs.koin.bom))
@@ -47,11 +49,19 @@ kotlin {
             implementation(libs.jetbrains.compose.ui)
             implementation(libs.jetbrains.compose.components.resources)
             implementation(libs.jetbrains.compose.components.ui.preview)
+
+            if (!isComponentsBuild) {
+                implementation(libs.tb.mobile.components.ui.bolt)
+            }
         }
 
         commonTest.dependencies {
             implementation(libs.bundles.shared.kmp.common.test)
             implementation(libs.bundles.shared.kmp.compose.common.test)
+
+            if (!isComponentsBuild) {
+                implementation(libs.tb.mobile.components.ui.testing)
+            }
         }
 
         androidMain.dependencies {

components/README.md

@@ -0,0 +1,47 @@
+# Components
+
+This directory contains independently buildable and releasable parts of the project.
+
+A component should have a clear boundary, be testable on its own, and be consumable by the app through a published
+artifact, such as a Maven dependency. Local source development can still be supported through Gradle composite builds.
+
+## What belongs here
+
+Use `components/` for code that can reasonably be versioned, built, tested, and released independently.
+
+Examples:
+
+* shared KMP or Android libraries
+* sync, storage, network, crypto, or telemetry libraries
+* reusable test support libraries
+* developer tooling such as code generators or lint rules
+
+## What does not belong here
+
+Do not use `components/` for app-owned feature code or app-internal shared modules.
+
+Use:
+
+* `apps-xyz` for final applications
+* `features/` for product features and screens
+* `core/` for app-internal shared modules
+* `build-logic/` for Gradle convention plugins and build infrastructure
+
+## Rules
+
+Components must not depend on `apps/`, `features/`, or `core/`.
+
+If a component needs code from `core/`, either move that dependency into the component, promote the shared code into
+its own component, or introduce a smaller public API.
+
+The app currently consumes local component sources by default through dependency substitution. Disable local source
+substitution with the `tb.components.local` Gradle property when testing released artifacts.
+
+```shell
+./gradlew -Ptb.components.local=false :app-ui-catalog:assembleDebug
+```
+
+Individual component groups can provide their own override property. Bolt substitution can be controlled with
+`tb.components.local.bolt`.
+
+Moving code into `components/` is only useful if the app build no longer configures and compiles that component by default.

components/build.gradle.kts

@@ -0,0 +1,9 @@
+plugins {
+    alias(libs.plugins.android.library) apply false
+    alias(libs.plugins.android.multiplatform.library) apply false
+    alias(libs.plugins.compose) apply false
+    alias(libs.plugins.jetbrains.compose) apply false
+    alias(libs.plugins.kotlin.multiplatform) apply false
+    alias(libs.plugins.kotlin.serialization) apply false
+    alias(libs.plugins.kover) apply false
+}

components/gradle.properties

@@ -0,0 +1,18 @@
+# Android
+android.useAndroidX=true
+android.nonTransitiveRClass=true
+## Disable buildFeatures flags by default: https://developer.android.com/build/releases/gradle-plugin#default-changes
+android.defaults.buildfeatures.resvalues=false
+android.defaults.buildfeatures.shaders=false
+# Gradle
+## Ensure important default jvmargs aren't overwritten. See https://github.com/gradle/gradle/issues/19750
+org.gradle.jvmargs=-Dfile.encoding=UTF-8 -XX:+UseG1GC -XX:SoftRefLRUPolicyMSPerMB=1 -XX:ReservedCodeCacheSize=512m -XX:InitialCodeCacheSize=256m -XX:+HeapDumpOnOutOfMemoryError -Xmx8g -XX:+IgnoreUnrecognizedVMOptions -XX:+SuppressCDSWarning
+org.gradle.parallel=true
+org.gradle.caching=true
+org.gradle.configuration-cache=true
+org.gradle.configuration-cache.parallel=true
+org.gradle.kotlin.dsl.allWarningsAsErrors=true
+# Kotlin
+kotlin.code.style=official
+kotlin.compiler.execution.strategy=in-process
+kotlin.daemon.jvmargs=-Dfile.encoding=UTF-8 -XX:+UseG1GC -XX:SoftRefLRUPolicyMSPerMB=1 -XX:ReservedCodeCacheSize=512m -XX:InitialCodeCacheSize=256m -XX:+HeapDumpOnOutOfMemoryError -Xmx8g