프로젝트 소개

CompoMo는 @ds-mo/ui로 발행되는 프레임워크 중립 웹 컴포넌트 라이브러리입니다. Stencil.js로 빌드되고 TokoMo 디자인 토큰으로 스타일링되며, 커스텀 엘리먼트와 생성된 Angular, React, Vue 어댑터로 배포됩니다. ds-mo 패밀리의 일부로, @ds-mo/tokens 및 @ds-mo/icons와 함께 제공됩니다. 설치 시 세 가지 패키지가 함께 들어갑니다: @ds-mo/tokens, @ds-mo/icons, @ds-mo/ui. TokoMo 토큰은 앱 루트에서 한 번만 가져옵니다(tokens, tokens/reset, tokens/globals). 사용은 각 프레임워크에 따릅니다. 일반 HTML에서는 컴포넌트 모듈을 가져오면 커스텀 엘리먼트가 자동으로 정의되므로, label 속성과 함께 ds-button-filled 태그를 바로 사용할 수 있습니다. Angular 애플리케이션은 개별 컴포넌트 독립형 어댑터(@ds-mo/ui/angular/ds-button-filled)를 가져오는 것이 권장됩니다. React와 Vue는 각각 @ds-mo/ui/react 및 @ds-mo/ui/vue의 생성된 래퍼를 사용합니다. 아이콘은 @ds-mo/icons를 통해 해결되며, ds-icon은 번들 시점의 IcoMo 내 정확히 일치하는 정규 이름을 사용합니다. 이 라이브러리는 몇 가지 공개 지원 표면(@ds-mo/ui/shell: 프레임워크 중립 셸 계약, @ds-mo/ui/toast: 토스트 매니저, @ds-mo/ui/utils: registerIcons 등의 일반 유틸리티, @ds-mo/ui/prose.css: 렌더러 중립 시맨틱 프로즈 스타일링, @ds-mo/ui/control-elevation.css: 상승된 외부 컨트롤 래퍼)을 문서로 남깁니다. 전역 컴포넌트 CSS 번들은 의도적으로 없으며, 스타일은 각 커스텀 엘리먼트와 함께 배송됩니다. 브라우저 지원 측면에서 CompoMo는 이동하는 'Baseline Newly available' 집합을 대상으로 합니다. 컴포넌트는 Baseline 코어 브라우저에서 상호 운용 가능해질 때 웹 플랫폼 기능을 채택할 수 있으며, 구버전 브라우저 릴리스를 사용하는 소비자는 자체 대체수단을 제공하거나 이전 호환 릴리스를 유지해야 합니다. 주의할 만한 추가 기능으로 compomo-mcp가 있습니다. 이 로컬 실행 파일은 패키지 동봉으로, 커스텀 엘리먼트, Angular, React, Vue에 대한 생성된 컴포넌트 메타데이터와 실행 가능한 컴포지션 레시피를 노출하며, MCP 서버로 등록할 수 있습니다(Codex 구성 파일에 node_modules/.bin/compomo-mcp 포인팅). stdio 전용이며 현대 2026-07-28 프로토콜과 2025-11-25까지의 레거시 initialize 기반_revision_을 모두 제공하며, 현대 발견을 지원하는 클라이언트에는 자동 버전 협상이 권장됩니다. README는 API 사실은 Stencil 메타데이터에서, 선별된 의도는 동일 위치 컴포넌트 에이전트 JSON과 실행 가능 패턴에서 온다고 명시합니다. 문서화는 Storybook 소개, 프레임워크 통합 가이드, v13 마이그레이션 가이드, 유지관리자 문서 라우터, AGENTS.md 내 저장소 지침으로 나뉩니다. README는 패키지 버전, 컴포넌트 목록, props, 이벤트, 내보내기를 중복 기술하지 않으며, 현재 사실은 package.json, Storybook, 또는 생성된 레지스트리를 참조하도록 안내합니다.