map-gl-offline 0.8.7 → 0.8.8

package/dist/services/tileService.d.ts

@@ -1,4 +1,13 @@
 import type { TileDownloadOptions, TileDownloadResult, TileStats, OfflineRegionOptions, MapboxStyle } from '../types';
+/**
+ * Match a tile-URL template against the known-sparse Mapbox Standard
+ * sub-tilesets. Catches:
+ *   - `mapbox://<tileset>` — original style source URL.
+ *   - `.../v4/<tileset>.json...` — resolved TileJSON URL produced when the
+ *     library resolves a `mapbox://` source URL into an HTTPS one.
+ *   - `.../v4/<tileset>/{z}/{x}/{y}...` — resolved tile-template URL.
+ */
+export declare function urlReferencesKnownSparseTileset(template: string): boolean;
 /**
  * Service for managing offline map tiles
  * Handles downloading, storing, and retrieving map tiles from IndexedDB

package/dist/types/tile.d.ts

@@ -80,6 +80,20 @@ export interface TileDownloadOptions {
      * (old behavior — noisier, but guaranteed-complete).
      */
     probeSourcesBeforeDownload?: boolean;
+    /**
+     * Pre-skip a small allowlist of Mapbox Standard sub-tilesets that are
+     * sparse-by-design across the whole planet — `mapbox.indoor-v3`,
+     * `mapbox.landmark-pois-v1`, `mapbox.procedural-buildings-v1`. These
+     * have tiles only where indoor venues / landmark POIs / 3D buildings
+     * actually exist; for typical regions they return 404 for nearly every
+     * coordinate. Pre-skipping means we never issue probe or download
+     * requests for them, eliminating the 404 noise in devtools.
+     *
+     * Default: `true`. Set `false` to attempt these sources anyway — the
+     * downstream `probeSourcesBeforeDownload` pass will still skip them
+     * for most regions, but you'll see the probe 404s in the network log.
+     */
+    skipKnownSparseSources?: boolean;
 }
 /**
  * Result of a tile download operation

package/dist/utils/constants.d.ts

@@ -81,6 +81,19 @@ export declare const MAPBOX_API: {
     readonly MODELS_PATH: "/models/v1";
     readonly PROTOCOL: "mapbox://";
 };
+/**
+ * Mapbox Standard sub-tilesets that are sparse-by-design across the planet.
+ * These only have tiles where the underlying feature (indoor venues, landmark
+ * POIs, 3D procedural buildings) actually exists, and return 404 for nearly
+ * every other coordinate. The tile downloader pre-skips any source whose tile
+ * URL templates reference one of these tileset IDs, so we never issue probe
+ * or download requests for them — eliminating the 404 noise in devtools.
+ *
+ * Matching is done against the tileset segment of the tile URL template
+ * (e.g. `https://api.mapbox.com/v4/mapbox.indoor-v3/{z}/{x}/{y}.vector.pbf`
+ * or `mapbox://mapbox.indoor-v3`).
+ */
+export declare const MAPBOX_STANDARD_SPARSE_TILESETS: readonly ["mapbox.indoor-v3", "mapbox.landmark-pois-v1", "mapbox.procedural-buildings-v1"];
 export declare const MAP_PROVIDERS: {
     readonly AUTO: "auto";
     readonly MAPBOX: "mapbox";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "map-gl-offline",
-  "version": "0.8.7",
+  "version": "0.8.8",
   "description": "A TypeScript-compatible npm package for MapLibre GL JS that enables comprehensive offline storage and usage of vector/raster tiles, sprites, styles, fonts (glyphs), and entire map regions with advanced analytics, import/export capabilities, and intelligent cleanup.",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",