map-gl-offline 0.8.6 → 0.8.7

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/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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "map-gl-offline",
-  "version": "0.8.6",
+  "version": "0.8.7",
   "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",