map-gl-offline 0.7.0 → 0.8.2

package/dist/types/import-export.d.ts

@@ -10,12 +10,10 @@ export interface RegionExportData {
         createdAt: number;
         exportedAt: number;
         version: string;
-        format: 'json' | 'pmtiles' | 'mbtiles';
+        format: 'mbtiles';
     };
     style: unknown;
     tiles: TileExportData[];
-    sprites: SpriteExportData[];
-    fonts: FontExportData[];
 }
 export interface TileExportData {
     z: number;
@@ -25,34 +23,13 @@ export interface TileExportData {
     format: 'pbf' | 'png' | 'jpg' | 'webp';
     sourceId: string;
 }
-export interface SpriteExportData {
-    url: string;
-    data: ArrayBuffer;
-    type: 'json' | 'png';
-    resolution: '1x' | '2x';
-}
-export interface FontExportData {
-    fontStack: string;
-    range: string;
-    data: ArrayBuffer;
-}
-export interface PMTilesExportOptions {
-    compression?: 'gzip' | 'brotli' | 'none';
-    clustered?: boolean;
-    metadata?: Record<string, unknown>;
-}
 export interface MBTilesExportOptions {
+    /** Tile format written into the MBTiles metadata table. */
     format?: 'pbf' | 'png' | 'jpg';
-    compression?: 'gzip' | 'none';
+    /** Additional metadata rows. Values are JSON-stringified if non-string. */
     metadata?: Record<string, unknown>;
 }
 export interface ImportExportOptions {
-    includeStyle?: boolean;
-    includeTiles?: boolean;
-    includeSprites?: boolean;
-    includeFonts?: boolean;
-    format?: 'json' | 'pmtiles' | 'mbtiles';
-    compression?: boolean;
     onProgress?: (progress: ImportExportProgress) => void;
 }
 export interface ImportExportProgress {
@@ -65,10 +42,12 @@ export interface ImportExportProgress {
 }
 export interface RegionImportData {
     file: File;
-    format: 'json' | 'pmtiles' | 'mbtiles';
+    /** Format is fixed to mbtiles; kept as a literal field for forward-compat. */
+    format: 'mbtiles';
     overwrite?: boolean;
     newRegionId?: string;
     newRegionName?: string;
+    onProgress?: (progress: ImportExportProgress) => void;
 }
 export interface ImportResult {
     success: boolean;
@@ -84,7 +63,7 @@ export interface ImportResult {
 }
 export interface ExportResult {
     success: boolean;
-    format: 'json' | 'pmtiles' | 'mbtiles';
+    format: 'mbtiles';
     filename: string;
     blob: Blob;
     size: number;

package/dist/ui/components/shared/PanelContent.d.ts

@@ -31,7 +31,6 @@ export declare class PanelContentRenderer extends BaseComponent {
     private showRegionDetails;
     private deleteRegion;
     private downloadRegion;
-    private showImportExportModal;
     /**
      * Refresh content
      */

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

@@ -100,7 +100,7 @@ export declare class PanelRenderer extends BaseComponent {
      */
     private handleRedownloadRegion;
     /**
-     * Handle import/export functionality
+     * Show the MBTiles import/export modal for a region.
      */
     private handleImportExport;
     /**

package/dist/ui/modals/{importExportModal.d.ts → mbtilesModal.d.ts}

@@ -1,47 +1,48 @@
 /**
- * Import/Export Modal Component
- * Handles import/export operations for regions
- * Refactored to use modular Modal component for consistency
+ * MBTiles Import/Export Modal
+ *
+ * Focused modal for exchanging regions as binary SQLite MBTiles archives.
+ * Replaces the previous multi-format import/export modal.
  */
-import type { StoredRegion, ImportExportOptions, ExportResult, ImportResult, RegionImportData } from '@/types';
-export interface ImportExportModalOptions {
+import type { StoredRegion, ImportExportOptions, MBTilesExportOptions, ExportResult, ImportResult, RegionImportData } from '@/types';
+type MBTilesExportRequestOptions = ImportExportOptions & MBTilesExportOptions;
+export interface MBTilesModalOptions {
     region: StoredRegion;
     onClose: () => void;
     onExport?: (result: ExportResult) => void;
     onImport?: (result: ImportResult) => void;
-    exportRegion?: (regionId: string, format: 'json' | 'pmtiles' | 'mbtiles', options?: ImportExportOptions) => Promise<ExportResult>;
+    exportRegion?: (regionId: string, options?: MBTilesExportRequestOptions) => Promise<ExportResult>;
     importRegion?: (data: RegionImportData) => Promise<ImportResult>;
 }
-export declare class ImportExportModal {
+export declare class MBTilesModal {
     private modal?;
     private options;
     private isExporting;
     private isImporting;
-    private exportFormatSelect?;
-    private includeStyleCheckbox?;
-    private includeTilesCheckbox?;
-    private includeSpritesCheckbox?;
-    private includeFontsCheckbox?;
     private exportProgressBar?;
     private exportProgressText?;
+    private exportProgressContainer?;
     private exportButton?;
     private importFileInput?;
     private importNameInput?;
     private importOverwriteCheckbox?;
     private importProgressBar?;
     private importProgressText?;
+    private importProgressContainer?;
     private importButton?;
-    constructor(options: ImportExportModalOptions);
+    constructor(options: MBTilesModalOptions);
     show(): HTMLDivElement;
     hide(): void;
+    destroy(): void;
     private createContent;
-    private createRegionInfoCard;
+    private createRegionInfoLine;
     private createExportSection;
     private createImportSection;
-    private createFormatGuide;
+    private createSection;
+    private createProgressBlock;
+    private createFooter;
     private attachEventListeners;
     private handleExport;
     private handleImport;
-    private createFooter;
-    destroy(): void;
 }
+export {};

package/dist/ui/translations/ar.d.ts

@@ -95,9 +95,6 @@ export declare const ar: {
     readonly 'styleSelection.title': "اختر نمط غير متصل";
     readonly 'styleSelection.message': "اختر النمط غير المتصل الذي تريد تحميله:";
     readonly 'styleSelection.sources': "مصادر";
-    readonly 'importExport.title': "استيراد/تصدير";
-    readonly 'importExport.export': "تصدير";
-    readonly 'importExport.import': "استيراد";
     readonly 'error.loadingContent': "خطأ في تحميل المحتوى";
     readonly 'error.tryAgain': "يرجى المحاولة مرة أخرى";
     readonly 'error.mapNotInitialized': "الخريطة غير مهيأة. يرجى التأكد من تحميل الخريطة قبل تحميل النمط.";
@@ -117,40 +114,29 @@ export declare const ar: {
     readonly 'regionDetails.bounds': "الحدود";
     readonly 'regionDetails.zoomRange': "نطاق التكبير";
     readonly 'regionDetails.created': "تاريخ الإنشاء";
-    readonly 'importExport.regionTitle': "استيراد/تصدير المنطقة";
-    readonly 'importExport.regionInfo': "معلومات المنطقة";
-    readonly 'importExport.id': "المعرف";
-    readonly 'importExport.name': "الاسم";
-    readonly 'importExport.unnamed': "بدون اسم";
-    readonly 'importExport.zoom': "التكبير";
-    readonly 'importExport.created': "تاريخ الإنشاء";
-    readonly 'importExport.exportRegion': "تصدير المنطقة";
-    readonly 'importExport.exportFormat': "تنسيق التصدير";
-    readonly 'importExport.formatJson': "JSON - بيانات كاملة (موصى به)";
-    readonly 'importExport.formatPmtiles': "PMTiles - بلاطات محسنة للويب";
-    readonly 'importExport.formatMbtiles': "MBTiles - معيار الصناعة";
-    readonly 'importExport.formatHint': "اختر التنسيق بناءً على حالة استخدامك";
-    readonly 'importExport.includeComponents': "تضمين المكونات";
-    readonly 'importExport.styleConfig': "إعدادات النمط";
-    readonly 'importExport.mapTiles': "بلاطات الخريطة";
-    readonly 'importExport.spritesIcons': "الرموز والأيقونات";
-    readonly 'importExport.fontsGlyphs': "الخطوط والحروف";
-    readonly 'importExport.preparingExport': "جاري تجهيز التصدير...";
-    readonly 'importExport.exportComplete': "اكتمل التصدير!";
-    readonly 'importExport.exportFailed': "فشل التصدير. يرجى المحاولة مرة أخرى.";
-    readonly 'importExport.importRegion': "استيراد المنطقة";
-    readonly 'importExport.selectFile': "اختر ملف";
-    readonly 'importExport.fileFormatsHint': "يدعم تنسيقات JSON و PMTiles و MBTiles";
-    readonly 'importExport.newRegionName': "اسم المنطقة الجديد (اختياري)";
-    readonly 'importExport.newRegionNamePlaceholder': "اتركه فارغاً لاستخدام الاسم الأصلي";
-    readonly 'importExport.overwriteIfExists': "الكتابة فوق المنطقة الموجودة";
-    readonly 'importExport.preparingImport': "جاري تجهيز الاستيراد...";
-    readonly 'importExport.importComplete': "اكتمل الاستيراد!";
-    readonly 'importExport.importFailed': "فشل الاستيراد. يرجى المحاولة مرة أخرى.";
-    readonly 'importExport.formatGuide': "دليل التنسيقات";
-    readonly 'importExport.jsonDesc': "بيانات كاملة، قابلة للقراءة، الأفضل للتطوير";
-    readonly 'importExport.pmtilesDesc': "محسن للويب، خدمة فعالة، متوافق مع السحابة";
-    readonly 'importExport.mbtilesDesc': "معيار الصناعة، قائم على SQLite، متعدد المنصات";
+    readonly 'mbtiles.title': "استيراد / تصدير MBTiles";
+    readonly 'mbtiles.regionInfo': "معلومات المنطقة";
+    readonly 'mbtiles.id': "المعرف";
+    readonly 'mbtiles.name': "الاسم";
+    readonly 'mbtiles.unnamed': "بدون اسم";
+    readonly 'mbtiles.zoom': "التكبير";
+    readonly 'mbtiles.created': "تاريخ الإنشاء";
+    readonly 'mbtiles.exportTitle': "التصدير كـ MBTiles";
+    readonly 'mbtiles.exportHint': "احزم بلاطات هذه المنطقة داخل أرشيف MBTiles (SQLite) يمكن فتحه في QGIS و tippecanoe وأدوات أخرى.";
+    readonly 'mbtiles.exportButton': "تنزيل ملف mbtiles.";
+    readonly 'mbtiles.preparingExport': "جاري تجهيز التصدير...";
+    readonly 'mbtiles.exportComplete': "اكتمل التصدير!";
+    readonly 'mbtiles.exportFailed': "فشل التصدير. يرجى المحاولة مرة أخرى.";
+    readonly 'mbtiles.importTitle': "الاستيراد من MBTiles";
+    readonly 'mbtiles.selectFile': "اختر ملف mbtiles.";
+    readonly 'mbtiles.fileHint': "تُدعم ملفات mbtiles. بتنسيق SQLite فقط.";
+    readonly 'mbtiles.newRegionName': "اسم المنطقة الجديد (اختياري)";
+    readonly 'mbtiles.newRegionNamePlaceholder': "اتركه فارغًا لاستخدام الاسم من الملف";
+    readonly 'mbtiles.overwriteIfExists': "الكتابة فوق المنطقة إذا كان المعرف موجودًا";
+    readonly 'mbtiles.importButton': "استيراد ملف mbtiles.";
+    readonly 'mbtiles.preparingImport': "جاري تجهيز الاستيراد...";
+    readonly 'mbtiles.importComplete': "اكتمل الاستيراد!";
+    readonly 'mbtiles.importFailed': "فشل الاستيراد. يرجى المحاولة مرة أخرى.";
     readonly 'download.activeCount': "التحميلات النشطة ({{count}})";
     readonly 'panel.downloadedRegions': "المناطق المحملة";
     readonly 'panel.noExpiry': "بدون انتهاء";

package/dist/ui/translations/en.d.ts

@@ -94,9 +94,6 @@ export declare const en: {
     readonly 'styleSelection.title': "Select Offline Style";
     readonly 'styleSelection.message': "Choose which offline style to load:";
     readonly 'styleSelection.sources': "sources";
-    readonly 'importExport.title': "Import/Export";
-    readonly 'importExport.export': "Export";
-    readonly 'importExport.import': "Import";
     readonly 'error.loadingContent': "Error loading content";
     readonly 'error.tryAgain': "Please try again";
     readonly 'error.mapNotInitialized': "Map is not initialized. Please ensure the map is loaded before loading a style.";
@@ -116,40 +113,29 @@ export declare const en: {
     readonly 'regionDetails.bounds': "Bounds";
     readonly 'regionDetails.zoomRange': "Zoom Range";
     readonly 'regionDetails.created': "Created";
-    readonly 'importExport.regionTitle': "Import/Export Region";
-    readonly 'importExport.regionInfo': "Region Information";
-    readonly 'importExport.id': "ID";
-    readonly 'importExport.name': "Name";
-    readonly 'importExport.unnamed': "Unnamed";
-    readonly 'importExport.zoom': "Zoom";
-    readonly 'importExport.created': "Created";
-    readonly 'importExport.exportRegion': "Export Region";
-    readonly 'importExport.exportFormat': "Export Format";
-    readonly 'importExport.formatJson': "JSON - Complete data (recommended)";
-    readonly 'importExport.formatPmtiles': "PMTiles - Web optimized tiles";
-    readonly 'importExport.formatMbtiles': "MBTiles - Industry standard";
-    readonly 'importExport.formatHint': "Choose format based on your use case";
-    readonly 'importExport.includeComponents': "Include Components";
-    readonly 'importExport.styleConfig': "Style Configuration";
-    readonly 'importExport.mapTiles': "Map Tiles";
-    readonly 'importExport.spritesIcons': "Sprites & Icons";
-    readonly 'importExport.fontsGlyphs': "Fonts & Glyphs";
-    readonly 'importExport.preparingExport': "Preparing export...";
-    readonly 'importExport.exportComplete': "Export complete!";
-    readonly 'importExport.exportFailed': "Export failed. Please try again.";
-    readonly 'importExport.importRegion': "Import Region";
-    readonly 'importExport.selectFile': "Select File";
-    readonly 'importExport.fileFormatsHint': "Supports JSON, PMTiles, and MBTiles formats";
-    readonly 'importExport.newRegionName': "New Region Name (Optional)";
-    readonly 'importExport.newRegionNamePlaceholder': "Leave empty to use original name";
-    readonly 'importExport.overwriteIfExists': "Overwrite if region exists";
-    readonly 'importExport.preparingImport': "Preparing import...";
-    readonly 'importExport.importComplete': "Import complete!";
-    readonly 'importExport.importFailed': "Import failed. Please try again.";
-    readonly 'importExport.formatGuide': "Format Guide";
-    readonly 'importExport.jsonDesc': "Complete data, human-readable, best for development";
-    readonly 'importExport.pmtilesDesc': "Web-optimized, efficient serving, cloud-friendly";
-    readonly 'importExport.mbtilesDesc': "Industry standard, SQLite-based, cross-platform";
+    readonly 'mbtiles.title': "MBTiles Import / Export";
+    readonly 'mbtiles.regionInfo': "Region Information";
+    readonly 'mbtiles.id': "ID";
+    readonly 'mbtiles.name': "Name";
+    readonly 'mbtiles.unnamed': "Unnamed";
+    readonly 'mbtiles.zoom': "Zoom";
+    readonly 'mbtiles.created': "Created";
+    readonly 'mbtiles.exportTitle': "Export as MBTiles";
+    readonly 'mbtiles.exportHint': "Package the tiles in this region into a standard SQLite MBTiles archive that opens in QGIS, tippecanoe, and other tools.";
+    readonly 'mbtiles.exportButton': "Download .mbtiles";
+    readonly 'mbtiles.preparingExport': "Preparing export...";
+    readonly 'mbtiles.exportComplete': "Export complete!";
+    readonly 'mbtiles.exportFailed': "Export failed. Please try again.";
+    readonly 'mbtiles.importTitle': "Import from MBTiles";
+    readonly 'mbtiles.selectFile': "Select an .mbtiles file";
+    readonly 'mbtiles.fileHint': "Only SQLite-format .mbtiles files are supported.";
+    readonly 'mbtiles.newRegionName': "New Region Name (optional)";
+    readonly 'mbtiles.newRegionNamePlaceholder': "Leave empty to use the name from the file";
+    readonly 'mbtiles.overwriteIfExists': "Overwrite if a region with the same id exists";
+    readonly 'mbtiles.importButton': "Import .mbtiles";
+    readonly 'mbtiles.preparingImport': "Preparing import...";
+    readonly 'mbtiles.importComplete': "Import complete!";
+    readonly 'mbtiles.importFailed': "Import failed. Please try again.";
     readonly 'download.activeCount': "Active Downloads ({{count}})";
     readonly 'panel.downloadedRegions': "Downloaded Regions";
     readonly 'panel.noExpiry': "No expiry";

package/dist/utils/importResolver.d.ts

@@ -31,3 +31,13 @@ export declare function hasImports(style: unknown): boolean;
  * Returns the mutated style.
  */
 export declare function resolveImports(style: BaseStyle, accessToken: string, options?: ResolveImportsOptions): Promise<BaseStyle>;
+/**
+ * Rewrite indoor-only expressions in a style's layers to their outdoor no-op
+ * constants. See the in-line comment in `resolveValue` for why this is needed
+ * for Mapbox Standard when the `imports` wrapper is stripped.
+ *
+ * Safe to call multiple times and on already-downloaded stored styles — the
+ * rewrites are idempotent (after the first pass there are no more
+ * `is-active-floor` / `floor-level` expressions to rewrite).
+ */
+export declare function sanitizeIndoorExpressions(style: BaseStyle): void;

package/dist/utils/index.d.ts

@@ -15,3 +15,4 @@ export * from './convertStyleForSW';
 export * from './swRegistration';
 export * from './cssPrefix';
 export * from './importResolver';
+export * from './sqlJsLoader';

package/dist/utils/sqlJsLoader.d.ts

@@ -0,0 +1,17 @@
+import type { SqlJsStatic } from 'sql.js';
+export interface SqlJsConfig {
+    /** URL where `sql-wasm.wasm` (and any Emscripten runtime files) can be fetched from. */
+    wasmUrl?: string;
+    /** Pre-fetched WASM binary. Takes precedence over `wasmUrl`. Useful in Node / tests. */
+    wasmBinary?: ArrayBuffer | Uint8Array;
+}
+/**
+ * Override how `sql.js` loads its WebAssembly. Call once before any MBTiles
+ * import/export is invoked. Resets any cached init.
+ */
+export declare function configureSqlJs(config: SqlJsConfig): void;
+/**
+ * Lazily initialise `sql.js`. The underlying module is loaded via dynamic
+ * `import()` so it only ships with bundles that actually call MBTiles code.
+ */
+export declare function getSqlJs(): Promise<SqlJsStatic>;

package/dist/utils/styleProviderUtils.d.ts

@@ -7,6 +7,22 @@ import type { BaseStyle, StyleProvider } from '@/types/style';
  * Check if a URL uses the mapbox:// protocol
  */
 export declare function isMapboxProtocol(url: string): boolean;
+/**
+ * Parse a URL and return its hostname, or null if the URL is malformed.
+ * Accepts relative URLs when `base` is provided.
+ */
+export declare function getUrlHostname(url: string, base?: string): string | null;
+/**
+ * True if `url`'s hostname equals `host` or is a subdomain of `host`.
+ * Uses URL parsing (not substring matching) to avoid false positives like
+ * `https://evil.com/?x=mapbox.com` matching `mapbox.com`.
+ */
+export declare function hostMatches(url: string, host: string, base?: string): boolean;
+/**
+ * True for any host under the mapbox.com domain (including api.mapbox.com,
+ * *.tiles.mapbox.com, etc.). Used by provider detection.
+ */
+export declare function isMapboxHost(url: string, base?: string): boolean;
 /**
  * Resolve a mapbox:// URL to its HTTPS API equivalent
  *

package/dist/utils/tileKey.d.ts

@@ -18,6 +18,19 @@ export declare function parseTileKey(key: string): {
     y: number;
     ext: string;
 } | null;
+/**
+ * Extract the extension (the last dotted segment before `?`, `#`, or end) from
+ * a tile URL or tile URL template. Defaults to `"pbf"` when no extension can
+ * be parsed. For multi-extension URLs like Mapbox v4's `{y}.vector.pbf` this
+ * returns `"pbf"`, matching the key used when the tile is stored.
+ *
+ * Keeping extraction logic in one place ensures patchStyleForOffline (which
+ * rewrites tile URLs to `idb://` at load time) derives the same extension
+ * that tileService.extractExtension used at store time — otherwise the
+ * first-try lookup in idbFetchHandler misses and has to fall through its
+ * pbf/mvt/png/jpg/webp fallback loop.
+ */
+export declare function extractTileExtensionFromUrl(url: string): string;
 /**
  * Derive tile extension from tile URL templates
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "map-gl-offline",
-  "version": "0.7.0",
+  "version": "0.8.2",
   "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",
@@ -36,11 +36,12 @@
   },
   "scripts": {
     "dev": "vite",
-    "build": "npm run build:clean && npm run build:lib && npm run build:types && npm run build:css && npm run build:sw",
+    "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:types": "tsc --declaration --emitDeclarationOnly --outDir dist",
     "build:css": "tailwindcss -i src/styles/style.css -o dist/style.css --minify",
+    "build:sw-src": "node scripts/build-sw.mjs",
     "build:sw": "cp public/idb-offline-sw.js dist/idb-offline-sw.js && cp bin/vite-plugin.js dist/vite-plugin.js",
     "build:watch": "rollup -c -w",
     "build:dev": "npm run build:clean && npm run build:lib",
@@ -86,7 +87,6 @@
     "sprites",
     "fonts",
     "glyphs",
-    "pmtiles",
     "mbtiles",
     "import",
     "export",
@@ -107,7 +107,8 @@
     "@turf/difference": "^7.3.4",
     "@turf/helpers": "^7.3.4",
     "i18next": "^25.8.11",
-    "idb": "^8.0.3"
+    "idb": "^8.0.3",
+    "sql.js": "^1.14.1"
   },
   "peerDependencies": {
     "mapbox-gl": ">=2.0.0",
@@ -134,7 +135,9 @@
     "@types/mapbox-gl": "^3.4.1",
     "@types/maplibre-gl": "^1.14.0",
     "@types/node": "^25.3.0",
+    "@types/sql.js": "^1.4.11",
     "autoprefixer": "^10.4.24",
+    "esbuild": "^0.27.3",
     "eslint": "^10.0.0",
     "fake-indexeddb": "^6.2.5",
     "husky": "^9.1.7",