페르소나 리뷰(적대적 검증 통과)에서 정리된 항목입니다.
관점: 사용 개발자(DX) · 구분: 추가희망 · 심각도: low · 난이도: 낮음
현상
Canvas는 aspectRatio:'1/1' 고정에 size/maxSize가 width/maxWidth로 매핑된다(hyperglobe.tsx:233). size 기본값 '100%'라 부모 폭에 의존하는데, 부모 높이/레이아웃에 따라 잘리거나 안 보이는 경우가 잦다. Size 스토리는 height:500 데코레이터로 우회(stories.tsx:68-74)하지만 이 주의사항이 문서에 없다.
근거
packages/hyperglobe/src/components/hyperglobe/hyperglobe.tsx:233; packages/hyperglobe/src/components/hyperglobe/hyperglobe.stories.tsx:68-74; types/hyperglobe-props.ts:23-38
권고
가이드에 '크기는 폭 기준이며 1:1 비율로 고정된다. 부모에 충분한 폭/높이를 주거나 maxSize로 상한을 둔다'는 한 단락과 잘리는 예/올바른 예를 추가.
검증 메모
전제의 핵심은 모두 정확하다. 다만 보강할 점: Size 스토리의 실제 중앙 정렬/표시는 height:500 데코레이터 단독이 아니라 meta의 parameters.layout:'centered'(stories.tsx:8)와 함께 작동하며, 데코레이터는 세로 공간을 확보하는 역할이다. 또한 demo 파일들이 maxSize={900}와 style margin/maxWidth 패턴을 일관되게 사용하고 있어 '올바른 사용법'은 코드 예제로는 존재하지만 산문 가이드로는 명문화돼 있지 않다는 점이 더 정확한 표현이다.
관점: 사용 개발자(DX) · 구분: 추가희망 · 심각도: low · 난이도: 낮음
현상
Canvas는
aspectRatio:'1/1'고정에 size/maxSize가 width/maxWidth로 매핑된다(hyperglobe.tsx:233). size 기본값 '100%'라 부모 폭에 의존하는데, 부모 높이/레이아웃에 따라 잘리거나 안 보이는 경우가 잦다. Size 스토리는 height:500 데코레이터로 우회(stories.tsx:68-74)하지만 이 주의사항이 문서에 없다.근거
packages/hyperglobe/src/components/hyperglobe/hyperglobe.tsx:233; packages/hyperglobe/src/components/hyperglobe/hyperglobe.stories.tsx:68-74; types/hyperglobe-props.ts:23-38
권고
가이드에 '크기는 폭 기준이며 1:1 비율로 고정된다. 부모에 충분한 폭/높이를 주거나 maxSize로 상한을 둔다'는 한 단락과 잘리는 예/올바른 예를 추가.
검증 메모
전제의 핵심은 모두 정확하다. 다만 보강할 점: Size 스토리의 실제 중앙 정렬/표시는 height:500 데코레이터 단독이 아니라 meta의 parameters.layout:'centered'(stories.tsx:8)와 함께 작동하며, 데코레이터는 세로 공간을 확보하는 역할이다. 또한 demo 파일들이 maxSize={900}와 style margin/maxWidth 패턴을 일관되게 사용하고 있어 '올바른 사용법'은 코드 예제로는 존재하지만 산문 가이드로는 명문화돼 있지 않다는 점이 더 정확한 표현이다.