// tsconfig.json — configuração otimizada
{
  "compilerOptions": {
    // Paralelismo e cache
    "isolatedModules": true,       // permite compilação paralela (obrigatório com esbuild/SWC)
    "incremental": true,           // recompila apenas o que mudou
    "tsBuildInfoFile": ".tsbuildinfo",

    // Pula verificações desnecessárias
    "skipLibCheck": true,          // ignora .d.ts de node_modules (~30% mais rápido)
    "skipDefaultLibCheck": true,

    // Módulos otimizados
    "moduleResolution": "bundler", // resolução moderna para bundlers
    "verbatimModuleSyntax": true,  // force `import type` — elimina imports do emit
    "module": "esnext",

    // Target moderno = JS menor
    "target": "es2022",            // async/await nativo, sem polyfills
    "lib": ["es2022", "dom", "dom.iterable"]
  }
}

// ❌ Com isolatedModules, isso gera erro:
const enum Direction { Up, Down } // const enum não pode ser usado entre arquivos

// ✅ Use as const assertion:
const Direction = { Up: 0, Down: 1 } as const;

// ❌ Import de tipo sem `type` — pode ser incluído no bundle
import { User, ApiResponse } from './types';

// ✅ Import de tipo — eliminado pelo bundler
import type { User, ApiResponse } from './types';

// ✅ Mix: tipos com `type`, valores sem
import { UserService } from './services';
import type { User, ApiResponse } from './types';

// ❌ index.ts — barrel que impede tree shaking
export * from './userService';
export * from './orderService';
export * from './paymentService'; // mesmo que só userService seja usado, tudo é incluído

// ✅ Imports diretos — bundler elimina o que não é usado
import { UserService } from './userService';

// ✅ Barrel com exports nomeados (melhor que wildcard)
export { UserService } from './userService';
export { OrderService } from './orderService';

// ❌ enum — gera objeto IIFE no runtime (~100 bytes)
enum Direction { Up, Down, Left, Right }

// ✅ const enum — inlined pelo compilador, zero runtime
// Porém: não funciona com isolatedModules
const enum Direction { Up, Down, Left, Right }

// ✅✅ as const — zero runtime, funciona com isolatedModules, tree-shakeable
const Direction = { Up: 0, Down: 1, Left: 2, Right: 3 } as const;
type Direction = (typeof Direction)[keyof typeof Direction];

// tsconfig.json
{
  "compilerOptions": {
    "isolatedModules": true,
    "preserveConstEnums": false  // remove const enums do emit
  }
}

// tsconfig.json (raiz)
{
  "references": [
    { "path": "./packages/shared" },
    { "path": "./packages/api" },
    { "path": "./packages/web" }
  ],
  "compilerOptions": { "composite": true }
}

# Compila apenas pacotes alterados
tsc --build --incremental

# Compila em paralelo (TS 5.0+)
tsc --build --force

// ❌ Aloca array a cada iteração
for (const key of Object.keys(config)) { /* ... */ }

// ✅ Cacheie as keys
const keys = Object.keys(config);
for (const key of keys) { /* ... */ }

// ✅✅ Use for...in com hasOwnProperty
for (const key in config) {
  if (Object.prototype.hasOwnProperty.call(config, key)) { /* ... */ }
}

// ❌ Import estático — carrega tudo no bundle inicial
import { HeavyChart } from './HeavyChart';

// ✅ Dynamic import — carrega apenas quando necessário
const HeavyChart = lazy(() => import('./HeavyChart'));

// ✅✅ Preload no hover — carrega antes do clique
const loadChart = () => import('./HeavyChart');
<a href="/chart" onMouseEnter={loadChart}>Ver gráfico</a>

// ❌ O(n) — percorre array toda vez
const user = users.find(u => u.id === targetId);

// ✅ O(1) — lookup instantâneo
const userMap = new Map(users.map(u => [u.id, u]));
const user = userMap.get(targetId);