How salesforce/lwc works
LWC is a component compiler and runtime. The principal workflow is authoring component source, compiling JavaScript/templates/styles, then registering and rendering components through a browser or server runtime; browser rendering can hydrate existing markup. Runtime internals support component definitions, decorators, reactive state, and template execution. The README establishes the compiler/engine product, while the source index and excerpts show several engine relationships; less-documented compiler and renderer links are marked unverified or omitted.
Main entry points: main.ts Engine entry points · renderer.ts Browser renderer · register.ts Decorator registration · transformer.ts LWC compiler
Components 23
Compilation
- LWC compiler
packages/@lwc/compiler/src/transformers/transformer.ts - Component transforms
packages/@lwc/babel-plugin-component/src/component.ts
Component Runtime
- Engine entry points
packages/@lwc/engine-core/src/framework/main.ts - Component registration
packages/@lwc/engine-core/src/framework/component.ts - Component definitions
packages/@lwc/engine-core/src/framework/def.ts - Decorator registration
packages/@lwc/engine-core/src/framework/decorators/register.ts - LightningElement base
packages/@lwc/engine-core/src/framework/base-lightning-element.ts - DOM bridge element
packages/@lwc/engine-core/src/framework/base-bridge-element.ts - Reactive membrane
packages/@lwc/engine-core/src/framework/membrane.ts - Mutation tracking
packages/@lwc/engine-core/src/framework/mutation-tracker.ts - Component lifecycle
packages/@lwc/engine-core/src/framework/component.ts - Component VM
packages/@lwc/engine-core/src/framework/vm.ts - Wire and context
packages/@lwc/engine-core/src/framework/wiring/wiring.ts
Rendering
- Template runtime
packages/@lwc/engine-core/src/framework/template.ts - Template registration
packages/@lwc/engine-core/src/framework/secure-template.ts - Stylesheet runtime
packages/@lwc/engine-core/src/framework/stylesheet.ts - Browser renderer
packages/@lwc/engine-dom/src/renderer.ts - Server renderer
packages/@lwc/engine-server/src/apis/render-component.ts - DOM hydration
packages/@lwc/engine-core/src/framework/hydration.ts
Platform Support
- Synthetic shadow
packages/@lwc/synthetic-shadow/src/polyfills/shadow-root/main.ts
Other components
- Component author
- Browser DOM
- Server host
Connections 25
- Component author → LWC compiler: provides source
README.md - LWC compiler → Component transforms: transforms components
- LWC compiler → Engine entry points: targets compiled APIs
packages/@lwc/engine-core/src/framework/main.ts - Engine entry points → Component registration: exports registration
packages/@lwc/engine-core/src/framework/main.ts - Engine entry points → Component definitions: exports definitions
packages/@lwc/engine-core/src/framework/main.ts - Engine entry points → Decorator registration: exports decorator registration
packages/@lwc/engine-core/src/framework/main.ts - Engine entry points → Component VM: exports VM APIs
packages/@lwc/engine-core/src/framework/main.ts - Engine entry points → Template runtime: exports template APIs
packages/@lwc/engine-core/src/framework/main.ts - Engine entry points → Template registration: exports template registration
packages/@lwc/engine-core/src/framework/main.ts - Component registration → Decorator registration: reads decorator metadata
packages/@lwc/engine-core/src/framework/decorators/register.ts - Component definitions → Decorator registration: reads decorator metadata
packages/@lwc/engine-core/src/framework/def.ts - LightningElement base → Component lifecycle: schedules updates
packages/@lwc/engine-core/src/framework/base-lightning-element.ts - Component lifecycle → Mutation tracking: observes component state
packages/@lwc/engine-core/src/framework/component.ts - Component lifecycle → Component VM: schedules rehydration
packages/@lwc/engine-core/src/framework/component.ts - Reactive membrane → Mutation tracking: reports changes
packages/@lwc/engine-core/src/framework/membrane.ts - Decorator registration → Wire and context: registers wire support
packages/@lwc/engine-core/src/framework/decorators/register.ts - Component VM → Template runtime: executes template
- Browser renderer → Engine entry points: uses runtime APIs
- Server renderer → Engine entry points: uses runtime APIs
- Browser renderer → Browser DOM: renders into DOM
- Server renderer → Server host: renders markup
- DOM hydration → Browser renderer: hydrates DOM
- Engine entry points → DOM hydration: exports hydration
packages/@lwc/engine-core/src/framework/main.ts - Synthetic shadow → Browser DOM: patches shadow DOM
- Stylesheet runtime → Browser renderer: applies styles