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

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/worklet-runtime/__test__/runtimeSourceLayout.test.js → packages/react/runtime/__test__/worklet-runtime/runtimeSourceLayout.test.js

@@ -8,17 +8,21 @@ import { fileURLToPath } from 'node:url';
 import { describe, expect, test } from 'vitest';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const reactPackagesDir = path.resolve(__dirname, '..', '..');
+const reactPackagesDir = path.resolve(__dirname, '..', '..', '..');
 const reactPackageJsonPath = path.join(reactPackagesDir, 'package.json');
-const workletRuntimePackageJsonPath = path.join(
+const runtimeWorkletRuntimeDir = path.join(
   reactPackagesDir,
+  'runtime',
+  'src',
   'worklet-runtime',
-  'package.json',
 );
-const runtimeWorkletRuntimeDir = path.join(
+const runtimeWorkletRuntimeBundleDir = path.join(
   reactPackagesDir,
   'runtime',
-  'src',
+  'worklet-runtime',
+);
+const retiredWorkletRuntimePackageDir = path.join(
+  reactPackagesDir,
   'worklet-runtime',
 );
 
@@ -36,38 +40,26 @@ describe('runtime-local worklet-runtime source layout', () => {
     }
   });
 
-  test('keeps the shell package focused on dist-only worklet bundle outputs', () => {
-    const workletRuntimePackageJson = JSON.parse(
-      fs.readFileSync(workletRuntimePackageJsonPath, 'utf8'),
-    );
-
-    expect(workletRuntimePackageJson.exports['.']).toEqual({
-      default: './dist/main.js',
-    });
-    expect(workletRuntimePackageJson.exports['./dev']).toEqual({
-      default: './dist/dev.js',
-    });
-    expect(workletRuntimePackageJson.main).toBe('dist/main.js');
-    expect(workletRuntimePackageJson.module).toBe('dist/main.js');
-    expect(
-      fs.existsSync(path.join(reactPackagesDir, 'worklet-runtime', 'src')),
-    ).toBe(false);
+  test('keeps worklet bundle outputs under runtime and retires the shell package', () => {
+    expect(retiredWorkletRuntimePackageDir).not.toBe(runtimeWorkletRuntimeBundleDir);
+    expect(fs.existsSync(retiredWorkletRuntimePackageDir)).toBe(false);
   });
 
   test('preserves the public worklet-runtime export targets on @lynx-js/react', () => {
     const reactPackageJson = JSON.parse(fs.readFileSync(reactPackageJsonPath, 'utf8'));
 
     expect(reactPackageJson.exports['./worklet-runtime']).toEqual({
       types: './runtime/lib/worklet-runtime/index.d.ts',
-      default: './worklet-runtime/dist/main.js',
+      default: './runtime/worklet-runtime/main.js',
     });
     expect(reactPackageJson.exports['./worklet-dev-runtime']).toEqual({
       types: './runtime/lib/worklet-runtime/index.d.ts',
-      default: './worklet-runtime/dist/dev.js',
+      default: './runtime/worklet-runtime/dev.js',
     });
     expect(reactPackageJson.exports['./worklet-runtime/bindings']).toEqual({
       types: './runtime/lib/worklet-runtime/bindings/index.d.ts',
       default: './runtime/lib/worklet-runtime/bindings/index.js',
     });
+    expect(reactPackageJson.files).not.toContain('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/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