@stll/folio-core 0.45.0 → 0.46.0

package/dist/docx/serializer/runSerializer.js

@@ -1,5 +1,8 @@
 import { isValidHexColor } from "../../utils/colorResolver.js";
+import { normalizeImageLuminancePercent } from "../../utils/imageLuminance.js";
+import { serializePreservedAttributes } from "../attributeRemainder.js";
 import { THEME_COLOR_TO_DRAWING_SCHEME } from "../drawingUtils.js";
+import { fieldStateAttributes } from "../fieldState.js";
 import { serializeGraphicFrameLocks } from "../graphicFrameLocks.js";
 import { DECORATIVE_EXTENSION_URI, DECORATIVE_NAMESPACE } from "../imageParser.js";
 import { canReplayEditableImageRawXml } from "../imageRawXml.js";
@@ -103,10 +106,7 @@ function serializeNoteReference(content) {
 * Serialize field character (w:fldChar)
 */
 function serializeFieldChar(content) {
-	const attrs = [`w:fldCharType="${content.charType}"`];
-	if (content.fldLock) attrs.push("w:fldLock=\"true\"");
-	if (content.dirty) attrs.push("w:dirty=\"true\"");
-	return `<w:fldChar ${attrs.join(" ")}/>`;
+	return `<w:fldChar ${[`w:fldCharType="${content.charType}"`, ...fieldStateAttributes(content)].join(" ")}/>`;
 }
 /**
 * Serialize field instruction text (w:instrText)
@@ -209,6 +209,17 @@ function serializeWrap(wrap) {
 	}
 }
 /**
+* `a:xfrm` attributes for an authored transform.
+*
+* Written iff authored: `rot="0"` and `flipH="0"` are OOXML's defaults, so a
+* truthiness guard cannot tell "the author said none" from "the author said
+* nothing", and a save erased an authored zero.
+*/
+const serializeTransformAttrs = (transform) => {
+	if (transform === void 0) return "";
+	return `${transform.rotation === void 0 ? "" : ` rot="${Math.round(transform.rotation * 6e4)}"`}${transform.flipH === void 0 ? "" : ` flipH="${transform.flipH ? 1 : 0}"`}${transform.flipV === void 0 ? "" : ` flipV="${transform.flipV ? 1 : 0}"`}`;
+};
+/**
 * Build the common a:graphic > pic:pic element for images.
 *
 * Takes the relationship id as a separate argument so the caller has to have
@@ -221,18 +232,18 @@ function serializePicGraphic(image, imageRId, sharedId) {
 	const rId = escapeXmlAttribute(imageRId);
 	const id = sharedId;
 	const name = image.filename || `image${id}`;
-	let xfrmAttrs = "";
-	if (image.transform?.rotation) xfrmAttrs += ` rot="${Math.round(image.transform.rotation * 6e4)}"`;
-	if (image.transform?.flipH) xfrmAttrs += " flipH=\"1\"";
-	if (image.transform?.flipV) xfrmAttrs += " flipV=\"1\"";
+	const xfrmAttrs = serializeTransformAttrs(image.transform);
 	const cropAttrs = [];
 	if (image.crop?.left) cropAttrs.push(`l="${Math.round(image.crop.left * 1e5)}"`);
 	if (image.crop?.top) cropAttrs.push(`t="${Math.round(image.crop.top * 1e5)}"`);
 	if (image.crop?.right) cropAttrs.push(`r="${Math.round(image.crop.right * 1e5)}"`);
 	if (image.crop?.bottom) cropAttrs.push(`b="${Math.round(image.crop.bottom * 1e5)}"`);
 	const srcRectEl = cropAttrs.length > 0 ? `<a:srcRect ${cropAttrs.join(" ")}/>` : "";
-	const alphaChild = image.opacity !== void 0 && image.opacity < 1 ? `<a:alphaModFix amt="${Math.round(Math.max(0, image.opacity) * 1e5)}"/>` : "";
-	const blipEl = alphaChild ? `<a:blip r:embed="${rId}">${alphaChild}</a:blip>` : `<a:blip r:embed="${rId}"/>`;
+	const luminanceAttrs = [];
+	if (image.effects?.brightness !== void 0 && Number.isFinite(image.effects.brightness)) luminanceAttrs.push(`bright="${Math.round(normalizeImageLuminancePercent(image.effects.brightness) * 1e3)}"`);
+	if (image.effects?.contrast !== void 0 && Number.isFinite(image.effects.contrast)) luminanceAttrs.push(`contrast="${Math.round(normalizeImageLuminancePercent(image.effects.contrast) * 1e3)}"`);
+	const blipChildren = `${luminanceAttrs.length === 0 ? "" : `<a:lum ${luminanceAttrs.join(" ")}/>`}${image.opacity !== void 0 && image.opacity < 1 ? `<a:alphaModFix amt="${Math.round(Math.max(0, image.opacity) * 1e5)}"/>` : ""}`;
+	const blipEl = blipChildren ? `<a:blip r:embed="${rId}">${blipChildren}</a:blip>` : `<a:blip r:embed="${rId}"/>`;
 	return [
 		"<a:graphic xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\">",
 		"<a:graphicData uri=\"http://schemas.openxmlformats.org/drawingml/2006/picture\">",
@@ -373,13 +384,9 @@ function serializeShapeContent(content) {
 		...shape.alt !== void 0 ? { alt: shape.alt } : {},
 		...shape.title !== void 0 ? { title: shape.title } : {}
 	});
-	let xfrmAttrs = "";
-	if (shape.transform?.rotation) xfrmAttrs += ` rot="${Math.round(shape.transform.rotation * 6e4)}"`;
-	if (shape.transform?.flipH) xfrmAttrs += " flipH=\"1\"";
-	if (shape.transform?.flipV) xfrmAttrs += " flipV=\"1\"";
 	const spPr = [
 		"<wps:spPr>",
-		`<a:xfrm${xfrmAttrs}>`,
+		`<a:xfrm${serializeTransformAttrs(shape.transform)}>`,
 		"<a:off x=\"0\" y=\"0\"/>",
 		`<a:ext cx="${intAttr(cx)}" cy="${intAttr(cy)}"/>`,
 		"</a:xfrm>",
@@ -475,6 +482,7 @@ function serializeRunContent(content) {
 		case "softHyphen": return serializeSoftHyphen(content);
 		case "noBreakHyphen": return serializeNoBreakHyphen(content);
 		case "renderedPageBreak": return "<w:lastRenderedPageBreak/>";
+		case "preservedXml": return content.xml;
 		case "drawing":
 			if (content.rawXml && canReplayEditableImageRawXml(content)) return content.rawXml;
 			return serializeDrawingContent(content);
@@ -496,7 +504,8 @@ function serializeRun(run) {
 		const contentXml = serializeRunContent(content);
 		if (contentXml) parts.push(contentXml);
 	}
-	return `<w:r>${parts.join("")}</w:r>`;
+	const attrs = serializePreservedAttributes([], run.preservedAttributes);
+	return `<w:r${attrs.length > 0 ? ` ${attrs.join(" ")}` : ""}>${parts.join("")}</w:r>`;
 }
 /**
 * Serialize multiple runs to OOXML XML

package/dist/docx/serializer/sectionPropertiesSerializer.js

@@ -1,3 +1,4 @@
+import { serializePreservedAttributes } from "../attributeRemainder.js";
 import { getUnserializedSectionPropertyChildNames } from "../sectionParser.js";
 import { serializeSectionReferenceHistory } from "../sectionReferenceHistory.js";
 import { serializeBorder } from "./borderSerializer.js";
@@ -53,12 +54,12 @@ function serializePaperSource(props) {
 	return attrs.length > 0 ? `<w:paperSrc ${attrs.join(" ")}/>` : "";
 }
 function serializeColumns(props) {
-	if (props.columnCount === void 0 && !props.columns?.length && props.columnSpace === void 0 && props.equalWidth === void 0) return "";
+	if (props.columnCount === void 0 && !props.columns?.length && props.columnSpace === void 0 && props.equalWidth === void 0 && props.separator === void 0) return "";
 	const attrs = [];
 	if (props.columnCount !== void 0 && props.columnCount >= 1) attrs.push(`w:num="${intAttr(props.columnCount)}"`);
 	if (props.columnSpace !== void 0) attrs.push(`w:space="${intAttr(props.columnSpace)}"`);
 	if (props.equalWidth !== void 0) attrs.push(`w:equalWidth="${props.equalWidth ? "1" : "0"}"`);
-	if (props.separator) attrs.push("w:sep=\"1\"");
+	if (props.separator !== void 0) attrs.push(`w:sep="${props.separator ? "1" : "0"}"`);
 	const colElements = (props.columns ?? []).map((col) => {
 		const colAttrs = [];
 		if (col.width !== void 0) colAttrs.push(`w:w="${intAttr(col.width)}"`);
@@ -178,8 +179,11 @@ function serializeSectionProperties(props) {
 	for (const change of props.propertyChanges ?? []) parts.push(serializeSectionPropertyChange(change));
 	const unserializedChildNames = getUnserializedSectionPropertyChildNames(props);
 	if (unserializedChildNames && unserializedChildNames.length > 0) return "";
-	if (parts.length > 0) return `<w:sectPr>${parts.join("")}</w:sectPr>`;
-	if (Object.keys(props).length > 0) return "";
+	const attributes = serializePreservedAttributes([], props.preservedAttributes);
+	const startTag = attributes.length > 0 ? `<w:sectPr ${attributes.join(" ")}` : "<w:sectPr";
+	if (parts.length > 0) return `${startTag}>${parts.join("")}</w:sectPr>`;
+	if (Object.keys(props).some((key) => key !== "preservedAttributes")) return "";
+	if (attributes.length > 0) return `${startTag}/>`;
 	return "<w:sectPr/>";
 }
 //#endregion

package/dist/docx/serializer/tableSerializer.js

@@ -1,6 +1,7 @@
 import { canonicalJson } from "../../utils/canonicalJson.js";
 import { isValidHexColor } from "../../utils/colorResolver.js";
-import { withBlockRangeMarkers } from "../blockRangeMarkers.js";
+import { serializePreservedAttributes } from "../attributeRemainder.js";
+import { serializeWithPreservedChildren } from "../containerChildren.js";
 import { TABLE_LOOK_FLAGS } from "../tableLook.js";
 import { parseTableCellProperties, parseTableGrid, parseTableProperties, parseTableRowProperties } from "../tableParser.js";
 import { sanitizeCapturedXmlElement } from "../verbatimCapture.js";
@@ -369,8 +370,14 @@ const replayableGridChangeXml = (gridChangeXml) => sanitizeCapturedXmlElement(gr
 * Serialize cell content (paragraphs, nested tables)
 */
 function serializeCellContent(content, serializeParagraph) {
-	const parts = [];
-	for (const item of content) parts.push(withBlockRangeMarkers(item, item.type === "paragraph" ? serializeParagraph(item) : serializeTable(item, serializeParagraph)));
+	const parts = content.map((block) => {
+		switch (block.type) {
+			case "paragraph": return serializeParagraph(block);
+			case "table": return serializeTable(block, serializeParagraph);
+			case "preservedBlock": return block.xml;
+			default: return block;
+		}
+	});
 	if (parts.length === 0) parts.push("<w:p/>");
 	return parts.join("");
 }
@@ -391,8 +398,9 @@ function serializeTableRow(row, serializeParagraph) {
 	const parts = [];
 	const trPrXml = serializeTableRowFormatting(row.formatting, row.propertyChanges, row.structuralChange);
 	if (trPrXml) parts.push(trPrXml);
-	for (const cell of row.cells) parts.push(serializeTableCell(cell, serializeParagraph));
-	return `<w:tr>${parts.join("")}</w:tr>`;
+	parts.push(serializeWithPreservedChildren(row.cells.map((cell) => serializeTableCell(cell, serializeParagraph)), row.preserved));
+	const attrs = serializePreservedAttributes([], row.preservedAttributes);
+	return `<w:tr${attrs.length > 0 ? ` ${attrs.join(" ")}` : ""}>${parts.join("")}</w:tr>`;
 }
 /**
 * Serialize a table to OOXML XML (w:tbl)
@@ -401,9 +409,11 @@ function serializeTableRow(row, serializeParagraph) {
 * @returns XML string for the table
 */
 function serializeTable(table, serializeParagraph) {
-	const parts = [serializeTableFormatting(table.formatting, table.propertyChanges) || "<w:tblPr/>", serializeTableGrid(table)];
-	for (const row of table.rows) parts.push(serializeTableRow(row, serializeParagraph));
-	return `<w:tbl>${parts.join("")}</w:tbl>`;
+	return `<w:tbl>${[
+		serializeTableFormatting(table.formatting, table.propertyChanges) || "<w:tblPr/>",
+		serializeTableGrid(table),
+		serializeWithPreservedChildren(table.rows.map((row) => serializeTableRow(row, serializeParagraph)), table.preserved)
+	].join("")}</w:tbl>`;
 }
 /**
 * Serialize multiple tables to OOXML XML

package/dist/docx/server/createBilingualDocument.js

@@ -203,6 +203,7 @@ const flattenBlocks = (content) => {
 			out.push(block);
 			return;
 		}
+		if (block.type === "preservedBlock") return;
 		for (const child of block.content) visit(child);
 	};
 	for (const block of content) visit(block);
@@ -462,7 +463,7 @@ const remapListRendering = (rendering, cloner) => {
 const collectTableParagraphs = (table) => {
 	const out = [];
 	for (const row of table.rows) for (const cell of row.cells) for (const item of cell.content) if (item.type === "paragraph") out.push(item);
-	else out.push(...collectTableParagraphs(item));
+	else if (item.type === "table") out.push(...collectTableParagraphs(item));
 	return out;
 };
 const cloneTableForTarget = ({ table, editableParagraphIds, paraIds, styleCloner, cloner, bookmarkIds }) => {
@@ -475,6 +476,7 @@ const cloneTableForTarget = ({ table, editableParagraphIds, paraIds, styleCloner
 				...structuredClone(cell),
 				content: cell.content.map((item) => {
 					if (item.type === "table") return cloneTable(item);
+					if (item.type !== "paragraph") return structuredClone(item);
 					const targetParaId = paraIds.mint(item.paraId);
 					const copy = cloneParagraphForTarget(item, targetParaId, styleCloner, cloner, bookmarkIds);
 					if (isTranslatableParagraph(item, editableParagraphIds)) paragraphs.push({

package/dist/docx/server/materializeYjsDocx.d.ts

@@ -4,7 +4,7 @@ declare const FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME = "prosemirror";
 /** Maximum accepted size of a complete Yjs collaboration state update. */
 declare const FOLIO_YJS_UPDATE_MAX_BYTES: number;
 /** Stable failure codes returned by server-side Yjs-to-DOCX materialization. */
-declare const FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES: readonly ["empty_update", "invalid_update", "missing_document", "source_mismatch", "update_too_large"];
+declare const FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES: readonly ["empty_update", "invalid_update", "missing_document", "source_mismatch", "stale_attr_schema", "update_too_large"];
 /** Failure code for a rejected Yjs-to-DOCX materialization request. */
 type FolioYjsDocxMaterializationErrorCode = (typeof FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES)[number];
 declare const FolioYjsDocxMaterializationError_base: import("better-result").TaggedErrorClass<"FolioYjsDocxMaterializationError">;

package/dist/docx/server/materializeYjsDocx.js

@@ -1,6 +1,6 @@
 import { fromProseDoc } from "../../prosemirror/conversion/fromProseDoc.js";
 import { schema } from "../../prosemirror/schema/index.js";
-import { readYjsParagraphSourceContract, withParagraphSourceContract } from "../../prosemirror/yjsParagraphSourceContract.js";
+import { applyAttrSchemaMigrations, readYjsAttrSchemaVersion, readYjsParagraphSourceContract, withParagraphSourceContract } from "../../prosemirror/yjsDocumentMetadata.js";
 import { ParagraphPropertySourceValidationError } from "../paragraphPropertySource.js";
 import { parseDocx } from "../parser.js";
 import { repackDocx } from "../rezip.js";
@@ -18,6 +18,7 @@ const FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES = [
 	"invalid_update",
 	"missing_document",
 	"source_mismatch",
+	"stale_attr_schema",
 	"update_too_large"
 ];
 /** Typed failure raised when a collaboration snapshot cannot be materialized. */
@@ -40,6 +41,13 @@ const readProseMirrorDocument = (yjsUpdate) => {
 				code: "missing_document",
 				message: "Yjs update does not contain a Folio document."
 			});
+			const attrSchemaVersion = readYjsAttrSchemaVersion(ydoc);
+			if (attrSchemaVersion.isErr()) throw new FolioYjsDocxMaterializationError({
+				cause: attrSchemaVersion.error,
+				code: "stale_attr_schema",
+				message: attrSchemaVersion.error.message
+			});
+			applyAttrSchemaMigrations(ydoc, fragment, attrSchemaVersion.value);
 			const contract = readYjsParagraphSourceContract(ydoc);
 			if (!contract) throw new FolioYjsDocxMaterializationError({
 				code: "source_mismatch",

package/dist/docx/server/migrateYjsAttrSchema.d.ts

@@ -0,0 +1,55 @@
+import { FolioYjsAttrSchemaVersion } from "../../prosemirror/yjsDocumentMetadata.js";
+import { Result } from "better-result";
+//#region src/docx/server/migrateYjsAttrSchema.d.ts
+/** Stable failure codes returned by an offline snapshot migration. */
+declare const FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES: readonly ["invalid_update", "unsupported_version", "update_too_large"];
+/** Failure code for a snapshot that could not be migrated. */
+type FolioYjsSnapshotMigrationErrorCode = (typeof FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES)[number];
+declare const FolioYjsSnapshotMigrationError_base: import("better-result").TaggedErrorClass<"FolioYjsSnapshotMigrationError">;
+/** Typed failure raised when a collaboration snapshot cannot be migrated. */
+declare class FolioYjsSnapshotMigrationError extends FolioYjsSnapshotMigrationError_base<{
+  code: FolioYjsSnapshotMigrationErrorCode;
+  message: string;
+  cause?: unknown;
+}> {}
+/** What an offline migration did to one snapshot. */
+type FolioYjsSnapshotMigrationResult = {
+  /** The complete state update to store in place of the input. */
+  update: Uint8Array;
+  /** The attr-schema version the input was written under. */
+  fromVersion: FolioYjsAttrSchemaVersion;
+  /** The attr-schema version the output carries. */
+  toVersion: FolioYjsAttrSchemaVersion;
+  /** Paragraphs whose attrs the migration rewrote. */
+  paragraphsRewritten: number;
+};
+/**
+ * Carry a stored collaboration snapshot forward to the attr schema this build
+ * writes, without a ProseMirror schema and without rebuilding a single node.
+ *
+ * A Yjs XML element's attributes are ordinary CRDT map entries holding JSON, so
+ * {@link applyAttrSchemaMigrations} rewrites values in the fragment directly.
+ * Nothing here can trip y-prosemirror's node rebuild, which deletes an element
+ * it fails to construct. The function is pure and offline: no network, no
+ * DOCX, no editor.
+ *
+ * A snapshot already at the current version is returned byte for byte, so a
+ * host may run this over its whole corpus repeatedly.
+ *
+ * **The contract a reseed must respect.** This function never reseeds and never
+ * touches the paragraph-source contract: it preserves whichever source binding
+ * the snapshot already carries. A reseed does the opposite, and Folio holds it
+ * to one rule: *the DOCX handed to the seeding editor must be the same bytes
+ * the host will later pass to `materializeYjsDocx` as that room's source*.
+ * The contract is a digest of those bytes, so seeding from one document while
+ * recording another as the room's source makes every later save fail with
+ * `source_mismatch`. The reverse mistake is worse and Folio cannot see it: a
+ * host that reseeds from the document a room was *created* from, rather than
+ * from the latest content it published, produces a perfectly well-formed
+ * snapshot whose collaborative history has been replaced by an older document.
+ * Rebind the recorded source in the same statement that clears the seed, or do
+ * not clear it.
+ */
+declare const migrateFolioYjsSnapshot: (update: Uint8Array) => Result<FolioYjsSnapshotMigrationResult, FolioYjsSnapshotMigrationError>;
+//#endregion
+export { FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES, FolioYjsSnapshotMigrationError, FolioYjsSnapshotMigrationErrorCode, FolioYjsSnapshotMigrationResult, migrateFolioYjsSnapshot };

package/dist/docx/server/migrateYjsAttrSchema.js

@@ -0,0 +1,95 @@
+import { applyAttrSchemaMigrations, readYjsAttrSchemaVersion } from "../../prosemirror/yjsDocumentMetadata.js";
+import { FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME } from "./materializeYjsDocx.js";
+import { Result, TaggedError } from "better-result";
+import * as Y from "yjs";
+//#region src/docx/server/migrateYjsAttrSchema.ts
+/** Stable failure codes returned by an offline snapshot migration. */
+const FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES = [
+	"invalid_update",
+	"unsupported_version",
+	"update_too_large"
+];
+/** Typed failure raised when a collaboration snapshot cannot be migrated. */
+var FolioYjsSnapshotMigrationError = class extends TaggedError("FolioYjsSnapshotMigrationError") {};
+/**
+* Carry a stored collaboration snapshot forward to the attr schema this build
+* writes, without a ProseMirror schema and without rebuilding a single node.
+*
+* A Yjs XML element's attributes are ordinary CRDT map entries holding JSON, so
+* {@link applyAttrSchemaMigrations} rewrites values in the fragment directly.
+* Nothing here can trip y-prosemirror's node rebuild, which deletes an element
+* it fails to construct. The function is pure and offline: no network, no
+* DOCX, no editor.
+*
+* A snapshot already at the current version is returned byte for byte, so a
+* host may run this over its whole corpus repeatedly.
+*
+* **The contract a reseed must respect.** This function never reseeds and never
+* touches the paragraph-source contract: it preserves whichever source binding
+* the snapshot already carries. A reseed does the opposite, and Folio holds it
+* to one rule: *the DOCX handed to the seeding editor must be the same bytes
+* the host will later pass to `materializeYjsDocx` as that room's source*.
+* The contract is a digest of those bytes, so seeding from one document while
+* recording another as the room's source makes every later save fail with
+* `source_mismatch`. The reverse mistake is worse and Folio cannot see it: a
+* host that reseeds from the document a room was *created* from, rather than
+* from the latest content it published, produces a perfectly well-formed
+* snapshot whose collaborative history has been replaced by an older document.
+* Rebind the recorded source in the same statement that clears the seed, or do
+* not clear it.
+*/
+const migrateFolioYjsSnapshot = (update) => {
+	if (update.byteLength === 0) return Result.err(new FolioYjsSnapshotMigrationError({
+		code: "invalid_update",
+		message: "Cannot migrate an empty Yjs update."
+	}));
+	if (update.byteLength > 10485760) return Result.err(new FolioYjsSnapshotMigrationError({
+		code: "update_too_large",
+		message: "Yjs update exceeds the snapshot migration limit."
+	}));
+	const ydoc = new Y.Doc();
+	const applied = Result.try({
+		try: () => {
+			Y.applyUpdate(ydoc, update);
+		},
+		catch: (cause) => new FolioYjsSnapshotMigrationError({
+			cause,
+			code: "invalid_update",
+			message: "Yjs update is not a valid Folio collaboration snapshot."
+		})
+	});
+	if (applied.isErr()) {
+		ydoc.destroy();
+		return Result.err(applied.error);
+	}
+	const read = readYjsAttrSchemaVersion(ydoc);
+	if (read.isErr()) {
+		ydoc.destroy();
+		return Result.err(new FolioYjsSnapshotMigrationError({
+			cause: read.error,
+			code: "unsupported_version",
+			message: read.error.message
+		}));
+	}
+	const fromVersion = read.value;
+	if (fromVersion === 3) {
+		ydoc.destroy();
+		return Result.ok({
+			fromVersion,
+			paragraphsRewritten: 0,
+			toVersion: 3,
+			update
+		});
+	}
+	const paragraphsRewritten = applyAttrSchemaMigrations(ydoc, ydoc.getXmlFragment(FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME), fromVersion);
+	const migrated = Y.encodeStateAsUpdate(ydoc);
+	ydoc.destroy();
+	return Result.ok({
+		fromVersion,
+		paragraphsRewritten,
+		toVersion: 3,
+		update: migrated
+	});
+};
+//#endregion
+export { FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES, FolioYjsSnapshotMigrationError, migrateFolioYjsSnapshot };

package/dist/docx/shapeParser.js

@@ -27,13 +27,13 @@ function parseTransform(xfrm) {
 		height: parseNumericAttribute(ext, null, "cy") ?? 0
 	};
 	const rotation = rotToDegrees(getAttribute(xfrm, null, "rot"));
-	const flipH = parseOnOffAttribute(xfrm, null, "flipH") === true;
-	const flipV = parseOnOffAttribute(xfrm, null, "flipV") === true;
-	if (rotation === void 0 && !flipH && !flipV) return { size };
+	const flipH = parseOnOffAttribute(xfrm, null, "flipH");
+	const flipV = parseOnOffAttribute(xfrm, null, "flipV");
+	if (rotation === void 0 && flipH === void 0 && flipV === void 0) return { size };
 	const transform = {};
 	if (rotation !== void 0) transform.rotation = rotation;
-	if (flipH) transform.flipH = true;
-	if (flipV) transform.flipV = true;
+	if (flipH !== void 0) transform.flipH = flipH;
+	if (flipV !== void 0) transform.flipV = flipV;
 	return {
 		size,
 		transform

package/dist/docx/tableParser.d.ts

@@ -1,7 +1,7 @@
 import { document_d_exports } from "../types/document.js";
 import { NumberingMap } from "./numberingParser.js";
-import { StyleMap } from "./styleParser.js";
 import { XmlElement } from "./xmlParser.js";
+import { StyleMap } from "./styleParser.js";
 //#region src/docx/tableParser.d.ts
 /**
  * Sanity cap on `w:gridSpan` (and the derived table column count). Word's