@mx-sose-front/mx-sose-graph 1.2.7 → 1.2.8

package/dist/src/utils/containers.d.ts

@@ -0,0 +1,119 @@
+import { Shape } from '../types';
+
+/** 统一的几何矩形类型 */
+export type Rect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/** 更新回调签名（ */
+export type Updater = (id: string, updates: Partial<Shape>) => void;
+/** 读取内边距（padding）。支持 style.padding 为数字；默认 20 */
+export declare const readPadding: (s?: Shape) => {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+};
+/** 获取父容器的“内容区”（内边距之后的可放置区域） */
+export declare const getContentRect: (parent: Shape) => {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+};
+/** 判断 childId 是否是 ancestorId 的后代 */
+export declare const isDescendant: (shapes: Shape[], childId: string, ancestorId: string) => boolean;
+/** 收集整棵子树(仅 id) */
+export declare const collectDescendantIds: (shapes: Shape[], parentId: string) => string[];
+/** 计算 child 与 region 的相交面积（region 是一个 {left,top,right,bottom}） */
+export declare const intersectArea: (child: Rect, region: {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}) => number;
+/** 计算子矩形在父“内容区”内的覆盖率（0~1） */
+export declare const coverageIn: (child: Rect, parent: Shape) => number;
+/** 把 child 夹回 parent 的内容区（不改变尺寸） */
+export declare const clampChildIntoParent: (parent: Shape, child: Rect, alignLarge?: 'center' | 'start' | 'end') => Rect;
+/**
+ * 让 parent “刚好包下所有直接子 + padding”
+ * - 仅增大，不缩小；必要时向左/上扩张（同时移动 x/y）
+ * - 采用 floor-ε 抑制抖动：避免 0.x 的毛刺每次都向上取整导致“慢慢变大”
+ */
+export declare const ensureParentFitsChildren: (shapes: Shape[], parent: Shape, updateShape: Updater, overrideRects?: Record<string, Rect>) => void;
+/** 从当前父开始，逐层向上做 ensureParentFitsChildren */
+export declare const bubbleAutoFitUp: (shapes: Shape[], startParentId: string | null | undefined, updateShape: Updater) => void;
+/**
+ * 挂接：把 child 挂到 parent 下，同时把“整棵子树的 zIndex”平移为 parent.z + 1（相对层级不变）
+ * - 注意：这里只负责数据层，不做归一化（normalizeZOrder 建议在调用方统一执行）
+ */
+export declare const attachToParent: (shapes: Shape[], childId: string, parentId: string, updateShape: Updater) => void;
+/** 脱离父子关系（仅清 parenShapeId） */
+export declare const detachFromParent: (shapes: Shape[], childId: string, updateShape: Updater) => void;
+/**
+ * （旧）自某节点起，强制“子 = 父+1”
+ */
+export declare const cascadeZIndexFrom: (shapes: Shape[], startId: string, updateShape: Updater) => void;
+/** 计算“直接子元素”的联合包围盒 */
+export declare const childrenUnionBounds: (shapes: Shape[], parentId: string, overrideRects?: Record<string, Rect>) => {
+    L: number;
+    T: number;
+    R: number;
+    B: number;
+} | null;
+/**
+ * 在“缩放父元素”手势中，约束 next：content(next) 覆盖 childrenUnion ± gap
+ * - dir 决定修正哪条边：左/上需要改 x/y 和宽高；右/下只改宽高
+ */
+export declare const clampParentRectToChildrenGap: (shapes: Shape[], parent: Shape, next: Rect, dir: 'nw' | 'ne' | 'sw' | 'se', gap?: number, minW?: number, minH?: number, overrideRects?: Record<string, Rect>) => Rect;
+/**
+ * 直接把 parent 扩到“刚好 ≥ 子并集 + gap”（对称扩容）
+ * - 注意：这是“立即扩父”的版本，通常用于非交互状态下的矫正或强制收口
+ */
+export declare const ensureParentCoversChildrenWithGap: (shapes: Shape[], parent: Shape, updateShape: Updater, gap?: number, overrideRects?: Record<string, Rect>) => void;
+/** 从当前父起，逐层把所有祖先都扩到“刚好 ≥ 子并集 + gap” */
+export declare const bubbleCoverWithGapUp: (shapes: Shape[], startParentId: string | null | undefined, updateShape: Updater, gap?: number) => void;
+/** 轻微越界容忍（px） */
+export declare const CONTENT_EPS = 3;
+/** 计算“最终矩形”（ghost 优先，兜底实体 bounds） */
+export declare const finalRectOf: (ghost: Record<string, Rect>, s: Shape) => Rect;
+/** 计算 childRect 相对 parent 内容区的“最大越界量”（>0 表示越界） */
+export declare const overflowIn: (parent: Shape, childRect: Rect) => number;
+/** 轻微越界 → 夹回；显著越界 → 扩父（并向上冒泡） */
+export declare const clampOrGrowIntoParent: (parent: Shape, childRect: Rect, shapes: Shape[], updateShape: Updater, childId: string, eps?: number) => void;
+/** 组拖辅助：该节点是否有“正在拖动”的祖先（有则禁止 reparent） */
+export declare const hasDraggedAncestor: (shapes: Shape[], sid: string, draggingSet: Set<string>) => boolean;
+/** 哪些图元一旦挂上父，就不允许脱离父（拖动时只能让父扩容） */
+export declare const isStickyChild: (s: Shape) => boolean;
+export declare const resolveParentAfterDrag: (shapes: Shape[], s: Shape, finalRect: Rect, draggingIds: string[], diagramId: string | null | undefined, updateShape: (id: string, updates: Partial<Shape>) => void, _minCoverage?: number, hoverCandidateId?: string | null, options?: {
+    /** 当发生“换父（嵌套）”时，是否只更新父子关系与位置，不立刻扩父，留给外部在接口成功后再扩父 */
+    deferExpandOnReparent?: boolean;
+}) => boolean;
+/**
+ * 只返回“视觉上最上面”的命中容器：
+ * - 命中条件：指针在 shape.bounds 内（不强制内容区）
+ * - 先找候选里 zIndex 的最大值，只在这个 z 层里挑一个
+ * - 同 z 打平：更深（层级大）> 内容区更小 > id 稳定
+ */
+export declare const pickContainerByPointerTopmost: (shapes: Shape[], pointer: {
+    x: number;
+    y: number;
+}, draggingId: string, diagramId: string, excludeIds?: string[], boundsMargin?: number) => Shape | null;
+export declare function hitContainerAtPoint(shapes: Shape[], pointer: {
+    x: number;
+    y: number;
+}, diagramId: string, excludeIds?: string[]): Shape | null;
+/**
+ * 根据某个子元素的最终矩形，自动扩容父元素，并在必要时把子元素夹回父元素内部。
+ * 注意：
+ *  - 这个方法可以在拖拽逻辑之外单独调用（比如：后端嵌套接口成功后，再调用它来扩父）
+ *  - 仅依赖当前 shapes + parent + childRect，不改变父子关系
+ */
+export declare const expandParentToFitChildBounds: (shapes: Shape[], parent: Shape, childId: string, childRect: Rect, updateShape: (id: string, updates: Partial<Shape>) => void) => {
+    expanded: boolean;
+    affectedIds: string[];
+};
+//# sourceMappingURL=containers.d.ts.map

package/dist/src/utils/containers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"containers.d.ts","sourceRoot":"","sources":["../../../src/utils/containers.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/contextMenuUtils.d.ts

@@ -0,0 +1,108 @@
+import { Ref } from 'vue';
+
+export declare class ContextMenuUtils {
+    private static copiedShapes;
+    private static operationType;
+    /**
+     * 处理右键菜单点击事件
+     * @param event 鼠标事件
+     * @param layerRef 图层引用
+     * @param pickTarget 命中测试函数
+     * @param shapes 图元列表
+     * @param selectShape 选中图元函数
+     * @param isDragging 是否正在拖拽
+     * @param isResizing 是否正在缩放
+     * @returns 命中的图元（如果有）
+     */
+    static handleContextMenuClick(event: MouseEvent, layerRef: Ref<HTMLElement | null>, pickTarget: (shapes: any[], point: {
+        x: number;
+        y: number;
+    }) => {
+        kind: string;
+        shape?: any;
+    }, shapes: any[], selectShape?: (shape: any) => void, isDragging?: boolean, isResizing?: boolean, scale?: number): any | null;
+    /**
+     * 将鼠标事件坐标转换为本地坐标
+     * 注意：需要考虑画布的缩放比例
+     */
+    static toLocalPoint(event: MouseEvent, layerRef: HTMLElement | null, scale?: number): {
+        x: number;
+        y: number;
+    };
+    /**
+     * 检查点击是否在菜单外部
+     */
+    static isClickOutsideMenu(event: MouseEvent, menuSelector?: string): boolean;
+    /**
+     * 计算菜单位置（避免超出屏幕边界）
+     */
+    static calculateMenuPosition(x: number, y: number, menuWidth?: number, menuHeight?: number, safeMargin?: number): {
+        x: number;
+        y: number;
+    };
+    /**
+     * 处理删除操作
+     */
+    static handleDelete(target: any): void;
+    /**
+     * 处理属性配置  (暂时不用)
+     */
+    static handleShowPropertyPanel(target: any): void;
+    /**
+     * 处理树上高亮
+     */
+    static handleHighlight(target: any): void;
+    /**
+     * 处理所在图表
+     */
+    static handleLocateChart(target: any): void;
+    /**
+     * 设置复制的图元
+     */
+    static setCopiedShapes(shapes: any[]): void;
+    /**
+     * 获取复制的图元
+     */
+    static getCopiedShapes(): any[];
+    /**
+     * 检查剪贴板是否有内容
+     */
+    static hasClipboardContent(): boolean;
+    /**
+     * 清空剪贴板（粘贴完成后调用）
+     */
+    static clearClipboard(): void;
+    /**
+     * 清除剪切状态（只清除SVG遮盖层，不清除剪贴板数据）
+     * 当点击空白处时调用
+     */
+    static clearCutState(): void;
+    /**
+     * 完全清除剪切状态和剪贴板数据
+     * 当需要完全重置时调用（如按ESC取消操作）
+     */
+    static clearAll(): void;
+    /**
+     * 收集图元及其所有子图元的 ID
+     * @param shapes 要收集的图元数组
+     * @returns 所有图元 ID 的数组（包括子图元）
+     */
+    private static collectShapeAndChildrenIds;
+    /**
+     * 处理复制
+     */
+    static handleCopy(targets: any[]): void;
+    /**
+     * 处理粘贴
+     */
+    static handlePaste(_target?: any): void;
+    /**
+     * 处理剪切
+     */
+    static handleCut(targets: any[]): void;
+    /**
+     * 记录日志
+     */
+    static logSelectedShape(target: any): void;
+}
+//# sourceMappingURL=contextMenuUtils.d.ts.map

package/dist/src/utils/contextMenuUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextMenuUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/contextMenuUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAM/B,qBAAa,gBAAgB;IAE3B,OAAO,CAAC,MAAM,CAAC,YAAY,CAAa;IAExC,OAAO,CAAC,MAAM,CAAC,aAAa,CAA0B;IAEtD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,sBAAsB,CAC3B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,EACjC,UAAU,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE,EAC7F,MAAM,EAAE,GAAG,EAAE,EACb,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,EAClC,UAAU,CAAC,EAAE,OAAO,EACpB,UAAU,CAAC,EAAE,OAAO,EACpB,KAAK,GAAE,MAAU,GAChB,GAAG,GAAG,IAAI;IAyBb;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,GAAE,MAAU,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IAajH;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,GAAE,MAAwB,GAAG,OAAO;IAK7F;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAC1B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,SAAS,GAAE,MAAY,EACvB,UAAU,GAAE,MAAY,EACxB,UAAU,GAAE,MAAW,GACtB;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IAsB3B;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG;IAM/B;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,MAAM,EAAE,GAAG;IAM1C;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,GAAG;IAMlC;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,GAAG;IAMpC;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE;IAKpC;;OAEG;IACH,MAAM,CAAC,eAAe,IAAI,GAAG,EAAE;IAI/B;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,OAAO;IAIrC;;OAEG;IACH,MAAM,CAAC,cAAc;IAUrB;;;OAGG;IACH,MAAM,CAAC,aAAa;IASpB;;;OAGG;IACH,MAAM,CAAC,QAAQ;IAaf;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAkBzC;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE;IAgBhC;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,GAAG;IAyBhC;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE;IAiB/B;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG;CAGpC"}

package/dist/src/utils/dateUtils.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 日期工具类
+ * 提供统一的日期解析、格式化和计算功能
+ */
+export declare class DateUtils {
+    /**
+     * 解析日期字符串为 Date 对象
+     * @param dateStr - 日期字符串，支持 ISO 格式（带 T 或空格）
+     * @returns Date 对象，解析失败返回 null
+     * @example
+     * DateUtils.parse('2024-03-05T14:30:25') // Date 对象
+     * DateUtils.parse('2024-03-05 14:30:25') // Date 对象
+     * DateUtils.parse('invalid') // null
+     */
+    static parse(dateStr: string | null | undefined): Date | null;
+    /**
+     * 获取日期的时间戳
+     * @param dateStr - 日期字符串
+     * @returns 时间戳（毫秒），解析失败返回 null
+     * @example
+     * DateUtils.getTimestamp('2024-03-05T14:30:25') // 1709641825000
+     */
+    static getTimestamp(dateStr: string | null | undefined): number | null;
+    /**
+     * 格式化日期为字符串
+     * @param dateStr - 日期字符串或 Date 对象
+     * @param format - 格式类型：'date' 只显示日期，'datetime' 显示日期和时间
+     * @returns 格式化后的字符串，解析失败返回原字符串
+     * @example
+     * DateUtils.format('2024-03-05T14:30:25', 'date') // '2024-03-05'
+     * DateUtils.format('2024-03-05T14:30:25', 'datetime') // '2024-03-05 14:30:25'
+     */
+    static format(dateStr: string | Date | null | undefined, format?: 'date' | 'datetime'): string;
+    /**
+     * 格式化日期为中文格式
+     * @param dateStr - 日期字符串
+     * @returns 中文格式的日期字符串
+     * @example
+     * DateUtils.formatChinese('2024-03-05') // '2024年3月5日'
+     */
+    static formatChinese(dateStr: string | null | undefined): string;
+    /**
+     * 数字补零（小于 10 的数字前面补 0）
+     * @param value - 数字
+     * @returns 补零后的字符串
+     * @example
+     * DateUtils.pad(5) // '05'
+     * DateUtils.pad(12) // '12'
+     */
+    static pad(value: number): string;
+    /**
+     * 检查日期字符串是否有效
+     * @param dateStr - 日期字符串
+     * @returns 是否有效
+     * @example
+     * DateUtils.isValid('2024-03-05') // true
+     * DateUtils.isValid('invalid') // false
+     */
+    static isValid(dateStr: string | null | undefined): boolean;
+    /**
+     * 比较两个日期的大小
+     * @param date1 - 日期1
+     * @param date2 - 日期2
+     * @returns date1 < date2 返回 -1，date1 > date2 返回 1，相等返回 0，任一无效返回 null
+     */
+    static compare(date1: string | null | undefined, date2: string | null | undefined): number | null;
+    /**
+     * 获取日期范围（最小和最大日期）
+     * @param dates - 日期字符串数组
+     * @returns { min: Date | null, max: Date | null }
+     */
+    static getRange(dates: (string | null | undefined)[]): {
+        min: Date | null;
+        max: Date | null;
+    };
+}
+//# sourceMappingURL=dateUtils.d.ts.map

package/dist/src/utils/dateUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/dateUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,SAAS;IACpB;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI;IAW7D;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI;IAKtE;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CACX,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,EACzC,MAAM,GAAE,MAAM,GAAG,UAAuB,GACvC,MAAM;IAqBT;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM;IAShE;;;;;;;OAOG;IACH,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIjC;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO;IAI3D;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CACZ,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,MAAM,GAAG,IAAI;IAchB;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAAG;QACrD,GAAG,EAAE,IAAI,GAAG,IAAI,CAAA;QAChB,GAAG,EAAE,IAAI,GAAG,IAAI,CAAA;KACjB;CAkBF"}

package/dist/src/utils/diagram.d.ts

@@ -0,0 +1,289 @@
+import { Shape } from '../types';
+
+export type HandlePos = "nw" | "ne" | "sw" | "se";
+export declare const HANDLE_SIZE = 10;
+export declare const SELECTION_PADDING = 6;
+export declare const ShapeConfig: {
+    SHAPE_TYPE: string;
+    CANVAS_PADDING: number;
+    MIN_CANVAS_WIDTH: number;
+    MIN_CANVAS_HEIGHT: number;
+};
+export declare const selectionBoxStyle: (shape: Shape) => {
+    position: "absolute";
+    left: string;
+    top: string;
+    width: string;
+    height: string;
+    backgroundColor: string;
+};
+/**
+ * 计算手柄样式 —— 以 selection-box 内部为参照系
+ * 默认让红点“贴在 shape 四角”（即离选框边内缩 padding，且点心落在角上）
+ */
+export declare const handleStyle: (pos: HandlePos, shape: Shape) => {
+    position: "absolute";
+    width: string;
+    height: string;
+    backgroundColor: string;
+    border: string;
+    borderRadius: string;
+    cursor: string;
+    pointerEvents: "auto";
+    left: string;
+    top: string;
+};
+/**
+ * 获取画布形状
+ */
+export declare const getCanvasShape: () => {
+    id: string;
+    diagramId: string;
+    parenShapeId: string;
+    shapeKey: string;
+    shapeType: "shape" | "edge" | "pin" | "diagram" | "gantt" | "table" | "matrix";
+    bounds: {
+        x?: number | undefined;
+        y?: number | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    };
+    style?: {
+        fontSize?: number | undefined;
+        fontFamily?: string | undefined;
+        fontWeight?: string | undefined;
+        color?: string | undefined;
+        backgroundColor?: string | undefined;
+        borderColor?: string | undefined;
+        borderWidth?: number | undefined;
+        borderRadius?: number | undefined;
+        padding?: number | {
+            top: number;
+            right: number;
+            bottom: number;
+            left: number;
+        } | undefined;
+        margin?: number | undefined;
+        zIndex?: number | undefined;
+        canvasBorderWidth?: number | undefined;
+        canvasBorderColor?: string | undefined;
+        canvasBorderStyle?: "dashed" | "solid" | "dotted" | undefined;
+        canvasNameFontSize?: number | undefined;
+        canvasNameFontFamily?: string | undefined;
+        canvasNameFontColor?: string | undefined;
+        gradientLeftColor?: string | undefined;
+        gradientRightColor?: string | undefined;
+        textAnchor?: string | undefined;
+        dominantBaseline?: string | undefined;
+    } | undefined;
+    keywords: string;
+    keywordsBounds?: {
+        x?: number | undefined;
+        y?: number | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    } | undefined;
+    keywordsStyle?: {
+        fontSize?: number | undefined;
+        fontFamily?: string | undefined;
+        fontWeight?: string | undefined;
+        color?: string | undefined;
+        backgroundColor?: string | undefined;
+        borderColor?: string | undefined;
+        borderWidth?: number | undefined;
+        borderRadius?: number | undefined;
+        padding?: number | {
+            top: number;
+            right: number;
+            bottom: number;
+            left: number;
+        } | undefined;
+        margin?: number | undefined;
+        zIndex?: number | undefined;
+        canvasBorderWidth?: number | undefined;
+        canvasBorderColor?: string | undefined;
+        canvasBorderStyle?: "dashed" | "solid" | "dotted" | undefined;
+        canvasNameFontSize?: number | undefined;
+        canvasNameFontFamily?: string | undefined;
+        canvasNameFontColor?: string | undefined;
+        gradientLeftColor?: string | undefined;
+        gradientRightColor?: string | undefined;
+        textAnchor?: string | undefined;
+        dominantBaseline?: string | undefined;
+    } | undefined;
+    icon?: string | undefined;
+    modelId: string;
+    modelName: string;
+    names: string;
+    name: string;
+    nameBounds?: {
+        x?: number | undefined;
+        y?: number | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    } | undefined;
+    nameStyle?: {
+        fontSize?: number | undefined;
+        fontFamily?: string | undefined;
+        fontWeight?: string | undefined;
+        color?: string | undefined;
+        backgroundColor?: string | undefined;
+        borderColor?: string | undefined;
+        borderWidth?: number | undefined;
+        borderRadius?: number | undefined;
+        padding?: number | {
+            top: number;
+            right: number;
+            bottom: number;
+            left: number;
+        } | undefined;
+        margin?: number | undefined;
+        zIndex?: number | undefined;
+        canvasBorderWidth?: number | undefined;
+        canvasBorderColor?: string | undefined;
+        canvasBorderStyle?: "dashed" | "solid" | "dotted" | undefined;
+        canvasNameFontSize?: number | undefined;
+        canvasNameFontFamily?: string | undefined;
+        canvasNameFontColor?: string | undefined;
+        gradientLeftColor?: string | undefined;
+        gradientRightColor?: string | undefined;
+        textAnchor?: string | undefined;
+        dominantBaseline?: string | undefined;
+    } | undefined;
+    direction?: string | undefined;
+    sourceId?: string | undefined;
+    targetId?: string | undefined;
+    waypointId?: string | undefined;
+    waypoints?: {
+        x: number;
+        y: number;
+    }[] | undefined;
+    showKeywords: boolean;
+    showIcon: boolean;
+    showName: boolean;
+    showTaggedValues: boolean;
+    showComparents: boolean;
+    taggedValueLabels?: {
+        id: string;
+        modelId: string;
+        modelName: string;
+        names: string;
+        name: string;
+        nameBounds?: string | undefined;
+        nameStyle?: string | undefined;
+    }[] | undefined;
+    comparents?: {
+        bounds: {
+            x?: number | undefined;
+            y?: number | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        };
+        modelId: string;
+        modelName: string;
+        comparentShapes: any[];
+    }[] | undefined;
+    meta?: any;
+    scenarioMenus?: {
+        [x: string]: any;
+        code: string;
+        name: string;
+        icon: string;
+        sourceModels: string[];
+        targetCreateModel: string;
+        targetModels: string[];
+    }[] | undefined;
+    inert?: boolean | undefined;
+    isCut?: boolean | undefined;
+    sourceModels?: string[] | undefined;
+    targetModels?: string[] | undefined;
+    modelTypePropertyId: string;
+    targetCreateModel?: string | undefined;
+    sourceModelId?: string | undefined;
+    isMovableComparents: boolean;
+    ganttData?: {
+        [x: string]: any;
+        id: string;
+        modelId: string;
+        ganttOrTableModelId: string;
+        projectId: string;
+        type: string;
+        sort: string;
+    }[] | undefined;
+    attributeColumns?: {
+        id?: number | undefined;
+        propertyId?: number | undefined;
+        projectId?: string | undefined;
+        modelId?: string | undefined;
+        configId: string;
+        name: string;
+        isShow: boolean;
+        isReadonly: boolean;
+    }[] | undefined;
+    ganttContainsModels?: {
+        projectId: string;
+        ownerId: string;
+        type: string;
+        name: string;
+        isChart: boolean;
+        icon: string;
+    }[] | undefined;
+} | undefined;
+/**
+ * 计算所有子图元的边界范围
+ * */
+export declare const calculateShapesBounds: () => {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+} | null;
+/**
+ * 调整画布大小
+ * */
+export declare const adjustCanvasToFitAllShapes: () => void;
+/**
+ * 计算操作按钮的位置样式
+ */
+export declare const actionButtonsStyle: (shape: Shape) => Record<string, string>;
+/**
+ * 名称虚线框容器样式 - 确保在父组件内水平居中
+ */
+export declare const nameTextBoxContainerStyle: (id: string) => Record<string, string>;
+/**
+ * 名称虚线框样式 - 自适应父容器宽度
+ */
+export declare const nameTextBoxStyle: (shape: Shape) => Record<string, string>;
+/**
+ * Pin 名称编辑输入框样式（放大，随字体自适应），非 Pin 返回空由 CSS 控制
+ */
+export declare const nameInputStyle: (shape: Shape) => Record<string, string>;
+/**
+ * 名称编辑容器样式 - 确保在父组件内水平居中
+ */
+export declare const nameEditorContainerStyle: (shape: Shape) => Record<string, string>;
+/**
+ * 计算文本所需最小宽度 - 应用于所有图形类型
+ */
+export declare const calculateTextMinWidth: (shape: Shape) => number;
+/**
+ * 框选矩形的样式
+ */
+export declare const getMarqueeStyle: (r: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}) => Record<string, string>;
+/**
+ * 计算交互层的定位样式
+ * @param diagramBounds 画布边界
+ * @returns CSS样式对象
+ */
+export declare const getLayerStyle: (diagramBounds: {
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+} | undefined) => Record<string, string>;
+//# sourceMappingURL=diagram.d.ts.map

package/dist/src/utils/diagram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram.d.ts","sourceRoot":"","sources":["../../../src/utils/diagram.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAElD,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAGnC,eAAO,MAAM,WAAW;;;;;CAKvB,CAAC;AAGF,eAAO,MAAM,iBAAiB,UAAW,KAAK;;;;;;;CAW7C,CAAC;AAUF;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAS,SAAS,SAAS,KAAK;;;;;;;;;;;CA8CvD,CAAC;AAQF;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAG1B,CAAC;AAEF;;KAEK;AACL,eAAO,MAAM,qBAAqB;;;;;QA4BjC,CAAC;AAEF;;KAEK;AACL,eAAO,MAAM,0BAA0B,YAgDtC,CAAC;AA6BF;;GAEG;AACH,eAAO,MAAM,kBAAkB,UAAW,KAAK,KAAG,OAAO,MAAM,EAAE,MAAM,CA4BtE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,OAAQ,MAAM,KAAG,OAAO,MAAM,EAAE,MAAM,CAmF3E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,UAAW,KAAK,KAAG,OAAO,MAAM,EAAE,MAAM,CAWpE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,UAAW,KAAK,KAAG,OAAO,MAAM,EAAE,MAAM,CAelE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,UAAW,KAAK,KAAG,OAAO,MAAM,EAAE,MAAM,CA4D5E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,UAAW,KAAK,KAAG,MAoBpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,MAAO;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KAAG,OAAO,MAAM,EAAE,MAAM,CAShH,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,aAAa,kBAAmB;IAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,KAAG,OAAO,MAAM,EAAE,MAAM,CAa3I,CAAC"}

package/dist/src/utils/dom.d.ts

@@ -0,0 +1,2 @@
+export declare const withDrag: (onMove: (e: MouseEvent) => void, onUp: (e: MouseEvent) => void) => () => void;
+//# sourceMappingURL=dom.d.ts.map

package/dist/src/utils/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../../src/utils/dom.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,QAAQ,eACP,UAAU,KAAK,IAAI,YACnB,UAAU,KAAK,IAAI,eAgBhC,CAAA"}