@rx-angular/cdk
@rx-angular/cdk is a Component Development Kit, a helper layer of low-level,
tree-shakable utilities for building ergonomic, high-performance Angular directives,
components, services, and large-scale applications.
The CDK provides the building blocks the rest of RxAngular uses:
- A concurrent, priority-based renderer.
- Immutable array/object update helpers.
- Reactive-input coercion.
- Stream-level notification materialization.
- An app-wide hydration signal.
When to use it
The CDK is not a journey of its own. It is the substrate the RxAngular directives and state container are built on, and most of its value surfaces where you meet it: in the Template journey (rendering and scheduling) and the State journey (immutable state transformations).
You reach for the CDK directly when you need one of its building blocks.
Install
npm install @rx-angular/cdk
Requires Angular >=22.0.0 (RxAngular ^22). The CDK targets the modern baseline: standalone, inject(), signals, and native
control flow (@if/@for/@switch).
Entry points
The CDK ships as a set of independently importable secondary entry points, so you pull in only what you use:
| Entry point | What it provides | Where it surfaces |
|---|---|---|
@rx-angular/cdk/render-strategies | The render-strategy system and the RxStrategyProvider: concurrent, priority-based scheduling of change detection. | Template journey (rendering & scheduling) |
@rx-angular/cdk/transformations | Pure, immutable array/object update helpers (insert, remove, update, upsert, toDictionary, patch, setProp, deleteProp, slice, toggle, …). | State journey (immutable updates) |
@rx-angular/cdk/coercing | Reactive-input coercion: turn Observables or static values into a single Observable input stream. | CDK reference / how-to |
@rx-angular/cdk/notifications | RxNotification, rxMaterialize, and toRx*Notification: stream-level materialization of the reactive context (suspense / next / error / complete). | CDK reference |
@rx-angular/cdk/ssr | HydrationTracker / provideHydrationTracker: an app-wide "fully hydrated" signal for SSR apps. | CDK reference / how-to |
@rx-angular/cdk/coalescing | The coalesceWith RxJS operator for coalescing work over a duration selector. | Legacy · Zone.js shelf |
@rx-angular/cdk/zone-configurations | Zone.js flag configuration helpers. | Legacy · Zone.js shelf |
@rx-angular/cdk/zone-less/browser | Zone-unpatched browser APIs: cancelAnimationFrame, clearInterval, clearTimeout, Promise, requestAnimationFrame, setInterval, setTimeout, unpatchAddEventListener. | Zoneless & Zone.js concept |
@rx-angular/cdk/internals/core | Low-level internals, including getZoneUnPatchedApi. | Internals |
@rx-angular/cdk/internals/scheduler | The concurrent scheduler powering the render strategies. | Internals |
@rx-angular/cdk/template | EmbeddedView management primitives underpinning the template directives. | Internals |
Where to go next
- Render & schedule: the concurrent, priority-based rendering system. Concurrent strategies reference and the Concurrent rendering how-to in the Template journey.
- Transform state immutably: Transformation helpers reference for the pure array/object update functions used in the State journey.
- Coerce reactive inputs:
coercingreference · How to coerce reactive inputs. - Materialize a reactive stream: Notifications reference.
- Track SSR hydration:
HydrationTrackerreference · How to track app hydration. - Concept: Understanding change detection in Angular, the "why" behind render strategies and the scheduling the CDK provides.
Older CDK material was framed around Zone.js. It covered zone flags, zone-less APIs
and coalescing of zone-triggered change detection. Since Angular v21 change
detection is zoneless by default and Zone.js is dropped from the default bundle.
The zone flag and coalescing guides now live on the Legacy · Zone.js shelf for
apps still running Zone.js. The zone-less utilities have no page of their own. The
Zoneless & Zone.js concept
explains how they work. Only the bare @rx-angular/cdk/zone-less entry point was
dropped. The @rx-angular/cdk/zone-less/browser sub-entry still ships
for apps that need zone-unpatched browser globals directly. To reach a
zone-unpatched API generically, use getZoneUnPatchedApi from
@rx-angular/cdk/internals/core.