'use client'; /** * Lazy-loaded Map Components * * Heavy MapLibre GL (~800KB) is loaded only when components are rendered. * Use these for automatic code-splitting with Suspense fallback. * * For direct imports without lazy loading, use: * import { MapContainer } from '@djangocfg/ui-tools/map' */ import * as React from 'react'; import { createLazyComponent, MapLoadingFallback } from '../../../common'; import type { MapContainerProps } from './components'; // ============================================================================ // Lazy Components // ============================================================================ /** * LazyMapContainer - Lazy-loaded map container * * Automatically shows loading state while MapLibre GL loads (~800KB) */ export const LazyMapContainer = createLazyComponent( () => import('./components/MapContainer').then((mod) => ({ default: mod.MapContainer, })), { displayName: 'LazyMapContainer', fallback: , } ); /** * LazyMapView - Lazy-loaded map view (alias for MapContainer) */ export const LazyMapView = createLazyComponent>( () => import('./components/MapContainer').then((mod) => ({ default: mod.MapView, })), { displayName: 'LazyMapView', fallback: , } ); // ============================================================================ // Light primitives — direct re-exports // // MapMarker / MapPopup / MapCluster / MapSource / MapLayer / MapControls // etc. are thin wrappers around `react-map-gl/maplibre`. They don't import // `maplibre-gl` at module scope (only types, which are erased), so exporting // them synchronously here costs ~tens of KB at most — not the ~800KB of // MapLibre GL itself. // // The heavy library only loads when `LazyMapContainer` actually mounts, // because `MapContainer.tsx` (the only module that imports `maplibre-gl` // at runtime) is reached exclusively via the dynamic import above. // // This means consumers can write: // // import { LazyMapContainer, MapMarker, MapPopup } from '@djangocfg/ui-tools/map' // // …and still get correct code-splitting. // ============================================================================ export { MapMarker, MapPopup, MapCluster, MapSource, MapLayer, MapControls, CustomOverlay, MapLegend, LayerSwitcher, MeasureControl, DraggableMarkers, GeocoderInput, GeocoderControl, CompassChip, MarkerCard, MapMarkers, } from './components'; export type { DraggableMarkersProps, DraggablePoint } from './components'; export type { GeocoderInputProps, GeocoderControlProps } from './components'; export type { CompassChipProps } from './components'; // Marker info-cards — light wrappers (no maplibre at module scope), safe on // the synchronous surface. `MarkerCard` data type lives in `./cards`. export type { MarkerCardProps, MapMarkersProps, MarkerWithCard, MarkerCardAction, MarkerCardData, MarkerCardActionData, } from './components'; // Card-data shape under `MarkerCardInfo` (the `MarkerCard` value is the // component re-exported above). export type { MarkerCard as MarkerCardInfo } from './cards'; // Geocoder resolver — pure, key-free Photon (light; no maplibre runtime). export { photonResolve, cameraForResult } from './geocode'; export type { GeocodeResult, GeocodeKind, ResolveGeocode } from './geocode'; export { MapProvider, useMapContext, MapContext } from './context'; export type { MapProviderProps } from './context'; export type { MapContainerProps, GeolocateOptions, GeolocatePosition, MapMarkerProps, MapPopupProps, MapClusterProps, MapSourceProps, MapLayerProps, MapControlsProps, MeasureControlProps, } from './components'; export type { MapViewport, MapStyleKey, MarkerData, } from './types'; // Basemap styles (incl. free OpenFreeMap keys) + PMTiles protocol helper — // light, safe to load synchronously alongside the lazy container. export { MAP_STYLES, getMapStyle, MAP_STYLE_LABELS, KEY_FREE_STYLES, resolveBasemapOptions, TERRAIN_DEM, TERRAIN_DEM_URL, } from './styles'; export { addPMTilesProtocol, pmtilesSourceUrl } from './protocols/pmtiles'; // Hooks — pure React glue (maplibre is a TYPE-only import here, so these // add no runtime weight and are safe on the synchronous lazy surface). export { useMap, useMapControl, useMarkers, useMapEvents, useMapViewport, useMapLayers, useSpiderfy, useMapTouchMode, useMapScrollProtection, useMapImages, useMeasure, useTerrain, useCompass, useGeolocation, useControl, useDraggableMarkers, useGeocoder, useMarkerCard, type UseMarkerCardResult, type UseCompassResult, type UseGeocoderOptions, type UseGeocoderResult, type UseSpiderfyOptions, type UseSpiderfyResult, type MapImage, type UseMapImagesResult, type UseMeasureResult, type MeasureMode, type UseTerrainOptions, type GeolocationFix, type GeolocationStatus, type UseGeolocationOptions, type UseGeolocationResult, type UseDraggableMarkersOptions, type UseDraggableMarkersResult, type DraggableMarkerHandlers, } from './hooks'; // Layer factories — pure functions returning `LayerProps` (type-only deps). export { createClusterLayers, createPointLayer, createHeatmapLayer, createPolygonLayer, createPolygonOutlineLayer, createHighlightLayer, createLineLayer, createRouteLayers, createDashedLineLayer, createAnimatedLineLayer, createSymbolLayer, } from './layers'; // Geometry + spiderfy utils — pure, dependency-free helpers. export { calculateBounds, calculateCenter, calculateDistance, isPointInBounds, expandBounds, toGeoJSON, fromGeoJSON, createPoint, createPolygon, createLineString, createFeatureCollection, offsetOverlappingMarkers, getSpiderfyPositions, groupOverlappingMarkers, hasOverlappingMarkers, getOverlapStats, } from './utils';