googlemaps-kit 0.3.1 → 0.5.0

package/dist/types/directions.d.ts

@@ -1,7 +1,15 @@
 import type { Coordinates, TravelMode } from './common.js';
+import type { TransitVehicleType } from './transit.js';
 export type DirectionsUnits = 'metric' | 'imperial';
 /** Driving preference — not exposed until a working pb slot is confirmed live. */
 export type DirectionsAvoid = 'tolls' | 'highways' | 'ferries';
+/**
+ * Transit mode filter for `mode: 'transit'` routes.
+ * Pass one or more to restrict results to those vehicle types.
+ * Multiple values are ORed together (same as the Maps web client behaviour).
+ */
+export type TransitRoutingPreference = 'less_walking' | 'fewer_transfers';
+export type TransitMode = 'bus' | 'subway' | 'train' | 'tram' | 'rail';
 export interface DirectionsWaypoint {
     location: Coordinates | string;
     /** When true, route passes through but does not stop (not yet verified on preview/directions). */
@@ -27,25 +35,73 @@ export interface DirectionsOptions {
      * Return duration/distance only — skip step scrape (used by distance matrix / elevation).
      */
     metricsOnly?: boolean;
+    /**
+     * Desired departure time as a Unix timestamp (seconds). For transit routes.
+     * When not set, Google uses the current time.
+     */
+    departureTime?: number;
+    /**
+     * Desired arrival time as a Unix timestamp (seconds). For transit routes.
+     * Mutually exclusive with `departureTime`.
+     */
+    arrivalTime?: number;
+    /**
+     * Restrict transit routes to these vehicle types. Only effective when `mode: 'transit'`.
+     * Multiple values are ORed together.
+     */
+    transitModes?: TransitMode[];
+    /**
+     * Preference for transit routing: minimize walking or minimize transfers.
+     */
+    transitRoutingPreference?: TransitRoutingPreference;
 }
 export type StepManeuver = 'TURN' | 'STRAIGHT' | 'MERGE' | 'RAMP' | 'FORK' | 'ROUNDABOUT' | 'UTURN' | 'FERRY' | 'TRANSIT' | 'WALK' | 'UNKNOWN';
+/** Full transit details extracted from a transit step. */
 export interface DirectionsTransitDetails {
+    /** Line identifier, e.g. "Bus 10" or "Jubilee line". */
     line?: string;
+    /** Short route identifier, e.g. "N1" or "Jubilee". */
+    routeShortName?: string;
+    /** Destination shown on the vehicle, e.g. "towards Stratford". */
     headsign?: string;
+    /** Operating agency name, e.g. "Transport for London". */
     agency?: string;
-    vehicleType?: string;
+    /** Vehicle type: "BUS", "SUBWAY", "TRAIN", "TRAM", "RAIL", "FERRY", "CABLE_CAR". */
+    vehicleType?: TransitVehicleType;
+    /** URL of the transit vehicle icon. */
+    vehicleIconUrl?: string;
+    /** Line background colour as a hex string, e.g. "#0098A4". */
+    lineColor?: string;
+    /** Line text colour as a hex string, e.g. "#FFFFFF". */
+    lineTextColor?: string;
+    /** Name of the stop where you board. */
     departureStop?: string;
+    /** Name of the stop where you alight. */
     arrivalStop?: string;
+    /** Human-readable departure time, e.g. "10:32". */
     departureTime?: string;
+    /** Human-readable arrival time. */
     arrivalTime?: string;
+    /** ISO 8601 departure timestamp derived from Unix time when available. */
+    departureAt?: string;
+    /** ISO 8601 arrival timestamp. */
+    arrivalAt?: string;
+    /** Number of stops on this segment. */
     numStops?: number;
+    /** Fare string when present, e.g. "₹10" or "$2.50". */
     fare?: string;
 }
 export interface DirectionsStep {
     /** Plain-text instruction, e.g. "Turn left onto 11th Cross Rd". */
     instruction?: string;
+    /** Human-readable distance, e.g. "148 ft" or "1.2 km". */
     distance?: string;
+    /** Parsed distance in metres (always an integer when distance is present). */
+    distanceMeters?: number;
+    /** Human-readable duration, e.g. "2 min". */
     duration?: string;
+    /** Parsed duration in seconds (integer). */
+    durationSeconds?: number;
     /** Maneuver code from step markup or dir-tt CSS class. */
     maneuver?: string;
     /** Normalized turn hint parsed from dir-tt CSS when present. */
@@ -56,47 +112,205 @@ export interface DirectionsStep {
     roads?: string[];
     /** Explicit lat/lng pairs from step holder `[7][1]` / `[7][2]`. */
     path?: Coordinates[];
-    /** Standard encoded polyline derived from `path` when enough points exist. */
+    /**
+     * Standard encoded polyline derived from `path` when ≥2 points exist.
+     * Pass to `decodePolyline()` or `polylineToPath()` for human-readable coordinates.
+     */
     polyline?: string;
+    /** Transit details — present only on transit steps. */
     transit?: DirectionsTransitDetails;
 }
 export interface DirectionsLeg {
+    /** Human-readable distance, e.g. "2.7 miles". */
     distance?: string;
+    /** Parsed distance in metres. */
+    distanceMeters?: number;
+    /** Human-readable duration, e.g. "9 min". */
     duration?: string;
+    /** Parsed duration in seconds. */
+    durationSeconds?: number;
+    /** Primary road / route name for this leg. */
     summary?: string;
     steps?: DirectionsStep[];
 }
 export interface LatLngBounds {
     southwest: Coordinates;
     northeast: Coordinates;
+    /** Human-readable bounding box, e.g. "SW(42.29°, -83.73°) → NE(42.30°, -83.71°)". */
+    label?: string;
 }
 /** One route alternative. Google usually returns two or three per request. */
 export interface DirectionsRoute {
+    /** Human-readable distance, e.g. "2.7 miles". */
     distance?: string;
+    /** Parsed distance in metres. */
+    distanceMeters?: number;
+    /** Human-readable free-flow duration, e.g. "9 min". */
     duration?: string;
+    /** Parsed free-flow duration in seconds. */
+    durationSeconds?: number;
     /** Human label at route header `[0][1]`, e.g. "8th Main Rd". */
     summary?: string;
     /** Traffic-adjusted duration at route header `[0][10][0][1]` when distinct from free-flow. */
     durationInTraffic?: string;
+    /** Parsed traffic-adjusted duration in seconds. */
+    durationInTrafficSeconds?: number;
     bounds?: LatLngBounds;
     legs: DirectionsLeg[];
-    /** Encoded overview polyline stitched from per-step `[7][5][0]` segments when present. */
+    /**
+     * Encoded overview polyline stitched from per-step path points.
+     * Pass to `decodePolyline()` for a lat/lng array, or `polylineToGeoJSON()` for a GeoJSON LineString.
+     */
     polyline?: string;
+    /**
+     * Decoded lat/lng path — ready to use without calling decodePolyline.
+     * Same data as polyline, just already expanded.
+     */
     path?: Coordinates[];
+    /**
+     * Simplified human-readable path: array of "lat, lng" strings for logging / display.
+     * Rounded to 5 decimal places.
+     */
+    humanPath?: string[];
     warnings?: string[];
 }
 export interface DirectionsResult {
+    /** Human-readable distance of the primary route, e.g. "2.7 miles". */
     distance?: string;
+    /** Parsed distance in metres for the primary route. */
+    distanceMeters?: number;
+    /** Human-readable free-flow duration of the primary route, e.g. "9 min". */
     duration?: string;
+    /** Parsed free-flow duration in seconds for the primary route. */
+    durationSeconds?: number;
+    /** Primary route label, e.g. "via Pontiac Trail". */
     summary?: string;
     /** Traffic-adjusted duration for the primary route when present. */
     durationInTraffic?: string;
+    /** Parsed traffic duration in seconds. */
+    durationInTrafficSeconds?: number;
     bounds?: LatLngBounds;
     /** Legs of the primary (first) route. */
     legs: DirectionsLeg[];
     /** All route alternatives Google returned, primary first. */
     routes?: DirectionsRoute[];
     warnings?: string[];
+    /**
+     * Overview polyline for the primary route.
+     * Pass to `decodePolyline()` / `polylineToGeoJSON()`.
+     */
+    polyline?: string;
+    /**
+     * Decoded lat/lng path for the primary route — ready to use.
+     */
+    path?: Coordinates[];
+    raw?: unknown;
+}
+export type DistanceMatrixElementStatus = 'OK' | 'ZERO_RESULTS' | 'NOT_FOUND' | 'ERROR';
+export interface DistanceMatrixLocation extends Coordinates {
+    /** Optional label echoed back in results. */
+    label?: string;
+}
+export interface DistanceMatrixOptions {
+    origins: Array<Coordinates | string>;
+    destinations: Array<Coordinates | string>;
+    mode?: TravelMode;
+    /** Max parallel directions requests (default 8). */
+    concurrency?: number;
+    /** Extra delay between pair starts (default 0 — HttpClient scheduler paces). */
+    requestDelayMs?: number;
+    hl?: string;
+    gl?: string;
+}
+export interface DistanceMatrixCell {
+    originIndex: number;
+    destinationIndex: number;
+    status: DistanceMatrixElementStatus;
+    distanceMeters?: number;
+    durationSeconds?: number;
+    /** Human-readable distance from directions, when parsed. */
+    distanceText?: string;
+    /** Human-readable duration from directions, when parsed. */
+    durationText?: string;
+    error?: string;
+}
+export interface DistanceMatrixResult {
+    /** origins × destinations matrix in row-major order. */
+    rows: DistanceMatrixCell[][];
+    /** Total unique directions HTTP requests made (after deduplication). */
+    requestCount: number;
+    /** Implementation note: fan-out over `/maps/preview/directions`, not a batch matrix RPC. */
+    implementation: 'directions-fan-out';
+    /** Wall time for the whole matrix. */
+    timingMs?: number;
+}
+export type ElevationStatus = 'OK' | 'UNAVAILABLE' | 'ERROR';
+export interface ElevationPointOptions {
+    lat: number;
+    lng: number;
+    hl?: string;
+    gl?: string;
+}
+export interface ElevationPointResult {
+    lat: number;
+    lng: number;
+    status: ElevationStatus;
+    /** Meters above WGS84 ellipsoid when available. */
+    elevationMeters?: number;
+    /** How elevation was obtained. */
+    source?: 'directions-bicycling-start' | 'directions-profile';
+    error?: string;
+    timingMs?: number;
+}
+export interface ElevationPathOptions {
+    /** At least two points defining the path. */
+    points: Coordinates[];
+    /** Travel mode for directions lookup (default `bicycling` — most reliable elevation block). */
+    mode?: Extract<TravelMode, 'bicycling' | 'walking'>;
+    hl?: string;
+    gl?: string;
+    /** Include raw directions payload in the result. */
+    raw?: boolean;
+}
+export interface ElevationSummary {
+    minElevationMeters: number;
+    maxElevationMeters: number;
+    startElevationMeters: number;
+    endElevationMeters: number;
+    gainMeters: number;
+    lossMeters: number;
+    /** Formatted strings from Google payload when present. */
+    minElevationText?: string;
+    maxElevationText?: string;
+}
+export interface ElevationProfileSample {
+    /** Cumulative distance along the route in meters (delta-decoded from directions payload). */
+    distanceMeters: number;
+    /**
+     * Elevation in meters above sea level at this sample.
+     * Currently `undefined` — the directions elevation block encodes only the
+     * summary (min/max/start/end) and grade per sample, not per-sample absolute elevation.
+     * Reserved for a future payload that provides it.
+     */
+    elevationMeters?: number;
+    /** Grade at this sample in percent when present. */
+    gradePercent?: number;
+}
+export interface ElevationPathResult {
+    status: ElevationStatus;
+    summary?: ElevationSummary;
+    /** Cumulative-distance samples with grade; elevation stats are in `summary`. */
+    profile?: ElevationProfileSample[];
+    /** Total route distance in meters from decoded profile distances. */
+    pathDistanceMeters?: number;
+    /**
+     * Elevation at the start of the route in meters — same as `summary.startElevationMeters`.
+     * Provided as a convenience field directly on the result for quick access.
+     */
+    startElevationMeters?: number;
+    mode: Extract<TravelMode, 'bicycling' | 'walking'>;
+    error?: string;
     raw?: unknown;
+    timingMs?: number;
 }
 //# sourceMappingURL=directions.d.ts.map

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

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

package/dist/types/dx.d.ts

@@ -4,6 +4,7 @@
  * Intent methods return these shapes so agents/devs always know where fields live.
  */
 import type { Coordinates, KnowledgeEntity, LocalPost, PlaceDetails, PlaceFullMeta, ReviewsResult, SearchMode, SearchResult, TravelMode } from './common.js';
+import type { TransitMode, TransitRoutingPreference } from './directions.js';
 import type { SearchClientFilters } from './search-filters.js';
 import type { ReviewClientFilters } from './reviews.js';
 import type { PhotoCategory, PlacePhoto, PhotosSource } from './photos.js';
@@ -37,9 +38,9 @@ export type PlaceRef = string | {
     name?: string;
     lat?: number;
     lng?: number;
-    /** Search-row alias for lat. */
+    /** @deprecated Search-row alias for `lat` — use `lat`. */
     latitude?: number;
-    /** Search-row alias for lng. */
+    /** @deprecated Search-row alias for `lng` — use `lng`. */
     longitude?: number;
     placeId?: string;
     ftid?: string;
@@ -72,8 +73,9 @@ export interface ClientCapabilities {
     askMapsHistory: boolean;
     privateLists: boolean;
     legacyRpc: boolean;
+    userPrefs: boolean;
 }
-export type AuthCapability = keyof Pick<ClientCapabilities, 'askMaps' | 'askMapsHistory' | 'reviewsRpc' | 'privateLists' | 'legacyRpc'>;
+export type AuthCapability = keyof Pick<ClientCapabilities, 'askMaps' | 'askMapsHistory' | 'reviewsRpc' | 'privateLists' | 'legacyRpc' | 'userPrefs'>;
 /** Input for `maps.discover()`. */
 export interface DiscoverOptions extends IntentCallOptions {
     /** Free-text query, e.g. "coffee" or "cafes in indiranagar". */
@@ -207,6 +209,23 @@ export interface RouteOptions extends IntentCallOptions {
      * Default false: duration/distance only.
      */
     includeSteps?: boolean;
+    /**
+     * Desired departure time as a Unix timestamp (seconds). For `mode: 'transit'`.
+     * Defaults to current time when omitted.
+     */
+    departureTime?: number;
+    /**
+     * Desired arrival time as a Unix timestamp (seconds). Mutually exclusive with `departureTime`.
+     */
+    arrivalTime?: number;
+    /**
+     * Restrict transit routes to these vehicle types. Only effective when `mode: 'transit'`.
+     */
+    transitModes?: TransitMode[];
+    /**
+     * Preference for transit routing: `'less_walking'` or `'fewer_transfers'`.
+     */
+    transitRoutingPreference?: TransitRoutingPreference;
 }
 /** Output of `maps.route()` — same as directions service. */
 export type RouteResult = DirectionsResult;
@@ -286,4 +305,30 @@ export interface PipelineResult {
     discover: DiscoverResult;
     timingMs: number;
 }
+/** Input for Intent `grid()` — area-coverage search. */
+export interface GridOptions extends Omit<import('./grid-search.js').GridSearchOptions, 'bounds' | 'onProgress'> {
+    /** Area to cover — either explicit bounds or a centre + span. */
+    bounds?: import('./grid-search.js').GridSearchBounds;
+    /**
+     * Bias center (Intent spelling); with `spanKm` this derives a square bounds.
+     * Ignored when `bounds` is set.
+     */
+    near?: Coordinates;
+    /** Full width of the derived square box in km (default 3). */
+    spanKm?: number;
+    /** Progress per cell — `{ type: 'grid', index, total, loaded }`. */
+    onProgress?: import('./hooks.js').ProgressCallback;
+}
+/** Result for Intent `grid()`. */
+export interface GridResult {
+    places: SearchResult[];
+    /** Cells actually searched (may be below plan due to caps / early exit). */
+    cellsSearched: number;
+    /** Cells the area expands to at `cellZoom`. */
+    cellsTotal: number;
+    /** Total search requests spent, including per-cell pagination. */
+    requestsMade: number;
+    cellZoom: number;
+    timingMs: number;
+}
 //# sourceMappingURL=dx.d.ts.map

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

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

package/dist/types/geocode.d.ts

@@ -1,8 +1,14 @@
 /** Forward geocode request options (address → coordinates). */
 export interface GeocodeOptions {
-    /** Viewport center latitude — biases the search camera (default 0). */
+    /**
+     * Viewport center latitude for the search camera bias.
+     * Defaults to 0 (Null Island) — pass a lat near the target area for better
+     * ranking of ambiguous addresses.
+     */
     lat?: number;
-    /** Viewport center longitude — biases the search camera (default 0). */
+    /**
+     * Viewport center longitude for the search camera bias. See {@link GeocodeOptions.lat}.
+     */
     lng?: number;
     /** Map zoom used to derive viewport altitude when `viewportDist` is omitted. */
     zoom?: number;
@@ -28,9 +34,21 @@ export interface ReverseGeocodeOptions {
     gl?: string;
     raw?: boolean;
 }
-/** A single parsed address line from place row index `[2]`. */
+/** A single parsed address component from place row index `[2]`. */
 export interface AddressComponent {
+    /** Long-form component name, e.g. "New York", "United States". */
     longName: string;
+    /**
+     * Short-form component name, e.g. "NY", "US".
+     * Not currently extracted by the geocode parser — reserved for future extraction.
+     */
+    shortName?: string;
+    /**
+     * Address component type tags, e.g. `["locality", "political"]`.
+     * Not currently extracted — reserved for future extraction.
+     */
+    types?: string[];
+    raw?: unknown;
 }
 /** Parsed geocode / reverse-geocode place row. */
 export interface GeocodeResult {
@@ -50,6 +68,11 @@ export interface GeocodeResult {
     plusCodeAddress?: string;
     /** Whether plusCode came from the response or was computed locally via Open Location Code. */
     plusCodeSource?: 'payload' | 'derived-olc';
+    /** Primary category when the geocode hit is a POI (e.g. "Restaurant"). */
+    category?: string;
+    /** True when the result is a precise POI match vs. a street/area result. */
+    isPoi?: boolean;
+    raw?: unknown;
 }
 /** Forward or reverse geocode response with best match and alternates. */
 export interface GeocodeResponse {
@@ -57,4 +80,39 @@ export interface GeocodeResponse {
     alternatives: GeocodeResult[];
     raw?: unknown;
 }
+export interface TimezoneOptions {
+    lat: number;
+    lng: number;
+    hl?: string;
+    gl?: string;
+    /**
+     * `offline` (default) — `geo-tz` polygon lookup, ~1 ms, no HTTP.
+     * `geocode` — Google place-row `[14][30]` via reverse/forward geocode.
+     */
+    source?: 'offline' | 'geocode';
+}
+export type TimezoneOffsetSource = 'google-geocode' | 'derived-intl';
+export type TimezoneIdSource = 'geo-tz' | 'google-geocode';
+export interface TimezoneResult {
+    lat: number;
+    lng: number;
+    /** IANA timezone id, e.g. `Asia/Kolkata` / `America/New_York`. */
+    timeZoneId?: string;
+    status: 'OK' | 'NOT_FOUND' | 'ERROR';
+    /**
+     * UTC offset in minutes for the queried instant (default: now).
+     * Derived via `Intl` when not present in Google's payload — see `offsetSource`.
+     */
+    rawOffsetMinutes?: number;
+    /** DST offset in minutes (derived via `Intl`; Google payload does not expose this). */
+    dstOffsetMinutes?: number;
+    /** Total offset = raw + dst, in minutes east of UTC. */
+    totalOffsetMinutes?: number;
+    offsetSource?: TimezoneOffsetSource;
+    /** Where the IANA id came from. */
+    timezoneSource?: TimezoneIdSource;
+    /** Whether DST is active at the queried instant (derived via `Intl`). */
+    isDst?: boolean;
+    error?: string;
+}
 //# sourceMappingURL=geocode.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"geocode.d.ts","sourceRoot":"","sources":["../../src/types/geocode.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,+DAA+D;AAC/D,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACvC,qHAAqH;IACrH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8FAA8F;IAC9F,cAAc,CAAC,EAAE,SAAS,GAAG,aAAa,CAAC;CAC5C;AAED,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf"}
+{"version":3,"file":"geocode.d.ts","sourceRoot":"","sources":["../../src/types/geocode.ts"],"names":[],"mappings":"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"}

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"}