@procedures/collections 0.0.0-stage → 0.1.0

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 (205) hide show
  1. package/CHANGELOG.md +5 -0
  2. package/LICENSE +21 -0
  3. package/README.md +394 -2
  4. package/dist/.tsbuildinfo +1 -0
  5. package/dist/async/async-queue.d.ts +155 -0
  6. package/dist/async/async-queue.d.ts.map +1 -0
  7. package/dist/async/async-queue.js +342 -0
  8. package/dist/async/async-queue.js.map +1 -0
  9. package/dist/async/channels.d.ts +188 -0
  10. package/dist/async/channels.d.ts.map +1 -0
  11. package/dist/async/channels.js +314 -0
  12. package/dist/async/channels.js.map +1 -0
  13. package/dist/behaviors/bounded.d.ts +79 -0
  14. package/dist/behaviors/bounded.d.ts.map +1 -0
  15. package/dist/behaviors/bounded.js +384 -0
  16. package/dist/behaviors/bounded.js.map +1 -0
  17. package/dist/behaviors/composite.d.ts +17 -0
  18. package/dist/behaviors/composite.d.ts.map +1 -0
  19. package/dist/behaviors/composite.js +93 -0
  20. package/dist/behaviors/composite.js.map +1 -0
  21. package/dist/behaviors/evented.d.ts +154 -0
  22. package/dist/behaviors/evented.d.ts.map +1 -0
  23. package/dist/behaviors/evented.js +299 -0
  24. package/dist/behaviors/evented.js.map +1 -0
  25. package/dist/behaviors/lru.d.ts +84 -0
  26. package/dist/behaviors/lru.d.ts.map +1 -0
  27. package/dist/behaviors/lru.js +376 -0
  28. package/dist/behaviors/lru.js.map +1 -0
  29. package/dist/behaviors/readonly.d.ts +73 -0
  30. package/dist/behaviors/readonly.d.ts.map +1 -0
  31. package/dist/behaviors/readonly.js +177 -0
  32. package/dist/behaviors/readonly.js.map +1 -0
  33. package/dist/behaviors/safe.d.ts +163 -0
  34. package/dist/behaviors/safe.d.ts.map +1 -0
  35. package/dist/behaviors/safe.js +176 -0
  36. package/dist/behaviors/safe.js.map +1 -0
  37. package/dist/behaviors/synchronized.d.ts +88 -0
  38. package/dist/behaviors/synchronized.d.ts.map +1 -0
  39. package/dist/behaviors/synchronized.js +285 -0
  40. package/dist/behaviors/synchronized.js.map +1 -0
  41. package/dist/behaviors/ttl.d.ts +118 -0
  42. package/dist/behaviors/ttl.d.ts.map +1 -0
  43. package/dist/behaviors/ttl.js +354 -0
  44. package/dist/behaviors/ttl.js.map +1 -0
  45. package/dist/contracts/model.d.ts +29 -0
  46. package/dist/contracts/model.d.ts.map +1 -0
  47. package/dist/contracts/model.js +26 -0
  48. package/dist/contracts/model.js.map +1 -0
  49. package/dist/core/effects.d.ts +176 -0
  50. package/dist/core/effects.d.ts.map +1 -0
  51. package/dist/core/effects.js +180 -0
  52. package/dist/core/effects.js.map +1 -0
  53. package/dist/core/events.d.ts +192 -0
  54. package/dist/core/events.d.ts.map +1 -0
  55. package/dist/core/events.js +291 -0
  56. package/dist/core/events.js.map +1 -0
  57. package/dist/core/middleware.d.ts +231 -0
  58. package/dist/core/middleware.d.ts.map +1 -0
  59. package/dist/core/middleware.js +161 -0
  60. package/dist/core/middleware.js.map +1 -0
  61. package/dist/core/policies.d.ts +220 -0
  62. package/dist/core/policies.d.ts.map +1 -0
  63. package/dist/core/policies.js +48 -0
  64. package/dist/core/policies.js.map +1 -0
  65. package/dist/core/traits.d.ts +142 -0
  66. package/dist/core/traits.d.ts.map +1 -0
  67. package/dist/core/traits.js +8 -0
  68. package/dist/core/traits.js.map +1 -0
  69. package/dist/fx/collectors.d.ts +193 -0
  70. package/dist/fx/collectors.d.ts.map +1 -0
  71. package/dist/fx/collectors.js +375 -0
  72. package/dist/fx/collectors.js.map +1 -0
  73. package/dist/fx/iter.d.ts +166 -0
  74. package/dist/fx/iter.d.ts.map +1 -0
  75. package/dist/fx/iter.js +421 -0
  76. package/dist/fx/iter.js.map +1 -0
  77. package/dist/impl/array-deque.d.ts +112 -0
  78. package/dist/impl/array-deque.d.ts.map +1 -0
  79. package/dist/impl/array-deque.js +380 -0
  80. package/dist/impl/array-deque.js.map +1 -0
  81. package/dist/impl/array-list.d.ts +101 -0
  82. package/dist/impl/array-list.d.ts.map +1 -0
  83. package/dist/impl/array-list.js +387 -0
  84. package/dist/impl/array-list.js.map +1 -0
  85. package/dist/impl/hash-map.d.ts +149 -0
  86. package/dist/impl/hash-map.d.ts.map +1 -0
  87. package/dist/impl/hash-map.js +473 -0
  88. package/dist/impl/hash-map.js.map +1 -0
  89. package/dist/impl/hash-set.d.ts +125 -0
  90. package/dist/impl/hash-set.d.ts.map +1 -0
  91. package/dist/impl/hash-set.js +264 -0
  92. package/dist/impl/hash-set.js.map +1 -0
  93. package/dist/impl/linked-hash-map.d.ts +141 -0
  94. package/dist/impl/linked-hash-map.d.ts.map +1 -0
  95. package/dist/impl/linked-hash-map.js +442 -0
  96. package/dist/impl/linked-hash-map.js.map +1 -0
  97. package/dist/impl/linked-list.d.ts +109 -0
  98. package/dist/impl/linked-list.d.ts.map +1 -0
  99. package/dist/impl/linked-list.js +494 -0
  100. package/dist/impl/linked-list.js.map +1 -0
  101. package/dist/impl/priority-queue.d.ts +139 -0
  102. package/dist/impl/priority-queue.d.ts.map +1 -0
  103. package/dist/impl/priority-queue.js +343 -0
  104. package/dist/impl/priority-queue.js.map +1 -0
  105. package/dist/impl/tree-map.d.ts +153 -0
  106. package/dist/impl/tree-map.d.ts.map +1 -0
  107. package/dist/impl/tree-map.js +788 -0
  108. package/dist/impl/tree-map.js.map +1 -0
  109. package/dist/impl/tree-set.d.ts +112 -0
  110. package/dist/impl/tree-set.d.ts.map +1 -0
  111. package/dist/impl/tree-set.js +374 -0
  112. package/dist/impl/tree-set.js.map +1 -0
  113. package/dist/index.d.ts +106 -0
  114. package/dist/index.d.ts.map +1 -0
  115. package/dist/index.js +139 -0
  116. package/dist/index.js.map +1 -0
  117. package/dist/interfaces/collection.d.ts +119 -0
  118. package/dist/interfaces/collection.d.ts.map +1 -0
  119. package/dist/interfaces/collection.js +8 -0
  120. package/dist/interfaces/collection.js.map +1 -0
  121. package/dist/interfaces/list.d.ts +247 -0
  122. package/dist/interfaces/list.d.ts.map +1 -0
  123. package/dist/interfaces/list.js +8 -0
  124. package/dist/interfaces/list.js.map +1 -0
  125. package/dist/interfaces/map.d.ts +344 -0
  126. package/dist/interfaces/map.d.ts.map +1 -0
  127. package/dist/interfaces/map.js +8 -0
  128. package/dist/interfaces/map.js.map +1 -0
  129. package/dist/interfaces/queue.d.ts +304 -0
  130. package/dist/interfaces/queue.d.ts.map +1 -0
  131. package/dist/interfaces/queue.js +8 -0
  132. package/dist/interfaces/queue.js.map +1 -0
  133. package/dist/interfaces/set.d.ts +137 -0
  134. package/dist/interfaces/set.d.ts.map +1 -0
  135. package/dist/interfaces/set.js +8 -0
  136. package/dist/interfaces/set.js.map +1 -0
  137. package/dist/register.d.ts +8 -0
  138. package/dist/register.d.ts.map +1 -0
  139. package/dist/register.js +8 -0
  140. package/dist/register.js.map +1 -0
  141. package/dist/storage/index.d.ts +15 -0
  142. package/dist/storage/index.d.ts.map +1 -0
  143. package/dist/storage/index.js +14 -0
  144. package/dist/storage/index.js.map +1 -0
  145. package/dist/storage/interface.d.ts +141 -0
  146. package/dist/storage/interface.d.ts.map +1 -0
  147. package/dist/storage/interface.js +23 -0
  148. package/dist/storage/interface.js.map +1 -0
  149. package/dist/storage/memory.d.ts +68 -0
  150. package/dist/storage/memory.d.ts.map +1 -0
  151. package/dist/storage/memory.js +154 -0
  152. package/dist/storage/memory.js.map +1 -0
  153. package/dist/utils/defaults.d.ts +135 -0
  154. package/dist/utils/defaults.d.ts.map +1 -0
  155. package/dist/utils/defaults.js +322 -0
  156. package/dist/utils/defaults.js.map +1 -0
  157. package/dist/utils/factories.d.ts +144 -0
  158. package/dist/utils/factories.d.ts.map +1 -0
  159. package/dist/utils/factories.js +293 -0
  160. package/dist/utils/factories.js.map +1 -0
  161. package/dist/utils/helpers.d.ts +137 -0
  162. package/dist/utils/helpers.d.ts.map +1 -0
  163. package/dist/utils/helpers.js +221 -0
  164. package/dist/utils/helpers.js.map +1 -0
  165. package/package.json +68 -3
  166. package/src/async/async-queue.ts +417 -0
  167. package/src/async/channels.ts +374 -0
  168. package/src/behaviors/bounded.ts +477 -0
  169. package/src/behaviors/composite.ts +99 -0
  170. package/src/behaviors/evented.ts +464 -0
  171. package/src/behaviors/lru.ts +447 -0
  172. package/src/behaviors/readonly.ts +224 -0
  173. package/src/behaviors/safe.ts +372 -0
  174. package/src/behaviors/synchronized.ts +316 -0
  175. package/src/behaviors/ttl.ts +462 -0
  176. package/src/contracts/model.ts +44 -0
  177. package/src/core/effects.ts +323 -0
  178. package/src/core/events.ts +356 -0
  179. package/src/core/middleware.ts +415 -0
  180. package/src/core/policies.ts +316 -0
  181. package/src/core/traits.ts +164 -0
  182. package/src/fx/collectors.ts +500 -0
  183. package/src/fx/iter.ts +536 -0
  184. package/src/impl/array-deque.ts +463 -0
  185. package/src/impl/array-list.ts +490 -0
  186. package/src/impl/hash-map.ts +623 -0
  187. package/src/impl/hash-set.ts +342 -0
  188. package/src/impl/linked-hash-map.ts +572 -0
  189. package/src/impl/linked-list.ts +606 -0
  190. package/src/impl/priority-queue.ts +448 -0
  191. package/src/impl/tree-map.ts +912 -0
  192. package/src/impl/tree-set.ts +469 -0
  193. package/src/index.ts +277 -0
  194. package/src/interfaces/collection.ts +141 -0
  195. package/src/interfaces/list.ts +281 -0
  196. package/src/interfaces/map.ts +405 -0
  197. package/src/interfaces/queue.ts +353 -0
  198. package/src/interfaces/set.ts +158 -0
  199. package/src/register.ts +8 -0
  200. package/src/storage/index.ts +16 -0
  201. package/src/storage/interface.ts +179 -0
  202. package/src/storage/memory.ts +180 -0
  203. package/src/utils/defaults.ts +345 -0
  204. package/src/utils/factories.ts +357 -0
  205. package/src/utils/helpers.ts +248 -0
@@ -0,0 +1,473 @@
1
+ /**
2
+ * HashMap implementation - A hash table with custom equality and hashing.
3
+ *
4
+ * Provides O(1) average case lookup, insertion, and deletion.
5
+ * Supports custom equality and hash functions for keys.
6
+ * Mirrors java.util.HashMap.
7
+ *
8
+ * @example
9
+ * const map = hashMap<string, number>()
10
+ * map.set('one', 1)
11
+ * map.set('two', 2)
12
+ * console.log(map.get('one')) // 1
13
+ *
14
+ * // Custom equality for object keys
15
+ * const userMap = hashMap<User, Data>({
16
+ * keyEq: (a, b) => a.id === b.id,
17
+ * keyHash: (u) => hashString(u.id)
18
+ * })
19
+ */
20
+ import { defaultEq, defaultHash } from "../utils/defaults.js";
21
+ /**
22
+ * HashMap<K, V> - Hash table implementation with custom equality/hashing.
23
+ *
24
+ * Uses separate chaining for collision resolution.
25
+ * Automatically resizes when load factor is exceeded.
26
+ *
27
+ * Not thread-safe. Use synchronized() behavior for concurrent access.
28
+ */
29
+ export class HashMap {
30
+ _buckets;
31
+ _size;
32
+ _loadFactor;
33
+ _keyEq;
34
+ _keyHash;
35
+ _valueEq;
36
+ _threshold;
37
+ /**
38
+ * The count of structural changes (a key added or removed, a clear, a resize). An iterator
39
+ * records it at its start and throws when it changes. Before, a resize during iteration made
40
+ * the iterator skip or repeat entries (BUGS-2026-07 L15).
41
+ */
42
+ _modCount = 0;
43
+ constructor(options = {}) {
44
+ const { initialCapacity = 16, loadFactor = 0.75, keyEq = defaultEq, keyHash = defaultHash, valueEq = defaultEq, } = options;
45
+ const capacity = this.nextPowerOfTwo(Math.max(4, initialCapacity));
46
+ this._buckets = new Array(capacity).fill(null);
47
+ this._size = 0;
48
+ this._loadFactor = loadFactor;
49
+ this._keyEq = keyEq;
50
+ this._keyHash = keyHash;
51
+ this._valueEq = valueEq;
52
+ this._threshold = Math.floor(capacity * loadFactor);
53
+ }
54
+ // ========================================================================
55
+ // Size
56
+ // ========================================================================
57
+ get size() {
58
+ return this._size;
59
+ }
60
+ get isEmpty() {
61
+ return this._size === 0;
62
+ }
63
+ get keyEq() {
64
+ return this._keyEq;
65
+ }
66
+ get valueEq() {
67
+ return this._valueEq;
68
+ }
69
+ // ========================================================================
70
+ // Lookup
71
+ // ========================================================================
72
+ has(key) {
73
+ const hash = this._keyHash(key);
74
+ const index = this.bucketIndex(hash);
75
+ let node = this._buckets[index] ?? null;
76
+ while (node !== null) {
77
+ if (node.hash === hash && this._keyEq(node.key, key)) {
78
+ return true;
79
+ }
80
+ node = node.next;
81
+ }
82
+ return false;
83
+ }
84
+ get(key) {
85
+ const value = this.getOrUndefined(key);
86
+ if (value === undefined) {
87
+ throw new Error(`Key not found: ${key}`);
88
+ }
89
+ return value;
90
+ }
91
+ getOrUndefined(key) {
92
+ const hash = this._keyHash(key);
93
+ const index = this.bucketIndex(hash);
94
+ let node = this._buckets[index] ?? null;
95
+ while (node !== null) {
96
+ if (node.hash === hash && this._keyEq(node.key, key)) {
97
+ return node.value;
98
+ }
99
+ node = node.next;
100
+ }
101
+ return undefined;
102
+ }
103
+ getOrDefault(key, defaultValue) {
104
+ const value = this.getOrUndefined(key);
105
+ return value !== undefined ? value : defaultValue;
106
+ }
107
+ containsValue(value) {
108
+ for (const bucket of this._buckets) {
109
+ let node = bucket;
110
+ while (node !== null) {
111
+ if (this._valueEq(node.value, value)) {
112
+ return true;
113
+ }
114
+ node = node.next;
115
+ }
116
+ }
117
+ return false;
118
+ }
119
+ // ========================================================================
120
+ // Modification
121
+ // ========================================================================
122
+ set(key, value) {
123
+ const hash = this._keyHash(key);
124
+ const index = this.bucketIndex(hash);
125
+ let node = this._buckets[index] ?? null;
126
+ // Check if key already exists
127
+ while (node !== null) {
128
+ if (node.hash === hash && this._keyEq(node.key, key)) {
129
+ const oldValue = node.value;
130
+ node.value = value;
131
+ return oldValue;
132
+ }
133
+ node = node.next;
134
+ }
135
+ // Key doesn't exist, add new entry
136
+ const newNode = {
137
+ key,
138
+ value,
139
+ hash,
140
+ next: this._buckets[index] ?? null,
141
+ };
142
+ this._buckets[index] = newNode;
143
+ this._size++;
144
+ this._modCount++;
145
+ // Check if resize is needed
146
+ if (this._size > this._threshold) {
147
+ this.resize();
148
+ }
149
+ return undefined;
150
+ }
151
+ setIfAbsent(key, value) {
152
+ const existing = this.getOrUndefined(key);
153
+ if (existing !== undefined) {
154
+ return existing;
155
+ }
156
+ this.set(key, value);
157
+ return value;
158
+ }
159
+ delete(key) {
160
+ const hash = this._keyHash(key);
161
+ const index = this.bucketIndex(hash);
162
+ let node = this._buckets[index] ?? null;
163
+ let prev = null;
164
+ while (node !== null) {
165
+ if (node.hash === hash && this._keyEq(node.key, key)) {
166
+ // Found the node to delete
167
+ if (prev === null) {
168
+ // Node is at head of bucket
169
+ this._buckets[index] = node.next;
170
+ }
171
+ else {
172
+ // Node is in middle or end
173
+ prev.next = node.next;
174
+ }
175
+ this._size--;
176
+ this._modCount++;
177
+ return node.value;
178
+ }
179
+ prev = node;
180
+ node = node.next;
181
+ }
182
+ return undefined;
183
+ }
184
+ deleteEntry(key, value) {
185
+ const hash = this._keyHash(key);
186
+ const index = this.bucketIndex(hash);
187
+ let node = this._buckets[index] ?? null;
188
+ let prev = null;
189
+ while (node !== null) {
190
+ if (node.hash === hash &&
191
+ this._keyEq(node.key, key) &&
192
+ this._valueEq(node.value, value)) {
193
+ // Found the entry to delete
194
+ if (prev === null) {
195
+ this._buckets[index] = node.next;
196
+ }
197
+ else {
198
+ prev.next = node.next;
199
+ }
200
+ this._size--;
201
+ this._modCount++;
202
+ return true;
203
+ }
204
+ prev = node;
205
+ node = node.next;
206
+ }
207
+ return false;
208
+ }
209
+ replace(key, value) {
210
+ const hash = this._keyHash(key);
211
+ const index = this.bucketIndex(hash);
212
+ let node = this._buckets[index] ?? null;
213
+ while (node !== null) {
214
+ if (node.hash === hash && this._keyEq(node.key, key)) {
215
+ const oldValue = node.value;
216
+ node.value = value;
217
+ return oldValue;
218
+ }
219
+ node = node.next;
220
+ }
221
+ return undefined;
222
+ }
223
+ replaceEntry(key, oldValue, newValue) {
224
+ const hash = this._keyHash(key);
225
+ const index = this.bucketIndex(hash);
226
+ let node = this._buckets[index] ?? null;
227
+ while (node !== null) {
228
+ if (node.hash === hash &&
229
+ this._keyEq(node.key, key) &&
230
+ this._valueEq(node.value, oldValue)) {
231
+ node.value = newValue;
232
+ return true;
233
+ }
234
+ node = node.next;
235
+ }
236
+ return false;
237
+ }
238
+ // ========================================================================
239
+ // Compute operations
240
+ // ========================================================================
241
+ computeIfAbsent(key, mappingFunction) {
242
+ const existing = this.getOrUndefined(key);
243
+ if (existing !== undefined) {
244
+ return existing;
245
+ }
246
+ const newValue = mappingFunction(key);
247
+ this.set(key, newValue);
248
+ return newValue;
249
+ }
250
+ computeIfPresent(key, remappingFunction) {
251
+ const existing = this.getOrUndefined(key);
252
+ if (existing === undefined) {
253
+ return undefined;
254
+ }
255
+ const newValue = remappingFunction(key, existing);
256
+ if (newValue === undefined) {
257
+ this.delete(key);
258
+ return undefined;
259
+ }
260
+ this.set(key, newValue);
261
+ return newValue;
262
+ }
263
+ compute(key, remappingFunction) {
264
+ const existing = this.getOrUndefined(key);
265
+ const newValue = remappingFunction(key, existing);
266
+ if (newValue === undefined) {
267
+ if (existing !== undefined) {
268
+ this.delete(key);
269
+ }
270
+ return undefined;
271
+ }
272
+ this.set(key, newValue);
273
+ return newValue;
274
+ }
275
+ merge(key, value, remappingFunction) {
276
+ const existing = this.getOrUndefined(key);
277
+ if (existing === undefined) {
278
+ this.set(key, value);
279
+ return value;
280
+ }
281
+ const merged = remappingFunction(existing, value);
282
+ if (merged === undefined) {
283
+ this.delete(key);
284
+ return undefined;
285
+ }
286
+ this.set(key, merged);
287
+ return merged;
288
+ }
289
+ // ========================================================================
290
+ // Bulk operations
291
+ // ========================================================================
292
+ putAll(other) {
293
+ for (const entry of other) {
294
+ this.set(entry.key, entry.value);
295
+ }
296
+ }
297
+ clear() {
298
+ this._buckets.fill(null);
299
+ this._size = 0;
300
+ this._modCount++;
301
+ }
302
+ // ========================================================================
303
+ // Views
304
+ // ========================================================================
305
+ *keys() {
306
+ const expected = this._modCount;
307
+ for (const bucket of this._buckets) {
308
+ let node = bucket;
309
+ while (node !== null) {
310
+ yield node.key;
311
+ this.checkUnchanged(expected);
312
+ node = node.next;
313
+ }
314
+ }
315
+ }
316
+ *values() {
317
+ const expected = this._modCount;
318
+ for (const bucket of this._buckets) {
319
+ let node = bucket;
320
+ while (node !== null) {
321
+ yield node.value;
322
+ this.checkUnchanged(expected);
323
+ node = node.next;
324
+ }
325
+ }
326
+ }
327
+ *entries() {
328
+ const expected = this._modCount;
329
+ for (const bucket of this._buckets) {
330
+ let node = bucket;
331
+ while (node !== null) {
332
+ yield { key: node.key, value: node.value };
333
+ this.checkUnchanged(expected);
334
+ node = node.next;
335
+ }
336
+ }
337
+ }
338
+ // ========================================================================
339
+ // Iteration
340
+ // ========================================================================
341
+ *[Symbol.iterator]() {
342
+ yield* this.entries();
343
+ }
344
+ forEach(action) {
345
+ for (const entry of this.entries()) {
346
+ action(entry.value, entry.key, this);
347
+ }
348
+ }
349
+ // ========================================================================
350
+ // Internal helpers
351
+ // ========================================================================
352
+ /** This method throws when the map changed structurally after an iterator started. */
353
+ checkUnchanged(expected) {
354
+ if (this._modCount !== expected) {
355
+ throw new Error("HashMap changed during iteration");
356
+ }
357
+ }
358
+ /**
359
+ * Returns the bucket index for a given hash.
360
+ */
361
+ bucketIndex(hash) {
362
+ // Use bitwise AND with (length - 1) for efficient modulo
363
+ // This works because length is always a power of 2
364
+ return hash & (this._buckets.length - 1);
365
+ }
366
+ /**
367
+ * Resizes the hash table to double its current capacity.
368
+ */
369
+ resize() {
370
+ const oldBuckets = this._buckets;
371
+ const newCapacity = oldBuckets.length << 1; // Double capacity
372
+ if (newCapacity < 0) {
373
+ throw new Error("Map too large");
374
+ }
375
+ this._buckets = new Array(newCapacity).fill(null);
376
+ this._threshold = Math.floor(newCapacity * this._loadFactor);
377
+ this._modCount++;
378
+ // Rehash all entries
379
+ for (const bucket of oldBuckets) {
380
+ let node = bucket;
381
+ while (node !== null) {
382
+ const next = node.next;
383
+ const index = this.bucketIndex(node.hash);
384
+ node.next = this._buckets[index] ?? null;
385
+ this._buckets[index] = node;
386
+ node = next;
387
+ }
388
+ }
389
+ }
390
+ /**
391
+ * Returns the next power of 2 >= n.
392
+ */
393
+ nextPowerOfTwo(n) {
394
+ if (n <= 0)
395
+ return 1;
396
+ n--;
397
+ n |= n >> 1;
398
+ n |= n >> 2;
399
+ n |= n >> 4;
400
+ n |= n >> 8;
401
+ n |= n >> 16;
402
+ return n + 1;
403
+ }
404
+ // ========================================================================
405
+ // Inspection
406
+ // ========================================================================
407
+ /**
408
+ * Returns the current number of buckets.
409
+ */
410
+ get capacity() {
411
+ return this._buckets.length;
412
+ }
413
+ /**
414
+ * Returns the current load factor (size / capacity).
415
+ */
416
+ get loadFactor() {
417
+ return this._size / this._buckets.length;
418
+ }
419
+ /**
420
+ * Returns statistics about bucket distribution (for debugging).
421
+ */
422
+ getStats() {
423
+ let maxChainLength = 0;
424
+ let totalChainLength = 0;
425
+ let emptyBuckets = 0;
426
+ for (const bucket of this._buckets) {
427
+ if (bucket === null) {
428
+ emptyBuckets++;
429
+ }
430
+ else {
431
+ let length = 0;
432
+ let node = bucket;
433
+ while (node !== null) {
434
+ length++;
435
+ node = node.next;
436
+ }
437
+ totalChainLength += length;
438
+ maxChainLength = Math.max(maxChainLength, length);
439
+ }
440
+ }
441
+ return {
442
+ size: this._size,
443
+ capacity: this._buckets.length,
444
+ loadFactor: this.loadFactor,
445
+ avgChainLength: this._size > 0 ? totalChainLength / (this._buckets.length - emptyBuckets) : 0,
446
+ maxChainLength,
447
+ emptyBuckets,
448
+ };
449
+ }
450
+ }
451
+ /**
452
+ * Factory function to create a HashMap.
453
+ *
454
+ * @example
455
+ * const map = hashMap<string, number>()
456
+ * const mapWithOptions = hashMap<User, Data>({
457
+ * keyEq: (a, b) => a.id === b.id,
458
+ * keyHash: (u) => hashString(u.id)
459
+ * })
460
+ * const mapFromEntries = hashMap([['a', 1], ['b', 2]])
461
+ */
462
+ export function hashMap(optionsOrEntries) {
463
+ // Check if it's an iterable of entries
464
+ if (optionsOrEntries && Symbol.iterator in optionsOrEntries) {
465
+ const map = new HashMap();
466
+ for (const [key, value] of optionsOrEntries) {
467
+ map.set(key, value);
468
+ }
469
+ return map;
470
+ }
471
+ return new HashMap(optionsOrEntries);
472
+ }
473
+ //# sourceMappingURL=hash-map.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hash-map.js","sourceRoot":"","sources":["../../src/impl/hash-map.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,125 @@
1
+ /**
2
+ * HashSet implementation - A set backed by a HashMap.
3
+ *
4
+ * Provides O(1) average case for add, remove, and contains operations.
5
+ * Elements are unique based on custom equality and hash functions.
6
+ * Mirrors java.util.HashSet.
7
+ *
8
+ * @example
9
+ * const set = hashSet<number>()
10
+ * set.add(1)
11
+ * set.add(2)
12
+ * set.add(1) // Returns false, already present
13
+ * set.size // 2
14
+ */
15
+ import type { Set } from "../interfaces/set.js";
16
+ import type { Eq, Hash } from "../core/traits.js";
17
+ import { HashMap } from "./hash-map.js";
18
+ /**
19
+ * Options for creating a HashSet.
20
+ */
21
+ export interface HashSetOptions<T> {
22
+ /**
23
+ * Initial capacity.
24
+ * @default 16
25
+ */
26
+ initialCapacity?: number;
27
+ /**
28
+ * Load factor threshold for resizing.
29
+ * @default 0.75
30
+ */
31
+ loadFactor?: number;
32
+ /**
33
+ * Equality function for elements.
34
+ * @default defaultEq (===)
35
+ */
36
+ eq?: Eq<T>;
37
+ /**
38
+ * Hash function for elements.
39
+ * @default defaultHash
40
+ */
41
+ hash?: Hash<T>;
42
+ }
43
+ /**
44
+ * HashSet<T> - Hash table implementation of the Set interface.
45
+ *
46
+ * Backed by a HashMap where values are a dummy constant.
47
+ * Provides constant-time performance for basic operations.
48
+ *
49
+ * Not thread-safe. Use synchronized() behavior for concurrent access.
50
+ */
51
+ export declare class HashSet<T> implements Set<T> {
52
+ private readonly _map;
53
+ private readonly _eq;
54
+ constructor(options?: HashSetOptions<T>);
55
+ get size(): number;
56
+ get isEmpty(): boolean;
57
+ get eq(): Eq<T>;
58
+ add(element: T): boolean;
59
+ remove(element: T): boolean;
60
+ contains(element: T): boolean;
61
+ addAll(other: Iterable<T>): boolean;
62
+ removeAll(other: Iterable<T>): boolean;
63
+ retainAll(other: Iterable<T>): boolean;
64
+ containsAll(other: Iterable<T>): boolean;
65
+ clear(): void;
66
+ /**
67
+ * Returns a new set that is the union of this set and the other set.
68
+ * Contains all elements from both sets.
69
+ */
70
+ union(other: Iterable<T>): HashSet<T>;
71
+ /**
72
+ * Returns a new set that is the intersection of this set and the other set.
73
+ * Contains only elements present in both sets.
74
+ */
75
+ intersection(other: Iterable<T>): HashSet<T>;
76
+ /**
77
+ * Returns a new set that is the difference of this set and the other set.
78
+ * Contains elements in this set but not in the other set.
79
+ */
80
+ difference(other: Iterable<T>): HashSet<T>;
81
+ /**
82
+ * Returns a new set that is the symmetric difference of this set and the other set.
83
+ * Contains elements in either set but not in both.
84
+ */
85
+ symmetricDifference(other: Iterable<T>): HashSet<T>;
86
+ /**
87
+ * Returns true if this set is a subset of the other set.
88
+ * All elements in this set are also in the other set.
89
+ */
90
+ isSubsetOf(other: Iterable<T>): boolean;
91
+ /**
92
+ * Returns true if this set is a superset of the other set.
93
+ * All elements in the other set are also in this set.
94
+ */
95
+ isSupersetOf(other: Iterable<T>): boolean;
96
+ /**
97
+ * Returns true if this set and the other set have no elements in common.
98
+ */
99
+ isDisjointFrom(other: Iterable<T>): boolean;
100
+ [Symbol.iterator](): Iterator<T>;
101
+ forEach(action: (element: T, index: number) => void): void;
102
+ toArray(): T[];
103
+ /**
104
+ * Creates a shallow copy of this set.
105
+ */
106
+ clone(): HashSet<T>;
107
+ /**
108
+ * Returns statistics about the underlying hash table.
109
+ */
110
+ getStats(): ReturnType<HashMap<T, symbol>["getStats"]>;
111
+ /**
112
+ * Returns a string representation for debugging.
113
+ */
114
+ toString(): string;
115
+ }
116
+ /**
117
+ * Factory function to create a HashSet.
118
+ *
119
+ * @example
120
+ * const set = hashSet<number>()
121
+ * const setFromArray = hashSet([1, 2, 3, 2, 1]) // {1, 2, 3}
122
+ * const setWithOptions = hashSet<string>({ initialCapacity: 32 })
123
+ */
124
+ export declare function hashSet<T>(optionsOrElements?: HashSetOptions<T> | Iterable<T>): HashSet<T>;
125
+ //# sourceMappingURL=hash-set.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hash-set.d.ts","sourceRoot":"","sources":["../../src/impl/hash-set.ts"],"names":[],"mappings":"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"}