@hkdigital/lib-sveltekit 0.1.62 → 0.1.65

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 (209) hide show
  1. package/README.md +135 -135
  2. package/dist/assets/autospuiten/car-paint-picker.js +41 -41
  3. package/dist/assets/autospuiten/labels.js +7 -7
  4. package/dist/classes/data/IterableTree.js +243 -243
  5. package/dist/classes/data/Selector.js +190 -190
  6. package/dist/classes/data/index.js +2 -2
  7. package/dist/classes/index.js +4 -4
  8. package/dist/classes/promise/HkPromise.js +377 -377
  9. package/dist/classes/promise/index.js +1 -1
  10. package/dist/classes/stores/SubscribersCount.js +107 -107
  11. package/dist/classes/stores/index.js +1 -1
  12. package/dist/classes/streams/LogTransformStream.js +19 -19
  13. package/dist/classes/streams/ServerEventsStore.js +110 -110
  14. package/dist/classes/streams/TimeStampSource.js +26 -26
  15. package/dist/classes/streams/index.js +3 -3
  16. package/dist/classes/svelte/audio/AudioLoader.svelte.js +58 -58
  17. package/dist/classes/svelte/audio/AudioScene.svelte.js +295 -295
  18. package/dist/classes/svelte/audio/mocks.js +35 -35
  19. package/dist/classes/svelte/finite-state-machine/FiniteStateMachine.svelte.js +133 -133
  20. package/dist/classes/svelte/finite-state-machine/index.js +1 -1
  21. package/dist/classes/svelte/image/ImageLoader.svelte.js +47 -47
  22. package/dist/classes/svelte/image/ImageScene.svelte.js +253 -253
  23. package/dist/classes/svelte/image/ImageVariantsLoader.svelte.js +152 -152
  24. package/dist/classes/svelte/image/index.js +4 -4
  25. package/dist/classes/svelte/image/mocks.js +35 -35
  26. package/dist/classes/svelte/image/typedef.js +8 -8
  27. package/dist/classes/svelte/index.js +14 -14
  28. package/dist/classes/svelte/loading-state-machine/LoadingStateMachine.svelte.js +109 -109
  29. package/dist/classes/svelte/loading-state-machine/constants.js +16 -16
  30. package/dist/classes/svelte/loading-state-machine/index.js +3 -3
  31. package/dist/classes/svelte/network-loader/NetworkLoader.svelte.js +331 -331
  32. package/dist/classes/svelte/network-loader/constants.js +3 -3
  33. package/dist/classes/svelte/network-loader/index.js +3 -3
  34. package/dist/classes/svelte/network-loader/mocks.js +30 -30
  35. package/dist/classes/svelte/network-loader/typedef.js +8 -8
  36. package/dist/components/area/HkArea.svelte +49 -49
  37. package/dist/components/area/HkGridArea.svelte +77 -77
  38. package/dist/components/area/index.js +2 -2
  39. package/dist/components/buttons/button/Button.svelte +82 -82
  40. package/dist/components/buttons/button-icon-steeze/SteezeIconButton.svelte +30 -30
  41. package/dist/components/buttons/button-text/TextButton.svelte +21 -21
  42. package/dist/components/buttons/index.js +3 -3
  43. package/dist/components/debug/debug-panel-design-scaling/DebugPanelDesignScaling.svelte +146 -146
  44. package/dist/components/debug/index.js +1 -1
  45. package/dist/components/hkdev/blocks/TextBlock.svelte +46 -46
  46. package/dist/components/hkdev/buttons/CheckButton.svelte +62 -62
  47. package/dist/components/icons/HkIcon.svelte +86 -86
  48. package/dist/components/icons/HkTabIcon.svelte +116 -116
  49. package/dist/components/icons/SteezeIcon.svelte +97 -97
  50. package/dist/components/icons/index.js +6 -6
  51. package/dist/components/icons/typedef.js +16 -16
  52. package/dist/components/index.js +2 -2
  53. package/dist/components/inputs/index.js +1 -1
  54. package/dist/components/inputs/text-input/TestTextInput.svelte__ +102 -102
  55. package/dist/components/inputs/text-input/TextInput.svelte +223 -223
  56. package/dist/components/inputs/text-input/TextInput.svelte___ +83 -83
  57. package/dist/components/inputs/text-input/assets/IconInvalid.svelte +14 -14
  58. package/dist/components/inputs/text-input/assets/IconValid.svelte +12 -12
  59. package/dist/components/layout/grid-layers/GridLayers.svelte +167 -167
  60. package/dist/components/layout/index.js +1 -1
  61. package/dist/components/panels/index.js +1 -1
  62. package/dist/components/panels/panel/Panel.svelte +43 -43
  63. package/dist/components/rows/index.js +3 -3
  64. package/dist/components/rows/panel-grid-row/PanelGridRow.svelte +104 -104
  65. package/dist/components/rows/panel-row-2/PanelRow2.svelte +40 -40
  66. package/dist/components/tab-bar/HkTabBar.state.svelte.js +149 -149
  67. package/dist/components/tab-bar/HkTabBar.svelte +74 -74
  68. package/dist/components/tab-bar/HkTabBarSelector.state.svelte.js +93 -93
  69. package/dist/components/tab-bar/HkTabBarSelector.svelte +49 -49
  70. package/dist/components/tab-bar/index.js +17 -17
  71. package/dist/components/tab-bar/typedef.js +8 -8
  72. package/dist/config/imagetools-config.js +189 -189
  73. package/dist/config/imagetools.d.ts +71 -71
  74. package/dist/config/typedef.js +8 -8
  75. package/dist/constants/bases.js +13 -13
  76. package/dist/constants/errors/api.js +9 -9
  77. package/dist/constants/errors/generic.js +5 -5
  78. package/dist/constants/errors/index.js +3 -3
  79. package/dist/constants/errors/jwt.js +5 -5
  80. package/dist/constants/http/headers.js +6 -6
  81. package/dist/constants/http/index.js +2 -2
  82. package/dist/constants/http/methods.js +2 -2
  83. package/dist/constants/index.js +3 -3
  84. package/dist/constants/mime/application.js +5 -5
  85. package/dist/constants/mime/audio.js +13 -13
  86. package/dist/constants/mime/image.js +3 -3
  87. package/dist/constants/mime/index.js +4 -4
  88. package/dist/constants/mime/text.js +2 -2
  89. package/dist/constants/regexp/index.js +31 -31
  90. package/dist/constants/regexp/inspiratie.js__ +95 -95
  91. package/dist/constants/regexp/text.js +49 -49
  92. package/dist/constants/regexp/user.js +32 -32
  93. package/dist/constants/regexp/web.js +3 -3
  94. package/dist/constants/state-labels/input-states.js +11 -11
  95. package/dist/constants/state-labels/submit-states.js +4 -4
  96. package/dist/constants/time.js +28 -28
  97. package/dist/css/utilities.css +43 -43
  98. package/dist/design/design-config.js +73 -73
  99. package/dist/design/tailwind-theme-extend.js +158 -158
  100. package/dist/schemas/index.js +1 -1
  101. package/dist/schemas/validate-url.js +180 -180
  102. package/dist/server/index.js +1 -1
  103. package/dist/server/logger.js +94 -94
  104. package/dist/states/index.js +1 -1
  105. package/dist/states/navigation.svelte.js +55 -55
  106. package/dist/stores/index.js +1 -1
  107. package/dist/stores/theme.js +80 -80
  108. package/dist/themes/hkdev/components/blocks/text-block.css +41 -41
  109. package/dist/themes/hkdev/components/boxes/game-box.css +12 -12
  110. package/dist/themes/hkdev/components/buttons/button-icon-steeze.css +22 -22
  111. package/dist/themes/hkdev/components/buttons/button-text.css +32 -32
  112. package/dist/themes/hkdev/components/buttons/button.css +142 -142
  113. package/dist/themes/hkdev/components/buttons/skip-button.css +6 -6
  114. package/dist/themes/hkdev/components/icons/icon-steeze.css +22 -22
  115. package/dist/themes/hkdev/components/inputs/text-input.css +104 -104
  116. package/dist/themes/hkdev/components/panels/panel.css +27 -27
  117. package/dist/themes/hkdev/components/rows/panel-grid-row.css +6 -6
  118. package/dist/themes/hkdev/components/rows/panel-row-2.css +7 -7
  119. package/dist/themes/hkdev/components.css +47 -47
  120. package/dist/themes/hkdev/debug.css +1 -1
  121. package/dist/themes/hkdev/global/layout.css +39 -39
  122. package/dist/themes/hkdev/global/on-colors.css +53 -53
  123. package/dist/themes/hkdev/globals.css +11 -11
  124. package/dist/themes/hkdev/responsive.css +12 -12
  125. package/dist/themes/hkdev/theme-ext.js +15 -15
  126. package/dist/themes/hkdev/theme.js +235 -235
  127. package/dist/themes/index.js +1 -1
  128. package/dist/util/array/index.js +455 -455
  129. package/dist/util/bases/base58.js +262 -262
  130. package/dist/util/bases/index.js +1 -1
  131. package/dist/util/compare/index.js +247 -247
  132. package/dist/util/css/css-vars.js +83 -83
  133. package/dist/util/css/index.js +1 -1
  134. package/dist/util/design-system/components/states.js +22 -22
  135. package/dist/util/design-system/css/clamp.js +66 -66
  136. package/dist/util/design-system/css/root-design-vars.js +100 -100
  137. package/dist/util/design-system/index.js +5 -5
  138. package/dist/util/design-system/layout/scaling.js +228 -228
  139. package/dist/util/design-system/skeleton.js +208 -208
  140. package/dist/util/design-system/tailwind.js +288 -288
  141. package/dist/util/expect/arrays.js +47 -47
  142. package/dist/util/expect/index.js +259 -259
  143. package/dist/util/expect/primitives.js +55 -55
  144. package/dist/util/expect/url.js +60 -60
  145. package/dist/util/function/index.js +218 -218
  146. package/dist/util/http/errors.js +97 -97
  147. package/dist/util/http/headers.js +45 -45
  148. package/dist/util/http/http-request.js +294 -294
  149. package/dist/util/http/index.js +22 -22
  150. package/dist/util/http/json-request.js +143 -143
  151. package/dist/util/http/mocks.js +65 -65
  152. package/dist/util/http/response.js +241 -241
  153. package/dist/util/http/test-data__/content-length-test-hkdigital-small.V4HfZyBQ.avif +0 -0
  154. package/dist/util/http/url.js +52 -52
  155. package/dist/util/image/index.js +86 -86
  156. package/dist/util/index.js +2 -2
  157. package/dist/util/is/index.js +140 -140
  158. package/dist/util/iterate/index.js +234 -234
  159. package/dist/util/object/index.js +1361 -1361
  160. package/dist/util/singleton/index.js +97 -97
  161. package/dist/util/string/array-path.js +75 -75
  162. package/dist/util/string/convert.js +54 -54
  163. package/dist/util/string/fs.js +226 -226
  164. package/dist/util/string/index.js +5 -5
  165. package/dist/util/string/interpolate.js +61 -61
  166. package/dist/util/string/pad.js +10 -10
  167. package/dist/util/svelte/index.js +4 -4
  168. package/dist/util/svelte/loading/loading-tracker.svelte.js +108 -108
  169. package/dist/util/svelte/observe/index.js +49 -49
  170. package/dist/util/svelte/state-context/index.js +83 -83
  171. package/dist/util/svelte/wait/index.js +38 -38
  172. package/dist/util/sveltekit/index.js +1 -1
  173. package/dist/util/sveltekit/route-folders/index.js +101 -101
  174. package/dist/util/time/index.js +323 -323
  175. package/dist/util/unique/index.js +249 -249
  176. package/dist/valibot/date.js__ +10 -10
  177. package/dist/valibot/index.js +9 -9
  178. package/dist/valibot/url.js +95 -95
  179. package/dist/valibot/user.js +23 -23
  180. package/dist/widgets/button-group/ButtonGroup.svelte +82 -94
  181. package/dist/widgets/button-group/ButtonGroup.svelte.d.ts +0 -2
  182. package/dist/widgets/button-group/typedef.js +10 -10
  183. package/dist/widgets/compare-left-right/CompareLeftRight.svelte +179 -179
  184. package/dist/widgets/compare-left-right/index.js +1 -1
  185. package/dist/widgets/game-box/GameBox.svelte +579 -186
  186. package/dist/widgets/game-box/GameBox.svelte.d.ts +64 -4
  187. package/dist/widgets/game-box/gamebox.util.js +83 -83
  188. package/dist/widgets/hk-app-layout/HkAppLayout.state.svelte.js +25 -25
  189. package/dist/widgets/hk-app-layout/HkAppLayout.svelte +251 -251
  190. package/dist/widgets/image-box/ImageBox.svelte +212 -212
  191. package/dist/widgets/image-box/index.js +5 -5
  192. package/dist/widgets/image-box/typedef.js +32 -32
  193. package/dist/widgets/index.js +23 -23
  194. package/dist/widgets/presenter/(broken) Presenter.state.svelte.js__ +613 -0
  195. package/dist/widgets/presenter/ImageSlide.svelte +64 -64
  196. package/dist/widgets/presenter/Presenter.state.svelte.js +636 -636
  197. package/dist/widgets/presenter/Presenter.svelte +140 -140
  198. package/dist/widgets/presenter/Presenter.svelte__ +125 -0
  199. package/dist/widgets/presenter/constants.js +7 -7
  200. package/dist/widgets/presenter/index.js +10 -10
  201. package/dist/widgets/presenter/typedef.js +106 -106
  202. package/dist/widgets/presenter/util.js +210 -210
  203. package/dist/widgets/virtual-viewport/VirtualViewport.svelte +196 -196
  204. package/dist/zod/all.js +33 -33
  205. package/dist/zod/generic.js +11 -11
  206. package/dist/zod/javascript.js +32 -32
  207. package/dist/zod/user.js +16 -16
  208. package/dist/zod/web.js +52 -52
  209. package/package.json +102 -102
@@ -1,323 +1,323 @@
1
- /**
2
- * time.js
3
- *
4
- * @description
5
- * This file contains time related functionality
6
- *
7
- * @example
8
- *
9
- * import { delay, now } from './time.js';
10
- *
11
- * async function test()
12
- * {
13
- * console.log( `Current timestamp [${now()}]` );
14
- *
15
- * await delay( 1000 );
16
- *
17
- * console.log( `Current timestamp [${now()}]` );
18
- * }
19
- */
20
-
21
- /**
22
- * FIXME: use Intl.DateTimeFormat instead of custom conversions
23
- *
24
- * e.g.
25
- * return new Intl.DateTimeFormat('nl-NL', {
26
- * month: "long",
27
- * timeZone: 'Europe/Amsterdam'
28
- * }).format(d);
29
- */
30
-
31
- import {
32
- SECOND_MS,
33
- MINUTE_MS,
34
- HOUR_MS,
35
- DAY_MS,
36
- TIME_2025_01_01 } from '../../constants/time.js';
37
-
38
- import * as expect from '../expect';
39
- import { HkPromise } from '../../classes/promise/index.js';
40
-
41
- /**
42
- * Returns a promise that resolves after a specified timeout
43
- * - If the returned promise is rejected, the timeout is cancelled
44
- *
45
- * @param {number} delayOrMinDelayMs
46
- * Number of milliseconds to wait before promise resolves
47
- *
48
- * @param {number} [maxDelayMs=delayOrMinDelayMs]
49
- * Maximum number of milliseconds to wait before the returned promise
50
- * resolves. If this parameter is set, the delay will be chosen randomly
51
- * between the values [delayOrMinDelayMs, maxDelayMs]
52
- *
53
- * @returns {HkPromise} promise that resolves after a specified timeout
54
- */
55
- export function delay(delayOrMinDelayMs, maxDelayMs) {
56
- expect.number(delayOrMinDelayMs);
57
-
58
- if (maxDelayMs) {
59
- //
60
- // maxDelayMs was set -> generate random delay
61
- //
62
- if (maxDelayMs > delayOrMinDelayMs) {
63
- delayOrMinDelayMs = Math.floor(
64
- delayOrMinDelayMs + Math.random() * (maxDelayMs - delayOrMinDelayMs)
65
- );
66
- }
67
- }
68
-
69
- const promise = new HkPromise();
70
-
71
- let timer = setTimeout(() => {
72
- timer = null;
73
- promise.resolve();
74
- }, delayOrMinDelayMs);
75
-
76
- // Register catch method to cancel timer when promise is rejected
77
- promise.catch(() => {
78
- if (timer) {
79
- clearTimeout(timer);
80
- timer = null;
81
- }
82
- });
83
-
84
- return promise;
85
- }
86
-
87
- /**
88
- * Get the number of milliseconds since the specified time stamp of the default
89
- * reference time stamp TIME_2025_01_01
90
- *
91
- * @param {number} [sinceMs=TIME_2025_01_01]
92
- *
93
- * @returns {number} number of milliseconds since the specified time
94
- */
95
- export function sinceMs(sinceMs = TIME_2025_01_01) {
96
- return Date.now() - sinceMs;
97
- }
98
-
99
- /**
100
- * Get a string that represents the time in a readable
101
- * string format: [DD:][HH:]MM:SS.mmm
102
- *
103
- * @param {number} timeMs [description]
104
- *
105
- * @returns {string} time in human readable format
106
- */
107
- export function timeToString(timeMs) {
108
- const days = Math.floor(timeMs / DAY_MS);
109
-
110
- let restMs = timeMs - days * DAY_MS;
111
-
112
- const hours = Math.floor(restMs / HOUR_MS);
113
-
114
- restMs = restMs - hours * HOUR_MS;
115
-
116
- const minutes = Math.floor(restMs / MINUTE_MS);
117
-
118
- restMs = restMs - minutes * MINUTE_MS;
119
-
120
- const seconds = Math.floor(restMs / SECOND_MS);
121
-
122
- restMs = restMs - seconds * SECOND_MS;
123
-
124
- let str = '';
125
-
126
- if (days) {
127
- str += `${days.toString().padStart(2, '0')}:`;
128
- str += `${hours.toString().padStart(2, '0')}:`;
129
- } else if (hours) {
130
- str += `${hours.toString().padStart(2, '0')}:`;
131
- }
132
-
133
- str += `${minutes.toString().padStart(2, '0')}:`;
134
- str += `${seconds.toString().padStart(2, '0')}.`;
135
- str += `${restMs.toString().padStart(3, '0')}`;
136
-
137
- return str;
138
- }
139
-
140
- /**
141
- * Returns a Date object
142
- * - The input can be a Date object or a numeric timestamp
143
- *
144
- * @param {Date|number} dateOrTimestamp
145
- *
146
- * @returns {Date} date object
147
- */
148
- export function toDate(dateOrTimestamp) {
149
- if (dateOrTimestamp instanceof Date) {
150
- return dateOrTimestamp;
151
- }
152
-
153
- if (typeof dateOrTimestamp === 'number') {
154
- return new Date(dateOrTimestamp);
155
- }
156
-
157
- throw new Error('Missing or invalid parameter [dateOrTimestamp]');
158
- }
159
-
160
- /**
161
- * Get the ISO 8601 week number of the specified date
162
- *
163
- * @see https://stackoverflow.com
164
- * /questions/6117814/get-week-of-year-in-javascript-like-in-php
165
- *
166
- * @param {Date|number} dateOrTimestamp
167
- *
168
- * @returns {number} week number
169
- */
170
- export function getWeekNumber(dateOrTimestamp) {
171
- const date = toDate(dateOrTimestamp);
172
-
173
- //
174
- // Create a copy of this date object
175
- //
176
- const target = new Date(date.valueOf());
177
-
178
- //
179
- // ISO week date weeks start on Monday, so correct the day number
180
- //
181
- const dayNumber = (date.getDay() + 6) % 7;
182
-
183
- //
184
- // ISO 8601 states that week 1 is the week with the first Thursday
185
- // of that year.
186
- //
187
- // Set the target date to the Thursday in the target week
188
- //
189
- target.setDate(target.getDate() - dayNumber + 3);
190
-
191
- //
192
- // Store the millisecond value of the target date
193
- //
194
- const firstThursday = target.valueOf();
195
-
196
- // Set the target to the first Thursday of the year
197
- // First, set the target to January 1st
198
- target.setMonth(0, 1);
199
-
200
- //
201
- // Not a Thursday? Correct the date to the next Thursday
202
- //
203
- if (target.getDay() !== 4) {
204
- target.setMonth(0, 1 + ((4 - target.getDay() + 7) % 7));
205
- }
206
-
207
- //
208
- // The week number is the number of weeks between the first Thursday
209
- // of the year and the Thursday in the target week
210
- // (604800000 = 7 * 24 * 3600 * 1000)
211
- //
212
- return 1 + Math.ceil((firstThursday - target.getTime()) / 604800000);
213
- }
214
-
215
- /**
216
- * Get the name of the month
217
- * - Returns the month name using Intl.DateTimeFormat
218
- * - By default uses English locale, but locale can be specified
219
- *
220
- * @param {Date|number} dateOrTimestamp - Date object or timestamp
221
- * @param {string} [locale='nl-NL'] - The locale to use for the month name
222
- *
223
- * @param {Object} [options]
224
- * @param {'numeric'|'2-digit'|'narrow'|'short'|'long'} [options.month='long']
225
- * @param {string} [options.timeZone] - Optional timezone
226
- *
227
- * @returns {string} name of the month in the specified locale
228
- */
229
- export function getMonthName(dateOrTimestamp, locale = 'nl-NL',
230
- options = { month: 'long' }) {
231
-
232
- const date = toDate(dateOrTimestamp);
233
-
234
- // Create formatter with provided locale and options
235
- // @ts-ignore - TypeScript kan hier strikter zijn dan nodig met de options
236
- const formatter = new Intl.DateTimeFormat(locale, {
237
- month: options?.month || 'long',
238
- ...(options?.timeZone ? { timeZone: options.timeZone } : {})
239
- });
240
-
241
- return formatter.format(date);
242
- }
243
-
244
- /**
245
- * Get the name of the day of the week
246
- * - Returns the day name using Intl.DateTimeFormat
247
- * - By default uses English locale, but locale can be specified
248
- *
249
- * @param {Date|number} dateOrTimestamp - Date object or timestamp
250
- * @param {string} [locale='nl-NL'] - The locale to use for the day name
251
- *
252
- * @param {Object} [options]
253
- * @param {'narrow'|'short'|'long'} [options.weekday='long']
254
- * @param {string} [options.timeZone] - Optional timezone
255
- *
256
- * @returns {string} name of the day in the specified locale
257
- */
258
- export function getDayName(dateOrTimestamp, locale = 'nl-NL',
259
- options = { weekday: 'long' }) {
260
-
261
- const date = toDate(dateOrTimestamp);
262
-
263
- // Create formatter with provided locale and options
264
- // @ts-ignore - TypeScript kan hier strikter zijn dan nodig met de options
265
- const formatter = new Intl.DateTimeFormat(locale, {
266
- weekday: options?.weekday || 'long',
267
- ...(options?.timeZone ? { timeZone: options.timeZone } : {})
268
- });
269
-
270
- return formatter.format(date);
271
- }
272
-
273
- /**
274
- * Return the timestamp of the start of the day
275
- * - Midnight
276
- *
277
- * @param {Date|number} [dateOrTimestamp]
278
- *
279
- * @returns {number} timestamp of start of the day (00:00:00:0000)
280
- */
281
- export function getTimeAtStartOfDay(dateOrTimestamp) {
282
- let d;
283
-
284
- if (dateOrTimestamp) {
285
- d = toDate(dateOrTimestamp);
286
- } else {
287
- // today, now
288
- d = new Date();
289
- }
290
-
291
- d.setHours(0);
292
- d.setMinutes(0);
293
- d.setSeconds(0);
294
- d.setMilliseconds(0);
295
-
296
- return d.getTime();
297
- }
298
-
299
- /**
300
- * Return the timestamp of the end of the day
301
- * - Midnight - 1 millisecond
302
- *
303
- * @param {Date|number} [dateOrTimestamp]
304
- *
305
- * @returns {number} timestamp of start of the day
306
- */
307
- export function getTimeAtEndOfDay(dateOrTimestamp) {
308
- let d;
309
-
310
- if (dateOrTimestamp) {
311
- d = toDate(dateOrTimestamp);
312
- } else {
313
- // today, now
314
- d = new Date();
315
- }
316
-
317
- d.setHours(23);
318
- d.setMinutes(59);
319
- d.setSeconds(59);
320
- d.setMilliseconds(999);
321
-
322
- return d.getTime();
323
- }
1
+ /**
2
+ * time.js
3
+ *
4
+ * @description
5
+ * This file contains time related functionality
6
+ *
7
+ * @example
8
+ *
9
+ * import { delay, now } from './time.js';
10
+ *
11
+ * async function test()
12
+ * {
13
+ * console.log( `Current timestamp [${now()}]` );
14
+ *
15
+ * await delay( 1000 );
16
+ *
17
+ * console.log( `Current timestamp [${now()}]` );
18
+ * }
19
+ */
20
+
21
+ /**
22
+ * FIXME: use Intl.DateTimeFormat instead of custom conversions
23
+ *
24
+ * e.g.
25
+ * return new Intl.DateTimeFormat('nl-NL', {
26
+ * month: "long",
27
+ * timeZone: 'Europe/Amsterdam'
28
+ * }).format(d);
29
+ */
30
+
31
+ import {
32
+ SECOND_MS,
33
+ MINUTE_MS,
34
+ HOUR_MS,
35
+ DAY_MS,
36
+ TIME_2025_01_01 } from '../../constants/time.js';
37
+
38
+ import * as expect from '../expect';
39
+ import { HkPromise } from '../../classes/promise/index.js';
40
+
41
+ /**
42
+ * Returns a promise that resolves after a specified timeout
43
+ * - If the returned promise is rejected, the timeout is cancelled
44
+ *
45
+ * @param {number} delayOrMinDelayMs
46
+ * Number of milliseconds to wait before promise resolves
47
+ *
48
+ * @param {number} [maxDelayMs=delayOrMinDelayMs]
49
+ * Maximum number of milliseconds to wait before the returned promise
50
+ * resolves. If this parameter is set, the delay will be chosen randomly
51
+ * between the values [delayOrMinDelayMs, maxDelayMs]
52
+ *
53
+ * @returns {HkPromise} promise that resolves after a specified timeout
54
+ */
55
+ export function delay(delayOrMinDelayMs, maxDelayMs) {
56
+ expect.number(delayOrMinDelayMs);
57
+
58
+ if (maxDelayMs) {
59
+ //
60
+ // maxDelayMs was set -> generate random delay
61
+ //
62
+ if (maxDelayMs > delayOrMinDelayMs) {
63
+ delayOrMinDelayMs = Math.floor(
64
+ delayOrMinDelayMs + Math.random() * (maxDelayMs - delayOrMinDelayMs)
65
+ );
66
+ }
67
+ }
68
+
69
+ const promise = new HkPromise();
70
+
71
+ let timer = setTimeout(() => {
72
+ timer = null;
73
+ promise.resolve();
74
+ }, delayOrMinDelayMs);
75
+
76
+ // Register catch method to cancel timer when promise is rejected
77
+ promise.catch(() => {
78
+ if (timer) {
79
+ clearTimeout(timer);
80
+ timer = null;
81
+ }
82
+ });
83
+
84
+ return promise;
85
+ }
86
+
87
+ /**
88
+ * Get the number of milliseconds since the specified time stamp of the default
89
+ * reference time stamp TIME_2025_01_01
90
+ *
91
+ * @param {number} [sinceMs=TIME_2025_01_01]
92
+ *
93
+ * @returns {number} number of milliseconds since the specified time
94
+ */
95
+ export function sinceMs(sinceMs = TIME_2025_01_01) {
96
+ return Date.now() - sinceMs;
97
+ }
98
+
99
+ /**
100
+ * Get a string that represents the time in a readable
101
+ * string format: [DD:][HH:]MM:SS.mmm
102
+ *
103
+ * @param {number} timeMs [description]
104
+ *
105
+ * @returns {string} time in human readable format
106
+ */
107
+ export function timeToString(timeMs) {
108
+ const days = Math.floor(timeMs / DAY_MS);
109
+
110
+ let restMs = timeMs - days * DAY_MS;
111
+
112
+ const hours = Math.floor(restMs / HOUR_MS);
113
+
114
+ restMs = restMs - hours * HOUR_MS;
115
+
116
+ const minutes = Math.floor(restMs / MINUTE_MS);
117
+
118
+ restMs = restMs - minutes * MINUTE_MS;
119
+
120
+ const seconds = Math.floor(restMs / SECOND_MS);
121
+
122
+ restMs = restMs - seconds * SECOND_MS;
123
+
124
+ let str = '';
125
+
126
+ if (days) {
127
+ str += `${days.toString().padStart(2, '0')}:`;
128
+ str += `${hours.toString().padStart(2, '0')}:`;
129
+ } else if (hours) {
130
+ str += `${hours.toString().padStart(2, '0')}:`;
131
+ }
132
+
133
+ str += `${minutes.toString().padStart(2, '0')}:`;
134
+ str += `${seconds.toString().padStart(2, '0')}.`;
135
+ str += `${restMs.toString().padStart(3, '0')}`;
136
+
137
+ return str;
138
+ }
139
+
140
+ /**
141
+ * Returns a Date object
142
+ * - The input can be a Date object or a numeric timestamp
143
+ *
144
+ * @param {Date|number} dateOrTimestamp
145
+ *
146
+ * @returns {Date} date object
147
+ */
148
+ export function toDate(dateOrTimestamp) {
149
+ if (dateOrTimestamp instanceof Date) {
150
+ return dateOrTimestamp;
151
+ }
152
+
153
+ if (typeof dateOrTimestamp === 'number') {
154
+ return new Date(dateOrTimestamp);
155
+ }
156
+
157
+ throw new Error('Missing or invalid parameter [dateOrTimestamp]');
158
+ }
159
+
160
+ /**
161
+ * Get the ISO 8601 week number of the specified date
162
+ *
163
+ * @see https://stackoverflow.com
164
+ * /questions/6117814/get-week-of-year-in-javascript-like-in-php
165
+ *
166
+ * @param {Date|number} dateOrTimestamp
167
+ *
168
+ * @returns {number} week number
169
+ */
170
+ export function getWeekNumber(dateOrTimestamp) {
171
+ const date = toDate(dateOrTimestamp);
172
+
173
+ //
174
+ // Create a copy of this date object
175
+ //
176
+ const target = new Date(date.valueOf());
177
+
178
+ //
179
+ // ISO week date weeks start on Monday, so correct the day number
180
+ //
181
+ const dayNumber = (date.getDay() + 6) % 7;
182
+
183
+ //
184
+ // ISO 8601 states that week 1 is the week with the first Thursday
185
+ // of that year.
186
+ //
187
+ // Set the target date to the Thursday in the target week
188
+ //
189
+ target.setDate(target.getDate() - dayNumber + 3);
190
+
191
+ //
192
+ // Store the millisecond value of the target date
193
+ //
194
+ const firstThursday = target.valueOf();
195
+
196
+ // Set the target to the first Thursday of the year
197
+ // First, set the target to January 1st
198
+ target.setMonth(0, 1);
199
+
200
+ //
201
+ // Not a Thursday? Correct the date to the next Thursday
202
+ //
203
+ if (target.getDay() !== 4) {
204
+ target.setMonth(0, 1 + ((4 - target.getDay() + 7) % 7));
205
+ }
206
+
207
+ //
208
+ // The week number is the number of weeks between the first Thursday
209
+ // of the year and the Thursday in the target week
210
+ // (604800000 = 7 * 24 * 3600 * 1000)
211
+ //
212
+ return 1 + Math.ceil((firstThursday - target.getTime()) / 604800000);
213
+ }
214
+
215
+ /**
216
+ * Get the name of the month
217
+ * - Returns the month name using Intl.DateTimeFormat
218
+ * - By default uses English locale, but locale can be specified
219
+ *
220
+ * @param {Date|number} dateOrTimestamp - Date object or timestamp
221
+ * @param {string} [locale='nl-NL'] - The locale to use for the month name
222
+ *
223
+ * @param {Object} [options]
224
+ * @param {'numeric'|'2-digit'|'narrow'|'short'|'long'} [options.month='long']
225
+ * @param {string} [options.timeZone] - Optional timezone
226
+ *
227
+ * @returns {string} name of the month in the specified locale
228
+ */
229
+ export function getMonthName(dateOrTimestamp, locale = 'nl-NL',
230
+ options = { month: 'long' }) {
231
+
232
+ const date = toDate(dateOrTimestamp);
233
+
234
+ // Create formatter with provided locale and options
235
+ // @ts-ignore - TypeScript kan hier strikter zijn dan nodig met de options
236
+ const formatter = new Intl.DateTimeFormat(locale, {
237
+ month: options?.month || 'long',
238
+ ...(options?.timeZone ? { timeZone: options.timeZone } : {})
239
+ });
240
+
241
+ return formatter.format(date);
242
+ }
243
+
244
+ /**
245
+ * Get the name of the day of the week
246
+ * - Returns the day name using Intl.DateTimeFormat
247
+ * - By default uses English locale, but locale can be specified
248
+ *
249
+ * @param {Date|number} dateOrTimestamp - Date object or timestamp
250
+ * @param {string} [locale='nl-NL'] - The locale to use for the day name
251
+ *
252
+ * @param {Object} [options]
253
+ * @param {'narrow'|'short'|'long'} [options.weekday='long']
254
+ * @param {string} [options.timeZone] - Optional timezone
255
+ *
256
+ * @returns {string} name of the day in the specified locale
257
+ */
258
+ export function getDayName(dateOrTimestamp, locale = 'nl-NL',
259
+ options = { weekday: 'long' }) {
260
+
261
+ const date = toDate(dateOrTimestamp);
262
+
263
+ // Create formatter with provided locale and options
264
+ // @ts-ignore - TypeScript kan hier strikter zijn dan nodig met de options
265
+ const formatter = new Intl.DateTimeFormat(locale, {
266
+ weekday: options?.weekday || 'long',
267
+ ...(options?.timeZone ? { timeZone: options.timeZone } : {})
268
+ });
269
+
270
+ return formatter.format(date);
271
+ }
272
+
273
+ /**
274
+ * Return the timestamp of the start of the day
275
+ * - Midnight
276
+ *
277
+ * @param {Date|number} [dateOrTimestamp]
278
+ *
279
+ * @returns {number} timestamp of start of the day (00:00:00:0000)
280
+ */
281
+ export function getTimeAtStartOfDay(dateOrTimestamp) {
282
+ let d;
283
+
284
+ if (dateOrTimestamp) {
285
+ d = toDate(dateOrTimestamp);
286
+ } else {
287
+ // today, now
288
+ d = new Date();
289
+ }
290
+
291
+ d.setHours(0);
292
+ d.setMinutes(0);
293
+ d.setSeconds(0);
294
+ d.setMilliseconds(0);
295
+
296
+ return d.getTime();
297
+ }
298
+
299
+ /**
300
+ * Return the timestamp of the end of the day
301
+ * - Midnight - 1 millisecond
302
+ *
303
+ * @param {Date|number} [dateOrTimestamp]
304
+ *
305
+ * @returns {number} timestamp of start of the day
306
+ */
307
+ export function getTimeAtEndOfDay(dateOrTimestamp) {
308
+ let d;
309
+
310
+ if (dateOrTimestamp) {
311
+ d = toDate(dateOrTimestamp);
312
+ } else {
313
+ // today, now
314
+ d = new Date();
315
+ }
316
+
317
+ d.setHours(23);
318
+ d.setMinutes(59);
319
+ d.setSeconds(59);
320
+ d.setMilliseconds(999);
321
+
322
+ return d.getTime();
323
+ }