create-volt 0.26.0 → 0.27.0

package/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to `create-volt` are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/), and this project adheres to
 [Semantic Versioning](https://semver.org/).
 
+## [0.27.0] - 2026-06-29
+
+### Fixed
+- **Reactive crash on conditional re-render** (`volt.js`) — a signal write
+  notified a *snapshot* of subscribers, so a parent reactive block that disposed
+  a nested one mid-update would still run the stale nested effect on detached DOM
+  ("Cannot read properties of null (reading 'insertBefore')"). Disposed effects
+  now skip their queued run, and `renderRange` guards against a detached range.
+  Fixes the **setup wizard** crashing when toggling add-ons or changing the DB
+  driver. Regression-tested in the headless-browser suite.
+
 ## [0.26.0] - 2026-06-29
 
 ### Added
@@ -370,6 +381,7 @@ All notable changes to `create-volt` are documented here. The format follows
   watching and full-page hot reload. Supports `--skip-install` and `--force`,
   and auto-detects npm / pnpm / yarn / bun for the install step.
 
+[0.27.0]: https://github.com/MIR-2025/volt/releases/tag/v0.27.0
 [0.26.0]: https://github.com/MIR-2025/volt/releases/tag/v0.26.0
 [0.25.0]: https://github.com/MIR-2025/volt/releases/tag/v0.25.0
 [0.24.0]: https://github.com/MIR-2025/volt/releases/tag/v0.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-volt",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "Scaffold a new Volt app — no-build, signals-based UI with Socket.io hot reload.",
   "type": "module",
   "bin": {

package/templates/default/public/volt.js

@@ -47,7 +47,11 @@ export function effect(fn) {
     deps: new Set(),
     children: new Set(),
     parent: activeEffect,
+    disposed: false,
     run() {
+      // A signal write notifies a *snapshot* of subscribers; a parent re-render
+      // can dispose this effect before its turn in that snapshot — so skip if so.
+      if (eff.disposed) return;
       disposeChildren(eff);
       cleanupDeps(eff);
       const prev = activeEffect;
@@ -59,6 +63,7 @@ export function effect(fn) {
       }
     },
     dispose() {
+      eff.disposed = true;
       disposeChildren(eff);
       cleanupDeps(eff);
       if (eff.parent) eff.parent.children.delete(eff);
@@ -152,6 +157,7 @@ function appendChild(parent, child) {
 
 // Replace everything between the start/end anchors with `value`'s nodes.
 function renderRange(start, end, value) {
+  if (!end.parentNode) return; // range detached (parent re-rendered) — nothing to do
   let n = start.nextSibling;
   while (n && n !== end) {
     const t = n.nextSibling;

package/templates/guestbook/public/volt.js

@@ -47,7 +47,11 @@ export function effect(fn) {
     deps: new Set(),
     children: new Set(),
     parent: activeEffect,
+    disposed: false,
     run() {
+      // A signal write notifies a *snapshot* of subscribers; a parent re-render
+      // can dispose this effect before its turn in that snapshot — so skip if so.
+      if (eff.disposed) return;
       disposeChildren(eff);
       cleanupDeps(eff);
       const prev = activeEffect;
@@ -59,6 +63,7 @@ export function effect(fn) {
       }
     },
     dispose() {
+      eff.disposed = true;
       disposeChildren(eff);
       cleanupDeps(eff);
       if (eff.parent) eff.parent.children.delete(eff);
@@ -152,6 +157,7 @@ function appendChild(parent, child) {
 
 // Replace everything between the start/end anchors with `value`'s nodes.
 function renderRange(start, end, value) {
+  if (!end.parentNode) return; // range detached (parent re-rendered) — nothing to do
   let n = start.nextSibling;
   while (n && n !== end) {
     const t = n.nextSibling;

package/templates/starter/public/volt.js

@@ -47,7 +47,11 @@ export function effect(fn) {
     deps: new Set(),
     children: new Set(),
     parent: activeEffect,
+    disposed: false,
     run() {
+      // A signal write notifies a *snapshot* of subscribers; a parent re-render
+      // can dispose this effect before its turn in that snapshot — so skip if so.
+      if (eff.disposed) return;
       disposeChildren(eff);
       cleanupDeps(eff);
       const prev = activeEffect;
@@ -59,6 +63,7 @@ export function effect(fn) {
       }
     },
     dispose() {
+      eff.disposed = true;
       disposeChildren(eff);
       cleanupDeps(eff);
       if (eff.parent) eff.parent.children.delete(eff);
@@ -152,6 +157,7 @@ function appendChild(parent, child) {
 
 // Replace everything between the start/end anchors with `value`'s nodes.
 function renderRange(start, end, value) {
+  if (!end.parentNode) return; // range detached (parent re-rendered) — nothing to do
   let n = start.nextSibling;
   while (n && n !== end) {
     const t = n.nextSibling;