# Changelog

## [4.0.2] - 2026-07-29

### Features

- **Event system enhancements** — Editor emits `editor:ready` on mount, `editor:destroy` on unmount, `editor:reset` before `loadJSON` rebuilds canvas and history; host emits `plugin:loaded` after install/activate and `history:changed` for Toolbar undo/redo state wiring; selection emits `selection:cleared` when transitioning from selected to empty.
- **Canvas property undo/redo** — `UpdateCanvasPropertyCommand` supports undo/redo for dpm, width, height changes.
- **Zoom auto-fit** — Canvas auto-fits to half viewport on `loadJSON` completion.
- **TransformOverlay unified drag** — All element dragging unified through `TransformOverlay`; Shape native drag handlers retired.
- **Export filename prefix** — Exported PNG/JPEG/PDF filenames are prefixed with `vkedit`.
- **Pin icon enhancement** — Lock icon changed to solid fill style for stronger lock/unlock visual distinction.
- **Favicon update** — Updated `favicon.svg` with new brand design and gradients.

### Improvements

- **Icons migrated to Phosphor** — Icon set switched from `material-symbols-light` to Phosphor for better consistency and smaller bundle.
- **Snap decoupled from DOM** — Snap calculation logic extracted from DOM dependency; `resolveDragSnap` exposed for overlay integration.
- **Line element reworked** — Line element switched to `v-rect` fill with transparent hit layer for zoom-robust selection.
- **Layer event names unified** — Layer events renamed to `layer:order-changed` and `layer:visibility-change` for consistency.

### Fixed

- **Hidden elements rendering** — Elements with `visible: false` no longer render on canvas.
- **Box-select start logic** — Box-select now correctly starts from an unselected element instead of triggering single-select.
- **Align sync** — Konva node is synced after model update in align command; distribute icons swapped for correct ordering.
- **Build export** — `Props` interface exported to unblock plugin type chain for host consumption.
- **Keyboard move canvas update** — `TransformElementCommand` syncs Konva node to fix canvas not updating on keyboard arrow move.
- **Command coalescing** — Compatible commands are coalesced in `executeCommand`; merged command side effects applied on each execution.

## [4.0.0] - 2026-07-21

### BREAKING CHANGE (styles)

- **Design Token 重命名/删除** — 废弃 `--vkedit-color-white`、`--vkedit-color-gray-*`、`--vkedit-color-bg-dark*`、`--vkedit-color-border-dark*`、`--vkedit-color-text-dark*` 等旧变量，改用统一语义 Token（详见 [MIGRATION.md](./MIGRATION.md)）
- **默认暗色主题** — 编辑器根节点默认 `data-vkedit-theme="dark"`，废除原 `body:has(.vkedit-editor)` 深色覆盖方案
- **Primary 色变更为 teal** — 品牌色从蓝色系切换为 teal 系，若需还原请覆盖 `--vkedit-color-primary` 等 CSS 变量
- **移除 `--vkedit-color-neutral-*` 零散阶梯** — 统一为 `--vkedit-palette-neutral-*`（0～950 完整阶梯）

### Features

- **teal primary 品牌色** — 暗色 `--vkedit-palette-teal-500`、亮色 `--vkedit-palette-teal-600`，统一 Vk* 组件与壳层视觉
- **Design Token 体系** — 两层架构：Palette（`:root`）+ Semantic（主题选择器），组件只引用语义变量
- **VkButton `variant="primary"`** — 新增 primary/destructive/outline/secondary/ghost/link 变体
- **Teleport 浮层主题继承** — 弹出层自动携带 `data-vkedit-theme`，浮层在 DOM 外也能正确渲染主题色
- **主题解析工具** — `resolveVkeditTheme(el)` 工具函数，供自定义组件获取当前主题
- **完整 CSS 变量集** — 包含 spacing、radius、font、shadow、elevation、z-index、control-height 等基础设施

### Added

- **`GraphicPlugin<T>` 抽象基类** — 新增统一插件基类，子类只需声明 `graphicType`、`graphicElement`、`shapeComponent`、`toolComponent`、`propertyPanels` 等抽象属性，即可在 `onActivate`/`onDeactivate` 中自动完成图形组件、工具栏、属性面板、元素构造器的注册与注销，无需手动 emit 四条事件。
- **`GraphicRegistryPlugin` 统一注册中心** — 替代原有的 GraphicManagerPlugin、GraphicToolManagerPlugin、ElementManagerPlugin、PropertyPanelManagerPlugin，集中管理所有图形类型、工具栏、属性面板、元素构造器的注册与查询。

### Changed

- **字段重命名：`transferable` → `resizable`** — `IGraphicElement` 接口及 `BaseGraphicElement` 实现中的可缩放标记字段统一更名为 `resizable`，语义更准确。
- **字段重命名：`element.name` → `element.displayName`** — 元素自定义显示名称字段从 `name` 改为 `displayName`，`LayerManagerPlugin` 的自动命名逻辑同步更新。
- **Rect / Text / Line / Qrcode / Barcode 插件重构** — 五个图形插件从继承 `BasePlugin` + 手动 emit 四条注册事件，改为继承 `GraphicPlugin<T>`，通过抽象属性声明式注册。
- **方法重命名：`handlePMouseleave` → `handleMouseLeave`** — 统一鼠标离开事件处理方法命名，消除拼写不一致。
- **`EditorHost` 泛型简化** — `installPlugin` / `getPlugin` / `uninstallPlugin` 方法移除对 `PluginMap` 的泛型依赖，改为运行时 string 键 + 显式泛型重载。

### Deprecated

- **`declare module '@/types'` 模块声明合并模式** — 基于 `PluginMap` / `ElementTypeMap` 空接口 + `declare module` 的插件类型注册机制不再推荐使用，改为由 `GraphicPlugin<T>` 及 `GraphicRegistryPlugin` 统一管理类型信息。

### Removed

- **删除 `GraphicManagerPlugin`**（`src/plugins/graphic-manager/`）— 功能由 `GraphicRegistryPlugin` 替代。
- **删除 `GraphicToolManagerPlugin`**（`src/plugins/graphic-tool-manager.ts`）— 功能由 `GraphicRegistryPlugin` 替代。
- **删除 `ElementManagerPlugin`**（`src/plugins/element-manager.ts`）— 功能由 `GraphicRegistryPlugin` 替代。
- **删除 `PropertyPanelManagerPlugin`**（`src/plugins/property-panel-manager/`）— 功能由 `GraphicRegistryPlugin` 替代。
- **删除 `PluginMap` 类型文件**（`src/types/plugin-map.ts`）— 不再需要模块声明合并模式。
- **删除 `ElementTypeMap` 类型文件**（`src/types/element-type-map.ts`）— 不再需要模块声明合并模式。
- **删除 `BaseGraphicType` 类型文件**（`src/types/base-graphic-type.ts`）— 由 `GraphicPlugin<T>` 替代。
- **清理死代码** — 移除 EditorHost 及各个插件中因旧架构残留的临时变量、未使用 imports 及已注释代码块。

### Fixed

- **`create-host.ts`** — 修复核心插件安装链，移除已删除的四个旧 Manager 插件引用，替换为 `GraphicRegistryPlugin`。