@xrift/world-components 0.13.0 → 0.15.1

package/dist/contexts/UsersContext.d.ts

@@ -1,10 +1,13 @@
 import { type ReactNode } from 'react';
+import type { PlayerMovement } from '../types/movement';
 /**
  * ユーザー情報の型定義
  */
 export interface User {
-    /** ユーザーID */
+    /** 認証ユーザーID */
     id: string;
+    /** ソケット接続ID */
+    socketId: string;
     /** 表示名 */
     displayName: string;
     /** アバターアイコンURL */
@@ -21,6 +24,19 @@ export interface UsersContextValue {
     localUser: User | null;
     /** リモートユーザー（他の参加者） */
     remoteUsers: User[];
+    /**
+     * 指定したユーザーの位置情報を取得
+     * useFrame内で毎フレーム呼び出しても再レンダリングを引き起こさない
+     * @param socketId - ソケット接続ID
+     * @returns PlayerMovement または undefined（ユーザーが存在しない場合）
+     */
+    getMovement: (socketId: string) => PlayerMovement | undefined;
+    /**
+     * ローカルユーザー（自分）の位置情報を取得
+     * useFrame内で毎フレーム呼び出しても再レンダリングを引き起こさない
+     * @returns PlayerMovement
+     */
+    getLocalMovement: () => PlayerMovement;
 }
 /**
  * ユーザー情報を管理するContext
@@ -51,10 +67,25 @@ export declare const UsersProvider: ({ implementation, children }: Props) => imp
  * ワールド作成者が現在のユーザー情報（自分＋他の参加者）を取得するために使用
  *
  * @example
+ * // 基本的な使い方
  * const { localUser, remoteUsers } = useUsers()
  *
- * // localUser: { id, displayName, avatarUrl, isGuest }
- * // remoteUsers: [{ id, displayName, avatarUrl, isGuest }, ...]
+ * @example
+ * // 位置情報を取得（useFrame内で毎フレーム呼び出し可能）
+ * const { remoteUsers, getMovement, getLocalMovement } = useUsers()
+ *
+ * useFrame(() => {
+ *   // 自分の位置を取得
+ *   const myMovement = getLocalMovement()
+ *
+ *   // 他のユーザーの位置を取得
+ *   remoteUsers.forEach(user => {
+ *     const movement = getMovement(user.socketId)
+ *     if (movement) {
+ *       console.log(`${user.displayName} is at`, movement.position)
+ *     }
+ *   })
+ * })
  */
 export declare const useUsers: () => UsersContextValue;
 export {};

package/dist/contexts/UsersContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UsersContext.d.ts","sourceRoot":"","sources":["../../src/contexts/UsersContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAc,MAAM,OAAO,CAAA;AAEjE;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,aAAa;IACb,EAAE,EAAE,MAAM,CAAA;IACV,UAAU;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,kBAAkB;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc;IACd,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAA;IACtB,sBAAsB;IACtB,WAAW,EAAE,IAAI,EAAE,CAAA;CACpB;AAWD;;;GAGG;AACH,eAAO,MAAM,YAAY,4CAExB,CAAA;AAED,UAAU,KAAK;IACb;;;OAGG;IACH,cAAc,CAAC,EAAE,iBAAiB,CAAA;IAClC,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,8BAA8B,KAAK,4CAQhE,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,QAAO,iBAE3B,CAAA"}
+{"version":3,"file":"UsersContext.d.ts","sourceRoot":"","sources":["../../src/contexts/UsersContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAc,MAAM,OAAO,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,eAAe;IACf,EAAE,EAAE,MAAM,CAAA;IACV,eAAe;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,kBAAkB;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc;IACd,OAAO,EAAE,OAAO,CAAA;CACjB;AAeD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAA;IACtB,sBAAsB;IACtB,WAAW,EAAE,IAAI,EAAE,CAAA;IACnB;;;;;OAKG;IACH,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAA;IAC7D;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,cAAc,CAAA;CACvC;AAaD;;;GAGG;AACH,eAAO,MAAM,YAAY,4CAExB,CAAA;AAED,UAAU,KAAK;IACb;;;OAGG;IACH,cAAc,CAAC,EAAE,iBAAiB,CAAA;IAClC,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,8BAA8B,KAAK,4CAQhE,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,QAAQ,QAAO,iBAE3B,CAAA"}

package/dist/contexts/UsersContext.js

@@ -1,5 +1,17 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useContext } from 'react';
+/**
+ * デフォルトの PlayerMovement（位置情報が取得できない場合に使用）
+ */
+const DEFAULT_PLAYER_MOVEMENT = {
+    position: { x: 0, y: 0, z: 0 },
+    direction: { x: 0, z: 0 },
+    horizontalSpeed: 0,
+    verticalSpeed: 0,
+    rotation: { yaw: 0, pitch: 0 },
+    isGrounded: true,
+    isJumping: false,
+};
 /**
  * デフォルト実装: Context未設定時は空の状態として動作
  * 開発時やテスト時に使用される
@@ -7,6 +19,8 @@ import { createContext, useContext } from 'react';
 const createDefaultImplementation = () => ({
     localUser: null,
     remoteUsers: [],
+    getMovement: () => undefined,
+    getLocalMovement: () => DEFAULT_PLAYER_MOVEMENT,
 });
 /**
  * ユーザー情報を管理するContext
@@ -32,10 +46,25 @@ export const UsersProvider = ({ implementation, children }) => {
  * ワールド作成者が現在のユーザー情報（自分＋他の参加者）を取得するために使用
  *
  * @example
+ * // 基本的な使い方
  * const { localUser, remoteUsers } = useUsers()
  *
- * // localUser: { id, displayName, avatarUrl, isGuest }
- * // remoteUsers: [{ id, displayName, avatarUrl, isGuest }, ...]
+ * @example
+ * // 位置情報を取得（useFrame内で毎フレーム呼び出し可能）
+ * const { remoteUsers, getMovement, getLocalMovement } = useUsers()
+ *
+ * useFrame(() => {
+ *   // 自分の位置を取得
+ *   const myMovement = getLocalMovement()
+ *
+ *   // 他のユーザーの位置を取得
+ *   remoteUsers.forEach(user => {
+ *     const movement = getMovement(user.socketId)
+ *     if (movement) {
+ *       console.log(`${user.displayName} is at`, movement.position)
+ *     }
+ *   })
+ * })
  */
 export const useUsers = () => {
     return useContext(UsersContext);

package/dist/contexts/UsersContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"UsersContext.js","sourceRoot":"","sources":["../../src/contexts/UsersContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAkB,UAAU,EAAE,MAAM,OAAO,CAAA;AA2BjE;;;GAGG;AACH,MAAM,2BAA2B,GAAG,GAAsB,EAAE,CAAC,CAAC;IAC5D,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,EAAE;CAChB,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CACvC,2BAA2B,EAAE,CAC9B,CAAA;AAWD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAE,cAAc,EAAE,QAAQ,EAAS,EAAE,EAAE;IACnE,MAAM,KAAK,GAAG,cAAc,IAAI,2BAA2B,EAAE,CAAA;IAE7D,OAAO,CACL,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAChC,QAAQ,GACa,CACzB,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAsB,EAAE;IAC9C,OAAO,UAAU,CAAC,YAAY,CAAC,CAAA;AACjC,CAAC,CAAA"}
+{"version":3,"file":"UsersContext.js","sourceRoot":"","sources":["../../src/contexts/UsersContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAkB,UAAU,EAAE,MAAM,OAAO,CAAA;AAmBjE;;GAEG;AACH,MAAM,uBAAuB,GAAmB;IAC9C,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IAC9B,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;IACzB,eAAe,EAAE,CAAC;IAClB,aAAa,EAAE,CAAC;IAChB,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;IAC9B,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,KAAK;CACjB,CAAA;AA0BD;;;GAGG;AACH,MAAM,2BAA2B,GAAG,GAAsB,EAAE,CAAC,CAAC;IAC5D,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,EAAE;IACf,WAAW,EAAE,GAAG,EAAE,CAAC,SAAS;IAC5B,gBAAgB,EAAE,GAAG,EAAE,CAAC,uBAAuB;CAChD,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CACvC,2BAA2B,EAAE,CAC9B,CAAA;AAWD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAE,cAAc,EAAE,QAAQ,EAAS,EAAE,EAAE;IACnE,MAAM,KAAK,GAAG,cAAc,IAAI,2BAA2B,EAAE,CAAA;IAE7D,OAAO,CACL,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAChC,QAAQ,GACa,CACzB,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAsB,EAAE;IAC9C,OAAO,UAAU,CAAC,YAAY,CAAC,CAAA;AACjC,CAAC,CAAA"}

package/dist/index.d.ts

@@ -11,4 +11,5 @@ export { ScreenShareDisplay, type ScreenShareDisplayProps, } from './components/
 export { SpawnPoint, type SpawnPointProps, } from './components/SpawnPoint';
 export { useInstanceState } from './hooks/useInstanceState';
 export { useSpawnPoint } from './hooks/useSpawnPoint';
+export { type PlayerMovement, type Position3D, type Rotation3D, type VRTrackingData, type VRMovementDirection, } from './types/movement';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,yBAAyB,GAC/B,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,UAAU,IAAI,cAAc,EACjC,KAAK,sBAAsB,GAC5B,MAAM,8BAA8B,CAAA;AAErC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,KAAK,IAAI,EACT,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAA;AAGhC,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,GACvB,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAE9D,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAE9D,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,UAAU,GAChB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,GAC7B,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,UAAU,EACV,KAAK,eAAe,GACrB,MAAM,yBAAyB,CAAA;AAGhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,yBAAyB,GAC/B,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,UAAU,IAAI,cAAc,EACjC,KAAK,sBAAsB,GAC5B,MAAM,8BAA8B,CAAA;AAErC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,KAAK,IAAI,EACT,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAA;AAGhC,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,GACvB,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAE9D,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAE9D,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,UAAU,GAChB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,GAC7B,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,UAAU,EACV,KAAK,eAAe,GACrB,MAAM,yBAAyB,CAAA;AAGhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAGrD,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAA"}

package/dist/types/movement.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 3D位置
+ */
+export interface Position3D {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * 3D回転（オイラー角）
+ */
+export interface Rotation3D {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * VRトラッキングの移動方向
+ */
+export type VRMovementDirection = 'forward' | 'backward' | 'left' | 'right' | 'idle';
+/**
+ * VRトラッキングデータ（VRモード時のみ送信）
+ */
+export interface VRTrackingData {
+    /** ヘッド（カメラ）の回転（yaw/pitch） */
+    head: {
+        yaw: number;
+        pitch: number;
+    };
+    /** 左手のアバター基準相対座標 */
+    leftHand: {
+        position: Position3D;
+        rotation: Rotation3D;
+    };
+    /** 右手のアバター基準相対座標 */
+    rightHand: {
+        position: Position3D;
+        rotation: Rotation3D;
+    };
+    /** hipsの位置変化量（初期位置からの差分、シーンローカル座標系） */
+    hipsPositionDelta: Position3D;
+    /** 足のアニメーション状態 */
+    movementDirection: VRMovementDirection;
+    /** ハンドトラッキングかどうか */
+    isHandTracking?: boolean;
+}
+/**
+ * プレイヤーの移動状態
+ * ワールド制作者がユーザーの位置・回転・移動状態を取得するために使用
+ */
+export interface PlayerMovement {
+    /** 位置情報（ワールド座標） */
+    position: Position3D;
+    /** 移動方向（XZ平面、正規化済みベクトル） */
+    direction: {
+        x: number;
+        z: number;
+    };
+    /** XZ平面での速度 */
+    horizontalSpeed: number;
+    /** Y軸での速度（ジャンプ・落下） */
+    verticalSpeed: number;
+    /** 回転情報 - yaw: y軸回転（左右）、pitch: x軸回転（上下） */
+    rotation: {
+        yaw: number;
+        pitch: number;
+    };
+    /** 地面接触判定 */
+    isGrounded: boolean;
+    /** ジャンプ中フラグ */
+    isJumping: boolean;
+    /** VRモードかどうか */
+    isInVR?: boolean;
+    /** VRトラッキングデータ（VRモード時のみ） */
+    vrTracking?: VRTrackingData;
+}
+//# sourceMappingURL=movement.d.ts.map

package/dist/types/movement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"movement.d.ts","sourceRoot":"","sources":["../../src/types/movement.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;AAEpF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,IAAI,EAAE;QACJ,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;IACD,oBAAoB;IACpB,QAAQ,EAAE;QACR,QAAQ,EAAE,UAAU,CAAA;QACpB,QAAQ,EAAE,UAAU,CAAA;KACrB,CAAA;IACD,oBAAoB;IACpB,SAAS,EAAE;QACT,QAAQ,EAAE,UAAU,CAAA;QACpB,QAAQ,EAAE,UAAU,CAAA;KACrB,CAAA;IACD,uCAAuC;IACvC,iBAAiB,EAAE,UAAU,CAAA;IAC7B,kBAAkB;IAClB,iBAAiB,EAAE,mBAAmB,CAAA;IACtC,oBAAoB;IACpB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,mBAAmB;IACnB,QAAQ,EAAE,UAAU,CAAA;IACpB,2BAA2B;IAC3B,SAAS,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACnC,eAAe;IACf,eAAe,EAAE,MAAM,CAAA;IACvB,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,2CAA2C;IAC3C,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACxC,aAAa;IACb,UAAU,EAAE,OAAO,CAAA;IACnB,eAAe;IACf,SAAS,EAAE,OAAO,CAAA;IAClB,gBAAgB;IAChB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,cAAc,CAAA;CAC5B"}

package/dist/types/movement.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=movement.js.map

package/dist/types/movement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"movement.js","sourceRoot":"","sources":["../../src/types/movement.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xrift/world-components",
-  "version": "0.13.0",
+  "version": "0.15.1",
   "description": "Shared components and utilities for Xrift worlds",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",