docs(angular): document PNPM workaround for ngcc

[daniel-shuy]

Current Behavior

Currently, https://nx.dev/recipes/other/setup-incremental-builds-angular#requirements still warns that ngcc doesn't support PNPM.

Expected Behavior

While ngcc doesn't support PNPM out-of-the-box, PNPM has since added a node-linker=hoisted mode that creates flat node_modules without symlinks, similar to the node_modules created by NPM, allowing ngcc to work with PNPM (angular/angular#50735).

Unfortunately, using node-link=hoisted breaks @parcel/watcher that is used by NX (#16319 and parcel-bundler/watcher#142). A workaround is to explicitly declare node-gyp-build in package.json, e.g.

{
  ...
  "devDependencies": {
    ...
    "node-gyp-build": "4.6.0",
    ...
  }
  ...
}

This PR documents the workarounds to use ngcc with PNPM.

p.s. Huge thanks to @DzmVasileusky for discovering the workarounds.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
nx-dev	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jul 14, 2023 4:25am

[nx-cloud]

☁️ Nx Cloud Report

CI is running/has finished running commands for commit 302547f. As they complete they will appear below. Click to see the status, the terminal output, and the build insights.

📂 See all runs for this branch

---

✅ Successfully ran 1 target

• nx affected -t e2e-macos --parallel=1 --base=6ce7fc57edda3e28a2d977ff802f57d3e7a4a0d1 --head=302547f6d92213e508d4f7641348ad148f277eb0

---

Sent with 💌 from NxCloud.

[daniel-shuy]

I don't understand why the build is failing, there are no error messages in the build console logs

[isaacplmann]

Needed to run nx format and commit the changes, but I couldn't apply my changes on top of your PR, so I made #19041.

If you run nx format and push your changes before the other PR merges, I'll close that PR. Otherwise, I'll close this one. You're still listed as an author on the commit on the other PR.

[isaacplmann]

Closed in favor of #19041

[daniel-shuy]

No worries, thanks for helping to fix it!

[github-actions]

This pull request has already been merged/closed. If you experience issues related to these changes, please open a new issue referencing this pull request.