@graphrefly/graphrefly 0.12.0 → 0.14.0

package/dist/{meta-BcuDhtwu.d.cts → meta-CrZUQAJ6.d.cts}

@@ -148,7 +148,7 @@ declare function accessHintForGuard(guard: NodeGuard): string;
  * |  3   | COMPLETE, ERROR        | Terminal lifecycle | Deferred to after phase-2           |
  * |  4   | TEARDOWN               | Destruction       | Immediate (usually sent alone)      |
  *
- * **Rule:** Within `emitWithBatch`, messages are partitioned by tier and delivered
+ * **Rule:** Within `downWithBatch`, messages are partitioned by tier and delivered
  * in tier order. This ensures phase-2 values (DATA/RESOLVED) reach sinks before
  * terminal signals (COMPLETE/ERROR) mark the node as done, preventing the
  * "COMPLETE-before-DATA" class of bugs. Sources that emit in canonical order

package/dist/{meta-BcuDhtwu.d.ts → meta-CrZUQAJ6.d.ts}

@@ -148,7 +148,7 @@ declare function accessHintForGuard(guard: NodeGuard): string;
  * |  3   | COMPLETE, ERROR        | Terminal lifecycle | Deferred to after phase-2           |
  * |  4   | TEARDOWN               | Destruction       | Immediate (usually sent alone)      |
  *
- * **Rule:** Within `emitWithBatch`, messages are partitioned by tier and delivered
+ * **Rule:** Within `downWithBatch`, messages are partitioned by tier and delivered
  * in tier order. This ensures phase-2 values (DATA/RESOLVED) reach sinks before
  * terminal signals (COMPLETE/ERROR) mark the node as done, preventing the
  * "COMPLETE-before-DATA" class of bugs. Sources that emit in canonical order

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

@@ -368,12 +368,12 @@ function partitionForBatch(messages) {
   }
   return { immediate, deferred, terminal };
 }
-function emitWithBatch(emit, messages, phase = 2, options) {
+function downWithBatch(sink, messages, phase = 2, options) {
   if (messages.length === 0) {
     return;
   }
   if (options?.strategy === "sequential") {
-    _emitSequential(emit, messages, phase);
+    _downSequential(sink, messages, phase);
     return;
   }
   const queue = phase === 3 ? pendingPhase3 : pendingPhase2;
@@ -381,61 +381,61 @@ function emitWithBatch(emit, messages, phase = 2, options) {
     const t = messages[0][0];
     if (t === DATA || t === RESOLVED) {
       if (isBatching()) {
-        queue.push(() => emit(messages));
+        queue.push(() => sink(messages));
       } else {
-        emit(messages);
+        sink(messages);
       }
     } else if (isTerminalMessage(t)) {
       if (isBatching()) {
-        queue.push(() => emit(messages));
+        queue.push(() => sink(messages));
       } else {
-        emit(messages);
+        sink(messages);
       }
     } else {
-      emit(messages);
+      sink(messages);
     }
     return;
   }
   const { immediate, deferred, terminal } = partitionForBatch(messages);
   if (immediate.length > 0) {
-    emit(immediate);
+    sink(immediate);
   }
   if (isBatching()) {
     if (deferred.length > 0) {
-      queue.push(() => emit(deferred));
+      queue.push(() => sink(deferred));
     }
     if (terminal.length > 0) {
-      queue.push(() => emit(terminal));
+      queue.push(() => sink(terminal));
     }
   } else {
     if (deferred.length > 0) {
-      emit(deferred);
+      sink(deferred);
     }
     if (terminal.length > 0) {
-      emit(terminal);
+      sink(terminal);
     }
   }
 }
-function _emitSequential(emit, messages, phase = 2) {
+function _downSequential(sink, messages, phase = 2) {
   const dataQueue = phase === 3 ? pendingPhase3 : pendingPhase2;
   for (const msg of messages) {
     const tier = messageTier(msg[0]);
     if (tier === 2) {
       if (isBatching()) {
         const m = msg;
-        dataQueue.push(() => emit([m]));
+        dataQueue.push(() => sink([m]));
       } else {
-        emit([msg]);
+        sink([msg]);
       }
     } else if (tier >= 3) {
       if (isBatching()) {
         const m = msg;
-        pendingPhase3.push(() => emit([m]));
+        pendingPhase3.push(() => sink([m]));
       } else {
-        emit([msg]);
+        sink([msg]);
       }
     } else {
-      emit([msg]);
+      sink([msg]);
     }
   }
 }
@@ -663,7 +663,7 @@ var NodeImpl = class {
   _singleDepSinks = /* @__PURE__ */ new WeakSet();
   _upstreamUnsubs = [];
   _actions;
-  _boundEmitToSinks;
+  _boundDownToSinks;
   _inspectorHook;
   _versioning;
   _hashFn;
@@ -710,7 +710,7 @@ var NodeImpl = class {
       },
       emit(value) {
         self._manualEmitUsed = true;
-        self._emitAutoValue(value);
+        self._downAutoValue(value);
       },
       up(messages) {
         self._upInternal(messages);
@@ -718,7 +718,7 @@ var NodeImpl = class {
     };
     this.down = this.down.bind(this);
     this.up = this.up.bind(this);
-    this._boundEmitToSinks = this._emitToSinks.bind(this);
+    this._boundDownToSinks = this._downToSinks.bind(this);
   }
   get name() {
     return this._registryName ?? this._optsName;
@@ -824,12 +824,12 @@ var NodeImpl = class {
           if (sinkMessages[i][0] !== DIRTY) filtered.push(sinkMessages[i]);
         }
         if (filtered.length > 0) {
-          emitWithBatch(this._boundEmitToSinks, filtered);
+          downWithBatch(this._boundDownToSinks, filtered);
         }
         return;
       }
     }
-    emitWithBatch(this._boundEmitToSinks, sinkMessages);
+    downWithBatch(this._boundDownToSinks, sinkMessages);
   }
   subscribe(sink, hints) {
     if (hints?.actor != null && this._guard != null) {
@@ -916,7 +916,7 @@ var NodeImpl = class {
     this._disconnectUpstream();
   }
   // --- Private methods (prototype, _ prefix) ---
-  _emitToSinks(messages) {
+  _downToSinks(messages) {
     if (this._sinks == null) return;
     if (typeof this._sinks === "function") {
       this._sinks(messages);
@@ -931,6 +931,9 @@ var NodeImpl = class {
     for (const m of messages) {
       const t = m[0];
       if (t === DATA) {
+        if (m.length < 2) {
+          continue;
+        }
         this._cached = m[1];
         if (this._versioning != null) {
           advanceVersion(this._versioning, m[1], this._hashFn);
@@ -978,7 +981,7 @@ var NodeImpl = class {
   _canSkipDirty() {
     return this._sinkCount === 1 && this._singleDepSinkCount === 1;
   }
-  _emitAutoValue(value) {
+  _downAutoValue(value) {
     const wasDirty = this._status === "dirty";
     let unchanged;
     try {
@@ -1031,7 +1034,7 @@ var NodeImpl = class {
         this._cleanup = out.cleanup;
         if (this._manualEmitUsed) return;
         if ("value" in out) {
-          this._emitAutoValue(out.value);
+          this._downAutoValue(out.value);
         }
         return;
       }
@@ -1041,7 +1044,7 @@ var NodeImpl = class {
       }
       if (this._manualEmitUsed) return;
       if (out === void 0) return;
-      this._emitAutoValue(out);
+      this._downAutoValue(out);
     } catch (err) {
       const errMsg = err instanceof Error ? err.message : String(err);
       const wrapped = new Error(`Node "${this.name}": fn threw: ${errMsg}`, { cause: err });
@@ -1223,7 +1226,7 @@ var DynamicNodeImpl = class {
   _singleDepSinks = /* @__PURE__ */ new WeakSet();
   // Actions object (for onMessage handler)
   _actions;
-  _boundEmitToSinks;
+  _boundDownToSinks;
   // Mutable state
   _cached = NO_VALUE;
   _status = "disconnected";
@@ -1270,7 +1273,7 @@ var DynamicNodeImpl = class {
         self._downInternal(messages);
       },
       emit(value) {
-        self._emitAutoValue(value);
+        self._downAutoValue(value);
       },
       up(messages) {
         for (const dep of self._deps) {
@@ -1278,7 +1281,7 @@ var DynamicNodeImpl = class {
         }
       }
     };
-    this._boundEmitToSinks = this._emitToSinks.bind(this);
+    this._boundDownToSinks = this._downToSinks.bind(this);
   }
   get name() {
     return this._registryName ?? this._optsName;
@@ -1358,12 +1361,12 @@ var DynamicNodeImpl = class {
           if (sinkMessages[i][0] !== DIRTY) filtered.push(sinkMessages[i]);
         }
         if (filtered.length > 0) {
-          emitWithBatch(this._boundEmitToSinks, filtered);
+          downWithBatch(this._boundDownToSinks, filtered);
         }
         return;
       }
     }
-    emitWithBatch(this._boundEmitToSinks, sinkMessages);
+    downWithBatch(this._boundDownToSinks, sinkMessages);
   }
   _canSkipDirty() {
     return this._sinkCount === 1 && this._singleDepSinkCount === 1;
@@ -1439,7 +1442,7 @@ var DynamicNodeImpl = class {
     this._disconnect();
   }
   // --- Private methods ---
-  _emitToSinks(messages) {
+  _downToSinks(messages) {
     if (this._sinks == null) return;
     if (typeof this._sinks === "function") {
       this._sinks(messages);
@@ -1493,7 +1496,7 @@ var DynamicNodeImpl = class {
       }
     }
   }
-  _emitAutoValue(value) {
+  _downAutoValue(value) {
     const wasDirty = this._status === "dirty";
     let unchanged;
     try {
@@ -1553,7 +1556,7 @@ var DynamicNodeImpl = class {
       const result = this._fn(get);
       this._rewire(trackedDeps);
       if (result === void 0) return;
-      this._emitAutoValue(result);
+      this._downAutoValue(result);
     } catch (err) {
       this._downInternal([[ERROR, err]]);
     }
@@ -1617,14 +1620,14 @@ var DynamicNodeImpl = class {
         this._dirtyBits.add(index);
         this._settledBits.delete(index);
         if (this._dirtyBits.size === 1) {
-          emitWithBatch(this._boundEmitToSinks, [[DIRTY]]);
+          downWithBatch(this._boundDownToSinks, [[DIRTY]]);
         }
         continue;
       }
       if (t === DATA || t === RESOLVED) {
         if (!this._dirtyBits.has(index)) {
           this._dirtyBits.add(index);
-          emitWithBatch(this._boundEmitToSinks, [[DIRTY]]);
+          downWithBatch(this._boundDownToSinks, [[DIRTY]]);
         }
         this._settledBits.add(index);
         if (this._allDirtySettled()) {
@@ -3803,7 +3806,7 @@ function computeLineBreaks(segments, maxWidth, adapter, font, cache) {
     hyphenWidth = adapter.measureSegment("-", font).width;
     fontCache.set("-", hyphenWidth);
   }
-  function emitLine(endSeg = lineEndSeg, endGrapheme = lineEndGrapheme, width = lineW) {
+  function flushLine(endSeg = lineEndSeg, endGrapheme = lineEndGrapheme, width = lineW) {
     let text = "";
     for (let i = lineStartSeg; i < endSeg; i++) {
       const seg = segments[i];
@@ -3866,7 +3869,7 @@ function computeLineBreaks(segments, maxWidth, adapter, font, cache) {
     const seg = segments[i];
     if (seg.kind === "hard-break") {
       if (hasContent) {
-        emitLine();
+        flushLine();
       } else {
         lines.push({
           text: "",
@@ -3900,20 +3903,20 @@ function computeLineBreaks(segments, maxWidth, adapter, font, cache) {
         lineW += w;
         lineEndSeg = i + 1;
         lineEndGrapheme = 0;
-        emitLine(i + 1, 0, seg.kind === "space" ? lineW - w : lineW);
+        flushLine(i + 1, 0, seg.kind === "space" ? lineW - w : lineW);
         continue;
       }
       if (pendingBreakSeg >= 0) {
-        emitLine(pendingBreakSeg, 0, pendingBreakWidth);
+        flushLine(pendingBreakSeg, 0, pendingBreakWidth);
         i--;
         continue;
       }
       if (w > maxWidth && seg.graphemeWidths) {
-        emitLine();
+        flushLine();
         appendBreakableSegment(i, 0, seg.graphemeWidths);
         continue;
       }
-      emitLine();
+      flushLine();
       i--;
       continue;
     }
@@ -3926,7 +3929,7 @@ function computeLineBreaks(segments, maxWidth, adapter, font, cache) {
     }
   }
   if (hasContent) {
-    emitLine();
+    flushLine();
   }
   return { lines, lineCount: lines.length };
   function appendBreakableSegment(segIdx, startG, gWidths) {
@@ -3937,7 +3940,7 @@ function computeLineBreaks(segments, maxWidth, adapter, font, cache) {
         continue;
       }
       if (lineW + gw > maxWidth + 5e-3) {
-        emitLine();
+        flushLine();
         startLineAtGrapheme(segIdx, g, gw);
       } else {
         lineW += gw;
@@ -4028,9 +4031,9 @@ function reactiveLayout(opts) {
         const hr = hitRate;
         const len = result.length;
         const el = elapsed;
-        emitWithBatch((msgs) => meta["cache-hit-rate"]?.down(msgs), [[DATA, hr]], 3);
-        emitWithBatch((msgs) => meta["segment-count"]?.down(msgs), [[DATA, len]], 3);
-        emitWithBatch((msgs) => meta["layout-time-ns"]?.down(msgs), [[DATA, el]], 3);
+        downWithBatch((msgs) => meta["cache-hit-rate"]?.down(msgs), [[DATA, hr]], 3);
+        downWithBatch((msgs) => meta["segment-count"]?.down(msgs), [[DATA, len]], 3);
+        downWithBatch((msgs) => meta["layout-time-ns"]?.down(msgs), [[DATA, el]], 3);
       }
       return result;
     },
@@ -4260,8 +4263,8 @@ function reactiveBlockLayout(opts) {
       const elapsed = monotonicNs() - t0;
       const meta = measuredBlocksNode.meta;
       if (meta) {
-        emitWithBatch((msgs) => meta["block-count"]?.down(msgs), [[DATA, result.length]], 3);
-        emitWithBatch((msgs) => meta["layout-time-ns"]?.down(msgs), [[DATA, elapsed]], 3);
+        downWithBatch((msgs) => meta["block-count"]?.down(msgs), [[DATA, result.length]], 3);
+        downWithBatch((msgs) => meta["layout-time-ns"]?.down(msgs), [[DATA, elapsed]], 3);
       }
       return result;
     },