@angular/core 17.2.2 → 17.2.4

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v17.2.2
+ * @license Angular v17.2.4
  * (c) 2010-2022 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -1104,7 +1104,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 +1136,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 +1817,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 +1844,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
  *
@@ -3846,7 +3846,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 +3874,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 +3902,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 +3934,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
  */
@@ -5131,7 +5131,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 +5695,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;
 }
 
 /**
@@ -7477,7 +7483,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;
@@ -7799,7 +7805,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 +9030,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 +9082,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 +9214,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 +10779,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
  *
@@ -11360,7 +11371,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 +11392,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;
@@ -12878,6 +12890,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 {
@@ -13346,7 +13375,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;
 

package/package.json

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

package/primitives/signals/index.d.ts

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

package/rxjs-interop/index.d.ts

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

package/schematics/migrations/block-template-entities/bundle.js

@@ -7227,13 +7227,10 @@ var ExpressionKind;
   ExpressionKind2[ExpressionKind2["EmptyExpr"] = 17] = "EmptyExpr";
   ExpressionKind2[ExpressionKind2["AssignTemporaryExpr"] = 18] = "AssignTemporaryExpr";
   ExpressionKind2[ExpressionKind2["ReadTemporaryExpr"] = 19] = "ReadTemporaryExpr";
-  ExpressionKind2[ExpressionKind2["SanitizerExpr"] = 20] = "SanitizerExpr";
-  ExpressionKind2[ExpressionKind2["TrustedValueFnExpr"] = 21] = "TrustedValueFnExpr";
-  ExpressionKind2[ExpressionKind2["SlotLiteralExpr"] = 22] = "SlotLiteralExpr";
-  ExpressionKind2[ExpressionKind2["ConditionalCase"] = 23] = "ConditionalCase";
-  ExpressionKind2[ExpressionKind2["DerivedRepeaterVar"] = 24] = "DerivedRepeaterVar";
-  ExpressionKind2[ExpressionKind2["ConstCollected"] = 25] = "ConstCollected";
-  ExpressionKind2[ExpressionKind2["TwoWayBindingSet"] = 26] = "TwoWayBindingSet";
+  ExpressionKind2[ExpressionKind2["SlotLiteralExpr"] = 20] = "SlotLiteralExpr";
+  ExpressionKind2[ExpressionKind2["ConditionalCase"] = 21] = "ConditionalCase";
+  ExpressionKind2[ExpressionKind2["ConstCollected"] = 22] = "ConstCollected";
+  ExpressionKind2[ExpressionKind2["TwoWayBindingSet"] = 23] = "TwoWayBindingSet";
 })(ExpressionKind || (ExpressionKind = {}));
 var VariableFlags;
 (function(VariableFlags2) {
@@ -7252,12 +7249,6 @@ var CompatibilityMode;
   CompatibilityMode2[CompatibilityMode2["Normal"] = 0] = "Normal";
   CompatibilityMode2[CompatibilityMode2["TemplateDefinitionBuilder"] = 1] = "TemplateDefinitionBuilder";
 })(CompatibilityMode || (CompatibilityMode = {}));
-var DeferSecondaryKind;
-(function(DeferSecondaryKind2) {
-  DeferSecondaryKind2[DeferSecondaryKind2["Loading"] = 0] = "Loading";
-  DeferSecondaryKind2[DeferSecondaryKind2["Placeholder"] = 1] = "Placeholder";
-  DeferSecondaryKind2[DeferSecondaryKind2["Error"] = 2] = "Error";
-})(DeferSecondaryKind || (DeferSecondaryKind = {}));
 var BindingKind;
 (function(BindingKind2) {
   BindingKind2[BindingKind2["Attribute"] = 0] = "Attribute";
@@ -7331,10 +7322,6 @@ var TRAIT_DEPENDS_ON_SLOT_CONTEXT = {
 var TRAIT_CONSUMES_VARS = {
   [ConsumesVarsTrait]: true
 };
-var TRAIT_USES_VAR_OFFSET = {
-  [UsesVarOffset]: true,
-  varOffset: null
-};
 function hasConsumesSlotTrait(op) {
   return op[ConsumesSlot] === true;
 }
@@ -9599,7 +9586,7 @@ var ElementAttributes = class {
     this.propertyBindings = null;
     this.projectAs = null;
   }
-  isKnown(kind, name, value) {
+  isKnown(kind, name) {
     var _a2;
     const nameToValue = (_a2 = this.known.get(kind)) != null ? _a2 : /* @__PURE__ */ new Set();
     this.known.set(kind, nameToValue);
@@ -9612,7 +9599,7 @@ var ElementAttributes = class {
   add(kind, name, value, namespace, trustedValueFn) {
     var _a2;
     const allowDuplicates = this.compatibility === CompatibilityMode.TemplateDefinitionBuilder && (kind === BindingKind.Attribute || kind === BindingKind.ClassName || kind === BindingKind.StyleProperty);
-    if (!allowDuplicates && this.isKnown(kind, name, value)) {
+    if (!allowDuplicates && this.isKnown(kind, name)) {
       return;
     }
     if (name === "ngProjectAs") {
@@ -10212,7 +10199,7 @@ function createI18nMessage(job, context, messagePlaceholder) {
 }
 function formatIcuPlaceholder(op) {
   if (op.strings.length !== op.expressionPlaceholders.length + 1) {
-    throw Error(`AsserionError: Invalid ICU placeholder with ${op.strings.length} strings and ${op.expressionPlaceholders.length} expressions`);
+    throw Error(`AssertionError: Invalid ICU placeholder with ${op.strings.length} strings and ${op.expressionPlaceholders.length} expressions`);
   }
   const values = op.expressionPlaceholders.map(formatValue);
   return op.strings.flatMap((str, i) => [str, values[i] || ""]).join("");
@@ -16858,7 +16845,7 @@ function addNamesToView(unit, baseName, state, compatibility) {
         }
         if (op.emptyView !== null) {
           const emptyView = unit.job.views.get(op.emptyView);
-          addNamesToView(emptyView, `${baseName}_${`${op.functionNameSuffix}Empty`}_${op.handle.slot + 2}`, state, compatibility);
+          addNamesToView(emptyView, `${baseName}_${op.functionNameSuffix}Empty_${op.handle.slot + 2}`, state, compatibility);
         }
         addNamesToView(unit.job.views.get(op.xref), `${baseName}_${op.functionNameSuffix}_${op.handle.slot + 1}`, state, compatibility);
         break;
@@ -17279,7 +17266,7 @@ function propagateI18nBlocksToTemplates(unit, subTemplateIndex) {
         break;
       case OpKind.RepeaterCreate:
         const forView = unit.job.views.get(op.xref);
-        subTemplateIndex = propagateI18nBlocksForView(unit.job.views.get(op.xref), i18nBlock, op.i18nPlaceholder, subTemplateIndex);
+        subTemplateIndex = propagateI18nBlocksForView(forView, i18nBlock, op.i18nPlaceholder, subTemplateIndex);
         if (op.emptyView !== null) {
           subTemplateIndex = propagateI18nBlocksForView(unit.job.views.get(op.emptyView), i18nBlock, op.emptyI18nPlaceholder, subTemplateIndex);
         }
@@ -18379,11 +18366,11 @@ function processLexicalScope(view, ops) {
 // bazel-out/darwin_arm64-fastbuild/bin/packages/compiler/src/template/pipeline/src/phases/resolve_dollar_event.mjs
 function resolveDollarEvent(job) {
   for (const unit of job.units) {
-    transformDollarEvent(unit, unit.create);
-    transformDollarEvent(unit, unit.update);
+    transformDollarEvent(unit.create);
+    transformDollarEvent(unit.update);
   }
 }
-function transformDollarEvent(unit, ops) {
+function transformDollarEvent(ops) {
   for (const op of ops) {
     if (op.kind === OpKind.Listener || op.kind === OpKind.TwoWayListener) {
       transformExpressionsInOp(op, (expr) => {
@@ -18554,7 +18541,7 @@ function recordTemplateStart(job, view, slot, i18nPlaceholder, i18nContext, i18n
   addParam(i18nContext.params, startName, slot, getSubTemplateIndexForTemplateTag(job, i18nBlock, view), flags);
 }
 function recordTemplateClose(job, view, slot, i18nPlaceholder, i18nContext, i18nBlock, structuralDirective) {
-  const { startName, closeName } = i18nPlaceholder;
+  const { closeName } = i18nPlaceholder;
   const flags = I18nParamValueFlags.TemplateTag | I18nParamValueFlags.CloseTag;
   if (closeName) {
     addParam(i18nContext.params, closeName, slot, getSubTemplateIndexForTemplateTag(job, i18nBlock, view), flags);
@@ -18581,14 +18568,14 @@ function addParam(params, placeholder, value, subTemplateIndex, flags) {
 // bazel-out/darwin_arm64-fastbuild/bin/packages/compiler/src/template/pipeline/src/phases/resolve_i18n_expression_placeholders.mjs
 function resolveI18nExpressionPlaceholders(job) {
   var _a2;
-  const subTemplateIndicies = /* @__PURE__ */ new Map();
+  const subTemplateIndices = /* @__PURE__ */ new Map();
   const i18nContexts = /* @__PURE__ */ new Map();
   const icuPlaceholders = /* @__PURE__ */ new Map();
   for (const unit of job.units) {
     for (const op of unit.create) {
       switch (op.kind) {
         case OpKind.I18nStart:
-          subTemplateIndicies.set(op.xref, op.subTemplateIndex);
+          subTemplateIndices.set(op.xref, op.subTemplateIndex);
           break;
         case OpKind.I18nContext:
           i18nContexts.set(op.xref, op);
@@ -18605,7 +18592,7 @@ function resolveI18nExpressionPlaceholders(job) {
     for (const op of unit.update) {
       if (op.kind === OpKind.I18nExpression) {
         const index = expressionIndices.get(referenceIndex(op)) || 0;
-        const subTemplateIndex = (_a2 = subTemplateIndicies.get(op.i18nOwner)) != null ? _a2 : null;
+        const subTemplateIndex = (_a2 = subTemplateIndices.get(op.i18nOwner)) != null ? _a2 : null;
         const value = {
           value: index,
           subTemplateIndex,
@@ -18669,7 +18656,7 @@ function processLexicalScope2(unit, ops, savedView) {
     if (op.kind == OpKind.Listener || op.kind === OpKind.TwoWayListener) {
       continue;
     }
-    transformExpressionsInOp(op, (expr, flags) => {
+    transformExpressionsInOp(op, (expr) => {
       if (expr instanceof LexicalReadExpr) {
         if (scope.has(expr.name)) {
           return new ReadVariableExpr(scope.get(expr.name));
@@ -19271,7 +19258,6 @@ function optimizeVariablesInOpList(ops, compatibility) {
   const toInline = [];
   for (const [id, count] of varUsages) {
     const decl = varDecls.get(id);
-    const varInfo = opMap.get(decl);
     const isAlwaysInline = !!(decl.flags & VariableFlags.AlwaysInline);
     if (count !== 1 || isAlwaysInline) {
       continue;
@@ -19974,7 +19960,6 @@ function ingestIcu(unit, icu) {
   var _a2;
   if (icu.i18n instanceof Message && isSingleI18nIcu(icu.i18n)) {
     const xref = unit.job.allocateXrefId();
-    const icuNode = icu.i18n.nodes[0];
     unit.create.push(createIcuStartOp(xref, icu.i18n, icuFromI18nMessage(icu.i18n).name, null));
     for (const [placeholder, text2] of Object.entries(__spreadValues(__spreadValues({}, icu.vars), icu.placeholders))) {
       if (text2 instanceof BoundText) {
@@ -26070,7 +26055,7 @@ function publishFacade(global) {
 }
 
 // bazel-out/darwin_arm64-fastbuild/bin/packages/compiler/src/version.mjs
-var VERSION2 = new Version("17.2.2");
+var VERSION2 = new Version("17.2.4");
 
 // bazel-out/darwin_arm64-fastbuild/bin/packages/compiler/src/i18n/extractor_merger.mjs
 var _VisitorMode;