@manycore/custom-sdk 1.7.0-rc.0 → 1.8.4-rc.0

package/index.d.ts

@@ -1,7 +1,11 @@
 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 { PlankArea } from '@qunhe/miniapp-model-viewer-core/src/model/base/plankArea';
+import { ServService } from 'servkit';
 
 declare interface AMap<K, V> {
     clear(): void;
@@ -22,8 +26,13 @@ declare interface AMap<K, V> {
  * ```
  */
 export declare class Application {
-    constructor();
     private serviceMap;
+    private sappSDK;
+    constructor();
+    /**
+     * 判断当前是否在定制小程序下运行
+     */
+    isInCustomMiniAppMode(): boolean;
     /**
      * 启动对接2.0应用
      *
@@ -34,7 +43,7 @@ export declare class Application {
      * await application.start();
      * ```
      */
-    start(): Promise<void>;
+    start(option?: IApplicationStartOption): Promise<void>;
     /**
      * 初始化语言类型(默认不需要处理)
      *
@@ -71,6 +80,44 @@ export declare class Application {
     getService<T extends BaseService>(serv: {
         new (): T;
     }): T;
+    /**
+     * 在对接2.0，提供调用定制小程序服务的能力，兼容历史代码
+     *
+     * 可以参见[定制小程序相关API](https://manual.kujiale.com/custom-miniapp-sdk/)
+     *
+     * @example
+     * ```
+     * import { CustomDesignParamModelService } from '@manycore/custom-miniapp-sdk';
+     *
+     * const s = application.getCustomMiniAppService(CustomDesignParamModelService);
+     * ```
+     *
+     */
+    getCustomMiniAppService<T extends typeof ServService>(decl: T): IServClientService<T> | undefined;
+    getCustomMiniAppService<M extends {
+        [key: string]: typeof ServService;
+    }>(decls: M): {
+        [key in keyof M]: IServClientService<M[key]> | undefined;
+    };
+    /**
+     * 在对接2.0，提供调用定制小程序服务的能力，兼容历史代码
+     *
+     * 可以参见[定制小程序相关API](https://manual.kujiale.com/custom-miniapp-sdk/)
+     *
+     * @example
+     * ```
+     * import { CustomDesignParamModelService } from '@manycore/custom-miniapp-sdk';
+     *
+     * const s = application.getCustomMiniAppServiceUnSafe(CustomDesignParamModelService);
+     * ```
+     *
+     */
+    getCustomMiniAppServiceUnSafe<T extends typeof ServService>(decl: T): IServClientService<T>;
+    getCustomMiniAppServiceUnSafe<M extends {
+        [key: string]: typeof ServService;
+    }>(decls: M): {
+        [key in keyof M]: IServClientService<M[key]>;
+    };
 }
 
 /**
@@ -80,6 +127,24 @@ declare abstract class BaseService {
     __onDestroy?(): void;
 }
 
+/**
+ * 定制模型真分类过滤列表默认值
+ */
+export declare const CUSTOM_MODEL_CATEGORY_FILTER = [
+/**
+* 装饰陈设
+*/
+596,
+/**
+* 参数化软装
+*/
+2048,
+/**
+* 软装部件
+*/
+2049,
+];
+
 /**
  * 模型相关控制的逻辑
  *
@@ -161,12 +226,26 @@ export declare enum ECameraMoveDirection {
     BACK = "BACK"
 }
 
+/**
+ * 线是否顺时针的值
+ */
+declare enum EClockWise {
+    /**
+     * 顺时针
+     */
+    TRUE = "true",
+    /**
+     * 逆时针
+     */
+    FALSE = "false"
+}
+
 /**
  * 交互模式
  */
 export declare enum EDesignMode {
     /**
-     * 自定模式
+     * 自定义模式
      */
     CUSTOM = 'custom',
     /**
@@ -183,6 +262,36 @@ export declare enum EDesignMode {
     PRODUCT = 'product',
 }
 
+/**
+ * 模型类型
+ */
+export declare enum EElementType {
+    /**
+     * 参数化模型
+     */
+    PARAM_MODEL = 'paramModel',
+    /**
+     * 参数化组合
+     */
+    PARAM_MODEL_ASSEMBLY = 'paramModelAssembly',
+    /**
+     * 孔
+     */
+    HOLE = 'hole',
+    /**
+     * 槽
+     */
+    GROOVE = 'groove',
+    /**
+     * 五金
+     */
+    HARDWARE = 'hardware',
+    /**
+     * 五金槽
+     */
+    HARDWARE_GROOVE = 'hardwareGroove',
+}
+
 /**
  * 孔槽配件类型
  */
@@ -274,6 +383,24 @@ export declare enum ELineType {
     ELLIPSE_ARC = 3,
 }
 
+/**
+ * 线的类型
+ */
+declare enum ELineType_3 {
+    /**
+     * 直线
+     */
+    SEGMENT = 0,
+    /**
+     * 圆弧
+     */
+    CIRCLE_ARC = 1,
+    /**
+     * 椭圆
+     */
+    ELLIPSE_ARC = 3
+}
+
 /**
  * 模型类型
  */
@@ -286,6 +413,10 @@ export declare enum EModelType {
      * 模型组合
      */
     PARAM_MODEL_ASSEMBLY = 'param_model_assembly',
+    /**
+     * 孔槽五金模型
+     */
+    FITTING_MODEL = 'fitting_model',
 }
 
 /**
@@ -307,27 +438,98 @@ declare enum EParamModelType {
 }
 
 declare enum EParamType {
+    /**
+     * 浮点数
+     */
     FLOAT = "float",
+    /**
+     * 二维浮点数
+     */
     FLOAT2 = "float2",
+    /**
+     * 三维浮点数
+     */
     FLOAT3 = "float3",
+    /**
+     * 浮点数
+     */
     FLOAT_BUFFER = "floatbuf",
+    /**
+     * 二维浮点数
+     */
     FLOAT2_BUFFER = "float2buf",
+    /**
+     * 三维浮点数
+     */
     FLOAT3_BUFFER = "float3buf",
+    /**
+     * 引用
+     */
     REFERENCE = "reference",
+    /**
+     * 整数
+     */
     INT = "int",
+    /**
+     * 整数
+     */
     INT_BUFFER = "intbuf",
+    /**
+     * 字符串
+     */
     STRING = "string",
+    /**
+     * 轮廓,一般为商品ID
+     */
     SHAPE = "shape",
+    /**
+     * 材质，一般存储为商品ID
+     */
     MATERIAL = "material",
+    /**
+     * 布尔
+     */
     BOOLEAN = "boolean",
+    /**
+     * 布尔
+     */
     BOOLEAN_BUFFER = "booleanbuf",
+    /**
+     * 适配
+     */
     FIT = "fit",
+    /**
+     * 路径
+     */
     PATH = "paramcornerpath",
+    /**
+     * 样式
+     */
     STYLE = "style",
+    /**
+     * 字符串
+     */
     FORMULA_STRING = "formulaString",
+    /**
+     * 多布尔
+     */
     BOOLEAN_LIST = "booleanlist"
 }
 
+/**
+ * 板件轮廓路径类型
+ */
+export declare enum EPlankPathType {
+    /**
+     * 内部路径，例如某个挖洞
+     */
+    INNER = 'inner',
+    /**
+     * 外部路径
+     */
+    OUTER = 'outer',
+}
+
 /**
  * 点的类型
  */
@@ -348,6 +550,32 @@ export declare enum EPointType {
      * 切圆，就是内挖一个倒圆的形状
      */
     CUT_CIRCLE = 3,
+    /**
+     * 椭圆
+     */
+    ELLIPSE = 4,
+}
+
+/**
+ * 点的类型
+ */
+declare enum EPointType_2 {
+    /**
+     * 普通点
+     */
+    NONE = 0,
+    /**
+     * 倒圆
+     */
+    CIRCLE = 1,
+    /**
+     * 倒角
+     */
+    LINE = 2,
+    /**
+     * 切圆，就是内挖一个倒圆的形状
+     */
+    CUT_CIRCLE = 3
 }
 
 /**
@@ -442,6 +670,18 @@ export declare enum ETriggerType {
     DB_CLICK = 'double_click',
 }
 
+/**
+ * 附加通用参数-几何体颜色key
+ * @default 孔：0x00ff00 槽：0x1e90ff 五金槽：0x1e90ff
+ */
+export declare const FITTING_PARAM_GEOMETRY_COLOR_KEY = '$$geometry_color';
+
+/**
+ * 附加通用参数-几何体不透明度key
+ * @default 1
+ */
+export declare const FITTING_PARAM_GEOMETRY_OPACITY_KEY = '$$geometry_opacity';
+
 /**
  * 孔槽方案相关数据的管理
  *
@@ -558,7 +798,7 @@ export declare class FittingDesignService extends BaseService {
      /**
       * 删除当前孔槽方案(解锁主工具模型)
       *
-      * 主工具当中，模型的锁定与解锁，与当前模型是不存在孔槽方案有关
+      * 主工具当中，模型的锁定与解锁，与当前模型是不是存在孔槽方案有关
       * 默认情况下，option不传时，清空当前正在编辑的模型的孔槽方案，当传入modelId时，表示清空指定模型的孔槽方案数据
       *
       * * @example
@@ -570,6 +810,28 @@ export declare class FittingDesignService extends BaseService {
      clearDesign(options?: IBaseOptions): Promise<void>;
     }
 
+    /**
+     * 配置孔槽特殊标识
+     *
+     * @example
+     * ```typescript
+     * const fittingHintService = application.getService(FittingHintService );
+     * ```
+     */
+    export declare class FittingHintService extends BaseService {
+        /**
+         * 设置五金孔槽高亮
+         * @param conf IFittingHintOption
+         */
+        setFittingHint(conf: IFittingHintOption): void;
+        /**
+         * 清空当前已经配置的标识信息
+         *
+         * @param id 待删除标识信息的模型ID，默认清空所有
+         */
+        clearFittingHint(id?: string | string[]): void;
+    }
+
     /**
      * 提供孔槽模型操作能力
      *
@@ -595,6 +857,8 @@ export declare class FittingDesignService extends BaseService {
         }): Promise<void>;
     }
 
+    export declare type IApplicationStartOption = ITerminalConfig;
+
     /**
      * 孔槽数据基础示意
      */
@@ -615,10 +879,16 @@ export declare class FittingDesignService extends BaseService {
 
     /**
      * 附加通用参数存储
+     *
+     * **内部占用key:**
+     * - $$geometry_color: 孔槽五金槽模型颜色
+     * - $$geometry_opacity: 孔槽五金槽模型不透明度
      */
     export declare interface IBaseFittingParameters {
         /**
          * 通用参数的key
+         *
+         * 不建议使用 **$$** 开头命名， **$$** 开头通常为SDK内部使用参数
          */
         key: string;
         /**
@@ -714,18 +984,32 @@ export declare class FittingDesignService extends BaseService {
         update?: IUpdateInfo[];
     }
 
+    /**
+     * 场景内的某个模型
+     */
+    export declare interface IElement {
+        /**
+         * 模型(paramModel|孔|槽|五金槽|五金)ID
+         */
+        id: string;
+        /**
+         * 模型类型
+         */
+        type: EElementType;
+    }
+
     /**
      * 自定义模式，hover触发模型高亮回调
      */
     export declare interface IFindHintModel {
-        (rayTarget: IParamModelLite): void | ISceneHintOption | ISceneHintOption[];
+        (rayTarget: IParamModelLite | IFittingModelLite): void | ISceneHintOption | ISceneHintOption[];
     }
 
     /**
      * 自定义模式，单击、双击触发模型选中回调
      */
     export declare interface IFindSelectModel {
-        (rayTarget: IParamModelLite, triggerType: ETriggerType):
+        (rayTarget: IParamModelLite | IFittingModelLite, triggerType: ETriggerType):
         | void
         | ISceneSelectOption
         | ISceneSelectOption[];
@@ -779,6 +1063,24 @@ export declare class FittingDesignService extends BaseService {
      */
     export declare type IFittingHardwareGrooves = Record<string, IHardwareGrooveData[]>;
 
+    /**
+     * 五金孔槽模型ID - 标识信息
+     *
+     * @example
+     *
+     * ```json
+     * {
+     *     "89D2793C-2B23-41A9-BA6E-4E3908490057": {
+     *         "outline": {
+     *             "color": "#234432",
+     *             "opacity": 0.8,
+     *          }
+     *      }
+     * }
+     * ```
+     */
+    export declare type IFittingHintOption = Record<string, IHintFitting>;
+
     /**
      * 方案中，所有孔的数据
      */
@@ -837,9 +1139,13 @@ export declare class FittingDesignService extends BaseService {
     export declare interface IGetParamModelJsonOption extends IBaseOptions {
         /**
          * 是否强制重新获取
-         * @default true 默认值为true,当前浏览模型时，获取json数据时，将会缓存
+         * @default false 默认值为false,当获取正在查看的模型json数据时，默认情况会使用状态中的缓存数据，如果需要强制走后端重新获取，此字段需要传入true
          */
         force?: boolean;
+        /**
+         * 模板id
+         */
+        templateId?: string;
     }
 
     export declare interface IGrooveData extends IBaseHoleGrooveData {
@@ -927,6 +1233,13 @@ export declare class FittingDesignService extends BaseService {
         opacity: number;
     }
 
+    export declare interface IHintFitting {
+        /**
+         * 轮廓高亮信息
+         */
+        outline: IHintBase;
+    }
+
     /**
      * 配置默认的高亮配置信息
      */
@@ -996,16 +1309,104 @@ export declare class FittingDesignService extends BaseService {
         intersectedGroups: IIntersectedGroup[];
     }
 
+    /**
+     * 轮廓路径线段表示
+     */
+    export declare interface ILine extends ILineBase {
+        /**
+         * 获取实际渲染端点
+         * >线段两端
+         */
+        getRenderPoints(): [Number2, Number2];
+        /**
+         * 设置线段的高亮，高亮深度为板件厚度
+         * @param hint 高亮配置
+         */
+        setHint(hint: IHintBase): void;
+        /**
+         * 清除高亮
+         */
+        clearHint(): void;
+        /**
+         * 获取高亮
+         */
+        getHint(): IHintBase | undefined;
+    }
+
+    /**
+     * 线段表示
+     */
+    export declare interface ILineBase {
+        /**
+         * 线条类型
+         */
+        type: ELineType;
+        /**
+         * 圆弧是否为顺时针
+         */
+        clockwise?: boolean;
+        /**
+         * 圆弧是否为劣弧
+         */
+        minorArc?: boolean;
+        /**
+         * 圆弧半径
+         */
+        radius?: number;
+        /**
+         * 椭圆弧长轴
+         */
+        majorRadius?: number;
+        /**
+         * 椭圆弧短轴
+         */
+        minorRadius?: number;
+        /**
+         * 椭圆圆心
+         */
+        ellipseCenter?: Number2;
+    }
+
     export declare type ILineData = ILineDataBase | ILineDataCircle;
 
-    export declare interface ILineDataBase {
+    declare interface ILineData_2 {
+        /**
+         * 线条类型
+         */
+        type: ELineType_3;
+        /**
+         * 是否顺时针
+         */
+        clockwise?: boolean;
+        /**
+         * 优弧劣弧 (只有弧线有)
+         */
+        minorArc?: boolean;
+        /**
+         * 半径 (只有弧线有)
+         */
+        radius?: number;
+    }
+
+    /**
+     * 直线
+     */
+    export declare interface ILineDataBase
+    extends Omit<
+    ILineBase,
+    'ellipseCenter' | 'clockwise' | 'minorArc' | 'radius' | 'majorRadius' | 'minorRadius'
+    > {
         /**
          * 线条类型
          */
         type: ELineType_2.SEGMENT;
     }
 
-    export declare interface ILineDataCircle {
+    /**
+     * 弧线
+     */
+    export declare interface ILineDataCircle
+    extends Omit<ILineBase, 'ellipseCenter' | 'majorRadius' | 'minorRadius'> {
         /**
          * 线条类型
          */
@@ -1154,6 +1555,20 @@ export declare class FittingDesignService extends BaseService {
          * @type string
          */
         readonly id: string;
+        /**
+         * 模型在方案中的名称
+         * @readonly
+         * @public
+         * @type string
+         */
+        name: string;
+        /**
+         * 模型的备注信息
+         * @readonly
+         * @public
+         * @typedef Number3
+         */
+        remark?: string;
         /**
          * 当前位置信息
          * @readonly
@@ -1226,6 +1641,26 @@ export declare class FittingDesignService extends BaseService {
          * @readonly
          */
         isRoot?: boolean;
+        /**
+         * 获取当前模型名称
+         */
+        getName(): string;
+        /**
+         * 更改当前模型名称
+         *
+         * @param name 需重新设置的模型名称
+         */
+        setName(name: string): void;
+        /**
+         * 获取模型备注信息
+         */
+        getRemark(): string | undefined;
+        /**
+         * 更改模型备注信息
+         *
+         * @param remark 备注信息
+         */
+        setRemark(remark: string): void;
         /**
          * 更新当前模型的位置信息
          * @param position {Number3} 坐标
@@ -1321,6 +1756,13 @@ export declare class FittingDesignService extends BaseService {
          * 将一个序列化之后的模型，进行反序列化操作
          */
         deserialize(model: string): IParamModelLite_2;
+        /**
+         * 刷新某个模型，此API仅适用于反向对接的模型：
+         * 当前某个模型在后台更新了，但用户方案中，存储的仍然是之前的版本，调用此方法后，会自动将当前模型更新成后台最新的版本。
+         * > 需要注意的是，此方法会导致更新后，模型ID存在变化
+         * > 模型中，添加的appendChild或addAccessory等参数，可能会失效不起作用
+         */
+        forceUpdate(update?: boolean): void;
     }
 
     /**
@@ -1391,6 +1833,91 @@ export declare class FittingDesignService extends BaseService {
         setPrimitiveOverride(value: boolean): void;
     }
 
+    declare interface IPathData {
+        /**
+         * 偏移, 正数扩大路径范围，负数缩小路径范围
+         */
+        offset?: number;
+        /**
+         * 轮廓上的点
+         */
+        paramPoints: IPointData_2[];
+        /**
+         * 轮廓上的线
+         */
+        paramPathLines: ILineData_2[];
+    }
+
+    /**
+     * 板件轮廓描述
+     */
+    export declare interface IPlankArea {
+        /**
+         * 由板件原始轮廓数据解析出的所有路径
+         */
+        paths: IPlankPath[];
+
+        /**
+         * 对板件原始轮廓数据进行非直角端点处理、重合、偏移计算后的实际展示路径
+         */
+        getRealPaths(): IPlankArea;
+    }
+
+    /**
+     * 板件轮廓上的某条闭合路径，例如外轮廓、内部挖洞
+     */
+    export declare interface IPlankPath {
+        /**
+         * 路径类型
+         */
+        type: EPlankPathType;
+        /**
+         * 路径上的所有端点
+         */
+        points: IPoint[];
+        /**
+         * 路径上的所有线段
+         */
+        lines: ILine[];
+        /**
+         * 获取路径上实际渲染的端点
+         */
+        getRenderPoints(): Number2[];
+    }
+
+    declare interface IPlankPathData {
+        path?: IPathData;
+        holes: IPathData[];
+        /**
+         * other fields
+         */
+        [key: string]: any;
+    }
+
+    /**
+     * 轮廓路径端点表示
+     */
+    export declare interface IPoint extends IPointBase {
+        /**
+         * 获取实际渲染端点
+         * >非直角端点为渲染线段的两端，直角端点两个端点相同
+         */
+        getRenderPoints(): [Number2, Number2];
+        /**
+         * 设置非直角端点渲染线段的高亮，高亮深度为板件厚度
+         * @param hint 高亮配置
+         */
+        setHint(hint: IHintBase): void;
+        /**
+         * 清除高亮
+         */
+        clearHint(): void;
+        /**
+         * 获取高亮
+         */
+        getHint(): IHintBase | undefined;
+    }
+
     /**
      * 点的基本类型
      */
@@ -1398,11 +1925,32 @@ export declare class FittingDesignService extends BaseService {
         type: EPointType;
         /**
          * 点的位置
-         *
-         * @example
-         * "123,-345"
          */
-        position: Number3;
+        position: Number3 | Number2;
+        /**
+         * 切角长度
+         */
+        cornerCutDistance?: [number, number];
+        /**
+         * 椭圆端点长轴
+         */
+        majorRadius?: number;
+        /**
+         * 椭圆端点短轴
+         */
+        minorRadius?: number;
+        /**
+         * 圆弧、切圆半径
+         */
+        radius?: number;
+        /**
+         * 圆弧是否为顺时针
+         */
+        clockwise?: boolean;
+        /**
+         * 圆弧、椭圆弧圆心偏移
+         */
+        offset?: Number2;
     }
 
     /**
@@ -1410,10 +1958,60 @@ export declare class FittingDesignService extends BaseService {
      */
     export declare type IPointData = IPointWithNone | IPointWithLine | IPointWithCircle | IPointWithCutCircle;
 
+    declare interface IPointData_2 {
+        /**
+         * 点的位置
+         *
+         * @example
+         * "123,-345"
+         */
+        position: string;
+        /**
+         * 点的类型
+         */
+        type: EPointType_2;
+        /**
+         * 切角两边上切点距离当前点的距离（切角专用）
+         */
+        cornerCutDistance?: [string, string];
+        /**
+         * 是否顺时针, 前端必须保证逆时针
+         */
+        clockwise?: EClockWise;
+        /**
+         * 半径 (倒圆切圆专用)
+         * @example
+         * "345.12"
+         */
+        radius?: string;
+        /**
+         * 圆心偏移 (切圆专用)
+         * @example
+         * "345.12"
+         */
+        offset?: string;
+        /**
+         * 长轴 (椭圆必传)
+         * @example
+         * "345.12"
+         */
+        majorRadius?: string;
+        /**
+         * 短轴 (椭圆必传)
+         * @example
+         * "345.12"
+         */
+        minorRadius?: string;
+    }
+
     /**
      * 倒圆
      */
-    export declare interface IPointWithCircle extends IPointBase {
+    export declare interface IPointWithCircle
+    extends Omit<
+    IPointBase,
+    'clockwise' | 'majorRadius' | 'minorRadius' | 'cornerCutDistance' | 'offset'
+    > {
         /**
          * 切角类型
          */
@@ -1444,7 +2042,8 @@ export declare class FittingDesignService extends BaseService {
     /**
      * 切角
      */
-    export declare interface IPointWithLine extends IPointBase {
+    export declare interface IPointWithLine
+    extends Omit<IPointBase, 'clockwise' | 'majorRadius' | 'minorRadius' | 'radius' | 'offset'> {
         /**
          * 切角类型
          */
@@ -1458,7 +2057,11 @@ export declare class FittingDesignService extends BaseService {
     /**
      * 普通点类型
      */
-    export declare interface IPointWithNone extends IPointBase {
+    export declare interface IPointWithNone
+    extends Omit<
+    IPointBase,
+    'cornerCutDistance' | 'majorRadius' | 'minorRadius' | 'radius' | 'offset'
+    > {
         /**
          * 普通点
          */
@@ -1487,21 +2090,12 @@ export declare class FittingDesignService extends BaseService {
     /**
      * 高亮模型描述
      */
-    export declare type ISceneHintOption = ISceneSelectOption;
+    export declare type ISceneHintOption = IElement;
 
     /**
      * 选中模型描述
      */
-    export declare interface ISceneSelectOption {
-        /**
-         * 模型id | 组合id
-         */
-        id: string;
-        /**
-         * 模型类型
-         */
-        type: EModelType;
-    }
+    export declare type ISceneSelectOption = IElement;
 
     /**
      * 当前选中的数据
@@ -1574,6 +2168,51 @@ export declare class FittingDesignService extends BaseService {
         grooveColor: number;
     }
 
+    /**
+     * 场景中通用配置能力
+     *
+     * @example
+     * ```json
+     * {
+     *   holeOpacity: 0.8, // 孔透明度
+     *   grooveOpacity: 0.5 // 槽、五金槽透明度
+     * }
+     * ```
+     */
+    export declare interface ISettingCommon {
+        /**
+         * 孔不透明度
+         *
+         * @default 1
+         */
+        holeOpacity: number;
+        /**
+         * 槽不透明度
+         *
+         * @default 1
+         */
+        grooveOpacity: number;
+        /**
+         * 渲染忽略模型真分类ID
+         * @default CUSTOM_MODEL_CATEGORY_FILTER
+         */
+        renderIgnoreCategory: number | number[];
+    }
+
+    /**
+     * 启动时，配置terminal信息
+     */
+    export declare interface ITerminalConfig {
+        /**
+         * 请输入clientId
+         */
+        clientId?: string;
+        /**
+         * 请输入连接超时时间
+         */
+        timeout?: number;
+    }
+
     /**
      * 展示交接信息时的筛选行为
      */
@@ -1672,6 +2311,10 @@ export declare class FittingDesignService extends BaseService {
          * 最大值为 500
          */
         pageNum?: number;
+        /**
+         * 真分类ID过滤
+         */
+        ignoreCategory?: number | number[];
     }
 
     declare interface IUpdateInfo {
@@ -2031,7 +2674,7 @@ export declare class FittingDesignService extends BaseService {
          *
          * @example
          * ```typescript
-         * await modelService.getParamData();
+         * await modelService.getParamIntersected();
          * ```
          *
          * @param options
@@ -2040,6 +2683,7 @@ export declare class FittingDesignService extends BaseService {
         /**
          * 获取方案顶层模型列表
          * @param options
+         * @param options.ignoreCategory 真分类id过滤，默认值 CUSTOM_MODEL_CATEGORY_FILTER
          */
         getTopParamModels(options?: ITopParamModelListOption): Promise<ITopParamModelDataResponse>;
         getParamModelPhotoById(modelId: string | string[]): Promise<IParamModelPhotoResponse[]>;
@@ -2054,7 +2698,12 @@ export declare class FittingDesignService extends BaseService {
      * ```
      */
     export declare class ModelViewerSelectionService extends BaseService {
-        constructor();
+        /**
+         * if watch EVENT_SELECT_CHANGED event
+         *
+         * @ignore
+         */
+        private hasWatchSelectionChange;
         /**
          * 获取当前选中的数据
          */
@@ -2102,6 +2751,10 @@ export declare class FittingDesignService extends BaseService {
          * @ignore
          */
         private __generateEntity;
+        /**
+         * @ignore
+         */
+        private startWatchSelectedChangedEvent;
         /**
          * @ignore
          */
@@ -2127,6 +2780,74 @@ export declare class FittingDesignService extends BaseService {
         __onDestroy(): void;
     }
 
+    /**
+     * ModelViewerSelectionService v2版本: 作为范围为场景内五金孔槽、参数化组合、参数化模型
+     *
+     * 主要是用来与场景交互的，监听当前选中的对象, 获取选中的内容
+     *
+     * @example
+     * ```typescript
+     * const viewerSelectionV2Service = application.getService(ModelViewerSelectionV2Service);
+     * ```
+     */
+    export declare class ModelViewerSelectionV2Service extends BaseService {
+        /**
+         * if watch EVENT_SELECT_CHANGED_V2 event
+         *
+         * @ignore
+         */
+        private hasWatchSelectionChange;
+        /**
+         * 获取当前选中的数据
+         */
+        getSelected(): IElement[];
+        /**
+         * 设置选中的模型，支持多选
+         * @param option IElement | IElement[]
+         */
+        select(option: IElement | IElement[]): void;
+        /**
+         * 取消场景当中选中内容
+         * @param option IElement | IElement[]
+         */
+        unSelect(option?: IElement | IElement[]): void;
+        /**
+         * 监听当前选中内容
+         * @param fn
+         */
+        on(fn: (param: IElement | IElement[]) => any): void;
+        /**
+         * 取消监听选中变化
+         * @param fn
+         */
+        off(fn?: (param: IElement | IElement[]) => any): void;
+        /**
+         * 监听当前选中的内容(触发一次后自动取消)
+         * @param fn
+         */
+        once(fn: (param: IElement | IElement[]) => any): void;
+        /**
+         * @ignore
+         */
+        private startWatchSelectedChangedEvent;
+        /**
+         * @ignore
+         */
+        private onSelectedChanged;
+        /**
+         * @ignore
+         */
+        private _genEntityFromElement;
+        /**
+         * @ignore
+         */
+        private _genElement;
+        /**
+         * @ignore
+         */
+        __onDestroy(): void;
+    }
+
     /**
      * 主要提供了模型展示的控制能力：重置视角，边框，半透明，以及展示颜色配置
      *
@@ -2164,11 +2885,16 @@ export declare class FittingDesignService extends BaseService {
          */
         toggleModelTransparent(flag: boolean): void;
         /**
-         * 设置交接信息展示颜色
+         * 配置模型展示信息
+         *  - 交界面、交接体颜色
+         *  - 五金与柜体交界面、五金与柜体交接体颜色
+         *  - 孔颜色、不透明度
+         *  - 槽、五金槽颜色、不透明度
+         *  - 模型渲染真分类过滤
          *
          * > `settings`,需要在application.start()后，立即被设置，否则展示会读取至之前配置信息，展示可能存在异常。
          */
-        setting(settings: Partial<ISettingColor>): void;
+        setting(settings: Partial<ISettingColor & ISettingCommon>): void;
         /**
          * 刷新场景内所有模型
          *
@@ -2191,7 +2917,7 @@ export declare class FittingDesignService extends BaseService {
     /**
      * 二维空间下：坐标/向量/旋转/尺寸的基础表示
      */
-    declare interface Number2 {
+    declare interface Number2_2 {
         /**
          * x轴上的数据
          */
@@ -2205,13 +2931,49 @@ export declare class FittingDesignService extends BaseService {
     /**
      * 三维空间下，坐标/向量/旋转/尺寸的基础表示
      */
-    declare interface Number3_2 extends Number2 {
+    declare interface Number3_2 extends Number2_2 {
         /**
          * z轴方向数据
          */
         z: number;
     }
 
+    /**
+     * 底层板件轮廓服务，支持对模型json中轮廓解析为特定的类，暴露对轮廓数据查看、计算、修改的方法
+     *
+     * - 解析板件json数据
+     * - 同步板件轮廓修改到渲染场景中
+     *
+     * @example
+     * ```typescript
+     * const plankPathService = application.getService(PlankPathService);
+     * const modelID = 'xx'; // 板件模型ID
+     * const plankPathData: IPlankPathData = { ... }; // 轮廓数据
+     * const plankArea = plankPathService.parseModelPlankPath(modelID, plankPathData);
+     * // change plankArea
+     * plankPathService.syncModelPlankPath(plankArea); // 同步修改
+     * ```
+     */
+    export declare class PlankPathService extends BaseService {
+        /**
+         * 解析板件轮廓
+         *
+         * @param option.modelID 关联模型ID
+         * @param option.data `IDesignExportData.paramModel` 仅处理底层板件数据(只有板件包含轮廓路径)
+         * @returns
+         */
+        parseModelPlankPath(option: {
+            modelID: string;
+            data: IPlankPathData;
+        }): PlankArea;
+        /**
+         * 同步板件轮廓修改到渲染场景中
+         *
+         * @param plankArea
+         */
+        syncModelPlankPath(plankArea: IPlankArea): void;
+    }
+
     /**
      * 提供渲染场景的控制
      *