@worm-vue3-print/common 1.3.7-beta.0 → 1.4.0

package/dist/print-designer.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
@@ -34,9 +34,9 @@ export declare class PrintDesignerElement extends HTMLElement {
     private unmountHelp;
     private drag;
     private snapTimer;
-    /** 页签 tooltip：挂在 shadow root 上的浮层（canvas 的 .page-tabs-tip 等价物） */
-    private pageTipEl;
-    private pageTipTimer;
+    /** 悬浮提示浮层：挂在 shadow root 上（canvas 的 useHoverTip / .pd-hover-tip 等价物） */
+    private hoverTipEl;
+    private hoverTipTimer;
     private resize;
     private raf;
     private lastSelKey;
@@ -79,6 +79,11 @@ export declare class PrintDesignerElement extends HTMLElement {
     save(): void;
     /** 拼版配置校验：getTemplateJson 是旁路，宿主导出/另存时需自行调用拦截 */
     validateTemplate(): import("@worm-vue3-print/core").TilingIssue[];
+    /**
+     * 出纸裁切提示（旋转外接盒顶越页首、元素超出纸面左右缘），与 canvas 同名同口径。
+     * 预估口径：编辑期无实测高，自适应行高按设计盒估算 ⇒ 只提示、不阻断保存。
+     */
+    getGeometryWarnings(): string[];
     private applyTemplate;
     private openExpression;
     private closeExpression;
@@ -163,8 +168,8 @@ export declare class PrintDesignerElement extends HTMLElement {
     private onWheel;
     private onScroll;
     private bindPointer;
-    private showPageTip;
-    private hidePageTip;
+    private showHoverTip;
+    private hideHoverTip;
     private manualGuides;
     /** 仅重绘吸附引导线，避免拖拽中全量重建 DOM */
     private paintGuidesOnly;

package/dist/shell/binding.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/canvas.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/code.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/color-picker.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/controls.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
@@ -50,7 +50,8 @@ export interface ShellCtx {
     host: {
         uploadImage?: (file: File) => Promise<string>;
         uploadDesignBackground?: (file: File) => Promise<string>;
-        fonts?: readonly (string | PrintFontDeclaration)[];
+        /** 模板级字体声明，与 canvas 的 PrintDesigner `fonts` prop 同类型（裸字符串族名不参与候选，与画布一致） */
+        fonts?: readonly PrintFontDeclaration[];
     };
 }
 /** 带图标的工具栏按钮（对应 canvas 的 .tb-btn.tb-icon） */
@@ -82,12 +83,35 @@ export declare function stepper(opts: {
     disabled?: boolean;
     onCommit: (v: number) => void;
 }): import("../core/h").El;
-/** 属性行：pd-field > pd-label + 控件 */
-export declare function field(label: string, control: unknown, hint?: string): import("../core/h").El;
+/** 属性行：pd-field > pd-label(.pd-label-t + 恢复默认值) + 控件 */
+export declare function field(label: string, control: unknown, hint?: string, reset?: unknown): import("../core/h").El;
 /** 字段说明图标：说明不常驻行内，悬浮或点击聚焦时才浮出（对应 canvas 的 button.pd-help） */
 export declare const labelHelp: (tip: string) => import("../core/h").El;
 /** 带说明图标的属性行：与 field() 同结构，差别只在说明挂图标而非常驻 .pd-hint 段落 */
-export declare function fieldHelp(label: string, control: unknown, tip: string): import("../core/h").El;
+export declare function fieldHelp(label: string, control: unknown, tip: string, reset?: unknown): import("../core/h").El;
+/**
+ * 「恢复默认值」按钮，与 canvas 的 property/ResetButton.vue 逐字同构。
+ * 落点派生自 base[propKey]：判据一律 === 比出厂值，base 里取到 undefined 即「未设」，
+ * 写回它天然等于删键。0 与 undefined 是两个状态，不得用 ?? / || 归并。
+ * 外壳是全量重绘模型，灰/亮在构造时求值即可，不需要响应式。
+ * 按钮不带任何文本子节点——属性搜索按 .pd-label 的 textContent 匹配，写字会污染命中。
+ */
+export declare function resetButton(o: {
+    target: Record<string, any>;
+    base: Record<string, any>;
+    propKey: string;
+    /** 提示语数值：仅用于文案，不参与判定 */
+    tipValue?: number | string;
+    tipUnit?: string;
+    /** 覆盖整条提示（单元格级固定用「跟随表格默认」，回落目标是该表自己的默认） */
+    tipOverride?: string;
+    /** 覆盖写回通道：单元格组必须整选区恢复，不能让按钮只改当前展示的那一个 cell 对象 */
+    write?: (value: any) => void;
+    /** 写回后的收尾（重绘 / 记历史）；不提供时只改对象 */
+    onReset?: () => void;
+    /** 多选批量档：不显示"已改"脏点（判据取自单格会误导），但按钮恒可点，写回整选区 */
+    force?: boolean;
+}): import("../core/h").El;
 /** 分节标题（对应 canvas 的 h3.pd-divider） */
 export declare const divider: (text: string) => import("../core/h").El;
 /** 颜色触发钮：预设色板面板（移植 canvas 的 PresetColorPicker.vue，面板实现见 shell/color-picker.ts）。
@@ -99,3 +123,16 @@ export declare function radioGroup(name: string, options: {
     value: string;
     label: string;
 }[], current: string, onChange: (v: string) => void, twoCol?: boolean): import("../core/h").El;
+/**
+ * 裸下拉（无 label 包裹，用于 .border-style-row 这类横向控件行）。
+ * 不能只靠 <option selected> 属性：happy-dom/部分内核在"首项未选中、第三项选中"时会回落到第二项，
+ * 必须建真节点后显式 select.value = 当前值（与 selectField 同一套可靠赋值）。
+ */
+export declare function plainSelect(value: string, options: {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}[], onChange: (v: string) => void, attrs?: {
+    className?: string;
+    width?: string;
+}): HTMLSelectElement;

package/dist/shell/crop-anchor.d.ts

@@ -0,0 +1,29 @@
+/*!
+ * @worm-vue3-print/common v1.4.0
+ * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-License-Identifier: MIT
+ */
+import type { ShellCtx } from './controls';
+export interface CropAnchorOpts {
+    fieldKey: string;
+    label: string;
+    /** 容器类名：canvas 只在单元格台包一层 `pd-cell-anchor`（`TableCellGroup.vue`），元素台没有包层；缺省沿用本包 `pd-crop-anchor` */
+    containerClass?: string;
+    /** 已解析的图片地址（表达式由宿主求值后传入）；为空则回落内置示例图 */
+    src: string;
+    widthMm: number;
+    heightMm: number;
+    /** 缩放模式（CSS object-fit 原值，缺省按 contain）：可挪余量按它逐轴结算 */
+    fit?: string;
+    /** 剪裁放大比例（%）：只有 cover 消费，铺满后把画面再推大这么多 */
+    scale?: number;
+    /** 行尾「恢复默认值」图标：落点由宿主按所在层构造（元素级派生出厂值、单元格级删自身值），
+     *  本组件只负责把它摆进标签行右端，与 canvas 的 CropAnchorField 同一 DOM 结构 */
+    resetAnchor?: unknown;
+    resetScale?: unknown;
+    value?: string;
+    onCommit: (value: string | undefined) => void;
+    onScaleCommit: (value: number | undefined) => void;
+}
+export declare function cropAnchorField(ctx: ShellCtx, o: CropAnchorOpts): import("../core/h").El;

package/dist/shell/elements.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
@@ -8,7 +8,7 @@ import { mmToPx } from '@worm-vue3-print/core/designer';
 import type { RuntimeElement } from '@worm-vue3-print/core/designer';
 import type { ShellCtx } from './controls';
 /** 元素几何与边框（对齐 BaseElement.elementStyle） */
-export declare function elementStyle(el: RuntimeElement): Record<string, string>;
+export declare function elementStyle(el: RuntimeElement, followMemberIds?: Set<string>): Record<string, string>;
 /** 文本与长文本共用的行内样式：与 canvas 的 TextElement / LongTextElement 逐项一致（差异按类型分支） */
 export declare function textLikeStyle(el: RuntimeElement): {
     style: Record<string, string>;
@@ -22,6 +22,6 @@ export declare function positionLabel(o: {
     width: number;
     height: number;
 }): string;
-export declare function renderDesignElement(ctx: ShellCtx, el: RuntimeElement): import("../core/h").El;
+export declare function renderDesignElement(ctx: ShellCtx, el: RuntimeElement, followMemberIds?: Set<string>): import("../core/h").El;
 /** mm → px（供画布几何换算复用同一口径） */
 export { mmToPx };

package/dist/shell/expression-editor.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/flow-list.d.ts

@@ -0,0 +1,11 @@
+/*!
+ * @worm-vue3-print/common v1.4.0
+ * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-License-Identifier: MIT
+ */
+import type { RuntimeElement } from '@worm-vue3-print/core/designer';
+/** 与 canvas FlowListElement 的 DESIGN_FALLBACK_ITEMS 逐字一致：新拖入的元素也要看得见形状 */
+export declare const FLOW_LIST_DEMO_ITEMS: string[];
+export declare function flowListCells(el: RuntimeElement, data?: Record<string, any>[]): string[];
+export declare function renderFlowListElement(el: RuntimeElement, data?: Record<string, any>[]): import("../core/h").El;

package/dist/shell/font-select.d.ts

@@ -1,18 +1,18 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
  */
-import type { FontOption } from '../core/font-catalog';
+import type { FontCatalogOption, PrintFontDeclaration } from '@worm-vue3-print/core';
 import type { ShellState } from './controls';
 export interface FontSelectOptions {
     /** 实例标识：同一时刻只允许一个字体下拉处于展开态 */
     id: string;
     /** 外壳状态：展开态落在这里，跨重绘保持 */
     state: ShellState;
-    /** 宿主注入的字体清单（字符串或字体声明均可） */
-    fonts?: readonly (string | FontOption)[];
+    /** 宿主注入的字体清单：条目须是字体声明（family/label，`files` 由宿主侧携带），裸字符串不进候选——与画布同一判据 */
+    fonts?: readonly (FontCatalogOption | PrintFontDeclaration | null | undefined)[];
     /** 当前族名；undefined 表示未设置，走全局兜底字体栈 */
     value?: string;
     /** 空值行文案（同时用作输入框 placeholder） */

package/dist/shell/format-bar.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/help-content/changelog.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/help-content/faq.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/help-content/features.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/help-content/getting-started.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/help-content/index.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/help-content/shortcuts.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/help-modal.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/page-extras.d.ts

@@ -1,10 +1,11 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
  */
+import type { El } from '../core/h';
 import type { ShellCtx } from './controls';
-export declare function designBackgroundSection(ctx: ShellCtx): import("../core/h").El;
+export declare function designBackgroundSection(ctx: ShellCtx): El;
 /** 拼版打印：开关 + 目标纸 + 留白 + 间距列数 + 校验与摘要 */
-export declare function tilingSection(ctx: ShellCtx): import("../core/h").El;
+export declare function tilingSection(ctx: ShellCtx): El;

package/dist/shell/panels.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/prop-group.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/property-panel.d.ts

@@ -1,14 +1,15 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
  */
+import type { El } from '../core/h';
 import type { ShellCtx } from './controls';
 /** 下拉属性行 */
 /** 下拉属性行（导出仅供单测断言未设置态，包公开入口不导出） */
 export declare function selectField(_ctx: ShellCtx, label: string, value: string, options: {
     value: string;
     label: string;
-}[], onCommit: (v: string) => void, tip?: string): import("../core/h").El;
-export declare function renderPropertyPanel(ctx: ShellCtx): import("../core/h").El;
+}[], onCommit: (v: string) => void, tip?: string, reset?: El): El;
+export declare function renderPropertyPanel(ctx: ShellCtx): El;

package/dist/shell/property-search.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/ruler.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/table-props.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/table.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/toolbar-overflow.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/toolbar.d.ts

@@ -1,5 +1,5 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT

package/dist/shell/watermark.d.ts

@@ -1,10 +1,11 @@
 /*!
- * @worm-vue3-print/common v1.3.7-beta.0
+ * @worm-vue3-print/common v1.4.0
  * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
  * SPDX-License-Identifier: MIT
  */
+import type { El } from '../core/h';
 import type { ShellCtx } from './controls';
 /** 与 canvas 的 isExpressionText 同判定：花括号 / 函数调用 / 字段路径视为表达式 */
 export declare function isExpressionText(text: string): boolean;
-export declare function watermarkSection(ctx: ShellCtx): import("../core/h").El;
+export declare function watermarkSection(ctx: ShellCtx): El;

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@worm-vue3-print/common",
-  "version": "1.3.7-beta.0",
+  "version": "1.4.0",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
   "type": "module",
-  "description": "【预览版 · 实验性，不建议用于生产】打印模板设计器的通用宿主适配包：任意框架或无框架宿主均可直接接入（实现为零框架原生 Custom Elements + Shadow DOM），零 Vue/React 依赖，直接消费 @worm-vue3-print/core；Vue 3 项目请使用 @worm-vue3-print/canvas",
+  "description": "【实验性，不建议用于生产】打印模板设计器的通用宿主适配包：任意框架或无框架宿主均可直接接入（实现为零框架原生 Custom Elements + Shadow DOM），零 Vue/React 依赖，直接消费 @worm-vue3-print/core；Vue 3 项目请使用 @worm-vue3-print/canvas",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -44,7 +48,7 @@
     "test": "npm run styles && vitest run"
   },
   "dependencies": {
-    "@worm-vue3-print/core": "^1.3.7",
+    "@worm-vue3-print/core": "^1.4.0",
     "dompurify": "^3.4.12",
     "jsbarcode": "^3.12.3",
     "qrcode": "^1.5.4"

package/dist/core/font-catalog.d.ts

@@ -1,30 +0,0 @@
-/*!
- * @worm-vue3-print/common v1.3.7-beta.0
- * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
- * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
- * SPDX-License-Identifier: MIT
- */
-/** 下拉候选项：family 写入模板，label 仅用于界面展示 */
-export interface FontOption {
-    family: string;
-    label?: string;
-}
-/** 宿主清单条目：字符串族名，或带 label 的声明（core 的 PrintFontDeclaration 结构兼容） */
-export type FontSource = string | FontOption | null | undefined;
-/**
- * 把宿主注入的字体清单整理为下拉候选项：去空白、丢空值、族名大小写不敏感去重，
- * 保留声明顺序（顺序即宿主期望的优先级）。
- */
-export declare function buildFontCatalog(sources?: readonly FontSource[] | null): readonly FontOption[];
-/** 在目录中按族名查找（大小写不敏感） */
-export declare function findFontOption(fonts: readonly FontOption[], family?: string): FontOption | undefined;
-/** 下拉选项文案：有展示名时补上真实族名（写入模板的值） */
-export declare function fontOptionLabel(option: FontOption): string;
-/** 匹配用键：小写并去掉全部空白，使用户输入 `ya hei` 与 `yahei` 等价 */
-export declare function normalizeFontQuery(value: string): string;
-/**
- * 模糊过滤字体目录：完全相等 > 前缀 > 子串 > 子序列，同档保持目录原有顺序
- * （目录顺序由宿主声明决定，过滤不应打乱）。
- * 族名与展示名（label）都参与匹配，设计者按业务名搜也能命中。
- */
-export declare function filterFontOptions(fonts: readonly FontOption[], query: string): FontOption[];