This commit is contained in:
eewing
2026-02-17 14:10:16 -06:00
parent 2bca5834c5
commit cf73cd3b4c
11246 changed files with 1690552 additions and 0 deletions
+1
View File
@@ -0,0 +1 @@
export * from "./state-history.svelte.js";
+1
View File
@@ -0,0 +1 @@
export * from "./state-history.svelte.js";
@@ -0,0 +1,24 @@
import type { MaybeGetter, Setter } from "../../internal/types.js";
type LogEvent<T> = {
snapshot: T;
timestamp: number;
};
type StateHistoryOptions = {
capacity?: MaybeGetter<number>;
};
/**
* Tracks the change history of a value, providing undo and redo capabilities.
*
* @see {@link https://runed.dev/docs/utilities/state-history}
*/
export declare class StateHistory<T> {
#private;
log: LogEvent<T>[];
readonly canUndo: boolean;
readonly canRedo: boolean;
constructor(value: MaybeGetter<T>, set: Setter<T>, options?: StateHistoryOptions);
undo(): void;
redo(): void;
clear(): void;
}
export {};
@@ -0,0 +1,62 @@
import { watch } from "../watch/watch.svelte.js";
import { get } from "../../internal/utils/get.js";
/**
* Tracks the change history of a value, providing undo and redo capabilities.
*
* @see {@link https://runed.dev/docs/utilities/state-history}
*/
export class StateHistory {
#redoStack = $state([]);
#ignoreUpdate = false;
#set;
log = $state([]);
canUndo = $derived(this.log.length > 1);
canRedo = $derived(this.#redoStack.length > 0);
constructor(value, set, options) {
this.#redoStack = [];
this.#set = set;
this.undo = this.undo.bind(this);
this.redo = this.redo.bind(this);
const addEvent = (event) => {
this.log.push(event);
const capacity$ = get(options?.capacity);
if (capacity$ && this.log.length > capacity$) {
this.log = this.log.slice(-capacity$);
}
};
watch(() => get(value), (v) => {
if (this.#ignoreUpdate) {
this.#ignoreUpdate = false;
return;
}
addEvent({ snapshot: v, timestamp: new Date().getTime() });
this.#redoStack = [];
});
watch(() => get(options?.capacity), (c) => {
if (!c)
return;
this.log = this.log.slice(-c);
});
}
undo() {
const [prev, curr] = this.log.slice(-2);
if (!curr || !prev)
return;
this.#ignoreUpdate = true;
this.#redoStack.push(curr);
this.log.pop();
this.#set(prev.snapshot);
}
redo() {
const nextEvent = this.#redoStack.pop();
if (!nextEvent)
return;
this.#ignoreUpdate = true;
this.log.push(nextEvent);
this.#set(nextEvent.snapshot);
}
clear() {
this.log = [];
this.#redoStack = [];
}
}