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

package/index.d.ts

@@ -4,14 +4,16 @@ import { IServClientService } from 'servkit';
 import { Number2 as Number2_2 } from '@manycore/custom-miniapp-sdk';
 import { ServService } from 'servkit';
 
-declare interface AMap<K, V> {
-    clear(): void;
-    delete(key: K): boolean;
-    forEach(callbackfn: (value: V, key: K, map: AMap<K, V>) => void, thisArg?: any): void;
-    get(key: K): V | undefined;
-    has(key: K): boolean;
-    set(key: K, value: V): this;
-    readonly size: number;
+/**
+ * app 配置服务
+ */
+export declare class AppConfigService extends BaseService {
+    /**
+     * 更改获取JSON数据的默认配置信息
+     *
+     * @param option
+     */
+    setGetJsonConfig(option: IJsonOutputConfig): void;
 }
 
 /**
@@ -31,6 +33,11 @@ export declare class Application {
      * 判断当前是否在定制小程序下运行
      */
     isInCustomMiniAppMode(): boolean;
+    /**
+     * 添加调试的utils
+     * - 获取已初始化的service
+     */
+    private createDebugUtils;
     /**
      * 启动对接2.0应用
      *
@@ -158,7 +165,7 @@ export declare class CustomModelService extends BaseService {
      */
     getAllCustomModels(): Promise<IParamModelLite[]>;
     /**
-     * 根据id获取所有模型
+     * 根据id获取指定模型
      * @param id 模型id
      * @returns Promise<IParamModelLite | undefined>
      */
@@ -183,6 +190,7 @@ export declare class CustomModelService extends BaseService {
 /**
  * 自定议字段枚举类型
  */
+
 declare enum EBzPropertyType {
     /**
      * 数字类型
@@ -242,20 +250,6 @@ export declare enum ECameraMoveDirection {
     BACK = "BACK"
 }
 
-/**
- * 线是否顺时针的值
- */
-declare enum EClockWise {
-    /**
-     * 顺时针
-     */
-    TRUE = "true",
-    /**
-     * 逆时针
-     */
-    FALSE = "false"
-}
-
 /**
  * 定制模型类型
  */
@@ -368,6 +362,20 @@ export declare enum EIntersectedCreatedType {
     PLANK_FURNITURE = 1
 }
 
+/**
+ * 支持配置输出的交接数据类型
+ */
+export declare enum EIntersectedInfoType {
+    /**
+     * 交接体
+     */
+    SHELL = "1",
+    /**
+     * 贯穿交接体
+     */
+    THROUGH_SHELL = "3"
+}
+
 /**
  * 交接数据的数据类型
  */
@@ -379,7 +387,11 @@ export declare enum EIntersectedType {
     /**
      * 交界面
      */
-    FACE = "2"
+    FACE = "2",
+    /**
+     * 贯穿交接体
+     */
+    THROUGH_SHELL = "3"
 }
 
 /**
@@ -464,7 +476,11 @@ export declare enum ELineType {
      * 椭圆
      * 当前代码中，暂不支持
      */
-    ELLIPSE_ARC = 3
+    ELLIPSE_ARC = 3,
+    /**
+     * 圆
+     */
+    CIRCLE_CENTER = 4
 }
 
 /**
@@ -485,6 +501,44 @@ export declare enum EModelType {
     FITTING_MODEL = 'fitting_model',
 }
 
+/**
+ * 当前参数的类型
+ */
+declare enum EParamForm {
+    /**
+     * 单值, 老数据
+     * */
+    SINGLE = 0,
+    /**
+     * 区间
+     * */
+    RANGE = 1,
+    /**
+     * 可选
+     * */
+    OPTION = 2,
+    /**
+     * 递增
+     * */
+    STEP = 3,
+    /**
+     * 复合公式, 可以在公式和值之间切换
+     * */
+    COMPOUND_FORMULA = 4,
+    /**
+     * 公式
+     * */
+    FIXED_FORMULA = 5,
+    /**
+     * 固定值
+     * */
+    FIXED_VALUE = 6,
+    /**
+     * 复合公式, 公式+可选的组合
+     * */
+    COMPOUND_FORMULA_OPTION = 7
+}
+
 /**
  * 当前模型的类型
  */
@@ -582,6 +636,28 @@ declare enum EParamType {
     BOOLEAN_LIST = "booleanlist"
 }
 
+/**
+ * 值的单位类型
+ */
+declare enum EParamUnitType {
+    /**
+     * 单位默认值
+     */
+    DEFAULT = 0,
+    /**
+     * 长度单位
+     */
+    LENGTH = 1,
+    /**
+     * 面积单位
+     */
+    AREA = 2,
+    /**
+     * 数量单位
+     */
+    NUMBER = 3
+}
+
 /**
  * 板件轮廓路径类型
  */
@@ -619,7 +695,11 @@ export declare enum EPointType {
     /**
      * 椭圆
      */
-    ELLIPSE = 4
+    ELLIPSE = 4,
+    /**
+     * 圆心点
+     */
+    CIRCLE_CENTER = 5
 }
 
 /**
@@ -757,14 +837,12 @@ 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();
      * ```
@@ -777,8 +855,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>;
     /**
@@ -797,7 +875,6 @@ 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>;
     /**
@@ -823,7 +900,6 @@ 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?: {
          /**
@@ -851,7 +927,6 @@ 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;
@@ -867,25 +942,8 @@ 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;
     }
 
     /**
@@ -908,6 +966,16 @@ export declare class FittingDesignService extends BaseService {
          * @param id 待删除标识信息的模型ID，默认清空所有
          */
         clearFittingHint(id?: string | string[]): void;
+        /**
+         * 设置五金突出展示
+         */
+        setFittingHardwareHint(conf: Record<string, IHintBase>): void;
+        /**
+         * 清空当前已经配置的标识信息
+         *
+         * @param id 待删除标识信息的模型ID，默认清空所有
+         */
+        clearFittingHardwareHint(id?: string | string[]): void;
     }
 
     /**
@@ -1005,40 +1073,7 @@ export declare class FittingDesignService extends BaseService {
      * 交接信息
      * @vm-type UnknownType
      */
-    export declare interface IBaseIntersected {
-        /**
-         * 当前交接信息所处的板面信息
-         */
-        plankFaceId: number;
-        /**
-         * 当前交接信息所有顶点的信息
-         * * 如果为交接面，length为4
-         * * 如果为交接体，length为8
-         */
-        points: Number3[];
-        /**
-         * 当前交接信息产生的元件ID
-         */
-        linkedModelId: string;
-        /**
-         * 交接信息产生元件的父母ID
-         */
-        linkedParentModelId: string;
-        /**
-         * 交接数据的数据类型
-         */
-        '@type': EIntersectedType;
-        /**
-         * @ignore
-         * 交接体的shell数据
-         */
-        shell?: string;
-        /**
-         * 交接体板面是否需要开槽
-         * 当五金与板面产生的交接信息，为板面的部分，则为true
-         */
-        needGroove?: boolean;
-    }
+    export declare type IBaseIntersected = (ICommonIntersected<EIntersectedType.FACE> & IPlankFaceId) | (ICommonIntersected<EIntersectedType.SHELL> & IPlankFaceId) | ICommonIntersected<EIntersectedType.THROUGH_SHELL>;
 
     /**
      * 获取模型数据/交界面/体数据参数
@@ -1046,7 +1081,7 @@ export declare class FittingDesignService extends BaseService {
     export declare interface IBaseOptions {
         /**
          * 最长等待时间(以ms为单位)
-         * @default 500000
+         * @default 50000
          */
         timeout?: number;
         /**
@@ -1106,6 +1141,37 @@ export declare class FittingDesignService extends BaseService {
         update?: IUpdateInfo[];
     }
 
+    declare interface ICommonIntersected<T extends EIntersectedType> {
+        /**
+         * 当前交接信息所有顶点的信息
+         * * 如果为交接面，length为4
+         * * 如果为交接体，length为8
+         */
+        points: Number3[];
+        /**
+         * 当前交接信息产生的元件ID
+         */
+        linkedModelId: string;
+        /**
+         * 交接信息产生元件的父母ID
+         */
+        linkedParentModelId: string;
+        /**
+         * 交接数据的数据类型
+         */
+        '@type': T;
+        /**
+         * @ignore
+         * 交接体的shell数据
+         */
+        shell?: string;
+        /**
+         * 交接体板面是否需要开槽
+         * 当五金与板面产生的交接信息，为板面的部分，则为true
+         */
+        needGroove?: boolean;
+    }
+
     /**
      * 场景内的某个模型
      */
@@ -1350,6 +1416,13 @@ export declare class FittingDesignService extends BaseService {
          * @default EProductDirection.XY
          */
         direction?: EProductDirection;
+        /**
+         * 支持配置的交接类型
+         * 默认输出交接面&交接体
+         * 交接面不支持配置（一定输出）
+         * 支持配置输出交接体/贯穿交接体
+         */
+        intersectedInfoType?: EIntersectedInfoType[];
     }
 
     /**
@@ -1370,8 +1443,14 @@ export declare class FittingDesignService extends BaseService {
         force?: boolean;
         /**
          * 模板id
+         * 如果不传，将从配置模板中，获取默认配置
          */
         templateId?: string;
+        /**
+         * 忽略重置默认位置，如果不传入此参数，将会从`AppConfigService`设置的配置中读取
+         * @default false
+         */
+        ignoreResetPosition?: boolean;
     }
 
     export declare interface IGrooveData extends IBaseHoleGrooveData {
@@ -1534,6 +1613,19 @@ export declare class FittingDesignService extends BaseService {
      */
     export declare type IIntersectedResult = IIntersectedData;
 
+    export declare interface IJsonOutputConfig {
+        /**
+         * 默认模板ID
+         */
+        defaultTemplateId?: string;
+
+        /**
+         * 忽略重置默认位置
+         * @default false
+         */
+        ignoreResetPosition?: boolean;
+    }
+
     /**
      * 轮廓路径线段表示
      */
@@ -1682,7 +1774,7 @@ export declare class FittingDesignService extends BaseService {
      *     ]
      *   },
      *   "89D2793C-2B23-41A9-BA6E-4E3FS8490057": {
-     *     // 自定义高亮配置信息
+     *     // 自定议高亮配置信息
      *     "hintBorder": {
      *       "color": "#234432",
      *       "opacity": 0.8
@@ -1712,6 +1804,12 @@ export declare class FittingDesignService extends BaseService {
         invalidateList: string[];
     }
 
+    /** 交互优先级配置 */
+    export declare type InteractionPriorityConfig = Record<
+    Exclude<EElementType, EElementType.PARAM_MODEL_ASSEMBLY>,
+    number
+    >;
+
     /**
      * 获取交接信息
      *
@@ -1764,7 +1862,8 @@ export declare class FittingDesignService extends BaseService {
 
     /**
      * 对定制参数化模型进行精简处理后的结果
-     * @name ParamModel
+     * @name CustomModel
+     * @vm-type CustomModel
      */
     declare interface IParamModelLite_2 {
         /**
@@ -1778,63 +1877,10 @@ export declare class FittingDesignService extends BaseService {
         /**
          * 定制模型类型，在 @modelType 基础上进行了细分
          * @public
+         * @readonly
          * @type ECustomModelType
          */
         type: ECustomModelType;
-        /**
-         * 模型在方案中的名称
-         * @readonly
-         * @public
-         * @type string
-         */
-        name: string;
-        /**
-         * 模型的备注信息
-         * @readonly
-         * @public
-         * @typedef Number3
-         */
-        remark?: string;
-        /**
-         * 当前位置信息
-         * @readonly
-         * @public
-         * @typedef Number3
-         */
-        position: Number3;
-        /**
-         * 当前模型的旋转信息
-         * @readonly
-         * @public
-         * @typedef Number3
-         * @deprecated 将废弃，推荐使用 rotation
-         */
-        rotate: Number3;
-        /**
-         * 当前模型的旋转信息
-         * @readonly
-         * @public
-         * @typedef Number3
-         */
-        rotation: Number3;
-        /**
-         * 当前尺寸信息
-         * @readonly
-         * @public
-         * @typedef Number3
-         */
-        size: Number3;
-        /**
-         * 模型当中自定议的参数信息
-         * @readonly
-         * @protected
-         * @typedef AMap<string, IParamModelLiteParam>
-         */
-        readonly params: AMap<string, IParamModelLiteParam>;
-        /**
-         * 模型当前用户自定义属性
-         */
-        readonly bzProperties: AMap<string, IBzParamModelLiteProperty>;
         /**
          * 商品ID，即商品后台的商品ID
          * @readonly
@@ -1878,6 +1924,13 @@ export declare class FittingDesignService extends BaseService {
          * @type boolean
          */
         readonly legal?: boolean;
+        /**
+         * 当前尺寸信息
+         * @readonly
+         * @public
+         * @typedef Number3
+         */
+        readonly size: Number3;
         /**
          * 获取当前模型名称
          */
@@ -1909,17 +1962,15 @@ export declare class FittingDesignService extends BaseService {
          */
         getPosition(): Number3;
         /**
-         * 更新当前模型的旋转信息
-         * @description 特别说明，定制模型，使用的是右手坐标系，rotate字段中
-         * @param rotate {Number3} 旋转的弧度
-         * @deprecated 将废弃，推荐使用 rotation
+         * 通过公式设置旋转
+         * @internal
          */
-        setRotate(rotate: Number3): void;
+        setPositionFormula(position: Number3Formula): void;
         /**
-         * 获取当前模型相对父级的旋转信息
-         * @deprecated 将废弃，推荐使用 rotation
+         * 读取模型位置旋转
+         * @internal
          */
-        getRotate(): Number3;
+        getPositionFormula(): Number3Formula | undefined;
         /**
          * 更新当前模型的旋转信息
          * @description 特别说明，定制模型，使用的是右手坐标系，rotation字段中
@@ -1930,6 +1981,16 @@ export declare class FittingDesignService extends BaseService {
          * 获取当前模型相对父级的旋转信息
          */
         getRotation(): Number3;
+        /**
+         * 通过公式设置旋转
+         * @internal
+         */
+        setRotationFormula(rotation: Number3Formula): void;
+        /**
+         * 读取模型位置旋转
+         * @internal
+         */
+        getRotationFormula(): Number3Formula | undefined;
         /**
          * 获取当前模型所处的工具线
          */
@@ -2034,6 +2095,10 @@ export declare class FittingDesignService extends BaseService {
          * 获取设计对象id
          */
         getElementId(): ElementId | undefined;
+        /**
+         * 获取当前模型中的板件轮廓信息
+         */
+        getPlankPathAsync(): Promise<IParamModelLitePlankPath | undefined>;
     }
 
     /**
@@ -2041,6 +2106,50 @@ export declare class FittingDesignService extends BaseService {
      * @vm-type IParamType
      */
     declare interface IParamModelLiteParam<T = any> {
+        /**
+         * 获取参数名称
+         */
+        getName(): string;
+        /**
+         * 当前参数描述信息
+         */
+        getDescription(): string | undefined;
+        /**
+         * 获取参数简写名称
+         */
+        getSimpleName(): string | undefined;
+        /**
+         * 获取参数的显示名称
+         */
+        getDisplayName(): string;
+        /**
+         * 当前参数在工具中是否可见
+         */
+        getVisible(): boolean | undefined;
+        /**
+         * 当前字段是否被覆盖
+         */
+        isOverridden(): boolean | undefined;
+        /**
+         * 取消当前字段被覆盖
+         */
+        cancelOverride(): any;
+        /**
+         * 获取当前字段的单位类型
+         */
+        getUnitType(): EParamUnitType | undefined;
+        /**
+         * 获取当前参数类型
+         */
+        getParamForm(): EParamForm | undefined;
+        /**
+         * 判断当前值是否使用复合公式
+         */
+        isUsingMixFormula(): boolean;
+        /**
+         * 重置当前参数使用复合公式
+         */
+        useMixFormula(): void;
         /**
          * 获取当前参数解析后的值内容
          */
@@ -2061,7 +2170,7 @@ export declare class FittingDesignService extends BaseService {
          */
         setParsedValue(value: T): any;
         /**
-         * 获取当前参数类型
+         * 获取当前参数值类型
          */
         getType(): EParamType;
         /**
@@ -2090,21 +2199,99 @@ export declare class FittingDesignService extends BaseService {
          */
         getRecommendValues(): NamedValue[];
         /**
-         * 获取value展示的值
+         * 当为多布尔值时，展示的内容
          */
         getValueDisplayNames(): string[];
         /**
          * 是否需要将设置的参数覆盖原始参数信息
          * 仅对部分参数设计有效，具体细节，见对应场景
+         * @deprecated 直接调用isOverridden()方法即可
          */
         getPrimitiveOverride(): boolean;
         /**
          * 是否需要将设置的参数覆盖原始参数信息
+         * @deprecated 此逻辑，将在调用setValue时，自动完成此步骤，此方法可以忽略
          * @param value {boolean}
          */
         setPrimitiveOverride(value: boolean): void;
+        /**
+         * 获取公式
+         * @internal
+         */
+        getFormula(): string | undefined;
+        /**
+         * 设置公式
+         * @internal
+         * @param formula
+         */
+        setFormula(formula: string): void;
+    }
+
+    /**
+     * 模型的板件轮廓信息
+     */
+    declare interface IParamModelLitePlankPath {
+        /**
+         * 获取原始外轮廓
+         * 编辑器设置的外轮廓
+         */
+        getOriginOuterPath(): IPathData;
+        /**
+         * 获取原始内轮廓洞
+         * 编辑器设置的内轮廓洞
+         */
+        getOriginInnerHoles(): IPathData[];
+        /**
+         * 获取外轮廓
+         */
+        getOuterPath(): IPathData;
+        /**
+         * 获取内轮廓洞的集合
+         */
+        getInnerHoles(): IPathData[];
+        /**
+         * 设置外轮廓
+         * 全量替换原有的外轮廓
+         */
+        setOuterPath(path: IPathData): void;
+        /**
+         * 设置内轮廓洞
+         * 全量替换原有的内轮廓洞
+         */
+        setInnerHoles(holes: IPathData[]): void;
+        /**
+         * 获取轮廓值
+         * 调用updateAsync后取得准确
+         * 叠加offset后的最终结果
+         */
+        getResult(): IPlankPathResult;
+    }
+
+    /**
+     * 轮廓数据
+     */
+    declare interface IPathData {
+        /**
+         * 轮廓上的点
+         */
+        paramPoints: IPlankPathPoint[];
+        /**
+         * 轮廓上的线
+         */
+        paramPathLines: IPlankPathLine[];
+        /**
+         * other fields
+         */
+        [key: string]: any;
     }
 
+    declare type IPathResultData = IPathData & {
+        /**
+         * 轮廓绕向
+         */
+        clockwise?: boolean;
+    };
+
     /**
      * 板件轮廓描述
      */
@@ -2125,7 +2312,7 @@ export declare class FittingDesignService extends BaseService {
         /**
          * 获取外轮廓路径中心点坐标
          */
-        getCenterPoint(): Number2_2;
+        getCenterPoint(): Number2_2 | undefined;
     }
 
     /**
@@ -2144,6 +2331,13 @@ export declare class FittingDesignService extends BaseService {
         modelId: string;
     }
 
+    declare interface IPlankFaceId {
+        /**
+         * 当前交接信息所处的板面信息
+         */
+        plankFaceId: number;
+    }
+
     /**
      * 板件轮廓上的某条闭合路径，例如外轮廓、内部挖洞
      */
@@ -2175,7 +2369,7 @@ export declare class FittingDesignService extends BaseService {
         [key: string]: any;
     }
 
-    declare interface IPlankPathLineData {
+    declare interface IPlankPathLine {
         /**
          * 线条类型
          */
@@ -2191,9 +2385,11 @@ export declare class FittingDesignService extends BaseService {
         /**
          * 半径 (只有弧线有)
          */
-        radius?: number;
+        radius?: string;
     }
 
+    declare type IPlankPathLineData = ILineBase;
+
     declare interface IPlankPathPathData {
         /**
          * 偏移, 正数扩大路径范围，负数缩小路径范围
@@ -2209,12 +2405,12 @@ export declare class FittingDesignService extends BaseService {
         paramPathLines: IPlankPathLineData[];
     }
 
-    declare interface IPlankPathPointData {
+    declare interface IPlankPathPoint {
         /**
          * 点的位置
-         *
          * @example
          * "123,-345"
+         * "#W/2,#D/2"
          */
         position: string;
         /**
@@ -2226,9 +2422,11 @@ export declare class FittingDesignService extends BaseService {
          */
         cornerCutDistance?: [string, string];
         /**
-         * 是否顺时针, 前端必须保证逆时针
+         * 切圆必传
+         * 轮廓路径顺时针 true=外弧 false=内弧
+         * 轮廓路径逆时针 true=内弧 false=外弧
          */
-        clockwise?: EClockWise;
+        clockwise?: boolean;
         /**
          * 半径 (倒圆切圆专用)
          * @example
@@ -2238,7 +2436,8 @@ export declare class FittingDesignService extends BaseService {
         /**
          * 圆心偏移 (切圆专用)
          * @example
-         * "345.12"
+         * "0,0"
+         * "#W/2,#D/2"
          */
         offset?: string;
         /**
@@ -2255,6 +2454,22 @@ export declare class FittingDesignService extends BaseService {
         minorRadius?: string;
     }
 
+    declare type IPlankPathPointData = IPointBase;
+
+    /**
+     * 轮廓值
+     */
+    declare interface IPlankPathResult {
+        /**
+         * 外轮廓
+         */
+        outerPath: IPathResultData;
+        /**
+         * 内轮廓洞
+         */
+        innerHoles: IPathResultData[];
+    }
+
     /**
      * 轮廓路径端点表示
      */
@@ -2459,6 +2674,10 @@ export declare class FittingDesignService extends BaseService {
          * 交接体展示时，使用的颜色
          */
         intersectedBodyColor: number;
+        /**
+         * 贯穿交接体展示时，使用的颜色
+         */
+        intersectedThroughColor: number;
         /**
          * 五金与柜体之间，交接面产生的颜色
          */
@@ -2915,7 +3134,7 @@ export declare class FittingDesignService extends BaseService {
          *     ]
          *   },
          *   "89D2793C-2B23-41A9-BA6E-4E3FS8490057": {
-         *     // 自定义标识颜色
+         *     // 自定议标识颜色
          *     "hintBorder": {
          *       "color": "#234432",
          *       "opacity": 0.8
@@ -2986,7 +3205,6 @@ export declare class FittingDesignService extends BaseService {
          * ```
          *
          * @param options
-         * @deprecated a legacy api in sdk(version >= 2.0.0).
          */
         getParamData(options?: IGetParamModelJsonOption): Promise<any>;
         /**
@@ -3013,14 +3231,12 @@ 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[]>;
     }
@@ -3042,7 +3258,6 @@ export declare class FittingDesignService extends BaseService {
      * 主要是用来与场景交互的，监听当前选中的对象, 获取选中的内容
      *
      * @example
-     * @deprecated a legacy service in sdk(version >= 2.0.0).
      * ```typescript
      * const viewerSelectionService = application.getService(ModelViewerSelectionService);
      * ```
@@ -3056,7 +3271,6 @@ export declare class FittingDesignService extends BaseService {
         private hasWatchSelectionChange;
         /**
          * 获取当前选中的数据
-         * @deprecated a legacy api in sdk(version >= 2.0.0).
          */
         getSelected(): ISelected;
         /**
@@ -3064,7 +3278,6 @@ 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 = {
@@ -3081,7 +3294,6 @@ 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 = {
@@ -3115,19 +3327,16 @@ 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;
         /**
@@ -3223,26 +3432,14 @@ export declare class FittingDesignService extends BaseService {
     export declare class ModelViewerService extends BaseService {
         /**
          * 将工具方案中，选中的模型，加载到对接 2.0 小程序中展示
-         *
-         * 此方法，会成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>;
         /**
          * 重置视图展示视角
          */
@@ -3257,6 +3454,11 @@ export declare class FittingDesignService extends BaseService {
          * @param flag
          */
         toggleModelTransparent(flag: boolean): void;
+        /**
+         * 设置模型为全透明模式
+         * @param flag
+         */
+        toggleModelFullTransparent(flag: boolean): void;
         /**
          * 配置模型展示信息
          *  - 交界面、交接体颜色
@@ -3274,6 +3476,24 @@ export declare class FittingDesignService extends BaseService {
          * > example: 调用工具API修改模型材质纹理方向（或其他属性）后，调用该API可手动同步模型修改到小程序渲染场景中（效果同退出小程序后重新进入），如果小程序中不存在任意模型，则抛出错误.
          */
         refreshModel(): Promise<void>;
+        /**
+         * 修改场景中可交互对象的[优先级](https://manual.kujiale.com/custom-sdk#/mini-app/annotation/index?id=%e4%ba%a4%e4%ba%92%e4%bc%98%e5%85%88%e7%ba%a7)配置
+         * > 配置生效必须重新渲染模型
+         * @example
+         * ```
+         * const viewer = getApplication().getService(ModelViewerService);
+         * viewer.setInteractionPriority({ hole: 10, groove: 10, paramModel: 5 });
+         * viewer.viewSelected(); // 重新渲染模型
+         * viewer.viewModelById('xx'); // 指定渲染某个模型
+         * ```
+         *
+         * @param options
+         */
+        setInteractionPriority(options: Partial<InteractionPriorityConfig>): void;
+        /**
+         * 获取场景中可交互对象的优先级配置
+         */
+        getInteractionPriority(): InteractionPriorityConfig;
     }
 
     /**
@@ -3311,6 +3531,24 @@ export declare class FittingDesignService extends BaseService {
         z: number;
     }
 
+    /**
+     * 设置旋转/位置
+     */
+    declare interface Number3Formula {
+        /**
+         * X轴方向上的公式
+         */
+        x: string;
+        /**
+         * Y轴方向上的公式
+         */
+        y: string;
+        /**
+         * Z轴方向上的公式
+         */
+        z: string;
+    }
+
     /**
      * 底层板件轮廓服务，支持对模型json中轮廓解析为特定的类，暴露对轮廓数据查看、计算、修改的方法
      *