refactor(core): split up interface files in render3 (#21433)

PR Close #21433

packages/core/src/render3/interfaces/definition.ts

@@ -0,0 +1,150 @@
+/**
+ * @license
+ * Copyright Google Inc. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+
+import {RendererType2} from '../../render/api';
+import {Type} from '../../type';
+import {resolveRendererType2} from '../../view/util';
+
+/**
+ * Definition of what a template rendering function should look like.
+ */
+export type ComponentTemplate<T> = {
+  (ctx: T, creationMode: boolean): void; ngStaticData?: never;
+};
+export type EmbeddedTemplate<T> = (ctx: T) => void;
+
+export interface ComponentType<T> extends Type<T> { ngComponentDef: ComponentDef<T>; }
+
+export interface DirectiveType<T> extends Type<T> { ngDirectiveDef: DirectiveDef<T>; }
+
+export const enum DirectiveDefFlags {ContentQuery = 0b10}
+
+/**
+ * `DirectiveDef` is a compiled version of the Directive used by the renderer instructions.
+ */
+export interface DirectiveDef<T> {
+  /**
+   * Token representing the directive. Used by DI.
+   */
+  type: Type<T>;
+
+  /** Function that makes a directive public to the DI system. */
+  diPublic: ((def: DirectiveDef<any>) => void)|null;
+
+  /**
+   * List of inputs which are part of the components public API.
+   *
+   * The key is minified property name whereas the value is the original unminified name.
+   */
+  inputs: {[P in keyof T]: P};
+
+  /**
+   * List of outputs which are part of the components public API.
+   *
+   * The key is minified property name whereas the value is the original unminified name.=
+   */
+  outputs: {[P in keyof T]: P};
+
+  /**
+   * List of methods which are part of the components public API.
+   *
+   * The key is minified property name whereas the value is the original unminified name.
+   */
+  methods: {[P in keyof T]: P};
+
+  /**
+   * factory function used to create a new directive instance.
+   *
+   * NOTE: this property is short (1 char) because it is used in
+   * component templates which is sensitive to size.
+   */
+  n(): T;
+
+  /**
+   * Refreshes the view of the component. Also calls lifecycle hooks like
+   * ngAfterViewInit, if they are defined on the component.
+   *
+   * NOTE: this property is short (1 char) because it is used in component
+   * templates which is sensitive to size.
+   *
+   * @param directiveIndex index of the directive in the containing template
+   * @param elementIndex index of an host element for a given directive.
+   */
+  r(directiveIndex: number, elementIndex: number): void;
+
+  /**
+   * Refreshes host bindings on the associated directive. Also calls lifecycle hooks
+   * like ngOnInit and ngDoCheck, if they are defined on the directive.
+   */
+  // Note: This call must be separate from r() because hooks like ngOnInit need to
+  // be called breadth-first across a view before processing onInits in children
+  // (for backwards compatibility). Child template processing thus needs to be
+  // delayed until all inputs and host bindings in a view have been checked.
+  h(directiveIndex: number, elementIndex: number): void;
+}
+
+export interface ComponentDef<T> extends DirectiveDef<T> {
+  /**
+   * Refreshes the view of the component. Also calls lifecycle hooks like
+   * ngAfterViewInit, if they are defined on the component.
+   *
+   * NOTE: this property is short (1 char) because it is used in
+   * component templates which is sensitive to size.
+   *
+   * @param directiveIndex index of the directive in the containing template
+   * @param elementIndex index of an host element for a given component.
+   */
+  r(directiveIndex: number, elementIndex: number): void;
+
+  /**
+   * The tag name which should be used by the component.
+   *
+   * NOTE: only used with component directives.
+   */
+  tag: string;
+
+  /**
+   * The View template of the component.
+   *
+   * NOTE: only used with component directives.
+   */
+  template: ComponentTemplate<T>;
+
+  /**
+   * Renderer type data of the component.
+   *
+   * NOTE: only used with component directives.
+   */
+  rendererType: RendererType2|null;
+}
+
+export interface DirectiveDefArgs<T> {
+  type: Type<T>;
+  factory: () => T;
+  refresh?: (directiveIndex: number, elementIndex: number) => void;
+  inputs?: {[P in keyof T]?: string};
+  outputs?: {[P in keyof T]?: string};
+  methods?: {[P in keyof T]?: string};
+  features?: DirectiveDefFeature[];
+}
+
+export interface ComponentDefArgs<T> extends DirectiveDefArgs<T> {
+  tag: string;
+  template: ComponentTemplate<T>;
+  refresh?: (directiveIndex: number, elementIndex: number) => void;
+  hostBindings?: (directiveIndex: number, elementIndex: number) => void;
+  features?: ComponentDefFeature[];
+  rendererType?: RendererType2;
+}
+
+export type DirectiveDefFeature = <T>(directiveDef: DirectiveDef<T>) => void;
+export type ComponentDefFeature = <T>(directiveDef: DirectiveDef<T>) => void;
+
+// Note: This hack is necessary so we don't erroneously get a circular dependency
+// failure based on types.
+export const unusedValueExportToPlacateAjd = 1;