Path Aliases no TypeScript: Setup com @/

// tsconfig.json
{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "outDir": "./dist",
    "rootDir": "./src",

    // Path Aliases - a mágica tá aqui
    "baseUrl": ".",
    "paths": {
      "@/*": ["src/*"],
      "@components/*": ["src/components/*"],
      "@utils/*": ["src/utils/*"],
      "@services/*": ["src/services/*"],
      "@types/*": ["src/types/*"]
    }
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}

// tsconfig.json - projeto com muitos módulos
{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["src/*"],
      "@api/*": ["src/api/*"],
      "@config/*": ["src/config/*"],
      "@hooks/*": ["src/hooks/*"],
      "@lib/*": ["src/lib/*"],
      "@models/*": ["src/models/*"],
      "@store/*": ["src/store/*"],
      "@styles/*": ["src/styles/*"]
    }
  }
}

// Agora seus imports ficam assim:
import { useAuth } from '@hooks/useAuth';
import { UserModel } from '@models/User';
import { apiClient } from '@api/client';
import { theme } from '@styles/theme';

// tsconfig.json (Next.js já entende isso nativamente)
{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["./src/*"]
    }
  }
}

// Uso nos componentes:
import { Button } from '@/components/ui/Button';
import { useUser } from '@/hooks/useUser';
import { cn } from '@/lib/utils';

// Se você usa o App Router com pasta src/:
// src/app/page.tsx
// src/components/Button.tsx
// O alias @/ aponta pra src/ automaticamente

// Next.js 13+ com create-next-app já cria o tsconfig
// com @/* configurado. Só usar.

// jest.config.ts
import type { Config } from 'jest';

const config: Config = {
  preset: 'ts-jest',
  testEnvironment: 'node',

  // Espelhar os paths do tsconfig.json
  moduleNameMapper: {
    '^@/(.*)$': '<rootDir>/src/$1',
    '^@components/(.*)$': '<rootDir>/src/components/$1',
    '^@utils/(.*)$': '<rootDir>/src/utils/$1',
    '^@services/(.*)$': '<rootDir>/src/services/$1',
    '^@types/(.*)$': '<rootDir>/src/types/$1',
  },

  // Ou use ts-jest pathsToModuleNameMapper:
  // moduleNameMapper: pathsToModuleNameMapper(
  //   compilerOptions.paths,
  //   { prefix: '<rootDir>/' }
  // ),
};

export default config;

// jest.config.ts - abordagem automatizada
import { pathsToModuleNameMapper } from 'ts-jest';
import { compilerOptions } from './tsconfig.json';

export default {
  preset: 'ts-jest',
  testEnvironment: 'node',
  modulePaths: ['<rootDir>'],
  moduleNameMapper: pathsToModuleNameMapper(
    compilerOptions.paths,
    { prefix: '<rootDir>/' }
  ),
};

// Agora quando você adiciona um novo alias no tsconfig,
// o Jest pega automaticamente. Zero manutenção extra.

// Instalar module-alias
// npm install module-alias
// npm install -D @types/module-alias

// package.json - mapear aliases
{
  "_moduleAliases": {
    "@": "dist",
    "@components": "dist/components",
    "@utils": "dist/utils",
    "@services": "dist/services"
  }
}

// src/index.ts - registrar aliases ANTES de qualquer import
import 'module-alias/register';

import { startServer } from '@/server';
import { connectDB } from '@services/database';

async function main() {
  await connectDB();
  await startServer();
}

main();

// Instalar tsconfig-paths
// npm install -D tsconfig-paths

// Opção 1: Rodar com ts-node + tsconfig-paths
// npx ts-node -r tsconfig-paths/register src/index.ts

// Opção 2: Registrar no código
// src/register-paths.ts
import { register } from 'tsconfig-paths';
import { compilerOptions } from '../tsconfig.json';

register({
  baseUrl: compilerOptions.baseUrl,
  paths: compilerOptions.paths,
});

// Opção 3: Script no package.json
// {
//   "scripts": {
//     "dev": "ts-node -r tsconfig-paths/register src/index.ts",
//     "start": "node -r tsconfig-paths/register dist/index.js"
//   }
// }