@angular/core 17.1.2 → 17.2.0-next.1

package/fesm2022/primitives/signals.mjs

@@ -1,5 +1,5 @@
 /**
- * @license Angular v17.1.2
+ * @license Angular v17.2.0-next.1
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -549,5 +549,5 @@ function setAlternateWeakRefImpl(impl) {
     // TODO: remove this function
 }
 
-export { REACTIVE_NODE, SIGNAL, SIGNAL_NODE, consumerAfterComputation, consumerBeforeComputation, consumerDestroy, consumerPollProducersForChange, createComputed, createSignal, createWatch, defaultEquals, getActiveConsumer, isInNotificationPhase, isReactive, producerAccessed, producerNotifyConsumers, producerUpdateValueVersion, producerUpdatesAllowed, setActiveConsumer, setAlternateWeakRefImpl, setPostSignalSetFn, setThrowInvalidWriteToSignalError, signalSetFn, signalUpdateFn };
+export { REACTIVE_NODE, SIGNAL, SIGNAL_NODE, consumerAfterComputation, consumerBeforeComputation, consumerDestroy, consumerMarkDirty, consumerPollProducersForChange, createComputed, createSignal, createWatch, defaultEquals, getActiveConsumer, isInNotificationPhase, isReactive, producerAccessed, producerNotifyConsumers, producerUpdateValueVersion, producerUpdatesAllowed, setActiveConsumer, setAlternateWeakRefImpl, setPostSignalSetFn, setThrowInvalidWriteToSignalError, signalSetFn, signalUpdateFn };
 //# sourceMappingURL=signals.mjs.map

package/fesm2022/rxjs-interop.mjs

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

package/fesm2022/testing.mjs

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

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v17.1.2
+ * @license Angular v17.2.0-next.1
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -5490,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.
      *
@@ -5501,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>;
     };
 }
 
@@ -5543,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> {
 }
 
 /**
@@ -5578,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;
 
@@ -7725,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;
@@ -7938,6 +7968,7 @@ declare interface R3DeclareQueryMetadataFacade {
     read?: OpaqueValue;
     static?: boolean;
     emitDistinctChangesOnly?: boolean;
+    isSignal?: boolean;
 }
 
 declare type R3DeclareTemplateDependencyFacade = {
@@ -12054,6 +12085,7 @@ export declare const ɵIMAGE_CONFIG_DEFAULTS: ɵImageConfig;
  */
 export declare type ɵImageConfig = {
     breakpoints?: number[];
+    placeholderResolution?: number;
     disableImageSizeWarning?: boolean;
     disableImageLazyLoadWarning?: boolean;
 };
@@ -13008,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;
 
@@ -13995,7 +14030,21 @@ export declare function ɵɵconditional<T>(containerIndex: number, matchingTempl
  *
  * @codeGenApi
  */
-export declare function ɵɵcontentQuery<T>(directiveIndex: number, predicate: ProviderToken<unknown> | string[], flags: QueryFlags, read?: any): void;
+export declare function ɵɵcontentQuery<T>(directiveIndex: number, predicate: ProviderToken<unknown> | string | string[], flags: QueryFlags, read?: any): 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
@@ -15647,6 +15696,20 @@ export declare function ɵɵpureFunction8(slotOffset: number, pureFn: (v1: any,
  */
 export declare function ɵɵpureFunctionV(slotOffset: number, pureFn: (...v: any[]) => any, exps: any[], thisArg?: any): any;
 
+/**
+ * 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
  * views.
@@ -16901,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
@@ -16909,6 +16972,19 @@ export declare function ɵɵvalidateIframeAttribute(attrValue: any, tagName: str
  *
  * @codeGenApi
  */
-export declare function ɵɵviewQuery<T>(predicate: ProviderToken<unknown> | string[], flags: QueryFlags, read?: any): void;
+export declare function ɵɵviewQuery<T>(predicate: ProviderToken<unknown> | string | string[], flags: QueryFlags, read?: any): 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.1.2",
+  "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.1.2
+ * @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.1.2
+ * @license Angular v17.2.0-next.1
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */