@angular/core 17.2.0-next.0 → 17.2.0-next.1

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v17.2.0-next.0
+ * @license Angular v17.2.0-next.1
  * (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
  */
@@ -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;
 
@@ -7713,6 +7754,7 @@ declare const enum QueryFlags {
 export declare class QueryList<T> implements Iterable<T> {
     private _emitDistinctChangesOnly;
     readonly dirty = true;
+    private _onDirty?;
     private _results;
     private _changesDetected;
     private _changes;
@@ -10673,6 +10715,8 @@ export declare interface ViewChildDecorator {
      *
      * @usageNotes
      *
+     * ### Example 1
+     *
      * {@example core/di/ts/viewChild/view_child_example.ts region='Component'}
      *
      * ### Example 2
@@ -11573,9 +11617,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>;
 
@@ -11999,6 +12045,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
@@ -12027,6 +12085,7 @@ export declare const ɵIMAGE_CONFIG_DEFAULTS: ɵImageConfig;
  */
 export declare type ɵImageConfig = {
     breakpoints?: number[];
+    placeholderResolution?: number;
     disableImageSizeWarning?: boolean;
     disableImageLazyLoadWarning?: boolean;
 };
@@ -12524,6 +12583,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);
@@ -12979,13 +13040,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;
 
@@ -13968,7 +14032,19 @@ export declare function ɵɵconditional<T>(containerIndex: number, matchingTempl
  */
 export declare function ɵɵcontentQuery<T>(directiveIndex: number, predicate: ProviderToken<unknown> | string | string[], flags: QueryFlags, read?: any): void;
 
-export declare function ɵɵcontentQuerySignal(): void;
+/**
+ * Registers a QueryList, associated with a content query, for later refresh (part of a view
+ * refresh).
+ *
+ * @param directiveIndex Current directive index
+ * @param predicate The type for which the query will search
+ * @param flags Flags associated with the query
+ * @param read What to save in the query
+ * @returns QueryList<T>
+ *
+ * @codeGenApi
+ */
+export declare function ɵɵcontentQuerySignal<T>(target: Signal<T>, directiveIndex: number, predicate: ProviderToken<unknown> | string[], flags: QueryFlags, read?: any): void;
 
 /**
  * Copies the fields not handled by the `ɵɵInheritDefinitionFeature` from the supertype of a
@@ -15620,7 +15696,19 @@ export declare function ɵɵpureFunction8(slotOffset: number, pureFn: (v1: any,
  */
 export declare function ɵɵpureFunctionV(slotOffset: number, pureFn: (...v: any[]) => any, exps: any[], thisArg?: any): any;
 
-export declare function ɵɵqueryAdvance(_count?: number): void;
+/**
+ * Advances the current query index by a specified offset.
+ *
+ * Adjusting the current query index is necessary in cases where a given directive has a mix of
+ * zone-based and signal-based queries. The signal-based queries don't require tracking of the
+ * current index (those are refreshed on demand and not during change detection) so this instruction
+ * is only necessary for backward-compatibility.
+ *
+ * @param index offset to apply to the current query index (defaults to 1)
+ *
+ * @codeGenApi
+ */
+export declare function ɵɵqueryAdvance(indexOffset?: number): void;
 
 /**
  * Refreshes a query by combining matches from all active views and removing matches from deleted
@@ -16876,7 +16964,7 @@ export declare function ɵɵtrustConstantResourceUrl(url: TemplateStringsArray):
 export declare function ɵɵvalidateIframeAttribute(attrValue: any, tagName: string, attrName: string): any;
 
 /**
- * Creates new QueryList, stores the reference in LView and returns QueryList.
+ * Creates a new view query by initializing internal data structures.
  *
  * @param predicate The type for which the query will search
  * @param flags Flags associated with the query
@@ -16886,6 +16974,17 @@ export declare function ɵɵvalidateIframeAttribute(attrValue: any, tagName: str
  */
 export declare function ɵɵviewQuery<T>(predicate: ProviderToken<unknown> | string | string[], flags: QueryFlags, read?: any): void;
 
-export declare function ɵɵviewQuerySignal(): void;
+/**
+ * Creates a new view query by initializing internal data structures and binding a new query to the
+ * target signal.
+ *
+ * @param target The target signal to assign the query results to.
+ * @param predicate The type or label that should match a given query
+ * @param flags Flags associated with the query
+ * @param read What to save in the query
+ *
+ * @codeGenApi
+ */
+export declare function ɵɵviewQuerySignal(target: Signal<unknown>, predicate: ProviderToken<unknown> | string[], flags: QueryFlags, read?: ProviderToken<unknown>): void;
 
 export { }

package/package.json

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

package/primitives/signals/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v17.2.0-next.0
+ * @license Angular v17.2.0-next.1
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -53,6 +53,8 @@ export declare function consumerBeforeComputation(node: ReactiveNode | null): Re
  */
 export declare function consumerDestroy(node: ReactiveNode): void;
 
+export declare function consumerMarkDirty(node: ReactiveNode): void;
+
 /**
  * Determine whether this consumer has any dependencies which have changed since the last time
  * they were read.

package/rxjs-interop/index.d.ts

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