webmcp-types는 WebMCP 명세에 정의된 타입을 제공하는 TypeScript 선언 파일 패키지다. 기존 dom 타입 정의를 WebMCP 타입으로 확장할 때 사용할 수 있으며, TypeScript 5.0 이상이 필요하다.
패키지는 npm, yarn, pnpm으로 설치할 수 있다.
- npm:
npm install --save-dev webmcp-types - yarn:
yarn add --dev webmcp-types - pnpm:
pnpm add -D webmcp-types
DefinitelyTyped 외부 패키지이므로 TypeScript가 의존성을 자동으로 불러오지 않는다. tsconfig.json의 compilerOptions에 types를 지정하거나 typeRoots에 패키지 경로를 추가해야 한다.
{
// ...
"compilerOptions": {
// ...
"types": ["webmcp-types"]
}
}
또는 다음처럼 typeRoots를 설정할 수 있다.
{
// ...
"compilerOptions": {
// ...
"typeRoots": ["./node_modules/webmcp-types", "./node_modules/@types"]
}
}
도구 체인이 tsconfig.json을 읽지 않는 경우에는 TypeScript 파일에 다음 참조를 넣는 방법도 있다.
/// <reference types="webmcp-types" />
Webpack을 사용하고 앞선 설정만으로 충분하지 않다면 webpack.config.js에 다음 설정이 필요할 수 있다. 다만 이 방법은 검증되지 않았다고 패키지 문서는 밝힌다.
"types": ["webmcp-types"]
타입 테스트는 npm install과 npm test로 실행할 수 있다. index.test-d.ts 테스트는 Vitest의 타입 검사 모드에서 tsconfig.json을 기준으로 정적으로 검사하며, 실제 실행되지는 않는다.
새 npm 버전은 Conventional Commits를 바탕으로 Release Please가 릴리스 풀 리퀘스트와 변경 기록을 관리한다. 이를 병합하면 GitHub 릴리스가 생성되고 npm trusted publishing으로 배포되므로 npm 토큰이나 로컬 배포 단계가 필요하지 않다. 프로젝트 저장소는 webmcp-types다.
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요