@noya-app/noya-multiplayer-react 0.1.38 → 0.1.39

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 import * as _noya_app_state_manager from '@noya-app/state-manager';
-import { MultiplayerUser, EphemeralUserData, ConnectionEvent, Task, MultiplayerStateManager, AssetManager, StateManager, Get, StateManagerOptions, MultiplayerStateManagerOptions, SyncAdapterOptions, TSchema, Static } from '@noya-app/state-manager';
+import { MultiplayerUser, EphemeralUserData, ConnectionEvent, Task, MultiplayerStateManager, AssetManager, StateManager, StateManagerOptions, MultiplayerStateManagerOptions, SyncAdapterOptions, TSchema, Static } from '@noya-app/state-manager';
 export * from '@noya-app/state-manager';
-import React, { SetStateAction } from 'react';
-import { Observable, PathKey, GetWithPath } from '@noya-app/observable';
+import React, { ComponentPropsWithoutRef, SetStateAction } from 'react';
+import { GetAtPath, ObservableOptions, PathKey, Observable } from '@noya-app/observable';
 
 declare function getAvatarInitials(name: string): string;
 /**
@@ -27,11 +27,12 @@ type UserPointerProps<E extends UserPointerData> = {
     ephemeralUserData: EphemeralUserData<E>;
     hideAfter?: number;
 };
-declare const UserPointer: <E extends UserPointerData>({ user, ephemeralUserData, hideAfter, }: UserPointerProps<E>) => React.JSX.Element | null;
+declare const UserPointer_: <E extends UserPointerData>({ user, ephemeralUserData, hideAfter, }: UserPointerProps<E>) => React.JSX.Element | null;
+declare const UserPointer: typeof UserPointer_;
 declare const UserPointerContainer: React.NamedExoticComponent<{
     point: Point;
     children: React.ReactNode;
-    show?: boolean | undefined;
+    show?: boolean;
 }>;
 declare const UserNameTag: React.NamedExoticComponent<{
     background: string;
@@ -43,7 +44,7 @@ type UserPointersOverlayProps<E extends UserPointerData> = {
 };
 declare const UserPointersOverlay: React.MemoExoticComponent<(<E extends UserPointerData>({ connectedUsers, ephemeralUserData }: UserPointersOverlayProps<E>) => React.JSX.Element)>;
 declare const UserPointerIcon: React.NamedExoticComponent<{
-    color?: string | undefined;
+    color?: string;
 }>;
 
 type StateInspectorAnchor = "left" | "right" | "bottom left" | "bottom right";
@@ -53,19 +54,19 @@ type StateInspectorOptions = {
 };
 declare const StateInspector: React.MemoExoticComponent<(<S, M, E>({ state, connectionEvents, connectedUsers, tasks, userId, unstyled, colorScheme, multiplayerStateManager, assetManager, ephemeralUserData, anchor, forceInit, ...props }: {
     state: S;
-    connectionEvents?: ConnectionEvent<S>[] | undefined;
-    connectedUsers?: MultiplayerUser[] | undefined;
-    tasks?: Task[] | undefined;
-    userId?: string | undefined;
-    unstyled?: boolean | undefined;
+    connectionEvents?: ConnectionEvent<S>[];
+    connectedUsers?: MultiplayerUser[];
+    tasks?: Task[];
+    userId?: string;
+    unstyled?: boolean;
     multiplayerStateManager: MultiplayerStateManager<S, M>;
     assetManager: AssetManager;
     ephemeralUserData: EphemeralUserData<E>;
     forceInit: () => void;
-} & StateInspectorOptions & Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">) => React.JSX.Element | null)>;
+} & StateInspectorOptions & ComponentPropsWithoutRef<"div">) => React.JSX.Element | 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): Get<S, P, unknown>;
+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;
@@ -90,7 +91,8 @@ declare function useMultiplayerState<S, M = void, E = void>(initialState: S | ((
     ephemeralUserData: EphemeralUserData<E>;
     multiplayerStateManager: MultiplayerStateManager<S, M>;
     assets: _noya_app_state_manager.Asset[];
-    createAsset: (options: Uint8Array | _noya_app_state_manager.CreateAssetOptions) => Promise<_noya_app_state_manager.Asset>;
+    assetManager: AssetManager;
+    createAsset: (options: _noya_app_state_manager.CreateAssetOptions | Uint8Array | File | Blob) => Promise<_noya_app_state_manager.Asset>;
     deleteAsset: (id: string) => Promise<void>;
 }];
 
@@ -162,7 +164,41 @@ declare function useNoyaState<S, M = void, E = void, O extends UseNoyaStateOptio
     schema: TSchema;
 }]): UseNoyaStateResult<O["schema"] extends TSchema ? Static<O["schema"]> : S, M, E>;
 
+interface NoyaStateProviderProps<Schema extends TSchema, M, E> extends Omit<UseNoyaStateOptions<Static<Schema>, M, E>, "schema"> {
+    children: React.ReactNode;
+    initialState?: Static<Schema>;
+}
+declare function useAssets(): _noya_app_state_manager.Asset[];
+declare function useAsset(id: string | undefined): _noya_app_state_manager.Asset | undefined;
+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 createNoyaContext<Schema extends TSchema, M = void, E = void>({ schema, }: {
+    schema: Schema;
+}): {
+    Context: React.Context<{
+        ms: MultiplayerStateManager<Static<Schema>, M>;
+        assetManager: AssetManager;
+    } | undefined>;
+    Provider: ({ children, initialState, ...options }: NoyaStateProviderProps<Schema, M, E>) => 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;
+    };
+    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];
+    };
+};
+
 declare function useObservable<T>(observable: Observable<T>): T;
-declare function useObservable<T, P extends PathKey[]>(observable: Observable<T>, path: P): GetWithPath<T, P>;
+declare function useObservable<T, P extends PathKey[] | string>(observable: Observable<T>, path: P): GetAtPath<T, P>;
 
-export { type AppData, type AppTheme, type AppViewType, type GetAppDataOptions, type HostToIframeMessage, type IframeToHostMessage, StateInspector, type StateInspectorAnchor, type StateInspectorOptions, type UseMultiplayerStateOptions, type UseNoyaStateOptions, type UseNoyaStateResult, UserNameTag, UserPointer, UserPointerContainer, type UserPointerData, UserPointerIcon, type UserPointerProps, UserPointersOverlay, type UserPointersOverlayProps, createDefaultAppData, enforceSchema, getAppData, getAvatarInitials, getAvatarStyle, isEmbeddedApp, parseAppDataParameter, useBroadcastConnectedUsers, useBroadcastMenuItems, useEphemeralUserData, useManagedHistory, useManagedState, useMultiplayerState, useNoyaState, useObservable, useSyncMultiplayerStateManager, useSyncStateManager };
+export { type AppData, type AppTheme, type AppViewType, type GetAppDataOptions, type HostToIframeMessage, type IframeToHostMessage, StateInspector, type StateInspectorAnchor, type StateInspectorOptions, type UseMultiplayerStateOptions, type UseNoyaStateOptions, type UseNoyaStateResult, UserNameTag, UserPointer, UserPointerContainer, type UserPointerData, UserPointerIcon, type UserPointerProps, UserPointersOverlay, type UserPointersOverlayProps, createDefaultAppData, createNoyaContext, enforceSchema, getAppData, getAvatarInitials, getAvatarStyle, isEmbeddedApp, parseAppDataParameter, useAsset, useAssetManager, useAssets, useBroadcastConnectedUsers, useBroadcastMenuItems, useEphemeralUserData, useManagedHistory, useManagedState, useMultiplayerState, useNoyaState, useObservable, useSyncMultiplayerStateManager, useSyncStateManager };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import * as _noya_app_state_manager from '@noya-app/state-manager';
-import { MultiplayerUser, EphemeralUserData, ConnectionEvent, Task, MultiplayerStateManager, AssetManager, StateManager, Get, StateManagerOptions, MultiplayerStateManagerOptions, SyncAdapterOptions, TSchema, Static } from '@noya-app/state-manager';
+import { MultiplayerUser, EphemeralUserData, ConnectionEvent, Task, MultiplayerStateManager, AssetManager, StateManager, StateManagerOptions, MultiplayerStateManagerOptions, SyncAdapterOptions, TSchema, Static } from '@noya-app/state-manager';
 export * from '@noya-app/state-manager';
-import React, { SetStateAction } from 'react';
-import { Observable, PathKey, GetWithPath } from '@noya-app/observable';
+import React, { ComponentPropsWithoutRef, SetStateAction } from 'react';
+import { GetAtPath, ObservableOptions, PathKey, Observable } from '@noya-app/observable';
 
 declare function getAvatarInitials(name: string): string;
 /**
@@ -27,11 +27,12 @@ type UserPointerProps<E extends UserPointerData> = {
     ephemeralUserData: EphemeralUserData<E>;
     hideAfter?: number;
 };
-declare const UserPointer: <E extends UserPointerData>({ user, ephemeralUserData, hideAfter, }: UserPointerProps<E>) => React.JSX.Element | null;
+declare const UserPointer_: <E extends UserPointerData>({ user, ephemeralUserData, hideAfter, }: UserPointerProps<E>) => React.JSX.Element | null;
+declare const UserPointer: typeof UserPointer_;
 declare const UserPointerContainer: React.NamedExoticComponent<{
     point: Point;
     children: React.ReactNode;
-    show?: boolean | undefined;
+    show?: boolean;
 }>;
 declare const UserNameTag: React.NamedExoticComponent<{
     background: string;
@@ -43,7 +44,7 @@ type UserPointersOverlayProps<E extends UserPointerData> = {
 };
 declare const UserPointersOverlay: React.MemoExoticComponent<(<E extends UserPointerData>({ connectedUsers, ephemeralUserData }: UserPointersOverlayProps<E>) => React.JSX.Element)>;
 declare const UserPointerIcon: React.NamedExoticComponent<{
-    color?: string | undefined;
+    color?: string;
 }>;
 
 type StateInspectorAnchor = "left" | "right" | "bottom left" | "bottom right";
@@ -53,19 +54,19 @@ type StateInspectorOptions = {
 };
 declare const StateInspector: React.MemoExoticComponent<(<S, M, E>({ state, connectionEvents, connectedUsers, tasks, userId, unstyled, colorScheme, multiplayerStateManager, assetManager, ephemeralUserData, anchor, forceInit, ...props }: {
     state: S;
-    connectionEvents?: ConnectionEvent<S>[] | undefined;
-    connectedUsers?: MultiplayerUser[] | undefined;
-    tasks?: Task[] | undefined;
-    userId?: string | undefined;
-    unstyled?: boolean | undefined;
+    connectionEvents?: ConnectionEvent<S>[];
+    connectedUsers?: MultiplayerUser[];
+    tasks?: Task[];
+    userId?: string;
+    unstyled?: boolean;
     multiplayerStateManager: MultiplayerStateManager<S, M>;
     assetManager: AssetManager;
     ephemeralUserData: EphemeralUserData<E>;
     forceInit: () => void;
-} & StateInspectorOptions & Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">) => React.JSX.Element | null)>;
+} & StateInspectorOptions & ComponentPropsWithoutRef<"div">) => React.JSX.Element | 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): Get<S, P, unknown>;
+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;
@@ -90,7 +91,8 @@ declare function useMultiplayerState<S, M = void, E = void>(initialState: S | ((
     ephemeralUserData: EphemeralUserData<E>;
     multiplayerStateManager: MultiplayerStateManager<S, M>;
     assets: _noya_app_state_manager.Asset[];
-    createAsset: (options: Uint8Array | _noya_app_state_manager.CreateAssetOptions) => Promise<_noya_app_state_manager.Asset>;
+    assetManager: AssetManager;
+    createAsset: (options: _noya_app_state_manager.CreateAssetOptions | Uint8Array | File | Blob) => Promise<_noya_app_state_manager.Asset>;
     deleteAsset: (id: string) => Promise<void>;
 }];
 
@@ -162,7 +164,41 @@ declare function useNoyaState<S, M = void, E = void, O extends UseNoyaStateOptio
     schema: TSchema;
 }]): UseNoyaStateResult<O["schema"] extends TSchema ? Static<O["schema"]> : S, M, E>;
 
+interface NoyaStateProviderProps<Schema extends TSchema, M, E> extends Omit<UseNoyaStateOptions<Static<Schema>, M, E>, "schema"> {
+    children: React.ReactNode;
+    initialState?: Static<Schema>;
+}
+declare function useAssets(): _noya_app_state_manager.Asset[];
+declare function useAsset(id: string | undefined): _noya_app_state_manager.Asset | undefined;
+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 createNoyaContext<Schema extends TSchema, M = void, E = void>({ schema, }: {
+    schema: Schema;
+}): {
+    Context: React.Context<{
+        ms: MultiplayerStateManager<Static<Schema>, M>;
+        assetManager: AssetManager;
+    } | undefined>;
+    Provider: ({ children, initialState, ...options }: NoyaStateProviderProps<Schema, M, E>) => 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;
+    };
+    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];
+    };
+};
+
 declare function useObservable<T>(observable: Observable<T>): T;
-declare function useObservable<T, P extends PathKey[]>(observable: Observable<T>, path: P): GetWithPath<T, P>;
+declare function useObservable<T, P extends PathKey[] | string>(observable: Observable<T>, path: P): GetAtPath<T, P>;
 
-export { type AppData, type AppTheme, type AppViewType, type GetAppDataOptions, type HostToIframeMessage, type IframeToHostMessage, StateInspector, type StateInspectorAnchor, type StateInspectorOptions, type UseMultiplayerStateOptions, type UseNoyaStateOptions, type UseNoyaStateResult, UserNameTag, UserPointer, UserPointerContainer, type UserPointerData, UserPointerIcon, type UserPointerProps, UserPointersOverlay, type UserPointersOverlayProps, createDefaultAppData, enforceSchema, getAppData, getAvatarInitials, getAvatarStyle, isEmbeddedApp, parseAppDataParameter, useBroadcastConnectedUsers, useBroadcastMenuItems, useEphemeralUserData, useManagedHistory, useManagedState, useMultiplayerState, useNoyaState, useObservable, useSyncMultiplayerStateManager, useSyncStateManager };
+export { type AppData, type AppTheme, type AppViewType, type GetAppDataOptions, type HostToIframeMessage, type IframeToHostMessage, StateInspector, type StateInspectorAnchor, type StateInspectorOptions, type UseMultiplayerStateOptions, type UseNoyaStateOptions, type UseNoyaStateResult, UserNameTag, UserPointer, UserPointerContainer, type UserPointerData, UserPointerIcon, type UserPointerProps, UserPointersOverlay, type UserPointersOverlayProps, createDefaultAppData, createNoyaContext, enforceSchema, getAppData, getAvatarInitials, getAvatarStyle, isEmbeddedApp, parseAppDataParameter, useAsset, useAssetManager, useAssets, useBroadcastConnectedUsers, useBroadcastMenuItems, useEphemeralUserData, useManagedHistory, useManagedState, useMultiplayerState, useNoyaState, useObservable, useSyncMultiplayerStateManager, useSyncStateManager };

package/dist/index.js

@@ -38,12 +38,16 @@ __export(src_exports, {
   UserPointerIcon: () => UserPointerIcon,
   UserPointersOverlay: () => UserPointersOverlay,
   createDefaultAppData: () => createDefaultAppData,
+  createNoyaContext: () => createNoyaContext,
   enforceSchema: () => enforceSchema,
   getAppData: () => getAppData,
   getAvatarInitials: () => getAvatarInitials,
   getAvatarStyle: () => getAvatarStyle,
   isEmbeddedApp: () => isEmbeddedApp,
   parseAppDataParameter: () => parseAppDataParameter,
+  useAsset: () => useAsset,
+  useAssetManager: () => useAssetManager,
+  useAssets: () => useAssets,
   useBroadcastConnectedUsers: () => useBroadcastConnectedUsers,
   useBroadcastMenuItems: () => useBroadcastMenuItems,
   useEphemeralUserData: () => useEphemeralUserData,
@@ -111,7 +115,7 @@ var import_react2 = __toESM(require("react"));
 var import_react = require("react");
 function useObservable(observable, path) {
   const { get, listen } = (0, import_react.useMemo)(() => {
-    const listen2 = path ? (callback) => observable.listen(path, callback) : observable.listen;
+    const listen2 = path ? (callback) => observable.subscribe(path, callback) : observable.subscribe;
     const get2 = path ? () => observable.get(path) : observable.get;
     return { get: get2, listen: listen2 };
   }, [observable, path]);
@@ -1381,6 +1385,7 @@ function useMultiplayerState(initialState, options) {
       ephemeralUserData,
       multiplayerStateManager,
       assets,
+      assetManager,
       createAsset: assetManager.create,
       deleteAsset: assetManager.delete
       // evaluate: async (code: string) => {
@@ -1450,7 +1455,15 @@ function useMultiplayerState(initialState, options) {
   const [unrecoverableError, setUnrecoverableError] = (0, import_react7.useState)();
   (0, import_react7.useEffect)(() => {
     return multiplayerStateManager.errorEmitter.addListener((error) => {
-      setUnrecoverableError(error);
+      switch (error.reason) {
+        case "invalidDataType":
+        case "schemaMismatch":
+        case "outdatedSchema":
+        case "dataMigrationFailure":
+        case "schemaMigration":
+          setUnrecoverableError(error);
+          break;
+      }
     });
   }, [multiplayerStateManager]);
   (0, import_react7.useEffect)(() => {
@@ -1589,6 +1602,107 @@ function useNoyaState(...args) {
   }, [extras, theme, viewType]);
   return [result[0], result[1], mergedExtras];
 }
+
+// src/NoyaStateContext.tsx
+var import_react9 = __toESM(require("react"));
+var AnyNoyaStateContext = (0, import_react9.createContext)(void 0);
+function useAnyNoyaStateContext() {
+  const value = (0, import_react9.useContext)(AnyNoyaStateContext);
+  if (!value) {
+    throw new Error(
+      "useNoyaStateContext must be used within a NoyaStateProvider"
+    );
+  }
+  return value;
+}
+function useAssets() {
+  const { assetManager } = useAnyNoyaStateContext();
+  return useObservable(assetManager.assets$);
+}
+function useAsset(id) {
+  const { assetManager } = useAnyNoyaStateContext();
+  const observable = (0, import_react9.useMemo)(
+    () => assetManager.assets$.map((assets) => assets.find((a) => a.id === id)),
+    [assetManager, id]
+  );
+  return useObservable(observable);
+}
+function useAssetManager() {
+  const { assetManager } = useAnyNoyaStateContext();
+  return (0, import_react9.useMemo)(
+    () => ({
+      create: assetManager.create,
+      delete: assetManager.delete
+    }),
+    [assetManager]
+  );
+}
+function createNoyaContext({
+  schema
+}) {
+  const NoyaStateContext = AnyNoyaStateContext;
+  function NoyaStateProvider({
+    children,
+    initialState,
+    ...options
+  }) {
+    const [, , { multiplayerStateManager, assetManager }] = useNoyaState(
+      initialState,
+      {
+        ...options,
+        schema
+      }
+    );
+    const value = (0, import_react9.useMemo)(
+      () => ({
+        ms: multiplayerStateManager,
+        assetManager
+      }),
+      [multiplayerStateManager, assetManager]
+    );
+    return /* @__PURE__ */ import_react9.default.createElement(AnyNoyaStateContext.Provider, { value }, children);
+  }
+  function useValue(path, options) {
+    const { ms } = useAnyNoyaStateContext();
+    let actualPath = typeof path === "function" || !path ? "" : path;
+    const mappedObservable = (0, import_react9.useMemo)(() => {
+      if (typeof path === "function") {
+        return ms.optimisticState$.map(path, { isEqual: options?.isEqual });
+      }
+      return ms.optimisticState$;
+    }, [ms, path, options?.isEqual]);
+    const value = useObservable(mappedObservable, actualPath);
+    return value;
+  }
+  function useSetValue(path) {
+    const { ms } = useAnyNoyaStateContext();
+    const setValue = (0, import_react9.useCallback)(
+      (...args) => {
+        const [metadata, value] = args.length === 2 ? args : [void 0, args[0]];
+        const setStateAtPath = ms.setStateAtPath;
+        setStateAtPath(metadata, path ?? "", value);
+      },
+      [ms, path]
+    );
+    return setValue;
+  }
+  function useValueState(...args) {
+    const [selector, options, path] = args.length >= 1 && typeof args[0] === "function" ? [args[0], args[1], void 0] : [void 0, void 0, args[0]];
+    const value = useValue(selector ?? path ?? "", options);
+    const setValue = useSetValue(path ?? "");
+    return [value, setValue];
+  }
+  return {
+    Context: NoyaStateContext,
+    Provider: NoyaStateProvider,
+    useValue,
+    useSetValue,
+    useValueState
+    // useAssets,
+    // useAssetManager,
+    // useAsset,
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   StateInspector,
@@ -1598,12 +1712,16 @@ function useNoyaState(...args) {
   UserPointerIcon,
   UserPointersOverlay,
   createDefaultAppData,
+  createNoyaContext,
   enforceSchema,
   getAppData,
   getAvatarInitials,
   getAvatarStyle,
   isEmbeddedApp,
   parseAppDataParameter,
+  useAsset,
+  useAssetManager,
+  useAssets,
   useBroadcastConnectedUsers,
   useBroadcastMenuItems,
   useEphemeralUserData,