bimba-cli 0.5.0 → 0.5.1

package/README.md

@@ -40,6 +40,18 @@ bunx bimba src/index.imba --serve --port 5200 --html public/index.html
 - Injects an importmap built from your `package.json` dependencies
 - Injects an HMR client that swaps component prototypes without a full page reload
 
+**HMR internals:**
+
+When a file changes, the server recompiles it and sends an `update` message over WebSocket. The browser re-imports the module with a fresh `?t=` cache-bust query.
+
+Since Imba custom elements can't be registered twice (`customElements.define` throws on duplicates), bimba intercepts all `define` calls. On first load the class is registered normally and stored in a map. On hot reload, instead of registering again, bimba copies all methods and static properties from the new class onto the original class prototype — so existing element instances in the DOM immediately get the new `render()` and other methods without losing their state (`el.active`, `el.count`, etc.).
+
+After patching, bimba clears each element's Imba render cache (anonymous `Symbol` keys pointing to DOM nodes) and sets `innerHTML = ''`, so the new render method starts from a clean slate. Then `imba.commit()` triggers a re-render of all mounted components.
+
+CSS is handled automatically: Imba's runtime calls `imba_styles.register()` during module execution, which updates the `<style>` tag in place — no extra DOM work needed.
+
+Duplicate root elements (caused by `imba.mount()` running again on re-import) are removed by a dedup pass over `document.body.children` before any other HMR logic runs.
+
 **HTML setup:** add a `data-entrypoint` attribute to the script tag that loads your bundle. The dev server will replace it with your `.imba` entrypoint and inject the importmap above it:
 
 ```html
@@ -54,10 +66,6 @@ bunx bimba src/index.imba --serve --port 5200 --html public/index.html
 
 `--html <path>` — path to your HTML file (auto-detected from `./index.html`, `./public/index.html`, `./src/index.html` if omitted)
 
-`--hmr-mode <css|full>` — HMR mode (default: `css`)
-  - `css` — CSS-only hot reload (injects styles instantly, full reload on JS changes)
-  - `full` — full HMR with element swapping (prototype replacement, no page reload)
-
 Static files are resolved relative to the HTML file's directory first, then from the project root (for `node_modules`, `src`, etc.).
 
 ---
@@ -95,7 +103,3 @@ bunx bimba src/index.imba --outdir public/js --watch --clearcache
 `--port <number>` — port for the dev server (default: `5200`). Used with `--serve`.
 
 `--html <path>` — custom HTML file path. Used with `--serve`.
-
-`--hmr-mode <css|full>` — HMR mode for dev server (default: `css`)
-  - `css` — CSS-only hot reload (injects styles instantly without reload, triggers full reload only when JS changes)
-  - `full` — full HMR with element swapping (swaps component prototypes, no page reload at all)

package/index.js

@@ -27,7 +27,6 @@ try {
             serve: { type: 'boolean' },
             port: { type: 'string' },
             html: { type: 'string' },
-            hmrmode: { type: 'string' },
         },
         strict: true,
         allowPositionals: true,
@@ -55,14 +54,6 @@ if (!fs.existsSync(bunfigPath)) {
     }
 }
 
-// Validate hmr-mode flag
-if (flags.hmrmode && !['css', 'full'].includes(flags.hmrmode)) {
-    console.log("");
-    console.log(theme.failure("Invalid value for --hmr-mode. Use 'css' (default) or 'full'."));
-    console.log("");
-    process.exit(0);
-}
-
 // help: more on bun building params here: https://bun.sh/docs/bundler
 if(flags.help) {
     console.log("");
@@ -80,7 +71,6 @@ if(flags.help) {
     console.log("   "+theme.flags('--serve')+"                               Start dev server with Hot Module Replacement");
     console.log("   "+theme.flags('--port <number>')+"                       Port for the dev server (default: 5200)");
     console.log("   "+theme.flags('--html <path>')+"                         Custom HTML file path (auto-detected if omitted)");
-    console.log("   "+theme.flags('--hmr-mode <css|full>')+"                 HMR mode: 'css' = CSS-only reload (default), 'full' = element swap");
     console.log("");
     process.exit(0);
 }
@@ -96,7 +86,7 @@ if (flags.serve) {
         console.log("");
         process.exit(1);
     }
-    serve(entrypoint, { port: parseInt(flags.port) || 5200, html: flags.html, hmrMode: flags.hmrmode || 'css' });
+    serve(entrypoint, { port: parseInt(flags.port) || 5200, html: flags.html });
 }
 // no entrypoint or outdir
 else if(!entrypoint || !flags.outdir) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bimba-cli",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/HeapVoid/bimba.git"