Composable Preview 함수를 별도 소스셋(debug/preview)으로 분리

[simeunseok]

종류

Improvement

작업 목표

Composable의 @Preview 함수를 프로덕션 코드와 분리된 위치(debug/preview 소스셋)에 두는 규칙을 확정하고 기존 컴포넌트에 적용한다. Preview에서 쓰는 샘플 데이터를 UI 테스트와 공용으로 사용할 수 있는 구조를 만든다.

상세 설명

• 현재 Preview 함수가 프로덕션 Composable 파일 안에 함께 위치한다.
• Preview 함수를 src/debug/(또는 preview 전용 위치)로 분리한다.
• 이 위치에 두는 장점:
  1. prod로 사용될 Composable과 preview를 구분 — 릴리스 빌드에 preview 코드가 섞이지 않고, 파일이 프로덕션 로직에만 집중된다.
  2. UI 테스트에 사용될 테스트 케이스 데이터를 공용으로 사용 — preview 샘플/케이스 데이터를 UI 테스트에서도 재사용해 한 곳에서 관리한다.
• 선행 조건: 디자인 시스템 컴포넌트 개발 작업(디자인 시스템 컴포넌트(Avatar·TextInput·TextArea·Snackbar) Composable 개발 #77 등) 이후에 착수한다.

영향 모듈

• core:design-system (Preview·컴포넌트 위치 변경)
• 향후 UI 테스트 모듈/소스셋

완료 조건

• Preview 함수 배치 위치 규칙 결정 (src/debug/ 소스셋 vs 별도 preview 위치)
• 규칙을 컨벤션 문서(core/design-system/README.md 또는 docs/conventions/)에 기록
• 기존 컴포넌트의 Preview 함수를 새 위치로 이전
• Preview 샘플 데이터를 UI 테스트와 공유 가능한 형태로 추출
• 빌드·프리뷰(IDE 렌더링) 정상 동작 확인

참고 사항

• 디자인 시스템 컴포넌트 개발(디자인 시스템 컴포넌트(Avatar·TextInput·TextArea·Snackbar) Composable 개발 #77) 완료 후 진행할 후속 작업
• 검토 필요: src/debug/는 main 소스셋을 참조 가능하나 그 역은 불가 — Preview↔프로덕션 접근성 조정 필요 여부, @PreviewParameter 데이터를 테스트 소스셋과 공유하려면 testFixtures/공용 모듈이 필요한지 함께 확인