map-gl-offline 0.8.8 → 0.9.0

package/dist/utils/tileRange.d.ts

@@ -0,0 +1,63 @@
+export interface TileRange {
+    minX: number;
+    maxX: number;
+    minY: number;
+    maxY: number;
+}
+/**
+ * XYZ tile range covering `bounds` at zoom `z`. Shared by the download
+ * pipeline (which fetches exactly this range) and region-scoped consumers
+ * like MBTiles export, so both agree on which tiles belong to a region.
+ */
+export declare function getTileRangeAtZoom(bounds: [[number, number], [number, number]], z: number): TileRange;
+/**
+ * Whether tile `z/x/y` falls inside `bounds` and `[minZoom, maxZoom]`.
+ */
+export declare function isTileInRegion(z: number, x: number, y: number, region: {
+    bounds: [[number, number], [number, number]];
+    minZoom: number;
+    maxZoom: number;
+}): boolean;
+/**
+ * Zoom levels to download for one source in `region`: the overlap of the
+ * region's and the source's zoom ranges. When they don't overlap, the source
+ * still gets the zooms the map needs from it:
+ * - source ends below the region (`maxzoom` < region min) → its `maxzoom`,
+ *   which the renderer overzooms for the region's zooms;
+ * - source starts above the region (`minzoom` > region max) → `minzoom`
+ *   through `maxzoom` (or just `minzoom` if unbounded).
+ */
+export declare function sourceZoomRange(region: {
+    minZoom: number;
+    maxZoom: number;
+}, sourceMinZoom?: number, sourceMaxZoom?: number): {
+    min: number;
+    max: number;
+};
+/** Zoom fields of a stored style source (possibly patched by patchStyleForOffline). */
+export interface SourceZoomConfig {
+    minzoom?: number;
+    maxzoom?: number;
+    __originalMaxzoom?: number | null;
+}
+/**
+ * A stored source's upstream `maxzoom`. Patched styles cap `maxzoom` for
+ * rendering and stash the upstream value under `__originalMaxzoom`.
+ */
+export declare function upstreamMaxzoom(source: SourceZoomConfig | undefined): number | undefined;
+/**
+ * Whether a stored tile was downloaded for `region`: inside its bounds, at a
+ * zoom the download pipeline fetches for the tile's source (which can fall
+ * outside the region's own range — see `sourceZoomRange`). `sources` is the
+ * stored style's `sources`. Regions with malformed bounds match nothing.
+ */
+export declare function tileBelongsToRegion(tile: {
+    sourceId?: string;
+    z: number;
+    x: number;
+    y: number;
+}, region: {
+    bounds: [[number, number], [number, number]];
+    minZoom: number;
+    maxZoom: number;
+}, sources: Record<string, SourceZoomConfig | undefined>): boolean;

package/dist/utils/validation.d.ts

@@ -2,7 +2,7 @@
  * Validation utilities for common patterns
  * Provides reusable validation functions to ensure data integrity
  */
-import type { OfflineRegionOptions } from '../types';
+import type { OfflineRegionOptions } from '../types/index.js';
 /**
  * Validate geographic bounds
  * @param bounds - Array of two [lng, lat] coordinate pairs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "map-gl-offline",
-  "version": "0.8.8",
+  "version": "0.9.0",
   "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",
@@ -38,7 +38,7 @@
     "dev": "vite",
     "build": "npm run build:clean && npm run build:sw-src && npm run build:lib && npm run build:types && npm run build:css && npm run build:sw",
     "build:clean": "rimraf dist",
-    "build:lib": "rollup -c",
+    "build:lib": "rollup -c && node scripts/check-umd.mjs",
     "build:types": "tsc --declaration --emitDeclarationOnly --outDir dist && tsc-alias -p tsconfig.json --outDir dist",
     "build:css": "tailwindcss -i src/styles/style.css -o dist/style.css --minify",
     "build:sw-src": "node scripts/build-sw.mjs",
@@ -52,7 +52,7 @@
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
-    "test:ci": "jest --ci --coverage --watchAll=false --testPathIgnorePatterns='tests/e2e'",
+    "test:ci": "jest --ci --coverage --watchAll=false --no-watchman --testPathIgnorePatterns='tests/e2e'",
     "lint": "eslint src",
     "lint:fix": "eslint src --fix",
     "lint:warn": "eslint src --max-warnings 200",
@@ -71,7 +71,10 @@
     "docs:build": "cd docs && npm run build",
     "docs:serve": "cd docs && npm run serve",
     "docs:deploy": "cd docs && npm run deploy",
-    "prepare": "husky"
+    "prepare": "husky",
+    "check:mapbox-standard": "node scripts/check-mapbox-standard.mjs",
+    "check:demo": "node scripts/check-demo.mjs",
+    "check:docs": "node scripts/check-doc-examples.mjs"
   },
   "keywords": [
     "mapbox-gl",
@@ -102,13 +105,13 @@
   "type": "module",
   "dependencies": {
     "@mapbox/tilebelt": "^2.0.3",
-    "@turf/area": "^7.3.4",
-    "@turf/bbox-polygon": "^7.3.4",
-    "@turf/difference": "^7.3.4",
-    "@turf/helpers": "^7.3.4",
-    "i18next": "^25.8.11",
-    "idb": "^8.0.3",
-    "sql.js": "^1.14.1"
+    "@turf/area": "^7.4.0",
+    "@turf/bbox-polygon": "^7.4.0",
+    "@turf/difference": "^7.4.0",
+    "@turf/helpers": "^7.4.0",
+    "i18next": "^26.7.2",
+    "idb": "^8.0.4",
+    "sql.js": "^1.15.2"
   },
   "peerDependencies": {
     "mapbox-gl": ">=2.0.0",
@@ -123,44 +126,46 @@
     }
   },
   "devDependencies": {
-    "@babel/preset-env": "^7.29.0",
+    "@babel/core": "^8.1.0",
+    "@babel/preset-env": "^8.0.7",
     "@eslint/js": "^10.0.1",
-    "@rollup/plugin-commonjs": "^29.0.0",
+    "@fontsource/barlow": "^5.3.0",
+    "@rollup/plugin-commonjs": "^29.0.3",
     "@rollup/plugin-node-resolve": "^16.0.3",
-    "@rollup/plugin-typescript": "^12.3.0",
-    "@tailwindcss/cli": "^4.2.0",
-    "@tailwindcss/vite": "^4.2.0",
+    "@rollup/plugin-typescript": "^12.3.1",
+    "@tailwindcss/cli": "^4.3.4",
+    "@tailwindcss/vite": "^4.3.4",
     "@types/jest": "^30.0.0",
     "@types/mapbox__tilebelt": "^1.0.4",
     "@types/mapbox-gl": "^3.4.1",
-    "@types/maplibre-gl": "^1.14.0",
-    "@types/node": "^25.3.0",
+    "@types/node": "^26.6.6",
     "@types/sql.js": "^1.4.11",
-    "autoprefixer": "^10.4.24",
-    "esbuild": "^0.27.3",
-    "eslint": "^10.0.0",
-    "fake-indexeddb": "^6.2.5",
+    "autoprefixer": "^10.6.2",
+    "esbuild": "^0.28.2",
+    "eslint": "^10.14.0",
+    "fake-indexeddb": "^6.2.7",
     "husky": "^9.1.7",
-    "jest": "^30.2.0",
-    "jest-environment-jsdom": "^30.2.0",
-    "map-gl-style-switcher": "^0.9.2",
-    "mapbox-gl": "^3.18.1",
-    "postcss": "^8.5.10",
-    "prettier": "^3.8.1",
-    "puppeteer": "^24.37.4",
-    "rimraf": "^6.1.3",
-    "rollup": "^4.60.0",
-    "rollup-plugin-dts": "^6.3.0",
-    "tailwindcss": "^4.2.0",
-    "ts-jest": "^29.4.6",
+    "jest": "^30.5.2",
+    "jest-environment-jsdom": "^30.5.2",
+    "map-gl-style-switcher": "^0.10.1",
+    "mapbox-gl": "^3.34.2",
+    "maplibre-gl": "^6.16.0",
+    "postcss": "^8.5.32",
+    "prettier": "^3.9.10",
+    "puppeteer": "^25.16.0",
+    "rimraf": "^6.1.4",
+    "rollup": "^4.67.5",
+    "rollup-plugin-dts": "^6.5.1",
+    "tailwindcss": "^4.3.4",
+    "ts-jest": "^29.4.15",
     "ts-node": "^10.9.2",
-    "tsc-alias": "^1.8.17",
+    "tsc-alias": "^1.9.10",
     "tsconfig-paths": "^4.2.0",
-    "tslib": "^2.8.1",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.56.0",
-    "vite": "^7.3.2",
+    "tslib": "^2.9.1",
+    "tsx": "^4.23.15",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.72.1",
+    "vite": "^8.3.6",
     "vite-tsconfig-paths": "^6.1.1"
   }
 }