sh-ui-cli 0.67.1 → 0.67.3

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.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",
+      "title": "patch — MCP instructions 에 v0.65~0.67 신규 툴/라우팅 가이드 반영 + migrations 노트",
+      "type": "patch",
+      "highlights": [
+        "**MCP `instructions` 갱신** — `sh_ui_add_app` (모노레포에 앱 추가), `sh_ui_migrate_to_v065` (v0.64.x → v0.65 자동 마이그레이션) 사용 시점을 명시. AI 가 사용자 의도 (\"admin 앱 추가\", \"컴포넌트 중복 emit 정리\") 와 툴 호출을 직접 매핑.",
+        "**모노레포 라우팅 가이드 추가** — `sh_ui_add_component` 가 monorepo 에선 컴포넌트는 ui-core 단일 SoT, tokens 는 각 ui-app 으로 라우팅. CLI `sh-ui add` 는 v0.67+ walk-up 으로 어느 디렉토리에서든 자동 라우팅 (apps/web 에서 tokens → ui-web hintApp 추론).",
+        "**v0.67.1 preset 보존 정책 명시** — rose/emerald/violet 등 풍부한 preset 도 'custom' 과 동일하게 tokens.css 단일 진실로 보존. `sh_ui_add_component` 의 `tokens` 가 rebuild 대신 보존하는 케이스 확장.",
+        "**`apps/docs/migrations/v0.65.md`** 에 v0.66/0.67 후속 개선 섹션 추가 — sh_ui_add_app, walk-up 라우팅, preset 회귀 fix 까지 한 페이지에서 흐름 파악 가능."
+      ],
+      "url": "https://github.com/sanghyeonKim0201/sh-ui/releases/tag/v0.67.2"
+    },
     {
       "version": "0.67.1",
       "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 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sh-ui-cli",
-  "version": "0.67.1",
+  "version": "0.67.3",
   "description": "sh-ui CLI — 프로젝트 스캐폴드(create) + 컴포넌트 추가(add/list/remove) + IDE-내 AI용 MCP 서버",
   "license": "MIT",
   "repository": {

package/src/mcp.mjs

@@ -164,6 +164,22 @@ function buildServerInstructions(cliName) {
 
 \`create-next-app\` + \`sh_ui_init\` 조합은 **쓰지 말 것** — 위 두 경로가 더 짧고 sh-ui 관용에 맞다.
 
+## 기존 모노레포에 새 앱 추가하는 경우 (v0.66+)
+
+이미 sh-ui monorepo 가 있고 사용자가 "admin 앱 추가", "dashboard 같은 앱 더 만들고 싶어" 류 요청을 하면 \`sh_ui_add_app\` MCP 툴 사용 (Bash 직접 호출보다 우선).
+
+  - 인자: name (필수), port, plugins (선택), theme (앱별 다른 톤 가능), cssFramework, cwd
+  - 산출물: \`apps/{name}/\` (Next.js + arch overlay) + \`packages/ui/ui-apps/ui-{name}/\` (tokens-only role, v0.65 layout). 새 ui-app 만 theme/css 적용 — 다른 앱 영향 X.
+  - 앱별로 다른 톤을 원하면 각 앱 별도 호출 (예: 마케팅 사이트 = rose, admin = emerald). 컴포넌트는 ui-core 단일 SoT 라 두 앱이 자동 공유.
+
+## v0.64.x → v0.65 마이그레이션 (v0.66+)
+
+사용자가 "v0.64 모노레포에서 컴포넌트 중복 emit 정리하고 싶어" / "ui-app 들에 같은 컴포넌트가 N 번 있어" 류 요청 또는 사용자가 v0.64.x 시절 만든 모노레포라면 \`sh_ui_migrate_to_v065\` 사용:
+
+  - **dryRun 기본** — 변경 plan 미리보기 후 사용자 확인. 컨텐츠 충돌 시 abort (자동 병합 안 함).
+  - apply: 모든 ui-app 의 \`src/{components,hooks,lib}/\` → \`packages/ui/ui-core/\` 단일 SoT 로 dedup 이동, ui-app 에 \`role: "tokens-only"\` 마커, \`apps/*\` 의 \`@workspace/ui-{app}/components/...\` 임포트를 \`@workspace/ui-core/...\` 로 일괄 재작성.
+  - 적용 후 사용자에게 \`pnpm install\` 안내.
+
 ## 이미 있는 프로젝트에 sh-ui 를 얹는 경우 (MCP 툴 사용)
 
 기존 Next.js/Vite/Flutter 프로젝트에 sh-ui 컴포넌트만 추가하고 싶을 때:
@@ -178,6 +194,14 @@ function buildServerInstructions(cliName) {
 - \`sh_ui_add_component\` / \`sh_ui_remove_component\` — 설치/삭제
 - \`sh_ui_get_changelog\` — 최근 변경 내역
 
+### 모노레포 라우팅 (v0.65+)
+
+monorepo 에서 \`sh_ui_add_component\` 호출 시:
+- **컴포넌트/훅/lib** → \`packages/ui/ui-core/\` 단일 SoT (ui-app 마다 복제 X). 모든 앱이 \`@workspace/ui-core/components/<name>\` 으로 import.
+- **\`tokens\`** → 각 \`packages/ui/ui-apps/ui-{app}/\` (앱별 다른 톤 가능). \`--app <name>\` 으로 대상 명시 가능.
+
+CLI \`sh-ui add <name>\` 은 monorepo 의 어느 디렉토리에서든 (apps/web/, root, ui-core, ui-apps/ui-{app}) 실행해도 자동 라우팅 (v0.67+ walk-up). \`apps/web/\` 안에서 \`sh-ui add tokens\` 실행하면 hintApp='web' 으로 ui-web 자동 선택.
+
 ## UI 짤 때 사고 순서 (raw HTML 기본값 회피)
 
 새 위젯·페이지를 작성할 때 \`<aside>\` / \`<nav>\` / \`<header>\` / \`<table>\` / \`<button>\` 같은 시맨틱 태그를 raw 로 쓰기 전에:
@@ -222,7 +246,7 @@ function buildServerInstructions(cliName) {
 
 ### 기존 프로젝트 톤만 바꾸고 싶을 때
 
-> v0.61.2 부터 \`theme.base: "custom"\` 인 프로젝트에서 \`sh_ui_add_component\` 의 \`tokens\` 는 no-op (보존). 색을 바꾸려면 새 base64 를 만들고 새 디렉토리로 \`force: true\` 재스캐폴드하는 게 정석. 부분 편집을 원해도 \`tokens.css\` 직접 수정 후 \`sh_ui_encode_theme\` 로 새 base64 백업까지 같이 — 그 base64 를 메모리에 갱신해야 다음 재스캐폴드와 일관됨.
+> v0.61.2 부터 \`theme.base: "custom"\` 인 프로젝트에서 \`sh_ui_add_component\` 의 \`tokens\` 는 no-op (보존). v0.67.1 부터 \`rose\`/\`emerald\`/\`violet\` 같은 풍부한 preset 도 동일 — tokens.css 단일 진실로 보존. 색을 바꾸려면 새 base64 를 만들고 새 디렉토리로 \`force: true\` 재스캐폴드하는 게 정석. 부분 편집을 원해도 \`tokens.css\` 직접 수정 후 \`sh_ui_encode_theme\` 로 새 base64 백업까지 같이 — 그 base64 를 메모리에 갱신해야 다음 재스캐폴드와 일관됨.
 `;
 }