Cursor rule

1---
2description: 'Middle Earth TypeScript baseline guidelines (compiler, modules, best practices)'
3globs:
4  - '**/*.ts'
5  - '**/*.tsx'
6alwaysApply: false
7---
8 
9# TypeScript (Middle Earth)
10 
11## Compiler and language
12 
13- Respect `tsconfig.base.json`: `strict` true, `verbatimModuleSyntax`, `noUnusedLocals/Parameters`.
14- Use the provided path aliases (`@middle-earth/libs/publishable/*`); do not import via relative `../../..`.
15- No `any` or unsafe casts; favor precise types and narrowing.
16 
17## Modules and barrels
18 
19- Import from library barrels (`src/index.ts`). Avoid deep imports into internal files.
20- Keep public types exported from the barrel.
21 
22## Functions and variables
23 
24- Prefer explicit function return types for exported functions and public APIs.
25- Meaningful identifiers; no 1-2 letter names; avoid abbreviations unless industry-standard.
26- Use early returns and narrow unions with type guards.
27- Organize constants, helpers, and types by file: `*.constants.ts`, `*.helpers.ts`, `*.types.ts`.
28 
29## Error handling
30 
31- Use `Result`-like patterns or typed errors. Do not swallow errors; add context.
32- Prefer `type-fest` utility types where possible.
33 
34## Lint integration
35 
36- Follow root ESLint config (Airbnb base/typescript, SonarJS, Unicorn, Security, Promise, Perfectionist, Prettier).
37- Avoid default exports unless required by a framework (e.g., Next.js pages/layouts).
38