@hkdigital/lib-sveltekit 0.2.8 → 0.2.9

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 (243) 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/cache/IndexedDbCache.js +1407 -1407
  5. package/dist/classes/cache/MemoryResponseCache.js +138 -138
  6. package/dist/classes/cache/index.js +5 -5
  7. package/dist/classes/cache/typedef.js +41 -41
  8. package/dist/classes/data/IterableTree.js +243 -243
  9. package/dist/classes/data/Selector.js +190 -190
  10. package/dist/classes/data/index.js +2 -2
  11. package/dist/classes/events/EventEmitter.js +275 -275
  12. package/dist/classes/events/index.js +2 -2
  13. package/dist/classes/index.js +4 -4
  14. package/dist/classes/logging/Logger.js +158 -158
  15. package/dist/classes/logging/constants.js +18 -18
  16. package/dist/classes/logging/index.js +4 -4
  17. package/dist/classes/promise/HkPromise.js +377 -377
  18. package/dist/classes/promise/index.js +1 -1
  19. package/dist/classes/services/ServiceBase.js +409 -409
  20. package/dist/classes/services/ServiceManager.js +1114 -1114
  21. package/dist/classes/services/constants.js +12 -12
  22. package/dist/classes/services/index.js +5 -5
  23. package/dist/classes/stores/SubscribersCount.js +107 -107
  24. package/dist/classes/stores/index.js +1 -1
  25. package/dist/classes/streams/LogTransformStream.js +19 -19
  26. package/dist/classes/streams/ServerEventsStore.js +110 -110
  27. package/dist/classes/streams/TimeStampSource.js +26 -26
  28. package/dist/classes/streams/index.js +3 -3
  29. package/dist/classes/svelte/audio/AudioLoader.svelte.js +58 -58
  30. package/dist/classes/svelte/audio/AudioScene.svelte.js +324 -324
  31. package/dist/classes/svelte/audio/mocks.js +35 -35
  32. package/dist/classes/svelte/finite-state-machine/FiniteStateMachine.svelte.js +133 -133
  33. package/dist/classes/svelte/finite-state-machine/index.js +1 -1
  34. package/dist/classes/svelte/image/ImageLoader.svelte.js +45 -45
  35. package/dist/classes/svelte/image/ImageScene.svelte.js +249 -249
  36. package/dist/classes/svelte/image/ImageVariantsLoader.svelte.js +152 -152
  37. package/dist/classes/svelte/image/index.js +4 -4
  38. package/dist/classes/svelte/image/mocks.js +35 -35
  39. package/dist/classes/svelte/image/typedef.js +8 -8
  40. package/dist/classes/svelte/index.js +14 -14
  41. package/dist/classes/svelte/loading-state-machine/LoadingStateMachine.svelte.js +109 -109
  42. package/dist/classes/svelte/loading-state-machine/constants.js +16 -16
  43. package/dist/classes/svelte/loading-state-machine/index.js +3 -3
  44. package/dist/classes/svelte/network-loader/NetworkLoader.svelte.js +338 -338
  45. package/dist/classes/svelte/network-loader/constants.js +3 -3
  46. package/dist/classes/svelte/network-loader/index.js +3 -3
  47. package/dist/classes/svelte/network-loader/mocks.js +30 -30
  48. package/dist/classes/svelte/network-loader/typedef.js +8 -8
  49. package/dist/components/area/HkArea.svelte +49 -49
  50. package/dist/components/area/HkGridArea.svelte +77 -77
  51. package/dist/components/area/index.js +2 -2
  52. package/dist/components/buttons/button/Button.svelte +82 -82
  53. package/dist/components/buttons/button-icon-steeze/SteezeIconButton.svelte +30 -30
  54. package/dist/components/buttons/button-text/TextButton.svelte +21 -21
  55. package/dist/components/buttons/index.js +3 -3
  56. package/dist/components/debug/debug-panel-design-scaling/DebugPanelDesignScaling.svelte +146 -146
  57. package/dist/components/debug/index.js +1 -1
  58. package/dist/components/drag-drop/DragController.js +44 -44
  59. package/dist/components/drag-drop/DragDropContext.svelte +112 -110
  60. package/dist/components/drag-drop/Draggable.svelte +498 -512
  61. package/dist/components/drag-drop/{Dropzone.svelte → DropZone.svelte} +258 -258
  62. package/dist/components/drag-drop/DropZoneArea.svelte +119 -119
  63. package/dist/components/drag-drop/DropZoneList.svelte +125 -125
  64. package/dist/components/drag-drop/actions.d.ts +6 -0
  65. package/dist/components/drag-drop/actions.js +18 -0
  66. package/dist/components/drag-drop/drag-state.svelte.js +319 -319
  67. package/dist/components/drag-drop/index.js +7 -7
  68. package/dist/components/drag-drop/util.js +85 -85
  69. package/dist/components/hkdev/blocks/TextBlock.svelte +46 -46
  70. package/dist/components/hkdev/buttons/CheckButton.svelte +62 -62
  71. package/dist/components/icons/HkIcon.svelte +86 -86
  72. package/dist/components/icons/HkTabIcon.svelte +116 -116
  73. package/dist/components/icons/SteezeIcon.svelte +97 -97
  74. package/dist/components/icons/index.js +6 -6
  75. package/dist/components/icons/typedef.js +16 -16
  76. package/dist/components/index.js +2 -2
  77. package/dist/components/inputs/index.js +1 -1
  78. package/dist/components/inputs/text-input/TestTextInput.svelte__ +102 -102
  79. package/dist/components/inputs/text-input/TextInput.svelte +223 -223
  80. package/dist/components/inputs/text-input/TextInput.svelte___ +83 -83
  81. package/dist/components/inputs/text-input/assets/IconInvalid.svelte +14 -14
  82. package/dist/components/inputs/text-input/assets/IconValid.svelte +12 -12
  83. package/dist/components/layout/grid-layers/GridLayers.svelte +63 -63
  84. package/dist/components/layout/grid-layers/GridLayers.svelte__heightFrom__ +372 -0
  85. package/dist/components/layout/grid-layers/util.js +74 -74
  86. package/dist/components/layout/index.js +1 -1
  87. package/dist/components/panels/index.js +1 -1
  88. package/dist/components/panels/panel/Panel.svelte +43 -43
  89. package/dist/components/rows/index.js +3 -3
  90. package/dist/components/rows/panel-grid-row/PanelGridRow.svelte +104 -104
  91. package/dist/components/rows/panel-row-2/PanelRow2.svelte +40 -40
  92. package/dist/components/tab-bar/HkTabBar.state.svelte.js +149 -149
  93. package/dist/components/tab-bar/HkTabBar.svelte +74 -74
  94. package/dist/components/tab-bar/HkTabBarSelector.state.svelte.js +93 -93
  95. package/dist/components/tab-bar/HkTabBarSelector.svelte +49 -49
  96. package/dist/components/tab-bar/index.js +17 -17
  97. package/dist/components/tab-bar/typedef.js +11 -11
  98. package/dist/config/imagetools-config.js +189 -189
  99. package/dist/config/imagetools.d.ts +72 -72
  100. package/dist/constants/bases.js +13 -13
  101. package/dist/constants/errors/api.js +9 -9
  102. package/dist/constants/errors/generic.js +5 -5
  103. package/dist/constants/errors/index.js +3 -3
  104. package/dist/constants/errors/jwt.js +5 -5
  105. package/dist/constants/http/headers.js +6 -6
  106. package/dist/constants/http/index.js +2 -2
  107. package/dist/constants/http/methods.js +2 -2
  108. package/dist/constants/index.js +3 -3
  109. package/dist/constants/mime/application.js +5 -5
  110. package/dist/constants/mime/audio.js +13 -13
  111. package/dist/constants/mime/image.js +3 -3
  112. package/dist/constants/mime/index.js +4 -4
  113. package/dist/constants/mime/text.js +2 -2
  114. package/dist/constants/regexp/index.js +31 -31
  115. package/dist/constants/regexp/inspiratie.js__ +95 -95
  116. package/dist/constants/regexp/text.js +49 -49
  117. package/dist/constants/regexp/user.js +32 -32
  118. package/dist/constants/regexp/web.js +3 -3
  119. package/dist/constants/state-labels/drag-states.js +6 -6
  120. package/dist/constants/state-labels/drop-states.js +6 -6
  121. package/dist/constants/state-labels/input-states.js +11 -11
  122. package/dist/constants/state-labels/submit-states.js +4 -4
  123. package/dist/constants/time.js +28 -28
  124. package/dist/css/utilities.css +43 -43
  125. package/dist/design/design-config.js +73 -73
  126. package/dist/design/tailwind-theme-extend.js +158 -158
  127. package/dist/features/button-group/ButtonGroup.svelte +82 -82
  128. package/dist/features/button-group/typedef.js +10 -10
  129. package/dist/features/compare-left-right/CompareLeftRight.svelte +179 -179
  130. package/dist/features/compare-left-right/index.js +1 -1
  131. package/dist/features/game-box/GameBox.svelte +577 -577
  132. package/dist/features/game-box/gamebox.util.js +83 -83
  133. package/dist/features/hk-app-layout/HkAppLayout.state.svelte.js +25 -25
  134. package/dist/features/hk-app-layout/HkAppLayout.svelte +251 -251
  135. package/dist/features/image-box/ImageBox.svelte +210 -210
  136. package/dist/features/image-box/index.js +5 -5
  137. package/dist/features/image-box/typedef.js +32 -32
  138. package/dist/features/index.js +23 -23
  139. package/dist/features/presenter/ImageSlide.svelte +64 -64
  140. package/dist/features/presenter/Presenter.state.svelte.js +638 -638
  141. package/dist/features/presenter/Presenter.svelte +142 -142
  142. package/dist/features/presenter/constants.js +7 -7
  143. package/dist/features/presenter/index.js +10 -10
  144. package/dist/features/presenter/typedef.js +106 -106
  145. package/dist/features/presenter/util.js +210 -210
  146. package/dist/features/virtual-viewport/VirtualViewport.svelte +196 -196
  147. package/dist/schemas/index.js +1 -1
  148. package/dist/schemas/validate-url.js +180 -180
  149. package/dist/server/index.js +1 -1
  150. package/dist/server/logger.js +94 -94
  151. package/dist/states/index.js +1 -1
  152. package/dist/states/navigation.svelte.js +55 -55
  153. package/dist/stores/index.js +1 -1
  154. package/dist/stores/theme.js +80 -80
  155. package/dist/themes/hkdev/components/blocks/text-block.css +41 -41
  156. package/dist/themes/hkdev/components/boxes/game-box.css +12 -12
  157. package/dist/themes/hkdev/components/buttons/button-icon-steeze.css +22 -22
  158. package/dist/themes/hkdev/components/buttons/button-text.css +32 -32
  159. package/dist/themes/hkdev/components/buttons/button.css +146 -146
  160. package/dist/themes/hkdev/components/buttons/skip-button.css +6 -6
  161. package/dist/themes/hkdev/components/drag-drop/draggable.css +73 -73
  162. package/dist/themes/hkdev/components/drag-drop/drop-zone.css +48 -48
  163. package/dist/themes/hkdev/components/icons/icon-steeze.css +22 -22
  164. package/dist/themes/hkdev/components/inputs/text-input.css +104 -104
  165. package/dist/themes/hkdev/components/panels/panel.css +27 -27
  166. package/dist/themes/hkdev/components/rows/panel-grid-row.css +6 -6
  167. package/dist/themes/hkdev/components/rows/panel-row-2.css +7 -7
  168. package/dist/themes/hkdev/components.css +53 -53
  169. package/dist/themes/hkdev/debug.css +1 -1
  170. package/dist/themes/hkdev/global/layout.css +39 -39
  171. package/dist/themes/hkdev/global/on-colors.css +53 -53
  172. package/dist/themes/hkdev/globals.css +11 -11
  173. package/dist/themes/hkdev/responsive.css +12 -12
  174. package/dist/themes/hkdev/theme-ext.js +15 -15
  175. package/dist/themes/hkdev/theme.js +235 -235
  176. package/dist/themes/index.js +1 -1
  177. package/dist/typedef/context.js +6 -6
  178. package/dist/typedef/drag.js +25 -25
  179. package/dist/typedef/drop.js +12 -12
  180. package/dist/typedef/image.js +38 -38
  181. package/dist/typedef/index.js +4 -4
  182. package/dist/util/array/index.js +436 -436
  183. package/dist/util/bases/base58.js +262 -262
  184. package/dist/util/bases/index.js +1 -1
  185. package/dist/util/compare/index.js +247 -247
  186. package/dist/util/css/css-vars.js +83 -83
  187. package/dist/util/css/index.js +1 -1
  188. package/dist/util/design-system/components/states.js +22 -22
  189. package/dist/util/design-system/css/clamp.js +66 -66
  190. package/dist/util/design-system/css/root-design-vars.js +102 -102
  191. package/dist/util/design-system/index.js +5 -5
  192. package/dist/util/design-system/layout/scaling.js +228 -228
  193. package/dist/util/design-system/skeleton.js +208 -208
  194. package/dist/util/design-system/tailwind.js +288 -288
  195. package/dist/util/env/index.js +9 -9
  196. package/dist/util/expect/arrays.js +47 -47
  197. package/dist/util/expect/index.js +259 -259
  198. package/dist/util/expect/primitives.js +55 -55
  199. package/dist/util/expect/url.js +60 -60
  200. package/dist/util/function/index.js +218 -218
  201. package/dist/util/geo/index.js +26 -26
  202. package/dist/util/http/caching.js +263 -263
  203. package/dist/util/http/errors.js +97 -97
  204. package/dist/util/http/headers.js +75 -75
  205. package/dist/util/http/http-request.js +379 -379
  206. package/dist/util/http/index.js +22 -22
  207. package/dist/util/http/json-request.js +224 -224
  208. package/dist/util/http/mocks.js +65 -65
  209. package/dist/util/http/response.js +294 -294
  210. package/dist/util/http/test-data__/content-length-test-hkdigital-small.V4HfZyBQ.avif +0 -0
  211. package/dist/util/http/typedef.js +93 -93
  212. package/dist/util/http/url.js +52 -52
  213. package/dist/util/image/index.js +86 -86
  214. package/dist/util/index.js +2 -2
  215. package/dist/util/is/index.js +140 -140
  216. package/dist/util/iterate/index.js +234 -234
  217. package/dist/util/object/index.js +1361 -1361
  218. package/dist/util/singleton/index.js +97 -97
  219. package/dist/util/string/array-path.js +75 -75
  220. package/dist/util/string/convert.js +54 -54
  221. package/dist/util/string/fs.js +226 -226
  222. package/dist/util/string/index.js +5 -5
  223. package/dist/util/string/interpolate.js +61 -61
  224. package/dist/util/string/pad.js +10 -10
  225. package/dist/util/svelte/index.js +4 -4
  226. package/dist/util/svelte/loading/loading-tracker.svelte.js +108 -108
  227. package/dist/util/svelte/observe/index.js +49 -49
  228. package/dist/util/svelte/state-context/index.js +117 -117
  229. package/dist/util/svelte/wait/index.js +38 -38
  230. package/dist/util/sveltekit/index.js +1 -1
  231. package/dist/util/sveltekit/route-folders/index.js +101 -101
  232. package/dist/util/time/index.js +323 -323
  233. package/dist/util/unique/index.js +249 -249
  234. package/dist/valibot/date.js__ +10 -10
  235. package/dist/valibot/index.js +9 -9
  236. package/dist/valibot/url.js +95 -95
  237. package/dist/valibot/user.js +23 -23
  238. package/dist/zod/all.js +33 -33
  239. package/dist/zod/generic.js +11 -11
  240. package/dist/zod/javascript.js +32 -32
  241. package/dist/zod/user.js +16 -16
  242. package/dist/zod/web.js +52 -52
  243. package/package.json +112 -112
@@ -1,275 +1,275 @@
1
- /**
2
- * @fileoverview Simple event emitter implementation to support event-based architecture
3
- * in service management and other parts of the application.
4
- *
5
- * This implementation provides standard event publishing and subscription methods
6
- * with support for namespaced events, wildcard listeners, and callback removal.
7
- *
8
- * @example
9
- * // Basic usage
10
- * import { EventEmitter } from './EventEmitter.js';
11
- *
12
- * // Create an emitter
13
- * const events = new EventEmitter();
14
- *
15
- * // Subscribe to events
16
- * const unsubscribe = events.on('data-loaded', (data) => {
17
- * console.log('Data loaded:', data);
18
- * });
19
- *
20
- * // Subscribe to all events with a specific prefix
21
- * events.on('database:*', ({ event, data }) => {
22
- * console.log(`Database event ${event}:`, data);
23
- * });
24
- *
25
- * // Emit events
26
- * events.emit('data-loaded', { items: [1, 2, 3] });
27
- * events.emit('database:connected', { connectionId: 'abc123' });
28
- *
29
- * // Clean up when done
30
- * unsubscribe();
31
- *
32
- * // Or remove all listeners
33
- * events.removeAllListeners();
34
- */
35
-
36
- /**
37
- * EventEmitter class for event-based programming
38
- */
39
- export default class EventEmitter {
40
- /**
41
- * Create a new EventEmitter instance
42
- */
43
- constructor() {
44
- /**
45
- * Map to store event handlers
46
- * @type {Map<string, Set<Function>>}
47
- * @private
48
- */
49
- this.eventHandlers = new Map();
50
-
51
- /**
52
- * Map to store wildcard event handlers (events ending with *)
53
- * @type {Map<string, Set<Function>>}
54
- * @private
55
- */
56
- this.wildcardHandlers = new Map();
57
- }
58
-
59
- /**
60
- * Register an event handler
61
- *
62
- * @param {string} eventName - Event name to listen for. Can use wildcard (*)
63
- * at the end to listen to all events with a specific prefix.
64
- * @param {Function} handler - Handler function to call when event is emitted
65
- * @returns {Function} Function to remove this specific handler
66
- *
67
- * @example
68
- * // Listen for a specific event
69
- * emitter.on('userLoggedIn', (user) => {
70
- * console.log(`User logged in: ${user.name}`);
71
- * });
72
- *
73
- * // Listen for all events with a prefix
74
- * emitter.on('api:*', ({ event, data }) => {
75
- * console.log(`API event ${event}:`, data);
76
- * });
77
- */
78
- on(eventName, handler) {
79
- if (typeof handler !== 'function') {
80
- throw new TypeError('Event handler must be a function');
81
- }
82
-
83
- // Handle wildcard listeners
84
- if (eventName.endsWith('*')) {
85
- const prefix = eventName.slice(0, -1);
86
-
87
- if (!this.wildcardHandlers.has(prefix)) {
88
- this.wildcardHandlers.set(prefix, new Set());
89
- }
90
-
91
- this.wildcardHandlers.get(prefix).add(handler);
92
-
93
- return () => this.off(eventName, handler);
94
- }
95
-
96
- // Handle normal listeners
97
- if (!this.eventHandlers.has(eventName)) {
98
- this.eventHandlers.set(eventName, new Set());
99
- }
100
-
101
- this.eventHandlers.get(eventName).add(handler);
102
-
103
- return () => this.off(eventName, handler);
104
- }
105
-
106
- /**
107
- * Register a one-time event handler that will be removed after first execution
108
- *
109
- * @param {string} eventName - Event name to listen for
110
- * @param {Function} handler - Handler function to call when event is emitted
111
- * @returns {Function} Function to remove this specific handler
112
- *
113
- * @example
114
- * emitter.once('initialization', () => {
115
- * console.log('Initialization happened');
116
- * });
117
- */
118
- once(eventName, handler) {
119
- if (typeof handler !== 'function') {
120
- throw new TypeError('Event handler must be a function');
121
- }
122
-
123
- const wrapper = (...args) => {
124
- this.off(eventName, wrapper);
125
- handler(...args);
126
- };
127
-
128
- return this.on(eventName, wrapper);
129
- }
130
-
131
- /**
132
- * Remove an event handler
133
- *
134
- * @param {string} eventName - Event name the handler was registered for
135
- * @param {Function} handler - Handler function to remove
136
- * @returns {boolean} True if the handler was removed, false otherwise
137
- *
138
- * @example
139
- * const handler = (data) => console.log(data);
140
- * emitter.on('data', handler);
141
- * emitter.off('data', handler);
142
- */
143
- off(eventName, handler) {
144
- // Handle wildcard listeners
145
- if (eventName.endsWith('*')) {
146
- const prefix = eventName.slice(0, -1);
147
- const handlers = this.wildcardHandlers.get(prefix);
148
-
149
- if (handlers) {
150
- return handlers.delete(handler);
151
- }
152
-
153
- return false;
154
- }
155
-
156
- // Handle normal listeners
157
- const handlers = this.eventHandlers.get(eventName);
158
-
159
- if (handlers) {
160
- return handlers.delete(handler);
161
- }
162
-
163
- return false;
164
- }
165
-
166
- /**
167
- * Remove all event handlers for a specific event
168
- *
169
- * @param {string} [eventName] - Event name to remove handlers for.
170
- * If not provided, removes all handlers for all events.
171
- *
172
- * @example
173
- * // Remove all 'data' event handlers
174
- * emitter.removeAllListeners('data');
175
- *
176
- * // Remove all event handlers
177
- * emitter.removeAllListeners();
178
- */
179
- removeAllListeners(eventName) {
180
- if (eventName) {
181
- // Handle wildcard listeners
182
- if (eventName.endsWith('*')) {
183
- const prefix = eventName.slice(0, -1);
184
- this.wildcardHandlers.delete(prefix);
185
- } else {
186
- this.eventHandlers.delete(eventName);
187
- }
188
- } else {
189
- // Clear all handlers
190
- this.eventHandlers.clear();
191
- this.wildcardHandlers.clear();
192
- }
193
- }
194
-
195
- /**
196
- * Emit an event
197
- *
198
- * @param {string} eventName - Name of the event to emit
199
- * @param {*} data - Data to pass to event handlers
200
- * @returns {boolean} True if there were handlers for this event, false otherwise
201
- *
202
- * @example
203
- * emitter.emit('dataLoaded', { users: [...] });
204
- */
205
- emit(eventName, data) {
206
- let handled = false;
207
-
208
- // Call specific event handlers
209
- const handlers = this.eventHandlers.get(eventName);
210
- if (handlers && handlers.size > 0) {
211
- handlers.forEach(handler => handler(data));
212
- handled = true;
213
- }
214
-
215
- // Call matching wildcard handlers
216
- this.wildcardHandlers.forEach((handlers, prefix) => {
217
- if (eventName.startsWith(prefix)) {
218
- handlers.forEach(handler =>
219
- handler({ event: eventName, data })
220
- );
221
- handled = true;
222
- }
223
- });
224
-
225
- return handled;
226
- }
227
-
228
- /**
229
- * Get the number of listeners for a specific event
230
- *
231
- * @param {string} eventName - Event name to count listeners for
232
- * @returns {number} Number of listeners for this event
233
- *
234
- * @example
235
- * const count = emitter.listenerCount('data');
236
- * console.log(`There are ${count} data event listeners`);
237
- */
238
- listenerCount(eventName) {
239
- let count = 0;
240
-
241
- // Count specific event handlers
242
- const handlers = this.eventHandlers.get(eventName);
243
- if (handlers) {
244
- count += handlers.size;
245
- }
246
-
247
- // Count matching wildcard handlers
248
- this.wildcardHandlers.forEach((handlers, prefix) => {
249
- if (eventName.startsWith(prefix)) {
250
- count += handlers.size;
251
- }
252
- });
253
-
254
- return count;
255
- }
256
-
257
- /**
258
- * Get all registered event names
259
- *
260
- * @returns {string[]} Array of event names that have listeners
261
- *
262
- * @example
263
- * console.log('Events with listeners:', emitter.eventNames());
264
- */
265
- eventNames() {
266
- const events = [...this.eventHandlers.keys()];
267
-
268
- // Add wildcard events
269
- this.wildcardHandlers.forEach((_, prefix) => {
270
- events.push(`${prefix}*`);
271
- });
272
-
273
- return events;
274
- }
275
- }
1
+ /**
2
+ * @fileoverview Simple event emitter implementation to support event-based architecture
3
+ * in service management and other parts of the application.
4
+ *
5
+ * This implementation provides standard event publishing and subscription methods
6
+ * with support for namespaced events, wildcard listeners, and callback removal.
7
+ *
8
+ * @example
9
+ * // Basic usage
10
+ * import { EventEmitter } from './EventEmitter.js';
11
+ *
12
+ * // Create an emitter
13
+ * const events = new EventEmitter();
14
+ *
15
+ * // Subscribe to events
16
+ * const unsubscribe = events.on('data-loaded', (data) => {
17
+ * console.log('Data loaded:', data);
18
+ * });
19
+ *
20
+ * // Subscribe to all events with a specific prefix
21
+ * events.on('database:*', ({ event, data }) => {
22
+ * console.log(`Database event ${event}:`, data);
23
+ * });
24
+ *
25
+ * // Emit events
26
+ * events.emit('data-loaded', { items: [1, 2, 3] });
27
+ * events.emit('database:connected', { connectionId: 'abc123' });
28
+ *
29
+ * // Clean up when done
30
+ * unsubscribe();
31
+ *
32
+ * // Or remove all listeners
33
+ * events.removeAllListeners();
34
+ */
35
+
36
+ /**
37
+ * EventEmitter class for event-based programming
38
+ */
39
+ export default class EventEmitter {
40
+ /**
41
+ * Create a new EventEmitter instance
42
+ */
43
+ constructor() {
44
+ /**
45
+ * Map to store event handlers
46
+ * @type {Map<string, Set<Function>>}
47
+ * @private
48
+ */
49
+ this.eventHandlers = new Map();
50
+
51
+ /**
52
+ * Map to store wildcard event handlers (events ending with *)
53
+ * @type {Map<string, Set<Function>>}
54
+ * @private
55
+ */
56
+ this.wildcardHandlers = new Map();
57
+ }
58
+
59
+ /**
60
+ * Register an event handler
61
+ *
62
+ * @param {string} eventName - Event name to listen for. Can use wildcard (*)
63
+ * at the end to listen to all events with a specific prefix.
64
+ * @param {Function} handler - Handler function to call when event is emitted
65
+ * @returns {Function} Function to remove this specific handler
66
+ *
67
+ * @example
68
+ * // Listen for a specific event
69
+ * emitter.on('userLoggedIn', (user) => {
70
+ * console.log(`User logged in: ${user.name}`);
71
+ * });
72
+ *
73
+ * // Listen for all events with a prefix
74
+ * emitter.on('api:*', ({ event, data }) => {
75
+ * console.log(`API event ${event}:`, data);
76
+ * });
77
+ */
78
+ on(eventName, handler) {
79
+ if (typeof handler !== 'function') {
80
+ throw new TypeError('Event handler must be a function');
81
+ }
82
+
83
+ // Handle wildcard listeners
84
+ if (eventName.endsWith('*')) {
85
+ const prefix = eventName.slice(0, -1);
86
+
87
+ if (!this.wildcardHandlers.has(prefix)) {
88
+ this.wildcardHandlers.set(prefix, new Set());
89
+ }
90
+
91
+ this.wildcardHandlers.get(prefix).add(handler);
92
+
93
+ return () => this.off(eventName, handler);
94
+ }
95
+
96
+ // Handle normal listeners
97
+ if (!this.eventHandlers.has(eventName)) {
98
+ this.eventHandlers.set(eventName, new Set());
99
+ }
100
+
101
+ this.eventHandlers.get(eventName).add(handler);
102
+
103
+ return () => this.off(eventName, handler);
104
+ }
105
+
106
+ /**
107
+ * Register a one-time event handler that will be removed after first execution
108
+ *
109
+ * @param {string} eventName - Event name to listen for
110
+ * @param {Function} handler - Handler function to call when event is emitted
111
+ * @returns {Function} Function to remove this specific handler
112
+ *
113
+ * @example
114
+ * emitter.once('initialization', () => {
115
+ * console.log('Initialization happened');
116
+ * });
117
+ */
118
+ once(eventName, handler) {
119
+ if (typeof handler !== 'function') {
120
+ throw new TypeError('Event handler must be a function');
121
+ }
122
+
123
+ const wrapper = (...args) => {
124
+ this.off(eventName, wrapper);
125
+ handler(...args);
126
+ };
127
+
128
+ return this.on(eventName, wrapper);
129
+ }
130
+
131
+ /**
132
+ * Remove an event handler
133
+ *
134
+ * @param {string} eventName - Event name the handler was registered for
135
+ * @param {Function} handler - Handler function to remove
136
+ * @returns {boolean} True if the handler was removed, false otherwise
137
+ *
138
+ * @example
139
+ * const handler = (data) => console.log(data);
140
+ * emitter.on('data', handler);
141
+ * emitter.off('data', handler);
142
+ */
143
+ off(eventName, handler) {
144
+ // Handle wildcard listeners
145
+ if (eventName.endsWith('*')) {
146
+ const prefix = eventName.slice(0, -1);
147
+ const handlers = this.wildcardHandlers.get(prefix);
148
+
149
+ if (handlers) {
150
+ return handlers.delete(handler);
151
+ }
152
+
153
+ return false;
154
+ }
155
+
156
+ // Handle normal listeners
157
+ const handlers = this.eventHandlers.get(eventName);
158
+
159
+ if (handlers) {
160
+ return handlers.delete(handler);
161
+ }
162
+
163
+ return false;
164
+ }
165
+
166
+ /**
167
+ * Remove all event handlers for a specific event
168
+ *
169
+ * @param {string} [eventName] - Event name to remove handlers for.
170
+ * If not provided, removes all handlers for all events.
171
+ *
172
+ * @example
173
+ * // Remove all 'data' event handlers
174
+ * emitter.removeAllListeners('data');
175
+ *
176
+ * // Remove all event handlers
177
+ * emitter.removeAllListeners();
178
+ */
179
+ removeAllListeners(eventName) {
180
+ if (eventName) {
181
+ // Handle wildcard listeners
182
+ if (eventName.endsWith('*')) {
183
+ const prefix = eventName.slice(0, -1);
184
+ this.wildcardHandlers.delete(prefix);
185
+ } else {
186
+ this.eventHandlers.delete(eventName);
187
+ }
188
+ } else {
189
+ // Clear all handlers
190
+ this.eventHandlers.clear();
191
+ this.wildcardHandlers.clear();
192
+ }
193
+ }
194
+
195
+ /**
196
+ * Emit an event
197
+ *
198
+ * @param {string} eventName - Name of the event to emit
199
+ * @param {*} data - Data to pass to event handlers
200
+ * @returns {boolean} True if there were handlers for this event, false otherwise
201
+ *
202
+ * @example
203
+ * emitter.emit('dataLoaded', { users: [...] });
204
+ */
205
+ emit(eventName, data) {
206
+ let handled = false;
207
+
208
+ // Call specific event handlers
209
+ const handlers = this.eventHandlers.get(eventName);
210
+ if (handlers && handlers.size > 0) {
211
+ handlers.forEach(handler => handler(data));
212
+ handled = true;
213
+ }
214
+
215
+ // Call matching wildcard handlers
216
+ this.wildcardHandlers.forEach((handlers, prefix) => {
217
+ if (eventName.startsWith(prefix)) {
218
+ handlers.forEach(handler =>
219
+ handler({ event: eventName, data })
220
+ );
221
+ handled = true;
222
+ }
223
+ });
224
+
225
+ return handled;
226
+ }
227
+
228
+ /**
229
+ * Get the number of listeners for a specific event
230
+ *
231
+ * @param {string} eventName - Event name to count listeners for
232
+ * @returns {number} Number of listeners for this event
233
+ *
234
+ * @example
235
+ * const count = emitter.listenerCount('data');
236
+ * console.log(`There are ${count} data event listeners`);
237
+ */
238
+ listenerCount(eventName) {
239
+ let count = 0;
240
+
241
+ // Count specific event handlers
242
+ const handlers = this.eventHandlers.get(eventName);
243
+ if (handlers) {
244
+ count += handlers.size;
245
+ }
246
+
247
+ // Count matching wildcard handlers
248
+ this.wildcardHandlers.forEach((handlers, prefix) => {
249
+ if (eventName.startsWith(prefix)) {
250
+ count += handlers.size;
251
+ }
252
+ });
253
+
254
+ return count;
255
+ }
256
+
257
+ /**
258
+ * Get all registered event names
259
+ *
260
+ * @returns {string[]} Array of event names that have listeners
261
+ *
262
+ * @example
263
+ * console.log('Events with listeners:', emitter.eventNames());
264
+ */
265
+ eventNames() {
266
+ const events = [...this.eventHandlers.keys()];
267
+
268
+ // Add wildcard events
269
+ this.wildcardHandlers.forEach((_, prefix) => {
270
+ events.push(`${prefix}*`);
271
+ });
272
+
273
+ return events;
274
+ }
275
+ }
@@ -1,2 +1,2 @@
1
-
2
- export { default as EventEmitter } from './EventEmitter.js';
1
+
2
+ export { default as EventEmitter } from './EventEmitter.js';
@@ -1,4 +1,4 @@
1
- export * as data from './data/index.js';
2
- export * as streams from './streams/index.js';
3
- export * as stores from './stores/index.js';
4
- export * as svelte from './svelte/index.js';
1
+ export * as data from './data/index.js';
2
+ export * as streams from './streams/index.js';
3
+ export * as stores from './stores/index.js';
4
+ export * as svelte from './svelte/index.js';