fabricjs-document-engine 0.3.0 → 0.5.0

package/dist/export/preflight-export.cjs

@@ -0,0 +1,105 @@
+const require_font_check = require("../assets/font-check.cjs");
+const require_image_check = require("../assets/image-check.cjs");
+const require_export_options = require("./export-options.cjs");
+const require_object_ids = require("../fabric/object-ids.cjs");
+const require_walk_objects = require("../fabric/walk-objects.cjs");
+//#region src/export/preflight-export.ts
+function imageElementsOf(object) {
+	const elements = [];
+	const withElement = object;
+	if (typeof withElement.getElement === "function") elements.push(withElement.getElement());
+	for (const paint of [object.fill, object.stroke]) {
+		const source = paint?.source;
+		if (source !== void 0) elements.push(source);
+	}
+	return elements.filter((element) => typeof HTMLImageElement !== "undefined" && element instanceof HTMLImageElement);
+}
+function collectImageUses(objects) {
+	const uses = /* @__PURE__ */ new Map();
+	const pending = objects.map((object) => ({
+		object,
+		ownerId: require_object_ids.readObjectId(object)
+	}));
+	while (pending.length > 0) {
+		const { object, ownerId } = pending.pop();
+		const id = require_object_ids.readObjectId(object) ?? ownerId;
+		for (const element of imageElementsOf(object)) {
+			const url = element.currentSrc || element.src;
+			const use = uses.get(url) ?? {
+				element,
+				objectIds: /* @__PURE__ */ new Set()
+			};
+			if (id !== void 0) use.objectIds.add(id);
+			uses.set(url, use);
+		}
+		require_walk_objects.childrenOf(object).forEach((child) => pending.push({
+			object: child,
+			ownerId: id
+		}));
+		if (object.clipPath) pending.push({
+			object: object.clipPath,
+			ownerId: id
+		});
+	}
+	return uses;
+}
+function isBroken(element) {
+	return element.complete && element.naturalWidth === 0;
+}
+function shortUrl(url) {
+	return url.length > 80 ? `${url.slice(0, 77)}...` : url;
+}
+async function preflightExport(canvas, format, fonts, assetOptions) {
+	const problems = [];
+	const warnings = [];
+	if (format === "json") return {
+		ok: true,
+		problems,
+		warnings
+	};
+	for (const [url, use] of collectImageUses(canvas.getObjects())) {
+		const objectIds = [...use.objectIds];
+		if (isBroken(use.element)) problems.push({
+			code: "MISSING_IMAGE",
+			message: `The image ${shortUrl(url)} did not load`,
+			url,
+			objectIds
+		});
+		else if (require_export_options.isRasterFormat(format) && require_image_check.isCrossOriginUrl(url) && !use.element.crossOrigin) problems.push({
+			code: "CROSS_ORIGIN_IMAGE",
+			message: `The image ${shortUrl(url)} comes from another site without crossOrigin, so the browser blocks exporting it. Load it with crossOrigin: 'anonymous' from a server that allows CORS.`,
+			url,
+			objectIds
+		});
+		else if (format === "svg" && !require_image_check.isPortableUrl(url)) warnings.push({
+			code: "ASSET_NOT_PORTABLE",
+			message: `The SVG links to ${shortUrl(url)}, which only exists in this tab`,
+			url,
+			objectIds
+		});
+	}
+	const fontSet = typeof document === "undefined" ? void 0 : document.fonts;
+	if (fontSet) await fontSet.ready;
+	for (const font of await require_font_check.findUnavailableFonts(fonts, assetOptions.loadFont)) {
+		const message = `The font "${font.family}" (${font.weight}, ${font.style}) is not available`;
+		if (assetOptions.requireFonts) problems.push({
+			code: "MISSING_FONT",
+			message,
+			family: font.family,
+			objectIds: font.objectIds
+		});
+		else warnings.push({
+			code: "FONT_UNAVAILABLE",
+			message: `${message}, text will use a fallback font`,
+			family: font.family,
+			objectIds: font.objectIds
+		});
+	}
+	return {
+		ok: problems.length === 0,
+		problems,
+		warnings
+	};
+}
+//#endregion
+exports.preflightExport = preflightExport;

package/dist/export/preflight-export.d.cts

@@ -0,0 +1,17 @@
+import { AssetWarning } from "../assets/asset-pipeline.cjs";
+import { StaticCanvas } from "fabric";
+//#region src/export/preflight-export.d.ts
+export type ExportProblemCode = "MISSING_IMAGE" | "CROSS_ORIGIN_IMAGE" | "MISSING_FONT";
+export interface ExportProblem {
+  code: ExportProblemCode;
+  message: string;
+  url?: string;
+  family?: string;
+  objectIds: string[];
+}
+export interface ExportPreflight {
+  ok: boolean;
+  problems: ExportProblem[];
+  warnings: AssetWarning[];
+}
+//#endregion

package/dist/export/preflight-export.d.ts

@@ -0,0 +1,17 @@
+import { AssetWarning } from "../assets/asset-pipeline.js";
+import { StaticCanvas } from "fabric";
+//#region src/export/preflight-export.d.ts
+export type ExportProblemCode = "MISSING_IMAGE" | "CROSS_ORIGIN_IMAGE" | "MISSING_FONT";
+export interface ExportProblem {
+  code: ExportProblemCode;
+  message: string;
+  url?: string;
+  family?: string;
+  objectIds: string[];
+}
+export interface ExportPreflight {
+  ok: boolean;
+  problems: ExportProblem[];
+  warnings: AssetWarning[];
+}
+//#endregion

package/dist/export/preflight-export.js

@@ -0,0 +1,105 @@
+import { findUnavailableFonts } from "../assets/font-check.js";
+import { isCrossOriginUrl, isPortableUrl } from "../assets/image-check.js";
+import { isRasterFormat } from "./export-options.js";
+import { readObjectId } from "../fabric/object-ids.js";
+import { childrenOf } from "../fabric/walk-objects.js";
+//#region src/export/preflight-export.ts
+function imageElementsOf(object) {
+	const elements = [];
+	const withElement = object;
+	if (typeof withElement.getElement === "function") elements.push(withElement.getElement());
+	for (const paint of [object.fill, object.stroke]) {
+		const source = paint?.source;
+		if (source !== void 0) elements.push(source);
+	}
+	return elements.filter((element) => typeof HTMLImageElement !== "undefined" && element instanceof HTMLImageElement);
+}
+function collectImageUses(objects) {
+	const uses = /* @__PURE__ */ new Map();
+	const pending = objects.map((object) => ({
+		object,
+		ownerId: readObjectId(object)
+	}));
+	while (pending.length > 0) {
+		const { object, ownerId } = pending.pop();
+		const id = readObjectId(object) ?? ownerId;
+		for (const element of imageElementsOf(object)) {
+			const url = element.currentSrc || element.src;
+			const use = uses.get(url) ?? {
+				element,
+				objectIds: /* @__PURE__ */ new Set()
+			};
+			if (id !== void 0) use.objectIds.add(id);
+			uses.set(url, use);
+		}
+		childrenOf(object).forEach((child) => pending.push({
+			object: child,
+			ownerId: id
+		}));
+		if (object.clipPath) pending.push({
+			object: object.clipPath,
+			ownerId: id
+		});
+	}
+	return uses;
+}
+function isBroken(element) {
+	return element.complete && element.naturalWidth === 0;
+}
+function shortUrl(url) {
+	return url.length > 80 ? `${url.slice(0, 77)}...` : url;
+}
+async function preflightExport(canvas, format, fonts, assetOptions) {
+	const problems = [];
+	const warnings = [];
+	if (format === "json") return {
+		ok: true,
+		problems,
+		warnings
+	};
+	for (const [url, use] of collectImageUses(canvas.getObjects())) {
+		const objectIds = [...use.objectIds];
+		if (isBroken(use.element)) problems.push({
+			code: "MISSING_IMAGE",
+			message: `The image ${shortUrl(url)} did not load`,
+			url,
+			objectIds
+		});
+		else if (isRasterFormat(format) && isCrossOriginUrl(url) && !use.element.crossOrigin) problems.push({
+			code: "CROSS_ORIGIN_IMAGE",
+			message: `The image ${shortUrl(url)} comes from another site without crossOrigin, so the browser blocks exporting it. Load it with crossOrigin: 'anonymous' from a server that allows CORS.`,
+			url,
+			objectIds
+		});
+		else if (format === "svg" && !isPortableUrl(url)) warnings.push({
+			code: "ASSET_NOT_PORTABLE",
+			message: `The SVG links to ${shortUrl(url)}, which only exists in this tab`,
+			url,
+			objectIds
+		});
+	}
+	const fontSet = typeof document === "undefined" ? void 0 : document.fonts;
+	if (fontSet) await fontSet.ready;
+	for (const font of await findUnavailableFonts(fonts, assetOptions.loadFont)) {
+		const message = `The font "${font.family}" (${font.weight}, ${font.style}) is not available`;
+		if (assetOptions.requireFonts) problems.push({
+			code: "MISSING_FONT",
+			message,
+			family: font.family,
+			objectIds: font.objectIds
+		});
+		else warnings.push({
+			code: "FONT_UNAVAILABLE",
+			message: `${message}, text will use a fallback font`,
+			family: font.family,
+			objectIds: font.objectIds
+		});
+	}
+	return {
+		ok: problems.length === 0,
+		problems,
+		warnings
+	};
+}
+//#endregion
+export { preflightExport };

package/dist/export/render-export.cjs

@@ -0,0 +1,69 @@
+//#region src/export/render-export.ts
+const identity = [
+	1,
+	0,
+	0,
+	1,
+	0,
+	0
+];
+const mimeTypes = {
+	png: "image/png",
+	jpeg: "image/jpeg",
+	webp: "image/webp",
+	svg: "image/svg+xml",
+	json: "application/json"
+};
+function chooseBackground(background, format, current) {
+	if (background === "transparent") return format === "jpeg" ? "white" : "";
+	if (background !== "keep") return background;
+	return format === "jpeg" && !(current !== void 0 && current !== null && current !== "") ? "white" : current;
+}
+function withExportView(canvas, background, format, work) {
+	const savedTransform = [...canvas.viewportTransform];
+	const savedBackground = canvas.backgroundColor;
+	canvas.setViewportTransform(identity);
+	canvas.backgroundColor = chooseBackground(background, format, savedBackground);
+	try {
+		return work();
+	} finally {
+		canvas.backgroundColor = savedBackground;
+		canvas.setViewportTransform(savedTransform);
+		canvas.requestRenderAll();
+	}
+}
+function renderRaster(canvas, area, format, scale, quality) {
+	return canvas.toDataURL({
+		...area,
+		format,
+		quality,
+		multiplier: scale,
+		enableRetinaScaling: false
+	});
+}
+function renderSvg(canvas, area, scale) {
+	return canvas.toSVG({
+		viewBox: {
+			x: area.left,
+			y: area.top,
+			width: area.width,
+			height: area.height
+		},
+		width: String(area.width * scale),
+		height: String(area.height * scale)
+	});
+}
+function dataUrlToBlob(dataUrl) {
+	const [header, payload = ""] = dataUrl.split(",");
+	const mimeType = /data:([^;]+)/.exec(header ?? "")?.[1] ?? "application/octet-stream";
+	const binary = atob(payload);
+	const bytes = new Uint8Array(binary.length);
+	for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);
+	return new Blob([bytes], { type: mimeType });
+}
+//#endregion
+exports.dataUrlToBlob = dataUrlToBlob;
+exports.mimeTypes = mimeTypes;
+exports.renderRaster = renderRaster;
+exports.renderSvg = renderSvg;
+exports.withExportView = withExportView;

package/dist/export/render-export.js

@@ -0,0 +1,65 @@
+//#region src/export/render-export.ts
+const identity = [
+	1,
+	0,
+	0,
+	1,
+	0,
+	0
+];
+const mimeTypes = {
+	png: "image/png",
+	jpeg: "image/jpeg",
+	webp: "image/webp",
+	svg: "image/svg+xml",
+	json: "application/json"
+};
+function chooseBackground(background, format, current) {
+	if (background === "transparent") return format === "jpeg" ? "white" : "";
+	if (background !== "keep") return background;
+	return format === "jpeg" && !(current !== void 0 && current !== null && current !== "") ? "white" : current;
+}
+function withExportView(canvas, background, format, work) {
+	const savedTransform = [...canvas.viewportTransform];
+	const savedBackground = canvas.backgroundColor;
+	canvas.setViewportTransform(identity);
+	canvas.backgroundColor = chooseBackground(background, format, savedBackground);
+	try {
+		return work();
+	} finally {
+		canvas.backgroundColor = savedBackground;
+		canvas.setViewportTransform(savedTransform);
+		canvas.requestRenderAll();
+	}
+}
+function renderRaster(canvas, area, format, scale, quality) {
+	return canvas.toDataURL({
+		...area,
+		format,
+		quality,
+		multiplier: scale,
+		enableRetinaScaling: false
+	});
+}
+function renderSvg(canvas, area, scale) {
+	return canvas.toSVG({
+		viewBox: {
+			x: area.left,
+			y: area.top,
+			width: area.width,
+			height: area.height
+		},
+		width: String(area.width * scale),
+		height: String(area.height * scale)
+	});
+}
+function dataUrlToBlob(dataUrl) {
+	const [header, payload = ""] = dataUrl.split(",");
+	const mimeType = /data:([^;]+)/.exec(header ?? "")?.[1] ?? "application/octet-stream";
+	const binary = atob(payload);
+	const bytes = new Uint8Array(binary.length);
+	for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);
+	return new Blob([bytes], { type: mimeType });
+}
+//#endregion
+export { dataUrlToBlob, mimeTypes, renderRaster, renderSvg, withExportView };

package/dist/history/apply-state.cjs

@@ -1,5 +1,5 @@
-const require_fabric_adapter = require("../fabric/fabric-adapter.cjs");
 const require_object_ids = require("../fabric/object-ids.cjs");
+const require_fabric_adapter = require("../fabric/fabric-adapter.cjs");
 //#region src/history/apply-state.ts
 function arrangeObjects(current, change, created) {
 	const arranged = [];

package/dist/history/apply-state.js

@@ -1,5 +1,5 @@
-import { createObjects } from "../fabric/fabric-adapter.js";
 import { readObjectId } from "../fabric/object-ids.js";
+import { createObjects } from "../fabric/fabric-adapter.js";
 //#region src/history/apply-state.ts
 function arrangeObjects(current, change, created) {
 	const arranged = [];

package/dist/index.cjs

@@ -5,11 +5,13 @@ const require_validate_document = require("./document/validate-document.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");
+const require_download_export = require("./export/download-export.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.downloadExport = require_download_export.downloadExport;
 exports.isDocumentEngineError = require_errors.isDocumentEngineError;
 exports.validateDocument = require_validate_document.validateDocument;

package/dist/index.d.cts

@@ -2,17 +2,22 @@ import { CURRENT_SCHEMA_VERSION, DocumentCanvas, DocumentInfo, FabricDocument, S
 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 { ExportArea, ExportBackground, ExportFormat, ExportOptions, ExportRect } from "./export/export-options.cjs";
+import { ExportPreflight, ExportProblem, ExportProblemCode } from "./export/preflight-export.cjs";
 import { NewDocumentOptions } from "./document/create-document.cjs";
 import { CustomObjectDefinition } from "./fabric/object-registry.cjs";
 import { HistoryOptions, HistoryState } from "./history/create-history.cjs";
+import { RecoveryStore } from "./recovery/recovery-store.cjs";
+import { InterruptedLoad, RecoveryOptions, RecoveryRecord } from "./recovery/recovery-controller.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, LoadOptions, createDocumentEngine } from "./engine/create-document-engine.cjs";
+import { DocumentEngine, DocumentEngineEvents, DocumentEngineOptions, ExportResult, LoadOptions, createDocumentEngine } from "./engine/create-document-engine.cjs";
 import { validateDocument } from "./document/validate-document.cjs";
 import { KeyboardShortcutOptions, UndoRedoTarget, bindKeyboardShortcuts } from "./history/keyboard-shortcuts.cjs";
 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 };
+import { DownloadableExport, downloadExport } from "./export/download-export.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 DownloadableExport, type ExportArea, type ExportBackground, type ExportFormat, type ExportOptions, type ExportPreflight, type ExportProblem, type ExportProblemCode, type ExportRect, type ExportResult, type FabricDocument, type FontAsset, type FontLoader, type HistoryOptions, type HistoryState, type ImageAsset, type InterruptedLoad, type KeyboardShortcutOptions, type LoadOptions, type NewDocumentOptions, type RecoveryOptions, type RecoveryRecord, type RecoveryStore, 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, downloadExport, isDocumentEngineError, validateDocument };

package/dist/index.d.ts

@@ -2,17 +2,22 @@ import { CURRENT_SCHEMA_VERSION, DocumentCanvas, DocumentInfo, FabricDocument, S
 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 { ExportArea, ExportBackground, ExportFormat, ExportOptions, ExportRect } from "./export/export-options.js";
+import { ExportPreflight, ExportProblem, ExportProblemCode } from "./export/preflight-export.js";
 import { NewDocumentOptions } from "./document/create-document.js";
 import { CustomObjectDefinition } from "./fabric/object-registry.js";
 import { HistoryOptions, HistoryState } from "./history/create-history.js";
+import { RecoveryStore } from "./recovery/recovery-store.js";
+import { InterruptedLoad, RecoveryOptions, RecoveryRecord } from "./recovery/recovery-controller.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, LoadOptions, createDocumentEngine } from "./engine/create-document-engine.js";
+import { DocumentEngine, DocumentEngineEvents, DocumentEngineOptions, ExportResult, LoadOptions, createDocumentEngine } from "./engine/create-document-engine.js";
 import { validateDocument } from "./document/validate-document.js";
 import { KeyboardShortcutOptions, UndoRedoTarget, bindKeyboardShortcuts } from "./history/keyboard-shortcuts.js";
 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 };
+import { DownloadableExport, downloadExport } from "./export/download-export.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 DownloadableExport, type ExportArea, type ExportBackground, type ExportFormat, type ExportOptions, type ExportPreflight, type ExportProblem, type ExportProblemCode, type ExportRect, type ExportResult, type FabricDocument, type FontAsset, type FontLoader, type HistoryOptions, type HistoryState, type ImageAsset, type InterruptedLoad, type KeyboardShortcutOptions, type LoadOptions, type NewDocumentOptions, type RecoveryOptions, type RecoveryRecord, type RecoveryStore, 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, downloadExport, isDocumentEngineError, validateDocument };

package/dist/index.js

@@ -4,4 +4,5 @@ import { validateDocument } from "./document/validate-document.js";
 import { createDocumentEngine } from "./engine/create-document-engine.js";
 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 };
+import { downloadExport } from "./export/download-export.js";
+export { CURRENT_SCHEMA_VERSION, DocumentEngineError, bindKeyboardShortcuts, bindUnsavedChangesWarning, createConflictError, createDocumentEngine, downloadExport, isDocumentEngineError, validateDocument };

package/dist/recovery/indexed-db-recovery.cjs

@@ -0,0 +1,80 @@
+//#region src/recovery/indexed-db-recovery.ts
+function requestToPromise(request) {
+	return new Promise((resolve, reject) => {
+		request.onsuccess = () => resolve(request.result);
+		request.onerror = () => reject(request.error);
+	});
+}
+function browserStorage() {
+	try {
+		return globalThis.localStorage;
+	} catch {
+		return;
+	}
+}
+function createIndexedDbRecovery(options = {}) {
+	const databaseName = options.databaseName ?? "fabricjs-document-engine";
+	const storeName = options.storeName ?? "recovery";
+	let opening;
+	let database;
+	const emergencyPrefix = `${databaseName}/${storeName}:`;
+	const emergencyStorage = browserStorage();
+	function readEmergency(key) {
+		const json = emergencyStorage?.getItem(`${emergencyPrefix}${key}`);
+		return json === null || json === void 0 ? void 0 : JSON.parse(json);
+	}
+	function emergencyKeys() {
+		if (!emergencyStorage) return [];
+		return Array.from({ length: emergencyStorage.length }, (_, index) => emergencyStorage.key(index) ?? "").filter((key) => key.startsWith(emergencyPrefix)).map((key) => key.slice(emergencyPrefix.length));
+	}
+	function openDatabase() {
+		opening ?? (opening = new Promise((resolve, reject) => {
+			const request = indexedDB.open(databaseName, 1);
+			request.onupgradeneeded = () => {
+				if (!request.result.objectStoreNames.contains(storeName)) request.result.createObjectStore(storeName);
+			};
+			request.onsuccess = () => {
+				database = request.result;
+				resolve(request.result);
+			};
+			request.onerror = () => {
+				opening = void 0;
+				reject(request.error);
+			};
+		}));
+		return opening;
+	}
+	async function run(mode, work) {
+		const transaction = (database ?? await openDatabase()).transaction(storeName, mode);
+		const result = requestToPromise(work(transaction.objectStore(storeName)));
+		await new Promise((resolve, reject) => {
+			transaction.oncomplete = () => resolve();
+			transaction.onerror = () => reject(transaction.error);
+			transaction.onabort = () => reject(transaction.error);
+		});
+		return result;
+	}
+	return {
+		get: async (key) => await run("readonly", (store) => store.get(key)) ?? readEmergency(key),
+		set: async (key, value) => {
+			await run("readwrite", (store) => store.put(value, key));
+		},
+		setNow(key, value) {
+			try {
+				emergencyStorage?.setItem(`${emergencyPrefix}${key}`, JSON.stringify(value));
+			} catch {
+				return;
+			}
+		},
+		delete: async (key) => {
+			emergencyStorage?.removeItem(`${emergencyPrefix}${key}`);
+			await run("readwrite", (store) => store.delete(key));
+		},
+		keys: async () => {
+			const stored = (await run("readonly", (store) => store.getAllKeys())).map(String);
+			return [.../* @__PURE__ */ new Set([...stored, ...emergencyKeys()])];
+		}
+	};
+}
+//#endregion
+exports.createIndexedDbRecovery = createIndexedDbRecovery;

package/dist/recovery/indexed-db-recovery.d.cts

@@ -0,0 +1,8 @@
+import { RecoveryStore } from "./recovery-store.cjs";
+//#region src/recovery/indexed-db-recovery.d.ts
+export interface IndexedDbRecoveryOptions {
+  databaseName?: string;
+  storeName?: string;
+}
+export declare function createIndexedDbRecovery(options?: IndexedDbRecoveryOptions): RecoveryStore;
+//#endregion

package/dist/recovery/indexed-db-recovery.d.ts

@@ -0,0 +1,8 @@
+import { RecoveryStore } from "./recovery-store.js";
+//#region src/recovery/indexed-db-recovery.d.ts
+export interface IndexedDbRecoveryOptions {
+  databaseName?: string;
+  storeName?: string;
+}
+export declare function createIndexedDbRecovery(options?: IndexedDbRecoveryOptions): RecoveryStore;
+//#endregion

package/dist/recovery/indexed-db-recovery.js

@@ -0,0 +1,80 @@
+//#region src/recovery/indexed-db-recovery.ts
+function requestToPromise(request) {
+	return new Promise((resolve, reject) => {
+		request.onsuccess = () => resolve(request.result);
+		request.onerror = () => reject(request.error);
+	});
+}
+function browserStorage() {
+	try {
+		return globalThis.localStorage;
+	} catch {
+		return;
+	}
+}
+function createIndexedDbRecovery(options = {}) {
+	const databaseName = options.databaseName ?? "fabricjs-document-engine";
+	const storeName = options.storeName ?? "recovery";
+	let opening;
+	let database;
+	const emergencyPrefix = `${databaseName}/${storeName}:`;
+	const emergencyStorage = browserStorage();
+	function readEmergency(key) {
+		const json = emergencyStorage?.getItem(`${emergencyPrefix}${key}`);
+		return json === null || json === void 0 ? void 0 : JSON.parse(json);
+	}
+	function emergencyKeys() {
+		if (!emergencyStorage) return [];
+		return Array.from({ length: emergencyStorage.length }, (_, index) => emergencyStorage.key(index) ?? "").filter((key) => key.startsWith(emergencyPrefix)).map((key) => key.slice(emergencyPrefix.length));
+	}
+	function openDatabase() {
+		opening ?? (opening = new Promise((resolve, reject) => {
+			const request = indexedDB.open(databaseName, 1);
+			request.onupgradeneeded = () => {
+				if (!request.result.objectStoreNames.contains(storeName)) request.result.createObjectStore(storeName);
+			};
+			request.onsuccess = () => {
+				database = request.result;
+				resolve(request.result);
+			};
+			request.onerror = () => {
+				opening = void 0;
+				reject(request.error);
+			};
+		}));
+		return opening;
+	}
+	async function run(mode, work) {
+		const transaction = (database ?? await openDatabase()).transaction(storeName, mode);
+		const result = requestToPromise(work(transaction.objectStore(storeName)));
+		await new Promise((resolve, reject) => {
+			transaction.oncomplete = () => resolve();
+			transaction.onerror = () => reject(transaction.error);
+			transaction.onabort = () => reject(transaction.error);
+		});
+		return result;
+	}
+	return {
+		get: async (key) => await run("readonly", (store) => store.get(key)) ?? readEmergency(key),
+		set: async (key, value) => {
+			await run("readwrite", (store) => store.put(value, key));
+		},
+		setNow(key, value) {
+			try {
+				emergencyStorage?.setItem(`${emergencyPrefix}${key}`, JSON.stringify(value));
+			} catch {
+				return;
+			}
+		},
+		delete: async (key) => {
+			emergencyStorage?.removeItem(`${emergencyPrefix}${key}`);
+			await run("readwrite", (store) => store.delete(key));
+		},
+		keys: async () => {
+			const stored = (await run("readonly", (store) => store.getAllKeys())).map(String);
+			return [.../* @__PURE__ */ new Set([...stored, ...emergencyKeys()])];
+		}
+	};
+}
+//#endregion
+export { createIndexedDbRecovery };