PupilTong · pull · May 8, 2025 · May 8, 2025 · May 8, 2025 · May 8, 2025
diff --git a/.github/renovate.json5 b/.github/renovate.json5
@@ -5,6 +5,7 @@
     ":automergeStableNonMajor",
     ":automergeTypes",
     ":maintainLockFilesWeekly",
+    "helpers:pinGitHubActionDigests",
   ],
 
   "enabledManagers": [
@@ -105,6 +106,11 @@
       ],
       "rangeStrategy": "widen",
     },
+    {
+      "groupName": "github-actions",
+      "groupSlug": "github-actions",
+      "matchManagers": ["github-actions"],
+    },
   ],
   "postUpdateOptions": [
     "pnpmDedupe",

diff --git a/package.json b/package.json
@@ -42,7 +42,7 @@
     "lint-staged": "^15.5.2",
     "sort-package-json": "^3.2.0",
     "ts-patch": "^3.3.0",
-    "turbo": "^2.5.2",
+    "turbo": "^2.5.3",
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.32.0",
     "vitest": "^3.1.3"

diff --git a/packages/background-only/README.md b/packages/background-only/README.md
@@ -0,0 +1,60 @@
+# background-only
+
+This package serves as a mark package to enforce and mark modules that should only be used in the Background Thread context. It provides type definitions and runtime checks to ensure proper usage.
+
+## Example Usages
+
+Say we have a `Logger` module that has side effects calling into Native Modules or other APIs that are only available in the "Background" environment:
+
+```tsx
+// Logger.js
+import "background-only";
+
+export function log(msg) {
+  // Notice how we are calling into NativeModules here.
+  NativeModules.hybridMonitor.reportJSError(...);
+}
+```
+
+By adding `import "background-only"` to poison this module, we are now declaring that this module is only safe to be bundled in a "Background" environment, protecting this module from being accidentally bundled into a "Main thread" environment by throwing an error at runtime.
+
+For example, if we use `log` in a desirable position from a React component, such as in `useEffect` or an event handler, the `log` will work as expected:
+
+```tsx
+// App.jsx
+import { log } from "./Logger";
+
+function App() {
+  useEffect() {
+    log();
+  }
+  return <view />
+}
+```
+
+However, if we use `log` in a undesirable position from a React component, such as in the body of the rendering function, it will throw an error at runtime time:
+
+```tsx
+// App.jsx
+import { log } from './Logger';
+
+function App() {
+  // throw!
+  log();
+  return <view />;
+}
+```
+
+## Development Note
+
+This package is already in its final form and does not require build or test steps. The files are simple enough to be used as-is.
+
+The package consists of three files in their final form:
+
+- `error.js` - Throws an error when imported in the wrong context
+- `empty.js` - An empty module for the default export
+- `index.d.ts` - TypeScript type definitions (empty)
+
+## Credits
+
+This is inspired by the [`server-only`](https://www.npmjs.com/package/server-only?activeTab=readme) package of React.
diff --git a/packages/background-only/empty.js b/packages/background-only/empty.js
@@ -0,0 +1,3 @@
+// Copyright 2024 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.
diff --git a/packages/background-only/error.js b/packages/background-only/error.js
@@ -0,0 +1,7 @@
+// Copyright 2024 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.
+throw new Error(
+  'This module cannot be imported from a Main Thread module. '
+    + 'It should only be used from a Background Thread.',
+);
diff --git a/packages/background-only/index.d.ts b/packages/background-only/index.d.ts
@@ -0,0 +1,4 @@
+// Copyright 2024 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 {};
diff --git a/packages/background-only/package.json b/packages/background-only/package.json
@@ -0,0 +1,35 @@
+{
+  "name": "background-only",
+  "version": "0.0.1",
+  "description": "This is a marker package to indicate that a module can only be used in the Background Thread.",
+  "keywords": [
+    "react",
+    "lynx"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lynx-family/lynx-stack.git",
+    "directory": "packages/background-only"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "lepus": {
+        "types": "./index.d.ts",
+        "default": "./error.js"
+      },
+      "default": {
+        "types": "./index.d.ts",
+        "default": "./empty.js"
+      }
+    }
+  },
+  "main": "empty.js",
+  "types": "index.d.ts",
+  "files": [
+    "error.js",
+    "empty.js",
+    "index.d.ts"
+  ]
+}
diff --git a/packages/background-only/tsconfig.json b/packages/background-only/tsconfig.json
@@ -0,0 +1,12 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": ".",
+    "composite": true,
+  },
+  "include": [
+    "*.ts",
+    "*.d.ts",
+  ],
+}
diff --git a/packages/rspeedy/core/package.json b/packages/rspeedy/core/package.json
@@ -79,7 +79,7 @@
     "typia": "9.1.1",
     "typia-rspack-plugin": "2.0.1",
     "vitest": "^3.1.3",
-    "webpack": "^5.99.7"
+    "webpack": "^5.99.8"
   },
   "peerDependencies": {
     "typescript": "5.1.6 - 5.8.x"

diff --git a/packages/rspeedy/create-rspeedy/package.json b/packages/rspeedy/create-rspeedy/package.json
@@ -35,7 +35,7 @@
     "test": "vitest"
   },
   "dependencies": {
-    "create-rstack": "1.4.0"
+    "create-rstack": "1.4.1"
   },
   "devDependencies": {
     "@lynx-js/qrcode-rsbuild-plugin": "workspace:^",

diff --git a/packages/rspeedy/plugin-react/package.json b/packages/rspeedy/plugin-react/package.json
@@ -44,7 +44,7 @@
     "@lynx-js/runtime-wrapper-webpack-plugin": "workspace:*",
     "@lynx-js/template-webpack-plugin": "workspace:*",
     "@lynx-js/web-webpack-plugin": "workspace:*",
-    "background-only": "^0.0.1"
+    "background-only": "workspace:^"
   },
   "devDependencies": {
     "@lynx-js/react": "workspace:*",

diff --git a/packages/tools/vitest-setup/package.json b/packages/tools/vitest-setup/package.json
@@ -19,7 +19,7 @@
   "devDependencies": {
     "path-serializer": "^0.4.0",
     "vitest": "^3.1.3",
-    "webpack": "^5.99.7"
+    "webpack": "^5.99.8"
   },
   "engines": {
     "node": ">=18"

diff --git a/packages/webpack/chunk-loading-webpack-plugin/package.json b/packages/webpack/chunk-loading-webpack-plugin/package.json
@@ -46,7 +46,7 @@
     "@rspack/core": "catalog:rspack",
     "css-loader": "^7.1.2",
     "mini-css-extract-plugin": "^2.9.2",
-    "webpack": "^5.99.7"
+    "webpack": "^5.99.8"
   },
   "peerDependencies": {
     "@rspack/core": "^1.3.0"

diff --git a/packages/webpack/css-extract-webpack-plugin/package.json b/packages/webpack/css-extract-webpack-plugin/package.json
@@ -56,7 +56,7 @@
     "@rspack/core": "catalog:rspack",
     "css-loader": "^7.1.2",
     "sass-loader": "^16.0.5",
-    "webpack": "^5.99.7"
+    "webpack": "^5.99.8"
   },
   "peerDependencies": {
     "@lynx-js/template-webpack-plugin": "^0.5.0 || ^0.6.0"

diff --git a/packages/webpack/react-refresh-webpack-plugin/package.json b/packages/webpack/react-refresh-webpack-plugin/package.json
@@ -45,7 +45,7 @@
     "@microsoft/api-extractor": "catalog:",
     "@rspack/core": "catalog:rspack",
     "swc-loader": "^0.2.6",
-    "webpack": "^5.99.7"
+    "webpack": "^5.99.8"
   },
   "peerDependencies": {
     "@lynx-js/react-webpack-plugin": "^0.3.0 || ^0.4.0 || ^0.5.0 || ^0.6.0"

diff --git a/packages/webpack/react-webpack-plugin/package.json b/packages/webpack/react-webpack-plugin/package.json
@@ -50,7 +50,7 @@
     "@rspack/core": "catalog:rspack",
     "css-loader": "^7.1.2",
     "swc-loader": "^0.2.6",
-    "webpack": "^5.99.7"
+    "webpack": "^5.99.8"
   },
   "peerDependencies": {
     "@lynx-js/react": "^0.103.0 || ^0.104.0 || ^0.105.0 || ^0.106.0 || ^0.107.0 || ^0.108.0",

diff --git a/packages/webpack/runtime-wrapper-webpack-plugin/package.json b/packages/webpack/runtime-wrapper-webpack-plugin/package.json
@@ -41,7 +41,7 @@
   "devDependencies": {
     "@lynx-js/test-tools": "workspace:*",
     "@microsoft/api-extractor": "catalog:",
-    "webpack": "^5.99.7"
+    "webpack": "^5.99.8"
   },
   "engines": {
     "node": ">=18"

diff --git a/packages/webpack/template-webpack-plugin/package.json b/packages/webpack/template-webpack-plugin/package.json
@@ -49,7 +49,7 @@
     "@microsoft/api-extractor": "catalog:",
     "@types/css-tree": "^2.3.10",
     "@types/object.groupby": "^1.0.4",
-    "webpack": "^5.99.7"
+    "webpack": "^5.99.8"
   },
   "engines": {
     "node": ">=18"

diff --git a/packages/webpack/test-tools/package.json b/packages/webpack/test-tools/package.json
@@ -26,7 +26,7 @@
     "rimraf": "^6.0.1",
     "source-map": "^0.7.4",
     "tiny-invariant": "^1.3.3",
-    "webpack": "^5.99.7",
+    "webpack": "^5.99.8",
     "webpack-merge": "^6.0.1"
   },
   "engines": {

diff --git a/packages/webpack/web-webpack-plugin/package.json b/packages/webpack/web-webpack-plugin/package.json
@@ -31,7 +31,7 @@
   "devDependencies": {
     "@lynx-js/template-webpack-plugin": "workspace:*",
     "@lynx-js/test-tools": "workspace:*",
-    "webpack": "^5.99.7"
+    "webpack": "^5.99.8"
   },
   "peerDependencies": {
     "@lynx-js/template-webpack-plugin": "^0.6.0"

diff --git a/packages/webpack/webpack-dev-transport/package.json b/packages/webpack/webpack-dev-transport/package.json
@@ -58,7 +58,7 @@
   },
   "devDependencies": {
     "@microsoft/api-extractor": "catalog:",
-    "webpack": "^5.99.7"
+    "webpack": "^5.99.8"
   },
   "engines": {
     "node": ">=18"