Rslib configuration harness

.github/workflows/build-and-test.yml

@@ -78,6 +78,15 @@ jobs:
       - name: Verify Publint Workflow Coverage
         run: node tools/scripts/verify-publint-workflow-coverage.mjs
 
+      - name: Run Rslib Harness Tests
+        run: pnpm run test:rslib-harness
+
+      - name: Verify Rslib Harness Coverage
+        run: pnpm run verify:rslib-harness
+
+      - name: Verify Rslib Harness Workflow Coverage
+        run: pnpm run verify:rslib-harness:workflow
+
       - name: Print Number of CPU Cores
         run: nproc
 

README.md

@@ -42,6 +42,62 @@ To get started with Module Federation, see the [Quick Start](https://module-fede
 
 Come and chat with us on [Discussions](https://github.com/module-federation/universe/discussions) or [Discord](https://discord.gg/n69NnT3ACV)! The Module federation team and users are active there, and we're always looking for contributions.
 
+## 🧪 Rslib Monorepo Harness
+
+This repository includes a workspace-level Rslib harness that can orchestrate
+multiple `rslib.config.*` projects from the repo root (including nested project
+definitions via harness config files).
+
+Quick examples:
+
+- List resolved projects:
+
+  ```bash
+  pnpm run rslib:harness list
+  ```
+
+- List resolved projects as JSON:
+
+  ```bash
+  pnpm run rslib:harness list --json
+  ```
+
+  `--json` also implies list output when used with other commands.
+
+- Emit a machine-readable dry-run command plan:
+
+  ```bash
+  pnpm run rslib:harness:build --project create-module-federation --json --dry-run
+  ```
+
+  For non-`list` commands, `--json` is only supported with `--dry-run`.
+
+- Build a single project by name/path filter:
+
+  ```bash
+  pnpm run rslib:harness:build --project create-module-federation
+  ```
+
+- Show commands without executing:
+
+  ```bash
+  pnpm run rslib:harness:build --project create-module-federation --dry-run
+  ```
+
+- Inspect one project's generated config outputs:
+
+  ```bash
+  pnpm run rslib:harness:inspect --project create-module-federation
+  ```
+
+- Verify harness coverage against repo Rslib configs:
+
+  ```bash
+  pnpm run verify:rslib-harness
+  ```
+
+The default root harness config is `rslib.harness.config.mjs`.
+
 ## 🤝 Contribution
 
 > New contributors welcome!

package.json

@@ -30,6 +30,13 @@
     "lint": "nx run-many --target=lint",
     "test": "nx run-many --target=test",
     "build": "NX_TUI=false  nx run-many --target=build --parallel=5  --projects=tag:type:pkg",
+    "rslib:harness": "node ./scripts/rslib-harness.mjs",
+    "rslib:harness:list": "node ./scripts/rslib-harness.mjs list",
+    "rslib:harness:build": "node ./scripts/rslib-harness.mjs build",
+    "rslib:harness:inspect": "node ./scripts/rslib-harness.mjs inspect",
+    "test:rslib-harness": "node --test ./scripts/__tests__/rslib-harness.test.mjs",
+    "verify:rslib-harness": "node ./tools/scripts/verify-rslib-harness-coverage.mjs",
+    "verify:rslib-harness:workflow": "node ./tools/scripts/verify-rslib-harness-workflow-coverage.mjs",
     "build:pkg": "NX_TUI=false nx run-many --targets=build --projects=tag:type:pkg --skip-nx-cache",
     "test:pkg": "NX_TUI=false nx run-many --targets=test --projects=tag:type:pkg --skip-nx-cache",
     "lint-fix": "nx format:write --uncommitted",

rslib.harness.config.mjs

@@ -0,0 +1,30 @@
+/**
+ * Rslib monorepo harness configuration.
+ *
+ * Supported project entry forms:
+ * - string path / glob:
+ *   - directory (auto-detect rslib.config.*)
+ *   - explicit rslib.config.* file
+ *   - nested rslib.harness.config.* file
+ * - object:
+ *   {
+ *     name?: string;
+ *     root?: string;
+ *     config?: string;
+ *     args?: string[];
+ *     ignore?: string[];
+ *     projects?: (string | object)[];
+ *   }
+ *
+ * Notes:
+ * - `<rootDir>` token is supported in path values.
+ * - this root harness intentionally targets publishable package projects and
+ *   app-level rslib projects in apps/.
+ */
+export default {
+  ignore: ['**/dist/**', '**/.{idea,cache,output,temp}/**'],
+  projects: [
+    'packages/*/rslib.config.{mjs,ts,js,cjs,mts,cts}',
+    'apps/**/rslib.config.{mjs,ts,js,cjs,mts,cts}',
+  ],
+};