Prepare for release 0.7.4 (#152)

skydoves · web-flow · commit 3e15ffce45e9 · 2026-04-25T10:34:16.000+09:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,6 +5,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.7.4] - 2026-04-25
+
+### Added
+- **Recomposition Profiler: Timing measurement** (Issue #89)
+  - `@TraceRecomposition` now measures composable recomposition duration via `System.nanoTime()` IR injection
+  - Duration displayed in logcat output: `[Recomposition #3] UserCard (2.30ms)`
+  - Compiler plugin wraps composable body in try-finally for accurate timing even on exceptions
+  - `RecompositionEvent.durationNanos` field added for custom logger consumption
+  - KMP-compatible via `expect/actual currentNanoTime()` (Android/JVM supported, other platforms gracefully skip)
+- **Heatmap Tooltip** — Hover over recomposition count inlay in the editor to see:
+  - Last recomposition duration
+  - Parameter changes with old/new values
+  - State changes with old/new values
+  - Unstable parameter summary
+  - Cumulative total recomposition count and duration
+- **Heatmap logcat parser updates** — Parses `[param]` and `[state]` prefixed lines and duration from log output
+
+### Changed
+- **Shadow plugin upgraded to 9.0.0-beta12** for Gradle 9.x compatibility (plugin ID changed from `com.github.johnrengelman.shadow` to `com.gradleup.shadow`)
+
 ## [0.7.3] - 2026-04-11
 
 ### Added
diff --git a/README.md b/README.md
@@ -212,7 +212,7 @@ This is incredibly useful for:
 First, add the plugin to the `[plugins]` section of your `libs.versions.toml` file:
 
 ```toml
-stability-analyzer = { id = "com.github.skydoves.compose.stability.analyzer", version = "0.7.3" }
+stability-analyzer = { id = "com.github.skydoves.compose.stability.analyzer", version = "0.7.4" }
 ```
 
 Then, apply it to your root `build.gradle.kts` with `apply false`:
@@ -234,7 +234,7 @@ It’s **strongly recommended to use the exact same Kotlin version** as this lib
 
 | Stability Analyzer | Kotlin |
 |--------------------|-------------|
-| 0.7.3+             | 2.3.20 |
+| 0.7.4+             | 2.3.20 |
 | 0.6.5~0.7.0        | 2.3.0 |
 | 0.4.0~0.6.4        | 2.2.21 |
 
@@ -256,9 +256,9 @@ fun UserProfile(user: User) {
 That's it. When this composable recomposes, you'll see logs like:
 
 ```
-D/Recomposition: [Recomposition #1] UserProfile
+D/Recomposition: [Recomposition #1] UserProfile (0.12ms)
 D/Recomposition:   └─ [param] user: User stable (User@abc123)
-D/Recomposition: [Recomposition #2] UserProfile
+D/Recomposition: [Recomposition #2] UserProfile (0.15ms)
 D/Recomposition:   └─ [param] user: User changed (User@abc123 → User@def456)
 ```
 
@@ -316,7 +316,7 @@ fun UserProfile(user: User) {
 Now logs include the tag:
 
 ```
-D/Recomposition: [Recomposition #1] UserProfile (tag: user-profile)
+D/Recomposition: [Recomposition #1] UserProfile (tag: user-profile) (0.08ms)
 D/Recomposition:   └─ [param] user: User stable (User@abc123)
 ```
 
@@ -414,7 +414,7 @@ Let's understand what each log tells you:
 #### First Recomposition
 
 ```
-D/Recomposition: [Recomposition #1] UserProfile
+D/Recomposition: [Recomposition #1] UserProfile (0.12ms)
 D/Recomposition:   └─ [param] user: User stable (User@abc123)
 ```
 
@@ -430,7 +430,7 @@ This log confirms the composable is working correctly. The parameter is stable a
 #### Parameter Changed
 
 ```
-D/Recomposition: [Recomposition #2] UserProfile
+D/Recomposition: [Recomposition #2] UserProfile (0.15ms)
 D/Recomposition:   └─ [param] user: User changed (User@abc123 → User@def456)
 ```
 
@@ -444,15 +444,15 @@ This is normal behavior. The parameter changed, so the composable recomposed to
 #### Unstable Parameter
 
 ```
-D/Recomposition: [Recomposition #1] UserCard (tag: user-card)
+D/Recomposition: [Recomposition #1] UserCard (tag: user-card) (0.25ms)
 D/Recomposition:   ├─ [param] user: MutableUser unstable (MutableUser@xyz789)
 D/Recomposition:   └─ Unstable parameters: [user]
 ```
 
 #### Multiple Parameters (Mixed Stability)
 
 ```
-D/Recomposition: [Recomposition #5] ProductList (tag: products)
+D/Recomposition: [Recomposition #5] ProductList (tag: products) (3.40ms)
 D/Recomposition:   ├─ [param] title: String stable (Products)
 D/Recomposition:   ├─ [param] count: Int changed (4 → 5)
 D/Recomposition:   ├─ [param] items: List<Product> unstable (List@abc)
@@ -491,12 +491,12 @@ fun ProductCard(
 **Step 2: Run your app and check Logcat**
 
 ```
-D/Recomposition: [Recomposition #3] ProductCard (tag: product-card)
+D/Recomposition: [Recomposition #3] ProductCard (tag: product-card) (0.45ms)
 D/Recomposition:   ├─ [param] product: Product unstable (Product@abc)
 D/Recomposition:   ├─ [param] onClick: () -> Unit stable (Function@xyz)
 D/Recomposition:   └─ Unstable parameters: [product]
 
-D/Recomposition: [Recomposition #4] ProductCard (tag: product-card)
+D/Recomposition: [Recomposition #4] ProductCard (tag: product-card) (0.42ms)
 D/Recomposition:   ├─ [param] product: Product unstable (Product@abc)
 D/Recomposition:   ├─ [param] onClick: () -> Unit stable (Function@xyz)
 D/Recomposition:   └─ Unstable parameters: [product]
@@ -536,7 +536,7 @@ data class Product(
 Run the app again and check Logcat:
 
 ```
-D/Recomposition: [Recomposition #3] ProductCard (tag: product-card)
+D/Recomposition: [Recomposition #3] ProductCard (tag: product-card) (0.45ms)
 D/Recomposition:   ├─ [param] product: Product stable (Product@abc)
 D/Recomposition:   └─ [param] onClick: () -> Unit stable (Function@xyz)
 
@@ -568,7 +568,7 @@ fun CounterScreen(title: String) {
 After clicking the button:
 
 ```
-D/Recomposition: [Recomposition #2] CounterScreen
+D/Recomposition: [Recomposition #2] CounterScreen (1.20ms)
 D/Recomposition:   ├─ [param] title: String stable (Counter)
 D/Recomposition:   ├─ [state] counter: Int changed (0 → 1)
 D/Recomposition:   └─ State changes: [counter]
diff --git a/compose-stability-analyzer-idea/CHANGELOG.md b/compose-stability-analyzer-idea/CHANGELOG.md
@@ -2,6 +2,16 @@
 
 All notable changes to the IntelliJ IDEA plugin will be documented in this file.
 
+## [0.7.4] - 2026-04-25
+
+### Added
+- **Heatmap Tooltip** — Hover over recomposition count inlay to see last recomposition details: duration, parameter/state changes, unstable params, and cumulative totals
+- **Duration display in heatmap** — Logcat parser now captures recomposition timing from `(X.XXms)` format
+- **`[param]` and `[state]` prefix parsing** — Updated logcat parser to handle new log format
+
+### Changed
+- Removed manual `HintManager` tooltip in favor of `IdeTooltipManager` for correct positioning
+
 ## [0.7.3] - 2026-04-11
 
 ### Fixed
diff --git a/compose-stability-analyzer-idea/build.gradle.kts b/compose-stability-analyzer-idea/build.gradle.kts
@@ -26,7 +26,7 @@ kotlin {
 }
 
 group = "com.github.skydoves"
-version = "0.7.4-SNAPSHOT"
+version = "0.7.4"
 
 repositories {
   mavenLocal()
diff --git a/docs/gradle-plugin/getting-started.md b/docs/gradle-plugin/getting-started.md
@@ -45,7 +45,7 @@ The Compose Stability Analyzer compiler plugin is tightly coupled to the Kotlin
 
 | Stability Analyzer | Kotlin |
 |--------------------|--------|
-| 0.7.3+             | 2.3.20 |
+| 0.7.4+             | 2.3.20 |
 | 0.6.5 ~ 0.7.0     | 2.3.0  |
 | 0.4.0 ~ 0.6.4     | 2.2.21 |
 
diff --git a/docs/gradle-plugin/trace-recomposition.md b/docs/gradle-plugin/trace-recomposition.md
@@ -20,9 +20,9 @@ fun UserProfile(user: User) {
 When this composable recomposes, detailed logs appear in Logcat showing the recomposition count, each parameter's stability status, and whether the parameter's value changed since the last composition.
 
 ```
-D/Recomposition: [Recomposition #1] UserProfile
+D/Recomposition: [Recomposition #1] UserProfile (0.12ms)
 D/Recomposition:   └─ [param] user: User stable (User@abc123)
-D/Recomposition: [Recomposition #2] UserProfile
+D/Recomposition: [Recomposition #2] UserProfile (0.15ms)
 D/Recomposition:   └─ [param] user: User changed (User@abc123 → User@def456)
 ```
 
@@ -45,7 +45,7 @@ fun UserProfile(user: User) {
 Logs now include the tag, making it easy to filter in Logcat:
 
 ```
-D/Recomposition: [Recomposition #1] UserProfile (tag: user-profile)
+D/Recomposition: [Recomposition #1] UserProfile (tag: user-profile) (0.08ms)
 D/Recomposition:   └─ [param] user: User stable (User@abc123)
 ```
 
@@ -94,7 +94,7 @@ fun CounterScreen(title: String) {
 After clicking the button, the log now shows both parameter and state information:
 
 ```
-D/Recomposition: [Recomposition #2] CounterScreen
+D/Recomposition: [Recomposition #2] CounterScreen (1.20ms)
 D/Recomposition:   ├─ [param] title: String stable (Counter)
 D/Recomposition:   ├─ [state] counter: Int changed (0 → 1)
 D/Recomposition:   └─ State changes: [counter]
@@ -110,14 +110,31 @@ The `[param]` prefix identifies parameter tracking entries, while `[state]` iden
 
     Use `traceStates = true` when a composable is recomposing but the parameter logs show no changes. This typically means an internal state or `CompositionLocal` is causing the recomposition, and state tracking will reveal which one.
 
+## Recomposition Duration
+
+Every `@TraceRecomposition` composable automatically measures how long each recomposition takes. The duration appears in the log header:
+
+```
+D/Recomposition: [Recomposition #3] UserCard (2.30ms)
+D/Recomposition:   └─ [param] user: User changed (User@abc → User@def)
+```
+
+The `(2.30ms)` shows how long the composable body took to execute during this recomposition. This helps identify which composables are expensive, not just which ones recompose frequently.
+
+Duration data is also available in `RecompositionEvent.durationNanos` for custom loggers, and is displayed in the IDE's heatmap tooltip when hovering over the recomposition count inlay.
+
+!!! note "Platform support"
+
+    Duration measurement uses `System.nanoTime()` and is available on Android and JVM. On other KMP platforms (iOS, JS, WASM), timing is gracefully skipped and `durationNanos` will be `0`.
+
 ## Reading the Logs
 
 Understanding the log output is key to diagnosing recomposition issues. Each log entry contains several pieces of information that, together, tell you exactly what happened and why.
 
 ### First Recomposition
 
 ```
-D/Recomposition: [Recomposition #1] UserProfile
+D/Recomposition: [Recomposition #1] UserProfile (0.12ms)
 D/Recomposition:   └─ [param] user: User stable (User@abc123)
 ```
 
@@ -128,7 +145,7 @@ This log confirms the composable is working correctly. A stable parameter on the
 ### Parameter Changed
 
 ```
-D/Recomposition: [Recomposition #2] UserProfile
+D/Recomposition: [Recomposition #2] UserProfile (0.15ms)
 D/Recomposition:   └─ [param] user: User changed (User@abc123 → User@def456)
 ```
 
@@ -139,7 +156,7 @@ This is normal behavior. The parameter changed, so the composable recomposed to
 ### Unstable Parameter
 
 ```
-D/Recomposition: [Recomposition #1] UserCard (tag: user-card)
+D/Recomposition: [Recomposition #1] UserCard (tag: user-card) (0.25ms)
 D/Recomposition:   ├─ [param] user: MutableUser unstable (MutableUser@xyz789)
 D/Recomposition:   └─ Unstable parameters: [user]
 ```
@@ -149,7 +166,7 @@ The `unstable` label means the Compose compiler cannot guarantee this parameter
 ### Multiple Parameters (Mixed Stability)
 
 ```
-D/Recomposition: [Recomposition #5] ProductList (tag: products)
+D/Recomposition: [Recomposition #5] ProductList (tag: products) (3.40ms)
 D/Recomposition:   ├─ [param] title: String stable (Products)
 D/Recomposition:   ├─ [param] count: Int changed (4 → 5)
 D/Recomposition:   ├─ [param] items: List<Product> unstable (List@abc)
@@ -195,7 +212,7 @@ fun ProductCard(product: Product, onClick: () -> Unit) {
 **Run the app and check Logcat.** Filter by `product-card` to see only this composable's events. After scrolling through the list, you see logs appearing rapidly:
 
 ```
-D/Recomposition: [Recomposition #3] ProductCard (tag: product-card)
+D/Recomposition: [Recomposition #3] ProductCard (tag: product-card) (0.45ms)
 D/Recomposition:   ├─ [param] product: Product unstable (Product@abc)
 D/Recomposition:   ├─ [param] onClick: () -> Unit stable (Function@xyz)
 D/Recomposition:   └─ Unstable parameters: [product]
@@ -216,7 +233,7 @@ data class Product(val name: String, val price: Double)
 **Verify the fix** by running the app again. The logs now show stable parameters:
 
 ```
-D/Recomposition: [Recomposition #3] ProductCard (tag: product-card)
+D/Recomposition: [Recomposition #3] ProductCard (tag: product-card) (0.45ms)
 D/Recomposition:   ├─ [param] product: Product stable (Product@abc)
 D/Recomposition:   └─ [param] onClick: () -> Unit stable (Function@xyz)
 ```
diff --git a/docs/version-map.md b/docs/version-map.md
@@ -6,7 +6,7 @@ It is **strongly recommended to use the exact same Kotlin version** as this libr
 
 | Stability Analyzer | Kotlin |
 |--------------------|--------|
-| 0.7.3+             | 2.3.20 |
+| 0.7.4+             | 2.3.20 |
 | 0.6.5 ~ 0.7.0     | 2.3.0  |
 | 0.4.0 ~ 0.6.4     | 2.2.21 |
 
diff --git a/gradle.properties b/gradle.properties
@@ -48,7 +48,7 @@ kotlin.mpp.androidGradlePluginCompatibility.nowarn=true
 
 # Maven publishing
 GROUP=com.github.skydoves
-VERSION_NAME=0.7.4-SNAPSHOT
+VERSION_NAME=0.7.4
 
 POM_URL=https://github.com/skydoves/compose-stability-analyzer/
 POM_SCM_URL=https://github.com/skydoves/compose-stability-analyzer/
diff --git a/gradle/libs.versions.toml b/gradle/libs.versions.toml
@@ -13,7 +13,7 @@ androidGradlePlugin = "8.13.1"
 androidxActivity = "1.11.0"
 androidxComposeBom = "2025.12.00"
 jetbrains-compose = "1.9.3"
-compose-stability-analyzer = "0.7.4-SNAPSHOT"
+compose-stability-analyzer = "0.7.3"
 runtimeAnnotation = "1.9.0"
 spotless = "6.21.0"
 shadow = "9.0.0-beta12"
diff --git a/stability-gradle/src/main/kotlin/com/skydoves/compose/stability/gradle/StabilityAnalyzerGradlePlugin.kt b/stability-gradle/src/main/kotlin/com/skydoves/compose/stability/gradle/StabilityAnalyzerGradlePlugin.kt
@@ -47,7 +47,7 @@ public class StabilityAnalyzerGradlePlugin : KotlinCompilerPluginSupportPlugin {
 
     // This version should match the version in gradle.properties
     // Update this when bumping the library version
-    private const val VERSION = "0.7.4-SNAPSHOT"
+    private const val VERSION = "0.7.4"
 
     // Compiler option keys
     private const val OPTION_ENABLED = "enabled"

Original file line number	Diff line number	Diff line change
`@@ -26,7 +26,7 @@ kotlin {`
`26`	`26`	`}`
`27`	`27`
`28`	`28`	`group = "com.github.skydoves"`
`29`		`-version = "0.7.4-SNAPSHOT"`
	`29`	`+version = "0.7.4"`
`30`	`30`
`31`	`31`	`repositories {`
`32`	`32`	`mavenLocal()`