@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,60 +1,60 @@
1
- // > Imports
2
-
3
- import * as v from 'valibot';
4
-
5
- import {
6
- ValidateUrl,
7
- ValidateUrlOrEmptyString,
8
- ValidateUrlPath,
9
- ValidateRelativeUrl,
10
- ValidateAbsOrRelUrl
11
- } from '../../schemas/validate-url.js';
12
-
13
- // > Exports
14
-
15
- /**
16
- * Throws a validation error if value is not an url
17
- *
18
- * @param {any} value
19
- */
20
- export function url(value) {
21
- v.parse(ValidateUrl, value);
22
- }
23
-
24
- /**
25
- * Throws a validation error if value is not an url or
26
- * an empty string
27
- *
28
- * @param {any} value
29
- */
30
- export function urlOrEmptyString(value) {
31
- v.parse(ValidateUrlOrEmptyString, value);
32
- }
33
-
34
- /**
35
- * Throws a validation error if value is not a relative url
36
- *
37
- * @param {any} value
38
- */
39
- export function urlPath(value) {
40
- v.parse(ValidateUrlPath, value);
41
- }
42
-
43
- /**
44
- * Throws a validation error if value is not a relative url
45
- *
46
- * @param {any} value
47
- */
48
- export function relativeUrl(value) {
49
- v.parse(ValidateRelativeUrl, value);
50
- }
51
-
52
- /**
53
- * Throws a validation error if value is not an absolute
54
- * or relative url
55
- *
56
- * @param {any} value
57
- */
58
- export function absOrRelUrl(value) {
59
- v.parse(ValidateAbsOrRelUrl, value);
60
- }
1
+ // > Imports
2
+
3
+ import * as v from 'valibot';
4
+
5
+ import {
6
+ ValidateUrl,
7
+ ValidateUrlOrEmptyString,
8
+ ValidateUrlPath,
9
+ ValidateRelativeUrl,
10
+ ValidateAbsOrRelUrl
11
+ } from '../../schemas/validate-url.js';
12
+
13
+ // > Exports
14
+
15
+ /**
16
+ * Throws a validation error if value is not an url
17
+ *
18
+ * @param {any} value
19
+ */
20
+ export function url(value) {
21
+ v.parse(ValidateUrl, value);
22
+ }
23
+
24
+ /**
25
+ * Throws a validation error if value is not an url or
26
+ * an empty string
27
+ *
28
+ * @param {any} value
29
+ */
30
+ export function urlOrEmptyString(value) {
31
+ v.parse(ValidateUrlOrEmptyString, value);
32
+ }
33
+
34
+ /**
35
+ * Throws a validation error if value is not a relative url
36
+ *
37
+ * @param {any} value
38
+ */
39
+ export function urlPath(value) {
40
+ v.parse(ValidateUrlPath, value);
41
+ }
42
+
43
+ /**
44
+ * Throws a validation error if value is not a relative url
45
+ *
46
+ * @param {any} value
47
+ */
48
+ export function relativeUrl(value) {
49
+ v.parse(ValidateRelativeUrl, value);
50
+ }
51
+
52
+ /**
53
+ * Throws a validation error if value is not an absolute
54
+ * or relative url
55
+ *
56
+ * @param {any} value
57
+ */
58
+ export function absOrRelUrl(value) {
59
+ v.parse(ValidateAbsOrRelUrl, value);
60
+ }
@@ -1,218 +1,218 @@
1
- /**
2
- * function.js
3
- *
4
- * @description
5
- * This file contains code for working with functions
6
- *
7
- * @example
8
- *
9
- * import { once } from "./function.js";
10
- *
11
- * const sayHelloOnce = once( () => { console.log("Hello"); } );
12
- *
13
- * sayHelloOnce();
14
- * sayHelloOnce();
15
- *
16
- * @example
17
- *
18
- * import { defer } from './process.js';
19
- *
20
- * defer( () => {
21
- * console.log("The execution of the function has been defered");
22
- * } );
23
- */
24
-
25
- /* ------------------------------------------------------------------ Imports */
26
-
27
- import * as expect from '../expect/index.js';
28
-
29
- /* ---------------------------------------------------------------- Internals */
30
-
31
- const NEXT_TICK_MESSAGE = 'hk-next-tick';
32
-
33
- /**
34
- * Detect and return the most suitable setImmediate implementation available
35
- * on the current platform
36
- */
37
- function set_immediate_implementation() {
38
- if (typeof global !== 'undefined') {
39
- if (undefined !== global.setImmediate) {
40
- return global.setImmediate;
41
- }
42
- } else if (typeof window !== 'undefined') {
43
- if (window.postMessage && window.addEventListener) {
44
- const queue = [];
45
-
46
- window.addEventListener(
47
- 'message',
48
- (event) => {
49
- const source = event.source;
50
-
51
- if ((source === window || source === null) && event.data === NEXT_TICK_MESSAGE) {
52
- event.stopPropagation();
53
- if (queue.length > 0) {
54
- const fn = queue.shift();
55
- fn();
56
- }
57
- }
58
- },
59
- true
60
- );
61
-
62
- return function nextTickUsingPostMessage(fn) {
63
- expect.function(fn);
64
-
65
- queue.push(fn);
66
- window.postMessage(NEXT_TICK_MESSAGE, '*');
67
- };
68
- }
69
- }
70
-
71
- throw new Error('No suitable [setImmediate] implementation available');
72
- }
73
-
74
- /* ------------------------------------------------------------------ Exports */
75
-
76
- /**
77
- * 'No operation' function
78
- * - A function that does nothing
79
- */
80
- export const noop = () => {};
81
-
82
- // -----------------------------------------------------------------------------
83
-
84
- /**
85
- * Wraps a function so that the callback function will be called only once
86
- *
87
- * @param {function} callback
88
- *
89
- * @returns {function} callback wrapped in `once` function
90
- */
91
- export function once(callback) {
92
- expect.function(callback);
93
-
94
- let ignore = false;
95
-
96
- return function () {
97
- if (!ignore) {
98
- ignore = true;
99
- callback(...arguments);
100
- }
101
- };
102
- }
103
-
104
- // -----------------------------------------------------------------------------
105
-
106
- /**
107
- * Returns a debounced function
108
- * - The original function is not called more than once during the
109
- * specified interval
110
- *
111
- * @param {function} fn
112
- * @param {number} [intervalMs=200]
113
- *
114
- * @returns {function} debounced function
115
- */
116
- export function debounce(fn, intervalMs = 200) {
117
- let idleTimer;
118
- let lastArguments;
119
-
120
- // console.log("debounce");
121
-
122
- return function debounced() {
123
- // console.log("debounced");
124
-
125
- if (idleTimer) {
126
- // console.log("idleTimer running");
127
-
128
- // The function has been called recently
129
- lastArguments = arguments;
130
- return;
131
- }
132
-
133
- idleTimer = setTimeout(() => {
134
- // console.log("idleTimer finished", lastArguments);
135
-
136
- idleTimer = null;
137
-
138
- if (lastArguments) {
139
- //
140
- // At least one call has been "debounced"
141
- // -> make call with last arguments, so function always receives
142
- // the arguments of the last call to the function
143
- //
144
- fn(...lastArguments);
145
- lastArguments = undefined;
146
- }
147
- }, intervalMs);
148
-
149
- fn(...arguments);
150
- };
151
- }
152
-
153
- // -----------------------------------------------------------------------------
154
-
155
- /**
156
- * Defer the execution of a function
157
- * - Uses the best 'setImmediate' implementation supported by the current
158
- * runtime environment
159
- *
160
- * @param {function} fn - Function to execute
161
- *
162
- * --
163
- *
164
- * @note setImmediate is preferred over nextTick
165
- *
166
- * @see https://nodejs.org/en/docs/guides/event-loop-timers-and-nexttick/
167
- */
168
- export const defer = set_immediate_implementation();
169
-
170
- // -----------------------------------------------------------------------------
171
-
172
- /**
173
- * Adds a wrapper around a function that only calls the supplied function
174
- * if the (first) supplied argument to the returned function is not `null`
175
- *
176
- * @param {object} [object]
177
- * Optional function context to be used as `this`
178
- *
179
- * @param {function} functionOrMethodName
180
- *
181
- * @returns {function} not null wrapper function
182
- */
183
- // export function ifNotNull( /* object, functionOrMethodName */ )
184
- // {
185
- // let fn;
186
-
187
- // switch( arguments.length )
188
- // {
189
- // case 1:
190
- // fn = arguments[0];
191
- // expectFunction( fn, "Missing or invalid parameter [fn]" );
192
- // break;
193
-
194
- // case 2:
195
- // {
196
- // const object = arguments[0];
197
- // const methodName = arguments[1];
198
-
199
- // expectObject( object, "Invalid parameter [object]" );
200
- // expectNotEmptyString( methodName, "Invalid parameter [methodName]" );
201
-
202
- // fn = object[ methodName ].bind( object );
203
-
204
- // expectFunction( fn, `Invalid method [<object>.${methodName}]` );
205
- // }
206
- // break;
207
-
208
- // default:
209
- // throw new Error("Invalid number of arguments");
210
- // }
211
-
212
- // return async ( value ) => {
213
- // if( null !== value )
214
- // {
215
- // await fn( value );
216
- // }
217
- // };
218
- // }
1
+ /**
2
+ * function.js
3
+ *
4
+ * @description
5
+ * This file contains code for working with functions
6
+ *
7
+ * @example
8
+ *
9
+ * import { once } from "./function.js";
10
+ *
11
+ * const sayHelloOnce = once( () => { console.log("Hello"); } );
12
+ *
13
+ * sayHelloOnce();
14
+ * sayHelloOnce();
15
+ *
16
+ * @example
17
+ *
18
+ * import { defer } from './process.js';
19
+ *
20
+ * defer( () => {
21
+ * console.log("The execution of the function has been defered");
22
+ * } );
23
+ */
24
+
25
+ /* ------------------------------------------------------------------ Imports */
26
+
27
+ import * as expect from '../expect/index.js';
28
+
29
+ /* ---------------------------------------------------------------- Internals */
30
+
31
+ const NEXT_TICK_MESSAGE = 'hk-next-tick';
32
+
33
+ /**
34
+ * Detect and return the most suitable setImmediate implementation available
35
+ * on the current platform
36
+ */
37
+ function set_immediate_implementation() {
38
+ if (typeof global !== 'undefined') {
39
+ if (undefined !== global.setImmediate) {
40
+ return global.setImmediate;
41
+ }
42
+ } else if (typeof window !== 'undefined') {
43
+ if (window.postMessage && window.addEventListener) {
44
+ const queue = [];
45
+
46
+ window.addEventListener(
47
+ 'message',
48
+ (event) => {
49
+ const source = event.source;
50
+
51
+ if ((source === window || source === null) && event.data === NEXT_TICK_MESSAGE) {
52
+ event.stopPropagation();
53
+ if (queue.length > 0) {
54
+ const fn = queue.shift();
55
+ fn();
56
+ }
57
+ }
58
+ },
59
+ true
60
+ );
61
+
62
+ return function nextTickUsingPostMessage(fn) {
63
+ expect.function(fn);
64
+
65
+ queue.push(fn);
66
+ window.postMessage(NEXT_TICK_MESSAGE, '*');
67
+ };
68
+ }
69
+ }
70
+
71
+ throw new Error('No suitable [setImmediate] implementation available');
72
+ }
73
+
74
+ /* ------------------------------------------------------------------ Exports */
75
+
76
+ /**
77
+ * 'No operation' function
78
+ * - A function that does nothing
79
+ */
80
+ export const noop = () => {};
81
+
82
+ // -----------------------------------------------------------------------------
83
+
84
+ /**
85
+ * Wraps a function so that the callback function will be called only once
86
+ *
87
+ * @param {function} callback
88
+ *
89
+ * @returns {function} callback wrapped in `once` function
90
+ */
91
+ export function once(callback) {
92
+ expect.function(callback);
93
+
94
+ let ignore = false;
95
+
96
+ return function () {
97
+ if (!ignore) {
98
+ ignore = true;
99
+ callback(...arguments);
100
+ }
101
+ };
102
+ }
103
+
104
+ // -----------------------------------------------------------------------------
105
+
106
+ /**
107
+ * Returns a debounced function
108
+ * - The original function is not called more than once during the
109
+ * specified interval
110
+ *
111
+ * @param {function} fn
112
+ * @param {number} [intervalMs=200]
113
+ *
114
+ * @returns {function} debounced function
115
+ */
116
+ export function debounce(fn, intervalMs = 200) {
117
+ let idleTimer;
118
+ let lastArguments;
119
+
120
+ // console.log("debounce");
121
+
122
+ return function debounced() {
123
+ // console.log("debounced");
124
+
125
+ if (idleTimer) {
126
+ // console.log("idleTimer running");
127
+
128
+ // The function has been called recently
129
+ lastArguments = arguments;
130
+ return;
131
+ }
132
+
133
+ idleTimer = setTimeout(() => {
134
+ // console.log("idleTimer finished", lastArguments);
135
+
136
+ idleTimer = null;
137
+
138
+ if (lastArguments) {
139
+ //
140
+ // At least one call has been "debounced"
141
+ // -> make call with last arguments, so function always receives
142
+ // the arguments of the last call to the function
143
+ //
144
+ fn(...lastArguments);
145
+ lastArguments = undefined;
146
+ }
147
+ }, intervalMs);
148
+
149
+ fn(...arguments);
150
+ };
151
+ }
152
+
153
+ // -----------------------------------------------------------------------------
154
+
155
+ /**
156
+ * Defer the execution of a function
157
+ * - Uses the best 'setImmediate' implementation supported by the current
158
+ * runtime environment
159
+ *
160
+ * @param {function} fn - Function to execute
161
+ *
162
+ * --
163
+ *
164
+ * @note setImmediate is preferred over nextTick
165
+ *
166
+ * @see https://nodejs.org/en/docs/guides/event-loop-timers-and-nexttick/
167
+ */
168
+ export const defer = set_immediate_implementation();
169
+
170
+ // -----------------------------------------------------------------------------
171
+
172
+ /**
173
+ * Adds a wrapper around a function that only calls the supplied function
174
+ * if the (first) supplied argument to the returned function is not `null`
175
+ *
176
+ * @param {object} [object]
177
+ * Optional function context to be used as `this`
178
+ *
179
+ * @param {function} functionOrMethodName
180
+ *
181
+ * @returns {function} not null wrapper function
182
+ */
183
+ // export function ifNotNull( /* object, functionOrMethodName */ )
184
+ // {
185
+ // let fn;
186
+
187
+ // switch( arguments.length )
188
+ // {
189
+ // case 1:
190
+ // fn = arguments[0];
191
+ // expectFunction( fn, "Missing or invalid parameter [fn]" );
192
+ // break;
193
+
194
+ // case 2:
195
+ // {
196
+ // const object = arguments[0];
197
+ // const methodName = arguments[1];
198
+
199
+ // expectObject( object, "Invalid parameter [object]" );
200
+ // expectNotEmptyString( methodName, "Invalid parameter [methodName]" );
201
+
202
+ // fn = object[ methodName ].bind( object );
203
+
204
+ // expectFunction( fn, `Invalid method [<object>.${methodName}]` );
205
+ // }
206
+ // break;
207
+
208
+ // default:
209
+ // throw new Error("Invalid number of arguments");
210
+ // }
211
+
212
+ // return async ( value ) => {
213
+ // if( null !== value )
214
+ // {
215
+ // await fn( value );
216
+ // }
217
+ // };
218
+ // }