@jay-framework/runtime 0.17.3 → 0.17.4

package/dist/index.js

@@ -975,7 +975,10 @@ class HTMLElementRefsImpl extends PrivateRefs {
     return newHTMLElementPublicApiProxy(this);
   }
   exec$(handler) {
-    return [...this.elements][0].exec$(handler);
+    const first = [...this.elements][0];
+    if (!first)
+      return Promise.resolve(void 0);
+    return first.exec$(handler);
   }
 }
 class ComponentRefsImpl extends PrivateRefs {
@@ -1058,6 +1061,8 @@ class HTMLElementRefImpl extends RefImpl {
     return newHTMLElementPublicApiProxy(this);
   }
   exec$(handler) {
+    if (!this.element)
+      return Promise.resolve(void 0);
     return new Promise((resolve, reject) => {
       try {
         resolve(handler(this.element, this.viewState));

package/docs/refs.md

@@ -101,7 +101,9 @@ interface HTMLElementProxy<ViewState, ElementType extends HTMLElement>
 - `addEventListener`: registers a new event handlers.
 - `removeEventListener`: registers a new event handlers.
 - `exec$`: runs a code function against the DOM element. The function must match compiler patterns (see the compiler security section)
-  to be property run in secure applications. In non-secure applications, the function just runs with the DOM element.
+  to be properly run in secure applications. In non-secure applications, the function just runs with the DOM element.
+  **Important:** `exec$` must only be used inside event handlers — never at top-level component creation or in effects,
+  because elements don't exist yet at that point. Top-level `exec$` calls silently resolve to `undefined`.
 
 ## HTMLElementCollectionProxy
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/runtime",
-  "version": "0.17.3",
+  "version": "0.17.4",
   "type": "module",
   "license": "Apache-2.0",
   "main": "dist/index.js",
@@ -23,11 +23,11 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@jay-framework/list-compare": "^0.17.3",
-    "@jay-framework/reactive": "^0.17.3"
+    "@jay-framework/list-compare": "^0.17.4",
+    "@jay-framework/reactive": "^0.17.4"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.17.3",
+    "@jay-framework/dev-environment": "^0.17.4",
     "@testing-library/jest-dom": "^6.2.0",
     "@types/jsdom": "^21.1.6",
     "@types/node": "^20.11.5",