map-gl-offline 0.8.6 → 0.8.8

package/dist/managers/offlineMapManager/styleManagement.d.ts

@@ -2,14 +2,14 @@ import type { EnhancedStyleStats, StyleDownloadOptions, StyleDownloadResult, Sty
 export interface StyleManagement {
     downloadStyle(styleUrl: string, options?: StyleDownloadOptions & {
         provider?: StyleProvider;
-        accessToken?: string;
+        accessToken?: string | null;
         forceProvider?: boolean;
     }): Promise<StyleDownloadResult>;
     loadStyleById(styleId: string): Promise<StyleEntry | null>;
     listStyles(): Promise<StyleEntry[]>;
     deleteStyle(styleId: string): Promise<void>;
     getStyleStats(styleId: string): Promise<EnhancedStyleStats>;
-    downloadMapboxStyle(styleUrl: string, accessToken?: string, options?: StyleDownloadOptions): Promise<StyleDownloadResult>;
+    downloadMapboxStyle(styleUrl: string, accessToken?: string | null, options?: StyleDownloadOptions): Promise<StyleDownloadResult>;
     downloadMapLibreStyle(styleUrl: string, options?: StyleDownloadOptions): Promise<StyleDownloadResult>;
     downloadStyleWithAutoDetection(styleUrl: string, options?: StyleDownloadOptions): Promise<StyleDownloadResult>;
     cleanupOldStyles(maxAgeDays?: number): Promise<number>;

package/dist/services/styleService.d.ts

@@ -32,6 +32,6 @@ export declare function isStyleDownloaded(styleId?: string, styleUrl?: string):
  */
 export declare function downloadStyleWithProvider(styleUrl: string, options?: StyleDownloadOptions & {
     provider?: StyleProvider;
-    accessToken?: string;
+    accessToken?: string | null;
     forceProvider?: boolean;
 }): Promise<StyleDownloadResult>;

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/region.d.ts

@@ -26,8 +26,12 @@ export interface DownloadRegionOptions {
     onProgress?: (progress: DownloadRegionProgress) => void;
     /** Style provider hint when the style needs to be fetched. Defaults to 'auto'. */
     provider?: StyleProvider;
-    /** Mapbox access token; required when the style or sources use mapbox:// URLs. */
-    accessToken?: string;
+    /**
+     * Mapbox access token; required when the style or sources use mapbox:// URLs.
+     * Accepts `null` to match Mapbox GL's `accessToken` type so callers can pass
+     * `mapboxgl.accessToken` directly without a cast; treated the same as omitted.
+     */
+    accessToken?: string | null;
     /** Skip glyph download entirely. Default: false. */
     skipGlyphs?: boolean;
     /** Skip sprite download entirely. Default: false. */
@@ -98,6 +102,20 @@ export interface ExtraSource {
     /** Attribution string for this source */
     attribution?: string;
 }
+/**
+ * Geographic bounding box as `[[west, south], [east, north]]`.
+ *
+ * Exposed as a public tuple alias so callers can annotate `bounds` literals
+ * (or arrays of them) without TypeScript widening them to `number[][]`. Use
+ * this in your own types for cities/regions lists, e.g.
+ *
+ * ```ts
+ * const cities: Array<{ id: string; bounds: BoundingBox }> = [
+ *   { id: 'nyc', bounds: [[-74.05, 40.68], [-73.90, 40.82]] },
+ * ];
+ * ```
+ */
+export type BoundingBox = [[number, number], [number, number]];
 /**
  * Configuration options for an offline region
  */
@@ -109,7 +127,7 @@ export interface OfflineRegionOptions {
     /** Human-readable region name */
     name: string;
     /** Geographic bounds: [[west, south], [east, north]] */
-    bounds: [[number, number], [number, number]];
+    bounds: BoundingBox;
     /** Whether this region is part of a multi-region download */
     multipleRegions?: boolean;
     /** URL to the map style JSON */

package/dist/types/style.d.ts

@@ -54,7 +54,7 @@ export type StyleEntry = {
     fonts: string[];
     glyphs: string[];
     sprites: string[];
-    accessToken?: string;
+    accessToken?: string | null;
     originalUrl?: string;
     originalSpriteUrl?: BaseStyle['sprite'];
     originalGlyphsUrl?: string;
@@ -71,7 +71,11 @@ export interface StyleDownloadOptions {
     enableSourceEmbedding?: boolean;
     storageQuotaCheck?: boolean;
     includeMetadata?: boolean;
-    accessToken?: string;
+    /**
+     * Mapbox access token. Accepts `null` to match `mapboxgl.accessToken`'s
+     * type so callers can pass it through without a cast; treated as omitted.
+     */
+    accessToken?: string | null;
 }
 export interface StyleDownloadResult {
     styleId: string;

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/ui/controls/regionControl.d.ts

@@ -13,7 +13,7 @@ export interface RegionControlOptions {
     container: HTMLDivElement;
     onRegionSaved?: () => void;
     styleUrl: string;
-    accessToken?: string;
+    accessToken?: string | null;
     cssPrefix?: CssPrefix;
 }
 export declare class RegionControl {

package/dist/ui/modals/regionFormModal.d.ts

@@ -10,7 +10,7 @@ export interface RegionFormData {
     styleUrl: string;
     bounds: [number, number, number, number];
     provider?: 'mapbox' | 'maplibre' | 'auto';
-    accessToken?: string;
+    accessToken?: string | null;
     /** Additional tile sources to download alongside the style's own sources */
     extraSources?: import('../../types/region').ExtraSource[];
 }
@@ -38,7 +38,7 @@ export interface RegionFormOptions {
     onCancel: () => void;
     onThemeToggle?: () => void;
     styleUrl: string;
-    accessToken?: string;
+    accessToken?: string | null;
     /** Tile sources discovered from the live map for user selection */
     mapSources?: MapTileSource[];
 }

package/dist/ui/offlineManagerControl.d.ts

@@ -93,8 +93,11 @@ export interface OfflineManagerControlOptions {
     theme?: 'light' | 'dark';
     /** Whether to show bounding boxes when focusing on regions */
     showBbox?: boolean;
-    /** Mapbox access token, pre-filled in the region download form for mapbox:// style URLs */
-    accessToken?: string;
+    /**
+     * Mapbox access token, pre-filled in the region download form for mapbox:// style URLs.
+     * Accepts `null` so callers can pass `mapboxgl.accessToken` directly; treated as omitted.
+     */
+    accessToken?: string | null;
     /**
      * Map library module that supports `addProtocol`/`removeProtocol`.
      * Pass `maplibregl` here so the `idb://` protocol is registered in web workers.

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.6",
+  "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",