@xingm/vmap-cesium-toolbar 0.0.2-alpha.17 → 0.0.2-alpha.18

package/dist/libs/CesiumAutoRecover.d.ts

@@ -0,0 +1,48 @@
+import { Viewer } from '../../node_modules/cesium';
+export interface CesiumAutoRecoverOptions {
+    /** 是否启用自动恢复（默认 false） */
+    enabled?: boolean;
+    /** 最大恢复次数（默认 3） */
+    maxRetries?: number;
+    /** 两次恢复之间的最小间隔（默认 5000ms） */
+    cooldownMs?: number;
+    /** 恢复后是否尝试保留相机视角（默认 true） */
+    preserveCamera?: boolean;
+    /**
+     * 触发恢复的原因与错误信息
+     * - reason: renderError/widgetError/watchdog/windowError 等
+     */
+    onRecovering?: (ctx: {
+        reason: string;
+        error?: unknown;
+        attempt: number;
+    }) => void;
+    /** 恢复成功回调：业务侧应在这里替换引用（非常重要） */
+    onRecovered?: (ctx: {
+        reason: string;
+        error?: unknown;
+        attempt: number;
+        oldViewer: Viewer;
+        newViewer: Viewer;
+    }) => void;
+    /**
+     * 渲染“静默停止”监测：有些错误不一定走 renderError，但会导致不再 postRender。
+     * 注意：若开启了 requestRenderMode（按需渲染），默认不建议启用 watchdog。
+     */
+    watchdog?: {
+        enabled?: boolean;
+        /** 多久没有 postRender 认为卡死（默认 6000ms） */
+        staleMs?: number;
+        /** 检查间隔（默认 2000ms） */
+        checkIntervalMs?: number;
+    };
+}
+type CreateViewer = () => Promise<Viewer>;
+/**
+ * 为已有 Viewer 安装自动恢复：遇到“Rendering has stopped”/NaN render error 等，自动重建 Viewer。
+ * 重要：重建会产生新的 Viewer 实例，业务侧必须在 onRecovered 里替换引用。
+ */
+export declare function enableCesiumAutoRecover(viewer: Viewer, createViewer: CreateViewer, options: CesiumAutoRecoverOptions): {
+    dispose: () => void;
+};
+export {};

package/dist/libs/CesiumHeatmapLayer.d.ts

@@ -18,6 +18,8 @@ export interface HeatmapOptions {
     /** Canvas 分辨率，越大越清晰但开销越大 */
     width?: number;
     height?: number;
+    /** 渲染模式：heat 为热力渐变（默认）；discrete 为严格分段纯色 */
+    mode?: "heat" | "discrete";
     /** 单个点的影响半径（像素） */
     radius?: number;
     /** 低强度提升（伽马矫正），< 1 可增强边缘，默认 0.7 */
@@ -31,6 +33,20 @@ export interface HeatmapOptions {
     opacity?: number;
     /** 颜色梯度 */
     gradient?: HeatmapGradient;
+    /**
+     * 严格分段（仅 mode=discrete 生效）：
+     * thresholds.length + 1 必须等于 colors.length。
+     * 例如 thresholds=[40,60,90,110] colors=[蓝,青,绿,黄,红]
+     * - value < 40 -> colors[0]
+     * - 40 <= value < 60 -> colors[1]
+     * - 60 <= value < 90 -> colors[2]
+     * - 90 <= value < 110 -> colors[3]
+     * - value >= 110 -> colors[4]
+     */
+    discreteThresholds?: number[];
+    discreteColors?: string[];
+    /** 重叠像素的决策：max=取更高分段（默认）；last=后绘制覆盖 */
+    discreteOverlap?: "max" | "last";
 }
 export interface HeatmapAutoUpdateOptions {
     /** 是否启用随视角变化自动重绘（默认 true） */
@@ -64,7 +80,11 @@ export default class CesiumHeatmapLayer {
     private workerReady;
     private pendingUpdate;
     private lastUpdateKey;
+    private handleWorkerFault;
     constructor(viewer: Cesium.Viewer, options?: HeatmapOptions);
+    private parseColorToRGBA;
+    private getDiscreteBucketIndex;
+    private renderDiscrete;
     /**
      * 设置/替换热力图数据（度为单位）
      */

package/dist/libs/CesiumMapLoader.d.ts

@@ -1,4 +1,5 @@
 import { Viewer as CesiumViewer, Terrain, TerrainProvider } from '../../node_modules/cesium';
+import { CesiumAutoRecoverOptions } from './CesiumAutoRecover';
 import * as Cesium from 'cesium';
 interface InitOptions {
     orderIndependentTranslucency?: boolean;
@@ -50,6 +51,8 @@ interface InitOptions {
     success?: () => void;
     cancel?: () => void;
     mapCenter?: MapCenter;
+    /** 渲染异常自动恢复（可选）：会重建 Viewer，需在回调里替换引用 */
+    autoRecover?: CesiumAutoRecoverOptions;
 }
 interface MapCenter {
     latitude: number;

package/dist/libs/CesiumOverlayService.d.ts

@@ -22,8 +22,37 @@ export declare class CesiumOverlayService {
     private lastHoverTargets;
     private hoverPickRAF;
     private hoverPickPos;
+    private overlayMutationRevision;
+    private hoverSuspendUntil;
+    private lastHoverPickTime;
+    private lastHoverPickPos;
+    private bulkUpdateDepth;
     private static readonly DEFAULT_HIGHLIGHT_COLOR;
     private static readonly DEFAULT_HIGHLIGHT_FILL_ALPHA;
+    private static readonly HOVER_PICK_MIN_INTERVAL_MS;
+    private static readonly HOVER_PICK_MIN_MOVE_PX;
+    private static readonly HOVER_SUSPEND_AFTER_MUTATION_MS;
+    private markOverlayMutated;
+    /**
+     * 显式开始一次批量更新：在 begin/end 期间暂停 hover pick。
+     * 建议 websocket 批量 add/remove 覆盖物时包裹使用，降低 Cesium GroundPrimitive 异步重建窗口期的 pick/update 压力。
+     */
+    beginBulkUpdate(): void;
+    /**
+     * 结束一次批量更新。
+     */
+    endBulkUpdate(): void;
+    /**
+     * 批量更新包裹器（自动 begin/end）。
+     */
+    bulkUpdate<T>(fn: () => T): T;
+    /**
+     * Primitive 模式下，GeometryInstance.id 会是字符串（structured-cloneable），
+     * 需要映射回 overlayMap 内的根覆盖物 id。
+     */
+    private normalizeOverlayPickId;
+    private resolveOverlayByPickId;
+    private resolvePickedOverlayEntity;
     readonly marker: MapMarker;
     readonly label: MapLabel;
     readonly icon: MapIcon;

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

@@ -6,6 +6,11 @@ import { BaseDraw, DrawResult, DrawOptions } from './BaseDraw';
 export declare class DrawPolygon extends BaseDraw {
     private currentPolygonEntity;
     private currentBorderEntity;
+    /**
+     * 结束绘制但未生成最终结果（例如点数不足/自相交被拦截）时的统一清理。
+     * 目标：不留下临时实体/状态副作用（尤其是 depthTestAgainstTerrain）。
+     */
+    private abortFinishCleanup;
     /**
      * 开始绘制
      */

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

@@ -8,6 +8,7 @@ interface I18nLike {
     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;

package/dist/libs/overlay/primitives/CirclePrimitiveLayerStack.d.ts

@@ -5,13 +5,13 @@ export interface CirclePrimitiveLayerCollections {
     ringCollection: Cesium.PrimitiveCollection;
 }
 /**
- * Maintains a stable, ordered layer stack for Circle primitive rendering.
+ * 为 Circle（圆）Primitive 渲染维护一个稳定的有序图层栈。
  *
- * Rendering order:
- * - all fill layers (bottom -> top)
- * - all ring layers (bottom -> top)
+ * 渲染顺序：
+ * - 所有填充图层（从下到上）
+ * - 所有外环图层（从下到上）
  *
- * This ensures boundaries (rings) remain visible even when multiple translucent fills overlap.
+ * 这样可以确保在存在多个半透明填充重叠时，外环边界仍然清晰可见。
  */
 export declare class CirclePrimitiveLayerStack {
     private viewer;

package/dist/libs/overlay/primitives/PolygonPrimitiveLayerStack.d.ts

@@ -5,13 +5,13 @@ export interface PolygonPrimitiveLayerCollections {
     borderCollection: Cesium.PrimitiveCollection;
 }
 /**
- * Maintains a stable, ordered layer stack for Polygon primitive rendering.
+ * 为 Polygon（多边形）Primitive 渲染维护一个稳定的有序图层栈。
  *
- * Rendering order:
- * - all fill layers (bottom -> top)
- * - all border layers (bottom -> top)
+ * 渲染顺序：
+ * - 所有填充图层（从下到上）
+ * - 所有边框图层（从下到上）
  *
- * This ensures borders remain visible even when multiple translucent fills overlap.
+ * 这样可以确保在存在多个半透明填充重叠时，边框仍然清晰可见。
  */
 export declare class PolygonPrimitiveLayerStack {
     private viewer;

package/dist/libs/toolBar/MapToolBarConfig.d.ts

@@ -1,3 +1,10 @@
-import { ButtonConfig } from '../CesiumMapModel';
+import { ButtonConfig, ToolbarConfig } from '../CesiumMapModel';
 export declare const defaultButtonSorts: Record<string, number>;
 export declare const defaultButtons: ButtonConfig[];
+export declare const defaultMeasureItems: {
+    id: string;
+    text: string;
+    textKey: string;
+    icon: string;
+}[];
+export declare const defaultToolBarStyle: ToolbarConfig;

package/dist/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@xingm/vmap-cesium-toolbar",
-  "version": "0.0.2-alpha.17",
+  "version": "0.0.2-alpha.18",
   "description": "A powerful Cesium map toolbar plugin with drawing, measurement, and interaction features",
   "type": "module",
-  "main": "index.js",
-  "module": "index.js",
+  "main": "index.es.js",
+  "module": "index.es.js",
   "types": "index.d.ts",
   "files": [
-    "index.js",
+    "index.es.js",
+    "index.umd.js",
     "index.d.ts",
     "style.css",
     "README.md",
@@ -15,8 +16,8 @@
   ],
   "exports": {
     ".": {
-      "import": "./index.js",
-      "types": "./index.d.ts"
+      "import": "./index.es.js",
+      "default": "./index.es.js"
     },
     "./style": "./style.css"
   },

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@xingm/vmap-cesium-toolbar",
-  "version": "0.0.2-alpha.17",
+  "version": "0.0.2-alpha.18",
   "description": "A powerful Cesium map toolbar plugin with drawing, measurement, and interaction features",
   "type": "module",
-  "main": "dist/index.js",
-  "module": "dist/index.js",
+  "main": "dist/index.es.js",
+  "module": "dist/index.es.js",
   "types": "dist/index.d.ts",
   "files": [
     "dist",
@@ -15,14 +15,15 @@
   },
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "import": "./dist/index.es.js",
+      "default": "./dist/index.es.js"
     },
     "./style": "./dist/style.css"
   },
   "scripts": {
     "dev": "vite --force",
     "build": "vite build --mode lib",
+    "dist": "vite build",
     "build:dts": "vue-tsc -p tsconfig.dts.json",
     "build:plugin": "node scripts/build-plugin.js",
     "docs:dev": "vitepress dev doc",