balises 0.7.2 → 0.8.0

package/README.md

@@ -4,7 +4,7 @@
   <img alt="balises" src="./assets/logo.svg" width="280">
 </picture>
 
-### A minimal reactive HTML templating library for building websites and web components. ~2.8KB gzipped.
+### A minimal reactive HTML templating library for building websites and web components. ~3.2KB gzipped.
 
 Balises gives you reactive signals and HTML templates without the framework overhead. Works great with custom elements, vanilla JavaScript projects, or anywhere you need dynamic UIs but don't want to pull in React.
 
@@ -523,6 +523,34 @@ count.value = 1; // logs "count changed to 1"
 unsubscribe(); // Stop listening
 ```
 
+### `.is(value)`
+
+Checks equality with O(1) update performance - ideal for selection patterns.
+
+When you have a signal representing a selected item (like `selectedId`), using `.is()` inside computed/templates creates optimized subscriptions. Only computeds checking the **previous** or **new** value are notified on change, not all of them.
+
+```ts
+import { html, signal } from "balises";
+
+const selected = signal<number | null>(null);
+
+// In a list of 1000 rows, only 2 rows update when selection changes
+// (the previously selected and newly selected)
+function Row({ id, label }) {
+  return html`
+    <tr class=${() => (selected.is(id) ? "danger" : "")}>
+      <td>${id}</td>
+      <td>${label}</td>
+    </tr>
+  `;
+}
+
+selected.value = 5; // Only row 5 gets "danger" class
+selected.value = 10; // Only rows 5 and 10 update
+```
+
+Works on both `Signal` and `Computed`. Uses `Object.is()` for equality checks.
+
 ### `.dispose()`
 
 Stops a computed from tracking dependencies and frees memory.
@@ -537,7 +565,7 @@ doubled.dispose(); // Stops tracking, frees memory
 You can import just what you need to keep bundle size down:
 
 ```ts
-// Full library (~2.8KB gzipped)
+// Full library (~3.2KB gzipped)
 import { html, signal, computed, effect } from "balises";
 
 // Signals only (no HTML templating - use in any JS project)
@@ -689,23 +717,23 @@ Performance comparison of Balises against other popular reactive libraries. Benc
 ┌───────┬───────────────────┬───────┬───────────────┬──────────────────┐
 │ Rank  │ Library           │ Score │ Avg Time (μs) │ vs Fastest       │
 ├───────┼───────────────────┼───────┼───────────────┼──────────────────┤
-│ #1 🏆 │ preact@1.12.1     │ 0.000 │ 64.17         │ 1.00x (baseline) │
+│ #1 🏆 │ preact@1.12.1     │ 0.000 │ 64.00         │ 1.00x (baseline) │
 ├───────┼───────────────────┼───────┼───────────────┼──────────────────┤
-│ #2    │ balises@0.7.0     │ 0.033 │ 85.48         │ 1.33x            │
+│ #2    │ balises@0.7.2     │ 0.022 │ 85.76         │ 1.34x            │
 ├───────┼───────────────────┼───────┼───────────────┼──────────────────┤
-│ #3    │ vue@3.5.26        │ 0.095 │ 94.27         │ 1.47x            │
+│ #3    │ vue@3.5.26        │ 0.080 │ 94.69         │ 1.48x            │
 ├───────┼───────────────────┼───────┼───────────────┼──────────────────┤
-│ #4    │ maverick@6.0.0    │ 0.146 │ 124.89        │ 1.95x            │
+│ #4    │ maverick@6.0.0    │ 0.142 │ 124.28        │ 1.94x            │
 ├───────┼───────────────────┼───────┼───────────────┼──────────────────┤
-│ #5    │ usignal@0.10.0    │ 0.175 │ 133.48        │ 2.08x            │
+│ #5    │ usignal@0.10.0    │ 0.190 │ 135.64        │ 2.12x            │
 ├───────┼───────────────────┼───────┼───────────────┼──────────────────┤
-│ #6    │ angular@19.2.17   │ 0.214 │ 169.86        │ 2.65x            │
+│ #6    │ angular@19.2.17   │ 0.205 │ 163.90        │ 2.56x            │
 ├───────┼───────────────────┼───────┼───────────────┼──────────────────┤
-│ #7    │ solid@1.9.10      │ 0.343 │ 260.01        │ 4.05x            │
+│ #7    │ solid@1.9.10      │ 0.341 │ 269.71        │ 4.21x            │
 ├───────┼───────────────────┼───────┼───────────────┼──────────────────┤
-│ #8    │ mobx@6.15.0       │ 0.854 │ 910.41        │ 14.19x           │
+│ #8    │ mobx@6.15.0       │ 0.846 │ 915.30        │ 14.30x           │
 ├───────┼───────────────────┼───────┼───────────────┼──────────────────┤
-│ #9    │ hyperactiv@0.11.3 │ 1.000 │ 1051.12       │ 16.38x           │
+│ #9    │ hyperactiv@0.11.3 │ 1.000 │ 1067.91       │ 16.69x           │
 └───────┴───────────────────┴───────┴───────────────┴──────────────────┘
 ```
 
@@ -715,19 +743,19 @@ Performance comparison of Balises against other popular reactive libraries. Benc
 ┌───────────────────┬───────────────┬─────────────┬────────────────┬────────────────────┬─────────────┬──────────────┬──────────┐
 │ Library           │ S1: 1: Layers │ S2: 2: Wide │ S3: 3: Diamond │ S4: 4: Conditional │ S5: 5: List │ S6: 6: Batch │ Avg Rank │
 ├───────────────────┼───────────────┼─────────────┼────────────────┼────────────────────┼─────────────┼──────────────┼──────────┤
-│ preact@1.12.1     │ #1 🏆         │ #1 🏆       │ #2             │ #1 🏆              │ #1 🏆       │ #2           │ 1.3      │
+│ preact@1.12.1     │ #1 🏆         │ #2          │ #2             │ #1 🏆              │ #1 🏆       │ #2           │ 1.5      │
 ├───────────────────┼───────────────┼─────────────┼────────────────┼────────────────────┼─────────────┼──────────────┼──────────┤
-│ balises@0.7.0     │ #3            │ #2          │ #1 🏆          │ #2                 │ #2          │ #1 🏆        │ 1.8      │
+│ balises@0.7.2     │ #3            │ #1 🏆       │ #1 🏆          │ #2                 │ #2          │ #1 🏆        │ 1.7      │
 ├───────────────────┼───────────────┼─────────────┼────────────────┼────────────────────┼─────────────┼──────────────┼──────────┤
-│ vue@3.5.26        │ #2            │ #3          │ #5             │ #3                 │ #3          │ #5           │ 3.5      │
+│ vue@3.5.26        │ #2            │ #3          │ #4             │ #3                 │ #3          │ #4           │ 3.2      │
 ├───────────────────┼───────────────┼─────────────┼────────────────┼────────────────────┼─────────────┼──────────────┼──────────┤
-│ maverick@6.0.0    │ #5            │ #5          │ #4             │ #4                 │ #4          │ #4           │ 4.3      │
+│ maverick@6.0.0    │ #5            │ #5          │ #3             │ #4                 │ #4          │ #5           │ 4.3      │
 ├───────────────────┼───────────────┼─────────────┼────────────────┼────────────────────┼─────────────┼──────────────┼──────────┤
-│ usignal@0.10.0    │ #4            │ #4          │ #3             │ #5                 │ #8          │ #6           │ 5.0      │
+│ usignal@0.10.0    │ #4            │ #4          │ #5             │ #5                 │ #8          │ #7           │ 5.5      │
 ├───────────────────┼───────────────┼─────────────┼────────────────┼────────────────────┼─────────────┼──────────────┼──────────┤
 │ angular@19.2.17   │ #6            │ #6          │ #6             │ #6                 │ #5          │ #3           │ 5.3      │
 ├───────────────────┼───────────────┼─────────────┼────────────────┼────────────────────┼─────────────┼──────────────┼──────────┤
-│ solid@1.9.10      │ #7            │ #8          │ #7             │ #7                 │ #7          │ #7           │ 7.2      │
+│ solid@1.9.10      │ #7            │ #8          │ #7             │ #7                 │ #7          │ #6           │ 7.0      │
 ├───────────────────┼───────────────┼─────────────┼────────────────┼────────────────────┼─────────────┼──────────────┼──────────┤
 │ mobx@6.15.0       │ #9            │ #7          │ #8             │ #8                 │ #6          │ #8           │ 7.7      │
 ├───────────────────┼───────────────┼─────────────┼────────────────┼────────────────────┼─────────────┼──────────────┼──────────┤
@@ -750,7 +778,7 @@ Performance comparison of Balises against other popular reactive libraries. Benc
 - These are synthetic benchmarks measuring pure reactivity - real apps should consider the whole picture (ecosystem, docs, community, etc.)
 - Lower rank = better performance
 
-_Last updated: 2026-01-05_
+_Last updated: 2026-01-07_
 
 <!-- BENCHMARK_RESULTS_END -->