@nuxt/scripts 1.0.0-rc.5 → 1.0.0-rc.6

package/dist/runtime/components/GoogleMaps/ScriptGoogleMaps.vue

@@ -1,18 +1,16 @@
 <script>
+export { MAP_INJECTION_KEY } from "./useGoogleMapsResource";
+</script>
+
+<script setup>
 import { useScriptTriggerElement } from "#nuxt-scripts/composables/useScriptTriggerElement";
 import { useScriptGoogleMaps } from "#nuxt-scripts/registry/google-maps";
 import { scriptRuntimeConfig, scriptsPrefix } from "#nuxt-scripts/utils";
 import { defu } from "defu";
 import { tryUseNuxtApp, useHead, useRuntimeConfig } from "nuxt/app";
-import { computed, onBeforeUnmount, onMounted, provide, ref, shallowRef, toRaw, useAttrs, watch } from "vue";
+import { computed, onBeforeUnmount, onMounted, provide, ref, shallowRef, toRaw, useAttrs, useTemplateRef, watch } from "vue";
 import ScriptAriaLoadingIndicator from "../ScriptAriaLoadingIndicator.vue";
-import { MAP_INJECTION_KEY } from "./useGoogleMapsResource";
-const DIGITS_ONLY_RE = /^\d+$/;
-const DIGITS_PX_RE = /^\d+px$/i;
-export { MAP_INJECTION_KEY } from "./useGoogleMapsResource";
-</script>
-
-<script setup>
+import { defineDeprecatedAlias, MAP_INJECTION_KEY, waitForMapsReady, warnDeprecatedTopLevelMapProps } from "./useGoogleMapsResource";
 const props = defineProps({
   trigger: { type: [String, Array, Boolean], required: false, default: ["mouseenter", "mouseover", "mousedown"] },
   apiKey: { type: String, required: false },
@@ -30,23 +28,21 @@ const props = defineProps({
 });
 const emits = defineEmits(["ready", "error"]);
 defineSlots();
+const DIGITS_ONLY_RE = /^\d+$/;
+const DIGITS_PX_RE = /^\d+px$/i;
 const apiKey = props.apiKey || scriptRuntimeConfig("googleMaps")?.apiKey;
 const runtimeConfig = useRuntimeConfig();
-const nuxtApp = tryUseNuxtApp();
-const nuxtColorMode = nuxtApp?.$colorMode;
-const currentColorMode = computed(() => {
-  if (props.colorMode)
-    return props.colorMode;
-  if (nuxtColorMode?.value)
-    return nuxtColorMode.value === "dark" ? "dark" : "light";
-  return "light";
+const nuxtColorMode = computed(() => {
+  const value = tryUseNuxtApp()?.$colorMode?.value;
+  return value === "dark" || value === "light" ? value : void 0;
 });
+const currentColorMode = computed(() => props.colorMode || nuxtColorMode.value || "light");
 const currentMapId = computed(() => {
   if (!props.mapIds)
     return props.mapOptions?.mapId;
   return props.mapIds[currentColorMode.value] || props.mapIds.light || props.mapOptions?.mapId;
 });
-const mapsApi = ref();
+const mapsApi = shallowRef();
 if (import.meta.dev) {
   if (!apiKey)
     throw new Error("GoogleMaps requires an API key. Enable it in your nuxt.config:\n\n  scripts: {\n    registry: {\n      googleMaps: true\n    }\n  }\n\nThen set NUXT_PUBLIC_SCRIPTS_GOOGLE_MAPS_API_KEY in your .env file.\n\nAlternatively, pass `api-key` directly on the <ScriptGoogleMaps> component (note: this exposes the key client-side).");
@@ -62,9 +58,10 @@ if (import.meta.dev) {
     if (prop in attrs)
       console.warn(`[nuxt-scripts] <ScriptGoogleMaps> prop "${prop}" was removed in v1. ${message} See https://scripts.nuxt.com/docs/migration-guide/v0-to-v1`);
   }
+  warnDeprecatedTopLevelMapProps({ center: props.center, zoom: props.zoom });
 }
-const rootEl = ref();
-const mapEl = ref();
+const rootEl = useTemplateRef("rootEl");
+const mapEl = useTemplateRef("mapEl");
 const centerOverride = ref();
 const trigger = useScriptTriggerElement({ trigger: props.trigger, el: rootEl });
 const { load, status, onLoaded } = useScriptGoogleMaps({
@@ -78,12 +75,14 @@ const { load, status, onLoaded } = useScriptGoogleMaps({
 });
 const options = computed(() => {
   const mapId = props.mapOptions?.styles ? void 0 : currentMapId.value || "map";
-  return defu({ center: centerOverride.value, mapId, zoom: props.zoom }, props.mapOptions, {
-    center: props.center,
-    zoom: 15
-  });
+  return defu(
+    { center: centerOverride.value, mapId },
+    props.mapOptions,
+    { center: props.center, zoom: props.zoom },
+    { zoom: 15 }
+  );
 });
-const ready = ref(false);
+const isMapReady = ref(false);
 const map = shallowRef();
 function isLocationQuery(s) {
   return typeof s === "string" && (s.split(",").length > 2 || s.includes("+"));
@@ -108,29 +107,25 @@ async function resolveQueryToLatLng(query) {
     }
     throw new Error(`No location found for ${query}`);
   }
-  return new Promise(async (resolve, reject) => {
-    if (!mapsApi.value) {
-      await load();
-      await new Promise((resolve2) => {
-        const _ = watch(mapsApi, () => {
-          _();
-          resolve2();
-        });
-      });
-    }
-    const placesService = new mapsApi.value.places.PlacesService(map.value);
-    placesService.findPlaceFromQuery({
-      query,
-      fields: ["name", "geometry"]
-    }, (results, status2) => {
-      if (status2 === "OK" && results?.[0]?.geometry?.location)
-        return resolve(results[0].geometry.location);
-      return reject(new Error(`No location found for ${query}`));
-    });
-  }).then((res) => {
-    queryToLatLngCache.set(query, res);
-    return res;
+  await waitForMapsReady({ mapsApi, map, status, load });
+  const placesService = new mapsApi.value.places.PlacesService(map.value);
+  const result = await new Promise((resolve, reject) => {
+    placesService.findPlaceFromQuery(
+      {
+        query,
+        fields: ["name", "geometry"]
+      },
+      (results, status2) => {
+        if (status2 === "OK" && results?.[0]?.geometry?.location) {
+          resolve(results[0].geometry.location);
+        } else {
+          reject(new Error(`No location found for ${query}`));
+        }
+      }
+    );
   });
+  queryToLatLngCache.set(query, result);
+  return result;
 }
 const libraries = /* @__PURE__ */ new Map();
 function importLibrary(key) {
@@ -152,13 +147,25 @@ function importLibrary(key) {
   libraries.set(key, cached);
   return cached;
 }
-const googleMaps = {
+const exposed = {
+  mapsApi,
+  // Plain alias for production. In dev, replaced below with a getter that
+  // emits a one-shot deprecation warning. Both forms return the same
+  // shallow ref as `mapsApi`.
   googleMaps: mapsApi,
   map,
   resolveQueryToLatLng,
   importLibrary
 };
-defineExpose(googleMaps);
+if (import.meta.dev) {
+  defineDeprecatedAlias(
+    exposed,
+    "googleMaps",
+    "mapsApi",
+    '[nuxt-scripts] <ScriptGoogleMaps> expose key "googleMaps" is deprecated; use "mapsApi" instead. See https://scripts.nuxt.com/docs/migration-guide/v0-to-v1'
+  );
+}
+defineExpose(exposed);
 let activeInfoWindow;
 provide(MAP_INJECTION_KEY, {
   map,
@@ -171,9 +178,9 @@ provide(MAP_INJECTION_KEY, {
   }
 });
 onMounted(() => {
-  watch(ready, (v) => {
+  watch(isMapReady, (v) => {
     if (v) {
-      emits("ready", googleMaps);
+      emits("ready", exposed);
     }
   });
   watch(status, (v) => {
@@ -191,13 +198,13 @@ onMounted(() => {
     if (map.value && zoom != null)
       map.value.setZoom(zoom);
   });
-  watch([() => options.value.center, ready, map], async (next) => {
+  watch([() => options.value.center, isMapReady, map], async (next) => {
     if (!map.value) {
       return;
     }
     let center = toRaw(next[0]);
     if (center) {
-      if (isLocationQuery(center) && ready.value) {
+      if (isLocationQuery(center) && isMapReady.value) {
         center = await resolveQueryToLatLng(center);
       }
       const current = map.value.getCenter();
@@ -223,9 +230,10 @@ onMounted(() => {
     map.value = new mapsApi.value.Map(mapEl.value, _options);
     if (center && isLocationQuery(center)) {
       centerOverride.value = await resolveQueryToLatLng(center);
-      map.value?.setCenter(centerOverride.value);
+      if (centerOverride.value)
+        map.value?.setCenter(centerOverride.value);
     }
-    ready.value = true;
+    isMapReady.value = true;
   });
 });
 if (import.meta.server) {
@@ -280,9 +288,9 @@ onBeforeUnmount(() => {
 
 <template>
   <div ref="rootEl" v-bind="rootAttrs">
-    <div v-show="ready" ref="mapEl" :style="{ width: '100%', height: '100%', maxWidth: '100%' }" />
-    <slot v-if="!ready" name="placeholder" />
-    <slot v-if="status !== 'awaitingLoad' && !ready" name="loading">
+    <div v-show="isMapReady" ref="mapEl" :style="{ width: '100%', height: '100%', maxWidth: '100%' }" />
+    <slot v-if="!isMapReady" name="placeholder" />
+    <slot v-if="status !== 'awaitingLoad' && !isMapReady" name="loading">
       <ScriptAriaLoadingIndicator />
     </slot>
     <slot v-if="status === 'awaitingLoad'" name="awaitingLoad" />

package/dist/runtime/components/GoogleMaps/ScriptGoogleMaps.vue.d.ts

@@ -1,11 +1,10 @@
 import type { ElementScriptTrigger } from '#nuxt-scripts/types';
 import type { HTMLAttributes, ReservedProps, ShallowRef } from 'vue';
 export { MAP_INJECTION_KEY } from './useGoogleMapsResource.js';
-declare const _default: typeof __VLS_export;
-export default _default;
-declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
+export interface ScriptGoogleMapsProps {
     /**
      * Defines the trigger event to load the script.
+     * @default ['mouseenter', 'mouseover', 'mousedown']
      */
     trigger?: ElementScriptTrigger;
     /**
@@ -14,11 +13,20 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     apiKey?: string;
     /**
      * A latitude / longitude of where to focus the map.
+     *
+     * @deprecated Pass `center` via `mapOptions` instead. The top-level `center`
+     * prop will be removed in a future major version. When both are set,
+     * `mapOptions.center` wins.
+     * @see https://scripts.nuxt.com/docs/migration-guide/v0-to-v1
      */
     center?: google.maps.LatLng | google.maps.LatLngLiteral | `${string},${string}`;
     /**
      * Zoom level for the map (0-21). Reactive: changing this will update the map.
-     * Takes precedence over mapOptions.zoom when provided.
+     *
+     * @deprecated Pass `zoom` via `mapOptions` instead. The top-level `zoom`
+     * prop will be removed in a future major version. When both are set,
+     * `mapOptions.zoom` wins.
+     * @see https://scripts.nuxt.com/docs/migration-guide/v0-to-v1
      */
     zoom?: number;
     /**
@@ -30,19 +38,21 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
      */
     region?: string;
     /**
-     * Defines the language of the map
+     * Defines the language of the map.
      */
     language?: string;
     /**
-     * Defines the version of google maps js API
+     * Defines the version of google maps js API.
      */
     version?: string;
     /**
      * Defines the width of the map.
+     * @default 640
      */
     width?: number | string;
     /**
-     * Defines the height of the map
+     * Defines the height of the map.
+     * @default 400
      */
     height?: number | string;
     /**
@@ -60,122 +70,92 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     };
     /**
      * Manual color mode control. When provided, overrides auto-detection from @nuxtjs/color-mode.
-     * Accepts 'light', 'dark', or a reactive ref.
-     */
-    colorMode?: "light" | "dark";
-}, {
-    readonly googleMaps: import("vue").Ref<typeof google.maps | undefined, typeof google.maps | undefined>;
-    readonly map: ShallowRef<google.maps.Map | undefined>;
-    readonly resolveQueryToLatLng: (query: string) => Promise<google.maps.LatLng | google.maps.LatLngLiteral | undefined>;
-    readonly importLibrary: {
-        (key: "marker"): Promise<google.maps.MarkerLibrary>;
-        (key: "places"): Promise<google.maps.PlacesLibrary>;
-        (key: "geometry"): Promise<google.maps.GeometryLibrary>;
-        (key: "drawing"): Promise<google.maps.DrawingLibrary>;
-        (key: "visualization"): Promise<google.maps.VisualizationLibrary>;
-        (key: string): Promise<any>;
-    };
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    error: () => any;
-    ready: (e: {
-        readonly googleMaps: import("vue").Ref<typeof google.maps | undefined, typeof google.maps | undefined>;
-        readonly map: ShallowRef<google.maps.Map | undefined>;
-        readonly resolveQueryToLatLng: (query: string) => Promise<google.maps.LatLng | google.maps.LatLngLiteral | undefined>;
-        readonly importLibrary: {
-            (key: "marker"): Promise<google.maps.MarkerLibrary>;
-            (key: "places"): Promise<google.maps.PlacesLibrary>;
-            (key: "geometry"): Promise<google.maps.GeometryLibrary>;
-            (key: "drawing"): Promise<google.maps.DrawingLibrary>;
-            (key: "visualization"): Promise<google.maps.VisualizationLibrary>;
-            (key: string): Promise<any>;
-        };
-    }) => any;
-}, string, import("vue").PublicProps, Readonly<{
-    /**
-     * Defines the trigger event to load the script.
+     * Accepts 'light' or 'dark'.
      */
-    trigger?: ElementScriptTrigger;
+    colorMode?: 'light' | 'dark';
+}
+export interface ScriptGoogleMapsExpose {
     /**
-     * Defines the Google Maps API key. Must have access to the Static Maps API as well.
+     * A reference to the loaded Google Maps API namespace (`google.maps`), or
+     * `undefined` if not yet loaded.
      */
-    apiKey?: string;
+    mapsApi: ShallowRef<typeof google.maps | undefined>;
     /**
-     * A latitude / longitude of where to focus the map.
+     * A reference to the loaded Google Maps API namespace, or `undefined` if not
+     * yet loaded.
+     *
+     * @deprecated Use `mapsApi` instead. The `googleMaps` alias will be removed
+     * in a future major version.
+     * @see https://scripts.nuxt.com/docs/migration-guide/v0-to-v1
      */
-    center?: google.maps.LatLng | google.maps.LatLngLiteral | `${string},${string}`;
+    googleMaps: ShallowRef<typeof google.maps | undefined>;
     /**
-     * Zoom level for the map (0-21). Reactive: changing this will update the map.
-     * Takes precedence over mapOptions.zoom when provided.
+     * A reference to the Google Map instance, or `undefined` if not yet initialized.
      */
-    zoom?: number;
+    map: ShallowRef<google.maps.Map | undefined>;
     /**
-     * Options for the map.
+     * Utility function to resolve a location query (e.g. "New York, NY") to latitude/longitude coordinates.
+     * Uses a caching mechanism and a server-side proxy to avoid unnecessary client-side API calls.
      */
-    mapOptions?: google.maps.MapOptions;
+    resolveQueryToLatLng: (query: string) => Promise<google.maps.LatLng | google.maps.LatLngLiteral | undefined>;
     /**
-     * Defines the region of the map.
+     * Utility function to dynamically import additional Google Maps libraries (e.g. "marker", "places").
+     * Caches imported libraries for efficient reuse.
      */
-    region?: string;
+    importLibrary: {
+        (key: 'marker'): Promise<google.maps.MarkerLibrary>;
+        (key: 'places'): Promise<google.maps.PlacesLibrary>;
+        (key: 'geometry'): Promise<google.maps.GeometryLibrary>;
+        (key: 'drawing'): Promise<google.maps.DrawingLibrary>;
+        (key: 'visualization'): Promise<google.maps.VisualizationLibrary>;
+        (key: string): Promise<any>;
+    };
+}
+export interface ScriptGoogleMapsEmits {
     /**
-     * Defines the language of the map
+     * Fired when the Google Maps instance is fully loaded and ready to use. Provides access to the maps API.
      */
-    language?: string;
+    ready: [payload: ScriptGoogleMapsExpose];
     /**
-     * Defines the version of google maps js API
+     * Fired when the Google Maps script fails to load.
      */
-    version?: string;
+    error: [];
+}
+export interface ScriptGoogleMapsSlots {
     /**
-     * Defines the width of the map.
+     * Default slot for rendering child components (e.g. markers, info windows) that depend on the map being ready.
      */
-    width?: number | string;
+    default?: () => any;
     /**
-     * Defines the height of the map
+     * Slot displayed while the map is loading. Can be used to show a custom loading indicator.
      */
-    height?: number | string;
+    loading?: () => any;
     /**
-     * Customize the root element attributes.
+     * Slot displayed when the script is awaiting user interaction to load (based on the `trigger` prop).
      */
-    rootAttrs?: HTMLAttributes & ReservedProps & Record<string, unknown>;
+    awaitingLoad?: () => any;
     /**
-     * Map IDs for light and dark color modes.
-     * When provided, the map will automatically switch styles based on color mode.
-     * Requires @nuxtjs/color-mode or manual colorMode prop.
+     * Slot displayed if the script fails to load.
      */
-    mapIds?: {
-        light?: string;
-        dark?: string;
-    };
+    error?: () => any;
     /**
-     * Manual color mode control. When provided, overrides auto-detection from @nuxtjs/color-mode.
-     * Accepts 'light', 'dark', or a reactive ref.
+     * Slot displayed as a placeholder before the map is ready. Useful for showing a static map or skeleton.
      */
-    colorMode?: "light" | "dark";
-}> & Readonly<{
+    placeholder?: () => any;
+}
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<ScriptGoogleMapsProps, ScriptGoogleMapsExpose, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    error: () => any;
+    ready: (payload: ScriptGoogleMapsExpose) => any;
+}, string, import("vue").PublicProps, Readonly<ScriptGoogleMapsProps> & Readonly<{
     onError?: (() => any) | undefined;
-    onReady?: ((e: {
-        readonly googleMaps: import("vue").Ref<typeof google.maps | undefined, typeof google.maps | undefined>;
-        readonly map: ShallowRef<google.maps.Map | undefined>;
-        readonly resolveQueryToLatLng: (query: string) => Promise<google.maps.LatLng | google.maps.LatLngLiteral | undefined>;
-        readonly importLibrary: {
-            (key: "marker"): Promise<google.maps.MarkerLibrary>;
-            (key: "places"): Promise<google.maps.PlacesLibrary>;
-            (key: "geometry"): Promise<google.maps.GeometryLibrary>;
-            (key: "drawing"): Promise<google.maps.DrawingLibrary>;
-            (key: "visualization"): Promise<google.maps.VisualizationLibrary>;
-            (key: string): Promise<any>;
-        };
-    }) => any) | undefined;
+    onReady?: ((payload: ScriptGoogleMapsExpose) => any) | undefined;
 }>, {
     trigger: ElementScriptTrigger;
     width: number | string;
     height: number | string;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
-    default?: () => any;
-    placeholder?: () => any;
-    loading?: () => any;
-    awaitingLoad?: () => any;
-    error?: () => any;
-}>;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, ScriptGoogleMapsSlots>;
 type __VLS_WithSlots<T, S> = T & {
     new (): {
         $slots: S;

package/dist/runtime/components/GoogleMaps/ScriptGoogleMapsOverlayView.d.vue.ts

@@ -1,16 +1,29 @@
-type OverlayAnchor = 'center' | 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' | 'left-center' | 'right-center';
-type OverlayPane = 'mapPane' | 'overlayLayer' | 'markerLayer' | 'overlayMouseTarget' | 'floatPane';
-type __VLS_Props = {
+import type { ShallowRef } from 'vue';
+export type ScriptGoogleMapsOverlayAnchor = 'center' | 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right' | 'left-center' | 'right-center';
+export type ScriptGoogleMapsOverlayPane = 'mapPane' | 'overlayLayer' | 'markerLayer' | 'overlayMouseTarget' | 'floatPane';
+export interface ScriptGoogleMapsOverlayViewProps {
     /**
      * Geographic position for the overlay. Falls back to parent marker position if omitted.
+     *
+     * Accepts either a plain `LatLngLiteral` (`{ lat, lng }`) or a
+     * `google.maps.LatLng` instance.
      * @see https://developers.google.com/maps/documentation/javascript/reference/overlay-view#OverlayView
      */
-    position?: google.maps.LatLngLiteral;
+    position?: google.maps.LatLng | google.maps.LatLngLiteral;
+    /**
+     * Initial open state for the uncontrolled mode (when `v-model:open` is not
+     * bound). When omitted, the overlay opens on mount, matching v0 behaviour.
+     *
+     * Has no effect when `v-model:open` is used; pass an initial value to the
+     * bound ref instead.
+     * @default true
+     */
+    defaultOpen?: boolean;
     /**
      * Anchor point of the overlay relative to its position.
      * @default 'bottom-center'
      */
-    anchor?: OverlayAnchor;
+    anchor?: ScriptGoogleMapsOverlayAnchor;
     /**
      * Pixel offset from the anchor position.
      */
@@ -23,7 +36,7 @@ type __VLS_Props = {
      * @default 'floatPane'
      * @see https://developers.google.com/maps/documentation/javascript/reference/overlay-view#MapPanes
      */
-    pane?: OverlayPane;
+    pane?: ScriptGoogleMapsOverlayPane;
     /**
      * CSS z-index for the overlay element.
      */
@@ -45,31 +58,39 @@ type __VLS_Props = {
      * @default true
      */
     hideWhenClustered?: boolean;
-};
-type __VLS_Slots = {
+}
+export interface ScriptGoogleMapsOverlayViewEmits {
+    /** Event handler called when the open state of the overlay view changes. */
+    'update:open': [value: boolean];
+}
+export interface ScriptGoogleMapsOverlayViewSlots {
     default?: () => any;
-};
-type __VLS_ModelProps = {
-    'open'?: boolean;
-};
-type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
-    overlay: import("vue").ShallowRef<google.maps.OverlayView | undefined>;
-    dataState: import("vue").ComputedRef<"open" | "closed">;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:open": (value: boolean) => any;
-}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-    "onUpdate:open"?: ((value: boolean) => any) | undefined;
-}>, {
-    anchor: OverlayAnchor;
-    pane: OverlayPane;
-    blockMapInteraction: boolean;
-    panOnOpen: boolean | number;
-    hideWhenClustered: boolean;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+}
+export interface ScriptGoogleMapsOverlayViewExpose {
+    /** The underlying `OverlayView` instance. */
+    overlayView: ShallowRef<google.maps.OverlayView | undefined>;
+    /**
+     * The underlying `OverlayView` instance.
+     *
+     * @deprecated Use `overlayView` instead. The `overlay` alias will be
+     * removed in a future major version.
+     * @see https://scripts.nuxt.com/docs/migration-guide/v0-to-v1
+     */
+    overlay: ShallowRef<google.maps.OverlayView | undefined>;
+    /** The current data-state of the overlay, either 'open' or 'closed'. */
+    dataState: Readonly<ShallowRef<'open' | 'closed'>>;
+}
 declare const _default: typeof __VLS_export;
 export default _default;
+declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<ScriptGoogleMapsOverlayViewProps & {
+    open?: boolean;
+}, ScriptGoogleMapsOverlayViewExpose, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:open": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<ScriptGoogleMapsOverlayViewProps & {
+    open?: boolean;
+}> & Readonly<{
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, ScriptGoogleMapsOverlayViewSlots>;
 type __VLS_WithSlots<T, S> = T & {
     new (): {
         $slots: S;