docs: add deprecation notices for Marker and HeatmapLayer components

- Mark Marker component as deprecated (deprecated Feb 2024)
- Mark HeatmapLayer component as deprecated (deprecated May 2025)
- Add TypeScript @deprecated annotations with migration guidance
- Update README with GitHub-style warning alerts
- Update VitePress documentation with warning containers
- Add deprecation badges to component lists and table of contents

Follows Google Maps JavaScript API deprecation timeline:
- Marker API deprecated Feb 2024, migrate to AdvancedMarker
- HeatmapLayer deprecated May 2025, migrate to deck.gl (sunset May 2026)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: HusamElbashir

README.md

@@ -16,7 +16,7 @@ Note: Please refer to the [documentation site](https://vue3-google-map.com/) for
   - [Your First Map](#your-first-map)
 - [Components](#components)
   - [Advanced Marker](#advanced-marker)
-  - [Marker](#marker)
+  - [Marker](#marker) ⚠️ **Deprecated**
   - [Polyline](#polyline)
   - [Polygon](#polygon)
   - [Rectangle](#rectangle)
@@ -25,7 +25,7 @@ Note: Please refer to the [documentation site](https://vue3-google-map.com/) for
   - [Custom Marker](#custom-marker)
   - [Custom Control](#custom-control)
   - [Marker Cluster](#marker-cluster)
-  - [Heatmap Layer](#heatmap-layer)
+  - [Heatmap Layer](#heatmap-layer) ⚠️ **Deprecated**
 - [Advanced Usage](#advanced-usage)
 - [Contribution](#contribution)
 - [License](#license)
@@ -87,7 +87,7 @@ This library is intended to be used in a composable fashion. Therefore you will
 The main mapping component is `GoogleMap`, however the following components are available at your disposal:
 
 - [AdvancedMarker](#advanced-marker)
-- [Marker](#marker)
+- [Marker](#marker) ⚠️ **Deprecated** - Use AdvancedMarker instead
 - [Polyline](#polyline)
 - [Polygon](#polygon)
 - [Rectangle](#rectangle)
@@ -96,6 +96,7 @@ The main mapping component is `GoogleMap`, however the following components are
 - [CustomMarker](#custom-marker)
 - [CustomControl](#custom-control)
 - [MarkerCluster](#marker-cluster)
+- [HeatmapLayer](#heatmap-layer) ⚠️ **Deprecated**
 
 ### Advanced Marker
 
@@ -157,6 +158,9 @@ You can listen for [the following events](https://developers.google.com/maps/doc
 
 ### Marker
 
+> [!WARNING]
+> **DEPRECATED:** The `Marker` component is deprecated as of February 2024. Please use the [`AdvancedMarker`](#advanced-marker) component instead for new projects. The legacy `google.maps.Marker` API will be removed in a future version. [Learn more about the deprecation](https://developers.google.com/maps/deprecations#googlemapsmarker_in_the_deprecated_as_of_february_2024).
+
 Use the `Marker` component to draw markers, drop pins or any custom icons on a map.
 
 #### Options
@@ -709,6 +713,9 @@ You can listen for [the following events](https://googlemaps.github.io/js-marker
 
 ### Heatmap Layer
 
+> [!WARNING]
+> **DEPRECATED:** The `HeatmapLayer` component was deprecated on **May 27, 2025** and will be sunset in **May 2026**. Google recommends migrating to third-party library integrations like [deck.gl](https://deck.gl/), which offers a HeatmapLayer implementation. [Learn more about the deprecation](https://developers.google.com/maps/deprecations).
+
 Use the `HeatmapLayer` component to depict the intensity of data at geographical points on the map. Make sure to include the `visualization` library in the `libraries` prop of the `GoogleMap` component.
 
 #### Options

docs/components/heatmap-layer.md

@@ -25,6 +25,10 @@ const heatmapData = [
 
 # Heatmap Layer
 
+::: warning DEPRECATED
+The `HeatmapLayer` component was deprecated on **May 27, 2025** and will be sunset in **May 2026**. Google recommends migrating to third-party library integrations like [deck.gl](https://deck.gl/), which offers a HeatmapLayer implementation. [Learn more about the deprecation](https://developers.google.com/maps/deprecations).
+:::
+
 Use the `HeatmapLayer` component to depict the intensity of data at geographical points on the map. Make sure to include the `visualization` library in the `libraries` prop of the `GoogleMap` component.
 
 ## Options

docs/components/index.md

@@ -5,7 +5,7 @@ This library is intended to be used in a composable fashion. Therefore you will
 The main mapping component is `GoogleMap`, however the following components are available at your disposal:
 
 - [AdvancedMarker](./advanced-marker.md)
-- [Marker](./marker.md)
+- [Marker](./marker.md) ⚠️ **Deprecated** - Use AdvancedMarker instead
 - [Polyline](./polyline.md)
 - [Polygon](./polygon.md)
 - [Rectangle](./rectangle.md)
@@ -14,4 +14,4 @@ The main mapping component is `GoogleMap`, however the following components are
 - [Custom Marker](./custom-marker.md)
 - [Custom Control](./custom-control.md)
 - [Marker Cluster](./marker-cluster.md)
-- [Heatmap Layer](./heatmap-layer.md)
+- [Heatmap Layer](./heatmap-layer.md) ⚠️ **Deprecated**

docs/components/marker.md

@@ -7,6 +7,10 @@ const center = { lat: 40.689247, lng: -74.044502 }
 
 # Marker
 
+::: warning DEPRECATED
+The `Marker` component is deprecated as of February 2024. Please use the [`AdvancedMarker`](./advanced-marker.md) component instead for new projects. The legacy `google.maps.Marker` API will be removed in a future version. [Learn more about the deprecation](https://developers.google.com/maps/deprecations#googlemapsmarker_in_the_deprecated_as_of_february_2024).
+:::
+
 Use the `Marker` component to draw markers, drop pins or any custom icons on a map.
 
 ## Options

src/components/HeatmapLayer.ts

@@ -8,6 +8,11 @@ interface ExtendedHeatmapLayerOptions extends Omit<HeatmapLayerOptions, "data">
   data: HeatmapLayerOptions["data"] | (google.maps.LatLngLiteral | { location: google.maps.LatLngLiteral })[];
 }
 
+/**
+ * @deprecated The HeatmapLayer component was deprecated on May 27, 2025 and will be sunset in May 2026.
+ * Google recommends migrating to third-party library integrations like deck.gl, which offers a HeatmapLayer implementation.
+ * @see {@link https://developers.google.com/maps/deprecations} for more information.
+ */
 export default defineComponent({
   name: "HeatmapLayer",
   props: {

src/components/Marker.ts

@@ -28,6 +28,12 @@ const markerEvents = [
   "visible_changed",
 ];
 
+/**
+ * @deprecated The Marker component is deprecated as of February 2024. Use AdvancedMarker instead.
+ * The google.maps.Marker API is deprecated and will be removed in a future version.
+ * Migrate to AdvancedMarker for the latest features and better performance.
+ * @see {@link https://developers.google.com/maps/deprecations} for more information.
+ */
 export default defineComponent({
   name: "Marker",
   props: {