Structura.js

A very fast and lightweight Typescript library to create immutable states with a mutable syntax
GitHub
414
Created 2 years ago, last commit 4 months ago
5 contributors
405 commits
Stars added on GitHub, month by month
0
0
11
12
1
2
3
4
5
6
7
8
9
10
2023
2024
Stars added on GitHub, per day, on average
Yesterday
=
Last week
+0.1
/day
Last month
+0.1
/day
Last 12 months
+0.1
/day
npmPackage on NPM
Monthly downloads on NPM
11
12
1
2
3
4
5
6
7
8
9
10
2023
2024
No dependencies
README

Structura.js

structura

You can find complete docs at https://giusepperaso.github.io/structura.js/

Structura.js is a very fast and lightweight Typescript library which allows to create immutable states with a mutable syntax. It is based on the idea of structural sharing.

The library is very similar to Immer.js, but it has some advantages over it:

  • up to ~10x more performant, even faster than Immutable most of the time
  • freezes the object only at compile time by leveraging Typescript, while other libraries freeze the object at runtime with Object.freeze, which may be slow expecially for nested objects
  • circular and multiple references are supported
  • can return and modify the draft at the same time
  • flexibility in the return type of the producer
  • no need to toggle on/off features (with some exceptions)
  • does support transpositions and moves of portions of the draft

The library is actually in alpha state. It is probably already usable (many complex scenarios are already covered by tests), but the APIs and the types could change in the future.

BREAKING CHANGES

  • v.0.9.0-alpha: produceWithStandardPatches was removed from the library; use enableStandardPatches(true) instead
  • v.0.8.0-alpha: patches use 'op' instead of 'action' as key for the operation; they can also be passed in the JSON format
  • v.0.6.0-alpha: revert back to accept primitives, just don't draft them; also accept the in operator
  • v.0.5.0-alpha: don't accept primitive types at runtime
  • v.0.4.0-alpha: primitive types are not accepted anymore in the produce function