feat: tree-shakeable providers API updates (#22655)

Rename @Injectable({scope -> providedIn}).

Instead of {providedIn: APP_ROOT_SCOPE}, accept {providedIn: 'root'}.
Also, {providedIn: null} implies the injectable should not be added
to any scope.

PR Close #22655

packages/compiler/src/compile_metadata.ts

@@ -140,7 +140,7 @@ export interface CompileInjectableMetadata {
   symbol: StaticSymbol;
   type: CompileTypeMetadata;
 
-  module?: StaticSymbol;
+  providedIn?: StaticSymbol;
 
   useValue?: any;
   useClass?: StaticSymbol;

packages/compiler/src/core.ts

@@ -127,7 +127,7 @@ export interface ModuleWithProviders {
   providers?: Provider[];
 }
 export interface Injectable {
-  scope?: Type|any;
+  providedIn?: Type|'root'|any;
   useClass?: Type|any;
   useExisting?: Type|any;
   useValue?: any;

packages/compiler/src/injectable_compiler.ts

@@ -89,16 +89,24 @@ export class InjectableCompiler {
   }
 
   injectableDef(injectable: CompileInjectableMetadata, ctx: OutputContext): o.Expression {
+    let providedIn: o.Expression = o.NULL_EXPR;
+    if (injectable.providedIn) {
+      if (typeof injectable.providedIn === 'string') {
+        providedIn = o.literal(injectable.providedIn);
+      } else {
+        providedIn = ctx.importExpr(injectable.providedIn);
+      }
+    }
     const def: MapLiteral = [
       mapEntry('factory', this.factoryFor(injectable, ctx)),
       mapEntry('token', ctx.importExpr(injectable.type.reference)),
-      mapEntry('scope', ctx.importExpr(injectable.module !)),
+      mapEntry('providedIn', providedIn),
     ];
     return o.importExpr(Identifiers.defineInjectable).callFn([o.literalMap(def)]);
   }
 
   compile(injectable: CompileInjectableMetadata, ctx: OutputContext): void {
-    if (injectable.module) {
+    if (injectable.providedIn) {
       const className = identifierName(injectable.type) !;
       const clazz = new o.ClassStmt(
           className, null,

packages/compiler/src/metadata_resolver.ts

@@ -801,7 +801,7 @@ export class CompileMetadataResolver {
     return {
       symbol: type,
       type: typeMetadata,
-      module: meta.scope || undefined,
+      providedIn: meta.providedIn,
       useValue: meta.useValue,
       useClass: meta.useClass,
       useExisting: meta.useExisting,