map-gl-offline 0.6.0 → 0.8.2

package/dist/sw/shared.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Pure helpers shared between the main-thread offline fetch handler
+ * (`src/utils/idbFetchHandler.ts`) and the offline Service Worker
+ * (`src/sw/offline-sw.ts`, compiled to `public/idb-offline-sw.js`).
+ *
+ * Keeping these in one place means the SW and the main-thread handler
+ * can't drift — adding a new `model` handler, changing the fallback
+ * order, or tweaking the tilejson-source matcher happens once.
+ *
+ * Nothing in here touches IndexedDB directly. Each helper takes already-
+ * resolved inputs and returns the list of candidate keys (or the
+ * resolved output) that the caller feeds into its own IDB lookup.
+ *
+ * The corresponding IDB access layer is:
+ *   - main thread: `idb` library via `dbPromise`
+ *   - service worker: raw `indexedDB.open` (see `offline-sw.ts`)
+ *
+ * They have different shapes so cannot be shared; the key computation
+ * can be and is.
+ */
+export declare const OFFLINE_PREFIX = "/__offline__/";
+export declare const DB_NAME = "offline-map-db";
+/**
+ * Minimal stored-style shape used for region-by-style lookup and
+ * tilejson source resolution.
+ */
+export interface StyleEntryLike {
+    key: string;
+    style?: {
+        sources?: Record<string, unknown>;
+    };
+    regions?: Array<{
+        id?: string;
+        regionId?: string;
+    }>;
+}
+/** Canonical tile key format used across stores. Keep in sync with `tileKey.ts`. */
+export declare function makeTileKey(x: number, y: number, z: number, styleId: string, sourceId: string, ext: string): string;
+/**
+ * Extensions to try in order when the requested extension misses. `glb` is
+ * last so batched-model sources (Mapbox Standard 3D buildings) resolve when
+ * their source URL template ended in `.vector` or similar and the actual
+ * tile body was stored as glb.
+ */
+export declare const TILE_FALLBACK_EXTENSIONS: readonly ["pbf", "mvt", "png", "jpg", "webp", "glb"];
+/** Extensions minus the one the caller already tried. */
+export declare function tileFallbackExtensions(requested: string): string[];
+/** Extract `.../{y}.ext` → `{ y, ext }`. Returns null if the path isn't a tile filename. */
+export declare function parseTileYExt(yExt: string): {
+    y: number;
+    ext: string;
+} | null;
+/**
+ * Given an already-fetched list of style entries, find the first one whose
+ * `regions` array contains the given ID. Pure — the caller is responsible for
+ * loading the entries and for caching. Used by both `findStyleByRegionId`
+ * implementations to keep the match rule identical.
+ */
+export declare function findStyleByRegionIdIn(styles: readonly StyleEntryLike[], regionId: string): StyleEntryLike | null;
+/**
+ * Parse `FontA,FontB,FontC/0-255.pbf` into (fontstacks, rangePart). Mapbox
+ * requests a comma-joined font-family fallback chain; each glyph is stored
+ * individually, so the caller tries each fontstack in order.
+ */
+export declare function parseGlyphPath(decodedPath: string): {
+    fontstacks: string[];
+    rangePart: string;
+};
+/**
+ * Build the list of keys to try for a single (fontstack, range) pair.
+ * Order: actualStyleId variants first (most common), then downloadId,
+ * then the bare path. Normalized and raw `.pbf`-less forms are both tried
+ * to cover stored-key variants from older versions.
+ */
+export declare function glyphCandidateKeys(actualStyleId: string, downloadId: string, fontstack: string, rangePart: string): string[];
+/**
+ * Sprite keys have historically used both `::` and `:` as the separator, and
+ * both the full filename (`sprite.json`) and the bare name (`sprite`). Return
+ * every variant in priority order; the caller stops at the first hit.
+ */
+export declare function spriteCandidateKeys(actualStyleId: string, downloadId: string, decodedPath: string): string[];
+/**
+ * Model keys are `{styleId}::model::{name}`. Try the resolved style id first,
+ * then the bare downloadId in case the request came through the region-scoped
+ * URL form (`idb://{regionId}/model/{name}`).
+ */
+export declare function modelCandidateKeys(actualStyleId: string, downloadId: string, decodedPath: string): string[];
+/**
+ * Mapbox GL requests tilejson via `idb://{downloadId}/tilesjson/{path}` where
+ * `{path}` may be the source id, the original TileJSON URL, or the URL we
+ * stashed under `__originalTilesetUrl` when patching for offline. Try all
+ * three; return the matching source id + its config, or null.
+ */
+export declare function matchTileJsonSource(sources: Record<string, unknown>, decodedPath: string): {
+    sourceId: string;
+    config: Record<string, unknown>;
+} | null;
+/**
+ * Build the offline TileJSON payload that replaces the one Mapbox would
+ * have fetched from the network. `tiles` is rewritten to serve from the SW
+ * (the caller supplies the scheme via `tileUrlScheme`); copyable TileJSON
+ * fields are preserved.
+ */
+export declare function buildOfflineTileJson(sourceConfig: Record<string, unknown>, downloadId: string, sourceId: string, extension: string, tileUrlScheme: 'idb' | 'offline', origin?: string): Record<string, unknown>;
+/** First-match extension derivation, same rule as `tileKey.extractTileExtensionFromUrl`. */
+export declare function deriveTileExtensionFromTiles(tiles: unknown): string;
+/** RFC 1952 gzip magic bytes: 1f 8b. */
+export declare function isGzipped(buffer: ArrayBuffer): boolean;

package/dist/types/database.d.ts

@@ -5,6 +5,7 @@ import type { FontEntry } from './font';
 import type { TileEntry } from './tile';
 import type { SpriteEntry } from './sprite';
 import type { GlyphEntry } from './glyph';
+import type { ModelEntry } from './model';
 export interface OfflineMapDB extends DBSchema {
     /**
      * @deprecated Regions are now stored inside styles.regions[] array.
@@ -35,4 +36,12 @@ export interface OfflineMapDB extends DBSchema {
         key: string;
         value: FontEntry;
     };
+    /**
+     * 3D model files (.glb) referenced by `style.models` entries. Used by
+     * Mapbox Standard for tree / wind-turbine model layers.
+     */
+    models: {
+        key: string;
+        value: ModelEntry;
+    };
 }

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/types/index.d.ts

@@ -4,6 +4,7 @@ export * from './font';
 export * from './tile';
 export * from './sprite';
 export * from './glyph';
+export * from './model';
 export * from './database';
 export * from './maintenance';
 export * from './progress';

package/dist/types/model.d.ts

@@ -0,0 +1,62 @@
+import { DownloadProgress } from './progress';
+/**
+ * 3D model asset (e.g. a tree or turbine .glb) stored in IndexedDB.
+ *
+ * Mapbox Standard references 32 models via the top-level `style.models`
+ * dictionary (`{ "maple1-lod1": "mapbox://models/mapbox/maple1-v4-lod1.glb" }`).
+ * Layers of type `model` then pick one by name at render time.
+ */
+export interface ModelEntry {
+    /** Storage key: `{styleId}::model::{modelName}`. */
+    key: string;
+    /** Model binary (.glb / .gltf) as ArrayBuffer. */
+    data: ArrayBuffer;
+    /** HTTP Content-Type (usually `model/gltf-binary`). */
+    contentType: string;
+    /** Byte length. */
+    size: number;
+    /** URL the model was downloaded from. */
+    url: string;
+    /** Style this model belongs to. */
+    styleId: string;
+    /** Model name (the key in `style.models`). */
+    modelName: string;
+    /** Last-Modified or download timestamp (ms since epoch). */
+    lastModified: number;
+    /** ISO 8601 download timestamp. */
+    downloadedAt: string;
+    /** Optional expiry from HTTP Cache-Control. */
+    expires?: number;
+}
+/** Options for `downloadModels`. */
+export interface ModelDownloadOptions {
+    onProgress?: (progress: DownloadProgress) => void;
+    batchSize?: number;
+    maxRetries?: number;
+    skipExisting?: boolean;
+    timeoutMs?: number;
+}
+/** Result of a model download batch. */
+export interface ModelDownloadResult {
+    totalModels: number;
+    downloadedModels: number;
+    skippedModels: number;
+    failedModels: number;
+    totalSize: number;
+    errors: Array<{
+        url: string;
+        error: string;
+    }>;
+}
+/** Aggregate stats across stored models. */
+export interface EnhancedModelStats {
+    count: number;
+    totalSize: number;
+    averageSize: number;
+    models: Array<{
+        name: string;
+        size: number;
+        lastModified?: number;
+    }>;
+    modelsByStyle: Record<string, number>;
+}

package/dist/types/region.d.ts

@@ -2,11 +2,12 @@ import type { StyleProvider } from './style';
 import type { TileDownloadOptions, TileDownloadResult } from './tile';
 import type { SpriteDownloadResult } from './sprite';
 import type { GlyphDownloadResult } from './glyph';
+import type { ModelDownloadResult } from './model';
 import type { StyleDownloadResult } from './style';
 /**
  * Phase of a region download pipeline, reported via `DownloadRegionOptions.onProgress`.
  */
-export type DownloadRegionPhase = 'style' | 'sprites' | 'glyphs' | 'tiles' | 'metadata';
+export type DownloadRegionPhase = 'style' | 'sprites' | 'glyphs' | 'models' | 'tiles' | 'metadata';
 /**
  * Progress update emitted by `OfflineMapManager.downloadRegion`.
  */
@@ -31,6 +32,14 @@ export interface DownloadRegionOptions {
     skipGlyphs?: boolean;
     /** Skip sprite download entirely. Default: false. */
     skipSprites?: boolean;
+    /**
+     * Skip 3D model download. Default: false. Models (e.g. Mapbox Standard
+     * trees / wind turbines) are declared via `style.models` and live at
+     * `mapbox://models/…` URLs that only Mapbox serves. Skip for styles that
+     * don't use model layers, or to reduce storage footprint at the cost of
+     * missing tree/turbine rendering.
+     */
+    skipModels?: boolean;
     /** Override Unicode glyph ranges fetched per font. Defaults to `GLYPH_CONFIG.COMPREHENSIVE_RANGES`. */
     glyphRanges?: string[];
     /** Extra options forwarded to the tile download step. */
@@ -45,6 +54,7 @@ export interface DownloadRegionResult {
     styleResult?: StyleDownloadResult;
     spriteResults: SpriteDownloadResult[];
     glyphResult?: GlyphDownloadResult;
+    modelResult?: ModelDownloadResult;
     tileResult: TileDownloadResult;
 }
 /**

package/dist/types/style.d.ts

@@ -19,8 +19,17 @@ export interface BaseStyle {
         data?: BaseStyle;
         config?: Record<string, unknown>;
     }>;
-    models?: Record<string, {
-        uri: string;
+    /**
+     * 3D model declarations used by `model` layers (Mapbox Standard trees /
+     * wind turbines). Two shapes are accepted in the wild:
+     *
+     * - Mapbox Standard format — values are plain URI strings:
+     *   `{ "maple1-lod1": "mapbox://models/mapbox/maple1-v4-lod1.glb" }`
+     * - Older / generic format — values wrap the URI in an object:
+     *   `{ "name": { "uri": "mapbox://..." } }`
+     */
+    models?: Record<string, string | {
+        uri?: string;
         [key: string]: unknown;
     }>;
     [key: string]: unknown;

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/managers/downloadManager.d.ts

@@ -74,7 +74,7 @@ export interface DownloadProgress {
     /** Human-readable description of current activity */
     currentResource: string;
     /** Current download phase */
-    phase?: 'style' | 'sprites' | 'glyphs' | 'tiles';
+    phase?: 'style' | 'sprites' | 'glyphs' | 'models' | 'tiles';
 }
 /**
  * Configuration options for the DownloadManager.

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/constants.d.ts

@@ -3,13 +3,14 @@
  * Centralizes magic numbers and configuration values
  */
 export declare const DB_NAME = "offline-map-db";
-export declare const DB_VERSION = 3;
+export declare const DB_VERSION = 4;
 export declare const STORE_NAMES: {
     readonly TILES: "tiles";
     readonly STYLES: "styles";
     readonly SPRITES: "sprites";
     readonly GLYPHS: "glyphs";
     readonly FONTS: "fonts";
+    readonly MODELS: "models";
 };
 export declare const DOWNLOAD_DEFAULTS: {
     readonly BATCH_SIZE: 10;

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>;