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

package/index.d.ts

@@ -2,7 +2,6 @@ import { IParamModelPhotoResponse } from '@manycore/custom-miniapp-sdk';
 import { IServClientService } from 'servkit';
 import { Number2 as Number2_2 } from '@manycore/custom-miniapp-sdk';
 import { ServService } from 'servkit';
-import { ServServiceMeta } from 'servkit';
 
 /**
  * 小程序发射器
@@ -16,7 +15,7 @@ export declare class AppBooter {
     private readonly proxyTerminals;
     private getCustomMiniAppService;
     constructor(option?: IApplicationStartOption);
-    initializeServer: (option?: ITerminalConfig | undefined) => Promise<ServServiceMeta[]>;
+    private initializeServer;
     /**
      * 启动的小程序地址
      * @param openParam.url 打开的小程序地址
@@ -168,6 +167,11 @@ export declare class Application {
     };
 }
 
+/**
+ * @vm-type UnknownType
+ */
+declare type AugmentedRequired<T extends object, K extends keyof T = keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+
 /**
  * @private
  */
@@ -175,6 +179,17 @@ declare abstract class BaseService {
     __onDestroy?(): void;
 }
 
+export declare enum CameraType {
+    /**
+     * 透视相机
+     */
+    Perspective = 0,
+    /**
+     * 正交相机
+     */
+    Orthographic = 1,
+}
+
 /**
  * 定制模型真分类过滤列表默认值
  */
@@ -231,7 +246,77 @@ export declare class CustomModelService extends BaseService {
 }
 
 /**
- * 自定议字段枚举类型
+ * 槽应用类型
+ */
+export declare enum EAppliedGrooveType {
+    /**
+     * 板件槽
+     */
+    PLANK = "PLANK",
+    /**
+     * 五金槽
+     */
+    FITTING = "FITTING",
+    /**
+     * 辅助槽
+     */
+    AUXILIARY = "AUXILIARY",
+    /**
+     * 拉米诺槽
+     */
+    LAMELLO = "LAMELLO",
+    /**
+     * 乐扣槽
+     */
+    LOCK = "LOCK",
+    /**
+     * 边型槽
+     */
+    EDGE = "EDGE",
+    /**
+     * 隐形件槽
+     */
+    INVISIBLE = "INVISIBLE",
+    /**
+     * 阵列槽
+     */
+    ARRAY = "ARRAY"
+}
+
+/**
+ * 孔的应用类型
+ */
+export declare enum EAppliedHoleType {
+    /**
+     * 板件孔
+     */
+    PLANK = "PLANK",
+    /**
+     * 五金孔
+     */
+    FITTING = "FITTING",
+    /**
+     * 辅助孔
+     */
+    AUXILIARY = "AUXILIARY"
+}
+
+/**
+ * 线段类型
+ */
+export declare enum EBomCurveType {
+    /**
+     * 线段
+     */
+    LineSeg = "LineSeg",
+    /**
+     * 弧线
+     */
+    Arc = "Arc"
+}
+
+/**
+ * 自定义字段枚举类型
  */
 
 declare enum EBzPropertyType {
@@ -363,6 +448,26 @@ export declare enum EElementType {
      * 五金槽
      */
     HARDWARE_GROOVE = 'hardwareGroove',
+    /**
+     * 孔V2
+     */
+    HOLE_V2 = 'holeV2',
+    /**
+     * 方槽
+     */
+    SQUARE_GROOVE = 'squareGroove',
+    /**
+     * 圆角方槽
+     */
+    ROUND_CORNER_GROOVE = 'roundCornerGroove',
+    /**
+     * 异形槽
+     */
+    SPECIAL_SHAPED_GROOVE = 'specialShapedGroove',
+    /**
+     * 路径槽
+     */
+    PATH_GROOVE = 'pathGroove',
 }
 
 /**
@@ -388,7 +493,65 @@ export declare enum EFittingType {
     /**
      * 交接面信息
      */
-    INTERSECTED = "intersected"
+    INTERSECTED = "intersected",
+    /**
+     * 孔V2
+     */
+    HOLE_V2 = "holeV2",
+    /**
+     * 方槽
+     */
+    SQUARE_GROOVE = "squareGroove",
+    /**
+     * 圆角方槽
+     */
+    ROUND_CORNER_GROOVE = "roundCornerGroove",
+    /**
+     * 异形槽
+     */
+    SPECIAL_SHAPED_GROOVE = "specialShapedGroove",
+    /**
+     * 路径槽
+     */
+    PATH_GROOVE = "pathGroove"
+}
+
+/**
+ * 槽几何类型
+ */
+export declare enum EGrooveGeometryType {
+    /**
+     * 方槽
+     */
+    SQUARE = "SQUARE",
+    /**
+     * 圆角方槽
+     */
+    ROUND_CORNER = "ROUND_CORNER",
+    /**
+     * 路径槽
+     */
+    PATH = "PATH",
+    /**
+     * 异形槽
+     */
+    SPECIAL_SHAPED = "SPECIAL_SHAPED"
+}
+
+/**
+ * 五金版本
+ * 主要为了区分五金类别
+ * 避免两者在API侧互相影响
+ */
+export declare enum EHardwareVersion {
+    /**
+     * 孔槽方案v1添加的接口
+     */
+    V1 = 'v1',
+    /**
+     * 孔槽v2添加的接口—— 临时孔槽写入
+     */
+    V2 = 'v2',
 }
 
 /**
@@ -500,7 +663,15 @@ declare enum ElementType {
     /** 门窗副本 */
     DoorWindowCopy = "DoorWindowCopy",
     /** 定制组合 */
-    CustomGroup = "CustomGroup"
+    CustomGroup = "CustomGroup",
+    /** 厨卫引用模型 */
+    CabinetRef = "CabinetRef",
+    /** 厨卫副本引用模型 */
+    CabinetCopyRef = "CabinetCopyRef",
+    /** 全屋引用模型 */
+    WardrobeRef = "WardrobeRef",
+    /** 全屋副本引用模型 */
+    WardrobeCopyRef = "WardrobeCopyRef"
 }
 
 /**
@@ -701,6 +872,50 @@ declare enum EParamUnitType {
     NUMBER = 3
 }
 
+/**
+ * 线的类型
+ */
+declare enum EPlankPathLineType {
+    /**
+     * 直线
+     */
+    SEGMENT = 0,
+    /**
+     * 圆弧
+     */
+    CIRCLE_ARC = 1,
+    /**
+     * 圆
+     */
+    CIRCLE_CENTER = 4
+}
+
+/**
+ * 点的类型
+ */
+declare enum EPlankPathPointType {
+    /**
+     * 普通点
+     */
+    NONE = 0,
+    /**
+     * 倒圆
+     */
+    CIRCLE = 1,
+    /**
+     * 倒角
+     */
+    LINE = 2,
+    /**
+     * 切圆，就是内挖一个倒圆的形状
+     */
+    CUT_CIRCLE = 3,
+    /**
+     * 圆心点
+     */
+    CIRCLE_CENTER = 5
+}
+
 /**
  * 板件轮廓路径类型
  */
@@ -814,6 +1029,16 @@ export declare enum ETriggerType {
     DB_CLICK = 'double_click',
 }
 
+/** @ignore */
+export declare enum Face {
+    Bottom = 'bottom',
+    Front = 'front',
+    Left = 'left',
+    Right = 'right',
+    Back = 'back',
+    Top = 'top',
+}
+
 /**
  * 附加通用参数-几何体颜色key
  * @default 孔：0x00ff00 槽：0x1e90ff 五金槽：0x1e90ff
@@ -828,7 +1053,7 @@ export declare const FITTING_PARAM_GEOMETRY_OPACITY_KEY = '$$geometry_opacity';
 
 /**
  * 孔槽方案相关数据的管理
- *
+ * @deprecated 接口已废弃, 预计于`2024年9月30日`完全下线,请尽快使用`IDP.Custom.FittingDesignV2` 以及 `FittingViewerService`代替,解锁更丰富的孔槽类型
  * @example
  * ```typescript
  * const fittingDesignService = application.getService(FittingDesignService);
@@ -848,6 +1073,7 @@ export declare class FittingDesignService extends BaseService {
      * ```
      *
      * @param autoSave 默认开启自动保存
+     * @deprecated 接口已废弃, 预计于`2024年9月30日`完全下线
      */
     toggleAutoSave(autoSave?: boolean): void;
     /**
@@ -857,6 +1083,7 @@ export declare class FittingDesignService extends BaseService {
      * ```typescript
      * fittingDesignService.isAutoSave();
      * ```
+     * @deprecated 接口已废弃, 预计于`2024年9月30日`完全下线
      */
     isAutoSave(): boolean;
     /**
@@ -868,6 +1095,7 @@ export declare class FittingDesignService extends BaseService {
      * ```
      *
      * @param modelId 方案模型的ID，当没传时，就是获取场景中，正在预览的模型ID的方案数据
+     * @deprecated 接口已废弃, 预计于`2024年9月30日`完全下线, 请尽快使用`IDP.Custom.FittingDesignV2.findDesignDataAsync`代替
      */
     getFittingDesignData(modelId?: string): Promise<IFittingDesignData | null>;
     /**
@@ -886,6 +1114,7 @@ export declare class FittingDesignService extends BaseService {
      *
      * @param modelid 模型ID，如果为空时，则表示传递的为查询当前正在编辑的模型的方案数据
      * @param casbin 是否为五金，当modelid为五金的id时，需要为true
+     * @deprecated 接口已废弃, 预计于`2024年9月30日`完全下线, 请尽快使用`FittingViewerService.getFitting` 和 `FittingViewerService.getHardware`代替
      */
     getConnectedFittingDesign(modelid?: string, casbin?: boolean): Promise<IFittingDesignData | null>;
     /**
@@ -893,6 +1122,7 @@ export declare class FittingDesignService extends BaseService {
      *
      * @param path 待验证的路径
      * @param linkModelId 关联的模型ID
+     * @deprecated 接口已废弃, 预计于`2024年9月30日`完全下线
      */
     validateFittingDesign(path: IHardwareGrooveData, linkModelId: string): IFittingDesignValidateResult;
     /**
@@ -911,6 +1141,7 @@ export declare class FittingDesignService extends BaseService {
      *
      * @param design 孔/槽方案信息
      * @param option { timeout, save} 调用超时，save 是否立即保存至后端，默认为true
+         * @deprecated 接口已废弃, 预计于`2024年9月30日`完全下线, 请尽快使用`FittingViewerService.addFitting` 和 `FittingViewerService.addHardware`代替
          */
      appendFittingDesign(design: Partial<IFittingDesignData>, option?: {
          /**
@@ -938,6 +1169,7 @@ export declare class FittingDesignService extends BaseService {
       *
       * @param design 需要保存的方案信息
       * @param option
+      * @deprecated 接口已废弃, 预计于`2024年9月30日`完全下线, 请尽快使用 `IDP.Custom.FittingDesignV2.saveDesignDataAsync`代替
       */
      saveDesign(design?: IFittingDesignData, option?: {
          timeout?: number;
@@ -953,6 +1185,7 @@ export declare class FittingDesignService extends BaseService {
       * await fittingDesignService.clearDesign();
       * ```
       * @param options
+      * @deprecated 接口已废弃, 预计于`2024年9月30日`完全下线, 请尽快使用 `IDP.Custom.FittingDesignV2.deleteDesignDataAsync`代替
       */
      clearDesign(options?: IBaseOptions): Promise<void>;
     }
@@ -1014,6 +1247,92 @@ export declare class FittingDesignService extends BaseService {
         }): Promise<void>;
     }
 
+    /**
+     * 孔槽渲染数据的管理
+     * > 坐标系统一是关联模型的中心点为原点构建的坐标系
+     * > 只会影响展示效果
+     * @example
+     * ```typescript
+     * const fittingViewerService = application.getService(FittingViewerService);
+     * ```
+     */
+    export declare class FittingViewerService extends BaseService {
+        /**
+         * 往当前的场景中，新增孔、槽的渲染效果
+         * 孔槽坐标系要求是其关联的元件（商品下的模型）的中心点坐标系
+         * 如若获取的是左后下坐标，需要主动做偏移后写入
+         * @param fittingData 孔/槽方案信息
+         * @param fittingData.modelId 孔槽关联的商品
+         * @param fittingData.holes 孔的集合，若不带holeId,则会生成实例id返回
+         * @param fittingData.grooves 槽的集合，若不带grooveId,则会生成实例id返回
+         * @returns 返回携带了实例id的孔槽集合
+         * @example 展示模型id为"6CE4EFB3-59B4-41A8-8706-936800280B15"下的孔槽
+         * ```typescript
+         * const fittingViewerService = application.getService(FittingViewerService);
+         * await fittingViewerService.addFitting({
+         *     modelId: "6CE4EFB3-59B4-41A8-8706-936800280B15",
+         *     holes: [{xxx}],
+         *     grooves: [{xxx}]
+         * })
+         * ```
+         */
+        addFitting(fittingData: IFittingViewerDataWithOptionalId): Promise<IFittingViewerDataWithId>;
+        /**
+         * 清空当前场景内的全部孔槽
+         * @example 清空场景内的全部孔槽
+         * ```typescript
+         * const fittingViewerService = application.getService(FittingViewerService);
+         * await fittingViewerService.clearFitting();
+         * ```
+         */
+        clearFitting(): Promise<void>;
+        /**
+         * 获取场景中的孔槽
+         * @param option.modelId 获取关联的孔槽
+         * @example 获取场景中关联模型id为`89720858-5242-4756-8528-F07C3D69F9E`的孔槽
+         * ```typescript
+         * const fittings = fittingViewerService.getFitting({modelId: "89720858-5242-4756-8528-F07C3D69F9E"});
+         * ```
+         */
+        getFitting(option?: {
+            modelId: string;
+        }): Promise<IFittingViewerDataWithId[]>;
+        /**
+         * 往当前的场景中，新增五金的渲染效果
+         * 注意坐标系均为中心点坐标系其余与之前的五金一致
+         * @param hardwareData.modelId 五金关联的商品
+         * @param hardwareData.hardwares 五金的集合，若不带id,则会生成实例id返回
+         * @example 展示模型id为"6CE4EFB3-59B4-41A8-8706-936800280B15"下的五金
+         * ```typescript
+         * const fittingViewerService = application.getService(FittingViewerService);
+         * await fittingViewerService.addHardware({
+         *     modelId: "6CE4EFB3-59B4-41A8-8706-936800280B15",
+         *     hardwares: [{xxx}]
+         * })
+         */
+        addHardware(hardwareData: IHardwareViewerDataWithOptionalId): Promise<IHardwareViewerDataWithId>;
+        /**
+         * 清除当前场景内的全部五金渲染效果
+         * @example 清空场景内的全部五金
+         * ```typescript
+         * const fittingViewerService = application.getService(FittingViewerService);
+         * await fittingViewerService.clearHardware();
+         * ```
+         */
+        clearHardware(): Promise<void>;
+        /**
+         * 获取场景中的五金
+         * @param option.modelId 获取关联的孔槽
+         * @example 获取场景中关联模型id为`89720858-5242-4756-8528-F07C3D69F9E`的五金
+         * ```typescript
+         * const fittings = fittingViewerService.getHardware({modelId: "89720858-5242-4756-8528-F07C3D69F9E"});
+         * ```
+         */
+        getHardware(option?: {
+            modelId: string;
+        }): Promise<IHardwareViewerDataWithId[]>;
+    }
+
     export declare type IApplicationStartOption = ITerminalConfig;
 
     /**
@@ -1102,7 +1421,74 @@ export declare class FittingDesignService extends BaseService {
     }
 
     /**
-     * 自定议参数
+     * 通过凸度定义圆弧
+     */
+    declare interface IBomArcCurveByBulge {
+        /**
+         * 线段类型
+         */
+        type: EBomCurveType.Arc;
+        /**
+         * 凸度
+         */
+        bulge: number;
+    }
+
+    /**
+     * 通过半径、绕向、是否劣弧定义圆弧
+     */
+    declare interface IBomArcCurveByRadius {
+        /**
+         * 线段类型
+         */
+        type: EBomCurveType.Arc;
+        /**
+         * 逆时针
+         */
+        isCCW: boolean;
+        /**
+         * 劣弧
+         */
+        minorArc: boolean;
+        /**
+         * 半径
+         */
+        radius: number;
+    }
+
+    /**
+     * 线段描述
+     * @vm-type UnknownType
+     */
+    export declare type IBomCurve = IBomLineSegCurve | IBomArcCurveByBulge | IBomArcCurveByRadius;
+
+    /**
+     * 直线
+     */
+    declare interface IBomLineSegCurve {
+        /**
+         * 线段类型
+         */
+        type: EBomCurveType.LineSeg;
+    }
+
+    /**
+     * 成品板件轮廓
+     * @vm-type UnknownType
+     */
+    export declare interface IBomProfile<T = IBomCurve> {
+        /**
+         * 点的坐标，每两个值代表一个点
+         * eg: [100, 200, 250, 300]
+         */
+        points: number[];
+        curves: T[];
+        /** 名称 */
+        name?: string;
+    }
+
+    /**
+     * 自定义参数
      * @vm-type IBzParamType
      */
     declare interface IBzParamModelLiteProperty<T extends number | string | boolean = string> {
@@ -1232,6 +1618,25 @@ export declare class FittingDesignService extends BaseService {
         | ISceneSelectOption[];
     }
 
+    /**
+     * 孔槽数据
+     * @vm-type UnknownType
+     */
+    export declare interface IFittingDataV2<WithId extends boolean = false> {
+        /**
+         * 孔槽关联的商品id
+         */
+        modelId: string;
+        /**
+         * 孔的集合
+         */
+        holes?: Array<WithId extends true ? IHoleDataV2WithId : IHoleDataV2>;
+        /**
+         * 槽的集合
+         */
+        grooves?: Array<WithId extends true ? IGrooveDataV2WithId : IGrooveDataV2>;
+    }
+
     /**
      * 孔/槽方案的数据结构
      */
@@ -1258,6 +1663,21 @@ export declare class FittingDesignService extends BaseService {
         hardwareGrooves: IFittingHardwareGrooves_2;
     }
 
+    /**
+     * 孔槽方案数据
+     * @vm-type UnknownType
+     */
+    export declare interface IFittingDesignDataV2<WithId extends boolean = false> {
+        /**
+         * 方案关联的顶层模型id
+         */
+        id: string;
+        /**
+         * 孔槽方案
+         */
+        fittingDesign: Array<IFittingDataV2<WithId>>;
+    }
+
     export declare interface IFittingDesignValidateResult {
         /**
          * 是否验证通过
@@ -1350,7 +1770,16 @@ export declare class FittingDesignService extends BaseService {
         /**
          * 方案原始数据
          */
-        originalData: IHoleData | IGrooveData | IHardwareData | IHardwareGrooveData;
+        originalData:
+        | IHoleData
+        | IGrooveData
+        | IHardwareData
+        | IHardwareGrooveData
+        | IHoleDataV2WithId
+        | ISquareGrooveDataWithId
+        | IRoundCornerGrooveDataWithId
+        | ISpecialShapedGrooveDataWithId
+        | IPathGrooveDataWithId;
 
         /**
          * 模型变更记录
@@ -1370,6 +1799,77 @@ export declare class FittingDesignService extends BaseService {
         setHidden(isHidden: boolean): void;
     }
 
+    /**
+     * 影响孔槽渲染的属性
+     */
+    export declare interface IFittingRenderProperty {
+        /**
+         * 渲染属性
+         */
+        renderProperty: {
+            /**
+             * 孔槽颜色
+             * @default 默认颜色为`ModelViewerService.setting()`接口设置的holeColor/grooveColor
+             */
+            color?: string | number;
+            /**
+             * 不透明度
+             * @default 默认不透明度为`ModelViewerService.setting()`接口设置的holeOpacity/grooveOpacity
+             */
+            opacity?: number;
+        };
+    }
+
+    export declare interface IFittingViewerDataWithId {
+        /**
+         * 关联的商品id
+         */
+        modelId: string;
+        /**
+         * 孔的集合
+         */
+        holes?: Array<IHoleDataV2WithId & Partial<IFittingRenderProperty>>;
+        /**
+         * 槽的集合
+         */
+        grooves?: Array<IGrooveDataV2WithId & Partial<IFittingRenderProperty>>;
+        /**
+         * 描述异形板件的轮廓
+         * 主要用于BOM
+         */
+        finishedProfile?: IBomProfile;
+    }
+
+    export declare interface IFittingViewerDataWithOptionalId {
+        /**
+         * 关联的商品id
+         */
+        modelId: string;
+        /**
+         * 孔的集合
+         */
+        holes?: Array<IHoleDataV2WithOptionalId & Partial<IFittingRenderProperty>>;
+        /**
+         * 槽的集合
+         */
+        grooves?: Array<IGrooveDataV2WithOptionalId & Partial<IFittingRenderProperty>>;
+        /**
+         * 描述异形板件的轮廓
+         * 主要用于BOM
+         */
+        finishedProfile?: IBomProfile;
+    }
+
+    /** 模型关联户型数据 */
+    declare interface IFloorplanRelation {
+        /** 关联墙体id */
+        hostIds: string[];
+        /** 关联墙洞id */
+        openingIds: string[];
+        /** 是否与墙体方向反向 与 模型旋转角度 和 内外开启参数(pushOrPull)、开门方向参数(doorOpenDirection) 共同决定展示的开向 */
+        reverse?: boolean;
+    }
+
     /**
      * 获取模型的交接信息
      */
@@ -1434,6 +1934,18 @@ export declare class FittingDesignService extends BaseService {
          * 支持配置输出交接体/贯穿交接体
          */
         intersectedInfoType?: EIntersectedInfoType[];
+        /**
+         * 不足板厚，是否输出交接体
+         * @default true 默认true，即输出交接体
+         */
+        thicknessFilterBody?: boolean;
+        /**
+         * 不足板厚，配置允许输出交接面的阈值范围；
+         * 在阈值范围内输出交界面，在阈值范围外不输出交界面；
+         * 该字段需要配合`thicknessFilter`一起使用，即 `thicknessFilter`为true时，该字段才会生效；
+         * @default 0.05
+         */
+        thicknessFilterFaceDistTol?: number;
     }
 
     /**
@@ -1468,6 +1980,66 @@ export declare class FittingDesignService extends BaseService {
         width: number;
     }
 
+    export declare interface IGrooveDataV2 {
+        /**
+         * 起点圆心
+         */
+        start?: Number3;
+        /**
+         * 终点
+         */
+        end?: Number3;
+        /**
+         * 板面
+         */
+        plankFaceId: string;
+        /**
+         * 槽宽
+         */
+        width?: number;
+        /**
+         * 槽应用类型
+         */
+        type: EAppliedGrooveType;
+        /**
+         * 槽几何类型，不填默认是SQUARE
+         */
+        geometryType?: EGrooveGeometryType;
+        /**
+         * 槽路径点
+         */
+        profile?: IProfileOrPath;
+        /**
+         * 圆弧路径
+         */
+        radius?: number;
+        /**
+         * 多点路径
+         */
+        path?: IProfileOrPath;
+        /**
+         * 槽深
+         */
+        depth: number;
+        /**
+         * 名称
+         */
+        name: string;
+    }
+
+    export declare type IGrooveDataV2WithId = IGrooveDataV2 & IGrooveId;
+
+    export declare interface IGrooveDataV2WithOptionalId extends IGrooveDataV2 {
+        grooveId?: string;
+    }
+
+    declare interface IGrooveId {
+        /**
+         * 槽ID
+         */
+        grooveId: string;
+    }
+
     /**
      * 五金相关的信息
      */
@@ -1494,6 +2066,12 @@ export declare class FittingDesignService extends BaseService {
         linkedIds: string[];
     }
 
+    export declare type IHardwareDataWithId = IHardwareData;
+
+    export declare interface IHardwareDataWithOptionalId extends Omit<IHardwareData, 'id'> {
+        id?: string;
+    }
+
     /**
      * 闭合路径中的点，需要按逆时针顺序上传，否则会导致异常
      */
@@ -1516,6 +2094,28 @@ export declare class FittingDesignService extends BaseService {
         lines: ILineData[];
     }
 
+    export declare interface IHardwareViewerDataWithId {
+        /**
+         * 关联的模型id
+         */
+        modelId: string;
+        /**
+         * 五金集合
+         */
+        hardwares: IHardwareDataWithId[];
+    }
+
+    export declare interface IHardwareViewerDataWithOptionalId {
+        /**
+         * 关联的模型id
+         */
+        modelId: string;
+        /**
+         * 五金集合
+         */
+        hardwares: IHardwareDataWithOptionalId[];
+    }
+
     /**
      * 颜色配置信息
      *
@@ -1591,6 +2191,52 @@ export declare class FittingDesignService extends BaseService {
         diameter: number;
     }
 
+    /**
+     * 孔数据结构
+     * 坐标原点为关联模型的中心点
+     */
+    export declare interface IHoleDataV2 {
+        /**
+         * 起点圆心
+         */
+        start: Number3;
+        /**
+         * 终点
+         */
+        end: Number3;
+        /**
+         * 板面
+         */
+        plankFaceId: string;
+        /**
+         * 应用类型
+         */
+        type: EAppliedHoleType;
+        /**
+         * 直径
+         */
+        diameter: number;
+        /**
+         * 孔深
+         */
+        depth: number;
+        /**
+         * 名称
+         */
+        name: string;
+    }
+
+    export declare interface IHoleDataV2WithId extends IHoleDataV2 {
+        /**
+         * 孔的id
+         */
+        holeId: string;
+    }
+
+    export declare interface IHoleDataV2WithOptionalId extends IHoleDataV2 {
+        holeId?: string;
+    }
+
     /**
      * 交接信息
      */
@@ -1729,6 +2375,29 @@ export declare class FittingDesignService extends BaseService {
         radius: number;
     }
 
+    export declare interface ILineV2 {
+        /**
+         * 线段类型
+         */
+        type: EBomCurveType;
+        /**
+         * 凸度
+         */
+        bulge?: number;
+        /**
+         * 逆时针
+         */
+        isCCW?: boolean;
+        /**
+         * 劣弧
+         */
+        minorArc?: boolean;
+        /**
+         * 半径
+         */
+        radius?: number;
+    }
+
     /**
      * 模型高亮默认配置信息
      * @example
@@ -1942,6 +2611,11 @@ export declare class FittingDesignService extends BaseService {
          * @typedef Number3
          */
         readonly size: Number3;
+        /**
+         * 获取当前模型的产品编码
+         * 此字段相当于json输出中『modelBrandGoodCode』字段
+         */
+        getProductCode(): string | undefined;
         /**
          * 获取当前模型名称
          */
@@ -2046,6 +2720,14 @@ export declare class FittingDesignService extends BaseService {
          * @param child {IParamModelLite} 待添加的模型
          */
         appendChild(child: this): void;
+        /**
+         * 替换子模型
+         * @param oldChild
+         * @param newChild
+         * @param option
+         * @internal
+         */
+        replaceChild(oldChild: this, newChild: this, option?: IReplaceParamModelInfoOption): void;
         /**
          * 向当前模型中，添加一个非原生模型；一般会使用在添加五金
          * @param accessory {IParamModelLite} 待添加的模型
@@ -2110,6 +2792,15 @@ export declare class FittingDesignService extends BaseService {
          * 获取当前模型中的板件轮廓信息
          */
         getPlankPathAsync(): Promise<IParamModelLitePlankPath | undefined>;
+        /**
+         * 获取户型关系
+         */
+        getFloorplanRelation(): Readonly<IFloorplanRelation> | undefined;
+        /**
+         * 设置户型关系
+         * @param floorplanRelation {IFloorplanRelation} 户型关系
+         */
+        setFloorplanRelation(floorplanRelation: Omit<IFloorplanRelation, 'hostIds'>): void;
     }
 
     /**
@@ -2236,6 +2927,10 @@ export declare class FittingDesignService extends BaseService {
          * @param formula
          */
         setFormula(formula: string): void;
+        /**
+         * 获取约束的产品包id
+         */
+        getPackageId(): string | undefined;
     }
 
     /**
@@ -2252,6 +2947,11 @@ export declare class FittingDesignService extends BaseService {
          * 编辑器设置的内轮廓洞
          */
         getOriginInnerHoles(): IPathData[];
+        /**
+         * 获取原始槽
+         * 编辑器设置的槽
+         */
+        getOriginSlots(): ISlotData[];
         /**
          * 获取外轮廓
          */
@@ -2260,6 +2960,10 @@ export declare class FittingDesignService extends BaseService {
          * 获取内轮廓洞的集合
          */
         getInnerHoles(): IPathData[];
+        /**
+         * 获取槽
+         */
+        getSlots(): ISlotData[];
         /**
          * 设置外轮廓
          * 全量替换原有的外轮廓
@@ -2271,11 +2975,10 @@ export declare class FittingDesignService extends BaseService {
          */
         setInnerHoles(holes: IPathData[]): void;
         /**
-         * 获取轮廓值
-         * 调用updateAsync后取得准确
-         * 叠加offset后的最终结果
+         * 设置槽
+         * 全量替换原有的槽
          */
-        getResult(): IPlankPathResult;
+        setSlots(holes: ISlotData[]): void;
     }
 
     /**
@@ -2296,12 +2999,33 @@ export declare class FittingDesignService extends BaseService {
         [key: string]: any;
     }
 
-    declare type IPathResultData = IPathData & {
+    /**
+     * 路径槽
+     */
+    export declare type IPathGrooveData = AugmentedRequired<IGrooveDataV2, 'width' | 'path'> & {
+        geometryType: EGrooveGeometryType.PATH;
+    };
+
+    export declare type IPathGrooveDataWithId = IPathGrooveData & IGrooveId;
+
+    export declare interface IPathV2 {
         /**
-         * 轮廓绕向
+         * 是否闭合的路径
          */
-        clockwise?: boolean;
-    };
+        isClosed: boolean;
+        /**
+         * 路径上的所有端点
+         */
+        points: IPointV2[];
+        /**
+         * 路径上的所有线段
+         */
+        lines: ILineV2[];
+        /**
+         * 获取路径上实际渲染的端点
+         */
+        getRenderPoints(): Number2[];
+    }
 
     /**
      * 板件轮廓描述
@@ -2384,7 +3108,7 @@ export declare class FittingDesignService extends BaseService {
         /**
          * 线条类型
          */
-        type: ELineType;
+        type: EPlankPathLineType;
         /**
          * 是否顺时针
          */
@@ -2427,7 +3151,7 @@ export declare class FittingDesignService extends BaseService {
         /**
          * 点的类型
          */
-        type: EPointType;
+        type: EPlankPathPointType;
         /**
          * 切角两边上切点距离当前点的距离（切角专用）
          */
@@ -2467,20 +3191,6 @@ export declare class FittingDesignService extends BaseService {
 
     declare type IPlankPathPointData = IPointBase;
 
-    /**
-     * 轮廓值
-     */
-    declare interface IPlankPathResult {
-        /**
-         * 外轮廓
-         */
-        outerPath: IPathResultData;
-        /**
-         * 内轮廓洞
-         */
-        innerHoles: IPathResultData[];
-    }
-
     /**
      * 轮廓路径端点表示
      */
@@ -2548,6 +3258,16 @@ export declare class FittingDesignService extends BaseService {
      */
     export declare type IPointData = IPointWithNone | IPointWithLine | IPointWithCircle | IPointWithCutCircle;
 
+    export declare interface IPointV2 {
+        /**
+         * 点的位置
+         *
+         * @example
+         * "123,-345"
+         */
+        position: Number2;
+    }
+
     /**
      * 倒圆
      */
@@ -2608,6 +3328,47 @@ export declare class FittingDesignService extends BaseService {
         clockwise?: boolean;
     }
 
+    /**
+     * 槽路径/轮廓
+     */
+    declare interface IProfileOrPath {
+        /**
+         * 点的坐标，每两个值代表一个点
+         * eg: [100, 200, 250, 300]
+         */
+        points: number[];
+        curves: Array<{
+            /**
+             * 线段类型
+             * 直线 / 弧线
+             */
+            type: 'LineSeg' | 'Arc';
+            /**
+             * 逆时针
+             */
+            isCCW?: boolean;
+            /**
+             * 劣弧
+             */
+            minorArc?: boolean;
+            /**
+             * 半径
+             */
+            radius?: number;
+            /**
+             * 凸度
+             */
+            bulge?: number;
+        }>;
+    }
+
+    /**
+     * 替换模型时的配置信息
+     */
+    declare interface IReplaceParamModelInfoOption {
+        inherit?: boolean;
+    }
+
     /**
      * 房间信息
      */
@@ -2622,6 +3383,15 @@ export declare class FittingDesignService extends BaseService {
         roomName?: string;
     }
 
+    /**
+     * 圆角方槽
+     */
+    export declare type IRoundCornerGrooveData = AugmentedRequired<IGrooveDataV2, 'start' | 'end' | 'width' | 'radius'> & {
+        geometryType: EGrooveGeometryType.ROUND_CORNER;
+    };
+
+    export declare type IRoundCornerGrooveDataWithId = IRoundCornerGrooveData & IGrooveId;
+
     /**
      * 高亮模型描述
      */
@@ -2710,6 +3480,46 @@ export declare class FittingDesignService extends BaseService {
         renderIgnoreCategory: number | number[];
     }
 
+    /**
+     * 槽数据
+     */
+    declare interface ISlotData {
+        /**
+         * 槽轮廓信息
+         */
+        path: IPathData;
+        /**
+         * 槽深度
+         */
+        deep: string;
+        /**
+         * 槽的挖槽方向
+         */
+        slotCaveType: SlotCaveType;
+        /**
+         * other fields
+         */
+        [key: string]: any;
+    }
+
+    /**
+     * 异形槽
+     */
+    export declare type ISpecialShapedGrooveData = AugmentedRequired<IGrooveDataV2, 'profile'> & {
+        geometryType: EGrooveGeometryType.SPECIAL_SHAPED;
+    };
+
+    export declare type ISpecialShapedGrooveDataWithId = ISpecialShapedGrooveData & IGrooveId;
+
+    /**
+     * 方槽
+     */
+    export declare type ISquareGrooveData = AugmentedRequired<IGrooveDataV2, 'start' | 'end' | 'width'> & {
+        geometryType?: EGrooveGeometryType.SQUARE;
+    };
+
+    export declare type ISquareGrooveDataWithId = ISquareGrooveData & IGrooveId;
+
     /**
      * 启动时，配置terminal信息
      */
@@ -3061,6 +3871,18 @@ export declare class FittingDesignService extends BaseService {
          * ```
          */
         moveCamera(direction: ECameraMoveDirection): void;
+        /**
+         * 相机视角调整
+         * @param face
+         * @ignore
+         */
+        focusFace(face: Face): void;
+        /**
+         * 更新相机类型
+         * @param type
+         * @ignore
+         */
+        updateCameraType(type: CameraType): void;
     }
 
     /**
@@ -3478,6 +4300,15 @@ export declare class FittingDesignService extends BaseService {
         syncModelPlankPath(plankArea: IPlankArea): void;
     }
 
+    /**
+     * 获取promise函数返回类型
+     */
+    export declare type ReturnPromiseType<T extends (...args: any[]) => Promise<any>> = T extends (
+    ...args: any[]
+    ) => Promise<infer R>
+    ? R
+    : T;
+
     /**
      * 提供渲染场景的控制
      *
@@ -3527,4 +4358,12 @@ export declare class FittingDesignService extends BaseService {
         registerMultiSelectShortcut(key: KeyboardKey | KeyboardKey[]): void;
     }
 
+    /**
+     * 挖槽方向
+     */
+    declare enum SlotCaveType {
+        FROM_TOP = "1",
+        FROM_BOTTOM = "2"
+    }
+
     export { }