@ssafy-mhk/e-ver 1.0.6 → 1.0.7

package/README.md

@@ -27,18 +27,6 @@ pnpm add @ssafy-mhk/e-ver
 pnpm add react react-dom three @react-three/fiber @react-three/drei @mediapipe/tasks-vision zustand
 ```
 
-이 레포에서 `ever/frontend`로 로컬 검증할 때는:
-
-```bash
-pnpm run sdk:use-tarball
-```
-
-퍼블리시된 버전으로 되돌릴 때는:
-
-```bash
-pnpm run sdk:use-version -- 1.0.4
-```
-
 ## 서버와 인증
 
 기본 API 서버는 `http://localhost:8000/api/v1`입니다.
@@ -50,12 +38,10 @@ const client = new EverClient();
 
 const publicClient = new EverClient({
   apiKey: "ever_live_xxxxxxxx",
+  baseUrl: "http://localhost:8080/api/v1",
 });
 ```
 
-- 기본 생성자: 쿠키 인증 또는 같은 오리진 환경에서 사용
-- `apiKey` 지정 시: `/sdk/public/*` 경로를 사용하는 공개 SDK 모드
-
 `useEverGeneration`도 동일하게 `apiKey`를 받을 수 있습니다.
 
 ## 권장 사용 흐름
@@ -69,15 +55,15 @@ const publicClient = new EverClient({
 
 ## 핵심 API
 
-| 분류 | 모듈 | 역할 |
-| --- | --- | --- |
-| Client | `EverClient` | body preset 조회/매칭, garment 생성, 이미지 업로드, `generate-3d`, polling |
-| Hook | `useEverGeneration` | 의류 생성 플로우를 훅으로 제공 |
-| Scene | `EverFittingScene` | webcam, tracking, measurement, body preset selection, garment 렌더링 통합 |
-| Scene | `EverTrackedGarment` | 준비된 의류 GLB를 추적 렌더링 |
-| Hook | `useEverFitting` | 고수준 fitting runtime 상태 제공 |
-| Hook | `useBodyPresetSelection` | 측정값 기반 body preset 자동 선택 |
-| Renderer | `EverCanvas` | 저수준 R3F canvas wrapper |
+| 분류     | 모듈                     | 역할                                                                       |
+| -------- | ------------------------ | -------------------------------------------------------------------------- |
+| Client   | `EverClient`             | body preset 조회/매칭, garment 생성, 이미지 업로드, `generate-3d`, polling |
+| Hook     | `useEverGeneration`      | 의류 생성 플로우를 훅으로 제공                                             |
+| Scene    | `EverFittingScene`       | webcam, tracking, measurement, body preset selection, garment 렌더링 통합  |
+| Scene    | `EverTrackedGarment`     | 준비된 의류 GLB를 추적 렌더링                                              |
+| Hook     | `useEverFitting`         | 고수준 fitting runtime 상태 제공                                           |
+| Hook     | `useBodyPresetSelection` | 측정값 기반 body preset 자동 선택                                          |
+| Renderer | `EverCanvas`             | 저수준 R3F canvas wrapper                                                  |
 
 ## Quick Start
 
@@ -198,7 +184,11 @@ function Generator() {
 직접 조립이 필요하면 `useEverFitting`과 `EverTrackedGarment`를 사용할 수 있습니다.
 
 ```tsx
-import { EverCanvas, EverTrackedGarment, useEverFitting } from "@ssafy-mhk/e-ver";
+import {
+  EverCanvas,
+  EverTrackedGarment,
+  useEverFitting,
+} from "@ssafy-mhk/e-ver";
 
 function CustomScene({ garmentUrl }: { garmentUrl: string }) {
   const fitting = useEverFitting({

package/dist/components/EverFittingScene.d.ts

@@ -2,7 +2,7 @@ import { type CSSProperties } from "react";
 import type { UseBodyPresetSelectionOptions } from "../types/bodyPreset";
 import { type EverFittingOptions, type EverFittingRuntimeState } from "../hooks/useEverFitting";
 import { type GarmentLoadState } from "./EverTrackedGarment";
-export interface EverFittingSceneProps extends Pick<EverFittingOptions, "enabled" | "width" | "height" | "facingMode" | "mockMode" | "viewportWidth" | "viewportHeight" | "measurementEnabled" | "autoStartMeasurement" | "measurementConfig" | "fitType" | "garmentScaleHint"> {
+export interface EverFittingSceneProps extends Pick<EverFittingOptions, "enabled" | "width" | "height" | "facingMode" | "mockMode" | "modelComplexity" | "numPoses" | "minDetectionConfidence" | "minTrackingConfidence" | "outputSegmentationMasks" | "viewportWidth" | "viewportHeight" | "measurementEnabled" | "autoStartMeasurement" | "measurementConfig" | "fitType" | "garmentScaleHint"> {
     garmentUrl: string | null;
     bodyPresetOptions?: UseBodyPresetSelectionOptions;
     className?: string;
@@ -15,4 +15,4 @@ export interface EverFittingSceneProps extends Pick<EverFittingOptions, "enabled
     onRuntimeStateChange?: (state: EverFittingRuntimeState) => void;
     onGarmentLoadStateChange?: (state: GarmentLoadState) => void;
 }
-export declare function EverFittingScene({ garmentUrl, enabled, width, height, facingMode, mockMode, viewportWidth, viewportHeight, measurementEnabled, autoStartMeasurement, measurementConfig, fitType, garmentScaleHint, bodyPresetOptions, className, style, debugMaterials, showEnvironment, showStats, showWebcamBackground, onCanvasReadyChange, onRuntimeStateChange, onGarmentLoadStateChange, }: EverFittingSceneProps): import("react/jsx-runtime").JSX.Element;
+export declare function EverFittingScene({ garmentUrl, enabled, width, height, facingMode, mockMode, modelComplexity, numPoses, minDetectionConfidence, minTrackingConfidence, outputSegmentationMasks, viewportWidth, viewportHeight, measurementEnabled, autoStartMeasurement, measurementConfig, fitType, garmentScaleHint, bodyPresetOptions, className, style, debugMaterials, showEnvironment, showStats, showWebcamBackground, onCanvasReadyChange, onRuntimeStateChange, onGarmentLoadStateChange, }: EverFittingSceneProps): import("react/jsx-runtime").JSX.Element;

package/dist/garment/trackedGarmentMotion.d.ts

@@ -10,6 +10,8 @@ export interface TrackedGarmentMotionState {
     facingDetector: FacingDetector;
     yawFreezeController: YawFreezeController;
     displayYaw: number | null;
+    displayPitch: number | null;
+    displayRoll: number | null;
     lastFacingState: FacingState | null;
     hasInitialPosition: boolean;
 }

package/dist/garment/trackedModelTransform.d.ts

@@ -14,8 +14,12 @@ export interface TrackedModelTransformScratch {
     scaledAnchor: THREE.Vector3;
     position: THREE.Vector3;
     scale: THREE.Vector3;
+    rootQuaternion: THREE.Quaternion;
+    bodyPitch: number;
+    bodyRoll: number;
     stabilizedBodyHeightScale: number | null;
     missingBodyHeightFrames: number;
+    stableTorsoHeightToShoulderRatio: number | null;
     smoothedGlobalScale: number;
     hasSmoothedGlobalScale: boolean;
     effectiveYaw: number;
@@ -35,6 +39,7 @@ export interface TrackedModelTransformOptions {
     sourceHeight?: number;
     bodyYaw?: number;
     worldLandmarks?: NormalizedLandmark[] | null;
+    deltaSeconds?: number;
 }
 export declare function createTrackedModelTransformScratch(): TrackedModelTransformScratch;
 export declare function updateTrackedModelTransform(fitProfile: GarmentFitProfile, landmarks: NormalizedLandmark[], viewportWidth: number, viewportHeight: number, scratch: TrackedModelTransformScratch, options?: TrackedModelTransformOptions): boolean;

package/dist/humanoid/numberedBoneAliases.d.ts

@@ -0,0 +1,12 @@
+import * as THREE from "three";
+import { BONE_MAPPING } from "../pose/boneMapping";
+export type StandardHumanoidBoneName = keyof typeof BONE_MAPPING;
+/** 번호 본(bone_0, bone_1 등) 패턴의 스켈레톤인지 판별 */
+export declare function isLikelyNumberedHumanoidSkeleton(skeleton: THREE.Skeleton): boolean;
+/**
+ * 번호 본 스켈레톤에서 위치 기반 휴리스틱으로 표준 휴머노이드 본 별칭을 추론한다.
+ *
+ * 하드코딩된 인덱스 매핑 없이 본의 월드 좌표와 계층 구조만으로
+ * Hips, Spine, Chest, 팔·다리 체인 등을 자동 식별한다.
+ */
+export declare function inferNumberedHumanoidBoneAliases(skeleton: THREE.Skeleton): Map<THREE.Bone, StandardHumanoidBoneName>;

package/dist/index.d.ts

@@ -28,6 +28,7 @@ export * from "./garment/trackedModelTransform";
 export * from "./garment/constants";
 export * from "./garment/poseApplication";
 export * from "./garment/trackedGarmentMotion";
+export * from "./humanoid/numberedBoneAliases";
 export * from "./avatar/avatarLoader";
 export * from "./avatar/VRMCompat";
 export * from "./avatar/humanoidBindings";
@@ -41,8 +42,11 @@ export * from "./pose/landmarkerFactory";
 export * from "./pose/segmentation";
 export * from "./pose/boneMapping";
 export * from "./pose/facingDetector";
+export * from "./pose/trackingConfidence";
 export * from "./pose/yawFreezeController";
 export * from "./pose/yawDirectionStabilizer";
+export * from "./pose/frameSmoothing";
+export * from "./pose/detectionCadence";
 export * from "./tracking/personLock";
 export * from "./tracking/trackingState";
 export * from "./tracking/trackingStability";