@hkdigital/lib-sveltekit 0.2.6 → 0.2.8

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.d.ts +0 -20
  59. package/dist/components/drag-drop/DragController.js +44 -113
  60. package/dist/components/drag-drop/DragDropContext.svelte +110 -103
  61. package/dist/components/drag-drop/Draggable.svelte +512 -492
  62. package/dist/components/drag-drop/Draggable.svelte.d.ts +8 -2
  63. package/dist/components/drag-drop/DropZoneArea.svelte +119 -119
  64. package/dist/components/drag-drop/DropZoneList.svelte +125 -125
  65. package/dist/components/drag-drop/{DropZone.svelte → Dropzone.svelte} +258 -258
  66. package/dist/components/drag-drop/drag-state.svelte.js +319 -323
  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/util.js +74 -74
  85. package/dist/components/layout/index.js +1 -1
  86. package/dist/components/panels/index.js +1 -1
  87. package/dist/components/panels/panel/Panel.svelte +43 -43
  88. package/dist/components/rows/index.js +3 -3
  89. package/dist/components/rows/panel-grid-row/PanelGridRow.svelte +104 -104
  90. package/dist/components/rows/panel-row-2/PanelRow2.svelte +40 -40
  91. package/dist/components/tab-bar/HkTabBar.state.svelte.js +149 -149
  92. package/dist/components/tab-bar/HkTabBar.svelte +74 -74
  93. package/dist/components/tab-bar/HkTabBarSelector.state.svelte.js +93 -93
  94. package/dist/components/tab-bar/HkTabBarSelector.svelte +49 -49
  95. package/dist/components/tab-bar/index.js +17 -17
  96. package/dist/components/tab-bar/typedef.js +11 -11
  97. package/dist/config/imagetools-config.js +189 -189
  98. package/dist/config/imagetools.d.ts +72 -72
  99. package/dist/constants/bases.js +13 -13
  100. package/dist/constants/errors/api.js +9 -9
  101. package/dist/constants/errors/generic.js +5 -5
  102. package/dist/constants/errors/index.js +3 -3
  103. package/dist/constants/errors/jwt.js +5 -5
  104. package/dist/constants/http/headers.js +6 -6
  105. package/dist/constants/http/index.js +2 -2
  106. package/dist/constants/http/methods.js +2 -2
  107. package/dist/constants/index.js +3 -3
  108. package/dist/constants/mime/application.js +5 -5
  109. package/dist/constants/mime/audio.js +13 -13
  110. package/dist/constants/mime/image.js +3 -3
  111. package/dist/constants/mime/index.js +4 -4
  112. package/dist/constants/mime/text.js +2 -2
  113. package/dist/constants/regexp/index.js +31 -31
  114. package/dist/constants/regexp/inspiratie.js__ +95 -95
  115. package/dist/constants/regexp/text.js +49 -49
  116. package/dist/constants/regexp/user.js +32 -32
  117. package/dist/constants/regexp/web.js +3 -3
  118. package/dist/constants/state-labels/drag-states.js +6 -6
  119. package/dist/constants/state-labels/drop-states.js +6 -6
  120. package/dist/constants/state-labels/input-states.js +11 -11
  121. package/dist/constants/state-labels/submit-states.js +4 -4
  122. package/dist/constants/time.js +28 -28
  123. package/dist/css/utilities.css +43 -43
  124. package/dist/design/design-config.js +73 -73
  125. package/dist/design/tailwind-theme-extend.js +158 -158
  126. package/dist/features/button-group/ButtonGroup.svelte +82 -82
  127. package/dist/features/button-group/typedef.js +10 -10
  128. package/dist/features/compare-left-right/CompareLeftRight.svelte +179 -179
  129. package/dist/features/compare-left-right/index.js +1 -1
  130. package/dist/features/game-box/GameBox.svelte +577 -577
  131. package/dist/features/game-box/gamebox.util.js +83 -83
  132. package/dist/features/hk-app-layout/HkAppLayout.state.svelte.js +25 -25
  133. package/dist/features/hk-app-layout/HkAppLayout.svelte +251 -251
  134. package/dist/features/image-box/ImageBox.svelte +210 -210
  135. package/dist/features/image-box/index.js +5 -5
  136. package/dist/features/image-box/typedef.js +32 -32
  137. package/dist/features/index.js +23 -23
  138. package/dist/features/presenter/ImageSlide.svelte +64 -64
  139. package/dist/features/presenter/Presenter.state.svelte.js +638 -638
  140. package/dist/features/presenter/Presenter.svelte +142 -142
  141. package/dist/features/presenter/constants.js +7 -7
  142. package/dist/features/presenter/index.js +10 -10
  143. package/dist/features/presenter/typedef.js +106 -106
  144. package/dist/features/presenter/util.js +210 -210
  145. package/dist/features/virtual-viewport/VirtualViewport.svelte +196 -196
  146. package/dist/schemas/index.js +1 -1
  147. package/dist/schemas/validate-url.js +180 -180
  148. package/dist/server/index.js +1 -1
  149. package/dist/server/logger.js +94 -94
  150. package/dist/states/index.js +1 -1
  151. package/dist/states/navigation.svelte.js +55 -55
  152. package/dist/stores/index.js +1 -1
  153. package/dist/stores/theme.js +80 -80
  154. package/dist/themes/hkdev/components/blocks/text-block.css +41 -41
  155. package/dist/themes/hkdev/components/boxes/game-box.css +12 -12
  156. package/dist/themes/hkdev/components/buttons/button-icon-steeze.css +22 -22
  157. package/dist/themes/hkdev/components/buttons/button-text.css +32 -32
  158. package/dist/themes/hkdev/components/buttons/button.css +146 -146
  159. package/dist/themes/hkdev/components/buttons/skip-button.css +6 -6
  160. package/dist/themes/hkdev/components/drag-drop/draggable.css +73 -73
  161. package/dist/themes/hkdev/components/drag-drop/drop-zone.css +48 -48
  162. package/dist/themes/hkdev/components/icons/icon-steeze.css +22 -22
  163. package/dist/themes/hkdev/components/inputs/text-input.css +104 -104
  164. package/dist/themes/hkdev/components/panels/panel.css +27 -27
  165. package/dist/themes/hkdev/components/rows/panel-grid-row.css +6 -6
  166. package/dist/themes/hkdev/components/rows/panel-row-2.css +7 -7
  167. package/dist/themes/hkdev/components.css +53 -53
  168. package/dist/themes/hkdev/debug.css +1 -1
  169. package/dist/themes/hkdev/global/layout.css +39 -39
  170. package/dist/themes/hkdev/global/on-colors.css +53 -53
  171. package/dist/themes/hkdev/globals.css +11 -11
  172. package/dist/themes/hkdev/responsive.css +12 -12
  173. package/dist/themes/hkdev/theme-ext.js +15 -15
  174. package/dist/themes/hkdev/theme.js +235 -235
  175. package/dist/themes/index.js +1 -1
  176. package/dist/typedef/context.js +6 -6
  177. package/dist/typedef/drag.js +25 -25
  178. package/dist/typedef/drop.js +12 -12
  179. package/dist/typedef/image.js +38 -38
  180. package/dist/typedef/index.js +4 -4
  181. package/dist/util/array/index.js +436 -436
  182. package/dist/util/bases/base58.js +262 -262
  183. package/dist/util/bases/index.js +1 -1
  184. package/dist/util/compare/index.js +247 -247
  185. package/dist/util/css/css-vars.js +83 -83
  186. package/dist/util/css/index.js +1 -1
  187. package/dist/util/design-system/components/states.js +22 -22
  188. package/dist/util/design-system/css/clamp.js +66 -66
  189. package/dist/util/design-system/css/root-design-vars.js +102 -102
  190. package/dist/util/design-system/index.js +5 -5
  191. package/dist/util/design-system/layout/scaling.js +228 -228
  192. package/dist/util/design-system/skeleton.js +208 -208
  193. package/dist/util/design-system/tailwind.js +288 -288
  194. package/dist/util/env/index.js +9 -9
  195. package/dist/util/expect/arrays.js +47 -47
  196. package/dist/util/expect/index.js +259 -259
  197. package/dist/util/expect/primitives.js +55 -55
  198. package/dist/util/expect/url.js +60 -60
  199. package/dist/util/function/index.js +218 -218
  200. package/dist/util/geo/index.js +26 -26
  201. package/dist/util/http/caching.js +263 -263
  202. package/dist/util/http/errors.js +97 -97
  203. package/dist/util/http/headers.js +75 -75
  204. package/dist/util/http/http-request.js +379 -379
  205. package/dist/util/http/index.js +22 -22
  206. package/dist/util/http/json-request.js +224 -224
  207. package/dist/util/http/mocks.js +65 -65
  208. package/dist/util/http/response.js +294 -294
  209. package/dist/util/http/typedef.js +93 -93
  210. package/dist/util/http/url.js +52 -52
  211. package/dist/util/image/index.js +86 -86
  212. package/dist/util/index.js +2 -2
  213. package/dist/util/is/index.js +140 -140
  214. package/dist/util/iterate/index.js +234 -234
  215. package/dist/util/object/index.js +1361 -1361
  216. package/dist/util/singleton/index.js +97 -97
  217. package/dist/util/string/array-path.js +75 -75
  218. package/dist/util/string/convert.js +54 -54
  219. package/dist/util/string/fs.js +226 -226
  220. package/dist/util/string/index.js +5 -5
  221. package/dist/util/string/interpolate.js +61 -61
  222. package/dist/util/string/pad.js +10 -10
  223. package/dist/util/svelte/index.js +4 -4
  224. package/dist/util/svelte/loading/loading-tracker.svelte.js +108 -108
  225. package/dist/util/svelte/observe/index.js +49 -49
  226. package/dist/util/svelte/state-context/index.js +117 -117
  227. package/dist/util/svelte/wait/index.js +38 -38
  228. package/dist/util/sveltekit/index.js +1 -1
  229. package/dist/util/sveltekit/route-folders/index.js +101 -101
  230. package/dist/util/time/index.js +323 -323
  231. package/dist/util/unique/index.js +249 -249
  232. package/dist/valibot/date.js__ +10 -10
  233. package/dist/valibot/index.js +9 -9
  234. package/dist/valibot/url.js +95 -95
  235. package/dist/valibot/user.js +23 -23
  236. package/dist/zod/all.js +33 -33
  237. package/dist/zod/generic.js +11 -11
  238. package/dist/zod/javascript.js +32 -32
  239. package/dist/zod/user.js +16 -16
  240. package/dist/zod/web.js +52 -52
  241. package/package.json +112 -112
  242. package/dist/components/layout/grid-layers/GridLayers.svelte__heightFrom__ +0 -372
  243. package/dist/util/http/test-data__/content-length-test-hkdigital-small.V4HfZyBQ.avif +0 -0
@@ -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';