@lynx-js/react 0.120.0 → 0.121.0

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

@@ -0,0 +1,219 @@
+// Copyright 2025 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 { globalCommitContext, markRemovedSubtreeForCurrentCommit, resetGlobalCommitContext } from './commit-context.js';
+import { BUILTIN_RAW_TEXT_TEMPLATE_KEY } from './instance.js';
+import { backgroundElementTemplateInstanceManager } from './manager.js';
+import { isDirectOrDeepEqual } from '../../utils.js';
+import { ElementTemplateUpdateOps } from '../protocol/opcodes.js';
+export function hydrate(serialized, instance) {
+    resetGlobalCommitContext();
+    hydrateIntoContext(serialized, instance);
+    return globalCommitContext.ops;
+}
+export function hydrateIntoContext(serialized, instance) {
+    hydrateInstance(serialized, instance);
+}
+function hydrateMatchingChildrenAndDiffSlot(serializedChildren, backgroundChildren) {
+    let lastPlacedIndex = 0;
+    const result = {
+        hasChanges: false,
+        insertions: {},
+        insertionCount: 0,
+        removals: [],
+        moves: {},
+    };
+    const serializedByTemplateKey = {};
+    const serializedCursorByTemplateKey = {};
+    for (let i = 0; i < serializedChildren.length; i += 1) {
+        const node = serializedChildren[i];
+        (serializedByTemplateKey[node.templateKey] ??= []).push([node, i]);
+    }
+    for (let i = 0; i < backgroundChildren.length; i += 1) {
+        const backgroundChild = backgroundChildren[i];
+        const serializedCandidates = serializedByTemplateKey[backgroundChild.type];
+        const candidateCursor = serializedCursorByTemplateKey[backgroundChild.type] ?? 0;
+        const matchedSerialized = serializedCandidates?.[candidateCursor];
+        if (matchedSerialized) {
+            serializedCursorByTemplateKey[backgroundChild.type] = candidateCursor + 1;
+            const oldIndex = matchedSerialized[1];
+            hydrateInstance(matchedSerialized[0], backgroundChild);
+            if (oldIndex < lastPlacedIndex) {
+                result.moves[oldIndex] = { toIndex: i, instance: backgroundChild };
+                result.hasChanges = true;
+            }
+            else {
+                lastPlacedIndex = oldIndex;
+            }
+        }
+        else {
+            result.insertions[i] = backgroundChild;
+            result.insertionCount += 1;
+            result.hasChanges = true;
+        }
+    }
+    for (const key in serializedByTemplateKey) {
+        const candidates = serializedByTemplateKey[key];
+        const candidateCursor = serializedCursorByTemplateKey[key] ?? 0;
+        for (let i = candidateCursor; i < candidates.length; i += 1) {
+            result.removals.push(candidates[i][1]);
+            result.hasChanges = true;
+        }
+    }
+    return result;
+}
+function hydrateInstance(serialized, instance) {
+    if (serialized.templateKey !== instance.type) {
+        if (__DEV__) {
+            lynx.reportError(new Error(`ElementTemplate hydrate key mismatch: main='${serialized.templateKey}' background='${instance.type}'.`));
+        }
+        return;
+    }
+    const handleId = serialized.uid;
+    if (!bindHydrationHandleId(instance, handleId, serialized.templateKey)) {
+        return;
+    }
+    instance.prepareAttributeSlotsForNative();
+    hydrateAttributeSlots(handleId, serialized.attributeSlots ?? [], instance.attributeSlots);
+    if (serialized.templateKey === BUILTIN_RAW_TEXT_TEMPLATE_KEY) {
+        return;
+    }
+    const serializedElementSlots = serialized.elementSlots ?? [];
+    // Snapshot hydrates dynamic children through slot-filtered lists. Keeping ET
+    // scoped the same way means a cross-slot candidate is a source remove plus a
+    // target create/insert, while same-slot reorder can still stay move-like.
+    const slotCount = Math.max(serializedElementSlots.length, instance.elementSlots.length);
+    for (let slotId = 0; slotId < slotCount; slotId += 1) {
+        const serializedSlot = serializedElementSlots[slotId];
+        const backgroundSlot = instance.elementSlots[slotId];
+        if (!serializedSlot && !backgroundSlot) {
+            continue;
+        }
+        hydrateElementSlot(instance, slotId, serializedSlot ?? []);
+    }
+}
+function hydrateElementSlot(parent, slotId, serializedChildren) {
+    const backgroundChildren = parent.elementSlots[slotId] ?? [];
+    if (backgroundChildren.length === 0) {
+        for (const serialized of serializedChildren) {
+            emitSerializedSubtreeRemove(parent, slotId, serialized);
+        }
+        return;
+    }
+    const listDiff = hydrateMatchingChildrenAndDiffSlot(serializedChildren, backgroundChildren);
+    if (!listDiff.hasChanges) {
+        return;
+    }
+    // Hydrate emits patches directly here. Replaying against serialized order
+    // keeps insert targets in the main-thread slot without reshaping background.
+    const removalIndexes = new Set(listDiff.removals);
+    const { insertions, moves } = listDiff;
+    const pendingMoves = new Map();
+    let serializedCursor = 0;
+    let currentSerializedChild = serializedChildren[serializedCursor];
+    let newIndex = 0;
+    let oldIndex = 0;
+    // Insertions are known before replay starts. Moves are counted only when their
+    // old serialized position is reached, so the cursor can keep emitting patches
+    // even after all serialized children have been consumed.
+    let pendingInsertOrMovePatchCount = listDiff.insertionCount;
+    while (currentSerializedChild || pendingInsertOrMovePatchCount > 0) {
+        let keepCurrentSerializedChild = false;
+        if (currentSerializedChild && removalIndexes.has(oldIndex)) {
+            emitSerializedSubtreeRemove(parent, slotId, currentSerializedChild);
+        }
+        else if (currentSerializedChild && moves[oldIndex] !== undefined) {
+            const move = moves[oldIndex];
+            pendingMoves.set(move.toIndex, move.instance);
+            pendingInsertOrMovePatchCount += 1;
+        }
+        else {
+            const beforeChildId = currentSerializedChild ? currentSerializedChild.uid : 0;
+            const movedChild = pendingMoves.get(newIndex);
+            if (movedChild) {
+                keepCurrentSerializedChild = true;
+                globalCommitContext.ops.push(ElementTemplateUpdateOps.insertNode, parent.instanceId, slotId, movedChild.instanceId, beforeChildId);
+                pendingInsertOrMovePatchCount -= 1;
+            }
+            else if (insertions[newIndex] !== undefined) {
+                const insertedChild = insertions[newIndex];
+                keepCurrentSerializedChild = true;
+                emitCreateSubtree(insertedChild);
+                globalCommitContext.ops.push(ElementTemplateUpdateOps.insertNode, parent.instanceId, slotId, insertedChild.instanceId, beforeChildId);
+                pendingInsertOrMovePatchCount -= 1;
+            }
+            newIndex += 1;
+        }
+        if (currentSerializedChild && !keepCurrentSerializedChild) {
+            currentSerializedChild = serializedChildren[++serializedCursor];
+            oldIndex += 1;
+        }
+    }
+}
+function emitSerializedSubtreeRemove(parent, slotId, serialized) {
+    const childId = serialized.uid;
+    const existing = backgroundElementTemplateInstanceManager.get(childId);
+    // The removed child may no longer have a live background instance in this
+    // slot, so serialized data is the source of truth for registry cleanup.
+    const removedSubtreeHandleIds = [];
+    collectSerializedSubtreeHandleIdsInto(serialized, removedSubtreeHandleIds);
+    globalCommitContext.ops.push(ElementTemplateUpdateOps.removeNode, parent.instanceId, slotId, childId, removedSubtreeHandleIds);
+    if (existing && !existing.parent) {
+        markRemovedSubtreeForCurrentCommit(existing);
+    }
+}
+function collectSerializedSubtreeHandleIdsInto(serialized, handles) {
+    handles.push(serialized.uid);
+    for (const slotChildren of serialized.elementSlots ?? []) {
+        if (!slotChildren) {
+            continue;
+        }
+        for (const child of slotChildren) {
+            collectSerializedSubtreeHandleIdsInto(child, handles);
+        }
+    }
+}
+function emitCreateSubtree(node) {
+    for (const slotChildren of node.elementSlots) {
+        /* v8 ignore start */
+        if (!slotChildren) {
+            continue;
+        }
+        /* v8 ignore stop */
+        for (const child of slotChildren) {
+            emitCreateSubtree(child);
+        }
+    }
+    node.prepareAttributeSlotsForNative();
+    node.emitCreate();
+}
+function bindHydrationHandleId(instance, handleId, templateKey) {
+    try {
+        backgroundElementTemplateInstanceManager.updateId(instance.instanceId, handleId);
+        instance.markCreateEmittedForHydration();
+        return true;
+    }
+    catch (error) {
+        if (__DEV__) {
+            const reason = error instanceof Error ? error.message : String(error);
+            lynx.reportError(new Error(`ElementTemplate hydrate received invalid uid ${handleId} for '${templateKey}': ${reason}`));
+        }
+        return false;
+    }
+}
+function hydrateAttributeSlots(handleId, beforeSlots, afterSlots) {
+    const slotCount = Math.max(beforeSlots.length, afterSlots.length);
+    for (let slotIndex = 0; slotIndex < slotCount; slotIndex += 1) {
+        const beforeValue = beforeSlots[slotIndex];
+        const afterValue = afterSlots[slotIndex];
+        if (isDirectOrDeepEqual(beforeValue, afterValue)) {
+            continue;
+        }
+        if (afterValue === undefined && beforeValue === null) {
+            // JSON serialization turns undefined array slots into null on the main-thread payload.
+            continue;
+        }
+        globalCommitContext.ops.push(ElementTemplateUpdateOps.setAttribute, handleId, slotIndex, afterValue ?? null);
+    }
+}
+//# sourceMappingURL=hydrate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate.js","sourceRoot":"","sources":["../../../src/element-template/background/hydrate.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,OAAO,EAAE,mBAAmB,EAAE,kCAAkC,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACxH,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,EAAE,wCAAwC,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAOlE,MAAM,UAAU,OAAO,CACrB,UAAqC,EACrC,QAA2C;IAE3C,wBAAwB,EAAE,CAAC;IAC3B,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACzC,OAAO,mBAAmB,CAAC,GAAG,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,UAAqC,EACrC,QAA2C;IAE3C,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AACxC,CAAC;AAaD,SAAS,kCAAkC,CACzC,kBAA+C,EAC/C,kBAAuD;IAEvD,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,MAAM,MAAM,GAAyB;QACnC,UAAU,EAAE,KAAK;QACjB,UAAU,EAAE,EAAE;QACd,cAAc,EAAE,CAAC;QACjB,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE,EAAE;KACV,CAAC;IACF,MAAM,uBAAuB,GAA0D,EAAE,CAAC;IAC1F,MAAM,6BAA6B,GAA2B,EAAE,CAAC;IAEjE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,kBAAkB,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,kBAAkB,CAAC,CAAC,CAAE,CAAC;QACpC,CAAC,uBAAuB,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,kBAAkB,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,eAAe,GAAG,kBAAkB,CAAC,CAAC,CAAE,CAAC;QAC/C,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3E,MAAM,eAAe,GAAG,6BAA6B,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjF,MAAM,iBAAiB,GAAG,oBAAoB,EAAE,CAAC,eAAe,CAAC,CAAC;QAElE,IAAI,iBAAiB,EAAE,CAAC;YACtB,6BAA6B,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,eAAe,GAAG,CAAC,CAAC;YAC1E,MAAM,QAAQ,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;YACtC,eAAe,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;YACvD,IAAI,QAAQ,GAAG,eAAe,EAAE,CAAC;gBAC/B,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;gBACnE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,eAAe,GAAG,QAAQ,CAAC;YAC7B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC;YACvC,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC;YAC3B,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,uBAAuB,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,uBAAuB,CAAC,GAAG,CAAE,CAAC;QACjD,MAAM,eAAe,GAAG,6BAA6B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChE,KAAK,IAAI,CAAC,GAAG,eAAe,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5D,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CACtB,UAAqC,EACrC,QAA2C;IAE3C,IAAI,UAAU,CAAC,WAAW,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC7C,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,WAAW,CACd,IAAI,KAAK,CACP,+CAA+C,UAAU,CAAC,WAAW,iBAAiB,QAAQ,CAAC,IAAI,IAAI,CACxG,CACF,CAAC;QACJ,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAa,CAAC;IAC1C,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACvE,OAAO;IACT,CAAC;IACD,QAAQ,CAAC,8BAA8B,EAAE,CAAC;IAC1C,qBAAqB,CAAC,QAAQ,EAAE,UAAU,CAAC,cAAc,IAAI,EAAE,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAE1F,IAAI,UAAU,CAAC,WAAW,KAAK,6BAA6B,EAAE,CAAC;QAC7D,OAAO;IACT,CAAC;IAED,MAAM,sBAAsB,GAAG,UAAU,CAAC,YAAY,IAAI,EAAE,CAAC;IAC7D,6EAA6E;IAC7E,6EAA6E;IAC7E,0EAA0E;IAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACxF,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,cAAc,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,cAAc,GAAG,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACrD,IAAI,CAAC,cAAc,IAAI,CAAC,cAAc,EAAE,CAAC;YACvC,SAAS;QACX,CAAC;QACD,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CACzB,MAAyC,EACzC,MAAc,EACd,kBAA+C;IAE/C,MAAM,kBAAkB,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC7D,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,KAAK,MAAM,UAAU,IAAI,kBAAkB,EAAE,CAAC;YAC5C,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,kCAAkC,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;IAE5F,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IAED,0EAA0E;IAC1E,6EAA6E;IAC7E,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;IACvC,MAAM,YAAY,GAAG,IAAI,GAAG,EAA6C,CAAC;IAC1E,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,IAAI,sBAAsB,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;IAClE,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,+EAA+E;IAC/E,8EAA8E;IAC9E,yDAAyD;IACzD,IAAI,6BAA6B,GAAG,QAAQ,CAAC,cAAc,CAAC;IAC5D,OAAO,sBAAsB,IAAI,6BAA6B,GAAG,CAAC,EAAE,CAAC;QACnE,IAAI,0BAA0B,GAAG,KAAK,CAAC;QACvC,IAAI,sBAAsB,IAAI,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3D,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,sBAAsB,CAAC,CAAC;QACtE,CAAC;aAAM,IAAI,sBAAsB,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;YACnE,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAE,CAAC;YAC9B,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC9C,6BAA6B,IAAI,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,MAAM,aAAa,GAAG,sBAAsB,CAAC,CAAC,CAAC,sBAAsB,CAAC,GAAa,CAAC,CAAC,CAAC,CAAC,CAAC;YACxF,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC9C,IAAI,UAAU,EAAE,CAAC;gBACf,0BAA0B,GAAG,IAAI,CAAC;gBAClC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAC1B,wBAAwB,CAAC,UAAU,EACnC,MAAM,CAAC,UAAU,EACjB,MAAM,EACN,UAAU,CAAC,UAAU,EACrB,aAAa,CACd,CAAC;gBACF,6BAA6B,IAAI,CAAC,CAAC;YACrC,CAAC;iBAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC9C,MAAM,aAAa,GAAG,UAAU,CAAC,QAAQ,CAAE,CAAC;gBAC5C,0BAA0B,GAAG,IAAI,CAAC;gBAClC,iBAAiB,CAAC,aAAa,CAAC,CAAC;gBACjC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAC1B,wBAAwB,CAAC,UAAU,EACnC,MAAM,CAAC,UAAU,EACjB,MAAM,EACN,aAAa,CAAC,UAAU,EACxB,aAAa,CACd,CAAC;gBACF,6BAA6B,IAAI,CAAC,CAAC;YACrC,CAAC;YAED,QAAQ,IAAI,CAAC,CAAC;QAChB,CAAC;QACD,IAAI,sBAAsB,IAAI,CAAC,0BAA0B,EAAE,CAAC;YAC1D,sBAAsB,GAAG,kBAAkB,CAAC,EAAE,gBAAgB,CAAC,CAAC;YAChE,QAAQ,IAAI,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,2BAA2B,CAClC,MAAyC,EACzC,MAAc,EACd,UAAqC;IAErC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAa,CAAC;IACzC,MAAM,QAAQ,GAAG,wCAAwC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvE,0EAA0E;IAC1E,wEAAwE;IACxE,MAAM,uBAAuB,GAAa,EAAE,CAAC;IAC7C,qCAAqC,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAC;IAC3E,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAC1B,wBAAwB,CAAC,UAAU,EACnC,MAAM,CAAC,UAAU,EACjB,MAAM,EACN,OAAO,EACP,uBAAuB,CACxB,CAAC;IACF,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACjC,kCAAkC,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,SAAS,qCAAqC,CAC5C,UAAqC,EACrC,OAAiB;IAEjB,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,GAAa,CAAC,CAAC;IACvC,KAAK,MAAM,YAAY,IAAI,UAAU,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;QACzD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,SAAS;QACX,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;YACjC,qCAAqC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAuC;IAChE,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7C,qBAAqB;QACrB,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,SAAS;QACX,CAAC;QACD,oBAAoB;QACpB,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;YACjC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,IAAI,CAAC,8BAA8B,EAAE,CAAC;IACtC,IAAI,CAAC,UAAU,EAAE,CAAC;AACpB,CAAC;AAED,SAAS,qBAAqB,CAC5B,QAA2C,EAC3C,QAAgB,EAChB,WAAmB;IAEnB,IAAI,CAAC;QACH,wCAAwC,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACjF,QAAQ,CAAC,6BAA6B,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtE,IAAI,CAAC,WAAW,CACd,IAAI,KAAK,CAAC,gDAAgD,QAAQ,SAAS,WAAW,MAAM,MAAM,EAAE,CAAC,CACtG,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAC5B,QAAgB,EAChB,WAAgC,EAChC,UAA+B;IAE/B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAClE,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,SAAS,IAAI,CAAC,EAAE,CAAC;QAC9D,MAAM,WAAW,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,mBAAmB,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC;YACjD,SAAS;QACX,CAAC;QACD,IAAI,UAAU,KAAK,SAAS,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACrD,uFAAuF;YACvF,SAAS;QACX,CAAC;QACD,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAC1B,wBAAwB,CAAC,YAAY,EACrC,QAAQ,EACR,SAAS,EACT,UAAU,IAAI,IAAI,CACnB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/runtime/lib/element-template/background/hydration-listener.d.ts

@@ -0,0 +1,2 @@
+export declare function installElementTemplateHydrationListener(): void;
+export declare function resetElementTemplateHydrationListener(): void;

package/runtime/lib/element-template/background/hydration-listener.js

@@ -0,0 +1,93 @@
+// 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 { globalCommitContext, resetGlobalCommitContext, takeRemovedSubtreesForCurrentCommit, } from './commit-context.js';
+import { markElementTemplateHydrated, resetElementTemplateCommitState, scheduleElementTemplateRemovedSubtreeCleanup, } from './commit-hook.js';
+import { hydrateIntoContext } from './hydrate.js';
+import { BackgroundElementTemplateInstance } from './instance.js';
+import { formatElementTemplateUpdateCommands, printElementTemplateTreeToString } from '../debug/alog.js';
+import { profileEnd, profileStart } from '../debug/profile.js';
+import { PerformanceTimingFlags, PipelineOrigins, beginPipeline, markTiming } from '../lynx/performance.js';
+import { flushPendingEvents } from '../prop-adapters/event.js';
+import { ElementTemplateLifecycleConstant } from '../protocol/lifecycle-constant.js';
+import { __root } from '../runtime/page/root-instance.js';
+let listener;
+export function installElementTemplateHydrationListener() {
+    resetElementTemplateHydrationListener();
+    resetElementTemplateCommitState();
+    listener = (event) => {
+        const { data } = event;
+        if (__PROFILE__) {
+            profileStart('ReactLynx::hydrate');
+        }
+        beginPipeline(true, PipelineOrigins.reactLynxHydrate, PerformanceTimingFlags.reactLynxHydrate);
+        markTiming('hydrateParsePayloadStart');
+        const instances = data;
+        markTiming('hydrateParsePayloadEnd');
+        markTiming('diffVdomStart');
+        const root = __root;
+        resetGlobalCommitContext();
+        if (typeof __ALOG__ !== 'undefined' && __ALOG__) {
+            console.alog?.('[ReactLynxDebug] ElementTemplate MTS -> BTS hydrate:\n'
+                + JSON.stringify({ data: instances }, null, 2));
+            console.alog?.('[ReactLynxDebug] BackgroundElementTemplate tree before hydration:\n'
+                + printElementTemplateTreeToString(root));
+        }
+        let after = root.firstChild;
+        for (const before of instances) {
+            if (!after) {
+                break;
+            }
+            hydrateIntoContext(before, after);
+            after = after.nextSibling;
+        }
+        if (typeof __ALOG__ !== 'undefined' && __ALOG__) {
+            console.alog?.('[ReactLynxDebug] BackgroundElementTemplate tree after hydration:\n'
+                + printElementTemplateTreeToString(root));
+        }
+        if (__PROFILE__) {
+            profileEnd();
+        }
+        markTiming('diffVdomEnd');
+        markElementTemplateHydrated();
+        const hasHydrateUpdate = globalCommitContext.ops.length > 0;
+        let didDispatchHydrateUpdate = false;
+        if (hasHydrateUpdate) {
+            if (typeof __ALOG__ !== 'undefined' && __ALOG__) {
+                console.alog?.('[ReactLynxDebug] ElementTemplate hydrate update commands:\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,
+                    },
+                });
+                didDispatchHydrateUpdate = true;
+            }
+            finally {
+                resetGlobalCommitContext();
+                scheduleElementTemplateRemovedSubtreeCleanup(removedSubtrees);
+            }
+        }
+        if (!hasHydrateUpdate || didDispatchHydrateUpdate) {
+            flushPendingEvents();
+        }
+    };
+    lynx.getCoreContext().addEventListener(ElementTemplateLifecycleConstant.hydrate, listener);
+}
+export function resetElementTemplateHydrationListener() {
+    if (listener) {
+        lynx.getCoreContext().removeEventListener(ElementTemplateLifecycleConstant.hydrate, listener);
+    }
+    listener = undefined;
+}
+//# sourceMappingURL=hydration-listener.js.map

package/runtime/lib/element-template/background/hydration-listener.js.map

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

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

@@ -0,0 +1,39 @@
+import type { SerializableValue } from '../protocol/types.js';
+export declare const BUILTIN_RAW_TEXT_TEMPLATE_KEY = "_et_builtin_raw_text";
+export declare class BackgroundElementTemplateInstance {
+    instanceId: number;
+    type: string;
+    parent: BackgroundElementTemplateInstance | null;
+    firstChild: BackgroundElementTemplateInstance | null;
+    lastChild: BackgroundElementTemplateInstance | null;
+    nextSibling: BackgroundElementTemplateInstance | null;
+    previousSibling: BackgroundElementTemplateInstance | null;
+    attributeSlots: SerializableValue[];
+    elementSlots: BackgroundElementTemplateInstance[][];
+    private rawAttributeSlots;
+    private hasEmittedCreate;
+    get parentNode(): BackgroundElementTemplateInstance | null;
+    get childNodes(): BackgroundElementTemplateInstance[];
+    nodeType: number;
+    constructor(type: string, initialAttributeSlots?: SerializableValue[]);
+    emitCreate(): void;
+    private isPendingCreate;
+    private canEmitPatch;
+    appendChild(child: BackgroundElementTemplateInstance): void;
+    insertBefore(child: BackgroundElementTemplateInstance, beforeChild: BackgroundElementTemplateInstance | null, silent?: boolean): void;
+    removeChild(child: BackgroundElementTemplateInstance, silent?: boolean): void;
+    tearDown(): void;
+    getRawAttributeSlot(attrSlotIndex: number): unknown;
+    markCreateEmittedForHydration(): void;
+    prepareAttributeSlotsForNative(): void;
+    setAttribute(key: string, value: unknown): void;
+    get text(): string;
+    set text(value: string);
+    get data(): string;
+    set data(value: string);
+}
+export declare class BackgroundElementTemplateSlot extends BackgroundElementTemplateInstance {
+    partId: number;
+    constructor();
+}
+export declare function collectElementTemplateSubtreeHandleIds(root: BackgroundElementTemplateInstance): number[];