Foundations

API Stability

글로벌 대기업·전사 시스템에서 안심하고 도입할 수 있도록 명시된 안정성·버전·지원 정책.

Stability tiers

모든 컴포넌트는 다음 4단계 중 하나의 안정성 레벨을 가집니다.

Stable

프로덕션 사용 권장. 메이저 버전(예: 1.x → 2.x) 안에서는 breaking change 없음. Breaking change 시 최소 6개월 deprecation 경고 후 제거.

현재: Button · Card · Input · Dialog · Sheet · Tabs · Dropdown · Sonner

Beta

프로덕션 사용 가능. 마이너 버전에서 API 변경 가능성 있음. 변경 시 changelog 에 명시 + 마이그레이션 가이드 제공.

현재: Alert · Accordion · Avatar · Checkbox · Switch · Select · Progress · Tooltip · Table · Skeleton

Experimental

테스트 / 평가용. 프로덕션 비권장. API 가 빠르게 변할 수 있음.

현재: (현재 없음)

Deprecated

신규 사용 비권장. 최소 12개월 보안 패치 보장 후 제거. 대체 컴포넌트 명시.

현재: (현재 없음)

엔터프라이즈 시스템 운영에 필요한 핵심 보장.

모든 npm 의존성은 정확한 버전(예: @base-ui/react@1.5.0)으로 명시됩니다. 자동 업데이트를 막아 예측 가능한 시스템 동작을 보장합니다.

Stable API 가 변경될 때는 최소 6개월(메이저 한 사이클) 동안 console warning 으로 안내합니다. Deprecated 컴포넌트는 12개월 동안 보안 패치만 받습니다.

각 컴포넌트의 'Dependencies' 섹션에서 호환되는 의존성 버전을 확인할 수 있습니다. 의존성 업데이트가 필요한 경우 Compatibility Matrix 를 우선 확인.

CVE 발견 시 24시간 내 patch 릴리스 + GitHub Security Advisory 공지. 사용자는 본인 프로젝트의 lockfile 을 정기 audit 권장.

Groudit UI 는 Semantic Versioning 2.0 을 따릅니다.

변경 종류	의미	사용자 액션
`x.y.Z` Patch	버그 수정만. 동작 보장.	없음
`x.Y.0` Minor	새 기능 추가. 기존 동작 유지.	선택
`X.0.0` Major	Breaking change. 마이그레이션 가이드 제공.	필수 검증

각 컴포넌트 페이지의 Dependencies 섹션에서 정확한 의존성 버전을 확인하세요.