@baishuyun/ui-base 6.12.0 → 6.13.1

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

@@ -3,6 +3,10 @@ interface MenuItemProps {
     item: MenuItemType;
     onClick: (item: MenuItemType) => void;
     isActive?: boolean;
+    isSubmenuOpen?: boolean;
+    onSubmenuOpen?: () => void;
+    onSubmenuLeave?: () => void;
+    activeKey?: string[];
 }
 declare const MenuItem: React.FC<MenuItemProps>;
 export { MenuItem };

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

@@ -36,6 +36,10 @@ export interface MenuItemType {
    * @default false
    */
   disabled?: boolean;
+  /**
+   * 子菜单项。存在非空数组时该行作为分组：悬停或点击从右侧飞出，不触发 onClick
+   */
+  children?: MenuItemType[];
 
   /**
    * 是否是系统字段
@@ -144,7 +148,7 @@ export interface DropDownProps {
    */
   offset?: OffsetType;
   /**
-   * 自定义下拉菜单的样式
+   * 每一级菜单面板的样式（根面板与子菜单）
    */
   style?: React.CSSProperties;
 

package/dist/components/Editor/Preview/EditorPreview.d.ts

@@ -0,0 +1,9 @@
+import { EditorAiStatus } from '../interface';
+/** loading 时把 LCS 预览合到下一帧；ready/error 立刻算，避免应用按钮闪一下。 */
+export declare function usePolishProposedHtml(enabled: boolean, originalHtml: string, text: string, status: EditorAiStatus | undefined): string;
+type EditorPreviewProps = {
+    maxLength?: number;
+    onMaxLengthExceed?: () => void;
+};
+declare const EditorPreview: React.FC<EditorPreviewProps>;
+export default EditorPreview;

package/dist/components/Editor/Preview/HtmlPreview.d.ts

@@ -0,0 +1,5 @@
+type HtmlPreviewProps = {
+    html: string;
+};
+declare const HtmlPreview: React.FC<HtmlPreviewProps>;
+export default HtmlPreview;

package/dist/components/Editor/Preview/PolishModal.d.ts

@@ -0,0 +1,14 @@
+import { EditorAiPreset, EditorAiStatus } from '../interface';
+type PolishModalProps = {
+    status: EditorAiStatus;
+    reasoning?: string;
+    errorMessage?: string;
+    originalHtml: string;
+    proposedHtml: string;
+    preset: EditorAiPreset;
+    onPresetChange: (preset: EditorAiPreset) => void;
+    onCancel: () => void;
+    onApply: () => boolean;
+};
+declare const PolishModal: React.FC<PolishModalProps>;
+export default PolishModal;

package/dist/components/Editor/Preview/Thinking.d.ts

@@ -0,0 +1,23 @@
+import { EditorAiStatus } from '../interface';
+type ThinkingModel = {
+    visible: boolean;
+    thinking: boolean;
+    open: boolean;
+    label: string;
+    reasoning: string;
+    toggle: () => void;
+    onViewportScroll: () => void;
+};
+export declare function useThinking(source: {
+    status: EditorAiStatus;
+    reasoning?: string;
+}, hasAnswer: boolean, scrollViewportRef?: {
+    readonly current: HTMLElement | null;
+}): ThinkingModel;
+export declare const ThinkingHead: React.FC<{
+    model: ThinkingModel;
+}>;
+export declare const ThinkingBody: React.FC<{
+    model: ThinkingModel;
+}>;
+export {};

package/dist/components/Editor/Preview/TypesetModal.d.ts

@@ -0,0 +1,12 @@
+import { EditorAiStatus } from '../interface';
+type TypesetModalProps = {
+    status: EditorAiStatus;
+    reasoning?: string;
+    errorMessage?: string;
+    originalHtml: string;
+    proposedHtml: string;
+    onCancel: () => void;
+    onApply: () => boolean;
+};
+declare const TypesetModal: React.FC<TypesetModalProps>;
+export default TypesetModal;

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

@@ -21,7 +21,11 @@ interface ToolbarButtonProps {
      */
     active?: boolean;
     /**
-     * 大小；未传时使用 toolbar theme.iconSize（默认 14）
+     * 强调色（如「更多」展开）；只改图标色，不加灰底
+     */
+    highlight?: boolean;
+    /**
+     * 大小；未传时使用 toolbar theme.iconSize（跟 size 档位，default 为 16）
      */
     size?: number;
 }

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

@@ -0,0 +1,3 @@
+import { RegisteredToolbarButtonProps } from './registry';
+declare const AiButton: React.FC<RegisteredToolbarButtonProps>;
+export default AiButton;

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

@@ -1,2 +1,3 @@
-declare const AlignButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const AlignButton: React.FC<RegisteredToolbarButtonProps>;
 export default AlignButton;

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

@@ -1,2 +1,3 @@
-declare const BoldButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const BoldButton: React.FC<RegisteredToolbarButtonProps>;
 export default BoldButton;

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

@@ -1,2 +1,3 @@
-declare const BulletListButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const BulletListButton: React.FC<RegisteredToolbarButtonProps>;
 export default BulletListButton;

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

@@ -0,0 +1,3 @@
+import { RegisteredToolbarButtonProps } from './registry';
+declare const ClearFormatButton: React.FC<RegisteredToolbarButtonProps>;
+export default ClearFormatButton;

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

@@ -1,2 +1,3 @@
-declare const CodeButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const CodeButton: React.FC<RegisteredToolbarButtonProps>;
 export default CodeButton;

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

@@ -1,2 +1,3 @@
-declare const BackgroundColorButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const BackgroundColorButton: React.FC<RegisteredToolbarButtonProps>;
 export default BackgroundColorButton;

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

@@ -1,2 +1,3 @@
-declare const FontColorButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const FontColorButton: React.FC<RegisteredToolbarButtonProps>;
 export default FontColorButton;

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

@@ -1,2 +1,3 @@
-declare const FontSizeButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const FontSizeButton: React.FC<RegisteredToolbarButtonProps>;
 export default FontSizeButton;

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

@@ -1,2 +1,3 @@
-declare const HeadingButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const HeadingButton: React.FC<RegisteredToolbarButtonProps>;
 export default HeadingButton;

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

@@ -1,2 +1,3 @@
-declare const IndentButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const IndentButton: React.FC<RegisteredToolbarButtonProps>;
 export default IndentButton;

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

@@ -1,2 +1,3 @@
-declare const ItalicButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const ItalicButton: React.FC<RegisteredToolbarButtonProps>;
 export default ItalicButton;

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

@@ -1,2 +1,3 @@
-declare const LinkButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const LinkButton: React.FC<RegisteredToolbarButtonProps>;
 export default LinkButton;

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

@@ -1,2 +1,3 @@
-declare const NumberListButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const NumberListButton: React.FC<RegisteredToolbarButtonProps>;
 export default NumberListButton;

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

@@ -1,2 +1,3 @@
-declare const OutdentButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const OutdentButton: React.FC<RegisteredToolbarButtonProps>;
 export default OutdentButton;

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

@@ -1,2 +1,3 @@
-declare const PictureButton: React.FC;
+import { RegisteredToolbarButtonProps } from '../registry';
+declare const PictureButton: React.FC<RegisteredToolbarButtonProps>;
 export default PictureButton;

package/dist/components/Editor/ToolbarPlugin/Buttons/PictureButton/UploadImage.d.ts

@@ -1,6 +1,7 @@
 export interface UploadImageItem {
     src: string;
     fileName: string;
+    attachment?: unknown;
 }
 export interface UploadImageRef {
     getValue: () => Promise<UploadImageItem[]>;

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

@@ -1,2 +1,3 @@
-declare const RedoButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const RedoButton: React.FC<RegisteredToolbarButtonProps>;
 export default RedoButton;

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

@@ -1,2 +1,3 @@
-declare const SourceButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const SourceButton: React.FC<RegisteredToolbarButtonProps>;
 export default SourceButton;

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

@@ -1,2 +1,3 @@
-declare const StrikeThroughButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const StrikeThroughButton: React.FC<RegisteredToolbarButtonProps>;
 export default StrikeThroughButton;

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

@@ -1,2 +1,3 @@
-declare const SubscriptButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const SubscriptButton: React.FC<RegisteredToolbarButtonProps>;
 export default SubscriptButton;

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

@@ -1,2 +1,3 @@
-declare const SuperscriptButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const SuperscriptButton: React.FC<RegisteredToolbarButtonProps>;
 export default SuperscriptButton;

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

@@ -1,2 +1,3 @@
-declare const TableButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const TableButton: React.FC<RegisteredToolbarButtonProps>;
 export default TableButton;

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

@@ -1,2 +1,3 @@
-declare const UnLinkButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const UnLinkButton: React.FC<RegisteredToolbarButtonProps>;
 export default UnLinkButton;

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

@@ -1,2 +1,3 @@
-declare const UnderLineButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const UnderLineButton: React.FC<RegisteredToolbarButtonProps>;
 export default UnderLineButton;

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

@@ -1,2 +1,3 @@
-declare const UndoButton: React.FC;
+import { RegisteredToolbarButtonProps } from './registry';
+declare const UndoButton: React.FC<RegisteredToolbarButtonProps>;
 export default UndoButton;

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

@@ -1,30 +1,33 @@
 import { getToolbarButton, listRegisteredToolbarButtons, registerToolbarButton, unregisterToolbarButton } from './registry';
 declare const builtinButtons: {
-    undo: import('react').FC<{}>;
-    redo: import('react').FC<{}>;
-    bold: import('react').FC<{}>;
-    underline: import('react').FC<{}>;
-    italic: import('react').FC<{}>;
-    strikethrough: import('react').FC<{}>;
-    superscript: import('react').FC<{}>;
-    subscript: import('react').FC<{}>;
-    heading: import('react').FC<{}>;
-    fontSize: import('react').FC<{}>;
-    fontColor: import('react').FC<{}>;
-    fill: import('react').FC<{}>;
-    bullet: import('react').FC<{}>;
-    number: import('react').FC<{}>;
-    outdent: import('react').FC<{}>;
-    indent: import('react').FC<{}>;
-    align: import('react').FC<{}>;
-    link: import('react').FC<{}>;
-    unLink: import('react').FC<{}>;
-    picture: import('react').FC<{}>;
-    code: import('react').FC<{}>;
-    table: import('react').FC<{}>;
-    source: import('react').FC<{}>;
+    undo: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    redo: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    bold: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    underline: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    italic: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    strikethrough: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    superscript: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    subscript: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    heading: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    fontSize: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    fontColor: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    fill: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    clearFormat: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    bullet: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    number: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    outdent: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    indent: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    align: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    link: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    unLink: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    picture: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    code: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    table: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    source: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
+    ai: import('react').FC<import('./registry').RegisteredToolbarButtonProps>;
 };
 export type BuiltinButtonName = keyof typeof builtinButtons;
 export type ToolbarButtonName = BuiltinButtonName | (string & {});
 export { registerToolbarButton, unregisterToolbarButton, getToolbarButton, listRegisteredToolbarButtons, };
+export type { RegisteredToolbarButtonProps } from './registry';
 export default builtinButtons;

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

@@ -1,5 +1,8 @@
 import { ComponentType } from 'react';
-export type ToolbarButtonComponent = ComponentType<any>;
+export type RegisteredToolbarButtonProps = {
+    disabled?: boolean;
+};
+export type ToolbarButtonComponent = ComponentType<RegisteredToolbarButtonProps & Record<string, any>>;
 export declare const registerToolbarButton: (name: string, component: ToolbarButtonComponent) => void;
 export declare const unregisterToolbarButton: (name: string) => void;
 export declare const getToolbarButton: (name: string) => ToolbarButtonComponent | undefined;

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

@@ -16,6 +16,7 @@ export type TextFormatsState = {
     isInTable: boolean;
     headingTag: 'h1' | 'h2' | 'h3' | false;
     codeLanguage: CodeLanguageId;
+    hasEditorText: boolean;
     link?: {
         link?: string;
         linkText?: string;

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

@@ -18,9 +18,9 @@ export interface ToolbarButtonProps {
       | {
           name: ToolbarButtonName;
           /**
-           * @description 各个 button 组件的 props
+           * 传给按钮的 props。内置按钮目前只认 `disabled`，与内部禁用或运算。
            */
-          props?: Record<string, any>;
+          props?: { disabled?: boolean } & Record<string, any>;
         }
     >;
   }>;

package/dist/components/Editor/constants/ai.d.ts

@@ -0,0 +1,12 @@
+import { EditorAiPreset } from '../interface';
+export declare const EDITOR_AI_CODE_PLACEHOLDER: (index: number) => string;
+export declare const EDITOR_AI_CODE_PLACEHOLDER_RE: RegExp;
+export declare const EDITOR_AI_PRESETS: EditorAiPreset[];
+export declare const EDITOR_AI_PRESET_I18N: {
+    readonly quick: "editor.aiPresetQuick";
+    readonly formal: "editor.aiPresetFormal";
+    readonly colloquial: "editor.aiPresetColloquial";
+    readonly lively: "editor.aiPresetLively";
+    readonly literary: "editor.aiPresetLiterary";
+    readonly retro: "editor.aiPresetRetro";
+};

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

@@ -38,7 +38,10 @@ export declare const FONT_SIZES: readonly [{
 export declare const DEFAULT_FONT_SIZE = "16px";
 export declare const DEFAULT_FONT_COLOR = "#000";
 export declare const DEFAULT_BACKGROUND_COLOR = "transparent";
+/** 与业务 BsyImageUpload 一致，不开放外部 maxSize / accept */
 export declare const IMAGE_MAX_BYTES: number;
 export declare const IMAGE_MAX_COUNT = 10;
+export declare const EDITOR_IMAGE_FILE_TYPES: readonly ["jpg", "jpeg", "png", "gif", "bmp", "tif"];
+export declare const EDITOR_IMAGE_ACCEPT: string;
 export declare const TABLE_GRID_SIZE = 10;
 export type FontSize = (typeof FONT_SIZES)[number]['value'];

package/dist/components/Editor/constants/portableEditorStyles.d.ts

@@ -0,0 +1,11 @@
+/** 与 theme.scss 编辑态可见皮肤对齐；导出 HTML 写成 inline。不含 hover / ::marker。 */
+export declare const PORTABLE_HEADING_STYLES: Record<string, Record<string, string>>;
+export declare const PORTABLE_LINK_STYLES: Record<string, string>;
+export declare const PORTABLE_LIST_BASE_STYLES: Record<string, string>;
+export declare const PORTABLE_UL_MARKERS: readonly ["disc", "circle", "square"];
+export declare const PORTABLE_LI_STYLES: Record<string, string>;
+export declare const PORTABLE_NESTED_LI_STYLES: Record<string, string>;
+export declare const PORTABLE_CODE_STYLES: Record<string, string>;
+export declare const PORTABLE_TABLE_STYLES: Record<string, string>;
+export declare const PORTABLE_CELL_STYLES: Record<string, string>;
+export declare const PORTABLE_HEADER_CELL_STYLES: Record<string, string>;

package/dist/components/Editor/constants/toolbarSize.d.ts

@@ -0,0 +1,12 @@
+import { EditorToolbarSize } from '../interface';
+export declare const DEFAULT_EDITOR_TOOLBAR_SIZE: EditorToolbarSize;
+/** 工具栏按钮打开的浮层相对触发器下移 */
+export declare const EDITOR_TOOLBAR_POPOVER_OFFSET: {
+    readonly x: 0;
+    readonly y: 5;
+};
+/** itemHeight 同时是按钮高度和最小宽度。 */
+export declare const EDITOR_TOOLBAR_SIZE_PRESETS: Record<EditorToolbarSize, {
+    itemHeight: number;
+    iconSize: number;
+}>;

package/dist/components/Editor/context/EditorContainerContext.d.ts

@@ -1,8 +1,34 @@
-import { RefObject } from 'react';
+import { Dispatch, MutableRefObject, RefObject, SetStateAction } from 'react';
+import { EditorAi, EditorAiMode, EditorAiPreset, EditorAiStatus, EditorUpload } from '../interface';
+export type EditorAiSession = {
+    originalHtml: string;
+    originalText?: string;
+    codeBlocks?: string[];
+    preset?: EditorAiPreset;
+};
 interface EditorContainerContextType {
     containerRef: RefObject<HTMLDivElement | null>;
     toolbarRef: RefObject<HTMLDivElement>;
+    upload?: EditorUpload;
+    aiOpen: EditorAiMode | null;
+    setAiOpen: Dispatch<SetStateAction<EditorAiMode | null>>;
+    aiSessionRef: MutableRefObject<EditorAiSession | null>;
+    attachmentsBySrcRef: MutableRefObject<Map<string, unknown>>;
+    typeset?: EditorAi['typeset'];
+    polish?: EditorAi['polish'];
+    stop?: EditorAi['stop'];
+    canTypeset: boolean;
+    canPolish: boolean;
 }
+export type EditorAiStream = {
+    text: string;
+    reasoning?: string;
+    status?: EditorAiStatus;
+    errorMessage?: string;
+};
 declare const EditorContainerContext: import('react').Context<EditorContainerContextType | null>;
+declare const EditorAiStreamContext: import('react').Context<EditorAiStream>;
 export declare const useEditorContainer: () => EditorContainerContextType;
+export declare const useEditorAiStream: () => EditorAiStream;
+export { EditorAiStreamContext };
 export default EditorContainerContext;

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

@@ -1,7 +1,7 @@
 export { Editor as default } from './Editor';
-export type { EditorProps, EditorTheme, EditorToolbarFloating, EditorToolbarMode, EditorToolbarOffset, EditorToolbarPlacement, EditorToolbarProps, EditorToolbarTheme, } from './interface';
+export type { EditorUpload, EditorUploadContext, EditorUploadResult, EditorAi, EditorAiMode, EditorAiPreset, EditorAiStatus, EditorProps, EditorTheme, EditorToolbarFloating, EditorToolbarMode, EditorToolbarOffset, EditorToolbarPlacement, EditorToolbarProps, EditorToolbarSize, EditorToolbarTheme, } from './interface';
 export { registerToolbarButton, unregisterToolbarButton, listRegisteredToolbarButtons, } from './ToolbarPlugin/Buttons';
-export type { ToolbarButtonName } from './ToolbarPlugin/Buttons';
+export type { ToolbarButtonName, RegisteredToolbarButtonProps } from './ToolbarPlugin/Buttons';
 export { useLexicalComposerContext } from '@lexical/react/LexicalComposerContext';
 export { $getRoot } from 'lexical';
 export { default as BaseButton } from './ToolbarPlugin/BaseButton/BaseButton';

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

@@ -6,7 +6,7 @@ export interface EditorToolbarTheme {
   bg?: string;
   /** 工具栏底部分割线 @default #e0e0e0 */
   borderColor?: string;
-  /** 工具栏内边距 @default 5px 6px */
+  /** 工具栏内边距 @default 4px 6px */
   padding?: string;
   /**
    * 工具栏容器 flex gap。
@@ -15,10 +15,8 @@ export interface EditorToolbarTheme {
   gap?: string | number;
   /** 组内按钮间距 @default 6px */
   groupGap?: string | number;
-  /** 组分隔线颜色 @default #e0e0e0 */
+  /** 组分隔线颜色；高度固定 14px @default #e0e0e0 */
   dividerColor?: string;
-  /** 组分隔线高度 @default 20px */
-  dividerSize?: string | number;
   /** 组分隔线水平外边距 @default 5px */
   dividerMargin?: string | number;
   /** 按钮默认图标/文字色 @default #666 */
@@ -31,11 +29,15 @@ export interface EditorToolbarTheme {
   itemActiveBg?: string;
   /** active 前景 @default #121211 */
   itemActiveColor?: string;
+  /** 「更多」展开等强调色 @default #0265ff */
+  itemHighlightColor?: string;
   /** 按钮内边距 @default 3px */
   itemPadding?: string | number;
   /** 按钮圆角 @default 2px */
   itemBorderRadius?: string | number;
-  /** 图标尺寸 @default 14 */
+  /** 按钮高度与最小宽度；未传时跟 toolbar.size 档位 */
+  itemHeight?: string | number;
+  /** 图标字号，不含按钮内文字；未传时跟 toolbar.size 档位 */
   iconSize?: string | number;
 }
 
@@ -43,6 +45,8 @@ export interface EditorTheme {
   toolbar?: EditorToolbarTheme;
 }
 
+export type EditorToolbarSize = 'small' | 'default';
+
 export type EditorToolbarMode = 'embedded' | 'floating';
 
 export type EditorToolbarPlacement = 'top' | 'bottom';
@@ -61,6 +65,11 @@ export interface EditorToolbarFloating {
 
 export interface EditorToolbarProps {
   config?: ToolbarButtonProps['config'];
+  /**
+   * 按钮档位。`small` 为 20×20（图标 14），`default` 为 30×30（图标 16）；按钮内文字固定 14。
+   * @default 'default'
+   */
+  size?: EditorToolbarSize;
   /** 覆盖工具栏视觉样式；floating 下 `left`/`top` 等定位字段会被忽略，`width` 可覆盖默认宽度（自定义后靠左） */
   style?: React.CSSProperties;
   /** @default 'embedded' */
@@ -84,7 +93,7 @@ export type EditorProps = {
    * 编辑器内容变化回调
    */
   onChange: (
-    { text, html }: { text: string; html: string | null },
+    { text, html, attachment }: { text: string; html: string | null; attachment: unknown[] },
     editorState: EditorState
   ) => void;
 
@@ -134,12 +143,50 @@ export type EditorProps = {
   onError?: (error: Error) => void;
 
   /**
-   * @description 图片上传配置
-   * @todo 待实现
+   * 上传配置。未传 `customRequest` 时，弹窗选图仍写入 data URL。
    */
-  imageUpload?: {
-    maxSize?: number; // 最大文件大小
-    accept?: string[]; // 支持的文件类型
-    customUpload?: (file: File) => Promise<string>; // 自定义上传函数
-  };
+  upload?: EditorUpload;
+
+  /**
+   * AI 排版 / 润色。未传 `typeset` / `polish` 时对应菜单项禁用。
+   * 预览由组件自管；业务绑定流式 `text` / `reasoning` / `status`。
+   */
+  ai?: EditorAi;
+};
+
+export type EditorAiPreset = 'quick' | 'formal' | 'colloquial' | 'lively' | 'literary' | 'retro';
+
+export type EditorAiMode = 'typeset' | 'polish';
+
+export type EditorAiStatus = 'idle' | 'loading' | 'ready' | 'error';
+
+export type EditorAi = {
+  /** 点「智能排版」；`html` 已抽掉代码块为占位注释 */
+  typeset?: (input: { text: string; html: string }) => void;
+  /** 点润色预设；弹窗内切换预设会再调一次。`text` 为按块分隔的可润色纯文本（不含代码块） */
+  polish?: (input: { text: string; preset: EditorAiPreset }) => void;
+  /** 放弃或应用后中止请求 */
+  stop?: () => void;
+  /** 流式正文：排版为 HTML，润色为纯文本 */
+  text?: string;
+  /** 可选思维链 */
+  reasoning?: string;
+  status?: EditorAiStatus;
+  errorMessage?: string;
+};
+
+export type EditorUploadContext = {
+  onProgress?: (percent: number) => void;
+  signal?: AbortSignal;
+};
+
+export type EditorUploadResult = {
+  url: string;
+  /** 厂商原始文件对象（如接口 `data.file`），原样回传到 onChange.attachment */
+  attachment?: unknown;
+};
+
+export type EditorUpload = {
+  /** 业务上传：成功返回 URL，或 `{ url, attachment }` 以便 onChange 带回原始文件对象 */
+  customRequest?: (file: File, ctx: EditorUploadContext) => Promise<string | EditorUploadResult>;
 };

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

@@ -0,0 +1,8 @@
+import { LexicalEditor } from 'lexical';
+export declare const POLISH_BLOCK_MARKER = "<!--bsy-block-->";
+export declare function joinPolishBlocks(blocks: string[]): string;
+export declare function hasPolishContent(text: string): boolean;
+export declare function collectPolishHtmlBlocks(html: string): string[];
+/** 只改块内文字，不重建标签。 */
+export declare function applyAiPolishToHtml(html: string, proposed: string): string;
+export declare function applyAiPolish(editor: LexicalEditor, proposed: string): boolean;

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

@@ -0,0 +1,5 @@
+import { LexicalEditor } from 'lexical';
+export declare function applyAiTypeset(editor: LexicalEditor, proposedHtml: string, codeBlocks: string[], maxLength?: number): {
+    applied: boolean;
+    truncated: boolean;
+};

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

@@ -0,0 +1 @@
+export declare function $clearInlineTextFormat(): void;