Normalize the output folders to lib-commonjs, lib-dts, and lib-esm for all projects in this repo.

.github/workflows/ci.yml

@@ -84,11 +84,11 @@ jobs:
         working-directory: repo-a/build-tests/rush-package-manager-integration-test
 
       - name: Ensure repo README is up-to-date
-        run: node repo-scripts/repo-toolbox/lib/start.js readme --verify
+        run: node repo-scripts/repo-toolbox/lib-commonjs/start.js readme --verify
         working-directory: repo-a
 
       - name: Collect JSON schemas
-        run: node repo-scripts/repo-toolbox/lib/start.js collect-json-schemas --output-path ${GITHUB_WORKSPACE}/artifacts/json-schemas
+        run: node repo-scripts/repo-toolbox/lib-commonjs/start.js collect-json-schemas --output-path ${GITHUB_WORKSPACE}/artifacts/json-schemas
         working-directory: repo-a
 
       - name: Clone another copy of the repo to test the build cache
@@ -104,13 +104,13 @@ jobs:
         working-directory: repo-b
 
       - name: Rush update (rush-lib)
-        run: node ${{ github.workspace }}/repo-a/apps/rush/lib/start-dev.js update
+        run: node ${{ github.workspace }}/repo-a/apps/rush/lib-commonjs/start-dev.js update
         working-directory: repo-b
 
       - name: Rush test (rush-lib)
-        run: node ${{ github.workspace }}/repo-a/apps/rush/lib/start-dev.js test --verbose --production --timeline
+        run: node ${{ github.workspace }}/repo-a/apps/rush/lib-commonjs/start-dev.js test --verbose --production --timeline
         working-directory: repo-b
 
       - name: Rush test (rush-lib) again to verify build cache hits
-        run: node ${{ github.workspace }}/repo-a/apps/rush/lib/start-dev.js test --verbose --production --timeline
+        run: node ${{ github.workspace }}/repo-a/apps/rush/lib-commonjs/start-dev.js test --verbose --production --timeline
         working-directory: repo-b

.gitignore

@@ -136,4 +136,4 @@ test-results/
 
 # Claude Code local configuration
 .claude/*.local.json
-
+**/tmpclaude-*-cwd

.prettierignore

@@ -114,6 +114,7 @@ temp/
 lib/
 lib-amd/
 lib-es6/
+lib-esm/
 lib-esnext/
 lib-commonjs/
 lib-shim/

.vscode/launch.json

@@ -5,7 +5,7 @@
 			"name": "Rush Debug",
 			"type": "node",
 			"request": "launch",
-			"program": "${workspaceRoot}/apps/rush/lib/start-dev.js",
+			"program": "${workspaceRoot}/apps/rush/lib-commonjs/start-dev.js",
 			"stopOnEntry": true,
 			"args": [
 				"start"
@@ -36,7 +36,7 @@
 			"runtimeArgs": [
 				"--nolazy",
 				"--inspect-brk",
-				"${workspaceFolder}/apps/heft/lib/start.js",
+				"${workspaceFolder}/apps/heft/lib-commonjs/start.js",
 				"--debug",
 				"test",
 				"--test-path-pattern",
@@ -56,7 +56,7 @@
 			"runtimeArgs": [
 				"--nolazy",
 				"--inspect-brk",
-				"${workspaceFolder}/apps/heft/lib/start.js",
+				"${workspaceFolder}/apps/heft/lib-commonjs/start.js",
 				"--debug",
 				"build"
 			],
@@ -74,7 +74,7 @@
 			"runtimeArgs": [
 				"--nolazy",
 				"--inspect-brk",
-				"${workspaceFolder}/apps/heft/lib/start.js",
+				"${workspaceFolder}/apps/heft/lib-commonjs/start.js",
 				"--debug",
 				"build",
 				"--clean"

apps/api-documenter/bin/api-documenter

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-require('../lib/start.js');
+require('../lib-commonjs/start.js');

apps/api-documenter/config/api-extractor.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
 
-  "mainEntryPointFilePath": "<projectFolder>/lib/index.d.ts",
+  "mainEntryPointFilePath": "<projectFolder>/lib-dts/index.d.ts",
 
   "apiReport": {
     "enabled": true,

apps/api-documenter/package.json

@@ -17,8 +17,30 @@
   "bin": {
     "api-documenter": "./bin/api-documenter"
   },
-  "main": "lib/index.js",
-  "typings": "dist/rollup.d.ts",
+  "main": "./lib-commonjs/index.js",
+  "module": "./lib-esm/index.js",
+  "types": "./dist/rollup.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/rollup.d.ts",
+      "import": "./lib-esm/index.js",
+      "require": "./lib-commonjs/index.js"
+    },
+    "./lib/*.schema.json": "./lib-commonjs/*.schema.json",
+    "./lib/*": {
+      "types": "./lib-dts/*.d.ts",
+      "import": "./lib-esm/*.js",
+      "require": "./lib-commonjs/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "lib/*": [
+        "lib-dts/*"
+      ]
+    }
+  },
   "dependencies": {
     "@microsoft/api-extractor-model": "workspace:*",
     "@microsoft/tsdoc": "~0.16.0",
@@ -34,5 +56,9 @@
     "@types/resolve": "1.20.2",
     "eslint": "~9.37.0",
     "local-node-rig": "workspace:*"
-  }
+  },
+  "sideEffects": [
+    "lib-commonjs/start.js",
+    "lib-esm/start.js"
+  ]
 }

apps/api-extractor/bin/api-extractor

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-require('../lib/start.js');
+require('../lib-commonjs/start.js');

apps/api-extractor/config/api-extractor.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
 
-  "mainEntryPointFilePath": "<projectFolder>/lib/index.d.ts",
+  "mainEntryPointFilePath": "<projectFolder>/lib-dts/index.d.ts",
 
   "apiReport": {
     "enabled": true,

apps/api-extractor/config/heft.json

@@ -23,7 +23,7 @@
               "copyOperations": [
                 {
                   "sourcePath": "src",
-                  "destinationFolders": ["lib"],
+                  "destinationFolders": ["lib-commonjs"],
                   "includeGlobs": ["**/test/test-data/**/*"]
                 }
               ]

apps/api-extractor/package.json

@@ -25,8 +25,30 @@
     "directory": "apps/api-extractor"
   },
   "homepage": "https://api-extractor.com",
-  "main": "lib/index.js",
-  "typings": "dist/rollup.d.ts",
+  "main": "./lib-commonjs/index.js",
+  "module": "./lib-esm/index.js",
+  "types": "./dist/rollup.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/rollup.d.ts",
+      "import": "./lib-esm/index.js",
+      "require": "./lib-commonjs/index.js"
+    },
+    "./lib/*.schema.json": "./lib-commonjs/*.schema.json",
+    "./lib/*": {
+      "types": "./lib-dts/*.d.ts",
+      "import": "./lib-esm/*.js",
+      "require": "./lib-commonjs/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "lib/*": [
+        "lib-dts/*"
+      ]
+    }
+  },
   "bin": {
     "api-extractor": "./bin/api-extractor"
   },
@@ -60,5 +82,9 @@
     "decoupled-local-node-rig": "workspace:*",
     "eslint": "~9.37.0",
     "local-eslint-config": "workspace:*"
-  }
+  },
+  "sideEffects": [
+    "lib-commonjs/start.js",
+    "lib-esm/start.js"
+  ]
 }

apps/api-extractor/src/api/test/test-data/config-lookup1/tsconfig.json

@@ -2,7 +2,7 @@
   "$schema": "http://json.schemastore.org/tsconfig",
 
   "compilerOptions": {
-    "outDir": "lib",
+    "outDir": "lib-commonjs",
     "rootDir": "src",
 
     "forceConsistentCasingInFileNames": true,
@@ -20,6 +20,5 @@
     "target": "es2017",
     "lib": ["es2017"]
   },
-  "include": ["src/**/*.ts", "src/**/*.tsx"],
-  "exclude": ["node_modules", "lib"]
+  "include": ["src/**/*.ts", "src/**/*.tsx"]
 }

apps/api-extractor/src/api/test/test-data/config-lookup2/tsconfig.json

@@ -2,7 +2,7 @@
   "$schema": "http://json.schemastore.org/tsconfig",
 
   "compilerOptions": {
-    "outDir": "lib",
+    "outDir": "lib-commonjs",
     "rootDir": "src",
 
     "forceConsistentCasingInFileNames": true,
@@ -20,6 +20,5 @@
     "target": "es2017",
     "lib": ["es2017"]
   },
-  "include": ["src/**/*.ts", "src/**/*.tsx"],
-  "exclude": ["node_modules", "lib"]
+  "include": ["src/**/*.ts", "src/**/*.tsx"]
 }

apps/api-extractor/src/api/test/test-data/config-lookup3/src/test/tsconfig.json

@@ -2,7 +2,7 @@
   "$schema": "http://json.schemastore.org/tsconfig",
 
   "compilerOptions": {
-    "outDir": "lib",
+    "outDir": "lib-commonjs",
     "rootDir": "src",
 
     "forceConsistentCasingInFileNames": true,
@@ -20,6 +20,5 @@
     "target": "es2017",
     "lib": ["es2017"]
   },
-  "include": ["src/**/*.ts", "src/**/*.tsx"],
-  "exclude": ["node_modules", "lib"]
+  "include": ["src/**/*.ts", "src/**/*.tsx"]
 }

apps/api-extractor/src/api/test/test-data/config-lookup3/tsconfig.json

@@ -2,7 +2,7 @@
   "$schema": "http://json.schemastore.org/tsconfig",
 
   "compilerOptions": {
-    "outDir": "lib",
+    "outDir": "lib-commonjs",
     "rootDir": "src",
 
     "forceConsistentCasingInFileNames": true,
@@ -20,6 +20,5 @@
     "target": "es2017",
     "lib": ["es2017"]
   },
-  "include": ["src/**/*.ts", "src/**/*.tsx"],
-  "exclude": ["node_modules", "lib"]
+  "include": ["src/**/*.ts", "src/**/*.tsx"]
 }

apps/api-extractor/src/api/test/test-data/custom-tsdoc-tags/tsconfig.json

@@ -2,7 +2,7 @@
   "$schema": "http://json.schemastore.org/tsconfig",
 
   "compilerOptions": {
-    "outDir": "lib",
+    "outDir": "lib-commonjs",
     "rootDir": "src",
 
     "forceConsistentCasingInFileNames": true,
@@ -20,6 +20,5 @@
     "target": "es2017",
     "lib": ["es2017"]
   },
-  "include": ["src/**/*.ts", "src/**/*.tsx"],
-  "exclude": ["node_modules", "lib"]
+  "include": ["src/**/*.ts", "src/**/*.tsx"]
 }

apps/cpu-profile-summarizer/bin/cpu-profile-aggregator

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-require('../lib/start.js');
+require('../lib-commonjs/start.js');

apps/cpu-profile-summarizer/package.json

@@ -25,5 +25,24 @@
     "@rushstack/heft": "workspace:*",
     "eslint": "~9.37.0",
     "local-node-rig": "workspace:*"
-  }
+  },
+  "exports": {
+    "./lib/*": {
+      "types": "./lib-dts/*.d.ts",
+      "import": "./lib-esm/*.js",
+      "require": "./lib-commonjs/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "lib/*": [
+        "lib-dts/*"
+      ]
+    }
+  },
+  "sideEffects": [
+    "lib-commonjs/start.js",
+    "lib-esm/start.js"
+  ]
 }

apps/heft/.npmignore

@@ -33,4 +33,4 @@
 
 !/includes/**
 !UPGRADING.md
-
+lib-*/legacy-compatibility/**

apps/heft/bin/heft

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-require('../lib/startWithVersionSelector.js');
+require('../lib-commonjs/startWithVersionSelector.js');

apps/heft/config/api-extractor.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
 
-  "mainEntryPointFilePath": "<projectFolder>/lib/index.d.ts",
+  "mainEntryPointFilePath": "<projectFolder>/lib-dts/index.d.ts",
   "apiReport": {
     "enabled": true,
     "reportFolder": "../../../common/reviews/api"

apps/heft/config/heft.json

@@ -20,6 +20,23 @@
               ]
             }
           }
+        },
+
+        "copy-legacy-compatibility-start-js": {
+          "taskDependencies": ["typescript"],
+          "taskPlugin": {
+            "pluginPackage": "@rushstack/heft",
+            "pluginName": "copy-files-plugin",
+            "options": {
+              "copyOperations": [
+                {
+                  "sourcePath": "src/legacy-compatibility",
+                  "destinationFolders": ["lib"],
+                  "includeGlobs": ["*"]
+                }
+              ]
+            }
+          }
         }
       }
     }