@lynx-js/react 0.108.1 → 0.109.1

package/runtime/lib/worklet/hmr.js.map

@@ -1 +1 @@
-{"version":3,"file":"hmr.js","sourceRoot":"","sources":["../../src/worklet/hmr.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,+EAA+E;AAE/E,iEAAiE;AAEjE,qBAAqB;AACrB;;GAEG;AACH,mCAAmC;AACnC,0GAA0G;AAC1G,SAAS,2BAA2B,CAAC,KAAa,EAAE,KAAa,EAAE,GAAa;IAC9E,kCAAkC;IAClC,YAAY;IACZ,IAAI;IACJ,4BAA4B;IAC5B,+BAA+B;IAC/B,gCAAgC;IAChC,kDAAkD;IAClD,YAAY;IACZ,mFAAmF;IACnF,qBAAqB;IACrB,OAAO;IACP,IAAI;AACN,CAAC;AACD,oBAAoB;AAEpB,OAAO,EAAE,2BAA2B,EAAE,CAAC"}
+{"version":3,"file":"hmr.js","sourceRoot":"","sources":["../../src/worklet/hmr.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,+EAA+E;AAE/E,iEAAiE;AAEjE,qBAAqB;AACrB;;GAEG;AACH,mCAAmC;AACnC,0GAA0G;AAC1G,SAAS,2BAA2B,CAClC,KAAa,EACb,KAAa,EACb,GAAoC;IAEpC,kCAAkC;IAClC,YAAY;IACZ,IAAI;IACJ,4BAA4B;IAC5B,+BAA+B;IAC/B,gCAAgC;IAChC,kDAAkD;IAClD,YAAY;IACZ,mFAAmF;IACnF,qBAAqB;IACrB,OAAO;IACP,IAAI;AACN,CAAC;AACD,oBAAoB;AAEpB,OAAO,EAAE,2BAA2B,EAAE,CAAC"}

package/runtime/lib/worklet/indexMap.js

@@ -1,3 +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.
 class IndexMap {
     lastIndex = 0;
     indexMap = new Map();

package/runtime/lib/worklet/indexMap.js.map

@@ -1 +1 @@
-{"version":3,"file":"indexMap.js","sourceRoot":"","sources":["../../src/worklet/indexMap.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ;IACF,SAAS,GAAG,CAAC,CAAC;IACd,QAAQ,GAAmB,IAAI,GAAG,EAAE,CAAC;IAExC,GAAG,CAAC,KAAQ;QACjB,MAAM,KAAK,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,GAAG,CAAC,KAAa;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAEM,MAAM,CAAC,KAAa;QACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"indexMap.js","sourceRoot":"","sources":["../../src/worklet/indexMap.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,MAAM,QAAQ;IACF,SAAS,GAAG,CAAC,CAAC;IACd,QAAQ,GAAmB,IAAI,GAAG,EAAa,CAAC;IAEnD,GAAG,CAAC,KAAQ;QACjB,MAAM,KAAK,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,GAAG,CAAC,KAAa;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAEM,MAAM,CAAC,KAAa;QACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/runtime/lib/worklet/runOnBackground.js

@@ -1,7 +1,7 @@
 // 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 { WorkletEvents } from '@lynx-js/react/worklet-runtime/bindings';
+import { WorkletEvents, delayRunOnBackground } from '@lynx-js/react/worklet-runtime/bindings';
 import { destroyTasks } from './destroy.js';
 import { WorkletExecIdMap } from './execMap.js';
 import { isRunOnBackgroundEnabled } from './functionality.js';
@@ -87,19 +87,28 @@ function runOnBackground(f) {
     return async (...params) => {
         return new Promise((resolve) => {
             const resolveId = onFunctionCall(resolve);
-            lynx.getJSContext().dispatchEvent({
-                type: WorkletEvents.runOnBackground,
-                data: JSON.stringify({
-                    obj: {
-                        _jsFnId: obj._jsFnId,
-                        _execId: obj._execId,
-                    },
-                    params,
-                    resolveId,
-                }),
-            });
+            if (obj._isFirstScreen) {
+                delayRunOnBackground(obj, (fnId, execId) => {
+                    dispatchRunBackgroundFunctionEvent(fnId, params, execId, resolveId);
+                });
+                return;
+            }
+            dispatchRunBackgroundFunctionEvent(obj._jsFnId, params, obj._execId, resolveId);
         });
     };
 }
+function dispatchRunBackgroundFunctionEvent(fnId, params, execId, resolveId) {
+    lynx.getJSContext().dispatchEvent({
+        type: WorkletEvents.runOnBackground,
+        data: JSON.stringify({
+            obj: {
+                _jsFnId: fnId,
+                _execId: execId,
+            },
+            params,
+            resolveId,
+        }),
+    });
+}
 export { registerWorkletCtx, runJSFunction, runOnBackground };
 //# sourceMappingURL=runOnBackground.js.map

package/runtime/lib/worklet/runOnBackground.js.map

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

package/runtime/src/gesture/processGesture.ts

@@ -1,17 +1,21 @@
-import {
-  type GestureKind,
-  GestureTypeInner,
-  type ComposedGesture,
-  type BaseGesture,
-  type GestureConfig,
-} from './types.js';
+// 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 { onWorkletCtxUpdate } from '@lynx-js/react/worklet-runtime/bindings';
 
+import { GestureTypeInner } from './types.js';
+import type { BaseGesture, ComposedGesture, GestureConfig, GestureKind } from './types.js';
+
 function isSerializedGesture(gesture: GestureKind): boolean {
   return gesture.__isSerialized ?? false;
 }
 
-function getGestureInfo(gesture: BaseGesture, dom: FiberElement) {
+function getGestureInfo(
+  gesture: BaseGesture,
+  oldGesture: BaseGesture | undefined,
+  isFirstScreen: boolean,
+  dom: FiberElement,
+) {
   const config = {
     callbacks: [],
   } as GestureConfig;
@@ -22,12 +26,11 @@ function getGestureInfo(gesture: BaseGesture, dom: FiberElement) {
   }
 
   for (
-    const key of Object.keys(baseGesture.callbacks) as Array<
-      keyof BaseGesture['callbacks']
-    >
+    const key of Object.keys(baseGesture.callbacks)
   ) {
     const callback = baseGesture.callbacks[key]!;
-    onWorkletCtxUpdate(callback, dom);
+    const oldCallback = oldGesture?.callbacks[key];
+    onWorkletCtxUpdate(callback, oldCallback, isFirstScreen, dom);
     config.callbacks.push({
       name: key,
       callback: callback,
@@ -49,6 +52,8 @@ function getGestureInfo(gesture: BaseGesture, dom: FiberElement) {
 export function processGesture(
   dom: FiberElement,
   gesture: GestureKind,
+  oldGesture: GestureKind | undefined,
+  isFirstScreen: boolean,
   gestureOptions?: {
     domSet: boolean;
   },
@@ -63,13 +68,16 @@ export function processGesture(
   }
 
   if (gesture.type === GestureTypeInner.COMPOSED) {
-    for (const subGesture of (gesture as ComposedGesture).gestures) {
-      processGesture(dom, subGesture, { domSet: true });
+    for (const [index, subGesture] of (gesture as ComposedGesture).gestures.entries()) {
+      processGesture(dom, subGesture, (oldGesture as ComposedGesture)?.gestures[index], isFirstScreen, {
+        domSet: true,
+      });
     }
   } else {
     const baseGesture = gesture as BaseGesture;
+    const oldBaseGesture = oldGesture as BaseGesture | undefined;
 
-    const { config, relationMap } = getGestureInfo(baseGesture, dom);
+    const { config, relationMap } = getGestureInfo(baseGesture, oldBaseGesture, isFirstScreen, dom);
     __SetGestureDetector(
       dom,
       baseGesture.id,

package/runtime/src/lifecycle/patch/snapshotPatchApply.ts

@@ -13,7 +13,13 @@
  * order and with proper error handling.
  */
 
-import { SnapshotInstance, createSnapshot, snapshotInstanceManager, snapshotManager } from '../../snapshot.js';
+import {
+  SnapshotInstance,
+  createSnapshot,
+  entryUniqID,
+  snapshotInstanceManager,
+  snapshotManager,
+} from '../../snapshot.js';
 import type { SnapshotPatch } from './snapshotPatch.js';
 import { SnapshotOperation } from './snapshotPatch.js';
 
@@ -94,7 +100,7 @@ export function snapshotPatchApply(snapshotPatch: SnapshotPatch): void {
           const cssId: number = snapshotPatch[++i] ?? 0;
           const entryName: string | undefined = snapshotPatch[++i];
 
-          if (!snapshotManager.values.has(uniqID)) {
+          if (!snapshotManager.values.has(entryUniqID(uniqID, entryName))) {
             // HMR-related
             // Update the evaluated snapshots from JS.
             createSnapshot(

package/runtime/src/list.ts

@@ -184,10 +184,10 @@ export class ListUpdateInfoRecording implements ListUpdateInfo {
       const elementIndex = this.list.__snapshot_def.slot[0]![1];
       const listElement = this.list.__elements![elementIndex]!;
 
-      // `__GetAttributeByName` is avaiable since Lynx 2.14
+      // `__GetAttributeByName` is available since Lynx 2.14
       if (__GetAttributeByName(listElement, 'custom-list-name') === 'list-container') {
         // `updateAction` must be full (not incremental) when Lynx version <= 2.18 and
-        // when `custom-list-name` is `list-container` (avaiable when Lynx version >= 2.14) is true,
+        // when `custom-list-name` is `list-container` (available when Lynx version >= 2.14) is true,
         updates.length = 0;
         this.list.childNodes.forEach((child, index) => {
           updates.push({

package/runtime/src/lynx/calledByNative.ts

@@ -86,7 +86,7 @@ function renderPage(data: any): void {
   renderMainThread();
 
   // always call this before `__FlushElementTree`
-  // (There is an implict `__FlushElementTree` in `renderPage`)
+  // (There is an implicit `__FlushElementTree` in `renderPage`)
   __pendingListUpdates.flush();
 
   if (__FIRST_SCREEN_SYNC_TIMING__ === 'immediately') {

package/runtime/src/snapshot/gesture.ts

@@ -1,10 +1,12 @@
-import { SnapshotInstance } from '../snapshot.js';
 import { processGesture } from '../gesture/processGesture.js';
+import type { GestureKind } from '../gesture/types.js';
+import { isMainThreadHydrationFinished } from '../lifecycle/patch/isMainThreadHydrationFinished.js';
+import { SnapshotInstance } from '../snapshot.js';
 
 export function updateGesture(
   snapshot: SnapshotInstance,
   expIndex: number,
-  _oldValue: any,
+  oldValue: any,
   elementIndex: number,
   workletType: string,
 ): void {
@@ -14,10 +16,10 @@ export function updateGesture(
   if (__PROFILE__) {
     console.profile('updateGesture');
   }
-  const value = snapshot.__values![expIndex];
+  const value = snapshot.__values![expIndex] as GestureKind;
 
   if (workletType === 'main-thread') {
-    processGesture(snapshot.__elements[elementIndex]!, value);
+    processGesture(snapshot.__elements[elementIndex]!, value, oldValue as GestureKind, !isMainThreadHydrationFinished);
   }
   if (__PROFILE__) {
     console.profileEnd();

package/runtime/src/snapshot/workletEvent.ts

@@ -5,11 +5,12 @@ import { onWorkletCtxUpdate } from '@lynx-js/react/worklet-runtime/bindings';
 import type { Worklet } from '@lynx-js/react/worklet-runtime/bindings';
 
 import { SnapshotInstance } from '../snapshot.js';
+import { isMainThreadHydrationFinished } from '../lifecycle/patch/isMainThreadHydrationFinished.js';
 
 function updateWorkletEvent(
   snapshot: SnapshotInstance,
   expIndex: number,
-  _oldValue: Worklet,
+  oldValue: Worklet,
   elementIndex: number,
   workletType: string,
   eventType: string,
@@ -22,7 +23,7 @@ function updateWorkletEvent(
   value._workletType = workletType;
 
   if (workletType === 'main-thread') {
-    onWorkletCtxUpdate(value, snapshot.__elements[elementIndex]!);
+    onWorkletCtxUpdate(value, oldValue, !isMainThreadHydrationFinished, snapshot.__elements[elementIndex]!);
     const event = {
       type: 'worklet',
       value,

package/runtime/src/snapshot/workletRef.ts

@@ -2,12 +2,12 @@
 // 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 { runWorkletCtx, updateWorkletRef as update } from '@lynx-js/react/worklet-runtime/bindings';
-import type { Element, Worklet, WorkletRefId, WorkletRefImpl } from '@lynx-js/react/worklet-runtime/bindings';
+import type { Element, Worklet, WorkletRefImpl } from '@lynx-js/react/worklet-runtime/bindings';
 
 import type { SnapshotInstance } from '../snapshot.js';
 
 function workletUnRef(value: Worklet | WorkletRefImpl<Element>): void {
-  if ('_wvid' in value && (value._wvid as WorkletRefId) > 0) {
+  if ('_wvid' in value) {
     update(value as WorkletRefImpl<Element>, null);
   } else if ('_wkltId' in value) {
     if (typeof value._unmount == 'function') {
@@ -38,14 +38,14 @@ function updateWorkletRef(
   if (value === null || value === undefined) {
     // do nothing
   } else if (value._wvid) {
-    if ((value._wvid as WorkletRefId) > 0) {
-      update(value as WorkletRefImpl<Element>, snapshot.__elements[elementIndex]!);
-    }
+    update(value as WorkletRefImpl<Element>, snapshot.__elements[elementIndex]!);
   } else if ((value as Worklet)._wkltId) {
     (value as Worklet)._unmount = runWorkletCtx(value as Worklet, [{
       elementRefptr: (snapshot.__elements[elementIndex]!) as any,
     }]) as () => void;
+    /* v8 ignore next 3 */
   } else if (value._type === '__LEPUS__' || (value as Worklet)._lepusWorkletHash) {
+    // for pre-0.99 compatibility
     // During the initial render, we will not update the WorkletRef because the background thread is not ready yet.
   } else {
     throw new Error('MainThreadRef: main-thread:ref must be of type MainThreadRef or main-thread function.');

package/runtime/src/snapshot.ts

@@ -181,6 +181,10 @@ export const backgroundSnapshotInstanceManager: {
   },
 };
 
+export function entryUniqID(uniqID: string, entryName?: string): string {
+  return entryName ? `${entryName}:${uniqID}` : uniqID;
+}
+
 export function createSnapshot(
   uniqID: string,
   create: Snapshot['create'] | null,
@@ -194,7 +198,7 @@ export function createSnapshot(
     // `__globalSnapshotPatch` does not exist before hydration,
     // so the snapshot of the first screen will not be sent to the main thread.
     && __globalSnapshotPatch
-    && !snapshotManager.values.has(uniqID)
+    && !snapshotManager.values.has(entryUniqID(uniqID, entryName))
     // `create` may be `null` when loading a lazy bundle after hydration.
     && create !== null
   ) {
@@ -215,9 +219,7 @@ export function createSnapshot(
     );
   }
 
-  if (entryName) {
-    uniqID = `${entryName}:${uniqID}`;
-  }
+  uniqID = entryUniqID(uniqID, entryName);
 
   const s: Snapshot = { create, update, slot, cssId, entryName };
   snapshotManager.values.set(uniqID, s);

package/runtime/src/worklet/execMap.ts

@@ -29,11 +29,12 @@ export class WorkletExecIdMap extends IndexMap<Worklet> {
       return undefined;
     }
 
-    const f = (obj: any): JsFnHandle | undefined => {
-      if (obj === null || typeof obj !== 'object') {
+    const f = (value: unknown): JsFnHandle | undefined => {
+      if (value === null || typeof value !== 'object') {
         return undefined;
       }
-      if ('_jsFnId' in obj && obj._jsFnId === fnId) {
+      const obj = value as Record<string, unknown>;
+      if ('_jsFnId' in obj && obj['_jsFnId'] === fnId) {
         return obj as JsFnHandle;
       }
       for (const i in obj) {

package/runtime/src/worklet/functionality.ts

@@ -11,20 +11,14 @@ let runOnBackgroundEnabled: boolean | undefined;
  * @internal
  */
 function isMtsEnabled(): boolean {
-  if (mtsEnabled === undefined) {
-    mtsEnabled = isSdkVersionGt(2, 13);
-  }
-  return mtsEnabled;
+  return mtsEnabled ??= isSdkVersionGt(2, 13);
 }
 
 /**
  * @internal
  */
 function isRunOnBackgroundEnabled(): boolean {
-  if (runOnBackgroundEnabled === undefined) {
-    runOnBackgroundEnabled = isSdkVersionGt(2, 15);
-  }
-  return runOnBackgroundEnabled;
+  return runOnBackgroundEnabled ??= isSdkVersionGt(2, 15);
 }
 
 function clearConfigCacheForTesting(): void {

package/runtime/src/worklet/hmr.ts

@@ -11,7 +11,11 @@
  */
 // disable hmr until bugs are fixed
 // TODO: re-enable hmr or change a way to impl it; also need to fix the test case DEV_ONLY_RegisterWorklet
-function registerWorkletOnBackground(_type: string, _hash: string, _fn: Function) {
+function registerWorkletOnBackground(
+  _type: string,
+  _hash: string,
+  _fn: (...args: unknown[]) => unknown,
+) {
   // if (workletHashSet.has(hash)) {
   //   return;
   // }

package/runtime/src/worklet/indexMap.ts

@@ -1,6 +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.
 class IndexMap<T> {
   protected lastIndex = 0;
-  protected indexMap: Map<number, T> = new Map();
+  protected indexMap: Map<number, T> = new Map<number, T>();
 
   public add(value: T): number {
     const index = ++this.lastIndex;

package/runtime/src/worklet/runOnBackground.ts

@@ -2,8 +2,13 @@
 // 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 type { JsFnHandle, RunWorkletCtxRetData, Worklet } from '@lynx-js/react/worklet-runtime/bindings';
-import { WorkletEvents } from '@lynx-js/react/worklet-runtime/bindings';
+import type {
+  ClosureValueType,
+  JsFnHandle,
+  RunWorkletCtxRetData,
+  Worklet,
+} from '@lynx-js/react/worklet-runtime/bindings';
+import { WorkletEvents, delayRunOnBackground } from '@lynx-js/react/worklet-runtime/bindings';
 
 import { destroyTasks } from './destroy.js';
 import { WorkletExecIdMap } from './execMap.js';
@@ -44,7 +49,7 @@ function init() {
 function runJSFunction(event: RuntimeProxy.Event): void {
   'background only';
   const data = JSON.parse(event.data as string) as RunOnBackgroundData;
-  const obj = execIdMap!.findJsFnHandle(data.obj._execId!, data.obj._jsFnId);
+  const obj = execIdMap!.findJsFnHandle(data.obj._execId!, data.obj._jsFnId!);
   const f = obj?._fn;
   if (!f) {
     throw new Error('runOnBackground: JS function not found: ' + JSON.stringify(data.obj));
@@ -104,22 +109,39 @@ function runOnBackground<R, Fn extends (...args: any[]) => R>(f: Fn): (...args:
   if (obj._error) {
     throw new Error(obj._error);
   }
-  return async (...params: any[]): Promise<R> => {
+  return async (...params: ClosureValueType[]): Promise<R> => {
     return new Promise((resolve) => {
       const resolveId = onFunctionCall(resolve);
-      lynx.getJSContext!().dispatchEvent({
-        type: WorkletEvents.runOnBackground,
-        data: JSON.stringify({
-          obj: {
-            _jsFnId: obj._jsFnId,
-            _execId: obj._execId!,
-          },
-          params,
-          resolveId,
-        } as RunOnBackgroundData),
-      });
+
+      if (obj._isFirstScreen) {
+        delayRunOnBackground(obj, (fnId: number, execId: number) => {
+          dispatchRunBackgroundFunctionEvent(fnId, params, execId, resolveId);
+        });
+        return;
+      }
+
+      dispatchRunBackgroundFunctionEvent(obj._jsFnId!, params, obj._execId!, resolveId);
     });
   };
 }
 
+function dispatchRunBackgroundFunctionEvent(
+  fnId: number,
+  params: ClosureValueType[],
+  execId: number,
+  resolveId: number,
+): void {
+  lynx.getJSContext!().dispatchEvent({
+    type: WorkletEvents.runOnBackground,
+    data: JSON.stringify({
+      obj: {
+        _jsFnId: fnId,
+        _execId: execId,
+      },
+      params,
+      resolveId,
+    } as RunOnBackgroundData),
+  });
+}
+
 export { registerWorkletCtx, runJSFunction, runOnBackground };

package/testing-library/dist/vitest-global-setup.js

@@ -86,6 +86,13 @@ globalThis.onInjectBackgroundThreadGlobals = (target)=>{
     globalThis.lynxCoreInject = target.lynxCoreInject;
     (0, __WEBPACK_EXTERNAL_MODULE__runtime_lib_lynx_tt_js_37d9bcb1__.injectTt)();
     globalThis.lynxCoreInject = oldLynxCoreInject;
+    target.lynx.requireModuleAsync = async (url, callback)=>{
+        try {
+            callback(null, await __vite_ssr_dynamic_import__(url));
+        } catch (err) {
+            callback(err, null);
+        }
+    };
     (0, __WEBPACK_EXTERNAL_MODULE__runtime_lib_lifecycle_patch_snapshotPatch_js_c1ebb33c__.deinitGlobalSnapshotPatch)();
     (0, __WEBPACK_EXTERNAL_MODULE__runtime_lib_lifecycle_patch_commit_js_9adc7328__.clearCommitTaskId)();
 };