@xrift/world-components 0.12.5 → 0.14.0

package/dist/contexts/UsersContext.d.ts

@@ -0,0 +1,90 @@
+import { type ReactNode } from 'react';
+import type { PlayerMovement } from '../types/movement';
+/**
+ * ユーザー情報の型定義
+ */
+export interface User {
+    /** ユーザーID */
+    id: string;
+    /** 表示名 */
+    displayName: string;
+    /** アバターアイコンURL */
+    avatarUrl: string | null;
+    /** ゲストかどうか */
+    isGuest: boolean;
+}
+/**
+ * ユーザー情報を管理するためのインターフェース
+ * プラットフォーム側（xrift-frontend）が実装を注入する
+ */
+export interface UsersContextValue {
+    /** ローカルユーザー（自分） */
+    localUser: User | null;
+    /** リモートユーザー（他の参加者） */
+    remoteUsers: User[];
+    /**
+     * 指定したユーザーの位置情報を取得
+     * useFrame内で毎フレーム呼び出しても再レンダリングを引き起こさない
+     * @param userId - ユーザーID
+     * @returns PlayerMovement または undefined（ユーザーが存在しない場合）
+     */
+    getMovement: (userId: string) => PlayerMovement | undefined;
+    /**
+     * ローカルユーザー（自分）の位置情報を取得
+     * useFrame内で毎フレーム呼び出しても再レンダリングを引き起こさない
+     * @returns PlayerMovement
+     */
+    getLocalMovement: () => PlayerMovement;
+}
+/**
+ * ユーザー情報を管理するContext
+ * ワールド作成者はこのContextを通じてユーザー情報にアクセスする
+ */
+export declare const UsersContext: import("react").Context<UsersContextValue>;
+interface Props {
+    /**
+     * プラットフォーム側が提供する実装
+     * 未指定の場合はデフォルト実装（空の状態）が使用される
+     */
+    implementation?: UsersContextValue;
+    children: ReactNode;
+}
+/**
+ * ユーザー情報を提供するContextProvider
+ * プラットフォーム側（xrift-frontend）が実装を注入するために使用
+ *
+ * @example
+ * // プラットフォーム側での使用例
+ * <UsersProvider implementation={usersImplementation}>
+ *   <WorldComponent />
+ * </UsersProvider>
+ */
+export declare const UsersProvider: ({ implementation, children }: Props) => import("react/jsx-runtime").JSX.Element;
+/**
+ * ユーザー情報を取得するhook
+ * ワールド作成者が現在のユーザー情報（自分＋他の参加者）を取得するために使用
+ *
+ * @example
+ * // 基本的な使い方
+ * const { localUser, remoteUsers } = useUsers()
+ *
+ * @example
+ * // 位置情報を取得（useFrame内で毎フレーム呼び出し可能）
+ * const { remoteUsers, getMovement, getLocalMovement } = useUsers()
+ *
+ * useFrame(() => {
+ *   // 自分の位置を取得
+ *   const myMovement = getLocalMovement()
+ *
+ *   // 他のユーザーの位置を取得
+ *   remoteUsers.forEach(user => {
+ *     const movement = getMovement(user.id)
+ *     if (movement) {
+ *       console.log(`${user.displayName} is at`, movement.position)
+ *     }
+ *   })
+ * })
+ */
+export declare const useUsers: () => UsersContextValue;
+export {};
+//# sourceMappingURL=UsersContext.d.ts.map

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

@@ -0,0 +1 @@
+{"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,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;IACnB;;;;;OAKG;IACH,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAA;IAC3D;;;;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

@@ -0,0 +1,72 @@
+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未設定時は空の状態として動作
+ * 開発時やテスト時に使用される
+ */
+const createDefaultImplementation = () => ({
+    localUser: null,
+    remoteUsers: [],
+    getMovement: () => undefined,
+    getLocalMovement: () => DEFAULT_PLAYER_MOVEMENT,
+});
+/**
+ * ユーザー情報を管理するContext
+ * ワールド作成者はこのContextを通じてユーザー情報にアクセスする
+ */
+export const UsersContext = createContext(createDefaultImplementation());
+/**
+ * ユーザー情報を提供するContextProvider
+ * プラットフォーム側（xrift-frontend）が実装を注入するために使用
+ *
+ * @example
+ * // プラットフォーム側での使用例
+ * <UsersProvider implementation={usersImplementation}>
+ *   <WorldComponent />
+ * </UsersProvider>
+ */
+export const UsersProvider = ({ implementation, children }) => {
+    const value = implementation ?? createDefaultImplementation();
+    return (_jsx(UsersContext.Provider, { value: value, children: children }));
+};
+/**
+ * ユーザー情報を取得するhook
+ * ワールド作成者が現在のユーザー情報（自分＋他の参加者）を取得するために使用
+ *
+ * @example
+ * // 基本的な使い方
+ * const { localUser, remoteUsers } = useUsers()
+ *
+ * @example
+ * // 位置情報を取得（useFrame内で毎フレーム呼び出し可能）
+ * const { remoteUsers, getMovement, getLocalMovement } = useUsers()
+ *
+ * useFrame(() => {
+ *   // 自分の位置を取得
+ *   const myMovement = getLocalMovement()
+ *
+ *   // 他のユーザーの位置を取得
+ *   remoteUsers.forEach(user => {
+ *     const movement = getMovement(user.id)
+ *     if (movement) {
+ *       console.log(`${user.displayName} is at`, movement.position)
+ *     }
+ *   })
+ * })
+ */
+export const useUsers = () => {
+    return useContext(UsersContext);
+};
+//# sourceMappingURL=UsersContext.js.map

package/dist/contexts/UsersContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsersContext.js","sourceRoot":"","sources":["../../src/contexts/UsersContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAkB,UAAU,EAAE,MAAM,OAAO,CAAA;AAiBjE;;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/contexts/XRiftContext.d.ts

@@ -3,6 +3,7 @@ import type { Object3D } from 'three';
 import { type InstanceStateContextValue } from './InstanceStateContext';
 import { type ScreenShareContextValue } from './ScreenShareContext';
 import { type SpawnPointContextValue } from './SpawnPointContext';
+import { type UsersContextValue } from './UsersContext';
 export interface XRiftContextValue {
     /**
      * ワールドのベースURL（CDNのディレクトリパス）
@@ -45,6 +46,11 @@ interface Props {
      * 指定しない場合はデフォルト実装（ローカルstate）が使用される
      */
     spawnPointImplementation?: SpawnPointContextValue;
+    /**
+     * ユーザー情報の実装（オプション）
+     * 指定しない場合はデフォルト実装（空の状態）が使用される
+     */
+    usersImplementation?: UsersContextValue;
     children: ReactNode;
 }
 /**
@@ -52,7 +58,7 @@ interface Props {
  * Module Federationで動的にロードされたワールドコンポーネントに
  * 必要な情報を注入するために使用
  */
-export declare const XRiftProvider: ({ baseUrl, instanceStateImplementation, screenShareImplementation, spawnPointImplementation, children, }: Props) => import("react/jsx-runtime").JSX.Element;
+export declare const XRiftProvider: ({ baseUrl, instanceStateImplementation, screenShareImplementation, spawnPointImplementation, usersImplementation, children, }: Props) => import("react/jsx-runtime").JSX.Element;
 /**
  * XRift ワールドの情報を取得するhook
  * ワールドプロジェクト側でアセットの相対パスを絶対パスに変換する際に使用

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

@@ -1 +1 @@
-{"version":3,"file":"XRiftContext.d.ts","sourceRoot":"","sources":["../../src/contexts/XRiftContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAA8C,MAAM,OAAO,CAAA;AACjG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AACrC,OAAO,EAAyB,KAAK,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAC9F,OAAO,EAAuB,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACxF,OAAO,EAAsB,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAUrF,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,mBAAmB,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAA;IAClC;;OAEG;IACH,oBAAoB,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAA;IAChD;;OAEG;IACH,sBAAsB,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAA;CAKnD;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,mDAAgD,CAAA;AAEzE,UAAU,KAAK;IACb,OAAO,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,2BAA2B,CAAC,EAAE,yBAAyB,CAAA;IACvD;;;OAGG;IACH,yBAAyB,CAAC,EAAE,uBAAuB,CAAA;IACnD;;;OAGG;IACH,wBAAwB,CAAC,EAAE,sBAAsB,CAAA;IACjD,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,0GAM3B,KAAK,4CAsCP,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,QAAO,iBAQ3B,CAAA"}
+{"version":3,"file":"XRiftContext.d.ts","sourceRoot":"","sources":["../../src/contexts/XRiftContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAA8C,MAAM,OAAO,CAAA;AACjG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AACrC,OAAO,EAAyB,KAAK,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAC9F,OAAO,EAAuB,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACxF,OAAO,EAAsB,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AACrF,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAUtE,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,mBAAmB,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAA;IAClC;;OAEG;IACH,oBAAoB,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAA;IAChD;;OAEG;IACH,sBAAsB,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAA;CAKnD;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,mDAAgD,CAAA;AAEzE,UAAU,KAAK;IACb,OAAO,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,2BAA2B,CAAC,EAAE,yBAAyB,CAAA;IACvD;;;OAGG;IACH,yBAAyB,CAAC,EAAE,uBAAuB,CAAA;IACnD;;;OAGG;IACH,wBAAwB,CAAC,EAAE,sBAAsB,CAAA;IACjD;;;OAGG;IACH,mBAAmB,CAAC,EAAE,iBAAiB,CAAA;IACvC,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,+HAO3B,KAAK,4CAwCP,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,QAAO,iBAQ3B,CAAA"}

package/dist/contexts/XRiftContext.js

@@ -3,6 +3,7 @@ import { createContext, useCallback, useContext, useMemo, useState } from 'react
 import { InstanceStateProvider } from './InstanceStateContext';
 import { ScreenShareProvider } from './ScreenShareContext';
 import { SpawnPointProvider } from './SpawnPointContext';
+import { UsersProvider } from './UsersContext';
 // デフォルトの画面共有実装（開発環境用）
 const createDefaultScreenShareImplementation = () => ({
     videoElement: null,
@@ -20,7 +21,7 @@ export const XRiftContext = createContext(null);
  * Module Federationで動的にロードされたワールドコンポーネントに
  * 必要な情報を注入するために使用
  */
-export const XRiftProvider = ({ baseUrl, instanceStateImplementation, screenShareImplementation, spawnPointImplementation, children, }) => {
+export const XRiftProvider = ({ baseUrl, instanceStateImplementation, screenShareImplementation, spawnPointImplementation, usersImplementation, children, }) => {
     // インタラクト可能なオブジェクトの管理
     const [interactableObjects] = useState(() => new Set());
     // 画面共有の実装（指定がない場合はデフォルト実装を使用）
@@ -38,7 +39,7 @@ export const XRiftProvider = ({ baseUrl, instanceStateImplementation, screenShar
             interactableObjects,
             registerInteractable,
             unregisterInteractable,
-        }, children: _jsx(ScreenShareProvider, { value: screenShareImpl, children: _jsx(InstanceStateProvider, { implementation: instanceStateImplementation, children: _jsx(SpawnPointProvider, { implementation: spawnPointImplementation, children: children }) }) }) }));
+        }, children: _jsx(ScreenShareProvider, { value: screenShareImpl, children: _jsx(InstanceStateProvider, { implementation: instanceStateImplementation, children: _jsx(SpawnPointProvider, { implementation: spawnPointImplementation, children: _jsx(UsersProvider, { implementation: usersImplementation, children: children }) }) }) }) }));
 };
 /**
  * XRift ワールドの情報を取得するhook

package/dist/contexts/XRiftContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"XRiftContext.js","sourceRoot":"","sources":["../../src/contexts/XRiftContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAkB,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEjG,OAAO,EAAE,qBAAqB,EAAkC,MAAM,wBAAwB,CAAA;AAC9F,OAAO,EAAE,mBAAmB,EAAgC,MAAM,sBAAsB,CAAA;AACxF,OAAO,EAAE,kBAAkB,EAA+B,MAAM,qBAAqB,CAAA;AAErF,sBAAsB;AACtB,MAAM,sCAAsC,GAAG,GAA4B,EAAE,CAAC,CAAC;IAC7E,YAAY,EAAE,IAAI;IAClB,SAAS,EAAE,KAAK;IAChB,gBAAgB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC;IAC5E,eAAe,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC;CAC3E,CAAC,CAAA;AA2BF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAA2B,IAAI,CAAC,CAAA;AAsBzE;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAC5B,OAAO,EACP,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,QAAQ,GACF,EAAE,EAAE;IACV,qBAAqB;IACrB,MAAM,CAAC,mBAAmB,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,EAAY,CAAC,CAAA;IAEjE,8BAA8B;IAC9B,MAAM,eAAe,GAAG,OAAO,CAC7B,GAAG,EAAE,CAAC,yBAAyB,IAAI,sCAAsC,EAAE,EAC3E,CAAC,yBAAyB,CAAC,CAC5B,CAAA;IAED,YAAY;IACZ,MAAM,oBAAoB,GAAG,WAAW,CAAC,CAAC,MAAgB,EAAE,EAAE;QAC5D,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACjC,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAA;IAEzB,cAAc;IACd,MAAM,sBAAsB,GAAG,WAAW,CAAC,CAAC,MAAgB,EAAE,EAAE;QAC9D,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACpC,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAA;IAEzB,OAAO,CACL,KAAC,YAAY,CAAC,QAAQ,IACpB,KAAK,EAAE;YACL,OAAO;YACP,mBAAmB;YACnB,oBAAoB;YACpB,sBAAsB;SACvB,YAED,KAAC,mBAAmB,IAAC,KAAK,EAAE,eAAe,YACzC,KAAC,qBAAqB,IAAC,cAAc,EAAE,2BAA2B,YAChE,KAAC,kBAAkB,IAAC,cAAc,EAAE,wBAAwB,YACzD,QAAQ,GACU,GACC,GACJ,GACA,CACzB,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAsB,EAAE;IAC9C,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,CAAA;IAExC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;IAC/D,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}
+{"version":3,"file":"XRiftContext.js","sourceRoot":"","sources":["../../src/contexts/XRiftContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAkB,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEjG,OAAO,EAAE,qBAAqB,EAAkC,MAAM,wBAAwB,CAAA;AAC9F,OAAO,EAAE,mBAAmB,EAAgC,MAAM,sBAAsB,CAAA;AACxF,OAAO,EAAE,kBAAkB,EAA+B,MAAM,qBAAqB,CAAA;AACrF,OAAO,EAAE,aAAa,EAA0B,MAAM,gBAAgB,CAAA;AAEtE,sBAAsB;AACtB,MAAM,sCAAsC,GAAG,GAA4B,EAAE,CAAC,CAAC;IAC7E,YAAY,EAAE,IAAI;IAClB,SAAS,EAAE,KAAK;IAChB,gBAAgB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC;IAC5E,eAAe,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC;CAC3E,CAAC,CAAA;AA2BF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAA2B,IAAI,CAAC,CAAA;AA2BzE;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAC5B,OAAO,EACP,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,QAAQ,GACF,EAAE,EAAE;IACV,qBAAqB;IACrB,MAAM,CAAC,mBAAmB,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,EAAY,CAAC,CAAA;IAEjE,8BAA8B;IAC9B,MAAM,eAAe,GAAG,OAAO,CAC7B,GAAG,EAAE,CAAC,yBAAyB,IAAI,sCAAsC,EAAE,EAC3E,CAAC,yBAAyB,CAAC,CAC5B,CAAA;IAED,YAAY;IACZ,MAAM,oBAAoB,GAAG,WAAW,CAAC,CAAC,MAAgB,EAAE,EAAE;QAC5D,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACjC,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAA;IAEzB,cAAc;IACd,MAAM,sBAAsB,GAAG,WAAW,CAAC,CAAC,MAAgB,EAAE,EAAE;QAC9D,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACpC,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAA;IAEzB,OAAO,CACL,KAAC,YAAY,CAAC,QAAQ,IACpB,KAAK,EAAE;YACL,OAAO;YACP,mBAAmB;YACnB,oBAAoB;YACpB,sBAAsB;SACvB,YAED,KAAC,mBAAmB,IAAC,KAAK,EAAE,eAAe,YACzC,KAAC,qBAAqB,IAAC,cAAc,EAAE,2BAA2B,YAChE,KAAC,kBAAkB,IAAC,cAAc,EAAE,wBAAwB,YAC1D,KAAC,aAAa,IAAC,cAAc,EAAE,mBAAmB,YAC/C,QAAQ,GACK,GACG,GACC,GACJ,GACA,CACzB,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAsB,EAAE;IAC9C,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,CAAA;IAExC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;IAC/D,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { XRiftContext, XRiftProvider, useXRift, type XRiftContextValue, } from '
 export { InstanceStateContext, useInstanceStateContext, type InstanceStateContextValue, } from './contexts/InstanceStateContext';
 export { ScreenShareContext, ScreenShareProvider, useScreenShareContext, type ScreenShareContextValue, } from './contexts/ScreenShareContext';
 export { SpawnPointContext, SpawnPointProvider, useSpawnPointContext, type SpawnPoint as SpawnPointData, type SpawnPointContextValue, } from './contexts/SpawnPointContext';
+export { UsersContext, UsersProvider, useUsers, type User, type UsersContextValue, } from './contexts/UsersContext';
 export { Interactable, type InteractableProps, } from './components/Interactable';
 export { Mirror, type MirrorProps } from './components/Mirror';
 export { Skybox, type SkyboxProps } from './components/Skybox';
@@ -10,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;AAGrC,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/index.js

@@ -3,6 +3,7 @@ export { XRiftContext, XRiftProvider, useXRift, } from './contexts/XRiftContext'
 export { InstanceStateContext, useInstanceStateContext, } from './contexts/InstanceStateContext';
 export { ScreenShareContext, ScreenShareProvider, useScreenShareContext, } from './contexts/ScreenShareContext';
 export { SpawnPointContext, SpawnPointProvider, useSpawnPointContext, } from './contexts/SpawnPointContext';
+export { UsersContext, UsersProvider, useUsers, } from './contexts/UsersContext';
 // Components
 export { Interactable, } from './components/Interactable';
 export { Mirror } from './components/Mirror';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EACL,YAAY,EACZ,aAAa,EACb,QAAQ,GAET,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,GAExB,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,GAEtB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GAGrB,MAAM,8BAA8B,CAAA;AAErC,aAAa;AACb,OAAO,EACL,YAAY,GAEb,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAA;AAE9D,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAA;AAE9D,OAAO,EACL,WAAW,GAGZ,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EACL,kBAAkB,GAEnB,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,UAAU,GAEX,MAAM,yBAAyB,CAAA;AAEhC,QAAQ;AACR,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EACL,YAAY,EACZ,aAAa,EACb,QAAQ,GAET,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,GAExB,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,GAEtB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GAGrB,MAAM,8BAA8B,CAAA;AAErC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,QAAQ,GAGT,MAAM,yBAAyB,CAAA;AAEhC,aAAa;AACb,OAAO,EACL,YAAY,GAEb,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAA;AAE9D,OAAO,EAAE,MAAM,EAAoB,MAAM,qBAAqB,CAAA;AAE9D,OAAO,EACL,WAAW,GAGZ,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EACL,kBAAkB,GAEnB,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,UAAU,GAEX,MAAM,yBAAyB,CAAA;AAEhC,QAAQ;AACR,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,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.12.5",
+  "version": "0.14.0",
   "description": "Shared components and utilities for Xrift worlds",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",