@soonspacejs/plugin-tiles 2.15.4 → 2.15.5

package/dist/terrain-tiles-renderer/OverlayManager.d.ts

@@ -1,6 +1,6 @@
-import { ImageOverlayPlugin, GeoJSONOverlay, CesiumIonOverlay, TMSTilesOverlay, XYZTilesOverlay, WMSTilesOverlay, WMTSTilesOverlay, UrlTemplateTilesOverlay } from 'um-3d-tiles-renderer/plugins';
+import { ImageOverlayPlugin, StyledGeoJSONOverlay, CesiumIonOverlay, TMSTilesOverlay, XYZTilesOverlay, WMSTilesOverlay, WMTSTilesOverlay, UrlTemplateTilesOverlay } from 'um-3d-tiles-renderer/plugins';
 import { ResourceManager } from './ResourceManager';
-import { IGeoJSONOverlayOptions, ICesiumIonOverlayOptions, ITMSTilesOverlayOptions, IXYZTilesOverlayOptions, IWMSTilesOverlayOptions, IWMTSTilesOverlayOptions, IUrlTemplateOverlayOptions } from './types';
+import { IGeoJSONOverlayOptions, IGeoJSONFeatureStyle, GeoJSONOverlayMode, ICesiumIonOverlayOptions, ITMSTilesOverlayOptions, IXYZTilesOverlayOptions, IWMSTilesOverlayOptions, IWMTSTilesOverlayOptions, IUrlTemplateOverlayOptions } from './types';
 /**
  * OverlayManager - Overlay 实例管理器
  *
@@ -15,13 +15,24 @@ export declare class OverlayManager {
     /** 存储所有 overlay 实例 */
     private static readonly MAX_OVERLAY_INSTANCES;
     private _instances;
+    private _geoJSONUtilityOverlay;
     constructor(imageOverlayPlugin: ImageOverlayPlugin | undefined, resourceManager?: ResourceManager | undefined);
-    addGeoJSONOverlay(options: IGeoJSONOverlayOptions): GeoJSONOverlay | null;
+    addGeoJSONOverlay(options: IGeoJSONOverlayOptions): StyledGeoJSONOverlay | null;
     updateGeoJSONColor(id: string, color: string): boolean;
+    updateGeoJSONDefaultStyle(id: string, stylePatch: IGeoJSONFeatureStyle): boolean;
     updateGeoJSONStrokeStyle(id: string, strokeStyle: string): boolean;
     updateGeoJSONStrokeWidth(id: string, strokeWidth: number): boolean;
     updateGeoJSONFillStyle(id: string, fillStyle: string): boolean;
-    updateGeoJSONMode(id: string, mode: 'overlay' | 'mask' | 'invertMask'): boolean;
+    updateGeoJSONMode(id: string, mode: GeoJSONOverlayMode): boolean;
+    setGeoJSON(id: string, geojson: object): boolean;
+    normalizeGeoJSON(geojson: any): any;
+    mergeGeoJSON(geojsonList: ReadonlyArray<any>): any;
+    setMergedGeoJSON(id: string, geojsonList: ReadonlyArray<any>, options?: {
+        redraw?: boolean;
+    }): any | null;
+    getGeoJSONFeatureById(id: string, featureId: string | number): any | null;
+    updateGeoJSONFeatureStyleById(id: string, featureId: string | number, stylePatch: IGeoJSONFeatureStyle): boolean;
+    updateGeoJSONFeatureStylesByIds(id: string, featureIds: Array<string | number>, stylePatch: IGeoJSONFeatureStyle): boolean;
     addCesiumIonOverlay(options: ICesiumIonOverlayOptions): CesiumIonOverlay | null;
     addTMSOverlay(options: ITMSTilesOverlayOptions): TMSTilesOverlay | null;
     addXYZOverlay(options: IXYZTilesOverlayOptions): XYZTilesOverlay | null;
@@ -111,6 +122,10 @@ export declare class OverlayManager {
      * 获取 overlay 数量
      */
     get count(): number;
+    private _buildGeoJSONDefaultStyle;
+    private _getGeoJSONModeFlags;
+    private _getGeoJSONUtilityOverlay;
+    private _updateOverlayOptions;
     private _getImageOverlayPluginForAdd;
     /**
      * 获取本地影像数量（不依赖 ResourceManager）

package/dist/terrain-tiles-renderer/ResourceManager.d.ts

@@ -1,11 +1,11 @@
-import { IGeoJSONOverlayOptions, ICesiumIonOverlayOptions, ITMSTilesOverlayOptions, IXYZTilesOverlayOptions, IWMSTilesOverlayOptions, IWMTSTilesOverlayOptions, OverlayType } from './types';
+import { IGeoJSONOverlayOptions, ICesiumIonOverlayOptions, ITMSTilesOverlayOptions, IXYZTilesOverlayOptions, IWMSTilesOverlayOptions, IWMTSTilesOverlayOptions, IUrlTemplateOverlayOptions, OverlayType } from './types';
 /**
  * Overlay 资源配置
  */
 export interface IOverlayResource {
     id: string;
     type: OverlayType;
-    options: IGeoJSONOverlayOptions | ICesiumIonOverlayOptions | ITMSTilesOverlayOptions | IXYZTilesOverlayOptions | IWMSTilesOverlayOptions | IWMTSTilesOverlayOptions;
+    options: IGeoJSONOverlayOptions | ICesiumIonOverlayOptions | ITMSTilesOverlayOptions | IXYZTilesOverlayOptions | IWMSTilesOverlayOptions | IWMTSTilesOverlayOptions | IUrlTemplateOverlayOptions;
 }
 /**
  * ResourceManager 资源管理器

package/dist/terrain-tiles-renderer/TerrainTilesRenderer.d.ts

@@ -5,7 +5,7 @@ import { TileCustomMaterialPlugin } from './plugins';
 import { OverlayManager } from './OverlayManager';
 import { ResourceManager } from './ResourceManager';
 import { TerrainManager } from './TerrainManager';
-import { ITerrainTilesRendererOptions, IGeoJSONOverlayOptions, ICesiumIonOverlayOptions, ITMSTilesOverlayOptions, IXYZTilesOverlayOptions, IWMSTilesOverlayOptions, IWMTSTilesOverlayOptions, IUrlTemplateOverlayOptions, AlphaClipMode, ITerrainConfig } from './types';
+import { ITerrainTilesRendererOptions, IGeoJSONOverlayOptions, ICesiumIonOverlayOptions, ITMSTilesOverlayOptions, IXYZTilesOverlayOptions, IWMSTilesOverlayOptions, IWMTSTilesOverlayOptions, IUrlTemplateOverlayOptions, IGeoJSONFeatureStyle, GeoJSONOverlayMode, AlphaClipMode, ITerrainConfig } from './types';
 import { GroundDecalManager } from '../plot/GroundDecalManager';
 /**
  * TerrainTilesRenderer 地形渲染器
@@ -118,7 +118,7 @@ export declare class TerrainTilesRenderer {
      * @param options Overlay 配置选项，必须包含 type 字段
      * @returns Overlay 实例或 null（如果添加失败）
      */
-    addOverlay(options: IGeoJSONOverlayOptions | ICesiumIonOverlayOptions | IGeoJSONOverlayOptions | ITMSTilesOverlayOptions | IXYZTilesOverlayOptions | IWMSTilesOverlayOptions | IWMTSTilesOverlayOptions | IUrlTemplateOverlayOptions): Promise<import('um-3d-tiles-renderer/plugins').XYZTilesOverlay | import('um-3d-tiles-renderer/plugins').GeoJSONOverlay | import('um-3d-tiles-renderer/plugins').CesiumIonOverlay | import('um-3d-tiles-renderer/plugins').TMSTilesOverlay | import('um-3d-tiles-renderer/plugins').UrlTemplateTilesOverlay | import('um-3d-tiles-renderer/plugins').WMSTilesOverlay | import('um-3d-tiles-renderer/plugins').WMTSTilesOverlay | null>;
+    addOverlay(options: IGeoJSONOverlayOptions | ICesiumIonOverlayOptions | ITMSTilesOverlayOptions | IXYZTilesOverlayOptions | IWMSTilesOverlayOptions | IWMTSTilesOverlayOptions | IUrlTemplateOverlayOptions): Promise<import('um-3d-tiles-renderer/plugins').XYZTilesOverlay | import('um-3d-tiles-renderer/plugins').StyledGeoJSONOverlay | import('um-3d-tiles-renderer/plugins').CesiumIonOverlay | import('um-3d-tiles-renderer/plugins').TMSTilesOverlay | import('um-3d-tiles-renderer/plugins').UrlTemplateTilesOverlay | import('um-3d-tiles-renderer/plugins').WMSTilesOverlay | import('um-3d-tiles-renderer/plugins').WMTSTilesOverlay | null>;
     /**
      * 移除指定 overlay
      */
@@ -133,7 +133,7 @@ export declare class TerrainTilesRenderer {
      * - mask: 只显示 GeoJSON 区域内的地形
      * - invertMask: 只显示 GeoJSON 区域外的地形
      */
-    updateGeoJSONMode(id: string, mode: 'overlay' | 'mask' | 'invertMask'): boolean;
+    updateGeoJSONMode(id: string, mode: GeoJSONOverlayMode): boolean;
     /**
      * 更新 GeoJSON 描边样式
      */
@@ -146,12 +146,33 @@ export declare class TerrainTilesRenderer {
      * 更新 GeoJSON 填充样式
      */
     updateGeoJSONFillStyle(id: string, fillStyle: string): boolean;
+    /**
+     * 更新 StyledGeoJSONOverlay 的默认 feature 样式
+     */
+    updateGeoJSONDefaultStyle(id: string, stylePatch: IGeoJSONFeatureStyle): boolean;
+    /**
+     * 替换 GeoJSON 数据
+     */
+    setGeoJSON(id: string, geojson: object): boolean;
+    /**
+     * 合并多个 GeoJSON 后替换指定 StyledGeoJSONOverlay 的数据
+     */
+    setMergedGeoJSON(id: string, geojsonList: ReadonlyArray<any>, options?: {
+        redraw?: boolean;
+    }): any | null;
+    getGeoJSONFeatureById(id: string, featureId: string | number): any | null;
+    updateGeoJSONFeatureStyleById(id: string, featureId: string | number, stylePatch: IGeoJSONFeatureStyle): boolean;
+    updateGeoJSONFeatureStylesByIds(id: string, featureIds: Array<string | number>, stylePatch: IGeoJSONFeatureStyle): boolean;
+    /**
+     * 将任意 GeoJSON 根对象规范化为 FeatureCollection
+     */
+    normalizeGeoJSON(geojson: any): any;
     /**
      * 合并多个 GeoJSON
      * @param geojsons 待合并的 GeoJSON 数组
      * @returns 合并后的 GeoJSON
      */
-    mergeGeoJSON(geojsons: any[]): import('geojson-merge-ts').GeoJSONFeatureCollection;
+    mergeGeoJSON(geojsons: ReadonlyArray<any>): any;
     /**
      * 设置 overlay 层级顺序
      * @param id overlay ID

package/dist/terrain-tiles-renderer/types.d.ts

@@ -88,16 +88,65 @@ export interface IOverlayBaseOptions {
 /**
  * GeoJSON Overlay 配置
  */
+export interface IGeoJSONFeatureStyle {
+    visible?: boolean;
+    zIndex?: number;
+    opacity?: number;
+    fillStyle?: string | null;
+    fillOpacity?: number;
+    strokeStyle?: string | null;
+    strokeWidth?: number;
+    strokeOpacity?: number;
+    lineDash?: number[];
+    lineCap?: CanvasLineCap;
+    lineJoin?: CanvasLineJoin;
+    pointRadius?: number;
+    pointOpacity?: number;
+    pointFillStyle?: string | null;
+    pointStrokeStyle?: string | null;
+    pointStrokeWidth?: number | null;
+}
+export type GeoJSONOverlayMode = 'overlay' | 'mask' | 'invertMask';
 export interface IGeoJSONOverlayOptions extends IOverlayBaseOptions {
     /** GeoJSON 文件 URL 或 GeoJSON 数据对象 */
     url?: string;
     geojson?: object;
+    /** Canvas resolution for each rasterized GeoJSON overlay tile */
+    resolution?: number;
+    /** Legacy alias for resolution */
+    tileDimension?: number;
+    /** Default feature style used by StyledGeoJSONOverlay */
+    defaultStyle?: IGeoJSONFeatureStyle;
+    /** Overlay / terrain mask mode */
+    mode?: GeoJSONOverlayMode;
+    /** Point radius */
+    pointRadius?: number;
     /** 填充样式 */
     fillStyle?: string;
+    /** Fill opacity */
+    fillOpacity?: number;
     /** 描边样式: 颜色设置参考  https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/strokeStyle*/
     strokeStyle?: string;
     /** 描边宽度 */
     strokeWidth?: number;
+    /** Stroke opacity */
+    strokeOpacity?: number;
+    /** Stroke dash pattern */
+    lineDash?: number[];
+    /** Stroke line cap */
+    lineCap?: CanvasLineCap;
+    /** Stroke line join */
+    lineJoin?: CanvasLineJoin;
+    /** Point fill style */
+    pointFillStyle?: string | null;
+    /** Point stroke style */
+    pointStrokeStyle?: string | null;
+    /** Point stroke width */
+    pointStrokeWidth?: number | null;
+    /** Per-feature default visibility */
+    visible?: boolean;
+    /** Per-feature default zIndex */
+    zIndex?: number;
 }
 /**
  * Cesium Ion Overlay 配置

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@soonspacejs/plugin-tiles",
   "pluginName": "TilesPlugin",
-  "version": "2.15.4",
+  "version": "2.15.5",
   "description": "3D Tiles plugin for SoonSpace.js",
   "main": "dist/index.esm.js",
   "module": "dist/index.esm.js",
@@ -18,9 +18,9 @@
   "license": "UNLICENSED",
   "gitHead": "4a87dd85050651088e11c3da777c49fab3db7e5d",
   "peerDependencies": {
-    "um-3d-tiles-renderer": "^0.4.46",
+    "um-3d-tiles-renderer": "^0.4.48",
     "three": "^0.183.0",
     "@mapbox/geojson-merge": "^1.1.1",
-    "soonspacejs": "2.15.4"
+    "soonspacejs": "2.15.5"
   }
 }