15.0.0 (2022-11-16)

Breaking Changes

@angular/cli

• The Angular CLI no longer supports 16.10.x, 16.11.x and 16.12.x. Current supported versions of Node.js are 14.20.x, 16.13.x and 18.10.x.
• Node.js versions older than 14.20 are no longer supported.
• The 'path' option in schematics schema no longer has a special meaning. Use 'workingDirectory' smart default provider should be used instead.

@schematics/angular

• Removed unusedappDir option from Universal and App-Shell schematic. This option can safely be removed if present since it no longer has effect.

• analyticsSharing option in the global angular configuration has been
  removed without replacement. This option was used to configure the Angular CLI to access to your own users' CLI usage data.

  If this option is used, it can be removed using ng config --global cli.analyticsSharing undefined.

• analytics APIs have been removed without replacement from @angular-devkit/core and @angular-devkit/architect.

@angular-devkit/build-angular

• TypeScript versions older than 4.8.2 are no longer supported.

• The server builder bundleDependencies option has been removed. This option was used pre Ivy. Currently, using this option is unlikely to produce working server bundles.

  The externalDependencies option can be used instead to exclude specific node_module packages from the final bundle.

• • Deprecated support for tilde import has been removed. Please update the imports by removing the ~.

  Before

  @import "~font-awesome/scss/font-awesome";

  After

  @import "font-awesome/scss/font-awesome";

  • By default the CLI will use Sass modern API, While not recommended, users can still opt to use legacy API by setting NG_BUILD_LEGACY_SASS=1.

• Internally the Angular CLI now always set the TypeScript target to ES2022 and useDefineForClassFields to false unless the target is set to ES2022 or later in the TypeScript configuration. To control ECMA version and features use the Browerslist configuration.

• require.context are no longer parsed. Webpack specific features are not supported nor guaranteed to work in the future.

• Producing ES5 output is no longer possible. This was needed for Internet Explorer which is no longer supported. All browsers that Angular supports work with ES2015+

• server builder bundleDependencies option now only accept a boolean value.

• Deprecated support for Stylus has been removed. The Stylus package has never reached a stable version and its usage in the Angular CLI is minimal. It's recommended to migrate to another CSS preprocessor that the Angular CLI supports.

@angular-devkit/core

• Workspace projects with missing root is now an error.

@ngtools/webpack

• TypeScript versions older than 4.8.2 are no longer supported.

@schematics/angular

Commit	Description
	add migration to remove require calls from karma builder main file
	Added --project-root option to the library schematics
	drop polyfills.ts file from new templates
	enable error on unknown properties and elements in tests
	generate new projects using TypeScript 4.8.2
	mark projectRoot as non hidden option in application schematic
	remove karma.conf.js from newly generated projects
	remove ngOnInit from component template
	remove Browserslist configuration files from projects
	remove environment files in new applications
	remove test.ts file from new projects
	add @angular/localize as type when localize package is installed
	mark project as required option
	remove empty lines
	remove TypeScript target from universal schematic
	remove deprecated appDir option

@angular/cli

Commit	Description
	add support for Node.js version 18
	drop support for Node.js versions older than 14.20
	add unique user id as user parameter in GA
	add workspace information as part of analytics collection
	allow ng add to find prerelease versions when CLI is prerelease
	do not collect analytics when running in non TTY mode
	exclude @angular/localize@<10.0.0 from ng add pa… (#24152)
	exclude @angular/material@7.x from ng add package discovery
	respect registry in RC when running update through yarn
	remove deprecated path handler

Commit	Description
	migrate analytics collector to use GA4
	remove analytics API from core and architect

@angular-devkit/build-angular

Commit	Description
	add ng-server-context when using app-shell builder
	add esbuild-based builder initial support for fileReplacements
	add initial incremental code rebuilding to esbuild builder
	add initial watch support to esbuild-based builder
	amend polyfills option in all builders to support an array of module specifiers
	auto include @angular/localize/init when found in types
	auto include @angular/platform-server/init during server builds
	drop support for TypeScript 4.6 and 4.7
	export @angular/platform-server symbols in server bundle
	karma builder main option is now optional
	providing a karma config is now optional
	remove bundleDependencies from server builder
	switch to use Sass modern API
	use Browserslist to determine ECMA output
	account for package.json exports fields with CSS import statements
	account for package.json exports with Sass in esbuild builder
	add @angular/platform-server as an optional peer dependency
	allow both script and module sourceTypes to be localized
	avoid attempted resolve of external CSS URLs with esbuild builder
	correct escaping of target warning text in esbuild builder
	correctly resolve Sass partial files in node packages
	fix crash when Sass error occurs
	handle conditional exports in scripts and styles option
	ignore cache path when watching with esbuild builder
	ignore specs in node_modules when finding specs
	only add @angular/platform-server/init when package is installed.
	only import karma when running karma builder
	provide workaround for V8 object spread performance defect
	rebase Sass url() values when using esbuild-based builder
	resolve transitive dependencies in Sass when using Yarn PNP
	show file replacement in TS missing file error in esbuild builder
	show warning when using TypeScript target older then ES2022 in esbuild builder
	support Yarn PNP resolution in modern SASS API
	update browerslist package
	update sourcemaps when rebasing Sass url() functions in esbuild builder
	use relative sourcemap source paths for Sass in esbuild builder
	wait during file watching to improve multi-save rebuilds for esbuild builder
	warn when components styles sourcemaps are not generated when styles optimization is enabled
	add initial global styles incremental rebuilds with esbuild builder
	add vendor chunking to server builder
	avoid extra babel file reads in esbuild builder rebuilds
	avoid extra TypeScript emits with esbuild rebuilds
	avoid template diagnostics for declaration files in esbuild builder
	minimize Angular diagnostics incremental analysis in esbuild-based builder
	use esbuild-based builder to directly downlevel for await...of
	use Sass worker pool for Sass support in esbuild builder
	use Uint8Arrays for incremental caching with esbuild-based builder
	disable requireContext parsing
	remove deprecated ES5 support
	remove old bundleDependencies enum logic
	remove support for Stylus

@angular-devkit/core

Commit	Description
	throw error when project has missing root property
	update logger forEach promiseCtor type

@ngtools/webpack

Commit	Description
	drop support for TypeScript 4.6 and 4.7
	support inline style sourcemaps when using css-loader for component styles

Special Thanks

Alan Agius, Brent Schmidt, Charles Lyding, Cédric Exbrayat, Dariusz Ostolski, Doug Parker, Günhan Gülsoy, Jason Bedard, Lukas Spirig, Ruslan Lekhman, angular-robot[bot] and minijus