boottent-design 0.1.270 → 0.1.271

package/README.md

@@ -280,6 +280,7 @@ npm 인증 토큰은 레포 파일에 커밋하지 않고 환경변수로만 주
 | 결정 가이드 | `docs/design-system/when-to-use.md` | 어떤 상황에 어떤 컴포넌트를 쓰는가 |
 | 사용법 | `docs/design-system/usage.md` | 설치 · CSS 배포 모드 · presentational 소비 규칙 |
 | 토큰 | `docs/design-system/tokens.md` | 색상 · 타이포 · 기타 토큰 |
+| 소비 레포 셋업 가이드 | `docs/design-system/consumer-setup.md` | 소비 레포가 이 문서 체계를 자기 레포에 세팅하는 방법(자동 동기화 포함) |
 | UI 스포크 | `docs/design-system/ui/<name>.md` | UI 프리미티브당 1파일 |
 | 조합형 스포크 | `docs/design-system/components/<name>.md` | 조합형 컴포넌트당 1파일 |
 
@@ -288,11 +289,13 @@ npm 인증 토큰은 레포 파일에 커밋하지 않고 환경변수로만 주
 - `/ds-docs-check` (slash) — 읽기전용 sync 리포트 · `/ds-docs-sync` (slash) — 재생성 + 누락 JSDoc·결정 엔트리 초안 작성.
 - husky `pre-commit`이 커밋 시 문서를 자동 재생성·stage 한다.
 
-**소비 레포**는 동봉된 `boottent-design-docs` CLI로 dist 스탬프본을 자기 레포로 동기화한다.
+**소비 레포는 별도 명령 없이 자동으로 동기화된다.** `boottent-design` 패키지 자체가 `postinstall` 훅을 갖고 있어서, `yarn add boottent-design` / `yarn install` / `yarn upgrade boottent-design`을 실행하는 즉시 소비 레포의 `docs/ds/`가 최신 dist 스탬프본으로 채워지고, `docs/design.md`가 없으면 시작 템플릿이 생긴다(이미 있으면 절대 덮어쓰지 않음). 이 훅은 실패해도 설치 자체를 막지 않는다. 자세한 안내는 npm에도 함께 배포되는 [docs/design-system/consumer-setup.md](docs/design-system/consumer-setup.md)(설치 후 `node_modules/boottent-design/dist/design-system/consumer-setup.md`에서 바로 열람 가능)를 보라.
+
+동봉된 `boottent-design-docs` CLI는 수동 재실행이나, 소비 레포 자신의 package.json에 `docs:ds`/`postinstall` 스크립트를 명시적으로 남기고 싶을 때 쓴다:
 
 ```sh
-# 소비 레포(boottent-frontend 등)에서
-yarn boottent-design-docs init --postinstall    # docs/ds/ 초기화 + docs/design.md scaffold + install/update 자동 sync 설정
+# 소비 레포(boottent-frontend 등)에서 — package.json에 스크립트도 남기고 싶을 때
+yarn boottent-design-docs init --postinstall    # docs/ds/ 초기화 + docs/design.md scaffold + install/update 자동 sync 스크립트 추가
 
 # boottent-design이 아직 설치 전이면
 yarn dlx -p boottent-design boottent-design-docs init --postinstall
@@ -303,8 +306,9 @@ npx -p boottent-design boottent-design-docs init --postinstall
 # 수동 동기화만 필요할 때
 boottent-design-docs sync                       # docs/ds/ 로 미러 복사 + docs/design.md scaffold(없을 때만)
 boottent-design-docs sync --out docs/design     # 미러 경로 변경
+boottent-design-docs sync --design-doc docs/design-guide.md  # design.md 자리에 다른 문서가 이미 있을 때 경로 변경
 boottent-design-docs sync --no-scaffold         # design.md 자동 생성 비활성화
 ```
 
-소비처는 자체 `docs/design.md`(허브로 연결, 앱 전용 확장 기록)를 소유하고, `docs/ds/`는 sync가 덮어쓰는 SSOT 미러다. `init --postinstall`을 한 번 실행하면 이후 `yarn install` / `yarn upgrade boottent-design` 때 최신 DS 문서가 자동으로 다시 동기화된다.
+소비처는 자체 `docs/design.md`(허브로 연결, 앱 전용 확장 기록)를 소유하고, `docs/ds/`는 sync가 덮어쓰는 SSOT 미러다.
 자세한 연동/업그레이드 루프는 [docs/SSOT-INTEGRATION.md](docs/SSOT-INTEGRATION.md)를 참조하세요.

package/bin/postinstall-sync.mjs

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * boottent-design 자체 설치 후 자동 실행되는 훅(package.json "postinstall").
+ *
+ * 소비 레포가 아무 명령도 실행하지 않아도 docs/ds/ 미러 + docs/design.md 스캐폴드가
+ * 생기도록 한다(bin/sync-docs.mjs의 "sync" 로직을 그대로 재사용, 수정하지 않는다).
+ *
+ * 반드시 지키는 것: 이 훅이 실패해도 소비처의 yarn/npm install 자체는 절대 막지 않는다.
+ * 전체를 try/catch로 감싸고 항상 exit(0)한다.
+ */
+import { execFileSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = path.join(__dirname, "..");
+
+function readJson(filePath) {
+  return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+}
+
+try {
+  // npm/yarn이 install을 실행한 원래 위치(소비 레포 루트). 패키지 자신의
+  // node_modules/boottent-design 디렉터리가 아니다.
+  const targetRoot = process.env.INIT_CWD || process.cwd();
+  const targetPkgPath = path.join(targetRoot, "package.json");
+
+  if (!fs.existsSync(targetPkgPath)) {
+    process.exit(0); // 소비처 package.json을 찾을 수 없음 — 조용히 스킵
+  }
+
+  const targetPkg = readJson(targetPkgPath);
+  if (targetPkg.name === "boottent-design") {
+    process.exit(0); // 이 저장소 자체 개발 중(yarn install) — 자기 자신에 미러링하지 않음
+  }
+
+  const syncScript = path.join(PKG_ROOT, "bin", "sync-docs.mjs");
+  execFileSync(process.execPath, [syncScript, "sync"], {
+    cwd: targetRoot,
+    stdio: "inherit",
+  });
+} catch (error) {
+  console.warn(
+    "boottent-design: 문서 자동 동기화를 건너뜁니다 (설치는 정상 진행됩니다). 수동 실행: npx boottent-design-docs sync",
+  );
+  console.warn(`  (${error?.message ?? error})`);
+}
+
+process.exit(0);

package/dist/design-system/components/article-asset-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — article-asset-card.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/blog-review-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — blog-review-card.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/boottent-event-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — boottent-event-card.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/camp-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — camp-card.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/company-info-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — company-info-card.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/dday-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — dday-card.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/environment-asset-photo.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — environment-asset-photo.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/event-asset-banner.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — event-asset-banner.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/event-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — event-card.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/lecturer-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — lecturer-card.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/main-banner-image.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — main-banner-image.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/mobile-camp-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — mobile-camp-card.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/partner-list-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — partner-list-card.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/portfolio-asset-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — portfolio-asset-card.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/premium-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — premium-card.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/title-tag-card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — title-tag-card.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/components/youtube-video-modal.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — youtube-video-modal.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/consumer-setup.md

@@ -0,0 +1,45 @@
+# consumer-setup.md — boottent-design
+
+> [!WARNING]
+> **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
+> 소비 레포(boottent-frontend, boottent-partner 등)가 이 문서 체계를 자기 레포에 세팅하는 방법.
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
+
+[← 디자인 시스템 허브](./design-system.md)
+
+> 이 문서는 **소비 레포**용이다. `boottent-design` 저장소 자체에는 적용하지 않는다.
+
+## 자동 동기화 (별도 명령 불필요)
+
+`boottent-design`은 패키지 자체 `postinstall` 훅을 갖고 있다. `yarn add boottent-design` / `yarn install` / `yarn upgrade boottent-design`을 실행하면 그때마다 자동으로:
+
+- 소비 레포 루트에 `docs/ds/`를 만들고(이미 있으면 최신 내용으로 덮어씀),
+- `docs/design.md`가 없으면 시작 템플릿을 만든다(이미 있으면 **절대 덮어쓰지 않음**).
+
+**아무 명령도 실행할 필요가 없다** — 설치/업그레이드만 하면 된다. 이 훅은 실패해도(권한 문제 등) 설치 자체를 막지 않고 콘솔에 경고만 남긴다.
+
+## (선택) 소비 레포 package.json에 스크립트로도 남기기
+
+`docs:ds`/`postinstall` 스크립트를 소비 레포 자신의 package.json에도 명시적으로 남기고 싶다면(가시성·수동 재실행 편의):
+
+```sh
+yarn boottent-design-docs init --postinstall
+```
+
+이미 `docs/design.md`가 있으면 건드리지 않고, `docs/ds/`만 다시 미러링한다.
+
+## 파일명이 이미 쓰이고 있다면
+
+`docs/design.md` 자리에 이미 다른 문서가 있다면(대소문자만 다른 경우도 포함 — macOS는 기본적으로 대소문자를 구분하지 않는 파일시스템이라 `docs/DESIGN.md`와 `docs/design.md`는 같은 파일로 취급된다) `--design-doc`으로 다른 경로를 지정한다:
+
+```sh
+yarn boottent-design-docs init --design-doc docs/design-guide.md --postinstall
+```
+
+## 커밋 정책
+
+`docs/ds/`와 `docs/design.md`는 **커밋한다.** PR/리뷰에서 어떤 DS 버전 기준인지 드러나고, 업그레이드 시 diff로 변경이 보인다. `docs/ds/`는 매번 전체가 덮어써지는 미러이므로 손으로 편집하지 않는다.
+
+## 더 자세히
+
+전체 CLI 옵션·업그레이드 루프·로컬 `file:` 링크 개발 시나리오는 저장소의 `docs/SSOT-INTEGRATION.md`(GitHub)를 참고하라.

package/dist/design-system/design-system.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > boottent-design 허브 — 먼저 이 문서를 읽고 필요한 스포크 문서로 이동하라.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 ## 0. 원칙 (먼저 읽어라)
 
@@ -29,6 +29,7 @@ boottent-design은 모든 소비 앱의 **단일 진실 원천(SSOT)** 이다. U
 | 특정 컴포넌트의 props·variants·예시 | `ui/<name>.md` · `components/<name>.md` |
 | 색·타이포·간격 값 | [tokens.md](./tokens.md) |
 | 설치 · CSS 모드 · 소비 규칙 | [usage.md](./usage.md) |
+| 소비 레포에 이 문서 체계를 어떻게 셋업하나 | [consumer-setup.md](./consumer-setup.md) |
 | 우리 앱 전용 디자인 확장 규칙 | (소비처) `../design.md` |
 
 ## 3. 레이어 구조

package/dist/design-system/tokens.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 디자인 토큰 — 색상 · 타이포그래피 · 기타.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 디자인 시스템 허브](./design-system.md)
 

package/dist/design-system/ui/accordion.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — accordion.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/alert-dialog.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — alert-dialog.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/anchor.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — anchor.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/aspect-ratio.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — aspect-ratio.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/avatar.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — avatar.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/badge.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — badge.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/button.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — button.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/calendar.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — calendar.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/callout.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — callout.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/card-label.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — card-label.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/card.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — card.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/checkbox.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — checkbox.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/circled-check-button.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — circled-check-button.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/command.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — command.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/dialog.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — dialog.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/dropdown-menu.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — dropdown-menu.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/file-uploader.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — file-uploader.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/form.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — form.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/highlight-text.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — highlight-text.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/icons.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — icons.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/image.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — image.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/input.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — input.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/label.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — label.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/month-picker.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — month-picker.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/multi-select.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — multi-select.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/navigation-menu.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — navigation-menu.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/popover.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — popover.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/portal.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — portal.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/progress.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — progress.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/radio-group.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — radio-group.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/scroll-area.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — scroll-area.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/select.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — select.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/separator.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — separator.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/simple-table.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — simple-table.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/skeleton.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — skeleton.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/slider.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — slider.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/switch.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — switch.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/symbols.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — symbols.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/tabs.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — tabs.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/tag.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — tag.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/text.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — text.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/textarea.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — textarea.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/toast.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — toast.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/toggle-group.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — toggle-group.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/toggle.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — toggle.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/ui/tooltip.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — tooltip.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

package/dist/design-system/usage.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 설치 · CSS 배포 모드 · 소비 규칙의 기계 생성 정본.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 디자인 시스템 허브](./design-system.md)
 

package/dist/design-system/when-to-use.md

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 어떤 상황에 어떤 컴포넌트를 쓰는가 — 결정 가이드.
-> 버전: boottent-design v0.1.270 · 생성: 2026. 7. 13. 오후 6:10:02
+> 버전: boottent-design v0.1.271 · 생성: 2026. 7. 14. 오후 12:00:30
 
 [← 디자인 시스템 허브](./design-system.md)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "boottent-design",
-  "version": "0.1.270",
+  "version": "0.1.271",
   "description": "부트텐트 디자인시스템 라이브러리",
   "repository": {
     "type": "git",
@@ -83,6 +83,7 @@
     "storybook:test": "storybook test --url http://localhost:6006",
     "stories:check": "node scripts/check-story-coverage.mjs",
     "preview": "vite preview",
+    "postinstall": "node ./bin/postinstall-sync.mjs",
     "prepare": "husky",
     "prepublishOnly": "yarn run build",
     "chromatic": "npx chromatic --only-changed --project-token=$CHROMATIC_PROJECT_TOKEN --storybook-build-dir=.cache/storybook-static",