@manycore/custom-sdk 1.14.0-alpha.0 → 2.0.0-beta.0

package/index.d.ts

@@ -1,9 +1,7 @@
-import { ELineType as ELineType_2 } from '@manycore/custom-miniapp-sdk';
 import { IExportModelData } from '@manycore/custom-miniapp-sdk';
 import { IParamModelPhotoResponse } from '@manycore/custom-miniapp-sdk';
 import { IServClientService } from 'servkit';
-import { Number2 } from '@manycore/custom-miniapp-sdk';
-import { Number3 } from '@manycore/custom-miniapp-sdk';
+import { Number2 as Number2_2 } from '@manycore/custom-miniapp-sdk';
 import { ServService } from 'servkit';
 
 declare interface AMap<K, V> {
@@ -28,6 +26,7 @@ export declare class Application {
     private serviceMap;
     private sappSDK;
     constructor();
+    private startOnApiCalledEvent;
     /**
      * 判断当前是否在定制小程序下运行
      */
@@ -352,7 +351,7 @@ export declare enum EFittingType {
     /**
      * 交接面信息
      */
-    INTERSECTED = 'intersected',
+    INTERSECTED = "intersected"
 }
 
 /**
@@ -362,11 +361,11 @@ export declare enum EIntersectedCreatedType {
     /**
      * 板与板之间产生的交界
      */
-    BOTH_PLANK,
+    BOTH_PLANK = 0,
     /**
      * 板与五金之间产生的交界信息
      */
-    PLANK_FURNITURE,
+    PLANK_FURNITURE = 1
 }
 
 /**
@@ -376,11 +375,29 @@ export declare enum EIntersectedType {
     /**
      * 交接体
      */
-    SHELL = '1',
+    SHELL = "1",
     /**
      * 交界面
      */
-    FACE = '2',
+    FACE = "2"
+}
+
+/**
+ * 交接对象类型
+ */
+export declare enum EIntersectModelType {
+    /**
+     * 板件
+     */
+    PLANK = 0,
+    /**
+     * 五金
+     */
+    HARDWARE = 1,
+    /**
+     * 商品
+     */
+    PRODUCT = 2
 }
 
 /**
@@ -435,25 +452,6 @@ declare enum ElementType {
  * 线的类型
  */
 export declare enum ELineType {
-    /**
-     * 直线
-     */
-    SEGMENT = 0,
-    /**
-     * 圆弧
-     */
-    CIRCLE_ARC = 1,
-    /**
-     * 椭圆
-     * 当前代码中，暂不支持
-     */
-    ELLIPSE_ARC = 3,
-}
-
-/**
- * 线的类型
- */
-declare enum ELineType_3 {
     /**
      * 直线
      */
@@ -621,33 +619,16 @@ export declare enum EPointType {
     /**
      * 椭圆
      */
-    ELLIPSE = 4,
+    ELLIPSE = 4
 }
 
 /**
- * 点的类型
+ * 商品建模方向
  */
-declare enum EPointType_2 {
-    /**
-     * 普通点
-     */
-    NONE = 0,
-    /**
-     * 倒圆
-     */
-    CIRCLE = 1,
-    /**
-     * 倒角
-     */
-    LINE = 2,
-    /**
-     * 切圆，就是内挖一个倒圆的形状
-     */
-    CUT_CIRCLE = 3,
-    /**
-     * 椭圆
-     */
-    ELLIPSE = 4
+export declare enum EProductDirection {
+    XY = 0,
+    YZ = 1,
+    XZ = 2
 }
 
 /**
@@ -776,12 +757,14 @@ export declare class FittingDesignService extends BaseService {
      * ```
      *
      * @param autoSave 默认开启自动保存
+     * @deprecated a legacy api in sdk(version >= 2.0.0).
      */
     toggleAutoSave(autoSave?: boolean): void;
     /**
      * 获取当前是否开启了自动保存
      *
      * @example
+     * @deprecated a legacy api in sdk(version >= 2.0.0).
      * ```typescript
      * fittingDesignService.isAutoSave();
      * ```
@@ -794,8 +777,8 @@ export declare class FittingDesignService extends BaseService {
      * ```typescript
      * fittingDesignService.getFittingDesignData();
      * ```
-     *
      * @param modelId 方案模型的ID，当没传时，就是获取场景中，正在预览的模型ID的方案数据
+     * @deprecated a legacy api in sdk(version >= 2.0.0).
      */
     getFittingDesignData(modelId?: string): Promise<IFittingDesignData | null>;
     /**
@@ -814,6 +797,7 @@ export declare class FittingDesignService extends BaseService {
      *
      * @param modelid 模型ID，如果为空时，则表示传递的为查询当前正在编辑的模型的方案数据
      * @param casbin 是否为五金，当modelid为五金的id时，需要为true
+     * @deprecated a legacy api in sdk(version >= 2.0.0).
      */
     getConnectedFittingDesign(modelid?: string, casbin?: boolean): Promise<IFittingDesignData | null>;
     /**
@@ -839,6 +823,7 @@ export declare class FittingDesignService extends BaseService {
      *
      * @param design 孔/槽方案信息
      * @param option { timeout, save} 调用超时，save 是否立即保存至后端，默认为true
+         * @deprecated a legacy api in sdk(version >= 2.0.0).
          */
      appendFittingDesign(design: Partial<IFittingDesignData>, option?: {
          /**
@@ -866,6 +851,7 @@ export declare class FittingDesignService extends BaseService {
       *
       * @param design 需要保存的方案信息
       * @param option
+      * @deprecated a legacy api in sdk(version >= 2.0.0).
       */
      saveDesign(design?: IFittingDesignData, option?: {
          timeout?: number;
@@ -881,8 +867,25 @@ export declare class FittingDesignService extends BaseService {
       * await fittingDesignService.clearDesign();
       * ```
       * @param options
+      * @deprecated a legacy api in sdk(version >= 2.0.0).
       */
      clearDesign(options?: IBaseOptions): Promise<void>;
+     /**
+      * 渲染五金孔槽数据到场景中，不影响五金孔槽数据保存
+      *
+      * @param option.data 五金孔槽数据
+      * ```
+      * const fittingData = getFittingData(); // 获取五金孔槽数据
+      * viewFitting({ data: fittingData }); // 初次渲染
+      *
+      * const newFittingData = getFittingData(); // 新的五金孔槽数据
+      * viewFitting({ data: newFittingData }); // 更新场景内展示的五金孔槽
+      * viewFitting({}); // 清除场景内展示的五金孔槽
+      * ```
+      */
+     viewFitting(option?: {
+         data?: IFittingDesignData;
+     }): void;
     }
 
     /**
@@ -918,7 +921,7 @@ export declare class FittingDesignService extends BaseService {
     export declare class FittingModelService extends BaseService {
         /**
          * 获取所有五金孔槽模型
-         * @param modelId  模型id，查找相关联孔槽五金或模型下所有的板件关联孔槽五金
+         * @param modelId 模型id，查找相关联的孔槽五金或模型下所有的板件关联的孔槽五金
          * @returns Promise<IFittingModelLite[]>
          */
         getAllFittingModels(modelId?: string): Promise<IFittingModelLite[]>;
@@ -984,17 +987,14 @@ export declare class FittingDesignService extends BaseService {
          * 孔/槽的深度
          */
         depth: number;
-
         /**
          * 所处的板面
          */
         plankFaceId: number;
-
         /**
          * 起点
          */
         start: Number3;
-
         /**
          * 终点
          */
@@ -1003,6 +1003,7 @@ export declare class FittingDesignService extends BaseService {
 
     /**
      * 交接信息
+     * @vm-type UnknownType
      */
     export declare interface IBaseIntersected {
         /**
@@ -1015,7 +1016,6 @@ export declare class FittingDesignService extends BaseService {
          * * 如果为交接体，length为8
          */
         points: Number3[];
-
         /**
          * 当前交接信息产生的元件ID
          */
@@ -1057,6 +1057,7 @@ export declare class FittingDesignService extends BaseService {
 
     /**
      * 自定议参数
+     * @vm-type IBzParamType
      */
     declare interface IBzParamModelLiteProperty<T extends number | string | boolean = string> {
         /**
@@ -1165,19 +1166,19 @@ export declare class FittingDesignService extends BaseService {
         /**
          * 所有的孔的数据
          */
-        holes: IFittingHoleCollect;
+        holes: IFittingHoleCollect_2;
         /**
          * 槽的数据
          */
-        grooves: IFittingGrooveCollect;
+        grooves: IFittingGrooveCollect_2;
         /**
          * 五金数据
          */
-        hardwares: IFittingHardwareCollect;
+        hardwares: IFittingHardwareCollect_2;
         /**
          * 五金槽数据
          */
-        hardwareGrooves: IFittingHardwareGrooves;
+        hardwareGrooves: IFittingHardwareGrooves_2;
     }
 
     export declare interface IFittingDesignValidateResult {
@@ -1192,16 +1193,31 @@ export declare class FittingDesignService extends BaseService {
      */
     export declare type IFittingGrooveCollect = Record<string, IGrooveData[]>;
 
+    /**
+     * 方案中的所有槽的数据
+     */
+    declare type IFittingGrooveCollect_2 = Record<string, IGrooveData[]>;
+
     /**
      * 五金数据
      */
     export declare type IFittingHardwareCollect = Record<string, IHardwareData[]>;
 
+    /**
+     * 五金数据
+     */
+    declare type IFittingHardwareCollect_2 = Record<string, IHardwareData[]>;
+
     /**
      * 五金槽数据
      */
     export declare type IFittingHardwareGrooves = Record<string, IHardwareGrooveData[]>;
 
+    /**
+     * 五金槽数据
+     */
+    declare type IFittingHardwareGrooves_2 = Record<string, IHardwareGrooveData[]>;
+
     /**
      * 五金孔槽模型ID - 标识信息
      *
@@ -1225,6 +1241,11 @@ export declare class FittingDesignService extends BaseService {
      */
     export declare type IFittingHoleCollect = Record<string, IHoleData[]>;
 
+    /**
+     * 方案中，所有孔的数据
+     */
+    declare type IFittingHoleCollect_2 = Record<string, IHoleData[]>;
+
     /**
      * 五金孔槽通用模型
      */
@@ -1273,17 +1294,71 @@ export declare class FittingDesignService extends BaseService {
     }
 
     /**
-     * 获取交接面配置信息
+     * 获取模型的交接信息
      */
-    export declare interface IGetModelIntersectedOption extends IBaseOptions {
+    declare interface IGetIntersectedOption {
         /**
+         * 模型ID
+         */
+        modelId: string;
+        /**
+         * @deprecated 可使用bodyDistTol/faceDistTol分别指定交接体/面阈值
          * 含义为交接面/体进行运算过程中的阈值容差；即两个平行面之间，生成交接信息时，最大距离
          * 默认值为 0.1mm
          * 单位：毫米
          */
         tolerance?: number;
+        /**
+         * 超时时间
+         * 单位：秒
+         */
+        timeout?: number;
+        /**
+         * 交接体阈值
+         * 单位：毫米
+         * @default 0.1
+         */
+        bodyDistTol?: number;
+        /**
+         * 交接面阈值
+         * 单位：毫米
+         * @default 0.1
+         */
+        faceDistTol?: number;
+        /**
+         * 是否过滤板厚
+         * @default true
+         */
+        thicknessFilter?: boolean;
+        /**
+         * 参与计算的对象
+         * 传入商品需要明确指定prodCatIds
+         * @default [EIntersectModelType.PLANK,EIntersectModelType.HARDWARE]
+         */
+        computeModelTypes?: Array<EIntersectModelType>;
+        /**
+         * 参与计算的商品
+         */
+        products?: Array<{
+            /**
+             * 真分类
+             */
+            category: number;
+        }>;
+        /**
+         * 商品统一建模方向
+         * @default EProductDirection.XY
+         */
+        direction?: EProductDirection;
     }
 
+    /**
+     * 获取交接面配置信息
+     */
+    export declare interface IGetModelIntersectedOption
+    extends Omit<IGetIntersectedOption, 'modelId'>,
+    IBaseOptions {}
+
     /**
      * 获取模型数据
      */
@@ -1300,7 +1375,6 @@ export declare class FittingDesignService extends BaseService {
     }
 
     export declare interface IGrooveData extends IBaseHoleGrooveData {
-        // 槽宽
         width: number;
     }
 
@@ -1312,22 +1386,18 @@ export declare class FittingDesignService extends BaseService {
          * 建模原点在板件坐标系下的坐标
          */
         position: Number3;
-
         /**
          * 相对建模坐标系中夹角，不传默认没有任何基于板件坐标的旋转，会将五金以建模原点放在 position 上，五金建模方向和板件建模方向一致进行摆放。
          */
         rotate: Number3;
-
         /**
          * 相对建模坐标系中缩放，不传默认五金和上传大小完全一致
          */
         scale: Number3;
-
         /**
          * 商品ID
          */
         brandGoodId: string;
-
         /**
          * 关联孔槽ID
          */
@@ -1342,7 +1412,6 @@ export declare class FittingDesignService extends BaseService {
          * 槽的深度
          */
         depth: number;
-
         /**
          * 所处的板面
          */
@@ -1432,6 +1501,16 @@ export declare class FittingDesignService extends BaseService {
         diameter: number;
     }
 
+    /**
+     * 交接信息
+     */
+    export declare interface IIntersectedData {
+        /**
+         * 交接信息集合
+         */
+        intersectedGroups: IIntersectedGroup[];
+    }
+
     /**
      * 一组交接信息
      */
@@ -1453,12 +1532,7 @@ export declare class FittingDesignService extends BaseService {
     /**
      * 交接信息
      */
-    export declare interface IIntersectedResult {
-        /**
-         * 交接信息集合
-         */
-        intersectedGroups: IIntersectedGroup[];
-    }
+    export declare type IIntersectedResult = IIntersectedData;
 
     /**
      * 轮廓路径线段表示
@@ -1468,7 +1542,7 @@ export declare class FittingDesignService extends BaseService {
          * 获取实际渲染端点
          * >线段两端
          */
-        getRenderPoints(): [Number2, Number2];
+        getRenderPoints(): [Number2_2, Number2_2];
         /**
          * 设置线段的高亮，高亮深度为板件厚度
          * @param hint 高亮配置
@@ -1523,26 +1597,21 @@ export declare class FittingDesignService extends BaseService {
     /**
      * 直线
      */
-    export declare interface ILineDataBase
-    extends Omit<
-    ILineBase,
-    'ellipseCenter' | 'clockwise' | 'minorArc' | 'radius' | 'majorRadius' | 'minorRadius'
-    > {
+    export declare interface ILineDataBase extends Omit<ILineBase, 'ellipseCenter' | 'clockwise' | 'minorArc' | 'radius' | 'majorRadius' | 'minorRadius'> {
         /**
          * 线条类型
          */
-        type: ELineType_2.SEGMENT;
+        type: ELineType.SEGMENT;
     }
 
     /**
      * 弧线
      */
-    export declare interface ILineDataCircle
-    extends Omit<ILineBase, 'ellipseCenter' | 'majorRadius' | 'minorRadius'> {
+    export declare interface ILineDataCircle extends Omit<ILineBase, 'ellipseCenter' | 'majorRadius' | 'minorRadius'> {
         /**
          * 线条类型
          */
-        type: ELineType_2.CIRCLE_ARC;
+        type: ELineType.CIRCLE_ARC;
         /**
          * 是否顺时针
          */
@@ -1613,7 +1682,7 @@ export declare class FittingDesignService extends BaseService {
      *     ]
      *   },
      *   "89D2793C-2B23-41A9-BA6E-4E3FS8490057": {
-     *     // 自定议高亮配置信息
+     *     // 自定义高亮配置信息
      *     "hintBorder": {
      *       "color": "#234432",
      *       "opacity": 0.8
@@ -1732,7 +1801,7 @@ export declare class FittingDesignService extends BaseService {
          * @public
          * @typedef Number3
          */
-        position: Number3_2;
+        position: Number3;
         /**
          * 当前模型的旋转信息
          * @readonly
@@ -1740,21 +1809,21 @@ export declare class FittingDesignService extends BaseService {
          * @typedef Number3
          * @deprecated 将废弃，推荐使用 rotation
          */
-        rotate: Number3_2;
+        rotate: Number3;
         /**
          * 当前模型的旋转信息
          * @readonly
          * @public
          * @typedef Number3
          */
-        rotation: Number3_2;
+        rotation: Number3;
         /**
          * 当前尺寸信息
          * @readonly
          * @public
          * @typedef Number3
          */
-        size: Number3_2;
+        size: Number3;
         /**
          * 模型当中自定议的参数信息
          * @readonly
@@ -1833,34 +1902,34 @@ export declare class FittingDesignService extends BaseService {
          * 更新当前模型的位置信息
          * @param position {Number3} 坐标
          */
-        setPosition(position: Number3_2): void;
+        setPosition(position: Number3): void;
         /**
          * 获取当前模型的坐标信息
          * @return Number3 相对父模型坐标，如果为顶层模型，则为世界坐标
          */
-        getPosition(): Number3_2;
+        getPosition(): Number3;
         /**
          * 更新当前模型的旋转信息
          * @description 特别说明，定制模型，使用的是右手坐标系，rotate字段中
          * @param rotate {Number3} 旋转的弧度
          * @deprecated 将废弃，推荐使用 rotation
          */
-        setRotate(rotate: Number3_2): void;
+        setRotate(rotate: Number3): void;
         /**
          * 获取当前模型相对父级的旋转信息
          * @deprecated 将废弃，推荐使用 rotation
          */
-        getRotate(): Number3_2;
+        getRotate(): Number3;
         /**
          * 更新当前模型的旋转信息
          * @description 特别说明，定制模型，使用的是右手坐标系，rotation字段中
          * @param rotation {Number3} 旋转的弧度
          */
-        setRotation(rotation: Number3_2): void;
+        setRotation(rotation: Number3): void;
         /**
          * 获取当前模型相对父级的旋转信息
          */
-        getRotation(): Number3_2;
+        getRotation(): Number3;
         /**
          * 获取当前模型所处的工具线
          */
@@ -1969,6 +2038,7 @@ export declare class FittingDesignService extends BaseService {
 
     /**
      * 模型的参数信息
+     * @vm-type IParamType
      */
     declare interface IParamModelLiteParam<T = any> {
         /**
@@ -2041,13 +2111,21 @@ export declare class FittingDesignService extends BaseService {
     export declare interface IPlankArea {
         /**
          * 由板件原始轮廓数据解析出的所有路径
+         * >包含一个外轮廓路径和任意个内部轮廓路径
          */
         paths: IPlankPath[];
 
         /**
-         * 对板件原始轮廓数据进行非直角端点处理、重合、偏移计算后的实际展示路径
+         * 对板件原始轮廓数据进行非直角端点处理、重合、偏移计算后的实际展示路径，高亮时会将轮廓中心点放置到 (0, 0)
+         * @param option.resetCenter 是否重置轮廓中心点为 (0, 0)，默认为true
+         * @param option.force 忽略计算缓存，同一个PlankArea对象，getRealPaths计算结果会被缓存，默认为false
          */
-        getRealPaths(): IPlankArea;
+        getRealPaths(option?: { resetCenter?: boolean; force?: boolean }): IPlankArea;
+
+        /**
+         * 获取外轮廓路径中心点坐标
+         */
+        getCenterPoint(): Number2_2;
     }
 
     /**
@@ -2085,7 +2163,7 @@ export declare class FittingDesignService extends BaseService {
         /**
          * 获取路径上实际渲染的端点
          */
-        getRenderPoints(): Number2[];
+        getRenderPoints(): Number2_2[];
     }
 
     declare interface IPlankPathData {
@@ -2101,7 +2179,7 @@ export declare class FittingDesignService extends BaseService {
         /**
          * 线条类型
          */
-        type: ELineType_3;
+        type: ELineType;
         /**
          * 是否顺时针
          */
@@ -2142,7 +2220,7 @@ export declare class FittingDesignService extends BaseService {
         /**
          * 点的类型
          */
-        type: EPointType_2;
+        type: EPointType;
         /**
          * 切角两边上切点距离当前点的距离（切角专用）
          */
@@ -2185,7 +2263,7 @@ export declare class FittingDesignService extends BaseService {
          * 获取实际渲染端点
          * >非直角端点为渲染线段的两端，直角端点两个端点相同
          */
-        getRenderPoints(): [Number2, Number2];
+        getRenderPoints(): [Number2_2, Number2_2];
         /**
          * 设置非直角端点渲染线段的高亮，高亮深度为板件厚度
          * @param hint 高亮配置
@@ -2208,6 +2286,9 @@ export declare class FittingDesignService extends BaseService {
         type: EPointType;
         /**
          * 点的位置
+         *
+         * @example
+         * "123,-345"
          */
         position: Number3 | Number2;
         /**
@@ -2244,11 +2325,7 @@ export declare class FittingDesignService extends BaseService {
     /**
      * 倒圆
      */
-    export declare interface IPointWithCircle
-    extends Omit<
-    IPointBase,
-    'clockwise' | 'majorRadius' | 'minorRadius' | 'cornerCutDistance' | 'offset'
-    > {
+    export declare interface IPointWithCircle extends Omit<IPointBase, 'clockwise' | 'majorRadius' | 'minorRadius' | 'cornerCutDistance' | 'offset'> {
         /**
          * 切角类型
          */
@@ -2279,8 +2356,7 @@ export declare class FittingDesignService extends BaseService {
     /**
      * 切角
      */
-    export declare interface IPointWithLine
-    extends Omit<IPointBase, 'clockwise' | 'majorRadius' | 'minorRadius' | 'radius' | 'offset'> {
+    export declare interface IPointWithLine extends Omit<IPointBase, 'clockwise' | 'majorRadius' | 'minorRadius' | 'radius' | 'offset'> {
         /**
          * 切角类型
          */
@@ -2294,11 +2370,7 @@ export declare class FittingDesignService extends BaseService {
     /**
      * 普通点类型
      */
-    export declare interface IPointWithNone
-    extends Omit<
-    IPointBase,
-    'cornerCutDistance' | 'majorRadius' | 'minorRadius' | 'radius' | 'offset'
-    > {
+    export declare interface IPointWithNone extends Omit<IPointBase, 'cornerCutDistance' | 'majorRadius' | 'minorRadius' | 'radius' | 'offset'> {
         /**
          * 普通点
          */
@@ -2843,7 +2915,7 @@ export declare class FittingDesignService extends BaseService {
          *     ]
          *   },
          *   "89D2793C-2B23-41A9-BA6E-4E3FS8490057": {
-         *     // 自定议标识颜色
+         *     // 自定义标识颜色
          *     "hintBorder": {
          *       "color": "#234432",
          *       "opacity": 0.8
@@ -2914,6 +2986,7 @@ export declare class FittingDesignService extends BaseService {
          * ```
          *
          * @param options
+         * @deprecated a legacy api in sdk(version >= 2.0.0).
          */
         getParamData(options?: IGetParamModelJsonOption): Promise<any>;
         /**
@@ -2940,8 +3013,15 @@ export declare class FittingDesignService extends BaseService {
          * 获取方案顶层模型列表
          * @param options
          * @param options.ignoreCategory 真分类id过滤，默认值 CUSTOM_MODEL_CATEGORY_FILTER
+         * @deprecated a legacy api in sdk(version >= 2.0.0).
          */
         getTopParamModels(options?: ITopParamModelListOption): Promise<ITopParamModelDataResponse>;
+        /**
+         * 获取模型缩略图信息
+         * @param modelId
+         * @returns 模型缩略图信息
+         * @deprecated a legacy api in sdk(version >= 2.0.0).
+         */
         getParamModelPhotoById(modelId: string | string[]): Promise<IParamModelPhotoResponse[]>;
     }
 
@@ -2962,6 +3042,7 @@ export declare class FittingDesignService extends BaseService {
      * 主要是用来与场景交互的，监听当前选中的对象, 获取选中的内容
      *
      * @example
+     * @deprecated a legacy service in sdk(version >= 2.0.0).
      * ```typescript
      * const viewerSelectionService = application.getService(ModelViewerSelectionService);
      * ```
@@ -2975,6 +3056,7 @@ export declare class FittingDesignService extends BaseService {
         private hasWatchSelectionChange;
         /**
          * 获取当前选中的数据
+         * @deprecated a legacy api in sdk(version >= 2.0.0).
          */
         getSelected(): ISelected;
         /**
@@ -2982,6 +3064,7 @@ export declare class FittingDesignService extends BaseService {
          * 同时选中多个模型暂未支持，请勿使用
          * @param option ISetSelectedByIdOption
          * @example
+         * @deprecated a legacy api in sdk(version >= 2.0.0).
          * ```
          * const viewerSelectionService = application.getService(ModelViewerSelectionService);
          * const selectOption = {
@@ -2998,6 +3081,7 @@ export declare class FittingDesignService extends BaseService {
          * 同时取消多个模型暂未支持，请勿使用
          * @param option
          * @example
+         * @deprecated a legacy api in sdk(version >= 2.0.0).
          * ```
          * const viewerSelectionService = application.getService(ModelViewerSelectionService);
          * const selectOption = {
@@ -3031,16 +3115,19 @@ export declare class FittingDesignService extends BaseService {
         /**
          * 监听当前选中内容
          * @param fn
+         * @deprecated a legacy api in sdk(version >= 2.0.0).
          */
         on(fn: (param: ISelected) => any): void;
         /**
          * 取消监听选中变化
          * @param fn
+         * @deprecated a legacy api in sdk(version >= 2.0.0).
          */
         off(fn?: (param: ISelected) => any): void;
         /**
          * 监听当前选中的内容(触发一次后自动取消)
          * @param fn
+         * @deprecated a legacy api in sdk(version >= 2.0.0).
          */
         once(fn: (param: ISelected) => any): void;
         /**
@@ -3139,14 +3226,23 @@ export declare class FittingDesignService extends BaseService {
          *
          * 此方法，会成Application.start方法中，默认执行
          *
+         * @deprecated a legacy api in sdk(version >= 2.0.0).
          */
         viewSelected(): Promise<void>;
         /**
          * 指定模型的 ID，将当前模型加载到工具方案当中
          *
          * @param id 模型ID
+         * @deprecated a legacy api in sdk(version >= 2.0.0).
          */
         viewModelById(id: string | string[]): Promise<void>;
+        /**
+         * 通过模型id渲染指定模型
+         * >目前仅支持顶层模型、组合渲染
+         */
+        viewParamModel({ id }: {
+            id: string;
+        }): Promise<void>;
         /**
          * 重置视图展示视角
          */
@@ -3194,7 +3290,7 @@ export declare class FittingDesignService extends BaseService {
     /**
      * 二维空间下：坐标/向量/旋转/尺寸的基础表示
      */
-    declare interface Number2_2 {
+    declare interface Number2 {
         /**
          * x轴上的数据
          */
@@ -3208,7 +3304,7 @@ export declare class FittingDesignService extends BaseService {
     /**
      * 三维空间下，坐标/向量/旋转/尺寸的基础表示
      */
-    declare interface Number3_2 extends Number2_2 {
+    declare interface Number3 extends Number2 {
         /**
          * z轴方向数据
          */