@zakkster/lite-observe 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 1.1.1 -- Late mixed-box joiner reads the last delivered size, not a stale zero
+
+### Fixed
+
+- **A late `observeResize` mixed-box joiner no longer reads 0 until the next
+  resize (B-4).** 1.1.0's lazy box-pair mint was correct for cost but wrong for
+  value: when a second consumer asked for the other box on an element already
+  under observation, its pair was minted fresh at `signal(0)` and nothing wrote
+  it until the element next resized -- on a settled layout, potentially never, so
+  a border-box reader mounted into a stable layout saw a zero-size element with
+  no error and no warning. `drainResize` now parks the last delivered box
+  dimensions on the slot as four primitives (`lastCW`/`lastCH`/`lastBW`/`lastBH`)
+  -- numbers only, no browser object retained, no allocation added to the hot
+  path -- and a lazily minted pair is seeded from them (`=== null ? 0 : x`, so a
+  parked 0 survives and a never-delivered box still reads 0). Before any delivery
+  the parked fields are null and a freshly minted pair reads 0, unchanged. The
+  slot literal births the four fields as `null` for hidden-class stability. No
+  API change; the drain path stays zero-allocation (Phase A `maxMajor=0` holds)
+  and retention stays 0 per cycle.
+
 ## 1.1.0 -- Lazy resize box-pair allocation + pooled-node census docs
 
 ### Changed

package/README.md

@@ -146,7 +146,7 @@ interface ResizeHandle {
 
 Width and height are independent fine-grained signals. N consumers of the same element share one underlying `ResizeObserver.observe()` call; the element is unobserved when the last handle is disposed.
 
-`options.box` selects which box the `width` / `height` signals surface: `'content'` (default) mirrors `entry.contentRect`; `'border'` mirrors `entry.borderBoxSize` (includes padding + border, matching `getBoundingClientRect()`). Mixed-box consumers of the *same* element still share a single underlying observation -- one `ResizeObserver` fires both, and each handle reads the pair it asked for. On legacy runtimes without `borderBoxSize`, a border-box reader sees content-box values until the next layout.
+`options.box` selects which box the `width` / `height` signals surface: `'content'` (default) mirrors `entry.contentRect`; `'border'` mirrors `entry.borderBoxSize` (includes padding + border, matching `getBoundingClientRect()`). Mixed-box consumers of the *same* element still share a single underlying observation -- one `ResizeObserver` fires both, and each handle reads the pair it asked for. A consumer that joins an already-observed element after a delivery has happened is seeded from that element's last delivered size for its box (the slot parks those numbers), so it reads the real size at once rather than a zero that would persist until the next resize; before any delivery has arrived, a freshly minted pair reads 0. On legacy runtimes without `borderBoxSize`, a border-box reader sees content-box values until the next layout.
 
 Pooled signal nodes: 2 while observed (the requested box pair; 4 if both content- and border-box consumers observe the same element). Freed on last dispose.
 

package/llms.txt

@@ -12,7 +12,9 @@ registry: N consumers of the same element share one underlying observer.
   independent signals (Object.is-gated). First emission async. `options.box`
   selects `'content'` (default, contentRect) or `'border'` (borderBoxSize,
   matches getBoundingClientRect). Mixed-box consumers of one element still
-  share a single observation.
+  share a single observation; a late joiner is seeded from the element's
+  last delivered size for its box (0 if nothing has been delivered yet),
+  not a stale zero until the next resize.
   Pooled nodes: 2 while observed (the requested box pair; 4 if both content-
   and border-box consumers observe the same element). Freed on last dispose.
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zakkster/lite-observe",
-    "version": "1.1.0",
+    "version": "1.1.1",
     "author": "Zahary Shinikchiev <shinikchiev@yahoo.com>",
     "description": "Zero-GC reactive bridge for the DOM observer APIs. ResizeObserver, IntersectionObserver, MutationObserver, matchMedia, and Page Visibility collapsed to fine-grained lite-signal signals. Shared registry: N components observing the same element pay one observer cost.",
     "type": "module",

package/src/Resize.js

@@ -12,6 +12,13 @@
  * source. ResizeObserver fires with sub-pixel precision; we forward the raw
  * `contentRect.width` / `contentRect.height` values.
  *
+ * Each slot also parks the last delivered box dimensions as four primitives
+ * (no browser object retained, no allocation on the drain path). A late
+ * mixed-box joiner that mints the other pair after delivery has already
+ * happened reads those last numbers immediately, not a stale zero that would
+ * persist until the element next resizes; before any delivery the parked
+ * fields are null and a freshly minted pair reads 0.
+ *
  * SSR-safe. In a Node environment without `ResizeObserver`, signals are
  * created and stay at zero; observe is a no-op.
  */
@@ -59,6 +66,24 @@ function drainResize() {
         // rect is a field read, not an allocation. Hoisted here because the
         // border fallback reads it too; content-box writes use it directly.
         const rect = entry.contentRect;
+        // Border box: includes padding + border. Per spec the field is an
+        // array (to support multi-column layout); we read the first entry.
+        // Older browsers without borderBoxSize fall back to contentRect; for
+        // zero-alloc cleanliness we just mirror content here when it is absent,
+        // so a legacy-runtime border consumer sees content-box values until the
+        // next layout pass. Resolve both dimensions into locals once (numbers,
+        // not references) so the parking and the guarded write below reuse them.
+        const bbs = entry.borderBoxSize;
+        const bw = (bbs && bbs.length > 0) ? bbs[0].inlineSize : rect.width;
+        const bh = (bbs && bbs.length > 0) ? bbs[0].blockSize : rect.height;
+        // Park the last delivered numbers on the slot unconditionally so a late
+        // mixed-box joiner can seed its lazily-minted pair from the element's
+        // real size instead of a stale zero (B-4). Four primitives: zero
+        // allocation, no browser object retained.
+        slot.lastCW = rect.width;
+        slot.lastCH = rect.height;
+        slot.lastBW = bw;
+        slot.lastBH = bh;
         // Content box: the historical default. Matches the rect a consumer
         // would derive from `getBoundingClientRect` after subtracting
         // padding + border. Written only if a content-box consumer minted it.
@@ -66,24 +91,10 @@ function drainResize() {
             slot.contentWidth.set(rect.width);
             slot.contentHeight.set(rect.height);
         }
-        // Border box: includes padding + border. Per spec the field is an
-        // array (to support multi-column layout); we read the first entry.
-        // Older browsers without borderBoxSize fall back to contentRect
-        // plus the differential measured via getBoundingClientRect at the
-        // next layout. For zero-alloc cleanliness we just mirror content
-        // here when borderBoxSize is absent; consumers who specifically
-        // requested border-box on a legacy runtime will see content-box
-        // values until the next layout pass. Written only if a border-box
-        // consumer minted the pair.
+        // Border box: written only if a border-box consumer minted the pair.
         if (slot.borderWidth !== null) {
-            const bbs = entry.borderBoxSize;
-            if (bbs && bbs.length > 0) {
-                slot.borderWidth.set(bbs[0].inlineSize);
-                slot.borderHeight.set(bbs[0].blockSize);
-            } else {
-                slot.borderWidth.set(rect.width);
-                slot.borderHeight.set(rect.height);
-            }
+            slot.borderWidth.set(bw);
+            slot.borderHeight.set(bh);
         }
     }
 }
@@ -127,7 +138,9 @@ function ensureObserver() {
  * its own dispose. The element stays observed until every handle has been
  * disposed. Consumers requesting different boxes for the same element
  * cooperate transparently: a single ResizeObserver fires both, and each
- * handle surfaces the pair it asked for.
+ * handle surfaces the pair it asked for. A handle that joins an already-
+ * observed element after a delivery is seeded from that element's last
+ * delivered size for its box; before any delivery it reads 0.
  *
  * @param {Element} element
  * @param {ResizeOptions} [options]
@@ -144,6 +157,14 @@ export function observeResize(element, options) {
             contentHeight: null,
             borderWidth: null,
             borderHeight: null,
+            // Last delivered box dimensions, parked as primitives by
+            // drainResize so a late mixed-box joiner seeds its pair from the
+            // element's real size, not a stale zero (B-4). null until the first
+            // delivery; a null-check (not `??`) reads that as 0 at mint time.
+            lastCW: null,
+            lastCH: null,
+            lastBW: null,
+            lastBH: null,
             refCount: 0
         };
         slots.set(element, slot);
@@ -152,11 +173,21 @@ export function observeResize(element, options) {
     }
     // Lazily mint the requested box pair if absent. Placed before refCount++
     // so it also covers a later mixed-box caller joining an existing slot that
-    // only holds the other pair.
+    // only holds the other pair. Seed from the last delivered numbers so a late
+    // joiner reads the element's real size at once, not a stale zero until the
+    // next resize (B-4). Explicit `=== null ? 0 : x` rather than `?? 0`: only
+    // null (never delivered) means "no size yet" and reads 0; any delivered
+    // number, 0 included, passes through untouched. Law: null is not zero.
     if (box === 'border') {
-        if (slot.borderWidth === null) { slot.borderWidth = signal(0); slot.borderHeight = signal(0); }
+        if (slot.borderWidth === null) {
+            slot.borderWidth = signal(slot.lastBW === null ? 0 : slot.lastBW);
+            slot.borderHeight = signal(slot.lastBH === null ? 0 : slot.lastBH);
+        }
     } else {
-        if (slot.contentWidth === null) { slot.contentWidth = signal(0); slot.contentHeight = signal(0); }
+        if (slot.contentWidth === null) {
+            slot.contentWidth = signal(slot.lastCW === null ? 0 : slot.lastCW);
+            slot.contentHeight = signal(slot.lastCH === null ? 0 : slot.lastCH);
+        }
     }
     slot.refCount++;