@yarrow-uz/yarrow-map-web-sdk 1.0.46 → 1.0.48

package/dist/react/index.d.ts

@@ -1,4 +1,342 @@
-import 'maplibre-gl/dist/maplibre-gl.css';
-export * from './useYarrowMap';
-export * from './YarrowMapView';
-//# sourceMappingURL=index.d.ts.map
+import * as React from "react";
+import { FeatureIdentifier, GeoJSONSourceSpecification, LayerSpecification, Map as Map$1, MapMouseEvent, Marker, MarkerOptions, PointLike, QueryRenderedFeaturesOptions, StyleSpecification } from "maplibre-gl";
+
+//#region src/maps/brandBadge.d.ts
+type BrandBadgePosition$1 = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+//#endregion
+//#region src/maps/yarrowControls.d.ts
+type YarrowControlsPosition$1 = 'left' | 'left-top' | 'left-bottom' | 'right' | 'right-top' | 'right-bottom';
+type YarrowControlsConfig$1 = {
+  enabled?: boolean;
+  position?: YarrowControlsPosition$1;
+  zoom?: boolean;
+  compass?: boolean;
+};
+type NormalizedYarrowControlsConfig = {
+  enabled: boolean;
+  position: YarrowControlsPosition$1;
+  zoom: boolean;
+  compass: boolean;
+};
+declare const normalizeYarrowControlsConfig: (controls?: YarrowControlsConfig$1) => NormalizedYarrowControlsConfig;
+//#endregion
+//#region node_modules/@maplibre/maplibre-gl-style-spec/dist/index.d.ts
+type ColorSpecification = string;
+type ProjectionDefinitionT = [string, string, number];
+type ProjectionDefinitionSpecification = string | ProjectionDefinitionT | PropertyValueSpecification<ProjectionDefinitionT>;
+type ExpressionInputType = string | number | boolean;
+type VariableExpressionSpecification = ["var", string];
+type CollatorExpressionSpecification = ["collator", {
+  "case-sensitive"?: boolean | ExpressionSpecification;
+  "diacritic-sensitive"?: boolean | ExpressionSpecification;
+  locale?: string | ExpressionSpecification;
+}];
+type InterpolationSpecification = ["linear"] | ["exponential", number] | ["cubic-bezier", number, number, number, number];
+type ExpressionSpecification = ["array", ExpressionSpecification] | ["array", "string" | "number" | "boolean", ExpressionSpecification] | ["array", "string" | "number" | "boolean", number, ExpressionSpecification] | ["boolean", unknown | ExpressionSpecification, ...(unknown | ExpressionSpecification)[]] | CollatorExpressionSpecification | ["format", ...(string | ["image", ExpressionSpecification] | ExpressionSpecification | {
+  "font-scale"?: number | ExpressionSpecification;
+  "text-font"?: ExpressionSpecification;
+  "text-color"?: ColorSpecification | ExpressionSpecification;
+  "vertical-align"?: "bottom" | "center" | "top";
+})[]] | ["image", string | ExpressionSpecification] | ["literal", unknown] | ["number", unknown | ExpressionSpecification, ...(unknown | ExpressionSpecification)[]] | ["number-format", number | ExpressionSpecification, {
+  "locale"?: string | ExpressionSpecification;
+  "currency"?: string | ExpressionSpecification;
+  "min-fraction-digits"?: number | ExpressionSpecification;
+  "max-fraction-digits"?: number | ExpressionSpecification;
+}] | ["number-format", number | ExpressionSpecification, {
+  "locale"?: string | ExpressionSpecification;
+  "unit"?: string | ExpressionSpecification;
+  "min-fraction-digits"?: number | ExpressionSpecification;
+  "max-fraction-digits"?: number | ExpressionSpecification;
+}] | ["object", unknown | ExpressionSpecification, ...(unknown | ExpressionSpecification)[]] | ["string", unknown | ExpressionSpecification, ...(unknown | ExpressionSpecification)[]] | ["to-boolean", unknown | ExpressionSpecification] | ["to-color", unknown | ExpressionSpecification, ...(unknown | ExpressionSpecification)[]] | ["to-number", unknown | ExpressionSpecification, ...(unknown | ExpressionSpecification)[]] | ["to-string", unknown | ExpressionSpecification] | ["typeof", unknown | ExpressionSpecification] | ["accumulated"] | ["feature-state", string | ExpressionSpecification] | ["geometry-type"] | ["id"] | ["line-progress"] | ["properties"] | ["at", number | ExpressionSpecification, ExpressionSpecification] | ["get", string | ExpressionSpecification, ExpressionSpecification?] | ["global-state", string] | ["has", string | ExpressionSpecification, ExpressionSpecification?] | ["in", null | ExpressionInputType | ExpressionSpecification, string | ExpressionSpecification] | ["index-of", null | ExpressionInputType | ExpressionSpecification, string | ExpressionSpecification, (number | ExpressionSpecification)?] | ["length", string | ExpressionSpecification] | ["slice", string | ExpressionSpecification, number | ExpressionSpecification, (number | ExpressionSpecification)?] | ["!", boolean | ExpressionSpecification] | ["!=", null | ExpressionInputType | ExpressionSpecification, null | ExpressionInputType | ExpressionSpecification, (CollatorExpressionSpecification | VariableExpressionSpecification)?] | ["<", string | number | ExpressionSpecification, string | number | ExpressionSpecification, (CollatorExpressionSpecification | VariableExpressionSpecification)?] | ["<=", string | number | ExpressionSpecification, string | number | ExpressionSpecification, (CollatorExpressionSpecification | VariableExpressionSpecification)?] | ["==", null | ExpressionInputType | ExpressionSpecification, null | ExpressionInputType | ExpressionSpecification, (CollatorExpressionSpecification | VariableExpressionSpecification)?] | [">", string | number | ExpressionSpecification, string | number | ExpressionSpecification, (CollatorExpressionSpecification | VariableExpressionSpecification)?] | [">=", string | number | ExpressionSpecification, string | number | ExpressionSpecification, (CollatorExpressionSpecification | VariableExpressionSpecification)?] | ["all", ...(boolean | ExpressionSpecification)[]] | ["any", ...(boolean | ExpressionSpecification)[]] | ["case", boolean | ExpressionSpecification, null | ExpressionInputType | ExpressionSpecification, ...(boolean | null | ExpressionInputType | ExpressionSpecification)[], null | ExpressionInputType | ExpressionSpecification] | ["coalesce", ...(ExpressionInputType | ExpressionSpecification)[]] | ["match", string | number | ExpressionSpecification, string | number | string[] | number[], null | ExpressionInputType | ExpressionSpecification, ...(string | number | string[] | number[] | null | ExpressionInputType | ExpressionSpecification)[], // repeated as above
+null | ExpressionInputType | ExpressionSpecification] | ["within", GeoJSON.GeoJSON] | ["interpolate", InterpolationSpecification, number | ExpressionSpecification, ...(number | ColorSpecification | ExpressionSpecification | ProjectionDefinitionSpecification)[]] | ["interpolate-hcl", InterpolationSpecification, number | ExpressionSpecification, ...(number | ColorSpecification | ExpressionSpecification)[]] | ["interpolate-lab", InterpolationSpecification, number | ExpressionSpecification, ...(number | ColorSpecification | ExpressionSpecification)[]] | ["step", number | ExpressionSpecification, ExpressionInputType | ExpressionSpecification, ...(number | ExpressionInputType | ExpressionSpecification)[]] | ["let", string, ExpressionInputType | ExpressionSpecification, ...(string | ExpressionInputType | ExpressionSpecification)[]] | VariableExpressionSpecification | ["concat", ...(ExpressionInputType | ExpressionSpecification)[]] | ["downcase", string | ExpressionSpecification] | ["is-supported-script", string | ExpressionSpecification] | ["join", string[] | ExpressionSpecification, string | ExpressionSpecification] | ["resolved-locale", CollatorExpressionSpecification] | ["split", string | ExpressionSpecification, string | ExpressionSpecification] | ["upcase", string | ExpressionSpecification] | ["rgb", number | ExpressionSpecification, number | ExpressionSpecification, number | ExpressionSpecification] | ["rgba", number | ExpressionSpecification, number | ExpressionSpecification, number | ExpressionSpecification, number | ExpressionSpecification] | ["to-rgba", ColorSpecification | ExpressionSpecification] | ["-", number | ExpressionSpecification, (number | ExpressionSpecification)?] | ["*", number | ExpressionSpecification, number | ExpressionSpecification, ...(number | ExpressionSpecification)[]] | ["/", number | ExpressionSpecification, number | ExpressionSpecification] | ["%", number | ExpressionSpecification, number | ExpressionSpecification] | ["^", number | ExpressionSpecification, number | ExpressionSpecification] | ["+", ...(number | ExpressionSpecification)[]] | ["abs", number | ExpressionSpecification] | ["acos", number | ExpressionSpecification] | ["asin", number | ExpressionSpecification] | ["atan", number | ExpressionSpecification] | ["ceil", number | ExpressionSpecification] | ["cos", number | ExpressionSpecification] | ["distance", GeoJSON.GeoJSON] | ["e"] | ["floor", number | ExpressionSpecification] | ["ln", number | ExpressionSpecification] | ["ln2"] | ["log10", number | ExpressionSpecification] | ["log2", number | ExpressionSpecification] | ["max", number | ExpressionSpecification, ...(number | ExpressionSpecification)[]] | ["min", number | ExpressionSpecification, ...(number | ExpressionSpecification)[]] | ["pi"] | ["round", number | ExpressionSpecification] | ["sin", number | ExpressionSpecification] | ["sqrt", number | ExpressionSpecification] | ["tan", number | ExpressionSpecification] | ["zoom"] | ["heatmap-density"] | ["elevation"] | ["global-state", string];
+type ExpressionFilterSpecification = boolean | ExpressionSpecification;
+type LegacyFilterSpecification = ["has", string] | ["!has", string] | ["==", string, string | number | boolean] | ["!=", string, string | number | boolean] | [">", string, string | number | boolean] | [">=", string, string | number | boolean] | ["<", string, string | number | boolean] | ["<=", string, string | number | boolean] | ["in", string, ...(string | number | boolean)[]] | ["!in", string, ...(string | number | boolean)[]] | ["all", ...LegacyFilterSpecification[]] | ["any", ...LegacyFilterSpecification[]] | ["none", ...LegacyFilterSpecification[]];
+type FilterSpecification = ExpressionFilterSpecification | LegacyFilterSpecification;
+type CameraFunctionSpecification<T> = {
+  type: "exponential";
+  stops: Array<[number, T]>;
+} | {
+  type: "interval";
+  stops: Array<[number, T]>;
+};
+type PropertyValueSpecification<T> = T | CameraFunctionSpecification<T> | ExpressionSpecification;
+//#endregion
+//#region src/maps/types.d.ts
+type CacheConfig$1 = {
+  enabled?: boolean;
+  lifespanDays?: number;
+};
+type NormalizedCacheConfig = {
+  enabled: boolean;
+  lifespanDays: number;
+};
+type LayerDescriptor = {
+  type: string;
+  name: string;
+};
+type AddLayerOptions = {
+  sourceId?: string;
+  filter?: FilterSpecification;
+};
+type BoundsInput = {
+  type?: string;
+  features: Array<{
+    geometry?: {
+      type?: string;
+      coordinates?: unknown;
+    };
+  }>;
+};
+type RouteFeature = {
+  type: 'Feature';
+  geometry: {
+    type: 'LineString';
+    coordinates: [number, number][];
+  };
+  properties: {
+    duration: number;
+    distance: number;
+    [key: string]: unknown;
+  };
+};
+type SearchResult = {
+  id?: string | number;
+  latitude?: number;
+  longitude?: number;
+  icon_img?: string;
+  name?: string;
+  [key: string]: unknown;
+};
+type YarrowMapConfigOptions = {
+  container: HTMLElement | string;
+  center: [number, number];
+  zoom?: number;
+  minZoom?: number;
+  maxZoom?: number;
+  theme?: 'light' | 'dark';
+  cache?: CacheConfig$1;
+  brandBadgePosition?: BrandBadgePosition$1;
+  controls?: YarrowControlsConfig$1;
+  excludePoiLayer?: boolean;
+  apiKey: string;
+};
+type SearchOptions = {
+  layerName?: string;
+  iconImage?: string;
+  highlightColor?: string;
+  pulseAnimation?: boolean;
+  zoomToResults?: boolean;
+  onIconClick?: (lat: number, lng: number, properties: Record<string, unknown>) => void;
+  onResultsUpdate?: (results: SearchResult[]) => void;
+  onLoadingStateChange?: (state: 'firstRender' | 'rerender' | false) => void;
+};
+//#endregion
+//#region src/maps/config.d.ts
+declare class YarrowMapConfig {
+  readonly container: HTMLElement | string;
+  readonly center: [number, number];
+  readonly zoom: number;
+  readonly minZoom: number;
+  readonly maxZoom: number;
+  theme: 'light' | 'dark';
+  cache: NormalizedCacheConfig;
+  brandBadgePosition: BrandBadgePosition$1;
+  controls: ReturnType<typeof normalizeYarrowControlsConfig>;
+  excludePoiLayer: boolean;
+  apiKey: string;
+  constructor(config: YarrowMapConfigOptions);
+}
+//#endregion
+//#region src/maps/routing/types.d.ts
+type RouteLineCap = 'butt' | 'round' | 'square';
+type RouteLineJoin = 'bevel' | 'round' | 'miter';
+interface RouteEventContext {
+  feature: RouteFeature;
+  index: number;
+  isBest: boolean;
+  layerId: string;
+  lngLat: {
+    lng: number;
+    lat: number;
+  };
+  originalEvent: MapMouseEvent;
+}
+interface BuildRouteOptions {
+  profile: string;
+  coordinates: [number, number][];
+  routeColor?: string;
+  routeWidth?: number;
+  routeOpacity?: number;
+  alternativeColor?: string;
+  alternativeWidth?: number;
+  alternativeOpacity?: number;
+  routeLineCap?: RouteLineCap;
+  routeLineJoin?: RouteLineJoin;
+  fitBounds?: boolean;
+  clearOldRoutes?: boolean;
+  language?: string;
+  layerPrefix?: string;
+  onRouteClick?: (ctx: RouteEventContext) => void;
+  onRouteHover?: (ctx: RouteEventContext | null) => void;
+}
+interface BuildRouteResult {
+  features: RouteFeature[];
+  directions: RouteDirection[][];
+  meta: {
+    profile: string;
+    totalRoutes: number;
+    bestRouteIndex: number;
+    duration: number;
+    distance: number;
+  };
+}
+type RouteDirection = {
+  distance: number;
+  duration: number;
+  instruction: string;
+  [key: string]: unknown;
+};
+//#endregion
+//#region src/maps/yarrow.d.ts
+declare class YarrowMap {
+  private static isCacheProtocolRegistered;
+  config: YarrowMapConfig;
+  map?: Map$1;
+  layers: LayerDescriptor[];
+  private layerManager;
+  private markerManager;
+  private routingBuilder;
+  private routingRenderer;
+  private searchManager;
+  private stylesManager;
+  private navigationManager;
+  private eventManager;
+  private badgeController;
+  private controlsController;
+  private badgeResizeObserver?;
+  private poiLayerConfig?;
+  private poiSourceConfig?;
+  constructor(config: YarrowMapConfig);
+  private ensureCacheProtocol;
+  private get cacheLifespanMs();
+  private isCacheEnabled;
+  private transformRequestForCache;
+  private fetchJson;
+  private addApiKeyToUrl;
+  private loadImageFromSrc;
+  private loadIconImage;
+  private getIconsMap;
+  private addIconsToMap;
+  private patchMapRemoveForBadgeCleanup;
+  private getControlsInsetForCollision;
+  private syncOverlayCollisionInset;
+  private stopBadgeCollisionObserver;
+  private startBadgeCollisionObserver;
+  fixStyle(style: StyleSpecification | null | undefined): void;
+  private updateLayersArray;
+  private storePoiLayerConfig;
+  private removePoiLayerFromStyle;
+  init(): Promise<void>;
+  clearCache(): Promise<void>;
+  changeStyles(styleType?: string): Promise<StyleSpecification>;
+  changeTheme(theme: 'light' | 'dark'): Promise<StyleSpecification>;
+  changeBrandBadgePosition(position: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right'): BrandBadgePosition$1;
+  enablePoiLayer(): void;
+  disablePoiLayer(): void;
+  zoomTo(lat: number, lng: number, zoom: number): void;
+  fitBounds(data: BoundsInput): void;
+  getBoundingBox(data: BoundsInput): {
+    xMin: number;
+    xMax: number;
+    yMin: number;
+    yMax: number;
+  };
+  onMoveEnd(callback: (lat: number, lng: number, zoom: number) => void): void;
+  onMapClick(callback: (lat: number, lng: number) => void): void;
+  onIconClick(layerGroup: 'pois' | 'buildings', callback: (lat: number, lng: number, properties: Record<string, unknown>) => void): void;
+  onLayerClick(layerName: 'buildings' | 'pois', callback: (lat: number, lng: number, properties: Record<string, unknown>) => void): void;
+  changeBackgroundColor(color: string): void;
+  addSource(sourceId: string, data: GeoJSONSourceSpecification['data']): void;
+  updateSourceData(sourceId: string, data: GeoJSONSourceSpecification['data']): void;
+  addLayer(layerName: string, layerType: LayerSpecification['type'], featureCollection: GeoJSONSourceSpecification['data'], paint?: LayerSpecification['paint'], layout?: LayerSpecification['layout'], iconSettings?: {
+    width?: number;
+    height?: number;
+  }, options?: AddLayerOptions): void;
+  removeLayer(layerName: string): void;
+  setFeatureState(feature: FeatureIdentifier, state: Record<string, unknown>): void;
+  queryRenderedFeatures(geometryOrOptions?: PointLike | [PointLike, PointLike] | QueryRenderedFeaturesOptions, options?: QueryRenderedFeaturesOptions): import("maplibre-gl").MapGeoJSONFeature[];
+  addMarker(coordinates: [number, number], options?: MarkerOptions): Marker | null;
+  removeMarker(marker: Marker | null): void;
+  renderRoutes(routes: RouteFeature[], baseLayerName?: string): void;
+  buildRoute(options: BuildRouteOptions): Promise<BuildRouteResult>;
+  buildRouteWithLabels(startCoordinates: [number, number], endCoordinates: [number, number], profile: string): Promise<{
+    features: RouteFeature[];
+    directions: unknown[];
+  }>;
+  buildMultiSegmentRouteWithLabels(coordinates: [number, number][], profile: string, language?: string): Promise<{
+    features: RouteFeature[];
+    directions: unknown[][];
+  }>;
+  clearAllRoutes(): void;
+  highlightSearchResults(query: string, options?: SearchOptions): () => void;
+}
+//#endregion
+//#region src/react/useYarrowMap.d.ts
+type CacheConfig = {
+  enabled?: boolean;
+  lifespanDays?: number;
+};
+type BrandBadgePosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+type YarrowControlsPosition = 'left' | 'left-top' | 'left-bottom' | 'right' | 'right-top' | 'right-bottom';
+type YarrowControlsConfig = {
+  enabled?: boolean;
+  position?: YarrowControlsPosition;
+  zoom?: boolean;
+  compass?: boolean;
+};
+type YarrowMapReactConfig = {
+  center: [number, number];
+  zoom?: number;
+  minZoom?: number;
+  maxZoom?: number;
+  theme?: 'light' | 'dark';
+  cache?: CacheConfig;
+  brandBadgePosition?: BrandBadgePosition;
+  controls?: YarrowControlsConfig;
+  excludePoiLayer?: boolean;
+  apiKey: string;
+};
+type UseYarrowMapOptions = {
+  config: YarrowMapReactConfig;
+  configKey?: string | number;
+  onReady?: (map: YarrowMap) => void;
+};
+type UseYarrowMapResult = {
+  containerRef: React.RefObject<HTMLDivElement | null>;
+  map: YarrowMap | null;
+  isReady: boolean;
+  error: Error | null;
+};
+declare const useYarrowMap: ({
+  config,
+  configKey,
+  onReady
+}: UseYarrowMapOptions) => UseYarrowMapResult;
+//#endregion
+//#region src/react/YarrowMapView.d.ts
+type YarrowMapViewProps = {
+  config: YarrowMapReactConfig;
+  configKey?: string | number;
+  onReady?: Parameters<typeof useYarrowMap>[0]['onReady'];
+  className?: string;
+  style?: React.CSSProperties;
+};
+declare const YarrowMapView: ({
+  config,
+  configKey,
+  onReady,
+  className,
+  style
+}: YarrowMapViewProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { UseYarrowMapOptions, UseYarrowMapResult, YarrowMapReactConfig, YarrowMapView, useYarrowMap };