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

package/dist/types/lib/hooks/useVectorDataset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVectorDataset.d.ts","sourceRoot":"","sources":["../../../../src/lib/hooks/useVectorDataset.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAU9E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC;;;0BAOR,OAAO;;;;0BAgBP,aAAa;+BAQR,MAAM;;sBAcf,MAAM,GAAG,IAAI;;;EA0BnD"}

package/dist/types/lib/hooks/useViewState.d.ts

@@ -0,0 +1,43 @@
+import { ViewStateControlState } from '../core/types';
+/**
+ * React hook for managing ViewStateControl state.
+ *
+ * @param initialState - Optional initial state.
+ * @returns State and state management functions.
+ *
+ * @example
+ * ```tsx
+ * const { state, expand, collapse, toggle, startBBoxDraw, clearBBox } = useViewState({
+ *   collapsed: false
+ * });
+ *
+ * return (
+ *   <>
+ *     <button onClick={toggle}>
+ *       {state.collapsed ? 'Show' : 'Hide'} View State
+ *     </button>
+ *     <ViewStateControlReact
+ *       map={map}
+ *       collapsed={state.collapsed}
+ *       onStateChange={setState}
+ *     />
+ *   </>
+ * );
+ * ```
+ */
+export declare function useViewState(initialState?: Partial<ViewStateControlState>): {
+    state: ViewStateControlState;
+    setState: import('react').Dispatch<import('react').SetStateAction<ViewStateControlState>>;
+    setVisible: (visible: boolean) => void;
+    setCollapsed: (collapsed: boolean) => void;
+    expand: () => void;
+    collapse: () => void;
+    toggle: () => void;
+    setDrawingBBox: (drawingBBox: boolean) => void;
+    setDrawnBBox: (drawnBBox: [number, number, number, number] | null) => void;
+    clearBBox: () => void;
+    show: () => void;
+    hide: () => void;
+    reset: () => void;
+};
+//# sourceMappingURL=useViewState.d.ts.map

package/dist/types/lib/hooks/useViewState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useViewState.d.ts","sourceRoot":"","sources":["../../../../src/lib/hooks/useViewState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAc3D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;;;0BAM/B,OAAO;8BAIH,OAAO;;;;kCAgBH,OAAO;8BAK1C,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;;;;;EAqCtD"}

package/dist/types/lib/utils/color.d.ts

@@ -0,0 +1,47 @@
+import { ColorStop } from '../core/types';
+/**
+ * Converts a hex color to RGB values.
+ *
+ * @param hex - The hex color string (with or without #).
+ * @returns Object with r, g, b values (0-255).
+ */
+export declare function hexToRgb(hex: string): {
+    r: number;
+    g: number;
+    b: number;
+} | null;
+/**
+ * Converts RGB values to a hex color string.
+ *
+ * @param r - Red value (0-255).
+ * @param g - Green value (0-255).
+ * @param b - Blue value (0-255).
+ * @returns Hex color string with #.
+ */
+export declare function rgbToHex(r: number, g: number, b: number): string;
+/**
+ * Interpolates between two colors.
+ *
+ * @param color1 - First hex color.
+ * @param color2 - Second hex color.
+ * @param factor - Interpolation factor (0-1).
+ * @returns Interpolated hex color.
+ */
+export declare function interpolateColor(color1: string, color2: string, factor: number): string;
+/**
+ * Gets a color from a colormap at a specific position.
+ *
+ * @param colorStops - Array of color stops.
+ * @param position - Position (0-1) to sample.
+ * @returns The interpolated color at the position.
+ */
+export declare function getColorAtPosition(colorStops: ColorStop[], position: number): string;
+/**
+ * Generates CSS gradient string from color stops.
+ *
+ * @param colorStops - Array of color stops.
+ * @param direction - CSS gradient direction.
+ * @returns CSS linear-gradient string.
+ */
+export declare function generateGradientCSS(colorStops: ColorStop[], direction?: string): string;
+//# sourceMappingURL=color.d.ts.map

package/dist/types/lib/utils/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/color.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,GACV;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAS5C;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,MAAM,CAaR;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,SAAS,EAAE,EACvB,QAAQ,EAAE,MAAM,GACf,MAAM,CAyBR;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,SAAS,EAAE,EACvB,SAAS,GAAE,MAAmB,GAC7B,MAAM,CAKR"}

package/dist/types/lib/utils/fileHelpers.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Supported vector file formats.
+ *
+ * DuckDB's spatial extension uses GDAL under the hood, enabling support
+ * for many common geospatial formats via ST_Read().
+ */
+export type VectorFormat = "geojson" | "shapefile" | "geopackage" | "geoparquet" | "kml" | "kmz" | "gpx" | "flatgeobuf" | "gml" | "topojson" | "csv" | "xlsx" | "dxf" | "unknown";
+/**
+ * File extensions for GeoJSON files.
+ */
+export declare const GEOJSON_EXTENSIONS: string[];
+/**
+ * File extensions for Shapefile files.
+ * Includes .zip for zipped shapefiles (most common distribution).
+ */
+export declare const SHAPEFILE_EXTENSIONS: string[];
+/**
+ * File extensions for GeoPackage files.
+ */
+export declare const GEOPACKAGE_EXTENSIONS: string[];
+/**
+ * File extensions for GeoParquet files.
+ */
+export declare const GEOPARQUET_EXTENSIONS: string[];
+/**
+ * File extensions for KML (Keyhole Markup Language) files.
+ * Used by Google Earth.
+ */
+export declare const KML_EXTENSIONS: string[];
+/**
+ * File extensions for KMZ (compressed KML) files.
+ * KMZ is a zipped KML file used by Google Earth.
+ */
+export declare const KMZ_EXTENSIONS: string[];
+/**
+ * File extensions for GPX (GPS Exchange Format) files.
+ * Common format for GPS tracks, waypoints, and routes.
+ */
+export declare const GPX_EXTENSIONS: string[];
+/**
+ * File extensions for FlatGeobuf files.
+ * A performant binary encoding for geographic data.
+ */
+export declare const FLATGEOBUF_EXTENSIONS: string[];
+/**
+ * File extensions for GML (Geography Markup Language) files.
+ * OGC standard XML-based format.
+ */
+export declare const GML_EXTENSIONS: string[];
+/**
+ * File extensions for TopoJSON files.
+ * An extension of GeoJSON that encodes topology.
+ */
+export declare const TOPOJSON_EXTENSIONS: string[];
+/**
+ * File extensions for CSV files with geometry.
+ * Can contain WKT geometry or lat/lon columns.
+ */
+export declare const CSV_EXTENSIONS: string[];
+/**
+ * File extensions for Excel files with geometry.
+ * Can contain WKT geometry or lat/lon columns.
+ */
+export declare const XLSX_EXTENSIONS: string[];
+/**
+ * File extensions for DXF (AutoCAD Drawing Exchange Format) files.
+ */
+export declare const DXF_EXTENSIONS: string[];
+/**
+ * Extensions processed via shpjs (Shapefile library).
+ */
+export declare const SHPJS_EXTENSIONS: string[];
+/**
+ * Extensions processed via DuckDB spatial (GDAL-powered).
+ */
+export declare const DUCKDB_EXTENSIONS: string[];
+/**
+ * All supported extensions for advanced formats (require DuckDB or shpjs).
+ */
+export declare const ADVANCED_EXTENSIONS: string[];
+/**
+ * All supported vector file extensions.
+ */
+export declare const ALL_EXTENSIONS: string[];
+/**
+ * Detects the vector format from a filename.
+ *
+ * @param filename - The filename to check.
+ * @returns The detected vector format.
+ *
+ * @example
+ * ```typescript
+ * detectFormat('data.geojson'); // 'geojson'
+ * detectFormat('counties.shp'); // 'shapefile'
+ * detectFormat('data.gpkg'); // 'geopackage'
+ * detectFormat('track.gpx'); // 'gpx'
+ * detectFormat('places.kml'); // 'kml'
+ * detectFormat('data.zip'); // 'shapefile'
+ * detectFormat('data.txt'); // 'unknown'
+ * ```
+ */
+export declare function detectFormat(filename: string): VectorFormat;
+/**
+ * Checks if a format requires DuckDB for processing.
+ * Note: Shapefiles use shpjs, not DuckDB.
+ *
+ * @param format - The vector format to check.
+ * @returns True if the format requires DuckDB.
+ *
+ * @example
+ * ```typescript
+ * requiresDuckDB('geojson'); // false
+ * requiresDuckDB('shapefile'); // false (uses shpjs)
+ * requiresDuckDB('geopackage'); // true
+ * requiresDuckDB('geoparquet'); // true
+ * requiresDuckDB('kml'); // true
+ * requiresDuckDB('gpx'); // true
+ * ```
+ */
+export declare function requiresDuckDB(format: VectorFormat): boolean;
+/**
+ * Checks if a format requires a special converter (not native GeoJSON).
+ *
+ * @param format - The vector format to check.
+ * @returns True if the format requires conversion.
+ */
+export declare function requiresConversion(format: VectorFormat): boolean;
+/**
+ * Gets the file extension from a filename (lowercase, with leading dot).
+ *
+ * @param filename - The filename to extract extension from.
+ * @returns The file extension (e.g., '.geojson') or empty string.
+ *
+ * @example
+ * ```typescript
+ * getFileExtension('data.GeoJSON'); // '.geojson'
+ * getFileExtension('file.tar.gz'); // '.gz'
+ * getFileExtension('noextension'); // ''
+ * ```
+ */
+export declare function getFileExtension(filename: string): string;
+/**
+ * Reads a File object as an ArrayBuffer.
+ *
+ * @param file - The file to read.
+ * @returns Promise resolving to the file contents as ArrayBuffer.
+ *
+ * @example
+ * ```typescript
+ * const input = document.querySelector('input[type="file"]');
+ * const file = input.files[0];
+ * const buffer = await readFileAsBuffer(file);
+ * ```
+ */
+export declare function readFileAsBuffer(file: File): Promise<ArrayBuffer>;
+/**
+ * Gets the list of accepted file extensions based on options.
+ *
+ * @param enableAdvanced - Whether to include advanced format extensions.
+ * @returns Array of accepted file extensions.
+ *
+ * @example
+ * ```typescript
+ * getAcceptedExtensions(false); // ['.geojson', '.json']
+ * getAcceptedExtensions(true); // ['.geojson', '.json', '.shp', '.zip', '.gpkg', '.kml', ...]
+ * ```
+ */
+export declare function getAcceptedExtensions(enableAdvanced: boolean): string[];
+/**
+ * Checks if a file extension is valid for the given options.
+ *
+ * @param filename - The filename to check.
+ * @param enableAdvanced - Whether advanced formats are enabled.
+ * @returns True if the extension is accepted.
+ *
+ * @example
+ * ```typescript
+ * isValidExtension('data.geojson', false); // true
+ * isValidExtension('data.gpkg', false); // false
+ * isValidExtension('data.gpkg', true); // true
+ * isValidExtension('track.gpx', true); // true
+ * ```
+ */
+export declare function isValidExtension(filename: string, enableAdvanced: boolean): boolean;
+/**
+ * Gets a human-readable format name for display.
+ *
+ * @param format - The vector format.
+ * @returns Human-readable format name.
+ *
+ * @example
+ * ```typescript
+ * getFormatDisplayName('geojson'); // 'GeoJSON'
+ * getFormatDisplayName('shapefile'); // 'Shapefile'
+ * getFormatDisplayName('kml'); // 'KML'
+ * getFormatDisplayName('gpx'); // 'GPX'
+ * ```
+ */
+export declare function getFormatDisplayName(format: VectorFormat): string;
+/**
+ * Gets a description of the format for tooltips/help text.
+ *
+ * @param format - The vector format.
+ * @returns Description of the format.
+ */
+export declare function getFormatDescription(format: VectorFormat): string;
+//# sourceMappingURL=fileHelpers.d.ts.map

package/dist/types/lib/utils/fileHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileHelpers.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/fileHelpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,KAAK,GACL,KAAK,GACL,KAAK,GACL,YAAY,GACZ,KAAK,GACL,UAAU,GACV,KAAK,GACL,MAAM,GACN,KAAK,GACL,SAAS,CAAC;AAEd;;GAEG;AACH,eAAO,MAAM,kBAAkB,UAAwB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,UAAmB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,qBAAqB,UAAY,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,qBAAqB,UAA8B,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,cAAc,UAAW,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,cAAc,UAAW,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,cAAc,UAAW,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,qBAAqB,UAAW,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,cAAc,UAAW,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,UAAgB,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,cAAc,UAAW,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,eAAe,UAAoB,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,cAAc,UAAW,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,gBAAgB,UAA4B,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,iBAAiB,UAY7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,UAA8C,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,cAAc,UAAkD,CAAC;AAE9E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAwD3D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAc5D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAEhE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAEjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,EAAE,CAKvE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,OAAO,GACtB,OAAO,CAIT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA+BjE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA+BjE"}

package/dist/types/lib/utils/helpers.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Clamps a value between min and max.
+ *
+ * @param value - The value to clamp.
+ * @param min - The minimum value.
+ * @param max - The maximum value.
+ * @returns The clamped value.
+ */
+export declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Formats a numeric value based on the range.
+ *
+ * @param value - The value to format.
+ * @param range - The total range (max - min).
+ * @returns Formatted string.
+ */
+export declare function formatNumericValue(value: number, range: number): string;
+/**
+ * Generates a unique ID with optional prefix.
+ *
+ * @param prefix - Optional prefix for the ID.
+ * @returns A unique ID string.
+ */
+export declare function generateId(prefix?: string): string;
+/**
+ * Debounces a function call.
+ *
+ * @param fn - The function to debounce.
+ * @param delay - The delay in milliseconds.
+ * @returns A debounced function.
+ */
+export declare function debounce<T extends (...args: unknown[]) => void>(fn: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * Throttles a function call.
+ *
+ * @param fn - The function to throttle.
+ * @param limit - The minimum time between calls in milliseconds.
+ * @returns A throttled function.
+ */
+export declare function throttle<T extends (...args: unknown[]) => void>(fn: T, limit: number): (...args: Parameters<T>) => void;
+/**
+ * Joins class names, filtering out falsy values.
+ *
+ * @param classes - Class names to join.
+ * @returns Joined class string.
+ */
+export declare function classNames(...classes: (string | undefined | null | false)[]): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/types/lib/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUvE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,SAAS,GAAG,MAAM,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,EAC7D,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAMlC;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,EAC7D,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CASlC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,GAAG,OAAO,EAAE,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,KAAK,CAAC,EAAE,GAChD,MAAM,CAER"}

package/dist/types/lib/utils/index.d.ts

@@ -0,0 +1,4 @@
+export { clamp, formatNumericValue, generateId, debounce, throttle, classNames, } from './helpers';
+export { hexToRgb, rgbToHex, interpolateColor, getColorAtPosition, generateGradientCSS, } from './color';
+export { XYZSERVICES_URL, buildTileUrl, generateThumbnailUrl, parseProviders, fetchProviders, groupBasemaps, filterBasemaps, } from './providers';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/lib/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,kBAAkB,EAClB,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/types/lib/utils/providers.d.ts

@@ -0,0 +1,46 @@
+import { BasemapItem } from '../core/types';
+/**
+ * Default URL for xyzservices providers.json.
+ */
+export declare const XYZSERVICES_URL = "https://raw.githubusercontent.com/geopandas/xyzservices/main/xyzservices/data/providers.json";
+/**
+ * Options for parsing providers.
+ */
+interface ParseOptions {
+    filterGroups?: string[];
+    excludeGroups?: string[];
+    excludeBroken?: boolean;
+}
+/**
+ * Build the tile URL from an XYZ provider.
+ * Replaces placeholders like {s}, {r}, {variant}, {ext}.
+ */
+export declare function buildTileUrl(basemap: BasemapItem): string;
+/**
+ * Generate a thumbnail URL from a basemap's tile URL.
+ * Uses zoom level 3 for a reasonable world view.
+ */
+export declare function generateThumbnailUrl(basemap: BasemapItem): string;
+/**
+ * Parse xyzservices providers.json data into BasemapItem array.
+ */
+export declare function parseProviders(data: Record<string, unknown>, options?: ParseOptions): BasemapItem[];
+/**
+ * Fetch and parse providers from xyzservices URL.
+ */
+export declare function fetchProviders(url?: string, options?: ParseOptions): Promise<BasemapItem[]>;
+/**
+ * Group basemaps by their group property.
+ */
+export declare function groupBasemaps(basemaps: BasemapItem[]): Map<string, BasemapItem[]>;
+/**
+ * Filter basemaps by search text.
+ */
+export declare function filterBasemaps(basemaps: BasemapItem[], searchText: string): BasemapItem[];
+/**
+ * Google basemap definitions.
+ * These are not included in xyzservices but are commonly requested.
+ */
+export declare const GOOGLE_BASEMAPS: BasemapItem[];
+export {};
+//# sourceMappingURL=providers.d.ts.map

package/dist/types/lib/utils/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,eAAe,iGACoE,CAAC;AA2BjG;;GAEG;AACH,UAAU,YAAY;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAcD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CA4BzD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAejE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE,YAAiB,GACzB,WAAW,EAAE,CAmEf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,GAAG,GAAE,MAAwB,EAC7B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,EAAE,CAAC,CAOxB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,EAAE,GACtB,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAW5B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,WAAW,EAAE,EACvB,UAAU,EAAE,MAAM,GACjB,WAAW,EAAE,CAYf;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,WAAW,EAiCxC,CAAC"}

package/dist/types/react.d.ts

@@ -0,0 +1,15 @@
+export { ColorbarReact } from './lib/core/ColorbarReact';
+export { LegendReact } from './lib/core/LegendReact';
+export { HtmlControlReact } from './lib/core/HtmlControlReact';
+export { BasemapReact } from './lib/core/BasemapReact';
+export { TerrainReact } from './lib/core/TerrainReact';
+export { SearchControlReact } from './lib/core/SearchControlReact';
+export { VectorDatasetReact } from './lib/core/VectorDatasetReact';
+export { InspectControlReact } from './lib/core/InspectControlReact';
+export { ViewStateControlReact } from './lib/core/ViewStateControlReact';
+export { ControlGridReact } from './lib/core/ControlGridReact';
+export { CogLayerReact } from './lib/core/CogLayerReact';
+export { MinimapControlReact } from './lib/core/MinimapControlReact';
+export { useColorbar, useLegend, useHtmlControl, useBasemap, useTerrain, useSearchControl, useVectorDataset, useInspectControl, useViewState, useControlGrid, useCogLayer, useMinimapControl, } from './lib/hooks';
+export type { ColorbarOptions, ColorbarState, ColorbarReactProps, LegendOptions, LegendState, LegendReactProps, LegendItem, HtmlControlOptions, HtmlControlState, HtmlControlReactProps, BasemapControlOptions, BasemapControlState, BasemapControlReactProps, BasemapItem, BasemapDisplayMode, BasemapEvent, TerrainControlOptions, TerrainControlState, TerrainControlReactProps, TerrainEncoding, TerrainEvent, TerrainEventHandler, SearchControlOptions, SearchControlState, SearchControlReactProps, SearchResult, SearchEvent, SearchEventHandler, VectorDatasetControlOptions, VectorDatasetControlState, VectorDatasetControlReactProps, LoadedDataset, VectorLayerStyle, VectorDatasetEvent, VectorDatasetEventHandler, InspectControlOptions, InspectControlState, InspectControlReactProps, InspectedFeature, InspectHighlightStyle, InspectEvent, InspectEventHandler, ViewStateControlOptions, ViewStateControlState, ViewStateControlReactProps, ViewStateEvent, ViewStateEventHandler, ControlGridOptions, ControlGridState, ControlGridReactProps, ControlGridEvent, ControlGridEventHandler, CogLayerControlOptions, CogLayerControlState, CogLayerControlReactProps, CogLayerEvent, CogLayerEventHandler, ColormapName, ColorStop, ControlPosition, ColorbarOrientation, ComponentEvent, ComponentEventHandler, MinimapControlOptions, MinimapControlState, MinimapControlReactProps, MinimapEvent, MinimapEventHandler, } from './lib/core/types';
+//# sourceMappingURL=react.d.ts.map

package/dist/types/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/react.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE,OAAO,EACL,WAAW,EACX,SAAS,EACT,cAAc,EACd,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,2BAA2B,EAC3B,yBAAyB,EACzB,8BAA8B,EAC9B,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,YAAY,EACZ,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/webimage-CBRffWZD.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./geotiff-De1w1lBy.cjs");class i extends r.BaseDecoder{constructor(){if(super(),typeof createImageBitmap>"u")throw new Error("Cannot decode WebImage as `createImageBitmap` is not available");if(typeof document>"u"&&typeof OffscreenCanvas>"u")throw new Error("Cannot decode WebImage as neither `document` nor `OffscreenCanvas` is not available")}async decode(c,n){const o=new Blob([n]),e=await createImageBitmap(o);let t;typeof document<"u"?(t=document.createElement("canvas"),t.width=e.width,t.height=e.height):t=new OffscreenCanvas(e.width,e.height);const a=t.getContext("2d");return a.drawImage(e,0,0),a.getImageData(0,0,e.width,e.height).data.buffer}}exports.default=i;

package/dist/webimage-ibSPOLHJ.js

@@ -0,0 +1,19 @@
+import { B as r } from "./geotiff-o_Fq1Na4.js";
+class s extends r {
+  constructor() {
+    if (super(), typeof createImageBitmap > "u")
+      throw new Error("Cannot decode WebImage as `createImageBitmap` is not available");
+    if (typeof document > "u" && typeof OffscreenCanvas > "u")
+      throw new Error("Cannot decode WebImage as neither `document` nor `OffscreenCanvas` is not available");
+  }
+  async decode(i, n) {
+    const o = new Blob([n]), e = await createImageBitmap(o);
+    let t;
+    typeof document < "u" ? (t = document.createElement("canvas"), t.width = e.width, t.height = e.height) : t = new OffscreenCanvas(e.width, e.height);
+    const a = t.getContext("2d");
+    return a.drawImage(e, 0, 0), a.getImageData(0, 0, e.width, e.height).data.buffer;
+  }
+}
+export {
+  s as default
+};

package/package.json

@@ -0,0 +1,137 @@
+{
+  "name": "@gisfun/maplibre-gl-components",
+  "version": "0.15.0-alpha.0",
+  "description": "Legend, colorbar, and HTML control components for MapLibre GL JS maps",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./react": {
+      "import": {
+        "types": "./dist/types/react.d.ts",
+        "default": "./dist/react.mjs"
+      },
+      "require": {
+        "types": "./dist/types/react.d.ts",
+        "default": "./dist/react.cjs"
+      }
+    },
+    "./style.css": "./dist/maplibre-gl-components.css"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": [
+    "*.css"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -p tsconfig.build.json && vite build",
+    "build:examples": "vite build --config vite.examples.config.ts",
+    "preview": "vite preview",
+    "test": "vitest --run",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0",
+    "format": "prettier --write \"src/**/*.{ts,tsx,css}\"",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "maplibre",
+    "maplibre-gl",
+    "legend",
+    "colorbar",
+    "colormap",
+    "visualization",
+    "map",
+    "plugin",
+    "control",
+    "react",
+    "typescript"
+  ],
+  "author": "Qiusheng Wu",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/opengeos/maplibre-gl-components.git"
+  },
+  "homepage": "https://github.com/opengeos/maplibre-gl-components",
+  "bugs": {
+    "url": "https://github.com/opengeos/maplibre-gl-components/issues"
+  },
+  "peerDependencies": {
+    "@deck.gl/core": "^9.2.6",
+    "@deck.gl/mapbox": "^9.2.6",
+    "jspdf": ">=2.5.0",
+    "maplibre-gl": ">=5.16.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "three": "^0.178.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "jspdf": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@duckdb/duckdb-wasm": "^1.32.0",
+    "@geoman-io/maplibre-geoman-free": "^0.6.2",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/node": "^25.2.3",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@typescript-eslint/eslint-plugin": "^8.55.0",
+    "@typescript-eslint/parser": "^8.55.0",
+    "@vitejs/plugin-react": "^5.1.4",
+    "@vitest/ui": "^4.0.18",
+    "eslint": "^9.0.0",
+    "jsdom": "^28.0.0",
+    "jspdf": "^4.1.0",
+    "maplibre-gl": "5.17.0",
+    "prettier": "^3.8.1",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "shpjs": "^6.2.0",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vite-plugin-dts": "^4.5.4",
+    "vite-plugin-node-polyfills": "^0.25.0",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "@carbonplan/zarr-layer": "^0.3.1",
+    "@developmentseed/deck.gl-geotiff": "^0.2.0",
+    "@dvt3d/maplibre-three-plugin": "^1.3.0",
+    "flatgeobuf": "^4.4.0",
+    "geotiff-geokeys-to-proj4": "^2024.4.13",
+    "maplibre-gl-geo-editor": "^0.7.3",
+    "maplibre-gl-layer-control": "^0.13.0",
+    "maplibre-gl-lidar": "^0.11.1",
+    "maplibre-gl-planetary-computer": "^0.2.2",
+    "maplibre-gl-splat": "^0.2.2",
+    "maplibre-gl-streetview": "^0.3.1",
+    "maplibre-gl-swipe": "^0.6.0",
+    "maplibre-gl-usgs-lidar": "^0.7.2",
+    "pmtiles": "^4.4.0"
+  }
+}