[PT-BR] translating 'rootDir.md' tsconfig-reference file

packages/tsconfig-reference/copy/pt/options/rootDir.md

@@ -0,0 +1,66 @@
+---
+display: "Diretório Raiz"
+oneline: "Define o diretório raiz dentre os seus arquivos fonte"
+---
+
+**Padrão**: O caminho mais longo em comum entre todos os arquivos que não são de declaração. Se `composite` está definido, o padrão será o diretório contendo o arquivo `tsconfig.json`.
+
+Quando TypeScript compila os arquivos, ele mantém a mesma estrutura de diretórios no diretório de saída como ela existe no diretório de entrada.
+
+Por exemplo, suponhamos que você tenha alguns arquivos de entrada:
+
+```
+MeuProj
+├── tsconfig.json
+├── core
+│   ├── a.ts
+│   ├── b.ts
+│   ├── sub
+│   │   ├── c.ts
+├── types.d.ts
+```
+
+O valor inferido para `rootDir` é o caminho mais longo em comum entre todos os arquivos que não são de declaração, que neste caso é `core/`.
+
+Se o seu `outDir` fosse `dist`, TypeScript escreveria esta árvore:
+
+```
+MeuProj
+├── dist
+│   ├── a.ts
+│   ├── b.ts
+│   ├── sub
+│   │   ├── c.ts
+```
+
+Contudo, você pode ter a intenção de que `core` seja parte da estrutura do diretório de saída.
+Ao definir `rootDir: "."` em `tsconfig.json`, TypeScript escreveria esta árvore:
+
+```
+MeuProj
+├── dist
+│   ├── core
+│   │   ├── a.js
+│   │   ├── b.js
+│   │   ├── sub
+│   │   │   ├── c.js
+```
+
+Importante, a opção `rootDir` **não altera quais arquivos se tornam parte da compilação**.
+Pois não tem interação com `include`, `exclude`, ou com a propriedade `files` em `tsconfig.json`.
+
+Note que TypeScript nunca irá escrever um arquivo de saída em um diretório fora de `outDir`, e nunca irá pular a emissão de um arquivo.
+Por este motivo, `rootDir` também impõe que todos arquivos que precisam ser emitidos estejam abaixo do caminho `rootDir`.
+
+Por exemplo, digamos que você tivesse esta árvore:
+
+```
+MeuProj
+├── tsconfig.json
+├── core
+│   ├── a.ts
+│   ├── b.ts
+├── ajudantes.ts
+```
+
+Seria um erro especificar `rootDir` como `core` _e_ `include` como `*`, porque está se criando um arquivo (`ajudantes.ts`) que precisaria ser emitido _fora_ do `outDir` (i.e. `../ajudantes.js`).