googlemaps-kit 0.1.0

package/dist/parsers/shared.js

@@ -0,0 +1,147 @@
+import { parseReviewCountLabel } from '../utils/feature-id.js';
+import { safeGet } from '../utils/safe-get.js';
+/** Parse review count from place/search rating block at index [4]. */
+export function parseReviewCountFromBlock(block) {
+    if (!Array.isArray(block))
+        return undefined;
+    const direct = block[8];
+    if (typeof direct === 'number' && Number.isFinite(direct)) {
+        return direct;
+    }
+    const label = block[3];
+    if (Array.isArray(label)) {
+        const fromLabel = parseReviewCountLabel(label[1]);
+        if (fromLabel != null)
+            return fromLabel;
+    }
+    return undefined;
+}
+export function parseReviewCount(placeData) {
+    return parseReviewCountFromBlock(placeData[4]);
+}
+export function parsePriceRange(block) {
+    if (!Array.isArray(block))
+        return undefined;
+    const direct = block[2];
+    if (typeof direct === 'string' && direct.length > 0)
+        return direct;
+    const alt = block[10];
+    if (typeof alt === 'string' && alt.length > 0)
+        return alt;
+    return undefined;
+}
+export function parsePriceLevel(block) {
+    if (!Array.isArray(block))
+        return undefined;
+    const level = block[14];
+    if (typeof level === 'number' && level >= 1 && level <= 4)
+        return level;
+    return undefined;
+}
+export function parseWebsiteFromContact(contact) {
+    if (!Array.isArray(contact))
+        return undefined;
+    const directUrl = contact[0];
+    if (typeof directUrl === 'string' && directUrl.startsWith('http') && !directUrl.includes('google.com')) {
+        return directUrl;
+    }
+    for (const item of contact.slice(0, 12)) {
+        if (typeof item === 'string' && item.includes('/url?q=')) {
+            try {
+                const url = new URL(item, 'https://www.google.com');
+                const q = url.searchParams.get('q');
+                if (q)
+                    return q;
+            }
+            catch {
+                // ignore
+            }
+        }
+        else if (typeof item === 'string' && item.startsWith('http') && !item.includes('google.com')) {
+            return item;
+        }
+    }
+    return undefined;
+}
+export function parsePhone(placeData) {
+    const phoneData = safeGet(placeData, 178);
+    if (!Array.isArray(phoneData) || phoneData.length === 0)
+        return undefined;
+    const inner = phoneData[0];
+    if (Array.isArray(inner) && typeof inner[0] === 'string') {
+        return inner[0];
+    }
+    if (typeof inner === 'string') {
+        return inner;
+    }
+    return safeGet(placeData, 178, 0, 0);
+}
+export function normalizeHoursText(value) {
+    return value.replace(/\u202f/g, ' ').replace(/\u2013/g, '-').replace(/\u2014/g, '-').trim();
+}
+/**
+ * Convert user-authored HTML into plain text.
+ *
+ * Google returns review bodies with markup intact — `<br>` for the author's line breaks
+ * and HTML entities — so callers rendering the text elsewhere would otherwise leak tags.
+ */
+export function htmlToPlainText(value) {
+    return value
+        .replace(/<br\s*\/?>/gi, '\n')
+        .replace(/<\/p>\s*<p[^>]*>/gi, '\n\n')
+        .replace(/<[^>]+>/g, '')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&amp;/g, '&')
+        .replace(/[ \t]+/g, ' ')
+        .replace(/\n{3,}/g, '\n\n')
+        .replace(/[ \t]*\n[ \t]*/g, '\n')
+        .trim();
+}
+const DAY_NAME_RE = /^(monday|tuesday|wednesday|thursday|friday|saturday|sunday)$/i;
+/** Collect day-hour entries from nested Maps hours protobuf trees. */
+export function collectHourDayEntries(hoursRoot, maxDepth = 6) {
+    const entries = [];
+    function walk(node, depth) {
+        if (!Array.isArray(node) || depth > maxDepth)
+            return;
+        if (node.length >= 4 &&
+            typeof node[0] === 'string' &&
+            DAY_NAME_RE.test(node[0])) {
+            entries.push(node);
+            return;
+        }
+        for (const item of node) {
+            walk(item, depth + 1);
+        }
+    }
+    walk(hoursRoot, 0);
+    return entries;
+}
+export function parseOpenStatus(hoursRoot) {
+    if (!Array.isArray(hoursRoot))
+        return undefined;
+    function walk(node, depth = 0) {
+        if (depth > 8)
+            return undefined;
+        if (typeof node === 'string') {
+            if (/^(open|closed)\b/i.test(node) || /open ·|closed ·/i.test(node)) {
+                return normalizeHoursText(node);
+            }
+            return undefined;
+        }
+        if (!Array.isArray(node))
+            return undefined;
+        for (const item of node) {
+            const found = walk(item, depth + 1);
+            if (found)
+                return found;
+        }
+        return undefined;
+    }
+    return walk(hoursRoot);
+}
+//# sourceMappingURL=shared.js.map

package/dist/parsers/shared.js.map

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

package/dist/parsers/suggest.d.ts

@@ -0,0 +1,10 @@
+import type { SuggestResult } from '../types/suggest.js';
+/**
+ * Extract omnibox suggestions from a parsed (or chunked-wrapped) suggest response.
+ *
+ * Defensive against sparse null-filled arrays — missing indices never throw.
+ */
+export declare function extractSuggestions(data: unknown, options?: {
+    raw?: boolean;
+}): SuggestResult;
+//# sourceMappingURL=suggest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../src/parsers/suggest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAA8B,MAAM,qBAAqB,CAAC;AAsIrF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,aAAa,CAmC5F"}

package/dist/parsers/suggest.js

@@ -0,0 +1,153 @@
+import { htmlToPlainText } from './shared.js';
+import { parseGoogleResponse } from '../utils/response-parser.js';
+import { safeGet } from '../utils/safe-get.js';
+function isChunkedWrapper(value) {
+    return (value != null &&
+        typeof value === 'object' &&
+        !Array.isArray(value) &&
+        typeof value.d === 'string' &&
+        'c' in value);
+}
+/** Unwrap `{c,d}` chunked envelopes emitted when `tch=1` is sent. */
+function unwrapSuggestPayload(data) {
+    if (isChunkedWrapper(data)) {
+        return parseGoogleResponse(data.d);
+    }
+    return data;
+}
+function asPlainText(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return undefined;
+    return htmlToPlainText(trimmed);
+}
+/**
+ * Decode the wrapped place id at S[0][27]: `BChIJ…=` → `ChIJ…`.
+ */
+function parseWrappedPlaceId(value) {
+    if (typeof value !== 'string' || !value)
+        return undefined;
+    let id = value.trim();
+    if (id.startsWith('B') && id.endsWith('=')) {
+        id = id.slice(1, -1);
+    }
+    else if (id.endsWith('=')) {
+        id = id.slice(0, -1);
+    }
+    if (/^ChIJ|^GhIJ|^EhIJ/.test(id)) {
+        return id;
+    }
+    return undefined;
+}
+function parseHexId(value) {
+    if (typeof value !== 'string' || !value.includes(':0x'))
+        return undefined;
+    return value;
+}
+function parseFeatureId(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    if (value.startsWith('/m/') || value.startsWith('/g/'))
+        return value;
+    return undefined;
+}
+function parseThumbnail(payload) {
+    // Brand/chain logo URLs live at [23][6][0] (verified on starbucks suggest probe).
+    // Legacy parsers also checked [24][6][0] — kept as fallback.
+    for (const blockIndex of [23, 24]) {
+        const direct = safeGet(payload, blockIndex, 6, 0);
+        if (typeof direct === 'string' && direct.startsWith('http'))
+            return direct;
+        const nested = safeGet(payload, blockIndex, 6);
+        if (Array.isArray(nested)) {
+            for (const item of nested) {
+                if (typeof item === 'string' && item.startsWith('http'))
+                    return item;
+            }
+        }
+    }
+    return undefined;
+}
+function classifyKind(hexId, placeId) {
+    if (hexId || placeId)
+        return 'place';
+    return 'query';
+}
+function suggestionKey(suggestion) {
+    return [
+        suggestion.kind,
+        suggestion.text,
+        suggestion.primaryText ?? '',
+        suggestion.secondaryText ?? '',
+        suggestion.hexId ?? '',
+        suggestion.placeId ?? '',
+    ].join('\0');
+}
+function parseSuggestionPayload(payload) {
+    if (!Array.isArray(payload))
+        return undefined;
+    const fullText = asPlainText(safeGet(payload, 0, 0));
+    const primaryText = asPlainText(safeGet(payload, 1, 0));
+    const secondaryText = asPlainText(safeGet(payload, 2, 0));
+    const placeId = parseWrappedPlaceId(safeGet(payload, 0, 27));
+    const hexFrom13 = parseHexId(safeGet(payload, 13, 0, 0));
+    const hexFrom14 = parseHexId(safeGet(payload, 14, 1));
+    const hexId = hexFrom13 ?? hexFrom14;
+    const featureId = parseFeatureId(safeGet(payload, 13, 0, 10));
+    const thumbnailUrl = parseThumbnail(payload);
+    const countryCode = asPlainText(payload[34]);
+    const text = fullText ?? primaryText;
+    if (!text)
+        return undefined;
+    const kind = classifyKind(hexId, placeId);
+    return {
+        kind,
+        text,
+        primaryText,
+        secondaryText,
+        placeId,
+        hexId,
+        featureId,
+        thumbnailUrl,
+        countryCode: countryCode && countryCode.length === 2 ? countryCode.toUpperCase() : undefined,
+    };
+}
+/**
+ * Extract omnibox suggestions from a parsed (or chunked-wrapped) suggest response.
+ *
+ * Defensive against sparse null-filled arrays — missing indices never throw.
+ */
+export function extractSuggestions(data, options) {
+    const unwrapped = unwrapSuggestPayload(data);
+    const root = Array.isArray(unwrapped) ? unwrapped : [];
+    const query = asPlainText(safeGet(root, 0, 0)) ?? '';
+    const sessionToken = asPlainText(root[7]);
+    const entries = safeGet(root, 0, 1);
+    const suggestions = [];
+    const seen = new Set();
+    if (Array.isArray(entries)) {
+        for (const entry of entries) {
+            const payload = safeGet(entry, 22);
+            const suggestion = parseSuggestionPayload(payload);
+            if (!suggestion)
+                continue;
+            const key = suggestionKey(suggestion);
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            suggestions.push(suggestion);
+        }
+    }
+    const result = {
+        query,
+        suggestions,
+        sessionToken,
+    };
+    if (options?.raw) {
+        result.raw = unwrapped;
+    }
+    return result;
+}
+//# sourceMappingURL=suggest.js.map

package/dist/parsers/suggest.js.map

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

package/dist/parsers/tiles.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Parse protobuf-wrapped basemap tile responses.
+ *
+ * `/maps/vt/proto` and `/maps/vt/stream` return `application/x-octet-stream` bodies
+ * where a PNG image is embedded inside a protobuf envelope. The PNG magic `\x89PNG`
+ * appears after a short protobuf header; locate it and slice through the IEND chunk.
+ */
+/** Locate the PNG signature inside a protobuf-wrapped tile body. */
+export declare function findPngOffset(data: Uint8Array): number;
+/**
+ * Extract raw PNG bytes from a protobuf-wrapped tile response.
+ * Returns null when no valid PNG envelope is found.
+ */
+export declare function unwrapTilePng(data: Uint8Array): Uint8Array | null;
+/** Read PNG width/height from the IHDR chunk (first chunk after the 8-byte signature). */
+export declare function readPngDimensions(data: Uint8Array): {
+    width: number;
+    height: number;
+} | null;
+/** True when the buffer contains a PNG signature (raw or protobuf-wrapped). */
+export declare function isPngBytes(data: Uint8Array): boolean;
+//# sourceMappingURL=tiles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tiles.d.ts","sourceRoot":"","sources":["../../src/parsers/tiles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAKtD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAmBjE;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAc5F;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAGpD"}

package/dist/parsers/tiles.js

@@ -0,0 +1,70 @@
+/**
+ * Parse protobuf-wrapped basemap tile responses.
+ *
+ * `/maps/vt/proto` and `/maps/vt/stream` return `application/x-octet-stream` bodies
+ * where a PNG image is embedded inside a protobuf envelope. The PNG magic `\x89PNG`
+ * appears after a short protobuf header; locate it and slice through the IEND chunk.
+ */
+const PNG_SIGNATURE = new Uint8Array([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+const IEND_TYPE = new Uint8Array([0x49, 0x45, 0x4e, 0x44]); // "IEND"
+const IEND_TRAILER = new Uint8Array([0xae, 0x42, 0x60, 0x82]);
+function bytesEqual(a, offset, pattern) {
+    if (offset + pattern.length > a.length)
+        return false;
+    for (let i = 0; i < pattern.length; i++) {
+        if (a[offset + i] !== pattern[i])
+            return false;
+    }
+    return true;
+}
+/** Locate the PNG signature inside a protobuf-wrapped tile body. */
+export function findPngOffset(data) {
+    for (let i = 0; i <= data.length - PNG_SIGNATURE.length; i++) {
+        if (bytesEqual(data, i, PNG_SIGNATURE))
+            return i;
+    }
+    return -1;
+}
+/**
+ * Extract raw PNG bytes from a protobuf-wrapped tile response.
+ * Returns null when no valid PNG envelope is found.
+ */
+export function unwrapTilePng(data) {
+    const start = findPngOffset(data);
+    if (start < 0)
+        return null;
+    for (let i = start + 8; i <= data.length - 8; i++) {
+        if (bytesEqual(data, i, IEND_TYPE) &&
+            i >= 4 &&
+            data[i - 4] === 0 &&
+            data[i - 3] === 0 &&
+            data[i - 2] === 0 &&
+            data[i - 1] === 0 &&
+            bytesEqual(data, i + 4, IEND_TRAILER)) {
+            return data.slice(start, i + 8);
+        }
+    }
+    return null;
+}
+/** Read PNG width/height from the IHDR chunk (first chunk after the 8-byte signature). */
+export function readPngDimensions(data) {
+    if (data.length < 24 || !bytesEqual(data, 0, PNG_SIGNATURE))
+        return null;
+    const ihdrOffset = 8;
+    if (!bytesEqual(data, ihdrOffset + 4, new Uint8Array([0x49, 0x48, 0x44, 0x52]))) {
+        return null;
+    }
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const width = view.getUint32(ihdrOffset + 8, false);
+    const height = view.getUint32(ihdrOffset + 12, false);
+    if (width === 0 || height === 0)
+        return null;
+    return { width, height };
+}
+/** True when the buffer contains a PNG signature (raw or protobuf-wrapped). */
+export function isPngBytes(data) {
+    if (bytesEqual(data, 0, PNG_SIGNATURE))
+        return true;
+    return findPngOffset(data) >= 0;
+}
+//# sourceMappingURL=tiles.js.map

package/dist/parsers/tiles.js.map

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

package/dist/parsers/timezone-geocode.d.ts

@@ -0,0 +1,20 @@
+import type { GeocodeResult } from '../types/geocode.js';
+import type { TimezoneOffsetSource, TimezoneResult } from '../types/timezone.js';
+/** Pick the first IANA timezone from geocode rows. */
+export declare function extractTimezoneFromGeocodeResults(results: Array<GeocodeResult | null | undefined>): string | undefined;
+/**
+ * Build forward-geocode queries from a reverse hit's plus-code address.
+ * e.g. `46J5+FPF Sydney, New South Wales, Australia` → `Sydney, Australia`.
+ */
+export declare function localityQueriesFromReverseHit(hit: GeocodeResult): string[];
+export interface DerivedTimezoneOffset {
+    rawOffsetMinutes: number;
+    dstOffsetMinutes: number;
+    totalOffsetMinutes: number;
+    isDst: boolean;
+    offsetSource: TimezoneOffsetSource;
+}
+/** Derive UTC offset for an IANA timezone at `at` using Intl (not from Google payload). */
+export declare function deriveTimezoneOffset(timeZoneId: string, at?: Date): DerivedTimezoneOffset | undefined;
+export declare function buildTimezoneResult(lat: number, lng: number, timeZoneId: string | undefined, at?: Date): TimezoneResult;
+//# sourceMappingURL=timezone-geocode.d.ts.map

package/dist/parsers/timezone-geocode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone-geocode.d.ts","sourceRoot":"","sources":["../../src/parsers/timezone-geocode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAIjF,sDAAsD;AACtD,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,KAAK,CAAC,aAAa,GAAG,IAAI,GAAG,SAAS,CAAC,GAC/C,MAAM,GAAG,SAAS,CAKpB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,EAAE,CAmB1E;AAED,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,oBAAoB,CAAC;CACpC;AAED,2FAA2F;AAC3F,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,EAAE,GAAE,IAAiB,GACpB,qBAAqB,GAAG,SAAS,CAiCnC;AAgBD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,EAAE,GAAE,IAAiB,GACpB,cAAc,CAiBhB"}

package/dist/parsers/timezone-geocode.js

@@ -0,0 +1,96 @@
+const PLUS_CODE_PREFIX_RE = /^[23456789CFGHJMPQRVWX]{4,8}\+[23456789CFGHJMPQRVWX]{2,3}\s+/i;
+/** Pick the first IANA timezone from geocode rows. */
+export function extractTimezoneFromGeocodeResults(results) {
+    for (const row of results) {
+        if (row?.timezone && row.timezone.includes('/'))
+            return row.timezone;
+    }
+    return undefined;
+}
+/**
+ * Build forward-geocode queries from a reverse hit's plus-code address.
+ * e.g. `46J5+FPF Sydney, New South Wales, Australia` → `Sydney, Australia`.
+ */
+export function localityQueriesFromReverseHit(hit) {
+    const raw = hit.plusCodeAddress ?? hit.formattedAddress;
+    if (!raw)
+        return [];
+    const withoutCode = raw.replace(PLUS_CODE_PREFIX_RE, '').trim();
+    if (!withoutCode)
+        return [];
+    const parts = withoutCode.split(',').map((part) => part.trim()).filter(Boolean);
+    const queries = new Set();
+    queries.add(withoutCode);
+    if (parts.length >= 2) {
+        queries.add(`${parts[0]}, ${parts[parts.length - 1]}`);
+    }
+    if (parts.length >= 3) {
+        queries.add(`${parts[0]}, ${parts[1]}, ${parts[parts.length - 1]}`);
+    }
+    return [...queries];
+}
+/** Derive UTC offset for an IANA timezone at `at` using Intl (not from Google payload). */
+export function deriveTimezoneOffset(timeZoneId, at = new Date()) {
+    try {
+        const parts = new Intl.DateTimeFormat('en-US', {
+            timeZone: timeZoneId,
+            timeZoneName: 'longOffset',
+        }).formatToParts(at);
+        const offsetText = parts.find((part) => part.type === 'timeZoneName')?.value;
+        const match = offsetText?.match(/GMT([+-])(\d{1,2})(?::(\d{2}))?/i);
+        if (!match)
+            return undefined;
+        const sign = match[1] === '-' ? -1 : 1;
+        const hours = Number.parseInt(match[2], 10);
+        const minutes = match[3] ? Number.parseInt(match[3], 10) : 0;
+        const totalOffsetMinutes = sign * (hours * 60 + minutes);
+        const jan = new Date(Date.UTC(at.getUTCFullYear(), 0, 1));
+        const jul = new Date(Date.UTC(at.getUTCFullYear(), 6, 1));
+        const janOffset = deriveTotalOffsetMinutes(timeZoneId, jan);
+        const julOffset = deriveTotalOffsetMinutes(timeZoneId, jul);
+        const rawOffsetMinutes = Math.min(janOffset, julOffset);
+        const dstOffsetMinutes = totalOffsetMinutes - rawOffsetMinutes;
+        return {
+            rawOffsetMinutes,
+            dstOffsetMinutes,
+            totalOffsetMinutes,
+            isDst: dstOffsetMinutes !== 0,
+            offsetSource: 'derived-intl',
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function deriveTotalOffsetMinutes(timeZoneId, at) {
+    const parts = new Intl.DateTimeFormat('en-US', {
+        timeZone: timeZoneId,
+        timeZoneName: 'longOffset',
+    }).formatToParts(at);
+    const offsetText = parts.find((part) => part.type === 'timeZoneName')?.value;
+    const match = offsetText?.match(/GMT([+-])(\d{1,2})(?::(\d{2}))?/i);
+    if (!match)
+        return 0;
+    const sign = match[1] === '-' ? -1 : 1;
+    const hours = Number.parseInt(match[2], 10);
+    const minutes = match[3] ? Number.parseInt(match[3], 10) : 0;
+    return sign * (hours * 60 + minutes);
+}
+export function buildTimezoneResult(lat, lng, timeZoneId, at = new Date()) {
+    if (!timeZoneId) {
+        return { lat, lng, status: 'NOT_FOUND' };
+    }
+    const derived = deriveTimezoneOffset(timeZoneId, at);
+    return {
+        lat,
+        lng,
+        timeZoneId,
+        status: 'OK',
+        rawOffsetMinutes: derived?.rawOffsetMinutes,
+        dstOffsetMinutes: derived?.dstOffsetMinutes,
+        totalOffsetMinutes: derived?.totalOffsetMinutes,
+        isDst: derived?.isDst,
+        offsetSource: derived?.offsetSource,
+    };
+}
+//# sourceMappingURL=timezone-geocode.js.map

package/dist/parsers/timezone-geocode.js.map

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

package/dist/parsers/traffic.d.ts

@@ -0,0 +1,10 @@
+import type { AreaTrafficReport } from '../types/traffic.js';
+/**
+ * Parse GetAreaTraffic batchexecute response.
+ * Verified paths (inner payload): summary [19][0][1][0], detail [20][0][1][0], icons [14][4][*][0].
+ * Some responses wrap payload at [1] with hasTraffic flag at [0].
+ */
+export declare function extractAreaTraffic(data: unknown, options?: {
+    raw?: boolean;
+}): AreaTrafficReport;
+//# sourceMappingURL=traffic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"traffic.d.ts","sourceRoot":"","sources":["../../src/parsers/traffic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAa7D;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,iBAAiB,CAyBhG"}

package/dist/parsers/traffic.js

@@ -0,0 +1,38 @@
+import { safeGet } from '../utils/safe-get.js';
+import { parseBatchPayload } from '../rpc/batch-rpc.js';
+function resolveTrafficRoot(root) {
+    const inner = safeGet(root, 1);
+    if (inner != null && safeGet(inner, 19, 0, 1, 0)) {
+        return inner;
+    }
+    return root;
+}
+/**
+ * Parse GetAreaTraffic batchexecute response.
+ * Verified paths (inner payload): summary [19][0][1][0], detail [20][0][1][0], icons [14][4][*][0].
+ * Some responses wrap payload at [1] with hasTraffic flag at [0].
+ */
+export function extractAreaTraffic(data, options) {
+    const root = parseBatchPayload(data);
+    const payload = resolveTrafficRoot(root);
+    const report = {
+        hasTraffic: safeGet(root, 0) === true || safeGet(payload, 0) === true,
+        raw: options?.raw ? root : undefined,
+    };
+    report.severity = safeGet(payload, 8) ?? undefined;
+    const iconBlock = safeGet(payload, 14, 4);
+    if (Array.isArray(iconBlock)) {
+        const urls = [];
+        for (const item of iconBlock) {
+            const url = safeGet(item, 0);
+            if (url)
+                urls.push(url);
+        }
+        if (urls.length > 0)
+            report.iconUrls = urls;
+    }
+    report.summary = safeGet(payload, 19, 0, 1, 0);
+    report.detail = safeGet(payload, 20, 0, 1, 0);
+    return report;
+}
+//# sourceMappingURL=traffic.js.map

package/dist/parsers/traffic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traffic.js","sourceRoot":"","sources":["../../src/parsers/traffic.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,SAAS,kBAAkB,CAAC,IAAY;IACtC,MAAM,KAAK,GAAG,OAAO,CAAS,IAAI,EAAE,CAAC,CAAC,CAAC;IACvC,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,CAAS,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAa,EAAE,OAA2B;IAC3E,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAEzC,MAAM,MAAM,GAAsB;QAChC,UAAU,EAAE,OAAO,CAAU,IAAI,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,OAAO,CAAU,OAAO,EAAE,CAAC,CAAC,KAAK,IAAI;QACvF,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;KACrC,CAAC;IAEF,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAS,OAAO,EAAE,CAAC,CAAC,IAAI,SAAS,CAAC;IAE3D,MAAM,SAAS,GAAG,OAAO,CAAW,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACpD,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,OAAO,CAAS,IAAI,EAAE,CAAC,CAAC,CAAC;YACrC,IAAI,GAAG;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,OAAO,GAAG,OAAO,CAAS,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACvD,MAAM,CAAC,MAAM,GAAG,OAAO,CAAS,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAEtD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/parsers/transit.d.ts

@@ -0,0 +1,12 @@
+import type { TransitStationBoard } from '../types/transit.js';
+import type { PlaceDataNode } from '../types/protobuf.js';
+/**
+ * Parse transit station departure boards from place preview placeData[62].
+ *
+ * Verified on King's Cross (2026-07-31): mode tabs at [62][1][*][1], departure rows at
+ * [62][1][mode][2][*]. Per row: headsign [1][0][0], time block [1][0][3][0][0][0]
+ * (unix, tz, label), trip id [1][0][3][0][0][7], platform [1][0][3][0][0][8],
+ * line hex [4], operator/colour [5][1][1].
+ */
+export declare function extractTransitStationBoard(placeData: PlaceDataNode): TransitStationBoard | undefined;
+//# sourceMappingURL=transit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transit.d.ts","sourceRoot":"","sources":["../../src/parsers/transit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAU,MAAM,sBAAsB,CAAC;AAGlE;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,aAAa,GAAG,mBAAmB,GAAG,SAAS,CAiCpG"}