@procedures/collections 0.47.1 → 0.48.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 (238) hide show
  1. package/CHANGELOG.md +32 -8
  2. package/README.md +3 -1
  3. package/dist/.tsbuildinfo +1 -1
  4. package/dist/index.d.ts +1 -59
  5. package/dist/index.d.ts.map +1 -1
  6. package/dist/index.js +3 -95
  7. package/dist/index.js.map +1 -1
  8. package/dist/storage/index.d.ts +2 -2
  9. package/dist/storage/index.d.ts.map +1 -1
  10. package/dist/storage/index.js +1 -1
  11. package/dist/storage/index.js.map +1 -1
  12. package/dist/storage/memory.d.ts +1 -1
  13. package/dist/storage/memory.d.ts.map +1 -1
  14. package/dist/storage/memory.js +1 -1
  15. package/dist/storage/memory.js.map +1 -1
  16. package/dist/testing/index.d.ts +1 -1
  17. package/dist/testing/index.d.ts.map +1 -1
  18. package/dist/testing/index.js +1 -1
  19. package/dist/testing/index.js.map +1 -1
  20. package/dist/testing/storage-contract.js +1 -1
  21. package/dist/testing/storage-contract.js.map +1 -1
  22. package/dist/undo/index.d.ts +1 -1
  23. package/dist/undo/index.js +1 -1
  24. package/dist/undo/undo-log.d.ts +1 -1
  25. package/dist/undo/undo-log.js +1 -1
  26. package/package.json +5 -5
  27. package/src/index.ts +338 -214
  28. package/src/storage/index.ts +2 -2
  29. package/src/storage/memory.ts +1 -1
  30. package/src/testing/index.ts +1 -1
  31. package/src/testing/storage-contract.ts +1 -1
  32. package/src/undo/index.ts +1 -1
  33. package/src/undo/undo-log.ts +1 -1
  34. package/dist/async/async-queue.d.ts +0 -170
  35. package/dist/async/async-queue.d.ts.map +0 -1
  36. package/dist/async/async-queue.js +0 -404
  37. package/dist/async/async-queue.js.map +0 -1
  38. package/dist/async/channels.d.ts +0 -211
  39. package/dist/async/channels.d.ts.map +0 -1
  40. package/dist/async/channels.js +0 -393
  41. package/dist/async/channels.js.map +0 -1
  42. package/dist/async/settled.d.ts +0 -23
  43. package/dist/async/settled.d.ts.map +0 -1
  44. package/dist/async/settled.js +0 -32
  45. package/dist/async/settled.js.map +0 -1
  46. package/dist/behaviors/bounded.d.ts +0 -79
  47. package/dist/behaviors/bounded.d.ts.map +0 -1
  48. package/dist/behaviors/bounded.js +0 -393
  49. package/dist/behaviors/bounded.js.map +0 -1
  50. package/dist/behaviors/composite.d.ts +0 -17
  51. package/dist/behaviors/composite.d.ts.map +0 -1
  52. package/dist/behaviors/composite.js +0 -93
  53. package/dist/behaviors/composite.js.map +0 -1
  54. package/dist/behaviors/evented.d.ts +0 -154
  55. package/dist/behaviors/evented.d.ts.map +0 -1
  56. package/dist/behaviors/evented.js +0 -299
  57. package/dist/behaviors/evented.js.map +0 -1
  58. package/dist/behaviors/lru.d.ts +0 -84
  59. package/dist/behaviors/lru.d.ts.map +0 -1
  60. package/dist/behaviors/lru.js +0 -376
  61. package/dist/behaviors/lru.js.map +0 -1
  62. package/dist/behaviors/readonly.d.ts +0 -73
  63. package/dist/behaviors/readonly.d.ts.map +0 -1
  64. package/dist/behaviors/readonly.js +0 -189
  65. package/dist/behaviors/readonly.js.map +0 -1
  66. package/dist/behaviors/safe.d.ts +0 -163
  67. package/dist/behaviors/safe.d.ts.map +0 -1
  68. package/dist/behaviors/safe.js +0 -176
  69. package/dist/behaviors/safe.js.map +0 -1
  70. package/dist/behaviors/synchronized.d.ts +0 -88
  71. package/dist/behaviors/synchronized.d.ts.map +0 -1
  72. package/dist/behaviors/synchronized.js +0 -285
  73. package/dist/behaviors/synchronized.js.map +0 -1
  74. package/dist/behaviors/ttl.d.ts +0 -118
  75. package/dist/behaviors/ttl.d.ts.map +0 -1
  76. package/dist/behaviors/ttl.js +0 -354
  77. package/dist/behaviors/ttl.js.map +0 -1
  78. package/dist/contracts/model.d.ts +0 -29
  79. package/dist/contracts/model.d.ts.map +0 -1
  80. package/dist/contracts/model.js +0 -26
  81. package/dist/contracts/model.js.map +0 -1
  82. package/dist/core/effects.d.ts +0 -176
  83. package/dist/core/effects.d.ts.map +0 -1
  84. package/dist/core/effects.js +0 -180
  85. package/dist/core/effects.js.map +0 -1
  86. package/dist/core/events.d.ts +0 -192
  87. package/dist/core/events.d.ts.map +0 -1
  88. package/dist/core/events.js +0 -291
  89. package/dist/core/events.js.map +0 -1
  90. package/dist/core/middleware.d.ts +0 -231
  91. package/dist/core/middleware.d.ts.map +0 -1
  92. package/dist/core/middleware.js +0 -161
  93. package/dist/core/middleware.js.map +0 -1
  94. package/dist/core/policies.d.ts +0 -220
  95. package/dist/core/policies.d.ts.map +0 -1
  96. package/dist/core/policies.js +0 -48
  97. package/dist/core/policies.js.map +0 -1
  98. package/dist/core/traits.d.ts +0 -142
  99. package/dist/core/traits.d.ts.map +0 -1
  100. package/dist/core/traits.js +0 -8
  101. package/dist/core/traits.js.map +0 -1
  102. package/dist/fx/collectors.d.ts +0 -193
  103. package/dist/fx/collectors.d.ts.map +0 -1
  104. package/dist/fx/collectors.js +0 -375
  105. package/dist/fx/collectors.js.map +0 -1
  106. package/dist/fx/iter.d.ts +0 -166
  107. package/dist/fx/iter.d.ts.map +0 -1
  108. package/dist/fx/iter.js +0 -421
  109. package/dist/fx/iter.js.map +0 -1
  110. package/dist/impl/array-deque.d.ts +0 -112
  111. package/dist/impl/array-deque.d.ts.map +0 -1
  112. package/dist/impl/array-deque.js +0 -380
  113. package/dist/impl/array-deque.js.map +0 -1
  114. package/dist/impl/array-list.d.ts +0 -101
  115. package/dist/impl/array-list.d.ts.map +0 -1
  116. package/dist/impl/array-list.js +0 -387
  117. package/dist/impl/array-list.js.map +0 -1
  118. package/dist/impl/hash-map.d.ts +0 -149
  119. package/dist/impl/hash-map.d.ts.map +0 -1
  120. package/dist/impl/hash-map.js +0 -473
  121. package/dist/impl/hash-map.js.map +0 -1
  122. package/dist/impl/hash-set.d.ts +0 -125
  123. package/dist/impl/hash-set.d.ts.map +0 -1
  124. package/dist/impl/hash-set.js +0 -264
  125. package/dist/impl/hash-set.js.map +0 -1
  126. package/dist/impl/linked-hash-map.d.ts +0 -141
  127. package/dist/impl/linked-hash-map.d.ts.map +0 -1
  128. package/dist/impl/linked-hash-map.js +0 -442
  129. package/dist/impl/linked-hash-map.js.map +0 -1
  130. package/dist/impl/linked-list.d.ts +0 -109
  131. package/dist/impl/linked-list.d.ts.map +0 -1
  132. package/dist/impl/linked-list.js +0 -494
  133. package/dist/impl/linked-list.js.map +0 -1
  134. package/dist/impl/priority-queue.d.ts +0 -139
  135. package/dist/impl/priority-queue.d.ts.map +0 -1
  136. package/dist/impl/priority-queue.js +0 -343
  137. package/dist/impl/priority-queue.js.map +0 -1
  138. package/dist/impl/summary-tree.d.ts +0 -146
  139. package/dist/impl/summary-tree.d.ts.map +0 -1
  140. package/dist/impl/summary-tree.js +0 -524
  141. package/dist/impl/summary-tree.js.map +0 -1
  142. package/dist/impl/tree-map.d.ts +0 -153
  143. package/dist/impl/tree-map.d.ts.map +0 -1
  144. package/dist/impl/tree-map.js +0 -788
  145. package/dist/impl/tree-map.js.map +0 -1
  146. package/dist/impl/tree-set.d.ts +0 -112
  147. package/dist/impl/tree-set.d.ts.map +0 -1
  148. package/dist/impl/tree-set.js +0 -374
  149. package/dist/impl/tree-set.js.map +0 -1
  150. package/dist/interfaces/collection.d.ts +0 -119
  151. package/dist/interfaces/collection.d.ts.map +0 -1
  152. package/dist/interfaces/collection.js +0 -8
  153. package/dist/interfaces/collection.js.map +0 -1
  154. package/dist/interfaces/list.d.ts +0 -247
  155. package/dist/interfaces/list.d.ts.map +0 -1
  156. package/dist/interfaces/list.js +0 -8
  157. package/dist/interfaces/list.js.map +0 -1
  158. package/dist/interfaces/map.d.ts +0 -344
  159. package/dist/interfaces/map.d.ts.map +0 -1
  160. package/dist/interfaces/map.js +0 -8
  161. package/dist/interfaces/map.js.map +0 -1
  162. package/dist/interfaces/queue.d.ts +0 -304
  163. package/dist/interfaces/queue.d.ts.map +0 -1
  164. package/dist/interfaces/queue.js +0 -8
  165. package/dist/interfaces/queue.js.map +0 -1
  166. package/dist/interfaces/set.d.ts +0 -137
  167. package/dist/interfaces/set.d.ts.map +0 -1
  168. package/dist/interfaces/set.js +0 -8
  169. package/dist/interfaces/set.js.map +0 -1
  170. package/dist/order/index.d.ts +0 -7
  171. package/dist/order/index.d.ts.map +0 -1
  172. package/dist/order/index.js +0 -7
  173. package/dist/order/index.js.map +0 -1
  174. package/dist/order/rank.d.ts +0 -100
  175. package/dist/order/rank.d.ts.map +0 -1
  176. package/dist/order/rank.js +0 -286
  177. package/dist/order/rank.js.map +0 -1
  178. package/dist/storage/listeners.d.ts +0 -39
  179. package/dist/storage/listeners.d.ts.map +0 -1
  180. package/dist/storage/listeners.js +0 -65
  181. package/dist/storage/listeners.js.map +0 -1
  182. package/dist/testing/check.d.ts +0 -25
  183. package/dist/testing/check.d.ts.map +0 -1
  184. package/dist/testing/check.js +0 -85
  185. package/dist/testing/check.js.map +0 -1
  186. package/dist/utils/defaults.d.ts +0 -135
  187. package/dist/utils/defaults.d.ts.map +0 -1
  188. package/dist/utils/defaults.js +0 -322
  189. package/dist/utils/defaults.js.map +0 -1
  190. package/dist/utils/factories.d.ts +0 -144
  191. package/dist/utils/factories.d.ts.map +0 -1
  192. package/dist/utils/factories.js +0 -293
  193. package/dist/utils/factories.js.map +0 -1
  194. package/dist/utils/helpers.d.ts +0 -137
  195. package/dist/utils/helpers.d.ts.map +0 -1
  196. package/dist/utils/helpers.js +0 -221
  197. package/dist/utils/helpers.js.map +0 -1
  198. package/src/async/async-queue.ts +0 -481
  199. package/src/async/channels.ts +0 -450
  200. package/src/async/settled.ts +0 -41
  201. package/src/behaviors/bounded.ts +0 -485
  202. package/src/behaviors/composite.ts +0 -99
  203. package/src/behaviors/evented.ts +0 -464
  204. package/src/behaviors/lru.ts +0 -447
  205. package/src/behaviors/readonly.ts +0 -236
  206. package/src/behaviors/safe.ts +0 -372
  207. package/src/behaviors/synchronized.ts +0 -316
  208. package/src/behaviors/ttl.ts +0 -462
  209. package/src/contracts/model.ts +0 -44
  210. package/src/core/effects.ts +0 -323
  211. package/src/core/events.ts +0 -356
  212. package/src/core/middleware.ts +0 -415
  213. package/src/core/policies.ts +0 -316
  214. package/src/core/traits.ts +0 -164
  215. package/src/fx/collectors.ts +0 -500
  216. package/src/fx/iter.ts +0 -536
  217. package/src/impl/array-deque.ts +0 -463
  218. package/src/impl/array-list.ts +0 -490
  219. package/src/impl/hash-map.ts +0 -623
  220. package/src/impl/hash-set.ts +0 -342
  221. package/src/impl/linked-hash-map.ts +0 -572
  222. package/src/impl/linked-list.ts +0 -606
  223. package/src/impl/priority-queue.ts +0 -448
  224. package/src/impl/summary-tree.ts +0 -586
  225. package/src/impl/tree-map.ts +0 -912
  226. package/src/impl/tree-set.ts +0 -469
  227. package/src/interfaces/collection.ts +0 -141
  228. package/src/interfaces/list.ts +0 -281
  229. package/src/interfaces/map.ts +0 -405
  230. package/src/interfaces/queue.ts +0 -353
  231. package/src/interfaces/set.ts +0 -158
  232. package/src/order/index.ts +0 -6
  233. package/src/order/rank.ts +0 -271
  234. package/src/storage/listeners.ts +0 -72
  235. package/src/testing/check.ts +0 -81
  236. package/src/utils/defaults.ts +0 -345
  237. package/src/utils/factories.ts +0 -357
  238. package/src/utils/helpers.ts +0 -248
@@ -1,376 +0,0 @@
1
- /**
2
- * LRU (Least Recently Used) eviction behavior.
3
- *
4
- * Tracks access times and automatically evicts the least recently used
5
- * elements when capacity is reached. Perfect for caching.
6
- *
7
- * @example
8
- * const cache = compose(
9
- * lruMap({ capacity: 100 })
10
- * )(hashMap<string, Data>())
11
- *
12
- * cache.set('key1', data1) // Accessed
13
- * cache.get('key1') // Accessed again (moves to front)
14
- * // When full, least recently accessed keys are evicted
15
- */
16
- import { compositeMapMethod } from "./composite.js";
17
- /**
18
- * Creates an LRU Map middleware.
19
- *
20
- * Maintains a doubly-linked list to track access order.
21
- * Most recently accessed items are at the head.
22
- * When capacity is exceeded, items at the tail are evicted.
23
- */
24
- export function lruMap(options) {
25
- const { capacity, onEvict } = options;
26
- return (next) => {
27
- // Doubly-linked list for LRU tracking
28
- let head = null;
29
- let tail = null;
30
- const nodeMap = new Map();
31
- const moveToHead = (node) => {
32
- // Remove from current position
33
- if (node.prev) {
34
- node.prev.next = node.next;
35
- }
36
- else {
37
- head = node.next;
38
- }
39
- if (node.next) {
40
- node.next.prev = node.prev;
41
- }
42
- else {
43
- tail = node.prev;
44
- }
45
- // Add to head
46
- node.prev = null;
47
- node.next = head;
48
- if (head) {
49
- head.prev = node;
50
- }
51
- head = node;
52
- if (!tail) {
53
- tail = node;
54
- }
55
- node.lastAccessed = Date.now();
56
- };
57
- const addNode = (key, value) => {
58
- const node = {
59
- key,
60
- value,
61
- lastAccessed: Date.now(),
62
- prev: null,
63
- next: head,
64
- };
65
- if (head) {
66
- head.prev = node;
67
- }
68
- head = node;
69
- if (!tail) {
70
- tail = node;
71
- }
72
- nodeMap.set(key, node);
73
- };
74
- const removeNode = (node) => {
75
- if (node.prev) {
76
- node.prev.next = node.next;
77
- }
78
- else {
79
- head = node.next;
80
- }
81
- if (node.next) {
82
- node.next.prev = node.prev;
83
- }
84
- else {
85
- tail = node.prev;
86
- }
87
- nodeMap.delete(node.key);
88
- };
89
- // A layer below this one (for example ttlMap, in compose(lruMap, ttlMap)) can remove an
90
- // entry without this layer seeing it. Its node is then stale: the list must not keep it
91
- // (it holds the value, and it would grow without bound) and evicting it is not an eviction.
92
- const dropStaleNodes = () => {
93
- for (const node of [...nodeMap.values()]) {
94
- if (!next.has(node.key)) {
95
- removeNode(node);
96
- }
97
- }
98
- };
99
- const evictLRU = () => {
100
- while (tail) {
101
- const candidate = tail;
102
- removeNode(candidate);
103
- if (!next.has(candidate.key)) {
104
- // Already removed below: skip it and evict the next least recently used entry
105
- continue;
106
- }
107
- next.delete(candidate.key);
108
- if (onEvict) {
109
- onEvict({
110
- key: candidate.key,
111
- value: candidate.value,
112
- timestamp: candidate.lastAccessed,
113
- });
114
- }
115
- return;
116
- }
117
- };
118
- return new Proxy(next, {
119
- get(target, prop, receiver) {
120
- // Add isFull property
121
- if (prop === "isFull") {
122
- return target.size >= capacity;
123
- }
124
- // Composite methods (setIfAbsent, compute, merge, putAll and others) go through this
125
- // proxy's own primitives, so they keep this behavior's rules (BUGS-2026-07 L13)
126
- const composite = compositeMapMethod(receiver, prop);
127
- if (composite) {
128
- return composite;
129
- }
130
- const value = Reflect.get(target, prop, receiver);
131
- if (typeof value === "function") {
132
- switch (prop) {
133
- case "get":
134
- return function (key) {
135
- let result;
136
- try {
137
- result = value.call(target, key);
138
- }
139
- catch (error) {
140
- // The entry is gone below (for example expired): forget its node
141
- const stale = nodeMap.get(key);
142
- if (stale) {
143
- removeNode(stale);
144
- }
145
- throw error;
146
- }
147
- // Update access time
148
- const node = nodeMap.get(key);
149
- if (node) {
150
- moveToHead(node);
151
- }
152
- return result;
153
- };
154
- case "has":
155
- return function (key) {
156
- const result = value.call(target, key);
157
- const node = nodeMap.get(key);
158
- if (node) {
159
- if (result) {
160
- // Update access time
161
- moveToHead(node);
162
- }
163
- else {
164
- // The entry is gone below (for example expired): forget its node
165
- removeNode(node);
166
- }
167
- }
168
- return result;
169
- };
170
- case "set":
171
- return function (key, val) {
172
- const hadKey = target.has(key);
173
- if (hadKey) {
174
- // Update existing
175
- const oldValue = value.call(target, key, val);
176
- const node = nodeMap.get(key);
177
- if (node) {
178
- node.value = val;
179
- moveToHead(node);
180
- }
181
- return oldValue;
182
- }
183
- else {
184
- // Add new. A stale node for this key (its entry was removed below) must not
185
- // stay in the list: evicting it later would delete the new node's map entry.
186
- const stale = nodeMap.get(key);
187
- if (stale) {
188
- removeNode(stale);
189
- }
190
- // Keep the node list bounded: when it reaches capacity, drop stale nodes first
191
- if (nodeMap.size >= capacity) {
192
- dropStaleNodes();
193
- }
194
- if (target.size >= capacity) {
195
- evictLRU();
196
- }
197
- const result = value.call(target, key, val);
198
- addNode(key, val);
199
- return result;
200
- }
201
- };
202
- case "delete":
203
- return function (key) {
204
- const result = value.call(target, key);
205
- const node = nodeMap.get(key);
206
- if (node) {
207
- removeNode(node);
208
- }
209
- return result;
210
- };
211
- case "clear":
212
- return function () {
213
- value.call(target);
214
- head = null;
215
- tail = null;
216
- nodeMap.clear();
217
- };
218
- }
219
- }
220
- return value;
221
- },
222
- });
223
- };
224
- }
225
- /**
226
- * Creates an LRU cache with a simpler API.
227
- * This is a standalone LRU cache implementation.
228
- *
229
- * @example
230
- * const cache = lruCache<string, Data>(100)
231
- * cache.set('key', value)
232
- * cache.get('key') // Moves to front
233
- */
234
- export class LRUCache {
235
- capacity;
236
- onEvict;
237
- map = new Map();
238
- head = null;
239
- tail = null;
240
- constructor(capacity, onEvict) {
241
- this.capacity = capacity;
242
- this.onEvict = onEvict;
243
- }
244
- get size() {
245
- return this.map.size;
246
- }
247
- get isFull() {
248
- return this.map.size >= this.capacity;
249
- }
250
- get(key) {
251
- const entry = this.map.get(key);
252
- if (!entry)
253
- return undefined;
254
- this.moveToHead(entry.node);
255
- return entry.value;
256
- }
257
- set(key, value) {
258
- const entry = this.map.get(key);
259
- if (entry) {
260
- // Update existing
261
- entry.value = value;
262
- entry.node.value = value;
263
- this.moveToHead(entry.node);
264
- }
265
- else {
266
- // Add new
267
- if (this.map.size >= this.capacity) {
268
- this.evictLRU();
269
- }
270
- const node = {
271
- key,
272
- value,
273
- lastAccessed: Date.now(),
274
- prev: null,
275
- next: this.head,
276
- };
277
- if (this.head) {
278
- this.head.prev = node;
279
- }
280
- this.head = node;
281
- if (!this.tail) {
282
- this.tail = node;
283
- }
284
- this.map.set(key, { value, node });
285
- }
286
- }
287
- has(key) {
288
- return this.map.has(key);
289
- }
290
- delete(key) {
291
- const entry = this.map.get(key);
292
- if (!entry)
293
- return false;
294
- this.removeNode(entry.node);
295
- this.map.delete(key);
296
- return true;
297
- }
298
- clear() {
299
- this.map.clear();
300
- this.head = null;
301
- this.tail = null;
302
- }
303
- moveToHead(node) {
304
- if (node === this.head)
305
- return;
306
- // Remove from current position
307
- if (node.prev) {
308
- node.prev.next = node.next;
309
- }
310
- if (node.next) {
311
- node.next.prev = node.prev;
312
- }
313
- else {
314
- this.tail = node.prev;
315
- }
316
- // Add to head
317
- node.prev = null;
318
- node.next = this.head;
319
- if (this.head) {
320
- this.head.prev = node;
321
- }
322
- this.head = node;
323
- node.lastAccessed = Date.now();
324
- }
325
- removeNode(node) {
326
- if (node.prev) {
327
- node.prev.next = node.next;
328
- }
329
- else {
330
- this.head = node.next;
331
- }
332
- if (node.next) {
333
- node.next.prev = node.prev;
334
- }
335
- else {
336
- this.tail = node.prev;
337
- }
338
- }
339
- evictLRU() {
340
- if (!this.tail)
341
- return;
342
- const evicted = this.tail;
343
- this.removeNode(evicted);
344
- this.map.delete(evicted.key);
345
- if (this.onEvict) {
346
- this.onEvict(evicted.key, evicted.value);
347
- }
348
- }
349
- /**
350
- * Returns keys in LRU order (most recent first).
351
- */
352
- *keys() {
353
- let node = this.head;
354
- while (node) {
355
- yield node.key;
356
- node = node.next;
357
- }
358
- }
359
- /**
360
- * Returns entries in LRU order (most recent first).
361
- */
362
- *entries() {
363
- let node = this.head;
364
- while (node) {
365
- yield [node.key, node.value];
366
- node = node.next;
367
- }
368
- }
369
- }
370
- /**
371
- * Factory function to create an LRU cache.
372
- */
373
- export function lruCache(capacity, onEvict) {
374
- return new LRUCache(capacity, onEvict);
375
- }
376
- //# sourceMappingURL=lru.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"lru.js","sourceRoot":"","sources":["../../src/behaviors/lru.ts"],"names":[],"mappings":"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"}
@@ -1,73 +0,0 @@
1
- /**
2
- * Readonly behavior - Creates immutable views of collections.
3
- *
4
- * Wraps collections to prevent modifications by throwing errors
5
- * on any mutation attempt. Mirrors Java's Collections.unmodifiable*() methods.
6
- *
7
- * @example
8
- * const list = compose(
9
- * readonlyList()
10
- * )(arrayList([1, 2, 3]))
11
- *
12
- * list.get(0) // OK: 1
13
- * list.add(4) // Error: Cannot modify readonly list
14
- */
15
- import type { Middleware } from "../core/middleware.js";
16
- import type { ReadonlyList } from "../interfaces/list.js";
17
- import type { ReadonlyQueue } from "../interfaces/queue.js";
18
- import type { ReadonlyMapLike } from "../interfaces/map.js";
19
- import type { ReadonlyCollection } from "../interfaces/collection.js";
20
- /**
21
- * Options for readonly behavior.
22
- */
23
- export interface ReadonlyOptions {
24
- /**
25
- * Custom error message to throw on mutation attempts.
26
- * @default 'Cannot modify readonly collection'
27
- */
28
- errorMessage?: string;
29
- }
30
- /**
31
- * Creates a readonly List middleware.
32
- *
33
- * All mutation methods will throw an error.
34
- * Read operations work normally.
35
- *
36
- * @example
37
- * const readonlyNumbers = compose(
38
- * readonlyList()
39
- * )(arrayList([1, 2, 3]))
40
- */
41
- export declare function readonlyList<T>(options?: ReadonlyOptions): Middleware<ReadonlyList<T>>;
42
- /**
43
- * Creates a readonly Queue middleware.
44
- */
45
- export declare function readonlyQueue<T>(options?: ReadonlyOptions): Middleware<ReadonlyQueue<T>>;
46
- /**
47
- * Creates a readonly Map middleware.
48
- */
49
- export declare function readonlyMap<K, V>(options?: ReadonlyOptions): Middleware<ReadonlyMapLike<K, V>>;
50
- /**
51
- * Creates a readonly Collection middleware.
52
- *
53
- * Generic version that works with any collection type.
54
- */
55
- export declare function readonlyCollection<T>(options?: ReadonlyOptions): Middleware<ReadonlyCollection<T>>;
56
- /**
57
- * Generic readonly middleware.
58
- * Alias for readonlyCollection.
59
- */
60
- export declare function readonly<C extends object>(options?: ReadonlyOptions): Middleware<C>;
61
- /**
62
- * Alias for Java compatibility: unmodifiableList
63
- */
64
- export declare const unmodifiableList: typeof readonlyList;
65
- /**
66
- * Alias for Java compatibility: unmodifiableMap
67
- */
68
- export declare const unmodifiableMap: typeof readonlyMap;
69
- /**
70
- * Alias for Java compatibility: unmodifiableCollection
71
- */
72
- export declare const unmodifiableCollection: typeof readonlyCollection;
73
- //# sourceMappingURL=readonly.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"readonly.d.ts","sourceRoot":"","sources":["../../src/behaviors/readonly.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAmID;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,OAAO,GAAE,eAAoB,GAC5B,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAG7B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,OAAO,GAAE,eAAoB,GAC5B,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAG9B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAC9B,OAAO,GAAE,eAAoB,GAC5B,UAAU,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAGnC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,OAAO,GAAE,eAAoB,GAC5B,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAGnC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EACvC,OAAO,GAAE,eAAoB,GAC5B,UAAU,CAAC,CAAC,CAAC,CAGf;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAG,OAAO,YAA2B,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,eAAe,EAAG,OAAO,WAAyB,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAG,OAAO,kBAAuC,CAAC"}
@@ -1,189 +0,0 @@
1
- /**
2
- * Readonly behavior - Creates immutable views of collections.
3
- *
4
- * Wraps collections to prevent modifications by throwing errors
5
- * on any mutation attempt. Mirrors Java's Collections.unmodifiable*() methods.
6
- *
7
- * @example
8
- * const list = compose(
9
- * readonlyList()
10
- * )(arrayList([1, 2, 3]))
11
- *
12
- * list.get(0) // OK: 1
13
- * list.add(4) // Error: Cannot modify readonly list
14
- */
15
- /**
16
- * Set of method names that mutate collections.
17
- */
18
- const MUTATING_METHODS = new Set([
19
- // Collection mutations
20
- "add",
21
- "addAll",
22
- "remove",
23
- "removeAll",
24
- "retainAll",
25
- "clear",
26
- // List mutations
27
- "set",
28
- "insert",
29
- "insertAll",
30
- "removeAt",
31
- "removeRange",
32
- "push",
33
- "pop",
34
- "shift",
35
- "unshift",
36
- "sort",
37
- "reverse",
38
- // Queue/Deque mutations
39
- "offer",
40
- "offerFirst",
41
- "offerLast",
42
- "poll",
43
- "pollFirst",
44
- "pollLast",
45
- "enqueue",
46
- "dequeue",
47
- "addFirst",
48
- "addLast",
49
- "removeFirst",
50
- "removeLast",
51
- // Map mutations
52
- "set",
53
- "setIfAbsent",
54
- "forcePut",
55
- "pollFirstEntry",
56
- "pollLastEntry",
57
- "delete",
58
- "deleteEntry",
59
- "replace",
60
- "replaceEntry",
61
- "computeIfAbsent",
62
- "computeIfPresent",
63
- "compute",
64
- "merge",
65
- "putAll",
66
- ]);
67
- /** Methods that return a view of the collection: the view is readonly too. */
68
- const VIEW_METHODS = new Set([
69
- "subList",
70
- "subMap",
71
- "subSet",
72
- "headMap",
73
- "tailMap",
74
- "headSet",
75
- "tailSet",
76
- "descendingMap",
77
- "descendingSet",
78
- "inverse",
79
- ]);
80
- /**
81
- * Creates a readonly middleware for any collection type.
82
- */
83
- function createReadonly(errorMessage = "Cannot modify readonly collection") {
84
- return (next) => {
85
- // The read methods, bound to the collection: one function for each name
86
- const bound = new Map();
87
- return new Proxy(next, {
88
- get(target, prop) {
89
- // A read runs on the collection itself, not on the proxy: a read that changes internal
90
- // state (a LinkedHashMap with accessOrder moves the entry) does not hit the set trap
91
- const value = Reflect.get(target, prop, target);
92
- // Block mutating methods
93
- if (typeof prop === "string" && MUTATING_METHODS.has(prop)) {
94
- if (typeof value === "function") {
95
- return () => {
96
- throw new Error(errorMessage);
97
- };
98
- }
99
- }
100
- // A view (a sublist, a submap, a head or tail set, a descending map) is readonly too.
101
- // Before, only subList and subMap were wrapped, and setIfAbsent, pollFirstEntry and
102
- // pollLastEntry were not blocked (BUGS-2026-07 L14).
103
- if (typeof value === "function" && typeof prop === "string" && VIEW_METHODS.has(prop)) {
104
- return function (...args) {
105
- const result = value.apply(target, args);
106
- // Recursively apply readonly to the result
107
- return createReadonly(errorMessage)(result);
108
- };
109
- }
110
- if (typeof value === "function") {
111
- const known = bound.get(prop);
112
- if (known !== undefined && known.value === value)
113
- return known.method;
114
- const method = value.bind(target);
115
- bound.set(prop, { value, method });
116
- return method;
117
- }
118
- return value;
119
- },
120
- set(_target, _prop, _value, _receiver) {
121
- // Block property assignments
122
- throw new Error(errorMessage);
123
- },
124
- deleteProperty(_target, _prop) {
125
- // Block property deletions
126
- throw new Error(errorMessage);
127
- },
128
- });
129
- };
130
- }
131
- /**
132
- * Creates a readonly List middleware.
133
- *
134
- * All mutation methods will throw an error.
135
- * Read operations work normally.
136
- *
137
- * @example
138
- * const readonlyNumbers = compose(
139
- * readonlyList()
140
- * )(arrayList([1, 2, 3]))
141
- */
142
- export function readonlyList(options = {}) {
143
- const errorMessage = options.errorMessage ?? "Cannot modify readonly list";
144
- return createReadonly(errorMessage);
145
- }
146
- /**
147
- * Creates a readonly Queue middleware.
148
- */
149
- export function readonlyQueue(options = {}) {
150
- const errorMessage = options.errorMessage ?? "Cannot modify readonly queue";
151
- return createReadonly(errorMessage);
152
- }
153
- /**
154
- * Creates a readonly Map middleware.
155
- */
156
- export function readonlyMap(options = {}) {
157
- const errorMessage = options.errorMessage ?? "Cannot modify readonly map";
158
- return createReadonly(errorMessage);
159
- }
160
- /**
161
- * Creates a readonly Collection middleware.
162
- *
163
- * Generic version that works with any collection type.
164
- */
165
- export function readonlyCollection(options = {}) {
166
- const errorMessage = options.errorMessage ?? "Cannot modify readonly collection";
167
- return createReadonly(errorMessage);
168
- }
169
- /**
170
- * Generic readonly middleware.
171
- * Alias for readonlyCollection.
172
- */
173
- export function readonly(options = {}) {
174
- const errorMessage = options.errorMessage ?? "Cannot modify readonly collection";
175
- return createReadonly(errorMessage);
176
- }
177
- /**
178
- * Alias for Java compatibility: unmodifiableList
179
- */
180
- export const unmodifiableList = readonlyList;
181
- /**
182
- * Alias for Java compatibility: unmodifiableMap
183
- */
184
- export const unmodifiableMap = readonlyMap;
185
- /**
186
- * Alias for Java compatibility: unmodifiableCollection
187
- */
188
- export const unmodifiableCollection = readonlyCollection;
189
- //# sourceMappingURL=readonly.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"readonly.js","sourceRoot":"","sources":["../../src/behaviors/readonly.ts"],"names":[],"mappings":"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"}