feat(catalog): modern Compose sample catalog, Key API signatures, and Reviewer mode

.github/workflows/build.yml

@@ -117,12 +117,10 @@ jobs:
 
     - name: Build and check
       run: |
-        ./gradlew :snippets:app:assembleDebug
-        ./gradlew :snippets:app-ktx:assembleDebug
-        ./gradlew :snippets:app-utils-ktx:assembleDebug
+        ./gradlew :snippets:kotlin-app:assembleDebug
+        ./gradlew :snippets:java-app:assembleDebug
         ./gradlew :snippets:app-compose:assembleDebug
         ./gradlew :snippets:app-places-ktx:assembleDebug
-        ./gradlew :snippets:app-utils:assembleDebug
 
   build-tutorials:
     runs-on: ubuntu-latest

.github/workflows/lint.yml

@@ -55,11 +55,9 @@ jobs:
           ./gradlew :ApiDemos:kotlin-app:lintDebug
           ./gradlew :ApiDemos:java-app:lintDebug
           ./gradlew :ApiDemos:common-ui:lintDebug
-          ./gradlew :snippets:app:lintGmsDebug
-          ./gradlew :snippets:app-utils:lintDebug
-          ./gradlew :snippets:app-utils-ktx:lintDebug
+          ./gradlew :snippets:kotlin-app:lintDebug
+          ./gradlew :snippets:java-app:lintDebug
           ./gradlew :snippets:app-places-ktx:lintDebug
-          ./gradlew :snippets:app-ktx:lintDebug
           ./gradlew :snippets:app-compose:lintDebug
           ./gradlew :WearOS:Wearable:lintDebug
           ./gradlew :FireMarkers:app:lintDebug
@@ -82,36 +80,24 @@ jobs:
           sarif_file: ApiDemos/project/common-ui/build/reports/lint-results-debug.sarif
           category: ApiDemos-common-ui
 
-      - name: Upload SARIF for snippets:app
+      - name: Upload SARIF for snippets:kotlin-app
         uses: github/codeql-action/upload-sarif@ff2f1c621b7f889edc0d3c761ac2e6a3f8cdb0dd # v4.37.7
         with:
-          sarif_file: snippets/app/build/reports/lint-results-debug.sarif
-          category: snippets-app
+          sarif_file: snippets/kotlin-app/build/reports/lint-results-debug.sarif
+          category: snippets-kotlin-app
 
-      - name: Upload SARIF for snippets:app-utils
+      - name: Upload SARIF for snippets:java-app
         uses: github/codeql-action/upload-sarif@ff2f1c621b7f889edc0d3c761ac2e6a3f8cdb0dd # v4.37.7
         with:
-          sarif_file: snippets/app-utils/build/reports/lint-results-debug.sarif
-          category: snippets-app-utils
-
-      - name: Upload SARIF for snippets:app-utils-ktx
-        uses: github/codeql-action/upload-sarif@ff2f1c621b7f889edc0d3c761ac2e6a3f8cdb0dd # v4.37.7
-        with:
-          sarif_file: snippets/app-utils-ktx/build/reports/lint-results-debug.sarif
-          category: snippets-app-utils-ktx
+          sarif_file: snippets/java-app/build/reports/lint-results-debug.sarif
+          category: snippets-java-app
 
       - name: Upload SARIF for snippets:app-places-ktx
         uses: github/codeql-action/upload-sarif@ff2f1c621b7f889edc0d3c761ac2e6a3f8cdb0dd # v4.37.7
         with:
           sarif_file: snippets/app-places-ktx/build/reports/lint-results-debug.sarif
           category: snippets-app-places-ktx
 
-      - name: Upload SARIF for snippets:app-ktx
-        uses: github/codeql-action/upload-sarif@ff2f1c621b7f889edc0d3c761ac2e6a3f8cdb0dd # v4.37.7
-        with:
-          sarif_file: snippets/app-ktx/build/reports/lint-results-debug.sarif
-          category: snippets-app-ktx
-
       - name: Upload SARIF for snippets:app-compose
         uses: github/codeql-action/upload-sarif@ff2f1c621b7f889edc0d3c761ac2e6a3f8cdb0dd # v4.37.7
         with:

.gitignore

@@ -9,5 +9,15 @@ secrets.properties
 
 # This covers new IDEs, like Antigravity
 .vscode/
-**/bin/
-.kotlin/
+
+# Temporary verification screenshot files
+*_screen*.png
+sydney_final.png
+*_sydney.png
+*_verified.png
+!**/assets/screenshots/*.png
+.kotlin/
+.gradle-test/
+eval_runs/
+__pycache__/
+*.pyc

AGENTS.md

@@ -36,6 +36,7 @@ demonstrate the same features and must stay in sync.
 - Adhere to formatting rules defined in `.editorconfig`.
 - Do not use wildcard imports (`import foo.*`); use explicit imports.
 - Avoid fully qualified class names in source code; declare explicit imports at the file level instead (except to resolve naming collisions or in XML layouts).
+- Target **Java 17** (`JavaLanguageVersion.of(17)`) for all project modules. Do not downgrade bytecode to Java 8 or Java 11.
 
 ## Building and testing
 
@@ -69,7 +70,10 @@ into the root `settings.gradle.kts`; build them from their own directory.
 
 - Use Conventional Commit messages (`feat:`, `fix:`, `docs:`, ...).
   release-please parses them to generate versions and CHANGELOG.md; a wrong
-  prefix causes a wrong release bump. Never edit CHANGELOG.md by hand.
+  prefix causes a wrong release bump.
+- **PR Title Validation**: Ensure PR titles strictly conform to Conventional Commits (e.g., `fix: stale QuadItem removal` instead of `Fix stale QuadItem removal`). When PRs are squash-merged into `main`, GitHub uses the PR title as the default commit header; a non-conforming title prevents release-please from accurately categorizing changes in CHANGELOG.md or calculating semantic version increments.
+- Never edit CHANGELOG.md or `.release-please-manifest.json` by hand.
+- All pull requests are to be created as drafts (`gh pr create --draft`) until authorization is explicitly given to mark them ready for review. Always inform the user that the PR was created as a draft.
 - Keep changes scoped to one sample or one feature across its language
   variants; do not mix unrelated samples in one PR.
 - Build and test the affected modules before declaring work done, and report actual

ApiDemos/project/common-ui/build.gradle.kts

@@ -1,7 +1,7 @@
 import org.jetbrains.kotlin.gradle.dsl.JvmTarget
 
 /*
- * Copyright 2025 Google LLC
+ * Copyright 2026 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -18,6 +18,8 @@ import org.jetbrains.kotlin.gradle.dsl.JvmTarget
 
 plugins {
     alias(libs.plugins.android.library)
+    alias(libs.plugins.kotlin.compose)
+    alias(libs.plugins.ksp)
 }
 
 android {
@@ -45,6 +47,7 @@ android {
     }
     buildFeatures {
         viewBinding = true
+        compose = true
     }
     compileOptions {
         sourceCompatibility = JavaVersion.VERSION_17
@@ -64,12 +67,30 @@ android {
 }
 
 dependencies {
-
     implementation(libs.core.ktx)
     implementation(libs.appcompat)
     implementation(libs.material)
     implementation(libs.play.services.maps)
+
+    // Jetpack Compose
+    implementation(platform(libs.compose.bom))
+    implementation(libs.ui)
+    implementation(libs.ui.graphics)
+    implementation(libs.ui.tooling.preview)
+    implementation(libs.material3)
+    implementation(libs.material.icons.extended)
+    implementation(libs.activity.compose)
+    debugImplementation(libs.ui.tooling)
+
+    // Room
+    implementation(libs.androidx.room.runtime)
+    implementation(libs.androidx.room.ktx)
+    ksp(libs.androidx.room.compiler)
+
+    // Lifecycle & Coroutines
+    implementation(libs.lifecycle.runtime.ktx)
+
     testImplementation(libs.junit)
     androidTestImplementation(libs.junit)
     androidTestImplementation(libs.espresso.core)
-}
+}