설치

환경 요구 사항

• Vue 2.7(마지막 버전; 2.6 이하는 지원하지 않으며, IE11 도 지원하지 않습니다)
• Node 20 + pnpm 10 권장

패키지 매니저로 설치

npm install @lh-ui/vue2
# 또는
pnpm add @lh-ui/vue2
# 또는
yarn add @lh-ui/vue2

@lh-ui/vue2 의 유일한 런타임 의존성은 @lh-ui/share(공유층: core 순수 함수 / theme / constants / locales / types / 컴포넌트 스타일 소스)이며, 자동으로 함께 설치됩니다.

사설 서버에서 설치

패키지가 공개 registry 가 아닌 사설 서버에 호스팅된 경우, 다음 방법 중 하나로 설치합니다.

방법 1: tarball 직접 링크

서버가 정적 파일 호스팅만 제공해도 됩니다. npm pack 으로 생성한 lh-ui-vue2-x.y.z.tgz 를 서버 디렉터리에 놓고 다음을 실행합니다.

npm install https://your-domain/pkg/lh-ui-vue2-1.0.0.tgz
# 또는
pnpm add https://your-domain/pkg/lh-ui-vue2-1.0.0.tgz
# 또는
yarn add https://your-domain/pkg/lh-ui-vue2-1.0.0.tgz

tarball 직접 링크 방식에서는 @lh-ui/share 가 여전히 현재 registry 에서 해석되므로, 해당 패키지가 공개 registry 또는 사설 registry 에서 보이는지 확인해야 합니다.

방법 2: 자체 구축 registry (예: Verdaccio)

자체 구축 registry 는 semver 기반 가져오기와 버전 관리를 지원합니다. 프로젝트 루트의 .npmrc 에서 scope 단위로 라우팅을 설정합니다 (다른 패키지의 설치 소스에는 영향을 주지 않습니다).

@lh-ui:registry=https://your-domain/

그 다음 평소대로 설치합니다.

pnpm add @lh-ui/vue2

스타일 수동 불러오기

// 테마 변수(라이트 + 다크)
import '@lh-ui/vue2/theme.css'
// 컴포넌트별 스타일을 개별적으로 불러오기 (선택 — 전체 엔트리에도 포함되어 있음)
import '@lh-ui/vue2/style/button'

버전 정책

• @lh-ui/share 업그레이드는 「share 가 먼저 릴리스 → UI 라이브러리가 업그레이드하여 회귀 → 그 다음 릴리스」라는 규율을 따라야 합니다.
• 현재 상태: @lh-ui/vue2 는 1.0.0 을 릴리스했고, @lh-ui/share 는 0.1.0 입니다.