@luck-design-biz/luckda 1.0.1-4 → 1.0.1-6

package/es/lowcode/engine/tools/dataProcess.js

@@ -5,10 +5,10 @@ import _typeof from "@babel/runtime/helpers/esm/typeof";
 import * as LZString from 'lz-string';
 import { LC_BUILDIN_UNIT_KEY } from "../../constants";
 
-/**
- * 数据压缩
- * @param {JSON} data
- * @returns 加密后的字符串
+/**
+ * 数据压缩
+ * @param {JSON} data
+ * @returns 加密后的字符串
  */
 export function compress(data) {
   // 将对象转换为JSON字符串
@@ -17,10 +17,10 @@ export function compress(data) {
   return LZString.compressToBase64(jsonString);
 }
 
-/**
- * 数据解压
- * @param {string} compressedData
- * @returns {json}
+/**
+ * 数据解压
+ * @param {string} compressedData
+ * @returns {json}
  */
 export function decompress(compressedData) {
   // 使用LZ-String解压数据
@@ -29,13 +29,13 @@ export function decompress(compressedData) {
   return JSON.parse(jsonString);
 }
 
-/**
- * 查找指定ID的节点及其父节点。
- *
- * @param {string} id - 要查找的节点ID。
- * @param {Object} current - 当前遍历的JSON对象。
- * @param {Object|null} parent - 当前节点的父节点。
- * @returns {{node: Object|null, parent: Object|null}} 查找结果，包含节点和其父节点。
+/**
+ * 查找指定ID的节点及其父节点。
+ *
+ * @param {string} id - 要查找的节点ID。
+ * @param {Object} current - 当前遍历的JSON对象。
+ * @param {Object|null} parent - 当前节点的父节点。
+ * @returns {{node: Object|null, parent: Object|null}} 查找结果，包含节点和其父节点。
  */
 export function findNodeAndParent(id, current) {
   var parent = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : null;
@@ -69,13 +69,13 @@ export function findNodeAndParent(id, current) {
   };
 }
 
-/**
- * 对指定的JSON结构进行节点的添加、修改或删除操作。
- *
- * @param {Object} json - 要操作的JSON对象。
- * @param {string|null} path - 要操作的节点路径，使用'/'分隔。
- * @param {string} id - 操作节点的唯一标识符。
- * @param {Object|null} data - 要添加或修改的数据。如果为null，表示删除操作。
+/**
+ * 对指定的JSON结构进行节点的添加、修改或删除操作。
+ *
+ * @param {Object} json - 要操作的JSON对象。
+ * @param {string|null} path - 要操作的节点路径，使用'/'分隔。
+ * @param {string} id - 操作节点的唯一标识符。
+ * @param {Object|null} data - 要添加或修改的数据。如果为null，表示删除操作。
  */
 function process(json, path, id, data) {
   if (!json) {
@@ -141,25 +141,25 @@ function process(json, path, id, data) {
   }
 }
 
-/**
- * 对指定的JSON结构进行节点的添加操作。
- *
- * @param {Object} json - 要操作的JSON对象。
- * @param {string} parentId - 父节点的唯一标识符。
- * @param {string} id - 操作节点的唯一标识符。
- * @param {Object|null} data - 要添加或修改的数据。如果为null，表示删除操作。
+/**
+ * 对指定的JSON结构进行节点的添加操作。
+ *
+ * @param {Object} json - 要操作的JSON对象。
+ * @param {string} parentId - 父节点的唯一标识符。
+ * @param {string} id - 操作节点的唯一标识符。
+ * @param {Object|null} data - 要添加或修改的数据。如果为null，表示删除操作。
  */
 export function add(json, parentId, id, data) {
   process(json, getPathById(json, parentId), id, data);
 }
 
-/**
- * 移动指定的节点到另一个节点的指定位置。
- *
- * @param {Object} json - 要操作的JSON对象。
- * @param {string} sid - 被移动的节点id
- * @param {string} tid - 目标节点id
- * @param {string} action - 'left': 往节点前面插入，'right'：往节点后面插，'inside'：往节点子节点插
+/**
+ * 移动指定的节点到另一个节点的指定位置。
+ *
+ * @param {Object} json - 要操作的JSON对象。
+ * @param {string} sid - 被移动的节点id
+ * @param {string} tid - 目标节点id
+ * @param {string} action - 'left': 往节点前面插入，'right'：往节点后面插，'inside'：往节点子节点插
  */
 export function move(json, sid, tid, action) {
   // 验证节点存在性
@@ -215,34 +215,34 @@ export function move(json, sid, tid, action) {
   }
 }
 
-/**
- * 对指定的JSON结构进行节点的修改操作。
- *
- * @param {Object} json - 要操作的JSON对象。
- * @param {string} id - 操作节点的唯一标识符。
- * @param {Object|null} data - 要添加或修改的数据。如果为null，表示删除操作。
+/**
+ * 对指定的JSON结构进行节点的修改操作。
+ *
+ * @param {Object} json - 要操作的JSON对象。
+ * @param {string} id - 操作节点的唯一标识符。
+ * @param {Object|null} data - 要添加或修改的数据。如果为null，表示删除操作。
  */
 export function modifyById(json, id, data) {
   process(json, null, id, data);
 }
 
-/**
- * 删除指定id的节点。
- *
- * @param {Object} json - JSON对象。
- * @param {string} id - 要删除的节点ID。
+/**
+ * 删除指定id的节点。
+ *
+ * @param {Object} json - JSON对象。
+ * @param {string} id - 要删除的节点ID。
  */
 export function deleteById(json, id) {
   process(json, null, id);
 }
 
-/**
- * 根据ID在给定的JSON结构中查找节点的路径。
- *
- * @param {Object} json - 要搜索的JSON对象。
- * @param {string} id - 要查找的节点ID。
- * @param {string} currentPath - 当前递归到的路径，用于构建返回的路径字符串。
- * @returns {string|null} 如果找到节点，返回节点的路径；否则返回null。
+/**
+ * 根据ID在给定的JSON结构中查找节点的路径。
+ *
+ * @param {Object} json - 要搜索的JSON对象。
+ * @param {string} id - 要查找的节点ID。
+ * @param {string} currentPath - 当前递归到的路径，用于构建返回的路径字符串。
+ * @returns {string|null} 如果找到节点，返回节点的路径；否则返回null。
  */
 export function getPathById(json, id) {
   var currentPath = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : '';
@@ -262,28 +262,28 @@ export function getPathById(json, id) {
   return null;
 }
 
-/**
- * 在给定的JSON结构中搜索具有特定id的节点，并返回包含该节点及其所有父节点的props属性的路径数组。
- *
- * @param {Object} data - 待搜索的JSON对象，它代表了一个复杂的树状结构，每个节点都可能有props和children属性。
- * @param {string} targetId - 需要找到的目标节点的id。
- * @returns {Array<Object>} 一个包含目标节点及其所有父节点的props属性的数组。如果未找到目标节点，则返回空数组。
- *
- * @example
- * const data = {
- *   props: {
- *     id: 'page_root',
- *     type: 'Page',
- *     name: '页面',
- *     hasHeder: true,
- *     hasFooter: true,
- *   },
- *   // ...其他节点
- * };
- *
- * const path = getPathNodesById(data, 'form_jknbjkun');
- * console.log(path);
- * // 输出目标节点及其所有父节点的props属性的数组
+/**
+ * 在给定的JSON结构中搜索具有特定id的节点，并返回包含该节点及其所有父节点的props属性的路径数组。
+ *
+ * @param {Object} data - 待搜索的JSON对象，它代表了一个复杂的树状结构，每个节点都可能有props和children属性。
+ * @param {string} targetId - 需要找到的目标节点的id。
+ * @returns {Array<Object>} 一个包含目标节点及其所有父节点的props属性的数组。如果未找到目标节点，则返回空数组。
+ *
+ * @example
+ * const data = {
+ *   props: {
+ *     id: 'page_root',
+ *     type: 'Page',
+ *     name: '页面',
+ *     hasHeder: true,
+ *     hasFooter: true,
+ *   },
+ *   // ...其他节点
+ * };
+ *
+ * const path = getPathNodesById(data, 'form_jknbjkun');
+ * console.log(path);
+ * // 输出目标节点及其所有父节点的props属性的数组
  */
 export function getPathNodesById(data, targetId) {
   // 初始化结果数组

package/es/lowcode/engine/tools/useCanvasRender.js

@@ -7,6 +7,7 @@ var _excluded = ["props", "children"],
 import React, { useRef } from 'react';
 import { dynamic } from 'umi';
 import { useMemoizedFn, useCreation } from 'ahooks';
+import { Skeleton } from 'luck-design/antd';
 import { upperFirst, isNil } from 'lodash';
 import { useContext } from "../provider/ContextProvider";
 import { LC_BUILDIN_UNIT_KEY_LIST, RUNTIME } from "../../constants";
@@ -55,7 +56,18 @@ export default function useCanvasRender(data, deps) {
               return _loader.apply(this, arguments);
             }
             return loader;
-          }()
+          }(),
+          loading: function loading() {
+            return /*#__PURE__*/React.createElement(Skeleton, {
+              active: true,
+              title: {
+                width: '70%'
+              },
+              paragraph: {
+                rows: 7
+              }
+            });
+          }
         });
       }
       var renderable = true;

package/es/lowcode/painter/Components.js

@@ -87,8 +87,8 @@ var CompItem = function CompItem(_ref2) {
   }, /*#__PURE__*/React.createElement("span", null, item.name)));
 };
 
-/**
- * 组件清单
+/**
+ * 组件清单
  */
 var Components = function Components(_ref3) {
   var _ref3$dataset = _ref3.dataset,

package/es/lowcode/painter/components/Collapse.js

@@ -5,32 +5,32 @@ import { useMemoizedFn, useCreation } from 'ahooks';
 import styles from "../style/collapse.less";
 import { Icon, Tooltip } from 'luck-design/antd';
 
-/**
- * Collapse 组件是一个可折叠区域的实现，用于显示或隐藏内容。它支持自定义标签、描述以及默认的折叠状态。
- * 该组件还可以通过 `next` 函数来自定义点击操作，而不是简单地切换折叠状态。
- * 提供的工具提示可以显示额外信息，如字段名和描述，以帮助用户更好地理解折叠内容的作用。
- *
- * @component
- * @example
- * <Collapse
- *   field="exampleField"
- *   label="示例标签"
- *   desc="这是一个用于演示的折叠组件"
- *   defaultCollapsed={true}
- *   next={() => console.log('Custom next function executed')}
- * >
- *   <p>这里是可折叠的内容</p>
- * </Collapse>
- *
- * @param {Object} props - 组件的属性。
- * @param {React.ReactNode} children - 折叠区域展开时显示的内容。
- * @param {string} [props.field] - 与折叠内容相关联的字段名。
- * @param {string} props.label - 折叠区域的标签名称。
- * @param {string} [props.desc] - 关于折叠内容的描述信息。
- * @param {boolean} [props.defaultCollapsed=false] - 折叠区域的默认状态。如果为 true，则默认为折叠状态。
- * @param {Function} [props.next] - 点击操作的自定义函数。如果提供，点击时将执行此函数，而不是切换折叠状态。
- *
- * @returns {ReactElement} 返回一个 React 元素，表示一个具有可折叠功能的容器。
+/**
+ * Collapse 组件是一个可折叠区域的实现，用于显示或隐藏内容。它支持自定义标签、描述以及默认的折叠状态。
+ * 该组件还可以通过 `next` 函数来自定义点击操作，而不是简单地切换折叠状态。
+ * 提供的工具提示可以显示额外信息，如字段名和描述，以帮助用户更好地理解折叠内容的作用。
+ *
+ * @component
+ * @example
+ * <Collapse
+ *   field="exampleField"
+ *   label="示例标签"
+ *   desc="这是一个用于演示的折叠组件"
+ *   defaultCollapsed={true}
+ *   next={() => console.log('Custom next function executed')}
+ * >
+ *   <p>这里是可折叠的内容</p>
+ * </Collapse>
+ *
+ * @param {Object} props - 组件的属性。
+ * @param {React.ReactNode} children - 折叠区域展开时显示的内容。
+ * @param {string} [props.field] - 与折叠内容相关联的字段名。
+ * @param {string} props.label - 折叠区域的标签名称。
+ * @param {string} [props.desc] - 关于折叠内容的描述信息。
+ * @param {boolean} [props.defaultCollapsed=false] - 折叠区域的默认状态。如果为 true，则默认为折叠状态。
+ * @param {Function} [props.next] - 点击操作的自定义函数。如果提供，点击时将执行此函数，而不是切换折叠状态。
+ *
+ * @returns {ReactElement} 返回一个 React 元素，表示一个具有可折叠功能的容器。
  */
 export default function (_ref) {
   var children = _ref.children,

package/es/lowcode/painter/components/ColorInput.js

@@ -10,30 +10,30 @@ import { Input } from 'luck-design/antd';
 import styles from "../style/color-input.less";
 import { SketchPicker } from 'react-color';
 
-/**
- * ColorInput 组件是一个集成颜色选择器的输入框组件，允许用户以 RGBA 或十六进制格式输入颜色值。
- * 组件内部通过 PopConfirm 弹出一个 SketchPicker 颜色选择器，以提供一个直观的颜色选择界面。
- * 用户输入的颜色值在内部转换为适当的格式，并通过 onChange 回调暴露给外部使用。
- * 此组件还支持通过传入的 value 属性初始化颜色值，并响应其后续更改。
- *
- * @component
- * @example
- * const handleColorChange = (newColor) => {
- *   console.log('Selected color:', newColor);
- * };
- * <ColorInput
- *   value="rgba(255, 0, 0, 0.5)"
- *   onChange={handleColorChange}
- *   wrapperStyle={{ margin: '20px' }}
- * />
- *
- * @param {Object} props - 组件的属性。
- * @param {string} props.value - 初始化颜色值，支持 RGBA 字符串或十六进制格式。
- * @param {Function} props.onChange - 当颜色值变更时触发的回调函数。传递新的颜色值作为参数。
- * @param {Object} [props.wrapperStyle] - 自定义包装器 div 的样式对象。
- * @param {Object} rest - 传递给 Input 组件的其他属性。
- *
- * @returns {ReactElement} 返回一个 React 元素，表示一个带有颜色选择器的输入框组件。
+/**
+ * ColorInput 组件是一个集成颜色选择器的输入框组件，允许用户以 RGBA 或十六进制格式输入颜色值。
+ * 组件内部通过 PopConfirm 弹出一个 SketchPicker 颜色选择器，以提供一个直观的颜色选择界面。
+ * 用户输入的颜色值在内部转换为适当的格式，并通过 onChange 回调暴露给外部使用。
+ * 此组件还支持通过传入的 value 属性初始化颜色值，并响应其后续更改。
+ *
+ * @component
+ * @example
+ * const handleColorChange = (newColor) => {
+ *   console.log('Selected color:', newColor);
+ * };
+ * <ColorInput
+ *   value="rgba(255, 0, 0, 0.5)"
+ *   onChange={handleColorChange}
+ *   wrapperStyle={{ margin: '20px' }}
+ * />
+ *
+ * @param {Object} props - 组件的属性。
+ * @param {string} props.value - 初始化颜色值，支持 RGBA 字符串或十六进制格式。
+ * @param {Function} props.onChange - 当颜色值变更时触发的回调函数。传递新的颜色值作为参数。
+ * @param {Object} [props.wrapperStyle] - 自定义包装器 div 的样式对象。
+ * @param {Object} rest - 传递给 Input 组件的其他属性。
+ *
+ * @returns {ReactElement} 返回一个 React 元素，表示一个带有颜色选择器的输入框组件。
  */
 var ColorInput = /*#__PURE__*/forwardRef(function (_ref, ref) {
   var value = _ref.value,

package/es/lowcode/painter/components/ListEditor.js

@@ -4,14 +4,14 @@ import { Icon, Button } from 'luck-design/antd';
 import { formatMessage } from '@luck-design-biz/base/utils';
 import styles from "../style/list-editor.less";
 
-/**
- * ListEditor 是一个用于管理和展示一组可编辑标签项的容器组件。
- * 它提供了一个添加新标签项的操作按钮，并通过 children 属性接收一组 ListEditorItem 组件。
- *
- * @param {Object} props - 组件接收的属性。
- * @param {ReactNode} props.children - ListEditorItem 组件的实例，表示可编辑的标签项。
- * @param {Function} props.handleAdd - 一个回调函数，当用户点击添加按钮时被触发，用于添加新的标签项。
- * @returns {ReactNode} 渲染一个带有操作按钮和标签项的容器。
+/**
+ * ListEditor 是一个用于管理和展示一组可编辑标签项的容器组件。
+ * 它提供了一个添加新标签项的操作按钮，并通过 children 属性接收一组 ListEditorItem 组件。
+ *
+ * @param {Object} props - 组件接收的属性。
+ * @param {ReactNode} props.children - ListEditorItem 组件的实例，表示可编辑的标签项。
+ * @param {Function} props.handleAdd - 一个回调函数，当用户点击添加按钮时被触发，用于添加新的标签项。
+ * @returns {ReactNode} 渲染一个带有操作按钮和标签项的容器。
  */
 export var ListEditor = function ListEditor(_ref) {
   var children = _ref.children,
@@ -41,22 +41,22 @@ export var ListEditor = function ListEditor(_ref) {
   }))));
 };
 
-/**
- * ListEditorItem 是一个可编辑的标签项组件，用于在 ListEditor 容器内展示。
- * 它支持拖拽排序，并可以通过左侧和右侧的插槽来自定义内容。
- *
- * @param {Object} props - 组件接收的属性。
- * @param {Object} props.item - 表示标签项数据的对象。
- * @param {ReactNode} props.left - 放置在标签项左侧的内容，通常用于展示标签名称或其他信息。
- * @param {ReactNode} props.right - 放置在标签项右侧的内容，通常用于展示操作按钮如编辑或删除。
- * @param {Function} props.setNodeRef - 用于设置拖拽组件根节点的引用。
- * @param {Function} props.setActivatorNodeRef - 用于设置激活拖拽操作的节点引用。
- * @param {Object} props.style - 应用于标签项的样式对象，通常包含拖拽过程中的动态变化样式。
- * @param {Object} props.attributes - 包含与拖拽相关的HTML属性。
- * @param {Object} props.listeners - 包含处理拖拽事件的监听器。
- * @param {CSSProperties} props.transform - 应用于组件的CSS变换属性，用于实现拖拽效果。
- * @param {string} props.transition - 定义拖拽动画的CSS过渡属性。
- * @returns {ReactNode} 渲染一个可编辑的标签项，支持拖拽排序。
+/**
+ * ListEditorItem 是一个可编辑的标签项组件，用于在 ListEditor 容器内展示。
+ * 它支持拖拽排序，并可以通过左侧和右侧的插槽来自定义内容。
+ *
+ * @param {Object} props - 组件接收的属性。
+ * @param {Object} props.item - 表示标签项数据的对象。
+ * @param {ReactNode} props.left - 放置在标签项左侧的内容，通常用于展示标签名称或其他信息。
+ * @param {ReactNode} props.right - 放置在标签项右侧的内容，通常用于展示操作按钮如编辑或删除。
+ * @param {Function} props.setNodeRef - 用于设置拖拽组件根节点的引用。
+ * @param {Function} props.setActivatorNodeRef - 用于设置激活拖拽操作的节点引用。
+ * @param {Object} props.style - 应用于标签项的样式对象，通常包含拖拽过程中的动态变化样式。
+ * @param {Object} props.attributes - 包含与拖拽相关的HTML属性。
+ * @param {Object} props.listeners - 包含处理拖拽事件的监听器。
+ * @param {CSSProperties} props.transform - 应用于组件的CSS变换属性，用于实现拖拽效果。
+ * @param {string} props.transition - 定义拖拽动画的CSS过渡属性。
+ * @returns {ReactNode} 渲染一个可编辑的标签项，支持拖拽排序。
  */
 export var ListEditorItem = function ListEditorItem(_ref2) {
   var item = _ref2.item,

package/es/lowcode/painter/components/NumberInput.js

@@ -8,34 +8,34 @@ import styles from "../style/number-input.less";
 import { InputNumber, Dropdown, Menu } from 'luck-design/antd';
 import { isNil } from 'lodash';
 
-/**
- * NumberInput 组件是一个带单位选择的数字输入框组件，允许用户输入一个数值并从预定义的选项中选择一个单位。
- * 它支持默认值、空值、自动类型转换以及自定义更改处理逻辑。
- * 组件内部通过 Dropdown 组件提供一个单位的下拉选择菜单，并通过 InputNumber 接收数值输入。
- * 该组件也支持将输入值转换为整数或保持为原始格式，并允许通过 options 定制可选单位。
- * 
- * @component
- * @example
- * const options = [{ value: 'px', label: '像素' }, { value: '%', label: '百分比' }];
- * <NumberInput
- *   value={100}
- *   options={options}
- *   onChange={(newValue) => console.log('New value:', newValue)}
- *   defaultValue={0}
- *   allowNull={true}
- *   convertInt={false}
- * />
- * 
- * @param {Object} props - 组件的属性。
- * @param {number|string} props.value - 初始化输入框的值。
- * @param {Object[]} props.options - 可选单位的数组，每个对象包含 value（单位的值）和 label（显示在下拉菜单中的标签）。
- * @param {Function} props.onChange - 当输入值或单位改变时触发的回调函数。传递新的值作为参数。
- * @param {number|string} [props.defaultValue] - 未指定 value 时的默认值。
- * @param {boolean} [props.allowNull=true] - 是否允许空值。
- * @param {boolean} [props.convertInt=false] - 是否将输入值转换为整数。
- * @param {Object} rest - 传递给 InputNumber 组件的其他属性。
- * 
- * @returns {ReactElement} 返回一个 React 元素，表示一个带单位选择的数字输入框组件。
+/**
+ * NumberInput 组件是一个带单位选择的数字输入框组件，允许用户输入一个数值并从预定义的选项中选择一个单位。
+ * 它支持默认值、空值、自动类型转换以及自定义更改处理逻辑。
+ * 组件内部通过 Dropdown 组件提供一个单位的下拉选择菜单，并通过 InputNumber 接收数值输入。
+ * 该组件也支持将输入值转换为整数或保持为原始格式，并允许通过 options 定制可选单位。
+ * 
+ * @component
+ * @example
+ * const options = [{ value: 'px', label: '像素' }, { value: '%', label: '百分比' }];
+ * <NumberInput
+ *   value={100}
+ *   options={options}
+ *   onChange={(newValue) => console.log('New value:', newValue)}
+ *   defaultValue={0}
+ *   allowNull={true}
+ *   convertInt={false}
+ * />
+ * 
+ * @param {Object} props - 组件的属性。
+ * @param {number|string} props.value - 初始化输入框的值。
+ * @param {Object[]} props.options - 可选单位的数组，每个对象包含 value（单位的值）和 label（显示在下拉菜单中的标签）。
+ * @param {Function} props.onChange - 当输入值或单位改变时触发的回调函数。传递新的值作为参数。
+ * @param {number|string} [props.defaultValue] - 未指定 value 时的默认值。
+ * @param {boolean} [props.allowNull=true] - 是否允许空值。
+ * @param {boolean} [props.convertInt=false] - 是否将输入值转换为整数。
+ * @param {Object} rest - 传递给 InputNumber 组件的其他属性。
+ * 
+ * @returns {ReactElement} 返回一个 React 元素，表示一个带单位选择的数字输入框组件。
  */
 export default function (_ref) {
   var value = _ref.value,

package/es/lowcode/painter/components/PanelItem.js

@@ -7,30 +7,30 @@ import { startsWith } from 'lodash';
 import classNames from 'classnames';
 import styles from "../style/panel-item.less";
 
-/**
- * `PanelItem` 组件用于展示属性面板中的单个属性项。
- * 它支持展示一个标签（属性名称）及对应的组件（例如输入框、选择器等），并可通过传入的 `addon` 属性添加额外的内容。
- * 此组件支持折叠功能，可以通过 `collapsed` 属性控制初始折叠状态。
- *
- * @component
- * @example
- * ```jsx
- * <PanelItem
- *   label="属性名称"
- *   collapsed={false}
- *   addon={<div>额外内容</div>}
- * >
- *   <input type="text" />
- * </PanelItem>
- * ```
- *
- * @param {Object} props 组件接收的参数。
- * @param {string} props.label 显示的属性名称。如果标签以 `#` 开头，则不显示。
- * @param {boolean} [props.collapsed=true] 初始是否折叠。默认为 `true`。
- * @param {React.ReactNode} props.addon 当属性项展开时，可以在下方显示额外内容。
- * @param {React.ReactNode} props.children 对应于属性名称的组件，可以是输入框、下拉菜单等 React 节点。
- *
- * @returns {React.Element} 渲染属性名称、对应的组件以及可选的额外内容。
+/**
+ * `PanelItem` 组件用于展示属性面板中的单个属性项。
+ * 它支持展示一个标签（属性名称）及对应的组件（例如输入框、选择器等），并可通过传入的 `addon` 属性添加额外的内容。
+ * 此组件支持折叠功能，可以通过 `collapsed` 属性控制初始折叠状态。
+ *
+ * @component
+ * @example
+ * ```jsx
+ * <PanelItem
+ *   label="属性名称"
+ *   collapsed={false}
+ *   addon={<div>额外内容</div>}
+ * >
+ *   <input type="text" />
+ * </PanelItem>
+ * ```
+ *
+ * @param {Object} props 组件接收的参数。
+ * @param {string} props.label 显示的属性名称。如果标签以 `#` 开头，则不显示。
+ * @param {boolean} [props.collapsed=true] 初始是否折叠。默认为 `true`。
+ * @param {React.ReactNode} props.addon 当属性项展开时，可以在下方显示额外内容。
+ * @param {React.ReactNode} props.children 对应于属性名称的组件，可以是输入框、下拉菜单等 React 节点。
+ *
+ * @returns {React.Element} 渲染属性名称、对应的组件以及可选的额外内容。
  */
 export default function (_ref) {
   var field = _ref.field,

package/es/lowcode/painter/components/PopConfirm.js

@@ -7,14 +7,14 @@ import { Popconfirm } from 'luck-design/antd';
 import classNames from 'classnames';
 import styles from "../style/pop-confirm.less";
 
-/**
- * 这个组件是对 luck-design/antd 的 Popconfirm 组件的封装。
- * 它提供了一个带有自定义样式的弹出确认框，用于在用户尝试执行重要操作前提示确认信息。
- * 通过传入的 props 可以自定义 Popconfirm 组件的行为和外观。
- *
- * @param {Object} props - 传递给 Popconfirm 组件的属性。这包括所有标准的 Popconfirm 属性，
- *                         以及任何额外的属性，如事件处理器或自定义内容。
- * @returns {ReactNode} 返回一个配置了自定义样式和指定属性的 Popconfirm 组件实例。
+/**
+ * 这个组件是对 luck-design/antd 的 Popconfirm 组件的封装。
+ * 它提供了一个带有自定义样式的弹出确认框，用于在用户尝试执行重要操作前提示确认信息。
+ * 通过传入的 props 可以自定义 Popconfirm 组件的行为和外观。
+ *
+ * @param {Object} props - 传递给 Popconfirm 组件的属性。这包括所有标准的 Popconfirm 属性，
+ *                         以及任何额外的属性，如事件处理器或自定义内容。
+ * @returns {ReactNode} 返回一个配置了自定义样式和指定属性的 Popconfirm 组件实例。
  */
 export default function (_ref) {
   var _ref$showBtn = _ref.showBtn,