fabricjs-document-engine 0.1.0 → 0.3.0

package/dist/history/create-history.cjs

@@ -24,7 +24,7 @@ function describePendingChanges(changes) {
 	return changes.length === 1 ? `${verb} ${changes[0].noun}` : `${verb} ${changes.length} objects`;
 }
 function createHistory(options) {
-	const { canvas, serializeObjects, onChange } = options;
+	const { canvas, serializeObjects, onChange, onContentChange } = options;
 	const stack = require_history_stack.createHistoryStack(Math.max(1, options.limit ?? 100));
 	let snapshot = require_snapshot.createSnapshot(serializeObjects());
 	let pendingChanges = [];
@@ -53,6 +53,7 @@ function createHistory(options) {
 			label,
 			...difference
 		});
+		onContentChange();
 		onChange(state());
 		return true;
 	}
@@ -155,6 +156,7 @@ function createHistory(options) {
 			}
 			snapshot = require_snapshot.createSnapshot(serializeObjects());
 			moveTo(step);
+			onContentChange();
 			onChange(state());
 			return true;
 		});

package/dist/history/create-history.js

@@ -24,7 +24,7 @@ function describePendingChanges(changes) {
 	return changes.length === 1 ? `${verb} ${changes[0].noun}` : `${verb} ${changes.length} objects`;
 }
 function createHistory(options) {
-	const { canvas, serializeObjects, onChange } = options;
+	const { canvas, serializeObjects, onChange, onContentChange } = options;
 	const stack = createHistoryStack(Math.max(1, options.limit ?? 100));
 	let snapshot = createSnapshot(serializeObjects());
 	let pendingChanges = [];
@@ -53,6 +53,7 @@ function createHistory(options) {
 			label,
 			...difference
 		});
+		onContentChange();
 		onChange(state());
 		return true;
 	}
@@ -155,6 +156,7 @@ function createHistory(options) {
 			}
 			snapshot = createSnapshot(serializeObjects());
 			moveTo(step);
+			onContentChange();
 			onChange(state());
 			return true;
 		});

package/dist/index.cjs

@@ -1,12 +1,15 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_errors = require("./engine/errors.cjs");
 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,10 +1,18 @@
 import { CURRENT_SCHEMA_VERSION, DocumentCanvas, DocumentInfo, FabricDocument, SerializedFabricObject } from "./document/document-format.cjs";
+import { AssetManifest, FontAsset, ImageAsset } from "./assets/asset-manifest.cjs";
+import { FontLoader } from "./assets/font-check.cjs";
+import { AssetOptions, AssetReport, AssetWarning, AssetWarningCode, UploadRequest } from "./assets/asset-pipeline.cjs";
 import { NewDocumentOptions } from "./document/create-document.cjs";
 import { CustomObjectDefinition } from "./fabric/object-registry.cjs";
 import { HistoryOptions, HistoryState } from "./history/create-history.cjs";
-import { DocumentEngineError, DocumentEngineErrorDetails, DocumentErrorCode, DocumentIssue, isDocumentEngineError } from "./engine/errors.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";
 import { KeyboardShortcutOptions, UndoRedoTarget, bindKeyboardShortcuts } from "./history/keyboard-shortcuts.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 HistoryOptions, type HistoryState, type KeyboardShortcutOptions, type LoadOptions, type NewDocumentOptions, type SerializedFabricObject, type UndoRedoTarget, type Unsubscribe, bindKeyboardShortcuts, createDocumentEngine, isDocumentEngineError, validateDocument };
+import { UnsavedChangesSource, bindUnsavedChangesWarning } from "./save/unsaved-changes-warning.cjs";
+export { type AssetManifest, type AssetOptions, type AssetReport, type AssetWarning, type AssetWarningCode, 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 FontAsset, type FontLoader, type HistoryOptions, type HistoryState, type ImageAsset, 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, type UploadRequest, bindKeyboardShortcuts, bindUnsavedChangesWarning, createConflictError, createDocumentEngine, isDocumentEngineError, validateDocument };

package/dist/index.d.ts

@@ -1,10 +1,18 @@
 import { CURRENT_SCHEMA_VERSION, DocumentCanvas, DocumentInfo, FabricDocument, SerializedFabricObject } from "./document/document-format.js";
+import { AssetManifest, FontAsset, ImageAsset } from "./assets/asset-manifest.js";
+import { FontLoader } from "./assets/font-check.js";
+import { AssetOptions, AssetReport, AssetWarning, AssetWarningCode, UploadRequest } from "./assets/asset-pipeline.js";
 import { NewDocumentOptions } from "./document/create-document.js";
 import { CustomObjectDefinition } from "./fabric/object-registry.js";
 import { HistoryOptions, HistoryState } from "./history/create-history.js";
-import { DocumentEngineError, DocumentEngineErrorDetails, DocumentErrorCode, DocumentIssue, isDocumentEngineError } from "./engine/errors.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";
 import { KeyboardShortcutOptions, UndoRedoTarget, bindKeyboardShortcuts } from "./history/keyboard-shortcuts.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 HistoryOptions, type HistoryState, type KeyboardShortcutOptions, type LoadOptions, type NewDocumentOptions, type SerializedFabricObject, type UndoRedoTarget, type Unsubscribe, bindKeyboardShortcuts, createDocumentEngine, isDocumentEngineError, validateDocument };
+import { UnsavedChangesSource, bindUnsavedChangesWarning } from "./save/unsaved-changes-warning.js";
+export { type AssetManifest, type AssetOptions, type AssetReport, type AssetWarning, type AssetWarningCode, 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 FontAsset, type FontLoader, type HistoryOptions, type HistoryState, type ImageAsset, 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, type UploadRequest, bindKeyboardShortcuts, bindUnsavedChangesWarning, createConflictError, createDocumentEngine, isDocumentEngineError, validateDocument };

package/dist/index.js

@@ -1,6 +1,7 @@
+import { DocumentEngineError, createConflictError, isDocumentEngineError } from "./engine/errors.js";
 import { CURRENT_SCHEMA_VERSION } from "./document/document-format.js";
 import { validateDocument } from "./document/validate-document.js";
-import { DocumentEngineError, isDocumentEngineError } from "./engine/errors.js";
 import { createDocumentEngine } from "./engine/create-document-engine.js";
 import { bindKeyboardShortcuts } from "./history/keyboard-shortcuts.js";
-export { CURRENT_SCHEMA_VERSION, DocumentEngineError, bindKeyboardShortcuts, createDocumentEngine, isDocumentEngineError, validateDocument };
+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 };

package/dist/save/save-controller.cjs

@@ -0,0 +1,149 @@
+const require_errors = require("../engine/errors.cjs");
+const require_autosave_scheduler = require("./autosave-scheduler.cjs");
+const require_retry = require("./retry.cjs");
+//#region src/save/save-controller.ts
+function cancelledError() {
+	return new require_errors.DocumentEngineError("SAVE_CANCELLED", "The save was cancelled because another document was opened");
+}
+function toSaveError(error, signal) {
+	if (require_errors.isDocumentEngineError(error)) return error;
+	if (signal.aborted) return cancelledError();
+	const hints = error ?? {};
+	const reason = typeof hints.message === "string" ? hints.message : String(error);
+	if (hints.code === "SAVE_CONFLICT") return new require_errors.DocumentEngineError("SAVE_CONFLICT", reason, { cause: error });
+	return new require_errors.DocumentEngineError("SAVE_FAILED", `Storage could not save the document: ${reason}`, {
+		cause: error,
+		retryable: require_retry.isRetryable(error)
+	});
+}
+function createSaveController(options) {
+	const attempts = Math.max(0, options.retry?.attempts ?? 3);
+	let contentVersion = 0;
+	let savedVersion = 0;
+	let revision = 0;
+	let lastSavedAt;
+	let lastError;
+	let saving = false;
+	let session = 0;
+	let sessionAbort = new AbortController();
+	let inFlight = null;
+	let queued = null;
+	const isDirty = () => contentVersion !== savedVersion;
+	function state() {
+		let status = isDirty() ? "unsaved" : "saved";
+		if (lastError) status = lastError.code === "SAVE_CONFLICT" ? "conflict" : "error";
+		if (saving) status = "saving";
+		return {
+			status,
+			isDirty: isDirty(),
+			isSaving: saving,
+			revision,
+			lastSavedAt,
+			error: lastError
+		};
+	}
+	const publish = () => options.onStateChange(state());
+	const autosave = options.autosave === false || options.autosave === void 0 ? null : require_autosave_scheduler.createAutosaveScheduler(() => {
+		if (isDirty()) save().catch(() => void 0);
+	}, options.autosave);
+	async function sendWithRetries(storage, document, expectedRevision, signal) {
+		for (let attempt = 0;; attempt += 1) try {
+			return await storage.saveDocument(document, {
+				expectedRevision,
+				signal
+			});
+		} catch (error) {
+			if (signal.aborted || !require_retry.isRetryable(error) || attempt >= attempts) throw error;
+			const delay = require_retry.retryDelay(attempt, options.retry);
+			options.onRetry({
+				attempt: attempt + 1,
+				delay,
+				error
+			});
+			await require_retry.wait(delay, signal);
+		}
+	}
+	async function runSave(saveOptions) {
+		const storage = options.getStorage();
+		const sessionAtStart = session;
+		const { signal } = sessionAbort;
+		const versionAtSnapshot = contentVersion;
+		const expectedRevision = saveOptions.overwrite === true ? null : revision;
+		const creating = options.createDocument();
+		saving = true;
+		lastError = void 0;
+		publish();
+		try {
+			const document = {
+				...await creating,
+				revision: revision + 1
+			};
+			options.onStart(document);
+			const result = await sendWithRetries(storage, document, expectedRevision, signal);
+			if (sessionAtStart !== session) return document;
+			revision = result?.revision ?? document.revision;
+			document.revision = revision;
+			savedVersion = versionAtSnapshot;
+			lastSavedAt = (/* @__PURE__ */ new Date()).toISOString();
+			options.onSuccess(document);
+			return document;
+		} catch (error) {
+			const saveError = toSaveError(error, signal);
+			if (sessionAtStart === session) {
+				lastError = saveError;
+				options.onError(saveError);
+			}
+			throw saveError;
+		} finally {
+			if (sessionAtStart === session) {
+				saving = false;
+				publish();
+			}
+		}
+	}
+	function save(saveOptions = {}) {
+		if (inFlight === null) {
+			inFlight = runSave(saveOptions).finally(() => {
+				inFlight = null;
+			});
+			return inFlight;
+		}
+		if (queued === null) {
+			const sessionWhenQueued = session;
+			queued = inFlight.catch(() => void 0).then(() => {
+				queued = null;
+				if (sessionWhenQueued !== session) throw cancelledError();
+				return save(saveOptions);
+			});
+		}
+		return queued;
+	}
+	return {
+		save,
+		noteContentChange() {
+			contentVersion += 1;
+			autosave?.schedule();
+			publish();
+		},
+		startSession(newRevision) {
+			session += 1;
+			sessionAbort.abort();
+			sessionAbort = new AbortController();
+			autosave?.cancel();
+			saving = false;
+			savedVersion = contentVersion;
+			revision = newRevision;
+			lastSavedAt = void 0;
+			lastError = void 0;
+			publish();
+		},
+		state,
+		destroy() {
+			session += 1;
+			sessionAbort.abort();
+			autosave?.cancel();
+		}
+	};
+}
+//#endregion
+exports.createSaveController = createSaveController;

package/dist/save/save-controller.d.cts

@@ -0,0 +1,20 @@
+import { DocumentEngineError } from "../engine/errors.cjs";
+//#region src/save/save-controller.d.ts
+export type SaveStatus = "saved" | "unsaved" | "saving" | "error" | "conflict";
+export interface SaveState {
+  status: SaveStatus;
+  isDirty: boolean;
+  isSaving: boolean;
+  revision: number;
+  lastSavedAt: string | undefined;
+  error: DocumentEngineError | undefined;
+}
+export interface SaveOptions {
+  overwrite?: boolean;
+}
+export interface SaveRetryEvent {
+  attempt: number;
+  delay: number;
+  error: unknown;
+}
+//#endregion

package/dist/save/save-controller.d.ts

@@ -0,0 +1,20 @@
+import { DocumentEngineError } from "../engine/errors.js";
+//#region src/save/save-controller.d.ts
+export type SaveStatus = "saved" | "unsaved" | "saving" | "error" | "conflict";
+export interface SaveState {
+  status: SaveStatus;
+  isDirty: boolean;
+  isSaving: boolean;
+  revision: number;
+  lastSavedAt: string | undefined;
+  error: DocumentEngineError | undefined;
+}
+export interface SaveOptions {
+  overwrite?: boolean;
+}
+export interface SaveRetryEvent {
+  attempt: number;
+  delay: number;
+  error: unknown;
+}
+//#endregion

package/dist/save/save-controller.js

@@ -0,0 +1,149 @@
+import { DocumentEngineError, isDocumentEngineError } from "../engine/errors.js";
+import { createAutosaveScheduler } from "./autosave-scheduler.js";
+import { isRetryable, retryDelay, wait } from "./retry.js";
+//#region src/save/save-controller.ts
+function cancelledError() {
+	return new DocumentEngineError("SAVE_CANCELLED", "The save was cancelled because another document was opened");
+}
+function toSaveError(error, signal) {
+	if (isDocumentEngineError(error)) return error;
+	if (signal.aborted) return cancelledError();
+	const hints = error ?? {};
+	const reason = typeof hints.message === "string" ? hints.message : String(error);
+	if (hints.code === "SAVE_CONFLICT") return new DocumentEngineError("SAVE_CONFLICT", reason, { cause: error });
+	return new DocumentEngineError("SAVE_FAILED", `Storage could not save the document: ${reason}`, {
+		cause: error,
+		retryable: isRetryable(error)
+	});
+}
+function createSaveController(options) {
+	const attempts = Math.max(0, options.retry?.attempts ?? 3);
+	let contentVersion = 0;
+	let savedVersion = 0;
+	let revision = 0;
+	let lastSavedAt;
+	let lastError;
+	let saving = false;
+	let session = 0;
+	let sessionAbort = new AbortController();
+	let inFlight = null;
+	let queued = null;
+	const isDirty = () => contentVersion !== savedVersion;
+	function state() {
+		let status = isDirty() ? "unsaved" : "saved";
+		if (lastError) status = lastError.code === "SAVE_CONFLICT" ? "conflict" : "error";
+		if (saving) status = "saving";
+		return {
+			status,
+			isDirty: isDirty(),
+			isSaving: saving,
+			revision,
+			lastSavedAt,
+			error: lastError
+		};
+	}
+	const publish = () => options.onStateChange(state());
+	const autosave = options.autosave === false || options.autosave === void 0 ? null : createAutosaveScheduler(() => {
+		if (isDirty()) save().catch(() => void 0);
+	}, options.autosave);
+	async function sendWithRetries(storage, document, expectedRevision, signal) {
+		for (let attempt = 0;; attempt += 1) try {
+			return await storage.saveDocument(document, {
+				expectedRevision,
+				signal
+			});
+		} catch (error) {
+			if (signal.aborted || !isRetryable(error) || attempt >= attempts) throw error;
+			const delay = retryDelay(attempt, options.retry);
+			options.onRetry({
+				attempt: attempt + 1,
+				delay,
+				error
+			});
+			await wait(delay, signal);
+		}
+	}
+	async function runSave(saveOptions) {
+		const storage = options.getStorage();
+		const sessionAtStart = session;
+		const { signal } = sessionAbort;
+		const versionAtSnapshot = contentVersion;
+		const expectedRevision = saveOptions.overwrite === true ? null : revision;
+		const creating = options.createDocument();
+		saving = true;
+		lastError = void 0;
+		publish();
+		try {
+			const document = {
+				...await creating,
+				revision: revision + 1
+			};
+			options.onStart(document);
+			const result = await sendWithRetries(storage, document, expectedRevision, signal);
+			if (sessionAtStart !== session) return document;
+			revision = result?.revision ?? document.revision;
+			document.revision = revision;
+			savedVersion = versionAtSnapshot;
+			lastSavedAt = (/* @__PURE__ */ new Date()).toISOString();
+			options.onSuccess(document);
+			return document;
+		} catch (error) {
+			const saveError = toSaveError(error, signal);
+			if (sessionAtStart === session) {
+				lastError = saveError;
+				options.onError(saveError);
+			}
+			throw saveError;
+		} finally {
+			if (sessionAtStart === session) {
+				saving = false;
+				publish();
+			}
+		}
+	}
+	function save(saveOptions = {}) {
+		if (inFlight === null) {
+			inFlight = runSave(saveOptions).finally(() => {
+				inFlight = null;
+			});
+			return inFlight;
+		}
+		if (queued === null) {
+			const sessionWhenQueued = session;
+			queued = inFlight.catch(() => void 0).then(() => {
+				queued = null;
+				if (sessionWhenQueued !== session) throw cancelledError();
+				return save(saveOptions);
+			});
+		}
+		return queued;
+	}
+	return {
+		save,
+		noteContentChange() {
+			contentVersion += 1;
+			autosave?.schedule();
+			publish();
+		},
+		startSession(newRevision) {
+			session += 1;
+			sessionAbort.abort();
+			sessionAbort = new AbortController();
+			autosave?.cancel();
+			saving = false;
+			savedVersion = contentVersion;
+			revision = newRevision;
+			lastSavedAt = void 0;
+			lastError = void 0;
+			publish();
+		},
+		state,
+		destroy() {
+			session += 1;
+			sessionAbort.abort();
+			autosave?.cancel();
+		}
+	};
+}
+//#endregion
+export { createSaveController };

package/dist/save/unsaved-changes-warning.cjs

@@ -0,0 +1,12 @@
+//#region src/save/unsaved-changes-warning.ts
+function bindUnsavedChangesWarning(engine, target = globalThis.window) {
+	const handleBeforeUnload = (event) => {
+		if (!engine.isDirty()) return;
+		event.preventDefault();
+		event.returnValue = "";
+	};
+	target.addEventListener("beforeunload", handleBeforeUnload);
+	return () => target.removeEventListener("beforeunload", handleBeforeUnload);
+}
+//#endregion
+exports.bindUnsavedChangesWarning = bindUnsavedChangesWarning;

package/dist/save/unsaved-changes-warning.d.cts

@@ -0,0 +1,6 @@
+//#region src/save/unsaved-changes-warning.d.ts
+export interface UnsavedChangesSource {
+  isDirty(): boolean;
+}
+export declare function bindUnsavedChangesWarning(engine: UnsavedChangesSource, target?: EventTarget): () => void;
+//#endregion

package/dist/save/unsaved-changes-warning.d.ts

@@ -0,0 +1,6 @@
+//#region src/save/unsaved-changes-warning.d.ts
+export interface UnsavedChangesSource {
+  isDirty(): boolean;
+}
+export declare function bindUnsavedChangesWarning(engine: UnsavedChangesSource, target?: EventTarget): () => void;
+//#endregion

package/dist/save/unsaved-changes-warning.js

@@ -0,0 +1,12 @@
+//#region src/save/unsaved-changes-warning.ts
+function bindUnsavedChangesWarning(engine, target = globalThis.window) {
+	const handleBeforeUnload = (event) => {
+		if (!engine.isDirty()) return;
+		event.preventDefault();
+		event.returnValue = "";
+	};
+	target.addEventListener("beforeunload", handleBeforeUnload);
+	return () => target.removeEventListener("beforeunload", handleBeforeUnload);
+}
+//#endregion
+export { bindUnsavedChangesWarning };