@stll/folio-core 0.61.0 → 0.63.0

package/dist/utils/tableOperations.js

@@ -1,5 +1,15 @@
 import { TABLE_JUSTIFICATION_VALUES } from "../types/documentEnumValues.js";
+import { finalizeParagraphFormatting } from "@stll/docx-core/model";
 //#region src/utils/tableOperations.ts
+/**
+* Table model operations — framework-agnostic types and pure functions over the
+* folio document model's `Table`, `TableRow`, and `TableCell` shapes.
+*
+* Extracted from the React `table-types` module (originally the TableToolbar) so
+* the cell-selection manager and any adapter can share one implementation of the
+* add/delete row/column, merge, and split math. Pure data in, pure data out — no
+* ProseMirror, no DOM, no React.
+*/
 const TABLE_PROPERTY_JUSTIFICATION_ORDER = {
 	left: 0,
 	center: 1,
@@ -46,13 +56,17 @@ const createTableContext = (table, selection) => {
 		columnCount
 	};
 };
-const createEmptyCell = () => ({
-	type: "tableCell",
-	content: [{
+const emptyCellParagraph = () => {
+	const formatting = finalizeParagraphFormatting({});
+	return {
 		type: "paragraph",
 		content: [],
-		formatting: {}
-	}],
+		...formatting === void 0 ? {} : { formatting }
+	};
+};
+const createEmptyCell = () => ({
+	type: "tableCell",
+	content: [emptyCellParagraph()],
 	formatting: {}
 });
 const createEmptyRow = (templateRow, columnCount) => {
@@ -61,11 +75,7 @@ const createEmptyRow = (templateRow, columnCount) => {
 	for (const templateCell of templateRow.cells) {
 		cells.push({
 			type: "tableCell",
-			content: [{
-				type: "paragraph",
-				content: [],
-				formatting: {}
-			}],
+			content: [emptyCellParagraph()],
 			formatting: (() => {
 				if (!templateCell.formatting) return {};
 				const { vMerge: _vm, ...rest } = templateCell.formatting;
@@ -222,40 +232,33 @@ const splitCell = (table, rowIndex, columnIndex) => {
 		let currentCol = 0;
 		for (const rowCell of row.cells) {
 			const cellColSpan = rowCell.formatting?.gridSpan ?? 1;
-			if (currentCol === columnIndex || currentCol <= columnIndex && columnIndex < currentCol + cellColSpan) if (gridSpan > 1) for (let i = 0; i < gridSpan; i++) newCells.push({
-				type: "tableCell",
-				content: i === 0 ? rowCell.content : [{
-					type: "paragraph",
-					content: [],
-					formatting: {}
-				}],
-				formatting: (() => {
-					if (!rowCell.formatting) return {};
-					const { gridSpan: _gs, vMerge: _vm, ...rest } = rowCell.formatting;
-					return rest;
-				})()
-			});
-			else if (isVMergeStart && rIndex === rowIndex) newCells.push({
-				...rowCell,
-				formatting: (() => {
-					if (!rowCell.formatting) return {};
-					const { vMerge: _vm, ...rest } = rowCell.formatting;
-					return rest;
-				})()
-			});
-			else if (rowCell.formatting?.vMerge === "continue") {
-				const { vMerge: _vm, ...restFormatting } = rowCell.formatting;
-				newCells.push({
+			if (currentCol === columnIndex || currentCol <= columnIndex && columnIndex < currentCol + cellColSpan) {
+				if (gridSpan > 1) for (let i = 0; i < gridSpan; i++) newCells.push({
 					type: "tableCell",
-					content: [{
-						type: "paragraph",
-						content: [],
-						formatting: {}
-					}],
-					formatting: restFormatting
+					content: i === 0 ? rowCell.content : [emptyCellParagraph()],
+					formatting: (() => {
+						if (!rowCell.formatting) return {};
+						const { gridSpan: _gs, vMerge: _vm, ...rest } = rowCell.formatting;
+						return rest;
+					})()
+				});
+				else if (isVMergeStart && rIndex === rowIndex) newCells.push({
+					...rowCell,
+					formatting: (() => {
+						if (!rowCell.formatting) return {};
+						const { vMerge: _vm, ...rest } = rowCell.formatting;
+						return rest;
+					})()
 				});
+				else if (rowCell.formatting?.vMerge === "continue") {
+					const { vMerge: _vm, ...restFormatting } = rowCell.formatting;
+					newCells.push({
+						type: "tableCell",
+						content: [emptyCellParagraph()],
+						formatting: restFormatting
+					});
+				} else newCells.push(rowCell);
 			} else newCells.push(rowCell);
-			else newCells.push(rowCell);
 			currentCol += cellColSpan;
 		}
 		return {

package/dist/utils/tablePlacement.d.ts

@@ -1,7 +1,6 @@
 import { TableAlignment } from "../types/formatting.js";
 //#region src/utils/tablePlacement.d.ts
-type PhysicalTableAlignment = "left" | "center" | "right";
+export type PhysicalTableAlignment = "left" | "center" | "right";
 /** Resolve an OOXML table placement to a physical inline alignment. */
-declare const resolveTablePlacementAlignment: (placement: TableAlignment, rightToLeft: boolean) => PhysicalTableAlignment;
-//#endregion
-export { PhysicalTableAlignment, resolveTablePlacementAlignment };
+export declare const resolveTablePlacementAlignment: (placement: TableAlignment, rightToLeft: boolean) => PhysicalTableAlignment;
+//#endregion

package/dist/utils/textAdvanceGapsDom.d.ts

@@ -0,0 +1,8 @@
+//#region src/utils/textAdvanceGapsDom.d.ts
+type TextAdvanceGap = {
+  readonly offset: number;
+  readonly advancePx: number;
+};
+export declare const applyTextAdvanceGaps: (host: HTMLElement, gaps: readonly TextAdvanceGap[]) => void;
+//#endregion
+export {};

package/dist/utils/textAdvanceGapsDom.js

@@ -0,0 +1,49 @@
+//#region src/utils/textAdvanceGapsDom.ts
+const applyTextAdvanceGaps = (host, gaps) => {
+	host.style.textAutospace = "no-autospace";
+	if (gaps.length === 0) return;
+	const doc = host.ownerDocument;
+	const walker = doc.createTreeWalker(host, 4);
+	const nodes = [];
+	let node = walker.nextNode();
+	while (node !== null) {
+		nodes.push(node);
+		node = walker.nextNode();
+	}
+	let sourceOffset = 0;
+	let gapIndex = 0;
+	for (const textNode of nodes) {
+		const text = textNode.nodeValue ?? "";
+		const end = sourceOffset + text.length;
+		const fragment = doc.createDocumentFragment();
+		let consumed = 0;
+		while (gapIndex < gaps.length) {
+			const gap = gaps[gapIndex];
+			if (gap === void 0 || gap.offset > end) break;
+			gapIndex += 1;
+			const boundary = gap.offset - sourceOffset;
+			if (boundary <= consumed) continue;
+			let start = boundary;
+			while (start > consumed) {
+				const trailing = text.charCodeAt(start - 1);
+				const previous = trailing >= 56320 && trailing <= 57343 ? start - 2 : start - 1;
+				const character = text.slice(Math.max(consumed, previous), start);
+				start = Math.max(consumed, previous);
+				if (!/^\p{M}$/u.test(character)) break;
+			}
+			if (start > consumed) fragment.append(doc.createTextNode(text.slice(consumed, start)));
+			const advance = doc.createElement("span");
+			advance.style.letterSpacing = `${gap.advancePx}px`;
+			advance.textContent = text.slice(start, boundary);
+			fragment.append(advance);
+			consumed = boundary;
+		}
+		if (consumed > 0) {
+			if (consumed < text.length) fragment.append(doc.createTextNode(text.slice(consumed)));
+			textNode.parentNode?.replaceChild(fragment, textNode);
+		}
+		sourceOffset = end;
+	}
+};
+//#endregion
+export { applyTextAdvanceGaps };

package/dist/utils/textDirectionFlow.d.ts

@@ -1,6 +1,6 @@
 import { TextDirection } from "@stll/docx-core/model";
 //#region src/utils/textDirectionFlow.d.ts
-type TextFlowCss = {
+export type TextFlowCss = {
   /** `horizontal-tb` needs no declaration; the others are written out. */
   writingMode: "horizontal-tb" | "vertical-lr" | "vertical-rl";
   /**
@@ -10,6 +10,5 @@ type TextFlowCss = {
   rotateDegrees?: 180;
 };
 /** The CSS a `w:textDirection` token renders as, through the flow it names. */
-declare const textFlowCss: (direction: TextDirection) => TextFlowCss;
-//#endregion
-export { TextFlowCss, textFlowCss };
+export declare const textFlowCss: (direction: TextDirection) => TextFlowCss;
+//#endregion

package/dist/utils/textEncoding.js

@@ -1,2 +1 @@
-import { base64ToBytes, bytesToBase64, bytesToBase64Url, bytesToHex, createTextReader, decodeText, encodeBinaryString, encodeUtf16BE, encodeUtf16LE, encodeUtf8, readBlobText } from "@stll/utf8-boundaries";
-export { base64ToBytes, bytesToBase64, bytesToBase64Url, bytesToHex, createTextReader, decodeText, encodeBinaryString, encodeUtf16BE, encodeUtf16LE, encodeUtf8, readBlobText };
+export { base64ToBytes, bytesToBase64, bytesToBase64Url, bytesToHex, createTextReader, decodeText, encodeBinaryString, encodeUtf16BE, encodeUtf16LE, encodeUtf8, readBlobText } from "@stll/utf8-boundaries";

package/dist/utils/textFormattingMerge.d.ts

@@ -1,6 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/utils/textFormattingMerge.d.ts
-declare const STYLE_TOGGLE_KEYS: readonly ["bold", "boldCs", "italic", "italicCs", "allCaps", "emboss", "imprint", "outline", "shadow", "smallCaps", "strike", "hidden"];
+export declare const STYLE_TOGGLE_KEYS: readonly ["bold", "boldCs", "italic", "italicCs", "allCaps", "emboss", "imprint", "outline", "shadow", "smallCaps", "strike", "hidden"];
 /**
  * Merge one style's own run-formatting declarations onto its already-resolved
  * `w:basedOn` ancestor.
@@ -21,7 +21,6 @@ declare const STYLE_TOGGLE_KEYS: readonly ["bold", "boldCs", "italic", "italicCs
  * `basedOn` walks like this one; it is not part of resolving a single walk, so
  * it has no place in this function.
  */
-declare function mergeStyleTextFormatting(target: document_d_exports.TextFormatting | undefined, source: document_d_exports.TextFormatting | undefined): document_d_exports.TextFormatting | undefined;
-declare function mergeTextFormatting(target: document_d_exports.TextFormatting | undefined, source: document_d_exports.TextFormatting | undefined): document_d_exports.TextFormatting | undefined;
-//#endregion
-export { STYLE_TOGGLE_KEYS, mergeStyleTextFormatting, mergeTextFormatting };
+export declare function mergeStyleTextFormatting(target: document_d_exports.TextFormatting | undefined, source: document_d_exports.TextFormatting | undefined): document_d_exports.TextFormatting | undefined;
+export declare function mergeTextFormatting(target: document_d_exports.TextFormatting | undefined, source: document_d_exports.TextFormatting | undefined): document_d_exports.TextFormatting | undefined;
+//#endregion

package/dist/utils/tiffConverter.d.ts

@@ -5,14 +5,13 @@
  * Callers pass what is left of the budget and subtract the pixels each
  * conversion reports.
  */
-declare const MAX_PACKAGE_TIFF_PIXELS = 256000000;
-declare function isTiffMimeType(mimeType: string): boolean;
-type ConvertedTiff = {
+export declare const MAX_PACKAGE_TIFF_PIXELS = 256000000;
+export declare function isTiffMimeType(mimeType: string): boolean;
+export type ConvertedTiff = {
   dataUrl: string;
   data: ArrayBuffer;
   /** Pixels decoded, so callers can draw down a package-wide budget. */
   pixels: number;
 };
-declare function convertTiffToPngDataUrl(tiffData: ArrayBuffer, maxPixels?: number): Promise<ConvertedTiff | null>;
-//#endregion
-export { ConvertedTiff, MAX_PACKAGE_TIFF_PIXELS, convertTiffToPngDataUrl, isTiffMimeType };
+export declare function convertTiffToPngDataUrl(tiffData: ArrayBuffer, maxPixels?: number): Promise<ConvertedTiff | null>;
+//#endregion

package/dist/utils/trailingText.d.ts

@@ -5,8 +5,8 @@
  * must not backtrack the way an end-anchored regular expression does.
  */
 /** Index where the trailing run of U+0020 spaces begins; `text.length` when there is none. */
-declare function trailingSpaceStart(text: string): number;
-type TrailingToken = {
+export declare function trailingSpaceStart(text: string): number;
+export type TrailingToken = {
   /** Last run of non-whitespace characters. */
   token: string;
   /** Whitespace after the token, up to the end of the text. */
@@ -17,6 +17,5 @@ type TrailingToken = {
  * follows it, or return undefined when the text has no non-whitespace
  * character.
  */
-declare function splitTrailingToken(text: string): TrailingToken | undefined;
-//#endregion
-export { TrailingToken, splitTrailingToken, trailingSpaceStart };
+export declare function splitTrailingToken(text: string): TrailingToken | undefined;
+//#endregion

package/dist/utils/units.d.ts

@@ -12,9 +12,9 @@
  * Standard assumption: 96 DPI (pixels per inch)
  */
 /** Twips per inch (1 inch = 1440 twips) */
-declare const TWIPS_PER_INCH = 1440;
+export declare const TWIPS_PER_INCH = 1440;
 /** Pixels per inch at standard DPI */
-declare const PIXELS_PER_INCH = 96;
+export declare const PIXELS_PER_INCH = 96;
 /**
  * Word's auto paragraph spacing in px. HTML-origin paragraphs use
  * `w:beforeAutospacing`/`w:afterAutospacing` instead of explicit before/after;
@@ -22,32 +22,32 @@ declare const PIXELS_PER_INCH = 96;
  * The value is empirical (Word's rendered auto gap), not derivable from a
  * twips conversion. See eigenpal/docx-editor#823.
  */
-declare const AUTO_PARAGRAPH_SPACING_PX: number;
+export declare const AUTO_PARAGRAPH_SPACING_PX: number;
 /**
  * Convert twips to pixels (at 96 DPI)
  *
  * 1 inch = 1440 twips = 96 pixels
  * → 1 twip = 96/1440 pixels = 1/15 pixels
  */
-declare function twipsToPixels(twips: number): number;
+export declare function twipsToPixels(twips: number): number;
 /**
  * Convert pixels to twips
  */
-declare function pixelsToTwips(px: number): number;
+export declare function pixelsToTwips(px: number): number;
 /**
  * Convert EMUs to pixels (at 96 DPI)
  *
  * 1 inch = 914400 EMUs = 96 pixels
  * Returns 0 for null/undefined/NaN inputs.
  */
-declare function emuToPixels(emu: number | undefined | null): number;
+export declare function emuToPixels(emu: number | undefined | null): number;
 /**
  * Convert pixels to EMUs.
  *
  * EMU coordinates in OOXML are integer-typed (xs:long); rounding here keeps
  * floating-point drift (e.g. 52 px → 495299.99999999994) out of the document.
  */
-declare function pixelsToEmu(px: number): number;
+export declare function pixelsToEmu(px: number): number;
 /**
  * Convert EMUs to pixels for a stroke width.
  *
@@ -56,53 +56,52 @@ declare function pixelsToEmu(px: number): number;
  * has to write the document's own number back carries the authored EMU beside
  * the pixels rather than converting these back.
  */
-declare function emuToStrokePixels(emu: number): number;
+export declare function emuToStrokePixels(emu: number): number;
 /**
  * Convert EMUs to twips. Twips are integer-typed in OOXML; round here.
  */
-declare function emuToTwips(emu: number): number;
+export declare function emuToTwips(emu: number): number;
 /**
  * Convert twips to EMUs. EMUs are integer-typed in OOXML; round here.
  */
-declare function twipsToEmu(twips: number): number;
+export declare function twipsToEmu(twips: number): number;
 /**
  * Convert points to pixels (at 96 DPI)
  *
  * 1 inch = 72 points = 96 pixels
  * → 1 point = 96/72 pixels = 4/3 pixels
  */
-declare function pointsToPixels(points: number): number;
+export declare function pointsToPixels(points: number): number;
 /**
  * Convert half-points to pixels (at 96 DPI)
  *
  * Half-points are commonly used for font sizes in OOXML (w:sz).
  */
-declare function halfPointsToPixels(halfPoints: number): number;
+export declare function halfPointsToPixels(halfPoints: number): number;
 /**
  * Convert half-points to points
  */
-declare function halfPointsToPoints(halfPoints: number): number;
+export declare function halfPointsToPoints(halfPoints: number): number;
 /**
  * Convert points to half-points
  */
-declare function pointsToHalfPoints(points: number): number;
+export declare function pointsToHalfPoints(points: number): number;
 /**
  * Convert eighths of a point to pixels (at 96 DPI)
  *
  * Eighths of a point are used for border widths in OOXML.
  */
-declare function eighthsToPixels(eighths: number): number;
+export declare function eighthsToPixels(eighths: number): number;
 /**
  * Round a pixel value to avoid sub-pixel rendering issues
  */
-declare function roundPixels(px: number, decimalPlaces?: number): number;
+export declare function roundPixels(px: number, decimalPlaces?: number): number;
 /**
  * Clamp a value between min and max
  */
-declare function clamp(value: number, min: number, max: number): number;
+export declare function clamp(value: number, min: number, max: number): number;
 /**
  * Format a pixel value as CSS string
  */
-declare function formatPx(px: number): string;
-//#endregion
-export { AUTO_PARAGRAPH_SPACING_PX, PIXELS_PER_INCH, TWIPS_PER_INCH, clamp, eighthsToPixels, emuToPixels, emuToStrokePixels, emuToTwips, formatPx, halfPointsToPixels, halfPointsToPoints, pixelsToEmu, pixelsToTwips, pointsToHalfPoints, pointsToPixels, roundPixels, twipsToEmu, twipsToPixels };
+export declare function formatPx(px: number): string;
+//#endregion

package/dist/utils/urlSecurity.d.ts

@@ -1,13 +1,13 @@
 import { sanitizeExternalUrl } from "@stll/docx-core";
 //#region src/utils/urlSecurity.d.ts
-declare function normalizeUserUrl(rawUrl: string): string;
-declare function isAllowedUserUrl(rawUrl: string): boolean;
-type AnchorTargetAttrs = {
+export declare function normalizeUserUrl(rawUrl: string): string;
+export declare function isAllowedUserUrl(rawUrl: string): boolean;
+export type AnchorTargetAttrs = {
   target: string;
   rel: string;
 };
-declare function anchorTargetAttrs(authoredFrame: string | undefined): AnchorTargetAttrs;
+export declare function anchorTargetAttrs(authoredFrame: string | undefined): AnchorTargetAttrs;
 /** `window.open` features carrying the same guarantees as {@link ANCHOR_REL}. */
-declare function windowFeaturesFor({ rel }: AnchorTargetAttrs): string;
+export declare function windowFeaturesFor({ rel }: AnchorTargetAttrs): string;
 //#endregion
-export { AnchorTargetAttrs, anchorTargetAttrs, isAllowedUserUrl, normalizeUserUrl, sanitizeExternalUrl, windowFeaturesFor };
+export { sanitizeExternalUrl };

package/dist/utils/urlSecurity.js

@@ -18,7 +18,8 @@ function normalizeUserUrl(rawUrl) {
 		const suffix = trimmed.slice(colonIndex + 1);
 		if (suffix.startsWith("//") || !startsWithPortSuffix(suffix)) return "";
 	}
-	return sanitizeExternalUrl(`https://${trimmed}`) ?? "";
+	const withProtocol = `https://${trimmed}`;
+	return sanitizeExternalUrl(withProtocol) ?? "";
 }
 function isAllowedUserUrl(rawUrl) {
 	return normalizeUserUrl(rawUrl) !== "";

package/dist/utils/zoom.d.ts

@@ -12,10 +12,9 @@
  * these limits.
  */
 /** Minimum reachable zoom level (25%). */
-declare const ZOOM_MIN = 0.25;
+export declare const ZOOM_MIN = 0.25;
 /** Maximum reachable zoom level (400%). */
-declare const ZOOM_MAX = 4;
+export declare const ZOOM_MAX = 4;
 /** Step applied per zoom-in / zoom-out action and per keyboard shortcut. */
-declare const ZOOM_STEP = 0.1;
-//#endregion
-export { ZOOM_MAX, ZOOM_MIN, ZOOM_STEP };
+export declare const ZOOM_STEP = 0.1;
+//#endregion

package/dist/version-comparison.d.ts

@@ -5,34 +5,34 @@ import { FolioContentAlignedBlockEvent } from "./compare/content-alignment.js";
 import { FOLIO_DOCUMENT_METADATA_PROPERTIES, FolioDocumentMetadataProperty, FolioDocumentPrivacyOptions, FolioDocumentPrivacyReport, FolioDocumentPrivacyTransform } from "./docx/metadataPrivacy.js";
 //#region src/version-comparison.d.ts
 /** One word-level diff segment within a `modified` block. Mirrors {@link WordDiffSegment}. */
-type FolioVersionDiffSegment = WordDiffSegment;
+export type FolioVersionDiffSegment = WordDiffSegment;
 /** Independently selectable comparison scopes. */
-declare const FOLIO_VERSION_COMPARISON_SCOPES: readonly ["text", "formatting", "metadata"];
-type FolioVersionComparisonScope = (typeof FOLIO_VERSION_COMPARISON_SCOPES)[number];
-declare const isFolioVersionComparisonScope: (value: unknown) => value is FolioVersionComparisonScope;
-type FolioCompareDocxVersionsOptions = {
+export declare const FOLIO_VERSION_COMPARISON_SCOPES: readonly ["text", "formatting", "metadata"];
+export type FolioVersionComparisonScope = (typeof FOLIO_VERSION_COMPARISON_SCOPES)[number];
+export declare const isFolioVersionComparisonScope: (value: unknown) => value is FolioVersionComparisonScope;
+export type FolioCompareDocxVersionsOptions = {
   /** Selected scopes; defaults to text and formatting. */
   include?: readonly FolioVersionComparisonScope[];
   /** Optional output-only privacy transforms. Source buffers are never mutated. */
   privacy?: FolioVersionDiffPrivacyOptions;
 };
 declare const InvalidFolioVersionComparisonOptionsError_base: import("better-result").TaggedErrorClass<"InvalidFolioVersionComparisonOptionsError">;
-declare class InvalidFolioVersionComparisonOptionsError extends InvalidFolioVersionComparisonOptionsError_base<{
+export declare class InvalidFolioVersionComparisonOptionsError extends InvalidFolioVersionComparisonOptionsError_base<{
   message: string;
   option: "include" | "privacy.transforms";
   receivedValue: unknown;
 }> {}
-type FolioDocumentMetadataValue = string | number | null;
-type FolioMetadataDiff = {
+export type FolioDocumentMetadataValue = string | number | null;
+export type FolioMetadataDiff = {
   property: FolioDocumentMetadataProperty;
   baseValue: FolioDocumentMetadataValue;
   revisedValue: FolioDocumentMetadataValue;
 };
-declare const FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS: readonly ["remove-attribution", "remove-timestamps", "remove-descriptive-metadata"];
-type FolioVersionComparisonPrivacyTransform = FolioDocumentPrivacyTransform;
-declare const isFolioVersionComparisonPrivacyTransform: (value: unknown) => value is FolioVersionComparisonPrivacyTransform;
-type FolioVersionDiffPrivacyOptions = FolioDocumentPrivacyOptions;
-type FolioVersionDiffPrivacyReport = FolioDocumentPrivacyReport;
+export declare const FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS: readonly ["remove-attribution", "remove-timestamps", "remove-descriptive-metadata"];
+export type FolioVersionComparisonPrivacyTransform = FolioDocumentPrivacyTransform;
+export declare const isFolioVersionComparisonPrivacyTransform: (value: unknown) => value is FolioVersionComparisonPrivacyTransform;
+export type FolioVersionDiffPrivacyOptions = FolioDocumentPrivacyOptions;
+export type FolioVersionDiffPrivacyReport = FolioDocumentPrivacyReport;
 /** Inline formatting properties compared for `formatChanged` detection. */
 declare const INLINE_FORMAT_PROPERTIES: {
   readonly bold: true;
@@ -57,18 +57,18 @@ declare const BLOCK_PROPERTIES: {
   readonly displayLabel: true;
 };
 /** A presentation property that can differ in a `formatChanged` block. */
-type FolioFormatProperty = keyof typeof INLINE_FORMAT_PROPERTIES | keyof typeof PARAGRAPH_FORMAT_PROPERTIES;
+export type FolioFormatProperty = keyof typeof INLINE_FORMAT_PROPERTIES | keyof typeof PARAGRAPH_FORMAT_PROPERTIES;
 /** A non-presentation block property retained on composite content changes. */
-type FolioBlockProperty = keyof typeof BLOCK_PROPERTIES;
+export type FolioBlockProperty = keyof typeof BLOCK_PROPERTIES;
 /** One content or presentation property attached to a modified or moved block. */
-type FolioVersionChangeProperty = FolioBlockProperty | FolioFormatProperty;
+export type FolioVersionChangeProperty = FolioBlockProperty | FolioFormatProperty;
 /** Stable location of one compared block within its source document. */
-type FolioVersionBlockHandle = {
+export type FolioVersionBlockHandle = {
   story: FolioDocumentStoryHandle;
   blockId: string;
 };
 /** One block-level change between two document versions, in revised-side document order. */
-type FolioBlockDiff = {
+export type FolioBlockDiff = {
   type: "added";
   blockId: string;
   kind: string;
@@ -113,7 +113,7 @@ type FolioBlockDiff = {
   changedProperties?: FolioVersionChangeProperty[];
   revisedHandle: FolioVersionBlockHandle;
 };
-type FolioVersionDiffSummaryCounts = {
+export type FolioVersionDiffSummaryCounts = {
   added: number;
   deleted: number;
   modified: number;
@@ -123,14 +123,14 @@ type FolioVersionDiffSummaryCounts = {
   unchanged: number;
 };
 /** Changes within one matched, added, or deleted document story. */
-type FolioStoryDiff = {
+export type FolioStoryDiff = {
   baseStory: FolioDocumentStoryHandle | null;
   revisedStory: FolioDocumentStoryHandle | null;
   changes: FolioBlockDiff[];
   summaryCounts: FolioVersionDiffSummaryCounts;
 };
 /** Result of {@link compareDocxVersions}. */
-type FolioVersionDiff = {
+export type FolioVersionDiff = {
   /** Every changed block, in revised-side document order (deletions and move sources slotted where they sat). */
   changes: FolioBlockDiff[];
   /** Per-story results in base order followed by stories added in the revised document. */
@@ -142,11 +142,11 @@ type FolioVersionDiff = {
   /** Counts across every paired/unpaired block, including the unchanged blocks `changes` omits. `moved` counts pairs, not entries. */
   summaryCounts: FolioVersionDiffSummaryCounts;
 };
-declare const exceedsLcsBudget: (baseCount: number, revisedCount: number) => boolean;
-type FolioVersionComparisonLcsBudget = {
+export declare const exceedsLcsBudget: (baseCount: number, revisedCount: number) => boolean;
+export type FolioVersionComparisonLcsBudget = {
   remainingCells: number;
 };
-type FolioAlignedBlockEvent = FolioContentAlignedBlockEvent<FolioAIBlock>;
+export type FolioAlignedBlockEvent = FolioContentAlignedBlockEvent<FolioAIBlock>;
 /**
  * Compatibility adapter for the DOCX snapshot comparison surface.
  *
@@ -154,15 +154,15 @@ type FolioAlignedBlockEvent = FolioContentAlignedBlockEvent<FolioAIBlock>;
  * that policy while the representation-neutral core can treat caller ids as
  * stable by default.
  */
-declare const alignFolioBlocks: (baseBlocks: readonly FolioAIBlock[], revisedBlocks: readonly FolioAIBlock[], lcsBudget?: FolioVersionComparisonLcsBudget) => FolioAlignedBlockEvent[];
+export declare const alignFolioBlocks: (baseBlocks: readonly FolioAIBlock[], revisedBlocks: readonly FolioAIBlock[], lcsBudget?: FolioVersionComparisonLcsBudget) => FolioAlignedBlockEvent[];
 /** Apply auditable, output-only privacy transforms to a structured version diff. */
-declare const applyFolioVersionDiffPrivacy: (diff: FolioVersionDiff, options: FolioVersionDiffPrivacyOptions) => FolioVersionDiff;
+export declare const applyFolioVersionDiffPrivacy: (diff: FolioVersionDiff, options: FolioVersionDiffPrivacyOptions) => FolioVersionDiff;
 /**
  * Compare two `.docx` buffers and return a structured, block-level diff.
  * See the module doc comment for the as-accepted comparison semantics, the
  * three-pass alignment algorithm, move detection, and format-only change
  * detection.
  */
-declare const compareDocxVersions: (base: ArrayBuffer, revised: ArrayBuffer, options?: FolioCompareDocxVersionsOptions) => Promise<FolioVersionDiff>;
+export declare const compareDocxVersions: (base: ArrayBuffer, revised: ArrayBuffer, options?: FolioCompareDocxVersionsOptions) => Promise<FolioVersionDiff>;
 //#endregion
-export { FOLIO_DOCUMENT_METADATA_PROPERTIES, FOLIO_VERSION_COMPARISON_PRIVACY_TRANSFORMS, FOLIO_VERSION_COMPARISON_SCOPES, FolioAlignedBlockEvent, FolioBlockDiff, FolioBlockProperty, FolioCompareDocxVersionsOptions, type FolioDocumentMetadataProperty, FolioDocumentMetadataValue, FolioFormatProperty, FolioMetadataDiff, FolioStoryDiff, FolioVersionBlockHandle, FolioVersionChangeProperty, FolioVersionComparisonLcsBudget, FolioVersionComparisonPrivacyTransform, FolioVersionComparisonScope, FolioVersionDiff, FolioVersionDiffPrivacyOptions, FolioVersionDiffPrivacyReport, FolioVersionDiffSegment, FolioVersionDiffSummaryCounts, InvalidFolioVersionComparisonOptionsError, alignFolioBlocks, applyFolioVersionDiffPrivacy, compareDocxVersions, exceedsLcsBudget, isFolioVersionComparisonPrivacyTransform, isFolioVersionComparisonScope };
+export { FOLIO_DOCUMENT_METADATA_PROPERTIES, type FolioDocumentMetadataProperty };

package/dist/version-comparison.js

@@ -168,16 +168,17 @@ const excludedTextEventUnitCount = (event) => {
 	}
 };
 const compareStoryBlocks = ({ baseStory, revisedStory, baseBlocks, revisedBlocks, firstMoveGroupId, includeText, includeFormatting, workSession }) => {
+	const steps = alignFolioContentStructure({
+		baseBlocks,
+		revisedBlocks,
+		workSession: workSession.alignment,
+		stableIdMismatch: "pair",
+		idStability: folioAIBlockIdStability
+	});
 	const compared = compareAlignedFolioContent({
 		baseBlocks,
 		revisedBlocks,
-		steps: alignFolioContentStructure({
-			baseBlocks,
-			revisedBlocks,
-			workSession: workSession.alignment,
-			stableIdMismatch: "pair",
-			idStability: folioAIBlockIdStability
-		}),
+		steps,
 		workSession,
 		idStability: folioAIBlockIdStability,
 		maxChanges: Number.MAX_SAFE_INTEGER

package/dist/watermark/index.d.ts

@@ -9,13 +9,13 @@ import { document_d_exports } from "../types/document.js";
  * whatever later opens the file (e.g. Word) would try to resolve. Only
  * `http:`/`https:` targets are allowed.
  */
-declare function isAllowedExternalWatermarkImageUrl(target: string): boolean;
+export declare function isAllowedExternalWatermarkImageUrl(target: string): boolean;
 /**
  * Read the document's watermark. Walks every header part and returns
  * the first watermark encountered (header insertion order). Returns
  * `undefined` when no header carries one.
  */
-declare function getDocumentWatermark(doc: document_d_exports.Document): document_d_exports.Watermark | undefined;
+export declare function getDocumentWatermark(doc: document_d_exports.Document): document_d_exports.Watermark | undefined;
 /**
  * Set (or clear) the document's watermark. Writes the modeled `watermark` to
  * every existing header part (clearing the captured raw VML so the serializer
@@ -23,7 +23,7 @@ declare function getDocumentWatermark(doc: document_d_exports.Document): documen
  * document needs but lacks — see {@link ensureWatermarkHeaderCoverage}. Pass
  * `undefined` to remove the watermark from every header.
  */
-declare function setDocumentWatermark(doc: document_d_exports.Document, watermark: document_d_exports.Watermark | undefined): document_d_exports.Document;
+export declare function setDocumentWatermark(doc: document_d_exports.Document, watermark: document_d_exports.Watermark | undefined): document_d_exports.Document;
 /**
  * Ensure the watermark shows on every page it should, even when the header
  * parts a section needs are missing:
@@ -41,8 +41,8 @@ declare function setDocumentWatermark(doc: document_d_exports.Document, watermar
  * Created headers use freshly minted rIds that the save pipeline materializes
  * into real parts.
  */
-declare function ensureWatermarkHeaderCoverage(doc: document_d_exports.Document, watermark: document_d_exports.Watermark): document_d_exports.Document;
+export declare function ensureWatermarkHeaderCoverage(doc: document_d_exports.Document, watermark: document_d_exports.Watermark): document_d_exports.Document;
 type PictureWatermark = document_d_exports.PictureWatermark;
 type TextWatermark = document_d_exports.TextWatermark;
 type Watermark = document_d_exports.Watermark;
-export { type PictureWatermark, type TextWatermark, type Watermark, ensureWatermarkHeaderCoverage, getDocumentWatermark, isAllowedExternalWatermarkImageUrl, setDocumentWatermark };
+export type { PictureWatermark, TextWatermark, Watermark };

package/dist/watermark/index.js

@@ -2,6 +2,15 @@ import { isEmptyParagraph } from "../docx/paragraphParser.js";
 import { cloneParagraphWithPropertySource } from "../docx/paragraphPropertySource.js";
 //#region src/watermark/index.ts
 /**
+* Headless API for the document watermark.
+*
+* Mirrors the `content-controls` module's shape: pure functions that
+* read and write a `Document` immutably. Word stores watermarks inside
+* header parts; folio's getter scans every header and returns the
+* first watermark found, and the setter writes the modeled watermark
+* to every header part so all sections render it.
+*/
+/**
 * Schemes allowed for a picture watermark's external image target
 * (`TargetMode="External"` in the saved package's relationships).
 */