@lynx-js/react 0.119.0 → 0.121.0

package/CHANGELOG.md

@@ -1,5 +1,83 @@
 # @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
+
+- Bump `@lynx-js/internal-preact` from `10.28.4-dfff9aa` to `10.29.1-20260424024911-12b794f` ([diff](https://github.com/lynx-family/internal-preact/compare/10.28.4-dfff9aa...10.29.1-20260424024911-12b794f)). ([#2512](https://github.com/lynx-family/lynx-stack/pull/2512))
+
+  Fixes wrong DOM order when a keyed child moves to a different `$N` slot across a re-render. Cross-slot moves now land at the correct slot position instead of being appended past stable siblings.
+
+- Refactor preact to support multi-slots children and reduce the number and depth of snapshot. ([#1764](https://github.com/lynx-family/lynx-stack/pull/1764))
+
+### Patch Changes
+
+- Fix stale callback-local references when transforming JSX inside `children={array.map(...)}` prop expressions. ([#2524](https://github.com/lynx-family/lynx-stack/pull/2524))
+
+- Fix ref callbacks not being cleaned up or re-applied correctly when the ref at the same element slot changes across rerenders that happen before hydration (e.g. a `useEffect` triggering `setState` during the initial background render). ([#2500](https://github.com/lynx-family/lynx-stack/pull/2500))
+
+- fix: reduce redundant updates for main-thread handlers and gestures ([#2188](https://github.com/lynx-family/lynx-stack/pull/2188))
+
+  - Updates are faster when the main-thread event handler or gesture object is stable across rerenders (fewer unnecessary native updates).
+  - Spread props rerenders that don't semantically change the handler/gesture no longer trigger redundant updates.
+  - Removing a gesture from spread props reliably clears the gesture state on the target element.
+
+- Fix hydration edge cases by tolerating serialized snapshot nodes with missing `values` ([#2481](https://github.com/lynx-family/lynx-stack/pull/2481))
+
+- Keep ReactLynx Testing Library imports aligned with the contained snapshot runtime paths. ([#2498](https://github.com/lynx-family/lynx-stack/pull/2498))
+
 ## 0.119.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynx-js/react",
-  "version": "0.119.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/hooks/react.d.ts",
-      "default": "./runtime/lib/hooks/react.js"
+      "types": "./runtime/lib/core/hooks/react.d.ts",
+      "default": "./runtime/lib/core/hooks/react.js"
     },
     "./lepus/hooks": {
-      "types": "./runtime/lib/hooks/react.d.ts",
-      "default": "./runtime/lib/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",
@@ -96,9 +112,9 @@
       "default": "./runtime/lib/worklet-runtime/bindings/index.js"
     },
     "./legacy-react-runtime": {
-      "types": "./runtime/lib/legacy-react-runtime/index.d.ts",
+      "types": "./runtime/lib/snapshot/legacy-react-runtime/index.d.ts",
       "lazy": "./runtime/lazy/legacy-react-runtime.js",
-      "default": "./runtime/lib/legacy-react-runtime/index.js"
+      "default": "./runtime/lib/snapshot/legacy-react-runtime/index.js"
     },
     "./testing-library": {
       "types": "./testing-library/types/index.d.ts",
@@ -132,10 +148,10 @@
         "./runtime/lazy/import.d.ts"
       ],
       "hooks": [
-        "./runtime/lib/hooks/react.d.ts"
+        "./runtime/lib/core/hooks/react.d.ts"
       ],
       "lepus/hooks": [
-        "./runtime/lib/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"
       ],
@@ -174,7 +202,7 @@
         "./runtime/lib/worklet-runtime/bindings/index.d.ts"
       ],
       "legacy-react-runtime": [
-        "./runtime/lib/legacy-react-runtime/index.d.ts"
+        "./runtime/lib/snapshot/legacy-react-runtime/index.d.ts"
       ]
     }
   },
@@ -192,7 +220,7 @@
     "README.zh.md"
   ],
   "dependencies": {
-    "preact": "npm:@lynx-js/internal-preact@10.28.4-2d1d67a"
+    "preact": "npm:@lynx-js/internal-preact@10.29.1-20260424024911-12b794f"
   },
   "devDependencies": {
     "@lynx-js/types": "3.7.0",

package/runtime/lazy/compat.js

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

package/runtime/lazy/internal.js

@@ -19,7 +19,10 @@ export const {
   __DynamicPartChildren,
   __DynamicPartChildren_0,
   __DynamicPartListChildren,
+  __DynamicPartListSlotV2,
   __DynamicPartSlot,
+  __DynamicPartSlotV2,
+  __DynamicPartSlotV2_0,
   __DynamicPartMultiChildren,
   __dynamicImport,
   __page,

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/{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/{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 '../renderToOpcodes/constants.js';
-import { noop } from '../utils.js';
+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';
 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/{hooks → 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/{hooks → 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/{hooks → 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/document.d.ts

@@ -1,5 +1,5 @@
-import { BackgroundSnapshotInstance } from './snapshot/backgroundSnapshot.js';
-import { SnapshotInstance } from './snapshot/snapshot.js';
+import { BackgroundSnapshotInstance } from './snapshot/snapshot/backgroundSnapshot.js';
+import { SnapshotInstance } from './snapshot/snapshot/snapshot.js';
 /**
  * This module implements an Interface Adapter Pattern to integrate Preact's
  * rendering system with Lynx's custom Snapshot-based virtual DOM.
@@ -26,10 +26,10 @@ declare const document: SnapshotDocumentAdapter;
  * Sets up the document interface for the background thread.
  * All DOM operations are intercepted to create {@link BackgroundSnapshotInstance}.
  */
-declare function setupBackgroundDocument(): void;
+declare function setupBackgroundDocument(_document?: SnapshotDocumentAdapter): void;
 /**
  * Sets up the document interface for the main thread.
  * All DOM operations are intercepted to create {@link SnapshotInstance}.
  */
-declare function setupDocument(): void;
+declare function setupDocument(_document?: SnapshotDocumentAdapter): void;
 export { document, setupBackgroundDocument, setupDocument };

package/runtime/lib/document.js

@@ -1,21 +1,21 @@
 // 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 { BackgroundSnapshotInstance } from './snapshot/backgroundSnapshot.js';
-import { SnapshotInstance } from './snapshot/snapshot.js';
+import { BackgroundSnapshotInstance } from './snapshot/snapshot/backgroundSnapshot.js';
+import { SnapshotInstance } from './snapshot/snapshot/snapshot.js';
 const document = {};
 /**
  * Sets up the document interface for the background thread.
  * All DOM operations are intercepted to create {@link BackgroundSnapshotInstance}.
  */
-function setupBackgroundDocument() {
-    document.createElement = function (type) {
+function setupBackgroundDocument(_document = document) {
+    _document.createElement = function (type) {
         return new BackgroundSnapshotInstance(type);
     };
-    document.createElementNS = function (_ns, type) {
+    _document.createElementNS = function (_ns, type, _is) {
         return new BackgroundSnapshotInstance(type);
     };
-    document.createTextNode = function (text) {
+    _document.createTextNode = function (text) {
         const i = new BackgroundSnapshotInstance(null);
         i.setAttribute(0, text);
         Object.defineProperty(i, 'data', {
@@ -30,14 +30,16 @@ function setupBackgroundDocument() {
  * Sets up the document interface for the main thread.
  * All DOM operations are intercepted to create {@link SnapshotInstance}.
  */
-function setupDocument() {
-    document.createElement = function (type) {
-        return new SnapshotInstance(type);
+function setupDocument(_document = document) {
+    _document.createElement = function (type) {
+        const si = new SnapshotInstance(type);
+        return si;
     };
-    document.createElementNS = function (_ns, type) {
-        return new SnapshotInstance(type);
+    _document.createElementNS = function (_ns, type, _is) {
+        const si = new SnapshotInstance(type);
+        return si;
     };
-    document.createTextNode = function (text) {
+    _document.createTextNode = function (text) {
         const i = new SnapshotInstance(null);
         i.setAttribute(0, text);
         Object.defineProperty(i, 'data', {

package/runtime/lib/document.js.map

@@ -1 +1 @@
-{"version":3,"file":"document.js","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAyB1D,MAAM,QAAQ,GAA4B,EAA6B,CAAC;AAExE;;;GAGG;AACH,SAAS,uBAAuB;IAC9B,QAAQ,CAAC,aAAa,GAAG,UAAS,IAAY;QAC5C,OAAO,IAAI,0BAA0B,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC,CAAC;IACF,QAAQ,CAAC,eAAe,GAAG,UAAS,GAAW,EAAE,IAAY;QAC3D,OAAO,IAAI,0BAA0B,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC,CAAC;IACF,QAAQ,CAAC,cAAc,GAAG,UAAS,IAAY;QAC7C,MAAM,CAAC,GAAG,IAAI,0BAA0B,CAAC,IAAyB,CAAC,CAAC;QACpE,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACxB,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE;YAC/B,GAAG,CAAC,CAAC;gBACH,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACvB,CAAC;SACF,CAAC,CAAC;QACH,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa;IACpB,QAAQ,CAAC,aAAa,GAAG,UAAS,IAAY;QAC5C,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC;IACF,QAAQ,CAAC,eAAe,GAAG,UAAS,GAAW,EAAE,IAAY;QAC3D,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC;IACF,QAAQ,CAAC,cAAc,GAAG,UAAS,IAAY;QAC7C,MAAM,CAAC,GAAG,IAAI,gBAAgB,CAAC,IAAyB,CAAC,CAAC;QAC1D,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACxB,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE;YAC/B,GAAG,CAAC,CAAC;gBACH,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACvB,CAAC;SACF,CAAC,CAAC;QACH,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;AACJ,CAAC;AAED,gBAAgB;AAChB,+BAA+B;AAC/B,0BAA0B;AAC1B,qBAAqB;AACrB,IAAI;AAEJ,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAyBnE,MAAM,QAAQ,GAA4B,EAA6B,CAAC;AAExE;;;GAGG;AACH,SAAS,uBAAuB,CAAC,YAAqC,QAAQ;IAC5E,SAAS,CAAC,aAAa,GAAG,UAAS,IAAY;QAC7C,OAAO,IAAI,0BAA0B,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC,CAAC;IACF,SAAS,CAAC,eAAe,GAAG,UAAS,GAAW,EAAE,IAAY,EAAE,GAAY;QAC1E,OAAO,IAAI,0BAA0B,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC,CAAC;IACF,SAAS,CAAC,cAAc,GAAG,UAAS,IAAY;QAC9C,MAAM,CAAC,GAAG,IAAI,0BAA0B,CAAC,IAAyB,CAAC,CAAC;QACpE,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACxB,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE;YAC/B,GAAG,CAAC,CAAC;gBACH,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACvB,CAAC;SACF,CAAC,CAAC;QACH,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,YAAqC,QAAQ;IAClE,SAAS,CAAC,aAAa,GAAG,UAAS,IAAY;QAC7C,MAAM,EAAE,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACtC,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;IACF,SAAS,CAAC,eAAe,GAAG,UAAS,GAAW,EAAE,IAAY,EAAE,GAAY;QAC1E,MAAM,EAAE,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACtC,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;IACF,SAAS,CAAC,cAAc,GAAG,UAAS,IAAY;QAC9C,MAAM,CAAC,GAAG,IAAI,gBAAgB,CAAC,IAAyB,CAAC,CAAC;QAC1D,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACxB,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE;YAC/B,GAAG,CAAC,CAAC;gBACH,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACvB,CAAC;SACF,CAAC,CAAC;QACH,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;AACJ,CAAC;AAED,gBAAgB;AAChB,+BAA+B;AAC/B,0BAA0B;AAC1B,qBAAqB;AACrB,IAAI;AAEJ,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,aAAa,EAAE,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;