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

package/dist/core/default-template.d.ts

@@ -0,0 +1,9 @@
+/*!
+ * @worm-vue3-print/common v1.4.0-beta.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 { TemplateData } from '@worm-vue3-print/core/designer';
+/** 默认模板：与 canvas 的 createDefaultTemplate 同结构，保证两侧序列化一致 */
+export declare function createDefaultTemplate(): TemplateData;

package/dist/core/format.d.ts

@@ -0,0 +1,122 @@
+/*!
+ * @worm-vue3-print/common v1.4.0-beta.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, type ElementBorderSpec } from '@worm-vue3-print/core/designer';
+import type { DesignerStore } from './store';
+/** 多选目标间字段值不一致的哨兵 */
+export declare const MIXED: unique symbol;
+export type MixedOr<T> = T | typeof MIXED;
+/** 支持字体/对齐等文本样式的元素类型（与 AppearanceGroup 的 isTextType 口径一致） */
+export declare const TEXT_TYPES: Set<string>;
+export interface FormatStylePatch {
+    fontFamily?: string;
+    fontSize?: number;
+    color?: string;
+    backgroundColor?: string;
+    textAlign?: TextAlign;
+    verticalAlign?: VerticalAlign;
+}
+/** 元素边框规格：类型与写入口径都在 core，本包不再自造一份 */
+export type { ElementBorderSpec };
+type BorderSide = 'top' | 'right' | 'bottom' | 'left';
+export declare class FormatToolbar {
+    private store;
+    /** 线型草稿：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;
+    private painterSnapshot;
+    constructor(store: DesignerStore);
+    private get selectedElements();
+    private get tableElement();
+    get context(): 'none' | 'cells' | 'elements';
+    /** 选区内的可写单元格（跳过被合并占位格） */
+    private get targetCells();
+    /** 字体/字号/颜色/对齐仅对文本类元素生效 */
+    private get textTargets();
+    get fontEditable(): boolean;
+    /** 文本类写入目标：单元格上下文为选区单元格，元素上下文为文本类选中元素 */
+    private get styleTargets();
+    private pick;
+    private hasToken;
+    get values(): {
+        fontFamily?: MixedOr<string>;
+        fontSize?: MixedOr<number>;
+        color?: MixedOr<string>;
+        backgroundColor?: MixedOr<string>;
+        textAlign?: MixedOr<TextAlign>;
+        verticalAlign?: MixedOr<VerticalAlign>;
+        bold: MixedOr<boolean>;
+        underline: MixedOr<boolean>;
+        strike: MixedOr<boolean>;
+    };
+    /** 落历史并通知视图（时机与 Vue 版 recordHistory 调用点一一对应） */
+    private commit;
+    private writeCells;
+    applyStyle(patch: FormatStylePatch): void;
+    toggleBold(): void;
+    private toggleDecoration;
+    toggleUnderline(): void;
+    toggleStrike(): void;
+    /**
+     * 单元格上下文的三行回读：单格取该格真实规格（四边不一致的字段留空并标 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;
+    /** 单元格选区四边激活态（WPS 式单边按钮的按下态）；非单元格上下文或选区为空为 null */
+    get cellEdges(): Record<BorderSide, MixedOr<boolean>> | null;
+    /** 单边切换：未全有则补齐该边，全有再点则移除该边（与 Word/WPS 一致） */
+    private toggleCellEdge;
+    /** 元素选中集的分边激活态：看「这条边到底有没有线」（整圈生效＝四边都有），与属性台勾选框同一判据 */
+    get elementEdges(): Record<BorderSide, MixedOr<boolean>> | null;
+    /** 元素分边切换：勾上用面板草稿；整圈生效时撤一边会把其余三边展开成分边 */
+    private toggleElementEdge;
+    /** 边框预设（Vue 版组件 onPreset 的路由口径）：单元格上下文走表格预设，否则走元素整圈 */
+    applyBorderPreset(preset: BorderPreset): void;
+    /** 单边按钮（Vue 版组件 onEdge 的路由口径）：按上下文落到单元格边或元素分边 */
+    applyEdge(side: BorderSide): void;
+    /** 撤掉一条边（线型＝无时工具栏的单边走这条）：整圈生效时其余三边展开成单边 */
+    private clearElementEdge;
+    /** 单边按下态（Vue 版组件 edgeOn 口径） */
+    edgeOn(side: BorderSide): boolean;
+    /** 仅选中单个未锁定元素时可作为格式源 */
+    get painterCapturable(): boolean;
+    private clonePainterBorders;
+    /** 从当前唯一选中元素捕获格式并进入刷取模式；locked=true 为双击连续刷 */
+    pickPainterSource(nextLocked?: boolean): boolean;
+    cancelPainter(): void;
+    /** 按目标类型过滤写入；backgroundColor 全类型通用，与格式工具栏口径一致 */
+    applyPainter(el: RuntimeElement): boolean;
+    /** Vue 版 watch(selectedIds) 的等价入口：shell 在选中集变化后调用；单击模式刷一次即退出 */
+    painterSyncSelection(): void;
+    /** Esc 退出连续刷：shell 绑定 keydown 后转发（输入控件聚焦时忽略，与 Vue 版一致） */
+    handlePainterKeydown(e: KeyboardEvent): void;
+}

package/dist/core/h.d.ts

@@ -0,0 +1,22 @@
+/*!
+ * @worm-vue3-print/common v1.4.0-beta.0
+ * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-License-Identifier: MIT
+ */
+export type AttrValue = string | number | boolean | null | undefined;
+export interface Child {
+    node: Node;
+}
+export interface El {
+    tag: string;
+    props: Record<string, unknown>;
+    children: unknown[];
+}
+/** h('div', { class, style, onClick, html, ... }, [...]) */
+export declare function h(tag: string, props?: Record<string, unknown>, children?: unknown[]): El;
+export declare function render(node: El | string | Node, parent: Element | ShadowRoot): Element | Text;
+/** 清空容器（重渲染前调用） */
+export declare function clear(node: Element | ShadowRoot): void;
+export declare function mm(v: number): string;
+export declare const SVG_NS_CONST = "http://www.w3.org/2000/svg";

package/dist/core/icons.d.ts

@@ -0,0 +1,10 @@
+/*!
+ * @worm-vue3-print/common v1.4.0-beta.0
+ * Copyright (c) 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-FileCopyrightText: 2026 worm <liu_long_qqcom@qq.com>
+ * SPDX-License-Identifier: MIT
+ */
+/** lucide 图标内部 SVG 片段（viewBox 固定 0 0 24 24，stroke 走 currentColor） */
+export declare const ICONS: Record<string, string>;
+/** 生成图标 SVG 字符串；未知图标名返回空串（调用方按文本兜底）。cls 对应 canvas 里挂在 lucide 组件上的 class */
+export declare function iconSvg(name: string, size?: number, cls?: string): string;

package/dist/core/store.d.ts

@@ -0,0 +1,163 @@
+/*!
+ * @worm-vue3-print/common v1.4.0-beta.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 { AlignLine, AlignMode, MultiPageTemplateData, PrintBusinessField, RuntimeElement, TableSelection, TemplateData } from '@worm-vue3-print/core/designer';
+import { createRuntimeElement } from '@worm-vue3-print/core/designer';
+/** 拼版模板只允许单页：增页入口被拦截时的提示文案（与 canvas 同口径） */
+export declare const TILING_SINGLE_PAGE_TIP = "\u5F00\u542F\u62FC\u7248\u540E\u53EA\u80FD\u6709\u4E00\u4E2A\u8BBE\u8BA1\u9875\u9762";
+/** 纸面 mm 落点（与 canvas 的 toPaperPoint 同口径，原点为纸张左上角） */
+export interface PaperPoint {
+    x: number;
+    y: number;
+}
+export interface DesignerOptions {
+    initialTemplate?: TemplateData | MultiPageTemplateData;
+    initialElements?: RuntimeElement[];
+    initialFields?: PrintBusinessField[];
+}
+/** 把三区模板摊平为统一运行时元素池（补 id、打 zone 标） */
+export declare function toRuntimePool(data: TemplateData): TemplateData;
+/** 单页运行时池序列化回三区模板 JSON（按 zone 拆回，补 id/type） */
+export declare function serializePage(page: TemplateData): TemplateData;
+/**
+ * 设计器状态容器。
+ * 视图层通过 subscribe 收到「结构性变更」通知；高频拖拽走 livePatch 直改 + 定点重绘，
+ * 避免每个 mousemove 都全量重渲染（canvas 侧靠 Vue 细粒度响应式，这里显式区分）。
+ */
+export declare class DesignerStore {
+    scale: number;
+    showRuler: boolean;
+    showGrid: boolean;
+    snapToGrid: boolean;
+    showTableGhostBorder: boolean;
+    dirty: boolean;
+    pages: TemplateData[];
+    activePageIndex: number;
+    fields: PrintBusinessField[];
+    selectedIds: Set<string>;
+    previewIds: Set<string>;
+    tableSelection: TableSelection | null;
+    /** 正在拖拽的元素 id：对应 canvas BaseElement 的 useDrag isDragging，驱动 `.drag-ghost` + `.drag-preview` */
+    draggingIds: Set<string>;
+    /** 拖拽吸附生成的临时引导线，仅存在于一次拖拽期间（与 canvas 的 guideLines 同语义） */
+    adsorbGuides: AlignLine[];
+    /** 拖拽/缩放进行中的实时元素覆盖，不落历史 */
+    private live;
+    private clipboard;
+    private moveSessionActive;
+    private moveTimer;
+    private dragBefore;
+    private undoStack;
+    private redoStack;
+    private listeners;
+    private readonly align;
+    private readonly group;
+    constructor(opts?: DesignerOptions);
+    subscribe(fn: () => void): () => void;
+    /** 结构性变更后调用：通知视图重渲染并置 dirty */
+    emit(markDirty?: boolean): void;
+    get templateData(): TemplateData;
+    set templateData(v: TemplateData);
+    get elements(): RuntimeElement[];
+    get tilingEnabled(): boolean;
+    switchPage(i: number): void;
+    addPage(): void;
+    /** 默认页名跳过已占用的编号（对应 canvas nextDefaultPageName） */
+    private nextDefaultPageName;
+    duplicatePage(i: number): void;
+    deletePage(i: number): void;
+    renamePage(i: number, name: string): void;
+    movePage(from: number, to: number): void;
+    /**
+     * 选中集变化的副作用钩子（shell 在初始化时挂上）：
+     * 对应 canvas `useFormatPainter` 里的 `watch(selectedIds)` —— 格式刷是以「选中集变化」为触发点的，
+     * 点击选中、框选、图层面板选中都走这一条路径，不能只在拖拽收尾时同步。
+     */
+    onSelectionChanged?: () => void;
+    private setSelection;
+    select(ids: Set<string>): void;
+    selectOne(id: string, additive?: boolean): void;
+    clearSelection(): void;
+    /**
+     * 画布/图层「单击选中」：对应 canvas useDesignerState 的 selectElement。
+     * · Ctrl/Cmd 点击 = 增删单个成员（canvas 的 select(id, true)）
+     * · 普通点击 = 整组选中（canvas 的 getGroupedIds），组内成员被点中即选中全组
+     */
+    selectElement(id: string, multiple?: boolean): void;
+    selectAll(): void;
+    get selectedElements(): RuntimeElement[];
+    get selectedElement(): RuntimeElement | null;
+    resetSelection(): void;
+    setTableSelection(s: TableSelection | null): void;
+    setPreview(ids: Set<string>): void;
+    commitPreview(): void;
+    addGuide(type: 'vertical' | 'horizontal', positionMm: number): void;
+    moveGuide(id: string, positionMm: number): void;
+    removeGuide(id: string): void;
+    addElement(type: Parameters<typeof createRuntimeElement>[0], options?: Partial<RuntimeElement['options']>, dropPoint?: PaperPoint): RuntimeElement;
+    addFieldElement(field: PrintBusinessField, options?: Partial<RuntimeElement['options']>, dropPoint?: PaperPoint): RuntimeElement;
+    /**
+     * 按落点把新元素放进对应区域（canvas 的 placeAtDropPoint）：
+     * dropPoint 为纸面 mm；页眉/页脚不允许的类型返回 false（调用方不加入元素）。
+     */
+    private placeAtDropPoint;
+    deleteSelected(): void;
+    /** 拖拽/缩放过程中的实时值：只进 live 层，不落历史也不触发全量重渲染 */
+    livePatch(id: string, patch: Partial<RuntimeElement['options']>): void;
+    /** 交互结束：把 live 层落回元素并记一条历史（与 canvas 的「一次拖拽一条记录」同口径） */
+    commitLive(): void;
+    /** 拖拽跟手集合（对应 canvas BaseElement：主元素 + 同组元素，不含其它选中项） */
+    dragIds(id: string): string[];
+    /** 丢弃 live 层（Alt+拖拽：canvas 拖拽期间从不写响应式坐标，副本落在落点、原元素回原位） */
+    discardLive(): void;
+    /**
+     * 拖拽/缩放开始快照（对应 canvas 的 dragStart）：dragStop 用它挑出几何变化的元素做归区收尾。
+     */
+    dragStart(): void;
+    /**
+     * 拖拽/缩放结束归区（对应 canvas 的 dragStop）：按元素中心点重判所在区，
+     * 跨区换算坐标并改写 zone、页眉页脚内 clamp；类型不允许跨入则退回内容区并提示。
+     */
+    dragStop(): void;
+    private geoSig;
+    updateElement(id: string, patch: Partial<RuntimeElement['options']>, record?: boolean): void;
+    updateTemplateData(patch: Partial<TemplateData>): void;
+    moveLayer(mode: 'top' | 'bottom' | 'up' | 'down'): void;
+    alignSelected(mode: AlignMode): void;
+    groupSelected(): void;
+    ungroupSelected(): void;
+    copy(): void;
+    cutSelected(): void;
+    paste(offset?: number): void;
+    /** Ctrl+D 原地复制（对应 canvas duplicateSelected）：复用剪贴板，偏移 10+5 */
+    duplicateSelected(): void;
+    get hasClipboard(): boolean;
+    /**
+     * 方向键微移（对应 canvas moveSelected）：跳过锁定元素、不做 0 钳制（可移出纸面），
+     * 300ms 内的连按算一次历史会话。
+     */
+    moveSelected(dx: number, dy: number): void;
+    /** Alt+拖拽落点插入副本（对应 canvas PrintDesigner.onCloneElement）：push + 选中副本 + 一条历史 */
+    cloneElement(el: RuntimeElement): void;
+    recordHistory(): void;
+    get canUndo(): boolean;
+    get canRedo(): boolean;
+    undo(): void;
+    redo(): void;
+    /** Ctrl+1 重置缩放至 100%（对应 canvas resetZoom） */
+    resetZoom(): void;
+    /**
+     * 设置缩放百分比。canvas 只在「交互缩放」入口钳到 25%，适应窗口可到 5%，放大不设上限。
+     */
+    setScale(v: number, minPercent?: number): void;
+    getTemplateJson(): string;
+    loadTemplate(input: TemplateData | MultiPageTemplateData): void;
+    /** 当前纸张尺寸（mm），视图层算坐标要用 */
+    get paperSize(): {
+        width: number;
+        height: number;
+    };
+}