@angular/core 17.1.0-next.3 → 17.1.0-next.5

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v17.1.0-next.3
+ * @license Angular v17.1.0-next.5
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -642,7 +642,6 @@ export declare class ApplicationRef {
     private _destroyed;
     private _destroyListeners;
     private readonly internalErrorHandler;
-    private readonly zoneIsStable;
     /**
      * Indicates whether this instance was destroyed.
      */
@@ -3615,7 +3614,6 @@ export declare type EnvironmentProviders = {
     ɵbrand: 'EnvironmentProviders';
 };
 
-
 /**
  * Provides a hook for centralized exception handling.
  *
@@ -3848,6 +3846,16 @@ export declare interface FactorySansProvider {
 
 declare const FLAGS = 2;
 
+/**
+ * Interface to an `EffectScheduler` capable of running scheduled effects synchronously.
+ */
+declare interface FlushableEffectRunner {
+    /**
+     * Run any scheduled effects.
+     */
+    flush(): void;
+}
+
 /**
  * Allows to refer to references which are not yet defined.
  *
@@ -5138,11 +5146,21 @@ export declare interface InputDecorator {
     new (arg?: string | Input): any;
 }
 
+/**
+ * `InputSignal` is 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.
+ */
+export declare type InputSignal<ReadT, WriteT = ReadT> = Signal<ReadT> & {
+    [ɵ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;
 
-declare type InputTransformFunction_2 = any;
-
 /**
  * See `TNode.insertBeforeIndex`
  */
@@ -5561,6 +5579,8 @@ declare enum LContainerFlags {
     HasChildViewsToRefresh = 4
 }
 
+declare type LegacyInputPartialMapping = string | [bindingPropertyName: string, classPropertyName: string, transformFunction?: Function];
+
 /**
  * Provide this token to set the locale of your application.
  * It is used for i18n extraction, by i18n pipes (DatePipe, I18nPluralPipe, CurrencyPipe,
@@ -5912,9 +5932,11 @@ declare interface LViewEnvironment {
     /** An optional custom sanitizer. */
     sanitizer: Sanitizer | null;
     /** Container for reactivity system `effect`s. */
-    inlineEffectRunner: ɵFlushableEffectRunner | null;
+    inlineEffectRunner: FlushableEffectRunner | null;
     /** Container for after render hooks */
     afterRenderEventManager: ɵAfterRenderEventManager | null;
+    /** Scheduler for change detection to notify when application state changes. */
+    changeDetectionScheduler: ɵChangeDetectionScheduler | null;
 }
 
 /** Flags associated with an LView (saved in LView[FLAGS]) */
@@ -7349,11 +7371,13 @@ declare interface R3DeclareDirectiveFacade {
     selector?: string;
     type: Type_2;
     inputs?: {
-        [classPropertyName: string]: string | [
-        bindingPropertyName: string,
-        classPropertyName: string,
-        transformFunction?: InputTransformFunction_2
-        ];
+        [fieldName: string]: {
+            classPropertyName: string;
+            publicName: string;
+            isSignal: boolean;
+            isRequired: boolean;
+            transformFunction: Function | null;
+        } | LegacyInputPartialMapping;
     };
     outputs?: {
         [classPropertyName: string]: string;
@@ -10844,6 +10868,14 @@ 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;
+}
+
 export declare function ɵclearResolutionOfComponentResourcesQueue(): Map<Type<any>, Component>;
 
 /**
@@ -11171,6 +11203,9 @@ export declare interface ɵDirectiveDef<T> {
      * A dictionary mapping the private names of inputs to their transformation functions.
      * Note: the private names are used for the keys, rather than the public ones, because public
      * names can be re-aliased in host directives which would invalidate the lookup.
+     *
+     * Note: Signal inputs will not have transforms captured here. This is because their
+     * transform function is already integrated into the `InputSignal`.
      */
     readonly inputTransforms: {
         [classPropertyName: string]: InputTransformFunction;
@@ -11337,16 +11372,6 @@ export declare const enum ɵExtraLocaleDataIndex {
  */
 export declare function ɵfindLocaleData(locale: string): any;
 
-/**
- * Interface to an `EffectScheduler` capable of running scheduled effects synchronously.
- */
-export declare interface ɵFlushableEffectRunner {
-    /**
-     * Run any scheduled effects.
-     */
-    flush(): void;
-}
-
 /**
  * Loops over queued module definitions, if a given module definition has all of its
  * declarations resolved, it dequeues that module definition and sets the scope on
@@ -11404,6 +11429,9 @@ export declare function ɵgetDeferBlocks(lView: LView, deferBlocks: ɵDeferBlock
  */
 export declare function ɵgetDirectives(node: Node): {}[];
 
+
+export declare function ɵgetEnsureDirtyViewsAreAlwaysReachable(): boolean;
+
 /**
  * Retrieves the host element of a component or directive instance.
  * The host element is the DOM element that matched the selector of the directive.
@@ -11515,26 +11543,6 @@ export declare type ɵImageConfig = {
     disableImageLazyLoadWarning?: boolean;
 };
 
-/**
- * *Internal* service that keeps track of pending tasks happening in the system
- * during the initial rendering. No tasks are tracked after an initial
- * rendering.
- *
- * This information is needed to make sure that the serialization on the server
- * is delayed until all tasks in the queue (such as an initial navigation or a
- * pending HTTP request) are completed.
- */
-export declare class ɵInitialRenderPendingTasks implements OnDestroy {
-    private taskId;
-    private pendingTasks;
-    hasPendingTasks: BehaviorSubject<boolean>;
-    add(): number;
-    remove(taskId: number): void;
-    ngOnDestroy(): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ɵInitialRenderPendingTasks, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<ɵInitialRenderPendingTasks>;
-}
-
 /** Returns a ChangeDetectorRef (a.k.a. a ViewRef) */
 export declare function ɵinjectChangeDetectorRef(flags: InjectFlags): ChangeDetectorRef;
 
@@ -11563,6 +11571,116 @@ export declare interface ɵInjectorProfilerContext {
     token: Type<unknown> | null;
 }
 
+/**
+ * Initializes an input with an initial value. If no explicit value
+ * is specified, Angular will use `undefined`.
+ *
+ * Consider using `input.required` for inputs that don't need an
+ * initial value.
+ *
+ * @usageNotes
+ * Initialize an input in your directive or component by declaring a
+ * class field and initializing it with the `input()` function.
+ *
+ * ```ts
+ * @Directive({..})
+ * export class MyDir {
+ *   firstName = input<string>();            // string|undefined
+ *   lastName = input.required<string>();    // string
+ *   age = input(0);                         // number
+ * }
+ * ```
+ */
+export declare const ɵinput: ɵInputFunction;
+
+declare const ɵINPUT_SIGNAL_BRAND_READ_TYPE: unique symbol;
+
+export declare const ɵINPUT_SIGNAL_BRAND_WRITE_TYPE: unique symbol;
+
+/**
+ * Type of the `input` function.
+ *
+ * The input function is a special function that also provides access to
+ * required inputs via the `.required` property.
+ */
+export declare type ɵInputFunction = typeof ɵinputFunctionForApiGuard & {
+    required: typeof ɵinputFunctionRequiredForApiGuard;
+};
+
+/**
+ * Initializes an input with an initial value. If no explicit value
+ * is specified, Angular will use `undefined`.
+ *
+ * Consider using `input.required` for inputs that don't need an
+ * initial value.
+ *
+ * @usageNotes
+ * Initialize an input in your directive or component by declaring a
+ * class field and initializing it with the `input()` function.
+ *
+ * ```ts
+ * @Directive({..})
+ * export class MyDir {
+ *   firstName = input<string>();            // string|undefined
+ *   lastName = input.required<string>();    // string
+ *   age = input(0);                         // number
+ * }
+ * ```
+ */
+export declare function ɵinputFunctionForApiGuard<ReadT>(): InputSignal<ReadT | undefined>;
+
+export declare function ɵinputFunctionForApiGuard<ReadT>(initialValue: ReadT, opts?: ɵInputOptionsWithoutTransform<ReadT>): InputSignal<ReadT>;
+
+export declare function ɵinputFunctionForApiGuard<ReadT, WriteT>(initialValue: ReadT, opts: ɵInputOptionsWithTransform<ReadT, WriteT>): InputSignal<ReadT, WriteT>;
+
+/**
+ * Initializes a required input. Users of your directive/component,
+ * need to bind to this input, otherwise they will see errors.
+ * *
+ * @usageNotes
+ * Initialize an input in your directive or component by declaring a
+ * class field and initializing it with the `input()` function.
+ *
+ * ```ts
+ * @Directive({..})
+ * export class MyDir {
+ *   firstName = input<string>();            // string|undefined
+ *   lastName = input.required<string>();    // string
+ *   age = input(0);                         // number
+ * }
+ * ```
+ */
+export declare function ɵinputFunctionRequiredForApiGuard<ReadT>(opts?: ɵInputOptionsWithoutTransform<ReadT>): InputSignal<ReadT>;
+
+export declare function ɵinputFunctionRequiredForApiGuard<ReadT, WriteT>(opts: ɵInputOptionsWithTransform<ReadT, WriteT>): InputSignal<ReadT, WriteT>;
+
+/**
+ * Options for signal inputs.
+ */
+export declare interface ɵInputOptions<ReadT, WriteT> {
+    /** Optional public name for the input. By default, the class field name is used. */
+    alias?: string;
+    /**
+     * Optional transform that runs whenever a new value is bound. Can be used to
+     * transform the input value before the input is updated.
+     *
+     * The transform function can widen the type of the input. For example, consider
+     * an input for `disabled`. In practice, as the component author, you want to only
+     * deal with a boolean, but users may want to bind a string if they just use the
+     * attribute form to bind to the input via `<my-dir input>`. A transform can then
+     * handle such string values and convert them to `boolean`. See: {@link booleanAttribute}.
+     */
+    transform?: (v: WriteT) => ReadT;
+}
+
+/** Signal input options without the transform option. */
+export declare type ɵInputOptionsWithoutTransform<ReadT> = Omit<ɵInputOptions<ReadT, ReadT>, 'transform'> & {
+    transform?: undefined;
+};
+
+/** Signal input options with the transform option required. */
+export declare type ɵInputOptionsWithTransform<ReadT, WriteT> = Required<Pick<ɵInputOptions<ReadT, WriteT>, 'transform'>> & ɵInputOptions<ReadT, WriteT>;
+
 /**
  * Register a callback to run once before any userspace `afterRender` or
  * `afterNextRender` callbacks.
@@ -11871,6 +11989,28 @@ export declare const ɵNOT_FOUND_CHECK_ONLY_ELEMENT_INJECTOR: {};
  */
 export declare function ɵpatchComponentDefWithScope<C>(componentDef: ɵComponentDef<C>, transitiveScopes: ɵNgModuleTransitiveScopes): void;
 
+/**
+ * *Internal* service that keeps track of pending tasks happening in the system.
+ *
+ * This information is needed to make sure that the serialization on the server
+ * is delayed until all tasks in the queue (such as an initial navigation or a
+ * pending HTTP request) are completed.
+ *
+ * Pending tasks continue to contribute to the stableness of `ApplicationRef`
+ * throughout the lifetime of the application.
+ */
+export declare class ɵPendingTasks implements OnDestroy {
+    private taskId;
+    private pendingTasks;
+    private get _hasPendingTasks();
+    hasPendingTasks: BehaviorSubject<boolean>;
+    add(): number;
+    remove(taskId: number): void;
+    ngOnDestroy(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ɵPendingTasks, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ɵPendingTasks>;
+}
+
 
 /**
  * A guarded `performance.mark` for feature marking.
@@ -12362,6 +12502,8 @@ export declare function ɵsetCurrentInjector(injector: Injector | null | undefin
  */
 export declare function ɵsetDocument(document: Document | undefined): void;
 
+export declare function ɵsetEnsureDirtyViewsAreAlwaysReachable(v: boolean): void;
+
 export declare function ɵsetInjectorProfilerContext(context: ɵInjectorProfilerContext): ɵInjectorProfilerContext;
 
 
@@ -12443,6 +12585,14 @@ export declare function ɵtruncateMiddle(str: string, maxLength?: number): strin
  */
 export declare function ɵunregisterLocaleData(): void;
 
+/** Unwraps all `InputSignal` 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;
+
 export declare function ɵunwrapSafeValue(value: ɵSafeValue): string;
 
 export declare function ɵunwrapSafeValue<T>(value: T): T;
@@ -12731,7 +12881,7 @@ export declare const ɵXSS_SECURITY_URL = "https://g.co/ng/security#xss";
  * An `EffectScheduler` which is capable of queueing scheduled effects per-zone, and flushing them
  * as an explicit operation.
  */
-export declare class ɵZoneAwareQueueingScheduler implements ɵEffectScheduler, ɵFlushableEffectRunner {
+export declare class ɵZoneAwareQueueingScheduler implements ɵEffectScheduler, FlushableEffectRunner {
     private queuedEffectCount;
     private queues;
     scheduleEffect(handle: SchedulableEffect): void;
@@ -13728,6 +13878,7 @@ export declare type ɵɵDirectiveDeclaration<T, Selector extends string, ExportA
     [key: string]: string | {
         alias: string | null;
         required: boolean;
+        isSignal?: boolean;
     };
 }, OutputMap extends {
     [key: string]: string;
@@ -15151,10 +15302,12 @@ export declare function ɵɵrepeater(collection: Iterable<unknown> | undefined |
  * @param emptyTemplateFn Reference to the template function of the empty block.
  * @param emptyDecls The number of nodes, local refs, and pipes for the empty block.
  * @param emptyVars The number of bindings for the empty block.
+ * @param emptyTagName The name of the empty block container element, if applicable
+ * @param emptyAttrsIndex Index of the empty block template attributes in the `consts` array.
  *
  * @codeGenApi
  */
-export declare function ɵɵrepeaterCreate(index: number, templateFn: ComponentTemplate<unknown>, decls: number, vars: number, tagName: string | null, attrsIndex: number | null, trackByFn: TrackByFunction<unknown>, trackByUsesComponentInstance?: boolean, emptyTemplateFn?: ComponentTemplate<unknown>, emptyDecls?: number, emptyVars?: number): void;
+export declare function ɵɵrepeaterCreate(index: number, templateFn: ComponentTemplate<unknown>, decls: number, vars: number, tagName: string | null, attrsIndex: number | null, trackByFn: TrackByFunction<unknown>, trackByUsesComponentInstance?: boolean, emptyTemplateFn?: ComponentTemplate<unknown>, emptyDecls?: number, emptyVars?: number, emptyTagName?: string | null, emptyAttrsIndex?: number | null): void;
 
 /**
  * A built-in trackBy function used for situations where users specified collection item reference

package/package.json

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

package/primitives/signals/index.d.ts

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

package/rxjs-interop/index.d.ts

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