vkedit 4.0.0 → 4.0.2

package/dist/{index.es-Dswe047Z.js → index.es-BsTzN-5u.js}

@@ -1,4 +1,4 @@
-import { c as Da, _ as Va, g as il } from "./index-CSKpw1uX.js";
+import { c as Da, _ as Va, g as il } from "./index-BlZP6Kl3.js";
 var fn = {}, cn = {}, cr, vn;
 function Q() {
   if (vn) return cr;

package/dist/plugins/barcode/PropertyPanel.vue.d.ts

@@ -1,6 +1,6 @@
 import { EditorHost } from '../../core';
 import { BarcodeElement } from './barcode';
-interface Props {
+export interface Props {
     host: EditorHost;
     element: BarcodeElement;
     selection: BarcodeElement[];

package/dist/plugins/barcode/Shape.vue.d.ts

@@ -1,8 +1,6 @@
+import { ShapeProps } from '../../types/shape-props';
 import { BarcodeElement } from './barcode';
-import { EditorHost } from '../../core';
-export interface Props {
-    host: EditorHost;
-    element: BarcodeElement;
+export interface Props extends ShapeProps<BarcodeElement> {
 }
 declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/plugins/barcode/barcode.d.ts

@@ -1,4 +1,4 @@
-import { GraphicPlugin, PropertyPanelRegistration } from '../../types/graphic-plugin';
+import { GraphicPlugin } from '../../types/graphic-plugin';
 import { BaseGraphicElement, BaseGraphicElementOptions } from '../../types/base-graphic-element';
 import { EditorHost } from '../../core';
 export interface BarcodeOptions extends BaseGraphicElementOptions {
@@ -69,7 +69,5 @@ export declare class BarcodePlugin extends GraphicPlugin<BarcodeElement> {
     shapeComponent: import('vue').DefineComponent<import('./Shape.vue').Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('./Shape.vue').Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
     iconComponent: import('vue').Component;
     typeDisplayName: string;
-    propertyPanels: PropertyPanelRegistration[];
-    protected onInstall(): void;
-    protected onUninstall(): void;
+    propertyPanel: import('vue').DefineComponent<import('./PropertyPanel.vue').Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('./PropertyPanel.vue').Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 }

package/dist/plugins/line/PropertyPanel.vue.d.ts

@@ -1,6 +1,6 @@
 import { EditorHost } from '../../core';
 import { LineElement } from './line';
-interface Props {
+export interface Props {
     host: EditorHost;
     element: LineElement;
     selection: LineElement[];

package/dist/plugins/line/Shape.vue.d.ts

@@ -1,6 +1,6 @@
+import { ShapeProps } from '../../types/shape-props';
 import { LineElement } from './line';
-export interface Props {
-    element: LineElement;
+export interface Props extends ShapeProps<LineElement> {
 }
 declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/plugins/line/line.d.ts

@@ -1,4 +1,4 @@
-import { GraphicPlugin, PropertyPanelRegistration } from '../../types/graphic-plugin';
+import { GraphicPlugin } from '../../types/graphic-plugin';
 import { BaseGraphicElement, BaseGraphicElementOptions } from '../../types/base-graphic-element';
 import { EditorHost } from '../../core';
 export interface LineOptions extends BaseGraphicElementOptions {
@@ -9,12 +9,11 @@ export interface LineOptions extends BaseGraphicElementOptions {
 export declare class LineElement extends BaseGraphicElement {
     type: string;
     stroke: string;
+    private static readonly MIN_HIT_SCREEN_PX;
     constructor(host: EditorHost, options?: Partial<LineOptions>);
-    get config(): {
-        points: number[];
-        stroke: string;
-        strokeWidth: number;
-        hitStrokeWidth: number;
+    get hitHeight(): number;
+    get groupConfig(): {
+        [key: string]: any;
         id: string;
         x: number;
         y: number;
@@ -26,6 +25,20 @@ export declare class LineElement extends BaseGraphicElement {
         visible: boolean;
         draggable: boolean;
     };
+    get visibleRectConfig(): {
+        width: number;
+        height: number;
+        fill: string;
+        x: number;
+        y: number;
+    };
+    get hitRectConfig(): {
+        width: number;
+        height: number;
+        x: number;
+        y: number;
+        fill: string;
+    };
     deserialize(data: any): void;
     serialize(): {
         stroke: string;
@@ -54,7 +67,5 @@ export declare class LinePlugin extends GraphicPlugin<LineElement> {
     shapeComponent: import('vue').DefineComponent<import('./Shape.vue').Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('./Shape.vue').Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
     iconComponent: import('vue').Component;
     typeDisplayName: string;
-    propertyPanels: PropertyPanelRegistration[];
-    protected onInstall(): void;
-    protected onUninstall(): void;
+    propertyPanel: import('vue').DefineComponent<import('./PropertyPanel.vue').Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('./PropertyPanel.vue').Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 }

package/dist/plugins/qrcode/PropertyPanel.vue.d.ts

@@ -1,6 +1,6 @@
 import { EditorHost } from '../../core';
 import { QrcodeElement } from './qrcode';
-interface Props {
+export interface Props {
     host: EditorHost;
     element: QrcodeElement;
     selection: QrcodeElement[];

package/dist/plugins/qrcode/Shape.vue.d.ts

@@ -1,8 +1,6 @@
+import { ShapeProps } from '../../types/shape-props';
 import { QrcodeElement } from './qrcode';
-import { EditorHost } from '../../core';
-export interface Props {
-    host: EditorHost;
-    element: QrcodeElement;
+export interface Props extends ShapeProps<QrcodeElement> {
 }
 declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/plugins/qrcode/qrcode.d.ts

@@ -1,4 +1,4 @@
-import { GraphicPlugin, PropertyPanelRegistration } from '../../types/graphic-plugin';
+import { GraphicPlugin } from '../../types/graphic-plugin';
 import { BaseGraphicElement, BaseGraphicElementOptions } from '../../types/base-graphic-element';
 import { EditorHost } from '../../core';
 export interface QrcodeOptions extends BaseGraphicElementOptions {
@@ -68,7 +68,5 @@ export declare class QrcodePlugin extends GraphicPlugin<QrcodeElement> {
     shapeComponent: import('vue').DefineComponent<import('./Shape.vue').Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('./Shape.vue').Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
     iconComponent: import('vue').Component;
     typeDisplayName: string;
-    propertyPanels: PropertyPanelRegistration[];
-    protected onInstall(): void;
-    protected onUninstall(): void;
+    propertyPanel: import('vue').DefineComponent<import('./PropertyPanel.vue').Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('./PropertyPanel.vue').Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 }

package/dist/plugins/rect/PropertyPanel.vue.d.ts

@@ -1,6 +1,6 @@
 import { EditorHost } from '../../core';
 import { RectElement } from './rect';
-interface Props {
+export interface Props {
     host: EditorHost;
     element: RectElement;
     selection: RectElement[];

package/dist/plugins/rect/Shape.vue.d.ts

@@ -1,6 +1,6 @@
+import { ShapeProps } from '../../types/shape-props';
 import { RectElement } from './rect';
-export interface Props {
-    element: RectElement;
+export interface Props extends ShapeProps<RectElement> {
 }
 declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/plugins/rect/rect.d.ts

@@ -1,6 +1,6 @@
 import { BaseGraphicElement, BaseGraphicElementOptions } from '../../types/base-graphic-element';
 import { EditorHost } from '../../core';
-import { GraphicPlugin, PropertyPanelRegistration } from '../../types/graphic-plugin';
+import { GraphicPlugin } from '../../types/graphic-plugin';
 export interface RectOptions extends BaseGraphicElementOptions {
     x?: number;
     y?: number;
@@ -62,6 +62,5 @@ export declare class RectPlugin extends GraphicPlugin<RectElement> {
     shapeComponent: import('vue').DefineComponent<import('./Shape.vue').Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('./Shape.vue').Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
     iconComponent: import('vue').Component;
     typeDisplayName: string;
-    propertyPanels: PropertyPanelRegistration[];
-    protected onInstall(): void;
+    propertyPanel: import('vue').DefineComponent<import('./PropertyPanel.vue').Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('./PropertyPanel.vue').Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 }

package/dist/plugins/snap/snap.d.ts

@@ -1,5 +1,6 @@
 import { Ref } from 'vue';
 import { BasePlugin } from '../../types/base-plugin';
+import { IGraphicElement } from '../../types';
 import { GuideLine } from '../../utils/geometry';
 export declare class SnapPlugin extends BasePlugin {
     name: string;
@@ -8,13 +9,21 @@ export declare class SnapPlugin extends BasePlugin {
     private snapEnabledSnapshot;
     private cachedTargetLines;
     private cachedSelectionIds;
+    private sticky;
     protected onInstall(): void;
     protected onUninstall(): void;
     isSnapEnabled(): boolean;
     toggleSnap(): void;
+    private resetSessionState;
     private handleDragStart;
     private cacheTargets;
-    private handleDragMove;
+    resolveDragSnap(elements: IGraphicElement[], intentPositions: Map<string, {
+        x: number;
+        y: number;
+    }>): {
+        offsetX: number;
+        offsetY: number;
+    };
     private handleDragEnd;
 }
 declare module '../../types' {

package/dist/plugins/text/PropertyPanel.vue.d.ts

@@ -1,6 +1,6 @@
 import { EditorHost } from '../../core';
 import { TextElement } from './text';
-interface Props {
+export interface Props {
     host: EditorHost;
     element: TextElement;
     selection: TextElement[];

package/dist/plugins/text/Shape.vue.d.ts

@@ -1,6 +1,6 @@
+import { ShapeProps } from '../../types/shape-props';
 import { TextElement } from './text';
-export interface Props {
-    element: TextElement;
+export interface Props extends ShapeProps<TextElement> {
 }
 declare const _default: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/plugins/text/text.d.ts

@@ -1,5 +1,5 @@
 import { BaseGraphicElement, BaseGraphicElementOptions } from '../../types/base-graphic-element';
-import { GraphicPlugin, PropertyPanelRegistration } from '../../types/graphic-plugin';
+import { GraphicPlugin } from '../../types/graphic-plugin';
 import { EditorHost } from '../../core';
 export interface TextOptions extends BaseGraphicElementOptions {
     x?: number;
@@ -73,7 +73,7 @@ export declare class TextPlugin extends GraphicPlugin<TextElement> {
     shapeComponent: import('vue').DefineComponent<import('./Shape.vue').Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('./Shape.vue').Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
     iconComponent: import('vue').Component;
     typeDisplayName: string;
-    propertyPanels: PropertyPanelRegistration[];
+    propertyPanel: import('vue').DefineComponent<import('./PropertyPanel.vue').Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('./PropertyPanel.vue').Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
     protected onInstall(): void;
     protected onUninstall(): void;
 }

package/dist/types/base.d.ts

@@ -74,6 +74,7 @@ export interface IStageState {
     isPanning: boolean;
     offsetX: number;
     offsetY: number;
+    autoFitPending: boolean;
 }
 export interface IToolbar {
     name: string;

package/dist/types/event-data.d.ts

@@ -7,6 +7,10 @@ export interface BaseEventData {
     timestamp?: number;
     source?: string;
 }
+export interface EditorLifecyclePayload {
+    timestamp: number;
+    source: string;
+}
 export interface ElementEventData extends BaseEventData {
     element: any;
     elementId: string;
@@ -18,6 +22,9 @@ export interface ElementRegisteredEventData extends BaseEventData {
 export interface SelectionEventData extends BaseEventData {
     selection: Array<IGraphicElement>;
 }
+export interface SelectionChangedPayload {
+    elements: unknown[];
+}
 export interface TransformEventData extends ElementEventData {
     oldState: any;
     newState: any;
@@ -35,6 +42,10 @@ export interface ToolEventData extends BaseEventData {
 export interface PluginEventData extends BaseEventData {
     plugin: any;
 }
+export interface PluginLoadedPayload extends BaseEventData {
+    name: string;
+    plugin: unknown;
+}
 export interface CommandEventData extends BaseEventData {
     command: any;
 }
@@ -81,6 +92,16 @@ export interface LayerOrderEventData extends BaseEventData {
     direction: 'up' | 'down' | 'top' | 'bottom';
     newOrder?: string[];
 }
+export interface LayerOrderChangedPayload extends BaseEventData {
+    elementIds: string[];
+    elementId?: string;
+    direction?: 'up' | 'down' | 'top' | 'bottom';
+    newOrder?: string[];
+}
+export interface LayerVisibilityChangedPayload extends BaseEventData {
+    elementId: string;
+    visible: boolean;
+}
 export interface BaseStageEventData extends BaseEventData {
     point: Point2D;
     target: any;

package/dist/types/event-map.d.ts

@@ -1,4 +1,4 @@
-import { BaseEventData, ElementDragEventData, ElementEventData, SelectionEventData, TransformEventData, ToolEventData, PluginEventData, CommandEventData, HistoryEventData, ViewEventData, CreationEventData, ErrorEventData, PerformanceEventData, AlignEventData, DistributeEventData, LayerOrderEventData, ElementUpdateEventData, StageDblClickEventData, StageMouseEventData, StageKeyboardEventData, ElementRegisteredEventData, StatusEventData, GraphicEventData, GraphicToolEventData, PropertyPanelEventData } from './event-data';
+import { BaseEventData, EditorLifecyclePayload, ElementDragEventData, ElementEventData, SelectionEventData, TransformEventData, ToolEventData, PluginEventData, PluginLoadedPayload, CommandEventData, HistoryEventData, ViewEventData, CreationEventData, ErrorEventData, PerformanceEventData, AlignEventData, DistributeEventData, LayerOrderEventData, LayerOrderChangedPayload, LayerVisibilityChangedPayload, ElementUpdateEventData, StageDblClickEventData, StageMouseEventData, StageKeyboardEventData, ElementRegisteredEventData, StatusEventData, GraphicEventData, GraphicToolEventData, PropertyPanelEventData } from './event-data';
 /**
  * 编辑器事件映射接口
  * @description 定义编辑器中所有可能的事件及其对应的负载类型。
@@ -16,9 +16,9 @@ import { BaseEventData, ElementDragEventData, ElementEventData, SelectionEventDa
  * ```
  * */
 export interface EventMap {
-    'editor:ready': (payload: BaseEventData) => void;
-    'editor:destroy': (payload: BaseEventData) => void;
-    'editor:reset': (payload: BaseEventData) => void;
+    'editor:ready': (payload: EditorLifecyclePayload) => void;
+    'editor:destroy': (payload: EditorLifecyclePayload) => void;
+    'editor:reset': (payload: EditorLifecyclePayload) => void;
     'file:new': (payload: BaseEventData) => void;
     'file:open': (payload: BaseEventData) => void;
     'file:save': (payload: BaseEventData) => void;
@@ -83,8 +83,8 @@ export interface EventMap {
     'view:ruler-visibility-change': (payload: ViewEventData) => void;
     'layer:added': (payload: BaseEventData) => void;
     'layer:removed': (payload: BaseEventData) => void;
-    'layer:order-changed': (payload: LayerOrderEventData) => void;
-    'layer:visibility-change': (payload: BaseEventData) => void;
+    'layer:order-changed': (payload: LayerOrderChangedPayload) => void;
+    'layer:visibility-change': (payload: LayerVisibilityChangedPayload) => void;
     'layer:locked-change': (payload: BaseEventData) => void;
     'layer:active-change': (payload: BaseEventData) => void;
     'command:executed': (payload: CommandEventData) => void;
@@ -96,7 +96,7 @@ export interface EventMap {
     'plugin:unregistered': (payload: PluginEventData) => void;
     'plugin:activated': (payload: PluginEventData) => void;
     'plugin:deactivated': (payload: PluginEventData) => void;
-    'plugin:loaded': (payload: PluginEventData) => void;
+    'plugin:loaded': (payload: PluginLoadedPayload) => void;
     'plugin:error': (payload: ErrorEventData) => void;
     'graphic:registered': (payload: GraphicEventData) => void;
     'graphic:unregistered': (payload: GraphicEventData) => void;

package/dist/types/graphic-plugin.d.ts

@@ -19,6 +19,32 @@ export declare abstract class GraphicPlugin<T extends IGraphicElement> extends B
     abstract graphicType: string;
     abstract graphicElement: new (host: EditorHost) => T;
     abstract shapeComponent: Component;
+    /**
+     * 当前图形自身的属性面板 Vue 组件。
+     *
+     * 与 {@link shapeComponent} / {@link iconComponent} 风格一致：
+     * 直接以组件引用声明，而非工厂函数。
+     *
+     * 基类会在 `onActivate` 时自动 emit 等价的 `property-panel:registered` 事件：
+     * - `graphicTypes = [this.graphicType]`
+     * - `render = () => this.propertyPanel`
+     * - `isCanvas = false`
+     * - `isPublic = false`
+     *
+     * 如需注册自身以外的图形类型、注册多个面板、或 `isCanvas = true` / `isPublic = true`，
+     * 请改用旧 {@link propertyPanels} 字段或在独立插件的 `onInstall` 手动 emit。
+     */
+    propertyPanel?: Component;
+    /**
+     * 属性面板注册列表（旧 API，多面板与逃生通道）。
+     *
+     * @deprecated 请优先使用单数 {@link propertyPanel} 字段。本字段仅作为
+     * 「多面板 / 为其他 graphicType 注册 / `isCanvas = true` / `isPublic = true`」
+     * 场景下的逃生通道保留。新插件禁止使用本字段。
+     *
+     * 基类 `onActivate` 仍按现有逻辑遍历本数组 emit `property-panel:registered`，
+     * 因此同一插件同时声明 `propertyPanel` 与 `propertyPanels` 时两者都会被注册。
+     */
     propertyPanels?: PropertyPanelRegistration[];
     iconComponent?: Component;
     typeDisplayName?: string;

package/dist/types/index.d.ts

@@ -5,3 +5,4 @@ export * from './event-data';
 export * from './event-map';
 export * from './konva-text';
 export * from './graphic-plugin';
+export * from './shape-props';

package/dist/types/shape-props.d.ts

@@ -0,0 +1,6 @@
+import { EditorHost } from '../core';
+import { IGraphicElement } from './base';
+export interface ShapeProps<T extends IGraphicElement = IGraphicElement> {
+    element: T;
+    host: EditorHost;
+}

package/dist/utils/geometry.d.ts

@@ -36,3 +36,16 @@ export declare function getElementAABB(input: AABBInput): AABB;
 export declare function getAABBLineValues(aabb: AABB): AABBLineValues;
 export declare function unionAABB(aabbs: AABB[]): AABB | null;
 export declare function computeSnap(dragged: AABBLineValues, targets: AABBLineValues[], threshold: number): SnapResult;
+export type StickyAxis = SnapMatch | null;
+export interface StickyState {
+    x: StickyAxis;
+    y: StickyAxis;
+}
+export declare function snapResultToOffset(result: SnapResult): {
+    offsetX: number;
+    offsetY: number;
+};
+export declare function applyStickySnap(intent: AABBLineValues, rawSnap: SnapResult, sticky: StickyState, threshold: number): {
+    result: SnapResult;
+    nextSticky: StickyState;
+};

package/dist/utils/transform-geometry.d.ts

@@ -41,7 +41,7 @@ export declare function getElementOBB(input: {
     scaleX?: number;
     scaleY?: number;
 }): OBB;
-export declare function getElementOBBFromSource(element: IGraphicElement, node: {
+export declare function getElementOBBFromSource(element: IGraphicElement, _node: {
     x: () => number;
     y: () => number;
     rotation: () => number;