@lynx-js/react-canary 0.114.0 → 0.114.1-canary-20250928-a35a2452

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @lynx-js/react
 
+## 0.114.1-canary-20250928082931-a35a2452e5355bda3c475f9a750a86085e0cf56a
+
+### Patch Changes
+
+- fix: optimize main thread event error message ([#1838](https://github.com/lynx-family/lynx-stack/pull/1838))
+
 ## 0.114.0
 
 ### Minor Changes
@@ -73,10 +79,10 @@
 - Add `animate` API in Main Thread Script(MTS), so you can now control a CSS animation imperatively ([#1534](https://github.com/lynx-family/lynx-stack/pull/1534))
 
   ```ts
-  import type { MainThread } from '@lynx-js/types';
+  import type { MainThread } from "@lynx-js/types";
 
   function startAnimation(ele: MainThread.Element) {
-    'main thread';
+    "main thread";
     const animation = ele.animate([{ opacity: 0 }, { opacity: 1 }], {
       duration: 3000,
     });
@@ -105,7 +111,7 @@
 - Supports `recyclable` attribute in `<list-item>` to control whether the list item is recyclable. The `recyclable` attribute depends on Lynx Engine 3.4 or later. ([#1388](https://github.com/lynx-family/lynx-stack/pull/1388))
 
   ```jsx
-  <list-item recyclable={false} />;
+  <list-item recyclable={false} />
   ```
 
 - feat: Support using a host element as direct child of Suspense ([#1455](https://github.com/lynx-family/lynx-stack/pull/1455))
@@ -126,7 +132,7 @@
 
   ```ts
   function handleTap() {
-    'main thread';
+    "main thread";
     // The following check always returned false before this fix
     if (myHandleTap) {
       runOnBackground(myHandleTap)();
@@ -187,10 +193,10 @@
   Add the import to `@lynx-js/react/debug` at the first line of the entry:
 
   ```js
-  import '@lynx-js/react/debug';
-  import { root } from '@lynx-js/react';
+  import "@lynx-js/react/debug";
+  import { root } from "@lynx-js/react";
 
-  import { App } from './App.jsx';
+  import { App } from "./App.jsx";
 
   root.render(<App />);
   ```
@@ -200,9 +206,9 @@
   For example, you can use it like this:
 
   ```jsx
-  <list-item defer={{ unmountRecycled: true }} item-key='1'>
+  <list-item defer={{ unmountRecycled: true }} item-key="1">
     <WillBeUnmountIfRecycled />
-  </list-item>;
+  </list-item>
   ```
 
   Now the component will be unmounted when it is recycled, which can help with performance in certain scenarios.
@@ -210,7 +216,7 @@
 - Avoid some unexpected `__SetAttribute` in hydrate when `undefined` is passed as an attribute value to intrinsic elements, for example: ([#1318](https://github.com/lynx-family/lynx-stack/pull/1318))
 
   ```jsx
-  <image async-mode={undefined} />;
+  <image async-mode={undefined} />
   ```
 
 ## 0.111.1
@@ -256,7 +262,7 @@
 - Supports `act` in testing library. ([#1182](https://github.com/lynx-family/lynx-stack/pull/1182))
 
   ```js
-  import { act } from '@lynx-js/react/testing-library';
+  import { act } from "@lynx-js/react/testing-library";
 
   act(() => {
     // ...
@@ -362,8 +368,7 @@
      * 3: Full Resolution - Batch render with async property and element tree resolution for list item subtree
      */
     experimental-batch-render-strategy={3}
-  >
-  </list>;
+  ></list>
   ```
 
 - rename @lynx-js/test-environment to @lynx-js/testing-environment ([#704](https://github.com/lynx-family/lynx-stack/pull/704))
@@ -481,7 +486,7 @@
   You can now use `useErrorBoundary` it in TypeScript like this:
 
   ```tsx
-  import { useErrorBoundary } from '@lynx-js/react';
+  import { useErrorBoundary } from "@lynx-js/react";
   ```
 
 - Modified the format of data sent from background threads to the main thread. ([#207](https://github.com/lynx-family/lynx-stack/pull/207))
@@ -533,13 +538,13 @@
   Now you can get the return value from `runOnBackground()` and `runOnMainThread()`, which enables more flexible data flow between the main thread and the background thread.
 
   ```js
-  import { runOnBackground } from '@lynx-js/react';
+  import { runOnBackground } from "@lynx-js/react";
 
   const onTap = async () => {
-    'main thread';
+    "main thread";
     const text = await runOnBackground(() => {
-      'background only';
-      return 'Hello, world!';
+      "background only";
+      return "Hello, world!";
     })();
     console.log(text);
   };
@@ -574,9 +579,9 @@
 
   ```ts
   // These imports will be removed from the final bundle
-  import type { Foo } from 'xyz';
-  import { type Bar } from 'xyz';
-  import { xyz } from 'xyz'; // When xyz is not used
+  import type { Foo } from "xyz";
+  import { type Bar } from "xyz";
+  import { xyz } from "xyz"; // When xyz is not used
   ```
 
   See [TypeScript - verbatimModuleSyntax](https://www.typescriptlang.org/tsconfig/#verbatimModuleSyntax) for details.
@@ -616,7 +621,7 @@
     const f = undefined;
 
     function mts() {
-      'main thread';
+      "main thread";
       // throws in background rendering
       f && runOnBackground(f)();
     }
@@ -650,14 +655,14 @@
 - a30c83d: Add `compat.removeComponentAttrRegex`.
 
   ```js
-  import { pluginReactLynx } from '@lynx-js/react-rsbuild-plugin';
-  import { defineConfig } from '@lynx-js/rspeedy';
+  import { pluginReactLynx } from "@lynx-js/react-rsbuild-plugin";
+  import { defineConfig } from "@lynx-js/rspeedy";
 
   export default defineConfig({
     plugins: [
       pluginReactLynx({
         compat: {
-          removeComponentAttrRegex: 'YOUR REGEX',
+          removeComponentAttrRegex: "YOUR REGEX",
         },
       }),
     ],
@@ -743,22 +748,22 @@
   Gesture Handler is a set of gesture handling capabilities built on top of the Main Thread Script. It currently supports drag, inertial scrolling, long press, and tap gestures for `<view>`, `<scroll-view>`, `<list>`, and `<text>`. In the future, it will also support multi-finger zoom, multi-finger rotation, and other gesture capabilities.
 
   ```tsx
-  import { useGesture, PanGesture } from '@lynx-js/gesture-runtime';
+  import { useGesture, PanGesture } from "@lynx-js/gesture-runtime";
 
   function App() {
     const pan = useGesture(PanGesture);
 
     pan
       .onBegin((event, stateManager) => {
-        'main thread';
+        "main thread";
         // some logic
       })
       .onUpdate((event, stateManager) => {
-        'main thread';
+        "main thread";
         // some logic
       })
       .onEnd((event, stateManager) => {
-        'main thread';
+        "main thread";
         // some logic
       });
 
@@ -778,7 +783,7 @@
       return;
     }
 
-    console.log('not __LEPUS__'); // This can be removed now
+    console.log("not __LEPUS__"); // This can be removed now
   }
   ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynx-js/react-canary",
-  "version": "0.114.0",
+  "version": "0.114.1-canary-20250928-a35a2452",
   "description": "ReactLynx is a framework for developing Lynx applications with familiar React.",
   "repository": {
     "type": "git",

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

@@ -5,7 +5,7 @@
   Rslib v0.13.3
 
 info    build started...
-ready   built in 0.20 s
+ready   built in 0.12 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"}