@worm-vue3-print/canvas 1.1.0 → 1.2.1

package/dist/utils/ruler.d.ts

@@ -1,7 +1,29 @@
+/** 视口固定尺条厚度（px），CanvasArea 布局与左上角块共用 */
+export declare const RULER_THICKNESS = 22;
 export interface RulerTick {
+    /** 刻度在纸面坐标系上的位置（mm，可为负，表示纸张原点之外） */
     mm: number;
+    /** 是否为主刻度（带数字标签） */
     major: boolean;
     label?: string;
 }
-/** 生成标尺刻度：5mm 小刻度，10mm 大刻度 + 数字标签 */
-export declare function buildRulerTicks(lengthMM: number): RulerTick[];
+/**
+ * 按缩放选择主刻度步长（mm）：取漂亮数序列中使屏幕间距
+ * 不小于 targetPx 的最小步长，保证任意缩放下标签不重叠
+ * @param scale 画布缩放比例（1 = 100%）
+ * @param targetPx 主刻度之间的目标屏幕间距（px）
+ */
+export declare function chooseMajorStepMM(scale: number, targetPx?: number): number;
+/**
+ * 次刻度步长：5 系（5/50/500…）五等分、2 系（2/20/200…）二等分、
+ * 10 的幂从 10mm 起五等分（10→2mm、100→20mm），1mm 时无次刻度
+ */
+export declare function minorStepMM(majorStepMM: number): number | null;
+/**
+ * 生成可见毫米范围内的全部刻度（升序）：
+ * 从首个对齐的次刻度开始，主刻度带数字标签
+ * @param startMM 可见范围起点（纸面坐标，可为负）
+ * @param endMM 可见范围终点
+ * @param majorStepMM 主刻度步长（由 chooseMajorStepMM 选出）
+ */
+export declare function buildRulerTicks(startMM: number, endMM: number, majorStepMM: number): RulerTick[];

package/dist/utils/scale.d.ts

@@ -1,2 +1,15 @@
-/** 计算适应窗口的缩放百分比,clamp 到 [50,200] */
+/** 最小缩放百分比,低于此值画布难以查看与操作;放大方向不设上限 */
+export declare const MIN_SCALE_PERCENT = 25;
+/** 适应窗口时允许的最小缩放百分比（可低于交互缩放下限，保证超大纸张也能整版容纳） */
+export declare const FIT_SCALE_MIN_PERCENT = 5;
+/** 将缩放百分比钳制到允许范围:仅保留下限,放大不设上限 */
+export declare function clampScalePercent(percent: number): number;
+/**
+ * 滚轮缩放:乘性步进(默认 ×1.1 / ÷1.1),大倍数下仍保持平滑手感,
+ * 返回取整后的百分比,避免浮点累加产生脏显示(如 110.00000001)
+ * @param percent 当前缩放百分比
+ * @param direction 1 放大,-1 缩小
+ */
+export declare function nextWheelScale(percent: number, direction: 1 | -1, factor?: number): number;
+/** 计算适应窗口的缩放百分比,允许小于交互缩放下限,保证整版纸张可见 */
 export declare function computeFitScale(containerW: number, containerH: number, paperW: number, paperH: number, ratio?: number): number;

package/dist/utils/units.d.ts

@@ -2,3 +2,5 @@
 export declare function ptToMm(pt: number): number;
 /** px 转 mm（基于 96dpi 屏幕） */
 export declare function pxToMm(px: number): number;
+/** mm 转 px（基于 96dpi 屏幕） */
+export declare function mmToPx(mm: number): number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@worm-vue3-print/canvas",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "type": "module",
   "description": "Vue 3 可视化打印模板设计器画布（开源核心，无 Element Plus、无宿主业务依赖）",
   "main": "./dist/index.cjs",