boottent-design 0.1.270 → 0.1.272

package/README.md

@@ -280,19 +280,23 @@ 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파일 |
 
 **문서 sync 도구** (이 레포에서):
 - `yarn docs:gen` — 추적 문서 재생성 · `yarn docs:check` — 소스와 sync 검사(deep-entry·토큰·결정 매트릭스·freshness).
 - `/ds-docs-check` (slash) — 읽기전용 sync 리포트 · `/ds-docs-sync` (slash) — 재생성 + 누락 JSDoc·결정 엔트리 초안 작성.
+- `/ds-release` (slash) — DS 변경사항 publish(버전 bump·빌드·docs 재생성·커밋·push·npm publish) + 소비 레포(boottent-frontend/boottent-partner/boottent-partner-frontend) 업그레이드 대상 확인 후 반영까지 자동화.
 - 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 +307,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/components/lecturer-card.cjs.js

@@ -1 +1 @@
-"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../lecturer-card-D4nR3tgq.cjs");exports.LecturerCard=e.LecturerCard;
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../lecturer-card-C0AeVE2l.cjs");exports.LecturerCard=e.LecturerCard;

package/dist/components/lecturer-card.es.js

@@ -1,5 +1,5 @@
 "use client";
-import { L as t } from "../lecturer-card-DaAD77e-.js";
+import { L as t } from "../lecturer-card-h44ZjbBL.js";
 export {
   t as LecturerCard
 };

package/dist/components.cjs.js

@@ -1 +1 @@
-"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./dday-card-D5SqIn0Y.cjs"),a=require("./event-card-D3wzSDI2.cjs"),o=require("./main-banner-image-By44s_XP.cjs"),n=require("./premium-card-CThRJYXd.cjs"),i=require("./title-tag-card-C-AvnXtC.cjs"),d=require("./article-asset-card-DRRl2BH8.cjs"),C=require("./blog-review-card-OX6KhSpS.cjs"),s=require("./boottent-event-card-Bx4iFf2w.cjs"),m=require("./camp-card-DM2V71SW.cjs"),e=require("./camp-card-format-rjZZu4G6.cjs"),u=require("./company-info-card-BXAempVI.cjs"),c=require("./environment-asset-photo-CXxtAAax.cjs"),l=require("./event-asset-banner-m607rLD9.cjs"),p=require("./lecturer-card-D4nR3tgq.cjs"),T=require("./partner-list-card-DL_omz4v.cjs"),f=require("./mobile-camp-card-D-5N6bex.cjs"),r=require("./portfolio-asset-card-8mBpumTp.cjs"),A=require("./youtube-video-modal-C2GWcF5u.cjs");exports.DdayCard=t.DdayCard;exports.EventCard=a.EventCard;exports.MainBannerImage=o.MainBannerImage;exports.PremiumCard=n.PremiumCard;exports.TitleTagCard=i.TitleTagCard;exports.ArticleAssetCard=d.ArticleAssetCard;exports.BlogReviewCard=C.BlogReviewCard;exports.BoottentEventCard=s.BoottentEventCard;exports.CampCard=m.CampCard;exports.formatCampCardDateText=e.formatCampCardDateText;exports.formatCampCardLocationText=e.formatCampCardLocationText;exports.formatCampCardPeriodText=e.formatCampCardPeriodText;exports.formatCampCardScheduleText=e.formatCampCardScheduleText;exports.formatCampCardTuitionText=e.formatCampCardTuitionText;exports.formatTuitionAmountText=e.formatTuitionAmountText;exports.isEarlyBirdApplied=e.isEarlyBirdApplied;exports.CompanyInfoCard=u.CompanyInfoCard;exports.EnvironmentAssetPhoto=c.EnvironmentAssetPhoto;exports.EventAssetBanner=l.EventAssetBanner;exports.LecturerCard=p.LecturerCard;exports.PartnerListCard=T.PartnerListCard;exports.MobileCampCard=f.MobileCampCard;exports.PortfolioAssetCard=r.PortfolioAssetCard;exports.PortfolioAssetFooter=r.PortfolioAssetFooter;exports.YoutubeVideoModal=A.YoutubeVideoModal;
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./dday-card-D5SqIn0Y.cjs"),a=require("./event-card-D3wzSDI2.cjs"),o=require("./main-banner-image-By44s_XP.cjs"),n=require("./premium-card-CThRJYXd.cjs"),i=require("./title-tag-card-C-AvnXtC.cjs"),d=require("./article-asset-card-DRRl2BH8.cjs"),C=require("./blog-review-card-OX6KhSpS.cjs"),s=require("./boottent-event-card-Bx4iFf2w.cjs"),m=require("./camp-card-DM2V71SW.cjs"),e=require("./camp-card-format-rjZZu4G6.cjs"),u=require("./company-info-card-BXAempVI.cjs"),c=require("./environment-asset-photo-CXxtAAax.cjs"),l=require("./event-asset-banner-m607rLD9.cjs"),p=require("./lecturer-card-C0AeVE2l.cjs"),T=require("./partner-list-card-DL_omz4v.cjs"),f=require("./mobile-camp-card-D-5N6bex.cjs"),r=require("./portfolio-asset-card-8mBpumTp.cjs"),A=require("./youtube-video-modal-C2GWcF5u.cjs");exports.DdayCard=t.DdayCard;exports.EventCard=a.EventCard;exports.MainBannerImage=o.MainBannerImage;exports.PremiumCard=n.PremiumCard;exports.TitleTagCard=i.TitleTagCard;exports.ArticleAssetCard=d.ArticleAssetCard;exports.BlogReviewCard=C.BlogReviewCard;exports.BoottentEventCard=s.BoottentEventCard;exports.CampCard=m.CampCard;exports.formatCampCardDateText=e.formatCampCardDateText;exports.formatCampCardLocationText=e.formatCampCardLocationText;exports.formatCampCardPeriodText=e.formatCampCardPeriodText;exports.formatCampCardScheduleText=e.formatCampCardScheduleText;exports.formatCampCardTuitionText=e.formatCampCardTuitionText;exports.formatTuitionAmountText=e.formatTuitionAmountText;exports.isEarlyBirdApplied=e.isEarlyBirdApplied;exports.CompanyInfoCard=u.CompanyInfoCard;exports.EnvironmentAssetPhoto=c.EnvironmentAssetPhoto;exports.EventAssetBanner=l.EventAssetBanner;exports.LecturerCard=p.LecturerCard;exports.PartnerListCard=T.PartnerListCard;exports.MobileCampCard=f.MobileCampCard;exports.PortfolioAssetCard=r.PortfolioAssetCard;exports.PortfolioAssetFooter=r.PortfolioAssetFooter;exports.YoutubeVideoModal=A.YoutubeVideoModal;

package/dist/components.es.js

@@ -12,7 +12,7 @@ import { f as B, a as c, b as v, c as M, d as L, e as b, i as g } from "./camp-c
 import { C as D } from "./company-info-card-DJTgItPu.js";
 import { E as I } from "./environment-asset-photo-BCR9v2we.js";
 import { E as w } from "./event-asset-banner-BW6nZaJq.js";
-import { L as R } from "./lecturer-card-DaAD77e-.js";
+import { L as R } from "./lecturer-card-h44ZjbBL.js";
 import { P as V } from "./partner-list-card-Bx-UZxGG.js";
 import { M as k } from "./mobile-camp-card-1dxI-BCc.js";
 import { P as z, a as G } from "./portfolio-asset-card-mAkXH6Qc.js";

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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
+
+[← 디자인 시스템 허브](./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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 ## 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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 디자인 시스템 허브](./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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 허브](../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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 디자인 시스템 허브](./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.272 · 생성: 2026. 7. 15. 오전 10:40:04
 
 [← 디자인 시스템 허브](./design-system.md)
 

package/dist/{lecturer-card-D4nR3tgq.cjs → lecturer-card-C0AeVE2l.cjs}

@@ -1 +1 @@
-"use strict";const e=require("react/jsx-runtime"),t=require("react"),g=require("framer-motion"),x=require("./common-DeneXo5X.cjs");require("./ui/accordion.cjs.js");require("./ui/alert-dialog.cjs.js");require("@radix-ui/react-aspect-ratio");require("./ui/avatar.cjs.js");require("./ui/badge.cjs.js");require("./ui/button.cjs.js");require("./ui/calendar.cjs.js");require("./ui/callout.cjs.js");require("./ui/card.cjs.js");require("./ui/card-label.cjs.js");require("./ui/checkbox.cjs.js");require("lucide-react");require("./ui/command.cjs.js");require("./ui/dialog.cjs.js");require("./ui/dropdown-menu.cjs.js");require("./ui/file-uploader.cjs.js");require("./ui/form.cjs.js");const h=require("./ui/icons.cjs.js");require("./ui/input.cjs.js");require("./ui/label.cjs.js");require("./ui/month-picker.cjs.js");require("./ui/multi-select.cjs.js");require("./ui/navigation-menu.cjs.js");require("./ui/popover.cjs.js");require("./ui/progress.cjs.js");require("./ui/radio-group.cjs.js");require("./ui/scroll-area.cjs.js");require("./ui/select.cjs.js");require("./ui/separator.cjs.js");require("@radix-ui/react-slider");require("./ui/switch.cjs.js");require("./ui/tabs.cjs.js");const H=require("./ui/tag.cjs.js");require("./ui/text.cjs.js");require("./ui/textarea.cjs.js");require("./ui/toast.cjs.js");require("./ui/toggle.cjs.js");require("./ui/toggle-group.cjs.js");require("./ui/tooltip.cjs.js");const T=require("./image-loading-DZFBFoVv.cjs"),u=80;function O({keyPrefix:o,lecturer:s,roleLabel:b,description:l,numberOfLecturers:p,imagePriority:j,imageLoading:N,imageFetchPriority:v,imageDecoding:w}){const c=`${o}-name`,d=`${o}-srdesc`,m=`${o}-content`,q=t.useRef(null),[i,y]=t.useState(!1),[a,L]=t.useState(!1),[C,I]=t.useState(u),A=g.useReducedMotion();t.useLayoutEffect(()=>{const r=q.current;if(!r)return;const n=()=>{I(r.scrollHeight),L(r.scrollHeight>u+1)};n();const f=new ResizeObserver(n);return f.observe(r),()=>f.disconnect()},[l]);const R=T.getImageLoadingAttributes({imagePriority:j,imageLoading:N,imageFetchPriority:v,imageDecoding:w});return e.jsxs("article",{"aria-labelledby":c,className:x.cn("bt-ds-surface bt-ds-radius-10 flex h-full w-full items-start gap-5 rounded-[10px] border border-grey-200 bg-background px-[30px] py-5",p===1&&"col-span-2"),children:[e.jsx("div",{className:"shrink-0",children:s.imageUrl?e.jsx("div",{className:"bt-ds-surface bt-ds-radius-full relative flex aspect-square w-[60px] items-center justify-center overflow-hidden rounded-full border border-grey-200",children:e.jsx("img",{src:s.imageUrl,alt:`${s.lecturerName} 프로필 이미지`,className:"h-full w-full object-cover",...R})}):e.jsx("div",{className:"relative flex aspect-square w-[60px] items-center justify-center overflow-hidden rounded-full bg-grey-100","aria-label":`${s.lecturerName} 프로필 이미지 없음`,children:e.jsx(h.Icon.Profile,{size:"32",fill:"#A2A3A4","aria-hidden":"true"})})}),e.jsxs("div",{className:"flex w-full flex-col gap-2 text-regular14 text-grey-800",children:[e.jsxs("header",{className:"flex items-center gap-2 text-semibold16",children:[e.jsx("span",{id:c,children:s.lecturerName}),e.jsx(H.Tag,{variant:"solid-secondary-100",size:"sm",className:"px-1 py-0.5",children:b})]}),e.jsx("span",{className:"sr-only",id:d,children:"강사 소개를 목록으로 안내한다."}),e.jsxs(g.motion.div,{initial:!1,animate:{height:a?i?C:u:"auto"},transition:{duration:A?0:.35,ease:[.4,0,.2,1]},className:"relative overflow-hidden",children:[e.jsx("ul",{ref:q,id:m,"aria-describedby":d,"aria-expanded":a?i:void 0,className:"flex w-full flex-col whitespace-pre-wrap break-keep text-grey-600",children:l.map((r,n)=>e.jsx("li",{children:r},n))}),a&&!i&&e.jsx("span",{"aria-hidden":"true",className:"pointer-events-none absolute inset-x-0 bottom-0 h-8 bg-gradient-to-t from-white to-transparent"})]}),a&&e.jsxs("button",{type:"button",onClick:()=>y(r=>!r),"aria-expanded":i,"aria-controls":m,className:"flex items-center gap-0.5 self-end text-main-600",children:[i?"정보 숨기기":"정보 더보기",e.jsx(h.Icon.ArrowDown2,{size:"16",fill:"currentColor","aria-hidden":"true",className:x.cn("shrink-0 transition-transform duration-200",i&&"rotate-180")})]})]})]})}exports.LecturerCard=O;
+"use strict";const e=require("react/jsx-runtime"),t=require("react"),g=require("framer-motion"),x=require("./common-DeneXo5X.cjs");require("./ui/accordion.cjs.js");require("./ui/alert-dialog.cjs.js");require("@radix-ui/react-aspect-ratio");require("./ui/avatar.cjs.js");require("./ui/badge.cjs.js");require("./ui/button.cjs.js");require("./ui/calendar.cjs.js");require("./ui/callout.cjs.js");require("./ui/card.cjs.js");require("./ui/card-label.cjs.js");require("./ui/checkbox.cjs.js");require("lucide-react");require("./ui/command.cjs.js");require("./ui/dialog.cjs.js");require("./ui/dropdown-menu.cjs.js");require("./ui/file-uploader.cjs.js");require("./ui/form.cjs.js");const h=require("./ui/icons.cjs.js");require("./ui/input.cjs.js");require("./ui/label.cjs.js");require("./ui/month-picker.cjs.js");require("./ui/multi-select.cjs.js");require("./ui/navigation-menu.cjs.js");require("./ui/popover.cjs.js");require("./ui/progress.cjs.js");require("./ui/radio-group.cjs.js");require("./ui/scroll-area.cjs.js");require("./ui/select.cjs.js");require("./ui/separator.cjs.js");require("@radix-ui/react-slider");require("./ui/switch.cjs.js");require("./ui/tabs.cjs.js");const H=require("./ui/tag.cjs.js");require("./ui/text.cjs.js");require("./ui/textarea.cjs.js");require("./ui/toast.cjs.js");require("./ui/toggle.cjs.js");require("./ui/toggle-group.cjs.js");require("./ui/tooltip.cjs.js");const T=require("./image-loading-DZFBFoVv.cjs"),u=80;function k({keyPrefix:o,lecturer:s,roleLabel:b,description:l,numberOfLecturers:p,imagePriority:j,imageLoading:w,imageFetchPriority:N,imageDecoding:v}){const c=`${o}-name`,d=`${o}-srdesc`,m=`${o}-content`,q=t.useRef(null),[i,y]=t.useState(!1),[a,L]=t.useState(!1),[C,I]=t.useState(u),A=g.useReducedMotion();t.useLayoutEffect(()=>{const r=q.current;if(!r)return;const n=()=>{I(r.scrollHeight),L(r.scrollHeight>u+1)};n();const f=new ResizeObserver(n);return f.observe(r),()=>f.disconnect()},[l]);const R=T.getImageLoadingAttributes({imagePriority:j,imageLoading:w,imageFetchPriority:N,imageDecoding:v});return e.jsxs("article",{"aria-labelledby":c,className:x.cn("bt-ds-surface bt-ds-radius-10 flex h-full w-full items-start gap-5 rounded-[10px] border border-grey-200 bg-background px-[30px] py-5",p===1&&"col-span-2"),children:[e.jsx("div",{className:"shrink-0",children:s.imageUrl?e.jsx("div",{className:"bt-ds-surface bt-ds-radius-full relative flex aspect-square w-[60px] items-center justify-center overflow-hidden rounded-full border border-grey-200",children:e.jsx("img",{src:s.imageUrl,alt:`${s.lecturerName} 프로필 이미지`,className:"h-full w-full object-cover",...R})}):e.jsx("div",{className:"relative flex aspect-square w-[60px] items-center justify-center overflow-hidden rounded-full bg-grey-100","aria-label":`${s.lecturerName} 프로필 이미지 없음`,children:e.jsx(h.Icon.Profile,{size:"32",fill:"#A2A3A4","aria-hidden":"true"})})}),e.jsxs("div",{className:"flex w-full min-w-0 flex-col gap-2 text-regular14 text-grey-800",children:[e.jsxs("header",{className:"flex items-center gap-2 text-semibold16",children:[e.jsx("span",{id:c,children:s.lecturerName}),e.jsx(H.Tag,{variant:"solid-secondary-100",size:"sm",className:"px-1 py-0.5",children:b})]}),e.jsx("span",{className:"sr-only",id:d,children:"강사 소개를 목록으로 안내한다."}),e.jsxs(g.motion.div,{initial:!1,animate:{height:a?i?C:u:"auto"},transition:{duration:A?0:.35,ease:[.4,0,.2,1]},className:"relative min-w-0 overflow-hidden",children:[e.jsx("ul",{ref:q,id:m,"aria-describedby":d,"aria-expanded":a?i:void 0,className:"flex w-full min-w-0 flex-col whitespace-pre-wrap break-words break-keep text-grey-600",children:l.map((r,n)=>e.jsx("li",{children:r},n))}),a&&!i&&e.jsx("span",{"aria-hidden":"true",className:"pointer-events-none absolute inset-x-0 bottom-0 h-8 bg-gradient-to-t from-white to-transparent"})]}),a&&e.jsxs("button",{type:"button",onClick:()=>y(r=>!r),"aria-expanded":i,"aria-controls":m,className:"flex items-center gap-0.5 self-end text-main-600",children:[i?"정보 숨기기":"정보 더보기",e.jsx(h.Icon.ArrowDown2,{size:"16",fill:"currentColor","aria-hidden":"true",className:x.cn("shrink-0 transition-transform duration-200",i&&"rotate-180")})]})]})]})}exports.LecturerCard=k;

package/dist/{lecturer-card-DaAD77e-.js → lecturer-card-h44ZjbBL.js}

@@ -1,6 +1,6 @@
 import { jsxs as o, jsx as e } from "react/jsx-runtime";
-import { useRef as O, useState as l, useLayoutEffect as R } from "react";
-import { useReducedMotion as $, motion as k } from "framer-motion";
+import { useRef as k, useState as l, useLayoutEffect as O } from "react";
+import { useReducedMotion as R, motion as $ } from "framer-motion";
 import { c as h } from "./common-zQ5XY0UN.js";
 import "./ui/accordion.es.js";
 import "./ui/alert-dialog.es.js";
@@ -48,26 +48,26 @@ function Le({
   lecturer: i,
   roleLabel: x,
   description: c,
-  numberOfLecturers: N,
-  imagePriority: v,
-  imageLoading: w,
+  numberOfLecturers: w,
+  imagePriority: N,
+  imageLoading: v,
   imageFetchPriority: y,
   imageDecoding: A
 }) {
-  const d = `${n}-name`, p = `${n}-srdesc`, u = `${n}-content`, f = O(null), [r, C] = l(!1), [a, I] = l(!1), [L, H] = l(m), T = $();
-  R(() => {
-    const t = f.current;
-    if (!t) return;
+  const d = `${n}-name`, p = `${n}-srdesc`, u = `${n}-content`, f = k(null), [t, C] = l(!1), [a, I] = l(!1), [L, H] = l(m), T = R();
+  O(() => {
+    const r = f.current;
+    if (!r) return;
     const s = () => {
-      H(t.scrollHeight), I(t.scrollHeight > m + 1);
+      H(r.scrollHeight), I(r.scrollHeight > m + 1);
     };
     s();
     const g = new ResizeObserver(s);
-    return g.observe(t), () => g.disconnect();
+    return g.observe(r), () => g.disconnect();
   }, [c]);
   const j = E({
-    imagePriority: v,
-    imageLoading: w,
+    imagePriority: N,
+    imageLoading: v,
     imageFetchPriority: y,
     imageDecoding: A
   });
@@ -77,7 +77,7 @@ function Le({
       "aria-labelledby": d,
       className: h(
         "bt-ds-surface bt-ds-radius-10 flex h-full w-full items-start gap-5 rounded-[10px] border border-grey-200 bg-background px-[30px] py-5",
-        N === 1 && "col-span-2"
+        w === 1 && "col-span-2"
       ),
       children: [
         /* @__PURE__ */ e("div", { className: "shrink-0", children: i.imageUrl ? /* @__PURE__ */ e("div", { className: "bt-ds-surface bt-ds-radius-full relative flex aspect-square w-[60px] items-center justify-center overflow-hidden rounded-full border border-grey-200", children: /* @__PURE__ */ e(
@@ -96,19 +96,19 @@ function Le({
             children: /* @__PURE__ */ e(b.Profile, { size: "32", fill: "#A2A3A4", "aria-hidden": "true" })
           }
         ) }),
-        /* @__PURE__ */ o("div", { className: "flex w-full flex-col gap-2 text-regular14 text-grey-800", children: [
+        /* @__PURE__ */ o("div", { className: "flex w-full min-w-0 flex-col gap-2 text-regular14 text-grey-800", children: [
           /* @__PURE__ */ o("header", { className: "flex items-center gap-2 text-semibold16", children: [
             /* @__PURE__ */ e("span", { id: d, children: i.lecturerName }),
             /* @__PURE__ */ e(z, { variant: "solid-secondary-100", size: "sm", className: "px-1 py-0.5", children: x })
           ] }),
           /* @__PURE__ */ e("span", { className: "sr-only", id: p, children: "강사 소개를 목록으로 안내한다." }),
           /* @__PURE__ */ o(
-            k.div,
+            $.div,
             {
               initial: !1,
-              animate: { height: a ? r ? L : m : "auto" },
+              animate: { height: a ? t ? L : m : "auto" },
               transition: { duration: T ? 0 : 0.35, ease: [0.4, 0, 0.2, 1] },
-              className: "relative overflow-hidden",
+              className: "relative min-w-0 overflow-hidden",
               children: [
                 /* @__PURE__ */ e(
                   "ul",
@@ -116,12 +116,12 @@ function Le({
                     ref: f,
                     id: u,
                     "aria-describedby": p,
-                    "aria-expanded": a ? r : void 0,
-                    className: "flex w-full flex-col whitespace-pre-wrap break-keep text-grey-600",
-                    children: c.map((t, s) => /* @__PURE__ */ e("li", { children: t }, s))
+                    "aria-expanded": a ? t : void 0,
+                    className: "flex w-full min-w-0 flex-col whitespace-pre-wrap break-words break-keep text-grey-600",
+                    children: c.map((r, s) => /* @__PURE__ */ e("li", { children: r }, s))
                   }
                 ),
-                a && !r && /* @__PURE__ */ e(
+                a && !t && /* @__PURE__ */ e(
                   "span",
                   {
                     "aria-hidden": "true",
@@ -135,19 +135,19 @@ function Le({
             "button",
             {
               type: "button",
-              onClick: () => C((t) => !t),
-              "aria-expanded": r,
+              onClick: () => C((r) => !r),
+              "aria-expanded": t,
               "aria-controls": u,
               className: "flex items-center gap-0.5 self-end text-main-600",
               children: [
-                r ? "정보 숨기기" : "정보 더보기",
+                t ? "정보 숨기기" : "정보 더보기",
                 /* @__PURE__ */ e(
                   b.ArrowDown2,
                   {
                     size: "16",
                     fill: "currentColor",
                     "aria-hidden": "true",
-                    className: h("shrink-0 transition-transform duration-200", r && "rotate-180")
+                    className: h("shrink-0 transition-transform duration-200", t && "rotate-180")
                   }
                 )
               ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "boottent-design",
-  "version": "0.1.270",
+  "version": "0.1.272",
   "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",