@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.
- package/CHANGELOG.md +5 -0
- package/LICENSE +21 -0
- package/README.md +394 -2
- package/dist/.tsbuildinfo +1 -0
- package/dist/async/async-queue.d.ts +155 -0
- package/dist/async/async-queue.d.ts.map +1 -0
- package/dist/async/async-queue.js +342 -0
- package/dist/async/async-queue.js.map +1 -0
- package/dist/async/channels.d.ts +188 -0
- package/dist/async/channels.d.ts.map +1 -0
- package/dist/async/channels.js +314 -0
- package/dist/async/channels.js.map +1 -0
- package/dist/behaviors/bounded.d.ts +79 -0
- package/dist/behaviors/bounded.d.ts.map +1 -0
- package/dist/behaviors/bounded.js +384 -0
- package/dist/behaviors/bounded.js.map +1 -0
- package/dist/behaviors/composite.d.ts +17 -0
- package/dist/behaviors/composite.d.ts.map +1 -0
- package/dist/behaviors/composite.js +93 -0
- package/dist/behaviors/composite.js.map +1 -0
- package/dist/behaviors/evented.d.ts +154 -0
- package/dist/behaviors/evented.d.ts.map +1 -0
- package/dist/behaviors/evented.js +299 -0
- package/dist/behaviors/evented.js.map +1 -0
- package/dist/behaviors/lru.d.ts +84 -0
- package/dist/behaviors/lru.d.ts.map +1 -0
- package/dist/behaviors/lru.js +376 -0
- package/dist/behaviors/lru.js.map +1 -0
- package/dist/behaviors/readonly.d.ts +73 -0
- package/dist/behaviors/readonly.d.ts.map +1 -0
- package/dist/behaviors/readonly.js +177 -0
- package/dist/behaviors/readonly.js.map +1 -0
- package/dist/behaviors/safe.d.ts +163 -0
- package/dist/behaviors/safe.d.ts.map +1 -0
- package/dist/behaviors/safe.js +176 -0
- package/dist/behaviors/safe.js.map +1 -0
- package/dist/behaviors/synchronized.d.ts +88 -0
- package/dist/behaviors/synchronized.d.ts.map +1 -0
- package/dist/behaviors/synchronized.js +285 -0
- package/dist/behaviors/synchronized.js.map +1 -0
- package/dist/behaviors/ttl.d.ts +118 -0
- package/dist/behaviors/ttl.d.ts.map +1 -0
- package/dist/behaviors/ttl.js +354 -0
- package/dist/behaviors/ttl.js.map +1 -0
- package/dist/contracts/model.d.ts +29 -0
- package/dist/contracts/model.d.ts.map +1 -0
- package/dist/contracts/model.js +26 -0
- package/dist/contracts/model.js.map +1 -0
- package/dist/core/effects.d.ts +176 -0
- package/dist/core/effects.d.ts.map +1 -0
- package/dist/core/effects.js +180 -0
- package/dist/core/effects.js.map +1 -0
- package/dist/core/events.d.ts +192 -0
- package/dist/core/events.d.ts.map +1 -0
- package/dist/core/events.js +291 -0
- package/dist/core/events.js.map +1 -0
- package/dist/core/middleware.d.ts +231 -0
- package/dist/core/middleware.d.ts.map +1 -0
- package/dist/core/middleware.js +161 -0
- package/dist/core/middleware.js.map +1 -0
- package/dist/core/policies.d.ts +220 -0
- package/dist/core/policies.d.ts.map +1 -0
- package/dist/core/policies.js +48 -0
- package/dist/core/policies.js.map +1 -0
- package/dist/core/traits.d.ts +142 -0
- package/dist/core/traits.d.ts.map +1 -0
- package/dist/core/traits.js +8 -0
- package/dist/core/traits.js.map +1 -0
- package/dist/fx/collectors.d.ts +193 -0
- package/dist/fx/collectors.d.ts.map +1 -0
- package/dist/fx/collectors.js +375 -0
- package/dist/fx/collectors.js.map +1 -0
- package/dist/fx/iter.d.ts +166 -0
- package/dist/fx/iter.d.ts.map +1 -0
- package/dist/fx/iter.js +421 -0
- package/dist/fx/iter.js.map +1 -0
- package/dist/impl/array-deque.d.ts +112 -0
- package/dist/impl/array-deque.d.ts.map +1 -0
- package/dist/impl/array-deque.js +380 -0
- package/dist/impl/array-deque.js.map +1 -0
- package/dist/impl/array-list.d.ts +101 -0
- package/dist/impl/array-list.d.ts.map +1 -0
- package/dist/impl/array-list.js +387 -0
- package/dist/impl/array-list.js.map +1 -0
- package/dist/impl/hash-map.d.ts +149 -0
- package/dist/impl/hash-map.d.ts.map +1 -0
- package/dist/impl/hash-map.js +473 -0
- package/dist/impl/hash-map.js.map +1 -0
- package/dist/impl/hash-set.d.ts +125 -0
- package/dist/impl/hash-set.d.ts.map +1 -0
- package/dist/impl/hash-set.js +264 -0
- package/dist/impl/hash-set.js.map +1 -0
- package/dist/impl/linked-hash-map.d.ts +141 -0
- package/dist/impl/linked-hash-map.d.ts.map +1 -0
- package/dist/impl/linked-hash-map.js +442 -0
- package/dist/impl/linked-hash-map.js.map +1 -0
- package/dist/impl/linked-list.d.ts +109 -0
- package/dist/impl/linked-list.d.ts.map +1 -0
- package/dist/impl/linked-list.js +494 -0
- package/dist/impl/linked-list.js.map +1 -0
- package/dist/impl/priority-queue.d.ts +139 -0
- package/dist/impl/priority-queue.d.ts.map +1 -0
- package/dist/impl/priority-queue.js +343 -0
- package/dist/impl/priority-queue.js.map +1 -0
- package/dist/impl/tree-map.d.ts +153 -0
- package/dist/impl/tree-map.d.ts.map +1 -0
- package/dist/impl/tree-map.js +788 -0
- package/dist/impl/tree-map.js.map +1 -0
- package/dist/impl/tree-set.d.ts +112 -0
- package/dist/impl/tree-set.d.ts.map +1 -0
- package/dist/impl/tree-set.js +374 -0
- package/dist/impl/tree-set.js.map +1 -0
- package/dist/index.d.ts +106 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +139 -0
- package/dist/index.js.map +1 -0
- package/dist/interfaces/collection.d.ts +119 -0
- package/dist/interfaces/collection.d.ts.map +1 -0
- package/dist/interfaces/collection.js +8 -0
- package/dist/interfaces/collection.js.map +1 -0
- package/dist/interfaces/list.d.ts +247 -0
- package/dist/interfaces/list.d.ts.map +1 -0
- package/dist/interfaces/list.js +8 -0
- package/dist/interfaces/list.js.map +1 -0
- package/dist/interfaces/map.d.ts +344 -0
- package/dist/interfaces/map.d.ts.map +1 -0
- package/dist/interfaces/map.js +8 -0
- package/dist/interfaces/map.js.map +1 -0
- package/dist/interfaces/queue.d.ts +304 -0
- package/dist/interfaces/queue.d.ts.map +1 -0
- package/dist/interfaces/queue.js +8 -0
- package/dist/interfaces/queue.js.map +1 -0
- package/dist/interfaces/set.d.ts +137 -0
- package/dist/interfaces/set.d.ts.map +1 -0
- package/dist/interfaces/set.js +8 -0
- package/dist/interfaces/set.js.map +1 -0
- package/dist/register.d.ts +8 -0
- package/dist/register.d.ts.map +1 -0
- package/dist/register.js +8 -0
- package/dist/register.js.map +1 -0
- package/dist/storage/index.d.ts +15 -0
- package/dist/storage/index.d.ts.map +1 -0
- package/dist/storage/index.js +14 -0
- package/dist/storage/index.js.map +1 -0
- package/dist/storage/interface.d.ts +141 -0
- package/dist/storage/interface.d.ts.map +1 -0
- package/dist/storage/interface.js +23 -0
- package/dist/storage/interface.js.map +1 -0
- package/dist/storage/memory.d.ts +68 -0
- package/dist/storage/memory.d.ts.map +1 -0
- package/dist/storage/memory.js +154 -0
- package/dist/storage/memory.js.map +1 -0
- package/dist/utils/defaults.d.ts +135 -0
- package/dist/utils/defaults.d.ts.map +1 -0
- package/dist/utils/defaults.js +322 -0
- package/dist/utils/defaults.js.map +1 -0
- package/dist/utils/factories.d.ts +144 -0
- package/dist/utils/factories.d.ts.map +1 -0
- package/dist/utils/factories.js +293 -0
- package/dist/utils/factories.js.map +1 -0
- package/dist/utils/helpers.d.ts +137 -0
- package/dist/utils/helpers.d.ts.map +1 -0
- package/dist/utils/helpers.js +221 -0
- package/dist/utils/helpers.js.map +1 -0
- package/package.json +68 -3
- package/src/async/async-queue.ts +417 -0
- package/src/async/channels.ts +374 -0
- package/src/behaviors/bounded.ts +477 -0
- package/src/behaviors/composite.ts +99 -0
- package/src/behaviors/evented.ts +464 -0
- package/src/behaviors/lru.ts +447 -0
- package/src/behaviors/readonly.ts +224 -0
- package/src/behaviors/safe.ts +372 -0
- package/src/behaviors/synchronized.ts +316 -0
- package/src/behaviors/ttl.ts +462 -0
- package/src/contracts/model.ts +44 -0
- package/src/core/effects.ts +323 -0
- package/src/core/events.ts +356 -0
- package/src/core/middleware.ts +415 -0
- package/src/core/policies.ts +316 -0
- package/src/core/traits.ts +164 -0
- package/src/fx/collectors.ts +500 -0
- package/src/fx/iter.ts +536 -0
- package/src/impl/array-deque.ts +463 -0
- package/src/impl/array-list.ts +490 -0
- package/src/impl/hash-map.ts +623 -0
- package/src/impl/hash-set.ts +342 -0
- package/src/impl/linked-hash-map.ts +572 -0
- package/src/impl/linked-list.ts +606 -0
- package/src/impl/priority-queue.ts +448 -0
- package/src/impl/tree-map.ts +912 -0
- package/src/impl/tree-set.ts +469 -0
- package/src/index.ts +277 -0
- package/src/interfaces/collection.ts +141 -0
- package/src/interfaces/list.ts +281 -0
- package/src/interfaces/map.ts +405 -0
- package/src/interfaces/queue.ts +353 -0
- package/src/interfaces/set.ts +158 -0
- package/src/register.ts +8 -0
- package/src/storage/index.ts +16 -0
- package/src/storage/interface.ts +179 -0
- package/src/storage/memory.ts +180 -0
- package/src/utils/defaults.ts +345 -0
- package/src/utils/factories.ts +357 -0
- package/src/utils/helpers.ts +248 -0
|
@@ -0,0 +1,387 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ArrayList implementation - A dynamic array-backed list.
|
|
3
|
+
*
|
|
4
|
+
* Provides O(1) indexed access and amortized O(1) append.
|
|
5
|
+
* Mirrors java.util.ArrayList.
|
|
6
|
+
*
|
|
7
|
+
* @example
|
|
8
|
+
* const list = arrayList<number>()
|
|
9
|
+
* list.add(1)
|
|
10
|
+
* list.add(2)
|
|
11
|
+
* list.add(3)
|
|
12
|
+
* console.log(list.get(1)) // 2
|
|
13
|
+
*/
|
|
14
|
+
import { defaultEq, defaultCompare } from "../utils/defaults.js";
|
|
15
|
+
/**
|
|
16
|
+
* ArrayList<T> - Resizable array implementation of the List interface.
|
|
17
|
+
*
|
|
18
|
+
* Provides fast random access (O(1)) and fast append (amortized O(1)).
|
|
19
|
+
* Insertion and removal in the middle require shifting elements (O(n)).
|
|
20
|
+
*
|
|
21
|
+
* This is the most commonly used list implementation.
|
|
22
|
+
*/
|
|
23
|
+
export class ArrayList {
|
|
24
|
+
_array;
|
|
25
|
+
_size;
|
|
26
|
+
_eq;
|
|
27
|
+
supportsRandomAccess = true;
|
|
28
|
+
constructor(options = {}) {
|
|
29
|
+
const { initialCapacity = 10, eq = defaultEq } = options;
|
|
30
|
+
this._array = new Array(initialCapacity);
|
|
31
|
+
this._size = 0;
|
|
32
|
+
this._eq = eq;
|
|
33
|
+
}
|
|
34
|
+
// ========================================================================
|
|
35
|
+
// Size and capacity
|
|
36
|
+
// ========================================================================
|
|
37
|
+
get size() {
|
|
38
|
+
return this._size;
|
|
39
|
+
}
|
|
40
|
+
get isEmpty() {
|
|
41
|
+
return this._size === 0;
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Current capacity of the underlying array.
|
|
45
|
+
*/
|
|
46
|
+
get capacity() {
|
|
47
|
+
return this._array.length;
|
|
48
|
+
}
|
|
49
|
+
get eq() {
|
|
50
|
+
return this._eq;
|
|
51
|
+
}
|
|
52
|
+
// ========================================================================
|
|
53
|
+
// Indexed access
|
|
54
|
+
// ========================================================================
|
|
55
|
+
get(index) {
|
|
56
|
+
this.checkIndex(index);
|
|
57
|
+
return this._array[index];
|
|
58
|
+
}
|
|
59
|
+
set(index, element) {
|
|
60
|
+
this.checkIndex(index);
|
|
61
|
+
const old = this._array[index];
|
|
62
|
+
this._array[index] = element;
|
|
63
|
+
return old;
|
|
64
|
+
}
|
|
65
|
+
// ========================================================================
|
|
66
|
+
// Search
|
|
67
|
+
// ========================================================================
|
|
68
|
+
contains(element) {
|
|
69
|
+
return this.indexOf(element) !== -1;
|
|
70
|
+
}
|
|
71
|
+
indexOf(element, fromIndex = 0) {
|
|
72
|
+
if (fromIndex < 0)
|
|
73
|
+
fromIndex = 0;
|
|
74
|
+
for (let i = fromIndex; i < this._size; i++) {
|
|
75
|
+
if (this._eq(this._array[i], element)) {
|
|
76
|
+
return i;
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
return -1;
|
|
80
|
+
}
|
|
81
|
+
lastIndexOf(element, fromIndex) {
|
|
82
|
+
const start = fromIndex !== undefined
|
|
83
|
+
? Math.min(fromIndex, this._size - 1)
|
|
84
|
+
: this._size - 1;
|
|
85
|
+
for (let i = start; i >= 0; i--) {
|
|
86
|
+
if (this._eq(this._array[i], element)) {
|
|
87
|
+
return i;
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
return -1;
|
|
91
|
+
}
|
|
92
|
+
containsAll(other) {
|
|
93
|
+
for (const element of other) {
|
|
94
|
+
if (!this.contains(element))
|
|
95
|
+
return false;
|
|
96
|
+
}
|
|
97
|
+
return true;
|
|
98
|
+
}
|
|
99
|
+
// ========================================================================
|
|
100
|
+
// Addition
|
|
101
|
+
// ========================================================================
|
|
102
|
+
add(element) {
|
|
103
|
+
this.ensureCapacity(this._size + 1);
|
|
104
|
+
this._array[this._size++] = element;
|
|
105
|
+
return true;
|
|
106
|
+
}
|
|
107
|
+
push(element) {
|
|
108
|
+
this.add(element);
|
|
109
|
+
}
|
|
110
|
+
unshift(element) {
|
|
111
|
+
this.insert(0, element);
|
|
112
|
+
}
|
|
113
|
+
insert(index, element) {
|
|
114
|
+
this.checkInsertIndex(index);
|
|
115
|
+
this.ensureCapacity(this._size + 1);
|
|
116
|
+
// Shift elements to the right
|
|
117
|
+
for (let i = this._size; i > index; i--) {
|
|
118
|
+
this._array[i] = this._array[i - 1];
|
|
119
|
+
}
|
|
120
|
+
this._array[index] = element;
|
|
121
|
+
this._size++;
|
|
122
|
+
}
|
|
123
|
+
insertAll(index, other) {
|
|
124
|
+
this.checkInsertIndex(index);
|
|
125
|
+
const elements = Array.isArray(other) ? other : Array.from(other);
|
|
126
|
+
if (elements.length === 0)
|
|
127
|
+
return false;
|
|
128
|
+
this.ensureCapacity(this._size + elements.length);
|
|
129
|
+
// Shift existing elements to the right
|
|
130
|
+
for (let i = this._size - 1; i >= index; i--) {
|
|
131
|
+
this._array[i + elements.length] = this._array[i];
|
|
132
|
+
}
|
|
133
|
+
// Insert new elements
|
|
134
|
+
for (let i = 0; i < elements.length; i++) {
|
|
135
|
+
this._array[index + i] = elements[i];
|
|
136
|
+
}
|
|
137
|
+
this._size += elements.length;
|
|
138
|
+
return true;
|
|
139
|
+
}
|
|
140
|
+
addAll(other) {
|
|
141
|
+
const elements = Array.isArray(other) ? other : Array.from(other);
|
|
142
|
+
if (elements.length === 0)
|
|
143
|
+
return false;
|
|
144
|
+
this.ensureCapacity(this._size + elements.length);
|
|
145
|
+
for (const element of elements) {
|
|
146
|
+
this._array[this._size++] = element;
|
|
147
|
+
}
|
|
148
|
+
return true;
|
|
149
|
+
}
|
|
150
|
+
// ========================================================================
|
|
151
|
+
// Removal
|
|
152
|
+
// ========================================================================
|
|
153
|
+
remove(element) {
|
|
154
|
+
const index = this.indexOf(element);
|
|
155
|
+
if (index === -1)
|
|
156
|
+
return false;
|
|
157
|
+
this.removeAt(index);
|
|
158
|
+
return true;
|
|
159
|
+
}
|
|
160
|
+
removeAt(index) {
|
|
161
|
+
this.checkIndex(index);
|
|
162
|
+
const old = this._array[index];
|
|
163
|
+
// Shift elements to the left
|
|
164
|
+
for (let i = index; i < this._size - 1; i++) {
|
|
165
|
+
this._array[i] = this._array[i + 1];
|
|
166
|
+
}
|
|
167
|
+
this._size--;
|
|
168
|
+
// Clear the last element to allow GC
|
|
169
|
+
this._array[this._size] = undefined;
|
|
170
|
+
return old;
|
|
171
|
+
}
|
|
172
|
+
pop() {
|
|
173
|
+
if (this.isEmpty) {
|
|
174
|
+
throw new Error("Cannot pop from empty list");
|
|
175
|
+
}
|
|
176
|
+
return this.removeAt(this._size - 1);
|
|
177
|
+
}
|
|
178
|
+
shift() {
|
|
179
|
+
if (this.isEmpty) {
|
|
180
|
+
throw new Error("Cannot shift from empty list");
|
|
181
|
+
}
|
|
182
|
+
return this.removeAt(0);
|
|
183
|
+
}
|
|
184
|
+
removeRange(fromIndex, toIndex) {
|
|
185
|
+
this.checkRange(fromIndex, toIndex);
|
|
186
|
+
const numToRemove = toIndex - fromIndex;
|
|
187
|
+
if (numToRemove === 0)
|
|
188
|
+
return;
|
|
189
|
+
// Shift elements to the left
|
|
190
|
+
for (let i = toIndex; i < this._size; i++) {
|
|
191
|
+
this._array[i - numToRemove] = this._array[i];
|
|
192
|
+
}
|
|
193
|
+
// Clear removed elements
|
|
194
|
+
for (let i = this._size - numToRemove; i < this._size; i++) {
|
|
195
|
+
this._array[i] = undefined;
|
|
196
|
+
}
|
|
197
|
+
this._size -= numToRemove;
|
|
198
|
+
}
|
|
199
|
+
removeAll(other) {
|
|
200
|
+
const toRemove = new Set();
|
|
201
|
+
for (const element of other) {
|
|
202
|
+
toRemove.add(element);
|
|
203
|
+
}
|
|
204
|
+
let writeIndex = 0;
|
|
205
|
+
let modified = false;
|
|
206
|
+
for (let readIndex = 0; readIndex < this._size; readIndex++) {
|
|
207
|
+
const element = this._array[readIndex];
|
|
208
|
+
let shouldRemove = false;
|
|
209
|
+
// Check if element matches any in toRemove using custom equality
|
|
210
|
+
for (const removeElement of toRemove) {
|
|
211
|
+
if (this._eq(element, removeElement)) {
|
|
212
|
+
shouldRemove = true;
|
|
213
|
+
modified = true;
|
|
214
|
+
break;
|
|
215
|
+
}
|
|
216
|
+
}
|
|
217
|
+
if (!shouldRemove) {
|
|
218
|
+
this._array[writeIndex++] = element;
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
// Clear remaining elements
|
|
222
|
+
for (let i = writeIndex; i < this._size; i++) {
|
|
223
|
+
this._array[i] = undefined;
|
|
224
|
+
}
|
|
225
|
+
this._size = writeIndex;
|
|
226
|
+
return modified;
|
|
227
|
+
}
|
|
228
|
+
retainAll(other) {
|
|
229
|
+
const toRetain = Array.from(other);
|
|
230
|
+
let writeIndex = 0;
|
|
231
|
+
let modified = false;
|
|
232
|
+
for (let readIndex = 0; readIndex < this._size; readIndex++) {
|
|
233
|
+
const element = this._array[readIndex];
|
|
234
|
+
let shouldRetain = false;
|
|
235
|
+
// Check if element matches any in toRetain using custom equality
|
|
236
|
+
for (const retainElement of toRetain) {
|
|
237
|
+
if (this._eq(element, retainElement)) {
|
|
238
|
+
shouldRetain = true;
|
|
239
|
+
break;
|
|
240
|
+
}
|
|
241
|
+
}
|
|
242
|
+
if (shouldRetain) {
|
|
243
|
+
this._array[writeIndex++] = element;
|
|
244
|
+
}
|
|
245
|
+
else {
|
|
246
|
+
modified = true;
|
|
247
|
+
}
|
|
248
|
+
}
|
|
249
|
+
// Clear remaining elements
|
|
250
|
+
for (let i = writeIndex; i < this._size; i++) {
|
|
251
|
+
this._array[i] = undefined;
|
|
252
|
+
}
|
|
253
|
+
this._size = writeIndex;
|
|
254
|
+
return modified;
|
|
255
|
+
}
|
|
256
|
+
clear() {
|
|
257
|
+
// Clear all elements to allow GC
|
|
258
|
+
for (let i = 0; i < this._size; i++) {
|
|
259
|
+
this._array[i] = undefined;
|
|
260
|
+
}
|
|
261
|
+
this._size = 0;
|
|
262
|
+
}
|
|
263
|
+
// ========================================================================
|
|
264
|
+
// Ordering
|
|
265
|
+
// ========================================================================
|
|
266
|
+
sort(compare = defaultCompare) {
|
|
267
|
+
// Sort only the used portion of the array
|
|
268
|
+
const slice = this._array.slice(0, this._size);
|
|
269
|
+
slice.sort(compare);
|
|
270
|
+
for (let i = 0; i < this._size; i++) {
|
|
271
|
+
this._array[i] = slice[i];
|
|
272
|
+
}
|
|
273
|
+
}
|
|
274
|
+
reverse() {
|
|
275
|
+
let left = 0;
|
|
276
|
+
let right = this._size - 1;
|
|
277
|
+
while (left < right) {
|
|
278
|
+
const temp = this._array[left];
|
|
279
|
+
this._array[left] = this._array[right];
|
|
280
|
+
this._array[right] = temp;
|
|
281
|
+
left++;
|
|
282
|
+
right--;
|
|
283
|
+
}
|
|
284
|
+
}
|
|
285
|
+
// ========================================================================
|
|
286
|
+
// Views
|
|
287
|
+
// ========================================================================
|
|
288
|
+
first() {
|
|
289
|
+
if (this.isEmpty) {
|
|
290
|
+
throw new Error("List is empty");
|
|
291
|
+
}
|
|
292
|
+
return this._array[0];
|
|
293
|
+
}
|
|
294
|
+
last() {
|
|
295
|
+
if (this.isEmpty) {
|
|
296
|
+
throw new Error("List is empty");
|
|
297
|
+
}
|
|
298
|
+
return this._array[this._size - 1];
|
|
299
|
+
}
|
|
300
|
+
subList(fromIndex, toIndex) {
|
|
301
|
+
this.checkRange(fromIndex, toIndex);
|
|
302
|
+
// For now, return a copy. Later we can implement a view.
|
|
303
|
+
const sub = new ArrayList({ eq: this._eq });
|
|
304
|
+
for (let i = fromIndex; i < toIndex; i++) {
|
|
305
|
+
sub.add(this._array[i]);
|
|
306
|
+
}
|
|
307
|
+
return sub;
|
|
308
|
+
}
|
|
309
|
+
// ========================================================================
|
|
310
|
+
// Iteration
|
|
311
|
+
// ========================================================================
|
|
312
|
+
*[Symbol.iterator]() {
|
|
313
|
+
for (let i = 0; i < this._size; i++) {
|
|
314
|
+
yield this._array[i];
|
|
315
|
+
}
|
|
316
|
+
}
|
|
317
|
+
forEach(action) {
|
|
318
|
+
for (let i = 0; i < this._size; i++) {
|
|
319
|
+
action(this._array[i], i);
|
|
320
|
+
}
|
|
321
|
+
}
|
|
322
|
+
toArray() {
|
|
323
|
+
return this._array.slice(0, this._size);
|
|
324
|
+
}
|
|
325
|
+
// ========================================================================
|
|
326
|
+
// Capacity management
|
|
327
|
+
// ========================================================================
|
|
328
|
+
/**
|
|
329
|
+
* Ensures that the capacity is at least the specified minimum.
|
|
330
|
+
*/
|
|
331
|
+
ensureCapacity(minCapacity) {
|
|
332
|
+
if (minCapacity <= this._array.length)
|
|
333
|
+
return;
|
|
334
|
+
// Grow by 1.5x or to minCapacity, whichever is larger
|
|
335
|
+
const newCapacity = Math.max(minCapacity, Math.floor(this._array.length * 1.5) + 1);
|
|
336
|
+
const newArray = new Array(newCapacity);
|
|
337
|
+
for (let i = 0; i < this._size; i++) {
|
|
338
|
+
newArray[i] = this._array[i];
|
|
339
|
+
}
|
|
340
|
+
this._array = newArray;
|
|
341
|
+
}
|
|
342
|
+
/**
|
|
343
|
+
* Trims the capacity to the current size to minimize memory usage.
|
|
344
|
+
*/
|
|
345
|
+
trimToSize() {
|
|
346
|
+
if (this._size < this._array.length) {
|
|
347
|
+
this._array = this._array.slice(0, this._size);
|
|
348
|
+
}
|
|
349
|
+
}
|
|
350
|
+
// ========================================================================
|
|
351
|
+
// Private helpers
|
|
352
|
+
// ========================================================================
|
|
353
|
+
checkIndex(index) {
|
|
354
|
+
if (index < 0 || index >= this._size) {
|
|
355
|
+
throw new RangeError(`Index ${index} out of bounds for size ${this._size}`);
|
|
356
|
+
}
|
|
357
|
+
}
|
|
358
|
+
checkInsertIndex(index) {
|
|
359
|
+
if (index < 0 || index > this._size) {
|
|
360
|
+
throw new RangeError(`Index ${index} out of bounds for insert (size ${this._size})`);
|
|
361
|
+
}
|
|
362
|
+
}
|
|
363
|
+
checkRange(fromIndex, toIndex) {
|
|
364
|
+
if (fromIndex < 0 || toIndex > this._size || fromIndex > toIndex) {
|
|
365
|
+
throw new RangeError(`Invalid range [${fromIndex}, ${toIndex}) for size ${this._size}`);
|
|
366
|
+
}
|
|
367
|
+
}
|
|
368
|
+
}
|
|
369
|
+
/**
|
|
370
|
+
* Factory function to create an ArrayList.
|
|
371
|
+
*
|
|
372
|
+
* @example
|
|
373
|
+
* const list = arrayList<number>()
|
|
374
|
+
* const listWithEq = arrayList<User>({ eq: (a, b) => a.id === b.id })
|
|
375
|
+
* const listFromArray = arrayList([1, 2, 3])
|
|
376
|
+
*/
|
|
377
|
+
export function arrayList(optionsOrElements) {
|
|
378
|
+
// Check if it's an iterable (not options)
|
|
379
|
+
if (optionsOrElements && Symbol.iterator in optionsOrElements) {
|
|
380
|
+
const list = new ArrayList();
|
|
381
|
+
list.addAll(optionsOrElements);
|
|
382
|
+
return list;
|
|
383
|
+
}
|
|
384
|
+
const list = new ArrayList(optionsOrElements);
|
|
385
|
+
return list;
|
|
386
|
+
}
|
|
387
|
+
//# sourceMappingURL=array-list.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"array-list.js","sourceRoot":"","sources":["../../src/impl/array-list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAmBjE;;;;;;;GAOG;AACH,MAAM,OAAO,SAAS;IACZ,MAAM,CAAM;IACZ,KAAK,CAAS;IACL,GAAG,CAAQ;IAEnB,oBAAoB,GAAG,IAAa,CAAC;IAE9C,YAAY,OAAO,GAAwB,EAAE;QAC3C,MAAM,EAAE,eAAe,GAAG,EAAE,EAAE,EAAE,GAAG,SAAS,EAAE,GAAG,OAAO,CAAC;QACzD,IAAI,CAAC,MAAM,GAAG,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QACf,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,2EAA2E;IAC3E,oBAAoB;IACpB,2EAA2E;IAE3E,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,2EAA2E;IAC3E,iBAAiB;IACjB,2EAA2E;IAE3E,GAAG,CAAC,KAAa;QACf,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAE,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,KAAa,EAAE,OAAU;QAC3B,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAE,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;QAC7B,OAAO,GAAI,CAAC;IACd,CAAC;IAED,2EAA2E;IAC3E,SAAS;IACT,2EAA2E;IAE3E,QAAQ,CAAC,OAAU;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,OAAU,EAAE,SAAS,GAAW,CAAC;QACvC,IAAI,SAAS,GAAG,CAAC;YAAE,SAAS,GAAG,CAAC,CAAC;QACjC,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,EAAE,OAAO,CAAC,EAAE,CAAC;gBACvC,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IAED,WAAW,CAAC,OAAU,EAAE,SAAkB;QACxC,MAAM,KAAK,GACT,SAAS,KAAK,SAAS;YACrB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;YACrC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,EAAE,OAAO,CAAC,EAAE,CAAC;gBACvC,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IAED,WAAW,CAAC,KAAkB;QAC5B,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,OAAO,KAAK,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2EAA2E;IAC3E,WAAW;IACX,2EAA2E;IAE3E,GAAG,CAAC,OAAU;QACZ,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,OAAU;QACb,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,CAAC,OAAU;QAChB,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,OAAU;QAC9B,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAEpC,8BAA8B;QAC9B,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACvC,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;QAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,SAAS,CAAC,KAAa,EAAE,KAAkB;QACzC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAExC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAElD,uCAAuC;QACvC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;QACrD,CAAC;QAED,sBAAsB;QACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,KAAkB;QACvB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAExC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAElD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;QACtC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2EAA2E;IAC3E,UAAU;IACV,2EAA2E;IAE3E,MAAM,CAAC,OAAU;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAE,CAAC;QAEhC,6BAA6B;QAC7B,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACvC,CAAC;QAED,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,qCAAqC;QACrC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,SAAgB,CAAC;QAE3C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,GAAG;QACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED,WAAW,CAAC,SAAiB,EAAE,OAAe;QAC5C,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACpC,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;QACxC,IAAI,WAAW,KAAK,CAAC;YAAE,OAAO;QAE9B,6BAA6B;QAC7B,KAAK,IAAI,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;QACjD,CAAC;QAED,yBAAyB;QACzB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3D,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAgB,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC;IAC5B,CAAC;IAED,SAAS,CAAC,KAAkB;QAC1B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAK,CAAC;QAC9B,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;YAC5B,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAED,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC;YAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAE,CAAC;YACxC,IAAI,YAAY,GAAG,KAAK,CAAC;YAEzB,iEAAiE;YACjE,KAAK,MAAM,aAAa,IAAI,QAAQ,EAAE,CAAC;gBACrC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,CAAC;oBACrC,YAAY,GAAG,IAAI,CAAC;oBACpB,QAAQ,GAAG,IAAI,CAAC;oBAChB,MAAM;gBACR,CAAC;YACH,CAAC;YAED,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,GAAG,OAAO,CAAC;YACtC,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAgB,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC;QACxB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,SAAS,CAAC,KAAkB;QAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC;YAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAE,CAAC;YACxC,IAAI,YAAY,GAAG,KAAK,CAAC;YAEzB,iEAAiE;YACjE,KAAK,MAAM,aAAa,IAAI,QAAQ,EAAE,CAAC;gBACrC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,CAAC;oBACrC,YAAY,GAAG,IAAI,CAAC;oBACpB,MAAM;gBACR,CAAC;YACH,CAAC;YAED,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,GAAG,OAAO,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAgB,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC;QACxB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK;QACH,iCAAiC;QACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAgB,CAAC;QACpC,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,2EAA2E;IAC3E,WAAW;IACX,2EAA2E;IAE3E,IAAI,CAAC,OAAO,GAAe,cAAc;QACvC,0CAA0C;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QAC3B,OAAO,IAAI,GAAG,KAAK,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAE,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAE,CAAC;YACxC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YAC1B,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC;IAED,2EAA2E;IAC3E,QAAQ;IACR,2EAA2E;IAE3E,KAAK;QACH,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;IACzB,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,SAAiB,EAAE,OAAe;QACxC,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACpC,yDAAyD;QACzD,MAAM,GAAG,GAAG,IAAI,SAAS,CAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/C,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,2EAA2E;IAC3E,YAAY;IACZ,2EAA2E;IAE3E,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,MAA2C;QACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,2EAA2E;IAC3E,sBAAsB;IACtB,2EAA2E;IAE3E;;OAEG;IACH,cAAc,CAAC,WAAmB;QAChC,IAAI,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO;QAE9C,sDAAsD;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAC1B,WAAW,EACX,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CACzC,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;QACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,2EAA2E;IAC3E,kBAAkB;IAClB,2EAA2E;IAEnE,UAAU,CAAC,KAAa;QAC9B,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACrC,MAAM,IAAI,UAAU,CAClB,SAAS,KAAK,2BAA2B,IAAI,CAAC,KAAK,EAAE,CACtD,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,KAAa;QACpC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACpC,MAAM,IAAI,UAAU,CAClB,SAAS,KAAK,mCAAmC,IAAI,CAAC,KAAK,GAAG,CAC/D,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,SAAiB,EAAE,OAAe;QACnD,IAAI,SAAS,GAAG,CAAC,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC;YACjE,MAAM,IAAI,UAAU,CAClB,kBAAkB,SAAS,KAAK,OAAO,cAAc,IAAI,CAAC,KAAK,EAAE,CAClE,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CACvB,iBAAqD;IAErD,0CAA0C;IAC1C,IAAI,iBAAiB,IAAI,MAAM,CAAC,QAAQ,IAAI,iBAAiB,EAAE,CAAC;QAC9D,MAAM,IAAI,GAAG,IAAI,SAAS,EAAK,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,iBAAgC,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,SAAS,CAAI,iBAAwC,CAAC,CAAC;IACxE,OAAO,IAAI,CAAC;AACd,CAAC"}
|
|
@@ -0,0 +1,149 @@
|
|
|
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 type { MapLike, Entry } from "../interfaces/map.js";
|
|
21
|
+
import type { Eq, Hash } from "../core/traits.js";
|
|
22
|
+
/**
|
|
23
|
+
* Options for creating a HashMap.
|
|
24
|
+
*/
|
|
25
|
+
export interface HashMapOptions<K, V> {
|
|
26
|
+
/**
|
|
27
|
+
* Initial capacity (number of buckets).
|
|
28
|
+
* Must be a power of 2.
|
|
29
|
+
* @default 16
|
|
30
|
+
*/
|
|
31
|
+
initialCapacity?: number;
|
|
32
|
+
/**
|
|
33
|
+
* Load factor threshold for resizing (0-1).
|
|
34
|
+
* When size > capacity * loadFactor, the map resizes.
|
|
35
|
+
* @default 0.75
|
|
36
|
+
*/
|
|
37
|
+
loadFactor?: number;
|
|
38
|
+
/**
|
|
39
|
+
* Equality function for keys.
|
|
40
|
+
* @default defaultEq (===)
|
|
41
|
+
*/
|
|
42
|
+
keyEq?: Eq<K>;
|
|
43
|
+
/**
|
|
44
|
+
* Hash function for keys.
|
|
45
|
+
* @default defaultHash
|
|
46
|
+
*/
|
|
47
|
+
keyHash?: Hash<K>;
|
|
48
|
+
/**
|
|
49
|
+
* Equality function for values (used in containsValue).
|
|
50
|
+
* @default defaultEq (===)
|
|
51
|
+
*/
|
|
52
|
+
valueEq?: Eq<V>;
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* HashMap<K, V> - Hash table implementation with custom equality/hashing.
|
|
56
|
+
*
|
|
57
|
+
* Uses separate chaining for collision resolution.
|
|
58
|
+
* Automatically resizes when load factor is exceeded.
|
|
59
|
+
*
|
|
60
|
+
* Not thread-safe. Use synchronized() behavior for concurrent access.
|
|
61
|
+
*/
|
|
62
|
+
export declare class HashMap<K, V> implements MapLike<K, V> {
|
|
63
|
+
private _buckets;
|
|
64
|
+
private _size;
|
|
65
|
+
private readonly _loadFactor;
|
|
66
|
+
private readonly _keyEq;
|
|
67
|
+
private readonly _keyHash;
|
|
68
|
+
private readonly _valueEq;
|
|
69
|
+
private _threshold;
|
|
70
|
+
/**
|
|
71
|
+
* The count of structural changes (a key added or removed, a clear, a resize). An iterator
|
|
72
|
+
* records it at its start and throws when it changes. Before, a resize during iteration made
|
|
73
|
+
* the iterator skip or repeat entries (BUGS-2026-07 L15).
|
|
74
|
+
*/
|
|
75
|
+
private _modCount;
|
|
76
|
+
constructor(options?: HashMapOptions<K, V>);
|
|
77
|
+
get size(): number;
|
|
78
|
+
get isEmpty(): boolean;
|
|
79
|
+
get keyEq(): Eq<K>;
|
|
80
|
+
get valueEq(): Eq<V>;
|
|
81
|
+
has(key: K): boolean;
|
|
82
|
+
get(key: K): V;
|
|
83
|
+
getOrUndefined(key: K): V | undefined;
|
|
84
|
+
getOrDefault(key: K, defaultValue: V): V;
|
|
85
|
+
containsValue(value: V): boolean;
|
|
86
|
+
set(key: K, value: V): V | undefined;
|
|
87
|
+
setIfAbsent(key: K, value: V): V;
|
|
88
|
+
delete(key: K): V | undefined;
|
|
89
|
+
deleteEntry(key: K, value: V): boolean;
|
|
90
|
+
replace(key: K, value: V): V | undefined;
|
|
91
|
+
replaceEntry(key: K, oldValue: V, newValue: V): boolean;
|
|
92
|
+
computeIfAbsent(key: K, mappingFunction: (key: K) => V): V;
|
|
93
|
+
computeIfPresent(key: K, remappingFunction: (key: K, value: V) => V | undefined): V | undefined;
|
|
94
|
+
compute(key: K, remappingFunction: (key: K, value: V | undefined) => V | undefined): V | undefined;
|
|
95
|
+
merge(key: K, value: V, remappingFunction: (oldValue: V, newValue: V) => V | undefined): V | undefined;
|
|
96
|
+
putAll(other: MapLike<K, V> | Iterable<Entry<K, V>>): void;
|
|
97
|
+
clear(): void;
|
|
98
|
+
keys(): IterableIterator<K>;
|
|
99
|
+
values(): IterableIterator<V>;
|
|
100
|
+
entries(): IterableIterator<Entry<K, V>>;
|
|
101
|
+
[Symbol.iterator](): Iterator<Entry<K, V>>;
|
|
102
|
+
forEach(action: (value: V, key: K, map: this) => void): void;
|
|
103
|
+
/** This method throws when the map changed structurally after an iterator started. */
|
|
104
|
+
private checkUnchanged;
|
|
105
|
+
/**
|
|
106
|
+
* Returns the bucket index for a given hash.
|
|
107
|
+
*/
|
|
108
|
+
private bucketIndex;
|
|
109
|
+
/**
|
|
110
|
+
* Resizes the hash table to double its current capacity.
|
|
111
|
+
*/
|
|
112
|
+
private resize;
|
|
113
|
+
/**
|
|
114
|
+
* Returns the next power of 2 >= n.
|
|
115
|
+
*/
|
|
116
|
+
private nextPowerOfTwo;
|
|
117
|
+
/**
|
|
118
|
+
* Returns the current number of buckets.
|
|
119
|
+
*/
|
|
120
|
+
get capacity(): number;
|
|
121
|
+
/**
|
|
122
|
+
* Returns the current load factor (size / capacity).
|
|
123
|
+
*/
|
|
124
|
+
get loadFactor(): number;
|
|
125
|
+
/**
|
|
126
|
+
* Returns statistics about bucket distribution (for debugging).
|
|
127
|
+
*/
|
|
128
|
+
getStats(): {
|
|
129
|
+
size: number;
|
|
130
|
+
capacity: number;
|
|
131
|
+
loadFactor: number;
|
|
132
|
+
avgChainLength: number;
|
|
133
|
+
maxChainLength: number;
|
|
134
|
+
emptyBuckets: number;
|
|
135
|
+
};
|
|
136
|
+
}
|
|
137
|
+
/**
|
|
138
|
+
* Factory function to create a HashMap.
|
|
139
|
+
*
|
|
140
|
+
* @example
|
|
141
|
+
* const map = hashMap<string, number>()
|
|
142
|
+
* const mapWithOptions = hashMap<User, Data>({
|
|
143
|
+
* keyEq: (a, b) => a.id === b.id,
|
|
144
|
+
* keyHash: (u) => hashString(u.id)
|
|
145
|
+
* })
|
|
146
|
+
* const mapFromEntries = hashMap([['a', 1], ['b', 2]])
|
|
147
|
+
*/
|
|
148
|
+
export declare function hashMap<K, V>(optionsOrEntries?: HashMapOptions<K, V> | Iterable<readonly [K, V]>): HashMap<K, V>;
|
|
149
|
+
//# sourceMappingURL=hash-map.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hash-map.d.ts","sourceRoot":"","sources":["../../src/impl/hash-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAalD;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,EAAE,CAAC;IAClC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,qBAAa,OAAO,CAAC,CAAC,EAAE,CAAC,CAAE,YAAW,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,UAAU,CAAS;IAC3B;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAAK;IAEtB,YAAY,OAAO,GAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAM,EAiB7C;IAMD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAEjB;IAED,IAAI,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAEnB;IAMD,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAanB;IAED,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAMb;IAED,cAAc,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAapC;IAED,YAAY,CAAC,GAAG,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAGvC;IAED,aAAa,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAW/B;IAMD,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAgCnC;IAED,WAAW,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAO/B;IAED,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAyB5B;IAED,WAAW,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CA2BrC;IAED,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAevC;IAED,YAAY,CAAC,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAkBtD;IAMD,eAAe,CAAC,GAAG,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CASzD;IAED,gBAAgB,CACd,GAAG,EAAE,CAAC,EACN,iBAAiB,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,SAAS,GACrD,CAAC,GAAG,SAAS,CAcf;IAED,OAAO,CACL,GAAG,EAAE,CAAC,EACN,iBAAiB,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,GAAG,SAAS,GACjE,CAAC,GAAG,SAAS,CAaf;IAED,KAAK,CACH,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,CAAC,EACR,iBAAiB,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,SAAS,GAC7D,CAAC,GAAG,SAAS,CAgBf;IAMD,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAIzD;IAED,KAAK,IAAI,IAAI,CAIZ;IAMA,IAAI,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAU3B;IAEA,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAU7B;IAEA,OAAO,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAUxC;IAMA,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAE1C;IAED,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,KAAK,IAAI,GAAG,IAAI,CAI3D;IAMD,sFAAsF;IACtF,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,OAAO,CAAC,MAAM;IAyBd;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACH,QAAQ,IAAI;QACV,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;KACtB,CA4BA;CACF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAC1B,gBAAgB,CAAC,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAClE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAWf"}
|