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

package/dist/core/default-template.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/core/format.d.ts

@@ -1,11 +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 { RuntimeElement, TextAlign, VerticalAlign, TableCellBorder } from '@worm-vue3-print/core/designer';
-import { type BorderPreset } from '@worm-vue3-print/core/designer';
+import { type BorderPreset, type ElementBorderSpec } from '@worm-vue3-print/core/designer';
 import type { DesignerStore } from './store';
 /** 多选目标间字段值不一致的哨兵 */
 export declare const MIXED: unique symbol;
@@ -20,17 +20,25 @@ export interface FormatStylePatch {
     textAlign?: TextAlign;
     verticalAlign?: VerticalAlign;
 }
-export interface ElementBorderSpec {
-    width: number;
-    style: string;
-    color: string;
-}
+/** 元素边框规格：类型与写入口径都在 core，本包不再自造一份 */
+export type { ElementBorderSpec };
 type BorderSide = 'top' | 'right' | 'bottom' | 'left';
 export declare class FormatToolbar {
     private store;
-    borderStyle: 'solid' | 'dashed' | 'dotted' | 'double';
-    borderWidth: number;
-    borderColor: string;
+    /** 线型草稿：null = 一个格式都没选中（线型＝无，点预设/单边即按「无」落盘） */
+    borderStyle: 'solid' | 'dashed' | 'dotted' | 'double' | null;
+    /** 多选/混合态允许留空；批写时按缺省档兜底 */
+    borderWidth: number | undefined;
+    borderColor: string | undefined;
+    /** 单元格四边规格不一致的字段：留空、不谎报；未选时批写按缺省档 */
+    borderMixed: {
+        style: boolean;
+        width: boolean;
+        color: boolean;
+    };
+    /** 最近一次已回读的单元格选区标识：只在新选区回填，避免每次重绘冲掉用户草稿 */
+    private borderDraftKey;
+    get borderMixedAny(): boolean;
     painterActive: boolean;
     painterLocked: boolean;
     painterSource: string | null;
@@ -67,8 +75,19 @@ export declare class FormatToolbar {
     private toggleDecoration;
     toggleUnderline(): void;
     toggleStrike(): void;
-    /** 当前面板草稿对应的边框规格（Vue 版组件内 borderSpec()） */
+    /**
+     * 单元格上下文的三行回读：单格取该格真实规格（四边不一致的字段留空并标 mixed）；
+     * 多选按上一轮口径不取单格，落缺省档作批写源。只在选区变化时回填，用户改草稿不会被打断。
+     */
+    syncBorderDraft(): void;
+    /** 当前面板草稿对应的边框规格（Vue 版组件内 borderSpec()）；混合/留空项按缺省档兜底 */
     borderSpec(): TableCellBorder;
+    setBorderWidth(v: number | undefined): void;
+    setBorderColor(v: string | undefined): void;
+    /** 单元格批写落盘后本次规格已统一：混合标记与留空项落定为实际写入值 */
+    private settleBorderDraft;
+    /** 再点已选中的线型＝取消该格式（图标全不亮＝线型无） */
+    toggleBorderStyle(key: 'solid' | 'dashed' | 'dotted' | 'double'): void;
     private applyElementBorder;
     private applyCellBorderPreset;
     private applyCellBorderEdges;
@@ -76,14 +95,16 @@ export declare class FormatToolbar {
     get cellEdges(): Record<BorderSide, MixedOr<boolean>> | null;
     /** 单边切换：未全有则补齐该边，全有再点则移除该边（与 Word/WPS 一致） */
     private toggleCellEdge;
-    /** 元素选中集的分边激活态（options.borders）；非元素上下文或无可选元素为 null */
+    /** 元素选中集的分边激活态：看「这条边到底有没有线」（整圈生效＝四边都有），与属性台勾选框同一判据 */
     get elementEdges(): Record<BorderSide, MixedOr<boolean>> | null;
-    /** 元素分边切换：写入/移除 options.borders[side]，不影响整圈三字段 */
+    /** 元素分边切换：勾上用面板草稿；整圈生效时撤一边会把其余三边展开成分边 */
     private toggleElementEdge;
     /** 边框预设（Vue 版组件 onPreset 的路由口径）：单元格上下文走表格预设，否则走元素整圈 */
     applyBorderPreset(preset: BorderPreset): void;
     /** 单边按钮（Vue 版组件 onEdge 的路由口径）：按上下文落到单元格边或元素分边 */
     applyEdge(side: BorderSide): void;
+    /** 撤掉一条边（线型＝无时工具栏的单边走这条）：整圈生效时其余三边展开成单边 */
+    private clearElementEdge;
     /** 单边按下态（Vue 版组件 edgeOn 口径） */
     edgeOn(side: BorderSide): boolean;
     /** 仅选中单个未锁定元素时可作为格式源 */
@@ -99,4 +120,3 @@ export declare class FormatToolbar {
     /** Esc 退出连续刷：shell 绑定 keydown 后转发（输入控件聚焦时忽略，与 Vue 版一致） */
     handlePainterKeydown(e: KeyboardEvent): void;
 }
-export {};

package/dist/core/h.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/core/icons.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/core/store.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