byuckchon-frontend-cli 2.0.0 → 2.0.1

package/bin/index.js

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+import { createRequire } from 'node:module';
+
 import { config as loadDotenv } from 'dotenv';
 import { Command } from 'commander';
 import chalk from 'chalk';
@@ -24,12 +26,17 @@ import {
 // 프로젝트 .env 가 있으면 자동 로드 (ANTHROPIC_API_KEY, OPENAI_API_KEY 등).
 loadDotenv({ quiet: true });
 
+// 버전은 package.json 에서 읽는다. 여기에 직접 적으면 changesets 가 올린 버전과
+// 어긋나서, 실제로는 최신인데 옛 버전이라고 표시되는 일이 생긴다.
+const require = createRequire(import.meta.url);
+const { version } = require('../package.json');
+
 const program = new Command();
 
 program
   .name('bc')
   .description('Byuckchon Frontend Workbench — 프로젝트 스타터 + AI 어시스턴트')
-  .version('1.10.0');
+  .version(version);
 
 program
   .command('init')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "byuckchon-frontend-cli",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Byuckchon Frontend Workbench — project starter + AI chat + codebase RAG + OpenAPI codegen",
   "type": "module",
   "engines": {

package/src/generators/createBaseFiles.js

@@ -51,7 +51,7 @@ export function agentsDoc(framework) {
 | \`@byuckchon-frontend/hooks\` | useDebounce, useThrottle, useTimer, useInfiniteScroll, useIntersectionObserver, useDetectClose, useAutoFocus, useFileUpload, usePagination, usePullToRefresh, useScrollTop, useCheckList, useMonthCalendar, useVisibilityEvent, usePasswordVisibility, useImpressionRef, useInstallPWA, useScrollToSelectedItem |
 | \`@byuckchon-frontend/utils\` | 포맷(formatData), 검증(validate), 에러 처리(handleError), 쿼리 파라미터(filterParams), userAgent, sanitizeHtml, dateUtils, editorUtils |
 | \`@byuckchon-frontend/core\` | Overlay, ErrorBoundary, SanitizeHtmlRender |
-| \`@byuckchon-frontend/basic-ui\` | Accordion, Input, Checkbox, Toggle, Dropdown, Table, Tooltip, Pagination, Calendar, BottomSheet, Breadcrumb, Modal(Alert·Confirm·Choice), ToastMessage, UIThemeProvider |
+| \`@byuckchon-frontend/basic-ui\` | ⚠️ **먼저 쓰지 않는다** — 아래 설명 참고 |
 | \`@byuckchon-frontend/settings\` | ESLint / Prettier / tsconfig 프리셋, 모션 토큰, 디자인 토큰 변환 |
 
 **작업 순서**
@@ -65,6 +65,41 @@ export function agentsDoc(framework) {
 
 없는 걸 억지로 끼워 맞추지는 마세요. 쓰임이 다르면 직접 만드는 게 맞습니다.
 
+### basic-ui 는 예외입니다
+
+\`@byuckchon-frontend/basic-ui\` 는 **사용자가 명시적으로 요청했을 때만** 씁니다.
+프로젝트마다 디자인이 달라서 기본 UI 컴포넌트를 그대로 쓰면 오히려 덜어내는 작업이 늘어납니다.
+
+UI 컴포넌트는 이 프로젝트의 디자인에 맞춰 직접 만드세요.
+(Accordion, Input, Modal, Table 등이 필요하면 basic-ui 에 있으니 참고만 하세요)
+
+### 모션은 settings 의 클래스를 씁니다
+
+전환 효과가 필요하면 \`duration-200\` 같은 Tailwind 기본 클래스를 직접 쓰지 말고,
+\`@byuckchon-frontend/settings\` 의 모션 유틸리티를 쓰세요. 팀 전체가 같은 속도·곡선을 공유합니다.
+
+| 상황 | 클래스 |
+| --- | --- |
+| hover 확대 / 클릭 눌림 | \`motion-hover-scale\` \`motion-press\` |
+| 펼침·접힘 / 화살표 회전 | \`motion-collapse\` \`motion-rotate\` |
+| 팝업·드롭다운 진입 | \`motion-scale-in\` |
+| 배경 딤 | \`motion-backdrop\` |
+| 바텀시트 / 드로어 | \`motion-sheet\` \`motion-slide-x-left\` \`motion-slide-x-right\` |
+| 토스트 / 툴팁 | \`motion-toast\` \`motion-tooltip\` |
+| 토글 / 체크 / 라벨 | \`motion-toggle-knob\` \`motion-check-pop\` \`motion-label-float\` |
+| 탭 인디케이터 | \`motion-tab-indicator\` |
+
+\`data-open\` 이 필요한 클래스가 있습니다. 열림 상태를 \`data-open={isOpen}\` 으로 내려주세요.
+
+\`\`\`tsx
+<div data-open={isOpen} className="motion-collapse"><div>{content}</div></div>
+\`\`\`
+
+### 클래스 병합은 cn 을 씁니다
+
+\`src/lib/utils/cn.ts\` 의 \`cn\` 을 쓰세요. \`twMerge\` 를 직접 쓰면
+타이포그래피 유틸(\`text-body-sm-regular\`)이 글자 색으로 분류되어 조용히 사라집니다.
+
 ## 2. 설정 파일은 직접 고치지 않는다
 
 \`eslint.config.js\`, \`prettier.config.js\`, \`tsconfig.*.json\`, \`token.config.js\` 는

package/src/generators/createFolders.js

@@ -54,12 +54,14 @@ export async function createFolders(rootDir, config) {
   // 각 레이어에 placeholder 파일 생성
   await writeFile(
     path.join(rootDir, 'src/lib/utils/cn.ts'),
-    `import { clsx, type ClassValue } from 'clsx';
-import { twMerge } from 'tailwind-merge';
-
-export function cn(...inputs: ClassValue[]) {
-  return twMerge(clsx(inputs));
-}
+    `// 클래스 병합은 @byuckchon-frontend/utils 가 관리합니다.
+// twMerge 기본 설정은 타이포그래피 유틸(text-body-sm-regular 등)을 글자 색으로 분류해서
+// 색과 함께 쓰면 타이포가 조용히 사라집니다. utils 의 cn 은 그 부분을 고쳐둔 것입니다.
+//
+// 토큰 이름 체계가 기본 패턴과 다르면 createCn 으로 직접 지정하세요.
+//   import { createCn } from '@byuckchon-frontend/utils';
+//   export const cn = createCn({ typography: ['tab-bar', 'subtitle'] });
+export { cn } from '@byuckchon-frontend/utils';
 `,
   );
   await writeFile(

package/templates/review-automation/github/pull_request_template.md

@@ -1,30 +1,27 @@
 ## 작업 내용
 
-<!-- 무엇을, 왜 바꿨는지 적어주세요. -->
+<!--
+  아래 마커 사이는 커밋 내역으로 자동 채워집니다. 직접 수정하지 마세요.
+  덧붙일 설명이 있으면 이 주석 위·아래에 자유롭게 적으면 됩니다.
+-->
+<!-- byuckchon:commits:start -->
+<!-- byuckchon:commits:end -->
 
 ## 확인 사항
 
-<!-- 리뷰어가 중점적으로 봐야 할 부분이 있다면 적어주세요. -->
-
-## 테스트
-
-- [ ] 로컬에서 동작 확인
-- [ ] `lint` / `typecheck` / `build` 통과
-
 <!--
-  아래 마커 사이는 워크플로가 자동으로 채웁니다. 직접 수정하지 마세요.
-
-  - 커밋 내역: 커밋 메시지 첫 줄을 타입별로 묶습니다. (feat / fix / docs ...)
-  - 리뷰 포인트: 커밋 본문에 NOTE: 또는 TODO: 로 적은 줄을 모읍니다.
+  아래 마커 사이는 커밋 본문의 NOTE: / TODO: 로 자동 채워집니다.
 
       feat: 주문 목록 API 연동
 
       NOTE: 응답 스키마가 미확정이라 any 가 남아 있습니다
       TODO: 에러 처리 미구현
 
-  PR 제목은 브랜치명의 첫 토막이 대괄호로 붙습니다.
-      feature/update-mypage-style/hyuk + "마이페이지 디자인 적용"
-        → "[feature] 마이페이지 디자인 적용"
+  리뷰어가 봐야 할 다른 내용은 이 주석 아래에 적어주세요.
 -->
-<!-- byuckchon:commits:start -->
-<!-- byuckchon:commits:end -->
+<!-- byuckchon:notes:start -->
+<!-- byuckchon:notes:end -->
+
+## 기타
+
+<!-- 참고 링크, 스크린샷, 남은 작업 등 자유롭게 적어주세요. -->

package/templates/review-automation/github/workflows/pr-description.yml

@@ -22,8 +22,8 @@ name: PR Description
 on:
   pull_request:
     types: [opened, synchronize, reopened]
-    branches:
-      - dev
+    # 대상 브랜치를 제한하지 않습니다. PR 본문을 채우는 일이라
+    # dev 든 main 이든 동작하는 편이 낫습니다.
 
 concurrency:
   group: pr-description-${{ github.event.pull_request.number }}