chore(main): release 1.6.1

[github-actions]

🤖 I have created a release beep boop

1.6.1 (2026-10-14)

⚠ BREAKING CHANGES

• map: Introduction of map instance caching needed a change to the DOM-Structure produced by the map component (added a div-element owned by the Map component to contain the map instance).
• map: The type passed to the onProjectionChange is changed from MapCameraChangedEvent to MapEvent, so there are no longer camera-props available for this event
• removed the useStreetViewPanorama() and useDirectionsService() hooks.
• The behaviour of the props controlling camera parameters (center, zoom, heading and tilt) changed. Unless you are using controlled props, you have to change the prop names from e.g. center to defaultCenter (the same goes for zoom, heading and tilt).

Features

• add channel prop to APIProvider (#584) (6aa38e5)
• add 2d geometry components - circle, polyline and polygon (#917) (54b1d0e)
• add 3D map, marker and popover components (#898) (2ba09a1)
• add basic keyboard events for advanced marker (#1001) (af5ab1c)
• add example for drawing tools (#220) (75e91c4)
• add fetchAppCheckToken prop to APIProvider (#913) (992994d)
• add hover events and anchor points to advanced markers (#472) (cc4a397)
• add map-3d-route example with 3D Map and custom route element (v=alpha) (#989) (4adb9e1)
• add new onError prop for api provider (#541) (bbe5709)
• add new prop InfoWindow.shouldFocus (#254) (c83ea37)
• add solution-channel parameter (#334) (f93e43e)
• add StaticMap component with SSR support (#633) (55acea2)
• add TypeScript type definitions for Google Maps custom elements (#857) (a946a36)
• advanced-marker: add style prop to add styles to content-element (#337) (e942fb5)
• advanced-marker: add support for clickable option (#341) (ca96e54)
• api-loader: migrate to @googlemaps/js-api-loader (#885) (4af51dd)
• better handling for missing map configuration (#308) (b318d67)
• implement usage attribution (#844) (af36b8f)
• infowindow: add className and style props (92854c9)
• infowindow: add missing options and events (92854c9)
• infowindow: add new headerContent prop (#396) (0d40c81), closes #378
• infowindow: InfoWindow overhaul (#335) (92854c9)
• map-control: add className prop (#967) (37bfe46)
• map-control: add style prop (#1052) (5f88daa), closes #379
• map3d: refactor components to use custom elements (#765) (8b60a78)
• map: add padding option to defaultBounds (#392) (9dc65dc)
• map: implement initial version of map-instance caching (#349) (4a6e83a)
• new 3d components (#1009) (69bf2f7)
• pin: split Pin component into modern and legacy implementations (#945) (4826836)
• restore map state when changing mapId (#213) (0db363f)
• update eslint-plugin-react-hooks (#851) (6ebe344)
• updated AdvancedMarker anchoring implementation (#841) (d7b128e)

Bug Fixes

• add explicit type for exported function components (#611) (a5b0359), closes #583
• add support Next.js 15 (#609) (0e673c2)
• adjust advanced marker markup to fix anchoring & collision behavior (#577) (97a98b2)
• advanced-marker: apply marker class when rendering a Pin (#384) (e8a4cc3)
• advanced-marker: remove content element in cleanup (#351) (128df87)
• allow negative anchor values for AdvancedMarker (#695) (d2de370)
• api-loader didn't call callback on repeat load calls (743878a)
• avoid unnecessary state-updates in api-provider (#551) (46068c9)
• better handling for clickable prop in AdvancedMarker (#906) (c8ff82f)
• build: don't build examples with library build (1b43288)
• build: share one ESM module graph across the root, /server and /3d entries (#1075) (39569cf)
• custom-element-types: update type definitions for boolean values (8db4ad0)
• deps-dev: bump react, react-dom and corresponding types (#650) (02fe28f)
• docs: use correct spelling of JavaScript (#312) (f38d3c4)
• ensure proper type inference of APILoadingStatus (#747) (2c59d59)
• export api-loading-status types (#231) (9695034), closes #230
• geometry: only send changed options to the maps api (#1061) (bbfc6e9), closes #524
• guard against invalid camera values in map events (#1023) (b487463)
• handle externally-loaded importLibrary in loader (#1002) (f76ed12)
• hooks: add fallback to useLayoutEffect for React 16/17 compatibility (#950) (86ad8ee)
• hooks: add SafeReact and fallback for useInsertionEffect to ensure compatibility with React 16/17 (#1017) (1a503a8), closes #957
• hooks: avoid static useInsertionEffect imports (#960) (f2870c1)
• improve types ColorScheme and RenderingType (#675) (785927a)
• info-window: fix reappearing InfoWindows (#393) (dc51eb9)
• InfoWindow.shouldFocus doesn't work with false as value (#278) (2f4b508)
• infowindow: add missing cleanup for infowindow (92854c9)
• infowindow: better dependency checks, using useDeepCompareEffect where needed (92854c9)
• infowindow: removed unneeded dependency in infowindow hooks (92854c9)
• infowindow: replace useDeepCompareEffect with useEffect (#786) (1b25e80)
• introduce useEffectEvent to improve stability of event handlers (#866) (e44933e)
• map controls crashing when invalid key is provided (#290) (5052dfb)
• map: add support for new and missing mapOptions (#501) (f22af50)
• map: change event-type of projectionChanged event to MapEvent (#346) (83f9309)
• map: don't crash when remounting with a broken cached map instance (#984) (31a5261), closes #982
• map: improve reuseMaps reliability after remounting (#920) (e9296de)
• map: remove @ts-expect-error after @types/google.maps update (deb2bc7)
• map: set container position to relative (#356) (7fa2b71)
• map: set other container position to relative (#357) (8e77d70)
• map: undefined rendering-type and color-scheme (#515) (c288d15)
• memoize context-values to avoid excessive re-renders (#287) (bea68f9), closes #285
• more efficient useMemoized hook and fixed infowindow issues (#903) (8cb7151)
• move vite back to devDependencies (#955) (d3535ac)
• omit map prop from markers (#305) (8a38acf)
• prevent api provider race condition, defer loading state update (#970) (7fd6efe)
• prevent passing empty parameters to ApiLoader (#193) (0601753)
• remove deep-link into fast-deep-equal package (#208) (f0be380)
• remove explicit types for components using forwardRef (#620) (8448a33), closes #619 #617
• skip writing props the consumer never provided (#1074) (8775224)
• static-maps: remove path grouping by style (#809) (d1f499e)
• support ROADMAP and make it the default Map3D mode (#1094) (196f65b)
• trigger release-please action (0eaabeb)
• types: add new PinElement and PinElementOptions types to augmentations (3751d0d)
• types: add types-reference to google.maps (#520) (ed19636), closes #519
• types: inline PlaceContextualElementOptions in types for 'gmp-place-contextual' (0626be2)
• Update calc clusters to happen after Idle event - reduces issue 563 (#806) (bed6ccd)
• update dependencies and update importLibrary typings (#1019) (ef951c4)
• update gmp types (#973) (2f5c29c)
• update useMapsLibrary hook to include maps3d (bd218bb)
• use correct pointer events behaviour (#997) (538e918)
• use deep compare effect to prevent infowindow close (#642) (bfa85c1)
• use latest reuseMaps value in map instance cleanup (#1042) (20a535f)
• use parameter v instead of version (0626fb6)

Miscellaneous Chores

• add tslib as devDependency (#854) (fe42240)
• tag 1.0.0 release (afb67a7)

Code Refactoring

• improved state-handling implementation (#181) (904b918)
• remove obsolete hooks (#219) (69b2373)

---

This PR was generated with Release Please. See documentation.