@solidjs/signals 2.0.0-rc.2 → 2.0.0-rc.20

package/dist/observe/store/affects.js

@@ -0,0 +1,142 @@
+import { GlobalQueue, releaseMarksHook } from "../core/scheduler.js";
+
+import { optHooks, installAffectsHooks } from "./hooks.js";
+
+import { lookupTarget, $OWNER } from "./target.js";
+
+import { $TARGET } from "./types.js";
+
+/**
+ * Store — the store half of `affects()` (plan sec. 29, plan sec. 37; A24 (4), #2882,
+ * #2893, #2904).
+ *
+ * A mark on a store is a mark on nodes (affects.ts: a count on the node, a
+ * dependency walk at probe time): `affects(record, key)` marks the slot's
+ * leaf; `affects(record)` marks a carrier (the record's `$AFFECTS` leaf)
+ * and every live node in the record's subtree — the edges existing readers
+ * subscribed through. Coverage is by RAW IDENTITY, not read path (#2882: a
+ * captured row proxy, a derived store sharing the source's raw, never read
+ * through the declaration's proxy): the identities reachable at the
+ * declaration are the mark's `scope`, so a node born inside the window on
+ * a covered record inherits the mark (released with the carrier's last),
+ * and an untracked probe through a record with no nodes is witnessed into
+ * the verdict. A mark declared on a draft (inside a setter) or over an
+ * optimistic family walks the view the writer sees.
+ *
+ * Imported by `affects()`, which installs it on its first store target
+ * (#3891, after #3912): a program with stores that never declares a mark
+ * carries none of it. It never imports store.ts — the engine's top level —
+ * so a program declaring marks without stores carries this module alone:
+ * the store's nodes and its wrappability test come through `GlobalQueue`
+ * (`_storeNode`, `_storeWrappable`), and node birth and the untracked traps
+ * reach back through `affectsHooks` (hooks.ts).
+ */
+/** The keyless mark's carrier key: a leaf of the record no read serves. */ const $AFFECTS = Symbol(0);
+
+const scopes = new Map;
+
+function scopeOf(e, o) {
+    let n = scopes.get(e);
+    if (n === undefined) scopes.set(e, n = {
+        oo: new Set,
+        no: [],
+        gt: o
+    });
+    return n;
+}
+
+/** The nodes an `affects(store[, key])` declaration marks (affects.ts
+ * registers each). */ function storeMarks(e, 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.oo.add(e.v);
+    if (e.pb !== null) t.oo.add(e.pb);
+    return [ n ];
+}
+
+/** The identities reachable from `value` into the scope (the draft's and
+ * 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.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.oo.add(r);
+    if (f !== undefined) {
+        if (f.pb !== null) o.oo.add(f.v);
+        // The writer's view: the tick's own unflushed guesses are in motion too.
+                if (optHooks && f.fam?.opt === true) r = optHooks.view(f, r, true);
+        const e = f.n;
+        if (e !== null) for (const o of Reflect.ownKeys(e)) 
+        // Another mark's carrier is its own channel: counting it here would
+        // extend that scope's lifetime to this declaration's.
+        if (o !== $AFFECTS) n.push(e[o]);
+        const s = f.h;
+        if (s !== null) for (const e of Reflect.ownKeys(s)) n.push(s[e]);
+        if (f.k !== null) n.push(f.k);
+        if (f.dk !== null) n.push(f.dk);
+        t = f.fam ?? t;
+    }
+    for (const e of Reflect.ownKeys(r)) if (e !== $OWNER) {
+        const f = Object.getOwnPropertyDescriptor(r, e);
+        if (f.get === undefined) walk(f.value, o, n, t, s);
+    }
+}
+
+/** A live scope covering `t`'s identity (keyed: for `key`). Chained
+ * 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.gt !== undefined && s.gt !== o) continue;
+        for (let o = e.v; ;) {
+            if (s.oo.has(o)) return t;
+            const e = o?.[$TARGET];
+            if (e === undefined) break;
+            const n = e.pb ?? e.v;
+            if (n === o) break;
+            o = n;
+        }
+    }
+    return null;
+}
+
+/** The store's side: node birth and the untracked traps call it (store.ts,
+ * through `affectsHooks`) — with no live mark too: an empty scope map is
+ * no work. */ const hooks = {
+    // A node born on a record a live mark covers inherits it (released with
+    // the carrier's last registration).
+    ro(e, o, n) {
+        if (scopes.size === 0 || n === $AFFECTS) return;
+        const t = covering(e, n, o);
+        if (!t) return;
+        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.
+    io(e, o) {
+        if (e.n?.[$AFFECTS]?.T?.I || covering(e, o)) GlobalQueue.bt();
+    }
+};
+
+/** `affects()` calls it before a store-targeted declaration (idempotent). */ function installStoreAffects() {
+    installAffectsHooks(hooks);
+}
+
+/** The carrier's last mark released (affects.ts): its scope dies, and the
+ * nodes that inherited the mark release theirs. */ function releaseMarkScope(e) {
+    const o = scopes.get(e);
+    if (o === undefined) return;
+    scopes.delete(e);
+    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 };

package/dist/observe/store/hooks.js

@@ -0,0 +1,16 @@
+// Set before any family is optimistic (`fam.opt`): a call site checks the
+// hooks first, so a build that does not import optimistic.ts folds the arm
+// away.
+let optHooks = null;
+
+function installOptHooks(o) {
+    optHooks = o;
+}
+
+let affectsHooks = null;
+
+function installAffectsHooks(o) {
+    affectsHooks = o;
+}
+
+export { affectsHooks, installAffectsHooks, installOptHooks, optHooks };

package/dist/observe/store/index.js

@@ -0,0 +1,47 @@
+import { createStore as createStore$1, deep as deep$1, snapshot as snapshot$1 } from "./store.js";
+
+export { storeHasFamily, storeHasOptimisticFamily, storeIsShallow } from "./store.js";
+
+export { createOptimisticStore } from "./optimistic.js";
+
+import { createStoreDerived } from "./projection.js";
+
+export { createProjection } from "./projection.js";
+
+import { reconcileState } from "./reconcile.js";
+
+import "../core/verdict.js";
+
+import "../core/core.js";
+
+import "../core/dev.js";
+
+import "../core/scheduler.js";
+
+import "../core/effect.js";
+
+import "../core/lanes.js";
+
+function createStore(e, r, t) {
+    if (typeof e === "function") return createStoreDerived(e, r, t);
+    return createStore$1(e, r);
+}
+
+/**
+ * A setter transform that reconciles `value` into the store by key
+ * (`"id"` by default; `null` positional), preserving store identity for
+ * surviving rows.
+ */ function reconcile(e, r = "id") {
+    return t => reconcileState(e, t, r);
+}
+
+/** Non-tracking snapshot of a store's current value (source identity for
+ * unmodified subtrees). */ function snapshot(e) {
+    return snapshot$1(e);
+}
+
+/** Tracking snapshot: subscribes to every reachable record. */ function deep(e) {
+    return deep$1(e);
+}
+
+export { createStore, deep, reconcile, snapshot };