@angular/core 14.1.0-next.3 → 14.1.0-next.4

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v14.1.0-next.3
+ * @license Angular v14.1.0-next.4
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -608,8 +608,10 @@ export declare interface AttributeDecorator {
 
 /**
  * Provides additional options to the bootstraping process.
+ *
+ * @publicApi
  */
-declare interface BootstrapOptions {
+export declare interface BootstrapOptions {
     /**
      * Optionally specify which `NgZone` should be used.
      *
@@ -1320,6 +1322,15 @@ declare type ComponentInstance = {};
  * @publicApi
  */
 export declare abstract class ComponentRef<C> {
+    /**
+     * Updates a specified input name to a new value. Using this method will properly mark for check
+     * component using the `OnPush` change detection strategy. It will also assure that the
+     * `OnChanges` lifecycle hook runs when a dynamically created component is change-detected.
+     *
+     * @param name The name of an input.
+     * @param value The new value of an input.
+     */
+    abstract setInput(name: string, value: unknown): void;
     /**
      * The host or anchor [element](guide/glossary#element) for this component instance.
      */
@@ -1452,6 +1463,8 @@ export declare interface ContentChildDecorator {
      * **Metadata Properties**:
      *
      * * **selector** - The directive type or the name used for querying.
+     * * **descendants** - If `true` (default) include all descendants of the element. If `false` then
+     * only query direct children of the element.
      * * **read** - Used to read a different token from the queried element.
      * * **static** - True to resolve query results before change detection runs,
      * false to resolve after change detection. Defaults to false.
@@ -1485,10 +1498,12 @@ export declare interface ContentChildDecorator {
      * @Annotation
      */
     (selector: ProviderToken<unknown> | Function | string, opts?: {
+        descendants?: boolean;
         read?: any;
         static?: boolean;
     }): any;
     new (selector: ProviderToken<unknown> | Function | string, opts?: {
+        descendants?: boolean;
         read?: any;
         static?: boolean;
     }): ContentChild;
@@ -1599,49 +1614,6 @@ declare type ContentQueriesFunction<T> = <U extends T>(rf: ɵRenderFlags, ctx: U
 
 declare const CONTEXT = 8;
 
-/** Options that control how the component should be bootstrapped. */
-declare interface CreateComponentOptions {
-    /** Which renderer factory to use. */
-    rendererFactory?: RendererFactory3;
-    /** A custom sanitizer instance */
-    sanitizer?: Sanitizer;
-    /** A custom animation player handler */
-    playerHandler?: ɵPlayerHandler;
-    /**
-     * Host element on which the component will be bootstrapped. If not specified,
-     * the component definition's `tag` is used to query the existing DOM for the
-     * element to bootstrap.
-     */
-    host?: RElement | string;
-    /** Module injector for the component. If unspecified, the injector will be NULL_INJECTOR. */
-    injector?: Injector;
-    /**
-     * List of features to be applied to the created component. Features are simply
-     * functions that decorate a component with a certain behavior.
-     *
-     * Typically, the features in this list are features that cannot be added to the
-     * other features list in the component definition because they rely on other factors.
-     *
-     * Example: `LifecycleHooksFeature` is a function that adds lifecycle hook capabilities
-     * to root components in a tree-shakable way. It cannot be added to the component
-     * features list because there's no way of knowing when the component will be used as
-     * a root component.
-     */
-    hostFeatures?: HostFeature[];
-    /**
-     * A function which is used to schedule change detection work in the future.
-     *
-     * When marking components as dirty, it is necessary to schedule the work of
-     * change detection in the future. This is done to coalesce multiple
-     * {@link markDirty} calls into a single changed detection processing.
-     *
-     * The default value of the scheduler is the `requestAnimationFrame` function.
-     *
-     * It is also useful to override this function for testing purposes.
-     */
-    scheduler?: (work: () => void) => void;
-}
-
 /**
  * Create a new environment injector.
  *
@@ -2639,6 +2611,17 @@ export declare abstract class EnvironmentInjector implements Injector {
      * @suppress {duplicate}
      */
     abstract get(token: any, notFoundValue?: any): any;
+    /**
+     * Runs the given function in the context of this `EnvironmentInjector`.
+     *
+     * Within the function's stack frame, `inject` can be used to inject dependencies from this
+     * injector. Note that `inject` is only usable synchronously, and cannot be used in any
+     * asynchronous callbacks or after any `await` points.
+     *
+     * @param fn the closure to be run in the context of this injector
+     * @returns the return value of the function, if any
+     */
+    abstract runInContext<ReturnT>(fn: () => ReturnT): ReturnT;
     abstract destroy(): void;
 }
 
@@ -2944,6 +2927,14 @@ export declare interface GetTestability {
     findTestabilityInTree(registry: TestabilityRegistry, elem: any, findInAncestors: boolean): Testability | null;
 }
 
+/**
+ * The goal here is to make sure that the browser DOM API is the Renderer.
+ * We do this by defining a subset of DOM API to be the renderer and then
+ * use that at runtime for rendering.
+ *
+ * At runtime we can then use the DOM api directly, in server or web-worker
+ * it will be easy to implement such API.
+ */
 declare type GlobalTargetName = 'document' | 'window' | 'body';
 
 declare type GlobalTargetResolver = (element: any) => EventTarget;
@@ -3148,9 +3139,6 @@ export declare interface HostDecorator {
     new (): Host;
 }
 
-/** See CreateComponentOptions.hostFeatures */
-declare type HostFeature = (<T>(component: T, componentDef: ɵComponentDef<T>) => void);
-
 /**
  * Type of the HostListener metadata.
  *
@@ -3614,9 +3602,38 @@ export declare function inject<T>(token: ProviderToken<T>): T;
  * @throws if called outside of a supported context.
  *
  * @publicApi
+ * @deprecated prefer an options object instead of `InjectFlags`
  */
 export declare function inject<T>(token: ProviderToken<T>, flags?: InjectFlags): T | null;
 
+/**
+ * @param token A token that represents a dependency that should be injected.
+ * @param options Control how injection is executed. Options correspond to injection strategies
+ *     that can be specified with parameter decorators `@Host`, `@Self`, `@SkipSelf`, and
+ *     `@Optional`.
+ * @returns the injected value if operation is successful.
+ * @throws if called outside of a supported context, or if the token is not found.
+ *
+ * @publicApi
+ */
+export declare function inject<T>(token: ProviderToken<T>, options: InjectOptions & {
+    optional?: false;
+}): T;
+
+/**
+ * @param token A token that represents a dependency that should be injected.
+ * @param options Control how injection is executed. Options correspond to injection strategies
+ *     that can be specified with parameter decorators `@Host`, `@Self`, `@SkipSelf`, and
+ *     `@Optional`.
+ * @returns the injected value if operation is successful,  `null` if the token is not
+ *     found and optional injection has been requested.
+ * @throws if called outside of a supported context, or if the token is not found and optional
+ *     injection was not requested.
+ *
+ * @publicApi
+ */
+export declare function inject<T>(token: ProviderToken<T>, options: InjectOptions): T | null;
+
 /**
  * Type of the Injectable metadata.
  *
@@ -3740,6 +3757,7 @@ export declare interface InjectDecorator {
  * Injection flags for DI.
  *
  * @publicApi
+ * @deprecated use an options object for `inject` instead.
  */
 export declare enum InjectFlags {
     /** Check self and check parent injector if needed */
@@ -3814,6 +3832,32 @@ export declare class InjectionToken<T> {
     toString(): string;
 }
 
+/**
+ * Type of the options argument to `inject`.
+ *
+ * @publicApi
+ */
+export declare interface InjectOptions {
+    /**
+     * Use optional injection, and return `null` if the requested token is not found.
+     */
+    optional?: boolean;
+    /**
+     * Start injection at the parent of the current injector.
+     */
+    skipSelf?: boolean;
+    /**
+     * Only query the current injector for the token, and don't fall back to the parent injector if
+     * it's not found.
+     */
+    self?: boolean;
+    /**
+     * Stop injection at the host component's injector. Only relevant when injecting from an element
+     * injector, and a no-op for environment injectors.
+     */
+    host?: boolean;
+}
+
 /**
  * An InjectionToken that gets the current `Injector` for `createInjector()`-style injectors.
  *
@@ -4588,9 +4632,9 @@ declare interface LView<T = unknown> extends Array<any> {
     /** An optional Module Injector to be used as fall back after Element Injectors are consulted. */
     readonly [INJECTOR_2]: Injector | null;
     /** Factory to be used for creating Renderer. */
-    [RENDERER_FACTORY]: RendererFactory3;
+    [RENDERER_FACTORY]: RendererFactory;
     /** Renderer to be used for this view. */
-    [RENDERER]: Renderer3;
+    [RENDERER]: Renderer;
     /** An optional custom sanitizer. */
     [SANITIZER]: Sanitizer | null;
     /**
@@ -5435,21 +5479,6 @@ declare interface NodeInjectorDebug {
     parentInjectorIndex: number;
 }
 
-/**
- * Object Oriented style of API needed to create elements and text nodes.
- *
- * This is the native browser API style, e.g. operations are methods on individual objects
- * like HTMLElement. With this style, no additional code is needed as a facade
- * (reducing payload size).
- * */
-declare interface ObjectOrientedRenderer3 {
-    createComment(data: string): RComment;
-    createElement(tagName: string): RElement;
-    createElementNS(namespace: string, tagName: string): RElement;
-    createTextNode(data: string): RText;
-    querySelector(selectors: string): RElement | null;
-}
-
 /**
  * @description
  * A lifecycle hook that is called when any data-bound property of a directive changes.
@@ -5874,41 +5903,6 @@ declare const enum PreOrderHookFlags {
     NumberOfInitHooksCalledMask = 4294901760
 }
 
-/**
- * Procedural style of API needed to create elements and text nodes.
- *
- * In non-native browser environments (e.g. platforms such as web-workers), this is the
- * facade that enables element manipulation. This also facilitates backwards compatibility
- * with Renderer2.
- */
-declare interface ProceduralRenderer3 {
-    destroy(): void;
-    createComment(value: string): RComment;
-    createElement(name: string, namespace?: string | null): RElement;
-    createText(value: string): RText;
-    /**
-     * This property is allowed to be null / undefined,
-     * in which case the view engine won't call it.
-     * This is used as a performance optimization for production mode.
-     */
-    destroyNode?: ((node: RNode) => void) | null;
-    appendChild(parent: RElement, newChild: RNode): void;
-    insertBefore(parent: RNode, newChild: RNode, refChild: RNode | null, isMove?: boolean): void;
-    removeChild(parent: RElement, oldChild: RNode, isHostElement?: boolean): void;
-    selectRootElement(selectorOrNode: string | any, preserveContent?: boolean): RElement;
-    parentNode(node: RNode): RElement | null;
-    nextSibling(node: RNode): RNode | null;
-    setAttribute(el: RElement, name: string, value: string | TrustedHTML | TrustedScript | TrustedScriptURL, namespace?: string | null): void;
-    removeAttribute(el: RElement, name: string, namespace?: string | null): void;
-    addClass(el: RElement, name: string): void;
-    removeClass(el: RElement, name: string): void;
-    setStyle(el: RElement, style: string, value: any, flags?: RendererStyleFlags2 | RendererStyleFlags3): void;
-    removeStyle(el: RElement, style: string, flags?: RendererStyleFlags2 | RendererStyleFlags3): void;
-    setProperty(el: RElement, name: string, value: any): void;
-    setValue(node: RText | RComment, value: string): void;
-    listen(target: GlobalTargetName | RNode, eventName: string, callback: (event: any) => boolean | void): () => void;
-}
-
 /**
  * Describes a function that is used to process provider lists (such as provider
  * overrides).
@@ -6307,6 +6301,7 @@ declare class R3Injector extends EnvironmentInjector {
      */
     destroy(): void;
     onDestroy(callback: () => void): void;
+    runInContext<ReturnT>(fn: () => ReturnT): ReturnT;
     get<T>(token: ProviderToken<T>, notFoundValue?: any, flags?: InjectFlags): T;
     toString(): string;
     private assertNotDestroyed;
@@ -6637,6 +6632,40 @@ declare interface RElement extends RNode {
 
 declare const RENDERER = 11;
 
+/**
+ * Procedural style of API needed to create elements and text nodes.
+ *
+ * In non-native browser environments (e.g. platforms such as web-workers), this is the
+ * facade that enables element manipulation. In practice, this is implemented by `Renderer2`.
+ */
+declare interface Renderer {
+    destroy(): void;
+    createComment(value: string): RComment;
+    createElement(name: string, namespace?: string | null): RElement;
+    createText(value: string): RText;
+    /**
+     * This property is allowed to be null / undefined,
+     * in which case the view engine won't call it.
+     * This is used as a performance optimization for production mode.
+     */
+    destroyNode?: ((node: RNode) => void) | null;
+    appendChild(parent: RElement, newChild: RNode): void;
+    insertBefore(parent: RNode, newChild: RNode, refChild: RNode | null, isMove?: boolean): void;
+    removeChild(parent: RElement, oldChild: RNode, isHostElement?: boolean): void;
+    selectRootElement(selectorOrNode: string | any, preserveContent?: boolean): RElement;
+    parentNode(node: RNode): RElement | null;
+    nextSibling(node: RNode): RNode | null;
+    setAttribute(el: RElement, name: string, value: string | TrustedHTML | TrustedScript | TrustedScriptURL, namespace?: string | null): void;
+    removeAttribute(el: RElement, name: string, namespace?: string | null): void;
+    addClass(el: RElement, name: string): void;
+    removeClass(el: RElement, name: string): void;
+    setStyle(el: RElement, style: string, value: any, flags?: RendererStyleFlags2): void;
+    removeStyle(el: RElement, style: string, flags?: RendererStyleFlags2): void;
+    setProperty(el: RElement, name: string, value: any): void;
+    setValue(node: RText | RComment, value: string): void;
+    listen(target: GlobalTargetName | RNode, eventName: string, callback: (event: any) => boolean | void): () => void;
+}
+
 /**
  * Extend this base class to implement custom rendering. By default, Angular
  * renders a template into DOM. You can use custom rendering to intercept
@@ -6813,10 +6842,14 @@ export declare abstract class Renderer2 {
     abstract listen(target: 'window' | 'document' | 'body' | any, eventName: string, callback: (event: any) => boolean | void): () => void;
 }
 
-declare type Renderer3 = ObjectOrientedRenderer3 | ProceduralRenderer3;
-
 declare const RENDERER_FACTORY = 10;
 
+declare interface RendererFactory {
+    createRenderer(hostElement: RElement | null, rendererType: RendererType2 | null): Renderer;
+    begin?(): void;
+    end?(): void;
+}
+
 /**
  * Creates and initializes a custom renderer that implements the `Renderer2` base class.
  *
@@ -6845,12 +6878,6 @@ export declare abstract class RendererFactory2 {
     abstract whenRenderingDone?(): Promise<any>;
 }
 
-declare interface RendererFactory3 {
-    createRenderer(hostElement: RElement | null, rendererType: RendererType2 | null): Renderer3;
-    begin?(): void;
-    end?(): void;
-}
-
 /**
  * Flags for renderer-specific style modifiers.
  * @publicApi
@@ -6866,11 +6893,6 @@ export declare enum RendererStyleFlags2 {
     DashCase = 2
 }
 
-declare enum RendererStyleFlags3 {
-    Important = 1,
-    DashCase = 2
-}
-
 /**
  * Used by `RendererFactory2` to associate custom rendering data and styles
  * with a rendering implementation.
@@ -7060,6 +7082,7 @@ declare const enum RuntimeErrorCode {
     PLATFORM_ALREADY_DESTROYED = 404,
     ASYNC_INITIALIZERS_STILL_RUNNING = 405,
     APPLICATION_REF_ALREADY_DESTROYED = 406,
+    RENDERER_NOT_FOUND = 407,
     INVALID_I18N_STRUCTURE = 700,
     MISSING_LOCALE_DATA = 701,
     IMPORT_PROVIDERS_FROM_STANDALONE = 800,
@@ -10678,6 +10701,7 @@ export declare class ɵRender3ComponentRef<T> extends ComponentRef<T> {
     changeDetectorRef: ChangeDetectorRef;
     componentType: Type<T>;
     constructor(componentType: Type<T>, instance: T, location: ElementRef, _rootLView: LView, _tNode: TElementNode | TContainerNode | TElementContainerNode);
+    setInput(name: string, value: unknown): void;
     get injector(): Injector;
     destroy(): void;
     onDestroy(callback: () => void): void;
@@ -10693,25 +10717,11 @@ export declare class ɵRender3NgModuleRef<T> extends NgModuleRef<T> implements I
     readonly componentFactoryResolver: ComponentFactoryResolver_2;
     constructor(ngModuleType: Type<T>, _parent: Injector | null);
     get(token: any, notFoundValue?: any, injectFlags?: InjectFlags): any;
+    runInContext<ReturnT>(fn: () => ReturnT): ReturnT;
     destroy(): void;
     onDestroy(callback: () => void): void;
 }
 
-/**
- * Bootstraps a Component into an existing host element and returns an instance
- * of the component.
- *
- * Use this function to bootstrap a component into the DOM tree. Each invocation
- * of this function will create a separate tree of components, injectors and
- * change detection cycles and lifetimes. To dynamically insert a new component
- * into an existing tree such that it shares the same injection, change detection
- * and object lifetime, use {@link ViewContainer#createComponent}.
- *
- * @param componentType Component to bootstrap
- * @param options Optional parameters which control bootstrapping
- */
-export declare function ɵrenderComponent<T>(componentType: ɵComponentType<T> | Type<T>, opts?: CreateComponentOptions): T;
-
 /**
  * Flags passed into template functions to determine which blocks (i.e. creation, update)
  * should be executed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/core",
-  "version": "14.1.0-next.3",
+  "version": "14.1.0-next.4",
   "description": "Angular - the core framework",
   "author": "angular",
   "license": "MIT",

package/testing/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v14.1.0-next.3
+ * @license Angular v14.1.0-next.4
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */