How reactivex/rxjs works
This repository’s main product is RxJS 9, a platform-based library for composing asynchronous and event-driven programs, alongside a conditional Observable polyfill and a migration tool. The principal runtime workflow is consumer code using platform Observables and RxJS Symbol-keyed factories/operators, with ColdObservable available for producer-per-subscription behavior and AbortSignal-based cancellation. The migration package analyzes legacy test code, applies semantic and optional framework transformations, and reports diagnostics. Edges are limited to README-documented behavior and source-index or excerpt evidence; unsampled internals are not assumed to connect.
Main entry points: src/index.ts Migration API · semantics.ts Semantic Migration · diagnostics.ts Diagnostics · src/index.ts RxJS API
Components 17
RxJS Runtime
- RxJS API
packages/rxjs/src/index.ts - Observable Factory
packages/rxjs/src/create.ts - Cold Observable
packages/rxjs/src/cold-observable.ts - Symbol Operators
packages/rxjs/src/map.ts - Subjects
packages/rxjs/src/subject.ts - Group By
packages/rxjs/src/group-by.ts
Platform Fallback
- Observable Polyfill
packages/observable-polyfill/src/index.ts
Migration Engine
- Migration API
packages/migrate/src/index.ts - Source Analysis
packages/migrate/src/analyze.ts - Capability Registry
packages/migrate/src/capabilities.ts - Semantic Migration
packages/migrate/src/semantics.ts - Framework Adapter
packages/migrate/src/mocha-chai-vitest.ts - Diagnostics
packages/migrate/src/diagnostics.ts - Migration Schemas
packages/migrate/src/schemas.ts - Migration Contracts
packages/migrate/src/types.ts
Runtime Contracts
- Platform Observable
Other components
- Library Consumer
Connections 20
- Library Consumer → Platform Observable: uses
README.md - Library Consumer → RxJS API: uses extensions
README.md - Library Consumer → Cold Observable: creates producer
README.md - RxJS API → Symbol Operators: exports symbols
- RxJS API → Observable Factory: exports API
- Observable Polyfill → Platform Observable: provides fallback
README.md - Group By → Observable Factory: creates stream
packages/rxjs/src/group-by.ts - Group By → Subjects: creates groups
packages/rxjs/src/group-by.ts - Library Consumer → Migration API: requests migration
- Migration API → Semantic Migration: runs semantics
packages/migrate/src/index.ts - Migration API → Framework Adapter: adapts framework
packages/migrate/src/index.ts - Migration API → Diagnostics: sorts diagnostics
packages/migrate/src/index.ts - Semantic Migration → Diagnostics: reports issues
packages/migrate/src/semantics.ts - Semantic Migration → Migration Schemas: validates registry
packages/migrate/src/semantics.ts - Semantic Migration → Capability Registry: loads mappings
packages/migrate/src/semantics.ts - Source Analysis → Capability Registry: uses registry
packages/migrate/src/analyze.ts - Framework Adapter → Diagnostics: creates diagnostics
packages/migrate/src/mocha-chai-vitest.ts - Diagnostics → Migration Contracts: uses contracts
packages/migrate/src/diagnostics.ts - Capability Registry → Migration Contracts: uses contracts
packages/migrate/src/capabilities.ts - Migration Schemas → Migration Contracts: validates contracts
packages/migrate/src/schemas.ts