@stll/folio-core 0.22.3 → 0.23.0

package/dist/ai-edits/apply.d.ts

@@ -17,7 +17,7 @@ type FolioAIEditView = {
 type ApplyFolioAIEditOperationsOptions = {
   view: FolioAIEditView;
   snapshot: FolioAIEditSnapshot;
-  operations: FolioAIEditOperation[];
+  operations: readonly FolioAIEditOperation[];
   mode?: FolioAIEditApplyMode;
   author?: string;
   /** Optional author initials (w:initials) stamped alongside the author. */

package/dist/document-operations.d.ts

@@ -56,10 +56,10 @@ declare class InvalidFolioDocumentOperationBatchError extends InvalidFolioDocume
 declare const assertSupportedFolioDocumentOperationVersion: (value: unknown) => typeof FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION;
 type FolioDocumentOperationBatch = {
   readonly version: typeof FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION;
-  operations: FolioDocumentOperation[];
-  mode?: FolioDocumentOperationMode;
-  atomic?: boolean;
-  dryRun?: boolean;
+  readonly operations: readonly FolioDocumentOperation[];
+  readonly mode?: FolioDocumentOperationMode;
+  readonly atomic?: boolean;
+  readonly dryRun?: boolean;
 };
 declare const parseFolioDocumentOperationBatch: (value: unknown) => FolioDocumentOperationBatch;
 type FolioDocumentOperationStatus = "committed" | "previewed" | "rejected";

package/dist/document-operations.js

@@ -34,6 +34,7 @@ const FOLIO_DOCUMENT_OPERATION_STORIES = Object.freeze([
 ]);
 const FOLIO_DOCUMENT_OPERATION_PRECONDITIONS = Object.freeze(["blockTextHash"]);
 const FOLIO_DOCUMENT_OPERATION_BATCH_MODES = Object.freeze(["best-effort", "atomic"]);
+const parsedFolioDocumentOperationBatches = /* @__PURE__ */ new WeakSet();
 const DIRECT_AND_TRACKED_MODES = Object.freeze(["direct", "tracked-changes"]);
 const DIRECT_TRACKED_AND_SUGGESTED_MODES = FOLIO_DOCUMENT_OPERATION_MODES;
 const DIRECT_AND_SUGGESTED_MODES = Object.freeze(["direct", "suggested"]);
@@ -83,6 +84,17 @@ const assertSupportedFolioDocumentOperationVersion = (value) => {
 	});
 };
 const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isParsedFolioDocumentOperationBatch = (value) => typeof value === "object" && value !== null && parsedFolioDocumentOperationBatches.has(value);
+const freezeParsedValue = (value) => {
+	if (Array.isArray(value)) {
+		for (const entry of value) freezeParsedValue(entry);
+		Object.freeze(value);
+		return;
+	}
+	if (!isPlainObject(value)) return;
+	for (const entry of Object.values(value)) freezeParsedValue(entry);
+	Object.freeze(value);
+};
 const invalidBatch = (path, reason) => {
 	throw new InvalidFolioDocumentOperationBatchError({
 		message: `Invalid document operation batch at ${path}: ${reason}.`,
@@ -508,6 +520,7 @@ const parseDocumentOperation = (value, index) => {
 	return invalidBatch(`${path}.type`, `unsupported operation type "${type}"`);
 };
 const parseFolioDocumentOperationBatch = (value) => {
+	if (isParsedFolioDocumentOperationBatch(value)) return value;
 	if (!isPlainObject(value)) return invalidBatch("$", "expected an object");
 	assertAllowedKeys(value, "$", [
 		"version",
@@ -529,13 +542,16 @@ const parseFolioDocumentOperationBatch = (value) => {
 		if (operationIds.has(operation.id)) return invalidBatch(`$.operations[${index}].id`, "expected a unique operation id");
 		operationIds.add(operation.id);
 	}
-	return {
+	const parsedBatch = {
 		version,
 		operations: parsedOperations,
 		...mode !== void 0 && { mode },
 		...atomic !== void 0 && { atomic },
 		...dryRun !== void 0 && { dryRun }
 	};
+	freezeParsedValue(parsedBatch);
+	parsedFolioDocumentOperationBatches.add(parsedBatch);
+	return parsedBatch;
 };
 const recoveryByReason = {
 	missingBlock: "refreshDocument",

package/dist/docx/rezip.d.ts

@@ -145,7 +145,7 @@ declare function updateCoreProperties(corePropsXml: string, { updateModifiedDate
  * @param buffer - Buffer to validate
  * @returns Promise resolving to validation result
  */
-declare function validateDocx(buffer: ArrayBuffer): Promise<{
+declare const validateDocx: (buffer: ArrayBuffer) => Promise<{
   valid: boolean;
   errors: string[];
   warnings: string[];

package/dist/docx/rezip.js

@@ -21,6 +21,7 @@ import { isPreservableDocxEntry } from "./unzip.js";
 import { WORDPROCESSINGML_NAMESPACE_URIS, findChild, getChildElements, getLocalName, getNamespaceUri, matchesName, parseXml } from "./xmlParser.js";
 import { assertXmlResourceLimits } from "./xmlResourceLimits.js";
 import { panic } from "better-result";
+import { validateDocxPackage } from "@stll/docx-core";
 import JSZip from "jszip";
 //#region src/docx/rezip.ts
 /**
@@ -1223,38 +1224,18 @@ function getContentTypeForExtension(extension, mimeType) {
 * @param buffer - Buffer to validate
 * @returns Promise resolving to validation result
 */
-async function validateDocx(buffer) {
-	const errors = [];
-	const warnings = [];
-	try {
-		const zip = await JSZip.loadAsync(buffer);
-		for (const file of ["[Content_Types].xml", "word/document.xml"]) if (!zip.file(file)) errors.push(`Missing required file: ${file}`);
-		for (const file of [
-			"_rels/.rels",
-			"word/_rels/document.xml.rels",
-			"word/styles.xml"
-		]) if (!zip.file(file)) warnings.push(`Missing recommended file: ${file}`);
-		const docFile = zip.file("word/document.xml");
-		if (docFile) {
-			const docXml = await docFile.async("text");
-			if (!docXml.includes("<?xml")) warnings.push("document.xml missing XML declaration");
-			if (!docXml.includes("<w:document")) errors.push("document.xml missing w:document element");
-			if (!docXml.includes("<w:body>")) errors.push("document.xml missing w:body element");
-		}
-		const ctFile = zip.file("[Content_Types].xml");
-		if (ctFile) {
-			const ctXml = await ctFile.async("text");
-			if (!ctXml.includes("word/document.xml") && !ctXml.includes("application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml")) warnings.push("Content_Types.xml may be missing document.xml type declaration");
-		}
-	} catch (error) {
-		errors.push(`Failed to read as ZIP: ${error instanceof Error ? error.message : "Unknown error"}`);
-	}
-	return {
-		valid: errors.length === 0,
-		errors,
-		warnings
+const validateDocx = async (buffer) => {
+	const result = await validateDocxPackage(buffer);
+	return result.valid ? {
+		valid: true,
+		errors: [],
+		warnings: []
+	} : {
+		valid: false,
+		errors: [result.error],
+		warnings: []
 	};
-}
+};
 /**
 * Check if buffer looks like a DOCX file (quick check)
 *

package/dist/layout-bridge/convert/toFlowBlocks.js

@@ -9,7 +9,6 @@ import { autospacingMatchesBase } from "../../prosemirror/autospacingBase.js";
 import { runShadingAttrsToShading } from "../../prosemirror/conversion/runShadingMark.js";
 import { directionIsRtl } from "../../prosemirror/paragraphDirection.js";
 import { assertValidProseMirrorDocument } from "../../prosemirror/validation.js";
-import { NUMBER_FORMAT_VALUES } from "../../types/documentEnumValues.js";
 import { resolveColor, resolveHighlightToCss } from "../../utils/colorResolver.js";
 import { resolveThemeFont } from "../../utils/fontResolver.js";
 import { resolveShadingFill } from "../../utils/formatToStyle.js";
@@ -364,7 +363,7 @@ const resolveWesternThemeFont = (fontFamily, theme) => {
 	return (themeRef ? resolveThemeFont(themeRef, theme?.fontScheme) : null) ?? fontFamily.ascii ?? fontFamily.hAnsi ?? void 0;
 };
 const resolveComplexScriptThemeFont = (fontFamily, theme) => {
-	return (fontFamily.cstheme ? resolveThemeFont(fontFamily.cstheme, theme?.fontScheme) : null) ?? fontFamily.cs ?? void 0;
+	return (fontFamily.csTheme ? resolveThemeFont(fontFamily.csTheme, theme?.fontScheme) : null) ?? fontFamily.cs ?? void 0;
 };
 const resolveEastAsiaThemeFont = (fontFamily, theme) => {
 	return (fontFamily.eastAsiaTheme ? resolveThemeFont(fontFamily.eastAsiaTheme, theme?.fontScheme) : null) ?? fontFamily.eastAsia ?? void 0;
@@ -650,78 +649,54 @@ function toListMarkerRevision(kind, info) {
 }
 function isAddedNumberingChange(change) {
 	const previousFormatting = change.previousFormatting;
-	return previousFormatting != null && Object.hasOwn(previousFormatting, "numPr") && previousFormatting["numPr"] == null;
+	return previousFormatting != null && Object.hasOwn(previousFormatting, "numPr") && previousFormatting.numPr == null;
 }
 function isRemovedNumberingChange(change) {
 	const previousFormatting = change.previousFormatting;
-	return previousFormatting != null && Object.hasOwn(previousFormatting, "numPr") && isListNumPr(previousFormatting["numPr"]);
+	return previousFormatting != null && Object.hasOwn(previousFormatting, "numPr") && isListNumPr(previousFormatting.numPr);
 }
 function isChangedNumberingChange(currentNumPr, change) {
 	const previousFormatting = change.previousFormatting;
-	return previousFormatting != null && Object.hasOwn(previousFormatting, "numPr") && isListNumPr(previousFormatting["numPr"]) && !areListNumPrEqual(previousFormatting["numPr"], currentNumPr);
+	return previousFormatting != null && Object.hasOwn(previousFormatting, "numPr") && isListNumPr(previousFormatting.numPr) && !areListNumPrEqual(previousFormatting.numPr, currentNumPr);
 }
 function areListNumPrEqual(left, right) {
 	return left.numId === right.numId && left.ilvl === right.ilvl;
 }
-function isRecord(value) {
-	return typeof value === "object" && value !== null;
-}
 function isListNumPr(value) {
-	if (!isRecord(value)) return false;
-	const numId = value["numId"];
-	const ilvl = value["ilvl"];
-	return (numId === void 0 || typeof numId === "number") && (ilvl === void 0 || typeof ilvl === "number");
-}
-function isNumberFormat(value) {
-	return NUMBER_FORMAT_VALUES.some((format) => format === value);
-}
-function readNumberFormats(value) {
-	if (!Array.isArray(value)) return;
-	const formats = [];
-	for (const item of value) {
-		if (!isNumberFormat(item)) return;
-		formats.push(item);
-	}
-	return formats;
-}
-function readListMarkerSuffix(value) {
-	if (value === "tab" || value === "space" || value === "nothing") return value;
-}
-function readListMarkerAlignment(value) {
-	if (value === "left" || value === "center" || value === "right") return value;
+	return value !== void 0 && value !== null;
 }
 function toPreviousListAttrs(previousFormatting) {
 	const attrs = {};
-	const numPr = previousFormatting["numPr"];
+	const numPr = previousFormatting.numPr;
 	if (isListNumPr(numPr)) attrs.numPr = numPr;
-	const listIsBullet = previousFormatting["listIsBullet"];
-	if (typeof listIsBullet === "boolean") attrs.listIsBullet = listIsBullet;
-	const listIsLegal = previousFormatting["listIsLegal"];
-	if (typeof listIsLegal === "boolean") attrs.listIsLegal = listIsLegal;
-	const listMarker = previousFormatting["listMarker"];
-	if (typeof listMarker === "string") attrs.listMarker = listMarker;
-	const listNumFmt = previousFormatting["listNumFmt"];
-	if (isNumberFormat(listNumFmt)) attrs.listNumFmt = listNumFmt;
-	const listLevelNumFmts = readNumberFormats(previousFormatting["listLevelNumFmts"]);
-	if (listLevelNumFmts) attrs.listLevelNumFmts = listLevelNumFmts;
-	const listLevelStarts = previousFormatting["listLevelStarts"];
-	if (Array.isArray(listLevelStarts) && listLevelStarts.every((value) => typeof value === "number")) attrs.listLevelStarts = listLevelStarts;
-	const listAbstractNumId = previousFormatting["listAbstractNumId"];
-	if (typeof listAbstractNumId === "number") attrs.listAbstractNumId = listAbstractNumId;
-	const listStartOverride = previousFormatting["listStartOverride"];
-	if (typeof listStartOverride === "number") attrs.listStartOverride = listStartOverride;
-	const listMarkerHidden = previousFormatting["listMarkerHidden"];
-	if (typeof listMarkerHidden === "boolean") attrs.listMarkerHidden = listMarkerHidden;
-	const listMarkerFontFamily = previousFormatting["listMarkerFontFamily"];
-	if (typeof listMarkerFontFamily === "string") attrs.listMarkerFontFamily = listMarkerFontFamily;
-	const listMarkerFontSize = previousFormatting["listMarkerFontSize"];
-	if (typeof listMarkerFontSize === "number") attrs.listMarkerFontSize = listMarkerFontSize;
-	const listMarkerBold = previousFormatting["listMarkerBold"];
-	if (typeof listMarkerBold === "boolean") attrs.listMarkerBold = listMarkerBold;
-	const listMarkerAlignment = readListMarkerAlignment(previousFormatting["listMarkerAlignment"]);
-	if (listMarkerAlignment) attrs.listMarkerAlignment = listMarkerAlignment;
-	const listMarkerSuffix = readListMarkerSuffix(previousFormatting["listMarkerSuffix"]);
-	if (listMarkerSuffix) attrs.listMarkerSuffix = listMarkerSuffix;
+	const listIsBullet = previousFormatting.listIsBullet;
+	if (listIsBullet !== void 0) attrs.listIsBullet = listIsBullet;
+	const listIsLegal = previousFormatting.listIsLegal;
+	if (listIsLegal !== void 0) attrs.listIsLegal = listIsLegal;
+	const listMarker = previousFormatting.listMarker;
+	if (listMarker !== void 0) attrs.listMarker = listMarker;
+	const listNumFmt = previousFormatting.listNumFmt;
+	if (listNumFmt !== void 0) attrs.listNumFmt = listNumFmt;
+	const listLevelNumFmts = previousFormatting.listLevelNumFmts;
+	if (listLevelNumFmts !== void 0) attrs.listLevelNumFmts = listLevelNumFmts;
+	const listLevelStarts = previousFormatting.listLevelStarts;
+	if (listLevelStarts !== void 0) attrs.listLevelStarts = listLevelStarts;
+	const listAbstractNumId = previousFormatting.listAbstractNumId;
+	if (listAbstractNumId !== void 0) attrs.listAbstractNumId = listAbstractNumId;
+	const listStartOverride = previousFormatting.listStartOverride;
+	if (listStartOverride !== void 0) attrs.listStartOverride = listStartOverride;
+	const listMarkerHidden = previousFormatting.listMarkerHidden;
+	if (listMarkerHidden !== void 0) attrs.listMarkerHidden = listMarkerHidden;
+	const listMarkerFontFamily = previousFormatting.listMarkerFontFamily;
+	if (listMarkerFontFamily !== void 0) attrs.listMarkerFontFamily = listMarkerFontFamily;
+	const listMarkerFontSize = previousFormatting.listMarkerFontSize;
+	if (listMarkerFontSize !== void 0) attrs.listMarkerFontSize = listMarkerFontSize;
+	const listMarkerBold = previousFormatting.listMarkerBold;
+	if (listMarkerBold !== void 0) attrs.listMarkerBold = listMarkerBold;
+	const listMarkerAlignment = previousFormatting.listMarkerAlignment;
+	if (listMarkerAlignment !== void 0) attrs.listMarkerAlignment = listMarkerAlignment;
+	const listMarkerSuffix = previousFormatting.listMarkerSuffix;
+	if (listMarkerSuffix !== void 0) attrs.listMarkerSuffix = listMarkerSuffix;
 	return attrs;
 }
 function resolveDeletedListMarker(previousListAttrs, listCounters, listAbstractCounters, listSeenNumIds) {
@@ -848,8 +823,7 @@ function convertParagraphAttrs(pmAttrs, theme, listCounters, listAbstractCounter
 	if (pmAttrs.runInWithNext) attrs.runInWithNext = true;
 	if (directionIsRtl(pmAttrs.direction)) attrs.bidi = true;
 	if (pmAttrs.styleId) attrs.styleId = pmAttrs.styleId;
-	const pPrChange = pmAttrs._propertyChanges;
-	const propertyChanges = Array.isArray(pPrChange) ? pPrChange : [];
+	const propertyChanges = pmAttrs._propertyChanges ?? [];
 	let changedNumberingChange;
 	if (pmAttrs.numPr) {
 		const numPr = {};

package/dist/layout-painter/imageLayout.d.ts

@@ -1,7 +1,7 @@
 import { FlowBlock, Measure } from "../layout-engine/types.js";
+import { ImageAttrs } from "../prosemirror/schema/nodes.js";
 import { BlockLookup } from "./index.js";
 import { WrapType } from "../docx/wrapTypes.js";
-import { ImageAttrs } from "../prosemirror/schema/nodes.js";
 //#region src/layout-painter/imageLayout.d.ts
 /**
  * Anchored wrap-type targets — the OOXML wrap types except `inline`.

package/dist/managers/AutoSaveManager.js

@@ -1,10 +1,10 @@
 import { Subscribable } from "./Subscribable.js";
+import { decodeAutoSaveEnvelope, encodeAutoSaveDocument, encodeAutoSaveEnvelopeFromDocument } from "./autoSaveCodec.js";
 //#region src/managers/AutoSaveManager.ts
 const DEFAULT_STORAGE_KEY = "docx-editor-autosave";
 const DEFAULT_INTERVAL = 3e4;
 const DEFAULT_MAX_AGE = 1440 * 60 * 1e3;
 const DEFAULT_DEBOUNCE_DELAY = 2e3;
-const SAVE_VERSION = 1;
 function isLocalStorageAvailable() {
 	try {
 		const testKey = "__docx_editor_test__";
@@ -16,31 +16,7 @@ function isLocalStorageAvailable() {
 	}
 }
 function serializeForStorage(document) {
-	return JSON.stringify({
-		...document,
-		originalBuffer: null
-	});
-}
-function isDocumentLike(value) {
-	return typeof value === "object" && value !== null && "package" in value;
-}
-function parseSavedData(json) {
-	let parsed;
-	try {
-		parsed = JSON.parse(json);
-	} catch {
-		return null;
-	}
-	if (typeof parsed !== "object" || parsed === null) return null;
-	if (!("document" in parsed) || !("savedAt" in parsed) || !("version" in parsed)) return null;
-	const { document, savedAt, version } = parsed;
-	if (typeof savedAt !== "string" || typeof version !== "number") return null;
-	if (!isDocumentLike(document)) return null;
-	return {
-		document,
-		savedAt,
-		version
-	};
+	return encodeAutoSaveDocument(document);
 }
 function isStale(savedAt, maxAge) {
 	const savedTime = new Date(savedAt).getTime();
@@ -99,12 +75,12 @@ var AutoSaveManager = class extends Subscribable {
 		this.updateStatus("saving");
 		try {
 			const serialized = serializeForStorage(doc);
-			if (serialized === this.lastSavedJson) {
+			if (serialized.json === this.lastSavedJson) {
 				this.updateStatus("saved");
 				return true;
 			}
-			this.persistToStorage(doc);
-			this.lastSavedJson = serialized;
+			this.persistToStorage(serialized);
+			this.lastSavedJson = serialized.json;
 			const saveTime = /* @__PURE__ */ new Date();
 			this.lastSaveTime = saveTime;
 			this.updateStatus("saved");
@@ -133,7 +109,7 @@ var AutoSaveManager = class extends Subscribable {
 		if (!this.storageAvailable) return null;
 		const savedJson = localStorage.getItem(this.storageKey);
 		if (!savedJson) return null;
-		const savedData = parseSavedData(savedJson);
+		const savedData = decodeAutoSaveEnvelope(savedJson);
 		if (!savedData) return null;
 		if (isStale(savedData.savedAt, this.maxAge)) {
 			this.clear();
@@ -179,7 +155,7 @@ var AutoSaveManager = class extends Subscribable {
 	destroy() {
 		this.stopTimers();
 		if (this.isEnabled && this.currentDocument && this.storageAvailable) try {
-			this.persistToStorage(this.currentDocument);
+			this.persistToStorage(serializeForStorage(this.currentDocument));
 		} catch (error) {
 			this.onErrorCallback?.(error instanceof Error ? error : new Error(String(error)));
 		}
@@ -194,15 +170,7 @@ var AutoSaveManager = class extends Subscribable {
 		}
 	}
 	persistToStorage(document) {
-		const dataToSave = {
-			document: {
-				...document,
-				originalBuffer: null
-			},
-			savedAt: (/* @__PURE__ */ new Date()).toISOString(),
-			version: SAVE_VERSION
-		};
-		localStorage.setItem(this.storageKey, JSON.stringify(dataToSave));
+		localStorage.setItem(this.storageKey, encodeAutoSaveEnvelopeFromDocument(document, (/* @__PURE__ */ new Date()).toISOString()));
 	}
 	debounceSave() {
 		if (this.debounceTimer) clearTimeout(this.debounceTimer);

package/dist/managers/TableSelectionManager.d.ts

@@ -1,7 +1,7 @@
 import { document_d_exports } from "../types/document.js";
+import { TableAction, TableContext } from "../utils/tableOperations.js";
 import { Subscribable } from "./Subscribable.js";
 import { CellCoordinates } from "./types.js";
-import { TableAction, TableContext } from "../utils/tableOperations.js";
 //#region src/managers/TableSelectionManager.d.ts
 /** Data attributes for table elements in the rendered DOM */
 declare const TABLE_DATA_ATTRIBUTES: {

package/dist/managers/autoSaveCodec.d.ts

@@ -0,0 +1,17 @@
+import { document_d_exports } from "../types/document.js";
+//#region src/managers/autoSaveCodec.d.ts
+declare const AUTOSAVE_FORMAT_VERSION = 2;
+type DecodedAutoSave = {
+  document: document_d_exports.Document;
+  savedAt: string;
+  version: typeof AUTOSAVE_FORMAT_VERSION;
+};
+type EncodedAutoSaveDocument = {
+  json: string;
+};
+declare const encodeAutoSaveDocument: (document: document_d_exports.Document) => EncodedAutoSaveDocument;
+declare const encodeAutoSaveEnvelopeFromDocument: (document: EncodedAutoSaveDocument, savedAt: string) => string;
+declare const encodeAutoSaveEnvelope: (document: document_d_exports.Document, savedAt: string) => string;
+declare const decodeAutoSaveEnvelope: (json: string) => DecodedAutoSave | null;
+//#endregion
+export { AUTOSAVE_FORMAT_VERSION, DecodedAutoSave, EncodedAutoSaveDocument, decodeAutoSaveEnvelope, encodeAutoSaveDocument, encodeAutoSaveEnvelope, encodeAutoSaveEnvelopeFromDocument };

package/dist/managers/autoSaveCodec.js

@@ -0,0 +1,109 @@
+import { validateFolioDocumentModel } from "../docx/modelValidation.js";
+//#region src/managers/autoSaveCodec.ts
+const AUTOSAVE_FORMAT_VERSION = 2;
+const BASE64_CHUNK_BYTES = 32768;
+const encodeBase64 = (buffer) => {
+	const bytes = new Uint8Array(buffer);
+	const chunks = [];
+	for (let offset = 0; offset < bytes.length; offset += BASE64_CHUNK_BYTES) chunks.push(String.fromCharCode(...bytes.subarray(offset, offset + BASE64_CHUNK_BYTES)));
+	return btoa(chunks.join(""));
+};
+const decodeBase64 = (value) => {
+	const binary = atob(value);
+	const bytes = new Uint8Array(binary.length);
+	for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);
+	return bytes.buffer;
+};
+const encodeValue = (value) => {
+	if (value === void 0) return { type: "undefined" };
+	if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean") return value;
+	if (value instanceof Date) return {
+		type: "date",
+		value: value.toISOString()
+	};
+	if (value instanceof ArrayBuffer) return {
+		type: "arrayBuffer",
+		value: encodeBase64(value)
+	};
+	if (value instanceof Map) return {
+		type: "map",
+		value: [...value.entries()].map(([key, entry]) => [encodeValue(key), encodeValue(entry)])
+	};
+	if (Array.isArray(value)) return {
+		type: "array",
+		value: value.map(encodeValue)
+	};
+	if (typeof value === "object") {
+		const encoded = {};
+		for (const [key, entry] of Object.entries(value)) encoded[key] = encodeValue(entry);
+		return {
+			type: "object",
+			value: encoded
+		};
+	}
+	throw new TypeError(`Unsupported auto-save value: ${typeof value}`);
+};
+const decodeValue = (value) => {
+	if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean") return value;
+	if (typeof value !== "object" || !value || !("type" in value)) throw new TypeError("Invalid auto-save encoded value");
+	const type = value.type;
+	if (type === "undefined") return;
+	if (type === "date") {
+		if (!("value" in value) || typeof value.value !== "string" || !Number.isFinite(Date.parse(value.value))) throw new TypeError("Invalid auto-save date");
+		return new Date(value.value);
+	}
+	if (type === "arrayBuffer") {
+		if (!("value" in value) || typeof value.value !== "string") throw new TypeError("Invalid auto-save binary data");
+		return decodeBase64(value.value);
+	}
+	if (type === "array") {
+		if (!("value" in value) || !Array.isArray(value.value)) throw new TypeError("Invalid auto-save array");
+		return value.value.map(decodeValue);
+	}
+	if (type === "map") {
+		if (!("value" in value) || !Array.isArray(value.value)) throw new TypeError("Invalid auto-save map");
+		return new Map(value.value.map((entry) => {
+			if (!Array.isArray(entry) || entry.length !== 2) throw new TypeError("Invalid auto-save map entry");
+			return [decodeValue(entry[0]), decodeValue(entry[1])];
+		}));
+	}
+	if (type === "object") {
+		if (!("value" in value) || typeof value.value !== "object" || !value.value) throw new TypeError("Invalid auto-save object");
+		const decoded = Object.create(null);
+		for (const [key, entry] of Object.entries(value.value)) {
+			if (key === "__proto__" || key === "constructor" || key === "prototype") throw new TypeError("Invalid auto-save object key");
+			const decodedEntry = decodeValue(entry);
+			if (decodedEntry !== void 0) decoded[key] = decodedEntry;
+		}
+		return decoded;
+	}
+	throw new TypeError("Unknown auto-save encoded value");
+};
+const encodeAutoSaveDocument = (document) => {
+	const snapshot = {
+		...document,
+		originalBuffer: null
+	};
+	return { json: JSON.stringify(encodeValue(snapshot)) };
+};
+const encodeAutoSaveEnvelopeFromDocument = (document, savedAt) => `{"document":${document.json},"savedAt":${JSON.stringify(savedAt)},"version":2}`;
+const encodeAutoSaveEnvelope = (document, savedAt) => encodeAutoSaveEnvelopeFromDocument(encodeAutoSaveDocument(document), savedAt);
+const decodeAutoSaveEnvelope = (json) => {
+	try {
+		const parsed = JSON.parse(json);
+		if (typeof parsed !== "object" || !parsed || !("document" in parsed) || !("savedAt" in parsed) || !("version" in parsed)) return null;
+		if (parsed.version !== 2 || typeof parsed.savedAt !== "string" || !Number.isFinite(Date.parse(parsed.savedAt))) return null;
+		const document = decodeValue(parsed.document);
+		if (typeof document !== "object" || !document) return null;
+		if (!validateFolioDocumentModel(document).valid) return null;
+		return {
+			document,
+			savedAt: parsed.savedAt,
+			version: 2
+		};
+	} catch {
+		return null;
+	}
+};
+//#endregion
+export { AUTOSAVE_FORMAT_VERSION, decodeAutoSaveEnvelope, encodeAutoSaveDocument, encodeAutoSaveEnvelope, encodeAutoSaveEnvelopeFromDocument };