@solidjs/signals 2.0.0-rc.4 → 2.0.0-rc.6

package/dist/prod/core/core.js

@@ -1,6 +1,6 @@
-import { handleAsync, clearStatus, parkLoadingWindow, notifyStatus, settleErroredDependents } from "./async.js";
+import { releaseFlightTeardown, handleAsync, clearStatus, parkLoadingWindow, notifyStatus, settlePendingSource, settleErroredDependents } from "./async.js";
 
-import { EFFECT_TRACKED, REACTIVE_OPTIMISTIC_DIRTY, CONFIG_OPTIMISTIC, NOT_PENDING, STATUS_UNINITIALIZED, STATUS_ERROR, REACTIVE_REASK, REACTIVE_RECOMPUTING_DEPS, CONFIG_SYNC, CONFIG_HAS_LANE, STATUS_PENDING, REACTIVE_MISSED_WAKE, REACTIVE_NONE, REACTIVE_SNAPSHOT_STALE, unwrapOverride, OVERRIDE_UNDEFINED, CONFIG_HAS_COMPANIONS, REACTIVE_LAZY, REACTIVE_DISPOSED, CONFIG_AUTO_DISPOSE, CONFIG_CHILDREN_FORBIDDEN, REACTIVE_CHECK, REACTIVE_DIRTY, REACTIVE_IN_HEAP, REACTIVE_IN_HEAP_HEIGHT, defaultContext, CONFIG_IN_SNAPSHOT_SCOPE, CONFIG_TRANSPARENT, CONFIG_OWNED_WRITE, CONFIG_NO_SNAPSHOT, $REFRESH, REACTIVE_MANUAL_WRITE, CONFIG_FW_CHILDREN, NO_SNAPSHOT, CONFIG_HAS_SNAPSHOT, STORE_SNAPSHOT_PROPS, EFFECT_USER } from "./constants.js";
+import { EFFECT_TRACKED, REACTIVE_OPTIMISTIC_DIRTY, CONFIG_OPTIMISTIC, NOT_PENDING, STATUS_UNINITIALIZED, STATUS_ERROR, REACTIVE_REASK, REACTIVE_RECOMPUTING_DEPS, CONFIG_SYNC, CONFIG_HAS_LANE, STATUS_PENDING, REACTIVE_MISSED_WAKE, REACTIVE_NONE, REACTIVE_SNAPSHOT_STALE, unwrapOverride, CONFIG_DIRECT_COMMIT, OVERRIDE_UNDEFINED, CONFIG_AUTHORITATIVE_OBSERVED, CONFIG_HAS_COMPANIONS, REACTIVE_LAZY, REACTIVE_DISPOSED, CONFIG_AUTO_DISPOSE, CONFIG_CHILDREN_FORBIDDEN, CONFIG_FRESH_READ, CONFIG_AUTHORITATIVE_READ, CONFIG_HELD_TRUTH, REACTIVE_CHECK, REACTIVE_DIRTY, REACTIVE_IN_HEAP, REACTIVE_IN_HEAP_HEIGHT, defaultContext, CONFIG_IN_SNAPSHOT_SCOPE, CONFIG_TRANSPARENT, CONFIG_OWNED_WRITE, CONFIG_NO_SNAPSHOT, CONFIG_FW_CHILDREN, NO_SNAPSHOT, CONFIG_HAS_SNAPSHOT, REACTIVE_MANUAL_WRITE, STORE_SNAPSHOT_PROPS, EFFECT_USER } from "./constants.js";
 
 import { NotReadyError } from "./error.js";
 
@@ -8,15 +8,15 @@ import { trimStaleDeps, link, dormantNodes } from "./graph.js";
 
 import { deleteFromHeap, queueFor, insertIntoHeapHeight, enqueueSub, markNode, markHeap, insertIntoHeap } from "./heap.js";
 
-import { GlobalQueue, activeTransition, globalQueue, clock, insertSubs, queuePendingNode, runInTransition, schedule, notifyEpoch, dirtyQueue, bumpNotifyEpoch, projectionWriteActive, reaskArmed, armReaskClear } from "./scheduler.js";
+import { GlobalQueue, bumpNotifyEpoch, activeTransition, globalQueue, clock, insertSubs, queuePendingNode, runInTransition, schedule, notifyEpoch, dirtyQueue, projectionWriteActive, reaskArmed, armReaskClear } from "./scheduler.js";
 
 import "./invariants.js";
 
 import { disposeChildren, markDisposal, inheritId } from "./owner.js";
 
-GlobalQueue.Ce = recompute;
+GlobalQueue.Fe = recompute;
 
-GlobalQueue.Fe = disposeChildren;
+GlobalQueue.He = disposeChildren;
 
 let tracking = false;
 
@@ -48,7 +48,7 @@ let snapshotSources = null;
 
 function ownerInSnapshotScope(e) {
     while (e) {
-        if (e.He) return true;
+        if (e.Ve) return true;
         e = e.ke;
     }
     return false;
@@ -60,20 +60,20 @@ function setSnapshotCapture(e) {
 }
 
 function markSnapshotScope(e) {
-    e.He = true;
+    e.Ve = true;
 }
 
 function releaseSnapshotScope(e) {
-    e.He = false;
+    e.Ve = false;
     releaseSubtree(e);
     schedule();
 }
 
 function releaseSubtree(e) {
-    let t = e.ve;
+    let t = e.xe;
     while (t) {
-        if (t.He) {
-            t = t.Ve;
+        if (t.Ve) {
+            t = t.Le;
             continue;
         }
         if (t.oe) {
@@ -82,19 +82,19 @@ function releaseSubtree(e) {
             if (e.ie & REACTIVE_SNAPSHOT_STALE) {
                 e.ie &= ~REACTIVE_SNAPSHOT_STALE;
                 e.ie |= REACTIVE_DIRTY;
-                if (dirtyQueue.xe > e.Le) dirtyQueue.xe = e.Le;
+                if (dirtyQueue.Qe > e.Me) dirtyQueue.Qe = e.Me;
                 insertIntoHeap(e, dirtyQueue);
             }
         }
         releaseSubtree(t);
-        t = t.Ve;
+        t = t.Le;
     }
 }
 
 function clearSnapshots() {
     if (snapshotSources) {
         for (const e of snapshotSources) {
-            delete e.o?.Qe;
+            delete e.o?.We;
             // StoreNode targets share one pre-initialized hidden class (see
             // createStoreProxy) — assign undefined instead of deleting, and only
             // when present so signal-node sources don't grow the field.
@@ -108,48 +108,63 @@ function clearSnapshots() {
 function recompute(e, t = false) {
     // §12d: any recompute can clean a marked subscriber — invalidate skips.
     bumpNotifyEpoch();
-    const n = e.Re;
+    const n = e.ge;
     if (!t) {
-        if (e._e && (!n || activeTransition) && activeTransition !== e._e) globalQueue.initTransition(e._e);
+        if (e.Ae && (!n || activeTransition) && activeTransition !== e.Ae) globalQueue.initTransition(e.Ae);
         deleteFromHeap(e, queueFor(e));
-        if (e.o !== null) e.o.Ee = null;
+        if (e.o !== null) {
+            e.o.Ie = null;
+            // Supersede is where an iterator flight dies (#3122): close it now.
+            // Its cleanup(close) registration may sit in a zombie-deferred
+            // disposal list that a held transition only drains when the
+            // SUPERSEDING flight settles — cancellation must not wait for the
+            // work that replaced it. Idempotent with the cleanup-channel close.
+                        releaseFlightTeardown(e);
+        }
         // Tracked effects run after finalizePureQueue, so dispose immediately instead of deferring
-                if (e._e || n === EFFECT_TRACKED) disposeChildren(e); else if (e.ve !== null || e.he !== null) {
+                if (e.Ae || n === EFFECT_TRACKED) disposeChildren(e); else if (e.xe !== null || e.Ge !== null) {
             markDisposal(e);
             const t = ext(e);
-            t.We = e.he;
-            t.qe = e.ve;
-            e.he = null;
-            e.ve = null;
-            e.Me = 0;
+            t.qe = e.Ge;
+            t.Ye = e.xe;
+            e.Ge = null;
+            e.xe = null;
+            e.Ze = 0;
         } else ;
     }
     let i = !!(e.ie & REACTIVE_OPTIMISTIC_DIRTY);
-    const u = (e.T & CONFIG_OPTIMISTIC) !== 0 && e.o?.De !== NOT_PENDING && e.o?.De !== undefined;
+    const u = (e.T & CONFIG_OPTIMISTIC) !== 0 && e.o?.Pe !== NOT_PENDING && e.o?.Pe !== undefined;
     const l = !!(e.S & STATUS_UNINITIALIZED);
     // Outgoing error, captured before the compute clears status: if this run
     // recovers to an unchanged value, dependents still holding this object must
     // be swept (settleErroredDependents, #2949).
         const o = e.S & STATUS_ERROR ? e.o?._ : undefined;
+    // Pending SOURCE-hood, captured before the compute clears status: a node
+    // whose own flight parked dependents self-registers in _pendingSources
+    // (notifyStatus, isSource). If this recompute supersedes that flight and
+    // settles synchronously, those dependents settle HERE — asyncWrite's
+    // settlePendingSource walk never runs for a landing that was preempted
+    // (#3181).
+        const s = e.o?.le?.has(e);
     // Re-ask classification lives in the verdict module; capture the flag before
     // the recompute wipes _flags below.
-        const s = (e.ie & REACTIVE_REASK) !== 0;
+        const a = (e.ie & REACTIVE_REASK) !== 0;
     // Captured before the compute clears it on a sync landing: if that landing
     // is transition-held below, the window must stay open until the hold
     // commits (commitPendingNode) — a closed window plus a held value reads as
     // a pending frame to live observers of the verdict (#2990).
-        const a = e.Ie;
-    const r = context;
+        const r = e.Ne;
+    const c = context;
     context = e;
-    e.Ye = null;
-    e.Ze++;
+    e.je = null;
+    e.Ke++;
     e.ie = REACTIVE_RECOMPUTING_DEPS;
     e.Te = clock;
-    let c = e.Pe === NOT_PENDING ? e.be : e.Pe;
-    let _ = e.Le;
-    let f = false;
-    let N = tracking;
-    let E = currentOptimisticLane;
+    let _ = e.Re === NOT_PENDING ? e.be : e.Re;
+    let f = e.Me;
+    let I = false;
+    let E = tracking;
+    let N = currentOptimisticLane;
     tracking = true;
     // A computed's fn establishes its OWN dependencies, so it must never run
     // inside a latest() read window: read() short-circuits through the
@@ -157,54 +172,54 @@ function recompute(e, t = false) {
     // computed) inside latest(fn) came out permanently dependency-less (#2926).
     // latestRead() already suspends the flag for its pull-recomputes; this
     // covers creation-time computes and flushes that run inside the window.
-        const I = latestReadActive;
+        const T = latestReadActive;
     latestReadActive = false;
     // Lane posture lives with the engine: OPTIMISTIC_DIRTY is only ever set by
     // engine-driven paths, and _optimisticNodes is only pushed by
     // _optimisticWrite, so the hook is installed whenever either gate holds.
         if (i) {
-        const t = GlobalQueue.je(e, true);
+        const t = GlobalQueue.Be(e, true);
         if (t) currentOptimisticLane = t;
         // `false` = wake-only lane demotion: recompute plain so a mid-tick
         // latest()/isPending() pull stages instead of direct-committing (#3009).
         // The predicate lives with the engine (recomputeLane).
          else if (t === false) i = false;
-    } else if (activeTransition && !t && activeTransition.Ke.length) {
+    } else if (activeTransition && !t && activeTransition.ze.length) {
         // Lane adoption: parent-deeper-than-owned-child can run before its OPT-dirty
         // child propagates. Walk deps once and inherit the OPT lane so this node
         // recomputes under the right posture and propagates correctly.
-        const t = GlobalQueue.je(e, false);
+        const t = GlobalQueue.Be(e, false);
         if (t) {
             i = true;
             currentOptimisticLane = t;
         }
     }
-    const d = n && n !== EFFECT_USER;
-    const T = stale;
-    if (d) stale = true;
+    const S = n && n !== EFFECT_USER;
+    const d = stale;
+    if (S) stale = true;
     try {
         if (!false && e.T & CONFIG_SYNC) {
-            c = e.oe(c);
-            if (e.o !== null) e.o.Ee = null;
-            e.Ie = false;
+            _ = e.oe(_);
+            if (e.o !== null) e.o.Ie = null;
+            e.Ne = false;
         } else {
             // Snapshot `_inFlight` so we can detect whether `_fn` self-registered an async
             // subscription (e.g. `createProjection` calls `handleAsync` from inside its body
             // with a setter callback). In that case, the outer `handleAsync` call below would
             // clobber the fresh subscription, so we skip it and let the internally-registered
             // iteration drive updates.
-            const t = e.o?.Ee;
-            const n = e.oe(c);
+            const t = e.o?.Ie;
+            const n = e.oe(_);
             const i = typeof n === "object" && n !== null;
-            const u = e.o?.Ee !== t;
-            c = u || !i ? n : handleAsync(e, n);
+            const u = e.o?.Ie !== t;
+            _ = u || !i ? n : handleAsync(e, n);
             if (!u && !i) {
-                if (e.o !== null) e.o.Ee = null;
+                if (e.o !== null) e.o.Ie = null;
                 // A sync (non-object) return is the first real answer; async-shaped
                 // results clear inside handleAsync at their own landing points, and a
                 // self-registered flight (inFlightChanged — projections) clears when
                 // its internal handleAsync lands.
-                                e.Ie = false;
+                                e.Ne = false;
             }
         }
         // On a status-free node clearStatus is a guaranteed no-op: every field
@@ -214,10 +229,10 @@ function recompute(e, t = false) {
                 if (e.S !== 0 || e.o !== null) clearStatus(e, t);
         // _optimisticLane is only ever assigned by engine paths (CONFIG_HAS_LANE
         // is their sticky presence mark).
-                if (e.T & CONFIG_HAS_LANE && e.o?.Be) GlobalQueue.ze(e);
+                if (e.T & CONFIG_HAS_LANE && e.o?.Je) GlobalQueue.Xe(e);
     } catch (t) {
         const n = t instanceof NotReadyError;
-        if (n && e.Ie) {
+        if (n && e.Ne) {
             // Loading window with an unready sync dependency: register for the
             // source's settle (the settlePendingSource walk runs off
             // _pendingSources + _blocked alone) but take NO read-visible pending
@@ -233,30 +248,33 @@ function recompute(e, t = false) {
             let i = false;
             if (n) {
                 ext(e).fe = true;
-                if (GlobalQueue.Je !== null) i = GlobalQueue.Je(e, s);
+                if (GlobalQueue.et !== null) i = GlobalQueue.et(e, a);
             }
-            notifyStatus(e, n ? STATUS_PENDING : STATUS_ERROR, t, undefined, n ? e.o?.Be : undefined);
+            notifyStatus(e, n ? STATUS_PENDING : STATUS_ERROR, t, undefined, n ? e.o?.Je : undefined);
+            // The replacement source is fully propagated now. If no new flight
+            // re-owned self, retire the superseded flight and its dependent copies.
+                        if (n && s && !e.o?.Ie) settlePendingSource(e);
             if (i) GlobalQueue.k(e);
         }
     } finally {
-        tracking = N;
-        latestReadActive = I;
-        if (d) stale = T;
+        tracking = E;
+        latestReadActive = T;
+        if (S) stale = d;
         // Consume the missed-wake latch (#3037, set by insertSubs): a dep write
         // landed beneath this pass on a link it had already validated. The wipe
         // below must not key off DIRTY/CHECK — the read-time pull protocol
         // (markNode(c) in read()) marks the running node as part of ordinary
         // bookkeeping, and those marks are correctly discarded here.
-                f = (e.ie & REACTIVE_MISSED_WAKE) !== 0;
+                I = (e.ie & REACTIVE_MISSED_WAKE) !== 0;
         e.ie = REACTIVE_NONE | (t ? e.ie & REACTIVE_SNAPSHOT_STALE : 0);
-        context = r;
+        context = c;
     }
     if (!e.o?._) {
         trimStaleDeps(e);
-        const s = u ? unwrapOverride(e.o?.De) : e.Pe === NOT_PENDING ? e.be : e.Pe;
-        let r = false;
+        const a = u ? unwrapOverride(e.o?.Pe) : e.Re === NOT_PENDING ? e.be : e.Re;
+        let c = false;
         try {
-            r = !n && l || !e.Ue || !e.Ue(s, c);
+            c = !n && l || !e.pe || !e.pe(a, _);
         } catch (t) {
             // A throwing user comparator is an error of this node's computation.
             // Route it through the same status path as a compute-phase throw so
@@ -269,53 +287,63 @@ function recompute(e, t = false) {
         // its runner — happen here instead. `!create` matches the previous `initialized`
         // gate: the explicit recompute(node, true) inside effect() does not enqueue, so
         // effect() can call its runner synchronously for the first run.
-                if (n && r) {
-            e.Xe = !e.o?._;
+                if (n && c) {
+            e.tt = !e.o?._;
             // Reuse one bound runner per effect — runEffect no-ops on a stale
             // `_modified`, so re-enqueueing the same function is harmless.
-                        if (!t) e.C.enqueue(n, e.et ??= GlobalQueue.tt.bind(null, e));
+                        if (!t) e.C.enqueue(n, e.nt ??= GlobalQueue.it.bind(null, e));
         }
-        if (e.o?._) ; else if (r) {
-            const l = u ? e.o?.De : undefined;
+        if (e.o?._) ; else if (c) {
+            const l = u ? e.o?.Pe : undefined;
             if (t || 
             // Plain sync flush (no transition on either side) commits effect
             // values directly — the pending round-trip (queuePendingNode +
             // commitPendingNodes) exists to sequence transition reveals, and
             // paying it per effect on the plain path is pure overhead.
-            n && (activeTransition !== e._e || activeTransition === null) || i) {
-                e.be = c;
+            // DIRECT_COMMIT effects (resolve/until) commit directly even under
+            // their own held transition: their applies deliver on a microtask,
+            // not the stashed queues, so a staged value would hand the immediate
+            // apply stale state — see CONFIG_DIRECT_COMMIT.
+            n && (activeTransition !== e.Ae || activeTransition === null || e.T & CONFIG_DIRECT_COMMIT) || i) {
+                e.be = _;
                 // Lane-propagated correction: upstream data is fresh, correct the
                 // override unconditionally. The direct _value commit is the lane's
                 // own reveal schedule; drop any superseded older hold so its queued
                 // commit can't clobber the fresh value.
                                 if (u && i) {
-                    ext(e).De = c === undefined ? OVERRIDE_UNDEFINED : c;
-                    e.Pe = NOT_PENDING;
+                    ext(e).Pe = _ === undefined ? OVERRIDE_UNDEFINED : _;
+                    e.Re = NOT_PENDING;
                 }
             } else {
-                e.Pe = c;
+                e.Re = _;
                 // A window landing that gets held re-opens the window until the hold
                 // commits — the verdict's held-value branch is window-gated (#2990).
-                                if (a) e.Ie = true;
+                                if (r) e.Ne = true;
                 // Transition-held sync recompute is a write path like setSignal/asyncWrite,
                 // so sync derivations of held sources stay visible to isPending()/latest()
                 // (#2831). Both companion writes are transition-scoped (optimistic) and
                 // auto-revert/re-derive at commit. Skipped for plain flushes where the
                 // pending value commits before effects run.
-                                if ((activeTransition || e._e) && GlobalQueue.Oe !== null) GlobalQueue.Oe(e, c);
+                                if ((activeTransition || e.Ae) && GlobalQueue.Ue !== null) GlobalQueue.Ue(e, _);
             }
             // insertSubs only walks _subs (no scheduling of its own), so a
             // subscriber-less node has nothing to notify.
-                        if (e.u !== null && (!u || i || e.o?.De !== l)) insertSubs(e, i || u);
+                        if (e.u !== null && (!u || i || e.o?.Pe !== l)) insertSubs(e, i || u);
         } else if (u) {
             // Unchanged value (equals the override) recomputed while the override
             // is active: _value may still be stale, so hold the authoritative value
             // for commit on its own transition's schedule — invisibly (A17/A18).
-            if (e.Pe === NOT_PENDING) queuePendingNode(e);
-            e.Pe = c;
-            if (a) e.Ie = true;
+            if (e.Re === NOT_PENDING) queuePendingNode(e);
+            e.Re = _;
+            if (r) e.Ne = true;
  // see the held branch above (#2990)
-                } else if (e.Le != _) {
+            // A authoritative-view reader (until()) observed this node past its
+            // override — and "authoritative arrival equal to the override" is
+            // exactly the acknowledgment it waits for. Wake those readers only;
+            // A17 silence holds for every ordinary subscriber. (Hook installed by
+            // until(), the only setter of the gating bit.)
+                        if (e.T & CONFIG_AUTHORITATIVE_OBSERVED) GlobalQueue.he(e);
+        } else if (e.Me != f) {
             for (let t = e.u; t !== null; t = t.ae) {
                 insertIntoHeapHeight(t.ce, queueFor(t.ce));
             }
@@ -325,23 +353,27 @@ function recompute(e, t = false) {
         // in an errored run and may sit on stale commits (#2949). Changed-value
         // recoveries ride insertSubs above; a comparator throw re-errored the node
         // (el._x?._error re-set), so this only runs on a genuinely clean recovery.
-                if (o !== undefined && !r && !e.o?._) settleErroredDependents(e, o);
+                if (o !== undefined && !c && !e.o?._) settleErroredDependents(e, o);
+        // #3181: a synchronous settle supersedes the old landing callback, so
+        // recompute owns its pending-source sweep. An uninitialized node without
+        // a replacement source still has no truth to reveal and must stay parked.
+                if (s && !(e.S & (STATUS_PENDING | STATUS_UNINITIALIZED))) settlePendingSource(e);
     }
-    currentOptimisticLane = E;
-    const S = e.Pe !== NOT_PENDING || e.o !== null && (e.o.qe !== null || e.o.We !== null) || (e.S & (STATUS_PENDING | STATUS_UNINITIALIZED)) !== 0;
+    currentOptimisticLane = N;
+    const A = e.Re !== NOT_PENDING || e.o !== null && (e.o.Ye !== null || e.o.qe !== null) || (e.S & (STATUS_PENDING | STATUS_UNINITIALIZED)) !== 0;
     // Override-covered holds (hasOverride) always queue: their commit belongs
     // to their own transition's schedule (A18 re-rule) and is unobservable
     // under the override (A17). Revert no longer commits anything, so an
     // unqueued covered hold would leak (INV-7) once the revert clears
     // _transition.
-        S && (!t || e.S & STATUS_PENDING) && (!e._e || u) && queuePendingNode(e);
-    e._e && n && activeTransition !== e._e && runInTransition(e._e, () => recompute(e));
+        A && (!t || e.S & STATUS_PENDING) && (!e.Ae || u) && queuePendingNode(e);
+    e.Ae && n && activeTransition !== e.Ae && runInTransition(e.Ae, () => recompute(e));
     // Missed-wake reschedule (see the finally above): values this pass read
     // before the nested commit are stale, so run again now that the heap will
     // accept the node. Equality gates stop same-value landings from cascading,
     // and a re-run only latches again if another nested commit changes a dep
     // beneath it — convergent unless deps genuinely keep changing.
-        if (f) {
+        if (I) {
         enqueueSub(e);
         schedule();
     }
@@ -352,11 +384,13 @@ function updateIfNecessary(e) {
     // (_depsTail/_depGen) is live, and a nested recompute would corrupt it.
     // A mid-pass mark stays latched for recompute's own tail to reschedule
     // (#3037); readers meanwhile serve the values the pass has so far.
-    if (e.ie & REACTIVE_RECOMPUTING_DEPS) return;
+    // Never recompute a DISPOSED node either: recompute rewrites _flags and
+    // would resurrect it (#2983) — readers serve its last value.
+    if (e.ie & (REACTIVE_RECOMPUTING_DEPS | REACTIVE_DISPOSED)) return;
     if (e.ie & REACTIVE_CHECK) {
-        for (let t = e.nt; t; t = t.it) {
-            const n = t.ut;
-            const i = n.lt || n;
+        for (let t = e.ut; t; t = t.lt) {
+            const n = t.ot;
+            const i = n.st || n;
             if (i.oe) {
                 updateIfNecessary(i);
             }
@@ -365,7 +399,7 @@ function updateIfNecessary(e) {
             }
         }
     }
-    if (e.ie & (REACTIVE_DIRTY | REACTIVE_OPTIMISTIC_DIRTY) || e.o?._ && e.Te < clock && !e.o?.Ee) {
+    if (e.ie & (REACTIVE_DIRTY | REACTIVE_OPTIMISTIC_DIRTY) || e.o?._ && e.Te < clock && !e.o?.Ie) {
         recompute(e);
     }
     e.ie = e.ie & (REACTIVE_SNAPSHOT_STALE | REACTIVE_IN_HEAP | REACTIVE_IN_HEAP_HEIGHT);
@@ -380,40 +414,40 @@ function computed(e, t) {
     const u = {
         id: inheritId(t, n, context),
         T: (n ? CONFIG_TRANSPARENT : 0) | (t?.ownedWrite ? CONFIG_OWNED_WRITE : 0) | (!context || t?.lazy ? CONFIG_AUTO_DISPOSE : 0) | (t?.sync ? CONFIG_SYNC : 0) | (t?.H ? CONFIG_NO_SNAPSHOT : 0) | (snapshotCaptureActive && ownerInSnapshotScope(context) ? CONFIG_IN_SNAPSHOT_SCOPE : 0),
-        Ue: t?.equals != null ? t.equals : isEqual,
-        he: null,
+        pe: t?.equals ?? isEqual,
+        Ge: null,
         C: context?.C ?? globalQueue,
         we: context?.we ?? defaultContext,
-        Me: 0,
+        Ze: 0,
         oe: e,
         be: i ? t.loadingValue : undefined,
-        Le: 0,
-        ot: undefined,
-        st: null,
-        nt: null,
-        Ye: null,
-        Ze: 0,
+        Me: 0,
+        rt: undefined,
+        ct: null,
+        ut: null,
+        je: null,
+        Ke: 0,
         u: null,
-        rt: null,
+        _t: null,
         ke: context,
-        Ve: null,
-        ct: null,
-        ve: null,
+        Le: null,
+        ft: null,
+        xe: null,
         ie: t?.lazy ? REACTIVE_LAZY : REACTIVE_NONE,
         // A loadingValue node is born committed: commit #0 is already in _value.
         S: i ? 0 : STATUS_UNINITIALIZED,
         Te: clock,
-        Pe: NOT_PENDING,
-        _e: null,
-        _t: -1,
-        Ie: i,
+        Re: NOT_PENDING,
+        Ae: null,
+        It: -1,
+        Ne: i,
         // Cold machinery (async/transition/optimistic/verdict slots) lives one
         // hop away in the lazily-allocated extension — the core literal MUST
         // stay under V8's in-object boundary (§12: past ~39 fields every
         // allocation spills to a backing store and creation cost ~4x's).
         o: null
     };
-    if (t?.unobserved) ext(u).ft = t.unobserved;
+    if (t?.unobserved) ext(u).Et = t.unobserved;
     setupComputedNode(u, t);
     return u;
 }
@@ -423,25 +457,26 @@ function computed(e, t) {
  * this; hot paths read `el._x?._field` gated by the _config presence bits.
  * Never call ext() just to store a field's default. */ function ext(e) {
     return e.o ??= {
-        De: undefined,
+        Pe: undefined,
         Nt: undefined,
-        Be: undefined,
-        Ge: undefined,
-        ge: undefined,
-        Et: undefined,
+        Je: undefined,
+        ye: undefined,
+        Ce: undefined,
+        Tt: undefined,
         t: 0,
+        Ie: null,
         Ee: null,
         _: undefined,
         fe: undefined,
         le: undefined,
         h: undefined,
-        pe: false,
+        De: false,
         i: null,
-        ft: undefined,
-        Qe: undefined,
-        We: null,
+        Et: undefined,
+        We: undefined,
         qe: null,
-        It: undefined
+        Ye: null,
+        St: undefined
     };
 }
 
@@ -454,39 +489,39 @@ function computed(e, t) {
     const l = u?.transparent ?? false;
     const o = {
         id: inheritId(u, l, context),
-        T: (l ? CONFIG_TRANSPARENT : 0) | (u?.ownedWrite ? CONFIG_OWNED_WRITE : 0) | (u?.sync ? CONFIG_SYNC : 0) | (snapshotCaptureActive && ownerInSnapshotScope(context) ? CONFIG_IN_SNAPSHOT_SCOPE : 0),
-        Ue: false,
-        he: null,
+        T: (l ? CONFIG_TRANSPARENT : 0) | (u?.ownedWrite ? CONFIG_OWNED_WRITE : 0) | (u?.sync ? CONFIG_SYNC : 0) | (u?.dt ?? 0) | (snapshotCaptureActive && ownerInSnapshotScope(context) ? CONFIG_IN_SNAPSHOT_SCOPE : 0),
+        pe: false,
+        Ge: null,
         C: context?.C ?? globalQueue,
         we: context?.we ?? defaultContext,
-        Me: 0,
+        Ze: 0,
         oe: e,
         be: undefined,
-        Le: 0,
-        ot: undefined,
-        st: null,
-        nt: null,
-        Ye: null,
-        Ze: 0,
+        Me: 0,
+        rt: undefined,
+        ct: null,
+        ut: null,
+        je: null,
+        Ke: 0,
         u: null,
-        rt: null,
+        _t: null,
         ke: context,
-        Ve: null,
-        ct: null,
-        ve: null,
+        Le: null,
+        ft: null,
+        xe: null,
         ie: REACTIVE_LAZY,
         S: STATUS_UNINITIALIZED,
         Te: clock,
-        Pe: NOT_PENDING,
-        _e: null,
-        _t: -1,
-        Ie: false,
-        Xe: false,
-        dt: undefined,
-        Tt: t,
-        St: n,
+        Re: NOT_PENDING,
+        Ae: null,
+        It: -1,
+        Ne: false,
+        tt: false,
         At: undefined,
-        Re: i,
+        Ot: t,
+        Ct: n,
+        Rt: undefined,
+        ge: i,
         o: null
     };
     // Effects dispatch status through the SHARED notifier (statusNotifierOf,
@@ -494,7 +529,7 @@ function computed(e, t) {
     // allocation on EVERY effect at creation (an alloc + 19 field stores,
     // +23% effect creation, caught by the creation benches). Only genuinely
     // per-node channels (boundaries) live on _x.
-        if (u?.unobserved) ext(o).ft = u.unobserved;
+        if (u?.unobserved) ext(o).Et = u.unobserved;
     setupComputedNode(o, lazyOptions);
     return o;
 }
@@ -515,10 +550,9 @@ function setEffectStatusNotify(e) {
  * the field) fall back to the shared notifier. Presence doubles as the
  * "display consumer" membership test in the status walks, exactly as the
  * per-node field did when every effect carried one. */ function statusNotifierOf(e) {
-    const t = e.o;
-    const n = t !== null && t !== undefined ? t.h : undefined;
-    if (n !== undefined) return n;
-    return e.Re ? effectStatusNotify ?? undefined : undefined;
+    const t = e.o?.h;
+    if (t !== undefined) return t;
+    return e.ge ? effectStatusNotify ?? undefined : undefined;
 }
 
 const lazyOptions = {
@@ -526,24 +560,24 @@ const lazyOptions = {
 };
 
 function setupComputedNode(e, t) {
-    e.st = e;
-    const n = context?.Ct ? context.Ot : context;
+    e.ct = e;
+    const n = context?.Gt ? context.Dt : context;
     if (context) {
-        const t = context.ve;
+        const t = context.xe;
         if (t === null) {
-            context.ve = e;
+            context.xe = e;
         } else {
-            e.Ve = t;
-            t.ct = e;
-            context.ve = e;
+            e.Le = t;
+            t.ft = e;
+            context.xe = e;
         }
     }
-    if (n) e.Le = n.Le + 1;
-    if (GlobalQueue.Rt !== null) GlobalQueue.Rt(e);
+    if (n) e.Me = n.Me + 1;
+    if (GlobalQueue.Pt !== null) GlobalQueue.Pt(e);
     !t?.lazy && recompute(e, true);
     if (snapshotCaptureActive && !t?.lazy) {
         if (!(e.S & STATUS_PENDING) && !(e.T & CONFIG_NO_SNAPSHOT)) {
-            ext(e).Qe = e.be === undefined ? NO_SNAPSHOT : e.be;
+            ext(e).We = e.be === undefined ? NO_SNAPSHOT : e.be;
             e.T |= CONFIG_HAS_SNAPSHOT;
             snapshotSources.add(e);
         }
@@ -552,31 +586,31 @@ function setupComputedNode(e, t) {
 
 function signal(e, t, n = null) {
     const i = {
-        Ue: t?.equals != null ? t.equals : isEqual,
+        pe: t?.equals ?? isEqual,
         T: (t?.ownedWrite ? CONFIG_OWNED_WRITE : 0) | (t?.H ? CONFIG_NO_SNAPSHOT : 0),
         be: e,
         u: null,
-        rt: null,
+        _t: null,
         Te: clock,
-        lt: n,
+        st: n,
         Se: n?.o?.i || null,
-        Pe: NOT_PENDING,
+        Re: NOT_PENDING,
         // Signal-literal diet (§12e): NO _time/_fn/_statusFlags slots. Stores
         // materialize one signal per touched leaf, so signal bytes are store
         // bytes. _time is write-only on signals (every read site is computed-
         // typed error-retry gating); _fn/_statusFlags read falsy-identically as
         // missing properties on the shared paths (undefined masks to 0).
-        _e: null,
-        _t: -1,
+        Ae: null,
+        It: -1,
         o: null
     };
-    if (t?.unobserved) ext(i).ft = t.unobserved;
+    if (t?.unobserved) ext(i).Et = t.unobserved;
     if (n) {
         ext(n).i = i;
         n.T |= CONFIG_FW_CHILDREN;
     }
     if (snapshotCaptureActive && !(i.T & CONFIG_NO_SNAPSHOT) && !((n?.S ?? 0) & STATUS_PENDING)) {
-        ext(i).Qe = e === undefined ? NO_SNAPSHOT : e;
+        ext(i).We = e === undefined ? NO_SNAPSHOT : e;
         i.T |= CONFIG_HAS_SNAPSHOT;
         snapshotSources.add(i);
     }
@@ -585,14 +619,14 @@ function signal(e, t, n = null) {
 
 function optimisticSignal(e, t) {
     const n = signal(e, t);
-    ext(n).De = NOT_PENDING;
+    ext(n).Pe = NOT_PENDING;
     n.T |= CONFIG_OPTIMISTIC;
     return n;
 }
 
 function optimisticComputed(e, t) {
     const n = computed(e, t);
-    ext(n).De = NOT_PENDING;
+    ext(n).Pe = NOT_PENDING;
     n.T |= CONFIG_OPTIMISTIC;
     return n;
 }
@@ -623,11 +657,11 @@ function isEqual(e, t) {
  * );
  * ```
  */ function untrack(e, t) {
-    if (GlobalQueue.Gt === null && !tracking && true) return e();
+    if (GlobalQueue.ht === null && !tracking && true) return e();
     const n = tracking;
     tracking = false;
     try {
-        if (GlobalQueue.Gt !== null) return GlobalQueue.Gt(e);
+        if (GlobalQueue.ht !== null) return GlobalQueue.ht(e);
         return e();
     } finally {
         tracking = n;
@@ -668,16 +702,44 @@ function isEqual(e, t) {
  * fast path, `_fn` nodes need prepareComputed, and firewall / override /
  * snapshot / transition / lane / dev-strictRead state all take the full
  * resolution. Anything slow returns READ_SLOW; the caller then calls read().
- */ function readNodeFast(e) {
-    if (latestReadActive || pendingCheckActive || e.oe || e.lt || e.o?.De !== undefined || e.o?.Qe !== undefined || activeTransition !== null || currentOptimisticLane !== null || snapshotCaptureActive || false) return READ_SLOW;
+ */
+/**
+ * Wake only authoritative-view readers (until() predicates) subscribed to `el`.
+ * The A17-silent ack paths — an authoritative arrival equal to the active
+ * override — use this so the predicate re-evaluates without re-firing
+ * ordinary subscribers whose visible (override) value did not change.
+ * Pay-for-use: reached through GlobalQueue._notifyAuthoritativeObservers,
+ * installed at first until() call — apps that never use until() shake it.
+ */ function notifyAuthoritativeObservers(e) {
+    for (let t = e.u; t !== null; t = t.ae) {
+        const e = t.ce;
+        if (!(e.T & CONFIG_AUTHORITATIVE_READ)) continue;
+        // Missed-wake latch (#3037), same contract as insertSubs: the reader may
+        // itself have pulled this recompute (updateIfNecessary from its own
+        // read), and the heap refuses RECOMPUTING nodes — latch so recompute's
+        // tail reschedules it with the staged value visible.
+                if (e.ie & REACTIVE_RECOMPUTING_DEPS && t.Ft === e.Ke && t !== e.je) e.ie |= REACTIVE_MISSED_WAKE;
+        enqueueSub(e);
+    }
+    schedule();
+}
+
+/** Installs the until() machinery hook. Idempotent; called by until() before
+ * any authoritative-view read happens (same late-binding contract as the
+ * optimistic engine). */ function installAuthoritativeRead() {
+    if (GlobalQueue.he === null) GlobalQueue.he = notifyAuthoritativeObservers;
+}
+
+function readNodeFast(e) {
+    if (latestReadActive || pendingCheckActive || e.oe || e.st || e.o?.Pe !== undefined || e.o?.We !== undefined || activeTransition !== null || currentOptimisticLane !== null || snapshotCaptureActive || false) return READ_SLOW;
     let t = context;
-    if (t?.Ct) t = t.Ot;
+    if (t?.Gt) t = t.Dt;
     if (t && tracking) link(e, t);
     // Children-forbidden readers (createTrackedEffect / onSettled callbacks) get
     // committed visibility: like the effect half of createEffect and event
     // handlers, effect-phase code never observes its own unsettled write — the
     // write lands in the same flush's continuation (#3006).
-        return !t || e.Pe === NOT_PENDING || t.T & CONFIG_CHILDREN_FORBIDDEN ? e.be : e.Pe;
+        return !t || e.Re === NOT_PENDING || t.T & CONFIG_CHILDREN_FORBIDDEN ? e.be : e.Re;
 }
 
 function read(e) {
@@ -685,47 +747,54 @@ function read(e) {
     // Checked before isPending so that isPending(() => latest(x)) checks
     // the _pendingSignal of _latestValueComputed (async in flight) rather
     // than the original node (which stays "pending" while held in a transition).
-    if (latestReadActive) return GlobalQueue.Pt(e);
+    if (latestReadActive) return GlobalQueue.gt(e);
     let t = context;
-    if (t?.Ct) t = t.Ot;
+    if (t?.Gt) t = t.Dt;
     const n = e;
-    const i = e.lt;
+    const i = e.st;
     const u = i || e;
     // Handle isPending() mode: collect pending state while preserving normal read semantics.
     // Probe mode is suspended while preparing the node so nested reads during a
     // recompute don't collect into the probe.
         if (pendingCheckActive) {
-        GlobalQueue.Dt(e, t, u, i);
+        GlobalQueue.Ht(e, t, u, i);
     } else if (typeof n.oe === "function") {
         prepareComputed(e, false);
     }
-    if (!n.oe && u === e && e.o?.De === undefined && e.o?.Qe === undefined && activeTransition === null && currentOptimisticLane === null && !snapshotCaptureActive && true) {
+    if (!n.oe && u === e && e.o?.Pe === undefined && e.o?.We === undefined && activeTransition === null && currentOptimisticLane === null && !snapshotCaptureActive && true) {
         if (t && tracking) link(e, t);
         // Committed visibility for children-forbidden readers — see readNodeFast.
-                return !t || e.Pe === NOT_PENDING || t.T & CONFIG_CHILDREN_FORBIDDEN ? e.be : e.Pe;
+                return !t || e.Re === NOT_PENDING || t.T & CONFIG_CHILDREN_FORBIDDEN ? e.be : e.Re;
     }
     if (t && tracking) {
         link(e, t, pendingCheckActive);
         if (u.oe) {
             const n = queueFor(e);
-            if (u.Le >= n.xe) {
+            if (u.Me >= n.Qe) {
                 markNode(t);
                 markHeap(n);
                 updateIfNecessary(u);
             }
-            const i = u.Le;
+            // Fresh-pull readers (awaitable refresh's waiter) recompute a dirty
+            // source inline even when the height gate defers to the flush: the
+            // waiter must park on the re-ask's window (or serve its sync answer),
+            // never read the PRE-re-ask value as settled. Self-guarded: a clean
+            // node no-ops and updateIfNecessary refuses disposed nodes (#2983) —
+            // a dead target serves its last value, which is already quiescent.
+             else if (t.T & CONFIG_FRESH_READ) updateIfNecessary(u);
+            const i = u.Me;
             // parent check is shallow, might need to be recursive
-                        if (i >= t.Le && e.ke !== t) {
-                t.Le = i + 1;
+                        if (i >= t.Me && e.ke !== t) {
+                t.Me = i + 1;
             }
         }
     }
     if (u.S & STATUS_PENDING) {
-        if (t && !(stale && u._e && activeTransition !== u._e)) {
+        if (t && !(stale && u.Ae && activeTransition !== u.Ae)) {
             // Per-lane suspension lives with the engine (a non-null lane implies it
             // is installed): under a lane, only same-lane pending async without an
             // active override throws.
-            if (currentOptimisticLane === null || GlobalQueue.ht(u)) {
+            if (currentOptimisticLane === null || GlobalQueue.Vt(u)) {
                 if (!tracking && e !== t) link(e, t);
                 throw u.o?._;
             }
@@ -761,17 +830,27 @@ function read(e) {
         } else throw u.o?._;
     }
     if (snapshotCaptureActive && t && t.T & CONFIG_IN_SNAPSHOT_SCOPE) {
-        const n = e.o?.Qe;
+        const n = e.o?.We;
         if (n !== undefined) {
             const i = n === NO_SNAPSHOT ? undefined : n;
-            const u = e.Pe !== NOT_PENDING ? e.Pe : e.be;
+            const u = e.Re !== NOT_PENDING ? e.Re : e.be;
             if (u !== i) t.ie |= REACTIVE_SNAPSHOT_STALE;
             return i;
         }
     }
-    if (e.o?.De !== undefined && e.o?.De !== NOT_PENDING) {
-        // A17: the override IS the value for every reader.
-        return unwrapOverride(e.o?.De);
+    if (e.o?.Pe !== undefined && e.o?.Pe !== NOT_PENDING) {
+        // A17: the override IS the value for every reader — except an authoritative
+        // reader (until()'s predicate carries CONFIG_AUTHORITATIVE_READ): it must
+        // observe independently-arriving truth, and serving it the caller's own
+        // tentative write would trivially satisfy the predicate. The bit is checked
+        // on the reading computation itself, so a shared computed the predicate
+        // pulls recomputes as ITSELF (context = the memo, no bit) under the normal
+        // view. Fall through to normal value selection (staged `_pendingValue` is
+        // authoritative — optimism never lives there); the sticky mark makes the
+        // A17-silent "landing equals override" paths notify this node's subs so
+        // the reader re-runs when truth arrives.
+        if (!(t && t.T & CONFIG_AUTHORITATIVE_READ)) return unwrapOverride(e.o?.Pe);
+        e.T |= CONFIG_AUTHORITATIVE_OBSERVED;
     }
     // Entanglement gate: a reader recomputing under an optimistic lane that reads
     // a pending mid-transition write sees the committed value. Projection-store
@@ -780,7 +859,7 @@ function read(e) {
     // _pendingValue for correct fetching. The sub is recorded for replay at commit
     // so it re-runs with the new committed view. (Gate details live with the
     // engine — a non-null lane implies it is installed.)
-        if (currentOptimisticLane !== null && activeTransition !== null && t !== null && GlobalQueue.Ft(e, u, t)) {
+        if (currentOptimisticLane !== null && activeTransition !== null && t !== null && GlobalQueue.vt(e, u, t)) {
         return e.be;
     }
     // In optimistic lane context, return _value for optimistic/lane-assigned signals
@@ -789,10 +868,19 @@ function read(e) {
     // (The lane-context clause lives with the engine.) Children-forbidden readers
     // (createTrackedEffect / onSettled callbacks) get committed visibility — see
     // readNodeFast (#3006).
-        const l = !t || currentOptimisticLane !== null && GlobalQueue.gt(e, u, t) || e.Pe === NOT_PENDING || t.T & CONFIG_CHILDREN_FORBIDDEN || stale && e._e && activeTransition !== e._e ? e.be : e.Pe;
+        const l = !t || currentOptimisticLane !== null && GlobalQueue.bt(e, u, t) || e.Re === NOT_PENDING || t.T & CONFIG_CHILDREN_FORBIDDEN || stale && e.Ae && activeTransition !== e.Ae || 
+    // A17 for HELD truth (#3164, see CONFIG_HELD_TRUTH): staged confirming
+    // truth — fold-staged onto an armed family, or entangle-stolen by an
+    // awaited until() — is masked from ordinary readers until its
+    // transaction's reveal; the retaining transaction's own speculative
+    // recomputes included (partial override coverage would otherwise
+    // compose override + staged truth into a state no timeline contains).
+    // Authoritative readers (until()'s predicate) and latest() see the
+    // staged truth — the tunnel that keeps the hold deadlock-free.
+    e.T & CONFIG_HELD_TRUTH && !latestReadActive && !(t.T & CONFIG_AUTHORITATIVE_READ) ? e.be : e.Re;
     // Record that this isPending() probe observed the fresh pending value, so
     // the probe doesn't pair "pending" with the new value (#2831).
-        if (pendingCheckActive) GlobalQueue.Ht(e, l);
+        if (pendingCheckActive) GlobalQueue.kt(e, l);
     if (!t && u === e && typeof n.oe === "function" && e.T & CONFIG_AUTO_DISPOSE && !(u.S & STATUS_PENDING) && !e.u) {
         // Deferred, not inline (#3078): an inline unobserved() here made untracked
         // reads destructive — dispose on this read, full revival recompute on the
@@ -807,28 +895,28 @@ function read(e) {
 }
 
 function setSignal(e, t) {
-    if (e._e && activeTransition !== e._e) globalQueue.initTransition(e._e);
+    if (e.Ae && activeTransition !== e.Ae) globalQueue.initTransition(e.Ae);
     // The optimistic write path lives with the engine: only optimisticSignal /
     // optimisticComputed callers and optimistic store nodes carry an
     // _overrideValue slot (flagged by CONFIG_OPTIMISTIC — a masked read of the
     // always-present config instead of a missing-property probe), and every
     // module that installs one installs the engine first.
-        if (e.T & CONFIG_OPTIMISTIC && !projectionWriteActive) return GlobalQueue.kt(e, t);
-    const n = e.Pe === NOT_PENDING ? e.be : e.Pe;
+        if (e.T & CONFIG_OPTIMISTIC && !projectionWriteActive) return GlobalQueue.xt(e, t);
+    const n = e.Re === NOT_PENDING ? e.be : e.Re;
     if (typeof t === "function") t = t(n);
     // Uninitialized check first: the first commit has no previous value, so the
     // user comparator must not run against `undefined` (matches recompute).
-        const i = !!(e.S & STATUS_UNINITIALIZED) || !e.Ue || !e.Ue(n, t);
+        const i = !!(e.S & STATUS_UNINITIALIZED) || !e.pe || !e.pe(n, t);
     if (!i) return t;
-    const u = e.Pe !== NOT_PENDING;
+    const u = e.Re !== NOT_PENDING;
     if (!u) queuePendingNode(e);
-    e.Pe = t;
+    e.Re = t;
     // syncCompanions only pokes _pendingSignal/_latestValueComputed — with
     // neither companion present the call is a guaranteed no-op (companions are
     // only ever created, never removed, and creating one installs the hook and
     // sets CONFIG_HAS_COMPANIONS — one masked read replaces two optional-field
     // probes on every write).
-        e.T & CONFIG_HAS_COMPANIONS && GlobalQueue.Oe !== null && GlobalQueue.Oe(e, t);
+        e.T & CONFIG_HAS_COMPANIONS && GlobalQueue.Ue !== null && GlobalQueue.Ue(e, t);
     // _time is a computed-only slot (§12e): writing it on a signal would fork
     // the lean shape. Every read site is computed-typed.
         if (e.oe !== undefined) e.Te = clock;
@@ -837,7 +925,7 @@ function setSignal(e, t) {
     // (epoch) — re-stages the value and stops. The walk is idempotent (subs
     // marked, heap entries flag-guarded, effects queued once); lane and reask
     // contexts change what a walk MEANS, so they always walk.
-        if (u && e._t === notifyEpoch && currentOptimisticLane === null && !reaskArmed) return t;
+        if (u && e.It === notifyEpoch && currentOptimisticLane === null && !reaskArmed) return t;
     insertSubs(e);
     schedule();
     return t;
@@ -851,12 +939,12 @@ function setSignal(e, t) {
  * cleanup point.
  */ function suppressComputedRecompute(e) {
     deleteFromHeap(e, queueFor(e));
-    if (!(e.ie & REACTIVE_MANUAL_WRITE) && e.Pe === NOT_PENDING) {
+    if (!(e.ie & REACTIVE_MANUAL_WRITE) && e.Re === NOT_PENDING) {
         queuePendingNode(e);
         schedule();
     }
     e.ie = e.ie & -4 | REACTIVE_MANUAL_WRITE;
-    e.vt = clock;
+    e.Ut = clock;
 }
 
 /**
@@ -912,39 +1000,22 @@ function staleValues(e, t = true) {
 }
 
 /**
- * Invalidates one reactive source, forcing it to re-execute even if its inputs
- * haven't changed.
- *
- * Pass either a Solid-created accessor or a projected store created from
- * `createStore(fn, ...)` / `createProjection(...)`. `refresh()` is a
- * write-like invalidation operation: it does not read the target's value, and
- * refreshing a plain signal accessor is a no-op.
- *
- * Use it to invalidate cached async values (e.g. force a re-fetch) without
- * tearing the consumer down.
- *
- * @example
- * ```ts
- * const user = createMemo(async () => fetch(`/users/${id()}`).then(r => r.json()));
- *
- * // Re-fetch on demand
- * <button onClick={() => refresh(user)}>Reload</button>
- * ```
- */ function refresh(e) {
-    const t = e?.[$REFRESH];
-    if (!t) {
-        return;
-    }
-    if (typeof t.oe === "function" && !(t.ie & REACTIVE_DISPOSED)) {
-        if (t.ie & REACTIVE_MANUAL_WRITE) {
+ * Core marking half of `refresh()` (the public wrapper lives in signals.ts —
+ * it validates the target, marks through here, then builds the quiescence
+ * promise on the resolve()/until() effect machinery). Flags the node's next
+ * recompute as a quiet re-ask and schedules it; no-ops for non-derived or
+ * disposed targets and for same-tick manual writes.
+ */ function markRefresh(e) {
+    if (typeof e.oe === "function" && !(e.ie & REACTIVE_DISPOSED)) {
+        if (e.ie & REACTIVE_MANUAL_WRITE) {
             // A manual write in the CURRENT tick wins over the refresh (#2692).
             // A mask stamped in an earlier tick only survives because a
             // transaction (action) is holding the pending drain open; there the
             // refresh is a later, explicit re-ask and lifts the mask — otherwise
             // any setStore early in an action silently swallows every refresh()
             // for the rest of the transaction (#3026).
-            if (t.vt === clock) return;
-            t.ie &= ~REACTIVE_MANUAL_WRITE;
+            if (e.Ut === clock) return;
+            e.ie &= ~REACTIVE_MANUAL_WRITE;
             // No REASK below: the batch carries a manual value change, so the
             // recompute is not a quiet re-ask of an unchanged question.
                 }
@@ -955,14 +1026,14 @@ function staleValues(e, t = true) {
         // REACTIVE_IN_HEAP counts as dirt: insertSubs schedules subscribers by
         // heap insertion alone (no DIRTY/CHECK flag), so a same-batch value
         // change followed by refresh() must not be laundered into a quiet re-ask.
-         else if (!(t.ie & (REACTIVE_DIRTY | REACTIVE_CHECK | REACTIVE_IN_HEAP))) {
-            t.ie |= REACTIVE_REASK;
+         else if (!(e.ie & (REACTIVE_DIRTY | REACTIVE_CHECK | REACTIVE_IN_HEAP))) {
+            e.ie |= REACTIVE_REASK;
             armReaskClear();
         }
-        t.ie = t.ie & ~REACTIVE_CHECK | REACTIVE_DIRTY;
-        insertIntoHeap(t, queueFor(t));
+        e.ie = e.ie & ~REACTIVE_CHECK | REACTIVE_DIRTY;
+        insertIntoHeap(e, queueFor(e));
         schedule();
     }
 }
 
-export { READ_SLOW, clearSnapshots, computed, context, createEffectNode, currentOptimisticLane, effectStatusNotify, ext, isEqual, latestReadActive, markSnapshotScope, optimisticComputed, optimisticSignal, pendingCheckActive, prepareComputed, read, readNodeFast, recompute, refresh, releaseSnapshotScope, runWithOwner, setContextInternal, setEffectStatusNotify, setLatestReadActive, setMemo, setPendingCheckActive, setSignal, setSnapshotCapture, signal, snapshotCaptureActive, snapshotSources, stale, staleValues, statusNotifierOf, suppressComputedRecompute, tracking, untrack };
+export { READ_SLOW, clearSnapshots, computed, context, createEffectNode, currentOptimisticLane, effectStatusNotify, ext, installAuthoritativeRead, isEqual, latestReadActive, markRefresh, markSnapshotScope, notifyAuthoritativeObservers, optimisticComputed, optimisticSignal, pendingCheckActive, prepareComputed, read, readNodeFast, recompute, releaseSnapshotScope, runWithOwner, setContextInternal, setEffectStatusNotify, setLatestReadActive, setMemo, setPendingCheckActive, setSignal, setSnapshotCapture, signal, snapshotCaptureActive, snapshotSources, stale, staleValues, statusNotifierOf, suppressComputedRecompute, tracking, untrack };