@lynx-js/react-canary 0.115.1-canary-20251212-12a98f76 → 0.115.1

package/CHANGELOG.md

@@ -1,11 +1,28 @@
 # @lynx-js/react
 
-## 0.115.1-canary-20251212065701-12a98f76be08e5c45e147867ea57fecdc968b102
+## 0.115.1
 
 ### Patch Changes
 
 - Auto define lynx.loadLazyBundle when using `import(/* relative path */)`. ([#1956](https://github.com/lynx-family/lynx-stack/pull/1956))
 
+- feat: support declaring cross-thread shared modules via Import Attributes, enabling Main Thread Functions to call standard JS functions directly. ([#1968](https://github.com/lynx-family/lynx-stack/pull/1968))
+
+  - Usage: Add `with { runtime: "shared" }` to the `import` statement. For example:
+
+    ```ts
+    import { func } from './utils.js' with { runtime: 'shared' };
+
+    function worklet() {
+      'main thread';
+      func(); // callable inside a main thread function
+    }
+    ```
+
+  - Limitations:
+    - Only directly imported identifiers are treated as shared; assigning the import to a new variable will result in the loss of this shared capability.
+    - Functions defined within shared modules do not automatically become Main Thread Functions. Accessing main-thread-only APIs (e.g., `MainThreadRef`) will cause errors.
+
 ## 0.115.0
 
 ### Minor Changes
@@ -74,11 +91,11 @@
 - Support testing React Compiler in testing library. Enable React Compiler by setting the `experimental_enableReactCompiler` option of `createVitestConfig` to `true`. ([#1269](https://github.com/lynx-family/lynx-stack/pull/1269))
 
   ```js
-  import { defineConfig, mergeConfig } from "vitest/config";
-  import { createVitestConfig } from "@lynx-js/react/testing-library/vitest-config";
+  import { defineConfig, mergeConfig } from 'vitest/config';
+  import { createVitestConfig } from '@lynx-js/react/testing-library/vitest-config';
 
   const defaultConfig = await createVitestConfig({
-    runtimePkgName: "@lynx-js/react",
+    runtimePkgName: '@lynx-js/react',
     experimental_enableReactCompiler: true,
   });
 
@@ -108,7 +125,7 @@
   ```tsx
   function App() {
     function handleInnerTap(event: MainThread.TouchEvent) {
-      "main thread";
+      'main thread';
       event.stopPropagation();
       // Or stop immediate propagation with
       // event.stopImmediatePropagation();
@@ -206,10 +223,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,
     });
@@ -238,7 +255,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))
@@ -259,7 +276,7 @@
 
   ```ts
   function handleTap() {
-    "main thread";
+    'main thread';
     // The following check always returned false before this fix
     if (myHandleTap) {
       runOnBackground(myHandleTap)();
@@ -320,10 +337,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 />);
   ```
@@ -333,9 +350,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.
@@ -343,7 +360,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
@@ -389,7 +406,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(() => {
     // ...
@@ -495,7 +512,8 @@
      * 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))
@@ -613,7 +631,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))
@@ -665,13 +683,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);
   };
@@ -706,9 +724,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.
@@ -748,7 +766,7 @@
     const f = undefined;
 
     function mts() {
-      "main thread";
+      'main thread';
       // throws in background rendering
       f && runOnBackground(f)();
     }
@@ -782,14 +800,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',
         },
       }),
     ],
@@ -875,22 +893,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
       });
 
@@ -910,7 +928,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.115.1-canary-20251212-12a98f76",
+  "version": "0.115.1",
   "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.15.0
 
 info    build started...
-ready   built in 0.26 s
+ready   built in 0.14 s
 
 File (esm)      Size      
 dist/index.js   10.1 kB