vkedit 3.2.7 → 4.0.1

package/dist/{index.es-B1gCGYT7.js → index.es-LscL1n3Y.js}

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

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

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

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

@@ -1,4 +1,3 @@
 export { default as BarcodePropertyPanel } from './PropertyPanel.vue';
 export { default as BarcodeShape } from './Shape.vue';
-export { default as BarcodeTool } from './Tool.vue';
 export * from './barcode';

package/dist/plugins/export/export.d.ts

@@ -7,7 +7,6 @@ export declare class ExportPlugin extends BasePlugin {
     pixelRatio: number;
     constructor(host: EditorHost, pixelRatio?: number);
     protected onInstall(): void;
-    handleExportExcel(): void;
     handleExportImage(): void;
     handleExportJSON(): void;
     handleExportPdf(): void;
@@ -30,7 +29,7 @@ declare module '../../types' {
     }
 }
 export interface ExportEventData extends BaseEventData {
-    format: 'png' | 'jpeg' | 'pdf' | 'json' | 'excel' | string;
+    format: 'png' | 'jpeg' | 'pdf' | 'json' | string;
     error?: any;
     prevent?: () => void;
 }

package/dist/plugins/graphic-registry/graphic-registry.d.ts

@@ -0,0 +1,43 @@
+import { BasePlugin } from '../../types/base-plugin';
+import { Component } from 'vue';
+import { IGraphicElement } from '../../types';
+export interface ToolDescriptor {
+    type: string;
+    iconComponent: Component;
+    typeDisplayName: string;
+    createElement: () => IGraphicElement;
+}
+export declare class GraphicRegistryPlugin extends BasePlugin {
+    name: string;
+    version: string;
+    elements: Map<string, IGraphicElement>;
+    private graphics;
+    private tools;
+    private propertyPanels;
+    protected onInstall(): void;
+    protected onUninstall(): void;
+    getElementComponent(type: string): Component;
+    getTypeMeta(type: string): {
+        iconComponent?: Component;
+        typeDisplayName?: string;
+    } | undefined;
+    getToolList(): ToolDescriptor[];
+    getToolComponent(type: string): Component;
+    getPanelsBySelection(selection: IGraphicElement[]): Component[];
+    private getPanelsByType;
+    private getPanelsByMultipleSelect;
+    private findCommonElements;
+    getCanvasPanels(): Component[];
+    addElement(element: IGraphicElement): void;
+    removeElement(elementId: string): void;
+    getElement<T extends IGraphicElement = IGraphicElement>(elementId: string): T;
+    getAllElements<T extends IGraphicElement = IGraphicElement>(): T[];
+    createElement(type: string): IGraphicElement;
+    getOrderedElements(order?: 'ascending' | 'descending'): IGraphicElement[];
+    normalizeZIndices(): void;
+}
+declare module '../../types' {
+    interface PluginMap {
+        'graphic-registry-plugin': GraphicRegistryPlugin;
+    }
+}

package/dist/plugins/graphic-registry/index.d.ts

@@ -0,0 +1 @@
+export * from './graphic-registry';

package/dist/plugins/import/import.d.ts

@@ -12,7 +12,6 @@ export declare class ImportPlugin extends BasePlugin {
     };
     handleImportJSON(): void;
     importJSON(data: string): void;
-    importExcel(): void;
 }
 declare module '../../types' {
     interface PluginMap {
@@ -20,7 +19,7 @@ declare module '../../types' {
     }
 }
 export interface ImportEventData extends BaseEventData {
-    format: 'json' | 'excel' | string;
+    format: 'json' | string;
     error?: any;
 }
 declare module '../../types' {

package/dist/plugins/index.d.ts

@@ -1,21 +1,17 @@
 export * from './align';
 export * from './barcode';
 export * from './clipboard';
-export * from './chart';
 export * from './context-menu-manager';
-export * from './element-manager';
 export * from './export';
-export * from './graphic-manager';
-export * from './graphic-tool-manager';
+export * from './graphic-registry';
 export * from './import';
 export * from './keydown';
+export * from './layer-manager';
 export * from './line';
 export * from './preview';
-export * from './property-panel-manager';
 export * from './qrcode';
 export * from './rect';
 export * from './selection';
 export * from './snap';
-export * from './table';
 export * from './text';
 export * from './toolbar-manager';

package/dist/plugins/{table/ContextMenu.vue.d.ts → layer-manager/LayerPanel.vue.d.ts}

@@ -1,9 +1,10 @@
 import { EditorHost } from '../../core';
-import { TableElement } from './table';
 type __VLS_Props = {
     host: EditorHost;
-    element: TableElement;
-    selection: TableElement[];
 };
-declare const _default: 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: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    panelRef: HTMLDivElement;
+    listRef: HTMLDivElement;
+    renameInputEl: HTMLInputElement;
+}, HTMLDivElement>;
 export default _default;

package/dist/plugins/layer-manager/index.d.ts

@@ -0,0 +1,2 @@
+export { LayerManagerPlugin } from './layer-manager';
+export { default as LayerPanel } from './LayerPanel.vue';

package/dist/plugins/layer-manager/layer-manager.d.ts

@@ -0,0 +1,16 @@
+import { BasePlugin } from '../../types/base-plugin';
+import { IGraphicElement } from '../../types';
+export declare class LayerManagerPlugin extends BasePlugin {
+    name: string;
+    version: string;
+    protected onInstall(): void;
+    protected onUninstall(): void;
+    getElementDisplayName(element: IGraphicElement): string;
+    moveLayer(elementId: string, direction: 'up' | 'down' | 'top' | 'bottom'): void;
+    reorder(newOrder: string[]): void;
+}
+declare module '../../types' {
+    interface PluginMap {
+        'layer-manager-plugin': LayerManagerPlugin;
+    }
+}

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

@@ -1,5 +1,7 @@
+import { EditorHost } from '../../core';
 import { LineElement } from './line';
-interface Props {
+export interface Props {
+    host: EditorHost;
     element: 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>;

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

@@ -1,4 +1,3 @@
 export { default as LinePropertyPanel } from './PropertyPanel.vue';
 export { default as LineShape } from './Shape.vue';
-export { default as LineTool } from './Tool.vue';
 export * from './line';

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

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

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

@@ -1,4 +1,3 @@
 export { default as QrPropertyPanel } from './PropertyPanel.vue';
 export { default as QrShape } from './Shape.vue';
-export { default as QrTool } from './Tool.vue';
 export * from './qrcode';

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

@@ -1,5 +1,5 @@
 import { RectElement } from './rect';
-interface Props {
+export interface Props {
     element: 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>;

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

@@ -1,4 +1,3 @@
 export { default as RectPropertyPanel } from './PropertyPanel.vue';
 export { default as RectShape } from './Shape.vue';
-export { default as RectTool } from './Tool.vue';
 export * from './rect';

package/dist/plugins/selection.d.ts

@@ -13,7 +13,6 @@ export declare class SelectionPlugin extends BasePlugin {
     protected onInstall(): void;
     protected onUninstall(): void;
     private handleMouseDown;
-    private isClickOnTransformer;
     private handleMouseMove;
     private handleMouseUp;
     /**

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

@@ -1,5 +1,5 @@
 import { TextElement } from './text';
-interface Props {
+export interface Props {
     element: 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>;

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

@@ -1,5 +1,4 @@
 export { default as TextPropertyPanel } from './PropertyPanel.vue';
 export { default as TextShape } from './Shape.vue';
-export { default as TextTool } from './Tool.vue';
 export { default as TextContextMenu } from './TextContextMenu.vue';
 export * from './text';

package/dist/types/base-graphic-element.d.ts

@@ -13,7 +13,9 @@ export interface BaseGraphicElementOptions {
     visible?: boolean;
     locked?: boolean;
     draggable?: boolean;
-    transferable?: boolean;
+    resizable?: boolean;
+    zIndex?: number;
+    displayName?: string | null;
 }
 export declare abstract class BaseGraphicElement implements IGraphicElement {
     get x(): number;
@@ -37,8 +39,11 @@ export declare abstract class BaseGraphicElement implements IGraphicElement {
     visible: boolean;
     locked: boolean;
     draggable: boolean;
-    transferable: boolean;
+    resizable: boolean;
+    zIndex: number;
     resizeAnchors: string[] | null;
+    /** 元素自定义显示名称。空字符串/null 时回退到 layer-manager.getElementDisplayName 的自动命名逻辑。 */
+    displayName: string | null;
     constructor(host: EditorHost, options?: Partial<BaseGraphicElementOptions>);
     updateProperty(host: EditorHost, property: string, oldValue: any, newValue: any): void;
     clone(): IGraphicElement;
@@ -62,7 +67,9 @@ export declare abstract class BaseGraphicElement implements IGraphicElement {
         visible: boolean;
         locked: boolean;
         draggable: boolean;
-        transferable: boolean;
+        resizable: boolean;
+        zIndex: number;
+        displayName: string | null;
         [key: string]: any;
     };
     getTransformAttr(event: any): {

package/dist/types/base.d.ts

@@ -14,11 +14,6 @@ export interface BoundingBox {
     width: number;
     height: number;
 }
-export interface IGraphicComponent {
-    component: any;
-    props?: any;
-    events?: any;
-}
 export interface IGraphicElement {
     id: string;
     type: string;
@@ -32,7 +27,10 @@ export interface IGraphicElement {
     visible: boolean;
     locked: boolean;
     draggable: boolean;
-    transferable: boolean;
+    resizable: boolean;
+    zIndex: number;
+    /** 元素自定义显示名称。空字符串/null 时回退到 layer-manager.getElementDisplayName 的自动命名逻辑。 */
+    displayName?: string | null;
     resizeAnchors?: string[] | null;
     getBoundingBox(): BoundingBox;
     clone(): IGraphicElement;
@@ -51,24 +49,13 @@ export interface IEditorPlugin {
     uninstall(): void;
     activate?(): void;
     deactivate?(): void;
-    registerGraphicTypes?(): IGraphicType[];
-    getTools?(): IPluginTool[];
-    [key: string]: any;
-}
-export interface IPluginTool {
     [key: string]: any;
 }
-export interface IGraphicType {
-    type: string;
-    render(): Component;
-    renderTool(): Component;
-    renderPropertyPanel(): Component;
-    createElement(x: number, y: number): IGraphicElement;
-}
 export interface IEditorState {
     zoom: number;
     currentTool: string;
     snapToGrid: boolean;
+    snapRotation: boolean;
     showGrid: boolean;
     width: number;
     height: number;
@@ -87,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;
 }
@@ -79,6 +90,17 @@ export interface DistributeEventData extends BaseEventData {
 export interface LayerOrderEventData extends BaseEventData {
     elementId: string;
     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;
@@ -106,6 +128,22 @@ export interface ElementDragEventData extends BaseEventData {
     target: any;
     evt: MouseEvent | undefined;
 }
+export interface GraphicEventData extends BaseEventData {
+    type: string;
+    render: () => Component;
+    iconComponent?: Component;
+    typeDisplayName?: string;
+}
+export interface GraphicToolEventData extends BaseEventData {
+    type: string;
+    render: () => Component;
+}
+export interface PropertyPanelEventData extends BaseEventData {
+    graphicTypes: string[];
+    render: () => Component;
+    isCanvas: boolean;
+    isPublic: boolean;
+}
 /**
  * 事件工具函数
  */

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 } 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,11 +96,17 @@ 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;
+    'graphic-tool:registered': (payload: GraphicToolEventData) => void;
+    'graphic-tool:unregistered': (payload: GraphicToolEventData) => void;
     'create-strategy:registered': (payload: BaseEventData) => void;
     'create-strategy:unregistered': (payload: BaseEventData) => void;
     'create-strategy:needs-register': (payload: BaseEventData) => void;
+    'property-panel:registered': (payload: PropertyPanelEventData) => void;
+    'property-panel:unregistered': (payload: PropertyPanelEventData) => void;
     'property:value-change': (payload: BaseEventData) => void;
     'property:batch-update-start': (payload: BaseEventData) => void;
     'property:batch-update-end': (payload: BaseEventData) => void;
@@ -109,6 +115,7 @@ export interface EventMap {
     'elements:group': (payload: BaseEventData) => void;
     'elements:ungroup': (payload: BaseEventData) => void;
     'elements:layer': (payload: LayerOrderEventData) => void;
+    'elements:reorder': (payload: LayerOrderEventData) => void;
     'shortcut:triggered': (payload: BaseEventData) => void;
     'shortcut:registered': (payload: BaseEventData) => void;
     'shortcut:conflict': (payload: BaseEventData) => void;

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

@@ -0,0 +1,53 @@
+import { Component } from 'vue';
+import { EditorHost } from '../core';
+import { BasePlugin } from './base-plugin';
+import { IGraphicElement } from './base';
+export interface GraphicTypeRegistration {
+    type: string;
+    render: () => Component;
+    createElement: () => IGraphicElement;
+    iconComponent?: Component;
+    typeDisplayName?: string;
+}
+export interface PropertyPanelRegistration {
+    graphicTypes: string[];
+    render: () => Component;
+    isCanvas?: boolean;
+    isPublic?: boolean;
+}
+export declare abstract class GraphicPlugin<T extends IGraphicElement> extends BasePlugin {
+    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;
+    protected onActivate(): void;
+    protected onDeactivate(): void;
+}

package/dist/types/index.d.ts

@@ -1,9 +1,7 @@
 export * from './base-graphic-element';
-export * from './base-graphic-type';
 export * from './base-plugin';
 export * from './base';
 export * from './event-data';
 export * from './event-map';
 export * from './konva-text';
-export * from './plugin-map';
-export * from './element-type-map';
+export * from './graphic-plugin';

package/dist/utils/color.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 判断输入是否是完整的 #RRGGBB 形式的 HEX 颜色
+ */
+export declare function isFullHexColor(value: unknown): boolean;
+/**
+ * 将任意输入规范化为小写 #rrggbb 形式的 HEX 字符串
+ * @returns 规范化结果；输入不是合法完整 HEX 时返回 null
+ */
+export declare function normalizeHex(value: unknown): string | null;
+/**
+ * 将 #rrggbb 形式的字符串拆分成 r/g/b 三个 0-255 的整数分量
+ */
+export declare function hexToRgb(hex: unknown): {
+    r: number;
+    g: number;
+    b: number;
+} | null;
+/**
+ * WCAG 2.x sRGB 相对亮度
+ * https://www.w3.org/TR/WCAG21/#dfn-relative-luminance
+ */
+export declare function relativeLuminance(rgb: {
+    r: number;
+    g: number;
+    b: number;
+}): number;
+/**
+ * WCAG 2.x 对比度 = (较亮 + 0.05) / (较暗 + 0.05)
+ */
+export declare function contrastRatio(a: {
+    r: number;
+    g: number;
+    b: number;
+}, b: {
+    r: number;
+    g: number;
+    b: number;
+}): number;
+export declare const DEFAULT_SWATCHES: string[];
+export declare const PRESET_SWATCHES: string[];

package/dist/utils/css-var.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Read a CSS custom property from the editor theme scope.
+ * Prefer passing a node inside the editor (e.g. host.stageState.wrapperEl).
+ */
+export declare function cssVar(name: string, el?: Element | null): string;
+/**
+ * Resolve a color token to a computed color (rgb/rgba) that canvas/Konva can use.
+ * getPropertyValue alone may return nested `var(...)` which Konva cannot paint.
+ */
+export declare function cssColorVar(name: string, el?: Element | null): string;
+/**
+ * Resolve color-mix against a token (e.g. primary @ 16% transparent) for Konva fills.
+ */
+export declare function cssColorMix(name: string, percent: number, el?: Element | null, space?: string): string;

package/dist/utils/index.d.ts

@@ -1 +1,5 @@
 export * from './geometry';
+export * from './color';
+export * from './readability';
+export * from './transform-geometry';
+export * from './transform-overlay';

package/dist/utils/readability.d.ts

@@ -0,0 +1,22 @@
+import { ComputedRef } from 'vue';
+export declare const READABILITY_WARNING_TEXT = "\u5F53\u524D\u524D\u666F\u8272\u4E0E\u80CC\u666F\u8272\u7684\u660E\u6697\u5173\u7CFB\u6216\u5BF9\u6BD4\u5EA6\u53EF\u80FD\u5BFC\u81F4\u7801\u65E0\u6CD5\u8BC6\u522B\uFF0C\u8BF7\u4F7F\u7528\u5B9E\u9645\u8BBE\u5907\u626B\u7801\u786E\u8BA4\u3002";
+export declare const READABILITY_CONTRAST_THRESHOLD = 4.5;
+/**
+ * 判定给定前景色与背景色组合是否会触发可读性风险提示。
+ * - 前景亮度 >= 背景亮度 ⇒ 必然触发
+ * - 前景更暗但对比度 < 4.5 ⇒ 触发
+ * - 前景更暗且对比度 >= 4.5 ⇒ 不触发
+ */
+export declare function shouldWarnReadability(fg: string, bg: string): boolean;
+export interface UseReadabilityWarningInput {
+    foreground: ComputedRef<string> | {
+        value: string;
+    };
+    background: ComputedRef<string> | {
+        value: string;
+    };
+}
+/**
+ * 在属性面板中使用的可读性风险提示组合式：返回文案（无风险时为空字符串）
+ */
+export declare function useReadabilityWarning(input: UseReadabilityWarningInput): ComputedRef<string>;

package/dist/utils/theme.d.ts

@@ -0,0 +1,2 @@
+export type VkeditTheme = 'dark' | 'light';
+export declare function resolveVkeditTheme(el: Element | null | undefined): VkeditTheme;