@replicast/react 0.1.0

package/dist/connection-store.d.ts

@@ -0,0 +1,16 @@
+export type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+export type ConnectionQuality = 'good' | 'fair' | 'poor';
+export interface ConnectionState {
+    status: ConnectionStatus;
+    playerId: string | null;
+    latency: number | null;
+    quality: ConnectionQuality | null;
+}
+interface ConnectionStore extends ConnectionState {
+    setStatus: (status: ConnectionStatus, playerId: string | null) => void;
+    setLatency: (latency: number, quality: ConnectionQuality) => void;
+}
+export declare function createConnectionStore(): import("zustand").UseBoundStore<import("zustand").StoreApi<ConnectionStore>>;
+export type ConnectionStoreInstance = ReturnType<typeof createConnectionStore>;
+export {};
+//# sourceMappingURL=connection-store.d.ts.map

package/dist/connection-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-store.d.ts","sourceRoot":"","sources":["../src/connection-store.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAA;AAC3F,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;AAExD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,gBAAgB,CAAA;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAClC;AAED,UAAU,eAAgB,SAAQ,eAAe;IAC/C,SAAS,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACtE,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAA;CAClE;AAED,wBAAgB,qBAAqB,iFASpC;AAED,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAA"}

package/dist/connection-store.js

@@ -0,0 +1,12 @@
+import { create } from 'zustand';
+export function createConnectionStore() {
+    return create((set) => ({
+        status: 'disconnected',
+        playerId: null,
+        latency: null,
+        quality: null,
+        setStatus: (status, playerId) => set({ status, playerId }),
+        setLatency: (latency, quality) => set({ latency, quality }),
+    }));
+}
+//# sourceMappingURL=connection-store.js.map

package/dist/connection-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-store.js","sourceRoot":"","sources":["../src/connection-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAiBhC,MAAM,UAAU,qBAAqB;IACnC,OAAO,MAAM,CAAkB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,EAAE,cAAc;QACtB,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAC1D,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;KAC5D,CAAC,CAAC,CAAA;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { initRPC } from './init-rpc.js';
+export type { ConnectionState, ConnectionStatus, ConnectionQuality } from './connection-store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { initRPC } from './init-rpc.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA"}

package/dist/init-rpc.d.ts

@@ -0,0 +1,26 @@
+interface StoreEntry {
+    instance: object;
+    name: string;
+}
+interface InitRPCOptions {
+    client: {
+        playerId: string | null;
+        latency: number | null;
+        quality: any;
+        onStatusChange?: (status: any) => void;
+        onLatencyChange?: (latency: number, quality: any) => void;
+    };
+    stores: StoreEntry[];
+}
+type UseStoreHook<T extends object> = () => T;
+type RPCResult<Stores extends StoreEntry[]> = {
+    useConnection: () => import('./connection-store.js').ConnectionState;
+} & {
+    [K in Stores[number] as `use${K['name']}`]: UseStoreHook<K['instance'] & object>;
+};
+export declare function initRPC<Stores extends StoreEntry[]>(options: {
+    client: InitRPCOptions['client'];
+    stores: Stores;
+}): RPCResult<Stores>;
+export {};
+//# sourceMappingURL=init-rpc.d.ts.map

package/dist/init-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-rpc.d.ts","sourceRoot":"","sources":["../src/init-rpc.ts"],"names":[],"mappings":"AAIA,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,UAAU,cAAc;IACtB,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;QACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;QACtB,OAAO,EAAE,GAAG,CAAA;QACZ,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAA;QACtC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,IAAI,CAAA;KAC1D,CAAA;IACD,MAAM,EAAE,UAAU,EAAE,CAAA;CACrB;AAED,KAAK,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,CAAC,CAAA;AAE7C,KAAK,SAAS,CAAC,MAAM,SAAS,UAAU,EAAE,IAAI;IAC5C,aAAa,EAAE,MAAM,OAAO,uBAAuB,EAAE,eAAe,CAAA;CACrE,GAAG;KACD,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC;CACjF,CAAA;AAED,wBAAgB,OAAO,CAAC,MAAM,SAAS,UAAU,EAAE,EACjD,OAAO,EAAE;IAAE,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5D,SAAS,CAAC,MAAM,CAAC,CAyDnB"}

package/dist/init-rpc.js

@@ -0,0 +1,50 @@
+import { create } from 'zustand';
+import { createConnectionStore } from './connection-store.js';
+import { createUseConnection } from './use-connection.js';
+export function initRPC(options) {
+    const { client, stores } = options;
+    // Set up connection Zustand store
+    const connectionStore = createConnectionStore();
+    client.onStatusChange = (status) => {
+        connectionStore.getState().setStatus(status, client.playerId);
+    };
+    client.onLatencyChange = (latency, quality) => {
+        connectionStore.getState().setLatency(latency, quality);
+    };
+    // Build per-store Zustand stores
+    const storeHooks = {};
+    for (const { instance, name } of stores) {
+        // Create a snapshot of the instance's public state as initial state.
+        // Use getSnapshot() if available (BaseStore) to avoid capturing private runtime fields.
+        const maybeStore = instance;
+        const initialState = typeof maybeStore.getSnapshot === 'function'
+            ? maybeStore.getSnapshot()
+            : Object.fromEntries(Object.entries(instance)
+                .filter(([k, v]) => !k.startsWith('_') && v !== undefined));
+        const zustandStore = create(() => ({ ...initialState }));
+        // Wire up _onReplication to update the Zustand store if instance is a BaseStore.
+        // Always overwrite to ensure re-wiring on a second initRPC call is consistent.
+        maybeStore._onReplication = (batch) => {
+            const update = {};
+            if (batch.global && Object.keys(batch.global).length > 0) {
+                Object.assign(update, batch.global);
+            }
+            if (batch.ownerByPlayer instanceof Map) {
+                const ownPatch = batch.ownerByPlayer.get(client.playerId);
+                if (ownPatch?.patch && Object.keys(ownPatch.patch).length > 0) {
+                    Object.assign(update, ownPatch.patch);
+                }
+            }
+            if (Object.keys(update).length > 0) {
+                zustandStore.setState(update);
+            }
+        };
+        storeHooks[`use${name}`] = () => zustandStore();
+    }
+    const result = {
+        useConnection: createUseConnection(connectionStore),
+        ...storeHooks,
+    };
+    return result;
+}
+//# sourceMappingURL=init-rpc.js.map

package/dist/init-rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-rpc.js","sourceRoot":"","sources":["../src/init-rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AA0BzD,MAAM,UAAU,OAAO,CACrB,OAA6D;IAE7D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IAElC,kCAAkC;IAClC,MAAM,eAAe,GAAG,qBAAqB,EAAE,CAAA;IAE/C,MAAM,CAAC,cAAc,GAAG,CAAC,MAAM,EAAE,EAAE;QACjC,eAAe,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC/D,CAAC,CAAA;IAED,MAAM,CAAC,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAC5C,eAAe,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACzD,CAAC,CAAA;IAED,iCAAiC;IACjC,MAAM,UAAU,GAAiC,EAAE,CAAA;IAEnD,KAAK,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;QACxC,qEAAqE;QACrE,wFAAwF;QACxF,MAAM,UAAU,GAAG,QAAe,CAAA;QAClC,MAAM,YAAY,GAAG,OAAO,UAAU,CAAC,WAAW,KAAK,UAAU;YAC/D,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE;YAC1B,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,QAAmC,CAAC;iBAChD,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAC7D,CAAA;QAEL,MAAM,YAAY,GAAG,MAAM,CAA0B,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,YAAY,EAAE,CAAC,CAAC,CAAA;QAEjF,iFAAiF;QACjF,+EAA+E;QAC/E,UAAU,CAAC,cAAc,GAAG,CAAC,KAAU,EAAE,EAAE;YACzC,MAAM,MAAM,GAA4B,EAAE,CAAA;YAC1C,IAAI,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzD,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;YACrC,CAAC;YACD,IAAI,KAAK,CAAC,aAAa,YAAY,GAAG,EAAE,CAAC;gBACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;gBACzD,IAAI,QAAQ,EAAE,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC9D,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;gBACvC,CAAC;YACH,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YAC/B,CAAC;QACH,CAAC,CAAA;QAED,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,YAAY,EAAE,CAAA;IACjD,CAAC;IAED,MAAM,MAAM,GAAQ;QAClB,aAAa,EAAE,mBAAmB,CAAC,eAAe,CAAC;QACnD,GAAG,UAAU;KACd,CAAA;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/use-connection.d.ts

@@ -0,0 +1,3 @@
+import type { ConnectionState, ConnectionStoreInstance } from './connection-store.js';
+export declare function createUseConnection(store: ConnectionStoreInstance): () => ConnectionState;
+//# sourceMappingURL=use-connection.d.ts.map

package/dist/use-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-connection.d.ts","sourceRoot":"","sources":["../src/use-connection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAErF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,uBAAuB,SAC/B,eAAe,CAQjD"}

package/dist/use-connection.js

@@ -0,0 +1,12 @@
+import { useShallow } from 'zustand/react/shallow';
+export function createUseConnection(store) {
+    return function useConnection() {
+        return store(useShallow((s) => ({
+            status: s.status,
+            playerId: s.playerId,
+            latency: s.latency,
+            quality: s.quality,
+        })));
+    };
+}
+//# sourceMappingURL=use-connection.js.map

package/dist/use-connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-connection.js","sourceRoot":"","sources":["../src/use-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAGlD,MAAM,UAAU,mBAAmB,CAAC,KAA8B;IAChE,OAAO,SAAS,aAAa;QAC3B,OAAO,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9B,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB,CAAC,CAAC,CAAC,CAAA;IACN,CAAC,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@replicast/react",
+  "version": "0.1.0",
+  "description": "React hooks for replicast — initRPC, useConnection, and reactive per-store hooks",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@replicast/core": "*",
+    "zustand": "^4.5.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^18.0.0",
+    "jsdom": "^29.1.1",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "vitest": "^1.6.0"
+  }
+}