Cursor rule

1---
2description: 'Middle Earth code style conventions (TypeScript/JavaScript)'
3globs:
4  - '*'
5alwaysApply: true
6---
7 
8# Code style (Middle Earth)
9 
10## Naming and clarity
11 
12- Use descriptive names; avoid abbreviations unless industry-standard (URL, ID, API).
13- Functions are verbs; variables are nouns.
14- Prefer explicit return types for exported functions and public APIs.
15 
16## Structure and files
17 
18- Cohesion-first: one responsibility per module.
19- Organize by file type when it helps:
20  - `*.constants.ts`: constants and enums
21  - `*.types.ts`: types and interfaces
22  - `*.helpers.ts`: pure functions/utilities
23- Use barrels (`src/index.ts`) for library exports; no deep imports.
24 
25## Control flow
26 
27- Favor guard clauses and early returns; keep nesting shallow (≤ 2 levels).
28- Avoid deeply nested ternaries; extract small functions.
29 
30## Dependencies and imports
31 
32- Prefer path aliases defined in `tsconfig.base.json` (`@middle-earth/libs/publishable/*`).
33- Respect Nx module boundaries and tags.
34 
35## Error handling and validation
36 
37- Validate inputs at boundaries.
38- Enrich errors with context; avoid silent failures.
39 
40## Performance and DX
41 
42- Prefer pure functions and immutable data structures where possible.
43- Avoid premature optimization; measure first. Keep components and modules small and composable.
44 
45## Formatting and tooling
46 
47- End files with a single trailing newline.
48- After editing files, run formatter and linter with `--fix`.
49