Bump all dependencies to the latest, add Copilot instructions, and add new Material 3 components (Dialog, Divider, RadioButton, Segmented buttons, Slider, SnackbarHost, Tab, Chip, Select, TopAppBar, and more)

Bump all dependencies to the latest, add Copilot instructions, and add new Material 3 components (Dialog, Divider, RadioButton, Segmented buttons, Slider, SnackbarHost, Tab, Chip, Select, TopAppBar, and more)

Author: ShreckYe

.github/copilot-instructions.md

@@ -0,0 +1,30 @@
+name: "Copilot Setup Steps"
+
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+  pull_request:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+
+jobs:
+  copilot-setup-steps:
+    runs-on: macos-latest
+
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v5
+        with:
+          java-version: "17"
+          distribution: "temurin"
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v4

.github/workflows/copilot-setup-steps.yml

@@ -0,0 +1 @@
+See [Copilot instructions.md](.github/copilot-instructions.md).

AGENTS.md

@@ -51,53 +51,76 @@ This project is still in development and has not reached a stable state. Some AP
 
 #### Material 2 components
 
-- `Button`
-- `Card`
-- `Checkbox`
-- `Divider` (not working properly on JS yet)
-- `Icon`
-- `IconButton`
-- `Snackbar` (inconsistent, not recommended), `SnackBarHost` (recommended)
-- `Switch`
-- `Text`
+**Deprecation notice:** The Material 2 components are no longer maintained and published for release since v0.6.0, due to its decreasing popularity and the underlying KMDC library's incompatible Kotlin and Compose versions.
+
+- Button: `Button`
+- Card: `Card`
+- Checkbox: `Checkbox`
+- Divider: `Divider` (not working properly on JS yet)
+- Icon: `Icon`
+- Icon button: `IconButton`
+- Snackbar: `Snackbar` (inconsistent, not recommended), `SnackBarHost` (recommended)
+- Switch: `Switch`
+- Text: `Text`
 
 ##### `ext` components
 
-- `Button`
-- `IconButton`
-- `RadioRow`, `RadioGroupRow`
-- `SwitchWithLabel`
-- `MaterialText`, `TaglessText`
-- `TextField`, `OutlinedTextField`
-- `TopAppBarScaffold`
+- Button: `Button`
+- Icon button: `IconButton`
+- Radio button: `RadioRow`, `RadioGroupRow`
+- Switch: `SwitchWithLabel`
+- Text: `MaterialText`, `TaglessText`
+- Text field: `TextField`, `OutlinedTextField`
+- Top app bar: `TopAppBarScaffold`
 
 ##### `lazy.ext` components
 
 - `List`/`LazyColumnList` (visually inconsistent for now)
 
 #### Material 3 components
 
-- `Button` (`FilledButton`), `ElevatedButton`, `FilledTonalButton`, `OutlinedButton`, `TextButton`
-- `Card` (`FilledCard`), `ElevatedCard`, `OutlinedCard`
-- `Checkbox`
-- `FloatingActionButton`, `SmallFloatingActionButton`, `LargeFloatingActionButton`, `ExtendedFloatingActionButton`
-- `Icon`
-- `IconButton`, `IconToggleButton`, `FilledIconButton`, `FilledIconToggleButton`, `FilledTonalIconButton`, `FilledTonalIconToggleButton`, `OutlinedIconButton`, `OutlinedIconToggleButton`
-- `LinearProgressIndicator`, `CircularProgressIndicator`
-- `Switch`
-- `Text`
+- Button: `Button` (`FilledButton`), `ElevatedButton`, `FilledTonalButton`, `OutlinedButton`, `TextButton`
+- Card: `Card` (`FilledCard`), `ElevatedCard`, `OutlinedCard`
+- Checkbox: `Checkbox`
+- Dialog: `AlertDialog`, `SimpleDialog`
+- Divider: `HorizontalDivider`
+- Floating action button: `FloatingActionButton`, `SmallFloatingActionButton`, `LargeFloatingActionButton`,
+  `ExtendedFloatingActionButton`
+- Icon: `Icon`
+- Icon button: `IconButton`, `IconToggleButton`, `FilledIconButton`, `FilledIconToggleButton`, `FilledTonalIconButton`,
+  `FilledTonalIconToggleButton`, `OutlinedIconButton`, `OutlinedIconToggleButton`
+- Navigation drawer: `ModalNavigationDrawer` (deprecated)
+- Progress indicator: `LinearProgressIndicator`, `CircularProgressIndicator`
+- Radio button: `RadioButton`
+- Segmented button: `SingleChoiceSegmentedButtonRow`, `MultiChoiceSegmentedButtonRow`
+- Slider: `Slider`, `RangeSlider`
+- Snackbar: `SnackbarHost`, `SnackbarHostState`
+- Switch: `Switch`
+- Tab: `PrimaryTabRow`, `SecondaryTabRow` (tabs are in `ext`)
+- Text: `Text`
 
 ##### `ext` components
 
-- `Button` (`FilledButton`), `ElevatedButton`, `FilledTonalButton`, `OutlinedButton`, `TextButton`
-- `Card` (`FilledCard`), `ElevatedCard`, `OutlinedCard`
-- `DropdownMenu`, `DropdownMenuItem`
-  - `ExposedDropdownMenuBox`, `ExposedDropdownMenuBoxScope.ExposedDropdownMenuBoxTextField`, `ExposedDropdownMenuBoxScope.ExposedDropdownMenu`, `ExposedDropdownMenuWithTextField`
-- `FloatingActionButton`, `SmallFloatingActionButton`, `LargeFloatingActionButton`, `ExtendedFloatingActionButton`
-- `IconButton`, `IconToggleButton`, `FilledIconButton`, `FilledIconToggleButton`, `FilledTonalIconButton`, `FilledTonalIconToggleButton`, `OutlinedIconButton`, `OutlinedIconToggleButton`
-- `NavigationBar`, `NavigationBarItem`
-- `MaterialText`, `TaglessText`
-- `TextField`, `OutlinedTextField`
+- Badge: `Badge` (deprecated)
+- Button: `Button` (`FilledButton`), `ElevatedButton`, `FilledTonalButton`, `OutlinedButton`, `TextButton`
+- Card: `Card` (`FilledCard`), `ElevatedCard`, `OutlinedCard`
+- Chip: `AssistChip`, `ElevatedAssistChip`, `FilterChip`, `ElevatedFilterChip`, `InputChip`, `SuggestionChip`,
+  `ElevatedSuggestionChip`
+- Dropdown menu: `DropdownMenu`, `DropdownMenuItem`
+  - `ExposedDropdownMenuBox`, `ExposedDropdownMenuBoxScope.ExposedDropdownMenuBoxTextField`, `ExposedDropdownMenuBoxScope.ExposedDropdownMenu`, `ExposedDropdownMenuBoxWithTextField`
+- Floating action button: `FloatingActionButton`, `SmallFloatingActionButton`, `LargeFloatingActionButton`,
+  `ExtendedFloatingActionButton`
+- Icon button: `IconButton`, `IconToggleButton`, `FilledIconButton`, `FilledIconToggleButton`, `FilledTonalIconButton`,
+  `FilledTonalIconToggleButton`, `OutlinedIconButton`, `OutlinedIconToggleButton`
+- Navigation bar: `NavigationBar`, `NavigationBarItem`
+- Radio button: `RadioButtonRow`, `radioGroup`
+- Segmented button: `SingleChoiceSegmentedButtonRowScope.SegmentedButton`,
+  `MultiChoiceSegmentedButtonRowScope.SegmentedButton`
+- Select: `FilledSelect`, `OutlinedSelect`, `SelectOption`
+- Tab: `PrimaryTab`, `SecondaryTab`
+- Text: `MaterialText`, `TaglessText`
+- Text field: `TextField`, `OutlinedTextField`
+- Top app bar: `TopAppBar`, `CenterAlignedTopAppBar`, `MediumTopAppBar`, `LargeTopAppBar`
 
 ##### `lazy.ext` components
 
@@ -184,15 +207,6 @@ kotlin {
 
 View [all the artifacts on Maven Central](https://search.maven.org/search?q=g:com.huanshankeji%20AND%20a:compose-multiplatform-*).
 
-This project depends on [Kobweb](https://github.com/varabyte/kobweb) which is not published to Maven Central yet, so you have to add the following Maven repository:
-
-```kotlin
-repositories {
-    mavenCentral()
-    maven("https://us-central1-maven.pkg.dev/varabyte-repos/public")
-}
-```
-
 ### Material Symbols & Icons on JS
 
 See [the corresponding section in Compose HTML Material](https://github.com/huanshankeji/compose-html-material?tab=readme-ov-file#material-symbols--icons) for configuring Material Icons on JS.

README.md

@@ -3,7 +3,7 @@ tasks.wrapper {
 }
 
 plugins {
-    id("org.jetbrains.kotlinx.binary-compatibility-validator") version "0.16.3"
+    id("org.jetbrains.kotlinx.binary-compatibility-validator") version "0.18.1"
 }
 
 apiValidation {
@@ -13,6 +13,6 @@ apiValidation {
     }
 
     ignoredProjects += "compose-multiplatform-html-unified".let {
-        listOf("$it-demo", "$it-common-legacy")
+        listOf("$it-demo")
     }
 }

build.gradle.kts

@@ -3,18 +3,19 @@ plugins {
 }
 
 repositories {
-    //mavenLocal() // comment out when not needed
+    mavenLocal() // TODO comment out when not needed so the build is always reproducible by others
     gradlePluginPortal()
     google()
     mavenCentral()
 }
 
 dependencies {
-    val kotlinVersion = "2.2.0-RC2"
+    val kotlinVersion = "2.3.20"
     implementation(kotlin("gradle-plugin", kotlinVersion))
     implementation("org.jetbrains.kotlin:compose-compiler-gradle-plugin:$kotlinVersion")
-    implementation("org.jetbrains.compose:compose-gradle-plugin:1.8.1")
-    implementation("com.huanshankeji.team:gradle-plugins:0.9.0") // don't use a snapshot version in a main branch
-    implementation("com.android.tools.build:gradle:8.10.1")
-    implementation("com.huanshankeji:common-gradle-dependencies:0.9.0-20241203") // don't use a snapshot version in a main branch
+    implementation("org.jetbrains.compose:compose-gradle-plugin:1.10.3")
+    implementation("com.huanshankeji.team:gradle-plugins:0.11.0") // don't use a snapshot version in a main branch
+    // https://developer.android.com/build/releases/gradle-plugin, https://mvnrepository.com/artifact/com.android.tools.build/gradle
+    implementation("com.android.tools.build:gradle:8.12.3")
+    implementation("com.huanshankeji:common-gradle-dependencies:0.10.0-20251024") // don't use a snapshot version in a main branch
 }

buildSrc/build.gradle.kts

@@ -1 +1 @@
-val androidSdkVersion = 35
+val androidSdkVersion = 36

buildSrc/src/main/kotlin/Android.kt

@@ -8,11 +8,18 @@ val commonDependencies = CommonDependencies()
 object DependencyVersions {
     const val composeMultiplatform = ComposeBuildConfig.composeVersion // for "ui-unit"
 
+
     // https://slack-chats.kotlinlang.org/t/27579160/after-updating-to-1-8-0-rc01-package-androidx-compose-materi
     // https://github.com/JetBrains/compose-multiplatform/releases/tag/v1.8.0-rc01
     const val composeMultiplatformMaterialIconsExtended = "1.7.3"
-    val kobweb = "0.19.2"
-    val huanshankejiComposeHtml = "0.4.0" // don't use a snapshot version in a main branch
+
+    // https://github.com/varabyte/kobweb/releases
+    val kobweb = "0.24.0"
+    val huanshankejiComposeHtml = "0.5.0" // don't use a snapshot version in a main branch
+
+    // https://github.com/mpetuska/kmdc/releases
     val kmdc = "0.1.2"
-    val materialSymbols = "0.25.1"
+
+    // https://github.com/marella/material-symbols/releases
+    val materialSymbols = "0.42.3"
 }

buildSrc/src/main/kotlin/VersionsAndDependencies.kt

@@ -8,10 +8,9 @@ plugins {
 }
 
 repositories {
-    //mavenLocal() // commented out so the build is always reproducible by others // put back if needed when depending on a snapshot
+    mavenLocal() // TODO comment out when not needed so the build is always reproducible by others
     mavenCentral()
     google()
-    maven("https://us-central1-maven.pkg.dev/varabyte-repos/public") // for Kobweb
 }
 
 group = "com.huanshankeji"
@@ -25,7 +24,6 @@ kotlin {
 
     //androidTarget()
 
-    iosX64()
     iosArm64()
     iosSimulatorArm64()
 
@@ -40,6 +38,10 @@ kotlin {
     js {
         // The project works without this, but it can be added to avoid potential issues.
         browser()
+
+        compilerOptions {
+            target.set("es2015")
+        }
     }
 
 
@@ -60,5 +62,6 @@ kotlin {
 
     compilerOptions {
         freeCompilerArgs.add("-Xexpect-actual-classes")
+        optIn.add("com.huanshankeji.compose.ExperimentalApi")
     }
 }

buildSrc/src/main/kotlin/common-conventions.gradle.kts

@@ -1,4 +1,4 @@
 plugins {
     id("lib-conventions-without-publishing")
-    id("com.huanshankeji.kotlin-multiplatform-sonatype-ossrh-publish-conventions")
+    id("com.huanshankeji.maven-central-publish-conventions")
 }