@cloudcome/utils-core 1.1.1 → 1.2.1

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 (293) hide show
  1. package/README.md +18 -0
  2. package/dist/array.cjs +129 -0
  3. package/dist/array.cjs.map +1 -0
  4. package/dist/array.d.ts +171 -0
  5. package/dist/array.mjs +129 -0
  6. package/dist/array.mjs.map +1 -0
  7. package/dist/async.cjs +219 -0
  8. package/dist/async.cjs.map +1 -0
  9. package/dist/async.d.ts +137 -0
  10. package/dist/async.mjs +219 -0
  11. package/dist/async.mjs.map +1 -0
  12. package/dist/base64.cjs +16 -0
  13. package/dist/base64.cjs.map +1 -0
  14. package/dist/base64.d.ts +7 -0
  15. package/dist/base64.mjs +16 -0
  16. package/dist/base64.mjs.map +1 -0
  17. package/dist/cache.cjs +79 -0
  18. package/dist/cache.cjs.map +1 -0
  19. package/dist/cache.d.ts +90 -0
  20. package/dist/cache.mjs +79 -0
  21. package/dist/cache.mjs.map +1 -0
  22. package/{src/color/contrast.ts → dist/color/contrast.d.ts} +2 -12
  23. package/dist/color/distance.d.ts +8 -0
  24. package/dist/color/helpers.d.ts +2 -0
  25. package/dist/color/hex-hsl.d.ts +3 -0
  26. package/{src/color/hex-hsv.ts → dist/color/hex-hsv.d.ts} +3 -11
  27. package/{src/color/hex-hwb.ts → dist/color/hex-hwb.d.ts} +3 -11
  28. package/dist/color/hex-rgb.d.ts +18 -0
  29. package/{src/color/hsl-lighten.ts → dist/color/hsl-lighten.d.ts} +2 -7
  30. package/{src/color/hsv-brighten.ts → dist/color/hsv-brighten.d.ts} +2 -7
  31. package/{src/color/luminance.ts → dist/color/luminance.d.ts} +2 -9
  32. package/{src/color/mix.ts → dist/color/mix.d.ts} +2 -10
  33. package/dist/color/rgb-hsl.d.ts +23 -0
  34. package/{src/color/rgb-hsv.ts → dist/color/rgb-hsv.d.ts} +3 -30
  35. package/dist/color/rgb-hwb.d.ts +29 -0
  36. package/{src/color/rgb-lab.ts → dist/color/rgb-lab.d.ts} +3 -11
  37. package/dist/color/rgb-whiter.d.ts +12 -0
  38. package/dist/color/rgb-xyz.d.ts +22 -0
  39. package/{src/color/types.ts → dist/color/types.d.ts} +30 -12
  40. package/{src/color/xyz-lab.ts → dist/color/xyz-lab.d.ts} +3 -32
  41. package/dist/color.cjs +250 -0
  42. package/dist/color.cjs.map +1 -0
  43. package/dist/color.mjs +250 -0
  44. package/dist/color.mjs.map +1 -0
  45. package/dist/const.cjs +14 -0
  46. package/dist/const.cjs.map +1 -0
  47. package/dist/const.mjs +15 -0
  48. package/dist/const.mjs.map +1 -0
  49. package/dist/core.cjs +250 -0
  50. package/dist/core.cjs.map +1 -0
  51. package/dist/core.mjs +251 -0
  52. package/dist/core.mjs.map +1 -0
  53. package/dist/crypto/md5.d.mts +1 -0
  54. package/dist/crypto/sha1.d.mts +1 -0
  55. package/dist/crypto/sha256.d.mts +1 -0
  56. package/dist/crypto/sha512.d.mts +1 -0
  57. package/dist/crypto.cjs +812 -0
  58. package/dist/crypto.cjs.map +1 -0
  59. package/{src/crypto.ts → dist/crypto.d.ts} +4 -20
  60. package/dist/crypto.mjs +812 -0
  61. package/dist/crypto.mjs.map +1 -0
  62. package/dist/date/const.d.ts +6 -0
  63. package/dist/date/core.d.ts +52 -0
  64. package/dist/date/days.d.ts +23 -0
  65. package/{src/date/is.ts → dist/date/is.d.ts} +8 -102
  66. package/dist/date/relative.d.ts +44 -0
  67. package/dist/date/start-end.d.ts +73 -0
  68. package/dist/date/timezone.d.ts +67 -0
  69. package/dist/date/weeks.d.ts +72 -0
  70. package/dist/date.cjs +239 -0
  71. package/dist/date.cjs.map +1 -0
  72. package/dist/date.mjs +241 -0
  73. package/dist/date.mjs.map +1 -0
  74. package/dist/dict.cjs +2 -0
  75. package/dist/dict.cjs.map +1 -0
  76. package/dist/dict.mjs +2 -0
  77. package/dist/dict.mjs.map +1 -0
  78. package/dist/each.cjs +18 -0
  79. package/dist/each.cjs.map +1 -0
  80. package/dist/each.mjs +19 -0
  81. package/dist/each.mjs.map +1 -0
  82. package/dist/easing.cjs +151 -0
  83. package/dist/easing.cjs.map +1 -0
  84. package/dist/easing.d.ts +46 -0
  85. package/dist/easing.mjs +151 -0
  86. package/dist/easing.mjs.map +1 -0
  87. package/dist/emitter.cjs +94 -0
  88. package/dist/emitter.cjs.map +1 -0
  89. package/dist/emitter.d.ts +68 -0
  90. package/dist/emitter.mjs +94 -0
  91. package/dist/emitter.mjs.map +1 -0
  92. package/dist/enum.cjs +58 -0
  93. package/dist/enum.cjs.map +1 -0
  94. package/dist/enum.d.ts +68 -0
  95. package/dist/enum.mjs +58 -0
  96. package/dist/enum.mjs.map +1 -0
  97. package/dist/env.cjs +28 -0
  98. package/dist/env.cjs.map +1 -0
  99. package/{src/env.ts → dist/env.d.ts} +6 -30
  100. package/dist/env.mjs +28 -0
  101. package/dist/env.mjs.map +1 -0
  102. package/dist/error.cjs +12 -0
  103. package/dist/error.cjs.map +1 -0
  104. package/{src/error.ts → dist/error.d.ts} +3 -12
  105. package/dist/error.mjs +12 -0
  106. package/dist/error.mjs.map +1 -0
  107. package/dist/exception.cjs +22 -0
  108. package/dist/exception.cjs.map +1 -0
  109. package/dist/exception.d.ts +31 -0
  110. package/dist/exception.mjs +22 -0
  111. package/dist/exception.mjs.map +1 -0
  112. package/dist/fn.cjs +76 -0
  113. package/dist/fn.cjs.map +1 -0
  114. package/dist/fn.d.ts +102 -0
  115. package/dist/fn.mjs +76 -0
  116. package/dist/fn.mjs.map +1 -0
  117. package/dist/index.cjs +5 -0
  118. package/dist/index.cjs.map +1 -0
  119. package/dist/index.d.ts +1 -0
  120. package/dist/index.mjs +5 -0
  121. package/dist/index.mjs.map +1 -0
  122. package/dist/merge.cjs +87 -0
  123. package/dist/merge.cjs.map +1 -0
  124. package/dist/merge.mjs +88 -0
  125. package/dist/merge.mjs.map +1 -0
  126. package/dist/number.cjs +14 -0
  127. package/dist/number.cjs.map +1 -0
  128. package/dist/number.d.ts +153 -0
  129. package/dist/number.mjs +14 -0
  130. package/dist/number.mjs.map +1 -0
  131. package/{src/object/each.ts → dist/object/each.d.ts} +3 -23
  132. package/dist/object/get-set.d.ts +111 -0
  133. package/dist/object/is.d.ts +32 -0
  134. package/dist/object/merge.d.ts +72 -0
  135. package/{src/object/process.ts → dist/object/process.d.ts} +4 -38
  136. package/dist/object.cjs +130 -0
  137. package/dist/object.cjs.map +1 -0
  138. package/dist/object.mjs +130 -0
  139. package/dist/object.mjs.map +1 -0
  140. package/dist/path.cjs +77 -0
  141. package/dist/path.cjs.map +1 -0
  142. package/dist/path.d.ts +82 -0
  143. package/dist/path.mjs +77 -0
  144. package/dist/path.mjs.map +1 -0
  145. package/dist/promise.cjs +62 -0
  146. package/dist/promise.cjs.map +1 -0
  147. package/{src/promise.ts → dist/promise.d.ts} +6 -67
  148. package/dist/promise.mjs +62 -0
  149. package/dist/promise.mjs.map +1 -0
  150. package/dist/qs.cjs +47 -0
  151. package/dist/qs.cjs.map +1 -0
  152. package/{src/qs.ts → dist/qs.d.ts} +3 -60
  153. package/dist/qs.mjs +47 -0
  154. package/dist/qs.mjs.map +1 -0
  155. package/dist/regexp.cjs +66 -0
  156. package/dist/regexp.cjs.map +1 -0
  157. package/dist/regexp.d.ts +65 -0
  158. package/dist/regexp.mjs +66 -0
  159. package/dist/regexp.mjs.map +1 -0
  160. package/dist/string.cjs +16 -0
  161. package/dist/string.cjs.map +1 -0
  162. package/dist/string.d.ts +80 -0
  163. package/dist/string.mjs +16 -0
  164. package/dist/string.mjs.map +1 -0
  165. package/dist/string2.cjs +157 -0
  166. package/dist/string2.cjs.map +1 -0
  167. package/dist/string2.mjs +158 -0
  168. package/dist/string2.mjs.map +1 -0
  169. package/dist/time/from.d.ts +14 -0
  170. package/dist/time/to.d.ts +38 -0
  171. package/dist/time.cjs +82 -0
  172. package/dist/time.cjs.map +1 -0
  173. package/dist/time.mjs +82 -0
  174. package/dist/time.mjs.map +1 -0
  175. package/dist/timer.cjs +119 -0
  176. package/dist/timer.cjs.map +1 -0
  177. package/dist/timer.d.ts +96 -0
  178. package/{src/timer.ts → dist/timer.mjs} +17 -124
  179. package/dist/timer.mjs.map +1 -0
  180. package/dist/tree.cjs +125 -0
  181. package/dist/tree.cjs.map +1 -0
  182. package/dist/tree.d.ts +210 -0
  183. package/dist/tree.mjs +125 -0
  184. package/dist/tree.mjs.map +1 -0
  185. package/dist/type.cjs +78 -0
  186. package/dist/type.cjs.map +1 -0
  187. package/{src/type.ts → dist/type.d.ts} +20 -96
  188. package/dist/type.mjs +78 -0
  189. package/dist/type.mjs.map +1 -0
  190. package/dist/types.cjs +2 -0
  191. package/dist/types.cjs.map +1 -0
  192. package/{src/types.ts → dist/types.d.ts} +12 -33
  193. package/dist/types.mjs +2 -0
  194. package/dist/types.mjs.map +1 -0
  195. package/dist/unique.cjs +46 -0
  196. package/dist/unique.cjs.map +1 -0
  197. package/dist/unique.d.ts +22 -0
  198. package/dist/unique.mjs +46 -0
  199. package/dist/unique.mjs.map +1 -0
  200. package/dist/url.cjs +37 -0
  201. package/dist/url.cjs.map +1 -0
  202. package/dist/url.d.ts +53 -0
  203. package/dist/url.mjs +37 -0
  204. package/dist/url.mjs.map +1 -0
  205. package/dist/version.cjs +33 -0
  206. package/dist/version.cjs.map +1 -0
  207. package/dist/version.d.ts +32 -0
  208. package/dist/version.mjs +33 -0
  209. package/dist/version.mjs.map +1 -0
  210. package/package.json +8 -2
  211. package/CHANGELOG.md +0 -52
  212. package/src/array.ts +0 -312
  213. package/src/async.ts +0 -379
  214. package/src/base64.ts +0 -20
  215. package/src/cache.ts +0 -146
  216. package/src/color/distance.ts +0 -28
  217. package/src/color/helpers.ts +0 -23
  218. package/src/color/hex-hsl.ts +0 -11
  219. package/src/color/hex-rgb.ts +0 -39
  220. package/src/color/rgb-hsl.ts +0 -53
  221. package/src/color/rgb-hwb.ts +0 -56
  222. package/src/color/rgb-whiter.ts +0 -22
  223. package/src/color/rgb-xyz.ts +0 -62
  224. package/src/crypto/md5.mjs +0 -357
  225. package/src/crypto/sha1.mjs +0 -300
  226. package/src/crypto/sha256.mjs +0 -310
  227. package/src/crypto/sha512.mjs +0 -459
  228. package/src/date/const.ts +0 -6
  229. package/src/date/core.ts +0 -162
  230. package/src/date/days.ts +0 -51
  231. package/src/date/relative.ts +0 -92
  232. package/src/date/start-end.ts +0 -246
  233. package/src/date/timezone.ts +0 -220
  234. package/src/date/weeks.ts +0 -100
  235. package/src/dts/global.d.ts +0 -27
  236. package/src/easing.ts +0 -166
  237. package/src/emitter.ts +0 -117
  238. package/src/enum.ts +0 -171
  239. package/src/exception.ts +0 -68
  240. package/src/fn.ts +0 -197
  241. package/src/index.ts +0 -1
  242. package/src/number.ts +0 -236
  243. package/src/object/get-set.ts +0 -273
  244. package/src/object/is.ts +0 -128
  245. package/src/object/merge.ts +0 -180
  246. package/src/path.ts +0 -188
  247. package/src/regexp.ts +0 -156
  248. package/src/string.ts +0 -146
  249. package/src/time/from.ts +0 -57
  250. package/src/time/to.ts +0 -106
  251. package/src/tree.ts +0 -394
  252. package/src/unique.ts +0 -77
  253. package/src/url.ts +0 -93
  254. package/src/version.ts +0 -71
  255. package/test/array.test.ts +0 -332
  256. package/test/async-real.test.ts +0 -39
  257. package/test/async.test.ts +0 -375
  258. package/test/base64.test.ts +0 -32
  259. package/test/cache.test.ts +0 -83
  260. package/test/color.test.ts +0 -163
  261. package/test/crypto.test.ts +0 -34
  262. package/test/date-tz.test.ts +0 -206
  263. package/test/date.test.ts +0 -353
  264. package/test/easing.test.ts +0 -33
  265. package/test/emitter.test.ts +0 -71
  266. package/test/enum.test.ts +0 -113
  267. package/test/env.test.ts +0 -69
  268. package/test/error.test.ts +0 -58
  269. package/test/exception.test.ts +0 -43
  270. package/test/fn.test.ts +0 -263
  271. package/test/helpers.ts +0 -23
  272. package/test/index.test.ts +0 -6
  273. package/test/number.test.ts +0 -213
  274. package/test/object.test.ts +0 -309
  275. package/test/path.test.ts +0 -156
  276. package/test/promise.test.ts +0 -199
  277. package/test/qs.test.ts +0 -79
  278. package/test/regexp.test.ts +0 -97
  279. package/test/string.test.ts +0 -150
  280. package/test/time.test.ts +0 -214
  281. package/test/timer.test.ts +0 -114
  282. package/test/tree.test.ts +0 -348
  283. package/test/type.test.ts +0 -226
  284. package/test/unique.test.ts +0 -71
  285. package/test/url.test.ts +0 -136
  286. package/test/version.test.ts +0 -52
  287. package/tsconfig.json +0 -31
  288. package/vite.config.mts +0 -114
  289. /package/{src/color.ts → dist/color.d.ts} +0 -0
  290. /package/{src/date.ts → dist/date.d.ts} +0 -0
  291. /package/{src/dict.ts → dist/dict.d.ts} +0 -0
  292. /package/{src/object.ts → dist/object.d.ts} +0 -0
  293. /package/{src/time.ts → dist/time.d.ts} +0 -0
@@ -1,206 +0,0 @@
1
- import { dateFormat } from '@/date';
2
- import { TzDate } from '@/date';
3
-
4
- const gmtOrder = TzDate.getOrder();
5
- console.log(`当前时区 GMT${gmtOrder > 0 ? '+' : ''}${gmtOrder}`);
6
-
7
- describe('0 时区', () => {
8
- const offset = TzDate.getOffset(0);
9
-
10
- it('空入参', () => {
11
- // 时间戳与时区无关
12
- const tzNow = new TzDate({ offset }).getTime();
13
- const now = new Date().getTime();
14
- expect(tzNow).toBeLessThanOrEqual(now);
15
- // 误差小于 10ms
16
- expect(tzNow).toBeGreaterThanOrEqual(now - 10);
17
- });
18
-
19
- it('时间戳', () => {
20
- // 时间戳与时区无关
21
- const now = Date.now();
22
- const td = new TzDate({ offset, timestamp: now });
23
- const dt = new Date(now);
24
-
25
- expect(td.getTime()).toBe(dt.getTime());
26
- expect(td.getTimezoneOrder()).toBe(0);
27
- });
28
-
29
- it('年月日', () => {
30
- const localOffset = new Date().getTimezoneOffset() * 60 * 1000;
31
- const targetOffset = 0;
32
- const value = [2025, 5, 3, 12, 34, 56, 789] as const;
33
- const td = new TzDate({ offset, value });
34
-
35
- expect(td.toISOString()).toEqual('2025-06-03T12:34:56.789Z');
36
-
37
- // 0 时区与 UTC 时间戳一致
38
- expect(td.getTime()).toBe(Date.UTC(...value) + targetOffset);
39
- expect(td.getTime()).toBe(new Date(...value).getTime() - localOffset + targetOffset);
40
-
41
- expect([
42
- td.getFullYear(),
43
- td.getMonth(),
44
- td.getDate(),
45
- td.getHours(),
46
- td.getMinutes(),
47
- td.getSeconds(),
48
- td.getMilliseconds(),
49
- ]).toEqual(value);
50
-
51
- td.setFullYear(2024);
52
- expect(td.getFullYear()).toBe(2024);
53
- expect(td.getTime()).toEqual(getUtcTimestamp(td));
54
-
55
- td.setMonth(5);
56
- expect(td.getMonth()).toBe(5);
57
- expect(td.getTime()).toEqual(getUtcTimestamp(td));
58
-
59
- td.setDate(10);
60
- expect(td.getDate()).toBe(10);
61
- expect(td.getTime()).toEqual(getUtcTimestamp(td));
62
-
63
- td.setHours(12);
64
- expect(td.getHours()).toBe(12);
65
- expect(td.getTime()).toEqual(getUtcTimestamp(td));
66
-
67
- td.setMinutes(30);
68
- expect(td.getMinutes()).toBe(30);
69
- expect(td.getTime()).toEqual(getUtcTimestamp(td));
70
-
71
- td.setSeconds(45);
72
- expect(td.getSeconds()).toBe(45);
73
- expect(td.getTime()).toEqual(getUtcTimestamp(td));
74
-
75
- td.setMilliseconds(100);
76
- expect(td.getMilliseconds()).toBe(100);
77
- expect(td.getTime()).toEqual(getUtcTimestamp(td));
78
- });
79
- });
80
-
81
- describe('东 8 时区', () => {
82
- const offset = TzDate.getOffset(8);
83
-
84
- it('空入参', () => {
85
- // 时间戳与时区无关
86
- const tzNow = new TzDate({ offset }).getTime();
87
- const now = new Date().getTime();
88
- expect(tzNow).toBeLessThanOrEqual(now);
89
- // 误差小于 10ms
90
- expect(tzNow).toBeGreaterThanOrEqual(now - 10);
91
- });
92
-
93
- it('时间戳', () => {
94
- // 时间戳与时区无关
95
- const now = Date.now();
96
- const td = new TzDate({ offset, timestamp: now });
97
- const dt = new Date(now);
98
-
99
- expect(td.getTime()).toBe(dt.getTime());
100
- expect(td.getTimezoneOrder()).toBe(8);
101
- });
102
-
103
- it('年月日', () => {
104
- const localOffset = new Date().getTimezoneOffset() * 60 * 1000;
105
- const targetOffset = offset * 60 * 1000;
106
- const value = [2025, 5, 3, 12, 34, 56, 789] as const;
107
- const td = new TzDate({ offset, value: [...value] });
108
-
109
- expect(td.toISOString()).toEqual('2025-06-03T04:34:56.789Z');
110
-
111
- // 0 时区与 UTC 时间戳一致
112
- expect(td.getTime()).toBe(Date.UTC(...value) + targetOffset);
113
- expect(td.getTime()).toBe(new Date(...value).getTime() - localOffset + targetOffset);
114
-
115
- expect([
116
- td.getFullYear(),
117
- td.getMonth(),
118
- td.getDate(),
119
- td.getHours(),
120
- td.getMinutes(),
121
- td.getSeconds(),
122
- td.getMilliseconds(),
123
- ]).toEqual(value);
124
-
125
- td.setFullYear(2024);
126
- expect(td.getFullYear()).toBe(2024);
127
- expect(td.getTime()).toEqual(getUtcTimestamp(td, offset));
128
-
129
- td.setMonth(5);
130
- expect(td.getMonth()).toBe(5);
131
- expect(td.getTime()).toEqual(getUtcTimestamp(td, offset));
132
-
133
- td.setDate(10);
134
- expect(td.getDate()).toBe(10);
135
- expect(td.getTime()).toEqual(getUtcTimestamp(td, offset));
136
-
137
- td.setHours(12);
138
- expect(td.getHours()).toBe(12);
139
- expect(td.getTime()).toEqual(getUtcTimestamp(td, offset));
140
-
141
- td.setMinutes(30);
142
- expect(td.getMinutes()).toBe(30);
143
- expect(td.getTime()).toEqual(getUtcTimestamp(td, offset));
144
-
145
- td.setSeconds(45);
146
- expect(td.getSeconds()).toBe(45);
147
- expect(td.getTime()).toEqual(getUtcTimestamp(td, offset));
148
-
149
- td.setMilliseconds(100);
150
- expect(td.getMilliseconds()).toBe(100);
151
- expect(td.getTime()).toEqual(getUtcTimestamp(td, offset));
152
- });
153
- });
154
-
155
- describe('时区转换', () => {
156
- it('时间戳', () => {
157
- const timestamp = Date.now();
158
- const gmt8Date = new TzDate({
159
- offset: TzDate.getOffset(8),
160
- timestamp,
161
- });
162
- const gmt0Date = TzDate.from(gmt8Date, 0);
163
-
164
- console.log('gmt8:', dateFormat(gmt8Date));
165
- console.log('gmt0:', dateFormat(gmt0Date));
166
-
167
- let gmt8Hours = gmt8Date.getHours();
168
- const gmt0Hours = gmt0Date.getHours();
169
-
170
- // 不是同一天
171
- if (gmt8Date.getDate() !== gmt0Date.getDate()) {
172
- gmt8Hours += 24;
173
- }
174
-
175
- expect(gmt8Hours - gmt0Hours).toBe(8);
176
- expect(gmt0Date.getTime()).toBe(gmt0Date.getTime());
177
- });
178
-
179
- it('日期', () => {
180
- const value = [2024, 5, 10, 12, 30, 45, 100] as const;
181
- const gmt8Td = new TzDate({
182
- offset: TzDate.getOffset(8),
183
- value,
184
- });
185
- const gmt0Td = TzDate.from(gmt8Td, 0);
186
-
187
- expect(gmt8Td.getHours()).toBe(12);
188
- expect(gmt0Td.getHours()).toBe(4);
189
- expect(gmt0Td.getTime()).toBe(gmt0Td.getTime());
190
- });
191
- });
192
-
193
- function getUtcTimestamp(td: TzDate, offset = 0) {
194
- return (
195
- Date.UTC(
196
- td.getFullYear(),
197
- td.getMonth(),
198
- td.getDate(),
199
- td.getHours(),
200
- td.getMinutes(),
201
- td.getSeconds(),
202
- td.getMilliseconds(),
203
- ) +
204
- offset * 60 * 1000
205
- );
206
- }
package/test/date.test.ts DELETED
@@ -1,353 +0,0 @@
1
- import {
2
- DATE_DAY_MS,
3
- DATE_HOUR_MS,
4
- DATE_MINUTE_MS,
5
- DATE_SECOND_MS,
6
- type TDateRelativeTemplates,
7
- dateDaysInMonth,
8
- dateDaysInYear,
9
- dateEndInDay,
10
- dateEndInHour,
11
- dateEndInMinute,
12
- dateEndInMonth,
13
- dateEndInSecond,
14
- dateEndInYear,
15
- dateFormat,
16
- dateParse,
17
- dateRelative,
18
- dateStartInDay,
19
- dateStartInHour,
20
- dateStartInMinute,
21
- dateStartInMonth,
22
- dateStartInSecond,
23
- dateStartInYear,
24
- isLeapYear,
25
- isSameDateInDay,
26
- isSameDateInHour,
27
- isSameDateInMinute,
28
- isSameDateInMonth,
29
- isSameDateInSecond,
30
- isSameDateInYear,
31
- isValidDate,
32
- } from '@/date';
33
- import { describe, expect, it } from 'vitest';
34
-
35
- describe('isValidDate', () => {
36
- it('应正确判断有效的日期对象', () => {
37
- expect(isValidDate(new Date())).toBe(true);
38
- expect(isValidDate(new Date('2023-01-01'))).toBe(true);
39
- });
40
-
41
- it('应正确判断无效的日期对象', () => {
42
- expect(isValidDate('2023-01-01')).toBe(false);
43
- expect(isValidDate(Number.NaN)).toBe(false);
44
- expect(isValidDate(123456789)).toBe(false);
45
- });
46
- });
47
-
48
- describe('dateParse', () => {
49
- it('应正确解析数值为日期对象', () => {
50
- const date = dateParse(1672531200000);
51
- expect(date.getFullYear()).toBe(2023);
52
- expect(date.getMonth()).toBe(0);
53
- expect(date.getDate()).toBe(1);
54
- });
55
-
56
- it('应正确解析字符串为日期对象', () => {
57
- const date = dateParse('2023-01-01');
58
- expect(date.getFullYear()).toBe(2023);
59
- expect(date.getMonth()).toBe(0);
60
- expect(date.getDate()).toBe(1);
61
- });
62
-
63
- it('应正确解析 Date 对象', () => {
64
- const inputDate = new Date('2023-01-01');
65
- const date = dateParse(inputDate);
66
- expect(date.getTime()).toBe(inputDate.getTime());
67
- });
68
-
69
- it('应抛出 SyntaxError 当解析无效的日期字符串', () => {
70
- expect(() => dateParse('invalid date')).toThrow(SyntaxError);
71
- });
72
- });
73
-
74
- describe('dateStringify', () => {
75
- it('应正确格式化日期为默认模板', () => {
76
- const date = new Date('2023-01-01T00:00:00');
77
- expect(dateFormat(date)).toBe('2023-01-01 00:00:00');
78
- });
79
-
80
- it('12/24 小时制', () => {
81
- const date = new Date('2023-01-01T15:22:33');
82
- expect(dateFormat(date, 'hh/HH')).toBe('03/15');
83
- });
84
-
85
- it('应正确格式化日期为自定义模板', () => {
86
- const date = new Date('2023-01-01T12:34:56');
87
- expect(dateFormat(date, 'YYYY/MM/DD HH:mm:ss')).toBe('2023/01/01 12:34:56');
88
- expect(dateFormat(date, 'YYYY年MM月DD日')).toBe('2023年01月01日');
89
- });
90
-
91
- it('应正确处理数值和字符串作为日期值', () => {
92
- expect(dateFormat(1672531200000, 'YYYY-MM-DD')).toBe('2023-01-01');
93
- expect(dateFormat('2023-01-01', 'YYYY/MM/DD')).toBe('2023/01/01');
94
- });
95
- });
96
-
97
- describe('dateRelative', () => {
98
- const now = new Date(1999, 9, 9, 9, 9, 9, 9).getTime();
99
-
100
- it('前时间', () => {
101
- expect(dateRelative(now, now)).toEqual('刚刚');
102
- expect(dateRelative(now - 1000 * 9, now)).toEqual('刚刚');
103
- expect(dateRelative(now - 1000 * 10, now)).toEqual('10 秒前');
104
- expect(dateRelative(now - 1000 * 59, now)).toEqual('59 秒前');
105
- expect(dateRelative(now - 1000 * 59 - 999, now)).toEqual('59 秒前');
106
- expect(dateRelative(now - 1000 * 60, now)).toEqual('1 分钟前');
107
- expect(dateRelative(now - 1000 * 60 * 59, now)).toEqual('59 分钟前');
108
- expect(dateRelative(now - 1000 * 60 * 60, now)).toEqual('1 小时前');
109
- expect(dateRelative(now - 1000 * 60 * 60 * 23, now)).toEqual('23 小时前');
110
- expect(dateRelative(now - 1000 * 60 * 60 * 24, now)).toEqual('昨天');
111
- expect(dateRelative(now - 1000 * 60 * 60 * 24 * 2, now)).toEqual('前天');
112
- expect(dateRelative(now - 1000 * 60 * 60 * 24 * 3, now)).toEqual('3 天前');
113
- expect(dateRelative(now - 1000 * 60 * 60 * 24 * 29, now)).toEqual('29 天前');
114
- expect(dateRelative(now - 1000 * 60 * 60 * 24 * 30, now)).toEqual('1999年09月09日');
115
- });
116
-
117
- it('后时间', () => {
118
- expect(dateRelative(now, now)).toEqual('刚刚');
119
- expect(dateRelative(now + 1000 * 9, now)).toEqual('刚刚');
120
- expect(dateRelative(now + 1000 * 10, now)).toEqual('10 秒后');
121
- expect(dateRelative(now + 1000 * 59, now)).toEqual('59 秒后');
122
- expect(dateRelative(now + 1000 * 60, now)).toEqual('1 分钟后');
123
- expect(dateRelative(now + 1000 * 60 * 59, now)).toEqual('59 分钟后');
124
- expect(dateRelative(now + 1000 * 60 * 60, now)).toEqual('1 小时后');
125
- expect(dateRelative(now + 1000 * 60 * 60 * 23, now)).toEqual('23 小时后');
126
- expect(dateRelative(now + 1000 * 60 * 60 * 24, now)).toEqual('明天');
127
- expect(dateRelative(now + 1000 * 60 * 60 * 24 * 2, now)).toEqual('后天');
128
- expect(dateRelative(now + 1000 * 60 * 60 * 24 * 3, now)).toEqual('3 天后');
129
- expect(dateRelative(now + 1000 * 60 * 60 * 24 * 29, now)).toEqual('29 天后');
130
- expect(dateRelative(now + 1000 * 60 * 60 * 24 * 30, now)).toEqual('1999年11月08日');
131
- });
132
-
133
- it('自定义模板', () => {
134
- const myTemplates: TDateRelativeTemplates = [
135
- [1, 100, 'in {n} seconds'],
136
- [0, Number.POSITIVE_INFINITY, 'YYYY-MM-DD HH:mm:ss'],
137
- ];
138
- expect(dateRelative(now - 1000 * 59, now, myTemplates)).toEqual('in 59 seconds');
139
- expect(dateRelative(now - 1000 * 99, now, myTemplates)).toEqual('in 99 seconds');
140
- expect(dateRelative(now - 1000 * 100, now, myTemplates)).toEqual('1999-10-09 09:07:29');
141
- expect(dateRelative(new Date(), myTemplates)).toEqual('in 1 seconds');
142
- });
143
- });
144
-
145
- describe('dateOfStart', () => {
146
- it('应正确返回指定时间单位的起始时间', () => {
147
- const date = new Date(2023, 5, 15, 12, 30, 45, 500); // 2023-06-15 12:30:45.500
148
-
149
- // 测试秒级起始时间
150
- const secondStart = dateStartInSecond(date);
151
- expect(secondStart.getMilliseconds()).toBe(0);
152
- expect(secondStart.getSeconds()).toBe(45);
153
- expect(secondStart.getMinutes()).toBe(30);
154
- expect(secondStart.getHours()).toBe(12);
155
- expect(secondStart.getDate()).toBe(15);
156
- expect(secondStart.getMonth()).toBe(5);
157
- expect(secondStart.getFullYear()).toBe(2023);
158
-
159
- // 测试分钟级起始时间
160
- const minuteStart = dateStartInMinute(date);
161
- expect(minuteStart.getMilliseconds()).toBe(0);
162
- expect(minuteStart.getSeconds()).toBe(0);
163
- expect(minuteStart.getMinutes()).toBe(30);
164
- expect(minuteStart.getHours()).toBe(12);
165
- expect(minuteStart.getDate()).toBe(15);
166
- expect(minuteStart.getMonth()).toBe(5);
167
- expect(minuteStart.getFullYear()).toBe(2023);
168
-
169
- // 测试小时级起始时间
170
- const hourStart = dateStartInHour(date);
171
- expect(hourStart.getMilliseconds()).toBe(0);
172
- expect(hourStart.getSeconds()).toBe(0);
173
- expect(hourStart.getMinutes()).toBe(0);
174
- expect(hourStart.getHours()).toBe(12);
175
- expect(hourStart.getDate()).toBe(15);
176
- expect(hourStart.getMonth()).toBe(5);
177
- expect(hourStart.getFullYear()).toBe(2023);
178
-
179
- // 测试天级起始时间
180
- const dayStart = dateStartInDay(date);
181
- expect(dayStart.getMilliseconds()).toBe(0);
182
- expect(dayStart.getSeconds()).toBe(0);
183
- expect(dayStart.getMinutes()).toBe(0);
184
- expect(dayStart.getHours()).toBe(0);
185
- expect(dayStart.getDate()).toBe(15);
186
- expect(dayStart.getMonth()).toBe(5);
187
- expect(dayStart.getFullYear()).toBe(2023);
188
-
189
- // 测试月级起始时间
190
- const monthStart = dateStartInMonth(date);
191
- expect(monthStart.getMilliseconds()).toBe(0);
192
- expect(monthStart.getSeconds()).toBe(0);
193
- expect(monthStart.getMinutes()).toBe(0);
194
- expect(monthStart.getHours()).toBe(0);
195
- expect(monthStart.getDate()).toBe(1);
196
- expect(monthStart.getMonth()).toBe(5);
197
- expect(monthStart.getFullYear()).toBe(2023);
198
-
199
- // 测试年级起始时间
200
- const yearStart = dateStartInYear(date);
201
- expect(yearStart.getMilliseconds()).toBe(0);
202
- expect(yearStart.getSeconds()).toBe(0);
203
- expect(yearStart.getMinutes()).toBe(0);
204
- expect(yearStart.getHours()).toBe(0);
205
- expect(yearStart.getDate()).toBe(1);
206
- expect(yearStart.getMonth()).toBe(0);
207
- expect(yearStart.getFullYear()).toBe(2023);
208
- });
209
- });
210
-
211
- describe('dateOfEnd', () => {
212
- it('应正确返回指定时间单位的结束时间', () => {
213
- const date = new Date(2023, 1, 15, 12, 30, 45, 500); // 2023-02-15 12:30:45.500
214
-
215
- // 测试秒级结束时间
216
- const secondEnd = dateEndInSecond(date);
217
- expect(secondEnd.getMilliseconds()).toBe(999);
218
- expect(secondEnd.getSeconds()).toBe(45);
219
- expect(secondEnd.getMinutes()).toBe(30);
220
- expect(secondEnd.getHours()).toBe(12);
221
- expect(secondEnd.getDate()).toBe(15);
222
- expect(secondEnd.getMonth()).toBe(1);
223
- expect(secondEnd.getFullYear()).toBe(2023);
224
-
225
- // 测试分钟级结束时间
226
- const minuteEnd = dateEndInMinute(date);
227
- expect(minuteEnd.getMilliseconds()).toBe(999);
228
- expect(minuteEnd.getSeconds()).toBe(59);
229
- expect(minuteEnd.getMinutes()).toBe(30);
230
- expect(minuteEnd.getHours()).toBe(12);
231
- expect(minuteEnd.getDate()).toBe(15);
232
- expect(minuteEnd.getMonth()).toBe(1);
233
- expect(minuteEnd.getFullYear()).toBe(2023);
234
-
235
- // 测试小时级结束时间
236
- const hourEnd = dateEndInHour(date);
237
- expect(hourEnd.getMilliseconds()).toBe(999);
238
- expect(hourEnd.getSeconds()).toBe(59);
239
- expect(hourEnd.getMinutes()).toBe(59);
240
- expect(hourEnd.getHours()).toBe(12);
241
- expect(hourEnd.getDate()).toBe(15);
242
- expect(hourEnd.getMonth()).toBe(1);
243
- expect(hourEnd.getFullYear()).toBe(2023);
244
-
245
- // 测试天级结束时间
246
- const dayEnd = dateEndInDay(date);
247
- expect(dayEnd.getMilliseconds()).toBe(999);
248
- expect(dayEnd.getSeconds()).toBe(59);
249
- expect(dayEnd.getMinutes()).toBe(59);
250
- expect(dayEnd.getHours()).toBe(23);
251
- expect(dayEnd.getDate()).toBe(15);
252
- expect(dayEnd.getMonth()).toBe(1);
253
- expect(dayEnd.getFullYear()).toBe(2023);
254
-
255
- // 测试月级结束时间
256
- const monthEnd = dateEndInMonth(date);
257
- expect(monthEnd.getMilliseconds()).toBe(999);
258
- expect(monthEnd.getSeconds()).toBe(59);
259
- expect(monthEnd.getMinutes()).toBe(59);
260
- expect(monthEnd.getHours()).toBe(23);
261
- expect(monthEnd.getDate()).toBe(28);
262
- expect(monthEnd.getMonth()).toBe(1);
263
- expect(monthEnd.getFullYear()).toBe(2023);
264
-
265
- // 测试年级结束时间
266
- const yearEnd = dateEndInYear(date);
267
- expect(yearEnd.getMilliseconds()).toBe(999);
268
- expect(yearEnd.getSeconds()).toBe(59);
269
- expect(yearEnd.getMinutes()).toBe(59);
270
- expect(yearEnd.getHours()).toBe(23);
271
- expect(yearEnd.getDate()).toBe(31);
272
- expect(yearEnd.getMonth()).toBe(11);
273
- expect(yearEnd.getFullYear()).toBe(2023);
274
- });
275
- });
276
-
277
- describe('dateDaysInMonth', () => {
278
- it('应正确计算指定日期所在月的天数', () => {
279
- expect(dateDaysInMonth(new Date('2023-02-15'))).toBe(28); // 非闰年2月
280
- expect(dateDaysInMonth(new Date('2024-02-15'))).toBe(29); // 闰年2月
281
- expect(dateDaysInMonth(new Date('2023-04-15'))).toBe(30); // 4月
282
- expect(dateDaysInMonth(new Date('2023-07-15'))).toBe(31); // 7月
283
- });
284
-
285
- it('默认应计算指定日期所在月的天数', () => {
286
- expect(dateDaysInMonth(new Date('2023-02-15'))).toBe(28); // 默认计算月天数
287
- });
288
- });
289
-
290
- describe('dateDaysInYear', () => {
291
- it('应正确计算指定日期所在年的天数', () => {
292
- expect(dateDaysInYear(new Date('2023-02-15'))).toBe(365); // 非闰年
293
- expect(dateDaysInYear(new Date('2024-02-15'))).toBe(366); // 闰年
294
- });
295
- });
296
-
297
- describe('isSameDate', () => {
298
- const date1 = new Date(2023, 5, 15, 12, 30, 45, 500); // 2023-06-15 12:30:45.500
299
- const date2 = new Date(2023, 5, 15, 13, 30, 45, 500); // 2023-06-15 13:30:45.500
300
- const date3 = new Date(2023, 5, 16, 12, 30, 45, 500); // 2023-06-16 12:30:45.500
301
- const date4 = new Date(2023, 6, 15, 12, 30, 45, 500); // 2023-07-15 12:30:45.500
302
- const date5 = new Date(2024, 5, 15, 12, 30, 45, 500); // 2024-06-15 12:30:45.500
303
-
304
- it('应正确比较年份', () => {
305
- expect(isSameDateInYear(date1, date2)).toBe(true);
306
- expect(isSameDateInYear(date1, date5)).toBe(false);
307
- });
308
-
309
- it('应正确比较月份', () => {
310
- expect(isSameDateInMonth(date1, date2)).toBe(true);
311
- expect(isSameDateInMonth(date1, date4)).toBe(false);
312
- });
313
-
314
- it('应正确比较天数', () => {
315
- expect(isSameDateInDay(date1, date2)).toBe(true);
316
- expect(isSameDateInDay(date1, date3)).toBe(false);
317
- });
318
-
319
- it('应正确比较小时', () => {
320
- expect(isSameDateInHour(date1, date2)).toBe(false);
321
- expect(isSameDateInHour(date1, new Date(2023, 5, 15, 12, 0, 0, 0))).toBe(true);
322
- });
323
-
324
- it('应正确比较分钟', () => {
325
- expect(isSameDateInMinute(date1, date2)).toBe(false);
326
- expect(isSameDateInMinute(date1, new Date(2023, 5, 15, 12, 30, 0, 0))).toBe(true);
327
- });
328
-
329
- it('应正确比较秒', () => {
330
- expect(isSameDateInSecond(date1, date2)).toBe(false);
331
- expect(isSameDateInSecond(date1, '2023-06-15 12:30:45.0')).toBe(true);
332
- });
333
-
334
- it('应正确处理字符串和数值作为日期值', () => {
335
- expect(isSameDateInDay('2023-06-15', '2023-06-15')).toBe(true);
336
- expect(isSameDateInDay(1686814245500, 1686814245511)).toBe(true);
337
- expect(isSameDateInDay('2023-06-15', '2023-06-16')).toBe(false);
338
- });
339
- });
340
-
341
- describe('isLeapYear', () => {
342
- it('应正确判断闰年', () => {
343
- expect(isLeapYear(2020)).toBe(true);
344
- expect(isLeapYear(2000)).toBe(true);
345
- expect(isLeapYear(2024)).toBe(true);
346
- });
347
-
348
- it('应正确判断平年', () => {
349
- expect(isLeapYear(2021)).toBe(false);
350
- expect(isLeapYear(1900)).toBe(false);
351
- expect(isLeapYear(1999)).toBe(false);
352
- });
353
- });
@@ -1,33 +0,0 @@
1
- import { createEasingFn } from '@/easing';
2
- import { describe, expect, it } from 'vitest';
3
-
4
- describe('createEasingFn', () => {
5
- it('应正确创建线性缓动函数', () => {
6
- const linearEasing = createEasingFn(0, 0, 1, 1);
7
- expect(linearEasing(0)).toBe(0);
8
- expect(linearEasing(0.5)).toBe(0.5);
9
- expect(linearEasing(1)).toBe(1);
10
- });
11
-
12
- it('应正确创建自定义缓动函数', () => {
13
- const customEasing = createEasingFn(0.25, 0.1, 0.25, 1);
14
- expect(customEasing(0)).toBe(0);
15
- expect(customEasing(0.5)).toBeCloseTo(0.8, 1);
16
- expect(customEasing(1)).toBe(1);
17
- });
18
-
19
- it('应抛出错误当 mX1 或 mX2 不在 [0, 1] 范围内', () => {
20
- expect(() => createEasingFn(-0.1, 0.5, 0.5, 1)).toThrow('bezier x values must be in [0, 1] range');
21
- expect(() => createEasingFn(1.1, 0.5, 0.5, 1)).toThrow('bezier x values must be in [0, 1] range');
22
- expect(() => createEasingFn(0.5, 0.5, -0.1, 1)).toThrow('bezier x values must be in [0, 1] range');
23
- expect(() => createEasingFn(0.5, 0.5, 1.1, 1)).toThrow('bezier x values must be in [0, 1] range');
24
- });
25
-
26
- it('应返回 LinearEasing 当 mX1=mY1 且 mX2=mY2', () => {
27
- const linearEasing = createEasingFn(0, 0, 1, 1);
28
- const customLinearEasing = createEasingFn(0.5, 0.5, 0.5, 0.5);
29
- expect(customLinearEasing(0)).toBe(linearEasing(0));
30
- expect(customLinearEasing(0.5)).toBe(linearEasing(0.5));
31
- expect(customLinearEasing(1)).toBe(linearEasing(1));
32
- });
33
- });
@@ -1,71 +0,0 @@
1
- import { Emitter } from '@/emitter';
2
- import { beforeEach, describe, expect, it, vi } from 'vitest';
3
-
4
- type TestEvents = {
5
- click: [x: number, y: number];
6
- change: [value: string];
7
- };
8
-
9
- describe('Emitter', () => {
10
- let emitter: Emitter<TestEvents>;
11
-
12
- beforeEach(() => {
13
- emitter = new Emitter<TestEvents>();
14
- });
15
-
16
- it('应正确注册和触发事件', () => {
17
- const clickHandler = vi.fn();
18
- emitter.on('click', clickHandler);
19
- emitter.emit('click', 10, 20);
20
- expect(clickHandler).toHaveBeenCalledWith(10, 20);
21
- });
22
-
23
- it('应按注册顺序触发监听器', () => {
24
- const calls: number[] = [];
25
- emitter.on('click', () => calls.push(1));
26
- emitter.on('click', () => calls.push(2));
27
- emitter.emit('click', 0, 0);
28
- expect(calls).toEqual([1, 2]);
29
- });
30
-
31
- it('应在监听器返回 false 时中断触发', () => {
32
- const handler1 = vi.fn().mockReturnValue(false);
33
- const handler2 = vi.fn();
34
- emitter.on('click', handler1);
35
- emitter.on('click', handler2);
36
- emitter.emit('click', 0, 0);
37
- expect(handler1).toHaveBeenCalled();
38
- expect(handler2).not.toHaveBeenCalled();
39
- });
40
-
41
- it('应移除特定事件的特定监听器', () => {
42
- const handler = vi.fn();
43
- emitter.on('click', handler);
44
- emitter.off('click', handler);
45
- emitter.emit('click', 0, 0);
46
- expect(handler).not.toHaveBeenCalled();
47
- });
48
-
49
- it('应移除特定事件的所有监听器', () => {
50
- const handler1 = vi.fn();
51
- const handler2 = vi.fn();
52
- emitter.on('click', handler1);
53
- emitter.on('click', handler2);
54
- emitter.off('click');
55
- emitter.emit('click', 0, 0);
56
- expect(handler1).not.toHaveBeenCalled();
57
- expect(handler2).not.toHaveBeenCalled();
58
- });
59
-
60
- it('应移除所有事件的所有监听器', () => {
61
- const clickHandler = vi.fn();
62
- const changeHandler = vi.fn();
63
- emitter.on('click', clickHandler);
64
- emitter.on('change', changeHandler);
65
- emitter.off();
66
- emitter.emit('click', 0, 0);
67
- emitter.emit('change', 'test');
68
- expect(clickHandler).not.toHaveBeenCalled();
69
- expect(changeHandler).not.toHaveBeenCalled();
70
- });
71
- });