@lynx-js/react 0.120.0 → 0.121.1

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

@@ -0,0 +1,236 @@
+// 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, markRemovedSubtreeForPostDispatchTeardown, 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 { hydrationMap } from '../hydration-map.js';
+import { ElementTemplateUpdateOps } from '../protocol/opcodes.js';
+export function hydrate(serialized, instance) {
+    resetGlobalCommitContext();
+    if (!hydrateIntoContext(serialized, instance)) {
+        // Hydration protocol errors are not transactional: earlier matched nodes
+        // may already be rebound while discovering a later mismatch. Discard the
+        // native output for this failed pass and let the listener keep refs/events gated.
+        resetGlobalCommitContext();
+    }
+    return globalCommitContext.ops;
+}
+export function hydrateIntoContext(serialized, instance) {
+    return 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];
+            if (!hydrateInstance(matchedSerialized[0], backgroundChild)) {
+                return null;
+            }
+            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 false;
+    }
+    const handleId = serialized.uid;
+    if (!bindHydrationHandleId(instance, handleId, serialized.templateKey)) {
+        return false;
+    }
+    instance.prepareAttributeSlotsForHydration();
+    hydrateAttributeSlots(handleId, serialized.attributeSlots ?? [], instance.attributeSlots);
+    if (serialized.templateKey === BUILTIN_RAW_TEXT_TEMPLATE_KEY) {
+        return true;
+    }
+    const serializedElementSlots = serialized.elementSlots ?? [];
+    const backgroundElementSlots = instance.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, backgroundElementSlots.length);
+    for (let slotId = 0; slotId < slotCount; slotId += 1) {
+        const serializedSlot = serializedElementSlots[slotId];
+        const backgroundSlot = backgroundElementSlots[slotId];
+        if (!serializedSlot && !backgroundSlot) {
+            continue;
+        }
+        if (!hydrateElementSlot(instance, slotId, serializedSlot ?? [], backgroundSlot ?? [])) {
+            return false;
+        }
+    }
+    return true;
+}
+function hydrateElementSlot(parent, slotId, serializedChildren, backgroundChildren) {
+    if (backgroundChildren.length === 0) {
+        for (const serialized of serializedChildren) {
+            emitSerializedSubtreeRemove(parent, slotId, serialized);
+        }
+        return true;
+    }
+    const listDiff = hydrateMatchingChildrenAndDiffSlot(serializedChildren, backgroundChildren);
+    if (listDiff === null) {
+        return false;
+    }
+    if (!listDiff.hasChanges) {
+        return true;
+    }
+    // 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 movesWaitingForInsertionPoint = 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 insertOrMovePatchesWaitingForInsertionPoint = listDiff.insertionCount;
+    while (currentSerializedChild || insertOrMovePatchesWaitingForInsertionPoint > 0) {
+        let keepCurrentSerializedChild = false;
+        if (currentSerializedChild && removalIndexes.has(oldIndex)) {
+            emitSerializedSubtreeRemove(parent, slotId, currentSerializedChild);
+        }
+        else if (currentSerializedChild && moves[oldIndex] !== undefined) {
+            const move = moves[oldIndex];
+            movesWaitingForInsertionPoint.set(move.toIndex, move.instance);
+            insertOrMovePatchesWaitingForInsertionPoint += 1;
+        }
+        else {
+            const beforeChildId = currentSerializedChild ? currentSerializedChild.uid : 0;
+            const movedChild = movesWaitingForInsertionPoint.get(newIndex);
+            if (movedChild) {
+                keepCurrentSerializedChild = true;
+                globalCommitContext.ops.push(ElementTemplateUpdateOps.insertNode, parent.instanceId, slotId, movedChild.instanceId, beforeChildId);
+                insertOrMovePatchesWaitingForInsertionPoint -= 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);
+                insertOrMovePatchesWaitingForInsertionPoint -= 1;
+            }
+            newIndex += 1;
+        }
+        if (currentSerializedChild && !keepCurrentSerializedChild) {
+            currentSerializedChild = serializedChildren[++serializedCursor];
+            oldIndex += 1;
+        }
+    }
+    return true;
+}
+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) {
+        markRemovedSubtreeForPostDispatchTeardown(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) {
+    // Linked-list walk: slot grouping would be discarded since we recurse into
+    // every child regardless of slot. `emitCreate` does its own single-walk
+    // serialization of `instanceId`s grouped by slot.
+    let child = node.firstChild;
+    while (child) {
+        emitCreateSubtree(child);
+        child = child.nextSibling;
+    }
+    node.prepareAttributeSlotsForHydration();
+    node.emitCreate();
+}
+function bindHydrationHandleId(instance, handleId, templateKey) {
+    const oldHandleId = instance.instanceId;
+    try {
+        backgroundElementTemplateInstanceManager.updateId(instance.instanceId, handleId);
+        // Ref proxies created before hydrate keep the old background id; resolve it
+        // lazily so user-held proxies continue selecting the hydrated native node.
+        hydrationMap.set(oldHandleId, handleId);
+        instance.markMaterializedByHydration();
+        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":"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"}

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,139 @@
+// 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, takeRemovedSubtreesForPostDispatchTeardown, } from './commit-context.js';
+import { markElementTemplateHydrated, resetElementTemplateCommitState, scheduleElementTemplateRemovedSubtreeCleanup, } from './commit-hook.js';
+import { hydrateIntoContext } from './hydrate.js';
+import { BackgroundElementTemplateInstance } from './instance.js';
+import { getReloadVersion } from '../../core/reload-version.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 { clearPendingEvents, flushPendingEvents } from '../prop-adapters/event.js';
+import { clearDelayedRefUiOps, clearPendingRefs, flushDelayedRefUiOps } from '../prop-adapters/ref.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;
+        let instances;
+        if (Array.isArray(data)) {
+            instances = data;
+        }
+        else {
+            const payload = data;
+            if (typeof payload.reloadVersion === 'number' && payload.reloadVersion < getReloadVersion()) {
+                return;
+            }
+            instances = payload.instances;
+        }
+        if (__PROFILE__) {
+            profileStart('ReactLynx::hydrate');
+        }
+        beginPipeline(true, PipelineOrigins.reactLynxHydrate, PerformanceTimingFlags.reactLynxHydrate);
+        markTiming('hydrateParsePayloadStart');
+        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;
+        let didHydrateMatchedInstances = true;
+        for (const before of instances) {
+            if (!after) {
+                break;
+            }
+            if (!('templateKey' in before)) {
+                if (__DEV__) {
+                    lynx.reportError(new Error(`ElementTemplate hydrate does not support serialized typed root '${before.type}'.`));
+                }
+                didHydrateMatchedInstances = false;
+                break;
+            }
+            if (!hydrateIntoContext(before, after)) {
+                didHydrateMatchedInstances = false;
+                break;
+            }
+            after = after.nextSibling;
+        }
+        if (typeof __ALOG__ !== 'undefined' && __ALOG__) {
+            console.alog?.('[ReactLynxDebug] BackgroundElementTemplate tree after hydration:\n'
+                + printElementTemplateTreeToString(root));
+        }
+        if (__PROFILE__) {
+            profileEnd();
+        }
+        markTiming('diffVdomEnd');
+        if (didHydrateMatchedInstances) {
+            markElementTemplateHydrated();
+        }
+        else {
+            // Hydrate is not transactional; a later failure can happen after earlier
+            // nodes were rebound. Treat the pass as failed for externally observable
+            // work, so delayed refs/events are not released from an incomplete tree.
+            clearPendingEvents();
+            clearPendingRefs();
+            clearDelayedRefUiOps();
+            resetGlobalCommitContext();
+        }
+        const hasHydrateUpdate = didHydrateMatchedInstances && 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 removedSubtreesAwaitingTeardown = takeRemovedSubtreesForPostDispatchTeardown();
+            try {
+                lynx.getCoreContext().dispatchEvent({
+                    type: ElementTemplateLifecycleConstant.update,
+                    data: {
+                        ops: globalCommitContext.ops,
+                        flushOptions: globalCommitContext.flushOptions,
+                        flowIds: globalCommitContext.flowIds,
+                        reloadVersion: getReloadVersion(),
+                    },
+                });
+                didDispatchHydrateUpdate = true;
+            }
+            finally {
+                if (!didDispatchHydrateUpdate) {
+                    // Do not expose refs or replay delayed selector ops if the hydrate
+                    // patch failed to reach the main thread; selectors may still point at
+                    // stale pre-hydration ids in that case.
+                    clearPendingEvents();
+                    clearPendingRefs();
+                    clearDelayedRefUiOps();
+                }
+                resetGlobalCommitContext();
+                scheduleElementTemplateRemovedSubtreeCleanup(removedSubtreesAwaitingTeardown);
+            }
+        }
+        if (didHydrateMatchedInstances && (!hasHydrateUpdate || didDispatchHydrateUpdate)) {
+            flushPendingEvents();
+            // Ordinary refs attach on Preact commit boundaries; hydration only releases
+            // delayed selector ops after ids have been rebound to stable native handles.
+            flushDelayedRefUiOps();
+        }
+    };
+    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,41 @@
+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;
+    __slotIndex: number;
+    attributeSlots: SerializableValue[];
+    private rawAttributeSlots;
+    private isMaterializedOnMainThread;
+    get parentNode(): BackgroundElementTemplateInstance | null;
+    get childNodes(): BackgroundElementTemplateInstance[];
+    get elementSlots(): BackgroundElementTemplateInstance[][];
+    nodeType: number;
+    constructor(type: string, initialAttributeSlots?: SerializableValue[]);
+    emitCreate(): void;
+    private needsMainThreadCreate;
+    emitMainThreadCreateIfNeeded(): void;
+    private canEmitUpdatePatch;
+    appendChild(child: BackgroundElementTemplateInstance): void;
+    insertBefore(child: BackgroundElementTemplateInstance, beforeChild: BackgroundElementTemplateInstance | null, silent?: boolean): void;
+    removeChild(child: BackgroundElementTemplateInstance, silent?: boolean): void;
+    tearDown(): void;
+    queueRefCleanupForSubtree(): void;
+    getRawAttributeSlot(attrSlotIndex: number): unknown;
+    markMaterializedByHydration(): void;
+    prepareAttributeSlotsForNative(options?: {
+        queueRefEffects?: boolean;
+    }): void;
+    prepareAttributeSlotsForHydration(): void;
+    setAttribute(key: string, value: unknown): void;
+    get text(): string;
+    set text(value: string);
+    get data(): string;
+    set data(value: string);
+}
+export declare function collectElementTemplateSubtreeHandleIds(root: BackgroundElementTemplateInstance): number[];