@tiny-codes/react-easy 1.4.0 → 1.4.1

package/es/components/Lexical/nodes/SelectNode.js

@@ -30,6 +30,11 @@ import { useLexicalComposerContext } from '@lexical/react/LexicalComposerContext
 import { Select } from 'antd';
 import { insertNodeAtCursor, updateDomStyle } from "../helpers";
 import { BaseDecoratorNode } from "./base";
+
+/**
+ * - EN: Props for SelectNode, extending antd Select props plus behavior flags.
+ * - CN: SelectNode 的属性，基于 antd Select 属性并附加行为标记。
+ */
 import { jsx as _jsx } from "react/jsx-runtime";
 export var SelectNode = /*#__PURE__*/function (_BaseDecoratorNode) {
   _inherits(SelectNode, _BaseDecoratorNode);
@@ -110,8 +115,6 @@ export var SelectNode = /*#__PURE__*/function (_BaseDecoratorNode) {
       var writable = this.getWritable();
       writable.__value = value;
     }
-
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
   }, {
     key: "getPropValue",
     value: function getPropValue(propName) {
@@ -149,6 +152,12 @@ export var SelectNode = /*#__PURE__*/function (_BaseDecoratorNode) {
   return SelectNode;
 }(BaseDecoratorNode);
 
+/**
+ * - EN: React decorator component rendered for SelectNode.
+ * - CN: SelectNode 对应的 React 装饰组件。
+ *
+ * @param node The bound SelectNode instance | 关联的 SelectNode 实例
+ */
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 function SelectComponent(_ref) {
   var node = _ref.node;
@@ -182,14 +191,35 @@ function SelectComponent(_ref) {
     onClear: handleClear
   }));
 }
+
+/**
+ * - EN: Factory to create a SelectNode.
+ * - CN: 创建 SelectNode 的工厂函数。
+ *
+ * @param props Props for the Select node | Select 节点的属性
+ */
 export function $createSelectNode(props) {
   return new SelectNode(props);
 }
 
+/**
+ * - EN: Type guard to check whether a node is SelectNode.
+ * - CN: 判断节点是否为 SelectNode 的类型守卫。
+ *
+ * @param node Node to test | 要检测的节点
+ */
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function $isSelectNode(node) {
   return node instanceof SelectNode;
 }
+
+/**
+ * - EN: Insert a SelectNode at the current cursor position.
+ * - CN: 在当前光标位置插入一个 SelectNode。
+ *
+ * @param editor LexicalEditor instance | LexicalEditor 实例
+ * @param props Props for the Select node | Select 节点的属性
+ */
 export function $insertSelectNode(editor, props) {
   editor.update(function () {
     var selectNode = $createSelectNode(_objectSpread(_objectSpread({}, props), {}, {
@@ -201,4 +231,9 @@ export function $insertSelectNode(editor, props) {
     insertNodeAtCursor(editor, selectNode);
   });
 }
+
+/**
+ * - EN: Props passed to the Select decorator component.
+ * - CN: 传递给 Select 装饰组件的属性。
+ */
 //# sourceMappingURL=SelectNode.js.map

package/es/components/Lexical/nodes/SelectNode.js.map

@@ -1 +1 @@
-{"version":3,"names":["useCallback","useLexicalComposerContext","Select","insertNodeAtCursor","updateDomStyle","BaseDecoratorNode","jsx","_jsx","SelectNode","_BaseDecoratorNode","_inherits","_super","_createSuper","props","_props$defaultValue","_this","_classCallCheck","call","_defineProperty","_assertThisInitialized","__value","defaultValue","undefined","_createClass","key","value","exportJSON","_objectSpread","_get","_getPrototypeOf","prototype","__props","type","getType","version","createDOM","_this$__props","span","document","createElement","containerStyle","updateDOM","decorate","SelectComponent","node","isInline","getTextContent","_this$__props2","_this2","_this$__props4","content","valueContent","String","textContentMode","_this$__props3","option","options","find","opt","label","spaceAround","concat","getValue","setValue","writable","getWritable","getPropValue","propName","_this$__props5","setProps","clone","getKey","importJSON","serializedNode","$createSelectNode","_ref","_ref2","selectProps","_objectWithoutProperties","_excluded","_useLexicalComposerCo","_useLexicalComposerCo2","_slicedToArray","editor","handleChange","update","_node$__props","_node$__props$onChang","onChange","handleClear","_node$__props2","_node$__props2$onClea","onClear","$isSelectNode","$insertSelectNode","selectNode","paddingLeft","paddingRight"],"sources":["../../../../src/components/Lexical/nodes/SelectNode.tsx"],"sourcesContent":["import { type CSSProperties, type ReactNode, useCallback } from 'react';\nimport { useLexicalComposerContext } from '@lexical/react/LexicalComposerContext';\nimport { Select } from 'antd';\nimport type { SelectProps } from 'antd';\nimport type { BaseOptionType, DefaultOptionType } from 'antd/es/select';\nimport type { LexicalEditor, LexicalNode, SerializedLexicalNode, Spread } from 'lexical';\nimport { insertNodeAtCursor, updateDomStyle } from '../helpers';\nimport type { BaseDecoratorNodeProps } from './base';\nimport { BaseDecoratorNode } from './base';\n\nexport interface SelectNodeProps<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ValueType = any,\n  OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType,\n> extends SelectProps<ValueType, OptionType>,\n    BaseDecoratorNodeProps {\n  /**\n   * 在获取editor的textContent时，是否将选项的label作为文本内容插入到编辑器中，默认 `value`\n   *\n   * - `label` - 将选项的label作为文本内容\n   * - `value` - 将选项的value作为文本内容\n   */\n  textContentMode?: 'label' | 'value';\n  /** 是否在`textContext`两边添加一个空格，默认`true` */\n  spaceAround?: boolean;\n  /** 容器样式 */\n  containerStyle?: CSSProperties;\n}\n\nexport class SelectNode<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ValueType = any,\n  OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType,\n> extends BaseDecoratorNode<ReactNode, SelectNodeProps<ValueType, OptionType>> {\n  __value: ValueType | undefined;\n\n  constructor(props?: SelectNodeProps<ValueType, OptionType> & { key?: string }) {\n    super(props);\n    this.__value = props?.defaultValue ?? undefined;\n  }\n  static getType(): string {\n    return 'antd.Select';\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static clone<ValueType = any, OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType>(\n    node: SelectNode<ValueType, OptionType>\n  ): SelectNode<ValueType, OptionType> {\n    return new SelectNode<ValueType, OptionType>({ ...node.__props, key: node.getKey() });\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static importJSON<ValueType = any, OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType>(\n    serializedNode: SerializedSelectNode<ValueType, OptionType>\n  ): SelectNode<ValueType, OptionType> {\n    return $createSelectNode(serializedNode.props);\n  }\n\n  exportJSON(): SerializedSelectNode<ValueType, OptionType> {\n    return {\n      ...super.exportJSON(),\n      props: this.__props,\n      type: this.getType(),\n      version: 1,\n    };\n  }\n\n  createDOM(): HTMLElement {\n    const span = document.createElement('span');\n    updateDomStyle(span, this.__props?.containerStyle);\n    return span;\n  }\n\n  updateDOM(): false {\n    return false;\n  }\n\n  decorate(): ReactNode {\n    return <SelectComponent node={this} />;\n  }\n\n  isInline(): boolean {\n    return true;\n  }\n\n  getTextContent(): string {\n    let content: string;\n    const valueContent = this.__value ? String(this.__value) : '';\n    if (this.__props?.textContentMode === 'label') {\n      const option = this.__props?.options?.find((opt) => opt.value === this.__value);\n      content = option?.label ? String(option.label) : valueContent;\n    } else {\n      content = valueContent;\n    }\n    if (this.__props?.spaceAround !== false) {\n      return ` ${content} `;\n    }\n    return content;\n  }\n\n  getValue(): ValueType | undefined {\n    return this.__value;\n  }\n\n  setValue(value: ValueType | undefined): void {\n    const writable = this.getWritable();\n    writable.__value = value;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  getPropValue(propName: keyof SelectNodeProps<ValueType, OptionType>): any {\n    return this.__props?.[propName];\n  }\n\n  setProps(props: SelectNodeProps<ValueType, OptionType>): void {\n    const writable = this.getWritable();\n    writable.__props = {\n      ...writable.__props,\n      ...props,\n    };\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction SelectComponent<ValueType = any, OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType>({\n  node,\n}: SelectComponentProps<ValueType, OptionType>): ReactNode {\n  /* eslint-disable @typescript-eslint/no-unused-vars */\n  const { textContentMode, spaceAround, containerStyle, ...selectProps } = node.__props || {};\n  /* eslint-enable @typescript-eslint/no-unused-vars */\n  const [editor] = useLexicalComposerContext();\n\n  const handleChange = useCallback<NonNullable<SelectNodeProps<ValueType, OptionType>['onChange']>>(\n    (value, options) => {\n      editor.update(() => {\n        node.setValue(value);\n        node.__props?.onChange?.(value, options);\n      });\n    },\n    [editor, node]\n  );\n\n  const handleClear = useCallback(() => {\n    editor.update(() => {\n      node.setValue(undefined);\n      node.__props?.onClear?.();\n    });\n  }, [editor, node]);\n\n  return <Select {...selectProps} value={node.getValue()} onChange={handleChange} onClear={handleClear} />;\n}\n\nexport function $createSelectNode<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ValueType = any,\n  OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType,\n>(props?: SelectNodeProps<ValueType, OptionType>): SelectNode<ValueType, OptionType> {\n  return new SelectNode<ValueType, OptionType>(props);\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function $isSelectNode(node: LexicalNode | null | undefined): node is SelectNode<any, any> {\n  return node instanceof SelectNode;\n}\n\nexport function $insertSelectNode<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ValueType = any,\n  OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType,\n>(editor: LexicalEditor, props: SelectNodeProps<ValueType, OptionType>): void {\n  editor.update(() => {\n    const selectNode = $createSelectNode<ValueType, OptionType>({\n      ...props,\n      containerStyle: {\n        paddingLeft: '8px',\n        paddingRight: '8px',\n        ...props.containerStyle,\n      },\n    });\n    insertNodeAtCursor(editor, selectNode);\n  });\n}\n\ninterface SelectComponentProps<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ValueType = any,\n  OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType,\n> {\n  node: SelectNode<ValueType, OptionType>;\n}\nexport type SerializedSelectNode<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ValueType = any,\n  OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType,\n> = Spread<\n  {\n    props?: SelectNodeProps<ValueType, OptionType>;\n  },\n  SerializedLexicalNode\n>;\n"],"mappings":"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"}
+{"version":3,"names":["useCallback","useLexicalComposerContext","Select","insertNodeAtCursor","updateDomStyle","BaseDecoratorNode","jsx","_jsx","SelectNode","_BaseDecoratorNode","_inherits","_super","_createSuper","props","_props$defaultValue","_this","_classCallCheck","call","_defineProperty","_assertThisInitialized","__value","defaultValue","undefined","_createClass","key","value","exportJSON","_objectSpread","_get","_getPrototypeOf","prototype","__props","type","getType","version","createDOM","_this$__props","span","document","createElement","containerStyle","updateDOM","decorate","SelectComponent","node","isInline","getTextContent","_this$__props2","_this2","_this$__props4","content","valueContent","String","textContentMode","_this$__props3","option","options","find","opt","label","spaceAround","concat","getValue","setValue","writable","getWritable","getPropValue","propName","_this$__props5","setProps","clone","getKey","importJSON","serializedNode","$createSelectNode","_ref","_ref2","selectProps","_objectWithoutProperties","_excluded","_useLexicalComposerCo","_useLexicalComposerCo2","_slicedToArray","editor","handleChange","update","_node$__props","_node$__props$onChang","onChange","handleClear","_node$__props2","_node$__props2$onClea","onClear","$isSelectNode","$insertSelectNode","selectNode","paddingLeft","paddingRight"],"sources":["../../../../src/components/Lexical/nodes/SelectNode.tsx"],"sourcesContent":["import { type CSSProperties, type ReactNode, useCallback } from 'react';\nimport { useLexicalComposerContext } from '@lexical/react/LexicalComposerContext';\nimport { Select } from 'antd';\nimport type { SelectProps } from 'antd';\nimport type { BaseOptionType, DefaultOptionType } from 'antd/es/select';\nimport type { LexicalEditor, LexicalNode, SerializedLexicalNode, Spread } from 'lexical';\nimport { insertNodeAtCursor, updateDomStyle } from '../helpers';\nimport type { BaseDecoratorNodeProps } from './base';\nimport { BaseDecoratorNode } from './base';\n\n/**\n * - EN: Props for SelectNode, extending antd Select props plus behavior flags.\n * - CN: SelectNode 的属性，基于 antd Select 属性并附加行为标记。\n */\nexport interface SelectNodeProps<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ValueType = any,\n  OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType,\n> extends SelectProps<ValueType, OptionType>,\n    BaseDecoratorNodeProps {\n  /**\n   * - EN: When reading editor textContent, whether to use option label or value. Default `value`.\n   * - CN: 在获取 editor 的 textContent 时，使用选项的 label 还是 value。默认 `value`。\n   * - label: use option label as text\n   * - value: use option value as text\n   */\n  textContentMode?: 'label' | 'value';\n  /**\n   * - EN: Add a space around textContent. Default `true`.\n   * - CN: 是否在 textContent 两边添加一个空格，默认 `true`。\n   */\n  spaceAround?: boolean;\n  /**\n   * - EN: Container DOM style.\n   * - CN: 容器样式。\n   */\n  containerStyle?: CSSProperties;\n}\n\nexport class SelectNode<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ValueType = any,\n  OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType,\n> extends BaseDecoratorNode<ReactNode, SelectNodeProps<ValueType, OptionType>> {\n  __value: ValueType | undefined;\n\n  constructor(props?: SelectNodeProps<ValueType, OptionType> & { key?: string }) {\n    super(props);\n    this.__value = props?.defaultValue ?? undefined;\n  }\n  static getType(): string {\n    return 'antd.Select';\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static clone<ValueType = any, OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType>(\n    node: SelectNode<ValueType, OptionType>\n  ): SelectNode<ValueType, OptionType> {\n    return new SelectNode<ValueType, OptionType>({ ...node.__props, key: node.getKey() });\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  static importJSON<ValueType = any, OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType>(\n    serializedNode: SerializedSelectNode<ValueType, OptionType>\n  ): SelectNode<ValueType, OptionType> {\n    return $createSelectNode(serializedNode.props);\n  }\n\n  exportJSON(): SerializedSelectNode<ValueType, OptionType> {\n    return {\n      ...super.exportJSON(),\n      props: this.__props,\n      type: this.getType(),\n      version: 1,\n    };\n  }\n\n  createDOM(): HTMLElement {\n    const span = document.createElement('span');\n    updateDomStyle(span, this.__props?.containerStyle);\n    return span;\n  }\n\n  updateDOM(): false {\n    return false;\n  }\n\n  decorate(): ReactNode {\n    return <SelectComponent node={this} />;\n  }\n\n  isInline(): boolean {\n    return true;\n  }\n\n  getTextContent(): string {\n    let content: string;\n    const valueContent = this.__value ? String(this.__value) : '';\n    if (this.__props?.textContentMode === 'label') {\n      const option = this.__props?.options?.find((opt) => opt.value === this.__value);\n      content = option?.label ? String(option.label) : valueContent;\n    } else {\n      content = valueContent;\n    }\n    if (this.__props?.spaceAround !== false) {\n      return ` ${content} `;\n    }\n    return content;\n  }\n\n  getValue(): ValueType | undefined {\n    return this.__value;\n  }\n\n  setValue(value: ValueType | undefined): void {\n    const writable = this.getWritable();\n    writable.__value = value;\n  }\n\n  getPropValue(\n    propName: keyof SelectNodeProps<ValueType, OptionType>\n  ): SelectNodeProps<ValueType, OptionType>[typeof propName] {\n    return this.__props?.[propName];\n  }\n\n  setProps(props: Partial<SelectNodeProps<ValueType, OptionType>>): void {\n    const writable = this.getWritable();\n    writable.__props = {\n      ...writable.__props,\n      ...props,\n    };\n  }\n}\n\n/**\n * - EN: React decorator component rendered for SelectNode.\n * - CN: SelectNode 对应的 React 装饰组件。\n *\n * @param node The bound SelectNode instance | 关联的 SelectNode 实例\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction SelectComponent<ValueType = any, OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType>({\n  node,\n}: SelectComponentProps<ValueType, OptionType>): ReactNode {\n  /* eslint-disable @typescript-eslint/no-unused-vars */\n  const { textContentMode, spaceAround, containerStyle, ...selectProps } = node.__props || {};\n  /* eslint-enable @typescript-eslint/no-unused-vars */\n  const [editor] = useLexicalComposerContext();\n\n  const handleChange = useCallback<NonNullable<SelectNodeProps<ValueType, OptionType>['onChange']>>(\n    (value, options) => {\n      editor.update(() => {\n        node.setValue(value);\n        node.__props?.onChange?.(value, options);\n      });\n    },\n    [editor, node]\n  );\n\n  const handleClear = useCallback(() => {\n    editor.update(() => {\n      node.setValue(undefined);\n      node.__props?.onClear?.();\n    });\n  }, [editor, node]);\n\n  return <Select {...selectProps} value={node.getValue()} onChange={handleChange} onClear={handleClear} />;\n}\n\n/**\n * - EN: Factory to create a SelectNode.\n * - CN: 创建 SelectNode 的工厂函数。\n *\n * @param props Props for the Select node | Select 节点的属性\n */\nexport function $createSelectNode<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ValueType = any,\n  OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType,\n>(props?: SelectNodeProps<ValueType, OptionType>): SelectNode<ValueType, OptionType> {\n  return new SelectNode<ValueType, OptionType>(props);\n}\n\n/**\n * - EN: Type guard to check whether a node is SelectNode.\n * - CN: 判断节点是否为 SelectNode 的类型守卫。\n *\n * @param node Node to test | 要检测的节点\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function $isSelectNode(node: LexicalNode | null | undefined): node is SelectNode<any, any> {\n  return node instanceof SelectNode;\n}\n\n/**\n * - EN: Insert a SelectNode at the current cursor position.\n * - CN: 在当前光标位置插入一个 SelectNode。\n *\n * @param editor LexicalEditor instance | LexicalEditor 实例\n * @param props Props for the Select node | Select 节点的属性\n */\nexport function $insertSelectNode<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ValueType = any,\n  OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType,\n>(editor: LexicalEditor, props: SelectNodeProps<ValueType, OptionType>): void {\n  editor.update(() => {\n    const selectNode = $createSelectNode<ValueType, OptionType>({\n      ...props,\n      containerStyle: {\n        paddingLeft: '8px',\n        paddingRight: '8px',\n        ...props.containerStyle,\n      },\n    });\n    insertNodeAtCursor(editor, selectNode);\n  });\n}\n\n/**\n * - EN: Props passed to the Select decorator component.\n * - CN: 传递给 Select 装饰组件的属性。\n */\ninterface SelectComponentProps<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ValueType = any,\n  OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType,\n> {\n  node: SelectNode<ValueType, OptionType>;\n}\ntype SerializedSelectNode<\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ValueType = any,\n  OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType,\n> = Spread<\n  {\n    props?: SelectNodeProps<ValueType, OptionType>;\n  },\n  SerializedLexicalNode\n>;\n"],"mappings":"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"}

package/es/components/Lexical/nodes/base.d.ts

@@ -1,25 +1,50 @@
 import type { LexicalNode } from 'lexical';
 import { DecoratorNode, ElementNode } from 'lexical';
+/**
+ * - EN: Common behavior flags for custom nodes.
+ * - CN: 自定义节点的通用行为标记。
+ */
 export interface BaseNodeProps {
-    /** 是否可被删除，默认 `true` */
+    /**
+     * - EN: Whether the node can be removed. Default `true`.
+     * - CN: 是否可被删除，默认 `true`。
+     */
     canBeRemoved?: boolean;
-    /** 是否可被替换，默认 `true` */
+    /**
+     * - EN: Whether the node can be replaced. Default `true`.
+     * - CN: 是否可被替换，默认 `true`。
+     */
     canBeReplaced?: boolean;
 }
+/**
+ * - EN: Extra behavior flags for element nodes.
+ * - CN: 元素节点的附加行为标记。
+ */
 export interface BaseElementProps extends BaseNodeProps {
     /**
-     * 是否允许节点为空，默认 `false`
-     *
-     * - `true` - 允许节点为空
-     * - `false` - 不允许节点为空，当最后一个子节点被删除后，节点也会被删除
+     * - EN: Whether an element is allowed to be empty. Default `false`.
+     * - CN: 是否允许节点为空，默认 `false`。
      */
     canBeEmpty?: boolean;
-    /** 是否允许在节点内的起始位置插入文本，默认 `true` */
+    /**
+     * - EN: Allow inserting text at the start of the element. Default `true`.
+     * - CN: 是否允许在节点内的起始位置插入文本，默认 `true`。
+     */
     canInsertTextBefore?: boolean;
-    /** 是否允许在节点内的结束位置插入文本，默认 `true` */
+    /**
+     * - EN: Allow inserting text at the end of the element. Default `true`.
+     * - CN: 是否允许在节点内的结束位置插入文本，默认 `true`。
+     */
     canInsertTextAfter?: boolean;
 }
 export type BaseDecoratorNodeProps = BaseNodeProps;
+/**
+ * - EN: A helper wrapping base behaviors (remove/replace) with guard flags.
+ * - CN: 封装基础行为（删除/替换）并根据标记进行限制的帮助器。
+ *
+ * @param props Node behavior flags | 节点行为标记
+ * @param superMethods Methods delegated to the underlying node | 委托给底层节点的方法
+ */
 export declare class BaseNodeHelper<P extends BaseNodeProps> {
     __props: (P & BaseNodeProps) | undefined;
     __superMethods: Pick<LexicalNode, 'replace' | 'remove'>;
@@ -28,8 +53,18 @@ export declare class BaseNodeHelper<P extends BaseNodeProps> {
         remove: (preserveEmptyParent?: boolean) => void;
         replace: <N extends LexicalNode>(replaceWith: N, includeChildren?: boolean) => N;
     };
+    /**
+     * - EN: Strip helper-only flags from props for DOM usage.
+     * - CN: 去除仅用于帮助器的标记属性，得到用于 DOM 的纯属性。
+     *
+     * @param props Props including helper flags | 含帮助标记的属性
+     */
     getUnderlyingProps(props: P & BaseNodeProps): Omit<P, keyof BaseNodeProps>;
 }
+/**
+ * - EN: Base element node with behavior flags.
+ * - CN: 带行为标记的基础元素节点。
+ */
 export declare class BaseElementNode<P extends BaseElementProps> extends ElementNode {
     __props: P | undefined;
     __base: BaseNodeHelper<P>;
@@ -39,13 +74,29 @@ export declare class BaseElementNode<P extends BaseElementProps> extends Element
     canBeEmpty(): boolean;
     canInsertTextBefore(): boolean;
     canInsertTextAfter(): boolean;
+    /**
+     * - EN: Strip element-specific flags and return DOM props.
+     * - CN: 去除元素特有的标记并返回 DOM 属性。
+     *
+     * @param props Element props including flags | 含标记的元素属性
+     */
     getUnderlyingProps(props: P | undefined): Omit<P, keyof BaseElementProps>;
 }
+/**
+ * - EN: Base decorator node with behavior flags.
+ * - CN: 带行为标记的基础装饰器节点。
+ */
 export declare class BaseDecoratorNode<T, P extends BaseDecoratorNodeProps> extends DecoratorNode<T> {
     __props: P | undefined;
     __base: BaseNodeHelper<P>;
     constructor(props?: P & {
         key?: string;
     });
+    /**
+     * - EN: Strip decorator-specific flags and return DOM props.
+     * - CN: 去除装饰器特有的标记并返回 DOM 属性。
+     *
+     * @param props Decorator props including flags | 含标记的装饰器属性
+     */
     getUnderlyingProps(props: P | undefined): Omit<P, keyof BaseDecoratorNodeProps>;
 }

package/es/components/Lexical/nodes/base.js

@@ -22,6 +22,24 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { DecoratorNode, ElementNode } from 'lexical';
+
+/**
+ * - EN: Common behavior flags for custom nodes.
+ * - CN: 自定义节点的通用行为标记。
+ */
+
+/**
+ * - EN: Extra behavior flags for element nodes.
+ * - CN: 元素节点的附加行为标记。
+ */
+
+/**
+ * - EN: A helper wrapping base behaviors (remove/replace) with guard flags.
+ * - CN: 封装基础行为（删除/替换）并根据标记进行限制的帮助器。
+ *
+ * @param props Node behavior flags | 节点行为标记
+ * @param superMethods Methods delegated to the underlying node | 委托给底层节点的方法
+ */
 export var BaseNodeHelper = /*#__PURE__*/function () {
   function BaseNodeHelper(props, superMethods) {
     var _this = this;
@@ -49,7 +67,14 @@ export var BaseNodeHelper = /*#__PURE__*/function () {
   }
   _createClass(BaseNodeHelper, [{
     key: "getUnderlyingProps",
-    value: function getUnderlyingProps(props) {
+    value:
+    /**
+     * - EN: Strip helper-only flags from props for DOM usage.
+     * - CN: 去除仅用于帮助器的标记属性，得到用于 DOM 的纯属性。
+     *
+     * @param props Props including helper flags | 含帮助标记的属性
+     */
+    function getUnderlyingProps(props) {
       /* eslint-disable @typescript-eslint/no-unused-vars */
       var canBeRemoved = props.canBeRemoved,
         canBeReplaced = props.canBeReplaced,
@@ -60,6 +85,11 @@ export var BaseNodeHelper = /*#__PURE__*/function () {
   }]);
   return BaseNodeHelper;
 }();
+
+/**
+ * - EN: Base element node with behavior flags.
+ * - CN: 带行为标记的基础元素节点。
+ */
 export var BaseElementNode = /*#__PURE__*/function (_ElementNode) {
   _inherits(BaseElementNode, _ElementNode);
   var _super = _createSuper(BaseElementNode);
@@ -108,6 +138,13 @@ export var BaseElementNode = /*#__PURE__*/function (_ElementNode) {
       var _this$__props$canInse2, _this$__props5;
       return (_this$__props$canInse2 = (_this$__props5 = this.__props) === null || _this$__props5 === void 0 ? void 0 : _this$__props5.canInsertTextAfter) !== null && _this$__props$canInse2 !== void 0 ? _this$__props$canInse2 : true;
     }
+
+    /**
+     * - EN: Strip element-specific flags and return DOM props.
+     * - CN: 去除元素特有的标记并返回 DOM 属性。
+     *
+     * @param props Element props including flags | 含标记的元素属性
+     */
   }, {
     key: "getUnderlyingProps",
     value: function getUnderlyingProps(props) {
@@ -123,6 +160,11 @@ export var BaseElementNode = /*#__PURE__*/function (_ElementNode) {
   }]);
   return BaseElementNode;
 }(ElementNode);
+
+/**
+ * - EN: Base decorator node with behavior flags.
+ * - CN: 带行为标记的基础装饰器节点。
+ */
 export var BaseDecoratorNode = /*#__PURE__*/function (_DecoratorNode) {
   _inherits(BaseDecoratorNode, _DecoratorNode);
   var _super2 = _createSuper(BaseDecoratorNode);
@@ -153,6 +195,13 @@ export var BaseDecoratorNode = /*#__PURE__*/function (_DecoratorNode) {
     });
     return _this3;
   }
+
+  /**
+   * - EN: Strip decorator-specific flags and return DOM props.
+   * - CN: 去除装饰器特有的标记并返回 DOM 属性。
+   *
+   * @param props Decorator props including flags | 含标记的装饰器属性
+   */
   _createClass(BaseDecoratorNode, [{
     key: "getUnderlyingProps",
     value: function getUnderlyingProps(props) {

package/es/components/Lexical/nodes/base.js.map

@@ -1 +1 @@
-{"version":3,"names":["DecoratorNode","ElementNode","BaseNodeHelper","props","superMethods","_this","_classCallCheck","_defineProperty","remove","preserveEmptyParent","_this$__props","__props","canBeRemoved","__superMethods","replace","replaceWith","includeChildren","_this$__props2","canBeReplaced","_createClass","key","value","getUnderlyingProps","restProps","_objectWithoutProperties","_excluded","BaseElementNode","_ElementNode","_inherits","_super","_createSuper","_thisSuper","_thisSuper2","_this2","_ref","_excluded2","call","_assertThisInitialized","__base","_get","_getPrototypeOf","prototype","Object","keys","hooks","forEach","method","bind","canBeEmpty","_this$__props$canBeEm","_this$__props3","canInsertTextBefore","_this$__props$canInse","_this$__props4","canInsertTextAfter","_this$__props$canInse2","_this$__props5","baseProps","_excluded3","BaseDecoratorNode","_DecoratorNode","_super2","_thisSuper3","_thisSuper4","_this3","_ref2","_excluded4","assign","_objectDestructuringEmpty"],"sources":["../../../../src/components/Lexical/nodes/base.ts"],"sourcesContent":["import type { LexicalNode } from 'lexical';\nimport { DecoratorNode, ElementNode } from 'lexical';\n\nexport interface BaseNodeProps {\n  /** 是否可被删除，默认 `true` */\n  canBeRemoved?: boolean;\n  /** 是否可被替换，默认 `true` */\n  canBeReplaced?: boolean;\n}\nexport interface BaseElementProps extends BaseNodeProps {\n  /**\n   * 是否允许节点为空，默认 `false`\n   *\n   * - `true` - 允许节点为空\n   * - `false` - 不允许节点为空，当最后一个子节点被删除后，节点也会被删除\n   */\n  canBeEmpty?: boolean;\n  /** 是否允许在节点内的起始位置插入文本，默认 `true` */\n  canInsertTextBefore?: boolean;\n  /** 是否允许在节点内的结束位置插入文本，默认 `true` */\n  canInsertTextAfter?: boolean;\n}\n\nexport type BaseDecoratorNodeProps = BaseNodeProps;\n\nexport class BaseNodeHelper<P extends BaseNodeProps> {\n  __props: (P & BaseNodeProps) | undefined;\n  __superMethods: Pick<LexicalNode, 'replace' | 'remove'>;\n\n  constructor(props: P | undefined, superMethods: Pick<LexicalNode, 'replace' | 'remove'>) {\n    this.__props = props as P & BaseNodeProps;\n    this.__superMethods = superMethods;\n  }\n\n  hooks = {\n    remove: (preserveEmptyParent?: boolean): void => {\n      if (this.__props?.canBeRemoved === false) {\n        return;\n      }\n      this.__superMethods.remove(preserveEmptyParent);\n    },\n\n    replace: <N extends LexicalNode>(replaceWith: N, includeChildren?: boolean): N => {\n      if (this.__props?.canBeReplaced === false) {\n        return this as unknown as N;\n      }\n      return this.__superMethods.replace(replaceWith, includeChildren);\n    },\n  };\n  getUnderlyingProps(props: P & BaseNodeProps): Omit<P, keyof BaseNodeProps> {\n    /* eslint-disable @typescript-eslint/no-unused-vars */\n    const { canBeRemoved, canBeReplaced, ...restProps } = props;\n    /* eslint-enable @typescript-eslint/no-unused-vars */\n    return restProps as P;\n  }\n}\n\nexport class BaseElementNode<P extends BaseElementProps> extends ElementNode {\n  __props: P | undefined;\n  __base: BaseNodeHelper<P>;\n\n  constructor(props?: P & { key?: string }) {\n    const { key, ...restProps } = props || {};\n    super(key);\n    this.__props = restProps as P;\n    this.__base = new BaseNodeHelper<P>(this.__props, {\n      remove: () => super.remove(),\n      replace: (replaceWith, includeChildren) => super.replace(replaceWith, includeChildren),\n    });\n    Object.keys(this.__base.hooks).forEach((key) => {\n      const method = this.__base.hooks[key as keyof typeof this.__base.hooks];\n      if (typeof method === 'function') {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        this[key as keyof this] = method.bind(this.__base) as any;\n      }\n    });\n  }\n\n  canBeEmpty(): boolean {\n    return this.__props?.canBeEmpty ?? false;\n  }\n\n  canInsertTextBefore(): boolean {\n    return this.__props?.canInsertTextBefore ?? true;\n  }\n\n  canInsertTextAfter(): boolean {\n    return this.__props?.canInsertTextAfter ?? true;\n  }\n\n  getUnderlyingProps(props: P | undefined): Omit<P, keyof BaseElementProps> {\n    const baseProps = this.__base.getUnderlyingProps(props ?? ({} as P));\n    /* eslint-disable @typescript-eslint/no-unused-vars */\n    const { canBeEmpty, canInsertTextBefore, canInsertTextAfter, ...restProps } = baseProps;\n    /* eslint-enable @typescript-eslint/no-unused-vars */\n    return restProps as P;\n  }\n}\n\nexport class BaseDecoratorNode<T, P extends BaseDecoratorNodeProps> extends DecoratorNode<T> {\n  __props: P | undefined;\n  __base: BaseNodeHelper<P>;\n\n  constructor(props?: P & { key?: string }) {\n    const { key, ...restProps } = props || {};\n    super(key);\n    this.__props = restProps as P;\n\n    this.__base = new BaseNodeHelper<P>(this.__props, {\n      remove: () => super.remove(),\n      replace: (replaceWith, includeChildren) => super.replace(replaceWith, includeChildren),\n    });\n    Object.keys(this.__base.hooks).forEach((key) => {\n      const method = this.__base.hooks[key as keyof typeof this.__base.hooks];\n      if (typeof method === 'function') {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        this[key as keyof this] = method.bind(this.__base) as any;\n      }\n    });\n  }\n\n  getUnderlyingProps(props: P | undefined): Omit<P, keyof BaseDecoratorNodeProps> {\n    const baseProps = this.__base.getUnderlyingProps(props ?? ({} as P));\n    /* eslint-disable @typescript-eslint/no-unused-vars */\n    const { ...restProps } = baseProps;\n    /* eslint-enable @typescript-eslint/no-unused-vars */\n    return restProps as P;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"names":["DecoratorNode","ElementNode","BaseNodeHelper","props","superMethods","_this","_classCallCheck","_defineProperty","remove","preserveEmptyParent","_this$__props","__props","canBeRemoved","__superMethods","replace","replaceWith","includeChildren","_this$__props2","canBeReplaced","_createClass","key","value","getUnderlyingProps","restProps","_objectWithoutProperties","_excluded","BaseElementNode","_ElementNode","_inherits","_super","_createSuper","_thisSuper","_thisSuper2","_this2","_ref","_excluded2","call","_assertThisInitialized","__base","_get","_getPrototypeOf","prototype","Object","keys","hooks","forEach","method","bind","canBeEmpty","_this$__props$canBeEm","_this$__props3","canInsertTextBefore","_this$__props$canInse","_this$__props4","canInsertTextAfter","_this$__props$canInse2","_this$__props5","baseProps","_excluded3","BaseDecoratorNode","_DecoratorNode","_super2","_thisSuper3","_thisSuper4","_this3","_ref2","_excluded4","assign","_objectDestructuringEmpty"],"sources":["../../../../src/components/Lexical/nodes/base.ts"],"sourcesContent":["import type { LexicalNode } from 'lexical';\nimport { DecoratorNode, ElementNode } from 'lexical';\n\n/**\n * - EN: Common behavior flags for custom nodes.\n * - CN: 自定义节点的通用行为标记。\n */\nexport interface BaseNodeProps {\n  /**\n   * - EN: Whether the node can be removed. Default `true`.\n   * - CN: 是否可被删除，默认 `true`。\n   */\n  canBeRemoved?: boolean;\n  /**\n   * - EN: Whether the node can be replaced. Default `true`.\n   * - CN: 是否可被替换，默认 `true`。\n   */\n  canBeReplaced?: boolean;\n}\n/**\n * - EN: Extra behavior flags for element nodes.\n * - CN: 元素节点的附加行为标记。\n */\nexport interface BaseElementProps extends BaseNodeProps {\n  /**\n   * - EN: Whether an element is allowed to be empty. Default `false`.\n   * - CN: 是否允许节点为空，默认 `false`。\n   */\n  canBeEmpty?: boolean;\n  /**\n   * - EN: Allow inserting text at the start of the element. Default `true`.\n   * - CN: 是否允许在节点内的起始位置插入文本，默认 `true`。\n   */\n  canInsertTextBefore?: boolean;\n  /**\n   * - EN: Allow inserting text at the end of the element. Default `true`.\n   * - CN: 是否允许在节点内的结束位置插入文本，默认 `true`。\n   */\n  canInsertTextAfter?: boolean;\n}\n\nexport type BaseDecoratorNodeProps = BaseNodeProps;\n\n/**\n * - EN: A helper wrapping base behaviors (remove/replace) with guard flags.\n * - CN: 封装基础行为（删除/替换）并根据标记进行限制的帮助器。\n *\n * @param props Node behavior flags | 节点行为标记\n * @param superMethods Methods delegated to the underlying node | 委托给底层节点的方法\n */\nexport class BaseNodeHelper<P extends BaseNodeProps> {\n  __props: (P & BaseNodeProps) | undefined;\n  __superMethods: Pick<LexicalNode, 'replace' | 'remove'>;\n\n  constructor(props: P | undefined, superMethods: Pick<LexicalNode, 'replace' | 'remove'>) {\n    this.__props = props as P & BaseNodeProps;\n    this.__superMethods = superMethods;\n  }\n\n  hooks = {\n    remove: (preserveEmptyParent?: boolean): void => {\n      if (this.__props?.canBeRemoved === false) {\n        return;\n      }\n      this.__superMethods.remove(preserveEmptyParent);\n    },\n\n    replace: <N extends LexicalNode>(replaceWith: N, includeChildren?: boolean): N => {\n      if (this.__props?.canBeReplaced === false) {\n        return this as unknown as N;\n      }\n      return this.__superMethods.replace(replaceWith, includeChildren);\n    },\n  };\n  /**\n   * - EN: Strip helper-only flags from props for DOM usage.\n   * - CN: 去除仅用于帮助器的标记属性，得到用于 DOM 的纯属性。\n   *\n   * @param props Props including helper flags | 含帮助标记的属性\n   */\n  getUnderlyingProps(props: P & BaseNodeProps): Omit<P, keyof BaseNodeProps> {\n    /* eslint-disable @typescript-eslint/no-unused-vars */\n    const { canBeRemoved, canBeReplaced, ...restProps } = props;\n    /* eslint-enable @typescript-eslint/no-unused-vars */\n    return restProps as P;\n  }\n}\n\n/**\n * - EN: Base element node with behavior flags.\n * - CN: 带行为标记的基础元素节点。\n */\nexport class BaseElementNode<P extends BaseElementProps> extends ElementNode {\n  __props: P | undefined;\n  __base: BaseNodeHelper<P>;\n\n  constructor(props?: P & { key?: string }) {\n    const { key, ...restProps } = props || {};\n    super(key);\n    this.__props = restProps as P;\n    this.__base = new BaseNodeHelper<P>(this.__props, {\n      remove: () => super.remove(),\n      replace: (replaceWith, includeChildren) => super.replace(replaceWith, includeChildren),\n    });\n    Object.keys(this.__base.hooks).forEach((key) => {\n      const method = this.__base.hooks[key as keyof typeof this.__base.hooks];\n      if (typeof method === 'function') {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        this[key as keyof this] = method.bind(this.__base) as any;\n      }\n    });\n  }\n\n  canBeEmpty(): boolean {\n    return this.__props?.canBeEmpty ?? false;\n  }\n\n  canInsertTextBefore(): boolean {\n    return this.__props?.canInsertTextBefore ?? true;\n  }\n\n  canInsertTextAfter(): boolean {\n    return this.__props?.canInsertTextAfter ?? true;\n  }\n\n  /**\n   * - EN: Strip element-specific flags and return DOM props.\n   * - CN: 去除元素特有的标记并返回 DOM 属性。\n   *\n   * @param props Element props including flags | 含标记的元素属性\n   */\n  getUnderlyingProps(props: P | undefined): Omit<P, keyof BaseElementProps> {\n    const baseProps = this.__base.getUnderlyingProps(props ?? ({} as P));\n    /* eslint-disable @typescript-eslint/no-unused-vars */\n    const { canBeEmpty, canInsertTextBefore, canInsertTextAfter, ...restProps } = baseProps;\n    /* eslint-enable @typescript-eslint/no-unused-vars */\n    return restProps as P;\n  }\n}\n\n/**\n * - EN: Base decorator node with behavior flags.\n * - CN: 带行为标记的基础装饰器节点。\n */\nexport class BaseDecoratorNode<T, P extends BaseDecoratorNodeProps> extends DecoratorNode<T> {\n  __props: P | undefined;\n  __base: BaseNodeHelper<P>;\n\n  constructor(props?: P & { key?: string }) {\n    const { key, ...restProps } = props || {};\n    super(key);\n    this.__props = restProps as P;\n\n    this.__base = new BaseNodeHelper<P>(this.__props, {\n      remove: () => super.remove(),\n      replace: (replaceWith, includeChildren) => super.replace(replaceWith, includeChildren),\n    });\n    Object.keys(this.__base.hooks).forEach((key) => {\n      const method = this.__base.hooks[key as keyof typeof this.__base.hooks];\n      if (typeof method === 'function') {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        this[key as keyof this] = method.bind(this.__base) as any;\n      }\n    });\n  }\n\n  /**\n   * - EN: Strip decorator-specific flags and return DOM props.\n   * - CN: 去除装饰器特有的标记并返回 DOM 属性。\n   *\n   * @param props Decorator props including flags | 含标记的装饰器属性\n   */\n  getUnderlyingProps(props: P | undefined): Omit<P, keyof BaseDecoratorNodeProps> {\n    const baseProps = this.__base.getUnderlyingProps(props ?? ({} as P));\n    /* eslint-disable @typescript-eslint/no-unused-vars */\n    const { ...restProps } = baseProps;\n    /* eslint-enable @typescript-eslint/no-unused-vars */\n    return restProps as P;\n  }\n}\n"],"mappings":"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"}

package/es/utils/index.d.ts

@@ -1,2 +1,3 @@
 export * from './color';
 export * from './math';
+export * from './string';

package/es/utils/index.js

@@ -1,3 +1,4 @@
 export * from "./color";
 export * from "./math";
+export * from "./string";
 //# sourceMappingURL=index.js.map

package/es/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["../../src/utils/index.ts"],"sourcesContent":["export * from './color';\nexport * from './math';\n"],"mappings":"AAAA;AACA"}
+{"version":3,"names":[],"sources":["../../src/utils/index.ts"],"sourcesContent":["export * from './color';\nexport * from './math';\nexport * from './string';\n"],"mappings":"AAAA;AACA;AACA"}

package/es/utils/string.d.ts

@@ -0,0 +1,7 @@
+/**
+ * - EN: Generate a random string of alphanumeric characters.
+ * - CN: 生成一个随机的字母数字字符串。
+ *
+ * @param length Length of the random string | 随机字符串的长度
+ */
+export declare function randomChars(length: number): string;

package/es/utils/string.js

@@ -0,0 +1,15 @@
+/**
+ * - EN: Generate a random string of alphanumeric characters.
+ * - CN: 生成一个随机的字母数字字符串。
+ *
+ * @param length Length of the random string | 随机字符串的长度
+ */
+export function randomChars(length) {
+  var chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+  var result = '';
+  for (var i = 0; i < length; i++) {
+    result += chars.charAt(Math.floor(Math.random() * chars.length));
+  }
+  return result;
+}
+//# sourceMappingURL=string.js.map

package/es/utils/string.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["randomChars","length","chars","result","i","charAt","Math","floor","random"],"sources":["../../src/utils/string.ts"],"sourcesContent":["/**\n * - EN: Generate a random string of alphanumeric characters.\n * - CN: 生成一个随机的字母数字字符串。\n *\n * @param length Length of the random string | 随机字符串的长度\n */\nexport function randomChars(length: number): string {\n  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';\n  let result = '';\n  for (let i = 0; i < length; i++) {\n    result += chars.charAt(Math.floor(Math.random() * chars.length));\n  }\n  return result;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,WAAWA,CAACC,MAAc,EAAU;EAClD,IAAMC,KAAK,GAAG,gEAAgE;EAC9E,IAAIC,MAAM,GAAG,EAAE;EACf,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGH,MAAM,EAAEG,CAAC,EAAE,EAAE;IAC/BD,MAAM,IAAID,KAAK,CAACG,MAAM,CAACC,IAAI,CAACC,KAAK,CAACD,IAAI,CAACE,MAAM,CAAC,CAAC,GAAGN,KAAK,CAACD,MAAM,CAAC,CAAC;EAClE;EACA,OAAOE,MAAM;AACf"}

package/lib/components/FormItemControl/index.d.ts

@@ -2,16 +2,16 @@ import type { FC, ReactNode } from 'react';
 export interface FormItemControlProps {
     children: (options: {
         value: any;
-        onChange?: (value: any) => void;
+        onChange: (value: any) => void;
     }) => ReactNode;
 }
 /**
- * - **EN:** FormItemControl is a component that wraps custom content into a valid Form.Item control.
- *   It provides a value and an onChange function to the children, allowing them to interact with
- *   the form state. This is useful for creating custom form controls that need to integrate with
- *   Ant Design's Form.Item.
- * - **CN:** FormItemControl 是一个将自定义内容包装成有效的 Form.Item 控件的组件。它向子组件提供了一个 `value` 和一个 `onChange`
- *   函数，使得子组件能够与表单状态进行交互。 这对于创建需要与 Ant Design 的 `Form.Item` 集成的自定义表单控件非常有用。
+ * - **EN:** FormItemControl is a component that wraps custom content into a valid Form.Item control,
+ *   and must be used as a direct child of Form.Item. It provides its children with a `value` and an
+ *   `onChange` function, allowing them to interact with the form state. This is useful for creating
+ *   custom form controls that need to integrate with Ant Design's Form.Item.
+ * - **CN:** FormItemControl 是一个将自定义内容包装成有效的 Form.Item 控件的组件，必须作为 Form.Item 的直接子节点使用。它向子组件提供了一个
+ *   `value` 和一个 `onChange` 函数，使得子组件能够与表单状态进行交互。这对于创建需要与 Ant Design 的 `Form.Item` 集成的自定义表单控件非常有用。
  */
 declare const FormItemControl: FC<FormItemControlProps>;
 export default FormItemControl;

package/lib/components/FormItemControl/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/components/FormItemControl/index.tsx"],
-  "sourcesContent": ["import type { FC, ReactNode } from 'react';\n\nexport interface FormItemControlProps {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  children: (options: { value: any; onChange?: (value: any) => void }) => ReactNode;\n}\n\n/**\n * - **EN:** FormItemControl is a component that wraps custom content into a valid Form.Item control.\n *   It provides a value and an onChange function to the children, allowing them to interact with\n *   the form state. This is useful for creating custom form controls that need to integrate with\n *   Ant Design's Form.Item.\n * - **CN:** FormItemControl 是一个将自定义内容包装成有效的 Form.Item 控件的组件。它向子组件提供了一个 `value` 和一个 `onChange`\n *   函数，使得子组件能够与表单状态进行交互。 这对于创建需要与 Ant Design 的 `Form.Item` 集成的自定义表单控件非常有用。\n */\nconst FormItemControl: FC<FormItemControlProps> = (props) => {\n  // eslint-disable-next-line react/prop-types\n  const { children, value, onChange } = props as FormItemControlProps & {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    value?: any;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    onChange?: (value: any) => void;\n  };\n\n  return children({ value, onChange });\n};\n\nexport default FormItemControl;\n"],
+  "sourcesContent": ["import type { FC, ReactNode } from 'react';\n\nexport interface FormItemControlProps {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  children: (options: { value: any; onChange: (value: any) => void }) => ReactNode;\n}\n\n/**\n * - **EN:** FormItemControl is a component that wraps custom content into a valid Form.Item control,\n *   and must be used as a direct child of Form.Item. It provides its children with a `value` and an\n *   `onChange` function, allowing them to interact with the form state. This is useful for creating\n *   custom form controls that need to integrate with Ant Design's Form.Item.\n * - **CN:** FormItemControl 是一个将自定义内容包装成有效的 Form.Item 控件的组件，必须作为 Form.Item 的直接子节点使用。它向子组件提供了一个\n *   `value` 和一个 `onChange` 函数，使得子组件能够与表单状态进行交互。这对于创建需要与 Ant Design 的 `Form.Item` 集成的自定义表单控件非常有用。\n */\nconst FormItemControl: FC<FormItemControlProps> = (props) => {\n  // eslint-disable-next-line react/prop-types\n  const { children, value, onChange } = props as FormItemControlProps & {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    value: any;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    onChange: (value: any) => void;\n  };\n\n  return children({ value, onChange });\n};\n\nexport default FormItemControl;\n"],
   "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAeA,IAAM,kBAA4C,CAAC,UAAU;AAE3D,QAAM,EAAE,UAAU,OAAO,SAAS,IAAI;AAOtC,SAAO,SAAS,EAAE,OAAO,SAAS,CAAC;AACrC;AAEA,IAAO,0BAAQ;",
   "names": []
 }

package/lib/components/Lexical/helpers/index.d.ts

@@ -1,58 +1,73 @@
 import type { CSSProperties, HtmlHTMLAttributes } from 'react';
 import type { LexicalEditor, LexicalNode } from 'lexical';
 /**
- * 将节点插入到当前光标位置
+ * - EN: Insert a node at the current cursor position.
+ * - CN: 将节点插入到当前光标位置。
  *
- * @param editor LexicalEditor 实例
- * @param node 要插入的节点
+ * @param editor LexicalEditor instance | LexicalEditor 实例
+ * @param node Node to insert | 要插入的节点
  */
 export declare function insertNodeAtCursor(editor: LexicalEditor, node: LexicalNode): void;
 /**
- * 将文本插入到当前光标位置
+ * - EN: Insert text at the current cursor position.
+ * - CN: 将文本插入到当前光标位置。
  *
- * @param editor LexicalEditor 实例
- * @param text 要插入的文本
+ * @param editor LexicalEditor instance | LexicalEditor 实例
+ * @param text Text to insert | 要插入的文本
  */
 export declare function insertTextAtCursor(editor: LexicalEditor, text: string): void;
 /**
- * 清空编辑器内容
+ * - EN: Clear the editor content.
+ * - CN: 清空编辑器内容。
  *
- * @param editor LexicalEditor 实例
+ * @param editor LexicalEditor instance | LexicalEditor 实例
  */
 export declare function clearEditorContent(editor: LexicalEditor): void;
 /**
- * 查找符合条件的节点
+ * - EN: Find the first node that matches the predicate.
+ * - CN: 查找第一个符合条件的节点。
  *
- * @param editor LexicalEditor 实例
- * @param predicate 用于匹配节点的函数
- * @param options 选项
+ * @param editor LexicalEditor instance | LexicalEditor 实例
+ * @param predicate Function to test whether a node matches | 用于匹配节点的函数
  *
- * @returns 符合条件的节点数组
+ * @returns The matched node, or undefined | 符合条件的第一个节点，或 undefined
  */
 export declare function findNode<T extends LexicalNode>(editor: LexicalEditor, predicate: (node: LexicalNode) => boolean): T | undefined;
 /**
- * 查找所有符合条件的节点数组
+ * - EN: Find all nodes that match the predicate.
+ * - CN: 查找所有符合条件的节点数组。
  *
- * @param editor LexicalEditor 实例
- * @param predicate 用于匹配节点的函数
- * @param options 选项
+ * @param editor LexicalEditor instance | LexicalEditor 实例
+ * @param predicate Function to test whether a node matches | 用于匹配节点的函数
+ * @param options Options | 选项
  *
- * @returns 符合条件的节点数组
+ * @returns An array of matched nodes | 符合条件的节点数组
  */
 export declare function findNodes<T extends LexicalNode>(editor: LexicalEditor, predicate: (node: LexicalNode) => boolean, options?: {
     stopOnFirstMatch?: boolean;
 }): T[];
 /**
- * 更新 DOM 元素的属性
+ * - EN: Update properties on a DOM element.
+ * - CN: 更新 DOM 元素的属性。
  *
- * @param dom 要更新的 DOM 元素
- * @param props 要设置的属性
+ * @param dom Target DOM element to update | 要更新的 DOM 元素
+ * @param props Props to set on the element | 要设置的属性
  */
 export declare function updateDomProps(dom: HTMLElement | undefined, props: HtmlHTMLAttributes<HTMLElement>): void;
 /**
- * 更新 DOM 元素的样式
+ * - EN: Update style on a DOM element.
+ * - CN: 更新 DOM 元素的样式。
  *
- * @param dom 要更新的 DOM 元素
- * @param style 要设置的样式
+ * @param dom Target DOM element to update | 要更新的 DOM 元素
+ * @param style Style to set | 要设置的样式
  */
 export declare function updateDomStyle(dom: HTMLElement | undefined, style: CSSProperties | undefined): void;
+/**
+ * - EN: Get attributes from a DOM element.
+ * - CN: 从 DOM 元素获取属性。
+ *
+ * @param dom Target DOM element | 目标 DOM 元素
+ *
+ * @returns Element attributes | 元素属性
+ */
+export declare function getDomAttributes(dom: HTMLElement | undefined): HtmlHTMLAttributes<HTMLElement> | undefined;

package/lib/components/Lexical/helpers/index.js

@@ -22,6 +22,7 @@ __export(helpers_exports, {
   clearEditorContent: () => clearEditorContent,
   findNode: () => findNode,
   findNodes: () => findNodes,
+  getDomAttributes: () => getDomAttributes,
   insertNodeAtCursor: () => insertNodeAtCursor,
   insertTextAtCursor: () => insertTextAtCursor,
   updateDomProps: () => updateDomProps,
@@ -185,11 +186,34 @@ function updateDomStyle(dom, style) {
     });
   }
 }
+function getDomAttributes(dom) {
+  if (!dom)
+    return void 0;
+  const attributes = {};
+  Array.from(dom.attributes).forEach((attr) => {
+    if (attr.name === "class" || attr.name === "style") {
+      return;
+    }
+    attributes[attr.name] = attr.value;
+  });
+  if (dom.className) {
+    attributes.className = dom.className;
+  }
+  if (dom.style) {
+    const styles = {};
+    Array.from(dom.style).forEach((styleName) => {
+      styles[styleName] = dom.style[styleName];
+    });
+    attributes.style = styles;
+  }
+  return attributes;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   clearEditorContent,
   findNode,
   findNodes,
+  getDomAttributes,
   insertNodeAtCursor,
   insertTextAtCursor,
   updateDomProps,