@angular/google-maps 19.0.0-next.8 → 19.0.0-next.9

package/index.d.ts

@@ -11,6 +11,48 @@ import { OnInit } from '@angular/core';
 import { QueryList } from '@angular/core';
 import { SimpleChanges } from '@angular/core';
 
+declare interface Algorithm_2 {
+    /**
+     * Calculates an array of {@link Cluster}.
+     */
+    calculate: ({ markers, map }: AlgorithmInput) => AlgorithmOutput;
+}
+
+declare interface AlgorithmInput {
+    /**
+     * The map containing the markers and clusters.
+     */
+    map: google.maps.Map;
+    /**
+     * An array of markers to be clustered.
+     *
+     * There are some specific edge cases to be aware of including the following:
+     * * Markers that are not visible.
+     */
+    markers: Marker[];
+    /**
+     * The `mapCanvasProjection` enables easy conversion from lat/lng to pixel.
+     *
+     * @see [MapCanvasProjection](https://developers.google.com/maps/documentation/javascript/reference/overlay-view#MapCanvasProjection)
+     */
+    mapCanvasProjection: google.maps.MapCanvasProjection;
+}
+
+declare interface AlgorithmOptions {
+    maxZoom?: number;
+}
+
+declare interface AlgorithmOutput {
+    /**
+     * The clusters returned based upon the {@link AlgorithmInput}.
+     */
+    clusters: Cluster_2[];
+    /**
+     * A boolean flag indicating that the clusters have not changed.
+     */
+    changed?: boolean;
+}
+
 /**
  * Function type alias for determining the aria label on a Google Maps marker cluster.
  *
@@ -38,6 +80,27 @@ declare class Cluster {
     updateIcon(): void;
 }
 
+declare class Cluster_2 {
+    marker?: Marker;
+    readonly markers?: Marker[];
+    protected _position: google.maps.LatLng;
+    constructor({ markers, position }: ClusterOptions);
+    get bounds(): google.maps.LatLngBounds | undefined;
+    get position(): google.maps.LatLng;
+    /**
+     * Get the count of **visible** markers.
+     */
+    get count(): number;
+    /**
+     * Add a marker to the cluster.
+     */
+    push(marker: Marker): void;
+    /**
+     * Cleanup references and remove marker from map.
+     */
+    delete(): void;
+}
+
 /**
  * Info interface for a marker cluster icon.
  *
@@ -75,6 +138,27 @@ export declare interface ClusterIconStyle {
     width: number;
 }
 
+declare interface ClusterOptions {
+    position?: google.maps.LatLng | google.maps.LatLngLiteral;
+    markers?: Marker[];
+}
+
+declare class ClusterStats {
+    readonly markers: {
+        sum: number;
+    };
+    readonly clusters: {
+        count: number;
+        markers: {
+            mean: number;
+            sum: number;
+            min: number;
+            max: number;
+        };
+    };
+    constructor(markers: Marker[], clusters: Cluster_2[]);
+}
+
 /** Arbitrary default height for the map element */
 declare const DEFAULT_HEIGHT = "500px";
 
@@ -106,6 +190,116 @@ declare const DEFAULT_OPTIONS: google.maps.MapOptions;
 /** Arbitrary default width for the map element */
 declare const DEFAULT_WIDTH = "500px";
 
+/**
+ * Angular component for implementing a Google Maps Marker Clusterer.
+ * See https://developers.google.com/maps/documentation/javascript/marker-clustering
+ *
+ * @deprecated This component is using a deprecated clustering implementation. Use the
+ *   `map-marker-clusterer` component instead.
+ * @breaking-change 21.0.0
+ *
+ */
+export declare class DeprecatedMapMarkerClusterer implements OnInit, AfterContentInit, OnChanges, OnDestroy {
+    private readonly _googleMap;
+    private readonly _ngZone;
+    private readonly _currentMarkers;
+    private readonly _eventManager;
+    private readonly _destroy;
+    /** Whether the clusterer is allowed to be initialized. */
+    private readonly _canInitialize;
+    ariaLabelFn: AriaLabelFn;
+    set averageCenter(averageCenter: boolean);
+    private _averageCenter;
+    batchSize?: number;
+    set batchSizeIE(batchSizeIE: number);
+    private _batchSizeIE;
+    set calculator(calculator: Calculator);
+    private _calculator;
+    set clusterClass(clusterClass: string);
+    private _clusterClass;
+    set enableRetinaIcons(enableRetinaIcons: boolean);
+    private _enableRetinaIcons;
+    set gridSize(gridSize: number);
+    private _gridSize;
+    set ignoreHidden(ignoreHidden: boolean);
+    private _ignoreHidden;
+    set imageExtension(imageExtension: string);
+    private _imageExtension;
+    set imagePath(imagePath: string);
+    private _imagePath;
+    set imageSizes(imageSizes: number[]);
+    private _imageSizes;
+    set maxZoom(maxZoom: number);
+    private _maxZoom;
+    set minimumClusterSize(minimumClusterSize: number);
+    private _minimumClusterSize;
+    set styles(styles: ClusterIconStyle[]);
+    private _styles;
+    set title(title: string);
+    private _title;
+    set zIndex(zIndex: number);
+    private _zIndex;
+    set zoomOnClick(zoomOnClick: boolean);
+    private _zoomOnClick;
+    set options(options: MarkerClustererOptions);
+    private _options;
+    /**
+     * See
+     * googlemaps.github.io/v3-utility-library/modules/
+     * _google_markerclustererplus.html#clusteringbegin
+     */
+    readonly clusteringbegin: Observable<void>;
+    /**
+     * See
+     * googlemaps.github.io/v3-utility-library/modules/_google_markerclustererplus.html#clusteringend
+     */
+    readonly clusteringend: Observable<void>;
+    /** Emits when a cluster has been clicked. */
+    readonly clusterClick: Observable<Cluster>;
+    _markers: QueryList<MapMarker>;
+    /**
+     * The underlying MarkerClusterer object.
+     *
+     * See
+     * googlemaps.github.io/v3-utility-library/classes/
+     * _google_markerclustererplus.markerclusterer.html
+     */
+    markerClusterer?: MarkerClusterer;
+    /** Event emitted when the clusterer is initialized. */
+    readonly markerClustererInitialized: EventEmitter<MarkerClusterer>;
+    constructor(...args: unknown[]);
+    ngOnInit(): void;
+    ngAfterContentInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    fitMapToMarkers(padding: number | google.maps.Padding): void;
+    getAverageCenter(): boolean;
+    getBatchSizeIE(): number;
+    getCalculator(): Calculator;
+    getClusterClass(): string;
+    getClusters(): Cluster[];
+    getEnableRetinaIcons(): boolean;
+    getGridSize(): number;
+    getIgnoreHidden(): boolean;
+    getImageExtension(): string;
+    getImagePath(): string;
+    getImageSizes(): number[];
+    getMaxZoom(): number;
+    getMinimumClusterSize(): number;
+    getStyles(): ClusterIconStyle[];
+    getTitle(): string;
+    getTotalClusters(): number;
+    getTotalMarkers(): number;
+    getZIndex(): number;
+    getZoomOnClick(): boolean;
+    private _combineOptions;
+    private _watchForMarkerChanges;
+    private _getInternalMarkers;
+    private _assertInitialized;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DeprecatedMapMarkerClusterer, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DeprecatedMapMarkerClusterer, "deprecated-map-marker-clusterer", ["mapMarkerClusterer"], { "ariaLabelFn": { "alias": "ariaLabelFn"; "required": false; }; "averageCenter": { "alias": "averageCenter"; "required": false; }; "batchSize": { "alias": "batchSize"; "required": false; }; "batchSizeIE": { "alias": "batchSizeIE"; "required": false; }; "calculator": { "alias": "calculator"; "required": false; }; "clusterClass": { "alias": "clusterClass"; "required": false; }; "enableRetinaIcons": { "alias": "enableRetinaIcons"; "required": false; }; "gridSize": { "alias": "gridSize"; "required": false; }; "ignoreHidden": { "alias": "ignoreHidden"; "required": false; }; "imageExtension": { "alias": "imageExtension"; "required": false; }; "imagePath": { "alias": "imagePath"; "required": false; }; "imageSizes": { "alias": "imageSizes"; "required": false; }; "maxZoom": { "alias": "maxZoom"; "required": false; }; "minimumClusterSize": { "alias": "minimumClusterSize"; "required": false; }; "styles": { "alias": "styles"; "required": false; }; "title": { "alias": "title"; "required": false; }; "zIndex": { "alias": "zIndex"; "required": false; }; "zoomOnClick": { "alias": "zoomOnClick"; "required": false; }; "options": { "alias": "options"; "required": false; }; }, { "clusteringbegin": "clusteringbegin"; "clusteringend": "clusteringend"; "clusterClick": "clusterClick"; "markerClustererInitialized": "markerClustererInitialized"; }, ["_markers"], ["*"], true, never>;
+}
+
 /**
  * Angular component that renders a Google Map via the Google Maps JavaScript
  * API.
@@ -345,7 +539,7 @@ export declare class GoogleMap implements OnChanges, OnInit, OnDestroy {
 
 export declare class GoogleMapsModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<GoogleMapsModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<GoogleMapsModule, never, [typeof i1.GoogleMap, typeof i2.MapBaseLayer, typeof i3.MapBicyclingLayer, typeof i4.MapCircle, typeof i5.MapDirectionsRenderer, typeof i6.MapGroundOverlay, typeof i7.MapHeatmapLayer, typeof i8.MapInfoWindow, typeof i9.MapKmlLayer, typeof i10.MapMarker, typeof i11.MapAdvancedMarker, typeof i12.MapMarkerClusterer, typeof i13.MapPolygon, typeof i14.MapPolyline, typeof i15.MapRectangle, typeof i16.MapTrafficLayer, typeof i17.MapTransitLayer], [typeof i1.GoogleMap, typeof i2.MapBaseLayer, typeof i3.MapBicyclingLayer, typeof i4.MapCircle, typeof i5.MapDirectionsRenderer, typeof i6.MapGroundOverlay, typeof i7.MapHeatmapLayer, typeof i8.MapInfoWindow, typeof i9.MapKmlLayer, typeof i10.MapMarker, typeof i11.MapAdvancedMarker, typeof i12.MapMarkerClusterer, typeof i13.MapPolygon, typeof i14.MapPolyline, typeof i15.MapRectangle, typeof i16.MapTrafficLayer, typeof i17.MapTransitLayer]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<GoogleMapsModule, never, [typeof i1.GoogleMap, typeof i2.MapBaseLayer, typeof i3.MapBicyclingLayer, typeof i4.MapCircle, typeof i5.MapDirectionsRenderer, typeof i6.MapGroundOverlay, typeof i7.MapHeatmapLayer, typeof i8.MapInfoWindow, typeof i9.MapKmlLayer, typeof i10.MapMarker, typeof i11.MapAdvancedMarker, typeof i12.DeprecatedMapMarkerClusterer, typeof i13.MapPolygon, typeof i14.MapPolyline, typeof i15.MapRectangle, typeof i16.MapTrafficLayer, typeof i17.MapTransitLayer, typeof i18.MapMarkerClusterer], [typeof i1.GoogleMap, typeof i2.MapBaseLayer, typeof i3.MapBicyclingLayer, typeof i4.MapCircle, typeof i5.MapDirectionsRenderer, typeof i6.MapGroundOverlay, typeof i7.MapHeatmapLayer, typeof i8.MapInfoWindow, typeof i9.MapKmlLayer, typeof i10.MapMarker, typeof i11.MapAdvancedMarker, typeof i12.DeprecatedMapMarkerClusterer, typeof i13.MapPolygon, typeof i14.MapPolyline, typeof i15.MapRectangle, typeof i16.MapTrafficLayer, typeof i17.MapTransitLayer, typeof i18.MapMarkerClusterer]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<GoogleMapsModule>;
 }
 
@@ -377,7 +571,7 @@ declare namespace i11 {
 
 declare namespace i12 {
     export {
-        MapMarkerClusterer
+        DeprecatedMapMarkerClusterer
     }
 }
 
@@ -411,6 +605,12 @@ declare namespace i17 {
     }
 }
 
+declare namespace i18 {
+    export {
+        MapMarkerClusterer
+    }
+}
+
 declare namespace i2 {
     export {
         MapBaseLayer
@@ -465,7 +665,7 @@ declare namespace i9 {
  *
  * See developers.google.com/maps/documentation/javascript/reference/marker
  */
-export declare class MapAdvancedMarker implements OnInit, OnChanges, OnDestroy, MapAnchorPoint {
+export declare class MapAdvancedMarker implements OnInit, OnChanges, OnDestroy, MapAnchorPoint, MarkerDirective {
     private readonly _googleMap;
     private _ngZone;
     private _eventManager;
@@ -562,6 +762,8 @@ export declare class MapAdvancedMarker implements OnInit, OnChanges, OnDestroy,
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     getAnchor(): google.maps.marker.AdvancedMarkerElement;
+    /** Returns a promise that resolves when the marker has been initialized. */
+    _resolveMarker(): Promise<google.maps.marker.AdvancedMarkerElement>;
     /** Creates a combined options object using the passed-in options and the individual inputs. */
     private _combineOptions;
     /** Asserts that the map has been initialized. */
@@ -1166,7 +1368,7 @@ export declare class MapKmlLayer implements OnInit, OnDestroy {
  *
  * See developers.google.com/maps/documentation/javascript/reference/marker
  */
-export declare class MapMarker implements OnInit, OnChanges, OnDestroy, MapAnchorPoint {
+export declare class MapMarker implements OnInit, OnChanges, OnDestroy, MapAnchorPoint, MarkerDirective {
     private readonly _googleMap;
     private _ngZone;
     private _eventManager;
@@ -1406,105 +1608,45 @@ export declare class MapMarker implements OnInit, OnChanges, OnDestroy, MapAncho
  *
  * See https://developers.google.com/maps/documentation/javascript/marker-clustering
  */
-export declare class MapMarkerClusterer implements OnInit, AfterContentInit, OnChanges, OnDestroy {
+export declare class MapMarkerClusterer implements OnInit, OnChanges, OnDestroy {
     private readonly _googleMap;
     private readonly _ngZone;
     private readonly _currentMarkers;
-    private readonly _eventManager;
-    private readonly _destroy;
+    private readonly _closestMapEventManager;
+    private _markersSubscription;
     /** Whether the clusterer is allowed to be initialized. */
     private readonly _canInitialize;
-    ariaLabelFn: AriaLabelFn;
-    set averageCenter(averageCenter: boolean);
-    private _averageCenter;
-    batchSize?: number;
-    set batchSizeIE(batchSizeIE: number);
-    private _batchSizeIE;
-    set calculator(calculator: Calculator);
-    private _calculator;
-    set clusterClass(clusterClass: string);
-    private _clusterClass;
-    set enableRetinaIcons(enableRetinaIcons: boolean);
-    private _enableRetinaIcons;
-    set gridSize(gridSize: number);
-    private _gridSize;
-    set ignoreHidden(ignoreHidden: boolean);
-    private _ignoreHidden;
-    set imageExtension(imageExtension: string);
-    private _imageExtension;
-    set imagePath(imagePath: string);
-    private _imagePath;
-    set imageSizes(imageSizes: number[]);
-    private _imageSizes;
-    set maxZoom(maxZoom: number);
-    private _maxZoom;
-    set minimumClusterSize(minimumClusterSize: number);
-    private _minimumClusterSize;
-    set styles(styles: ClusterIconStyle[]);
-    private _styles;
-    set title(title: string);
-    private _title;
-    set zIndex(zIndex: number);
-    private _zIndex;
-    set zoomOnClick(zoomOnClick: boolean);
-    private _zoomOnClick;
-    set options(options: MarkerClustererOptions);
-    private _options;
     /**
-     * See
-     * googlemaps.github.io/v3-utility-library/modules/
-     * _google_markerclustererplus.html#clusteringbegin
+     * Used to customize how the marker cluster is rendered.
+     * See https://googlemaps.github.io/js-markerclusterer/interfaces/Renderer.html.
      */
-    readonly clusteringbegin: Observable<void>;
+    renderer: Renderer;
     /**
-     * See
-     * googlemaps.github.io/v3-utility-library/modules/_google_markerclustererplus.html#clusteringend
+     * Algorithm used to cluster the markers.
+     * See https://googlemaps.github.io/js-markerclusterer/interfaces/Algorithm.html.
      */
+    algorithm: Algorithm_2;
+    /** Emits when clustering has started. */
+    readonly clusteringbegin: Observable<void>;
+    /** Emits when clustering is done. */
     readonly clusteringend: Observable<void>;
     /** Emits when a cluster has been clicked. */
-    readonly clusterClick: Observable<Cluster>;
-    _markers: QueryList<MapMarker>;
-    /**
-     * The underlying MarkerClusterer object.
-     *
-     * See
-     * googlemaps.github.io/v3-utility-library/classes/
-     * _google_markerclustererplus.markerclusterer.html
-     */
-    markerClusterer?: MarkerClusterer;
-    /** Event emitted when the clusterer is initialized. */
-    readonly markerClustererInitialized: EventEmitter<MarkerClusterer>;
-    constructor(...args: unknown[]);
-    ngOnInit(): void;
-    ngAfterContentInit(): void;
-    ngOnChanges(changes: SimpleChanges): void;
+    readonly clusterClick: EventEmitter<Cluster_2>;
+    /** Event emitted when the marker clusterer is initialized. */
+    readonly markerClustererInitialized: EventEmitter<MarkerClusterer_2>;
+    _markers: QueryList<MarkerDirective>;
+    /** Underlying MarkerClusterer object used to interact with Google Maps. */
+    markerClusterer?: MarkerClusterer_2;
+    ngOnInit(): Promise<void>;
+    ngOnChanges(changes: SimpleChanges): Promise<void>;
     ngOnDestroy(): void;
-    fitMapToMarkers(padding: number | google.maps.Padding): void;
-    getAverageCenter(): boolean;
-    getBatchSizeIE(): number;
-    getCalculator(): Calculator;
-    getClusterClass(): string;
-    getClusters(): Cluster[];
-    getEnableRetinaIcons(): boolean;
-    getGridSize(): number;
-    getIgnoreHidden(): boolean;
-    getImageExtension(): string;
-    getImagePath(): string;
-    getImageSizes(): number[];
-    getMaxZoom(): number;
-    getMinimumClusterSize(): number;
-    getStyles(): ClusterIconStyle[];
-    getTitle(): string;
-    getTotalClusters(): number;
-    getTotalMarkers(): number;
-    getZIndex(): number;
-    getZoomOnClick(): boolean;
-    private _combineOptions;
+    private _createCluster;
     private _watchForMarkerChanges;
+    private _destroyCluster;
     private _getInternalMarkers;
     private _assertInitialized;
     static ɵfac: i0.ɵɵFactoryDeclaration<MapMarkerClusterer, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MapMarkerClusterer, "map-marker-clusterer", ["mapMarkerClusterer"], { "ariaLabelFn": { "alias": "ariaLabelFn"; "required": false; }; "averageCenter": { "alias": "averageCenter"; "required": false; }; "batchSize": { "alias": "batchSize"; "required": false; }; "batchSizeIE": { "alias": "batchSizeIE"; "required": false; }; "calculator": { "alias": "calculator"; "required": false; }; "clusterClass": { "alias": "clusterClass"; "required": false; }; "enableRetinaIcons": { "alias": "enableRetinaIcons"; "required": false; }; "gridSize": { "alias": "gridSize"; "required": false; }; "ignoreHidden": { "alias": "ignoreHidden"; "required": false; }; "imageExtension": { "alias": "imageExtension"; "required": false; }; "imagePath": { "alias": "imagePath"; "required": false; }; "imageSizes": { "alias": "imageSizes"; "required": false; }; "maxZoom": { "alias": "maxZoom"; "required": false; }; "minimumClusterSize": { "alias": "minimumClusterSize"; "required": false; }; "styles": { "alias": "styles"; "required": false; }; "title": { "alias": "title"; "required": false; }; "zIndex": { "alias": "zIndex"; "required": false; }; "zoomOnClick": { "alias": "zoomOnClick"; "required": false; }; "options": { "alias": "options"; "required": false; }; }, { "clusteringbegin": "clusteringbegin"; "clusteringend": "clusteringend"; "clusterClick": "clusterClick"; "markerClustererInitialized": "markerClustererInitialized"; }, ["_markers"], ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MapMarkerClusterer, "map-marker-clusterer", ["mapMarkerClusterer"], { "renderer": { "alias": "renderer"; "required": false; }; "algorithm": { "alias": "algorithm"; "required": false; }; }, { "clusteringbegin": "clusteringbegin"; "clusteringend": "clusteringend"; "clusterClick": "clusterClick"; "markerClustererInitialized": "markerClustererInitialized"; }, ["_markers"], ["*"], true, never>;
 }
 
 /**
@@ -1871,6 +2013,9 @@ export declare class MapTransitLayer implements OnInit, OnDestroy {
     static ɵdir: i0.ɵɵDirectiveDeclaration<MapTransitLayer, "map-transit-layer", ["mapTransitLayer"], {}, { "transitLayerInitialized": "transitLayerInitialized"; }, never, never, true, never>;
 }
 
+/** Marker types from the Google Maps API. */
+declare type Marker = google.maps.Marker | google.maps.marker.AdvancedMarkerElement;
+
 
 /// <reference types="google.maps" preserve="true" />
 /**
@@ -1948,6 +2093,27 @@ declare class MarkerClusterer {
     static withDefaultStyle(overrides: ClusterIconStyle): ClusterIconStyle;
 }
 
+declare class MarkerClusterer_2 extends google.maps.OverlayView {
+    onClusterClick: onClusterClickHandler;
+    protected algorithm: Algorithm_2;
+    protected clusters: Cluster_2[];
+    protected markers: Marker[];
+    protected renderer: Renderer;
+    protected map: google.maps.Map | null;
+    protected idleListener: google.maps.MapsEventListener;
+    constructor({ map, markers, algorithmOptions, algorithm, renderer, onClusterClick, }: MarkerClustererOptions_2);
+    addMarker(marker: Marker, noDraw?: boolean): void;
+    addMarkers(markers: Marker[], noDraw?: boolean): void;
+    removeMarker(marker: Marker, noDraw?: boolean): boolean;
+    removeMarkers(markers: Marker[], noDraw?: boolean): boolean;
+    clearMarkers(noDraw?: boolean): void;
+    render(): void;
+    onAdd(): void;
+    onRemove(): void;
+    protected reset(): void;
+    protected renderClusters(): void;
+}
+
 /**
  * Options for constructing a MarkerClusterer from the @google/markerclustererplus library.
  *
@@ -1976,4 +2142,45 @@ export declare interface MarkerClustererOptions {
     zoomOnClick?: boolean;
 }
 
+declare interface MarkerClustererOptions_2 {
+    markers?: Marker[];
+    /**
+     * An algorithm to cluster markers. Default is {@link SuperClusterAlgorithm}. Must
+     * provide a `calculate` method accepting {@link AlgorithmInput} and returning
+     * an array of {@link Cluster}.
+     */
+    algorithm?: Algorithm_2;
+    algorithmOptions?: AlgorithmOptions;
+    map?: google.maps.Map | null;
+    /**
+     * An object that converts a {@link Cluster} into a `google.maps.Marker`.
+     * Default is {@link DefaultRenderer}.
+     */
+    renderer?: Renderer;
+    onClusterClick?: onClusterClickHandler;
+}
+
+/** Interface that should be implemented by directives that wrap marker APIs. */
+declare interface MarkerDirective {
+    _resolveMarker(): Promise<Marker>;
+}
+
+declare type onClusterClickHandler = (event: google.maps.MapMouseEvent, cluster: Cluster_2, map: google.maps.Map) => void;
+
+declare interface Renderer {
+    /**
+     * Turn a {@link Cluster} into a `Marker`.
+     *
+     * Below is a simple example to create a marker with the number of markers in the cluster as a label.
+     *
+     * ```typescript
+     * return new google.maps.Marker({
+     *   position,
+     *   label: String(markers.length),
+     * });
+     * ```
+     */
+    render(cluster: Cluster_2, stats: ClusterStats, map: google.maps.Map): Marker;
+}
+
 export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/google-maps",
-  "version": "19.0.0-next.8",
+  "version": "19.0.0-next.9",
   "description": "Angular Google Maps",
   "repository": {
     "type": "git",
@@ -27,7 +27,12 @@
   },
   "sideEffects": false,
   "schematics": "./schematics/collection.json",
-  "ng-update": {},
+  "ng-update": {
+    "migrations": "./schematics/migration.json",
+    "packageGroup": [
+      "@angular/google-maps"
+    ]
+  },
   "module": "./fesm2022/google-maps.mjs",
   "typings": "./index.d.ts",
   "type": "module",

package/schematics/migration.json

@@ -0,0 +1,9 @@
+{
+  "schematics": {
+    "migration-v19": {
+      "version": "19.0.0-0",
+      "description": "Updates the Angular Google Maps package to v19",
+      "factory": "./ng-update/index_bundled#updateToV19"
+    }
+  }
+}

package/schematics/ng-update/index_bundled.js

@@ -0,0 +1,115 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// bazel-out/k8-fastbuild/bin/src/google-maps/schematics/ng-update/index.mjs
+var ng_update_exports = {};
+__export(ng_update_exports, {
+  updateToV19: () => updateToV19
+});
+module.exports = __toCommonJS(ng_update_exports);
+var import_typescript = __toESM(require("typescript"), 1);
+var TAG_NAME = "map-marker-clusterer";
+var MODULE_NAME = "@angular/google-maps";
+var CLASS_NAME = "MapMarkerClusterer";
+var DEPRECATED_CLASS_NAME = "DeprecatedMapMarkerClusterer";
+function updateToV19() {
+  return (tree) => {
+    tree.visit((path) => {
+      if (path.endsWith(".html")) {
+        const content = tree.readText(path);
+        if (content.includes("<" + TAG_NAME)) {
+          tree.overwrite(path, migrateHtml(content));
+        }
+      } else if (path.endsWith(".ts") && !path.endsWith(".d.ts")) {
+        migrateTypeScript(path, tree);
+      }
+    });
+  };
+}
+function migrateHtml(content) {
+  return content.replace(/<map-marker-clusterer/g, "<deprecated-map-marker-clusterer").replace(/<\/map-marker-clusterer/g, "</deprecated-map-marker-clusterer");
+}
+function migrateTypeScript(path, tree) {
+  const content = tree.readText(path);
+  if (!content.includes("<" + TAG_NAME) && !content.includes(MODULE_NAME) && !content.includes(CLASS_NAME)) {
+    return;
+  }
+  const sourceFile = import_typescript.default.createSourceFile(path, content, import_typescript.default.ScriptTarget.Latest, true);
+  const toMigrate = findTypeScriptNodesToMigrate(sourceFile);
+  if (toMigrate.length === 0) {
+    return;
+  }
+  const printer = import_typescript.default.createPrinter();
+  const update = tree.beginUpdate(path);
+  for (const node of toMigrate) {
+    let replacement;
+    if (import_typescript.default.isStringLiteralLike(node)) {
+      if (import_typescript.default.isStringLiteral(node)) {
+        replacement = import_typescript.default.factory.createStringLiteral(migrateHtml(node.text), node.getText()[0] === `'`);
+      } else {
+        replacement = import_typescript.default.factory.createNoSubstitutionTemplateLiteral(migrateHtml(node.text));
+      }
+    } else {
+      const propertyName = import_typescript.default.factory.createIdentifier(DEPRECATED_CLASS_NAME);
+      const name = node.name;
+      replacement = import_typescript.default.isImportSpecifier(node) ? import_typescript.default.factory.updateImportSpecifier(node, node.isTypeOnly, propertyName, name) : import_typescript.default.factory.updateExportSpecifier(node, node.isTypeOnly, propertyName, name);
+    }
+    update.remove(node.getStart(), node.getWidth()).insertLeft(node.getStart(), printer.printNode(import_typescript.default.EmitHint.Unspecified, replacement, sourceFile));
+  }
+  tree.commitUpdate(update);
+}
+function findTypeScriptNodesToMigrate(sourceFile) {
+  const results = [];
+  sourceFile.forEachChild(function walk(node) {
+    var _a;
+    if (import_typescript.default.isStringLiteral(node) && node.text.includes("<" + TAG_NAME)) {
+      results.push(node);
+    } else if ((import_typescript.default.isImportDeclaration(node) || import_typescript.default.isExportDeclaration(node)) && node.moduleSpecifier && import_typescript.default.isStringLiteralLike(node.moduleSpecifier) && node.moduleSpecifier.text === MODULE_NAME) {
+      const bindings = import_typescript.default.isImportDeclaration(node) ? (_a = node.importClause) == null ? void 0 : _a.namedBindings : node.exportClause;
+      if (bindings && (import_typescript.default.isNamedImports(bindings) || import_typescript.default.isNamedExports(bindings))) {
+        bindings.elements.forEach((element) => {
+          const symbolName = element.propertyName || element.name;
+          if (import_typescript.default.isIdentifier(symbolName) && symbolName.text === CLASS_NAME) {
+            results.push(element);
+          }
+        });
+      }
+    } else {
+      node.forEachChild(walk);
+    }
+  });
+  return results.sort((a, b) => b.getStart() - a.getStart());
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  updateToV19
+});
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+//# sourceMappingURL=index_bundled.js.map

package/schematics/ng-update/index_bundled.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../src/google-maps/schematics/ng-update/index.ts"],
+  "sourcesContent": ["/**\n * @license\n * Copyright Google LLC All Rights Reserved.\n *\n * Use of this source code is governed by an MIT-style license that can be\n * found in the LICENSE file at https://angular.dev/license\n */\n\nimport {Path} from '@angular-devkit/core';\nimport {Rule, Tree} from '@angular-devkit/schematics';\nimport ts from 'typescript';\n\n/** Tag name of the clusterer component. */\nconst TAG_NAME = 'map-marker-clusterer';\n\n/** Module from which the clusterer is being imported. */\nconst MODULE_NAME = '@angular/google-maps';\n\n/** Old name of the clusterer class. */\nconst CLASS_NAME = 'MapMarkerClusterer';\n\n/** New name of the clusterer class. */\nconst DEPRECATED_CLASS_NAME = 'DeprecatedMapMarkerClusterer';\n\n/** Entry point for the migration schematics with target of Angular Material v19 */\nexport function updateToV19(): Rule {\n  return tree => {\n    tree.visit(path => {\n      if (path.endsWith('.html')) {\n        const content = tree.readText(path);\n\n        if (content.includes('<' + TAG_NAME)) {\n          tree.overwrite(path, migrateHtml(content));\n        }\n      } else if (path.endsWith('.ts') && !path.endsWith('.d.ts')) {\n        migrateTypeScript(path, tree);\n      }\n    });\n  };\n}\n\n/** Migrates an HTML template from the old tag name to the new one. */\nfunction migrateHtml(content: string): string {\n  return content\n    .replace(/<map-marker-clusterer/g, '<deprecated-map-marker-clusterer')\n    .replace(/<\\/map-marker-clusterer/g, '</deprecated-map-marker-clusterer');\n}\n\n/** Migrates a TypeScript file from the old tag and class names to the new ones. */\nfunction migrateTypeScript(path: Path, tree: Tree) {\n  const content = tree.readText(path);\n\n  // Exit early if none of the symbols we're looking for are mentioned.\n  if (\n    !content.includes('<' + TAG_NAME) &&\n    !content.includes(MODULE_NAME) &&\n    !content.includes(CLASS_NAME)\n  ) {\n    return;\n  }\n\n  const sourceFile = ts.createSourceFile(path, content, ts.ScriptTarget.Latest, true);\n  const toMigrate = findTypeScriptNodesToMigrate(sourceFile);\n\n  if (toMigrate.length === 0) {\n    return;\n  }\n\n  const printer = ts.createPrinter();\n  const update = tree.beginUpdate(path);\n\n  for (const node of toMigrate) {\n    let replacement: ts.Node;\n\n    if (ts.isStringLiteralLike(node)) {\n      // Strings should be migrated as if they're HTML.\n      if (ts.isStringLiteral(node)) {\n        replacement = ts.factory.createStringLiteral(\n          migrateHtml(node.text),\n          node.getText()[0] === `'`,\n        );\n      } else {\n        replacement = ts.factory.createNoSubstitutionTemplateLiteral(migrateHtml(node.text));\n      }\n    } else {\n      // Imports/exports should preserve the old name, but import the clusterer using the new one.\n      const propertyName = ts.factory.createIdentifier(DEPRECATED_CLASS_NAME);\n      const name = node.name as ts.Identifier;\n\n      replacement = ts.isImportSpecifier(node)\n        ? ts.factory.updateImportSpecifier(node, node.isTypeOnly, propertyName, name)\n        : ts.factory.updateExportSpecifier(node, node.isTypeOnly, propertyName, name);\n    }\n\n    update\n      .remove(node.getStart(), node.getWidth())\n      .insertLeft(\n        node.getStart(),\n        printer.printNode(ts.EmitHint.Unspecified, replacement, sourceFile),\n      );\n  }\n\n  tree.commitUpdate(update);\n}\n\n/** Finds the TypeScript nodes that need to be migrated from a specific file. */\nfunction findTypeScriptNodesToMigrate(sourceFile: ts.SourceFile) {\n  const results: (ts.StringLiteralLike | ts.ImportSpecifier | ts.ExportSpecifier)[] = [];\n\n  sourceFile.forEachChild(function walk(node) {\n    // Most likely a template using the clusterer.\n    if (ts.isStringLiteral(node) && node.text.includes('<' + TAG_NAME)) {\n      results.push(node);\n    } else if (\n      // Import/export referencing the clusterer.\n      (ts.isImportDeclaration(node) || ts.isExportDeclaration(node)) &&\n      node.moduleSpecifier &&\n      ts.isStringLiteralLike(node.moduleSpecifier) &&\n      node.moduleSpecifier.text === MODULE_NAME\n    ) {\n      const bindings = ts.isImportDeclaration(node)\n        ? node.importClause?.namedBindings\n        : node.exportClause;\n\n      if (bindings && (ts.isNamedImports(bindings) || ts.isNamedExports(bindings))) {\n        bindings.elements.forEach(element => {\n          const symbolName = element.propertyName || element.name;\n\n          if (ts.isIdentifier(symbolName) && symbolName.text === CLASS_NAME) {\n            results.push(element);\n          }\n        });\n      }\n    } else {\n      node.forEachChild(walk);\n    }\n  });\n\n  // Sort the results in reverse order to make applying the updates easier.\n  return results.sort((a, b) => b.getStart() - a.getStart());\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;AAUA,wBAAe;AAGf,IAAM,WAAW;AAGjB,IAAM,cAAc;AAGpB,IAAM,aAAa;AAGnB,IAAM,wBAAwB;AAGxB,SAAU,cAAW;AACzB,SAAO,UAAO;AACZ,SAAK,MAAM,UAAO;AAChB,UAAI,KAAK,SAAS,OAAO,GAAG;AAC1B,cAAM,UAAU,KAAK,SAAS,IAAI;AAElC,YAAI,QAAQ,SAAS,MAAM,QAAQ,GAAG;AACpC,eAAK,UAAU,MAAM,YAAY,OAAO,CAAC;QAC3C;MACF,WAAW,KAAK,SAAS,KAAK,KAAK,CAAC,KAAK,SAAS,OAAO,GAAG;AAC1D,0BAAkB,MAAM,IAAI;MAC9B;IACF,CAAC;EACH;AACF;AAGA,SAAS,YAAY,SAAe;AAClC,SAAO,QACJ,QAAQ,0BAA0B,kCAAkC,EACpE,QAAQ,4BAA4B,mCAAmC;AAC5E;AAGA,SAAS,kBAAkB,MAAY,MAAU;AAC/C,QAAM,UAAU,KAAK,SAAS,IAAI;AAGlC,MACE,CAAC,QAAQ,SAAS,MAAM,QAAQ,KAChC,CAAC,QAAQ,SAAS,WAAW,KAC7B,CAAC,QAAQ,SAAS,UAAU,GAC5B;AACA;EACF;AAEA,QAAM,aAAa,kBAAAA,QAAG,iBAAiB,MAAM,SAAS,kBAAAA,QAAG,aAAa,QAAQ,IAAI;AAClF,QAAM,YAAY,6BAA6B,UAAU;AAEzD,MAAI,UAAU,WAAW,GAAG;AAC1B;EACF;AAEA,QAAM,UAAU,kBAAAA,QAAG,cAAa;AAChC,QAAM,SAAS,KAAK,YAAY,IAAI;AAEpC,aAAW,QAAQ,WAAW;AAC5B,QAAI;AAEJ,QAAI,kBAAAA,QAAG,oBAAoB,IAAI,GAAG;AAEhC,UAAI,kBAAAA,QAAG,gBAAgB,IAAI,GAAG;AAC5B,sBAAc,kBAAAA,QAAG,QAAQ,oBACvB,YAAY,KAAK,IAAI,GACrB,KAAK,QAAO,EAAG,OAAO,GAAG;MAE7B,OAAO;AACL,sBAAc,kBAAAA,QAAG,QAAQ,oCAAoC,YAAY,KAAK,IAAI,CAAC;MACrF;IACF,OAAO;AAEL,YAAM,eAAe,kBAAAA,QAAG,QAAQ,iBAAiB,qBAAqB;AACtE,YAAM,OAAO,KAAK;AAElB,oBAAc,kBAAAA,QAAG,kBAAkB,IAAI,IACnC,kBAAAA,QAAG,QAAQ,sBAAsB,MAAM,KAAK,YAAY,cAAc,IAAI,IAC1E,kBAAAA,QAAG,QAAQ,sBAAsB,MAAM,KAAK,YAAY,cAAc,IAAI;IAChF;AAEA,WACG,OAAO,KAAK,SAAQ,GAAI,KAAK,SAAQ,CAAE,EACvC,WACC,KAAK,SAAQ,GACb,QAAQ,UAAU,kBAAAA,QAAG,SAAS,aAAa,aAAa,UAAU,CAAC;EAEzE;AAEA,OAAK,aAAa,MAAM;AAC1B;AAGA,SAAS,6BAA6B,YAAyB;AAC7D,QAAM,UAA8E,CAAA;AAEpF,aAAW,aAAa,SAAS,KAAK,MAAI;AA7G5C;AA+GI,QAAI,kBAAAA,QAAG,gBAAgB,IAAI,KAAK,KAAK,KAAK,SAAS,MAAM,QAAQ,GAAG;AAClE,cAAQ,KAAK,IAAI;IACnB,YAEG,kBAAAA,QAAG,oBAAoB,IAAI,KAAK,kBAAAA,QAAG,oBAAoB,IAAI,MAC5D,KAAK,mBACL,kBAAAA,QAAG,oBAAoB,KAAK,eAAe,KAC3C,KAAK,gBAAgB,SAAS,aAC9B;AACA,YAAM,WAAW,kBAAAA,QAAG,oBAAoB,IAAI,KACxC,UAAK,iBAAL,mBAAmB,gBACnB,KAAK;AAET,UAAI,aAAa,kBAAAA,QAAG,eAAe,QAAQ,KAAK,kBAAAA,QAAG,eAAe,QAAQ,IAAI;AAC5E,iBAAS,SAAS,QAAQ,aAAU;AAClC,gBAAM,aAAa,QAAQ,gBAAgB,QAAQ;AAEnD,cAAI,kBAAAA,QAAG,aAAa,UAAU,KAAK,WAAW,SAAS,YAAY;AACjE,oBAAQ,KAAK,OAAO;UACtB;QACF,CAAC;MACH;IACF,OAAO;AACL,WAAK,aAAa,IAAI;IACxB;EACF,CAAC;AAGD,SAAO,QAAQ,KAAK,CAAC,GAAG,MAAM,EAAE,SAAQ,IAAK,EAAE,SAAQ,CAAE;AAC3D;",
+  "names": ["ts"]
+}