@crikey/stores-immer

Provide svelte compatible implementations of readable, writable, derived and get using immutible values via immer.

Strict inequality triggering semantics provide a store version of the functionality seen with <svelte:options immutable={true} /> in the svelte compiler.

Using immer, @crikey/stores-immer is able to provide copy-on-write semantics during updates.

See @crikey/stores-immer for full documentation.

API

Store creation functions:

• constant - Create a Readable store with a fixed value
• readable - Create a Readable store
• writable - Create a Writable immer store
• derive - Create a Readable store derived from the resolved values of other stores

Utility functions:

• get - Retrieve the value of a store

Installation

1# pnpm
2$ pnpm add @crikey/stores-immer
3
4# npm
5$ npm add @crikey/stores-immer
6
7# yarn
8$ yarn add @crikey/stores-immer

Usage

Standard usage should be a drop in replacement for svelte/store. The key difference being that mutating a store value will use immer to perform copy-on-write semantics during an Writable.update | update.

Example

1const initial = [1,2,3];
2const store = writable([1,2,3]);
3store.subscribe(value => console.log(value));
4// > [ 1, 2, 3 ]
5
6store.update(value => {
7    value.push(4);
8    return value;
9})
10// > [ 1, 2, 3, 4 ]
11
12console.log(get(store) !== initial);
13// > true