@angular/core 17.3.0-next.0 → 17.3.0-rc.0

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v17.3.0-next.0
+ * @license Angular v17.3.0-rc.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
  *
@@ -3801,7 +3803,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 +3848,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 +3876,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 +3904,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 +3936,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
  */
@@ -4314,6 +4316,33 @@ export declare interface Host {
  */
 export declare const Host: HostDecorator;
 
+/**
+ * Creates a token that can be used to inject static attributes of the host node.
+ *
+ * @usageNotes
+ * ### Injecting an attribute that is known to exist
+ * ```typescript
+ * @Directive()
+ * class MyDir {
+ *   attr: string = inject(new HostAttributeToken('some-attr'));
+ * }
+ * ```
+ *
+ * ### Optionally injecting an attribute
+ * ```typescript
+ * @Directive()
+ * class MyDir {
+ *   attr: string | null = inject(new HostAttributeToken('some-attr'), {optional: true});
+ * }
+ * ```
+ * @publicApi
+ */
+export declare class HostAttributeToken {
+    private attributeName;
+    constructor(attributeName: string);
+    toString(): string;
+}
+
 /**
  * Type of the HostBinding metadata.
  *
@@ -5018,6 +5047,37 @@ export declare function inject<T>(token: ProviderToken<T>, options: InjectOption
  */
 export declare function inject<T>(token: ProviderToken<T>, options: InjectOptions): T | null;
 
+/**
+ * @param token A token that represents a static attribute on the host node that should be injected.
+ * @returns Value of the attribute if it exists.
+ * @throws If called outside of a supported context or the attribute does not exist.
+ *
+ * @publicApi
+ */
+export declare function inject(token: HostAttributeToken): string;
+
+/**
+ * @param token A token that represents a static attribute on the host node that should be injected.
+ * @returns Value of the attribute if it exists, otherwise `null`.
+ * @throws If called outside of a supported context.
+ *
+ * @publicApi
+ */
+export declare function inject(token: HostAttributeToken, options: {
+    optional: true;
+}): string | null;
+
+/**
+ * @param token A token that represents a static attribute on the host node that should be injected.
+ * @returns Value of the attribute if it exists.
+ * @throws If called outside of a supported context or the attribute does not exist.
+ *
+ * @publicApi
+ */
+export declare function inject(token: HostAttributeToken, options: {
+    optional: false;
+}): string;
+
 /**
  * Type of the Injectable metadata.
  *
@@ -5131,7 +5191,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;
@@ -5695,6 +5755,12 @@ declare interface InternalAfterNextRenderOptions {
      * If this is not provided, the current injection context will be used instead (via `inject`).
      */
     injector?: Injector;
+    /**
+     * When true, the hook will execute both on client and on the server.
+     *
+     * When false or undefined, the hook only executes in the browser.
+     */
+    runOnServer?: boolean;
 }
 
 /**
@@ -6731,12 +6797,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;
 }
 
 /**
@@ -7477,7 +7541,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;
@@ -7501,6 +7565,29 @@ export declare interface Output {
  */
 export declare const Output: OutputDecorator;
 
+/**
+ * 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>();     // OutputEmitterRef<string>
+ *   onClick = output();                // OutputEmitterRef<void>
+ * }
+ * ```
+ *
+ * @developerPreview
+ */
+export declare function output<T = void>(opts?: OutputOptions): OutputEmitterRef<T>;
+
 /**
  * Type of the Output decorator / constructor function.
  *
@@ -7527,6 +7614,67 @@ 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;
+    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
@@ -7799,7 +7947,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}
  *
@@ -9024,7 +9172,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
  *
@@ -9076,7 +9224,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
  */
@@ -9208,6 +9356,11 @@ declare interface TDeferBlockDetails {
      * which all await the same set of dependencies.
      */
     loadingPromise: Promise<unknown> | null;
+    /**
+     * List of providers collected from all NgModules that were imported by
+     * standalone components used within this defer block.
+     */
+    providers: Provider[] | null;
 }
 
 /** Static data for an <ng-container> */
@@ -10768,7 +10921,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
  *
@@ -11341,14 +11494,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.
      */
@@ -11360,7 +11510,7 @@ export declare interface WritableSignal<T> extends Signal<T> {
     update(updateFn: (value: T) => T): void;
     /**
      * Returns a readonly version of this signal. Readonly signals can be accessed to read their value
-     * but can't be changed using set, update or mutate methods. The readonly signals do _not_ have
+     * but can't be changed using set or update methods. The readonly signals do _not_ have
      * any built-in mechanism that would prevent deep-mutation of their value.
      */
     asReadonly(): Signal<T>;
@@ -11381,9 +11531,10 @@ export declare function ɵ_sanitizeUrl(url: string): string;
  */
 export declare class ɵAfterRenderEventManager {
     /**
-     * Executes callbacks. Returns `true` if any callbacks executed.
+     * Executes internal and user-provided callbacks.
      */
     execute(): void;
+    executeInternalCallbacks(): void;
     ngOnDestroy(): void;
     /** @nocollapse */
     static ɵprov: unknown;
@@ -11944,6 +12095,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;
 
@@ -12268,6 +12421,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;
 
 /**
@@ -12423,6 +12579,14 @@ export declare function ɵisComponentDefPendingResolution(type: Type<any>): bool
 
 export declare function ɵisEnvironmentProviders(value: Provider | EnvironmentProviders | ɵInternalEnvironmentProviders): value is ɵInternalEnvironmentProviders;
 
+/**
+ * Used to patch behavior that needs to _temporarily_ be different between g3 and external.
+ *
+ * For example, make breaking changes ahead of the main branch targeting a major version.
+ * Permanent differences between g3 and external should be configured by individual patches.
+ */
+export declare const ɵisG3 = false;
+
 export declare function ɵisInjectable(type: any): boolean;
 
 export declare function ɵisNgModule<T>(value: Type<T>): value is Type<T> & {
@@ -12669,56 +12833,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.
@@ -12878,6 +12992,23 @@ export declare interface ɵProviderRecord {
 
 export declare function ɵprovideZonelessChangeDetection(): EnvironmentProviders;
 
+/**
+ * Queue a state update to be performed asynchronously.
+ *
+ * This is useful to safely update application state that is used in an expression that was already
+ * checked during change detection. This defers the update until later and prevents
+ * `ExpressionChangedAfterItHasBeenChecked` errors. Using signals for state is recommended instead,
+ * but it's not always immediately possible to change the state to a signal because it would be a
+ * breaking change. When the callback updates state used in an expression, this needs to be
+ * accompanied by an explicit notification to the framework that something has changed (i.e.
+ * updating a signal or calling `ChangeDetectorRef.markForCheck()`) or may still cause
+ * `ExpressionChangedAfterItHasBeenChecked` in dev mode or fail to synchronize the state to the DOM
+ * in production.
+ */
+export declare function ɵqueueStateUpdate(callback: VoidFunction, options?: {
+    injector?: Injector;
+}): void;
+
 export declare function ɵreadHydrationInfo(node: RNode): ɵHydrationInfo | null;
 
 export declare class ɵReflectionCapabilities implements PlatformReflectionCapabilities {
@@ -13148,6 +13279,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
 }
@@ -13346,7 +13478,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;
 
@@ -13357,7 +13489,7 @@ export declare function ɵunwrapSafeValue<T>(value: T): T;
  * @codeGenApi
  */
 export declare function ɵunwrapWritableSignal<T>(value: T | {
-    [WRITABLE_SIGNAL]: T;
+    [ɵWRITABLE_SIGNAL]: T;
 }): T;
 
 /**
@@ -13635,6 +13767,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.
  */
@@ -14997,6 +15132,12 @@ export declare function ɵɵinject<T>(token: ProviderToken<T>): T;
 
 export declare function ɵɵinject<T>(token: ProviderToken<T>, flags?: InjectFlags): T | null;
 
+export declare function ɵɵinject(token: HostAttributeToken): string;
+
+export declare function ɵɵinject(token: HostAttributeToken, flags?: InjectFlags): string | null;
+
+export declare function ɵɵinject<T>(token: ProviderToken<T> | HostAttributeToken, flags?: InjectFlags): string | null;
+
 /**
  * Information about how a type or `InjectionToken` interfaces with the DI system.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/core",
-  "version": "17.3.0-next.0",
+  "version": "17.3.0-rc.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.0
+ * @license Angular v17.3.0-rc.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.0
+ * @license Angular v17.3.0-rc.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.