boottent-design 0.1.258 → 0.1.259

package/README.md

@@ -292,10 +292,19 @@ npm 인증 토큰은 레포 파일에 커밋하지 않고 환경변수로만 주
 
 ```sh
 # 소비 레포(boottent-frontend 등)에서
+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
+
+# npm 사용 소비처
+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 --no-scaffold         # design.md 자동 생성 비활성화
 ```
 
-소비처는 자체 `docs/design.md`(허브로 연결, 앱 전용 확장 기록)를 소유하고, `docs/ds/`는 sync가 덮어쓰는 SSOT 미러다.
+소비처는 자체 `docs/design.md`(허브로 연결, 앱 전용 확장 기록)를 소유하고, `docs/ds/`는 sync가 덮어쓰는 SSOT 미러다. `init --postinstall`을 한 번 실행하면 이후 `yarn install` / `yarn upgrade boottent-design` 때 최신 DS 문서가 자동으로 다시 동기화된다.
 자세한 연동/업그레이드 루프는 [docs/SSOT-INTEGRATION.md](docs/SSOT-INTEGRATION.md)를 참조하세요.

package/bin/sync-docs.mjs

@@ -8,11 +8,13 @@
  *
  * 사용법:
  *   boottent-design-docs sync [--out <dir>] [--design-doc <path>] [--no-scaffold]
+ *   boottent-design-docs init [--out <dir>] [--design-doc <path>] [--no-scaffold] [--postinstall]
  *
  * 옵션:
  *   --out <dir>          SSOT 미러 출력 디렉터리 (기본: docs/ds)
  *   --design-doc <path>  소비처 소유 design.md 경로 (기본: docs/design.md). 없을 때만 생성.
  *   --no-scaffold        design.md scaffold 비활성화
+ *   --postinstall        소비처 package.json에 install/update 후 자동 sync 스크립트 추가
  *   --help               이 도움말
  */
 import fs from "node:fs";
@@ -28,22 +30,26 @@ const SRC_DOCS = path.join(PKG_ROOT, "dist", "design-system");
 
 const DEFAULT_OUT = "docs/ds";
 const DEFAULT_DESIGN_DOC = "docs/design.md";
+const SYNC_COMMAND = "boottent-design-docs sync";
 
 function printHelp() {
   console.log(`boottent-design-docs — DS 문서 SSOT 동기화
 
 사용법:
   boottent-design-docs sync [--out <dir>] [--design-doc <path>] [--no-scaffold]
+  boottent-design-docs init [--out <dir>] [--design-doc <path>] [--no-scaffold] [--postinstall]
 
 옵션:
   --out <dir>          SSOT 미러 출력 디렉터리 (기본: ${DEFAULT_OUT})
   --design-doc <path>  소비처 소유 design.md 경로 (기본: ${DEFAULT_DESIGN_DOC}). 없을 때만 생성.
   --no-scaffold        design.md scaffold 비활성화
+  --postinstall        소비처 package.json에 install/update 후 자동 sync 스크립트 추가
   --help               이 도움말
 
 동작:
-  설치된 boottent-design 의 dist/design-system/ (허브 + 스포크 스탬프본)를 <dir> 로 재귀 복사하고,
-  소비처 design.md 가 없으면 허브로 연결되는 시작 템플릿을 생성합니다.`);
+  sync: 설치된 boottent-design 의 dist/design-system/ (허브 + 스포크 스탬프본)를 <dir> 로 미러링하고,
+        소비처 design.md 가 없으면 허브로 연결되는 시작 템플릿을 생성합니다.
+  init: sync를 먼저 실행한 뒤, --postinstall 지정 시 소비처 package.json에 자동 동기화 스크립트를 추가합니다.`);
 }
 
 function getPkgVersion() {
@@ -61,6 +67,7 @@ function parseArgs(argv) {
     out: DEFAULT_OUT,
     designDoc: DEFAULT_DESIGN_DOC,
     scaffold: true,
+    postinstall: false,
     help: false,
   };
   for (let i = 0; i < argv.length; i++) {
@@ -69,6 +76,7 @@ function parseArgs(argv) {
     else if (arg === "--out" || arg === "-o") args.out = argv[++i];
     else if (arg === "--design-doc") args.designDoc = argv[++i];
     else if (arg === "--no-scaffold") args.scaffold = false;
+    else if (arg === "--postinstall") args.postinstall = true;
     else if (!arg.startsWith("-") && !args.command) args.command = arg;
   }
   return args;
@@ -79,6 +87,10 @@ function fail(message) {
   process.exit(1);
 }
 
+function normalizeRelPath(filePath) {
+  return filePath.split(path.sep).join("/");
+}
+
 /** 디렉터리 트리를 재귀 복사한다. */
 function copyTree(srcDir, destDir) {
   fs.mkdirSync(destDir, { recursive: true });
@@ -96,6 +108,17 @@ function copyTree(srcDir, destDir) {
   return count;
 }
 
+function mirrorDocs(srcDir, destDir) {
+  const cwd = process.cwd();
+  const resolvedDest = path.resolve(destDir);
+  if (resolvedDest === cwd) {
+    fail(`미러 출력 디렉터리로 현재 작업 디렉터리 자체를 사용할 수 없습니다: ${resolvedDest}`);
+  }
+
+  fs.rmSync(resolvedDest, { recursive: true, force: true });
+  return copyTree(srcDir, resolvedDest);
+}
+
 /** 소비처가 소유하는 design.md 시작 템플릿. */
 function designDocTemplate(version, outRel, generatedAt) {
   const hub = path.posix.join(outRel, "design-system.md");
@@ -122,6 +145,71 @@ UI는 [boottent-design](https://boottent.com)을 **단일 진실 원천(SSOT)**
 `;
 }
 
+function getSyncCommand(args) {
+  const parts = [];
+  if (args.out !== DEFAULT_OUT) parts.push("--out", args.out);
+  if (args.designDoc !== DEFAULT_DESIGN_DOC) parts.push("--design-doc", args.designDoc);
+  if (!args.scaffold) parts.push("--no-scaffold");
+  const suffix = parts.map((part) => (/\s/.test(part) ? JSON.stringify(part) : part)).join(" ");
+  return suffix ? `${SYNC_COMMAND} ${suffix}` : SYNC_COMMAND;
+}
+
+function readPackageJson(packageJsonPath) {
+  try {
+    return JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+  } catch (error) {
+    fail(`package.json을 읽을 수 없습니다: ${packageJsonPath}\n  ${error.message}`);
+  }
+}
+
+function writePackageJson(packageJsonPath, pkg) {
+  fs.writeFileSync(packageJsonPath, `${JSON.stringify(pkg, null, 2)}\n`);
+}
+
+function commandIncludesSync(command) {
+  return typeof command === "string" && command.includes(SYNC_COMMAND);
+}
+
+function installPackageScripts(args) {
+  const packageJsonPath = path.resolve(process.cwd(), "package.json");
+  if (!fs.existsSync(packageJsonPath)) {
+    fail("--postinstall을 사용하려면 소비처 루트에 package.json이 있어야 합니다.");
+  }
+
+  const pkg = readPackageJson(packageJsonPath);
+  const scripts = pkg.scripts && typeof pkg.scripts === "object" ? pkg.scripts : {};
+  pkg.scripts = scripts;
+
+  const syncCommand = getSyncCommand(args);
+  let changed = false;
+
+  if (!scripts["docs:ds"]) {
+    scripts["docs:ds"] = syncCommand;
+    changed = true;
+    console.log(`  package.json: scripts.docs:ds 추가 (${syncCommand})`);
+  } else {
+    console.log("  package.json: scripts.docs:ds 이미 존재 — 보존");
+  }
+
+  if (!scripts.postinstall) {
+    scripts.postinstall = syncCommand;
+    changed = true;
+    console.log(`  package.json: scripts.postinstall 추가 (${syncCommand})`);
+  } else if (commandIncludesSync(scripts.postinstall)) {
+    console.log("  package.json: scripts.postinstall 이미 DS sync 포함 — 보존");
+  } else {
+    scripts.postinstall = `${scripts.postinstall} && ${syncCommand}`;
+    changed = true;
+    console.log("  package.json: scripts.postinstall에 DS sync 추가");
+  }
+
+  if (changed) {
+    writePackageJson(packageJsonPath, pkg);
+  } else {
+    console.log("  package.json: 변경 없음");
+  }
+}
+
 function sync(args) {
   if (!fs.existsSync(SRC_DOCS)) {
     fail(
@@ -134,8 +222,8 @@ function sync(args) {
   const generatedAt = new Date().toLocaleString("ko-KR");
   const absOut = path.resolve(process.cwd(), args.out);
 
-  const count = copyTree(SRC_DOCS, absOut);
-  const outRel = path.relative(process.cwd(), absOut) || ".";
+  const count = mirrorDocs(SRC_DOCS, absOut);
+  const outRel = normalizeRelPath(path.relative(process.cwd(), absOut) || ".");
 
   console.log(`✓ boottent-design v${version} 문서 동기화 완료`);
   console.log(`  미러: ${outRel}/  (${count} files)`);
@@ -144,7 +232,9 @@ function sync(args) {
   if (args.scaffold) {
     const absDesign = path.resolve(process.cwd(), args.designDoc);
     if (fs.existsSync(absDesign)) {
-      console.log(`  design.md: 이미 존재 — 건너뜀 (${path.relative(process.cwd(), absDesign)})`);
+      console.log(
+        `  design.md: 이미 존재 — 건너뜀 (${normalizeRelPath(path.relative(process.cwd(), absDesign))})`,
+      );
     } else {
       fs.mkdirSync(path.dirname(absDesign), { recursive: true });
       // design.md 위치에서 미러 디렉터리로 가는 상대경로
@@ -153,11 +243,22 @@ function sync(args) {
         absOut.split(path.sep).join("/"),
       );
       fs.writeFileSync(absDesign, designDocTemplate(version, relToOut || ".", generatedAt));
-      console.log(`  design.md: 생성 (${path.relative(process.cwd(), absDesign)})`);
+      console.log(`  design.md: 생성 (${normalizeRelPath(path.relative(process.cwd(), absDesign))})`);
     }
   }
 }
 
+function init(args) {
+  sync(args);
+
+  if (args.postinstall) {
+    installPackageScripts(args);
+  } else {
+    console.log("  package.json: --postinstall 미지정 — 자동 sync 스크립트 추가 안 함");
+    console.log("  자동 sync가 필요하면 다시 실행: boottent-design-docs init --postinstall");
+  }
+}
+
 function main() {
   const args = parseArgs(process.argv.slice(2));
 
@@ -171,6 +272,11 @@ function main() {
     return;
   }
 
+  if (args.command === "init") {
+    init(args);
+    return;
+  }
+
   console.error(`알 수 없는 명령: ${args.command}\n`);
   printHelp();
   process.exit(1);

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

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > 조합형 컴포넌트 — article-asset-card.
-> 버전: boottent-design v0.1.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 

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

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > boottent-design 허브 — 먼저 이 문서를 읽고 필요한 스포크 문서로 이동하라.
-> 버전: boottent-design v0.1.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 ## 0. 원칙 (먼저 읽어라)
 

package/dist/design-system/tokens.md

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

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

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — accordion.
-> 버전: boottent-design v0.1.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../design-system.md) · [언제 무엇을 쓰나](../when-to-use.md)
 
@@ -26,7 +26,7 @@ import { /* ... */ } from "boottent-design/ui/toggle-group";
 
 ### Props
 ```typescript
-interface ToggleGroupContextProps extends VariantProps<typeof toggleVariants> {}
+type ToggleGroupContextProps = VariantProps<typeof toggleVariants>;
 ```
 
 ### 예시

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

@@ -3,7 +3,7 @@
 > [!WARNING]
 > **자동 생성된 파일 — 직접 수정 금지** (`yarn docs:gen` 으로 재생성)
 > UI 프리미티브 — toggle.
-> 버전: boottent-design v0.1.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 허브](../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.257 · 생성: 2026. 6. 11. 오후 4:37:12
+> 버전: boottent-design v0.1.259 · 생성: 2026. 6. 11. 오후 5:57:42
 
 [← 디자인 시스템 허브](./design-system.md)
 

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

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

package/dist/ui/progress.es.js

@@ -13,18 +13,9 @@ const m = n.forwardRef(
         "aria-valuenow": r,
         "aria-valuemin": 0,
         "aria-valuemax": a,
-        className: l(
-          "relative h-2 w-full overflow-hidden rounded-full bg-muted",
-          i
-        ),
+        className: l("relative h-2 w-full overflow-hidden rounded-full bg-muted", i),
         ...o,
-        children: /* @__PURE__ */ e(
-          "div",
-          {
-            className: "h-full bg-primary transition-all duration-300 ease-in-out",
-            style: { width: `${t}%` }
-          }
-        )
+        children: /* @__PURE__ */ e("div", { className: "h-full bg-primary transition-all duration-300 ease-in-out", style: { width: `${t}%` } })
       }
     );
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "boottent-design",
-  "version": "0.1.258",
+  "version": "0.1.259",
   "description": "부트텐트 디자인시스템 라이브러리",
   "repository": {
     "type": "git",