react-bkoi-gl 2.1.0 → 2.2.0

package/dist/index.d.cts

@@ -190,6 +190,9 @@ type MaplibreProps = Partial<ViewState> & MapCallbacks & {
     interactiveLayerIds?: string[];
     /** CSS cursor */
     cursor?: string;
+    /** Called with non-fatal warnings (e.g. transient errors before the style
+     * has finished loading). When omitted, warnings fall back to `console.warn`. */
+    onWarning?: (e: ErrorEvent) => void;
 };
 
 /** These methods may break the react binding if called directly */
@@ -221,6 +224,9 @@ type GlobalSettings = {
 type MapContextValue = {
     mapLib: MapLib;
     map: MapRef;
+    /** Consumer-supplied warning handler, propagated to child components so they
+     * can surface non-fatal warnings without touching console directly. */
+    onWarning?: (e: ErrorEvent) => void;
 };
 type MapInitOptions = Omit<MapOptions, 'style' | 'container' | 'bounds' | 'fitBoundsOptions' | 'center'>;
 type MapProps = MapInitOptions & MaplibreProps & GlobalSettings & {
@@ -231,7 +237,23 @@ type MapProps = MapInitOptions & MaplibreProps & GlobalSettings & {
     /** Map container CSS style */
     style?: CSSProperties;
     children?: React$1.ReactNode;
+    /** Whether to render the Barikoi logo control.
+     * @default true */
+    showBarikoiLogo?: boolean;
+    /** Whether to render the map attribution control.
+     * @default true
+     * @remarks Attribution is required by the OpenStreetMap and MapLibre
+     * license terms; keep this enabled unless you provide attribution elsewhere. */
+    showAttribution?: boolean;
 } & React$1.RefAttributes<MapRef>;
+/**
+ * Interactive Map component using MapLibre GL.
+ *
+ * @remarks
+ * For keyboard navigation and accessibility, the `keyboard` prop must be set to `true` (which is default).
+ * If explicitly disabled (e.g. `keyboard={false}`), keyboard access (such as panning/zooming via arrow keys)
+ * will be unavailable to screen reader and keyboard-only users.
+ */
 declare const Map: React$1.FC<MapProps>;
 
 type MarkerProps = MarkerOptions & {
@@ -373,7 +395,7 @@ type SourceProps = SourceSpecification & {
     /** Child Layer components that will use this source. */
     children?: any;
 };
-declare const Source: React$1.MemoExoticComponent<React$1.ForwardRefExoticComponent<SourceProps & React$1.RefAttributes<Source$1>>>;
+declare const Source: React$1.NamedExoticComponent<SourceProps & React$1.RefAttributes<Source$1>>;
 
 /**
  * @fileoverview CanvasSource component for adding canvas-based data sources to a MapLibre GL map.
@@ -849,6 +871,10 @@ declare class Minimap implements IControl {
     private toggleButtonCleanup?;
     private isMinimized;
     private resizeHandler?;
+    private resizeTimeout?;
+    private transitionTimeout?;
+    private toggleButtonStyleEl?;
+    private liveRegion?;
     constructor(options?: MinimapControlOptions);
     onAdd(parentMap: MapLibreMap): HTMLElement;
     onRemove(): void;
@@ -867,4 +893,14 @@ declare class Minimap implements IControl {
 declare function _MinimapControl(props: MinimapControlProps): any;
 declare const MinimapControl: React$1.MemoExoticComponent<typeof _MinimapControl>;
 
-export { AttributionControl, type AttributionControlProps, type CanvasCoordinates, CanvasSource, type CanvasSourceProps, DrawControl, type DrawControlOptions, type DrawControlProps, type ErrorEvent, FullscreenControl, type FullscreenControlProps, GeolocateControl, type GeolocateControlProps, type GeolocateErrorEvent, type GeolocateEvent, type GeolocateResultEvent, GlobeControl, type GlobeControlOptions, type GlobeControlProps, type ImmutableLike, Layer, type LayerProps, LogoControl, type LogoControlProps, Map, type MapCallbacks, type MapControl, type MapInteractions, type MapLib, type MapMouseEvent, type MapProps, MapProvider, type MapRef, Marker, type MarkerDragEvent, type MarkerEvent, type MarkerProps, Minimap, MinimapControl, type MinimapControlOptions, type MinimapControlProps, type MinimapInteractions, NavigationControl, type NavigationControlProps, type ParentRectConfig, Popup, type PopupEvent, type PopupProps, ScaleControl, type ScaleControlProps, Source, type SourceProps, TerrainControl, type TerrainControlProps, type ToggleButtonConfig, type ViewState, type ViewStateChangeEvent, Map as default, useControl, useMap };
+interface Logger {
+    warn: (message: any, ...args: any[]) => void;
+    error: (message: any, ...args: any[]) => void;
+}
+declare const logger: {
+    warn(message: any, ...args: any[]): void;
+    error(message: any, ...args: any[]): void;
+};
+declare function setLogger(customLogger: Partial<Logger>): void;
+
+export { AttributionControl, type AttributionControlProps, type CanvasCoordinates, CanvasSource, type CanvasSourceProps, DrawControl, type DrawControlOptions, type DrawControlProps, type ErrorEvent, FullscreenControl, type FullscreenControlProps, GeolocateControl, type GeolocateControlProps, type GeolocateErrorEvent, type GeolocateEvent, type GeolocateResultEvent, GlobeControl, type GlobeControlOptions, type GlobeControlProps, type ImmutableLike, Layer, type LayerProps, type Logger, LogoControl, type LogoControlProps, Map, type MapCallbacks, type MapControl, type MapInteractions, type MapLib, type MapMouseEvent, type MapProps, MapProvider, type MapRef, Marker, type MarkerDragEvent, type MarkerEvent, type MarkerProps, Minimap, MinimapControl, type MinimapControlOptions, type MinimapControlProps, type MinimapInteractions, NavigationControl, type NavigationControlProps, type ParentRectConfig, Popup, type PopupEvent, type PopupProps, ScaleControl, type ScaleControlProps, Source, type SourceProps, TerrainControl, type TerrainControlProps, type ToggleButtonConfig, type ViewState, type ViewStateChangeEvent, Map as default, logger, setLogger, useControl, useMap };

package/dist/index.d.ts

@@ -190,6 +190,9 @@ type MaplibreProps = Partial<ViewState> & MapCallbacks & {
     interactiveLayerIds?: string[];
     /** CSS cursor */
     cursor?: string;
+    /** Called with non-fatal warnings (e.g. transient errors before the style
+     * has finished loading). When omitted, warnings fall back to `console.warn`. */
+    onWarning?: (e: ErrorEvent) => void;
 };
 
 /** These methods may break the react binding if called directly */
@@ -221,6 +224,9 @@ type GlobalSettings = {
 type MapContextValue = {
     mapLib: MapLib;
     map: MapRef;
+    /** Consumer-supplied warning handler, propagated to child components so they
+     * can surface non-fatal warnings without touching console directly. */
+    onWarning?: (e: ErrorEvent) => void;
 };
 type MapInitOptions = Omit<MapOptions, 'style' | 'container' | 'bounds' | 'fitBoundsOptions' | 'center'>;
 type MapProps = MapInitOptions & MaplibreProps & GlobalSettings & {
@@ -231,7 +237,23 @@ type MapProps = MapInitOptions & MaplibreProps & GlobalSettings & {
     /** Map container CSS style */
     style?: CSSProperties;
     children?: React$1.ReactNode;
+    /** Whether to render the Barikoi logo control.
+     * @default true */
+    showBarikoiLogo?: boolean;
+    /** Whether to render the map attribution control.
+     * @default true
+     * @remarks Attribution is required by the OpenStreetMap and MapLibre
+     * license terms; keep this enabled unless you provide attribution elsewhere. */
+    showAttribution?: boolean;
 } & React$1.RefAttributes<MapRef>;
+/**
+ * Interactive Map component using MapLibre GL.
+ *
+ * @remarks
+ * For keyboard navigation and accessibility, the `keyboard` prop must be set to `true` (which is default).
+ * If explicitly disabled (e.g. `keyboard={false}`), keyboard access (such as panning/zooming via arrow keys)
+ * will be unavailable to screen reader and keyboard-only users.
+ */
 declare const Map: React$1.FC<MapProps>;
 
 type MarkerProps = MarkerOptions & {
@@ -373,7 +395,7 @@ type SourceProps = SourceSpecification & {
     /** Child Layer components that will use this source. */
     children?: any;
 };
-declare const Source: React$1.MemoExoticComponent<React$1.ForwardRefExoticComponent<SourceProps & React$1.RefAttributes<Source$1>>>;
+declare const Source: React$1.NamedExoticComponent<SourceProps & React$1.RefAttributes<Source$1>>;
 
 /**
  * @fileoverview CanvasSource component for adding canvas-based data sources to a MapLibre GL map.
@@ -849,6 +871,10 @@ declare class Minimap implements IControl {
     private toggleButtonCleanup?;
     private isMinimized;
     private resizeHandler?;
+    private resizeTimeout?;
+    private transitionTimeout?;
+    private toggleButtonStyleEl?;
+    private liveRegion?;
     constructor(options?: MinimapControlOptions);
     onAdd(parentMap: MapLibreMap): HTMLElement;
     onRemove(): void;
@@ -867,4 +893,14 @@ declare class Minimap implements IControl {
 declare function _MinimapControl(props: MinimapControlProps): any;
 declare const MinimapControl: React$1.MemoExoticComponent<typeof _MinimapControl>;
 
-export { AttributionControl, type AttributionControlProps, type CanvasCoordinates, CanvasSource, type CanvasSourceProps, DrawControl, type DrawControlOptions, type DrawControlProps, type ErrorEvent, FullscreenControl, type FullscreenControlProps, GeolocateControl, type GeolocateControlProps, type GeolocateErrorEvent, type GeolocateEvent, type GeolocateResultEvent, GlobeControl, type GlobeControlOptions, type GlobeControlProps, type ImmutableLike, Layer, type LayerProps, LogoControl, type LogoControlProps, Map, type MapCallbacks, type MapControl, type MapInteractions, type MapLib, type MapMouseEvent, type MapProps, MapProvider, type MapRef, Marker, type MarkerDragEvent, type MarkerEvent, type MarkerProps, Minimap, MinimapControl, type MinimapControlOptions, type MinimapControlProps, type MinimapInteractions, NavigationControl, type NavigationControlProps, type ParentRectConfig, Popup, type PopupEvent, type PopupProps, ScaleControl, type ScaleControlProps, Source, type SourceProps, TerrainControl, type TerrainControlProps, type ToggleButtonConfig, type ViewState, type ViewStateChangeEvent, Map as default, useControl, useMap };
+interface Logger {
+    warn: (message: any, ...args: any[]) => void;
+    error: (message: any, ...args: any[]) => void;
+}
+declare const logger: {
+    warn(message: any, ...args: any[]): void;
+    error(message: any, ...args: any[]): void;
+};
+declare function setLogger(customLogger: Partial<Logger>): void;
+
+export { AttributionControl, type AttributionControlProps, type CanvasCoordinates, CanvasSource, type CanvasSourceProps, DrawControl, type DrawControlOptions, type DrawControlProps, type ErrorEvent, FullscreenControl, type FullscreenControlProps, GeolocateControl, type GeolocateControlProps, type GeolocateErrorEvent, type GeolocateEvent, type GeolocateResultEvent, GlobeControl, type GlobeControlOptions, type GlobeControlProps, type ImmutableLike, Layer, type LayerProps, type Logger, LogoControl, type LogoControlProps, Map, type MapCallbacks, type MapControl, type MapInteractions, type MapLib, type MapMouseEvent, type MapProps, MapProvider, type MapRef, Marker, type MarkerDragEvent, type MarkerEvent, type MarkerProps, Minimap, MinimapControl, type MinimapControlOptions, type MinimapControlProps, type MinimapInteractions, NavigationControl, type NavigationControlProps, type ParentRectConfig, Popup, type PopupEvent, type PopupProps, ScaleControl, type ScaleControlProps, Source, type SourceProps, TerrainControl, type TerrainControlProps, type ToggleButtonConfig, type ViewState, type ViewStateChangeEvent, Map as default, logger, setLogger, useControl, useMap };