Angular: v22.0.0 Release

compiler

| Commit | Description | | -- | -- | | | allow safe navigation to correctly narrow down nullables | | | Angular expressions with optional chaining returns undefined | | | Support comments in html element. | | | abstract emitter producing incorrect code for dynamic imports | | | Don't bind inputs/outputs for data- attributes | | | don't escape dollar sign in literal expression | | | enforce parentheses containing arguments for :host-context | | | invalid type checking code if field name needs to be quoted | | | normalize tag names with custom namespaces in DomElementSchemaRegistry (#68868) | | | preserve leading commas in animation definitions | | | remove dedicated support for legacy shadow DOM selectors | | | remove deprecated shadow CSS encapsulation polyfills | | | sanitize dynamic href and xlink:href bindings on SVG a elements (#68868) | | | simplify handling of colon host with a selector list | | | stop generating unused field | | | throw on duplicate input/outputs | | | throw on invalid in expressions | | | type check invalid for loops |

compiler-cli

| Commit | Description | | -- | -- | | | add support for Node.js 26.0.0 | | | Adds warning for prefetch without main defer trigger | | | support external TCBs with copied content in specific mode | | | animation events not type checked properly when bound through HostListener decorator | | | resolve TCB mapping failure for safe property reads with as any | | | transform dropping exclamationToken from properties | | | introduce NG8023 compile-time diagnostic for duplicate selectors |

core

| Commit | Description | | -- | -- | | | add IdleRequestOptions support to IdleService | | | add provideWebMcpTools | | | Add a injectAsync helper function | | | Add a schematics to migrate provideHttpClient to keep using the HttpXhrBackend implementation. | | | add ability to cache resources for SSR | | | Add migration to add ChangeDetectionStrategy.Eager where applicable | | | add special return statuses for resource params | | | add TestBed.getFixture | | | allow debouncing signals | | | Allow other expression for exhaustive typechecking | | | allow synchronous values for stream Resources | | | bootstrap via ApplicationRef with config | | | de-duplicate host directives | | | drop support for TypeScript 5.9 | | | enhance profiling with documentation URLs | | | export experimental declareWebMcpTool support | | | implement Angular DI graph in-page AI tool | | | introduce @Service decorator | | | re-introduce nested leave animations scoped to component boundaries | | | register AI runtime debugging tools | | | Set default Component changeDetection strategy to OnPush | | | support bootstrapping Angular applications underneath shadow roots | | | support customization of @defer's on idle behavior | | | Support optional timeout for idle deferred triggers | | | TestBed.getFixture -> TestBed.getLastFixture and update implementation | | | Update Testability to use PendingTasks for stability indicator | | | allow service with factory on abstract classes | | | bind global context to idle callback shims in @defer's idle service | | | do not register dom triggers when defer blocks are in manual mode | | | enforce return type for service factory | | | ensure custom controls resolve transitive host directives | | | lazy-initialize debounced state to prevent computation cycle | | | mark service decorator as stable | | | normalize tag names in runtime i18n attribute security context lookup (#68868) | | | prevent rxResource from leaking a subscription | | | resolver function not matching expected type | | | support prefix-insensitive DOM schema lookups and compile-time i18n attribute validation | | | synchronize core sanitization schema with compiler | | | widen type for directive inputs/outputs | | | enhance AnimationCallbackEvent.animationComplete signature | | | remove checkNoChanges from the public API. | | | remove createNgModuleRef | | | remove ComponentFactoryResolver & ComponentFactory from the api surface | | | remove ComponentFactoryResolver & ComponentFactory from the api surface"" |

forms

| Commit | Description | | -- | -- | | | add reloadValidation to Signal Forms to manually trigger async validation | | | add debounce option to validateAsync and validateHttp | | | add FieldState.getError() | | | graduate signal forms APIs to public API | | | shim legacy NG_VALIDATORS into parseErrors for CVA mode (#67943) | | | support binding number|null to <input type="text"> | | | support ngNoCva as an opt-out for ControlValueAccessors | | | template & reactive support for FVC | | | Add support for range type with outside of native bounds | | | align FormField CVA selection priority with standard forms | | | allow FormRoot to be used without submission options (#67727) | | | allow late-bound input types for signals forms | | | change FieldState optional properties to non-optional | undefined | | | clear native date inputs correctly in signal forms when changed via native UI | | | deduplicate writeValue calls in CVA interop | | | ensure debounced async validators produce pending status during debounce | | | fix orphan field error on blur during array removal | | | implement custom control reset propagation | | | prevent orphan field crashes in debounceSync and async validation | | | restrict SignalFormsConfig to a readonly API | | | split the touched model into an input and touch output | | | support generic unions in signal form schemas | | | synchronize controls with the model on reset | | | Untrack setValue in reactive forms | | | use controlValue in NgControl for CVA interop (#67943) | | | avoid redundant invalidations in parser errors signal | | | avoid spurious recomputation in FormField.parseErrors | | | lazily instantiate signal form fields | | | optimize reactivity by using shallow array equality | | | shortcut deepSignal writes if value is unchanged | | | remove string support from min and max validation rules (#68001) |

http

| Commit | Description | | -- | -- | | | Use FetchBackend as default for the HttpBackend implementation | | | Introduce a max buffer size for fetch requests on SSR | | | prevent httpResource from leaking a subscription | | | Add reportUploadProgress & reportDownloadProgress options |

language-service

| Commit | Description | | -- | -- | | | add angular template inlay hints support | | | add Document Symbols support for Angular templates | | | Add support for idle timeout in defer blocks | | | Add support for @Input with transforms |

migrations

| Commit | Description | | -- | -- | | | Add migration for CanMatchFn snapshot parameter (#67452) | | | add strictTemplates to tsconfig during ng update | | | Disabling nullishCoalescingNotNullable & optionalChainNotNullable on ng update | | | model + output migrations | | | avoid generating invalid code in ChangeDetectionStrategy.Eager migration | | | Fix typo for strict-template migration | | | Make the safe optional chaining idempotent | | | remove compiler import from safe optional chaining migration |

platform-browser

| Commit | Description | | -- | -- | | | make incremental hydration default behavior | | | remove unused styles when associated host is dropped | | | remove Hammer integration |

router

| Commit | Description | | -- | -- | | | Add options optional parameter for withComponentInputBinding | | | add unmatchedInputBehavior option to componentInputBinding | | | adds browserUrl input support to router links | | | Add strict typing on 'getResolvedTitleForRoute' | | | make currentSnapshot required in CanMatchFn (#67452) | | | set default paramsInheritanceStrategy to 'always' | | | remove deprecated provideRoutes function. |

service-worker

| Commit | Description | | -- | -- | | | resolve TS 6.0 compatibility for messageerror listener |

upgrade

| Commit | Description | | -- | -- | | | remove getAngularLib/setAngularLib |

Breaking Changes

compiler

• This change will trigger the nullishCoalescingNotNullable and optionalChainNotNullable diagnostics on exisiting projects. You might want to disable those 2 diagnotiscs in your tsconfig temporarily.
• data prefixed attribute no-longer bind inputs nor outputs.
• The compiler will throw when there a when inputs, outputs or model are binding to the same input/outputs.
• in variables will throw in template expressions. ### compiler-cli
• Elements with multiple matching selectors will now throw at compile time. ### core
• The second arguement of appRef.bootstrap does not accept any anymore. Make sure the element you pass is not nullable.
• * TypeScript versions older than 6.0 are no longer supported.
• Leave animations are no longer limited to the element being removed.
• Component with undefined changeDetection property are now OnPush by default. Specify changeDetection: ChangeDetectionStrategy.Eager to keep the previous behavior.
• change AnimationCallbackEvent.animationComplete signature
• ChangeDetectorRef.checkNoChanges was removed. In tests use fixture.detectChanges() instead.
• createNgModuleRef was removed, use createNgModule instead
• ComponentFactoryResolver and ComponentFactory are no longer available. Pass the component class directly to APIs that previously required a factory, such as ViewContainerRef.createComponent or use the standalone createComponentFunction.
• ComponentFactoryResolver and ComponentFactory are no longer available. Pass the component class directly to APIs that previously required a factory, such as ViewContainerRef.createComponent or use the standalone createComponent function.
• stream Resource (which includes rxResource) are now resolving the value synchronously if the stream/observable returns a value sychronously. This can break some tests that assumed an asynchronous resolution of the value. ### forms
• min and max validation rules no longer support string values. Bound values must be numbers or null. ### http
• Use the HttpXhrBackend with provideHttpClient(withXhr) if you want to keep supporting upload progress reports. ### platform-browser
• This removes styles when they appear to no longer be used by an associated host. However other DOM on the page may still be affected by those styles if not leveraging ViewEncapsulation.Emulated or if those styles are used by elements outside of Angular, potentially causing other DOM to appear unstyled.
• Hammer.js integration has been removed. Use your own implementation. ### router
• The return type for TitleStrategy.getResolvedTitleForRoute was previously 'any' while the actual return type could only be either string or undefined. The return type now reflects the possible values correctly. Code that reads the value may need to be adjusted.

(cherry picked from commit ad37f52c1212164c51ffcc533067af05c2c33c89) - The currentSnapshot parameter in CanMatchFn and the canMatch method of the CanMatch interface is now required. While this was already the behavior of the Router at runtime, existing class implementations of CanMatch must now include the third argument to satisfy the interface. - paramsInheritanceStrategy now defaults to 'always'

The default value of paramsInheritanceStrategy has been changed from 'emptyOnly' to 'always'. This means that route parameters are inherited from all parent routes by default. To restore the previous behavior, set paramsInheritanceStrategy to 'emptyOnly' in your router configuration. - provideRoutes() has been removed. Use provideRouter() or ROUTES as multi token if necessary.

upgrade

• Deprecated getAngularLib/setAngularLib have been removed use getAngularJSGlobal/setAngularJSGlobal instead. ## Deprecations ### http
• withFetch is now deprecated, it can be safely removed.
• The reportProgress option is deprecated please use reportUploadProgress & reportDownloadProgress instead.