@ssafy-mhk/e-ver 1.0.2 → 1.0.3

package/README.md

@@ -14,11 +14,11 @@ S14P21M104 가상 피팅(WebAR) 프로젝트를 위한 공식 프론트엔드 Re
 
 ## 🛠 설치 방법 (Installation)
 
-이 패키지는 사내 또는 외부 NPM에 직접 배포되기 전 로컬 저장소를 통한 심볼릭 링크(Symbolic Link) 방식으로 연결하거나 파일 디렉토리를 참조하여 사용할 수 있습니다.
+이 패키지는 배포 전 로컬 검증 시 tarball로 패키징한 뒤 소비 애플리케이션에 설치해서 확인하는 방식을 권장합니다.
 
-### 로컬 프로젝트에서 참조하여 설치할 경우:
+### 배포된 패키지 설치
 
-여러분의 Next.js 프로젝트 최상위 폴더(`frontend`)에서 아래 명령어를 실행하세요.
+여러분의 Next.js 프로젝트 최상위 폴더에서 아래 명령어를 실행하세요.
 
 ```bash
 # pnpm 사용 시
@@ -31,6 +31,20 @@ yarn add @ssafy-mhk/e-ver
 
 _(의존성 설치가 잘 되었는지 꼭 `package.json` 코드를 확인하세요.)_
 
+### 이 레포에서 `frontend`로 로컬 검증할 경우
+
+`/ever/frontend`에서 아래 명령어를 실행하면 `/ever/sdk`를 빌드하고 tarball로 패키징한 뒤 현재 프론트엔드에 설치합니다.
+
+```bash
+pnpm run sdk:use-tarball
+```
+
+검증 후 퍼블리시된 버전으로 되돌릴 때는 아래 명령어를 사용합니다.
+
+```bash
+pnpm run sdk:use-version -- 1.0.3
+```
+
 ---
 
 ## 🚀 코어로직 한눈에 보기 (SDK 핵심 요소)

package/dist/api/EverClient.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/EverProvider.d.ts

@@ -1,12 +1,4 @@
 import React from "react";
-import * as THREE from "three";
-export interface EverContextType {
-    videoRef: React.RefObject<HTMLVideoElement | null>;
-    avatarBones: Record<string, THREE.Bone> | null;
-    setAvatarBones: (bones: Record<string, THREE.Bone> | null) => void;
-    isProviderReady: boolean;
-}
-export declare const useEver: () => EverContextType;
 export interface EverProviderProps {
     children: React.ReactNode;
 }

package/dist/components/ever-context.d.ts

@@ -0,0 +1,9 @@
+import * as THREE from "three";
+export interface EverContextType {
+    videoRef: React.RefObject<HTMLVideoElement | null>;
+    avatarBones: Record<string, THREE.Bone> | null;
+    setAvatarBones: (bones: Record<string, THREE.Bone> | null) => void;
+    isProviderReady: boolean;
+}
+export declare const EverContext: import("react").Context<EverContextType | undefined>;
+export declare function useEver(): EverContextType;

package/dist/hooks/useBodyMeasurer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/useEverGeneration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/usePoseMapper.d.ts

@@ -1,7 +1,13 @@
 import * as THREE from "three";
+interface PoseLandmark {
+    x: number;
+    y: number;
+    z: number;
+}
 /**
  * Custom hook to map MediaPipe 2D/3D landmarks to 3D bones (Quaternions).
  */
 export declare const usePoseMapper: () => {
-    mapPoseToBones: (landmarks: any[], targetBones: Record<string, THREE.Bone>) => void;
+    mapPoseToBones: (landmarks: PoseLandmark[], targetBones: Record<string, THREE.Bone>) => void;
 };
+export {};

package/dist/hooks/usePoseTracker.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./store/useEverStore";
 export * from "./components/EverProvider";
+export * from "./components/ever-context";
 export * from "./components/EverCanvas";
 export * from "./components/CameraView";
 export * from "./components/AvatarModel";

package/dist/index.es.js

@@ -17837,11 +17837,15 @@ var mg = class {
 		let t = this.getContext();
 		t.drawingBufferColorSpace = $n._getDrawingBufferColorSpace(e), t.unpackColorSpace = $n._getUnpackColorSpace();
 	}
-}, hg = i(void 0), gg = () => {
+}, hg = i(void 0);
+function gg() {
 	let e = o(hg);
 	if (!e) throw Error("useEver must be used within an EverProvider");
 	return e;
-}, _g = ({ children: e }) => {
+}
+//#endregion
+//#region src/components/EverProvider.tsx
+var _g = ({ children: e }) => {
 	let t = u(null), [n, r] = d(null), i = {
 		videoRef: t,
 		avatarBones: n,
@@ -35941,7 +35945,7 @@ var Ux = ({ children: e, showEnvironment: t = !0 }) => /* @__PURE__ */ p(_g, { c
 		if (!n) return;
 		let e = {};
 		return n.traverse((t) => {
-			t.isBone && (e[t.name] = t);
+			t instanceof oo && (e[t.name] = t);
 		}), i(e), t && t(e), () => i(null);
 	}, [
 		n,
@@ -35959,7 +35963,7 @@ var Ux = ({ children: e, showEnvironment: t = !0 }) => /* @__PURE__ */ p(_g, { c
 	let { scene: n } = ax(e), r = u(null), { avatarBones: i } = gg(), a = t || i;
 	return s(() => {
 		!n || !a || n.traverse((e) => {
-			if (e.isSkinnedMesh) {
+			if (e instanceof ao) {
 				let t = e, n = [];
 				t.skeleton.bones.forEach((e) => {
 					a[e.name] ? n.push(a[e.name]) : n.push(e);
@@ -40789,4 +40793,4 @@ function iM(e) {
 	};
 }
 //#endregion
-export { Gx as AvatarModel, Wx as CameraView, Ux as EverCanvas, tM as EverClient, _g as EverProvider, qx as GarmentModel, Qj as useBodyMeasurer, gg as useEver, iM as useEverGeneration, E as useEverStore, Zj as usePoseMapper, Xj as usePoseTracker };
+export { Gx as AvatarModel, Wx as CameraView, Ux as EverCanvas, tM as EverClient, hg as EverContext, _g as EverProvider, qx as GarmentModel, Qj as useBodyMeasurer, gg as useEver, iM as useEverGeneration, E as useEverStore, Zj as usePoseMapper, Xj as usePoseTracker };