sh-ui-cli 0.67.2 → 0.68.0

package/bin/sh-ui.mjs

@@ -15,6 +15,7 @@ const usage = `사용법:
                                    필요한 외부 패키지를 자동 설치
                                    특수값: tokens → 설정 기반 토큰 파일 생성
   sh-ui list                       현재 설치된 컴포넌트 목록 표시
+  sh-ui doctor                     프로젝트 정합성 점검 (config / tokens / 설치된 컴포넌트)
   sh-ui remove <component...>      설치된 컴포넌트 파일 삭제
   sh-ui rename-app <old> <new>     monorepo 의 앱 이름 일괄 변경
                                    (apps/<old>/, packages/ui/ui-apps/ui-<old>/
@@ -99,6 +100,11 @@ try {
       await list({ cwd: process.cwd(), all });
       break;
     }
+    case "doctor": {
+      const { doctor } = await import("../src/doctor.mjs");
+      await doctor({ cwd: process.cwd() });
+      break;
+    }
     case "mcp": {
       // `sh-ui mcp init ...` → 설정 파일에 엔트리 추가
       // `sh-ui mcp`         → MCP 서버 시작

package/data/changelog/versions.json

@@ -2,6 +2,32 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$description": "sh-ui 릴리즈 노트 단일 소스. docs(React)와 showcase(Flutter)가 함께 읽는다. 새 릴리즈마다 맨 앞에 추가.",
   "versions": [
+    {
+      "version": "0.68.0",
+      "date": "2026-05-09",
+      "title": "토큰 의존 검증 + sh-ui doctor — silent breakage 가시화 (Phase A)",
+      "type": "minor",
+      "highlights": [
+        "**`sh-ui doctor` 추가** — 프로젝트 정합성 점검. config/tokens.css/cssEntry/설치된 컴포넌트의 토큰 의존성을 한 번에 검사하고 ✓⚠✗ 로 리포트. CI 통합 가능 (실패 시 exit 1).",
+        "**컴포넌트 토큰 의존 메타** — `packages/registry/react/tokens-used.json` 자동 생성 (`scripts/build-registry-tokens.mjs`). 컴포넌트 CSS 의 `var(--*)` 참조를 framework 별로 추출하고 fallback 있는 var 와 컴포넌트 자체 정의 변수는 외부 의존에서 제외. `pnpm lint:tokens-used` 가 drift 검출.",
+        "**add-time 토큰 검증** — `sh-ui add <component>` 가 destination tokens.css 의 변수 정의를 비교해 누락이면 한 번에 친절한 경고 (silent breakage 사전 차단). 실패가 아닌 안내 — 실제 실행은 그대로.",
+        "**`paths.cssEntry` 옵션 신설** — `sh-ui.config.json` 의 paths 에 `cssEntry` (globals.css 위치) 추가. doctor 가 tokens.css import 정합성을 검증. init/create 가 자동 채움 (Next.js fsd/flat → `app/globals.css`, monorepo ui-app → `src/styles/globals.css`). 기존 config 는 미설정 시 검사 스킵."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.68.0"
+    },
+    {
+      "version": "0.67.3",
+      "date": "2026-05-09",
+      "title": "fix(sidebar) — Collapsible 하위 메뉴 펼침/접힘 애니메이션",
+      "type": "patch",
+      "highlights": [
+        "**Sidebar Collapsible 애니메이션 회귀 fix** — chevron 회전은 부드러운데 본문은 `display:none` 토글이라 즉시 사라지던 어색함. `grid-template-rows: 0fr ↔ 1fr` 트릭으로 height 를 모르는 채로 200ms ease 트랜지션. inner wrapper + `overflow:hidden`/`min-height:0` 으로 grid track 에 맞춰 잘림.",
+        "**a11y 보존** — `hidden={!open}` 대신 `inert` + `aria-hidden` 사용. 닫힌 상태에서도 DOM 은 살아 있어 트랜지션이 가능하면서, 포커스/스크린리더 접근은 정상적으로 차단.",
+        "**reduced-motion 가드** — `prefers-reduced-motion: reduce` 일 때 `__collapsible-content` 트랜지션 비활성. 모션 민감 사용자는 즉시 토글 (기존 동작) 유지.",
+        "**collapsed=icon flyout 모드 영향 없음** — icon 모드에서는 inline content 가 아닌 Popover 로 전환되므로 기존 flyout UX 그대로."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.67.3"
+    },
     {
       "version": "0.67.2",
       "date": "2026-05-09",

package/data/registry/react/components/sidebar/index.tsx

@@ -918,8 +918,13 @@ export function SidebarCollapsibleContent({ children }: { children: React.ReactN
   }
 
   return (
-    <div className="sh-ui-sidebar__collapsible-content" data-state={open ? "open" : "closed"} hidden={!open}>
-      {children}
+    <div
+      className="sh-ui-sidebar__collapsible-content"
+      data-state={open ? "open" : "closed"}
+      inert={!open}
+      aria-hidden={!open || undefined}
+    >
+      <div className="sh-ui-sidebar__collapsible-content-inner">{children}</div>
     </div>
   );
 }

package/data/registry/react/components/sidebar/styles.css

@@ -462,8 +462,19 @@
   transform: rotate(90deg);
 }
 
+/* grid-template-rows 0fr→1fr 트릭 — height 를 모르는 채로 부드럽게 펼침/접힘.
+ * inner 는 overflow:hidden + min-height:0 으로 grid track 에 맞춰 잘려나간다. */
+.sh-ui-sidebar__collapsible-content {
+  display: grid;
+  grid-template-rows: 1fr;
+  transition: grid-template-rows 200ms ease;
+}
 .sh-ui-sidebar__collapsible-content[data-state="closed"] {
-  display: none;
+  grid-template-rows: 0fr;
+}
+.sh-ui-sidebar__collapsible-content-inner {
+  min-height: 0;
+  overflow: hidden;
 }
 
 /* ───── Flyout (collapsed=icon 상태의 서브메뉴) ─────
@@ -493,7 +504,8 @@
   .sh-ui-sidebar__menu-button,
   .sh-ui-sidebar__menu-sub-button,
   .sh-ui-sidebar__panel-close,
-  .sh-ui-sidebar__chevron {
+  .sh-ui-sidebar__chevron,
+  .sh-ui-sidebar__collapsible-content {
     transition: none;
   }
   .sh-ui-sidebar__panel {