Function createStore

src/effector/createUnit.ts:252–454

(
  defaultState: State,
  props?: Config,
)

  'undefined is used to skip updates. To allow undefined as a value provide explicit { skipVoid: false } option'

export function createStore<State>(
  defaultState: State,
  props?: Config,
): Store<State> {
  const config = flattenConfig(props)
  const plainState = createStateRef(defaultState)
  const errorTitle = generateErrorTitle('store', config)
  const updates = createEvent({named: 'updates', derived: true})
  applyTemplate('storeBase', plainState)
  const plainStateId = plainState.id

  // skipVoid deprecation rules
  const explicitSkipVoid = 'skipVoid' in config
  const voidValueAllowed = explicitSkipVoid && !config.skipVoid
  const skipVoidTrueSet = explicitSkipVoid && config.skipVoid

  deprecate(!skipVoidTrueSet, '{skipVoid: true}', 'updateFilter', errorTitle)

  const store = {
    updates,
    defaultState,
    stateRef: plainState,
    getState() {
      let targetRef = plainState
      let reachedPage
      if (currentPage) {
        let page = currentPage
        while (page && !page.reg[plainStateId]) {
          page = getParent(page)
        }
        if (page) reachedPage = page
      }
      if (!reachedPage && forkPage) {
        initRefInScope(forkPage, plainState, true)
        reachedPage = forkPage
      }
      if (reachedPage) targetRef = reachedPage.reg[plainStateId]
      return readRef(targetRef)
    },
    setState: (state: State) =>
      launch({
        target: store,
        params: state,
        defer: true,
        scope: forkPage!,
      }),
    reset(...units: CommonUnit[]) {
      assert(
        // @ts-expect-error
        store.targetable,
        '.reset of derived store is not supported',
        errorTitle,
      )
      forEach(units, unit =>
        on(store, '.reset', unit, () => store.defaultState, errorTitle),
      )
      return store
    },