타입스크립트에서 타입스크립트의 라이브러리 관리 방법은 무엇인가요?

1. Q: TypeScript 내장 라이브러리(`lib`)란 무엇인가요?
A: TypeScript가 기본 제공하는 전역 API 타입 정의 집합입니다. 예를 들어 `DOM`, `ES2015`, `ESNext`, `WebWorker` 등이 있으며, 브라우저나 Node, WebWorker 등 실행 환경의 전역 객체·인터페이스를 정의합니다.

2. Q: 내장 라이브러리는 어떻게 활성화·비활성화하나요?
A: tsconfig.json의 `compilerOptions.lib` 배열에 사용할 라이브러리 이름을 나열합니다. 예:
```json
{
"compilerOptions": {
"lib": ["ES2019", "DOM"]
}
}
```
지정하지 않으면 기본값(`["ES5","DOM"]`)이 사용됩니다.

3. Q: 외부 npm 패키지의 타입 선언은 어떻게 관리하나요?
A: 보통 DefinitelyTyped 저장소에 올라간 `@types/패키지명`을 설치합니다.
```bash
npm install --save-dev @types/lodash
```
이 후 tsconfig.json의 `typeRoots` 또는 `types` 옵션을 통해 자동으로 인식시킵니다.

4. Q: tsconfig.json에서 `typeRoots`와 `types`의 차이는 무엇인가요?
A:
- `typeRoots`: 타입 선언이 위치한 디렉터리 경로 목록(`node_modules/@types` 외에 추가 경로 지정 가능).
- `types`: 컴파일러가 로드할 타입 패키지 이름 목록. 지정 시 목록에 없는 `@types/*`는 무시됩니다.

5. Q: 직접 만든 라이브러리(모듈)의 타입 선언은 어떻게 처리하나요? A:
1) `.d.ts` 파일에 `declare module 'my-lib' { … }` 형태로 작성 후 프로젝트 루트 또는 별도 타입 디렉터리에 배치.
2) tsconfig.json `typeRoots`에 해당 디렉터리 추가.
3) 또는 라이브러리 패키지 배포 시 `package.json`에 `"types": "dist/index.d.ts"` 필드를 지정합니다.

6. Q: 프로젝트 전역 타입 선언(.d.ts)은 어떻게 구성하나요?
A: 보통 `src/types` 또는 `typings` 폴더를 만들고 `.d.ts` 파일을 넣습니다. tsconfig.json `include`에 해당 폴더를 추가하거나 `typeRoots`에 등록해 자동으로 포함시킵니다.

7. Q: 모듈 내부에서 전역 확장(ambient augmentation)을 하려면?
A:
- 전역 객체 확장: `declare global { interface Window { myProp: string } }`
- 모듈 내부 확장: `declare module 'express' { interface Request { user?: User } }`
파일 최상단에 `export {}`를 추가해 모듈 스코프로 만듭니다.

8. Q: Triple-slash 지시문(/// )은 언제 쓰나요?
A: 전통적인 방식으로 상대 경로의 `.d.ts`를 수동 참조할 때 사용합니다. 다만 tsconfig.json 설정으로 자동 인식이 가능하므로, 유지보수 규모가 작을 때만 제한적으로 활용하는 것이 좋습니다.

9. Q: 라이브러리 버전 충돌 문제는 어떻게 해결하나요?
A:
- `npm ls @types/패키지`로 중복 버전을 확인.
- `resolutions`(Yarn) 또는 `overrides`(npm)로 특정 버전 강제 지정.
- 직접 호환 가능한 `@types` 버전을 설치하거나, 필요 시 자체 `.d.ts`를 작성합니다.

10. Q: 모노레포(Monorepo) 환경에서 타입 선언 관리는 어떻게 하나요?
A:
1) 각 패키지별로 tsconfig.json을 두되, 공통 설정은 루트에 `tsconfig.base.json`으로 분리.
2) `composite` 옵션과 `references`를 사용해 빌드 순서를 정의.
3) 루트 `typeRoots`나 `paths`를 통해 공통 타입 선언을 공유합니다.

타입스크립트에서 타입스크립트의 빌드 프로세스는 어떻게 되나요?

타입스크립트에서 커스텀 타입을 만드는 방법은 무엇인가요?

타입스크립트(TypeScript)는 자바스크립트의 상위 집합으로, 정적 타입을 지원하여 코드의 안정성과 가독성을 높이는 데 도움을 줍니다.

타입스크립트의 라이브러리 관리 방법은 여러 가지가 있으며, 이 과정에서 주의해야 할 몇 가지 중요한 사항이 있습니다.

아래에서는 타입스크립트의 라이브러리 관리 방법에 대해 자세히 설명하겠습니다.

1. 패키지 매니저 사용 타입스크립트 프로젝트에서 라이브러리를 관리하는 가장 일반적인 방법은 패키지 매니저를 사용하는 것입니다.

주로 사용되는 패키지 매니저는 npm(Node Package Manager)과 Yarn이 있습니다.

- npm : Node.js와 함께 설치되는 기본 패키지 매니저로, `package.json` 파일을 통해 프로젝트의 의존성을 관리합니다.

- Yarn : Facebook에서 개발한 패키지 매니저로, npm보다 빠른 설치 속도와 더 나은 의존성 관리 기능을 제공합니다.

패키지 설치 타입스크립트 라이브러리를 설치할 때는 다음과 같은 명령어를 사용합니다.

```bash npm install ``` 또는 Yarn을 사용하는 경우: ```bash yarn add ```

2. 타입 정의 파일 타입스크립트는 자바스크립트 라이브러리와 함께 사용할 때, 해당 라이브러리의 타입 정보를 제공하는 타입 정의 파일이 필요합니다.

이러한 타입 정의 파일은 `.d.ts` 확장자를 가지며, 일반적으로 DefinitelyTyped라는 저장소에서 관리됩니다.

타입 정의 파일을 설치하는 방법은 다음과 같습니다.

```bash npm install @types/ ``` 또는 Yarn을 사용하는 경우: ```bash yarn add @types/ ``` 예를 들어, `lodash` 라이브러리를 사용하는 경우, 다음과 같이 설치할 수 있습니다.

```bash npm install lodash npm install @types/lodash ```

3. `tsconfig.json` 설정 타입스크립트 프로젝트의 설정은 `tsconfig.json` 파일을 통해 관리됩니다.

이 파일에서는 컴파일러 옵션, 포함할 파일 및 제외할 파일 등을 설정할 수 있습니다.

라이브러리를 사용할 때는 `tsconfig.json` 파일에서 `typeRoots` 및 `types` 옵션을 설정하여 타입 정의 파일의 경로를 지정할 수 있습니다.

```json { "compilerOptions": { "typeRoots": ["node_modules/@types"], "types": ["lodash"] } } ```

4. 모듈 시스템 타입스크립트는 ES6 모듈 시스템을 지원합니다.

이를 통해 라이브러리의 기능을 필요에 따라 가져오고 사용할 수 있습니다.

예를 들어, `lodash`의 `map` 함수를 사용하려면 다음과 같이 작성할 수 있습니다.

```typescript import { map } from 'lodash'; const numbers = [1, 2, 3]; const doubled = map(numbers, n => n *

2); ```

5. 버전 관리 타입스크립트 라이브러리를 관리할 때는 버전 관리가 중요합니다.

라이브러리의 버전을 명시적으로 지정하여, 프로젝트의 안정성을 유지할 수 있습니다.

`package.json` 파일에서 의존성의 버전을 다음과 같이 설정할 수 있습니다.

```json "dependencies": { "lodash": "^4.17.21" } ``` 여기서 `^` 기호는 해당 버전 이상의 최신 버전을 허용한다는 의미입니다.

필요에 따라 `~` 기호를 사용하여 특정 마이너 버전 내에서만 업데이트되도록 설정할 수도 있습니다.



6. 업데이트 및 유지 관리 정기적으로 의존성을 업데이트하고 유지 관리하는 것은 프로젝트의 안정성과 보안을 유지하는 데 중요합니다.

npm에서는 다음 명령어를 사용하여 모든 패키지를 업데이트할 수 있습니다.

```bash npm update ``` Yarn을 사용하는 경우: ```bash yarn upgrade ```

7. 커스텀 타입 정의 타입스크립트 라이브러리를 사용할 때, 때로는 외부 라이브러리의 타입 정의가 부족하거나 필요하지 않은 경우가 있습니다.

이럴 때는 커스텀 타입 정의 파일을 작성하여 사용할 수 있습니다.

프로젝트의 루트 디렉토리에 `types` 폴더를 만들고, 그 안에 필요한 타입 정의 파일을 추가합니다.

```typescript // types/custom.d.ts declare module 'some-library' { export function someFunction(param: string): number; } ``` 이렇게 작성한 타입 정의 파일은 `tsconfig.json`의 `include` 옵션에 추가하여 타입스크립트 컴파일러가 인식하도록 할 수 있습니다.

결론 타입스크립트에서 라이브러리를 관리하는 방법은 패키지 매니저를 사용하여 의존성을 설치하고, 타입 정의 파일을 추가하며, `tsconfig.json`을 통해 설정을 관리하는 것입니다.

또한, 버전 관리와 정기적인 업데이트를 통해 프로젝트의 안정성을 유지하는 것이 중요합니다.

이러한 방법을 통해 타입스크립트 프로젝트에서 라이브러리를 효율적으로 관리할 수 있습니다.