@lynx-js/react 0.114.0 → 0.114.2

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # @lynx-js/react
 
+## 0.114.2
+
+### Patch Changes
+
+- fix: main thread functions created during the initial render cannot correctly call `runOnBackground()` after hydration ([#1878](https://github.com/lynx-family/lynx-stack/pull/1878))
+
+## 0.114.1
+
+### Patch Changes
+
+- Add `event.stopPropagation` and `event.stopImmediatePropagation` in MTS, to help with event propagation control ([#1835](https://github.com/lynx-family/lynx-stack/pull/1835))
+
+  ```tsx
+  function App() {
+    function handleInnerTap(event: MainThread.TouchEvent) {
+      'main thread';
+      event.stopPropagation();
+      // Or stop immediate propagation with
+      // event.stopImmediatePropagation();
+    }
+
+    // OuterTap will not be triggered
+    return (
+      <view main-thread:bindtap={handleOuterTap}>
+        <view main-thread:bindtap={handleInnerTap}>
+          <text>Hello, world</text>
+        </view>
+      </view>
+    );
+  }
+  ```
+
+  Note, if this feature is used in [Lazy Loading Standalone Project](https://lynxjs.org/react/code-splitting.html#lazy-loading-standalone-project), both the Producer and the Consumer should update to latest version of `@lynx-js/react` to make sure the feature is available.
+
+- Fix the "ReferenceError: Node is not defined" error. ([#1850](https://github.com/lynx-family/lynx-stack/pull/1850))
+
+  This error would happen when upgrading to `@testing-library/jest-dom` [v6.9.0](https://github.com/testing-library/jest-dom/releases/tag/v6.9.0).
+
+- fix: optimize main thread event error message ([#1838](https://github.com/lynx-family/lynx-stack/pull/1838))
+
 ## 0.114.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynx-js/react",
-  "version": "0.114.0",
+  "version": "0.114.2",
   "description": "ReactLynx is a framework for developing Lynx applications with familiar React.",
   "repository": {
     "type": "git",
@@ -175,8 +175,8 @@
   },
   "devDependencies": {
     "@lynx-js/types": "3.4.11",
-    "@microsoft/api-extractor": "7.52.13",
-    "@types/react": "^18.3.24"
+    "@microsoft/api-extractor": "7.52.15",
+    "@types/react": "^18.3.25"
   },
   "peerDependencies": {
     "@lynx-js/types": "*",

package/refresh/.turbo/turbo-build.log

@@ -2,10 +2,10 @@
 > @lynx-js/react-refresh@0.1.0 build /home/runner/work/lynx-stack/lynx-stack/packages/react/refresh
 > rslib build
 
-  Rslib v0.13.3
+  Rslib v0.15.0
 
 info    build started...
-ready   built in 0.20 s
+ready   built in 0.11 s
 
 File (esm)      Size      
 dist/index.js   11.1 kB

package/runtime/lib/debug/describeInvalidValue.d.ts

@@ -0,0 +1 @@
+export declare function describeInvalidValue(value: unknown): string;

package/runtime/lib/debug/describeInvalidValue.js

@@ -0,0 +1,25 @@
+// 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.
+export function describeInvalidValue(value) {
+    if (value === null) {
+        return 'null';
+    }
+    if (value === undefined) {
+        return 'undefined';
+    }
+    if (typeof value === 'function') {
+        return `function ${value.name || '(anonymous)'}`;
+    }
+    if (typeof value === 'string') {
+        return `string "${value}"`;
+    }
+    if (typeof value === 'number' || typeof value === 'bigint' || typeof value === 'boolean') {
+        return `${typeof value} ${String(value)}`;
+    }
+    if (typeof value === 'symbol') {
+        return `symbol ${String(value)}`;
+    }
+    return `unexpected ${typeof value}`;
+}
+//# sourceMappingURL=describeInvalidValue.js.map

package/runtime/lib/debug/describeInvalidValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describeInvalidValue.js","sourceRoot":"","sources":["../../src/debug/describeInvalidValue.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,YAAY,KAAK,CAAC,IAAI,IAAI,aAAa,EAAE,CAAC;IACnD,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,WAAW,KAAK,GAAG,CAAC;IAC7B,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QACzF,OAAO,GAAG,OAAO,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5C,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,UAAU,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,cAAc,OAAO,KAAK,EAAE,CAAC;AACtC,CAAC"}

package/runtime/lib/snapshot/workletEvent.js

@@ -2,13 +2,34 @@
 // 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 { describeInvalidValue } from '../debug/describeInvalidValue.js';
 import { isMainThreadHydrating } from '../lifecycle/patch/isMainThreadHydrating.js';
 import { SnapshotInstance } from '../snapshot.js';
+function formatEventAttribute(workletType, eventType, eventName) {
+    const suffix = eventType.endsWith('Event') ? eventType.slice(0, -'Event'.length) : eventType;
+    return `${workletType}:${suffix}${eventName}`;
+}
+function reportInvalidWorkletValue(snapshot, elementIndex, workletType, eventType, eventName, value) {
+    const eventAttr = formatEventAttribute(workletType, eventType, eventName);
+    const element = snapshot.__elements?.[elementIndex];
+    const elementTag = element ? __GetTag(element) : 'unknown';
+    const elementId = snapshot.__id;
+    const snapshotName = snapshot.type;
+    const message = `"${eventAttr}" on <${elementTag}> (snapshot ${elementId} "${snapshotName}") expected `
+        + 'a main-thread function but received '
+        + `${describeInvalidValue(value)}. Did you forget to add a "main thread" directive to the handler?`;
+    lynx.reportError(new Error(message));
+}
 function updateWorkletEvent(snapshot, expIndex, oldValue, elementIndex, workletType, eventType, eventName) {
     if (!snapshot.__elements) {
         return;
     }
-    const value = (snapshot.__values[expIndex] || undefined) ?? {};
+    const rawValue = snapshot.__values[expIndex];
+    if (__DEV__ && rawValue !== null && rawValue !== undefined && typeof rawValue !== 'object') {
+        reportInvalidWorkletValue(snapshot, elementIndex, workletType, eventType, eventName, rawValue);
+        return;
+    }
+    const value = (rawValue ?? {});
     value._workletType = workletType;
     if (workletType === 'main-thread') {
         onWorkletCtxUpdate(value, oldValue, isMainThreadHydrating, snapshot.__elements[elementIndex]);

package/runtime/lib/snapshot/workletEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"workletEvent.js","sourceRoot":"","sources":["../../src/snapshot/workletEvent.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAG7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,SAAS,kBAAkB,CACzB,QAA0B,EAC1B,QAAgB,EAChB,QAAiB,EACjB,YAAoB,EACpB,WAAmB,EACnB,SAAiB,EACjB,SAAiB;IAEjB,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,QAAQ,CAAC,QAAS,CAAC,QAAQ,CAAY,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;IAC3E,KAAK,CAAC,YAAY,GAAG,WAAW,CAAC;IAEjC,IAAI,WAAW,KAAK,aAAa,EAAE,CAAC;QAClC,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,qBAAqB,EAAE,QAAQ,CAAC,UAAU,CAAC,YAAY,CAAE,CAAC,CAAC;QAC/F,MAAM,KAAK,GAAG;YACZ,IAAI,EAAE,SAAS;YACf,KAAK;SACN,CAAC;QACF,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,YAAY,CAAE,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"workletEvent.js","sourceRoot":"","sources":["../../src/snapshot/workletEvent.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAG7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,SAAS,oBAAoB,CAAC,WAAmB,EAAE,SAAiB,EAAE,SAAiB;IACrF,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7F,OAAO,GAAG,WAAW,IAAI,MAAM,GAAG,SAAS,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,yBAAyB,CAChC,QAA0B,EAC1B,YAAoB,EACpB,WAAmB,EACnB,SAAiB,EACjB,SAAiB,EACjB,KAAc;IAEd,MAAM,SAAS,GAAG,oBAAoB,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC,YAAY,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC;IAChC,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,SAAS,SAAS,UAAU,eAAe,SAAS,KAAK,YAAY,cAAc;UACnG,sCAAsC;UACtC,GAAG,oBAAoB,CAAC,KAAK,CAAC,mEAAmE,CAAC;IACtG,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,kBAAkB,CACzB,QAA0B,EAC1B,QAAgB,EAChB,QAAiB,EACjB,YAAoB,EACpB,WAAmB,EACnB,SAAiB,EACjB,SAAiB;IAEjB,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAS,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,OAAO,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC3F,yBAAyB,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC/F,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAY,CAAC;IAC1C,KAAK,CAAC,YAAY,GAAG,WAAW,CAAC;IAEjC,IAAI,WAAW,KAAK,aAAa,EAAE,CAAC;QAClC,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,qBAAqB,EAAE,QAAQ,CAAC,UAAU,CAAC,YAAY,CAAE,CAAC,CAAC;QAC/F,MAAM,KAAK,GAAG;YACZ,IAAI,EAAE,SAAS;YACf,KAAK;SACN,CAAC;QACF,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,YAAY,CAAE,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/testing-library/dist/env/vitest.js

@@ -606,10 +606,12 @@ const env = {
         await builtinEnvironments.jsdom.setup(fakeGlobal, {});
         const lynxTestingEnv1 = new LynxTestingEnv(fakeGlobal.jsdom);
         global1.lynxTestingEnv = lynxTestingEnv1;
+        global1.Node = lynxTestingEnv1.jsdom.window.Node;
         return {
             teardown (global1) {
                 delete global1.lynxTestingEnv;
                 delete global1.jsdom;
+                delete global1.Node;
             }
         };
     }

package/testing-library/dist/index.d.ts

@@ -970,8 +970,6 @@ export declare class LynxTestingEnv {
     injectGlobals(): void;
     switchToBackgroundThread(): void;
     switchToMainThread(): void;
-    // we do not use it because we have to keep background thread
-    // otherwise we will get error on __MAIN_THREAD__/__BACKGROUND__/lynx not defined etc.
     clearGlobal(): void;
     reset(): void;
 }

package/testing-library/dist/vitest.config.js

@@ -21,7 +21,8 @@ const createVitestConfig = async (options)=>{
     const runtimeDir = path.dirname(vitest_config_require.resolve(`${runtimePkgName}/package.json`));
     const runtimeOSSDir = path.dirname(vitest_config_require.resolve(`${runtimeOSSPkgName}/package.json`, {
         paths: [
-            runtimeDir
+            runtimeDir,
+            vitest_config_dirname
         ]
     }));
     const preactDir = path.dirname(vitest_config_require.resolve('preact/package.json', {
@@ -38,7 +39,8 @@ const createVitestConfig = async (options)=>{
                 find: new RegExp('^' + name + '$'),
                 replacement: vitest_config_require.resolve(name, {
                     paths: [
-                        resolveDir
+                        resolveDir,
+                        vitest_config_dirname
                     ]
                 })
             });