페르소나 리뷰(적대적 검증 통과)에서 정리된 항목입니다.
관점: 사용 개발자(DX) · 구분: 추가희망 · 심각도: low · 난이도: 높음
현상
현재 확장 수단은 marker.iconPath(SVG path 문자열)뿐이고, region/route/marker/graticule 외에 소비자가 자신의 three 오브젝트나 이미지 오버레이를 지구본 좌표계에 얹을 공개 API(children/render-prop/좌표→벡터 변환 유틸)가 없다. CoordinateConverter 등 핵심 변환 유틸도 공개 export되지 않아(@hyperglobe/tools 내부), 소비자가 좌표 변환을 직접 할 길이 막혀 있다.
근거
packages/hyperglobe/src/index.ts:1-17 (components/types/Colors만 공개); packages/hyperglobe/src/components/marker-feature/marker-interface.ts:24-27 (iconPath 한정); CoordinateConverter는 @hyperglobe/tools 내부
권고
1차로 경위도→3D 벡터 변환 유틸(CoordinateConverter류)과 children 슬롯(지구본 group 내부)을 공개해 소비자가 임의 R3F 노드를 배치할 수 있게 한다. 이미지 오버레이는 후속.
검증 메모
전제 자체는 정확하나 미세한 정밀화 한 가지: evidence는 'CoordinateConverter가 @hyperglobe/tools 내부라 export 안 됨'이라 표현했는데, 엄밀히는 tools 패키지의 src/coordinate/index.ts에서 re-export는 되어 있다. 다만 tools 패키지가 private:true로 npm 미게시이고, core의 공개 번들(src/index.ts)이 이를 다시 export하지 않으므로 '소비자가 접근 불가'라는 결론은 그대로 유효하다.
관점: 사용 개발자(DX) · 구분: 추가희망 · 심각도: low · 난이도: 높음
현상
현재 확장 수단은 marker.iconPath(SVG path 문자열)뿐이고, region/route/marker/graticule 외에 소비자가 자신의 three 오브젝트나 이미지 오버레이를 지구본 좌표계에 얹을 공개 API(children/render-prop/좌표→벡터 변환 유틸)가 없다. CoordinateConverter 등 핵심 변환 유틸도 공개 export되지 않아(@hyperglobe/tools 내부), 소비자가 좌표 변환을 직접 할 길이 막혀 있다.
근거
packages/hyperglobe/src/index.ts:1-17 (components/types/Colors만 공개); packages/hyperglobe/src/components/marker-feature/marker-interface.ts:24-27 (iconPath 한정); CoordinateConverter는 @hyperglobe/tools 내부
권고
1차로 경위도→3D 벡터 변환 유틸(CoordinateConverter류)과 children 슬롯(지구본 group 내부)을 공개해 소비자가 임의 R3F 노드를 배치할 수 있게 한다. 이미지 오버레이는 후속.
검증 메모
전제 자체는 정확하나 미세한 정밀화 한 가지: evidence는 'CoordinateConverter가 @hyperglobe/tools 내부라 export 안 됨'이라 표현했는데, 엄밀히는 tools 패키지의 src/coordinate/index.ts에서 re-export는 되어 있다. 다만 tools 패키지가 private:true로 npm 미게시이고, core의 공개 번들(src/index.ts)이 이를 다시 export하지 않으므로 '소비자가 접근 불가'라는 결론은 그대로 유효하다.