@soonspacejs/plugin-tiles 2.15.8 → 2.15.9

package/dist/plot/GroundDecalManager.d.ts

@@ -1,54 +1,58 @@
-import { PlotSdfPlugin } from 'um-3d-tiles-renderer/three/plugins';
-import { ImageOverlayPlugin } from 'um-3d-tiles-renderer/plugins';
+import { default as SoonSpace } from 'soonspacejs';
+import { CesiumGroundFrameState } from 'cesium-to-three/ground';
 import { GisPlotBase } from './plugins/base';
 import { GisPlotArrowSnapshot, GisPlotSnapshot, LonLatPoint, PlotAddOptions } from './plugins/types';
-import { default as SoonSpace } from 'soonspacejs';
-/** 构造 {@link GroundDecalManager} 时的选项 */
+import { PlotPrimitiveBridge } from './PlotPrimitiveBridge';
+/** 构造 GroundDecalManager 时的选项（注入 ssp）。 */
 export type GroundDecalManagerOptions = {
-    /** SoonSpace 实例（必传） */
+    /** SoonSpace 实例（必传）；标绘图元挂载到 ssp.viewport.scene。 */
     ssp: SoonSpace;
-    /** 传入后会在首次有图形时自动将 PlotOverlay 注册到该插件 */
-    imageOverlayPlugin?: ImageOverlayPlugin;
 };
-/** {@link GroundDecalManager.getItem} / {@link GroundDecalManager.getItemDeep} 的联合返回类型 */
+/** getItem / getItemDeep 的联合返回类型（箭头额外带 generatedCoords）。 */
 export type GisPlotItemSnapshot = GisPlotSnapshot | GisPlotArrowSnapshot;
-/**
- * 标绘样式补丁：与 {@link GisPlotBase.update} 一致，允许在基类字段之外带扩展键。
- */
+/** 标绘样式补丁：与 GisPlotBase.update 一致，允许基类字段之外的扩展键。 */
 export type GisPlotStylePatch = Partial<Parameters<GisPlotBase['update']>[0]> & Record<string, unknown>;
-/**
- * {@link GroundDecalManager.setCenter} 的中心点（度）。
- */
+/** setCenter 的中心点（lon / lat 均可选；单位度）。 */
 export type CenterLonLat = {
     lon?: number;
     lat?: number;
 };
+/**
+ * 地面标绘管理器：与参考项目同名同形，数据 API 逐字保留；
+ * 渲染接入收敛到桥接器（PlotPrimitiveBridge）。
+ */
 export declare class GroundDecalManager {
-    /** 标绘 id → 实例；与 `PlotOverlay.imageSource.shapes` 共用同一引用 */
+    /** 标绘 id → 实例；与桥接器的 shapes 共用同一引用 */
     private readonly _items;
-    /** 标绘 id */
+    /** 标绘管理器 id（对外常量，保持与参考项目一致） */
     readonly id: string;
     /** SoonSpace 实例 */
     readonly ssp: SoonSpace;
-    /** 传入的 PlotSDFPlugin，用于在有图形时自动注册 overlay */
-    private _plotSdfPlugin?;
-    /** overlay 是否已注册到 PlotSDFPlugin */
+    /** 渲染桥接器（顶替参考项目的 PlotSdfPlugin） */
+    private readonly _bridge;
+    /** 桥接器是否已收到 shapes 引用 */
     private _overlayAttached;
-    /** 合并同一帧内多次 `_markDirty`，值为 `requestAnimationFrame` 句柄 */
+    /** 合并同一帧内多次 _markDirty，值为 requestAnimationFrame 句柄 */
     private _redrawTimer;
     constructor(options: GroundDecalManagerOptions);
+    /** 暴露内部桥接器，业务若需自定义场景接入可选择性使用 */
+    get bridge(): PlotPrimitiveBridge;
     /**
-     * 内部使用的 `PlotOverlay` 实例。
-     * 注册到 `ImageOverlayPlugin` 的 `overlays` 数组中，顺序靠后者通常绘制在上层。
+     * 兼容参考项目同名 getter：内置桥接器替代 PlotSdfPlugin。
+     * 业务旧调用 `decals.plotSdfPlugin` 仍能拿到一个具备 shapes / redraw /
+     * opacity / dispose 协议的对象。
      */
-    get plotSdfPlugin(): PlotSdfPlugin | undefined;
+    get plotSdfPlugin(): PlotPrimitiveBridge;
     /**
-     * 绑定 / 更换 PlotOverlayPlugin（切换地形重建插件后调用）。
-     * 如果当前已有图形，会在下一帧自动重新注册 overlay。
+     * 兼容参考项目签名：桥接器已在构造时内置，无需外部注入。
+     * 调用仅触发一次重绘，便于旧业务无感升级。
      */
-    setPlotSDFPlugin(plugin: PlotSdfPlugin): void;
+    setPlotSDFPlugin(_plugin?: unknown): void;
     /**
-     * 添加标绘：由 `options.type` 决定实例化哪一类 `GisPlot*`（与各类 `*Options` 对应）。
+     * 添加标绘：由 options.type 决定实例化哪一类 GisPlot*。
+     *
+     * @returns 新建标绘的自增字符串 id。
+     * @throws  当 options.type 未知时抛错。
      */
     addPlot(options: PlotAddOptions): string;
     /** 按 id 移除标绘；存在并删除成功时触发重绘 */
@@ -56,57 +60,79 @@ export declare class GroundDecalManager {
     /** 清空全部标绘 */
     clear(): void;
     /**
-     * 读取标绘快照（**浅拷贝**：`options` 为新对象，但 `points` 与内部仍为同一数组引用）。
-     * 若需完全独立副本，请用 {@link getItemDeep}。
+     * 读取标绘浅快照（options 为新对象，points 仍共享引用；箭头附带 generatedCoords）。
+     *
+     * @returns 浅快照；id 不存在时返回 null。
      */
     getItem(id: string): GisPlotItemSnapshot | null;
     /**
-     * 深拷贝快照：`points` 等嵌套数组被复制，修改返回值不会影响内部状态。
-     * 箭头类型额外深拷贝 `generatedCoords`。
+     * 读取标绘深快照：points 等嵌套数组被复制；箭头额外深拷贝 generatedCoords。
+     *
+     * @returns 深快照；id 不存在时返回 null。
      */
     getItemDeep(id: string): GisPlotItemSnapshot | null;
     /**
-     * 合并更新样式与几何字段（调用对应 `GisPlot*.update`）。
-     * `patch` 形状需与该 id 下图元类型兼容。
+     * 合并更新样式与几何字段（调用对应 GisPlot*.update 做不可变整表替换）。
      */
     setStyle(id: string, patch: GisPlotStylePatch): void;
     /**
-     * 将 **第一个顶点** 设为新的经纬度中心（适用于点、矩形中心、扇心、文字锚点等单中心语义）。
+     * 将第一个顶点设为新的经纬度中心（点 / 矩形中心 / 扇心 / 文字锚点等单中心
+     * 语义）。**就地修改** points[0]（与 update 的不可变风格不同）。
      */
     setCenter(id: string, center: CenterLonLat): void;
-    /** 整体替换顶点列表（每项为 `[lon, lat]`） */
+    /**
+     * 整体替换顶点列表（每项为 [lon, lat]，深拷贝防止外部引用泄漏）。
+     */
     setCoords(id: string, coords: LonLatPoint[]): void;
-    /** 修改指定下标顶点；`coord` 分量可为 `undefined` 表示不改该分量 */
+    /**
+     * 修改指定下标顶点；coord 分量为 undefined 表示不改该分量。越界静默返回。
+     */
     setCoord(id: string, index: number, coord: Partial<LonLatPoint> | [number?, number?]): void;
-    /** 在 `index` 处插入一个顶点（可插在末尾，`index` 越界时钳位） */
+    /**
+     * 在 index 处插入一个顶点（可插末尾，越界钳位）。插入顶点深拷贝。
+     */
     insertCoord(id: string, index: number, coord: LonLatPoint): void;
     /**
-     * 删除指定下标顶点。
-     * 多边形至少保留 3 点，其余类型至少 2 点（与 `shape.category` 联动）。
+     * 删除指定下标顶点。多边形至少保留 3 点，其余至少 2 点；越界 / 触底静默返回。
      */
     removeCoord(id: string, index: number): void;
-    /** 对所有顶点做经纬度平移（度） */
+    /**
+     * 对所有顶点做经纬度平移（度），就地修改。
+     */
     translateCoords(id: string, dLon: number, dLat: number): void;
-    /** 仅对 `category === 'text'` 的项更新 `options.content` */
+    /**
+     * 仅对 category === 'text' 的项更新 options.content。
+     */
     setText(id: string, text: string): void;
-    /** 设置整个 overlay 不透明度（0–1，具体语义以 `PlotOverlay` 为准） */
+    /**
+     * 设置整个标绘层的全局不透明度（0..1）。桥接器内部钳位。
+     */
     setGlobalOpacity(opacity: number): void;
+    /**
+     * 返回某标绘顶点数（不存在返回 0）。
+     */
     getCoordCount(id: string): number;
     /**
-     * 在经纬度平面上找离 `(lon, lat)` 最近的顶点下标（平方距离最小）；
-     * 无顶点时返回 `-1`。
+     * 在经纬度平面找离 (lon, lat) 最近的顶点下标（平方距离最小）；无顶点返回 -1。
      */
     findNearestCoord(id: string, lon: number, lat: number): number;
-    render: () => void;
     /**
-     * 释放 overlay 内部 RTT / 纹理等资源。
-     * `PlotSDFPlugin` 的运行时实现含 `dispose`，类型声明可能未列出，故做断言。
+     * 宿主每帧调用：在深度纹理渲染之后、renderer.render 之前，
+     * 把深度纹理 / 视口 / 相机透传给所有标绘图元。
+     *
+     * @param frameState 当前帧状态（含 depthTexture / width / height / camera /
+     *                   pixelRatio?）。
      */
+    update(frameState: CesiumGroundFrameState): void;
+    /**
+     * 触发 SoonSpace 视口刷新；在 _markDirty 合并重绘后调用。
+     */
+    render: () => void;
+    /** 释放桥接器内部全部图元与场景挂载 */
     dispose(): void;
     /**
-     * 标记需要在下一帧重绘瓦片标绘层；同一帧内多次调用只会调度一次。
-     * 首次有图形且尚未挂载时，先将 PlotOverlay 注册到 ImageOverlayPlugin（此时 shapes 已有数据，
-     * `init()` → `hasContent` 能正确返回 true）。
+     * 标记下一帧重绘；同帧多次调用只调度一次。
+     * 首次有图形时把 _items 交给桥接器（此时 shapes 已有数据，redraw 能正确建图元）。
      */
     private _markDirty;
 }

package/dist/plot/PlotPrimitiveBridge.d.ts

@@ -0,0 +1,61 @@
+import { Scene } from 'three';
+import { CesiumGroundFrameState } from 'cesium-to-three/ground';
+import { GisPlotBase } from './plugins/base';
+/** 桥接器构造选项 */
+export interface PlotPrimitiveBridgeOptions {
+    /** 标绘图元挂载的目标场景 */
+    scene: Scene;
+}
+/**
+ * 标绘图元桥接器：把 Map<id, GisPlot*> 同步为一组 CesiumGround*Primitive。
+ */
+export declare class PlotPrimitiveBridge {
+    /** 标绘 id → 渲染记录 */
+    private readonly _entries;
+    /** 由 GroundDecalManager 写入的标绘集合（引用共享） */
+    private _shapes;
+    /** 全局不透明度（0..1）；写入后下次 redraw 生效 */
+    private _opacity;
+    /** 挂载场景 */
+    private readonly _scene;
+    /** 已释放标记 */
+    private _disposed;
+    constructor(options: PlotPrimitiveBridgeOptions);
+    /** 接收 GroundDecalManager 交付的 Map */
+    set shapes(value: Map<string, GisPlotBase>);
+    /** 当前持有的标绘集合（引用，与 GroundDecalManager._items 同一） */
+    get shapes(): Map<string, GisPlotBase>;
+    /** 全局不透明度，写入时钳到 [0, 1] */
+    set opacity(value: number);
+    get opacity(): number;
+    /**
+     * 把 _shapes 同步成图元集合：删除消失的、新增没有的、几何 / 样式变化的重建，
+     * 仅可见性 / renderOrder 变化的轻量刷新。
+     */
+    redraw(): void;
+    /**
+     * 宿主每帧调用：把 frameState 透传给所有图元（深度 + 视口 + 相机 + pixelRatio）。
+     */
+    update(frameState: CesiumGroundFrameState): void;
+    /** 释放全部图元与场景挂载 */
+    dispose(): void;
+    /**
+     * 当前图元是否支持样式热更新（颜色 / 描边等）。
+     * 折线（setColor / setWidth）与文字（setText）支持；面类不支持，需重建。
+     */
+    private _supportsStyleHotUpdate;
+    /**
+     * 几何未变时的轻量刷新：
+     *   - 所有图元：group.visible + setRenderOrder。
+     *   - 折线：setColor / setWidth / setArrowSizeMeters / setVisible（不重建几何）。
+     *   - 文字：setText（内容 + 颜色 + 不透明度）/ setVisible（不重建图元）。
+     */
+    private _refreshLightweight;
+    /**
+     * 按 category 实例化对应 cesium-to-three 图元。统一透传 stroke/fill 颜色与
+     * 0..100 不透明度，并按全局 opacity 折算（在 0..100 口径上乘 this._opacity）。
+     *
+     * @returns 渲染图元；未知类型 / 退化情况返回 null。
+     */
+    private _buildPrimitive;
+}

package/dist/plot/index.d.ts

@@ -0,0 +1,9 @@
+export { GroundDecalManager, } from './GroundDecalManager';
+export type { GroundDecalManagerOptions, GisPlotItemSnapshot, GisPlotStylePatch, CenterLonLat, } from './GroundDecalManager';
+export * from './plugins/index';
+export { parseColorToRGBA, resolveOpacity, } from './plugins/utils/colorUtils';
+export type { NormalizedRGBA, StyleOpacityInput, } from './plugins/utils/colorUtils';
+export * from './plugins/utils/ArrowUtils';
+export { PlotPrimitiveBridge, } from './PlotPrimitiveBridge';
+export type { PlotPrimitiveBridgeOptions, } from './PlotPrimitiveBridge';
+export { plotOrderToRenderOrder, sanitizePlotOrder, } from './plot-order';

package/dist/plot/plot-order.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 将用户侧标绘顺序清洗为有限非负整数。
+ * NaN / Infinity / 负数均回退到 0。
+ */
+export declare function sanitizePlotOrder(plotOrder: number): number;
+/**
+ * 将唯一 plotOrder 展开为 front-stencil 命令块的基础 renderOrder。
+ *
+ * 该函数只把已经唯一的 plotOrder 展开为 stencil 管线使用的三个绘制命令。
+ * 真正的唯一性由桥接器按 Map 插入序分配 plotOrder 保证；不要把这个函数
+ * 当成去重器。
+ *
+ * @returns 基础 renderOrder = 1000 + plotOrder × 3。
+ */
+export declare function plotOrderToRenderOrder(plotOrder: number): number;

package/dist/plot/plugins/arrow.d.ts

@@ -1,25 +1,28 @@
-import { LonLat } from './utils/ArrowUtils';
+import { ArrowPolygon } from 'cesium-to-three/arrow';
 import { GisPlotBase } from './base';
 import { GisPlotArrowSnapshot, PlotArrowOptions } from './types';
-/**
- * 箭头标绘（面类）→ {@link PlotArrowOptions}
- *
- * CPU 端由 `./utils/ArrowUtils` 生成闭合多边形 → `generatedCoords`，复用 polygon type 2 渲染。
- * 与折线端点箭头样式（`PlotArrowStyle`）不同。
- */
 export declare class GisPlotArrow extends GisPlotBase {
     readonly category: "arrow";
     options: PlotArrowOptions;
-    /** `generateCoords()` 填充的闭合多边形顶点 */
-    generatedCoords: LonLat[];
+    /** generateCoords() 填充的闭合多边形顶点；初始为空 */
+    generatedCoords: ArrowPolygon;
     constructor(options: PlotArrowOptions);
-    update(patch: Partial<PlotArrowOptions>): void;
+    /** 类型收窄：patch 限定为 PlotArrowOptions 的子集 + 任意扩展键 */
+    update(patch: Partial<PlotArrowOptions> & Record<string, unknown>): void;
     /**
-     * 按 `arrowType` 与控制点生成闭合多边形顶点（供 GroundDecalManager / PlotOverlay 重建几何）。
+     * 根据 arrowType 把控制点转为闭合多边形顶点序列，存入 generatedCoords。
+     * 结果已 CCW 规范化、去除连续重复顶点并 clamp 到 ≤120 顶点，
+     * 可直接喂给 CesiumGroundPolygonPrimitive。
+     *
+     * 边界：
+     *   - 控制点 < 2 → generatedCoords = []，返回 []。
+     *   - 'fine' / 'assaultDirection' 只用前 2 个控制点。
+     *   - 'attack' / 'swallowtailAttack' / 'curved' 用全部控制点。
+     *   - 未知 arrowType 退化为 createFineArrow( cp[0], cp[last] )。
      */
-    generateCoords(): LonLat[];
-    /** 浅拷贝：`options`、`generatedCoords` 与内部共享引用（顶点数组仍与 `options.points` 规则一致）。 */
+    generateCoords(): ArrowPolygon;
+    /** 浅快照：附带 generatedCoords（每个顶点复制一份，与内部数组解耦） */
     getSnapshot(): GisPlotArrowSnapshot;
-    /** 深拷贝：`options.points` 与 `generatedCoords` 均为新数组。 */
+    /** 深快照：options.points 与 generatedCoords 各自每个顶点都是新数组 */
     getSnapshotDeep(): GisPlotArrowSnapshot;
 }

package/dist/plot/plugins/base.d.ts

@@ -1,32 +1,45 @@
 import { GisPlotBaseOptions, GisPlotCategory, GisPlotSnapshot, LonLatPoint } from './types';
 /**
- * GIS 标绘对象基类。
- *
- * 数据结构对齐 {@link GisPlotBaseOptions}：`points` 为 `[[lon, lat], ...]`。
- * 子类在 `options` 中扩展各自字段（如 `size`、`radius`、`arrowType` 等）。
+ * 标绘数据模型基类。每个实例是一个**纯数据对象**：只持有 id / category /
+ * options，不持有任何 GPU 资源 / Three 对象 / DOM 节点。
  */
 export declare class GisPlotBase {
+    /** 自增字符串 id（'1' / '2' / '3' ...） */
     readonly id: string;
+    /**
+     * 类别。基类构造为空串，子类用 `readonly category = 'xxx' as const` 覆写。
+     * 桥接器据此 switch 分支。
+     */
     category: GisPlotCategory;
+    /**
+     * 标绘选项。基类持 GisPlotBaseOptions，子类用 `declare options: 具体Options`
+     * 收窄类型提示。
+     */
     options: GisPlotBaseOptions;
     constructor(options: GisPlotBaseOptions);
     /**
-     * 合并更新 `options`（不可变风格：整表替换为新对象）。
-     * 子类应覆盖为 `Partial<具体Options>`，以便类型提示包含各类型专有字段。
+     * 不可变整表替换：用展开 + patch 重建 options。
+     * 子类覆写此方法仅为收窄 patch 的类型提示，方法体相同。
      */
     update(patch: Partial<GisPlotBaseOptions> & Record<string, unknown>): void;
     /**
-     * 浅拷贝快照：`options` 为一层展开新对象，`points` 与内部仍为同一数组引用。
-     * {@link GroundDecalManager.getItem} 默认使用此方法。
+     * 浅快照：options 是新对象（展开一层），但 options.points 与内部共享引用。
+     * 管理器 getItem 默认走这里。
      */
     getSnapshot(): GisPlotSnapshot;
     /**
-     * 深拷贝快照：`points` 中每个顶点为新数组，修改返回值不会影响标绘内部状态。
-     * 需独立副本时请用 {@link GroundDecalManager.getItemDeep} 或本方法。
+     * 深快照：points 每个顶点都是新数组 → 改返回值不影响内部。
+     * 管理器 getItemDeep 走这里。
      */
     getSnapshotDeep(): GisPlotSnapshot;
-    /** 用于计算 ENU 参考中心的坐标点 */
+    /**
+     * 基类默认：返回全部顶点。上层用来算 ENU 参考中心。
+     * 子类（point / text / circle / sector 等）可覆写为更紧的语义。
+     */
     getCenterPoints(): LonLatPoint[];
-    /** 用于计算最大空间范围的坐标点（子类可覆盖以扩展半径等） */
+    /**
+     * 基类默认：返回全部顶点。上层用来算最大空间范围。
+     * circle / sector 子类覆写为按半径外扩的经纬度包围盒。
+     */
     getExtentPoints(): LonLatPoint[];
 }

package/dist/plot/plugins/circle.d.ts

@@ -1,13 +1,11 @@
 import { GisPlotBase } from './base';
 import { LonLatPoint, PlotCircleOptions } from './types';
-/**
- * 圆标绘 → {@link PlotCircleOptions}
- * `points[0]` 为圆心；shader type 1。
- */
 export declare class GisPlotCircle extends GisPlotBase {
     readonly category: "circle";
     options: PlotCircleOptions;
     constructor(options: PlotCircleOptions);
-    update(patch: Partial<PlotCircleOptions>): void;
+    /** 类型收窄：patch 限定为 PlotCircleOptions 的子集 + 任意扩展键 */
+    update(patch: Partial<PlotCircleOptions> & Record<string, unknown>): void;
+    /** 按半径外扩的经纬度包围盒（两点：西南角、东北角） */
     getExtentPoints(): LonLatPoint[];
 }

package/dist/plot/plugins/line.d.ts

@@ -1,12 +1,9 @@
 import { GisPlotBase } from './base';
 import { PlotLineOptions } from './types';
-/**
- * 折线标绘 → {@link PlotLineOptions}
- * `options.points` 为折线顶点；shader type 3。
- */
 export declare class GisPlotLine extends GisPlotBase {
     readonly category: "line";
     options: PlotLineOptions;
     constructor(options: PlotLineOptions);
-    update(patch: Partial<PlotLineOptions>): void;
+    /** 类型收窄：patch 限定为 PlotLineOptions 的子集 + 任意扩展键 */
+    update(patch: Partial<PlotLineOptions> & Record<string, unknown>): void;
 }

package/dist/plot/plugins/point.d.ts

@@ -1,14 +1,13 @@
 import { GisPlotBase } from './base';
 import { LonLatPoint, PlotPointOptions } from './types';
-/**
- * 点标绘 → {@link PlotPointOptions}
- * `options.points[0]` 为点的中心；shader type 6。
- */
 export declare class GisPlotPoint extends GisPlotBase {
     readonly category: "point";
     options: PlotPointOptions;
     constructor(options: PlotPointOptions);
-    update(patch: Partial<PlotPointOptions>): void;
+    /** 类型收窄：patch 限定为 PlotPointOptions 的子集 + 任意扩展键 */
+    update(patch: Partial<PlotPointOptions> & Record<string, unknown>): void;
+    /** 单中心语义：只取 points[0] */
     getCenterPoints(): LonLatPoint[];
+    /** 范围与中心相同（点无几何外扩） */
     getExtentPoints(): LonLatPoint[];
 }

package/dist/plot/plugins/polygon.d.ts

@@ -1,12 +1,9 @@
 import { GisPlotBase } from './base';
 import { PlotPolygonOptions } from './types';
-/**
- * 多边形标绘 → {@link PlotPolygonOptions}
- * 至少 3 个顶点；shader type 2。
- */
 export declare class GisPlotPolygon extends GisPlotBase {
     readonly category: "polygon";
     options: PlotPolygonOptions;
     constructor(options: PlotPolygonOptions);
-    update(patch: Partial<PlotPolygonOptions>): void;
+    /** 类型收窄：patch 限定为 PlotPolygonOptions 的子集 + 任意扩展键 */
+    update(patch: Partial<PlotPolygonOptions> & Record<string, unknown>): void;
 }

package/dist/plot/plugins/rectangle.d.ts

@@ -1,13 +1,9 @@
 import { GisPlotBase } from './base';
 import { PlotRectangleOptions } from './types';
-/**
- * 矩形标绘 → {@link PlotRectangleOptions}
- * `points` 为 4 个角点 [[lon,lat], ...]，按顺/逆时针排列；
- * 渲染端以多边形方式绘制（shader type 2）。
- */
 export declare class GisPlotRectangle extends GisPlotBase {
     readonly category: "rectangle";
     options: PlotRectangleOptions;
     constructor(options: PlotRectangleOptions);
-    update(patch: Partial<PlotRectangleOptions>): void;
+    /** 类型收窄：patch 限定为 PlotRectangleOptions 的子集 + 任意扩展键 */
+    update(patch: Partial<PlotRectangleOptions> & Record<string, unknown>): void;
 }

package/dist/plot/plugins/sector.d.ts

@@ -1,13 +1,11 @@
 import { GisPlotBase } from './base';
 import { LonLatPoint, PlotSectorOptions } from './types';
-/**
- * 扇形标绘 → {@link PlotSectorOptions}
- * `points[0]` 为扇心；shader type 5。
- */
 export declare class GisPlotSector extends GisPlotBase {
     readonly category: "sector";
     options: PlotSectorOptions;
     constructor(options: PlotSectorOptions);
-    update(patch: Partial<PlotSectorOptions>): void;
+    /** 类型收窄：patch 限定为 PlotSectorOptions 的子集 + 任意扩展键 */
+    update(patch: Partial<PlotSectorOptions> & Record<string, unknown>): void;
+    /** 按半径外扩的经纬度包围盒（与 GisPlotCircle 完全一致；不区分扇区角度） */
     getExtentPoints(): LonLatPoint[];
 }

package/dist/plot/plugins/text.d.ts

@@ -1,14 +1,13 @@
 import { GisPlotBase } from './base';
 import { LonLatPoint, PlotTextOptions } from './types';
-/**
- * 文本标绘 → {@link PlotTextOptions}
- * `points[0]` 为标签锚点；shader type 4（label atlas）。
- */
 export declare class GisPlotText extends GisPlotBase {
     readonly category: "text";
     options: PlotTextOptions;
     constructor(options: PlotTextOptions);
-    update(patch: Partial<PlotTextOptions>): void;
+    /** 类型收窄：patch 限定为 PlotTextOptions 的子集 + 任意扩展键 */
+    update(patch: Partial<PlotTextOptions> & Record<string, unknown>): void;
+    /** 单锚点语义：只取 points[0] */
     getCenterPoints(): LonLatPoint[];
+    /** 范围与中心相同（文本无几何外扩） */
     getExtentPoints(): LonLatPoint[];
 }