@angular/core 6.0.3 → 6.0.7

package/src/di/injectable.d.ts

@@ -9,32 +9,23 @@ import { ClassSansProvider, ConstructorSansProvider, ExistingSansProvider, Facto
 export declare type InjectableProvider = ValueSansProvider | ExistingSansProvider | StaticClassSansProvider | ConstructorSansProvider | FactorySansProvider | ClassSansProvider;
 /**
  * Type of the Injectable decorator / constructor function.
- *
- *
  */
 export interface InjectableDecorator {
     /**
-     * @usageNotes
-     * ```
-     * @Injectable()
-     * class Car {}
-     * ```
-     *
-     * @description
-     * A marker metadata that marks a class as available to {@link Injector} for creation.
+     * A marker metadata that marks a class as available to `Injector` for creation.
      *
-     * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+     * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
      *
+     * @usageNotes
      * ### Example
      *
      * {@example core/di/ts/metadata_spec.ts region='Injectable'}
      *
-     * {@link Injector} will throw an error when trying to instantiate a class that
+     * `Injector` will throw an error when trying to instantiate a class that
      * does not have `@Injectable` marker, as shown in the example below.
      *
      * {@example core/di/ts/metadata_spec.ts region='InjectableThrows'}
      *
-     *
      */
     (): any;
     (options?: {
@@ -58,7 +49,6 @@ export declare function convertInjectableProviderToFactory(type: Type<any>, prov
 /**
 * Injectable decorator and metadata.
 *
-*
 * @Annotation
 */
 export declare const Injectable: InjectableDecorator;

package/src/di/injection_token.d.ts

@@ -32,16 +32,14 @@ import { Type } from '../type';
  * overrides the above behavior and marks the token as belonging to a particular `@NgModule`. As
  * mentioned above, `'root'` is the default value for `providedIn`.
  *
- * ### Example
- *
- * #### Tree-shakeable InjectionToken
- *
- * {@example core/di/ts/injector_spec.ts region='ShakeableInjectionToken'}
- *
- * #### Plain InjectionToken
+ * @usageNotes
+ * ### Basic Example
  *
  * {@example core/di/ts/injector_spec.ts region='InjectionToken'}
  *
+ * ### Tree-shakeable Example
+ *
+ * {@example core/di/ts/injector_spec.ts region='ShakeableInjectionToken'}
  *
  */
 export declare class InjectionToken<T> {

package/src/di/injector.d.ts

@@ -23,23 +23,17 @@ export declare class NullInjector implements Injector {
     get(token: any, notFoundValue?: any): any;
 }
 /**
- * @usageNotes
- * ```
- * const injector: Injector = ...;
- * injector.get(...);
- * ```
- *
- * @description
- *
  * Concrete injectors implement this interface.
  *
- * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+ * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
  *
+ * @usageNotes
  * ### Example
  *
  * {@example core/di/ts/injector_spec.ts region='Injector'}
  *
  * `Injector` returns itself when given `Injector` as a token:
+ *
  * {@example core/di/ts/injector_spec.ts region='injectInjector'}
  *
  *
@@ -103,7 +97,10 @@ export declare function setCurrentInjector(injector: Injector | null | undefined
  * Injects a token from the currently active injector.
  *
  * This function must be used in the context of a factory function such as one defined for an
- * `InjectionToken`, and will throw an error if not called from such a context. For example:
+ * `InjectionToken`, and will throw an error if not called from such a context.
+ *
+ * @usageNotes
+ * ### Example
  *
  * {@example core/di/ts/injector_spec.ts region='ShakeableInjectionToken'}
  *

package/src/di/metadata.d.ts

@@ -1,43 +1,29 @@
 /**
  * Type of the Inject decorator / constructor function.
- *
- *
  */
 export interface InjectDecorator {
     /**
-     * @usageNotes
-     * ```
-     * @Injectable()
-     * class Car {
-     *   constructor(@Inject("MyEngine") public engine:Engine) {}
-     * }
-     * ```
-     *
-     * @description
      * A parameter decorator that specifies a dependency.
      *
-     * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+     * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
      *
+     * @usageNotes
      * ### Example
      *
      * {@example core/di/ts/metadata_spec.ts region='Inject'}
      *
-     * When `@Inject()` is not present, {@link Injector} will use the type annotation of the
+     * When `@Inject()` is not present, `Injector` will use the type annotation of the
      * parameter.
      *
      * ### Example
      *
      * {@example core/di/ts/metadata_spec.ts region='InjectWithoutDecorator'}
-     *
-     *
      */
     (token: any): any;
     new (token: any): Inject;
 }
 /**
  * Type of the Inject metadata.
- *
- *
  */
 export interface Inject {
     token: any;
@@ -45,122 +31,79 @@ export interface Inject {
 /**
  * Inject decorator and metadata.
  *
- *
  * @Annotation
  */
 export declare const Inject: InjectDecorator;
 /**
  * Type of the Optional decorator / constructor function.
- *
- *
  */
 export interface OptionalDecorator {
     /**
-     * @usageNotes
-     * ```
-     * @Injectable()
-     * class Car {
-     *   constructor(@Optional() public engine:Engine) {}
-     * }
-     * ```
-     *
-     * @description
      * A parameter metadata that marks a dependency as optional.
-     * {@link Injector} provides `null` if the dependency is not found.
+     * `Injector` provides `null` if the dependency is not found.
      *
-     * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+     * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
      *
+     * @usageNotes
      * ### Example
      *
      * {@example core/di/ts/metadata_spec.ts region='Optional'}
-     *
-     *
      */
     (): any;
     new (): Optional;
 }
 /**
  * Type of the Optional metadata.
- *
- *
  */
 export interface Optional {
 }
 /**
  * Optional decorator and metadata.
  *
- *
  * @Annotation
  */
 export declare const Optional: OptionalDecorator;
 /**
  * Type of the Self decorator / constructor function.
- *
- *
  */
 export interface SelfDecorator {
     /**
-     * @usageNotes
-     * ```
-     * @Injectable()
-     * class Car {
-     *   constructor(@Self() public engine:Engine) {}
-     * }
-     * ```
-     *
-     * @description
-     * Specifies that an {@link Injector} should retrieve a dependency only from itself.
+     * Specifies that an `Injector` should retrieve a dependency only from itself.
      *
-     * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+     * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
      *
+     * @usageNotes
      * ### Example
      *
      * {@example core/di/ts/metadata_spec.ts region='Self'}
-     *
-     *
      */
     (): any;
     new (): Self;
 }
 /**
  * Type of the Self metadata.
- *
- *
  */
 export interface Self {
 }
 /**
  * Self decorator and metadata.
  *
- *
  * @Annotation
  */
 export declare const Self: SelfDecorator;
 /**
  * Type of the SkipSelf decorator / constructor function.
- *
- *
  */
 export interface SkipSelfDecorator {
     /**
-     * @usageNotes
-     * ```
-     * @Injectable()
-     * class Car {
-     *   constructor(@SkipSelf() public engine:Engine) {}
-     * }
-     * ```
-     *
-     * @description
      * Specifies that the dependency resolution should start from the parent injector.
      *
-     * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+     * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
      *
+     * @usageNotes
      * ### Example
      *
      * {@example core/di/ts/metadata_spec.ts region='SkipSelf'}
-     *
-     *
      */
     (): any;
     new (): SkipSelf;
@@ -175,51 +118,35 @@ export interface SkipSelf {
 /**
  * SkipSelf decorator and metadata.
  *
- *
  * @Annotation
  */
 export declare const SkipSelf: SkipSelfDecorator;
 /**
  * Type of the Host decorator / constructor function.
- *
- *
  */
 export interface HostDecorator {
     /**
-     * @usageNotes
-     * ```
-     * @Injectable()
-     * class Car {
-     *   constructor(@Host() public engine:Engine) {}
-     * }
-     * ```
-     *
-     * @description
      * Specifies that an injector should retrieve a dependency from any injector until
      * reaching the host element of the current component.
      *
-     * For more details, see the {@linkDocs guide/dependency-injection "Dependency Injection Guide"}.
+     * For more details, see the ["Dependency Injection Guide"](guide/dependency-injection).
      *
+     * @usageNotes
      * ### Example
      *
      * {@example core/di/ts/metadata_spec.ts region='Host'}
-     *
-     *
      */
     (): any;
     new (): Host;
 }
 /**
  * Type of the Host metadata.
- *
- *
  */
 export interface Host {
 }
 /**
  * Host decorator and metadata.
  *
- *
  * @Annotation
  */
 export declare const Host: HostDecorator;