nodality 1.0.191 → 1.0.193

package/lib/raster-ops.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.191
+ * nodality v1.0.193
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */
@@ -181,7 +181,11 @@ const REGISTRY = {
     // inject divergence energy the field stays stable with no pressure
     // projection at all — the whole simulation is a single pass.
     //
-    //   { op: "stir", strength: 26, swirl: 2.4, decay: 0.985 }
+    //   { op: "stir", strength: 26, curl: 2.4, decay: 0.985 }
+    //
+    // The swirliness knob is `curl` (vorticity confinement). An earlier
+    // version of this line said `swirl`, which the solver never reads — it
+    // is accepted silently and leaves curl at its default.
     // Halftone: the print dot screen. Tone is carried by dot AREA on a
     // rotated grid rather than by intensity, the way offset lithography
     // reproduces a continuous-tone image with a single ink.
@@ -1407,7 +1411,41 @@ function freezeViewportUnits(original, clone) {
     return clone;
 }
 
+/**
+ * The single <img> a host renders, if that is all it is.
+ *
+ * A foreignObject rendered from a data: URI never fetches subresources, so
+ * any <img> inside the serialized subtree comes back blank — a photo host
+ * would capture as fully transparent. When the host is just an image we can
+ * skip serialization entirely and upload that image as the texture, which
+ * is both correct and considerably cheaper.
+ *
+ * Only same-origin, already-decoded images qualify: a cross-origin one
+ * would taint the canvas and break the readback the pipeline depends on.
+ */
+function soleImageOf(el) {
+    if (!el) return null;
+    const img = el.tagName === "IMG"
+        ? el
+        : (el.children && el.children.length === 1 && el.children[0].tagName === "IMG"
+            ? el.children[0]
+            : null);
+    if (!img || !img.complete || !img.naturalWidth) return null;
+    try {
+        // Relative and same-origin absolute srcs both resolve clean here.
+        if (new URL(img.currentSrc || img.src, location.href).origin !== location.origin) {
+            return null;
+        }
+    } catch (e) {
+        return null;
+    }
+    return img;
+}
+
 function snapshotToImage(el, w, h, dpr) {
+    const direct = soleImageOf(el);
+    if (direct) return Promise.resolve(direct);
+
     return new Promise((resolve, reject) => {
         const serialized = new XMLSerializer()
             .serializeToString(freezeViewportUnits(el, el.cloneNode(true)));
@@ -2279,8 +2317,29 @@ function applyRasterPipeline(el, rasterNodes) {
         snapshotCapture();
     };
 
+    // Match the canvas box to the host immediately, without recapturing.
+    // Re-uploading the texture is the expensive half and stays debounced;
+    // resizing the element is cheap and must not be, because a host that is
+    // being animated (a scroll-driven hero expanding every frame) would
+    // otherwise render up to a debounce-interval behind its own layout —
+    // the canvas visibly trailing the content it is drawn over.
+    const syncCanvasBox = () => {
+        if (destroyed) return;
+        const m = measure();
+        if (m.width < 2 || m.height < 2) return;
+        if (Math.round(m.width) === Math.round(rect.width) &&
+            Math.round(m.height) === Math.round(rect.height)) return;
+        rect.width = m.width;
+        rect.height = m.height;
+        canvas.style.width = m.width + "px";
+        canvas.style.height = m.height + "px";
+        canvas.width = Math.round(m.width * dpr);
+        canvas.height = Math.round(m.height * dpr);
+    };
+
     if (typeof ResizeObserver !== "undefined") {
         ro = new ResizeObserver(() => {
+            syncCanvasBox();
             clearTimeout(resizeTimer);
             resizeTimer = setTimeout(remeasureAndCapture, 150);
         });

package/lib/scroll-video.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.191
+ * nodality v1.0.193
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/seo.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.191
+ * nodality v1.0.193
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/stacker.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.191
+ * nodality v1.0.193
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/theme.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.191
+ * nodality v1.0.193
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/lib/transform-anim.js

@@ -1,5 +1,5 @@
 /*!
- * nodality v1.0.191
+ * nodality v1.0.193
  * (c) 2026 Filip Vabrousek
  * License: MIT
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodality",
-  "version": "1.0.191",
+  "version": "1.0.193",
   "description": "A lightweight library for declarative UI elements.",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",