@lynx-js/react 0.120.0 → 0.121.1

package/runtime/lib/element-template/lynx/performance.js

@@ -0,0 +1,135 @@
+// 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 { RENDER_COMPONENT, ROOT } from '../../shared/render-constants.js';
+import { hook } from '../../utils.js';
+import { globalCommitContext } from '../background/commit-context.js';
+const PerformanceTimingKeys = [
+    'updateSetStateTrigger',
+    'updateDiffVdomStart',
+    'updateDiffVdomEnd',
+    // updateSetStateTrigger, updateDiffVdomStart and updateDiffVdomEnd is deprecated
+    'diffVdomStart',
+    'diffVdomEnd',
+    'packChangesStart',
+    'packChangesEnd',
+    'parseChangesStart',
+    'parseChangesEnd',
+    'patchChangesStart',
+    'patchChangesEnd',
+    'hydrateParsePayloadStart',
+    'hydrateParsePayloadEnd',
+    'mtsRenderStart',
+    'mtsRenderEnd',
+];
+const PerformanceTimingFlags = {
+    reactLynxHydrate: 'react_lynx_hydrate',
+};
+const PipelineOrigins = {
+    reactLynxHydrate: 'reactLynxHydrate',
+    updateTriggeredByBts: 'updateTriggeredByBts',
+};
+/**
+ * @deprecated used by old timing api(setState timing flag)
+ */
+const PerfSpecificKey = '__lynx_timing_flag';
+let timingFlag;
+let shouldMarkDiffVdomStart = false;
+let shouldMarkDiffVdomEnd = false;
+let globalPipelineOptions;
+/**
+ * @deprecated used by old timing api(setState timing flag)
+ */
+function markTimingLegacy(key, timingFlag_) {
+    switch (key) {
+        case 'updateSetStateTrigger': {
+            shouldMarkDiffVdomStart = true;
+            shouldMarkDiffVdomEnd = true;
+            timingFlag = timingFlag_;
+            break;
+        }
+        case 'updateDiffVdomStart': {
+            if (!shouldMarkDiffVdomStart) {
+                return;
+            }
+            shouldMarkDiffVdomStart = false;
+            break;
+        }
+        case 'updateDiffVdomEnd': {
+            if (!shouldMarkDiffVdomEnd) {
+                return;
+            }
+            shouldMarkDiffVdomEnd = false;
+            break;
+        }
+    }
+    lynx.getNativeApp().markTiming?.(timingFlag, key);
+}
+function beginPipeline(needTimestamps, pipelineOrigin, timingFlag) {
+    globalPipelineOptions = lynx.performance?._generatePipelineOptions?.();
+    if (globalPipelineOptions) {
+        globalPipelineOptions.needTimestamps = needTimestamps;
+        globalPipelineOptions.pipelineOrigin = pipelineOrigin;
+        globalPipelineOptions.dsl = 'reactLynx';
+        switch (pipelineOrigin) {
+            case PipelineOrigins.reactLynxHydrate:
+                globalPipelineOptions.stage = 'hydrate';
+                break;
+            case PipelineOrigins.updateTriggeredByBts:
+                globalPipelineOptions.stage = 'update';
+                break;
+        }
+        lynx.performance?._onPipelineStart?.(globalPipelineOptions.pipelineID, globalPipelineOptions);
+        if (timingFlag) {
+            lynx.performance?._bindPipelineIdWithTimingFlag?.(globalPipelineOptions.pipelineID, timingFlag);
+        }
+    }
+}
+function setPipeline(pipeline) {
+    globalPipelineOptions = pipeline;
+}
+function markTiming(timestampKey, force) {
+    if (globalPipelineOptions && (force || globalPipelineOptions.needTimestamps)) {
+        lynx.performance?._markTiming?.(globalPipelineOptions.pipelineID, timestampKey);
+    }
+}
+function shouldStartUpdatePipeline() {
+    return globalCommitContext.ops.length > 0;
+}
+function initTimingAPI() {
+    // eslint-disable-next-line unicorn/consistent-function-scoping
+    const helper = () => {
+        // Check update ops to make sure this only runs after hydrate
+        if (__JS__ && shouldStartUpdatePipeline()) {
+            if (!globalPipelineOptions) {
+                beginPipeline(false, PipelineOrigins.updateTriggeredByBts);
+                markTiming('diffVdomStart', true);
+            }
+            if (shouldMarkDiffVdomStart) {
+                markTimingLegacy('updateDiffVdomStart');
+            }
+        }
+    };
+    hook(options, RENDER_COMPONENT, (old, vnode, c) => {
+        helper();
+        /* v8 ignore start */
+        if (old) {
+            old(vnode, c);
+        }
+        /* v8 ignore stop */
+    });
+    hook(options, ROOT, (old, vnode, parentDom) => {
+        helper();
+        /* v8 ignore start */
+        if (old) {
+            old(vnode, parentDom);
+        }
+        /* v8 ignore stop */
+    });
+}
+/**
+ * @internal
+ */
+export { PerformanceTimingFlags, PipelineOrigins, PerfSpecificKey, markTimingLegacy, initTimingAPI, beginPipeline, markTiming, setPipeline, globalPipelineOptions, };
+//# sourceMappingURL=performance.js.map

package/runtime/lib/element-template/lynx/performance.js.map

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

package/runtime/lib/element-template/native/callDestroyLifetimeFun.d.ts

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

package/runtime/lib/element-template/native/callDestroyLifetimeFun.js

@@ -0,0 +1,8 @@
+// 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 { destroyElementTemplateBackgroundRuntime } from '../background/destroy.js';
+export function callDestroyLifetimeFun() {
+    destroyElementTemplateBackgroundRuntime();
+}
+//# sourceMappingURL=callDestroyLifetimeFun.js.map

package/runtime/lib/element-template/native/callDestroyLifetimeFun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callDestroyLifetimeFun.js","sourceRoot":"","sources":["../../../src/element-template/native/callDestroyLifetimeFun.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,uCAAuC,EAAE,MAAM,0BAA0B,CAAC;AAEnF,MAAM,UAAU,sBAAsB;IACpC,uCAAuC,EAAE,CAAC;AAC5C,CAAC"}

package/runtime/lib/element-template/native/index.d.ts

@@ -0,0 +1 @@
+import '@lynx-js/react/hooks';

package/runtime/lib/element-template/native/index.js

@@ -0,0 +1,79 @@
+// 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 '@lynx-js/react/hooks';
+import { render } from 'preact';
+import { callDestroyLifetimeFun } from './callDestroyLifetimeFun.js';
+import { injectCalledByNative } from './main-thread-api.js';
+import { installOnMtsDestruction } from './mts-destroy.js';
+import { installElementTemplatePatchListener } from './patch-listener.js';
+import { reloadBackground } from './reload.js';
+import { runWithForceRootRender } from '../../core/forceRootRender.js';
+import { updateGlobalProps as updateGlobalPropsCore } from '../../core/globalProps.js';
+import { installMainThreadHooks } from '../../core/hooks/mainThreadImpl.js';
+import { updateCardData } from '../../core/lynx-update-data.js';
+import { installElementTemplateCommitHook } from '../background/commit-hook.js';
+import { setupBackgroundElementTemplateDocument } from '../background/document.js';
+import { installElementTemplateHydrationListener } from '../background/hydration-listener.js';
+import { BackgroundElementTemplateInstance } from '../background/instance.js';
+import { initElementTemplatePAPICallAlog } from '../debug/elementPAPICall.js';
+import { initProfileHook } from '../debug/profile.js';
+import { setupLynxEnv } from '../lynx/env.js';
+import { initTimingAPI } from '../lynx/performance.js';
+import { publicComponentEvent, publishEvent, resetEventStateForRuntime } from '../prop-adapters/event.js';
+import { __root, setRoot } from '../runtime/page/root-instance.js';
+function forceRootRender() {
+    runWithForceRootRender({
+        getRootVNode: () => __root.__jsx,
+        setRootVNode: (vnode) => {
+            // @ts-expect-error: __root.__jsx is a Preact VNode during background force render.
+            __root.__jsx = vnode;
+        },
+        render: () => {
+            render(__root.__jsx, __root);
+        },
+    });
+}
+const updateGlobalPropsOptions = {
+    forceRerender: forceRootRender,
+};
+function updateGlobalProps(newData) {
+    updateGlobalPropsCore(newData, updateGlobalPropsOptions);
+}
+function init() {
+    if (typeof __ALOG_ELEMENT_API__ !== 'undefined' && __ALOG_ELEMENT_API__) {
+        initElementTemplatePAPICallAlog();
+    }
+    if (__MAIN_THREAD__) {
+        installMainThreadHooks();
+        injectCalledByNative();
+        installElementTemplatePatchListener();
+        installOnMtsDestruction();
+        if (__PROFILE__) {
+            initProfileHook();
+        }
+    }
+    if (__BACKGROUND__) {
+        console.log('experimental_useElementTemplate:', __USE_ELEMENT_TEMPLATE__);
+        setRoot(new BackgroundElementTemplateInstance('root'));
+        setupBackgroundElementTemplateDocument();
+        installElementTemplateHydrationListener();
+        resetEventStateForRuntime();
+        lynxCoreInject.tt.callDestroyLifetimeFun = callDestroyLifetimeFun;
+        lynxCoreInject.tt.publishEvent = publishEvent;
+        lynxCoreInject.tt.publicComponentEvent = publicComponentEvent;
+        lynxCoreInject.tt.updateGlobalProps = updateGlobalProps;
+        lynxCoreInject.tt.updateCardData = updateCardData;
+        lynxCoreInject.tt.onAppReload = reloadBackground;
+        installElementTemplateCommitHook();
+        if (process.env['NODE_ENV'] !== 'test') {
+            initTimingAPI();
+            if (lynx.performance?.isProfileRecording?.()) {
+                initProfileHook();
+            }
+        }
+    }
+    setupLynxEnv();
+}
+init();
+//# sourceMappingURL=index.js.map

package/runtime/lib/element-template/native/index.js.map

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

package/runtime/lib/element-template/native/main-thread-api.d.ts

@@ -0,0 +1,2 @@
+declare function injectCalledByNative(): void;
+export {};

package/runtime/lib/element-template/native/main-thread-api.js

@@ -0,0 +1,49 @@
+// 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 { reloadMainThread } from './reload.js';
+import { applyUpdatePageData } from '../../core/lynx-page-data.js';
+import { __page, createElementTemplatePage, setupPage } from '../runtime/page/page.js';
+import { renderMainThread, resetMainThreadRootRefs } from '../runtime/render/render-main-thread.js';
+function injectCalledByNative() {
+    const calledByNative = {
+        renderPage,
+        updatePage,
+        updateGlobalProps,
+        getPageData: function () {
+            return null;
+        },
+        removeComponents: function () { },
+    };
+    Object.assign(globalThis, calledByNative);
+}
+function renderPage(data) {
+    lynx.__initData = data ?? {};
+    setupPage(createElementTemplatePage());
+    resetMainThreadRootRefs();
+    renderMainThread();
+}
+function updatePage(data, options) {
+    if (__FIRST_SCREEN_SYNC_TIMING__ !== 'immediately') {
+        return;
+    }
+    if (options?.reloadTemplate) {
+        reloadMainThread(data, options);
+        return;
+    }
+    applyUpdatePageData(data, options);
+    __FlushElementTree(__page, options ?? {});
+}
+function updateGlobalProps(_data, options) {
+    if (options) {
+        __FlushElementTree(__page, options);
+    }
+    else {
+        __FlushElementTree();
+    }
+}
+/**
+ * @internal
+ */
+export { injectCalledByNative };
+//# sourceMappingURL=main-thread-api.js.map

package/runtime/lib/element-template/native/main-thread-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-thread-api.js","sourceRoot":"","sources":["../../../src/element-template/native/main-thread-api.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAEpG,SAAS,oBAAoB;IAC3B,MAAM,cAAc,GAAqB;QACvC,UAAU;QACV,UAAU;QACV,iBAAiB;QACjB,WAAW,EAAE;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QACD,gBAAgB,EAAE,cAAkB,CAAC;KACtC,CAAC;IAEF,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,UAAU,CAAC,IAAyC;IAC3D,IAAI,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;IAC7B,SAAS,CAAC,yBAAyB,EAAE,CAAC,CAAC;IACvC,uBAAuB,EAAE,CAAC;IAC1B,gBAAgB,EAAE,CAAC;AACrB,CAAC;AAED,SAAS,UAAU,CAAC,IAAyC,EAAE,OAA0B;IACvF,IAAI,4BAA4B,KAAK,aAAa,EAAE,CAAC;QACnD,OAAO;IACT,CAAC;IAED,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;QAC5B,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAChC,OAAO;IACT,CAAC;IAED,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,kBAAkB,CAAC,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc,EAAE,OAA0B;IACnE,IAAI,OAAO,EAAE,CAAC;QACZ,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,kBAAkB,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/runtime/lib/element-template/native/mts-destroy.d.ts

@@ -0,0 +1,3 @@
+export declare function installOnMtsDestruction(): void;
+export declare function onMtsDestruction(): void;
+export declare function destroyElementTemplateMainThreadRuntime(): void;

package/runtime/lib/element-template/native/mts-destroy.js

@@ -0,0 +1,37 @@
+// 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 { resetElementTemplatePatchListener } from './patch-listener.js';
+import { elementTemplateRegistry } from '../runtime/template/registry.js';
+export function installOnMtsDestruction() {
+    lynx.getNative?.().addEventListener('__DestroyLifetime', onMtsDestruction);
+}
+export function onMtsDestruction() {
+    const performance = lynx.performance;
+    performance?.profileStart?.('ReactLynx::onMtsDestruction');
+    try {
+        destroyElementTemplateMainThreadRuntime();
+    }
+    finally {
+        performance?.profileEnd?.();
+        lynx.getNative?.().removeEventListener('__DestroyLifetime', onMtsDestruction);
+    }
+}
+export function destroyElementTemplateMainThreadRuntime() {
+    let patchListenerResetError;
+    let didPatchListenerResetThrow = false;
+    try {
+        resetElementTemplatePatchListener();
+    }
+    catch (error) {
+        patchListenerResetError = error;
+        didPatchListenerResetThrow = true;
+    }
+    // The registry is the main-thread strong-reference owner for ET refs. Clear it
+    // even if listener reset fails so destroy does not leave removed pages retained.
+    elementTemplateRegistry.clear();
+    if (didPatchListenerResetThrow) {
+        throw patchListenerResetError;
+    }
+}
+//# sourceMappingURL=mts-destroy.js.map

package/runtime/lib/element-template/native/mts-destroy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mts-destroy.js","sourceRoot":"","sources":["../../../src/element-template/native/mts-destroy.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,MAAM,UAAU,uBAAuB;IACrC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACrC,WAAW,EAAE,YAAY,EAAE,CAAC,6BAA6B,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,uCAAuC,EAAE,CAAC;IAC5C,CAAC;YAAS,CAAC;QACT,WAAW,EAAE,UAAU,EAAE,EAAE,CAAC;QAC5B,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,mBAAmB,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CAAC;IAChF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uCAAuC;IACrD,IAAI,uBAAgC,CAAC;IACrC,IAAI,0BAA0B,GAAG,KAAK,CAAC;IACvC,IAAI,CAAC;QACH,iCAAiC,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,uBAAuB,GAAG,KAAK,CAAC;QAChC,0BAA0B,GAAG,IAAI,CAAC;IACpC,CAAC;IAED,+EAA+E;IAC/E,iFAAiF;IACjF,uBAAuB,CAAC,KAAK,EAAE,CAAC;IAEhC,IAAI,0BAA0B,EAAE,CAAC;QAC/B,MAAM,uBAAuB,CAAC;IAChC,CAAC;AACH,CAAC"}

package/runtime/lib/element-template/native/patch-listener.d.ts

@@ -0,0 +1,2 @@
+export declare function installElementTemplatePatchListener(): void;
+export declare function resetElementTemplatePatchListener(): void;

package/runtime/lib/element-template/native/patch-listener.js

@@ -0,0 +1,70 @@
+// 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 { getReloadVersion } from '../../core/reload-version.js';
+import { formatElementTemplateUpdateCommands } from '../debug/alog.js';
+import { markTiming, setPipeline } from '../lynx/performance.js';
+import { ElementTemplateLifecycleConstant } from '../protocol/lifecycle-constant.js';
+import { __page } from '../runtime/page/page.js';
+import { applyElementTemplateUpdateCommands } from '../runtime/patch.js';
+let listener;
+export function installElementTemplatePatchListener() {
+    resetElementTemplatePatchListener();
+    listener = (event) => {
+        const { data } = event;
+        const payload = data;
+        if (typeof payload?.reloadVersion === 'number' && payload.reloadVersion < getReloadVersion()) {
+            return;
+        }
+        const hasOps = Array.isArray(payload?.ops) && payload.ops.length > 0;
+        const flushOptions = payload?.flushOptions ?? {};
+        const pipelineOptions = flushOptions.pipelineOptions;
+        setPipeline(pipelineOptions);
+        const flowIds = Array.isArray(payload?.flowIds) && payload.flowIds.length > 0
+            ? payload.flowIds
+            : undefined;
+        const shouldProfilePatch = hasOps
+            && !!flowIds
+            && typeof lynx.performance?.profileStart === 'function'
+            && typeof lynx.performance?.profileEnd === 'function';
+        if (shouldProfilePatch) {
+            lynx.performance.profileStart('ReactLynx::patch', {
+                flowId: flowIds[0],
+                flowIds,
+            });
+        }
+        if (hasOps) {
+            if (typeof __ALOG__ !== 'undefined' && __ALOG__) {
+                console.alog?.('[ReactLynxDebug] ElementTemplate main-thread patch:\n'
+                    + JSON.stringify({
+                        ops: formatElementTemplateUpdateCommands(payload.ops),
+                        flushOptions,
+                        flowIds,
+                    }, null, 2));
+            }
+            markTiming('mtsRenderStart');
+            markTiming('parseChangesStart');
+            markTiming('parseChangesEnd');
+            markTiming('patchChangesStart');
+            try {
+                applyElementTemplateUpdateCommands(payload.ops);
+            }
+            finally {
+                markTiming('patchChangesEnd');
+                markTiming('mtsRenderEnd');
+            }
+        }
+        __FlushElementTree(__page, flushOptions);
+        if (shouldProfilePatch) {
+            lynx.performance.profileEnd();
+        }
+    };
+    lynx.getJSContext().addEventListener(ElementTemplateLifecycleConstant.update, listener);
+}
+export function resetElementTemplatePatchListener() {
+    if (listener) {
+        lynx.getJSContext().removeEventListener(ElementTemplateLifecycleConstant.update, listener);
+    }
+    listener = undefined;
+}
+//# sourceMappingURL=patch-listener.js.map

package/runtime/lib/element-template/native/patch-listener.js.map

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

package/runtime/lib/element-template/native/reload.d.ts

@@ -0,0 +1,2 @@
+export declare function reloadMainThread(data: unknown, options: UpdatePageOption): void;
+export declare function reloadBackground(updateData: unknown): void;

package/runtime/lib/element-template/native/reload.js

@@ -0,0 +1,64 @@
+// 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 { render } from 'preact';
+import { applyUpdatePageData } from '../../core/lynx-page-data.js';
+import { increaseReloadVersion } from '../../core/reload-version.js';
+import { destroyElementTemplateBackgroundRuntime } from '../background/destroy.js';
+import { setupBackgroundElementTemplateDocument } from '../background/document.js';
+import { installElementTemplateHydrationListener } from '../background/hydration-listener.js';
+import { BackgroundElementTemplateInstance } from '../background/instance.js';
+import { profileEnd, profileStart } from '../debug/profile.js';
+import { resetEventStateForRuntime } from '../prop-adapters/event.js';
+import { __page } from '../runtime/page/page.js';
+import { __root, setRoot } from '../runtime/page/root-instance.js';
+import { removeMainThreadRootRefs, renderMainThread } from '../runtime/render/render-main-thread.js';
+import { resetTemplateId } from '../runtime/template/handle.js';
+import { elementTemplateRegistry } from '../runtime/template/registry.js';
+export function reloadMainThread(data, options) {
+    if (typeof __PROFILE__ !== 'undefined' && __PROFILE__) {
+        profileStart('ReactLynx::reloadMainThread');
+    }
+    try {
+        increaseReloadVersion();
+        applyUpdatePageData(data, options);
+        elementTemplateRegistry.clear();
+        resetTemplateId();
+        const oldRoot = __root;
+        removeMainThreadRootRefs();
+        setRoot({ __jsx: oldRoot.__jsx });
+        renderMainThread();
+        __FlushElementTree(__page, options);
+    }
+    finally {
+        if (typeof __PROFILE__ !== 'undefined' && __PROFILE__) {
+            profileEnd();
+        }
+    }
+}
+export function reloadBackground(updateData) {
+    if (typeof __PROFILE__ !== 'undefined' && __PROFILE__) {
+        profileStart('ReactLynx::reloadBackground');
+    }
+    try {
+        const jsx = __root.__jsx;
+        destroyElementTemplateBackgroundRuntime();
+        increaseReloadVersion();
+        // Reload creates a new object so InitData Provider / Consumer observers do
+        // not retain the pre-reload object identity.
+        lynx.__initData = Object.assign({}, lynx.__initData);
+        applyUpdatePageData(updateData);
+        setRoot(new BackgroundElementTemplateInstance('root'));
+        __root.__jsx = jsx;
+        setupBackgroundElementTemplateDocument();
+        installElementTemplateHydrationListener();
+        resetEventStateForRuntime();
+        render(jsx, __root);
+    }
+    finally {
+        if (typeof __PROFILE__ !== 'undefined' && __PROFILE__) {
+            profileEnd();
+        }
+    }
+}
+//# sourceMappingURL=reload.js.map

package/runtime/lib/element-template/native/reload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload.js","sourceRoot":"","sources":["../../../src/element-template/native/reload.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAG1D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,uCAAuC,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,sCAAsC,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,uCAAuC,EAAE,MAAM,qCAAqC,CAAC;AAC9F,OAAO,EAAE,iCAAiC,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AACrG,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,MAAM,UAAU,gBAAgB,CAAC,IAAa,EAAE,OAAyB;IACvE,IAAI,OAAO,WAAW,KAAK,WAAW,IAAI,WAAW,EAAE,CAAC;QACtD,YAAY,CAAC,6BAA6B,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC;QACH,qBAAqB,EAAE,CAAC;QACxB,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAEnC,uBAAuB,CAAC,KAAK,EAAE,CAAC;QAChC,eAAe,EAAE,CAAC;QAElB,MAAM,OAAO,GAAG,MAAM,CAAC;QACvB,wBAAwB,EAAE,CAAC;QAC3B,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAClC,gBAAgB,EAAE,CAAC;QAEnB,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,WAAW,KAAK,WAAW,IAAI,WAAW,EAAE,CAAC;YACtD,UAAU,EAAE,CAAC;QACf,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAmB;IAClD,IAAI,OAAO,WAAW,KAAK,WAAW,IAAI,WAAW,EAAE,CAAC;QACtD,YAAY,CAAC,6BAA6B,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC;QACzB,uCAAuC,EAAE,CAAC;QAC1C,qBAAqB,EAAE,CAAC;QACxB,2EAA2E;QAC3E,6CAA6C;QAC7C,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACrD,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAEhC,OAAO,CAAC,IAAI,iCAAiC,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;QACnB,sCAAsC,EAAE,CAAC;QACzC,uCAAuC,EAAE,CAAC;QAC1C,yBAAyB,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAqB,EAAE,MAAkC,CAAC,CAAC;IACpE,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,WAAW,KAAK,WAAW,IAAI,WAAW,EAAE,CAAC;YACtD,UAAU,EAAE,CAAC;QACf,CAAC;IACH,CAAC;AACH,CAAC"}

package/runtime/lib/element-template/prop-adapters/event-value.d.ts

@@ -0,0 +1 @@
+export declare function getEventValue(handleId: number, attrSlotIndex: number, eventKey?: string): string;

package/runtime/lib/element-template/prop-adapters/event-value.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.
+export function getEventValue(handleId, attrSlotIndex, eventKey = '') {
+    return `${handleId}:${attrSlotIndex}:${eventKey}`;
+}
+//# sourceMappingURL=event-value.js.map

package/runtime/lib/element-template/prop-adapters/event-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-value.js","sourceRoot":"","sources":["../../../src/element-template/prop-adapters/event-value.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,aAAqB,EACrB,QAAQ,GAAG,EAAE;IAEb,OAAO,GAAG,QAAQ,IAAI,aAAa,IAAI,QAAQ,EAAE,CAAC;AACpD,CAAC"}

package/runtime/lib/element-template/prop-adapters/event.d.ts

@@ -0,0 +1,8 @@
+export type EtEventHandler = (data: EventDataType) => unknown;
+export declare function clearEventState(): void;
+export declare function clearPendingEvents(): void;
+export declare function resetEventStateForRuntime(): void;
+export declare function getEventHandlerForEventValue(eventValue: string): EtEventHandler | undefined;
+export declare function publishEvent(eventValue: string, data: EventDataType): void;
+export declare function publicComponentEvent(_componentId: string, eventValue: string, data: EventDataType): void;
+export declare function flushPendingEvents(): void;

package/runtime/lib/element-template/prop-adapters/event.js

@@ -0,0 +1,64 @@
+// 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 { backgroundElementTemplateInstanceManager } from '../background/manager.js';
+const pendingEvents = [];
+let queuePendingEvents = false;
+function dispatchEvent(eventValue, data) {
+    const handler = backgroundElementTemplateInstanceManager.getRawAttributeValueByEventValue(eventValue);
+    if (typeof __ALOG__ !== 'undefined' && __ALOG__) {
+        console.alog?.(`[ReactLynxDebug] ElementTemplate BTS received event:\n${JSON.stringify({
+            eventValue,
+            type: data.type,
+            jsFunctionName: typeof handler === 'function' ? handler.name : '',
+            hasHandler: typeof handler === 'function',
+        }, null, 2)}`);
+    }
+    if (typeof handler !== 'function') {
+        return false;
+    }
+    try {
+        handler(data);
+    }
+    catch (error) {
+        lynx.reportError(error);
+    }
+    return true;
+}
+export function clearEventState() {
+    clearPendingEvents();
+    queuePendingEvents = false;
+}
+export function clearPendingEvents() {
+    pendingEvents.length = 0;
+}
+export function resetEventStateForRuntime() {
+    clearEventState();
+    queuePendingEvents = true;
+}
+export function getEventHandlerForEventValue(eventValue) {
+    const handler = backgroundElementTemplateInstanceManager.getRawAttributeValueByEventValue(eventValue);
+    return typeof handler === 'function' ? handler : undefined;
+}
+export function publishEvent(eventValue, data) {
+    if (dispatchEvent(eventValue, data)) {
+        return;
+    }
+    if (queuePendingEvents) {
+        pendingEvents.push([eventValue, data]);
+    }
+}
+export function publicComponentEvent(_componentId, eventValue, data) {
+    publishEvent(eventValue, data);
+}
+export function flushPendingEvents() {
+    queuePendingEvents = false;
+    if (pendingEvents.length === 0) {
+        return;
+    }
+    const events = pendingEvents.splice(0);
+    for (const [eventValue, data] of events) {
+        dispatchEvent(eventValue, data);
+    }
+}
+//# sourceMappingURL=event.js.map

package/runtime/lib/element-template/prop-adapters/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../src/element-template/prop-adapters/event.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,OAAO,EAAE,wCAAwC,EAAE,MAAM,0BAA0B,CAAC;AAIpF,MAAM,aAAa,GAAqD,EAAE,CAAC;AAC3E,IAAI,kBAAkB,GAAG,KAAK,CAAC;AAE/B,SAAS,aAAa,CAAC,UAAkB,EAAE,IAAmB;IAC5D,MAAM,OAAO,GAAG,wCAAwC,CAAC,gCAAgC,CAAC,UAAU,CAAC,CAAC;IACtG,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,EAAE,CAAC;QAChD,OAAO,CAAC,IAAI,EAAE,CACZ,yDACE,IAAI,CAAC,SAAS,CACZ;YACE,UAAU;YACV,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,cAAc,EAAE,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;YACjE,UAAU,EAAE,OAAO,OAAO,KAAK,UAAU;SAC1C,EACD,IAAI,EACJ,CAAC,CAEL,EAAE,CACH,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACF,OAA0B,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,WAAW,CAAC,KAAc,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,kBAAkB,EAAE,CAAC;IACrB,kBAAkB,GAAG,KAAK,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,eAAe,EAAE,CAAC;IAClB,kBAAkB,GAAG,IAAI,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,UAAkB;IAC7D,MAAM,OAAO,GAAG,wCAAwC,CAAC,gCAAgC,CAAC,UAAU,CAAC,CAAC;IACtG,OAAO,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAE,OAA0B,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,IAAmB;IAClE,IAAI,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO;IACT,CAAC;IACD,IAAI,kBAAkB,EAAE,CAAC;QACvB,aAAa,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,YAAoB,EACpB,UAAkB,EAClB,IAAmB;IAEnB,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,kBAAkB,GAAG,KAAK,CAAC;IAC3B,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACvC,KAAK,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;QACxC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;AACH,CAAC"}

package/runtime/lib/element-template/prop-adapters/ref.d.ts

@@ -0,0 +1,26 @@
+import { SelectorRefProxy } from '../../core/ref.js';
+import type { OrdinaryRef, RefProxyForwardedMethods } from '../../core/ref.js';
+import type { SerializableValue } from '../protocol/types.js';
+export type EtRef = OrdinaryRef<ElementTemplateRefProxy>;
+export declare function getRefValue(handleId: number, attrSlotIndex: number): string;
+export declare function flushDelayedRefUiOps(): void;
+export declare function clearDelayedRefUiOps(): void;
+export declare class ElementTemplateRefProxy extends SelectorRefProxy<ElementTemplateRefProxy> {
+    private readonly handleId;
+    private readonly attrSlotIndex;
+    constructor(handleId: number, attrSlotIndex: number);
+    protected createProxyTarget(): ElementTemplateRefProxy;
+    protected runOrDelay(task: () => void): void;
+    get selector(): string;
+}
+export interface ElementTemplateRefProxy extends RefProxyForwardedMethods<ElementTemplateRefProxy> {
+}
+export declare function getRefFromValue(value: unknown): EtRef | null;
+export declare function getSpreadRefFromValue(value: unknown): EtRef | null | undefined;
+export declare function prepareRefAttrSlot(handleId: number, attrSlotIndex: number, value: unknown): SerializableValue | null;
+export declare function prepareSpreadRefAttrValue(handleId: number, attrSlotIndex: number, value: unknown): SerializableValue | null | undefined;
+export declare function queueRefAttrUpdate(oldValue: unknown, newValue: unknown, handleId: number, attrSlotIndex: number): void;
+export declare function flushPendingRefs(): void;
+export declare function clearPendingRefs(): void;
+export declare function hasPendingRefs(): boolean;
+export declare function clearRefState(): void;