reference-compiler-cli
Angular Compiler CLI (ngtsc) Architecture
Overview
The packages/compiler-cli package contains the Angular Compiler (Ivy), often referred to as ngtsc. It is a wrapper around the TypeScript compiler (tsc) that extends it with Angular-specific capabilities.
The core goal of ngtsc is to compile Angular decorators (like @Component, @Directive, @Pipe) into static properties on the class (Ivy instructions, e.g., static ɵcmp = ...). It also performs template type checking and ahead-of-time (AOT) compilation.
Mental Model
The compiler is designed as a lazy, incremental, and partial compilation pipeline.
- Wrapper Pattern:
NgtscProgramwraps the standardts.Program. It intercepts calls to act as a drop-in replacement for standard tooling. - Traits System: Every class with an Angular decorator is considered a "Trait". The compiler manages the state of these traits through a state machine:
- Pending: Detected but not processed.
- Analyzed: Metadata extracted, template parsed (but dependencies not yet linked).
- Resolved: Dependencies (directives/pipes in template) resolved, import cycles handled.
- Skipped: Not an Angular class.
- Lazy Analysis: Analysis only happens when necessary (e.g., when diagnostics are requested or emit is prepared).
More from midudev/autoskills
bun
Use when building, testing, and deploying JavaScript/TypeScript applications. Reach for Bun when you need to run scripts, manage dependencies, bundle code, or test applications with a single unified tool.
19react-hook-form
React Hook Form performance optimization for client-side form validation using useForm, useWatch, useController, and useFieldArray. This skill should be used when building client-side controlled forms with React Hook Form library. This skill does NOT cover React 19 Server Actions, useActionState, or server-side form handling (use react-19 skill for those).
15pydantic
Python data validation using type hints and runtime type checking with Pydantic v2's Rust-powered core for high-performance validation in FastAPI, Django, and configuration management.
13prisma-postgres
Prisma Postgres setup and operations guidance across Console, create-db CLI, Management API, and Management API SDK. Use when creating Prisma Postgres databases, working in Prisma Console, provisioning with create-db/create-pg/create-postgres, or integrating programmatic provisioning with service tokens or OAuth.
12nestjs-best-practices
NestJS best practices and architecture patterns for building production-ready applications. This skill should be used when writing, reviewing, or refactoring NestJS code to ensure proper patterns for modules, dependency injection, security, and performance.
12flutter-animations
>-
11