@ehfuse/photo-editor

사진을 캔버스에 보여주는 React 편집기 코어. 캔버스 렌더링 + 보정 엔진(뷰티/필터/워프/배경 분리)으로 구성되며, 모든 기능은 props/handle 로 제어한다.

기본 사용법은 docs/ko/getting-started.md 를 참고한다.

설치

npm install @ehfuse/photo-editor

peerDependencies: react, react-dom (>=18). 얼굴/인물/포즈 인식이 필요하면 @mediapipe/tasks-vision (>=0.10) 을 함께 설치한다(선택).

사용

import { PhotoEditor, DEFAULT_BEAUTY } from "@ehfuse/photo-editor";
import type { PhotoEditorHandle } from "@ehfuse/photo-editor";

const ref = useRef<PhotoEditorHandle>(null);

<PhotoEditor
    ref={ref}
    src={imageUrl}
    width={560}
    beauty={DEFAULT_BEAUTY}
/>;

주요 export

• PhotoEditor — 캔버스 편집기 컴포넌트
• PhotoEditorHandle — 명령형 제어 handle(회전/원근/자르기/반전/undo 등)
• BeautyOptions / DEFAULT_BEAUTY — 보정 옵션 타입·기본값
• applyBeauty / applyFilter — 픽셀 보정·필터 엔진
• FormSlider — 폼 바인딩 슬라이더
• AiEditFn / AiEditRequest / AiEditResult / AiEditMode — AI 편집 어댑터 타입(소비처가 주입). 연동은 UI 키트의 AI 편집 가이드 참고.

라이선스

UNLICENSED (비공개 패키지)