Merge pull request #770 from khaosdoctor/pt-br-translation

Brazilian Portuguese translation

Author: Orta Therox

packages/tsconfig-reference/copy/pt/intro.md

@@ -0,0 +1,5 @@
+## Introdução às referências do TSConfig
+
+Ter um arquivo TSConfig em uma pasta indica que esta pasta é a raiz de um projeto TypeScript ou JavaScript. O arquivo TSConfig pode ser um `tsconfig.json` ou um `jsconfig.json`, os dois possuem o mesmo comportamento e as mesmas variáveis de configuração.
+
+Esta página cobre todas as diferentes opções de configuração disponíveis em um arquivo TSConfig. Ela começa com uma visão geral de todas as configurações, depois passa pelos atributos principais que estão na raiz do arquivo JSON, então fala sobre as `compilerOptions`, que são a maioria das opções e finaliza com as `watchOptions`.

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

@@ -0,0 +1,39 @@
+---
+display: "Permitir JS"
+oneline: "Permite que o TS inclua arquivos .JS nos imports"
+---
+
+Permite que arquivos JavaScript sejam importados dentro do seu projeto ao invés de só permitir arquivos `.ts` e `.tsx`. Por exemplo, este arquivo JS:
+
+```js twoslash
+// @filename: carta.js
+export const naipePadrao = "Copas";
+```
+
+Quando importado em um arquivo TypeScript, vai emitir um erro:
+
+```ts twoslash
+// @errors: 2307
+// @filename: carta.js
+module.exports.naipePadrao = "Copas";
+// ---cut---
+// @filename: index.ts
+import { naipePadrao } from "./carta";
+
+console.log(naipePadrao);
+```
+
+Mas é importado normalmente com a opção `allowJS` ativada:
+
+```ts twoslash
+// @filename: carta.js
+module.exports.naipePadrao = "Copas";
+// ---cut---
+// @allowJs
+// @filename: index.ts
+import { naipePadrao } from "./carta";
+
+console.log(naipePadrao);
+```
+
+Esta opção pode ser utilizada como uma forma de migrar um projeto JavaScript para TypeScript de forma incremental. Permitindo que arquivos `.ts` e `.tsx` coexistam no mesmo projeto que os arquivos JavaScript.

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

@@ -0,0 +1,21 @@
+---
+display: "Permitir Imports Sintéticos Padrão"
+oneline: "Permite 'import x from y' quando um módulo não tem um export padrão"
+---
+
+Quando está ativo, `allowSyntheticDefaultImports` permite que você escreva um import como:
+
+```ts
+import React from "react";
+```
+
+Ao invés de:
+
+```ts
+import * as React from "react";
+```
+
+Quando o módulo **não** especifica um export padrão.
+
+Isso não afeta o JavaScript que será emitido no TypeScript, somente a checagem de tipos
+Essa opção traz o comportamento do TypeScript in-line com o Babel, onde código extra é emitido no final para que o uso de um export padrão seja mais ergonômico.

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

@@ -0,0 +1,8 @@
+---
+display: "Permitir Acesso Global UMD"
+oneline: "Assume que todos os imports UMD estão disponíveis globalmente"
+---
+
+Quando setado para `true`, a flag `allowUmdGlobalAccess` deixa que você acesse todos os exports UMD como globais de dentro dos arquivos de módulo. Um arquivo de módulo é um arquivo que tem imports e/ou exports. Sem essa configuração, usando um export de dentro de um módulo UMD vai pedir uma declaração de import.
+
+Um caso de exemplo para essa flag seria um projeto web onde você sabe que uma biblioteca em particular (como o jQuery ou Lodash) vai estar sempre disponível em runtime, mas você não pode acessá-la com um import.

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

@@ -0,0 +1,41 @@
+---
+display: "Permitir Código Não Executado"
+oneline: "Exibe um erro quando o código nunca será executado"
+---
+
+Quando:
+
+- `undefined` (padrão) dá sugestões como avisos para o editor
+- `true` todo o código não executável é ignorado
+- `false` exibe um erro de compilação quando código não executável é detectado
+
+Mude para false para desabilitar os avisos sobre código não executável.
+Estes avisos são somente sobre código que são provavelmente inalcançáveis e nunca serão executados por conta do uso da sintaxe do JavaScript como, por exemplo:
+
+```ts
+function fn(n: number) {
+  if (n > 5) {
+    return true;
+  } else {
+    return false;
+  }
+  return true;
+}
+```
+
+Com `"allowUnreachableCode": false`:
+
+```ts twoslash
+// @errors: 7027
+// @allowUnreachableCode: false
+function fn(n: number) {
+  if (n > 5) {
+    return true;
+  } else {
+    return false;
+  }
+  return true;
+}
+```
+
+Isso não afeta os erros exibidos com base em código que _parece_ ser inalcançável devido à análise de tipos.

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

@@ -0,0 +1,19 @@
+---
+display: "Permitir Labels Não Utilizadas"
+oneline: "Exibe um erro quando uma label é criada acidentalmente"
+---
+
+Defina como false para desabilitar os avisos sobre labels não utilizadas.
+
+Labels são muito raras no JavaScript e, tipicamente, indicam uma tentativa de escrever um objeto literal:
+
+```ts twoslash
+// @errors: 7028
+// @allowUnusedLabels: false
+function verificarIdade(idade: number) {
+  // Esquecemos o 'return'
+  if (idade > 18) {
+    verificado: true;
+  }
+}
+```

packages/tsconfig-reference/copy/pt/sections/compilerOptions.md

@@ -0,0 +1,3 @@
+### Opções do compilador
+
+Essas são a maioria das opções do TypeScript e descrevem como o compilador deve funcionar.

packages/tsconfig-reference/copy/pt/sections/top_level.md

@@ -0,0 +1,3 @@
+### Campos Raiz
+
+Para começar, temos algumas opções na raiz do TSConfig - essas opções são relacionadas a como seu projeto TypeScript ou JavaScript está configurado.