@skirbi/sugar 0.0.10 → 0.0.11

package/Changes

@@ -1,5 +1,11 @@
 Revision history for @skirbi/sugar
 
+0.0.11       2026-02-24 16:53:49Z
+
+  * Fix comparing HTML nodes. Whitespace text nodes are a PITA, we deal with
+    them and now you can just compare two nodes regardless how you wrote it.
+    Whitespace kinda matters in HTML I guess, until it doesn't.  
+
 0.0.10       2026-02-24 03:09:34Z
 
   * Improve Livewire/morphdom support in withConnectedSugar
@@ -30,6 +36,28 @@ Revision history for @skirbi/sugar
     Where `your-tag-here` represents the authored child element that
     indicates the component has been reverted to its pre-compiled state.
 
+    The `_compile` function is part of the contract as it authors child
+    elements into the final DOM structure. But you are free give it any name
+    you'd like. An example implementation may look like this:
+
+      _compile() {
+        const steps = Array.from(this.children)
+          .filter(n => n.tagName?.toLowerCase() === 'x-step')
+          .map(n => n.textContent ?? '');
+
+        const frag = this.renderFromTemplate();
+        const ol = frag.querySelector('ol[data-steps]');
+
+        for (const label of steps) {
+          const li = document.createElement('li');
+          li.textContent = label;
+          ol.appendChild(li);
+        }
+
+        this.replaceChildren(frag);
+      }
+    }
+
 0.0.9       2026-02-23 10:56:27Z
 
   * Fix a bug for connectedCallbacks with Livewire

package/lib/index.mjs

@@ -2,7 +2,7 @@
 //
 // SPDX-License-Identifier: MIT
 
-const VERSION = "0.0.10";
+const VERSION = "0.0.11";
 
 export { HTMLElementSugar } from './htmlelement.mjs';
 export { HTMLElementSugarInput } from './htmlelement-input.mjs';

package/lib/testing.mjs

@@ -129,8 +129,29 @@ export async function assertComponentContract(Class, example) {
  */
 function htmlToFragment(html) {
   const tpl = document.createElement('template');
-  tpl.innerHTML = html.trim();
-  return tpl.content;
+  tpl.innerHTML = html.trim().normalize();
+  return stripWhitespaceTextNodes(tpl.content);
+}
+
+/**
+ * Strip whitespace textnodes from an HTML fragment
+ *
+ * Use primairly to sanitize HTML to compare it
+ *
+ * @param {node} node - an HTML node
+ * @returns {node}
+ */
+function stripWhitespaceTextNodes(node) {
+  for (const child of Array.from(node.childNodes)) {
+    if (child.nodeType === 3) { // TEXT_NODE
+      if (!child.nodeValue.trim()) {
+        child.remove();
+      }
+    } else {
+      stripWhitespaceTextNodes(child);
+    }
+  }
+  return node;
 }
 
 /**

package/package.json

@@ -53,5 +53,5 @@
   },
   "sideEffects": false,
   "type": "module",
-  "version": "0.0.10"
+  "version": "0.0.11"
 }