@stll/folio-core 0.8.0 → 0.10.0

package/dist/prosemirror/extensions/marks/LanguageExtension.js

@@ -0,0 +1,30 @@
+import { expectLanguageMarkAttrs } from "../../attrs/index.js";
+import { createMarkExtension } from "../create.js";
+//#region src/prosemirror/extensions/marks/LanguageExtension.ts
+/** Preserve OOXML `w:lang` and expose its primary language to the editing DOM. */
+const LanguageExtension = createMarkExtension({
+	name: "language",
+	schemaMarkName: "language",
+	markSpec: {
+		attrs: {
+			val: { default: null },
+			eastAsia: { default: null },
+			bidi: { default: null }
+		},
+		parseDOM: [{
+			tag: "span[lang]",
+			getAttrs: (dom) => typeof dom === "string" ? false : { val: dom.getAttribute("lang") ?? void 0 }
+		}],
+		toDOM(mark) {
+			const { val, eastAsia, bidi } = expectLanguageMarkAttrs(mark);
+			const language = val ?? eastAsia ?? bidi;
+			return language ? [
+				"span",
+				{ lang: language },
+				0
+			] : ["span", 0];
+		}
+	}
+});
+//#endregion
+export { LanguageExtension };

package/dist/prosemirror/extensions/marks/RunShadingExtension.js

@@ -1,6 +1,6 @@
-import { ensureHexPrefix } from "../../../utils/colorResolver.js";
 import { expectRunShadingMarkAttrs } from "../../attrs/index.js";
 import { createMarkExtension } from "../create.js";
+import { ensureHexPrefix } from "../../../utils/colorResolver.js";
 import { normalizeCssColorKey, parseDOMHighlightColor } from "./HighlightExtension.js";
 //#region src/prosemirror/extensions/marks/RunShadingExtension.ts
 const RunShadingExtension = createMarkExtension({

package/dist/prosemirror/extensions/marks/TextColorExtension.js

@@ -1,6 +1,6 @@
-import { textToStyle } from "../../../utils/formatToStyle.js";
 import { expectTextColorMarkAttrs } from "../../attrs/index.js";
 import { createMarkExtension } from "../create.js";
+import { textToStyle } from "../../../utils/formatToStyle.js";
 import { removeMark, setMark } from "./markUtils.js";
 import { panic } from "better-result";
 //#region src/prosemirror/extensions/marks/TextColorExtension.ts

package/dist/prosemirror/extensions/marks/TrackedChangeExtensions.js

@@ -1,6 +1,6 @@
-import { AUTHOR_COLORS, getAuthorColorIdx } from "../../../utils/authorColors.js";
 import { expectTrackedChangeMarkAttrs } from "../../attrs/index.js";
 import { createMarkExtension } from "../create.js";
+import { AUTHOR_COLORS, getAuthorColorIdx } from "../../../utils/authorColors.js";
 //#region src/prosemirror/extensions/marks/TrackedChangeExtensions.ts
 /**
 * Tracked Change Mark Extensions — insertion and deletion marks

package/dist/prosemirror/extensions/marks/markUtils.js

@@ -43,6 +43,17 @@ function marksToTextFormatting(marks) {
 			};
 			break;
 		}
+		case "language": {
+			const val = mark.attrs["val"];
+			const eastAsia = mark.attrs["eastAsia"];
+			const bidi = mark.attrs["bidi"];
+			formatting.language = {
+				...typeof val === "string" ? { val } : {},
+				...typeof eastAsia === "string" ? { eastAsia } : {},
+				...typeof bidi === "string" ? { bidi } : {}
+			};
+			break;
+		}
 		case "superscript":
 			formatting.vertAlign = "superscript";
 			break;
@@ -186,6 +197,7 @@ function textFormattingToMarks(formatting, schema) {
 		hAnsi: formatting.fontFamily.hAnsi,
 		asciiTheme: formatting.fontFamily.asciiTheme
 	}));
+	if (formatting.language && schema.marks["language"]) marks.push(schema.marks["language"].create(formatting.language));
 	if (formatting.vertAlign === "superscript" && schema.marks["superscript"]) marks.push(schema.marks["superscript"].create());
 	if (formatting.vertAlign === "subscript" && schema.marks["subscript"]) marks.push(schema.marks["subscript"].create());
 	if (formatting.rtl && schema.marks["rtl"]) marks.push(schema.marks["rtl"].create());

package/dist/prosemirror/extensions/nodes/ImageExtension.js

@@ -33,12 +33,14 @@ const ImageExtension = createNodeExtension({
 			cropBottom: { default: null },
 			cropLeft: { default: null },
 			position: { default: null },
+			layoutInCell: { default: null },
 			borderWidth: { default: null },
 			borderColor: { default: null },
 			borderStyle: { default: null },
 			wrapText: { default: null },
 			hlinkHref: { default: null },
-			_docxRawXml: { default: null }
+			_docxRawXml: { default: null },
+			_docxObjectPreview: { default: null }
 		},
 		parseDOM: [{
 			tag: "img[src]",

package/dist/prosemirror/extensions/nodes/TableExtension.js

@@ -1,11 +1,11 @@
 import { TABLE_CELL_TEXT_DIRECTION_VALUES, TABLE_WIDTH_TYPE_VALUES } from "../../../types/documentEnumValues.js";
-import { resolveColor } from "../../../utils/colorResolver.js";
 import { expectTableAttrs, expectTableCellAttrs, expectTableRowAttrs, mergeTableAttrs, mergeTableCellAttrs, mergeTableRowAttrs } from "../../attrs/index.js";
 import { createExtension, createNodeExtension } from "../create.js";
+import { resolveColor } from "../../../utils/colorResolver.js";
 import { panic } from "better-result";
 import { Plugin, PluginKey, Selection, TextSelection } from "prosemirror-state";
-import { Decoration, DecorationSet } from "prosemirror-view";
 import { CellSelection, TableMap, columnResizing, mergeCells, removeRow, selectedRect, splitCell, tableEditing } from "prosemirror-tables";
+import { Decoration, DecorationSet } from "prosemirror-view";
 //#region src/prosemirror/extensions/nodes/TableExtension.ts
 /**
 * Table Extension — 4 node specs + plugins + commands
@@ -310,6 +310,7 @@ const tableCellSpec = {
 		widthType: { default: null },
 		verticalAlign: { default: null },
 		backgroundColor: { default: null },
+		_resolvedBackgroundColor: { default: null },
 		borders: { default: null },
 		margins: { default: null },
 		textDirection: { default: null },
@@ -363,6 +364,7 @@ const tableHeaderSpec = {
 		widthType: { default: null },
 		verticalAlign: { default: null },
 		backgroundColor: { default: null },
+		_resolvedBackgroundColor: { default: null },
 		borders: { default: null },
 		margins: { default: null },
 		textDirection: { default: null },

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

@@ -1,6 +1,6 @@
 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, RunFormattingOverrideAttrs, RunShadingAttrs, StrikeAttrs, TextColorAttrs, TextEffectAttrs, TrackedChangeMarkAttrs, UnderlineAttrs } from "./marks.js";
+import { CharacterSpacingAttrs, CharacterStyleAttrs, CommentAttrs, EmphasisMarkAttrs, FontFamilyAttrs, FontSizeAttrs, FootnoteRefAttrs, HighlightAttrs, HyperlinkAttrs, LanguageAttrs, RunFormattingOverrideAttrs, RunShadingAttrs, StrikeAttrs, TextColorAttrs, TextEffectAttrs, TrackedChangeMarkAttrs, UnderlineAttrs } from "./marks.js";
 
 //#region src/prosemirror/schema/index.d.ts
 declare const singletonManager: ExtensionManager;
@@ -12,4 +12,4 @@ type DocxSchema = typeof schema;
 type DocxNode = ReturnType<typeof schema.node>;
 type DocxMark = ReturnType<typeof schema.mark>;
 //#endregion
-export { type BlockSdtAttrs, type CharacterSpacingAttrs, type CharacterStyleAttrs, type CommentAttrs, DocxMark, DocxNode, DocxSchema, type EmphasisMarkAttrs, type FieldAttrs, type FontFamilyAttrs, type FontSizeAttrs, type FootnoteRefAttrs, type HardBreakAttrs, type HighlightAttrs, type HyperlinkAttrs, type ImageAttrs, type ImagePositionAttrs, type MathAttrs, type ParagraphAttrs, type RunFormattingOverrideAttrs, type RunShadingAttrs, type SdtAttrs, type ShapeAttrs, type StrikeAttrs, type TableAttrs, type TableCellAttrs, type TableRowAttrs, type TextBoxAttrs, type TextColorAttrs, type TextEffectAttrs, type TrackedChangeMarkAttrs, type UnderlineAttrs, schema, singletonManager };
+export { type BlockSdtAttrs, type CharacterSpacingAttrs, type CharacterStyleAttrs, type CommentAttrs, DocxMark, DocxNode, DocxSchema, type EmphasisMarkAttrs, type FieldAttrs, type FontFamilyAttrs, type FontSizeAttrs, type FootnoteRefAttrs, type HardBreakAttrs, type HighlightAttrs, type HyperlinkAttrs, type ImageAttrs, type ImagePositionAttrs, type LanguageAttrs, type MathAttrs, type ParagraphAttrs, type RunFormattingOverrideAttrs, type RunShadingAttrs, type SdtAttrs, type ShapeAttrs, type StrikeAttrs, type TableAttrs, type TableCellAttrs, type TableRowAttrs, type TextBoxAttrs, type TextColorAttrs, type TextEffectAttrs, type TrackedChangeMarkAttrs, type UnderlineAttrs, schema, singletonManager };

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

@@ -40,6 +40,11 @@ type FontFamilyAttrs = {
   eastAsiaTheme?: string;
   csTheme?: string;
 };
+type LanguageAttrs = {
+  val?: string;
+  eastAsia?: string;
+  bidi?: string;
+};
 type HighlightAttrs = {
   color: NonNullable<document_d_exports.TextFormatting["highlight"]>;
 };
@@ -115,4 +120,4 @@ type HyperlinkAttrs = {
   _docxHyperlinkIndex?: number;
 };
 //#endregion
-export { CharacterSpacingAttrs, CharacterStyleAttrs, CommentAttrs, EmphasisMarkAttrs, FontFamilyAttrs, FontSizeAttrs, FootnoteRefAttrs, HighlightAttrs, HyperlinkAttrs, RunFormattingOverrideAttrs, RunShadingAttrs, StrikeAttrs, TextColorAttrs, TextEffectAttrs, TrackedChangeMarkAttrs, UnderlineAttrs };
+export { CharacterSpacingAttrs, CharacterStyleAttrs, CommentAttrs, EmphasisMarkAttrs, FontFamilyAttrs, FontSizeAttrs, FootnoteRefAttrs, HighlightAttrs, HyperlinkAttrs, LanguageAttrs, RunFormattingOverrideAttrs, RunShadingAttrs, StrikeAttrs, TextColorAttrs, TextEffectAttrs, TrackedChangeMarkAttrs, UnderlineAttrs };

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

@@ -13,7 +13,10 @@ type HardBreakAttrs = {
 type ParagraphAttrs = {
   paraId?: string;
   textId?: string;
-  alignment?: document_d_exports.ParagraphAlignment;
+  alignment?: document_d_exports.ParagraphAlignment; /** Effective East Asian line-edge policy (`w:kinsoku`). */
+  kinsoku?: boolean; /** Effective hanging-punctuation policy (`w:overflowPunct`). */
+  overflowPunctuation?: boolean; /** Effective paragraph opt-out from document automatic hyphenation. */
+  suppressAutoHyphens?: boolean;
   spaceBefore?: number;
   spaceAfter?: number;
   lineSpacing?: number;
@@ -46,7 +49,8 @@ type ParagraphAttrs = {
   listMarker?: string; /** Whether the list marker is hidden (w:vanish on numbering level rPr) */
   listMarkerHidden?: boolean; /** Marker font family from numbering level rPr */
   listMarkerFontFamily?: string; /** Marker font size from numbering level rPr, in points */
-  listMarkerFontSize?: number; /** Horizontal alignment of the marker around the paragraph's list anchor. */
+  listMarkerFontSize?: number; /** Marker bold state from numbering level rPr */
+  listMarkerBold?: boolean; /** Horizontal alignment of the marker around the paragraph's list anchor. */
   listMarkerAlignment?: "left" | "center" | "right";
   /**
    * `w:suff` (§17.9.25) — what follows the marker before body text.
@@ -83,7 +87,8 @@ type ParagraphAttrs = {
   shading?: document_d_exports.ShadingProperties;
   tabs?: document_d_exports.TabStop[];
   pageBreakBefore?: boolean; /** Word's cached rendered-page-break marker; preserved for round-trip only. */
-  renderedPageBreakBefore?: boolean;
+  renderedPageBreakBefore?: boolean; /** Internal import marker for a paragraph whose only run content is a hard page break. */
+  _pageBreakCarrier?: boolean;
   keepNext?: boolean;
   keepLines?: boolean;
   widowControl?: boolean; /** Contextual spacing — suppress space between same-style paragraphs */
@@ -192,13 +197,15 @@ type ImageAttrs = {
   cropRight?: number;
   cropBottom?: number;
   cropLeft?: number; /** Position for floating images (horizontal and vertical alignment) */
-  position?: ImagePositionAttrs; /** Border width in pixels */
+  position?: ImagePositionAttrs; /** Use the containing table cell as the anchor's positioning scope (the OOXML default). */
+  layoutInCell?: boolean; /** Border width in pixels */
   borderWidth?: number; /** Border color as CSS color string */
   borderColor?: string; /** Border style (CSS border-style value) */
   borderStyle?: string; /** Wrap text setting from DOCX (left, right, bothSides, largest) for round-trip */
   wrapText?: NonNullable<document_d_exports.ImageWrap["wrapText"]>; /** Hyperlink URL for clickable image */
   hlinkHref?: string; /** Original OOXML for opaque/unsupported DOCX drawings. */
-  _docxRawXml?: string;
+  _docxRawXml?: string; /** Embedded-object previews use their authored box as the exact line height. */
+  _docxObjectPreview?: boolean;
 };
 /**
  * Field node attributes
@@ -375,15 +382,11 @@ type TableCellAttrs = {
   width?: number; /** Cell width type */
   widthType?: document_d_exports.TableWidthType; /** Vertical alignment */
   verticalAlign?: "top" | "center" | "bottom"; /** Background color (RGB hex) */
-  backgroundColor?: string; /** OOXML text direction (e.g. 'tbRl', 'btLr') */
+  backgroundColor?: string; /** Resolved source color. PM-only; distinguishes theme rendering from a user override. */
+  _resolvedBackgroundColor?: string; /** OOXML text direction (e.g. 'tbRl', 'btLr') */
   textDirection?: NonNullable<document_d_exports.TableCellFormatting["textDirection"]>; /** No text wrapping in cell */
   noWrap?: boolean; /** Cell borders — full BorderSpec per side (style, color, size) */
-  borders?: {
-    top?: document_d_exports.BorderSpec;
-    bottom?: document_d_exports.BorderSpec;
-    left?: document_d_exports.BorderSpec;
-    right?: document_d_exports.BorderSpec;
-  }; /** Cell margins/padding in twips per side */
+  borders?: document_d_exports.TableCellBorders; /** Cell margins/padding in twips per side */
   margins?: {
     top?: number;
     bottom?: number;

package/dist/prosemirror/styles/resolvedStyleAttrs.js

@@ -86,6 +86,7 @@ function listAttrsFromResolvedStyle(resolved, numbering) {
 		listMarkerHidden: rendering?.markerHidden ?? null,
 		listMarkerFontFamily: rendering?.markerFontFamily ?? null,
 		listMarkerFontSize: rendering?.markerFontSize ?? null,
+		listMarkerBold: rendering?.markerBold ?? null,
 		listMarkerAlignment: rendering?.markerAlignment ?? null,
 		listMarkerSuffix: rendering?.markerSuffix ?? null,
 		listMarkerAllCaps: rendering?.markerAllCaps ?? null,

package/dist/prosemirror/utils/tabCalculator.d.ts

@@ -64,7 +64,9 @@ declare function pixelsToTwips(pixels: number): number;
  * Compute the list of effective tab stops for a paragraph
  *
  * Merges explicit stops with default stops at regular intervals.
- * Filters out stops that fall before the left indent.
+ * Explicit stops before the left indent remain available to a hanging first
+ * line. Continuation lines naturally skip them because their cursor already
+ * starts at the left indent.
  *
  * @param context - Tab context with explicit stops and settings
  * @returns Sorted array of tab stops in twips

package/dist/prosemirror/utils/tabCalculator.js

@@ -27,25 +27,27 @@ function pixelsToTwips(pixels) {
 * Compute the list of effective tab stops for a paragraph
 *
 * Merges explicit stops with default stops at regular intervals.
-* Filters out stops that fall before the left indent.
+* Explicit stops before the left indent remain available to a hanging first
+* line. Continuation lines naturally skip them because their cursor already
+* starts at the left indent.
 *
 * @param context - Tab context with explicit stops and settings
 * @returns Sorted array of tab stops in twips
 */
 function computeTabStops(context) {
 	const { explicitStops = [], defaultTabInterval = 720, leftIndent = 0 } = context;
-	const validExplicitStops = explicitStops.filter((stop) => stop.val !== "clear").filter((stop) => stop.pos >= leftIndent);
+	const validExplicitStops = explicitStops.filter((stop) => stop.val !== "clear");
 	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];
-	if (leftIndent > 0 && !validExplicitStops.some((s) => s.pos <= leftIndent)) {
-		if (!clearPositions.some((p) => Math.abs(p - leftIndent) < 20)) stops.push({
-			val: "start",
-			pos: leftIndent,
-			leader: "none"
-		});
-	}
+	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({
+		val: "start",
+		pos: leftIndent,
+		leader: "none"
+	});
 	let pos = Math.floor(Math.max(maxExplicit, leftIndent) / defaultTabInterval) * defaultTabInterval;
 	const limitPos = leftIndent + 14400;
 	while (pos < limitPos) {
@@ -60,7 +62,7 @@ function computeTabStops(context) {
 			hasClearStop = true;
 			break;
 		}
-		const isAtLeftIndent = leftIndent > 0 && Math.abs(pos - leftIndent) < 20;
+		const isAtLeftIndent = addsImplicitLeftIndent && Math.abs(pos - leftIndent) < 20;
 		if (!hasExplicitStop && !hasClearStop && !isAtLeftIndent) stops.push({
 			val: "start",
 			pos,

package/dist/prosemirror/validation.js

@@ -1,4 +1,4 @@
-import { readBlockSdtAttrs, readCharacterSpacingMarkAttrs, readCharacterStyleMarkAttrs, readCommentMarkAttrs, readEmphasisMarkAttrs, readFieldAttrs, readFontFamilyMarkAttrs, readFontSizeMarkAttrs, readFootnoteRefMarkAttrs, readHardBreakAttrs, readHighlightMarkAttrs, readHyperlinkMarkAttrs, readImageAttrs, readMathAttrs, readParagraphAttrs, readRunFormattingOverrideMarkAttrs, readRunShadingMarkAttrs, readSdtAttrs, readShapeAttrs, readStrikeMarkAttrs, readTableAttrs, readTableCellAttrs, readTableRowAttrs, readTextBoxAttrs, readTextColorMarkAttrs, readTextEffectMarkAttrs, readTrackedChangeMarkAttrs, readUnderlineMarkAttrs } from "./attrs/index.js";
+import { readBlockSdtAttrs, readCharacterSpacingMarkAttrs, readCharacterStyleMarkAttrs, readCommentMarkAttrs, readEmphasisMarkAttrs, readFieldAttrs, readFontFamilyMarkAttrs, readFontSizeMarkAttrs, readFootnoteRefMarkAttrs, readHardBreakAttrs, readHighlightMarkAttrs, readHyperlinkMarkAttrs, readImageAttrs, readLanguageMarkAttrs, readMathAttrs, readParagraphAttrs, readRunFormattingOverrideMarkAttrs, readRunShadingMarkAttrs, readSdtAttrs, readShapeAttrs, readStrikeMarkAttrs, readTableAttrs, readTableCellAttrs, readTableRowAttrs, readTextBoxAttrs, readTextColorMarkAttrs, readTextEffectMarkAttrs, readTrackedChangeMarkAttrs, readUnderlineMarkAttrs } from "./attrs/index.js";
 //#region src/prosemirror/validation.ts
 var ProseMirrorDocumentValidationError = class extends Error {
 	issues;
@@ -133,6 +133,9 @@ const validateMarks = (marks, path, issues) => {
 			case "fontFamily":
 				appendAttrIssues(markPath, readFontFamilyMarkAttrs(mark), issues);
 				continue;
+			case "language":
+				appendAttrIssues(markPath, readLanguageMarkAttrs(mark), issues);
+				continue;
 			case "characterSpacing":
 				appendAttrIssues(markPath, readCharacterSpacingMarkAttrs(mark), issues);
 				continue;

package/dist/redline.d.ts

@@ -1,20 +1,35 @@
-import { FolioAIEditApplyResult } from "./ai-edits/types.js";
+import { FolioAIEditAppliedOperation, FolioAIEditSkippedOperation } from "./ai-edits/types.js";
+import { FolioDocumentStoryHandle, FolioResolvedReviewedView } from "./ai-edits/headless.js";
+import { FolioDocumentPrivacyOptions, FolioDocumentPrivacyReport } from "./docx/metadataPrivacy.js";
 
 //#region src/redline.d.ts
 /** Options for {@link generateRedlineDocx}. */
 type GenerateRedlineDocxOptions = {
-  /** Author recorded on the generated tracked changes. (default: `"folio compare"`) */author?: string;
+  /** Author recorded on the generated tracked changes. (default: `"folio compare"`) */author?: string; /** Resolved base input state. (default: `"final"`) */
+  baseView?: FolioResolvedReviewedView; /** Resolved revised input state. (default: `"final"`) */
+  revisedView?: FolioResolvedReviewedView; /** Optional output-only package-metadata privacy transforms. */
+  privacy?: FolioDocumentPrivacyOptions;
+};
+declare const InvalidGenerateRedlineDocxOptionsError_base: import("better-result").TaggedErrorClass<"InvalidGenerateRedlineDocxOptionsError", {
+  message: string;
+  option: "baseView" | "revisedView";
+  receivedValue: unknown;
+}>;
+declare class InvalidGenerateRedlineDocxOptionsError extends InvalidGenerateRedlineDocxOptionsError_base {}
+type GenerateRedlineUnprocessedStory = {
+  baseStory: FolioDocumentStoryHandle | null;
+  revisedStory: FolioDocumentStoryHandle | null;
+  reason: "missing-base-story" | "missing-revised-story";
 };
 /** Result of {@link generateRedlineDocx}. */
-type GenerateRedlineDocxResult = FolioAIEditApplyResult & {
-  /** The redline `.docx`: the base document with base → revised tracked changes. */buffer: ArrayBuffer;
+type GenerateRedlineDocxResult = {
+  /** The base package with generated tracked changes. */buffer: ArrayBuffer; /** Operations applied across every matched story. */
+  applied: FolioAIEditAppliedOperation[]; /** Block operations that could not be applied. */
+  skipped: FolioAIEditSkippedOperation[]; /** Package parts that could not be represented as story-scoped text edits. */
+  unprocessedStories: GenerateRedlineUnprocessedStory[]; /** Privacy transforms applied to the generated package. */
+  privacyReport: FolioDocumentPrivacyReport;
 };
-/**
- * Compare `base` and `revised` and return the base document with every
- * difference recorded as a tracked change. See the module doc comment for
- * semantics and limitations; `skipped` reports any block the generator could
- * not redline (e.g. additions with no anchor in an empty base document).
- */
+/** Compare two buffers and return tracked changes for every matched editable story. */
 declare const generateRedlineDocx: (base: ArrayBuffer, revised: ArrayBuffer, options?: GenerateRedlineDocxOptions) => Promise<GenerateRedlineDocxResult>;
 //#endregion
-export { GenerateRedlineDocxOptions, GenerateRedlineDocxResult, generateRedlineDocx };
+export { GenerateRedlineDocxOptions, GenerateRedlineDocxResult, GenerateRedlineUnprocessedStory, InvalidGenerateRedlineDocxOptionsError, generateRedlineDocx };

package/dist/redline.js

@@ -1,75 +1,35 @@
-import { FolioDocxReviewer } from "./ai-edits/headless.js";
+import "./document-operations.js";
+import { pairFolioDocumentStories } from "./document-stories.js";
+import { FolioDocxReviewer, isFolioResolvedReviewedView } from "./ai-edits/headless.js";
+import { resolveFolioDocumentPrivacyTransforms, rewriteDocxMetadataPrivacy } from "./docx/metadataPrivacy.js";
 import { alignFolioBlocks } from "./version-comparison.js";
+import { TaggedError, panic } from "better-result";
 //#region src/redline.ts
 /**
-* Redline generator: compare two `.docx` buffers and produce a THIRD `.docx`
-* whose differences are recorded as real Word tracked changes (`w:ins` /
-* `w:del`), ready for review in Word or the folio editor — the
-* document-producing counterpart to {@link compareDocxVersions}'s structured
-* diff.
+* Compare two `.docx` buffers and produce a third buffer whose text
+* differences are represented as tracked changes.
 *
-* The pipeline is a composition of existing machinery, not a new engine:
-* the base buffer is opened in a headless {@link FolioDocxReviewer}, the two
-* snapshots are aligned with {@link alignFolioBlocks} (the same three-pass
-* alignment the comparer uses), each alignment event maps onto a
-* tracked-changes {@link FolioAIEditOperation}, and the reviewer's shared
-* apply path records them as redlines. Word-level minimality comes free:
-* the apply engine word-diffs a `replaceBlock` and only marks the divergent
-* tokens.
-*
-* ## Semantics and limitations
-*
-* - **As-accepted inputs.** Pending tracked changes in either input count as
-*   applied before comparison (mirroring {@link compareDocxVersions}): the
-*   base's own pending redlines are accepted in the output, so the tracked
-*   changes it carries are exactly base → revised. This is intentionally
-*   lossy about the inputs' own revision history and authorship.
-* - **Text redlines only.** Format-only changes and relocated blocks are
-*   redlined as plain edits (a move becomes a delete + insert, like Word
-*   compare with move detection off); block-level formatting is carried via
-*   the revised block's `styleId` on inserted blocks.
-* - **Anchoring.** Insertions anchor `before` the next surviving base block
-*   so consecutive additions keep their order; additions past the last base
-*   block anchor `after` it. A base document with no content blocks offers
-*   no anchor at all — such additions surface in `skipped` rather than
-*   silently vanishing.
-*/
-/**
-* For each event index, the base block id the next `revisedOnly` event
-* should anchor before: the base side of the nearest later `pair` or
-* `baseOnly` event, or `null` when only additions remain until the end of
-* the document. One backward pass, so a long run of trailing additions
-* (huge revised document vs. a small base) stays linear instead of
-* re-scanning the tail per added block.
+* Each matched editable story is processed independently through the shared
+* block alignment and document-operation paths. Package parts that exist on
+* only one side are reported because creating or removing those parts is a
+* distinct package-level operation.
 */
+var InvalidGenerateRedlineDocxOptionsError = class extends TaggedError("InvalidGenerateRedlineDocxOptionsError")() {};
 const nextBaseBlockIdByIndex = (events) => {
 	const nextIds = Array.from({ length: events.length });
 	let nextId = null;
-	for (let i = events.length - 1; i >= 0; i--) {
-		nextIds[i] = nextId;
-		const event = events[i];
+	for (let index = events.length - 1; index >= 0; index--) {
+		nextIds[index] = nextId;
+		const event = events[index];
 		if (event?.type === "pair") nextId = event.baseBlock.id;
 		else if (event?.type === "baseOnly") nextId = event.block.id;
 	}
 	return nextIds;
 };
-/**
-* Compare `base` and `revised` and return the base document with every
-* difference recorded as a tracked change. See the module doc comment for
-* semantics and limitations; `skipped` reports any block the generator could
-* not redline (e.g. additions with no anchor in an empty base document).
-*/
-const generateRedlineDocx = async (base, revised, options = {}) => {
-	const [baseReviewer, revisedReviewer] = await Promise.all([FolioDocxReviewer.fromBuffer(base, { author: options.author ?? "folio compare" }), FolioDocxReviewer.fromBuffer(revised)]);
-	baseReviewer.acceptAll();
-	const baseSnapshot = baseReviewer.snapshot();
-	const revisedBlocks = revisedReviewer.snapshot().blocks;
+const buildRedlineOperations = ({ baseSnapshot, revisedBlocks, nextOperationId }) => {
 	const events = alignFolioBlocks(baseSnapshot.blocks, revisedBlocks);
 	const anchorIds = nextBaseBlockIdByIndex(events);
 	const operations = [];
-	let operationSeq = 0;
-	const nextOperationId = () => `redline-${++operationSeq}`;
-	/** Additions past the last base block, inserted after it in reverse so the final order matches the revised document. */
 	const trailingAdditions = [];
 	const lastBaseBlockId = baseSnapshot.blocks.at(-1)?.id ?? null;
 	events.forEach((event, eventIndex) => {
@@ -106,22 +66,105 @@ const generateRedlineDocx = async (base, revised, options = {}) => {
 			...event.block.styleId !== void 0 && { styleId: event.block.styleId }
 		});
 	});
-	for (const addition of trailingAdditions.toReversed()) operations.push({
+	if (lastBaseBlockId === null && baseSnapshot.emptyDocumentAnchorId !== void 0) {
+		const firstAddition = trailingAdditions.shift();
+		if (firstAddition !== void 0) operations.push({
+			id: nextOperationId(),
+			type: "replaceBlock",
+			blockId: baseSnapshot.emptyDocumentAnchorId,
+			text: firstAddition.text,
+			...firstAddition.styleId !== void 0 && { styleId: firstAddition.styleId }
+		});
+	}
+	for (const addition of trailingAdditions) operations.push({
 		id: nextOperationId(),
 		type: "insertAfterBlock",
-		blockId: lastBaseBlockId ?? "redline-unanchored",
+		blockId: lastBaseBlockId ?? baseSnapshot.emptyDocumentAnchorId ?? "redline-unanchored",
 		text: addition.text,
 		...addition.styleId !== void 0 && { styleId: addition.styleId }
 	});
-	const { applied, skipped } = baseReviewer.applyOperations(operations, {
-		mode: "tracked-changes",
-		snapshot: baseSnapshot
+	return operations;
+};
+const resolveInputView = (value, option) => {
+	if (value === void 0) return "final";
+	if (!isFolioResolvedReviewedView(value)) throw new InvalidGenerateRedlineDocxOptionsError({
+		message: `${option} must be original or final.`,
+		option,
+		receivedValue: value
 	});
+	return value;
+};
+/** Compare two buffers and return tracked changes for every matched editable story. */
+const generateRedlineDocx = async (base, revised, options = {}) => {
+	const baseView = resolveInputView(options.baseView, "baseView");
+	const revisedView = resolveInputView(options.revisedView, "revisedView");
+	const privacyTransforms = resolveFolioDocumentPrivacyTransforms(options.privacy?.transforms ?? []);
+	const [baseReviewer, revisedReviewer] = await Promise.all([FolioDocxReviewer.fromBuffer(base, { author: options.author ?? "folio compare" }), FolioDocxReviewer.fromBuffer(revised)]);
+	const baseStories = baseReviewer.listStories().map(({ handle }) => handle);
+	const revisedStories = revisedReviewer.listStories().map(({ handle }) => handle);
+	for (const story of baseStories) if (!baseReviewer.resolveReviewedStory({
+		story,
+		view: baseView
+	})) panic("A listed base story could not be resolved");
+	const applied = [];
+	const skipped = [];
+	const unprocessedStories = [];
+	let operationSequence = 0;
+	const nextOperationId = () => `redline-${++operationSequence}`;
+	for (const pair of pairFolioDocumentStories(baseStories, revisedStories)) {
+		if (!pair.baseStory) {
+			unprocessedStories.push({
+				...pair,
+				reason: "missing-base-story"
+			});
+			continue;
+		}
+		if (!pair.revisedStory) {
+			unprocessedStories.push({
+				...pair,
+				reason: "missing-revised-story"
+			});
+			continue;
+		}
+		const baseSnapshot = baseReviewer.snapshotStory(pair.baseStory);
+		const revisedSnapshot = revisedReviewer.readReviewedStory({
+			story: pair.revisedStory,
+			view: revisedView
+		})?.snapshot;
+		if (!baseSnapshot || !revisedSnapshot) panic("A matched document story could not be read");
+		const operations = buildRedlineOperations({
+			baseSnapshot,
+			revisedBlocks: revisedSnapshot.blocks,
+			nextOperationId
+		});
+		if (operations.length === 0) continue;
+		const result = baseReviewer.applyDocumentOperationsToStory({
+			story: pair.baseStory,
+			snapshot: baseSnapshot,
+			batch: {
+				version: 1,
+				mode: "tracked-changes",
+				operations
+			}
+		});
+		applied.push(...result.applied);
+		skipped.push(...result.skipped);
+	}
+	const redlineBuffer = await baseReviewer.toBuffer();
+	const privacyResult = privacyTransforms.length === 0 ? {
+		buffer: redlineBuffer,
+		privacyReport: {
+			appliedTransforms: [],
+			removedMetadataProperties: []
+		}
+	} : await rewriteDocxMetadataPrivacy(redlineBuffer, { transforms: privacyTransforms });
 	return {
-		buffer: await baseReviewer.toBuffer(),
+		buffer: privacyResult.buffer,
 		applied,
-		skipped
+		skipped,
+		unprocessedStories,
+		privacyReport: privacyResult.privacyReport
 	};
 };
 //#endregion
-export { generateRedlineDocx };
+export { InvalidGenerateRedlineDocxOptionsError, generateRedlineDocx };

package/dist/server.d.ts

@@ -1,16 +1,20 @@
 import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditSnapshot, FolioAIInlineFormatting, FolioAITextRangeHandle, FolioDocumentNavigationTarget, FolioDocumentOutline, FolioDocumentOutlineEntry, FolioDocumentSection, FolioDocumentSectionHandle, FolioDocumentSectionReadResult } from "./ai-edits/types.js";
-import { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationStatus, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "./document-operations.js";
+import { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_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, FolioApplyDocumentOperationsOptions, FolioApplyOperationsOptions, FolioDocumentStory, FolioDocumentStoryHandle, FolioDocxReviewer, FolioDocxReviewerOptions, FolioReviewChangeFilter, FolioReviewComment, FolioReviewCommentFilter, FolioReviewCommentReply, FolioReviewReplyInput, applyFolioAIEditsToBuffer } from "./ai-edits/headless.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 { 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";
 import { CreateEmptyDocumentOptions, createEmptyDocument } from "./utils/createDocument.js";
+import { DocumentStyleCatalog, DocumentStyleCatalogEntry, ExtractDocumentStyleSetOptions, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, inspectDocumentStyles, inspectDocumentStylesFromDocx } from "./style-sets/extract.js";
+import { STELLA_STYLE_SET_NAME, createStellaStyleDocumentPreset, createStellaStyleSet } from "./style-sets/stellaStyle.js";
 import { createDocx } from "./docx/rezip.js";
 import { EnsureParaIdsError, EnsureParaIdsOptions, EnsureParaIdsResult, ensureParaIds } from "./docx/ensureParaIds.js";
+import { FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_DOCUMENT_PRIVACY_TRANSFORMS, FolioDocumentMetadataProperty, FolioDocumentPrivacyArchiveError, FolioDocumentPrivacyOptions, FolioDocumentPrivacyReport, FolioDocumentPrivacyTransform, InvalidFolioDocumentPrivacyOptionsError, RewriteDocxMetadataPrivacyResult, isFolioDocumentPrivacyTransform, rewriteDocxMetadataPrivacy } from "./docx/metadataPrivacy.js";
 import { CreateCommentReplyInput, replyToComment } from "./docx/replyToComment.js";
 import { DocxArchiveError } from "./docx/server/boundedArchive.js";
 import { DocxParagraphSource, ExtractedDocxParagraph, ExtractedDocxText, extractDocxText } from "./docx/server/extractDocxText.js";
-import { GenerateRedlineDocxOptions, GenerateRedlineDocxResult, generateRedlineDocx } from "./redline.js";
-import { FolioBlockDiff, FolioFormatProperty, FolioVersionDiff, FolioVersionDiffSegment, compareDocxVersions } from "./version-comparison.js";
-export { type ApplyFolioAIEditsToBufferOptions, type ApplyFolioAIEditsToBufferResult, type CreateCommentReplyInput, type CreateEmptyDocumentOptions, type DeriveBlockIdInput, DocxArchiveError, type DocxParagraphSource, EnsureParaIdsError, type EnsureParaIdsOptions, type EnsureParaIdsResult, type ExtractedDocxParagraph, type ExtractedDocxText, 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, 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 FolioApplyOperationsOptions, type FolioBlockDiff, type FolioBlockId, 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 FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentOutline, type FolioDocumentOutlineEntry, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocxReviewer, type FolioDocxReviewerOptions, type FolioFormatProperty, type FolioReviewChange, type FolioReviewChangeFilter, type FolioReviewChangeKind, type FolioReviewComment, type FolioReviewCommentFilter, type FolioReviewCommentReply, type FolioReviewReplyInput, type FolioVersionDiff, type FolioVersionDiffSegment, type GenerateRedlineDocxOptions, type GenerateRedlineDocxResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioAIEditsToBuffer, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, deriveBlockId, ensureParaIds, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch, readFolioDocumentSection, replyToComment };
+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 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 DocxParagraphSource, EnsureParaIdsError, type EnsureParaIdsOptions, type EnsureParaIdsResult, 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_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, FolioDocxReviewer, type FolioDocxReviewerOptions, 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, InvalidFolioDocumentOperationBatchError, InvalidFolioDocumentPrivacyOptionsError, InvalidFolioVersionComparisonOptionsError, InvalidGenerateRedlineDocxOptionsError, type RewriteDocxMetadataPrivacyResult, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, applyFolioAIEditsToBuffer, applyFolioVersionDiffPrivacy, assertSupportedFolioDocumentOperationVersion, compareDocxVersions, createDocx, createEmptyDocument, createFolioAITextRangeHandle, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, ensureParaIds, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractDocxText, generateRedlineDocx, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, inspectDocumentStyles, inspectDocumentStylesFromDocx, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocumentPrivacyTransform, isFolioResolvedReviewedView, isFolioReviewedView, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope, isSequentialFolioBlockId, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch, readFolioDocumentSection, replyToComment, rewriteDocxMetadataPrivacy };