vislite 1.9.1 → 1.10.0

package/types/painterConfig.d.ts

@@ -1,5 +1,15 @@
+/**
+ * 绘图配置相关类型定义
+ * 定义了绘图相关的枚举类型
+ */
+
+/** 圆弧端点类型 */
 export type arcCapType = "butt" | "round" | "-round"
+/** 文字水平对齐方式 */
 export type textAlignType = "left" | "center" | "right"
+/** 文字垂直对齐方式 */
 export type textBaselineType = "top" | "middle" | "bottom"
+/** 线条端点类型 */
 export type lineCapType = "butt" | "round" | "square"
+/** 线条连接方式 */
 export type lineJoinType = "miter" | "bevel" | "round"

package/types/rotate.d.ts

@@ -1,6 +1,16 @@
 /**
- * 旋转
+ * 旋转变换函数类型定义
+ * 用于计算二维坐标系中的旋转变换
  */
 export default interface rotateType {
+    /**
+     * 计算旋转后的坐标
+     * @param cx 旋转中心的x坐标
+     * @param cy 旋转中心的y坐标
+     * @param deg 旋转角度（度）
+     * @param x 原始点的x坐标
+     * @param y 原始点的y坐标
+     * @returns 返回旋转后的坐标 [newX, newY]
+     */
     (cx: number, cy: number, deg: number, x: number, y: number): [number, number]
 }

package/types/ruler.d.ts

@@ -1,11 +1,25 @@
+/**
+ * 刻度尺配置选项类型定义
+ */
 export interface rulerOptionType {
+    /** 最大值限制 */
     max?: number
+    /** 最小值限制 */
     min?: number
 }
 
 /**
- * 刻度尺刻度运算，返回一个数组，表示刻度尺上应该显示的刻度
+ * 刻度尺计算函数类型定义
+ * 用于在给定范围内生成均匀的刻度值
  */
 export default interface rulerType {
+    /**
+     * 生成刻度值数组
+     * @param maxValue 数据最大值
+     * @param minValue 数据最小值
+     * @param num 期望的刻度数量
+     * @param option 可选的配置选项
+     * @returns 返回计算得到的刻度值数组
+     */
     (maxValue: number, minValue: number, num: number, option?: rulerOptionType): number[]
 }

package/types/scale.d.ts

@@ -1,6 +1,16 @@
 /**
- * 缩放
+ * 缩放变换函数类型定义
+ * 用于计算二维坐标系中的缩放变换
  */
 export default interface scaleType {
+    /**
+     * 计算缩放后的坐标
+     * @param cx 缩放中心的x坐标
+     * @param cy 缩放中心的y坐标
+     * @param times 缩放倍数
+     * @param x 原始点的x坐标
+     * @param y 原始点的y坐标
+     * @returns 返回缩放后的坐标 [newX, newY]
+     */
     (cx: number, cy: number, times: number, x: number, y: number): [number, number]
 }

package/types/throttle.d.ts

@@ -1,6 +1,7 @@
 import { throttleType } from "oipage/web/throttle/index"
 
 /**
- * 节流函数
+ * 节流函数类型定义
+ * 用于限制函数的执行频率，优化性能
  */
 export default throttleType