fabricjs-document-engine 1.1.0 → 1.3.0

package/dist/performance/spatial-index.js

@@ -0,0 +1,78 @@
+//#region src/performance/spatial-index.ts
+const OFFSET = 1 << 20;
+const keyOf = (column, row) => (column + OFFSET) * 2 ** 21 + (row + OFFSET);
+function createSpatialIndex(options = {}) {
+	const cellSize = options.cellSize ?? 256;
+	const maxCells = options.maxCellsPerItem ?? 64;
+	const cells = /* @__PURE__ */ new Map();
+	const placed = /* @__PURE__ */ new Map();
+	const large = /* @__PURE__ */ new Set();
+	const span = (bounds) => [
+		Math.floor(bounds.left / cellSize),
+		Math.floor(bounds.top / cellSize),
+		Math.floor((bounds.left + Math.max(0, bounds.width)) / cellSize),
+		Math.floor((bounds.top + Math.max(0, bounds.height)) / cellSize)
+	];
+	function remove(item) {
+		const where = placed.get(item);
+		if (where === void 0) return false;
+		placed.delete(item);
+		if (where === "large") {
+			large.delete(item);
+			return true;
+		}
+		for (const key of where) {
+			const bucket = cells.get(key);
+			bucket.delete(item);
+			if (bucket.size === 0) cells.delete(key);
+		}
+		return true;
+	}
+	return {
+		set(item, bounds) {
+			remove(item);
+			const [left, top, right, bottom] = span(bounds);
+			const count = (right - left + 1) * (bottom - top + 1);
+			if (!Number.isFinite(count) || count > maxCells) {
+				large.add(item);
+				placed.set(item, "large");
+				return;
+			}
+			const keys = [];
+			for (let column = left; column <= right; column += 1) for (let row = top; row <= bottom; row += 1) {
+				const key = keyOf(column, row);
+				let bucket = cells.get(key);
+				if (!bucket) cells.set(key, bucket = /* @__PURE__ */ new Set());
+				bucket.add(item);
+				keys.push(key);
+			}
+			placed.set(item, keys);
+		},
+		delete: remove,
+		has: (item) => placed.has(item),
+		query(bounds) {
+			const found = new Set(large);
+			const [left, top, right, bottom] = span(bounds);
+			if ((right - left + 1) * (bottom - top + 1) > cells.size) {
+				for (const [key, bucket] of cells) {
+					const column = Math.floor(key / 2 ** 21) - OFFSET;
+					const row = key % 2 ** 21 - OFFSET;
+					if (column >= left && column <= right && row >= top && row <= bottom) bucket.forEach((item) => found.add(item));
+				}
+				return found;
+			}
+			for (let column = left; column <= right; column += 1) for (let row = top; row <= bottom; row += 1) cells.get(keyOf(column, row))?.forEach((item) => found.add(item));
+			return found;
+		},
+		clear() {
+			cells.clear();
+			placed.clear();
+			large.clear();
+		},
+		get size() {
+			return placed.size;
+		}
+	};
+}
+//#endregion
+export { createSpatialIndex };

package/dist/performance.cjs

@@ -0,0 +1,9 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_batch = require("./performance/batch.cjs");
+const require_spatial_index = require("./performance/spatial-index.cjs");
+const require_dirty_regions = require("./performance/dirty-regions.cjs");
+const require_monitor = require("./performance/monitor.cjs");
+exports.batchCanvasUpdates = require_batch.batchCanvasUpdates;
+exports.createPerformanceMonitor = require_monitor.createPerformanceMonitor;
+exports.createSpatialIndex = require_spatial_index.createSpatialIndex;
+exports.enableDirtyRegionRendering = require_dirty_regions.enableDirtyRegionRendering;

package/dist/performance.d.cts

@@ -0,0 +1,5 @@
+import { batchCanvasUpdates } from "./performance/batch.cjs";
+import { Rect, SpatialIndex, SpatialIndexOptions, createSpatialIndex } from "./performance/spatial-index.cjs";
+import { DirtyRegionOptions, DirtyRegionRenderer, DirtyRegionStats, enableDirtyRegionRendering } from "./performance/dirty-regions.cjs";
+import { FrameStats, PerformanceMonitor, PerformanceMonitorOptions, createPerformanceMonitor } from "./performance/monitor.cjs";
+export { type DirtyRegionOptions, type DirtyRegionRenderer, type DirtyRegionStats, type FrameStats, type PerformanceMonitor, type PerformanceMonitorOptions, type Rect, type SpatialIndex, type SpatialIndexOptions, batchCanvasUpdates, createPerformanceMonitor, createSpatialIndex, enableDirtyRegionRendering };

package/dist/performance.d.ts

@@ -0,0 +1,5 @@
+import { batchCanvasUpdates } from "./performance/batch.js";
+import { Rect, SpatialIndex, SpatialIndexOptions, createSpatialIndex } from "./performance/spatial-index.js";
+import { DirtyRegionOptions, DirtyRegionRenderer, DirtyRegionStats, enableDirtyRegionRendering } from "./performance/dirty-regions.js";
+import { FrameStats, PerformanceMonitor, PerformanceMonitorOptions, createPerformanceMonitor } from "./performance/monitor.js";
+export { type DirtyRegionOptions, type DirtyRegionRenderer, type DirtyRegionStats, type FrameStats, type PerformanceMonitor, type PerformanceMonitorOptions, type Rect, type SpatialIndex, type SpatialIndexOptions, batchCanvasUpdates, createPerformanceMonitor, createSpatialIndex, enableDirtyRegionRendering };

package/dist/performance.js

@@ -0,0 +1,5 @@
+import { batchCanvasUpdates } from "./performance/batch.js";
+import { createSpatialIndex } from "./performance/spatial-index.js";
+import { enableDirtyRegionRendering } from "./performance/dirty-regions.js";
+import { createPerformanceMonitor } from "./performance/monitor.js";
+export { batchCanvasUpdates, createPerformanceMonitor, createSpatialIndex, enableDirtyRegionRendering };

package/dist/recovery/recovery-controller.cjs

@@ -1,4 +1,5 @@
 const require_asset_pipeline = require("../assets/asset-pipeline.cjs");
+const require_ids = require("../document/ids.cjs");
 //#region src/recovery/recovery-controller.ts
 async function toStoredFiles(files) {
 	const entries = await Promise.all(Object.entries(files).map(async ([url, blob]) => [url, {
@@ -12,22 +13,55 @@ function fromStoredFiles(files) {
 	for (const [url, file] of Object.entries(files ?? {})) restored[url] = file instanceof Blob ? file : new Blob([file.bytes], { type: file.type });
 	return restored;
 }
-function fromStoredRecord(value) {
+function fromStoredRecord(value, sessionId, active) {
 	if (!isRecoveryRecord(value)) return void 0;
 	const stored = value;
 	return {
 		...stored,
+		sessionId,
+		active,
 		files: fromStoredFiles(stored.files)
 	};
 }
-const documentKeyPrefix = "document:";
-const unloadKeyPrefix = "unload:";
-const loadingKey = "loading";
-function documentKey(documentId) {
-	return `${documentKeyPrefix}${documentId}`;
+const LEGACY_SESSION = "legacy";
+const checkpointPrefix = "checkpoint:";
+const closingPrefix = "closing:";
+const loadingPrefix = "loading:";
+const legacyDocumentPrefix = "document:";
+const legacyUnloadPrefix = "unload:";
+const legacyLoadingKey = "loading";
+function branchKeys({ sessionId, documentId }) {
+	if (sessionId === LEGACY_SESSION) return {
+		checkpoint: `${legacyDocumentPrefix}${documentId}`,
+		closing: `${legacyUnloadPrefix}${documentId}`
+	};
+	const document = encodeURIComponent(documentId);
+	return {
+		checkpoint: `${checkpointPrefix}${sessionId}:${document}`,
+		closing: `${closingPrefix}${sessionId}:${document}`
+	};
+}
+/** The branch a key belongs to, or undefined for keys that are not copies. */
+function parseBranch(key) {
+	for (const prefix of [checkpointPrefix, closingPrefix]) {
+		if (!key.startsWith(prefix)) continue;
+		const rest = key.slice(prefix.length);
+		const separator = rest.indexOf(":");
+		if (separator <= 0) return void 0;
+		return {
+			sessionId: rest.slice(0, separator),
+			documentId: decodeURIComponent(rest.slice(separator + 1))
+		};
+	}
+	for (const prefix of [legacyDocumentPrefix, legacyUnloadPrefix]) if (key.startsWith(prefix)) return {
+		sessionId: LEGACY_SESSION,
+		documentId: key.slice(prefix.length)
+	};
 }
-function unloadKey(documentId) {
-	return `${unloadKeyPrefix}${documentId}`;
+const LOCK_PREFIX = "fabricjs-document-engine/recovery/";
+function lockManager() {
+	const locks = globalThis.navigator?.locks;
+	return typeof locks?.request === "function" && typeof locks.query === "function" ? locks : void 0;
 }
 function newerRecord(checkpoint, unloadCopy) {
 	if (!unloadCopy) return checkpoint;
@@ -58,6 +92,24 @@ async function restoreRecordedFiles(record) {
 }
 function createRecoveryController(options) {
 	const { store } = options;
+	const sessionId = require_ids.createId();
+	const own = (documentId) => ({
+		sessionId,
+		documentId
+	});
+	const adopted = /* @__PURE__ */ new Map();
+	const locks = lockManager();
+	let releaseLock;
+	locks?.request(`${LOCK_PREFIX}${sessionId}`, () => new Promise((resolve) => releaseLock = resolve)).catch(() => void 0);
+	async function liveSessions() {
+		const live = /* @__PURE__ */ new Set([sessionId]);
+		if (!locks) return live;
+		try {
+			const { held = [] } = await locks.query();
+			for (const lock of held) if (lock.name?.startsWith(LOCK_PREFIX)) live.add(lock.name.slice(34));
+		} catch {}
+		return live;
+	}
 	const interval = options.interval ?? 2e3;
 	const capturedFiles = /* @__PURE__ */ new Map();
 	const readyFiles = /* @__PURE__ */ new Map();
@@ -88,6 +140,8 @@ function createRecoveryController(options) {
 	function createRecord(document, files) {
 		return {
 			documentId: document.id,
+			sessionId,
+			active: true,
 			savedAt: (/* @__PURE__ */ new Date()).toISOString(),
 			baseRevision: document.revision ?? 0,
 			document,
@@ -99,7 +153,7 @@ function createRecoveryController(options) {
 		if (!options.shouldWrite()) return;
 		const document = options.createDocument();
 		const record = createRecord(document, await captureTabOnlyFiles(document));
-		await store.set(documentKey(document.id), {
+		await store.set(branchKeys(own(document.id)).checkpoint, {
 			...record,
 			files: await toStoredFiles(record.files)
 		});
@@ -109,20 +163,52 @@ function createRecoveryController(options) {
 		cancel();
 		if (!options.shouldWrite()) return;
 		const document = options.createDocument();
+		const keys = branchKeys(own(document.id));
 		if (store.setNow) {
-			store.setNow(unloadKey(document.id), createRecord(document, {}));
+			store.setNow(keys.closing, createRecord(document, {}));
 			return;
 		}
 		const record = createRecord(document, Object.fromEntries(readyFiles));
-		toStoredFiles(record.files).then((files) => store.set(documentKey(document.id), {
+		toStoredFiles(record.files).then((files) => store.set(keys.checkpoint, {
 			...record,
 			files
 		})).then(() => options.onCheckpoint(record), options.onError);
 	}
-	async function read(documentId) {
+	async function readBranch(branch, live) {
+		const keys = branchKeys(branch);
+		const [checkpoint, closing] = await Promise.all([store.get(keys.checkpoint), store.get(keys.closing)]);
+		const active = live.has(branch.sessionId);
+		return newerRecord(fromStoredRecord(checkpoint, branch.sessionId, active), fromStoredRecord(closing, branch.sessionId, active));
+	}
+	/** Every branch in the store, de-duplicated, in one pass over the keys. */
+	async function branches(documentId) {
+		const found = /* @__PURE__ */ new Map();
+		for (const key of await store.keys()) {
+			const branch = parseBranch(key);
+			if (!branch || documentId !== void 0 && branch.documentId !== documentId) continue;
+			found.set(`${branch.sessionId}\u0000${branch.documentId}`, branch);
+		}
+		return [...found.values()];
+	}
+	async function readAll(documentId) {
 		await queue;
-		const [checkpoint, unloadCopy] = await Promise.all([store.get(documentKey(documentId)), store.get(unloadKey(documentId))]);
-		return newerRecord(fromStoredRecord(checkpoint), fromStoredRecord(unloadCopy));
+		const live = await liveSessions();
+		return (await Promise.all((await branches(documentId)).map((branch) => readBranch(branch, live)))).filter((record) => record !== void 0).sort((first, second) => second.savedAt.localeCompare(first.savedAt));
+	}
+	async function read(documentId, branchSession) {
+		if (branchSession !== void 0) {
+			await queue;
+			return readBranch({
+				sessionId: branchSession,
+				documentId
+			}, await liveSessions());
+		}
+		return (await readAll(documentId))[0];
+	}
+	async function deleteBranch(branch) {
+		const keys = branchKeys(branch);
+		await store.delete(keys.closing);
+		await store.delete(keys.checkpoint);
 	}
 	function cancel() {
 		if (timer !== void 0) clearTimeout(timer);
@@ -151,31 +237,64 @@ function createRecoveryController(options) {
 		flush,
 		writeNow: writeCheckpointBeforeThePageCloses,
 		cancel,
+		sessionId,
 		remove: (documentId) => enqueue(async () => {
-			await store.delete(unloadKey(documentId));
-			await store.delete(documentKey(documentId));
+			await deleteBranch(own(documentId));
+			await deleteBranch({
+				sessionId: LEGACY_SESSION,
+				documentId
+			});
+			for (const other of adopted.get(documentId) ?? []) await deleteBranch({
+				sessionId: other,
+				documentId
+			});
+			adopted.delete(documentId);
 		}),
-		read,
-		async list() {
-			await queue;
-			const documentIds = /* @__PURE__ */ new Set();
-			for (const key of await store.keys()) {
-				if (key.startsWith(documentKeyPrefix)) documentIds.add(key.slice(9));
-				if (key.startsWith(unloadKeyPrefix)) documentIds.add(key.slice(7));
-			}
-			return (await Promise.all([...documentIds].map(read))).filter((record) => record !== void 0).sort((first, second) => second.savedAt.localeCompare(first.savedAt));
+		adopt(documentId, other) {
+			if (other === sessionId) return;
+			const sessions = adopted.get(documentId) ?? /* @__PURE__ */ new Set();
+			sessions.add(other);
+			adopted.set(documentId, sessions);
 		},
-		markLoadStarted: (documentId) => store.set(loadingKey, {
+		discard: (documentId, branchSession) => enqueue(async () => {
+			const targets = branchSession === void 0 ? await branches(documentId) : [{
+				sessionId: branchSession,
+				documentId
+			}];
+			for (const branch of targets) await deleteBranch(branch);
+		}),
+		read,
+		list: () => readAll(),
+		markLoadStarted: (documentId) => store.set(`${loadingPrefix}${sessionId}`, {
 			documentId,
 			startedAt: (/* @__PURE__ */ new Date()).toISOString()
 		}).catch(options.onError),
-		markLoadFinished: () => store.delete(loadingKey).catch(options.onError),
+		markLoadFinished: async () => {
+			try {
+				await store.delete(`${loadingPrefix}${sessionId}`);
+				const live = await liveSessions();
+				for (const key of await store.keys()) {
+					const markerSession = key === legacyLoadingKey ? LEGACY_SESSION : key.startsWith(loadingPrefix) ? key.slice(8) : void 0;
+					if (markerSession !== void 0 && !live.has(markerSession)) await store.delete(key);
+				}
+			} catch (error) {
+				options.onError(error);
+			}
+		},
 		async interruptedLoad() {
-			const marker = await store.get(loadingKey);
-			return marker && typeof marker.startedAt === "string" ? marker : void 0;
+			const live = await liveSessions();
+			let newest;
+			for (const key of await store.keys()) {
+				const markerSession = key === legacyLoadingKey ? LEGACY_SESSION : key.startsWith(loadingPrefix) ? key.slice(8) : void 0;
+				if (markerSession === void 0 || live.has(markerSession)) continue;
+				const marker = await store.get(key);
+				if (marker && typeof marker.startedAt === "string" && (!newest || marker.startedAt > newest.startedAt)) newest = marker;
+			}
+			return newest;
 		},
 		destroy() {
 			cancel();
+			releaseLock?.();
 			pageEvents?.removeEventListener("pagehide", handlePageHidden);
 			pageEvents?.document.removeEventListener("visibilitychange", handleVisibilityChange);
 		}

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

@@ -7,6 +7,14 @@ export interface RecoveryOptions {
 }
 export interface RecoveryRecord {
   documentId: string;
+  /**
+   * The editor session (one per engine, so one per tab) that wrote this copy.
+   * Two tabs editing the same document keep separate copies. `legacy` marks
+   * a copy written before 1.2.
+   */
+  sessionId: string;
+  /** True while the session that wrote the copy is still open in a tab, when the browser can tell. */
+  active: boolean;
   savedAt: string;
   baseRevision: number;
   document: FabricDocument;

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

@@ -7,6 +7,14 @@ export interface RecoveryOptions {
 }
 export interface RecoveryRecord {
   documentId: string;
+  /**
+   * The editor session (one per engine, so one per tab) that wrote this copy.
+   * Two tabs editing the same document keep separate copies. `legacy` marks
+   * a copy written before 1.2.
+   */
+  sessionId: string;
+  /** True while the session that wrote the copy is still open in a tab, when the browser can tell. */
+  active: boolean;
   savedAt: string;
   baseRevision: number;
   document: FabricDocument;

package/dist/recovery/recovery-controller.js

@@ -1,4 +1,5 @@
 import { rewriteUrls } from "../assets/asset-pipeline.js";
+import { createId } from "../document/ids.js";
 //#region src/recovery/recovery-controller.ts
 async function toStoredFiles(files) {
 	const entries = await Promise.all(Object.entries(files).map(async ([url, blob]) => [url, {
@@ -12,22 +13,55 @@ function fromStoredFiles(files) {
 	for (const [url, file] of Object.entries(files ?? {})) restored[url] = file instanceof Blob ? file : new Blob([file.bytes], { type: file.type });
 	return restored;
 }
-function fromStoredRecord(value) {
+function fromStoredRecord(value, sessionId, active) {
 	if (!isRecoveryRecord(value)) return void 0;
 	const stored = value;
 	return {
 		...stored,
+		sessionId,
+		active,
 		files: fromStoredFiles(stored.files)
 	};
 }
-const documentKeyPrefix = "document:";
-const unloadKeyPrefix = "unload:";
-const loadingKey = "loading";
-function documentKey(documentId) {
-	return `${documentKeyPrefix}${documentId}`;
+const LEGACY_SESSION = "legacy";
+const checkpointPrefix = "checkpoint:";
+const closingPrefix = "closing:";
+const loadingPrefix = "loading:";
+const legacyDocumentPrefix = "document:";
+const legacyUnloadPrefix = "unload:";
+const legacyLoadingKey = "loading";
+function branchKeys({ sessionId, documentId }) {
+	if (sessionId === LEGACY_SESSION) return {
+		checkpoint: `${legacyDocumentPrefix}${documentId}`,
+		closing: `${legacyUnloadPrefix}${documentId}`
+	};
+	const document = encodeURIComponent(documentId);
+	return {
+		checkpoint: `${checkpointPrefix}${sessionId}:${document}`,
+		closing: `${closingPrefix}${sessionId}:${document}`
+	};
+}
+/** The branch a key belongs to, or undefined for keys that are not copies. */
+function parseBranch(key) {
+	for (const prefix of [checkpointPrefix, closingPrefix]) {
+		if (!key.startsWith(prefix)) continue;
+		const rest = key.slice(prefix.length);
+		const separator = rest.indexOf(":");
+		if (separator <= 0) return void 0;
+		return {
+			sessionId: rest.slice(0, separator),
+			documentId: decodeURIComponent(rest.slice(separator + 1))
+		};
+	}
+	for (const prefix of [legacyDocumentPrefix, legacyUnloadPrefix]) if (key.startsWith(prefix)) return {
+		sessionId: LEGACY_SESSION,
+		documentId: key.slice(prefix.length)
+	};
 }
-function unloadKey(documentId) {
-	return `${unloadKeyPrefix}${documentId}`;
+const LOCK_PREFIX = "fabricjs-document-engine/recovery/";
+function lockManager() {
+	const locks = globalThis.navigator?.locks;
+	return typeof locks?.request === "function" && typeof locks.query === "function" ? locks : void 0;
 }
 function newerRecord(checkpoint, unloadCopy) {
 	if (!unloadCopy) return checkpoint;
@@ -58,6 +92,24 @@ async function restoreRecordedFiles(record) {
 }
 function createRecoveryController(options) {
 	const { store } = options;
+	const sessionId = createId();
+	const own = (documentId) => ({
+		sessionId,
+		documentId
+	});
+	const adopted = /* @__PURE__ */ new Map();
+	const locks = lockManager();
+	let releaseLock;
+	locks?.request(`${LOCK_PREFIX}${sessionId}`, () => new Promise((resolve) => releaseLock = resolve)).catch(() => void 0);
+	async function liveSessions() {
+		const live = /* @__PURE__ */ new Set([sessionId]);
+		if (!locks) return live;
+		try {
+			const { held = [] } = await locks.query();
+			for (const lock of held) if (lock.name?.startsWith(LOCK_PREFIX)) live.add(lock.name.slice(34));
+		} catch {}
+		return live;
+	}
 	const interval = options.interval ?? 2e3;
 	const capturedFiles = /* @__PURE__ */ new Map();
 	const readyFiles = /* @__PURE__ */ new Map();
@@ -88,6 +140,8 @@ function createRecoveryController(options) {
 	function createRecord(document, files) {
 		return {
 			documentId: document.id,
+			sessionId,
+			active: true,
 			savedAt: (/* @__PURE__ */ new Date()).toISOString(),
 			baseRevision: document.revision ?? 0,
 			document,
@@ -99,7 +153,7 @@ function createRecoveryController(options) {
 		if (!options.shouldWrite()) return;
 		const document = options.createDocument();
 		const record = createRecord(document, await captureTabOnlyFiles(document));
-		await store.set(documentKey(document.id), {
+		await store.set(branchKeys(own(document.id)).checkpoint, {
 			...record,
 			files: await toStoredFiles(record.files)
 		});
@@ -109,20 +163,52 @@ function createRecoveryController(options) {
 		cancel();
 		if (!options.shouldWrite()) return;
 		const document = options.createDocument();
+		const keys = branchKeys(own(document.id));
 		if (store.setNow) {
-			store.setNow(unloadKey(document.id), createRecord(document, {}));
+			store.setNow(keys.closing, createRecord(document, {}));
 			return;
 		}
 		const record = createRecord(document, Object.fromEntries(readyFiles));
-		toStoredFiles(record.files).then((files) => store.set(documentKey(document.id), {
+		toStoredFiles(record.files).then((files) => store.set(keys.checkpoint, {
 			...record,
 			files
 		})).then(() => options.onCheckpoint(record), options.onError);
 	}
-	async function read(documentId) {
+	async function readBranch(branch, live) {
+		const keys = branchKeys(branch);
+		const [checkpoint, closing] = await Promise.all([store.get(keys.checkpoint), store.get(keys.closing)]);
+		const active = live.has(branch.sessionId);
+		return newerRecord(fromStoredRecord(checkpoint, branch.sessionId, active), fromStoredRecord(closing, branch.sessionId, active));
+	}
+	/** Every branch in the store, de-duplicated, in one pass over the keys. */
+	async function branches(documentId) {
+		const found = /* @__PURE__ */ new Map();
+		for (const key of await store.keys()) {
+			const branch = parseBranch(key);
+			if (!branch || documentId !== void 0 && branch.documentId !== documentId) continue;
+			found.set(`${branch.sessionId}\u0000${branch.documentId}`, branch);
+		}
+		return [...found.values()];
+	}
+	async function readAll(documentId) {
 		await queue;
-		const [checkpoint, unloadCopy] = await Promise.all([store.get(documentKey(documentId)), store.get(unloadKey(documentId))]);
-		return newerRecord(fromStoredRecord(checkpoint), fromStoredRecord(unloadCopy));
+		const live = await liveSessions();
+		return (await Promise.all((await branches(documentId)).map((branch) => readBranch(branch, live)))).filter((record) => record !== void 0).sort((first, second) => second.savedAt.localeCompare(first.savedAt));
+	}
+	async function read(documentId, branchSession) {
+		if (branchSession !== void 0) {
+			await queue;
+			return readBranch({
+				sessionId: branchSession,
+				documentId
+			}, await liveSessions());
+		}
+		return (await readAll(documentId))[0];
+	}
+	async function deleteBranch(branch) {
+		const keys = branchKeys(branch);
+		await store.delete(keys.closing);
+		await store.delete(keys.checkpoint);
 	}
 	function cancel() {
 		if (timer !== void 0) clearTimeout(timer);
@@ -151,31 +237,64 @@ function createRecoveryController(options) {
 		flush,
 		writeNow: writeCheckpointBeforeThePageCloses,
 		cancel,
+		sessionId,
 		remove: (documentId) => enqueue(async () => {
-			await store.delete(unloadKey(documentId));
-			await store.delete(documentKey(documentId));
+			await deleteBranch(own(documentId));
+			await deleteBranch({
+				sessionId: LEGACY_SESSION,
+				documentId
+			});
+			for (const other of adopted.get(documentId) ?? []) await deleteBranch({
+				sessionId: other,
+				documentId
+			});
+			adopted.delete(documentId);
 		}),
-		read,
-		async list() {
-			await queue;
-			const documentIds = /* @__PURE__ */ new Set();
-			for (const key of await store.keys()) {
-				if (key.startsWith(documentKeyPrefix)) documentIds.add(key.slice(9));
-				if (key.startsWith(unloadKeyPrefix)) documentIds.add(key.slice(7));
-			}
-			return (await Promise.all([...documentIds].map(read))).filter((record) => record !== void 0).sort((first, second) => second.savedAt.localeCompare(first.savedAt));
+		adopt(documentId, other) {
+			if (other === sessionId) return;
+			const sessions = adopted.get(documentId) ?? /* @__PURE__ */ new Set();
+			sessions.add(other);
+			adopted.set(documentId, sessions);
 		},
-		markLoadStarted: (documentId) => store.set(loadingKey, {
+		discard: (documentId, branchSession) => enqueue(async () => {
+			const targets = branchSession === void 0 ? await branches(documentId) : [{
+				sessionId: branchSession,
+				documentId
+			}];
+			for (const branch of targets) await deleteBranch(branch);
+		}),
+		read,
+		list: () => readAll(),
+		markLoadStarted: (documentId) => store.set(`${loadingPrefix}${sessionId}`, {
 			documentId,
 			startedAt: (/* @__PURE__ */ new Date()).toISOString()
 		}).catch(options.onError),
-		markLoadFinished: () => store.delete(loadingKey).catch(options.onError),
+		markLoadFinished: async () => {
+			try {
+				await store.delete(`${loadingPrefix}${sessionId}`);
+				const live = await liveSessions();
+				for (const key of await store.keys()) {
+					const markerSession = key === legacyLoadingKey ? LEGACY_SESSION : key.startsWith(loadingPrefix) ? key.slice(8) : void 0;
+					if (markerSession !== void 0 && !live.has(markerSession)) await store.delete(key);
+				}
+			} catch (error) {
+				options.onError(error);
+			}
+		},
 		async interruptedLoad() {
-			const marker = await store.get(loadingKey);
-			return marker && typeof marker.startedAt === "string" ? marker : void 0;
+			const live = await liveSessions();
+			let newest;
+			for (const key of await store.keys()) {
+				const markerSession = key === legacyLoadingKey ? LEGACY_SESSION : key.startsWith(loadingPrefix) ? key.slice(8) : void 0;
+				if (markerSession === void 0 || live.has(markerSession)) continue;
+				const marker = await store.get(key);
+				if (marker && typeof marker.startedAt === "string" && (!newest || marker.startedAt > newest.startedAt)) newest = marker;
+			}
+			return newest;
 		},
 		destroy() {
 			cancel();
+			releaseLock?.();
 			pageEvents?.removeEventListener("pagehide", handlePageHidden);
 			pageEvents?.document.removeEventListener("visibilitychange", handleVisibilityChange);
 		}