@florasync/leaflet-geokit 0.5.0 → 0.7.0

package/dist/types/src/components/LeafletDrawMapElement.d.ts

@@ -13,6 +13,10 @@ export declare class LeafletDrawMapElement extends HTMLElement implements Leafle
     private _maxZoom?;
     private _tileUrl;
     private _tileAttribution?;
+    private _tileProvider?;
+    private _tileStyle?;
+    private _apiKey?;
+    private _activeTileProvider;
     private _readOnly;
     private _logLevel;
     private _devOverlay;
@@ -33,6 +37,9 @@ export declare class LeafletDrawMapElement extends HTMLElement implements Leafle
     disconnectedCallback(): Promise<void>;
     static get observedAttributes(): string[];
     attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
+    private _updateTileLayer;
+    private _handleTileProviderError;
+    private _emitTileProviderChanged;
     get latitude(): number;
     set latitude(v: number);
     get longitude(): number;
@@ -45,6 +52,12 @@ export declare class LeafletDrawMapElement extends HTMLElement implements Leafle
     set maxZoom(v: number | undefined);
     get tileUrl(): string;
     set tileUrl(v: string);
+    get tileProvider(): string | undefined;
+    set tileProvider(v: string | undefined);
+    get tileStyle(): string | undefined;
+    set tileStyle(v: string | undefined);
+    get apiKey(): string | undefined;
+    set apiKey(v: string | undefined);
     get tileAttribution(): string | undefined;
     set tileAttribution(v: string | undefined);
     get readOnly(): boolean;
@@ -88,6 +101,11 @@ export declare class LeafletDrawMapElement extends HTMLElement implements Leafle
     loadGeoJSONFromText(text: string): Promise<void>;
     private _currentConfig;
     private _applyThemeStyles;
+    private _syncApiKeyFromAttributes;
+    private _normalizeText;
+    private _resolveTileProviderErrorCode;
+    private _resolveHereTileLayerErrorCode;
+    private _describeTileLayerError;
     private _reflect;
     private _booleanReflect;
     private _coerceNumber;

package/dist/types/src/lib/MapController.d.ts

@@ -4,6 +4,7 @@ import "leaflet-ruler";
 import type { Feature, FeatureCollection } from "geojson";
 import type { DrawControlsConfig, MapConfig, MeasurementSystem } from "@src/types/public";
 import { type Logger } from "@src/utils/logger";
+import type { TileURLTemplate } from "@src/lib/TileProviderFactory";
 export interface MapControllerCallbacks {
     onReady?: (detail: {
         bounds?: [[number, number], [number, number]];
@@ -38,6 +39,9 @@ export interface MapControllerOptions {
     /** Prefer external Leaflet if available (falls back to bundled if missing/invalid). */
     useExternalLeaflet?: boolean;
 }
+interface TileLayerCallbacks {
+    onTileError?: (error: unknown) => void;
+}
 /**
  * MapController: initializes Leaflet map + Draw, bridges events, and manages data via FeatureStore.
  */
@@ -48,6 +52,7 @@ export declare class MapController {
     private L;
     private store;
     private map;
+    private tileLayer;
     private drawnItems;
     private drawControl;
     private rulerControl;
@@ -76,6 +81,7 @@ export declare class MapController {
     fitBoundsToData(paddingRatio?: number): Promise<void>;
     fitBounds(boundsTuple: [[number, number], [number, number]], paddingRatio?: number): Promise<void>;
     setView(lat: number, lng: number, zoom?: number): Promise<void>;
+    setTileLayer(config: TileURLTemplate, callbacks?: TileLayerCallbacks): void;
     /**
      * Merge all visible polygon features into a single polygon feature.
      * This removes the original features and adds a new feature with the merged geometry.
@@ -119,3 +125,4 @@ export declare class MapController {
     private showMoveConfirmationUI;
     private hideMoveConfirmationUI;
 }
+export {};

package/dist/types/src/lib/TileProviderFactory.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Configuration for selecting and customizing a tile provider.
+ */
+export interface TileProviderConfig {
+    /** Tile provider identifier (e.g., "osm", "here"). */
+    provider: "osm" | "here" | string;
+    /** Optional visual style name (used by style-capable providers like HERE). */
+    style?: string;
+    /** Optional API key used by authenticated providers like HERE Maps. */
+    apiKey?: string;
+    /** Optional attribution override for the selected provider. */
+    attribution?: string;
+}
+/**
+ * Resolved tile layer template configuration used to create a Leaflet tile layer.
+ */
+export interface TileURLTemplate {
+    /** URL template containing Leaflet placeholders such as {z}, {x}, and {y}. */
+    urlTemplate: string;
+    /** Attribution string displayed on the map. */
+    attribution: string;
+    /** Maximum zoom level supported by the provider. */
+    maxZoom?: number;
+    /** Optional tile subdomains for providers that shard traffic by hostname. */
+    subdomains?: string[];
+}
+/**
+ * Build tile layer URL and metadata for the selected provider.
+ *
+ * HERE-specific behavior:
+ * - Requires a non-empty API key
+ * - Uses `lite.day` as default style when style is omitted/invalid
+ */
+export declare function buildTileURL(config: TileProviderConfig): TileURLTemplate;
+/**
+ * Validate provider configuration before tile URL construction.
+ *
+ * Rules:
+ * - `provider` is required
+ * - HERE provider requires a non-empty `apiKey`
+ */
+export declare function validateProviderConfig(config: TileProviderConfig): {
+    valid: boolean;
+    error?: string;
+};

package/dist/types/src/types/public.d.ts

@@ -48,6 +48,58 @@ export interface DrawControlsConfig {
     delete?: boolean;
     ruler?: boolean;
 }
+/**
+ * Configuration for tile provider selection and styling
+ */
+export interface TileProviderConfig {
+    /** Tile provider identifier (e.g., "osm", "here") */
+    provider: "osm" | "here" | string;
+    /** Provider-specific style (e.g., "lite.day" for HERE) */
+    style?: string;
+    /** API key for authenticated providers */
+    apiKey?: string;
+    /** Optional override for tile attribution text */
+    attribution?: string;
+}
+/**
+ * Tile layer configuration with URL template and provider settings
+ */
+export interface TileURLTemplate {
+    /** Leaflet tile URL template (e.g., "https://{s}.domain.com/{z}/{x}/{y}.png") */
+    urlTemplate: string;
+    /** Attribution text displayed on the map */
+    attribution: string;
+    /** Maximum zoom level supported */
+    maxZoom?: number;
+    /** Tile subdomains for load balancing */
+    subdomains?: string[];
+}
+/**
+ * Event detail for tile provider errors
+ */
+export interface TileProviderErrorDetail {
+    /** Error code identifying the failure type */
+    code: "missing_api_key" | "invalid_api_key" | "permission_denied" | "tile_load_failed" | "unknown_provider";
+    /** Human-readable error message */
+    message: string;
+    /** Provider identifier where the error occurred */
+    provider: string;
+    /** Unix timestamp when error occurred */
+    timestamp: number;
+}
+/**
+ * Event detail for successful tile provider changes
+ */
+export interface TileProviderChangedDetail {
+    /** New active provider */
+    provider: string;
+    /** New active style (if applicable) */
+    style?: string;
+    /** Previously active provider */
+    previousProvider: string;
+    /** Unix timestamp when change occurred */
+    timestamp: number;
+}
 /**
  * Public API that the custom element exposes (methods/properties).
  * This is provided for typing in TS consumers who may cast the element.
@@ -70,6 +122,12 @@ export interface LeafletDrawMapElementAPI {
     skipLeafletStyles?: boolean;
     /** Optional injection of a pre-existing Leaflet namespace to use instead of bundled import. */
     leafletInstance?: typeof Leaflet;
+    /** Tile provider identifier (e.g., "osm", "here") */
+    tileProvider?: "osm" | "here" | string;
+    /** Provider-specific style (e.g., "lite.day" for HERE) */
+    tileStyle?: string;
+    /** API key for authenticated providers */
+    apiKey?: string;
     getGeoJSON(): Promise<FeatureCollection>;
     loadGeoJSON(fc: FeatureCollection): Promise<void>;
     clearLayers(): Promise<void>;

package/dist/types/tests/component-branch-coverage.spec.d.ts

@@ -0,0 +1 @@
+import "@src/index";

package/dist/types/tests/component-tile-provider.spec.d.ts

@@ -0,0 +1 @@
+import "@src/index";

package/dist/types/tests/tile-provider-factory.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@florasync/leaflet-geokit",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Framework-agnostic Leaflet + Leaflet.draw web component with TypeScript, verbose logging, and tests.",
   "type": "module",
   "main": "./dist/leaflet-geokit.umd.js",
@@ -124,6 +124,7 @@
     }
   },
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
     "@playwright/test": "^1.58.2",
     "@preact/preset-vite": "^2.8.0",
     "@testing-library/dom": "^10.4.0",
@@ -135,12 +136,13 @@
     "@types/node": "^22.0.0",
     "@types/react": "^18.3.12",
     "@types/react-dom": "^18.3.1",
-    "@typescript-eslint/eslint-plugin": "^8.0.1",
-    "@typescript-eslint/parser": "^8.0.1",
-    "@vitest/coverage-v8": "^3.2.4",
+    "@typescript-eslint/eslint-plugin": "^8.56.0",
+    "@typescript-eslint/parser": "^8.56.0",
+    "@vitest/coverage-v8": "^4.0.18",
     "baseline-browser-mapping": "^2.9.17",
-    "eslint": "^9.9.0",
-    "happy-dom": "^18.0.1",
+    "eslint": "^10.0.0",
+    "globals": "^17.3.0",
+    "happy-dom": "^20.6.3",
     "husky": "^9.1.7",
     "lint-staged": "^15.2.10",
     "preact": "^10.28.3",
@@ -150,7 +152,7 @@
     "rollup-plugin-visualizer": "^6.0.5",
     "typescript": "^5.5.4",
     "vite": "^7.1.4",
-    "vitest": "^3.2.4"
+    "vitest": "^4.0.18"
   },
   "lint-staged": {
     "*.{ts,tsx,js,jsx}": [
@@ -160,5 +162,8 @@
     "*.{json,md,css,scss,html,yml,yaml}": [
       "prettier --write"
     ]
+  },
+  "overrides": {
+    "minimatch": "^10.2.1"
   }
 }