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

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

@@ -0,0 +1,172 @@
+import { IControl, Map as MapLibreMap } from 'maplibre-gl';
+import { SearchControlOptions, SearchControlState, SearchResult, SearchEvent, SearchEventHandler } from './types';
+/**
+ * A collapsible search control for MapLibre GL maps.
+ *
+ * Provides place search functionality using Nominatim (or custom geocoder).
+ * Shows a search icon that expands to reveal a search input with autocomplete results.
+ *
+ * @example
+ * ```typescript
+ * const searchControl = new SearchControl({
+ *   placeholder: 'Search for a place...',
+ *   flyToZoom: 12,
+ *   showMarker: true,
+ * });
+ * map.addControl(searchControl, 'top-right');
+ *
+ * // Listen for result selection
+ * searchControl.on('resultselect', (event) => {
+ *   console.log('Selected:', event.result);
+ * });
+ * ```
+ */
+export declare class SearchControl implements IControl {
+    private _container?;
+    private _inputEl?;
+    private _inputWrapper?;
+    private _resultsContainer?;
+    private _loadingEl?;
+    private _clearBtn?;
+    private _options;
+    private _state;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _zoomVisible;
+    private _marker?;
+    private _debounceTimer?;
+    /**
+     * Creates a new SearchControl instance.
+     *
+     * @param options - Configuration options for the control.
+     */
+    constructor(options?: SearchControlOptions);
+    /**
+     * Called when the control is added to the map.
+     *
+     * @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.
+     */
+    onRemove(): void;
+    /**
+     * Shows the control.
+     */
+    show(): void;
+    /**
+     * Hides the control.
+     */
+    hide(): void;
+    /**
+     * Expands the search control to show the input.
+     */
+    expand(): void;
+    /**
+     * Collapses the search control to icon only.
+     */
+    collapse(): void;
+    /**
+     * Toggles the collapsed state.
+     */
+    toggle(): void;
+    /**
+     * Performs a search with the given query.
+     *
+     * @param query - The search query string.
+     */
+    search(query: string): Promise<void>;
+    /**
+     * Selects a search result and flies to its location.
+     *
+     * @param result - The search result to select.
+     */
+    selectResult(result: SearchResult): void;
+    /**
+     * Clears the search query and results.
+     */
+    clear(): void;
+    /**
+     * Gets the current state.
+     *
+     * @returns The current control state.
+     */
+    getState(): SearchControlState;
+    /**
+     * Updates control options.
+     *
+     * @param options - Partial options to update.
+     */
+    update(options: Partial<SearchControlOptions>): void;
+    /**
+     * Registers an event handler.
+     *
+     * @param event - The event type to listen for.
+     * @param handler - The callback function.
+     */
+    on(event: SearchEvent, handler: SearchEventHandler): void;
+    /**
+     * Removes an event handler.
+     *
+     * @param event - The event type.
+     * @param handler - The callback function to remove.
+     */
+    off(event: SearchEvent, handler: SearchEventHandler): void;
+    /**
+     * Emits an event to all registered handlers.
+     */
+    private _emit;
+    /**
+     * Performs a search using Nominatim geocoding service.
+     */
+    private _nominatimSearch;
+    /**
+     * 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;
+    /**
+     * Adds a marker at the result location.
+     */
+    private _addMarker;
+    /**
+     * Removes the current marker.
+     */
+    private _removeMarker;
+    /**
+     * Updates only the results section without rebuilding the entire DOM.
+     * This prevents input focus loss during search.
+     */
+    private _renderResultsOnly;
+    /**
+     * Updates only the loading/clear button state without full DOM rebuild.
+     */
+    private _updateLoadingState;
+    /**
+     * Creates the main container element.
+     */
+    private _createContainer;
+    /**
+     * Handles input change with debouncing.
+     */
+    private _handleInput;
+    /**
+     * Renders the control content.
+     */
+    private _render;
+    /**
+     * Renders the collapsed state (search icon only).
+     */
+    private _renderCollapsedState;
+    /**
+     * Renders the expanded state (search input and results).
+     */
+    private _renderExpandedState;
+}
+//# sourceMappingURL=SearchControl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SearchControl.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/SearchControl.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,WAAW,EAAU,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAqCjB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC5C,OAAO,CAAC,UAAU,CAAC,CAAc;IACjC,OAAO,CAAC,QAAQ,CAAC,CAAmB;IACpC,OAAO,CAAC,aAAa,CAAC,CAAc;IACpC,OAAO,CAAC,iBAAiB,CAAC,CAAc;IACxC,OAAO,CAAC,UAAU,CAAC,CAAc;IACjC,OAAO,CAAC,SAAS,CAAC,CAAoB;IACtC,OAAO,CAAC,QAAQ,CAEd;IACF,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,cAAc,CAAwD;IAC9E,OAAO,CAAC,IAAI,CAAC,CAAc;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,cAAc,CAAC,CAAgC;IAEvD;;;;OAIG;gBACS,OAAO,CAAC,EAAE,oBAAoB;IAa1C;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW;IAepC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAoBhB;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACH,MAAM,IAAI,IAAI;IAUd;;OAEG;IACH,QAAQ,IAAI,IAAI;IAShB;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoD1C;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAuCxC;;OAEG;IACH,KAAK,IAAI,IAAI;IAmBb;;;;OAIG;IACH,QAAQ,IAAI,kBAAkB;IAI9B;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IASpD;;;;;OAKG;IACH,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAOzD;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAI1D;;OAEG;IACH,OAAO,CAAC,KAAK;IAQb;;OAEG;YACW,gBAAgB;IAkD9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,UAAU;IAwBlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IA8G1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA6E3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACH,OAAO,CAAC,YAAY,CAWlB;IAEF;;OAEG;IACH,OAAO,CAAC,OAAO;IA+Cf;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA8B7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAoO7B"}

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

@@ -0,0 +1,32 @@
+import { SearchControlReactProps } from './types';
+/**
+ * React wrapper component for SearchControl.
+ *
+ * @example
+ * ```tsx
+ * import { SearchControlReact } from 'maplibre-gl-components/react';
+ *
+ * function MyMap() {
+ *   const [map, setMap] = useState<Map | null>(null);
+ *
+ *   return (
+ *     <>
+ *       <div ref={mapContainer} />
+ *       {map && (
+ *         <SearchControlReact
+ *           map={map}
+ *           position="top-right"
+ *           placeholder="Search for a place..."
+ *           onResultSelect={(result) => console.log('Selected:', result)}
+ *         />
+ *       )}
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @param props - Component props including map instance and control options.
+ * @returns null - This component renders nothing directly.
+ */
+export declare function SearchControlReact({ map, onResultSelect, onStateChange, position, ...options }: SearchControlReactProps): null;
+//# sourceMappingURL=SearchControlReact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SearchControlReact.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/SearchControlReact.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,uBAAuB,EAGxB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,GAAG,EACH,cAAc,EACd,aAAa,EACb,QAAsB,EACtB,GAAG,OAAO,EACX,EAAE,uBAAuB,GAAG,IAAI,CA6FhC"}

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

@@ -0,0 +1,107 @@
+import { IControl, Map as MapLibreMap } from 'maplibre-gl';
+import { StacLayerControlOptions, StacLayerControlState, StacLayerEvent, StacLayerEventHandler, ControlPosition } from './types';
+/**
+ * A control for loading and displaying COG layers from STAC items.
+ *
+ * @example
+ * ```typescript
+ * const stacControl = new StacLayerControl({
+ *   defaultUrl: 'https://example.com/stac-item.json',
+ *   loadDefaultUrl: true,
+ * });
+ * map.addControl(stacControl, 'top-right');
+ * ```
+ */
+export declare class StacLayerControl implements IControl {
+    private _container?;
+    private _button?;
+    private _panel?;
+    private _colormapPreview?;
+    private _options;
+    private _state;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _zoomVisible;
+    private _deckOverlay?;
+    private _cogLayers;
+    private _cogLayerPropsMap;
+    private _layerCounter;
+    private _activePopup?;
+    private _mapClickHandler?;
+    constructor(options?: StacLayerControlOptions);
+    onAdd(map: MapLibreMap): HTMLElement;
+    onRemove(): void;
+    getDefaultPosition(): ControlPosition;
+    expand(): void;
+    collapse(): void;
+    toggle(): void;
+    show(): void;
+    hide(): void;
+    getState(): StacLayerControlState;
+    update(options: Partial<StacLayerControlOptions>): void;
+    on(event: StacLayerEvent, handler: StacLayerEventHandler): void;
+    off(event: StacLayerEvent, handler: StacLayerEventHandler): void;
+    loadStacUrl(url: string): Promise<void>;
+    /**
+     * Remove a specific layer by ID, or all layers if no ID is provided.
+     */
+    removeLayer(id?: string): void;
+    /**
+     * Get all layer IDs currently managed by this control.
+     */
+    getLayerIds(): string[];
+    /**
+     * Get the opacity of a specific layer.
+     */
+    getLayerOpacity(layerId: string): number | null;
+    /**
+     * Set the opacity of a specific layer.
+     */
+    setLayerOpacity(layerId: string, opacity: number): void;
+    /**
+     * Get the visibility of a specific layer (opacity > 0 = visible).
+     */
+    getLayerVisibility(layerId: string): boolean;
+    /**
+     * Set the visibility of a specific layer via opacity.
+     */
+    setLayerVisibility(layerId: string, visible: boolean, storedOpacity?: number): void;
+    private _emit;
+    private _checkZoomVisibility;
+    private _updateDisplayState;
+    private _createContainer;
+    private _render;
+    private _renderCollapsed;
+    private _renderExpanded;
+    private _createFormGroup;
+    private _appendStatus;
+    /**
+     * Auto-set rescale values based on the selected asset's data type.
+     */
+    private _autoSetRescale;
+    private _updateColormapPreview;
+    private _fetchStacItem;
+    private _ensureOverlay;
+    private _setupClickHandler;
+    private _addLayer;
+    private _updateOpacity;
+    private _updateRescaleAndColormap;
+    private _removeLayer;
+    private _removeAllLayers;
+    /**
+     * Patch COGLayer to handle grayscale and float GeoTIFFs with colormap support.
+     * The upstream library has limited support for these formats.
+     */
+    private _patchCOGLayer;
+    /**
+     * Register common projections that may not be included by default.
+     */
+    private _registerCommonProjections;
+    /**
+     * Build a geoKeysParser function using geotiff-geokeys-to-proj4.
+     * This avoids CORS issues when looking up EPSG codes from epsg.io.
+     */
+    private _buildGeoKeysParser;
+}
+//# sourceMappingURL=StacLayer.d.ts.map

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

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

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

@@ -0,0 +1,109 @@
+import { IControl, Map as MapLibreMap } from 'maplibre-gl';
+import { StacSearchControlOptions, StacSearchControlState, StacSearchEvent, StacSearchEventHandler, StacSearchItem, ControlPosition } from './types';
+/**
+ * A control for searching and visualizing STAC items from STAC API catalogs.
+ *
+ * @example
+ * ```typescript
+ * const stacSearch = new StacSearchControl({
+ *   catalogs: [
+ *     { name: "Earth Search", url: "https://earth-search.aws.element84.com/v1" },
+ *   ],
+ * });
+ * map.addControl(stacSearch, 'top-right');
+ * ```
+ */
+export declare class StacSearchControl implements IControl {
+    private _container?;
+    private _button?;
+    private _panel?;
+    private _options;
+    private _state;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _zoomVisible;
+    private _footprintSourceId;
+    private _footprintLayerId;
+    private _footprintOutlineLayerId;
+    private _footprintHighlightLayerId;
+    private _footprintHighlightOutlineLayerId;
+    private _showCustomUrlInput;
+    private _deckOverlay?;
+    private _cogLayers;
+    private _layerCounter;
+    constructor(options?: StacSearchControlOptions);
+    onAdd(map: MapLibreMap): HTMLElement;
+    onRemove(): void;
+    getDefaultPosition(): ControlPosition;
+    expand(): void;
+    collapse(): void;
+    toggle(): void;
+    show(): void;
+    hide(): void;
+    getState(): StacSearchControlState;
+    update(options: Partial<StacSearchControlOptions>): void;
+    on(event: StacSearchEvent, handler: StacSearchEventHandler): void;
+    off(event: StacSearchEvent, handler: StacSearchEventHandler): void;
+    /**
+     * Get the currently selected STAC item.
+     */
+    getSelectedItem(): StacSearchItem | null;
+    /**
+     * Get all search result items.
+     */
+    getItems(): StacSearchItem[];
+    private _emit;
+    private _checkZoomVisibility;
+    private _updateDisplayState;
+    private _createContainer;
+    private _render;
+    private _renderCollapsed;
+    private _renderExpanded;
+    private _createFormGroup;
+    private _appendStatus;
+    private _fetchCollections;
+    private _searchItems;
+    private _addFootprints;
+    private _removeFootprints;
+    /**
+     * Update available assets based on the selected item.
+     */
+    private _updateAvailableAssets;
+    /**
+     * Find default RGB band assignments based on available assets.
+     */
+    private _findDefaultRgbBands;
+    /**
+     * Update the footprint highlight to show the selected item.
+     */
+    private _updateFootprintHighlight;
+    /**
+     * Check if a catalog URL is for Microsoft Planetary Computer.
+     */
+    private _isPlanetaryComputer;
+    /**
+     * Get default assets for a collection (fallback when no user selection).
+     */
+    private _getDefaultAssets;
+    /**
+     * Get default rescale for a collection (fallback when no user selection).
+     */
+    private _getDefaultRescale;
+    private _displayItem;
+    /**
+     * Display a Planetary Computer item using their TiTiler endpoint.
+     * PC requires signed URLs, so we use their tile service instead of direct COG access.
+     */
+    private _displayPlanetaryComputerItem;
+    private _ensureOverlay;
+    /**
+     * Convert S3 URLs to HTTPS URLs for browser access.
+     * Handles common S3 URL patterns from various providers.
+     */
+    private _convertS3ToHttps;
+    private _addCogLayer;
+    private _removeLayer;
+    private _removeAllLayers;
+}
+//# sourceMappingURL=StacSearch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StacSearch.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/StacSearch.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,2BAA2B,CAAC;AACnC,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,GAAG,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACtB,eAAe,EACf,sBAAsB,EAGtB,cAAc,EACd,eAAe,EAChB,MAAM,SAAS,CAAC;AA+EjB;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,YAAW,QAAQ;IAChD,OAAO,CAAC,UAAU,CAAC,CAAc;IAEjC,OAAO,CAAC,OAAO,CAAC,CAAoB;IAEpC,OAAO,CAAC,MAAM,CAAC,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,cAAc,CACV;IACZ,OAAO,CAAC,IAAI,CAAC,CAAc;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,kBAAkB,CAAoC;IAC9D,OAAO,CAAC,iBAAiB,CAA0C;IACnE,OAAO,CAAC,wBAAwB,CAA4C;IAC5E,OAAO,CAAC,0BAA0B,CACG;IACrC,OAAO,CAAC,iCAAiC,CACI;IAC7C,OAAO,CAAC,mBAAmB,CAAkB;IAE7C,OAAO,CAAC,YAAY,CAAC,CAAM;IAE3B,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,aAAa,CAAK;gBAEd,OAAO,CAAC,EAAE,wBAAwB;IA8B9C,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW;IAYpC,QAAQ,IAAI,IAAI;IA2BhB,kBAAkB,IAAI,eAAe;IAIrC,MAAM,IAAI,IAAI;IAQd,QAAQ,IAAI,IAAI;IAQhB,MAAM,IAAI,IAAI;IAKd,IAAI,IAAI,IAAI;IAQZ,IAAI,IAAI,IAAI;IAQZ,QAAQ,IAAI,sBAAsB;IAIlC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,IAAI;IAcxD,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAOjE,GAAG,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAIlE;;OAEG;IACH,eAAe,IAAI,cAAc,GAAG,IAAI;IAIxC;;OAEG;IACH,QAAQ,IAAI,cAAc,EAAE;IAI5B,OAAO,CAAC,KAAK;IAiBb,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,OAAO;IA0Bf,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,eAAe;IAyjBvB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,aAAa;YAWP,iBAAiB;YAsDjB,YAAY;IAmH1B,OAAO,CAAC,cAAc;IAiGtB,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAyH9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmC5B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAkBjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,kBAAkB;YAiBZ,YAAY;IAuH1B;;;OAGG;YACW,6BAA6B;YA6F7B,cAAc;IAc5B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;YA2BX,YAAY;IA0B1B,OAAO,CAAC,YAAY;IAoCpB,OAAO,CAAC,gBAAgB;CASzB"}

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

@@ -0,0 +1,165 @@
+import { IControl, Map as MapLibreMap } from 'maplibre-gl';
+import { TerrainControlOptions, TerrainControlState, TerrainEvent, TerrainEventHandler } from './types';
+/**
+ * A terrain toggle control for MapLibre GL maps.
+ *
+ * Enables/disables 3D terrain rendering using AWS Terrarium elevation tiles.
+ *
+ * @example
+ * ```typescript
+ * const terrain = new TerrainControl({
+ *   exaggeration: 1.5,
+ *   hillshade: true,
+ * });
+ * map.addControl(terrain, 'top-right');
+ *
+ * terrain.on('terrainchange', (event) => {
+ *   console.log('Terrain enabled:', event.state.enabled);
+ * });
+ * ```
+ */
+export declare class TerrainControl implements IControl {
+    private _container?;
+    private _button?;
+    private _options;
+    private _state;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _handleStyleLoad?;
+    private _zoomVisible;
+    /**
+     * Creates a new TerrainControl instance.
+     *
+     * @param options - Configuration options for the terrain control.
+     */
+    constructor(options?: TerrainControlOptions);
+    /**
+     * Called when the control is added to the map.
+     *
+     * @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.
+     */
+    onRemove(): void;
+    /**
+     * Shows the control.
+     */
+    show(): void;
+    /**
+     * Hides the control.
+     */
+    hide(): void;
+    /**
+     * Enables terrain rendering.
+     */
+    enable(): void;
+    /**
+     * Disables terrain rendering.
+     */
+    disable(): void;
+    /**
+     * Toggles terrain on/off.
+     */
+    toggle(): void;
+    /**
+     * Checks if terrain is currently enabled.
+     *
+     * @returns True if terrain is enabled.
+     */
+    isEnabled(): boolean;
+    /**
+     * Sets the terrain exaggeration factor.
+     *
+     * @param value - Exaggeration value (typically 0.1 to 10.0).
+     */
+    setExaggeration(value: number): void;
+    /**
+     * Gets the current exaggeration value.
+     *
+     * @returns The current exaggeration factor.
+     */
+    getExaggeration(): number;
+    /**
+     * Enables the hillshade layer.
+     */
+    enableHillshade(): void;
+    /**
+     * Disables the hillshade layer.
+     */
+    disableHillshade(): void;
+    /**
+     * Toggles the hillshade layer.
+     */
+    toggleHillshade(): void;
+    /**
+     * Updates control options and re-renders.
+     *
+     * @param options - Partial options to update.
+     */
+    update(options: Partial<TerrainControlOptions>): void;
+    /**
+     * Gets the current state.
+     *
+     * @returns The current terrain control state.
+     */
+    getState(): TerrainControlState;
+    /**
+     * Registers an event handler.
+     *
+     * @param event - The event type to listen for.
+     * @param handler - The callback function.
+     */
+    on(event: TerrainEvent, handler: TerrainEventHandler): void;
+    /**
+     * Removes an event handler.
+     *
+     * @param event - The event type.
+     * @param handler - The callback function to remove.
+     */
+    off(event: TerrainEvent, handler: TerrainEventHandler): void;
+    /**
+     * Emits an event to all registered handlers.
+     *
+     * @param event - The event type to emit.
+     */
+    private _emit;
+    /**
+     * Sets up the terrain source and enables terrain rendering.
+     */
+    private _setupTerrain;
+    /**
+     * Removes terrain and cleans up sources/layers.
+     */
+    private _removeTerrain;
+    /**
+     * Adds the hillshade layer for better terrain visualization.
+     */
+    private _addHillshadeLayer;
+    /**
+     * Removes the hillshade layer.
+     */
+    private _removeHillshadeLayer;
+    /**
+     * 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/updates the control appearance based on current state.
+     */
+    private _render;
+}
+//# sourceMappingURL=Terrain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Terrain.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/Terrain.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACpB,MAAM,SAAS,CAAC;AA8CjB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAC7C,OAAO,CAAC,UAAU,CAAC,CAAc;IACjC,OAAO,CAAC,OAAO,CAAC,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,cAAc,CACV;IACZ,OAAO,CAAC,IAAI,CAAC,CAAc;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,gBAAgB,CAAC,CAAa;IACtC,OAAO,CAAC,YAAY,CAAiB;IAErC;;;;OAIG;gBACS,OAAO,CAAC,EAAE,qBAAqB;IAU3C;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW;IAkCpC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAqBhB;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACH,MAAM,IAAI,IAAI;IASd;;OAEG;IACH,OAAO,IAAI,IAAI;IASf;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;;;OAIG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;OAIG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAepC;;;;OAIG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,eAAe,IAAI,IAAI;IAWvB;;OAEG;IACH,gBAAgB,IAAI,IAAI;IASxB;;OAEG;IACH,eAAe,IAAI,IAAI;IAQvB;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI;IA6BrD;;;;OAIG;IACH,QAAQ,IAAI,mBAAmB;IAI/B;;;;;OAKG;IACH,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAO3D;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAI5D;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAQb;;OAEG;IACH,OAAO,CAAC,aAAa;IAiCrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA8B1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;OAEG;IACH,OAAO,CAAC,OAAO;CAgBhB"}

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

@@ -0,0 +1,32 @@
+import { TerrainControlReactProps } from './types';
+/**
+ * React wrapper component for TerrainControl.
+ *
+ * @example
+ * ```tsx
+ * import { TerrainReact } from 'maplibre-gl-components/react';
+ *
+ * function MyMap() {
+ *   const [map, setMap] = useState<Map | null>(null);
+ *
+ *   return (
+ *     <>
+ *       <div ref={mapContainer} />
+ *       {map && (
+ *         <TerrainReact
+ *           map={map}
+ *           exaggeration={1.5}
+ *           hillshade={true}
+ *           onTerrainChange={(enabled) => console.log('Terrain:', enabled)}
+ *         />
+ *       )}
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @param props - Component props including map instance and terrain options.
+ * @returns null - This component renders nothing directly.
+ */
+export declare function TerrainReact({ map, onTerrainChange, onStateChange, position, ...options }: TerrainControlReactProps): null;
+//# sourceMappingURL=TerrainReact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TerrainReact.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/TerrainReact.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAuB,MAAM,SAAS,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,YAAY,CAAC,EAC3B,GAAG,EACH,eAAe,EACf,aAAa,EACb,QAAsB,EACtB,GAAG,OAAO,EACX,EAAE,wBAAwB,GAAG,IAAI,CA6DjC"}