googlemaps-kit 0.1.0

package/dist/utils/encoded-polyline.js

@@ -0,0 +1,67 @@
+/**
+ * Decode Google's standard encoded polyline (precision 5).
+ * Algorithm: https://developers.google.com/maps/documentation/utilities/polylinealgorithm
+ */
+export function decodeEncodedPolyline(encoded, precision = 5) {
+    const coordinates = [];
+    let index = 0;
+    let lat = 0;
+    let lng = 0;
+    const factor = 10 ** precision;
+    while (index < encoded.length) {
+        let shift = 0;
+        let result = 0;
+        let byte;
+        do {
+            byte = encoded.charCodeAt(index++) - 63;
+            result |= (byte & 0x1f) << shift;
+            shift += 5;
+        } while (byte >= 0x20);
+        const deltaLat = (result & 1) !== 0 ? ~(result >> 1) : result >> 1;
+        lat += deltaLat;
+        shift = 0;
+        result = 0;
+        do {
+            byte = encoded.charCodeAt(index++) - 63;
+            result |= (byte & 0x1f) << shift;
+            shift += 5;
+        } while (byte >= 0x20);
+        const deltaLng = (result & 1) !== 0 ? ~(result >> 1) : result >> 1;
+        lng += deltaLng;
+        coordinates.push({ lat: lat / factor, lng: lng / factor });
+    }
+    return coordinates;
+}
+/** Encode coordinates to Google's standard encoded polyline (precision 5). */
+export function encodePolyline(points, precision = 5) {
+    const factor = 10 ** precision;
+    let output = '';
+    let prevLat = 0;
+    let prevLng = 0;
+    for (const point of points) {
+        const lat = Math.round(point.lat * factor);
+        const lng = Math.round(point.lng * factor);
+        output += encodeSigned(lat - prevLat);
+        output += encodeSigned(lng - prevLng);
+        prevLat = lat;
+        prevLng = lng;
+    }
+    return output;
+}
+function encodeSigned(value) {
+    let signed = value << 1;
+    if (value < 0)
+        signed = ~signed;
+    return encodeUnsigned(signed);
+}
+function encodeUnsigned(value) {
+    let remaining = value;
+    let output = '';
+    while (remaining >= 0x20) {
+        output += String.fromCharCode((0x20 | (remaining & 0x1f)) + 63);
+        remaining >>= 5;
+    }
+    output += String.fromCharCode(remaining + 63);
+    return output;
+}
+//# sourceMappingURL=encoded-polyline.js.map

package/dist/utils/encoded-polyline.js.map

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

package/dist/utils/feature-id.d.ts

@@ -0,0 +1,2 @@
+export declare function parseReviewCountLabel(value: unknown): number | undefined;
+//# sourceMappingURL=feature-id.d.ts.map

package/dist/utils/feature-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-id.d.ts","sourceRoot":"","sources":["../../src/utils/feature-id.ts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAOxE"}

package/dist/utils/feature-id.js

@@ -0,0 +1,11 @@
+export function parseReviewCountLabel(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string') {
+        const match = value.match(/([\d,]+)/);
+        if (match)
+            return parseInt(match[1].replace(/,/g, ''), 10);
+    }
+    return undefined;
+}
+//# sourceMappingURL=feature-id.js.map

package/dist/utils/feature-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-id.js","sourceRoot":"","sources":["../../src/utils/feature-id.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,KAAK;YAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/geo.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Google Maps viewport altitude ↔ zoom conversion.
+ * Reverse-engineered from Maps JS (see SerpAPI pagination article).
+ */
+/** Convert map zoom level to viewport altitude (`!1d` in search pb). */
+export declare function altitudeFromZoom(zoom: number, latitude: number): number;
+/** Convert viewport altitude to approximate zoom level. */
+export declare function zoomFromAltitude(altitude: number, latitude: number): number;
+/** Default viewport distance for local search (~5km). */
+export declare function defaultViewportDist(lat: number, zoom?: number): number;
+/** Web Mercator tile indices, the coordinate space Street View coverage tiles use. */
+export declare function webMercatorTile(lat: number, lng: number, zoom: number): {
+    x: number;
+    y: number;
+};
+/** Great-circle distance in metres, used to rank panoramas by proximity. */
+export declare function haversineMeters(lat1: number, lng1: number, lat2: number, lng2: number): number;
+//# sourceMappingURL=geo.d.ts.map

package/dist/utils/geo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo.d.ts","sourceRoot":"","sources":["../../src/utils/geo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI3E;AAED,yDAAyD;AACzD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,MAAM,CAElE;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAO1B;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,CAQR"}

package/dist/utils/geo.js

@@ -0,0 +1,40 @@
+/**
+ * Google Maps viewport altitude ↔ zoom conversion.
+ * Reverse-engineered from Maps JS (see SerpAPI pagination article).
+ */
+const EARTH_RADIUS_METERS = 6_371_010;
+const TILE_SIZE = 256;
+const SCREEN_PIXEL_HEIGHT = 768;
+const RADIUS_X_PIXEL_HEIGHT = 27.3611 * EARTH_RADIUS_METERS * SCREEN_PIXEL_HEIGHT;
+/** Convert map zoom level to viewport altitude (`!1d` in search pb). */
+export function altitudeFromZoom(zoom, latitude) {
+    return (RADIUS_X_PIXEL_HEIGHT * Math.cos((latitude * Math.PI) / 180)) / (2 ** zoom * TILE_SIZE);
+}
+/** Convert viewport altitude to approximate zoom level. */
+export function zoomFromAltitude(altitude, latitude) {
+    const ratio = (RADIUS_X_PIXEL_HEIGHT * Math.cos((latitude * Math.PI) / 180)) / (TILE_SIZE * altitude);
+    return Math.log2(ratio);
+}
+/** Default viewport distance for local search (~5km). */
+export function defaultViewportDist(lat, zoom = 15) {
+    return altitudeFromZoom(zoom, lat);
+}
+/** Web Mercator tile indices, the coordinate space Street View coverage tiles use. */
+export function webMercatorTile(lat, lng, zoom) {
+    const scale = 2 ** zoom;
+    const latRad = (lat * Math.PI) / 180;
+    return {
+        x: Math.floor(((lng + 180) / 360) * scale),
+        y: Math.floor(((1 - Math.log(Math.tan(latRad) + 1 / Math.cos(latRad)) / Math.PI) / 2) * scale),
+    };
+}
+/** Great-circle distance in metres, used to rank panoramas by proximity. */
+export function haversineMeters(lat1, lng1, lat2, lng2) {
+    const toRad = (deg) => (deg * Math.PI) / 180;
+    const dLat = toRad(lat2 - lat1);
+    const dLng = toRad(lng2 - lng1);
+    const a = Math.sin(dLat / 2) ** 2 +
+        Math.cos(toRad(lat1)) * Math.cos(toRad(lat2)) * Math.sin(dLng / 2) ** 2;
+    return 2 * EARTH_RADIUS_METERS * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+}
+//# sourceMappingURL=geo.js.map

package/dist/utils/geo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo.js","sourceRoot":"","sources":["../../src/utils/geo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,mBAAmB,GAAG,SAAS,CAAC;AACtC,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,MAAM,qBAAqB,GAAG,OAAO,GAAG,mBAAmB,GAAG,mBAAmB,CAAC;AAElF,wEAAwE;AACxE,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAgB;IAC7D,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,GAAG,SAAS,CAAC,CAAC;AAClG,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,QAAgB;IACjE,MAAM,KAAK,GACT,CAAC,qBAAqB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,GAAG,QAAQ,CAAC,CAAC;IAC1F,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,mBAAmB,CAAC,GAAW,EAAE,IAAI,GAAG,EAAE;IACxD,OAAO,gBAAgB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,eAAe,CAC7B,GAAW,EACX,GAAW,EACX,IAAY;IAEZ,MAAM,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC;IACxB,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;IACrC,OAAO;QACL,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC;QAC1C,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;KAC/F,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,IAAY;IAEZ,MAAM,KAAK,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;IAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAChC,MAAM,CAAC,GACL,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,mBAAmB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC"}

package/dist/utils/ids.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Convert between Google Maps place identifier formats.
+ *
+ * - Feature ID (hex): `0x808fb73b6141f7b3:0x109239be3293d9ca`
+ * - Place ID (ChIJ): base64url-encoded protobuf of two uint64 values
+ * - Ludocid: decimal representation of the low 64 bits
+ */
+export interface FeatureIdParts {
+    hi: bigint;
+    lo: bigint;
+}
+/** Parse hex feature ID `0xHI:0xLO` into uint64 pair. */
+export declare function parseFeatureId(featureId: string): FeatureIdParts;
+/** Encode uint64 pair as hex feature ID. */
+export declare function toFeatureId(hi: bigint, lo: bigint): string;
+/** Decode ChIJ... place ID to feature ID parts. */
+export declare function placeIdToFeatureParts(placeId: string): FeatureIdParts;
+export declare function placeIdToFeatureId(placeId: string): string;
+export declare function featureIdToLudocid(featureId: string): string;
+/** Encode feature ID parts to ChIJ place ID (simplified protobuf fixed64 encoding). */
+export declare function featurePartsToPlaceId(parts: FeatureIdParts): string;
+export declare function featureIdToPlaceId(featureId: string): string;
+//# sourceMappingURL=ids.d.ts.map

package/dist/utils/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/utils/ids.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AASD,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAShE;AAED,4CAA4C;AAC5C,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,mDAAmD;AACnD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAyBrE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAcnE;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/utils/ids.js

@@ -0,0 +1,81 @@
+/**
+ * Convert between Google Maps place identifier formats.
+ *
+ * - Feature ID (hex): `0x808fb73b6141f7b3:0x109239be3293d9ca`
+ * - Place ID (ChIJ): base64url-encoded protobuf of two uint64 values
+ * - Ludocid: decimal representation of the low 64 bits
+ */
+function base64UrlDecode(input) {
+    let str = input.replace(/-/g, '+').replace(/_/g, '/');
+    while (str.length % 4)
+        str += '=';
+    const binary = Buffer.from(str, 'base64');
+    return new Uint8Array(binary);
+}
+/** Parse hex feature ID `0xHI:0xLO` into uint64 pair. */
+export function parseFeatureId(featureId) {
+    const match = featureId.match(/^0x([0-9a-f]+):0x([0-9a-f]+)$/i);
+    if (!match) {
+        throw new Error(`Invalid feature ID format: ${featureId}`);
+    }
+    return {
+        hi: BigInt(`0x${match[1]}`),
+        lo: BigInt(`0x${match[2]}`),
+    };
+}
+/** Encode uint64 pair as hex feature ID. */
+export function toFeatureId(hi, lo) {
+    return `0x${hi.toString(16)}:0x${lo.toString(16)}`;
+}
+/** Decode ChIJ... place ID to feature ID parts. */
+export function placeIdToFeatureParts(placeId) {
+    const bytes = base64UrlDecode(placeId);
+    // Protobuf: field 1 (hi) and field 2 (lo) as fixed64
+    let hi = 0n;
+    let lo = 0n;
+    let i = 0;
+    while (i < bytes.length) {
+        const tag = bytes[i];
+        i++;
+        const field = tag >> 3;
+        const wire = tag & 0x7;
+        if (wire === 1 && i + 8 <= bytes.length) {
+            const view = new DataView(bytes.buffer, bytes.byteOffset + i, 8);
+            const value = view.getBigUint64(0, true);
+            i += 8;
+            if (field === 1)
+                hi = value;
+            else if (field === 2)
+                lo = value;
+        }
+        else {
+            break;
+        }
+    }
+    return { hi, lo };
+}
+export function placeIdToFeatureId(placeId) {
+    const { hi, lo } = placeIdToFeatureParts(placeId);
+    return toFeatureId(hi, lo);
+}
+export function featureIdToLudocid(featureId) {
+    const { lo } = parseFeatureId(featureId);
+    return lo.toString(10);
+}
+/** Encode feature ID parts to ChIJ place ID (simplified protobuf fixed64 encoding). */
+export function featurePartsToPlaceId(parts) {
+    const buf = Buffer.alloc(20);
+    let offset = 0;
+    // field 1, wire type 1 (fixed64) = tag 0x09
+    buf.writeUInt8(0x09, offset++);
+    buf.writeBigUInt64LE(parts.hi, offset);
+    offset += 8;
+    // field 2, wire type 1 = tag 0x11
+    buf.writeUInt8(0x11, offset++);
+    buf.writeBigUInt64LE(parts.lo, offset);
+    return buf.toString('base64url');
+}
+export function featureIdToPlaceId(featureId) {
+    return featurePartsToPlaceId(parseFeatureId(featureId));
+}
+//# sourceMappingURL=ids.js.map

package/dist/utils/ids.js.map

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

package/dist/utils/load-env.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Load `.env.local` then `.env` into `process.env` without overwriting existing keys.
+ * Keeps secrets out of git — files are listed in `.gitignore`.
+ */
+/** Idempotent — safe to call from multiple entry points. */
+export declare function loadProjectEnv(cwd?: string): void;
+//# sourceMappingURL=load-env.d.ts.map

package/dist/utils/load-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-env.d.ts","sourceRoot":"","sources":["../../src/utils/load-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2BH,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,GAAG,SAAgB,GAAG,IAAI,CAkBxD"}

package/dist/utils/load-env.js

@@ -0,0 +1,49 @@
+/**
+ * Load `.env.local` then `.env` into `process.env` without overwriting existing keys.
+ * Keeps secrets out of git — files are listed in `.gitignore`.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+function parseEnvFile(content) {
+    const out = {};
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eq = trimmed.indexOf('=');
+        if (eq <= 0)
+            continue;
+        const key = trimmed.slice(0, eq).trim();
+        let value = trimmed.slice(eq + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        out[key] = value;
+    }
+    return out;
+}
+let loaded = false;
+/** Idempotent — safe to call from multiple entry points. */
+export function loadProjectEnv(cwd = process.cwd()) {
+    if (loaded)
+        return;
+    loaded = true;
+    for (const filename of ['.env.local', '.env']) {
+        const path = join(cwd, filename);
+        if (!existsSync(path))
+            continue;
+        try {
+            const vars = parseEnvFile(readFileSync(path, 'utf-8'));
+            for (const [key, value] of Object.entries(vars)) {
+                if (process.env[key] === undefined) {
+                    process.env[key] = value;
+                }
+            }
+        }
+        catch {
+            // Missing or unreadable env files are non-fatal.
+        }
+    }
+}
+//# sourceMappingURL=load-env.js.map

package/dist/utils/load-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-env.js","sourceRoot":"","sources":["../../src/utils/load-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClD,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,EAAE,IAAI,CAAC;YAAE,SAAS;QACtB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,IACE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC9C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAC9C,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,IAAI,MAAM,GAAG,KAAK,CAAC;AAEnB,4DAA4D;AAC5D,MAAM,UAAU,cAAc,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAChD,IAAI,MAAM;QAAE,OAAO;IACnB,MAAM,GAAG,IAAI,CAAC;IAEd,KAAK,MAAM,QAAQ,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QAChC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,YAAY,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;YACvD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;oBACnC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,iDAAiD;QACnD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils/photo-url.d.ts

@@ -0,0 +1,4 @@
+/** Upgrade googleusercontent photo URLs to a larger display size when possible. */
+export declare function normalizePhotoUrl(url: string, minWidth?: number): string;
+export declare function dedupePhotos(urls: string[], max?: number): string[];
+//# sourceMappingURL=photo-url.d.ts.map

package/dist/utils/photo-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photo-url.d.ts","sourceRoot":"","sources":["../../src/utils/photo-url.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,MAAM,CAuBrE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,SAAK,GAAG,MAAM,EAAE,CAa/D"}

package/dist/utils/photo-url.js

@@ -0,0 +1,35 @@
+/** Upgrade googleusercontent photo URLs to a larger display size when possible. */
+export function normalizePhotoUrl(url, minWidth = 800) {
+    if (!url.includes('googleusercontent.com'))
+        return url;
+    let normalized = url.startsWith('//') ? `https:${url}` : url;
+    if (/=s\d+-[a-z]-cc-rp-mo/i.test(normalized) || /=s40-/i.test(normalized)) {
+        return normalized;
+    }
+    if (/=w\d+-h\d+/i.test(normalized)) {
+        return normalized.replace(/=w\d+-h\d+[^/]*/i, `=w${minWidth}-h${Math.round(minWidth * 0.75)}-k-no`);
+    }
+    if (/=s\d+/i.test(normalized)) {
+        return normalized.replace(/=s\d+[^/]*/i, `=s${minWidth}`);
+    }
+    if (!/=[whs]\d+/i.test(normalized) && !normalized.includes('=s')) {
+        const separator = normalized.includes('?') ? '&' : '?';
+        return `${normalized}${separator}w=${minWidth}`;
+    }
+    return normalized;
+}
+export function dedupePhotos(urls, max = 50) {
+    const seen = new Set();
+    const result = [];
+    for (const url of urls) {
+        const base = url.split('=')[0] ?? url;
+        if (seen.has(base))
+            continue;
+        seen.add(base);
+        result.push(normalizePhotoUrl(url));
+        if (result.length >= max)
+            break;
+    }
+    return result;
+}
+//# sourceMappingURL=photo-url.js.map

package/dist/utils/photo-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"photo-url.js","sourceRoot":"","sources":["../../src/utils/photo-url.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,QAAQ,GAAG,GAAG;IAC3D,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QAAE,OAAO,GAAG,CAAC;IAEvD,IAAI,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAE7D,IAAI,uBAAuB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1E,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACnC,OAAO,UAAU,CAAC,OAAO,CAAC,kBAAkB,EAAE,KAAK,QAAQ,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IACtG,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,UAAU,CAAC,OAAO,CAAC,aAAa,EAAE,KAAK,QAAQ,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACjE,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QACvD,OAAO,GAAG,UAAU,GAAG,SAAS,KAAK,QAAQ,EAAE,CAAC;IAClD,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAc,EAAE,GAAG,GAAG,EAAE;IACnD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QACtC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;QACpC,IAAI,MAAM,CAAC,MAAM,IAAI,GAAG;YAAE,MAAM;IAClC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/plus-code.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Open Location Code (Plus Code) encoder — ported from Google's reference implementation.
+ *
+ * Forward geocode hits carry address metadata at placeData[183] but omit the compact
+ * code at [183][2][1][0]; that slot appears on reverse-geocode coordinate hits only.
+ * When coordinates are known, a derived code matches Google's mathematically.
+ */
+/** Encode a full Plus Code from WGS84 coordinates (default 10-digit pair precision). */
+export declare function encodePlusCode(latitude: number, longitude: number, codeLength?: number): string;
+export type PlusCodeSource = 'payload' | 'derived-olc';
+//# sourceMappingURL=plus-code.d.ts.map

package/dist/utils/plus-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plus-code.d.ts","sourceRoot":"","sources":["../../src/utils/plus-code.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkFH,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,SAAmB,GAAG,MAAM,CAGzG;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,aAAa,CAAC"}

package/dist/utils/plus-code.js

@@ -0,0 +1,83 @@
+/**
+ * Open Location Code (Plus Code) encoder — ported from Google's reference implementation.
+ *
+ * Forward geocode hits carry address metadata at placeData[183] but omit the compact
+ * code at [183][2][1][0]; that slot appears on reverse-geocode coordinate hits only.
+ * When coordinates are known, a derived code matches Google's mathematically.
+ */
+const SEPARATOR = '+';
+const SEPARATOR_POSITION = 8;
+const PADDING_CHARACTER = '0';
+const CODE_ALPHABET = '23456789CFGHJMPQRVWX';
+const ENCODING_BASE = CODE_ALPHABET.length;
+const LATITUDE_MAX = 90;
+const LONGITUDE_MAX = 180;
+const PAIR_CODE_LENGTH = 10;
+const MAX_DIGIT_COUNT = 15;
+const GRID_COLUMNS = 4;
+const GRID_ROWS = 5;
+const PAIR_PRECISION = ENCODING_BASE ** 3;
+const GRID_CODE_LENGTH = MAX_DIGIT_COUNT - PAIR_CODE_LENGTH;
+const FINAL_LAT_PRECISION = PAIR_PRECISION * GRID_ROWS ** (MAX_DIGIT_COUNT - PAIR_CODE_LENGTH);
+const FINAL_LNG_PRECISION = PAIR_PRECISION * GRID_COLUMNS ** (MAX_DIGIT_COUNT - PAIR_CODE_LENGTH);
+function locationToIntegers(latitude, longitude) {
+    let latVal = Math.floor(latitude * FINAL_LAT_PRECISION);
+    latVal += LATITUDE_MAX * FINAL_LAT_PRECISION;
+    if (latVal < 0) {
+        latVal = 0;
+    }
+    else if (latVal >= 2 * LATITUDE_MAX * FINAL_LAT_PRECISION) {
+        latVal = 2 * LATITUDE_MAX * FINAL_LAT_PRECISION - 1;
+    }
+    let lngVal = Math.floor(longitude * FINAL_LNG_PRECISION);
+    lngVal += LONGITUDE_MAX * FINAL_LNG_PRECISION;
+    if (lngVal < 0) {
+        lngVal =
+            (lngVal % (2 * LONGITUDE_MAX * FINAL_LNG_PRECISION)) +
+                2 * LONGITUDE_MAX * FINAL_LNG_PRECISION;
+    }
+    else if (lngVal >= 2 * LONGITUDE_MAX * FINAL_LNG_PRECISION) {
+        lngVal = lngVal % (2 * LONGITUDE_MAX * FINAL_LNG_PRECISION);
+    }
+    return [latVal, lngVal];
+}
+function encodeIntegers(latInt, lngInt, codeLength = PAIR_CODE_LENGTH) {
+    const code = new Array(MAX_DIGIT_COUNT + 1);
+    code[SEPARATOR_POSITION] = SEPARATOR;
+    if (codeLength > PAIR_CODE_LENGTH) {
+        for (let i = MAX_DIGIT_COUNT - PAIR_CODE_LENGTH; i >= 1; i--) {
+            const latDigit = latInt % GRID_ROWS;
+            const lngDigit = lngInt % GRID_COLUMNS;
+            const ndx = latDigit * GRID_COLUMNS + lngDigit;
+            code[SEPARATOR_POSITION + 2 + i] = CODE_ALPHABET[ndx];
+            latInt = Math.floor(latInt / GRID_ROWS);
+            lngInt = Math.floor(lngInt / GRID_COLUMNS);
+        }
+    }
+    else {
+        latInt = Math.floor(latInt / GRID_ROWS ** GRID_CODE_LENGTH);
+        lngInt = Math.floor(lngInt / GRID_COLUMNS ** GRID_CODE_LENGTH);
+    }
+    code[SEPARATOR_POSITION + 1] = CODE_ALPHABET[latInt % ENCODING_BASE];
+    code[SEPARATOR_POSITION + 2] = CODE_ALPHABET[lngInt % ENCODING_BASE];
+    latInt = Math.floor(latInt / ENCODING_BASE);
+    lngInt = Math.floor(lngInt / ENCODING_BASE);
+    for (let i = PAIR_CODE_LENGTH / 2 + 1; i >= 0; i -= 2) {
+        code[i] = CODE_ALPHABET[latInt % ENCODING_BASE];
+        code[i + 1] = CODE_ALPHABET[lngInt % ENCODING_BASE];
+        latInt = Math.floor(latInt / ENCODING_BASE);
+        lngInt = Math.floor(lngInt / ENCODING_BASE);
+    }
+    if (codeLength >= SEPARATOR_POSITION) {
+        return code.slice(0, codeLength + 1).join('');
+    }
+    return (code.slice(0, codeLength).join('') +
+        PADDING_CHARACTER.repeat(SEPARATOR_POSITION - codeLength) +
+        SEPARATOR);
+}
+/** Encode a full Plus Code from WGS84 coordinates (default 10-digit pair precision). */
+export function encodePlusCode(latitude, longitude, codeLength = PAIR_CODE_LENGTH) {
+    const [latInt, lngInt] = locationToIntegers(latitude, longitude);
+    return encodeIntegers(latInt, lngInt, codeLength);
+}
+//# sourceMappingURL=plus-code.js.map

package/dist/utils/plus-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plus-code.js","sourceRoot":"","sources":["../../src/utils/plus-code.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAC7C,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC;AAC3C,MAAM,YAAY,GAAG,EAAE,CAAC;AACxB,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,YAAY,GAAG,CAAC,CAAC;AACvB,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,MAAM,cAAc,GAAG,aAAa,IAAI,CAAC,CAAC;AAC1C,MAAM,gBAAgB,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAC5D,MAAM,mBAAmB,GACvB,cAAc,GAAG,SAAS,IAAI,CAAC,eAAe,GAAG,gBAAgB,CAAC,CAAC;AACrE,MAAM,mBAAmB,GACvB,cAAc,GAAG,YAAY,IAAI,CAAC,eAAe,GAAG,gBAAgB,CAAC,CAAC;AAExE,SAAS,kBAAkB,CAAC,QAAgB,EAAE,SAAiB;IAC7D,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,mBAAmB,CAAC,CAAC;IACxD,MAAM,IAAI,YAAY,GAAG,mBAAmB,CAAC;IAC7C,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,MAAM,GAAG,CAAC,CAAC;IACb,CAAC;SAAM,IAAI,MAAM,IAAI,CAAC,GAAG,YAAY,GAAG,mBAAmB,EAAE,CAAC;QAC5D,MAAM,GAAG,CAAC,GAAG,YAAY,GAAG,mBAAmB,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,mBAAmB,CAAC,CAAC;IACzD,MAAM,IAAI,aAAa,GAAG,mBAAmB,CAAC;IAC9C,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,MAAM;YACJ,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,aAAa,GAAG,mBAAmB,CAAC,CAAC;gBACpD,CAAC,GAAG,aAAa,GAAG,mBAAmB,CAAC;IAC5C,CAAC;SAAM,IAAI,MAAM,IAAI,CAAC,GAAG,aAAa,GAAG,mBAAmB,EAAE,CAAC;QAC7D,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,aAAa,GAAG,mBAAmB,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,cAAc,CAAC,MAAc,EAAE,MAAc,EAAE,UAAU,GAAG,gBAAgB;IACnF,MAAM,IAAI,GAAa,IAAI,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC;IACtD,IAAI,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAC;IAErC,IAAI,UAAU,GAAG,gBAAgB,EAAE,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,eAAe,GAAG,gBAAgB,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7D,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;YACpC,MAAM,QAAQ,GAAG,MAAM,GAAG,YAAY,CAAC;YACvC,MAAM,GAAG,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;YAC/C,IAAI,CAAC,kBAAkB,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,GAAG,CAAE,CAAC;YACvD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;YACxC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,IAAI,gBAAgB,CAAC,CAAC;QAC5D,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,YAAY,IAAI,gBAAgB,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,CAAC,kBAAkB,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,MAAM,GAAG,aAAa,CAAE,CAAC;IACtE,IAAI,CAAC,kBAAkB,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,MAAM,GAAG,aAAa,CAAE,CAAC;IACtE,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC;IAC5C,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC;IAE5C,KAAK,IAAI,CAAC,GAAG,gBAAgB,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,MAAM,GAAG,aAAa,CAAE,CAAC;QACjD,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,MAAM,GAAG,aAAa,CAAE,CAAC;QACrD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC;QAC5C,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,UAAU,IAAI,kBAAkB,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,CACL,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,iBAAiB,CAAC,MAAM,CAAC,kBAAkB,GAAG,UAAU,CAAC;QACzD,SAAS,CACV,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,SAAiB,EAAE,UAAU,GAAG,gBAAgB;IAC/F,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,kBAAkB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACjE,OAAO,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AACpD,CAAC"}

package/dist/utils/png.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Minimal PNG decode/encode for 8-bit RGB/RGBA tiles.
+ *
+ * Supports color types 2 (RGB) and 6 (RGBA). Output is always RGBA for compositing.
+ * Uses node:zlib for IDAT inflate/deflate — no third-party image dependency.
+ */
+export interface RgbaImage {
+    width: number;
+    height: number;
+    /** Row-major RGBA bytes, length width * height * 4. */
+    data: Uint8Array;
+}
+/** Decode a PNG buffer into RGBA pixels. */
+export declare function decodePng(png: Uint8Array): RgbaImage;
+/** Encode RGBA pixels as an 8-bit truecolour-with-alpha PNG. */
+export declare function encodePng(image: RgbaImage): Uint8Array;
+/** Create a blank RGBA canvas filled with a solid colour. */
+export declare function createRgbaCanvas(width: number, height: number, fill?: [number, number, number, number]): RgbaImage;
+/** Blit source RGBA onto dest at (dx, dy), clipping at dest edges. */
+export declare function blitRgba(dest: RgbaImage, src: RgbaImage, dx: number, dy: number): void;
+/** Extract a sub-rectangle from an RGBA image. */
+export declare function cropRgba(image: RgbaImage, x: number, y: number, w: number, h: number): RgbaImage;
+/** Sample pixel channel variance — detects uniform/blank stitch output. */
+export declare function pixelVariance(image: RgbaImage): number;
+//# sourceMappingURL=png.d.ts.map

package/dist/utils/png.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"png.d.ts","sourceRoot":"","sources":["../../src/utils/png.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,IAAI,EAAE,UAAU,CAAC;CAClB;AA6FD,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,CAqGpD;AAUD,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,CAmCtD;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAwB,GAC5D,SAAS,CAUX;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CACtB,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,SAAS,EACd,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,IAAI,CA4BN;AAED,kDAAkD;AAClD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAiBhG;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAsBtD"}