Именование TypeScript alias'ов

При настройке paths в TypeScript выбирайте алиасы, которые точно не конфликтуют с npm-пакетами. Алиас вида @api/* может пересекаться с внешними пакетами и путать резолвер. Проблема обычно всплывает не сразу: локально все может работать, но в другом окружении резолв дает неожиданный результат.

{
  "compilerOptions": {
    "paths": {
      "@api/*": ["./src/api/*"],
      ...
    }
  }
}

{
  "compilerOptions": {
    "paths": {
      "@/api/*": ["./src/api/*"],
      ...
    }
  }
}

Лучше использовать префикс, который явно означает "локальный код", например @/ или ~/. Так импорты читаются понятнее, а риск конфликта с внешними зависимостями заметно ниже. Дополнительно стоит зафиксировать один стиль алиасов в команде и не смешивать несколько схем в одном проекте.