@solidjs/signals 2.0.0-rc.15 → 2.0.0-rc.17

package/dist/observe/reveal.js

@@ -32,124 +32,124 @@ const SEQUENTIAL_ACCESSOR = () => "sequential";
 
 const isController = t => t instanceof RevealController;
 
-const slotReady = t => isController(t) ? t.rs() : ready(t);
+const slotReady = t => isController(t) ? t.Lt() : ready(t);
 
-const slotMinReady = t => isController(t) ? t.ns() : ready(t);
+const slotMinReady = t => isController(t) ? t.Qt() : ready(t);
 
 /** Force a slot's state. A boundary re-derives its output when it changes;
  * a nested controller passes the state on to its own slots. Released
  * (`!gated`), a nested controller leaves its parent's ownership and runs its
  * own order; a boundary leaves when it has shown content (boundaries.ts). */ function setSlotState(t, e, s, r) {
     if (isController(t)) {
-        t.ne = s;
-        t.re = r;
-        t.ls();
+        t.$ = s;
+        t.ee = r;
+        t.Bt();
         // Released and ready — every slot of its own has shown — it graduates,
         // as a boundary does when it shows content. Released at the frontier
         // but not ready, it stays the parent's frontier.
-                if (!s && t.us && t._parent === e) t._parent = null;
+                if (!s && t.Jt && t._parent === e) t._parent = null;
         return;
     }
-    if (t.ne !== s || t.re !== r) {
-        t.ne = s;
-        t.re = r;
+    if (t.$ !== s || t.ee !== r) {
+        t.$ = s;
+        t.ee = r;
         redraw(t);
     }
 }
 
 class RevealController {
-    hs;
-    cs;
-    fs=[];
+    Xt;
+    Yt;
+    Zt=[];
     /** The controller gating this one, until it releases this one. */
     _parent=null;
     /** The state a parent forces on this whole group. */
-    ne=false;
-    re=false;
-    us=true;
-    ds=true;
-    Ss=false;
+    $=false;
+    ee=false;
+    Jt=true;
+    ts=true;
+    es=false;
     constructor(t, e) {
-        this.hs = t;
-        this.cs = e;
+        this.Xt = t;
+        this.Yt = e;
     }
     /** A slot that has left this controller's ownership: a boundary that has
      * shown content, a nested group that is ready. Shown is shown — it counts
-     * as ready whatever happens to it later (a re-arm gates nobody else). */    Rs(t) {
-        return (isController(t) ? t._parent : t.V) !== this;
+     * as ready whatever happens to it later (a re-arm gates nobody else). */    ss(t) {
+        return (isController(t) ? t._parent : t.v) !== this;
     }
     /** The slots this controller still owns, in registration order — the
-     * ones the order's state is forced on. */    _s(t) {
-        for (let e = 0; e < this.fs.length; e++) {
-            const s = this.fs[e];
-            if (!this.Rs(s) && t(s) === false) return false;
+     * ones the order's state is forced on. */    rs(t) {
+        for (let e = 0; e < this.Zt.length; e++) {
+            const s = this.Zt[e];
+            if (!this.ss(s) && t(s) === false) return false;
         }
         return true;
     }
-    /** Readiness is judged over every slot, done ones as ready. */    rs() {
-        for (let t = 0; t < this.fs.length; t++) {
-            const e = this.fs[t];
-            if (!this.Rs(e) && !slotReady(e)) return false;
+    /** Readiness is judged over every slot, done ones as ready. */    Lt() {
+        for (let t = 0; t < this.Zt.length; t++) {
+            const e = this.Zt[t];
+            if (!this.ss(e) && !slotReady(e)) return false;
         }
         return true;
     }
     /** Something visible to show under its own order — what an enclosing
      * `together` waits for: `together` — every slot minimally ready;
-     * `sequential` — the first slot; `natural` — any. */    ns() {
-        const t = untrack(this.hs);
-        const e = this.fs;
+     * `sequential` — the first slot; `natural` — any. */    Qt() {
+        const t = untrack(this.Xt);
+        const e = this.Zt;
         if (e.length === 0) return true;
-        if (t === "sequential") return this.Rs(e[0]) || slotMinReady(e[0]);
+        if (t === "sequential") return this.ss(e[0]) || slotMinReady(e[0]);
         for (let s = 0; s < e.length; s++) {
-            const r = this.Rs(e[s]) || slotMinReady(e[s]);
+            const r = this.ss(e[s]) || slotMinReady(e[s]);
             if (t === "natural" ? r : !r) return t === "natural";
         }
         return t !== "natural";
     }
-    ue(t) {
-        if (this.fs.includes(t)) return;
-        this.fs.push(t);
+    oe(t) {
+        if (this.Zt.includes(t)) return;
+        this.Zt.push(t);
         // Gated from the start (collapsed in a collapsed sequential tail); the
         // evaluation releases what the order allows.
-                const e = untrack(this.hs) === "sequential" && !!untrack(this.cs);
+                const e = untrack(this.Xt) === "sequential" && !!untrack(this.Yt);
         if (isController(t)) {
             t._parent = this;
-            t.ne = true;
-            t.re = e;
-            t.ls();
+            t.$ = true;
+            t.ee = e;
+            t.Bt();
         } else {
-            t.V = this;
-            t.ne = true;
-            t.re = e;
+            t.v = this;
+            t.$ = true;
+            t.ee = e;
         }
-        untrack(() => this.ls());
+        untrack(() => this.Bt());
     }
-    oe(t) {
-        const e = this.fs.indexOf(t);
-        if (e >= 0) this.fs.splice(e, 1);
-        untrack(() => this.ls());
+    te(t) {
+        const e = this.Zt.indexOf(t);
+        if (e >= 0) this.Zt.splice(e, 1);
+        untrack(() => this.Bt());
     }
     /** Apply the order to the owned slots — or, gated by a parent, its state
-     * to all of them. */    ls() {
-        if (this.Ss) return;
-        this.Ss = true;
-        const t = this.us;
-        const e = this.ds;
+     * to all of them. */    Bt() {
+        if (this.es) return;
+        this.es = true;
+        const t = this.Jt;
+        const e = this.ts;
         try {
-            const t = untrack(this.hs);
-            const e = t === "sequential" && !!untrack(this.cs);
-            if (this.ne) {
-                this._s(t => setSlotState(t, this, true, this.re));
+            const t = untrack(this.Xt);
+            const e = t === "sequential" && !!untrack(this.Yt);
+            if (this.$) {
+                this.rs(t => setSlotState(t, this, true, this.ee));
             } else if (t === "natural") {
-                this._s(t => {
+                this.rs(t => {
                     if (isController(t)) setSlotState(t, this, false, false); else setSlotState(t, this, !ready(t), false);
                 });
             } else if (t === "together") {
-                const t = this._s(slotMinReady);
-                this._s(e => setSlotState(e, this, !t, false));
+                const t = this.rs(slotMinReady);
+                this.rs(e => setSlotState(e, this, !t, false));
             } else {
                 let t = false;
-                this._s(s => {
+                this.rs(s => {
                     if (t) return setSlotState(s, this, true, e);
                     if (slotReady(s)) return setSlotState(s, this, false, false);
                     t = true;
@@ -159,11 +159,11 @@ class RevealController {
                 });
             }
         } finally {
-            this.us = this.rs();
-            this.ds = this.ns();
-            this.Ss = false;
+            this.Jt = this.Lt();
+            this.ts = this.Qt();
+            this.es = false;
         }
-        if (this._parent !== null && (t !== this.us || e !== this.ds)) this._parent.ls();
+        if (this._parent !== null && (t !== this.Jt || e !== this.ts)) this._parent.Bt();
     }
 }
 
@@ -179,23 +179,23 @@ class RevealController {
  *   slots behind the frontier render nothing instead of their fallbacks
  */ function createRevealOrder(t, e) {
     const s = createOwner();
-    const r = s.D[REVEAL];
+    const r = s.A[REVEAL];
     const i = new RevealController(e?.order || SEQUENTIAL_ACCESSOR, e?.collapsed || FALSE_ACCESSOR);
-    s.D = {
-        ...s.D,
+    s.A = {
+        ...s.A,
         [REVEAL]: i
     };
     return runWithOwner(s, () => {
         const e = t();
         const s = computed(() => {
-            i.hs();
-            i.cs();
-            i.ls();
+            i.Xt();
+            i.Yt();
+            i.Bt();
         });
         if (true) s._name = "reveal order";
         if (r) {
-            r.ue(i);
-            cleanup(() => r.oe(i));
+            r.oe(i);
+            cleanup(() => r.te(i));
         }
         return e;
     });
@@ -204,9 +204,9 @@ class RevealController {
 // Installed at module evaluation — present exactly when something imports
 // `createRevealOrder`; a Loading boundary without one pays a null check.
 setRevealHooks({
-    ue: (t, e) => t.ue(e),
     oe: (t, e) => t.oe(e),
-    P: t => t.ls()
+    te: (t, e) => t.te(e),
+    P: t => t.Bt()
 });
 
 export { createRevealOrder };

package/dist/observe/signals.js

@@ -12,9 +12,13 @@ import { globalQueue, flushTransaction, dirtyQueue, GlobalQueue, resolveTx, pass
 
 import { cleanup, createRoot, getOwner, dispose } from "./core/owner.js";
 
+import { signalHook } from "./core/identities.js";
+
 import { effect, trackedEffect } from "./core/effect.js";
 
-import { optimisticWrite, truthRead, truthConfirmed } from "./core/lanes.js";
+import { optimisticWrite } from "./core/lanes.js";
+
+import { truthRead, truthConfirmed } from "./core/truth.js";
 
 /**
  * Low-level reactive-cleanup primitive. Registers a callback that runs when
@@ -73,18 +77,19 @@ function accessor(e) {
 function createSignal(e, t) {
     if (typeof e === "function") {
         const r = computed(e, t);
-        r.i &= ~CONFIG_AUTO_DISPOSE;
+        r.l &= ~CONFIG_AUTO_DISPOSE;
         return [ accessor(r), setMemo.bind(null, r) ];
     }
     const r = signal(e, t);
     registerGraph(r, getOwner());
+    if (signalHook !== null) signalHook(r);
     return [ accessor(r), setSignal.bind(null, r) ];
 }
 
 function createOptimistic(e, t) {
     if (typeof e === "function") {
         const r = computed(e, t);
-        r.i &= ~CONFIG_AUTO_DISPOSE;
+        r.l &= ~CONFIG_AUTO_DISPOSE;
         return [ accessor(r), optimisticWrite.bind(null, r) ];
     }
     const r = signal(e, t);
@@ -162,7 +167,7 @@ function createMemo(e, t) {
  * );
  * ```
  *
- * @description https://docs.solidjs.com/reference/basic-reactivity/create-effect
+ * @description https://v2.solidjs.com/reference/solid-js/reactivity/create-effect
  */ function createEffect(e, t, r) {
     effect(e, t.effect || t, t.error, {
         user: true,
@@ -197,7 +202,7 @@ function createMemo(e, t) {
  * }
  * ```
  *
- * @description https://docs.solidjs.com/reference/secondary-primitives/create-render-effect
+ * @description https://v2.solidjs.com/reference/solid-js/advanced/specialized-reactivity/create-render-effect
  */ function createRenderEffect(e, t, r) {
     effect(e, t, undefined, r);
 }
@@ -245,7 +250,7 @@ function createMemo(e, t) {
  * });
  * ```
  *
- * @description https://docs.solidjs.com/reference/secondary-primitives/create-tracked-effect
+ * @description https://v2.solidjs.com/reference/solid-js/advanced/specialized-reactivity/create-tracked-effect
  */ function createTrackedEffect(e, t) {
     trackedEffect(e, t);
 }
@@ -274,7 +279,7 @@ function createMemo(e, t) {
  * setCount(1); // logs once, reaction re-armed for next change
  * ```
  *
- * @description https://docs.solidjs.com/reference/secondary-primitives/create-reaction
+ * @description https://v2.solidjs.com/reference/solid-js/advanced/specialized-reactivity/create-reaction
  */ function createReaction(e, t) {
     let r = undefined;
     cleanup(() => r?.());
@@ -291,7 +296,12 @@ function createMemo(e, t) {
             o = undefined;
         }
         runWithOwner(n, () => {
-            effect(() => (c(), o = getOwner()), t => {
+            effect(() => {
+                const e = getOwner();
+                o = e;
+                c();
+                return e;
+            }, t => {
                 o = undefined;
                 r?.();
                 const n = (e.effect || e)?.();
@@ -325,34 +335,40 @@ function createMemo(e, t) {
  *   joined it (L2, born held — A29) and delivers at that commit: the
  *   committed view, never a foreign hold's unrevealed frame. */ function watch(e, t, r, n = 0, o, c = flushTransaction) {
     if (n & CONFIG_AUTHORITATIVE) {
-        GlobalQueue.Nn = truthRead;
-        GlobalQueue.rn = truthConfirmed;
+        GlobalQueue.rn = truthRead;
+        GlobalQueue.tn = truthConfirmed;
     }
     // `config` is on the node for its first pass too (the pass runs inside
     // `computed()`): `until`'s predicate is authoritative from its first read,
     // or an already-displayed guess would satisfy it in a later slice. (REDERIVE
     // after: the first pass's own error is the promise's rejection.)
         computed(() => {
-        let n;
+        let i, u = false;
         try {
-            n = e();
+            i = e();
         } catch (e) {
             if (e instanceof NotReadyError) throw e;
-            queueMicrotask(() => r(unwrapStatusError(e)));
-            return;
+            // An error is an answer (D-41): delivered by the same frame rule.
+                        i = unwrapStatusError(e);
+            u = true;
         }
-        const u = getOwner();
+        const s = getOwner();
+        // A truth reader waits out a `createDeferred` flight its value derives
+        // from, which serves everyone else the stale answer (D-40).
+                const f = n & CONFIG_AUTHORITATIVE && GlobalQueue.er?.(s);
+        if (f) throw new NotReadyError(f);
         // (Outside a flush a mainline pass joins through `passTx`.)
-                const i = flushTransaction ?? passTx;
-        if (u.R & REACTIVE_JOINED && i !== null && (c === null || resolveTx(c) !== resolveTx(i))) {
-            staleReader(u, resolveTx(i));
+                const a = flushTransaction ?? passTx;
+        if (s.R & REACTIVE_JOINED && a !== null && (c === null || resolveTx(c) !== resolveTx(a))) {
+            staleReader(s, resolveTx(a));
             return;
         }
-        o?.(n);
-        queueMicrotask(() => t(n));
+        if (u) return void queueMicrotask(() => r(i));
+        o?.(i);
+        queueMicrotask(() => t(i));
     }, {
-        Ct: n
-    }).i |= CONFIG_REDERIVE;
+        St: n
+    }).l |= CONFIG_REDERIVE;
 }
 
 /**
@@ -451,7 +467,7 @@ function createMemo(e, t) {
                 // guessed node's own re-ask is not answered by it (#3895): park
                 // on that flight, or reject with its error.
                                 const e = read(t);
-                if (t.i & CONFIG_GUESS && t.S & (STATUS_PENDING | STATUS_ERROR)) throw t.m?.F;
+                if (t.l & CONFIG_GUESS && t.m & (STATUS_PENDING | STATUS_ERROR)) throw t.T?.F;
                 return e;
             }, t => {
                 n(typeof e === "function" ? t : e);
@@ -509,14 +525,14 @@ function createMemo(e, t) {
         // (`saving=true` beside the confirmed `version=1` is a tear no timeline
         // contains). Updates that do not flip the predicate reveal freely.
                 const c = flushTransaction;
-        createRoot(u => {
-            let i;
+        createRoot(i => {
+            let u;
             let s;
             const settle = e => {
-                if (i !== undefined) clearTimeout(i);
+                if (u !== undefined) clearTimeout(u);
                 if (s !== undefined) o.removeEventListener("abort", s);
                 e();
-                u();
+                i();
             };
             // Authoritative: the predicate sees the truth, never the action's own
             // optimistic guess — a guess cannot satisfy the wait for its own
@@ -529,9 +545,9 @@ function createMemo(e, t) {
                 // The flip, inside the pass of the flush carrying it: the flush
                 // joins the action's transaction, and what it staged is held and
                 // revealed with the action.
-                if (e && c !== null && globalQueue.X && resolveTx(c).tt !== 0) joinFuture(c);
+                if (e && c !== null && globalQueue.q && resolveTx(c).tt !== 0) joinFuture(c);
             });
-            if (t?.timeout !== undefined) i = setTimeout(() => settle(() => n(new TimeoutError)), t.timeout);
+            if (t?.timeout !== undefined) u = setTimeout(() => settle(() => n(new TimeoutError)), t.timeout);
             if (o !== undefined) {
                 s = () => settle(() => n(o.reason));
                 o.addEventListener("abort", s, {
@@ -637,7 +653,7 @@ function createMemo(e, t) {
  *   on owner disposal
  */ function onSettled(e) {
     const t = getOwner();
-    t && !(t.i & CONFIG_CHILDREN_FORBIDDEN) ? trackedEffect(() => untrack(e), {
+    t && !(t.l & CONFIG_CHILDREN_FORBIDDEN) ? trackedEffect(() => untrack(e), {
         name: "onSettled"
     }) : globalQueue.enqueue(EFFECT_USER, function fire() {
         // Settled means derived. A settle that reverts optimism (or replays
@@ -647,7 +663,7 @@ function createMemo(e, t) {
         // still holding the optimistic value — reads do not pull (#3411). Fall
         // to the next pass while the heap has work; `run` swapped the queue,
         // so this lands there, and `enqueue` keeps the drain alive.
-        if (dirtyQueue.Kt >= dirtyQueue.ut) return globalQueue.enqueue(EFFECT_USER, fire);
+        if (dirtyQueue.jt >= dirtyQueue.st) return globalQueue.enqueue(EFFECT_USER, fire);
         // Unowned, out-of-band fire (no owner, or a children-forbidden one this
         // one-shot must not bind to): a returned cleanup has no lifecycle to
         // attach to. Reject it in dev; in production the return is simply

package/dist/observe/store/affects.js

@@ -1,4 +1,4 @@
-import { GlobalQueue } from "../core/scheduler.js";
+import { GlobalQueue, releaseMarksHook } from "../core/scheduler.js";
 
 import { optHooks, installAffectsHooks } from "./hooks.js";
 
@@ -38,24 +38,24 @@ const scopes = new Map;
 function scopeOf(e, o) {
     let n = scopes.get(e);
     if (n === undefined) scopes.set(e, n = {
-        eo: new Set,
-        oo: [],
-        bt: o
+        oo: new Set,
+        no: [],
+        Vt: o
     });
     return n;
 }
 
 /** The nodes an `affects(store[, key])` declaration marks (affects.ts
  * registers each). */ function storeMarks(e, o) {
-    const n = GlobalQueue.no(e, o === undefined ? $AFFECTS : o);
+    const n = GlobalQueue.so(e, o === undefined ? $AFFECTS : o);
     const t = scopeOf(n, o);
     if (o === undefined) {
         const o = [ n ];
         walk(e.px, t, o, e.fam, new Set);
         return o;
     }
-    t.eo.add(e.v);
-    if (e.pb !== null) t.eo.add(e.pb);
+    t.oo.add(e.v);
+    if (e.pb !== null) t.oo.add(e.pb);
     return [ n ];
 }
 
@@ -63,14 +63,14 @@ function scopeOf(e, o) {
  * the committed backing both, when a draft is open; an optimistic family's
  * view), every live node under each record into `found`. Untracked by
  * construction: raws, never traps. */ function walk(e, o, n, t, s) {
-    if (!GlobalQueue.so(e)) return;
+    if (!GlobalQueue.fo(e)) return;
     const f = e[$TARGET] ?? lookupTarget(e, t);
     let r = f !== undefined ? f.pb ?? f.v : e;
     if (s.has(r)) return;
     s.add(r);
-    o.eo.add(r);
+    o.oo.add(r);
     if (f !== undefined) {
-        if (f.pb !== null) o.eo.add(f.v);
+        if (f.pb !== null) o.oo.add(f.v);
         // The writer's view: the tick's own unflushed guesses are in motion too.
                 if (f.fam?.opt === true) r = optHooks.view(f, r, true);
         const e = f.n;
@@ -94,9 +94,9 @@ function scopeOf(e, o) {
  * backings (§7b): a view's backing is another store's proxy — marks cover
  * the BASE raw, so every identity along the chain is checked. */ function covering(e, o, n) {
     for (const [t, s] of scopes) {
-        if (t === n || s.bt !== undefined && s.bt !== o) continue;
+        if (t === n || s.Vt !== undefined && s.Vt !== o) continue;
         for (let o = e.v; ;) {
-            if (s.eo.has(o)) return t;
+            if (s.oo.has(o)) return t;
             const e = o?.[$TARGET];
             if (e === undefined) break;
             const n = e.pb ?? e.v;
@@ -112,18 +112,18 @@ function scopeOf(e, o) {
  * no work. */ const hooks = {
     // A node born on a record a live mark covers inherits it (released with
     // the carrier's last registration).
-    fo(e, o, n) {
+    ro(e, o, n) {
         if (scopes.size === 0 || n === $AFFECTS) return;
         const t = covering(e, n, o);
         if (!t) return;
-        GlobalQueue.O(o);
-        scopes.get(t).oo.push(o);
+        GlobalQueue.N(o);
+        scopes.get(t).no.push(o);
     },
     // An untracked probe (`isPending(() => s.x)` with no observer) reading a
     // record a live mark covers: no node carries the mark for it — the
     // verdict is told directly.
-    ro(e, o) {
-        if (e.n?.[$AFFECTS]?.m?.T || covering(e, o)) GlobalQueue.Bt();
+    io(e, o) {
+        if (e.n?.[$AFFECTS]?.T?.I || covering(e, o)) GlobalQueue.bt();
     }
 };
 
@@ -136,7 +136,7 @@ function scopeOf(e, o) {
     const o = scopes.get(e);
     if (o === undefined) return;
     scopes.delete(e);
-    GlobalQueue.k(o.oo);
+    releaseMarksHook(o.no);
 }
 
 export { installStoreAffects, releaseMarkScope, storeMarks };

package/dist/observe/store/edges.js

@@ -0,0 +1,39 @@
+import { CONFIG_SLOT_NODE } from "../core/constants.js";
+
+import { signalName } from "../core/identities.js";
+
+import { $TARGET } from "./types.js";
+
+/**
+ * Deferred hydration, dependency edges for stores. Only the frames client
+ * imports this module, so nothing here ships without it.
+ *
+ * A plain store root (`createStore` over an object) is named like a plain
+ * signal (core/identities.ts: `<owner id>~<n>`, on the same count), and the
+ * whole store goes by that one name: the server records it for any read of
+ * the store, at any depth, and a setter call on the store — on its root or
+ * on a proxy nested in it — is a write to it. Its readers mount at the
+ * setter's entry, before the draft runs, as a plain signal's do.
+ */
+/**
+ * @internal The name of the store `x` belongs to — `x` a store proxy (a
+ * setter's entry) or one of its property nodes (the setter notifying it) —
+ * or undefined when it has none or it cannot be placed: a projection or
+ * optimistic family, a store chained over another store's proxy, a root
+ * named twice, or a proxy reached through a store other than the one it
+ * was named as the root of.
+ */ function storeName(e) {
+    if (e === undefined) return undefined;
+    let n = e.l & CONFIG_SLOT_NODE ? e.O : e[$TARGET];
+    if (n === undefined) return undefined;
+    // Up to the root; a target on the way named as a root of its own is one
+    // object in two stores.
+        while (n.u !== null) {
+        if (n.fam !== null || n.ch || signalName(n) !== undefined) return undefined;
+        n = n.u;
+    }
+    if (n.fam !== null || n.ch) return undefined;
+    return signalName(n) || undefined;
+}
+
+export { storeName };