@solidjs/signals 2.0.0-rc.0 → 2.0.0-rc.10
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/README.md +1 -1
- package/dist/dev-shared.js +7138 -0
- package/dist/dev.attribution.js +3307 -0
- package/dist/dev.js +8076 -6692
- package/dist/observe/affects.js +129 -0
- package/dist/observe/attribution.js +7 -0
- package/dist/observe/boundaries.js +793 -0
- package/dist/observe/core/action.js +177 -0
- package/dist/observe/core/async.js +849 -0
- package/dist/observe/core/attribution-costs.js +66 -0
- package/dist/observe/core/attribution-feedback.js +280 -0
- package/dist/observe/core/attribution-hooks.js +83 -0
- package/dist/observe/core/attribution-queries.js +43 -0
- package/dist/observe/core/attribution.js +2904 -0
- package/dist/observe/core/constants.js +283 -0
- package/dist/{types-cjs/core/context.d.cts → observe/core/context.js} +37 -12
- package/dist/observe/core/core.js +1999 -0
- package/dist/observe/core/dev.js +343 -0
- package/dist/observe/core/effect.js +200 -0
- package/dist/observe/core/error-hooks.js +71 -0
- package/dist/observe/core/error.js +80 -0
- package/dist/observe/core/external.js +98 -0
- package/dist/observe/core/graph.js +155 -0
- package/dist/observe/core/heap.js +147 -0
- package/dist/observe/core/invariants.js +45 -0
- package/dist/observe/core/lanes.js +205 -0
- package/dist/observe/core/optimistic.js +627 -0
- package/dist/observe/core/owner.js +353 -0
- package/dist/observe/core/scheduler.js +1547 -0
- package/dist/observe/core/verdict.js +674 -0
- package/dist/observe/index.js +59 -0
- package/dist/observe/map.js +484 -0
- package/dist/observe/signals.js +731 -0
- package/dist/observe/store/index.js +44 -0
- package/dist/observe/store/next/optimistic.js +717 -0
- package/dist/observe/store/next/projection.js +266 -0
- package/dist/observe/store/next/reconcile.js +375 -0
- package/dist/observe/store/next/store.js +2480 -0
- package/dist/observe/store/next/target.js +51 -0
- package/dist/observe/store/store.js +331 -0
- package/dist/observe/store/storePath.js +103 -0
- package/dist/observe/store/utils.js +1070 -0
- package/dist/prod/affects.js +10 -9
- package/dist/prod/attribution.js +45 -0
- package/dist/prod/boundaries.js +388 -178
- package/dist/prod/core/action.js +65 -37
- package/dist/prod/core/async.js +477 -208
- package/dist/prod/core/attribution-hooks.js +3 -0
- package/dist/prod/core/constants.js +186 -1
- package/dist/prod/core/context.js +10 -16
- package/dist/prod/core/core.js +1556 -415
- package/dist/prod/core/dev.js +18 -1
- package/dist/prod/core/effect.js +119 -79
- package/dist/prod/core/error-hooks.js +71 -0
- package/dist/prod/core/error.js +13 -1
- package/dist/prod/core/external.js +4 -4
- package/dist/prod/core/graph.js +105 -54
- package/dist/prod/core/heap.js +72 -65
- package/dist/prod/core/invariants.js +3 -2
- package/dist/prod/core/lanes.js +117 -52
- package/dist/prod/core/optimistic.js +474 -103
- package/dist/prod/core/owner.js +131 -84
- package/dist/prod/core/scheduler.js +1013 -248
- package/dist/prod/core/verdict.js +418 -113
- package/dist/prod/index.js +25 -13
- package/dist/prod/map.js +314 -151
- package/dist/prod/signals.js +382 -32
- package/dist/prod/store/index.js +38 -0
- package/dist/prod/store/next/optimistic.js +710 -0
- package/dist/prod/store/next/projection.js +257 -0
- package/dist/prod/store/next/reconcile.js +373 -0
- package/dist/prod/store/next/store.js +2356 -0
- package/dist/prod/store/next/target.js +51 -0
- package/dist/prod/store/store.js +129 -881
- package/dist/prod/store/utils.js +982 -242
- package/dist/types/attribution.d.ts +19 -0
- package/dist/types/attribution.prod.d.ts +22 -0
- package/dist/types/boundaries.d.ts +78 -5
- package/dist/types/core/action.d.ts +12 -5
- package/dist/types/core/async.d.ts +3 -1
- package/dist/types/core/attribution-costs.d.ts +35 -0
- package/dist/types/core/attribution-feedback.d.ts +133 -0
- package/dist/types/core/attribution-hooks.d.ts +304 -0
- package/dist/types/core/attribution-queries.d.ts +24 -0
- package/dist/types/core/attribution.d.ts +892 -0
- package/dist/types/core/constants.d.ts +179 -0
- package/dist/types/core/core.d.ts +305 -23
- package/dist/types/core/dev.d.ts +421 -8
- package/dist/types/core/effect.d.ts +8 -1
- package/dist/types/core/error-hooks.d.ts +71 -0
- package/dist/types/core/error.d.ts +9 -0
- package/dist/types/core/graph.d.ts +23 -0
- package/dist/types/core/heap.d.ts +5 -3
- package/dist/types/core/index.d.ts +6 -3
- package/dist/types/core/invariants.d.ts +5 -1
- package/dist/types/core/lanes.d.ts +51 -19
- package/dist/types/core/owner.d.ts +15 -3
- package/dist/types/core/scheduler.d.ts +252 -3
- package/dist/types/core/types.d.ts +124 -41
- package/dist/types/index.d.ts +18 -5
- package/dist/types/map.d.ts +2 -0
- package/dist/types/signals.d.ts +164 -13
- package/dist/types/store/index.d.ts +16 -5
- package/dist/types/store/next/optimistic.d.ts +25 -0
- package/dist/types/store/next/projection.d.ts +27 -0
- package/dist/types/store/next/reconcile.d.ts +10 -0
- package/dist/types/store/next/store.d.ts +143 -0
- package/dist/types/store/next/target.d.ts +196 -0
- package/dist/types/store/store.d.ts +46 -112
- package/dist/types/store/utils.d.ts +188 -40
- package/package.json +32 -26
- package/dist/node.cjs +0 -7938
- package/dist/prod/store/optimistic.js +0 -217
- package/dist/prod/store/projection.js +0 -231
- package/dist/prod/store/reconcile.js +0 -707
- package/dist/types/store/optimistic.d.ts +0 -45
- package/dist/types/store/projection.d.ts +0 -70
- package/dist/types/store/reconcile.d.ts +0 -46
- package/dist/types-cjs/affects.d.cts +0 -47
- package/dist/types-cjs/boundaries.d.cts +0 -175
- package/dist/types-cjs/core/action.d.cts +0 -64
- package/dist/types-cjs/core/async.d.cts +0 -21
- package/dist/types-cjs/core/constants.d.cts +0 -71
- package/dist/types-cjs/core/core.d.cts +0 -148
- package/dist/types-cjs/core/dev.d.cts +0 -64
- package/dist/types-cjs/core/effect.d.cts +0 -30
- package/dist/types-cjs/core/error.d.cts +0 -47
- package/dist/types-cjs/core/external.d.cts +0 -15
- package/dist/types-cjs/core/graph.d.cts +0 -5
- package/dist/types-cjs/core/heap.d.cts +0 -22
- package/dist/types-cjs/core/index.d.cts +0 -13
- package/dist/types-cjs/core/invariants.d.cts +0 -59
- package/dist/types-cjs/core/lanes.d.cts +0 -56
- package/dist/types-cjs/core/optimistic.d.cts +0 -6
- package/dist/types-cjs/core/owner.d.cts +0 -124
- package/dist/types-cjs/core/scheduler.d.cts +0 -170
- package/dist/types-cjs/core/types.d.cts +0 -148
- package/dist/types-cjs/core/verdict.d.cts +0 -2
- package/dist/types-cjs/index.d.cts +0 -10
- package/dist/types-cjs/map.d.cts +0 -69
- package/dist/types-cjs/package.json +0 -3
- package/dist/types-cjs/signals.d.cts +0 -605
- package/dist/types-cjs/store/index.d.cts +0 -9
- package/dist/types-cjs/store/optimistic.d.cts +0 -45
- package/dist/types-cjs/store/projection.d.cts +0 -70
- package/dist/types-cjs/store/reconcile.d.cts +0 -46
- package/dist/types-cjs/store/store.d.cts +0 -213
- package/dist/types-cjs/store/storePath.d.cts +0 -58
- package/dist/types-cjs/store/utils.d.cts +0 -114
|
@@ -1,16 +1,18 @@
|
|
|
1
|
-
import { EFFECT_RENDER, EFFECT_USER, STATUS_PENDING, REACTIVE_IN_HEAP_HEIGHT, REACTIVE_DISPOSED,
|
|
1
|
+
import { EFFECT_RENDER, EFFECT_USER, STATUS_PENDING, CONFIG_ADOPTED_UNFLUSHED, NOT_PENDING, REACTIVE_MANUAL_WRITE, STATUS_UNINITIALIZED, REACTIVE_OPTIMISTIC_DIRTY, REACTIVE_IN_HEAP_HEIGHT, REACTIVE_DISPOSED, CONFIG_HELD_TRUTH, CONFIG_HAS_COMPANIONS, EFFECT_TRACKED, CONFIG_INPUTS_PUBLISHED, REACTIVE_ZOMBIE, CONFIG_LANE_FRAME, CONFIG_HAS_LANE, CONFIG_HAS_SNAPSHOT, REACTIVE_RECOMPUTING_DEPS, REACTIVE_MISSED_WAKE, CONFIG_IN_SNAPSHOT_SCOPE, REACTIVE_SNAPSHOT_STALE, CONFIG_SLOT_NODE, CONFIG_HELD_CHILDREN, REACTIVE_REASK, CONFIG_AUTHORITATIVE_READ } from "./constants.js";
|
|
2
2
|
|
|
3
|
-
import { currentOptimisticLane } from "./core.js";
|
|
3
|
+
import { resyncUnflushedCompanions, currentOptimisticLane, slotUnobservedHook, markUnflushedStaged, hasActiveOverride } from "./core.js";
|
|
4
4
|
|
|
5
5
|
import { DEV } from "./dev.js";
|
|
6
6
|
|
|
7
7
|
import { NotReadyError } from "./error.js";
|
|
8
8
|
|
|
9
|
+
import { sweepDormant, trimStaleDeps } from "./graph.js";
|
|
10
|
+
|
|
9
11
|
import { runHeap, deleteFromHeap, enqueueSub } from "./heap.js";
|
|
10
12
|
|
|
11
13
|
import { activeLanes, assignOrMergeLane, findLane } from "./lanes.js";
|
|
12
14
|
|
|
13
|
-
export { getOrCreateLane,
|
|
15
|
+
export { getOrCreateLane, mergeLanes, resolveLane } from "./lanes.js";
|
|
14
16
|
|
|
15
17
|
import { devCheckFlushStart, devCheckActiveOverrides, devCensusCompanions, devCheckQuiescent } from "./invariants.js";
|
|
16
18
|
|
|
@@ -19,26 +21,44 @@ const transitions = new Set;
|
|
|
19
21
|
const dirtyQueue = {
|
|
20
22
|
eE: new Array(2e3).fill(undefined),
|
|
21
23
|
tE: false,
|
|
22
|
-
|
|
24
|
+
ln: 0,
|
|
23
25
|
EE: 0
|
|
24
26
|
};
|
|
25
27
|
|
|
26
28
|
const zombieQueue = {
|
|
27
29
|
eE: new Array(2e3).fill(undefined),
|
|
28
30
|
tE: false,
|
|
29
|
-
|
|
31
|
+
ln: 0,
|
|
30
32
|
EE: 0
|
|
31
33
|
};
|
|
32
34
|
|
|
33
35
|
/** runHeap callback that discards a queued zombie recompute instead of running
|
|
34
36
|
* it: unlink pure recompute entries; strip just the recompute bit from dirtied
|
|
35
|
-
* height-adjust entries so their height work still happens.
|
|
36
|
-
|
|
37
|
+
* height-adjust entries so their height work still happens. A zombie dirtied
|
|
38
|
+
* through the lane channel (OPTIMISTIC_DIRTY — an override or a `latest()`
|
|
39
|
+
* companion) runs instead (#3444): a zombie renders mainline until the commit
|
|
40
|
+
* disposes it, and the lane's values ARE the mainline frame — the still-visible
|
|
41
|
+
* branch a held `Show` is removing showed the old `latest(count)` beside the
|
|
42
|
+
* new one outside. Its pass runs under the lane and its run lands on the
|
|
43
|
+
* lane's effect queue, so a held lane defers it exactly as it defers every
|
|
44
|
+
* other reader's. */ function cancelZombieRecompute(e) {
|
|
45
|
+
if (e.oe & REACTIVE_OPTIMISTIC_DIRTY && !laneZombie(e)) return GlobalQueue.Ke(e);
|
|
46
|
+
if (e.oe & REACTIVE_IN_HEAP_HEIGHT) e.oe &= -140; else {
|
|
37
47
|
deleteFromHeap(e, zombieQueue);
|
|
38
|
-
e.
|
|
48
|
+
e.oe &= -132;
|
|
39
49
|
}
|
|
40
50
|
}
|
|
41
51
|
|
|
52
|
+
/** A member of a parked LANE frame (CONFIG_LANE_FRAME on the owner whose pass
|
|
53
|
+
* parked it, #3662). The #3444 exception is for transaction zombies; a lane
|
|
54
|
+
* frame's member is retired by the run that carries the lane's values, so its
|
|
55
|
+
* lane-channel recompute is cancelled with the rest — run, it republished the
|
|
56
|
+
* retired frame under those values. Mainline writes still reach it (#3463). */ function laneZombie(e) {
|
|
57
|
+
let t = e;
|
|
58
|
+
while (t !== null && t.oe & REACTIVE_ZOMBIE) t = t._parent;
|
|
59
|
+
return t !== null && (t.C & CONFIG_LANE_FRAME) !== 0;
|
|
60
|
+
}
|
|
61
|
+
|
|
42
62
|
let clock = 0;
|
|
43
63
|
|
|
44
64
|
let activeTransition = null;
|
|
@@ -53,36 +73,51 @@ let syncDepth = 0;
|
|
|
53
73
|
|
|
54
74
|
let projectionWriteActive = false;
|
|
55
75
|
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
76
|
+
/** > 0 while an action's generator body is on the stack (the synchronous
|
|
77
|
+
* slice between yields). Maintained by action.ts around `it.next()`. */ let actionStepDepth = 0;
|
|
78
|
+
|
|
79
|
+
function enterActionStep() {
|
|
80
|
+
actionStepDepth++;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
function exitActionStep() {
|
|
84
|
+
actionStepDepth--;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
// Store property nodes whose last subscriber left while they carried state
|
|
88
|
+
// the backing cannot reconstruct — an optimistic override (overrides live on
|
|
89
|
+
// nodes, over a clone the setter discards) or a staged write. Releasing the
|
|
90
|
+
// slot then would drop the override: an optimistic store key read `0` the
|
|
91
|
+
// moment its only reader gated away while the action was live (S7). Swept
|
|
92
|
+
// after each flush — a node still without subs whose override and staging
|
|
93
|
+
// have resolved is released through the slot hook; one that regained a
|
|
94
|
+
// subscriber leaves the set.
|
|
60
95
|
const transientStoreNodes = new Set;
|
|
61
96
|
|
|
62
|
-
function
|
|
97
|
+
/** Slot hook's deferral: release this node when its carried state resolves. */ function deferSlotRelease(e) {
|
|
63
98
|
transientStoreNodes.add(e);
|
|
64
99
|
}
|
|
65
100
|
|
|
66
101
|
function canUseSimpleSyncFlush(e) {
|
|
67
102
|
const t = e.m;
|
|
68
|
-
return transitions.size === 0 && activeLanes.size === 0 && e.
|
|
103
|
+
return transitions.size === 0 && activeLanes.size === 0 && e.ft.length === 0 && t.cn.length === 0 && t.A.length === 0 && t.ri.size === 0 && transientStoreNodes.size === 0 && pendingRearms.size === 0;
|
|
69
104
|
}
|
|
70
105
|
|
|
71
106
|
function sweepTransientStoreNodes() {
|
|
72
107
|
if (transientStoreNodes.size === 0) return;
|
|
73
108
|
for (const e of transientStoreNodes) {
|
|
74
|
-
if (e.
|
|
109
|
+
if (e.u !== null) {
|
|
75
110
|
transientStoreNodes.delete(e);
|
|
76
111
|
continue;
|
|
77
112
|
}
|
|
78
|
-
if (e.
|
|
79
|
-
if (e.
|
|
113
|
+
if (e._e !== NOT_PENDING) continue;
|
|
114
|
+
if (e.o?.Fe !== undefined && e.o?.Fe !== NOT_PENDING) continue;
|
|
80
115
|
// A live affects() mark keeps the node addressable: sweeping it would
|
|
81
116
|
// detach the refcount from the slot (a fresh probe would upsert a new,
|
|
82
117
|
// unmarked node for the same property).
|
|
83
|
-
if (e.t) continue;
|
|
118
|
+
if (e.o?.t) continue;
|
|
84
119
|
transientStoreNodes.delete(e);
|
|
85
|
-
e.
|
|
120
|
+
if (e.C & CONFIG_SLOT_NODE) slotUnobservedHook(e); else e.o?.Hn?.();
|
|
86
121
|
}
|
|
87
122
|
}
|
|
88
123
|
|
|
@@ -109,32 +144,34 @@ function setProjectionWriteActive(e) {
|
|
|
109
144
|
* land there directly — no per-field aliasing.
|
|
110
145
|
*/ function createBatch() {
|
|
111
146
|
return {
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
147
|
+
be: clock,
|
|
148
|
+
Gn: [],
|
|
149
|
+
le: new Map,
|
|
150
|
+
cn: [],
|
|
116
151
|
A: [],
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
152
|
+
ri: new Set,
|
|
153
|
+
pe: [],
|
|
154
|
+
dt: {
|
|
155
|
+
Tt: [ [], [] ],
|
|
156
|
+
ft: []
|
|
122
157
|
},
|
|
123
|
-
|
|
124
|
-
|
|
158
|
+
Rn: false,
|
|
159
|
+
In: new Set,
|
|
160
|
+
Dn: null
|
|
125
161
|
};
|
|
126
162
|
}
|
|
127
163
|
|
|
128
164
|
function mergeTransitionState(e, t) {
|
|
129
|
-
t.
|
|
130
|
-
e.
|
|
131
|
-
|
|
132
|
-
if (t
|
|
165
|
+
t.Rn = e;
|
|
166
|
+
e.pe.push(...t.pe);
|
|
167
|
+
e.Te ||= t.Te;
|
|
168
|
+
for (const n of activeLanes) if (n.we === t) n.we = e;
|
|
169
|
+
if (t.cn.length) {
|
|
133
170
|
// Move (don't copy): the global queue's batch may still be the outgoing
|
|
134
171
|
// transition, and the adoption pass in initTransition would re-push its
|
|
135
172
|
// contents into the target — duplicating every entry.
|
|
136
|
-
e.
|
|
137
|
-
t.
|
|
173
|
+
e.cn.push(...t.cn);
|
|
174
|
+
t.cn.length = 0;
|
|
138
175
|
}
|
|
139
176
|
if (t.A.length) {
|
|
140
177
|
// Move (don't copy): the global queue's batch may still be the outgoing
|
|
@@ -143,15 +180,120 @@ function mergeTransitionState(e, t) {
|
|
|
143
180
|
e.A.push(...t.A);
|
|
144
181
|
t.A.length = 0;
|
|
145
182
|
}
|
|
146
|
-
for (const
|
|
147
|
-
for (const [
|
|
148
|
-
let t = e.
|
|
149
|
-
if (!t) e.
|
|
150
|
-
for (const e of
|
|
183
|
+
for (const n of t.ri) e.ri.add(n);
|
|
184
|
+
for (const [n, i] of t.le) {
|
|
185
|
+
let t = e.le.get(n);
|
|
186
|
+
if (!t) e.le.set(n, t = new Set);
|
|
187
|
+
for (const e of i) t.add(e);
|
|
188
|
+
}
|
|
189
|
+
for (const n of t.In) e.In.add(n);
|
|
190
|
+
if (t.Dn) (e.Dn ??= []).push(...t.Dn);
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
/**
|
|
194
|
+
* Flip-entanglement (#3164 follow-up): `until()` is a declaration of
|
|
195
|
+
* relatedness — the predicate names the condition that confirms the awaiting
|
|
196
|
+
* transaction. When the predicate settles truthy, every live foreign
|
|
197
|
+
* transition whose staged write it read IS the confirming event by the
|
|
198
|
+
* user's own definition, so it merges into the awaiting transaction and
|
|
199
|
+
* reveals at the joint settle — the cross-primitive twin of the family fold
|
|
200
|
+
* (a landing on an optimism-carrying family joins the retaining
|
|
201
|
+
* transaction). Non-flipping updates never pass through here: falsy
|
|
202
|
+
* evaluations don't entangle, so unrelated traffic on the watched sources
|
|
203
|
+
* reveals freely on its own schedule.
|
|
204
|
+
*
|
|
205
|
+
* Runs inside the predicate's compute (pure phase) — the confirming
|
|
206
|
+
* transition's stamps are still live and its commit decision hasn't run, so
|
|
207
|
+
* the merge lands before any reveal. Only the tree-shaken graphs that call
|
|
208
|
+
* `until()` retain this.
|
|
209
|
+
*/ function entangleConfirmingTransitions(e, t) {
|
|
210
|
+
t = currentTransition(t);
|
|
211
|
+
if (t.Rn === true) return;
|
|
212
|
+
// The confirming evidence is a dep whose value is STAGED (pending,
|
|
213
|
+
// uncommitted) at flip evaluation — committed deps are public already and
|
|
214
|
+
// carry nothing to entangle. A staged dep lives in one of two carriers: a
|
|
215
|
+
// stamped transition, or the queue's current batch (ambient registrations
|
|
216
|
+
// don't stamp; "ambient work IS a transaction" — the batch is the
|
|
217
|
+
// carrier). The entangle STEALS the carrier's staged cargo — its pending
|
|
218
|
+
// nodes move (re-stamped) into the awaiting transaction and reveal at its
|
|
219
|
+
// settle — but never the carrier itself: its async reporters, actions,
|
|
220
|
+
// and stashes are its own future (a live stream's flight must not chain
|
|
221
|
+
// the awaiting transaction to landings that haven't happened; a merged
|
|
222
|
+
// reporter deadlocked exactly that way).
|
|
223
|
+
let n = false;
|
|
224
|
+
for (let i = e.Ie; i !== null; i = i.Ne) {
|
|
225
|
+
const r = i.Oe;
|
|
226
|
+
if (r._e !== NOT_PENDING) {
|
|
227
|
+
const e = r.we;
|
|
228
|
+
const i = e != null ? currentTransition(e) : null;
|
|
229
|
+
// Skip the awaiting transaction's own cargo (t === target: a
|
|
230
|
+
// fold-staged landing or a write the action itself issued — hold and
|
|
231
|
+
// reveal already correct) and dead carriers. Ambient-batch staging
|
|
232
|
+
// (t === null) must leave the batch NOW — it commits at this flush's
|
|
233
|
+
// end, which would reveal the confirmation under the live optimism
|
|
234
|
+
// it just confirmed.
|
|
235
|
+
const s = i === null ? currentBatch.Gn : i !== t && i.Rn !== true ? i.Gn : null;
|
|
236
|
+
if (s !== null) n = stealEntangledCargo(s, t) || n;
|
|
237
|
+
}
|
|
238
|
+
if (i === e.Nn) break;
|
|
239
|
+
}
|
|
240
|
+
// The steal never activates the awaiting transaction: the predicate can
|
|
241
|
+
// flip inside another transaction's finalize heap, and adopting the queue
|
|
242
|
+
// batch there hands the stolen cargo to that finalize's commit sweep — a
|
|
243
|
+
// premature reveal at a foreign settle. Subscribers that computed against
|
|
244
|
+
// the pre-steal world were re-dirtied by the steal itself, so this
|
|
245
|
+
// flush's applies paint the mid-hold view (committed for lane and stale
|
|
246
|
+
// readers; a deriving reader is held with the cargo); the cargo commits
|
|
247
|
+
// at the awaiting transaction's own settle.
|
|
248
|
+
}
|
|
249
|
+
|
|
250
|
+
/** Move a confirming carrier's staged nodes into the awaiting transaction:
|
|
251
|
+
* re-stamp and arm the held-truth mask (override-covered nodes skip it —
|
|
252
|
+
* the override already hides their staged value per A17, and is usually
|
|
253
|
+
* the very optimism this confirmation settles); the mask's commit
|
|
254
|
+
* registers the settle-side post-revert wake. The carrier's array is
|
|
255
|
+
* emptied so its own commit point commits none of the stolen cargo.
|
|
256
|
+
*
|
|
257
|
+
* EFFECT subs of stolen nodes re-run: any that recomputed against the
|
|
258
|
+
* staging BEFORE the steal (the carrier's landing notified them as a plain
|
|
259
|
+
* write) hold a private result derived from the carrier's world — one
|
|
260
|
+
* that the next paint gate (stash-point lane run, a foreign flush's
|
|
261
|
+
* completion drain) would apply as the carrier's. Re-running them now that
|
|
262
|
+
* the cargo is the awaiting transaction's re-routes each by its posture in
|
|
263
|
+
* this same heap pass: a lane pass keeps committed (the mask), a stale
|
|
264
|
+
* render effect keeps committed and registers for the reveal's replay
|
|
265
|
+
* (stale-of-foreign), and a deriving user effect is served the truth and
|
|
266
|
+
* held with the transaction (A29). PURE computeds are deliberately NOT
|
|
267
|
+
* re-run: a staged value of theirs is itself stolen cargo — held with the
|
|
268
|
+
* transaction, so ordinary readers already serve their committed value —
|
|
269
|
+
* while re-running them would re-derive the OLD world and re-stage it over
|
|
270
|
+
* the held truth. The reveal re-notifies (commitPendingNodes), which is
|
|
271
|
+
* when they re-derive for real. */ function stealEntangledCargo(e, t) {
|
|
272
|
+
if (e === t.Gn || e.length === 0) return false;
|
|
273
|
+
for (let n = 0; n < e.length; n++) {
|
|
274
|
+
const i = e[n];
|
|
275
|
+
i.we = t;
|
|
276
|
+
t.Gn.push(i);
|
|
277
|
+
// Override-covered nodes stay silent AND unmasked: the override is the
|
|
278
|
+
// display (A17 — its staging never notified, its revert will), so their
|
|
279
|
+
// subs saw nothing and re-running one would break the silence with a
|
|
280
|
+
// duplicate fire of an unchanged view.
|
|
281
|
+
if (!hasActiveOverride(i)) {
|
|
282
|
+
i.C |= CONFIG_HELD_TRUTH;
|
|
283
|
+
for (let e = i.u; e !== null; e = e.Ae) {
|
|
284
|
+
const t = e.ge;
|
|
285
|
+
if (t.je && !(t.C & CONFIG_AUTHORITATIVE_READ)) enqueueSub(t);
|
|
286
|
+
}
|
|
287
|
+
}
|
|
151
288
|
}
|
|
152
|
-
|
|
289
|
+
e.length = 0;
|
|
290
|
+
transitions.add(t);
|
|
291
|
+
return true;
|
|
153
292
|
}
|
|
154
293
|
|
|
294
|
+
/** `schedule()` armed `scheduled` but withheld the microtask because a
|
|
295
|
+
* projection draft was writing (see below). Consumed by `scheduleWithheld`. */ let withheld = false;
|
|
296
|
+
|
|
155
297
|
function schedule() {
|
|
156
298
|
if (halted) {
|
|
157
299
|
notifyHalted();
|
|
@@ -159,21 +301,112 @@ function schedule() {
|
|
|
159
301
|
}
|
|
160
302
|
if (scheduled) return;
|
|
161
303
|
scheduled = true;
|
|
162
|
-
if (!syncDepth && !globalQueue.
|
|
304
|
+
if (!syncDepth && !globalQueue.Jn) {
|
|
305
|
+
// A projection draft's writes withhold the microtask: a flight's landing
|
|
306
|
+
// drains them (asyncWrite's flush), and a drain BEFORE the landing tears
|
|
307
|
+
// the pre- and post-await halves of the run apart (createProjection.async
|
|
308
|
+
// "notifies only changed paths"). A draft write that no landing will
|
|
309
|
+
// follow re-arms through scheduleWithheld (proj R37).
|
|
310
|
+
withheld = projectionWriteActive;
|
|
311
|
+
if (!withheld) queueMicrotask(flush);
|
|
312
|
+
}
|
|
313
|
+
}
|
|
314
|
+
|
|
315
|
+
/** Arm the microtask `schedule()` withheld under projectionWriteActive. The
|
|
316
|
+
* projection draft calls this after a write made outside its run with no
|
|
317
|
+
* flight up (proj R37): nothing else will drain, and leaving `scheduled`
|
|
318
|
+
* armed with no microtask strands the whole scheduler — every later
|
|
319
|
+
* `schedule()` early-returns — until something calls `flush()` by hand.
|
|
320
|
+
* (`withheld` was set in the same synchronous slice as this call, so the
|
|
321
|
+
* syncDepth/_running gates it passed still hold; a stale mark left by a
|
|
322
|
+
* landing's own flush arms at worst one no-op drain.) */ function scheduleWithheld() {
|
|
323
|
+
if (withheld) {
|
|
324
|
+
withheld = false;
|
|
325
|
+
queueMicrotask(flush);
|
|
326
|
+
}
|
|
327
|
+
}
|
|
328
|
+
|
|
329
|
+
/**
|
|
330
|
+
* Parked transactions whose reporter set changed without a write. A
|
|
331
|
+
* transaction completes when nothing live reports a flight it waits on, but
|
|
332
|
+
* the flush only judges the ACTIVE transaction: a parked one is re-entered by
|
|
333
|
+
* a stamped node's landing or an action's resume. A reporter that stops
|
|
334
|
+
* counting for another reason — its loading boundary flipped to the fallback
|
|
335
|
+
* (#3375), or it was disposed by ambient work (#3372) — is neither: the
|
|
336
|
+
* pruning in `reporterBlocksSource` would drop it at the next check, but no
|
|
337
|
+
* check comes, and the writes held with it stay staged. Such sites record the
|
|
338
|
+
* transaction here (deduped: one idle pass per transaction, however many
|
|
339
|
+
* reporters changed); the flush re-enters it on an otherwise idle pass, so
|
|
340
|
+
* the re-evaluation adopts no unrelated ambient work.
|
|
341
|
+
*/ const wokenTransitions = [];
|
|
342
|
+
|
|
343
|
+
/** Wake every parked transaction — for a site that knows a reporter stopped
|
|
344
|
+
* counting but not whose (a boundary reset). */ function wakeParked() {
|
|
345
|
+
for (const e of transitions) wokenTransitions.includes(e) || wokenTransitions.push(e);
|
|
346
|
+
schedule();
|
|
347
|
+
}
|
|
348
|
+
|
|
349
|
+
/**
|
|
350
|
+
* Boundaries whose `on` dependencies notified this flush (#3540; a Set:
|
|
351
|
+
* many notifications, one re-arm). The notification arrives inside a pass,
|
|
352
|
+
* at the height of the `on` reads — before the readers the write put in
|
|
353
|
+
* flight are registered — so the re-arm waits for the heap and runs before
|
|
354
|
+
* the verdict (GlobalQueue.run → drainRearms), still under the write's
|
|
355
|
+
* transaction: the release is seen by the verdict that follows, and the
|
|
356
|
+
* staged fallback swap lands with the write's frame.
|
|
357
|
+
*/ const pendingRearms = new Set;
|
|
358
|
+
|
|
359
|
+
function queueRearm(e) {
|
|
360
|
+
pendingRearms.add(e);
|
|
361
|
+
schedule();
|
|
362
|
+
}
|
|
363
|
+
|
|
364
|
+
/** The drain (see pendingRearms): each boundary decides for itself, from
|
|
365
|
+
* what is pending under it now, whether re-arming means its fallback or
|
|
366
|
+
* nothing. Snapshot first: a re-arm can queue another — a write it makes
|
|
367
|
+
* notifying an `on` that reads it — which is the next pass's. */ function drainRearms() {
|
|
368
|
+
const e = Array.from(pendingRearms);
|
|
369
|
+
pendingRearms.clear();
|
|
370
|
+
for (let t = 0; t < e.length; t++) e[t].se();
|
|
163
371
|
}
|
|
164
372
|
|
|
373
|
+
/** Transactions a mainline tick has PROPOSED against (A34, #3494): a write to a
|
|
374
|
+
* node one of them holds — the same value or another — is a second proposal
|
|
375
|
+
* on a contested node, and the tick reveals with the hold ("both are
|
|
376
|
+
* suggesting a value; if one finished before the other that would be odd").
|
|
377
|
+
* Entered at the next flush's start, where the ambient batch is adopted;
|
|
378
|
+
* never from the write itself, which left `activeTransition` set across the
|
|
379
|
+
* caller's block and made creation after the write the transaction's (A29). */ const batchJoins = [];
|
|
380
|
+
|
|
165
381
|
/**
|
|
166
382
|
* Permanently halts the reactive system. Called when a user error escapes
|
|
167
383
|
* every boundary — app state is undefined at that point, so scheduling stops
|
|
168
384
|
* entirely rather than limping along with a half-applied update.
|
|
169
|
-
*/
|
|
385
|
+
*/
|
|
386
|
+
/**
|
|
387
|
+
* The key a root owner carries its client error hook under (`render`'s
|
|
388
|
+
* `onError`) — registered, so a runtime writes it with no import of the hook
|
|
389
|
+
* module (core/error-hooks.ts) and no property mangling in the way. Defined
|
|
390
|
+
* HERE, not there: a runtime that only writes the key must not retain the
|
|
391
|
+
* hook machinery (pay-for-use).
|
|
392
|
+
*/ const ROOT_ERROR_HOOK = Symbol.for("solid-js/root-error-hook");
|
|
393
|
+
|
|
394
|
+
function haltReactivity(e) {
|
|
170
395
|
if (halted) return;
|
|
171
396
|
halted = true;
|
|
172
397
|
let t = "[REACTIVITY_HALTED]";
|
|
173
|
-
//
|
|
398
|
+
// Surface the cause here too: callers rethrow it, but a creation-time throw
|
|
174
399
|
// unwinds through ancestor recomputes that convert it to status instead of
|
|
175
400
|
// surfacing it (#2884), so the rethrow alone cannot guarantee visibility.
|
|
176
|
-
|
|
401
|
+
// Where the platform has one, hand the cause to its uncaught-error channel
|
|
402
|
+
// (`reportError` → `error` event → window.onerror / error monitoring): a
|
|
403
|
+
// halt that only reaches console.error leaves a page that LOOKS alive with
|
|
404
|
+
// nothing an app or its telemetry can act on (#3338 — an uncaught throw
|
|
405
|
+
// during the hydration render). The rethrow may reach the top as well in
|
|
406
|
+
// the non-swallowed cases; a duplicate report beats a silent one.
|
|
407
|
+
const n = e !== undefined && globalThis.reportError;
|
|
408
|
+
n || e === undefined ? console.error(t) : console.error(t, e);
|
|
409
|
+
n && n(e);
|
|
177
410
|
}
|
|
178
411
|
|
|
179
412
|
// Logs on the first write after a halt so a frozen interaction is traceable.
|
|
@@ -193,30 +426,30 @@ function notifyHalted() {
|
|
|
193
426
|
let queueRunToken = 0;
|
|
194
427
|
|
|
195
428
|
class Queue {
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
429
|
+
_parent=null;
|
|
430
|
+
Tt=[ [], [] ];
|
|
431
|
+
ft=[];
|
|
432
|
+
ht=0;
|
|
200
433
|
created=clock;
|
|
201
434
|
addChild(e) {
|
|
202
|
-
this.
|
|
203
|
-
e.
|
|
435
|
+
this.ft.push(e);
|
|
436
|
+
e._parent = this;
|
|
204
437
|
}
|
|
205
438
|
removeChild(e) {
|
|
206
|
-
const t = this.
|
|
439
|
+
const t = this.ft.indexOf(e);
|
|
207
440
|
if (t >= 0) {
|
|
208
|
-
this.
|
|
209
|
-
e.
|
|
441
|
+
this.ft.splice(t, 1);
|
|
442
|
+
e._parent = null;
|
|
210
443
|
}
|
|
211
444
|
}
|
|
212
|
-
notify(e, t,
|
|
213
|
-
if (this.
|
|
445
|
+
notify(e, t, n, i) {
|
|
446
|
+
if (this._parent) return this._parent.notify(e, t, n, i);
|
|
214
447
|
return false;
|
|
215
448
|
}
|
|
216
449
|
run(e) {
|
|
217
|
-
if (this.
|
|
218
|
-
const t = this.
|
|
219
|
-
this.
|
|
450
|
+
if (this.Tt[e - 1].length) {
|
|
451
|
+
const t = this.Tt[e - 1];
|
|
452
|
+
this.Tt[e - 1] = [];
|
|
220
453
|
runQueue(t, e);
|
|
221
454
|
}
|
|
222
455
|
// Effects run here can dispose owners, and disposal removes queues from
|
|
@@ -226,70 +459,70 @@ class Queue {
|
|
|
226
459
|
// can be recovered by rescanning from the front and every child still runs
|
|
227
460
|
// exactly once. Children appended mid-pass carry a stale stamp and run,
|
|
228
461
|
// matching the previous live-array behaviour.
|
|
229
|
-
const t = this.
|
|
230
|
-
const
|
|
231
|
-
for (let
|
|
232
|
-
const
|
|
233
|
-
if (
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
if (t[
|
|
237
|
-
|
|
462
|
+
const t = this.ft;
|
|
463
|
+
const n = ++queueRunToken;
|
|
464
|
+
for (let i = 0; i < t.length; ) {
|
|
465
|
+
const r = t[i];
|
|
466
|
+
if (r.ht !== n) {
|
|
467
|
+
r.ht = n;
|
|
468
|
+
r.run?.(e);
|
|
469
|
+
if (t[i] !== r) {
|
|
470
|
+
i = 0;
|
|
238
471
|
continue;
|
|
239
472
|
}
|
|
240
473
|
}
|
|
241
|
-
|
|
474
|
+
i++;
|
|
242
475
|
}
|
|
243
476
|
}
|
|
244
477
|
enqueue(e, t) {
|
|
245
478
|
if (e) {
|
|
246
479
|
// Route to lane's effect queue if we're in an optimistic recomputation
|
|
247
480
|
if (currentOptimisticLane) {
|
|
248
|
-
const
|
|
249
|
-
|
|
481
|
+
const n = findLane(currentOptimisticLane);
|
|
482
|
+
n.dn[e - 1].push(t);
|
|
250
483
|
} else {
|
|
251
|
-
this.
|
|
484
|
+
this.Tt[e - 1].push(t);
|
|
252
485
|
}
|
|
253
486
|
}
|
|
254
487
|
schedule();
|
|
255
488
|
}
|
|
256
489
|
stashQueues(e) {
|
|
257
|
-
e.
|
|
258
|
-
e.
|
|
259
|
-
this.
|
|
260
|
-
for (let t = 0; t < this.
|
|
261
|
-
let
|
|
262
|
-
let
|
|
263
|
-
if (!
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
490
|
+
e.Tt[0].push(...this.Tt[0]);
|
|
491
|
+
e.Tt[1].push(...this.Tt[1]);
|
|
492
|
+
this.Tt = [ [], [] ];
|
|
493
|
+
for (let t = 0; t < this.ft.length; t++) {
|
|
494
|
+
let n = this.ft[t];
|
|
495
|
+
let i = e.ft[t];
|
|
496
|
+
if (!i) {
|
|
497
|
+
i = {
|
|
498
|
+
Tt: [ [], [] ],
|
|
499
|
+
ft: []
|
|
267
500
|
};
|
|
268
|
-
e.
|
|
501
|
+
e.ft[t] = i;
|
|
269
502
|
}
|
|
270
|
-
|
|
503
|
+
n.stashQueues(i);
|
|
271
504
|
}
|
|
272
505
|
}
|
|
273
506
|
restoreQueues(e) {
|
|
274
|
-
this.
|
|
275
|
-
this.
|
|
276
|
-
for (let t = 0; t < e.
|
|
277
|
-
const
|
|
278
|
-
let
|
|
279
|
-
if (
|
|
507
|
+
this.Tt[0].push(...e.Tt[0]);
|
|
508
|
+
this.Tt[1].push(...e.Tt[1]);
|
|
509
|
+
for (let t = 0; t < e.ft.length; t++) {
|
|
510
|
+
const n = e.ft[t];
|
|
511
|
+
let i = this.ft[t];
|
|
512
|
+
if (i) i.restoreQueues(n);
|
|
280
513
|
}
|
|
281
514
|
}
|
|
282
515
|
}
|
|
283
516
|
|
|
284
517
|
class GlobalQueue extends Queue {
|
|
285
|
-
|
|
518
|
+
Jn=false;
|
|
286
519
|
// The current transaction-shaped batch: a plain ambient batch while no
|
|
287
520
|
// transition is active, the active transition itself after initTransition.
|
|
288
521
|
m=createBatch();
|
|
289
|
-
static
|
|
290
|
-
static
|
|
291
|
-
static
|
|
292
|
-
static
|
|
522
|
+
static Ke;
|
|
523
|
+
static en;
|
|
524
|
+
static Cn;
|
|
525
|
+
static _t=null;
|
|
293
526
|
// Store-side hook: drops a keyless affects() mark's identity scope when the
|
|
294
527
|
// carrier node's last registration releases (wired by store.ts, mirroring
|
|
295
528
|
// _clearOptimisticStore).
|
|
@@ -300,27 +533,30 @@ class GlobalQueue extends Queue {
|
|
|
300
533
|
// once the gate holds.
|
|
301
534
|
static G=null;
|
|
302
535
|
static M=null;
|
|
303
|
-
static
|
|
536
|
+
static N=null;
|
|
304
537
|
// External-source bridge (wired by enableExternalSource(); null while no
|
|
305
538
|
// config is active — including after _resetExternalSourceConfig()).
|
|
306
|
-
static
|
|
307
|
-
static
|
|
539
|
+
static Zn=null;
|
|
540
|
+
static jn=null;
|
|
308
541
|
// Verdict-layer hooks (wired by verdict.ts when isPending()/latest() are
|
|
309
542
|
// imported; null in apps that never use them). Call sites either guard for
|
|
310
543
|
// null or sit behind state only the verdict layer can create (`!` is safe
|
|
311
544
|
// there: `_pendingSignal`/`_latestValueComputed` are only ever assigned by
|
|
312
545
|
// verdict.ts, and `pendingCheckActive`/`latestReadActive` only flip inside
|
|
313
546
|
// isPending()/latest()).
|
|
314
|
-
static
|
|
315
|
-
static
|
|
316
|
-
static
|
|
317
|
-
static
|
|
318
|
-
static
|
|
319
|
-
static
|
|
320
|
-
static
|
|
321
|
-
static
|
|
547
|
+
static Ve=null;
|
|
548
|
+
static Ge=null;
|
|
549
|
+
static We=null;
|
|
550
|
+
static ti=null;
|
|
551
|
+
static et=null;
|
|
552
|
+
static nt=null;
|
|
553
|
+
static rt=null;
|
|
554
|
+
static On=null;
|
|
322
555
|
static k=null;
|
|
323
|
-
static
|
|
556
|
+
static Et=null;
|
|
557
|
+
// Re-asks probes whose verdict was provisionally suppressed by a fresh read
|
|
558
|
+
// of a held value, once the transaction gains an async blocker (#3028).
|
|
559
|
+
static Nt=null;
|
|
324
560
|
// Optimistic-engine hooks (wired by core/optimistic.ts via
|
|
325
561
|
// installOptimisticEngine(), called from verdict.ts / createOptimistic /
|
|
326
562
|
// createOptimisticStore — every module that can create optimistic state).
|
|
@@ -328,28 +564,145 @@ class GlobalQueue extends Queue {
|
|
|
328
564
|
// `_overrideValue` slot, a lane in `activeLanes`, an `_optimisticNodes`
|
|
329
565
|
// entry, or a non-null `currentOptimisticLane`, so `!` invocations are safe
|
|
330
566
|
// once the gate holds.
|
|
331
|
-
static
|
|
332
|
-
static
|
|
567
|
+
static ot=null;
|
|
568
|
+
static oi=null;
|
|
569
|
+
static ai=null;
|
|
570
|
+
static li=null;
|
|
571
|
+
static si=null;
|
|
572
|
+
/** Patch-channel optimistic drain (next/patch.ts): optimistic emissions
|
|
573
|
+
* apply at lane-effect timing — visible in flight, unlike the regular
|
|
574
|
+
* effect queues an action stashes. Injected; null when unused. */
|
|
575
|
+
static ui=null;
|
|
576
|
+
static lt=null;
|
|
577
|
+
static it=null;
|
|
578
|
+
/** Is the node routed through a LIVE lane (`resolveLane`)? read()'s reveal
|
|
579
|
+
* carve-out asks before showing a foreign-held pending node's committed
|
|
580
|
+
* value: a lane-derived flight's inputs are already revealed through the
|
|
581
|
+
* lane (#3334). Gated on CONFIG_HAS_LANE, which only the engine sets. */
|
|
582
|
+
static tt=null;
|
|
583
|
+
static $n=null;
|
|
584
|
+
static an=null;
|
|
585
|
+
static Sn=null;
|
|
586
|
+
/** Authoritative-view reader wakeup: installed by until() and refresh() before
|
|
587
|
+
* their first read. Call sites are gated by CONFIG_AUTHORITATIVE_OBSERVED, which
|
|
588
|
+
* only such a reader's carve-out read can set, so `!` invocations are safe once
|
|
589
|
+
* the gate holds (#3303). */
|
|
590
|
+
static zn=null;
|
|
333
591
|
static Tn=null;
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
static
|
|
342
|
-
|
|
592
|
+
/** A18 supersession (#3331): own-source truth `value` landed under an active
|
|
593
|
+
* override. The engine decides whether the graph re-derives — the value
|
|
594
|
+
* differs from the override and is not a stale (older-action) answer (mark
|
|
595
|
+
* the node, demote its lane cascade, notify), or returns to it after an
|
|
596
|
+
* earlier differing arrival (clear the mark, notify) — and owns the
|
|
597
|
+
* authoritative-observer wake for a silent confirm. Installed with the
|
|
598
|
+
* optimistic engine; only reachable on a node that has an override. */
|
|
599
|
+
static ke=null;
|
|
600
|
+
/** The flush's pre-verdict step (#3427): once the transaction's action
|
|
601
|
+
* bodies have all ended and nothing authoritative is left in flight, the
|
|
602
|
+
* engine supersedes every override still in force with the truth it
|
|
603
|
+
* reverts to, so the graph re-derives from it now, as the transaction's
|
|
604
|
+
* held work, instead of after the flights the overrides fed have landed.
|
|
605
|
+
* True when it superseded something: the caller re-runs the heap ahead of
|
|
606
|
+
* the verdict. The engine owns every gate (acted, actions drained, has
|
|
607
|
+
* overrides, no store edits, no authoritative flight); null without it. */
|
|
608
|
+
static Ei=null;
|
|
609
|
+
/** read()'s value for a TRACKED reader of a superseded node (#3331): the
|
|
610
|
+
* staged truth, unless the reader is a stale (render) reader of another
|
|
611
|
+
* transaction — then the displayed override, as it keeps a foreign
|
|
612
|
+
* transaction's committed value over its staged write. */
|
|
613
|
+
/** A tracked read of an active override: the lane outside-view rule
|
|
614
|
+
* (#3460) and the A18 supersession selection (#3331) — see optimistic.ts. */
|
|
615
|
+
static ut=null;
|
|
616
|
+
/** A lane pass's publish for a memo (#3479, lanes stage): the speculative
|
|
617
|
+
* result becomes a DERIVED override, `_value` stays committed — see
|
|
618
|
+
* optimistic.ts laneOverride. Set with the engine, which a lane implies. */
|
|
619
|
+
static Me=null;
|
|
620
|
+
/** Verdict-layer recompute in progress (companion creation, latest()/
|
|
621
|
+
* isPending() pulls): never born held — see core.ts enterStagedRead. */
|
|
622
|
+
static Xn=false;
|
|
623
|
+
/** setSignal's authoritative (projection-write) landing on an override-
|
|
624
|
+
* covered node (#3331 store twin): stage the truth for its transaction's
|
|
625
|
+
* commit whatever its relation to the committed value — a landing equal to
|
|
626
|
+
* committed still differs from the override — then _supersedeOverride
|
|
627
|
+
* decides. Installed with the optimistic engine; only reachable on a node
|
|
628
|
+
* that has an override. */
|
|
629
|
+
static st=null;
|
|
630
|
+
static fi=null;
|
|
343
631
|
flush() {
|
|
344
|
-
if (this.
|
|
345
|
-
|
|
346
|
-
|
|
632
|
+
if (this.Jn) return;
|
|
633
|
+
// Fast drain: nothing in flight but plain pending commits — no dirty
|
|
634
|
+
// computeds, no queued effects, no child queues, no transitions/lanes/
|
|
635
|
+
// optimistic state. Commit and go; anything a commit hook schedules
|
|
636
|
+
// (companion snaps, store folds notifying subs) re-arms `scheduled`
|
|
637
|
+
// below and the outer drain loop takes the full spine next round.
|
|
638
|
+
if (activeTransition === null && dirtyQueue.EE < dirtyQueue.ln && this.Tt[0].length === 0 && this.Tt[1].length === 0 && this.ft.length === 0 && !wokenTransitions.length && !batchJoins.length && // a join must drain in its own tick (#3519 review)
|
|
639
|
+
canUseSimpleSyncFlush(this)) {
|
|
640
|
+
this.Jn = true;
|
|
641
|
+
try {
|
|
642
|
+
// A28: companions of nodes written since the last flush mirror the
|
|
643
|
+
// flushed world — re-synced inside the running window (the write is
|
|
644
|
+
// "flushed" from here on).
|
|
645
|
+
resyncUnflushedCompanions();
|
|
646
|
+
// Sweep first: unobserved() pulls swept nodes out of the dirty heap,
|
|
647
|
+
// so a dormant memo dirtied in the same tick is reclaimed instead of
|
|
648
|
+
// recomputed (matching the old inline dispose-on-read counts).
|
|
649
|
+
sweepDormant();
|
|
650
|
+
commitPendingNodes();
|
|
651
|
+
} finally {
|
|
652
|
+
this.Jn = false;
|
|
653
|
+
}
|
|
654
|
+
clock++;
|
|
655
|
+
scheduled = dirtyQueue.EE >= dirtyQueue.ln || this.Tt[0].length !== 0 || this.Tt[1].length !== 0 || this.m.Gn.length !== 0;
|
|
656
|
+
return;
|
|
657
|
+
}
|
|
658
|
+
this.Jn = true;
|
|
659
|
+
resyncUnflushedCompanions();
|
|
660
|
+
// A28, see above
|
|
661
|
+
try {
|
|
662
|
+
// The tick proposed against a hold (#3494): adopt its batch into it.
|
|
663
|
+
// Inside the try: the adoption runs user comparators (the no-proposal
|
|
664
|
+
// drop), and a throw there must not leave `_running` set.
|
|
665
|
+
while (batchJoins.length) this.initTransition(batchJoins.pop());
|
|
347
666
|
if (false) ;
|
|
348
|
-
runHeap
|
|
667
|
+
// Before runHeap for the same reason as the fast drain above; late
|
|
668
|
+
// subscribers (an effect reading a swept memo this flush) revive it,
|
|
669
|
+
// which is the pay-for-use contract.
|
|
670
|
+
sweepDormant();
|
|
671
|
+
runHeap(dirtyQueue, GlobalQueue.Ke);
|
|
672
|
+
// The action bodies are over: the overrides they leave in force
|
|
673
|
+
// revert at this settle, and the correction is this transaction's
|
|
674
|
+
// held work — re-derived here, under it, ahead of the verdict — not a
|
|
675
|
+
// waterfall after the flights the overrides fed (#3427). After the
|
|
676
|
+
// heap, not before: a synchronous body's own writes (a refresh that
|
|
677
|
+
// puts an override node's source in flight) are judged applied.
|
|
678
|
+
if (activeTransition && GlobalQueue.Ei?.(activeTransition)) runHeap(dirtyQueue, GlobalQueue.Ke);
|
|
679
|
+
// Re-arm the boundaries whose `on` notified this pass (pendingRearms):
|
|
680
|
+
// after the heap — what the notification put in flight is registered —
|
|
681
|
+
// and before the verdict, under the transaction that carried it. The
|
|
682
|
+
// boundary releases its hold and stages its fallback swap with the
|
|
683
|
+
// frame; the heap re-runs so its output pass is staged too, ahead of
|
|
684
|
+
// the verdict that commits or parks it (#3540).
|
|
685
|
+
if (pendingRearms.size) {
|
|
686
|
+
drainRearms();
|
|
687
|
+
runHeap(dirtyQueue, GlobalQueue.Ke);
|
|
688
|
+
}
|
|
349
689
|
if (activeTransition) {
|
|
690
|
+
// A boundary whose fallback read something not ready is judged before
|
|
691
|
+
// the verdict, under the transaction (boundaries.ts `_judgeHeld`,
|
|
692
|
+
// #3540): its output is pending on that read and holds the frame,
|
|
693
|
+
// and only a sweep re-runs it — the commit sweep, after the verdict
|
|
694
|
+
// its own read keeps parking. Ready, it stages `_disabled` false with
|
|
695
|
+
// the frame; the heap re-runs so the output drops the read ahead of
|
|
696
|
+
// the verdict.
|
|
697
|
+
if (this.ft.length) {
|
|
698
|
+
checkBoundaryChildren(this, true);
|
|
699
|
+
if (dirtyQueue.EE >= dirtyQueue.ln) runHeap(dirtyQueue, GlobalQueue.Ke);
|
|
700
|
+
}
|
|
350
701
|
const e = transitionComplete(activeTransition);
|
|
351
702
|
if (!e) {
|
|
352
703
|
const e = activeTransition;
|
|
704
|
+
// Parked: the unchanged passes' inputs are held; their tails stay (A30).
|
|
705
|
+
heldTrims.length = 0;
|
|
353
706
|
// When the parking batch IS the transition, all of its writes commit
|
|
354
707
|
// only with it — every zombie recompute they queued would run against
|
|
355
708
|
// a world the zombie never displays (zombies render mainline until
|
|
@@ -358,7 +711,7 @@ class GlobalQueue extends Queue {
|
|
|
358
711
|
// zombies here. Height-adjust entries still process normally: a
|
|
359
712
|
// dirtied one keeps its height flag and falls through to runHeap's
|
|
360
713
|
// adjustHeight path on the next pass of the bucket.
|
|
361
|
-
runHeap(zombieQueue, this.m === e ? cancelZombieRecompute : GlobalQueue.
|
|
714
|
+
runHeap(zombieQueue, this.m === e ? cancelZombieRecompute : GlobalQueue.Ke);
|
|
362
715
|
// Detach: the stashed transition keeps its batch; ambient work that
|
|
363
716
|
// follows lands in a fresh one. If the batch is already a separate
|
|
364
717
|
// ambient one — action done() restored activeTransition without
|
|
@@ -368,83 +721,126 @@ class GlobalQueue extends Queue {
|
|
|
368
721
|
if (this.m === e) currentBatch = this.m = createBatch();
|
|
369
722
|
// Run lane effects immediately (before stashing) - lanes with no pending async
|
|
370
723
|
if (activeLanes.size) {
|
|
371
|
-
GlobalQueue.
|
|
372
|
-
GlobalQueue.
|
|
724
|
+
GlobalQueue.si(EFFECT_RENDER);
|
|
725
|
+
GlobalQueue.si(EFFECT_USER);
|
|
373
726
|
}
|
|
374
|
-
this.stashQueues(e.
|
|
727
|
+
this.stashQueues(e.dt);
|
|
375
728
|
clock++;
|
|
376
729
|
// A kept ambient batch may hold pending nodes (#2916): stay
|
|
377
730
|
// scheduled so the outer drain loop commits them via the plain
|
|
378
731
|
// flush path instead of leaving them until the next natural flush.
|
|
379
|
-
scheduled = dirtyQueue.EE >= dirtyQueue.
|
|
380
|
-
reassignPendingTransition(e.
|
|
732
|
+
scheduled = dirtyQueue.EE >= dirtyQueue.ln || this.m.Gn.length > 0;
|
|
733
|
+
reassignPendingTransition(e.Gn);
|
|
381
734
|
activeTransition = null;
|
|
382
735
|
finalizePureQueue(null, true);
|
|
383
736
|
return;
|
|
384
737
|
}
|
|
385
738
|
const t = activeTransition;
|
|
386
|
-
const
|
|
387
|
-
|
|
388
|
-
this.restoreQueues(t.
|
|
739
|
+
const n = this.m;
|
|
740
|
+
n !== t && n.Gn.push(...t.Gn);
|
|
741
|
+
this.restoreQueues(t.dt);
|
|
389
742
|
transitions.delete(t);
|
|
390
743
|
activeTransition = null;
|
|
391
|
-
reassignPendingTransition(
|
|
744
|
+
reassignPendingTransition(n.Gn);
|
|
392
745
|
finalizePureQueue(t);
|
|
393
|
-
if (
|
|
746
|
+
if (n === t) {
|
|
394
747
|
// Drop the dead Transition wrapper but keep its (drained) containers
|
|
395
748
|
// as the ambient batch — late registrations during finalization live
|
|
396
749
|
// there and must survive to the next flush.
|
|
397
750
|
const e = createBatch();
|
|
398
|
-
e.
|
|
399
|
-
e.
|
|
400
|
-
e.A =
|
|
401
|
-
e.
|
|
751
|
+
e.Gn = n.Gn;
|
|
752
|
+
e.cn = n.cn;
|
|
753
|
+
e.A = n.A;
|
|
754
|
+
e.ri = n.ri;
|
|
402
755
|
currentBatch = this.m = e;
|
|
403
756
|
}
|
|
404
757
|
} else {
|
|
405
758
|
if (canUseSimpleSyncFlush(this)) {
|
|
406
759
|
commitPendingNodes();
|
|
407
|
-
if (dirtyQueue.EE >= dirtyQueue.
|
|
408
|
-
runHeap(dirtyQueue, GlobalQueue.
|
|
760
|
+
if (dirtyQueue.EE >= dirtyQueue.ln) {
|
|
761
|
+
runHeap(dirtyQueue, GlobalQueue.Ke);
|
|
409
762
|
commitPendingNodes();
|
|
410
763
|
}
|
|
411
764
|
} else {
|
|
412
|
-
|
|
765
|
+
// Parked transactions elsewhere: their owners' zombies render
|
|
766
|
+
// mainline until the commit that disposes them, so a mainline write
|
|
767
|
+
// reaches them here (#2916, #3463). Commit THIS flush's pending nodes
|
|
768
|
+
// first (#3546): a zombie whose owner commits now is disposed by that
|
|
769
|
+
// commit and never reruns — the same fate it has when no transaction
|
|
770
|
+
// is parked, where this queue is not run at all. Run before the
|
|
771
|
+
// commit, it reran and notified its owner through the previous
|
|
772
|
+
// pass's dependency tail (kept by A30 until the commit trims it),
|
|
773
|
+
// and the owner recomputed a second time with identical inputs,
|
|
774
|
+
// creating and disposing one more child per write. Only the zombies
|
|
775
|
+
// of actually parked owners survive the commit and rerun; the
|
|
776
|
+
// finalize's own commit picks up whatever those reruns stage.
|
|
777
|
+
if (transitions.size) {
|
|
778
|
+
commitPendingNodes();
|
|
779
|
+
runHeap(zombieQueue, GlobalQueue.Ke);
|
|
780
|
+
}
|
|
413
781
|
finalizePureQueue();
|
|
414
782
|
}
|
|
415
783
|
}
|
|
416
784
|
clock++;
|
|
417
|
-
// Check if finalization added items to the heap (from optimistic reversion)
|
|
418
|
-
|
|
785
|
+
// Check if finalization added items to the heap (from optimistic reversion).
|
|
786
|
+
// Finalization may also have ENTERED a transaction (a commit hook, boundary
|
|
787
|
+
// sweep or recompute wrote a node it owns): effects computed under it
|
|
788
|
+
// since are its to apply, not this flush's — runEffect leaves them queued
|
|
789
|
+
// and the next pass parks them with it (#3319). Everything computed
|
|
790
|
+
// mainline applies now.
|
|
791
|
+
scheduled = dirtyQueue.EE >= dirtyQueue.ln || activeTransition !== null;
|
|
419
792
|
// Run lane effects first (for ready lanes), then regular effects
|
|
420
|
-
activeLanes.size && GlobalQueue.
|
|
793
|
+
activeLanes.size && GlobalQueue.si(EFFECT_RENDER);
|
|
421
794
|
this.run(EFFECT_RENDER);
|
|
422
|
-
activeLanes.size && GlobalQueue.
|
|
795
|
+
activeLanes.size && GlobalQueue.si(EFFECT_USER);
|
|
423
796
|
this.run(EFFECT_USER);
|
|
424
797
|
if (false) ;
|
|
425
798
|
if (false && !scheduled && !activeTransition && transitions.size === 0 && activeLanes.size === 0) ;
|
|
426
799
|
if (false) ;
|
|
427
800
|
} finally {
|
|
428
|
-
|
|
801
|
+
// Re-enter a woken transaction (see wokenTransitions) only from an
|
|
802
|
+
// idle pass: entering adopts the ambient batch, and staged or dirty
|
|
803
|
+
// ambient work would be held behind flights it never read. `scheduled`
|
|
804
|
+
// is that test here — after the park exit as well as the normal one:
|
|
805
|
+
// it was recomputed from the heap this pass, every write since re-armed
|
|
806
|
+
// it, and optimistic ambient nodes reverted with the finalize — so a
|
|
807
|
+
// wake in a pass with work simply falls to the next. Entering re-arms
|
|
808
|
+
// it itself; a dead (completed) wake is a bare return in
|
|
809
|
+
// initTransition, and the loop moves on to the next.
|
|
810
|
+
while (!scheduled && !activeTransition && wokenTransitions.length) this.initTransition(wokenTransitions.pop());
|
|
811
|
+
this.Jn = false;
|
|
429
812
|
}
|
|
430
813
|
}
|
|
431
|
-
notify(e, t,
|
|
814
|
+
notify(e, t, n, i) {
|
|
432
815
|
// Only track async if the boundary is propagating STATUS_PENDING (not caught by boundary)
|
|
433
816
|
if (t & STATUS_PENDING) {
|
|
434
|
-
if (
|
|
435
|
-
|
|
817
|
+
if (n & STATUS_PENDING) {
|
|
818
|
+
// Callers pass either nothing or this node's own `_x._error`, so `??`
|
|
819
|
+
// is exact (a null error falls back to the same null).
|
|
820
|
+
const t = i ?? e.o?._;
|
|
436
821
|
// A visibility-only mark notification (the affects() boundary
|
|
437
822
|
// channel) updates display state on its way up but must be invisible
|
|
438
823
|
// to completion accounting BY CONSTRUCTION: it never registers a
|
|
439
824
|
// reporter and never counts toward the loading-boundary diagnostic.
|
|
440
825
|
if (t?.l) return true;
|
|
441
|
-
if (
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
if (
|
|
826
|
+
if (t) {
|
|
827
|
+
// A reveal can discover a flight started in an earlier flush. Hold
|
|
828
|
+
// the staged writes with that reader (A15), even if the reader is
|
|
829
|
+
// new. Fresh/reset loading boundaries consume pending before it
|
|
830
|
+
// reaches here. A reader already parked in a transition must not
|
|
831
|
+
// open a second one.
|
|
832
|
+
if (!activeTransition && !e.we && currentBatch.Gn.length) this.initTransition();
|
|
833
|
+
if (activeTransition) {
|
|
834
|
+
const n = t.source;
|
|
835
|
+
let i = activeTransition.le.get(n);
|
|
836
|
+
if (!i) activeTransition.le.set(n, i = new Set);
|
|
837
|
+
const r = i.size;
|
|
838
|
+
i.add(e);
|
|
839
|
+
if (i.size !== r) {
|
|
840
|
+
schedule();
|
|
841
|
+
GlobalQueue.Nt?.(activeTransition);
|
|
842
|
+
}
|
|
843
|
+
}
|
|
448
844
|
}
|
|
449
845
|
}
|
|
450
846
|
return true;
|
|
@@ -452,19 +848,33 @@ class GlobalQueue extends Queue {
|
|
|
452
848
|
return false;
|
|
453
849
|
}
|
|
454
850
|
initTransition(e) {
|
|
455
|
-
if (e)
|
|
456
|
-
|
|
457
|
-
|
|
851
|
+
if (e) {
|
|
852
|
+
e = currentTransition(e);
|
|
853
|
+
// A finished transaction cannot be re-entered: its state is committed
|
|
854
|
+
// or reverted, so "rejoining" it (A26) is meaningless and re-activating
|
|
855
|
+
// it spins the drain loop (#3140). The refusal must be a bare return —
|
|
856
|
+
// redirecting the caller to a fresh batch would re-arm the loop with a
|
|
857
|
+
// new transaction identity each pass. Stamps are cleared at commit, so
|
|
858
|
+
// this is a belt for paths that hand over a chased-dead reference
|
|
859
|
+
// (merged chains, async settles racing completion).
|
|
860
|
+
if (e.Rn === true || e === activeTransition) return;
|
|
861
|
+
}
|
|
862
|
+
if (!e && activeTransition && activeTransition.be === clock) return;
|
|
458
863
|
if (!activeTransition) {
|
|
459
864
|
activeTransition = e ?? createBatch();
|
|
460
865
|
} else if (e) {
|
|
461
866
|
const t = activeTransition;
|
|
462
867
|
mergeTransitionState(e, t);
|
|
868
|
+
// Effects the outgoing transaction parked belong to the surviving one
|
|
869
|
+
// now: back onto the live queue, where this flush parks them under
|
|
870
|
+
// `transition` or runs them at its completion. The outgoing stash is
|
|
871
|
+
// never read again — the transaction is dead (#3310).
|
|
872
|
+
this.restoreQueues(t.dt);
|
|
463
873
|
transitions.delete(t);
|
|
464
874
|
activeTransition = e;
|
|
465
875
|
}
|
|
466
876
|
transitions.add(activeTransition);
|
|
467
|
-
activeTransition.
|
|
877
|
+
activeTransition.be = clock;
|
|
468
878
|
const t = this.m;
|
|
469
879
|
if (t !== activeTransition) {
|
|
470
880
|
// Adopt the ambient batch into the transaction, then make the
|
|
@@ -474,34 +884,74 @@ class GlobalQueue extends Queue {
|
|
|
474
884
|
// must not entangle unrelated writes to it; the same rule holds one hop
|
|
475
885
|
// downstream: propagation never queues pended subscribers as pending
|
|
476
886
|
// nodes, see propagateAffectsMark, #2893.
|
|
477
|
-
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
|
|
887
|
+
// Adopted outside a flush: the staging is still unflushed — the stamp
|
|
888
|
+
// must not make it read as held-and-carried (CONFIG_ADOPTED_UNFLUSHED;
|
|
889
|
+
// the carrying flush clears it in reassignPendingTransition).
|
|
890
|
+
const e = this.Jn ? 0 : CONFIG_ADOPTED_UNFLUSHED;
|
|
891
|
+
for (let n = 0; n < t.Gn.length; n++) {
|
|
892
|
+
const i = t.Gn[n];
|
|
893
|
+
// A tick that nets to the committed value proposed nothing (A34, #3494):
|
|
894
|
+
// `setShow(false); setShow(true)` beside a write that opens a hold
|
|
895
|
+
// left `show` staged at its own value, stamped, pending to the
|
|
896
|
+
// verdict, and its next mainline write held by a flight it never
|
|
897
|
+
// derived from. Unstage it here — its subscribers were walked at the
|
|
898
|
+
// write and re-derive the same value. Writes only: a signal's staging
|
|
899
|
+
// is always one, a computed's only under REACTIVE_MANUAL_WRITE
|
|
900
|
+
// (`createSignal(fn)`'s setter, #3519 review) — otherwise it is its
|
|
901
|
+
// pass's result, which may equal an uninitialized `undefined` (a
|
|
902
|
+
// born-held first pass). `_equals: false` opts out. The unstaging is
|
|
903
|
+
// the commit's own path (commitPendingNode with nothing staged): the
|
|
904
|
+
// manual-write flag, companions and the rest are cleaned up as a
|
|
905
|
+
// commit would, and the node is stamped nowhere. Unstamped
|
|
906
|
+
// only: a node already a transaction's — arriving here as a parked
|
|
907
|
+
// batch folds into a merge — carries a FLUSHED proposal a later
|
|
908
|
+
// rewrite brought back to the committed value; it is held, not
|
|
909
|
+
// proposal-free. Dropped, it kept the dead stamp, and the next write
|
|
910
|
+
// to it queued under the merged transaction a value the commit then
|
|
911
|
+
// skipped as another's (fuzzer latest-2 #1470, S3).
|
|
912
|
+
if (i.we === null && i._e !== NOT_PENDING && (!i.he || i.oe & REACTIVE_MANUAL_WRITE && !(i.h & STATUS_UNINITIALIZED)) && i.xe && i.xe(i.ce, i._e)) {
|
|
913
|
+
i._e = NOT_PENDING;
|
|
914
|
+
commitPendingNode(i);
|
|
915
|
+
continue;
|
|
916
|
+
}
|
|
917
|
+
i.we = activeTransition;
|
|
918
|
+
i.C |= e;
|
|
919
|
+
activeTransition.Gn.push(i);
|
|
481
920
|
}
|
|
482
|
-
for (let e = 0; e < t.
|
|
483
|
-
const
|
|
484
|
-
|
|
485
|
-
activeTransition.
|
|
921
|
+
for (let e = 0; e < t.cn.length; e++) {
|
|
922
|
+
const n = t.cn[e];
|
|
923
|
+
n.we = activeTransition;
|
|
924
|
+
activeTransition.cn.push(n);
|
|
486
925
|
}
|
|
487
926
|
if (t.A.length) activeTransition.A.push(...t.A);
|
|
488
|
-
for (const e of t.
|
|
927
|
+
for (const e of t.ri) activeTransition.ri.add(e);
|
|
489
928
|
// Gated readers recorded against the ambient batch move with it: their
|
|
490
929
|
// replay-at-commit now happens at the transaction's completion.
|
|
491
|
-
if (t.
|
|
492
|
-
for (const e of t.
|
|
493
|
-
t.
|
|
930
|
+
if (t.In.size) {
|
|
931
|
+
for (const e of t.In) activeTransition.In.add(e);
|
|
932
|
+
t.In.clear();
|
|
494
933
|
}
|
|
495
934
|
currentBatch = this.m = activeTransition;
|
|
496
935
|
}
|
|
497
936
|
for (const e of activeLanes) {
|
|
498
|
-
if (!e.
|
|
937
|
+
if (!e.we) e.we = activeTransition;
|
|
499
938
|
}
|
|
939
|
+
// A transaction's ambient window is one flush. Entering must therefore
|
|
940
|
+
// guarantee a flush: a transaction opened with no writes (an action whose
|
|
941
|
+
// first statements only await) otherwise leaves activeTransition and the
|
|
942
|
+
// adopted batch armed across the async gap, and the next unrelated work
|
|
943
|
+
// to arrive — an optimistic store's authoritative landing, a plain async
|
|
944
|
+
// settle — is adopted into a transaction it has nothing to do with
|
|
945
|
+
// (#3141). The scheduled flush parks the incomplete transaction through
|
|
946
|
+
// the normal machinery and detaches the ambient slots first.
|
|
947
|
+
schedule();
|
|
500
948
|
}
|
|
501
949
|
}
|
|
502
950
|
|
|
503
951
|
function queuePendingNode(e) {
|
|
504
|
-
currentBatch.
|
|
952
|
+
currentBatch.Gn.push(e);
|
|
953
|
+
if (!globalQueue.Jn) markUnflushedStaged();
|
|
954
|
+
// A28
|
|
505
955
|
}
|
|
506
956
|
|
|
507
957
|
// Sticky: flips true on the first refresh() ever (the only setter of
|
|
@@ -509,95 +959,241 @@ function queuePendingNode(e) {
|
|
|
509
959
|
// clear entirely in apps that never refresh.
|
|
510
960
|
let reaskArmed = false;
|
|
511
961
|
|
|
962
|
+
/** §12d: bumped by every recompute and every new subscriber edge. A node's
|
|
963
|
+
* staged-rewrite skip is sound only while NOTHING recomputed or linked since
|
|
964
|
+
* its last notify — a mid-batch pull can clean a marked subscriber, and a
|
|
965
|
+
* skipped re-write would leave it stale. */ let notifyEpoch = 0;
|
|
966
|
+
|
|
967
|
+
function bumpNotifyEpoch() {
|
|
968
|
+
notifyEpoch++;
|
|
969
|
+
}
|
|
970
|
+
|
|
512
971
|
function armReaskClear() {
|
|
513
972
|
reaskArmed = true;
|
|
514
973
|
}
|
|
515
974
|
|
|
975
|
+
/** Provenance of the work currently running (A18 supersession, #3331): the
|
|
976
|
+
* invocation sequence of the action whose ambient window this is — set by
|
|
977
|
+
* action() for each slice; the flush that ends the window clears it — or,
|
|
978
|
+
* inside an async landing, the sequence captured when that flight was
|
|
979
|
+
* registered (asyncWrite sets it for the landing's synchronous propagation,
|
|
980
|
+
* so a sync recompute downstream of the landing — an optimistic wrapper over
|
|
981
|
+
* the async source — derives under the flight's provenance, and flights it
|
|
982
|
+
* registers inherit it). 0 is mainline: no action, always the current
|
|
983
|
+
* question. An override stamps this at its write (`_overrideStamp`); an
|
|
984
|
+
* answer whose flight an OLDER action issued is a stale question the user
|
|
985
|
+
* has since changed — it holds silently to commit instead of superseding. A
|
|
986
|
+
* slow source must not leak back in over a newer intent. Transactions merge,
|
|
987
|
+
* so the transition object cannot say WHICH action asked; this can. */ let origin = 0;
|
|
988
|
+
|
|
989
|
+
function setOrigin(e) {
|
|
990
|
+
const t = origin;
|
|
991
|
+
origin = e;
|
|
992
|
+
return t;
|
|
993
|
+
}
|
|
994
|
+
|
|
516
995
|
function insertSubs(e, t = false) {
|
|
996
|
+
// §12d: stamp before walking — setSignal's staged-rewrite fast path skips
|
|
997
|
+
// the next walk for this node while the epoch holds (marking is idempotent).
|
|
998
|
+
e.vn = notifyEpoch;
|
|
517
999
|
// Get source lane: prefer node's own lane over current context
|
|
518
1000
|
// This is important for isPending signals which need their own lane to flush immediately
|
|
519
|
-
|
|
520
|
-
|
|
1001
|
+
// Presence bits gate the optional-slot probes (see constants.ts): one
|
|
1002
|
+
// masked read of the always-present _config instead of missing-property
|
|
1003
|
+
// lookups in the hottest notify loop. Bits are sticky — the field read
|
|
1004
|
+
// stays authoritative when a bit is set.
|
|
1005
|
+
const n = e.C;
|
|
1006
|
+
const i = (n & CONFIG_HAS_LANE ? e.o?.me : undefined) || currentOptimisticLane;
|
|
1007
|
+
const r = (n & CONFIG_HAS_SNAPSHOT) !== 0 && e.o?.sn !== undefined;
|
|
521
1008
|
const s = reaskArmed;
|
|
522
|
-
for (let
|
|
1009
|
+
for (let n = e.u; n !== null; n = n.Ae) {
|
|
1010
|
+
const e = n.ge;
|
|
523
1011
|
// A value-change notification is a new question for the subscriber: any
|
|
524
1012
|
// pending re-ask mark (refresh) it carried is superseded.
|
|
525
|
-
|
|
526
|
-
|
|
527
|
-
|
|
1013
|
+
if (s) e.oe &= ~REACTIVE_REASK;
|
|
1014
|
+
// Missed-wake latch (#3037): this write is landing while the subscriber
|
|
1015
|
+
// is mid-recompute (a nested pull committing beneath its reads), and the
|
|
1016
|
+
// heap refuses RECOMPUTING nodes. A gen-current link means the pass
|
|
1017
|
+
// already validated this dep — the value it read is now stale — so latch
|
|
1018
|
+
// for recompute's tail to reschedule. Untouched links need no latch (the
|
|
1019
|
+
// pass either re-reads them fresh or trims them), and neither does the
|
|
1020
|
+
// tail link: it is the read IN FLIGHT — read() links before it pulls, so
|
|
1021
|
+
// this very commit is what that read returns.
|
|
1022
|
+
if (e.oe & REACTIVE_RECOMPUTING_DEPS && n.Be === e.Ye && n !== e.Nn) e.oe |= REACTIVE_MISSED_WAKE;
|
|
1023
|
+
if (r && e.C & CONFIG_IN_SNAPSHOT_SCOPE) {
|
|
1024
|
+
e.oe |= REACTIVE_SNAPSHOT_STALE;
|
|
528
1025
|
continue;
|
|
529
1026
|
}
|
|
530
1027
|
if (t && i) {
|
|
531
|
-
|
|
532
|
-
assignOrMergeLane(
|
|
1028
|
+
e.oe |= REACTIVE_OPTIMISTIC_DIRTY;
|
|
1029
|
+
assignOrMergeLane(e, i);
|
|
533
1030
|
} else if (t) {
|
|
534
|
-
|
|
1031
|
+
e.oe |= REACTIVE_OPTIMISTIC_DIRTY;
|
|
535
1032
|
// No source lane means reversion - clear subscriber's lane so effects go to regular queue
|
|
536
|
-
|
|
1033
|
+
if (e.o) e.o.me = undefined;
|
|
537
1034
|
}
|
|
538
|
-
enqueueSub(
|
|
1035
|
+
enqueueSub(e);
|
|
539
1036
|
}
|
|
540
1037
|
}
|
|
541
1038
|
|
|
542
1039
|
function commitPendingNode(e) {
|
|
543
1040
|
const t = e;
|
|
544
|
-
if (!t.
|
|
545
|
-
if (e.
|
|
546
|
-
e.
|
|
547
|
-
e.
|
|
1041
|
+
if (!t.he) {
|
|
1042
|
+
if (e._e !== NOT_PENDING) {
|
|
1043
|
+
e.ce = e._e;
|
|
1044
|
+
e._e = NOT_PENDING;
|
|
548
1045
|
}
|
|
549
|
-
if (e.
|
|
1046
|
+
if (e.C & CONFIG_HAS_COMPANIONS) GlobalQueue.ti(e);
|
|
550
1047
|
return;
|
|
551
1048
|
}
|
|
552
|
-
if (e.
|
|
553
|
-
e.
|
|
554
|
-
e.
|
|
1049
|
+
if (e._e !== NOT_PENDING) {
|
|
1050
|
+
e.ce = e._e;
|
|
1051
|
+
e._e = NOT_PENDING;
|
|
1052
|
+
// A node born held (recompute) initializes at this commit.
|
|
1053
|
+
t.h &= ~STATUS_UNINITIALIZED;
|
|
555
1054
|
// Set _modified for effects, but not for tracked effects (they handle their own scheduling)
|
|
556
|
-
if (e.
|
|
1055
|
+
if (e.je && e.je !== EFFECT_TRACKED) e.Xe = true;
|
|
1056
|
+
// A quiet re-ask classification preserved through a held landing dies
|
|
1057
|
+
// with the value commit — the commit IS the reveal (#3178). Gated on the
|
|
1058
|
+
// staged value: status propagation queues pending nodes whose windows
|
|
1059
|
+
// are still OPEN (no staged value), and their live classification must
|
|
1060
|
+
// survive this sweep.
|
|
1061
|
+
if (e.o) e.o.Le = false;
|
|
557
1062
|
}
|
|
558
1063
|
// The committed hold is the first observable answer for a loading-window
|
|
559
1064
|
// node — the window closes here, not at compute time (#2990). Unconditional
|
|
560
1065
|
// store to an always-present computed slot.
|
|
561
|
-
t.
|
|
562
|
-
t.
|
|
563
|
-
|
|
564
|
-
|
|
565
|
-
|
|
1066
|
+
t.ve = false;
|
|
1067
|
+
t.oe &= ~REACTIVE_MANUAL_WRITE;
|
|
1068
|
+
// The children this commit publishes are the frame's now (#3404) — and so
|
|
1069
|
+
// are the dependencies of the pass that produced the value: the previous
|
|
1070
|
+
// frame's tail goes (A30, #3410; `recompute` left it for a staged pass). Only
|
|
1071
|
+
// after a clean pass: `_error` is cleared by a clean pass or by the node's
|
|
1072
|
+
// own landing (whose pass was clean), so a set `_error` means the last pass
|
|
1073
|
+
// threw, kept its full list, and `_depsTail` marks where it stopped.
|
|
1074
|
+
if (t.o?._ == null) trimStaleDeps(t);
|
|
1075
|
+
// A LANE frame still parked here (#3662) rode a hold that stashed the run
|
|
1076
|
+
// that would have retired it: this commit applies that run, so it goes too.
|
|
1077
|
+
t.C &= -68157441;
|
|
1078
|
+
if (!(t.h & STATUS_PENDING)) t.h &= ~STATUS_UNINITIALIZED;
|
|
1079
|
+
// A flight this commit leaves in the air (unobserved, or observed only by
|
|
1080
|
+
// a boundary) now has PUBLISHED inputs: its committed value is stale
|
|
1081
|
+
// against the frame. read()'s reveal carve-out keys on the mark (#3305).
|
|
1082
|
+
else e.C |= CONFIG_INPUTS_PUBLISHED;
|
|
1083
|
+
if (t.o != null && (t.o._n !== null || t.o.fn !== null)) GlobalQueue.en(t, false, true);
|
|
1084
|
+
if (e.C & CONFIG_HAS_COMPANIONS) GlobalQueue.ti(e);
|
|
1085
|
+
}
|
|
1086
|
+
|
|
1087
|
+
// Store commit hook (INTERNALS-STORE-STATE.md §3): installed by the store
|
|
1088
|
+
// module at init (same treeshakeable pattern as _resolveOptimistic /
|
|
1089
|
+
// _clearOptimisticStores). Folds committed store-node values into their
|
|
1090
|
+
// backing objects at the same moment pending values commit — the single
|
|
1091
|
+
// mutation point of the owned-raw model.
|
|
1092
|
+
let storeCommitHook = null;
|
|
1093
|
+
|
|
1094
|
+
function setStoreCommitHook(e) {
|
|
1095
|
+
storeCommitHook = e;
|
|
566
1096
|
}
|
|
567
1097
|
|
|
1098
|
+
/** Held truth committed this finalize, awaiting its post-revert wake (see
|
|
1099
|
+
* finalizePureQueue): the commit IS the reveal, but subscribers must not
|
|
1100
|
+
* re-derive until the settling transaction's optimistic overrides have
|
|
1101
|
+
* reverted — a commit-time wake recomputes them in the window where
|
|
1102
|
+
* confirming truth is committed and the override still displays, a torn
|
|
1103
|
+
* frame no timeline contains. */ const heldRevealed = [];
|
|
1104
|
+
|
|
1105
|
+
/** Unchanged passes with a stale dependency tail, waiting on this flush's
|
|
1106
|
+
* verdict (A30, #3469). A pass that changed nothing replaced nothing either —
|
|
1107
|
+
* and cannot know at its own tail whether the flush that ran it will park:
|
|
1108
|
+
* parked, its inputs are held and the committed frame still derives from the
|
|
1109
|
+
* tail (`b() ? b() : a()` computed `1` from the held `b`, equal to the `1` it
|
|
1110
|
+
* had from `a` — with `a` trimmed, the mainline `a = 2` never reached it).
|
|
1111
|
+
* Trimmed when the flush commits; dropped with a park, the tail stays linked
|
|
1112
|
+
* until a committing pass trims it (one spurious recompute at most). */ const heldTrims = [];
|
|
1113
|
+
|
|
568
1114
|
function commitPendingNodes() {
|
|
569
|
-
|
|
1115
|
+
while (heldTrims.length) trimStaleDeps(heldTrims.pop());
|
|
1116
|
+
const e = currentBatch.Gn;
|
|
570
1117
|
for (let t = 0; t < e.length; t++) {
|
|
571
|
-
|
|
1118
|
+
const n = e[t];
|
|
1119
|
+
commitPendingNode(n);
|
|
1120
|
+
// The stamp dies with the commit (#3143) — symmetric with
|
|
1121
|
+
// resolveOptimisticNodes clearing optimistic stamps. A stamp outliving
|
|
1122
|
+
// its transaction let any later write (even a value-equal no-op, which
|
|
1123
|
+
// re-opens before the equality bail) resurrect the finished transaction;
|
|
1124
|
+
// a boundary flag rewritten every finalize pass then spun the drain loop
|
|
1125
|
+
// forever (#3140). The held-truth mark dies the same death — the commit
|
|
1126
|
+
// IS the reveal — but its wake defers to the post-revert pass: ordinary
|
|
1127
|
+
// subscribers were masked to committed all hold (some re-derived against
|
|
1128
|
+
// that old view and cached it), and commits are otherwise silent
|
|
1129
|
+
// (staging already notified), so without a wake they'd hold the old
|
|
1130
|
+
// world forever.
|
|
1131
|
+
n.we = null;
|
|
1132
|
+
if (n.C & CONFIG_HELD_TRUTH) {
|
|
1133
|
+
n.C &= ~CONFIG_HELD_TRUTH;
|
|
1134
|
+
heldRevealed.push(n);
|
|
1135
|
+
}
|
|
572
1136
|
}
|
|
573
1137
|
e.length = 0;
|
|
1138
|
+
storeCommitHook?.();
|
|
574
1139
|
}
|
|
575
1140
|
|
|
576
1141
|
function finalizePureQueue(e = null, t = false) {
|
|
577
1142
|
// For incomplete transitions, skip pending resolution and optimistic reversion
|
|
578
1143
|
// For completing transitions or no-transition, resolve pending and revert optimistic
|
|
1144
|
+
const n = currentBatch;
|
|
579
1145
|
const i = !t;
|
|
580
1146
|
if (i) commitPendingNodes();
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
|
|
1147
|
+
// A parked finalize sweeps nothing: the boundaries' staged swaps are the
|
|
1148
|
+
// transaction's, and a boundary whose own output parks the verdict was
|
|
1149
|
+
// judged under it in run(), ahead of the verdict (#3540).
|
|
1150
|
+
if (!t && globalQueue.ft.length) checkBoundaryChildren(globalQueue);
|
|
1151
|
+
// Contested effects (#3322) re-derive from the world this commit just
|
|
1152
|
+
// produced. Ahead of the heap run — not the post-heap gated replay — so
|
|
1153
|
+
// the recompute and the effect phase land in this same pass and the value
|
|
1154
|
+
// the other transaction wrote into the slot is never published.
|
|
1155
|
+
// (No clear: a completed transition is never finalized again.)
|
|
1156
|
+
// A transaction whose settle reverts optimism re-derives them post-revert
|
|
1157
|
+
// instead (below, with the gated replay): between commitPendingNodes and
|
|
1158
|
+
// _resolveOptimistic the truth is committed but the overrides still
|
|
1159
|
+
// display, and a re-derive here would compose the two — the #3164 tear,
|
|
1160
|
+
// one window later. The slot meanwhile holds the frame that is on screen.
|
|
1161
|
+
const r = e?.Dn;
|
|
1162
|
+
const s = i && (e ?? n).cn.length !== 0;
|
|
1163
|
+
if (r && !s) for (const e of r) if (!(e.oe & REACTIVE_DISPOSED)) enqueueSub(e);
|
|
1164
|
+
const o = dirtyQueue.EE >= dirtyQueue.ln;
|
|
1165
|
+
if (o) runHeap(dirtyQueue, GlobalQueue.Ke);
|
|
584
1166
|
if (i) {
|
|
585
|
-
|
|
1167
|
+
// Boundary checks, commit hooks and recomputes can enter a transaction,
|
|
1168
|
+
// which adopts the batch this finalize was settling: nothing batch-derived
|
|
1169
|
+
// may be committed or reverted here — the entered transaction owns it now
|
|
1170
|
+
// (#3319). A completing transaction's OWN containers are a different
|
|
1171
|
+
// matter: when the ambient batch was separate from it (the #2916 shape),
|
|
1172
|
+
// adoption never touched them and it must still settle them; when the
|
|
1173
|
+
// batch WAS the completing transaction, adoption re-stamped its contents
|
|
1174
|
+
// into the entered one and there is nothing left to settle.
|
|
1175
|
+
if (currentBatch !== n) {
|
|
1176
|
+
if (e === null || e === n) return;
|
|
1177
|
+
} else if (o) commitPendingNodes();
|
|
586
1178
|
// The settling batch: the completing transaction's, or the ambient one.
|
|
587
|
-
const t = e ??
|
|
1179
|
+
const t = e ?? n;
|
|
588
1180
|
// Optimistic reversion: a non-empty batch means _optimisticWrite ran,
|
|
589
1181
|
// which installed the engine's hooks.
|
|
590
|
-
if (t.
|
|
1182
|
+
if (t.cn.length) GlobalQueue.oi(t.cn);
|
|
1183
|
+
if (r && s) {
|
|
1184
|
+
for (const e of r) if (!(e.oe & REACTIVE_DISPOSED)) enqueueSub(e);
|
|
1185
|
+
schedule();
|
|
1186
|
+
}
|
|
591
1187
|
// Replay entanglement: subs recorded by the read-time gate get rescheduled
|
|
592
1188
|
// so they re-run with the now-committed values visible. The ambient batch
|
|
593
1189
|
// replays too — laneReadsCommitted records readers whose committed-view
|
|
594
1190
|
// read hid a same-tick plain write that just committed above (#2963).
|
|
595
|
-
if (t.
|
|
596
|
-
for (const e of t.
|
|
597
|
-
if (e.
|
|
1191
|
+
if (t.In.size) {
|
|
1192
|
+
for (const e of t.In) {
|
|
1193
|
+
if (e.oe & REACTIVE_DISPOSED) continue;
|
|
598
1194
|
enqueueSub(e);
|
|
599
1195
|
}
|
|
600
|
-
t.
|
|
1196
|
+
t.In.clear();
|
|
601
1197
|
// A completing transition keeps the outer flush loop alive by itself;
|
|
602
1198
|
// the ambient batch needs the re-arm or the replay sits in the heap
|
|
603
1199
|
// until the next unrelated write.
|
|
@@ -611,23 +1207,41 @@ function finalizePureQueue(e = null, t = false) {
|
|
|
611
1207
|
// (the earlier sweep above ran while the marks were still live).
|
|
612
1208
|
if (t.A.length) {
|
|
613
1209
|
GlobalQueue.G(t.A);
|
|
614
|
-
if (globalQueue.
|
|
1210
|
+
if (globalQueue.ft.length) checkBoundaryChildren(globalQueue);
|
|
615
1211
|
}
|
|
616
1212
|
// A non-empty set means trackOptimisticStore ran, which installed the
|
|
617
1213
|
// hook; the hook iterates, clears, and schedules (keeping the loop out of
|
|
618
1214
|
// core lets esbuild shake it — rollup already folds the null guard). The
|
|
619
1215
|
// completing transition scopes the clear to its own layer keys (#2899).
|
|
620
|
-
if (t.
|
|
1216
|
+
if (t.ri.size) GlobalQueue._t(t.ri, e);
|
|
1217
|
+
// Held-truth reveal wake (#3164), post-revert by construction: this
|
|
1218
|
+
// finalize committed confirming truth whose subscribers were masked all
|
|
1219
|
+
// hold — some re-derived against the committed view (the staging, or a
|
|
1220
|
+
// confirming carrier's landing, notified them as a plain write) and
|
|
1221
|
+
// cached it, and stash-restored applies may carry those torn values.
|
|
1222
|
+
// Waking and recomputing HERE — after _resolveOptimistic and the store
|
|
1223
|
+
// clears above — means every apply paints the settled view; a wake at
|
|
1224
|
+
// commit time would recompute them in the window where truth is
|
|
1225
|
+
// committed but the settling transaction's overrides still display.
|
|
1226
|
+
if (heldRevealed.length !== 0) {
|
|
1227
|
+
while (heldRevealed.length) insertSubs(heldRevealed.pop());
|
|
1228
|
+
if (dirtyQueue.EE >= dirtyQueue.ln) {
|
|
1229
|
+
runHeap(dirtyQueue, GlobalQueue.Ke);
|
|
1230
|
+
commitPendingNodes();
|
|
1231
|
+
}
|
|
1232
|
+
}
|
|
621
1233
|
sweepTransientStoreNodes();
|
|
622
1234
|
// Lanes only enter activeLanes through the engine's getOrCreateLane.
|
|
623
|
-
if (activeLanes.size) GlobalQueue.
|
|
1235
|
+
if (activeLanes.size) GlobalQueue.li(e);
|
|
624
1236
|
}
|
|
625
1237
|
}
|
|
626
1238
|
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
|
|
630
|
-
|
|
1239
|
+
/** The boundary sweep: the commit's (`_checkSources`), or — `held`, before
|
|
1240
|
+
* the verdict (#3540) — the one for a collecting boundary whose output is
|
|
1241
|
+
* pending on its fallback's read (`_judgeHeld`). */ function checkBoundaryChildren(e, t) {
|
|
1242
|
+
for (const n of e.ft) {
|
|
1243
|
+
t ? n.Re?.() : n.Ee?.();
|
|
1244
|
+
checkBoundaryChildren(n, t);
|
|
631
1245
|
}
|
|
632
1246
|
}
|
|
633
1247
|
|
|
@@ -649,8 +1263,10 @@ function checkBoundaryChildren(e) {
|
|
|
649
1263
|
|
|
650
1264
|
function reassignPendingTransition(e) {
|
|
651
1265
|
for (let t = 0; t < e.length; t++) {
|
|
652
|
-
e[t].
|
|
653
|
-
|
|
1266
|
+
e[t].we = activeTransition;
|
|
1267
|
+
e[t].C &= ~CONFIG_ADOPTED_UNFLUSHED;
|
|
1268
|
+
// this flush carried it
|
|
1269
|
+
}
|
|
654
1270
|
}
|
|
655
1271
|
|
|
656
1272
|
const globalQueue = new GlobalQueue;
|
|
@@ -663,6 +1279,16 @@ const globalQueue = new GlobalQueue;
|
|
|
663
1279
|
let currentBatch = globalQueue.m;
|
|
664
1280
|
|
|
665
1281
|
function flush(e) {
|
|
1282
|
+
// Inside an action body the drain is incoherent (#3333): the action's
|
|
1283
|
+
// writes are held by its transaction until it settles, so a drain can't
|
|
1284
|
+
// reveal them — and the loop below only exits once `activeTransition` is
|
|
1285
|
+
// null, so it would PARK the transaction mid-slice and every write after it
|
|
1286
|
+
// in the body would land as a plain, committed write. The reporter's
|
|
1287
|
+
// "leading flush()" workaround was exactly that leak. Prod: run `fn` if
|
|
1288
|
+
// given (its writes stay in the transaction) and skip the drain.
|
|
1289
|
+
if (actionStepDepth > 0) {
|
|
1290
|
+
return e ? e() : undefined;
|
|
1291
|
+
}
|
|
666
1292
|
if (e) {
|
|
667
1293
|
syncDepth++;
|
|
668
1294
|
try {
|
|
@@ -677,7 +1303,7 @@ function flush(e) {
|
|
|
677
1303
|
}
|
|
678
1304
|
}
|
|
679
1305
|
}
|
|
680
|
-
if (globalQueue.
|
|
1306
|
+
if (globalQueue.Jn) {
|
|
681
1307
|
return;
|
|
682
1308
|
}
|
|
683
1309
|
if (halted) return;
|
|
@@ -686,39 +1312,123 @@ function flush(e) {
|
|
|
686
1312
|
while (scheduled || activeTransition) {
|
|
687
1313
|
globalQueue.flush();
|
|
688
1314
|
}
|
|
1315
|
+
// Provenance ends with the drain: every ambient window (an action's first
|
|
1316
|
+
// slice, a landing's propagation) runs to this flush.
|
|
1317
|
+
origin = 0;
|
|
689
1318
|
}
|
|
690
1319
|
|
|
691
1320
|
function runQueue(e, t) {
|
|
692
|
-
for (let
|
|
1321
|
+
for (let n = 0; n < e.length; n++) e[n](t);
|
|
693
1322
|
}
|
|
694
1323
|
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
1324
|
+
/** Does `reporter` still hold the transaction waiting on `source` — live,
|
|
1325
|
+
* routed to no collecting loading boundary, and deriving from the source in
|
|
1326
|
+
* its current pass? The verdict's per-reporter test (sourceObserved), also
|
|
1327
|
+
* a boundary re-arm's (boundaries.ts `_rearm` runs before the verdict prunes
|
|
1328
|
+
* registrations that stopped counting). */ function reporterBlocksSource(e, t, n) {
|
|
1329
|
+
const i = e.oe;
|
|
1330
|
+
if (i & REACTIVE_DISPOSED) return false;
|
|
1331
|
+
// A zombie renders until the commit that disposes it (#3463): while its
|
|
1332
|
+
// removal is staged in a live transaction it is still on screen, and what
|
|
1333
|
+
// it displays must stay consistent with the frame — a held `Show`'s
|
|
1334
|
+
// `Details: 0` beside the lane's `Value: 1` otherwise. Its say is moot for
|
|
1335
|
+
// the verdict of the transaction that stages the removal (`verdict`): done,
|
|
1336
|
+
// and the commit disposes it; not done, and it stays parked regardless. A
|
|
1337
|
+
// zombie whose removal commits this flush (owner's pass not held) is dead.
|
|
1338
|
+
// The owner is stamped when the flush parks; held in this flush, its
|
|
1339
|
+
// staging transaction is the active one.
|
|
1340
|
+
if (i & REACTIVE_ZOMBIE) {
|
|
1341
|
+
let t = e;
|
|
1342
|
+
while (t && t.oe & REACTIVE_ZOMBIE) t = t._parent;
|
|
1343
|
+
let i = t && (t.we || (t.C & CONFIG_HELD_CHILDREN ? activeTransition : null));
|
|
1344
|
+
// A LANE frame's member (#3662) is displayed until its owner's run
|
|
1345
|
+
// applies, and the lane's transaction is what applies it (its completion
|
|
1346
|
+
// runs the lane's queue): moot for that verdict, live for every other.
|
|
1347
|
+
if (!i && t && t.C & CONFIG_LANE_FRAME && t.o?.me) i = findLane(t.o.me).we;
|
|
1348
|
+
if (!i || (i = currentTransition(i)).Rn === true || i === n) return false;
|
|
1349
|
+
}
|
|
1350
|
+
// Fallback-caught async holds nothing. A collecting loading boundary
|
|
1351
|
+
// consumes the notification, so a reader under a fallback never registers —
|
|
1352
|
+
// but a reader registered while its boundary showed content stays
|
|
1353
|
+
// registered when the boundary's `on` later changes and it flips to the
|
|
1354
|
+
// fallback. The reader is behind the fallback now; if nothing outside the
|
|
1355
|
+
// boundary consumes the flight, the hold is over (A33, ruled 2026-09-12, #3375).
|
|
1356
|
+
for (let t = e.T; t; t = t._parent) if (t.te & STATUS_PENDING && !t.q) return false;
|
|
1357
|
+
// "Still derives from the source" is a question about THIS pass's reads:
|
|
1358
|
+
// the deps up to `_depsTail`. Past it lie the committed frame's — kept
|
|
1359
|
+
// linked by A30 until the commit trims them (a staged pass, an errored
|
|
1360
|
+
// one). Reading them here made a reporter whose pass had stopped reading
|
|
1361
|
+
// the source (a gate closed in the same flush as the write) look live, and
|
|
1362
|
+
// the hold it kept was the commit that would have trimmed the dep that
|
|
1363
|
+
// kept it (spec O3, same-flush form; fuzzer #3446 P1 cases 21/79). A
|
|
1364
|
+
// trimmed list ends at `_depsTail`, so the bound is free there; a pass
|
|
1365
|
+
// that read nothing has a null tail and derives from nothing.
|
|
1366
|
+
// The registration is trusted: a pending mark rides only this pass's links
|
|
1367
|
+
// (notifyStatus skips the kept tail), so a registered reporter read the
|
|
1368
|
+
// source, or threw on it.
|
|
1369
|
+
if (e.o?.ue?.has(t)) return true;
|
|
1370
|
+
const r = e.Nn;
|
|
1371
|
+
for (let n = r === null ? null : e.Ie; n; n = n === r ? null : n.Ne) {
|
|
1372
|
+
let e = n.Oe;
|
|
700
1373
|
while (e) {
|
|
701
|
-
|
|
702
|
-
|
|
1374
|
+
// Or through a memo pending on the flight (#3494): a stale reader
|
|
1375
|
+
// served a held memo's committed value never turned pending itself, so
|
|
1376
|
+
// its only trace of the flight is the memo between them — `copy` of
|
|
1377
|
+
// `details`. Judged dead, its transaction released `count=1` beside
|
|
1378
|
+
// the `Copy: 0` it displays. `_pendingSources` is transitive, so one
|
|
1379
|
+
// hop covers any depth.
|
|
1380
|
+
if (e === t || e.De === t || e.o?.ue?.has(t)) return true;
|
|
1381
|
+
e = e.o?.kn;
|
|
703
1382
|
}
|
|
704
1383
|
}
|
|
705
|
-
return !!(e.
|
|
1384
|
+
return !!(e.h & STATUS_PENDING && e.o?._ instanceof NotReadyError && e.o?._.source === t);
|
|
1385
|
+
}
|
|
1386
|
+
|
|
1387
|
+
/**
|
|
1388
|
+
* Does a live reporter of `transition` still observe `source` pending? Dead
|
|
1389
|
+
* reporters (disposed, behind a fallback, no longer reading the source) are
|
|
1390
|
+
* pruned as they are found, and the source's entry with them. Shared by the
|
|
1391
|
+
* settle verdict and the lane's hold check (`waitingTransition`): a live
|
|
1392
|
+
* action parks its transaction without a verdict, so this prune is the only
|
|
1393
|
+
* one an optimistic lane whose last async reader unmounted mid-action ever
|
|
1394
|
+
* gets — without it the lane held on the dead reporter's registration until
|
|
1395
|
+
* the flight it no longer observed landed (#3426).
|
|
1396
|
+
*/ function sourceObserved(e, t, n) {
|
|
1397
|
+
const i = e.le.get(t);
|
|
1398
|
+
let r = false;
|
|
1399
|
+
for (const e of i ?? []) {
|
|
1400
|
+
if (reporterBlocksSource(e, t, n)) return true;
|
|
1401
|
+
// A zombie the verdict passes over is kept, not pruned (#3463): moot for
|
|
1402
|
+
// this verdict, it still holds a lane's reveal while the transaction
|
|
1403
|
+
// stays parked on something else.
|
|
1404
|
+
if (n && e.oe & REACTIVE_ZOMBIE) r = true; else i.delete(e);
|
|
1405
|
+
}
|
|
1406
|
+
if (!r) e.le.delete(t);
|
|
1407
|
+
return false;
|
|
706
1408
|
}
|
|
707
1409
|
|
|
708
1410
|
function transitionComplete(e) {
|
|
709
|
-
if (e.
|
|
710
|
-
if (e.
|
|
1411
|
+
if (e.Rn) return true;
|
|
1412
|
+
if (e.pe.length) {
|
|
1413
|
+
return false;
|
|
1414
|
+
}
|
|
711
1415
|
let t = true;
|
|
712
|
-
for (const
|
|
713
|
-
|
|
714
|
-
|
|
715
|
-
|
|
716
|
-
|
|
717
|
-
|
|
718
|
-
|
|
719
|
-
|
|
720
|
-
|
|
721
|
-
|
|
1416
|
+
for (const n of e.le.keys()) {
|
|
1417
|
+
// The source blocks while its OWN flight is up — the self entry in its
|
|
1418
|
+
// pending sources (added by notifyStatus's source path, with status;
|
|
1419
|
+
// retired by the landing and the supersede sweep, so it implies
|
|
1420
|
+
// STATUS_PENDING). `_error.source` is not that test: propagation from an
|
|
1421
|
+
// input that went pending later overwrites it with the input (#3375 — a
|
|
1422
|
+
// boundary-consumed load re-asked under a held derivation), and the
|
|
1423
|
+
// still-flying source read as settled, committing the writes it was
|
|
1424
|
+
// asked with ahead of its answer.
|
|
1425
|
+
// Not the self entry alone: a source whose own flight an upstream re-ask
|
|
1426
|
+
// superseded is still pending — on that re-ask (#3462). Its reader cannot
|
|
1427
|
+
// render until the chain lands, and the landing folds this transaction in
|
|
1428
|
+
// (enterWaiting). Judged complete instead, a re-entry between the two (a
|
|
1429
|
+
// repeated write to a held signal) committed the held writes beside the
|
|
1430
|
+
// reader's stale frame.
|
|
1431
|
+
if (sourceObserved(e, n, e) && n.o?.ue?.size) {
|
|
722
1432
|
t = false;
|
|
723
1433
|
break;
|
|
724
1434
|
}
|
|
@@ -726,24 +1436,79 @@ function transitionComplete(e) {
|
|
|
726
1436
|
// Override blockage lives with the engine (absent hook = "no optimistic
|
|
727
1437
|
// blockage"); the hook's loops over _optimisticNodes/_optimisticStores are
|
|
728
1438
|
// no-ops when the transition holds neither, so no pre-check is needed.
|
|
729
|
-
if (t && GlobalQueue.
|
|
730
|
-
t && (e.
|
|
1439
|
+
if (t && GlobalQueue.ai?.(e)) t = false;
|
|
1440
|
+
t && (e.Rn = true);
|
|
731
1441
|
return t;
|
|
732
1442
|
}
|
|
733
1443
|
|
|
1444
|
+
/** A fresh, unentered transaction (#3146): the optimistic store's truth
|
|
1445
|
+
* flight DECLARES an owned transaction instead of relying on whatever the
|
|
1446
|
+
* ambient adoption machinery stamped on its firewall. Activate it with
|
|
1447
|
+
* initTransition; it is a plain batch until then. */ function createTransition() {
|
|
1448
|
+
return createBatch();
|
|
1449
|
+
}
|
|
1450
|
+
|
|
734
1451
|
function currentTransition(e) {
|
|
735
|
-
while (e.
|
|
1452
|
+
while (e.Rn && typeof e.Rn === "object") e = e.Rn;
|
|
736
1453
|
return e;
|
|
737
1454
|
}
|
|
738
1455
|
|
|
1456
|
+
/**
|
|
1457
|
+
* The live transition blocked on `source` — the one whose render reader
|
|
1458
|
+
* observed it pending (INV-3 records the observation in whichever transaction
|
|
1459
|
+
* was active when the reader was notified). The observation is a fact about
|
|
1460
|
+
* the node, so a hold check must not assume it was recorded in the transaction
|
|
1461
|
+
* it happens to hold — lanes merge across transactions (#2912), and a merged
|
|
1462
|
+
* root's transaction knows nothing of the async its members' transactions
|
|
1463
|
+
* observed (#3335). Null when nobody is waiting — a registration whose every
|
|
1464
|
+
* reporter has since died is nobody (#3426).
|
|
1465
|
+
*/ function waitingTransition(e) {
|
|
1466
|
+
for (const t of transitions) if (sourceObserved(t, e)) return t;
|
|
1467
|
+
return null;
|
|
1468
|
+
}
|
|
1469
|
+
|
|
1470
|
+
/** A landing enters EVERY parked transaction still waiting on `source`, folding
|
|
1471
|
+
* them into the active one (A15: each reveal that discovered the flight
|
|
1472
|
+
* completes at its landing). The fold used to happen as the waiters' stamped
|
|
1473
|
+
* readers recomputed under the landing — recompute re-entering an effect's
|
|
1474
|
+
* stamp — which also folded in writes those readers merely shared a hole
|
|
1475
|
+
* with (#3407); effects no longer re-enter, so the landing folds explicitly.
|
|
1476
|
+
* Live iteration is safe: a merge deletes the outgoing (active) entry and
|
|
1477
|
+
* re-adds the visited one. */ function enterWaiting(e) {
|
|
1478
|
+
for (const t of transitions) if (sourceObserved(t, e)) globalQueue.initTransition(t);
|
|
1479
|
+
}
|
|
1480
|
+
|
|
739
1481
|
function runInTransition(e, t) {
|
|
740
|
-
const
|
|
1482
|
+
const n = activeTransition;
|
|
1483
|
+
try {
|
|
1484
|
+
activeTransition = currentTransition(e);
|
|
1485
|
+
return t();
|
|
1486
|
+
} finally {
|
|
1487
|
+
activeTransition = n;
|
|
1488
|
+
}
|
|
1489
|
+
}
|
|
1490
|
+
|
|
1491
|
+
/** Run `fn` with `transition` as BOTH the ambient transaction and the
|
|
1492
|
+
* registration batch, restoring both after. runInTransition alone is not
|
|
1493
|
+
* enough for code that WRITES on behalf of a transaction from inside someone
|
|
1494
|
+
* else's window (optimistic replay re-arming a still-open action's edits
|
|
1495
|
+
* during a landing commit, #3123): registrations route through the queue's
|
|
1496
|
+
* batch pointer, and a bare activeTransition swap leaves them in the ambient
|
|
1497
|
+
* batch — a plain batch "completes" at the next flush and reverts optimistic
|
|
1498
|
+
* registrations that were supposed to live with the transaction.
|
|
1499
|
+
* initTransition is the wrong tool here: it MERGES the currently ambient
|
|
1500
|
+
* transaction into the target, entangling whatever the interrupted window
|
|
1501
|
+
* belonged to. */ function runAsTransitionBatch(e, t) {
|
|
1502
|
+
const n = activeTransition;
|
|
1503
|
+
const i = globalQueue.m;
|
|
741
1504
|
try {
|
|
742
1505
|
activeTransition = currentTransition(e);
|
|
1506
|
+
currentBatch = globalQueue.m = activeTransition;
|
|
743
1507
|
return t();
|
|
744
1508
|
} finally {
|
|
745
|
-
activeTransition =
|
|
1509
|
+
activeTransition = n;
|
|
1510
|
+
currentBatch = globalQueue.m = i;
|
|
746
1511
|
}
|
|
747
1512
|
}
|
|
748
1513
|
|
|
749
|
-
export { GlobalQueue, Queue, activeAffectsMarks, activeLanes, activeTransition, armReaskClear, assignOrMergeLane, clock, currentTransition, dirtyQueue, enforceLoadingBoundary, finalizePureQueue, findLane, flush, globalQueue, haltReactivity, insertSubs, projectionWriteActive, queuePendingNode,
|
|
1514
|
+
export { GlobalQueue, Queue, ROOT_ERROR_HOOK, actionStepDepth, activeAffectsMarks, activeLanes, activeTransition, armReaskClear, assignOrMergeLane, batchJoins, bumpNotifyEpoch, clock, createTransition, currentTransition, deferSlotRelease, dirtyQueue, enforceLoadingBoundary, entangleConfirmingTransitions, enterActionStep, enterWaiting, exitActionStep, finalizePureQueue, findLane, flush, globalQueue, haltReactivity, hasActiveOverride, heldTrims, insertSubs, notifyEpoch, origin, pendingRearms, projectionWriteActive, queuePendingNode, queueRearm, reaskArmed, reporterBlocksSource, resetErrorHalt, runAsTransitionBatch, runInTransition, schedule, scheduleWithheld, setOrigin, setProjectionWriteActive, setStoreCommitHook, shiftAffectsMarks, sourceObserved, storeCommitHook, transitions, waitingTransition, wakeParked, wokenTransitions, zombieQueue };
|