@angular/core 15.2.2 → 15.2.4

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v15.2.2
+ * @license Angular v15.2.4
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -792,6 +792,9 @@ export declare abstract class ChangeDetectorRef {
     abstract reattach(): void;
 }
 
+declare interface ChangeDetectorRefInterface extends ChangeDetectorRef {
+}
+
 declare const CHILD_HEAD = 13;
 
 declare const CHILD_TAIL = 14;
@@ -1235,6 +1238,101 @@ declare interface ComponentDefFeature {
     ngInherit?: true;
 }
 
+declare interface ComponentDefinition<T> extends Omit<DirectiveDefinition<T>, 'features'> {
+    /**
+     * The number of nodes, local refs, and pipes in this component template.
+     *
+     * Used to calculate the length of this component's LView array, so we
+     * can pre-fill the array and set the binding start index.
+     */
+    decls: number;
+    /**
+     * The number of bindings in this component template (including pure fn bindings).
+     *
+     * Used to calculate the length of this component's LView array, so we
+     * can pre-fill the array and set the host binding start index.
+     */
+    vars: number;
+    /**
+     * Template function use for rendering DOM.
+     *
+     * This function has following structure.
+     *
+     * ```
+     * function Template<T>(ctx:T, creationMode: boolean) {
+     *   if (creationMode) {
+     *     // Contains creation mode instructions.
+     *   }
+     *   // Contains binding update instructions
+     * }
+     * ```
+     *
+     * Common instructions are:
+     * Creation mode instructions:
+     *  - `elementStart`, `elementEnd`
+     *  - `text`
+     *  - `container`
+     *  - `listener`
+     *
+     * Binding update instructions:
+     * - `bind`
+     * - `elementAttribute`
+     * - `elementProperty`
+     * - `elementClass`
+     * - `elementStyle`
+     *
+     */
+    template: ComponentTemplate<T>;
+    /**
+     * Constants for the nodes in the component's view.
+     * Includes attribute arrays, local definition arrays etc.
+     */
+    consts?: TConstantsOrFactory;
+    /**
+     * An array of `ngContent[selector]` values that were found in the template.
+     */
+    ngContentSelectors?: string[];
+    /**
+     * A list of optional features to apply.
+     *
+     * See: {@link NgOnChangesFeature}, {@link ProvidersFeature}
+     */
+    features?: ComponentDefFeature[];
+    /**
+     * Defines template and style encapsulation options available for Component's {@link Component}.
+     */
+    encapsulation?: ViewEncapsulation;
+    /**
+     * Defines arbitrary developer-defined data to be stored on a renderer instance.
+     * This is useful for renderers that delegate to other renderers.
+     *
+     * see: animation
+     */
+    data?: {
+        [kind: string]: any;
+    };
+    /**
+     * A set of styles that the component needs to be present for component to render correctly.
+     */
+    styles?: string[];
+    /**
+     * The strategy that the default change detector uses to detect changes.
+     * When set, takes effect the next time change detection is triggered.
+     */
+    changeDetection?: ChangeDetectionStrategy;
+    /**
+     * Registry of directives, components, and pipes that may be found in this component's view.
+     *
+     * This property is either an array of types or a function that returns the array of types. This
+     * function may be necessary to support forward declarations.
+     */
+    dependencies?: TypeOrFactory<DependencyTypeList>;
+    /**
+     * The set of schemas that declare elements to be allowed in the component's template.
+     */
+    schemas?: SchemaMetadata[] | null;
+}
+
 /**
  * Base class for a factory that can create a component dynamically.
  * Instantiate a factory for a given type of component with `resolveComponentFactory()`.
@@ -2469,6 +2567,141 @@ declare interface DirectiveDefFeature {
     ngInherit?: true;
 }
 
+declare interface DirectiveDefinition<T> {
+    /**
+     * Directive type, needed to configure the injector.
+     */
+    type: Type<T>;
+    /** The selectors that will be used to match nodes to this directive. */
+    selectors?: ɵCssSelectorList;
+    /**
+     * A map of input names.
+     *
+     * The format is in: `{[actualPropertyName: string]:(string|[string, string])}`.
+     *
+     * Given:
+     * ```
+     * class MyComponent {
+     *   @Input()
+     *   publicInput1: string;
+     *
+     *   @Input('publicInput2')
+     *   declaredInput2: string;
+     * }
+     * ```
+     *
+     * is described as:
+     * ```
+     * {
+     *   publicInput1: 'publicInput1',
+     *   declaredInput2: ['declaredInput2', 'publicInput2'],
+     * }
+     * ```
+     *
+     * Which the minifier may translate to:
+     * ```
+     * {
+     *   minifiedPublicInput1: 'publicInput1',
+     *   minifiedDeclaredInput2: [ 'publicInput2', 'declaredInput2'],
+     * }
+     * ```
+     *
+     * This allows the render to re-construct the minified, public, and declared names
+     * of properties.
+     *
+     * NOTE:
+     *  - Because declared and public name are usually same we only generate the array
+     *    `['declared', 'public']` format when they differ.
+     *  - The reason why this API and `outputs` API is not the same is that `NgOnChanges` has
+     *    inconsistent behavior in that it uses declared names rather than minified or public. For
+     *    this reason `NgOnChanges` will be deprecated and removed in future version and this
+     *    API will be simplified to be consistent with `output`.
+     */
+    inputs?: {
+        [P in keyof T]?: string | [string, string];
+    };
+    /**
+     * A map of output names.
+     *
+     * The format is in: `{[actualPropertyName: string]:string}`.
+     *
+     * Which the minifier may translate to: `{[minifiedPropertyName: string]:string}`.
+     *
+     * This allows the render to re-construct the minified and non-minified names
+     * of properties.
+     */
+    outputs?: {
+        [P in keyof T]?: string;
+    };
+    /**
+     * A list of optional features to apply.
+     *
+     * See: {@link NgOnChangesFeature}, {@link ProvidersFeature}, {@link InheritDefinitionFeature}
+     */
+    features?: DirectiveDefFeature[];
+    /**
+     * Function executed by the parent template to allow child directive to apply host bindings.
+     */
+    hostBindings?: HostBindingsFunction<T>;
+    /**
+     * The number of bindings in this directive `hostBindings` (including pure fn bindings).
+     *
+     * Used to calculate the length of the component's LView array, so we
+     * can pre-fill the array and set the host binding start index.
+     */
+    hostVars?: number;
+    /**
+     * Assign static attribute values to a host element.
+     *
+     * This property will assign static attribute values as well as class and style
+     * values to a host element. Since attribute values can consist of different types of values,
+     * the `hostAttrs` array must include the values in the following format:
+     *
+     * attrs = [
+     *   // static attributes (like `title`, `name`, `id`...)
+     *   attr1, value1, attr2, value,
+     *
+     *   // a single namespace value (like `x:id`)
+     *   NAMESPACE_MARKER, namespaceUri1, name1, value1,
+     *
+     *   // another single namespace value (like `x:name`)
+     *   NAMESPACE_MARKER, namespaceUri2, name2, value2,
+     *
+     *   // a series of CSS classes that will be applied to the element (no spaces)
+     *   CLASSES_MARKER, class1, class2, class3,
+     *
+     *   // a series of CSS styles (property + value) that will be applied to the element
+     *   STYLES_MARKER, prop1, value1, prop2, value2
+     * ]
+     *
+     * All non-class and non-style attributes must be defined at the start of the list
+     * first before all class and style values are set. When there is a change in value
+     * type (like when classes and styles are introduced) a marker must be used to separate
+     * the entries. The marker values themselves are set via entries found in the
+     * [AttributeMarker] enum.
+     */
+    hostAttrs?: TAttributes;
+    /**
+     * Function to create instances of content queries associated with a given directive.
+     */
+    contentQueries?: ContentQueriesFunction<T>;
+    /**
+     * Additional set of instructions specific to view query processing. This could be seen as a
+     * set of instructions to be inserted into the template function.
+     */
+    viewQuery?: ViewQueriesFunction<T> | null;
+    /**
+     * Defines the name that can be used in the template to assign this directive to a variable.
+     *
+     * See: {@link Directive.exportAs}
+     */
+    exportAs?: string[];
+    /**
+     * Whether this directive/component is standalone.
+     */
+    standalone?: boolean;
+}
+
 declare type DirectiveDefList = (ɵDirectiveDef<any> | ɵComponentDef<any>)[];
 
 /**
@@ -5054,6 +5287,12 @@ export declare interface ModuleWithProviders<T> {
 
 declare const MOVED_VIEWS = 9;
 
+declare type Mutable<T extends {
+    [x: string]: any;
+}, K extends string> = {
+    [P in K]: T[P];
+};
+
 declare const NATIVE = 7;
 
 declare const NEXT = 4;
@@ -9427,9 +9666,6 @@ declare enum ViewEncapsulation_2 {
     ShadowDom = 3
 }
 
-declare interface viewEngine_ChangeDetectorRef_interface extends ChangeDetectorRef {
-}
-
 /**
  * Definition of what a view queries function should look like.
  */
@@ -10918,7 +11154,7 @@ export declare function ɵunwrapSafeValue(value: ɵSafeValue): string;
 
 export declare function ɵunwrapSafeValue<T>(value: T): T;
 
-export declare class ɵViewRef<T> implements EmbeddedViewRef<T>, InternalViewRef, viewEngine_ChangeDetectorRef_interface {
+export declare class ɵViewRef<T> implements EmbeddedViewRef<T>, InternalViewRef, ChangeDetectorRefInterface {
     /**
      * This represents the `LView` associated with the point where `ChangeDetectorRef` was
      * requested.
@@ -11832,7 +12068,7 @@ export declare function ɵɵCopyDefinitionFeature(definition: ɵDirectiveDef<any
  *
  * # Example
  * ```
- * class MyDirective {
+ * class MyComponent {
  *   // Generated by Angular Template Compiler
  *   // [Symbol] syntax will not be supported by TypeScript until v2.7
  *   static ɵcmp = defineComponent({
@@ -11842,230 +12078,7 @@ export declare function ɵɵCopyDefinitionFeature(definition: ɵDirectiveDef<any
  * ```
  * @codeGenApi
  */
-export declare function ɵɵdefineComponent<T>(componentDefinition: {
-    /**
-     * Directive type, needed to configure the injector.
-     */
-    type: Type<T>;
-    /** The selectors that will be used to match nodes to this component. */
-    selectors?: ɵCssSelectorList;
-    /**
-     * The number of nodes, local refs, and pipes in this component template.
-     *
-     * Used to calculate the length of this component's LView array, so we
-     * can pre-fill the array and set the binding start index.
-     */
-    decls: number;
-    /**
-     * The number of bindings in this component template (including pure fn bindings).
-     *
-     * Used to calculate the length of this component's LView array, so we
-     * can pre-fill the array and set the host binding start index.
-     */
-    vars: number;
-    /**
-     * A map of input names.
-     *
-     * The format is in: `{[actualPropertyName: string]:(string|[string, string])}`.
-     *
-     * Given:
-     * ```
-     * class MyComponent {
-     *   @Input()
-     *   publicInput1: string;
-     *
-     *   @Input('publicInput2')
-     *   declaredInput2: string;
-     * }
-     * ```
-     *
-     * is described as:
-     * ```
-     * {
-     *   publicInput1: 'publicInput1',
-     *   declaredInput2: ['publicInput2', 'declaredInput2'],
-     * }
-     * ```
-     *
-     * Which the minifier may translate to:
-     * ```
-     * {
-     *   minifiedPublicInput1: 'publicInput1',
-     *   minifiedDeclaredInput2: ['publicInput2', 'declaredInput2'],
-     * }
-     * ```
-     *
-     * This allows the render to re-construct the minified, public, and declared names
-     * of properties.
-     *
-     * NOTE:
-     *  - Because declared and public name are usually same we only generate the array
-     *    `['public', 'declared']` format when they differ.
-     *  - The reason why this API and `outputs` API is not the same is that `NgOnChanges` has
-     *    inconsistent behavior in that it uses declared names rather than minified or public. For
-     *    this reason `NgOnChanges` will be deprecated and removed in future version and this
-     *    API will be simplified to be consistent with `output`.
-     */
-    inputs?: {
-        [P in keyof T]?: string | [string, string];
-    };
-    /**
-     * A map of output names.
-     *
-     * The format is in: `{[actualPropertyName: string]:string}`.
-     *
-     * Which the minifier may translate to: `{[minifiedPropertyName: string]:string}`.
-     *
-     * This allows the render to re-construct the minified and non-minified names
-     * of properties.
-     */
-    outputs?: {
-        [P in keyof T]?: string;
-    };
-    /**
-     * Function executed by the parent template to allow child directive to apply host bindings.
-     */
-    hostBindings?: HostBindingsFunction<T>;
-    /**
-     * The number of bindings in this directive `hostBindings` (including pure fn bindings).
-     *
-     * Used to calculate the length of the component's LView array, so we
-     * can pre-fill the array and set the host binding start index.
-     */
-    hostVars?: number;
-    /**
-     * Assign static attribute values to a host element.
-     *
-     * This property will assign static attribute values as well as class and style
-     * values to a host element. Since attribute values can consist of different types of values, the
-     * `hostAttrs` array must include the values in the following format:
-     *
-     * attrs = [
-     *   // static attributes (like `title`, `name`, `id`...)
-     *   attr1, value1, attr2, value,
-     *
-     *   // a single namespace value (like `x:id`)
-     *   NAMESPACE_MARKER, namespaceUri1, name1, value1,
-     *
-     *   // another single namespace value (like `x:name`)
-     *   NAMESPACE_MARKER, namespaceUri2, name2, value2,
-     *
-     *   // a series of CSS classes that will be applied to the element (no spaces)
-     *   CLASSES_MARKER, class1, class2, class3,
-     *
-     *   // a series of CSS styles (property + value) that will be applied to the element
-     *   STYLES_MARKER, prop1, value1, prop2, value2
-     * ]
-     *
-     * All non-class and non-style attributes must be defined at the start of the list
-     * first before all class and style values are set. When there is a change in value
-     * type (like when classes and styles are introduced) a marker must be used to separate
-     * the entries. The marker values themselves are set via entries found in the
-     * [AttributeMarker] enum.
-     */
-    hostAttrs?: TAttributes;
-    /**
-     * Function to create instances of content queries associated with a given directive.
-     */
-    contentQueries?: ContentQueriesFunction<T>;
-    /**
-     * Defines the name that can be used in the template to assign this directive to a variable.
-     *
-     * See: {@link Directive.exportAs}
-     */
-    exportAs?: string[];
-    /**
-     * Template function use for rendering DOM.
-     *
-     * This function has following structure.
-     *
-     * ```
-     * function Template<T>(ctx:T, creationMode: boolean) {
-     *   if (creationMode) {
-     *     // Contains creation mode instructions.
-     *   }
-     *   // Contains binding update instructions
-     * }
-     * ```
-     *
-     * Common instructions are:
-     * Creation mode instructions:
-     *  - `elementStart`, `elementEnd`
-     *  - `text`
-     *  - `container`
-     *  - `listener`
-     *
-     * Binding update instructions:
-     * - `bind`
-     * - `elementAttribute`
-     * - `elementProperty`
-     * - `elementClass`
-     * - `elementStyle`
-     *
-     */
-    template: ComponentTemplate<T>;
-    /**
-     * Constants for the nodes in the component's view.
-     * Includes attribute arrays, local definition arrays etc.
-     */
-    consts?: TConstantsOrFactory;
-    /**
-     * An array of `ngContent[selector]` values that were found in the template.
-     */
-    ngContentSelectors?: string[];
-    /**
-     * Additional set of instructions specific to view query processing. This could be seen as a
-     * set of instruction to be inserted into the template function.
-     *
-     * Query-related instructions need to be pulled out to a specific function as a timing of
-     * execution is different as compared to all other instructions (after change detection hooks but
-     * before view hooks).
-     */
-    viewQuery?: ViewQueriesFunction<T> | null;
-    /**
-     * A list of optional features to apply.
-     *
-     * See: {@link NgOnChangesFeature}, {@link ProvidersFeature}
-     */
-    features?: ComponentDefFeature[];
-    /**
-     * Defines template and style encapsulation options available for Component's {@link Component}.
-     */
-    encapsulation?: ViewEncapsulation;
-    /**
-     * Defines arbitrary developer-defined data to be stored on a renderer instance.
-     * This is useful for renderers that delegate to other renderers.
-     *
-     * see: animation
-     */
-    data?: {
-        [kind: string]: any;
-    };
-    /**
-     * A set of styles that the component needs to be present for component to render correctly.
-     */
-    styles?: string[];
-    /**
-     * The strategy that the default change detector uses to detect changes.
-     * When set, takes effect the next time change detection is triggered.
-     */
-    changeDetection?: ChangeDetectionStrategy;
-    /**
-     * Registry of directives, components, and pipes that may be found in this component's view.
-     *
-     * This property is either an array of types or a function that returns the array of types. This
-     * function may be necessary to support forward declarations.
-     */
-    dependencies?: TypeOrFactory<DependencyTypeList>;
-    /**
-     * The set of schemas that declare elements to be allowed in the component's template.
-     */
-    schemas?: SchemaMetadata[] | null;
-    /**
-     * Whether this directive/component is standalone.
-     */
-    standalone?: boolean;
-}): unknown;
+export declare function ɵɵdefineComponent<T>(componentDefinition: ComponentDefinition<T>): Mutable<ɵComponentDef<any>, keyof ɵComponentDef<any>>;
 
 /**
  * Create a directive definition object.
@@ -12083,132 +12096,7 @@ export declare function ɵɵdefineComponent<T>(componentDefinition: {
  *
  * @codeGenApi
  */
-export declare const ɵɵdefineDirective: <T>(directiveDefinition: {
-    /**
-     * Directive type, needed to configure the injector.
-     */
-    type: Type<T>;
-    /** The selectors that will be used to match nodes to this directive. */
-    selectors?: ɵCssSelectorList | undefined;
-    /**
-     * A map of input names.
-     *
-     * The format is in: `{[actualPropertyName: string]:(string|[string, string])}`.
-     *
-     * Given:
-     * ```
-     * class MyComponent {
-     *   @Input()
-     *   publicInput1: string;
-     *
-     *   @Input('publicInput2')
-     *   declaredInput2: string;
-     * }
-     * ```
-     *
-     * is described as:
-     * ```
-     * {
-     *   publicInput1: 'publicInput1',
-     *   declaredInput2: ['declaredInput2', 'publicInput2'],
-     * }
-     * ```
-     *
-     * Which the minifier may translate to:
-     * ```
-     * {
-     *   minifiedPublicInput1: 'publicInput1',
-     *   minifiedDeclaredInput2: [ 'publicInput2', 'declaredInput2'],
-     * }
-     * ```
-     *
-     * This allows the render to re-construct the minified, public, and declared names
-     * of properties.
-     *
-     * NOTE:
-     *  - Because declared and public name are usually same we only generate the array
-     *    `['declared', 'public']` format when they differ.
-     *  - The reason why this API and `outputs` API is not the same is that `NgOnChanges` has
-     *    inconsistent behavior in that it uses declared names rather than minified or public. For
-     *    this reason `NgOnChanges` will be deprecated and removed in future version and this
-     *    API will be simplified to be consistent with `output`.
-     */
-    inputs?: { [P in keyof T]?: string | [string, string] | undefined; } | undefined;
-    /**
-     * A map of output names.
-     *
-     * The format is in: `{[actualPropertyName: string]:string}`.
-     *
-     * Which the minifier may translate to: `{[minifiedPropertyName: string]:string}`.
-     *
-     * This allows the render to re-construct the minified and non-minified names
-     * of properties.
-     */
-    outputs?: { [P_1 in keyof T]?: string | undefined; } | undefined;
-    /**
-     * A list of optional features to apply.
-     *
-     * See: {@link NgOnChangesFeature}, {@link ProvidersFeature}, {@link InheritDefinitionFeature}
-     */
-    features?: DirectiveDefFeature[] | undefined;
-    /**
-     * Function executed by the parent template to allow child directive to apply host bindings.
-     */
-    hostBindings?: HostBindingsFunction<T> | undefined;
-    /**
-     * The number of bindings in this directive `hostBindings` (including pure fn bindings).
-     *
-     * Used to calculate the length of the component's LView array, so we
-     * can pre-fill the array and set the host binding start index.
-     */
-    hostVars?: number | undefined;
-    /**
-     * Assign static attribute values to a host element.
-     *
-     * This property will assign static attribute values as well as class and style
-     * values to a host element. Since attribute values can consist of different types of values,
-     * the `hostAttrs` array must include the values in the following format:
-     *
-     * attrs = [
-     *   // static attributes (like `title`, `name`, `id`...)
-     *   attr1, value1, attr2, value,
-     *
-     *   // a single namespace value (like `x:id`)
-     *   NAMESPACE_MARKER, namespaceUri1, name1, value1,
-     *
-     *   // another single namespace value (like `x:name`)
-     *   NAMESPACE_MARKER, namespaceUri2, name2, value2,
-     *
-     *   // a series of CSS classes that will be applied to the element (no spaces)
-     *   CLASSES_MARKER, class1, class2, class3,
-     *
-     *   // a series of CSS styles (property + value) that will be applied to the element
-     *   STYLES_MARKER, prop1, value1, prop2, value2
-     * ]
-     *
-     * All non-class and non-style attributes must be defined at the start of the list
-     * first before all class and style values are set. When there is a change in value
-     * type (like when classes and styles are introduced) a marker must be used to separate
-     * the entries. The marker values themselves are set via entries found in the
-     * [AttributeMarker] enum.
-     */
-    hostAttrs?: TAttributes | undefined;
-    /**
-     * Function to create instances of content queries associated with a given directive.
-     */
-    contentQueries?: ContentQueriesFunction<T> | undefined;
-    /**
-     * Additional set of instructions specific to view query processing. This could be seen as a
-     * set of instructions to be inserted into the template function.
-     */
-    viewQuery?: ViewQueriesFunction<T> | null | undefined;
-    /**
-     * Defines the name that can be used in the template to assign this directive to a variable.
-     *
-     * See: {@link Directive.exportAs}
-     */
-    exportAs?: string[] | undefined;
-}) => never;
+export declare function ɵɵdefineDirective<T>(directiveDefinition: DirectiveDefinition<T>): Mutable<ɵDirectiveDef<any>, keyof ɵDirectiveDef<any>>;
 
 /**
  * Construct an injectable definition which defines how a token will be constructed by the DI

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/core",
-  "version": "15.2.2",
+  "version": "15.2.4",
   "description": "Angular - the core framework",
   "author": "angular",
   "license": "MIT",