@ibiz-template/vue3-util 0.7.41-alpha.2 → 0.7.41-alpha.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (121) hide show
  1. package/dist/index.min.css +1 -1
  2. package/dist/index.system.min.js +1 -1
  3. package/es/common/badge/badge.css +1 -1
  4. package/es/common/control-base/control-base.css +1 -1
  5. package/es/common/control-base/control-base.d.ts +1 -0
  6. package/es/common/control-base/control-base.d.ts.map +1 -1
  7. package/es/common/control-base/control-base.mjs +38 -4
  8. package/es/common/custom-render/custom-render.d.ts.map +1 -1
  9. package/es/common/custom-render/custom-render.mjs +2 -2
  10. package/es/common/index.d.ts +1 -0
  11. package/es/common/index.d.ts.map +1 -1
  12. package/es/common/index.mjs +1 -0
  13. package/es/common/signature-pad/signature-pad.css +1 -0
  14. package/es/common/signature-pad/signature-pad.d.ts +19 -0
  15. package/es/common/signature-pad/signature-pad.d.ts.map +1 -0
  16. package/es/common/signature-pad/signature-pad.mjs +165 -0
  17. package/es/common/signature-pad/util/bezier.d.ts +58 -0
  18. package/es/common/signature-pad/util/bezier.d.ts.map +1 -0
  19. package/es/common/signature-pad/util/bezier.mjs +109 -0
  20. package/es/common/signature-pad/util/point.d.ts +55 -0
  21. package/es/common/signature-pad/util/point.d.ts.map +1 -0
  22. package/es/common/signature-pad/util/point.mjs +51 -0
  23. package/es/common/signature-pad/util/signature_pad.d.ts +593 -0
  24. package/es/common/signature-pad/util/signature_pad.d.ts.map +1 -0
  25. package/es/common/signature-pad/util/signature_pad.mjs +1018 -0
  26. package/es/common/view-shell/view-shell.d.ts +8 -1
  27. package/es/common/view-shell/view-shell.d.ts.map +1 -1
  28. package/es/common/view-shell/view-shell.mjs +13 -2
  29. package/es/control/panel/panel/panel.d.ts.map +1 -1
  30. package/es/control/panel/panel/panel.mjs +12 -1
  31. package/es/control/panel/view-layout-panel/view-layout-panel.d.ts +1 -1
  32. package/es/control/panel/view-layout-panel/view-layout-panel.d.ts.map +1 -1
  33. package/es/control/panel/view-layout-panel/view-layout-panel.mjs +12 -1
  34. package/es/index.mjs +2 -0
  35. package/es/locale/en/index.d.ts +1 -0
  36. package/es/locale/en/index.d.ts.map +1 -1
  37. package/es/locale/en/index.mjs +2 -1
  38. package/es/locale/zh-CN/index.d.ts +1 -0
  39. package/es/locale/zh-CN/index.d.ts.map +1 -1
  40. package/es/locale/zh-CN/index.mjs +2 -1
  41. package/es/panel-component/multi-data-container/multi-data-container.d.ts +1 -1
  42. package/es/panel-component/multi-data-container/multi-data-container.d.ts.map +1 -1
  43. package/es/panel-component/multi-data-container-raw/multi-data-container-raw.d.ts +1 -1
  44. package/es/panel-component/multi-data-container-raw/multi-data-container-raw.d.ts.map +1 -1
  45. package/es/panel-component/nav-pos/nav-pos.controller.d.ts +1 -1
  46. package/es/panel-component/nav-pos/nav-pos.d.ts +1 -1
  47. package/es/panel-component/panel-container/panel-container.d.ts.map +1 -1
  48. package/es/panel-component/panel-container/panel-container.mjs +30 -2
  49. package/es/panel-component/panel-field/panel-field.controller.mjs +1 -1
  50. package/es/panel-component/panel-tab-page/panel-tab-page.d.ts +1 -1
  51. package/es/panel-component/single-data-container/single-data-container.d.ts +1 -1
  52. package/es/panel-component/single-data-container/single-data-container.d.ts.map +1 -1
  53. package/es/panel-component/teleport-placeholder/teleport-placeholder.d.ts +1 -0
  54. package/es/panel-component/teleport-placeholder/teleport-placeholder.d.ts.map +1 -1
  55. package/es/panel-component/teleport-placeholder/teleport-placeholder.state.d.ts +1 -1
  56. package/es/panel-component/teleport-placeholder/teleport-placeholder.state.mjs +1 -1
  57. package/es/plugin/plugin-factory/plugin-factory.d.ts +13 -12
  58. package/es/plugin/plugin-factory/plugin-factory.d.ts.map +1 -1
  59. package/es/plugin/plugin-factory/plugin-factory.mjs +24 -18
  60. package/es/use/index.d.ts +1 -0
  61. package/es/use/index.d.ts.map +1 -1
  62. package/es/use/index.mjs +2 -0
  63. package/es/use/storage/index.d.ts +4 -6
  64. package/es/use/storage/index.d.ts.map +1 -1
  65. package/es/use/storage/index.mjs +16 -11
  66. package/es/use/vue-use/computed-async.d.ts +51 -0
  67. package/es/use/vue-use/computed-async.d.ts.map +1 -0
  68. package/es/use/vue-use/computed-async.mjs +66 -0
  69. package/es/use/vue-use/index.d.ts +2 -0
  70. package/es/use/vue-use/index.d.ts.map +1 -0
  71. package/es/use/vue-use/index.mjs +3 -0
  72. package/es/util/install.d.ts.map +1 -1
  73. package/es/util/overlay-container/overlay-container.d.ts +1 -1
  74. package/es/util/overlay-container/overlay-container.d.ts.map +1 -1
  75. package/es/util/overlay-container/overlay-container.mjs +7 -2
  76. package/es/util/overlay-view-util/overlay-view-util.d.ts +2 -2
  77. package/es/util/overlay-view-util/overlay-view-util.d.ts.map +1 -1
  78. package/es/util/overlay-view-util/overlay-view-util.mjs +2 -1
  79. package/es/util/render/render.d.ts.map +1 -1
  80. package/es/util/render/render.mjs +4 -1
  81. package/es/util/route/route.d.ts.map +1 -1
  82. package/es/util/route/route.mjs +18 -3
  83. package/es/view/common/index.d.ts.map +1 -1
  84. package/es/view/common/index.mjs +2 -0
  85. package/es/view/common/view.d.ts.map +1 -1
  86. package/es/view/common/view.mjs +14 -1
  87. package/es/view/md-custom-view/md-custom-view.provider.d.ts +13 -0
  88. package/es/view/md-custom-view/md-custom-view.provider.d.ts.map +1 -0
  89. package/es/view/md-custom-view/md-custom-view.provider.mjs +13 -0
  90. package/lib/common/badge/badge.css +1 -1
  91. package/lib/common/control-base/control-base.cjs +37 -3
  92. package/lib/common/control-base/control-base.css +1 -1
  93. package/lib/common/custom-render/custom-render.cjs +1 -1
  94. package/lib/common/index.cjs +2 -0
  95. package/lib/common/signature-pad/signature-pad.cjs +167 -0
  96. package/lib/common/signature-pad/signature-pad.css +1 -0
  97. package/lib/common/signature-pad/util/bezier.cjs +111 -0
  98. package/lib/common/signature-pad/util/point.cjs +53 -0
  99. package/lib/common/signature-pad/util/signature_pad.cjs +1022 -0
  100. package/lib/common/view-shell/view-shell.cjs +13 -2
  101. package/lib/control/panel/panel/panel.cjs +12 -1
  102. package/lib/control/panel/view-layout-panel/view-layout-panel.cjs +12 -1
  103. package/lib/index.cjs +4 -0
  104. package/lib/locale/en/index.cjs +2 -1
  105. package/lib/locale/zh-CN/index.cjs +2 -1
  106. package/lib/panel-component/panel-container/panel-container.cjs +29 -1
  107. package/lib/panel-component/panel-field/panel-field.controller.cjs +1 -1
  108. package/lib/panel-component/teleport-placeholder/teleport-placeholder.state.cjs +1 -1
  109. package/lib/plugin/plugin-factory/plugin-factory.cjs +24 -18
  110. package/lib/use/index.cjs +3 -0
  111. package/lib/use/storage/index.cjs +16 -11
  112. package/lib/use/vue-use/computed-async.cjs +68 -0
  113. package/lib/use/vue-use/index.cjs +7 -0
  114. package/lib/util/overlay-container/overlay-container.cjs +7 -2
  115. package/lib/util/overlay-view-util/overlay-view-util.cjs +2 -1
  116. package/lib/util/render/render.cjs +4 -1
  117. package/lib/util/route/route.cjs +18 -3
  118. package/lib/view/common/index.cjs +2 -0
  119. package/lib/view/common/view.cjs +13 -0
  120. package/lib/view/md-custom-view/md-custom-view.provider.cjs +15 -0
  121. package/package.json +7 -7
@@ -0,0 +1,593 @@
1
+ import { IBasicPoint } from './point';
2
+ /**
3
+ * @description 签名事件对象接口,封装签名相关的事件信息
4
+ * @export
5
+ * @interface ISignatureEvent
6
+ */
7
+ export interface ISignatureEvent {
8
+ /** 原始事件对象(鼠标、触摸或指针事件) */
9
+ event: MouseEvent | TouchEvent | PointerEvent;
10
+ /** 事件类型(如'mousedown'、'touchmove'等) */
11
+ type: string;
12
+ /** 事件发生时的X坐标 */
13
+ x: number;
14
+ /** 事件发生时的Y坐标 */
15
+ y: number;
16
+ /** 压力值(如触摸或绘图设备的压力感应值) */
17
+ pressure: number;
18
+ }
19
+ /**
20
+ * @description 从数据加载签名时的配置选项接口
21
+ * @export
22
+ * @interface IFromDataOptions
23
+ */
24
+ export interface IFromDataOptions {
25
+ /** 是否在加载前清除现有签名,默认true */
26
+ clear?: boolean;
27
+ }
28
+ /**
29
+ * @description 导出为SVG格式时的配置选项接口
30
+ * @export
31
+ * @interface IToSVGOptions
32
+ */
33
+ export interface IToSVGOptions {
34
+ /** 是否在SVG中包含背景色,默认false */
35
+ includeBackgroundColor?: boolean;
36
+ }
37
+ /**
38
+ * @description 点组的样式配置选项接口,用于定义签名线条/点的绘制样式
39
+ * @export
40
+ * @interface IPointGroupOptions
41
+ */
42
+ export interface IPointGroupOptions {
43
+ /** 点的大小(像素) */
44
+ dotSize: number;
45
+ /** 线条最小宽度(像素) */
46
+ minWidth: number;
47
+ /** 线条最大宽度(像素) */
48
+ maxWidth: number;
49
+ /** 画笔颜色(CSS颜色格式) */
50
+ penColor: string;
51
+ /** 速度过滤权重(用于平滑线条粗细变化) */
52
+ velocityFilterWeight: number;
53
+ /** 合成操作(遵循Canvas的globalCompositeOperation规范) */
54
+ compositeOperation: GlobalCompositeOperation;
55
+ }
56
+ /**
57
+ * @description SignaturePad的初始化配置选项接口,继承点组样式配置并支持部分可选扩展
58
+ * @export
59
+ * @interface ISignaturePadOptions
60
+ * @extends {Partial<IPointGroupOptions>}
61
+ */
62
+ export interface ISignaturePadOptions extends Partial<IPointGroupOptions> {
63
+ /** 连续点之间的最小距离(像素),小于此值则不记录新点 */
64
+ minDistance?: number;
65
+ /** 画布背景色(CSS颜色格式) */
66
+ backgroundColor?: string;
67
+ /** 事件节流时间(毫秒),限制绘制事件触发频率 */
68
+ throttle?: number;
69
+ /** Canvas 2D上下文的初始化配置 */
70
+ canvasContextOptions?: CanvasRenderingContext2DSettings;
71
+ }
72
+ /**
73
+ * @description 点组接口,包含一组点及对应的绘制样式配置,用于记录签名的一段轨迹
74
+ * @export
75
+ * @interface IPointGroup
76
+ * @extends {IPointGroupOptions}
77
+ */
78
+ export interface IPointGroup extends IPointGroupOptions {
79
+ /** 该组包含的点集合(基础点信息) */
80
+ points: IBasicPoint[];
81
+ }
82
+ export default class SignaturePad {
83
+ private canvas;
84
+ /**
85
+ * @description 点的大小,默认值为0(单位:像素)。控制点击画布时生成的点的尺寸。0表示根据线条宽度自动计算点的大小
86
+ * @type {number}
87
+ * @memberof SignaturePad
88
+ */
89
+ dotSize: number;
90
+ /**
91
+ * @description 画笔最小宽度,默认值为0.5(单位:像素)。控制签名线条的最细宽度,绘制速度越快,线条越接近此值
92
+ * @type {number}
93
+ * @memberof SignaturePad
94
+ */
95
+ minWidth: number;
96
+ /**
97
+ * @description 画笔最大宽度,默认值为2.5(单位:像素)。控制签名线条的最粗宽度,绘制速度越慢,线条越接近此值。
98
+ * @type {number}
99
+ * @memberof SignaturePad
100
+ */
101
+ maxWidth: number;
102
+ /**
103
+ * @description 画笔颜色,默认值为'black'。签名轨迹的颜色,可接受 CSS 颜色格式(如#ff0000、rgb(255,0,0)等)。
104
+ * @type {string}
105
+ * @memberof SignaturePad
106
+ */
107
+ penColor: string;
108
+ /**
109
+ * @description 最小绘制距离,默认值为5(单位:像素)。当连续两个绘制点的距离小于此值时,不会记录新点,用于减少冗余数据并优化绘制流畅度。
110
+ * @type {number}
111
+ * @memberof SignaturePad
112
+ */
113
+ minDistance: number;
114
+ /**
115
+ * @description 速度过滤权重,默认值为0.7。用于平滑处理绘制速度的计算,影响线条粗细随速度的变化幅度。值越接近 1,当前速度对线条粗细的影响越大;值越小,线条过渡越平滑
116
+ * @type {number}
117
+ * @memberof SignaturePad
118
+ */
119
+ velocityFilterWeight: number;
120
+ /**
121
+ * @description 合成操作,默认值为'source-over'。控制新绘制的线条与已有内容的混合方式,遵循 Canvas 的globalCompositeOperation属性规范
122
+ * @type {GlobalCompositeOperation}
123
+ * @memberof SignaturePad
124
+ */
125
+ compositeOperation: GlobalCompositeOperation;
126
+ /**
127
+ * @description 画布背景色,默认值为'rgba(0,0,0,0)'(透明)。签名画布的背景颜色,导出图片时会包含此背景。
128
+ * @type {string}
129
+ * @memberof SignaturePad
130
+ */
131
+ backgroundColor: string;
132
+ /**
133
+ * @description 节流时间,默认值为16(单位:毫秒)。限制绘制事件的触发频率,避免高频操作导致性能问题。??运算符确保0值会被正常应用(而||会忽略0)
134
+ * @type {number}
135
+ * @memberof SignaturePad
136
+ */
137
+ throttle: number;
138
+ /**
139
+ * @description Canvas 上下文配置,默认值为{}。用于初始化 Canvas 2D 上下文的额外配置项(如alpha、willReadFrequently等)
140
+ * @type {CanvasRenderingContext2DSettings}
141
+ * @memberof SignaturePad
142
+ */
143
+ canvasContextOptions: CanvasRenderingContext2DSettings;
144
+ /**
145
+ * @description Canvas 2D 渲染上下文,用于实际绘制签名轨迹
146
+ * @private
147
+ * @type {CanvasRenderingContext2D}
148
+ * @memberof SignaturePad
149
+ */
150
+ private _ctx;
151
+ /**
152
+ * @description 是否正在绘制中(笔触未抬起)
153
+ * @private
154
+ * @memberof SignaturePad
155
+ */
156
+ private _drawingStroke;
157
+ /**
158
+ * @description 签名是否为空(未绘制任何内容)
159
+ * @private
160
+ * @memberof SignaturePad
161
+ */
162
+ private _isEmpty;
163
+ /**
164
+ * @description 是否重新绘制过签名(用于判断是否从数据恢复过签名)
165
+ * @private
166
+ * @memberof SignaturePad
167
+ */
168
+ private _isRedrawn;
169
+ /**
170
+ * @description 上一次从DataURL加载的签名图片地址,用于撤销操作时恢复
171
+ * @private
172
+ * @memberof SignaturePad
173
+ */
174
+ private _oldFromDataURL;
175
+ /**
176
+ * @description 存储最近的点(最多4个),用于生成新的贝塞尔曲线
177
+ * @private
178
+ * @type {Point[]}
179
+ * @memberof SignaturePad
180
+ */
181
+ private _lastPoints;
182
+ /**
183
+ * @description 存储所有签名数据(按轨迹分组,每组包含一段连续绘制的点及样式配置)
184
+ * @private
185
+ * @type {IPointGroup[]}
186
+ * @memberof SignaturePad
187
+ */
188
+ private _data;
189
+ /**
190
+ * @description 上一次计算的绘制速度(用于平滑线条宽度变化)
191
+ * @private
192
+ * @memberof SignaturePad
193
+ */
194
+ private _lastVelocity;
195
+ /**
196
+ * @description 上一次绘制的线条宽度(用于平滑过渡到当前宽度)
197
+ * @private
198
+ * @memberof SignaturePad
199
+ */
200
+ private _lastWidth;
201
+ /**
202
+ * @description 节流处理后的笔触移动更新函数(根据配置的throttle值决定是否节流)
203
+ * @private
204
+ * @memberof SignaturePad
205
+ */
206
+ private _strokeMoveUpdate;
207
+ /**
208
+ * @description 当前活跃的指针事件ID(用于区分多指针设备的不同笔触)
209
+ * @private
210
+ * @type {(number | undefined)}
211
+ * @memberof SignaturePad
212
+ */
213
+ private _strokePointerId;
214
+ constructor(canvas: HTMLCanvasElement, options?: ISignaturePadOptions);
215
+ clear(): void;
216
+ /**
217
+ * 从数据URL加载图像并绘制到签名画布上
218
+ * 支持对图像进行旋转、缩放和偏移等处理,适用于恢复保存的签名图像
219
+ * @param {string} dataUrl - 图像的DataURL(如base64编码的图片数据)
220
+ * @param {Object} [options={}] - 加载配置选项
221
+ * @returns {Promise<void>} - 加载完成的Promise(成功时resolve,失败时reject)
222
+ */
223
+ fromDataURL(dataUrl: string, options?: {
224
+ ratio?: number;
225
+ width?: number;
226
+ height?: number;
227
+ xOffset?: number;
228
+ yOffset?: number;
229
+ rotation?: number;
230
+ }): Promise<void>;
231
+ /**
232
+ * @description 将已有的 DataURL 旋转指定角度后,返回新的 DataURL
233
+ * @private
234
+ * @param {string} dataUrl - 原始图片的DataURL
235
+ * @param {number} rotation - 旋转角度(度数,顺时针),默认0
236
+ * @param {string} type - 图片格式,默认'image/png'
237
+ * @param {number} [encoderOptions] - 图片质量(0-1),仅适用于jpeg等格式
238
+ * @returns {*} {Promise<string>}
239
+ * @memberof SignaturePad
240
+ */
241
+ private rotateDataURL;
242
+ /**
243
+ * @description 撤销上一步
244
+ * @returns {*} {void}
245
+ * @memberof SignaturePad
246
+ */
247
+ undoLastStep(): void;
248
+ /**
249
+ * @description 封装获取当前旋转方位的方法
250
+ * @returns {*} {IData} 包含屏幕状态、旋转角度和方向的对象
251
+ * @memberof SignaturePad
252
+ */
253
+ getCurrentOrientation(): IData;
254
+ /**
255
+ * @description 将签名图像作为数据 URL 返回
256
+ * @param {string} [type='image/png']
257
+ * @param {{
258
+ * rotation?: number;
259
+ * quality?: number;
260
+ * encoderOptions?: IToSVGOptions;
261
+ * }} [options={}]
262
+ * @returns {*} {string}
263
+ * @memberof SignaturePad
264
+ */
265
+ toDataURL(type?: string, options?: {
266
+ rotation?: number;
267
+ quality?: number;
268
+ encoderOptions?: IToSVGOptions;
269
+ }): string;
270
+ /**
271
+ * @description 导出为 Canvas DataURL(支持旋转)
272
+ * @private
273
+ * @param {string} [type='image/png'] 图片格式
274
+ * @param {number} [encoderOptions] 图片质量(0-1)
275
+ * @param {number} [rotation] 旋转角度(度数)
276
+ * @returns {*} {string}
277
+ * @memberof SignaturePad
278
+ */
279
+ private toCanvasDataURL;
280
+ /**
281
+ * @description 启用签名功能的事件监听,配置画布样式以禁用默认的触摸行为(如平移、缩放),并根据设备类型绑定相应的事件处理器
282
+ * @memberof SignaturePad
283
+ */
284
+ on(): void;
285
+ /**
286
+ * @description 禁用签名功能的事件监听,恢复画布默认样式(允许平移、缩放等),并移除所有已绑定的事件处理器
287
+ * @memberof SignaturePad
288
+ */
289
+ off(): void;
290
+ /**
291
+ * @description 获取事件监听器的工具函数(适配不同文档上下文的窗口)
292
+ * @private
293
+ * @returns {*} 包含addEventListener和removeEventListener的对象
294
+ * @memberof SignaturePad
295
+ */
296
+ private _getListenerFunctions;
297
+ /**
298
+ * @description 移除所有移动和抬起事件的监听器(清理事件绑定)
299
+ * @private
300
+ * @memberof SignaturePad
301
+ */
302
+ private _removeMoveUpEventListeners;
303
+ /**
304
+ * @description 判断签名画布是否为空(未绘制任何内容)
305
+ * @returns {*} {boolean}
306
+ * @memberof SignaturePad
307
+ */
308
+ isEmpty(): boolean;
309
+ /**
310
+ * @description 判断签名是否经过重新绘制(如从数据恢复签名、执行撤销后重新渲染等场景)
311
+ * @returns {*} {boolean}
312
+ * @memberof SignaturePad
313
+ */
314
+ isRedrawn(): boolean;
315
+ /**
316
+ * @description 从点组数据加载并渲染签名,可根据配置决定是否先清空现有签名,再基于传入的点组数据重新绘制曲线和点
317
+ * @param {IPointGroup[]} pointGroups - 签名点组数据数组,每个点组包含一段签名的点集合及对应的样式配置
318
+ * @param {IFromDataOptions} [options={ clear: true }] - 加载配置项,默认清空现有签名
319
+ * @memberof SignaturePad
320
+ */
321
+ fromData(pointGroups: IPointGroup[], { clear }?: IFromDataOptions): void;
322
+ /**
323
+ * @description 导出当前签名的点组数据,用于保存签名原始数据,后续可通过fromData方法恢复签名
324
+ * @returns {*} {IPointGroup[]}
325
+ * @memberof SignaturePad
326
+ */
327
+ toData(): IPointGroup[];
328
+ /**
329
+ * @description 判断鼠标左键是否按下(支持判断是否仅左键按下)
330
+ * @private
331
+ * @param {MouseEvent} event - 鼠标事件对象
332
+ * @param {boolean} [only] - 是否要求仅左键按下
333
+ * @returns {*} {boolean}
334
+ * @memberof SignaturePad
335
+ */
336
+ private _isLeftButtonPressed;
337
+ /**
338
+ * @description 将鼠标/指针事件转换为签名事件对象
339
+ * @private
340
+ * @param {(MouseEvent | PointerEvent)} event - 原始事件对象
341
+ * @returns {*} {ISignatureEvent}
342
+ * @memberof SignaturePad
343
+ */
344
+ private _pointerEventToSignatureEvent;
345
+ /**
346
+ * @description 将触摸事件转换为签名事件对象
347
+ * @private
348
+ * @param {TouchEvent} event - 原始触摸事件
349
+ * @returns {*} {ISignatureEvent}
350
+ * @memberof SignaturePad
351
+ */
352
+ private _touchEventToSignatureEvent;
353
+ /**
354
+ * @description 处理鼠标按下事件,当左键按下且未正在绘制时,开始新的笔触
355
+ * @private
356
+ * @param {MouseEvent} event
357
+ * @returns {*} {void}
358
+ * @memberof SignaturePad
359
+ */
360
+ private _handleMouseDown;
361
+ /**
362
+ * @description 处理鼠标移动事件,当左键持续按下且正在绘制时,更新笔触;否则结束笔触
363
+ * @private
364
+ * @param {MouseEvent} event
365
+ * @returns {*} {void}
366
+ * @memberof SignaturePad
367
+ */
368
+ private _handleMouseMove;
369
+ /**
370
+ * @description 处理鼠标抬起事件,当左键抬起时,结束当前笔触
371
+ * @private
372
+ * @param {MouseEvent} event
373
+ * @returns {*} {void}
374
+ * @memberof SignaturePad
375
+ */
376
+ private _handleMouseUp;
377
+ /**
378
+ * @description 处理触摸开始事件,当单点触摸且不在绘制状态时,开始新的笔触,并阻止页面滚动
379
+ * @private
380
+ * @param {TouchEvent} event
381
+ * @returns {*} {void}
382
+ * @memberof SignaturePad
383
+ */
384
+ private _handleTouchStart;
385
+ /**
386
+ * @description 处理触摸移动事件,当单点触摸且正在绘制时,更新笔触;否则结束笔触,并阻止页面滚动
387
+ * @private
388
+ * @param {TouchEvent} event
389
+ * @returns {*} {void}
390
+ * @memberof SignaturePad
391
+ */
392
+ private _handleTouchMove;
393
+ /**
394
+ * @description 处理触摸结束事件,当所有触摸点离开时,结束当前笔触,并阻止默认行为
395
+ * @private
396
+ * @param {TouchEvent} event
397
+ * @returns {*} {void}
398
+ * @memberof SignaturePad
399
+ */
400
+ private _handleTouchEnd;
401
+ /**
402
+ * @description 获取指针事件的唯一ID(优先使用persistentDeviceId,兼容旧设备用pointerId)
403
+ * @private
404
+ * @param {PointerEvent} event
405
+ * @returns {*} {number}
406
+ * @memberof SignaturePad
407
+ */
408
+ private _getPointerId;
409
+ /**
410
+ * @description 判断当前指针事件的ID是否为当前活跃的笔触ID
411
+ * @private
412
+ * @param {PointerEvent} event - 指针事件对象
413
+ * @param {boolean} [allowUndefined] - 是否允许当前无活跃ID(初始状态)
414
+ * @returns {*} {boolean}
415
+ * @memberof SignaturePad
416
+ */
417
+ private _allowPointerId;
418
+ /**
419
+ * @description 处理指针按下事件(兼容鼠标、触摸等多种输入设备)
420
+ * @private
421
+ * @param {PointerEvent} event
422
+ * @returns {*} {void}
423
+ * @memberof SignaturePad
424
+ */
425
+ private _handlePointerDown;
426
+ /**
427
+ * @description 处理指针移动事件,当指针ID有效、左键持续按下且正在绘制时,更新笔触;否则结束笔触
428
+ * @private
429
+ * @param {PointerEvent} event
430
+ * @returns {*} {void}
431
+ * @memberof SignaturePad
432
+ */
433
+ private _handlePointerMove;
434
+ /**
435
+ * @description 处理指针抬起事件,当左键抬起且指针ID有效时,结束当前笔触
436
+ * @private
437
+ * @param {PointerEvent} event
438
+ * @returns {*} {void}
439
+ * @memberof SignaturePad
440
+ */
441
+ private _handlePointerUp;
442
+ /**
443
+ * @description 获取点组的样式配置(优先使用点组自身配置,否则用全局配置)
444
+ * @private
445
+ * @param {IPointGroup} [group] - 点组对象(可选)
446
+ * @returns {*} {IPointGroupOptions}
447
+ * @memberof SignaturePad
448
+ */
449
+ private _getPointGroupOptions;
450
+ /**
451
+ * @description 开始绘制笔触(初始化事件监听和绘制状态)
452
+ * @private
453
+ * @param {ISignatureEvent} event - 签名事件对象
454
+ * @memberof SignaturePad
455
+ */
456
+ private _strokeBegin;
457
+ /**
458
+ * @description 更新绘制(处理新点并绘制曲线/点)
459
+ * @private
460
+ * @param {ISignatureEvent} event
461
+ * @returns {*} {void}
462
+ * @memberof SignaturePad
463
+ */
464
+ private _strokeUpdate;
465
+ /**
466
+ * @description 结束绘制笔触(清理事件监听和绘制状态)
467
+ * @private
468
+ * @param {ISignatureEvent} event - 签名事件对象
469
+ * @param {boolean} [shouldUpdate=true] - 是否在结束前更新绘制
470
+ * @returns {*} {void}
471
+ * @memberof SignaturePad
472
+ */
473
+ private _strokeEnd;
474
+ /**
475
+ * @description 初始化指针事件处理(绑定指针按下事件)
476
+ * @private
477
+ * @memberof SignaturePad
478
+ */
479
+ private _handlePointerEvents;
480
+ /**
481
+ * @description 初始化鼠标事件处理(绑定鼠标按下事件)
482
+ * @private
483
+ * @memberof SignaturePad
484
+ */
485
+ private _handleMouseEvents;
486
+ /**
487
+ * @description 初始化触摸事件处理(绑定触摸开始事件)
488
+ * @private
489
+ * @memberof SignaturePad
490
+ */
491
+ private _handleTouchEvents;
492
+ /**
493
+ * @description 重置绘制状态(清空最近点、重置速度和宽度等)
494
+ * @private
495
+ * @param {IPointGroupOptions} options - 点组样式配置
496
+ * @memberof SignaturePad
497
+ */
498
+ private _reset;
499
+ /**
500
+ * @description 创建点对象(转换坐标为画布相对坐标)
501
+ * @private
502
+ * @param {number} x - 原始X坐标(相对于视口)
503
+ * @param {number} y - 原始Y坐标(相对于视口)
504
+ * @param {number} pressure - 压力值
505
+ * @returns {*} {Point}
506
+ * @memberof SignaturePad
507
+ */
508
+ private _createPoint;
509
+ /**
510
+ * @description 添加点到最近点列表,并在点足够时生成贝塞尔曲线
511
+ * @private
512
+ * @param {Point} point - 新点
513
+ * @param {IPointGroupOptions} options - 样式配置
514
+ * @returns {*} {(Bezier | null)}
515
+ * @memberof SignaturePad
516
+ */
517
+ private _addPoint;
518
+ /**
519
+ * @description 计算曲线的起始和结束宽度(基于速度动态调整)
520
+ * @private
521
+ * @param {Point} startPoint - 曲线起点
522
+ * @param {Point} endPoint - 曲线终点
523
+ * @param {IPointGroupOptions} options - 样式配置
524
+ * @returns {*} {{ start: number; end: number }}
525
+ * @memberof SignaturePad
526
+ */
527
+ private _calculateCurveWidths;
528
+ /**
529
+ * @description 根据速度计算线条宽度(速度越快,宽度越接近最小宽度)
530
+ * @private
531
+ * @param {number} velocity - 绘制速度
532
+ * @param {IPointGroupOptions} options - 样式配置
533
+ * @returns {*} {number}
534
+ * @memberof SignaturePad
535
+ */
536
+ private _strokeWidth;
537
+ /**
538
+ * @description 绘制曲线片段(以点为中心的圆,用于模拟线条)
539
+ * @private
540
+ * @param {number} x - 片段X坐标
541
+ * @param {number} y - 片段Y坐标
542
+ * @param {number} width - 片段宽度(圆的半径)
543
+ * @memberof SignaturePad
544
+ */
545
+ private _drawCurveSegment;
546
+ /**
547
+ * @description 绘制贝塞尔曲线(通过分段绘制多个圆模拟平滑线条)
548
+ * @private
549
+ * @param {Bezier} curve - 贝塞尔曲线对象
550
+ * @param {IPointGroupOptions} options - 样式配置
551
+ * @memberof SignaturePad
552
+ */
553
+ private _drawCurve;
554
+ /**
555
+ * @description 绘制点(用于笔触起始或单点点击)
556
+ * @private
557
+ * @param {IBasicPoint} point - 点对象
558
+ * @param {IPointGroupOptions} options - 样式配置
559
+ * @memberof SignaturePad
560
+ */
561
+ private _drawDot;
562
+ /**
563
+ * @description 从点组数据绘制签名(用于从保存的数据恢复签名)
564
+ * @private
565
+ * @param {IPointGroup[]} pointGroups - 点组数据数组
566
+ * @param {Function} drawCurve - 绘制曲线的函数
567
+ * @param {Function} drawDot - 绘制点的函数
568
+ * @memberof SignaturePad
569
+ */
570
+ private _fromData;
571
+ /**
572
+ * @description 返回 svg 字符串而不转换为 base64
573
+ * @param {IToSVGOptions} [{ includeBackgroundColor = false }={}] includeBackgroundColor值为true时将背景颜色添加到 SVG 输出
574
+ * @returns {*} {string}
575
+ * @memberof SignaturePad
576
+ */
577
+ toSVG({ includeBackgroundColor }?: IToSVGOptions): string;
578
+ /**
579
+ * @description 将Blob对象转换为DataURL
580
+ * @param {Blob} blob - 要转换的Blob对象
581
+ * @returns {*} {Promise<string>}
582
+ * @memberof SignaturePad
583
+ */
584
+ blobToDataURL(blob: Blob): Promise<string>;
585
+ /**
586
+ * @description 处理图片加载并计算加载时间(通过回调通知完成状态)
587
+ * @param {string} imageUrl
588
+ * @param {() => void} _callBack
589
+ * @memberof SignaturePad
590
+ */
591
+ loadImage(imageUrl: string, _callBack: () => void): void;
592
+ }
593
+ //# sourceMappingURL=signature_pad.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"signature_pad.d.ts","sourceRoot":"","sources":["../../../../src/common/signature-pad/util/signature_pad.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAS,MAAM,SAAS,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;IAC9C,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,gBAAgB;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,kBAAkB,EAAE,wBAAwB,CAAC;CAC9C;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAqB,SAAQ,OAAO,CAAC,kBAAkB,CAAC;IACvE,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,oBAAoB,CAAC,EAAE,gCAAgC,CAAC;CACzD;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAY,SAAQ,kBAAkB;IACrD,sBAAsB;IACtB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,CAAC,OAAO,OAAO,YAAY;IA0J7B,OAAO,CAAC,MAAM;IAzJhB;;;;OAIG;IAEI,OAAO,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACI,QAAQ,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACI,QAAQ,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACI,QAAQ,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACI,WAAW,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACI,oBAAoB,EAAE,MAAM,CAAC;IAEpC;;;;OAIG;IACI,kBAAkB,EAAE,wBAAwB,CAAC;IAEpD;;;;OAIG;IACI,eAAe,EAAE,MAAM,CAAC;IAE/B;;;;OAIG;IACI,QAAQ,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACI,oBAAoB,EAAE,gCAAgC,CAAC;IAE9D;;;;;OAKG;IACH,OAAO,CAAC,IAAI,CAA2B;IAEvC;;;;OAIG;IACH,OAAO,CAAC,cAAc,CAAS;IAE/B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAQ;IAExB;;;;OAIG;IACH,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;OAIG;IACH,OAAO,CAAC,eAAe,CAAM;IAE7B;;;;;OAKG;IACH,OAAO,CAAC,WAAW,CAAe;IAElC;;;;;OAKG;IACH,OAAO,CAAC,KAAK,CAAqB;IAElC;;;;OAIG;IACH,OAAO,CAAC,aAAa,CAAK;IAE1B;;;;OAIG;IACH,OAAO,CAAC,UAAU,CAAK;IAEvB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB,CAAmC;IAE5D;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB,CAAqB;gBAGnC,MAAM,EAAE,iBAAiB,EACjC,OAAO,GAAE,oBAAyB;IAuC7B,KAAK,IAAI,IAAI;IAepB;;;;;;OAMG;IACU,WAAW,CACtB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAEP,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACd,GACL,OAAO,CAAC,IAAI,CAAC;IAiDhB;;;;;;;;;OASG;IACH,OAAO,CAAC,aAAa;IA0CrB;;;;OAIG;IACI,YAAY,IAAI,IAAI;IAmB3B;;;;OAIG;IACH,qBAAqB,IAAI,KAAK;IAmC9B;;;;;;;;;;OAUG;IACI,SAAS,CACd,IAAI,GAAE,MAAoB,EAC1B,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,aAAa,CAAC;KAC3B,GACL,MAAM;IAkBT;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAqCvB;;;OAGG;IACI,EAAE,IAAI,IAAI;IA8BjB;;;OAGG;IACI,GAAG,IAAI,IAAI;IAqBlB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;IAYnC;;;;OAIG;IACI,OAAO,IAAI,OAAO;IAIzB;;;;OAIG;IACI,SAAS,IAAI,OAAO;IAI3B;;;;;OAKG;IACI,QAAQ,CACb,WAAW,EAAE,WAAW,EAAE,EAC1B,EAAE,KAAY,EAAE,GAAE,gBAAqB,GACtC,IAAI;IAgBP;;;;OAIG;IACI,MAAM,IAAI,WAAW,EAAE;IAI9B;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;;;;;OAMG;IACH,OAAO,CAAC,6BAA6B;IAYrC;;;;;;OAMG;IACH,OAAO,CAAC,2BAA2B;IAWnC;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IASxB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAUtB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAezB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAevB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAWvB;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAiB7B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAyCpB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAyCrB;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;IAelB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;;;;OAKG;IACH,OAAO,CAAC,MAAM;IAQd;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;IAWpB;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IA4BjB;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IAuClB;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ;IAchB;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAqCjB;;;;;OAKG;IACI,KAAK,CAAC,EAAE,sBAA8B,EAAE,GAAE,aAAkB,GAAG,MAAM;IAqE5E;;;;;OAKG;IACI,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBjD;;;;;OAKG;IACI,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,IAAI,GAAG,IAAI;CAQhE"}