@antv/aimapui 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { BaiduMap } from '@antv/l7-maps';
 import { Component } from 'react';
 import { default as default_2 } from 'react';
-import { default as default_3 } from '@antv/l7-maps/es/amap-next';
+import { default as default_3 } from 'node_modules/@antv/l7-maps/es/amap-next';
 import { GoogleMap } from '@antv/l7-maps';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 import { Map as Map_2 } from '@antv/l7-maps';
@@ -1078,7 +1078,17 @@ export declare interface BusinessDataItem {
  *
  * 内置全国省/市/县三级 GeoJSON 数据，支持下钻模式与业务数据关联色阶映射。
  */
-export declare function ChinaDistrict({ provinceSource, citySource, districtSource, level, drillEnabled, drillPath: controlledDrillPath, onDrill, data, joinField, dataJoinField, valueField, colors, fillOpacity, strokeColor, strokeWidth, dimOpacity, showLabel, labelField, labelSize, hoverHighlight, clickSelect, showTooltip, tooltipFields, onRegionClick, zIndex, }: ChinaDistrictProps): JSX_2.Element | null;
+export declare const ChinaDistrict: default_2.ForwardRefExoticComponent<ChinaDistrictProps & default_2.RefAttributes<ChinaDistrictHandle>>;
+
+/** ChinaDistrict 命令式 API，通过 ref 获取 */
+export declare interface ChinaDistrictHandle {
+    /** 返回上一级 */
+    drillUp: () => void;
+    /** 返回到指定层级（面包屑导航） */
+    drillUpTo: (targetIndex: number) => void;
+    /** 当前下钻路径 */
+    getDrillPath: () => DrillPathNode[];
+}
 
 export declare interface ChinaDistrictProps {
     /** 省级 GeoJSON 数据 URL 或对象，默认内置全国省级数据 */
@@ -1089,12 +1099,16 @@ export declare interface ChinaDistrictProps {
     districtSource?: string | Record<string, unknown>;
     /** 当前显示层级（非下钻模式时使用） */
     level?: AdministrativeLevel;
-    /** 是否启用下钻模式 */
+    /** 是否启用下钻模式，默认 true */
     drillEnabled?: boolean;
     /** 下钻路径（受控模式） */
     drillPath?: DrillPathNode[];
-    /** 下钻回调 */
+    /** 下钻回调，点击区域进入下一级时触发 */
     onDrill?: (path: DrillPathNode[]) => void;
+    /** 上钻回调，用于面包屑导航返回上级 */
+    onDrillUp?: (path: DrillPathNode[]) => void;
+    /** 下钻时是否自动适配视口（fitBounds），默认 true */
+    autoFitOnDrill?: boolean;
     /** 业务数据，通过 name 或 adcode 与地理数据关联 */
     data?: BusinessDataItem[];
     /** 关联字段（地理数据属性名） */
@@ -1247,6 +1261,47 @@ export declare function createBasemap(schema: MapSchema): Promise<default_3 | Ma
  */
 export declare function createEventBus(): EventBus;
 
+/**
+ * 批量生成 Maki 图标的 iconMap，可直接用于 IconLayer 的 iconMap prop
+ *
+ * @example
+ * ```tsx
+ * <IconLayer
+ *   iconField="type"
+ *   iconMap={createMakiIconMap(['cafe', 'bus', 'hospital'], { fill: '#2563eb' })}
+ * />
+ * ```
+ *
+ * @param names - Maki 图标名列表
+ * @param opts  - 可选参数：size（默认 32）、fill（默认 "#333"）
+ * @returns Record<name, dataURL> 映射
+ */
+export declare function createMakiIconMap(names: string[], opts?: {
+    size?: number;
+    fill?: string;
+}): Record<string, string>;
+
+/**
+ * 批量生成带 Pin 背景的 Maki 图标 iconMap，可直接用于 IconLayer 的 iconMap prop
+ *
+ * @example
+ * ```tsx
+ * <IconLayer
+ *   iconField="type"
+ *   iconMap={createMakiPinMap(['cafe', 'bus', 'hospital'], { fill: '#2563eb' })}
+ *   iconAnchor="bottom"
+ * />
+ * ```
+ *
+ * @param names - Maki 图标名列表
+ * @param opts  - 可选参数：size（默认 40）、fill（Pin 填充色，默认 "#2563eb"）
+ * @returns Record<name, dataURL> 映射
+ */
+export declare function createMakiPinMap(names: string[], opts?: {
+    size?: number;
+    fill?: string;
+}): Record<string, string>;
+
 /**
  * 合并 className（基于 clsx）
  */
@@ -1483,7 +1538,7 @@ export declare interface GestureConfig {
  * - 碰撞检测：图标始终可见，仅文本被避让
  * - 缩放适配：L1(14+) 全显示 → L2(10-13) 仅图标 → L3(<10) 降级圆点
  */
-export declare function GlyphLayer({ source, sourceType, sourceConfig, iconField, iconFontFamily, iconFontPath, iconFontMap, iconColor, iconSize, iconHaloColor, iconHaloWidth, iconStyle, showLabel, labelField, labelColor, labelSize, labelAnchor, labelOffset, labelHaloColor, labelHaloWidth, labelStyle, textAllowOverlap, iconAllowOverlap, zoomAdaption, zoomShowLabel, zoomDegradeToPoint, onClick, onMouseEnter, onMouseLeave, ...rest }: GlyphLayerProps): JSX_2.Element | null;
+export declare function GlyphLayer({ source, sourceType, sourceConfig, iconField, iconFontFamily, iconFontPath, iconFontMap, iconColor, iconSize, iconHaloColor, iconHaloWidth, iconStyle, iconAnchor, iconBgShape, iconBgShapeColor, iconBgShapeSize, iconBgStrokeColor, iconBgStrokeWidth, iconBgPadding, iconBgCornerRadius, showLabel, labelField, labelColor, labelSize, labelAnchor, labelOffset, labelHaloColor, labelHaloWidth, labelStyle, textAllowOverlap, iconAllowOverlap, zoomAdaption, zoomShowLabel, zoomDegradeToPoint, onClick, onMouseEnter, onMouseLeave, ...rest }: GlyphLayerProps): JSX_2.Element | null;
 
 export declare interface GlyphLayerProps extends Omit<LayerSchema, 'type' | 'source' | 'sourceType' | 'sourceConfig'> {
     source: LayerSchema['source'];
@@ -1519,6 +1574,22 @@ export declare interface GlyphLayerProps extends Omit<LayerSchema, 'type' | 'sou
     iconHaloWidth?: number;
     /** 图标样式扩展 */
     iconStyle?: Record<string, unknown>;
+    /** 图标锚点位置，默认 'center' */
+    iconAnchor?: IconAnchor_2;
+    /** 图标背景形状，默认 'pin' */
+    iconBgShape?: 'circle' | 'pin';
+    /** 图标背景形状颜色，默认不显示 */
+    iconBgShapeColor?: string;
+    /** 图标背景形状大小，默认 24 */
+    iconBgShapeSize?: number;
+    /** 图标背景边框颜色 */
+    iconBgStrokeColor?: string;
+    /** 图标背景边框宽度，默认 0 */
+    iconBgStrokeWidth?: number;
+    /** 图标背景 padding，默认 0 */
+    iconBgPadding?: number;
+    /** 图标背景圆角半径，默认 0 */
+    iconBgCornerRadius?: number;
     /** 是否显示文字标签，默认 true */
     showLabel?: boolean;
     /** 文字标签字段，默认取 iconField */
@@ -1600,6 +1671,9 @@ export declare function hexToRgba(hex: string, alpha?: number): string;
 
 export declare type IconAnchor = 'center' | 'top' | 'bottom' | 'left' | 'right';
 
+/** 图标锚点位置 */
+declare type IconAnchor_2 = 'center' | 'top' | 'bottom' | 'left' | 'right';
+
 /**
  * 图片标注图层（IconLayer）
  *
@@ -2126,6 +2200,44 @@ export declare interface LineLayerProps extends Omit<LayerSchema, 'type' | 'sour
     onMouseLeave?: (payload: LayerEventPayload) => void;
 }
 
+export declare const MAKI_ICON_NAMES: string[];
+
+/**
+ * Maki Icons — Mapbox Maki icon path data
+ * Source: https://mapbox.com/maki-icons/
+ * License: CC0 1.0 Universal (Public Domain)
+ */
+export declare const MAKI_ICONS: Record<string, string>;
+
+export declare type MakiIconName = keyof typeof MAKI_ICONS;
+
+/**
+ * 将 Maki 图标路径数据生成 SVG data URL
+ *
+ * @param icon  - Maki 图标名（如 "cafe"、"bus"）
+ * @param opts  - 可选参数：size（默认 32）、fill（默认 "#333"）
+ * @returns data:image/svg+xml,... URL，可直接用于 L7 scene.addImage 或 IconLayer iconMap
+ */
+export declare function makiIconUrl(icon: string, opts?: {
+    size?: number;
+    fill?: string;
+}): string;
+
+/**
+ * 将 Maki 图标生成为带 Pin 背景的 SVG data URL
+ *
+ * 效果类似 Marker variant="icon"：水滴型 Pin 背景 + 白色 Maki 图标
+ * 可直接用于 L7 scene.addImage 或 IconLayer iconMap
+ *
+ * @param icon  - Maki 图标名（如 "cafe"、"bus"）
+ * @param opts  - 可选参数：size（默认 40，即 SVG 宽度）、fill（Pin 填充色，默认 "#2563eb"）
+ * @returns data:image/svg+xml,... URL
+ */
+export declare function makiPinUrl(icon: string, opts?: {
+    size?: number;
+    fill?: string;
+}): string;
+
 declare interface MapEventHandlers {
     onMove?: (payload: MapEventPayload) => void;
     onZoom?: (payload: MapEventPayload) => void;
@@ -2240,7 +2352,7 @@ export declare interface MarkerProps extends Omit<MarkerSchema, 'type' | 'conten
     variant?: MarkerVariant;
     /** 语义颜色，默认 primary */
     color?: MarkerColor;
-    /** Material Symbols 图标名 (仅 variant='icon' 时生效) */
+    /** Maki 图标名（如 "cafe"、"bus"、"airport"），仅 variant='icon' 时生效 */
     icon?: string;
     /** 文本标注，显示在 Marker 下方 4px */
     label?: string;
@@ -2279,7 +2391,7 @@ export declare interface MarkerSchema {
  * Marker 基础形态
  * - pin:   水滴型 (32x40px)，默认业务点，用于 POI、站点、静态设施
  * - circle: 圆型 (24x24px)，移动/轻量点，用于实时车辆、传感器
- * - icon:  图标型，在 Pin 内嵌入 Material Symbols 图标
+ * - icon:  图标型，在 Pin 内嵌入 Maki 图标
  * - dot:   简化点 (8px)，低缩放级降级形态
  */
 export declare type MarkerVariant = 'pin' | 'circle' | 'icon' | 'dot';