feat(angular): support generating artifacts using options as provided

[leosvelperez]

Current Behavior

Artifact generators (e.g. component) options are more complex than they should be and are not consistent across the different Nx first-party plugins. These are some of the current problems:

• Different generators have different option names for the same thing.
• The directory/path option is expected to be relative to the workspace root for some generators, and for others, it’s expected to be relative to the project source root.
• Devs need to specify many options to generate an artifact in a specific location: name, project, directory/path, flat.

Apart from those, there are also some automatic decisions made by these generators, like converting the provided names to kebab-case. While this can enforce certain standards, it can be limiting and might not fit every use case.

Expected Behavior

• Similar to the changes done to the project generators, we'll have two formats: as-provided and derived. In most cases, we'll prompt the user for the format they want to use.
• We’ll deprecate the following options, which will only be considered for the derived format:
  • project
  • flat
• We’ll standardize the path and directory options name to be directory. We'll keep backward compat for path.
• We’ll standardize the directory option to be relative to the cwd.
• We’ll standardize the support for providing a path as the artifact name. It will be a shorthand of passing name & directory options.

Related Issue(s)

Fixes #

[vercel]

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

Name	Status	Preview	Updated (UTC)
nx-dev	✅ Ready (Inspect)	Visit Preview	Oct 11, 2023 6:13pm

[nx-cloud]

☁️ Nx Cloud Report

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

📂 See all runs for this CI Pipeline Execution

---

✅ Successfully ran 6 targets

• nx affected --target=e2e --base=b8e150019073145f7cfc6c4ad043cb373e150f6d --head=c75ab8c02024aa986087f0b8d5add40ebb03170f --parallel=1
• nx affected --targets=lint,test,build --base=b8e150019073145f7cfc6c4ad043cb373e150f6d --head=c75ab8c02024aa986087f0b8d5add40ebb03170f --parallel=3
• nx run-many -t check-imports check-commit check-lock-files check-codeowners documentation --parallel=1 --no-dte
• nx-cloud record -- nx format:check --base=b8e150019073145f7cfc6c4ad043cb373e150f6d --head=c75ab8c02024aa986087f0b8d5add40ebb03170f
• nx documentation --no-dte
• nx affected -t e2e-macos --parallel=1 --base=b8e150019073145f7cfc6c4ad043cb373e150f6d --head=c75ab8c02024aa986087f0b8d5add40ebb03170f

---

Sent with 💌 from NxCloud.

[leosvelperez]

This was being executed after the smart defaults were applied. That was wrong because it would warn about a deprecated option with a smart default (e.g. project). The order of operations after this change matches the order of those in the Angular CLI.

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