@lynx-js/react 0.120.0 → 0.121.0

package/CHANGELOG.md

@@ -1,5 +1,57 @@
 # @lynx-js/react
 
+## 0.121.0
+
+### Minor Changes
+
+- Support `React.createElement(type, props, children)` API. ([#2360](https://github.com/lynx-family/lynx-stack/pull/2360))
+
+  ```jsx
+  React.createElement('view', { style }, <text>hello</text>);
+  // equivalent to
+  <view style={style}>
+    <text>hello</text>
+  </view>;
+
+  React.createElement(MyComponent, { style }, <view />);
+  // equivalent to
+  <MyComponent style={style}>
+    <view />
+  </MyComponent>;
+  ```
+
+### Patch Changes
+
+- Clear transient snapshot child props when removed snapshot subtrees are detached, preventing compiled `$*` child references from retaining deleted list holder or list item subtrees after removal. ([#2590](https://github.com/lynx-family/lynx-stack/pull/2590))
+
+- Add `createPortal` for rendering a subtree into a different ReactLynx element identified by a `NodesRef`. ([#2543](https://github.com/lynx-family/lynx-stack/pull/2543))
+
+  ```tsx
+  function App() {
+    const [host, setHost] = useState(null);
+    return (
+      <view>
+        <view ref={setHost} />
+        {host && createPortal(<text>hi</text>, host)}
+      </view>
+    );
+  }
+  ```
+
+- Default `fireEvent` to `bubbles: true` for the TouchEvent family in testing-library to match Lynx runtime semantics, and stop reassigning the read-only `Event.prototype` accessors which threw `TypeError` in strict mode. ([#2532](https://github.com/lynx-family/lynx-stack/pull/2532))
+
+- Set `bundle-url` on lazy bundle border elements. ([#2537](https://github.com/lynx-family/lynx-stack/pull/2537))
+
+- Stop warning when `runWorklet` receives an invalid or missing main-thread function object. Invalid worklet contexts are still ignored, but nullish handler values no longer produce noisy `MainThreadFunction: Invalid function object` console output. ([#2586](https://github.com/lynx-family/lynx-stack/pull/2586))
+
+- Retain main-thread worklet context references before offscreen snapshot elements are materialized, so event, ref, gesture, and spread callbacks stay alive until the DOM update path can attach them. ([#2592](https://github.com/lynx-family/lynx-stack/pull/2592))
+
+- Update the @lynx-js/tasm dependency to 0.0.39 and align React template attribute descriptors with it. ([#2643](https://github.com/lynx-family/lynx-stack/pull/2643))
+
+- Avoid retaining transformed nested worklet contexts after worklet transformation. ([#2591](https://github.com/lynx-family/lynx-stack/pull/2591))
+
+  Nested worklets transformed by the worklet runtime now keep their context recovery metadata through a weak reference, preventing cached transformed worklet functions from keeping list-item worklet contexts alive.
+
 ## 0.120.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynx-js/react",
-  "version": "0.120.0",
+  "version": "0.121.0",
   "description": "ReactLynx is a framework for developing Lynx applications with familiar React.",
   "repository": {
     "type": "git",
@@ -37,6 +37,22 @@
       "types": "./runtime/lib/document.d.ts",
       "default": "./runtime/lib/document.js"
     },
+    "./element-template": {
+      "types": "./runtime/lib/element-template/index.d.ts",
+      "default": "./runtime/lib/element-template/index.js"
+    },
+    "./element-template/internal": {
+      "types": "./runtime/lib/element-template/internal.d.ts",
+      "default": "./runtime/lib/element-template/internal.js"
+    },
+    "./element-template/jsx-runtime": {
+      "types": "./runtime/lib/element-template/jsx-runtime/index.d.ts",
+      "default": "./runtime/lib/element-template/jsx-runtime/index.js"
+    },
+    "./element-template/jsx-dev-runtime": {
+      "types": "./runtime/lib/element-template/jsx-dev-runtime/index.d.ts",
+      "default": "./runtime/lib/element-template/jsx-dev-runtime/index.js"
+    },
     "./jsx-runtime": {
       "types": "./runtime/jsx-runtime/index.d.ts",
       "lazy": "./runtime/lazy/jsx-runtime.js",
@@ -56,12 +72,12 @@
       "default": "./runtime/lepus/jsx-runtime/index.js"
     },
     "./hooks": {
-      "types": "./runtime/lib/snapshot/hooks/react.d.ts",
-      "default": "./runtime/lib/snapshot/hooks/react.js"
+      "types": "./runtime/lib/core/hooks/react.d.ts",
+      "default": "./runtime/lib/core/hooks/react.js"
     },
     "./lepus/hooks": {
-      "types": "./runtime/lib/snapshot/hooks/react.d.ts",
-      "default": "./runtime/lib/snapshot/hooks/mainThread.js"
+      "types": "./runtime/lib/core/hooks/react.d.ts",
+      "default": "./runtime/lib/core/hooks/mainThread.js"
     },
     "./lepus": {
       "types": "./runtime/lepus/index.d.ts",
@@ -132,10 +148,10 @@
         "./runtime/lazy/import.d.ts"
       ],
       "hooks": [
-        "./runtime/lib/snapshot/hooks/react.d.ts"
+        "./runtime/lib/core/hooks/react.d.ts"
       ],
       "lepus/hooks": [
-        "./runtime/lib/snapshot/hooks/react.d.ts"
+        "./runtime/lib/core/hooks/react.d.ts"
       ],
       "internal": [
         "./runtime/lib/internal.d.ts"
@@ -143,6 +159,18 @@
       "internal/document": [
         "./runtime/lib/document.d.ts"
       ],
+      "element-template": [
+        "./runtime/lib/element-template/index.d.ts"
+      ],
+      "element-template/internal": [
+        "./runtime/lib/element-template/internal.d.ts"
+      ],
+      "element-template/jsx-runtime": [
+        "./runtime/lib/element-template/jsx-runtime/index.d.ts"
+      ],
+      "element-template/jsx-dev-runtime": [
+        "./runtime/lib/element-template/jsx-dev-runtime/index.d.ts"
+      ],
       "jsx-runtime": [
         "./runtime/jsx-runtime/index.d.ts"
       ],

package/runtime/lazy/compat.js

@@ -18,6 +18,7 @@ export const {
   cloneElement,
   createContext,
   createElement,
+  createPortal,
   createRef,
   forwardRef,
   isValidElement,

package/runtime/lazy/react.js

@@ -16,6 +16,7 @@ export const {
   PureComponent,
   Suspense,
   cloneElement,
+  createPortal,
   createContext,
   createElement,
   createRef,

package/runtime/lib/core/hooks/mainThread.d.ts

@@ -0,0 +1 @@
+export * from './mainThreadImpl.js';

package/runtime/lib/core/hooks/mainThread.js

@@ -0,0 +1,7 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import { installMainThreadHooks } from './mainThreadImpl.js';
+installMainThreadHooks();
+export * from './mainThreadImpl.js';
+//# sourceMappingURL=mainThread.js.map

package/runtime/lib/core/hooks/mainThread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mainThread.js","sourceRoot":"","sources":["../../../src/core/hooks/mainThread.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,sBAAsB,EAAE,CAAC;AAEzB,cAAc,qBAAqB,CAAC"}

package/runtime/lib/{snapshot/hooks/mainThread.d.ts → core/hooks/mainThreadImpl.d.ts}

@@ -1,5 +1,6 @@
 import type { ErrorInfo, PreactContext } from 'preact';
 import type { Dispatch, useEffect as useEffectType, useErrorBoundary as useErrorBoundaryType, useImperativeHandle as useImperativeHandleType, useLayoutEffect as useLayoutEffectType } from 'preact/hooks';
+declare function installMainThreadHooks(): void;
 declare function useState<S>(initialState: S | (() => S)): [S, Dispatch<unknown>];
 declare function useReducer<S, A>(_reducer: (prevState: S, action: A) => S, initialState: S | (() => S), init?: (initialState: S) => S): [S, Dispatch<A>];
 declare function useRef<T>(initialValue?: T): {
@@ -14,4 +15,4 @@ declare function useId(): string;
 declare const useEffect: typeof useEffectType;
 declare const useLayoutEffect: typeof useLayoutEffectType;
 declare const useImperativeHandle: typeof useImperativeHandleType;
-export { useCallback, useContext, useDebugValue, useEffect, useErrorBoundary, useId, useImperativeHandle, useLayoutEffect, useMemo, useReducer, useRef, useState, };
+export { installMainThreadHooks, useCallback, useContext, useDebugValue, useEffect, useErrorBoundary, useId, useImperativeHandle, useLayoutEffect, useMemo, useReducer, useRef, useState, };

package/runtime/lib/{snapshot/hooks/mainThread.js → core/hooks/mainThreadImpl.js}

@@ -2,48 +2,59 @@
 // Licensed under the Apache License Version 2.0 that can be found in the
 // LICENSE file in the root directory of this source tree.
 /**
- * Implements hooks in main thread.
+ * Implements hooks in the main thread.
  * This module is modified from preact/hooks
  *
  * internal-preact/hooks/dist/hooks.mjs
  */
 import { options } from 'preact';
+import { CHILDREN, COMPONENT, DIFF, DIFFED, HOOK, HOOKS, LIST, MASK, PARENT, PENDING_EFFECTS, RENDER, ROOT, VALUE, VNODE, } from '../../shared/render-constants.js';
 import { noop } from '../../utils.js';
-import { CHILDREN, COMPONENT, DIFF, DIFFED, HOOK, HOOKS, LIST, MASK, PARENT, PENDING_EFFECTS, RENDER, ROOT, VALUE, VNODE, } from '../renderToOpcodes/constants.js';
 let currentIndex;
 let currentComponent;
 let currentHook;
-const oldBeforeDiff = options[DIFF];
-const oldBeforeRender = options[RENDER];
-const oldAfterDiff = options[DIFFED];
-const oldRoot = options[ROOT];
-options[DIFF] = function (vnode) {
-    currentComponent = null;
-    if (oldBeforeDiff)
-        oldBeforeDiff(vnode);
-};
-/* v8 ignore start */
-options[ROOT] = function (vnode, parentDom) {
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-    if (vnode && parentDom[CHILDREN] && parentDom[CHILDREN][MASK]) {
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-        vnode[MASK] = parentDom[CHILDREN][MASK];
+let hooksInstalled = false;
+let oldBeforeDiff;
+let oldBeforeRender;
+let oldAfterDiff;
+let oldRoot;
+function installMainThreadHooks() {
+    if (hooksInstalled) {
+        return;
     }
-    if (oldRoot)
-        oldRoot(vnode, parentDom);
-};
-/* v8 ignore stop */
-options[RENDER] = function (vnode) {
-    if (oldBeforeRender)
-        oldBeforeRender(vnode);
-    currentComponent = vnode[COMPONENT];
-    currentIndex = 0;
-};
-options[DIFFED] = function (vnode) {
-    if (oldAfterDiff)
-        oldAfterDiff(vnode);
-    currentComponent = null;
-};
+    hooksInstalled = true;
+    oldBeforeDiff = options[DIFF];
+    oldBeforeRender = options[RENDER];
+    oldAfterDiff = options[DIFFED];
+    oldRoot = options[ROOT];
+    options[DIFF] = function (vnode) {
+        currentComponent = null;
+        if (oldBeforeDiff)
+            oldBeforeDiff(vnode);
+    };
+    /* v8 ignore start */
+    options[ROOT] = function (vnode, parentDom) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+        if (vnode && parentDom[CHILDREN] && parentDom[CHILDREN][MASK]) {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+            vnode[MASK] = parentDom[CHILDREN][MASK];
+        }
+        if (oldRoot)
+            oldRoot(vnode, parentDom);
+    };
+    /* v8 ignore stop */
+    options[RENDER] = function (vnode) {
+        if (oldBeforeRender)
+            oldBeforeRender(vnode);
+        currentComponent = vnode[COMPONENT];
+        currentIndex = 0;
+    };
+    options[DIFFED] = function (vnode) {
+        if (oldAfterDiff)
+            oldAfterDiff(vnode);
+        currentComponent = null;
+    };
+}
 function getHookState(index, type) {
     if (options[HOOK]) {
         options[HOOK](currentComponent, index, currentHook || type);
@@ -148,5 +159,5 @@ function useId() {
 const useEffect = noop;
 const useLayoutEffect = noop;
 const useImperativeHandle = noop;
-export { useCallback, useContext, useDebugValue, useEffect, useErrorBoundary, useId, useImperativeHandle, useLayoutEffect, useMemo, useReducer, useRef, useState, };
-//# sourceMappingURL=mainThread.js.map
+export { installMainThreadHooks, useCallback, useContext, useDebugValue, useEffect, useErrorBoundary, useId, useImperativeHandle, useLayoutEffect, useMemo, useReducer, useRef, useState, };
+//# sourceMappingURL=mainThreadImpl.js.map

package/runtime/lib/core/hooks/mainThreadImpl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mainThreadImpl.js","sourceRoot":"","sources":["../../../src/core/hooks/mainThreadImpl.ts"],"names":[],"mappings":"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"}

package/runtime/lib/{snapshot → core}/hooks/react.js

@@ -2,7 +2,7 @@
 // Licensed under the Apache License Version 2.0 that can be found in the
 // LICENSE file in the root directory of this source tree.
 import { useCallback, useContext, useDebugValue, useErrorBoundary, useId, useImperativeHandle, useMemo, useEffect as usePreactEffect, useState as usePreactState, useReducer, useRef, } from 'preact/hooks';
-import { isProfiling, profileEnd, profileFlowId, profileStart } from '../debug/profile.js';
+import { isProfiling, profileEnd, profileFlowId, profileStart } from '../../shared/profile.js';
 // Cache profiled wrappers by the original preact setter to preserve stable
 // identity without introducing extra hooks in component render flow.
 const stateSetterTraceCache = /* @__PURE__ */ isProfiling

package/runtime/lib/core/hooks/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../../src/core/hooks/react.ts"],"names":[],"mappings":"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"}

package/runtime/lib/{snapshot → core}/hooks/useLynxGlobalEventListener.d.ts

@@ -1,5 +1,5 @@
 /**
- * `useLynxGlobalEventListener` help you `addListener` as early as possible.
+ * `useLynxGlobalEventListener` helps you `addListener` as early as possible.
  *
  * @example
  *

package/runtime/lib/{snapshot → core}/hooks/useLynxGlobalEventListener.js

@@ -3,7 +3,7 @@
 // LICENSE file in the root directory of this source tree.
 import { useEffect, useMemo, useRef } from 'preact/hooks';
 /**
- * `useLynxGlobalEventListener` help you `addListener` as early as possible.
+ * `useLynxGlobalEventListener` helps you `addListener` as early as possible.
  *
  * @example
  *

package/runtime/lib/core/hooks/useLynxGlobalEventListener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLynxGlobalEventListener.js","sourceRoot":"","sources":["../../../src/core/hooks/useLynxGlobalEventListener.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,0BAA0B,CACxC,SAAiB,EACjB,QAAW;IAEX,iBAAiB,CAAC;IAElB,MAAM,eAAe,GAAG,MAAM,EAAe,CAAC;IAE9C,OAAO,CAAC,GAAG,EAAE;QACX,IAAI,eAAe,CAAC,OAAO,EAAE,CAAC;YAC5B,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC;YACtD,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxE,eAAe,CAAC,OAAO,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE1B,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,eAAe,CAAC,OAAO,EAAE,CAAC;gBAC5B,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC;gBACtD,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC"}

package/runtime/lib/element-template/background/attr-slots.d.ts

@@ -0,0 +1,2 @@
+import type { SerializableValue } from '../protocol/types.js';
+export declare function prepareAttributeSlots(templateKey: string, handleId: number, rawSlots: readonly unknown[]): SerializableValue[];

package/runtime/lib/element-template/background/attr-slots.js

@@ -0,0 +1,34 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import { __etAttrPlanMap } from '../runtime/template/attr-slot-plan.js';
+function normalizeAttributeSlots(rawSlots) {
+    let normalizedSlots;
+    for (let slotIndex = 0; slotIndex < rawSlots.length; slotIndex += 1) {
+        const rawSlot = rawSlots[slotIndex];
+        if (rawSlot !== undefined) {
+            continue;
+        }
+        normalizedSlots ??= rawSlots.slice();
+        normalizedSlots[slotIndex] = null;
+    }
+    return normalizedSlots ?? rawSlots;
+}
+export function prepareAttributeSlots(templateKey, handleId, rawSlots) {
+    const attrPlan = __etAttrPlanMap[templateKey];
+    if (!attrPlan || attrPlan.length === 0) {
+        return normalizeAttributeSlots(rawSlots);
+    }
+    const normalizedSlots = normalizeAttributeSlots(rawSlots);
+    const preparedSlots = normalizedSlots === rawSlots
+        ? rawSlots.slice()
+        : normalizedSlots;
+    for (let planIndex = 0; planIndex < attrPlan.length; planIndex += 2) {
+        const attrSlotIndex = attrPlan[planIndex];
+        const adapter = attrPlan[planIndex + 1];
+        const rawValue = rawSlots[attrSlotIndex];
+        preparedSlots[attrSlotIndex] = adapter(handleId, attrSlotIndex, rawValue);
+    }
+    return preparedSlots;
+}
+//# sourceMappingURL=attr-slots.js.map

package/runtime/lib/element-template/background/attr-slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attr-slots.js","sourceRoot":"","sources":["../../../src/element-template/background/attr-slots.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAG1D,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAGxE,SAAS,uBAAuB,CAAC,QAA4B;IAC3D,IAAI,eAAgD,CAAC;IACrD,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,EAAE,CAAC;QACpE,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,eAAe,KAAK,QAAQ,CAAC,KAAK,EAAyB,CAAC;QAC5D,eAAe,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IACpC,CAAC;IACD,OAAO,eAAe,IAAI,QAA+B,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,WAAmB,EACnB,QAAgB,EAChB,QAA4B;IAE5B,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,eAAe,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAC1D,MAAM,aAAa,GAAG,eAAe,KAAK,QAAQ;QAChD,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAyB;QACzC,CAAC,CAAC,eAAe,CAAC;IACpB,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,EAAE,CAAC;QACpE,MAAM,aAAa,GAAG,QAAQ,CAAC,SAAS,CAAW,CAAC;QACpD,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAkB,CAAC;QACzD,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC;QACzC,aAAa,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/runtime/lib/element-template/background/commit-context.d.ts

@@ -0,0 +1,13 @@
+import type { BackgroundElementTemplateInstance } from './instance.js';
+import type { ElementTemplateUpdateCommitContext } from '../protocol/types.js';
+interface ElementTemplateCommitNonPayloadState {
+    removedSubtrees: BackgroundElementTemplateInstance[];
+}
+type ElementTemplateGlobalCommitContext = ElementTemplateUpdateCommitContext & {
+    nonPayload: ElementTemplateCommitNonPayloadState;
+};
+export declare const globalCommitContext: ElementTemplateGlobalCommitContext;
+export declare function resetGlobalCommitContext(): void;
+export declare function markRemovedSubtreeForCurrentCommit(root: BackgroundElementTemplateInstance): void;
+export declare function takeRemovedSubtreesForCurrentCommit(): BackgroundElementTemplateInstance[];
+export {};

package/runtime/lib/element-template/background/commit-context.js

@@ -0,0 +1,25 @@
+export const globalCommitContext = {
+    ops: [],
+    flushOptions: {},
+    nonPayload: {
+        removedSubtrees: [],
+    },
+};
+export function resetGlobalCommitContext() {
+    globalCommitContext.ops = [];
+    globalCommitContext.flushOptions = {};
+    delete globalCommitContext.flowIds;
+    globalCommitContext.nonPayload.removedSubtrees = [];
+}
+export function markRemovedSubtreeForCurrentCommit(root) {
+    const { removedSubtrees } = globalCommitContext.nonPayload;
+    if (!removedSubtrees.includes(root)) {
+        removedSubtrees.push(root);
+    }
+}
+export function takeRemovedSubtreesForCurrentCommit() {
+    const removedSubtrees = globalCommitContext.nonPayload.removedSubtrees;
+    globalCommitContext.nonPayload.removedSubtrees = [];
+    return removedSubtrees;
+}
+//# sourceMappingURL=commit-context.js.map

package/runtime/lib/element-template/background/commit-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-context.js","sourceRoot":"","sources":["../../../src/element-template/background/commit-context.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,mBAAmB,GAAuC;IACrE,GAAG,EAAE,EAAE;IACP,YAAY,EAAE,EAAE;IAChB,UAAU,EAAE;QACV,eAAe,EAAE,EAAE;KACpB;CACF,CAAC;AAEF,MAAM,UAAU,wBAAwB;IACtC,mBAAmB,CAAC,GAAG,GAAG,EAAE,CAAC;IAC7B,mBAAmB,CAAC,YAAY,GAAG,EAAE,CAAC;IACtC,OAAO,mBAAmB,CAAC,OAAO,CAAC;IACnC,mBAAmB,CAAC,UAAU,CAAC,eAAe,GAAG,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,IAAuC;IAEvC,MAAM,EAAE,eAAe,EAAE,GAAG,mBAAmB,CAAC,UAAU,CAAC;IAC3D,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mCAAmC;IACjD,MAAM,eAAe,GAAG,mBAAmB,CAAC,UAAU,CAAC,eAAe,CAAC;IACvE,mBAAmB,CAAC,UAAU,CAAC,eAAe,GAAG,EAAE,CAAC;IACpD,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/runtime/lib/element-template/background/commit-hook.d.ts

@@ -0,0 +1,7 @@
+import type { BackgroundElementTemplateInstance } from './instance.js';
+export declare function markElementTemplateHydrated(): void;
+export declare function isElementTemplateHydrated(): boolean;
+export declare function resetElementTemplateCommitState(): void;
+export declare function scheduleElementTemplateRemovedSubtreeCleanup(removedSubtrees: BackgroundElementTemplateInstance[]): void;
+export declare function cancelElementTemplateRemovedSubtreeCleanup(): void;
+export declare function installElementTemplateCommitHook(): void;

package/runtime/lib/element-template/background/commit-hook.js

@@ -0,0 +1,96 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import { options } from 'preact';
+import { globalCommitContext, resetGlobalCommitContext, takeRemovedSubtreesForCurrentCommit, } from './commit-context.js';
+import { COMMIT } from '../../shared/render-constants.js';
+import { hook } from '../../utils.js';
+import { formatElementTemplateUpdateCommands } from '../debug/alog.js';
+import { profileEnd, profileStart } from '../debug/profile.js';
+import { globalPipelineOptions, markTiming, markTimingLegacy, setPipeline } from '../lynx/performance.js';
+import { ElementTemplateLifecycleConstant } from '../protocol/lifecycle-constant.js';
+let installed = false;
+let hasHydrated = false;
+const scheduledRemovedSubtreeCleanupTimers = new Set();
+export function markElementTemplateHydrated() {
+    hasHydrated = true;
+}
+export function isElementTemplateHydrated() {
+    return hasHydrated;
+}
+export function resetElementTemplateCommitState() {
+    hasHydrated = false;
+    resetGlobalCommitContext();
+}
+export function scheduleElementTemplateRemovedSubtreeCleanup(removedSubtrees) {
+    if (removedSubtrees.length === 0) {
+        return;
+    }
+    const timer = setTimeout(() => {
+        scheduledRemovedSubtreeCleanupTimers.delete(timer);
+        for (const root of removedSubtrees) {
+            root.tearDown();
+        }
+    }, 10000);
+    scheduledRemovedSubtreeCleanupTimers.add(timer);
+}
+export function cancelElementTemplateRemovedSubtreeCleanup() {
+    for (const timer of scheduledRemovedSubtreeCleanupTimers) {
+        clearTimeout(timer);
+    }
+    scheduledRemovedSubtreeCleanupTimers.clear();
+}
+export function installElementTemplateCommitHook() {
+    if (installed) {
+        return;
+    }
+    installed = true;
+    hook(options, COMMIT, (originalCommit, vnode, commitQueue) => {
+        if (__BACKGROUND__ && hasHydrated && globalCommitContext.ops.length > 0) {
+            markTimingLegacy('updateDiffVdomEnd');
+            markTiming('diffVdomEnd');
+            if (__PROFILE__) {
+                profileStart('ReactLynx::commitChanges');
+            }
+            markTiming('packChangesStart');
+            if (globalPipelineOptions) {
+                globalCommitContext.flushOptions.pipelineOptions = globalPipelineOptions;
+            }
+            markTiming('packChangesEnd');
+            if (globalPipelineOptions) {
+                setPipeline(undefined);
+            }
+            if (__PROFILE__) {
+                profileEnd();
+            }
+            if (typeof __ALOG__ !== 'undefined' && __ALOG__) {
+                console.alog?.('[ReactLynxDebug] ElementTemplate BTS -> MTS update:\n'
+                    + JSON.stringify({
+                        ops: formatElementTemplateUpdateCommands(globalCommitContext.ops),
+                        flushOptions: globalCommitContext.flushOptions,
+                        flowIds: globalCommitContext.flowIds,
+                    }, null, 2));
+            }
+            const removedSubtrees = takeRemovedSubtreesForCurrentCommit();
+            try {
+                lynx.getCoreContext().dispatchEvent({
+                    type: ElementTemplateLifecycleConstant.update,
+                    data: {
+                        ops: globalCommitContext.ops,
+                        flushOptions: globalCommitContext.flushOptions,
+                        flowIds: globalCommitContext.flowIds,
+                    },
+                });
+            }
+            finally {
+                resetGlobalCommitContext();
+                // Match Snapshot's cleanup boundary: start the delayed teardown only
+                // after the bridge dispatch attempt, so background JS objects are not
+                // torn down before main-thread detach observes the same commit.
+                scheduleElementTemplateRemovedSubtreeCleanup(removedSubtrees);
+            }
+        }
+        originalCommit?.(vnode, commitQueue);
+    });
+}
+//# sourceMappingURL=commit-hook.js.map

package/runtime/lib/element-template/background/commit-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-hook.js","sourceRoot":"","sources":["../../../src/element-template/background/commit-hook.ts"],"names":[],"mappings":"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"}

package/runtime/lib/element-template/background/destroy.d.ts

@@ -0,0 +1 @@
+export declare function destroyElementTemplateBackgroundRuntime(): void;

package/runtime/lib/element-template/background/destroy.js

@@ -0,0 +1,17 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import { cancelElementTemplateRemovedSubtreeCleanup, resetElementTemplateCommitState } from './commit-hook.js';
+import { resetElementTemplateHydrationListener } from './hydration-listener.js';
+import { backgroundElementTemplateInstanceManager } from './manager.js';
+import { clearEventState } from '../prop-adapters/event.js';
+export function destroyElementTemplateBackgroundRuntime() {
+    resetElementTemplateHydrationListener();
+    resetElementTemplateCommitState();
+    // Destroy is the only place that may discard delayed removed subtrees instead
+    // of letting the Snapshot-aligned timer tear them down later.
+    cancelElementTemplateRemovedSubtreeCleanup();
+    clearEventState();
+    backgroundElementTemplateInstanceManager.clear();
+}
+//# sourceMappingURL=destroy.js.map

package/runtime/lib/element-template/background/destroy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"destroy.js","sourceRoot":"","sources":["../../../src/element-template/background/destroy.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,OAAO,EAAE,0CAA0C,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAC;AAC/G,OAAO,EAAE,qCAAqC,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,wCAAwC,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,UAAU,uCAAuC;IACrD,qCAAqC,EAAE,CAAC;IACxC,+BAA+B,EAAE,CAAC;IAClC,8EAA8E;IAC9E,8DAA8D;IAC9D,0CAA0C,EAAE,CAAC;IAC7C,eAAe,EAAE,CAAC;IAClB,wCAAwC,CAAC,KAAK,EAAE,CAAC;AACnD,CAAC"}

package/runtime/lib/element-template/background/document.d.ts

@@ -0,0 +1,7 @@
+import { BackgroundElementTemplateInstance } from './instance.js';
+export interface BackgroundElementTemplateDocument {
+    createElement(type: string): BackgroundElementTemplateInstance;
+    createElementNS(ns: string, type: string): BackgroundElementTemplateInstance;
+    createTextNode(text: string): BackgroundElementTemplateInstance;
+}
+export declare function setupBackgroundElementTemplateDocument(): BackgroundElementTemplateDocument;

package/runtime/lib/element-template/background/document.js

@@ -0,0 +1,27 @@
+// Copyright 2024 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import { options } from 'preact';
+import { BUILTIN_RAW_TEXT_TEMPLATE_KEY, BackgroundElementTemplateInstance, BackgroundElementTemplateSlot, } from './instance.js';
+export function setupBackgroundElementTemplateDocument() {
+    const doc = {
+        createElement(type) {
+            if (type === 'slot') {
+                return new BackgroundElementTemplateSlot();
+            }
+            return new BackgroundElementTemplateInstance(type);
+        },
+        createElementNS(_ns, type) {
+            if (type === 'slot') {
+                return new BackgroundElementTemplateSlot();
+            }
+            return new BackgroundElementTemplateInstance(type);
+        },
+        createTextNode(text) {
+            return new BackgroundElementTemplateInstance(BUILTIN_RAW_TEXT_TEMPLATE_KEY, [text]);
+        },
+    };
+    options.document = doc;
+    return doc;
+}
+//# sourceMappingURL=document.js.map

package/runtime/lib/element-template/background/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../../src/element-template/background/document.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEjC,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AAQvB,MAAM,UAAU,sCAAsC;IACpD,MAAM,GAAG,GAAG;QACV,aAAa,CAAC,IAAY;YACxB,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,OAAO,IAAI,6BAA6B,EAAE,CAAC;YAC7C,CAAC;YACD,OAAO,IAAI,iCAAiC,CAAC,IAAI,CAAC,CAAC;QACrD,CAAC;QACD,eAAe,CAAC,GAAW,EAAE,IAAY;YACvC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,OAAO,IAAI,6BAA6B,EAAE,CAAC;YAC7C,CAAC;YACD,OAAO,IAAI,iCAAiC,CAAC,IAAI,CAAC,CAAC;QACrD,CAAC;QACD,cAAc,CAAC,IAAY;YACzB,OAAO,IAAI,iCAAiC,CAAC,6BAA6B,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QACtF,CAAC;KACF,CAAC;IAEF,OAAO,CAAC,QAAQ,GAAG,GAA0B,CAAC;IAE9C,OAAO,GAAG,CAAC;AACb,CAAC"}

package/runtime/lib/element-template/background/hydrate.d.ts

@@ -0,0 +1,4 @@
+import type { BackgroundElementTemplateInstance } from './instance.js';
+import type { ElementTemplateUpdateCommandStream, SerializedElementTemplate } from '../protocol/types.js';
+export declare function hydrate(serialized: SerializedElementTemplate, instance: BackgroundElementTemplateInstance): ElementTemplateUpdateCommandStream;
+export declare function hydrateIntoContext(serialized: SerializedElementTemplate, instance: BackgroundElementTemplateInstance): void;