@worm-vue3-print/canvas 1.0.1

package/dist/composables/useDrag.d.ts

@@ -0,0 +1,51 @@
+import type { AdsorbResult } from '../types';
+export interface DragOptions {
+    axis?: 'x' | 'y';
+    disabled?: boolean;
+    getScale?: () => number;
+    /** 拖拽过程中每帧回调，提供修正后的绝对坐标（调用方用 transform 做视觉跟随） */
+    onDrag: (pos: {
+        left: number;
+        top: number;
+    }) => void;
+    /** 拖拽结束回调，提供最终坐标与修饰符信息（调用方一次性写入响应式数据） */
+    onDragEnd?: (pos: {
+        left: number;
+        top: number;
+    }, info: {
+        altKey: boolean;
+    }) => void;
+    onStart?: (info: {
+        altKey: boolean;
+    }) => void;
+    onStop?: () => void;
+    onAdsorb?: (pos: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    }) => AdsorbResult;
+}
+export declare function useDrag(target: {
+    value: HTMLElement | null;
+}, options: DragOptions): {
+    isDragging: import("vue").Ref<boolean, boolean>;
+    dragPreview: import("vue").Ref<{
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    } | null, {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    } | {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    } | null>;
+    setup: () => void;
+    cleanup: () => void;
+};

package/dist/composables/useGroup.d.ts

@@ -0,0 +1,7 @@
+import type { RuntimeElement } from '../types';
+export declare function generateGroupId(): string;
+export declare function useGroup(): {
+    group: (elements: RuntimeElement[], selectedIds: Set<string>) => RuntimeElement[];
+    ungroup: (elements: RuntimeElement[], selectedIds: Set<string>) => RuntimeElement[];
+    getGroupedIds: (elements: RuntimeElement[], selectedId: string) => Set<string>;
+};

package/dist/composables/useGuides.d.ts

@@ -0,0 +1,12 @@
+import { type Ref } from 'vue';
+import type { TemplateData, AlignLine } from '../types';
+export declare function useGuides(templateData: Ref<TemplateData>, recordHistory: () => void): {
+    guides: import("vue").ComputedRef<AlignLine[]>;
+    addGuide: (type: "vertical" | "horizontal", position: number) => void;
+    moveGuide: (id: string, position: number) => void;
+    removeGuide: (id: string) => void;
+    getGuidePositions: () => {
+        vertical: number[];
+        horizontal: number[];
+    };
+};

package/dist/composables/useHistory.d.ts

@@ -0,0 +1,31 @@
+import type { TemplateData } from '../types';
+export interface HistoryState {
+    elements: any[];
+    templateData?: TemplateData;
+}
+export interface UseHistoryOptions {
+    /** 历史记录上限，默认 50 步 */
+    maxSteps?: number;
+    /** 是否启用增量快照（减少内存占用），默认 false */
+    useIncremental?: boolean;
+}
+/**
+ * 撤销/重做历史管理（操作级快照粒度）。
+ *
+ * 语义说明：
+ * - `push(state)` 记录一次操作后的快照（检查点），并清空 redo 栈。
+ * - `undo(currentState?)` 弹出栈顶检查点（当前状态）压入 redo 栈，
+ *   返回新的栈顶（即上一个待恢复状态）；栈空时返回 null。
+ * - `redo(currentState?)` 弹出 redo 栈顶（待重做状态）压回 undo 栈并返回。
+ * - 所有快照均做 JSON 深拷贝，避免外部对象突变污染历史。
+ *
+ * 调用约定：若希望"撤销到初始状态"，应在首次操作前先 `push(initialState)`。
+ */
+export declare function useHistory(options?: UseHistoryOptions): {
+    push: (state: HistoryState) => void;
+    undo: (currentState?: HistoryState) => HistoryState | null;
+    redo: (currentState?: HistoryState) => HistoryState | null;
+    canUndo: import("vue").Ref<boolean, boolean>;
+    canRedo: import("vue").Ref<boolean, boolean>;
+    clear: () => void;
+};

package/dist/composables/useHostAdapter.d.ts

@@ -0,0 +1,4 @@
+import type { ComputedRef, InjectionKey } from 'vue';
+import type { UploadImageFn } from '../types';
+/** 图片上传适配器：PrintDesigner provide，ImageContentUpload inject */
+export declare const UPLOAD_IMAGE_KEY: InjectionKey<ComputedRef<UploadImageFn | undefined>>;

package/dist/composables/useKeyboard.d.ts

@@ -0,0 +1,22 @@
+export interface KeyboardHandlers {
+    onMove?: (dx: number, dy: number) => void;
+    onDelete?: () => void;
+    onCopy?: () => void;
+    onPaste?: () => void;
+    onSelectAll?: () => void;
+    onUndo?: () => void;
+    onRedo?: () => void;
+    onDuplicate?: () => void;
+    onResetZoom?: () => void;
+    onAlignLeft?: () => void;
+    onAlignRight?: () => void;
+    onAlignCenterH?: () => void;
+    onAlignTop?: () => void;
+    onAlignBottom?: () => void;
+    onGroup?: () => void;
+    onUngroup?: () => void;
+}
+export declare function useKeyboard(handlers: KeyboardHandlers): {
+    setup: () => void;
+    cleanup: () => void;
+};

package/dist/composables/useResize.d.ts

@@ -0,0 +1,26 @@
+import type { ResizePoint } from '../types';
+export interface ResizeRect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+export interface ResizeOptions {
+    minWidth?: number;
+    minHeight?: number;
+    getScale?: () => number;
+    /** 缩放起始时读取元素当前矩形（mm） */
+    getRect: () => ResizeRect;
+    onResize: (rect: ResizeRect) => void;
+    onStart?: () => void;
+    onStop?: () => void;
+}
+/** 8 方位缩放手柄，供模板 v-for 渲染 */
+export declare const RESIZE_POINTS: ResizePoint[];
+/** 根据方位与位移计算缩放后矩形（纯函数） */
+export declare function calcResizeRect(point: ResizePoint, startRect: ResizeRect, dx: number, dy: number, minW: number, minH: number): ResizeRect;
+/** 缩放交互逻辑：手柄由组件模板渲染，mousedown 时调用 startResize */
+export declare function useResize(options: ResizeOptions): {
+    startResize: (point: ResizePoint, e: MouseEvent) => void;
+    cleanup: () => void;
+};

package/dist/composables/useSelection.d.ts

@@ -0,0 +1,26 @@
+import { type InjectionKey, type Ref } from 'vue';
+import type { RuntimeElement } from '../types';
+/** 通过 provide/inject 共享选中状态，每个 BaseElement 精确追踪自身是否被选中 */
+export declare const SELECTED_IDS_KEY: InjectionKey<Ref<Set<string>>>;
+/** 框选实时预选状态：拖拽过程中高亮即将选中的元素，提交后转为正式选中 */
+export declare const PREVIEW_IDS_KEY: InjectionKey<Ref<Set<string>>>;
+export declare function useSelection(elements: {
+    value: RuntimeElement[];
+}): {
+    selectedIds: Ref<Set<string> & Omit<Set<string>, keyof Set<any>>, Set<string> | (Set<string> & Omit<Set<string>, keyof Set<any>>)>;
+    selectedElements: import("vue").ComputedRef<RuntimeElement[]>;
+    hasSelection: import("vue").ComputedRef<boolean>;
+    select: (id: string, multiple?: boolean) => void;
+    clearSelection: () => void;
+    selectAll: (allIds: string[]) => void;
+    getSelectionBounds: () => {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    } | null;
+    previewIds: Ref<Set<string> & Omit<Set<string>, keyof Set<any>>, Set<string> | (Set<string> & Omit<Set<string>, keyof Set<any>>)>;
+    setPreview: (ids: string[]) => void;
+    clearPreview: () => void;
+    commitPreview: () => void;
+};

package/dist/composables/useStudioChrome.d.ts

@@ -0,0 +1,8 @@
+export declare function useStudioChrome(): {
+    leftCollapsed: import("vue").Ref<boolean, boolean>;
+    rightCollapsed: import("vue").Ref<boolean, boolean>;
+    toggleLeft: () => void;
+    toggleRight: () => void;
+    dirty: import("vue").Ref<boolean, boolean>;
+    markSaved: () => void;
+};

package/dist/composables/useTableSelection.d.ts

@@ -0,0 +1,10 @@
+import type { InjectionKey, Ref } from 'vue';
+import type { TableSelection } from '../types';
+export interface TableEditContext {
+    tableSelection: Ref<TableSelection | null>;
+    setTableSelection: (s: TableSelection | null) => void;
+    recordHistory: () => void;
+    /** 页面打印范围宽度（mm）= 纸宽 - 左右边距，表格总列宽不得超过 */
+    maxTableWidth: Ref<number>;
+}
+export declare const TABLE_EDIT_KEY: InjectionKey<TableEditContext>;