@stll/folio-core 0.62.0 → 0.63.0

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

@@ -1,21 +1,21 @@
 //#region src/docx/server/materializeYjsDocx.d.ts
 /** Yjs fragment that stores Folio's canonical ProseMirror document. */
-declare const FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME = "prosemirror";
+export 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;
+export 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", "stale_attr_schema", "update_too_large"];
+export 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];
+export type FolioYjsDocxMaterializationErrorCode = (typeof FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES)[number];
 declare const FolioYjsDocxMaterializationError_base: import("better-result").TaggedErrorClass<"FolioYjsDocxMaterializationError">;
 /** Typed failure raised when a collaboration snapshot cannot be materialized. */
-declare class FolioYjsDocxMaterializationError extends FolioYjsDocxMaterializationError_base<{
+export declare class FolioYjsDocxMaterializationError extends FolioYjsDocxMaterializationError_base<{
   code: FolioYjsDocxMaterializationErrorCode;
   message: string;
   cause?: unknown;
 }> {}
 /** Inputs for materializing a complete Yjs state update into a DOCX package. */
-type MaterializeYjsDocxOptions = {
+export type MaterializeYjsDocxOptions = {
   /** Original DOCX whose package parts and non-body stories must be preserved. */
   sourceDocx: ArrayBuffer | Uint8Array;
   /** Complete Yjs state update containing Folio's ProseMirror fragment. */
@@ -26,6 +26,6 @@ type MaterializeYjsDocxOptions = {
  * package parts from the source document. This is the server-side equivalent
  * of the browser editor's full save path for the main document story.
  */
-declare const materializeYjsDocx: ({ sourceDocx, yjsUpdate }: MaterializeYjsDocxOptions) => Promise<ArrayBuffer>;
+export declare const materializeYjsDocx: ({ sourceDocx, yjsUpdate }: MaterializeYjsDocxOptions) => Promise<ArrayBuffer>;
 //#endregion
-export { FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES, FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME, FOLIO_YJS_UPDATE_MAX_BYTES, FolioYjsDocxMaterializationError, FolioYjsDocxMaterializationErrorCode, MaterializeYjsDocxOptions, materializeYjsDocx };
+export {};

package/dist/docx/server/materializeYjsDocx.js

@@ -11,7 +11,7 @@ import * as Y from "yjs";
 /** Yjs fragment that stores Folio's canonical ProseMirror document. */
 const FOLIO_YJS_PROSEMIRROR_FRAGMENT_NAME = "prosemirror";
 /** Maximum accepted size of a complete Yjs collaboration state update. */
-const FOLIO_YJS_UPDATE_MAX_BYTES = 10 * 1024 * 1024;
+const FOLIO_YJS_UPDATE_MAX_BYTES = 10485760;
 /** Stable failure codes returned by server-side Yjs-to-DOCX materialization. */
 const FOLIO_YJS_DOCX_MATERIALIZATION_ERROR_CODES = [
 	"empty_update",

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

@@ -2,18 +2,18 @@ import { FolioYjsAttrSchemaVersion } from "../../prosemirror/yjsDocumentMetadata
 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"];
+export 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];
+export 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<{
+export declare class FolioYjsSnapshotMigrationError extends FolioYjsSnapshotMigrationError_base<{
   code: FolioYjsSnapshotMigrationErrorCode;
   message: string;
   cause?: unknown;
 }> {}
 /** What an offline migration did to one snapshot. */
-type FolioYjsSnapshotMigrationResult = {
+export type FolioYjsSnapshotMigrationResult = {
   /** The complete state update to store in place of the input. */
   update: Uint8Array;
   /** The attr-schema version the input was written under. */
@@ -50,6 +50,6 @@ type FolioYjsSnapshotMigrationResult = {
  * 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>;
+export declare const migrateFolioYjsSnapshot: (update: Uint8Array) => Result<FolioYjsSnapshotMigrationResult, FolioYjsSnapshotMigrationError>;
 //#endregion
-export { FOLIO_YJS_SNAPSHOT_MIGRATION_ERROR_CODES, FolioYjsSnapshotMigrationError, FolioYjsSnapshotMigrationErrorCode, FolioYjsSnapshotMigrationResult, migrateFolioYjsSnapshot };
+export {};

package/dist/docx/server/migrateYjsAttrSchema.js

@@ -84,12 +84,12 @@ const migrateFolioYjsSnapshot = (update) => {
 		ydoc.destroy();
 		return Result.err(migratedAttrs.error);
 	}
-	if (fromVersion === 13) {
+	if (fromVersion === 14) {
 		ydoc.destroy();
 		return Result.ok({
 			fromVersion,
 			paragraphsRewritten: 0,
-			toVersion: 13,
+			toVersion: 14,
 			update
 		});
 	}
@@ -99,7 +99,7 @@ const migrateFolioYjsSnapshot = (update) => {
 	return Result.ok({
 		fromVersion,
 		paragraphsRewritten,
-		toVersion: 13,
+		toVersion: 14,
 		update: migrated
 	});
 };

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

@@ -1,15 +1,15 @@
 import { document_d_exports } from "../../types/document.js";
 import { DocxArchiveOptions } from "./boundedArchive.js";
 //#region src/docx/server/validateDocxConformance.d.ts
-declare const FOLIO_DOCX_CONFORMANCE_REPORT_VERSION: 1;
-declare const FOLIO_DOCX_CONFORMANCE_PROFILE: "folio-supported-v1";
-declare const FOLIO_DOCX_CONFORMANCE_CHECKS: readonly ["archive-safety", "required-parts", "xml-well-formedness", "package-roots", "conformance-class", "canonical-model"];
-declare const FOLIO_DOCX_CONFORMANCE_ISSUE_CODES: readonly ["archive-load-failed", "archive-invalid-options", "archive-input-too-large", "archive-too-many-entries", "archive-entry-too-large", "archive-total-too-large", "archive-compression-ratio-exceeded", "required-part-missing", "xml-doctype-forbidden", "xml-not-well-formed", "xml-read-failed", "required-xml-unreadable", "package-root-invalid", "conformance-class-unknown", "model-invalid", "model-warning", "parser-recovery", "parser-unsupported", "parser-failed", "encrypted-container", "container-not-zip"];
-type FolioDocxConformanceCheckId = (typeof FOLIO_DOCX_CONFORMANCE_CHECKS)[number];
-type FolioDocxConformanceIssueCode = (typeof FOLIO_DOCX_CONFORMANCE_ISSUE_CODES)[number];
-type FolioDocxConformanceCheckStatus = "passed" | "failed" | "indeterminate" | "not-run";
-type FolioDocxConformanceStatus = "invalid" | "conformant" | "indeterminate";
-type FolioDocxConformanceIssue = {
+export declare const FOLIO_DOCX_CONFORMANCE_REPORT_VERSION: 1;
+export declare const FOLIO_DOCX_CONFORMANCE_PROFILE: "folio-supported-v1";
+export declare const FOLIO_DOCX_CONFORMANCE_CHECKS: readonly ["archive-safety", "required-parts", "xml-well-formedness", "package-roots", "conformance-class", "canonical-model"];
+export declare const FOLIO_DOCX_CONFORMANCE_ISSUE_CODES: readonly ["archive-load-failed", "archive-invalid-options", "archive-input-too-large", "archive-too-many-entries", "archive-entry-too-large", "archive-total-too-large", "archive-compression-ratio-exceeded", "required-part-missing", "xml-doctype-forbidden", "xml-not-well-formed", "xml-read-failed", "required-xml-unreadable", "package-root-invalid", "conformance-class-unknown", "model-invalid", "model-warning", "parser-recovery", "parser-unsupported", "parser-failed", "encrypted-container", "container-not-zip"];
+export type FolioDocxConformanceCheckId = (typeof FOLIO_DOCX_CONFORMANCE_CHECKS)[number];
+export type FolioDocxConformanceIssueCode = (typeof FOLIO_DOCX_CONFORMANCE_ISSUE_CODES)[number];
+export type FolioDocxConformanceCheckStatus = "passed" | "failed" | "indeterminate" | "not-run";
+export type FolioDocxConformanceStatus = "invalid" | "conformant" | "indeterminate";
+export type FolioDocxConformanceIssue = {
   readonly check: FolioDocxConformanceCheckId;
   readonly code: FolioDocxConformanceIssueCode;
   readonly message: string;
@@ -18,11 +18,11 @@ type FolioDocxConformanceIssue = {
   readonly modelPath?: string;
   readonly count?: number;
 };
-type FolioDocxConformanceCheck = {
+export type FolioDocxConformanceCheck = {
   readonly id: FolioDocxConformanceCheckId;
   readonly status: FolioDocxConformanceCheckStatus;
 };
-type FolioDocxConformanceReport = {
+export type FolioDocxConformanceReport = {
   readonly version: typeof FOLIO_DOCX_CONFORMANCE_REPORT_VERSION;
   readonly profile: typeof FOLIO_DOCX_CONFORMANCE_PROFILE;
   readonly status: FolioDocxConformanceStatus;
@@ -31,10 +31,9 @@ type FolioDocxConformanceReport = {
   readonly issues: readonly FolioDocxConformanceIssue[];
   readonly unverifiedStandardsDimensions: readonly ["complete-schema-constraints", "markup-compatibility-processing", "consumer-specific-rendering"];
 };
-type ValidateDocxConformanceOptions = {
+export type ValidateDocxConformanceOptions = {
   readonly archive?: DocxArchiveOptions;
 };
 /** Assess a DOCX package against Folio's named, versioned support profile. */
-declare const validateDocxConformance: (bytes: ArrayBuffer | Uint8Array, options?: ValidateDocxConformanceOptions) => Promise<FolioDocxConformanceReport>;
-//#endregion
-export { FOLIO_DOCX_CONFORMANCE_CHECKS, FOLIO_DOCX_CONFORMANCE_ISSUE_CODES, FOLIO_DOCX_CONFORMANCE_PROFILE, FOLIO_DOCX_CONFORMANCE_REPORT_VERSION, FolioDocxConformanceCheck, FolioDocxConformanceCheckId, FolioDocxConformanceCheckStatus, FolioDocxConformanceIssue, FolioDocxConformanceIssueCode, FolioDocxConformanceReport, FolioDocxConformanceStatus, ValidateDocxConformanceOptions, validateDocxConformance };
+export declare const validateDocxConformance: (bytes: ArrayBuffer | Uint8Array, options?: ValidateDocxConformanceOptions) => Promise<FolioDocxConformanceReport>;
+//#endregion

package/dist/docx/settingsHeaderFooterUpdate.d.ts

@@ -1,5 +1,4 @@
 //#region src/docx/settingsHeaderFooterUpdate.d.ts
 /** Null means the source is malformed or outside the supported namespace profiles. */
-declare const updateEvenAndOddHeaders: (xml: string, enabled: boolean | undefined) => string | null;
-//#endregion
-export { updateEvenAndOddHeaders };
+export declare const updateEvenAndOddHeaders: (xml: string, enabled: boolean | undefined) => string | null;
+//#endregion

package/dist/docx/settingsParser.d.ts

@@ -1,6 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { DEFAULT_TAB_STOP_TWIPS } from "@stll/docx-core/model";
 //#region src/docx/settingsParser.d.ts
-declare function parseSettings(xml: string | null): document_d_exports.DocumentSettings;
+export declare function parseSettings(xml: string | null): document_d_exports.DocumentSettings;
 //#endregion
-export { DEFAULT_TAB_STOP_TWIPS, parseSettings };
+export { DEFAULT_TAB_STOP_TWIPS };

package/dist/docx/settingsParser.js

@@ -3,6 +3,16 @@ import { WORDPROCESSINGML_NAMESPACE_URIS, findChild, findChildByNamespaceUri, fi
 import { DEFAULT_TAB_STOP_TWIPS, DEFAULT_TAB_STOP_TWIPS as DEFAULT_TAB_STOP_TWIPS$1 } from "@stll/docx-core/model";
 //#region src/docx/settingsParser.ts
 /**
+* settings.xml parser
+*
+* Extracts document-wide settings the layout pipeline consumes at render
+* time. We deliberately read only the handful of settings that affect
+* layout, including the line-breaking compatibility controls Folio supports;
+* the rest of settings.xml is preserved opaquely by the rezip step.
+*
+* See ECMA-376 §17.15 for the full settings part.
+*/
+/**
 * Sanity cap on `w:defaultTabStop`. Word's maximum margin is ~22 inches
 * (31 680 twips); anything past that is corruption or a hostile input and
 * we substitute the OOXML default instead.
@@ -56,6 +66,8 @@ function parseSettings(xml) {
 	const compat = root ? findChild(root, "w", "compat") : null;
 	const compatibilityMode = parseCompatibilityMode(compat);
 	if (compatibilityMode !== void 0) settings.compatibilityMode = compatibilityMode;
+	const noColumnBalance = compat ? findChildByNamespaceUri(compat, WORDPROCESSINGML_NAMESPACE_URIS, "noColumnBalance") : null;
+	if (noColumnBalance !== null) settings.noColumnBalance = parseBooleanElement(noColumnBalance);
 	const splitPageBreakAndParagraphMark = compat ? findChild(compat, "w", "splitPgBreakAndParaMark") : null;
 	if (splitPageBreakAndParagraphMark && parseBooleanElement(splitPageBreakAndParagraphMark)) settings.splitPageBreakAndParagraphMark = true;
 	const wordprocessingCompat = root ? findChildByNamespaceUri(root, WORDPROCESSINGML_NAMESPACE_URIS, "compat") : null;

package/dist/docx/shadingParser.d.ts

@@ -2,6 +2,5 @@ import { document_d_exports } from "../types/document.js";
 import { ParseContext } from "./parseContext.js";
 import { XmlElement } from "./xmlParser.js";
 //#region src/docx/shadingParser.d.ts
-declare function parseShading(shd: XmlElement | null, context?: ParseContext): document_d_exports.ShadingProperties | undefined;
-//#endregion
-export { parseShading };
+export declare function parseShading(shd: XmlElement | null, context?: ParseContext): document_d_exports.ShadingProperties | undefined;
+//#endregion

package/dist/docx/shapeAlternateContent.d.ts

@@ -5,21 +5,22 @@ import { XmlElement } from "./xmlParser.js";
  * Capture the `mc:AlternateContent` a shape was read from, when the shape's
  * drawing is the sole child of the branch it came from.
  */
-declare const captureShapeAlternateContent: ({ shape, alternateContent, branch, drawing }: {
+export declare const captureShapeAlternateContent: ({ shape, alternateContent, branch, drawing }: {
   shape: Shape;
   alternateContent: XmlElement;
   branch: XmlElement;
   drawing: XmlElement;
 }) => ShapeAlternateContent | undefined;
 /** Re-fingerprint a capture for a shape rebuilt from an unedited projection. */
-declare const refingerprintShapeAlternateContent: (shape: Shape, verbatimXml: string) => ShapeAlternateContent;
+export declare const refingerprintShapeAlternateContent: (shape: Shape, verbatimXml: string) => ShapeAlternateContent;
 /**
  * The captured `mc:AlternateContent` to write in place of the shape's drawing,
  * or undefined when the shape must be regenerated.
  *
- * Replay requires the modeled shape to still match the capture. An edited shape
- * is regenerated as a bare `w:drawing` without the stale Fallback.
+ * Replay requires the modeled shape to match the capture. Structural edits
+ * regenerate a bare drawing rather than replaying stale geometry.
  */
-declare const replayableShapeAlternateContent: (content: ShapeContent) => string | undefined;
-//#endregion
-export { captureShapeAlternateContent, refingerprintShapeAlternateContent, replayableShapeAlternateContent };
+export declare const replayableShapeAlternateContent: (content: ShapeContent) => string | undefined;
+/** Synchronize only a text-only edit, after the caller needs regenerated drawing markup. */
+export declare const synchronizedTextShapeAlternateContent: (content: ShapeContent, regeneratedDrawingXml: string) => string | undefined;
+//#endregion

package/dist/docx/shapeAlternateContent.js

@@ -1,12 +1,23 @@
 import { canonicalJson } from "../utils/canonicalJson.js";
-import { captureVerbatimXml } from "./verbatimCapture.js";
-import { getChildElements, getLocalName } from "./xmlParser.js";
+import { captureVerbatimXml, isSafeCapturedXmlDocument } from "./verbatimCapture.js";
+import { NAMESPACES, WORDPROCESSINGML_NAMESPACE_URIS, cloneWithXmlnsDeclarations, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, parseXmlDocument } from "./xmlParser.js";
+import { assertXmlResourceLimits } from "./xmlResourceLimits.js";
+import { panic } from "better-result";
 //#region src/docx/shapeAlternateContent.ts
 /**
 * Every modeled field, text body included: the Fallback repeats the shape's
 * geometry and its text, so an edit to either makes the captured element stale.
 */
 const shapeFingerprint = (shape) => canonicalJson(shape);
+const shapeStructureFingerprint = (shape) => {
+	const { textBody, ...shapeProperties } = shape;
+	if (textBody === void 0) return canonicalJson(shapeProperties);
+	const { content: _content, ...textBodyProperties } = textBody;
+	return canonicalJson({
+		...shapeProperties,
+		textBody: textBodyProperties
+	});
+};
 /**
 * Whether `element` is the only child element of its `mc:Choice` or
 * `mc:Fallback` branch.
@@ -26,27 +37,91 @@ const isSoleBranchChild = (branch, element) => {
 const captureShapeAlternateContent = ({ shape, alternateContent, branch, drawing }) => {
 	if (getLocalName(alternateContent.name ?? "") !== "AlternateContent") return;
 	if (!isSoleBranchChild(branch, drawing)) return;
+	const selfContainedAlternateContent = cloneWithXmlnsDeclarations(alternateContent, {});
 	return {
-		verbatimXml: captureVerbatimXml(alternateContent),
-		verbatimFingerprint: shapeFingerprint(shape)
+		verbatimXml: captureVerbatimXml(selfContainedAlternateContent),
+		verbatimFingerprint: shapeFingerprint(shape),
+		verbatimStructureFingerprint: shapeStructureFingerprint(shape)
 	};
 };
 /** Re-fingerprint a capture for a shape rebuilt from an unedited projection. */
 const refingerprintShapeAlternateContent = (shape, verbatimXml) => ({
 	verbatimXml,
-	verbatimFingerprint: shapeFingerprint(shape)
+	verbatimFingerprint: shapeFingerprint(shape),
+	verbatimStructureFingerprint: shapeStructureFingerprint(shape)
 });
+const descendantsNamed = ({ root, namespaceUris, localName }) => {
+	const result = [];
+	const visit = (element) => {
+		for (const child of getChildElements(element)) {
+			if (namespaceUris.has(getNamespaceUri(child) ?? "") && getLocalName(child.name ?? "") === localName) result.push(child);
+			visit(child);
+		}
+	};
+	visit(root);
+	return result;
+};
+const branchNamed = (root, localName) => getChildElements(root).find((child) => getNamespaceUri(child) === NAMESPACES.mc && getLocalName(child.name ?? "") === localName);
+const updateAlternateContentText = (capturedXml, drawingXml) => {
+	assertXmlResourceLimits({ xml: capturedXml });
+	assertXmlResourceLimits({ xml: drawingXml });
+	const alternateContent = parseXmlDocument(capturedXml);
+	const drawing = parseXmlDocument(`<root xmlns:w="${NAMESPACES.w}">${drawingXml}</root>`);
+	if (alternateContent === null || drawing === null) panic("Captured shape alternate content failed to parse during serialization.");
+	const choice = branchNamed(alternateContent, "Choice");
+	const fallback = branchNamed(alternateContent, "Fallback");
+	const choiceBodies = choice ? descendantsNamed({
+		root: choice,
+		namespaceUris: WORDPROCESSINGML_NAMESPACE_URIS,
+		localName: "txbxContent"
+	}) : [];
+	const fallbackBodies = fallback ? descendantsNamed({
+		root: fallback,
+		namespaceUris: WORDPROCESSINGML_NAMESPACE_URIS,
+		localName: "txbxContent"
+	}) : [];
+	const drawingBodies = descendantsNamed({
+		root: drawing,
+		namespaceUris: WORDPROCESSINGML_NAMESPACE_URIS,
+		localName: "txbxContent"
+	});
+	if (choiceBodies.length !== 1 || fallbackBodies.length !== 1 || drawingBodies.length !== 1) return;
+	const choiceBody = choiceBodies.at(0);
+	const fallbackBody = fallbackBodies.at(0);
+	const drawingBody = drawingBodies.at(0);
+	if (choiceBody === void 0 || fallbackBody === void 0 || drawingBody === void 0) return;
+	const qualifiedName = drawingBody.name ?? "txbxContent";
+	const prefix = getNamespacePrefix(qualifiedName);
+	const declaration = prefix === null ? "xmlns" : `xmlns:${prefix}`;
+	for (const body of [choiceBody, fallbackBody]) {
+		body.name = qualifiedName;
+		body.attributes = {
+			...body.attributes,
+			[declaration]: NAMESPACES.w
+		};
+		body.elements = drawingBody.elements ?? [];
+	}
+	const synchronizedXml = captureVerbatimXml(alternateContent);
+	if (!isSafeCapturedXmlDocument(synchronizedXml)) panic("Synchronized shape alternate content failed XML validation.");
+	return synchronizedXml;
+};
 /**
 * The captured `mc:AlternateContent` to write in place of the shape's drawing,
 * or undefined when the shape must be regenerated.
 *
-* Replay requires the modeled shape to still match the capture. An edited shape
-* is regenerated as a bare `w:drawing` without the stale Fallback.
+* Replay requires the modeled shape to match the capture. Structural edits
+* regenerate a bare drawing rather than replaying stale geometry.
 */
 const replayableShapeAlternateContent = (content) => {
 	const captured = content.alternateContent;
 	if (captured === void 0) return;
-	return captured.verbatimFingerprint === shapeFingerprint(content.shape) ? captured.verbatimXml : void 0;
+	if (captured.verbatimFingerprint === shapeFingerprint(content.shape)) return captured.verbatimXml;
+};
+/** Synchronize only a text-only edit, after the caller needs regenerated drawing markup. */
+const synchronizedTextShapeAlternateContent = (content, regeneratedDrawingXml) => {
+	const captured = content.alternateContent;
+	if (captured === void 0 || captured.verbatimStructureFingerprint === void 0 || captured.verbatimStructureFingerprint !== shapeStructureFingerprint(content.shape)) return;
+	return updateAlternateContentText(captured.verbatimXml, regeneratedDrawingXml);
 };
 //#endregion
-export { captureShapeAlternateContent, refingerprintShapeAlternateContent, replayableShapeAlternateContent };
+export { captureShapeAlternateContent, refingerprintShapeAlternateContent, replayableShapeAlternateContent, synchronizedTextShapeAlternateContent };

package/dist/docx/shapeParser.d.ts

@@ -6,14 +6,13 @@ import { XmlElement } from "./xmlParser.js";
  * extent / position / wrap fields — those live on the wrapping
  * `<wp:inline>` / `<wp:anchor>` and are handled by `parseShapeFromDrawing`.
  */
-declare function parseShape(node: XmlElement): document_d_exports.Shape;
+export declare function parseShape(node: XmlElement): document_d_exports.Shape;
 /**
  * Parse a `<w:drawing>` element as a shape (i.e. the `<a:graphicData>` payload
  * is `<wps:wsp>`, not `<pic:pic>` or a text-box). Returns null when the
  * drawing is not a shape, or when it is a text-box (delegated to
  * `textBoxParser.parseTextBox`).
  */
-declare function parseShapeFromDrawing(drawingEl: XmlElement): document_d_exports.Shape | null;
-declare function shouldPreserveRawShapeDrawing(drawingEl: XmlElement): boolean;
-//#endregion
-export { parseShape, parseShapeFromDrawing, shouldPreserveRawShapeDrawing };
+export declare function parseShapeFromDrawing(drawingEl: XmlElement): document_d_exports.Shape | null;
+export declare function shouldPreserveRawShapeDrawing(drawingEl: XmlElement): boolean;
+//#endregion

package/dist/docx/shapeParser.js

@@ -49,7 +49,8 @@ function parseShapeType(spPr) {
 	if (!spPr) return "rect";
 	const prstGeom = findChildByLocalName(spPr, "prstGeom");
 	if (prstGeom) {
-		const narrowed = narrowEnum(getAttribute(prstGeom, null, "prst"), ShapeTypeSchema);
+		const prst = getAttribute(prstGeom, null, "prst");
+		const narrowed = narrowEnum(prst, ShapeTypeSchema);
 		if (narrowed) return narrowed;
 	}
 	return "rect";

package/dist/docx/storyBlockReplay.d.ts

@@ -8,7 +8,7 @@ type MaterializeReplayFragmentOptions = {
   generatedRoot?: XmlElement;
 };
 /** Bind a replay fragment once, retaining existing local declarations and compatibility tokens. */
-declare const materializeReplayFragment: ({ xml, element, sourceNamespace, generatedRoot }: MaterializeReplayFragmentOptions) => string | null;
+export declare const materializeReplayFragment: ({ xml, element, sourceNamespace, generatedRoot }: MaterializeReplayFragmentOptions) => string | null;
 type StoryBlockReplayOptions = {
   sourceXml: string;
   baselineContent: readonly document_d_exports.BlockContent[];
@@ -16,9 +16,9 @@ type StoryBlockReplayOptions = {
   serializedXml: string;
   ignoredChild?: string;
 };
-declare const buildStoryBlockReplay: (options: StoryBlockReplayOptions) => string | null;
+export declare const buildStoryBlockReplay: (options: StoryBlockReplayOptions) => string | null;
 /** Validate source/model correspondence before replaying an unchanged complete part. */
-declare const canReplayDocumentSource: (sourceXml: string, baseline: document_d_exports.DocumentBody) => boolean;
+export declare const canReplayDocumentSource: (sourceXml: string, baseline: document_d_exports.DocumentBody) => boolean;
 type DocumentBlockReplayOptions = {
   sourceXml: string;
   serializedXml: string;
@@ -26,6 +26,6 @@ type DocumentBlockReplayOptions = {
   current: document_d_exports.DocumentBody;
 };
 /** Replay body blocks and modeled document metadata inside the authored part shell. */
-declare const buildDocumentBlockReplay: ({ sourceXml, serializedXml, baseline, current }: DocumentBlockReplayOptions) => string | null;
+export declare const buildDocumentBlockReplay: ({ sourceXml, serializedXml, baseline, current }: DocumentBlockReplayOptions) => string | null;
 //#endregion
-export { buildDocumentBlockReplay, buildStoryBlockReplay, canReplayDocumentSource, materializeReplayFragment };
+export {};

package/dist/docx/storyBlockReplay.js

@@ -14,7 +14,11 @@ const BLOCK_ELEMENT_NAMES = {
 	blockCustomXml: "customXml",
 	preservedBlock: null,
 	bookmarkStart: "bookmarkStart",
-	bookmarkEnd: "bookmarkEnd"
+	bookmarkEnd: "bookmarkEnd",
+	moveFromRangeStart: "moveFromRangeStart",
+	moveFromRangeEnd: "moveFromRangeEnd",
+	moveToRangeStart: "moveToRangeStart",
+	moveToRangeEnd: "moveToRangeEnd"
 };
 const modelMatchesElement = ({ value, element, mode }) => {
 	if (value === void 0) return false;
@@ -303,7 +307,11 @@ const replayNestedBlock = ({ sourceXml, serializedXml, sourceElement, generatedE
 		case "paragraph":
 		case "preservedBlock":
 		case "bookmarkStart":
-		case "bookmarkEnd": return null;
+		case "bookmarkEnd":
+		case "moveFromRangeStart":
+		case "moveFromRangeEnd":
+		case "moveToRangeStart":
+		case "moveToRangeEnd": return null;
 		default: return current;
 	}
 	return spliceXml(sourceXml.slice(sourceRange.start, sourceRange.end), splices);

package/dist/docx/storyPlainText.d.ts

@@ -1,20 +1,19 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/docx/storyPlainText.d.ts
 /** Read the document body with pending revisions accepted. */
-declare const getDocumentText: (body: document_d_exports.DocumentBody) => string;
+export declare const getDocumentText: (body: document_d_exports.DocumentBody) => string;
 /** Approximate word count of the accepted body text. */
-declare const getWordCount: (body: document_d_exports.DocumentBody) => number;
+export declare const getWordCount: (body: document_d_exports.DocumentBody) => number;
 /** Character count of the accepted body text. */
-declare const getCharacterCount: (body: document_d_exports.DocumentBody) => number;
+export declare const getCharacterCount: (body: document_d_exports.DocumentBody) => number;
 /** Read an accepted table, including nested blocks and tracked structure. */
-declare const getTableText: (table: document_d_exports.Table) => string;
+export declare const getTableText: (table: document_d_exports.Table) => string;
 /** Read accepted text-box content for search and indexing. */
-declare const getTextBoxText: (textBox: document_d_exports.TextBox) => string;
+export declare const getTextBoxText: (textBox: document_d_exports.TextBox) => string;
 /** Read an accepted header or footer through the same walk as body and notes. */
-declare const getHeaderFooterText: (headerFooter: document_d_exports.HeaderFooter) => string;
+export declare const getHeaderFooterText: (headerFooter: document_d_exports.HeaderFooter) => string;
 /** Read accepted footnote content, including nested blocks. */
-declare const getFootnoteText: (footnote: document_d_exports.Footnote) => string;
+export declare const getFootnoteText: (footnote: document_d_exports.Footnote) => string;
 /** Read accepted endnote content, including nested blocks. */
-declare const getEndnoteText: (endnote: document_d_exports.Endnote) => string;
-//#endregion
-export { getCharacterCount, getDocumentText, getEndnoteText, getFootnoteText, getHeaderFooterText, getTableText, getTextBoxText, getWordCount };
+export declare const getEndnoteText: (endnote: document_d_exports.Endnote) => string;
+//#endregion

package/dist/docx/streamingXmlParser.d.ts

@@ -11,7 +11,7 @@ type XmlSourceRange = {
   readonly end: number;
 };
 /** Exact element source ranges, available only from the opt-in source-range reader. */
-declare const getXmlSourceRange: (element: XmlElement) => XmlSourceRange | undefined;
+export declare const getXmlSourceRange: (element: XmlElement) => XmlSourceRange | undefined;
 /**
  * Parse ordinary OOXML into Folio's existing element representation in one
  * pass. Unsupported or malformed constructs return a sentinel so callers can
@@ -34,29 +34,29 @@ type ElementScanVisitor = (options: ElementScanOptions) => void;
  * @param inheritedNamespaceScope the bindings in scope around `xml`, for a
  *   fragment captured out of a part whose root declared them.
  */
-declare const parseStreamingXml: (xml: string, inheritedNamespaceScope?: XmlNamespaceScope) => ParseXmlResult;
+export declare const parseStreamingXml: (xml: string, inheritedNamespaceScope?: XmlNamespaceScope) => ParseXmlResult;
 /** Retain source spans for every element without changing the parsed namespace tree. */
-declare const parseStreamingXmlWithSourceRanges: (xml: string, inheritedNamespaceScope?: XmlNamespaceScope) => ParseXmlResult;
+export declare const parseStreamingXmlWithSourceRanges: (xml: string, inheritedNamespaceScope?: XmlNamespaceScope) => ParseXmlResult;
 /** Retain the body tree while collecting identities for import repair. */
-declare const parseStreamingXmlWithIdentityVisitor: (xml: string, visitOpenTag: OpenTagScanVisitor) => ParseXmlResult;
+export declare const parseStreamingXmlWithIdentityVisitor: (xml: string, visitOpenTag: OpenTagScanVisitor) => ParseXmlResult;
 /** Rewrite selected decimal attribute values while preserving every other source byte. */
-declare const rewriteStreamingXmlDecimalAttributes: (xml: string, visitOpenTag: OpenTagVisitor) => {
+export declare const rewriteStreamingXmlDecimalAttributes: (xml: string, visitOpenTag: OpenTagVisitor) => {
   status: "rewritten";
   value: string;
 } | {
   status: "unsupported";
 };
 /** Visit identity attributes and namespace bindings without building an XML tree. */
-declare const scanStreamingXmlNumericIdAttributes: (xml: string, visitOpenTag: OpenTagScanVisitor) => {
+export declare const scanStreamingXmlNumericIdAttributes: (xml: string, visitOpenTag: OpenTagScanVisitor) => {
   status: "unsupported";
 } | {
   status: "scanned";
 };
 /** Visit namespace-resolved start tags and source spans without building a tree. */
-declare const scanStreamingXmlElements: (xml: string, visitElement: ElementScanVisitor) => {
+export declare const scanStreamingXmlElements: (xml: string, visitElement: ElementScanVisitor) => {
   status: "unsupported";
 } | {
   status: "scanned";
 };
 //#endregion
-export { getXmlSourceRange, parseStreamingXml, parseStreamingXmlWithIdentityVisitor, parseStreamingXmlWithSourceRanges, rewriteStreamingXmlDecimalAttributes, scanStreamingXmlElements, scanStreamingXmlNumericIdAttributes };
+export {};

package/dist/docx/strictNames.d.ts

@@ -2,10 +2,9 @@ import { XmlElement } from "./xmlParser.js";
 import { RenamedSlot } from "./strictNames.gen.js";
 //#region src/docx/strictNames.d.ts
 /** A renamed child of `parent`, in whichever spelling the document used. */
-declare const findChildAnySpelling: (parent: XmlElement | null | undefined, slot: RenamedSlot) => XmlElement | null;
+export declare const findChildAnySpelling: (parent: XmlElement | null | undefined, slot: RenamedSlot) => XmlElement | null;
 /** A renamed attribute's number, in whichever spelling the document used. */
-declare const numericAttributeAnySpelling: (element: XmlElement | null | undefined, slot: RenamedSlot) => number | undefined;
+export declare const numericAttributeAnySpelling: (element: XmlElement | null | undefined, slot: RenamedSlot) => number | undefined;
 /** Whether the element carries a renamed attribute under either spelling. */
-declare const hasAttributeAnySpelling: (element: XmlElement | null | undefined, slot: RenamedSlot) => boolean;
-//#endregion
-export { findChildAnySpelling, hasAttributeAnySpelling, numericAttributeAnySpelling };
+export declare const hasAttributeAnySpelling: (element: XmlElement | null | undefined, slot: RenamedSlot) => boolean;
+//#endregion

package/dist/docx/strictNames.gen.d.ts

@@ -14,7 +14,7 @@
  * The comment above each entry names the types that declare the pair.
  */
 /** What folio writes for a name a Strict producer spelled by writing direction. */
-declare const TRANSITIONAL_NAME_BY_STRICT_NAME: {
+export declare const TRANSITIONAL_NAME_BY_STRICT_NAME: {
   readonly "CT_Border end": "right";
   readonly "CT_Border start": "left";
   readonly "CT_Ind @end": "right";
@@ -25,11 +25,11 @@ declare const TRANSITIONAL_NAME_BY_STRICT_NAME: {
   readonly "CT_TblWidth start": "left";
 };
 /** A name Part 1 renamed, keyed by the complex type it belongs to. */
-type StrictName = keyof typeof TRANSITIONAL_NAME_BY_STRICT_NAME;
+export type StrictName = keyof typeof TRANSITIONAL_NAME_BY_STRICT_NAME;
 /** The same keys as a list, so a consumer can walk them without widening them. */
-declare const STRICT_NAMES: readonly ["CT_Border end", "CT_Border start", "CT_Ind @end", "CT_Ind @endChars", "CT_Ind @start", "CT_Ind @startChars", "CT_TblWidth end", "CT_TblWidth start"];
+export declare const STRICT_NAMES: readonly ["CT_Border end", "CT_Border start", "CT_Ind @end", "CT_Ind @endChars", "CT_Ind @start", "CT_Ind @startChars", "CT_TblWidth end", "CT_TblWidth start"];
 /** What a Strict producer may have written where folio writes the Transitional name. */
-declare const STRICT_NAMES_BY_TRANSITIONAL_NAME: {
+export declare const STRICT_NAMES_BY_TRANSITIONAL_NAME: {
   readonly "CT_Border left": readonly ["start"];
   readonly "CT_Border right": readonly ["end"];
   readonly "CT_Ind @left": readonly ["start"];
@@ -40,6 +40,5 @@ declare const STRICT_NAMES_BY_TRANSITIONAL_NAME: {
   readonly "CT_TblWidth right": readonly ["end"];
 };
 /** A slot a reader must take in either spelling, keyed the same way. */
-type RenamedSlot = keyof typeof STRICT_NAMES_BY_TRANSITIONAL_NAME;
-//#endregion
-export { RenamedSlot, STRICT_NAMES, STRICT_NAMES_BY_TRANSITIONAL_NAME, StrictName, TRANSITIONAL_NAME_BY_STRICT_NAME };
+export type RenamedSlot = keyof typeof STRICT_NAMES_BY_TRANSITIONAL_NAME;
+//#endregion

package/dist/docx/strictValueEncodings.gen.d.ts

@@ -1,15 +1,14 @@
 import { MeasureUnit } from "./universalMeasure.js";
 //#region src/docx/strictValueEncodings.gen.d.ts
 /** The fraction of a percent a Transitional attribute's number counts. */
-type PercentUnit = "fiftiethPercent" | "thousandthPercent" | "wholePercent";
+export type PercentUnit = "fiftiethPercent" | "thousandthPercent" | "wholePercent";
 /** The number a slot's dual-spelling type accepts in place of a Strict string. */
-type SlotEncoding = {
+export type SlotEncoding = {
   readonly measure?: MeasureUnit;
   readonly percent?: PercentUnit;
 };
 /** Slots whose Transitional type spells one value two ways. */
-declare const TRANSITIONAL_SLOT_ENCODINGS: ReadonlyMap<string, SlotEncoding>;
+export declare const TRANSITIONAL_SLOT_ENCODINGS: ReadonlyMap<string, SlotEncoding>;
 /** Every Strict namespace URI a WordprocessingML part can carry, and its Transitional pair. */
-declare const TRANSITIONAL_NAMESPACE_BY_STRICT_URI: ReadonlyMap<string, string>;
-//#endregion
-export { PercentUnit, SlotEncoding, TRANSITIONAL_NAMESPACE_BY_STRICT_URI, TRANSITIONAL_SLOT_ENCODINGS };
+export declare const TRANSITIONAL_NAMESPACE_BY_STRICT_URI: ReadonlyMap<string, string>;
+//#endregion

package/dist/docx/structuralXmlPatch.d.ts

@@ -9,6 +9,6 @@ type StructuralPatchOptions = {
  * Tables are opaque barriers: their modeled content and order must stay identical.
  * Id-less sources need an explicit ensureParaIds ingest before structural editing.
  */
-declare const buildStructuralDocumentPatch: ({ originalXml, serializedXml, changedIds }: StructuralPatchOptions) => string | null;
+export declare const buildStructuralDocumentPatch: ({ originalXml, serializedXml, changedIds }: StructuralPatchOptions) => string | null;
 //#endregion
-export { buildStructuralDocumentPatch };
+export {};