@stll/folio-core 0.31.1 → 0.32.0

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

@@ -274,7 +274,19 @@ type FolioAIEditSkipReason = "missingBlock" | "changedBlock" | "ambiguousFind" |
  * replace, or replaceBlock's `text` matches the live block.
  * Filtered out so the reviewer doesn't see "X → X" cards.
  */
-"noopOperation";
+"noopOperation" |
+/**
+ * The batch carried a `precondition.documentVersion` that no longer
+ * matches the document the surface holds; every operation in the batch
+ * is skipped. Re-read the document and regenerate the edits.
+ */
+"documentVersionMismatch" |
+/**
+ * The surface holds no editable document right now (no editor mounted,
+ * no entity to attach suggestions to); the operation was neither applied
+ * nor queued.
+ */
+"documentNotEditable";
 type FolioAIEditAppliedOperation = {
   id: string;
   commentId?: number;

package/dist/ai-edits/word-diff.js

@@ -1,5 +1,21 @@
 //#region src/ai-edits/word-diff.ts
-const tokenize = (s) => s.match(/\s+|\S+/gu) ?? [];
+const WHITESPACE = /\s/u;
+const tokenize = (s) => {
+	const tokens = [];
+	let tokenStart = 0;
+	let cursor = 0;
+	while (cursor < s.length) {
+		while (cursor < s.length && WHITESPACE.test(s.charAt(cursor))) cursor++;
+		if (cursor === s.length) break;
+		while (cursor < s.length && !WHITESPACE.test(s.charAt(cursor))) cursor++;
+		tokens.push(s.slice(tokenStart, cursor));
+		tokenStart = cursor;
+	}
+	const last = tokens.at(-1);
+	if (last === void 0) return s.length === 0 ? [] : [s];
+	if (tokenStart < s.length) tokens[tokens.length - 1] = last + s.slice(tokenStart);
+	return tokens;
+};
 /**
 * Cell budget for the O(n*m) word-diff DP table below, mirroring
 * `MAX_LCS_CELLS` in `version-comparison.ts`. `before`/`after` come from

package/dist/document-operations.d.ts

@@ -6,6 +6,15 @@ declare const FOLIO_DOCUMENT_OPERATION_TYPES: readonly ["replaceInBlock", "repla
 declare const FOLIO_DOCUMENT_OPERATION_MODES: readonly ["direct", "tracked-changes", "suggested"];
 declare const FOLIO_DOCUMENT_OPERATION_STORIES: readonly ["main", "header", "footer", "footnote", "endnote"];
 declare const FOLIO_DOCUMENT_OPERATION_PRECONDITIONS: readonly ["blockTextHash"];
+/**
+ * Batch-level preconditions. `documentVersion` is an opaque host token (an
+ * entity version id, a collaboration checkpoint) pinning the document the
+ * batch was authored against; whoever knows the live version (an agent
+ * bridge, a host applying the batch itself) compares it and skips the whole
+ * batch with `documentVersionMismatch` when it differs. The core apply path
+ * preserves the token but has no version to compare it to.
+ */
+declare const FOLIO_DOCUMENT_OPERATION_BATCH_PRECONDITIONS: readonly ["documentVersion"];
 declare const FOLIO_DOCUMENT_OPERATION_BATCH_MODES: readonly ["best-effort", "atomic"];
 type FolioDocumentOperation = FolioAIEditOperation;
 type FolioDocumentOperationMode = FolioAIEditApplyMode;
@@ -37,6 +46,7 @@ type FolioDocumentOperationCapabilities = {
   readonly batchModes: typeof FOLIO_DOCUMENT_OPERATION_BATCH_MODES;
   readonly dryRun: true;
   readonly preconditions: typeof FOLIO_DOCUMENT_OPERATION_PRECONDITIONS;
+  readonly batchPreconditions: typeof FOLIO_DOCUMENT_OPERATION_BATCH_PRECONDITIONS;
   readonly stories: typeof FOLIO_DOCUMENT_OPERATION_STORIES;
 };
 declare const getFolioDocumentOperationCapabilities: () => FolioDocumentOperationCapabilities;
@@ -54,16 +64,49 @@ declare class InvalidFolioDocumentOperationBatchError extends InvalidFolioDocume
   reason: string;
 }> {}
 declare const assertSupportedFolioDocumentOperationVersion: (value: unknown) => typeof FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION;
+/** Batch-level guard; see {@link FOLIO_DOCUMENT_OPERATION_BATCH_PRECONDITIONS}. */
+type FolioDocumentOperationBatchPrecondition = {
+  readonly documentVersion: string;
+};
 type FolioDocumentOperationBatch = {
   readonly version: typeof FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION;
   readonly operations: readonly FolioDocumentOperation[];
   readonly mode?: FolioDocumentOperationMode;
   readonly atomic?: boolean;
   readonly dryRun?: boolean;
+  readonly precondition?: FolioDocumentOperationBatchPrecondition;
 };
+/**
+ * Every property each operation type accepts on the wire; the parser
+ * rejects any other key. Exported so a lenient front door (an LLM tool
+ * decoder) can strip stray keys with the same knowledge instead of
+ * guessing, and so tool schemas can be derived from the contract.
+ */
+declare const FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE: Readonly<{
+  readonly replaceInBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "find", "replace", "comment"];
+  readonly replaceRange: readonly ["id", "type", "range", "severity", "area", "precondition", "suggestionId", "replace", "comment"];
+  readonly commentOnRange: readonly ["id", "type", "range", "severity", "area", "precondition", "comment"];
+  readonly formatRange: readonly ["id", "type", "range", "severity", "area", "precondition", "suggestionId", "formatting"];
+  readonly insertAfterBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "text", "inheritFormatting", "pageBreakBefore", "styleId", "comment"];
+  readonly insertBeforeBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "text", "inheritFormatting", "pageBreakBefore", "styleId", "comment"];
+  readonly replaceBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "text", "preserveFormatting", "styleId", "comment"];
+  readonly deleteBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "comment"];
+  readonly commentOnBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "quote", "comment"];
+  readonly insertSignatureTable: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "position", "parties", "comment"];
+  readonly insertTableRow: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "position", "cellTexts"];
+  readonly deleteTableRow: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId"];
+  readonly insertTableColumn: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "position", "cellTexts"];
+  readonly deleteTableColumn: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId"];
+  readonly mergeTableCells: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "endBlockId", "rowCount"];
+  readonly splitTableCell: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId"];
+}>;
 declare const parseFolioDocumentOperationBatch: (value: unknown) => FolioDocumentOperationBatch;
-type FolioDocumentOperationStatus = "committed" | "previewed" | "rejected";
-type FolioDocumentOperationRecovery = "refreshDocument" | "narrowMatch" | "changeMode" | "changeTarget" | "removeOperation" | "inspectBatch";
+/**
+ * `queued` is reported by a surface that routes the batch into a host-owned
+ * review queue instead of applying it; the core apply path never produces it.
+ */
+type FolioDocumentOperationStatus = "committed" | "previewed" | "rejected" | "queued";
+type FolioDocumentOperationRecovery = "refreshDocument" | "narrowMatch" | "changeMode" | "changeTarget" | "removeOperation" | "inspectBatch" | "retryLater";
 type FolioDocumentOperationIssue = {
   operationId: string;
   operationIndex: number;
@@ -152,9 +195,12 @@ type FolioDocumentOperationUndoResult = {
   undoHandle: FolioDocumentOperationUndoHandle;
   reason: FolioDocumentOperationUndoFailureReason;
 };
-type FolioDocumentOperationResult = {
+/** One operation a host surface accepted into its own review queue rather than applying. */
+type FolioDocumentOperationQueuedOperation = {
+  id: string;
+};
+type FolioDocumentOperationResultBase = {
   version: typeof FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION;
-  status: FolioDocumentOperationStatus;
   applied: FolioAIEditAppliedOperation[];
   skipped: FolioAIEditSkippedOperation[];
   issues: FolioDocumentOperationIssue[];
@@ -163,6 +209,19 @@ type FolioDocumentOperationResult = {
   /** Present when the execution surface can undo this committed batch. */
   undoHandle: FolioDocumentOperationUndoHandle | null;
 };
+/**
+ * Discriminated on `status`: only a host review-queue surface reports
+ * `"queued"`, and only that branch carries the `queued` list, so a consumer
+ * narrowing on the status can never meet a contradictory payload.
+ */
+type FolioDocumentOperationResult = (FolioDocumentOperationResultBase & {
+  status: "queued";
+  /** Operations parked in the host review queue instead of applied. */
+  queued: FolioDocumentOperationQueuedOperation[];
+}) | (FolioDocumentOperationResultBase & {
+  status: Exclude<FolioDocumentOperationStatus, "queued">;
+  queued?: never;
+});
 declare const getFolioDocumentOperationIssues: (operations: readonly FolioDocumentOperation[], skipped: readonly FolioAIEditSkippedOperation[]) => FolioDocumentOperationIssue[];
 /** Build deterministic affected-target receipts from operations and their applied entries. */
 declare const getFolioDocumentOperationReceipts: (operations: readonly FolioDocumentOperation[], applied: readonly FolioAIEditAppliedOperation[]) => FolioDocumentOperationReceipt[];
@@ -177,4 +236,4 @@ type ApplyFolioDocumentOperationsOptions = {
 };
 declare const applyFolioDocumentOperations: ({ view, snapshot, batch, story, author, createCommentId, createUndoHandle }: ApplyFolioDocumentOperationsOptions) => FolioDocumentOperationResult;
 //#endregion
-export { ApplyFolioDocumentOperationsOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationStatus, FolioDocumentOperationStory, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch };
+export { ApplyFolioDocumentOperationsOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_BATCH_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationBatchPrecondition, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationQueuedOperation, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationStatus, FolioDocumentOperationStory, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch };

package/dist/document-operations.js

@@ -33,6 +33,15 @@ const FOLIO_DOCUMENT_OPERATION_STORIES = Object.freeze([
 	"endnote"
 ]);
 const FOLIO_DOCUMENT_OPERATION_PRECONDITIONS = Object.freeze(["blockTextHash"]);
+/**
+* Batch-level preconditions. `documentVersion` is an opaque host token (an
+* entity version id, a collaboration checkpoint) pinning the document the
+* batch was authored against; whoever knows the live version (an agent
+* bridge, a host applying the batch itself) compares it and skips the whole
+* batch with `documentVersionMismatch` when it differs. The core apply path
+* preserves the token but has no version to compare it to.
+*/
+const FOLIO_DOCUMENT_OPERATION_BATCH_PRECONDITIONS = Object.freeze(["documentVersion"]);
 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"]);
@@ -64,6 +73,7 @@ const DOCUMENT_OPERATION_CAPABILITIES = Object.freeze({
 	batchModes: FOLIO_DOCUMENT_OPERATION_BATCH_MODES,
 	dryRun: true,
 	preconditions: FOLIO_DOCUMENT_OPERATION_PRECONDITIONS,
+	batchPreconditions: FOLIO_DOCUMENT_OPERATION_BATCH_PRECONDITIONS,
 	stories: FOLIO_DOCUMENT_OPERATION_STORIES
 });
 const getFolioDocumentOperationCapabilities = () => DOCUMENT_OPERATION_CAPABILITIES;
@@ -224,6 +234,94 @@ const COMMON_OPERATION_KEYS = [
 	"precondition",
 	"suggestionId"
 ];
+const RANGE_OPERATION_KEYS = [
+	"id",
+	"type",
+	"range",
+	"severity",
+	"area",
+	"precondition"
+];
+/**
+* Every property each operation type accepts on the wire; the parser
+* rejects any other key. Exported so a lenient front door (an LLM tool
+* decoder) can strip stray keys with the same knowledge instead of
+* guessing, and so tool schemas can be derived from the contract.
+*/
+const FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE = Object.freeze({
+	replaceInBlock: [
+		...COMMON_OPERATION_KEYS,
+		"find",
+		"replace",
+		"comment"
+	],
+	replaceRange: [
+		...RANGE_OPERATION_KEYS,
+		"suggestionId",
+		"replace",
+		"comment"
+	],
+	commentOnRange: [...RANGE_OPERATION_KEYS, "comment"],
+	formatRange: [
+		...RANGE_OPERATION_KEYS,
+		"suggestionId",
+		"formatting"
+	],
+	insertAfterBlock: [
+		...COMMON_OPERATION_KEYS,
+		"text",
+		"inheritFormatting",
+		"pageBreakBefore",
+		"styleId",
+		"comment"
+	],
+	insertBeforeBlock: [
+		...COMMON_OPERATION_KEYS,
+		"text",
+		"inheritFormatting",
+		"pageBreakBefore",
+		"styleId",
+		"comment"
+	],
+	replaceBlock: [
+		...COMMON_OPERATION_KEYS,
+		"text",
+		"preserveFormatting",
+		"styleId",
+		"comment"
+	],
+	deleteBlock: [...COMMON_OPERATION_KEYS, "comment"],
+	commentOnBlock: [
+		...COMMON_OPERATION_KEYS,
+		"quote",
+		"comment"
+	],
+	insertSignatureTable: [
+		...COMMON_OPERATION_KEYS,
+		"position",
+		"parties",
+		"comment"
+	],
+	insertTableRow: [
+		...COMMON_OPERATION_KEYS,
+		"position",
+		"cellTexts"
+	],
+	deleteTableRow: COMMON_OPERATION_KEYS,
+	insertTableColumn: [
+		...COMMON_OPERATION_KEYS,
+		"position",
+		"cellTexts"
+	],
+	deleteTableColumn: COMMON_OPERATION_KEYS,
+	mergeTableCells: [
+		...COMMON_OPERATION_KEYS,
+		"endBlockId",
+		"rowCount"
+	],
+	splitTableCell: COMMON_OPERATION_KEYS
+});
+const isFolioDocumentOperationType = (value) => Object.hasOwn(FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE, value);
 const parseSignatureParties = (value, path) => {
 	const parties = value["parties"];
 	if (!Array.isArray(parties)) return invalidBatch(`${path}.parties`, "expected an array");
@@ -248,6 +346,8 @@ const parseDocumentOperation = (value, index) => {
 	if (!isPlainObject(value)) return invalidBatch(path, "expected an object");
 	const id = readString(value, "id", path);
 	const type = readString(value, "type", path);
+	if (!isFolioDocumentOperationType(type)) return invalidBatch(`${path}.type`, `unsupported operation type "${type}"`);
+	assertAllowedKeys(value, path, FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE[type]);
 	const reviewMeta = readReviewMeta(value, path);
 	const precondition = readOptionalPrecondition(value, path);
 	const suggestionId = readOptionalString(value, "suggestionId", path);
@@ -257,37 +357,15 @@ const parseDocumentOperation = (value, index) => {
 		...precondition !== void 0 && { precondition },
 		...suggestionId !== void 0 && { suggestionId }
 	};
-	if (type === "replaceRange") {
-		assertAllowedKeys(value, path, [
-			"id",
-			"type",
-			"range",
-			"replace",
-			"comment",
-			"severity",
-			"area",
-			"precondition",
-			"suggestionId"
-		]);
-		return {
-			...operationMeta,
-			id,
-			type,
-			range: readTextRange(value, path),
-			replace: readString(value, "replace", path),
-			...comment !== void 0 && { comment }
-		};
-	}
+	if (type === "replaceRange") return {
+		...operationMeta,
+		id,
+		type,
+		range: readTextRange(value, path),
+		replace: readString(value, "replace", path),
+		...comment !== void 0 && { comment }
+	};
 	if (type === "commentOnRange") {
-		assertAllowedKeys(value, path, [
-			"id",
-			"type",
-			"range",
-			"comment",
-			"severity",
-			"area",
-			"precondition"
-		]);
 		if (comment === void 0) return invalidBatch(`${path}.comment`, "expected an object");
 		return {
 			...operationMeta,
@@ -297,52 +375,24 @@ const parseDocumentOperation = (value, index) => {
 			comment
 		};
 	}
-	if (type === "formatRange") {
-		assertAllowedKeys(value, path, [
-			"id",
-			"type",
-			"range",
-			"formatting",
-			"severity",
-			"area",
-			"precondition",
-			"suggestionId"
-		]);
-		return {
-			...operationMeta,
-			id,
-			type,
-			range: readTextRange(value, path),
-			formatting: readInlineFormatting(value, path)
-		};
-	}
+	if (type === "formatRange") return {
+		...operationMeta,
+		id,
+		type,
+		range: readTextRange(value, path),
+		formatting: readInlineFormatting(value, path)
+	};
 	const blockId = readString(value, "blockId", path);
-	if (type === "replaceInBlock") {
-		assertAllowedKeys(value, path, [
-			...COMMON_OPERATION_KEYS,
-			"find",
-			"replace",
-			"comment"
-		]);
-		return {
-			...operationMeta,
-			id,
-			type,
-			blockId,
-			find: readString(value, "find", path),
-			replace: readString(value, "replace", path),
-			...comment !== void 0 && { comment }
-		};
-	}
+	if (type === "replaceInBlock") return {
+		...operationMeta,
+		id,
+		type,
+		blockId,
+		find: readString(value, "find", path),
+		replace: readString(value, "replace", path),
+		...comment !== void 0 && { comment }
+	};
 	if (type === "insertAfterBlock" || type === "insertBeforeBlock") {
-		assertAllowedKeys(value, path, [
-			...COMMON_OPERATION_KEYS,
-			"text",
-			"inheritFormatting",
-			"pageBreakBefore",
-			"styleId",
-			"comment"
-		]);
 		const inheritFormatting = readOptionalBoolean(value, "inheritFormatting", path);
 		const pageBreakBefore = readOptionalBoolean(value, "pageBreakBefore", path);
 		const styleId = readOptionalString(value, "styleId", path);
@@ -359,13 +409,6 @@ const parseDocumentOperation = (value, index) => {
 		};
 	}
 	if (type === "replaceBlock") {
-		assertAllowedKeys(value, path, [
-			...COMMON_OPERATION_KEYS,
-			"text",
-			"preserveFormatting",
-			"styleId",
-			"comment"
-		]);
 		const preserveFormatting = readOptionalBoolean(value, "preserveFormatting", path);
 		const styleId = readOptionalString(value, "styleId", path);
 		return {
@@ -379,22 +422,14 @@ const parseDocumentOperation = (value, index) => {
 			...comment !== void 0 && { comment }
 		};
 	}
-	if (type === "deleteBlock") {
-		assertAllowedKeys(value, path, [...COMMON_OPERATION_KEYS, "comment"]);
-		return {
-			...operationMeta,
-			id,
-			type,
-			blockId,
-			...comment !== void 0 && { comment }
-		};
-	}
+	if (type === "deleteBlock") return {
+		...operationMeta,
+		id,
+		type,
+		blockId,
+		...comment !== void 0 && { comment }
+	};
 	if (type === "commentOnBlock") {
-		assertAllowedKeys(value, path, [
-			...COMMON_OPERATION_KEYS,
-			"quote",
-			"comment"
-		]);
 		if (comment === void 0) return invalidBatch(`${path}.comment`, "expected an object");
 		const quote = readOptionalString(value, "quote", path);
 		return {
@@ -407,12 +442,6 @@ const parseDocumentOperation = (value, index) => {
 		};
 	}
 	if (type === "insertSignatureTable") {
-		assertAllowedKeys(value, path, [
-			...COMMON_OPERATION_KEYS,
-			"position",
-			"parties",
-			"comment"
-		]);
 		const position = value["position"];
 		if (position !== void 0 && position !== "after" && position !== "before") return invalidBatch(`${path}.position`, "expected \"after\" or \"before\" when provided");
 		return {
@@ -426,11 +455,6 @@ const parseDocumentOperation = (value, index) => {
 		};
 	}
 	if (type === "insertTableRow") {
-		assertAllowedKeys(value, path, [
-			...COMMON_OPERATION_KEYS,
-			"position",
-			"cellTexts"
-		]);
 		const position = value["position"];
 		if (position !== void 0 && position !== "after" && position !== "before") return invalidBatch(`${path}.position`, "expected \"after\" or \"before\" when provided");
 		const cellTexts = readOptionalStringArray(value, "cellTexts", path);
@@ -443,21 +467,13 @@ const parseDocumentOperation = (value, index) => {
 			...cellTexts !== void 0 && { cellTexts }
 		};
 	}
-	if (type === "deleteTableRow") {
-		assertAllowedKeys(value, path, COMMON_OPERATION_KEYS);
-		return {
-			...operationMeta,
-			id,
-			type,
-			blockId
-		};
-	}
+	if (type === "deleteTableRow") return {
+		...operationMeta,
+		id,
+		type,
+		blockId
+	};
 	if (type === "insertTableColumn") {
-		assertAllowedKeys(value, path, [
-			...COMMON_OPERATION_KEYS,
-			"position",
-			"cellTexts"
-		]);
 		const position = value["position"];
 		if (position !== void 0 && position !== "after" && position !== "before") return invalidBatch(`${path}.position`, "expected \"after\" or \"before\" when provided");
 		const cellTexts = readOptionalStringArray(value, "cellTexts", path);
@@ -470,21 +486,13 @@ const parseDocumentOperation = (value, index) => {
 			...cellTexts !== void 0 && { cellTexts }
 		};
 	}
-	if (type === "deleteTableColumn") {
-		assertAllowedKeys(value, path, COMMON_OPERATION_KEYS);
-		return {
-			...operationMeta,
-			id,
-			type,
-			blockId
-		};
-	}
+	if (type === "deleteTableColumn") return {
+		...operationMeta,
+		id,
+		type,
+		blockId
+	};
 	if (type === "mergeTableCells") {
-		assertAllowedKeys(value, path, [
-			...COMMON_OPERATION_KEYS,
-			"endBlockId",
-			"rowCount"
-		]);
 		const endBlockId = readOptionalString(value, "endBlockId", path);
 		const rawRowCount = value["rowCount"];
 		if (endBlockId === void 0 === (rawRowCount === void 0)) return invalidBatch(path, "expected exactly one of endBlockId or rowCount");
@@ -508,16 +516,21 @@ const parseDocumentOperation = (value, index) => {
 			rowCount
 		};
 	}
-	if (type === "splitTableCell") {
-		assertAllowedKeys(value, path, COMMON_OPERATION_KEYS);
-		return {
-			...operationMeta,
-			id,
-			type,
-			blockId
-		};
-	}
-	return invalidBatch(`${path}.type`, `unsupported operation type "${type}"`);
+	return {
+		...operationMeta,
+		id,
+		type,
+		blockId
+	};
+};
+const readOptionalBatchPrecondition = (value) => {
+	const candidate = value["precondition"];
+	if (candidate === void 0) return;
+	if (!isPlainObject(candidate)) return invalidBatch("$.precondition", "expected an object when provided");
+	assertAllowedKeys(candidate, "$.precondition", FOLIO_DOCUMENT_OPERATION_BATCH_PRECONDITIONS);
+	const documentVersion = readString(candidate, "documentVersion", "$.precondition");
+	if (documentVersion.length === 0) return invalidBatch("$.precondition.documentVersion", "expected a non-empty string");
+	return { documentVersion };
 };
 const parseFolioDocumentOperationBatch = (value) => {
 	if (isParsedFolioDocumentOperationBatch(value)) return value;
@@ -527,7 +540,8 @@ const parseFolioDocumentOperationBatch = (value) => {
 		"operations",
 		"mode",
 		"atomic",
-		"dryRun"
+		"dryRun",
+		"precondition"
 	]);
 	const version = assertSupportedFolioDocumentOperationVersion(value["version"]);
 	const operations = value["operations"];
@@ -536,6 +550,7 @@ const parseFolioDocumentOperationBatch = (value) => {
 	if (mode !== void 0 && mode !== "direct" && mode !== "tracked-changes" && mode !== "suggested") return invalidBatch("$.mode", "expected \"direct\", \"tracked-changes\", or \"suggested\" when provided");
 	const atomic = readOptionalBoolean(value, "atomic", "$");
 	const dryRun = readOptionalBoolean(value, "dryRun", "$");
+	const precondition = readOptionalBatchPrecondition(value);
 	const parsedOperations = operations.map(parseDocumentOperation);
 	const operationIds = /* @__PURE__ */ new Set();
 	for (const [index, operation] of parsedOperations.entries()) {
@@ -547,7 +562,8 @@ const parseFolioDocumentOperationBatch = (value) => {
 		operations: parsedOperations,
 		...mode !== void 0 && { mode },
 		...atomic !== void 0 && { atomic },
-		...dryRun !== void 0 && { dryRun }
+		...dryRun !== void 0 && { dryRun },
+		...precondition !== void 0 && { precondition }
 	};
 	freezeParsedValue(parsedBatch);
 	parsedFolioDocumentOperationBatches.add(parsedBatch);
@@ -564,7 +580,9 @@ const recoveryByReason = {
 	preconditionFailed: "refreshDocument",
 	staleRange: "refreshDocument",
 	emptyOperation: "removeOperation",
-	noopOperation: "removeOperation"
+	noopOperation: "removeOperation",
+	documentVersionMismatch: "refreshDocument",
+	documentNotEditable: "retryLater"
 };
 const getFolioDocumentOperationIssues = (operations, skipped) => {
 	const indexById = /* @__PURE__ */ new Map();
@@ -780,4 +798,4 @@ const applyFolioDocumentOperations = ({ view, snapshot, batch, story = "main", a
 	};
 };
 //#endregion
-export { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch };
+export { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_BATCH_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch };

package/dist/docx/server/boundedArchive.d.ts

@@ -1,4 +1,16 @@
+import JSZip from "jszip";
 //#region src/docx/server/boundedArchive.d.ts
+declare module "jszip" {
+  interface JSZipObject {
+    /**
+     * Chunked read of the entry content, missing from the published typings.
+     * `nodeStream` is this stream wrapped in a Node.js `Readable`, which
+     * browsers and web workers cannot provide; the stream itself is
+     * platform-neutral.
+     */
+    internalStream(type: "uint8array"): JSZip.JSZipStreamHelper<Uint8Array>;
+  }
+}
 declare const DOCX_MAX_ENTRY_BYTES: number;
 declare const DOCX_MAX_TOTAL_BYTES: number;
 declare const DOCX_MAX_ENTRIES = 4096;

package/dist/docx/server/boundedArchive.js

@@ -7,20 +7,34 @@ const DOCX_MAX_ENTRIES = 4096;
 const DOCX_MAX_INPUT_BYTES = 50 * 1024 * 1024;
 /** Error raised when a DOCX archive cannot be loaded within configured limits. */
 var DocxArchiveError = class extends TaggedError("DocxArchiveError") {};
+const concatChunks = (chunks) => {
+	let totalBytes = 0;
+	for (const chunk of chunks) totalBytes += chunk.length;
+	const merged = new Uint8Array(totalBytes);
+	let offset = 0;
+	for (const chunk of chunks) {
+		merged.set(chunk, offset);
+		offset += chunk.length;
+	}
+	return merged;
+};
+/**
+* Accumulate an entry chunk by chunk, checking both caps before each chunk is
+* retained. Pausing the stream abandons a decompression bomb mid-inflate, so
+* the caps bound memory instead of merely reporting the overrun afterwards.
+*/
 const collectStream = async ({ stream, maxEntryBytes, remainingBytes, maxTotalBytes, path }) => await new Promise((resolve, reject) => {
 	const chunks = [];
 	let entryBytes = 0;
 	const fail = (reason, message) => {
-		const destroy = Reflect.get(stream, "destroy");
-		if (typeof destroy === "function") Reflect.apply(destroy, stream, []);
+		stream.pause();
 		reject(new DocxArchiveError({
 			message,
 			reason
 		}));
 	};
 	stream.on("data", (chunk) => {
-		const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
-		entryBytes += bytes.length;
+		entryBytes += chunk.length;
 		if (entryBytes > maxEntryBytes) {
 			fail("entry-too-large", `DOCX entry "${path}" exceeded the ${maxEntryBytes}-byte limit`);
 			return;
@@ -29,10 +43,8 @@ const collectStream = async ({ stream, maxEntryBytes, remainingBytes, maxTotalBy
 			fail("total-too-large", `DOCX archive exceeded the ${maxTotalBytes}-byte cumulative limit while reading "${path}"`);
 			return;
 		}
-		chunks.push(bytes);
-	});
-	stream.on("end", () => resolve(Buffer.concat(chunks)));
-	stream.on("error", reject);
+		chunks.push(chunk);
+	}).on("end", () => resolve(concatChunks(chunks))).on("error", reject).resume();
 });
 const getDeclaredUncompressedBytes = (entry) => {
 	const data = "_data" in entry ? entry._data : void 0;
@@ -116,15 +128,15 @@ const loadDocxArchive = async (bytes, options = {}) => {
 		const work = async () => {
 			const entry = zip.file(path);
 			if (!entry) return null;
-			const buffer = await collectStream({
-				stream: entry.nodeStream("nodebuffer"),
+			const content = await collectStream({
+				stream: entry.internalStream("uint8array"),
 				maxEntryBytes: Math.min(requestedMaxBytes, maxEntryBytes),
 				remainingBytes: maxTotalBytes - totalBytesRead,
 				maxTotalBytes,
 				path
 			});
-			totalBytesRead += buffer.length;
-			return buffer;
+			totalBytesRead += content.length;
+			return content;
 		};
 		const next = readChain.then(work, work);
 		readChain = next.then(() => void 0, () => void 0);
@@ -138,13 +150,10 @@ const loadDocxArchive = async (bytes, options = {}) => {
 			declaredUncompressedBytes: getDeclaredUncompressedBytes(entry)
 		}))),
 		async readEntryString(path) {
-			const buffer = await readEntry(path);
-			return buffer === null ? null : buffer.toString("utf-8");
+			const content = await readEntry(path);
+			return content === null ? null : new TextDecoder("utf-8", { ignoreBOM: true }).decode(content);
 		},
-		async readEntryUint8(path, readOptions) {
-			const buffer = await readEntry(path, readOptions);
-			return buffer === null ? null : new Uint8Array(buffer);
-		}
+		readEntryUint8: readEntry
 	};
 };
 //#endregion

package/dist/docx/server/createBilingualDocument.js

@@ -86,6 +86,7 @@ function createBilingualDocument(source, options) {
 		cloner
 	});
 	const paraIds = createParaIdMinter(collectPackageParaIds(source.package));
+	const bookmarkIds = createBookmarkIdMinter(source.package);
 	const rows = [];
 	const content = [];
 	let sectionRows = [];
@@ -97,7 +98,7 @@ function createBilingualDocument(source, options) {
 	const copyParagraph = (paragraph) => {
 		const targetParaId = paraIds.mint(paragraph.paraId);
 		return {
-			copy: cloneParagraphForTarget(paragraph, targetParaId, styleCloner, cloner),
+			copy: cloneParagraphForTarget(paragraph, targetParaId, styleCloner, cloner, bookmarkIds),
 			ref: {
 				sourceParaId: paragraph.paraId,
 				targetParaId,
@@ -152,7 +153,8 @@ function createBilingualDocument(source, options) {
 				editableParagraphIds: options.editableParagraphIds,
 				paraIds,
 				styleCloner,
-				cloner
+				cloner,
+				bookmarkIds
 			});
 			rows.push({
 				kind: "table",
@@ -362,7 +364,7 @@ const createStyleCloner = ({ styleById, suffix, cloner }) => {
 		})
 	};
 };
-const cloneParagraphForTarget = (paragraph, targetParaId, styleCloner, cloner) => {
+const cloneParagraphForTarget = (paragraph, targetParaId, styleCloner, cloner, bookmarkIds) => {
 	const { textId: _textId, sectionProperties: _sectionProperties, ...rest } = paragraph;
 	const formatting = paragraph.formatting;
 	const nextFormatting = formatting && {
@@ -379,12 +381,56 @@ const cloneParagraphForTarget = (paragraph, targetParaId, styleCloner, cloner) =
 	};
 	return {
 		...rest,
-		content: structuredClone(paragraph.content),
+		content: remapClonedBookmarkIds(structuredClone(paragraph.content), bookmarkIds),
 		paraId: targetParaId,
 		...nextFormatting && { formatting: nextFormatting },
 		...paragraph.listRendering && { listRendering: remapListRendering(paragraph.listRendering, cloner) }
 	};
 };
+const createBookmarkIdMinter = (source) => {
+	let nextId = 0;
+	const remapped = /* @__PURE__ */ new Map();
+	const visit = (value, seen) => {
+		if (typeof value !== "object" || value === null || seen.has(value)) return;
+		seen.add(value);
+		if (Array.isArray(value)) {
+			value.forEach((item) => visit(item, seen));
+			return;
+		}
+		const record = value;
+		if (record["type"] === "bookmarkStart" || record["type"] === "bookmarkEnd") {
+			const id = record["id"];
+			if (typeof id === "number") nextId = Math.max(nextId, id + 1);
+		}
+		Object.values(record).forEach((item) => visit(item, seen));
+	};
+	visit(source, /* @__PURE__ */ new Set());
+	return { mint: (sourceId) => {
+		const existing = remapped.get(sourceId);
+		if (existing !== void 0) return existing;
+		const id = nextId++;
+		remapped.set(sourceId, id);
+		return id;
+	} };
+};
+const remapClonedBookmarkIds = (value, bookmarkIds) => {
+	const visit = (item, seen) => {
+		if (typeof item !== "object" || item === null || seen.has(item)) return;
+		seen.add(item);
+		if (Array.isArray(item)) {
+			item.forEach((child) => visit(child, seen));
+			return;
+		}
+		const record = item;
+		if (record["type"] === "bookmarkStart" || record["type"] === "bookmarkEnd") {
+			const id = record["id"];
+			if (typeof id === "number") record["id"] = bookmarkIds.mint(id);
+		}
+		Object.values(record).forEach((child) => visit(child, seen));
+	};
+	visit(value, /* @__PURE__ */ new Set());
+	return value;
+};
 const remapListRendering = (rendering, cloner) => {
 	const clonedAbstract = rendering.abstractNumId === void 0 ? void 0 : cloner.clonedAbstractNumId(rendering.abstractNumId);
 	return {
@@ -399,7 +445,7 @@ const collectTableParagraphs = (table) => {
 	else out.push(...collectTableParagraphs(item));
 	return out;
 };
-const cloneTableForTarget = ({ table, editableParagraphIds, paraIds, styleCloner, cloner }) => {
+const cloneTableForTarget = ({ table, editableParagraphIds, paraIds, styleCloner, cloner, bookmarkIds }) => {
 	const paragraphs = [];
 	const cloneTable = (source) => ({
 		...structuredClone(source),
@@ -410,7 +456,7 @@ const cloneTableForTarget = ({ table, editableParagraphIds, paraIds, styleCloner
 				content: cell.content.map((item) => {
 					if (item.type === "table") return cloneTable(item);
 					const targetParaId = paraIds.mint(item.paraId);
-					const copy = cloneParagraphForTarget(item, targetParaId, styleCloner, cloner);
+					const copy = cloneParagraphForTarget(item, targetParaId, styleCloner, cloner, bookmarkIds);
 					if (item.paraId !== void 0 && editableParagraphIds.has(item.paraId)) paragraphs.push({
 						sourceParaId: item.paraId,
 						targetParaId,

package/dist/server.d.ts

@@ -1,5 +1,5 @@
 import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditSnapshot, FolioAIInlineFormatting, FolioAITextRangeHandle, FolioDocumentNavigationTarget, FolioDocumentOutline, FolioDocumentOutlineEntry, FolioDocumentSection, FolioDocumentSectionHandle, FolioDocumentSectionReadResult } from "./ai-edits/types.js";
-import { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationStatus, FolioDocumentOperationStory, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "./document-operations.js";
+import { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_BATCH_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationBatchPrecondition, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationQueuedOperation, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationStatus, FolioDocumentOperationStory, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "./document-operations.js";
 import { FolioReviewChange, FolioReviewChangeKind } from "./ai-edits/read.js";
 import { ApplyFolioAIEditsToBufferOptions, ApplyFolioAIEditsToBufferResult, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioApplyDocumentOperationsOptions, FolioApplyDocumentOperationsToStoryOptions, FolioApplyOperationsOptions, FolioDocumentStory, FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, FolioDocxReviewer, FolioDocxReviewerOptions, FolioEditableDocumentStoryHandle, FolioReadReviewedStoryOptions, FolioResolveReviewedStoryOptions, FolioResolvedReviewedView, FolioReviewChangeFilter, FolioReviewComment, FolioReviewCommentFilter, FolioReviewCommentReply, FolioReviewReplyInput, FolioReviewedStory, FolioReviewedView, UnsupportedFolioReviewedViewError, applyFolioAIEditsToBuffer, isFolioResolvedReviewedView, isFolioReviewedView } from "./ai-edits/headless.js";
 import { createFolioAITextRangeHandle, hashFolioAIBlockText, normalizeFolioAIBlockText } from "./ai-edits/snapshot.js";
@@ -27,4 +27,4 @@ import { FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_E
 import { FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES, FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME, FOLIO_YJS_UPDATE_MAX_BYTES, FolioYjsDocxMaterializationError, FolioYjsDocxMaterializationErrorCode, MaterializeYjsDocxOptions, materializeYjsDocx } from "./docx/server/materializeYjsDocx.js";
 import { GenerateRedlineDocxOptions, GenerateRedlineDocxResult, GenerateRedlineUnprocessedStory, InvalidGenerateRedlineDocxOptionsError, generateRedlineDocx } from "./redline.js";
 import { FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FolioBlockDiff, FolioCompareDocxVersionsOptions, FolioDocumentMetadataValue, FolioFormatProperty, FolioMetadataDiff, FolioStoryDiff, FolioVersionBlockHandle, FolioVersionComparisonPrivacyTransform, FolioVersionComparisonScope, FolioVersionDiff, FolioVersionDiffPrivacyOptions, FolioVersionDiffPrivacyReport, FolioVersionDiffSegment, FolioVersionDiffSummaryCounts, InvalidFolioVersionComparisonOptionsError, applyFolioVersionDiffPrivacy, compareDocxVersions, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope } from "./version-comparison.js";
-export { type ApplyDocxXmlPatchProposalArgs, type ApplyFolioAIEditsToBufferOptions, type ApplyFolioAIEditsToBufferResult, BILINGUAL_TABLE_LAYOUTS, type BilingualBorders, type BilingualParagraphRef, type BilingualRow, type BilingualRowKind, type BilingualTableLayout, type BilingualTableParagraphRef, type CreateBilingualDocumentOptions, type CreateBilingualDocumentResult, type CreateBilingualDocxOptions, type CreateBilingualDocxResult, type CreateCommentReplyInput, type CreateEmptyDocumentOptions, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, type DeriveBlockIdInput, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, DocxArchiveError, type DocxArchiveOptions, type DocxParagraphSource, type DocxTableRowKind, type DocxTableRowPosition, EnsureParaIdsError, type EnsureParaIdsOptions, type EnsureParaIdsResult, type EvaluateDocxXmlPatchProposalArgs, type ExtractDocumentStyleSetOptions, type ExtractedDocxParagraph, type ExtractedDocxTableCell, type ExtractedDocxTableCellParagraph, type ExtractedDocxText, FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES, FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME, FOLIO_YJS_UPDATE_MAX_BYTES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditSnapshot, type FolioAIInlineFormatting, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsOptions, type FolioApplyDocumentOperationsToStoryOptions, type FolioApplyOperationsOptions, type FolioBlockDiff, type FolioBlockId, type FolioCompareDocxVersionsOptions, type FolioDocumentMetadataProperty, type FolioDocumentMetadataValue, type FolioDocumentNavigationTarget, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentOutline, type FolioDocumentOutlineEntry, FolioDocumentPrivacyArchiveError, type FolioDocumentPrivacyOptions, type FolioDocumentPrivacyReport, type FolioDocumentPrivacyTransform, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, type FolioDocxConformanceCheck, type FolioDocxConformanceCheckId, type FolioDocxConformanceCheckStatus, type FolioDocxConformanceIssue, type FolioDocxConformanceIssueCode, type FolioDocxConformanceReport, type FolioDocxConformanceStatus, type FolioDocxInspectedXmlPart, type FolioDocxPackageInspection, FolioDocxPackageInspectionError, type FolioDocxPackageInspectionErrorCode, type FolioDocxPackageInspectionLimits, type FolioDocxPackagePart, type FolioDocxPackagePartKind, type FolioDocxPreparedXmlReplacement, FolioDocxReviewer, type FolioDocxReviewerOptions, type FolioDocxXmlPatchApplication, FolioDocxXmlPatchApplicationError, type FolioDocxXmlPatchApplicationReceipt, type FolioDocxXmlPatchProposal, type FolioDocxXmlPatchProposalEvaluation, type FolioDocxXmlPatchProposalIssue, type FolioDocxXmlPatchProposalIssueCode, type FolioDocxXmlPatchProposalLimits, type FolioDocxXmlReplacement, type FolioEditableDocumentStoryHandle, type FolioFormatProperty, type FolioMetadataDiff, type FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeFilter, type FolioReviewChangeKind, type FolioReviewComment, type FolioReviewCommentFilter, type FolioReviewCommentReply, type FolioReviewReplyInput, type FolioReviewedStory, type FolioReviewedView, type FolioStoryDiff, type FolioVersionBlockHandle, type FolioVersionComparisonPrivacyTransform, type FolioVersionComparisonScope, type FolioVersionDiff, type FolioVersionDiffPrivacyOptions, type FolioVersionDiffPrivacyReport, type FolioVersionDiffSegment, type FolioVersionDiffSummaryCounts, FolioYjsDocxMaterializationError, type FolioYjsDocxMaterializationErrorCode, type GenerateRedlineDocxOptions, type GenerateRedlineDocxResult, type GenerateRedlineUnprocessedStory, HEADING_LEVELS, type HeadingLevel, type InspectDocxPackageOptions, InvalidBilingualDocumentOptionsError, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioReportBuilderOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, type MaterializeYjsDocxOptions, type ParseOptions, type RewriteDocxMetadataPrivacyResult, STELLA_STYLE_SET_NAME, type TableCellSpec, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, type ValidateDocxConformanceOptions, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, bookmark, compareDocxVersions, createBilingualDocument, createBilingualDocx, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, createTableOfContentsField, deriveBlockId, docxToMarkdown, endnote, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, hashFolioAIBlockText, heading, hyperlink, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, materializeYjsDocx, normalizeFolioAIBlockText, pageBreak, paragraph, parseDocx, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readBilingualDocument, readBilingualDocx, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, run, table, validateDocxConformance };
+export { type ApplyDocxXmlPatchProposalArgs, type ApplyFolioAIEditsToBufferOptions, type ApplyFolioAIEditsToBufferResult, BILINGUAL_TABLE_LAYOUTS, type BilingualBorders, type BilingualParagraphRef, type BilingualRow, type BilingualRowKind, type BilingualTableLayout, type BilingualTableParagraphRef, type CreateBilingualDocumentOptions, type CreateBilingualDocumentResult, type CreateBilingualDocxOptions, type CreateBilingualDocxResult, type CreateCommentReplyInput, type CreateEmptyDocumentOptions, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, type DeriveBlockIdInput, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, DocxArchiveError, type DocxArchiveOptions, type DocxParagraphSource, type DocxTableRowKind, type DocxTableRowPosition, EnsureParaIdsError, type EnsureParaIdsOptions, type EnsureParaIdsResult, type EvaluateDocxXmlPatchProposalArgs, type ExtractDocumentStyleSetOptions, type ExtractedDocxParagraph, type ExtractedDocxTableCell, type ExtractedDocxTableCellParagraph, type ExtractedDocxText, FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_BATCH_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES, FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME, FOLIO_YJS_UPDATE_MAX_BYTES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditSnapshot, type FolioAIInlineFormatting, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsOptions, type FolioApplyDocumentOperationsToStoryOptions, type FolioApplyOperationsOptions, type FolioBlockDiff, type FolioBlockId, type FolioCompareDocxVersionsOptions, type FolioDocumentMetadataProperty, type FolioDocumentMetadataValue, type FolioDocumentNavigationTarget, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationBatchPrecondition, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationQueuedOperation, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentOutline, type FolioDocumentOutlineEntry, FolioDocumentPrivacyArchiveError, type FolioDocumentPrivacyOptions, type FolioDocumentPrivacyReport, type FolioDocumentPrivacyTransform, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, type FolioDocxConformanceCheck, type FolioDocxConformanceCheckId, type FolioDocxConformanceCheckStatus, type FolioDocxConformanceIssue, type FolioDocxConformanceIssueCode, type FolioDocxConformanceReport, type FolioDocxConformanceStatus, type FolioDocxInspectedXmlPart, type FolioDocxPackageInspection, FolioDocxPackageInspectionError, type FolioDocxPackageInspectionErrorCode, type FolioDocxPackageInspectionLimits, type FolioDocxPackagePart, type FolioDocxPackagePartKind, type FolioDocxPreparedXmlReplacement, FolioDocxReviewer, type FolioDocxReviewerOptions, type FolioDocxXmlPatchApplication, FolioDocxXmlPatchApplicationError, type FolioDocxXmlPatchApplicationReceipt, type FolioDocxXmlPatchProposal, type FolioDocxXmlPatchProposalEvaluation, type FolioDocxXmlPatchProposalIssue, type FolioDocxXmlPatchProposalIssueCode, type FolioDocxXmlPatchProposalLimits, type FolioDocxXmlReplacement, type FolioEditableDocumentStoryHandle, type FolioFormatProperty, type FolioMetadataDiff, type FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeFilter, type FolioReviewChangeKind, type FolioReviewComment, type FolioReviewCommentFilter, type FolioReviewCommentReply, type FolioReviewReplyInput, type FolioReviewedStory, type FolioReviewedView, type FolioStoryDiff, type FolioVersionBlockHandle, type FolioVersionComparisonPrivacyTransform, type FolioVersionComparisonScope, type FolioVersionDiff, type FolioVersionDiffPrivacyOptions, type FolioVersionDiffPrivacyReport, type FolioVersionDiffSegment, type FolioVersionDiffSummaryCounts, FolioYjsDocxMaterializationError, type FolioYjsDocxMaterializationErrorCode, type GenerateRedlineDocxOptions, type GenerateRedlineDocxResult, type GenerateRedlineUnprocessedStory, HEADING_LEVELS, type HeadingLevel, type InspectDocxPackageOptions, InvalidBilingualDocumentOptionsError, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioReportBuilderOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, type MaterializeYjsDocxOptions, type ParseOptions, type RewriteDocxMetadataPrivacyResult, STELLA_STYLE_SET_NAME, type TableCellSpec, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, type ValidateDocxConformanceOptions, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, bookmark, compareDocxVersions, createBilingualDocument, createBilingualDocx, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, createTableOfContentsField, deriveBlockId, docxToMarkdown, endnote, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, hashFolioAIBlockText, heading, hyperlink, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, materializeYjsDocx, normalizeFolioAIBlockText, pageBreak, paragraph, parseDocx, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readBilingualDocument, readBilingualDocx, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, run, table, validateDocxConformance };

package/dist/server.js

@@ -1,7 +1,7 @@
 import { FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioDocumentStoryNotFoundError, FolioDocxReviewer, UnsupportedFolioReviewedViewError, applyFolioAIEditsToBuffer, isFolioResolvedReviewedView, isFolioReviewedView } from "./ai-edits/headless.js";
 import { getFolioDocumentOutline, readFolioDocumentSection } from "./ai-edits/scoped-reading.js";
 import { createFolioAITextRangeHandle, hashFolioAIBlockText, normalizeFolioAIBlockText } from "./ai-edits/snapshot.js";
-import { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "./document-operations.js";
+import { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_BATCH_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "./document-operations.js";
 import { EnsureParaIdsError, ensureParaIds } from "./docx/ensureParaIds.js";
 import { FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FolioDocumentPrivacyArchiveError, InvalidFolioDocumentPrivacyOptionsError, isFolioDocumentPrivacyTransform, rewriteDocxMetadataPrivacy } from "./docx/metadataPrivacy.js";
 import { parseDocx } from "./docx/parser.js";
@@ -25,4 +25,4 @@ import { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION } from "./style-set
 import { deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
 import { createEmptyDocument } from "./utils/createDocument.js";
 import { FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, InvalidFolioVersionComparisonOptionsError, applyFolioVersionDiffPrivacy, compareDocxVersions, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope } from "./version-comparison.js";
-export { BILINGUAL_TABLE_LAYOUTS, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DocxArchiveError, EnsureParaIdsError, FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES, FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME, FOLIO_YJS_UPDATE_MAX_BYTES, FolioDocumentPrivacyArchiveError, FolioDocumentStoryNotFoundError, FolioDocxPackageInspectionError, FolioDocxReviewer, FolioDocxXmlPatchApplicationError, FolioYjsDocxMaterializationError, HEADING_LEVELS, InvalidBilingualDocumentOptionsError, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioReportBuilderOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, bookmark, compareDocxVersions, createBilingualDocument, createBilingualDocx, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, createTableOfContentsField, deriveBlockId, docxToMarkdown, endnote, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, hashFolioAIBlockText, heading, hyperlink, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, materializeYjsDocx, normalizeFolioAIBlockText, pageBreak, paragraph, parseDocx, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readBilingualDocument, readBilingualDocx, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, run, table, validateDocxConformance };
+export { BILINGUAL_TABLE_LAYOUTS, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DocxArchiveError, EnsureParaIdsError, FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_BATCH_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FOLIO_DOCX_XML_PATCH_PROPOSAL_DEFAULTS, FOLIO_DOCX_XML_PATCH_PROPOSAL_ISSUE_CODES, FOLIO_DOCX_XML_PATCH_PROPOSAL_PROFILE, FOLIO_DOCX_XML_PATCH_PROPOSAL_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES, FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME, FOLIO_YJS_UPDATE_MAX_BYTES, FolioDocumentPrivacyArchiveError, FolioDocumentStoryNotFoundError, FolioDocxPackageInspectionError, FolioDocxReviewer, FolioDocxXmlPatchApplicationError, FolioYjsDocxMaterializationError, HEADING_LEVELS, InvalidBilingualDocumentOptionsError, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioReportBuilderOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, bookmark, compareDocxVersions, createBilingualDocument, createBilingualDocx, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, createTableOfContentsField, deriveBlockId, docxToMarkdown, endnote, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, hashFolioAIBlockText, heading, hyperlink, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, materializeYjsDocx, normalizeFolioAIBlockText, pageBreak, paragraph, parseDocx, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readBilingualDocument, readBilingualDocx, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, run, table, validateDocxConformance };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.31.1",
+  "version": "0.32.0",
   "description": "Headless, framework-neutral core of folio: the OOXML (.docx) parser, document model, ProseMirror integration, and page-layout engine. No React.",
   "keywords": [
     "document-model",