@skirbi/sugar 0.0.20 → 0.0.21

package/Changes

@@ -1,5 +1,20 @@
 Revision history for @skirbi/sugar
 
+0.0.21       2026-05-10 02:05:46Z
+
+  * Add `$()` and `$$()` selector helpers to HTMLElementSugar.
+    Components were increasingly using repetitive
+    `querySelector()` and `querySelectorAll()` calls, especially in
+    templated custom elements.
+
+    The new helpers provide small ergonomic wrappers:
+
+      * `$()` returns the first matching descendant
+      * `$$()` returns all matching descendants as an array
+
+    This keeps component render logic significantly cleaner while
+    remaining fully standards-based internally.
+
 0.0.20       2026-04-24 18:34:26Z
 
   * And do not disable it

package/lib/htmlelement.mjs

@@ -343,5 +343,19 @@ export class HTMLElementSugar extends HTMLElement {
   assertQuerySelector(haystack, needle, msg) {
     return this.constructor.assertQuerySelector(haystack, needle, msg);
   }
+
+  /**
+   * Query inside current component root.
+   */
+  $(selector) {
+    return this.querySelector(selector)
+  }
+
+  /**
+   * Query all inside current component root.
+   */
+  $$(selector) {
+    return [...this.querySelectorAll(selector)]
+  }
 }
 

package/lib/index.mjs

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

package/package.json

@@ -52,5 +52,5 @@
   },
   "sideEffects": false,
   "type": "module",
-  "version": "0.0.20"
+  "version": "0.0.21"
 }