rsbuild-plugin-workspace-dev 0.0.1 → 0.1.0

package/README.md

@@ -104,10 +104,11 @@ interface projects {
    */
   match?: (stdout: string) => boolean;
   /**
-   * Whether to skip starting the current sub-project. Default is `false`.
-   * Useful for sub-projects that do not need to be started.
-   */
-  skip?: boolean;
+    * Whether to skip starting the current sub-project. The default value is `false`, typically used to skip sub-projects that don't need to be started.
+    * When the value is `true`, pruning will be performed on the specified project, meaning that this project and all its direct and indirect dependencies will not be started by the plugin.
+    * When the value is `only`, starting the specified project will be skipped, but no pruning will be performed, meaning that the project's direct and indirect dependencies will still be started by the plugin.
+  */
+  skip?: boolean | 'only';
 }
 
 

package/README.zh-CN.md

@@ -99,8 +99,10 @@ interface Projects {
   match?: (stdout: string) => boolean;
   /**
    * 是否跳过当前子项目的启动，默认值为 `false`，通常用于跳过一些不需要启动的子项目。
+   * 当值为 `true` 时，会从指定项目进行剪枝，这意味着该项目以及他的所有直接和间接依赖都不会被插件启动。
+   * 当值为 `only` 时，会跳过指定项目的启动，但不会进行剪枝，这意味着该项目的直接和间接依赖仍然会被插件启动。
    */
-  skip?: boolean;
+  skip?: boolean | 'only';
 }
 
 // 例如，配置 lib1 子项目，用 build:watch 命令启动，匹配 watch success 日志

package/dist/constant.d.ts

@@ -1,5 +1,5 @@
 export declare const PACKAGE_JSON = "package.json";
-export declare const DEBUG_LOG_TITLE = "[Rsbuild Workspace Dev Plugin]: ";
+export declare const PLUGIN_LOG_TITLE = "[Rsbuild Workspace Dev Plugin]: ";
 export declare const RSLIB_READY_MESSAGE = "build complete, watching for changes";
 export declare const MODERN_MODULE_READY_MESSAGE = "Watching for file changes";
 export declare const TSUP_READY_MESSAGE = "Watching for changes in";

package/dist/index.cjs

@@ -39,7 +39,7 @@ __webpack_require__.d(__webpack_exports__, {
 const external_chalk_namespaceObject = require("chalk");
 var external_chalk_default = /*#__PURE__*/ __webpack_require__.n(external_chalk_namespaceObject);
 const PACKAGE_JSON = 'package.json';
-const DEBUG_LOG_TITLE = '[Rsbuild Workspace Dev Plugin]: ';
+const PLUGIN_LOG_TITLE = '[Rsbuild Workspace Dev Plugin]: ';
 const RSLIB_READY_MESSAGE = 'build complete, watching for changes';
 const MODERN_MODULE_READY_MESSAGE = 'Watching for file changes';
 const TSUP_READY_MESSAGE = 'Watching for changes in';
@@ -107,10 +107,10 @@ class Logger {
         this.name = name;
         this.stdout = '';
         this.stderr = '';
-        this.logTitle = DEBUG_LOG_TITLE;
+        this.logTitle = PLUGIN_LOG_TITLE;
     }
 }
-const debugLog = (msg, prefix = DEBUG_LOG_TITLE)=>{
+const debugLog = (msg, prefix = PLUGIN_LOG_TITLE)=>{
     if (isDebug) console.log(prefix + msg);
 };
 const get_packages_namespaceObject = require("@manypkg/get-packages");
@@ -147,6 +147,8 @@ class WorkspaceDevRunner {
                 packageJson,
                 path: dir
             };
+            const skip = this.options.projects?.[name]?.skip;
+            if (true === skip) return;
             this.graph.setNode(name, node);
             this.visited[name] = false;
             this.visiting[name] = false;
@@ -159,12 +161,13 @@ class WorkspaceDevRunner {
             };
             for (const depName of Object.keys(deps)){
                 const isInternalDep = this.packages.some((p)=>p.packageJson.name === depName);
-                if (isInternalDep) {
+                const skip = this.options.projects?.[depName]?.skip;
+                if (isInternalDep) if (true !== skip) {
                     this.graph.setEdge(packageName, depName);
                     this.checkGraph();
                     const depPackage = packages.find((pkg)=>pkg.packageJson.name === depName);
                     if (!this.getNode(depName)) initNode(depPackage);
-                }
+                } else debugLog(`Prune project ${depName} and its dependencies because it is marked as skip: true`);
             }
         };
         initNode(currentPackage);
@@ -172,8 +175,11 @@ class WorkspaceDevRunner {
     checkGraph() {
         const cycles = external_graphlib_default().alg.findCycles(this.graph);
         const nonSelfCycles = cycles.filter((c)=>1 !== c.length);
-        debugLog(`cycles check: ${cycles}`);
-        if (nonSelfCycles.length) throw new Error(`${DEBUG_LOG_TITLE}Dependency graph do not allow cycles.`);
+        const nonSkipCycles = nonSelfCycles.filter((group)=>{
+            const isSkip = group.some((node)=>this.options.projects?.[node]?.skip);
+            return !isSkip;
+        });
+        if (nonSkipCycles.length) throw new Error(`${PLUGIN_LOG_TITLE} Cycle dependency graph found: ${nonSkipCycles}, you should config projects in plugin options to skip someone, or fix the cycle dependency. Otherwise, a loop of dev will occur.`);
     }
     async start() {
         const promises = [];
@@ -185,7 +191,8 @@ class WorkspaceDevRunner {
             const canStart = dependencies.every((dep)=>{
                 const selfStart = node === dep;
                 const isVisiting = this.visiting[dep];
-                const isVisited = selfStart || this.visited[dep];
+                const skipDep = this.options.projects?.[dep]?.skip;
+                const isVisited = selfStart || this.visited[dep] || skipDep;
                 return isVisited && !isVisiting;
             });
             if (canStart && !this.visited[node] && !this.visiting[node]) {
@@ -207,7 +214,7 @@ class WorkspaceDevRunner {
                 this.visited[node] = true;
                 this.visiting[node] = false;
                 debugLog(`Skip visit node: ${node}`);
-                logger.emitLogOnce('stdout', `skip visit node: ${name}`);
+                logger.emitLogOnce('stdout', `Skip visit node: ${name}`);
                 return this.start().then(()=>resolve());
             }
             this.visiting[node] = true;
@@ -303,6 +310,16 @@ function pluginWorkspaceDev(options) {
                 await runner.start();
                 Logger.setEndBanner();
             });
+            api.onBeforeBuild(async ({ isWatch, isFirstCompile })=>{
+                if (!isWatch || !isFirstCompile) return;
+                const runner = new WorkspaceDevRunner({
+                    cwd: rootPath,
+                    ...options
+                });
+                await runner.init();
+                await runner.start();
+                Logger.setEndBanner();
+            });
         }
     };
 }

package/dist/index.js

@@ -6,7 +6,7 @@ import { spawn } from "child_process";
 import graphlib, { Graph } from "graphlib";
 import path_0 from "path";
 const PACKAGE_JSON = 'package.json';
-const DEBUG_LOG_TITLE = '[Rsbuild Workspace Dev Plugin]: ';
+const PLUGIN_LOG_TITLE = '[Rsbuild Workspace Dev Plugin]: ';
 const RSLIB_READY_MESSAGE = 'build complete, watching for changes';
 const MODERN_MODULE_READY_MESSAGE = 'Watching for file changes';
 const TSUP_READY_MESSAGE = 'Watching for changes in';
@@ -70,10 +70,10 @@ class Logger {
         this.name = name;
         this.stdout = '';
         this.stderr = '';
-        this.logTitle = DEBUG_LOG_TITLE;
+        this.logTitle = PLUGIN_LOG_TITLE;
     }
 }
-const debugLog = (msg, prefix = DEBUG_LOG_TITLE)=>{
+const debugLog = (msg, prefix = PLUGIN_LOG_TITLE)=>{
     if (isDebug) console.log(prefix + msg);
 };
 function workspace_dev_define_property(obj, key, value) {
@@ -104,6 +104,8 @@ class WorkspaceDevRunner {
                 packageJson,
                 path: dir
             };
+            const skip = this.options.projects?.[name]?.skip;
+            if (true === skip) return;
             this.graph.setNode(name, node);
             this.visited[name] = false;
             this.visiting[name] = false;
@@ -116,12 +118,13 @@ class WorkspaceDevRunner {
             };
             for (const depName of Object.keys(deps)){
                 const isInternalDep = this.packages.some((p)=>p.packageJson.name === depName);
-                if (isInternalDep) {
+                const skip = this.options.projects?.[depName]?.skip;
+                if (isInternalDep) if (true !== skip) {
                     this.graph.setEdge(packageName, depName);
                     this.checkGraph();
                     const depPackage = packages.find((pkg)=>pkg.packageJson.name === depName);
                     if (!this.getNode(depName)) initNode(depPackage);
-                }
+                } else debugLog(`Prune project ${depName} and its dependencies because it is marked as skip: true`);
             }
         };
         initNode(currentPackage);
@@ -129,8 +132,11 @@ class WorkspaceDevRunner {
     checkGraph() {
         const cycles = graphlib.alg.findCycles(this.graph);
         const nonSelfCycles = cycles.filter((c)=>1 !== c.length);
-        debugLog(`cycles check: ${cycles}`);
-        if (nonSelfCycles.length) throw new Error(`${DEBUG_LOG_TITLE}Dependency graph do not allow cycles.`);
+        const nonSkipCycles = nonSelfCycles.filter((group)=>{
+            const isSkip = group.some((node)=>this.options.projects?.[node]?.skip);
+            return !isSkip;
+        });
+        if (nonSkipCycles.length) throw new Error(`${PLUGIN_LOG_TITLE} Cycle dependency graph found: ${nonSkipCycles}, you should config projects in plugin options to skip someone, or fix the cycle dependency. Otherwise, a loop of dev will occur.`);
     }
     async start() {
         const promises = [];
@@ -142,7 +148,8 @@ class WorkspaceDevRunner {
             const canStart = dependencies.every((dep)=>{
                 const selfStart = node === dep;
                 const isVisiting = this.visiting[dep];
-                const isVisited = selfStart || this.visited[dep];
+                const skipDep = this.options.projects?.[dep]?.skip;
+                const isVisited = selfStart || this.visited[dep] || skipDep;
                 return isVisited && !isVisiting;
             });
             if (canStart && !this.visited[node] && !this.visiting[node]) {
@@ -164,7 +171,7 @@ class WorkspaceDevRunner {
                 this.visited[node] = true;
                 this.visiting[node] = false;
                 debugLog(`Skip visit node: ${node}`);
-                logger.emitLogOnce('stdout', `skip visit node: ${name}`);
+                logger.emitLogOnce('stdout', `Skip visit node: ${name}`);
                 return this.start().then(()=>resolve());
             }
             this.visiting[node] = true;
@@ -260,6 +267,16 @@ function pluginWorkspaceDev(options) {
                 await runner.start();
                 Logger.setEndBanner();
             });
+            api.onBeforeBuild(async ({ isWatch, isFirstCompile })=>{
+                if (!isWatch || !isFirstCompile) return;
+                const runner = new WorkspaceDevRunner({
+                    cwd: rootPath,
+                    ...options
+                });
+                await runner.init();
+                await runner.start();
+                Logger.setEndBanner();
+            });
         }
     };
 }

package/dist/workspace-dev.d.ts

@@ -5,7 +5,7 @@ export interface WorkspaceDevRunnerOptions {
     projects?: Record<string, {
         match?: (stdout: string) => boolean;
         command?: string;
-        skip?: boolean;
+        skip?: boolean | 'only';
     }>;
     startCurrent?: boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rsbuild-plugin-workspace-dev",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "An Rsbuild plugin to provides workspace recursive dev functionality for Monorepo topologies.",
   "repository": "https://github.com/rspack-contrib/rsbuild-plugin-workspace-dev",
   "license": "MIT",
@@ -18,6 +18,17 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "rslib build",
+    "bump": "npx bumpp",
+    "dev": "rslib build --watch",
+    "lint": "biome check .",
+    "lint:write": "biome check . --write",
+    "prepare": "simple-git-hooks && npm run build",
+    "test": "pnpm run test:unit && pnpm run test:e2e",
+    "test:e2e": "playwright test --config=./test/playwright.config.ts",
+    "test:unit": "rstest --config=./test/rstest.config.ts"
+  },
   "simple-git-hooks": {
     "pre-commit": "npx nano-staged"
   },
@@ -27,12 +38,10 @@
     ]
   },
   "dependencies": {
-    "fast-glob": "^3.3.3",
-    "json5": "^2.2.3",
-    "yaml": "^2.8.1",
     "@manypkg/get-packages": "^3.1.0",
+    "chalk": "^5.6.2",
     "graphlib": "^2.1.8",
-    "chalk": "^5.6.2"
+    "json5": "^2.2.3"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.3",
@@ -41,6 +50,8 @@
     "@rsbuild/plugin-react": "^1.4.1",
     "@rsbuild/plugin-type-check": "^1.3.0",
     "@rslib/core": "^0.17.0",
+    "@rstest/core": "^0.6.6",
+    "@types/graphlib": "^2.1.12",
     "@types/node": "^22.18.8",
     "@types/react": "^19.1.16",
     "@types/react-dom": "^19.1.9",
@@ -48,9 +59,7 @@
     "react": "^19.1.1",
     "react-dom": "^19.1.1",
     "simple-git-hooks": "^2.13.1",
-    "typescript": "^5.9.3",
-    "@types/graphlib": "^2.1.12",
-    "@rstest/core": "^0.6.6"
+    "typescript": "^5.9.3"
   },
   "peerDependencies": {
     "@rsbuild/core": "1.x"
@@ -60,18 +69,9 @@
       "optional": true
     }
   },
+  "packageManager": "pnpm@10.17.1",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
-  },
-  "scripts": {
-    "build": "rslib build",
-    "dev": "rslib build --watch",
-    "lint": "biome check .",
-    "lint:write": "biome check . --write",
-    "test": "pnpm run test:unit && pnpm run test:e2e",
-    "test:unit": "rstest --config=./test/rstest.config.ts",
-    "test:e2e": "playwright test --config=./test/playwright.config.ts",
-    "bump": "npx bumpp"
   }
-}
+}