Merge pull request #5 from microsoft/main

Update

Author: Nabster101

docs/playground/ko/3-7/Fixits/Infer From Usage Changes.ts

@@ -0,0 +1,37 @@
+//// { compiler: {  noImplicitAny: false }, order: 2 }
+
+// TypeScript 3.7 버전에 있는 '사용법에서 추론한' 코드 수정은
+// 더욱 똑똑해졌습니다. 이제부터는 알려진 중요한 
+// 타입(문자열, 숫자, 배열, 프로미스)의 리스트로 사용되며, 
+// 이러한 객체의 API와 일치하는 타입의 사용에 따라
+// 유추합니다. 
+
+// 다음과 같은 예시에서, 함수의 매개변수를 선택하고
+// 전구를 클릭하여, "Infer Parameter types..."를 
+// 선택합니다.
+
+// 숫자 배열을 유추합니다:
+
+function pushNumber(arr) {
+  arr.push(12);
+}
+
+// 프로미스를 유추합니다:
+
+function awaitPromise(promise) {
+  promise.then((value) => console.log(value));
+}
+
+// 함수와 반환 타입을 유추합니다:
+
+function inferAny(app) {
+  const result = app.use("hi");
+  return result;
+}
+
+// 문자열이 추가 되었음으로, 
+// 문자열 배열로 유추합니다:
+
+function insertString(names) {
+  names[1] = "hello";
+}

docs/playground/ko/3-7/Syntax and Messaging/Flattened Error Reporting.ts

@@ -0,0 +1,63 @@
+//// { compiler: {  }, order: 3 }
+
+// TypeScript의 오류 메시지는 가끔 필요 이상으로 상세할 수 있습니다...
+// 3.7 버전에서, 몇 가지 터무니없는 사례를 보실 수 있습니다.
+
+// 중첩 속성
+
+let a = { b: { c: { d: { e: "string" } } } };
+let b = { b: { c: { d: { e: 12 } } } };
+
+a = b;
+
+// 이전에는, 중첩된 속성 당 두 줄의 코드였기에,
+// 오류 메시지의 첫 번째와 마지막 줄을 읽음으로써
+// 빠르게 오류 메시지를 읽는 방법을 배웠습니다. 
+
+// 이제는 인라인입니다:
+
+// 3.6 버전에서는 다음과 같습니다:
+//
+// Type '{ b: { c: { d: { e: number; }; }; }; }' is not assignable to type '{ b: { c: { d: { e: string; }; }; }; }'.
+//   Types of property 'b' are incompatible.
+//     Type '{ c: { d: { e: number; }; }; }' is not assignable to type '{ c: { d: { e: string; }; }; }'.
+//       Types of property 'c' are incompatible.
+//         Type '{ d: { e: number; }; }' is not assignable to type '{ d: { e: string; }; }'.
+//           Types of property 'd' are incompatible.
+//             Type '{ e: number; }' is not assignable to type '{ e: string; }'.
+//               Types of property 'e' are incompatible.
+//                 Type 'number' is not assignable to type 'string'
+
+// 유용하고 간결한 오류 메시지를 제공하여,
+// 객체의 여러 타입을 통해 작업을 처리할 수 있습니다.
+
+class ExampleClass {
+  state = "ok";
+}
+
+class OtherClass {
+  state = 12;
+}
+
+let x = { a: { b: { c: { d: { e: { f: ExampleClass } } } } } };
+let y = { a: { b: { c: { d: { e: { f: OtherClass } } } } } };
+x = y;
+
+// 3.6 버전에서는 다음과 같습니다:
+//
+// Type '{ a: { b: { c: { d: { e: { f: typeof OtherClass; }; }; }; }; }; }' is not assignable to type '{ a: { b: { c: { d: { e: { f: typeof ExampleClass; }; }; }; }; }; }'.
+//   Types of property 'a' are incompatible.
+//     Type '{ b: { c: { d: { e: { f: typeof OtherClass; }; }; }; }; }' is not assignable to type '{ b: { c: { d: { e: { f: typeof ExampleClass; }; }; }; }; }'.
+//       Types of property 'b' are incompatible.
+//         Type '{ c: { d: { e: { f: typeof OtherClass; }; }; }; }' is not assignable to type '{ c: { d: { e: { f: typeof ExampleClass; }; }; }; }'.
+//           Types of property 'c' are incompatible.
+//             Type '{ d: { e: { f: typeof OtherClass; }; }; }' is not assignable to type '{ d: { e: { f: typeof ExampleClass; }; }; }'.
+//               Types of property 'd' are incompatible.
+//                 Type '{ e: { f: typeof OtherClass; }; }' is not assignable to type '{ e: { f: typeof ExampleClass; }; }'.
+//                   Types of property 'e' are incompatible.
+//                     Type '{ f: typeof OtherClass; }' is not assignable to type '{ f: typeof ExampleClass; }'.
+//                       Types of property 'f' are incompatible.
+//                         Type 'typeof OtherClass' is not assignable to type 'typeof ExampleClass'.
+//                           Type 'OtherClass' is not assignable to type 'ExampleClass'.
+//                             Types of property 'state' are incompatible.
+//                               Type 'number' is not assignable to type 'string'

docs/playground/ko/JavaScript/Functions with JavaScript/Function Chaining.ts

@@ -0,0 +1,81 @@
+//// { order: 2, compiler: { esModuleInterop: true } }
+
+// 함수 체이닝 API는 JavaScript에서 흔한 패턴으로,
+// JavaScript 의 중첩 특성으로 인해
+// 중간값을 줄이고 가독성을 높혀
+// 코드를 집중시킬 수 있습니다.
+
+// 체이닝으로 동작하는 흔한 API는 jQuery입니다.
+// DefinitelyTyped의 타입과 함께 사용한
+// jQuery 예시입니다.:
+
+import $ from "jquery";
+
+// jQuery API 사용 예시:
+
+$("#navigation").css("background", "red").height(300).fadeIn(200);
+
+// 위 라인에 점을 추가해보면,
+// 긴 함수 리스트를 보게 될 것입니다.
+// 이 패턴은 JavaScript에서 쉽게 재현할 수 있습니다.
+// 핵심은 반드시 항상 같은 오브젝트를 반환하는 것입니다.
+
+// 여기 체이닝 API를 만드는 API 예시가 있습니다.
+// 핵심은 내부 상태를 파악하고 있는 외부 함수와
+// 항상 자신을 반환하는 API를
+// 노출하는 오브젝트를 갖는 것입니다.
+
+const addTwoNumbers = (start = 1) => {
+  let n = start;
+
+  const api = {
+    // API에 있는 각 함수를 실행하세요
+    add(inc: number = 1) {
+      n += inc;
+      return api;
+    },
+
+    print() {
+      console.log(n);
+      return api;
+    },
+  };
+  return api;
+};
+
+// jQuery에서 본 것처럼
+// 같은 스타일의 API를 허용:
+
+addTwoNumbers(1).add(3).add().print().add(1);
+
+// 클래스를 사용하는 비슷한 예시:
+
+class AddNumbers {
+  private n: number;
+
+  constructor(start = 0) {
+    this.n = start;
+  }
+
+  public add(inc = 1) {
+    this.n = this.n + inc;
+    return this;
+  }
+
+  public print() {
+    console.log(this.n);
+    return this;
+  }
+}
+
+// 여기에서 동작:
+
+new AddNumbers(2).add(3).add().print().add(1);
+
+// 이 예시는 JavaScript 패턴에
+// 도구를 제공하는 방법을 제공하기 위해서
+// TypeScript 타입 추론을 사용했습니다.
+
+// 더 많은 예시:
+//
+//  - example:code-flow

docs/tsconfig/it/options/noEmit.md

@@ -0,0 +1,10 @@
+---
+display: "Non genera"
+oneline: "Non genera file da una compilazione"
+---
+
+Il compilatore non genera file di output come ad esempio codice JavaScript, source maps o dichiarazioni.
+
+Questo fa spazio per altri strumenti come [Babel](https://babeljs.io) o [swc](https://github.com/swc-project/swc) per gestire la conversione di un file TypeScript in un file che può essere eseguito in un ambiente JavaScript
+
+Puoi usare TypeScript come uno strumento che ti offre un integrazione da parte dell'editor e un codice sorgente tipizzato.

docs/tsconfig/it/options/outFile.md

@@ -0,0 +1,11 @@
+---
+display: "File di output"
+oneline: "Crea un solo file js che contiene tutti i file concatenati"
+---
+
+Se specificato, tutti i file  _global_ (non moduli) verranno concatenati in un unico file output specificato.
+
+Se `module` è `system` o `amd`, tutti i file _module_ saranno concatenati in questo file dopo tutto il contenuto globale.
+
+Nota: `outFile` non può essere a meno che `module` è `None`, `System`, o `AMD`.
+Questa opzione _non può_ essere usata insieme a CommonJS o moduli ES6.

docs/tsconfig/it/options/plugins.md

@@ -0,0 +1,17 @@
+---
+display: "Plugins"
+oneline: "La lista dei plugin inclusi nel codice"
+---
+
+Lista dei language service plugin da eseguire all'interno dell'editor.
+
+I language service plugin sono un modo di dare più informazioni all'utente riguardo i file TypeScript esistenti. Loro possono sfruttare i messaggi di TypeScript e dell'editor per creare i loro errori.
+
+Per esempio:
+
+- [ts-sql-plugin](https://github.com/xialvjun/ts-sql-plugin#readme) — Aggiunge Linting SQL con un generatore di stringhe SQL.
+- [typescript-styled-plugin](https://github.com/Microsoft/typescript-styled-plugin) — Aggiunge Linting CSS all'interno delle stringhe di template.
+- [typescript-eslint-language-service](https://github.com/Quramy/typescript-eslint-language-service) — Da un errore di eslint e il corrispettivo fix all'interno dell'output del compilatore.
+- [ts-graphql-plugin](https://github.com/Quramy/ts-graphql-plugin) — Da validazione e autocompletamento all'interno delle stringhe con query GraphQL.
+
+VS Code ha l'abilità grazie alle estensioni di [includere automaticamente i language service plugin](https://code.visualstudio.com/api/references/contribution-points#contributes.typescriptServerPlugins), quindi è probabile che ne stai già eseguendo alcuni nel tuo editor senza aver bisogno di definirli nel `tsconfig.json`.

docs/tsconfig/ko/options/composite.md

@@ -0,0 +1,16 @@
+---
+display: "Composite"
+oneline: "Enable constraints that allow a TypeScript project to be used with project references."
+---
+
+`composite` 옵션은 아직 빌드되지 않은 프로젝트의 빠른 빌드 설정을 위해 빌드 도구(`—build` 모드에서 TypeScript를 포함한)에 특정 조건을 적용합니다.
+
+이 설정이 켜져 있으면:
+
+- 만약 `rootDir` 설정이 설정되어 있지 않다면, 기본값은 'tsconfig.json' 파일을 포함하는 디렉터리입니다.
+
+- 모든 실행 파일은 `include` 패턴과 일치하거나 `파일` 배열에 나열되어야 합니다. 만약 이 제약 조건을 위반하면, 'tsc'는 지정되지 않은 파일을 알려줍니다.
+
+- `declaration`의 기본값은 `true` 입니다.
+
+TypeScript 프로젝트에 대한 문서는 [핸드북](https://www.typescriptlang.org/docs/handbook/project-references.html)에서 확인할 수 있습니다.

docs/tsconfig/ko/options/jsxImportSource.md

@@ -0,0 +1,95 @@
+---
+display: "jsxImportSource"
+oneline: "Specify module specifier used to import the JSX factory functions when using `jsx: react-jsx*`.`"
+---
+
+Typescript 4.1 버전에 소개된 [jsx](#jsx)를 `"react-jsx"` 또는 `"react-jsxdev"`로 사용할 때, `jsx` 와 `jsxs` 팩터리 함수를 import 하는데 사용할 모듈 지정자를 선언합니다.
+
+[React 17](https://reactjs.org/blog/2020/09/22/introducing-the-new-jsx-transform.html)에서, 라이브러리는 독립된 import를 통하여 새로운 형태의 JSX 변환을 지원해 줍니다.
+
+예를 들어: 
+
+```tsx
+import React from "react";
+
+function App() {
+  return <h1>Hello World</h1>;
+}
+```
+
+TSConfig 사용할 때:
+
+```json tsconfig
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "commonjs",
+    "jsx": "react-jsx"
+  }
+}
+```
+
+TypeScript에서 컴파일 된 JavaScript는:
+
+```tsx twoslash
+// @showEmit
+// @noErrors
+// @jsx: react-jsx
+// @module: commonjs
+// @target: esnext
+declare module JSX {
+  interface Element {}
+  interface IntrinsicElements {
+    [s: string]: any;
+  }
+}
+import React from "react";
+
+function App() {
+  return <h1>Hello World</h1>;
+}
+```
+
+예를 들어, `"jsxImportSource": "preact"`를 사용하고 싶으시면, 다음과 같은 tsconfig를 이용하시면 됩니다:
+
+```json tsconfig
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "commonjs",
+    "jsx": "react-jsx",
+    "jsxImportSource": "preact",
+    "types": ["preact"]
+  }
+}
+```
+
+다음과 같은 코드를 생성합니다:
+
+```tsx twoslash
+// @showEmit
+// @jsxImportSource: preact
+// @types: preact
+// @jsx: react-jsx
+// @target: esnext
+// @module: commonjs
+// @noErrors
+
+export function App() {
+  return <h1>Hello World</h1>;
+}
+```
+
+또는, 파일 별 프래그마(per-file pragma)를 이용하여 다음과 같은 옵션을 설정할 수 있습니다:
+
+```tsx
+/** @jsxImportSource preact */
+
+export function App() {
+  return <h1>Hello World</h1>;
+}
+```
+
+`_jsx`팩토리를 위한 import로서 `preact/jsx-runtime`를 추가합니다.
+
+_노트:_ 의도한 대로 작동이 되려면, `tsx`파일은 `export` 또는 `import`를 추가해야만, 모듈로 간주됩니다.

docs/tsconfig/ko/options/listFiles.md

@@ -0,0 +1,40 @@
+---
+display: "List Files"
+oneline: "Print all of the files read during the compilation."
+---
+
+컴파일하는 파일 이름을 출력합니다. 
+이 기능은 TypeScript에 예상한 파일이 포함되어 있는지 확실하지 않을 때 유용합니다.
+
+예를들면:
+
+```
+example
+├── index.ts
+├── package.json
+└── tsconfig.json
+```
+
+다음과 같습니다:
+
+```json tsconfig
+{
+  "compilerOptions": {
+    "listFiles": true
+  }
+}
+```
+
+echo paths는 다음과 같습니다:
+
+```
+$ npm run tsc
+path/to/example/node_modules/typescript/lib/lib.d.ts
+path/to/example/node_modules/typescript/lib/lib.es5.d.ts
+path/to/example/node_modules/typescript/lib/lib.dom.d.ts
+path/to/example/node_modules/typescript/lib/lib.webworker.importscripts.d.ts
+path/to/example/node_modules/typescript/lib/lib.scripthost.d.ts
+path/to/example/index.ts
+```
+
+TypeScript 4.2 버전을 사용할 경우 [`explainFiles`](#explainFiles)을 참조하십시오. 파일이 추가된 이유에 대한 설명 또한 제공합니다.

docs/tsconfig/ko/sections/top_level.md

@@ -0,0 +1,3 @@
+### 루트 필드(Root Fields)
+
+TSConfig의 시작은 루트 옵션입니다 - 이 옵션은 TypeScript 또는 JavaScript 프로젝트 설정과 관련이 있습니다.