vkedit 4.0.0 → 4.0.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 vkedit contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 庞万国
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -151,6 +151,15 @@ import 'vkedit/dist/vkedit.css'
 
 ---
 
+## 社区
+
+- [贡献指南](CONTRIBUTING.md)
+- [行为准则](CODE_OF_CONDUCT.md)
+- [安全政策](SECURITY.md)
+- [第三方许可证声明](THIRD_PARTY_LICENSES.md)
+
+---
+
 ## 联系方式
 
 - **QQ**: 16871824

package/THIRD_PARTY_LICENSES.md

@@ -0,0 +1,64 @@
+# 第三方许可证声明
+
+vkedit 使用了以下开源依赖。本文件依据各许可证要求列出其版权与许可信息。
+
+## 运行时依赖（随 npm 包分发）
+
+以下依赖会在安装 vkedit 时被引入，许可证均与 vkedit 的 MIT 许可证兼容。
+
+| 依赖 | 版本 | 许可证 | 来源 |
+| --- | --- | --- | --- |
+| @vueuse/core | ^14.0.0 | MIT | https://github.com/vueuse/vueuse |
+| jsbarcode | ^3.11.5 | MIT | https://github.com/lindell/JsBarcode |
+| jspdf | ^3.0.3 | MIT | https://github.com/parallax/jsPDF |
+| lodash | ^4.17.21 | MIT | https://github.com/lodash/lodash |
+| qrcode | ^1.5.1 | MIT | https://github.com/soldair/node-qrcode |
+| uuid | ^13.0.0 | MIT | https://github.com/uuidjs/uuid |
+
+### Peer Dependencies（由宿主项目提供）
+
+| 依赖 | 版本 | 许可证 | 来源 |
+| --- | --- | --- | --- |
+| konva | ^10.0.2 | MIT | https://github.com/konvajs/konva |
+| vue | ^3.5.18 | MIT | https://github.com/vuejs/core |
+| vue-konva | ^3.2.6 | MIT | https://github.com/konvajs/vue-konva |
+
+## 开发依赖（不随 npm 包分发）
+
+以下依赖仅用于开发与构建，不影响下游合规义务。其中 `@iconify-json/ph` 的图标 SVG 数据在构建时由 `unplugin-icons` 内联至 `dist/`，但因其同为 MIT 许可，不产生额外合规义务。
+
+| 依赖 | 许可证 |
+| --- | --- |
+| @iconify-json/ph | MIT |
+| @tsconfig/node22 | MIT |
+| @types/lodash | MIT |
+| @types/node | MIT |
+| @types/qrcode | MIT |
+| @vitejs/plugin-vue | MIT |
+| @vue/eslint-config-prettier | MIT |
+| @vue/eslint-config-typescript | MIT |
+| @vue/tsconfig | MIT |
+| eslint | MIT |
+| eslint-plugin-vue | MIT |
+| jiti | MIT |
+| npm-run-all2 | MIT |
+| prettier | MIT |
+| primevue | MIT |
+| sass-embedded | MIT |
+| typescript | Apache-2.0 |
+| unplugin-icons | MIT |
+| vite | MIT |
+| vite-plugin-css-injected-by-js | MIT |
+| vite-plugin-dts | MIT |
+| vite-plugin-vue-devtools | MIT |
+| vue-tsc | MIT |
+
+## 许可证全文
+
+- MIT: https://opensource.org/license/mit/
+
+> 注：`typescript` 为 Apache-2.0 许可，但属开发依赖，不随 npm 包分发，无需附带许可证全文。
+
+---
+
+本声明基于发布时已知的依赖信息。如发现遗漏或错误，请通过 [GitHub Issues](https://github.com/pwg-code/vkedit/issues) 报告。

package/dist/commands/add-element-command.d.ts

@@ -1,7 +1,6 @@
 import { BaseCommand } from './base-command';
 import { IGraphicElement } from '../types';
 import { EditorHost } from '../core';
-import { ICommand } from './i-command';
 export declare class AddElementCommand extends BaseCommand {
     private element;
     name: string;
@@ -9,5 +8,4 @@ export declare class AddElementCommand extends BaseCommand {
     constructor(host: EditorHost, element: IGraphicElement);
     execute(): void;
     undo(): void;
-    canMergeWith(command: ICommand): boolean;
 }

package/dist/commands/change-layer-order-command.d.ts

@@ -9,6 +9,7 @@ export declare class ChangeLayerOrderCommand extends BaseCommand {
     constructor(host: EditorHost, elementId: string, direction: 'up' | 'down' | 'top' | 'bottom');
     execute(): void;
     undo(): void;
+    private emitOrderChanged;
     private saveCurrentOrder;
     private changeLayerOrder;
     private restorePreviousOrder;

package/dist/commands/index.d.ts

@@ -4,6 +4,7 @@ export * from './add-element-command';
 export * from './remove-element-command';
 export * from './transform-element-command';
 export * from './update-property-command';
+export * from './update-canvas-property-command';
 export * from './clear-selection-command';
 export * from './batch-command';
 export * from './change-layer-order-command';

package/dist/commands/reorder-elements-command.d.ts

@@ -14,6 +14,7 @@ export declare class ReorderElementsCommand extends BaseCommand {
     constructor(host: EditorHost, newOrder: string[], description?: string);
     execute(): void;
     undo(): void;
+    private emitOrderChanged;
     private saveCurrentOrder;
     private applyOrder;
 }

package/dist/commands/update-canvas-property-command.d.ts

@@ -0,0 +1,23 @@
+import { BaseCommand } from './base-command';
+import { IEditorState } from '../types';
+import { EditorHost } from '../core';
+import { ICommand } from './i-command';
+export type CanvasPropertyPath = 'dpm' | 'width' | 'height';
+export interface CanvasPropertySnapshot {
+    dpm: number;
+    width: number;
+    height: number;
+    wmm: number;
+    hmm: number;
+}
+export declare class UpdateCanvasPropertyCommand extends BaseCommand {
+    name: string;
+    private propertyPath;
+    private oldState;
+    private newStatus;
+    constructor(host: EditorHost, propertyPath: CanvasPropertyPath, oldState: CanvasPropertySnapshot, newStatus: Partial<IEditorState>);
+    execute(): void;
+    undo(): void;
+    canMergeWith(command: ICommand): boolean;
+    mergeWith(command: ICommand): ICommand;
+}

package/dist/core/editor-host.d.ts

@@ -20,6 +20,7 @@ export declare class EditorHost {
         isPanning: boolean;
         offsetX: number;
         offsetY: number;
+        autoFitPending: boolean;
     };
     emit<K extends keyof EventMap>(event: K, payload: Parameters<EventMap[K]>[0]): void;
     on<K extends keyof EventMap>(event: K, handler: EventMap[K]): void;
@@ -30,6 +31,7 @@ export declare class EditorHost {
     executeCommand(command: ICommand): void;
     undo(): void;
     redo(): void;
+    private _emitHistoryChanged;
     get status(): IEditorState;
     setStatus(newStatus: Partial<IEditorState>): void;
     toJSON(): string;

package/dist/favicon.svg

@@ -1,8 +1,21 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="vkedit">
-  <title>vkedit</title>
-  <desc>Teal rounded square with a fused white VK monogram. V's right arm and K's vertical stem share the same axis (x=30 to 36), so the lower half of the K stem is absorbed into V. The K diagonals branch from that shared stem to the upper-right and lower-right corners of the mark.</desc>
-  <rect width="64" height="64" rx="14" fill="#0d9488"/>
-  <path d="M 8 14 L 20 14 L 32 40 L 44 14 L 56 14 L 36 52 L 28 52 Z" fill="#ffffff"/>
-  <path d="M 30 14 L 36 14 L 36 28 L 50 14 L 56 14 L 40 32 L 56 50 L 50 50 L 36 36 L 36 50 L 30 50 Z" fill="#ffffff"/>
-</svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 80 80" width="80" height="80" role="img" aria-labelledby="title desc">
+  <title id="title">vkedit</title>
+  <desc id="desc">vkedit 网站图标，由渐变 V 形与画布折角组成</desc>
+  <defs>
+    <linearGradient id="vkedit-mark" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#2DD4BF"/>
+      <stop offset="0.48" stop-color="#14B8A6"/>
+      <stop offset="1" stop-color="#0D9488"/>
+    </linearGradient>
+    <linearGradient id="vkedit-fold" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#99F6E4"/>
+      <stop offset="1" stop-color="#5EEAD4"/>
+    </linearGradient>
+  </defs>
+  <rect x="4" y="4" width="72" height="72" rx="18" fill="#111726" stroke="#2B3854"/>
+  <g transform="translate(3 8)">
+    <path d="M42 45L55 41.5V27.5L59 31.5C60.3 32.8 61 34.5 61 36.4V48C61 52.4 57.4 56 53 56H39.5C36.9 56 34.6 54.5 33.5 52.3L42 45Z" fill="url(#vkedit-fold)"/>
+    <path d="M14 18C11.7 14.3 13.2 9.6 17.2 7.5C21.1 5.5 25.6 6.7 27.9 10.3L36 23.2L44.1 10.3C46.4 6.7 50.9 5.5 54.8 7.5C58.8 9.6 60.3 14.3 58 18L42.8 42.4C39.6 47.6 32.4 47.6 29.2 42.4L14 18Z" fill="url(#vkedit-mark)"/>
+    <path d="M18.4 10.7C21.1 9.3 24.2 10.1 25.8 12.7L35.7 28.5" fill="none" stroke="#FFFFFF" stroke-width="1.3" stroke-linecap="round" opacity="0.18"/>
+  </g>
+</svg>

package/dist/hooks/index.d.ts

@@ -2,6 +2,7 @@ export * from './use-bg-layer';
 export * from './use-content-layer';
 export * from './use-host-state';
 export * from './use-property-command';
+export * from './use-canvas-property-command';
 export * from './use-ruler-layer';
 export * from './use-selection-layer';
 export * from './use-stage-event';

package/dist/hooks/use-canvas-property-command.d.ts

@@ -0,0 +1,5 @@
+import { CanvasPropertyPath } from '../commands';
+import { EditorHost } from '../core';
+export declare function useCanvasPropertyCommand(host: EditorHost): {
+    updateCanvasProperty: (propertyPath: CanvasPropertyPath, newValue: number) => void;
+};