chore: bundle the root package.json as an installable package

AtofStryker · AtofStryker · commit ba709b78a846 · 2025-09-22T10:23:38.000-04:00
diff --git a/.circleci/cache-version.txt b/.circleci/cache-version.txt
@@ -1,2 +1,2 @@
 # Bump this version to force CI to re-create the cache from scratch.
-9-18-2025-x2
+9-22-2025-root-bundle
diff --git a/.circleci/src/workflows/workflows/@main.yml b/.circleci/src/workflows/workflows/@main.yml
@@ -6,6 +6,7 @@ linux-x64:
       - equal: [ develop, << pipeline.git.branch >> ]
       # use the following branch as well to ensure that v8 snapshot cache updates are fully tested
       - equal: [ 'update-v8-snapshot-cache-on-develop', << pipeline.git.branch >> ]
+      - equal: [ 'chore/bundle_package_root', << pipeline.git.branch >> ]
       - matches:
           pattern: /^release\/\d+\.\d+\.\d+$/
           value: << pipeline.git.branch >>
diff --git a/.circleci/workflows.yml b/.circleci/workflows.yml
@@ -3718,6 +3718,9 @@ workflows:
         - equal:
             - update-v8-snapshot-cache-on-develop
             - << pipeline.git.branch >>
+        - equal:
+            - chore/bundle_package_root
+            - << pipeline.git.branch >>
         - matches:
             pattern: /^release\/\d+\.\d+\.\d+$/
             value: << pipeline.git.branch >>
@@ -3772,6 +3775,9 @@ workflows:
         - equal:
             - update-v8-snapshot-cache-on-develop
             - << pipeline.git.branch >>
+        - equal:
+            - chore/bundle_package_root
+            - << pipeline.git.branch >>
         - matches:
             pattern: /^release\/\d+\.\d+\.\d+$/
             value: << pipeline.git.branch >>
@@ -3837,6 +3843,9 @@ workflows:
         - equal:
             - update-v8-snapshot-cache-on-develop
             - << pipeline.git.branch >>
+        - equal:
+            - chore/bundle_package_root
+            - << pipeline.git.branch >>
         - matches:
             pattern: /^release\/\d+\.\d+\.\d+$/
             value: << pipeline.git.branch >>
@@ -4322,6 +4331,9 @@ workflows:
         - equal:
             - update-v8-snapshot-cache-on-develop
             - << pipeline.git.branch >>
+        - equal:
+            - chore/bundle_package_root
+            - << pipeline.git.branch >>
         - matches:
             pattern: /^release\/\d+\.\d+\.\d+$/
             value: << pipeline.git.branch >>
@@ -5157,6 +5169,9 @@ workflows:
         - equal:
             - update-v8-snapshot-cache-on-develop
             - << pipeline.git.branch >>
+        - equal:
+            - chore/bundle_package_root
+            - << pipeline.git.branch >>
         - matches:
             pattern: /^release\/\d+\.\d+\.\d+$/
             value: << pipeline.git.branch >>
diff --git a/packages/root/.gitignore b/packages/root/.gitignore
@@ -0,0 +1,2 @@
+index.js
+index.mjs
diff --git a/packages/root/README.md b/packages/root/README.md
@@ -0,0 +1,5 @@
+# Purpose
+
+Bundles the monorepo root `package.json` as an installable package, allowing `@packages/root` to be installed in any context without having a absolute reference ot the root `package.json`
+
+In order to accomplish this, `rollup` is used bundle the `package.json`, as packages may be interpreted in place or be installed inside the `node_modules` directory. This package builds an `index.mjs` file for packages using `vite`/ ES Modules and an `index.js` file for any CommonJS entrypoints.
diff --git a/packages/root/index.js b/packages/root/index.js
diff --git a/packages/root/index.ts b/packages/root/index.ts
@@ -0,0 +1,3 @@
+import pkg from '../../package.json'
+
+export default pkg
diff --git a/packages/root/package.json b/packages/root/package.json
@@ -1,7 +1,20 @@
 {
   "name": "@packages/root",
   "version": "0.0.0-development",
-  "description": "dummy package pointing at the root package",
+  "description": "bundles the root package.json as an installable package",
   "main": "index.js",
+  "scripts": {
+    "build": "yarn build:cjs && yarn build:esm",
+    "build:cjs": "rimraf index.js && rollup -c rollup.config.mjs -f cjs -o index.js",
+    "build:esm": "rimraf index.mjs && rollup -c rollup.config.mjs -f esm -o index.mjs",
+    "build:prod": "yarn build"
+  },
+  "devDependencies": {
+    "@rollup/plugin-json": "^6.1.0",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.52.0",
+    "typescript": "^5.6.3"
+  },
+  "module": "index.mjs",
   "nx": {}
 }
diff --git a/packages/root/rollup.config.mjs b/packages/root/rollup.config.mjs
@@ -0,0 +1,7 @@
+import json from '@rollup/plugin-json'
+
+export default {
+  input: 'index.ts',
+  // inlines the root package.json into the bundle
+  plugins: [json()],
+}
diff --git a/packages/root/tsconfig.json b/packages/root/tsconfig.json
@@ -0,0 +1,5 @@
+{
+  "compilerOptions": {
+    "resolveJsonModule": true,
+  }
+}
diff --git a/scripts/binary/build.ts b/scripts/binary/build.ts
@@ -96,6 +96,13 @@ export async function buildCypressApp (options: BuildCypressAppOpts) {
   if (!keepBuild) {
     log('#buildPackages')
 
+    // Update the root package.json with the next app version so that it is snapshot properly
+    // as well as make sure @packages/root is built with the correct version
+    fs.writeJSONSync(path.join(CY_ROOT_DIR, 'package.json'), {
+      ...jsonRoot,
+      version,
+    }, { spaces: 2 })
+
     await execa('yarn', ['lerna', 'run', 'build', '--concurrency', '4'], {
       stdio: 'inherit',
       cwd: CY_ROOT_DIR,
@@ -226,7 +233,7 @@ require('./packages/server/index.js')
 }
 
 export async function packageElectronApp (options: BuildCypressAppOpts) {
-  const { platform, version, skipSigning = false } = options
+  const { platform, skipSigning = false } = options
 
   log('#removeCyAndBinFolders')
   await del([
@@ -260,12 +267,6 @@ export async function packageElectronApp (options: BuildCypressAppOpts) {
 
   console.log(`output folder: ${outputFolder}`)
 
-  // Update the root package.json with the next app version so that it is snapshot properly
-  fs.writeJSONSync(path.join(CY_ROOT_DIR, 'package.json'), {
-    ...jsonRoot,
-    version,
-  }, { spaces: 2 })
-
   try {
     await electronBuilder.build({
       publish: 'never',
diff --git a/yarn.lock b/yarn.lock

Original file line number	Diff line number	Diff line change
`@@ -1,2 +1,2 @@`
`1`	`1`	`# Bump this version to force CI to re-create the cache from scratch.`
`2`		`-9-18-2025-x2`
	`2`	`+9-22-2025-root-bundle`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+import pkg from '../../package.json'`
	`2`	`+`
	`3`	`+export default pkg`
-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +{
 +  "compilerOptions": {
 +    "resolveJsonModule": true,
 +  }
 +}