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

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

@@ -0,0 +1,211 @@
+import { IControl, Map as MapLibreMap, ControlPosition } from 'maplibre-gl';
+import { MeasureControlOptions, MeasureControlState, MeasureEvent, MeasureEventHandler, MeasureMode, Measurement, DistanceUnit, AreaUnit } from './types';
+/**
+ * A control for measuring distances and areas on the map.
+ *
+ * @example
+ * ```typescript
+ * const measureControl = new MeasureControl({
+ *   defaultMode: 'distance',
+ *   distanceUnit: 'kilometers',
+ * });
+ * map.addControl(measureControl, 'top-right');
+ *
+ * measureControl.on('drawend', (event) => {
+ *   console.log('Measurement:', event.measurement);
+ * });
+ * ```
+ */
+export declare class MeasureControl implements IControl {
+    private _container?;
+    private _button?;
+    private _panel?;
+    private _options;
+    private _state;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _zoomVisible;
+    private _sourceId;
+    private _lineLayerId;
+    private _fillLayerId;
+    private _resultValueEl?;
+    private _resultUnitEl?;
+    private _segmentListEl?;
+    private _instructionsEl?;
+    private _measurementsListEl?;
+    private _boundClickHandler?;
+    private _boundMoveHandler?;
+    private _boundDblClickHandler?;
+    private _boundKeyHandler?;
+    private _markers;
+    /**
+     * Creates a new MeasureControl instance.
+     */
+    constructor(options?: MeasureControlOptions);
+    /**
+     * 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: MeasureEvent, handler: MeasureEventHandler): this;
+    /**
+     * Remove an event handler.
+     */
+    off(event: MeasureEvent, handler: MeasureEventHandler): this;
+    /**
+     * Emit an event to registered handlers.
+     */
+    private _emit;
+    /**
+     * Create the control container.
+     */
+    private _createContainer;
+    /**
+     * Create the panel content.
+     */
+    private _createPanel;
+    /**
+     * Update unit dropdown options based on current mode.
+     */
+    private _updateUnitOptions;
+    /**
+     * Get the current unit label.
+     */
+    private _getCurrentUnitLabel;
+    /**
+     * 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;
+    /**
+     * Set the measurement mode.
+     */
+    private _setMode;
+    /**
+     * Set up map sources and layers for rendering measurements.
+     */
+    private _setupMapSources;
+    /**
+     * Clean up map sources and layers.
+     */
+    private _cleanupMapSources;
+    /**
+     * Start drawing a measurement.
+     */
+    private _startDrawing;
+    /**
+     * Stop drawing (cleanup event handlers).
+     */
+    private _stopDrawing;
+    /**
+     * Handle map click during drawing.
+     */
+    private _handleClick;
+    /**
+     * Handle mouse move during drawing.
+     */
+    private _handleMouseMove;
+    /**
+     * Finish the current drawing.
+     */
+    private _finishDrawing;
+    /**
+     * Cancel the current drawing.
+     */
+    private _cancelDrawing;
+    /**
+     * Update the current measurement calculation.
+     */
+    private _updateMeasurement;
+    /**
+     * Update the result display.
+     */
+    private _updateResult;
+    /**
+     * Update the map geometry (lines/polygons).
+     */
+    private _updateMapGeometry;
+    /**
+     * Add a marker for a vertex.
+     */
+    private _addMarker;
+    /**
+     * Clear all markers.
+     */
+    private _clearMarkers;
+    /**
+     * Update the measurements list display.
+     */
+    private _updateMeasurementsList;
+    /**
+     * Remove a measurement by ID.
+     */
+    private _removeMeasurement;
+    /**
+     * Clear all measurements.
+     */
+    private _clearAll;
+    /**
+     * Set up zoom-based visibility handling.
+     */
+    private _setupZoomHandler;
+    /**
+     * Show the control.
+     */
+    show(): this;
+    /**
+     * Hide the control.
+     */
+    hide(): this;
+    /**
+     * Get the current state.
+     */
+    getState(): MeasureControlState;
+    /**
+     * Get all measurements.
+     */
+    getMeasurements(): Measurement[];
+    /**
+     * Set the measurement mode.
+     */
+    setMode(mode: MeasureMode): this;
+    /**
+     * Set the distance unit.
+     */
+    setDistanceUnit(unit: DistanceUnit): this;
+    /**
+     * Set the area unit.
+     */
+    setAreaUnit(unit: AreaUnit): this;
+    /**
+     * Clear all measurements.
+     */
+    clear(): this;
+}
+//# sourceMappingURL=MeasureControl.d.ts.map

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

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

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

@@ -0,0 +1,77 @@
+import { IControl, Map as MapLibreMap, ControlPosition } from 'maplibre-gl';
+import { MinimapControlOptions, MinimapControlState, MinimapEvent, MinimapEventHandler } from './types';
+/**
+ * A control that displays a small overview map showing the current viewport extent.
+ *
+ * @example
+ * ```typescript
+ * const minimap = new MinimapControl({
+ *   width: 250,
+ *   height: 180,
+ *   zoomOffset: -5,
+ *   interactive: true,
+ * });
+ * map.addControl(minimap, 'bottom-left');
+ * ```
+ */
+export declare class MinimapControl implements IControl {
+    private _container?;
+    private _button?;
+    private _panel?;
+    private _options;
+    private _state;
+    private _eventHandlers;
+    private _map?;
+    private _minimapMap?;
+    private _handleMove?;
+    private _handleZoom?;
+    private _zoomVisible;
+    private _isDragging;
+    private _dragStartLngLat?;
+    private _dragCleanup?;
+    constructor(options?: MinimapControlOptions);
+    getDefaultPosition(): ControlPosition;
+    onAdd(map: MapLibreMap): HTMLElement;
+    onRemove(): void;
+    /**
+     * Register an event handler.
+     */
+    on(event: MinimapEvent, handler: MinimapEventHandler): this;
+    /**
+     * Remove an event handler.
+     */
+    off(event: MinimapEvent, handler: MinimapEventHandler): this;
+    private _emit;
+    private _createContainer;
+    private _showPanel;
+    private _hidePanel;
+    private _syncMinimap;
+    private _addViewportRect;
+    private _updateViewportRect;
+    private _checkZoomVisibility;
+    /**
+     * Show the control.
+     */
+    show(): this;
+    /**
+     * Hide the control.
+     */
+    hide(): this;
+    /**
+     * Expand the minimap (show the panel).
+     */
+    expand(): this;
+    /**
+     * Collapse the minimap (hide the panel).
+     */
+    collapse(): this;
+    /**
+     * Toggle the collapsed state.
+     */
+    toggle(): this;
+    /**
+     * Get the current state.
+     */
+    getState(): MinimapControlState;
+}
+//# sourceMappingURL=MinimapControl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MinimapControl.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/MinimapControl.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EACV,QAAQ,EACR,GAAG,IAAI,WAAW,EAClB,eAAe,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACpB,MAAM,SAAS,CAAC;AA+BjB;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAC7C,OAAO,CAAC,UAAU,CAAC,CAAc;IACjC,OAAO,CAAC,OAAO,CAAC,CAAoB;IACpC,OAAO,CAAC,MAAM,CAAC,CAAc;IAC7B,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,CAAiB;IACrC,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,gBAAgB,CAAC,CAA+B;IACxD,OAAO,CAAC,YAAY,CAAC,CAAa;gBAEtB,OAAO,CAAC,EAAE,qBAAqB;IAQ3C,kBAAkB,IAAI,eAAe;IAIrC,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW;IAoBpC,QAAQ,IAAI,IAAI;IA0BhB;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAQ3D;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAK5D,OAAO,CAAC,KAAK;IAQb,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,UAAU;IA2IlB,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,gBAAgB;IAiCxB,OAAO,CAAC,mBAAmB;IA2B3B,OAAO,CAAC,oBAAoB;IAY5B;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;OAEG;IACH,QAAQ,IAAI,IAAI;IAQhB;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,QAAQ,IAAI,mBAAmB;CAGhC"}

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

@@ -0,0 +1,32 @@
+import { MinimapControlReactProps } from './types';
+/**
+ * React wrapper component for MinimapControl.
+ *
+ * @example
+ * ```tsx
+ * import { MinimapControlReact } from 'maplibre-gl-components/react';
+ *
+ * function MyMap() {
+ *   const [map, setMap] = useState<Map | null>(null);
+ *
+ *   return (
+ *     <>
+ *       <div ref={mapContainer} />
+ *       {map && (
+ *         <MinimapControlReact
+ *           map={map}
+ *           width={250}
+ *           height={180}
+ *           interactive={true}
+ *         />
+ *       )}
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @param props - Component props including map instance and minimap options.
+ * @returns null - This component renders nothing directly.
+ */
+export declare function MinimapControlReact({ map, onStateChange, position, ...options }: MinimapControlReactProps): null;
+//# sourceMappingURL=MinimapControlReact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MinimapControlReact.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/MinimapControlReact.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAuB,MAAM,SAAS,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,GAAG,EACH,aAAa,EACb,QAAwB,EACxB,GAAG,OAAO,EACX,EAAE,wBAAwB,GAAG,IAAI,CA8BjC"}

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

@@ -0,0 +1,119 @@
+import { IControl, Map as MapLibreMap } from 'maplibre-gl';
+import { PMTilesLayerControlOptions, PMTilesLayerControlState, PMTilesLayerEvent, PMTilesLayerEventHandler } from './types';
+/**
+ * A control for adding PMTiles layers to the map.
+ *
+ * Supports both vector and raster PMTiles files.
+ *
+ * @example
+ * ```typescript
+ * const pmtilesControl = new PMTilesLayerControl({
+ *   defaultUrl: 'https://example.com/tiles.pmtiles',
+ *   loadDefaultUrl: true,
+ * });
+ * map.addControl(pmtilesControl, 'top-right');
+ *
+ * pmtilesControl.on('layeradd', (event) => {
+ *   console.log('PMTiles layer added:', event.url);
+ * });
+ * ```
+ */
+export declare class PMTilesLayerControl implements IControl {
+    private _container?;
+    private _button?;
+    private _panel?;
+    private _options;
+    private _state;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _zoomVisible;
+    private _pmtilesLayers;
+    private _layerCounter;
+    private _protocolRegistered;
+    private _protocol?;
+    private _popup?;
+    private _clickHandler?;
+    constructor(options?: PMTilesLayerControlOptions);
+    onAdd(map: MapLibreMap): HTMLElement;
+    onRemove(): void;
+    show(): void;
+    hide(): void;
+    expand(): void;
+    collapse(): void;
+    toggle(): void;
+    getState(): PMTilesLayerControlState;
+    update(options: Partial<PMTilesLayerControlOptions>): void;
+    on(event: PMTilesLayerEvent, handler: PMTilesLayerEventHandler): void;
+    off(event: PMTilesLayerEvent, handler: PMTilesLayerEventHandler): void;
+    /**
+     * Programmatically add a PMTiles layer.
+     */
+    addLayer(url?: string): Promise<void>;
+    /**
+     * Programmatically remove a PMTiles layer by ID, or all layers if no ID given.
+     */
+    removeLayer(id?: string): void;
+    /**
+     * Get all PMTiles layer IDs.
+     */
+    getLayerIds(): string[];
+    /**
+     * Find the source info that contains a specific layer ID.
+     */
+    private _findSourceByLayerId;
+    /**
+     * Get the opacity of a layer (by layer ID or source ID).
+     */
+    getLayerOpacity(id: string): number | null;
+    /**
+     * Set the opacity of a layer (by layer ID or source ID).
+     * If layer ID is provided, sets opacity for that specific layer.
+     * If source ID is provided, sets opacity for all layers from that source.
+     */
+    setLayerOpacity(id: string, opacity: number): void;
+    /**
+     * Set opacity directly on a MapLibre layer.
+     */
+    private _setLayerOpacityDirect;
+    /**
+     * Get the visibility of a layer (by layer ID or source ID).
+     */
+    getLayerVisibility(id: string): boolean;
+    /**
+     * Set the visibility of a layer (by layer ID or source ID).
+     * If layer ID is provided, sets visibility for that specific layer.
+     * If source ID is provided, sets visibility for all layers from that source.
+     */
+    setLayerVisibility(id: string, visible: boolean): void;
+    /**
+     * Get the URL for a specific PMTiles source.
+     */
+    getLayerUrl(sourceId: string): string | null;
+    /**
+     * Get whether features are pickable (clickable) globally or for a specific source.
+     */
+    getPickable(sourceId?: string): boolean;
+    /**
+     * Set whether features are pickable (clickable).
+     * If sourceId is provided, sets pickable for that specific source.
+     * If no sourceId, sets the global pickable state for all current and future layers.
+     */
+    setPickable(pickable: boolean, sourceId?: string): void;
+    private _emit;
+    private _setupClickHandler;
+    private _checkZoomVisibility;
+    private _updateDisplayState;
+    private _createContainer;
+    private _render;
+    private _renderCollapsed;
+    private _renderExpanded;
+    private _createFormGroup;
+    private _appendStatus;
+    private _ensureProtocol;
+    private _fetchSourceLayers;
+    private _addLayer;
+    private _removeLayer;
+    private _updateOpacity;
+}
+//# sourceMappingURL=PMTilesLayer.d.ts.map

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

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

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

@@ -0,0 +1,226 @@
+import { IControl, Map as MapLibreMap, ControlPosition } from 'maplibre-gl';
+import { PrintControlOptions, PrintControlState, PrintEvent, PrintEventHandler, PrintColorbarConfig } from './types';
+/**
+ * A control for exporting the current map view as an image.
+ *
+ * @example
+ * ```typescript
+ * const printControl = new PrintControl({
+ *   filename: 'my-map',
+ *   format: 'png',
+ * });
+ * map.addControl(printControl, 'top-right');
+ *
+ * printControl.on('export', (event) => {
+ *   console.log('Map exported:', event.state.filename);
+ * });
+ * ```
+ */
+export declare class PrintControl implements IControl {
+    private _container?;
+    private _button?;
+    private _panel?;
+    private _options;
+    private _state;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _zoomVisible;
+    private _titleInput?;
+    private _northArrowInput?;
+    private _scaleBarInput?;
+    private _colorbarInput?;
+    private _colorbarSettingsDiv?;
+    private _colorbarColormapSelect?;
+    private _colorbarOrientationSelect?;
+    private _colorbarVminInput?;
+    private _colorbarVmaxInput?;
+    private _colorbarLabelInput?;
+    private _colorbarUnitsInput?;
+    private _filenameInput?;
+    private _formatSelect?;
+    private _qualityInput?;
+    private _qualityValue?;
+    private _qualityField?;
+    private _sizeRadioCurrent?;
+    private _sizeRadioCustom?;
+    private _widthInput?;
+    private _heightInput?;
+    private _customSizeInputs?;
+    private _exportBtn?;
+    private _copyBtn?;
+    private _feedbackEl?;
+    /**
+     * Creates a new PrintControl instance.
+     */
+    constructor(options?: PrintControlOptions);
+    /**
+     * 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: PrintEvent, handler: PrintEventHandler): this;
+    /**
+     * Remove an event handler.
+     */
+    off(event: PrintEvent, handler: PrintEventHandler): this;
+    /**
+     * Emit an event to registered handlers.
+     */
+    private _emit;
+    /**
+     * Create the control container.
+     */
+    private _createContainer;
+    /**
+     * Create the panel content.
+     */
+    private _createPanel;
+    /**
+     * Toggle quality field visibility based on format.
+     */
+    private _updateQualityVisibility;
+    /**
+     * Toggle copy button visibility (hidden for PDF format).
+     */
+    private _updateCopyBtnVisibility;
+    /**
+     * Export the canvas to a PDF file using jspdf.
+     */
+    private _exportPdf;
+    /**
+     * Toggle custom size inputs visibility.
+     */
+    private _updateCustomSizeVisibility;
+    /**
+     * Toggle colorbar settings visibility.
+     */
+    private _updateColorbarSettingsVisibility;
+    /**
+     * Get color stops from colormap configuration.
+     */
+    private _getColorStops;
+    /**
+     * Draw a colorbar on the export canvas.
+     */
+    private _drawColorbar;
+    /**
+     * Format a tick value for display.
+     */
+    private _formatTickValue;
+    /**
+     * 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;
+    /**
+     * Show feedback message.
+     */
+    private _showFeedback;
+    /**
+     * Set loading state on buttons.
+     */
+    private _setExporting;
+    /**
+     * Capture the map canvas during the render cycle.
+     * WebGL canvases have preserveDrawingBuffer=false by default, so the
+     * framebuffer is cleared after compositing. We must read it during render.
+     */
+    private _captureMapCanvas;
+    /**
+     * Draw a north arrow on the export canvas.
+     */
+    private _drawNorthArrow;
+    /**
+     * Return a rounded scale distance using 1/2/5 progression.
+     */
+    private _niceDistance;
+    /**
+     * Draw a scale bar on the export canvas.
+     */
+    private _drawScaleBar;
+    /**
+     * Create the export canvas from the map.
+     */
+    private _createExportCanvas;
+    /**
+     * Export the map to a file download.
+     */
+    private _exportMap;
+    /**
+     * Copy the map to clipboard.
+     */
+    private _copyToClipboard;
+    /**
+     * Set up zoom-based visibility handling.
+     */
+    private _setupZoomHandler;
+    /**
+     * Show the control.
+     */
+    show(): this;
+    /**
+     * Hide the control.
+     */
+    hide(): this;
+    /**
+     * Get the current state.
+     */
+    getState(): PrintControlState;
+    /**
+     * Set the export format.
+     */
+    setFormat(format: "png" | "jpeg" | "pdf"): this;
+    /**
+     * Set the JPEG quality.
+     */
+    setQuality(quality: number): this;
+    /**
+     * Set the title text.
+     */
+    setTitle(title: string): this;
+    /**
+     * Export the map programmatically and return a data URL.
+     */
+    exportMap(options?: {
+        format?: "png" | "jpeg" | "pdf";
+        quality?: number;
+        filename?: string;
+        title?: string;
+        includeNorthArrow?: boolean;
+        includeScaleBar?: boolean;
+        colorbar?: PrintColorbarConfig;
+        width?: number;
+        height?: number;
+    }): Promise<string>;
+    /**
+     * Set the colorbar configuration.
+     */
+    setColorbar(config: PrintColorbarConfig): this;
+}
+//# sourceMappingURL=PrintControl.d.ts.map

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

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