sibujs 4.0.1 → 4.2.0

package/README.md

@@ -1,6 +1,6 @@
 # SibuJS
 
-A lightweight, function-based frontend framework with fine-grained reactivity, direct DOM rendering, and zero compilation. **No Virtual DOM. No magic.**
+A function-based frontend framework with fine-grained reactivity, direct DOM rendering, and zero compilation. **No Virtual DOM. No magic.**
 
 [NPM](https://www.npmjs.com/package/sibujs) · [License](https://github.com/hexplus/sibujs/blob/main/LICENSE)
 
@@ -147,6 +147,10 @@ The lean core: reactivity, rendering, and components. Everything below imports f
 ### Islands & Progressive Enhancement
 - **`enhance` / `enhanceAll`** — attach fine-grained reactivity to existing server-rendered HTML with no build step (the third rendering mode alongside `mount` and `hydrate`).
 - **`island` / `registerIsland` / `hydrateIslands`** — hydrate isolated interactive regions on demand.
+- **`ctx.each`** — bind many elements the server already rendered (a board, a table, a keyboard) from one descriptor, with no new DOM.
+- **`external`** — reactive integration with state SibuJS does not own: a domain engine, a canvas, an editor, a socket cache. `track()` where you read, `invalidate()` where you mutate.
+
+Guides: [islands & progressive enhancement](docs/islands.md) · [external mutable state and update granularity](docs/architecture/external-state.md) · [running islands inside another framework's page](docs/interop.md). Reference application: [`examples/chess/`](examples/chess/).
 
 ---
 
@@ -196,13 +200,37 @@ Utilities for testing components and reactivity.
 ### `sibujs/cdn` — Script-tag bundle
 Self-registering IIFE build exposing `window.Sibu`, for use without a bundler.
 
+There are two builds. Load **exactly one** — they both define `window.Sibu`, so
+loading both leaves whichever came last in charge.
+
+Development, with every diagnostic live:
+
+```html
+<script src="https://unpkg.com/sibujs@latest/dist/cdn.dev.global.js"></script>
+```
+
+Production, with diagnostics compiled out rather than merely disabled:
+
 ```html
 <script src="https://unpkg.com/sibujs@latest/dist/cdn.global.js"></script>
+```
+
+Either way, the API is on `window.Sibu`:
+
+```html
 <script>
   const { signal, effect, div, mount } = window.Sibu;
 </script>
 ```
 
+Develop against `cdn.dev.global.js` and swap the one line to ship. The runtime
+behaviour is identical; only the warnings differ.
+
+A bundled app needs neither file — import from `"sibujs"` and let your bundler
+define `__SIBU_DEV__` per build (the Vite and webpack plugins in `sibujs/build`
+do this for you). The two CDN files exist because a `<script>` tag has no
+bundler to make that choice.
+
 ---
 
 ## Ecosystem

package/dist/browser.cjs

@@ -60,23 +60,17 @@ __export(browser_exports, {
 module.exports = __toCommonJS(browser_exports);
 
 // src/core/dev.ts
-function isDev() {
-  return typeof globalThis.__SIBU_DEV__ !== "undefined" ? !!globalThis.__SIBU_DEV__ : (
-    // The bare `__SIBU_DEV__` is a bundler define that only exists in
-    // production builds; under the test runner it is always undefined, so
-    // this branch is unreachable here.
-    /* v8 ignore next 2 */
-    typeof __SIBU_DEV__ !== "undefined" ? __SIBU_DEV__ : typeof process !== "undefined" && process.env?.NODE_ENV !== "production"
-  );
-}
-var _isDev = isDev();
+var DEV = typeof __SIBU_DEV__ !== "undefined" ? !!__SIBU_DEV__ : typeof globalThis.__SIBU_DEV__ !== "undefined" ? !!globalThis.__SIBU_DEV__ : (
+  // safe default: off in browser, on in test/dev Node
+  typeof process !== "undefined" && process.env?.NODE_ENV !== "production"
+);
 function devAssert(condition, message) {
-  if (_isDev && !condition) {
+  if ((typeof __SIBU_DEV__ !== "undefined" ? __SIBU_DEV__ : DEV) && !condition) {
     throw new Error(`[SibuJS] ${message}`);
   }
 }
 function devWarn(message) {
-  if (_isDev) {
+  if (typeof __SIBU_DEV__ !== "undefined" ? __SIBU_DEV__ : DEV) {
     console.warn(`[SibuJS] ${message}`);
   }
 }
@@ -387,7 +381,14 @@ function reactiveBinding(commit, ownerNode) {
   subscriber._disposed = false;
   subscriber._errorPhase = "binding";
   subscriber._errorNode = ownerNode;
-  run();
+  try {
+    run();
+  } catch (err) {
+    subscriber._disposed = true;
+    subscriber._errorNode = void 0;
+    cleanup(subscriber);
+    throw err;
+  }
   return subscriber._dispose ?? (subscriber._dispose = () => {
     subscriber._disposed = true;
     subscriber._errorNode = void 0;
@@ -618,17 +619,16 @@ function forEachSubscriber(signal2, visit) {
 }
 
 // src/reactivity/track.ts
-var _isDev2 = isDev();
-var _runtimeVersion = true ? "4.0.1" : "dev";
+var _runtimeVersion = true ? "4.2.0" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g = globalThis;
   const existing = g[REGISTRY_KEY];
   if (existing) {
-    if (_isDev2 && !existing.__dupWarned) {
+    if (DEV && !existing.__dupWarned) {
       existing.__dupWarned = true;
       devWarn(
-        `Multiple instances of the reactive runtime detected on this page (active: ${existing.version}, duplicate: ${_runtimeVersion}). Reactivity still works \u2014 all copies share the first one \u2014 but de-duplicate sibujs in your bundler (e.g. Vite optimizeDeps.exclude: ['sibujs'] or resolve.dedupe: ['sibujs']).`
+        `Multiple instances of the reactive runtime detected on this page (active: ${existing.version}, duplicate: ${_runtimeVersion}). Reactivity is NOT broken and no bundler configuration is required: every copy routes through the first one via a global registry, so signal writes still reach subscribers registered by any copy. This is only a SIZE issue \u2014 the duplicate copy's bytes are downloaded and parsed for nothing. If you want them back, de-duplicate sibujs in your bundler (Vite: resolve.dedupe: ['sibujs']). Mismatched VERSIONS above are worth fixing regardless, since only the first one loaded is used.`
       );
     }
     return existing;
@@ -727,7 +727,6 @@ var isBatching = API2.isBatching;
 
 // src/core/signals/signal.ts
 var _g = globalThis;
-var _isDev3 = isDev();
 function signal(initial, options) {
   const state2 = {
     value: initial,
@@ -740,7 +739,7 @@ function signal(initial, options) {
     _d: false,
     _validate: void 0
   };
-  const debugName = _isDev3 ? options?.name : void 0;
+  const debugName = DEV ? options?.name : void 0;
   const equalsFn = options?.equals;
   if (debugName) state2.__name = debugName;
   function get() {
@@ -757,7 +756,7 @@ function signal(initial, options) {
       if (equalsFn(prev, newValue)) return;
       state2.value = newValue;
       state2.__v++;
-      if (_isDev3) {
+      if (DEV) {
         const hook = _g.__SIBU_DEVTOOLS_GLOBAL_HOOK__;
         if (hook) hook.emit("signal:update", { signal: state2, name: debugName, oldValue: prev, newValue });
       }
@@ -765,7 +764,7 @@ function signal(initial, options) {
         notifySubscribers2(state2);
       }
     };
-  } else if (_isDev3) {
+  } else if (DEV) {
     set = (next) => {
       const prev = state2.value;
       const newValue = typeof next === "function" ? next(prev) : next;
@@ -790,7 +789,7 @@ function signal(initial, options) {
       }
     };
   }
-  if (_isDev3) {
+  if (DEV) {
     const hook = _g.__SIBU_DEVTOOLS_GLOBAL_HOOK__;
     if (hook) hook.emit("signal:create", { signal: state2, name: debugName, getter: get, initial });
   }

package/dist/browser.js

@@ -35,15 +35,15 @@ import {
   visibility,
   wakeLock,
   windowSize
-} from "./chunk-IKVUUE7D.js";
+} from "./chunk-KE4KWRDY.js";
 import "./chunk-H3SRKIYX.js";
 import "./chunk-52XFPGSN.js";
 import "./chunk-7ZHH77QA.js";
-import "./chunk-XDOMTQHM.js";
-import "./chunk-TIRZCERI.js";
-import "./chunk-TVURNWDK.js";
-import "./chunk-JYXQCELN.js";
-import "./chunk-VPP2FONR.js";
+import "./chunk-7VEC3UD2.js";
+import "./chunk-5DXA2J44.js";
+import "./chunk-HECVW343.js";
+import "./chunk-7ALC7KGE.js";
+import "./chunk-2WLZ6757.js";
 export {
   animationFrame,
   battery,