@stll/folio-core 0.31.2 → 0.32.1

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/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/markdown/fromMarkdown.js

@@ -1,227 +1,24 @@
 import { createEmptyDocument } from "../utils/createDocument.js";
-import { sanitizeExternalUrl } from "../utils/urlSecurity.js";
-import { marked } from "marked";
+import { compileMarkdownToContent } from "@stll/docx-core";
 //#region src/markdown/fromMarkdown.ts
 /**
 * Markdown → DOCX-document import — the inverse of {@link toMarkdown} and the
-* second half of the skills bridge. Parses the GFM subset skill bodies use
-* (headings, paragraphs, bold/italic/strike, inline code, bullet + ordered
-* lists incl. nesting, pipe tables, blockquotes, links) into the docx
-* `Document` model so a skill's markdown can be edited in the Folio editor and
-* re-exported with {@link toMarkdown} without drift.
+* second half of the skills bridge. The parsing lives in `@stll/docx-core`
+* (`compileMarkdownToContent`), the same GFM reader the legal-source compiler
+* uses; this wrapper only places the blocks into an editor-ready `Document`.
 *
 * Round-trip notes:
-* - Lists are emitted as real list paragraphs (`listRendering`), so the editor
-*   shows a marker and {@link toMarkdown} re-derives `- ` / `1. ` rather than
-*   leaking a literal bullet glyph into the text.
-* - Inline code uses `Courier New` — a whitelisted monospace family that
-*   {@link toMarkdown} infers back to a backtick span (Folio renders it via its
-*   bundled Cousine substitute).
+* - Lists arrive as real list paragraphs (`listRendering` plus `numPr`) with a
+*   matching `document.package.numbering`, so the editor shows a marker and
+*   {@link toMarkdown} re-derives `- ` / `1. ` rather than leaking a literal
+*   bullet glyph. Merging this content onto another document that has its own
+*   numbering (e.g. a styled preset) needs `mergeDocumentContent` to renumber
+*   the two numbering namespaces apart.
 * - Markdown carries no page geometry, so the section is flattened to a
 *   continuous, header/footer-free band (a skill body is a document, not a
 *   Word page). Headers/footers live outside `document.content` and are never
 *   produced here.
-* - Every markdown list also gets a matching `w:abstractNum`/`w:num` pair in
-*   `document.package.numbering` (see {@link buildNumbering}), so the result
-*   is self-consistent and `createDocx` never has to fail with a missing
-*   numbering definition. Merging this content onto another document that
-*   has its own numbering (e.g. a styled preset) needs `mergeDocumentContent`
-*   to renumber the two numbering namespaces apart — appending
-*   `document.package.document.content` directly can collide.
 */
-const MONO_FONT = {
-	ascii: "Courier New",
-	hAnsi: "Courier New"
-};
-const isTokenType = (token, type) => token.type === type;
-const textRun = (text, fmt = {}) => {
-	const formatting = {
-		...fmt.bold ? { bold: true } : {},
-		...fmt.italic ? { italic: true } : {},
-		...fmt.strike ? { strike: true } : {},
-		...fmt.mono ? { fontFamily: MONO_FONT } : {}
-	};
-	const segments = text.split("\n");
-	const content = [];
-	for (const [index, segment] of segments.entries()) {
-		if (index > 0) content.push({ type: "break" });
-		if (segment.length > 0) content.push({
-			type: "text",
-			text: segment
-		});
-	}
-	if (content.length === 0) content.push({
-		type: "text",
-		text: ""
-	});
-	return {
-		type: "run",
-		formatting,
-		content
-	};
-};
-const sanitizeMarkdownHref = (rawHref) => {
-	const trimmed = rawHref.trim();
-	if (!trimmed) return;
-	if (trimmed.startsWith("#")) {
-		const anchor = trimmed.slice(1);
-		if (!anchor || hasUnsafeAnchorCharacter(anchor)) return;
-		return `#${anchor}`;
-	}
-	return sanitizeExternalUrl(trimmed);
-};
-const hasUnsafeAnchorCharacter = (anchor) => {
-	for (const char of anchor) {
-		const codePoint = char.codePointAt(0) ?? 0;
-		if (codePoint <= 32 || codePoint === 127 || char.trim() === "") return true;
-	}
-	return false;
-};
-const inlineToRuns = (tokens, fallback, base) => {
-	if (!tokens || tokens.length === 0) return [textRun(fallback, base)];
-	const runs = [];
-	for (const token of tokens) if (isTokenType(token, "strong")) runs.push(...inlineToRuns(token.tokens, token.text, {
-		...base,
-		bold: true
-	}));
-	else if (isTokenType(token, "em")) runs.push(...inlineToRuns(token.tokens, token.text, {
-		...base,
-		italic: true
-	}));
-	else if (isTokenType(token, "del")) runs.push(...inlineToRuns(token.tokens, token.text, {
-		...base,
-		strike: true
-	}));
-	else if (isTokenType(token, "codespan")) runs.push(textRun(token.text, {
-		...base,
-		mono: true
-	}));
-	else if (isTokenType(token, "link")) {
-		const children = inlineToRuns(token.tokens, token.text, base).filter((child) => child.type === "run");
-		const href = sanitizeMarkdownHref(token.href);
-		const linkChildren = children.length > 0 ? children : [textRun(token.text, base)];
-		if (!href) {
-			runs.push(...linkChildren);
-			continue;
-		}
-		const anchor = href.startsWith("#") ? href.slice(1) : void 0;
-		runs.push({
-			type: "hyperlink",
-			href,
-			...anchor ? { anchor } : {},
-			children: linkChildren
-		});
-	} else if (isTokenType(token, "paragraph")) runs.push(...inlineToRuns(token.tokens, token.text, base));
-	else if (token.type === "br") runs.push({
-		type: "run",
-		content: [{ type: "break" }]
-	});
-	else if (token.type === "space") {
-		if (runs.length > 0 && token.raw.includes("\n")) runs.push(textRun("\n", base));
-	} else if (isTokenType(token, "text")) {
-		const nested = token.tokens;
-		if (nested && nested.length > 0) runs.push(...inlineToRuns(nested, token.text, base));
-		else runs.push(textRun(token.text, base));
-	} else if ("text" in token && typeof token.text === "string") runs.push(textRun(token.text, base));
-	return runs.length > 0 ? runs : [textRun(fallback, base)];
-};
-const para = (runs, styleId) => ({
-	type: "paragraph",
-	formatting: styleId ? { styleId } : {},
-	content: runs.length > 0 ? runs : [textRun("")]
-});
-const listPara = (runs, rendering) => ({
-	type: "paragraph",
-	formatting: { numPr: {
-		numId: rendering.numId,
-		ilvl: rendering.level
-	} },
-	listRendering: rendering,
-	content: runs.length > 0 ? runs : [textRun("")]
-});
-const cellOf = (cell) => ({
-	type: "tableCell",
-	content: [para(inlineToRuns(cell.tokens, cell.text, {}))]
-});
-const tableFromToken = (token) => ({
-	type: "table",
-	rows: [{
-		type: "tableRow",
-		cells: token.header.map((c) => cellOf(c))
-	}, ...token.rows.map((row) => ({
-		type: "tableRow",
-		cells: row.map((c) => cellOf(c))
-	}))]
-});
-const LIST_INDENT_STEP_TWIPS = 720;
-const buildListLevel = (ilvl, isBullet, start) => ({
-	ilvl,
-	...!isBullet && { start },
-	numFmt: isBullet ? "bullet" : "decimal",
-	lvlText: isBullet ? "•" : `%${ilvl + 1}.`,
-	suffix: "tab",
-	pPr: {
-		indentLeft: LIST_INDENT_STEP_TWIPS * (ilvl + 1),
-		indentFirstLine: -360,
-		hangingIndent: true
-	}
-});
-const listBlocks = (list, level, numId, levels) => {
-	const out = [];
-	const start = Number(list.start) || 1;
-	const decimalLevels = Array.from({ length: level + 1 }, () => "decimal");
-	if (!levels.has(level)) levels.set(level, buildListLevel(level, !list.ordered, start));
-	for (const item of list.items) {
-		const rendering = list.ordered ? {
-			marker: `%${level + 1}.`,
-			level,
-			numId,
-			isBullet: false,
-			numFmt: "decimal",
-			levelNumFmts: decimalLevels,
-			...start !== 1 && { startOverride: start }
-		} : {
-			marker: "•",
-			level,
-			numId,
-			isBullet: true
-		};
-		const inlineTokens = [];
-		const nestedLists = [];
-		for (const child of item.tokens) if (isTokenType(child, "list")) nestedLists.push(child);
-		else inlineTokens.push(child);
-		out.push(listPara(inlineToRuns(inlineTokens, item.text, {}), rendering));
-		for (const nested of nestedLists) out.push(...listBlocks(nested, level + 1, numId, levels));
-	}
-	return out;
-};
-const blocksFromTokens = (tokens, numIds) => {
-	const blocks = [];
-	for (const token of tokens ?? []) if (isTokenType(token, "heading")) {
-		const level = Math.min(Math.max(token.depth, 1), 4);
-		blocks.push(para(inlineToRuns(token.tokens, token.text, {}), `Heading${level}`));
-	} else if (isTokenType(token, "paragraph")) blocks.push(para(inlineToRuns(token.tokens, token.text, {})));
-	else if (isTokenType(token, "list")) {
-		const numId = numIds.next++;
-		const levels = /* @__PURE__ */ new Map();
-		numIds.levels.set(numId, levels);
-		blocks.push(...listBlocks(token, 0, numId, levels));
-	} else if (isTokenType(token, "table")) blocks.push(tableFromToken(token));
-	else if (isTokenType(token, "code")) for (const line of token.text.split("\n")) blocks.push(para([textRun(line.length > 0 ? line : " ", { mono: true })]));
-	else if (isTokenType(token, "blockquote")) for (const inner of blocksFromTokens(token.tokens, numIds)) {
-		const styled = inner.type === "paragraph" ? {
-			...inner,
-			formatting: {
-				...inner.formatting,
-				styleId: "Quote"
-			}
-		} : inner;
-		blocks.push(styled);
-	}
-	else if (token.type === "hr") blocks.push(para([textRun("———")]));
-	else if (token.type !== "space" && "text" in token && typeof token.text === "string" && token.text.trim().length > 0) blocks.push(para([textRun(token.text)]));
-	return blocks;
-};
 const applyMarkdownPageGeometry = (document) => {
 	const section = document.package.document.finalSectionProperties;
 	if (!section) return;
@@ -232,26 +29,6 @@ const applyMarkdownPageGeometry = (document) => {
 	section.headerDistance = 0;
 	section.footerDistance = 0;
 };
-const buildNumbering = (numIdLevels) => {
-	const abstractNums = [];
-	const nums = [];
-	for (const [numId, levels] of numIdLevels) {
-		const sortedLevels = [...levels.entries()].sort(([a], [b]) => a - b).map(([, lvl]) => lvl);
-		abstractNums.push({
-			abstractNumId: numId,
-			multiLevelType: sortedLevels.length > 1 ? "multilevel" : "singleLevel",
-			levels: sortedLevels
-		});
-		nums.push({
-			numId,
-			abstractNumId: numId
-		});
-	}
-	return {
-		abstractNums,
-		nums
-	};
-};
 /**
 * Convert a markdown string to a parsed `Document`. Synchronous. The result is
 * ready to hand to the editor (`<DocxEditor document={…} />`) and to re-export
@@ -259,13 +36,9 @@ const buildNumbering = (numIdLevels) => {
 */
 function fromMarkdown(markdown) {
 	const document = createEmptyDocument();
-	const numIds = {
-		next: 1,
-		levels: /* @__PURE__ */ new Map()
-	};
-	const blocks = blocksFromTokens(marked.lexer(markdown), numIds);
-	if (blocks.length > 0) document.package.document.content = blocks;
-	if (numIds.levels.size > 0) document.package.numbering = buildNumbering(numIds.levels);
+	const { content, numbering } = compileMarkdownToContent(markdown);
+	if (content.length > 0) document.package.document.content = content;
+	if (numbering) document.package.numbering = numbering;
 	applyMarkdownPageGeometry(document);
 	return document;
 }

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/dist/utils/urlSecurity.d.ts

@@ -1,5 +1,5 @@
+import { sanitizeExternalUrl } from "@stll/docx-core";
 //#region src/utils/urlSecurity.d.ts
-declare function sanitizeExternalUrl(rawUrl: string | undefined): string | undefined;
 declare function normalizeUserUrl(rawUrl: string): string;
 declare function isAllowedUserUrl(rawUrl: string): boolean;
 declare function sanitizeLinkTarget(target: string | undefined): string;

package/dist/utils/urlSecurity.js

@@ -1,29 +1,11 @@
+import { sanitizeExternalUrl } from "@stll/docx-core";
 //#region src/utils/urlSecurity.ts
-const ALLOWED_URL_PROTOCOLS = /* @__PURE__ */ new Set([
-	"http:",
-	"https:",
-	"mailto:",
-	"tel:"
-]);
 const ALLOWED_TARGETS = /* @__PURE__ */ new Set([
 	"_blank",
 	"_self",
 	"_parent",
 	"_top"
 ]);
-function sanitizeExternalUrl(rawUrl) {
-	if (!rawUrl) return;
-	const trimmed = rawUrl.trim();
-	if (!trimmed) return;
-	try {
-		const parsed = new URL(trimmed);
-		if (!ALLOWED_URL_PROTOCOLS.has(parsed.protocol)) return;
-		if ((parsed.protocol === "mailto:" || parsed.protocol === "tel:") && parsed.pathname.trim() === "") return;
-		return parsed.href;
-	} catch {
-		return;
-	}
-}
 function normalizeUserUrl(rawUrl) {
 	const trimmed = rawUrl.trim();
 	if (!trimmed) return "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.31.2",
+  "version": "0.32.1",
   "description": "Headless, framework-neutral core of folio: the OOXML (.docx) parser, document model, ProseMirror integration, and page-layout engine. No React.",
   "keywords": [
     "document-model",
@@ -113,7 +113,7 @@
     "perf": "bun scripts/profile-editor.ts"
   },
   "dependencies": {
-    "@stll/docx-core": "^0.17.3",
+    "@stll/docx-core": "^0.18.0",
     "@stll/docx-utils": "^0.1.0",
     "@stll/template-conditions": "^0.1.0",
     "better-result": "3.0.1",
@@ -122,7 +122,6 @@
     "fast-xml-parser": "^5.10.1",
     "hyphen": "1.14.1",
     "jszip": "3.10.1",
-    "marked": "^18.0.5",
     "prosemirror-commands": "^1.7.1",
     "prosemirror-dropcursor": "^1.8.2",
     "prosemirror-gapcursor": "^1.4.1",