map-gl-offline 0.8.2 → 0.8.4

package/dist/types/region.d.ts

@@ -22,7 +22,7 @@ export interface DownloadRegionProgress {
  * Options for the programmatic `downloadRegion` pipeline.
  */
 export interface DownloadRegionOptions {
-    /** Called with per-phase progress during style → sprites → glyphs → tiles → metadata. */
+    /** Called with per-phase progress during style → sprites → glyphs → models → tiles → metadata. */
     onProgress?: (progress: DownloadRegionProgress) => void;
     /** Style provider hint when the style needs to be fetched. Defaults to 'auto'. */
     provider?: StyleProvider;

package/dist/ui/managers/downloadManager.d.ts

@@ -2,14 +2,15 @@
  * Download Manager for offline map regions.
  *
  * This module handles the complete download workflow for offline map regions,
- * including styles, sprites, glyphs (fonts), and map tiles. It provides
+ * including styles, sprites, glyphs (fonts), 3D models, and map tiles. It provides
  * progress tracking across all download phases.
  *
  * **Download Phases:**
  * 1. `style` - Downloads the map style JSON and processes sources
  * 2. `sprites` - Downloads sprite images and JSON for map icons
  * 3. `glyphs` - Downloads font glyphs for text rendering
- * 4. `tiles` - Downloads map tiles for the specified region bounds
+ * 4. `models` - Downloads 3D model assets (Mapbox Standard trees / turbines)
+ * 5. `tiles` - Downloads map tiles for the specified region bounds
  *
  * **Usage:**
  * The DownloadManager is typically instantiated by the OfflineManagerControl

package/dist/ui/offlineManagerControl.d.ts

@@ -12,7 +12,7 @@
  * - Integrates seamlessly as a MapLibre GL control
  * - Intercepts fetch requests to serve offline resources from IndexedDB
  * - Supports light and dark themes
- * - Shows download progress across all phases (style, sprites, glyphs, tiles)
+ * - Shows download progress across all phases (style, sprites, glyphs, models, tiles)
  * - Optional bounding box visualization for regions
  *
  * @example
@@ -36,6 +36,23 @@
  */
 import type { IControl, Map as MaplibreMap } from 'maplibre-gl';
 import { OfflineMapManager } from '@/managers/offlineMapManager';
+/**
+ * Request shape MapLibre passes to a protocol handler. `type` indicates how
+ * the response will be consumed — `"json"` for sprite atlases / TileJSON,
+ * everything else binary (`"arrayBuffer"`, `"image"`, …).
+ */
+export interface MapLibProtocolRequest {
+    url: string;
+    type?: string;
+}
+/**
+ * Response shape MapLibre expects from a promise-based protocol handler.
+ * `data` is binary (`ArrayBuffer`) for tiles/glyphs/sprites and a parsed
+ * JSON object for sprite atlas / TileJSON requests.
+ */
+export interface MapLibProtocolResponse {
+    data: ArrayBuffer | Record<string, unknown>;
+}
 /**
  * Interface for map libraries that support custom protocol handlers.
  * MapLibre GL JS provides `addProtocol`/`removeProtocol`; Mapbox GL JS v3 does not.
@@ -43,9 +60,7 @@ import { OfflineMapManager } from '@/managers/offlineMapManager';
  * `idb://` protocol for web-worker tile fetches.
  */
 export interface MapLibProtocol {
-    addProtocol: (protocol: string, handler: (...args: any[]) => Promise<{
-        data: ArrayBuffer;
-    }>) => void;
+    addProtocol: (protocol: string, handler: (params: MapLibProtocolRequest) => Promise<MapLibProtocolResponse>) => void;
     removeProtocol: (protocol: string) => void;
 }
 /**

package/dist/utils/constants.d.ts

@@ -25,10 +25,12 @@ export declare const TILE_CONFIG: {
     readonly DEFAULT_EXTENSION: "pbf";
     readonly SUPPORTED_EXTENSIONS: readonly ["pbf", "mvt", "png", "jpg", "jpeg", "webp", "glb"];
 };
+export declare const GLYPH_BLOCK_SIZE = 256;
+export declare const MAX_GLYPH_CODEPOINT = 65535;
 export declare const GLYPH_CONFIG: {
     readonly DEFAULT_URL: "https://tiles.openfreemap.org/fonts/{fontstack}/{range}.pbf";
     readonly DEFAULT_RANGES: readonly ["0-255"];
-    readonly COMPREHENSIVE_RANGES: readonly ["0-255", "256-511", "512-767", "768-1023", "1024-1279", "1280-1535", "1536-1791", "1792-2047", "2048-2303", "2304-2559", "2560-2815", "2816-3071", "3072-3327", "3328-3583", "3584-3839", "3840-4095", "4096-4351", "4352-4607", "4608-4863", "7680-7935", "8192-8447", "8448-8703", "11904-12031", "12032-12255", "12288-12543", "12544-12799", "19968-20223", "20224-20479", "40960-42127", "44032-55203", "63744-64255", "64256-64511", "65024-65279", "65280-65535"];
+    readonly COMPREHENSIVE_RANGES: string[];
 };
 export declare const STYLE_CONFIG: {
     readonly OPENFREEMAP_BASE: "https://tiles.openfreemap.org/styles";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "map-gl-offline",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "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",
@@ -145,7 +145,7 @@
     "jest-environment-jsdom": "^30.2.0",
     "map-gl-style-switcher": "^0.9.2",
     "mapbox-gl": "^3.18.1",
-    "postcss": "^8.5.6",
+    "postcss": "^8.5.10",
     "prettier": "^3.8.1",
     "puppeteer": "^24.37.4",
     "rimraf": "^6.1.3",