0Pricing
TypeScript Academy · 강의

타입이 포함된 패키지 배포

일급 타입 정의를 포함한 라이브러리를 배포합니다. tsc로 .d.ts를 생성하고 package.json에서 해당 파일을 가리키며 ESM/CJS 내보내기를 처리하고 배포 전에 테스트합니다.

타입이 포함된 패키지 배포은(는) CoddyKit의 무료 TypeScript Academy 강의입니다. 이것은 2개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 TypeScript Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. TypeScript Academy 강의에는 총 2개의 강의가 포함되어 있습니다.

소개

목표: 견고한 타입 선언이 포함된 패키지를 배포합니다. .d.ts 파일을 출력하고, package.json을 올바르게 연결하며, exports를 통해 ESM/CJS를 지원하고, 예제 앱에서 tsc --noEmit으로 확인합니다.

  • 선언 파일 출력
  • types 지정(또는 항목별 exports 지정)
  • 배포 전 테스트

선언 파일 출력

declaration을 활성화해 .d.ts를 출력하십시오. 전용 빌드 구성을 사용해 앱의 tsconfig를 엄격하고 깔끔하게 유지하십시오.

// tsconfig.build.json
{
  "compilerOptions": {
    "target": "ES2020",
    "module": "ESNext",
    "declaration": true,
    "emitDeclarationOnly": false,
    "outDir": "dist",
    "rootDir": "src",
    "stripInternal": true
  },
  "include": ["src/**/*"]
}

package.json의 types/exports

루트 선언 파일을 가리키도록 types를 설정하십시오. 하위 경로를 내보낼 때는 types 항목을 포함해야 편집기가 모듈별 .d.ts를 찾을 수 있습니다.

// package.json
{
  "name": "@acme/widgets",
  "version": "1.0.0",
  "type": "module",
  "main": "./dist/index.cjs",
  "module": "./dist/index.js",
  "types": "./dist/index.d.ts",
  "exports": {
    ".": {
      "types": "./dist/index.d.ts",
      "import": "./dist/index.js",
      "require": "./dist/index.cjs"
    },
    "./utils": {
      "types": "./dist/utils.d.ts",
      "import": "./dist/utils.js",
      "require": "./dist/utils.cjs"
    }
  }
}

소스와 .d.ts

공개 API에 타입이 올바르게 지정되어 있는지 확인하십시오. 선언은 소스 시그니처를 반영하므로 사용자는 자동 완성과 타입 검사를 이용할 수 있습니다.

// src/index.ts
export interface Widget { id: string; name: string }
export function greet(w: Widget): string { return `Hello, ${w.name}` }

// dist/index.d.ts (emitted)
export interface Widget { id: string; name: string }
export declare function greet(w: Widget): string

사용 프로젝트에서 테스트

배포하기 전에 tsc --noEmit을 사용하는 작은 사용자 프로젝트에서 테스트하십시오. 잘못된 사용에 대해 올바른 오류가 발생해야 합니다.

// consumer/tsconfig.json
{
  "compilerOptions": { "strict": true, "target": "ES2020", "module": "ESNext" },
  "include": ["./src"]
}

// consumer/src/app.ts
import { greet } from "@acme/widgets"

// Type checks in the consumer
console.log(greet({ id: "w1", name: "Ada" }))
// @ts-expect-error: missing name
// console.log(greet({ id: "w1" }))

팁 및 주의점

팁:

  • 항목별 types가 포함된 하위 경로 exports를 우선 사용하십시오.
  • 내부 타입은 내보내지 않거나 @internal로 표시하십시오.
  • npm publish 전에 빌드하도록 prepare 스크립트를 사용하십시오.

타입 배포 확인

빠른 확인: 타입을 노출하는 최소한의 올바른 설정은 무엇입니까?

요약

요약: tsc로 선언 파일을 출력하고, package.json(types/exports)을 연결한 뒤, 배포 전에 사용자 앱에서 확인하십시오.

자주 묻는 질문

“타입이 포함된 패키지 배포” 강의는 무료인가요?

네 — “타입이 포함된 패키지 배포” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 TypeScript Academy 강의 전체를 잠금 해제할 수 있습니다. TypeScript Academy 강의에는 총 2개의 강의가 포함되어 있습니다.

“타입이 포함된 패키지 배포”에서 뭘 배우나요?

일급 타입 정의를 포함한 라이브러리를 배포합니다. tsc로 .d.ts를 생성하고 package.json에서 해당 파일을 가리키며 ESM/CJS 내보내기를 처리하고 배포 전에 테스트합니다. 브라우저에서 직접 실행하는 실습 코드로 TypeScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

TypeScript Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 TypeScript Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 2개 중 2번째 강의입니다.

“타입이 포함된 패키지 배포” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 TypeScript Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 TypeScript Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. .d.ts 기초; export type과 export
  2. 타입이 포함된 패키지 배포
← TypeScript Academy(으)로 돌아가기