map-gl-offline 0.8.8 → 0.8.9

package/README.md

@@ -25,7 +25,7 @@ TypeScript offline-map library for **MapLibre GL JS** and **Mapbox GL JS**. Down
 npm install map-gl-offline
 ```
 
-Or via CDN as the `mapgloffline` global:
+Or via CDN as the `mapgloffline` global. The UMD build is self-contained — only your map library needs to be on the page:
 
 ```html
 <script src="https://unpkg.com/map-gl-offline/dist/index.umd.js"></script>
@@ -200,7 +200,7 @@ for (const city of cities) {
 
 For composite styles (e.g. Mapbox Standard) that reference sparse tilesets like `indoor-v3` or `landmark-pois-v1`, the tile downloader probes start/middle/end tiles per source and drops any that return majority-404. Disable with `tileOptions: { probeSourcesBeforeDownload: false }`.
 
-Three Mapbox Standard sub-tilesets are sparse-by-design across the planet — `mapbox.indoor-v3`, `mapbox.landmark-pois-v1`, `mapbox.procedural-buildings-v1`. Since 0.8.8 these are hard-skipped **before** the probe step so no network request is issued (and no 404s land in devtools). Opt out with `tileOptions: { skipKnownSparseSources: false }` to run them through the probe path instead.
+Three Mapbox Standard sub-tilesets are sparse-by-design across the planet — `mapbox.indoor-v3`, `mapbox.mapbox-landmark-pois-v1`, `mapbox.procedural-buildings-v1`. Since 0.8.8 these are hard-skipped **before** the probe step so no network request is issued (and no 404s land in devtools). Opt out with `tileOptions: { skipKnownSparseSources: false }` to run them through the probe path instead.
 
 ### Recovering from an incompatible DB
 
@@ -226,6 +226,7 @@ try {
 ## API at a glance
 
 - **Regions** — `downloadRegion`, `loadRegion`, `addRegion`, `getStoredRegion`, `listStoredRegions`, `listRegions`, `deleteRegion`
+- **Styles** — `downloadStyle`, `downloadMapboxStyle`, `downloadMapLibreStyle`, `downloadStyleWithAutoDetection`, `listStyles`, `loadStyleById`, `getStyleStats`, `deleteStyle`, `cleanupOldStyles`
 - **Analytics** — `getComprehensiveStorageAnalytics`, `getRegionAnalytics`, `getTileStats`, `getFontStats`, `getSpriteStats`, `getGlyphStats`
 - **Cleanup** — `cleanupExpiredRegions`, `performSmartCleanup`, `cleanupOld{Fonts,Sprites,Glyphs}`, `verifyAndRepair{Fonts,Sprites,Glyphs}`, `setupAutoCleanup`, `performCompleteMaintenance`
 - **Import / Export** — `exportRegionAsMBTiles`, `importRegion`, `downloadExportedRegion` (binary SQLite MBTiles, QGIS/tippecanoe-compatible)

package/dist/index.esm.js

@@ -171,10 +171,15 @@ const MAPBOX_API = {
  * 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`).
+ *
+ * The ids below are the ones the live Mapbox Standard style declares — note
+ * that the landmark-POI tileset is `mapbox.mapbox-landmark-pois-v1` (doubled
+ * `mapbox` segment), unlike the other two. The matcher is delimiter-anchored,
+ * so an approximate id silently never matches.
  */
 const MAPBOX_STANDARD_SPARSE_TILESETS = [
     'mapbox.indoor-v3',
-    'mapbox.landmark-pois-v1',
+    'mapbox.mapbox-landmark-pois-v1',
     'mapbox.procedural-buildings-v1',
 ];
 // Map Providers
@@ -3279,15 +3284,42 @@ function configureSqlJs(config) {
     sqlJsPromise = null;
 }
 /**
- * Lazily initialise `sql.js`. The underlying module is loaded via dynamic
- * `import()` so it only ships with bundles that actually call MBTiles code.
+ * Resolve the `initSqlJs` factory.
+ *
+ * Bundler builds resolve the npm package via dynamic `import()`, so `sql.js`
+ * only ships with bundles that actually call MBTiles code. The UMD/CDN build
+ * has no module resolver, so the import throws there — fall back to the
+ * `initSqlJs` global that sql.js's own `<script>` build defines.
+ */
+async function resolveInitSqlJs() {
+    let importError;
+    try {
+        const mod = (await import('sql.js'));
+        if (typeof mod?.default === 'function')
+            return mod.default;
+    }
+    catch (error) {
+        // Bare specifier not resolvable (UMD/CDN), or the module threw while
+        // initialising. Either way, try the global before giving up.
+        importError = error;
+    }
+    const globalInit = globalThis.initSqlJs;
+    if (typeof globalInit === 'function')
+        return globalInit;
+    // Preserve the original failure — a module that resolved but threw is a
+    // very different problem from one that couldn't be resolved at all.
+    throw new Error('sql.js could not be loaded. Install `sql.js` when bundling, or load ' +
+        'https://cdn.jsdelivr.net/npm/sql.js/dist/sql-wasm.js before map-gl-offline ' +
+        'when using the UMD build.', importError !== undefined ? { cause: importError } : undefined);
+}
+/**
+ * Lazily initialise `sql.js`.
  */
 async function getSqlJs() {
     if (sqlJsPromise)
         return sqlJsPromise;
     sqlJsPromise = (async () => {
-        const mod = (await import('sql.js'));
-        const initSqlJs = mod.default;
+        const initSqlJs = await resolveInitSqlJs();
         const options = {};
         if (currentConfig.wasmBinary) {
             options.wasmBinary = currentConfig.wasmBinary;