@tiny-codes/react-easy 1.4.0 → 1.4.2

package/lib/components/Lexical/nodes/SelectNode.d.ts

@@ -4,17 +4,27 @@ import type { BaseOptionType, DefaultOptionType } from 'antd/es/select';
 import type { LexicalEditor, LexicalNode, SerializedLexicalNode, Spread } from 'lexical';
 import type { BaseDecoratorNodeProps } from './base';
 import { BaseDecoratorNode } from './base';
+/**
+ * - EN: Props for SelectNode, extending antd Select props plus behavior flags.
+ * - CN: SelectNode 的属性，基于 antd Select 属性并附加行为标记。
+ */
 export interface SelectNodeProps<ValueType = any, OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType> extends SelectProps<ValueType, OptionType>, BaseDecoratorNodeProps {
     /**
-     * 在获取editor的textContent时，是否将选项的label作为文本内容插入到编辑器中，默认 `value`
-     *
-     * - `label` - 将选项的label作为文本内容
-     * - `value` - 将选项的value作为文本内容
+     * - EN: When reading editor textContent, whether to use option label or value. Default `value`.
+     * - CN: 在获取 editor 的 textContent 时，使用选项的 label 还是 value。默认 `value`。
+     * - label: use option label as text
+     * - value: use option value as text
      */
     textContentMode?: 'label' | 'value';
-    /** 是否在`textContext`两边添加一个空格，默认`true` */
+    /**
+     * - EN: Add a space around textContent. Default `true`.
+     * - CN: 是否在 textContent 两边添加一个空格，默认 `true`。
+     */
     spaceAround?: boolean;
-    /** 容器样式 */
+    /**
+     * - EN: Container DOM style.
+     * - CN: 容器样式。
+     */
     containerStyle?: CSSProperties;
 }
 export declare class SelectNode<ValueType = any, OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType> extends BaseDecoratorNode<ReactNode, SelectNodeProps<ValueType, OptionType>> {
@@ -33,12 +43,32 @@ export declare class SelectNode<ValueType = any, OptionType extends BaseOptionTy
     getTextContent(): string;
     getValue(): ValueType | undefined;
     setValue(value: ValueType | undefined): void;
-    getPropValue(propName: keyof SelectNodeProps<ValueType, OptionType>): any;
-    setProps(props: SelectNodeProps<ValueType, OptionType>): void;
+    getPropValue(propName: keyof SelectNodeProps<ValueType, OptionType>): SelectNodeProps<ValueType, OptionType>[typeof propName];
+    setProps(props: Partial<SelectNodeProps<ValueType, OptionType>>): void;
 }
+/**
+ * - EN: Factory to create a SelectNode.
+ * - CN: 创建 SelectNode 的工厂函数。
+ *
+ * @param props Props for the Select node | Select 节点的属性
+ */
 export declare function $createSelectNode<ValueType = any, OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType>(props?: SelectNodeProps<ValueType, OptionType>): SelectNode<ValueType, OptionType>;
+/**
+ * - EN: Type guard to check whether a node is SelectNode.
+ * - CN: 判断节点是否为 SelectNode 的类型守卫。
+ *
+ * @param node Node to test | 要检测的节点
+ */
 export declare function $isSelectNode(node: LexicalNode | null | undefined): node is SelectNode<any, any>;
+/**
+ * - 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 declare function $insertSelectNode<ValueType = any, OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType>(editor: LexicalEditor, props: SelectNodeProps<ValueType, OptionType>): void;
-export type SerializedSelectNode<ValueType = any, OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType> = Spread<{
+type SerializedSelectNode<ValueType = any, OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType> = Spread<{
     props?: SelectNodeProps<ValueType, OptionType>;
 }, SerializedLexicalNode>;
+export {};

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

@@ -91,7 +91,6 @@ var SelectNode = class extends import_base.BaseDecoratorNode {
     const writable = this.getWritable();
     writable.__value = value;
   }
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   getPropValue(propName) {
     var _a;
     return (_a = this.__props) == null ? void 0 : _a[propName];
@@ -107,7 +106,8 @@ var SelectNode = class extends import_base.BaseDecoratorNode {
 function SelectComponent({
   node
 }) {
-  const { textContentMode, spaceAround, containerStyle, ...selectProps } = node.__props || {};
+  const underlyingProps = node.getUnderlyingProps(node.__props);
+  const { textContentMode, spaceAround, containerStyle, ...selectProps } = underlyingProps;
   const [editor] = (0, import_LexicalComposerContext.useLexicalComposerContext)();
   const handleChange = (0, import_react.useCallback)(
     (value, options) => {

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "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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",
+  "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  const underlyingProps = node.getUnderlyingProps(node.__props);\n  /* eslint-disable @typescript-eslint/no-unused-vars */\n  const { textContentMode, spaceAround, containerStyle, ...selectProps } = underlyingProps;\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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",
   "names": []
 }

package/lib/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/lib/components/Lexical/nodes/base.js

@@ -46,6 +46,12 @@ var BaseNodeHelper = class {
     this.__props = props;
     this.__superMethods = superMethods;
   }
+  /**
+   * - EN: Strip helper-only flags from props for DOM usage.
+   * - CN: 去除仅用于帮助器的标记属性，得到用于 DOM 的纯属性。
+   *
+   * @param props Props including helper flags | 含帮助标记的属性
+   */
   getUnderlyingProps(props) {
     const { canBeRemoved, canBeReplaced, ...restProps } = props;
     return restProps;
@@ -79,6 +85,12 @@ var BaseElementNode = class extends import_lexical.ElementNode {
     var _a;
     return ((_a = this.__props) == null ? void 0 : _a.canInsertTextAfter) ?? true;
   }
+  /**
+   * - EN: Strip element-specific flags and return DOM props.
+   * - CN: 去除元素特有的标记并返回 DOM 属性。
+   *
+   * @param props Element props including flags | 含标记的元素属性
+   */
   getUnderlyingProps(props) {
     const baseProps = this.__base.getUnderlyingProps(props ?? {});
     const { canBeEmpty, canInsertTextBefore, canInsertTextAfter, ...restProps } = baseProps;
@@ -101,6 +113,12 @@ var BaseDecoratorNode = class extends import_lexical.DecoratorNode {
       }
     });
   }
+  /**
+   * - EN: Strip decorator-specific flags and return DOM props.
+   * - CN: 去除装饰器特有的标记并返回 DOM 属性。
+   *
+   * @param props Decorator props including flags | 含标记的装饰器属性
+   */
   getUnderlyingProps(props) {
     const baseProps = this.__base.getUnderlyingProps(props ?? {});
     const { ...restProps } = baseProps;

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "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": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,qBAA2C;AAwBpC,IAAM,iBAAN,MAA8C;AAAA,EAInD,YAAY,OAAsB,cAAuD;AAKzF,iBAAQ;AAAA,MACN,QAAQ,CAAC,wBAAwC;AAnCrD;AAoCM,cAAI,UAAK,YAAL,mBAAc,kBAAiB,OAAO;AACxC;AAAA,QACF;AACA,aAAK,eAAe,OAAO,mBAAmB;AAAA,MAChD;AAAA,MAEA,SAAS,CAAwB,aAAgB,oBAAiC;AA1CtF;AA2CM,cAAI,UAAK,YAAL,mBAAc,mBAAkB,OAAO;AACzC,iBAAO;AAAA,QACT;AACA,eAAO,KAAK,eAAe,QAAQ,aAAa,eAAe;AAAA,MACjE;AAAA,IACF;AAlBE,SAAK,UAAU;AACf,SAAK,iBAAiB;AAAA,EACxB;AAAA,EAiBA,mBAAmB,OAAwD;AAEzE,UAAM,EAAE,cAAc,eAAe,GAAG,UAAU,IAAI;AAEtD,WAAO;AAAA,EACT;AACF;AAEO,IAAM,kBAAN,cAA0D,2BAAY;AAAA,EAI3E,YAAY,OAA8B;AACxC,UAAM,EAAE,KAAK,GAAG,UAAU,IAAI,SAAS,CAAC;AACxC,UAAM,GAAG;AACT,SAAK,UAAU;AACf,SAAK,SAAS,IAAI,eAAkB,KAAK,SAAS;AAAA,MAChD,QAAQ,MAAM,MAAM,OAAO;AAAA,MAC3B,SAAS,CAAC,aAAa,oBAAoB,MAAM,QAAQ,aAAa,eAAe;AAAA,IACvF,CAAC;AACD,WAAO,KAAK,KAAK,OAAO,KAAK,EAAE,QAAQ,CAACA,SAAQ;AAC9C,YAAM,SAAS,KAAK,OAAO,MAAMA,IAAqC;AACtE,UAAI,OAAO,WAAW,YAAY;AAEhC,aAAKA,IAAiB,IAAI,OAAO,KAAK,KAAK,MAAM;AAAA,MACnD;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,aAAsB;AA9ExB;AA+EI,aAAO,UAAK,YAAL,mBAAc,eAAc;AAAA,EACrC;AAAA,EAEA,sBAA+B;AAlFjC;AAmFI,aAAO,UAAK,YAAL,mBAAc,wBAAuB;AAAA,EAC9C;AAAA,EAEA,qBAA8B;AAtFhC;AAuFI,aAAO,UAAK,YAAL,mBAAc,uBAAsB;AAAA,EAC7C;AAAA,EAEA,mBAAmB,OAAuD;AACxE,UAAM,YAAY,KAAK,OAAO,mBAAmB,SAAU,CAAC,CAAO;AAEnE,UAAM,EAAE,YAAY,qBAAqB,oBAAoB,GAAG,UAAU,IAAI;AAE9E,WAAO;AAAA,EACT;AACF;AAEO,IAAM,oBAAN,cAAqE,6BAAiB;AAAA,EAI3F,YAAY,OAA8B;AACxC,UAAM,EAAE,KAAK,GAAG,UAAU,IAAI,SAAS,CAAC;AACxC,UAAM,GAAG;AACT,SAAK,UAAU;AAEf,SAAK,SAAS,IAAI,eAAkB,KAAK,SAAS;AAAA,MAChD,QAAQ,MAAM,MAAM,OAAO;AAAA,MAC3B,SAAS,CAAC,aAAa,oBAAoB,MAAM,QAAQ,aAAa,eAAe;AAAA,IACvF,CAAC;AACD,WAAO,KAAK,KAAK,OAAO,KAAK,EAAE,QAAQ,CAACA,SAAQ;AAC9C,YAAM,SAAS,KAAK,OAAO,MAAMA,IAAqC;AACtE,UAAI,OAAO,WAAW,YAAY;AAEhC,aAAKA,IAAiB,IAAI,OAAO,KAAK,KAAK,MAAM;AAAA,MACnD;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,mBAAmB,OAA6D;AAC9E,UAAM,YAAY,KAAK,OAAO,mBAAmB,SAAU,CAAC,CAAO;AAEnE,UAAM,EAAE,GAAG,UAAU,IAAI;AAEzB,WAAO;AAAA,EACT;AACF;",
+  "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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",
   "names": ["key"]
 }

package/lib/utils/index.d.ts

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

package/lib/utils/index.js

@@ -18,9 +18,11 @@ var utils_exports = {};
 module.exports = __toCommonJS(utils_exports);
 __reExport(utils_exports, require("./color"), module.exports);
 __reExport(utils_exports, require("./math"), module.exports);
+__reExport(utils_exports, require("./string"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./color"),
-  ...require("./math")
+  ...require("./math"),
+  ...require("./string")
 });
 //# sourceMappingURL=index.js.map

package/lib/utils/index.js.map

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

package/lib/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/lib/utils/string.js

@@ -0,0 +1,37 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/string.ts
+var string_exports = {};
+__export(string_exports, {
+  randomChars: () => randomChars
+});
+module.exports = __toCommonJS(string_exports);
+function randomChars(length) {
+  const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+  let result = "";
+  for (let i = 0; i < length; i++) {
+    result += chars.charAt(Math.floor(Math.random() * chars.length));
+  }
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  randomChars
+});
+//# sourceMappingURL=string.js.map

package/lib/utils/string.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "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;AAAA;AAAA;AAAA;AAAA;AAMO,SAAS,YAAY,QAAwB;AAClD,QAAM,QAAQ;AACd,MAAI,SAAS;AACb,WAAS,IAAI,GAAG,IAAI,QAAQ,KAAK;AAC/B,cAAU,MAAM,OAAO,KAAK,MAAM,KAAK,OAAO,IAAI,MAAM,MAAM,CAAC;AAAA,EACjE;AACA,SAAO;AACT;",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiny-codes/react-easy",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "Simplify React and AntDesign development with practical components and hooks",
   "keywords": [
     "react",