googlemaps-kit 0.4.0 → 0.6.0

package/dist/types/search-along-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-along-route.d.ts","sourceRoot":"","sources":["../../src/types/search-along-route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;IAC7B,WAAW,EAAE,WAAW,GAAG,MAAM,CAAC;IAClC,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,mGAAmG;IACnG,YAAY,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,KAAK,EAAE;QACL,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,iEAAiE;QACjE,IAAI,EAAE,WAAW,EAAE,CAAC;QACpB,mDAAmD;QACnD,OAAO,EAAE,WAAW,EAAE,CAAC;KACxB,CAAC;IACF,qFAAqF;IACrF,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/search-along-route.js

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

package/dist/types/search-along-route.js.map

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

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

@@ -1,5 +1,5 @@
 /**
- * Search filter types reverse-engineered from Maps client JS (FRNZOb.js / eH4Qrd.js).
+ * Search filter types matched against the Maps web client (FRNZOb.js / eH4Qrd.js).
  *
  * NOT EFFECTIVE for anonymous HTTP: live probing showed none of these encodings change
  * `search?tbm=map` results — parameters are silently ignored. Registered as `searchFilters`

package/dist/types/search-filters.js

@@ -1,5 +1,5 @@
 /**
- * Search filter types reverse-engineered from Maps client JS (FRNZOb.js / eH4Qrd.js).
+ * Search filter types matched against the Maps web client (FRNZOb.js / eH4Qrd.js).
  *
  * NOT EFFECTIVE for anonymous HTTP: live probing showed none of these encodings change
  * `search?tbm=map` results — parameters are silently ignored. Registered as `searchFilters`

package/dist/types/suggest.d.ts

@@ -1,7 +1,13 @@
+import type { LocationRef } from './common.js';
 /** Omnibox autocomplete request options. */
 export interface SuggestOptions {
     /** Partial query text typed by the user. */
     query: string;
+    /**
+     * Bias point for suggestions. Wins over the flat `lat` / `lng` fields when
+     * both are given. Place names are geocoded to a pin.
+     */
+    location?: LocationRef;
     /** Camera latitude — biases suggestions toward this viewport (default Bangalore). */
     lat?: number;
     /** Camera longitude — biases suggestions toward this viewport (default Bangalore). */
@@ -23,8 +29,8 @@ export interface SuggestOptions {
     /** Include the raw parsed protobuf tree in the result. */
     raw?: boolean;
 }
-export type SuggestionKind = 'query' | 'place';
-/** A single omnibox suggestion — either a query completion or a place hit. */
+export type SuggestionKind = 'query' | 'place' | 'route';
+/** A single omnibox suggestion — either a query completion, a place hit, or a route. */
 export interface Suggestion {
     kind: SuggestionKind;
     /** Best display text (full description or primary line). */
@@ -43,6 +49,21 @@ export interface Suggestion {
     thumbnailUrl?: string;
     /** ISO 3166-1 alpha-2 country code when present. */
     countryCode?: string;
+    /** Suggest response subtype / section discriminator when present. */
+    subtype?: number;
+    /** Ranking / source score when present. */
+    score?: number;
+    /**
+     * Distance string shown for nearby place suggestions, e.g. "0.3 mi" or "500 m".
+     * Present only when the suggest response includes proximity ranking.
+     */
+    distanceText?: string;
+    /**
+     * Category or type hint shown as third line in some suggest responses
+     * (e.g. "Restaurant", "Coffee shop").
+     */
+    typeHint?: string;
+    raw?: unknown;
 }
 /** Parsed omnibox autocomplete response. */
 export interface SuggestResult {

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

@@ -1 +1 @@
-{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../src/types/suggest.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/C,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,OAAO,CAAC;CACf"}
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../src/types/suggest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEzD,wFAAwF;AACxF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,OAAO,CAAC;CACf"}

package/dist/types/tiles.d.ts

@@ -62,4 +62,44 @@ export interface MapIconResult {
     width: number;
     height: number;
 }
+/** Options for fetching a specific map layer tile. */
+export interface MapLayerTileOptions {
+    z: number;
+    x: number;
+    y: number;
+    layer: 'standard' | 'satellite' | 'hybrid' | 'terrain';
+    scale?: 1 | 2;
+}
+/**
+ * Named `/maps/vt` overlay layers decoded from the Maps JS layer descriptors
+ * (`_.er` messages: field 1 = type enum, field 2 = layer name).
+ *
+ * Three answer real raster tiles anonymously:
+ * - `hillshade` (`shading`, type 5) — terrain hillshade, global from z8
+ * - `contours` (type 6) — elevation contour lines, observed band z13–15
+ * - `airQualityHeatmap` (`air-quality-heatmap`, type 2) — AQI heatmap, z5–15,
+ *   strongest over cities
+ *
+ * Every other named layer observed in the JS bundle — traffic, transit, bike,
+ * svv, air-quality, area-busyness, crisis2, hotel-categorical-search, indoor,
+ * lore-p13n, lore-rec, travel-map-reachability — renders only inside the full
+ * web client style context and returns empty placeholder tiles when probed
+ * directly.
+ */
+export type MapOverlayLayer = 'hillshade' | 'contours' | 'airQualityHeatmap';
+/** Options for fetching an overlay tile by Web Mercator indices. */
+export interface MapOverlayFetchOptions {
+    z: number;
+    x: number;
+    y: number;
+    /** Overlay layer (default `hillshade`). */
+    layer?: MapOverlayLayer;
+}
+/** Options for fetching an overlay tile by lat/lng. */
+export interface MapOverlayLatLngOptions {
+    lat: number;
+    lng: number;
+    zoom: number;
+    layer?: MapOverlayLayer;
+}
 //# sourceMappingURL=tiles.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tiles.d.ts","sourceRoot":"","sources":["../../src/types/tiles.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC;AAErC,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjD,wFAAwF;AACxF,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC;AAE9B,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,gDAAgD;IAChD,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0FAA0F;AAC1F,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,eAAe,CAAC;CAC9B;AAED,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,+FAA+F;IAC/F,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,4BAA4B;AAC5B,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"tiles.d.ts","sourceRoot":"","sources":["../../src/types/tiles.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC;AAErC,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjD,wFAAwF;AACxF,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC;AAE9B,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,gDAAgD;IAChD,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0FAA0F;AAC1F,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,eAAe,CAAC;CAC9B;AAED,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,+FAA+F;IAC/F,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,4BAA4B;AAC5B,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,sDAAsD;AACtD,MAAM,WAAW,mBAAmB;IAClC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvD,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACf;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,UAAU,GAAG,mBAAmB,CAAC;AAE7E,oEAAoE;AACpE,MAAM,WAAW,sBAAsB;IACrC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,2CAA2C;IAC3C,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB"}

package/dist/types/traffic.d.ts

@@ -1,9 +1,20 @@
 /** Area traffic report from GetAreaTraffic batchexecute RPC. */
+import type { Coordinates } from './common.js';
 export interface AreaTrafficReport {
     hasTraffic: boolean;
-    severity?: number;
+    /**
+     * Traffic congestion severity level:
+     * `0` = no traffic, `1` = light, `2` = moderate, `3` = heavy, `4` = severe.
+     * Matches Google Maps internal traffic overlay codes.
+     */
+    severity?: 0 | 1 | 2 | 3 | 4;
     summary?: string;
     detail?: string;
+    /**
+     * Traffic incident icon URLs.
+     * Reserved — returns an empty array in all currently observed responses.
+     * Kept for forward compatibility if Google starts populating this slot.
+     */
     iconUrls?: string[];
     raw?: unknown;
 }
@@ -19,4 +30,50 @@ export interface GetAreaTrafficOptions {
     /** Override session psi token (scraped automatically when omitted). */
     psi?: string;
 }
+export type IncidentType = 'accident' | 'roadClosure' | 'roadWork' | 'congestion' | 'other';
+export type IncidentSeverity = 'critical' | 'major' | 'moderate' | 'minor';
+export interface TrafficIncident {
+    /** Google's incident id. */
+    id: string;
+    type: IncidentType;
+    /**
+     * Derived from {@link TrafficIncident.delay}, not reported by Google:
+     * `critical` ≥ 20 min, `major` ≥ 10, `moderate` ≥ 5, otherwise `minor`.
+     */
+    severity: IncidentSeverity;
+    /**
+     * Latitude of the first point of {@link TrafficIncident.path}.
+     * Omitted when Google publishes no decodable path for the incident.
+     */
+    lat?: number;
+    /** Longitude of the first path point. Omitted when there is no path. */
+    lng?: number;
+    /** Headline, e.g. `"Slowdown on E 42nd St"`. */
+    title: string;
+    /** Delay blurb, e.g. `"14-min delay"`. */
+    description?: string;
+    startTime?: Date;
+    endTime?: Date;
+    /** Road names the incident sits on. */
+    affectedRoads?: string[];
+    delay?: {
+        estimatedMinutes: number;
+        seconds: number;
+        text?: string;
+    };
+    /** Affected stretch of road, decoded from the response's delta-encoded points. */
+    path?: Coordinates[];
+    /** {@link TrafficIncident.path} as an encoded polyline. */
+    polyline?: string;
+    /** Incident icon served by maps.gstatic.com. */
+    iconUrl?: string;
+    source?: string;
+}
+export interface TrafficIncidentsOptions {
+    neLat: number;
+    neLng: number;
+    swLat: number;
+    swLng: number;
+    psi?: string;
+}
 //# sourceMappingURL=traffic.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"traffic.d.ts","sourceRoot":"","sources":["../../src/types/traffic.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd"}
+{"version":3,"file":"traffic.d.ts","sourceRoot":"","sources":["../../src/types/traffic.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;AAC5F,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB;;;OAGG;IACH,QAAQ,EAAE,gBAAgB,CAAC;IAC3B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,kFAAkF;IAClF,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd"}

package/dist/types/transit.d.ts

@@ -1,8 +1,22 @@
 /** Transit station departure board embedded in place preview placeData[62]. */
+import type { Coordinates } from './common.js';
+import type { TransitMode } from './directions.js';
+/**
+ * Raw vehicle label from the transit feed.
+ * Known canonical values are suggested, but Google also emits locale display
+ * labels ("Tube", "Metro"), so any string is assignable.
+ */
+export type TransitVehicleType = 'SUBWAY' | 'BUS' | 'TRAM' | 'RAIL' | 'FERRY' | 'CABLE_CAR' | 'GONDOLA' | (string & {});
 export interface TransitDeparture {
     headsign: string;
+    /** Human-readable departure time, e.g. "2 min" or "10:32". */
     scheduledTime?: string;
+    /** Unix timestamp in seconds (UTC). */
     scheduledUnix?: number;
+    /** ISO 8601 formatted departure time derived from scheduledUnix when timezone is present. */
+    scheduledAt?: string;
+    /** Minutes until departure (derived from scheduledUnix and current time). */
+    minutesUntil?: number;
     timezone?: string;
     platform?: string;
     tripId?: string;
@@ -10,12 +24,23 @@ export interface TransitDeparture {
     lineName?: string;
     lineColor?: string;
     lineTextColor?: string;
-    vehicleType?: string;
+    /**
+     * Vehicle type string from the transit feed.
+     * Known values: `"SUBWAY"`, `"BUS"`, `"TRAM"`, `"RAIL"`, `"FERRY"`, `"CABLE_CAR"`, `"GONDOLA"`.
+     * May also be a display label like `"Tube"` or `"Metro"` depending on locale.
+     */
+    vehicleType?: TransitVehicleType;
     vehicleIconUrl?: string;
+    /** Short route identifier (e.g. "N1", "Jubilee") extracted from headsign or line name. */
+    routeShortName?: string;
+    raw?: unknown;
 }
 export interface TransitModeBoard {
     mode: string;
+    /** Human-readable mode label (e.g. "Tube", "Bus") when present. */
+    modeLabel?: string;
     departures: TransitDeparture[];
+    raw?: unknown;
 }
 export interface TransitStationBoard {
     stationName?: string;
@@ -24,6 +49,7 @@ export interface TransitStationBoard {
     lng?: number;
     timezone?: string;
     modes: TransitModeBoard[];
+    raw?: unknown;
 }
 export interface GetStationDeparturesOptions {
     hexId: string;
@@ -43,4 +69,137 @@ export interface ListTransitLinesOptions {
     lng?: number;
     psi?: string;
 }
+export interface TransitRouteOptions {
+    origin: Coordinates | string;
+    destination: Coordinates | string;
+    /** Desired departure (local timezone of the origin). */
+    departureTime?: Date;
+    /** Desired arrival. Mutually exclusive with `departureTime`. */
+    arrivalTime?: Date;
+    preferences?: TransitPreference[];
+    /** Restrict to these vehicle types. */
+    modes?: TransitVehicleFilter[];
+    language?: string;
+}
+/**
+ * Vehicle types accepted by the transit filter.
+ * Same value set as {@link TransitMode} — kept as an alias so both option
+ * spellings (`RouteOptions.transitModes`, `TransitRouteOptions.modes`) stay valid.
+ */
+export type TransitVehicleFilter = TransitMode;
+export type TransitPreference = 'avoidSurface' | 'preferRail' | 'fewerTransfers';
+/** A point in space and time on a transit trip. */
+export interface TransitStation {
+    name: string;
+    /** Feed stop id (GTFS stop code) when Google publishes one. */
+    code?: string;
+    lat: number;
+    lng: number;
+    /** Maps feature id (`0x…:0x…`) for the stop, when present. */
+    hexId?: string;
+    /** Scheduled departure from this stop. */
+    departureTime?: Date;
+    /** Scheduled arrival at this stop. */
+    arrivalTime?: Date;
+}
+/** Operator running a transit leg. */
+export interface TransitAgency {
+    name: string;
+    id?: string;
+    url?: string;
+    phone?: string;
+}
+export interface TransitLine {
+    /** Short name riders use — `"176"`, `"A Line"`, `"Northern"`. */
+    number?: string;
+    /** Long display name when it differs from {@link number}. */
+    name?: string;
+    /** Line colour as `#rrggbb`. */
+    color?: string;
+    /** Contrasting text colour for {@link color}. */
+    textColor?: string;
+    agency?: string;
+    /** Full operator record. */
+    agencyDetails?: TransitAgency;
+    /** Terminus shown on the vehicle, e.g. `"Far Rockaway-Mott Av"`. */
+    headsign?: string;
+    /** Vehicle label from the feed — `"Bus"`, `"Subway"`, `"Tram"`. */
+    vehicleType?: TransitVehicleType;
+    /** Line/vehicle icon served by maps.gstatic.com. */
+    iconUrl?: string;
+}
+/** Service advisory attached to a route or leg. */
+export interface TransitAlert {
+    /** Short label, e.g. `"Modified schedule"`. */
+    headline?: string;
+    /** Severity label Google renders, e.g. `"Information"`. */
+    severity?: string;
+    /** Full advisory text. */
+    description?: string;
+}
+/** Fare for a route or leg, as published by the operator. */
+export interface TransitFare {
+    /** Numeric amount in {@link currency}. */
+    amount: number;
+    /** Localised amount, e.g. `"£1.75"`. */
+    text: string;
+    /** ISO 4217 code. */
+    currency: string;
+}
+export interface TransitLeg {
+    /** `walking` for the connecting legs, `transit` when riding a vehicle. */
+    mode: 'walking' | 'transit';
+    /**
+     * Boarding stop. Omitted when Google does not publish a station block
+     * (common on walking legs) — never a placeholder.
+     */
+    startStation?: TransitStation;
+    /** Alighting stop. Omitted when Google does not publish a station block. */
+    endStation?: TransitStation;
+    departureTime?: Date;
+    arrivalTime?: Date;
+    /** Leg duration in seconds. Omitted when the feed carries no duration node. */
+    durationSeconds?: number;
+    /** Human-readable duration, e.g. `"14 min"`. */
+    durationText?: string;
+    /** Distance in metres — present on walking legs. */
+    distanceMeters?: number;
+    distanceText?: string;
+    line?: TransitLine;
+    /** Turn-by-turn text for walking legs. */
+    instructions?: string[];
+    /** Stops between {@link startStation} and {@link endStation}. */
+    stops?: TransitStation[];
+    /** Number of stops ridden, as Google counts them. */
+    stopCount?: number;
+    /** Advisories scoped to this leg. */
+    alerts?: TransitAlert[];
+    fare?: TransitFare;
+}
+export interface TransitRoute {
+    legs: TransitLeg[];
+    /** Total trip duration in seconds. Omitted when the feed carries no duration node. */
+    durationSeconds?: number;
+    durationText?: string;
+    distanceMeters?: number;
+    distanceText?: string;
+    arrivalTime?: Date;
+    departureTime?: Date;
+    /** IANA timezone the times are expressed in. */
+    timezone?: string;
+    /** Vehicle boardings on this route (walking legs excluded). */
+    transfers: number;
+    /** Service frequency blurb, e.g. `"every 10 min"`. */
+    frequency?: string;
+    /** Total walking time across the route. */
+    walkingSeconds?: number;
+    fare?: TransitFare;
+    agencies?: TransitAgency[];
+    alerts?: TransitAlert[];
+    summary?: string;
+}
+export interface TransitRouteResult {
+    routes: TransitRoute[];
+    timingMs: number;
+}
 //# sourceMappingURL=transit.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"transit.d.ts","sourceRoot":"","sources":["../../src/types/transit.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd"}
+{"version":3,"file":"transit.d.ts","sourceRoot":"","sources":["../../src/types/transit.ts"],"names":[],"mappings":"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"}

package/dist/types/transit.js

@@ -1,3 +1,2 @@
-/** Transit station departure board embedded in place preview placeData[62]. */
 export {};
 //# sourceMappingURL=transit.js.map

package/dist/types/transit.js.map

@@ -1 +1 @@
-{"version":3,"file":"transit.js","sourceRoot":"","sources":["../../src/types/transit.ts"],"names":[],"mappings":"AAAA,+EAA+E"}
+{"version":3,"file":"transit.js","sourceRoot":"","sources":["../../src/types/transit.ts"],"names":[],"mappings":""}

package/dist/types/viewport.d.ts

@@ -0,0 +1,159 @@
+/** Viewport-surface types: passive-assist chips, neighbourhood context, click reveal. */
+export interface PassiveAssistChip {
+    name: string;
+    cacheKey?: string;
+    token?: string;
+    weatherIconUrl?: string;
+    weatherLabel?: string;
+    weatherTemp?: string;
+    /** Latitude of the associated place when present in the chip payload. */
+    lat?: number;
+    /** Longitude of the associated place when present in the chip payload. */
+    lng?: number;
+    /** Hex feature id of the associated place when present. */
+    hexId?: string;
+    /** ChIJ place id when present. */
+    placeId?: string;
+    raw?: unknown;
+}
+/** What a psi provider returns; `url` lets a provider hand back the verbatim captured request. */
+export interface MintedViewportPsi {
+    psi: string;
+    passiveAssistUrl?: string;
+}
+export interface PassiveAssistPsiContext {
+    lat: number;
+    lng: number;
+    zoom?: number;
+    hl: string;
+    gl: string;
+}
+export interface PassiveAssistOptions {
+    lat: number;
+    lng: number;
+    /** Viewport zoom used to derive camera altitude (default 14). */
+    zoom?: number;
+    /**
+     * In-page viewport psi. REQUIRED unless `psiProvider` is supplied: bootstrap
+     * kEI / fetchSessionPsi tokens only ever return the cache-metadata stub.
+     */
+    psi?: string;
+    /**
+     * Supplies an in-page psi on demand. Only a live Maps viewport session produces
+     * a usable token, so obtaining one needs a browser — this SDK deliberately will
+     * not launch one for you. Use `mintViewportPsi` from `scripts/lib/mint-viewport-psi.ts`
+     * to build a provider when a browser is acceptable in your environment.
+     */
+    psiProvider?: (context: PassiveAssistPsiContext) => Promise<string | MintedViewportPsi>;
+    width?: number;
+    height?: number;
+    /** Chip density hint (default 50). Browser also requests a 20-chip variant. */
+    chipLimit?: number;
+    hl?: string;
+    gl?: string;
+}
+export interface PassiveAssistResult {
+    chips: PassiveAssistChip[];
+    /** True when the response is the ~212 B cache-metadata stub with no POI rows. */
+    isStub: boolean;
+    raw?: unknown;
+}
+export type AreaType = 'city' | 'district' | 'neighborhood' | 'park' | 'water' | 'region';
+export type AdminLevel = 'country' | 'state' | 'county' | 'city' | 'neighborhood';
+export interface NearbyAreasOptions {
+    location: {
+        lat: number;
+        lng: number;
+    };
+    radiusMeters?: number;
+    types?: AreaType[];
+}
+export interface GeoArea {
+    id: string;
+    name: string;
+    type: AreaType;
+    lat: number;
+    lng: number;
+    distanceMeters: number;
+    bounds?: {
+        ne: {
+            lat: number;
+            lng: number;
+        };
+        sw: {
+            lat: number;
+            lng: number;
+        };
+    };
+    population?: number;
+}
+export interface AdminRegion {
+    name: string;
+    type: AdminLevel;
+    code?: string;
+    /**
+     * Region extent, when the source surface reports one.
+     *
+     * Reverse geocode names the administrative hierarchy but does not carry
+     * polygons, so this is usually absent.
+     */
+    bounds?: {
+        ne: {
+            lat: number;
+            lng: number;
+        };
+        sw: {
+            lat: number;
+            lng: number;
+        };
+    };
+    parent?: AdminRegion;
+}
+/** Options for GET /maps/preview/reveal (hidden POI at map click). */
+export interface RevealPlaceOptions {
+    /** Map viewport center latitude. */
+    camLat: number;
+    /** Map viewport center longitude. */
+    camLng: number;
+    /** Map zoom level used to derive camera altitude (default 14). */
+    camZoom?: number;
+    /** Click / hit-test latitude. */
+    hitLat: number;
+    /** Click / hit-test longitude. */
+    hitLng: number;
+    /**
+     * Feature id at the hit location (`!4m2!1s{ftid}!7e81`).
+     * From search/suggest `featureId` or place preview; omit to try hex-only flows.
+     */
+    ftid?: string;
+    /** Viewport width in pixels (default 1440). */
+    width?: number;
+    /** Viewport height in pixels (default 900). */
+    height?: number;
+    /** Tile pixel X for the hit (default 96). */
+    tileX?: number;
+    /** Tile pixel Y for the hit (default 64). */
+    tileY?: number;
+}
+/** POI revealed at a map click — often hidden from default map tiles. */
+export interface RevealedPlace {
+    name?: string;
+    formattedAddress?: string;
+    hexId?: string;
+    placeId?: string;
+    featureId?: string;
+    lat?: number;
+    lng?: number;
+    timezone?: string;
+    categoryHint?: string;
+    streetViewThumbnailUrl?: string;
+    plusCode?: string;
+    raw?: unknown;
+}
+export interface RevealPlaceResult {
+    place?: RevealedPlace;
+    /** Raw address line pair when present at response root. */
+    addressLines?: string[];
+    raw?: unknown;
+}
+//# sourceMappingURL=viewport.d.ts.map

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

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

package/dist/types/viewport.js

@@ -0,0 +1,3 @@
+/** Viewport-surface types: passive-assist chips, neighbourhood context, click reveal. */
+export {};
+//# sourceMappingURL=viewport.js.map

package/dist/types/viewport.js.map

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

package/dist/utils/async.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Async plumbing: abortable sleep, bounded-concurrency pools, TTL cache and
+ * per-call request context (AbortSignal via AsyncLocalStorage).
+ */
+export declare function throwIfAborted(signal?: AbortSignal): void;
+/** Sleep that rejects when the signal aborts. */
+export declare function sleepAbortable(ms: number, signal?: AbortSignal): Promise<void>;
+export declare function pooled<T>(items: T[], limit: number, worker: (item: T, index: number) => Promise<void>): Promise<void>;
+/** Like {@link pooled} but collects return values in input order. */
+export declare function pooledMap<T, R>(items: T[], limit: number, worker: (item: T, index: number) => Promise<R>): Promise<R[]>;
+export declare function sleep(ms: number): Promise<void>;
+export declare class TtlCache<V> {
+    private readonly ttlMs;
+    private readonly maxEntries;
+    private readonly map;
+    constructor(options?: {
+        ttlMs?: number;
+        maxEntries?: number;
+    });
+    get(key: string): V | undefined;
+    set(key: string, value: V): void;
+    clear(): void;
+    get size(): number;
+}
+export interface RequestContext {
+    signal?: AbortSignal;
+}
+export declare function runWithRequestContext<T>(ctx: RequestContext, fn: () => Promise<T>): Promise<T>;
+export declare function getRequestSignal(): AbortSignal | undefined;
+/**
+ * Run any kit calls inside an abortable scope.
+ *
+ * Intent methods (`discover`, `profile`, …) take `signal` directly. Service
+ * calls (`maps.travel.directions.get(…)`, `maps.map.tiles.getTile(…)`) do not —
+ * wrap them in this to make their HTTP requests abortable.
+ *
+ * @example
+ * const ac = new AbortController();
+ * const tile = await withAbortSignal(ac.signal, () =>
+ *   maps.map.tiles.getTile({ zoom: 14, x: 11871, y: 7576 }),
+ * );
+ */
+export declare function withAbortSignal<T>(signal: AbortSignal | undefined, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=async.d.ts.map