@yituengine/keymap 1.0.0

package/dist/types/effect/snowCover.d.ts

@@ -0,0 +1,50 @@
+import type KeyMap from '../map';
+import * as Cesium from 'cesium';
+/** 积雪覆盖效果配置项。 */
+export interface SnowCoverEffectOptions {
+    /** 积雪颜色，支持 CSS 颜色字符串。 */
+    color?: string;
+    /** 积雪覆盖强度，后处理阶段会将大于 `1.0` 的值限制为 `1.0`。 */
+    intensity?: number;
+    /** 是否启用积雪强度渐入动画。 */
+    isAnim?: boolean;
+}
+/**
+ * 积雪覆盖屏幕后处理效果。
+ *
+ * 根据场景深度和法线方向混合积雪颜色，可选择以定时器渐入方式提升覆盖强度。
+ */
+declare class SnowCoverEffect {
+    /** 积雪颜色。 */
+    snowColor: Cesium.Color;
+    /** 积雪覆盖强度。 */
+    intensity: number;
+    /** 是否启用积雪强度渐入动画。 */
+    isAnim: boolean;
+    private map;
+    private snowCoverStage;
+    private timer;
+    /**
+     * 创建积雪覆盖效果。
+     *
+     * @param options - 积雪覆盖效果配置项。
+     */
+    constructor(options?: SnowCoverEffectOptions);
+    /**
+     * 将积雪覆盖后处理阶段添加到地图场景中。
+     *
+     * @param map - 地图实例。
+     */
+    add(map: KeyMap): void;
+    /** 从地图场景中移除并销毁积雪覆盖后处理阶段。 */
+    destroy(): void;
+    /** 按当前目标强度启动积雪覆盖渐入动画。 */
+    snowCoverAnim(): void;
+    /**
+     * 返回积雪覆盖效果使用的 GLSL 片元着色器源码。
+     *
+     * @returns Cesium 后处理阶段使用的 shader 字符串。
+     */
+    snowCover(): string;
+}
+export default SnowCoverEffect;

package/dist/types/effect/snowFall.d.ts

@@ -0,0 +1,38 @@
+import type KeyMap from '../map';
+/** 降雪效果配置项。 */
+export interface SnowFallEffectOptions {
+    /** 雪花下落动画速度，默认 `1.0`。 */
+    speed?: number;
+}
+/**
+ * 降雪屏幕后处理效果。
+ *
+ * 通过 Cesium `PostProcessStage` 在画面上叠加动态雪花下落效果。
+ */
+declare class SnowFallEffect {
+    /** 雪花下落动画速度。 */
+    speed: number;
+    private map;
+    private snowFallStage;
+    /**
+     * 创建降雪效果。
+     *
+     * @param options - 降雪效果配置项。
+     */
+    constructor(options?: SnowFallEffectOptions);
+    /**
+     * 将降雪后处理阶段添加到地图场景中。
+     *
+     * @param map - 地图实例。
+     */
+    add(map: KeyMap): void;
+    /** 从地图场景中移除并销毁降雪后处理阶段。 */
+    destroy(): void;
+    /**
+     * 返回降雪效果使用的 GLSL 片元着色器源码。
+     *
+     * @returns Cesium 后处理阶段使用的 shader 字符串。
+     */
+    snowFall(): string;
+}
+export default SnowFallEffect;

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

@@ -0,0 +1,12 @@
+import MousePick from './mousePick';
+import Menu from './menu';
+export { default as MousePick } from './mousePick';
+export { default as Menu } from './menu';
+export type { MenuContext, MenuItem, MenuPositionedEvent } from './menu';
+/** SDK 内置地图事件交互实例类型。 */
+export type EventType = MousePick | Menu;
+declare const _default: {
+    MousePick: typeof MousePick;
+    Menu: typeof Menu;
+};
+export default _default;

package/dist/types/event/menu.d.ts

@@ -0,0 +1,110 @@
+import type KeyMap from '../map';
+import type { Asset, WGS84Pos } from '../types';
+import * as Cesium from 'cesium';
+type MenuOptions = {
+    menuId?: string;
+};
+/** 右键菜单使用的 Cesium 屏幕定位事件。 */
+export type MenuPositionedEvent = Cesium.ScreenSpaceEventHandler.PositionedEvent & {
+    /** 可选的事件传播阻止方法，存在时会在菜单打开前调用。 */
+    readonly stopPropagation?: () => void;
+};
+/**
+ * 右键菜单回调上下文。
+ *
+ * 菜单项的动态文本、显示条件、禁用条件和点击回调都会收到该上下文。
+ */
+export type MenuContext = {
+    /** 触发菜单的原始屏幕事件。 */
+    readonly event: MenuPositionedEvent;
+    /** 右键拾取位置对应的 WGS84 坐标；未拾取到地表时为 `null`。 */
+    readonly coordinate: WGS84Pos | null;
+    /** 右键拾取到的 Cesium 世界坐标；未拾取到地表时为 `null`。 */
+    readonly cartesian: Cesium.Cartesian3 | null;
+    /** 当前菜单绑定的地图实例。 */
+    readonly map: KeyMap;
+    /** 菜单使用的 DOM 元素。 */
+    readonly menu: HTMLElement;
+    /** 根据拾取对象解析出的 SDK 资源对象。 */
+    readonly specObj: Asset | null | undefined;
+    /** Cesium 原始拾取结果。 */
+    readonly pickedObj: unknown;
+};
+/** 右键菜单项配置。 */
+export type MenuItem = {
+    /** 菜单项唯一标识；重复添加同名项会替换已有项。 */
+    readonly id: string;
+    /** 菜单项文本，支持根据当前上下文动态生成。 */
+    readonly label: string | ((context: MenuContext) => string);
+    /** 菜单项排序值，默认按 `0` 处理。 */
+    readonly order?: number;
+    /** 菜单项是否显示，支持根据当前上下文动态判断。 */
+    readonly show?: boolean | ((context: MenuContext) => boolean);
+    /** 菜单项是否禁用，支持根据当前上下文动态判断。 */
+    readonly disabled?: boolean | ((context: MenuContext) => boolean);
+    /** 菜单项点击回调。 */
+    readonly onClick: (context: MenuContext) => void;
+};
+/**
+ * 地图右键上下文菜单。
+ *
+ * 绑定到 {@link KeyMap} 后监听画布右键事件，按当前拾取位置和拾取对象渲染菜单项，并在有效地表位置显示临时锚点图标。
+ */
+export default class Menu {
+    private layer;
+    /** 菜单使用的 Cesium 屏幕事件处理器。 */
+    handler: Cesium.ScreenSpaceEventHandler | null;
+    private items;
+    private currentContext;
+    private ownsMenu;
+    /** 菜单 DOM 元素；可以来自外部 `menuId`，也可以由 SDK 创建。 */
+    menu: HTMLElement | null;
+    /** 最近一次右键拾取位置对应的 WGS84 坐标。 */
+    coordinate: WGS84Pos | null;
+    private anchorLayer;
+    private anchorGraphic;
+    private readonly handleCanvasPointerDown;
+    /**
+     * 创建右键菜单实例。
+     *
+     * @param opt - 菜单配置项；传入 `menuId` 时会复用已有 DOM 元素。
+     */
+    constructor(opt?: MenuOptions);
+    /**
+     * 将菜单绑定到地图实例并注册右键、左键、滚轮和中键事件。
+     *
+     * @param layer - 地图实例。
+     */
+    register(layer: KeyMap): void;
+    /** 隐藏菜单，并清理当前上下文、坐标和菜单锚点图标。 */
+    hide(): void;
+    /**
+     * 添加或替换菜单项。
+     *
+     * 支持传入单个菜单项或菜单项数组；当 `id` 已存在时会替换旧项。若菜单当前已打开，会立即重新渲染。
+     *
+     * @param item - 要添加的菜单项或菜单项数组。
+     */
+    addItem(item: MenuItem | readonly MenuItem[]): void;
+    private setItem;
+    /**
+     * 按菜单项 id 移除菜单项。
+     *
+     * 支持传入单个 id 或 id 数组。若菜单当前已打开，会立即重新渲染。
+     *
+     * @param id - 要移除的菜单项 id 或 id 数组。
+     */
+    removeItem(id: string | readonly string[]): void;
+    /** 清空所有菜单项并隐藏菜单。 */
+    clearItems(): void;
+    private ensureMenuElement;
+    private renderItems;
+    private resolveMenuFlag;
+    private getPickedId;
+    private showMenuAt;
+    private showAnchor;
+    private destroyAnchorLayer;
+    /** 销毁菜单，移除事件监听、清空菜单项和状态，并移除 SDK 创建的菜单元素与锚点图层。 */
+    destroy(): void;
+}
+export {};

package/dist/types/event/mousePick.d.ts

@@ -0,0 +1,57 @@
+import { Asset, MousePickHandler } from '../types';
+import type KeyMap from '../map';
+import * as Cesium from 'cesium';
+/**
+ * 地图左键拾取事件管理器。
+ *
+ * 注册到 {@link KeyMap} 后监听画布左键事件，记录原始 Cesium 拾取结果、WGS84 坐标和对应 SDK 资源，并依次触发自定义拾取回调。
+ */
+export default class MousePick {
+    private map;
+    /** 当前拾取事件使用的 Cesium 屏幕事件处理器。 */
+    handler: Cesium.ScreenSpaceEventHandler | null;
+    /** 已注册的自定义拾取回调列表。 */
+    funCache: MousePickHandler[];
+    /** 最近一次拾取到的 WGS84 坐标；未拾取到位置时为 `null`。 */
+    coordinate: {
+        lng: number;
+        lat: number;
+        alt: number;
+    } | null;
+    /** 最近一次 Cesium 原始拾取结果。 */
+    pickedObj: any;
+    /** 最近一次拾取结果解析到的 SDK 资源。 */
+    pickedAsset: Asset | null;
+    /** 上一次拾取结果解析到的 SDK 资源。 */
+    lastPickedAsset: Asset | null;
+    /**
+     * 将拾取管理器绑定到地图实例。
+     *
+     * 绑定后会注册左键事件，并在每次点击时更新拾取状态、解析 SDK 资源并触发回调。
+     *
+     * @param map - 地图实例。
+     */
+    register(map: KeyMap): void;
+    /** 销毁拾取管理器，移除事件处理器并清空拾取状态和回调列表。 */
+    destroy(): void;
+    /**
+     * 从当前 Cesium 拾取结果中解析 SDK 资源 id。
+     *
+     * @returns 当前拾取对象对应的资源 id；无法解析时返回 `undefined`。
+     */
+    getPickedId(): any;
+    /**
+     * 添加自定义左键拾取回调。
+     *
+     * @param fn - 拾取回调函数。
+     */
+    addfun(fn: MousePickHandler): void;
+    /**
+     * 移除一个已注册的拾取回调。
+     *
+     * @param fn - 要移除的拾取回调函数。
+     */
+    removefun(fn: MousePickHandler): void;
+    /** 清空所有自定义拾取回调。 */
+    clearfun(): void;
+}

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

@@ -0,0 +1,131 @@
+import * as Cesium from 'cesium';
+import { GraphicLayer } from '../layer';
+import { PopupGraphicOptions } from './popupGraphic';
+import { CustomPopupGraphicOptions } from './customPopupGraphic';
+import { GraphicType } from '.';
+/**
+ * 图形资产的公共契约。
+ *
+ * 所有可添加到 `GraphicLayer` 的图形都应具备基础身份信息、Cesium 实体引用和生命周期方法。
+ */
+export interface Graphic {
+    /** 图形资产唯一 id，用于 `KeyMap.Assets` 查询、删除和图层登记。 */
+    id: string;
+    /** 图形资产名称，未传入时通常由类名和 id 自动生成。 */
+    name: string;
+    /** 图形类型标识，通常等于具体图形类名。 */
+    readonly type: string;
+    /** 图形锚点位置，常用于弹窗、标签、飞行定位或屏幕投影。 */
+    position: Cesium.Cartesian3 | null;
+    /** 图形所属业务图层，添加到图层前为 `null`。 */
+    layer: GraphicLayer | null;
+    /** 图形对应的 Cesium Entity，添加到地图前为 `null`。 */
+    entity: Cesium.Entity | null;
+    /** 将图形添加到指定图层。 */
+    add(layer: GraphicLayer): void;
+    /** 销毁图形并从图层、资产索引和 Cesium 数据源中移除。 */
+    destroy(): void;
+    /** 显示图形。 */
+    show(): void;
+    /** 隐藏图形。 */
+    hide(): void;
+    /** 将相机定位到图形对应的 Cesium Entity。 */
+    zoomTo(): void;
+    /** 将相机飞行到图形的锚点位置。 */
+    flyTo(): void;
+}
+/**
+ * 图形构造参数的公共基础字段。
+ *
+ * 具体图形会在此基础上追加 Cesium Graphic 构造参数和业务扩展参数。
+ */
+export interface BaseGraphicOptions {
+    /** 自定义资产 id；不传时自动生成。 */
+    id?: string;
+    /** 自定义资产名称；不传时自动使用 `类型_id`。 */
+    name?: string;
+    /** 图形锚点位置。 */
+    position?: Cesium.Cartesian3;
+    /** 内置弹窗配置，点击图形时可由默认交互打开。 */
+    popup?: PopupGraphicOptions;
+    /** 自定义 DOM 弹窗配置，点击图形时可由默认交互打开。 */
+    customPopup?: CustomPopupGraphicOptions;
+    /** Cesium Label 配置，会随图形一起挂到 Entity 上。 */
+    label?: Cesium.LabelGraphics.ConstructorOptions;
+    /** 图形被默认点击交互命中时触发的业务回调。 */
+    onClick?: () => void;
+    /** 开启后仅描边参与点击与悬停拾取，面填充不响应（适用于区域类图形的边框交互）。 */
+    pickOutlineOnly?: boolean;
+}
+/**
+ * Entity 图形基类。
+ *
+ * `BaseGraphic` 负责统一 id/name/type、锚点位置、弹窗、标签、显示隐藏和定位能力。
+ * 具体图形类负责实现 `add()` 与 `destroy()`，并把对应的 Cesium Graphic 挂到 Entity 上。
+ */
+export default abstract class BaseGraphic implements Graphic {
+    /** 图形资产唯一 id。 */
+    id: string;
+    /** 图形资产名称。 */
+    name: string;
+    /** 图形类型标识，默认由具体子类名生成。 */
+    readonly type: string;
+    /** 图形锚点位置。 */
+    position: Cesium.Cartesian3 | null;
+    /** 图形所属图层。 */
+    layer: GraphicLayer | null;
+    /** 图形对应的 Cesium Entity。 */
+    entity: (Cesium.Entity & {
+        parentAsset?: GraphicType;
+    }) | null;
+    /** 内置弹窗配置。 */
+    popup: PopupGraphicOptions | null;
+    /** 自定义 DOM 弹窗配置。 */
+    customPopup: CustomPopupGraphicOptions | null;
+    /** 图形标签配置生成的 Cesium LabelGraphics。 */
+    label: Cesium.LabelGraphics | null;
+    /** 图形点击回调。 */
+    onClick: (() => void) | undefined;
+    /** 是否仅描边参与点击与悬停拾取。 */
+    pickOutlineOnly: boolean;
+    /** 主图形的视距显示条件，供标签和 SDK 自建附属实体复用。 */
+    protected distanceDisplayCondition: Cesium.Property | undefined;
+    /**
+     * 创建图形基础实例。
+     *
+     * 构造时会初始化 id、name、position、popup、label 和 onClick，Cesium Entity 会在 `add()` 时创建或获取。
+     *
+     * @param opt 图形公共基础参数。
+     */
+    constructor(opt: BaseGraphicOptions);
+    /** 同步主图形视距显示条件到标签，并缓存给子类创建附属实体时复用。 */
+    protected syncDistanceDisplayCondition(distanceDisplayCondition: Cesium.Property | undefined): void;
+    /** 获取主图形视距显示条件，供子类创建 outline、hover outline 等附属实体。 */
+    protected getDistanceDisplayCondition(): Cesium.Property | undefined;
+    /** 将图形添加到指定图层。 */
+    abstract add(layer: GraphicLayer): void;
+    /** 销毁图形并释放相关资源。 */
+    abstract destroy(): void;
+    /**
+     * 将相机定位到当前图形 Entity。
+     *
+     * 默认使用俯视角和固定距离；具体子类可以覆盖该行为。
+     */
+    zoomTo(): void;
+    /**
+     * 将相机飞行到图形锚点位置。
+     *
+     * 依赖 `position`，若图形没有设置锚点位置则不会执行飞行。
+     */
+    flyTo(): void;
+    /** 显示当前图形 Entity。 */
+    show(): void;
+    /** 隐藏当前图形 Entity。 */
+    hide(): void;
+    /**
+     * 销毁当前图形关联的内置弹窗或自定义弹窗。
+     *
+     * 子类 `destroy()` 通常会先调用该方法，再移除自身 Entity。
+     */
+    destroyPopup(): void;
+}

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

@@ -0,0 +1,75 @@
+import BaseGraphic, { BaseGraphicOptions } from './baseGraphic';
+import { GraphicLayer } from '../layer';
+import * as Cesium from 'cesium';
+/**
+ * Billboard 图形构造参数。
+ *
+ * 继承 Cesium `BillboardGraphics` 参数，并追加易图引擎的图形基础字段。
+ */
+export interface BillboardGraphicOptions extends Cesium.BillboardGraphics.ConstructorOptions, BaseGraphicOptions {
+    /** 拖拽编辑结束后触发，参数为更新后的点位。 */
+    onChanged?: (position: Cesium.Cartesian3) => void;
+}
+/**
+ * 点位 Billboard 图形。
+ *
+ * 用于在地图上显示图片标记。添加到 `GraphicLayer` 后会创建 Cesium Entity，支持显示隐藏、定位、
+ * 点击回调、弹窗和单控制点拖拽编辑。
+ */
+declare class BillboardGraphic extends BaseGraphic {
+    /** 图形类型标识。 */
+    readonly type: 'BillboardGraphic';
+    /** Cesium BillboardGraphics 实例。 */
+    graphic: Cesium.BillboardGraphics;
+    /** 拖拽编辑结束后的业务回调。 */
+    onChanged: ((position: Cesium.Cartesian3) => void) | undefined;
+    private changedDuringDrag;
+    private controlPoints;
+    /**
+     * 创建 Billboard 图形。
+     *
+     * @param opt Billboard 图形配置。
+     */
+    constructor(opt: BillboardGraphicOptions);
+    /**
+     * 将 Billboard 添加到图层。
+     *
+     * `position` 是必填项，添加后 Entity 会登记到图层和全局资产管理器。
+     *
+     * @param layer 目标图层。
+     */
+    add(layer: GraphicLayer): void;
+    /** 进入编辑模式，显示唯一的点位控制点。 */
+    showHandler(): void;
+    /** 退出编辑模式，移除控制点。 */
+    clearHandler(): void;
+    private showControlPoints;
+    private clearControlPoints;
+    /**
+     * 响应控制点拖拽移动。
+     *
+     * 默认交互会调用该方法更新 Billboard 位置。
+     *
+     * @param index 控制点索引，Billboard 只接受 `0`。
+     * @param newPosition 控制点移动到的新位置。
+     */
+    onControlPointMoved(index: number, newPosition: Cesium.Cartesian3): void;
+    /**
+     * 控制点拖拽结束回调。
+     *
+     * 如果拖拽过程中位置发生变化，会触发 `onChanged`。
+     */
+    onControlPointDragEnd(): void;
+    /**
+     * 移动 Billboard 到新位置。
+     *
+     * @param position 新的 Cesium Cartesian3 位置。
+     */
+    moveTo(position: Cesium.Cartesian3): void;
+    /** 销毁 Billboard Entity、编辑控制点和关联弹窗。 */
+    destroy(): void;
+}
+declare namespace BillboardGraphic {
+    type ConstructorOptions = BillboardGraphicOptions;
+}
+export default BillboardGraphic;

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

@@ -0,0 +1,103 @@
+import BaseGraphic, { BaseGraphicOptions } from './baseGraphic';
+import * as Cesium from 'cesium';
+import { GraphicLayer } from '../layer';
+/**
+ * 圆形图形构造参数。
+ *
+ * 圆形内部使用 Cesium `EllipseGraphics` 表达，并额外维护圆心、半径和编辑描边。
+ */
+export interface CircleGraphicOptions extends Cesium.EllipseGraphics.ConstructorOptions, BaseGraphicOptions {
+    /** 圆心位置。 */
+    center: Cesium.Cartesian3;
+    /** 圆半径，单位为米。 */
+    radius: number;
+    /** 圆形标签配置。 */
+    label?: Cesium.LabelGraphics.ConstructorOptions;
+    /** 圆心或半径拖拽编辑结束后触发。 */
+    onChanged?: (center: Cesium.Cartesian3, radius: number) => void;
+    /** 常态描边宽度，传入 `0` 可关闭常态描边。 */
+    outlineWidth?: number;
+    /** 常态描边颜色，优先级低于 `outlineMaterial`。 */
+    outlineColor?: Cesium.Color;
+    /** 常态描边材质，优先级高于 `outlineColor`。 */
+    outlineMaterial?: Cesium.PolylineGraphics.ConstructorOptions['material'];
+}
+/**
+ * 可编辑圆形图形。
+ *
+ * 图形本体使用 Cesium Ellipse，SDK 额外创建 Polyline 描边以支持稳定的高亮和自定义线材质。
+ * 编辑模式下会显示圆心控制点和半径控制点。
+ */
+declare class CircleGraphic extends BaseGraphic {
+    /** 图形类型标识。 */
+    readonly type: 'CircleGraphic';
+    /** 圆心位置。 */
+    center: Cesium.Cartesian3;
+    /** 圆半径，单位为米。 */
+    radius: number;
+    /** Cesium EllipseGraphics 实例。 */
+    graphic: Cesium.EllipseGraphics;
+    /** 圆心或半径更新后的业务回调。 */
+    onChanged: ((center: Cesium.Cartesian3, radius: number) => void) | undefined;
+    private changedDuringDrag;
+    private controlPoints;
+    private isHovering;
+    private hoverOutlineEntity;
+    private outlineEntity;
+    private outlineWidth;
+    private outlineColor;
+    private outlineMaterial;
+    private outlinePositionsProperty;
+    /**
+     * 创建圆形图形。
+     *
+     * @param opt 圆形图形配置。
+     */
+    constructor(opt: CircleGraphicOptions);
+    /**
+     * 将圆形添加到图层。
+     *
+     * 添加后会创建圆形 Entity、设置圆心锚点，并创建常态描边。
+     *
+     * @param layer 目标图层。
+     */
+    add(layer: GraphicLayer): void;
+    private showOutline;
+    private clearOutline;
+    private extractOutlineColor;
+    /** 进入编辑模式，显示圆心控制点和半径控制点。 */
+    showHandler(): void;
+    /** 退出编辑模式，移除圆心和半径控制点。 */
+    clearHandler(): void;
+    private showControlPoints;
+    /** 圆心正东方向 radius 米处的坐标点（与 generateCirclePoints angle=0 公式一致） */
+    private getEastRadiusPoint;
+    /** 显示鼠标悬停高亮描边。 */
+    onMouseMoveIn(): void;
+    /** 隐藏鼠标悬停高亮描边。 */
+    onMouseMoveOut(): void;
+    private showHoverOutline;
+    private clearHoverOutline;
+    /**
+     * 响应控制点拖拽移动。
+     *
+     * `index` 为 `0` 时整体平移圆形，为 `1` 时更新半径。
+     *
+     * @param index 控制点索引。
+     * @param newPosition 控制点移动到的新位置。
+     */
+    onControlPointMoved(index: number, newPosition: Cesium.Cartesian3): void;
+    /** 拖圆心：整体平移（圆心 + 半径点 + ellipse + outline） */
+    private moveCircleTo;
+    private resizeCircleFromEdge;
+    private syncOutlinePositions;
+    /** 控制点拖拽结束回调，圆心或半径变化后触发 `onChanged`。 */
+    onControlPointDragEnd(): void;
+    private clearControlPoints;
+    /** 销毁圆形 Entity、描边、悬停高亮、编辑控制点和关联弹窗。 */
+    destroy(): void;
+}
+declare namespace CircleGraphic {
+    type ConstructorOptions = CircleGraphicOptions;
+}
+export default CircleGraphic;

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

@@ -0,0 +1,75 @@
+import * as Cesium from 'cesium';
+import BaseGraphic, { BaseGraphicOptions } from './baseGraphic';
+import { DistanceDisplayCondition } from '../types';
+import { GraphicLayer } from '../layer';
+/**
+ * 自定义 DOM 弹窗构造参数。
+ *
+ * 业务侧提供完整 DOM 容器，SDK 负责根据地图位置更新容器显示状态和屏幕位置。
+ */
+export interface CustomPopupGraphicOptions extends BaseGraphicOptions {
+    /** 业务侧提供的弹窗 DOM 容器。 */
+    container: HTMLElement;
+    /** 弹窗可视距离范围，超过范围时自动隐藏。 */
+    distance?: DistanceDisplayCondition;
+}
+/**
+ * 自定义 DOM 弹窗图形。
+ *
+ * 适合业务项目自行渲染复杂弹窗内容，SDK 只负责把 DOM 挂到页面并在每帧 postRender 中跟随地图锚点定位。
+ */
+declare class CustomPopupGraphic extends BaseGraphic {
+    /** 图形类型标识。 */
+    readonly type: 'CustomPopupGraphic';
+    /** 弹窗可视距离范围。 */
+    distance: DistanceDisplayCondition;
+    /** 弹窗 DOM 容器。 */
+    container: HTMLElement;
+    /** 弹窗是否处于业务关闭状态。 */
+    isClosed: boolean;
+    /** 地图容器左侧相对屏幕左侧的偏移。 */
+    left: number;
+    /**
+     * 创建自定义 DOM 弹窗。
+     *
+     * @param opt 自定义弹窗配置。
+     */
+    constructor(opt: CustomPopupGraphicOptions);
+    /**
+     * 将自定义弹窗添加到图层并挂载 DOM。
+     *
+     * @param layer 目标图层。
+     */
+    add(layer: GraphicLayer): void;
+    /** 销毁弹窗 DOM、postRender 监听和图层登记。 */
+    destroy(): void;
+    /** 注册 Cesium postRender 监听，用于每帧更新弹窗位置。 */
+    addListener(): void;
+    /** 移除 postRender 监听并隐藏弹窗。 */
+    clearListener(): void;
+    /** 显示弹窗。 */
+    show(): void;
+    /** 隐藏弹窗。 */
+    hide(): void;
+    /**
+     * 更新弹窗锚点或 DOM 容器。
+     *
+     * @param opt 可选更新项。
+     * @param opt.position 新锚点位置。
+     * @param opt.container 新弹窗 DOM 容器。
+     */
+    updateLabel(opt?: {
+        position?: Cesium.Cartesian3;
+        container?: HTMLElement;
+    }): void;
+    /**
+     * Cesium postRender 回调。
+     *
+     * 根据锚点屏幕坐标、相机距离和关闭状态更新 DOM 显隐与位置。
+     */
+    Postshow(): void;
+}
+declare namespace CustomPopupGraphic {
+    type ConstructorOptions = CustomPopupGraphicOptions;
+}
+export default CustomPopupGraphic;