@noya-app/noya-multiplayer-react 0.1.44 → 0.1.46

package/dist/index.d.mts

@@ -1,8 +1,9 @@
 import * as _noya_app_state_manager from '@noya-app/state-manager';
-import { ConnectedUsersManager, EphemeralUserDataManager, RPCManager, StandardRPCRequestPayload, StandardRPCResponsePayload, ConnectionEvent, Task, MultiplayerStateManager, AssetManager, SecretManager as SecretManager$1, StateManager, StateManagerOptions, MultiplayerStateManagerOptions, SyncAdapterOptions, AIManager, WorkflowManager, TSchema, Static } from '@noya-app/state-manager';
+import { ConnectedUsersManager, EphemeralUserDataManager, NoyaManager, StateManager, StateManagerOptions, MultiplayerStateManagerOptions, SyncAdapter, TSchema, Static, MultiplayerStateManager, ReconnectingWebSocketState, ClientToServerMessage, ServerToClientMessage, MultiplayerStateManagerError } from '@noya-app/state-manager';
 export * from '@noya-app/state-manager';
 import React, { SetStateAction } from 'react';
-import { Observable, GetAtPath, ObservableOptions, PathKey } from '@noya-app/observable';
+import { GetAtPath, ObservableOptions, PathKey, Observable } from '@noya-app/observable';
+import * as _noya_app_noya_designsystem from '@noya-app/noya-designsystem';
 
 type Point = {
     x: number;
@@ -26,62 +27,40 @@ type UserPointersOverlayProps<E extends UserPointerData> = {
 } & RenderUserPointer;
 declare const UserPointersOverlay: <E extends UserPointerData>(props: UserPointersOverlayProps<E>) => React.ReactElement | null;
 
-type Secret = {
-    id: string;
-    name: string;
-};
-declare class SecretManager {
-    rpcManager: RPCManager<StandardRPCRequestPayload, StandardRPCResponsePayload>;
-    constructor(rpcManager: RPCManager<StandardRPCRequestPayload, StandardRPCResponsePayload>);
-    secrets$: Observable<Secret[]>;
-    isInitialized$: Observable<boolean>;
-    createSecret(name: string, value: string): Promise<StandardRPCResponsePayload>;
-    deleteSecret(name: string): Promise<StandardRPCResponsePayload>;
-}
-
 type StateInspectorAnchor = "left" | "right" | "bottom left" | "bottom right";
 type StateInspectorOptions = {
     colorScheme?: "light" | "dark";
     anchor?: StateInspectorAnchor;
 };
-declare const StateInspector: <S, M, E extends object>(props: {
-    state: S;
-    connectionEvents?: ConnectionEvent<S>[];
-    tasks?: Task[];
+declare const StateInspector: <S, M extends object, E extends object, MenuT extends string = string>(props: {
+    noyaManager: NoyaManager<S, M, E, MenuT>;
     unstyled?: boolean;
-    multiplayerStateManager: MultiplayerStateManager<S, M>;
-    assetManager: AssetManager;
-    connectedUsersManager: ConnectedUsersManager;
-    secretManager: SecretManager$1;
-    ephemeralUserDataManager: EphemeralUserDataManager<E>;
-    forceInit: () => void;
 } & StateInspectorOptions & Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">) => React.ReactElement | null;
 
 declare function useSyncStateManager<S, M>(stateManager: StateManager<S, M>): S;
 declare function useSyncStateManager<S, M, P extends string>(stateManager: StateManager<S, M>, path: P): GetAtPath<S, P>;
 declare function useManagedState<S, M = void>(createInitialState: () => S, options?: StateManagerOptions<S, M>): readonly [S, (...args: M extends {} ? [metadata: M, action: SetStateAction<S>] : [action: SetStateAction<S>]) => void, StateManager<S, M>];
 declare function useManagedHistory<S, M = void>(stateManager: StateManager<S, M>): _noya_app_state_manager.HistorySnapshot<S, M>;
-declare function useSyncMultiplayerStateManager<S, M = void>(multiplayerStateManager: MultiplayerStateManager<S, M>): S;
-type UseMultiplayerStateOptions<S, M = void, E extends object = object> = MultiplayerStateManagerOptions<S, M> & {
-    sync?: (options: Pick<SyncAdapterOptions<S, M, E>, "ms" | "ephemeralUserDataManager" | "assetManager">) => void;
-    trackConnectionEvents?: boolean;
-    trackTasks?: boolean;
+type UseMultiplayerStateOptions<S, M extends object = object, E extends object = object, MenuT extends string = string> = MultiplayerStateManagerOptions<S, M> & {
+    sync?: SyncAdapter<S, M, E, MenuT>;
     inspector?: boolean | StateInspectorOptions;
 };
-declare function useMultiplayerState<S, M = void, E extends object = object>(initialState: S | (() => S), options?: UseMultiplayerStateOptions<S, M, E>): readonly [S, (...args: M extends {} ? [metadata: M, action: S | ((prevState: S) => S)] : [action: S | ((prevState: S) => S)]) => void, {
-    tasks: Task[];
-    connectionEvents: ConnectionEvent<S>[] | undefined;
-    connectedUsersManager: ConnectedUsersManager;
-    ephemeralUserDataManager: EphemeralUserDataManager<E>;
-    multiplayerStateManager: MultiplayerStateManager<S, M>;
-    assets: _noya_app_state_manager.Asset[];
-    assetManager: AssetManager;
-    aiManager: AIManager;
-    rpcManager: RPCManager<StandardRPCRequestPayload, StandardRPCResponsePayload>;
-    workflowManager: WorkflowManager;
-    secretManager: SecretManager;
+declare function useMultiplayerState<S, M extends object = object, E extends object = object, MenuT extends string = string>(initialState: S | (() => S), options?: UseMultiplayerStateOptions<S, M, E, MenuT>): readonly [S, (...args: [metadata: Partial<M>, action: S | ((prevState: S) => S)] | [action: S | ((prevState: S) => S)]) => void, {
+    noyaManager: NoyaManager<S, M, E, MenuT>;
+    taskManager: _noya_app_state_manager.TaskManager;
+    connectionEventManager: _noya_app_state_manager.ConnectionEventManager<S>;
+    connectedUsersManager: _noya_app_state_manager.ConnectedUsersManager;
+    ephemeralUserDataManager: _noya_app_state_manager.EphemeralUserDataManager<E>;
+    multiplayerStateManager: _noya_app_state_manager.MultiplayerStateManager<S, M>;
+    assetManager: _noya_app_state_manager.AssetManager;
+    aiManager: _noya_app_state_manager.AIManager;
+    rpcManager: _noya_app_state_manager.RPCManager;
+    workflowManager: _noya_app_state_manager.WorkflowManager;
+    secretManager: _noya_app_state_manager.SecretManager;
+    menuItemsManager: _noya_app_state_manager.MenuManager<MenuT>;
     createAsset: (options: _noya_app_state_manager.CreateAssetOptions | Uint8Array | File | Blob) => Promise<_noya_app_state_manager.Asset>;
     deleteAsset: (id: string) => Promise<void>;
+    assets: _noya_app_state_manager.Asset[];
 }];
 
 type AppViewType = "editable" | "readOnly" | "preview";
@@ -105,33 +84,13 @@ type GetAppDataOptions = {
 declare function enforceSchema<State>(initialState: State, schema?: TSchema): State;
 declare function parseAppDataParameter(options?: GetAppDataOptions): AppData<unknown> | null;
 declare function getAppData<State>(initialState: State | (() => State), schema?: TSchema, options?: GetAppDataOptions): AppData<State>;
-type IframeToHostMessage = {
-    type: "application.setMenuItems";
-    payload: {
-        menuItems: any[];
-    };
-} | {
-    type: "multiplayer.setUsers";
-    payload: {
-        users: any[];
-    };
-};
-type HostToIframeMessage = {
-    type: "application.selectMenuItem";
-    payload: {
-        value: string;
-    };
-};
-declare function useBroadcastConnectedUsers(connectedUsersManager: ConnectedUsersManager): void;
-declare function useBroadcastMenuItems<T>(menuItems: any[], handleSelectMenuItem: (value: T) => void): void;
-declare function isEmbeddedApp(): boolean;
-type UseNoyaStateOptions<S, M = void, E extends object = object> = UseMultiplayerStateOptions<S, M, E> & {
+type UseNoyaStateOptions<S, M extends object = object, E extends object = object, MenuT extends string = string> = UseMultiplayerStateOptions<S, M, E, MenuT> & {
     offlineStorageKey?: string;
 };
-type UseNoyaStateResult<S, M = void, E extends object = object> = [
-    ReturnType<typeof useMultiplayerState<S, M, E>>[0],
-    ReturnType<typeof useMultiplayerState<S, M, E>>[1],
-    ReturnType<typeof useMultiplayerState<S, M, E>>[2] & {
+type UseNoyaStateResult<S, M extends object = object, E extends object = object, MenuT extends string = string> = [
+    ReturnType<typeof useMultiplayerState<S, M, E, MenuT>>[0],
+    ReturnType<typeof useMultiplayerState<S, M, E, MenuT>>[1],
+    ReturnType<typeof useMultiplayerState<S, M, E, MenuT>>[2] & {
         theme: AppTheme;
         viewType: AppViewType;
     }
@@ -145,14 +104,14 @@ type UseNoyaStateResult<S, M = void, E extends object = object> = [
  * 2. Pass an initial state and a schema: `useNoyaState(initialState, { schema })`
  * 3. Pass only a schema, and a conforming initial state is created automatically: `useNoyaState({ schema })`
  */
-declare function useNoyaState<S, M = void, E extends object = object, O extends UseNoyaStateOptions<S, M, E> = UseNoyaStateOptions<S, M, E>>(...args: [
+declare function useNoyaState<S, M extends object = object, E extends object = object, MenuT extends string = string, O extends UseNoyaStateOptions<S, M, E, MenuT> = UseNoyaStateOptions<S, M, E, MenuT>>(...args: [
     initialState: O["schema"] extends TSchema ? Static<O["schema"]> | (() => Static<O["schema"]>) : S | (() => S),
     options?: O
 ] | [options: O & {
     schema: TSchema;
-}]): UseNoyaStateResult<O["schema"] extends TSchema ? Static<O["schema"]> : S, M, E>;
+}]): UseNoyaStateResult<O["schema"] extends TSchema ? Static<O["schema"]> : S, M, E, MenuT>;
 
-interface NoyaStateProviderProps<S, M, E extends object> extends Omit<UseNoyaStateOptions<S, M, E>, "schema" | "mergeHistoryEntries"> {
+interface NoyaStateProviderProps<S, M extends object, E extends object, MenuT extends string> extends Omit<UseNoyaStateOptions<S, M, E, MenuT>, "schema" | "mergeHistoryEntries"> {
     children: React.ReactNode;
     initialState?: S;
     fallback?: React.ReactNode;
@@ -163,12 +122,12 @@ declare function useAssetManager(): {
     create: (options: _noya_app_state_manager.CreateAssetOptions | Uint8Array | File | Blob) => Promise<_noya_app_state_manager.Asset>;
     delete: (id: string) => Promise<void>;
 };
-declare function useAIManager(): AIManager;
-declare function useSecretManager(): SecretManager$1;
+declare function useAIManager(): _noya_app_state_manager.AIManager;
+declare function useSecretManager(): _noya_app_state_manager.SecretManager;
 declare function useSecrets(): _noya_app_state_manager.Secret[];
 declare function useSecret(name: string): _noya_app_state_manager.Secret | undefined;
 declare function useIsInitialized(): boolean;
-declare function useWorkflowManager(): WorkflowManager;
+declare function useWorkflowManager(): _noya_app_state_manager.WorkflowManager;
 declare const ConnectedUsersContext: React.Context<ConnectedUsersManager | undefined>;
 declare function useConnectedUsersManager(): ConnectedUsersManager | undefined;
 declare const AnyEphemeralUserDataManagerContext: React.Context<EphemeralUserDataManager<object> | undefined>;
@@ -178,32 +137,33 @@ declare const FallbackUntilInitialized: ({ children, fallback, }: {
     children: React.ReactNode;
     fallback?: React.ReactNode;
 }) => React.ReactNode;
-declare function createNoyaContext<Schema extends TSchema, M = void, E extends object = object>({ schema, mergeHistoryEntries, }: {
+declare function createNoyaContext<Schema extends TSchema, M extends object = object, E extends object = object, MenuT extends string = string>({ schema, mergeHistoryEntries, }: {
     schema: Schema;
     mergeHistoryEntries?: StateManagerOptions<Static<Schema>, M>["mergeHistoryEntries"];
 }): {
-    Context: React.Context<{
-        ms: MultiplayerStateManager<Static<Schema>, M>;
-        assetManager: AssetManager;
-        secretManager: SecretManager$1;
-    } | undefined>;
-    Provider: ({ children, initialState, ...options }: NoyaStateProviderProps<Static<Schema>, M, E>) => React.JSX.Element;
+    Context: React.Context<NoyaManager<Static<Schema>, M, E, string> | undefined>;
+    Provider: ({ children, initialState, ...options }: NoyaStateProviderProps<Static<Schema>, M, E, MenuT>) => React.JSX.Element;
     useValue: {
         (): Static<Schema>;
         <A>(selector: (value: Static<Schema>) => A, options?: Pick<ObservableOptions, "isEqual">): A;
         <P extends PathKey[] | string>(path: P): GetAtPath<Static<Schema>, P>;
     };
     useSetValue: {
-        (): M extends {} ? (metadata: M, value: SetStateAction<Static<Schema>>) => void : (value: SetStateAction<Static<Schema>>) => void;
-        <P extends PathKey[] | string>(path: P): M extends {} ? (metadata: M, value: SetStateAction<GetAtPath<Static<Schema>, P>>) => void : (value: SetStateAction<GetAtPath<Static<Schema>, P>>) => void;
+        (): (...args: [metadata: M, value: SetStateAction<Static<Schema>>] | [value: SetStateAction<Static<Schema>>]) => void;
+        <P extends PathKey[] | string>(path: P): (...args: [metadata: M, value: SetStateAction<GetAtPath<Static<Schema>, P>>] | [value: SetStateAction<GetAtPath<Static<Schema>, P>>]) => void;
     };
     useValueState: {
-        (): [Static<Schema>, M extends {} ? (metadata: M, value: SetStateAction<Static<Schema>>) => void : (value: SetStateAction<Static<Schema>>) => void];
-        <A>(selector: (value: Static<Schema>) => A, options?: ObservableOptions): [A, M extends {} ? (metadata: M, value: SetStateAction<Static<Schema>>) => void : (value: SetStateAction<Static<Schema>>) => void];
-        <P extends PathKey[] | string>(path?: P): [GetAtPath<Static<Schema>, P>, M extends {} ? (metadata: M, value: SetStateAction<GetAtPath<Static<Schema>, P>>) => void : (value: SetStateAction<GetAtPath<Static<Schema>, P>>) => void];
+        (): [Static<Schema>, (...args: [metadata: M, value: SetStateAction<Static<Schema>>] | [value: SetStateAction<Static<Schema>>]) => void];
+        <A>(selector: (value: Static<Schema>) => A, options?: ObservableOptions): [A, (...args: [metadata: M, value: SetStateAction<Static<Schema>>] | [value: SetStateAction<Static<Schema>>]) => void];
+        <P extends PathKey[] | string>(path?: P): [GetAtPath<Static<Schema>, P>, (...args: [metadata: M, value: SetStateAction<GetAtPath<Static<Schema>, P>>] | [value: SetStateAction<GetAtPath<Static<Schema>, P>>]) => void];
     };
     useStateManager: () => MultiplayerStateManager<Static<Schema>, M>;
     useEphemeralUserDataManager: () => EphemeralUserDataManager<E>;
+    useLeftMenuItems: () => _noya_app_noya_designsystem.RegularMenuItem<MenuT>[];
+    useRightMenuItems: () => _noya_app_noya_designsystem.RegularMenuItem<MenuT>[];
+    useHandleMenuItem: (callback: (type: MenuT) => void) => void;
+    useOnSelectMenuItemCallback: () => (type: MenuT) => void;
+    useNoyaManager: () => NoyaManager<Static<Schema>, M, E, MenuT>;
 };
 
 declare function useObservable<T>(observable: Observable<T>): T;
@@ -213,4 +173,39 @@ declare function useObservable<T>(observable: Observable<T> | undefined): T | un
 declare function useObservable<T, A>(observable: Observable<T> | undefined, selector: (value: T) => A, options?: Pick<ObservableOptions, "isEqual">): A | undefined;
 declare function useObservable<T, P extends PathKey[] | string>(observable: Observable<T> | undefined, path: P): GetAtPath<T, P> | undefined;
 
-export { AnyEphemeralUserDataManagerContext, type AppData, type AppTheme, type AppViewType, ConnectedUsersContext, FallbackUntilInitialized, type GetAppDataOptions, type HostToIframeMessage, type IframeToHostMessage, type RenderUserPointer, type RenderUserPointerProps, StateInspector, type StateInspectorAnchor, type StateInspectorOptions, type UseMultiplayerStateOptions, type UseNoyaStateOptions, type UseNoyaStateResult, type UserPointerData, UserPointersOverlay, type UserPointersOverlayProps, createDefaultAppData, createNoyaContext, enforceSchema, getAppData, isEmbeddedApp, parseAppDataParameter, useAIManager, useAnyEphemeralUserData, useAsset, useAssetManager, useAssets, useBroadcastConnectedUsers, useBroadcastMenuItems, useConnectedUsersManager, useCurrentUserId, useIsInitialized, useManagedHistory, useManagedState, useMultiplayerState, useNoyaState, useObservable, useSecret, useSecretManager, useSecrets, useSyncMultiplayerStateManager, useSyncStateManager, useWorkflowManager };
+type ConnectionEvent<State> = {
+    type: "stateChange";
+    state: ReconnectingWebSocketState;
+} | {
+    type: "send";
+    message: ClientToServerMessage<State>;
+} | {
+    type: "receive";
+    message: ServerToClientMessage<State>;
+} | {
+    type: "error";
+    error: MultiplayerStateManagerError;
+};
+type ConnectionOptions<State> = {
+    debug?: boolean;
+    onConnectionEvent?: (event: ConnectionEvent<State>) => void;
+};
+declare class WebSocketConnection<State> {
+    private url;
+    private options;
+    private ws;
+    private pingCount;
+    private pendingPingId?;
+    private intervalId?;
+    constructor(url: URL, options?: ConnectionOptions<State>);
+    connect(): Promise<void>;
+    private handleOpen;
+    private handleMessage;
+    private handleClose;
+    send(message: ClientToServerMessage<State>): void;
+    close(): void;
+    addListener(listener: (state: ReconnectingWebSocketState) => void): () => void;
+    removeListener(listener: (state: ReconnectingWebSocketState) => void): void;
+}
+
+export { AnyEphemeralUserDataManagerContext, type AppData, type AppTheme, type AppViewType, ConnectedUsersContext, type ConnectionEvent, type ConnectionOptions, FallbackUntilInitialized, type GetAppDataOptions, type RenderUserPointer, type RenderUserPointerProps, StateInspector, type StateInspectorAnchor, type StateInspectorOptions, type UseMultiplayerStateOptions, type UseNoyaStateOptions, type UseNoyaStateResult, type UserPointerData, UserPointersOverlay, type UserPointersOverlayProps, WebSocketConnection, createDefaultAppData, createNoyaContext, enforceSchema, getAppData, parseAppDataParameter, useAIManager, useAnyEphemeralUserData, useAsset, useAssetManager, useAssets, useConnectedUsersManager, useCurrentUserId, useIsInitialized, useManagedHistory, useManagedState, useMultiplayerState, useNoyaState, useObservable, useSecret, useSecretManager, useSecrets, useSyncStateManager, useWorkflowManager };

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import * as _noya_app_state_manager from '@noya-app/state-manager';
-import { ConnectedUsersManager, EphemeralUserDataManager, RPCManager, StandardRPCRequestPayload, StandardRPCResponsePayload, ConnectionEvent, Task, MultiplayerStateManager, AssetManager, SecretManager as SecretManager$1, StateManager, StateManagerOptions, MultiplayerStateManagerOptions, SyncAdapterOptions, AIManager, WorkflowManager, TSchema, Static } from '@noya-app/state-manager';
+import { ConnectedUsersManager, EphemeralUserDataManager, NoyaManager, StateManager, StateManagerOptions, MultiplayerStateManagerOptions, SyncAdapter, TSchema, Static, MultiplayerStateManager, ReconnectingWebSocketState, ClientToServerMessage, ServerToClientMessage, MultiplayerStateManagerError } from '@noya-app/state-manager';
 export * from '@noya-app/state-manager';
 import React, { SetStateAction } from 'react';
-import { Observable, GetAtPath, ObservableOptions, PathKey } from '@noya-app/observable';
+import { GetAtPath, ObservableOptions, PathKey, Observable } from '@noya-app/observable';
+import * as _noya_app_noya_designsystem from '@noya-app/noya-designsystem';
 
 type Point = {
     x: number;
@@ -26,62 +27,40 @@ type UserPointersOverlayProps<E extends UserPointerData> = {
 } & RenderUserPointer;
 declare const UserPointersOverlay: <E extends UserPointerData>(props: UserPointersOverlayProps<E>) => React.ReactElement | null;
 
-type Secret = {
-    id: string;
-    name: string;
-};
-declare class SecretManager {
-    rpcManager: RPCManager<StandardRPCRequestPayload, StandardRPCResponsePayload>;
-    constructor(rpcManager: RPCManager<StandardRPCRequestPayload, StandardRPCResponsePayload>);
-    secrets$: Observable<Secret[]>;
-    isInitialized$: Observable<boolean>;
-    createSecret(name: string, value: string): Promise<StandardRPCResponsePayload>;
-    deleteSecret(name: string): Promise<StandardRPCResponsePayload>;
-}
-
 type StateInspectorAnchor = "left" | "right" | "bottom left" | "bottom right";
 type StateInspectorOptions = {
     colorScheme?: "light" | "dark";
     anchor?: StateInspectorAnchor;
 };
-declare const StateInspector: <S, M, E extends object>(props: {
-    state: S;
-    connectionEvents?: ConnectionEvent<S>[];
-    tasks?: Task[];
+declare const StateInspector: <S, M extends object, E extends object, MenuT extends string = string>(props: {
+    noyaManager: NoyaManager<S, M, E, MenuT>;
     unstyled?: boolean;
-    multiplayerStateManager: MultiplayerStateManager<S, M>;
-    assetManager: AssetManager;
-    connectedUsersManager: ConnectedUsersManager;
-    secretManager: SecretManager$1;
-    ephemeralUserDataManager: EphemeralUserDataManager<E>;
-    forceInit: () => void;
 } & StateInspectorOptions & Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">) => React.ReactElement | null;
 
 declare function useSyncStateManager<S, M>(stateManager: StateManager<S, M>): S;
 declare function useSyncStateManager<S, M, P extends string>(stateManager: StateManager<S, M>, path: P): GetAtPath<S, P>;
 declare function useManagedState<S, M = void>(createInitialState: () => S, options?: StateManagerOptions<S, M>): readonly [S, (...args: M extends {} ? [metadata: M, action: SetStateAction<S>] : [action: SetStateAction<S>]) => void, StateManager<S, M>];
 declare function useManagedHistory<S, M = void>(stateManager: StateManager<S, M>): _noya_app_state_manager.HistorySnapshot<S, M>;
-declare function useSyncMultiplayerStateManager<S, M = void>(multiplayerStateManager: MultiplayerStateManager<S, M>): S;
-type UseMultiplayerStateOptions<S, M = void, E extends object = object> = MultiplayerStateManagerOptions<S, M> & {
-    sync?: (options: Pick<SyncAdapterOptions<S, M, E>, "ms" | "ephemeralUserDataManager" | "assetManager">) => void;
-    trackConnectionEvents?: boolean;
-    trackTasks?: boolean;
+type UseMultiplayerStateOptions<S, M extends object = object, E extends object = object, MenuT extends string = string> = MultiplayerStateManagerOptions<S, M> & {
+    sync?: SyncAdapter<S, M, E, MenuT>;
     inspector?: boolean | StateInspectorOptions;
 };
-declare function useMultiplayerState<S, M = void, E extends object = object>(initialState: S | (() => S), options?: UseMultiplayerStateOptions<S, M, E>): readonly [S, (...args: M extends {} ? [metadata: M, action: S | ((prevState: S) => S)] : [action: S | ((prevState: S) => S)]) => void, {
-    tasks: Task[];
-    connectionEvents: ConnectionEvent<S>[] | undefined;
-    connectedUsersManager: ConnectedUsersManager;
-    ephemeralUserDataManager: EphemeralUserDataManager<E>;
-    multiplayerStateManager: MultiplayerStateManager<S, M>;
-    assets: _noya_app_state_manager.Asset[];
-    assetManager: AssetManager;
-    aiManager: AIManager;
-    rpcManager: RPCManager<StandardRPCRequestPayload, StandardRPCResponsePayload>;
-    workflowManager: WorkflowManager;
-    secretManager: SecretManager;
+declare function useMultiplayerState<S, M extends object = object, E extends object = object, MenuT extends string = string>(initialState: S | (() => S), options?: UseMultiplayerStateOptions<S, M, E, MenuT>): readonly [S, (...args: [metadata: Partial<M>, action: S | ((prevState: S) => S)] | [action: S | ((prevState: S) => S)]) => void, {
+    noyaManager: NoyaManager<S, M, E, MenuT>;
+    taskManager: _noya_app_state_manager.TaskManager;
+    connectionEventManager: _noya_app_state_manager.ConnectionEventManager<S>;
+    connectedUsersManager: _noya_app_state_manager.ConnectedUsersManager;
+    ephemeralUserDataManager: _noya_app_state_manager.EphemeralUserDataManager<E>;
+    multiplayerStateManager: _noya_app_state_manager.MultiplayerStateManager<S, M>;
+    assetManager: _noya_app_state_manager.AssetManager;
+    aiManager: _noya_app_state_manager.AIManager;
+    rpcManager: _noya_app_state_manager.RPCManager;
+    workflowManager: _noya_app_state_manager.WorkflowManager;
+    secretManager: _noya_app_state_manager.SecretManager;
+    menuItemsManager: _noya_app_state_manager.MenuManager<MenuT>;
     createAsset: (options: _noya_app_state_manager.CreateAssetOptions | Uint8Array | File | Blob) => Promise<_noya_app_state_manager.Asset>;
     deleteAsset: (id: string) => Promise<void>;
+    assets: _noya_app_state_manager.Asset[];
 }];
 
 type AppViewType = "editable" | "readOnly" | "preview";
@@ -105,33 +84,13 @@ type GetAppDataOptions = {
 declare function enforceSchema<State>(initialState: State, schema?: TSchema): State;
 declare function parseAppDataParameter(options?: GetAppDataOptions): AppData<unknown> | null;
 declare function getAppData<State>(initialState: State | (() => State), schema?: TSchema, options?: GetAppDataOptions): AppData<State>;
-type IframeToHostMessage = {
-    type: "application.setMenuItems";
-    payload: {
-        menuItems: any[];
-    };
-} | {
-    type: "multiplayer.setUsers";
-    payload: {
-        users: any[];
-    };
-};
-type HostToIframeMessage = {
-    type: "application.selectMenuItem";
-    payload: {
-        value: string;
-    };
-};
-declare function useBroadcastConnectedUsers(connectedUsersManager: ConnectedUsersManager): void;
-declare function useBroadcastMenuItems<T>(menuItems: any[], handleSelectMenuItem: (value: T) => void): void;
-declare function isEmbeddedApp(): boolean;
-type UseNoyaStateOptions<S, M = void, E extends object = object> = UseMultiplayerStateOptions<S, M, E> & {
+type UseNoyaStateOptions<S, M extends object = object, E extends object = object, MenuT extends string = string> = UseMultiplayerStateOptions<S, M, E, MenuT> & {
     offlineStorageKey?: string;
 };
-type UseNoyaStateResult<S, M = void, E extends object = object> = [
-    ReturnType<typeof useMultiplayerState<S, M, E>>[0],
-    ReturnType<typeof useMultiplayerState<S, M, E>>[1],
-    ReturnType<typeof useMultiplayerState<S, M, E>>[2] & {
+type UseNoyaStateResult<S, M extends object = object, E extends object = object, MenuT extends string = string> = [
+    ReturnType<typeof useMultiplayerState<S, M, E, MenuT>>[0],
+    ReturnType<typeof useMultiplayerState<S, M, E, MenuT>>[1],
+    ReturnType<typeof useMultiplayerState<S, M, E, MenuT>>[2] & {
         theme: AppTheme;
         viewType: AppViewType;
     }
@@ -145,14 +104,14 @@ type UseNoyaStateResult<S, M = void, E extends object = object> = [
  * 2. Pass an initial state and a schema: `useNoyaState(initialState, { schema })`
  * 3. Pass only a schema, and a conforming initial state is created automatically: `useNoyaState({ schema })`
  */
-declare function useNoyaState<S, M = void, E extends object = object, O extends UseNoyaStateOptions<S, M, E> = UseNoyaStateOptions<S, M, E>>(...args: [
+declare function useNoyaState<S, M extends object = object, E extends object = object, MenuT extends string = string, O extends UseNoyaStateOptions<S, M, E, MenuT> = UseNoyaStateOptions<S, M, E, MenuT>>(...args: [
     initialState: O["schema"] extends TSchema ? Static<O["schema"]> | (() => Static<O["schema"]>) : S | (() => S),
     options?: O
 ] | [options: O & {
     schema: TSchema;
-}]): UseNoyaStateResult<O["schema"] extends TSchema ? Static<O["schema"]> : S, M, E>;
+}]): UseNoyaStateResult<O["schema"] extends TSchema ? Static<O["schema"]> : S, M, E, MenuT>;
 
-interface NoyaStateProviderProps<S, M, E extends object> extends Omit<UseNoyaStateOptions<S, M, E>, "schema" | "mergeHistoryEntries"> {
+interface NoyaStateProviderProps<S, M extends object, E extends object, MenuT extends string> extends Omit<UseNoyaStateOptions<S, M, E, MenuT>, "schema" | "mergeHistoryEntries"> {
     children: React.ReactNode;
     initialState?: S;
     fallback?: React.ReactNode;
@@ -163,12 +122,12 @@ declare function useAssetManager(): {
     create: (options: _noya_app_state_manager.CreateAssetOptions | Uint8Array | File | Blob) => Promise<_noya_app_state_manager.Asset>;
     delete: (id: string) => Promise<void>;
 };
-declare function useAIManager(): AIManager;
-declare function useSecretManager(): SecretManager$1;
+declare function useAIManager(): _noya_app_state_manager.AIManager;
+declare function useSecretManager(): _noya_app_state_manager.SecretManager;
 declare function useSecrets(): _noya_app_state_manager.Secret[];
 declare function useSecret(name: string): _noya_app_state_manager.Secret | undefined;
 declare function useIsInitialized(): boolean;
-declare function useWorkflowManager(): WorkflowManager;
+declare function useWorkflowManager(): _noya_app_state_manager.WorkflowManager;
 declare const ConnectedUsersContext: React.Context<ConnectedUsersManager | undefined>;
 declare function useConnectedUsersManager(): ConnectedUsersManager | undefined;
 declare const AnyEphemeralUserDataManagerContext: React.Context<EphemeralUserDataManager<object> | undefined>;
@@ -178,32 +137,33 @@ declare const FallbackUntilInitialized: ({ children, fallback, }: {
     children: React.ReactNode;
     fallback?: React.ReactNode;
 }) => React.ReactNode;
-declare function createNoyaContext<Schema extends TSchema, M = void, E extends object = object>({ schema, mergeHistoryEntries, }: {
+declare function createNoyaContext<Schema extends TSchema, M extends object = object, E extends object = object, MenuT extends string = string>({ schema, mergeHistoryEntries, }: {
     schema: Schema;
     mergeHistoryEntries?: StateManagerOptions<Static<Schema>, M>["mergeHistoryEntries"];
 }): {
-    Context: React.Context<{
-        ms: MultiplayerStateManager<Static<Schema>, M>;
-        assetManager: AssetManager;
-        secretManager: SecretManager$1;
-    } | undefined>;
-    Provider: ({ children, initialState, ...options }: NoyaStateProviderProps<Static<Schema>, M, E>) => React.JSX.Element;
+    Context: React.Context<NoyaManager<Static<Schema>, M, E, string> | undefined>;
+    Provider: ({ children, initialState, ...options }: NoyaStateProviderProps<Static<Schema>, M, E, MenuT>) => React.JSX.Element;
     useValue: {
         (): Static<Schema>;
         <A>(selector: (value: Static<Schema>) => A, options?: Pick<ObservableOptions, "isEqual">): A;
         <P extends PathKey[] | string>(path: P): GetAtPath<Static<Schema>, P>;
     };
     useSetValue: {
-        (): M extends {} ? (metadata: M, value: SetStateAction<Static<Schema>>) => void : (value: SetStateAction<Static<Schema>>) => void;
-        <P extends PathKey[] | string>(path: P): M extends {} ? (metadata: M, value: SetStateAction<GetAtPath<Static<Schema>, P>>) => void : (value: SetStateAction<GetAtPath<Static<Schema>, P>>) => void;
+        (): (...args: [metadata: M, value: SetStateAction<Static<Schema>>] | [value: SetStateAction<Static<Schema>>]) => void;
+        <P extends PathKey[] | string>(path: P): (...args: [metadata: M, value: SetStateAction<GetAtPath<Static<Schema>, P>>] | [value: SetStateAction<GetAtPath<Static<Schema>, P>>]) => void;
     };
     useValueState: {
-        (): [Static<Schema>, M extends {} ? (metadata: M, value: SetStateAction<Static<Schema>>) => void : (value: SetStateAction<Static<Schema>>) => void];
-        <A>(selector: (value: Static<Schema>) => A, options?: ObservableOptions): [A, M extends {} ? (metadata: M, value: SetStateAction<Static<Schema>>) => void : (value: SetStateAction<Static<Schema>>) => void];
-        <P extends PathKey[] | string>(path?: P): [GetAtPath<Static<Schema>, P>, M extends {} ? (metadata: M, value: SetStateAction<GetAtPath<Static<Schema>, P>>) => void : (value: SetStateAction<GetAtPath<Static<Schema>, P>>) => void];
+        (): [Static<Schema>, (...args: [metadata: M, value: SetStateAction<Static<Schema>>] | [value: SetStateAction<Static<Schema>>]) => void];
+        <A>(selector: (value: Static<Schema>) => A, options?: ObservableOptions): [A, (...args: [metadata: M, value: SetStateAction<Static<Schema>>] | [value: SetStateAction<Static<Schema>>]) => void];
+        <P extends PathKey[] | string>(path?: P): [GetAtPath<Static<Schema>, P>, (...args: [metadata: M, value: SetStateAction<GetAtPath<Static<Schema>, P>>] | [value: SetStateAction<GetAtPath<Static<Schema>, P>>]) => void];
     };
     useStateManager: () => MultiplayerStateManager<Static<Schema>, M>;
     useEphemeralUserDataManager: () => EphemeralUserDataManager<E>;
+    useLeftMenuItems: () => _noya_app_noya_designsystem.RegularMenuItem<MenuT>[];
+    useRightMenuItems: () => _noya_app_noya_designsystem.RegularMenuItem<MenuT>[];
+    useHandleMenuItem: (callback: (type: MenuT) => void) => void;
+    useOnSelectMenuItemCallback: () => (type: MenuT) => void;
+    useNoyaManager: () => NoyaManager<Static<Schema>, M, E, MenuT>;
 };
 
 declare function useObservable<T>(observable: Observable<T>): T;
@@ -213,4 +173,39 @@ declare function useObservable<T>(observable: Observable<T> | undefined): T | un
 declare function useObservable<T, A>(observable: Observable<T> | undefined, selector: (value: T) => A, options?: Pick<ObservableOptions, "isEqual">): A | undefined;
 declare function useObservable<T, P extends PathKey[] | string>(observable: Observable<T> | undefined, path: P): GetAtPath<T, P> | undefined;
 
-export { AnyEphemeralUserDataManagerContext, type AppData, type AppTheme, type AppViewType, ConnectedUsersContext, FallbackUntilInitialized, type GetAppDataOptions, type HostToIframeMessage, type IframeToHostMessage, type RenderUserPointer, type RenderUserPointerProps, StateInspector, type StateInspectorAnchor, type StateInspectorOptions, type UseMultiplayerStateOptions, type UseNoyaStateOptions, type UseNoyaStateResult, type UserPointerData, UserPointersOverlay, type UserPointersOverlayProps, createDefaultAppData, createNoyaContext, enforceSchema, getAppData, isEmbeddedApp, parseAppDataParameter, useAIManager, useAnyEphemeralUserData, useAsset, useAssetManager, useAssets, useBroadcastConnectedUsers, useBroadcastMenuItems, useConnectedUsersManager, useCurrentUserId, useIsInitialized, useManagedHistory, useManagedState, useMultiplayerState, useNoyaState, useObservable, useSecret, useSecretManager, useSecrets, useSyncMultiplayerStateManager, useSyncStateManager, useWorkflowManager };
+type ConnectionEvent<State> = {
+    type: "stateChange";
+    state: ReconnectingWebSocketState;
+} | {
+    type: "send";
+    message: ClientToServerMessage<State>;
+} | {
+    type: "receive";
+    message: ServerToClientMessage<State>;
+} | {
+    type: "error";
+    error: MultiplayerStateManagerError;
+};
+type ConnectionOptions<State> = {
+    debug?: boolean;
+    onConnectionEvent?: (event: ConnectionEvent<State>) => void;
+};
+declare class WebSocketConnection<State> {
+    private url;
+    private options;
+    private ws;
+    private pingCount;
+    private pendingPingId?;
+    private intervalId?;
+    constructor(url: URL, options?: ConnectionOptions<State>);
+    connect(): Promise<void>;
+    private handleOpen;
+    private handleMessage;
+    private handleClose;
+    send(message: ClientToServerMessage<State>): void;
+    close(): void;
+    addListener(listener: (state: ReconnectingWebSocketState) => void): () => void;
+    removeListener(listener: (state: ReconnectingWebSocketState) => void): void;
+}
+
+export { AnyEphemeralUserDataManagerContext, type AppData, type AppTheme, type AppViewType, ConnectedUsersContext, type ConnectionEvent, type ConnectionOptions, FallbackUntilInitialized, type GetAppDataOptions, type RenderUserPointer, type RenderUserPointerProps, StateInspector, type StateInspectorAnchor, type StateInspectorOptions, type UseMultiplayerStateOptions, type UseNoyaStateOptions, type UseNoyaStateResult, type UserPointerData, UserPointersOverlay, type UserPointersOverlayProps, WebSocketConnection, createDefaultAppData, createNoyaContext, enforceSchema, getAppData, parseAppDataParameter, useAIManager, useAnyEphemeralUserData, useAsset, useAssetManager, useAssets, useConnectedUsersManager, useCurrentUserId, useIsInitialized, useManagedHistory, useManagedState, useMultiplayerState, useNoyaState, useObservable, useSecret, useSecretManager, useSecrets, useSyncStateManager, useWorkflowManager };