vg-print 1.0.421 → 1.0.422

package/README.md

@@ -419,9 +419,86 @@ const disableAutoConnect = () => designer.value.disAutoConnect()
 - `initial-template: object` 初始化模板 JSON；为空时使用内置示例模板
 - `initial-print-data: object | array` 初始化打印数据；支持对象或数组，运行时变更会即时生效
 - `default-lang: string` 默认语言；支持 `cn`、`en`、`de`、`es`、`fr`、`it`、`ja`、`ru`、`cn_tw`；默认 `cn`
+- `config: object` 设计器引擎配置；会在初始化前注入到 `hiprint.setConfig(config)`（同时写入 `window.HIPRINT_CONFIG`）。常用字段：
+  - `showAdsorbLine: boolean` 是否显示吸附参考线（拖动/缩放时的对齐辅助线）
+  - `showPosition: boolean` 是否显示元素坐标提示（移动元素时显示位置）
+  - `showSizeBox: boolean` 是否显示元素尺寸提示框（缩放时显示宽高）
+  - `adsorbMin: number` 吸附阈值（距离小于等于该值时触发吸附，单位：pt）
+  - `adsorbLineMin: number` 吸附线阈值（参考线判定阈值，单位：pt）
+- `design-options: object` 设计器 UI/行为配置（初始化时生效）：
+  - `grid: boolean` 是否显示网格线，默认 `true`
+  - `activePanel: boolean` 是否默认显示右侧属性面板，默认 `true`
+  - `adaptToSize: boolean` 是否初始化时自动缩放以适配设计区可视范围，默认 `false`
+- `theme: string | object` 主题；支持内置主题名或传入自定义主题对象
+- `theme-list: Array<string | object>` 主题列表（用于顶部主题切换菜单），默认：`light/dark/emerald/corporate/bumblebee/retro/cyberpunk/valentine`
+- `show-option: object` 区域显示控制（默认全部显示）：
+  - `showHeader: boolean` 是否显示顶部 Header，默认 `true`
+  - `showToolbar: boolean` 是否显示二级工具栏 Toolbar，默认 `true`
+  - `showFooter: boolean` 是否显示底部 Footer，默认 `true`
+- `footer-text: string` 底部默认文案（仅在未提供 `#footer` 插槽时展示）
 
 以上属性支持运行时动态修改；组件内部已监听并应用。
 
+示例（FullDesigner 直接传入 config / designOptions）：
+
+```vue
+<template>
+  <FullDesigner
+    :config="{ showAdsorbLine: true, showPosition: true, showSizeBox: true }"
+    :design-options="{ grid: true, activePanel: true, adaptToSize: true }"
+    theme="light"
+    :show-option="{ showHeader: true, showToolbar: true, showFooter: true }"
+    footer-text="联系我：xxxx（这里可写联系信息）"
+  />
+</template>
+```
+
+示例（主题切换：限制可选主题 + 自定义主题）：
+
+```vue
+<template>
+  <FullDesigner
+    :theme-list="[
+      'light',
+      'dark',
+      { name: '自定义1', colors: { accent: '#16a34a', headerBg: '#16a34a', toolbarBg: '#f0fdf4' } }
+    ]"
+    :theme="{ name: '自定义1', colors: { accent: '#16a34a', headerBg: '#16a34a', toolbarBg: '#f0fdf4' } }"
+  />
+</template>
+```
+
+自定义主题颜色字段说明（`theme.colors`）：
+- `accent: string` 主题强调色（影响：滚动条、选中态边框/高亮、部分 hover）
+- `accentSoft: string` 强调色浅背景（可选，建议 `rgba`；用于选中态/hover 底色，默认由 `accent` 自动生成）
+- `headerBg: string` Header/面板标题栏背景色（属性/结构/历史面板的标题栏也会使用）
+- `headerText: string` Header/面板标题栏文字颜色
+- `toolbarBg: string` 二级工具栏背景色
+- `panelBg: string` 左侧模板面板背景色（不传则默认跟随 `toolbarBg`）
+- `surfaceBg: string` 面板/弹窗主体背景色（属性/结构/历史面板、右键菜单等）
+- `text: string` 主文字颜色
+- `mutedText: string` 次级文字颜色（列表辅助信息、提示文字等）
+- `border: string` 边框/分割线颜色
+- `menuBg: string` 右键菜单背景色（可选，默认跟随 `surfaceBg`）
+- `menuHoverBg: string` 菜单 hover 背景色（可选）
+- `footerBg: string` Footer 背景色（可选，默认跟随 `surfaceBg`）
+- `footerText: string` Footer 文字颜色（可选，默认跟随 `mutedText`）
+
+示例（自定义 Footer 内容）：
+
+```vue
+<template>
+  <FullDesigner :show-option="{ showFooter: true }">
+    <template #footer>
+      <div style="width:100%;display:flex;justify-content:space-between;">
+        <span>联系信息：xxx</span>
+        <span>QQ群：xxx</span>
+      </div>
+    </template>
+  </FullDesigner>
+</template>
+```
+
 ### 方法（通过组件 ref 调用，含描述）
 
 - `preView()` 打开预览弹窗；将当前模板与数据渲染为预览 HTML

package/dist/{chunk-MW6X4KTL-C8cwO-x-.js → chunk-MW6X4KTL-GVLDlfm-.js}

@@ -1,4 +1,4 @@
-import { l as b } from "./index-BWjndjtC.js";
+import { l as b } from "./index-CgtNzzAs.js";
 function M(e) {
   return typeof e == "string" && /^data:image\/svg\+xml/i.test(e);
 }

package/dist/{chunk-Q2Z2CG2I-DXJ60XH6.js → chunk-Q2Z2CG2I-O7yXBUWS.js}

@@ -1,4 +1,4 @@
-import { W as a } from "./chunk-MW6X4KTL-C8cwO-x-.js";
+import { W as a } from "./chunk-MW6X4KTL-GVLDlfm-.js";
 async function o(r, t) {
   let i = await a(r, t), e = new Image();
   return e.src = i.toDataURL(`image/${t.format}`, t.quality), await e.decode(), e.style.width = `${i.width / t.dpr}px`, e.style.height = `${i.height / t.dpr}px`, e;

package/dist/{chunk-Y7FY32AO-DW7C-SwH.js → chunk-Y7FY32AO-CZEm3zsQ.js}

@@ -1,4 +1,4 @@
-import { W as m } from "./chunk-MW6X4KTL-C8cwO-x-.js";
+import { W as m } from "./chunk-MW6X4KTL-GVLDlfm-.js";
 async function a(n, e) {
   let o = e.type;
   if (o === "svg") {

package/dist/{download-CosvZHgX.js → download-CIEkuVJE.js}

@@ -1,5 +1,5 @@
-import { m as f } from "./chunk-Y7FY32AO-DW7C-SwH.js";
-import { W as t } from "./chunk-MW6X4KTL-C8cwO-x-.js";
+import { m as f } from "./chunk-Y7FY32AO-CZEm3zsQ.js";
+import { W as t } from "./chunk-MW6X4KTL-GVLDlfm-.js";
 async function w(n, e) {
   let c = ((e == null ? void 0 : e.format) || (e == null ? void 0 : e.type) || "").toLowerCase(), a = c === "jpg" ? "jpeg" : c || "png", i = (e == null ? void 0 : e.filename) || `snapdom.${a}`, o = { ...e || {}, format: a, type: a };
   if (o.dpr = 1, a === "svg") {