@luck-design-biz/luckda 0.0.25-14 → 0.0.25-16

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

@@ -7,17 +7,17 @@ import { DndContext } from '@dnd-kit/core';
 import { SortableContext, arrayMove, useSortable, verticalListSortingStrategy } from '@dnd-kit/sortable';
 import { CSS } from '@dnd-kit/utilities';
 
-/**
- * SortBox 是一个使用 dnd-kit 实现拖拽排序的组件。
- * 它允许子元素通过拖拽操作来重新排序，并在排序操作完成后通过 onChange 回调传递新的排序结果。
- * 
- * @param {Object} props 组件的 props。
- * @param {Array} props.datas 初始排序的数据数组，通常包含用于排序的唯一标识符。
- * @param {ReactNode} props.children 组件的子元素，通常是需要进行排序的元素集合。
- * @param {Function} props.onChange 当排序操作完成时触发的回调函数，参数为重新排序后的数据数组。
- * @param {Function} [props.strategy=verticalListSortingStrategy] 用于排序的策略。默认为垂直列表排序策略。
- * 
- * @returns {ReactNode} 返回一个配置了 DndContext 和 SortableContext 的 React 组件结构。
+/**
+ * SortBox 是一个使用 dnd-kit 实现拖拽排序的组件。
+ * 它允许子元素通过拖拽操作来重新排序，并在排序操作完成后通过 onChange 回调传递新的排序结果。
+ * 
+ * @param {Object} props 组件的 props。
+ * @param {Array} props.datas 初始排序的数据数组，通常包含用于排序的唯一标识符。
+ * @param {ReactNode} props.children 组件的子元素，通常是需要进行排序的元素集合。
+ * @param {Function} props.onChange 当排序操作完成时触发的回调函数，参数为重新排序后的数据数组。
+ * @param {Function} [props.strategy=verticalListSortingStrategy] 用于排序的策略。默认为垂直列表排序策略。
+ * 
+ * @returns {ReactNode} 返回一个配置了 DndContext 和 SortableContext 的 React 组件结构。
  */
 export var SortBox = function SortBox(_ref) {
   var datas = _ref.datas,
@@ -57,17 +57,17 @@ export var SortBox = function SortBox(_ref) {
   }, children));
 };
 
-/**
- * SortItem 组件是一个使用 dnd-kit 实现的可排序项。它通过 useSortable 钩子来提供拖拽功能，
- * 并将必要的属性和监听器传递给其子元素，使得子元素可拖拽。
- * 
- * @param {Object} props - 组件的 props。
- * @param {string} props.id - 该排序项的唯一标识符，用于识别不同的可排序元素。
- * @param {ReactNode} props.children - 该组件的子元素。通常是你希望使之可拖拽的元素。
- *                                    SortItem 会将拖拽相关的 props 注入到这个子元素中。
- * 
- * @returns {ReactNode} 返回一个增强后的 React 元素，此元素集成了拖拽功能。
- *                      它基于原 children 元素，附加了用于拖拽的属性和样式。
+/**
+ * SortItem 组件是一个使用 dnd-kit 实现的可排序项。它通过 useSortable 钩子来提供拖拽功能，
+ * 并将必要的属性和监听器传递给其子元素，使得子元素可拖拽。
+ * 
+ * @param {Object} props - 组件的 props。
+ * @param {string} props.id - 该排序项的唯一标识符，用于识别不同的可排序元素。
+ * @param {ReactNode} props.children - 该组件的子元素。通常是你希望使之可拖拽的元素。
+ *                                    SortItem 会将拖拽相关的 props 注入到这个子元素中。
+ * 
+ * @returns {ReactNode} 返回一个增强后的 React 元素，此元素集成了拖拽功能。
+ *                      它基于原 children 元素，附加了用于拖拽的属性和样式。
  */
 export var SortItem = function SortItem(_ref2) {
   var id = _ref2.id,

package/es/lowcode/painter/components/code-editor/BaseEditor.js

@@ -6,38 +6,38 @@ var _excluded = ["onChange", "isFullscreen", "style"],
 import React, { useEffect, useRef, useImperativeHandle, forwardRef } from 'react';
 import * as monaco from 'monaco-editor';
 
-/**
- * BaseEditor 组件是一个封装了 monaco 编辑器的 React 组件，支持前向 ref 引用。
- * 该组件允许用户编辑代码，并在代码发生变更时触发回调函数。
- * 它还支持通过 props 控制编辑器的语言、选项以及是否全屏显示。
- *
- * @component
- * @example
- * const handleEditorChange = (newValue, event) => {
- *   console.log('Editor content changed: ', newValue);
- * };
- * <BaseEditor
- *   language="javascript"
- *   onChange={handleEditorChange}
- *   isFullscreen={false}
- *   width="600px"
- *   height="400px"
- * >
- *   {`function sayHello() {\n  console.log('Hello, World!');\n}`}
- * </BaseEditor>
- *
- * @param {Object} props - 组件的属性。
- * @param {Function} props.onChange - 当编辑器内容变更时调用的函数。接收最新的编辑器内容和事件对象作为参数。
- * @param {boolean} props.isFullscreen - 控制编辑器是否全屏显示。
- * @param {string} [props.language='javascript'] - 设置编辑器的编程语言，默认为 'javascript'。
- * @param {Object} [props.options={}] - 用于自定义编辑器的选项。
- * @param {React.ReactNode} children - 子组件，通常是编辑器的初始代码。
- * @param {string} [props.width] - 编辑器的宽度，默认为 '100%'。
- * @param {string} [props.height] - 编辑器的高度，默认为 '100%'。
- * @param {Object} rest - 传递给 div 容器的其它属性。
- * @param {React.Ref} ref - React ref 引用，用于外部组件调用编辑器实例的方法。
- *
- * @returns {ReactElement} 返回一个 React 元素，其中包含了一个配置好的 monaco 编辑器实例。
+/**
+ * BaseEditor 组件是一个封装了 monaco 编辑器的 React 组件，支持前向 ref 引用。
+ * 该组件允许用户编辑代码，并在代码发生变更时触发回调函数。
+ * 它还支持通过 props 控制编辑器的语言、选项以及是否全屏显示。
+ *
+ * @component
+ * @example
+ * const handleEditorChange = (newValue, event) => {
+ *   console.log('Editor content changed: ', newValue);
+ * };
+ * <BaseEditor
+ *   language="javascript"
+ *   onChange={handleEditorChange}
+ *   isFullscreen={false}
+ *   width="600px"
+ *   height="400px"
+ * >
+ *   {`function sayHello() {\n  console.log('Hello, World!');\n}`}
+ * </BaseEditor>
+ *
+ * @param {Object} props - 组件的属性。
+ * @param {Function} props.onChange - 当编辑器内容变更时调用的函数。接收最新的编辑器内容和事件对象作为参数。
+ * @param {boolean} props.isFullscreen - 控制编辑器是否全屏显示。
+ * @param {string} [props.language='javascript'] - 设置编辑器的编程语言，默认为 'javascript'。
+ * @param {Object} [props.options={}] - 用于自定义编辑器的选项。
+ * @param {React.ReactNode} children - 子组件，通常是编辑器的初始代码。
+ * @param {string} [props.width] - 编辑器的宽度，默认为 '100%'。
+ * @param {string} [props.height] - 编辑器的高度，默认为 '100%'。
+ * @param {Object} rest - 传递给 div 容器的其它属性。
+ * @param {React.Ref} ref - React ref 引用，用于外部组件调用编辑器实例的方法。
+ *
+ * @returns {ReactElement} 返回一个 React 元素，其中包含了一个配置好的 monaco 编辑器实例。
  */
 var BaseEditor = /*#__PURE__*/forwardRef(function (_ref, ref) {
   var onChange = _ref.onChange,

package/es/lowcode/painter/components/code-editor/CssEditor.js

@@ -4,31 +4,31 @@ var _excluded = ["children"];
 import React, { forwardRef } from 'react';
 import BaseEditor from "./BaseEditor";
 
-/**
- * CssEditor 组件是一个专门用于编辑 CSS 代码的 React 组件，它基于 BaseEditor 组件构建。
- * 该组件通过将 language 属性固定设置为 "css"，确保编辑器环境专门用于 CSS 代码编辑。
- * 用户可以传入 CSS 代码作为 children，并通过其他 props 控制 BaseEditor 提供的额外功能。
- *
- * @component
- * @example
- * const handleCssChange = (newCss, event) => {
- *   console.log('CSS changed: ', newCss);
- * };
- * <CssEditor
- *   onChange={handleCssChange}
- *   isFullscreen={false}
- *   width="600px"
- *   height="400px"
- * >
- *   {`body { margin: 0; font-family: Arial, sans-serif; }`}
- * </CssEditor>
- *
- * @param {Object} props - 组件的属性。
- * @param {React.ReactNode} children - 子组件，通常是编辑器的初始 CSS 代码。
- * @param {Object} rest - 传递给 BaseEditor 组件的其他属性。
- * @param {React.Ref} ref - React ref 引用，用于外部组件调用编辑器实例的方法。
- *
- * @returns {ReactElement} 返回一个 React 元素，该元素内部是一个专门用于 CSS 编辑的 BaseEditor 组件实例。
+/**
+ * CssEditor 组件是一个专门用于编辑 CSS 代码的 React 组件，它基于 BaseEditor 组件构建。
+ * 该组件通过将 language 属性固定设置为 "css"，确保编辑器环境专门用于 CSS 代码编辑。
+ * 用户可以传入 CSS 代码作为 children，并通过其他 props 控制 BaseEditor 提供的额外功能。
+ *
+ * @component
+ * @example
+ * const handleCssChange = (newCss, event) => {
+ *   console.log('CSS changed: ', newCss);
+ * };
+ * <CssEditor
+ *   onChange={handleCssChange}
+ *   isFullscreen={false}
+ *   width="600px"
+ *   height="400px"
+ * >
+ *   {`body { margin: 0; font-family: Arial, sans-serif; }`}
+ * </CssEditor>
+ *
+ * @param {Object} props - 组件的属性。
+ * @param {React.ReactNode} children - 子组件，通常是编辑器的初始 CSS 代码。
+ * @param {Object} rest - 传递给 BaseEditor 组件的其他属性。
+ * @param {React.Ref} ref - React ref 引用，用于外部组件调用编辑器实例的方法。
+ *
+ * @returns {ReactElement} 返回一个 React 元素，该元素内部是一个专门用于 CSS 编辑的 BaseEditor 组件实例。
  */
 var CssEditor = /*#__PURE__*/forwardRef(function (_ref, ref) {
   var children = _ref.children,

package/es/lowcode/painter/components/code-editor/FullScreenEditor.js

@@ -8,29 +8,29 @@ import { formatMessage } from '@luck-design-biz/base/utils';
 import styles from "../../style/fullscreen-editor.less";
 import { useFullscreen } from 'ahooks';
 
-/**
- * FullScreenEditor 组件是一个支持全屏编辑模式的 React 组件，它利用提供的 EditorComponent 来实现代码编辑功能。
- * 该组件使用 ahooks 的 useFullscreen 钩子来实现全屏切换，并在全屏模式下调整编辑器布局。
- * 全屏/非全屏模式下编辑器的某些选项可能会有所不同，以适应不同的布局需求。
- *
- * @component
- * @example
- * const MyEditor = React.forwardRef((props, ref) => <BaseEditor {...props} ref={ref} />);
- * <FullScreenEditor
- *   EditorComponent={MyEditor}
- *   onLoad={() => console.log('Editor loaded')}
- * >
- *   {`function sayHello() {\n  console.log('Hello, World!');\n}`}
- * </FullScreenEditor>
- *
- * @param {Object} props - 组件的属性。
- * @param {Function} props.EditorComponent - 用于编辑的组件，该组件需要支持 ref 引用以调用编辑器的方法。
- * @param {Function} [props.onLoad] - 编辑器加载完成时的回调函数。
- * @param {React.ReactNode} children - 传递给 EditorComponent 的 children，通常是初始代码或内容。
- * @param {Object} rest - 传递给 EditorComponent 的其他属性。
- * @param {React.Ref} ref - React ref 引用，用于在外部组件中访问 EditorComponent 实例的方法。
- *
- * @returns {ReactElement} 返回一个 React 元素，其中包含了一个具有全屏切换功能的编辑器界面。
+/**
+ * FullScreenEditor 组件是一个支持全屏编辑模式的 React 组件，它利用提供的 EditorComponent 来实现代码编辑功能。
+ * 该组件使用 ahooks 的 useFullscreen 钩子来实现全屏切换，并在全屏模式下调整编辑器布局。
+ * 全屏/非全屏模式下编辑器的某些选项可能会有所不同，以适应不同的布局需求。
+ *
+ * @component
+ * @example
+ * const MyEditor = React.forwardRef((props, ref) => <BaseEditor {...props} ref={ref} />);
+ * <FullScreenEditor
+ *   EditorComponent={MyEditor}
+ *   onLoad={() => console.log('Editor loaded')}
+ * >
+ *   {`function sayHello() {\n  console.log('Hello, World!');\n}`}
+ * </FullScreenEditor>
+ *
+ * @param {Object} props - 组件的属性。
+ * @param {Function} props.EditorComponent - 用于编辑的组件，该组件需要支持 ref 引用以调用编辑器的方法。
+ * @param {Function} [props.onLoad] - 编辑器加载完成时的回调函数。
+ * @param {React.ReactNode} children - 传递给 EditorComponent 的 children，通常是初始代码或内容。
+ * @param {Object} rest - 传递给 EditorComponent 的其他属性。
+ * @param {React.Ref} ref - React ref 引用，用于在外部组件中访问 EditorComponent 实例的方法。
+ *
+ * @returns {ReactElement} 返回一个 React 元素，其中包含了一个具有全屏切换功能的编辑器界面。
  */
 var FullScreenEditor = /*#__PURE__*/forwardRef(function (_ref, ref) {
   var EditorComponent = _ref.EditorComponent,

package/es/lowcode/painter/components/code-editor/JSEditor.js

@@ -88,26 +88,26 @@ var setupAutocomplete = /*#__PURE__*/function () {
   };
 }();
 
-/**
- * JSEditor 组件是一个专为 JavaScript 编辑设计的 React 组件，它基于 BaseEditor 组件构建，并集成了自动完成功能。
- * 该组件利用 monaco-editor 提供的 API，通过 setupAutocomplete 函数设置自动完成项，从而增强代码编辑体验。
- * 自动完成逻辑包括从预定义的自动完成模块中加载补全项，以及在编辑器中键入特定字符（如"."）时触发补全建议。
- *
- * @component
- * @example
- * <JSEditor
- *   language="javascript"
- *   options={{ fontSize: 14 }}
- * >
- *   {`function sayHello() {\n  console.log('Hello, World!');\n}`}
- * </JSEditor>
- *
- * @param {Object} props - 组件的属性。
- * @param {React.ReactNode} children - 传递给 BaseEditor 的 children，通常是初始代码或内容。
- * @param {Object} rest - 传递给 BaseEditor 组件的其他属性。
- * @param {React.Ref} ref - React ref 引用，用于在外部组件中访问 BaseEditor 实例的方法。
- *
- * @returns {ReactElement} 返回一个 React 元素，其中包含了一个具有自动完成功能的 JavaScript 编辑器实例。
+/**
+ * JSEditor 组件是一个专为 JavaScript 编辑设计的 React 组件，它基于 BaseEditor 组件构建，并集成了自动完成功能。
+ * 该组件利用 monaco-editor 提供的 API，通过 setupAutocomplete 函数设置自动完成项，从而增强代码编辑体验。
+ * 自动完成逻辑包括从预定义的自动完成模块中加载补全项，以及在编辑器中键入特定字符（如"."）时触发补全建议。
+ *
+ * @component
+ * @example
+ * <JSEditor
+ *   language="javascript"
+ *   options={{ fontSize: 14 }}
+ * >
+ *   {`function sayHello() {\n  console.log('Hello, World!');\n}`}
+ * </JSEditor>
+ *
+ * @param {Object} props - 组件的属性。
+ * @param {React.ReactNode} children - 传递给 BaseEditor 的 children，通常是初始代码或内容。
+ * @param {Object} rest - 传递给 BaseEditor 组件的其他属性。
+ * @param {React.Ref} ref - React ref 引用，用于在外部组件中访问 BaseEditor 实例的方法。
+ *
+ * @returns {ReactElement} 返回一个 React 元素，其中包含了一个具有自动完成功能的 JavaScript 编辑器实例。
  */
 var JSEditor = /*#__PURE__*/forwardRef(function (_ref2, ref) {
   var children = _ref2.children,

package/es/lowcode/painter/components/code-editor/JsonEditor.js

@@ -4,31 +4,31 @@ var _excluded = ["children"];
 import React, { forwardRef } from 'react';
 import BaseEditor from "./BaseEditor";
 
-/**
- * JsonEditor 组件是一个专门用于编辑 CSS 代码的 React 组件，它基于 BaseEditor 组件构建。
- * 该组件通过将 language 属性固定设置为 "css"，确保编辑器环境专门用于 CSS 代码编辑。
- * 用户可以传入 CSS 代码作为 children，并通过其他 props 控制 BaseEditor 提供的额外功能。
- *
- * @component
- * @example
- * const handleCssChange = (newCss, event) => {
- *   console.log('CSS changed: ', newCss);
- * };
- * <JsonEditor
- *   onChange={handleCssChange}
- *   isFullscreen={false}
- *   width="600px"
- *   height="400px"
- * >
- *   {`body { margin: 0; font-family: Arial, sans-serif; }`}
- * </JsonEditor>
- *
- * @param {Object} props - 组件的属性。
- * @param {React.ReactNode} children - 子组件，通常是编辑器的初始 CSS 代码。
- * @param {Object} rest - 传递给 BaseEditor 组件的其他属性。
- * @param {React.Ref} ref - React ref 引用，用于外部组件调用编辑器实例的方法。
- *
- * @returns {ReactElement} 返回一个 React 元素，该元素内部是一个专门用于 CSS 编辑的 BaseEditor 组件实例。
+/**
+ * JsonEditor 组件是一个专门用于编辑 CSS 代码的 React 组件，它基于 BaseEditor 组件构建。
+ * 该组件通过将 language 属性固定设置为 "css"，确保编辑器环境专门用于 CSS 代码编辑。
+ * 用户可以传入 CSS 代码作为 children，并通过其他 props 控制 BaseEditor 提供的额外功能。
+ *
+ * @component
+ * @example
+ * const handleCssChange = (newCss, event) => {
+ *   console.log('CSS changed: ', newCss);
+ * };
+ * <JsonEditor
+ *   onChange={handleCssChange}
+ *   isFullscreen={false}
+ *   width="600px"
+ *   height="400px"
+ * >
+ *   {`body { margin: 0; font-family: Arial, sans-serif; }`}
+ * </JsonEditor>
+ *
+ * @param {Object} props - 组件的属性。
+ * @param {React.ReactNode} children - 子组件，通常是编辑器的初始 CSS 代码。
+ * @param {Object} rest - 传递给 BaseEditor 组件的其他属性。
+ * @param {React.Ref} ref - React ref 引用，用于外部组件调用编辑器实例的方法。
+ *
+ * @returns {ReactElement} 返回一个 React 元素，该元素内部是一个专门用于 CSS 编辑的 BaseEditor 组件实例。
  */
 var JsonEditor = /*#__PURE__*/forwardRef(function (_ref, ref) {
   var children = _ref.children,

package/es/lowcode/painter/panel-section/Icon.js

@@ -2,29 +2,29 @@ import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
 import React, { useState } from 'react';
 import styles from "../style/icon.less";
 import IconFont from "../../../components/IconFont";
-/**
- * 一个简单的图标选择器组件，展示了一个图标并允许用户点击选择。
- * 该组件使用了`Icon.createFromIconfontCN`来创建一个可以从Iconfont.cn加载图标的`IconFont`组件。
- * 当图标被点击时，会调用`onSelect`回调函数，并传递一个对象，其中包含了`field`字段。
- *
- * @component
- * @example
- * ```jsx
- * <IconSelector
- *   field="iconField"
- *   onSelect={({ field }) => console.log(`Selected icon field: ${field}`)}
- *   defaultValue="icon-example"
- * />
- * ```
- *
- * @param {Object} props 组件的props
- * @param {string} props.field 用于识别选择的图标字段的标识符。
- * @param {Function} props.onSelect 当图标被点击时触发的回调函数。
- *                                  接收一个对象参数，该对象包含`field`字段。
- * @param {string} [props.defaultValue='iconyingyongguanli'] 初始化时图标的类型，
- *                                                     默认为'iconyingyongguanli'。
- *
- * @returns {React.Element} 渲染的React元素。
+/**
+ * 一个简单的图标选择器组件，展示了一个图标并允许用户点击选择。
+ * 该组件使用了`Icon.createFromIconfontCN`来创建一个可以从Iconfont.cn加载图标的`IconFont`组件。
+ * 当图标被点击时，会调用`onSelect`回调函数，并传递一个对象，其中包含了`field`字段。
+ *
+ * @component
+ * @example
+ * ```jsx
+ * <IconSelector
+ *   field="iconField"
+ *   onSelect={({ field }) => console.log(`Selected icon field: ${field}`)}
+ *   defaultValue="icon-example"
+ * />
+ * ```
+ *
+ * @param {Object} props 组件的props
+ * @param {string} props.field 用于识别选择的图标字段的标识符。
+ * @param {Function} props.onSelect 当图标被点击时触发的回调函数。
+ *                                  接收一个对象参数，该对象包含`field`字段。
+ * @param {string} [props.defaultValue='iconyingyongguanli'] 初始化时图标的类型，
+ *                                                     默认为'iconyingyongguanli'。
+ *
+ * @returns {React.Element} 渲染的React元素。
  */
 export default function (_ref) {
   var defaultValue = _ref.defaultValue,

package/es/lowcode/painter/panel-section/IconSelector.js

@@ -10,22 +10,22 @@ import { formatMessage } from '@luck-design-biz/base/utils';
 import { ICONLIST_URL, ICONLIST_JS } from "../../constants/api-url";
 var Search = Input.Search;
 
-/**
- * 一个用于选择图标的组件，提供了图标的搜索和选择功能。
- *
- * 该组件首先从预定义的URL加载图标列表，然后显示这些图标。用户可以通过输入框搜索图标，
- * 点击图标时，会通过 `onChange` 回调将选中的图标信息返回给父组件。
- *
- * @component
- * @example
- * ```jsx
- * <IconSelector
- *   onChange={(selectedIcon) => console.log(selectedIcon)}
- * />
- * ```
- *
- * @param {Object} props 组件接受的props
- * @param {Function} props.onChange 当图标被选中时触发的回调函数，接受选中图标的信息作为参数
+/**
+ * 一个用于选择图标的组件，提供了图标的搜索和选择功能。
+ *
+ * 该组件首先从预定义的URL加载图标列表，然后显示这些图标。用户可以通过输入框搜索图标，
+ * 点击图标时，会通过 `onChange` 回调将选中的图标信息返回给父组件。
+ *
+ * @component
+ * @example
+ * ```jsx
+ * <IconSelector
+ *   onChange={(selectedIcon) => console.log(selectedIcon)}
+ * />
+ * ```
+ *
+ * @param {Object} props 组件接受的props
+ * @param {Function} props.onChange 当图标被选中时触发的回调函数，接受选中图标的信息作为参数
  */
 export default function (_ref) {
   var onChange = _ref.onChange,