@e280/strata 0.0.0-2 → 0.0.0-4

package/README.md

@@ -76,6 +76,31 @@
 
 ## only high-class discerning aristocrats permitted beyond this point
 
+### `Strata.setup` for localStorage persistence etc
+- simple setup
+  ```ts
+  const {strata} = await Strata.setup({
+    version: 1, // 👈 bump whenever your change state schema!
+    initialState: {count: 0},
+  })
+  ```
+- it's compatible with [`@e280/kv`](https://github.com/e280/kv)
+  ```ts
+  import {Kv, StorageDriver} from "@e280/kv"
+
+  const kv = new Kv(new StorageDriver())
+  const store = kv.store<any>("strata")
+
+  const {strata} = await Strata.setup({
+    version: 1,
+    initialState: {count: 0},
+    persistence: {
+      store,
+      onChange: StorageDriver.onStorageEvent,
+    },
+  })
+  ```
+
 ### `Chronstrata` for undo/redo history
 - first, put a `Chronicle` into your state tree
   ```ts
@@ -106,16 +131,6 @@
   ```
 - you can check how many undoable or redoable steps are available
   ```ts
-  snacks.undoable // 0
-
-  await snacks.mutate(s => s.peanuts = 101)
-  await snacks.mutate(s => s.peanuts = 102)
-  await snacks.mutate(s => s.peanuts = 103)
-
-  snacks.undoable // 3
-
-  await snacks.undo()
-
   snacks.undoable // 2
   snacks.redoable // 1
   ```

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@e280/strata",
-	"version": "0.0.0-2",
+	"version": "0.0.0-4",
 	"description": "state management",
 	"license": "MIT",
 	"author": "Chase Moskal <chasemoskal@gmail.com>",

package/s/index.ts

@@ -1,5 +1,6 @@
 
 export * from "./parts/chronstrata.js"
+export * from "./parts/persistence.js"
 export * from "./parts/strata.js"
 export * from "./parts/substrata.js"
 export * from "./parts/types.js"

package/s/parts/chronstrata.ts

@@ -2,13 +2,13 @@
 import {Substrata} from "./substrata.js"
 import {Chronicle, Mutator, Options, Selector, Stratum, Substate} from "./types.js"
 
-export class Chronstrata<ParentState extends Substate, S extends Substate> implements Stratum<S> {
-	#substrata: Substrata<ParentState, Chronicle<S>>
+export class Chronstrata<S extends Substate, ParentState extends Substate = any> implements Stratum<S> {
+	#substrata: Substrata<Chronicle<S>, ParentState>
 
 	constructor(
 			public limit: number,
 			public parent: Stratum<ParentState>,
-			public selector: Selector<ParentState, Chronicle<S>>,
+			public selector: Selector<Chronicle<S>, ParentState>,
 			public options: Options,
 		) {
 		this.#substrata = parent.substrata(selector)
@@ -77,7 +77,7 @@ export class Chronstrata<ParentState extends Substate, S extends Substate> imple
 		})
 	}
 
-	substrata<Sub extends Substate>(selector: Selector<S, Sub>): Substrata<S, Sub> {
+	substrata<Sub extends Substate>(selector: Selector<Sub, S>): Substrata<Sub, S> {
 		return new Substrata(this, selector, this.options)
 	}
 }

package/s/parts/persistence.ts

@@ -0,0 +1,31 @@
+
+import {Persistence} from "./types.js"
+
+export const localPersistence = <X>(
+		key: string,
+		storage: Storage = window.localStorage,
+	): Persistence<X> => ({
+
+	store: {
+		async get() {
+			const json = storage.getItem(key)
+			return json
+				? JSON.parse(json)
+				: undefined
+		},
+		async set(state) {
+			const json = JSON.stringify(state)
+			storage.setItem(key, json)
+		},
+	},
+
+	onChange: (fn: () => void) => {
+		const listener = (event: StorageEvent) => {
+			if (event.storageArea === storage && event.key === key)
+				fn()
+		}
+		window.addEventListener("storage", listener)
+		return () => window.removeEventListener("storage", listener)
+	},
+})
+

package/s/parts/strata.ts

@@ -1,12 +1,14 @@
 
 import {debounce, deep, sub} from "@e280/stz"
 
+import {strataSetup} from "./utils/setup.js"
 import {Substrata} from "./substrata.js"
 import {Chronstrata} from "./chronstrata.js"
 import {processOptions} from "./utils/process-options.js"
 import {Chronicle, Mutator, Options, Selector, State, Stratum, Substate} from "./types.js"
 
 export class Strata<S extends State> implements Stratum<S> {
+	static setup = strataSetup
 	static chronicle = <S extends Substate>(state: S): Chronicle<S> => ({
 		present: state,
 		past: [],
@@ -19,11 +21,6 @@ export class Strata<S extends State> implements Stratum<S> {
 	#mutable: S
 	#immutable: S
 	#mutationLock = 0
-	#dispatchMutation = debounce(0, async(state: S) => {
-		this.#mutationLock++
-		try { await this.watch.pub(state) }
-		finally { this.#mutationLock-- }
-	})
 
 	constructor(state: S, options: Partial<Options> = {}) {
 		this.options = processOptions(options)
@@ -31,11 +28,6 @@ export class Strata<S extends State> implements Stratum<S> {
 		this.#immutable = deep.freeze(this.options.clone(state))
 	}
 
-	#updateState(state: S) {
-		this.#mutable = state
-		this.#immutable = deep.freeze(this.options.clone(state))
-	}
-
 	get state() {
 		return this.#immutable
 	}
@@ -49,23 +41,31 @@ export class Strata<S extends State> implements Stratum<S> {
 		finally { this.#mutationLock-- }
 		const newState = this.#mutable
 		const isChanged = !deep.equal(newState, oldState)
-		if (isChanged) {
-			this.#updateState(newState)
-			const immutable = this.state
-			await this.#dispatchMutation(immutable)
-		}
+		if (isChanged) await this.overwrite(newState)
 		return this.#immutable
 	}
 
-	substrata<Sub extends Substate>(selector: Selector<S, Sub>): Substrata<S, Sub> {
+	async overwrite(state: S) {
+		this.#mutable = state
+		this.#immutable = deep.freeze(this.options.clone(state))
+		await this.#dispatchMutation()
+	}
+
+	substrata<Sub extends Substate>(selector: Selector<Sub, S>): Substrata<Sub, S> {
 		return new Substrata(this, selector, this.options)
 	}
 
 	chronstrata<Sub extends Substate>(
 			limit: number,
-			selector: Selector<S, Chronicle<Sub>>,
+			selector: Selector<Chronicle<Sub>, S>,
 		) {
 		return new Chronstrata(limit, this, selector, this.options)
 	}
+
+	#dispatchMutation = debounce(0, async() => {
+		this.#mutationLock++
+		try { await this.watch.pub(this.#immutable) }
+		finally { this.#mutationLock-- }
+	})
 }
 

package/s/parts/substrata.ts

@@ -3,7 +3,7 @@ import {debounce, deep, sub} from "@e280/stz"
 import {Chronstrata} from "./chronstrata.js"
 import {Chronicle, Mutator, Options, Selector, Stratum, Substate} from "./types.js"
 
-export class Substrata<ParentState extends Substate, S extends Substate> implements Stratum<S> {
+export class Substrata<S extends Substate, ParentState extends Substate = any> implements Stratum<S> {
 	dispose: () => void
 	watch = sub<[state: S]>()
 
@@ -12,7 +12,7 @@ export class Substrata<ParentState extends Substate, S extends Substate> impleme
 
 	constructor(
 			private parent: Stratum<ParentState>,
-			private selector: Selector<ParentState, S>,
+			private selector: Selector<S, ParentState>,
 			private options: Options,
 		) {
 
@@ -44,13 +44,13 @@ export class Substrata<ParentState extends Substate, S extends Substate> impleme
 		return this.#immutable
 	}
 
-	substrata<Sub extends Substate>(selector: Selector<S, Sub>): Substrata<S, Sub> {
+	substrata<Sub extends Substate>(selector: Selector<Sub, S>): Substrata<Sub, S> {
 		return new Substrata(this, selector, this.options)
 	}
 
 	chronstrata<Sub extends Substate>(
 			limit: number,
-			selector: Selector<S, Chronicle<Sub>>,
+			selector: Selector<Chronicle<Sub>, S>,
 		) {
 		return new Chronstrata(limit, this, selector, this.options)
 	}

package/s/parts/types.ts

@@ -5,17 +5,29 @@ export type Options = {
 	clone: <X>(x: X) => X
 }
 
-export type Selector<S, Sub> = (state: S) => Sub
+export type Selector<Sub, S> = (state: S) => Sub
 export type Mutator<S> = (state: S) => void
 
 export type State = {}
 export type Substate = {} | null | undefined
 
+export type Versioned<S extends State> = {
+	state: S
+	version: number
+}
+
 export type Stratum<S extends Substate> = {
 	readonly state: S
 	watch(fn: (s: S) => void): () => void
 	mutate(mutator: Mutator<S>): Promise<S>
-	substrata<Sub extends Substate>(selector: Selector<S, Sub>): Substrata<S, Sub>
+	substrata<Sub extends Substate>(selector: Selector<Sub, S>): Substrata<Sub, S>
+}
+
+export type SetupOptions<S extends State> = {
+	version: number
+	initialState: S
+	saveDebounceTime?: number
+	persistence?: Persistence<Versioned<S>>
 }
 
 export type Chronicle<S extends Substate> = {
@@ -29,3 +41,13 @@ export type Chronicle<S extends Substate> = {
 	future: S[]
 }
 
+export type EzStore<X> = {
+	get(): Promise<X | undefined>
+	set(state: X | undefined): Promise<void>
+}
+
+export type Persistence<X> = {
+	store: EzStore<X>
+	onChange: (fn: () => void) => (() => void)
+}
+

package/s/parts/utils/process-options.ts

@@ -2,6 +2,6 @@
 import {Options} from "../types.js"
 
 export const processOptions = (options: Partial<Options>): Options => ({
-	clone: options.clone ?? structuredClone,
+	clone: options.clone ?? (<X>(x: X) => structuredClone(x)),
 })
 

package/s/parts/utils/setup.ts

@@ -0,0 +1,40 @@
+
+import {debounce} from "@e280/stz"
+
+import {Strata} from "../strata.js"
+import {State, SetupOptions} from "../types.js"
+import {localPersistence} from "../persistence.js"
+
+export async function strataSetup<S extends State>(options: SetupOptions<S>) {
+	const {
+		version,
+		initialState,
+		saveDebounceTime = 500,
+		persistence = localPersistence("strata"),
+	} = options
+
+	const strata = new Strata<S>(initialState)
+
+	async function load() {
+		const pickle = await persistence.store.get()
+		if (pickle && pickle.version === version)
+			await strata.overwrite(pickle.state)
+	}
+
+	const save = debounce(saveDebounceTime, async() => persistence.store.set({
+		version,
+		state: strata.state,
+	}))
+
+	// persistence: initial load from store
+	await load()
+
+	// persistence: save to store
+	strata.watch(save)
+
+	// cross-tab sync
+	const dispose = persistence.onChange(load)
+
+	return {strata, load, save, dispose}
+}
+

package/x/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./parts/chronstrata.js";
+export * from "./parts/persistence.js";
 export * from "./parts/strata.js";
 export * from "./parts/substrata.js";
 export * from "./parts/types.js";

package/x/index.js

@@ -1,4 +1,5 @@
 export * from "./parts/chronstrata.js";
+export * from "./parts/persistence.js";
 export * from "./parts/strata.js";
 export * from "./parts/substrata.js";
 export * from "./parts/types.js";

package/x/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../s/index.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../s/index.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA"}

package/x/parts/chronstrata.d.ts

@@ -1,12 +1,12 @@
 import { Substrata } from "./substrata.js";
 import { Chronicle, Mutator, Options, Selector, Stratum, Substate } from "./types.js";
-export declare class Chronstrata<ParentState extends Substate, S extends Substate> implements Stratum<S> {
+export declare class Chronstrata<S extends Substate, ParentState extends Substate = any> implements Stratum<S> {
     #private;
     limit: number;
     parent: Stratum<ParentState>;
-    selector: Selector<ParentState, Chronicle<S>>;
+    selector: Selector<Chronicle<S>, ParentState>;
     options: Options;
-    constructor(limit: number, parent: Stratum<ParentState>, selector: Selector<ParentState, Chronicle<S>>, options: Options);
+    constructor(limit: number, parent: Stratum<ParentState>, selector: Selector<Chronicle<S>, ParentState>, options: Options);
     get state(): S;
     get undoable(): number;
     get redoable(): number;
@@ -19,5 +19,5 @@ export declare class Chronstrata<ParentState extends Substate, S extends Substat
     redo(n?: number): Promise<void>;
     /** wipe past and future snapshots */
     wipe(): Promise<void>;
-    substrata<Sub extends Substate>(selector: Selector<S, Sub>): Substrata<S, Sub>;
+    substrata<Sub extends Substate>(selector: Selector<Sub, S>): Substrata<Sub, S>;
 }

package/x/parts/persistence.d.ts

@@ -0,0 +1,2 @@
+import { Persistence } from "./types.js";
+export declare const localPersistence: <X>(key: string, storage?: Storage) => Persistence<X>;

package/x/parts/persistence.js

@@ -0,0 +1,23 @@
+export const localPersistence = (key, storage = window.localStorage) => ({
+    store: {
+        async get() {
+            const json = storage.getItem(key);
+            return json
+                ? JSON.parse(json)
+                : undefined;
+        },
+        async set(state) {
+            const json = JSON.stringify(state);
+            storage.setItem(key, json);
+        },
+    },
+    onChange: (fn) => {
+        const listener = (event) => {
+            if (event.storageArea === storage && event.key === key)
+                fn();
+        };
+        window.addEventListener("storage", listener);
+        return () => window.removeEventListener("storage", listener);
+    },
+});
+//# sourceMappingURL=persistence.js.map

package/x/parts/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../s/parts/persistence.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,GAAW,EACX,UAAmB,MAAM,CAAC,YAAY,EACrB,EAAE,CAAC,CAAC;IAEtB,KAAK,EAAE;QACN,KAAK,CAAC,GAAG;YACR,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;YACjC,OAAO,IAAI;gBACV,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBAClB,CAAC,CAAC,SAAS,CAAA;QACb,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,KAAK;YACd,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;YAClC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QAC3B,CAAC;KACD;IAED,QAAQ,EAAE,CAAC,EAAc,EAAE,EAAE;QAC5B,MAAM,QAAQ,GAAG,CAAC,KAAmB,EAAE,EAAE;YACxC,IAAI,KAAK,CAAC,WAAW,KAAK,OAAO,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG;gBACrD,EAAE,EAAE,CAAA;QACN,CAAC,CAAA;QACD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAC5C,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IAC7D,CAAC;CACD,CAAC,CAAA"}

package/x/parts/strata.d.ts

@@ -1,14 +1,17 @@
+import { strataSetup } from "./utils/setup.js";
 import { Substrata } from "./substrata.js";
 import { Chronstrata } from "./chronstrata.js";
 import { Chronicle, Mutator, Options, Selector, State, Stratum, Substate } from "./types.js";
 export declare class Strata<S extends State> implements Stratum<S> {
     #private;
+    static setup: typeof strataSetup;
     static chronicle: <S_1 extends Substate>(state: S_1) => Chronicle<S_1>;
     options: Options;
     watch: import("@e280/stz").Sub<[state: S]>;
     constructor(state: S, options?: Partial<Options>);
     get state(): S;
     mutate(mutator: Mutator<S>): Promise<S>;
-    substrata<Sub extends Substate>(selector: Selector<S, Sub>): Substrata<S, Sub>;
-    chronstrata<Sub extends Substate>(limit: number, selector: Selector<S, Chronicle<Sub>>): Chronstrata<S, Sub>;
+    overwrite(state: S): Promise<void>;
+    substrata<Sub extends Substate>(selector: Selector<Sub, S>): Substrata<Sub, S>;
+    chronstrata<Sub extends Substate>(limit: number, selector: Selector<Chronicle<Sub>, S>): Chronstrata<Sub, S>;
 }

package/x/parts/strata.js

@@ -1,8 +1,10 @@
 import { debounce, deep, sub } from "@e280/stz";
+import { strataSetup } from "./utils/setup.js";
 import { Substrata } from "./substrata.js";
 import { Chronstrata } from "./chronstrata.js";
 import { processOptions } from "./utils/process-options.js";
 export class Strata {
+    static setup = strataSetup;
     static chronicle = (state) => ({
         present: state,
         past: [],
@@ -13,24 +15,11 @@ export class Strata {
     #mutable;
     #immutable;
     #mutationLock = 0;
-    #dispatchMutation = debounce(0, async (state) => {
-        this.#mutationLock++;
-        try {
-            await this.watch.pub(state);
-        }
-        finally {
-            this.#mutationLock--;
-        }
-    });
     constructor(state, options = {}) {
         this.options = processOptions(options);
         this.#mutable = state;
         this.#immutable = deep.freeze(this.options.clone(state));
     }
-    #updateState(state) {
-        this.#mutable = state;
-        this.#immutable = deep.freeze(this.options.clone(state));
-    }
     get state() {
         return this.#immutable;
     }
@@ -47,18 +36,29 @@ export class Strata {
         }
         const newState = this.#mutable;
         const isChanged = !deep.equal(newState, oldState);
-        if (isChanged) {
-            this.#updateState(newState);
-            const immutable = this.state;
-            await this.#dispatchMutation(immutable);
-        }
+        if (isChanged)
+            await this.overwrite(newState);
         return this.#immutable;
     }
+    async overwrite(state) {
+        this.#mutable = state;
+        this.#immutable = deep.freeze(this.options.clone(state));
+        await this.#dispatchMutation();
+    }
     substrata(selector) {
         return new Substrata(this, selector, this.options);
     }
     chronstrata(limit, selector) {
         return new Chronstrata(limit, this, selector, this.options);
     }
+    #dispatchMutation = debounce(0, async () => {
+        this.#mutationLock++;
+        try {
+            await this.watch.pub(this.#immutable);
+        }
+        finally {
+            this.#mutationLock--;
+        }
+    });
 }
 //# sourceMappingURL=strata.js.map

package/x/parts/strata.js.map

@@ -1 +1 @@
-{"version":3,"file":"strata.js","sourceRoot":"","sources":["../../s/parts/strata.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"strata.js","sourceRoot":"","sources":["../../s/parts/strata.ts"],"names":[],"mappings":"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"}

package/x/parts/substrata.d.ts

@@ -1,15 +1,15 @@
 import { Chronstrata } from "./chronstrata.js";
 import { Chronicle, Mutator, Options, Selector, Stratum, Substate } from "./types.js";
-export declare class Substrata<ParentState extends Substate, S extends Substate> implements Stratum<S> {
+export declare class Substrata<S extends Substate, ParentState extends Substate = any> implements Stratum<S> {
     #private;
     private parent;
     private selector;
     private options;
     dispose: () => void;
     watch: import("@e280/stz").Sub<[state: S]>;
-    constructor(parent: Stratum<ParentState>, selector: Selector<ParentState, S>, options: Options);
+    constructor(parent: Stratum<ParentState>, selector: Selector<S, ParentState>, options: Options);
     get state(): S;
     mutate(mutator: Mutator<S>): Promise<S>;
-    substrata<Sub extends Substate>(selector: Selector<S, Sub>): Substrata<S, Sub>;
-    chronstrata<Sub extends Substate>(limit: number, selector: Selector<S, Chronicle<Sub>>): Chronstrata<S, Sub>;
+    substrata<Sub extends Substate>(selector: Selector<Sub, S>): Substrata<Sub, S>;
+    chronstrata<Sub extends Substate>(limit: number, selector: Selector<Chronicle<Sub>, S>): Chronstrata<Sub, S>;
 }

package/x/parts/types.d.ts

@@ -2,18 +2,36 @@ import { Substrata } from "./substrata.js";
 export type Options = {
     clone: <X>(x: X) => X;
 };
-export type Selector<S, Sub> = (state: S) => Sub;
+export type Selector<Sub, S> = (state: S) => Sub;
 export type Mutator<S> = (state: S) => void;
 export type State = {};
 export type Substate = {} | null | undefined;
+export type Versioned<S extends State> = {
+    state: S;
+    version: number;
+};
 export type Stratum<S extends Substate> = {
     readonly state: S;
     watch(fn: (s: S) => void): () => void;
     mutate(mutator: Mutator<S>): Promise<S>;
-    substrata<Sub extends Substate>(selector: Selector<S, Sub>): Substrata<S, Sub>;
+    substrata<Sub extends Substate>(selector: Selector<Sub, S>): Substrata<Sub, S>;
+};
+export type SetupOptions<S extends State> = {
+    version: number;
+    initialState: S;
+    saveDebounceTime?: number;
+    persistence?: Persistence<Versioned<S>>;
 };
 export type Chronicle<S extends Substate> = {
     past: S[];
     present: S;
     future: S[];
 };
+export type EzStore<X> = {
+    get(): Promise<X | undefined>;
+    set(state: X | undefined): Promise<void>;
+};
+export type Persistence<X> = {
+    store: EzStore<X>;
+    onChange: (fn: () => void) => (() => void);
+};

package/x/parts/utils/process-options.js

@@ -1,4 +1,4 @@
 export const processOptions = (options) => ({
-    clone: options.clone ?? structuredClone,
+    clone: options.clone ?? ((x) => structuredClone(x)),
 });
 //# sourceMappingURL=process-options.js.map

package/x/parts/utils/process-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"process-options.js","sourceRoot":"","sources":["../../../s/parts/utils/process-options.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAyB,EAAW,EAAE,CAAC,CAAC;IACtE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,eAAe;CACvC,CAAC,CAAA"}
+{"version":3,"file":"process-options.js","sourceRoot":"","sources":["../../../s/parts/utils/process-options.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAyB,EAAW,EAAE,CAAC,CAAC;IACtE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,CAAI,CAAI,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CACzD,CAAC,CAAA"}

package/x/parts/utils/setup.d.ts

@@ -0,0 +1,8 @@
+import { Strata } from "../strata.js";
+import { State, SetupOptions } from "../types.js";
+export declare function strataSetup<S extends State>(options: SetupOptions<S>): Promise<{
+    strata: Strata<S>;
+    load: () => Promise<void>;
+    save: import("@e280/stz").DebounceReturn<() => Promise<void>>;
+    dispose: () => void;
+}>;

package/x/parts/utils/setup.js

@@ -0,0 +1,24 @@
+import { debounce } from "@e280/stz";
+import { Strata } from "../strata.js";
+import { localPersistence } from "../persistence.js";
+export async function strataSetup(options) {
+    const { version, initialState, saveDebounceTime = 500, persistence = localPersistence("strata"), } = options;
+    const strata = new Strata(initialState);
+    async function load() {
+        const pickle = await persistence.store.get();
+        if (pickle && pickle.version === version)
+            await strata.overwrite(pickle.state);
+    }
+    const save = debounce(saveDebounceTime, async () => persistence.store.set({
+        version,
+        state: strata.state,
+    }));
+    // persistence: initial load from store
+    await load();
+    // persistence: save to store
+    strata.watch(save);
+    // cross-tab sync
+    const dispose = persistence.onChange(load);
+    return { strata, load, save, dispose };
+}
+//# sourceMappingURL=setup.js.map

package/x/parts/utils/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../s/parts/utils/setup.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,QAAQ,EAAC,MAAM,WAAW,CAAA;AAElC,OAAO,EAAC,MAAM,EAAC,MAAM,cAAc,CAAA;AAEnC,OAAO,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAA;AAElD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAkB,OAAwB;IAC1E,MAAM,EACL,OAAO,EACP,YAAY,EACZ,gBAAgB,GAAG,GAAG,EACtB,WAAW,GAAG,gBAAgB,CAAC,QAAQ,CAAC,GACxC,GAAG,OAAO,CAAA;IAEX,MAAM,MAAM,GAAG,IAAI,MAAM,CAAI,YAAY,CAAC,CAAA;IAE1C,KAAK,UAAU,IAAI;QAClB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;QAC5C,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO;YACvC,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACtC,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,gBAAgB,EAAE,KAAK,IAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC;QACxE,OAAO;QACP,KAAK,EAAE,MAAM,CAAC,KAAK;KACnB,CAAC,CAAC,CAAA;IAEH,uCAAuC;IACvC,MAAM,IAAI,EAAE,CAAA;IAEZ,6BAA6B;IAC7B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAElB,iBAAiB;IACjB,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAE1C,OAAO,EAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAC,CAAA;AACrC,CAAC"}