@graphrefly/graphrefly 0.7.0 → 0.9.0

package/dist/patterns/reactive-layout/index.cjs

@@ -547,6 +547,7 @@ function advanceVersion(info, newValue, hashFn) {
 }
 
 // src/core/node.ts
+var NO_VALUE = /* @__PURE__ */ Symbol.for("graphrefly/NO_VALUE");
 function createIntBitSet() {
   let bits = 0;
   return {
@@ -647,7 +648,6 @@ var NodeImpl = class {
   _producerStarted = false;
   _connecting = false;
   _manualEmitUsed = false;
-  _hasEmittedData = false;
   _sinkCount = 0;
   _singleDepSinkCount = 0;
   // --- Object/collection state ---
@@ -677,10 +677,10 @@ var NodeImpl = class {
     this._hasDeps = deps.length > 0;
     this._autoComplete = opts.completeWhenDepsComplete ?? true;
     this._isSingleDep = deps.length === 1 && fn != null;
-    this._cached = opts.initial;
+    this._cached = "initial" in opts ? opts.initial : NO_VALUE;
     this._status = this._hasDeps ? "disconnected" : "settled";
     this._hashFn = opts.versioningHash ?? defaultHash;
-    this._versioning = opts.versioning != null ? createVersioning(opts.versioning, this._cached, {
+    this._versioning = opts.versioning != null ? createVersioning(opts.versioning, this._cached === NO_VALUE ? void 0 : this._cached, {
       id: opts.versioningId,
       hash: this._hashFn
     }) : void 0;
@@ -764,10 +764,14 @@ var NodeImpl = class {
   _applyVersioning(level, opts) {
     if (this._versioning != null) return;
     this._hashFn = opts?.hash ?? this._hashFn;
-    this._versioning = createVersioning(level, this._cached, {
-      id: opts?.id,
-      hash: this._hashFn
-    });
+    this._versioning = createVersioning(
+      level,
+      this._cached === NO_VALUE ? void 0 : this._cached,
+      {
+        id: opts?.id,
+        hash: this._hashFn
+      }
+    );
   }
   hasGuard() {
     return this._guard != null;
@@ -777,7 +781,7 @@ var NodeImpl = class {
     return this._guard(normalizeActor(actor), "observe");
   }
   get() {
-    return this._cached;
+    return this._cached === NO_VALUE ? void 0 : this._cached;
   }
   down(messages, options) {
     if (messages.length === 0) return;
@@ -834,6 +838,7 @@ var NodeImpl = class {
     }
     if (this._terminal && this._opts.resubscribable) {
       this._terminal = false;
+      this._cached = NO_VALUE;
       this._status = this._hasDeps ? "disconnected" : "settled";
       this._opts.onResubscribe?.();
     }
@@ -933,8 +938,7 @@ var NodeImpl = class {
         const cleanupFn = this._cleanup;
         this._cleanup = void 0;
         cleanupFn?.();
-        this._cached = void 0;
-        this._hasEmittedData = false;
+        this._cached = NO_VALUE;
         this._lastDepValues = void 0;
       }
       this._status = statusAfterMessage(this._status, m);
@@ -943,8 +947,7 @@ var NodeImpl = class {
       }
       if (t === TEARDOWN) {
         if (this._opts.resetOnTeardown) {
-          this._cached = void 0;
-          this._hasEmittedData = false;
+          this._cached = NO_VALUE;
         }
         const teardownCleanup = this._cleanup;
         this._cleanup = void 0;
@@ -977,14 +980,13 @@ var NodeImpl = class {
     const wasDirty = this._status === "dirty";
     let unchanged;
     try {
-      unchanged = this._hasEmittedData && this._equals(this._cached, value);
+      unchanged = this._cached !== NO_VALUE && this._equals(this._cached, value);
     } catch (eqErr) {
       const eqMsg = eqErr instanceof Error ? eqErr.message : String(eqErr);
       const wrapped = new Error(`Node "${this.name}": equals threw: ${eqMsg}`, { cause: eqErr });
       this._downInternal([[ERROR, wrapped]]);
       return;
     }
-    this._hasEmittedData = true;
     if (unchanged) {
       this._downInternal(wasDirty ? [[RESOLVED]] : [[DIRTY], [RESOLVED]]);
       return;
@@ -1213,7 +1215,7 @@ var DynamicNodeImpl = class {
   _actions;
   _boundEmitToSinks;
   // Mutable state
-  _cached;
+  _cached = NO_VALUE;
   _status = "disconnected";
   _terminal = false;
   _connected = false;
@@ -1307,7 +1309,7 @@ var DynamicNodeImpl = class {
     return this._guard(normalizeActor(actor), "observe");
   }
   get() {
-    return this._cached;
+    return this._cached === NO_VALUE ? void 0 : this._cached;
   }
   down(messages, options) {
     if (messages.length === 0) return;
@@ -1365,6 +1367,7 @@ var DynamicNodeImpl = class {
     }
     if (this._terminal && this._resubscribable) {
       this._terminal = false;
+      this._cached = NO_VALUE;
       this._status = "disconnected";
       this._onResubscribe?.();
     }
@@ -1442,10 +1445,13 @@ var DynamicNodeImpl = class {
       const t = m[0];
       if (t === DATA) this._cached = m[1];
       if (t === INVALIDATE) {
-        this._cached = void 0;
+        this._cached = NO_VALUE;
+        this._status = "dirty";
       }
-      if (t === DATA || t === RESOLVED) {
+      if (t === DATA) {
         this._status = "settled";
+      } else if (t === RESOLVED) {
+        this._status = "resolved";
       } else if (t === DIRTY) {
         this._status = "dirty";
       } else if (t === COMPLETE) {
@@ -1456,7 +1462,7 @@ var DynamicNodeImpl = class {
         this._terminal = true;
       }
       if (t === TEARDOWN) {
-        if (this._resetOnTeardown) this._cached = void 0;
+        if (this._resetOnTeardown) this._cached = NO_VALUE;
         try {
           this._propagateToMeta(t);
         } finally {
@@ -1479,7 +1485,15 @@ var DynamicNodeImpl = class {
   }
   _emitAutoValue(value) {
     const wasDirty = this._status === "dirty";
-    const unchanged = this._equals(this._cached, value);
+    let unchanged;
+    try {
+      unchanged = this._cached !== NO_VALUE && this._equals(this._cached, value);
+    } catch (eqErr) {
+      const eqMsg = eqErr instanceof Error ? eqErr.message : String(eqErr);
+      const wrapped = new Error(`Node "${this.name}": equals threw: ${eqMsg}`, { cause: eqErr });
+      this._downInternal([[ERROR, wrapped]]);
+      return;
+    }
     if (unchanged) {
       this._downInternal(wasDirty ? [[RESOLVED]] : [[DIRTY], [RESOLVED]]);
       return;
@@ -3299,20 +3313,28 @@ var Graph = class _Graph {
     return g;
   }
   /**
-   * Plain snapshot with **recursively sorted object keys** for deterministic serialization (§3.8).
+   * Plain snapshot object with **recursively sorted object keys** for deterministic serialization (§3.8).
    *
    * @remarks
-   * ECMAScript `JSON.stringify(graph)` invokes this method; it must return a plain object, not an
-   * already-stringified JSON string (otherwise the graph would be double-encoded).
    * For a single UTF-8 string with a trailing newline (convenient for git), use {@link Graph.toJSONString}.
    *
    * @returns Same object as {@link Graph.snapshot}.
    */
-  toJSON() {
+  toObject() {
     return this.snapshot();
   }
   /**
-   * Deterministic JSON **text**: `JSON.stringify` of {@link Graph.toJSON} plus a trailing newline (§3.8).
+   * ECMAScript `JSON.stringify` hook — delegates to {@link Graph.toObject}.
+   *
+   * @remarks
+   * Must return a plain object (not a string) so `JSON.stringify(graph)` works correctly
+   * without double-encoding.
+   */
+  toJSON() {
+    return this.toObject();
+  }
+  /**
+   * Deterministic JSON **text**: `JSON.stringify` of {@link Graph.toObject} plus a trailing newline (§3.8).
    *
    * @returns Stable string suitable for diffs.
    */