@angular/core 17.1.1 → 17.1.3

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v17.1.1
+ * @license Angular v17.1.3
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -332,7 +332,7 @@ export declare interface AfterViewInit {
 }
 
 /**
- * A [DI token](guide/glossary#di-token "DI token definition") that indicates which animations
+ * A [DI token](api/core/InjectionToken) that indicates which animations
  * module has been loaded.
  * @publicApi
  */
@@ -756,6 +756,8 @@ export declare class ApplicationRef {
      * detection pass during which all change detection must complete.
      */
     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.
@@ -3327,9 +3329,7 @@ declare type DirectiveDefListOrFactory = (() => DirectiveDefList) | DirectiveDef
  *  - Because declared and public name are usually same we only generate the array
  *    `['declared', 'public']` format when they differ, or there is a transform.
  *  - 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`.
+ *    inconsistent behavior in that it uses declared names rather than minified or public.
  */
 declare type DirectiveInputs<T> = {
     [P in keyof T]?: string | [
@@ -3925,7 +3925,7 @@ declare const FLAGS = 2;
 export declare function forwardRef(forwardRefFn: ForwardRefFn): Type<any>;
 
 /**
- * An interface that a function passed into {@link forwardRef} has to implement.
+ * An interface that a function passed into `forwardRef` has to implement.
  *
  * @usageNotes
  * ### Example
@@ -4545,6 +4545,18 @@ export declare interface HostListenerDecorator {
 
 declare const HYDRATION = 6;
 
+declare const HYDRATION_INFO_KEY = "__ngDebugHydrationInfo__";
+
+/**
+ * Internal type that represents a claimed node.
+ * Only used in dev mode.
+ */
+declare enum HydrationStatus {
+    Hydrated = "hydrated",
+    Skipped = "skipped",
+    Mismatched = "mismatched"
+}
+
 declare namespace i0 {
     export {
         ɵɵinject,
@@ -5211,10 +5223,10 @@ export declare const INJECTOR: InjectionToken<Injector>;
 
 /**
  * Concrete injectors implement this interface. Injectors are configured
- * with [providers](guide/glossary#provider) that associate
- * dependencies of various types with [injection tokens](guide/glossary#di-token).
+ * with [providers](guide/dependency-injection-providers) that associate
+ * dependencies of various types with [injection tokens](guide/dependency-injection-providers).
  *
- * @see ["DI Providers"](guide/dependency-injection-providers).
+ * @see [DI Providers](guide/dependency-injection-providers).
  * @see {@link StaticProvider}
  *
  * @usageNotes
@@ -5478,7 +5490,7 @@ export declare interface InputFunction {
      */
     <ReadT>(): InputSignal<ReadT | undefined>;
     <ReadT>(initialValue: ReadT, opts?: InputOptionsWithoutTransform<ReadT>): InputSignal<ReadT>;
-    <ReadT, WriteT>(initialValue: ReadT, opts: InputOptionsWithTransform<ReadT, WriteT>): InputSignal<ReadT, WriteT>;
+    <ReadT, WriteT>(initialValue: ReadT, opts: InputOptionsWithTransform<ReadT, WriteT>): InputSignalWithTransform<ReadT, WriteT>;
     /**
      * Initializes a required input.
      *
@@ -5489,7 +5501,7 @@ export declare interface InputFunction {
      */
     required: {
         <ReadT>(opts?: InputOptionsWithoutTransform<ReadT>): InputSignal<ReadT>;
-        <ReadT, WriteT>(opts: InputOptionsWithTransform<ReadT, WriteT>): InputSignal<ReadT, WriteT>;
+        <ReadT, WriteT>(opts: InputOptionsWithTransform<ReadT, WriteT>): InputSignalWithTransform<ReadT, WriteT>;
     };
 }
 
@@ -5531,18 +5543,17 @@ export declare type InputOptionsWithoutTransform<ReadT> = Omit<InputOptions<Read
 export declare type InputOptionsWithTransform<ReadT, WriteT> = Required<Pick<InputOptions<ReadT, WriteT>, 'transform'>> & InputOptions<ReadT, WriteT>;
 
 /**
- * `InputSignal` is represents a special `Signal` for a directive/component input.
+ * `InputSignal` represents a special `Signal` for a directive/component input.
  *
  * An input signal is similar to a non-writable signal except that it also
  * carries additional type-information for transforms, and that Angular internally
  * updates the signal whenever a new value is bound.
  *
+ * @see {@link InputOptionsWithTransform} for inputs with transforms.
+ *
  * @developerPreview
  */
-export declare interface InputSignal<ReadT, WriteT = ReadT> extends Signal<ReadT> {
-    [SIGNAL]: InputSignalNode<ReadT, WriteT>;
-    [ɵINPUT_SIGNAL_BRAND_READ_TYPE]: ReadT;
-    [ɵINPUT_SIGNAL_BRAND_WRITE_TYPE]: WriteT;
+export declare interface InputSignal<ReadT> extends InputSignalWithTransform<ReadT, ReadT> {
 }
 
 /**
@@ -5566,6 +5577,36 @@ declare interface InputSignalNode<ReadT, WriteT> extends SignalNode<ReadT | type
     applyValueToInputSignal<ReadT, WriteT>(node: InputSignalNode<ReadT, WriteT>, value: ReadT): void;
 }
 
+/**
+ * `InputSignalWithTransform` represents a special `Signal` for a
+ * directive/component input with a `transform` function.
+ *
+ * Signal inputs with transforms capture an extra generic for their transform write
+ * type. Transforms can expand the accepted bound values for an input while ensuring
+ * value retrievals of the signal input are still matching the generic input type.
+ *
+ * ```ts
+ * class MyDir {
+ *   disabled = input(false, {
+ *     transform: (v: string|boolean) => convertToBoolean(v),
+ *   }); // InputSignalWithTransform<boolean, string|boolean>
+ *
+ *   click() {
+ *     this.disabled() // always returns a `boolean`.
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link InputSignal} for additional information.
+ *
+ * @developerPreview
+ */
+export declare interface InputSignalWithTransform<ReadT, WriteT> extends Signal<ReadT> {
+    [SIGNAL]: InputSignalNode<ReadT, WriteT>;
+    [ɵINPUT_SIGNAL_BRAND_READ_TYPE]: ReadT;
+    [ɵINPUT_SIGNAL_BRAND_WRITE_TYPE]: WriteT;
+}
+
 /** Function that can be used to transform incoming input values. */
 declare type InputTransformFunction = (value: any) => any;
 
@@ -10672,6 +10713,8 @@ export declare interface ViewChildDecorator {
      *
      * @usageNotes
      *
+     * ### Example 1
+     *
      * {@example core/di/ts/viewChild/view_child_example.ts region='Component'}
      *
      * ### Example 2
@@ -11094,7 +11137,7 @@ export declare class ɵAfterRenderEventManager {
     /**
      * Executes callbacks. Returns `true` if any callbacks executed.
      */
-    execute(): boolean;
+    execute(): void;
     ngOnDestroy(): void;
     /** @nocollapse */
     static ɵprov: unknown;
@@ -11572,9 +11615,11 @@ export declare const ɵDEFER_BLOCK_CONFIG: InjectionToken<ɵDeferBlockConfig>;
 
 /**
  * **INTERNAL**, avoid referencing it in application code.
- *
+ * *
  * Injector token that allows to provide `DeferBlockDependencyInterceptor` class
  * implementation.
+ *
+ * This token is only injected in devMode
  */
 export declare const ɵDEFER_BLOCK_DEPENDENCY_INTERCEPTOR: InjectionToken<ɵDeferBlockDependencyInterceptor>;
 
@@ -11998,6 +12043,18 @@ export declare type ɵGlobalDevModeUtils = {
     [GLOBAL_PUBLISH_EXPANDO_KEY]: typeof globalUtilsFunctions;
 };
 
+export declare type ɵHydratedNode = {
+    [HYDRATION_INFO_KEY]?: ɵHydrationInfo;
+};
+
+export declare type ɵHydrationInfo = {
+    status: HydrationStatus.Hydrated | HydrationStatus.Skipped;
+} | {
+    status: HydrationStatus.Mismatched;
+    actualNodeDetails: string | null;
+    expectedNodeDetails: string | null;
+};
+
 /**
  * Injection token that configures the image optimized image functionality.
  * See {@link ImageConfig} for additional information about parameters that
@@ -12523,6 +12580,8 @@ export declare interface ɵProviderRecord {
 
 export declare function ɵprovideZonelessChangeDetection(): EnvironmentProviders;
 
+export declare function ɵreadHydrationInfo(node: RNode): ɵHydrationInfo | null;
+
 export declare class ɵReflectionCapabilities implements PlatformReflectionCapabilities {
     private _reflect;
     constructor(reflect?: any);
@@ -12969,7 +13028,7 @@ export declare function ɵtriggerResourceLoading(tDetails: TDeferBlockDetails, l
  *
  * @param string
  * @param maxLength of the output string
- * @returns elispsed string with ... in the middle
+ * @returns ellipsed string with ... in the middle
  */
 export declare function ɵtruncateMiddle(str: string, maxLength?: number): string;
 
@@ -12978,13 +13037,16 @@ export declare function ɵtruncateMiddle(str: string, maxLength?: number): strin
  */
 export declare function ɵunregisterLocaleData(): void;
 
-/** Unwraps all `InputSignal` class fields of the given directive. */
+/**
+ * Unwraps all `InputSignal`/`InputSignalWithTransform` class fields of
+ * the given directive.
+ */
 export declare type ɵUnwrapDirectiveSignalInputs<Dir, Fields extends keyof Dir> = {
     [P in Fields]: ɵUnwrapInputSignalWriteType<Dir[P]>;
 };
 
-/** Retrieves the `WriteT` of an `InputSignal`. */
-declare type ɵUnwrapInputSignalWriteType<Field> = Field extends InputSignal<unknown, infer WriteT> ? WriteT : never;
+/** Retrieves the `WriteT` of an `InputSignal` and `InputSignalWithTransform`. */
+declare type ɵUnwrapInputSignalWriteType<Field> = Field extends InputSignalWithTransform<unknown, infer WriteT> ? WriteT : never;
 
 export declare function ɵunwrapSafeValue(value: ɵSafeValue): string;
 
@@ -13007,7 +13069,7 @@ export declare class ɵViewRef<T> implements EmbeddedViewRef<T>, ChangeDetectorR
      * This may be different from `_lView` if the `_cdRefInjectingView` is an embedded view.
      */
     private _cdRefInjectingView?;
-    private readonly notifyErrorHandler;
+    readonly notifyErrorHandler: boolean;
     private _appRef;
     private _attachedToViewContainer;
     get rootNodes(): any[];

package/package.json

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

package/primitives/signals/index.d.ts

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

package/rxjs-interop/index.d.ts

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