@yituengine/keymap 1.0.0

package/dist/types/graphic/index.d.ts

@@ -0,0 +1,32 @@
+import ModelGraphic from './modelGraphic';
+import PolylineGraphic from './polylineGraphic';
+import PolygonGraphic from './polygonGraphic';
+import CircleGraphic from './circleGraphic';
+import BillboardGraphic from './billboardGraphic';
+import PopupGraphic from './popupGraphic';
+import CustomPopupGraphic from './customPopupGraphic';
+export { default as ModelGraphic } from './modelGraphic';
+export { default as PolylineGraphic } from './polylineGraphic';
+export { default as PolygonGraphic } from './polygonGraphic';
+export { default as CircleGraphic } from './circleGraphic';
+export { default as BillboardGraphic } from './billboardGraphic';
+export { default as CustomPopupGraphic } from './customPopupGraphic';
+export { default as PopupGraphic } from './popupGraphic';
+export type { BillboardGraphicOptions } from './billboardGraphic';
+export type { CircleGraphicOptions } from './circleGraphic';
+export type { CustomPopupGraphicOptions } from './customPopupGraphic';
+export type { ModelGraphicOptions, ModelPathOptions } from './modelGraphic';
+export type { PolygonGraphicOptions } from './polygonGraphic';
+export type { PolylineGraphicOptions } from './polylineGraphic';
+export type { PopupGraphicOptions } from './popupGraphic';
+export type GraphicType = BillboardGraphic | ModelGraphic | PolylineGraphic | PolygonGraphic | CircleGraphic | PopupGraphic | CustomPopupGraphic;
+declare const _default: {
+    BillboardGraphic: typeof BillboardGraphic;
+    ModelGraphic: typeof ModelGraphic;
+    PolylineGraphic: typeof PolylineGraphic;
+    PolygonGraphic: typeof PolygonGraphic;
+    CircleGraphic: typeof CircleGraphic;
+    PopupGraphic: typeof PopupGraphic;
+    CustomPopupGraphic: typeof CustomPopupGraphic;
+};
+export default _default;

package/dist/types/graphic/modelGraphic.d.ts

@@ -0,0 +1,90 @@
+import PathAnim from '../core/pathAnim';
+import BaseGraphic, { BaseGraphicOptions } from './baseGraphic';
+import { GraphicLayer } from '../layer';
+import * as Cesium from 'cesium';
+import { Rotation } from '../types';
+/**
+ * 模型图形构造参数。
+ *
+ * 继承 Cesium `ModelGraphics` 参数，并追加模型初始姿态配置。
+ */
+export interface ModelGraphicOptions extends Cesium.ModelGraphics.ConstructorOptions, BaseGraphicOptions {
+    /** 模型初始旋转角，单位为弧度。 */
+    rotation?: Rotation;
+}
+/** 模型路径动画配置。 */
+export interface ModelPathOptions {
+    /** 路径点位数组。 */
+    positions: Cesium.Cartesian3[];
+    /** 路径运动时使用的模型姿态。 */
+    rotation?: Rotation;
+    /** 路径播放速度。 */
+    speed?: number;
+    /** 是否在路径播放时插值旋转。 */
+    isLerpRotation?: boolean;
+    /** 参与路径播放的模型 Entity；通常由 `setPath()` 自动注入。 */
+    model?: Cesium.Entity | null;
+}
+/**
+ * 三维模型图形。
+ *
+ * 用于把 Cesium `ModelGraphics` 添加到业务图层，支持移动、旋转、路径动画、导览视角和生成动画。
+ */
+declare class ModelGraphic extends BaseGraphic {
+    /** 图形类型标识。 */
+    readonly type: 'ModelGraphic';
+    /** Cesium ModelGraphics 实例。 */
+    graphic: Cesium.ModelGraphics;
+    /** 当前模型路径动画实例。 */
+    pathAnim: PathAnim | null;
+    private rotation;
+    /**
+     * 创建模型图形。
+     *
+     * @param opt 模型图形配置。
+     */
+    constructor(opt: ModelGraphicOptions);
+    /**
+     * 将模型添加到图层。
+     *
+     * 添加后会创建或获取 Entity，挂载 `model`、标签、初始位置和初始旋转。
+     *
+     * @param layer 目标图层。
+     */
+    add(layer: GraphicLayer): void;
+    /** 销毁模型 Entity 和关联弹窗。 */
+    destroy(): void;
+    /** 将相机定位到模型 Entity。 */
+    zoomTo(): void;
+    /**
+     * 移动模型到新位置。
+     *
+     * @param position 新的 Cesium Cartesian3 位置。
+     */
+    moveTo(position: Cesium.Cartesian3): void;
+    /**
+     * 设置模型旋转。
+     *
+     * @param rotation heading、pitch、roll 旋转角，单位为弧度。
+     */
+    setRotation(rotation: Rotation): void;
+    /**
+     * 设置模型路径动画。
+     *
+     * @param opt 路径动画配置。
+     * @param isGuide 是否进入跟随导览视角。
+     */
+    setPath(opt: ModelPathOptions, isGuide?: boolean): void;
+    /** 进入模型跟随导览视角。 */
+    enterGuide(): void;
+    /** 退出模型跟随导览视角。 */
+    exitGuide(): void;
+    /** 导览模式下的相机姿态更新回调。 */
+    guideUpdate(): void;
+    /** 播放模型生成动画，通过裁剪面逐步展示模型。 */
+    animate(): void;
+}
+declare namespace ModelGraphic {
+    type ConstructorOptions = ModelGraphicOptions;
+}
+export default ModelGraphic;

package/dist/types/graphic/polygonGraphic.d.ts

@@ -0,0 +1,124 @@
+import * as Cesium from 'cesium';
+import BaseGraphic, { BaseGraphicOptions } from './baseGraphic';
+import { GraphicLayer } from '../layer';
+/**
+ * 多边形图形构造参数。
+ *
+ * 继承 Cesium `PolygonGraphics` 参数，并追加顶点数组、编辑回调和描边配置。
+ */
+export interface PolygonGraphicOptions extends Cesium.PolygonGraphics.ConstructorOptions, BaseGraphicOptions {
+    /** 多边形顶点数组，按顺序组成闭合面。 */
+    positions: Cesium.Cartesian3[];
+    /** 多边形标签配置。 */
+    label?: Cesium.LabelGraphics.ConstructorOptions;
+    /** 顶点新增、移动、删除或整体更新后触发。 */
+    onChanged?: (positions: Cesium.Cartesian3[]) => void;
+    /** 常态描边宽度，传入 `0` 可关闭常态描边。 */
+    outlineWidth?: number;
+    /** 常态描边颜色，优先级低于 `outlineMaterial`。 */
+    outlineColor?: Cesium.Color;
+    /** 常态描边材质，优先级高于 `outlineColor`。 */
+    outlineMaterial?: Cesium.PolylineGraphics.ConstructorOptions['material'];
+}
+/**
+ * 可编辑多边形图形。
+ *
+ * 图形本体使用 Cesium Polygon，SDK 额外维护闭合 Polyline 描边、悬停高亮、顶点控制点和边中点。
+ */
+declare class PolygonGraphic extends BaseGraphic {
+    /** 图形类型标识。 */
+    readonly type: 'PolygonGraphic';
+    /** 多边形顶点数组。 */
+    positions: Cesium.Cartesian3[];
+    /** Cesium PolygonGraphics 实例。 */
+    graphic: Cesium.PolygonGraphics;
+    /** 顶点数组更新后的业务回调。 */
+    onChanged: ((positions: Cesium.Cartesian3[]) => void) | undefined;
+    private changedDuringDrag;
+    private controlPoints;
+    private midPoints;
+    private positionsProperty;
+    private isHovering;
+    private hoverOutlineEntity;
+    private outlineEntity;
+    private outlineWidth;
+    private outlineMaterial;
+    private outlinePositionsProperty;
+    /**
+     * 创建多边形图形。
+     *
+     * @param opt 多边形图形配置。
+     */
+    constructor(opt: PolygonGraphicOptions);
+    /**
+     * 将多边形添加到图层。
+     *
+     * 添加后会创建 Polygon Entity，设置层级、中心锚点、标签和常态描边。
+     *
+     * @param layer 目标图层。
+     */
+    add(layer: GraphicLayer): void;
+    /** 创建常态边框：沿多边形周长的闭合 polyline，颜色从 material 提取或用 outlineColor */
+    private showOutline;
+    private clearOutline;
+    /** 从 polygon 的 material 中提取纯色（忽略透明度），用于边框 */
+    private extractOutlineColor;
+    /** 进入编辑模式，显示顶点控制点和边中点。 */
+    showHandler(): void;
+    /** 退出编辑模式，移除顶点控制点和边中点。 */
+    clearHandler(): void;
+    private showControlPoints;
+    private showMidPoints;
+    /** 拖拽热路径专用：原地更新中点坐标，实体不销毁重建，仅setValue */
+    private updateMidPointPositions;
+    /**
+     * 将边中点转换为新的顶点控制点。
+     *
+     * @param midPointIndex 被选中的中点索引。
+     */
+    convertMidPointToControlPoint(midPointIndex: number): void;
+    /** 显示鼠标悬停高亮描边。 */
+    onMouseMoveIn(): void;
+    /** 隐藏鼠标悬停高亮描边。 */
+    onMouseMoveOut(): void;
+    /**
+     * 显示悬停描边：一条沿多边形周长闭合的白色粗线
+     * 不修改多边形本体材质，避免 pick 丢失闪烁
+     */
+    private showHoverOutline;
+    private clearHoverOutline;
+    /**
+     * 响应顶点控制点拖拽移动。
+     *
+     * 移动后会同步 PolygonHierarchy、边中点和描边位置。`onChanged` 会在拖拽结束时触发。
+     *
+     * @param index 被移动的顶点索引。
+     * @param newPosition 顶点移动到的新位置。
+     */
+    onControlPointMoved(index: number, newPosition: Cesium.Cartesian3): void;
+    /** 控制点拖拽结束回调，刷新中心锚点并在顶点变化后触发 `onChanged`。 */
+    onControlPointDragEnd(): void;
+    /**
+     * 删除指定顶点控制点。
+     *
+     * 删除后会重建控制点和中点，并同步 PolygonHierarchy、描边和中心锚点。多边形至少保留 3 个顶点。
+     *
+     * @param index 要删除的顶点索引。
+     */
+    onControlPointDeleted(index: number): void;
+    private syncOutlinePositions;
+    private clearControlPoints;
+    private clearMidPoints;
+    /**
+     * 替换多边形全部顶点。
+     *
+     * @param targetPos 新的顶点数组。
+     */
+    updatePositions(targetPos: Cesium.Cartesian3[]): void;
+    /** 销毁多边形 Entity、描边、悬停高亮、编辑控制点和关联弹窗。 */
+    destroy(): void;
+}
+declare namespace PolygonGraphic {
+    type ConstructorOptions = PolygonGraphicOptions;
+}
+export default PolygonGraphic;

package/dist/types/graphic/polylineGraphic.d.ts

@@ -0,0 +1,100 @@
+import BaseGraphic, { BaseGraphicOptions } from './baseGraphic';
+import * as Cesium from 'cesium';
+import { GraphicLayer } from '../layer';
+/**
+ * 折线图形构造参数。
+ *
+ * 继承 Cesium `PolylineGraphics` 参数，并追加顶点数组和编辑回调。
+ */
+export interface PolylineGraphicOptions extends Cesium.PolylineGraphics.ConstructorOptions, BaseGraphicOptions {
+    /** 折线顶点数组。 */
+    positions: Cesium.Cartesian3[];
+    /** 折线标签配置。 */
+    label?: Cesium.LabelGraphics.ConstructorOptions;
+    /** 顶点新增、移动或删除后触发。 */
+    onChanged?: (positions: Cesium.Cartesian3[]) => void;
+}
+/**
+ * 可编辑折线图形。
+ *
+ * 图形本体使用 Cesium Polyline，编辑模式下会显示顶点控制点和线段中点。
+ */
+declare class PolylineGraphic extends BaseGraphic {
+    /** 图形类型标识。 */
+    readonly type: 'PolylineGraphic';
+    /** 折线顶点数组。 */
+    positions: Cesium.Cartesian3[];
+    /** Cesium PolylineGraphics 实例。 */
+    graphic: Cesium.PolylineGraphics;
+    /** 顶点数组更新后的业务回调。 */
+    onChanged: ((positions: Cesium.Cartesian3[]) => void) | undefined;
+    private changedDuringDrag;
+    private controlPoints;
+    private midPoints;
+    private positionsProperty;
+    private isHovering;
+    private hoverOutlineEntity;
+    /**
+     * 创建折线图形。
+     *
+     * @param opt 折线图形配置。
+     */
+    constructor(opt: PolylineGraphicOptions);
+    /**
+     * 将折线添加到图层。
+     *
+     * 添加后会创建 Polyline Entity，设置 positions 属性、中心锚点和标签。
+     *
+     * @param layer 目标图层。
+     */
+    add(layer: GraphicLayer): void;
+    /** 进入编辑模式，显示顶点控制点和线段中点。 */
+    showHandler(): void;
+    /** 退出编辑模式，移除顶点控制点和线段中点。 */
+    clearHandler(): void;
+    private showControlPoints;
+    private showMidPoints;
+    /** 拖拽热路径专用：原地更新中点坐标，实体不销毁重建，仅setValue */
+    private updateMidPointPositions;
+    /**
+     * 将线段中点转换为新的顶点控制点。
+     *
+     * @param midPointIndex 被选中的中点索引。
+     */
+    convertMidPointToControlPoint(midPointIndex: number): void;
+    /** 显示鼠标悬停高亮描边。 */
+    onMouseMoveIn(): void;
+    /** 隐藏鼠标悬停高亮描边。 */
+    onMouseMoveOut(): void;
+    private showHoverOutline;
+    private clearHoverOutline;
+    private getPolylineWidth;
+    private getPolylineZIndex;
+    /**
+     * 响应顶点控制点拖拽移动。
+     *
+     * 移动后会同步 Polyline positions 和中点位置。`onChanged` 会在拖拽结束时触发。
+     *
+     * @param index 被移动的顶点索引。
+     * @param newPosition 顶点移动到的新位置。
+     */
+    onControlPointMoved(index: number, newPosition: Cesium.Cartesian3): void;
+    /** 控制点拖拽结束回调，刷新中心锚点并在顶点变化后触发 `onChanged`。 */
+    onControlPointDragEnd(): void;
+    /**
+     * 删除指定顶点控制点。
+     *
+     * 删除后会重建控制点和中点，并同步 Polyline positions 与中心锚点。折线至少保留 2 个顶点。
+     *
+     * @param index 要删除的顶点索引。
+     */
+    onControlPointDeleted(index: number): void;
+    private clearControlPoints;
+    private clearMidPoints;
+    /** 销毁折线 Entity、悬停高亮、编辑控制点和关联弹窗。 */
+    destroy(): void;
+}
+declare namespace PolylineGraphic {
+    type ConstructorOptions = PolylineGraphicOptions;
+}
+export default PolylineGraphic;

package/dist/types/graphic/popupGraphic.d.ts

@@ -0,0 +1,85 @@
+import { DistanceDisplayCondition } from '../types';
+import * as Cesium from 'cesium';
+import { GraphicLayer } from '../layer';
+import BaseGraphic, { BaseGraphicOptions } from './baseGraphic';
+/**
+ * 内置弹窗构造参数。
+ *
+ * SDK 会根据标题和内容创建默认 DOM 结构，并在地图渲染后同步屏幕位置。
+ */
+export interface PopupGraphicOptions extends BaseGraphicOptions {
+    /** 弹窗标题，支持 HTML 字符串。 */
+    title: string;
+    /** 弹窗内容，作为 HTML 写入默认内容容器。 */
+    content: string;
+    /** 弹窗可视距离范围，超过范围时自动隐藏。 */
+    distance?: DistanceDisplayCondition;
+}
+/**
+ * 内置 DOM 弹窗图形。
+ *
+ * 添加到图层后会创建默认黑色弹窗 DOM，并在 Cesium `postRender` 阶段跟随 `position` 更新屏幕位置。
+ */
+declare class PopupGraphic extends BaseGraphic {
+    /** 图形类型标识。 */
+    readonly type: 'PopupGraphic';
+    /** 弹窗标题。 */
+    title: string;
+    /** 弹窗内容 HTML。 */
+    content: string;
+    /** 弹窗可视距离范围。 */
+    distance: DistanceDisplayCondition;
+    /** SDK 创建的弹窗 DOM 容器。 */
+    container: HTMLDivElement | null;
+    /** 弹窗是否处于业务关闭状态。 */
+    isClosed: boolean;
+    /** 地图容器左侧相对屏幕左侧的偏移。 */
+    left: number;
+    /**
+     * 创建内置弹窗图形。
+     *
+     * @param opt 弹窗配置。
+     */
+    constructor(opt: PopupGraphicOptions);
+    /**
+     * 将弹窗添加到图层并创建默认 DOM。
+     *
+     * @param layer 目标图层。
+     */
+    add(layer: GraphicLayer): void;
+    /** 销毁弹窗 DOM、postRender 监听和图层登记。 */
+    destroy(): void;
+    /** 注册 Cesium postRender 监听，用于每帧更新弹窗位置。 */
+    addListener(): void;
+    /** 移除 postRender 监听并隐藏弹窗。 */
+    clearListener(): void;
+    /** 显示弹窗。 */
+    show(): void;
+    /** 隐藏弹窗。 */
+    hide(): void;
+    /**
+     * 更新弹窗锚点、标题或内容。
+     *
+     * `title` 和 `content` 会写入默认 DOM，其中 `content` 按 HTML 处理。
+     *
+     * @param opt 可选更新项。
+     * @param opt.position 新锚点位置。
+     * @param opt.title 新标题。
+     * @param opt.content 新内容 HTML。
+     */
+    updateLabel(opt?: {
+        position?: Cesium.Cartesian3;
+        title?: string;
+        content?: string;
+    }): void;
+    /**
+     * Cesium postRender 回调。
+     *
+     * 根据锚点屏幕坐标、视口范围、相机距离和关闭状态更新 DOM 显隐与位置。
+     */
+    Postshow(): void;
+}
+declare namespace PopupGraphic {
+    type ConstructorOptions = PopupGraphicOptions;
+}
+export default PopupGraphic;

package/dist/types/layer/graphicLayer.d.ts

@@ -0,0 +1,96 @@
+import { GraphicType } from '../graphic';
+import type KeyMap from '../map';
+import { Asset } from '../types';
+import * as Cesium from 'cesium';
+/**
+ * 图形图层。
+ *
+ * `GraphicLayer` 用于承载 `graphic` 模块下的 Entity 图形资产。图形添加到图层后，
+ * 图层会记录子资产信息，并把资产同步登记到 `KeyMap.Assets`，便于统一查询、显隐和销毁。
+ */
+export default class GraphicLayer {
+    /** 图层唯一 id，用于地图图层列表和资产关联。 */
+    id: string;
+    /** 图层名称，不传时自动使用 `GraphicLayer_id`。 */
+    name: string | null;
+    /** 图层类型标识。 */
+    type: string;
+    /** 当前图层关联的 Cesium Viewer，初始化前为 `null`。 */
+    viewer: Cesium.Viewer | null;
+    /** 当前图层所属的 `KeyMap` 实例，初始化前为 `null`。 */
+    map: KeyMap | null;
+    /**
+     * 图层下子资产的轻量索引。
+     *
+     * 这里只保存 id、name、type，真实资产对象存放在 `KeyMap.Assets` 中。
+     */
+    children: {
+        id: string;
+        name: string | null;
+        type: string;
+    }[];
+    /**
+     * 创建图形图层。
+     *
+     * @param opt 图层配置。
+     * @param opt.name 自定义图层名称。
+     * @param opt.id 自定义图层 id。
+     */
+    constructor(opt?: {
+        name?: string;
+        id?: string;
+    });
+    /**
+     * 初始化图层并挂载到地图。
+     *
+     * 通常由 `map.addLayer(layer)` 调用，业务侧不需要直接调用。
+     *
+     * @param map 当前地图实例。
+     */
+    init(map: KeyMap): void;
+    /**
+     * 添加图形资产到当前图层。
+     *
+     * 图形会执行自己的 `add(layer)` 方法，并在其中登记到图层和全局资产管理器。
+     *
+     * @param graphic 要添加的图形资产。
+     */
+    addGraphic(graphic: GraphicType): void;
+    /**
+     * 销毁图层。
+     *
+     * 会先移除图层下全部子资产，再从地图图层列表中删除当前图层引用。
+     */
+    destroy(): void;
+    /**
+     * 登记子资产。
+     *
+     * 通常由图形的 `add(layer)` 内部调用，会把资产加入 `KeyMap.Assets`，并在图层中保存轻量索引。
+     *
+     * @param child 要登记的子资产。
+     */
+    addChild(child: Asset): void;
+    /** 移除并销毁当前图层下的全部子资产。 */
+    removeAll(): void;
+    /**
+     * 从图层中删除指定子资产。
+     *
+     * 会同步调用 `KeyMap.Assets.removeById(id)` 销毁真实资产。
+     *
+     * @param id 子资产 id。
+     */
+    removeChild(id: string): void;
+    /**
+     * 将子资产从图层索引中解绑。
+     *
+     * 与 `removeChild()` 不同，该方法只解除图层登记并从 `KeyMap.Assets` 中 detach，
+     * 适合资产自身销毁流程中避免重复调用图层删除。
+     *
+     * @param id 子资产 id。
+     */
+    detachChild(id: string): void;
+    /** 显示当前图层下所有支持 `show()` 的子资产。 */
+    show(): void;
+    /** 隐藏当前图层下所有支持 `hide()` 的子资产。 */
+    hide(): void;
+}

package/dist/types/layer/heatmapLayer/heatmapRenderer.d.ts

@@ -0,0 +1,39 @@
+/** 负责热力图 纯canvas 的绘制 */
+import * as Cesium from 'cesium';
+/** 热力图经纬度权重点。 */
+export interface HeatmapPoint {
+    /** 经度，单位为度。 */
+    lng: number;
+    /** 纬度，单位为度。 */
+    lat: number;
+    /** 当前点权重值。 */
+    value: number;
+}
+/** 热力图渐变色节点。 */
+export interface HeatmapGradientStop {
+    /** 渐变位置，范围为 `0` 到 `1`。 */
+    offset: number;
+    /** CSS 颜色字符串。 */
+    color: string;
+}
+/** 热力图数值范围。 */
+export interface HeatmapValueRange {
+    /** 最小值，小于该值的点按最低热度处理。 */
+    min: number;
+    /** 最大值，大于该值的点按最高热度处理。 */
+    max: number;
+}
+export interface HeatmapRenderOptions {
+    readonly points: readonly HeatmapPoint[];
+    readonly rectangle: Cesium.Rectangle;
+    readonly width: number;
+    readonly height: number;
+    readonly radius: number;
+    readonly blur: number;
+    readonly gradient: readonly HeatmapGradientStop[];
+    readonly range: HeatmapValueRange;
+}
+export declare const HEATMAP_DEFAULT_GRADIENT: readonly HeatmapGradientStop[];
+export declare function resolveHeatmapRange(points: readonly HeatmapPoint[], min?: number, max?: number): HeatmapValueRange;
+/** 将经纬度权重点渲染为可作为 Cesium 图片材质使用的 canvas。 */
+export declare function renderHeatmap(canvas: HTMLCanvasElement, options: HeatmapRenderOptions): void;

package/dist/types/layer/heatmapLayer.d.ts

@@ -0,0 +1,113 @@
+import type KeyMap from '../map';
+import * as Cesium from 'cesium';
+import type { HeatmapGradientStop, HeatmapPoint, HeatmapValueRange } from './heatmapLayer/heatmapRenderer';
+export type { HeatmapGradientStop, HeatmapPoint, HeatmapValueRange } from './heatmapLayer/heatmapRenderer';
+/** 热力图图层构造参数。 */
+export interface HeatmapLayerOptions {
+    /** 图层唯一 id，不传时自动生成。 */
+    id?: string;
+    /** 图层名称，不传时自动使用 `HeatmapLayer_id`。 */
+    name?: string;
+    /** 热力图覆盖范围。 */
+    rectangle: Cesium.Rectangle;
+    /** 经纬度权重点。 */
+    points?: readonly HeatmapPoint[];
+    /** 热力图 canvas 宽度。 */
+    width?: number;
+    /** 热力图 canvas 高度。 */
+    height?: number;
+    /** 单点影响半径，单位像素。 */
+    radius?: number;
+    /** 中心实心区域比例，范围为 `0` 到 `1`。 */
+    blur?: number;
+    /** 固定最小值。实时数据建议设置，避免颜色语义漂移。 */
+    min?: number;
+    /** 固定最大值。实时数据建议设置，避免颜色语义漂移。 */
+    max?: number;
+    /** CSS 渐变色节点。 */
+    gradient?: readonly HeatmapGradientStop[];
+    /** 图层整体透明度，范围为 `0` 到 `1`。 */
+    opacity?: number;
+}
+/** 更新热力图渲染配置。 */
+export interface HeatmapRenderUpdateOptions {
+    /** 热力图覆盖范围。 */
+    rectangle?: Cesium.Rectangle;
+    /** 热力图 canvas 宽度。 */
+    width?: number;
+    /** 热力图 canvas 高度。 */
+    height?: number;
+    /** 单点影响半径，单位像素。 */
+    radius?: number;
+    /** 中心实心区域比例，范围为 `0` 到 `1`。 */
+    blur?: number;
+    /** CSS 渐变色节点。 */
+    gradient?: readonly HeatmapGradientStop[];
+    /** 图层整体透明度，范围为 `0` 到 `1`。 */
+    opacity?: number;
+}
+/**
+ * 二维热力图图层。
+ *
+ * `HeatmapLayer` 会把经纬度权重点绘制到 canvas，再作为 Cesium rectangle 图片材质贴到指定地理范围。
+ * 适合校园人流密度、区域热度等二维覆盖场景；首版不做地形贴合或 3D 拉伸。
+ */
+export default class HeatmapLayer {
+    /** 图层唯一 id。 */
+    id: string;
+    /** 图层名称。 */
+    name: string;
+    /** 图层类型标识。 */
+    type: string;
+    /** 当前图层所属的 `KeyMap` 实例，初始化前为 `null`。 */
+    map: KeyMap | null;
+    /** 当前图层关联的 Cesium Viewer，初始化前为 `null`。 */
+    viewer: Cesium.Viewer | null;
+    /** 热力图覆盖范围。 */
+    rectangle: Cesium.Rectangle;
+    /** 当前热力图数据范围。 */
+    range: HeatmapValueRange;
+    private readonly canvas;
+    private min?;
+    private max?;
+    private points;
+    private width;
+    private height;
+    private radius;
+    private blur;
+    private gradient;
+    private opacity;
+    private entity;
+    /**
+     * 创建二维热力图图层。
+     *
+     * @param opt 热力图图层配置。
+     */
+    constructor(opt: HeatmapLayerOptions);
+    /**
+     * 初始化图层并挂载到地图。
+     *
+     * 通常由 `map.addLayer(layer)` 调用。
+     *
+     * @param map 当前地图实例。
+     */
+    init(map: KeyMap): void;
+    /** 使用新的权重点数据重新渲染热力图。 */
+    setData(points: readonly HeatmapPoint[]): void;
+    /** 设置固定数值范围并重新渲染热力图。 */
+    setRange(range: HeatmapValueRange): void;
+    /** 更新覆盖范围并重新渲染热力图。 */
+    setRectangle(rectangle: Cesium.Rectangle): void;
+    /** 更新渲染参数并重新渲染热力图。 */
+    updateOptions(options: HeatmapRenderUpdateOptions): void;
+    /** 按当前配置重新绘制 canvas。 */
+    render(): void;
+    /** 显示热力图图层。 */
+    show(): void;
+    /** 隐藏热力图图层。 */
+    hide(): void;
+    /** 销毁热力图实体并解绑图层登记。 */
+    destroy(): void;
+    private updateEntityMaterial;
+    private detachLayer;
+}