Files
HMDesign/docs/sw/sw-home-menu-integration-2026-10-19.md
T
shkim4 170a5c23ae feat(sw): integrate responsive home menu into header
- Merge SW / Home Menu Stories into SW / Header (sidebar: Home Menu; others verification-tagged)
- Home On: logo hover ring and header top/bottom #5F4B0F lines while the menu is open
- Measured More in SWHeader; home menu narrow widths use a More (...) section with a grouped
  text menu instead of horizontal scroll, placed right after the last visible section
- Action tiles no longer stay on after a click; 최근파일 stays Active only while its list is open
- More dropdown and recent files list never open together; list top joins the accent line
- Recent files preview falls back left / over the list at narrow widths (390px)
- Update Storybook, browser tests, docs, AI guides and QA evidence
2026-10-19 22:46:28 +09:00

3.2 KiB

SW Task A + B 통합 — 로고 클릭 메뉴 (2026-10-19)

통합 Worktree HMDesign-SW-Integration, 브랜치 integration/sw-home-menu(기준 Task A e8409ef) + Task B 396539d의 신규 파일 84개. 미커밋.

결합 방식

  • Task B 파일 84개는 모두 신규이며 Task A 파일과 겹치지 않아 Git 충돌이 없습니다(5faa1f1 → e8409ef 조상 관계).
  • 공유 파일 수정은 연결에 필요한 최소 범위입니다.
파일 변경
packages/sw/src/index.ts export * from "./components/sw-home-menu"
sw-header/types.ts, index.ts homeMenu, homeMenuOpen, defaultHomeMenuOpen, onHomeMenuOpenChange, 타입 SWHeaderHomeMenu, SWHeaderHomeMenuChangeReason
sw-header/SWHeader.tsx homeMenu가 있을 때만: 로고 클릭 = 메뉴 토글(onHomeClick 미호출), DOM 측정 배치(객체 수정 영역 −2px ~ 창 영역), 메뉴와 문서·필드 Dropdown 상호 닫기. homeMenu가 없으면 기존 동작 그대로
components/SWHeaderHome.tsx aria-expanded·aria-controls 전달(시각 변화 없음)
components/SWHeaderPropertyPanel.tsx 내부 useSWPopupStack에 export만 추가(패키지 공개 아님)
theme/sw.css .hm-sw-header__home-menu 레이어 1줄(top 0, z-index 20)
sw-home-menu/SWHomeMenu.tsx(Task B) 열린 동안 Popup Escape 스택에 합류(하위 패널 → 메뉴 순서는 그대로)
Story·Fixture(Task B) @hm-design/sw 공식 Import, SWHeader homeMenu 사용, 통합 · Popup · Escape Story 추가
AI 문서·README·사용 가이드 카탈로그 5절, 조합 패턴 7절, 디자인 규칙 11절, 예제 G

검증 (실행 결과)

항목 결과
SW typecheck / 앱 tsc -b / SW build / Storybook build PASS / PASS / PASS / PASS
dist/styles.css 홈 메뉴 스타일, dist/index.d.ts 공개 Export 포함 / 포함
AI 문서·공개 API 정합성(ai-docs.check.mjs) 22/22 PASS
기존 SW Story 28장 픽셀 비교(통합 전 기준선 대비, threshold 0) 28/28 동일
기존 Header·Tool·Popup 기능 회귀(integrated-improvement.browser.mjs) 96 PASS / 0 FAIL(통합 전과 동일)
홈 메뉴 통합(home-menu-integration.browser.mjs) 22/22 PASS

남은 항목

  • 미실행: 독립 React 19 Tarball 소비 설치, SW + HM UI CSS 동시 사용, Figma 스크린샷 픽셀 비교(배치·크기는 DOM 실측으로만 확인), Firefox·Safari.
  • 좁은 폭: (2026-10-19 후속 수정) 가로 스크롤 대신 측정형 더보기(⋯). 들어가는 섹션만 앞에서부터 Figma 타일로 표시하고 나머지는 더보기 Dropdown의 텍스트 메뉴(섹션 제목 + 항목, 구분선)로 이동, 폭이 넓어지면 복귀. 실측(capture-responsive): 1920 5개, 1680 3+더보기, 1440·1280·1180 2+더보기, 1080·960 1+더보기, 768 이하 더보기만. 메뉴 행·페이지 가로 스크롤 0.
  • 디자인 승인 대기(미적용): 속성Bar 차이 3건, 폰트 차이. 열림 상태 Header 상·하단 #5F4B0F 선과 로고 Home On은 2026-10-19 사용자 요청으로 적용(Figma 662:67267).
  • Task A의 기존 제한(넓은 tools + 390px에서 파일명·레이어 폭 0)은 이번 통합 범위 밖입니다.