> TypeScript Tooling
Development tools, linting, and build config for TypeScript. Use when configuring ESLint, Prettier, Jest, Vitest, tsconfig, or any TS build tooling.
curl "https://skillshub.wtf/HoangNguyen0403/agent-skills-standard/tooling?format=md"TypeScript Tooling
Priority: P1 (OPERATIONAL)
Essential tooling for TypeScript development and maintenance.
Implementation Guidelines
- Compiler:
tscfor CI.ts-node/esbuildfor dev. - Lint: ESLint +
@typescript-eslint. Strict type checking. - Format: Prettier (on save + commit).
- Test: Jest/Vitest > 80% coverage.
- Build:
tsup(libs), Vite/Webpack (apps). - Check:
tsc --noEmitin CI.
Anti-Patterns
- No Disable: Avoid
// eslint-disable. - No Skip: Avoid
skipLibCheck: trueif possible. - No Ignore: Use
@ts-expect-error>@ts-ignore.
ESLint Configuration
Strict Mode Requirement
CRITICAL: Every file in the project, including tests (.spec.ts), must adhere to strict type-checked rules. NEVER turn off @typescript-eslint/no-explicit-any or no-unsafe-* rules.
Common Linting Issues & Solutions
Request Object Typing
Problem: Using any for Express request objects or creating duplicate inline interfaces.
Solution: Use the centralized interfaces in src/common/interfaces/request.interface.ts.
import { RequestWithUser } from 'src/common/interfaces/request.interface';
Unused Parameters
Problem: Function parameters marked as unused by linter.
Solution: Prefix the parameter with an underscore (e.g., _data) or remove it. NEVER use eslint-disable.
Test Mock Typing
Problem: Jest mocks triggering unsafe type warnings when expect.any() or custom mocks are used.
Solution: Cast the mock or expectation using as unknown as TargetType.
mockRepo.save.mockResolvedValue(result as unknown as User);
Configuration
// tsconfig.json
{
"compilerOptions": {
"strict": true,
"noImplicitReturns": true,
"noUnusedLocals": true
}
}
Reference & Examples
For testing configuration and CI/CD setup: See references/REFERENCE.md.
Related Topics
best-practices | language
> related_skills --same-repo
> typescript-tooling
Development tools, linting, and build config for TypeScript. Use when configuring ESLint, Prettier, Jest, Vitest, tsconfig, or any TS build tooling. (triggers: tsconfig.json, .eslintrc.*, jest.config.*, package.json, eslint, prettier, jest, vitest, build, compile, lint)
> typescript-security
Secure coding practices for TypeScript. Use when validating input, handling auth tokens, sanitizing data, or managing secrets and sensitive configuration. (triggers: **/*.ts, **/*.tsx, validate, sanitize, xss, injection, auth, password, secret, token)
> typescript-language
Modern TypeScript standards for type safety and maintainability. Use when working with types, interfaces, generics, enums, unions, or tsconfig settings. (triggers: **/*.ts, **/*.tsx, tsconfig.json, type, interface, generic, enum, union, intersection, readonly, const, namespace)
> typescript-best-practices
Idiomatic TypeScript patterns for clean, maintainable code. Use when writing or refactoring TypeScript classes, functions, modules, or async logic. (triggers: **/*.ts, **/*.tsx, class, function, module, import, export, async, promise)