@gisfun/maplibre-gl-components 0.15.0-alpha.0

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

@@ -0,0 +1,32 @@
+import { CogLayerControlReactProps } from './types';
+/**
+ * React wrapper component for CogLayerControl.
+ *
+ * @example
+ * ```tsx
+ * import { CogLayerReact } from 'maplibre-gl-components/react';
+ *
+ * function MyMap() {
+ *   const [map, setMap] = useState<Map | null>(null);
+ *
+ *   return (
+ *     <>
+ *       <div ref={mapContainer} />
+ *       {map && (
+ *         <CogLayerReact
+ *           map={map}
+ *           defaultUrl="https://example.com/cog.tif"
+ *           defaultColormap="terrain"
+ *           onLayerAdd={(url) => console.log('Added:', url)}
+ *         />
+ *       )}
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @param props - Component props including map instance and COG layer options.
+ * @returns null - This component renders nothing directly.
+ */
+export declare function CogLayerReact({ map, onLayerAdd, onLayerRemove, onLayerUpdate, onError, onStateChange, position, ...options }: CogLayerControlReactProps): null;
+//# sourceMappingURL=CogLayerReact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CogLayerReact.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/CogLayerReact.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAwB,MAAM,SAAS,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,aAAa,CAAC,EAC5B,GAAG,EACH,UAAU,EACV,aAAa,EACb,aAAa,EACb,OAAO,EACP,aAAa,EACb,QAAsB,EACtB,GAAG,OAAO,EACX,EAAE,yBAAyB,GAAG,IAAI,CA+ElC"}

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

@@ -0,0 +1,133 @@
+import { IControl, Map as MapLibreMap } from 'maplibre-gl';
+import { ColorbarOptions, ColorbarState, ComponentEvent, ComponentEventHandler } from './types';
+/**
+ * A continuous gradient colorbar control for MapLibre GL maps.
+ *
+ * Displays a color gradient legend with customizable colormaps,
+ * tick marks, labels, and positioning.
+ *
+ * @example
+ * ```typescript
+ * const colorbar = new Colorbar({
+ *   colormap: 'viridis',
+ *   vmin: 0,
+ *   vmax: 100,
+ *   label: 'Temperature',
+ *   units: '°C',
+ *   orientation: 'vertical',
+ * });
+ * map.addControl(colorbar, 'bottom-right');
+ * ```
+ */
+export declare class Colorbar implements IControl {
+    private _container?;
+    private _options;
+    private _state;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _zoomVisible;
+    /**
+     * Creates a new Colorbar instance.
+     *
+     * @param options - Configuration options for the colorbar.
+     */
+    constructor(options?: ColorbarOptions);
+    /**
+     * Called when the control is added to the map.
+     * Implements the IControl interface.
+     *
+     * @param map - The MapLibre GL map instance.
+     * @returns The control's container element.
+     */
+    onAdd(map: MapLibreMap): HTMLElement;
+    /**
+     * Called when the control is removed from the map.
+     * Implements the IControl interface.
+     */
+    onRemove(): void;
+    /**
+     * Shows the colorbar.
+     */
+    show(): void;
+    /**
+     * Hides the colorbar.
+     */
+    hide(): void;
+    /**
+     * Updates the colorbar options and re-renders.
+     *
+     * @param options - Partial options to update.
+     */
+    update(options: Partial<ColorbarOptions>): void;
+    /**
+     * Gets the current state.
+     *
+     * @returns The current colorbar state.
+     */
+    getState(): ColorbarState;
+    /**
+     * Registers an event handler.
+     *
+     * @param event - The event type to listen for.
+     * @param handler - The callback function.
+     */
+    on(event: ComponentEvent, handler: ComponentEventHandler<ColorbarState>): void;
+    /**
+     * Removes an event handler.
+     *
+     * @param event - The event type.
+     * @param handler - The callback function to remove.
+     */
+    off(event: ComponentEvent, handler: ComponentEventHandler<ColorbarState>): void;
+    /**
+     * Gets the resolved color stops for the current colormap.
+     *
+     * @returns Array of color stops.
+     */
+    private _getColorStops;
+    /**
+     * Generates the CSS gradient string.
+     *
+     * @returns CSS linear-gradient string.
+     */
+    private _generateGradient;
+    /**
+     * Generates tick values.
+     *
+     * @returns Array of tick values.
+     */
+    private _generateTicks;
+    /**
+     * Formats a tick value for display.
+     *
+     * @param value - The tick value.
+     * @returns Formatted string.
+     */
+    private _formatTick;
+    /**
+     * Emits an event to all registered handlers.
+     *
+     * @param event - The event type to emit.
+     */
+    private _emit;
+    /**
+     * Checks if the current zoom level is within the visibility range.
+     */
+    private _checkZoomVisibility;
+    /**
+     * Updates the display state based on visibility and zoom level.
+     */
+    private _updateDisplayState;
+    /**
+     * Creates the main container element.
+     *
+     * @returns The container element.
+     */
+    private _createContainer;
+    /**
+     * Renders the colorbar content.
+     */
+    private _render;
+}
+//# sourceMappingURL=Colorbar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Colorbar.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/Colorbar.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,cAAc,EACd,qBAAqB,EAEtB,MAAM,SAAS,CAAC;AAiCjB;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,QAAS,YAAW,QAAQ;IACvC,OAAO,CAAC,UAAU,CAAC,CAAc;IACjC,OAAO,CAAC,QAAQ,CAEd;IACF,OAAO,CAAC,MAAM,CAAgB;IAC9B,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,eAAe;IAUrC;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW;IAepC;;;OAGG;IACH,QAAQ,IAAI,IAAI;IAWhB;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAU/C;;;;OAIG;IACH,QAAQ,IAAI,aAAa;IAIzB;;;;;OAKG;IACH,EAAE,CACA,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,qBAAqB,CAAC,aAAa,CAAC,GAC5C,IAAI;IAOP;;;;;OAKG;IACH,GAAG,CACD,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,qBAAqB,CAAC,aAAa,CAAC,GAC5C,IAAI;IAIP;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAyBtB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAYtB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAcnB;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAQb;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACH,OAAO,CAAC,OAAO;CAmGhB"}

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

@@ -0,0 +1,79 @@
+import { IControl, Map as MapLibreMap, ControlPosition } from 'maplibre-gl';
+import { ColorbarGuiControlOptions, ColorbarGuiControlState, ColorbarGuiEvent, ColorbarGuiEventHandler } from './types';
+import { Colorbar } from './Colorbar';
+/**
+ * A GUI control for adding and configuring colorbars on the map.
+ *
+ * Provides a panel with colormap selection, value range, label, units,
+ * orientation, and position settings. The colorbar is added as a
+ * separate control to the map.
+ *
+ * @example
+ * ```typescript
+ * const colorbarGui = new ColorbarGuiControl({ collapsed: true });
+ * map.addControl(colorbarGui, 'top-right');
+ *
+ * colorbarGui.on('colorbaradd', (e) => {
+ *   console.log('Colorbar added:', e.state);
+ * });
+ * ```
+ */
+export declare class ColorbarGuiControl implements IControl {
+    private _container?;
+    private _button?;
+    private _panel?;
+    private _options;
+    private _state;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _zoomVisible;
+    private _colorbar?;
+    private _colormapSelect?;
+    private _vminInput?;
+    private _vmaxInput?;
+    private _labelInput?;
+    private _unitsInput?;
+    private _orientationSelect?;
+    private _positionSelect?;
+    private _addBtn?;
+    private _removeBtn?;
+    private _previewEl?;
+    private _customColorsTextarea?;
+    private _modeNamedRadio?;
+    private _modeCustomRadio?;
+    private _namedSection?;
+    private _customSection?;
+    constructor(options?: ColorbarGuiControlOptions);
+    onAdd(map: MapLibreMap): HTMLElement;
+    onRemove(): void;
+    getDefaultPosition(): ControlPosition;
+    on(event: ColorbarGuiEvent, handler: ColorbarGuiEventHandler): this;
+    off(event: ColorbarGuiEvent, handler: ColorbarGuiEventHandler): this;
+    private _emit;
+    expand(): void;
+    collapse(): void;
+    show(): this;
+    hide(): this;
+    getState(): ColorbarGuiControlState;
+    private _createContainer;
+    private _createPanel;
+    private _createField;
+    private _setMode;
+    private _parseCustomColors;
+    private _updatePreview;
+    private _getColormapValue;
+    private _addColorbar;
+    private _updateColorbar;
+    private _removeColorbar;
+    private _updateButtonStates;
+    private _togglePanel;
+    private _showPanel;
+    private _hidePanel;
+    private _setupZoomHandler;
+    /**
+     * Get the active Colorbar instance (if any).
+     */
+    getColorbar(): Colorbar | undefined;
+}
+//# sourceMappingURL=ColorbarGuiControl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ColorbarGuiControl.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/ColorbarGuiControl.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EACV,QAAQ,EACR,GAAG,IAAI,WAAW,EAClB,eAAe,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EAGxB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA4BtC;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,kBAAmB,YAAW,QAAQ;IACjD,OAAO,CAAC,UAAU,CAAC,CAAc;IACjC,OAAO,CAAC,OAAO,CAAC,CAAoB;IACpC,OAAO,CAAC,MAAM,CAAC,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,cAAc,CACV;IACZ,OAAO,CAAC,IAAI,CAAC,CAAc;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,YAAY,CAAiB;IAGrC,OAAO,CAAC,SAAS,CAAC,CAAW;IAG7B,OAAO,CAAC,eAAe,CAAC,CAAoB;IAC5C,OAAO,CAAC,UAAU,CAAC,CAAmB;IACtC,OAAO,CAAC,UAAU,CAAC,CAAmB;IACtC,OAAO,CAAC,WAAW,CAAC,CAAmB;IACvC,OAAO,CAAC,WAAW,CAAC,CAAmB;IACvC,OAAO,CAAC,kBAAkB,CAAC,CAAoB;IAC/C,OAAO,CAAC,eAAe,CAAC,CAAoB;IAC5C,OAAO,CAAC,OAAO,CAAC,CAAoB;IACpC,OAAO,CAAC,UAAU,CAAC,CAAoB;IACvC,OAAO,CAAC,UAAU,CAAC,CAAc;IAGjC,OAAO,CAAC,qBAAqB,CAAC,CAAsB;IACpD,OAAO,CAAC,eAAe,CAAC,CAAmB;IAC3C,OAAO,CAAC,gBAAgB,CAAC,CAAmB;IAC5C,OAAO,CAAC,aAAa,CAAC,CAAc;IACpC,OAAO,CAAC,cAAc,CAAC,CAAc;gBAEzB,OAAO,CAAC,EAAE,yBAAyB;IAkB/C,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW;IAUpC,QAAQ,IAAI,IAAI;IAUhB,kBAAkB,IAAI,eAAe;IAIrC,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAQnE,GAAG,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAKpE,OAAO,CAAC,KAAK;IAQb,MAAM,IAAI,IAAI;IAOd,QAAQ,IAAI,IAAI;IAOhB,IAAI,IAAI,IAAI;IASZ,IAAI,IAAI,IAAI;IASZ,QAAQ,IAAI,uBAAuB;IAInC,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,YAAY;IA0PpB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,WAAW,IAAI,QAAQ,GAAG,SAAS;CAGpC"}

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

@@ -0,0 +1,34 @@
+import { ColorbarReactProps } from './types';
+/**
+ * React wrapper component for Colorbar.
+ *
+ * @example
+ * ```tsx
+ * import { ColorbarReact } from 'maplibre-gl-components/react';
+ *
+ * function MyMap() {
+ *   const [map, setMap] = useState<Map | null>(null);
+ *
+ *   return (
+ *     <>
+ *       <div ref={mapContainer} />
+ *       {map && (
+ *         <ColorbarReact
+ *           map={map}
+ *           colormap="viridis"
+ *           vmin={0}
+ *           vmax={100}
+ *           label="Temperature"
+ *           units="°C"
+ *         />
+ *       )}
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @param props - Component props including map instance and colorbar options.
+ * @returns null - This component renders nothing directly.
+ */
+export declare function ColorbarReact({ map, onStateChange, position, ...options }: ColorbarReactProps): null;
+//# sourceMappingURL=ColorbarReact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ColorbarReact.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/ColorbarReact.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAiB,MAAM,SAAS,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,aAAa,CAAC,EAC5B,GAAG,EACH,aAAa,EACb,QAAyB,EACzB,GAAG,OAAO,EACX,EAAE,kBAAkB,GAAG,IAAI,CA+D3B"}

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

@@ -0,0 +1,125 @@
+import { IControl, Map as MapLibreMap } from 'maplibre-gl';
+import { ControlGridOptions, ControlGridState, ControlGridEvent, ControlGridEventHandler } from './types';
+import { CustomLayerAdapter } from '../adapters/CogLayerAdapter';
+/**
+ * A collapsible grid container for MapLibre IControl instances.
+ *
+ * Hosts multiple controls (e.g. SearchControl, TerrainControl) in a grid layout.
+ * Users can configure rows/columns and dynamically add or remove controls.
+ *
+ * @example
+ * ```typescript
+ * const grid = new ControlGrid({
+ *   title: 'Map Tools',
+ *   rows: 2,
+ *   columns: 2,
+ *   collapsible: true,
+ * });
+ * grid.addControl(new TerrainControl());
+ * grid.addControl(new SearchControl());
+ * map.addControl(grid, 'top-right');
+ * ```
+ */
+export declare class ControlGrid implements IControl {
+    private _container?;
+    private _gridEl?;
+    private _options;
+    private _state;
+    private _children;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _zoomVisible;
+    private _floatingEntry;
+    private _floatingPanel;
+    /** True during a click that originated inside the grid (not the floating panel). */
+    private _clickInGrid;
+    private _docCaptureHandler?;
+    private _docBubbleHandler?;
+    constructor(options?: ControlGridOptions);
+    private _createDefaultControl;
+    onAdd(map: MapLibreMap): HTMLElement;
+    onRemove(): void;
+    /**
+     * Add a control to the grid. If the control is already on the map, it is mounted into the grid.
+     */
+    addControl(control: IControl): void;
+    /**
+     * Remove a control from the grid. The control's onRemove is called.
+     */
+    removeControl(control: IControl): void;
+    /**
+     * Set the number of grid rows.
+     */
+    setRows(rows: number): void;
+    /**
+     * Set the number of grid columns.
+     */
+    setColumns(columns: number): void;
+    /**
+     * Get the list of controls currently in the grid.
+     */
+    getControls(): IControl[];
+    /**
+     * Create custom layer adapters for all data-layer controls in the grid.
+     * Returns adapters suitable for registering with a LayerControl via
+     * `layerControl.registerCustomAdapter(adapter)`.
+     *
+     * Supported controls: CogLayerControl, ZarrLayerControl,
+     * PMTilesLayerControl, StacLayerControl, AddVectorControl.
+     */
+    getAdapters(): CustomLayerAdapter[];
+    show(): void;
+    hide(): void;
+    expand(): void;
+    collapse(): void;
+    toggle(): void;
+    getState(): ControlGridState;
+    update(options: Partial<ControlGridOptions>): void;
+    on(event: ControlGridEvent, handler: ControlGridEventHandler): void;
+    off(event: ControlGridEvent, handler: ControlGridEventHandler): void;
+    private _emit;
+    private _checkZoomVisibility;
+    private _updateDisplayState;
+    private _createContainer;
+    private _autoGrowRows;
+    private _applyGridStyle;
+    private _mountChildren;
+    /**
+     * Set title on the control's button if it doesn't already have one.
+     */
+    private _applyTooltip;
+    private _unmountChildren;
+    private _isExpandable;
+    private _attachExpandListeners;
+    private _detachExpandListeners;
+    private _onChildExpand;
+    private _onChildCollapse;
+    private _mountAsFloating;
+    private _ensureFloatingPanel;
+    private _clearFloating;
+    private _collapseFloatingChild;
+    /**
+     * Hide the control's toggle button when it is inside the floating panel
+     * so only the expanded panel content is visible.
+     * Only applies to internal controls (no external panel).
+     */
+    private _hideFloatingButton;
+    /**
+     * Restore the control's toggle button visibility when moving
+     * back from the floating panel to the grid.
+     */
+    private _showFloatingButton;
+    /**
+     * Move an external panel (appended to the map container by the upstream control)
+     * into the floating panel, stripping its absolute positioning.
+     */
+    private _relocateExternalPanel;
+    /**
+     * Move an external panel back to its original parent and clear
+     * the inline overrides set during relocation.
+     */
+    private _restoreExternalPanel;
+    private _render;
+}
+//# sourceMappingURL=ControlGrid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ControlGrid.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/ControlGrid.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,32 @@
+import { ControlGridReactProps } from './types';
+/**
+ * React wrapper component for ControlGrid.
+ *
+ * @example
+ * ```tsx
+ * import { ControlGridReact, TerrainControl, SearchControl } from 'maplibre-gl-components/react';
+ *
+ * function MyMap() {
+ *   const [map, setMap] = useState<Map | null>(null);
+ *   const terrainRef = useRef(new TerrainControl());
+ *   const searchRef = useRef(new SearchControl());
+ *
+ *   return (
+ *     <>
+ *       <div ref={mapContainer} />
+ *       {map && (
+ *         <ControlGridReact
+ *           map={map}
+ *           title="Tools"
+ *           rows={2}
+ *           columns={2}
+ *           controls={[terrainRef.current, searchRef.current]}
+ *         />
+ *       )}
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+export declare function ControlGridReact({ map, onStateChange, position, controls: controlsProp, ...options }: ControlGridReactProps): null;
+//# sourceMappingURL=ControlGridReact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ControlGridReact.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/ControlGridReact.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAoB,MAAM,SAAS,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,GAAG,EACH,aAAa,EACb,QAAsB,EACtB,QAAQ,EAAE,YAAiB,EAC3B,GAAG,OAAO,EACX,EAAE,qBAAqB,GAAG,IAAI,CAoG9B"}

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

@@ -0,0 +1,140 @@
+import { IControl, Map as MapLibreMap } from 'maplibre-gl';
+import { HtmlControlOptions, HtmlControlState, ComponentEvent, ComponentEventHandler } from './types';
+/**
+ * A flexible HTML content control for MapLibre GL maps.
+ *
+ * Allows displaying arbitrary HTML content that can be dynamically updated.
+ * Supports collapsible mode with a toggle button.
+ *
+ * @example
+ * ```typescript
+ * const htmlControl = new HtmlControl({
+ *   html: '<div><strong>Stats:</strong> 1,234 features</div>',
+ *   position: 'top-left',
+ *   collapsible: true,
+ *   title: 'Statistics',
+ * });
+ * map.addControl(htmlControl, 'top-left');
+ *
+ * // Update content dynamically
+ * htmlControl.setHtml('<div><strong>Stats:</strong> 5,678 features</div>');
+ * ```
+ */
+export declare class HtmlControl implements IControl {
+    private _container?;
+    private _contentEl?;
+    private _options;
+    private _state;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _zoomVisible;
+    /**
+     * Creates a new HtmlControl instance.
+     *
+     * @param options - Configuration options for the control.
+     */
+    constructor(options?: HtmlControlOptions);
+    /**
+     * Called when the control is added to the map.
+     * Implements the IControl interface.
+     *
+     * @param map - The MapLibre GL map instance.
+     * @returns The control's container element.
+     */
+    onAdd(map: MapLibreMap): HTMLElement;
+    /**
+     * Called when the control is removed from the map.
+     * Implements the IControl interface.
+     */
+    onRemove(): void;
+    /**
+     * Shows the control.
+     */
+    show(): void;
+    /**
+     * Hides the control.
+     */
+    hide(): void;
+    /**
+     * Expands the control (if collapsible).
+     */
+    expand(): void;
+    /**
+     * Collapses the control (if collapsible).
+     */
+    collapse(): void;
+    /**
+     * Toggles the collapsed state.
+     */
+    toggle(): void;
+    /**
+     * Sets the HTML content.
+     *
+     * @param html - The HTML string to display.
+     */
+    setHtml(html: string): void;
+    /**
+     * Sets a DOM element as content.
+     *
+     * @param element - The DOM element to display.
+     */
+    setElement(element: HTMLElement): void;
+    /**
+     * Gets the content container element.
+     *
+     * @returns The content container element, or undefined if not yet added to map.
+     */
+    getElement(): HTMLElement | undefined;
+    /**
+     * Updates control options and re-renders.
+     *
+     * @param options - Partial options to update.
+     */
+    update(options: Partial<HtmlControlOptions>): void;
+    /**
+     * Gets the current state.
+     *
+     * @returns The current control state.
+     */
+    getState(): HtmlControlState;
+    /**
+     * Registers an event handler.
+     *
+     * @param event - The event type to listen for.
+     * @param handler - The callback function.
+     */
+    on(event: ComponentEvent, handler: ComponentEventHandler<HtmlControlState>): void;
+    /**
+     * Removes an event handler.
+     *
+     * @param event - The event type.
+     * @param handler - The callback function to remove.
+     */
+    off(event: ComponentEvent, handler: ComponentEventHandler<HtmlControlState>): void;
+    /**
+     * Emits an event to all registered handlers.
+     *
+     * @param event - The event type to emit.
+     */
+    private _emit;
+    /**
+     * Checks if the current zoom level is within the visibility range.
+     */
+    private _checkZoomVisibility;
+    /**
+     * Updates the display state based on visibility and zoom level.
+     */
+    private _updateDisplayState;
+    /**
+     * Creates the main container element.
+     *
+     * @returns The container element.
+     */
+    private _createContainer;
+    /**
+     * Renders the control content.
+     */
+    private _render;
+}
+//# sourceMappingURL=HtmlControl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlControl.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/HtmlControl.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACtB,MAAM,SAAS,CAAC;AA4BjB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAY,YAAW,QAAQ;IAC1C,OAAO,CAAC,UAAU,CAAC,CAAc;IACjC,OAAO,CAAC,UAAU,CAAC,CAAc;IACjC,OAAO,CAAC,QAAQ,CAEd;IACF,OAAO,CAAC,MAAM,CAAmB;IACjC,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,kBAAkB;IASxC;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW;IAepC;;;OAGG;IACH,QAAQ,IAAI,IAAI;IAYhB;;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,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAU3B;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAWtC;;;;OAIG;IACH,UAAU,IAAI,WAAW,GAAG,SAAS;IAIrC;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAUlD;;;;OAIG;IACH,QAAQ,IAAI,gBAAgB;IAI5B;;;;;OAKG;IACH,EAAE,CACA,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,qBAAqB,CAAC,gBAAgB,CAAC,GAC/C,IAAI;IAOP;;;;;OAKG;IACH,GAAG,CACD,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,qBAAqB,CAAC,gBAAgB,CAAC,GAC/C,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;;OAEG;IACH,OAAO,CAAC,OAAO;CA8FhB"}

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

@@ -0,0 +1,32 @@
+import { HtmlControlReactProps } from './types';
+/**
+ * React wrapper component for HtmlControl.
+ *
+ * @example
+ * ```tsx
+ * import { HtmlControlReact } from 'maplibre-gl-components/react';
+ *
+ * function MyMap() {
+ *   const [map, setMap] = useState<Map | null>(null);
+ *   const [stats, setStats] = useState('Loading...');
+ *
+ *   return (
+ *     <>
+ *       <div ref={mapContainer} />
+ *       {map && (
+ *         <HtmlControlReact
+ *           map={map}
+ *           html={`<div><strong>Stats:</strong> ${stats}</div>`}
+ *           position="top-left"
+ *         />
+ *       )}
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @param props - Component props including map instance and control options.
+ * @returns null - This component renders nothing directly.
+ */
+export declare function HtmlControlReact({ map, onStateChange, position, ...options }: HtmlControlReactProps): null;
+//# sourceMappingURL=HtmlControlReact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlControlReact.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/HtmlControlReact.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAoB,MAAM,SAAS,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,GAAG,EACH,aAAa,EACb,QAAqB,EACrB,GAAG,OAAO,EACX,EAAE,qBAAqB,GAAG,IAAI,CAsF9B"}