@lynx-js/react 0.108.0 → 0.109.0

package/worklet-runtime/lib/bindings/bindings.js

@@ -2,15 +2,19 @@
 // Licensed under the Apache License Version 2.0 that can be found in the
 // LICENSE file in the root directory of this source tree.
 /**
- * Register a worklet function to the `jsFunctionLifecycleManager`.
- * This function mast be called when a worklet context is updated.
+ * This function must be called when a worklet context is updated.
  *
  * @param worklet - The worklet to be updated
- * @param element - The element associated with the worklet
+ * @param oldWorklet - The old worklet context
+ * @param isFirstScreen - Whether it is before the hydration is finished
+ * @param element - The element
  * @internal
  */
-function onWorkletCtxUpdate(worklet, element) {
+function onWorkletCtxUpdate(worklet, oldWorklet, isFirstScreen, element) {
     globalThis.lynxWorkletImpl?._jsFunctionLifecycleManager?.addRef(worklet._execId, worklet);
+    if (isFirstScreen && oldWorklet) {
+        globalThis.lynxWorkletImpl?._hydrateCtx(worklet, oldWorklet);
+    }
     globalThis.lynxWorkletImpl?._eventDelayImpl.runDelayedWorklet(worklet, element);
 }
 /**
@@ -42,12 +46,13 @@ function updateWorkletRefInitValueChanges(patch) {
     }
 }
 /**
- * Clear all delayed worklets to run.
+ * This must be called when the hydration is finished.
  *
  * @internal
  */
-function clearDelayedWorklets() {
-    globalThis.lynxWorkletImpl?._eventDelayImpl.clearDelayedWorklets();
+function onHydrationFinished() {
+    globalThis.lynxWorkletImpl?._runOnBackgroundDelayImpl.runDelayedBackgroundFunctions();
+    globalThis.lynxWorkletImpl?._refImpl.clearFirstScreenWorkletRefMap();
 }
 /**
  * Register a worklet.
@@ -57,5 +62,13 @@ function clearDelayedWorklets() {
 function registerWorklet(type, id, worklet) {
     globalThis.registerWorklet(type, id, worklet);
 }
-export { onWorkletCtxUpdate, runWorkletCtx, updateWorkletRef, updateWorkletRefInitValueChanges, clearDelayedWorklets, registerWorklet, };
+/**
+ * Delay a runOnBackground after hydration.
+ *
+ * @internal
+ */
+function delayRunOnBackground(fnObj, fn) {
+    globalThis.lynxWorkletImpl?._runOnBackgroundDelayImpl.delayRunOnBackground(fnObj, fn);
+}
+export { onWorkletCtxUpdate, runWorkletCtx, updateWorkletRef, updateWorkletRefInitValueChanges, onHydrationFinished, registerWorklet, delayRunOnBackground, };
 //# sourceMappingURL=bindings.js.map

package/worklet-runtime/lib/bindings/bindings.js.map

@@ -1 +1 @@
-{"version":3,"file":"bindings.js","sourceRoot":"","sources":["../../src/bindings/bindings.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAO1D;;;;;;;GAOG;AACH,SAAS,kBAAkB,CAAC,OAAgB,EAAE,OAAoB;IAChE,UAAU,CAAC,eAAe,EAAE,2BAA2B,EAAE,MAAM,CAAC,OAAO,CAAC,OAAQ,EAAE,OAAO,CAAC,CAAC;IAC3F,UAAU,CAAC,eAAe,EAAE,eAAe,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAClF,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,OAAgB,EAAE,MAA0B;IACjE,OAAO,UAAU,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,UAAmC,EAAE,OAA2B;IACxF,UAAU,CAAC,eAAe,EAAE,QAAQ,CAAC,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED;;;;GAIG;AACH,SAAS,gCAAgC,CAAC,KAA2B;IACnE,IAAI,KAAK,EAAE,CAAC;QACV,UAAU,CAAC,eAAe,EAAE,QAAQ,CAAC,gCAAgC,CAAC,KAAK,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,oBAAoB;IAC3B,UAAU,CAAC,eAAe,EAAE,eAAe,CAAC,oBAAoB,EAAE,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,IAAY,EAAE,EAAU,EAAE,OAAiB;IAClE,UAAU,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,gCAAgC,EAChC,oBAAoB,EACpB,eAAe,GAChB,CAAC"}
+{"version":3,"file":"bindings.js","sourceRoot":"","sources":["../../src/bindings/bindings.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAK1D;;;;;;;;GAQG;AACH,SAAS,kBAAkB,CACzB,OAAgB,EAChB,UAAsC,EACtC,aAAsB,EACtB,OAAoB;IAEpB,UAAU,CAAC,eAAe,EAAE,2BAA2B,EAAE,MAAM,CAAC,OAAO,CAAC,OAAQ,EAAE,OAAO,CAAC,CAAC;IAC3F,IAAI,aAAa,IAAI,UAAU,EAAE,CAAC;QAChC,UAAU,CAAC,eAAe,EAAE,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC/D,CAAC;IACD,UAAU,CAAC,eAAe,EAAE,eAAe,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAClF,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,OAAgB,EAAE,MAA0B;IACjE,OAAO,UAAU,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,UAAmC,EAAE,OAA2B;IACxF,UAAU,CAAC,eAAe,EAAE,QAAQ,CAAC,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED;;;;GAIG;AACH,SAAS,gCAAgC,CAAC,KAA2B;IACnE,IAAI,KAAK,EAAE,CAAC;QACV,UAAU,CAAC,eAAe,EAAE,QAAQ,CAAC,gCAAgC,CAAC,KAAK,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB;IAC1B,UAAU,CAAC,eAAe,EAAE,yBAAyB,CAAC,6BAA6B,EAAE,CAAC;IACtF,UAAU,CAAC,eAAe,EAAE,QAAQ,CAAC,6BAA6B,EAAE,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,IAAY,EAAE,EAAU,EAAE,OAAwC;IACzF,UAAU,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,KAAiB,EAAE,EAA0C;IACzF,UAAU,CAAC,eAAe,EAAE,yBAAyB,CAAC,oBAAoB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACxF,CAAC;AAED,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,gCAAgC,EAChC,mBAAmB,EACnB,eAAe,EACf,oBAAoB,GACrB,CAAC"}

package/worklet-runtime/lib/bindings/events.d.ts

@@ -15,4 +15,7 @@ interface RunWorkletCtxRetData {
     resolveId: number;
     returnValue: unknown;
 }
-export { WorkletEvents, type RunWorkletCtxData, type RunWorkletCtxRetData };
+interface ReleaseWorkletRefData {
+    id: number;
+}
+export { WorkletEvents, type RunWorkletCtxData, type RunWorkletCtxRetData, type ReleaseWorkletRefData };

package/worklet-runtime/lib/bindings/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/bindings/events.ts"],"names":[],"mappings":"AAEA,IAAW,aAMV;AAND,WAAW,aAAa;IACtB,6DAA4C,CAAA;IAC5C,iEAAgD,CAAA;IAChD,iEAAgD,CAAA;IAChD,yFAAwE,CAAA;IACxE,qEAAoD,CAAA;AACtD,CAAC,EANU,aAAa,KAAb,aAAa,QAMvB;AAaD,OAAO,EAAE,aAAa,EAAqD,CAAC"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/bindings/events.ts"],"names":[],"mappings":"AAKA,IAAW,aAMV;AAND,WAAW,aAAa;IACtB,6DAA4C,CAAA;IAC5C,iEAAgD,CAAA;IAChD,iEAAgD,CAAA;IAChD,yFAAwE,CAAA;IACxE,qEAAoD,CAAA;AACtD,CAAC,EANU,aAAa,KAAb,aAAa,QAMvB;AAiBD,OAAO,EAAE,aAAa,EAAiF,CAAC"}

package/worklet-runtime/lib/bindings/index.d.ts

@@ -1,4 +1,4 @@
 export { loadWorkletRuntime } from './loadRuntime.js';
-export { onWorkletCtxUpdate, runWorkletCtx, updateWorkletRef, updateWorkletRefInitValueChanges, clearDelayedWorklets, } from './bindings.js';
+export { onWorkletCtxUpdate, runWorkletCtx, updateWorkletRef, updateWorkletRefInitValueChanges, onHydrationFinished, delayRunOnBackground, } from './bindings.js';
 export type * from './types.js';
 export { WorkletEvents, type RunWorkletCtxData, type RunWorkletCtxRetData } from './events.js';

package/worklet-runtime/lib/bindings/index.js

@@ -2,6 +2,6 @@
 // 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 { loadWorkletRuntime } from './loadRuntime.js';
-export { onWorkletCtxUpdate, runWorkletCtx, updateWorkletRef, updateWorkletRefInitValueChanges, clearDelayedWorklets, } from './bindings.js';
+export { onWorkletCtxUpdate, runWorkletCtx, updateWorkletRef, updateWorkletRefInitValueChanges, onHydrationFinished, delayRunOnBackground, } from './bindings.js';
 export { WorkletEvents } from './events.js';
 //# sourceMappingURL=index.js.map

package/worklet-runtime/lib/bindings/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bindings/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,gCAAgC,EAChC,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAE,aAAa,EAAqD,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bindings/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,gCAAgC,EAChC,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAE,aAAa,EAAqD,MAAM,aAAa,CAAC"}

package/worklet-runtime/lib/bindings/loadRuntime.js

@@ -1,7 +1,6 @@
 // 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.
-/// <reference path="../types/elementApi.d.ts" />
 import '../global.js';
 /**
  * Loads and initializes the Lepus chunk in the main thread.
@@ -16,7 +15,6 @@ function loadWorkletRuntime(__schema) {
         return true;
     }
     return __LoadLepusChunk('worklet-runtime', {
-        // @ts-ignore
         dynamicComponentEntry: __schema,
         chunkType: 0,
     });

package/worklet-runtime/lib/bindings/loadRuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"loadRuntime.js","sourceRoot":"","sources":["../../src/bindings/loadRuntime.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,iDAAiD;AAEjD,OAAO,cAAc,CAAC;AAEtB;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,QAAiB;IAC3C,IAAI,OAAO,gBAAgB,KAAK,WAAW,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,UAAU,CAAC,eAAe,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,gBAAgB,CAAC,iBAAiB,EAAE;QACzC,aAAa;QACb,qBAAqB,EAAE,QAAQ;QAC/B,SAAS,EAAE,CAAC;KACb,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"loadRuntime.js","sourceRoot":"","sources":["../../src/bindings/loadRuntime.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,OAAO,cAAc,CAAC;AAEtB;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,QAAiB;IAC3C,IAAI,OAAO,gBAAgB,KAAK,WAAW,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,UAAU,CAAC,eAAe,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,gBAAgB,CAAC,iBAAiB,EAAE;QACzC,qBAAqB,EAAE,QAAQ;QAC/B,SAAS,EAAE,CAAC;KACb,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/worklet-runtime/lib/bindings/types.d.ts

@@ -1,3 +1,5 @@
+import type { Element } from '../api/element.js';
+export type { Element };
 export type WorkletRefId = number;
 export interface WorkletRefImpl<T> {
     _wvid: WorkletRefId;
@@ -13,23 +15,31 @@ export interface WorkletRef<T> {
 }
 interface ClosureValueType_ extends Record<string, ClosureValueType> {
 }
-export type ClosureValueType = null | undefined | string | boolean | number | Worklet | WorkletRef<unknown> | ClosureValueType_ | ClosureValueType[];
+export type ClosureValueType = null | undefined | string | boolean | number | Worklet | WorkletRef<unknown> | Element | (((...args: unknown[]) => unknown) & {
+    ctx?: ClosureValueType;
+}) | ClosureValueType_ | ClosureValueType[];
 export interface Worklet {
     _wkltId: string;
+    _workletType?: string;
     _c?: Record<string, ClosureValueType>;
-    _lepusWorkletHash?: string;
     _execId?: number;
     _jsFn?: Record<string, string>;
-    _unmount?: any;
+    _unmount?: () => void;
     [key: string]: ClosureValueType;
+    _lepusWorkletHash?: string;
 }
 /**
  * @public
  */
 export interface JsFnHandle {
-    _jsFnId: number;
+    _jsFnId?: number;
     _fn?: (...args: unknown[]) => unknown;
     _execId?: number;
     _error?: string;
+    _isFirstScreen?: boolean;
+    /**
+     * Stores an array of indexes of runOnBackground tasks that should be processed with a delay.
+     * This is used before hydration.
+     */
+    _delayIndices?: number[];
 }
-export {};

package/worklet-runtime/lib/bindings/types.js

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

package/worklet-runtime/lib/bindings/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bindings/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bindings/types.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D"}

package/worklet-runtime/lib/delayRunOnBackground.d.ts

@@ -0,0 +1,12 @@
+import type { JsFnHandle } from './bindings/types.js';
+interface Details {
+    task: (fnId: number, execId: number) => void;
+    jsFnHandle?: JsFnHandle;
+}
+interface RunOnBackgroundDelayImpl {
+    delayedBackgroundFunctionArray: Details[];
+    delayRunOnBackground(fnObj: JsFnHandle, fn: (fnId: number, execId: number) => void): void;
+    runDelayedBackgroundFunctions(): void;
+}
+declare function initRunOnBackgroundDelay(): RunOnBackgroundDelayImpl;
+export { type RunOnBackgroundDelayImpl, initRunOnBackgroundDelay };

package/worklet-runtime/lib/delayRunOnBackground.js

@@ -0,0 +1,23 @@
+let impl;
+function initRunOnBackgroundDelay() {
+    return (impl = {
+        delayedBackgroundFunctionArray: [],
+        delayRunOnBackground,
+        runDelayedBackgroundFunctions,
+    });
+}
+function delayRunOnBackground(fnObj, task) {
+    impl.delayedBackgroundFunctionArray.push({ task });
+    const delayIndices = fnObj._delayIndices ??= [];
+    delayIndices.push(impl.delayedBackgroundFunctionArray.length - 1);
+}
+function runDelayedBackgroundFunctions() {
+    for (const details of impl.delayedBackgroundFunctionArray) {
+        if (details.jsFnHandle) {
+            details.task(details.jsFnHandle._jsFnId, details.jsFnHandle._execId);
+        }
+    }
+    impl.delayedBackgroundFunctionArray.length = 0;
+}
+export { initRunOnBackgroundDelay };
+//# sourceMappingURL=delayRunOnBackground.js.map

package/worklet-runtime/lib/delayRunOnBackground.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delayRunOnBackground.js","sourceRoot":"","sources":["../src/delayRunOnBackground.ts"],"names":[],"mappings":"AAmBA,IAAI,IAA0C,CAAC;AAE/C,SAAS,wBAAwB;IAC/B,OAAO,CAAC,IAAI,GAAG;QACb,8BAA8B,EAAE,EAAE;QAClC,oBAAoB;QACpB,6BAA6B;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAiB,EAAE,IAA4C;IAC3F,IAAK,CAAC,8BAA8B,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,KAAK,EAAE,CAAC;IAChD,YAAY,CAAC,IAAI,CAAC,IAAK,CAAC,8BAA8B,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,6BAA6B;IACpC,KAAK,MAAM,OAAO,IAAI,IAAK,CAAC,8BAA8B,EAAE,CAAC;QAC3D,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,OAAQ,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IACD,IAAK,CAAC,8BAA8B,CAAC,MAAM,GAAG,CAAC,CAAC;AAClD,CAAC;AAED,OAAO,EAAiC,wBAAwB,EAAE,CAAC"}

package/worklet-runtime/lib/delayWorkletEvent.js

@@ -27,8 +27,8 @@ function runDelayedWorklet(worklet, element) {
         }
         const leftParamsVec = [];
         paramsVec.forEach((params) => {
-            // @ts-ignore
-            if (params[0]?.currentTarget?.elementRefptr === element) {
+            const firstParam = params[0];
+            if (firstParam?.currentTarget?.elementRefptr === element) {
                 setTimeout(() => {
                     profile('runDelayedWorklet', () => {
                         runWorklet(worklet, params);

package/worklet-runtime/lib/delayWorkletEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"delayWorkletEvent.js","sourceRoot":"","sources":["../src/delayWorkletEvent.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAQ7C,IAAI,IAAgC,CAAC;AAErC,SAAS,cAAc;IACrB,OAAO,CAAC,IAAI,GAAG;QACb,wBAAwB,EAAE,IAAI,GAAG,EAAE;QACnC,iBAAiB;QACjB,oBAAoB;KACrB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAC5B,IAAY,EACZ,MAA0B;IAE1B,OAAO,CAAC,yBAAyB,GAAG,IAAI,EAAE,GAAG,EAAE;QAC7C,MAAM,GAAG,GAAG,IAAK,CAAC,wBAAwB,CAAC;QAC3C,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAgB,EAAE,OAAoB;IAC/D,OAAO,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACnC,MAAM,SAAS,GAAG,IAAK,CAAC,wBAAwB,CAAC,GAAG,CAClD,OAAO,CAAC,OAAO,CAChB,CAAC;QACF,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QACD,MAAM,aAAa,GAAyB,EAAE,CAAC;QAC/C,SAAS,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YAC3B,aAAa;YACb,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,aAAa,KAAK,OAAO,EAAE,CAAC;gBACxD,UAAU,CAAC,GAAG,EAAE;oBACd,OAAO,CAAC,mBAAmB,EAAE,GAAG,EAAE;wBAChC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;oBAC9B,CAAC,CAAC,CAAC;gBACL,CAAC,EAAE,CAAC,CAAC,CAAC;YACR,CAAC;iBAAM,CAAC;gBACN,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAK,CAAC,wBAAwB,CAAC,GAAG,CAChC,OAAO,CAAC,OAAO,EACf,aAAa,CACd,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,oBAAoB;IAC3B,IAAK,CAAC,wBAAwB,CAAC,KAAK,EAAE,CAAC;AACzC,CAAC;AAED,OAAO,EAAuB,cAAc,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"delayWorkletEvent.js","sourceRoot":"","sources":["../src/delayWorkletEvent.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAQ7C,IAAI,IAAgC,CAAC;AAErC,SAAS,cAAc;IACrB,OAAO,CAAC,IAAI,GAAG;QACb,wBAAwB,EAAE,IAAI,GAAG,EAAE;QACnC,iBAAiB;QACjB,oBAAoB;KACrB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAC5B,IAAY,EACZ,MAA0B;IAE1B,OAAO,CAAC,yBAAyB,GAAG,IAAI,EAAE,GAAG,EAAE;QAC7C,MAAM,GAAG,GAAG,IAAK,CAAC,wBAAwB,CAAC;QAC3C,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAgB,EAAE,OAAoB;IAC/D,OAAO,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACnC,MAAM,SAAS,GAAG,IAAK,CAAC,wBAAwB,CAAC,GAAG,CAClD,OAAO,CAAC,OAAO,CAChB,CAAC;QACF,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QACD,MAAM,aAAa,GAAyB,EAAE,CAAC;QAC/C,SAAS,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YAC3B,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAoE,CAAC;YAChG,IAAI,UAAU,EAAE,aAAa,EAAE,aAAa,KAAK,OAAO,EAAE,CAAC;gBACzD,UAAU,CAAC,GAAG,EAAE;oBACd,OAAO,CAAC,mBAAmB,EAAE,GAAG,EAAE;wBAChC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;oBAC9B,CAAC,CAAC,CAAC;gBACL,CAAC,EAAE,CAAC,CAAC,CAAC;YACR,CAAC;iBAAM,CAAC;gBACN,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAK,CAAC,wBAAwB,CAAC,GAAG,CAChC,OAAO,CAAC,OAAO,EACf,aAAa,CACd,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,oBAAoB;IAC3B,IAAK,CAAC,wBAAwB,CAAC,KAAK,EAAE,CAAC;AACzC,CAAC;AAED,OAAO,EAAuB,cAAc,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,CAAC"}

package/worklet-runtime/lib/global.d.ts

@@ -1,15 +1,18 @@
 import type { ClosureValueType, Worklet } from './bindings/types.js';
+import type { RunOnBackgroundDelayImpl } from './delayRunOnBackground.js';
 import type { EventDelayImpl } from './delayWorkletEvent.js';
 import type { JsFunctionLifecycleManager } from './jsFunctionLifecycle.js';
 import type { RefImpl } from './workletRef.js';
 declare global {
     var lynxWorkletImpl: {
-        _workletMap: Record<string, Function>;
+        _workletMap: Record<string, (...args: unknown[]) => unknown>;
         _jsFunctionLifecycleManager?: JsFunctionLifecycleManager;
         _eventDelayImpl: EventDelayImpl;
         _refImpl: RefImpl;
+        _runOnBackgroundDelayImpl: RunOnBackgroundDelayImpl;
+        _hydrateCtx: (worklet: Worklet, firstScreenWorklet: Worklet) => void;
     };
     function runWorklet(ctx: Worklet, params: ClosureValueType[]): unknown;
-    function registerWorklet(type: string, id: string, worklet: Function): void;
-    function registerWorkletInternal(type: string, id: string, worklet: Function): void;
+    function registerWorklet(type: string, id: string, worklet: (...args: unknown[]) => unknown): void;
+    function registerWorkletInternal(type: string, id: string, worklet: (...args: unknown[]) => unknown): void;
 }

package/worklet-runtime/lib/hydrate.d.ts

@@ -0,0 +1,11 @@
+import type { Worklet } from './bindings/index.js';
+/**
+ * Hydrates a Worklet context with data from a first-screen Worklet context.
+ * This process is typically used to run all delayed `runOnBackground` functions
+ * and initialize `WorkletRef` values modified before hydration.
+ *
+ * @param ctx The target Worklet context to be hydrated.
+ * @param firstScreenCtx The Worklet context from the first screen rendering,
+ *                       containing the data to hydrate with.
+ */
+export declare function hydrateCtx(ctx: Worklet, firstScreenCtx: Worklet): void;

package/worklet-runtime/lib/hydrate.js

@@ -0,0 +1,86 @@
+// 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 { Element } from './api/element.js';
+import { profile } from './utils/profile.js';
+/**
+ * Hydrates a Worklet context with data from a first-screen Worklet context.
+ * This process is typically used to run all delayed `runOnBackground` functions
+ * and initialize `WorkletRef` values modified before hydration.
+ *
+ * @param ctx The target Worklet context to be hydrated.
+ * @param firstScreenCtx The Worklet context from the first screen rendering,
+ *                       containing the data to hydrate with.
+ */
+export function hydrateCtx(ctx, firstScreenCtx) {
+    profile('hydrateCtx', () => {
+        hydrateCtxImpl(ctx, firstScreenCtx, ctx._execId);
+    });
+}
+function hydrateCtxImpl(ctx, firstScreenCtx, execId) {
+    if (!ctx || typeof ctx !== 'object' || !firstScreenCtx || typeof firstScreenCtx !== 'object')
+        return;
+    const ctxObj = ctx;
+    const firstScreenCtxObj = firstScreenCtx;
+    if (ctxObj['_wkltId'] && ctxObj['_wkltId'] !== firstScreenCtxObj['_wkltId']) {
+        return;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-for-in-array
+    for (const key in ctx) {
+        if (key === '_wvid') {
+            hydrateMainThreadRef(ctxObj[key], firstScreenCtxObj);
+        }
+        else if (key === '_jsFn') {
+            hydrateDelayRunOnBackgroundTasks(ctxObj[key], firstScreenCtxObj[key], execId);
+        }
+        else {
+            const firstScreenValue = typeof firstScreenCtxObj[key] === 'function'
+                ? firstScreenCtxObj[key].ctx
+                : firstScreenCtxObj[key];
+            hydrateCtxImpl(ctxObj[key], firstScreenValue, execId);
+        }
+    }
+}
+/**
+ * Hydrates a WorkletRef on the main thread.
+ * This is used to update the WorkletRef's background initial value based on changes
+ * that occurred in the first-screen Worklet context before hydration.
+ *
+ * @param refId The ID of the WorkletRef to hydrate.
+ * @param value The new value for the WorkletRef.
+ */
+function hydrateMainThreadRef(refId, value) {
+    if ('_initValue' in value) {
+        // The ref has not been accessed yet.
+        return;
+    }
+    const ref = lynxWorkletImpl._refImpl._workletRefMap[refId];
+    if (ref.current instanceof Element) {
+        // Modified by `main-thread:ref`
+        return;
+    }
+    ref.current = value.current;
+}
+/**
+ * Hydrates delayed `runOnBackground` tasks.
+ * This function ensures that any `runOnBackground` calls that were delayed
+ * during the first-screen rendering are correctly associated with their
+ * respective JavaScript function handles in the hydrated Worklet context.
+ */
+function hydrateDelayRunOnBackgroundTasks(fnObjs, // example: {"_jsFn1":{"_jsFnId":1}}
+firstScreenFnObjs, // example: {"_jsFn1":{"_isFirstScreen":true,"_delayIndices":[0]}}
+execId) {
+    for (const fnName in fnObjs) {
+        const fnObj = fnObjs[fnName];
+        const firstScreenFnObj = firstScreenFnObjs[fnName];
+        if (!firstScreenFnObj?._delayIndices) {
+            continue;
+        }
+        for (const index of firstScreenFnObj._delayIndices) {
+            const details = lynxWorkletImpl._runOnBackgroundDelayImpl.delayedBackgroundFunctionArray[index];
+            fnObj._execId = execId;
+            details.jsFnHandle = fnObj;
+        }
+    }
+}
+//# sourceMappingURL=hydrate.js.map

package/worklet-runtime/lib/hydrate.js.map

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

package/worklet-runtime/lib/jsFunctionLifecycle.js

@@ -19,7 +19,7 @@ class JsFunctionLifecycleManager {
         this.registry = new FinalizationRegistry(this.removeRef.bind(this));
     }
     addRef(execId, objToRef) {
-        this.execIdRefCount.set(execId, (this.execIdRefCount.get(execId) || 0) + 1);
+        this.execIdRefCount.set(execId, (this.execIdRefCount.get(execId) ?? 0) + 1);
         this.registry.register(objToRef, execId);
     }
     removeRef(execId) {
@@ -32,7 +32,7 @@ class JsFunctionLifecycleManager {
         this.execIdSetToFire.add(execId);
         if (!this.willFire) {
             this.willFire = true;
-            Promise.resolve().then(() => {
+            void Promise.resolve().then(() => {
                 this.fire();
             });
         }

package/worklet-runtime/lib/jsFunctionLifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsFunctionLifecycle.js","sourceRoot":"","sources":["../src/jsFunctionLifecycle.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,0BAA0B;IACtB,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,QAAQ,GAAG,KAAK,CAAC;IACjB,QAAQ,GAAkC,SAAS,CAAC;IAE5D;QACE,IAAI,CAAC,QAAQ,GAAG,IAAI,oBAAoB,CAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,CAAC,MAAc,EAAE,QAAgB;QACrC,IAAI,CAAC,cAAc,CAAC,GAAG,CACrB,MAAM,EACN,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAC3C,CAAC;QACF,IAAI,CAAC,QAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED,SAAS,CAAC,MAAc;QACtB,MAAM,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC;QAC5C,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI;QACF,OAAO,CAAC,iCAAiC,EAAE,GAAG,EAAE;YAC9C,IAAI,CAAC,YAAY,EAAE,CAAC,aAAa,CAAC;gBAChC,IAAI,EAAE,aAAa,CAAC,2BAA2B;gBAC/C,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC;aACvC,CAAC,CAAC;YACH,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,wBAAwB;IAC/B,OAAO,cAAc,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,CAAC"}
+{"version":3,"file":"jsFunctionLifecycle.js","sourceRoot":"","sources":["../src/jsFunctionLifecycle.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,0BAA0B;IACtB,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,QAAQ,GAAG,KAAK,CAAC;IACjB,QAAQ,GAAkC,SAAS,CAAC;IAE5D;QACE,IAAI,CAAC,QAAQ,GAAG,IAAI,oBAAoB,CAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,CAAC,MAAc,EAAE,QAAgB;QACrC,IAAI,CAAC,cAAc,CAAC,GAAG,CACrB,MAAM,EACN,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAC3C,CAAC;QACF,IAAI,CAAC,QAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED,SAAS,CAAC,MAAc;QACtB,MAAM,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC;QAC5C,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI;QACF,OAAO,CAAC,iCAAiC,EAAE,GAAG,EAAE;YAC9C,IAAI,CAAC,YAAY,EAAE,CAAC,aAAa,CAAC;gBAChC,IAAI,EAAE,aAAa,CAAC,2BAA2B;gBAC/C,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC;aACvC,CAAC,CAAC;YACH,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,wBAAwB;IAC/B,OAAO,cAAc,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,CAAC"}

package/worklet-runtime/lib/listeners.js.map

@@ -1 +1 @@
-{"version":3,"file":"listeners.js","sourceRoot":"","sources":["../src/listeners.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAE/D,SAAS,kBAAkB;IACzB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;IACtC,SAAS,CAAC,gBAAgB,CACxB,aAAa,CAAC,aAAa,EAC3B,CAAC,KAAyB,EAAE,EAAE;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAc,CAAsB,CAAC;QACnE,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAA4B,CAAC,CAAC;QAChF,SAAS,CAAC,aAAa,CAAC;YACtB,IAAI,EAAE,aAAa,CAAC,eAAe;YACnC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW;aACY,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IACF,SAAS,CAAC,gBAAgB,CACxB,aAAa,CAAC,iBAAiB,EAC/B,CAAC,KAAyB,EAAE,EAAE;QAC5B,4BAA4B,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC,CACF,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"listeners.js","sourceRoot":"","sources":["../src/listeners.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAE/D,SAAS,kBAAkB;IACzB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;IACtC,SAAS,CAAC,gBAAgB,CACxB,aAAa,CAAC,aAAa,EAC3B,CAAC,KAAY,EAAE,EAAE;QACf,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAc,CAAsB,CAAC;QACnE,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAA4B,CAAC,CAAC;QAChF,SAAS,CAAC,aAAa,CAAC;YACtB,IAAI,EAAE,aAAa,CAAC,eAAe;YACnC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW;aACY,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IACF,SAAS,CAAC,gBAAgB,CACxB,aAAa,CAAC,iBAAiB,EAC/B,CAAC,KAAY,EAAE,EAAE;QACf,4BAA4B,CAAE,KAAK,CAAC,IAA8B,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC,CACF,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/worklet-runtime/lib/utils/profile.d.ts

@@ -1 +1 @@
-export declare function profile<Ret, Fn extends (...args: any[]) => Ret>(sliceName: string, f: Fn): Ret;
+export declare function profile<Ret, Fn extends (...args: unknown[]) => Ret>(sliceName: string, f: Fn): Ret;

package/worklet-runtime/lib/utils/version.js

@@ -2,7 +2,7 @@
 // Licensed under the Apache License Version 2.0 that can be found in the
 // LICENSE file in the root directory of this source tree.
 export function isSdkVersionGt(major, minor) {
-    const lynxSdkVersion = SystemInfo.lynxSdkVersion || '1.0';
+    const lynxSdkVersion = SystemInfo.lynxSdkVersion ?? '1.0';
     const version = lynxSdkVersion.split('.');
     return (Number(version[0]) > major
         || (Number(version[0]) == major && Number(version[1]) > minor));

package/worklet-runtime/lib/workletRef.d.ts

@@ -2,11 +2,14 @@ import { Element } from './api/element.js';
 import type { WorkletRef, WorkletRefId, WorkletRefImpl } from './bindings/types.js';
 interface RefImpl {
     _workletRefMap: Record<WorkletRefId, WorkletRef<unknown>>;
-    updateWorkletRef(handle: WorkletRefImpl<Element>, element: ElementNode | null): void;
+    _firstScreenWorkletRefMap: Record<WorkletRefId, WorkletRef<unknown>>;
+    updateWorkletRef(refImpl: WorkletRefImpl<Element | null>, element: ElementNode | null): void;
     updateWorkletRefInitValueChanges(patch: [number, unknown][]): void;
+    clearFirstScreenWorkletRefMap(): void;
 }
 declare function initWorkletRef(): RefImpl;
-declare const getFromWorkletRefMap: (id: WorkletRefId) => WorkletRef<unknown>;
+declare const createWorkletRef: <T>(id: WorkletRefId, value: T) => WorkletRef<T>;
+declare const getFromWorkletRefMap: <T>(refImpl: WorkletRefImpl<T>) => WorkletRef<T>;
 declare function removeValueFromWorkletRefMap(id: WorkletRefId): void;
 declare function updateWorkletRefInitValueChanges(patch: [WorkletRefId, unknown][]): void;
-export { type RefImpl, initWorkletRef, getFromWorkletRefMap, removeValueFromWorkletRefMap, updateWorkletRefInitValueChanges, };
+export { type RefImpl, createWorkletRef, initWorkletRef, getFromWorkletRefMap, removeValueFromWorkletRefMap, updateWorkletRefInitValueChanges, };

package/worklet-runtime/lib/workletRef.js

@@ -7,8 +7,16 @@ let impl;
 function initWorkletRef() {
     return (impl = {
         _workletRefMap: {},
+        /**
+         * Map of worklet refs that are created during first screen rendering.
+         * These refs are created with negative IDs and need to be hydrated
+         * when the app starts. The map is cleared after hydration is complete
+         * to free up memory.
+         */
+        _firstScreenWorkletRefMap: {},
         updateWorkletRef,
         updateWorkletRefInitValueChanges,
+        clearFirstScreenWorkletRefMap,
     });
 }
 const createWorkletRef = (id, value) => {
@@ -17,8 +25,22 @@ const createWorkletRef = (id, value) => {
         _wvid: id,
     };
 };
-const getFromWorkletRefMap = (id) => {
-    const value = impl._workletRefMap[id];
+const getFromWorkletRefMap = (refImpl) => {
+    const id = refImpl._wvid;
+    let value;
+    if (id < 0) {
+        // At the first screen rendering, the worklet ref is created with a negative ID.
+        // Might be called in two scenarios:
+        // 1. In MTS events
+        // 2. In `main-thread:ref`
+        value = impl._firstScreenWorkletRefMap[id];
+        if (!value) {
+            value = impl._firstScreenWorkletRefMap[id] = createWorkletRef(id, refImpl._initValue);
+        }
+    }
+    else {
+        value = impl._workletRefMap[id];
+    }
     /* v8 ignore next 3 */
     if (__DEV__ && value === undefined) {
         throw new Error('Worklet: ref is not initialized: ' + id);
@@ -29,22 +51,27 @@ function removeValueFromWorkletRefMap(id) {
     delete impl._workletRefMap[id];
 }
 /**
- * Create an element instance of the given element node, then set worklet value to it.
+ * Create an element instance of the given element node, then set the worklet value to it.
  * This is called in `snapshotContextUpdateWorkletRef`.
  * @param handle handle of the worklet value.
  * @param element the element node.
  */
 function updateWorkletRef(handle, element) {
-    getFromWorkletRefMap(handle._wvid).current = element
+    getFromWorkletRefMap(handle).current = element
         ? new Element(element)
         : null;
 }
 function updateWorkletRefInitValueChanges(patch) {
     profile('updateWorkletRefInitValueChanges', () => {
         patch.forEach(([id, value]) => {
-            impl._workletRefMap[id] ??= createWorkletRef(id, value);
+            if (!impl._workletRefMap[id]) {
+                impl._workletRefMap[id] = createWorkletRef(id, value);
+            }
         });
     });
 }
-export { initWorkletRef, getFromWorkletRefMap, removeValueFromWorkletRefMap, updateWorkletRefInitValueChanges, };
+function clearFirstScreenWorkletRefMap() {
+    impl._firstScreenWorkletRefMap = {};
+}
+export { createWorkletRef, initWorkletRef, getFromWorkletRefMap, removeValueFromWorkletRefMap, updateWorkletRefInitValueChanges, };
 //# sourceMappingURL=workletRef.js.map

package/worklet-runtime/lib/workletRef.js.map

@@ -1 +1 @@
-{"version":3,"file":"workletRef.js","sourceRoot":"","sources":["../src/workletRef.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAW7C,IAAI,IAAyB,CAAC;AAE9B,SAAS,cAAc;IACrB,OAAO,CAAC,IAAI,GAAG;QACb,cAAc,EAAE,EAAE;QAClB,gBAAgB;QAChB,gCAAgC;KACjC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,gBAAgB,GAAG,CACvB,EAAgB,EAChB,KAAQ,EACO,EAAE;IACjB,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAC3B,EAAgB,EACK,EAAE;IACvB,MAAM,KAAK,GAAG,IAAK,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;IACvC,sBAAsB;IACtB,IAAI,OAAO,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,KAAM,CAAC;AAChB,CAAC,CAAC;AAEF,SAAS,4BAA4B,CAAC,EAAgB;IACpD,OAAO,IAAK,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CACvB,MAA+B,EAC/B,OAA2B;IAE3B,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,OAAO;QAClD,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC;QACtB,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,gCAAgC,CACvC,KAAgC;IAEhC,OAAO,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE;YAC5B,IAAK,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,gBAAgB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAEL,cAAc,EACd,oBAAoB,EACpB,4BAA4B,EAC5B,gCAAgC,GACjC,CAAC"}
+{"version":3,"file":"workletRef.js","sourceRoot":"","sources":["../src/workletRef.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAa7C,IAAI,IAAyB,CAAC;AAE9B,SAAS,cAAc;IACrB,OAAO,CAAC,IAAI,GAAG;QACb,cAAc,EAAE,EAAE;QAClB;;;;;WAKG;QACH,yBAAyB,EAAE,EAAE;QAC7B,gBAAgB;QAChB,gCAAgC;QAChC,6BAA6B;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,gBAAgB,GAAG,CACvB,EAAgB,EAChB,KAAQ,EACO,EAAE;IACjB,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,oBAAoB,GAAG,CAC3B,OAA0B,EACX,EAAE;IACjB,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IACzB,IAAI,KAAK,CAAC;IACV,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;QACX,gFAAgF;QAChF,oCAAoC;QACpC,mBAAmB;QACnB,0BAA0B;QAC1B,KAAK,GAAG,IAAK,CAAC,yBAAyB,CAAC,EAAE,CAAkB,CAAC;QAC7D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,IAAK,CAAC,yBAAyB,CAAC,EAAE,CAAC,GAAG,gBAAgB,CAAC,EAAE,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,IAAK,CAAC,cAAc,CAAC,EAAE,CAAkB,CAAC;IACpD,CAAC;IAED,sBAAsB;IACtB,IAAI,OAAO,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,SAAS,4BAA4B,CAAC,EAAgB;IACpD,OAAO,IAAK,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CACvB,MAAsC,EACtC,OAA2B;IAE3B,oBAAoB,CAAC,MAAM,CAAC,CAAC,OAAO,GAAG,OAAO;QAC5C,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC;QACtB,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,gCAAgC,CACvC,KAAgC;IAEhC,OAAO,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE;YAC5B,IAAI,CAAC,IAAK,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC9B,IAAK,CAAC,cAAc,CAAC,EAAE,CAAC,GAAG,gBAAgB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACzD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,6BAA6B;IACpC,IAAK,CAAC,yBAAyB,GAAG,EAAE,CAAC;AACvC,CAAC;AAED,OAAO,EAEL,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,4BAA4B,EAC5B,gCAAgC,GACjC,CAAC"}

package/worklet-runtime/lib/workletRuntime.js

@@ -2,15 +2,19 @@
 // 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 { Element } from './api/element.js';
+import { initRunOnBackgroundDelay } from './delayRunOnBackground.js';
 import { delayExecUntilJsReady, initEventDelay } from './delayWorkletEvent.js';
-import { isRunOnBackgroundEnabled, JsFunctionLifecycleManager } from './jsFunctionLifecycle.js';
+import { hydrateCtx } from './hydrate.js';
+import { JsFunctionLifecycleManager, isRunOnBackgroundEnabled } from './jsFunctionLifecycle.js';
 import { profile } from './utils/profile.js';
 import { getFromWorkletRefMap, initWorkletRef } from './workletRef.js';
 function initWorklet() {
     globalThis.lynxWorkletImpl = {
         _workletMap: {},
-        _eventDelayImpl: initEventDelay(),
         _refImpl: initWorkletRef(),
+        _runOnBackgroundDelayImpl: initRunOnBackgroundDelay(),
+        _hydrateCtx: hydrateCtx,
+        _eventDelayImpl: initEventDelay(),
     };
     if (isRunOnBackgroundEnabled()) {
         globalThis.lynxWorkletImpl._jsFunctionLifecycleManager = new JsFunctionLifecycleManager();
@@ -49,11 +53,7 @@ function runWorklet(ctx, params) {
 function runWorkletImpl(ctx, params) {
     const worklet = profile('transformWorkletCtx ' + ctx._wkltId, () => transformWorklet(ctx, true));
     const params_ = profile('transformWorkletParams', () => transformWorklet(params || [], false));
-    let result;
-    profile('runWorklet', () => {
-        result = worklet(...params_);
-    });
-    return result;
+    return profile('runWorklet', () => worklet(...params_));
 }
 function validateWorklet(ctx) {
     return typeof ctx === 'object' && ctx !== null && ('_wkltId' in ctx || '_lepusWorkletHash' in ctx);
@@ -77,17 +77,17 @@ function transformWorklet(ctx, isWorklet) {
     }
     return worklet.main;
 }
-const transformWorkletInner = (obj, depth, ctx) => {
+const transformWorkletInner = (value, depth, ctx) => {
     const limit = 1000;
     if (++depth >= limit) {
         throw new Error('Depth of value exceeds limit of ' + limit + '.');
     }
     /* v8 ignore next 3 */
-    if (typeof obj !== 'object' || obj === null) {
+    if (typeof value !== 'object' || value === null) {
         return;
     }
+    const obj = value;
     for (const key in obj) {
-        // @ts-ignore
         const subObj = obj[key];
         if (typeof subObj !== 'object' || subObj === null) {
             continue;
@@ -97,23 +97,21 @@ const transformWorkletInner = (obj, depth, ctx) => {
             transformWorkletInner(subObj, depth, ctx);
         }
         if (isEventTarget) {
-            // @ts-ignore
             obj[key] = new Element(subObj['elementRefptr']);
             continue;
         }
         const isWorkletRef = '_wvid' in subObj;
         if (isWorkletRef) {
-            // @ts-ignore
-            obj[key] = getFromWorkletRefMap(subObj._wvid);
+            obj[key] = getFromWorkletRefMap(subObj);
             continue;
         }
         const isWorklet = '_wkltId' in subObj;
         if (isWorklet) {
             // `subObj` is worklet ctx. Shallow copy it to prevent the transformed worklet from referencing ctx.
             // This would result in the value of `workletCache` referencing its key.
-            // @ts-ignore
             obj[key] = lynxWorkletImpl._workletMap[subObj._wkltId]
                 .bind({ ...subObj });
+            obj[key].ctx = subObj;
             continue;
         }
         const isJsFn = '_jsFnId' in subObj;