@xrift/world-components 0.2.5 → 0.4.0

package/README.md

@@ -48,6 +48,59 @@ function MyWorld() {
 }
 ```
 
+### useInstanceState フック
+
+インスタンス全体で同期される状態を管理するフックです。React の `useState` と同じAPIを提供します。
+
+```tsx
+import { useInstanceState } from '@xrift/world-components'
+
+function MyWorld() {
+  // インスタンス全体で同期される状態
+  const [buttonState, setButtonState] = useInstanceState('button-1', { enabled: false })
+
+  return (
+    <Interactable
+      id="button-1"
+      onInteract={() => {
+        // 状態を更新（全てのクライアントで同期される）
+        setButtonState({ enabled: !buttonState.enabled })
+      }}
+    >
+      <mesh>
+        <meshStandardMaterial color={buttonState.enabled ? 'green' : 'red'} />
+      </mesh>
+    </Interactable>
+  )
+}
+```
+
+#### 使用方法
+
+```tsx
+const [state, setState] = useInstanceState<T>(stateId, initialState)
+```
+
+- `stateId`: 状態の一意識別子（インスタンス内で一意である必要があります）
+- `initialState`: 初期状態
+- `setState`: 状態を更新する関数（直接値 or 関数型アップデートをサポート）
+
+#### 関数型アップデート
+
+```tsx
+// 直接値を設定
+setState({ enabled: true })
+
+// 前の状態を基に更新
+setState(prev => ({ enabled: !prev.enabled }))
+```
+
+#### 注意事項
+
+- Context未設定時はローカル `useState` として動作します
+- プラットフォーム側（xrift-frontend）がWebSocket実装を注入することで、インスタンス全体での同期が有効になります
+- 状態はシリアライズ可能な値（JSON）である必要があります
+
 ### Interactable コンポーネント
 
 3Dオブジェクトをインタラクション可能にするラッパーコンポーネントです。

package/dist/components/Interactable/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Interactable/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAsE,KAAK,EAAE,EAAE,MAAM,OAAO,CAAA;AAGnG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAIpC,eAAO,MAAM,YAAY,EAAE,EAAE,CAAC,KAAK,CA0GlC,CAAA;AAED,YAAY,EAAE,KAAK,IAAI,iBAAiB,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Interactable/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAsE,KAAK,EAAE,EAAE,MAAM,OAAO,CAAA;AAGnG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAIpC,eAAO,MAAM,YAAY,EAAE,EAAE,CAAC,KAAK,CAgHlC,CAAA;AAED,YAAY,EAAE,KAAK,IAAI,iBAAiB,EAAE,MAAM,SAAS,CAAA"}

package/dist/components/Interactable/index.js

@@ -4,9 +4,9 @@ import { Children, cloneElement, isValidElement, useEffect, useMemo, useRef } fr
 import { useXRift } from '../../contexts/XRiftContext';
 const INTERACTABLE_LAYER = 10;
 export const Interactable = ({ id, type = 'button', onInteract, interactionText, enabled = true, children, }) => {
-    const { currentTarget } = useXRift();
+    const { currentTarget, registerInteractable, unregisterInteractable } = useXRift();
     const groupRef = useRef(null);
-    // userDataにインタラクション情報を設定 & レイヤー設定
+    // userDataにインタラクション情報を設定 & レイヤー設定 & オブジェクト登録
     useEffect(() => {
         const object = groupRef.current;
         if (!object)
@@ -24,8 +24,12 @@ export const Interactable = ({ id, type = 'button', onInteract, interactionText,
         object.traverse((child) => {
             child.layers.enable(INTERACTABLE_LAYER);
         });
+        // インタラクト可能オブジェクトとして登録
+        registerInteractable(object);
         // クリーンアップ: userDataからインタラクション情報を削除
         return () => {
+            // 登録解除
+            unregisterInteractable(object);
             if (object.userData) {
                 delete object.userData.id;
                 delete object.userData.type;
@@ -38,7 +42,7 @@ export const Interactable = ({ id, type = 'button', onInteract, interactionText,
                 child.layers.disable(INTERACTABLE_LAYER);
             });
         };
-    }, [id, type, onInteract, interactionText, enabled]);
+    }, [id, type, onInteract, interactionText, enabled, registerInteractable, unregisterInteractable]);
     // 現在のターゲットかどうかで視覚的フィードバックを提供
     const isTargeted = currentTarget !== null && currentTarget.uuid === groupRef.current?.uuid;
     // 再帰的に子要素を探索して、すべての<mesh>に<Outlines>を追加する関数

package/dist/components/Interactable/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/Interactable/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/Interactable/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAW,MAAM,OAAO,CAAA;AAEnG,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAGtD,MAAM,kBAAkB,GAAG,EAAE,CAAA;AAE7B,MAAM,CAAC,MAAM,YAAY,GAAc,CAAC,EACtC,EAAE,EACF,IAAI,GAAG,QAAQ,EACf,UAAU,EACV,eAAe,EACf,OAAO,GAAG,IAAI,EACd,QAAQ,GACT,EAAE,EAAE;IACH,MAAM,EAAE,aAAa,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,GAAG,QAAQ,EAAE,CAAA;IAClF,MAAM,QAAQ,GAAG,MAAM,CAAQ,IAAI,CAAC,CAAA;IAEpC,6CAA6C;IAC7C,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAA;QAC/B,IAAI,CAAC,MAAM;YAAE,OAAM;QAEnB,yBAAyB;QACzB,MAAM,gBAAgB,GAAG;YACvB,EAAE;YACF,IAAI;YACJ,UAAU;YACV,eAAe;YACf,OAAO;SACR,CAAA;QAED,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAA;QAEhD,wBAAwB;QACxB,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE;YACxB,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAA;QACzC,CAAC,CAAC,CAAA;QAEF,sBAAsB;QACtB,oBAAoB,CAAC,MAAM,CAAC,CAAA;QAE5B,mCAAmC;QACnC,OAAO,GAAG,EAAE;YACV,OAAO;YACP,sBAAsB,CAAC,MAAM,CAAC,CAAA;YAE9B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAA;gBACzB,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAA;gBAC3B,OAAO,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAA;gBACjC,OAAO,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAA;gBACtC,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAA;YAChC,CAAC;YAED,WAAW;YACX,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE;gBACxB,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAA;YAC1C,CAAC,CAAC,CAAA;QACJ,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,CAAC,CAAC,CAAA;IAElG,6BAA6B;IAC7B,MAAM,UAAU,GAAG,aAAa,KAAK,IAAI,IAAI,aAAa,CAAC,IAAI,KAAK,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAA;IAE1F,4CAA4C;IAC5C,gDAAgD;IAChD,MAAM,oBAAoB,GAAG,OAAO,CAAC,GAAG,EAAE;QACxC,MAAM,mBAAmB,GAAG,CAAC,KAAsB,EAAmB,EAAE;YACtE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAA;YAExC,0BAA0B;YAC1B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAA;YAC5B,MAAM,MAAM,GAAG,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,MAAM,CAAA;YAEpE,4BAA4B;YAC5B,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,YAAY,CAAC,KAAK,EAAE;oBACzB,QAAQ,EAAE,CACR,8BAEI,KAAK,CAAC,KAAa,CAAC,QAAQ,EAC7B,UAAU,IAAI,OAAO,IAAI,CACxB,KAAC,QAAQ,IACP,SAAS,EAAE,CAAC,EACZ,KAAK,EAAC,SAAS,EACf,WAAW,EAAE,KAAK,EAClB,OAAO,EAAE,CAAC,EACV,WAAW,EAAE,KAAK,EAClB,KAAK,EAAE,IAAI,CAAC,EAAE,GACd,CACH,IACA,CACJ;iBACO,CAAC,CAAA;YACb,CAAC;YAED,uBAAuB;YACvB,8DAA8D;YAC9D,MAAM,aAAa,GAAI,KAAK,CAAC,KAAa,CAAC,QAAQ,CAAA;YACnD,IAAI,aAAa,EAAE,CAAC;gBAClB,OAAO,YAAY,CAAC,KAAK,EAAE;oBACzB,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,UAAU,EAAE,EAAE,CACnD,mBAAmB,CAAC,UAAU,CAAC,CAChC;iBACO,CAAC,CAAA;YACb,CAAC;YAED,OAAO,KAAK,CAAA;QACd,CAAC,CAAA;QAED,OAAO,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAA;IACtE,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAA;IAEnC,OAAO,CACL,gBAAO,GAAG,EAAE,QAAQ,YACjB,oBAAoB,GACf,CACT,CAAA;AACH,CAAC,CAAA"}

package/dist/contexts/InstanceStateContext.d.ts

@@ -0,0 +1,45 @@
+import { type ReactNode } from 'react';
+/**
+ * インスタンス状態を管理するためのインターフェース
+ * プラットフォーム側（xrift-frontend）がWebSocket実装を注入する
+ */
+export interface InstanceStateContextValue {
+    /**
+     * 指定されたIDの状態を取得する
+     * @param stateId 状態の一意識別子
+     * @param initialState 初期状態
+     * @returns [現在の状態, 状態更新関数]
+     */
+    getState: <T>(stateId: string, initialState: T) => [T, (state: T | ((prevState: T) => T)) => void];
+}
+/**
+ * インスタンス状態を管理するContext
+ * ワールド作成者はこのContextを通じてインスタンス全体で同期される状態にアクセスする
+ */
+export declare const InstanceStateContext: import("react").Context<InstanceStateContextValue>;
+interface Props {
+    /**
+     * プラットフォーム側が提供する実装（WebSocket同期など）
+     * 未指定の場合はデフォルト実装（ローカルstate）が使用される
+     */
+    implementation?: InstanceStateContextValue;
+    children: ReactNode;
+}
+/**
+ * インスタンス状態を提供するContextProvider
+ * プラットフォーム側（xrift-frontend）がWebSocket実装を注入するために使用
+ *
+ * @example
+ * // プラットフォーム側での使用例
+ * <InstanceStateProvider implementation={webSocketImplementation}>
+ *   <WorldComponent />
+ * </InstanceStateProvider>
+ */
+export declare const InstanceStateProvider: ({ implementation, children }: Props) => import("react/jsx-runtime").JSX.Element;
+/**
+ * インスタンス状態のContextを取得するhook
+ * 通常、ワールド作成者は直接このhookを使用せず、useInstanceStateを使用する
+ */
+export declare const useInstanceStateContext: () => InstanceStateContextValue;
+export {};
+//# sourceMappingURL=InstanceStateContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InstanceStateContext.d.ts","sourceRoot":"","sources":["../../src/contexts/InstanceStateContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAwB,MAAM,OAAO,CAAA;AAE3E;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,CAAC,EACV,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,CAAC,KACZ,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAA;CACrD;AA2BD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,oDAEhC,CAAA;AAED,UAAU,KAAK;IACb;;;OAGG;IACH,cAAc,CAAC,EAAE,yBAAyB,CAAA;IAC1C,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,GAAI,8BAA8B,KAAK,4CASxE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAAO,yBAE1C,CAAA"}

package/dist/contexts/InstanceStateContext.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useState } from 'react';
+/**
+ * デフォルト実装: Context未設定時はローカルuseStateとして動作
+ * 開発時やテスト時に使用される
+ */
+const createDefaultImplementation = () => {
+    const stateMap = new Map();
+    const setterMap = new Map();
+    return {
+        getState: (stateId, initialState) => {
+            // このstateIdで既に状態が存在する場合は既存の状態を返す
+            if (stateMap.has(stateId)) {
+                return [stateMap.get(stateId), setterMap.get(stateId)];
+            }
+            // 新しい状態を作成
+            const [state, setState] = useState(initialState);
+            stateMap.set(stateId, state);
+            setterMap.set(stateId, setState);
+            return [state, setState];
+        },
+    };
+};
+/**
+ * インスタンス状態を管理するContext
+ * ワールド作成者はこのContextを通じてインスタンス全体で同期される状態にアクセスする
+ */
+export const InstanceStateContext = createContext(createDefaultImplementation());
+/**
+ * インスタンス状態を提供するContextProvider
+ * プラットフォーム側（xrift-frontend）がWebSocket実装を注入するために使用
+ *
+ * @example
+ * // プラットフォーム側での使用例
+ * <InstanceStateProvider implementation={webSocketImplementation}>
+ *   <WorldComponent />
+ * </InstanceStateProvider>
+ */
+export const InstanceStateProvider = ({ implementation, children }) => {
+    const defaultImplementation = createDefaultImplementation();
+    const value = implementation || defaultImplementation;
+    return (_jsx(InstanceStateContext.Provider, { value: value, children: children }));
+};
+/**
+ * インスタンス状態のContextを取得するhook
+ * 通常、ワールド作成者は直接このhookを使用せず、useInstanceStateを使用する
+ */
+export const useInstanceStateContext = () => {
+    return useContext(InstanceStateContext);
+};
+//# sourceMappingURL=InstanceStateContext.js.map

package/dist/contexts/InstanceStateContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstanceStateContext.js","sourceRoot":"","sources":["../../src/contexts/InstanceStateContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAkB,UAAU,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAmB3E;;;GAGG;AACH,MAAM,2BAA2B,GAAG,GAA8B,EAAE;IAClE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAe,CAAA;IACvC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAgC,CAAA;IAEzD,OAAO;QACL,QAAQ,EAAE,CAAK,OAAe,EAAE,YAAe,EAAE,EAAE;YACjD,iCAAiC;YACjC,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,CAAA;YACzD,CAAC;YAED,WAAW;YACX,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAI,YAAY,CAAC,CAAA;YACnD,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YAC5B,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;YAEhC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QAC1B,CAAC;KACF,CAAA;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAC/C,2BAA2B,EAAE,CAC9B,CAAA;AAWD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,EAAE,cAAc,EAAE,QAAQ,EAAS,EAAE,EAAE;IAC3E,MAAM,qBAAqB,GAAG,2BAA2B,EAAE,CAAA;IAC3D,MAAM,KAAK,GAAG,cAAc,IAAI,qBAAqB,CAAA;IAErD,OAAO,CACL,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACxC,QAAQ,GACqB,CACjC,CAAA;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAA8B,EAAE;IACrE,OAAO,UAAU,CAAC,oBAAoB,CAAC,CAAA;AACzC,CAAC,CAAA"}

package/dist/contexts/XRiftContext.d.ts

@@ -1,5 +1,6 @@
 import { type ReactNode } from 'react';
 import type { Object3D } from 'three';
+import { type InstanceStateContextValue } from './InstanceStateContext';
 export interface XRiftContextValue {
     /**
      * ワールドのベースURL（CDNのディレクトリパス）
@@ -11,6 +12,19 @@ export interface XRiftContextValue {
      * xrift-frontend側のRaycastDetectorが設定する
      */
     currentTarget: Object3D | null;
+    /**
+     * インタラクト可能なオブジェクトのセット
+     * レイキャストのパフォーマンス最適化のために使用
+     */
+    interactableObjects: Set<Object3D>;
+    /**
+     * インタラクト可能なオブジェクトを登録
+     */
+    registerInteractable: (object: Object3D) => void;
+    /**
+     * インタラクト可能なオブジェクトの登録を解除
+     */
+    unregisterInteractable: (object: Object3D) => void;
 }
 /**
  * XRift ワールドの情報を提供するContext
@@ -20,6 +34,11 @@ export declare const XRiftContext: import("react").Context<XRiftContextValue | n
 interface Props {
     baseUrl: string;
     currentTarget?: Object3D | null;
+    /**
+     * インスタンス状態管理の実装（オプション）
+     * 指定しない場合はデフォルト実装（ローカルstate）が使用される
+     */
+    instanceStateImplementation?: InstanceStateContextValue;
     children: ReactNode;
 }
 /**
@@ -27,7 +46,7 @@ interface Props {
  * Module Federationで動的にロードされたワールドコンポーネントに
  * 必要な情報を注入するために使用
  */
-export declare const XRiftProvider: ({ baseUrl, currentTarget, children }: Props) => import("react/jsx-runtime").JSX.Element;
+export declare const XRiftProvider: ({ baseUrl, currentTarget, instanceStateImplementation, 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,EAAc,MAAM,OAAO,CAAA;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAErC,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,aAAa,EAAE,QAAQ,GAAG,IAAI,CAAA;CAK/B;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,mDAAgD,CAAA;AAEzE,UAAU,KAAK;IACb,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC/B,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,sCAA6C,KAAK,4CAW/E,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,EAAqC,MAAM,OAAO,CAAA;AACxF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AACrC,OAAO,EAAyB,KAAK,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAE9F,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,aAAa,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC9B;;;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,aAAa,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC/B;;;OAGG;IACH,2BAA2B,CAAC,EAAE,yBAAyB,CAAA;IACvD,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,mEAK3B,KAAK,4CA6BP,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,QAAO,iBAQ3B,CAAA"}

package/dist/contexts/XRiftContext.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, useContext } from 'react';
+import { createContext, useCallback, useContext, useState } from 'react';
+import { InstanceStateProvider } from './InstanceStateContext';
 /**
  * XRift ワールドの情報を提供するContext
  * ワールド側でこのContextを直接参照して情報を取得できる
@@ -10,11 +11,24 @@ export const XRiftContext = createContext(null);
  * Module Federationで動的にロードされたワールドコンポーネントに
  * 必要な情報を注入するために使用
  */
-export const XRiftProvider = ({ baseUrl, currentTarget = null, children }) => {
+export const XRiftProvider = ({ baseUrl, currentTarget = null, instanceStateImplementation, children }) => {
+    // インタラクト可能なオブジェクトの管理
+    const [interactableObjects] = useState(() => new Set());
+    // オブジェクトの登録
+    const registerInteractable = useCallback((object) => {
+        interactableObjects.add(object);
+    }, [interactableObjects]);
+    // オブジェクトの登録解除
+    const unregisterInteractable = useCallback((object) => {
+        interactableObjects.delete(object);
+    }, [interactableObjects]);
     return (_jsx(XRiftContext.Provider, { value: {
             baseUrl,
             currentTarget,
-        }, children: children }));
+            interactableObjects,
+            registerInteractable,
+            unregisterInteractable,
+        }, children: _jsx(InstanceStateProvider, { implementation: instanceStateImplementation, 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,UAAU,EAAE,MAAM,OAAO,CAAA;AAoBjE;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAA2B,IAAI,CAAC,CAAA;AAQzE;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,EAAE,QAAQ,EAAS,EAAE,EAAE;IAClF,OAAO,CACL,KAAC,YAAY,CAAC,QAAQ,IACpB,KAAK,EAAE;YACL,OAAO;YACP,aAAa;SACd,YAEA,QAAQ,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,QAAQ,EAAE,MAAM,OAAO,CAAA;AAExF,OAAO,EAAE,qBAAqB,EAAkC,MAAM,wBAAwB,CAAA;AAgC9F;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAA2B,IAAI,CAAC,CAAA;AAazE;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAC5B,OAAO,EACP,aAAa,GAAG,IAAI,EACpB,2BAA2B,EAC3B,QAAQ,EACF,EAAE,EAAE;IACV,qBAAqB;IACrB,MAAM,CAAC,mBAAmB,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,EAAY,CAAC,CAAA;IAEjE,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,aAAa;YACb,mBAAmB;YACnB,oBAAoB;YACpB,sBAAsB;SACvB,YAED,KAAC,qBAAqB,IAAC,cAAc,EAAE,2BAA2B,YAC/D,QAAQ,GACa,GACF,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/hooks/useInstanceState.d.ts

@@ -0,0 +1,38 @@
+/**
+ * インスタンス全体で同期される状態を管理するhook
+ *
+ * React の useState と同じAPIを提供します。
+ * Context未設定時はローカルstateとして動作し、
+ * プラットフォーム側が実装を注入することでWebSocket同期などが可能になります。
+ *
+ * @param stateId 状態の一意識別子（インスタンス内で一意である必要があります）
+ * @param initialState 初期状態
+ * @returns [現在の状態, 状態更新関数]
+ *
+ * @example
+ * // ボタンの有効/無効状態を管理
+ * const [buttonState, setButtonState] = useInstanceState('button-1', { enabled: false })
+ *
+ * // 直接値を設定
+ * setButtonState({ enabled: true })
+ *
+ * // 関数型アップデート
+ * setButtonState(prev => ({ enabled: !prev.enabled }))
+ *
+ * @example
+ * // より複雑な状態の管理
+ * interface DoorState {
+ *   isOpen: boolean
+ *   openedBy: string | null
+ * }
+ *
+ * const [doorState, setDoorState] = useInstanceState<DoorState>('main-door', {
+ *   isOpen: false,
+ *   openedBy: null
+ * })
+ *
+ * // ドアを開く
+ * setDoorState({ isOpen: true, openedBy: 'player-123' })
+ */
+export declare function useInstanceState<T>(stateId: string, initialState: T): [T, (state: T | ((prevState: T) => T)) => void];
+//# sourceMappingURL=useInstanceState.d.ts.map

package/dist/hooks/useInstanceState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInstanceState.d.ts","sourceRoot":"","sources":["../../src/hooks/useInstanceState.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,CAAC,GACd,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAGjD"}

package/dist/hooks/useInstanceState.js

@@ -0,0 +1,42 @@
+import { useInstanceStateContext } from '../contexts/InstanceStateContext';
+/**
+ * インスタンス全体で同期される状態を管理するhook
+ *
+ * React の useState と同じAPIを提供します。
+ * Context未設定時はローカルstateとして動作し、
+ * プラットフォーム側が実装を注入することでWebSocket同期などが可能になります。
+ *
+ * @param stateId 状態の一意識別子（インスタンス内で一意である必要があります）
+ * @param initialState 初期状態
+ * @returns [現在の状態, 状態更新関数]
+ *
+ * @example
+ * // ボタンの有効/無効状態を管理
+ * const [buttonState, setButtonState] = useInstanceState('button-1', { enabled: false })
+ *
+ * // 直接値を設定
+ * setButtonState({ enabled: true })
+ *
+ * // 関数型アップデート
+ * setButtonState(prev => ({ enabled: !prev.enabled }))
+ *
+ * @example
+ * // より複雑な状態の管理
+ * interface DoorState {
+ *   isOpen: boolean
+ *   openedBy: string | null
+ * }
+ *
+ * const [doorState, setDoorState] = useInstanceState<DoorState>('main-door', {
+ *   isOpen: false,
+ *   openedBy: null
+ * })
+ *
+ * // ドアを開く
+ * setDoorState({ isOpen: true, openedBy: 'player-123' })
+ */
+export function useInstanceState(stateId, initialState) {
+    const context = useInstanceStateContext();
+    return context.getState(stateId, initialState);
+}
+//# sourceMappingURL=useInstanceState.js.map

package/dist/hooks/useInstanceState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInstanceState.js","sourceRoot":"","sources":["../../src/hooks/useInstanceState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAA;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,YAAe;IAEf,MAAM,OAAO,GAAG,uBAAuB,EAAE,CAAA;IACzC,OAAO,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;AAChD,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export { XRiftContext, XRiftProvider, useXRift, type XRiftContextValue, } from './contexts/XRiftContext';
+export { InstanceStateContext, useInstanceStateContext, type InstanceStateContextValue, } from './contexts/InstanceStateContext';
 export { Interactable, type InteractableProps, } from './components/Interactable';
+export { useInstanceState } from './hooks/useInstanceState';
 //# 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;AAGhC,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,GACvB,MAAM,2BAA2B,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;AAGxC,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,GACvB,MAAM,2BAA2B,CAAA;AAGlC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/index.js

@@ -1,5 +1,8 @@
 // Contexts
 export { XRiftContext, XRiftProvider, useXRift, } from './contexts/XRiftContext';
+export { InstanceStateContext, useInstanceStateContext, } from './contexts/InstanceStateContext';
 // Components
 export { Interactable, } from './components/Interactable';
+// Hooks
+export { useInstanceState } from './hooks/useInstanceState';
 //# sourceMappingURL=index.js.map

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,aAAa;AACb,OAAO,EACL,YAAY,GAEb,MAAM,2BAA2B,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,aAAa;AACb,OAAO,EACL,YAAY,GAEb,MAAM,2BAA2B,CAAA;AAElC,QAAQ;AACR,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA"}

package/package.json

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