map-gl-offline 0.8.2 → 0.8.4

package/dist/index.umd.js

@@ -55,45 +55,61 @@
         SUPPORTED_EXTENSIONS: ['pbf', 'mvt', 'png', 'jpg', 'jpeg', 'webp', 'glb'],
     };
     // Glyph Configuration
+    //
+    // Glyph servers (MapTiler, Mapbox, OpenFreeMap, ...) serve glyphs in fixed
+    // 256-codepoint blocks aligned to a multiple of 256: every request must be
+    // `${k * 256}-${k * 256 + 255}`. Strict servers (e.g. MapTiler) reject any
+    // other range with HTTP 400 "Invalid glyph range"; lenient ones silently
+    // accept them, which is how malformed ranges went unnoticed. See issue #37.
+    const GLYPH_BLOCK_SIZE = 256;
+    const MAX_GLYPH_CODEPOINT = 65535;
+    /**
+     * Expand an inclusive Unicode codepoint span into the aligned 256-codepoint
+     * glyph blocks that cover it, formatted as `"start-end"` request ranges.
+     * The span need not be block-aligned — it is snapped out to whole blocks.
+     */
+    function glyphBlocksForSpan(start, end) {
+        const firstBlock = Math.floor(start / GLYPH_BLOCK_SIZE);
+        const lastBlock = Math.floor(Math.min(end, MAX_GLYPH_CODEPOINT) / GLYPH_BLOCK_SIZE);
+        const blocks = [];
+        for (let block = firstBlock; block <= lastBlock; block++) {
+            const blockStart = block * GLYPH_BLOCK_SIZE;
+            blocks.push(`${blockStart}-${blockStart + GLYPH_BLOCK_SIZE - 1}`);
+        }
+        return blocks;
+    }
+    /**
+     * Unicode codepoint spans the comprehensive glyph download aims to cover.
+     * Each span is snapped to whole 256-codepoint glyph blocks below, so the
+     * resulting request ranges are always server-valid regardless of where the
+     * underlying Unicode blocks happen to start or end. To extend coverage, add
+     * a span here — never hand-write raw `"start-end"` ranges.
+     */
+    const GLYPH_COVERAGE_SPANS = [
+        [0x0000, 0x12ff], // Latin, Greek, Cyrillic, Hebrew, Arabic, Indic, SE Asian, Georgian, Ethiopic, Cherokee
+        [0x1e00, 0x21ff], // Latin Extended Additional, punctuation, symbols, arrows
+        [0x2e00, 0x31ff], // CJK radicals, Hiragana, Katakana, Bopomofo, Hangul Compatibility Jamo
+        [0x4e00, 0x4fff], // CJK Unified Ideographs (common subset)
+        [0xa000, 0xa4ff], // Yi Syllables and Radicals
+        [0xac00, 0xd7ff], // Hangul Syllables (Korean)
+        [0xf900, 0xfbff], // CJK Compatibility Ideographs, Alphabetic Presentation Forms
+        [0xfe00, 0xfeff], // Variation Selectors
+        [0xff00, 0xffff], // Halfwidth and Fullwidth Forms
+    ];
+    /** Build the deduped, codepoint-ascending list of comprehensive glyph ranges. */
+    function buildComprehensiveRanges() {
+        const ranges = new Set();
+        for (const [start, end] of GLYPH_COVERAGE_SPANS) {
+            for (const range of glyphBlocksForSpan(start, end)) {
+                ranges.add(range);
+            }
+        }
+        return Array.from(ranges).sort((a, b) => Number(a.split('-')[0]) - Number(b.split('-')[0]));
+    }
     const GLYPH_CONFIG = {
         DEFAULT_URL: 'https://tiles.openfreemap.org/fonts/{fontstack}/{range}.pbf',
         DEFAULT_RANGES: ['0-255'],
-        COMPREHENSIVE_RANGES: [
-            '0-255', // Basic Latin + Latin-1 Supplement
-            '256-511', // Latin Extended-A + Latin Extended-B
-            '512-767', // IPA Extensions + Spacing Modifier Letters
-            '768-1023', // Combining Diacritical Marks + Greek and Coptic
-            '1024-1279', // Cyrillic + Cyrillic Supplement
-            '1280-1535', // Armenian + Hebrew
-            '1536-1791', // Arabic
-            '1792-2047', // Syriac + Arabic Supplement + Thaana
-            '2048-2303', // NKo + Samaritan + Mandaic
-            '2304-2559', // Devanagari + Bengali
-            '2560-2815', // Gurmukhi + Gujarati
-            '2816-3071', // Oriya + Tamil
-            '3072-3327', // Telugu + Kannada
-            '3328-3583', // Malayalam + Sinhala
-            '3584-3839', // Thai + Lao
-            '3840-4095', // Tibetan + Myanmar
-            '4096-4351', // Georgian + Hangul Jamo
-            '4352-4607', // Ethiopic
-            '4608-4863', // Cherokee + Canadian Aboriginal
-            '7680-7935', // Latin Extended Additional
-            '8192-8447', // General Punctuation, Superscripts/Subscripts, Currency Symbols
-            '8448-8703', // Letterlike Symbols, Number Forms, Arrows
-            '11904-12031', // CJK Radicals Supplement
-            '12032-12255', // Kangxi Radicals + CJK Symbols
-            '12288-12543', // Hiragana + Katakana
-            '12544-12799', // Bopomofo + Hangul Compatibility Jamo
-            '19968-20223', // CJK Unified Ideographs (first block)
-            '20224-20479', // CJK Unified Ideographs
-            '40960-42127', // Yi Syllables + Yi Radicals
-            '44032-55203', // Hangul Syllables (Korean)
-            '63744-64255', // CJK Compatibility Ideographs
-            '64256-64511', // Alphabetic Presentation Forms
-            '65024-65279', // Variation Selectors
-            '65280-65535', // Halfwidth and Fullwidth Forms
-        ],
+        COMPREHENSIVE_RANGES: buildComprehensiveRanges(),
     };
     // Style Configuration
     const STYLE_CONFIG = {
@@ -12937,14 +12953,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
@@ -13204,7 +13221,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
@@ -13973,6 +13990,7 @@
     exports.DOWNLOAD_DEFAULTS = DOWNLOAD_DEFAULTS;
     exports.ERROR_MESSAGES = ERROR_MESSAGES;
     exports.FontService = FontService;
+    exports.GLYPH_BLOCK_SIZE = GLYPH_BLOCK_SIZE;
     exports.GLYPH_CONFIG = GLYPH_CONFIG;
     exports.GZIP_MAGIC_BYTES = GZIP_MAGIC_BYTES;
     exports.GlyphService = GlyphService;
@@ -13981,6 +13999,7 @@
     exports.MAPBOX_CACHE_TTL = MAPBOX_CACHE_TTL;
     exports.MAPBOX_CLASSIC_STYLES = MAPBOX_CLASSIC_STYLES;
     exports.MAP_PROVIDERS = MAP_PROVIDERS;
+    exports.MAX_GLYPH_CODEPOINT = MAX_GLYPH_CODEPOINT;
     exports.MaintenanceService = MaintenanceService;
     exports.ModelService = ModelService;
     exports.OfflineManagerControl = OfflineManagerControl;