@angular/core 7.0.0-rc.1 → 7.0.3

package/src/metadata/lifecycle_hooks.d.ts

@@ -12,6 +12,7 @@ import { SimpleChange } from '../change_detection/change_detection_util';
  *
  * @see `OnChanges`
  *
+ * @publicApi
  */
 export interface SimpleChanges {
     [propName: string]: SimpleChange;
@@ -31,6 +32,7 @@ export interface SimpleChanges {
  *
  * {@example core/ts/metadata/lifecycle_hooks_spec.ts region='OnChanges'}
  *
+ * @publicApi
  */
 export interface OnChanges {
     /**
@@ -57,7 +59,7 @@ export interface OnChanges {
  *
  * {@example core/ts/metadata/lifecycle_hooks_spec.ts region='OnInit'}
  *
- *
+ * @publicApi
  */
 export interface OnInit {
     /**
@@ -91,6 +93,7 @@ export interface OnInit {
  *
  * {@example core/ts/metadata/lifecycle_hooks_spec.ts region='DoCheck'}
  *
+ * @publicApi
  */
 export interface DoCheck {
     /**
@@ -114,6 +117,7 @@ export interface DoCheck {
  *
  * {@example core/ts/metadata/lifecycle_hooks_spec.ts region='OnDestroy'}
  *
+ * @publicApi
  */
 export interface OnDestroy {
     /**
@@ -138,7 +142,7 @@ export interface OnDestroy {
  *
  * {@example core/ts/metadata/lifecycle_hooks_spec.ts region='AfterContentInit'}
  *
- *
+ * @publicApi
  */
 export interface AfterContentInit {
     /**
@@ -163,7 +167,7 @@ export interface AfterContentInit {
  *
  * {@example core/ts/metadata/lifecycle_hooks_spec.ts region='AfterContentChecked'}
  *
- *
+ * @publicApi
  */
 export interface AfterContentChecked {
     /**
@@ -189,7 +193,7 @@ export interface AfterContentChecked {
  *
  * {@example core/ts/metadata/lifecycle_hooks_spec.ts region='AfterViewInit'}
  *
- *
+ * @publicApi
  */
 export interface AfterViewInit {
     /**
@@ -214,6 +218,7 @@ export interface AfterViewInit {
  *
  * {@example core/ts/metadata/lifecycle_hooks_spec.ts region='AfterViewChecked'}
  *
+ * @publicApi
  */
 export interface AfterViewChecked {
     /**

package/src/metadata/ng_module.d.ts

@@ -65,6 +65,8 @@ export interface NgModuleDef<T> {
  *
  * @param T the module type. In Ivy applications, this must be explicitly
  * provided.
+ *
+ * @publicApi
  */
 export interface ModuleWithProviders<T = any /** TODO(alxhub): remove default when callers pass explicit type param */> {
     ngModule: Type<T>;
@@ -77,7 +79,7 @@ export interface ModuleWithProviders<T = any /** TODO(alxhub): remove default wh
  *
  * @param name The name of a defined schema.
  *
- * @experimental
+ * @publicApi
  */
 export interface SchemaMetadata {
     name: string;
@@ -88,19 +90,17 @@ export interface SchemaMetadata {
  * - Element properties named with dash case (`-`).
  * Dash case is the naming convention for custom elements.
  *
- *
+ * @publicApi
  */
 export declare const CUSTOM_ELEMENTS_SCHEMA: SchemaMetadata;
 /**
  * Defines a schema that allows any property on any element.
  *
- * @experimental
+ * @publicApi
  */
 export declare const NO_ERRORS_SCHEMA: SchemaMetadata;
 /**
  * Type of the NgModule decorator / constructor function.
- *
- *
  */
 export interface NgModuleDecorator {
     /**
@@ -111,8 +111,6 @@ export interface NgModuleDecorator {
 }
 /**
  * Type of the NgModule metadata.
- *
- *
  */
 export interface NgModule {
     /**
@@ -297,6 +295,7 @@ export interface NgModule {
 }
 /**
  * @Annotation
+ * @publicApi
  */
 export declare const NgModule: NgModuleDecorator;
 /**
@@ -317,6 +316,7 @@ export declare const NgModule: NgModuleDecorator;
  * }
  * ```
  *
+ * @publicApi
  */
 export interface DoBootstrap {
     ngDoBootstrap(appRef: ApplicationRef): void;

package/src/metadata/view.d.ts

@@ -12,7 +12,10 @@
  *
  * @usageNotes
  * ### Example
+ *
  * {@example core/ts/metadata/encapsulation.ts region='longform'}
+ *
+ * @publicApi
  */
 export declare enum ViewEncapsulation {
     /**

package/src/platform_core_providers.d.ts

@@ -10,6 +10,6 @@ import { StaticProvider } from './di';
 /**
  * This platform has to be included in any other platform
  *
- * @experimental
+ * @publicApi
  */
 export declare const platformCore: (extraProviders?: StaticProvider[] | undefined) => PlatformRef;

package/src/profile/profile.d.ts

@@ -39,7 +39,7 @@ export declare const wtfEnabled: boolean;
  * needs to be fixed before the app should be profiled. Add try-finally only when you expect that
  * an exception is expected during normal execution while profiling.
  *
- * @experimental
+ * @publicApi
  */
 export declare const wtfCreateScope: (signature: string, flags?: any) => WtfScopeFn;
 /**
@@ -49,7 +49,7 @@ export declare const wtfCreateScope: (signature: string, flags?: any) => WtfScop
  * - `returnValue` (optional) to be passed to the WTF.
  *
  * Returns the `returnValue for easy chaining.
- * @experimental
+ * @publicApi
  */
 export declare const wtfLeave: <T>(scope: any, returnValue?: T) => T;
 /**
@@ -63,13 +63,13 @@ export declare const wtfLeave: <T>(scope: any, returnValue?: T) => T;
  *          wtfEndTimeRange(s);
  *        });
  *     }
- * @experimental
+ * @publicApi
  */
 export declare const wtfStartTimeRange: (rangeType: string, action: string) => any;
 /**
  * Ends a async time range operation.
  * [range] is the return value from [wtfStartTimeRange] Async ranges only work if WTF has been
  * enabled.
- * @experimental
+ * @publicApi
  */
 export declare const wtfEndTimeRange: (range: any) => void;

package/src/profile/wtf_impl.d.ts

@@ -8,7 +8,7 @@
 /**
  * A scope function for the Web Tracing Framework (WTF).
  *
- * @experimental
+ * @publicApi
  */
 export interface WtfScopeFn {
     (arg0?: any, arg1?: any): any;

package/src/r3_symbols.d.ts

@@ -7,7 +7,7 @@
  */
 export { InjectableDef as ɵInjectableDef, InjectorDef as ɵInjectorDef, defineInjectable, defineInjector } from './di/defs';
 export { inject } from './di/injector';
-export { NgModuleDef as ɵNgModuleDef } from './metadata/ng_module';
+export { NgModuleDef as ɵNgModuleDef, NgModuleDefWithMeta as ɵNgModuleDefWithMeta } from './metadata/ng_module';
 export { defineNgModule as ɵdefineNgModule } from './render3/definition';
 export { NgModuleFactory as ɵNgModuleFactory } from './render3/ng_module_ref';
 /**

package/src/render/api.d.ts

@@ -10,6 +10,7 @@ import { Injector } from '../di/injector';
 import { ViewEncapsulation } from '../metadata/view';
 /**
  * @deprecated Use `RendererType2` (and `Renderer2`) instead.
+ * @publicApi
  */
 export declare class RenderComponentType {
     id: string;
@@ -21,7 +22,7 @@ export declare class RenderComponentType {
     constructor(id: string, templateUrl: string, slotCount: number, encapsulation: ViewEncapsulation, styles: Array<string | any[]>, animations: any);
 }
 /**
- * @deprecated Debug info is handeled internally in the view engine now.
+ * @deprecated Debug info is handled internally in the view engine now.
  */
 export declare abstract class RenderDebugInfo {
     abstract readonly injector: Injector;
@@ -45,6 +46,7 @@ export interface DirectRenderer {
 }
 /**
  * @deprecated Use the `Renderer2` instead.
+ * @publicApi
  */
 export declare abstract class Renderer {
     abstract selectRootElement(selectorOrNode: string | any, debugInfo?: RenderDebugInfo): any;
@@ -59,13 +61,13 @@ export declare abstract class Renderer {
     abstract listen(renderElement: any, name: string, callback: Function): Function;
     abstract listenGlobal(target: string, name: string, callback: Function): Function;
     abstract setElementProperty(renderElement: any, propertyName: string, propertyValue: any): void;
-    abstract setElementAttribute(renderElement: any, attributeName: string, attributeValue: string): void;
+    abstract setElementAttribute(renderElement: any, attributeName: string, attributeValue?: string): void;
     /**
      * Used only in debug mode to serialize property changes to dom nodes as attributes.
      */
     abstract setBindingDebugInfo(renderElement: any, propertyName: string, propertyValue: string): void;
     abstract setElementClass(renderElement: any, className: string, isAdd: boolean): void;
-    abstract setElementStyle(renderElement: any, styleName: string, styleValue: string): void;
+    abstract setElementStyle(renderElement: any, styleName: string, styleValue?: string): void;
     abstract invokeElementMethod(renderElement: any, methodName: string, args?: any[]): void;
     abstract setText(renderNode: any, text: string): void;
     abstract animate(element: any, startingStyles: any, keyframes: any[], duration: number, delay: number, easing: string, previousPlayers?: any[]): any;
@@ -84,6 +86,7 @@ export declare const Renderer2Interceptor: InjectionToken<Renderer2[]>;
  * The default Renderer implementation is `DomRenderer`. Also available is `WebWorkerRenderer`.
  *
  * @deprecated Use `RendererFactory2` instead.
+ * @publicApi
  */
 export declare abstract class RootRenderer {
     abstract renderComponent(componentType: RenderComponentType): Renderer;
@@ -91,7 +94,7 @@ export declare abstract class RootRenderer {
 /**
  * Used by `RendererFactory2` to associate custom rendering data and styles
  * with a rendering implementation.
- *  @experimental
+ *  @publicApi
  */
 export interface RendererType2 {
     /**
@@ -125,7 +128,7 @@ export interface RendererType2 {
 /**
  * Creates and initializes a custom renderer that implements the `Renderer2` base class.
  *
- * @experimental
+ * @publicApi
  */
 export declare abstract class RendererFactory2 {
     /**
@@ -151,7 +154,7 @@ export declare abstract class RendererFactory2 {
 }
 /**
  * Flags for renderer-specific style modifiers.
- * @experimental
+ * @publicApi
  */
 export declare enum RendererStyleFlags2 {
     /**
@@ -176,7 +179,7 @@ export declare enum RendererStyleFlags2 {
  * not statically known, use the `setProperty()` or
  * `setAttribute()` method.
  *
- * @experimental
+ * @publicApi
  */
 export declare abstract class Renderer2 {
     /**

package/src/render3/component.d.ts

@@ -9,9 +9,8 @@ import { Type } from '../core';
 import { Injector } from '../di/injector';
 import { Sanitizer } from '../sanitization/security';
 import { ComponentDef, ComponentType } from './interfaces/definition';
-import { LElementNode } from './interfaces/node';
 import { PlayerHandler } from './interfaces/player';
-import { RElement, RendererFactory3 } from './interfaces/renderer';
+import { RElement, RNode, Renderer3, RendererFactory3 } from './interfaces/renderer';
 import { LViewData, RootContext } from './interfaces/view';
 /** Options that control how the component should be bootstrapped. */
 export interface CreateComponentOptions {
@@ -72,11 +71,23 @@ export declare const NULL_INJECTOR: Injector;
  * @param options Optional parameters which control bootstrapping
  */
 export declare function renderComponent<T>(componentType: ComponentType<T> | Type<T>, opts?: CreateComponentOptions): T;
+/**
+ * Creates the root component view and the root component node.
+ *
+ * @param rNode Render host element.
+ * @param def ComponentDef
+ * @param rootView The parent view where the host node is stored
+ * @param renderer The current renderer
+ * @param sanitizer The sanitizer, if provided
+ *
+ * @returns Component view created
+ */
+export declare function createRootComponentView(rNode: RElement | null, def: ComponentDef<any>, rootView: LViewData, renderer: Renderer3, sanitizer?: Sanitizer | null): LViewData;
 /**
  * Creates a root component and sets it up with features and host bindings. Shared by
  * renderComponent() and ViewContainerRef.createComponent().
  */
-export declare function createRootComponent<T>(elementNode: LElementNode, componentDef: ComponentDef<T>, rootView: LViewData, rootContext: RootContext, hostFeatures: HostFeature[] | null): any;
+export declare function createRootComponent<T>(hostRNode: RNode | null, componentView: LViewData, componentDef: ComponentDef<T>, rootView: LViewData, rootContext: RootContext, hostFeatures: HostFeature[] | null): any;
 export declare function createRootContext(scheduler: (workFn: () => void) => void, playerHandler?: PlayerHandler | null): RootContext;
 /**
  * Used to enable lifecycle hooks on the root component.

package/src/render3/context_discovery.d.ts

@@ -6,52 +6,8 @@
  * found in the LICENSE file at https://angular.io/license
  */
 import './ng_dev_mode';
-import { LElementNode } from './interfaces/node';
-import { RElement } from './interfaces/renderer';
+import { LContext } from './interfaces/context';
 import { LViewData } from './interfaces/view';
-/**
- * This property will be monkey-patched on elements, components and directives
- */
-export declare const MONKEY_PATCH_KEY_NAME = "__ngContext__";
-/**
- * The internal view context which is specific to a given DOM element, directive or
- * component instance. Each value in here (besides the LViewData and element node details)
- * can be present, null or undefined. If undefined then it implies the value has not been
- * looked up yet, otherwise, if null, then a lookup was executed and nothing was found.
- *
- * Each value will get filled when the respective value is examined within the getContext
- * function. The component, element and each directive instance will share the same instance
- * of the context.
- */
-export interface LContext {
-    /**
-     * The component's parent view data.
-     */
-    lViewData: LViewData;
-    /**
-     * The index instance of the node.
-     */
-    nodeIndex: number;
-    /**
-     * The instance of the DOM node that is attached to the lNode.
-     */
-    native: RElement;
-    /**
-     * The instance of the Component node.
-     */
-    component: {} | null | undefined;
-    /**
-     * The list of active directives that exist on this element.
-     */
-    directives: any[] | null | undefined;
-    /**
-     * The map of local references (local reference name => element or directive instance) that exist
-     * on this element.
-     */
-    localRefs: {
-        [key: string]: any;
-    } | null | undefined;
-}
 /** Returns the matching `LContext` data for a given DOM node, directive or component instance.
  *
  * This function will examine the provided DOM element, component, or directive instance\'s
@@ -71,24 +27,17 @@ export interface LContext {
  */
 export declare function getContext(target: any): LContext | null;
 /**
- * A simplified lookup function for finding the LElementNode from a component instance.
+ * Takes a component instance and returns the view for that component.
  *
- * This function exists for tree-shaking purposes to avoid having to pull in everything
- * that `getContext` has in the event that an Angular application doesn't need to have
- * any programmatic access to an element's context (only change detection uses this function).
+ * @param componentInstance
+ * @returns The component's view
  */
-export declare function getLElementFromComponent(componentInstance: {}): LElementNode;
+export declare function getComponentViewByInstance(componentInstance: {}): LViewData;
 /**
  * Assigns the given data to the given target (which could be a component,
  * directive or DOM node instance) using monkey-patching.
  */
 export declare function attachPatchData(target: any, data: LViewData | LContext): void;
-/**
- * Returns the monkey-patch value data present on the target (which could be
- * a component, directive or a DOM node).
- */
-export declare function readPatchedData(target: any): LViewData | LContext | null;
-export declare function readPatchedLViewData(target: any): LViewData | null;
 export declare function isComponentInstance(instance: any): boolean;
 export declare function isDirectiveInstance(instance: any): boolean;
 /**
@@ -104,7 +53,6 @@ export declare function discoverDirectives(nodeIndex: number, lViewData: LViewDa
  * Returns a map of local references (local reference name => element or directive instance) that
  * exist on a given element.
  */
-export declare function discoverLocalRefs(lViewData: LViewData, lNodeIndex: number): {
+export declare function discoverLocalRefs(lViewData: LViewData, nodeIndex: number): {
     [key: string]: any;
 } | null;
-export declare function readElementValue(value: LElementNode | any[]): LElementNode;

package/src/render3/definition.d.ts

@@ -234,10 +234,6 @@ export declare function defineComponent<T>(componentDefinition: {
      * `PipeDefs`s. The function is necessary to be able to support forward declarations.
      */
     pipes?: PipeTypesOrFactory | null;
-    /**
-     * Registry of the animation triggers present on the component that will be used by the view.
-     */
-    animations?: any[] | null;
 }): never;
 export declare function extractDirectiveDef(type: DirectiveType<any> & ComponentType<any>): DirectiveDef<any> | ComponentDef<any>;
 export declare function extractPipeDef(type: PipeType<any>): PipeDef<any>;

package/src/render3/di.d.ts

@@ -7,7 +7,6 @@
  */
 import { InjectionToken } from '../di/injection_token';
 import { InjectFlags, Injector } from '../di/injector';
-import { Renderer2 } from '../render';
 import { Type } from '../type';
 import { DirectiveDef } from './interfaces/definition';
 import { TContainerNode, TElementContainerNode, TElementNode, TNode } from './interfaces/node';
@@ -82,7 +81,6 @@ export declare function diPublic(def: DirectiveDef<any>): void;
  */
 export declare function directiveInject<T>(token: Type<T> | InjectionToken<T>): T;
 export declare function directiveInject<T>(token: Type<T> | InjectionToken<T>, flags: InjectFlags): T;
-export declare function injectRenderer2(): Renderer2;
 /**
  * Inject static attribute value into directive constructor.
  *
@@ -112,7 +110,7 @@ export declare function injectRenderer2(): Renderer2;
  * })
  * ```
  *
- * @experimental
+ * @publicApi
  */
 export declare function injectAttribute(attrNameToInject: string): string | undefined;
 /**

package/src/render3/discovery_utils.d.ts

@@ -6,6 +6,7 @@
  * found in the LICENSE file at https://angular.io/license
  */
 import { Injector } from '../di/injector';
+import { LContext } from './interfaces/context';
 import { LViewData, RootContext } from './interfaces/view';
 /**
  * NOTE: The following functions might not be ideal for core usage in Angular...
@@ -35,7 +36,7 @@ export declare function getHostComponent<T = {}>(target: {}): T | null;
  * Returns the `RootContext` instance that is associated with
  * the application where the target is situated.
  */
-export declare function getRootContext(target: {}): RootContext;
+export declare function getRootContext(target: LViewData | {}): RootContext;
 /**
  * Returns a list of all the components in the application
  * that are have been bootstrapped.
@@ -51,6 +52,11 @@ export declare function getInjector(target: {}): Injector;
  * with the underlying target element.
  */
 export declare function getDirectives(target: {}): Array<{}>;
+/**
+ * Returns LContext associated with a target passed as an argument.
+ * Throws if a given target doesn't have associated LContext.
+ */
+export declare function loadContext(target: {}): LContext;
 /**
  * Retrieve the root view from any component by walking the parent `LViewData` until
  * reaching the root `LViewData`.

package/src/render3/i18n.d.ts

@@ -61,6 +61,10 @@ export declare type PlaceholderMap = {
  * @returns A list of instructions used to translate each template.
  */
 export declare function i18nMapping(translation: string, elements: (PlaceholderMap | null)[] | null, expressions?: (PlaceholderMap | null)[] | null, templateRoots?: string[] | null, lastChildIndex?: number | null): I18nInstruction[][];
+export declare function i18nAttribute(index: number, attrs: any[]): void;
+export declare function i18nExp(expression: any): void;
+export declare function i18nStart(index: number, message: string, subTemplateIndex?: number): void;
+export declare function i18nEnd(): void;
 /**
  * Takes a list of instructions generated by `i18nMapping()` to transform the template accordingly.
  *

package/src/render3/index.d.ts

@@ -12,11 +12,11 @@ import { NgOnChangesFeature } from './features/ng_onchanges_feature';
 import { PublicFeature } from './features/public_feature';
 import { BaseDef, ComponentDef, ComponentDefWithMeta, ComponentTemplate, ComponentType, DirectiveDef, DirectiveDefFlags, DirectiveDefWithMeta, DirectiveType, PipeDef, PipeDefWithMeta } from './interfaces/definition';
 export { ComponentFactory, ComponentFactoryResolver, ComponentRef, WRAP_RENDERER_FACTORY2, injectComponentFactoryResolver } from './component_ref';
-export { directiveInject, getFactoryOf, getInheritedFactory, injectAttribute, injectRenderer2 } from './di';
+export { directiveInject, getFactoryOf, getInheritedFactory, injectAttribute } from './di';
 export { RenderFlags } from './interfaces/definition';
 export { CssSelectorList } from './interfaces/projection';
 export { NO_CHANGE, bind, interpolation1, interpolation2, interpolation3, interpolation4, interpolation5, interpolation6, interpolation7, interpolation8, interpolationV, container, containerRefreshStart, containerRefreshEnd, nextContext, element, elementAttribute, elementClassProp, elementEnd, elementProperty, elementStart, elementContainerStart, elementContainerEnd, elementStyling, elementStylingMap, elementStyleProp, elementStylingApply, getCurrentView, restoreView, listener, store, load, namespaceHTML, namespaceMathML, namespaceSVG, enableBindings, disableBindings, projection, projectionDef, text, textBinding, template, reference, embeddedViewStart, embeddedViewEnd, detectChanges, markDirty, tick, } from './instructions';
-export { i18nApply, i18nMapping, i18nInterpolation1, i18nInterpolation2, i18nInterpolation3, i18nInterpolation4, i18nInterpolation5, i18nInterpolation6, i18nInterpolation7, i18nInterpolation8, i18nInterpolationV, i18nExpMapping, I18nInstruction, I18nExpInstruction } from './i18n';
+export { i18nAttribute, i18nExp, i18nStart, i18nEnd, i18nApply, i18nMapping, i18nInterpolation1, i18nInterpolation2, i18nInterpolation3, i18nInterpolation4, i18nInterpolation5, i18nInterpolation6, i18nInterpolation7, i18nInterpolation8, i18nInterpolationV, i18nExpMapping, I18nInstruction, I18nExpInstruction } from './i18n';
 export { NgModuleFactory, NgModuleRef, NgModuleType } from './ng_module_ref';
 export { AttributeMarker } from './interfaces/node';
 export { pipe, pipeBind1, pipeBind2, pipeBind3, pipeBind4, pipeBindV, } from './pipe';