fabricjs-document-engine 0.0.0 → 0.2.0

package/dist/history/create-history.js

@@ -0,0 +1,192 @@
+import { applyStateChange } from "./apply-state.js";
+import { createHistoryStack } from "./history-stack.js";
+import { createSnapshot, diffSnapshots } from "./snapshot.js";
+//#region src/history/create-history.ts
+const verbsByAction = {
+	drag: "Move",
+	rotate: "Rotate",
+	scale: "Resize",
+	scaleX: "Resize",
+	scaleY: "Resize",
+	resizing: "Resize",
+	skewX: "Skew",
+	skewY: "Skew"
+};
+function nameOf(object) {
+	return (object.constructor.type ?? object.type).toLowerCase();
+}
+function isPromiseLike(value) {
+	return typeof value?.then === "function";
+}
+function describePendingChanges(changes) {
+	if (new Set(changes.map((change) => change.verb)).size > 1) return "Edit objects";
+	const verb = changes[0]?.verb ?? "Edit";
+	return changes.length === 1 ? `${verb} ${changes[0].noun}` : `${verb} ${changes.length} objects`;
+}
+function createHistory(options) {
+	const { canvas, serializeObjects, onChange, onContentChange } = options;
+	const stack = createHistoryStack(Math.max(1, options.limit ?? 100));
+	let snapshot = createSnapshot(serializeObjects());
+	let pendingChanges = [];
+	let flushScheduled = false;
+	let transactionDepth = 0;
+	let pausedDepth = 0;
+	let applying = false;
+	let queue = Promise.resolve();
+	function state() {
+		const undoLabels = stack.undoLabels();
+		const redoLabels = stack.redoLabels();
+		return {
+			canUndo: undoLabels.length > 0,
+			canRedo: redoLabels.length > 0,
+			undoLabel: undoLabels[0],
+			redoLabel: redoLabels[0]
+		};
+	}
+	function commit(label) {
+		pendingChanges = [];
+		const nextSnapshot = createSnapshot(serializeObjects());
+		const difference = diffSnapshots(snapshot, nextSnapshot);
+		snapshot = nextSnapshot;
+		if (difference === null) return false;
+		stack.record({
+			label,
+			...difference
+		});
+		onContentChange();
+		onChange(state());
+		return true;
+	}
+	function isRecording() {
+		return !applying && pausedDepth === 0 && transactionDepth === 0;
+	}
+	function commitPendingChanges() {
+		flushScheduled = false;
+		if (pendingChanges.length === 0) return;
+		if (isRecording()) commit(describePendingChanges(pendingChanges));
+		pendingChanges = [];
+	}
+	function notice(verb, target) {
+		if (!isRecording()) return;
+		pendingChanges.push({
+			verb,
+			noun: nameOf(target)
+		});
+		if (flushScheduled) return;
+		flushScheduled = true;
+		queueMicrotask(commitPendingChanges);
+	}
+	const handleAdded = ({ target }) => notice("Add", target);
+	const handleRemoved = ({ target }) => notice("Delete", target);
+	const handleModified = (event) => {
+		const action = event.action ?? event.transform?.action ?? "";
+		notice(verbsByAction[action] ?? "Transform", event.target);
+	};
+	const handleTextEdited = ({ target }) => notice("Edit", target);
+	const listeners = [
+		["object:added", handleAdded],
+		["object:removed", handleRemoved],
+		["object:modified", handleModified],
+		["text:editing:exited", handleTextEdited]
+	];
+	const eventTarget = canvas;
+	listeners.forEach(([name, handler]) => eventTarget.on(name, handler));
+	function transaction(label, work) {
+		if (transactionDepth === 0) commitPendingChanges();
+		transactionDepth += 1;
+		const finish = () => {
+			transactionDepth -= 1;
+			if (transactionDepth === 0) commit(label);
+		};
+		let result;
+		try {
+			result = work();
+		} catch (error) {
+			finish();
+			throw error;
+		}
+		if (!isPromiseLike(result)) {
+			finish();
+			return result;
+		}
+		return Promise.resolve(result).then((value) => {
+			finish();
+			return value;
+		}, (error) => {
+			finish();
+			throw error;
+		});
+	}
+	function withoutRecording(work) {
+		pausedDepth += 1;
+		let result;
+		try {
+			result = work();
+		} catch (error) {
+			pausedDepth -= 1;
+			throw error;
+		}
+		if (!isPromiseLike(result)) {
+			pausedDepth -= 1;
+			return result;
+		}
+		return Promise.resolve(result).finally(() => {
+			pausedDepth -= 1;
+		});
+	}
+	function runInOrder(task) {
+		const run = queue.then(task);
+		queue = run.catch(() => void 0);
+		return run;
+	}
+	function travel(takeStep, pickChange, putBack, moveTo) {
+		return runInOrder(async () => {
+			if (transactionDepth > 0) return false;
+			commitPendingChanges();
+			const step = takeStep();
+			if (step === void 0) return false;
+			applying = true;
+			try {
+				await applyStateChange(canvas, pickChange(step));
+			} catch (error) {
+				putBack(step);
+				throw error;
+			} finally {
+				applying = false;
+			}
+			snapshot = createSnapshot(serializeObjects());
+			moveTo(step);
+			onContentChange();
+			onChange(state());
+			return true;
+		});
+	}
+	return {
+		commit(label) {
+			if (applying) return false;
+			return commit(label);
+		},
+		transaction,
+		undo: () => travel(() => stack.takeUndo(), (step) => step.before, (step) => stack.returnUndo(step), (step) => stack.returnRedo(step)),
+		redo: () => travel(() => stack.takeRedo(), (step) => step.after, (step) => stack.returnRedo(step), (step) => stack.returnUndo(step)),
+		state,
+		labels: () => ({
+			undo: stack.undoLabels(),
+			redo: stack.redoLabels()
+		}),
+		withoutRecording,
+		reset() {
+			pendingChanges = [];
+			stack.clear();
+			snapshot = createSnapshot(serializeObjects());
+			onChange(state());
+		},
+		destroy() {
+			listeners.forEach(([name, handler]) => eventTarget.off(name, handler));
+			pendingChanges = [];
+			stack.clear();
+		}
+	};
+}
+//#endregion
+export { createHistory, describePendingChanges };

package/dist/history/history-stack.cjs

@@ -0,0 +1,27 @@
+//#region src/history/history-stack.ts
+function createHistoryStack(limit) {
+	const undoSteps = [];
+	const redoSteps = [];
+	function pushWithinLimit(steps, step) {
+		steps.push(step);
+		if (steps.length > limit) steps.shift();
+	}
+	return {
+		record(step) {
+			pushWithinLimit(undoSteps, step);
+			redoSteps.length = 0;
+		},
+		takeUndo: () => undoSteps.pop(),
+		takeRedo: () => redoSteps.pop(),
+		returnUndo: (step) => pushWithinLimit(undoSteps, step),
+		returnRedo: (step) => pushWithinLimit(redoSteps, step),
+		undoLabels: () => undoSteps.map((step) => step.label).reverse(),
+		redoLabels: () => redoSteps.map((step) => step.label).reverse(),
+		clear() {
+			undoSteps.length = 0;
+			redoSteps.length = 0;
+		}
+	};
+}
+//#endregion
+exports.createHistoryStack = createHistoryStack;

package/dist/history/history-stack.js

@@ -0,0 +1,27 @@
+//#region src/history/history-stack.ts
+function createHistoryStack(limit) {
+	const undoSteps = [];
+	const redoSteps = [];
+	function pushWithinLimit(steps, step) {
+		steps.push(step);
+		if (steps.length > limit) steps.shift();
+	}
+	return {
+		record(step) {
+			pushWithinLimit(undoSteps, step);
+			redoSteps.length = 0;
+		},
+		takeUndo: () => undoSteps.pop(),
+		takeRedo: () => redoSteps.pop(),
+		returnUndo: (step) => pushWithinLimit(undoSteps, step),
+		returnRedo: (step) => pushWithinLimit(redoSteps, step),
+		undoLabels: () => undoSteps.map((step) => step.label).reverse(),
+		redoLabels: () => redoSteps.map((step) => step.label).reverse(),
+		clear() {
+			undoSteps.length = 0;
+			redoSteps.length = 0;
+		}
+	};
+}
+//#endregion
+export { createHistoryStack };

package/dist/history/keyboard-shortcuts.cjs

@@ -0,0 +1,32 @@
+//#region src/history/keyboard-shortcuts.ts
+function isTypingInto(element) {
+	if (!(element instanceof HTMLElement)) return false;
+	if (element.isContentEditable) return true;
+	return [
+		"INPUT",
+		"TEXTAREA",
+		"SELECT"
+	].includes(element.tagName);
+}
+function chooseAction(event) {
+	if (!(event.metaKey || event.ctrlKey) || event.altKey) return null;
+	const key = event.key.toLowerCase();
+	if (key === "z") return event.shiftKey ? "redo" : "undo";
+	if (key === "y" && event.ctrlKey && !event.shiftKey) return "redo";
+	return null;
+}
+function bindKeyboardShortcuts(engine, options = {}) {
+	const target = options.target ?? globalThis.window;
+	const handleKeyDown = (event) => {
+		const keyboardEvent = event;
+		if (keyboardEvent.defaultPrevented || isTypingInto(keyboardEvent.target)) return;
+		const action = chooseAction(keyboardEvent);
+		if (action === null) return;
+		keyboardEvent.preventDefault();
+		engine[action]().catch(() => void 0);
+	};
+	target.addEventListener("keydown", handleKeyDown);
+	return () => target.removeEventListener("keydown", handleKeyDown);
+}
+//#endregion
+exports.bindKeyboardShortcuts = bindKeyboardShortcuts;

package/dist/history/keyboard-shortcuts.d.cts

@@ -0,0 +1,10 @@
+//#region src/history/keyboard-shortcuts.d.ts
+export interface UndoRedoTarget {
+  undo(): Promise<boolean>;
+  redo(): Promise<boolean>;
+}
+export interface KeyboardShortcutOptions {
+  target?: EventTarget;
+}
+export declare function bindKeyboardShortcuts(engine: UndoRedoTarget, options?: KeyboardShortcutOptions): () => void;
+//#endregion

package/dist/history/keyboard-shortcuts.d.ts

@@ -0,0 +1,10 @@
+//#region src/history/keyboard-shortcuts.d.ts
+export interface UndoRedoTarget {
+  undo(): Promise<boolean>;
+  redo(): Promise<boolean>;
+}
+export interface KeyboardShortcutOptions {
+  target?: EventTarget;
+}
+export declare function bindKeyboardShortcuts(engine: UndoRedoTarget, options?: KeyboardShortcutOptions): () => void;
+//#endregion

package/dist/history/keyboard-shortcuts.js

@@ -0,0 +1,32 @@
+//#region src/history/keyboard-shortcuts.ts
+function isTypingInto(element) {
+	if (!(element instanceof HTMLElement)) return false;
+	if (element.isContentEditable) return true;
+	return [
+		"INPUT",
+		"TEXTAREA",
+		"SELECT"
+	].includes(element.tagName);
+}
+function chooseAction(event) {
+	if (!(event.metaKey || event.ctrlKey) || event.altKey) return null;
+	const key = event.key.toLowerCase();
+	if (key === "z") return event.shiftKey ? "redo" : "undo";
+	if (key === "y" && event.ctrlKey && !event.shiftKey) return "redo";
+	return null;
+}
+function bindKeyboardShortcuts(engine, options = {}) {
+	const target = options.target ?? globalThis.window;
+	const handleKeyDown = (event) => {
+		const keyboardEvent = event;
+		if (keyboardEvent.defaultPrevented || isTypingInto(keyboardEvent.target)) return;
+		const action = chooseAction(keyboardEvent);
+		if (action === null) return;
+		keyboardEvent.preventDefault();
+		engine[action]().catch(() => void 0);
+	};
+	target.addEventListener("keydown", handleKeyDown);
+	return () => target.removeEventListener("keydown", handleKeyDown);
+}
+//#endregion
+export { bindKeyboardShortcuts };

package/dist/history/snapshot.cjs

@@ -0,0 +1,47 @@
+//#region src/history/snapshot.ts
+function createSnapshot(objects) {
+	const objectsById = /* @__PURE__ */ new Map();
+	const order = [];
+	for (const object of objects) {
+		const id = object.id ?? "";
+		objectsById.set(id, JSON.stringify(object));
+		order.push(id);
+	}
+	return {
+		objectsById,
+		order
+	};
+}
+function haveSameOrder(first, second) {
+	return first.length === second.length && first.every((id, index) => id === second[index]);
+}
+function diffSnapshots(previous, next) {
+	const before = /* @__PURE__ */ new Map();
+	const after = /* @__PURE__ */ new Map();
+	for (const [id, json] of next.objectsById) {
+		const previousJson = previous.objectsById.get(id);
+		if (previousJson === json) continue;
+		before.set(id, previousJson ?? null);
+		after.set(id, json);
+	}
+	for (const [id, json] of previous.objectsById) {
+		if (next.objectsById.has(id)) continue;
+		before.set(id, json);
+		after.set(id, null);
+	}
+	const orderChanged = !haveSameOrder(previous.order, next.order);
+	if (before.size === 0 && !orderChanged) return null;
+	return {
+		before: {
+			objects: before,
+			order: orderChanged ? previous.order : null
+		},
+		after: {
+			objects: after,
+			order: orderChanged ? next.order : null
+		}
+	};
+}
+//#endregion
+exports.createSnapshot = createSnapshot;
+exports.diffSnapshots = diffSnapshots;

package/dist/history/snapshot.js

@@ -0,0 +1,46 @@
+//#region src/history/snapshot.ts
+function createSnapshot(objects) {
+	const objectsById = /* @__PURE__ */ new Map();
+	const order = [];
+	for (const object of objects) {
+		const id = object.id ?? "";
+		objectsById.set(id, JSON.stringify(object));
+		order.push(id);
+	}
+	return {
+		objectsById,
+		order
+	};
+}
+function haveSameOrder(first, second) {
+	return first.length === second.length && first.every((id, index) => id === second[index]);
+}
+function diffSnapshots(previous, next) {
+	const before = /* @__PURE__ */ new Map();
+	const after = /* @__PURE__ */ new Map();
+	for (const [id, json] of next.objectsById) {
+		const previousJson = previous.objectsById.get(id);
+		if (previousJson === json) continue;
+		before.set(id, previousJson ?? null);
+		after.set(id, json);
+	}
+	for (const [id, json] of previous.objectsById) {
+		if (next.objectsById.has(id)) continue;
+		before.set(id, json);
+		after.set(id, null);
+	}
+	const orderChanged = !haveSameOrder(previous.order, next.order);
+	if (before.size === 0 && !orderChanged) return null;
+	return {
+		before: {
+			objects: before,
+			order: orderChanged ? previous.order : null
+		},
+		after: {
+			objects: after,
+			order: orderChanged ? next.order : null
+		}
+	};
+}
+//#endregion
+export { createSnapshot, diffSnapshots };

package/dist/index.cjs

@@ -3,8 +3,13 @@ const require_document_format = require("./document/document-format.cjs");
 const require_validate_document = require("./document/validate-document.cjs");
 const require_errors = require("./engine/errors.cjs");
 const require_create_document_engine = require("./engine/create-document-engine.cjs");
+const require_keyboard_shortcuts = require("./history/keyboard-shortcuts.cjs");
+const require_unsaved_changes_warning = require("./save/unsaved-changes-warning.cjs");
 exports.CURRENT_SCHEMA_VERSION = require_document_format.CURRENT_SCHEMA_VERSION;
 exports.DocumentEngineError = require_errors.DocumentEngineError;
+exports.bindKeyboardShortcuts = require_keyboard_shortcuts.bindKeyboardShortcuts;
+exports.bindUnsavedChangesWarning = require_unsaved_changes_warning.bindUnsavedChangesWarning;
+exports.createConflictError = require_errors.createConflictError;
 exports.createDocumentEngine = require_create_document_engine.createDocumentEngine;
 exports.isDocumentEngineError = require_errors.isDocumentEngineError;
 exports.validateDocument = require_validate_document.validateDocument;

package/dist/index.d.cts

@@ -1,8 +1,15 @@
 import { CURRENT_SCHEMA_VERSION, DocumentCanvas, DocumentInfo, FabricDocument, SerializedFabricObject } from "./document/document-format.cjs";
 import { NewDocumentOptions } from "./document/create-document.cjs";
 import { CustomObjectDefinition } from "./fabric/object-registry.cjs";
-import { DocumentEngineError, DocumentEngineErrorDetails, DocumentErrorCode, DocumentIssue, isDocumentEngineError } from "./engine/errors.cjs";
+import { HistoryOptions, HistoryState } from "./history/create-history.cjs";
+import { AutosaveOptions } from "./save/autosave-scheduler.cjs";
+import { RetryOptions } from "./save/retry.cjs";
+import { DocumentEngineError, DocumentEngineErrorDetails, DocumentErrorCode, DocumentIssue, createConflictError, isDocumentEngineError } from "./engine/errors.cjs";
+import { DocumentStorage, SaveContext, SaveResult } from "./storage/storage-contract.cjs";
+import { SaveOptions, SaveRetryEvent, SaveState, SaveStatus } from "./save/save-controller.cjs";
 import { Unsubscribe } from "./engine/event-emitter.cjs";
-import { DocumentEngine, DocumentEngineEvents, DocumentEngineOptions, DocumentStorage, LoadOptions, createDocumentEngine } from "./engine/create-document-engine.cjs";
+import { DocumentEngine, DocumentEngineEvents, DocumentEngineOptions, LoadOptions, createDocumentEngine } from "./engine/create-document-engine.cjs";
 import { validateDocument } from "./document/validate-document.cjs";
-export { CURRENT_SCHEMA_VERSION, type CustomObjectDefinition, type DocumentCanvas, type DocumentEngine, DocumentEngineError, type DocumentEngineErrorDetails, type DocumentEngineEvents, type DocumentEngineOptions, type DocumentErrorCode, type DocumentInfo, type DocumentIssue, type DocumentStorage, type FabricDocument, type LoadOptions, type NewDocumentOptions, type SerializedFabricObject, type Unsubscribe, createDocumentEngine, isDocumentEngineError, validateDocument };
+import { KeyboardShortcutOptions, UndoRedoTarget, bindKeyboardShortcuts } from "./history/keyboard-shortcuts.cjs";
+import { UnsavedChangesSource, bindUnsavedChangesWarning } from "./save/unsaved-changes-warning.cjs";
+export { type AutosaveOptions, CURRENT_SCHEMA_VERSION, type CustomObjectDefinition, type DocumentCanvas, type DocumentEngine, DocumentEngineError, type DocumentEngineErrorDetails, type DocumentEngineEvents, type DocumentEngineOptions, type DocumentErrorCode, type DocumentInfo, type DocumentIssue, type DocumentStorage, type FabricDocument, type HistoryOptions, type HistoryState, type KeyboardShortcutOptions, type LoadOptions, type NewDocumentOptions, type RetryOptions, type SaveContext, type SaveOptions, type SaveResult, type SaveRetryEvent, type SaveState, type SaveStatus, type SerializedFabricObject, type UndoRedoTarget, type UnsavedChangesSource, type Unsubscribe, bindKeyboardShortcuts, bindUnsavedChangesWarning, createConflictError, createDocumentEngine, isDocumentEngineError, validateDocument };

package/dist/index.d.ts

@@ -1,8 +1,15 @@
 import { CURRENT_SCHEMA_VERSION, DocumentCanvas, DocumentInfo, FabricDocument, SerializedFabricObject } from "./document/document-format.js";
 import { NewDocumentOptions } from "./document/create-document.js";
 import { CustomObjectDefinition } from "./fabric/object-registry.js";
-import { DocumentEngineError, DocumentEngineErrorDetails, DocumentErrorCode, DocumentIssue, isDocumentEngineError } from "./engine/errors.js";
+import { HistoryOptions, HistoryState } from "./history/create-history.js";
+import { AutosaveOptions } from "./save/autosave-scheduler.js";
+import { RetryOptions } from "./save/retry.js";
+import { DocumentEngineError, DocumentEngineErrorDetails, DocumentErrorCode, DocumentIssue, createConflictError, isDocumentEngineError } from "./engine/errors.js";
+import { DocumentStorage, SaveContext, SaveResult } from "./storage/storage-contract.js";
+import { SaveOptions, SaveRetryEvent, SaveState, SaveStatus } from "./save/save-controller.js";
 import { Unsubscribe } from "./engine/event-emitter.js";
-import { DocumentEngine, DocumentEngineEvents, DocumentEngineOptions, DocumentStorage, LoadOptions, createDocumentEngine } from "./engine/create-document-engine.js";
+import { DocumentEngine, DocumentEngineEvents, DocumentEngineOptions, LoadOptions, createDocumentEngine } from "./engine/create-document-engine.js";
 import { validateDocument } from "./document/validate-document.js";
-export { CURRENT_SCHEMA_VERSION, type CustomObjectDefinition, type DocumentCanvas, type DocumentEngine, DocumentEngineError, type DocumentEngineErrorDetails, type DocumentEngineEvents, type DocumentEngineOptions, type DocumentErrorCode, type DocumentInfo, type DocumentIssue, type DocumentStorage, type FabricDocument, type LoadOptions, type NewDocumentOptions, type SerializedFabricObject, type Unsubscribe, createDocumentEngine, isDocumentEngineError, validateDocument };
+import { KeyboardShortcutOptions, UndoRedoTarget, bindKeyboardShortcuts } from "./history/keyboard-shortcuts.js";
+import { UnsavedChangesSource, bindUnsavedChangesWarning } from "./save/unsaved-changes-warning.js";
+export { type AutosaveOptions, CURRENT_SCHEMA_VERSION, type CustomObjectDefinition, type DocumentCanvas, type DocumentEngine, DocumentEngineError, type DocumentEngineErrorDetails, type DocumentEngineEvents, type DocumentEngineOptions, type DocumentErrorCode, type DocumentInfo, type DocumentIssue, type DocumentStorage, type FabricDocument, type HistoryOptions, type HistoryState, type KeyboardShortcutOptions, type LoadOptions, type NewDocumentOptions, type RetryOptions, type SaveContext, type SaveOptions, type SaveResult, type SaveRetryEvent, type SaveState, type SaveStatus, type SerializedFabricObject, type UndoRedoTarget, type UnsavedChangesSource, type Unsubscribe, bindKeyboardShortcuts, bindUnsavedChangesWarning, createConflictError, createDocumentEngine, isDocumentEngineError, validateDocument };

package/dist/index.js

@@ -1,5 +1,7 @@
 import { CURRENT_SCHEMA_VERSION } from "./document/document-format.js";
 import { validateDocument } from "./document/validate-document.js";
-import { DocumentEngineError, isDocumentEngineError } from "./engine/errors.js";
+import { DocumentEngineError, createConflictError, isDocumentEngineError } from "./engine/errors.js";
 import { createDocumentEngine } from "./engine/create-document-engine.js";
-export { CURRENT_SCHEMA_VERSION, DocumentEngineError, createDocumentEngine, isDocumentEngineError, validateDocument };
+import { bindKeyboardShortcuts } from "./history/keyboard-shortcuts.js";
+import { bindUnsavedChangesWarning } from "./save/unsaved-changes-warning.js";
+export { CURRENT_SCHEMA_VERSION, DocumentEngineError, bindKeyboardShortcuts, bindUnsavedChangesWarning, createConflictError, createDocumentEngine, isDocumentEngineError, validateDocument };

package/dist/save/autosave-scheduler.cjs

@@ -0,0 +1,28 @@
+//#region src/save/autosave-scheduler.ts
+function createAutosaveScheduler(run, options = {}) {
+	const delay = options.delay ?? 1e3;
+	const maxWait = Math.max(delay, options.maxWait ?? 1e4);
+	let timer;
+	let firstRequestAt;
+	function cancel() {
+		if (timer !== void 0) clearTimeout(timer);
+		timer = void 0;
+		firstRequestAt = void 0;
+	}
+	function fire() {
+		cancel();
+		run();
+	}
+	return {
+		schedule() {
+			const now = Date.now();
+			firstRequestAt ?? (firstRequestAt = now);
+			const timeLeftBeforeMaxWait = maxWait - (now - firstRequestAt);
+			if (timer !== void 0) clearTimeout(timer);
+			timer = setTimeout(fire, Math.max(0, Math.min(delay, timeLeftBeforeMaxWait)));
+		},
+		cancel
+	};
+}
+//#endregion
+exports.createAutosaveScheduler = createAutosaveScheduler;

package/dist/save/autosave-scheduler.d.cts

@@ -0,0 +1,6 @@
+//#region src/save/autosave-scheduler.d.ts
+export interface AutosaveOptions {
+  delay?: number;
+  maxWait?: number;
+}
+//#endregion

package/dist/save/autosave-scheduler.d.ts

@@ -0,0 +1,6 @@
+//#region src/save/autosave-scheduler.d.ts
+export interface AutosaveOptions {
+  delay?: number;
+  maxWait?: number;
+}
+//#endregion

package/dist/save/autosave-scheduler.js

@@ -0,0 +1,28 @@
+//#region src/save/autosave-scheduler.ts
+function createAutosaveScheduler(run, options = {}) {
+	const delay = options.delay ?? 1e3;
+	const maxWait = Math.max(delay, options.maxWait ?? 1e4);
+	let timer;
+	let firstRequestAt;
+	function cancel() {
+		if (timer !== void 0) clearTimeout(timer);
+		timer = void 0;
+		firstRequestAt = void 0;
+	}
+	function fire() {
+		cancel();
+		run();
+	}
+	return {
+		schedule() {
+			const now = Date.now();
+			firstRequestAt ?? (firstRequestAt = now);
+			const timeLeftBeforeMaxWait = maxWait - (now - firstRequestAt);
+			if (timer !== void 0) clearTimeout(timer);
+			timer = setTimeout(fire, Math.max(0, Math.min(delay, timeLeftBeforeMaxWait)));
+		},
+		cancel
+	};
+}
+//#endregion
+export { createAutosaveScheduler };

package/dist/save/retry.cjs

@@ -0,0 +1,33 @@
+//#region src/save/retry.ts
+function isRetryable(error) {
+	const hints = error ?? {};
+	if (hints.code === "SAVE_CONFLICT" || hints.code === "SAVE_CANCELLED") return false;
+	return hints.retryable !== false;
+}
+function retryDelay(attempt, options = {}) {
+	const baseDelay = options.baseDelay ?? 500;
+	const maxDelay = options.maxDelay ?? 8e3;
+	const ceiling = Math.min(maxDelay, baseDelay * 2 ** attempt);
+	return ceiling / 2 + Math.random() * (ceiling / 2);
+}
+function wait(milliseconds, signal) {
+	return new Promise((resolve, reject) => {
+		if (signal.aborted) {
+			reject(/* @__PURE__ */ new Error("aborted"));
+			return;
+		}
+		const stop = () => {
+			clearTimeout(timer);
+			reject(/* @__PURE__ */ new Error("aborted"));
+		};
+		const timer = setTimeout(() => {
+			signal.removeEventListener("abort", stop);
+			resolve();
+		}, milliseconds);
+		signal.addEventListener("abort", stop, { once: true });
+	});
+}
+//#endregion
+exports.isRetryable = isRetryable;
+exports.retryDelay = retryDelay;
+exports.wait = wait;

package/dist/save/retry.d.cts

@@ -0,0 +1,7 @@
+//#region src/save/retry.d.ts
+export interface RetryOptions {
+  attempts?: number;
+  baseDelay?: number;
+  maxDelay?: number;
+}
+//#endregion

package/dist/save/retry.d.ts

@@ -0,0 +1,7 @@
+//#region src/save/retry.d.ts
+export interface RetryOptions {
+  attempts?: number;
+  baseDelay?: number;
+  maxDelay?: number;
+}
+//#endregion

package/dist/save/retry.js

@@ -0,0 +1,31 @@
+//#region src/save/retry.ts
+function isRetryable(error) {
+	const hints = error ?? {};
+	if (hints.code === "SAVE_CONFLICT" || hints.code === "SAVE_CANCELLED") return false;
+	return hints.retryable !== false;
+}
+function retryDelay(attempt, options = {}) {
+	const baseDelay = options.baseDelay ?? 500;
+	const maxDelay = options.maxDelay ?? 8e3;
+	const ceiling = Math.min(maxDelay, baseDelay * 2 ** attempt);
+	return ceiling / 2 + Math.random() * (ceiling / 2);
+}
+function wait(milliseconds, signal) {
+	return new Promise((resolve, reject) => {
+		if (signal.aborted) {
+			reject(/* @__PURE__ */ new Error("aborted"));
+			return;
+		}
+		const stop = () => {
+			clearTimeout(timer);
+			reject(/* @__PURE__ */ new Error("aborted"));
+		};
+		const timer = setTimeout(() => {
+			signal.removeEventListener("abort", stop);
+			resolve();
+		}, milliseconds);
+		signal.addEventListener("abort", stop, { once: true });
+	});
+}
+//#endregion
+export { isRetryable, retryDelay, wait };