AGENTS.md

trigger	always_on

This is the source code for the Angular framework. This guide outlines standard practices for AI agents working in this repository.

Environment

• Use pnpm for package management.
• Use pnpm bazel test //target to run tests.

Key Documentation

• Building and Testing: definitive guide for running targets.
• Coding Standards: style guide for TypeScript and other files.
• Commit Guidelines: format for commit messages and PR titles.

Testing

• Create standalone component/directives by default, DO NOT introduce new NgModules/non-standalone components even if sibling tests use them.
• Prefer current best practices over existing authoring styles in the same file
• Test components usually do not need selectors unless they are used in templates
• Zoneless & Async-First: Assume a zoneless environment where state changes schedule updates asynchronously.
  • Do NOT use fixture.detectChanges() to manually trigger updates.
  • ALWAYS use the "Act, Wait, Assert" pattern:
    1. Act: Update state or perform an action.
    2. Wait: await fixture.whenStable() to allow the framework to process the scheduled update.
    3. Assert: Verify the output.
• To keep tests fast, minimize the need for waiting:
  • Use useAutoTick() (from packages/private/testing/src/utils.ts) to fast-forward time via the mock clock.
• When waiting is necessary, use real async tests (it('...', async () => { ... })) along with:
  • await timeout(ms) (from packages/private/testing/src/utils.ts) to wait a specific number of milliseconds.
  • await fixture.whenStable() to wait for framework stability.
  • Use the waitFor helper function exposed by @angular/private/testing

Pull Requests

• Use the gh CLI (GitHub CLI) for creating and managing pull requests.