@blueking/flow-canvas 0.0.1-beta.1

package/dist/plugins/clipboard.d.ts

@@ -0,0 +1,9 @@
+import type { CanvasPlugin } from '../types/plugin';
+/**
+ * FlowModel 级剪贴板插件。
+ *
+ * 不依赖 @antv/x6-plugin-clipboard，直接从 FlowModel 读取选中内容，
+ * 粘贴时生成新 ID 并通过 executeCommand 走完整命令管道。
+ * 这保证了粘贴操作与 undo/redo、插件 transformCommand 等机制一致。
+ */
+export declare function clipboardPlugin(): CanvasPlugin;

package/dist/plugins/connection-validator.d.ts

@@ -0,0 +1,3 @@
+import type { CanvasPlugin } from '../types/plugin';
+import type { ConnectionValidator } from '../types/api';
+export declare function connectionValidatorPlugin(validator: ConnectionValidator): CanvasPlugin;

package/dist/plugins/minimap.d.ts

@@ -0,0 +1,7 @@
+import type { CanvasPlugin } from '../types/plugin';
+export interface MinimapPluginOptions {
+    container?: HTMLElement;
+    width?: number;
+    height?: number;
+}
+export declare function minimapPlugin(options?: MinimapPluginOptions): CanvasPlugin;

package/dist/plugins/selection.d.ts

@@ -0,0 +1,7 @@
+import type { CanvasPlugin } from '../types/plugin';
+export interface SelectionPluginOptions {
+    rubberband?: boolean;
+    multiple?: boolean;
+    movable?: boolean;
+}
+export declare function selectionPlugin(options?: SelectionPluginOptions): CanvasPlugin;

package/dist/plugins/snapline.d.ts

@@ -0,0 +1,6 @@
+import type { CanvasPlugin } from '../types/plugin';
+export interface SnaplinePluginOptions {
+    tolerance?: number;
+    color?: string;
+}
+export declare function snaplinePlugin(options?: SnaplinePluginOptions): CanvasPlugin;

package/dist/runtime/canvas-api.d.ts

@@ -0,0 +1,25 @@
+import type { Graph } from '@antv/x6';
+import type { Ref } from 'vue';
+import type { CanvasApi } from '../types/api';
+import type { ContextMenuItem } from '../types/plugin';
+import type { FlowModel } from '../types/flow-model';
+import type { OverlayManager } from '../types/overlay';
+import type { CanvasSchema } from '../types/schema';
+import type { CommandEnvelope, CommandExecutionResult, ScreenPosition } from '../types/command';
+export interface NodeShapeInfo {
+    shapeName: string;
+    width: number;
+    height: number;
+}
+export interface CanvasApiOptions {
+    graph: Graph;
+    overlayManager: OverlayManager;
+    executeCommand: (envelope: CommandEnvelope) => CommandExecutionResult;
+    schema: CanvasSchema;
+    flowModel: Readonly<Ref<FlowModel>>;
+    defaultInsertGap?: number;
+    getContextMenuItems?: (position: ScreenPosition) => ContextMenuItem[];
+    onHighlightChange?: (nodeIds: string[], edgeIds: string[]) => void;
+    resolveNodeShape?: (nodeType: string) => NodeShapeInfo | null;
+}
+export declare function createCanvasApi({ graph, overlayManager, executeCommand, schema, flowModel, defaultInsertGap, getContextMenuItems: getContextMenuItemsFn, onHighlightChange, resolveNodeShape, }: CanvasApiOptions): CanvasApi;

package/dist/runtime/canvas-runtime-core.vue.d.ts

@@ -0,0 +1,36 @@
+import type { CanvasEditorContext } from '../core/editor';
+import type { CanvasUiEvent, ScreenPosition } from '../types/command';
+import type { FlowNodeModel } from '../types/flow-model';
+import type { CanvasApi, NodeActionsConfig, QuickAddConfig } from '../types/api';
+type __VLS_Props = {
+    editor: CanvasEditorContext;
+    graphOptions?: Record<string, unknown>;
+    nodeActions?: NodeActionsConfig;
+    quickAdd?: QuickAddConfig;
+};
+type __VLS_Slots = {
+    'node-overlay'?: (props: {
+        node: FlowNodeModel;
+        screenAnchors: Record<string, ScreenPosition>;
+        api: CanvasApi;
+    }) => unknown;
+    'quick-add-panel'?: (props: {
+        node: FlowNodeModel;
+        api: CanvasApi;
+        insertNodeToRight: (node: Omit<FlowNodeModel, 'position'>) => void;
+        closePopover: () => void;
+    }) => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "ui-event": (event: CanvasUiEvent) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUi-event"?: ((event: CanvasUiEvent) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/event-bridge.d.ts

@@ -0,0 +1,28 @@
+import type { Graph } from '@antv/x6';
+import type { FlowModel } from '../types/flow-model';
+import type { CanvasUiEvent, CommandEnvelope } from '../types/command';
+import type { Ref } from 'vue';
+type UiEventHandler = (event: CanvasUiEvent) => void;
+type CommandHandler = (envelope: CommandEnvelope) => void;
+/**
+ * X6 图交互事件 → CanvasUiEvent / CommandEnvelope 的桥接器。
+ *
+ * 事件分两类输出：
+ *  - onUiEvent：不修改 FlowModel 的交互事件（click、contextmenu、selection.change）
+ *  - onCommand：产生 FlowModel 变更的操作（node:moved → node.move、edge:connected → edge.add/reconnect）
+ *
+ * edge:connected 使用 X6 的 isNew 标志 + flowModelRef 双重判断区分新建连线和重连。
+ * edge:click 通过 DOM 层级查找 .x6-edge-label 来区分边体点击和标签点击。
+ */
+export declare class EventBridge {
+    private graph;
+    private onUiEvent;
+    private onCommand;
+    private flowModelRef;
+    private disposers;
+    constructor(graph: Graph, onUiEvent: UiEventHandler, onCommand: CommandHandler, flowModelRef: Readonly<Ref<FlowModel>>);
+    dispose(): void;
+    private bindEvents;
+    private on;
+}
+export {};

package/dist/runtime/graph-bridge.d.ts

@@ -0,0 +1,127 @@
+import { Graph } from '@antv/x6';
+import type { FlowModel, FlowNodeModel, FlowEdgeModel } from '../types/flow-model';
+import type { CanvasSchema, CanvasCallbackContext } from '../types/schema';
+import type { NodeDecoration, EdgeDecoration } from '../types/plugin';
+import { ShapeRegistry } from './shape-registry';
+export type NodeDecorationResolver = (node: FlowNodeModel) => NodeDecoration | undefined;
+export type EdgeDecorationResolver = (edge: FlowEdgeModel) => EdgeDecoration | undefined;
+export type CanvasContextResolver = () => CanvasCallbackContext | null;
+/**
+ * FlowModel → X6 Graph 的单向同步桥接器。
+ *
+ * 职责：将 FlowModel 的声明式状态增量同步到 X6 的命令式 API。
+ * knownNodeIds / knownEdgeIds 跟踪已渲染的元素，用于 diff：
+ *  - FlowModel 中有、图中无 → addNode/addEdge
+ *  - FlowModel 中有、图中有 → 更新 position/size/ports/source/target/labels
+ *  - FlowModel 中无、图中有 → removeCell
+ *
+ * syncing 标志用于让 EventBridge 忽略同步引起的 X6 事件，防止循环：
+ *  FlowModel 变更 → syncFlowModel → X6 事件 → executeCommand → FlowModel 变更 ...
+ */
+export declare class GraphBridge {
+    private graph;
+    private schema;
+    private shapeRegistry;
+    private resolveNodeDecoration?;
+    private resolveEdgeDecoration?;
+    private resolveCanvasContext?;
+    private knownNodeIds;
+    private knownEdgeIds;
+    private syncing;
+    private prevNodeDecorationClasses;
+    private prevNodeDecorationColors;
+    private prevEdgeDecorationClasses;
+    private prevEdgeDecorationColors;
+    private highlightedNodeIds;
+    private highlightedEdgeIds;
+    private hoveredEdgeId;
+    private defaultHighlightedNodeIds;
+    private defaultHighlightedEdgeIds;
+    private prevEdgeStyleIds;
+    /** x6CellConfig 中 attrs.body 的基线值，清理时恢复而非删除 */
+    private nodeDefaultAttrs;
+    /** x6EdgeConfig 中 attrs.line 的基线值，清理时恢复而非删除 */
+    private edgeDefaultAttrs;
+    private lastModel;
+    constructor(graph: Graph, schema: CanvasSchema, shapeRegistry: ShapeRegistry, resolveNodeDecoration?: NodeDecorationResolver, resolveEdgeDecoration?: EdgeDecorationResolver, resolveCanvasContext?: CanvasContextResolver);
+    syncFlowModel(flowModel: FlowModel): void;
+    get isSyncing(): boolean;
+    /**
+     * 从 x6CellConfig.attrs.body 中提取基线描边，用于管理层清理时恢复。
+     * 仅在节点首次创建时调用一次。
+     */
+    private saveNodeDefaultAttrs;
+    /**
+     * 从 x6EdgeConfig.attrs.line 中提取基线描边，用于管理层清理时恢复。
+     */
+    private saveEdgeDefaultAttrs;
+    /** 恢复节点 attr 到基线值；无基线时移除。 */
+    private restoreNodeAttr;
+    /** 恢复边 attr 到基线值；无基线时移除。 */
+    private restoreEdgeAttr;
+    /** 让正式边接管交互式预览边时，恢复 schema 定义的端点 marker。 */
+    private syncEdgeMarker;
+    dispose(): void;
+    private resolveNodes;
+    private resolveEdges;
+    private syncNodes;
+    private updateExistingNode;
+    private syncNodePorts;
+    private addNewNode;
+    /**
+     * 将 schema 定义的 getBehavior 映射到 X6 节点属性。
+     * NodeBehaviorConfig 的每个字段都映射到 X6 Cell 对应能力：
+     *  - draggable → 是否可拖拽移动
+     *  - selectable → 是否可被选中（注意：X6 Selection 插件也有全局控制）
+     *  - connectable → ports 的 magnet 属性，控制是否可从该节点发起连线
+     *  - showPorts → ports 的可见性
+     *  - deletable → 存入 cell data，由删除操作（插件/快捷键）自行读取判断
+     */
+    private applyNodeBehavior;
+    private syncEdges;
+    /**
+     * 增量更新已有边的 source/target/router/connector/labels。
+     * X6 Edge.getSource() 返回 { cell, port } 格式，与 FlowEdgeModel 的 { nodeId, portId } 不同，
+     * 需要用 (currentSource as any).cell 来比较。
+     */
+    private updateExistingEdge;
+    private syncEdgeLabels;
+    private addNewEdge;
+    /**
+     * 外部通知选区、高亮或 hover 变化时，重算所有边的视觉样式。
+     * 每条边走统一分层管道 applyEdgeStyleAndDecoration，
+     * 保证 defaultHighlight → schema style() → plugin decoration 的覆盖顺序。
+     */
+    refreshEdgeStyles(): void;
+    /**
+     * 重算所有节点的高亮 + 装饰视觉。
+     */
+    refreshNodeHighlights(): void;
+    /**
+     * 单节点的高亮 + 装饰统一管道。
+     * 所有路径（FlowModel 同步更新/新增节点/显式刷新高亮）必须走此方法。
+     *
+     * body/stroke 的分层优先级（低 → 高）：
+     *   1. 默认高亮 (#3a84ff) — 节点在 highlightedNodeIds 中时兜底
+     *   2. 插件装饰 (decorateNode().borderColor) — 始终覆盖高亮
+     *
+     * 最终值 = decorationColor ?? highlightColor ?? (清除)。
+     * 只在"曾经设过 → 现在无值"时执行 removeAttrByPath，避免误删 X6 原始样式。
+     */
+    private applyNodeHighlightAndDecoration;
+    setHoveredEdge(edgeId: string | null): void;
+    setHighlightedNodes(nodeIds: string[]): void;
+    setHighlightedEdges(edgeIds: string[]): void;
+    /**
+     * 单条边的 style + highlight + decoration 统一管道。
+     *
+     * line/stroke 的分层优先级（低 → 高）：
+     *   1. 默认高亮 (#3a84ff) — 无 style() 时的兜底
+     *   2. Schema style() — 接收完整 EdgeRenderState，完全控制视觉
+     *   3. 插件装饰 (decorateEdge().strokeColor) — 始终覆盖 style()
+     *
+     * strokeWidth / strokeDasharray 仅由 schema style() 控制，不受装饰影响。
+     * 最终值 = decorationStroke ?? styleStroke ?? defaultHighlightStroke ?? (清除)。
+     */
+    private applyEdgeStyleAndDecoration;
+}

package/dist/runtime/overlay-manager.d.ts

@@ -0,0 +1,4 @@
+import type { Graph } from '@antv/x6';
+import type { OverlayManager } from '../types/overlay';
+import type { CanvasSchema } from '../types/schema';
+export declare function createOverlayManager(graph: Graph, schema: CanvasSchema): OverlayManager;

package/dist/runtime/shape-registry.d.ts

@@ -0,0 +1,8 @@
+import type { Component } from 'vue';
+export declare class ShapeRegistry {
+    private instanceId;
+    private registeredShapes;
+    getShapeName(nodeType: string): string;
+    registerNodeType(nodeType: string, component: Component): string;
+    dispose(): void;
+}

package/dist/runtime/use-edge-delete-tool.d.ts

@@ -0,0 +1,11 @@
+import type { Graph } from '@antv/x6';
+/**
+ * 管理边上的 SVG 删除按钮：跟随鼠标贴附在边路径上，
+ * 靠近端点时自动隐藏，点击时由外部处理删除命令。
+ */
+export declare function useEdgeDeleteTool(graph: Graph): {
+    show: (edgeId: string, e: MouseEvent) => void;
+    move: (e: MouseEvent) => void;
+    remove: () => void;
+    handleEdgeRemoved: (edgeId: string) => void;
+};

package/dist/runtime/use-node-hover.d.ts

@@ -0,0 +1,8 @@
+export declare function useNodeHover(): {
+    hoveredNodeId: import("vue").Ref<string | null, string | null>;
+    isDraggingNode: import("vue").Ref<boolean, boolean>;
+    enter: (nodeId: string) => void;
+    leave: () => void;
+    cancelLeave: () => void;
+    cleanup: () => void;
+};

package/dist/runtime/use-port-visibility.d.ts

@@ -0,0 +1,15 @@
+import type { Graph, Node, Edge } from '@antv/x6';
+/**
+ * 管理画布端口可见性：
+ * - 默认隐藏，hover 节点时显示该节点的端口
+ * - 拖拽连线时显示所有节点端口，连线完成后恢复隐藏
+ * - 连线完成后 300ms 内抑制边删除工具显示（避免 flash）
+ */
+export declare function usePortVisibility(graph: Graph): {
+    showNodePorts: (node: Node) => void;
+    hideNodePorts: (node: Node) => void;
+    handleEdgeAdded: (edge: Edge) => void;
+    handleEdgeConnected: () => void;
+    handleEdgeRemoved: (edgeId: string) => void;
+    canShowEdgeTool: () => boolean;
+};

package/dist/shell/canvas-layout.vue.d.ts

@@ -0,0 +1,35 @@
+import type { CanvasEditorContext } from '../core/editor';
+import type { NodePaletteItem } from '../types/api';
+type __VLS_Props = {
+    sidebarCollapsed?: boolean;
+    sidebarWidth?: number;
+    hideSidebar?: boolean;
+    hideFooter?: boolean;
+    editor?: CanvasEditorContext;
+    paletteItems?: NodePaletteItem[];
+};
+type __VLS_Slots = {
+    sidebar?: () => unknown;
+    default?: () => unknown;
+    footer?: () => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:sidebarCollapsed": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:sidebarCollapsed"?: ((value: boolean) => any) | undefined;
+}>, {
+    editor: CanvasEditorContext;
+    sidebarCollapsed: boolean;
+    sidebarWidth: number;
+    hideSidebar: boolean;
+    hideFooter: boolean;
+    paletteItems: NodePaletteItem[];
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/shell/canvas-node-palette.vue.d.ts

@@ -0,0 +1,10 @@
+import type { CanvasEditorContext } from '../core/editor';
+import type { NodePaletteItem } from '../types/api';
+import '../assets/iconcool/style.css';
+type __VLS_Props = {
+    editor: CanvasEditorContext;
+    items?: NodePaletteItem[];
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/shell/canvas-toolbar.vue.d.ts

@@ -0,0 +1,11 @@
+import type { CanvasToolbarItem, BuiltinToolbarType } from '../types/api';
+import type { CanvasEditorContext } from '../core/editor';
+import '../assets/iconcool/style.css';
+type __VLS_Props = {
+    items?: CanvasToolbarItem[];
+    exclude?: BuiltinToolbarType[];
+    editor: CanvasEditorContext;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/shell/default-node.vue.d.ts

@@ -0,0 +1,4 @@
+import '../assets/iconcool/style.css';
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/shell/default-schema.d.ts

@@ -0,0 +1,39 @@
+import type { CanvasSchema, CanvasEdgeDefinition } from '../types/schema';
+import type { NodePaletteItem } from '../types/api';
+export interface DefaultNodeTypeConfig {
+    label?: string;
+    icon?: string;
+    width?: number;
+    height?: number;
+}
+export interface DefaultSchemaOptions {
+    nodeTypes?: Record<string, DefaultNodeTypeConfig>;
+    /** 默认连线类型，内置 'manhattan' | 'bezier'，也可指向自定义类型 key */
+    defaultEdgeType?: string;
+    /** 额外/覆盖的边类型定义，会与内置类型合并 */
+    edgeTypes?: Record<string, CanvasEdgeDefinition>;
+}
+export interface DefaultSchemaResult {
+    schema: CanvasSchema;
+    paletteItems: NodePaletteItem[];
+}
+/**
+ * 创建内置的默认 Schema，提供开箱即用的节点与边类型。
+ *
+ * 节点类型使用 DefaultNode 组件渲染，自带上/右/下/左四个连接端口。
+ * 不传参数时提供 7 种节点类型和 2 种内置边类型（manhattan / bezier）。
+ *
+ * @example
+ * // 默认 manhattan 直角连线
+ * const { schema, paletteItems } = createDefaultSchema();
+ *
+ * // 切换为贝塞尔曲线连线
+ * const { schema, paletteItems } = createDefaultSchema({ defaultEdgeType: 'bezier' });
+ *
+ * // 自定义边类型
+ * const { schema, paletteItems } = createDefaultSchema({
+ *   defaultEdgeType: 'myEdge',
+ *   edgeTypes: { myEdge: { connector: 'normal', style: ... } },
+ * });
+ */
+export declare function createDefaultSchema(options?: DefaultSchemaOptions): DefaultSchemaResult;

package/dist/shell/node-actions-toolbar.vue.d.ts

@@ -0,0 +1,18 @@
+import type { FlowNodeModel } from '../types/flow-model';
+import type { ScreenPosition } from '../types/command';
+import type { NodeActionsConfig } from '../types/api';
+import type { NodeBehaviorConfig } from '../types/schema';
+import '../assets/iconcool/style.css';
+type __VLS_Props = {
+    node: FlowNodeModel;
+    position: ScreenPosition;
+    config: Required<NodeActionsConfig>;
+    behavior: NodeBehaviorConfig;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    action: (type: "delete" | "copy" | "copy-insert" | "disconnect" | "debug", nodeId: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onAction?: ((type: "delete" | "copy" | "copy-insert" | "disconnect" | "debug", nodeId: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/shell/node-quick-add-popover.vue.d.ts

@@ -0,0 +1,36 @@
+import type { FlowNodeModel } from '../types/flow-model';
+import type { ScreenPosition } from '../types/command';
+import '../assets/iconcool/style.css';
+type __VLS_Props = {
+    node: FlowNodeModel;
+    portPosition: ScreenPosition;
+    tooltipText?: string;
+};
+declare function closePopover(): void;
+declare var __VLS_7: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_7) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
+    closePopover: typeof closePopover;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    close: () => any;
+    mouseenter: () => any;
+    mouseleave: () => any;
+    open: (nodeId: string) => any;
+    "start-drag": (nodeId: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: (() => any) | undefined;
+    onMouseenter?: (() => any) | undefined;
+    onMouseleave?: (() => any) | undefined;
+    onOpen?: ((nodeId: string) => any) | undefined;
+    "onStart-drag"?: ((nodeId: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/shell/toolbar-items.d.ts

@@ -0,0 +1,13 @@
+import type { CanvasToolbarItem, BuiltinToolbarType } from '../types/api';
+export interface DefaultToolbarItemsOptions {
+    /** 要排除的操作项类型（仅对可隐藏的组生效，zoom 和 reset 组固定不可排除） */
+    exclude?: BuiltinToolbarType[];
+}
+/**
+ * 工具栏默认项分为四组（从左到右）：
+ *  1. history: 撤销、重做 — 可隐藏
+ *  2. tools:   框选、自动排版、搜索、缩略图、下载 — 可隐藏
+ *  3. zoom:    缩小、放大 — 固定
+ *  4. reset:   重置 — 固定
+ */
+export declare function createDefaultToolbarItems(options?: DefaultToolbarItemsOptions): CanvasToolbarItem[];