refactor(react): remove worklet runtime shell package

.github/workflows/test.yml

@@ -220,7 +220,6 @@ jobs:
       run: >
         pnpm
         --filter @lynx-js/react-runtime
-        --filter @lynx-js/react-worklet-runtime
         --filter @lynx-js/react-transform
         run test
         --reporter=github-actions

eslint.config.js

@@ -87,6 +87,8 @@ export default tseslint.config(
       'packages/react/runtime/jsx-runtime/**',
       'packages/react/runtime/lazy/**',
       'packages/react/runtime/lepus/**',
+      // Generated worklet bundles are published assets, not source files.
+      'packages/react/runtime/worklet-runtime/**',
       'packages/react/runtime/src/renderToOpcodes/**',
       'packages/react/runtime/types/**',
 

packages/react/package.json

@@ -77,11 +77,11 @@
     },
     "./worklet-runtime": {
       "types": "./runtime/lib/worklet-runtime/index.d.ts",
-      "default": "./worklet-runtime/dist/main.js"
+      "default": "./runtime/worklet-runtime/main.js"
     },
     "./worklet-dev-runtime": {
       "types": "./runtime/lib/worklet-runtime/index.d.ts",
-      "default": "./worklet-runtime/dist/dev.js"
+      "default": "./runtime/worklet-runtime/dev.js"
     },
     "./worklet-runtime/bindings": {
       "types": "./runtime/lib/worklet-runtime/bindings/index.d.ts",
@@ -163,14 +163,14 @@
     "transform",
     "types",
     "docs",
-    "worklet-runtime",
     "testing-library",
     "CHANGELOG.md",
     "internal.js",
     "README.md",
     "README.zh.md"
   ],
   "scripts": {
+    "build": "rslib build",
     "api-extractor": "api-extractor run --verbose"
   },
   "dependencies": {

packages/react/worklet-runtime/rslib.config.ts → packages/react/rslib.config.ts

@@ -1,4 +1,4 @@
-// Copyright 2025 The Lynx Authors. All rights reserved.
+// Copyright 2026 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.
 
@@ -15,13 +15,16 @@ export default defineConfig({
           __DEV__: 'true',
         },
         entry: {
-          dev: '../runtime/src/worklet-runtime/index.ts',
+          dev: './runtime/src/worklet-runtime/index.ts',
         },
       },
       output: {
         sourceMap: {
           js: 'inline-source-map',
         },
+        distPath: {
+          root: './runtime/worklet-runtime',
+        },
       },
     },
     {
@@ -33,11 +36,14 @@ export default defineConfig({
           __DEV__: 'false',
         },
         entry: {
-          main: '../runtime/src/worklet-runtime/index.ts',
+          main: './runtime/src/worklet-runtime/index.ts',
         },
       },
       output: {
         minify: true,
+        distPath: {
+          root: './runtime/worklet-runtime',
+        },
       },
     },
   ],

packages/react/runtime/.gitignore

@@ -1,3 +1,4 @@
 coverage/
 lib/
+/worklet-runtime/
 !debug

packages/react/runtime/.npmignore

@@ -11,3 +11,5 @@
 !lepus/*
 !lib/**
 !lib/*
+!worklet-runtime/*
+!worklet-runtime/**

packages/react/runtime/package.json

@@ -15,6 +15,7 @@
     "src"
   ],
   "scripts": {
+    "build": "tsc --build",
     "test": "vitest run --coverage"
   },
   "devDependencies": {

packages/react/runtime/src/worklet-runtime/api/lepusQuerySelector.ts

@@ -13,12 +13,20 @@ class PageElement {
 }
 
 export function querySelector(cssSelector: string): Element | null {
-  const element = __QuerySelector(PageElement.get(), cssSelector, {});
+  const pageElement = PageElement.get();
+  if (!pageElement) {
+    return null;
+  }
+  const element = __QuerySelector(pageElement, cssSelector, {});
   return element ? new Element(element) : null;
 }
 
 export function querySelectorAll(cssSelector: string): Element[] {
-  return __QuerySelectorAll(PageElement.get(), cssSelector, {}).map(
+  const pageElement = PageElement.get();
+  if (!pageElement) {
+    return [];
+  }
+  return __QuerySelectorAll(pageElement, cssSelector, {}).map(
     (element) => {
       return new Element(element);
     },

packages/react/runtime/tsconfig.json

@@ -3,14 +3,19 @@
   "compilerOptions": {
     "composite": true,
     "outDir": "./lib",
+    // Keep incremental metadata under lib so clearing generated outputs also
+    // invalidates the runtime build cache for worklet-runtime artifacts.
+    "tsBuildInfoFile": "./lib/tsconfig.tsbuildinfo",
     "baseUrl": "./",
+    "paths": {
+      // Resolve the public bindings specifier back to source while building
+      // runtime itself, so the emitted lib output never becomes its own input.
+      "@lynx-js/react/worklet-runtime/bindings": ["./src/worklet-runtime/bindings/index.ts"],
+    },
     "rootDir": "./src",
     "jsx": "react-jsx",
     "jsxImportSource": "./",
   },
-  "references": [{
-    "path": "../worklet-runtime/tsconfig.json",
-  }],
   "include": [
     "debug",
     "jsx-dev-runtime",

packages/react/worklet-runtime/turbo.json → packages/react/runtime/turbo.json

@@ -5,11 +5,16 @@
     "build": {
       "dependsOn": [],
       "inputs": [
-        "../runtime/src/worklet-runtime/**",
-        "rslib.config.ts"
+        "debug/**",
+        "jsx-dev-runtime/**",
+        "jsx-runtime/**",
+        "lepus/**",
+        "src/**",
+        "types/**",
+        "tsconfig.json"
       ],
       "outputs": [
-        "dist"
+        "lib/**"
       ]
     }
   }

packages/react/runtime/vitest.config.ts

@@ -84,6 +84,7 @@ export default defineConfig({
         'vitest.config.ts',
         '__test__/utils/**',
         'lib/**',
+        'worklet-runtime/**',
         'src/index.ts',
         'src/lynx.ts',
         'src/root.ts',

packages/react/tsconfig.json

@@ -11,9 +11,6 @@
     {
       "path": "./components/tsconfig.json",
     },
-    {
-      "path": "./worklet-runtime/tsconfig.json",
-    },
     {
       "path": "./transform/rspack-napi/tsconfig.json",
     }

packages/react/turbo.json

@@ -5,10 +5,17 @@
     "build": {
       "dependsOn": [
         "@lynx-js/react-refresh#build",
+        "@lynx-js/react-runtime#build",
         "@lynx-js/react-transform#build:wasm",
-        "@lynx-js/react-worklet-runtime#build",
         "@lynx-js/reactlynx-testing-library#build",
         "@lynx-js/testing-environment#build"
+      ],
+      "inputs": [
+        "runtime/src/worklet-runtime/**",
+        "rslib.config.ts"
+      ],
+      "outputs": [
+        "runtime/worklet-runtime/**"
       ]
     }
   }

pnpm-workspace.yaml

@@ -13,7 +13,6 @@ packages:
   - packages/react/transform/rspack-napi
   - packages/react/transform/swc-plugin-reactlynx
   - packages/react/transform/swc-plugin-reactlynx-compat
-  - packages/react/worklet-runtime
   - packages/react-umd
   - packages/rspeedy/*
   - packages/tailwind-preset