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

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

@@ -0,0 +1,206 @@
+import { IControl, Map as MapLibreMap } from 'maplibre-gl';
+import { BasemapControlOptions, BasemapControlState, BasemapItem, BasemapEvent } from './types';
+/**
+ * Event handler type for basemap events.
+ */
+type BasemapEventHandler = (event: {
+    type: BasemapEvent;
+    state: BasemapControlState;
+    basemap?: BasemapItem;
+}) => void;
+/**
+ * A basemap switcher control for MapLibre GL maps.
+ *
+ * Allows users to interactively switch between different basemap tile sources.
+ * Supports loading basemaps from xyzservices or custom basemap arrays.
+ *
+ * @example
+ * ```typescript
+ * const basemapControl = new BasemapControl({
+ *   defaultBasemap: 'OpenStreetMap.Mapnik',
+ *   showSearch: true,
+ *   filterGroups: ['OpenStreetMap', 'CartoDB', 'Stadia'],
+ * });
+ * map.addControl(basemapControl, 'top-right');
+ * ```
+ */
+export declare class BasemapControl implements IControl {
+    private _container?;
+    private _options;
+    private _state;
+    private _basemaps;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _zoomVisible;
+    /**
+     * Creates a new BasemapControl instance.
+     *
+     * @param options - Configuration options for the control.
+     */
+    constructor(options?: BasemapControlOptions);
+    /**
+     * 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 control (if collapsible).
+     */
+    expand(): void;
+    /**
+     * Collapses the control (if collapsible).
+     */
+    collapse(): void;
+    /**
+     * Toggles the collapsed state.
+     */
+    toggle(): void;
+    /**
+     * Sets the active basemap by ID.
+     *
+     * @param basemapId - The ID of the basemap to activate.
+     */
+    setBasemap(basemapId: string): void;
+    /**
+     * Gets the list of available basemaps.
+     *
+     * @returns Array of basemap items.
+     */
+    getBasemaps(): BasemapItem[];
+    /**
+     * Adds a custom basemap.
+     *
+     * @param basemap - The basemap item to add.
+     */
+    addBasemap(basemap: BasemapItem): void;
+    /**
+     * Removes a basemap by ID.
+     *
+     * @param basemapId - The ID of the basemap to remove.
+     */
+    removeBasemap(basemapId: string): void;
+    /**
+     * Sets an API key for a basemap.
+     *
+     * @param basemapId - The ID of the basemap.
+     * @param apiKey - The API key to set.
+     */
+    setApiKey(basemapId: string, apiKey: string): void;
+    /**
+     * Updates control options and re-renders.
+     *
+     * @param options - Partial options to update.
+     */
+    update(options: Partial<BasemapControlOptions>): void;
+    /**
+     * Gets the current state.
+     *
+     * @returns The current control state.
+     */
+    getState(): BasemapControlState;
+    /**
+     * Gets the currently selected basemap.
+     *
+     * @returns The selected basemap item, or null if none selected.
+     */
+    getSelectedBasemap(): BasemapItem | null;
+    /**
+     * Registers an event handler.
+     *
+     * @param event - The event type to listen for.
+     * @param handler - The callback function.
+     */
+    on(event: BasemapEvent, handler: BasemapEventHandler): void;
+    /**
+     * Removes an event handler.
+     *
+     * @param event - The event type.
+     * @param handler - The callback function to remove.
+     */
+    off(event: BasemapEvent, handler: BasemapEventHandler): void;
+    /**
+     * Emits an event to all registered handlers.
+     */
+    private _emit;
+    /**
+     * Fetches providers from the xyzservices URL.
+     */
+    private _fetchProviders;
+    /**
+     * Applies a basemap to the map.
+     */
+    private _applyBasemap;
+    /**
+     * Applies an XYZ tile basemap.
+     */
+    private _applyXYZBasemap;
+    /**
+     * Applies a vector style basemap.
+     */
+    private _applyStyleBasemap;
+    /**
+     * Removes the basemap layer and source.
+     */
+    private _removeBasemapLayer;
+    /**
+     * 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.
+     */
+    private _createContainer;
+    /**
+     * Renders the control content.
+     */
+    private _render;
+    /**
+     * Creates the icon button for collapsed state.
+     */
+    private _createIconButton;
+    /**
+     * Creates the header element.
+     */
+    private _createHeader;
+    /**
+     * Creates the search input element.
+     */
+    private _createSearchInput;
+    /**
+     * Creates the below labels checkbox element.
+     */
+    private _createBelowLabelsCheckbox;
+    /**
+     * Renders the list mode.
+     */
+    private _renderList;
+    /**
+     * Renders the gallery mode.
+     */
+    private _renderGallery;
+    /**
+     * Creates a basemap item element.
+     */
+    private _createBasemapItem;
+}
+export {};
+//# sourceMappingURL=Basemap.d.ts.map

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

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

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

@@ -0,0 +1,32 @@
+import { BasemapControlReactProps } from './types';
+/**
+ * React wrapper component for BasemapControl.
+ *
+ * @example
+ * ```tsx
+ * import { BasemapReact } from 'maplibre-gl-components/react';
+ *
+ * function MyMap() {
+ *   const [map, setMap] = useState<Map | null>(null);
+ *
+ *   return (
+ *     <>
+ *       <div ref={mapContainer} />
+ *       {map && (
+ *         <BasemapReact
+ *           map={map}
+ *           defaultBasemap="OpenStreetMap.Mapnik"
+ *           showSearch
+ *           onBasemapChange={(basemap) => console.log('Changed to:', basemap.name)}
+ *         />
+ *       )}
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @param props - Component props including map instance and basemap control options.
+ * @returns null - This component renders nothing directly.
+ */
+export declare function BasemapReact({ map, onBasemapChange, onStateChange, position, ...options }: BasemapControlReactProps): null;
+//# sourceMappingURL=BasemapReact.d.ts.map

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

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

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

@@ -0,0 +1,180 @@
+import { IControl, Map as MapLibreMap, ControlPosition } from 'maplibre-gl';
+import { BookmarkControlOptions, BookmarkControlState, BookmarkEvent, BookmarkEventHandler, MapBookmark } from './types';
+/**
+ * A control for saving and restoring map bookmarks/views.
+ *
+ * @example
+ * ```typescript
+ * const bookmarkControl = new BookmarkControl({
+ *   storageKey: 'my-map-bookmarks',
+ *   flyToDuration: 2000,
+ * });
+ * map.addControl(bookmarkControl, 'top-right');
+ *
+ * bookmarkControl.on('select', (event) => {
+ *   console.log('Selected bookmark:', event.bookmark);
+ * });
+ * ```
+ */
+export declare class BookmarkControl implements IControl {
+    private _container?;
+    private _button?;
+    private _panel?;
+    private _options;
+    private _state;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _zoomVisible;
+    private _listEl?;
+    private _nameInput?;
+    /**
+     * Creates a new BookmarkControl instance.
+     */
+    constructor(options?: BookmarkControlOptions);
+    /**
+     * Called when the control is added to the map.
+     */
+    onAdd(map: MapLibreMap): HTMLElement;
+    /**
+     * Called when the control is removed from the map.
+     */
+    onRemove(): void;
+    /**
+     * Get the default position for this control.
+     */
+    getDefaultPosition(): ControlPosition;
+    /**
+     * Register an event handler.
+     */
+    on(event: BookmarkEvent, handler: BookmarkEventHandler): this;
+    /**
+     * Remove an event handler.
+     */
+    off(event: BookmarkEvent, handler: BookmarkEventHandler): this;
+    /**
+     * Emit an event to registered handlers.
+     */
+    private _emit;
+    /**
+     * Create the control container.
+     */
+    private _createContainer;
+    /**
+     * Create the panel content.
+     */
+    private _createPanel;
+    /**
+     * Expand the panel.
+     */
+    expand(): void;
+    /**
+     * Collapse the panel.
+     */
+    collapse(): void;
+    /**
+     * Toggle the panel visibility.
+     */
+    private _togglePanel;
+    /**
+     * Show the panel.
+     */
+    private _showPanel;
+    /**
+     * Hide the panel.
+     */
+    private _hidePanel;
+    /**
+     * Update the bookmarks list display.
+     */
+    private _updateList;
+    /**
+     * Escape HTML for safe rendering.
+     */
+    private _escapeHtml;
+    /**
+     * Add a new bookmark.
+     */
+    private _addBookmark;
+    /**
+     * Remove a bookmark by ID.
+     */
+    private _removeBookmark;
+    /**
+     * Go to a bookmark.
+     */
+    private _goToBookmark;
+    /**
+     * Start renaming a bookmark.
+     */
+    private _startRename;
+    /**
+     * Clear all bookmarks.
+     */
+    private _clearAll;
+    /**
+     * Update the footer (show/hide Clear All based on bookmark count).
+     */
+    private _updateFooter;
+    /**
+     * Export bookmarks to a JSON file download.
+     */
+    private _exportToFile;
+    /**
+     * Import bookmarks from a JSON file via file picker.
+     */
+    private _importFromFile;
+    /**
+     * Save bookmarks to localStorage.
+     */
+    private _saveToStorage;
+    /**
+     * Load bookmarks from localStorage.
+     */
+    private _loadFromStorage;
+    /**
+     * Set up zoom-based visibility handling.
+     */
+    private _setupZoomHandler;
+    /**
+     * Show the control.
+     */
+    show(): this;
+    /**
+     * Hide the control.
+     */
+    hide(): this;
+    /**
+     * Get the current state.
+     */
+    getState(): BookmarkControlState;
+    /**
+     * Get all bookmarks.
+     */
+    getBookmarks(): MapBookmark[];
+    /**
+     * Add a bookmark programmatically.
+     */
+    addBookmark(name?: string): this;
+    /**
+     * Remove a bookmark by ID.
+     */
+    removeBookmark(id: string): this;
+    /**
+     * Go to a bookmark by ID.
+     */
+    goTo(id: string): this;
+    /**
+     * Clear all bookmarks.
+     */
+    clear(): this;
+    /**
+     * Import bookmarks from an array.
+     */
+    importBookmarks(bookmarks: MapBookmark[]): this;
+    /**
+     * Export bookmarks as JSON string.
+     */
+    exportBookmarks(): string;
+}
+//# sourceMappingURL=BookmarkControl.d.ts.map

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

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

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

@@ -0,0 +1,105 @@
+import { IControl, Map as MapLibreMap } from 'maplibre-gl';
+import { ChoroplethControlOptions, ChoroplethControlState, ChoroplethEvent, ChoroplethEventHandler, ChoroplethClassificationScheme, ColormapName } from './types';
+/**
+ * A control for adding choropleth (thematic) maps from vector data URLs.
+ * Supports classification schemes, colormaps, fill and extrusion modes.
+ *
+ * @example
+ * ```typescript
+ * const choropleth = new ChoroplethControl({
+ *   defaultUrl: 'https://data.source.coop/giswqs/opengeos/h3_res4_geo.parquet',
+ *   defaultColumn: 'value',
+ *   defaultColormap: 'viridis',
+ *   defaultScheme: 'quantile',
+ *   defaultK: 5,
+ * });
+ * map.addControl(choropleth, 'top-right');
+ * ```
+ */
+export declare class ChoroplethControl implements IControl {
+    private _container?;
+    private _button?;
+    private _panel?;
+    private _options;
+    private _state;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _zoomVisible;
+    private _choroplethLayers;
+    private _legendControls;
+    private _activePopup?;
+    private _cachedGeojson?;
+    private _cachedColumns;
+    constructor(options?: ChoroplethControlOptions);
+    onAdd(map: MapLibreMap): HTMLElement;
+    onRemove(): void;
+    show(): void;
+    hide(): void;
+    expand(): void;
+    collapse(): void;
+    toggle(): void;
+    getState(): ChoroplethControlState;
+    update(options: Partial<ChoroplethControlOptions>): void;
+    on(event: ChoroplethEvent, handler: ChoroplethEventHandler): void;
+    off(event: ChoroplethEvent, handler: ChoroplethEventHandler): void;
+    /**
+     * Programmatically add a choropleth layer.
+     */
+    addLayer(url?: string, column?: string, options?: {
+        colormap?: ColormapName;
+        scheme?: ChoroplethClassificationScheme;
+        k?: number;
+    }): Promise<void>;
+    /**
+     * Remove a choropleth layer by ID.
+     */
+    removeLayer(id?: string): void;
+    /**
+     * Get all choropleth layer IDs.
+     */
+    getLayerIds(): string[];
+    private _emit;
+    private _checkZoomVisibility;
+    private _updateDisplayState;
+    private _createContainer;
+    private _render;
+    private _renderCollapsed;
+    private _renderExpanded;
+    private _createFormGroup;
+    private _appendStatus;
+    private _updateColormapPreview;
+    /**
+     * Load vector data from URL and detect numeric columns.
+     */
+    private _loadData;
+    /**
+     * Detect numeric columns from GeoJSON features.
+     */
+    private _detectNumericColumns;
+    /**
+     * Create and add the choropleth layer to the map.
+     */
+    private _addChoroplethLayer;
+    private _formatBreak;
+    private _normalizeGeoJSON;
+    private _fetchWithCorsProxy;
+    private _loadGeoParquet;
+    private _loadFlatGeobuf;
+    private _fitToData;
+    private _removeLayer;
+    /**
+     * Add a Legend control to the map for a given choropleth layer.
+     */
+    private _addLegendControl;
+    /**
+     * Remove a Legend control from the map for a given choropleth layer.
+     */
+    private _removeLegendControl;
+    /**
+     * Remove all Legend controls from the map.
+     */
+    private _removeAllLegendControls;
+    private _removeAllLayers;
+}
+//# sourceMappingURL=ChoroplethControl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChoroplethControl.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/ChoroplethControl.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,kCAAkC,CAAC;AAC1C,OAAmB,EACjB,KAAK,QAAQ,EACb,KAAK,GAAG,IAAI,WAAW,EACxB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACtB,eAAe,EACf,sBAAsB,EAEtB,8BAA8B,EAC9B,YAAY,EAEb,MAAM,SAAS,CAAC;AAiQjB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,iBAAkB,YAAW,QAAQ;IAChD,OAAO,CAAC,UAAU,CAAC,CAAc;IACjC,OAAO,CAAC,OAAO,CAAC,CAAoB;IACpC,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,iBAAiB,CAA+C;IACxE,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,YAAY,CAAC,CAAmB;IAExC,OAAO,CAAC,cAAc,CAAC,CAA4B;IACnD,OAAO,CAAC,cAAc,CAAgB;gBAE1B,OAAO,CAAC,EAAE,wBAAwB;IA6B9C,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW;IAsBpC,QAAQ,IAAI,IAAI;IAiBhB,IAAI,IAAI,IAAI;IAQZ,IAAI,IAAI,IAAI;IAQZ,MAAM,IAAI,IAAI;IAQd,QAAQ,IAAI,IAAI;IAQhB,MAAM,IAAI,IAAI;IAKd,QAAQ,IAAI,sBAAsB;IAIlC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,IAAI;IASxD,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;IACG,QAAQ,CACZ,GAAG,CAAC,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,YAAY,CAAC;QACxB,MAAM,CAAC,EAAE,8BAA8B,CAAC;QACxC,CAAC,CAAC,EAAE,MAAM,CAAC;KACZ,GACA,OAAO,CAAC,IAAI,CAAC;IAYhB;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAK9B;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAQvB,OAAO,CAAC,KAAK;IAWb,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,OAAO;IA4Bf,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,eAAe;IAifvB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,sBAAsB;IAY9B;;OAEG;YACW,SAAS;IAmEvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkC7B;;OAEG;YACW,mBAAmB;IA0VjC,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,iBAAiB;YAsBX,mBAAmB;YAuBnB,eAAe;YAiCf,eAAe;IAwB7B,OAAO,CAAC,UAAU;IAoDlB,OAAO,CAAC,YAAY;IAoCpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAYhC,OAAO,CAAC,gBAAgB;CA8BzB"}

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

@@ -0,0 +1,139 @@
+import { IControl, Map as MapLibreMap } from 'maplibre-gl';
+import { CogLayerControlOptions, CogLayerControlState, CogLayerEvent, CogLayerEventHandler } from './types';
+/**
+ * A control for adding Cloud Optimized GeoTIFF (COG) layers to the map.
+ *
+ * Uses deck.gl's COGLayer rendered through MapboxOverlay for efficient
+ * streaming and rendering of COG imagery.
+ *
+ * @example
+ * ```typescript
+ * const cogControl = new CogLayerControl({
+ *   defaultUrl: 'https://example.com/cog.tif',
+ *   defaultColormap: 'terrain',
+ * });
+ * map.addControl(cogControl, 'top-right');
+ *
+ * cogControl.on('layeradd', (event) => {
+ *   console.log('COG layer added:', event.url);
+ * });
+ * ```
+ */
+export declare class CogLayerControl implements IControl {
+    private _container?;
+    private _button?;
+    private _panel?;
+    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?: CogLayerControlOptions);
+    onAdd(map: MapLibreMap): HTMLElement;
+    onRemove(): void;
+    show(): void;
+    hide(): void;
+    expand(): void;
+    collapse(): void;
+    toggle(): void;
+    getState(): CogLayerControlState;
+    update(options: Partial<CogLayerControlOptions>): void;
+    on(event: CogLayerEvent, handler: CogLayerEventHandler): void;
+    off(event: CogLayerEvent, handler: CogLayerEventHandler): void;
+    /**
+     * Programmatically add a COG layer.
+     */
+    addLayer(url?: string): Promise<void>;
+    /**
+     * Programmatically remove a COG layer by ID, or all layers if no ID given.
+     */
+    removeLayer(id?: string): void;
+    /**
+     * Get all COG layer IDs.
+     * Useful for adapters and external integrations.
+     */
+    getLayerIds(): string[];
+    /**
+     * Get the opacity of a specific COG layer.
+     * @param layerId The layer ID
+     * @returns The opacity value (0-1) or null if layer not found
+     */
+    getLayerOpacity(layerId: string): number | null;
+    /**
+     * Set the opacity of a specific COG layer.
+     * @param layerId The layer ID
+     * @param opacity The opacity value (0-1)
+     */
+    setLayerOpacity(layerId: string, opacity: number): void;
+    /**
+     * Get the visibility of a specific COG layer.
+     * Visibility is simulated via opacity (opacity > 0 = visible).
+     * @param layerId The layer ID
+     * @returns true if visible, false otherwise
+     */
+    getLayerVisibility(layerId: string): boolean;
+    /**
+     * Set the visibility of a specific COG layer.
+     * Visibility is simulated by setting opacity to 0 (hidden) or restoring it (visible).
+     * @param layerId The layer ID
+     * @param visible Whether the layer should be visible
+     * @param storedOpacity Optional opacity to restore when making visible (defaults to 1)
+     */
+    setLayerVisibility(layerId: string, visible: boolean, storedOpacity?: number): void;
+    /**
+     * Get the URL for a specific COG layer.
+     * @param layerId The layer ID
+     * @returns The COG URL or null if layer not found
+     */
+    getLayerUrl(layerId: string): string | null;
+    private _emit;
+    private _checkZoomVisibility;
+    private _updateDisplayState;
+    private _createContainer;
+    private _render;
+    private _renderCollapsed;
+    private _renderExpanded;
+    private _createFormGroup;
+    private _appendStatus;
+    private _updateColormapPreview;
+    private _updateColormapPreviewElement;
+    private _ensureOverlay;
+    private _setupClickHandler;
+    private _updatePickable;
+    private _rebuildLayers;
+    /**
+     * Register common projections that may not be included by default.
+     */
+    private _registerCommonProjections;
+    /**
+     * Build a geoKeysParser function using geotiff-geokeys-to-proj4.
+     * This converts GeoTIFF geokeys to a ProjectionInfo object compatible
+     * with @developmentseed/deck.gl-geotiff.
+     */
+    private _buildGeoKeysParser;
+    /**
+     * Monkey-patch COGLayer._parseGeoTIFF to handle floating-point GeoTIFFs.
+     * The upstream library only supports unsigned integer data (SampleFormat: 1).
+     * This patch catches the "non-unsigned integers not yet supported" error and
+     * re-implements the parsing with a float-compatible render pipeline.
+     */
+    private _patchCOGLayerForFloat;
+    /**
+     * Monkey-patch COGLayer._renderSubLayers to propagate opacity to sublayers.
+     * The upstream COGLayer doesn't pass opacity to its RasterLayer/PathLayer
+     * sublayers, so opacity changes have no visual effect without this patch.
+     */
+    private _patchCOGLayerForOpacity;
+    private _addLayer;
+    private _removeLayer;
+    private _updateOpacity;
+    private _buildLayerInfoList;
+}
+//# sourceMappingURL=CogLayer.d.ts.map

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

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