Changelog

effector 22.8.7

Fix combine function called twice on first allSettled call (PR #984)

effector-react 22.5.4

Fix for createWatch implementation to improve @effector/next updates flow

effector-react 22.5.3

Fix too frequent useUnit updates

effector 22.8.6

Follow-up fix for 22.8.2: now combine in tuple-form handles compelx edge-cases with mapped stores correctly. (PR #902)

effector-react 22.5.2

Fix bug in useUnit during event change (issue #900, PR #901)

effector 22.8.5

Follow up fix for 22.8.4: now fix works for fork({ handlers }) calls too. PR #898

effector 22.8.4

Fixed an edge case for fork calls without sid (function from release 22.8.0). Some libraries provide built-in sid's in the code, which led to the duplicated sid found exception when calling fork when trying to use two instances of the same factory in a test and running it without effector/babel-plugin. The exception on fork calls is no longer thrown, and all sid-related checks and assertions have been moved to serialize calls, since sid's are actually only required for serialize to work. PR #897

effector 22.8.3

Added missing node and stateRef ids to meta-objects. These are internal changes which are not covered by the types or docs yet.

effector 22.8.2

combine types now allow primitive values, just like it was stated in the docs. Thanks to @faustienf PR #884
Events, created from split with match-object shape and internal inFlight counters of Effects now have proper metadata to use in the Inspect API. PR #892

effector 22.8.1

Internal state refs now also see meta, if owned by store. PR #889

effector 22.8.0

Sids are no longer required for fork({ values, handlers }), which allows to run tests without effector/babel-plugin. Note, that plugin and sids are still required for SSR. (PR #855)

effector-react 22.5.1

Fix Gate usage as component. <Gate /> will also be isomorphic by scope.

effector 22.7.0

Fix Declaration type, provide missing top-level properties for region and factory types
Add node's id to Declaration type

effector 22.6.2

Fix return type of withRegion

effector 22.6.1

Add missing exports definition for effector/inspect API

effector 22.6.0

Implemented inspect API (PR #859)

effector 22.5.2

Fix serialize: "ignore" in fork({ values }) (PR #862)

effector 22.5.1

Fix default factories list in babel-plugin (PR #857)

effector-react 22.5.0

Make useGate isomorphic in effector-react module, so the one not needed to use effector-react/scope anymore (PR #852)
Fix useUnit hangs when scope is changed (happens when route is changed in next.js) (PR #851)

effector 22.5.0

Support allSettled(scope) feature.

effector-react 22.4.0

Support @@unitShape protocol (PR #803) in useUnit

effector-solid 0.22.7

Support @@unitShape protocol (PR #803) in useUnit

effector 22.4.1

Add type support for read only arrays in sample source. This case now supported and typechecked correctly:

const profileFormSubmitted = createEvent()
const $name = createStore('alice')
const $age = createStore(0)
const saveProfileFx = createEffect(async ([name, age]: [string, number]) => {})

sample({
  clock: profileFormSubmitted,
  source: [$name, $age] as const,
  target: saveProfileFx,
})

Note that the one need to use "as const" in that case to got correct typechecking because without it typescript cannot infer the type [Store<string>, Store<number>]. We are working to avoid that limitation, stay tuned!

effector Encke 22.4.0

Add custom serializers for Store (PR #744)
Allow to pass domain as an argument for createEvent and similar methods (PR #763)
Add store.reinit event to set default value into store (PR #797)

const $store = createStore<Array<number>>([])

sample({
  clock: someEffectFailed,
  target: $store.reinit,
})

// subscribe on store reinit
sample({
  clock: $store.reinit,
  fn: createEffect(() => console.log('store value set to default')),
})

Add safe mode for scopeBind (PR #688)
Add is.attached method to detect effects created via attach (PR #670)
Add @farfetched/core and atomic-router to default factories so the one not needed to describe them explicitly
Protect against combine argument being broken via Array.slice (PR #801)
Add "type" entry for package exports (PR #759)
Finally allow Gate to be serialized (as this requires changes in babel plugin) (PR #683)

effector-react 22.3.4

Fix useUnit skipping updates when used with useEffect and useGate

effector-react 22.3.3

Fix useUnit skipping updates during scope changes (often happens in next.js apps). Big thanks to @AlexandrHoroshih for investigation

effector-react 22.3.1

Fix useUnit skipping updates in react 16-17

effector-vue 22.2.0

Add useStoreMap hook for Vue 3 composition API to select part from a store ((PR #780)[effector#780]) by @ilajosmanov

effector-react 22.3.0

Made hooks useEvent, useStore, useStoreMap and useList isomorphic, now they would use scope from the Provider if it is available and scope-less mode otherwise. For useUnit it was done in 22.2.0.
Added parameter forceScope to useEvent, useStore, useStoreMap and useList to force usage of scope from Provider, it would throw an error if Provider is not available, /scope module sets forceScope to true by default

effector-solid 0.22.6

Add type of Provider to main module

effector-solid 0.22.5

Add export of Provider from main module

effector-react 22.2.0

Made hook useUnit isomorphic, now it would use scope from the Provider if it is available and scope-less mode otherwise (PR #776 and PR #785)
Added parameter forceScope to useUnit to force usage of scope from Provider, it would throw an error if Provider is not available (PR #776 and PR #785), /scope module sets forceScope to true by default
Added "type" entry for package exports (PR #759)
Fixed typing in useUnit (PR #747)

effector-solid 0.22.4

Made useUnit isomorphic, now it would use scope from the Provider if it is available and scope-less mode otherwise (PR #782)
Added parameter forceScope to useUnit to force usage of scope from Provider, it would throw an error if Provider is not available (PR #782), /scope module sets forceScope to true by default

effector-vue 22.1.2

Added "type" entry for package exports (PR #759)

effector-solid 0.22.3

Added "type" entry for package exports (PR #759)

effector-solid 0.22.2

Fixed typing in useUnit (PR #747)

forest 0.21.2

Added "type" entry for package exports (PR #759)

effector-react 22.1.0

Added support for react 18 (PR #655)
Added useUnit method to read multiple stores and bind events or effects to scope in a single batched call (PR #733, #738)

import {createEvent, createStore, fork} from 'effector'
import {useUnit, Provider} from 'effector-react/scope'

const inc = createEvent()
const $count = createStore(0)
const $title = createStore('useStore example')

$count.on(inc, x => x + 1)

const App = () => {
  const [count, title, incFn] = useUnit([$count, $title, inc])
  return (
    <>
      <h1>{title}</h1>
      <p>Count: {count}</p>
      <button onClick={() => incFn()}>increment</button>
    </>
  )
}

const scope = fork()

render(
  () => (
    <Provider value={scope}>
      <App />
    </Provider>
  ),
  document.getElementById('root'),
)

Added placeholder option to useList to render in cases of empty list

const ChatList = () => (
  <div>
    {useList($chats, {
      fn: chat => <div>Chat {chat.name}</div>,
      keys: [],
      placeholder: <div>You have no chats yet. Add first one?</div>,
    })}
  </div>
)

Added defaultValue option to useStoreMap to return in cases when fn returns undefined

const ChatName = ({id}) => {
  const chat = useStoreMap({
    store: $chats,
    keys: [id],
    fn: chats => chats.find(chat => chat.id === id),
    defaultValue: {id: 'default', name: 'Default chat'},
  })
  return <span>{chat.name}</span>
}

Fixed Gate.status store being serialized (PR #683)

effector 22.2.0

Added filter option to sample, thereby making guard an alias (issue #521)

sample({
  clock: submitPasswordEvent,
  source: $store,
  filter: (state: AuthFlowState) => state is WaitingPasswordState,
  fn: (waitingPasswordState, clock) => waitingPasswordState.password,
  target: submitPassowrdFx,
})

Added clock option to split (issue #537)

split({
  clock: submit,
  source: $form,
  match: $mode,
  cases: {
    draft: saveFormDraftFx,
    send: sendFormToBackendFx,
  },
})

Improved sample type checking:
- Fixed cases when target units becomes compatible with any type (issue #600)
- Fixed cases when method call being marked as error when it perfectly correct
- Removed vague "incompatible unit in target" error
- Error messages now explicitly tells which type is given by source and which one is expected by target
- 16 overloads was merged into single one to improve clarity of error messages. Will remove a lot of noise from IDE output thereby improving developer expirience
Improved split type checking:
- Fixed a case when units in cases becomes compatible with any type
- Removed vague "incompatible unit in target" error
- Error messages now explicitly tells which type is given by source and which one is expected by failed target case
Added jsdoc documentation for all top level methods. Will be used by IDE such as VS Code and Webstorm to provide better developer expirience
Derived units in target of sample, guard, split and forward are deprecated (issue #563)
Imperative calls of derived units created by merge, sample and split are deprecated
Imperative calls of events and effects in pure functions are deprecated (issue #541)
restore($store) is deprecated (issue #571)
Effects created by attach got correct name for use in developer tools like effector-logger (issue #527)
Fixed a case when sample/guard pass obsolete data from it's source store (issue #544)
Fixed data race when using combine with fork api (issue #613)
Fixed cases when effector/babel-plugin changes function calls which it should avoid (issue #603)
Fixed support for multiple passes of effector/babel-plugin (issue #601)
Fixed combine support for units with large union types (issue #531)
Fixed support for calls without payload for Event<unknown> (PR #454)
Fixed circular reference warning during import of typings (issue #578)

effector-vue 22.1.0

Add support for Vue 3 SSR via new useEvent hook and VueSSRPlugin (PR #595)

effector-react 22.0.6

Fix Can't perform a React state update on an unmounted component warning for useStoreMap in a few cases (issue #574)

effector 22.1.2

Allow to use effector/babel-plugin in patronum/macro

effector 22.1.1

Fix data races that cause obsolete states to appear in the .on and .reset methods

effector 22.1.0

Added option debugSids to effector/babel-plugin

The option allows adding file path and variable name to a sid for each unit definition. It allows to easily debug serialized scope using SSR.

effector 22.0.0

Add support for plain functions to attach: attach({source, async effect(source, params) {}})
Allow to use fork without domains: const scope = fork()
- Unit not found in scope error is no longer exists, any unit could be used in any scope
- Increase performance of fork and serialize a hundredfold
Add support for attached effects to fork handlers
Add support for tuples to fork values and handlers: fork({values: [[$user, 'alice'], [$age, 22]]})
Add serialize: 'ignore' option to createStore to declare store as ignored by serialize calls
Make onlyChanges: true a default serialize option
Fix babel plugin issue with parsing method calls (e.g. in react native)
Validate combine arguments and throw an error in case of undefined and non-store units (issue #509)
Throw an error when fork handlers or values got units without sid or with duplicate sid
Deprecate createStoreObject alias for combine
Deprecate effector/fork module
Deprecate .thru
Deprecate second argument in store.map
Deprecate direct manipulations with derived units:
- Deprecate .on in derived stores created by store.map and combine
- Deprecate calls of derived events created by event.map, event.filterMap and event.filter
- Deprecate calls of fx.done, fx.doneData and other events belongs to effects
Remove ɔ (latin small letter open o) symbol to prevent incorrect unicode parsing
Remove undocumented scope.find which is a wrong abstraction for a new fork
Make Scope a unit:
- Add support for Scope to is.unit
- Add is.scope method
Allow to pass a scope to scopeBind: scopeBind(unit, {scope}), which is also can be used outside from .watch
Improve es modules support
Make package size 10% smaller

effector-react 22.0.0

Add module effector-react/scope and make effector-react/ssr an alias for it
Fix Cannot update a component warning in useGate
Allow to return undefined in useStoreMap
Make domain field in createGate optional
Deprecate createContextComponent and createReactState
Improve es modules support

effector-vue 22.0.0

Improve es modules support

forest 0.20.0

Improve es modules support

effector-react 21.3.1

Fixed TypeError in useStoreMap with scope (PR #474)

effector-react 21.3.0

Add support for updateFilter to useStoreMap. It helps to control component rerendering, e.g. when component should rerender only when id field is changed
Add useStoreMap($store, value => result) shorthand
Add support for getKey to useList. Function in this field will be used to compute key for every item of list
Add support for stores with functions in them to useStore (PR #431)
Add domain name passed to createGate to gate.displayName and gate units (issue #449)
Fix unhandled promise rejection in useEvent when used effect throw an error

effector 21.8.0

Add type support for arrays in sample target (PR #284, #445)

sample({
  clock: clickValidate,
  source: $formFields,
  target: [validateForm, sendStatsFx],
})

Add support for case functions, case stores and matcher stores to split. Case functions and stores will choose target case by its name, matcher stores are boolean stores which indicate whether to choose given case

const source = createEvent()
const even = createEvent()

const $odd = createStore(0)

split({
  source,
  // case function
  match(n) {
    if (n % 2 === 0) return 'even'
    return 'odd'
  },
  cases: {
    even,
    odd: $odd,
  },
})

const $currentPage = createStore('dashboard')

split({
  source,
  // case store
  match: $currentPage,
  cases: {
    dashboard: even,
    __: odd,
  },
})

const tryUpdatePage = createEvent()
const updatePageFx = createEffect()

const $hasWriteAccess = createStore(false)

split({
  source: tryUpdatePage,
  match: {
    // matcher store
    admin: $hasWriteAccess,
  },
  cases: {
    admin: updatePageFx,
  },
})

Add updateFilter config field to createStore to skip arbitrary store updates (discussion #428)

const $playerPosition = createStore(
  {x: 0, y: 0},
  {
    updateFilter: (update, current) => update.x !== current.x,
  },
)

Add support for sample with clock without source. For example, it useful in cases when clock is array of units and no source stores is needed

sample({
  clock: [fx1.doneData, fx2.doneData],
  fn: data => ({url: '/stats', data})
  target: fetchFx,
})

Add support for clock to guard to improve developer expirience in cases when update trigger (clock field) and data source (source field) are different things

guard({
  clock: validateForm,
  source: $formFields,
  filter: formFields => validator(formFields),
  target: submitFormFx,
})

Add addNames field to babel plugin (PR #450)
Add type support for Scope to clearNode (issue #441)
Add compositeName to Domain typings, making it consistent with other units
Add EventPayload and UnitValue type helpers (PR #434)
Improve various edge cases with fork api and serialization
Improve typechecking for attach (issue #439)
Fix various type issues in sample and guard typings

effector-react 21.2.0

Add createGate implementation to effector-react/ssr

import {createDomain} from 'effector'
import {createGate, useGate} from 'effector-react/ssr'

const app = createDomain()

const currentRouteGate = createGate({
  domain: app,
  defaultState: 'dashboard',
})

export const Layout = ({routeName, children}) => {
  useGate(currentRouteGate, routeName)
  return (
    <>
      <h1>{routeName}</h1>
      {children}
    </>
  )
}

effector-react 21.1.0

Add support for object and array of events to useEvent. It's a shorthand for calling several useEvent at once (PR #425 by @sergeysova)

export function ExampleComponent() {
  const handlers = useEvent({emailChanged, passwordChanged})

  return (
    <div>
      <input onChange={handlers.emailChanged} />
      <input onChange={handlers.passwordChanged} />
    </div>
  )
}

export function ExampleComponent() {
  const [changeEmail, changePassword] = useEvent([
    emailChanged,
    passwordChanged,
  ])

  return (
    <div>
      <input onChange={changeEmail} />
      <input onChange={changePassword} />
    </div>
  )
}

effector 21.7.0

Add support for scopes to hydrate, to provide a way to fill additional values to existing scope (happens during SSG navigation in next.js)
Improve prepend type inference (PR #415 (thanks @doasync))

effector-vue 21.1.0

Add support for vue@next (vue 3)
useStore useVModel useGate createGate see docs

effector 21.6.0

Add support for user-defined factories in fork api. Starting from this release, application developers can use their own functions and be sure that their content will be properly serialized and hydrated by fork api. New field factories in effector/babel-plugin accepts array of module names which exports will be treated as custom factories therefore each function call will provide unique prefix for sid properties of units inside them

{
  "plugins": [
    [
      "effector/babel-plugin",
      {
        "factories": ["src/createEffectStatus", "~/createCommonPending"]
      }
    ]
  ]
}

import {rootDomain} from './rootDomain'

export function createEffectStatus(fx) {
  const $status = rootDomain
    .createStore('init')
    .on(fx.finally, (_, {status}) => status)

  return $status
}

import {createEffectStatus} from './createEffectStatus'
import {fetchUserFx, fetchFriendsFx} from './api'

export const $fetchUserStatus = createEffectStatus(fetchUserFx)
export const $fetchFriendsStatus = createEffectStatus(fetchFriendsFx)

Import createEffectStatus from './createEffectStatus' was treated as factory function so each store created by it has its own sid and will be handled by serialize independently, although without factories they will share the same sid

factories in documentation

Add user-friendly unit name in fork api error messages when given unit is not found in scope. This improves error messages in both effector and effector-react
Add validation for values and handlers fields in fork and for values field in hydrate
Add type support for createEffect<typeof handler, Error>(handler) to infer Params and Done types from given handler and provide custom Fail type at the same time

createEffect and custom errors in documentation

Improve guard return type inference (PR #406 (thanks @doasync))
Fix void params support for createEffect(name, config) (issue #404)
Allow to use Event<void> in cases when only () => void is accepted (PR #400 (thanks @doasync))
Add support for merge to effector/babel-plugin

effector 21.5.0

Add support for attach({effect}) to create effect which will call effect with params as it is. That allow to create separate effects with shared behavior (PR #396 and #397 (thanks @sergeysova and @oas89))
Add reactSsr option to effector/babel-plugin to replace imports from effector-react to effector-react/ssr. Useful for building both server-side and client-side builds from the same codebase

effector 21.4.0

Add support for return status to allSettled. When allSettled is called with Effect, it return object with value and status fields (discussion)

import {createDomain, fork, allSettled} from 'effector'

const app = createDomain()
const fx = app.createEffect(() => 'ok')
const result = await allSettled(fx, {scope: fork(app)})
// => {status: 'done', value: 'ok'}

Files

CHANGELOG.md

Latest commit

History