@manycore/custom-sdk 1.13.0 → 1.13.4-beta.0

package/index.d.ts

@@ -1,10 +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 { PlankArea } from '@qunhe/miniapp-model-viewer-core/src/model/base/plankArea';
+import { Number2 as Number2_2 } from '@manycore/custom-miniapp-sdk';
 import { ServService } from 'servkit';
 
 declare interface AMap<K, V> {
@@ -29,6 +26,7 @@ export declare class Application {
     private serviceMap;
     private sappSDK;
     constructor();
+    private startOnApiCalledEvent;
     /**
      * 判断当前是否在定制小程序下运行
      */
@@ -182,6 +180,24 @@ export declare class CustomModelService extends BaseService {
     }): Promise<void>;
 }
 
+/**
+ * 自定议字段枚举类型
+ */
+declare enum EBzPropertyType {
+    /**
+     * 数字类型
+     */
+    number = "number",
+    /**
+     * 字符串类型
+     */
+    string = "string",
+    /**
+     * boolean类型
+     */
+    boolean = "boolean"
+}
+
 /**
  * 相机展示模式
  */
@@ -240,6 +256,26 @@ declare enum EClockWise {
     FALSE = "false"
 }
 
+/**
+ * 定制模型类型
+ */
+declare enum ECustomModelType {
+    /** 实体模型 */
+    PARAM_ENTITY = 1,
+    /** 家具模型，3d模型文件 */
+    PARAM_FURNITURE = 2,
+    /** 基元模型，需要计算mesh */
+    PARAM_PRIMITIVE = 3,
+    /** 虚拟模型 */
+    PARAM_VIRTUAL = 4,
+    /** 参数化组合：即在设计方案当中，选中多个模型，组合之后的结果 */
+    PARAM_ASSEMBLY = 5,
+    /**
+     * 参数化组合：在参数化编辑器中，对多个模型进行组合操作
+     */
+    TEMPLATE_ASSEMBLY = 6
+}
+
 /**
  * 交互模式
  */
@@ -315,7 +351,7 @@ export declare enum EFittingType {
     /**
      * 交接面信息
      */
-    INTERSECTED = 'intersected',
+    INTERSECTED = "intersected"
 }
 
 /**
@@ -325,11 +361,11 @@ export declare enum EIntersectedCreatedType {
     /**
      * 板与板之间产生的交界
      */
-    BOTH_PLANK,
+    BOTH_PLANK = 0,
     /**
      * 板与五金之间产生的交界信息
      */
-    PLANK_FURNITURE,
+    PLANK_FURNITURE = 1
 }
 
 /**
@@ -339,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
 }
 
 /**
@@ -365,28 +419,39 @@ export declare enum ELanguage {
 }
 
 /**
- * 线的类型
+ * 设计对象 ID
  */
-export declare enum ELineType {
-    /**
-     * 直线
-     */
-    SEGMENT = 0,
-    /**
-     * 圆弧
-     */
-    CIRCLE_ARC = 1,
-    /**
-     * 椭圆
-     * 当前代码中，暂不支持
-     */
-    ELLIPSE_ARC = 3,
+declare interface ElementId {
+    /** 实例 ID */
+    id: string;
+    /** 类型 */
+    type: ElementType;
+}
+
+/**
+ * 定制设计对象类型
+ */
+declare enum ElementType {
+    /** 全屋定制家具 */
+    Wardrobe = "Wardrobe",
+    /** 全屋定制家具副本 */
+    WardrobeCopy = "WardrobeCopy",
+    /** 厨卫 */
+    Cabinet = "Cabinet",
+    /** 厨卫副本 */
+    CabinetCopy = "CabinetCopy",
+    /** 门窗 */
+    DoorWindow = "DoorWindow",
+    /** 门窗副本 */
+    DoorWindowCopy = "DoorWindowCopy",
+    /** 定制组合 */
+    CustomGroup = "CustomGroup"
 }
 
 /**
  * 线的类型
  */
-declare enum ELineType_3 {
+export declare enum ELineType {
     /**
      * 直线
      */
@@ -554,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
 }
 
 /**
@@ -787,6 +835,9 @@ export declare class FittingDesignService extends BaseService {
       * 保存孔/槽数据至方案
       * 如果design不传，即表示将分步保存数据存储至后端
       *
+      * 之前的孔槽会被design直接替换
+      *
+      * 如果只想展示孔槽可使用 {@link FittingDesignService.appendFittingDesign}
       * @example
       * ```typescript
       * await fittingDesignService.saveDesign({
@@ -848,7 +899,7 @@ export declare class FittingDesignService extends BaseService {
     export declare class FittingModelService extends BaseService {
         /**
          * 获取所有五金孔槽模型
-         * @param modelId paramModel id，查找相关联孔槽五金
+         * @param modelId 模型id，查找相关联的孔槽五金或模型下所有的板件关联的孔槽五金
          * @returns Promise<IFittingModelLite[]>
          */
         getAllFittingModels(modelId?: string): Promise<IFittingModelLite[]>;
@@ -914,17 +965,14 @@ export declare class FittingDesignService extends BaseService {
          * 孔/槽的深度
          */
         depth: number;
-
         /**
          * 所处的板面
          */
         plankFaceId: number;
-
         /**
          * 起点
          */
         start: Number3;
-
         /**
          * 终点
          */
@@ -933,6 +981,7 @@ export declare class FittingDesignService extends BaseService {
 
     /**
      * 交接信息
+     * @vm-type UnknownType
      */
     export declare interface IBaseIntersected {
         /**
@@ -945,7 +994,6 @@ export declare class FittingDesignService extends BaseService {
          * * 如果为交接体，length为8
          */
         points: Number3[];
-
         /**
          * 当前交接信息产生的元件ID
          */
@@ -985,6 +1033,52 @@ export declare class FittingDesignService extends BaseService {
         modelId?: string;
     }
 
+    /**
+     * 自定议参数
+     */
+    declare interface IBzParamModelLiteProperty<T extends number | string | boolean = string> {
+        /**
+         * 参数命名空间
+         */
+        namespace: string;
+        /**
+         * 参数名称，为key
+         */
+        name: string;
+        /**
+         * 参数中存取的值
+         */
+        value: string | undefined;
+        /**
+         * 当前字段数据类型
+         */
+        type: EBzPropertyType | string;
+        /**
+         * 当前参数是否只读
+         */
+        readonly: boolean;
+        /**
+         * 获取参数名称
+         */
+        getName(): string;
+        /**
+         * 获取参数命名空间
+         */
+        getNamespace(): string;
+        /**
+         * 获取当前参数类型
+         */
+        getType(): string;
+        /**
+         * 读取值
+         */
+        getValue(): T | undefined;
+        /**
+         * 设置值
+         */
+        setValue(value: T): void;
+    }
+
     declare interface IChangeMap {
         update?: IUpdateInfo[];
     }
@@ -1049,19 +1143,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 {
@@ -1076,16 +1170,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 - 标识信息
      *
@@ -1109,6 +1218,11 @@ export declare class FittingDesignService extends BaseService {
      */
     export declare type IFittingHoleCollect = Record<string, IHoleData[]>;
 
+    /**
+     * 方案中，所有孔的数据
+     */
+    declare type IFittingHoleCollect_2 = Record<string, IHoleData[]>;
+
     /**
      * 五金孔槽通用模型
      */
@@ -1157,17 +1271,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 {}
+
     /**
      * 获取模型数据
      */
@@ -1184,7 +1352,6 @@ export declare class FittingDesignService extends BaseService {
     }
 
     export declare interface IGrooveData extends IBaseHoleGrooveData {
-        // 槽宽
         width: number;
     }
 
@@ -1196,22 +1363,18 @@ export declare class FittingDesignService extends BaseService {
          * 建模原点在板件坐标系下的坐标
          */
         position: Number3;
-
         /**
          * 相对建模坐标系中夹角，不传默认没有任何基于板件坐标的旋转，会将五金以建模原点放在 position 上，五金建模方向和板件建模方向一致进行摆放。
          */
         rotate: Number3;
-
         /**
          * 相对建模坐标系中缩放，不传默认五金和上传大小完全一致
          */
         scale: Number3;
-
         /**
          * 商品ID
          */
         brandGoodId: string;
-
         /**
          * 关联孔槽ID
          */
@@ -1226,7 +1389,6 @@ export declare class FittingDesignService extends BaseService {
          * 槽的深度
          */
         depth: number;
-
         /**
          * 所处的板面
          */
@@ -1316,6 +1478,16 @@ export declare class FittingDesignService extends BaseService {
         diameter: number;
     }
 
+    /**
+     * 交接信息
+     */
+    export declare interface IIntersectedData {
+        /**
+         * 交接信息集合
+         */
+        intersectedGroups: IIntersectedGroup[];
+    }
+
     /**
      * 一组交接信息
      */
@@ -1337,12 +1509,7 @@ export declare class FittingDesignService extends BaseService {
     /**
      * 交接信息
      */
-    export declare interface IIntersectedResult {
-        /**
-         * 交接信息集合
-         */
-        intersectedGroups: IIntersectedGroup[];
-    }
+    export declare type IIntersectedResult = IIntersectedData;
 
     /**
      * 轮廓路径线段表示
@@ -1352,7 +1519,7 @@ export declare class FittingDesignService extends BaseService {
          * 获取实际渲染端点
          * >线段两端
          */
-        getRenderPoints(): [Number2, Number2];
+        getRenderPoints(): [Number2_2, Number2_2];
         /**
          * 设置线段的高亮，高亮深度为板件厚度
          * @param hint 高亮配置
@@ -1402,50 +1569,26 @@ export declare class FittingDesignService extends BaseService {
         ellipseCenter?: Number2;
     }
 
-    declare interface ILineData$1 {
-        /**
-         * 线条类型
-         */
-        type: ELineType_3;
-        /**
-         * 是否顺时针
-         */
-        clockwise?: boolean;
-        /**
-         * 优弧劣弧 (只有弧线有)
-         */
-        minorArc?: boolean;
-        /**
-         * 半径 (只有弧线有)
-         */
-        radius?: number;
-    }
-
     export declare type ILineData = ILineDataBase | ILineDataCircle;
 
     /**
      * 直线
      */
-    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;
         /**
          * 是否顺时针
          */
@@ -1609,6 +1752,12 @@ export declare class FittingDesignService extends BaseService {
          * @type string
          */
         readonly id: string;
+        /**
+         * 定制模型类型，在 @modelType 基础上进行了细分
+         * @public
+         * @type ECustomModelType
+         */
+        type: ECustomModelType;
         /**
          * 模型在方案中的名称
          * @readonly
@@ -1629,7 +1778,7 @@ export declare class FittingDesignService extends BaseService {
          * @public
          * @typedef Number3
          */
-        position: Number3_2;
+        position: Number3;
         /**
          * 当前模型的旋转信息
          * @readonly
@@ -1637,21 +1786,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
@@ -1659,6 +1808,10 @@ export declare class FittingDesignService extends BaseService {
          * @typedef AMap<string, IParamModelLiteParam>
          */
         readonly params: AMap<string, IParamModelLiteParam>;
+        /**
+         * 模型当前用户自定义属性
+         */
+        readonly bzProperties: AMap<string, IBzParamModelLiteProperty>;
         /**
          * 商品ID，即商品后台的商品ID
          * @readonly
@@ -1695,6 +1848,13 @@ export declare class FittingDesignService extends BaseService {
          * @readonly
          */
         isRoot?: boolean;
+        /**
+         * 当前模型是否是合法（隐藏）模型
+         * @readonly
+         * @public
+         * @type boolean
+         */
+        readonly legal?: boolean;
         /**
          * 获取当前模型名称
          */
@@ -1719,38 +1879,48 @@ 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;
+        /**
+         * 获取当前模型所处的工具线
+         */
+        getToolType(): EToolType_2 | undefined;
+        /**
+         * 设置当前模型工具线
+         * @param toolType
+         * @throws 如果工具线不被允许，将会报错
+         */
+        setToolType(toolType: EToolType_2): void;
         /**
          * 模型的复制，返回一个新的`ParamModel`对象
          */
-        clone(): IParamModelLite_2;
+        clone(): this;
         /**
          * 将当前模型与父级模型断开联系
          * 可以更直接的理解为：删除当前模型
@@ -1760,31 +1930,32 @@ export declare class FittingDesignService extends BaseService {
         /**
          * 查找当前模型的父节点
          */
-        getParent(): IParamModelLite_2 | undefined;
+        getParent(): this | undefined;
         /**
-         * 获取当前模型的顶层模型，如果当前模型就是顶层模型，则会返回undefined
+         * 获取root节点，如果当前模型为root节点，则返回自身
+         * @param recursion 存在多root时，是否获取最顶层root
          */
-        getRoot(): IParamModelLite_2 | undefined;
+        getRoot(recursion?: boolean): this;
         /**
          * 获取当前模型的所有子模型
          */
-        getChild(): IParamModelLite_2[];
+        getChild(): this[];
         /**
          * 获取当前模型下的所有非原生模型
          * @description 说明一下：非原生模型可以大致理解为：在方案当中，手动生成一个模型，添加到其他模型上；与之对应子模型可以理解为原生模型，即参数
          * 化编辑中自带的模型
          */
-        getAccessory(): IParamModelLite_2[];
+        getAccessory(): this[];
         /**
          * 向当前模型中，添加一个子模型；一般会向包裹层当中，添加子模型；另外，五金配件，也必须使用此方法添加
          * @param child {IParamModelLite} 待添加的模型
          */
-        appendChild(child: IParamModelLite_2): void;
+        appendChild(child: this): void;
         /**
          * 向当前模型中，添加一个非原生模型；一般会使用在添加五金
          * @param accessory {IParamModelLite} 待添加的模型
          */
-        appendAccessory(accessory: IParamModelLite_2): void;
+        appendAccessory(accessory: this): void;
         /**
          * 获取当前模型中的参数信息(参数即在参数化编辑中的信息)
          * @example
@@ -1792,6 +1963,25 @@ export declare class FittingDesignService extends BaseService {
          * @param name {string} 参数名称
          */
         getParam(name: string): IParamModelLiteParam | undefined;
+        /**
+         * 获取用户自定义属性
+         * @param name {string} 属性名称
+         * @param namespace {string} 命名空间(当不传时，即表示当前小程序下的命名空间，格式如下：miniapp-${appId})
+         */
+        getBzProperty(name: string, namespace?: string): IBzParamModelLiteProperty | undefined;
+        /**
+         * 判断当前模型是否包含某个属性
+         * @param name {string} 属性名称
+         * @param namespace {string} 命名空间
+         */
+        hasBzProperty(name: string, namespace?: string): boolean;
+        /**
+         * 删除自定义属性、当删除成功时，将返回true，否则返回false
+         *
+         * @param name
+         * @param namespace
+         */
+        removeBzProperty(name: string, namespace?: string): boolean;
         /**
          * 判断当前模型是否包含某个参数
          * @param name {string} 参数名称
@@ -1809,7 +1999,7 @@ export declare class FittingDesignService extends BaseService {
         /**
          * 将一个序列化之后的模型，进行反序列化操作
          */
-        deserialize(model: string): IParamModelLite_2;
+        deserialize(model: string): this;
         /**
          * 刷新某个模型，此API仅适用于反向对接的模型：
          * 当前某个模型在后台更新了，但用户方案中，存储的仍然是之前的版本，调用此方法后，会自动将当前模型更新成后台最新的版本。
@@ -1817,6 +2007,10 @@ export declare class FittingDesignService extends BaseService {
          * > 模型中，添加的appendChild或addAccessory等参数，可能会失效不起作用
          */
         forceUpdate(update?: boolean): void;
+        /**
+         * 获取设计对象id
+         */
+        getElementId(): ElementId | undefined;
     }
 
     /**
@@ -1887,34 +2081,27 @@ export declare class FittingDesignService extends BaseService {
         setPrimitiveOverride(value: boolean): void;
     }
 
-    declare interface IPathData {
-        /**
-         * 偏移, 正数扩大路径范围，负数缩小路径范围
-         */
-        offset?: number;
-        /**
-         * 轮廓上的点
-         */
-        paramPoints: IPointData$1[];
-        /**
-         * 轮廓上的线
-         */
-        paramPathLines: ILineData$1[];
-    }
-
     /**
      * 板件轮廓描述
      */
     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;
     }
 
     /**
@@ -1952,78 +2139,53 @@ export declare class FittingDesignService extends BaseService {
         /**
          * 获取路径上实际渲染的端点
          */
-        getRenderPoints(): Number2[];
+        getRenderPoints(): Number2_2[];
     }
 
     declare interface IPlankPathData {
-        path?: IPathData;
-        holes: IPathData[];
+        path?: IPlankPathPathData;
+        holes: IPlankPathPathData[];
         /**
          * other fields
          */
         [key: string]: any;
     }
 
-    /**
-     * 轮廓路径端点表示
-     */
-    export declare interface IPoint extends IPointBase {
+    declare interface IPlankPathLineData {
         /**
-         * 获取实际渲染端点
-         * >非直角端点为渲染线段的两端，直角端点两个端点相同
+         * 线条类型
          */
-        getRenderPoints(): [Number2, Number2];
+        type: ELineType;
         /**
-         * 设置非直角端点渲染线段的高亮，高亮深度为板件厚度
-         * @param hint 高亮配置
+         * 是否顺时针
          */
-        setHint(hint: IHintBase): void;
+        clockwise?: boolean;
         /**
-         * 清除高亮
+         * 优弧劣弧 (只有弧线有)
          */
-        clearHint(): void;
+        minorArc?: boolean;
         /**
-         * 获取高亮
+         * 半径 (只有弧线有)
          */
-        getHint(): IHintBase | undefined;
+        radius?: number;
     }
 
-    /**
-     * 点的基本类型
-     */
-    export declare interface IPointBase {
-        type: EPointType;
-        /**
-         * 点的位置
-         */
-        position: Number3 | Number2;
-        /**
-         * 切角长度
-         */
-        cornerCutDistance?: [number, number];
+    declare interface IPlankPathPathData {
         /**
-         * 椭圆端点长轴
-         */
-        majorRadius?: number;
-        /**
-         * 椭圆端点短轴
-         */
-        minorRadius?: number;
-        /**
-         * 圆弧、切圆半径
+         * 偏移, 正数扩大路径范围，负数缩小路径范围
          */
-        radius?: number;
+        offset?: number;
         /**
-         * 圆弧是否为顺时针
+         * 轮廓上的点
          */
-        clockwise?: boolean;
+        paramPoints: IPlankPathPointData[];
         /**
-         * 圆弧、椭圆弧圆心偏移
+         * 轮廓上的线
          */
-        offset?: Number2;
+        paramPathLines: IPlankPathLineData[];
     }
 
-    declare interface IPointData$1 {
+    declare interface IPlankPathPointData {
         /**
          * 点的位置
          *
@@ -2034,7 +2196,7 @@ export declare class FittingDesignService extends BaseService {
         /**
          * 点的类型
          */
-        type: EPointType_2;
+        type: EPointType;
         /**
          * 切角两边上切点距离当前点的距离（切角专用）
          */
@@ -2069,6 +2231,68 @@ export declare class FittingDesignService extends BaseService {
         minorRadius?: string;
     }
 
+    /**
+     * 轮廓路径端点表示
+     */
+    export declare interface IPoint extends IPointBase {
+        /**
+         * 获取实际渲染端点
+         * >非直角端点为渲染线段的两端，直角端点两个端点相同
+         */
+        getRenderPoints(): [Number2_2, Number2_2];
+        /**
+         * 设置非直角端点渲染线段的高亮，高亮深度为板件厚度
+         * @param hint 高亮配置
+         */
+        setHint(hint: IHintBase): void;
+        /**
+         * 清除高亮
+         */
+        clearHint(): void;
+        /**
+         * 获取高亮
+         */
+        getHint(): IHintBase | undefined;
+    }
+
+    /**
+     * 点的基本类型
+     */
+    export declare interface IPointBase {
+        type: EPointType;
+        /**
+         * 点的位置
+         *
+         * @example
+         * "123,-345"
+         */
+        position: Number3 | Number2;
+        /**
+         * 切角长度
+         */
+        cornerCutDistance?: [number, number];
+        /**
+         * 椭圆端点长轴
+         */
+        majorRadius?: number;
+        /**
+         * 椭圆端点短轴
+         */
+        minorRadius?: number;
+        /**
+         * 圆弧、切圆半径
+         */
+        radius?: number;
+        /**
+         * 圆弧是否为顺时针
+         */
+        clockwise?: boolean;
+        /**
+         * 圆弧、椭圆弧圆心偏移
+         */
+        offset?: Number2;
+    }
+
     /**
      * 点的类型参数
      */
@@ -2077,11 +2301,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'> {
         /**
          * 切角类型
          */
@@ -2112,8 +2332,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'> {
         /**
          * 切角类型
          */
@@ -2127,11 +2346,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'> {
         /**
          * 普通点
          */
@@ -2728,12 +2943,22 @@ export declare class FittingDesignService extends BaseService {
          * const json = await service.getModelJsonDataByModelId('请输入模型ID');
          * ```
          *
-         * > 以上 API 暂不建议在非对接 2.0 环境下使用，主要是与孔/槽方案数据存在关联关系。
-         > > 替代的 service 为`CustomDesignExportService`，将会在 9 月底最新的`@manycore/custom-miniapp-sdk`中提供。
+         * > 以上 API 暂不建议在非对接 2.0 环境下使用，主要是与孔/槽方案数据存在关联关系
+         > > 耗时API 建议后台异步请求并配合做好缓存
+         > > >替代的 service 为`CustomDesignExportService`，将会在 9 月底最新的`@manycore/custom-miniapp-sdk`中提供。
          *
-         * @example
+         * @example 最佳实践
          * ```typescript
-         * await modelService.getParamData();
+         * // 后台异步任务 串行执行不建议并发
+         * const cache = new Map<string, any>();
+         * for (const model of models) {
+         *     const { id } = model;
+         *     const data = await getParamData({ modelId: id });
+         *     cache.set(id, data)
+         * }
+         *
+         * // 主线程获取
+         * cache.get(id);
          * ```
          *
          * @param options
@@ -2741,10 +2966,19 @@ export declare class FittingDesignService extends BaseService {
         getParamData(options?: IGetParamModelJsonOption): Promise<any>;
         /**
          * 获取模型的交接数据
-         *
+         * > 耗时API 建议后台异步请求并配合做好缓存
          * @example
          * ```typescript
-         * await modelService.getParamIntersected();
+         * // 后台异步任务 串行执行不建议并发
+         * const cache = new Map<string, any>();
+         * for (const model of models) {
+         *     const { id } = model;
+         *     const data = await getParamIntersected({ modelId: id });
+         *     cache.set(id, data)
+         * }
+         *
+         * // 主线程获取
+         * cache.get(id);
          * ```
          *
          * @param options
@@ -3008,7 +3242,7 @@ export declare class FittingDesignService extends BaseService {
     /**
      * 二维空间下：坐标/向量/旋转/尺寸的基础表示
      */
-    declare interface Number2_2 {
+    declare interface Number2 {
         /**
          * x轴上的数据
          */
@@ -3022,7 +3256,7 @@ export declare class FittingDesignService extends BaseService {
     /**
      * 三维空间下，坐标/向量/旋转/尺寸的基础表示
      */
-    declare interface Number3_2 extends Number2_2 {
+    declare interface Number3 extends Number2 {
         /**
          * z轴方向数据
          */
@@ -3056,7 +3290,7 @@ export declare class FittingDesignService extends BaseService {
         parseModelPlankPath(option: {
             modelID: string;
             data: IPlankPathData;
-        }): PlankArea;
+        }): IPlankArea;
         /**
          * 同步板件轮廓修改到渲染场景中
          *