## Summary
This pull request introduces custom screen transition animations to
enhance the overall user experience during navigation.
The key change is the implementation of a custom slide/fade effect for
navigating from main screens (i.e., screens hosted in the bottom
navigation bar) to detail screens. Transitions between the bottom
navigation bar tabs themselves retain a simple, clean cross-fade effect
to ensure a fast and smooth user interaction.
This PR also addresses the root cause of an issue where custom
animations were being overridden by the navigation library's defaults.
## Root Cause
During implementation, it was discovered that custom transition
animations defined in the `defaultTransitions` parameter of the
`DestinationsNavHost` in `MainActivity` were not being applied. Instead,
a default fade-in/fade-out animation was always present.
The root cause was traced to the `compose-destinations` KSP (Kotlin
Symbol Processing) code generator. By default, the generator creates a
`NavGraphSpec` (e.g., `RootNavGraph.kt`) that includes its own
`defaultTransitions` property. This property, defined at compile-time
within the generated graph object, has a higher precedence than the
`defaultTransitions` parameter supplied to the `DestinationsNavHost`
composable at runtime.
As a result, our intended custom animations were being ignored and
overridden by the generated default.
## Solution
To resolve this precedence issue permanently, this PR adopts the
official configuration method recommended by the `compose-destinations`
library.
- The following KSP argument has been added to the
`app/build.gradle.kts` file:
```kotlin
ksp {
arg("compose-destinations.defaultTransitions", "none")
}
```
- This argument instructs the code generator to omit the
`defaultTransitions` property from the generated `NavGraphSpec`.
- By removing the higher-priority, generated default, the
`defaultTransitions` parameter on `DestinationsNavHost` now functions as
the effective default, allowing our custom animation logic to execute as
intended.
## Animation Logic Details
The new animation logic is conditional and defined within
`MainActivity`. It distinguishes between two primary navigation types:
- Main Screen → Detail Screen:
- Enter: The new detail screen slides in from the right.
- Exit: The old main screen slides out to the left while fading out.
- Detail Screen → Main Screen (on Pop):
- Pop Enter: The main screen slides back in from the left while fading
in.
- Pop Exit: The detail screen slides out to the right.
- Between Bottom Navigation Tabs:
- A simple cross-fade (`fadeIn`/`fadeOut`) is maintained for these
transitions to provide a quick and non-disruptive experience when
switching between primary sections of the app.
Bumps the maven group with 7 updates in the /manager directory:
| Package | From | To |
| --- | --- | --- |
| androidx.compose:compose-bom | `2025.05.01` | `2025.06.00` |
| androidx.lifecycle:lifecycle-runtime-ktx | `2.9.0` | `2.9.1` |
| androidx.lifecycle:lifecycle-runtime-compose | `2.9.0` | `2.9.1` |
| androidx.lifecycle:lifecycle-viewmodel-compose | `2.9.0` | `2.9.1` |
| androidx.webkit:webkit | `1.13.0` | `1.14.0` |
| [org.lsposed.libcxx:libcxx](https://github.com/LSPosed/prefab-libcxx)
| `27.0.12077973` | `28.1.13356709` |
| [com.google.devtools.ksp](https://github.com/google/ksp) |
`2.1.21-2.0.1` | `2.1.21-2.0.2` |
Updates `androidx.compose:compose-bom` from 2025.05.01 to 2025.06.00
Updates `androidx.lifecycle:lifecycle-runtime-ktx` from 2.9.0 to 2.9.1
Updates `androidx.lifecycle:lifecycle-runtime-compose` from 2.9.0 to
2.9.1
Updates `androidx.lifecycle:lifecycle-viewmodel-compose` from 2.9.0 to
2.9.1
Updates `androidx.lifecycle:lifecycle-runtime-compose` from 2.9.0 to
2.9.1
Updates `androidx.lifecycle:lifecycle-viewmodel-compose` from 2.9.0 to
2.9.1
Updates `androidx.webkit:webkit` from 1.13.0 to 1.14.0
Updates `org.lsposed.libcxx:libcxx` from 27.0.12077973 to 28.1.13356709
<details>
<summary>Commits</summary>
<ul>
<li><a
href="1e95c38b8a"><code>1e95c38</code></a>
28.1.13356709</li>
<li><a
href="9d672dd836"><code>9d672dd</code></a>
27.0.12077973-1</li>
<li>See full diff in <a
href="https://github.com/LSPosed/prefab-libcxx/compare/27.0.12077973...28.1.13356709">compare
view</a></li>
</ul>
</details>
<br />
Updates `com.google.devtools.ksp` from 2.1.21-2.0.1 to 2.1.21-2.0.2
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/google/ksp/releases">com.google.devtools.ksp's
releases</a>.</em></p>
<blockquote>
<h2>2.1.21-2.0.2</h2>
<h2>What's Changed</h2>
<p>KSP1: use new mangling scheme for inline classes <a
href="https://redirect.github.com/google/ksp/issues/2446">#2446</a>
KSP task (non-)registration happens too soon <a
href="https://redirect.github.com/google/ksp/issues/1789">#1789</a>
[ksp2] Resolver.getJvmName wrong for properties starts with is <a
href="https://redirect.github.com/google/ksp/issues/2275">#2275</a>
Inlined JVM name is not correct <a
href="https://redirect.github.com/google/ksp/issues/1493">#1493</a>
[KSP2] Annotation values of inner annotations shouldn't be marked as
default <a
href="https://redirect.github.com/google/ksp/issues/2437">#2437</a>
Properly support <a href="https://github.com/all"><code>@all</code></a>
annotation use site target <a
href="https://redirect.github.com/google/ksp/issues/2438">#2438</a></p>
<h2>Contributors</h2>
<p>Thanks to everyone who reported bugs and participated in
discussions!</p>
<p><strong>Full Changelog</strong>: <a
href="https://github.com/google/ksp/compare/2.1.21-2.0.1...2.1.21-2.0.2">https://github.com/google/ksp/compare/2.1.21-2.0.1...2.1.21-2.0.2</a></p>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="e9efa37e8c"><code>e9efa37</code></a>
Handle a weird case from Analysis API</li>
<li><a
href="0f5ff31fe7"><code>0f5ff31</code></a>
Add clarification to possible value types of KSValueArgument.value</li>
<li><a
href="2ac9a4ccd4"><code>2ac9a4c</code></a>
UPDATE_KOTLIN_VERSION: 2.1.21</li>
<li><a
href="68d41f7c71"><code>68d41f7</code></a>
Ignore .kotlin/</li>
<li><a
href="529403acb8"><code>529403a</code></a>
Support friend modules</li>
<li><a
href="9fc3e74724"><code>9fc3e74</code></a>
Cleanup: remove CompilerConfiguration</li>
<li><a
href="9323eccdde"><code>9323ecc</code></a>
Small grammatical fix, otherwised -> otherwise</li>
<li><a
href="c48c1e891d"><code>c48c1e8</code></a>
Upgrade to the latest lint-gradle checks</li>
<li><a
href="084b3e8396"><code>084b3e8</code></a>
Better naming of variables</li>
<li><a
href="12bbdfdd0a"><code>12bbdfd</code></a>
Fix origin of arguments of synthetic annotations</li>
<li>Additional commits viewable in <a
href="https://github.com/google/ksp/compare/2.1.21-2.0.1...2.1.21-2.0.2">compare
view</a></li>
</ul>
</details>
<br />
<details>
<summary>Most Recent Ignore Conditions Applied to This Pull
Request</summary>
| Dependency Name | Ignore Conditions |
| --- | --- |
| com.google.devtools.ksp | [< 1.10, > 1.9.23-1.0.20] |
</details>
Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.
[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)
---
<details>
<summary>Dependabot commands and options</summary>
<br />
You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after
your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge
and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating
it. You can achieve the same result by closing it manually
- `@dependabot show <dependency name> ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore <dependency name> major version` will close this
group update PR and stop Dependabot creating any more for the specific
dependency's major version (unless you unignore this specific
dependency's major version or upgrade to it yourself)
- `@dependabot ignore <dependency name> minor version` will close this
group update PR and stop Dependabot creating any more for the specific
dependency's minor version (unless you unignore this specific
dependency's minor version or upgrade to it yourself)
- `@dependabot ignore <dependency name>` will close this group update PR
and stop Dependabot creating any more for the specific dependency
(unless you unignore this specific dependency or upgrade to it yourself)
- `@dependabot unignore <dependency name>` will remove all of the ignore
conditions of the specified dependency
- `@dependabot unignore <dependency name> <ignore condition>` will
remove the ignore condition of the specified dependency and ignore
conditions
</details>
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
