@xingm/vmap-cesium-toolbar 0.0.6 → 1.0.1

package/dist/libs/drawHelper/BaseDraw.d.ts

@@ -1,194 +0,0 @@
-import { Viewer, Entity, Cartesian3 } from '../../../node_modules/cesium';
-import * as Cesium from "cesium";
-/**
- * 绘制结果接口
- */
-export interface DrawResult {
-    entity: Entity | null;
-    type: "line" | "polygon" | "rectangle" | "circle";
-    positions: Cartesian3[];
-    distance?: number;
-    areaKm2?: number;
-}
-/**
- * 绘制回调接口
- */
-export interface DrawCallbacks {
-    onDrawStart?: () => void;
-    onDrawEnd?: (entity: Entity | null, result: DrawResult) => void;
-    onEntityRemoved?: (entity: Entity) => void;
-    onMeasureComplete?: (result: DrawResult) => void;
-}
-/**
- * 扩展后的绘制实体类型
- * 用于在 Entity 上挂载绘图相关的元数据
- */
-export type DrawEntity = Entity & {
-    _drawType?: "line" | "polygon" | "rectangle" | "circle";
-    _drawOptions?: DrawOptions;
-    _groundPositions?: Cartesian3[];
-    _groundPosition?: Cartesian3;
-    _groundRectangle?: Cesium.Rectangle;
-    _radius?: number;
-    _borderEntity?: Entity;
-    /** 关联的测量/提示标签实体（例如面积标签） */
-    _labelEntities?: Entity[];
-    _onClick?: (entity: Entity, ...args: any[]) => void;
-    _isSelected?: boolean;
-    _originalStyle?: {
-        material?: any;
-        width?: any;
-        outlineColor?: any;
-        outlineWidth?: any;
-    };
-};
-/**
- * 绘制时可选的样式和事件回调
- */
-export interface DrawOptions {
-    strokeColor?: Cesium.Color | string;
-    strokeWidth?: number;
-    fillColor?: Cesium.Color | string;
-    outlineColor?: Cesium.Color | string;
-    outlineWidth?: number;
-    selected?: {
-        color?: Cesium.Color | string;
-        width?: number;
-        outlineColor?: Cesium.Color | string;
-        outlineWidth?: number;
-    };
-    /** 是否显示面积标签（多边形/矩形）。默认 true */
-    showAreaLabel?: boolean;
-    /** 是否显示长度标签（线条）。默认 true */
-    showDistanceLabel?: boolean;
-    /**
-     * 是否启用多边形自相交校验。
-     * - false/未设置：默认允许交叉（不做校验）
-     * - true：启用自相交校验（结合 selfIntersectionAllowTouch/AllowContinue 控制行为）
-     */
-    selfIntersectionEnabled?: boolean;
-    /**
-     * 多边形自相交校验：是否允许“擦边/顶点落在旧边上”等仅接触（touch）情况。
-     * - false/未设置：touch 也视为不合法
-     * - true：允许 touch，但仍不允许重叠（overlap）与真正穿越（cross）
-     */
-    selfIntersectionAllowTouch?: boolean;
-    /**
-     * 多边形自相交校验：当即将产生自相交时，是否仍允许继续绘制/完成绘制。
-     * - false/未设置：检测到自相交则阻止落点/阻止完成
-     * - true：检测到自相交不拦截（由业务自行承担后续面积/中心等偏差风险）
-     */
-    selfIntersectionAllowContinue?: boolean;
-    onClick?: (entity: Entity, type?: "line" | "polygon" | "rectangle" | "circle", positions?: Cartesian3[]) => void;
-}
-/**
- * 基础绘制类
- * 包含所有绘制类型的通用逻辑
- */
-export declare abstract class BaseDraw {
-    protected viewer: Viewer;
-    protected scene: Cesium.Scene;
-    protected entities: Cesium.EntityCollection;
-    protected offsetHeight: number;
-    protected originalDepthTestAgainstTerrain: boolean | null;
-    /**
-     * 当场景启用了 requestRenderMode（手动渲染）时，绘制过程中需要关闭该模式以保证动画和交互正常。
-     * 在绘制结束或取消时应恢复为原始值。
-     */
-    protected originalRequestRenderMode: boolean | null;
-    protected callbacks: DrawCallbacks;
-    protected tempPositions: Cesium.Cartesian3[];
-    protected tempEntities: Cesium.Entity[];
-    protected tempLabelEntities: Cesium.Entity[];
-    protected finishedPointEntities: Cesium.Entity[];
-    /** 当前绘制的选项（如果有） */
-    protected drawOptions?: DrawOptions;
-    /**
-     * 公开只读访问当前临时数据，供调度器使用
-     */
-    getTempPositions(): Cartesian3[];
-    getTempEntities(): Entity[];
-    getTempLabelEntities(): Entity[];
-    getFinishedPointEntities(): Entity[];
-    /**
-     * 允许调度器安全地重建临时数据
-     */
-    setTempPositions(positions: Cartesian3[]): void;
-    setTempEntities(entities: Entity[]): void;
-    setTempLabelEntities(entities: Entity[]): void;
-    /**
-     * 供调度器调用的公开包装方法
-     */
-    addPointForHelper(position: Cartesian3): void;
-    clearTempEntitiesForHelper(): void;
-    /**
-     * 清除当前绘制过程中的临时点实体
-     * 仅删除带有 point 组件的临时实体，保留其它临时线/面实体
-     */
-    clearTempPointEntitiesForHelper(): void;
-    /**
-     * 删除最后一个点并根据剩余点重建预览实体
-     * 供调度器在右键删除点时调用，具体重建逻辑仍由各子类的 updateDrawingEntity 实现
-     */
-    removeLastPointAndRedraw(): void;
-    /**
-     * 将任意颜色输入解析为 Cesium.Color
-     */
-    protected resolveColor(input?: Cesium.Color | string): Cesium.Color;
-    /**
-     * 应用/切换选中样式（统一逻辑，供调度器和子类共用）
-     */
-    protected applySelectedStyleToEntity(entity: Entity): void;
-    /**
-     * 恢复原始样式（兼容旧接口，内部仍走统一逻辑）
-     */
-    protected restoreOriginalStyleForEntity(entity: Entity): void;
-    abstract updateDrawingEntity(previewPoint?: Cesium.Cartesian3): void;
-    abstract startDrawing(options?: DrawOptions): void;
-    /**
-     * 抽象方法：完成绘制
-     */
-    abstract finishDrawing(): DrawResult | null;
-    /**
-     * 抽象方法：获取绘制类型
-     */
-    abstract getDrawType(): "line" | "polygon" | "rectangle" | "circle";
-    constructor(viewer: Viewer, callbacks?: DrawCallbacks);
-    /**
-     * 根据场景模式更新偏移高度
-     */
-    protected updateOffsetHeight(): void;
-    /**
-     * 拾取地形或椭球体上的位置
-     */
-    protected pickGlobePosition(windowPosition: Cesium.Cartesian2): Cesium.Cartesian3 | null;
-    /**
-     * 如果场景启用了 requestRenderMode（手动渲染），在开始绘制时临时关闭以保证动画/交互正常。
-     */
-    protected enableContinuousRenderingIfNeeded(): void;
-    /**
-     * 在绘制完成或取消时恢复 requestRenderMode 到原始状态（如果曾被修改过）。
-     */
-    protected restoreRequestRenderModeIfNeeded(): void;
-    /**
-     * 添加一个点到临时位置数组并创建点实体
-     */
-    protected addPoint(position: Cesium.Cartesian3): void;
-    /**
-     * 创建总长/面积标签图片
-     */
-    protected createTotalLengthBillboardImage(text: string): HTMLCanvasElement;
-    /**
-     * 创建分段长度标签图片
-     */
-    protected createSegmentLengthBillboardImage(text: string): HTMLCanvasElement;
-    /**
-     * 清理临时实体
-     */
-    protected clearTempEntities(): void;
-}
-/**
- * 静态工具方法：切换实体的选中样式
- * 用于避免在多个模块中重复实现相同逻辑
- */
-export declare function toggleSelectedStyle(entity: DrawEntity): void;

package/dist/libs/drawHelper/DrawCircle.d.ts

@@ -1,31 +0,0 @@
-import { Cartesian3 } from '../../../node_modules/cesium';
-import { BaseDraw, DrawResult, DrawOptions } from './BaseDraw';
-/**
- * 画圆绘制类
- */
-export declare class DrawCircle extends BaseDraw {
-    private currentCircleEntity;
-    private currentBorderEntity;
-    private centerPosition;
-    /**
-     * 开始绘制
-     */
-    startDrawing(options?: DrawOptions): void;
-    addPoint(position: Cartesian3): void;
-    /**
-     * 更新绘制实体（预览）
-     */
-    updateDrawingEntity(previewPoint?: Cartesian3): void;
-    /**
-     * 完成绘制
-     */
-    finishDrawing(): DrawResult | null;
-    /**
-     * 获取绘制类型
-     */
-    getDrawType(): "line" | "polygon" | "rectangle" | "circle";
-    /**
-     * 生成近似圆（多边形）顶点
-     */
-    private generateCirclePositions;
-}

package/dist/libs/drawHelper/DrawLine.d.ts

@@ -1,49 +0,0 @@
-import { Cartesian3 } from '../../../node_modules/cesium';
-import { BaseDraw, DrawResult, DrawOptions } from './BaseDraw';
-/**
- * 画线绘制类
- */
-export declare class DrawLine extends BaseDraw {
-    private currentLineEntity;
-    private currentSegmentLabels;
-    private currentTotalLabel;
-    private currentLinePositions;
-    private isTotalLabelWarmedUp;
-    private readonly avoidGroundPipeline;
-    /**
-     * 清理当前线段/总距离标签（不影响线实体本身）
-     */
-    private clearDistanceLabels;
-    /**
-     * 开始绘制
-     */
-    startDrawing(options?: DrawOptions): void;
-    /**
-     * 更新绘制实体（预览）
-     */
-    updateDrawingEntity(previewPoint?: Cartesian3): void;
-    /**
-     * 完成绘制
-     */
-    finishDrawing(): DrawResult | null;
-    /**
-     * 获取绘制类型
-     */
-    getDrawType(): "line" | "polygon" | "rectangle" | "circle";
-    /**
-     * 清理线条实体
-     */
-    private clearLineEntity;
-    /**
-     * 更新分段标签
-     */
-    private updateSegmentLabels;
-    /**
-     * 更新总距离标签
-     */
-    private updateTotalLabel;
-    /**
-     * 总长标签预热
-     */
-    private warmupTotalLengthLabel;
-}

package/dist/libs/drawHelper/DrawPolgon.d.ts

@@ -1,35 +0,0 @@
-import { Cartesian3 } from '../../../node_modules/cesium';
-import { BaseDraw, DrawResult, DrawOptions } from './BaseDraw';
-/**
- * 画多边形绘制类
- */
-export declare class DrawPolygon extends BaseDraw {
-    private currentPolygonEntity;
-    private currentBorderEntity;
-    /**
-     * 结束绘制但未生成最终结果（例如点数不足/自相交被拦截）时的统一清理。
-     * 目标：不留下临时实体/状态副作用（尤其是 depthTestAgainstTerrain）。
-     */
-    private abortFinishCleanup;
-    /**
-     * 开始绘制
-     */
-    startDrawing(options?: DrawOptions): void;
-    /**
-     * 更新绘制实体（预览）
-     */
-    updateDrawingEntity(previewPoint?: Cartesian3): void;
-    /**
-     * 完成绘制
-     */
-    finishDrawing(): DrawResult | null;
-    /**
-     * 清理所有绘制相关的实体
-     */
-    clear(): void;
-    /**
-     * 获取绘制类型
-     */
-    getDrawType(): "line" | "polygon" | "rectangle" | "circle";
-    addPoint(position: Cartesian3): void;
-}

package/dist/libs/drawHelper/DrawRectangle.d.ts

@@ -1,24 +0,0 @@
-import { Cartesian3 } from '../../../node_modules/cesium';
-import { BaseDraw, DrawResult, DrawOptions } from './BaseDraw';
-/**
- * 画矩形绘制类
- */
-export declare class DrawRectangle extends BaseDraw {
-    private currentRectangleEntity;
-    /**
-     * 开始绘制
-     */
-    startDrawing(options?: DrawOptions): void;
-    /**
-     * 更新绘制实体（预览）
-     */
-    updateDrawingEntity(previewPoint?: Cartesian3): void;
-    /**
-     * 完成绘制
-     */
-    finishDrawing(): DrawResult | null;
-    /**
-     * 获取绘制类型
-     */
-    getDrawType(): "line" | "polygon" | "rectangle" | "circle";
-}

package/dist/libs/i18n/en-US.d.ts

@@ -1,69 +0,0 @@
-declare const enUS: {
-    locale: string;
-    toolbar: {
-        search: string;
-        measure: string;
-        view2d3d: string;
-        layers: string;
-        location: string;
-        zoom_in: string;
-        zoom_out: string;
-        fullscreen: string;
-    };
-    measurement: {
-        start: string;
-        distance_done: string;
-        area_done: string;
-        cleared: string;
-        menu: {
-            area: string;
-            distance: string;
-            clear: string;
-        };
-    };
-    search: {
-        placeholder: string;
-        failed: string;
-        no_results: string;
-    };
-    layers: {
-        title: string;
-        overlay_title: string;
-        overlay: {
-            airport: string;
-        };
-        map_type: {
-            place_name: string;
-        };
-    };
-    map_type: {
-        normal: string;
-        "3d": string;
-        imagery: string;
-        terrain: string;
-    };
-    no_fly: {
-        description: string;
-    };
-    draw: {
-        hint: {
-            circle_start: string;
-            circle_radius: string;
-            rectangle_start: string;
-            rectangle_end: string;
-            finish_or_undo: string;
-            polygon_start: string;
-            polygon_add: string;
-            polygon_continue: string;
-            line_start: string;
-            line_add: string;
-            line_continue: string;
-            polygon_no_intersection: string;
-        };
-        label: {
-            total_length: string;
-            area: string;
-        };
-    };
-};
-export default enUS;

package/dist/libs/i18n/index.d.ts

@@ -1,25 +0,0 @@
-type Locale = "zh-CN" | "en-US" | (string & {});
-type I18nDict = Record<string, any>;
-interface I18nLike {
-    getLocale(): Locale;
-    setLocale(locale: Locale, options?: {
-        persist?: boolean;
-    }): void;
-    t(key: string, params?: Record<string, any>, localeOverride?: Locale): string;
-    onLocaleChange(cb: (locale: Locale) => void): () => void;
-    bindElement(el: HTMLElement, key: string, attr?: "text" | "title" | "placeholder", params?: Record<string, any>): void;
-    updateElement(el: HTMLElement): void;
-    updateTree(root: HTMLElement): void;
-    addMessages?(locale: Locale, dict: I18nDict, options?: {
-        merge?: boolean;
-    }): void;
-    setFallbackLocale?(locale: Locale): void;
-    configure?(options: {
-        persist?: boolean;
-        useStoredLocale?: boolean;
-        fallbackLocale?: Locale;
-        locale?: Locale;
-    }): void;
-}
-export declare const i18n: I18nLike;
-export type { Locale, I18nLike };

package/dist/libs/i18n/zh-CN.d.ts

@@ -1,69 +0,0 @@
-declare const zhCN: {
-    locale: string;
-    toolbar: {
-        search: string;
-        measure: string;
-        view2d3d: string;
-        layers: string;
-        location: string;
-        zoom_in: string;
-        zoom_out: string;
-        fullscreen: string;
-    };
-    measurement: {
-        start: string;
-        distance_done: string;
-        area_done: string;
-        cleared: string;
-        menu: {
-            area: string;
-            distance: string;
-            clear: string;
-        };
-    };
-    search: {
-        placeholder: string;
-        failed: string;
-        no_results: string;
-    };
-    layers: {
-        title: string;
-        overlay_title: string;
-        overlay: {
-            airport: string;
-        };
-        map_type: {
-            place_name: string;
-        };
-    };
-    map_type: {
-        normal: string;
-        "3d": string;
-        imagery: string;
-        terrain: string;
-    };
-    no_fly: {
-        description: string;
-    };
-    draw: {
-        hint: {
-            circle_start: string;
-            circle_radius: string;
-            rectangle_start: string;
-            rectangle_end: string;
-            finish_or_undo: string;
-            polygon_start: string;
-            polygon_add: string;
-            polygon_continue: string;
-            line_start: string;
-            line_add: string;
-            line_continue: string;
-            polygon_no_intersection: string;
-        };
-        label: {
-            total_length: string;
-            area: string;
-        };
-    };
-};
-export default zhCN;

package/dist/libs/overlay/MapCircle.d.ts

@@ -1,130 +0,0 @@
-import { Viewer, Entity, Color, HeightReference } from '../../../node_modules/cesium';
-import { OverlayPosition, OverlayEntity } from './types';
-import * as Cesium from "cesium";
-/**
- * Circle 选项
- */
-export interface CircleOptions {
-    position: OverlayPosition;
-    radius: number;
-    /**
-     * 渲染模式：
-     * - auto：自动选择（默认；当前实现等同于 entity）
-     * - entity：使用 Cesium Entity
-     * - primitive：使用 Cesium Primitive（为大批量静态覆盖物预留）
-     */
-    renderMode?: 'auto' | 'entity' | 'primitive';
-    material?: Cesium.MaterialProperty | Color | string;
-    outline?: boolean;
-    outlineColor?: Color | string;
-    outlineWidth?: number;
-    /**
-     * 粗边框（outlineWidth>1）模式下用于近似圆的分段数，越大越圆滑但更耗性能。
-     * 默认 256。
-     */
-    segments?: number;
-    /**
-     * 是否贴地（默认：在粗边框模式下为 true）。
-     * - true：填充与边框都贴地。
-     * - false：填充与边框都使用 position 高度悬空。
-     */
-    clampToGround?: boolean;
-    /** 贴地抬高量（米，clampToGround=true 时生效） */
-    groundHeightEpsilon?: number;
-    heightReference?: HeightReference;
-    extrudedHeight?: number;
-    heightEpsilon?: number;
-    /** 点击该覆盖物时是否高亮显示（默认 false）。支持传入自定义颜色等参数 */
-    clickHighlight?: boolean | {
-        color?: Color | string;
-        fillAlpha?: number;
-    };
-    /** 鼠标移入该覆盖物时是否高亮显示（默认 false）。支持传入自定义颜色等参数 */
-    hoverHighlight?: boolean | {
-        color?: Color | string;
-        fillAlpha?: number;
-    };
-    onClick?: (entity: Entity) => void;
-    /**
-     * Primitive 模式分层渲染 key。
-     * - 相同 layerKey 的 circle 会被合并到同一个批次中（更高性能）
-     * - 不同 layerKey 会进入不同的“图层空间”，并按首次出现顺序确定上下层
-     * - 只对 primitive 生效；entity 模式忽略
-     */
-    layerKey?: string;
-    id?: string;
-}
-/**
- * Circle 工具类
- */
-export declare class MapCircle {
-    private viewer;
-    private entities;
-    private primitiveBatch;
-    private primitiveLayerStack;
-    private primitiveBatchesByLayer;
-    private static bearingTableCache;
-    constructor(viewer: Viewer);
-    private getPrimitiveBatch;
-    private getLayeredPrimitiveBatch;
-    private getPrimitiveBatchForOverlay;
-    private resolveMaterialColor;
-    private canUsePrimitive;
-    /**
-     * 添加一个基础的圆形图元
-     * @param options 圆形配置选项
-     * @returns 返回创建的实体对象
-     */
-    private addPrimitiveCircle;
-    /**
-     * 转换位置为 Cartesian3
-     */
-    private convertPosition;
-    /**
-     * 转换颜色
-     */
-    private resolveColor;
-    /**
-     * 解析材质
-     */
-    private resolveMaterial;
-    /**
-     * 添加 Circle（圆形）
-     */
-    add(options: CircleOptions): Entity;
-    /**
-     * 生成近似圆（多边形）顶点，返回 Cartesian3 数组。
-     * 使用大圆航线公式，segments 越大越平滑。
-     */
-    private generateCirclePositions;
-    /**
-     * 获取方位角查找表，用于存储正弦和余弦值
-     * @param segments 分段数量，用于确定查找表的精度
-     * @returns 返回一个包含正弦和余弦数组的对象
-     */
-    private getBearingTable;
-    /**
-     * 粗边框模式的默认分段数：平衡“圆滑程度/性能”。
-     * 用户如果传了 options.segments，则完全尊重用户设置。
-     */
-    private getDefaultSegmentsForRadius;
-    /**
-     * 更新 Circle 位置
-     */
-    updatePosition(entity: Entity, position: OverlayPosition): void;
-    /**
-     * 更新 Circle 半径
-     */
-    updateRadius(entity: Entity, radius: number): void;
-    /**
-     * 更新 Circle 样式
-     */
-    updateStyle(entity: Entity, options: Partial<Pick<CircleOptions, 'material' | 'outline' | 'outlineColor' | 'outlineWidth'>>): void;
-    /**
-     * 移除 Circle（通过实体或实体 id）
-     */
-    remove(entityOrId: Entity | string): boolean;
-    setPrimitiveVisible(entity: Entity, visible: boolean): void;
-    applyPrimitiveHighlight(entity: OverlayEntity, hlColor: Cesium.Color, fillAlpha: number): void;
-    restorePrimitiveHighlight(entity: OverlayEntity): void;
-}

package/dist/libs/overlay/MapIcon.d.ts

@@ -1,69 +0,0 @@
-import { Viewer, Entity, Color, HeightReference, VerticalOrigin, HorizontalOrigin } from '../../../node_modules/cesium';
-import { OverlayPosition } from './types';
-import * as Cesium from "cesium";
-/**
- * Icon 选项
- */
-export interface IconOptions {
-    position: OverlayPosition;
-    image: string;
-    width?: number;
-    height?: number;
-    scale?: number;
-    rotation?: number;
-    pixelOffset?: Cesium.Cartesian2;
-    eyeOffset?: Cesium.Cartesian3;
-    horizontalOrigin?: HorizontalOrigin;
-    verticalOrigin?: VerticalOrigin;
-    heightReference?: HeightReference;
-    disableDepthTestDistance?: number;
-    color?: Color | string;
-    /** 点击该覆盖物时是否高亮显示（默认 false）。支持传入自定义颜色等参数 */
-    clickHighlight?: boolean | {
-        color?: Color | string;
-        fillAlpha?: number;
-    };
-    /** 鼠标移入该覆盖物时是否高亮显示（默认 false）。支持传入自定义颜色等参数 */
-    hoverHighlight?: boolean | {
-        color?: Color | string;
-        fillAlpha?: number;
-    };
-    onClick?: (entity: Entity) => void;
-    id?: string;
-}
-/**
- * Icon 工具类
- */
-export declare class MapIcon {
-    private viewer;
-    private entities;
-    constructor(viewer: Viewer);
-    /**
-     * 转换位置为 Cartesian3
-     */
-    private convertPosition;
-    /**
-     * 转换颜色
-     */
-    private resolveColor;
-    /**
-     * 添加 Icon（图标，使用 Billboard）
-     */
-    add(options: IconOptions): Entity;
-    /**
-     * 更新 Icon 位置
-     */
-    updatePosition(entity: Entity, position: OverlayPosition): void;
-    /**
-     * 更新 Icon 图片
-     */
-    updateImage(entity: Entity, image: string): void;
-    /**
-     * 更新 Icon 样式
-     */
-    updateStyle(entity: Entity, options: Partial<Pick<IconOptions, 'scale' | 'rotation' | 'color'>>): void;
-    /**
-     * 移除 Icon（通过实体或实体 id）
-     */
-    remove(entityOrId: Entity | string): boolean;
-}