@stll/folio-core 0.61.0 → 0.63.0

package/dist/prosemirror/yjsDocumentMetadata.js

@@ -476,7 +476,8 @@ const FOLIO_YJS_ATTR_SCHEMA_VERSIONS = [
 	10,
 	11,
 	12,
-	13
+	13,
+	14
 ];
 /**
 * The one place a persisted attr-shape change is decided.
@@ -502,18 +503,20 @@ const ATTR_SCHEMA_MIGRATIONS = {
 	10: renamePageBreakRunOwnerMarkAttr,
 	11: stampMarkerOnly,
 	12: stampMarkerOnly,
-	13: "current"
+	13: stampMarkerOnly,
+	14: "current"
 };
 /**
 * The attr-schema version this build writes. Derived against the migration map
 * so the constant and the map cannot disagree.
 */
-const FOLIO_YJS_ATTR_SCHEMA_VERSION = 13;
+const FOLIO_YJS_ATTR_SCHEMA_VERSION = 14;
+const STATED_NUMBERING_SOURCE_SCHEMA_VERSION = 13;
 var FolioYjsNoteReferenceSchemaError = class extends TaggedError("FolioYjsNoteReferenceSchemaError") {};
 var FolioYjsNumberingSourceSchemaError = class extends TaggedError("FolioYjsNumberingSourceSchemaError") {};
 /** Older snapshots can hold a resolved style reference where a stated override belongs. */
 const requireStatedNumberingSources = (fragment, schemaVersion) => {
-	if (schemaVersion === 13) return;
+	if (schemaVersion >= STATED_NUMBERING_SOURCE_SCHEMA_VERSION) return;
 	const pending = [];
 	const visit = (node) => {
 		if ("getAttributes" in node) pending.push(node.getAttributes());
@@ -533,8 +536,8 @@ const requireStatedNumberingSources = (fragment, schemaVersion) => {
 		const numbering = value["numPr"];
 		if (isRecord(value["numPrFromStyle"]) && isRecord(numbering) && (numbering["kind"] === "reference" || "numId" in numbering)) throw new FolioYjsNumberingSourceSchemaError({
 			schemaVersion,
-			requiredSchemaVersion: 13,
-			message: `Yjs schema ${schemaVersion} has ambiguous numbering ownership; schema 13 requires stated numbering overrides. Rebuild the collaboration state from the saved DOCX.`
+			requiredSchemaVersion: STATED_NUMBERING_SOURCE_SCHEMA_VERSION,
+			message: `Yjs schema ${schemaVersion} has ambiguous numbering ownership; schema ${STATED_NUMBERING_SOURCE_SCHEMA_VERSION} requires stated numbering overrides. Rebuild the collaboration state from the saved DOCX.`
 		});
 		for (const entry of Object.values(value)) pending.push(entry);
 	}
@@ -555,8 +558,8 @@ const requireNoteOccurrenceAttribution = (fragment, schemaVersion) => {
 				if (isRecord(reference) && isNoteReferenceOccurrenceId(reference["occurrenceId"])) continue;
 				throw new FolioYjsNoteReferenceSchemaError({
 					schemaVersion,
-					requiredSchemaVersion: 13,
-					message: `Yjs schema ${schemaVersion} has unattributed note references; schema 13 requires occurrence identities. Rebuild the collaboration state from the saved DOCX.`
+					requiredSchemaVersion: 14,
+					message: `Yjs schema ${schemaVersion} has unattributed note references; schema 14 requires occurrence identities. Rebuild the collaboration state from the saved DOCX.`
 				});
 			}
 		}
@@ -589,7 +592,7 @@ const attrSchemaMigrationSteps = (fromVersion) => FOLIO_YJS_ATTR_SCHEMA_VERSIONS
 const applyAttrSchemaMigrations = (ydoc, fragment, fromVersion) => {
 	requireNoteOccurrenceAttribution(fragment, fromVersion);
 	requireStatedNumberingSources(fragment, fromVersion);
-	if (fromVersion === 13) return 0;
+	if (fromVersion === 14) return 0;
 	let rewritten = 0;
 	ydoc.transact(() => {
 		for (const step of attrSchemaMigrationSteps(fromVersion)) rewritten += step(fragment);
@@ -599,7 +602,7 @@ const applyAttrSchemaMigrations = (ydoc, fragment, fromVersion) => {
 };
 /** Raised when a snapshot's attr-schema marker is ahead of the running code. */
 var FolioYjsAttrSchemaVersionError = class extends TaggedError("FolioYjsAttrSchemaVersionError") {};
-const isReadableVersion = (marker) => typeof marker === "number" && Number.isInteger(marker) && marker >= 0 && marker <= 13;
+const isReadableVersion = (marker) => typeof marker === "number" && Number.isInteger(marker) && marker >= 0 && marker <= 14;
 /**
 * The attr-schema version a collaboration document was written under.
 *
@@ -617,7 +620,7 @@ const readYjsAttrSchemaVersion = (ydoc) => {
 	return Result.err(new FolioYjsAttrSchemaVersionError({
 		marker,
 		message: "The collaboration snapshot was written by a newer Folio attr schema than this build reads.",
-		supportedVersion: 13
+		supportedVersion: 14
 	}));
 };
 const proseDocumentParagraphSourceContract = (document) => {
@@ -625,7 +628,7 @@ const proseDocumentParagraphSourceContract = (document) => {
 };
 /** Stamp the attr-schema version of the build that wrote the current fragment. */
 const writeYjsAttrSchemaVersion = (ydoc) => {
-	ydoc.getMap(FOLIO_YJS_METADATA_MAP_NAME).set(ATTR_SCHEMA_VERSION_KEY, 13);
+	ydoc.getMap(FOLIO_YJS_METADATA_MAP_NAME).set(ATTR_SCHEMA_VERSION_KEY, 14);
 };
 /**
 * Write both metadata bindings for a freshly seeded collaboration document.

package/dist/prosemirror/zeroWidthAnchors.d.ts

@@ -1,10 +1,11 @@
 import { Node } from "prosemirror-model";
+import { ParagraphContentVerdict } from "@stll/docx-core/ops";
 //#region src/prosemirror/zeroWidthAnchors.d.ts
-declare const isZeroWidthAnchor: (node: Node) => boolean;
+export declare const isZeroWidthAnchor: (node: Node) => boolean;
 /**
- * Whether the textblock holds nothing but zero-width anchors, which is what
- * "everything in it was resolved away" looks like in the document.
+ * Whether the textblock holds content its paragraph mark must not take away,
+ * by the engine's rule: the paragraph's width, and each anchor directly in
+ * it counted as the engine item it stands for.
  */
-declare const holdsNoContent: (block: Node) => boolean;
-//#endregion
-export { holdsNoContent, isZeroWidthAnchor };
+export declare const paragraphContentOf: (block: Node) => ParagraphContentVerdict;
+//#endregion

package/dist/prosemirror/zeroWidthAnchors.js

@@ -1,29 +1,66 @@
+import { expectCommentRangeBoundaryAttrs } from "./commentRangeBoundaryAttrs.js";
+import { COMMENT_REFERENCE_NODE_NAME } from "./commentReferenceIntegrity.js";
 import { BOOKMARK_BOUNDARY_NODE_NAME } from "./extensions/nodes/BookmarkBoundaryExtension.js";
-import { COMMENT_REFERENCE_NODE_NAME } from "./extensions/nodes/CommentReferenceExtension.js";
+import { COMMENT_RANGE_BOUNDARY_NODE_NAME } from "./extensions/nodes/CommentRangeBoundaryExtension.js";
 import { MOVE_RANGE_BOUNDARY_NODE_NAME } from "./extensions/nodes/MoveRangeBoundaryExtension.js";
 import { RANGE_ANCHOR_NODE_NAME } from "./extensions/nodes/RangeAnchorExtension.js";
 import { RENDERED_PAGE_BREAK_NODE_NAME } from "./extensions/nodes/RenderedPageBreakExtension.js";
 import { TEXT_BOX_ANCHOR_NODE_NAME } from "./extensions/nodes/TextBoxAnchorExtension.js";
+import { paragraphContentVerdict } from "@stll/docx-core/ops";
 //#region src/prosemirror/zeroWidthAnchors.ts
-const ZERO_WIDTH_ANCHOR_NODE_NAMES = /* @__PURE__ */ new Set([
-	BOOKMARK_BOUNDARY_NODE_NAME,
-	COMMENT_REFERENCE_NODE_NAME,
-	MOVE_RANGE_BOUNDARY_NODE_NAME,
-	RANGE_ANCHOR_NODE_NAME,
-	RENDERED_PAGE_BREAK_NODE_NAME,
-	TEXT_BOX_ANCHOR_NODE_NAME
+/**
+* The engine item each anchor stands for in paragraph retention. Logical
+* offsets count comment references separately.
+*/
+const ANCHOR_ITEMS = /* @__PURE__ */ new Map([
+	[BOOKMARK_BOUNDARY_NODE_NAME, "bookmarkStart"],
+	[COMMENT_REFERENCE_NODE_NAME, "commentReference"],
+	[COMMENT_RANGE_BOUNDARY_NODE_NAME, "commentRangeStart"],
+	[MOVE_RANGE_BOUNDARY_NODE_NAME, "moveFromRangeStart"],
+	[RANGE_ANCHOR_NODE_NAME, "commentRangeStart"],
+	[RENDERED_PAGE_BREAK_NODE_NAME, "renderedPageBreak"],
+	[TEXT_BOX_ANCHOR_NODE_NAME, "unit"]
 ]);
-const isZeroWidthAnchor = (node) => ZERO_WIDTH_ANCHOR_NODE_NAMES.has(node.type.name);
+const isZeroWidthAnchor = (node) => ANCHOR_ITEMS.has(node.type.name);
 /**
-* Whether the textblock holds nothing but zero-width anchors, which is what
-* "everything in it was resolved away" looks like in the document.
+* A node's width the way the engine counts it: an atom or leaf (text, a
+* field, an image) is one unit or more, a container (an inline content
+* control) counts its children in place, and an anchor counts as the engine
+* item it stands for, which for a zero-width item is no width.
 */
-const holdsNoContent = (block) => {
-	let empty = true;
+const collectParagraphContent = (node, zeroWidthItems) => {
+	if (node.type.name === "commentRangeBoundary") {
+		zeroWidthItems.push(expectCommentRangeBoundaryAttrs(node).marker.type);
+		return 0;
+	}
+	const item = ANCHOR_ITEMS.get(node.type.name);
+	if (item !== void 0) {
+		if (item === "unit") return 1;
+		zeroWidthItems.push(item);
+		return 0;
+	}
+	if (node.isAtom || node.isLeaf) return 1;
+	let width = 0;
+	node.forEach((child) => {
+		width += collectParagraphContent(child, zeroWidthItems);
+	});
+	return width;
+};
+/**
+* Whether the textblock holds content its paragraph mark must not take away,
+* by the engine's rule: the paragraph's width, and each anchor directly in
+* it counted as the engine item it stands for.
+*/
+const paragraphContentOf = (block) => {
+	let width = 0;
+	const zeroWidthItems = [];
 	block.forEach((child) => {
-		if (!isZeroWidthAnchor(child)) empty = false;
+		width += collectParagraphContent(child, zeroWidthItems);
+	});
+	return paragraphContentVerdict({
+		width,
+		zeroWidthItems
 	});
-	return empty;
 };
 //#endregion
-export { holdsNoContent, isZeroWidthAnchor };
+export { isZeroWidthAnchor, paragraphContentOf };

package/dist/redline.d.ts

@@ -3,7 +3,7 @@ import { FolioDocumentStoryHandle, FolioResolvedReviewedView } from "./ai-edits/
 import { FolioDocumentPrivacyOptions, FolioDocumentPrivacyReport } from "./docx/metadataPrivacy.js";
 //#region src/redline.d.ts
 /** Options for {@link generateRedlineDocx}. */
-type GenerateRedlineDocxOptions = {
+export type GenerateRedlineDocxOptions = {
   /** Author recorded on the generated tracked changes. (default: `"folio compare"`) */
   author?: string;
   /** Resolved base input state. (default: `"final"`) */
@@ -15,19 +15,19 @@ type GenerateRedlineDocxOptions = {
 };
 declare const InvalidGenerateRedlineDocxOptionsError_base: import("better-result").TaggedErrorClass<"InvalidGenerateRedlineDocxOptionsError">;
 /** Raised when a resolved input view is not `"original"` or `"final"`. */
-declare class InvalidGenerateRedlineDocxOptionsError extends InvalidGenerateRedlineDocxOptionsError_base<{
+export declare class InvalidGenerateRedlineDocxOptionsError extends InvalidGenerateRedlineDocxOptionsError_base<{
   message: string;
   option: "baseView" | "revisedView";
   receivedValue: unknown;
 }> {}
 declare const GenerateRedlineDocxResourceImportError_base: import("better-result").TaggedErrorClass<"GenerateRedlineDocxResourceImportError">;
 /** Raised before body operations when revised resources cannot be imported atomically. */
-declare class GenerateRedlineDocxResourceImportError extends GenerateRedlineDocxResourceImportError_base<{
+export declare class GenerateRedlineDocxResourceImportError extends GenerateRedlineDocxResourceImportError_base<{
   message: string;
   detail: string;
 }> {}
 /** A document story that could not be paired across the two input packages. */
-type GenerateRedlineUnprocessedStory = {
+export type GenerateRedlineUnprocessedStory = {
   /** Story in the base package, or `null` when it exists only in the revision. */
   baseStory: FolioDocumentStoryHandle | null;
   /** Story in the revised package, or `null` when it exists only in the base. */
@@ -36,7 +36,7 @@ type GenerateRedlineUnprocessedStory = {
   reason: "missing-base-story" | "missing-revised-story";
 };
 /** A source-undefined style cleared so it cannot acquire unrelated base meaning. */
-type GenerateRedlineReferenceWarning = {
+export type GenerateRedlineReferenceWarning = {
   /** Position in the revised story's ProseMirror projection. */
   paragraphPosition: number;
   story: FolioDocumentStoryHandle;
@@ -44,7 +44,7 @@ type GenerateRedlineReferenceWarning = {
   id: string;
 };
 /** Result of {@link generateRedlineDocx}. */
-type GenerateRedlineDocxResult = {
+export type GenerateRedlineDocxResult = {
   /** The base package with generated tracked changes. */
   buffer: ArrayBuffer;
   /** Operations applied across every matched story. */
@@ -59,6 +59,6 @@ type GenerateRedlineDocxResult = {
   privacyReport: FolioDocumentPrivacyReport;
 };
 /** Compare two buffers and return tracked changes for every matched editable story. */
-declare const generateRedlineDocx: (base: ArrayBuffer, revised: ArrayBuffer, options?: GenerateRedlineDocxOptions) => Promise<GenerateRedlineDocxResult>;
+export declare const generateRedlineDocx: (base: ArrayBuffer, revised: ArrayBuffer, options?: GenerateRedlineDocxOptions) => Promise<GenerateRedlineDocxResult>;
 //#endregion
-export { GenerateRedlineDocxOptions, GenerateRedlineDocxResourceImportError, GenerateRedlineDocxResult, GenerateRedlineReferenceWarning, GenerateRedlineUnprocessedStory, InvalidGenerateRedlineDocxOptionsError, generateRedlineDocx };
+export {};

package/dist/redline.js

@@ -303,7 +303,8 @@ const generateRedlineDocx = async (base, revised, options = {}) => {
 	}
 	const destinationStyles = new Set(baseAccess.styleDefinitions()?.styles.map(({ styleId }) => styleId));
 	for (const [index, { story, snapshot, revisedSnapshot, inserted }] of plannedStories.entries()) {
-		const insertedById = rebindInsertedResourceBlocks(inserted, resources.snapshots.at(index) ?? panic("A redline resource import lost its snapshot"));
+		const rebound = resources.snapshots.at(index) ?? panic("A redline resource import lost its snapshot");
+		const insertedById = rebindInsertedResourceBlocks(inserted, rebound);
 		const originalBlocksById = new Map(revisedSnapshot.blocks.map((block) => [block.id, block]));
 		for (const [id, imported] of insertedById) {
 			const original = originalBlocksById.get(id) ?? panic("A carried insertion lost its original block");

package/dist/redlineOperationLimit.d.ts

@@ -1,8 +1,8 @@
 //#region src/redlineOperationLimit.d.ts
-declare const MAX_GENERATED_REDLINE_OPERATIONS = 10000;
+export declare const MAX_GENERATED_REDLINE_OPERATIONS = 10000;
 declare const GenerateRedlineDocxOperationLimitError_base: import("better-result").TaggedErrorClass<"GenerateRedlineDocxOperationLimitError">;
-declare class GenerateRedlineDocxOperationLimitError extends GenerateRedlineDocxOperationLimitError_base<{
+export declare class GenerateRedlineDocxOperationLimitError extends GenerateRedlineDocxOperationLimitError_base<{
   message: string;
 }> {}
 //#endregion
-export { GenerateRedlineDocxOperationLimitError, MAX_GENERATED_REDLINE_OPERATIONS };
+export {};

package/dist/render-dom/BodySelectionOverlay.d.ts

@@ -1,14 +1,14 @@
 import { DisplayMode } from "../managers/EditorModeManager.js";
 import { EditorState } from "prosemirror-state";
 //#region src/render-dom/BodySelectionOverlay.d.ts
-type BodySelectionOverlayResult = {
+export type BodySelectionOverlayResult = {
   type: "text";
 } | {
   type: "image";
   element: HTMLElement;
   pmPos: number;
 };
-type SyncBodySelectionOverlayOptions = {
+export type SyncBodySelectionOverlayOptions = {
   pagesContainer: HTMLElement;
   state: EditorState;
   /** The review view the pages were laid out for; a caret in text it hides paints at its edge. */
@@ -18,9 +18,8 @@ type SyncBodySelectionOverlayOptions = {
   caretColor?: string;
   selectionColor?: string;
 };
-declare class BodySelectionOverlay {
+export declare class BodySelectionOverlay {
   clear(pagesContainer: HTMLElement): void;
   sync({ pagesContainer, state, markupView, zoom, zIndex, caretColor, selectionColor }: SyncBodySelectionOverlayOptions): BodySelectionOverlayResult;
 }
-//#endregion
-export { BodySelectionOverlay, BodySelectionOverlayResult, SyncBodySelectionOverlayOptions };
+//#endregion

package/dist/render-dom/HeaderFooterSelectionOverlay.d.ts

@@ -1,27 +1,26 @@
 import { HfSlotKind } from "../layout-bridge/dom/findHfPmSpans.js";
 //#region src/render-dom/HeaderFooterSelectionOverlay.d.ts
-type HeaderFooterSelection = {
+export type HeaderFooterSelection = {
   from: number;
   kind: HfSlotKind;
   pageNumber?: number;
   rId: string;
   to: number;
 };
-type HeaderFooterSelectionRect = {
+export type HeaderFooterSelectionRect = {
   height: number;
   width: number;
   x: number;
   y: number;
 };
-type HeaderFooterSelectionGeometry = {
+export type HeaderFooterSelectionGeometry = {
   caret: Omit<HeaderFooterSelectionRect, "width"> | null;
   ranges: HeaderFooterSelectionRect[];
 };
 /** Resolve a persistent header/footer PM selection against its painted DOM. */
-declare const resolveHeaderFooterSelectionGeometry: (pagesContainer: HTMLElement, selection: HeaderFooterSelection, zoom: number) => HeaderFooterSelectionGeometry;
-declare class HeaderFooterSelectionOverlay {
+export declare const resolveHeaderFooterSelectionGeometry: (pagesContainer: HTMLElement, selection: HeaderFooterSelection, zoom: number) => HeaderFooterSelectionGeometry;
+export declare class HeaderFooterSelectionOverlay {
   clear(pagesContainer: HTMLElement): void;
   sync(pagesContainer: HTMLElement, selection: HeaderFooterSelection | null, zoom: number): void;
 }
-//#endregion
-export { HeaderFooterSelection, HeaderFooterSelectionGeometry, HeaderFooterSelectionOverlay, HeaderFooterSelectionRect, resolveHeaderFooterSelectionGeometry };
+//#endregion

package/dist/render-dom/RemoteSelectionOverlay.d.ts

@@ -1,23 +1,22 @@
 import { RemoteSelection } from "../types/remote-selection.js";
 import { RenderedDomContext, RenderedDomPoint, RenderedDomRect } from "./RenderedDomContext.js";
 //#region src/render-dom/RemoteSelectionOverlay.d.ts
-type SyncRemoteSelectionOverlayOptions = {
+export type SyncRemoteSelectionOverlayOptions = {
   pagesContainer: HTMLElement;
   selections: readonly RemoteSelection[];
   zoom: number;
   zIndex?: number;
   renderedDomContext?: RenderedDomContext;
 };
-type RemoteSelectionOverlayGeometry = {
+export type RemoteSelectionOverlayGeometry = {
   caret: RenderedDomPoint | null;
   rects: RenderedDomRect[];
   selection: RemoteSelection;
 };
-declare const resolveRemoteSelectionOverlayGeometry: (renderedDomContext: RenderedDomContext, selections: readonly RemoteSelection[]) => RemoteSelectionOverlayGeometry[];
+export declare const resolveRemoteSelectionOverlayGeometry: (renderedDomContext: RenderedDomContext, selections: readonly RemoteSelection[]) => RemoteSelectionOverlayGeometry[];
 /** Paint collaborative cursors and selections over the rendered page DOM. */
-declare class RemoteSelectionOverlay {
+export declare class RemoteSelectionOverlay {
   clear(pagesContainer: HTMLElement): void;
   sync({ pagesContainer, selections, zoom, zIndex, renderedDomContext }: SyncRemoteSelectionOverlayOptions): void;
 }
-//#endregion
-export { RemoteSelectionOverlay, RemoteSelectionOverlayGeometry, SyncRemoteSelectionOverlayOptions, resolveRemoteSelectionOverlayGeometry };
+//#endregion

package/dist/render-dom/RenderedDomContext.d.ts

@@ -4,18 +4,18 @@
  * the layout painter. Framework adapters use this for decorations, anchored
  * chrome, and plugin surfaces without duplicating range geometry.
  */
-type RenderedDomPoint = {
+export type RenderedDomPoint = {
   x: number;
   y: number;
   height: number;
 };
-type RenderedDomRect = {
+export type RenderedDomRect = {
   x: number;
   y: number;
   width: number;
   height: number;
 };
-type RenderedDomContext = {
+export type RenderedDomContext = {
   getCoordinatesForPosition(pmPos: number): RenderedDomPoint | null;
   findElementsForRange(from: number, to: number): Element[];
   getRectsForRange(from: number, to: number): RenderedDomRect[];
@@ -24,7 +24,7 @@ type RenderedDomContext = {
     y: number;
   };
 };
-declare class RenderedDomContextImpl implements RenderedDomContext {
+export declare class RenderedDomContextImpl implements RenderedDomContext {
   #private;
   constructor(pagesContainer: HTMLElement, zoom?: number);
   getCoordinatesForPosition(pmPos: number): RenderedDomPoint | null;
@@ -35,6 +35,5 @@ declare class RenderedDomContextImpl implements RenderedDomContext {
     y: number;
   };
 }
-declare const createRenderedDomContext: (pagesContainer: HTMLElement, zoom?: number) => RenderedDomContext;
-//#endregion
-export { RenderedDomContext, RenderedDomContextImpl, RenderedDomPoint, RenderedDomRect, createRenderedDomContext };
+export declare const createRenderedDomContext: (pagesContainer: HTMLElement, zoom?: number) => RenderedDomContext;
+//#endregion

package/dist/render-dom/commentAnchorAttributes.d.ts

@@ -14,15 +14,15 @@
  * cannot come to answer differently.
  */
 /** The painted anchors inside a container, whichever comment they belong to. */
-declare const COMMENT_ANCHOR_SELECTOR = "[data-comment-id]";
+export declare const COMMENT_ANCHOR_SELECTOR = "[data-comment-id]";
 /** What a painter, a reader and their test fakes all offer. */
 type CommentAnchor = {
   dataset: Record<string, string | undefined>;
 };
 /** Record the comments a painted run sits inside. */
-declare const writeCommentAnchorIds: (element: CommentAnchor, commentIds: readonly number[]) => void;
+export declare const writeCommentAnchorIds: (element: CommentAnchor, commentIds: readonly number[]) => void;
 /** Every comment id a painted anchor sits inside, first id first. */
-declare const commentAnchorIds: (element: CommentAnchor) => readonly string[];
+export declare const commentAnchorIds: (element: CommentAnchor) => readonly string[];
 /**
  * Selector for every painted anchor inside one comment, optionally scoped.
  *
@@ -30,8 +30,8 @@ declare const commentAnchorIds: (element: CommentAnchor) => readonly string[];
  * by the host app is not runtime-checked, so the value is escaped before it is
  * spliced into the selector.
  */
-declare const commentAnchorSelector: (id: string | number, scope?: string) => string;
+export declare const commentAnchorSelector: (id: string | number, scope?: string) => string;
 /** First painted anchor per comment id, in one pass over `container`. */
-declare const indexCommentAnchors: (container: ParentNode) => Map<string, HTMLElement>;
+export declare const indexCommentAnchors: (container: ParentNode) => Map<string, HTMLElement>;
 //#endregion
-export { COMMENT_ANCHOR_SELECTOR, commentAnchorIds, commentAnchorSelector, indexCommentAnchors, writeCommentAnchorIds };
+export {};

package/dist/render-dom/resolveSidebarItemPositions.d.ts

@@ -1,6 +1,6 @@
 import { RenderedDomContext } from "./RenderedDomContext.js";
 //#region src/render-dom/resolveSidebarItemPositions.d.ts
-type RenderedSidebarItem = {
+export type RenderedSidebarItem = {
   id: string;
   anchorPos: number;
   anchorKey?: string;
@@ -8,11 +8,11 @@ type RenderedSidebarItem = {
   fixedY?: number;
   estimatedHeight?: number;
 };
-type ResolvedSidebarItemPosition<T extends RenderedSidebarItem = RenderedSidebarItem> = {
+export type ResolvedSidebarItemPosition<T extends RenderedSidebarItem = RenderedSidebarItem> = {
   item: T;
   y: number;
 };
-type ResolveSidebarItemPositionsOptions<T extends RenderedSidebarItem> = {
+export type ResolveSidebarItemPositionsOptions<T extends RenderedSidebarItem> = {
   items: T[];
   anchorPositions: Map<string, number>;
   renderedDomContext: RenderedDomContext | null;
@@ -20,6 +20,5 @@ type ResolveSidebarItemPositionsOptions<T extends RenderedSidebarItem> = {
   cardHeights: Map<string, number>;
   lastKnown: Map<string, number>;
 };
-declare const resolveSidebarItemPositions: <T extends RenderedSidebarItem>({ items, anchorPositions, renderedDomContext, zoom, cardHeights, lastKnown }: ResolveSidebarItemPositionsOptions<T>) => ResolvedSidebarItemPosition<T>[];
-//#endregion
-export { RenderedSidebarItem, ResolveSidebarItemPositionsOptions, ResolvedSidebarItemPosition, resolveSidebarItemPositions };
+export declare const resolveSidebarItemPositions: <T extends RenderedSidebarItem>({ items, anchorPositions, renderedDomContext, zoom, cardHeights, lastKnown }: ResolveSidebarItemPositionsOptions<T>) => ResolvedSidebarItemPosition<T>[];
+//#endregion

package/dist/reviewHistoryLimits.d.ts

@@ -0,0 +1,3 @@
+//#region src/reviewHistoryLimits.d.ts
+export declare const MAX_REVIEW_HISTORY_ATTRIBUTE_LENGTH = 32768;
+//#endregion

package/dist/reviewHistoryLimits.js

@@ -0,0 +1,4 @@
+//#region src/reviewHistoryLimits.ts
+const MAX_REVIEW_HISTORY_ATTRIBUTE_LENGTH = 32768;
+//#endregion
+export { MAX_REVIEW_HISTORY_ATTRIBUTE_LENGTH };

package/dist/server.d.ts

@@ -6,6 +6,7 @@ import { FolioReviewChange, FolioReviewChangeKind } from "./ai-edits/read.js";
 import { createFolioAITextRangeHandle, hashFolioAIBlockText, isFolioAIContentBlock, normalizeFolioAIBlockText } from "./ai-edits/snapshot.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, FolioReviewerRepackReason, FolioReviewerSaveOptions, FolioReviewerSaveResult, UnsupportedFolioReviewedViewError, applyFolioAIEditsToBuffer, isFolioResolvedReviewedView, isFolioReviewedView } from "./ai-edits/headless.js";
 import { getFolioDocumentOutline, readFolioDocumentSection } from "./ai-edits/scoped-reading.js";
+import { getFolioDocumentOperationRemovedBlockIds, getTrackedFolioDocumentOperationRemovedBlockIds } from "./ai-edits/removed-blocks.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";
 import { CreateEmptyDocumentOptions, createEmptyDocument } from "./utils/createDocument.js";
@@ -31,4 +32,4 @@ import { FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES, FOLIO_YJS_PROSEMIRROR_FRAGM
 import { FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES, FolioYjsSnapshotMigrationError, FolioYjsSnapshotMigrationErrorCode, FolioYjsSnapshotMigrationResult, migrateFolioYjsSnapshot } from "./docx/server/migrateYjsAttrSchema.js";
 import { GenerateRedlineDocxOptions, GenerateRedlineDocxResourceImportError, GenerateRedlineDocxResult, GenerateRedlineReferenceWarning, GenerateRedlineUnprocessedStory, InvalidGenerateRedlineDocxOptionsError, generateRedlineDocx } from "./redline.js";
 import { FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FolioBlockDiff, FolioBlockProperty, FolioCompareDocxVersionsOptions, FolioDocumentMetadataValue, FolioFormatProperty, FolioMetadataDiff, FolioStoryDiff, FolioVersionBlockHandle, FolioVersionChangeProperty, 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 DocumentPropertiesOptions, 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 ExtractDocxTextOptions, 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_LINE_SPACING_RULE_VALUES, FOLIO_PAGE_BREAK_CLEAR_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FOLIO_YJS_ATTR_SCHEMA_VERSION, FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES, FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME, FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES, FOLIO_YJS_UPDATE_MAX_BYTES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, type FolioAIComment, type FolioAIDiagnosticBlock, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditSnapshot, type FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIParagraphBlock, type FolioAIParagraphSpacing, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsOptions, type FolioApplyDocumentOperationsToStoryOptions, type FolioApplyOperationsOptions, type FolioBlockDiff, type FolioBlockId, type FolioBlockProperty, type FolioCompareDocxVersionsOptions, type FolioContentParagraphKind, 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 FolioDocumentOperationResultBase, 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 FolioReviewerRepackReason, type FolioReviewerSaveOptions, type FolioReviewerSaveResult, type FolioRevisionStamp, type FolioStoryDiff, type FolioVersionBlockHandle, type FolioVersionChangeProperty, type FolioVersionComparisonPrivacyTransform, type FolioVersionComparisonScope, type FolioVersionDiff, type FolioVersionDiffPrivacyOptions, type FolioVersionDiffPrivacyReport, type FolioVersionDiffSegment, type FolioVersionDiffSummaryCounts, type FolioYjsAttrSchemaVersion, FolioYjsAttrSchemaVersionError, FolioYjsDocxMaterializationError, type FolioYjsDocxMaterializationErrorCode, FolioYjsSnapshotMigrationError, type FolioYjsSnapshotMigrationErrorCode, type FolioYjsSnapshotMigrationResult, type GenerateRedlineDocxOptions, GenerateRedlineDocxResourceImportError, type GenerateRedlineDocxResult, type GenerateRedlineReferenceWarning, 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, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, materializeYjsDocx, migrateFolioYjsSnapshot, 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 DocumentPropertiesOptions, 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 ExtractDocxTextOptions, 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_LINE_SPACING_RULE_VALUES, FOLIO_PAGE_BREAK_CLEAR_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FOLIO_YJS_ATTR_SCHEMA_VERSION, FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES, FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME, FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES, FOLIO_YJS_UPDATE_MAX_BYTES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, type FolioAIComment, type FolioAIDiagnosticBlock, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditSnapshot, type FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIParagraphBlock, type FolioAIParagraphSpacing, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsOptions, type FolioApplyDocumentOperationsToStoryOptions, type FolioApplyOperationsOptions, type FolioBlockDiff, type FolioBlockId, type FolioBlockProperty, type FolioCompareDocxVersionsOptions, type FolioContentParagraphKind, 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 FolioDocumentOperationResultBase, 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 FolioReviewerRepackReason, type FolioReviewerSaveOptions, type FolioReviewerSaveResult, type FolioRevisionStamp, type FolioStoryDiff, type FolioVersionBlockHandle, type FolioVersionChangeProperty, type FolioVersionComparisonPrivacyTransform, type FolioVersionComparisonScope, type FolioVersionDiff, type FolioVersionDiffPrivacyOptions, type FolioVersionDiffPrivacyReport, type FolioVersionDiffSegment, type FolioVersionDiffSummaryCounts, type FolioYjsAttrSchemaVersion, FolioYjsAttrSchemaVersionError, FolioYjsDocxMaterializationError, type FolioYjsDocxMaterializationErrorCode, FolioYjsSnapshotMigrationError, type FolioYjsSnapshotMigrationErrorCode, type FolioYjsSnapshotMigrationResult, type GenerateRedlineDocxOptions, GenerateRedlineDocxResourceImportError, type GenerateRedlineDocxResult, type GenerateRedlineReferenceWarning, 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, getFolioDocumentOperationRemovedBlockIds, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedFolioDocumentOperationRemovedBlockIds, hashFolioAIBlockText, heading, hyperlink, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, materializeYjsDocx, migrateFolioYjsSnapshot, normalizeFolioAIBlockText, pageBreak, paragraph, parseDocx, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readBilingualDocument, readBilingualDocx, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, run, table, validateDocxConformance };

package/dist/server.js

@@ -1,4 +1,5 @@
 import { FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioDocumentStoryNotFoundError, FolioDocxReviewer, UnsupportedFolioReviewedViewError, applyFolioAIEditsToBuffer, isFolioResolvedReviewedView, isFolioReviewedView } from "./ai-edits/headless.js";
+import { getFolioDocumentOperationRemovedBlockIds, getTrackedFolioDocumentOperationRemovedBlockIds } from "./ai-edits/removed-blocks.js";
 import { getFolioDocumentOutline, readFolioDocumentSection } from "./ai-edits/scoped-reading.js";
 import { createFolioAITextRangeHandle, hashFolioAIBlockText, isFolioAIContentBlock, normalizeFolioAIBlockText } from "./ai-edits/snapshot.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, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PAGE_BREAK_CLEAR_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "./document-operations.js";
@@ -27,4 +28,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_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_LINE_SPACING_RULE_VALUES, FOLIO_PAGE_BREAK_CLEAR_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FOLIO_YJS_ATTR_SCHEMA_VERSION, FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES, FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME, FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES, FOLIO_YJS_UPDATE_MAX_BYTES, FolioDocumentPrivacyArchiveError, FolioDocumentStoryNotFoundError, FolioDocxPackageInspectionError, FolioDocxReviewer, FolioDocxXmlPatchApplicationError, FolioYjsAttrSchemaVersionError, FolioYjsDocxMaterializationError, FolioYjsSnapshotMigrationError, GenerateRedlineDocxResourceImportError, 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, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, materializeYjsDocx, migrateFolioYjsSnapshot, 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_LINE_SPACING_RULE_VALUES, FOLIO_PAGE_BREAK_CLEAR_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FOLIO_YJS_ATTR_SCHEMA_VERSION, FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES, FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME, FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES, FOLIO_YJS_UPDATE_MAX_BYTES, FolioDocumentPrivacyArchiveError, FolioDocumentStoryNotFoundError, FolioDocxPackageInspectionError, FolioDocxReviewer, FolioDocxXmlPatchApplicationError, FolioYjsAttrSchemaVersionError, FolioYjsDocxMaterializationError, FolioYjsSnapshotMigrationError, GenerateRedlineDocxResourceImportError, 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, getFolioDocumentOperationRemovedBlockIds, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedFolioDocumentOperationRemovedBlockIds, hashFolioAIBlockText, heading, hyperlink, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxPackage, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, materializeYjsDocx, migrateFolioYjsSnapshot, normalizeFolioAIBlockText, pageBreak, paragraph, parseDocx, parseFolioDocumentOperationBatch, parseFolioDocxXmlPatchProposal, readBilingualDocument, readBilingualDocx, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy, run, table, validateDocxConformance };

package/dist/shaping/placeRun.d.ts

@@ -4,7 +4,7 @@ import { Shaper, ShapingDirection } from "./shaper.js";
  * One glyph, placed. Advances and offsets are in CSS pixels at the run's size;
  * the glyph id belongs to the face that was shaped, not to any subset of it.
  */
-type PlacedGlyph = {
+export type PlacedGlyph = {
   readonly glyphId: number;
   /**
    * Index into the run's code points of the cluster this glyph belongs to.
@@ -16,7 +16,7 @@ type PlacedGlyph = {
   readonly xOffsetPx: number;
   readonly yOffsetPx: number;
 };
-type PlaceRunOptions = {
+export type PlaceRunOptions = {
   readonly shaper: Shaper;
   /** sfnt bytes of the binary that covers this text. */
   readonly font: Uint8Array;
@@ -26,8 +26,8 @@ type PlaceRunOptions = {
   readonly direction?: ShapingDirection;
 };
 /** Whether a run's glyphs can be chosen from its code points alone. */
-declare const needsShaping: (text: string) => boolean;
-declare const directionOf: (text: string) => ShapingDirection;
+export declare const needsShaping: (text: string) => boolean;
+export declare const directionOf: (text: string) => ShapingDirection;
 /**
  * Shape and place one run against one binary.
  *
@@ -35,7 +35,7 @@ declare const directionOf: (text: string) => ShapingDirection;
  * subsets of a family is placed one segment at a time, because a glyph id only
  * means anything in the binary it came from.
  */
-declare const placeRun: ({ shaper, font, text, fontSizePx, direction }: PlaceRunOptions) => readonly PlacedGlyph[];
+export declare const placeRun: ({ shaper, font, text, fontSizePx, direction }: PlaceRunOptions) => readonly PlacedGlyph[];
 /**
  * The run's advance spread over its code points, one number each.
  *
@@ -46,6 +46,5 @@ declare const placeRun: ({ shaper, font, text, fontSizePx, direction }: PlaceRun
  * would invent a boundary the font does not have. The sum is exact, which is
  * what line breaking and every caller downstream reads.
  */
-declare const advancesPerCodePointPx: (glyphs: readonly PlacedGlyph[], codePointCount: number) => readonly number[];
-//#endregion
-export { PlaceRunOptions, PlacedGlyph, advancesPerCodePointPx, directionOf, needsShaping, placeRun };
+export declare const advancesPerCodePointPx: (glyphs: readonly PlacedGlyph[], codePointCount: number) => readonly number[];
+//#endregion