@angular/core 17.3.0-next.1 → 17.3.0

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v17.3.0-next.1
+ * @license Angular v17.3.0
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -644,6 +644,9 @@ export declare class ApplicationRef {
     private _destroyListeners;
     private readonly internalErrorHandler;
     private readonly afterRenderEffectManager;
+    private externalTestViews;
+    private beforeRender;
+    private afterTick;
     /**
      * Indicates whether this instance was destroyed.
      */
@@ -757,7 +760,6 @@ export declare class ApplicationRef {
      */
     tick(): void;
     private detectChangesInAttachedViews;
-    private detectChangesInView;
     /**
      * Attaches a view so that it will be dirty checked.
      * The view will be automatically detached when it is destroyed.
@@ -1104,7 +1106,7 @@ declare interface ClassDebugInfo {
 
 /**
  * Configures the `Injector` to return an instance of `useClass` for a token.
- * @see ["Dependency Injection Guide"](guide/dependency-injection).
+ * @see [Dependency Injection Guide](guide/dependency-injection).
  *
  * @usageNotes
  *
@@ -1136,7 +1138,7 @@ export declare interface ClassProvider extends ClassSansProvider {
  * Configures the `Injector` to return a value by invoking a `useClass` function.
  * Base for `ClassProvider` decorator.
  *
- * @see ["Dependency Injection Guide"](guide/dependency-injection).
+ * @see [Dependency Injection Guide](guide/dependency-injection).
  *
  * @publicApi
  */
@@ -1817,7 +1819,7 @@ export declare function computed<T>(computation: () => T, options?: CreateComput
 /**
  * Configures the `Injector` to return an instance of a token.
  *
- * @see ["Dependency Injection Guide"](guide/dependency-injection).
+ * @see [Dependency Injection Guide](guide/dependency-injection).
  *
  * @usageNotes
  *
@@ -1844,7 +1846,7 @@ export declare interface ConstructorProvider extends ConstructorSansProvider {
 /**
  * Configures the `Injector` to return an instance of a token.
  *
- * @see ["Dependency Injection Guide"](guide/dependency-injection).
+ * @see [Dependency Injection Guide](guide/dependency-injection).
  *
  * @usageNotes
  *
@@ -2706,6 +2708,15 @@ declare interface DehydratedView {
      * nodes detected in this view at serialization time.
      */
     disconnectedNodes?: Set<number> | null;
+    /**
+     * A mapping from a view to the first child to begin claiming nodes.
+     *
+     * This mapping is generated by an i18n block, and is the source of
+     * truth for the nodes inside of it. Once a view has been hydrated,
+     * the node is removed from the map. The remaining entries indicate
+     * dehydrated nodes that need to be cleaned up.
+     */
+    i18nNodes?: Map<number, RNode>;
 }
 
 /**
@@ -3801,7 +3812,7 @@ export declare class ErrorHandler {
  * @see [Observables in Angular](guide/observables-in-angular)
  * @publicApi
  */
-export declare interface EventEmitter<T> extends Subject<T> {
+export declare interface EventEmitter<T> extends Subject<T>, OutputRef<T> {
     /**
      * Creates an instance of this class that can
      * deliver events synchronously or asynchronously.
@@ -3846,7 +3857,7 @@ export declare const EventEmitter: {
 /**
  * Configures the `Injector` to return a value of another `useExisting` token.
  *
- * @see ["Dependency Injection Guide"](guide/dependency-injection).
+ * @see [Dependency Injection Guide](guide/dependency-injection).
  *
  * @usageNotes
  *
@@ -3874,7 +3885,7 @@ export declare interface ExistingProvider extends ExistingSansProvider {
  * Configures the `Injector` to return a value of another `useExisting` token.
  *
  * @see {@link ExistingProvider}
- * @see ["Dependency Injection Guide"](guide/dependency-injection).
+ * @see [Dependency Injection Guide](guide/dependency-injection).
  *
  * @publicApi
  */
@@ -3902,7 +3913,7 @@ declare type FactoryFn<T> = {
 
 /**
  * Configures the `Injector` to return a value by invoking a `useFactory` function.
- * @see ["Dependency Injection Guide"](guide/dependency-injection).
+ * @see [Dependency Injection Guide](guide/dependency-injection).
  *
  * @usageNotes
  *
@@ -3934,7 +3945,7 @@ export declare interface FactoryProvider extends FactorySansProvider {
  * Configures the `Injector` to return a value by invoking a `useFactory` function.
  *
  * @see {@link FactoryProvider}
- * @see ["Dependency Injection Guide"](guide/dependency-injection).
+ * @see [Dependency Injection Guide](guide/dependency-injection).
  *
  * @publicApi
  */
@@ -4721,6 +4732,62 @@ declare interface I18nDebug {
     debug?: string[];
 }
 
+/**
+ * Represents a simple DOM element in a translation, such as `<div>...</div>`
+ */
+declare interface I18nElementNode {
+    /** The AST node kind */
+    kind: I18nNodeKind.ELEMENT;
+    /** The LView index */
+    index: number;
+    /** The child nodes */
+    children: Array<I18nNode>;
+}
+
+/**
+ * Represents an ICU in a translation.
+ */
+declare interface I18nICUNode {
+    /** The AST node kind */
+    kind: I18nNodeKind.ICU;
+    /** The LView index */
+    index: number;
+    /** The branching cases */
+    cases: Array<Array<I18nNode>>;
+    /** The LView index that stores the active case */
+    currentCaseLViewIndex: number;
+}
+
+declare type I18nNode = I18nTextNode | I18nElementNode | I18nICUNode | I18nPlaceholderNode;
+
+declare const enum I18nNodeKind {
+    TEXT = 0,
+    ELEMENT = 1,
+    PLACEHOLDER = 2,
+    ICU = 3
+}
+
+/**
+ * Represents special content that is embedded into the translation. This can
+ * either be a special built-in element, such as <ng-container> and <ng-content>,
+ * or it can be a sub-template, for example, from a structural directive.
+ */
+declare interface I18nPlaceholderNode {
+    /** The AST node kind */
+    kind: I18nNodeKind.PLACEHOLDER;
+    /** The LView index */
+    index: number;
+    /** The child nodes */
+    children: Array<I18nNode>;
+    /** The placeholder type */
+    type: I18nPlaceholderType;
+}
+
+declare const enum I18nPlaceholderType {
+    ELEMENT = 0,
+    SUBTEMPLATE = 1
+}
+
 /**
  * Stores a list of nodes which need to be removed.
  *
@@ -4732,6 +4799,16 @@ declare interface I18nRemoveOpCodes extends Array<number> {
     __brand__: 'I18nRemoveOpCodes';
 }
 
+/**
+ * Represents a block of text in a translation, such as `Hello, {{ name }}!`.
+ */
+declare interface I18nTextNode {
+    /** The AST node kind */
+    kind: I18nNodeKind.TEXT;
+    /** The LView index */
+    index: number;
+}
+
 /**
  * Stores DOM operations which need to be applied to update DOM render tree due to changes in
  * expressions.
@@ -5189,7 +5266,7 @@ export declare interface InjectDecorator {
      * <code-example path="core/di/ts/metadata_spec.ts" region="InjectWithoutDecorator">
      * </code-example>
      *
-     * @see ["Dependency Injection Guide"](guide/dependency-injection)
+     * @see [Dependency Injection Guide](guide/dependency-injection)
      *
      */
     (token: any): any;
@@ -6795,12 +6872,10 @@ export declare interface ModelOptions {
  *
  * @developerPreview
  */
-export declare interface ModelSignal<T> extends WritableSignal<T> {
+export declare interface ModelSignal<T> extends WritableSignal<T>, OutputRef<T> {
     [SIGNAL]: InputSignalNode<T, T>;
     [ɵINPUT_SIGNAL_BRAND_READ_TYPE]: T;
     [ɵINPUT_SIGNAL_BRAND_WRITE_TYPE]: T;
-    /** @deprecated Do not use, will be removed. */
-    subscribe(callback: (value: T) => void): () => void;
 }
 
 /**
@@ -7401,6 +7476,12 @@ declare type NodeOutputBindings = Record<string, (number | string)[]>;
 
 declare const NODES = "n";
 
+
+declare const enum NotificationType {
+    RefreshViews = 0,
+    AfterRenderHooks = 1
+}
+
 declare const NUM_ROOT_NODES = "r";
 
 /**
@@ -7541,7 +7622,7 @@ export declare interface OptionalDecorator {
      * <code-example path="core/di/ts/metadata_spec.ts" region="Optional">
      * </code-example>
      *
-     * @see ["Dependency Injection Guide"](guide/dependency-injection).
+     * @see [Dependency Injection Guide](guide/dependency-injection).
      */
     (): any;
     new (): Optional;
@@ -7565,6 +7646,29 @@ export declare interface Output {
  */
 export declare const Output: OutputDecorator;
 
+/**
+ * The `output` function allows declaration of outputs in directives and
+ * components.
+ *
+ * Initializes an output that can emit values to consumers of your
+ * directive/component.
+ *
+ * @usageNotes
+ * Initialize an output in your directive by declaring a
+ * class field and initializing it with the `output()` function.
+ *
+ * ```ts
+ * @Directive({..})
+ * export class MyDir {
+ *   nameChange = output<string>();     // OutputEmitterRef<string>
+ *   onClick = output();                // OutputEmitterRef<void>
+ * }
+ * ```
+ *
+ * @developerPreview
+ */
+export declare function output<T = void>(opts?: OutputOptions): OutputEmitterRef<T>;
+
 /**
  * Type of the Output decorator / constructor function.
  *
@@ -7591,6 +7695,68 @@ export declare interface OutputDecorator {
     new (alias?: string): any;
 }
 
+/**
+ * An `OutputEmitterRef` is created by the `output()` function and can be
+ * used to emit values to consumers of your directive or component.
+ *
+ * Consumers of your directive/component can bind to the output and
+ * subscribe to changes via the bound event syntax. For example:
+ *
+ * ```html
+ * <my-comp (valueChange)="processNewValue($event)" />
+ * ```
+ *
+ * @developerPreview
+ */
+export declare class OutputEmitterRef<T> implements OutputRef<T> {
+    private destroyed;
+    private listeners;
+    private errorHandler;
+    constructor();
+    subscribe(callback: (value: T) => void): OutputRefSubscription;
+    /** Emits a new value to the output. */
+    emit(value: T): void;
+}
+
+/**
+ * Options for declaring an output.
+ *
+ * @developerPreview
+ */
+export declare interface OutputOptions {
+    alias?: string;
+}
+
+/**
+ * A reference to an Angular output.
+ *
+ * @developerPreview
+ */
+export declare interface OutputRef<T> {
+    /**
+     * Registers a callback that is invoked whenever the output
+     * emits a new value of type `T`.
+     *
+     * Angular will automatically clean up the subscription when
+     * the directive/component of the output is destroyed.
+     */
+    subscribe(callback: (value: T) => void): OutputRefSubscription;
+}
+
+
+/**
+ * Function that can be used to manually clean up a
+ * programmatic {@link OutputRef#subscribe} subscription.
+ *
+ * Note: Angular will automatically clean up subscriptions
+ * when the directive/component of the output is destroyed.
+ *
+ * @developerPreview
+ */
+export declare interface OutputRefSubscription {
+    unsubscribe(): void;
+}
+
 /**
  * A [DI token](guide/glossary#di-token "DI token definition") that indicates the root directory of
  * the application
@@ -7863,7 +8029,7 @@ declare type ProjectionSlots = (ɵCssSelectorList | '*')[];
 
 /**
  * Describes how the `Injector` should be configured.
- * @see ["Dependency Injection Guide"](guide/dependency-injection).
+ * @see [Dependency Injection Guide](guide/dependency-injection).
  *
  * @see {@link StaticProvider}
  *
@@ -9088,7 +9254,7 @@ export declare type StateKey<T> = string & {
 
 /**
  * Configures the `Injector` to return an instance of `useClass` for a token.
- * @see ["Dependency Injection Guide"](guide/dependency-injection).
+ * @see [Dependency Injection Guide](guide/dependency-injection).
  *
  * @usageNotes
  *
@@ -9140,7 +9306,7 @@ export declare interface StaticClassSansProvider {
  * A static provider provides tokens to an injector for various types of dependencies.
  *
  * @see {@link Injector.create()}
- * @see ["Dependency Injection Guide"](guide/dependency-injection-providers).
+ * @see [Dependency Injection Guide](guide/dependency-injection-providers).
  *
  * @publicApi
  */
@@ -9492,6 +9658,11 @@ declare interface TI18n {
      * DOM are required.
      */
     update: I18nUpdateOpCodes;
+    /**
+     * An AST representing the translated message. This is used for hydration (and serialization),
+     * while the Update and Create OpCodes are used at runtime.
+     */
+    ast: Array<I18nNode>;
 }
 
 declare interface TIcu {
@@ -10837,7 +11008,7 @@ export declare type ValueEqualityFn<T> = (a: T, b: T) => boolean;
 
 /**
  * Configures the `Injector` to return a value for a token.
- * @see ["Dependency Injection Guide"](guide/dependency-injection).
+ * @see [Dependency Injection Guide](guide/dependency-injection).
  *
  * @usageNotes
  *
@@ -11410,14 +11581,11 @@ declare interface ViewRefTracker {
     detachView(viewRef: ViewRef): void;
 }
 
-/** Symbol used distinguish `WritableSignal` from other non-writable signals and functions. */
-declare const WRITABLE_SIGNAL: unique symbol;
-
 /**
  * A `Signal` with a value that can be mutated via a setter interface.
  */
 export declare interface WritableSignal<T> extends Signal<T> {
-    [WRITABLE_SIGNAL]: T;
+    [ɵWRITABLE_SIGNAL]: T;
     /**
      * Directly set the signal to a new value, and notify any dependents.
      */
@@ -11690,12 +11858,11 @@ export declare const enum ɵBypassType {
     Style = "Style"
 }
 
-
 /**
  * Injectable that is notified when an `LView` is made aware of changes to application state.
  */
 export declare abstract class ɵChangeDetectionScheduler {
-    abstract notify(): void;
+    abstract notify(source?: NotificationType): void;
 }
 
 export declare function ɵclearResolutionOfComponentResourcesQueue(): Map<Type<any>, Component>;
@@ -12014,6 +12181,8 @@ export declare enum ɵDeferBlockState {
 /** The deps tracker to be used in the current Angular app in dev mode. */
 export declare const ɵdepsTracker: DepsTracker;
 
+export declare function ɵdetectChangesInViewIfRequired(lView: LView, isFirstPass: boolean, notifyErrorHandler: boolean): void;
+
 
 export declare function ɵdevModeEqual(a: any, b: any): boolean;
 
@@ -12338,6 +12507,9 @@ export declare function ɵgetLocaleCurrencyCode(locale: string): string | null;
  */
 export declare function ɵgetLocalePluralCase(locale: string): (value: number) => number;
 
+/** Gets the owning `DestroyRef` for the given output. */
+export declare function ɵgetOutputDestroyRef(ref: OutputRef<unknown>): DestroyRef | undefined;
+
 export declare function ɵgetSanitizationBypassType(value: any): ɵBypassType | null;
 
 /**
@@ -12739,56 +12911,6 @@ export declare function ɵnoSideEffects<T>(fn: () => T): T;
 
 export declare const ɵNOT_FOUND_CHECK_ONLY_ELEMENT_INJECTOR: {};
 
-/**
- * The `outputs` function allows declaration of outputs in directives and
- * components.
- *
- * Initializes an output that can emit values to consumers of your
- * directive/component.
- *
- * @usageNotes
- * Initialize an output in your directive by declaring a
- * class field and initializing it with the `output()` function.
- *
- * ```ts
- * @Directive({..})
- * export class MyDir {
- *   nameChange = output<string>();     // OutputEmitter<string>
- *   onClick = output();                // OutputEmitter<void>
- * }
- * ```
- *
- * @developerPreview
- */
-export declare function ɵoutput<T = void>(opts?: ɵOutputOptions): ɵOutputEmitter<T>;
-
-
-/**
- * An `OutputEmitter` is created by the `output()` function and can be
- * used to emit values to consumers of your directive or component.
- *
- * Consumers of your directive/component can bind to the output and
- * subscribe to changes via the bound event syntax. For example:
- *
- * ```html
- * <my-comp (valueChange)="processNewValue($event)" />
- * ```
- *
- * @developerPreview
- */
-export declare interface ɵOutputEmitter<T> {
-    emit(value: T): void;
-}
-
-/**
- * Options for declaring an output.
- *
- * @developerPreview
- */
-export declare interface ɵOutputOptions {
-    alias?: string;
-}
-
 /**
  * Patch the definition of a component with directives and pipes from the compilation scope of
  * a given module.
@@ -13235,6 +13357,7 @@ export declare const enum ɵRuntimeErrorCode {
     REQUIRED_INPUT_NO_VALUE = -950,
     REQUIRED_QUERY_NO_VALUE = -951,
     REQUIRED_MODEL_NO_VALUE = -952,
+    OUTPUT_REF_DESTROYED = 953,
     RUNTIME_DEPS_INVALID_IMPORTED_TYPE = 1000,
     RUNTIME_DEPS_ORPHAN_COMPONENT = 1001
 }
@@ -13433,7 +13556,7 @@ export declare type ɵUnwrapDirectiveSignalInputs<Dir, Fields extends keyof Dir>
 };
 
 /** Retrieves the `WriteT` of an `InputSignal` and `InputSignalWithTransform`. */
-declare type ɵUnwrapInputSignalWriteType<Field> = Field extends InputSignalWithTransform<unknown, infer WriteT> ? WriteT : never;
+declare type ɵUnwrapInputSignalWriteType<Field> = Field extends InputSignalWithTransform<any, infer WriteT> ? WriteT : never;
 
 export declare function ɵunwrapSafeValue(value: ɵSafeValue): string;
 
@@ -13444,7 +13567,7 @@ export declare function ɵunwrapSafeValue<T>(value: T): T;
  * @codeGenApi
  */
 export declare function ɵunwrapWritableSignal<T>(value: T | {
-    [WRITABLE_SIGNAL]: T;
+    [ɵWRITABLE_SIGNAL]: T;
 }): T;
 
 /**
@@ -13693,6 +13816,12 @@ export declare function ɵwhenStable(applicationRef: ApplicationRef): Promise<vo
  */
 export declare function ɵwithDomHydration(): EnvironmentProviders;
 
+/**
+ * Returns a set of providers required to setup support for i18n hydration.
+ * Requires hydration to be enabled separately.
+ */
+export declare function ɵwithI18nHydration(): EnvironmentProviders;
+
 /**
  * Returns a writable type version of type.
  *
@@ -13722,6 +13851,9 @@ export declare type ɵWritable<T> = {
     -readonly [K in keyof T]: T[K];
 };
 
+/** Symbol used distinguish `WritableSignal` from other non-writable signals and functions. */
+declare const ɵWRITABLE_SIGNAL: unique symbol;
+
 /**
  * URL for the XSS security documentation.
  */

package/package.json

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

package/primitives/signals/index.d.ts

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

package/rxjs-interop/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v17.3.0-next.1
+ * @license Angular v17.3.0
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -9,9 +9,47 @@ import { DestroyRef } from '@angular/core';
 import { Injector } from '@angular/core';
 import { MonoTypeOperatorFunction } from 'rxjs';
 import { Observable } from 'rxjs';
+import { OutputOptions } from '@angular/core';
+import { OutputRef } from '@angular/core';
 import { Signal } from '@angular/core';
 import { Subscribable } from 'rxjs';
 
+/**
+ * Declares an Angular output that is using an RxJS observable as a source
+ * for events dispatched to parent subscribers.
+ *
+ * The behavior for an observable as source is defined as followed:
+ *    1. New values are forwarded to the Angular output (next notifications).
+ *    2. Errors notifications are not handled by Angular. You need to handle these manually.
+ *       For example by using `catchError`.
+ *    3. Completion notifications stop the output from emitting new values.
+ *
+ * @usageNotes
+ * Initialize an output in your directive by declaring a
+ * class field and initializing it with the `outputFromObservable()` function.
+ *
+ * ```ts
+ * @Directive({..})
+ * export class MyDir {
+ *   nameChange$ = <some-observable>;
+ *   nameChange = outputFromObservable(this.nameChange$);
+ * }
+ * ```
+ *
+ * @developerPreview
+ */
+export declare function outputFromObservable<T>(observable: Observable<T>, opts?: OutputOptions): OutputRef<T>;
+
+/**
+ * Converts an Angular output declared via `output()` or `outputFromObservable()`
+ * to an observable.
+ *
+ * You can subscribe to the output via `Observable.subscribe` then.
+ *
+ * @developerPreview
+ */
+export declare function outputToObservable<T>(ref: OutputRef<T>): Observable<T>;
+
 /**
  * Operator which completes the Observable when the calling context (component, directive, service,
  * etc) is destroyed.