@baishuyun/ui-base 6.7.2 → 6.8.2

package/dist/components/DropDown/interface.d.ts

@@ -1,170 +1,168 @@
 import { ReactNode } from 'react';
-
-
-/**
- * 浮层偏移量接口
- */
-export interface OffsetType {
-  /**
-   * x 轴偏移量
-   * @default 0
-   */
-  x: number;
-  /**
-   * y 轴偏移量
-   * @default 0
-   */
-  y: number;
-}
-
-/**
- * 下拉菜单项接口
- */
-export interface MenuItemType {
-  /**
-   * 菜单项的唯一标识
-   */
-  key: string;
-  /**
-   * 菜单项的显示内容，可以是字符串或 React 节点
-   */
-  label: ReactNode;
-  /**
-   * 菜单项的图标
-   */
-  icon?: ReactNode;
-  /**
-   * 是否禁用该菜单项
-   * @default false
-   */
-  disabled?: boolean;
-
-  /**
-   * 是否是系统字段
-   * @description 系统字段的颜色会比较突出，和其他字段仅文字样式的不同
-   */
-  systemField?: boolean;
-  /**
-   * 允许任意额外字段，用于自定义搜索或其他用途
-   */
-  [key: string]: any;
-}
-
-/**
- * 下拉组件级颜色 token
- */
-export interface DropDownTheme {
-  /**
-   * 浮层背景色
-   * @default #fff
-   */
-  colorBgContainer?: string;
-  /**
-   * 菜单项默认文字颜色
-   * @default #121211
-   */
-  colorText?: string;
-  /**
-   * 菜单项图标颜色
-   * @default #6f829e
-   */
-  colorIcon?: string;
-  /**
-   * 禁用态文字/图标颜色
-   * @default #999
-   */
-  colorTextDisabled?: string;
-  /**
-   * 菜单项悬停背景色
-   * @default #eff0f6
-   */
-  itemHoverBg?: string;
-  /**
-   * 高亮项背景色
-   * @default #f0f6ff
-   */
-  itemActiveBg?: string;
-  /**
-   * 高亮项文字/图标颜色
-   * @default #0265ff
-   */
-  itemActiveColor?: string;
-}
-
-/**
- * 下拉组件的属性接口
- */
-export interface DropDownProps {
-  /**
-   * 触发器子元素
-   */
-  children: ReactNode;
-  /**
-   * 下拉菜单的菜单项列表
-   */
-  menus: MenuItemType[];
-  /**
-   * 菜单项点击时的回调函数
-   */
-  onClick?: (menuItem: MenuItemType) => void;
-  /**
-   * 下拉菜单打开/关闭状态变化时的回调函数
-   */
-  onOpenChange?: (open: boolean) => void;
-  /**
-   * 控制下拉菜单的显示隐藏状态（受控模式）
-   * @description 当传入此属性时，组件将变为受控模式
-   */
-  visible?: boolean;
-  /**
-   * 搜索框的占位符文本
-   * @default '搜索'
-   */
-  searchPlaceholder?: string;
-  /**
-   * 搜索值变化时的回调函数
-   */
-  onSearch?: (searchValue: string) => void;
-  /**
-   * 用于搜索的字段名
-   * @default 'label'
-   */
-  searchKey?: string;
-  /**
-   * 是否显示搜索框
-   * @default true
-   */
-  showSearch?: boolean;
-  /**
-   * 选择菜单项后是否关闭面板
-   * @default true
-   */
-  closeOnSelect?: boolean;
-  /**
-   * 浮层偏移量
-   * @default { x: 0, y: 0 }
-   */
-  offset?: OffsetType;
-  /**
-   * 自定义下拉菜单的样式
-   */
-  style?: React.CSSProperties;
-
-  /**
-   * 下拉面板浮层的 z-index
-   */
-  zIndex?: number;
-  /**
-   * 指定下拉浮层渲染的父级 DOM 节点
-   */
-  getPopupContainer?: () => HTMLElement;
-  /**
-   * 高亮的菜单项 key 数组
-   * @description 指定哪些菜单项应该被高亮显示
-   */
-  activeKey?: string[];
-  /**
-   * 组件级颜色 token
-   */
-  theme?: DropDownTheme;
-}
+/**
+ * 浮层偏移量接口
+ */
+export interface OffsetType {
+  /**
+   * x 轴偏移量
+   * @default 0
+   */
+  x: number;
+  /**
+   * y 轴偏移量
+   * @default 0
+   */
+  y: number;
+}
+
+/**
+ * 下拉菜单项接口
+ */
+export interface MenuItemType {
+  /**
+   * 菜单项的唯一标识
+   */
+  key: string;
+  /**
+   * 菜单项的显示内容，可以是字符串或 React 节点
+   */
+  label: ReactNode;
+  /**
+   * 菜单项的图标
+   */
+  icon?: ReactNode;
+  /**
+   * 是否禁用该菜单项
+   * @default false
+   */
+  disabled?: boolean;
+
+  /**
+   * 是否是系统字段
+   * @description 系统字段的颜色会比较突出，和其他字段仅文字样式的不同
+   */
+  systemField?: boolean;
+  /**
+   * 允许任意额外字段，用于自定义搜索或其他用途
+   */
+  [key: string]: any;
+}
+
+/**
+ * 下拉组件级颜色 token
+ */
+export interface DropDownTheme {
+  /**
+   * 浮层背景色
+   * @default #fff
+   */
+  colorBgContainer?: string;
+  /**
+   * 菜单项默认文字颜色
+   * @default #121211
+   */
+  colorText?: string;
+  /**
+   * 菜单项图标颜色
+   * @default #6f829e
+   */
+  colorIcon?: string;
+  /**
+   * 禁用态文字/图标颜色
+   * @default #999
+   */
+  colorTextDisabled?: string;
+  /**
+   * 菜单项悬停背景色
+   * @default #eff0f6
+   */
+  itemHoverBg?: string;
+  /**
+   * 高亮项背景色
+   * @default #f0f6ff
+   */
+  itemActiveBg?: string;
+  /**
+   * 高亮项文字/图标颜色
+   * @default #0265ff
+   */
+  itemActiveColor?: string;
+}
+
+/**
+ * 下拉组件的属性接口
+ */
+export interface DropDownProps {
+  /**
+   * 触发器子元素
+   */
+  children: ReactNode;
+  /**
+   * 下拉菜单的菜单项列表
+   */
+  menus: MenuItemType[];
+  /**
+   * 菜单项点击时的回调函数
+   */
+  onClick?: (menuItem: MenuItemType) => void;
+  /**
+   * 下拉菜单打开/关闭状态变化时的回调函数
+   */
+  onOpenChange?: (open: boolean) => void;
+  /**
+   * 控制下拉菜单的显示隐藏状态（受控模式）
+   * @description 当传入此属性时，组件将变为受控模式
+   */
+  visible?: boolean;
+  /**
+   * 搜索框的占位符文本
+   * @default '搜索'
+   */
+  searchPlaceholder?: string;
+  /**
+   * 搜索值变化时的回调函数
+   */
+  onSearch?: (searchValue: string) => void;
+  /**
+   * 用于搜索的字段名
+   * @default 'label'
+   */
+  searchKey?: string;
+  /**
+   * 是否显示搜索框
+   * @default true
+   */
+  showSearch?: boolean;
+  /**
+   * 选择菜单项后是否关闭面板
+   * @default true
+   */
+  closeOnSelect?: boolean;
+  /**
+   * 浮层偏移量
+   * @default { x: 0, y: 0 }
+   */
+  offset?: OffsetType;
+  /**
+   * 自定义下拉菜单的样式
+   */
+  style?: React.CSSProperties;
+
+  /**
+   * 下拉面板浮层的 z-index
+   */
+  zIndex?: number;
+  /**
+   * 指定下拉浮层渲染的父级 DOM 节点
+   */
+  getPopupContainer?: () => HTMLElement;
+  /**
+   * 高亮的菜单项 key 数组
+   * @description 指定哪些菜单项应该被高亮显示
+   */
+  activeKey?: string[];
+  /**
+   * 组件级颜色 token
+   */
+  theme?: DropDownTheme;
+}

package/dist/components/Editor/LengthBadge.d.ts

@@ -0,0 +1,6 @@
+type LengthBadgeProps = {
+    current: number;
+    maxLength: number;
+};
+declare const LengthBadge: React.FC<LengthBadgeProps>;
+export default LengthBadge;

package/dist/components/Editor/ToolbarPlugin/BaseButton/BaseButton.d.ts

@@ -21,7 +21,7 @@ interface ToolbarButtonProps {
      */
     active?: boolean;
     /**
-     * 大小
+     * 大小；未传时使用 toolbar theme.iconSize（默认 14）
      */
     size?: number;
 }

package/dist/components/Editor/ToolbarPlugin/ToolbarPlugin.d.ts

@@ -1,3 +1,7 @@
+import { EditorToolbarTheme } from '../interface';
 import { ToolbarButtonProps } from './interface.d';
-declare const Toolbar: React.FC<ToolbarButtonProps>;
+type ToolbarProps = ToolbarButtonProps & {
+    theme?: EditorToolbarTheme;
+};
+declare const Toolbar: React.FC<ToolbarProps>;
 export default Toolbar;

package/dist/components/Editor/ToolbarPlugin/context/EditorToolbarThemeContext.d.ts

@@ -0,0 +1,6 @@
+export declare const EditorToolbarThemeProvider: import('react').Provider<{
+    iconSize: number;
+}>;
+export declare const useEditorToolbarTheme: () => {
+    iconSize: number;
+};

package/dist/components/Editor/ToolbarPlugin/interface.d.ts

@@ -1,33 +1,31 @@
 import { ToolbarButtonName } from './Buttons';
-
-
-export interface ToolbarButtonProps {
-  /**
-   * @description 根据外部配置传入你想要渲染的 toolbar 按钮
-   * @description 如果数组为空，则会渲染默认的 toolbar 按钮
-   */
-  config?: Array<{
-    /**
-     * @description 分组的唯一标识
-     */
-    key: string;
-    /**
-     * @description 按钮组名称
-     * @description 自定义按钮名称需要通过 registerToolbarButton 先注册
-     */
-    buttons: Array<
-      | ToolbarButtonName
-      | {
-          name: ToolbarButtonName;
-          /**
-           * @description 各个 button 组件的 props
-           */
-          props?: Record<string, any>;
-        }
-    >;
-  }>;
-  /**
-   * @description 自定义样式
-   */
-  style?: React.CSSProperties;
-}
+export interface ToolbarButtonProps {
+  /**
+   * @description 根据外部配置传入你想要渲染的 toolbar 按钮
+   * @description 如果数组为空，则会渲染默认的 toolbar 按钮
+   */
+  config?: Array<{
+    /**
+     * @description 分组的唯一标识
+     */
+    key: string;
+    /**
+     * @description 按钮组名称
+     * @description 自定义按钮名称需要通过 registerToolbarButton 先注册
+     */
+    buttons: Array<
+      | ToolbarButtonName
+      | {
+          name: ToolbarButtonName;
+          /**
+           * @description 各个 button 组件的 props
+           */
+          props?: Record<string, any>;
+        }
+    >;
+  }>;
+  /**
+   * @description 自定义样式
+   */
+  style?: React.CSSProperties;
+}

package/dist/components/Editor/index.d.ts

@@ -1,5 +1,5 @@
 export { Editor as default } from './Editor';
-export type { EditorProps } from './interface';
+export type { EditorProps, EditorTheme, EditorToolbarTheme } from './interface';
 export { registerToolbarButton, unregisterToolbarButton, listRegisteredToolbarButtons, } from './ToolbarPlugin/Buttons';
 export type { ToolbarButtonName } from './ToolbarPlugin/Buttons';
 export { useLexicalComposerContext } from '@lexical/react/LexicalComposerContext';

package/dist/components/Editor/interface.d.ts

@@ -1,62 +1,120 @@
 import { EditorState } from 'lexical';
 import { ToolbarButtonProps } from './ToolbarPlugin/interface.d';
-
-
-export type EditorProps = {
-  /**
-   * 编辑器容器高度
-   */
-  height?: number;
-  /**
-   * 编辑器内容变化回调
-   */
-  onChange: (
-    { text, html }: { text: string; html: string | null },
-    editorState: EditorState
-  ) => void;
-
-  toolbar?: {
-    /**
-     * toolbar 配置
-     */
-    config?: ToolbarButtonProps['config'];
-
-    style?: React.CSSProperties;
-  };
-
-  /**
-   * 编辑器受控内容
-   */
-  value?: string | null;
-
-  /**
-   * @description 占位符文本
-   * @todo 待实现
-   */
-  placeholder?: string;
-
-  /**
-   * @description 是否自动聚焦，默认为 false
-   */
-  autoFocus?: boolean;
-  /**
-   * @description 是否禁用
-   * @todo 待实现
-   */
-  disabled?: boolean;
-  /**
-   * @description 错误处理回调
-   * @todo 待实现
-   */
-  onError?: (error: Error) => void;
-
-  /**
-   * @description 图片上传配置
-   * @todo 待实现
-   */
-  imageUpload?: {
-    maxSize?: number; // 最大文件大小
-    accept?: string[]; // 支持的文件类型
-    customUpload?: (file: File) => Promise<string>; // 自定义上传函数
-  };
-};
+/** Editor 工具栏 Design Token（挂在 theme.toolbar，避免与后续 content 等命名空间冲突） */
+export interface EditorToolbarTheme {
+  /** 工具栏背景 @default #fafafa */
+  bg?: string;
+  /** 工具栏底部分割线 @default #e0e0e0 */
+  borderColor?: string;
+  /** 工具栏内边距 @default 5px 6px */
+  padding?: string;
+  /**
+   * 工具栏容器 flex gap。
+   * 现状无 gap；未传时不写变量，保持与现状一致。
+   */
+  gap?: string | number;
+  /** 组内按钮间距 @default 6px */
+  groupGap?: string | number;
+  /** 组分隔线颜色 @default #e0e0e0 */
+  dividerColor?: string;
+  /** 组分隔线高度 @default 20px */
+  dividerSize?: string | number;
+  /** 组分隔线水平外边距 @default 5px */
+  dividerMargin?: string | number;
+  /** 按钮默认图标/文字色 @default #666 */
+  colorIcon?: string;
+  /** hover 背景 @default #e0e0e0 */
+  itemHoverBg?: string;
+  /** hover 前景 @default #121211 */
+  itemHoverColor?: string;
+  /** active 背景 @default #e0e0e0 */
+  itemActiveBg?: string;
+  /** active 前景 @default #121211 */
+  itemActiveColor?: string;
+  /** 按钮内边距 @default 3px */
+  itemPadding?: string | number;
+  /** 按钮圆角 @default 2px */
+  itemBorderRadius?: string | number;
+  /** 图标尺寸 @default 14 */
+  iconSize?: string | number;
+}
+
+export interface EditorTheme {
+  toolbar?: EditorToolbarTheme;
+}
+
+export type EditorProps = {
+  /**
+   * 编辑器容器高度
+   */
+  height?: number;
+  /**
+   * 编辑器内容变化回调
+   */
+  onChange: (
+    { text, html }: { text: string; html: string | null },
+    editorState: EditorState
+  ) => void;
+
+  /**
+   * 组件主题（与 Lexical 内部 content theme 无关）
+   */
+  theme?: EditorTheme;
+
+  toolbar?: {
+    /**
+     * toolbar 配置
+     */
+    config?: ToolbarButtonProps['config'];
+
+    style?: React.CSSProperties;
+  };
+
+  /**
+   * 编辑器受控内容
+   */
+  value?: string | null;
+
+  /**
+   * 最大字符数（与 onChange.text.length / getTextContent().length 一致）。
+   * 仅 `number && > 0` 时生效；未传或无效值不限制。
+   * 图片不计字数，链接只计可见文字。
+   */
+  maxLength?: number;
+
+  /**
+   * 发生超限（键入拦截 / 粘贴截断 / 回填截断）时触发
+   */
+  onMaxLengthExceed?: () => void;
+
+  /**
+   * @description 占位符文本
+   * @todo 待实现
+   */
+  placeholder?: string;
+
+  /**
+   * @description 是否自动聚焦，默认为 false
+   */
+  autoFocus?: boolean;
+  /**
+   * @description 是否禁用
+   * @todo 待实现
+   */
+  disabled?: boolean;
+  /**
+   * @description 错误处理回调
+   * @todo 待实现
+   */
+  onError?: (error: Error) => void;
+
+  /**
+   * @description 图片上传配置
+   * @todo 待实现
+   */
+  imageUpload?: {
+    maxSize?: number; // 最大文件大小
+    accept?: string[]; // 支持的文件类型
+    customUpload?: (file: File) => Promise<string>; // 自定义上传函数
+  };
+};

package/dist/components/Editor/plugins/MaxLengthPlugin.d.ts

@@ -0,0 +1,7 @@
+type MaxLengthPluginProps = {
+    maxLength: number;
+    onMaxLengthExceed?: () => void;
+};
+/** Lexical Playground–style hard limit; restore when already at cap, else trim. */
+export default function MaxLengthPlugin({ maxLength, onMaxLengthExceed, }: MaxLengthPluginProps): null;
+export {};

package/dist/components/Editor/utils/resolveEditorToolbarThemeVars.d.ts

@@ -0,0 +1,5 @@
+import { EditorToolbarTheme } from '../interface';
+/** 将 EditorToolbarTheme 映射为 CSS 变量（未传 token 不写入）。 */
+export declare const resolveEditorToolbarThemeVars: (theme?: EditorToolbarTheme) => Record<string, string>;
+/** 解析 iconSize 为数值，供 Icon size prop；默认 14（与 BaseButton 现状一致）。 */
+export declare const resolveEditorToolbarIconSize: (iconSize?: string | number) => number;

package/dist/components/Editor/utils/textLength.d.ts

@@ -0,0 +1,4 @@
+import { LexicalEditor } from 'lexical';
+export declare function isValidMaxLength(maxLength: unknown): maxLength is number;
+/** Trim from document end to `maxLength` (metric = getTextContentSize / onChange.text). */
+export declare function $truncateRootToMaxLength(editor: LexicalEditor, maxLength: number): boolean;