@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,494 @@
1
+ /**
2
+ * LinkedList implementation - A doubly-linked list.
3
+ *
4
+ * Provides O(1) insertion/removal at both ends and at known positions.
5
+ * Slower random access O(n) compared to ArrayList.
6
+ * Mirrors java.util.LinkedList.
7
+ *
8
+ * @example
9
+ * const list = linkedList<number>()
10
+ * list.addFirst(1)
11
+ * list.addLast(2)
12
+ * list.add(3)
13
+ */
14
+ import { defaultEq, defaultCompare } from "../utils/defaults.js";
15
+ /**
16
+ * Internal node structure for the linked list.
17
+ */
18
+ class Node {
19
+ value;
20
+ prev;
21
+ next;
22
+ constructor(value, prev = null, next = null) {
23
+ this.value = value;
24
+ this.prev = prev;
25
+ this.next = next;
26
+ }
27
+ }
28
+ /**
29
+ * LinkedList<T> - Doubly-linked list implementation.
30
+ *
31
+ * Efficient for:
32
+ * - Insertion/removal at ends: O(1)
33
+ * - Insertion/removal at known position: O(1)
34
+ * - Sequential iteration: O(n)
35
+ *
36
+ * Not efficient for:
37
+ * - Random access by index: O(n)
38
+ * - Search: O(n)
39
+ *
40
+ * Implements both List and Deque interfaces.
41
+ */
42
+ export class LinkedList {
43
+ _head = null;
44
+ _tail = null;
45
+ _size = 0;
46
+ _eq;
47
+ constructor(options = {}) {
48
+ const { eq = defaultEq } = options;
49
+ this._eq = eq;
50
+ }
51
+ // ========================================================================
52
+ // Size
53
+ // ========================================================================
54
+ get size() {
55
+ return this._size;
56
+ }
57
+ get isEmpty() {
58
+ return this._size === 0;
59
+ }
60
+ get eq() {
61
+ return this._eq;
62
+ }
63
+ // ========================================================================
64
+ // Deque operations (both ends)
65
+ // ========================================================================
66
+ addFirst(element) {
67
+ const newNode = new Node(element, null, this._head);
68
+ if (this._head) {
69
+ this._head.prev = newNode;
70
+ }
71
+ this._head = newNode;
72
+ if (!this._tail) {
73
+ this._tail = newNode;
74
+ }
75
+ this._size++;
76
+ }
77
+ addLast(element) {
78
+ const newNode = new Node(element, this._tail, null);
79
+ if (this._tail) {
80
+ this._tail.next = newNode;
81
+ }
82
+ this._tail = newNode;
83
+ if (!this._head) {
84
+ this._head = newNode;
85
+ }
86
+ this._size++;
87
+ }
88
+ removeFirst() {
89
+ if (!this._head) {
90
+ throw new Error("List is empty");
91
+ }
92
+ return this.pollFirst();
93
+ }
94
+ removeLast() {
95
+ if (!this._tail) {
96
+ throw new Error("List is empty");
97
+ }
98
+ return this.pollLast();
99
+ }
100
+ pollFirst() {
101
+ if (!this._head)
102
+ return undefined;
103
+ const value = this._head.value;
104
+ this._head = this._head.next;
105
+ if (this._head) {
106
+ this._head.prev = null;
107
+ }
108
+ else {
109
+ this._tail = null;
110
+ }
111
+ this._size--;
112
+ return value;
113
+ }
114
+ pollLast() {
115
+ if (!this._tail)
116
+ return undefined;
117
+ const value = this._tail.value;
118
+ this._tail = this._tail.prev;
119
+ if (this._tail) {
120
+ this._tail.next = null;
121
+ }
122
+ else {
123
+ this._head = null;
124
+ }
125
+ this._size--;
126
+ return value;
127
+ }
128
+ peekFirst() {
129
+ if (!this._head) {
130
+ throw new Error("List is empty");
131
+ }
132
+ return this._head.value;
133
+ }
134
+ peekLast() {
135
+ if (!this._tail) {
136
+ throw new Error("List is empty");
137
+ }
138
+ return this._tail.value;
139
+ }
140
+ peekFirstOrUndefined() {
141
+ return this._head?.value;
142
+ }
143
+ peekLastOrUndefined() {
144
+ return this._tail?.value;
145
+ }
146
+ offerFirst(element) {
147
+ this.addFirst(element);
148
+ return true;
149
+ }
150
+ offerLast(element) {
151
+ this.addLast(element);
152
+ return true;
153
+ }
154
+ // ========================================================================
155
+ // Stack operations (LIFO at the end, as on a JavaScript array)
156
+ // ========================================================================
157
+ // push and pop work at the end, and shift/unshift at the front, in every collection of this
158
+ // package. Before, they worked at the front here (the Java Deque rule), so a LinkedList used
159
+ // as a List reversed the pushed elements (ARCHITECTURE-PROPOSALS P8).
160
+ push(element) {
161
+ this.addLast(element);
162
+ }
163
+ pop() {
164
+ return this.removeLast();
165
+ }
166
+ // ========================================================================
167
+ // Queue operations (FIFO)
168
+ // ========================================================================
169
+ offer(element) {
170
+ return this.offerLast(element);
171
+ }
172
+ poll() {
173
+ return this.removeFirst();
174
+ }
175
+ peek() {
176
+ return this.peekFirst();
177
+ }
178
+ peekOrUndefined() {
179
+ return this.peekFirstOrUndefined();
180
+ }
181
+ pollOrUndefined() {
182
+ return this.pollFirst();
183
+ }
184
+ enqueue(element) {
185
+ return this.offer(element);
186
+ }
187
+ dequeue() {
188
+ return this.poll();
189
+ }
190
+ // ========================================================================
191
+ // List operations
192
+ // ========================================================================
193
+ get(index) {
194
+ const node = this.getNode(index);
195
+ return node.value;
196
+ }
197
+ set(index, element) {
198
+ const node = this.getNode(index);
199
+ const old = node.value;
200
+ node.value = element;
201
+ return old;
202
+ }
203
+ insert(index, element) {
204
+ if (index < 0 || index > this._size) {
205
+ throw new RangeError(`Index ${index} out of bounds for size ${this._size}`);
206
+ }
207
+ if (index === 0) {
208
+ this.addFirst(element);
209
+ return;
210
+ }
211
+ if (index === this._size) {
212
+ this.addLast(element);
213
+ return;
214
+ }
215
+ const nextNode = this.getNode(index);
216
+ const prevNode = nextNode.prev;
217
+ const newNode = new Node(element, prevNode, nextNode);
218
+ prevNode.next = newNode;
219
+ nextNode.prev = newNode;
220
+ this._size++;
221
+ }
222
+ insertAll(index, other) {
223
+ if (index < 0 || index > this._size) {
224
+ throw new RangeError(`Index ${index} out of bounds for size ${this._size}`);
225
+ }
226
+ const elements = Array.from(other);
227
+ if (elements.length === 0)
228
+ return false;
229
+ for (let i = 0; i < elements.length; i++) {
230
+ this.insert(index + i, elements[i]);
231
+ }
232
+ return true;
233
+ }
234
+ removeAt(index) {
235
+ const node = this.getNode(index);
236
+ return this.unlinkNode(node);
237
+ }
238
+ removeRange(fromIndex, toIndex) {
239
+ if (fromIndex < 0 || toIndex > this._size || fromIndex > toIndex) {
240
+ throw new RangeError(`Invalid range [${fromIndex}, ${toIndex})`);
241
+ }
242
+ for (let i = fromIndex; i < toIndex; i++) {
243
+ this.removeAt(fromIndex);
244
+ }
245
+ }
246
+ indexOf(element, fromIndex = 0) {
247
+ let index = 0;
248
+ let node = this._head;
249
+ while (node) {
250
+ if (index >= fromIndex && this._eq(node.value, element)) {
251
+ return index;
252
+ }
253
+ node = node.next;
254
+ index++;
255
+ }
256
+ return -1;
257
+ }
258
+ lastIndexOf(element, fromIndex) {
259
+ const start = fromIndex !== undefined ? fromIndex : this._size - 1;
260
+ let index = this._size - 1;
261
+ let node = this._tail;
262
+ while (node && index >= 0) {
263
+ if (index <= start && this._eq(node.value, element)) {
264
+ return index;
265
+ }
266
+ node = node.prev;
267
+ index--;
268
+ }
269
+ return -1;
270
+ }
271
+ first() {
272
+ return this.peekFirst();
273
+ }
274
+ last() {
275
+ return this.peekLast();
276
+ }
277
+ shift() {
278
+ return this.removeFirst();
279
+ }
280
+ unshift(element) {
281
+ this.addFirst(element);
282
+ }
283
+ // ========================================================================
284
+ // Collection operations
285
+ // ========================================================================
286
+ add(element) {
287
+ this.addLast(element);
288
+ return true;
289
+ }
290
+ addAll(other) {
291
+ let modified = false;
292
+ for (const element of other) {
293
+ this.addLast(element);
294
+ modified = true;
295
+ }
296
+ return modified;
297
+ }
298
+ contains(element) {
299
+ return this.indexOf(element) !== -1;
300
+ }
301
+ containsAll(other) {
302
+ for (const element of other) {
303
+ if (!this.contains(element))
304
+ return false;
305
+ }
306
+ return true;
307
+ }
308
+ remove(element) {
309
+ let node = this._head;
310
+ while (node) {
311
+ if (this._eq(node.value, element)) {
312
+ this.unlinkNode(node);
313
+ return true;
314
+ }
315
+ node = node.next;
316
+ }
317
+ return false;
318
+ }
319
+ removeAll(other) {
320
+ const toRemove = new Set(other);
321
+ let modified = false;
322
+ for (const element of toRemove) {
323
+ while (this.remove(element)) {
324
+ modified = true;
325
+ }
326
+ }
327
+ return modified;
328
+ }
329
+ retainAll(other) {
330
+ const toRetain = new Set(other);
331
+ let node = this._head;
332
+ let modified = false;
333
+ while (node) {
334
+ const next = node.next;
335
+ let shouldRetain = false;
336
+ for (const retainElement of toRetain) {
337
+ if (this._eq(node.value, retainElement)) {
338
+ shouldRetain = true;
339
+ break;
340
+ }
341
+ }
342
+ if (!shouldRetain) {
343
+ this.unlinkNode(node);
344
+ modified = true;
345
+ }
346
+ node = next;
347
+ }
348
+ return modified;
349
+ }
350
+ clear() {
351
+ this._head = null;
352
+ this._tail = null;
353
+ this._size = 0;
354
+ }
355
+ // ========================================================================
356
+ // Sorting and reversing
357
+ // ========================================================================
358
+ sort(compare = defaultCompare) {
359
+ if (this._size <= 1)
360
+ return;
361
+ // Convert to array, sort, rebuild list
362
+ const array = this.toArray();
363
+ array.sort(compare);
364
+ this.clear();
365
+ for (const element of array) {
366
+ this.addLast(element);
367
+ }
368
+ }
369
+ reverse() {
370
+ if (this._size <= 1)
371
+ return;
372
+ let node = this._head;
373
+ this._head = this._tail;
374
+ this._tail = node;
375
+ while (node) {
376
+ const next = node.next;
377
+ node.next = node.prev;
378
+ node.prev = next;
379
+ node = next;
380
+ }
381
+ }
382
+ // ========================================================================
383
+ // Views
384
+ // ========================================================================
385
+ subList(fromIndex, toIndex) {
386
+ if (fromIndex < 0 || toIndex > this._size || fromIndex > toIndex) {
387
+ throw new RangeError(`Invalid range [${fromIndex}, ${toIndex})`);
388
+ }
389
+ const sub = new LinkedList({ eq: this._eq });
390
+ let index = 0;
391
+ let node = this._head;
392
+ while (node && index < toIndex) {
393
+ if (index >= fromIndex) {
394
+ sub.addLast(node.value);
395
+ }
396
+ node = node.next;
397
+ index++;
398
+ }
399
+ return sub;
400
+ }
401
+ // ========================================================================
402
+ // Iteration
403
+ // ========================================================================
404
+ *[Symbol.iterator]() {
405
+ let node = this._head;
406
+ while (node) {
407
+ yield node.value;
408
+ node = node.next;
409
+ }
410
+ }
411
+ forEach(action) {
412
+ let index = 0;
413
+ let node = this._head;
414
+ while (node) {
415
+ action(node.value, index);
416
+ node = node.next;
417
+ index++;
418
+ }
419
+ }
420
+ toArray() {
421
+ const result = [];
422
+ let node = this._head;
423
+ while (node) {
424
+ result.push(node.value);
425
+ node = node.next;
426
+ }
427
+ return result;
428
+ }
429
+ // ========================================================================
430
+ // Private helpers
431
+ // ========================================================================
432
+ getNode(index) {
433
+ if (index < 0 || index >= this._size) {
434
+ throw new RangeError(`Index ${index} out of bounds for size ${this._size}`);
435
+ }
436
+ // Optimize: start from head or tail depending on index
437
+ if (index < this._size / 2) {
438
+ // Start from head
439
+ let node = this._head;
440
+ for (let i = 0; i < index; i++) {
441
+ node = node.next;
442
+ }
443
+ return node;
444
+ }
445
+ else {
446
+ // Start from tail
447
+ let node = this._tail;
448
+ for (let i = this._size - 1; i > index; i--) {
449
+ node = node.prev;
450
+ }
451
+ return node;
452
+ }
453
+ }
454
+ unlinkNode(node) {
455
+ const value = node.value;
456
+ if (node.prev) {
457
+ node.prev.next = node.next;
458
+ }
459
+ else {
460
+ this._head = node.next;
461
+ }
462
+ if (node.next) {
463
+ node.next.prev = node.prev;
464
+ }
465
+ else {
466
+ this._tail = node.prev;
467
+ }
468
+ this._size--;
469
+ return value;
470
+ }
471
+ // ========================================================================
472
+ // Inspection
473
+ // ========================================================================
474
+ toString() {
475
+ return `LinkedList[${this.toArray().join(", ")}]`;
476
+ }
477
+ }
478
+ /**
479
+ * Factory function to create a LinkedList.
480
+ *
481
+ * @example
482
+ * const list = linkedList<number>()
483
+ * const listFromArray = linkedList([1, 2, 3])
484
+ */
485
+ export function linkedList(optionsOrElements) {
486
+ // Check if it's an iterable (not options)
487
+ if (optionsOrElements && Symbol.iterator in optionsOrElements) {
488
+ const list = new LinkedList();
489
+ list.addAll(optionsOrElements);
490
+ return list;
491
+ }
492
+ return new LinkedList(optionsOrElements);
493
+ }
494
+ //# sourceMappingURL=linked-list.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"linked-list.js","sourceRoot":"","sources":["../../src/impl/linked-list.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,139 @@
1
+ /**
2
+ * PriorityQueue implementation - A binary heap-based priority queue.
3
+ *
4
+ * Elements are ordered according to their natural ordering (via comparator).
5
+ * The head of the queue is the least element according to the comparator.
6
+ * Provides O(log n) enqueue and O(log n) dequeue operations.
7
+ * Mirrors java.util.PriorityQueue.
8
+ *
9
+ * @example
10
+ * const pq = priorityQueue<number>((a, b) => a - b) // Min heap
11
+ * pq.offer(5)
12
+ * pq.offer(2)
13
+ * pq.offer(8)
14
+ * pq.poll() // 2 (smallest element)
15
+ */
16
+ import type { PriorityQueue as IPriorityQueue } from "../interfaces/queue.js";
17
+ import type { Eq, Compare } from "../core/traits.js";
18
+ /**
19
+ * Options for creating a PriorityQueue.
20
+ */
21
+ export interface PriorityQueueOptions<T> {
22
+ /**
23
+ * Initial capacity of the heap.
24
+ * @default 11
25
+ */
26
+ initialCapacity?: number;
27
+ /**
28
+ * Comparator for ordering elements.
29
+ * Lower values have higher priority (min heap).
30
+ * @default defaultCompare
31
+ */
32
+ compare?: Compare<T>;
33
+ /**
34
+ * Equality function for elements.
35
+ * @default defaultEq
36
+ */
37
+ eq?: Eq<T>;
38
+ }
39
+ /**
40
+ * PriorityQueue<T> - Binary heap implementation of priority queue.
41
+ *
42
+ * Elements are always retrieved in priority order (according to comparator).
43
+ * Not a FIFO queue - order depends on priority, not insertion order.
44
+ *
45
+ * The heap is a min heap by default (smallest element has highest priority).
46
+ * For max heap, use reversed comparator: (a, b) => compare(b, a)
47
+ *
48
+ * Not thread-safe. Use synchronized() behavior for concurrent access.
49
+ */
50
+ export declare class PriorityQueue<T> implements IPriorityQueue<T> {
51
+ private _heap;
52
+ private readonly _compare;
53
+ private readonly _eq;
54
+ constructor(options?: PriorityQueueOptions<T>);
55
+ get size(): number;
56
+ get isEmpty(): boolean;
57
+ get eq(): Eq<T>;
58
+ get compare(): Compare<T>;
59
+ get comparator(): Compare<T>;
60
+ offer(element: T): boolean;
61
+ poll(): T;
62
+ pollOrUndefined(): T | undefined;
63
+ peek(): T;
64
+ peekOrUndefined(): T | undefined;
65
+ enqueue(element: T): boolean;
66
+ dequeue(): T;
67
+ add(element: T): boolean;
68
+ addAll(other: Iterable<T>): boolean;
69
+ contains(element: T): boolean;
70
+ containsAll(other: Iterable<T>): boolean;
71
+ remove(element: T): boolean;
72
+ removeAll(other: Iterable<T>): boolean;
73
+ retainAll(other: Iterable<T>): boolean;
74
+ clear(): void;
75
+ /**
76
+ * Iterator returns elements in arbitrary order (not priority order).
77
+ * To get elements in priority order, repeatedly call poll().
78
+ */
79
+ [Symbol.iterator](): Iterator<T>;
80
+ forEach(action: (element: T, index: number) => void): void;
81
+ /**
82
+ * Returns elements in arbitrary heap order (not sorted).
83
+ */
84
+ toArray(): T[];
85
+ /**
86
+ * Returns elements in priority order (sorted).
87
+ * This is a destructive operation that drains the queue.
88
+ */
89
+ toSortedArray(): T[];
90
+ /**
91
+ * Bubbles an element up the heap to maintain heap property.
92
+ */
93
+ private bubbleUp;
94
+ /**
95
+ * Bubbles an element down the heap to maintain heap property.
96
+ *
97
+ * The element moves down through a hole: a smaller child moves up into the hole, and the
98
+ * element goes into the last hole. The children are compared with the element. (Before, they
99
+ * were compared with `_heap[index]`, which after the first step is a copy of the child that
100
+ * moved up: a poll could leave a larger element above a smaller one.)
101
+ */
102
+ private bubbleDown;
103
+ /**
104
+ * Rebuilds the heap from an arbitrary array.
105
+ * Uses Floyd's algorithm (O(n) time).
106
+ */
107
+ private heapify;
108
+ /**
109
+ * Creates a shallow copy of this priority queue.
110
+ */
111
+ clone(): PriorityQueue<T>;
112
+ /**
113
+ * Validates the heap property (for debugging).
114
+ * Returns true if the heap is valid.
115
+ */
116
+ validate(): boolean;
117
+ /**
118
+ * Returns a string representation for debugging.
119
+ */
120
+ toString(): string;
121
+ }
122
+ /**
123
+ * Factory function to create a PriorityQueue.
124
+ *
125
+ * @example
126
+ * // Min heap (default)
127
+ * const minHeap = priorityQueue<number>()
128
+ *
129
+ * // Max heap
130
+ * const maxHeap = priorityQueue<number>((a, b) => b - a)
131
+ *
132
+ * // From array
133
+ * const pq = priorityQueue([5, 2, 8, 1, 9])
134
+ *
135
+ * // With custom comparator
136
+ * const pq = priorityQueue<Task>((a, b) => a.priority - b.priority)
137
+ */
138
+ export declare function priorityQueue<T>(optionsOrElementsOrComparator?: PriorityQueueOptions<T> | Iterable<T> | Compare<T>): PriorityQueue<T>;
139
+ //# sourceMappingURL=priority-queue.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"priority-queue.d.ts","sourceRoot":"","sources":["../../src/impl/priority-queue.ts"],"names":[],"mappings":"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"}