v8.0.0

Welcome to version 8.0 of Angular and the CLI.

This release includes some significant new features:

• Differential Loading is a build system feature in the CLI. It builds two versions of your application. One version is for modern browsers, and has a 10-30% smaller JS bundle size and fewer required polyfills. The second version works in older browsers. During ng update, we make some minor changes to your application to make it possible for all browsers to automatically downloaded the most suitable bundles. This change requires no server-side or serving infrastructure changes. The change is enabled by default via the target field set to es2015 in application’s tsconfig.json. If this change breaks your application, you can change the value back to es5 which disables differential loading. Thanks to Manfred Steyer https://github.com/manfredsteyer for upstreaming his excellent work on ngx-build-plus. See the documentation at https://angular.io/guide/deployment#differential-loading
• Support for EcmaScript dynamic import() for lazy loading of routes. This aligns Angular with the JavaScript specification and makes your application more compatible with tooling. ng update will automatically change the loadChildren syntax to import(), and we no longer recommend using the string-based style like path/to/module#ModuleName. Thanks to Craig Spence https://github.com/phenomnomnominal for adding support for this.
• WebWorker bundling is now automatic in the CLI. This lets you easily write code that moves expensive computation to a separate thread, and have that bundled in a separate script that works in the browser. Thanks to Jason Miller https://github.com/developit for writing the Webpack plugin and assisting us with integrating this feature into the CLI. See the documentation at https://angular.io/guide/web-worker.
• CLI telemetry is an opt-in feature that lets you report CLI usage data to the Angular team, and also to your own Google Analytics account. This lets us make better decisions about which CLI features to prioritize, and measure the impact of our improvements. See the documentation at https://angular.io/analytics
• Builders is a new API in the CLI that allows tooling developers to replace the behavior of CLI commands such as build and test. Before 8.0.0 we will add documentation, for now you can see a preview at https://pr29964-c99aea0.ngbuilds.io/guide/architect and read the blog post. As part of 8.0.0 we are working with cloud providers to take advantage of Architect to provide a new deploy command. Along with Architect, we've added a Workspace API for tools that need to read or write the angular.json file; see https://github.com/angular/angular-cli/blob/master/packages/angular_devkit/core/README.md#workspaces
• Reduced transitive tarball download size of @angular/cli by 60%

To update, please visit https://update.angular.io

Note: if you configure Node.js with extra memory for your ng build command, you may need to do the same for ng update since this update loads your program in memory.

Breaking Changes

@angular-devkit/build-angular: use `sass` instead of `node-sass` (ce15899)

we no longer use `node-sass` by default, instead we use `sass` (dart-sass).

While in most cases this should not have an impact the generated code, dart sass has some differences from Ruby Sass. See https://github.com/sass/dart-sass#behavioral-differences-from-ruby-sass for more details

If you wish to use node-sass instead of sass you need to install node-sass as a dev dependency.

npm users

npm install node-sass --save-dev

yarn users

yarn add node-sass --dev

Note: for larger Sass projects to avoid this performance hit you might want to install fibers. See: https://www.npmjs.com/package/fibers

Ref: TOOL-748

@angular-devkit/core: Remove dep on chokidar (eb5643e)

Users who rely on angular-devkit/core to do the file watching must add chokidar to their devDependencies.

@angular-devkit/build-angular: disable by default stylesheet root relative URL rebasing (94b087c)

Root relative URLs are a standardized method to reference a resource path from the root of a host. The previous behavior of the Angular CLI prevented this from occuring and resulted in an inability to reference stylesheet assets in this manner. The initial reason for this behavior is no longer present in the internal implementation of the Angular CLI. Therefore, this now unnecessary and non-standard behavior is being phased out. If an application currently relies on this behavior, a compatibility option `rebaseRootRelativeCssUrls` has been provided for the 8.x release cycle to facilitate transition away from this non-standard and limiting behavior. The recommended method to transition is to use relative paths within the source stylesheet. This allows the build system to process and generate a full URL for the asset.

Schematics are now async

For Schematics authors: note that schematics have always been potentially async, but now they all are.

---

Commits

@angular/cli (8.0.0)
Commit	Description	Notes
	verify Angular version is supported
	automatically update angular builders when CLI is updated	[Closes #13581]
	add tracking for command duration
	support stable architect API
	allows analytics sharing with a third party
	add validation logic for analytics in ng config
	add custom implementation for analytics for commands
	add support for analytics command proper
	add prompt on post install step
	add analytic support to commands and command-runner
	add universal-analytics as dependency
	add `@nguniversal/*` to ng version	[Closes #9959]
	update minimum required Node.js version to 10.9
	Add VsCode recommendation for Angular Console
	Add VsCode extension recommendations
	support pnpm as a package manager option
	ng config doesn't parse positional array	[Closes #14516]
	ng generate --help shows the wrong collection	[Closes #14519]
	show analytics prompt when no global configuration file	[Closes #14486]
	standardize TTY checks
	ensure git repository is clean before updates
	show error when using x18n command on Node.js 12.0
	improve error handling of update command
	@bazel/* are not shown in `ng version`
	prevent nested schematic execution from generating analytics	[Closes #14190]
	enable analytics for safe builders	[Closes #14355]
	print full error when package is not found
	honor builder schema additional properties option	[Closes #14354]
	remove Angular specific version check from base architect command	[Closes #14266]
	only show postinstall prompt when global analytics not configured
	add missing experimentalImportFactories to schema
	update config schema for karma webworker
	improve opt-out language
	dont force a prompt on non-interactive terminals
	if no global config file found, analytics can be null
	don't remove scripts from package.json
	fix import path for TimingOptions	[Closes #13978]
	remove redundant typescript/compiler-cli compatibility check
	remove deprecated eject command
	explicitly define console color logging
	wrap `opn` in a new Promise because `opn` is already resolve is already resolve.
	Add an error message when we call `ng doc` without keyword. Currently, we open a page with the keyword `undefined`. (#13604)
	update terser-webpack-plugin (#13589)	[Closes #13582]
	schematics commands should fail on unknown options	[Closes #12549]
	remove unsupported `dryRun` and `force` from `ng add`	[Closes #13479]
	ng-add should resolve package.json
@angular-devkit/architect (0.800.0)
Commit	Description	Notes
	add analytics to builder context
	add new context methods
	getOptionsForTarget should return null
	add scheduleTargetAndForget function
	add targetFromTargetString() function
	QoL changes for builders
	allow for a different output type
	add generic architect builders
	add node architect host
	New Architect API first draft
	error run on input schema error (#14315)	[Closes #14269]
	propagate option validation errors
	consume the default export in TestingArchitectHost
	set proper name in TestingArchitectHost
	fix incorrect relative core import
	remove experimental API
	ensure workspaceRoot is actually set to workspaceRoot
	properly subscribe to error handlers
	properly report errors thrown by builder
@angular-devkit/build-angular (0.800.0)
Commit	Description	Notes
	use evergreen version of zone.js with ES2015
	remove experimentalImportFactories option	[Closes #14218]
	warn when target greater es2015
	deprecate `es5BrowserSupport` option in browser builder
	enable differential loading for es2015 builds
	wire up index generation for differential loading
	support web workers in karma builder
	support karma builder webpack transformation
	improve handling of nomodules and modules in index generation
	differential loading
	add safari-nomodule snippet
	update to core-js 3	[Closes #13954]
	support TS web workers
	support module web workers.
	write index.html for differential loading
	add experimentalImportFactories option
	use builder name for category
	add analytics for build
	implement stable architect API for extract-i18n
	add AppShell new API builder
	add server output path
	implement stable architect API for karma
	use `sass` instead of `node-sass`
	add Server Builder v2
	enable webpack profile when using stats-json flag	[Closes #13907]
	implement stable architect API for protractor
	deprecate `profile` option in build
	remove Closure compiler i18n code for ivy
	move dev-server to new API
	re-export schemas
	browserTarget should match target pattern
	add support for tslint 5.13+
	add Browser Builder v2
	change es5BrowserSupport output filename to `polyfills.es5.js`	[Closes #13808]
	move tslint to new API
	dev-server port number mismatches in logs when using `port=0`	[Closes #14499]
	absolute outputPath outputs index.html in wrong location	[Closes #14474]
	normalize sourceMap options in karma webpack plugin	[Closes #14457]
	show error for missing modules	[Closes #14421]
	extract i18n should only show warnings/errors	[Closes #14373]
	propagate protractor errors during execution
	stop dev server fallback outside of serve path
	protractor should use dev server baseUrl
	account for dynamic port with dev-server baseUrl
	load polyfills-es5 on test	[Closes #14335]
	never split polyfill chunks	[Closes #14280]
	relax typescript peerDep
	used named chunks for dynamic imports	[Closes #14251]
	e2e does not respect dev-server host and port settings (#14165)	[Closes #14151]
	live reload cannot be disabled	[Closes #14300]
	skip version check if unit-testing
	add Angular version check into required builders
	use known Terser global defs
	remove pure_getters	[Closes #9231] [Closes #11439] [Closes #12096] [Closes #12128]
	pass system path to readTsconfig
	set correct peerDependencies for TypeScript
	run build steps for differential loading in sequence to avoid confusing progress information
	ignore bundle budgets when running karma or devserver	[Closes #14100]
	verify chunk files exist before accessing
	update utility function output type
	ensure correct dev server path with public host option	[Closes #13627]
	fix countOccurences
	use package import for build-webpack in server builder
	update speed-measure-webpack-plugin to 1.3.1	[Closes #12763]
	passing port 0 when using serve will not find a suitable port
	don't show warning when font shorthand is used	[Closes #9648]
	resolve fonts with space in filename	[Closes #9648]
	fail the build if service worker fails
	fix base href insertion when HTML is in a single line	[Closes #13851]
	fix check for absolute paths in windows in server config	[Closes #13865] [Closes #1139]
	don't bundle linked modules when `bundleDependencies` in `none` in server builder	[Closes #13817]
	sourceMap option not working in tests	[Closes #13766]
	add promise polyfill to --es5BrowserSupport provided polyfills
	improve webpack loader resolution
	minimum threshold
	disable by default stylesheet root relative URL rebasing
	added warning for ES2017
	remove unneeded script element type
	throw error when multiple bundles have been name the same	[Closes #13568]
	error when both `baseUrl` and `devServerTarget` are used in protractor	[Closes #13611]
	use sourcemap object in karma plugin (#13584)	[Closes #13580]
	remove deprecated `istanbul` from dependencies (#13567)	[Closes #13562]
	add missing open parenthesis in stacktrace (#13565)	[Closes #13558]
@angular-devkit/build-ng-packagr (0.800.0)
Commit	Description	Notes
	add support for ng-packagr version 5
	implement stable architect API
	propogate errors during execution
@angular-devkit/build-optimizer (0.800.0)
Commit	Description	Notes
	remove deprecated test functions from public API
	don't add pure comments in call expressions	[Closes #14084]
	don't add pure comments inside arrow functions	[Closes #13768]
	prefix renamed extended classes (#13613)	[Closes #13613] [Closes #11796]
@angular-devkit/build-webpack (0.800.0)
Commit	Description	Notes
	include entrypoints in emitted files
	report emitted files
	add a "build" builder
	add API builder for dev server
	add API builder for webpack
	consider name when deduping emitted files
	add dot to file extension in emitted files
	check server address type before use
	also split on multi modules and spaces
@angular-devkit/core (8.0.0)
Commit	Description	Notes
	make new workspace API public
	implement workspace JSON reader/writer
	Remove dep on chokidar
	analytics interfaces and basic implementations
	add workspace reader/writer core API
	add factories for workspace
	remove Log messages from Job API
	jobs should re-log instead of forwarding
	logger.log() should keep own metadata
	export terminal capabilities
	support console logger color customization
	add a reuse JobStrategy
	add a fallback registry
	createJobFactory does not have to have options
	properly replace an added value in workspace API
	deprecate redundant isObservable function
	remove unimplemented prompt priority	[Closes #14402]
	handle async host exceptions for workspace isDirectory/isFile
	NodeJSAsyncHost.isFile should check for a file
	support writing an empty object workspace
	host.delete() completes but never emits	[Closes #14235]
	ignore undefined targets when adding a workspace project
	ensure long workspace value changes are multiline
	escape workspace json pointers
	allow scoped names for workspace projects
	add project type as a workspace special extension
	correct workspace discovery
	fix true schemas post transform step
	remove static initialization using process object
	Properly subscribe/unsubscribe to observables
@angular-devkit/schematics (8.0.0)
Commit	Description	Notes
	add support for analytics
	support unicode character HTML element names (#13837)
	support basic promise/async based rules (#13660)
	support pnpm as a package manager option
	deprecate synchronous testing methods
	use rxjs version of isObservable
	fully support async rules
	add aliases to collection-schema.json
	use `join` instead of normal string concatenation	[Closes #13654]
@ngtools/webpack (8.0.0)
Commit	Description	Notes
	remove importFactories option
	support loadchildren string syntax in Ivy
	redirect ngcc errors and warnings to webpack
	reuse compiler host in webpack child compilations
	add NGCC as part of the workflow
	support import syntax for loadChildren with ViewEngine
	add option to control lazy route discovery
	support Angular 8
	allow .svg files as templates	[Closes #10567]
	import factory from original declaration file	[Closes #14399]
	fixes ngcc error when project name is the same or partially the same as a module name	[Closes #14317]
	log ngcc info messages (#14320)	[Closes #14194]
	set correct peerDependencies for TypeScript and Angular Compiler CLI
	replace bootstrap code under Ivy unless running in JIT mode
	changes in non module code are not picked up when using barrel files	[Closes #13975]
	replace resources should return class node when modified
	don't invalidate cache after first run
	`getCurrentDirectory` should not return a devkit path
	don't load ngfactories for lazy routes with Ivy
	provide a TS-like path to ngProgram.listLazyRoutes	[Closes #13531]
@schematics/schematics (0.800.0)
Commit	Description	Notes
	update jasmine to 3.3.1+
	use correct collection.json path
@schematics/update (0.800.0)
Commit	Description	Notes
	show executing package during migrations
	guard against null value for semver check
devkit (0.800.0)
Commit	Description	Notes
	make name required for devkit package schematics
@schematics/angular (8.0.0)
Commit	Description	Notes
	update scaffolding rxjs version to 6.5.1
	drop @angular/http from dependencies
	enable support for Chrome 41
	update `karma` to `4.1.x`
	add lazy module path fixer
	add more information and browsers in browserlist
	migrate existing ES5 projects to support differential loading
	update several workspace dependencies
	set workspace tsconfig target to es2015
	stop adding `@angular/http` dependency when running universal schematic
	add web worker schematics
	remove ivy-ngcc postinstall script from new application
	update to codelyzer 5
	drop es6 from modern polyfills
	tslint migration for 8
	update to ng-packagr version 5
	add type checking for protractor.conf.js file	[Closes #13958]
	use more codelyzer rules
	allow ember, ember-cli, vendor, app and test names
	update workspace jasmine to 3.3.1+
	JSON schema for service worker config
	use esnext as the default TS module format
	update minimum karma and tslint versions
	change layout for root applications
	relocate `ng g service-worker` files
	rename `tsconfig.e2e.json` to `tsconfig.json`
	change layout of e2e files
	recommend plugins that John Papa recommends
	rename experimentalIvy to enableIvy
	Update rxjs to 6.4.0
	scaffold new projects with angular packages version 8
	remove `annotateForClosureCompiler` in libraries tsconfig (#13546)
	add migration to update `web-animations-js` polyfill	[Closes #14518]
	drop the worker alias	[Closes #14525]
	handle newline after `@` of a decorator	[Closes #14490]
	enable tsickle for library compilation
	update or add module and target to non extended tsconfig	[Closes #14436]
	polyfills migration leaving broken code in windows	[Closes #14443]
	update zone.js to 0.9.1
	differential loading migration should run only for projects using `@angular-devkit/build-angular:browser`	[Closes #14389]
	tsconfig with comments breaks universal schematic	[Closes #14371]
	remove old GoogleBot browserslist setting	[Closes #14364]
	linting errors in AST utils spec
	allow insertion when there are no occurrences
	project name option in the library schematic
	older projects are not migrated to support differential loading	[Closes #14321]
	avoid tslint overhead for lazy module migration
	reduce package installs for 8.0 migrations (#14324)
	set CLI 8.0 codelyzer migration version to ^5.0.1
	update zone.js version during CLI 8.0 migration	[Closes #14281]
	normalize differing TS AST versions in lazy module migration
	remove tsquery peer dependency warning	[Closes #14270]
	avoid double header/comments in es6 polyfill migration
	workaround bug in recorder/update
	move and update existing `src/browserslist`	[Closes #14232]
	align differential loading migration to browserslist template
	fix paths when `newProjectRoot` is an empty string	[Closes #14108]
	skip E2E projects when migrating browserslist
	ensure Angular builders are migrated to latest versions
	migrate TS module type to esnext
	handle polyfill migration in non root applications
	generate `tsconfig.worker.json` outside of the `src` folder
	add `tsconfig.worker.json` to list of tsconfigs to lint
	properly log data received in web worker snippet
	set version 8 migration to execute for beta versions
	minimal should not add `test` target
	remove unused core-js dependency from new projects
	buildRelativePath handles files in root
	remove baseUrl from universal tsconfig	[Closes #13935]
	change entry file name of the library schematic according to the kebab-case convention
	reintroduce `.sass` as a supported file extention	[Closes #13739]
	kebab case prefix causes lint errors in new directives	[Closes #13796]
	default newProjectRoot to current directory
	remove ViewEncapsulation from root component
	remove extra comma in component schematic
	use enableIvy as true
	JsonUtils should respect indent
	`findModuleFromOptions` not handling properly different casing in name	[Closes #13714]
	undefined is used as newProjectRoot when none is set	[Closes #13703]
	fix missing semicolons in extensions.json.template
	add file extensions to style prompt
	fixes issue that `ViewEncapsulation` is not being configured when provided	[Closes #13689]
	respect the flag when we create a guard with schematics
	Include bazel-out in .gitignore	[Closes #13636]
	set restartOnFileChange to true in karma.conf templates	[Closes #13542]
	e2e test fails strict TS config
	update latest version of devkit
	update typescript to 3.2.4 (#13554)
	set cortrect file extention in config when using preprocessors (#13552)	[Closes #13550]
	use baseUrl for default e2e test
	remove leading comments when removing `core-js/es7/reflect` (#13528)	[Closes #13491]
@angular-devkit/architect-cli (0.800.0)
Commit	Description	Notes
	clear console and show logs
	wait for last output of build
	CLI tool to use new Architect API
	fix paths to support Windows
	remove any throttling of the progress bar

---

Note About Versioning

You might have noticed some versions have changed since the last release. We always had two channels for our packages; stable and experimental. For example, @angular/cli is stable, while @angular-devkit/build-angular is experimental. So far, we managed those versions independently of each others (7.3.x matches 0.13.x, while 8.0.0 matches 0.14.0).

From version 8.0.0 and upwards, we will start using the power of Mathematics for choosing the experimental packages versions. The formula is simple; "0." + (major * 100 + minor) + "." + patch. So, for example, the 8.0.0 release becomes the 0.800.0 version for experimental packages.

This allows us to better manage our experimental packages (they are always monotonic with time), and it allows users to know if they are not matching versions between their packages in their projects, without relying on looking up the npm registry or other sources. If a package version does not match the formula above, you might have mismatching packages.

---

Special Thanks

Charles Lyding, Alan Agius, Hans Larsen, Renovate Bot, Filipe Silva, Alan, Alex Eagle, Minko Gechev, Cédric Exbrayat, Keen Yee Liau, hawkgs, Judy Bogart, ManfredSteyer, WilliamKoza, Vikram Subramanian, mrmeku, hrocha16, Louis Larry, Captain Caius, Nikita Poltoratsky, Craig Spence, Sam Thorogood, Logan Mzz, Jason Miller, Andriy Pyvovarchuk, ukrukar, JiaLiPassion, Kara, Niyaz Akhmetov, Will, Olivier Combe, Emilio Martinez, Cyrille Tuzi, Mathias Raacke, mgechev, Rares Matei, Amadou Sall, cipchk, owenmecham, George Kalpakas, Luis Confraria, William KOZA, Andrey Chalkin, Stephen Fluin