14.0.0 (2022-06-02)

Breaking Changes

@angular-devkit/schematics-cli

• camel case arguments are no longer allowed.

@angular-devkit/architect-cli

• camel case arguments are no longer allowed.

@angular/cli

• Several changes to the ng analytics command syntax.

  • ng analytics project <setting> has been replaced with ng analytics <setting>
  • ng analytics <setting> has been replaced with ng analytics <setting> --global

• Support for Node.js v12 has been removed as it will become EOL on 2022-04-30. Please use Node.js v14.15 or later.

• Support for TypeScript 4.4 and 4.5 has been removed. Please update to TypeScript 4.6.

• --all option from ng update has been removed without replacement. To update packages which don’t provide ng update capabilities in your workspace package.json use npm update, yarn upgrade-interactive or yarn upgrade instead.

• Deprecated option --prod has been removed from all builders. --configuration production/-c production should be used instead if the default configuration of the builder is not configured to production.

• --configuration cannot be used with ng run. Provide the configuration as part of the target. Ex: ng run project:builder:configuration.

• Deprecated ng x18n and ng i18n-extract commands have been removed in favor of ng extract-i18n.

• Several changes in the Angular CLI commands and arguments handling.

  • ng help has been removed in favour of the —-help option.
  • ng —-version has been removed in favour of ng version and ng v.
  • Deprecated camel cased arguments are no longer supported. Ex. using —-sourceMap instead of —-source-map will result in an error.
  • ng update, —-migrate-only option no longer accepts a string of migration name, instead use —-migrate-only -—name <migration-name>.
  • —-help json help has been removed.

@angular-devkit/build-angular

• browser and karma builders script and styles options input files extensions are now validated.

  Valid extensions for scripts are:

  • .js
  • .cjs
  • .mjs
  • .jsx
  • .cjsx
  • .mjsx

  Valid extensions for styles are:

  • .css
  • .less
  • .sass
  • .scss
  • .styl

• We now issue a build time error since importing a CSS file as an ECMA module is non standard Webpack specific feature, which is not supported by the Angular CLI.

  This feature was never truly supported by the Angular CLI, but has as such for visibility.

• Reflect metadata polyfill is no longer automatically provided in JIT mode
  Reflect metadata support is not required by Angular in JIT applications compiled by the CLI.
  Applications built in AOT mode did not and will continue to not provide the polyfill.
  For the majority of applications, the reflect metadata polyfill removal should have no effect.
  However, if an application uses JIT mode and also uses the previously polyfilled reflect metadata JavaScript APIs, the polyfill will need to be manually added to the application after updating.
  To replicate the previous behavior, the core-js package should be manually installed and the import 'core-js/proposals/reflect-metadata'; statement should be added to the application's polyfills.ts file.

• NG_BUILD_CACHE environment variable has been removed. cli.cache in the workspace configuration should be used instead.

• The deprecated showCircularDependencies browser and server builder option has been removed. The recommended method to detect circular dependencies in project code is to use either a lint rule or other external tools.

@angular-devkit/core

• parseJson and ParseJsonOptions APIs have been removed in favor of 3rd party JSON parsers such as jsonc-parser.
• The below APIs have been removed without replacement. Users should leverage other Node.js or other APIs.
  • fs namespace
  • clean
  • mapObject

@angular-devkit/schematics

• Schematics NodePackageInstallTask will not execute package scripts by default
  The NodePackageInstallTask will now use the package manager's --ignore-scripts option by default.
  The --ignore-scripts option will prevent package scripts from executing automatically during an install.
  If a schematic installs packages that need their install/postinstall scripts to be executed, the
  NodePackageInstallTask now contains an allowScripts boolean option which can be enabled to provide the
  previous behavior for that individual task. As with previous behavior, the allowScripts option will
  prevent the individual task's usage of the --ignore-scripts option but will not override the package
  manager's existing configuration.
• Deprecated analytics property has been removed from TypedSchematicContext interface

@ngtools/webpack

• ivy namespace has been removed from the public API.

  • ivy.AngularWebpackPlugin -> AngularWebpackPlugin
  • ivy.AngularPluginOptions -> AngularPluginOptions

Deprecations

@angular/cli

• The defaultCollection workspace option has been deprecated in favor of schematicCollections.

  Before

  "defaultCollection": "@angular/material"

  After

  "schematicCollections": ["@angular/material"]

• The defaultProject workspace option has been deprecated. The project to use will be determined from the current working directory.

@angular-devkit/core

• • ContentHasMutatedException, InvalidUpdateRecordException, UnimplementedException and MergeConflictException symbol from @angular-devkit/core have been deprecated in favor of the symbol from @angular-devkit/schematics.
  • UnsupportedPlatformException - A custom error exception should be created instead.

@angular-devkit/schematics-cli

Commit	Description
	replace parser with yargs-parser

@angular-devkit/architect-cli

Commit	Description
	replace parser with yargs-parser

@schematics/angular

Commit	Description
	add --standalone to ng generate
	add migratiom to remove defaultProject in workspace config
	introduce addDependency rule to utilities
	introduce a utility subpath export for Angular rules and utilities
	update Angular dependencies to use ^ as version prefix
	update new and existing projects compilation target to ES2020
	add migration to remove package.json in libraries secondary entrypoints
	alphabetically order imports during component generation
	Consolidated setup with a single beforeEach()
	don't add path mapping to old entrypoint definition file
	remove @types/node from new projects
	remove extra space in standalone imports

@angular/cli

Commit	Description
	add --global option to ng analytics command
	add ng analytics info command
	add ng cache command
	add disable/enable aliases for off/on ng analytics command
	add prompt to set up CLI autocompletion
	add prompts on missing builder targets
	add support for auto completion
	add support for multiple schematics collections
	deprecated defaultProject option
	don't prompt to set up autocompletion for ng update and ng completion commands
	drop support for Node.js 12
	make ng completion set up CLI autocompletion by modifying .bashrc files
	remember after prompting users to set up autocompletion and don't prompt again
	support TypeScript 4.6.2
	use PNPM as package manager when pnpm-lock.yaml exists
	ng doc doesn't open browser in Windows
	ng g show descrption from collection.json if not present in schema.json
	add long description to ng update
	correctly handle --search option in ng doc
	display option descriptions during auto completion
	display package manager during ng update
	don't prompt for analytics when running ng analytics
	ensure all available package migrations are executed
	favor project in cwd when running architect commands
	handle duplicate arguments
	hide private schematics from ng g help output
	improve error message for Windows autocompletion use cases
	populate path with working directory in nested schematics
	print entire config when no positional args are provided to ng config
	print schematic errors correctly
	remove analytics prompt postinstall script
	remove cache path from global valid paths
	remove incorrect warning during ng update
	remove JSON serialized description from help output
	remove type casting and add optional chaining for current in optionTransforms
	skip prompt or warn when setting up autocompletion without a global CLI install
	sort commands in help output
	support silent package installs with Yarn 2+
	workaround npm 7+ peer dependency resolve errors during updates
	remove deprecated --all option from ng update
	remove deprecated --prod flag
	remove deprecated command aliases for extract-i18n.
	replace command line arguments parser

@angular-devkit/build-angular

Commit	Description
	add initial experimental esbuild-based application browser builder
	validate file extensions for scripts and styles options
	add es2015 exports package condition to browser-esbuild
	better handle Windows paths in esbuild experimental builder
	close compiler on Karma exit
	close dev-server on error
	detect tailwind.config.cjs as valid tailwindcss configuration
	downlevel libraries based on the browserslist configurations
	ensure karma sourcemap support on Windows
	fail build when importing CSS files as an ECMA modules
	properly handle locally-built APF v14 libraries
	remove unneeded JIT reflect metadata polyfill
	remove deprecated NG_BUILD_CACHE environment variable
	remove deprecated showCircularDependencies browser and server builder option

@angular-devkit/core

Commit	Description
	deprecate unused exception classes
	remove deprecated parseJson and ParseJsonOptions APIs
	remove deprecated fs, object and array APIs

@angular-devkit/schematics

Commit	Description
	add parameter to listSchematicNames to allow returning hidden schematics.
	disable package script execution by default in NodePackageInstallTask
	re-export core string helpers from schematics package
	support null for options parameter from OptionTransform type
	support reading JSON content directly from a Tree
	support reading text content directly from a Tree
	support ignore scripts package installs with Yarn 2+
	support quiet package installs with Yarn 2+
	remove deprecated analytics property

@angular/pwa

Commit	Description
	remove @schematics/angular utility deep import usage

@ngtools/webpack

Commit	Description
	update peer dependency to reflect TS 4.6 support
	use Webpack's built-in xxhash64 support
	remove deprecated ivy namespace

Special Thanks

Adrien Crivelli, Alan Agius, Charles Lyding, Cédric Exbrayat, Daniil Dubrava, Doug Parker, Elton Coelho, George Kalpakas, Jason Bedard, Joey Perrott, Kristiyan Kostadinov, Paul Gschwendtner, Pawel Kozlowski, Tobias Speicher and alkavats1