doxum 0.1.8 → 0.1.9

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 (70) hide show
  1. package/README.md +215 -322
  2. package/dist/contract-BNStLbSE.d.ts +441 -0
  3. package/dist/contract-CIU5FCC1.d.cts +441 -0
  4. package/dist/driver-BlR81Dqg.js +200 -0
  5. package/dist/driver-BlR81Dqg.js.map +1 -0
  6. package/dist/driver-xOIkwrB8.cjs +241 -0
  7. package/dist/driver-xOIkwrB8.cjs.map +1 -0
  8. package/dist/index.cjs +666 -2222
  9. package/dist/index.cjs.map +1 -1
  10. package/dist/index.d.cts +10 -20
  11. package/dist/index.d.ts +10 -18
  12. package/dist/index.js +634 -2189
  13. package/dist/index.js.map +1 -1
  14. package/dist/{integration-CZwCwFBS.cjs → integration-C87tjRop.cjs} +4 -9
  15. package/dist/integration-C87tjRop.cjs.map +1 -0
  16. package/dist/{integration-B56u1l9V.js → integration-D5XCBLJ8.js} +2 -7
  17. package/dist/integration-D5XCBLJ8.js.map +1 -0
  18. package/dist/integration.cjs +11 -11
  19. package/dist/integration.d.cts +10 -4
  20. package/dist/integration.d.ts +10 -4
  21. package/dist/integration.js +4 -3
  22. package/dist/issue-DVaGQGeP.js +576 -0
  23. package/dist/issue-DVaGQGeP.js.map +1 -0
  24. package/dist/issue-DhrNdQNg.cjs +797 -0
  25. package/dist/issue-DhrNdQNg.cjs.map +1 -0
  26. package/dist/local-sync.cjs +67 -39
  27. package/dist/local-sync.cjs.map +1 -1
  28. package/dist/local-sync.d.cts +10 -10
  29. package/dist/local-sync.d.ts +10 -10
  30. package/dist/local-sync.js +66 -38
  31. package/dist/local-sync.js.map +1 -1
  32. package/dist/react.cjs +23 -4
  33. package/dist/react.cjs.map +1 -1
  34. package/dist/react.d.cts +8 -3
  35. package/dist/react.d.ts +8 -3
  36. package/dist/react.js +21 -6
  37. package/dist/react.js.map +1 -1
  38. package/dist/store-1Uob0Ghk.cjs +2750 -0
  39. package/dist/store-1Uob0Ghk.cjs.map +1 -0
  40. package/dist/store-CD0KdGsq.d.cts +262 -0
  41. package/dist/store-D7QH6Rzw.js +2511 -0
  42. package/dist/store-D7QH6Rzw.js.map +1 -0
  43. package/dist/store-cp5CpfCy.d.ts +262 -0
  44. package/package.json +1 -1
  45. package/skills/doxum-runtime/SKILL.md +26 -44
  46. package/skills/doxum-runtime/references/guide.en.md +95 -366
  47. package/skills/doxum-runtime/references/guide.zh-CN.md +80 -290
  48. package/skills/doxum-runtime/references/invariants.en.md +42 -165
  49. package/skills/doxum-runtime/references/invariants.zh-CN.md +34 -97
  50. package/skills/doxum-runtime/references/patterns.en.md +73 -225
  51. package/skills/doxum-runtime/references/patterns.zh-CN.md +73 -179
  52. package/dist/chunk-pbuEa-1d.js +0 -13
  53. package/dist/contract-CIcftgR3.d.ts +0 -561
  54. package/dist/contract-b87yPRDp.d.cts +0 -561
  55. package/dist/driver-CNxqMVFH.cjs +0 -69
  56. package/dist/driver-CNxqMVFH.cjs.map +0 -1
  57. package/dist/driver-CbzfW5MR.js +0 -46
  58. package/dist/driver-CbzfW5MR.js.map +0 -1
  59. package/dist/integration-B56u1l9V.js.map +0 -1
  60. package/dist/integration-CZwCwFBS.cjs.map +0 -1
  61. package/dist/ownership-CY0nPXGF.cjs +0 -304
  62. package/dist/ownership-CY0nPXGF.cjs.map +0 -1
  63. package/dist/ownership-CduRygE7.js +0 -245
  64. package/dist/ownership-CduRygE7.js.map +0 -1
  65. package/dist/runtime-0mOFbe_H.cjs +0 -2439
  66. package/dist/runtime-0mOFbe_H.cjs.map +0 -1
  67. package/dist/runtime-BzxODO9Q.d.ts +0 -150
  68. package/dist/runtime-CRVMB9n1.d.cts +0 -150
  69. package/dist/runtime-DF1q9Gje.js +0 -2129
  70. package/dist/runtime-DF1q9Gje.js.map +0 -1
@@ -1,2439 +0,0 @@
1
- //#region \0rolldown/runtime.js
2
- var __defProp = Object.defineProperty;
3
- var __exportAll = (all, no_symbols) => {
4
- let target = {};
5
- for (var name in all) __defProp(target, name, {
6
- get: all[name],
7
- enumerable: true
8
- });
9
- if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
10
- return target;
11
- };
12
- //#endregion
13
- const require_ownership = require("./ownership-CY0nPXGF.cjs");
14
- //#region core/src/schema.ts
15
- const node = (value) => Object.freeze(value);
16
- const field = () => node({ kind: "field" });
17
- const optional = (value) => {
18
- if (![
19
- "field",
20
- "variant",
21
- "dict",
22
- "list",
23
- "tree"
24
- ].includes(value.kind)) throw new TypeError("Only field, variant, dict, list and tree nodes support optional presence.");
25
- return node({
26
- ...value,
27
- optional: true
28
- });
29
- };
30
- const object = (shape) => node({
31
- kind: "object",
32
- shape
33
- });
34
- const variant = (tag, variants) => node({
35
- kind: "variant",
36
- tag,
37
- variants
38
- });
39
- const table = (value) => node({
40
- kind: "table",
41
- value
42
- });
43
- const map = (value) => node({
44
- kind: "map",
45
- value
46
- });
47
- const dict = () => node({ kind: "dict" });
48
- const list = (config) => ({
49
- kind: "list",
50
- keyOf: config.keyOf
51
- });
52
- const tree = () => node({ kind: "tree" });
53
- const paths = /* @__PURE__ */ new WeakMap();
54
- const collectionSchemas = /* @__PURE__ */ new WeakMap();
55
- const collectionSchema = (selector) => {
56
- const node = collectionSchemas.get(selector);
57
- if (!node) throw new TypeError("Expected a schema-owned collection selector.");
58
- return node;
59
- };
60
- const pathProxy = (nodes, address, owner) => {
61
- const proxy = new Proxy({}, { get: (_target, property) => {
62
- if (typeof property !== "string") return void 0;
63
- if (nodes.every((node) => node.kind === "table" || node.kind === "map") && property === "item") return (id) => {
64
- if (typeof id !== "string") throw new TypeError("Collection keys must be strings.");
65
- return pathProxy(nodes.map((node) => node.value), [...address, id], owner);
66
- };
67
- const children = nodes.flatMap((node) => {
68
- if (node.kind === "object") return node.shape[property] ? [node.shape[property]] : [];
69
- if (node.kind !== "variant") return [];
70
- if (property === node.tag) return [field()];
71
- return Object.values(node.variants).flatMap((branch) => branch.shape[property] ? [branch.shape[property]] : []);
72
- });
73
- if (!children.length) throw new TypeError(`Invalid schema path segment: ${property}`);
74
- return pathProxy(children, [...address, property], owner);
75
- } });
76
- paths.set(proxy, {
77
- nodes,
78
- address,
79
- owner
80
- });
81
- return proxy;
82
- };
83
- const select = (owner, kind, pick) => {
84
- const scope = {};
85
- const value = pick(pathProxy([object(owner.shape)], [], scope));
86
- const selected = typeof value === "object" && value !== null ? paths.get(value) : void 0;
87
- if (!selected || selected.owner !== scope) throw new TypeError("Selector must return a path from its callback.");
88
- if (kind === "collection" && !selected.nodes.every((node) => node.kind === "table" || node.kind === "map")) throw new TypeError("Collection selectors require a table or map path.");
89
- const result = Object.freeze({
90
- kind,
91
- schema: owner,
92
- address: Object.freeze([...selected.address])
93
- });
94
- if (kind === "collection") collectionSchemas.set(result, selected.nodes[0]);
95
- return result;
96
- };
97
- const schema = (shape) => {
98
- const result = {
99
- kind: "schema",
100
- shape,
101
- collection: (pick) => select(result, "collection", pick),
102
- value: (pick) => select(result, "value", pick)
103
- };
104
- return Object.freeze(result);
105
- };
106
- //#endregion
107
- //#region core/src/address.ts
108
- const registries = /* @__PURE__ */ new WeakMap();
109
- const registryNode = () => ({ static: /* @__PURE__ */ new Map() });
110
- const registryFor = (schema) => {
111
- const cached = registries.get(schema);
112
- if (cached) return cached;
113
- const registry = {
114
- root: registryNode(),
115
- nextPath: 0
116
- };
117
- registries.set(schema, registry);
118
- return registry;
119
- };
120
- const hashText = (value, seed) => {
121
- let hash = seed;
122
- for (let index = 0; index < value.length; index += 1) hash = Math.imul(hash ^ value.charCodeAt(index), 16777619);
123
- return hash >>> 0;
124
- };
125
- const appendAddressHash = (hash, segment) => hashText(segment, hashText("/", hash));
126
- const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
127
- const variantNode = (node, value) => {
128
- const tag = isRecord(value) && typeof value[node.tag] === "string" ? value[node.tag] : void 0;
129
- return node.variants[String(tag ?? Object.keys(node.variants)[0] ?? "")];
130
- };
131
- const schemaRoot$1 = (schema) => ({
132
- kind: "object",
133
- shape: schema.shape
134
- });
135
- const step = (nodeInput, value, segment) => {
136
- let node = nodeInput;
137
- if (!node) return {
138
- node: void 0,
139
- dynamic: false
140
- };
141
- if (node.kind === "variant") node = variantNode(node, value);
142
- if (!node) return {
143
- node: void 0,
144
- dynamic: false
145
- };
146
- if (node.kind === "object") return {
147
- node: node.shape[segment],
148
- dynamic: false
149
- };
150
- if (node.kind === "table" || node.kind === "map") return {
151
- node: node.value,
152
- dynamic: true
153
- };
154
- if (node.kind === "dict" || node.kind === "list" || node.kind === "tree") return {
155
- node,
156
- dynamic: true
157
- };
158
- return {
159
- node: void 0,
160
- dynamic: false
161
- };
162
- };
163
- const pathFor = (schema, address, document) => {
164
- const registry = registryFor(schema);
165
- let trie = registry.root;
166
- let node = schemaRoot$1(schema);
167
- let value = document;
168
- for (const segment of address) {
169
- require_ownership.profile.address.schemaStep();
170
- require_ownership.profile.address.documentStep();
171
- const resolved = step(node, value, segment);
172
- if (!resolved.node) return void 0;
173
- trie = resolved.dynamic ? trie.dynamic ??= registryNode() : (() => {
174
- const existing = trie.static.get(segment);
175
- if (existing) return existing;
176
- const created = registryNode();
177
- trie.static.set(segment, created);
178
- return created;
179
- })();
180
- node = resolved.node;
181
- value = readSegment(value, segment);
182
- }
183
- if (trie.path === void 0) trie.path = registry.nextPath++;
184
- return trie.path;
185
- };
186
- const resolveAddress = (schema, address, document) => {
187
- if (!Array.isArray(address)) return void 0;
188
- for (const segment of address) if (typeof segment !== "string") return void 0;
189
- require_ownership.profile.address.arrayCopied();
190
- const owned = Object.freeze(address.slice());
191
- const path = pathFor(schema, owned, document);
192
- return path === void 0 ? void 0 : {
193
- path,
194
- address: owned
195
- };
196
- };
197
- const nodeAt = (schema, address, document) => {
198
- let node = schemaRoot$1(schema);
199
- let value = document;
200
- for (const segment of address) {
201
- node = step(node, value, segment).node;
202
- value = readSegment(value, segment);
203
- if (!node) return void 0;
204
- }
205
- return node;
206
- };
207
- const readSegment = (value, segment) => {
208
- if (!isRecord(value) && !Array.isArray(value)) return void 0;
209
- if (isRecord(value) && "byId" in value && isRecord(value.byId)) {
210
- const entity = value.byId[segment];
211
- if (entity !== void 0 || Object.prototype.hasOwnProperty.call(value.byId, segment)) return entity;
212
- }
213
- return value[segment];
214
- };
215
- const read = (root, address) => {
216
- let value = root;
217
- for (const segment of address) {
218
- value = readSegment(value, segment);
219
- if (value === void 0) return void 0;
220
- }
221
- return value;
222
- };
223
- /** Resolves schema and document location in one address traversal. */
224
- const resolveLocated = (schema, root, address) => {
225
- if (address.length === 0) return void 0;
226
- let node = schemaRoot$1(schema);
227
- let current = root;
228
- let collection;
229
- let addressHash = 2166136261;
230
- for (let index = 0; index < address.length - 1; index += 1) {
231
- require_ownership.profile.address.schemaStep();
232
- require_ownership.profile.address.documentStep();
233
- const resolved = step(node, current, address[index]);
234
- if (!resolved.node) return void 0;
235
- if (node?.kind === "table" || node?.kind === "map") collection = {
236
- address: address.slice(0, index),
237
- addressHash,
238
- id: address[index],
239
- ...collection ? { parent: collection } : {}
240
- };
241
- addressHash = appendAddressHash(addressHash, address[index]);
242
- node = resolved.node;
243
- current = readSegment(current, address[index]);
244
- if (!node) return void 0;
245
- }
246
- require_ownership.profile.address.schemaStep();
247
- require_ownership.profile.address.documentStep();
248
- const last = address[address.length - 1];
249
- const resolved = step(node, current, last);
250
- if (!resolved.node || !isRecord(current) && !Array.isArray(current)) return void 0;
251
- if (node?.kind === "table" || node?.kind === "map") collection = {
252
- address: address.slice(0, -1),
253
- addressHash,
254
- id: last,
255
- ...collection ? { parent: collection } : {}
256
- };
257
- addressHash = appendAddressHash(addressHash, last);
258
- if (isRecord(current) && "byId" in current && isRecord(current.byId) && last in current.byId) return {
259
- addressHash,
260
- node: resolved.node,
261
- parent: current.byId,
262
- key: last,
263
- value: current.byId[last],
264
- ...collection ? { collection } : {}
265
- };
266
- return {
267
- addressHash,
268
- node: resolved.node,
269
- parent: current,
270
- key: Array.isArray(current) && /^\d+$/.test(last) ? Number(last) : last,
271
- value: readSegment(current, last),
272
- ...collection ? { collection } : {}
273
- };
274
- };
275
- const locate = (root, address) => {
276
- if (address.length === 0) return void 0;
277
- let current = root;
278
- for (let index = 0; index < address.length - 1; index += 1) current = readSegment(current, address[index]);
279
- if (!isRecord(current) && !Array.isArray(current)) return void 0;
280
- const last = address[address.length - 1];
281
- if (isRecord(current) && "byId" in current && isRecord(current.byId) && last in current.byId) return {
282
- parent: current.byId,
283
- key: last,
284
- value: current.byId[last]
285
- };
286
- return {
287
- parent: current,
288
- key: Array.isArray(current) && /^\d+$/.test(last) ? Number(last) : last,
289
- value: readSegment(current, last)
290
- };
291
- };
292
- const set = (root, address, value) => {
293
- const target = locate(root, address);
294
- if (!target) return false;
295
- target.parent[target.key] = value;
296
- return true;
297
- };
298
- const contains = (parent, child) => {
299
- require_ownership.profile.address.prefixComparison();
300
- if (parent.length > child.length) return false;
301
- for (let index = 0; index < parent.length; index += 1) {
302
- require_ownership.profile.address.segmentCompared();
303
- if (parent[index] !== child[index]) return false;
304
- }
305
- return true;
306
- };
307
- const overlaps = (a, b) => contains(a, b) || contains(b, a);
308
- const debugKey = (address) => {
309
- let result = "";
310
- for (let index = 0; index < address.length; index += 1) {
311
- if (index > 0) result += "/";
312
- result += address[index].replaceAll("~", "~~").replaceAll("/", "~/");
313
- }
314
- return result;
315
- };
316
- //#endregion
317
- //#region core/src/impact-target.ts
318
- var impact_target_exports = /* @__PURE__ */ __exportAll({
319
- address: () => address$1,
320
- belongs: () => belongs,
321
- bucket: () => bucket,
322
- id: () => id,
323
- same: () => same
324
- });
325
- const address$1 = (target) => "at" in target ? target.at : target.address;
326
- const id = (target) => target.kind === "collection" && "id" in target ? target.id : void 0;
327
- const belongs = (target, schema) => !("schema" in target) || target.schema === schema;
328
- const same = (left, right) => {
329
- if (left.kind !== right.kind) return false;
330
- if ("schema" in left && "schema" in right && left.schema !== right.schema) return false;
331
- const leftAddress = address$1(left);
332
- const rightAddress = address$1(right);
333
- if (leftAddress.length !== rightAddress.length) return false;
334
- for (let index = 0; index < leftAddress.length; index += 1) if (leftAddress[index] !== rightAddress[index]) return false;
335
- return left.kind !== "collection" || id(left) === id(right);
336
- };
337
- const bucket = (target) => address$1(target)[0];
338
- //#endregion
339
- //#region core/src/runtime/contract.ts
340
- var DocumentReentrancyError = class extends Error {
341
- constructor() {
342
- super("Document writes cannot be re-entered during an update or notification.");
343
- this.name = "DocumentReentrancyError";
344
- }
345
- };
346
- var DocumentDisposedError = class extends Error {
347
- constructor() {
348
- super("Doxum runtime has been disposed.");
349
- this.name = "DocumentDisposedError";
350
- }
351
- };
352
- //#endregion
353
- //#region core/src/mutation/anchor.ts
354
- const length = (keys) => keys.length;
355
- const keyAt = (keys, index) => Array.isArray(keys) ? keys[index] : keys.at(index);
356
- const keyIndex = (keys, key) => Array.isArray(keys) ? keys.indexOf(key) : keys.index(key);
357
- const keys = (values, keyOf) => ({
358
- length: values.length,
359
- at: (index) => index >= 0 && index < values.length ? keyOf(values[index]) : void 0,
360
- index: (key) => {
361
- for (let index = 0; index < values.length; index += 1) if (keyOf(values[index]) === key) return index;
362
- return -1;
363
- }
364
- });
365
- const index = (keys, anchor) => {
366
- if (!anchor) return length(keys);
367
- if ("at" in anchor) return anchor.at === "start" ? 0 : length(keys);
368
- if ("before" in anchor) return keyIndex(keys, anchor.before);
369
- return keyIndex(keys, anchor.after) + 1;
370
- };
371
- const at = (keys, position) => position <= 0 ? { at: "start" } : { after: keyAt(keys, position - 1) };
372
- const valid = (keys, anchor) => {
373
- if (!anchor) return true;
374
- if (typeof anchor !== "object" || anchor === null) return false;
375
- if (Number("at" in anchor) + Number("before" in anchor) + Number("after" in anchor) !== 1) return false;
376
- if ("at" in anchor) return anchor.at === "start" || anchor.at === "end";
377
- return keyIndex(keys, "before" in anchor ? anchor.before : anchor.after) >= 0;
378
- };
379
- const afterRemove = (keys, removedIndex, anchor) => {
380
- const position = index(keys, anchor);
381
- return position > removedIndex ? position - 1 : position;
382
- };
383
- const validPositions = (length, positions) => {
384
- let previous = -1;
385
- for (let index = 0; index < positions.length; index += 1) {
386
- const position = positions[index];
387
- if (!Number.isInteger(position) || position < 0 || position <= previous || position > length + index) return false;
388
- previous = position;
389
- }
390
- return true;
391
- };
392
- const restore = (keys, inserted, positions) => {
393
- const currentLength = keys.length;
394
- if (inserted.length !== positions.length || !validPositions(currentLength, positions)) throw new Error("Ordered restore positions are invalid.");
395
- let readIndex = currentLength - 1;
396
- let insertedIndex = inserted.length - 1;
397
- keys.length = currentLength + inserted.length;
398
- for (let writeIndex = keys.length - 1; writeIndex >= 0; writeIndex -= 1) if (insertedIndex >= 0 && positions[insertedIndex] === writeIndex) {
399
- keys[writeIndex] = inserted[insertedIndex];
400
- insertedIndex -= 1;
401
- } else {
402
- keys[writeIndex] = keys[readIndex];
403
- readIndex -= 1;
404
- }
405
- };
406
- //#endregion
407
- //#region core/src/access/reader.ts
408
- const schemaRoot = (schema) => object(schema.shape);
409
- const assertActive = (context) => {
410
- if (!context.active()) throw new Error("Document reader is no longer active.");
411
- };
412
- const readAt = (context, address) => {
413
- assertActive(context);
414
- require_ownership.profile.reader.lookup();
415
- return read(context.root(), address);
416
- };
417
- const collectValue = (context, address) => {
418
- context.dependencies?.record({
419
- kind: "value",
420
- at: address
421
- });
422
- };
423
- const collectCollection = (context, address, id) => {
424
- const target = {
425
- kind: "collection",
426
- at: address,
427
- ...id === void 0 ? {} : { id }
428
- };
429
- context.dependencies?.record(target);
430
- };
431
- const readerFor = (node, context, address = []) => {
432
- if (node.kind === "field") return { get: () => {
433
- collectValue(context, address);
434
- return readAt(context, address);
435
- } };
436
- if (node.kind === "dict") return {
437
- get: (key) => {
438
- collectValue(context, address);
439
- const value = readAt(context, address);
440
- return require_ownership.cloneValue(require_ownership.isRecord(value) && Object.prototype.hasOwnProperty.call(value, key) ? value[key] : void 0, "reader");
441
- },
442
- has: (key) => {
443
- collectValue(context, address);
444
- const value = readAt(context, address);
445
- return require_ownership.isRecord(value) && Object.prototype.hasOwnProperty.call(value, key);
446
- },
447
- keys: () => {
448
- collectValue(context, address);
449
- const value = readAt(context, address);
450
- return require_ownership.isRecord(value) ? Object.keys(value) : [];
451
- },
452
- values: () => {
453
- collectValue(context, address);
454
- require_ownership.profile.reader.structuralSnapshot();
455
- return require_ownership.cloneValue(readAt(context, address) ?? {}, "reader");
456
- }
457
- };
458
- if (node.kind === "list") return {
459
- get: (key) => {
460
- collectValue(context, address);
461
- const value = readAt(context, address);
462
- if (!Array.isArray(value)) return void 0;
463
- return require_ownership.cloneValue(value[keys(value, node.keyOf).index(key)], "reader");
464
- },
465
- has: (key) => {
466
- collectValue(context, address);
467
- const value = readAt(context, address);
468
- return Array.isArray(value) && keys(value, node.keyOf).index(key) >= 0;
469
- },
470
- values: () => {
471
- collectValue(context, address);
472
- const value = readAt(context, address);
473
- require_ownership.profile.reader.structuralSnapshot();
474
- return require_ownership.cloneValue(Array.isArray(value) ? value : [], "reader");
475
- },
476
- length: () => {
477
- collectValue(context, address);
478
- const value = readAt(context, address);
479
- return Array.isArray(value) ? value.length : 0;
480
- },
481
- at: (index) => {
482
- collectValue(context, address);
483
- const value = readAt(context, address);
484
- require_ownership.profile.reader.structuralSnapshot();
485
- return require_ownership.cloneValue(Array.isArray(value) ? value[index] : void 0, "reader");
486
- }
487
- };
488
- if (node.kind === "tree") return {
489
- rootId: () => {
490
- collectValue(context, address);
491
- const value = readAt(context, address);
492
- return require_ownership.isRecord(value) && typeof value.rootId === "string" ? value.rootId : void 0;
493
- },
494
- has: (id) => {
495
- collectValue(context, address);
496
- const value = readAt(context, address);
497
- return require_ownership.isRecord(value) && require_ownership.isRecord(value.nodes) && Object.prototype.hasOwnProperty.call(value.nodes, id);
498
- },
499
- value: (id) => {
500
- collectValue(context, address);
501
- const value = readAt(context, address);
502
- require_ownership.profile.reader.structuralSnapshot();
503
- return require_ownership.cloneValue(require_ownership.isRecord(value) && require_ownership.isRecord(value.nodes) && require_ownership.isRecord(value.nodes[id]) ? value.nodes[id].value : void 0, "reader");
504
- },
505
- parent: (id) => {
506
- collectValue(context, address);
507
- const value = readAt(context, address);
508
- const entry = require_ownership.isRecord(value) && require_ownership.isRecord(value.nodes) ? value.nodes[id] : void 0;
509
- return require_ownership.isRecord(entry) && typeof entry.parentId === "string" ? entry.parentId : void 0;
510
- },
511
- children: (id) => {
512
- collectValue(context, address);
513
- const value = readAt(context, address);
514
- const entry = require_ownership.isRecord(value) && require_ownership.isRecord(value.nodes) ? value.nodes[id] : void 0;
515
- return require_ownership.isRecord(entry) && Array.isArray(entry.children) ? [...entry.children] : [];
516
- }
517
- };
518
- if (node.kind === "table" || node.kind === "map") {
519
- let items;
520
- return {
521
- ids: () => {
522
- collectCollection(context, address);
523
- const value = readAt(context, address);
524
- const ids = node.kind === "table" && require_ownership.isRecord(value) && Array.isArray(value.ids) ? [...value.ids] : require_ownership.isRecord(value) ? Object.keys(value) : [];
525
- require_ownership.profile.reader.collectionIds(ids.length);
526
- return ids;
527
- },
528
- has: (id) => {
529
- collectCollection(context, address, id);
530
- const value = readAt(context, address);
531
- const byId = node.kind === "table" && require_ownership.isRecord(value) && require_ownership.isRecord(value.byId) ? value.byId : value;
532
- return require_ownership.isRecord(byId) && Object.prototype.hasOwnProperty.call(byId, id);
533
- },
534
- get: (id) => {
535
- collectCollection(context, address, id);
536
- const value = readAt(context, address);
537
- const byId = node.kind === "table" && require_ownership.isRecord(value) && require_ownership.isRecord(value.byId) ? value.byId : value;
538
- if (!require_ownership.isRecord(byId) || !Object.prototype.hasOwnProperty.call(byId, id)) return void 0;
539
- const cached = items?.get(id);
540
- if (cached) return cached;
541
- const reader = readerFor(node.value, context, [...address, id]);
542
- (items ??= /* @__PURE__ */ new Map()).set(id, reader);
543
- return reader;
544
- }
545
- };
546
- }
547
- if (node.kind === "variant") return { get: () => {
548
- collectValue(context, address);
549
- return require_ownership.cloneValue(readAt(context, address), "reader");
550
- } };
551
- let children;
552
- return new Proxy({}, { get: (_target, property) => {
553
- if (typeof property === "symbol") return void 0;
554
- const child = node.shape[property];
555
- if (!child) return void 0;
556
- const cached = children?.get(property);
557
- if (cached) return cached;
558
- const reader = readerFor(child, context, [...address, property]);
559
- (children ??= /* @__PURE__ */ new Map()).set(property, reader);
560
- return reader;
561
- } });
562
- };
563
- const documentReader = (schema, root, active, dependencies) => {
564
- require_ownership.profile.reader.session();
565
- return readerFor(schemaRoot(schema), {
566
- root,
567
- active,
568
- dependencies
569
- });
570
- };
571
- //#endregion
572
- //#region core/src/mutation/footprint.ts
573
- const sameAddress = (left, right) => left.length === right.length && left.every((segment, index) => segment === right[index]);
574
- const containsAddress = (parent, child) => parent.length <= child.length && parent.every((segment, index) => segment === child[index]);
575
- const address = (value) => Array.isArray(value) && value.every((segment) => typeof segment === "string") ? Object.freeze(value.slice()) : void 0;
576
- const targetKey = (target) => {
577
- const at = target.at.join("\0");
578
- if (target.kind === "dictionary-key" || target.kind === "list-item") return `${target.kind}:${at}:${target.key}`;
579
- if (target.kind === "entity" || target.kind === "tree-node") return `${target.kind}:${at}:${target.id}`;
580
- return `${target.kind}:${at}`;
581
- };
582
- const freezeTarget = (target) => Object.freeze({
583
- ...target,
584
- at: Object.freeze(target.at.slice())
585
- });
586
- const add = (targets, target) => {
587
- const stable = freezeTarget(target);
588
- targets.set(targetKey(stable), stable);
589
- };
590
- const commandFootprint = (operations) => {
591
- const targets = /* @__PURE__ */ new Map();
592
- for (const operation of operations) switch (operation.type) {
593
- case "field.set":
594
- case "field.clear":
595
- case "value.clear":
596
- case "variant.replace":
597
- add(targets, {
598
- kind: "value",
599
- at: operation.at
600
- });
601
- break;
602
- case "dict.replace":
603
- add(targets, {
604
- kind: "dictionary",
605
- at: operation.at
606
- });
607
- break;
608
- case "dict.set":
609
- case "dict.delete":
610
- add(targets, {
611
- kind: "dictionary-key",
612
- at: operation.at,
613
- key: operation.key
614
- });
615
- break;
616
- case "entity.create":
617
- add(targets, {
618
- kind: "collection",
619
- at: operation.at
620
- });
621
- for (const entry of operation.entries) add(targets, {
622
- kind: "entity",
623
- at: operation.at,
624
- id: entry.id
625
- });
626
- break;
627
- case "entity.remove":
628
- add(targets, {
629
- kind: "collection",
630
- at: operation.at
631
- });
632
- for (const id of operation.ids) add(targets, {
633
- kind: "entity",
634
- at: operation.at,
635
- id
636
- });
637
- break;
638
- case "entity.move":
639
- add(targets, {
640
- kind: "collection",
641
- at: operation.at
642
- });
643
- add(targets, {
644
- kind: "entity",
645
- at: operation.at,
646
- id: operation.id
647
- });
648
- break;
649
- case "list.insert":
650
- case "list.move":
651
- case "list.remove":
652
- add(targets, {
653
- kind: "list",
654
- at: operation.at
655
- });
656
- add(targets, {
657
- kind: "list-item",
658
- at: operation.at,
659
- key: operation.key
660
- });
661
- break;
662
- case "list.replace":
663
- add(targets, {
664
- kind: "list",
665
- at: operation.at
666
- });
667
- for (const key of operation.keys) add(targets, {
668
- kind: "list-item",
669
- at: operation.at,
670
- key
671
- });
672
- break;
673
- case "tree.insert":
674
- case "tree.move":
675
- case "tree.remove":
676
- case "tree.set":
677
- add(targets, {
678
- kind: "tree",
679
- at: operation.at
680
- });
681
- add(targets, {
682
- kind: "tree-node",
683
- at: operation.at,
684
- id: operation.treeNodeId
685
- });
686
- break;
687
- case "tree.replace":
688
- add(targets, {
689
- kind: "tree",
690
- at: operation.at
691
- });
692
- break;
693
- }
694
- return Object.freeze(Array.from(targets.values()));
695
- };
696
- const overlapsValueAndEntity = (value, entity) => containsAddress([...entity.at, entity.id], value.at) || containsAddress(value.at, [...entity.at, entity.id]);
697
- const targetsOverlap = (left, right) => {
698
- if (left.kind === "value" && right.kind === "value") return containsAddress(left.at, right.at) || containsAddress(right.at, left.at);
699
- if (left.kind === "value" && right.kind === "entity") return overlapsValueAndEntity(left, right);
700
- if (left.kind === "entity" && right.kind === "value") return overlapsValueAndEntity(right, left);
701
- if (left.kind === "dictionary" && right.kind === "dictionary") return sameAddress(left.at, right.at);
702
- if (left.kind === "dictionary" && right.kind === "dictionary-key") return sameAddress(left.at, right.at);
703
- if (left.kind === "dictionary-key" && right.kind === "dictionary") return sameAddress(left.at, right.at);
704
- if (left.kind === "dictionary-key" && right.kind === "dictionary-key") return sameAddress(left.at, right.at) && left.key === right.key;
705
- if (left.kind === "collection" && right.kind === "collection") return sameAddress(left.at, right.at);
706
- if (left.kind === "collection" && right.kind === "entity") return sameAddress(left.at, right.at);
707
- if (left.kind === "entity" && right.kind === "collection") return sameAddress(left.at, right.at);
708
- if (left.kind === "entity" && right.kind === "entity") return sameAddress(left.at, right.at) && left.id === right.id;
709
- if (left.kind === "list" && (right.kind === "list" || right.kind === "list-item")) return sameAddress(left.at, right.at);
710
- if (right.kind === "list" && left.kind === "list-item") return sameAddress(left.at, right.at);
711
- if (left.kind === "list-item" && right.kind === "list-item") return sameAddress(left.at, right.at) && left.key === right.key;
712
- if (left.kind === "tree" && (right.kind === "tree" || right.kind === "tree-node")) return sameAddress(left.at, right.at);
713
- if (right.kind === "tree" && left.kind === "tree-node") return sameAddress(left.at, right.at);
714
- if (left.kind === "tree-node" && right.kind === "tree-node") return sameAddress(left.at, right.at) && left.id === right.id;
715
- return false;
716
- };
717
- const footprintsOverlap = (left, right) => left.some((leftTarget) => right.some((rightTarget) => targetsOverlap(leftTarget, rightTarget)));
718
- const decodedTarget = (value) => {
719
- if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
720
- const record = value;
721
- const at = address(record.at);
722
- if (!at || typeof record.kind !== "string") return void 0;
723
- switch (record.kind) {
724
- case "value":
725
- case "dictionary":
726
- case "collection":
727
- case "list":
728
- case "tree": return freezeTarget({
729
- kind: record.kind,
730
- at
731
- });
732
- case "dictionary-key":
733
- case "list-item": return typeof record.key === "string" ? freezeTarget({
734
- kind: record.kind,
735
- at,
736
- key: record.key
737
- }) : void 0;
738
- case "entity":
739
- case "tree-node": return typeof record.id === "string" ? freezeTarget({
740
- kind: record.kind,
741
- at,
742
- id: record.id
743
- }) : void 0;
744
- default: return;
745
- }
746
- };
747
- const decodeCommandFootprint = (value) => {
748
- if (!Array.isArray(value)) return void 0;
749
- const targets = /* @__PURE__ */ new Map();
750
- for (const entry of value) {
751
- const target = decodedTarget(entry);
752
- if (!target) return void 0;
753
- targets.set(targetKey(target), target);
754
- }
755
- return Object.freeze(Array.from(targets.values()));
756
- };
757
- //#endregion
758
- //#region core/src/runtime/access.ts
759
- const states = /* @__PURE__ */ new WeakMap();
760
- const bindRuntimeAccess = (runtime, state) => {
761
- states.set(runtime, state);
762
- };
763
- const accessOf = (runtime) => {
764
- const state = states.get(runtime);
765
- if (!state) throw new Error("Unknown Doxum runtime.");
766
- return state;
767
- };
768
- const readWith = (runtime, run, dependencies) => {
769
- const state = accessOf(runtime);
770
- if (state.disposed) throw new DocumentDisposedError();
771
- let active = true;
772
- const reader = documentReader(state.schema, () => state.document, () => active, dependencies);
773
- try {
774
- return run(reader);
775
- } finally {
776
- active = false;
777
- }
778
- };
779
- //#endregion
780
- //#region core/src/runtime/notification.ts
781
- const ROOT_BUCKET = Symbol("document-root");
782
- const notifications = /* @__PURE__ */ new WeakMap();
783
- const readableOwners = /* @__PURE__ */ new WeakMap();
784
- const bindDocumentReadable = (readable, runtime) => {
785
- readableOwners.set(readable, runtime);
786
- };
787
- const documentReadableOwner = (readable) => readableOwners.get(readable);
788
- const key = (value) => bucket(value) ?? ROOT_BUCKET;
789
- const createNotification = (runtime) => {
790
- const notification = {
791
- root: /* @__PURE__ */ new Set(),
792
- filtered: /* @__PURE__ */ new Set(),
793
- buckets: /* @__PURE__ */ new Map(),
794
- processors: [],
795
- candidates: /* @__PURE__ */ new Set(),
796
- rootSnapshot: [],
797
- notifying: false
798
- };
799
- notifications.set(runtime, notification);
800
- return notification;
801
- };
802
- const notificationOf = (runtime) => {
803
- const value = notifications.get(runtime);
804
- if (!value) throw new Error("Unknown Doxum runtime.");
805
- return value;
806
- };
807
- const shareNotification = (source, target) => {
808
- notifications.set(target, notificationOf(source));
809
- };
810
- const attachProjection = (runtime, processor) => {
811
- const notification = notificationOf(runtime);
812
- const entry = {
813
- processor,
814
- active: true
815
- };
816
- notification.processors.push(entry);
817
- return () => {
818
- if (!entry.active) return;
819
- entry.active = false;
820
- if (!notification.notifying) {
821
- const index = notification.processors.indexOf(entry);
822
- if (index >= 0) notification.processors.splice(index, 1);
823
- }
824
- };
825
- };
826
- const subscribeRoot = (notification, listener) => {
827
- const entry = {
828
- listener,
829
- active: true
830
- };
831
- notification.root.add(entry);
832
- return () => {
833
- entry.active = false;
834
- if (!notification.notifying) notification.root.delete(entry);
835
- };
836
- };
837
- const subscribeTargets = (notification, targets, listener) => {
838
- const entry = {
839
- targets: Object.freeze(targets.slice()),
840
- listener,
841
- active: true
842
- };
843
- notification.filtered.add(entry);
844
- const keys = new Set(targets.map(key));
845
- keys.forEach((key) => {
846
- const bucket = notification.buckets.get(key) ?? /* @__PURE__ */ new Set();
847
- bucket.add(entry);
848
- notification.buckets.set(key, bucket);
849
- });
850
- return () => {
851
- if (!entry.active) return;
852
- entry.active = false;
853
- if (notification.notifying) return;
854
- notification.filtered.delete(entry);
855
- keys.forEach((key) => {
856
- const bucket = notification.buckets.get(key);
857
- bucket?.delete(entry);
858
- if (bucket?.size === 0) notification.buckets.delete(key);
859
- });
860
- };
861
- };
862
- const notify = (notification, commit, afterSettle) => {
863
- notification.notifying = true;
864
- const errors = [];
865
- const call = (listener) => {
866
- try {
867
- listener(commit);
868
- } catch (error) {
869
- errors.push(Object.freeze({
870
- phase: "listener",
871
- error
872
- }));
873
- }
874
- };
875
- try {
876
- const processorCount = notification.processors.length;
877
- for (let index = 0; index < processorCount; index += 1) {
878
- const entry = notification.processors[index];
879
- if (!entry?.active) continue;
880
- try {
881
- entry.processor.capture(commit);
882
- } catch (error) {
883
- errors.push(Object.freeze({
884
- phase: "processor",
885
- error
886
- }));
887
- }
888
- }
889
- for (let index = 0; index < processorCount; index += 1) {
890
- const entry = notification.processors[index];
891
- if (!entry?.active) continue;
892
- try {
893
- entry.processor.settle();
894
- } catch (error) {
895
- errors.push(Object.freeze({
896
- phase: "processor",
897
- error
898
- }));
899
- }
900
- }
901
- for (let index = 0; index < processorCount; index += 1) {
902
- const entry = notification.processors[index];
903
- if (!entry?.active) continue;
904
- try {
905
- errors.push(...entry.processor.flush());
906
- } catch (error) {
907
- errors.push(Object.freeze({
908
- phase: "flush",
909
- error
910
- }));
911
- }
912
- }
913
- if (afterSettle) errors.push(...afterSettle());
914
- const candidates = notification.candidates;
915
- candidates.clear();
916
- if (commit.impact.kind === "reset") notification.filtered.forEach((entry) => candidates.add(entry));
917
- else for (const operation of commit.operations) {
918
- const key = operation.at[0] ?? ROOT_BUCKET;
919
- notification.buckets.get(key)?.forEach((entry) => candidates.add(entry));
920
- notification.buckets.get(ROOT_BUCKET)?.forEach((entry) => candidates.add(entry));
921
- }
922
- candidates.forEach((entry) => {
923
- if (entry.active && entry.targets.some(commit.impact.affects)) call(entry.listener);
924
- });
925
- const rootSnapshot = notification.rootSnapshot;
926
- rootSnapshot.length = 0;
927
- notification.root.forEach((entry) => rootSnapshot.push(entry));
928
- for (const entry of rootSnapshot) if (entry.active) call(entry.listener);
929
- } finally {
930
- notification.notifying = false;
931
- let writeIndex = 0;
932
- for (const entry of notification.processors) if (entry.active) notification.processors[writeIndex++] = entry;
933
- notification.processors.length = writeIndex;
934
- notification.root.forEach((entry) => {
935
- if (!entry.active) notification.root.delete(entry);
936
- });
937
- notification.filtered.forEach((entry) => {
938
- if (!entry.active) notification.filtered.delete(entry);
939
- });
940
- notification.buckets.forEach((bucket, key) => {
941
- bucket.forEach((entry) => {
942
- if (!entry.active) bucket.delete(entry);
943
- });
944
- if (bucket.size === 0) notification.buckets.delete(key);
945
- });
946
- }
947
- return Object.freeze(errors);
948
- };
949
- const disposeNotification = (notification) => {
950
- const attachments = notification.processors.slice();
951
- notification.root.clear();
952
- notification.filtered.clear();
953
- notification.buckets.clear();
954
- notification.processors.length = 0;
955
- notification.candidates.clear();
956
- notification.rootSnapshot.length = 0;
957
- const errors = [];
958
- attachments.forEach((entry) => {
959
- if (!entry.active) return;
960
- try {
961
- entry.processor.dispose();
962
- } catch (error) {
963
- errors.push(error);
964
- }
965
- });
966
- if (errors.length) throw new AggregateError(errors, "Projection disposal notification failed.");
967
- };
968
- //#endregion
969
- //#region core/src/projection/contract.ts
970
- var ProjectionError = class extends Error {
971
- constructor(phase, identity, revisions, cause) {
972
- super(`Projection ${phase} failed: ${identity}`, { cause });
973
- this.phase = phase;
974
- this.identity = identity;
975
- this.revisions = revisions;
976
- this.name = "ProjectionError";
977
- }
978
- };
979
- var ProjectionDisposedError = class extends Error {
980
- constructor() {
981
- super("Projection has been disposed.");
982
- this.name = "ProjectionDisposedError";
983
- }
984
- };
985
- //#endregion
986
- //#region core/src/projection/scheduler.ts
987
- const projectionHandles = /* @__PURE__ */ new WeakSet();
988
- const createScheduler = (onError) => {
989
- let disposed = false;
990
- let depth = 0;
991
- let phase = "idle";
992
- let sequence = 0;
993
- const records = /* @__PURE__ */ new Map();
994
- const nodes = /* @__PURE__ */ new Set();
995
- const pending = /* @__PURE__ */ new Set();
996
- const heap = [];
997
- const queued = /* @__PURE__ */ new Set();
998
- const completed = [];
999
- const emissions = /* @__PURE__ */ new Set();
1000
- const errors = [];
1001
- let reportingFailures = [];
1002
- const guards = /* @__PURE__ */ new Set();
1003
- const cleanups = /* @__PURE__ */ new Set();
1004
- const assertActive = () => {
1005
- if (disposed) throw new ProjectionDisposedError();
1006
- };
1007
- const assertIdle = () => {
1008
- assertActive();
1009
- if (phase !== "idle") throw new Error("Projection cannot be re-entered during processing or notification.");
1010
- };
1011
- const lock = (value) => guards.forEach((guard) => guard(value));
1012
- const enqueue = (node) => {
1013
- if (node.disposed || queued.has(node)) return;
1014
- queued.add(node);
1015
- require_ownership.profile.projection("scheduledNodes");
1016
- let i = heap.length;
1017
- heap.push(node);
1018
- while (i > 0) {
1019
- const p = i - 1 >> 1;
1020
- if (heap[p].order < node.order) break;
1021
- heap[i] = heap[p];
1022
- i = p;
1023
- }
1024
- heap[i] = node;
1025
- };
1026
- const pop = () => {
1027
- const first = heap[0];
1028
- const last = heap.pop();
1029
- if (heap.length) {
1030
- let i = 0;
1031
- while (i * 2 + 1 < heap.length) {
1032
- let c = i * 2 + 1;
1033
- if (c + 1 < heap.length && heap[c + 1].order < heap[c].order) c++;
1034
- if (last.order < heap[c].order) break;
1035
- heap[i] = heap[c];
1036
- i = c;
1037
- }
1038
- heap[i] = last;
1039
- }
1040
- return first;
1041
- };
1042
- const errorFor = (node, cause, kind = "processor") => new ProjectionError(kind, node.name, node.sources.map((source) => source.revision()), cause);
1043
- const capture = (source) => {
1044
- if (disposed) return;
1045
- if (phase !== "idle") {
1046
- source.fault = new ProjectionError("source", "reentrant source", [source.revision()], /* @__PURE__ */ new Error("Source changed while projection was running."));
1047
- errors.push(source.fault);
1048
- throw source.fault;
1049
- }
1050
- pending.add(source);
1051
- require_ownership.profile.projection("sourceEvents");
1052
- if (source.fault) errors.push(source.fault);
1053
- };
1054
- const settle = () => {
1055
- if (disposed || depth || phase !== "idle") return;
1056
- phase = "compute";
1057
- lock(true);
1058
- try {
1059
- pending.forEach((source) => source.consumers.forEach(enqueue));
1060
- while (heap.length) {
1061
- const node = pop();
1062
- if (node.disposed) continue;
1063
- const wasFaulted = node.fault !== void 0;
1064
- require_ownership.profile.projection("processedNodes");
1065
- let changed = false;
1066
- const blocked = node.sources.find((source) => source.fault || source.disposed);
1067
- if (blocked) node.fault = errorFor(node, blocked.fault ?? new ProjectionDisposedError(), "blocked");
1068
- else {
1069
- const build = node.forced || wasFaulted || node.sources.some((source) => source.reset());
1070
- try {
1071
- changed = node.evaluate(build);
1072
- const failure = node.sources.find((source) => source.fault)?.fault;
1073
- if (failure) throw failure;
1074
- node.fault = void 0;
1075
- } catch (cause) {
1076
- const error = errorFor(node, cause);
1077
- errors.push(error);
1078
- node.fault = error;
1079
- if (!build) try {
1080
- changed = node.evaluate(true);
1081
- const failure = node.sources.find((source) => source.fault)?.fault;
1082
- if (failure) throw failure;
1083
- node.fault = void 0;
1084
- } catch (cause) {
1085
- node.fault = errorFor(node, cause);
1086
- errors.push(node.fault);
1087
- }
1088
- }
1089
- }
1090
- node.forced = false;
1091
- node.statusChanged = wasFaulted !== (node.fault !== void 0);
1092
- completed.push(node);
1093
- if (changed || wasFaulted || node.fault) {
1094
- require_ownership.profile.projection("publishedNodes");
1095
- emissions.add(node);
1096
- node.consumers.forEach(enqueue);
1097
- }
1098
- }
1099
- completed.forEach((node) => node.publish());
1100
- } finally {
1101
- lock(false);
1102
- phase = "idle";
1103
- }
1104
- };
1105
- const flush = () => {
1106
- if (disposed || depth) return [];
1107
- if (pending.size || completed.length) require_ownership.profile.projection("flushes");
1108
- phase = "notify";
1109
- lock(true);
1110
- const reportFailures = [];
1111
- try {
1112
- emissions.forEach((node) => node.emit((listener) => {
1113
- try {
1114
- listener();
1115
- } catch (cause) {
1116
- errors.push(errorFor(node, cause, "listener"));
1117
- }
1118
- }));
1119
- for (const error of errors.slice()) try {
1120
- onError(error);
1121
- } catch (cause) {
1122
- reportFailures.push(cause);
1123
- }
1124
- return Object.freeze([...errors.map((error) => Object.freeze({
1125
- phase: error.phase === "listener" ? "listener" : "processor",
1126
- error
1127
- })), ...reportFailures.map((error) => Object.freeze({
1128
- phase: "listener",
1129
- error
1130
- }))]);
1131
- } finally {
1132
- pending.forEach((source) => source.clear());
1133
- completed.forEach((node) => node.clear());
1134
- pending.clear();
1135
- queued.clear();
1136
- completed.length = 0;
1137
- emissions.clear();
1138
- errors.length = 0;
1139
- reportingFailures = reportFailures;
1140
- lock(false);
1141
- phase = "idle";
1142
- }
1143
- };
1144
- const run = () => {
1145
- settle();
1146
- const result = flush();
1147
- const failures = reportingFailures;
1148
- reportingFailures = [];
1149
- if (failures.length) throw new AggregateError(failures, "Projection error reporter failed.");
1150
- return result;
1151
- };
1152
- return {
1153
- assertActive,
1154
- assertIdle,
1155
- capture,
1156
- settle,
1157
- flush,
1158
- run,
1159
- records,
1160
- guards,
1161
- cleanups,
1162
- get active() {
1163
- return !disposed;
1164
- },
1165
- register(handle, record) {
1166
- assertIdle();
1167
- records.set(handle, record);
1168
- projectionHandles.add(handle);
1169
- },
1170
- unregisterSource(handle) {
1171
- const record = records.get(handle);
1172
- if (record) {
1173
- record.disposed = true;
1174
- pending.delete(record);
1175
- record.clear();
1176
- records.delete(handle);
1177
- }
1178
- },
1179
- source(handle) {
1180
- assertActive();
1181
- const source = records.get(handle);
1182
- if (!source || source.disposed) throw new Error("Unknown, disposed, or foreign projection source.");
1183
- return source;
1184
- },
1185
- addNode(node) {
1186
- nodes.add(node);
1187
- node.sources.forEach((source) => source.consumers.add(node));
1188
- },
1189
- order: () => sequence++,
1190
- initialize(run) {
1191
- assertIdle();
1192
- phase = "compute";
1193
- lock(true);
1194
- try {
1195
- return run();
1196
- } finally {
1197
- lock(false);
1198
- phase = "idle";
1199
- }
1200
- },
1201
- rebuild(node) {
1202
- assertIdle();
1203
- if (node.disposed) throw new ProjectionDisposedError();
1204
- node.forced = true;
1205
- enqueue(node);
1206
- run();
1207
- },
1208
- disposeNode(node) {
1209
- if (node.disposed) return;
1210
- assertIdle();
1211
- if (node.consumers.size) throw new Error("Cannot dispose a projection node with downstream consumers.");
1212
- node.disposed = true;
1213
- node.sources.forEach((source) => source.consumers.delete(node));
1214
- nodes.delete(node);
1215
- node.release();
1216
- for (const [handle, record] of records) if (record === node) records.delete(handle);
1217
- },
1218
- batch(callback) {
1219
- assertIdle();
1220
- depth++;
1221
- let failed = false;
1222
- try {
1223
- const value = callback();
1224
- assertSynchronous(value);
1225
- return value;
1226
- } catch (error) {
1227
- failed = true;
1228
- throw error;
1229
- } finally {
1230
- depth--;
1231
- if (!depth) if (failed) try {
1232
- run();
1233
- } catch {}
1234
- else run();
1235
- }
1236
- },
1237
- dispose() {
1238
- if (disposed) return;
1239
- assertIdle();
1240
- disposed = true;
1241
- const failures = [];
1242
- cleanups.forEach((cleanup) => {
1243
- try {
1244
- cleanup();
1245
- } catch (error) {
1246
- failures.push(error);
1247
- }
1248
- });
1249
- cleanups.clear();
1250
- nodes.forEach((node) => {
1251
- node.disposed = true;
1252
- node.release();
1253
- node.consumers.clear();
1254
- });
1255
- records.forEach((source) => {
1256
- source.disposed = true;
1257
- source.consumers.clear();
1258
- source.clear();
1259
- });
1260
- nodes.clear();
1261
- records.clear();
1262
- pending.clear();
1263
- heap.length = 0;
1264
- completed.length = 0;
1265
- queued.clear();
1266
- emissions.clear();
1267
- guards.clear();
1268
- errors.length = 0;
1269
- reportingFailures = [];
1270
- if (failures.length) throw new AggregateError(failures, "Projection cleanup failed.");
1271
- },
1272
- debug: () => ({
1273
- nodes: nodes.size,
1274
- sources: records.size - nodes.size,
1275
- subscriptions: cleanups.size,
1276
- pending: pending.size + heap.length
1277
- })
1278
- };
1279
- };
1280
- const assertSynchronous = (value) => {
1281
- if (value != null && (typeof value === "object" || typeof value === "function") && "then" in value && typeof value.then === "function") throw new TypeError("Projection callbacks must be synchronous.");
1282
- };
1283
- const assertScope = (active) => {
1284
- if (!active()) throw new Error("Projection reader or writer is no longer active.");
1285
- };
1286
- //#endregion
1287
- //#region core/src/projection/node.ts
1288
- const createNode = (scheduler, spec, behavior) => {
1289
- scheduler.assertIdle();
1290
- const entries = Object.entries(spec.sources).map(([key, handle]) => [key, scheduler.source(handle)]);
1291
- const order = scheduler.order();
1292
- const node = {
1293
- ...behavior,
1294
- publish: () => {
1295
- if (node.fault) behavior.clear();
1296
- else behavior.publish();
1297
- },
1298
- order,
1299
- name: spec.name ? `${spec.name} (${order})` : `projection-${order}`,
1300
- sources: entries.map(([, source]) => source),
1301
- consumers: /* @__PURE__ */ new Set(),
1302
- disposed: false,
1303
- fault: void 0,
1304
- forced: false,
1305
- statusChanged: false,
1306
- evaluate: (build) => {
1307
- let active = true;
1308
- try {
1309
- const inputs = Object.fromEntries(entries.map(([key, source]) => [key, source.context(() => active)]));
1310
- return behavior.evaluate(inputs, build, () => active);
1311
- } finally {
1312
- active = false;
1313
- }
1314
- }
1315
- };
1316
- scheduler.initialize(() => {
1317
- const invalid = node.sources.find((source) => source.fault || source.disposed);
1318
- if (invalid) throw invalid.fault ?? new ProjectionDisposedError();
1319
- node.evaluate(true);
1320
- node.publish();
1321
- node.clear();
1322
- });
1323
- const check = () => {
1324
- if (node.disposed || !scheduler.active) throw new ProjectionDisposedError();
1325
- if (node.fault) throw node.fault;
1326
- };
1327
- return {
1328
- node,
1329
- check,
1330
- install(handle) {
1331
- scheduler.register(handle, node);
1332
- scheduler.addNode(node);
1333
- },
1334
- rebuild: () => scheduler.rebuild(node),
1335
- dispose: () => scheduler.disposeNode(node)
1336
- };
1337
- };
1338
- //#endregion
1339
- //#region core/src/projection/collection.ts
1340
- const collectionHandles = /* @__PURE__ */ new WeakSet();
1341
- const readonlySet = (values) => {
1342
- const set = new Set(values);
1343
- const view = Object.freeze({
1344
- get size() {
1345
- return set.size;
1346
- },
1347
- has: (value) => set.has(value),
1348
- entries: () => set.entries(),
1349
- keys: () => set.keys(),
1350
- values: () => set.values(),
1351
- [Symbol.iterator]: () => set.values(),
1352
- forEach: (callback, thisArg) => set.forEach((value) => callback.call(thisArg, value, value, view))
1353
- });
1354
- return view;
1355
- };
1356
- const createCollection = (scheduler, spec) => {
1357
- const values = /* @__PURE__ */ new Map();
1358
- let ids = Object.freeze([]);
1359
- let staged = /* @__PURE__ */ new Map();
1360
- let nextIds = ids;
1361
- let change;
1362
- let instance;
1363
- let initialized = false;
1364
- let reset = false;
1365
- let revision = 0;
1366
- let idsRevision = 0;
1367
- let all;
1368
- const itemVersions = /* @__PURE__ */ new Map();
1369
- const items = /* @__PURE__ */ new Map();
1370
- const itemListeners = /* @__PURE__ */ new Map();
1371
- const idsListeners = /* @__PURE__ */ new Set();
1372
- const allListeners = /* @__PURE__ */ new Set();
1373
- const listeners = /* @__PURE__ */ new Set();
1374
- const changedKeys = /* @__PURE__ */ new Set();
1375
- let orderChanged = false;
1376
- const hasNext = (key) => staged.has(key) ? staged.get(key).present : values.has(key);
1377
- const getNext = (key) => {
1378
- const entry = staged.get(key);
1379
- return entry ? entry.present ? entry.value : void 0 : values.get(key);
1380
- };
1381
- const owner = createNode(scheduler, spec, {
1382
- evaluate: (sources, build, active) => {
1383
- staged = /* @__PURE__ */ new Map();
1384
- nextIds = ids;
1385
- change = void 0;
1386
- changedKeys.clear();
1387
- let explicitOrder;
1388
- let cleared = false;
1389
- const nextHas = (key) => staged.has(key) ? staged.get(key).present : !cleared && values.has(key);
1390
- const nextGet = (key) => {
1391
- const entry = staged.get(key);
1392
- return entry ? entry.present ? entry.value : void 0 : cleared ? void 0 : values.get(key);
1393
- };
1394
- const deriveIds = () => {
1395
- const result = cleared ? [] : ids.filter(nextHas);
1396
- for (const [key, entry] of staged) if (entry.present && (cleared || !values.has(key))) result.push(key);
1397
- return result;
1398
- };
1399
- const read = (next) => ({
1400
- get: (key) => {
1401
- assertScope(active);
1402
- return next ? nextGet(key) : values.get(key);
1403
- },
1404
- has: (key) => {
1405
- assertScope(active);
1406
- return next ? nextHas(key) : values.has(key);
1407
- },
1408
- ids: () => {
1409
- assertScope(active);
1410
- return next ? Object.freeze(explicitOrder ? explicitOrder.slice() : deriveIds()) : ids;
1411
- }
1412
- });
1413
- const writer = {
1414
- set: (key, value) => {
1415
- assertScope(active);
1416
- if (typeof key !== "string") throw new TypeError("Projection keys must be strings.");
1417
- staged.set(key, {
1418
- present: true,
1419
- value
1420
- });
1421
- },
1422
- remove: (key) => {
1423
- assertScope(active);
1424
- staged.set(key, { present: false });
1425
- },
1426
- order: (order) => {
1427
- assertScope(active);
1428
- explicitOrder = order.slice();
1429
- },
1430
- replace: (entries) => {
1431
- assertScope(active);
1432
- staged.clear();
1433
- cleared = true;
1434
- const order = [];
1435
- for (const [key, value] of entries) {
1436
- if (staged.has(key)) throw new TypeError("Duplicate projection key.");
1437
- writer.set(key, value);
1438
- order.push(key);
1439
- }
1440
- explicitOrder = order;
1441
- }
1442
- };
1443
- const input = {
1444
- sources,
1445
- previous: read(false),
1446
- next: read(true),
1447
- writer
1448
- };
1449
- if (build || !instance) {
1450
- require_ownership.profile.materialized.rebuilt();
1451
- instance = void 0;
1452
- cleared = true;
1453
- const built = spec.build(input);
1454
- assertSynchronous(built);
1455
- instance = built;
1456
- } else {
1457
- require_ownership.profile.materialized.updated();
1458
- const result = instance.update(input);
1459
- assertSynchronous(result);
1460
- if (result?.kind === "rebuild") {
1461
- staged.clear();
1462
- cleared = true;
1463
- explicitOrder = void 0;
1464
- instance = void 0;
1465
- const built = spec.build(input);
1466
- assertSynchronous(built);
1467
- instance = built;
1468
- build = true;
1469
- }
1470
- }
1471
- if (cleared) {
1472
- for (const key of values.keys()) if (!staged.has(key)) staged.set(key, { present: false });
1473
- }
1474
- const added = /* @__PURE__ */ new Set();
1475
- const removed = /* @__PURE__ */ new Set();
1476
- const updated = /* @__PURE__ */ new Set();
1477
- require_ownership.profile.projection("touchedKeys", staged.size);
1478
- for (const [key, entry] of staged) {
1479
- const existed = values.has(key);
1480
- if (entry.present) if (!existed) added.add(key);
1481
- else if (!(spec.isEqual ?? Object.is)(values.get(key), entry.value)) updated.add(key);
1482
- else staged.delete(key);
1483
- else if (existed) removed.add(key);
1484
- else staged.delete(key);
1485
- }
1486
- if (explicitOrder || added.size || removed.size) {
1487
- const order = explicitOrder ?? [...ids.filter((key) => !removed.has(key)), ...added];
1488
- if (new Set(order).size !== order.length || order.length !== values.size + added.size - removed.size || order.some((key) => !hasNext(key))) throw new TypeError("Projection order must contain every key exactly once.");
1489
- nextIds = ids.length === order.length && ids.every((key, i) => key === order[i]) ? ids : Object.freeze(order.slice());
1490
- }
1491
- orderChanged = nextIds !== ids;
1492
- if (added.size || removed.size || updated.size || orderChanged) {
1493
- let commonOrderChanged = false;
1494
- if (orderChanged) {
1495
- const before = ids.filter((key) => !removed.has(key));
1496
- const after = nextIds.filter((key) => !added.has(key));
1497
- commonOrderChanged = before.some((key, i) => after[i] !== key);
1498
- }
1499
- change = Object.freeze({
1500
- kind: "incremental",
1501
- added: readonlySet(added),
1502
- removed: readonlySet(removed),
1503
- updated: readonlySet(updated),
1504
- orderChanged: commonOrderChanged
1505
- });
1506
- [
1507
- ...added,
1508
- ...removed,
1509
- ...updated
1510
- ].forEach((key) => changedKeys.add(key));
1511
- require_ownership.profile.projection("changedKeys", changedKeys.size);
1512
- }
1513
- reset = build;
1514
- return change !== void 0;
1515
- },
1516
- context: (active) => {
1517
- const input = {
1518
- get: (key) => {
1519
- assertScope(active);
1520
- return getNext(key);
1521
- },
1522
- has: (key) => {
1523
- assertScope(active);
1524
- return hasNext(key);
1525
- },
1526
- ids: () => {
1527
- assertScope(active);
1528
- return nextIds;
1529
- },
1530
- change,
1531
- revision: revision + (change ? 1 : 0),
1532
- reset
1533
- };
1534
- return Object.freeze(input);
1535
- },
1536
- revision: () => revision,
1537
- reset: () => reset,
1538
- publish: () => {
1539
- for (const [key, entry] of staged) if (entry.present) values.set(key, entry.value);
1540
- else values.delete(key);
1541
- if (change) {
1542
- if (initialized) revision++;
1543
- if (orderChanged && initialized) idsRevision++;
1544
- all = void 0;
1545
- changedKeys.forEach((key) => {
1546
- if (items.has(key)) itemVersions.set(key, (itemVersions.get(key) ?? 0) + (initialized ? 1 : 0));
1547
- });
1548
- }
1549
- ids = nextIds;
1550
- initialized = true;
1551
- },
1552
- emit: (call) => {
1553
- require_ownership.profile.materialized.notification();
1554
- const fault = owner.node.fault !== void 0;
1555
- const resetEvent = Object.freeze({ kind: "reset" });
1556
- Array.from(listeners).forEach((listener) => call(() => listener(change ?? resetEvent)));
1557
- if (orderChanged || !change || fault || owner.node.statusChanged) Array.from(idsListeners).forEach((listener) => call(listener));
1558
- Array.from(allListeners).forEach((listener) => call(listener));
1559
- const keys = !change || fault || owner.node.statusChanged ? itemListeners.keys() : changedKeys;
1560
- for (const key of keys) Array.from(itemListeners.get(key) ?? []).forEach((listener) => call(listener));
1561
- },
1562
- clear: () => {
1563
- staged.clear();
1564
- nextIds = ids;
1565
- change = void 0;
1566
- reset = false;
1567
- changedKeys.clear();
1568
- orderChanged = false;
1569
- },
1570
- release: () => {
1571
- values.clear();
1572
- staged.clear();
1573
- items.clear();
1574
- itemVersions.clear();
1575
- itemListeners.clear();
1576
- idsListeners.clear();
1577
- allListeners.clear();
1578
- listeners.clear();
1579
- ids = nextIds = Object.freeze([]);
1580
- all = void 0;
1581
- instance = void 0;
1582
- }
1583
- });
1584
- const handle = {
1585
- ids: {
1586
- current: () => {
1587
- owner.check();
1588
- return ids;
1589
- },
1590
- revision: () => {
1591
- owner.check();
1592
- return idsRevision;
1593
- },
1594
- subscribe: (listener) => {
1595
- owner.check();
1596
- idsListeners.add(listener);
1597
- return () => {
1598
- idsListeners.delete(listener);
1599
- };
1600
- }
1601
- },
1602
- all: {
1603
- current: () => {
1604
- owner.check();
1605
- if (!all) {
1606
- require_ownership.profile.collectionView.arrayCopied();
1607
- all = Object.freeze(ids.map((key) => values.get(key)));
1608
- }
1609
- return all;
1610
- },
1611
- revision: () => {
1612
- owner.check();
1613
- return revision;
1614
- },
1615
- subscribe: (listener) => {
1616
- owner.check();
1617
- allListeners.add(listener);
1618
- return () => {
1619
- allListeners.delete(listener);
1620
- };
1621
- }
1622
- },
1623
- item: (key) => {
1624
- owner.check();
1625
- const old = items.get(key);
1626
- if (old) return old;
1627
- itemVersions.set(key, 0);
1628
- const readable = Object.freeze({
1629
- current: () => {
1630
- owner.check();
1631
- return values.get(key);
1632
- },
1633
- revision: () => {
1634
- owner.check();
1635
- return itemVersions.get(key) ?? 0;
1636
- },
1637
- subscribe: (listener) => {
1638
- owner.check();
1639
- const set = itemListeners.get(key) ?? /* @__PURE__ */ new Set();
1640
- set.add(listener);
1641
- itemListeners.set(key, set);
1642
- return () => {
1643
- set.delete(listener);
1644
- if (!set.size) itemListeners.delete(key);
1645
- };
1646
- }
1647
- });
1648
- projectionHandles.add(readable);
1649
- items.set(key, readable);
1650
- return readable;
1651
- },
1652
- revision: () => {
1653
- owner.check();
1654
- return revision;
1655
- },
1656
- subscribe: (listener) => {
1657
- owner.check();
1658
- listeners.add(listener);
1659
- return () => {
1660
- listeners.delete(listener);
1661
- };
1662
- },
1663
- rebuild: owner.rebuild,
1664
- dispose: owner.dispose
1665
- };
1666
- projectionHandles.add(handle.ids);
1667
- projectionHandles.add(handle.all);
1668
- collectionHandles.add(handle);
1669
- owner.install(handle);
1670
- return Object.freeze(handle);
1671
- };
1672
- //#endregion
1673
- //#region core/src/projection/source.ts
1674
- const createSources = (scheduler) => {
1675
- const documents = /* @__PURE__ */ new Map();
1676
- const readables = /* @__PURE__ */ new Map();
1677
- const collections = /* @__PURE__ */ new WeakSet();
1678
- const document = (runtime) => {
1679
- scheduler.assertIdle();
1680
- const state = accessOf(runtime);
1681
- if (state.disposed) throw new Error("Document has been disposed.");
1682
- const existing = documents.get(state);
1683
- if (existing) return existing;
1684
- const bindings = [];
1685
- const make = (targets, collection) => {
1686
- if (state.disposed) throw new Error("Document has been disposed.");
1687
- targets.forEach((value) => {
1688
- if (!belongs(value, state.schema)) throw new Error("Projection target belongs to another schema.");
1689
- });
1690
- const old = bindings.find((entry) => Boolean(collection) === collections.has(entry.handle) && entry.targets.length === targets.length && entry.targets.every((value, i) => same(value, targets[i])));
1691
- if (old) return old.handle;
1692
- let commits = [];
1693
- let reset = false;
1694
- let orderDirty = false;
1695
- const keys = /* @__PURE__ */ new Set();
1696
- let candidates;
1697
- const record = {
1698
- consumers: /* @__PURE__ */ new Set(),
1699
- disposed: false,
1700
- fault: void 0,
1701
- revision: runtime.revision,
1702
- reset: () => reset,
1703
- clear: () => {
1704
- commits = [];
1705
- reset = orderDirty = false;
1706
- keys.clear();
1707
- candidates = void 0;
1708
- },
1709
- context: (active) => {
1710
- assertScope(active);
1711
- if (state.disposed) throw new Error("Document has been disposed.");
1712
- const read = collection ? readerFor(nodeAt(state.schema, collection.address, state.document) ?? collectionSchema(collection), {
1713
- root: () => state.document,
1714
- active
1715
- }, collection.address) : documentReader(state.schema, () => state.document, active);
1716
- return Object.freeze({
1717
- read,
1718
- target: collection,
1719
- revision: runtime.revision(),
1720
- commits: Object.freeze(commits.slice()),
1721
- reset: record.reset(),
1722
- ...collection ? { candidates: candidates ??= Object.freeze({
1723
- keys: Object.freeze([...keys]),
1724
- orderDirty
1725
- }) } : {}
1726
- });
1727
- }
1728
- };
1729
- const handle = collection ? {} : {
1730
- collection: (pick) => {
1731
- scheduler.assertIdle();
1732
- const selector = state.schema.collection(pick);
1733
- return make([selector], selector);
1734
- },
1735
- targets: (...selected) => {
1736
- scheduler.assertIdle();
1737
- if (!selected.length) throw new TypeError("Expected at least one target.");
1738
- return make(selected);
1739
- }
1740
- };
1741
- Object.freeze(handle);
1742
- bindings.push({
1743
- handle,
1744
- targets,
1745
- record
1746
- });
1747
- if (collection) collections.add(handle);
1748
- scheduler.register(handle, record);
1749
- receivers.set(record, (commit) => {
1750
- commits.push(commit);
1751
- reset ||= commit.kind === "replace";
1752
- if (collection) {
1753
- const change = commit.impact.collection(collection);
1754
- if (change.kind === "reset") reset = true;
1755
- else {
1756
- change.added.forEach((key) => keys.add(key));
1757
- change.removed.forEach((key) => keys.add(key));
1758
- change.updated.forEach((key) => keys.add(key));
1759
- orderDirty ||= Boolean(change.added.size || change.removed.size || change.orderChanged);
1760
- }
1761
- candidates = void 0;
1762
- }
1763
- });
1764
- return handle;
1765
- };
1766
- const receivers = /* @__PURE__ */ new Map();
1767
- const handle = make([]);
1768
- const guard = (locked) => {
1769
- state.projectionLocks = (state.projectionLocks ?? 0) + (locked ? 1 : -1);
1770
- };
1771
- scheduler.guards.add(guard);
1772
- const unsubscribe = attachProjection(runtime, {
1773
- capture: (commit) => {
1774
- for (const binding of bindings) if (!binding.targets.length || binding.targets.some(commit.impact.affects)) {
1775
- receivers.get(binding.record)(commit);
1776
- scheduler.capture(binding.record);
1777
- }
1778
- },
1779
- settle: scheduler.settle,
1780
- flush: scheduler.flush,
1781
- dispose: () => {
1782
- bindings.forEach(({ record }) => {
1783
- record.fault = new ProjectionError("source", "document disposed", [runtime.revision()], /* @__PURE__ */ new Error("Document has been disposed."));
1784
- scheduler.capture(record);
1785
- });
1786
- scheduler.run();
1787
- }
1788
- });
1789
- scheduler.cleanups.add(() => {
1790
- unsubscribe();
1791
- scheduler.guards.delete(guard);
1792
- });
1793
- documents.set(state, handle);
1794
- return handle;
1795
- };
1796
- const valueSource = (initial, equal) => {
1797
- let value = initial;
1798
- let previous = initial;
1799
- let revision = 0;
1800
- const handle = Object.freeze({});
1801
- const record = {
1802
- consumers: /* @__PURE__ */ new Set(),
1803
- disposed: false,
1804
- fault: void 0,
1805
- revision: () => revision,
1806
- reset: () => false,
1807
- clear: () => {
1808
- previous = value;
1809
- },
1810
- context: (active) => {
1811
- assertScope(active);
1812
- return Object.freeze({
1813
- value,
1814
- previous,
1815
- revision,
1816
- changed: !equal(previous, value),
1817
- reset: false
1818
- });
1819
- }
1820
- };
1821
- scheduler.register(handle, record);
1822
- const accept = (next) => {
1823
- scheduler.assertIdle();
1824
- const recovering = record.fault !== void 0;
1825
- if (equal(value, next) && !recovering) return;
1826
- record.fault = void 0;
1827
- value = next;
1828
- revision++;
1829
- scheduler.capture(record);
1830
- };
1831
- return {
1832
- source: handle,
1833
- accept,
1834
- set(next) {
1835
- accept(next);
1836
- scheduler.run();
1837
- }
1838
- };
1839
- };
1840
- return {
1841
- dispose: () => {
1842
- documents.clear();
1843
- readables.clear();
1844
- },
1845
- document,
1846
- input: (initial, options) => {
1847
- const { source, set } = valueSource(initial, options?.isEqual ?? Object.is);
1848
- return Object.freeze({
1849
- source,
1850
- set
1851
- });
1852
- },
1853
- fromReadable: (readable, options) => {
1854
- scheduler.assertIdle();
1855
- if (projectionHandles.has(readable)) throw new Error("Projection nodes must be declared directly as sources.");
1856
- const equal = options?.isEqual ?? Object.is;
1857
- let bindings = readables.get(readable);
1858
- const old = bindings?.get(equal);
1859
- if (old) return old.source;
1860
- const input = valueSource(readable.current(), equal);
1861
- if (bindings) {
1862
- bindings.set(equal, {
1863
- source: input.source,
1864
- accept: (value) => input.accept(value)
1865
- });
1866
- return input.source;
1867
- }
1868
- bindings = new Map([[equal, {
1869
- source: input.source,
1870
- accept: (value) => input.accept(value)
1871
- }]]);
1872
- const members = bindings;
1873
- const receive = (settle = true) => {
1874
- if (!scheduler.active) return;
1875
- let value;
1876
- try {
1877
- value = readable.current();
1878
- } catch (cause) {
1879
- for (const member of members.values()) {
1880
- const record = scheduler.source(member.source);
1881
- record.fault = new ProjectionError("source", "external readable", [record.revision()], cause);
1882
- scheduler.capture(record);
1883
- }
1884
- if (settle) scheduler.run();
1885
- return;
1886
- }
1887
- for (const member of members.values()) try {
1888
- member.accept(value);
1889
- } catch (cause) {
1890
- const record = scheduler.source(member.source);
1891
- record.fault = new ProjectionError("source", "external readable", [record.revision()], cause);
1892
- scheduler.capture(record);
1893
- }
1894
- if (settle) scheduler.run();
1895
- };
1896
- let unsubscribe;
1897
- let detach;
1898
- try {
1899
- const owner = documentReadableOwner(readable);
1900
- if (owner) {
1901
- document(owner);
1902
- detach = attachProjection(owner, {
1903
- capture: () => receive(false),
1904
- settle: scheduler.settle,
1905
- flush: scheduler.flush,
1906
- dispose: () => {
1907
- for (const member of members.values()) {
1908
- const record = scheduler.source(member.source);
1909
- record.fault = new ProjectionError("source", "document readable disposed", [record.revision()], /* @__PURE__ */ new Error("Document has been disposed."));
1910
- scheduler.capture(record);
1911
- }
1912
- scheduler.run();
1913
- }
1914
- });
1915
- }
1916
- unsubscribe = readable.subscribe(() => receive());
1917
- input.accept(readable.current());
1918
- } catch (error) {
1919
- try {
1920
- unsubscribe?.();
1921
- detach?.();
1922
- } finally {
1923
- scheduler.unregisterSource(input.source);
1924
- }
1925
- throw error;
1926
- }
1927
- scheduler.cleanups.add(unsubscribe);
1928
- if (detach) scheduler.cleanups.add(detach);
1929
- readables.set(readable, bindings);
1930
- scheduler.run();
1931
- return input.source;
1932
- },
1933
- assertCollection: (handle) => {
1934
- scheduler.source(handle);
1935
- if (!collections.has(handle) && !collectionHandles.has(handle)) throw new Error("map requires a collection source.");
1936
- }
1937
- };
1938
- };
1939
- //#endregion
1940
- //#region core/src/projection/value.ts
1941
- const createValue = (scheduler, spec, options) => {
1942
- let instance;
1943
- let value;
1944
- let next;
1945
- let previous;
1946
- let initialized = false;
1947
- let revision = 0;
1948
- let changed = false;
1949
- let reset = false;
1950
- const listeners = /* @__PURE__ */ new Set();
1951
- const owner = createNode(scheduler, spec, {
1952
- evaluate: (sources, build) => {
1953
- let candidate;
1954
- if (build || !instance) {
1955
- require_ownership.profile.materialized.rebuilt();
1956
- instance = void 0;
1957
- const built = spec.build(sources);
1958
- assertSynchronous(built);
1959
- instance = built;
1960
- candidate = built.value;
1961
- } else {
1962
- require_ownership.profile.materialized.updated();
1963
- const result = instance.update(sources);
1964
- assertSynchronous(result);
1965
- if (result.kind === "rebuild") {
1966
- instance = void 0;
1967
- const built = spec.build(sources);
1968
- assertSynchronous(built);
1969
- instance = built;
1970
- candidate = built.value;
1971
- build = true;
1972
- } else candidate = result.kind === "changed" ? result.value : value;
1973
- }
1974
- previous = value;
1975
- changed = !initialized || !(options?.isEqual ?? Object.is)(value, candidate);
1976
- next = changed ? candidate : value;
1977
- reset = build;
1978
- return changed;
1979
- },
1980
- context: (active) => {
1981
- assertScope(active);
1982
- return Object.freeze({
1983
- value: next,
1984
- previous,
1985
- changed,
1986
- revision: revision + (changed ? 1 : 0),
1987
- reset
1988
- });
1989
- },
1990
- revision: () => revision,
1991
- reset: () => reset,
1992
- publish: () => {
1993
- if (changed && initialized) revision++;
1994
- value = next;
1995
- initialized = true;
1996
- },
1997
- emit: (call) => {
1998
- require_ownership.profile.materialized.notification();
1999
- Array.from(listeners).forEach((listener) => call(listener));
2000
- },
2001
- clear: () => {
2002
- next = value;
2003
- previous = value;
2004
- changed = false;
2005
- reset = false;
2006
- },
2007
- release: () => {
2008
- listeners.clear();
2009
- instance = void 0;
2010
- value = next = previous = void 0;
2011
- }
2012
- });
2013
- const handle = Object.freeze({
2014
- current: () => {
2015
- owner.check();
2016
- return value;
2017
- },
2018
- revision: () => {
2019
- owner.check();
2020
- return revision;
2021
- },
2022
- subscribe: (listener) => {
2023
- owner.check();
2024
- listeners.add(listener);
2025
- return () => {
2026
- listeners.delete(listener);
2027
- };
2028
- },
2029
- rebuild: owner.rebuild,
2030
- dispose: owner.dispose
2031
- });
2032
- owner.install(handle);
2033
- return handle;
2034
- };
2035
- //#endregion
2036
- //#region core/src/projection/runtime.ts
2037
- const debug = /* @__PURE__ */ new WeakMap();
2038
- const projectionDebug = (runtime) => {
2039
- const read = debug.get(runtime);
2040
- if (!read) throw new Error("Unknown projection runtime.");
2041
- return Object.freeze(read());
2042
- };
2043
- const createProjectionRuntime = (options) => {
2044
- const scheduler = createScheduler(options.onError);
2045
- const sources = createSources(scheduler);
2046
- function value(input, computeOrOptions, options) {
2047
- if (typeof computeOrOptions !== "function") return createValue(scheduler, input, computeOrOptions);
2048
- const compute = (input) => {
2049
- const result = computeOrOptions(input);
2050
- assertSynchronous(result);
2051
- return result;
2052
- };
2053
- return createValue(scheduler, {
2054
- sources: input,
2055
- build: (input) => ({
2056
- value: compute(input),
2057
- update: (input) => ({
2058
- kind: "changed",
2059
- value: compute(input)
2060
- })
2061
- })
2062
- }, options);
2063
- }
2064
- const map = (source, mapper, options) => {
2065
- sources.assertCollection(source);
2066
- const calculate = (id, entry) => {
2067
- const value = mapper(id, entry);
2068
- assertSynchronous(value);
2069
- return value;
2070
- };
2071
- return createCollection(scheduler, {
2072
- sources: { source },
2073
- isEqual: options?.isEqual,
2074
- build: ({ sources, writer }) => {
2075
- const input = sources.source;
2076
- const read = "read" in input ? input.read : input;
2077
- const ids = read.ids();
2078
- require_ownership.profile.collectionView.idsScanned(ids.length);
2079
- for (const id of ids) {
2080
- require_ownership.profile.collectionView.mapped();
2081
- writer.set(id, calculate(id, read.get(id)));
2082
- }
2083
- writer.order(ids);
2084
- return { update: ({ sources, writer }) => {
2085
- const input = sources.source;
2086
- if (input.reset) return { kind: "rebuild" };
2087
- const read = "read" in input ? input.read : input;
2088
- let keys;
2089
- let structural;
2090
- if ("candidates" in input) {
2091
- keys = input.candidates.keys;
2092
- structural = input.candidates.orderDirty;
2093
- } else {
2094
- const change = input.change;
2095
- if (!change) return;
2096
- if (change.kind === "reset") return { kind: "rebuild" };
2097
- keys = new Set([
2098
- ...change.added,
2099
- ...change.removed,
2100
- ...change.updated
2101
- ]);
2102
- structural = Boolean(change.added.size || change.removed.size || change.orderChanged);
2103
- }
2104
- for (const key of keys) if (!read.has(key)) writer.remove(key);
2105
- else {
2106
- require_ownership.profile.collectionView.mapped();
2107
- writer.set(key, calculate(key, read.get(key)));
2108
- }
2109
- if (structural) {
2110
- const ids = read.ids();
2111
- require_ownership.profile.collectionView.idsScanned(ids.length);
2112
- writer.order(ids);
2113
- }
2114
- } };
2115
- }
2116
- });
2117
- };
2118
- const runtime = {
2119
- document: sources.document,
2120
- input: sources.input,
2121
- fromReadable: sources.fromReadable,
2122
- value,
2123
- collection: () => (spec) => createCollection(scheduler, spec),
2124
- map,
2125
- batch: scheduler.batch,
2126
- dispose: () => {
2127
- try {
2128
- scheduler.dispose();
2129
- } finally {
2130
- if (!scheduler.active) sources.dispose();
2131
- }
2132
- }
2133
- };
2134
- debug.set(runtime, scheduler.debug);
2135
- return Object.freeze(runtime);
2136
- };
2137
- //#endregion
2138
- Object.defineProperty(exports, "DocumentDisposedError", {
2139
- enumerable: true,
2140
- get: function() {
2141
- return DocumentDisposedError;
2142
- }
2143
- });
2144
- Object.defineProperty(exports, "DocumentReentrancyError", {
2145
- enumerable: true,
2146
- get: function() {
2147
- return DocumentReentrancyError;
2148
- }
2149
- });
2150
- Object.defineProperty(exports, "ProjectionDisposedError", {
2151
- enumerable: true,
2152
- get: function() {
2153
- return ProjectionDisposedError;
2154
- }
2155
- });
2156
- Object.defineProperty(exports, "ProjectionError", {
2157
- enumerable: true,
2158
- get: function() {
2159
- return ProjectionError;
2160
- }
2161
- });
2162
- Object.defineProperty(exports, "accessOf", {
2163
- enumerable: true,
2164
- get: function() {
2165
- return accessOf;
2166
- }
2167
- });
2168
- Object.defineProperty(exports, "address", {
2169
- enumerable: true,
2170
- get: function() {
2171
- return address$1;
2172
- }
2173
- });
2174
- Object.defineProperty(exports, "afterRemove", {
2175
- enumerable: true,
2176
- get: function() {
2177
- return afterRemove;
2178
- }
2179
- });
2180
- Object.defineProperty(exports, "at", {
2181
- enumerable: true,
2182
- get: function() {
2183
- return at;
2184
- }
2185
- });
2186
- Object.defineProperty(exports, "belongs", {
2187
- enumerable: true,
2188
- get: function() {
2189
- return belongs;
2190
- }
2191
- });
2192
- Object.defineProperty(exports, "bindDocumentReadable", {
2193
- enumerable: true,
2194
- get: function() {
2195
- return bindDocumentReadable;
2196
- }
2197
- });
2198
- Object.defineProperty(exports, "bindRuntimeAccess", {
2199
- enumerable: true,
2200
- get: function() {
2201
- return bindRuntimeAccess;
2202
- }
2203
- });
2204
- Object.defineProperty(exports, "commandFootprint", {
2205
- enumerable: true,
2206
- get: function() {
2207
- return commandFootprint;
2208
- }
2209
- });
2210
- Object.defineProperty(exports, "contains", {
2211
- enumerable: true,
2212
- get: function() {
2213
- return contains;
2214
- }
2215
- });
2216
- Object.defineProperty(exports, "createNotification", {
2217
- enumerable: true,
2218
- get: function() {
2219
- return createNotification;
2220
- }
2221
- });
2222
- Object.defineProperty(exports, "createProjectionRuntime", {
2223
- enumerable: true,
2224
- get: function() {
2225
- return createProjectionRuntime;
2226
- }
2227
- });
2228
- Object.defineProperty(exports, "debugKey", {
2229
- enumerable: true,
2230
- get: function() {
2231
- return debugKey;
2232
- }
2233
- });
2234
- Object.defineProperty(exports, "decodeCommandFootprint", {
2235
- enumerable: true,
2236
- get: function() {
2237
- return decodeCommandFootprint;
2238
- }
2239
- });
2240
- Object.defineProperty(exports, "dict", {
2241
- enumerable: true,
2242
- get: function() {
2243
- return dict;
2244
- }
2245
- });
2246
- Object.defineProperty(exports, "disposeNotification", {
2247
- enumerable: true,
2248
- get: function() {
2249
- return disposeNotification;
2250
- }
2251
- });
2252
- Object.defineProperty(exports, "documentReader", {
2253
- enumerable: true,
2254
- get: function() {
2255
- return documentReader;
2256
- }
2257
- });
2258
- Object.defineProperty(exports, "field", {
2259
- enumerable: true,
2260
- get: function() {
2261
- return field;
2262
- }
2263
- });
2264
- Object.defineProperty(exports, "footprintsOverlap", {
2265
- enumerable: true,
2266
- get: function() {
2267
- return footprintsOverlap;
2268
- }
2269
- });
2270
- Object.defineProperty(exports, "id", {
2271
- enumerable: true,
2272
- get: function() {
2273
- return id;
2274
- }
2275
- });
2276
- Object.defineProperty(exports, "impact_target_exports", {
2277
- enumerable: true,
2278
- get: function() {
2279
- return impact_target_exports;
2280
- }
2281
- });
2282
- Object.defineProperty(exports, "index", {
2283
- enumerable: true,
2284
- get: function() {
2285
- return index;
2286
- }
2287
- });
2288
- Object.defineProperty(exports, "keys", {
2289
- enumerable: true,
2290
- get: function() {
2291
- return keys;
2292
- }
2293
- });
2294
- Object.defineProperty(exports, "list", {
2295
- enumerable: true,
2296
- get: function() {
2297
- return list;
2298
- }
2299
- });
2300
- Object.defineProperty(exports, "locate", {
2301
- enumerable: true,
2302
- get: function() {
2303
- return locate;
2304
- }
2305
- });
2306
- Object.defineProperty(exports, "map", {
2307
- enumerable: true,
2308
- get: function() {
2309
- return map;
2310
- }
2311
- });
2312
- Object.defineProperty(exports, "notify", {
2313
- enumerable: true,
2314
- get: function() {
2315
- return notify;
2316
- }
2317
- });
2318
- Object.defineProperty(exports, "object", {
2319
- enumerable: true,
2320
- get: function() {
2321
- return object;
2322
- }
2323
- });
2324
- Object.defineProperty(exports, "optional", {
2325
- enumerable: true,
2326
- get: function() {
2327
- return optional;
2328
- }
2329
- });
2330
- Object.defineProperty(exports, "overlaps", {
2331
- enumerable: true,
2332
- get: function() {
2333
- return overlaps;
2334
- }
2335
- });
2336
- Object.defineProperty(exports, "projectionDebug", {
2337
- enumerable: true,
2338
- get: function() {
2339
- return projectionDebug;
2340
- }
2341
- });
2342
- Object.defineProperty(exports, "read", {
2343
- enumerable: true,
2344
- get: function() {
2345
- return read;
2346
- }
2347
- });
2348
- Object.defineProperty(exports, "readWith", {
2349
- enumerable: true,
2350
- get: function() {
2351
- return readWith;
2352
- }
2353
- });
2354
- Object.defineProperty(exports, "resolveAddress", {
2355
- enumerable: true,
2356
- get: function() {
2357
- return resolveAddress;
2358
- }
2359
- });
2360
- Object.defineProperty(exports, "resolveLocated", {
2361
- enumerable: true,
2362
- get: function() {
2363
- return resolveLocated;
2364
- }
2365
- });
2366
- Object.defineProperty(exports, "restore", {
2367
- enumerable: true,
2368
- get: function() {
2369
- return restore;
2370
- }
2371
- });
2372
- Object.defineProperty(exports, "same", {
2373
- enumerable: true,
2374
- get: function() {
2375
- return same;
2376
- }
2377
- });
2378
- Object.defineProperty(exports, "schema", {
2379
- enumerable: true,
2380
- get: function() {
2381
- return schema;
2382
- }
2383
- });
2384
- Object.defineProperty(exports, "set", {
2385
- enumerable: true,
2386
- get: function() {
2387
- return set;
2388
- }
2389
- });
2390
- Object.defineProperty(exports, "shareNotification", {
2391
- enumerable: true,
2392
- get: function() {
2393
- return shareNotification;
2394
- }
2395
- });
2396
- Object.defineProperty(exports, "subscribeRoot", {
2397
- enumerable: true,
2398
- get: function() {
2399
- return subscribeRoot;
2400
- }
2401
- });
2402
- Object.defineProperty(exports, "subscribeTargets", {
2403
- enumerable: true,
2404
- get: function() {
2405
- return subscribeTargets;
2406
- }
2407
- });
2408
- Object.defineProperty(exports, "table", {
2409
- enumerable: true,
2410
- get: function() {
2411
- return table;
2412
- }
2413
- });
2414
- Object.defineProperty(exports, "tree", {
2415
- enumerable: true,
2416
- get: function() {
2417
- return tree;
2418
- }
2419
- });
2420
- Object.defineProperty(exports, "valid", {
2421
- enumerable: true,
2422
- get: function() {
2423
- return valid;
2424
- }
2425
- });
2426
- Object.defineProperty(exports, "validPositions", {
2427
- enumerable: true,
2428
- get: function() {
2429
- return validPositions;
2430
- }
2431
- });
2432
- Object.defineProperty(exports, "variant", {
2433
- enumerable: true,
2434
- get: function() {
2435
- return variant;
2436
- }
2437
- });
2438
-
2439
- //# sourceMappingURL=runtime-0mOFbe_H.cjs.map