@jay-framework/runtime 0.17.3 → 0.18.0

package/dist/index.d.ts

@@ -475,25 +475,6 @@ declare function isForEach<ViewState, Item>(c: Conditional<ViewState> | When<Vie
 declare function isWhen<ViewState, Item>(c: Conditional<ViewState> | When<ViewState, any> | ForEach<ViewState, Item> | WithData<ViewState, any> | TextElement<ViewState> | BaseJayElement<ViewState>): c is When<ViewState, any>;
 declare function isWithData<ViewState, ChildViewState>(c: Conditional<ViewState> | When<ViewState, any> | ForEach<ViewState, any> | WithData<ViewState, ChildViewState> | TextElement<ViewState> | BaseJayElement<ViewState>): c is WithData<ViewState, ChildViewState>;
 declare function forEach<T, Item>(getItems: (T: any) => Array<Item>, elemCreator: (Item: any) => BaseJayElement<Item>, matchBy: string): ForEach<T, Item>;
-/**
- * Runtime support for pre-rendered slow arrays (slowForEach in jay-html).
- *
- * This function is used when a forEach loop has been pre-rendered at slow phase.
- * The array items are statically embedded in the jay-html, but we still need to:
- * 1. Set up the correct data context for each item (so bindings work)
- * 2. Enable fast/interactive updates within each item
- * 3. Support event handling with the correct item coordinates
- *
- * The key insight is that slowForEachItem switches the data context to the
- * specific array item, so child bindings like {price} work correctly
- * (they resolve to item.price, not viewState.price).
- *
- * @param getItems - Function to get the array from the parent ViewState (handles nested paths)
- * @param index - The jayIndex value (position in the pre-rendered array)
- * @param trackByValue - The jayTrackBy value (identity for reconciliation)
- * @param elementCreator - Function that creates the pre-rendered element (called within item context)
- */
-declare function slowForEachItem<ParentVS, ItemVS>(getItems: (parentData: ParentVS) => ItemVS[], index: number, trackByValue: string, elementCreator: () => BaseJayElement<ItemVS>): BaseJayElement<ParentVS>;
 interface ForEach<ViewState, Item> {
     getItems: (T: any) => Array<Item>;
     elemCreator: (Item: any, String: any) => BaseJayElement<Item>;
@@ -586,7 +567,7 @@ declare class ConstructContext<ViewState> {
     get dataIds(): Coordinate;
     coordinate: (refName: string) => Coordinate;
     /**
-     * Create a child context for a forEach/slowForEach item.
+     * Create a child context for a forEach item.
      *
      * With scoped coordinates (DL#126), coordinateBase is NOT accumulated —
      * scoped coordinates are fully qualified within each scope. Only dataIds
@@ -742,4 +723,4 @@ declare function hydrateForEach<ViewState, Item>(accessor: (vs: ViewState) => It
  */
 declare function childCompHydrate<ParentVS, Props, ChildT, ChildElement extends BaseJayElement<ChildT>, ChildComp extends JayComponent<Props, ChildT, ChildElement>>(compCreator: JayComponentConstructor<Props>, getProps: (t: ParentVS) => Props, scopeRootCoordinate?: string, ref?: PrivateRef<ParentVS, ChildComp>): BaseJayElement<ParentVS>;
 
-export { type Attribute, type Attributes, type BaseJayElement, BaseReferencesManager, type ComponentCollectionProxy, ComponentCollectionRefImpl, type ComponentProxy, ComponentRefImpl, ComponentRefsImpl, type Conditional, ConstructContext, type ContextMarker, type Coordinate, type DynamicAttributeOrProperty, EVENT_TRAP, type ElementFrom, type EventEmitter, type EventTypeFrom, type ExtractFastViewState, type ExtractInteractiveViewState, type ExtractProps, type ExtractRefs, type ExtractSlowViewState, type ExtractViewState, type ForEach, GetTrapProxy, type GlobalJayEvents, type HTMLElementCollectionProxy, type HTMLElementCollectionProxyTarget, type HTMLElementProxy, type HTMLElementProxyTarget, type HTMLNativeExec, type HeadLink, type HtmlContent, type JayComponent, type JayComponentConstructor, type JayContract, type JayElement, type JayEvent, type JayEventHandler, type JayEventHandlerWrapper, type JayLog, type JayNativeEventBuilder, type JayNativeFunction, LogType, type ManagedRefConstructor, ManagedRefType, type ManagedRefs, type MapEventEmitterViewState, type MountFunc, type OnlyEventEmitters, type PreRenderElement, type PrivateRef, type PrivateRefConstructor, PrivateRefs, type PropsFrom, ReferencesManager, type RenderElement, type RenderElementOptions, STATIC, type TextElement, VIEW_STATE_CHANGE_EVENT, type ViewStateFrom, type When, WhenRole, type WithData, adoptDynamicElement, adoptElement, adoptText, applyHtmlContent, booleanAttribute, childComp, childCompHydrate, clearGlobalContextRegistry, conditional, createJayContext, currentConstructionContext, defaultEventWrapper, dynamicAttribute, dynamicElement, dynamicElementNS, dynamicHtml, dynamicProperty, dynamicText, element, findContext, forEach, hydrateConditional, hydrateForEach, injectHeadLinks, isCondition, isForEach, isHtmlContent, isWhen, isWithData, jayLog, mathMLDynamicElement, mathMLElement, mkUpdateCollection, noop, noopMount, noopUpdate, normalizeMount, normalizeUpdates, pending, registerGlobalContext, rejected, resolved, restoreContext, saveContext, slowForEachItem, svgDynamicElement, svgElement, type updateFunc, useContext, useGlobalContext, withContext, withData };
+export { type Attribute, type Attributes, type BaseJayElement, BaseReferencesManager, type ComponentCollectionProxy, ComponentCollectionRefImpl, type ComponentProxy, ComponentRefImpl, ComponentRefsImpl, type Conditional, ConstructContext, type ContextMarker, type Coordinate, type DynamicAttributeOrProperty, EVENT_TRAP, type ElementFrom, type EventEmitter, type EventTypeFrom, type ExtractFastViewState, type ExtractInteractiveViewState, type ExtractProps, type ExtractRefs, type ExtractSlowViewState, type ExtractViewState, type ForEach, GetTrapProxy, type GlobalJayEvents, type HTMLElementCollectionProxy, type HTMLElementCollectionProxyTarget, type HTMLElementProxy, type HTMLElementProxyTarget, type HTMLNativeExec, type HeadLink, type HtmlContent, type JayComponent, type JayComponentConstructor, type JayContract, type JayElement, type JayEvent, type JayEventHandler, type JayEventHandlerWrapper, type JayLog, type JayNativeEventBuilder, type JayNativeFunction, LogType, type ManagedRefConstructor, ManagedRefType, type ManagedRefs, type MapEventEmitterViewState, type MountFunc, type OnlyEventEmitters, type PreRenderElement, type PrivateRef, type PrivateRefConstructor, PrivateRefs, type PropsFrom, ReferencesManager, type RenderElement, type RenderElementOptions, STATIC, type TextElement, VIEW_STATE_CHANGE_EVENT, type ViewStateFrom, type When, WhenRole, type WithData, adoptDynamicElement, adoptElement, adoptText, applyHtmlContent, booleanAttribute, childComp, childCompHydrate, clearGlobalContextRegistry, conditional, createJayContext, currentConstructionContext, defaultEventWrapper, dynamicAttribute, dynamicElement, dynamicElementNS, dynamicHtml, dynamicProperty, dynamicText, element, findContext, forEach, hydrateConditional, hydrateForEach, injectHeadLinks, isCondition, isForEach, isHtmlContent, isWhen, isWithData, jayLog, mathMLDynamicElement, mathMLElement, mkUpdateCollection, noop, noopMount, noopUpdate, normalizeMount, normalizeUpdates, pending, registerGlobalContext, rejected, resolved, restoreContext, saveContext, svgDynamicElement, svgElement, type updateFunc, useContext, useGlobalContext, withContext, withData };

package/dist/index.js

@@ -199,7 +199,7 @@ class ConstructContext {
     return this._dataIds;
   }
   /**
-   * Create a child context for a forEach/slowForEach item.
+   * Create a child context for a forEach item.
    *
    * With scoped coordinates (DL#126), coordinateBase is NOT accumulated —
    * scoped coordinates are fully qualified within each scope. Only dataIds
@@ -556,33 +556,6 @@ function mkWhenPendingCondition(when2, group) {
 function forEach(getItems, elemCreator, matchBy) {
   return { getItems, elemCreator, trackBy: matchBy };
 }
-function slowForEachItem(getItems, index, trackByValue, elementCreator) {
-  const parentContext = currentConstructionContext();
-  const savedContext = saveContext();
-  const parentData = parentContext.currData;
-  const array = getItems(parentData);
-  const initialItem = array?.[index];
-  const childContext = parentContext.forItem(initialItem, trackByValue);
-  const element2 = withContext(CONSTRUCTION_CONTEXT_MARKER, childContext, elementCreator);
-  const originalUpdate = element2.update;
-  const update = (newParentData) => {
-    const newArray = getItems(newParentData);
-    const newItem = newArray?.[index];
-    const updateChildContext = parentContext.forItem(newItem, trackByValue);
-    restoreContext(
-      savedContext,
-      () => withContext(CONSTRUCTION_CONTEXT_MARKER, updateChildContext, () => {
-        originalUpdate(newItem);
-      })
-    );
-  };
-  return {
-    dom: element2.dom,
-    update,
-    mount: element2.mount,
-    unmount: element2.unmount
-  };
-}
 function withData(accessor, elem) {
   return { accessor, elem };
 }
@@ -975,7 +948,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 +1034,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));
@@ -1682,7 +1660,6 @@ export {
   resolved,
   restoreContext,
   saveContext,
-  slowForEachItem,
   svgDynamicElement,
   svgElement,
   useContext,

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.18.0",
   "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.18.0",
+    "@jay-framework/reactive": "^0.18.0"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.17.3",
+    "@jay-framework/dev-environment": "^0.18.0",
     "@testing-library/jest-dom": "^6.2.0",
     "@types/jsdom": "^21.1.6",
     "@types/node": "^20.11.5",