@stll/folio-core 0.27.0 → 0.28.0

package/dist/ai-edits/table-cell-mutations.js

@@ -14,6 +14,7 @@ const mergeTableRectangle = ({ tr, tablePosition, table, rectangle }) => {
 	const tableStart = tablePosition + 1;
 	const seen = /* @__PURE__ */ new Set();
 	const cells = [];
+	const topRowCells = [];
 	let appendedContent = Fragment.empty;
 	for (let row = rectangle.top; row < rectangle.bottom; row++) for (let column = rectangle.left; column < rectangle.right; column++) {
 		const cellPosition = map.map[row * map.width + column];
@@ -25,6 +26,7 @@ const mergeTableRectangle = ({ tr, tablePosition, table, rectangle }) => {
 			position: cellPosition,
 			cell
 		});
+		if (row === rectangle.top) topRowCells.push(cell);
 		if (cells.length > 1 && !isEmptyTableCell(cell)) appendedContent = appendedContent.append(cell.content);
 	}
 	const merged = cells.at(0);
@@ -34,8 +36,8 @@ const mergeTableRectangle = ({ tr, tablePosition, table, rectangle }) => {
 	const colwidth = merged.cell.attrs["colwidth"];
 	if (typeof colspan !== "number" || !Number.isInteger(colspan) || colspan < 1 || typeof rowspan !== "number" || !Number.isInteger(rowspan) || rowspan < 1 || colwidth !== null && colwidth !== void 0 && (!Array.isArray(colwidth) || colwidth.length !== colspan || !colwidth.every((width) => typeof width === "number"))) return null;
 	const mergedColspan = rectangle.right - rectangle.left;
-	const nextColwidth = Array.isArray(colwidth) ? [...colwidth] : null;
-	while (nextColwidth && nextColwidth.length < mergedColspan) nextColwidth.push(0);
+	const nextColwidth = mergeTopRowColwidths(topRowCells, mergedColspan);
+	const preferredWidth = mergeTopRowPreferredWidths(topRowCells);
 	const mapFrom = tr.mapping.maps.length;
 	for (const { position: cellPosition, cell } of cells.slice(1)) {
 		const position = tr.mapping.slice(mapFrom).map(tableStart + cellPosition);
@@ -46,7 +48,9 @@ const mergeTableRectangle = ({ tr, tablePosition, table, rectangle }) => {
 		...merged.cell.attrs,
 		colspan: mergedColspan,
 		rowspan: rectangle.bottom - rectangle.top,
-		colwidth: nextColwidth
+		colwidth: nextColwidth,
+		width: preferredWidth.type === "value" ? preferredWidth.width : null,
+		widthType: preferredWidth.type === "value" ? preferredWidth.widthType : null
 	});
 	if (appendedContent.size > 0) {
 		const contentEnd = absoluteMergedPosition + 1 + merged.cell.content.size;
@@ -55,6 +59,37 @@ const mergeTableRectangle = ({ tr, tablePosition, table, rectangle }) => {
 	}
 	return tr;
 };
+const mergeTopRowColwidths = (cells, mergedColspan) => {
+	const widths = [];
+	for (const cell of cells) {
+		const colspan = cell.attrs["colspan"];
+		const colwidth = cell.attrs["colwidth"];
+		if (typeof colspan !== "number" || !Number.isInteger(colspan) || colspan < 1 || !Array.isArray(colwidth) || colwidth.length !== colspan || !colwidth.every((width) => typeof width === "number" && width > 0)) return null;
+		widths.push(...colwidth);
+	}
+	return widths.length === mergedColspan ? widths : null;
+};
+/** A horizontal merge owns the whole top-row span. Sum compatible explicit
+* preferred widths; retaining only the first cell's width makes a 50%+50%
+* bilingual row serialize as a 50%-wide spanning cell. Mixed/implicit units
+* cannot be composed safely, so clear the preference and let the table grid
+* define the merged width. */
+const mergeTopRowPreferredWidths = (cells) => {
+	let width = 0;
+	let widthType;
+	for (const cell of cells) {
+		const candidateWidth = cell.attrs["width"];
+		const candidateType = cell.attrs["widthType"];
+		if (typeof candidateWidth !== "number" || !Number.isFinite(candidateWidth) || candidateType !== "dxa" && candidateType !== "pct" || widthType !== void 0 && candidateType !== widthType) return { type: "absent" };
+		width += candidateWidth;
+		widthType = candidateType;
+	}
+	return widthType === void 0 ? { type: "absent" } : {
+		type: "value",
+		width,
+		widthType
+	};
+};
 const mergeTrackedVerticalTableCells = ({ tr, tablePosition, table, rectangle, revisionId, author, date }) => {
 	const map = TableMap.get(table);
 	if (rectangle.right - rectangle.left !== 1 || rectangle.bottom - rectangle.top < 2 || rectangle.left < 0 || rectangle.top < 0 || rectangle.right > map.width || rectangle.bottom > map.height || tableRectangleCutsMergedCell(map, rectangle)) return null;

package/dist/docx/paragraphParser.js

@@ -1,3 +1,4 @@
+import { isValidHexColor } from "../utils/colorResolver.js";
 import { isValidHexId } from "../utils/hexId.js";
 import { parseBookmarkEnd as parseBookmarkEnd$1, parseBookmarkStart as parseBookmarkStart$1 } from "./bookmarkParser.js";
 import { parseFieldType } from "./fieldParser.js";
@@ -48,9 +49,9 @@ function parseShadingProperties(shd) {
 	if (!shd) return;
 	const props = {};
 	const color = getAttribute(shd, "w", "color");
-	if (color && color !== "auto") props.color = { rgb: color };
+	if (color && color !== "auto" && isValidHexColor(color)) props.color = { rgb: color };
 	const fill = getAttribute(shd, "w", "fill");
-	if (fill && fill !== "auto") props.fill = { rgb: fill };
+	if (fill && fill !== "auto" && isValidHexColor(fill)) props.fill = { rgb: fill };
 	const validatedThemeFill = narrowEnum(getAttribute(shd, "w", "themeFill"), ThemeColorSlotSchema);
 	if (validatedThemeFill) {
 		props.fill = props.fill || {};

package/dist/docx/parser.js

@@ -1,6 +1,6 @@
 import { toArrayBuffer } from "../utils/docxInput.js";
 import { loadFontsWithMapping } from "../utils/fontLoader.js";
-import { convertTiffToPngDataUrl, isTiffMimeType } from "../utils/tiffConverter.js";
+import { MAX_PACKAGE_TIFF_PIXELS, convertTiffToPngDataUrl, isTiffMimeType } from "../utils/tiffConverter.js";
 import { parseComments } from "./commentParser.js";
 import { normalizeCommentReferences } from "./commentReferenceNormalization.js";
 import { detectDocxConformanceClass } from "./conformance.js";
@@ -237,14 +237,37 @@ function copyBytesToArrayBuffer(bytes) {
 	new Uint8Array(buffer).set(bytes);
 	return buffer;
 }
-async function buildMediaMap(raw, _rels) {
+/**
+* Media paths reachable from the package relationship graph: the document's own
+* relationships plus every `.rels` part the unzip kept. Entries outside it are
+* still stored so a round-trip keeps their bytes, but nothing decodes them.
+*/
+function collectReferencedMediaPaths(raw, rels) {
+	const referenced = /* @__PURE__ */ new Set();
+	const addTargets = (map, relsPath) => {
+		for (const relationship of map.values()) {
+			if (!relationship.target || relationship.targetMode === "External") continue;
+			const partPath = resolveRelativePath(relsPath, relationship.target);
+			referenced.add(partPath.toLowerCase());
+			referenced.add(partPath.replace(/^word\//u, "").toLowerCase());
+		}
+	};
+	addTargets(rels, DOCUMENT_RELATIONSHIPS_PATH);
+	for (const [path, xml] of raw.allXml.entries()) if (path.toLowerCase().endsWith(".rels")) addTargets(parseRelationships(xml), path);
+	return referenced;
+}
+async function buildMediaMap(raw, rels) {
 	const media = /* @__PURE__ */ new Map();
+	const referenced = collectReferencedMediaPaths(raw, rels);
+	let remainingTiffPixels = MAX_PACKAGE_TIFF_PIXELS;
 	for (const [path, data] of raw.media.entries()) {
 		const filename = path.split("/").pop() || path;
 		const mimeType = getMediaMimeType(path);
-		if (isTiffMimeType(mimeType)) {
-			const converted = await convertTiffToPngDataUrl(data);
+		const isReferenced = referenced.has(path.toLowerCase());
+		if (isReferenced && isTiffMimeType(mimeType) && remainingTiffPixels > 0) {
+			const converted = await convertTiffToPngDataUrl(data, remainingTiffPixels);
 			if (converted) {
+				remainingTiffPixels -= converted.pixels;
 				const mediaFile = {
 					path,
 					filename: filename.replace(/\.tiff?$/iu, ".png"),
@@ -258,7 +281,7 @@ async function buildMediaMap(raw, _rels) {
 				continue;
 			}
 		}
-		const raster = isMetafileMimeType(mimeType) ? extractMetafileRaster(data) : null;
+		const raster = isReferenced && isMetafileMimeType(mimeType) ? extractMetafileRaster(data) : null;
 		if (raster) {
 			const mediaFile = {
 				path,

package/dist/docx/rezip.d.ts

@@ -54,6 +54,26 @@ declare function addCommentsExtendedOverride(contentTypesXml: string): string;
 declare function removeCommentsExtendedOverride(contentTypesXml: string): string;
 declare function addCommentsExtendedRelationship(relsXml: string): string;
 declare function removeCommentsExtendedRelationship(relsXml: string): string;
+/** Result of filtering the settings part; `undefined` means "leave as it is". */
+type SettingsWithoutAttachedTemplate = {
+  settingsXml: string | undefined;
+  relsXml: string | undefined;
+};
+/**
+ * Drop `w:attachedTemplate` from a `word/settings.xml` payload together with the
+ * relationships it resolves through.
+ *
+ * The elements are located in the parsed tree by namespace URI plus local name,
+ * so both the Transitional and the Strict WordprocessingML namespace are
+ * covered and a same-named element from a foreign namespace is left alone. Only
+ * the relationship ids those elements reference are removed from the `.rels`
+ * part: the settings part may also carry mail-merge and transform
+ * relationships, and their `r:id` values must keep resolving.
+ *
+ * The removal itself is a byte splice, so everything else in both parts
+ * round-trips exactly as authored.
+ */
+declare function withoutAttachedTemplate(settingsXml: string, relsXml: string | undefined): SettingsWithoutAttachedTemplate;
 /**
  * Update only document.xml in a DOCX buffer (minimal changes)
  *
@@ -173,4 +193,4 @@ declare function createEmptyDocx(): Promise<ArrayBuffer>;
  */
 declare function createDocx(doc: document_d_exports.Document): Promise<ArrayBuffer>;
 //#endregion
-export { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_CONTENT_TYPE, COMMENTS_EXTENDED_PART, COMMENTS_EXTENDED_PART_LOWER, DocxPackageFidelityError, RepackOptions, addCommentsExtendedOverride, addCommentsExtendedRelationship, addMedia, addRelationship, applyUpdatesToZip, collectHeaderFooterUpdates, collectHyperlinksWithoutRId, createDocx, createEmptyDocx, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, isDocxBuffer, notePartRelsPath, removeCommentsExtendedOverride, removeCommentsExtendedRelationship, repackDocx, repackDocxFromRaw, updateCoreProperties, updateDocumentXml, updateMultipleFiles, updateXmlFile, validateDocx };
+export { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_CONTENT_TYPE, COMMENTS_EXTENDED_PART, COMMENTS_EXTENDED_PART_LOWER, DocxPackageFidelityError, RepackOptions, addCommentsExtendedOverride, addCommentsExtendedRelationship, addMedia, addRelationship, applyUpdatesToZip, collectHeaderFooterUpdates, collectHyperlinksWithoutRId, createDocx, createEmptyDocx, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, isDocxBuffer, notePartRelsPath, removeCommentsExtendedOverride, removeCommentsExtendedRelationship, repackDocx, repackDocxFromRaw, updateCoreProperties, updateDocumentXml, updateMultipleFiles, updateXmlFile, validateDocx, withoutAttachedTemplate };

package/dist/docx/rezip.js

@@ -18,7 +18,7 @@ import { serializeStyle, serializeStylesXml } from "./serializer/stylesSerialize
 import { serializeThemeXml } from "./serializer/themeSerializer.js";
 import { escapeXml } from "./serializer/xmlUtils.js";
 import { isPreservableDocxEntry } from "./unzip.js";
-import { WORDPROCESSINGML_NAMESPACE_URIS, findChild, getChildElements, getLocalName, getNamespaceUri, matchesName, parseXml } from "./xmlParser.js";
+import { WORDPROCESSINGML_NAMESPACE_URIS, findChild, getAttribute, getChildElements, getLocalName, getNamespaceUri, matchesName, parseXml, parseXmlDocument } from "./xmlParser.js";
 import { assertXmlResourceLimits } from "./xmlResourceLimits.js";
 import { panic } from "better-result";
 import { validateDocxPackage } from "@stll/docx-core";
@@ -459,6 +459,7 @@ const finishRepack = async ({ document, originalZip, outputZip, originalDocument
 	await serializeNumberingIntoZip(document, originalZip, outputZip, compressionLevel);
 	await serializeAddedStylesIntoZip(document, originalZip, outputZip, compressionLevel);
 	await serializeCommentsToZip(document, outputZip, compressionLevel);
+	await dropAttachedTemplateReference(outputZip, compressionLevel);
 	if (updateModifiedDate && originalCorePropertiesXml) {
 		const updatedCoreProperties = updateCoreProperties(originalCorePropertiesXml, {
 			updateModifiedDate,
@@ -547,6 +548,7 @@ async function repackDocxFromRaw(doc, rawContent, options = {}) {
 	await serializeNumberingIntoZip(exportDocument, rawContent.originalZip, newZip, compressionLevel);
 	await serializeAddedStylesIntoZip(exportDocument, rawContent.originalZip, newZip, compressionLevel);
 	await serializeCommentsToZip(exportDocument, newZip, compressionLevel);
+	await dropAttachedTemplateReference(newZip, compressionLevel);
 	if (updateModifiedDate && rawContent.corePropsXml) {
 		const updatedCoreProps = updateCoreProperties(rawContent.corePropsXml, {
 			updateModifiedDate,
@@ -582,6 +584,82 @@ function addCommentsExtendedRelationship(relsXml) {
 function removeCommentsExtendedRelationship(relsXml) {
 	return relsXml.replace(/<Relationship\b[^>]*commentsExtended\.xml[^>]*\/>/giu, "");
 }
+const SETTINGS_PART = "word/settings.xml";
+const SETTINGS_RELS_PART = "word/_rels/settings.xml.rels";
+const ATTACHED_TEMPLATE_LOCAL_NAME = "attachedTemplate";
+const ATTACHED_TEMPLATE_ELEMENT = /<(?<prefix>[\w.-]+:)?attachedTemplate\b[^>]*?(?:\/>|>\s*<\/(?:[\w.-]+:)?attachedTemplate>)/giu;
+const RELATIONSHIP_ELEMENT = /<Relationship\b[^>]*?(?:\/>|>\s*<\/Relationship>)/giu;
+const RELATIONSHIP_ID_ATTRIBUTE = /\bId\s*=\s*(?<quote>["'])(?<value>[^"']*)\k<quote>/u;
+/**
+* Drop `w:attachedTemplate` from a `word/settings.xml` payload together with the
+* relationships it resolves through.
+*
+* The elements are located in the parsed tree by namespace URI plus local name,
+* so both the Transitional and the Strict WordprocessingML namespace are
+* covered and a same-named element from a foreign namespace is left alone. Only
+* the relationship ids those elements reference are removed from the `.rels`
+* part: the settings part may also carry mail-merge and transform
+* relationships, and their `r:id` values must keep resolving.
+*
+* The removal itself is a byte splice, so everything else in both parts
+* round-trips exactly as authored.
+*/
+function withoutAttachedTemplate(settingsXml, relsXml) {
+	const root = parseXmlDocument(settingsXml);
+	if (!root) return {
+		settingsXml: void 0,
+		relsXml: void 0
+	};
+	const prefixes = /* @__PURE__ */ new Set();
+	const referencedRIds = /* @__PURE__ */ new Set();
+	for (const element of getChildElements(root)) {
+		if (getLocalName(element.name) !== ATTACHED_TEMPLATE_LOCAL_NAME || !WORDPROCESSINGML_NAMESPACE_URIS.has(getNamespaceUri(element) ?? "")) continue;
+		const name = element.name ?? "";
+		const separatorIndex = name.indexOf(":");
+		prefixes.add(separatorIndex === -1 ? "" : name.slice(0, separatorIndex));
+		const rId = getAttribute(element, "r", "id");
+		if (rId) referencedRIds.add(rId);
+	}
+	if (prefixes.size === 0) return {
+		settingsXml: void 0,
+		relsXml: void 0
+	};
+	const filteredSettings = settingsXml.replace(ATTACHED_TEMPLATE_ELEMENT, (match, prefix) => prefixes.has(prefix?.slice(0, -1) ?? "") ? "" : match);
+	return {
+		settingsXml: filteredSettings === settingsXml ? void 0 : filteredSettings,
+		relsXml: relsXml === void 0 ? void 0 : withoutRelationships(relsXml, referencedRIds)
+	};
+}
+/** Drop the named relationships from a `.rels` payload; `undefined` when unchanged. */
+function withoutRelationships(relsXml, ids) {
+	if (ids.size === 0) return;
+	const filtered = relsXml.replace(RELATIONSHIP_ELEMENT, (relationship) => {
+		const id = RELATIONSHIP_ID_ATTRIBUTE.exec(relationship)?.groups?.["value"];
+		return id !== void 0 && ids.has(id) ? "" : relationship;
+	});
+	return filtered === relsXml ? void 0 : filtered;
+}
+/**
+* The settings part and its relationships are otherwise copied from the source
+* package byte for byte. `w:attachedTemplate` resolves through a relationship
+* whose target sits outside the package (`TargetMode="External"`); the document
+* model has no field for it, so a preserved copy would carry a reference folio
+* can neither read nor rewrite. Both sides are filtered on save.
+*/
+async function dropAttachedTemplateReference(zip, compressionLevel) {
+	const settingsFile = zip.file(SETTINGS_PART);
+	if (!settingsFile) return;
+	const relsFile = zip.file(SETTINGS_RELS_PART);
+	const filtered = withoutAttachedTemplate(await settingsFile.async("text"), await relsFile?.async("text"));
+	if (filtered.settingsXml !== void 0) zip.file(SETTINGS_PART, filtered.settingsXml, {
+		compression: "DEFLATE",
+		compressionOptions: { level: compressionLevel }
+	});
+	if (filtered.relsXml !== void 0) zip.file(SETTINGS_RELS_PART, filtered.relsXml, {
+		compression: "DEFLATE",
+		compressionOptions: { level: compressionLevel }
+	});
+}
 /**
 * Ensure [Content_Types].xml contains an Override for word/comments.xml.
 * If the document already had comments, this is a no-op.
@@ -1413,4 +1491,4 @@ const assertStyleNumberingReferences = (doc) => {
 	for (const numbering of doc.package.numbering?.nums ?? []) if (!availableAbstract.has(numbering.abstractNumId)) panic(`Numbering definition ${numbering.numId} references missing abstract numbering`);
 };
 //#endregion
-export { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_CONTENT_TYPE, COMMENTS_EXTENDED_PART, COMMENTS_EXTENDED_PART_LOWER, DocxPackageFidelityError, addCommentsExtendedOverride, addCommentsExtendedRelationship, addMedia, addRelationship, applyUpdatesToZip, collectHeaderFooterUpdates, collectHyperlinksWithoutRId, createDocx, createEmptyDocx, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, isDocxBuffer, notePartRelsPath, removeCommentsExtendedOverride, removeCommentsExtendedRelationship, repackDocx, repackDocxFromRaw, updateCoreProperties, updateDocumentXml, updateMultipleFiles, updateXmlFile, validateDocx };
+export { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_CONTENT_TYPE, COMMENTS_EXTENDED_PART, COMMENTS_EXTENDED_PART_LOWER, DocxPackageFidelityError, addCommentsExtendedOverride, addCommentsExtendedRelationship, addMedia, addRelationship, applyUpdatesToZip, collectHeaderFooterUpdates, collectHyperlinksWithoutRId, createDocx, createEmptyDocx, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, isDocxBuffer, notePartRelsPath, removeCommentsExtendedOverride, removeCommentsExtendedRelationship, repackDocx, repackDocxFromRaw, updateCoreProperties, updateDocumentXml, updateMultipleFiles, updateXmlFile, validateDocx, withoutAttachedTemplate };

package/dist/docx/runParser.js

@@ -1,3 +1,4 @@
+import { isValidHexColor } from "../utils/colorResolver.js";
 import { parseGroupDrawing } from "./groupDrawingParser.js";
 import { parseImage } from "./imageParser.js";
 import { EmphasisMarkSchema, FontHintSchema, FontThemeSchema, HighlightColorSchema, PositionalTabAlignmentSchema, PositionalTabLeaderSchema, PositionalTabRelativeToSchema, ShadingPatternSchema, TextEffectSchema, ThemeColorSlotSchema, UnderlineStyleSchema, narrowEnum } from "./parserEnums.js";
@@ -37,9 +38,9 @@ function parseShadingProperties(shd) {
 	if (!shd) return;
 	const props = {};
 	const color = getAttribute(shd, "w", "color");
-	if (color && color !== "auto") props.color = { rgb: color };
+	if (color && color !== "auto" && isValidHexColor(color)) props.color = { rgb: color };
 	const fill = getAttribute(shd, "w", "fill");
-	if (fill && fill !== "auto") props.fill = { rgb: fill };
+	if (fill && fill !== "auto" && isValidHexColor(fill)) props.fill = { rgb: fill };
 	const validatedThemeFill = narrowEnum(getAttribute(shd, "w", "themeFill"), ThemeColorSlotSchema);
 	if (validatedThemeFill) {
 		if (!props.fill) props.fill = {};
@@ -252,7 +253,7 @@ function parseRunProperties(rPr, theme, _styles) {
 				if (resolved) fontFamily.ascii = resolved;
 			}
 		}
-		const hAnsiTheme = getAttribute(rFonts, "w", "hAnsiTheme");
+		const hAnsiTheme = narrowEnum(getAttribute(rFonts, "w", "hAnsiTheme"), FontThemeSchema);
 		if (hAnsiTheme) {
 			fontFamily.hAnsiTheme = hAnsiTheme;
 			if (theme && !fontFamily.hAnsi) {
@@ -260,7 +261,7 @@ function parseRunProperties(rPr, theme, _styles) {
 				if (resolved) fontFamily.hAnsi = resolved;
 			}
 		}
-		const eastAsiaTheme = getAttribute(rFonts, "w", "eastAsiaTheme");
+		const eastAsiaTheme = narrowEnum(getAttribute(rFonts, "w", "eastAsiaTheme"), FontThemeSchema);
 		if (eastAsiaTheme) {
 			fontFamily.eastAsiaTheme = eastAsiaTheme;
 			if (theme && !fontFamily.eastAsia) {
@@ -268,7 +269,7 @@ function parseRunProperties(rPr, theme, _styles) {
 				if (resolved) fontFamily.eastAsia = resolved;
 			}
 		}
-		const csTheme = getAttribute(rFonts, "w", "cstheme");
+		const csTheme = narrowEnum(getAttribute(rFonts, "w", "cstheme"), FontThemeSchema);
 		if (csTheme) {
 			fontFamily.csTheme = csTheme;
 			if (theme && !fontFamily.cs) {

package/dist/docx/selectiveSave.d.ts

@@ -14,14 +14,6 @@ type SelectiveSaveOptions = {
    */
   maxBytes?: number;
 };
-/**
- * Attempt a selective save — patch only changed paragraphs in document.xml.
- * Also updates comments, headers/footers, and core properties so that
- * all document parts stay in sync even when only paragraphs are patched.
- *
- * Returns the saved ArrayBuffer, or null if selective save is not possible
- * (caller should fall back to full repack).
- */
 declare function attemptSelectiveSave(doc: document_d_exports.Document, originalBuffer: ArrayBuffer, options: SelectiveSaveOptions): Promise<ArrayBuffer | null>;
 //#endregion
 export { SelectiveSaveOptions, attemptSelectiveSave };

package/dist/docx/selectiveSave.js

@@ -5,7 +5,7 @@ import { validateFolioDocumentModel } from "./modelValidation.js";
 import { isNewDataUrlDrawing } from "./newImage.js";
 import { parseNumbering } from "./numberingParser.js";
 import { RELATIONSHIP_TYPES } from "./relsParser.js";
-import { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_PART_LOWER, addCommentsExtendedOverride, addCommentsExtendedRelationship, applyUpdatesToZip, collectHeaderFooterUpdates, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, updateCoreProperties } from "./rezip.js";
+import { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_PART_LOWER, addCommentsExtendedOverride, addCommentsExtendedRelationship, applyUpdatesToZip, collectHeaderFooterUpdates, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, updateCoreProperties, withoutAttachedTemplate } from "./rezip.js";
 import "./selectiveSaveFlags.js";
 import { buildPatchedDocumentXml, buildPatchedNoteXml, buildPatchedNumberingXml, collectChangedNumberingDefs, collectParaIds } from "./selectiveXmlPatch.js";
 import { ensureThreadedCommentParaIds, serializeComments, serializeCommentsExtended } from "./serializer/commentSerializer.js";
@@ -174,6 +174,20 @@ async function patchNumberingPart(zip, doc, updates) {
 * Returns the saved ArrayBuffer, or null if selective save is not possible
 * (caller should fall back to full repack).
 */
+/**
+* Queue the filtered `word/settings.xml` and `word/_rels/settings.xml.rels`
+* when the source package carries an attached-template reference. Shares
+* `withoutAttachedTemplate` with the full-repack path so both saves emit the
+* same package for the same source.
+*/
+const queueSettingsUpdates = async (zip, updates) => {
+	const settingsFile = zip.file("word/settings.xml");
+	if (!settingsFile) return;
+	const relsFile = zip.file("word/_rels/settings.xml.rels");
+	const filtered = withoutAttachedTemplate(await settingsFile.async("text"), await relsFile?.async("text"));
+	if (filtered.settingsXml !== void 0) updates.set("word/settings.xml", filtered.settingsXml);
+	if (filtered.relsXml !== void 0) updates.set("word/_rels/settings.xml.rels", filtered.relsXml);
+};
 async function attemptSelectiveSave(doc, originalBuffer, options) {
 	const { changedParaIds, structuralChange, hasUntrackedChanges } = options;
 	const maxBytes = options.maxBytes ?? 104857600;
@@ -243,6 +257,7 @@ async function attemptSelectiveSave(doc, originalBuffer, options) {
 		if (!await patchCommentsExtended(zip, comments, updates)) return null;
 		await patchNumberingPart(zip, doc, updates);
 		for (const [path, xml] of headerFooterUpdates) updates.set(path, xml);
+		await queueSettingsUpdates(zip, updates);
 		const corePropsFile = zip.file("docProps/core.xml");
 		if (corePropsFile) {
 			const corePropsXml = await corePropsFile.async("text");

package/dist/docx/serializer/runSerializer.js

@@ -85,10 +85,10 @@ function serializeTextFormatting(formatting) {
 		if (formatting.fontFamily.eastAsia) fontAttrs.push(`w:eastAsia="${escapeXml(formatting.fontFamily.eastAsia)}"`);
 		if (formatting.fontFamily.cs) fontAttrs.push(`w:cs="${escapeXml(formatting.fontFamily.cs)}"`);
 		if (formatting.fontFamily.hint) fontAttrs.push(`w:hint="${escapeXml(formatting.fontFamily.hint)}"`);
-		if (formatting.fontFamily.asciiTheme) fontAttrs.push(`w:asciiTheme="${formatting.fontFamily.asciiTheme}"`);
-		if (formatting.fontFamily.hAnsiTheme) fontAttrs.push(`w:hAnsiTheme="${formatting.fontFamily.hAnsiTheme}"`);
-		if (formatting.fontFamily.eastAsiaTheme) fontAttrs.push(`w:eastAsiaTheme="${formatting.fontFamily.eastAsiaTheme}"`);
-		if (formatting.fontFamily.csTheme) fontAttrs.push(`w:cstheme="${formatting.fontFamily.csTheme}"`);
+		if (formatting.fontFamily.asciiTheme) fontAttrs.push(`w:asciiTheme="${escapeXml(formatting.fontFamily.asciiTheme)}"`);
+		if (formatting.fontFamily.hAnsiTheme) fontAttrs.push(`w:hAnsiTheme="${escapeXml(formatting.fontFamily.hAnsiTheme)}"`);
+		if (formatting.fontFamily.eastAsiaTheme) fontAttrs.push(`w:eastAsiaTheme="${escapeXml(formatting.fontFamily.eastAsiaTheme)}"`);
+		if (formatting.fontFamily.csTheme) fontAttrs.push(`w:cstheme="${escapeXml(formatting.fontFamily.csTheme)}"`);
 		if (fontAttrs.length > 0) parts.push(`<w:rFonts ${fontAttrs.join(" ")}/>`);
 	}
 	if (formatting.language) {

package/dist/docx/serializer/sectionPropertiesSerializer.js

@@ -83,7 +83,7 @@ function serializePageNumbering(props) {
 	if (pageNumbering.format) attrs.push(`w:fmt="${pageNumbering.format}"`);
 	if (pageNumbering.start !== void 0) attrs.push(`w:start="${intAttr(pageNumbering.start)}"`);
 	if (pageNumbering.chapterStyle !== void 0) attrs.push(`w:chapStyle="${intAttr(pageNumbering.chapterStyle)}"`);
-	if (pageNumbering.chapterSeparator) attrs.push(`w:chapSep="${pageNumbering.chapterSeparator}"`);
+	if (pageNumbering.chapterSeparator) attrs.push(`w:chapSep="${escapeXml(pageNumbering.chapterSeparator)}"`);
 	return attrs.length > 0 ? `<w:pgNumType ${attrs.join(" ")}/>` : "";
 }
 function serializePageBorders(props) {
@@ -113,10 +113,10 @@ function serializeBackground(props) {
 	const attrs = [];
 	const { background } = props;
 	if (background.color?.auto) attrs.push("w:color=\"auto\"");
-	else if (background.color?.rgb) attrs.push(`w:color="${background.color.rgb}"`);
-	if (background.themeColor ?? background.color?.themeColor) attrs.push(`w:themeColor="${background.themeColor ?? background.color?.themeColor}"`);
-	if (background.themeTint ?? background.color?.themeTint) attrs.push(`w:themeTint="${background.themeTint ?? background.color?.themeTint}"`);
-	if (background.themeShade ?? background.color?.themeShade) attrs.push(`w:themeShade="${background.themeShade ?? background.color?.themeShade}"`);
+	else if (background.color?.rgb) attrs.push(`w:color="${escapeXml(background.color.rgb)}"`);
+	if (background.themeColor ?? background.color?.themeColor) attrs.push(`w:themeColor="${escapeXml(background.themeColor ?? background.color?.themeColor ?? "")}"`);
+	if (background.themeTint ?? background.color?.themeTint) attrs.push(`w:themeTint="${escapeXml(background.themeTint ?? background.color?.themeTint ?? "")}"`);
+	if (background.themeShade ?? background.color?.themeShade) attrs.push(`w:themeShade="${escapeXml(background.themeShade ?? background.color?.themeShade ?? "")}"`);
 	return attrs.length > 0 ? `<w:background ${attrs.join(" ")}/>` : "";
 }
 function serializeDocGrid(props) {

package/dist/docx/server/createBilingualDocument.js

@@ -10,7 +10,10 @@ import { TaggedError } from "better-result";
 * cloned per language, so both columns count independently (1. / 1. instead of
 * 1. / 2.) and stay live in Word. Right-column paragraphs receive fresh
 * `paraId`s so callers can address each row later (for example to replace the
-* placeholder copy with a translation by block id).
+* placeholder copy with a translation by block id). Horizontal paragraph
+* geometry is projected into the half-width cells: full-page indents and tab
+* stops otherwise place signature fields outside their column and let prose
+* overlap the translation.
 *
 * Section breaks cannot live inside a table cell, so the body is split at
 * paragraphs carrying `sectionProperties`: each section becomes its own table
@@ -28,6 +31,8 @@ const HALF_WIDTH_PCT = 2500;
 const A4_TEXT_WIDTH_TWIPS = 9072;
 const ROW_ID_NAMESPACE = "folio-bilingual";
 const BILINGUAL_TABLE_STYLE_ID = "FolioBilingualTranslation";
+const MIN_COLUMN_TEXT_WIDTH_TWIPS = 720;
+const MIN_TAB_TRAILING_WIDTH_TWIPS = 360;
 const GRID_BORDER = {
 	style: "single",
 	size: 4,
@@ -111,7 +116,7 @@ function createBilingualDocument(source, options) {
 				rowId: ref.targetParaId,
 				...ref
 			});
-			sectionRows.push(buildRow(block, copy));
+			sectionRows.push(buildRow(block, copy, styleById, textWidth));
 			continue;
 		}
 		const paragraphs = collectTableParagraphs(block).filter((paragraph) => paragraph.paraId !== void 0 && options.editableParagraphIds.has(paragraph.paraId)).map((paragraph) => ({
@@ -362,11 +367,72 @@ const collectTableParagraphs = (table) => {
 	else out.push(...collectTableParagraphs(item));
 	return out;
 };
-const buildRow = (left, right) => ({
-	type: "tableRow",
-	formatting: { cantSplit: true },
-	cells: [buildCell(left), buildCell(right)]
-});
+const buildRow = (left, right, styleById, textWidth) => {
+	const columnWidth = Math.floor(textWidth / 2);
+	const geometry = resolveHorizontalParagraphGeometry(left, styleById);
+	return {
+		type: "tableRow",
+		formatting: { cantSplit: true },
+		cells: [buildCell(projectParagraphIntoColumn(left, geometry, textWidth, columnWidth)), buildCell(projectParagraphIntoColumn(right, geometry, textWidth, columnWidth))]
+	};
+};
+const HORIZONTAL_PARAGRAPH_KEYS = [
+	"indentLeft",
+	"indentRight",
+	"indentFirstLine",
+	"hangingIndent",
+	"tabs"
+];
+/** Resolve only the paragraph properties whose coordinates change when a
+* full-width paragraph is placed in a half-width cell. Direct pPr wins over
+* the basedOn style chain, matching Word's paragraph-style cascade. */
+const resolveHorizontalParagraphGeometry = (paragraph, styleById) => {
+	const chain = [];
+	const seen = /* @__PURE__ */ new Set();
+	let style = paragraph.formatting?.styleId ? styleById.get(paragraph.formatting.styleId) : void 0;
+	while (style && !seen.has(style.styleId)) {
+		seen.add(style.styleId);
+		chain.push(style);
+		style = style.basedOn ? styleById.get(style.basedOn) : void 0;
+	}
+	const geometry = {};
+	for (const current of chain.toReversed()) assignHorizontalParagraphGeometry(geometry, current.pPr);
+	assignHorizontalParagraphGeometry(geometry, paragraph.formatting);
+	return geometry;
+};
+const assignHorizontalParagraphGeometry = (target, source) => {
+	for (const key of HORIZONTAL_PARAGRAPH_KEYS) {
+		const value = source?.[key];
+		if (value !== void 0) Object.assign(target, { [key]: value });
+	}
+};
+const projectParagraphIntoColumn = (paragraph, geometry, sourceWidth, columnWidth) => {
+	const scale = columnWidth / sourceWidth;
+	const maxSideIndent = Math.max(0, columnWidth - MIN_COLUMN_TEXT_WIDTH_TWIPS);
+	let indentLeft = projectSideIndent(geometry.indentLeft, scale, maxSideIndent);
+	let indentRight = projectSideIndent(geometry.indentRight, scale, maxSideIndent);
+	if (indentLeft + indentRight - maxSideIndent > 0) {
+		const total = indentLeft + indentRight;
+		indentLeft = Math.round(indentLeft / total * maxSideIndent);
+		indentRight = maxSideIndent - indentLeft;
+	}
+	const formatting = {
+		...paragraph.formatting,
+		...geometry.indentLeft !== void 0 && { indentLeft },
+		...geometry.indentRight !== void 0 && { indentRight },
+		...geometry.indentFirstLine !== void 0 && { indentFirstLine: Math.round(geometry.indentFirstLine * scale) },
+		...geometry.hangingIndent !== void 0 && { hangingIndent: geometry.hangingIndent },
+		...geometry.tabs !== void 0 && { tabs: geometry.tabs.map((tab) => ({
+			...tab,
+			position: Math.min(Math.max(0, Math.round(tab.position * scale)), Math.max(0, columnWidth - MIN_TAB_TRAILING_WIDTH_TWIPS))
+		})) }
+	};
+	return {
+		...paragraph,
+		formatting
+	};
+};
+const projectSideIndent = (value, scale, maximum) => Math.min(Math.max(0, Math.round((value ?? 0) * scale)), maximum);
 const buildCell = (paragraph) => ({
 	type: "tableCell",
 	formatting: {