@yituengine/keymap 1.0.0

package/dist/types/material/TextureFlow.d.ts

@@ -0,0 +1,94 @@
+import * as Cesium from 'cesium';
+import { EMaterialName } from '../types/general';
+/** 纹理流动材质支持的图片资源类型。 */
+export type TextureFlowImage = string | Cesium.Resource | HTMLCanvasElement | HTMLImageElement | HTMLVideoElement;
+/** `TextureFlow` 纹理流动材质传入 Cesium shader 的 uniforms。 */
+export interface TextureFlowUniforms {
+    /** 纹理图片资源。 */
+    uImage: TextureFlowImage;
+    /** 纹理在 x 方向的重复次数。 */
+    uRepeatX: number;
+    /** 纹理在 y 方向的重复次数。 */
+    uRepeatY: number;
+    /** 纹理透明度，范围通常为 `0` 到 `1`。 */
+    uOpacity: number;
+    /** 与纹理混合的基础颜色。 */
+    uColor: Cesium.Color;
+    /** 纹理流动速度。 */
+    uSpeed: number;
+}
+/** 纹理流动材质构造参数。 */
+export interface TextureFlowOptions {
+    /** 纹理图片资源，不传时使用 Cesium 默认图片。 */
+    image?: TextureFlowImage;
+    /** 纹理在 x 方向的重复次数，默认 `1`。 */
+    repeatX?: number;
+    /** 纹理在 y 方向的重复次数，默认 `1`。 */
+    repeatY?: number;
+    /** 透明度，默认 `1`。 */
+    opacity?: number;
+    /** 旧拼写兼容字段，等价于 `opacity`。 */
+    opcity?: number;
+    /** 基础颜色，支持 Cesium Color 或 CSS 颜色字符串。 */
+    color?: Cesium.Color | string;
+    /** 流动速度，默认 `1`。 */
+    speed?: number;
+}
+/**
+ * 纹理流动材质。
+ *
+ * 实现 Cesium `MaterialProperty`，通过移动纹理采样坐标形成箭头、水流、管线流动等效果。
+ */
+export default class TextureFlow implements Cesium.MaterialProperty {
+    private static registered;
+    /** Cesium MaterialProperty 标识，当前材质会随 uniforms 变化。 */
+    readonly isConstant = false;
+    /** Cesium 材质类型名称。 */
+    name: EMaterialName;
+    /** 当前材质 uniforms 状态。 */
+    uniforms: TextureFlowUniforms;
+    /** uniforms 变化时通知 Cesium 重新取值。 */
+    definitionChanged: Cesium.Event<(...args: any[]) => void>;
+    /**
+     * 创建纹理流动材质。
+     *
+     * @param opt 纹理流动材质配置。
+     */
+    constructor(opt: TextureFlowOptions);
+    private static registerMaterial;
+    private static toColor;
+    /** 纹理图片资源。赋值时会触发 `definitionChanged`。 */
+    get uImage(): TextureFlowImage;
+    set uImage(image: TextureFlowImage);
+    /** x 方向重复次数。赋值时会触发 `definitionChanged`。 */
+    get uRepeatX(): number;
+    set uRepeatX(repeatX: number);
+    /** y 方向重复次数。赋值时会触发 `definitionChanged`。 */
+    get uRepeatY(): number;
+    set uRepeatY(repeatY: number);
+    /** 透明度。赋值时会触发 `definitionChanged`。 */
+    get uOpacity(): number;
+    set uOpacity(opacity: number);
+    /** 透明度别名，兼容旧的 `uDefaultOpc` 调用。 */
+    get uDefaultOpc(): number;
+    set uDefaultOpc(opacity: number);
+    /** 基础颜色。赋值时会触发 `definitionChanged`。 */
+    get uColor(): Cesium.Color;
+    set uColor(color: Cesium.Color);
+    /** 流动速度。赋值时会触发 `definitionChanged`。 */
+    get uSpeed(): number;
+    set uSpeed(speed: number);
+    /** 返回 Cesium 材质类型名称。 */
+    getType(_time: Cesium.JulianDate): EMaterialName;
+    /**
+     * 返回当前 uniforms 值。
+     *
+     * Cesium 渲染管线会在需要材质值时调用该方法。
+     *
+     * @param _time Cesium 当前时间。
+     * @param result 可复用的结果对象。
+     */
+    getValue(_time: Cesium.JulianDate, result?: TextureFlowUniforms): TextureFlowUniforms;
+    /** 比较另一个 Cesium Property 是否与当前材质等价。 */
+    equals(other?: Cesium.Property): boolean;
+}

package/dist/types/material/Wave.d.ts

@@ -0,0 +1,75 @@
+import * as Cesium from 'cesium';
+import { EMaterialName } from '../types/general';
+/** `Wave` 扩散波纹材质传入 Cesium shader 的 uniforms。 */
+export interface WaveUniforms {
+    /** 波纹颜色。 */
+    uColor: Cesium.Color;
+    /** 波纹扩散速度。 */
+    uSpeed: number;
+    /** 同时显示的波纹圈数。 */
+    uCount: number;
+    /** 波纹渐变衰减系数。 */
+    uGradient: number;
+}
+/** 扩散波纹材质构造参数。 */
+export interface WaveOptions {
+    /** 波纹颜色，支持 Cesium Color 或 CSS 颜色字符串。 */
+    color?: Cesium.Color | string;
+    /** 波纹扩散速度，默认 `1`。 */
+    speed?: number;
+    /** 同时显示的波纹圈数，默认 `1`。 */
+    count?: number;
+    /** 旧字段别名，等价于 `count`。 */
+    repeat?: number;
+    /** 波纹渐变衰减系数，默认 `1`。 */
+    gradient?: number;
+}
+/**
+ * 扩散波纹材质。
+ *
+ * 实现 Cesium `MaterialProperty`，用于圆形、面或其他带纹理坐标的图形上生成中心向外扩散的波纹效果。
+ */
+export default class Wave implements Cesium.MaterialProperty {
+    private static registered;
+    /** Cesium MaterialProperty 标识，当前材质会随 uniforms 变化。 */
+    readonly isConstant = false;
+    /** Cesium 材质类型名称。 */
+    name: EMaterialName;
+    /** 当前材质 uniforms 状态。 */
+    uniforms: WaveUniforms;
+    /** uniforms 变化时通知 Cesium 重新取值。 */
+    definitionChanged: Cesium.Event<(...args: any[]) => void>;
+    /**
+     * 创建扩散波纹材质。
+     *
+     * @param opt 波纹材质配置。
+     */
+    constructor(opt?: WaveOptions);
+    private static registerMaterial;
+    private static toColor;
+    /** 波纹颜色。赋值时会触发 `definitionChanged`。 */
+    get uColor(): Cesium.Color;
+    set uColor(color: Cesium.Color);
+    /** 波纹扩散速度。赋值时会触发 `definitionChanged`。 */
+    get uSpeed(): number;
+    set uSpeed(speed: number);
+    /** 波纹圈数。赋值时会触发 `definitionChanged`。 */
+    get uCount(): number;
+    set uCount(count: number);
+    /** 波纹渐变衰减系数。赋值时会触发 `definitionChanged`。 */
+    get uGradient(): number;
+    set uGradient(gradient: number);
+    /** 返回 Cesium 材质类型名称。 */
+    getType(_time: Cesium.JulianDate): EMaterialName;
+    /**
+     * 返回当前 uniforms 值。
+     *
+     * Cesium 渲染管线会在需要材质值时调用该方法。
+     *
+     * @param _time Cesium 当前时间。
+     * @param result 可复用的结果对象。
+     */
+    getValue(_time: Cesium.JulianDate, result?: WaveUniforms): WaveUniforms;
+    /** 比较另一个 Cesium Property 是否与当前材质等价。 */
+    equals(other?: Cesium.Property): boolean;
+}

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

@@ -0,0 +1,20 @@
+import LightingFlow from './LightingFlow';
+import PolylineDashed from './PolylineDashed';
+import TextureFlow from './TextureFlow';
+import Wave from './Wave';
+export { default as LightingFlow } from './LightingFlow';
+export { default as PolylineDashed } from './PolylineDashed';
+export { default as TextureFlow } from './TextureFlow';
+export { default as Wave } from './Wave';
+export type { LightingFlowUniforms } from './LightingFlow';
+export type { PolylineDashedUniforms } from './PolylineDashed';
+export type { TextureFlowImage, TextureFlowOptions, TextureFlowUniforms } from './TextureFlow';
+export type { WaveOptions, WaveUniforms } from './Wave';
+export type MaterialType = LightingFlow | PolylineDashed | TextureFlow | Wave;
+declare const _default: {
+    LightingFlow: typeof LightingFlow;
+    PolylineDashed: typeof PolylineDashed;
+    TextureFlow: typeof TextureFlow;
+    Wave: typeof Wave;
+};
+export default _default;

package/dist/types/measure/baseMeasure.d.ts

@@ -0,0 +1,93 @@
+import type KeyMap from '../map';
+import * as Cesium from 'cesium';
+/**
+ * 交互式测量工具基类。
+ *
+ * 负责创建 Cesium 事件处理器和测量数据源，并统一维护测量实例在 {@link KeyMap} 中的激活、显示、清理和销毁生命周期。具体测量类型只需要实现事件注册逻辑。
+ *
+ * @typeParam TFinishCallback 测量完成时回调函数的类型。
+ */
+export default abstract class BaseMeasure<TFinishCallback> {
+    /** 测量实例的唯一标识。 */
+    id: string;
+    /** 测量实例名称，默认由类名和唯一标识组成。 */
+    name: string;
+    /** 资源类型标识，供地图资源管理器识别测量对象。 */
+    type: string;
+    /** 当前实例是否处于测量交互状态。 */
+    isMeasure: boolean;
+    /** 当前测量工具所属地图实例。 */
+    map: KeyMap;
+    /** 当前地图的 Cesium Viewer。 */
+    viewer: Cesium.Viewer;
+    /** 当前测量工具独占的屏幕事件处理器。 */
+    handler: Cesium.ScreenSpaceEventHandler;
+    /** 存放测量图形、标签和辅助实体的数据源。 */
+    dataSource: Cesium.CustomDataSource;
+    /** 测量完成回调；未设置时为 `null`。 */
+    finishCallback: TFinishCallback | null;
+    /**
+     * 创建测量工具实例。
+     *
+     * @param map 地图实例，测量实体会添加到该地图的 Viewer 中。
+     */
+    constructor(map: KeyMap);
+    /**
+     * 激活当前测量工具。
+     *
+     * 激活后会注册交互事件、将鼠标样式切换为十字光标、更新地图测量状态，并将实例加入地图资源管理器。
+     */
+    activate(): void;
+    /**
+     * 停止当前测量交互。
+     *
+     * 该方法只解除交互和状态，不会清除已经绘制到数据源中的测量结果。
+     */
+    deactivate(): void;
+    /**
+     * 设置测量完成回调。
+     *
+     * @param callback 测量完成时调用的回调函数，具体参数由子类定义。
+     */
+    setFinishCallback(callback: TFinishCallback): void;
+    /**
+     * 清空当前测量结果并移除测量数据源。
+     *
+     * 清理后实例会从地图资源管理器中解绑。
+     */
+    clear(): void;
+    /** 结束测量流程并停止交互。 */
+    measureEnd(): void;
+    /** 注销测量工具注册的鼠标事件。 */
+    unRegisterEvents(): void;
+    /** 将测量数据源重新添加到 Viewer 中以显示测量结果。 */
+    show(): void;
+    /** 从 Viewer 中移除测量数据源以隐藏测量结果。 */
+    hide(): void;
+    /** 销毁测量工具，停止交互、清理实体并注销事件。 */
+    destroy(): void;
+    /**
+     * 计算一组 Cartesian3 坐标的算术中心点。
+     *
+     * @param positions 用于计算中心点的三维坐标集合。
+     * @returns 输入坐标的 Cartesian3 算术平均位置。
+     */
+    calcCentroid(positions: Cesium.Cartesian3[]): Cesium.Cartesian3;
+    /**
+     * 从屏幕坐标拾取场景表面坐标。
+     *
+     * 优先使用 `pickPosition`，不可用时回退到地球表面射线拾取。
+     *
+     * @param windowPosition 鼠标事件中的屏幕坐标。
+     * @returns 拾取到的世界坐标；无法拾取时返回 `undefined`。
+     */
+    protected pickSurfacePosition(windowPosition: Cesium.Cartesian2): Cesium.Cartesian3 | undefined;
+    /** 激活后的子类扩展钩子。 */
+    protected onActivate(): void;
+    /** 停止交互后的子类扩展钩子。 */
+    protected onDeactivate(): void;
+    /** 清空测量结果后的子类扩展钩子。 */
+    protected onClear(): void;
+    /** 注册当前测量工具需要的鼠标事件。 */
+    protected abstract registerEvents(): void;
+}

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

@@ -0,0 +1,18 @@
+import MeasureDistance from './measureDistance';
+import MeasureCutFill from './measureCutFill';
+import MeasureHeight from './measureHeight';
+import MeasureArea from './measureArea';
+export { default as MeasureDistance } from './measureDistance';
+export { default as MeasureCutFill } from './measureCutFill';
+export { default as MeasureHeight } from './measureHeight';
+export { default as MeasureArea } from './measureArea';
+export type { CutFillResult } from './measureCutFill';
+/** SDK 内置交互式测量工具实例类型。 */
+export type MeasureType = MeasureDistance | MeasureCutFill | MeasureHeight | MeasureArea;
+declare const _default: {
+    MeasureDistance: typeof MeasureDistance;
+    MeasureCutFill: typeof MeasureCutFill;
+    MeasureHeight: typeof MeasureHeight;
+    MeasureArea: typeof MeasureArea;
+};
+export default _default;

package/dist/types/measure/measureArea.d.ts

@@ -0,0 +1,46 @@
+import type KeyMap from '../map';
+import * as Cesium from 'cesium';
+import BaseMeasure from './baseMeasure';
+/**
+ * 面积测量工具。
+ *
+ * 左键添加多边形顶点，鼠标移动预览面和边线，右键撤销上一个顶点，中键在至少三个顶点后结束测量并显示面积标签。
+ */
+export default class MeasureArea extends BaseMeasure<() => void> {
+    /** 用户左键确认的多边形顶点。 */
+    positions: Cesium.Cartesian3[];
+    /** 用于最终面积计算的固定顶点副本。 */
+    cleanPositions: Cesium.Cartesian3[];
+    /** 用于鼠标移动预览的动态顶点集合。 */
+    tempPositions: Cesium.Cartesian3[];
+    /** 面积测量边线实体。 */
+    lineEntity: Cesium.Entity | null;
+    /** 面积测量面实体。 */
+    polygonEntity: Cesium.Entity | null;
+    /** 标签高度补偿值。 */
+    height: number;
+    /**
+     * 创建面积测量工具。
+     *
+     * @param map 地图实例。
+     */
+    constructor(map: KeyMap);
+    private createPolylineEntity;
+    private createPolygonEntity;
+    private createEndEntity;
+    protected registerEvents(): void;
+    private leftClickEvent;
+    private middleClickEvent;
+    private rightClickEvent;
+    private mouseMoveEvent;
+    /**
+     * 计算多边形面积并返回带中文单位的格式化文本。
+     *
+     * 输入坐标会转换为经纬度，首尾未闭合时会自动闭合，再通过 Turf 计算面积。小于 1 平方公里时返回平方米，否则返回平方公里。
+     *
+     * @param points 多边形顶点坐标。
+     * @returns 面积文本，例如 `120.000 平方米` 或 `1.200 平方公里`。
+     */
+    calcArea(points: Cesium.Cartesian3[]): string;
+    protected onDeactivate(): void;
+}

package/dist/types/measure/measureCutFill.d.ts

@@ -0,0 +1,69 @@
+import type KeyMap from '../map';
+import * as Cesium from 'cesium';
+import BaseMeasure from './baseMeasure';
+/** 挖填方分析结果。 */
+export interface CutFillResult {
+    /** 分析区域总面积，单位为平方米。 */
+    allArea: number;
+    /** 挖方面积，单位为平方米。 */
+    cutArea: number;
+    /** 挖方体积，单位为立方米。 */
+    cutVolume: number;
+    /** 填方面积，单位为平方米。 */
+    fillArea: number;
+    /** 填方体积，单位为立方米。 */
+    fillVolume: number;
+    /** 无需挖填的面积，单位为平方米。 */
+    noArea: number;
+}
+/**
+ * 挖填方测量工具。
+ *
+ * 用户绘制多边形后，中键结束测量并执行挖填方体积分析。完成回调会收到当前分析结果；当测量未形成有效区域时结果为 `null`。
+ */
+export default class MeasureCutFill extends BaseMeasure<(result: CutFillResult | null) => void> {
+    /** 用户左键确认的分析区域顶点。 */
+    positions: Cesium.Cartesian3[];
+    /** 用于鼠标移动预览的动态区域边线顶点。 */
+    tempPositions: Cesium.Cartesian3[];
+    /** 分析基准高度，默认 100；首个拾取点有高度时会使用该高度。 */
+    height: number;
+    /** 挖填方采样精度，会根据分析区域面积动态计算。 */
+    precision: number;
+    /** 分析区域边线实体。 */
+    lineEntity: Cesium.Entity | null;
+    /** 最近一次挖填方分析结果。 */
+    result: CutFillResult | null;
+    /**
+     * 创建挖填方测量工具。
+     *
+     * @param map 地图实例。
+     */
+    constructor(map: KeyMap);
+    private createPolylineEntity;
+    /**
+     * 根据分析区域面积计算采样精度。
+     *
+     * 面积越小采样精度越高，面积较大时降低精度以控制分析成本。
+     *
+     * @param area 分析区域面积，单位为平方米。
+     * @returns 适用于挖填方分析的采样精度。
+     */
+    calcPrecision(area: number): number;
+    private createEndEntity;
+    protected registerEvents(): void;
+    private leftClickEvent;
+    private middleClickEvent;
+    private rightClickEvent;
+    private mouseMoveEvent;
+    /**
+     * 计算分析多边形面积。
+     *
+     * 输入坐标会转换为经纬度，首尾未闭合时会自动闭合，再通过 Turf 返回平方米面积。
+     *
+     * @param points 多边形顶点坐标。
+     * @returns 多边形面积，单位为平方米。
+     */
+    calcArea(points: Cesium.Cartesian3[]): number;
+    protected onDeactivate(): void;
+}

package/dist/types/measure/measureDistance.d.ts

@@ -0,0 +1,50 @@
+import type KeyMap from '../map';
+import * as Cesium from 'cesium';
+import BaseMeasure from './baseMeasure';
+/**
+ * 距离测量工具。
+ *
+ * 左键添加折线节点，鼠标移动预览下一段距离，右键撤销上一个节点，中键结束测量并固定最终折线和距离标签。
+ */
+export default class MeasureDistance extends BaseMeasure<() => void> {
+    /** 用户左键确认的折线节点。 */
+    positions: Cesium.Cartesian3[];
+    /** 用于鼠标移动预览的动态折线节点。 */
+    tempPositions: Cesium.Cartesian3[];
+    /** 已创建的节点标签和点实体。 */
+    vertexEntities: Cesium.Entity[];
+    /** 距离测量折线实体。 */
+    lineEntity: Cesium.Entity | null;
+    /** 鼠标移动过程中的临时节点实体。 */
+    moveVertexEntity: Cesium.Entity | null;
+    /** 当前累计测量距离，单位由内部距离计算工具决定。 */
+    measureDistance: number;
+    /**
+     * 创建距离测量工具。
+     *
+     * @param map 地图实例。
+     */
+    constructor(map: KeyMap);
+    private createLineEntity;
+    private createVertex;
+    private createStartEntity;
+    private createEndEntity;
+    protected registerEvents(): void;
+    private leftClickEvent;
+    private mouseMoveEvent;
+    /**
+     * 更新鼠标移动时的距离预览线。
+     *
+     * 至少存在一个固定节点时，传入位置会作为临时终点加入预览坐标。
+     *
+     * @param position 当前鼠标拾取到的世界坐标。
+     */
+    handleMoveEvent(position: Cesium.Cartesian3): void;
+    private middleClickEvent;
+    private rightClickEvent;
+    private getDistanceText;
+    private createLabelGraphics;
+    private createPointGraphics;
+    protected onActivate(): void;
+    protected onDeactivate(): void;
+}

package/dist/types/measure/measureHeight.d.ts

@@ -0,0 +1,47 @@
+import type KeyMap from '../map';
+import * as Cesium from 'cesium';
+import BaseMeasure from './baseMeasure';
+/**
+ * 高度测量工具。
+ *
+ * 通过两个拾取点构造水平、垂直和直线三段辅助线，并分别显示距离标签。
+ */
+export default class MeasureHeight extends BaseMeasure<() => void> {
+    /** 用户选择的两个测量点。 */
+    positions: Cesium.Cartesian3[];
+    /** 高度测量使用的椭球体引用。 */
+    ellipsoid: Cesium.Ellipsoid | null;
+    /**
+     * 创建高度测量工具。
+     *
+     * @param map 地图实例。
+     */
+    constructor(map: KeyMap);
+    protected registerEvents(): void;
+    private leftClickEvent;
+    private rightClickEvent;
+    /**
+     * 根据两个测量点绘制水平距离、垂直距离和直线距离辅助线及标签。
+     *
+     * 当测量点不足两个时不执行绘制。
+     */
+    drawTriangleAndLabels(): void;
+    /**
+     * 创建一条测量辅助线实体。
+     *
+     * @param start 线段起点。
+     * @param end 线段终点。
+     * @param color 线段颜色，默认黄色。
+     */
+    createLineEntity(start: Cesium.Cartesian3, end: Cesium.Cartesian3, color?: Cesium.Color): void;
+    /**
+     * 在指定位置添加测量标签。
+     *
+     * @param position 标签所在的世界坐标。
+     * @param text 标签显示文本。
+     */
+    addLabel(position: Cesium.Cartesian3, text: string): void;
+    private createPointEntity;
+    private getDistanceText;
+    protected onDeactivate(): void;
+}

package/dist/types/primitive/ClassificationPrimitive.d.ts

@@ -0,0 +1,72 @@
+import KeyMap from '../map';
+import * as Cesium from 'cesium';
+import { BasePrimitiveOptions } from './basePrimitive';
+/**
+ * 3D Tiles 单体化分类图元。
+ *
+ * 根据经纬度平面坐标和上下高度创建 Cesium `ClassificationPrimitive`，用于对 3D Tiles 指定区域进行分类显示。
+ */
+export default class ClassificationPrimitive implements BasePrimitiveOptions {
+    /** 分类图元唯一标识。 */
+    id: string;
+    /** 分类图元名称。 */
+    name: string;
+    /** 图元类型标识。 */
+    type: string;
+    /** 经纬度平面坐标数组，格式与 `Cesium.Cartesian3.fromDegreesArray` 一致。 */
+    coordinates: number[];
+    /** 分类体顶部海拔高度。 */
+    maxHeight: number;
+    /** 分类体底部海拔高度。 */
+    minHeight: number;
+    private map;
+    /** 调用方附加的业务数据。 */
+    info: any;
+    /** 更新分类图元时使用的 CSS 颜色字符串。 */
+    color: string;
+    /** 当前 Cesium 分类图元实例。 */
+    clPrimitive: Cesium.ClassificationPrimitive | null;
+    /**
+     * 创建单体化分类图元。
+     *
+     * @param opt - 分类图元配置项。
+     * @param opt.id - 图元唯一标识。
+     * @param opt.name - 图元名称；未传入时自动生成。
+     * @param opt.coordinates - 经纬度平面坐标数组。
+     * @param opt.maxHeight - 分类体顶部海拔高度。
+     * @param opt.minHeight - 分类体底部海拔高度。
+     * @param opt.info - 调用方附加的业务数据。
+     * @param opt.color - CSS 颜色字符串。
+     */
+    constructor(opt: {
+        id: string;
+        name?: string;
+        coordinates: number[];
+        maxHeight: number;
+        minHeight: number;
+        info?: any;
+        color?: string;
+    });
+    /**
+     * 将分类图元添加到地图场景和资源管理器中。
+     *
+     * @param map - 地图实例。
+     */
+    add(map: KeyMap): void;
+    /** 从地图场景和资源管理器中移除当前分类图元。 */
+    destroy(): void;
+    /** 重新创建 Cesium 分类图元以应用当前坐标、高度和颜色配置。 */
+    update(): void;
+    /**
+     * 设置分类图元颜色。
+     *
+     * Cesium 不能直接修改已有 `geometryInstances`，因此会通过重建图元来应用颜色。
+     *
+     * @param c - CSS 颜色字符串，例如 `rgba(100, 101, 255, 0.8)`。
+     */
+    setColor(c: string): void;
+    /** 显示当前 Cesium 分类图元。 */
+    show(): void;
+    /** 隐藏当前 Cesium 分类图元。 */
+    hide(): void;
+}

package/dist/types/primitive/Tube.d.ts

@@ -0,0 +1,38 @@
+import type { GraphicLayer } from '../layer';
+import type { WGS84Pos } from '../types';
+import * as Cesium from 'cesium';
+import BasePrimitive, { BasePrimitiveOptions } from './basePrimitive';
+/** 管线图元配置项。 */
+export interface TubePrimitiveOptions extends BasePrimitiveOptions {
+    /** 管线中心线的 WGS84 坐标点；未传入时使用空路径。 */
+    positions?: WGS84Pos[];
+    /** 管线圆形截面的半径。 */
+    radius?: number;
+}
+/**
+ * 管线 Primitive 图元。
+ *
+ * 通过 Cesium `PolylineVolumeGeometry` 按路径生成圆形截面的管线体。该类在模块出口中以 `TubePrimitive` 名称导出。
+ */
+export default class primitive extends BasePrimitive {
+    /** 图元类型标识。 */
+    readonly type: 'tube';
+    /** 转换后的管线路径坐标。 */
+    positions: Cesium.Cartesian3[];
+    /** 管线圆形截面的半径。 */
+    radius: number | undefined;
+    /** 管线默认颜色配置；当前几何实例颜色由 Cesium 随机色生成逻辑决定。 */
+    color: string;
+    /**
+     * 创建管线图元。
+     *
+     * @param opt - 管线图元配置项。
+     */
+    constructor(opt: TubePrimitiveOptions);
+    /**
+     * 将管线图元添加到图层和地图场景中。
+     *
+     * @param layer - 承载当前图元的图形图层。
+     */
+    add(layer: GraphicLayer): void;
+}

package/dist/types/primitive/Wall.d.ts

@@ -0,0 +1,47 @@
+import type { GraphicLayer } from '../layer';
+import type { WGS84Pos } from '../types';
+import * as Cesium from 'cesium';
+import BasePrimitive, { BasePrimitiveOptions } from './basePrimitive';
+/** 墙体图元配置项。 */
+export interface WallPrimitiveOptions extends BasePrimitiveOptions {
+    /** 墙体路径的 WGS84 坐标点。 */
+    positions: WGS84Pos[];
+    /** 墙体顶部相对底部的高度差，默认 `50.0`。 */
+    diffHeight?: number;
+    /** 墙体材质；传入后使用 Cesium `MaterialAppearance`。 */
+    material?: Cesium.Material;
+}
+/**
+ * 墙体 Primitive 图元。
+ *
+ * 通过 Cesium `WallGeometry` 按路径生成具有最小高度和最大高度的墙体。
+ */
+export default class WallPrimitive extends BasePrimitive {
+    /** 图元类型标识。 */
+    readonly type: 'wall';
+    /** 转换后的墙体路径坐标。 */
+    positions: Cesium.Cartesian3[];
+    /** 墙体顶部相对底部的高度差。 */
+    diffHeight: number;
+    /** 墙体底部高度，取第一个输入点的高度，缺省为 `0`。 */
+    minHeight: number;
+    /** 墙体顶部高度，等于 `minHeight + diffHeight`。 */
+    maxHeight: number;
+    /** 墙体材质；未传入时使用按实例颜色的外观。 */
+    material: Cesium.Material | null;
+    /** 墙体默认颜色配置；当前几何实例颜色由 Cesium 随机色生成逻辑决定。 */
+    color: string;
+    /**
+     * 创建墙体图元。
+     *
+     * @param opt - 墙体图元配置项。
+     */
+    constructor(opt: WallPrimitiveOptions);
+    /**
+     * 将墙体图元添加到图层和地图场景中。
+     *
+     * @param layer - 承载当前图元的图形图层。
+     */
+    add(layer: GraphicLayer): void;
+    private setHeightsArray;
+}