fix(js): integrate buildable bundler and compiler options

[mandarini]

Moved from here: #15090

After discussions, we decided to integrate the buildbale, bundler and compiler options of the js:lib generator, to make it more transparent.

So, the changes are on the @nrwl/js:lib generator. See the NEW documentation here.

Current behaviour

• If we don't pass the buildable flag, and we don't pass a bundler either, then library will be buildable with @nrwl/js:tsc as the build executor since it defaults to "@nrwl/js:tsc" executor.

• If you do pass the buildable flag and miss to pass the bundler, it will default to @nrwl/js: + options.compiler for the executor.

• The only way to get the @nrwl/js:tsc or @nrwl/js:swc executors is to leave bundler undefined

• The only way to get a non-buildable lib is to specifically pass --bundler=none

So we need to find a way to deprecate the buildable flag, but still be able to get the js:tsc or js:swc executors from the bundler. And make the behaviour more transparent.

Expected behaviour

--bundler=swc|tsc|rollup|vite|esbuild|none

Use Case 1: Don't want to bundle but want to build

--bundler=esbuild (esbuildOptions.bundle = false)
--bundler=tsc
--bundler=swc

Use Case 2: Want to bundle

--bundler=esbuild (esbuildOptions.bundle = true)
--bundler=vite
--bundler=rollup

Use Case 3: Not buildable/bundled

--bundler=none

Cases we want to deprecate:

tsc           | rollup       | rollup + tsc plugin
tsc           | webpack      | webpack + tsc plugin
swc           | webpack      | webpack + swc plugin

[vercel]

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

Name	Status	Preview	Comments	Updated
nx-dev	✅ Ready (Inspect)	Visit Preview	💬 Add your feedback	Mar 3, 2023 at 2:26PM (UTC)

[nx-cloud]

☁️ Nx Cloud Report

CI is running/has finished running commands for commit faa223f. 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 8 targets

• nx run-many -t e2e-macos --parallel=1 --exclude=e2e-detox
• nx affected --target=e2e --base=fde0abf9988cbd58a1338f3288fd562830d36d8e --head=faa223f7b111ed60009b55644d96ab9aaf2740dd --exclude=e2e-storybook,e2e-storybook-angular --parallel=1
• nx affected --target=test --base=fde0abf9988cbd58a1338f3288fd562830d36d8e --head=faa223f7b111ed60009b55644d96ab9aaf2740dd --parallel=1
• nx run-many -t root-lint check-imports check-commit check-lock-files depcheck --parallel=1 --no-dte
• nx affected --target=build --base=fde0abf9988cbd58a1338f3288fd562830d36d8e --head=faa223f7b111ed60009b55644d96ab9aaf2740dd --parallel=3
• nx affected --target=lint --base=fde0abf9988cbd58a1338f3288fd562830d36d8e --head=faa223f7b111ed60009b55644d96ab9aaf2740dd --parallel=3
• nx-cloud record -- nx format:check --base=fde0abf9988cbd58a1338f3288fd562830d36d8e --head=faa223f7b111ed60009b55644d96ab9aaf2740dd
• nx documentation --no-dte

---

Sent with 💌 from NxCloud.

[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.