Merge branch 'microsoft:main' into main

.gitattributes

@@ -47,4 +47,4 @@ yarn.lock                    merge=binary
 #
 # For more information, see this issue: https://github.com/microsoft/rushstack/issues/1088
 #
-*.json            linguist-language=JSON-with-Comments
+*.json                       linguist-language=JSON-with-Comments

.github/workflows/ci.yml

@@ -11,9 +11,6 @@ jobs:
     strategy:
       matrix:
         include:
-          - NodeVersion: 16.20.x
-            NodeVersionDisplayName: 16
-            OS: ubuntu-latest
           - NodeVersion: 18.18.x
             NodeVersionDisplayName: 18
             OS: ubuntu-latest
@@ -26,42 +23,71 @@ jobs:
     name: Node.js v${{ matrix.NodeVersionDisplayName }} (${{ matrix.OS }})
     runs-on: ${{ matrix.OS }}
     steps:
+      - name: Create ~/.rush-user/settings.json
+        shell: pwsh
+        # Create a .rush-user/settings.json file that looks like this:
+        #
+        # { "buildCacheFolder": "/<runner working directory>/rush-cache" }
+        #
+        # This configures the local cache to be shared between all Rush repos. This allows us to run a build in
+        # one clone of the repo (repo-a), and restore from the cache in another clone of the repo (repo-b) to test
+        # the build cache.
+        run: |
+          mkdir -p $HOME/.rush-user
+          @{ buildCacheFolder = Join-Path ${{ github.workspace }} rush-cache } | ConvertTo-Json > $HOME/.rush-user/settings.json
+
       - uses: actions/checkout@v3
         with:
           fetch-depth: 2
+          path: repo-a
 
       - name: Git config user
         run: |
           git config --local user.name "Rushbot"
           git config --local user.email "[email protected]"
+        working-directory: repo-a
 
       - uses: actions/setup-node@v3
         with:
           node-version: ${{ matrix.NodeVersion }}
 
       - name: Verify Change Logs
         run: node common/scripts/install-run-rush.js change --verify
+        working-directory: repo-a
 
       - name: Rush Install
         run: node common/scripts/install-run-rush.js install
+        working-directory: repo-a
 
       # - if: runner.os == 'Linux'
       #   name: Start xvfb
       #   run: /usr/bin/Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
+      #   working-directory: repo-a
 
       - name: Rush retest (install-run-rush)
         run: node common/scripts/install-run-rush.js retest --verbose --production
-        env:
-          # Prevent time-based browserslist update warning
-          # See https://github.com/microsoft/rushstack/issues/2981
-          BROWSERSLIST_IGNORE_OLD_DATA: 1
+        working-directory: repo-a
 
       - name: Ensure repo README is up-to-date
         run: node repo-scripts/repo-toolbox/lib/start.js readme --verify
+        working-directory: repo-a
+
+      - name: Clone another copy of the repo to test the build cache
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 1
+          path: repo-b
+
+      - name: Git config user
+        run: |
+          git config --local user.name "Rushbot"
+          git config --local user.email "[email protected]"
+        working-directory: repo-b
+
+      - name: Rush update (rush-lib)
+        run: node ${{ github.workspace }}/repo-a/apps/rush/lib/start-dev.js update
+        working-directory: repo-b
 
       - name: Rush test (rush-lib)
-        run: node apps/rush/lib/start-dev.js test --verbose --production --timeline
-        env:
-          # Prevent time-based browserslist update warning
-          # See https://github.com/microsoft/rushstack/issues/2981
-          BROWSERSLIST_IGNORE_OLD_DATA: 1
+        run: node ${{ github.workspace }}/repo-a/apps/rush/lib/start-dev.js test --verbose --production --timeline
+        working-directory: repo-b

.gitignore

@@ -3,42 +3,49 @@
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
 
 # Runtime data
 *.pid
 *.seed
 *.pid.lock
 
 # Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
+lib-cov/
 
 # Coverage directory used by tools like istanbul
-coverage
+coverage/
 
 # nyc test coverage
-.nyc_output
+.nyc_output/
 
 # Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
+.grunt/
 
 # Bower dependency directory (https://bower.io/)
-bower_components
+bower_components/
 
 # node-waf configuration
-.lock-wscript
+.lock-wscript/
 
 # Compiled binary addons (https://nodejs.org/api/addons.html)
-build/Release
+build/Release/
 
 # Dependency directories
-node_modules
+node_modules/
 jspm_packages/
 
+# TypeScript cache
+*.tsbuildinfo
+
 # Optional npm cache directory
-.npm
+.npm/
 
 # Optional eslint cache
-.eslintcache
+.eslintcache/
 
 # Optional REPL history
 .node_repl_history
@@ -51,9 +58,32 @@ jspm_packages/
 
 # dotenv environment variables file
 .env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
 
 # next.js build output
-.next
+.next/
+
+# Docusaurus cache and generated files
+.docusaurus/
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# yarn v2
+.yarn/cache/
+.yarn/unplugged/
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
 
 # OS X temporary files
 .DS_Store
@@ -64,12 +94,9 @@ jspm_packages/
 *.iml
 
 # Visual Studio Code
-.vscode/*
-!.vscode/settings.json
+.vscode/
 !.vscode/tasks.json
 !.vscode/launch.json
-!.vscode/extensions.json
-!*.code-workspace
 
 # Rush temporary files
 common/deploy/
@@ -78,23 +105,18 @@ common/autoinstallers/*/.npmrc
 **/.rush/temp/
 *.lock
 
-# Heft temporary files
-.cache
-.heft
-
-# Visual Studio Code
-.vscode
-
 # Common toolchain intermediate files
-temp
-lib
-lib-amd
-lib-es6
-lib-esnext
-lib-commonjs
-lib-shim
-dist
-dist-storybook
-*.scss.ts
-*.sass.ts
+temp/
+lib/
+lib-amd/
+lib-es6/
+lib-esnext/
+lib-commonjs/
+lib-shim/
+dist/
+dist-storybook/
 *.tsbuildinfo
+
+# Heft temporary files
+.cache/
+.heft/