maplibre-gl-layer-control 0.5.0 → 0.6.0

package/dist/maplibre-gl-layer-control.css

@@ -894,3 +894,15 @@
 .background-legend-layer-list::-webkit-scrollbar-thumb:hover {
   background: #a8a8a8;
 }
+
+/* Custom layer info panel */
+.layer-control-custom-info-text {
+  margin: 0;
+  padding: 8px;
+  font-size: 11px;
+  line-height: 1.5;
+  color: #666;
+  background: #f0f4f8;
+  border-radius: 4px;
+  border-left: 3px solid #2f6fed;
+}

package/dist/types/index.d.ts

@@ -27,6 +27,107 @@ export declare function createBackgroundGroupSymbolSVG(size?: number): string;
  */
 export declare function createLayerSymbolSVG(layerType: string, color: string | null, options?: SymbolOptions): string;
 
+/**
+ * Adapter interface for custom (non-MapLibre) layers.
+ * Implement this interface to integrate custom layer types (e.g., deck.gl layers)
+ * with the layer control.
+ */
+export declare interface CustomLayerAdapter {
+    /** Unique type identifier for this adapter (e.g., 'cog', 'zarr', 'deck') */
+    type: string;
+    /** Get all layer IDs managed by this adapter */
+    getLayerIds(): string[];
+    /** Get the current state of a layer */
+    getLayerState(layerId: string): LayerState | null;
+    /** Set layer visibility */
+    setVisibility(layerId: string, visible: boolean): void;
+    /** Set layer opacity (0-1) */
+    setOpacity(layerId: string, opacity: number): void;
+    /** Get display name for a layer */
+    getName(layerId: string): string;
+    /** Get layer symbol type for UI display (optional) */
+    getSymbolType?(layerId: string): string;
+    /**
+     * Subscribe to layer changes (add/remove).
+     * Returns an unsubscribe function.
+     */
+    onLayerChange?(callback: (event: 'add' | 'remove', layerId: string) => void): () => void;
+}
+
+/**
+ * Registry for managing custom layer adapters.
+ * Routes layer operations to the appropriate adapter based on layer ID.
+ */
+export declare class CustomLayerRegistry {
+    private adapters;
+    private changeListeners;
+    private unsubscribers;
+    /**
+     * Register a custom layer adapter.
+     * @param adapter The adapter to register
+     */
+    register(adapter: CustomLayerAdapter): void;
+    /**
+     * Unregister an adapter by type.
+     * @param type The adapter type to unregister
+     */
+    unregister(type: string): void;
+    /**
+     * Get all custom layer IDs across all adapters.
+     * @returns Array of layer IDs
+     */
+    getAllLayerIds(): string[];
+    /**
+     * Check if a layer ID is managed by any adapter.
+     * @param layerId The layer ID to check
+     * @returns true if the layer is managed by an adapter
+     */
+    hasLayer(layerId: string): boolean;
+    /**
+     * Get the adapter responsible for a specific layer.
+     * @param layerId The layer ID
+     * @returns The adapter or null if not found
+     */
+    getAdapterForLayer(layerId: string): CustomLayerAdapter | null;
+    /**
+     * Get the state of a custom layer.
+     * @param layerId The layer ID
+     * @returns The layer state or null if not found
+     */
+    getLayerState(layerId: string): LayerState | null;
+    /**
+     * Set visibility of a custom layer.
+     * @param layerId The layer ID
+     * @param visible Whether the layer should be visible
+     * @returns true if the operation was handled by an adapter
+     */
+    setVisibility(layerId: string, visible: boolean): boolean;
+    /**
+     * Set opacity of a custom layer.
+     * @param layerId The layer ID
+     * @param opacity The opacity value (0-1)
+     * @returns true if the operation was handled by an adapter
+     */
+    setOpacity(layerId: string, opacity: number): boolean;
+    /**
+     * Get the symbol type for a custom layer (for UI display).
+     * @param layerId The layer ID
+     * @returns The symbol type or null if not available
+     */
+    getSymbolType(layerId: string): string | null;
+    /**
+     * Subscribe to layer changes across all adapters.
+     * @param callback Function called when layers are added or removed
+     * @returns Unsubscribe function
+     */
+    onChange(callback: (event: 'add' | 'remove', layerId: string) => void): () => void;
+    private notifyChange;
+    /**
+     * Clean up all subscriptions and adapters.
+     */
+    destroy(): void;
+}
+
 /**
  * Darken a hex color by a given amount
  * @param hexColor The hex color to darken (e.g., '#ff0000')
@@ -102,6 +203,8 @@ export declare class LayerControl implements IControl {
     private showOpacitySlider;
     private showLayerSymbol;
     private excludeDrawnLayers;
+    private customLayerRegistry;
+    private customLayerUnsubscribe;
     private widthSliderEl;
     private widthThumbEl;
     private widthValueEl;
@@ -300,6 +403,10 @@ export declare class LayerControl implements IControl {
      * Open style editor for a layer
      */
     private openStyleEditor;
+    /**
+     * Create info panel for custom layers (style editing not supported)
+     */
+    private createCustomLayerInfoPanel;
     /**
      * Close style editor for a layer
      */
@@ -384,6 +491,8 @@ export declare interface LayerControlOptions {
     panelMaxHeight?: number;
     /** Whether to exclude drawn layers from drawing libraries like Geoman, Mapbox GL Draw, etc. (default: true) */
     excludeDrawnLayers?: boolean;
+    /** Custom layer adapters for non-MapLibre layers (e.g., deck.gl COG layers, Zarr layers) */
+    customLayerAdapters?: CustomLayerAdapter[];
 }
 
 /**
@@ -396,6 +505,10 @@ export declare interface LayerState {
     opacity: number;
     /** Display name for the layer */
     name: string;
+    /** Whether this is a custom (non-MapLibre) layer */
+    isCustomLayer?: boolean;
+    /** Custom layer type identifier (e.g., 'cog', 'zarr') */
+    customLayerType?: string;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "maplibre-gl-layer-control",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "A comprehensive layer control for MapLibre GL with advanced styling capabilities",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -91,6 +91,6 @@
     "vitest": "^2.1.0"
   },
   "dependencies": {
-    "maplibre-gl-layer-control": "^0.2.0"
+    "maplibre-gl-layer-control": "^0.5.1"
   }
 }