kc-plate-editor 0.3.3 → 0.3.5

package/dist/components/editor/standalone-toolbar.d.ts

@@ -8,9 +8,9 @@ import * as React from 'react';
 export interface StandaloneToolbarProps {
     /** 工具栏配置 */
     config: ToolbarConfig;
-    /** 编辑器实例（可选，如果不提供则创建一个内部实例） */
+    /** 编辑器实例（必需，用于共享编辑器状态和历史记录） */
     editor?: any;
-    /** 自定义插件列表（可选） */
+    /** 自定义插件列表（可选，仅在未提供 editor 时使用） */
     plugins?: EditorPluginKit;
     /** 是否显示工具栏，默认 true */
     showToolbar?: boolean;
@@ -31,22 +31,27 @@ export interface StandaloneToolbarProps {
  * 独立工具栏组件
  * 可以在编辑器组件外部独立使用，提供完整的工具栏功能
  *
+ * 重要：当与外部编辑器一起使用时，必须传入 editor 实例以共享历史记录和状态
+ *
  * @example
  * ```tsx
- * // 基础使用
- * <StandaloneToolbar config={FULL_TOOLBAR} />
+ * // 与编辑器实例关联（推荐用法）
+ * const editorRef = useRef<PlateEditorRef>(null);
+ * const [editor, setEditor] = useState<any>(null);
  *
- * // 自定义样式和对齐
- * <StandaloneToolbar
- *   config={BASIC_TOOLBAR}
- *   align="center"
- *   className="my-custom-toolbar"
- *   style={{ backgroundColor: '#f0f0f0' }}
+ * <StandaloneToolbar config={FULL_TOOLBAR} editor={editor} />
+ * <PlateEditor
+ *   ref={(ref) => {
+ *     editorRef.current = ref;
+ *     if (ref) {
+ *       setEditor(ref.getEditor());
+ *     }
+ *   }}
+ *   showToolbar={false}
  * />
  *
- * // 与编辑器实例关联
- * const editor = usePlateEditor({ plugins: EditorKit });
- * <StandaloneToolbar config={FULL_TOOLBAR} editor={editor} />
+ * // 独立使用（不推荐，历史记录不共享）
+ * <StandaloneToolbar config={FULL_TOOLBAR} />
  * ```
  */
 export declare const StandaloneToolbar: React.ForwardRefExoticComponent<StandaloneToolbarProps & React.RefAttributes<HTMLDivElement>>;

package/dist/components/editor/toolbars/configurable-toolbar.d.ts

@@ -5,6 +5,11 @@ export interface ConfigurableToolbarProps {
     config: ToolbarConfig;
     /** 是否显示工具栏，默认 true */
     showToolbar?: boolean;
+    /** 自定义工具栏按钮 */
+    customButtons?: {
+        before?: React.ReactNode;
+        after?: React.ReactNode;
+    };
 }
 /**
  * 可配置工具栏组件