Skip to content
Source
Sign inSign up
TanStack/store
Open History to see the last commit

createStoreContext.md

81 lines1.6 KB

function createStoreContext<TValue>(): object;

Defined in: createStoreContext.ts:44

Creates a typed Octane context for sharing a bundle of atoms and stores with a subtree.

The returned StoreProvider only transports the provided object through Octane context. Consumers destructure the contextual atoms and stores, then compose them with hooks like useSelector and useAtom.

The object shape is preserved exactly, so keyed atoms and stores remain fully typed when read back with useStoreContext().

Type Parameters

TValue

TValue extends object

Returns

object

StoreProvider

StoreProvider: ComponentBody<{
  children?: unknown;
  value: TValue;
}>;

useStoreContext

useStoreContext: () => TValue;

Returns

TValue

Example

const { StoreProvider, useStoreContext } = createStoreContext<{
  countAtom: Atom<number>
  totalsStore: Store<{ count: number }>
}>()

function CountButton() @{
  const { countAtom, totalsStore } = useStoreContext()
  const count = useSelector(countAtom)
  const total = useSelector(totalsStore, (state) => state.count)

  <button
    type="button"
    onClick={() =>
      totalsStore.setState((state) => ({
        ...state,
        count: state.count + 1,
      }))
    }
  >
    {count + ' / ' + total}
  </button>
}

Throws

When useStoreContext() is called outside the matching StoreProvider.