maplibre-gl-components 0.17.3 → 0.18.0

package/dist/types/lib/core/Legend.d.ts

@@ -21,6 +21,8 @@ import { LegendOptions, LegendState, LegendItem, ComponentEvent, ComponentEventH
 export declare class Legend implements IControl {
     private _container?;
     private _options;
+    private _legendOptions?;
+    private _legends;
     private _state;
     private _eventHandlers;
     private _map?;
@@ -107,6 +109,34 @@ export declare class Legend implements IControl {
      * @param handler - The callback function to remove.
      */
     off(event: ComponentEvent, handler: ComponentEventHandler<LegendState>): void;
+    /**
+     * Resolves configured legend entries against the control defaults.
+     *
+     * @returns Array of resolved legend options.
+     */
+    private _resolveLegends;
+    /**
+     * Creates public state from the current legend entries.
+     *
+     * @returns The current legend state.
+     */
+    private _createState;
+    /**
+     * Creates public state for a single legend entry.
+     *
+     * @param legend - The resolved legend options.
+     * @param index - The legend entry index.
+     * @returns The current legend entry state.
+     */
+    private _createLegendState;
+    /**
+     * Gets an entry's configured visibility.
+     *
+     * @param index - The entry index.
+     * @param fallback - The fallback visibility value.
+     * @returns Whether the entry is configured as visible.
+     */
+    private _getLegendEntryVisible;
     /**
      * Emits an event to all registered handlers.
      *
@@ -121,6 +151,20 @@ export declare class Legend implements IControl {
      * Updates the display state based on visibility and zoom level.
      */
     private _updateDisplayState;
+    /**
+     * Checks whether a legend entry is visible at the current zoom.
+     *
+     * @param legend - The resolved legend options.
+     * @param index - The legend entry index.
+     * @returns Whether the legend should be rendered.
+     */
+    private _isLegendVisible;
+    /**
+     * Checks whether any legend entry should be visible.
+     *
+     * @returns Whether at least one legend should be visible.
+     */
+    private _hasVisibleLegends;
     /**
      * Creates the main container element.
      *
@@ -131,9 +175,24 @@ export declare class Legend implements IControl {
      * Creates a color swatch element.
      *
      * @param item - Legend item configuration.
+     * @param legend - The resolved legend options.
      * @returns The swatch element.
      */
     private _createSwatch;
+    /**
+     * Toggles a legend entry.
+     *
+     * @param index - The legend entry index.
+     */
+    private _toggleLegend;
+    /**
+     * Creates a legend entry element.
+     *
+     * @param legend - The resolved legend options.
+     * @param index - The legend entry index.
+     * @returns The legend entry element.
+     */
+    private _createLegendElement;
     /**
      * Renders the legend content.
      */

package/dist/types/lib/core/Legend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Legend.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/Legend.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,UAAU,EACV,cAAc,EACd,qBAAqB,EACtB,MAAM,SAAS,CAAC;AA0BjB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,MAAO,YAAW,QAAQ;IACrC,OAAO,CAAC,UAAU,CAAC,CAAc;IACjC,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,cAAc,CAGR;IACd,OAAO,CAAC,IAAI,CAAC,CAAc;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,YAAY,CAAiB;IAErC;;;;OAIG;gBACS,OAAO,CAAC,EAAE,aAAa;IASnC;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW;IAepC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAWhB;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;OAEG;IACH,QAAQ,IAAI,IAAI;IAQhB;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI;IAOnC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAO/B;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAS/B;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAU7C;;;;OAIG;IACH,QAAQ,IAAI,WAAW;IAIvB;;;;;OAKG;IACH,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,CAAC,WAAW,CAAC,GAAG,IAAI;IAO5E;;;;;OAKG;IACH,GAAG,CACD,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,qBAAqB,CAAC,WAAW,CAAC,GAC1C,IAAI;IAIP;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAQb;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAkErB;;OAEG;IACH,OAAO,CAAC,OAAO;CAwGhB"}
+{"version":3,"file":"Legend.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/Legend.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAGV,aAAa,EACb,WAAW,EACX,UAAU,EACV,cAAc,EACd,qBAAqB,EACtB,MAAM,SAAS,CAAC;AA2BjB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,MAAO,YAAW,QAAQ;IACrC,OAAO,CAAC,UAAU,CAAC,CAAc;IACjC,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,cAAc,CAAC,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,cAAc,CAGR;IACd,OAAO,CAAC,IAAI,CAAC,CAAc;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,YAAY,CAAiB;IAErC;;;;OAIG;gBACS,OAAO,CAAC,EAAE,aAAa;IASnC;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW;IAepC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAWhB;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,MAAM,IAAI,IAAI;IAad;;OAEG;IACH,QAAQ,IAAI,IAAI;IAahB;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI;IAWnC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAc/B;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAc/B;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAa7C;;;;OAIG;IACH,QAAQ,IAAI,WAAW;IAWvB;;;;;OAKG;IACH,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,CAAC,WAAW,CAAC,GAAG,IAAI;IAO5E;;;;;OAKG;IACH,GAAG,CACD,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,qBAAqB,CAAC,WAAW,CAAC,GAC1C,IAAI;IAIP;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAYvB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAOpB;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAQ9B;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAQb;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAqErB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAgBrB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IA4G5B;;OAEG;IACH,OAAO,CAAC,OAAO;CAsBhB"}

package/dist/types/lib/core/LegendGuiControl.d.ts

@@ -28,12 +28,16 @@ export declare class LegendGuiControl implements IControl {
     private _handleZoom?;
     private _zoomVisible;
     private _legend?;
+    private _legends;
+    private _legendEntries;
+    private _legendSelect?;
     private _titleInput?;
     private _positionSelect?;
     private _itemsContainer?;
     private _dictTextarea?;
     private _dictErrorEl?;
     private _addBtn?;
+    private _updateBtn?;
     private _removeBtn?;
     constructor(options?: LegendGuiControlOptions);
     onAdd(map: MapLibreMap): HTMLElement;
@@ -53,10 +57,16 @@ export declare class LegendGuiControl implements IControl {
     private _renderItems;
     private _addItem;
     private _importFromDict;
+    private _getFormEntry;
+    private _applyEntryToForm;
+    private _createLegend;
+    private _selectLegend;
+    private _renderLegendSelect;
     private _addLegend;
     private _updateLegend;
     private _removeLegend;
     private _updateButtonStates;
+    private _removeAllLegends;
     private _togglePanel;
     private _showPanel;
     private _hidePanel;

package/dist/types/lib/core/LegendGuiControl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LegendGuiControl.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/LegendGuiControl.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EACV,QAAQ,EACR,GAAG,IAAI,WAAW,EAClB,eAAe,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAiClC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,OAAO,CAAC,UAAU,CAAC,CAAc;IACjC,OAAO,CAAC,OAAO,CAAC,CAAoB;IACpC,OAAO,CAAC,MAAM,CAAC,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,cAAc,CACV;IACZ,OAAO,CAAC,IAAI,CAAC,CAAc;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,YAAY,CAAiB;IAGrC,OAAO,CAAC,OAAO,CAAC,CAAS;IAGzB,OAAO,CAAC,WAAW,CAAC,CAAmB;IACvC,OAAO,CAAC,eAAe,CAAC,CAAoB;IAC5C,OAAO,CAAC,eAAe,CAAC,CAAc;IACtC,OAAO,CAAC,aAAa,CAAC,CAAsB;IAC5C,OAAO,CAAC,YAAY,CAAC,CAAc;IACnC,OAAO,CAAC,OAAO,CAAC,CAAoB;IACpC,OAAO,CAAC,UAAU,CAAC,CAAoB;gBAE3B,OAAO,CAAC,EAAE,uBAAuB;IAgB7C,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW;IAUpC,QAAQ,IAAI,IAAI;IAUhB,kBAAkB,IAAI,eAAe;IAIrC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAQ/D,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAKhE,OAAO,CAAC,KAAK;IAWb,MAAM,IAAI,IAAI;IAOd,QAAQ,IAAI,IAAI;IAOhB,IAAI,IAAI,IAAI;IASZ,IAAI,IAAI,IAAI;IASZ,QAAQ,IAAI,qBAAqB;IAIjC,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,YAAY;IAmJpB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,YAAY;IA+DpB,OAAO,CAAC,QAAQ;IAqBhB,OAAO,CAAC,eAAe;IAwCvB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,SAAS,IAAI,MAAM,GAAG,SAAS;CAGhC"}
+{"version":3,"file":"LegendGuiControl.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/LegendGuiControl.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EACV,QAAQ,EACR,GAAG,IAAI,WAAW,EAClB,eAAe,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EAErB,cAAc,EACd,qBAAqB,EACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAiClC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,OAAO,CAAC,UAAU,CAAC,CAAc;IACjC,OAAO,CAAC,OAAO,CAAC,CAAoB;IACpC,OAAO,CAAC,MAAM,CAAC,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,cAAc,CACV;IACZ,OAAO,CAAC,IAAI,CAAC,CAAc;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,YAAY,CAAiB;IAGrC,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,cAAc,CAA6B;IAGnD,OAAO,CAAC,aAAa,CAAC,CAAoB;IAC1C,OAAO,CAAC,WAAW,CAAC,CAAmB;IACvC,OAAO,CAAC,eAAe,CAAC,CAAoB;IAC5C,OAAO,CAAC,eAAe,CAAC,CAAc;IACtC,OAAO,CAAC,aAAa,CAAC,CAAsB;IAC5C,OAAO,CAAC,YAAY,CAAC,CAAc;IACnC,OAAO,CAAC,OAAO,CAAC,CAAoB;IACpC,OAAO,CAAC,UAAU,CAAC,CAAoB;IACvC,OAAO,CAAC,UAAU,CAAC,CAAoB;gBAE3B,OAAO,CAAC,EAAE,uBAAuB;IAkB7C,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW;IAUpC,QAAQ,IAAI,IAAI;IAUhB,kBAAkB,IAAI,eAAe;IAIrC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAQ/D,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAKhE,OAAO,CAAC,KAAK;IAWb,MAAM,IAAI,IAAI;IAOd,QAAQ,IAAI,IAAI;IAOhB,IAAI,IAAI,IAAI;IASZ,IAAI,IAAI,IAAI;IASZ,QAAQ,IAAI,qBAAqB;IAWjC,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,YAAY;IAwJpB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,YAAY;IA2DpB,OAAO,CAAC,QAAQ;IAoBhB,OAAO,CAAC,eAAe;IAuCvB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,aAAa;IAuBrB,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,SAAS,IAAI,MAAM,GAAG,SAAS;CAGhC"}

package/dist/types/lib/core/LegendReact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LegendReact.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/LegendReact.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,SAAS,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,WAAW,CAAC,EAC1B,GAAG,EACH,aAAa,EACb,QAAwB,EACxB,GAAG,OAAO,EACX,EAAE,gBAAgB,GAAG,IAAI,CA4DzB"}
+{"version":3,"file":"LegendReact.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/LegendReact.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,SAAS,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,WAAW,CAAC,EAC1B,GAAG,EACH,aAAa,EACb,QAAwB,EACxB,GAAG,OAAO,EACX,EAAE,gBAAgB,GAAG,IAAI,CA6DzB"}

package/dist/types/lib/core/types.d.ts

@@ -35,9 +35,9 @@ export interface TickConfig {
     length?: number;
 }
 /**
- * Options for configuring the Colorbar control.
+ * Options for configuring a single colorbar entry.
  */
-export interface ColorbarOptions {
+export interface ColorbarItemOptions {
     /** Colormap name or custom color array. */
     colormap?: ColormapName | string[];
     /** Custom color stops for fine-grained control. */
@@ -52,8 +52,6 @@ export interface ColorbarOptions {
     units?: string;
     /** Orientation of the colorbar. */
     orientation?: ColorbarOrientation;
-    /** Position on the map. */
-    position?: ControlPosition;
     /** Width in pixels (for vertical) or height (for horizontal) of the gradient bar. */
     barThickness?: number;
     /** Length of the colorbar in pixels. */
@@ -82,9 +80,18 @@ export interface ColorbarOptions {
     maxzoom?: number;
 }
 /**
- * Internal state of the Colorbar control.
+ * Options for configuring the Colorbar control.
  */
-export interface ColorbarState {
+export interface ColorbarOptions extends ColorbarItemOptions {
+    /** Position on the map. */
+    position?: ControlPosition;
+    /** Multiple colorbar entries to display in this control. */
+    colorbars?: ColorbarItemOptions[];
+}
+/**
+ * Internal state of a single colorbar entry.
+ */
+export interface ColorbarItemState {
     /** Whether the colorbar is visible. */
     visible: boolean;
     /** Current vmin value. */
@@ -94,6 +101,13 @@ export interface ColorbarState {
     /** Current colormap. */
     colormap: ColormapName | string[];
 }
+/**
+ * Internal state of the Colorbar control.
+ */
+export interface ColorbarState extends ColorbarItemState {
+    /** State for all rendered colorbar entries. */
+    colorbars?: ColorbarItemState[];
+}
 /**
  * Props for the React Colorbar wrapper component.
  */
@@ -119,15 +133,13 @@ export interface LegendItem {
     icon?: string;
 }
 /**
- * Options for configuring the Legend control.
+ * Options for configuring a single legend entry.
  */
-export interface LegendOptions {
+export interface LegendItemOptions {
     /** Legend title. */
     title?: string;
     /** Legend items to display. */
     items?: LegendItem[];
-    /** Position on the map. */
-    position?: ControlPosition;
     /** Custom CSS class name. */
     className?: string;
     /** Whether the legend is initially visible. */
@@ -160,9 +172,18 @@ export interface LegendOptions {
     maxzoom?: number;
 }
 /**
- * Internal state of the Legend control.
+ * Options for configuring the Legend control.
  */
-export interface LegendState {
+export interface LegendOptions extends LegendItemOptions {
+    /** Position on the map. */
+    position?: ControlPosition;
+    /** Multiple legend entries to display in this control. */
+    legends?: LegendItemOptions[];
+}
+/**
+ * Internal state of a single legend entry.
+ */
+export interface LegendItemState {
     /** Whether the legend is visible. */
     visible: boolean;
     /** Whether the legend is collapsed. */
@@ -170,6 +191,13 @@ export interface LegendState {
     /** Current legend items. */
     items: LegendItem[];
 }
+/**
+ * Internal state of the Legend control.
+ */
+export interface LegendState extends LegendItemState {
+    /** State for all rendered legend entries. */
+    legends?: LegendItemState[];
+}
 /**
  * Props for the React Legend wrapper component.
  */
@@ -180,17 +208,15 @@ export interface LegendReactProps extends LegendOptions {
     onStateChange?: (state: LegendState) => void;
 }
 /**
- * Options for configuring the HtmlControl.
+ * Options for configuring a single HtmlControl entry.
  */
-export interface HtmlControlOptions {
+export interface HtmlControlItemOptions {
     /** HTML content string. */
     html?: string;
     /** Or provide an element directly. */
     element?: HTMLElement;
     /** Title for the control header (shown when collapsible). */
     title?: string;
-    /** Position on the map. */
-    position?: ControlPosition;
     /** Custom CSS class name. */
     className?: string;
     /** Whether the control is initially visible. */
@@ -221,9 +247,18 @@ export interface HtmlControlOptions {
     maxzoom?: number;
 }
 /**
- * Internal state of the HtmlControl.
+ * Options for configuring the HtmlControl.
+ */
+export interface HtmlControlOptions extends HtmlControlItemOptions {
+    /** Position on the map. */
+    position?: ControlPosition;
+    /** Multiple HTML entries to display in this control. */
+    htmls?: HtmlControlItemOptions[];
+}
+/**
+ * Internal state of a single HtmlControl entry.
  */
-export interface HtmlControlState {
+export interface HtmlControlItemState {
     /** Whether the control is visible. */
     visible: boolean;
     /** Whether the control is collapsed. */
@@ -231,6 +266,13 @@ export interface HtmlControlState {
     /** Current HTML content. */
     html: string;
 }
+/**
+ * Internal state of the HtmlControl.
+ */
+export interface HtmlControlState extends HtmlControlItemState {
+    /** State for all rendered HTML entries. */
+    htmls?: HtmlControlItemState[];
+}
 /**
  * Props for the React HtmlControl wrapper component.
  */
@@ -988,13 +1030,9 @@ export interface ColorbarGuiControlOptions {
     maxzoom?: number;
 }
 /**
- * Internal state of the ColorbarGuiControl.
+ * Configured colorbar entry managed by the ColorbarGuiControl.
  */
-export interface ColorbarGuiControlState {
-    /** Whether the control is visible. */
-    visible: boolean;
-    /** Whether the panel is collapsed. */
-    collapsed: boolean;
+export interface ColorbarGuiEntryState {
     /** Colorbar mode: 'named' for predefined colormaps, 'custom' for user-defined colors. */
     mode: "named" | "custom";
     /** Selected colormap name (used when mode is 'named'). */
@@ -1013,8 +1051,21 @@ export interface ColorbarGuiControlState {
     orientation: ColorbarOrientation;
     /** Position of the colorbar on the map. */
     colorbarPosition: ControlPosition;
+}
+/**
+ * Internal state of the ColorbarGuiControl.
+ */
+export interface ColorbarGuiControlState extends ColorbarGuiEntryState {
+    /** Whether the control is visible. */
+    visible: boolean;
+    /** Whether the panel is collapsed. */
+    collapsed: boolean;
     /** Whether a colorbar is currently active on the map. */
     hasColorbar: boolean;
+    /** Index of the selected colorbar entry. */
+    selectedColorbarIndex: number;
+    /** Configured colorbars currently active on the map. */
+    colorbars: ColorbarGuiEntryState[];
 }
 /**
  * ColorbarGuiControl event types.
@@ -1059,21 +1110,30 @@ export interface LegendGuiControlOptions {
     maxzoom?: number;
 }
 /**
- * Internal state of the LegendGuiControl.
+ * Configured legend entry managed by the LegendGuiControl.
  */
-export interface LegendGuiControlState {
-    /** Whether the control is visible. */
-    visible: boolean;
-    /** Whether the panel is collapsed. */
-    collapsed: boolean;
+export interface LegendGuiEntryState {
     /** Legend title. */
     title: string;
     /** Current legend items. */
     items: LegendItem[];
     /** Position of the legend on the map. */
     legendPosition: ControlPosition;
+}
+/**
+ * Internal state of the LegendGuiControl.
+ */
+export interface LegendGuiControlState extends LegendGuiEntryState {
+    /** Whether the control is visible. */
+    visible: boolean;
+    /** Whether the panel is collapsed. */
+    collapsed: boolean;
     /** Whether a legend is currently active on the map. */
     hasLegend: boolean;
+    /** Index of the selected legend entry. */
+    selectedLegendIndex: number;
+    /** Configured legends currently active on the map. */
+    legends: LegendGuiEntryState[];
 }
 /**
  * LegendGuiControl event types.
@@ -1118,13 +1178,9 @@ export interface HtmlGuiControlOptions {
     maxzoom?: number;
 }
 /**
- * Internal state of the HtmlGuiControl.
+ * Configured HTML entry managed by the HtmlGuiControl.
  */
-export interface HtmlGuiControlState {
-    /** Whether the control is visible. */
-    visible: boolean;
-    /** Whether the panel is collapsed. */
-    collapsed: boolean;
+export interface HtmlGuiEntryState {
     /** Title for the HTML control. */
     title: string;
     /** Current HTML content. */
@@ -1133,8 +1189,21 @@ export interface HtmlGuiControlState {
     htmlPosition: ControlPosition;
     /** Whether the HTML control is collapsible. */
     collapsible: boolean;
+}
+/**
+ * Internal state of the HtmlGuiControl.
+ */
+export interface HtmlGuiControlState extends HtmlGuiEntryState {
+    /** Whether the control is visible. */
+    visible: boolean;
+    /** Whether the panel is collapsed. */
+    collapsed: boolean;
     /** Whether an HTML control is currently active on the map. */
     hasHtmlControl: boolean;
+    /** Index of the selected HTML entry. */
+    selectedHtmlIndex: number;
+    /** Configured HTML controls currently active on the map. */
+    htmls: HtmlGuiEntryState[];
 }
 /**
  * HtmlGuiControl event types.
@@ -1302,7 +1371,7 @@ export interface CogLayerControlOptions {
     defaultRescaleMin?: number;
     /** Default rescale maximum. Default: 255. */
     defaultRescaleMax?: number;
-    /** Default nodata value. */
+    /** Default nodata value. If omitted, TIFF metadata is used when available. */
     defaultNodata?: number;
     /** Default opacity (0-1). Default: 1. */
     defaultOpacity?: number;