@stll/folio-core 0.12.0 → 0.14.0

package/dist/prosemirror/plugins/contentControlWidgets.js

@@ -1,4 +1,4 @@
-import { ContentControlLockedError, ContentControlTypeError } from "../../content-controls/errors.js";
+import { ContentControlBoundError, ContentControlLockedError, ContentControlTypeError } from "../../content-controls/errors.js";
 import { findBlockSdtMatch, setContentControlValueTr } from "../commands/contentControls.js";
 import { Plugin, PluginKey } from "prosemirror-state";
 //#region src/prosemirror/plugins/contentControlWidgets.ts
@@ -127,7 +127,7 @@ const handleContentControlWidgetClick = ({ event, onEvent, view }) => {
 			return true;
 		}
 	} catch (error) {
-		if (error instanceof ContentControlLockedError || error instanceof ContentControlTypeError) {
+		if (error instanceof ContentControlLockedError || error instanceof ContentControlTypeError || error instanceof ContentControlBoundError) {
 			onEvent({
 				kind: "refused",
 				tag,
@@ -183,7 +183,7 @@ function dispatchDropdownPick(view, pmPos, value) {
 		view.dispatch(tr);
 		return true;
 	} catch (error) {
-		if (error instanceof ContentControlLockedError || error instanceof ContentControlTypeError) return false;
+		if (error instanceof ContentControlLockedError || error instanceof ContentControlTypeError || error instanceof ContentControlBoundError) return false;
 		throw error;
 	}
 }
@@ -197,7 +197,7 @@ function dispatchDatePick(view, pmPos, date) {
 		view.dispatch(tr);
 		return true;
 	} catch (error) {
-		if (error instanceof ContentControlLockedError || error instanceof ContentControlTypeError) return false;
+		if (error instanceof ContentControlLockedError || error instanceof ContentControlTypeError || error instanceof ContentControlBoundError) return false;
 		throw error;
 	}
 }

package/dist/prosemirror/plugins/revisionIds.d.ts

@@ -0,0 +1,23 @@
+import { Node } from "prosemirror-model";
+
+//#region src/prosemirror/plugins/revisionIds.d.ts
+/**
+ * Mint the next tracked-revision id (`w:id`). Strictly monotonic per realm,
+ * and always inside the range serialized `w:id` may occupy.
+ */
+declare function mintRevisionId(): number;
+/**
+ * Raise the counter above `maxId` so freshly minted ids cannot collide with
+ * ids already present in a loaded document. Only ever raises.
+ *
+ * `maxId` is derived from file content, so it is untrusted: a malformed or
+ * out-of-range value is ignored outright rather than folded into range.
+ */
+declare function seedRevisionIdsAbove(maxId: number): void;
+/**
+ * Raise the counter above every revision id already present in `doc`.
+ * Called from the suggestion-mode plugin's `state.init`.
+ */
+declare function seedRevisionIdsFromDoc(doc: Node): void;
+//#endregion
+export { mintRevisionId, seedRevisionIdsAbove, seedRevisionIdsFromDoc };

package/dist/prosemirror/plugins/revisionIds.js

@@ -0,0 +1,57 @@
+import { MAX_REVISION_ID } from "@stll/docx-core/model";
+//#region src/prosemirror/plugins/revisionIds.ts
+/**
+* Next id to hand out. Starts at 1 (0 is the serializer's "unusable metadata"
+* fallback) and is raised past a loaded document's existing ids by
+* `seedRevisionIdsAbove`.
+*
+* NOT seeded from a clock. `Date.now()` (~1.8e12) overflows the signed 32-bit
+* int consumers read `w:id` into.
+*/
+let counter = 1;
+/**
+* Mint the next tracked-revision id (`w:id`). Strictly monotonic per realm,
+* and always inside the range serialized `w:id` may occupy.
+*/
+function mintRevisionId() {
+	if (counter > MAX_REVISION_ID) counter = 1;
+	return counter++;
+}
+/**
+* Raise the counter above `maxId` so freshly minted ids cannot collide with
+* ids already present in a loaded document. Only ever raises.
+*
+* `maxId` is derived from file content, so it is untrusted: a malformed or
+* out-of-range value is ignored outright rather than folded into range.
+*/
+function seedRevisionIdsAbove(maxId) {
+	if (!Number.isInteger(maxId) || maxId < 0 || maxId >= MAX_REVISION_ID) return;
+	if (maxId >= counter) counter = maxId + 1;
+}
+/** Node attrs that carry a revision id directly (`revisionId` field). */
+const DIRECT_REVISION_ATTR_KEYS = ["trIns", "trDel"];
+/**
+* Raise the counter above every revision id already present in `doc`.
+* Called from the suggestion-mode plugin's `state.init`.
+*/
+function seedRevisionIdsFromDoc(doc) {
+	let max = 0;
+	const consider = (id) => {
+		if (typeof id === "number" && Number.isInteger(id) && id > max && id <= MAX_REVISION_ID) max = id;
+	};
+	doc.descendants((node) => {
+		for (const mark of node.marks) consider(mark.attrs["revisionId"]);
+		const attrs = node.attrs;
+		const pPrMark = attrs["pPrMark"];
+		if (pPrMark?.info) consider(pPrMark.info.id);
+		for (const key of DIRECT_REVISION_ATTR_KEYS) {
+			const value = attrs[key];
+			if (value) consider(value.revisionId);
+		}
+		const cellMarker = attrs["cellMarker"];
+		if (cellMarker?.info) consider(cellMarker.info.revisionId);
+	});
+	seedRevisionIdsAbove(max);
+}
+//#endregion
+export { mintRevisionId, seedRevisionIdsAbove, seedRevisionIdsFromDoc };

package/dist/prosemirror/plugins/suggestionMode.js

@@ -1,4 +1,5 @@
 import { splitBlockClearBorders } from "../extensions/features/BaseKeymapExtension.js";
+import { mintRevisionId, seedRevisionIdsFromDoc } from "./revisionIds.js";
 import { isHistoryTransaction } from "prosemirror-history";
 import { Plugin, PluginKey, TextSelection } from "prosemirror-state";
 //#region src/prosemirror/plugins/suggestionMode.ts
@@ -17,10 +18,9 @@ import { Plugin, PluginKey, TextSelection } from "prosemirror-state";
 const suggestionModeKey = new PluginKey("suggestionMode");
 const SUGGESTION_META = "suggestionModeApplied";
 const SUGGESTION_BYPASS_META = "suggestionModeBypass";
-let nextRevisionId = Date.now();
 function makeMarkAttrs(pluginState) {
 	return {
-		revisionId: nextRevisionId++,
+		revisionId: mintRevisionId(),
 		author: pluginState.author,
 		date: (/* @__PURE__ */ new Date()).toISOString()
 	};
@@ -340,7 +340,8 @@ function createSuggestionModePlugin(initialActive = false, author = "User") {
 	return new Plugin({
 		key: suggestionModeKey,
 		state: {
-			init() {
+			init(_config, instance) {
+				seedRevisionIdsFromDoc(instance.doc);
 				return {
 					active: initialActive,
 					author

package/dist/prosemirror/runFormattingMarkNames.d.ts

@@ -0,0 +1,14 @@
+//#region src/prosemirror/runFormattingMarkNames.d.ts
+/**
+ * Names of the marks that carry run-level (character) formatting.
+ *
+ * Single source of truth shared by every place that must swap a run's live
+ * formatting back to a previously recorded set: rejecting a `runPropertyChange`
+ * (commands/comments.ts) and stripping a *suggested* `runPropertyChange` at the
+ * serialization boundary (conversion/fromProseDoc.ts). Keeping one list makes
+ * it structurally impossible for the two paths to drift and let a formatting
+ * mark survive a revert.
+ */
+declare const RUN_FORMATTING_MARK_NAMES: Set<string>;
+//#endregion
+export { RUN_FORMATTING_MARK_NAMES };

package/dist/prosemirror/runFormattingMarkNames.js

@@ -0,0 +1,40 @@
+//#region src/prosemirror/runFormattingMarkNames.ts
+/**
+* Names of the marks that carry run-level (character) formatting.
+*
+* Single source of truth shared by every place that must swap a run's live
+* formatting back to a previously recorded set: rejecting a `runPropertyChange`
+* (commands/comments.ts) and stripping a *suggested* `runPropertyChange` at the
+* serialization boundary (conversion/fromProseDoc.ts). Keeping one list makes
+* it structurally impossible for the two paths to drift and let a formatting
+* mark survive a revert.
+*/
+const RUN_FORMATTING_MARK_NAMES = /* @__PURE__ */ new Set([
+	"bold",
+	"italic",
+	"underline",
+	"strike",
+	"textColor",
+	"highlight",
+	"runShading",
+	"fontSize",
+	"fontFamily",
+	"language",
+	"superscript",
+	"subscript",
+	"allCaps",
+	"smallCaps",
+	"characterSpacing",
+	"emboss",
+	"imprint",
+	"hidden",
+	"textShadow",
+	"emphasisMark",
+	"textOutline",
+	"rtl",
+	"textEffect",
+	"runFormattingOverride",
+	"characterStyle"
+]);
+//#endregion
+export { RUN_FORMATTING_MARK_NAMES };

package/dist/prosemirror/schema/index.d.ts

@@ -1,6 +1,6 @@
+import { CharacterSpacingAttrs, CharacterStyleAttrs, CommentAttrs, EmphasisMarkAttrs, FontFamilyAttrs, FontSizeAttrs, FootnoteRefAttrs, HighlightAttrs, HyperlinkAttrs, LanguageAttrs, RunFormattingOverrideAttrs, RunPropertyChangeMarkAttrs, RunShadingAttrs, StrikeAttrs, TextColorAttrs, TextEffectAttrs, TrackedChangeMarkAttrs, UnderlineAttrs } from "./marks.js";
 import { ExtensionManager } from "../extensions/ExtensionManager.js";
 import { BlockSdtAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, ParagraphAttrs, SdtAttrs, ShapeAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAttrs } from "./nodes.js";
-import { CharacterSpacingAttrs, CharacterStyleAttrs, CommentAttrs, EmphasisMarkAttrs, FontFamilyAttrs, FontSizeAttrs, FootnoteRefAttrs, HighlightAttrs, HyperlinkAttrs, LanguageAttrs, RunFormattingOverrideAttrs, RunPropertyChangeMarkAttrs, RunShadingAttrs, StrikeAttrs, TextColorAttrs, TextEffectAttrs, TrackedChangeMarkAttrs, UnderlineAttrs } from "./marks.js";
 
 //#region src/prosemirror/schema/index.d.ts
 declare const singletonManager: ExtensionManager;

package/dist/prosemirror/schema/marks.d.ts

@@ -85,15 +85,38 @@ type FootnoteRefAttrs = {
 type CommentAttrs = {
   commentId: number;
 };
+/**
+ * Provenance of a tracked change.
+ *
+ * - `"user"` — a normal tracked change authored by a person (or an
+ *   accepted suggestion). Serializes to OOXML `w:ins` / `w:del` /
+ *   `w:rPrChange`.
+ * - `"suggested"` — an AI-proposed edit rendered with the tracked-change
+ *   visual grammar but ALWAYS stripped from serialized DOCX output until
+ *   accepted. Suggested marks never round-trip through OOXML; parsing a
+ *   DOCX can only ever produce `"user"` marks.
+ */
+declare const TRACKED_CHANGE_PROVENANCE_VALUES: readonly ["user", "suggested"];
+type TrackedChangeProvenance = (typeof TRACKED_CHANGE_PROVENANCE_VALUES)[number];
 type TrackedChangeMarkAttrs = {
   revisionId: number;
   author: string;
-  date?: string;
-  moveKind?: "moveTo" | "moveFrom";
+  date?: string; /** Optional author initials (w:initials) carried through the round-trip. */
+  initials?: string;
+  moveKind?: "moveTo" | "moveFrom"; /** Defaults to `"user"`; `"suggested"` for AI-proposed, non-serialized edits. */
+  provenance: TrackedChangeProvenance;
+  /**
+   * Groups every mark belonging to one logical suggestion so the host can
+   * accept/reject them together. Absent for `"user"` provenance (the mark's
+   * `null` default is normalized to absent by the attrs reader).
+   */
+  suggestionId?: string;
 };
 /** Run-property revisions carried through the editable model. */
 type RunPropertyChangeMarkAttrs = {
-  changes: document_d_exports.RunPropertyChange[];
+  changes: document_d_exports.RunPropertyChange[]; /** See {@link TrackedChangeProvenance}. Defaults to `"user"`. */
+  provenance: TrackedChangeProvenance;
+  suggestionId?: string;
 };
 type RunFormattingOverrideAttrs = { [K in keyof Pick<document_d_exports.TextFormatting, "bold" | "italic" | "strike" | "doubleStrike" | "allCaps" | "smallCaps" | "hidden" | "emboss" | "imprint" | "shadow" | "outline" | "rtl">]?: false } & {
   underline?: "none";
@@ -124,4 +147,4 @@ type HyperlinkAttrs = {
   _docxHyperlinkIndex?: number;
 };
 //#endregion
-export { CharacterSpacingAttrs, CharacterStyleAttrs, CommentAttrs, EmphasisMarkAttrs, FontFamilyAttrs, FontSizeAttrs, FootnoteRefAttrs, HighlightAttrs, HyperlinkAttrs, LanguageAttrs, RunFormattingOverrideAttrs, RunPropertyChangeMarkAttrs, RunShadingAttrs, StrikeAttrs, TextColorAttrs, TextEffectAttrs, TrackedChangeMarkAttrs, UnderlineAttrs };
+export { CharacterSpacingAttrs, CharacterStyleAttrs, CommentAttrs, EmphasisMarkAttrs, FontFamilyAttrs, FontSizeAttrs, FootnoteRefAttrs, HighlightAttrs, HyperlinkAttrs, LanguageAttrs, RunFormattingOverrideAttrs, RunPropertyChangeMarkAttrs, RunShadingAttrs, StrikeAttrs, TRACKED_CHANGE_PROVENANCE_VALUES, TextColorAttrs, TextEffectAttrs, TrackedChangeMarkAttrs, TrackedChangeProvenance, UnderlineAttrs };

package/dist/prosemirror/schema/marks.js

@@ -0,0 +1,15 @@
+//#region src/prosemirror/schema/marks.ts
+/**
+* Provenance of a tracked change.
+*
+* - `"user"` — a normal tracked change authored by a person (or an
+*   accepted suggestion). Serializes to OOXML `w:ins` / `w:del` /
+*   `w:rPrChange`.
+* - `"suggested"` — an AI-proposed edit rendered with the tracked-change
+*   visual grammar but ALWAYS stripped from serialized DOCX output until
+*   accepted. Suggested marks never round-trip through OOXML; parsing a
+*   DOCX can only ever produce `"user"` marks.
+*/
+const TRACKED_CHANGE_PROVENANCE_VALUES = ["user", "suggested"];
+//#endregion
+export { TRACKED_CHANGE_PROVENANCE_VALUES };

package/dist/prosemirror/schema/nodes.d.ts

@@ -1,4 +1,5 @@
 import { document_d_exports } from "../../types/document.js";
+import { TrackedChangeProvenance } from "./marks.js";
 import { OutlineStyleAttr } from "../../types/documentEnumValues.js";
 import { SpacingExplicit } from "../../types/formatting.js";
 import { ParagraphDirection } from "../paragraphDirection.js";
@@ -152,6 +153,12 @@ type ParagraphAttrs = {
    *  `del`. Stored as a discriminated union to mirror folio's
    *  `TrackedChangeWrapperType` model rather than two parallel attrs. */
   pPrMark?: document_d_exports.ParagraphMarkChange;
+  /**
+   * Marks this whole paragraph as a *suggested* insertion (AI proposal). The
+   * paragraph is dropped from serialized DOCX until accepted; accepting turns
+   * it into a real inserted-paragraph tracked change (paragraph-mark `w:ins`).
+   */
+  _suggestedInsert?: SuggestedStructuralMarker | null;
 };
 /**
  * Image position for floating images (horizontal and vertical positioning)
@@ -382,6 +389,12 @@ type TableAttrs = {
   _resolvedIndent?: NonNullable<document_d_exports.TableFormatting["indent"]>; /** Original table formatting from DOCX for lossless round-trip serialization */
   _originalFormatting?: document_d_exports.TableFormatting; /** Tracked table property changes (w:tblPrChange) for round-trip + accept/reject */
   tblPrChange?: document_d_exports.TablePropertyChange[];
+  /**
+   * Marks this whole table as a *suggested* insertion (AI proposal). The table
+   * is dropped from serialized DOCX until accepted; because OOXML has no tracked
+   * whole-table-insert primitive, accepting applies it directly.
+   */
+  _suggestedInsert?: SuggestedStructuralMarker | null;
 };
 /**
  * Table row attributes
@@ -394,10 +407,19 @@ type TableRowAttrs = {
   _originalFormatting?: document_d_exports.TableRowFormatting; /** Tracked row property changes (w:trPrChange) for round-trip + accept/reject */
   trPrChange?: document_d_exports.TableRowPropertyChange[];
 } & ({
-  /** Tracked structural row insertion (w:trPr/w:ins). */trIns: {
+  /**
+   * Tracked structural row insertion (w:trPr/w:ins). A `"suggested"`
+   * provenance marks a whole-row AI proposal: stripped from serialized DOCX
+   * until accepted, at which point it becomes a real (user) `trIns`. Rows use
+   * this, NOT `_suggestedInsert` (that marker is paragraph/table only).
+   */
+  trIns: {
     revisionId: number;
     author: string;
     date?: string | null;
+    initials?: string | null;
+    provenance?: TrackedChangeProvenance;
+    suggestionId?: string | null;
   };
   trDel?: never;
 } | {
@@ -406,11 +428,28 @@ type TableRowAttrs = {
     revisionId: number;
     author: string;
     date?: string | null;
+    initials?: string | null;
+    provenance?: TrackedChangeProvenance;
+    suggestionId?: string | null;
   };
 } | {
   trIns?: never;
   trDel?: never;
 });
+/**
+ * A whole-node *suggested* insertion marker (AI proposal) carried on a
+ * paragraph or table node. The node is dropped entirely from serialized DOCX
+ * until accepted; accepting converts it to a real tracked change (paragraph
+ * mark `w:ins`) or, where OOXML has no tracked representation (whole table),
+ * applies it directly.
+ */
+type SuggestedStructuralMarker = {
+  suggestionId: string;
+  revisionId: number;
+  author: string;
+  date?: string | null;
+  initials?: string | null;
+};
 /**
  * Table cell attributes
  */
@@ -441,13 +480,22 @@ type TableCellAttrs = {
       revisionId: number;
       author: string;
       date?: string | null;
+      initials?: string | null; /** `"suggested"` marks this as an AI proposal (stripped until accepted). */
+      provenance?: TrackedChangeProvenance;
+      suggestionId?: string | null;
     };
   } | {
     kind: "merge";
+    /**
+     * Merge markers resolve via cell-merge resolution and are never
+     * produced in suggested mode (cell merge/split reports
+     * `unsupportedMode`), so they carry no suggestion provenance.
+     */
     info: {
       revisionId: number;
       author: string;
       date?: string | null;
+      initials?: string | null;
     };
     verticalMerge?: "continue" | "rest";
     verticalMergeOriginal?: "continue" | "rest";
@@ -456,4 +504,4 @@ type TableCellAttrs = {
   _docxVMergeContinuationCells?: document_d_exports.TableCell[];
 };
 //#endregion
-export { BlockSdtAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, ParagraphAttrs, SdtAttrs, ShapeAttrs, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAnchorAttrs, TextBoxAttrs };
+export { BlockSdtAttrs, FieldAttrs, HardBreakAttrs, ImageAttrs, ImagePositionAttrs, MathAttrs, ParagraphAttrs, SdtAttrs, ShapeAttrs, SuggestedStructuralMarker, TableAttrs, TableCellAttrs, TableRowAttrs, TextBoxAnchorAttrs, TextBoxAttrs };

package/dist/prosemirror/utils/tabCalculator.js

@@ -36,11 +36,11 @@ function pixelsToTwips(pixels) {
 */
 function computeTabStops(context) {
 	const { explicitStops = [], defaultTabInterval = 720, leftIndent = 0 } = context;
-	const validExplicitStops = explicitStops.filter((stop) => stop.val !== "clear");
+	const validExplicitStops = explicitStops.filter((stop) => stop.val !== "clear" && stop.val !== "bar");
 	const clearPositions = explicitStops.filter((stop) => stop.val === "clear").map((stop) => stop.pos);
 	let maxExplicit = 0;
 	for (const stop of validExplicitStops) maxExplicit = Math.max(maxExplicit, stop.pos);
-	const stops = [...validExplicitStops];
+	const stops = explicitStops.filter((stop) => stop.val !== "clear");
 	const hasLeftIndentClear = clearPositions.some((p) => Math.abs(p - leftIndent) < 20);
 	const addsImplicitLeftIndent = leftIndent > 0 && !hasLeftIndentClear && !validExplicitStops.some((stop) => stop.pos <= leftIndent);
 	if (addsImplicitLeftIndent) stops.push({
@@ -53,7 +53,7 @@ function computeTabStops(context) {
 	while (pos < limitPos) {
 		pos += defaultTabInterval;
 		let hasExplicitStop = false;
-		for (const stop of validExplicitStops) if (Math.abs(stop.pos - pos) < 20) {
+		for (const stop of stops) if (Math.abs(stop.pos - pos) < 20) {
 			hasExplicitStop = true;
 			break;
 		}

package/dist/render-dom/RemoteSelectionOverlay.js

@@ -41,7 +41,7 @@ var RemoteSelectionOverlay = class {
 			if (!caret) continue;
 			const caretElement = createOverlayElement(pagesContainer, CARET_CLASS, zIndex + 1);
 			caretElement.dataset["clientId"] = String(selection.clientId);
-			caretElement.style.background = selection.color;
+			caretElement.style.backgroundColor = selection.color;
 			setBox(caretElement, {
 				...caret,
 				width: 2
@@ -50,7 +50,7 @@ var RemoteSelectionOverlay = class {
 			const label = createOverlayElement(pagesContainer, LABEL_CLASS, zIndex + 2);
 			label.dataset["clientId"] = String(selection.clientId);
 			label.textContent = selection.name;
-			label.style.background = selection.color;
+			label.style.backgroundColor = selection.color;
 			label.style.color = "var(--background, #fff)";
 			label.style.fontSize = "10px";
 			label.style.lineHeight = "1";

package/dist/server.d.ts

@@ -2,7 +2,7 @@ import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreview
 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 { 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 } from "./ai-edits/snapshot.js";
+import { createFolioAITextRangeHandle, hashFolioAIBlockText, normalizeFolioAIBlockText } from "./ai-edits/snapshot.js";
 import { getFolioDocumentOutline, readFolioDocumentSection } from "./ai-edits/scoped-reading.js";
 import { DeriveBlockIdInput, FolioBlockId, deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
 import { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DocumentPreset, DocumentStyleSet } from "./style-sets/types.js";
@@ -17,8 +17,9 @@ import { DocxArchiveError, DocxArchiveOptions } from "./docx/server/boundedArchi
 import { EvaluateDocxXmlPatchProposalArgs, 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, FolioDocxPreparedXmlReplacement, FolioDocxXmlPatchProposal, FolioDocxXmlPatchProposalEvaluation, FolioDocxXmlPatchProposalIssue, FolioDocxXmlPatchProposalIssueCode, FolioDocxXmlPatchProposalLimits, FolioDocxXmlReplacement, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, evaluateDocxXmlPatchProposal, parseFolioDocxXmlPatchProposal } from "./docx/server/evaluateDocxXmlPatchProposal.js";
 import { FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, FolioDocxConformanceCheck, FolioDocxConformanceCheckId, FolioDocxConformanceCheckStatus, FolioDocxConformanceIssue, FolioDocxConformanceIssueCode, FolioDocxConformanceReport, FolioDocxConformanceStatus, ValidateDocxConformanceOptions, validateDocxConformance } from "./docx/server/validateDocxConformance.js";
 import { ApplyDocxXmlPatchProposalArgs, FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FolioDocxXmlPatchApplication, FolioDocxXmlPatchApplicationError, FolioDocxXmlPatchApplicationReceipt, UnsupportedFolioDocxXmlPatchApplicationProfileError, applyDocxXmlPatchProposal } from "./docx/server/applyDocxXmlPatchProposal.js";
+import { docxToMarkdown } from "./docx/server/docxToMarkdown.js";
 import { DocxParagraphSource, ExtractedDocxParagraph, ExtractedDocxText, extractDocxText } from "./docx/server/extractDocxText.js";
 import { FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FolioDocxInspectedXmlPart, FolioDocxPackageInspection, FolioDocxPackageInspectionError, FolioDocxPackageInspectionErrorCode, FolioDocxPackageInspectionLimits, FolioDocxPackagePart, FolioDocxPackagePartKind, InspectDocxPackageOptions, inspectDocxPackage } from "./docx/server/inspectDocxPackage.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, 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, EnsureParaIdsError, type EnsureParaIdsOptions, type EnsureParaIdsResult, type EvaluateDocxXmlPatchProposalArgs, type ExtractDocumentStyleSetOptions, type ExtractedDocxParagraph, 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, 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, type GenerateRedlineDocxOptions, type GenerateRedlineDocxResult, type GenerateRedlineUnprocessedStory, type InspectDocxPackageOptions, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, type RewriteDocxMetadataPrivacyResult, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, type ValidateDocxConformanceOptions, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, validateDocxConformance };
+export { type ApplyDocxXmlPatchProposalArgs, type ApplyFolioAIEditsToBufferOptions, type ApplyFolioAIEditsToBufferResult, 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, EnsureParaIdsError, type EnsureParaIdsOptions, type EnsureParaIdsResult, type EvaluateDocxXmlPatchProposalArgs, type ExtractDocumentStyleSetOptions, type ExtractedDocxParagraph, 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, 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, type GenerateRedlineDocxOptions, type GenerateRedlineDocxResult, type GenerateRedlineUnprocessedStory, type InspectDocxPackageOptions, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, type RewriteDocxMetadataPrivacyResult, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, type ValidateDocxConformanceOptions, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, docxToMarkdown, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, validateDocxConformance };

package/dist/server.js

@@ -1,5 +1,5 @@
 import { deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
-import { createFolioAITextRangeHandle } from "./ai-edits/snapshot.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 { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION } from "./style-sets/types.js";
 import { createEmptyDocument } from "./utils/createDocument.js";
@@ -12,11 +12,12 @@ import { FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioDocumentStory
 import { FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FolioDocumentPrivacyArchiveError, InvalidFolioDocumentPrivacyOptionsError, isFolioDocumentPrivacyTransform, rewriteDocxMetadataPrivacy } from "./docx/metadataPrivacy.js";
 import { FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, InvalidFolioVersionComparisonOptionsError, applyFolioVersionDiffPrivacy, compareDocxVersions, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope } from "./version-comparison.js";
 import { InvalidGenerateRedlineDocxOptionsError, generateRedlineDocx } from "./redline.js";
-import { EnsureParaIdsError, ensureParaIds } from "./docx/ensureParaIds.js";
 import { DocxArchiveError } from "./docx/server/boundedArchive.js";
+import { EnsureParaIdsError, ensureParaIds } from "./docx/ensureParaIds.js";
 import { extractDocxText } from "./docx/server/extractDocxText.js";
+import { docxToMarkdown } from "./docx/server/docxToMarkdown.js";
 import { FOLIO_DOCX_PACKAGE_INSPECTION_DEFAULTS, FOLIO_DOCX_PACKAGE_INSPECTION_ERROR_CODES, FOLIO_DOCX_PACKAGE_INSPECTION_VERSION, FolioDocxPackageInspectionError, inspectDocxPackage } from "./docx/server/inspectDocxPackage.js";
 import { 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, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, evaluateDocxXmlPatchProposal, parseFolioDocxXmlPatchProposal } from "./docx/server/evaluateDocxXmlPatchProposal.js";
 import { FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, validateDocxConformance } from "./docx/server/validateDocxConformance.js";
 import { FOLIO_DOCX_XML_PATCH_APPLICATION_PROFILE, FOLIO_DOCX_XML_PATCH_APPLICATION_VERSION, FolioDocxXmlPatchApplicationError, UnsupportedFolioDocxXmlPatchApplicationProfileError, applyDocxXmlPatchProposal } from "./docx/server/applyDocxXmlPatchProposal.js";
-export { 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, FolioDocumentPrivacyArchiveError, FolioDocumentStoryNotFoundError, FolioDocxPackageInspectionError, FolioDocxReviewer, FolioDocxXmlPatchApplicationError, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, validateDocxConformance };
+export { 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, FolioDocumentPrivacyArchiveError, FolioDocumentStoryNotFoundError, FolioDocxPackageInspectionError, FolioDocxReviewer, FolioDocxXmlPatchApplicationError, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioDocxXmlPatchProposalError, InvalidFolioDocxXmlPatchProposalOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioDocxXmlPatchApplicationProfileError, UnsupportedFolioReviewedViewError, applyDocxXmlPatchProposal, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, docxToMarkdown, ensureParaIds, evaluateDocxXmlPatchProposal, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, validateDocxConformance };

package/dist/utils/clipboard.d.ts

@@ -85,6 +85,15 @@ declare function isWordHtml(html: string): boolean;
  * Check if HTML is from our editor
  */
 declare function isEditorHtml(html: string): boolean;
+/**
+ * Sanitize inbound clipboard HTML at the paste trust boundary.
+ *
+ * Comments and XML declarations are stripped with linear scanners. When a
+ * browser `window` is available, DOMPurify removes scripts, event handlers,
+ * and dangerous URLs before any DOM walk. Without a window (unit stubs / SSR)
+ * the linear cleaners still run; the live editor path always has `window`.
+ */
+declare function sanitizeInboundClipboardHtml(html: string): string;
 /**
  * Clean Microsoft Word HTML
  */
@@ -123,4 +132,4 @@ declare const _default: {
   createClipboardHandlers: typeof createClipboardHandlers;
 };
 //#endregion
-export { CLIPBOARD_TYPES, ClipboardContent, ClipboardOptions, INTERNAL_CLIPBOARD_TYPE, ParsedClipboardContent, cleanWordHtml, copyParagraphs, copyRuns, createClipboardHandlers, _default as default, getClipboardImageFiles, handlePasteEvent, htmlToRuns, isEditorHtml, isWordHtml, paragraphsToClipboardContent, parseClipboardHtml, readFromClipboard, runsToClipboardContent, writeToClipboard };
+export { CLIPBOARD_TYPES, ClipboardContent, ClipboardOptions, INTERNAL_CLIPBOARD_TYPE, ParsedClipboardContent, cleanWordHtml, copyParagraphs, copyRuns, createClipboardHandlers, _default as default, getClipboardImageFiles, handlePasteEvent, htmlToRuns, isEditorHtml, isWordHtml, paragraphsToClipboardContent, parseClipboardHtml, readFromClipboard, runsToClipboardContent, sanitizeInboundClipboardHtml, writeToClipboard };

package/dist/utils/clipboard.js

@@ -1,5 +1,18 @@
+import { stripXmlDeclarations } from "./stripXmlDeclarations.js";
+import createDOMPurify from "dompurify";
 //#region src/utils/clipboard.ts
 /**
+* Clipboard utilities for copy/paste with formatting
+*
+* Handles:
+* - Copy: puts formatted HTML and plain text on clipboard
+* - Paste: reads HTML clipboard, converts to runs with formatting
+* - Handles paste from Word (cleans up Word HTML)
+* - Ctrl+C, Ctrl+V, Ctrl+X keyboard shortcuts
+*/
+let domPurify;
+const getDomPurify = () => domPurify ??= createDOMPurify(window);
+/**
 * Custom MIME type for internal clipboard format
 */
 const INTERNAL_CLIPBOARD_TYPE = "application/x-stella-folio";
@@ -308,12 +321,24 @@ function stripPairedNamespaceTags(html, prefix) {
 	return result;
 }
 /**
+* Sanitize inbound clipboard HTML at the paste trust boundary.
+*
+* Comments and XML declarations are stripped with linear scanners. When a
+* browser `window` is available, DOMPurify removes scripts, event handlers,
+* and dangerous URLs before any DOM walk. Without a window (unit stubs / SSR)
+* the linear cleaners still run; the live editor path always has `window`.
+*/
+function sanitizeInboundClipboardHtml(html) {
+	let cleaned = stripHtmlComments(html);
+	cleaned = stripXmlDeclarations(cleaned);
+	if (typeof globalThis.window === "undefined") return cleaned;
+	return getDomPurify().sanitize(cleaned);
+}
+/**
 * Clean Microsoft Word HTML
 */
 function cleanWordHtml(html) {
-	let cleaned = html;
-	cleaned = stripHtmlComments(cleaned);
-	cleaned = cleaned.replace(/<\?xml[^>]*>/gi, "");
+	let cleaned = sanitizeInboundClipboardHtml(html);
 	cleaned = stripPairedNamespaceTags(cleaned, "o:");
 	cleaned = cleaned.replace(/<o:[^>]*\/>/gi, "");
 	cleaned = stripPairedNamespaceTags(cleaned, "w:");
@@ -325,7 +350,8 @@ function cleanWordHtml(html) {
 	return cleaned;
 }
 function cleanWordAttributes(html) {
-	const container = new DOMParser().parseFromString(html, "text/html").body;
+	const sanitized = sanitizeInboundClipboardHtml(html);
+	const container = new DOMParser().parseFromString(sanitized, "text/html").body;
 	for (const element of Array.from(container.querySelectorAll("*"))) {
 		const filteredClasses = Array.from(element.classList).filter((className) => !className.includes("Mso"));
 		if (filteredClasses.length === 0) element.removeAttribute("class");
@@ -346,7 +372,8 @@ function cleanWordAttributes(html) {
 */
 function htmlToRuns(html, plainTextFallback) {
 	if (!html || html.trim() === "") return plainTextFallback ? [createTextRun(plainTextFallback)] : [];
-	const container = new DOMParser().parseFromString(html, "text/html").body;
+	const sanitized = sanitizeInboundClipboardHtml(html);
+	const container = new DOMParser().parseFromString(sanitized, "text/html").body;
 	const runs = [];
 	processNode(container, runs, {});
 	if (runs.length === 0 && plainTextFallback) return [createTextRun(plainTextFallback)];
@@ -619,4 +646,4 @@ var clipboard_default = {
 	createClipboardHandlers
 };
 //#endregion
-export { CLIPBOARD_TYPES, INTERNAL_CLIPBOARD_TYPE, cleanWordHtml, copyParagraphs, copyRuns, createClipboardHandlers, clipboard_default as default, getClipboardImageFiles, handlePasteEvent, htmlToRuns, isEditorHtml, isWordHtml, paragraphsToClipboardContent, parseClipboardHtml, readFromClipboard, runsToClipboardContent, writeToClipboard };
+export { CLIPBOARD_TYPES, INTERNAL_CLIPBOARD_TYPE, cleanWordHtml, copyParagraphs, copyRuns, createClipboardHandlers, clipboard_default as default, getClipboardImageFiles, handlePasteEvent, htmlToRuns, isEditorHtml, isWordHtml, paragraphsToClipboardContent, parseClipboardHtml, readFromClipboard, runsToClipboardContent, sanitizeInboundClipboardHtml, writeToClipboard };

package/dist/utils/colorResolver.d.ts

@@ -1,6 +1,13 @@
 import { document_d_exports } from "../types/document.js";
 
 //#region src/utils/colorResolver.d.ts
+/**
+ * Public form of the same hex-color check, for callers that read a color
+ * value from an untrusted surface (e.g. a pasted DOM node's `dataset`,
+ * which bypasses the CSSOM's own value validation) and must reject it
+ * before storing it as editor state.
+ */
+declare function isValidHexColor(value: string | undefined | null): boolean;
 /**
  * Resolve a ColorValue to a CSS color string
  *
@@ -162,4 +169,4 @@ declare function generateThemeTintShadeMatrix(colorScheme?: document_d_exports.T
  */
 declare function colorsEqual(color1: document_d_exports.ColorValue | undefined | null, color2: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): boolean;
 //#endregion
-export { STANDARD_TEXT_COLORS, ThemeMatrixCell, blendColors, colorsEqual, createRgbColor, createThemeColor, darkenColor, ensureHexPrefix, generateThemeTintShadeMatrix, getContrastingColor, getThemeTintShadeHex, isBlack, isWhite, lightenColor, parseColorString, resolveColor, resolveColorToHex, resolveHighlightColor, resolveHighlightToCss, resolveShadingColor };
+export { STANDARD_TEXT_COLORS, ThemeMatrixCell, blendColors, colorsEqual, createRgbColor, createThemeColor, darkenColor, ensureHexPrefix, generateThemeTintShadeMatrix, getContrastingColor, getThemeTintShadeHex, isBlack, isValidHexColor, isWhite, lightenColor, parseColorString, resolveColor, resolveColorToHex, resolveHighlightColor, resolveHighlightToCss, resolveShadingColor };