… and onBeforeClusterItemRendered (#1566)

Co-authored-by: Programmeister <[email protected]>

* feat: port MathUtil to Kotlin

This commit ports the `MathUtil` class from Java to idiomatic Kotlin.

The existing tests were leveraged to ensure that the port was successful, and a new test was added for `MathUtil` to ensure that it is well-tested.

* feat: port SphericalUtil to Kotlin

This commit ports the `SphericalUtil` class from Java to idiomatic Kotlin.

The existing tests were leveraged to ensure that the port was successful, and the tests were updated to use Google Truth assertions.

* feat(library): Port PolyUtil to Kotlin and enhance tests

This commit introduces a significant modernization of the `PolyUtil` class by porting it from Java to idiomatic Kotlin. This change improves the code's conciseness, readability, and null safety.

The key changes in this commit are:
- **Porting `PolyUtil` to Kotlin**: The `PolyUtil` class has been completely rewritten in Kotlin, taking advantage of features like top-level functions, default arguments, and extension functions. The public API has been preserved with `@JvmStatic` annotations to ensure backward compatibility for Java consumers.
- **Updating tests to use Google Truth**: The corresponding `PolyUtilTest` has been updated to use Google Truth assertions. This makes the tests more readable and expressive.

* fix: Add correct copyright header

* refactor: minor changes to comments and a fix to use the correct Google truth dependency

* Update library/src/main/java/com/google/maps/android/MathUtil.kt

Co-authored-by: Enrique López-Mañas <[email protected]>

---------

Co-authored-by: Enrique López-Mañas <[email protected]>

# [3.16.0](v3.15.0...v3.16.0) (2025-08-26)

### Features

* **library:** Port PolyUtil to Kotlin and enhance tests ([#1565](#1565)) ([90c56df](90c56df))

* build: run tests only on PR, not on push

* build: run tests only on PR, not on push

* Rename .java to .kt

* feat(library): Port PointQuadTree and tests to Kotlin

This commit migrates the `PointQuadTree` class and its corresponding test, `PointQuadTreeTest`, from Java to idiomatic Kotlin.

This conversion modernizes the codebase, improving its conciseness, readability, and null safety.

The key changes are:
- **`PointQuadTree` to Kotlin**: The core `PointQuadTree` class has been rewritten in Kotlin, leveraging features like primary constructors, companion objects, and stricter nullability.
- **`PointQuadTreeTest` to Kotlin**: The associated test class has also been ported to Kotlin, resulting in more streamlined test code.
- **Copyright Header Update**: The copyright year has been updated in the converted files.

* Rename .java to .kt

* refactor(geometry): Port Point and Bounds classes to Kotlin

This commit modernizes the `Point` and `Bounds` classes by converting them from Java to idiomatic Kotlin. This change improves code conciseness, readability, and null safety.

Key changes include:
- The `Point` and `Bounds` classes are now written in Kotlin.
- `@JvmField` annotations are used on properties to maintain binary compatibility for Java consumers.
- New unit tests, `PointTest.kt` and `BoundsTest.kt`, have been added to ensure the correctness of the ported classes.

* feat: added headers

---------

Co-authored-by: Enrique López Mañas <[email protected]>

…pleItems (#1557)

* refactor: simplify switch and improve locking in ClusterRendererMultipleItems

- Replaced a traditional switch statement with an enhanced switch expression in `setAnimationType`.
- Added a `setAnimationInterpolator` method to allow custom interpolators.
- Ensured `lock.unlock()` is always called in `finally` blocks within `MarkerModifier` and `AnimationTask` for better resource management.
- Added `@Override` annotation to `ViewModifier.run()`.

* refactor: Refactor MarkerModifier to use a withLock method

This commit refactors the `MarkerModifier` class to use a `withLock` method. This reduces code repetition and improves readability.

* docs: adding sample with Clustering Algorithms

* docs: header

* docs: comments from PR

* Rename .java to .kt

* refactor(library): Convert projection.Point to Kotlin and add tests

The `@Deprecated` annotation has been updated to the Kotlin syntax and now includes a `ReplaceWith` expression to provide IDE quick-fix support.

Additionally, new unit tests using Google Truth have been added for the `Point` class to verify its construction and inheritance.

* refactor(heatmaps): Port Gradient and WeightedLatLng to Kotlin

This commit migrates the `Gradient` and `WeightedLatLng` classes and their corresponding tests from Java to idiomatic Kotlin.

This conversion is part of the larger effort to modernize the library and prepare it for Kotlin Multiplatform (KMP) compatibility.

Key changes include:
- `WeightedLatLng` is now a `data class` with a private primary constructor to ensure correct instantiation while providing the benefits of auto-generated methods. The `@ExposedCopyVisibility` annotation has been added to maintain binary compatibility for the `copy()` method.
- `Gradient` has been converted to a Kotlin class, using `@JvmOverloads` for constructor compatibility and a `companion object` for its static helper method.
- The `internal` visibility of a method in `Gradient` was changed to `public` to ensure visibility to Java classes during the mixed-language phase of the migration.
- Unit tests for both classes have been ported to Kotlin, using the Truth assertion framework.

* feat(heatmaps): Port HeatmapTileProvider to Kotlin

This commit completes the migration of the `heatmaps` package to Kotlin by porting the final and most complex class, `HeatmapTileProvider`.

This conversion modernizes the class by introducing several idiomatic Kotlin features and improves its design by refactoring a key data structure.

Key changes include:
- The `HeatmapTileProvider` and its `Builder` are now written in Kotlin.
- The `getMaxValue()` method was refactored to use a `Map` with a type-safe `Vector` key instead of the Android-specific `LongSparseArray`, improving readability and moving closer to KMP compatibility.
- A new test suite was created from scratch for the provider, as none existed previously. This improves the code coverage and reliability of the module.
- Necessary adjustments were made to the demo application to support the newly ported Kotlin class.

* fix(tests): Correct copyright headers in new test files

Updates the copyright headers in the test files that were created
during the Kotlin porting process.

- Corrects the copyright year to 2025.
- Corrects the company name from "Google Inc." to "Google LLC".

* chore: Add PLACES_API_KEY to local.defaults.properties

* fix(heatmaps): Correct copyright headers

Updates the copyright headers in the `heatmaps` package source and test files.

- Corrects the copyright year to 2025.
- Corrects the company name from "Google Inc." to "Google LLC".

* refactor(heatmaps): Improve API clarity and documentation

Addresses feedback to make the heatmap API more intuitive and robust.

- Renames `setWeightedData` and `setData` in `HeatmapTileProvider` to `updateData` and `updateLatLngs` respectively. The `update` prefix better communicates that these methods perform expensive operations that rebuild internal state, rather than just setting a property.
- The old method names are preserved and marked as `@Deprecated` to provide a smooth migration path for existing users and avoid a breaking change.

- Adds a default value of 0.7 to the `opacity` parameter in `Gradient.generateColorMap`. This aligns with the default in `HeatmapTileProvider` and simplifies common use cases.
- Annotates `generateColorMap` with `@JvmOverloads` to ensure the new default parameter is exposed correctly to Java clients.

- Improves KDoc for all modified methods to be more descriptive, explaining the purpose of the code and the reasoning behind the design choices.

* refactor(heatmaps): Use constant for default opacity

Updates the `generateColorMap` function to use the
`HeatmapTileProvider.DEFAULT_OPACITY` constant for its default
opacity value.

This removes a hardcoded value, improving maintainability and ensuring
the default remains consistent with the provider. The accompanying
KDoc has also been corrected.

* Rename .java to .kt

* refactor(library): Convert projection.Point to Kotlin and add tests

The `@Deprecated` annotation has been updated to the Kotlin syntax and now includes a `ReplaceWith` expression to provide IDE quick-fix support.

Additionally, new unit tests using Google Truth have been added for the `Point` class to verify its construction and inheritance.

* refactor(heatmaps): Port Gradient and WeightedLatLng to Kotlin

This commit migrates the `Gradient` and `WeightedLatLng` classes and their corresponding tests from Java to idiomatic Kotlin.

This conversion is part of the larger effort to modernize the library and prepare it for Kotlin Multiplatform (KMP) compatibility.

Key changes include:
- `WeightedLatLng` is now a `data class` with a private primary constructor to ensure correct instantiation while providing the benefits of auto-generated methods. The `@ExposedCopyVisibility` annotation has been added to maintain binary compatibility for the `copy()` method.
- `Gradient` has been converted to a Kotlin class, using `@JvmOverloads` for constructor compatibility and a `companion object` for its static helper method.
- The `internal` visibility of a method in `Gradient` was changed to `public` to ensure visibility to Java classes during the mixed-language phase of the migration.
- Unit tests for both classes have been ported to Kotlin, using the Truth assertion framework.

* feat(heatmaps): Port HeatmapTileProvider to Kotlin

This commit completes the migration of the `heatmaps` package to Kotlin by porting the final and most complex class, `HeatmapTileProvider`.

This conversion modernizes the class by introducing several idiomatic Kotlin features and improves its design by refactoring a key data structure.

Key changes include:
- The `HeatmapTileProvider` and its `Builder` are now written in Kotlin.
- The `getMaxValue()` method was refactored to use a `Map` with a type-safe `Vector` key instead of the Android-specific `LongSparseArray`, improving readability and moving closer to KMP compatibility.
- A new test suite was created from scratch for the provider, as none existed previously. This improves the code coverage and reliability of the module.
- Necessary adjustments were made to the demo application to support the newly ported Kotlin class.

* fix(tests): Correct copyright headers in new test files

Updates the copyright headers in the test files that were created
during the Kotlin porting process.

- Corrects the copyright year to 2025.
- Corrects the company name from "Google Inc." to "Google LLC".

* chore: Add PLACES_API_KEY to local.defaults.properties

* fix(heatmaps): Correct copyright headers

Updates the copyright headers in the `heatmaps` package source and test files.

- Corrects the copyright year to 2025.
- Corrects the company name from "Google Inc." to "Google LLC".

* feat: Implement edge-to-edge UI

This commit implements edge-to-edge UI for the demo application.

Changes include:
- Updating the app theme to be edge-to-edge.
- Applying window insets to the base and main activities.
- Adding a separate styles.xml for API 27+ to handle display cutouts.

* fix: Update copyright headers

This commit updates the copyright headers in the following files:
- demo/build.gradle.kts
- demo/src/main/java/com/google/maps/android/utils/demo/BaseDemoActivity.java
- demo/src/main/java/com/google/maps/android/utils/demo/MainActivity.java
- demo/src/main/res/values/styles.xml
- demo/src/main/res/values-v27/styles.xml

* chore: fix copyright headers

* Fix copyright year

* Fix copyright header in main.xml

* refactor(heatmaps): Replace check with require in HeatmapTileProvider.Builder

This commit replaces the `check` function with `require` for validating input data in the `HeatmapTileProvider.Builder`.

Using `require` is more idiomatic for precondition checks, throwing an `IllegalArgumentException` which is more appropriate in this context than the `IllegalStateException` thrown by `check`.

* chore(heatmaps): Correct expected exception in HeatmapTileProviderTest

This commit updates `HeatmapTileProviderTest` to expect an `IllegalArgumentException` instead of `IllegalStateException` when building a provider with no data. It also cleans up unused exception variables in catch blocks.

* chore: fixed algorithm samples

* Removed