@kudashi/kds-api 2.14.4 → 2.14.5

package/README.md

@@ -2,6 +2,16 @@
 
 # api changelog
 
+# version 2.14.5(2025-10-30)
+- KSecondaryToolBarWidget KToolWidget
+# version 2.14.4(2025-12-30)
+- getEnvironmentSettings
+# version 2.14.3(2025-12-23)
+- pluginViewUseMaxHeight
+# version 2.14.2(2025-12-16)
+- KWire
+# version 2.14.1(2025-10-30)
+- 支持插入自定义Widget控件
 # version 2.13.33(2025-09-16)
 - 新增接口KPublicFontLibrary， 新增方法KAssetLibraryHelper.getPublicFontLibrary, KPublicFontLibrary.getFontList
 - KDesign.createText3d

package/api.d.ts

@@ -1,4 +1,4 @@
-// version: 2.14.4
+// version: 2.14.5
 
 declare global {
     /**
@@ -4757,6 +4757,31 @@ declare global {
         getMoldingProfileList(start: number, count: number): HostPromise<MoldingProfile[]>
     }
 
+    
+    /**
+     * 二级工具栏控件
+     *
+     * Secondary toolbar widget
+     */
+    interface KSecondaryToolBarWidget extends KWidget {
+    
+        /**
+         * 自定义展示二级工具栏工具列表，二级工具栏将被替换为tools描述的工具列表
+         *
+         * Customize the display of the secondary toolbar tool list, the secondary toolbar will be replaced with the tool list described by tools
+         * @param tools tool list
+         */
+        setTools(tools: KToolWidgetOption[]): { isSuccess: boolean };
+    
+        /**
+         * 获取工具列表
+         *
+         * Get the tool list
+         * @returns The current tool list
+         */
+        getTools(): KToolWidget[];
+    }
+
     /*
      *  KSelection.ts
      *  Copyright 2022 Qunhe Tech, all rights reserved.
@@ -5723,6 +5748,147 @@ declare global {
     }
 
     
+    /**
+     * 系统工具标识
+     *
+     * System tool Key
+     *
+     */
+    enum KSystemToolKey {
+        /** 变量化3D文字 */
+        TEXT_3D = 'TEXT_3D',
+        /** 变量化单面灯带 */
+        STRIP_LIGHT = 'STRIP_LIGHT',
+        /** 变量化多面灯带 */
+        CONTINUOUS_STRIP_LIGHTS = 'CONTINUOUS_STRIP_LIGHTS',
+    
+        /** 选取工具 */
+        SELECTOR = 'SELECTOR',
+        /** 最短路径工具 */
+        SHORTEST_PATH = 'SHORTEST_PATH',
+        /** 橡皮擦 */
+        ERASER = 'ERASER',
+        /** 直线 */
+        LINE = 'LINE',
+        /** 弧线 */
+        ARC_LINE = 'ARC_LINE',
+        /** 贝塞尔曲线 */
+        BEZIER = 'BEZIER',
+        /** 矩形 */
+        RECT = 'RECT',
+        /** 圆形 */
+        CIRCLE = 'CIRCLE',
+        /** 多边形 */
+        POLYGON = 'POLYGON',
+        /** 圆弧 */
+        ARC = 'ARC',
+        /** 推拉面 */
+        PULL_FACE = 'PULL_FACE',
+        /** 扫掠 */
+        SWEEP = 'SWEEP',
+        /** 偏移 */
+        OFFSET = 'OFFSET',
+        /** 桥接工具 */
+        BRIDGE = 'BRIDGE',
+        /** 分割面 */
+        DIVIDE_FACE = 'DIVIDE_FACE',
+        /** 膨胀 */
+        INFLATE = 'INFLATE',
+        /** 2D倒角 */
+        CORNER2D = 'CORNER2D',
+        /** 3D倒角 */
+        FILLET = 'FILLET',
+        /** 沿XY平面镜像 */
+        MIRROR_XY = 'MIRROR_XY',
+        /** 沿YZ平面镜像 */
+        MIRROR_YZ = 'MIRROR_YZ',
+        /** 沿ZX平面镜像 */
+        MIRROR_ZX = 'MIRROR_ZX',
+        /** 自定义镜像 */
+        MIRROR_CUSTOM = 'MIRROR_CUSTOM',
+        /** 线性阵列 */
+        LINEAR_ARRAY = 'LINEAR_ARRAY',
+        /** 环形阵列 */
+        CIRCULAR_ARRAY = 'CIRCULAR_ARRAY',
+        /** 布尔交 */
+        BOOLEAN3D_INTERSECT = 'BOOLEAN3D_INTERSECT',
+        /** 布尔并 */
+        BOOLEAN3D_UNION = 'BOOLEAN3D_UNION',
+        /** 布尔差 */
+        BOOLEAN3D_SUBTRACT = 'BOOLEAN3D_SUBTRACT',
+        /** 弯曲 */
+        BEND = 'BEND',
+        /** 路径弯曲 */
+        PATH_ALIGN = 'PATH_ALIGN',
+        /** 移动 */
+        MOVE = 'MOVE',
+        /** 旋转 */
+        ROTATE = 'ROTATE',
+        /** 缩放 */
+        SCALE = 'SCALE',
+        /** 参考直线 */
+        AUX_LINE = 'AUX_LINE',
+        /** 参考线段 */
+        AUX_BOUNDED_LINE = 'AUX_BOUNDED_LINE',
+        /** 参考弧线段 */
+        AUX_BOUNDED_ARC = 'AUX_BOUNDED_ARC',
+        /** 参考贝塞尔曲线段 */
+        AUX_BEZIER_CURVE_GROUP = 'AUX_BEZIER_CURVE_GROUP',
+        /** 测量 */
+        MEASURE = 'MEASURE',
+        /** 材质刷 */
+        MATERIAL_BRUSH = 'MATERIAL_BRUSH',
+        /** 翻转面法线 */
+        FLIP_FACE_NORMAL = 'FLIP_FACE_NORMAL',
+    }
+    
+    /**
+     * 二级工具栏工具控件
+     *
+     * Secondary tool widget
+     */
+    interface KToolWidget extends KWidget {
+        /**
+         * 获取工具标识
+         *
+         * Get the tool key
+         */
+        getToolKey(): KSystemToolKey;
+    
+        /**
+         * 设置子工具项
+         *
+         * Set sub-tools for the widget
+         * @param subTools 子工具项数组 (Array of sub-tools)
+         */
+        setSubTools(subTools: KToolWidgetOption[]): { isSuccess: boolean };
+    
+        /**
+         * 获取子工具项
+         *
+         * Get sub-tools of the widget
+         * @returns 当前的子工具项数组 (Current array of sub-tools)
+         */
+        getSubTools(): KToolWidget[];
+    }
+    
+    interface KToolWidgetOption {
+        /**
+         * 工具标识
+         *
+         * Tool key
+         */
+        key: KSystemToolKey;
+    
+        /**
+         * 子工具项
+         *
+         * Sub-tools
+         */
+        subTools?: KToolWidgetOption[];
+    }
+
+    
     /**
      * 顶部工具栏控件，显示在顶部栏的控件
      *
@@ -6771,6 +6937,20 @@ declare global {
          */
         SelectMenuButtonWidget = 'selectMenuButtonWidget',
     
+        /**
+         * 二级工具栏控件
+         *
+         * Secondary toolbar widget
+         */
+        SecondaryToolBarWidget = 'secondaryToolBarWidget',
+    
+        /**
+         * 二级工具栏工具控件
+         *
+         * Tool widget
+         */
+        ToolWidget = 'toolWidget',
+    
         /**
          * 系统控件
          */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kudashi/kds-api",
-  "version": "2.14.4",
+  "version": "2.14.5",
   "description": "kds api",
   "main": "api.d.ts",
   "scripts": {