@lynx-js/react 0.120.0 → 0.121.0

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":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGjC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE,MAAM,qBAAqB,GAAG;IAC5B,uBAAuB;IACvB,qBAAqB;IACrB,mBAAmB;IACnB,iFAAiF;IACjF,eAAe;IACf,aAAa;IACb,kBAAkB;IAClB,gBAAgB;IAChB,mBAAmB;IACnB,iBAAiB;IACjB,mBAAmB;IACnB,iBAAiB;IACjB,0BAA0B;IAC1B,wBAAwB;IACxB,gBAAgB;IAChB,cAAc;CACN,CAAC;AAEX,MAAM,sBAAsB,GAAG;IAC7B,gBAAgB,EAAE,oBAAoB;CAC9B,CAAC;AAEX,MAAM,eAAe,GAAG;IACtB,gBAAgB,EAAE,kBAAkB;IACpC,oBAAoB,EAAE,sBAAsB;CACpC,CAAC;AAIX;;GAEG;AACH,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAC7C,IAAI,UAA8B,CAAC;AACnC,IAAI,uBAAuB,GAAG,KAAK,CAAC;AACpC,IAAI,qBAAqB,GAAG,KAAK,CAAC;AAElC,IAAI,qBAAkD,CAAC;AAEvD;;GAEG;AACH,SAAS,gBAAgB,CAAC,GAAyC,EAAE,WAAoB;IACvF,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,uBAAuB,CAAC,CAAC,CAAC;YAC7B,uBAAuB,GAAG,IAAI,CAAC;YAC/B,qBAAqB,GAAG,IAAI,CAAC;YAC7B,UAAU,GAAG,WAAW,CAAC;YACzB,MAAM;QACR,CAAC;QACD,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC,uBAAuB,EAAE,CAAC;gBAC7B,OAAO;YACT,CAAC;YACD,uBAAuB,GAAG,KAAK,CAAC;YAChC,MAAM;QACR,CAAC;QACD,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBAC3B,OAAO;YACT,CAAC;YACD,qBAAqB,GAAG,KAAK,CAAC;YAC9B,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC,UAAW,EAAE,GAAG,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,aAAa,CAAC,cAAuB,EAAE,cAA8B,EAAE,UAAmB;IACjG,qBAAqB,GAAG,IAAI,CAAC,WAAW,EAAE,wBAAwB,EAAE,EAAE,CAAC;IACvE,IAAI,qBAAqB,EAAE,CAAC;QAC1B,qBAAqB,CAAC,cAAc,GAAG,cAAc,CAAC;QACtD,qBAAqB,CAAC,cAAc,GAAG,cAAc,CAAC;QACtD,qBAAqB,CAAC,GAAG,GAAG,WAAW,CAAC;QACxC,QAAQ,cAAc,EAAE,CAAC;YACvB,KAAK,eAAe,CAAC,gBAAgB;gBACnC,qBAAqB,CAAC,KAAK,GAAG,SAAS,CAAC;gBACxC,MAAM;YACR,KAAK,eAAe,CAAC,oBAAoB;gBACvC,qBAAqB,CAAC,KAAK,GAAG,QAAQ,CAAC;gBACvC,MAAM;QACV,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,gBAAgB,EAAE,CAAC,qBAAqB,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;QAC9F,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,EAAE,6BAA6B,EAAE,CAAC,qBAAqB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAClG,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,QAAqC;IACxD,qBAAqB,GAAG,QAAQ,CAAC;AACnC,CAAC;AAED,SAAS,UAAU,CAAC,YAAkD,EAAE,KAAe;IACrF,IAAI,qBAAqB,IAAI,CAAC,KAAK,IAAI,qBAAqB,CAAC,cAAc,CAAC,EAAE,CAAC;QAC7E,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,qBAAqB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB;IAChC,OAAO,mBAAmB,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,aAAa;IACpB,+DAA+D;IAC/D,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,6DAA6D;QAC7D,IAAI,MAAM,IAAI,yBAAyB,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBAC3B,aAAa,CAAC,KAAK,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;gBAC3D,UAAU,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;YACpC,CAAC;YACD,IAAI,uBAAuB,EAAE,CAAC;gBAC5B,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC,GAAG,EAAE,KAAY,EAAE,CAAC,EAAE,EAAE;QACvD,MAAM,EAAE,CAAC;QACT,qBAAqB;QACrB,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAChB,CAAC;QACD,oBAAoB;IACtB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,KAAY,EAAE,SAAS,EAAE,EAAE;QACnD,MAAM,EAAE,CAAC;QACT,qBAAqB;QACrB,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACxB,CAAC;QACD,oBAAoB;IACtB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,UAAU,EACV,WAAW,EACX,qBAAqB,GACtB,CAAC"}

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 '../hooks/react.js';

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

@@ -0,0 +1,53 @@
+// 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 '../hooks/react.js';
+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 { installMainThreadHooks } from '../../core/hooks/mainThreadImpl.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 { setRoot } from '../runtime/page/root-instance.js';
+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;
+        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":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,mBAAmB,CAAC;AAC3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,mCAAmC,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAChF,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,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC1G,OAAO,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAE3D,SAAS,IAAI;IACX,IAAI,OAAO,oBAAoB,KAAK,WAAW,IAAI,oBAAoB,EAAE,CAAC;QACxE,+BAA+B,EAAE,CAAC;IACpC,CAAC;IAED,IAAI,eAAe,EAAE,CAAC;QACpB,sBAAsB,EAAE,CAAC;QACzB,oBAAoB,EAAE,CAAC;QACvB,mCAAmC,EAAE,CAAC;QACtC,uBAAuB,EAAE,CAAC;QAC1B,IAAI,WAAW,EAAE,CAAC;YAChB,eAAe,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,wBAAwB,CAAC,CAAC;QAC1E,OAAO,CAAC,IAAI,iCAAiC,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,sCAAsC,EAAE,CAAC;QACzC,uCAAuC,EAAE,CAAC;QAC1C,yBAAyB,EAAE,CAAC;QAC5B,cAAc,CAAC,EAAE,CAAC,sBAAsB,GAAG,sBAAsB,CAAC;QAClE,cAAc,CAAC,EAAE,CAAC,YAAY,GAAG,YAAY,CAAC;QAC9C,cAAc,CAAC,EAAE,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;QAC9D,gCAAgC,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,MAAM,EAAE,CAAC;YACvC,aAAa,EAAE,CAAC;YAChB,IAAI,IAAI,CAAC,WAAW,EAAE,kBAAkB,EAAE,EAAE,EAAE,CAAC;gBAC7C,eAAe,EAAE,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED,YAAY,EAAE,CAAC;AACjB,CAAC;AAED,IAAI,EAAE,CAAC"}

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,27 @@
+// Copyright 2024 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import { setupPage } from '../runtime/page/page.js';
+import { renderMainThread } from '../runtime/render/render-main-thread.js';
+function injectCalledByNative() {
+    const calledByNative = {
+        renderPage,
+        updatePage: function () { },
+        updateGlobalProps: function () { },
+        getPageData: function () {
+            return null;
+        },
+        removeComponents: function () { },
+    };
+    Object.assign(globalThis, calledByNative);
+}
+function renderPage(data) {
+    lynx.__initData = data ?? {};
+    setupPage(__CreatePage('0', 0));
+    renderMainThread();
+}
+/**
+ * @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,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAE3E,SAAS,oBAAoB;IAC3B,MAAM,cAAc,GAAqB;QACvC,UAAU;QACV,UAAU,EAAE,cAAkB,CAAC;QAC/B,iBAAiB,EAAE,cAAkB,CAAC;QACtC,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,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAChC,gBAAgB,EAAE,CAAC;AACrB,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,66 @@
+// 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 { 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;
+        const hasOps = Array.isArray(payload?.ops);
+        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/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,7 @@
+export type EtEventHandler = (data: EventDataType) => unknown;
+export declare function clearEventState(): 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,61 @@
+// 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() {
+    pendingEvents.length = 0;
+    queuePendingEvents = false;
+}
+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,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;IACzB,kBAAkB,GAAG,KAAK,CAAC;AAC7B,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/spread.d.ts

@@ -0,0 +1,5 @@
+import type { SerializableValue } from '../protocol/types.js';
+export interface SpreadAttrAdapterContext {
+    previousPreparedValue?: unknown;
+}
+export declare function prepareSpreadAttrSlot(handleId: number, attrSlotIndex: number, value: unknown, _context?: SpreadAttrAdapterContext): SerializableValue | null;

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

@@ -0,0 +1,45 @@
+// 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 { getEventValue } from './event-value.js';
+const eventPropKeyRegExp = /^(?:global-bind|bind|catch|capture-bind|capture-catch)[A-Za-z]+$/;
+const namespacedEventKeyRegExp = /^[A-Za-z-]+:(?:global-bind|bind|catch|capture-bind|capture-catch)[A-Za-z]+$/;
+function isEventPropKey(key) {
+    return eventPropKeyRegExp.test(key);
+}
+function isSpreadRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+export function prepareSpreadAttrSlot(handleId, attrSlotIndex, value, _context) {
+    if (value === false || !isSpreadRecord(value)) {
+        return null;
+    }
+    const prepared = {};
+    for (const key in value) {
+        const spreadValue = value[key];
+        if (key === '__spread' || key === '__self' || key === '__source') {
+            continue;
+        }
+        if (key === 'class' || key === 'className') {
+            prepared['class'] = (spreadValue ?? '');
+            continue;
+        }
+        if (isEventPropKey(key)) {
+            prepared[key] = spreadValue === null || spreadValue === undefined || spreadValue === false
+                ? null
+                : getEventValue(handleId, attrSlotIndex, key);
+            continue;
+        }
+        if (spreadValue === undefined
+            || key === 'ref'
+            || key.endsWith(':ref')
+            || key.endsWith(':gesture')
+            || namespacedEventKeyRegExp.test(key)
+            || typeof spreadValue === 'function') {
+            continue;
+        }
+        prepared[key] = spreadValue;
+    }
+    return prepared;
+}
+//# sourceMappingURL=spread.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spread.js","sourceRoot":"","sources":["../../../src/element-template/prop-adapters/spread.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOjD,MAAM,kBAAkB,GAAG,kEAAkE,CAAC;AAC9F,MAAM,wBAAwB,GAAG,6EAA6E,CAAC;AAE/G,SAAS,cAAc,CAAC,GAAW;IACjC,OAAO,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,aAAqB,EACrB,KAAc,EACd,QAAmC;IAEnC,IAAI,KAAK,KAAK,KAAK,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAsC,EAAE,CAAC;IAEvD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YACjE,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YAC3C,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAsB,CAAC;YAC7D,SAAS;QACX,CAAC;QAED,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,QAAQ,CAAC,GAAG,CAAC,GAAG,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,KAAK;gBACxF,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;YAChD,SAAS;QACX,CAAC;QAED,IACE,WAAW,KAAK,SAAS;eACtB,GAAG,KAAK,KAAK;eACb,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;eACpB,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC;eACxB,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC;eAClC,OAAO,WAAW,KAAK,UAAU,EACpC,CAAC;YACD,SAAS;QACX,CAAC;QAED,QAAQ,CAAC,GAAG,CAAC,GAAG,WAAgC,CAAC;IACnD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/runtime/lib/element-template/protocol/lifecycle-constant.d.ts

@@ -0,0 +1,4 @@
+export declare const enum ElementTemplateLifecycleConstant {
+    hydrate = "rLynxElementTemplateHydrate",
+    update = "rLynxElementTemplateUpdate"
+}

package/runtime/lib/element-template/protocol/lifecycle-constant.js

@@ -0,0 +1,9 @@
+// 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.
+export var ElementTemplateLifecycleConstant;
+(function (ElementTemplateLifecycleConstant) {
+    ElementTemplateLifecycleConstant["hydrate"] = "rLynxElementTemplateHydrate";
+    ElementTemplateLifecycleConstant["update"] = "rLynxElementTemplateUpdate";
+})(ElementTemplateLifecycleConstant || (ElementTemplateLifecycleConstant = {}));
+//# sourceMappingURL=lifecycle-constant.js.map

package/runtime/lib/element-template/protocol/lifecycle-constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-constant.js","sourceRoot":"","sources":["../../../src/element-template/protocol/lifecycle-constant.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,MAAM,CAAN,IAAkB,gCAGjB;AAHD,WAAkB,gCAAgC;IAChD,2EAAuC,CAAA;IACvC,yEAAqC,CAAA;AACvC,CAAC,EAHiB,gCAAgC,KAAhC,gCAAgC,QAGjD"}

package/runtime/lib/element-template/protocol/opcodes.d.ts

@@ -0,0 +1,7 @@
+export declare const ElementTemplateUpdateOps: {
+    readonly createTemplate: 1;
+    readonly setAttribute: 2;
+    readonly insertNode: 3;
+    readonly removeNode: 4;
+};
+export type ElementTemplateUpdateOp = typeof ElementTemplateUpdateOps[keyof typeof ElementTemplateUpdateOps];

package/runtime/lib/element-template/protocol/opcodes.js

@@ -0,0 +1,10 @@
+// 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 const ElementTemplateUpdateOps = {
+    createTemplate: 1,
+    setAttribute: 2,
+    insertNode: 3,
+    removeNode: 4,
+};
+//# sourceMappingURL=opcodes.js.map

package/runtime/lib/element-template/protocol/opcodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opcodes.js","sourceRoot":"","sources":["../../../src/element-template/protocol/opcodes.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,cAAc,EAAE,CAAC;IACjB,YAAY,EAAE,CAAC;IACf,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,CAAC;CACL,CAAC"}

package/runtime/lib/element-template/protocol/types.d.ts

@@ -0,0 +1,50 @@
+import { ElementTemplateUpdateOps } from './opcodes.js';
+export type SerializableValue = string | number | boolean | null | SerializableValue[] | {
+    [key: string]: SerializableValue;
+};
+export type RuntimeOptions = Record<string, SerializableValue>;
+export interface SerializedElementTemplate {
+    templateKey: string;
+    bundleUrl?: string;
+    attributeSlots?: SerializableValue[] | null;
+    elementSlots?: SerializedElementTemplate[][] | null;
+    uid: number | string;
+}
+export type CreateTemplateCommand = [
+    typeof ElementTemplateUpdateOps.createTemplate,
+    handleId: number,
+    templateKey: string,
+    bundleUrl: string | null | undefined,
+    attributeSlots: SerializableValue[] | null | undefined,
+    elementSlots: number[][] | null | undefined
+];
+export type SetAttributeCommand = [
+    typeof ElementTemplateUpdateOps.setAttribute,
+    targetHandleId: number,
+    attrSlotIndex: number,
+    value: SerializableValue | null
+];
+export type InsertNodeCommand = [
+    typeof ElementTemplateUpdateOps.insertNode,
+    targetHandleId: number,
+    elementSlotIndex: number,
+    childHandleId: number,
+    referenceHandleId: number
+];
+export type RemoveNodeCommand = [
+    typeof ElementTemplateUpdateOps.removeNode,
+    targetHandleId: number,
+    elementSlotIndex: number,
+    childHandleId: number,
+    removedSubtreeHandleIds: number[]
+];
+export type ElementTemplateUpdateCommand = CreateTemplateCommand | SetAttributeCommand | InsertNodeCommand | RemoveNodeCommand;
+export type ElementTemplateUpdateCommandStream = ElementTemplateUpdateCommand[number][];
+export interface ElementTemplateFlushOptions {
+    pipelineOptions?: PipelineOptions;
+}
+export interface ElementTemplateUpdateCommitContext {
+    ops: ElementTemplateUpdateCommandStream;
+    flushOptions: ElementTemplateFlushOptions;
+    flowIds?: number[];
+}

package/runtime/lib/element-template/protocol/types.js

@@ -0,0 +1,5 @@
+// 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 { ElementTemplateUpdateOps } from './opcodes.js';
+//# sourceMappingURL=types.js.map