@benqoder/beam 0.4.0 → 0.4.2

package/README.md

@@ -410,7 +410,7 @@ return ctx.drawer(render(<MyDrawer />), { position: 'left', size: 'medium' })
 | `beam-watch-if` | Condition that must be true to trigger | `beam-watch-if="value.length >= 3"` |
 | `beam-cast` | Cast input value: `number`, `integer`, `boolean`, `trim` | `beam-cast="number"` |
 | `beam-loading-class` | Add class to input while request is in progress | `beam-loading-class="loading"` |
-| `beam-keep` | Preserve input focus and cursor position after morph | `beam-keep` |
+| `beam-keep` | Prevent element from being morphed during updates | `beam-keep` |
 
 ### Dirty Form Tracking
 
@@ -783,9 +783,9 @@ Add a class to the input while the request is in progress:
 </style>
 ```
 
-### Preserving Focus
+### Preventing Element Replacement
 
-Use `beam-keep` to preserve focus and cursor position after the response morphs the DOM:
+Use `beam-keep` to prevent an element from being morphed/replaced during updates. This keeps the element exactly as-is, preserving its state (focus, value, etc.):
 
 ```html
 <input
@@ -797,6 +797,8 @@ Use `beam-keep` to preserve focus and cursor position after the response morphs
 />
 ```
 
+Since the input isn't replaced, focus and cursor position are naturally preserved.
+
 ### Auto-Save on Blur
 
 Trigger action when the user leaves the field:

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,OAAO,EAAE,MAAM,SAAS,CAAA;AA8B9D,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAClE,MAAM,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACvF;AAGD,UAAU,UAAU;IAClB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAC7E,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClF;AAQD,KAAK,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;AAq8BzC,iBAAS,UAAU,IAAI,IAAI,CAU1B;AAkCD,iBAAS,WAAW,IAAI,IAAI,CAU3B;AAID,iBAAS,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,SAAS,GAAG,OAAmB,GAAG,IAAI,CAsB/E;AAkrBD,iBAAS,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAUzC;AAmlCD,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAMD,iBAAS,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CA0B9D;AAGD,iBAAS,gBAAgB,IAAI,OAAO,CAEnC;AAED,iBAAS,eAAe,IAAI,OAAO,CAAC,cAAc,CAAC,CAGlD;AAED,QAAA,MAAM,SAAS;;;;;;;;;sBA5rFO,OAAO,CAAC,cAAc,CAAC;CAssF5C,CAAA;AAGD,KAAK,YAAY,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;AAE/G,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,IAAI,EAAE,OAAO,SAAS,GAAG;YACvB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAA;SAC/B,CAAA;KACF;CACF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,KAAK,OAAO,EAAE,MAAM,SAAS,CAAA;AA8B9D,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAClE,MAAM,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACvF;AAGD,UAAU,UAAU;IAClB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAC7E,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClF;AAQD,KAAK,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;AAk8BzC,iBAAS,UAAU,IAAI,IAAI,CAU1B;AAkCD,iBAAS,WAAW,IAAI,IAAI,CAU3B;AAID,iBAAS,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,SAAS,GAAG,OAAmB,GAAG,IAAI,CAsB/E;AAkrBD,iBAAS,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAUzC;AAikCD,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAMD,iBAAS,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CA0B9D;AAGD,iBAAS,gBAAgB,IAAI,OAAO,CAEnC;AAED,iBAAS,eAAe,IAAI,OAAO,CAAC,cAAc,CAAC,CAGlD;AAED,QAAA,MAAM,SAAS;;;;;;;;;sBAvqFO,OAAO,CAAC,cAAc,CAAC;CAirF5C,CAAA;AAGD,KAAK,YAAY,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;AAE/G,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,IAAI,EAAE,OAAO,SAAS,GAAG;YACvB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAA;SAC/B,CAAA;KACF;CACF"}

package/dist/client.js

@@ -174,7 +174,8 @@ function morph(target, html, options) {
     Idiomorph.morph(target, html, {
         morphStyle: 'innerHTML',
         callbacks: {
-            // Skip morphing elements marked with beam-keep
+            // Skip morphing elements marked with beam-keep (preserves their current value)
+            // This only applies when both old and new DOM have a matching element
             beforeNodeMorphed: (fromEl, toEl) => {
                 // Only handle Element nodes
                 if (!(fromEl instanceof Element))
@@ -196,14 +197,10 @@ function morph(target, html, options) {
                     }
                 }
                 return true;
-            },
-            // Prevent removal of beam-keep elements
-            beforeNodeRemoved: (node) => {
-                if (node instanceof Element && node.hasAttribute('beam-keep')) {
-                    return false;
-                }
-                return true;
             }
+            // Note: We intentionally do NOT prevent removal of beam-keep elements.
+            // If an element doesn't exist in the new DOM, it should be removed.
+            // beam-keep only preserves values during morphing, not during removal.
         }
     });
 }
@@ -1840,9 +1837,6 @@ function setupInputWatcher(el) {
                 }
             }
         }
-        // Only restore focus for "input" events, not "change" (blur) events
-        const shouldRestoreFocus = htmlEl.hasAttribute('beam-keep') && eventType === 'input';
-        const activeElement = document.activeElement;
         // Add loading class if specified
         if (loadingClass)
             htmlEl.classList.add(loadingClass);
@@ -1891,19 +1885,6 @@ function setupInputWatcher(el) {
             if (response.script) {
                 executeScript(response.script);
             }
-            // Restore focus if beam-keep is set and this was an input event (not change/blur)
-            if (shouldRestoreFocus && activeElement instanceof HTMLElement) {
-                const newEl = document.querySelector(`[name="${name}"]`);
-                if (newEl && newEl !== activeElement) {
-                    newEl.focus();
-                    if (newEl instanceof HTMLInputElement || newEl instanceof HTMLTextAreaElement) {
-                        const cursorPos = activeElement.selectionStart;
-                        if (cursorPos !== null) {
-                            newEl.setSelectionRange(cursorPos, cursorPos);
-                        }
-                    }
-                }
-            }
         }
         catch (err) {
             console.error('Input watcher error:', err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@benqoder/beam",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "type": "module",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",