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

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

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

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

@@ -0,0 +1,30 @@
+/*!
+ * @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[];

package/dist/core/format.d.ts

@@ -0,0 +1,102 @@
+/*!
+ * @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
+ */
+import type { RuntimeElement, TextAlign, VerticalAlign, TableCellBorder } from '@worm-vue3-print/core/designer';
+import { type BorderPreset } 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;
+}
+export interface ElementBorderSpec {
+    width: number;
+    style: string;
+    color: string;
+}
+type BorderSide = 'top' | 'right' | 'bottom' | 'left';
+export declare class FormatToolbar {
+    private store;
+    borderStyle: 'solid' | 'dashed' | 'dotted' | 'double';
+    borderWidth: number;
+    borderColor: string;
+    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;
+    /** 当前面板草稿对应的边框规格（Vue 版组件内 borderSpec()） */
+    borderSpec(): TableCellBorder;
+    private applyElementBorder;
+    private applyCellBorderPreset;
+    private applyCellBorderEdges;
+    /** 单元格选区四边激活态（WPS 式单边按钮的按下态）；非单元格上下文或选区为空为 null */
+    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;
+    /** 单边按下态（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;
+}
+export {};

package/dist/core/h.d.ts

@@ -0,0 +1,22 @@
+/*!
+ * @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
+ */
+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.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
+ */
+/** 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.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
+ */
+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;
+    };
+}