@signaldb/core 2.0.0-beta.2 → 2.0.0-beta.21
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/dist/.vite/manifest.json +183 -80
- package/dist/AsyncDataAdapter.d.ts +53 -7
- package/dist/AutoFetchDataAdapter.d.ts +4 -6
- package/dist/Collection/Cursor.d.ts +56 -4
- package/dist/Collection/Observer.d.ts +33 -0
- package/dist/Collection/index.d.ts +66 -19
- package/dist/Collection/types.d.ts +9 -2
- package/dist/DataAdapter.d.ts +24 -6
- package/dist/DefaultDataAdapter.d.ts +5 -5
- package/dist/WorkerDataAdapter.d.ts +57 -5
- package/dist/WorkerDataAdapterHost.d.ts +9 -7
- package/dist/createIndex.d.ts +2 -2
- package/dist/createIndexProvider.d.ts +2 -2
- package/dist/createReactivityAdapter.d.ts +2 -2
- package/dist/createStorageAdapter.d.ts +1 -1
- package/dist/getIndexInfo.d.ts +3 -4
- package/dist/index.cjs.js +33 -31
- package/dist/index.d.ts +6 -1
- package/dist/index.mjs +17 -32
- package/dist/index10.cjs.js +11 -0
- package/dist/index10.mjs +10 -18
- package/dist/index11.cjs.js +23 -0
- package/dist/index11.mjs +22 -15
- package/dist/index12.cjs.js +45 -0
- package/dist/index12.mjs +44 -353
- package/dist/index13.cjs.js +22 -0
- package/dist/index13.mjs +21 -419
- package/dist/index14.cjs.js +45 -0
- package/dist/index14.mjs +44 -206
- package/dist/index15.cjs.js +86 -0
- package/dist/index15.mjs +85 -388
- package/dist/index16.cjs.js +15 -0
- package/dist/index16.mjs +14 -579
- package/dist/index17.cjs.js +141 -0
- package/dist/index17.mjs +140 -152
- package/dist/index18.cjs.js +47 -0
- package/dist/index18.mjs +46 -26
- package/dist/index19.cjs.js +15 -0
- package/dist/index19.mjs +14 -41
- package/dist/index2.cjs.js +33 -0
- package/dist/index2.mjs +32 -258
- package/dist/index20.cjs.js +23 -0
- package/dist/index20.mjs +22 -16
- package/dist/index21.cjs.js +37 -0
- package/dist/index21.mjs +36 -104
- package/dist/index22.cjs.js +35 -0
- package/dist/index22.mjs +34 -128
- package/dist/index23.cjs.js +21 -0
- package/dist/index23.mjs +20 -7
- package/dist/index24.cjs.js +19 -0
- package/dist/index24.mjs +18 -27
- package/dist/index25.cjs.js +157 -0
- package/dist/index25.mjs +156 -11
- package/dist/index26.cjs.js +38 -0
- package/dist/index26.mjs +37 -29
- package/dist/index27.cjs.js +42 -0
- package/dist/index27.mjs +41 -46
- package/dist/index28.cjs.js +347 -0
- package/dist/index28.mjs +345 -7
- package/dist/index29.cjs.js +602 -0
- package/dist/index29.mjs +601 -7
- package/dist/index3.cjs.js +19 -0
- package/dist/index3.mjs +18 -556
- package/dist/index30.cjs.js +11 -0
- package/dist/index30.mjs +10 -42
- package/dist/index31.cjs.js +11 -0
- package/dist/index31.mjs +10 -29
- package/dist/index32.cjs.js +90 -0
- package/dist/index32.mjs +89 -10
- package/dist/index33.cjs.js +53 -0
- package/dist/index33.mjs +52 -5
- package/dist/index34.cjs.js +453 -0
- package/dist/index34.mjs +453 -0
- package/dist/index35.cjs.js +72 -0
- package/dist/index35.mjs +72 -0
- package/dist/index36.cjs.js +580 -0
- package/dist/index36.mjs +580 -0
- package/dist/index37.cjs.js +21 -0
- package/dist/index37.mjs +21 -0
- package/dist/index38.cjs.js +363 -0
- package/dist/index38.mjs +363 -0
- package/dist/index39.cjs.js +513 -0
- package/dist/index39.mjs +513 -0
- package/dist/index4.cjs.js +209 -0
- package/dist/index4.mjs +204 -5
- package/dist/index5.cjs.js +187 -0
- package/dist/index5.mjs +186 -5
- package/dist/index6.cjs.js +303 -0
- package/dist/index6.mjs +301 -28
- package/dist/index7.cjs.js +125 -0
- package/dist/index7.mjs +124 -12
- package/dist/index8.cjs.js +33 -0
- package/dist/index8.mjs +32 -5
- package/dist/index9.cjs.js +12 -0
- package/dist/index9.mjs +11 -133
- package/dist/types/IndexProvider.d.ts +2 -2
- package/dist/types/Modifier.d.ts +1 -1
- package/dist/types/ReactivityAdapter.d.ts +1 -1
- package/dist/types/StorageAdapter.d.ts +9 -1
- package/dist/utils/applyQueryOptions.d.ts +15 -0
- package/dist/utils/createSignal.d.ts +2 -2
- package/dist/utils/getMatchingKeys.d.ts +2 -2
- package/dist/utils/idIndexQuery.d.ts +20 -0
- package/dist/utils/incrementalQueryUpdate.d.ts +62 -0
- package/dist/utils/isFieldExpression.d.ts +1 -1
- package/dist/utils/match.d.ts +1 -1
- package/dist/utils/modify.d.ts +1 -1
- package/dist/utils/projectItems.d.ts +12 -0
- package/dist/utils/queryDelta.d.ts +83 -0
- package/dist/utils/queryId.d.ts +2 -2
- package/dist/utils/reactiveOrAsync.d.ts +59 -0
- package/dist/utils/storageIndexQuery.d.ts +20 -0
- package/package.json +1 -1
- package/dist/index.cjs10.js +0 -18
- package/dist/index.cjs11.js +0 -15
- package/dist/index.cjs12.js +0 -353
- package/dist/index.cjs13.js +0 -419
- package/dist/index.cjs14.js +0 -206
- package/dist/index.cjs15.js +0 -388
- package/dist/index.cjs16.js +0 -579
- package/dist/index.cjs17.js +0 -152
- package/dist/index.cjs18.js +0 -26
- package/dist/index.cjs19.js +0 -42
- package/dist/index.cjs2.js +0 -259
- package/dist/index.cjs20.js +0 -16
- package/dist/index.cjs21.js +0 -104
- package/dist/index.cjs22.js +0 -129
- package/dist/index.cjs23.js +0 -7
- package/dist/index.cjs24.js +0 -27
- package/dist/index.cjs25.js +0 -10
- package/dist/index.cjs26.js +0 -29
- package/dist/index.cjs27.js +0 -46
- package/dist/index.cjs28.js +0 -8
- package/dist/index.cjs29.js +0 -7
- package/dist/index.cjs3.js +0 -557
- package/dist/index.cjs30.js +0 -42
- package/dist/index.cjs31.js +0 -29
- package/dist/index.cjs32.js +0 -9
- package/dist/index.cjs33.js +0 -5
- package/dist/index.cjs4.js +0 -5
- package/dist/index.cjs5.js +0 -5
- package/dist/index.cjs6.js +0 -29
- package/dist/index.cjs7.js +0 -12
- package/dist/index.cjs8.js +0 -5
- package/dist/index.cjs9.js +0 -133
package/dist/index6.mjs
CHANGED
|
@@ -1,30 +1,303 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
if (a === null)
|
|
13
|
-
return false;
|
|
14
|
-
if (b === null)
|
|
15
|
-
return false;
|
|
16
|
-
const aKeys = Object.keys(a);
|
|
17
|
-
const bKeys = Object.keys(b);
|
|
18
|
-
if (aKeys.length !== bKeys.length)
|
|
19
|
-
return false;
|
|
20
|
-
for (const key of aKeys) {
|
|
21
|
-
if (!bKeys.includes(key))
|
|
22
|
-
return false;
|
|
23
|
-
if (!isEqual(a[key], b[key]))
|
|
24
|
-
return false;
|
|
25
|
-
}
|
|
26
|
-
return true;
|
|
1
|
+
import Observer from "./index5.mjs";
|
|
2
|
+
//#region src/Collection/Cursor.ts
|
|
3
|
+
/**
|
|
4
|
+
* Checks if the current scope is reactive, considering the provided reactivity adapter.
|
|
5
|
+
* @param reactivity - The reactivity adapter or a boolean indicating whether reactivity is enabled.
|
|
6
|
+
* @returns A boolean indicating if the current scope is reactive.
|
|
7
|
+
*/
|
|
8
|
+
function isInReactiveScope(reactivity) {
|
|
9
|
+
if (!reactivity) return false;
|
|
10
|
+
if (!reactivity.isInScope) return true;
|
|
11
|
+
return reactivity.isInScope();
|
|
27
12
|
}
|
|
28
|
-
|
|
29
|
-
|
|
13
|
+
/**
|
|
14
|
+
* Represents a cursor for querying and observing a filtered, sorted, and transformed
|
|
15
|
+
* subset of items from a collection. Supports reactivity and field tracking.
|
|
16
|
+
* @template T - The type of the items in the collection.
|
|
17
|
+
* @template U - The transformed item type after applying transform (default is T).
|
|
18
|
+
*/
|
|
19
|
+
var Cursor = class {
|
|
20
|
+
observer;
|
|
21
|
+
getItems;
|
|
22
|
+
options;
|
|
23
|
+
onCleanupCallbacks = [];
|
|
24
|
+
/**
|
|
25
|
+
* Creates a new instance of the `Cursor` class.
|
|
26
|
+
* Provides utilities for querying, observing, and transforming items from a collection.
|
|
27
|
+
* @template T - The type of the items in the collection.
|
|
28
|
+
* @template U - The transformed item type after applying transformations (default is T).
|
|
29
|
+
* @param getItems - A function that retrieves the filtered list of items.
|
|
30
|
+
* @param options - Optional configuration for the cursor.
|
|
31
|
+
* @param options.transform - A transformation function to apply to each item when retrieving them.
|
|
32
|
+
* @param options.bindEvents - A function to bind reactivity events for the cursor, which should return a cleanup function.
|
|
33
|
+
* @param options.fields - A projection object defining which fields of the item should be included or excluded.
|
|
34
|
+
* @param options.sort - A sort specifier to determine the order of the items.
|
|
35
|
+
* @param options.skip - The number of items to skip from the beginning of the result set.
|
|
36
|
+
* @param options.limit - The maximum number of items to return in the result set.
|
|
37
|
+
* @param options.reactive - A reactivity adapter to enable observing changes in the cursor's result set.
|
|
38
|
+
* @param options.fieldTracking - A boolean to enable fine-grained field tracking for reactivity.
|
|
39
|
+
* @param options.transformAll - A function that will be able to solve the n+1 problem
|
|
40
|
+
*/
|
|
41
|
+
constructor(getItems, options) {
|
|
42
|
+
this.getItems = getItems;
|
|
43
|
+
this.options = options || {};
|
|
44
|
+
}
|
|
45
|
+
addGetters(item) {
|
|
46
|
+
if (!isInReactiveScope(this.options.reactive)) return item;
|
|
47
|
+
const depend = this.depend.bind(this);
|
|
48
|
+
return Object.entries(item).reduce((memo, [key, value]) => {
|
|
49
|
+
Object.defineProperty(memo, key, {
|
|
50
|
+
get() {
|
|
51
|
+
depend({ changedField: (notify) => (changedItem, changedFieldName) => {
|
|
52
|
+
if (changedFieldName !== key || changedItem.id !== item.id) return;
|
|
53
|
+
notify();
|
|
54
|
+
} });
|
|
55
|
+
return value;
|
|
56
|
+
},
|
|
57
|
+
enumerable: true,
|
|
58
|
+
configurable: true
|
|
59
|
+
});
|
|
60
|
+
return memo;
|
|
61
|
+
}, {});
|
|
62
|
+
}
|
|
63
|
+
transform(rawItem) {
|
|
64
|
+
const item = this.options.fieldTracking ? this.addGetters(rawItem) : rawItem;
|
|
65
|
+
if (!this.options.transform) return item;
|
|
66
|
+
return this.options.transform(item);
|
|
67
|
+
}
|
|
68
|
+
depend(changeEvents, bindExtraNotifier) {
|
|
69
|
+
if (this.options?.async) return;
|
|
70
|
+
if (!isInReactiveScope(this.options.reactive)) console.warn("Cursor.depend() called outside of a reactive scope without async option; consider using { async: true } or wrapping in a reactive scope");
|
|
71
|
+
if (!this.options.reactive) return;
|
|
72
|
+
const signal = this.options.reactive.create();
|
|
73
|
+
signal.depend();
|
|
74
|
+
const notify = () => signal.notify();
|
|
75
|
+
/**
|
|
76
|
+
* Builds a notifier function for the specified event.
|
|
77
|
+
* @template Event - The type of the event.
|
|
78
|
+
* @param event - The event for which to build the notifier.
|
|
79
|
+
* @returns A function that handles the event and triggers the appropriate notifications.
|
|
80
|
+
*/
|
|
81
|
+
function buildNotifier(event) {
|
|
82
|
+
const eventHandler = changeEvents[event];
|
|
83
|
+
return (...args) => {
|
|
84
|
+
if (eventHandler === true) {
|
|
85
|
+
notify();
|
|
86
|
+
return;
|
|
87
|
+
}
|
|
88
|
+
if (typeof eventHandler !== "function") return;
|
|
89
|
+
eventHandler(notify)(...args);
|
|
90
|
+
};
|
|
91
|
+
}
|
|
92
|
+
const stop = this.observeRawChanges({
|
|
93
|
+
added: buildNotifier("added"),
|
|
94
|
+
addedBefore: buildNotifier("addedBefore"),
|
|
95
|
+
changed: buildNotifier("changed"),
|
|
96
|
+
changedField: buildNotifier("changedField"),
|
|
97
|
+
movedBefore: buildNotifier("movedBefore"),
|
|
98
|
+
removed: buildNotifier("removed")
|
|
99
|
+
}, true);
|
|
100
|
+
if (this.options.reactive.onDispose) this.options.reactive.onDispose(() => stop(), signal);
|
|
101
|
+
this.onCleanup(stop);
|
|
102
|
+
if (!bindExtraNotifier) return;
|
|
103
|
+
const stopExtraNotifier = bindExtraNotifier(notify);
|
|
104
|
+
if (this.options.reactive.onDispose) this.options.reactive.onDispose(() => stopExtraNotifier(), signal);
|
|
105
|
+
this.onCleanup(stopExtraNotifier);
|
|
106
|
+
}
|
|
107
|
+
ensureObserver() {
|
|
108
|
+
if (!this.observer) {
|
|
109
|
+
const observer = new Observer(() => {
|
|
110
|
+
const requery = () => {
|
|
111
|
+
observer.runChecks(this.getItems);
|
|
112
|
+
};
|
|
113
|
+
const applyDelta = (delta) => {
|
|
114
|
+
observer.applyDelta(delta, this.getItems);
|
|
115
|
+
};
|
|
116
|
+
const cleanup = this.options.bindEvents && this.options.bindEvents(requery, applyDelta);
|
|
117
|
+
return () => {
|
|
118
|
+
if (cleanup) cleanup();
|
|
119
|
+
};
|
|
120
|
+
});
|
|
121
|
+
this.onCleanup(() => observer.stop());
|
|
122
|
+
this.observer = observer;
|
|
123
|
+
}
|
|
124
|
+
return this.observer;
|
|
125
|
+
}
|
|
126
|
+
observeRawChanges(callbacks, skipInitial = false) {
|
|
127
|
+
const observer = this.ensureObserver();
|
|
128
|
+
observer.addCallbacks(callbacks, skipInitial);
|
|
129
|
+
observer.runChecks(this.getItems);
|
|
130
|
+
return () => {
|
|
131
|
+
observer.removeCallbacks(callbacks);
|
|
132
|
+
if (!observer.isEmpty()) return;
|
|
133
|
+
observer.stop();
|
|
134
|
+
this.observer = void 0;
|
|
135
|
+
};
|
|
136
|
+
}
|
|
137
|
+
/**
|
|
138
|
+
* Cleans up all resources associated with the cursor, such as reactive bindings
|
|
139
|
+
* and event listeners. This method should be called when the cursor is no longer needed
|
|
140
|
+
* to prevent memory leaks.
|
|
141
|
+
*/
|
|
142
|
+
cleanup() {
|
|
143
|
+
this.onCleanupCallbacks.forEach((callback) => {
|
|
144
|
+
callback();
|
|
145
|
+
});
|
|
146
|
+
this.onCleanupCallbacks = [];
|
|
147
|
+
}
|
|
148
|
+
/**
|
|
149
|
+
* Registers a cleanup callback to be executed when the `cleanup` method is called.
|
|
150
|
+
* Useful for managing resources and ensuring proper cleanup of bindings or listeners.
|
|
151
|
+
* @param callback - A function to be executed during cleanup.
|
|
152
|
+
*/
|
|
153
|
+
onCleanup(callback) {
|
|
154
|
+
this.onCleanupCallbacks.push(callback);
|
|
155
|
+
}
|
|
156
|
+
/**
|
|
157
|
+
* Iterates over each item in the cursor's result set, applying the provided callback
|
|
158
|
+
* function to each transformed item.
|
|
159
|
+
* ⚡️ this function is reactive!
|
|
160
|
+
* @param callback - A function to execute for each item in the result set.
|
|
161
|
+
* @param callback.item - The transformed item.
|
|
162
|
+
* @returns A promise that resolves when all items have been processed, or void if not in async mode.
|
|
163
|
+
*/
|
|
164
|
+
forEach(callback) {
|
|
165
|
+
this.depend({
|
|
166
|
+
addedBefore: true,
|
|
167
|
+
removed: true,
|
|
168
|
+
movedBefore: true,
|
|
169
|
+
...this.options.fieldTracking ? {} : { changed: true }
|
|
170
|
+
});
|
|
171
|
+
const executeForEach = (items) => {
|
|
172
|
+
items.forEach((item) => {
|
|
173
|
+
callback(this.transform(item));
|
|
174
|
+
});
|
|
175
|
+
};
|
|
176
|
+
const result = this.getItems();
|
|
177
|
+
if (result instanceof Promise) return result.then(executeForEach);
|
|
178
|
+
else {
|
|
179
|
+
executeForEach(result);
|
|
180
|
+
return;
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
/**
|
|
184
|
+
* Creates a new array populated with the results of applying the provided callback
|
|
185
|
+
* function to each transformed item in the cursor's result set.
|
|
186
|
+
* ⚡️ this function is reactive!
|
|
187
|
+
* @template V - The type of the items in the resulting array.
|
|
188
|
+
* @param callback - A function to execute for each item in the result set.
|
|
189
|
+
* @param callback.item - The transformed item.
|
|
190
|
+
* @returns An array of results after applying the callback to each item.
|
|
191
|
+
*/
|
|
192
|
+
map(callback) {
|
|
193
|
+
const results = [];
|
|
194
|
+
const maybePromise = this.forEach((item) => {
|
|
195
|
+
results.push(callback(item));
|
|
196
|
+
});
|
|
197
|
+
if (maybePromise instanceof Promise) return maybePromise.then(() => results);
|
|
198
|
+
return results;
|
|
199
|
+
}
|
|
200
|
+
/**
|
|
201
|
+
* Fetches all transformed items from the cursor's result set as an array.
|
|
202
|
+
* Automatically applies filtering, sorting, and limiting as per the cursor's options.
|
|
203
|
+
* ⚡️ this function is reactive!
|
|
204
|
+
* @returns An array of transformed items in the result set.
|
|
205
|
+
*/
|
|
206
|
+
fetch() {
|
|
207
|
+
return this.map((item) => item);
|
|
208
|
+
}
|
|
209
|
+
/**
|
|
210
|
+
* Counts the total number of items in the cursor's result set after applying
|
|
211
|
+
* filtering and other criteria.
|
|
212
|
+
* ⚡️ this function is reactive!
|
|
213
|
+
* @returns The total number of items in the result set.
|
|
214
|
+
*/
|
|
215
|
+
count() {
|
|
216
|
+
this.depend({
|
|
217
|
+
added: true,
|
|
218
|
+
removed: true
|
|
219
|
+
});
|
|
220
|
+
const maybePromise = this.getItems();
|
|
221
|
+
return maybePromise instanceof Promise ? maybePromise.then((items) => items.length) : maybePromise.length;
|
|
222
|
+
}
|
|
223
|
+
/**
|
|
224
|
+
* Whether this cursor's query has yet to deliver a first result.
|
|
225
|
+
* ⚡️ this function is reactive!
|
|
226
|
+
*
|
|
227
|
+
* An asynchronous data adapter answers a newly registered query only after a
|
|
228
|
+
* round trip, and serves a neutral empty result until it does — which a
|
|
229
|
+
* consumer cannot otherwise tell apart from "there is nothing to show". This
|
|
230
|
+
* is that distinction, per query rather than per collection, so one screen
|
|
231
|
+
* waiting on its own data says nothing about any other query.
|
|
232
|
+
*
|
|
233
|
+
* Follows the usual `isLoading`/`isFetching` split: it reports "no result
|
|
234
|
+
* yet", not "an execution is in flight". A write that re-runs an
|
|
235
|
+
* already-settled query drives it through `'active'` again while this stays
|
|
236
|
+
* `false`, so a list does not fall back to a loading state every time one of
|
|
237
|
+
* its rows changes.
|
|
238
|
+
*
|
|
239
|
+
* A query that fails counts as settled — the `query.error` event on the
|
|
240
|
+
* collection is what surfaces the failure, and a loading state that never
|
|
241
|
+
* ends is the worse answer. Reading this registers the query if nothing else
|
|
242
|
+
* has, so it cannot wait on something nobody asked for. It is always `false`
|
|
243
|
+
* for an `{ async: true }` cursor, whose `fetch()` awaits the real result
|
|
244
|
+
* anyway, and for a data adapter that answers synchronously.
|
|
245
|
+
* @returns A boolean indicating whether the first result is still pending.
|
|
246
|
+
*/
|
|
247
|
+
isLoading() {
|
|
248
|
+
const queryState = this.options.queryState;
|
|
249
|
+
if (!queryState || this.options.async) return false;
|
|
250
|
+
this.depend({}, (notify) => queryState.onSettled(notify));
|
|
251
|
+
return !queryState.hasSettled();
|
|
252
|
+
}
|
|
253
|
+
/**
|
|
254
|
+
* Observes changes to the cursor's result set and triggers the specified callbacks
|
|
255
|
+
* when items are added, removed, or updated. Supports reactivity and transformation.
|
|
256
|
+
* @param callbacks - An object containing the callback functions to handle different change events.
|
|
257
|
+
* @param callbacks.added - Triggered when an item is added to the result set.
|
|
258
|
+
* @param callbacks.removed - Triggered when an item is removed from the result set.
|
|
259
|
+
* @param callbacks.changed - Triggered when an item in the result set is modified.
|
|
260
|
+
* @param callbacks.addedBefore - Triggered when an item is added before another item in the result set.
|
|
261
|
+
* @param callbacks.movedBefore - Triggered when an item is moved before another item in the result set.
|
|
262
|
+
* @param callbacks.changedField - Triggered when a specific field of an item changes.
|
|
263
|
+
* @param skipInitial - A boolean indicating whether to skip the initial notification of the current result set.
|
|
264
|
+
* @returns A function to stop observing changes.
|
|
265
|
+
*/
|
|
266
|
+
observeChanges(callbacks, skipInitial = false) {
|
|
267
|
+
return this.observeRawChanges(Object.entries(callbacks).reduce((memo, [callbackName, callback]) => {
|
|
268
|
+
if (!callback) return memo;
|
|
269
|
+
return {
|
|
270
|
+
...memo,
|
|
271
|
+
[callbackName]: (item, before) => {
|
|
272
|
+
const transformedValue = this.transform(item);
|
|
273
|
+
const hasBeforeParameter = before !== void 0;
|
|
274
|
+
const transformedBeforeValue = hasBeforeParameter && before ? this.transform(before) : null;
|
|
275
|
+
return callback(transformedValue, ...hasBeforeParameter ? [transformedBeforeValue] : []);
|
|
276
|
+
}
|
|
277
|
+
};
|
|
278
|
+
}, {}), skipInitial);
|
|
279
|
+
}
|
|
280
|
+
/**
|
|
281
|
+
* Forces the cursor to re-evaluate its result set by re-fetching items
|
|
282
|
+
* from the collection. This is useful when the underlying data or query
|
|
283
|
+
* criteria have changed, and you want to ensure the cursor reflects the latest state.
|
|
284
|
+
*/
|
|
285
|
+
requery() {
|
|
286
|
+
if (!this.observer) return;
|
|
287
|
+
this.observer.runChecks(this.getItems);
|
|
288
|
+
}
|
|
289
|
+
/**
|
|
290
|
+
* Brings the cursor up to date from a description of what changed, rather than by re-running the
|
|
291
|
+
* query and comparing the result with the previous one.
|
|
292
|
+
*
|
|
293
|
+
* Falls back to `requery` when the delta does not fit the result the cursor currently holds, so
|
|
294
|
+
* a caller never has to decide which of the two is safe.
|
|
295
|
+
* @param delta - The change to apply.
|
|
296
|
+
*/
|
|
297
|
+
applyDelta(delta) {
|
|
298
|
+
if (!this.observer) return;
|
|
299
|
+
this.observer.applyDelta(delta, this.getItems);
|
|
300
|
+
}
|
|
30
301
|
};
|
|
302
|
+
//#endregion
|
|
303
|
+
export { Cursor as default };
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
//#region src/utils/EventEmitter.ts
|
|
2
|
+
/**
|
|
3
|
+
* A strongly‑typed EventEmitter.
|
|
4
|
+
*/
|
|
5
|
+
var EventEmitter = class {
|
|
6
|
+
_maxListeners = 100;
|
|
7
|
+
/**
|
|
8
|
+
* We store a set of the listeners for each event.
|
|
9
|
+
*/
|
|
10
|
+
_listenerStore = /* @__PURE__ */ new Map();
|
|
11
|
+
setMaxListeners(max) {
|
|
12
|
+
this._maxListeners = max;
|
|
13
|
+
return this;
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Subscribe to an event with a listener function.
|
|
17
|
+
* @param eventName The event name (key of E).
|
|
18
|
+
* @param listener A function that receives the emitted arguments.
|
|
19
|
+
* @returns The emitter instance (for chaining).
|
|
20
|
+
*/
|
|
21
|
+
on(eventName, listener) {
|
|
22
|
+
let listenersSet = this._listenerStore.get(eventName);
|
|
23
|
+
if (!listenersSet) {
|
|
24
|
+
listenersSet = /* @__PURE__ */ new Set();
|
|
25
|
+
this._listenerStore.set(eventName, listenersSet);
|
|
26
|
+
}
|
|
27
|
+
listenersSet.add(listener);
|
|
28
|
+
if (listenersSet.size > this._maxListeners) console.warn(`Possible EventEmitter memory leak detected. ${listenersSet.size} ${String(eventName)} listeners added. Use emitter.setMaxListeners() to increase limit.`);
|
|
29
|
+
return this;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Subscribe to an event with a listener function.
|
|
33
|
+
* @param eventName The event name (key of E).
|
|
34
|
+
* @param listener A function that receives the emitted arguments.
|
|
35
|
+
* @returns The emitter instance (for chaining).
|
|
36
|
+
*/
|
|
37
|
+
addListener(eventName, listener) {
|
|
38
|
+
return this.on(eventName, listener);
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Subscribe to an event, handling it only once. Automatically removes
|
|
42
|
+
* the listener after it fires the first time.
|
|
43
|
+
* @param eventName The event name (key of E).
|
|
44
|
+
* @param listener A function that receives the emitted arguments.
|
|
45
|
+
* @returns The emitter instance (for chaining).
|
|
46
|
+
*/
|
|
47
|
+
once(eventName, listener) {
|
|
48
|
+
const onceWrapper = ((...args) => {
|
|
49
|
+
listener(...args);
|
|
50
|
+
this.off(eventName, onceWrapper);
|
|
51
|
+
});
|
|
52
|
+
return this.on(eventName, onceWrapper);
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Unsubscribe a previously subscribed listener.
|
|
56
|
+
* @param eventName The event name (key of E).
|
|
57
|
+
* @param listener The original function passed to `on` or `once`.
|
|
58
|
+
* @returns The emitter instance (for chaining).
|
|
59
|
+
*/
|
|
60
|
+
off(eventName, listener) {
|
|
61
|
+
const listenersSet = this._listenerStore.get(eventName);
|
|
62
|
+
if (!listenersSet) return this;
|
|
63
|
+
listenersSet.delete(listener);
|
|
64
|
+
if (listenersSet.size === 0) this._listenerStore.delete(eventName);
|
|
65
|
+
return this;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* Unsubscribe a previously subscribed listener.
|
|
69
|
+
* @param eventName The event name (key of E).
|
|
70
|
+
* @param listener The original function passed to `on` or `once`.
|
|
71
|
+
* @returns The emitter instance (for chaining).
|
|
72
|
+
*/
|
|
73
|
+
removeListener(eventName, listener) {
|
|
74
|
+
return this.off(eventName, listener);
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* Emit (dispatch) an event with a variable number of arguments.
|
|
78
|
+
* @param eventName The event name (key of E).
|
|
79
|
+
* @param args The arguments to pass to subscribed listeners.
|
|
80
|
+
*/
|
|
81
|
+
emit(eventName, ...args) {
|
|
82
|
+
this.listeners(eventName).forEach((listener) => {
|
|
83
|
+
listener(...args);
|
|
84
|
+
});
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* Returns the array of listener functions currently registered for a given event.
|
|
88
|
+
* @param eventName The event name (key of E).
|
|
89
|
+
* @returns An array of listener functions.
|
|
90
|
+
*/
|
|
91
|
+
listeners(eventName) {
|
|
92
|
+
const listenersSet = this._listenerStore.get(eventName);
|
|
93
|
+
if (!listenersSet) return [];
|
|
94
|
+
return [...listenersSet.values()];
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* Returns the number of listeners for a given event.
|
|
98
|
+
* @param eventName The event name (key of E).
|
|
99
|
+
* @returns The number of listeners.
|
|
100
|
+
*/
|
|
101
|
+
listenerCount(eventName) {
|
|
102
|
+
const listenersSet = this._listenerStore.get(eventName);
|
|
103
|
+
return listenersSet ? listenersSet.size : 0;
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Removes all listeners for a given event, or all events if none is specified.
|
|
107
|
+
* @param eventName Optional. If omitted, clears all events’ listeners.
|
|
108
|
+
* @returns The emitter instance (for chaining).
|
|
109
|
+
*/
|
|
110
|
+
removeAllListeners(eventName) {
|
|
111
|
+
if (eventName === void 0) {
|
|
112
|
+
for (const [eventName_, listenersSet] of this._listenerStore.entries()) for (const listener of listenersSet.values()) this.off(eventName_, listener);
|
|
113
|
+
this._listenerStore.clear();
|
|
114
|
+
} else {
|
|
115
|
+
const listenersSet = this._listenerStore.get(eventName);
|
|
116
|
+
if (listenersSet) {
|
|
117
|
+
for (const listener of listenersSet.values()) this.off(eventName, listener);
|
|
118
|
+
this._listenerStore.delete(eventName);
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
return this;
|
|
122
|
+
}
|
|
123
|
+
};
|
|
124
|
+
//#endregion
|
|
125
|
+
exports.default = EventEmitter;
|
package/dist/index7.mjs
CHANGED
|
@@ -1,13 +1,125 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
1
|
+
//#region src/utils/EventEmitter.ts
|
|
2
|
+
/**
|
|
3
|
+
* A strongly‑typed EventEmitter.
|
|
4
|
+
*/
|
|
5
|
+
var EventEmitter = class {
|
|
6
|
+
_maxListeners = 100;
|
|
7
|
+
/**
|
|
8
|
+
* We store a set of the listeners for each event.
|
|
9
|
+
*/
|
|
10
|
+
_listenerStore = /* @__PURE__ */ new Map();
|
|
11
|
+
setMaxListeners(max) {
|
|
12
|
+
this._maxListeners = max;
|
|
13
|
+
return this;
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Subscribe to an event with a listener function.
|
|
17
|
+
* @param eventName The event name (key of E).
|
|
18
|
+
* @param listener A function that receives the emitted arguments.
|
|
19
|
+
* @returns The emitter instance (for chaining).
|
|
20
|
+
*/
|
|
21
|
+
on(eventName, listener) {
|
|
22
|
+
let listenersSet = this._listenerStore.get(eventName);
|
|
23
|
+
if (!listenersSet) {
|
|
24
|
+
listenersSet = /* @__PURE__ */ new Set();
|
|
25
|
+
this._listenerStore.set(eventName, listenersSet);
|
|
26
|
+
}
|
|
27
|
+
listenersSet.add(listener);
|
|
28
|
+
if (listenersSet.size > this._maxListeners) console.warn(`Possible EventEmitter memory leak detected. ${listenersSet.size} ${String(eventName)} listeners added. Use emitter.setMaxListeners() to increase limit.`);
|
|
29
|
+
return this;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Subscribe to an event with a listener function.
|
|
33
|
+
* @param eventName The event name (key of E).
|
|
34
|
+
* @param listener A function that receives the emitted arguments.
|
|
35
|
+
* @returns The emitter instance (for chaining).
|
|
36
|
+
*/
|
|
37
|
+
addListener(eventName, listener) {
|
|
38
|
+
return this.on(eventName, listener);
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Subscribe to an event, handling it only once. Automatically removes
|
|
42
|
+
* the listener after it fires the first time.
|
|
43
|
+
* @param eventName The event name (key of E).
|
|
44
|
+
* @param listener A function that receives the emitted arguments.
|
|
45
|
+
* @returns The emitter instance (for chaining).
|
|
46
|
+
*/
|
|
47
|
+
once(eventName, listener) {
|
|
48
|
+
const onceWrapper = ((...args) => {
|
|
49
|
+
listener(...args);
|
|
50
|
+
this.off(eventName, onceWrapper);
|
|
51
|
+
});
|
|
52
|
+
return this.on(eventName, onceWrapper);
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Unsubscribe a previously subscribed listener.
|
|
56
|
+
* @param eventName The event name (key of E).
|
|
57
|
+
* @param listener The original function passed to `on` or `once`.
|
|
58
|
+
* @returns The emitter instance (for chaining).
|
|
59
|
+
*/
|
|
60
|
+
off(eventName, listener) {
|
|
61
|
+
const listenersSet = this._listenerStore.get(eventName);
|
|
62
|
+
if (!listenersSet) return this;
|
|
63
|
+
listenersSet.delete(listener);
|
|
64
|
+
if (listenersSet.size === 0) this._listenerStore.delete(eventName);
|
|
65
|
+
return this;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* Unsubscribe a previously subscribed listener.
|
|
69
|
+
* @param eventName The event name (key of E).
|
|
70
|
+
* @param listener The original function passed to `on` or `once`.
|
|
71
|
+
* @returns The emitter instance (for chaining).
|
|
72
|
+
*/
|
|
73
|
+
removeListener(eventName, listener) {
|
|
74
|
+
return this.off(eventName, listener);
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* Emit (dispatch) an event with a variable number of arguments.
|
|
78
|
+
* @param eventName The event name (key of E).
|
|
79
|
+
* @param args The arguments to pass to subscribed listeners.
|
|
80
|
+
*/
|
|
81
|
+
emit(eventName, ...args) {
|
|
82
|
+
this.listeners(eventName).forEach((listener) => {
|
|
83
|
+
listener(...args);
|
|
84
|
+
});
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* Returns the array of listener functions currently registered for a given event.
|
|
88
|
+
* @param eventName The event name (key of E).
|
|
89
|
+
* @returns An array of listener functions.
|
|
90
|
+
*/
|
|
91
|
+
listeners(eventName) {
|
|
92
|
+
const listenersSet = this._listenerStore.get(eventName);
|
|
93
|
+
if (!listenersSet) return [];
|
|
94
|
+
return [...listenersSet.values()];
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* Returns the number of listeners for a given event.
|
|
98
|
+
* @param eventName The event name (key of E).
|
|
99
|
+
* @returns The number of listeners.
|
|
100
|
+
*/
|
|
101
|
+
listenerCount(eventName) {
|
|
102
|
+
const listenersSet = this._listenerStore.get(eventName);
|
|
103
|
+
return listenersSet ? listenersSet.size : 0;
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Removes all listeners for a given event, or all events if none is specified.
|
|
107
|
+
* @param eventName Optional. If omitted, clears all events’ listeners.
|
|
108
|
+
* @returns The emitter instance (for chaining).
|
|
109
|
+
*/
|
|
110
|
+
removeAllListeners(eventName) {
|
|
111
|
+
if (eventName === void 0) {
|
|
112
|
+
for (const [eventName_, listenersSet] of this._listenerStore.entries()) for (const listener of listenersSet.values()) this.off(eventName_, listener);
|
|
113
|
+
this._listenerStore.clear();
|
|
114
|
+
} else {
|
|
115
|
+
const listenersSet = this._listenerStore.get(eventName);
|
|
116
|
+
if (listenersSet) {
|
|
117
|
+
for (const listener of listenersSet.values()) this.off(eventName, listener);
|
|
118
|
+
this._listenerStore.delete(eventName);
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
return this;
|
|
122
|
+
}
|
|
13
123
|
};
|
|
124
|
+
//#endregion
|
|
125
|
+
export { EventEmitter as default };
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
//#region src/utils/createSignal.ts
|
|
2
|
+
/**
|
|
3
|
+
* Creates a reactive signal for managing state and triggering dependencies.
|
|
4
|
+
* The signal holds a value and provides methods to get and set the value,
|
|
5
|
+
* with optional equality checks and dependency tracking.
|
|
6
|
+
* @template T - The type of the value held by the signal.
|
|
7
|
+
* @param reactivityAdapter - An optional reactivity adapter for managing dependencies.
|
|
8
|
+
* @param initialValue - The initial value of the signal.
|
|
9
|
+
* @param isEqual - A custom equality function to determine if the new value is different
|
|
10
|
+
* from the current value (default is `Object.is`).
|
|
11
|
+
* @returns A signal object with `get` and `set` methods to manage the value.
|
|
12
|
+
*/
|
|
13
|
+
function createSignal(reactivityAdapter, initialValue, isEqual = Object.is) {
|
|
14
|
+
let value = initialValue;
|
|
15
|
+
const dependency = reactivityAdapter?.create();
|
|
16
|
+
const isInReactiveScope = () => {
|
|
17
|
+
if (!reactivityAdapter?.isInScope) return true;
|
|
18
|
+
return reactivityAdapter.isInScope();
|
|
19
|
+
};
|
|
20
|
+
return {
|
|
21
|
+
get() {
|
|
22
|
+
if (dependency && isInReactiveScope()) dependency.depend();
|
|
23
|
+
return value;
|
|
24
|
+
},
|
|
25
|
+
set(newValue) {
|
|
26
|
+
if (isEqual(value, newValue)) return;
|
|
27
|
+
value = newValue;
|
|
28
|
+
if (dependency) dependency.notify();
|
|
29
|
+
}
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
//#endregion
|
|
33
|
+
exports.default = createSignal;
|
package/dist/index8.mjs
CHANGED
|
@@ -1,6 +1,33 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
1
|
+
//#region src/utils/createSignal.ts
|
|
2
|
+
/**
|
|
3
|
+
* Creates a reactive signal for managing state and triggering dependencies.
|
|
4
|
+
* The signal holds a value and provides methods to get and set the value,
|
|
5
|
+
* with optional equality checks and dependency tracking.
|
|
6
|
+
* @template T - The type of the value held by the signal.
|
|
7
|
+
* @param reactivityAdapter - An optional reactivity adapter for managing dependencies.
|
|
8
|
+
* @param initialValue - The initial value of the signal.
|
|
9
|
+
* @param isEqual - A custom equality function to determine if the new value is different
|
|
10
|
+
* from the current value (default is `Object.is`).
|
|
11
|
+
* @returns A signal object with `get` and `set` methods to manage the value.
|
|
12
|
+
*/
|
|
13
|
+
function createSignal(reactivityAdapter, initialValue, isEqual = Object.is) {
|
|
14
|
+
let value = initialValue;
|
|
15
|
+
const dependency = reactivityAdapter?.create();
|
|
16
|
+
const isInReactiveScope = () => {
|
|
17
|
+
if (!reactivityAdapter?.isInScope) return true;
|
|
18
|
+
return reactivityAdapter.isInScope();
|
|
19
|
+
};
|
|
20
|
+
return {
|
|
21
|
+
get() {
|
|
22
|
+
if (dependency && isInReactiveScope()) dependency.depend();
|
|
23
|
+
return value;
|
|
24
|
+
},
|
|
25
|
+
set(newValue) {
|
|
26
|
+
if (isEqual(value, newValue)) return;
|
|
27
|
+
value = newValue;
|
|
28
|
+
if (dependency) dependency.notify();
|
|
29
|
+
}
|
|
30
|
+
};
|
|
3
31
|
}
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
};
|
|
32
|
+
//#endregion
|
|
33
|
+
export { createSignal as default };
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
//#region src/utils/randomId.ts
|
|
2
|
+
/**
|
|
3
|
+
* creates a random id
|
|
4
|
+
* @returns a random string of 16 characters
|
|
5
|
+
* @example
|
|
6
|
+
* randomId() // '1234567890abcdef'
|
|
7
|
+
*/
|
|
8
|
+
function randomId() {
|
|
9
|
+
return Array.from({ length: 16 }, () => "abcdefghijklmnopqrstuvwxyz0123456789"[Math.floor(Math.random() * 36)]).join("");
|
|
10
|
+
}
|
|
11
|
+
//#endregion
|
|
12
|
+
exports.default = randomId;
|