@luck-design-biz/luckda 0.0.24-1 → 0.0.25

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

@@ -10,43 +10,93 @@ var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends")
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
 var _react = _interopRequireWildcard(require("react"));
+var _ahooks = require("ahooks");
 var _numberInput = _interopRequireDefault(require("../style/number-input.less"));
 var _antd = require("luck-design/antd");
-var _excluded = ["value", "options", "onChange", "defaultValue"];
+var _lodash = require("lodash");
+var _excluded = ["value", "options", "onChange", "defaultValue", "allowNull", "convertInt"];
+/**
+ * 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 元素，表示一个带单位选择的数字输入框组件。
+ */
 function _default(_ref) {
   var value = _ref.value,
     options = _ref.options,
     onChange = _ref.onChange,
-    _ref$defaultValue = _ref.defaultValue,
-    defaultValue = _ref$defaultValue === void 0 ? 100 : _ref$defaultValue,
+    defaultValue = _ref.defaultValue,
+    _ref$allowNull = _ref.allowNull,
+    allowNull = _ref$allowNull === void 0 ? true : _ref$allowNull,
+    _ref$convertInt = _ref.convertInt,
+    convertInt = _ref$convertInt === void 0 ? false : _ref$convertInt,
     rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
-  var _useState = (0, _react.useState)(value),
+  var _useState = (0, _react.useState)(value !== null && value !== void 0 ? value : defaultValue),
     _useState2 = (0, _slicedToArray2.default)(_useState, 2),
     val = _useState2[0],
     setVal = _useState2[1];
-  var initValue;
-  (0, _react.useEffect)(function () {
+  (0, _ahooks.useUpdateEffect)(function () {
     setVal(value);
   }, [value]);
-  var _parseValue = parseValue(val),
+  var _parseValue = parseValue(val, options),
     number = _parseValue.number,
     unit = _parseValue.unit;
   var handleSelect = function handleSelect(item) {
     var newValue;
     if (item.key == 'auto') newValue = item.key;else if (isNaN(number)) {
-      newValue = defaultValue + item.key;
+      var defaultNumber = defaultValue !== null && defaultValue !== void 0 ? defaultValue : 0;
+      if (isNaN(defaultNumber)) {
+        var match = defaultNumber.match(/[\d\.]+/);
+        defaultNumber = match ? parseFloat(match[0]) : 0;
+      }
+      newValue = defaultNumber + item.key;
     } else {
       newValue = number + item.key;
     }
     changeValue(newValue);
   };
   var handleChange = function handleChange(value) {
-    changeValue(value + (unit !== null && unit !== void 0 ? unit : options[0].value));
+    if (!(0, _lodash.isNil)(value)) changeValue(value + (unit !== null && unit !== void 0 ? unit : options[0].value));else changeValue(null);
   };
   var changeValue = function changeValue(value) {
-    console.log('changeValue', value);
-    if (onChange) onChange(value);
-    setVal(value);
+    // 分离需要数字前缀的值和不需要数字前缀的值（如auto）
+    var numericValues = options.filter(function (option) {
+      return option.value !== 'auto';
+    }).map(function (option) {
+      return option.value.replace(/[-\/\\^$*+?.()|[\]{}]/g, '\\$&');
+    }).join('|');
+
+    // 构建正则表达式
+    var regex = new RegExp("^(\\d*(?:".concat(numericValues, ")|auto)$"));
+    var isValid = regex.test(value);
+    if (isValid || allowNull && (value === '' || value == null)) {
+      // 如果value符合要求，执行以下代码
+      if (onChange) onChange(convertInt ? parseInt(value) : value);
+      setVal(value);
+    }
   };
   var optionName = options[0].label;
   var menu = /*#__PURE__*/_react.default.createElement(_antd.Menu, {
@@ -71,13 +121,17 @@ function _default(_ref) {
     className: _numberInput.default['num-option']
   }, /*#__PURE__*/_react.default.createElement(_antd.Dropdown, {
     overlay: menu,
-    value: unit
+    value: unit,
+    disabled: options.length === 1,
+    getPopupContainer: function getPopupContainer() {
+      return document.getElementById('lc-design-workspace');
+    }
   }, /*#__PURE__*/_react.default.createElement("span", null, optionName)))));
 }
 
 // 解析value，分离数字和单位
-var parseValue = function parseValue(value) {
-  if (!value) {
+var parseValue = function parseValue(value, options) {
+  if (value === null || typeof value === 'undefined' || value === '') {
     return {
       number: null,
       unit: null
@@ -90,7 +144,7 @@ var parseValue = function parseValue(value) {
   if (result) {
     return {
       number: result[1],
-      unit: result[2] ? result[2] : null // 如果有非数字字符，则返回该字符，否则返回 null
+      unit: result[2] ? result[2] : options[0].value // 如果有非数字字符，则返回该字符，否则返回默认单位的第一项
     };
   } else {
     return {

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

@@ -6,11 +6,14 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = _default;
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _react = _interopRequireWildcard(require("react"));
+var _ahooks = require("ahooks");
+var _antd = require("luck-design/antd");
 var _lodash = require("lodash");
+var _classnames = _interopRequireDefault(require("classnames"));
 var _panelItem = _interopRequireDefault(require("../style/panel-item.less"));
-var _antd = require("luck-design/antd");
 /**
  * `PanelItem` 组件用于展示属性面板中的单个属性项。
  * 它支持展示一个标签（属性名称）及对应的组件（例如输入框、选择器等），并可通过传入的 `addon` 属性添加额外的内容。
@@ -37,34 +40,60 @@ var _antd = require("luck-design/antd");
  * @returns {React.Element} 渲染属性名称、对应的组件以及可选的额外内容。
  */
 function _default(_ref) {
-  var label = _ref.label,
+  var field = _ref.field,
+    label = _ref.label,
+    desc = _ref.desc,
     _ref$collapsed = _ref.collapsed,
     collapsed = _ref$collapsed === void 0 ? true : _ref$collapsed,
     addon = _ref.addon,
+    suppressPadding = _ref.suppressPadding,
     children = _ref.children;
   var _useState = (0, _react.useState)(collapsed),
     _useState2 = (0, _slicedToArray2.default)(_useState, 2),
     curClps = _useState2[0],
     setCurClps = _useState2[1];
-  var HandleClick = function HandleClick() {
+  var HandleClick = (0, _ahooks.useMemoizedFn)(function () {
+    if (!addon) return;
     setCurClps(!curClps);
-  };
+  });
+  var tip = (0, _ahooks.useCreation)(function () {
+    var str = void 0;
+    if (field) {
+      str = "\u5C5E\u6027\uFF1A".concat(field);
+    }
+    if (desc) {
+      str += "".concat(str ? ' | ' : '', "\u8BF4\u660E\uFF1A").concat(desc);
+    }
+    return str;
+  }, [field, desc]);
   (0, _react.useEffect)(function () {
     setCurClps(collapsed);
   }, [collapsed]);
   return /*#__PURE__*/_react.default.createElement("div", {
-    className: _panelItem.default['lc-painter-components-panelitem']
+    className: (0, _classnames.default)(_panelItem.default['lc-painter-components-panelitem'], (0, _defineProperty2.default)({}, _panelItem.default['no-padding'], !!suppressPadding))
   }, /*#__PURE__*/_react.default.createElement("div", {
     className: _panelItem.default['panelrow']
-  }, /*#__PURE__*/_react.default.createElement("div", {
-    className: _panelItem.default['item-label']
+  }, label && !(0, _lodash.startsWith)(label, '#') && /*#__PURE__*/_react.default.createElement("div", {
+    className: "".concat(_panelItem.default['item-label']).concat(addon ? ' panel-pointer' : ''),
+    onClick: HandleClick
   }, addon && /*#__PURE__*/_react.default.createElement(_antd.Icon, {
     className: _panelItem.default['item-icon'],
-    type: !curClps ? 'down' : 'right',
-    onClick: HandleClick
-  }), label && !(0, _lodash.startsWith)(label, '#') && /*#__PURE__*/_react.default.createElement("span", null, label)), /*#__PURE__*/_react.default.createElement("span", {
+    type: !curClps ? 'down' : 'right'
+  }), /*#__PURE__*/_react.default.createElement(_antd.Tooltip, {
+    overlayStyle: {
+      fontSize: '12px'
+    },
+    title: tip,
+    getPopupContainer: function getPopupContainer() {
+      return document.getElementById('lc-design-workspace');
+    }
+  }, /*#__PURE__*/_react.default.createElement("span", {
+    style: desc ? {
+      cursor: 'help'
+    } : null
+  }, label))), /*#__PURE__*/_react.default.createElement("span", {
     className: _panelItem.default['item-component']
-  }, children)), !curClps && /*#__PURE__*/_react.default.createElement("div", {
+  }, children)), !curClps && addon && /*#__PURE__*/_react.default.createElement("div", {
     className: _panelItem.default['addon']
   }, addon));
 }

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

@@ -6,21 +6,31 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = _default;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
 var _react = _interopRequireDefault(require("react"));
 var _antd = require("luck-design/antd");
+var _classnames = _interopRequireDefault(require("classnames"));
 var _popConfirm = _interopRequireDefault(require("../style/pop-confirm.less"));
+var _excluded = ["showBtn"];
 /**
  * 这个组件是对 luck-design/antd 的 Popconfirm 组件的封装。
  * 它提供了一个带有自定义样式的弹出确认框，用于在用户尝试执行重要操作前提示确认信息。
  * 通过传入的 props 可以自定义 Popconfirm 组件的行为和外观。
- * 
+ *
  * @param {Object} props - 传递给 Popconfirm 组件的属性。这包括所有标准的 Popconfirm 属性，
  *                         以及任何额外的属性，如事件处理器或自定义内容。
  * @returns {ReactNode} 返回一个配置了自定义样式和指定属性的 Popconfirm 组件实例。
  */
-function _default(props) {
+function _default(_ref) {
+  var _ref$showBtn = _ref.showBtn,
+    showBtn = _ref$showBtn === void 0 ? false : _ref$showBtn,
+    props = (0, _objectWithoutProperties2.default)(_ref, _excluded);
   return /*#__PURE__*/_react.default.createElement(_antd.Popconfirm, (0, _extends2.default)({
-    overlayClassName: _popConfirm.default['lc-painter-panel-section-components-popconfirm'],
-    icon: null
+    overlayClassName: (0, _classnames.default)(_popConfirm.default['lc-painter-panel-section-components-popconfirm'], (0, _defineProperty2.default)({}, _popConfirm.default['show-btn'], showBtn)),
+    icon: null,
+    getPopupContainer: function getPopupContainer() {
+      return document.getElementById('lc-design-workspace');
+    }
   }, props));
 }

package/lib/lowcode/painter/components/RuleInput.js

@@ -12,10 +12,11 @@ var _createForOfIteratorHelper2 = _interopRequireDefault(require("@babel/runtime
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
 var _react = _interopRequireWildcard(require("react"));
+var _ahooks = require("ahooks");
 var _antd = require("luck-design/antd");
 var _classnames = _interopRequireDefault(require("classnames"));
 var _ruleInput = _interopRequireDefault(require("../style/rule-input.less"));
-var _excluded = ["onValueChange", "rules", "value"];
+var _excluded = ["onValueChange", "rules", "value", "defaultValue"];
 /**
  * 带校验功能的输入组件。
  *
@@ -51,8 +52,9 @@ var _default = exports.default = /*#__PURE__*/(0, _react.forwardRef)(function (_
   var onValueChange = _ref.onValueChange,
     rules = _ref.rules,
     value = _ref.value,
+    defaultValue = _ref.defaultValue,
     rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);
-  var _useState = (0, _react.useState)(value),
+  var _useState = (0, _react.useState)(value || defaultValue),
     _useState2 = (0, _slicedToArray2.default)(_useState, 2),
     inputValue = _useState2[0],
     setInputValue = _useState2[1]; // 托管输入值的状态
@@ -62,7 +64,7 @@ var _default = exports.default = /*#__PURE__*/(0, _react.forwardRef)(function (_
     setErr = _useState4[1];
 
   // 使用useEffect钩子监听value的变化
-  (0, _react.useEffect)(function () {
+  (0, _ahooks.useUpdateEffect)(function () {
     setInputValue(value);
     setErr(null);
   }, [value]);

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

@@ -8,81 +8,78 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = void 0;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _objectSpread2 = _interopRequireDefault(require("@babel/runtime/helpers/objectSpread2"));
-var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
 var _react = _interopRequireWildcard(require("react"));
 var monaco = _interopRequireWildcard(require("monaco-editor"));
-var _excluded = ["onChange"],
-  _excluded2 = ["children", "language", "options", "onFullscreenChange"];
+var _excluded = ["onChange", "isFullscreen"],
+  _excluded2 = ["children", "language", "options"];
+/**
+ * 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__*/(0, _react.forwardRef)(function (_ref, ref) {
   var onChange = _ref.onChange,
+    isFullscreen = _ref.isFullscreen,
     props = (0, _objectWithoutProperties2.default)(_ref, _excluded);
   var children = props.children,
     _props$language = props.language,
     language = _props$language === void 0 ? 'javascript' : _props$language,
     _props$options = props.options,
     options = _props$options === void 0 ? {} : _props$options,
-    onFullscreenChange = props.onFullscreenChange,
     rest = (0, _objectWithoutProperties2.default)(props, _excluded2);
-  var _useState = (0, _react.useState)(false),
-    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
-    isFullScreen = _useState2[0],
-    setIsFullScreen = _useState2[1];
   var editorRef = (0, _react.useRef)(null);
   var editorInstance = (0, _react.useRef)(null);
 
-  // 全屏切换方法
-  var toggleFullScreen = function toggleFullScreen() {
-    var element = editorRef.current;
-    if (!document.fullscreenElement) {
-      if (element.requestFullscreen) {
-        element.requestFullscreen();
-      } else if (element.mozRequestFullScreen) {
-        element.mozRequestFullScreen();
-      } else if (element.webkitRequestFullscreen) {
-        element.webkitRequestFullscreen();
-      } else if (element.msRequestFullscreen) {
-        element.msRequestFullscreen();
-      }
-    } else {
-      if (document.exitFullscreen) {
-        document.exitFullscreen();
-      } else if (document.mozCancelFullScreen) {
-        document.mozCancelFullScreen();
-      } else if (document.webkitExitFullscreen) {
-        document.webkitExitFullscreen();
-      } else if (document.msExitFullscreen) {
-        document.msExitFullscreen();
-      }
-    }
-  };
-
-  // 监听全屏状态的改变，并调用 layout
-  (0, _react.useEffect)(function () {
-    var handleFullScreenChange = function handleFullScreenChange() {
-      var isFullScreenNow = !!document.fullscreenElement;
-      setIsFullScreen(isFullScreenNow);
-      if (editorInstance.current) {
-        editorInstance.current.layout();
-      }
-      if (onFullscreenChange) onFullscreenChange(isFullScreenNow);
-    };
-    document.addEventListener('fullscreenchange', handleFullScreenChange);
-
-    // 组件卸载时移除事件监听器
-    return function () {
-      document.removeEventListener('fullscreenchange', handleFullScreenChange);
-    };
-  }, []);
-
   // 初始化编辑器实例
   (0, _react.useEffect)(function () {
     if (editorRef.current) {
       var code = _react.default.Children.toArray(children).join('').trim();
       editorInstance.current = monaco.editor.create(editorRef.current, (0, _objectSpread2.default)({
         value: code,
-        language: language
-      }, options));
+        language: language,
+        automaticLayout: true
+      }, options), {
+        storageService: {
+          get: function get() {},
+          getBoolean: function getBoolean(key) {
+            if (key === 'expandSuggestionDocs') return true;
+            return false;
+          },
+          remove: function remove() {},
+          store: function store() {},
+          onWillSaveState: function onWillSaveState() {},
+          onDidChangeStorage: function onDidChangeStorage() {}
+        }
+      });
       editorInstance.current.onDidChangeModelContent(function (event) {
         if (onChange) onChange(editorInstance.current.getValue(), event);
       });
@@ -98,20 +95,12 @@ var BaseEditor = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref) {
     return {
       get editor() {
         return editorInstance.current;
-      },
-      toggleFullScreen: toggleFullScreen
+      }
     };
-  });
-
-  // 更新编辑器布局当全屏状态改变
-  (0, _react.useEffect)(function () {
-    if (editorInstance.current) {
-      editorInstance.current.layout();
-    }
-  }, [isFullScreen]);
+  }, []);
 
   // 根据是否全屏来设置编辑器的样式
-  var editorStyle = isFullScreen ? {
+  var editorStyle = isFullscreen ? {
     width: '100vw',
     height: '100vh'
   } : {

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

@@ -11,6 +11,32 @@ var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/h
 var _react = _interopRequireWildcard(require("react"));
 var _BaseEditor = _interopRequireDefault(require("./BaseEditor"));
 var _excluded = ["children"];
+/**
+ * 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__*/(0, _react.forwardRef)(function (_ref, ref) {
   var children = _ref.children,
     rest = (0, _objectWithoutProperties2.default)(_ref, _excluded);

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

@@ -13,23 +13,44 @@ var _react = _interopRequireWildcard(require("react"));
 var _antd = require("luck-design/antd");
 var _utils = require("@luck-design-biz/base/utils");
 var _fullscreenEditor = _interopRequireDefault(require("../../style/fullscreen-editor.less"));
+var _ahooks = require("ahooks");
 var _excluded = ["EditorComponent", "onLoad", "children"];
+/**
+ * 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__*/(0, _react.forwardRef)(function (_ref, ref) {
   var EditorComponent = _ref.EditorComponent,
     onLoad = _ref.onLoad,
     children = _ref.children,
     props = (0, _objectWithoutProperties2.default)(_ref, _excluded);
-  var _useState = (0, _react.useState)(false),
-    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
-    isFullScreen = _useState2[0],
-    setIsFullScreen = _useState2[1];
+  var fullscreenRef = (0, _react.useRef)(null);
+  var _useFullscreen = (0, _ahooks.useFullscreen)(fullscreenRef),
+    _useFullscreen2 = (0, _slicedToArray2.default)(_useFullscreen, 2),
+    isFullscreen = _useFullscreen2[0],
+    toggleFullscreen = _useFullscreen2[1].toggleFullscreen;
   var handleFullscreen = function handleFullscreen() {
-    if (ref.current && ref.current.toggleFullScreen) {
-      ref.current.toggleFullScreen();
-    }
-  };
-  var HandleFullscreenChange = function HandleFullscreenChange(fullscrean) {
-    setIsFullScreen(fullscrean);
+    toggleFullscreen();
   };
   (0, _react.useEffect)(function () {
     if (onLoad) onLoad();
@@ -47,11 +68,12 @@ var FullScreenEditor = /*#__PURE__*/(0, _react.forwardRef)(function (_ref, ref)
     type: "fullscreen",
     onClick: handleFullscreen
   }))), /*#__PURE__*/_react.default.createElement("div", {
-    className: isFullScreen ? _fullscreenEditor.default['fullscreen'] : ''
+    className: isFullscreen ? _fullscreenEditor.default['fullscreen'] : '',
+    ref: fullscreenRef
   }, /*#__PURE__*/_react.default.createElement(EditorComponent, (0, _extends2.default)({
     ref: ref,
-    onFullscreenChange: HandleFullscreenChange,
-    options: isFullScreen ? {} : {
+    isFullscreen: isFullscreen,
+    options: isFullscreen ? {} : {
       lineNumbers: 'off',
       glyphMargin: false,
       folding: false,