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

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

@@ -0,0 +1,68 @@
+import { IControl, Map as MapLibreMap, ControlPosition } from 'maplibre-gl';
+import { HtmlGuiControlOptions, HtmlGuiControlState, HtmlGuiEvent, HtmlGuiEventHandler } from './types';
+import { HtmlControl } from './HtmlControl';
+/**
+ * A GUI control for adding and configuring HTML content controls on the map.
+ *
+ * Provides a panel with a text area for HTML content, title, position
+ * selection, and collapsibility options. The HTML control is added as a
+ * separate control to the map.
+ *
+ * @example
+ * ```typescript
+ * const htmlGui = new HtmlGuiControl({ collapsed: true });
+ * map.addControl(htmlGui, 'top-right');
+ *
+ * htmlGui.on('htmladd', (e) => {
+ *   console.log('HTML control added:', e.state);
+ * });
+ * ```
+ */
+export declare class HtmlGuiControl implements IControl {
+    private _container?;
+    private _button?;
+    private _panel?;
+    private _options;
+    private _state;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _zoomVisible;
+    private _htmlControl?;
+    private _titleInput?;
+    private _htmlTextarea?;
+    private _positionSelect?;
+    private _collapsibleCheckbox?;
+    private _addBtn?;
+    private _removeBtn?;
+    private _previewEl?;
+    constructor(options?: HtmlGuiControlOptions);
+    onAdd(map: MapLibreMap): HTMLElement;
+    onRemove(): void;
+    getDefaultPosition(): ControlPosition;
+    on(event: HtmlGuiEvent, handler: HtmlGuiEventHandler): this;
+    off(event: HtmlGuiEvent, handler: HtmlGuiEventHandler): this;
+    private _emit;
+    expand(): void;
+    collapse(): void;
+    show(): this;
+    hide(): this;
+    getState(): HtmlGuiControlState;
+    private _createContainer;
+    private _createPanel;
+    private _createField;
+    private _updatePreviewContent;
+    private _addHtmlControl;
+    private _updateHtmlControl;
+    private _removeHtmlControl;
+    private _updateButtonStates;
+    private _togglePanel;
+    private _showPanel;
+    private _hidePanel;
+    private _setupZoomHandler;
+    /**
+     * Get the active HtmlControl instance (if any).
+     */
+    getHtmlControl(): HtmlControl | undefined;
+}
+//# sourceMappingURL=HtmlGuiControl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HtmlGuiControl.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/HtmlGuiControl.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,gCAAgC,CAAC;AACxC,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;AACjB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA2B5C;;;;;;;;;;;;;;;;GAgBG;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,CAAa;IACjC,OAAO,CAAC,YAAY,CAAiB;IAGrC,OAAO,CAAC,YAAY,CAAC,CAAc;IAGnC,OAAO,CAAC,WAAW,CAAC,CAAmB;IACvC,OAAO,CAAC,aAAa,CAAC,CAAsB;IAC5C,OAAO,CAAC,eAAe,CAAC,CAAoB;IAC5C,OAAO,CAAC,oBAAoB,CAAC,CAAmB;IAChD,OAAO,CAAC,OAAO,CAAC,CAAoB;IACpC,OAAO,CAAC,UAAU,CAAC,CAAoB;IACvC,OAAO,CAAC,UAAU,CAAC,CAAc;gBAErB,OAAO,CAAC,EAAE,qBAAqB;IAa3C,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW;IAUpC,QAAQ,IAAI,IAAI;IAUhB,kBAAkB,IAAI,eAAe;IAIrC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAQ3D,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAK5D,OAAO,CAAC,KAAK;IAQb,MAAM,IAAI,IAAI;IAOd,QAAQ,IAAI,IAAI;IAOhB,IAAI,IAAI,IAAI;IASZ,IAAI,IAAI,IAAI;IASZ,QAAQ,IAAI,mBAAmB;IAI/B,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,YAAY;IAgJpB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,cAAc,IAAI,WAAW,GAAG,SAAS;CAG1C"}

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

@@ -0,0 +1,202 @@
+import { IControl, Map as MapLibreMap } from 'maplibre-gl';
+import { InspectControlOptions, InspectControlState, InspectedFeature, InspectEvent, InspectEventHandler } from './types';
+/**
+ * A control for inspecting vector features on the map.
+ *
+ * Provides click-to-inspect functionality that shows feature properties/attributes
+ * in a popup. Supports multiple features at the same location with navigation.
+ *
+ * @example
+ * ```typescript
+ * const inspectControl = new InspectControl({
+ *   excludeLayers: ['background'],
+ *   highlightStyle: { strokeColor: '#00ff00', strokeWidth: 4 },
+ * });
+ * map.addControl(inspectControl, 'top-right');
+ *
+ * // Listen for feature selection
+ * inspectControl.on('featureselect', (event) => {
+ *   console.log('Selected:', event.feature);
+ * });
+ * ```
+ */
+export declare class InspectControl implements IControl {
+    private _container?;
+    private _button?;
+    private _options;
+    private _state;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _zoomVisible;
+    private _popup?;
+    private _highlightSourceId;
+    private _highlightLayerIds;
+    private _boundClickHandler?;
+    /**
+     * Creates a new InspectControl instance.
+     *
+     * @param options - Configuration options for the control.
+     */
+    constructor(options?: InspectControlOptions);
+    /**
+     * 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;
+    /**
+     * Enables inspect mode.
+     */
+    enable(): void;
+    /**
+     * Disables inspect mode.
+     */
+    disable(): void;
+    /**
+     * Toggles inspect mode on/off.
+     */
+    toggle(): void;
+    /**
+     * Returns whether inspect mode is enabled.
+     */
+    isEnabled(): boolean;
+    /**
+     * Shows the control.
+     */
+    show(): void;
+    /**
+     * Hides the control.
+     */
+    hide(): void;
+    /**
+     * Clears the current inspection.
+     */
+    clear(): void;
+    /**
+     * Returns a copy of the current state.
+     */
+    getState(): InspectControlState;
+    /**
+     * Returns the currently inspected features.
+     */
+    getInspectedFeatures(): InspectedFeature[];
+    /**
+     * Returns the currently selected feature.
+     */
+    getSelectedFeature(): InspectedFeature | null;
+    /**
+     * Selects a feature by index.
+     */
+    selectFeature(index: number): void;
+    /**
+     * Selects the next feature.
+     */
+    nextFeature(): void;
+    /**
+     * Selects the previous feature.
+     */
+    previousFeature(): void;
+    /**
+     * Updates the control options.
+     */
+    update(options: Partial<InspectControlOptions>): void;
+    /**
+     * Registers an event handler.
+     */
+    on(event: InspectEvent, handler: InspectEventHandler): void;
+    /**
+     * Removes an event handler.
+     */
+    off(event: InspectEvent, handler: InspectEventHandler): void;
+    /**
+     * Emits an event to all registered handlers.
+     */
+    private _emit;
+    /**
+     * Creates the control container.
+     */
+    private _createContainer;
+    /**
+     * Updates the button's active state appearance.
+     */
+    private _updateButtonState;
+    /**
+     * Updates the cursor style when inspect mode is active.
+     */
+    private _updateCursor;
+    /**
+     * Sets up map click listener for inspect mode.
+     */
+    private _setupMapListeners;
+    /**
+     * Removes map click listener.
+     */
+    private _removeMapListeners;
+    /**
+     * Handles map click events to inspect features.
+     */
+    private _handleMapClick;
+    /**
+     * Queries features at a point.
+     */
+    private _queryFeatures;
+    /**
+     * Adds highlight layer for the selected feature.
+     */
+    private _addHighlight;
+    /**
+     * Determines if highlight can use the original source to avoid tile clipping.
+     */
+    private _getHighlightTarget;
+    /**
+     * Removes highlight layers.
+     */
+    private _removeHighlight;
+    /**
+     * Shows the popup with feature properties.
+     */
+    private _showPopup;
+    /**
+     * Hides the popup.
+     */
+    private _hidePopup;
+    /**
+     * Updates the popup content without recreating it.
+     */
+    private _updatePopupContent;
+    /**
+     * Attaches event listeners to popup navigation buttons.
+     */
+    private _attachPopupListeners;
+    /**
+     * Renders the popup HTML content.
+     */
+    private _renderPopupContent;
+    /**
+     * Formats geometry type for display.
+     */
+    private _formatGeometryType;
+    /**
+     * Formats a property value for display.
+     */
+    private _formatPropertyValue;
+    /**
+     * Escapes HTML special characters.
+     */
+    private _escapeHtml;
+    /**
+     * Checks zoom visibility and updates display state.
+     */
+    private _checkZoomVisibility;
+    /**
+     * Updates the display state based on visibility settings.
+     */
+    private _updateDisplayState;
+}
+//# sourceMappingURL=InspectControl.d.ts.map

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

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

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

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

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

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

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

@@ -0,0 +1,142 @@
+import { IControl, Map as MapLibreMap } from 'maplibre-gl';
+import { LegendOptions, LegendState, LegendItem, ComponentEvent, ComponentEventHandler } from './types';
+/**
+ * A categorical legend control for MapLibre GL maps.
+ *
+ * Displays discrete legend items with color swatches and labels.
+ *
+ * @example
+ * ```typescript
+ * const legend = new Legend({
+ *   title: 'Land Use',
+ *   items: [
+ *     { label: 'Residential', color: '#ff6b6b' },
+ *     { label: 'Commercial', color: '#4ecdc4' },
+ *     { label: 'Industrial', color: '#95a5a6' },
+ *   ],
+ * });
+ * map.addControl(legend, 'bottom-left');
+ * ```
+ */
+export declare class Legend implements IControl {
+    private _container?;
+    private _options;
+    private _state;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _zoomVisible;
+    /**
+     * Creates a new Legend instance.
+     *
+     * @param options - Configuration options for the legend.
+     */
+    constructor(options?: LegendOptions);
+    /**
+     * 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 legend.
+     */
+    show(): void;
+    /**
+     * Hides the legend.
+     */
+    hide(): void;
+    /**
+     * Expands the legend (if collapsible).
+     */
+    expand(): void;
+    /**
+     * Collapses the legend (if collapsible).
+     */
+    collapse(): void;
+    /**
+     * Toggles the collapsed state.
+     */
+    toggle(): void;
+    /**
+     * Updates the legend items.
+     *
+     * @param items - New legend items.
+     */
+    setItems(items: LegendItem[]): void;
+    /**
+     * Adds a legend item.
+     *
+     * @param item - Legend item to add.
+     */
+    addItem(item: LegendItem): void;
+    /**
+     * Removes a legend item by label.
+     *
+     * @param label - Label of the item to remove.
+     */
+    removeItem(label: string): void;
+    /**
+     * Updates legend options and re-renders.
+     *
+     * @param options - Partial options to update.
+     */
+    update(options: Partial<LegendOptions>): void;
+    /**
+     * Gets the current state.
+     *
+     * @returns The current legend state.
+     */
+    getState(): LegendState;
+    /**
+     * Registers an event handler.
+     *
+     * @param event - The event type to listen for.
+     * @param handler - The callback function.
+     */
+    on(event: ComponentEvent, handler: ComponentEventHandler<LegendState>): void;
+    /**
+     * Removes an event handler.
+     *
+     * @param event - The event type.
+     * @param handler - The callback function to remove.
+     */
+    off(event: ComponentEvent, handler: ComponentEventHandler<LegendState>): 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;
+    /**
+     * Creates a color swatch element.
+     *
+     * @param item - Legend item configuration.
+     * @returns The swatch element.
+     */
+    private _createSwatch;
+    /**
+     * Renders the legend content.
+     */
+    private _render;
+}
+//# sourceMappingURL=Legend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Legend.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/Legend.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,UAAU,EACV,cAAc,EACd,qBAAqB,EACtB,MAAM,SAAS,CAAC;AA0BjB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,MAAO,YAAW,QAAQ;IACrC,OAAO,CAAC,UAAU,CAAC,CAAc;IACjC,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,cAAc,CAGR;IACd,OAAO,CAAC,IAAI,CAAC,CAAc;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,YAAY,CAAiB;IAErC;;;;OAIG;gBACS,OAAO,CAAC,EAAE,aAAa;IASnC;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW;IAepC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAWhB;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;OAEG;IACH,QAAQ,IAAI,IAAI;IAQhB;;OAEG;IACH,MAAM,IAAI,IAAI;IAQd;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI;IAOnC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAO/B;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAS/B;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAU7C;;;;OAIG;IACH,QAAQ,IAAI,WAAW;IAIvB;;;;;OAKG;IACH,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,CAAC,WAAW,CAAC,GAAG,IAAI;IAO5E;;;;;OAKG;IACH,GAAG,CACD,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,qBAAqB,CAAC,WAAW,CAAC,GAC1C,IAAI;IAIP;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAQb;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAkErB;;OAEG;IACH,OAAO,CAAC,OAAO;CAwGhB"}

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

@@ -0,0 +1,69 @@
+import { IControl, Map as MapLibreMap, ControlPosition } from 'maplibre-gl';
+import { LegendGuiControlOptions, LegendGuiControlState, LegendGuiEvent, LegendGuiEventHandler } from './types';
+import { Legend } from './Legend';
+/**
+ * A GUI control for adding and configuring legends on the map.
+ *
+ * Provides a panel to set a title, add/remove items with color and label,
+ * and choose the legend position.
+ *
+ * @example
+ * ```typescript
+ * const legendGui = new LegendGuiControl({ collapsed: true });
+ * map.addControl(legendGui, 'top-right');
+ *
+ * legendGui.on('legendadd', (e) => {
+ *   console.log('Legend added:', e.state);
+ * });
+ * ```
+ */
+export declare class LegendGuiControl implements IControl {
+    private _container?;
+    private _button?;
+    private _panel?;
+    private _options;
+    private _state;
+    private _eventHandlers;
+    private _map?;
+    private _handleZoom?;
+    private _zoomVisible;
+    private _legend?;
+    private _titleInput?;
+    private _positionSelect?;
+    private _itemsContainer?;
+    private _dictTextarea?;
+    private _dictErrorEl?;
+    private _addBtn?;
+    private _removeBtn?;
+    constructor(options?: LegendGuiControlOptions);
+    onAdd(map: MapLibreMap): HTMLElement;
+    onRemove(): void;
+    getDefaultPosition(): ControlPosition;
+    on(event: LegendGuiEvent, handler: LegendGuiEventHandler): this;
+    off(event: LegendGuiEvent, handler: LegendGuiEventHandler): this;
+    private _emit;
+    expand(): void;
+    collapse(): void;
+    show(): this;
+    hide(): this;
+    getState(): LegendGuiControlState;
+    private _createContainer;
+    private _createPanel;
+    private _createField;
+    private _renderItems;
+    private _addItem;
+    private _importFromDict;
+    private _addLegend;
+    private _updateLegend;
+    private _removeLegend;
+    private _updateButtonStates;
+    private _togglePanel;
+    private _showPanel;
+    private _hidePanel;
+    private _setupZoomHandler;
+    /**
+     * Get the active Legend instance (if any).
+     */
+    getLegend(): Legend | undefined;
+}
+//# sourceMappingURL=LegendGuiControl.d.ts.map

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

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

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

@@ -0,0 +1,34 @@
+import { LegendReactProps } from './types';
+/**
+ * React wrapper component for Legend.
+ *
+ * @example
+ * ```tsx
+ * import { LegendReact } from 'maplibre-gl-components/react';
+ *
+ * function MyMap() {
+ *   const [map, setMap] = useState<Map | null>(null);
+ *
+ *   return (
+ *     <>
+ *       <div ref={mapContainer} />
+ *       {map && (
+ *         <LegendReact
+ *           map={map}
+ *           title="Land Use"
+ *           items={[
+ *             { label: 'Residential', color: '#ff6b6b' },
+ *             { label: 'Commercial', color: '#4ecdc4' },
+ *           ]}
+ *         />
+ *       )}
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @param props - Component props including map instance and legend options.
+ * @returns null - This component renders nothing directly.
+ */
+export declare function LegendReact({ map, onStateChange, position, ...options }: LegendReactProps): null;
+//# sourceMappingURL=LegendReact.d.ts.map

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

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