googlemaps-kit 0.4.0 → 0.6.0

package/dist/types/grid-search.d.ts

@@ -0,0 +1,66 @@
+import type { SearchClientFilters } from './search-filters.js';
+import type { SearchFieldMask, SearchMode, SearchResult } from './common.js';
+/**
+ * Bounding box for area searches, in decimal degrees.
+ * Spelling matches the rest of the SDK (`north/south/east/west`).
+ */
+export interface GridSearchBounds {
+    north: number;
+    south: number;
+    east: number;
+    west: number;
+}
+export interface GridSearchOptions {
+    /** Query run in every cell, e.g. "cafes". */
+    query: string;
+    /** Area to cover. Larger areas at a given `cellZoom` mean more cells. */
+    bounds: GridSearchBounds;
+    /**
+     * Web Mercator zoom used to subdivide the area into cells — each cell is
+     * one anonymous search request. `14` ≈ city districts, `15` ≈ ~2 km cells,
+     * `16` ≈ neighbourhoods, `17` ≈ blocks. Defaults to `15`.
+     */
+    cellZoom?: number;
+    /** Stop once this many unique results are collected. */
+    maxResults?: number;
+    /** Safety cap on cells searched. Defaults to all cells covered by the bounds. */
+    maxCells?: number;
+    /** Results requested per cell per page (search `limit`). */
+    limit?: number;
+    /** Pagination pages fetched per cell (default 1). */
+    pagesPerCell?: number;
+    mode?: SearchMode;
+    fieldMask?: SearchFieldMask;
+    filters?: SearchClientFilters;
+    /**
+     * Progress callback fired after each cell with the cell's tile coordinates
+     * and how many new unique results it contributed.
+     */
+    onProgress?: (progress: GridSearchProgress) => void;
+}
+/** Progress snapshot fired once per searched cell. */
+export interface GridSearchProgress {
+    /** 1-based index of the cell just completed. */
+    cell: number;
+    totalCells: number;
+    /** Web Mercator tile coordinates of the cell. */
+    x: number;
+    y: number;
+    /** New unique results contributed by this cell. */
+    foundInCell: number;
+    /** Running total of unique results so far. */
+    uniqueResults: number;
+}
+export interface GridSearchResult {
+    results: SearchResult[];
+    /** Alias of {@link GridSearchResult.results}. */
+    places: SearchResult[];
+    /** Cells actually searched (may be capped by `maxCells` / `maxResults`). */
+    cellsSearched: number;
+    /** Total cells implied by the bounds at `cellZoom`. */
+    cellsTotal: number;
+    /** HTTP requests issued including pagination. */
+    requestsMade: number;
+    cellZoom: number;
+}
+//# sourceMappingURL=grid-search.d.ts.map

package/dist/types/grid-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-search.d.ts","sourceRoot":"","sources":["../../src/types/grid-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE7E;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,MAAM,EAAE,gBAAgB,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACrD;AAED,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,iDAAiD;IACjD,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/grid-search.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=grid-search.js.map

package/dist/types/grid-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-search.js","sourceRoot":"","sources":["../../src/types/grid-search.ts"],"names":[],"mappings":""}

package/dist/types/hooks.d.ts

@@ -3,19 +3,19 @@
  */
 export type HookActionType = 'discover' | 'discoverPages' | 'resolve' | 'profile' | 'profileMany' | 'route' | 'opinions' | 'opinionsPages' | 'media' | 'mediaMany' | 'pipeline' | 'http.get' | 'http.getBytes' | 'batchexecute';
 export interface HookActionEvent {
-    type: HookActionType | string;
+    type: HookActionType;
     status: 'ok' | 'error';
     durationMs: number;
     error?: unknown;
 }
 export interface HookRetryEvent {
-    type: HookActionType | string;
+    type: HookActionType;
     attempt: number;
     delayMs?: number;
     error?: unknown;
 }
 export interface HookErrorEvent {
-    type: HookActionType | string;
+    type: HookActionType;
     error: unknown;
 }
 /** Wire once on `sdk({ hooks })` — fire-and-forget, never blocks the call. */

package/dist/types/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,eAAe,GACf,SAAS,GACT,SAAS,GACT,aAAa,GACb,OAAO,GACP,UAAU,GACV,eAAe,GACf,OAAO,GACP,WAAW,GACX,UAAU,GACV,UAAU,GACV,eAAe,GACf,cAAc,CAAC;AAEnB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC;IAC9B,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAE9D,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,eAAe,GACf,SAAS,GACT,SAAS,GACT,aAAa,GACb,OAAO,GACP,UAAU,GACV,eAAe,GACf,OAAO,GACP,WAAW,GACX,UAAU,GACV,UAAU,GACV,eAAe,GACf,cAAc,CAAC;AAEnB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAE9D,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/links.d.ts

@@ -1,9 +1,6 @@
-import type { TravelMode } from './common.js';
-/** Shared coordinate pair extracted from Maps URLs. */
-export interface MapsCoordinates {
-    lat: number;
-    lng: number;
-}
+import type { Coordinates, TravelMode } from './common.js';
+/** Shared coordinate pair extracted from Maps URLs. Alias of {@link Coordinates}. */
+export type MapsCoordinates = Coordinates;
 /** Base fields present on every successfully classified parse result. */
 interface ParsedMapsUrlBase {
     /** Normalized input URL (may differ from raw input after normalization). */

package/dist/types/links.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/types/links.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,yEAAyE;AACzE,UAAU,iBAAiB;IACzB,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC;CACb;AAED,6EAA6E;AAC7E,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACvD,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,8CAA8C;AAC9C,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wEAAwE;AACxE,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,6DAA6D;AAC7D,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2FAA2F;AAC3F,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACrD,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,+EAA+E;AAC/E,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,GAAG,QAAQ,CAAC;CACpC;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,eAAe,GACf,mBAAmB,GACnB,iBAAiB,GACjB,aAAa,GACb,YAAY,GACZ,kBAAkB,GAClB,gBAAgB,CAAC"}
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/types/links.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D,qFAAqF;AACrF,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC;AAE1C,yEAAyE;AACzE,UAAU,iBAAiB;IACzB,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC;CACb;AAED,6EAA6E;AAC7E,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACvD,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,8CAA8C;AAC9C,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wEAAwE;AACxE,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,6DAA6D;AAC7D,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2FAA2F;AAC3F,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACrD,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,+EAA+E;AAC/E,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,GAAG,QAAQ,CAAC;CACpC;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,eAAe,GACf,mBAAmB,GACnB,iBAAiB,GACjB,aAAa,GACb,YAAY,GACZ,kBAAkB,GAClB,gBAAgB,CAAC"}

package/dist/types/lists.d.ts

@@ -16,20 +16,61 @@ export interface PlaceListEntry {
     name: string;
     /** Curator comment — unique to list entries. */
     note?: string;
+    /**
+     * Full formatted address string from addressBlock[2].
+     * May include the place name as a prefix (e.g. "Marcy Land Omotesando Ramen Bar, 屋台 ...").
+     */
     address?: string;
+    /**
+     * @deprecated No longer populated — addressBlock[4] is a country-first reverse geocode
+     * string ("Japan, 〒..."), not a street-level line. Use `address` instead.
+     */
     streetAddress?: string;
     lat?: number;
     lng?: number;
-    /** Canonical hex feature id `0x…:0x…`. */
+    /**
+     * Canonical hex feature id `0x…:0x…` — derived from the decimal hi/lo pair
+     * in the address block, not directly transmitted in hex form.
+     */
     hexId?: string;
-    /** Google feature id, e.g. `/g/11q21hjdkh`. */
+    /**
+     * Google internal feature id, e.g. `/g/11q21hjdkh`.
+     * Present when addressBlock[7] or addressBlock[5][5] is a `/g/…` or `/m/…` path.
+     * Distinct from `hexId` — this is the `/g/` path form, hexId is the `0x…:0x…` form.
+     */
     featureId?: string;
+    /** ChIJ base64 place id when present in the address block. */
+    placeId?: string;
     addedBy?: string;
+    /** ISO 8601 timestamp when the entry was added to the list. */
     addedAt?: string;
+    /**
+     * Place rating (1–5).
+     * Not currently extracted by the parser — present in some list entry payloads.
+     * Reserved for future extraction.
+     */
+    rating?: number;
+    /**
+     * Total review count for the place.
+     * Not currently extracted by the parser — reserved for future extraction.
+     */
+    reviewCount?: number;
+    /**
+     * Primary category string (e.g. "Restaurant", "Café").
+     * Not currently extracted by the parser — reserved for future extraction.
+     */
+    category?: string;
+    /**
+     * Place thumbnail URL.
+     * Not currently extracted by the parser — reserved for future extraction.
+     */
+    thumbnailUrl?: string;
+    raw?: unknown;
 }
 /** Parsed place list with metadata and lightweight place stubs. */
 export interface PlaceList {
-    listId: string;
+    /** List id when the response bundle carries one; absent (not empty string) on malformed payloads. */
+    listId?: string;
     title?: string;
     ownerName?: string;
     ownerAvatarUrl?: string;
@@ -38,4 +79,28 @@ export interface PlaceList {
     entries: PlaceListEntry[];
     raw?: unknown;
 }
+/** Options for browsing public lists. */
+export interface ListBrowseOptions {
+    category?: 'featured' | 'trending' | 'new';
+    language?: string;
+    limit?: number;
+    offset?: number;
+}
+/** Summary of a list for browsing. */
+export interface PlaceListSummary {
+    id: string;
+    title: string;
+    description?: string;
+    ownerName?: string;
+    /** Number of places in the list, when Google publishes it in the browse response. */
+    itemCount?: number;
+    itemPreview?: Array<{
+        name: string;
+        lat?: number;
+        lng?: number;
+    }>;
+    createdAt?: Date;
+    lastModified?: Date;
+    isPublic: boolean;
+}
 //# sourceMappingURL=lists.d.ts.map

package/dist/types/lists.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lists.d.ts","sourceRoot":"","sources":["../../src/types/lists.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,MAAM,cAAc,GAAG;IAC3B,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mGAAmG;IACnG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,mEAAmE;AACnE,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf"}
+{"version":3,"file":"lists.d.ts","sourceRoot":"","sources":["../../src/types/lists.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,MAAM,cAAc,GAAG;IAC3B,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mGAAmG;IACnG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,mEAAmE;AACnE,MAAM,WAAW,SAAS;IACxB,qGAAqG;IACrG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,KAAK,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/dist/types/map-3d.d.ts

@@ -0,0 +1,126 @@
+import type { Coordinates } from './common.js';
+import type { RocktreePlanet } from '../rpc/earth-rocktree.js';
+/**
+ * Bounding box in the Earth octree's native `ne`/`sw` corner spelling
+ * (distinct from {@link LatLngBounds} in `types/directions.ts`, which uses `southwest`/`northeast`).
+ *
+ * Coordinates are geodetic lat/lng regardless of planet — mars/moon octrees
+ * use the same spherical mapping.
+ */
+export interface Map3dBounds {
+    ne: Coordinates;
+    sw: Coordinates;
+}
+/** How finely to sample the photorealistic octree. */
+export type Map3dDetail = 'low' | 'medium' | 'high' | 'max';
+export interface Map3dMeshOptions {
+    bounds: Map3dBounds;
+    /**
+     * Target ground sampling distance. `low` ≈ 40 m/texel (city block massing),
+     * `high` ≈ 2 m/texel (individual buildings), `max` descends as deep as the
+     * octree publishes. Defaults to `high`.
+     */
+    detail?: Map3dDetail;
+    /** Explicit target metres-per-texel; overrides `detail`. */
+    metersPerTexel?: number;
+    /** Include the node's 512×512 JPEG texture bytes. Defaults to false. */
+    includeTextures?: boolean;
+    /** Cap on nodes fetched. Defaults to 16. */
+    maxTiles?: number;
+    /**
+     * Which rocktree planetoid to walk. `earth` (default), `mars` or `moon` —
+     * all three serve the same octree protocol anonymously.
+     */
+    planet?: RocktreePlanet;
+}
+export interface Map3dVertex {
+    lat: number;
+    lng: number;
+    /** Height above the 6 371 010 m reference sphere, in metres. */
+    alt: number;
+}
+export interface Map3dTile {
+    /** Octant path identifying this node in the Earth octree. */
+    path: string;
+    /** Ground sampling distance of this node, in metres. */
+    metersPerTexel: number;
+    vertices: Map3dVertex[];
+    /** Triangle vertex indices, three per face. */
+    triangles: Array<[number, number, number]>;
+    /** Per-vertex texture coordinates in [0,1], when the node carries them. */
+    uvs: Array<[number, number]> | null;
+    texture: {
+        format: 'jpeg' | 'unknown';
+        width: number;
+        height: number;
+        bytes: Uint8Array;
+    } | null;
+    bounds: Map3dBounds;
+}
+export interface Map3dMeshResult {
+    tiles: Map3dTile[];
+    bounds: Map3dBounds;
+    /** Deepest octree level reached. */
+    level: number;
+    vertexCount: number;
+    triangleCount: number;
+    attribution: string;
+}
+export interface Map3dBuildingsOptions {
+    bounds: Map3dBounds;
+    /** Ignore structures shorter than this, in metres. Defaults to 4. */
+    minHeight?: number;
+    sort?: 'height' | 'prominence' | 'area';
+    detail?: Map3dDetail;
+    maxTiles?: number;
+    /** Rocktree planetoid to walk (default earth). */
+    planet?: RocktreePlanet;
+}
+export interface Building3d {
+    id: string;
+    outline: Array<{
+        lat: number;
+        lng: number;
+    }>;
+    /** Height above local ground, in metres. */
+    height: number;
+    centerLat: number;
+    centerLng: number;
+    /** Footprint area in square metres. */
+    areaSqM: number;
+    /** Ground height above the reference sphere, in metres. */
+    groundAlt: number;
+    color?: string;
+    address?: string;
+    buildingType?: string;
+}
+export interface Map3dTerrainOptions {
+    bounds: Map3dBounds;
+    /** Grid step: `low` 32 m, `medium` 16 m, `high` 8 m. Defaults to medium. */
+    resolution?: 'low' | 'medium' | 'high';
+    detail?: Map3dDetail;
+    maxTiles?: number;
+    /** Emit a Wavefront OBJ of the sampled surface. Defaults to true. */
+    includeMesh?: boolean;
+    /** Rocktree planetoid to walk (default earth). */
+    planet?: RocktreePlanet;
+}
+export interface Terrain3dGrid {
+    cols: number;
+    rows: number;
+    /** Row-major heights above the reference sphere; `null` where unsampled. */
+    heights: Array<number | null>;
+    /** Grid step in metres. */
+    stepMeters: number;
+}
+export interface Terrain3dResult {
+    /** Wavefront OBJ of the sampled surface (empty when `includeMesh` is false). */
+    mesh: Buffer;
+    format: 'obj';
+    bounds: Map3dBounds;
+    grid: Terrain3dGrid;
+    minAlt: number;
+    maxAlt: number;
+    attribution: string;
+}
+//# sourceMappingURL=map-3d.d.ts.map

package/dist/types/map-3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-3d.d.ts","sourceRoot":"","sources":["../../src/types/map-3d.ts"],"names":[],"mappings":"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"}

package/dist/types/map-3d.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=map-3d.js.map

package/dist/types/map-3d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-3d.js","sourceRoot":"","sources":["../../src/types/map-3d.ts"],"names":[],"mappings":""}

package/dist/types/map-earth.d.ts

@@ -0,0 +1,34 @@
+export interface EarthTileOptions {
+    zoom: number;
+    x: number;
+    y: number;
+    imageryType?: 'satellite' | 'hybrid';
+    scale?: 1 | 2;
+}
+export interface EarthTileResult {
+    data: Buffer;
+    zoom: number;
+    x: number;
+    y: number;
+    captureDate?: Date;
+}
+export interface EarthImageryOptions {
+    bounds: {
+        ne: {
+            lat: number;
+            lng: number;
+        };
+        sw: {
+            lat: number;
+            lng: number;
+        };
+    };
+    resolution?: 'low' | 'medium' | 'high';
+}
+export interface EarthImageryResult {
+    imagery: Buffer;
+    /** Resolution actually used for the mosaic (echoes the request, default `high`). */
+    resolution: 'low' | 'medium' | 'high';
+    lastUpdated: Date;
+}
+//# sourceMappingURL=map-earth.d.ts.map

package/dist/types/map-earth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-earth.d.ts","sourceRoot":"","sources":["../../src/types/map-earth.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,WAAW,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IACrC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE;QAAE,EAAE,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,EAAE,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC/E,UAAU,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtC,WAAW,EAAE,IAAI,CAAC;CACnB"}

package/dist/types/map-earth.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=map-earth.js.map

package/dist/types/map-earth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-earth.js","sourceRoot":"","sources":["../../src/types/map-earth.ts"],"names":[],"mappings":""}

package/dist/types/map-layers.d.ts

@@ -0,0 +1,63 @@
+export interface LayerTileOptions {
+    zoom: number;
+    x: number;
+    y: number;
+    scale?: 1 | 2;
+}
+export interface LayerTileResult {
+    data: Buffer;
+    mimeType: string;
+    zoom: number;
+    x: number;
+    y: number;
+}
+export interface LayerSearchOptions {
+    bounds: {
+        ne: {
+            lat: number;
+            lng: number;
+        };
+        sw: {
+            lat: number;
+            lng: number;
+        };
+    };
+    type?: 'elementary' | 'middle' | 'high' | 'college';
+}
+export interface SchoolMarker {
+    id: string;
+    name: string;
+    type: 'elementary' | 'middle' | 'high' | 'college';
+    lat: number;
+    lng: number;
+    rating?: number;
+    reviews?: number;
+}
+export interface ViewportCapabilitiesOptions {
+    lat: number;
+    lng: number;
+    /** Map zoom the capabilities are asked for. Defaults to 14. */
+    zoom?: number;
+    /** Viewport pixel width. Defaults to 1440. */
+    width?: number;
+    /** Viewport pixel height. Defaults to 757. */
+    height?: number;
+}
+export interface ViewportCapabilities {
+    lat: number;
+    lng: number;
+    zoom: number;
+    /**
+     * Capability ids Google reports for this viewport.
+     *
+     * Google publishes no names for these. Observed 2026-08-23: ids 3, 9 and 10
+     * come back almost everywhere land is in frame; 5 and 6 travel together and
+     * drop out over South Korea; 7 drops out over Japan and South Korea; 2 is
+     * present over most of Europe and the Americas and absent over Japan, South
+     * Korea, India, Kenya and the Sahara. Open water returns nothing at all.
+     */
+    capabilities: number[];
+    /** True when Google reports nothing — open ocean, or a viewport with no land. */
+    empty: boolean;
+}
+//# sourceMappingURL=map-layers.d.ts.map

package/dist/types/map-layers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-layers.d.ts","sourceRoot":"","sources":["../../src/types/map-layers.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE;QAAE,EAAE,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,EAAE,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC/E,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;CACrD;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;OAQG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iFAAiF;IACjF,KAAK,EAAE,OAAO,CAAC;CAChB"}

package/dist/types/map-layers.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=map-layers.js.map

package/dist/types/map-layers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-layers.js","sourceRoot":"","sources":["../../src/types/map-layers.ts"],"names":[],"mappings":""}

package/dist/types/mobility.d.ts

@@ -0,0 +1,121 @@
+/** Mobility POI types: EV charging, parking and bike-share. */
+import type { Coordinates } from './common.js';
+export type ParkingType = 'surface' | 'garage' | 'valet' | 'street' | 'lot';
+export interface ParkingSearchOptions {
+    location: {
+        lat: number;
+        lng: number;
+    };
+    radiusMeters?: number;
+    type?: ParkingType[];
+    priceRange?: {
+        min?: number;
+        max?: number;
+    };
+    sort?: 'distance' | 'price' | 'availability';
+}
+export interface Parking {
+    id: string;
+    name: string;
+    type: ParkingType;
+    lat: number;
+    lng: number;
+    distanceMeters: number;
+    rating?: number;
+    reviews?: number;
+    availability?: number;
+    hourlyRate?: number;
+    availableSpaces?: number;
+}
+export interface ParkingAvailability {
+    parkingId: string;
+    availableSpaces: number;
+    totalSpaces: number;
+    lastUpdated: Date;
+    updatesFrequencyMinutes: number;
+}
+export interface ParkingPrice {
+    parkingId: string;
+    hourly?: number;
+    daily?: number;
+    monthly?: number;
+    currency: string;
+    validFrom?: Date;
+    validTo?: Date;
+}
+export type ConnectorType = 'supercharger' | 'type2' | 'ccs' | 'chademo' | 'ac' | 'tesla';
+export type ChargerStatus = 'available' | 'occupied' | 'faulted' | 'unknown';
+export interface EvChargingSearchOptions {
+    location: Coordinates;
+    /** Search radius in metres. */
+    radiusMeters?: number;
+    connectorTypes?: ConnectorType[];
+    /** Minimum charger power in kW. */
+    minPower?: number;
+    sort?: 'distance' | 'availability' | 'price';
+}
+export interface EvChargingStation {
+    id: string;
+    name: string;
+    operator: string;
+    lat: number;
+    lng: number;
+    distanceMeters: number;
+    chargers: EvCharger[];
+    address?: string;
+    phone?: string;
+    website?: string;
+    amenities?: string[];
+}
+export interface EvCharger {
+    id: string;
+    type: ConnectorType;
+    /** Charging power in kW. Omitted when Google publishes no power figure — never `0`. */
+    power?: number;
+    status: ChargerStatus;
+    availableCount?: number;
+    totalCount?: number;
+}
+export interface EvChargerStatus {
+    chargerId: string;
+    status: ChargerStatus;
+    available: boolean;
+    lastUpdated: Date;
+    percentReserved?: number;
+}
+export interface EvChargingPrice {
+    stationId: string;
+    currency: string;
+    pricing: {
+        perKwh?: number;
+        perMinute?: number;
+        perSession?: number;
+        sessionMinutes?: number;
+    };
+    validFrom?: Date;
+    validTo?: Date;
+}
+/** Bike-share dock availability from the place preview availability block. */
+export interface BikeShareAvailability {
+    /** Bikes currently at the station. */
+    bikesAvailable: number;
+    /** Total dock capacity published by the operator feed. */
+    bikesTotal: number;
+    /** Compact label, e.g. `"48/57 bikes available"`. */
+    label: string;
+    /** Spelled-out label, e.g. `"48 out of 57 bikes available"`. */
+    labelText: string;
+}
+export interface GetBikeAvailabilityOptions {
+    /** Station hex feature id (`0x…:0x…`) — from search hits or `parseMapsUrl`. */
+    hexId?: string;
+    name?: string;
+    lat?: number;
+    lng?: number;
+    ftid?: string;
+    /** Place preview pb mode. All modes carry the availability block; default `live`. */
+    mode?: 'live' | 'detail' | 'rich';
+    hl?: string;
+    gl?: string;
+}
+//# sourceMappingURL=mobility.d.ts.map

package/dist/types/mobility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobility.d.ts","sourceRoot":"","sources":["../../src/types/mobility.ts"],"names":[],"mappings":"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"}

package/dist/types/mobility.js

@@ -0,0 +1,3 @@
+/** Mobility POI types: EV charging, parking and bike-share. */
+export {};
+//# sourceMappingURL=mobility.js.map

package/dist/types/mobility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobility.js","sourceRoot":"","sources":["../../src/types/mobility.ts"],"names":[],"mappings":"AAAA,+DAA+D"}